channels

type ApprovalChannel interface {
	SendApproval(ctx context.Context, recipientID string, req *ipc.ApprovalRequest) error
}

type Channel interface {
	// Name returns the channel identifier (e.g., "whatsapp", "telegram")
	Name() string
	// Start begins listening for inbound messages. Blocks until ctx is cancelled.
	Start(ctx context.Context, inbox chan<- InboundMessage) error
	// Send delivers an outbound message through this channel
	Send(ctx context.Context, msg OutboundMessage) error
	// Stop gracefully shuts down the channel
	Stop() error
}

type ChannelCommand struct {
	Name        string
	Description string
}

type HistoryCleaner interface {
	ClearHistory(ctx context.Context, recipientID string) error
}

type InboundMessage struct {
	ChannelName string                        `json:"channel_name"`
	SenderID    string                        `json:"sender_id"`
	Content     string                        `json:"content"`
	Images      []agentdomain.ImageAttachment `json:"images,omitempty"`
	Timestamp   time.Time                     `json:"timestamp"`
	Metadata    map[string]string             `json:"metadata,omitempty"`
}

type MessageButton struct {
	Text string `json:"text"`
	Data string `json:"data"`
}

type OutboundMessage struct {
	ChannelName string            `json:"channel_name"`
	RecipientID string            `json:"recipient_id"`
	Content     string            `json:"content"`
	Buttons     []MessageButton   `json:"buttons,omitempty"`
	Timestamp   time.Time         `json:"timestamp"`
	Metadata    map[string]string `json:"metadata,omitempty"`
}