channel

type AgentFunc func() (*agent.Agent, error)

type Attachment struct {
	Name    string // suggested filename, like "chart.png"
	Mime    string // media type, like "image/png"
	Data    []byte // the file bytes
	Caption string // optional note to show alongside it
}

type Caps struct {
	Media   bool // can carry images in and out
	Buttons bool // can render tap-to-approve controls
	Stream  bool // can update a message as text streams
}

type Channel interface {
	Name() string
	Caps() Caps
	Run(ctx context.Context, h Handler) error
}

type Clip struct {
	Data []byte // the raw audio
	Ext  string // container extension, like ".ogg" or ".m4a"
}

type Exchange struct {
	Channel  string
	In       Inbound
	Reply    Reply
	Approver policy.Approver
}

type FileReply interface {
	File(a Attachment)
}

type Handler func(ctx context.Context, x Exchange)

type Inbound struct {
	Chat   string           // conversation key within the channel
	User   string           // sender id, for allowlisting
	Text   string           // message text
	Images []provider.Block // any image blocks that came with it
	Audio  []Clip           // any voice notes that came with it, pre-transcription
}

type Reply interface {
	Chunk(text string)
	Notice(text string)
	Done()
}

type Router struct {
	// contains filtered or unexported fields
}

type VoiceReply interface {
	Voice(clip Clip)
}

type Workforce interface {
	// Route picks the worker for a message. An explicit @name prefix wins, then
	// a channel:chat binding, otherwise the default worker. It returns the
	// worker name and the text with any @name prefix stripped.
	Route(channel, chat, text string) (worker, cleaned string)
	// Agent builds a fresh agent for one worker, so its system prompt reflects
	// the worker's current memory.
	Agent(worker string) (*agent.Agent, error)
	// Engine returns the policy engine for one worker.
	Engine(worker string) *policy.Engine
	// Curator returns the reflection pass for one worker, or nil if none runs.
	Curator(worker string) *curator.Curator
	// Names lists every known worker, the default included.
	Names() []string
}