agentbridge

type Agent interface {
	// Status reports installation, auth, and transport capability.
	Status(ctx context.Context) Status
	// StartTurn acknowledges fast (well under a second) while the turn keeps
	// running asynchronously; progress arrives on Events.
	StartTurn(ctx context.Context, req TurnRequest) (ThreadRef, error)
	// Steer injects mid-turn guidance. Exec-mode implementations return
	// ErrUnsupported.
	Steer(ctx context.Context, ref ThreadRef, text string) error
	// Interrupt stops the running turn.
	Interrupt(ctx context.Context, ref ThreadRef) error
	// RespondApproval answers a pending ApprovalRequest by ID.
	RespondApproval(ctx context.Context, id string, d Decision) error
	// Events returns the normalized event stream. Closed by Close.
	Events() <-chan Event
	Close() error
}

type ApprovalRequest struct {
	ID      string
	Kind    string // "command" | "patch"
	Command string // exact command line for the command kind
	Summary string
	Cwd     string
}

type AuthMethod string

type Decision string

type Event struct {
	Type     EventType
	ThreadID string
	TurnID   string
	Item     *Item
	Approval *ApprovalRequest
	Err      string
}

type EventType string

type Item struct {
	Kind    string // agent_message | reasoning | command_execution | file_change | mcp_tool_call | web_search | ...
	Summary string // short human-readable description of the item
}

type Mode string

type Project struct {
	Alias   string // spoken-friendly unique name ("speechkit")
	Path    string // absolute directory
	Sandbox SandboxMode
}

type SandboxMode string

type Status struct {
	Installed  bool
	BinaryPath string
	Version    string
	Auth       AuthMethod
	Plan       string // best-effort plan label ("plus", "pro", ...); empty when unknown
	Mode       Mode
	Detail     string // human-readable degradation reason; speakable
}

type ThreadRef struct {
	ThreadID string
	TurnID   string
}

type TurnRequest struct {
	Project  Project
	Prompt   string
	ThreadID string // non-empty = resume/continue that thread
	Sandbox  SandboxMode
}