agent

type ClarificationAnswer struct {
	Selected []string `json:"selected"`
	Details  string   `json:"details"`
}

type Config struct {
	SessionID        string
	Workspace        string
	Message          string
	Mode             string // override session mode; empty = use session's mode
	ThinkingBudget   int
	ThinkLevel       string // Ollama: "", "true", "false", "low", "medium", "high"
	DesktopPermitted bool
	IsSubAgent       bool

	// EmitFn writes one event to the transport (stdout or WebSocket).
	EmitFn func(map[string]any)

	// RequestPerm asks the user to allow a shell command.
	// Returns (allow, allowAll). Nil → always deny.
	RequestPerm func(ctx context.Context, command string) (allow, allowAll bool)

	// RequestClarification pauses the agent and asks the user a clarifying question.
	// suggestions is an optional list of pre-written answers to show as chips.
	// multiChoice allows the user to select multiple suggestions simultaneously.
	// Returns the user's structured answer and ok=true, or (zero ClarificationAnswer, false) on timeout/cancel.
	// Nil → clarification not available (sub-agents, legacy callers).
	RequestClarification func(ctx context.Context, question string, suggestions []string, multiChoice bool) (answer ClarificationAnswer, ok bool)

	// TakeScreenshot triggers Tauri to capture the screen.
	// Returns the payload {image, width, height} or an error.
	// Nil → screenshot not available.
	TakeScreenshot func(ctx context.Context) (map[string]any, error)

	// EmitEvent is the full emit function (stdout + JSONL + session bus).
	// Set by Execute(); tools should use this instead of EmitFn so that
	// events like screen_event are visible to WebSocket clients.
	EmitEvent func(map[string]any)

	// TeamMemberIDs, when non-empty, switches the agent into team-lead mode.
	// In this mode spawn_sub_agent is replaced by delegate_task/wait_for_team
	// so the lead delegates to configured team members instead of spawning
	// ad-hoc sub-agents.
	TeamMemberIDs []string

	// ShellAutoAllow bypasses the per-command permission prompt for run_shell.
	// Set true to auto-allow all shell commands without asking the user.
	ShellAutoAllow bool

	// BrowserAvailable enables the browser tool set.
	// True in dev mode; false in channels (physical screen control only).
	BrowserAvailable bool

	// AgentName is the display name of a configured agent running as a team member.
	// When set, buildSystem puts the agent's identity at the very top of the system
	// prompt so the LLM anchors on its specialist role before reading anything else.
	AgentName string

	// CustomInstructions is the agent's persona/systemPrompt text.
	// Placed at the top of the system prompt when AgentName is set; appended otherwise.
	CustomInstructions string

	// Audit identity — attributed to actions in the tamper-evident audit log.
	// Any field may be empty on surfaces without that identity (e.g. desktop).
	UserID     string
	TenantID   string
	ActorLabel string

	// OverrideModel, when non-empty, replaces the session's stored model for this turn only.
	// Used by the CLI agent picker to honour per-agent model preferences.
	OverrideModel string

	// Images are user-attached base64-encoded images for the current turn.
	// Not persisted to disk — injected only into the in-memory user ChatMessage.
	Images []string

	// ProviderID is the ID of the session's active provider.
	// Set by Execute() after loading the session; used by RAG tools for embeddings.
	ProviderID string

	// ExtDispatch, when non-nil, is called before the built-in tool switch in Dispatch.
	// If it returns handled=true the built-in switch is skipped entirely.
	// Pro edition uses this to route "integration__*" tool calls.
	ExtDispatch ExtDispatchFunc

	// SystemOverride, when non-nil, replaces the output of buildSystem() entirely.
	// Pro edition uses this to inject identity, integrations, and persona instructions.
	SystemOverride *string

	// MemoryEnabled is set by Execute() from the workspace memory config.
	// When true, the save_memory tool is included and the system prompt mentions it.
	MemoryEnabled bool

	// RequestSystemPermission asks the frontend to guide the user to grant a macOS
	// system permission. permType is "accessibility" (mouse/keyboard control).
	// Returns true when the user grants it, false on timeout or denial.
	// Nil → permission flow not available (sub-agents, legacy callers).
	RequestSystemPermission func(ctx context.Context, permType string) bool

	// RequestContinue is called when ConfirmContinue is enabled and the agent
	// reaches the confirmation threshold. It pauses the loop and asks the user
	// whether to keep going. Returns true to continue, false to stop.
	// Nil → always continue (no prompt).
	RequestContinue func(ctx context.Context, iteration, maxIter int) bool
	// contains filtered or unexported fields
}

type ExtDispatchFunc func(ctx context.Context, cfg *Config, toolName string, inp map[string]any) (output, imageData string, isError, handled bool)

type SkillDef struct {
	Name        string
	Description string
	Source      string // "global" | "workspace"
	Body        string
}