engine

type ADKRunnable interface {
	Run(ctx agent.Context, args any) (map[string]any, error)
}

type AgentPatch struct {
	Description *string
	Prompt      *string
	Provider    *string
	Model       *string
	Tools       *[]string
}

type AgentSpec struct {
	Name        string
	Description string
	Prompt      string
	Provider    string
	Model       string
	Tools       []string
}

type ApprovalRequest struct {
	ToolName  string         `json:"tool_name"`
	Input     map[string]any `json:"input"`
	ToolUseID string         `json:"tool_use_id,omitempty"`
}

type ApprovalResponse struct {
	Allow    bool            `json:"allow"`
	Remember *PermissionRule `json:"remember,omitempty"`
}

type AssistantTextEvent struct {
	BaseEvent
	Text string `json:"text"`
}

type BaseEvent struct {
	TabID int `json:"tab_id"`
}

type BgTaskEndedEvent struct {
	BaseEvent
	JobID    string `json:"job_id"`
	ExitCode int    `json:"exit_code"`
}

type BgTaskStartedEvent struct {
	BaseEvent
	JobID       string `json:"job_id"`
	Description string `json:"description"`
}

type ContextAwareTool struct {
	Inner Tool
	// contains filtered or unexported fields
}

type ContextScope struct {
	Dir  string
	Root string
}

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

type CostEvent struct {
	BaseEvent
	CostUSD float64 `json:"cost_usd"`
}

type DoneEvent struct {
	BaseEvent
	Result ResultSummary `json:"result"`
	Error  error         `json:"error,omitempty"`
}

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

type EngineEvent interface {
	Kind() EventKind
	GetTabID() int
}

type EventKind string

type EventListener func(event EngineEvent)

type ExitedEvent struct {
	BaseEvent
}

type ExtensionsChangedEvent struct {
	BaseEvent
	What string `json:"what"`
}

type FilePart struct {
	Path     string `json:"path,omitempty"`
	MIMEType string `json:"mime_type,omitempty"`
	Data     []byte `json:"data,omitempty"`
}

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

type GenerateStreamFunc func(ctx context.Context, client *genai.Client, model string, contents []*genai.Content, config *genai.GenerateContentConfig) iter.Seq2[*genai.GenerateContentResponse, error]

type HeadlessInteractionHandler struct {
	AutoApproveTools bool
}

type InteractionHandler interface {
	AskQuestion(ctx context.Context, tabID int, questions []Question) (QuestionResponse, error)
	RequestApproval(ctx context.Context, tabID int, req ApprovalRequest) (ApprovalResponse, error)
	ConfirmPlan(ctx context.Context, tabID int, req PlanRequest) (PlanResponse, error)
	RequestSudoPassword(ctx context.Context, tabID int, prompt string) (SudoPasswordResponse, error)
}

type LoadedContextDoc struct {
	Path string
	// Body is what goes into the prompt, capped by
	// TruncateInstructionDoc.
	Body string
	// Root is the directory this document's @-links resolve against —
	// its own scope, not necessarily the project root.
	Root string
	// Links are the @-references found in the document's FULL body,
	// before any truncation. Body alone is not a safe source for them:
	// a link past the cap is still a real dependency of the
	// instructions and must still be followed.
	Links []string
}

type MCPStatusChangedEvent struct {
	BaseEvent
}

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

type MemoryExtractorOptions struct {
	// LoadConfig supplies the config each job reads; nil means config.Load.
	LoadConfig func() (config.Config, error)
	QueueSize  int
	Timeout    time.Duration
}

type MemoryTurn struct {
	Cwd      string
	Prompt   string
	Response string
	// Topic is the tab's current topic, offered to the model as the
	// default.
	Topic string
	// Files are the paths the turn read or edited.
	Files []string
	// Provider is the session's provider, used when the config names
	// none for memory.
	Provider string
	// OnUsage reports the extraction call's own token usage.
	OnUsage func(providerID, modelID string, inputTokens, outputTokens int)
	// OnTopic receives the topic the model settled on for the turn.
	OnTopic func(topic string)
}

type Message struct {
	Role        MessageRole      `json:"role"`
	Text        string           `json:"text,omitempty"`
	Thoughts    []ThoughtPart    `json:"thoughts,omitempty"`
	Files       []FilePart       `json:"files,omitempty"`
	ToolCalls   []ToolCallPart   `json:"tool_calls,omitempty"`
	ToolResults []ToolResultPart `json:"tool_results,omitempty"`
}

type MessageRole string

type MidTurnDrainedEvent struct {
	BaseEvent
	Text string `json:"text"`
}

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

type ModelInfoEvent struct {
	BaseEvent
	Model string `json:"model"`
}

type Options struct {
	Config             config.Config
	InteractionHandler InteractionHandler
	EventListener      EventListener
}

type Origin struct {
	Scope  OriginScope
	Plugin string
}

type OriginScope string

type PermissionRule struct {
	ToolName    string `json:"tool_name"`
	RuleContent string `json:"rule_content"`
}

type PlanRequest struct {
	Plan            string `json:"plan"`
	Explanation     string `json:"explanation"`
	DefaultWorkflow string `json:"default_workflow,omitempty"`
}

type PlanResponse struct {
	Headless      bool     `json:"headless,omitempty"`
	Cancelled     bool     `json:"cancelled,omitempty"`
	TalkMore      bool     `json:"talk_more,omitempty"`
	ExecuteInline bool     `json:"execute_inline,omitempty"`
	WorkflowName  string   `json:"workflow_name,omitempty"`
	WorkflowDone  bool     `json:"workflow_done,omitempty"`
	FailedReason  string   `json:"failed_reason,omitempty"`
	Outcome       string   `json:"outcome,omitempty"`
	Artifacts     []string `json:"artifacts,omitempty"`
	Source        any      `json:"-"`
}

type PromptOptions struct {
	Cwd                 string
	InWorkflow          bool
	GitStatusFn         func(string) string
	DisableSkillsPrompt bool
	SystemPrompt        string
}

type Question struct {
	Kind        string           `json:"kind"` // "pick_one", "pick_many", "pick_diagram"
	Prompt      string           `json:"prompt"`
	Options     []QuestionOption `json:"options"`
	AllowCustom bool             `json:"allow_custom,omitempty"`
}

type QuestionAnswer struct {
	Picks  []string `json:"picks"`
	Custom string   `json:"custom,omitempty"`
	Note   string   `json:"note,omitempty"`
}

type QuestionOption struct {
	Label   string `json:"label"`
	Diagram string `json:"diagram,omitempty"`
}

type QuestionResponse struct {
	Answers   []QuestionAnswer `json:"answers"`
	Cancelled bool             `json:"cancelled,omitempty"`
	Headless  bool             `json:"headless,omitempty"`
}

type ResultSummary struct {
	SessionID string `json:"session_id"`
	Result    string `json:"result"`
	IsError   bool   `json:"is_error"`
}

type Rule struct {
	// Path is the absolute path to the rule file.
	Path string
	// Rel is the rule file's label in prompts.
	Rel string
	// Paths is the compiled glob list from `paths` frontmatter. Empty means eager.
	Paths []string
	// Body is the markdown instruction text, capped by
	// TruncateInstructionDoc.
	Body string
	// Links are the @-references found in the rule's FULL body, before
	// truncation — see LoadedContextDoc.Links.
	Links []string
	// Root is the directory this rule's @-links resolve against: its own
	// scope root, so a user-global rule links within ~/.claude rather
	// than into whichever repository is open.
	Root string
}

type RuleScope struct {
	Root string
	Dir  string
}

type RunOptions struct {
	// Prompt is the user query, instruction, or task description.
	Prompt string `json:"prompt"`

	// SessionID is the unique session identifier. If empty, a new session is created.
	// If provided, prior conversation turns and tool calls are loaded from disk.
	SessionID string `json:"session_id,omitempty"`

	// Cwd is the target working directory. Defaults to os.Getwd().
	Cwd string `json:"cwd,omitempty"`

	// Config optionally overrides default configuration (~/.config/ask/ask.json).
	Config config.Config `json:"config,omitempty"`

	// Provider optionally overrides the LLM provider (e.g. "vertex"); empty
	// means Config.Provider, then the first registered provider.
	Provider string `json:"provider,omitempty"`

	// Model optionally overrides the default model for the selected provider.
	Model string `json:"model,omitempty"`

	// Effort optionally sets reasoning/thinking effort level.
	Effort string `json:"effort,omitempty"`

	// Files provides optional image/media attachments for models with vision.
	Files []FilePart `json:"files,omitempty"`

	// Tools optionally overrides or augments the default toolset.
	Tools []Tool `json:"-"`

	// EventListener receives real-time streaming deltas, tool calls, and lifecycle events.
	EventListener EventListener `json:"-"`

	// InteractionHandler manages tool approval prompts and user questions.
	// Defaults to HeadlessInteractionHandler{AutoApproveTools: true}.
	InteractionHandler InteractionHandler `json:"-"`

	// SkipAllPermissions bypasses confirmation prompts for all tools.
	SkipAllPermissions bool `json:"skip_all_permissions,omitempty"`

	// SkipMemory leaves the finished turn out of concept extraction. Set
	// for sub-agent runs, whose turns are not the user's conversation.
	SkipMemory bool `json:"skip_memory,omitempty"`
}

type RunResult struct {
	// SessionID is the session identifier used for this turn (persisted on disk).
	SessionID string `json:"session_id"`

	// Response is the final assistant text output.
	Response string `json:"response"`

	// Messages contains the complete message history up to this point.
	Messages []Message `json:"messages"`

	// IsError indicates whether the turn failed.
	IsError bool `json:"is_error"`

	// Error contains the failure error, if any.
	Error error `json:"error,omitempty"`
}

type RunnerBuilderFunc func(agentInstance agent.Agent, sessSvc session.Service) (*runner.Runner, error)

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

type SessionArgs struct {
	TabID              int
	Cwd                string
	Provider           string
	Model              string
	Effort             string
	InWorkflow         bool
	SkipAllPermissions bool
	SessionID          string
}

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

type SessionSummary struct {
	ID      string    `json:"id"`
	Cwd     string    `json:"cwd"`
	Preview string    `json:"preview"`
	ModTime time.Time `json:"modTime"`
}

type Skill struct {
	// Name is the slash/invocation name; plugin skills carry the
	// "plugin:" prefix the way Claude Code namespaces them.
	Name        string
	BareName    string
	Description string
	// Dir is the skill package directory; Path is its SKILL.md (or the
	// command file).
	Dir  string
	Path string
	// UserInvocable surfaces the skill as a /name slash command
	// (default true; `user-invocable: false` hides it).
	UserInvocable bool
	// DisableModelInvocation removes the skill from the system-prompt
	// trigger list — the user can still invoke it explicitly.
	DisableModelInvocation bool
	// Frontmatter holds the parsed ADK frontmatter when available.
	Frontmatter *skill.Frontmatter
	Origin      Origin
	Command     bool
}

type SkillPatch struct {
	Description            *string
	Body                   *string
	UserInvocable          *bool
	DisableModelInvocation *bool
}

type SkillRoot struct {
	Dir    string
	Origin Origin
}

type SkillSpec struct {
	Name                   string
	Description            string
	Body                   string
	UserInvocable          *bool
	DisableModelInvocation *bool
	License                string
	Compatibility          string
}

type StatusEvent struct {
	BaseEvent
	Status string `json:"status"`
}

type StoredSessionFile struct {
	Version   int              `json:"version"`
	AppName   string           `json:"appName"`
	UserID    string           `json:"userID"`
	SessionID string           `json:"sessionID"`
	Cwd       string           `json:"cwd"`
	CreatedAt time.Time        `json:"createdAt"`
	UpdatedAt time.Time        `json:"updatedAt"`
	State     map[string]any   `json:"state,omitempty"`
	Events    []*session.Event `json:"events"`
}

type SubagentDef struct {
	// Name is the task-tool name; plugin agents carry the "plugin:"
	// prefix the way Claude Code namespaces them.
	Name        string
	BareName    string
	Description string
	Provider    string
	Model       string
	Tools       []string
	Prompt      string
	Source      string
	Origin      Origin
}

type SubagentEndedEvent struct {
	BaseEvent
	SubagentID string `json:"subagent_id"`
	IsError    bool   `json:"is_error,omitempty"`
}

type SubagentRoot struct {
	Dir    string
	Origin Origin
}

type SubagentStartedEvent struct {
	BaseEvent
	SubagentID  string `json:"subagent_id"`
	AgentType   string `json:"agent_type"`
	Description string `json:"description"`
	Background  bool   `json:"background,omitempty"`
}

type SudoPasswordResponse struct {
	Password  string `json:"password"`
	Cancelled bool   `json:"cancelled"`
}

type TextDeltaEvent struct {
	BaseEvent
	Delta string `json:"delta"`
}

type ThoughtPart struct {
	Text      string `json:"text"`
	Signature []byte `json:"signature,omitempty"`
}

type TodoItem struct {
	Status     string `json:"status"`
	Content    string `json:"content"`
	ActiveForm string `json:"active_form,omitempty"`
}

type TodoUpdateEvent struct {
	BaseEvent
	Todos []TodoItem `json:"todos"`
}

type Tool = tool.Tool

type ToolCallEvent struct {
	BaseEvent
	ToolUseID  string         `json:"tool_use_id"`
	ToolName   string         `json:"tool_name"`
	Input      map[string]any `json:"input"`
	Background bool           `json:"background,omitempty"`
}

type ToolCallPart struct {
	ID               string         `json:"id,omitempty"`
	Name             string         `json:"name"`
	Args             map[string]any `json:"args,omitempty"`
	ThoughtSignature []byte         `json:"thought_signature,omitempty"`
}

type ToolDiffEvent struct {
	BaseEvent
	Path string `json:"path"`
	Diff string `json:"diff"`
}

type ToolFactory func(args ToolFactoryArgs) []Tool

type ToolFactoryArgs struct {
	Cwd                string
	TabID              int
	SkipPermissions    bool
	EventListener      EventListener
	InteractionHandler InteractionHandler
	AttachWebSearch    bool
	// SupportsImages reports whether the run's model can see images; it
	// gates feeding tool-rendered images back to the model. Nil is treated
	// as capable.
	SupportsImages func() bool
	// WorkflowStep attaches the workflow-step tools (save_artifact,
	// load_artifacts) so a step can pass data to a later one.
	WorkflowStep bool
	// WorkflowFinalStep also attaches finish_workflow, which reports the
	// run's outcome and created artifacts to the user. Only meaningful
	// with WorkflowStep.
	WorkflowFinalStep bool
}

type ToolInfo struct {
	Name        string         `json:"name"`
	Description string         `json:"description"`
	Parameters  map[string]any `json:"parameters,omitempty"`
	Required    []string       `json:"required,omitempty"`
}

type ToolResponse struct {
	Content string `json:"content"`
	IsError bool   `json:"is_error,omitempty"`
}

type ToolResultEvent struct {
	BaseEvent
	ToolUseID  string `json:"tool_use_id"`
	ToolName   string `json:"tool_name"`
	Output     string `json:"output"`
	IsError    bool   `json:"is_error"`
	Background bool   `json:"background,omitempty"`
}

type ToolResultPart struct {
	ID      string `json:"id,omitempty"`
	Name    string `json:"name"`
	Content string `json:"content"`
	IsError bool   `json:"is_error,omitempty"`
}

type Turn struct {
	Text  string
	Files []FilePart
	Done  chan struct{}
}

type TurnCompleteEvent struct {
	BaseEvent
}

type UsageEvent struct {
	BaseEvent
	InputTokens  int `json:"input_tokens"`
	OutputTokens int `json:"output_tokens"`
	TotalTokens  int `json:"total_tokens"`
}

type WorkflowDoneEvent struct {
	BaseEvent
	Description string   `json:"description"`
	Artifacts   []string `json:"artifacts"`
}

type WorkflowFailedEvent struct {
	BaseEvent
	Reason string `json:"reason"`
}

type WorkflowStartedEvent struct {
	BaseEvent
	Workflow string `json:"workflow"`
	Source   string `json:"source"`
}

type WorkflowStepDoneEvent struct {
	BaseEvent
	StepIdx int    `json:"step_idx"`
	Summary string `json:"summary"`
}

type WorkflowStepStartedEvent struct {
	BaseEvent
	StepIdx  int    `json:"step_idx"`
	StepName string `json:"step_name"`
	Provider string `json:"provider"`
	Model    string `json:"model"`
}