runner

type ActivityTracker interface {
	LastActivity() time.Time
}

type Aliver interface {
	Alive() bool
}

type DBPromptParams struct {
	SystemPrompt string // agent's soul from agents.system_prompt
	UserMemory   string // from user_agent_memory.content (always injected)
	AnnaHome     string
	Workspace    string
	Cwd          string // optional working directory
}

type Envelope struct {
	Type string          `json:"type"`
	Data json.RawMessage `json:"data"`
}

type Event struct {
	Text    string
	Image   *ImageEvent
	ToolUse *ToolUseEvent
	Store   ai.Message // if non-nil, Pool appends to session history
	Err     error
}

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

type GoRunnerConfig struct {
	API         string // provider key: "anthropic", "openai"
	Model       string // e.g. "claude-sonnet-4-20250514"
	APIKey      string
	BaseURL     string                  // optional provider base URL override
	WorkDir     string                  // working directory for tool execution
	Workspace   string                  // workspace dir for skills/memory (e.g. ~/.anna/workspace)
	AnnaHome    string                  // anna home directory (e.g. ~/.anna)
	System      string                  // optional system prompt override (bypasses default prompt building)
	ExtraTools  []tool.Tool             // additional tools to register
	PluginHooks engine.PluginHookRunner // optional plugin lifecycle hooks
}

type HandlerFunc func(ctx context.Context, history []ai.Message, message MessageContent) <-chan Event

type ImageEvent struct {
	Data     string // base64 encoded
	MimeType string // e.g. "image/jpeg"
}

type MessageContent = any

type NewRunnerFunc func(ctx context.Context, params RunnerParams) (Runner, error)

type Runner interface {
	Chat(ctx context.Context, history []ai.Message, message MessageContent) <-chan Event
}

type RunnerParams struct {
	Model      string // model ID (empty = use default)
	UserMemory string // per-user memory to inject into system prompt
}

type Skill struct {
	Name                   string
	Description            string
	FilePath               string // absolute path to the SKILL.md or .md file
	BaseDir                string // directory containing the skill file
	Source                 string // "user", "project", or "path"
	DisableModelInvocation bool
}

type Stateful interface {
	Stateful() bool
}

type ToolUseEvent struct {
	Tool   string // tool name, e.g. "bash", "read"
	Status string // "running", "done", "error"
	Input  string // short summary of the tool input
	Detail string // error detail or result summary (for "error" status)
}