24fec62d7f
Forked clean from public hackathon repo (Starfire-AgentTeam, BSL 1.1) with full rebrand to Molecule AI under github.com/Molecule-AI/molecule-monorepo. Brand: Starfire → Molecule AI. Slug: starfire / agent-molecule → molecule. Env vars: STARFIRE_* → MOLECULE_*. Go module: github.com/agent-molecule/platform → github.com/Molecule-AI/molecule-monorepo/platform. Python packages: starfire_plugin → molecule_plugin, starfire_agent → molecule_agent. DB: agentmolecule → molecule. History truncated; see public repo for prior commits and contributor attribution. Verified green: go test -race ./... (platform), pytest (workspace-template 1129 + sdk 132), vitest (canvas 352), build (mcp). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
56 lines
2.1 KiB
Go
56 lines
2.1 KiB
Go
// Package channels provides a pluggable adapter system for social channel
|
|
// integrations (Telegram, Slack, Discord, etc.). Each platform implements
|
|
// the ChannelAdapter interface and registers itself in the adapter registry.
|
|
package channels
|
|
|
|
import (
|
|
"context"
|
|
|
|
"github.com/gin-gonic/gin"
|
|
)
|
|
|
|
// ChannelAdapter is the interface every social channel must implement.
|
|
type ChannelAdapter interface {
|
|
// Type returns the channel type identifier (e.g. "telegram", "slack").
|
|
Type() string
|
|
|
|
// DisplayName returns the human-readable name (e.g. "Telegram").
|
|
DisplayName() string
|
|
|
|
// ValidateConfig checks that channel_config JSONB has required fields.
|
|
ValidateConfig(config map[string]interface{}) error
|
|
|
|
// SendMessage sends a text message to the social platform.
|
|
SendMessage(ctx context.Context, config map[string]interface{}, chatID string, text string) error
|
|
|
|
// ParseWebhook extracts message info from an incoming webhook request.
|
|
ParseWebhook(c *gin.Context, config map[string]interface{}) (*InboundMessage, error)
|
|
|
|
// StartPolling begins long-polling for platforms that support it.
|
|
// Returns nil immediately if the platform only supports webhooks.
|
|
StartPolling(ctx context.Context, config map[string]interface{}, onMessage MessageHandler) error
|
|
}
|
|
|
|
// InboundMessage is the standardized message from any social platform.
|
|
type InboundMessage struct {
|
|
ChatID string // Platform-specific chat/channel ID
|
|
UserID string // Platform-specific user ID
|
|
Username string // Human-readable username
|
|
Text string // Message text
|
|
MessageID string // Platform-specific message ID (for threading)
|
|
Metadata map[string]string // Extra platform-specific data
|
|
}
|
|
|
|
// MessageHandler is called by polling adapters when a message arrives.
|
|
type MessageHandler func(ctx context.Context, channelID string, msg *InboundMessage) error
|
|
|
|
// ChannelRow represents a row from the workspace_channels table.
|
|
type ChannelRow struct {
|
|
ID string
|
|
WorkspaceID string
|
|
ChannelType string
|
|
Config map[string]interface{}
|
|
Enabled bool
|
|
AllowedUsers []string
|
|
}
|