extensions

type API interface {
	On(EventType, Handler)
	// OnWithUnsubscribe registers a handler and returns an idempotent unsubscribe.
	OnWithUnsubscribe(EventType, Handler) func()
	RegisterTool(ToolDefinition)
	RegisterCommand(string, Command)
	RegisterShortcut(string, Shortcut)
	RegisterFlag(string, Flag)
	GetFlag(string) (any, bool)
	RegisterMessageRenderer(string, MessageRenderer)
	RegisterEntryRenderer(string, EntryRenderer)
	SendMessage(context.Context, CustomMessage, *SendMessageOptions) error
	SendUserMessage(context.Context, ai.UserContent, *SendUserMessageOptions) error
	AppendEntry(context.Context, string, any) error
	SetSessionName(context.Context, string) error
	GetSessionName(context.Context) (*string, error)
	SetLabel(context.Context, string, *string) error
	Exec(context.Context, string, []string, *ExecOptions) (ExecResult, error)
	GetActiveTools() ([]string, error)
	GetAllTools() ([]ToolInfo, error)
	SetActiveTools([]string) error
	GetCommands() ([]SlashCommandInfo, error)
	SetModel(context.Context, *ai.Model) (bool, error)
	GetThinkingLevel() (engine.ThinkingLevel, error)
	SetThinkingLevel(engine.ThinkingLevel) error
	RegisterProvider(Provider)
	RegisterProviderConfig(string, ProviderConfig)
	UnregisterProvider(string)
	Events() EventBus
}

type Actions struct {
	SendMessage            func(context.Context, CustomMessage, *SendMessageOptions) error
	SendUserMessage        func(context.Context, ai.UserContent, *SendUserMessageOptions) error
	AppendEntry            func(context.Context, string, any) error
	SetSessionName         func(context.Context, string) error
	GetSessionName         func(context.Context) (*string, error)
	SetLabel               func(context.Context, string, *string) error
	GetActiveTools         func() ([]string, error)
	GetAllTools            func() ([]ToolInfo, error)
	SetActiveTools         func([]string) error
	RefreshTools           func()
	GetCommands            func() ([]SlashCommandInfo, error)
	SetModel               func(context.Context, *ai.Model) (bool, error)
	GetThinkingLevel       func() (engine.ThinkingLevel, error)
	SetThinkingLevel       func(engine.ThinkingLevel) error
	RegisterProvider       func(Provider) error
	RegisterProviderConfig func(string, ProviderConfig) error
	UnregisterProvider     func(string) error
}

type ActivityOutcome string

type AfterProviderResponseEvent struct {
	Status  int
	Headers map[string]string
}

type AgentBeforeSettleEvent struct{ BoundaryState }

type AgentEndEvent struct{ Messages engine.AgentMessages }

type AgentSettledEvent struct{}

type AgentStartEvent struct{}

type AuthStatus struct {
	Configured bool   `json:"configured"`
	Source     string `json:"source,omitempty"`
	Label      string `json:"label,omitempty"`
}

type AutocompleteEditorComponent interface {
	EditorComponent
	SetAutocompleteProvider(AutocompleteProvider)
}

type AutocompleteItem struct {
	Value       string `json:"value"`
	Label       string `json:"label"`
	Description string `json:"description,omitempty"`
}

type AutocompleteProvider interface {
	TriggerCharacters() []string
	GetSuggestions(context.Context, AutocompleteRequest) (*AutocompleteResult, error)
	ApplyCompletion(AutocompleteRequest, AutocompleteItem, string) ([]string, int, int)
	ShouldTriggerFileCompletion(AutocompleteRequest) bool
}

type AutocompleteProviderFactory func(AutocompleteProvider) AutocompleteProvider

type AutocompleteRequest struct {
	Lines      []string
	CursorLine int
	CursorCol  int
	Signal     context.Context
	Force      bool
}

type AutocompleteResult struct {
	Prefix string
	Items  []AutocompleteItem
}

type BashResult struct {
	Output     string  `json:"output"`
	ExitCode   *int    `json:"exitCode"`
	Cancelled  bool    `json:"cancelled"`
	Truncated  bool    `json:"truncated"`
	FullOutput *string `json:"fullOutputPath,omitempty"`
}

type BeforeAgentStartCombinedResult struct {
	Messages            []CustomMessage     `json:"messages"`
	SystemPrompt        *string             `json:"-"`
	SystemPromptOptions SystemPromptOptions `json:"systemPromptOptions"`
}

type BeforeAgentStartEvent struct {
	Prompt              string
	Images              []*ai.ImageContent
	SystemPrompt        string
	SystemPromptOptions SystemPromptOptions
}

type BeforeAgentStartResult struct {
	Message      *CustomMessage
	SystemPrompt *string
}

type BeforeProviderHeadersEvent struct{ Headers ai.ProviderHeaders }

type BeforeProviderRequestEvent struct{ Payload any }

type BoundaryContextPreview struct {
	ContextEntries  []session.SessionEntry `json:"contextEntries"`
	ContextMessages engine.AgentMessages   `json:"contextMessages"`
	LLMMessages     ai.MessageList         `json:"llmMessages"`
	PendingMessages engine.AgentMessages   `json:"pendingMessages"`
	CanContinue     bool                   `json:"canContinue"`
}

type BoundaryDispatch struct {
	Entries  []SessionBoundaryDraft
	Continue bool
	Context  BoundaryContextPreview
	Valid    bool
}

type BoundaryResult struct {
	Entries  *[]SessionBoundaryDraft `json:"entries,omitempty"`
	Continue *bool                   `json:"continue,omitempty"`
}

type BoundaryState struct {
	Entries  []SessionBoundaryDraft `json:"entries"`
	Continue bool                   `json:"continue"`
	Context  BoundaryContextPreview `json:"context"`
	Outcome  ActivityOutcome        `json:"outcome"`
}

type Command struct {
	// SettingsLabel adds this command as a native Settings page when non-empty.
	SettingsLabel          string
	Name                   string
	SourceInfo             SourceInfo
	Description            string
	GetArgumentCompletions func(context.Context, string) ([]AutocompleteItem, error)
	Handler                func(context.Context, string, CommandContext) error
}

type CommandActions struct {
	WaitForIdle   func(context.Context) error
	NewSession    func(context.Context, *NewSessionOptions) (SessionReplacementResult, error)
	Fork          func(context.Context, string, *ForkOptions) (SessionReplacementResult, error)
	NavigateTree  func(context.Context, string, *NavigateTreeOptions) (SessionReplacementResult, error)
	SwitchSession func(context.Context, string, *SwitchSessionOptions) (SessionReplacementResult, error)
	Reload        func(context.Context) error
}

type CommandContext interface {
	Context
	GetSystemPromptOptions() SystemPromptOptions
	WaitForIdle(context.Context) error
	NewSession(context.Context, *NewSessionOptions) (SessionReplacementResult, error)
	Fork(context.Context, string, *ForkOptions) (SessionReplacementResult, error)
	NavigateTree(context.Context, string, *NavigateTreeOptions) (SessionReplacementResult, error)
	SwitchSession(context.Context, string, *SwitchSessionOptions) (SessionReplacementResult, error)
	Reload(context.Context) error
}

type CompactOptions struct {
	CustomInstructions string
	OnComplete         func(session.CompactionResult)
	OnError            func(error)
}

type CompactionReason string

type CompiledExtension struct {
	Name    string
	Factory Factory
	Hidden  bool
	// Replaceable built-ins step aside for an extension that registers one of
	// their tool, command, or flag names.
	Replaceable    bool
	DefaultEnabled bool
}

type CompiledLoadError struct {
	Name string
	Err  error
}

type Component interface{ Render(int) []string }

type ComponentFactory func(UIHost, Theme) Component

type Context interface {
	UI() UI
	Mode() Mode
	HasUI() bool
	CWD() string
	SessionManager() ReadonlySessionManager
	ModelRegistry() ModelRegistry
	Model() *ai.Model
	ScopedModels() []ScopedModel
	// ThinkingLevel is the current thinking level, when provided by the
	// session runtime; empty otherwise.
	ThinkingLevel() engine.ThinkingLevel
	IsIdle() bool
	IsProjectTrusted() bool
	Signal() context.Context
	Abort()
	HasPendingMessages() bool
	Shutdown()
	GetContextUsage() *ContextUsage
	Compact(*CompactOptions)
	GetSystemPrompt() string
}

type ContextActions struct {
	RequestInput           InputHandler
	GetModel               func() *ai.Model
	GetScopedModels        func() []ScopedModel
	IsIdle                 func() bool
	IsProjectTrusted       func() bool
	GetSignal              func() context.Context
	Abort                  func()
	HasPendingMessages     func() bool
	Shutdown               func()
	GetContextUsage        func() *ContextUsage
	Compact                func(*CompactOptions)
	GetSystemPrompt        func() string
	GetSystemPromptOptions func() SystemPromptOptions
}

type ContextEvent struct{ Messages engine.AgentMessages }

type ContextFile struct {
	Path    string `json:"path"`
	Content string `json:"content"`
}

type ContextResult struct{ Messages engine.AgentMessages }

type ContextUsage struct {
	Tokens        *int64
	ContextWindow int64
	Percent       *float64
}

type ContextWithSystemEvent struct{ Messages engine.AgentMessages }

type CustomDone func(any)

type CustomFactory func(UIHost, Theme, Keybindings, CustomDone) (Component, error)

type CustomMessage struct {
	CustomType string `json:"customType"`
	Content    any    `json:"content"`
	Display    bool   `json:"display"`
	Details    any    `json:"details,omitempty"`
}

type CustomOptions struct {
	Overlay               bool
	StaticOverlayOptions  *OverlayOptions
	DynamicOverlayOptions func() OverlayOptions
	OnHandle              func(OverlayHandle)
}

type DeliveryMode string

type Diagnostic struct {
	Type    string
	Message string
	Path    string
}

type DialogOptions struct {
	Signal  context.Context
	Timeout *int64
}

type DiscoveredPath struct {
	Path          string `json:"path"`
	ExtensionPath string `json:"extensionPath"`
}

type DiscoveredResources struct {
	SkillPaths  []DiscoveredPath `json:"skillPaths"`
	PromptPaths []DiscoveredPath `json:"promptPaths"`
	ThemePaths  []DiscoveredPath `json:"themePaths"`
}

type DisposableComponent interface {
	Component
	Dispose()
}

type EditorComponent interface {
	Component
	GetText() string
	SetText(string)
	HandleInput(string)
}

type EditorFactory func(UIHost, Theme, Keybindings) EditorComponent

type EntryRenderOptions struct{ Expanded bool }

type EntryRenderer func(any, EntryRenderOptions, Theme) Component

type Event interface {
	Type() EventType
}

type EventBus interface {
	Emit(context.Context, string, any) []error
	On(string, EventListener) func()
	Clear()
}

type EventListener func(context.Context, any) error

type EventType string

type ExecOptions struct {
	Context context.Context
	Timeout int64
	CWD     string
	Env     []string
}

type ExecResult struct {
	Stdout string `json:"stdout"`
	Stderr string `json:"stderr"`
	Code   int    `json:"code"`
	Killed bool   `json:"killed"`
}

type Extension struct {
	Path         string
	ResolvedPath string
	Hidden       bool
	// Replaceable built-ins step aside for an extension that registers one of
	// their tool, command, or flag names.
	Replaceable bool
	SourceInfo  SourceInfo
	// contains filtered or unexported fields
}

type ExtensionError struct {
	ExtensionPath string `json:"extensionPath"`
	Event         string `json:"event"`
	Error         string `json:"error"`
	Stack         string `json:"stack,omitempty"`
}

type Factory func(API) error

type Flag struct {
	Name          string
	Description   string
	Type          FlagType
	Default       any
	ExtensionPath string
}

type FlagType string

type FocusableComponent interface {
	InputComponent
	SetFocused(bool)
}

type FooterDataProvider interface {
	GitBranch() string
	Statuses() map[string]string
}

type FooterFactory func(UIHost, Theme, FooterDataProvider) Component

type ForkOptions struct {
	Position    ForkPosition
	WithSession func(context.Context, ReplacedSessionContext) error
}

type ForkPosition string

type Handler func(context.Context, Event, Context) (any, error)

type HeaderFactory func(UIHost, Theme) Component

type InputAction string

type InputComponent interface {
	Component
	HandleRawInput(data string)
	WantsKeyRelease() bool
}

type InputEvent struct {
	Text              string
	Images            []*ai.ImageContent
	Source            InputSource
	StreamingBehavior *DeliveryMode
}

type InputHandler func(context.Context, string, []string) (string, error)

type InputOptions struct {
	Presentation *InputPresentation
	Render       func(context.Context, UI) (string, error)
	Validate     func(string) error
}

type InputPresentation struct {
	Kind string          `json:"kind"`
	Data json.RawMessage `json:"data"`
}

type InputResult struct {
	Action InputAction        `json:"action"`
	Text   string             `json:"text,omitempty"`
	Images []*ai.ImageContent `json:"images,omitempty"`
}

type InputSource string

type KeybindingConflict struct {
	Key      string
	Bindings []string
}

type KeybindingDefinition struct {
	DefaultKeys []string
	Description string
}

type Keybindings interface {
	Matches(input, binding string) bool
	Keys(binding string) []string
	Definition(binding string) KeybindingDefinition
	Conflicts() []KeybindingConflict
	UserBindings() map[string][]string
	ResolvedBindings() map[string][]string
}

type LoadoutTool struct {
	Name        string        `json:"name"`
	Label       string        `json:"label"`
	Description string        `json:"description"`
	Parameters  ai.JSONSchema `json:"parameters"`
}

type MarkdownTransformContext struct {
	MessageType    string // "user" | "assistant" | "assistant-thinking"
	IsStreaming    bool
	AvailableWidth int
}

type MarkdownTransformer func(markdown string, context MarkdownTransformContext) string

type MessageEndEvent struct{ Message engine.AgentMessage }

type MessageEndResult struct{ Message engine.AgentMessage }

type MessageRenderOptions struct {
	Expanded  bool
	OutputPad int
}

type MessageRenderer func(CustomMessage, MessageRenderOptions, Theme) Component

type MessageStartEvent struct{ Message engine.AgentMessage }

type MessageUpdateEvent struct {
	Message               engine.AgentMessage
	AssistantMessageEvent ai.AssistantMessageEvent
}

type Mode string

type ModelRegistry interface {
	Reload() error
	Error() string
	Models() []ai.Model
	Find(provider, id string) (ai.Model, bool)
	HasConfiguredAuth(provider string, env map[string]string) bool
	GetProviderAuthStatus(provider string, env map[string]string) AuthStatus
	IsUsingOAuth(provider string) bool
	Available(env map[string]string) []ai.Model
	AvailableWithError(env map[string]string) ([]ai.Model, error)
	ResolveAPIKey(context.Context, string, map[string]string) (*string, error)
	ResolveProviderAuth(context.Context, string, map[string]string) (*aiauth.AuthResult, error)
	ResolveModelHeaders(context.Context, ai.Model, map[string]string, ...*string) (*map[string]string, error)
	StreamSimple(context.Context, *ai.Model, ai.Context, *ai.SimpleStreamOptions) (ai.AssistantMessageEventStream, error)
	Provider(string) (Provider, bool)
	ProviderDisplayName(string) string
	ProviderAuth(string) aiauth.ProviderAuth
	RegisteredProviderConfig(string) (ProviderConfig, bool)
	RegisteredNativeProvider(string) (Provider, bool)
	RegisteredProviderIDs() []string
	RegisterProvider(Provider) error
	RegisterProviderConfig(string, ProviderConfig) error
	UnregisterProvider(string) error
}

type ModelSelectEvent struct {
	Model         *ai.Model
	PreviousModel *ai.Model
	Source        ModelSelectSource
}

type ModelSelectSource string

type NavigateTreeOptions struct {
	Summarize           bool
	CustomInstructions  string
	ReplaceInstructions bool
	Label               string
}

type NewSessionOptions struct {
	// Prepare configures a new journal before the executor factory runs.
	Prepare       func(*session.SessionManager) error
	ParentSession string
	Setup         func(*session.SessionManager) error
	WithSession   func(context.Context, ReplacedSessionContext) error
}

type NoopUI struct{}

type NotificationType string

type OAuthAuthInfo struct {
	URL          string
	Instructions string
}

type OAuthCredentials struct {
	Refresh string         `json:"refresh"`
	Access  string         `json:"access"`
	Expires int64          `json:"expires"`
	Extra   map[string]any `json:"-"`
}

type OAuthDeviceCodeInfo struct {
	UserCode         string
	VerificationURI  string
	IntervalSeconds  int
	ExpiresInSeconds int
}

type OAuthLoginCallbacks struct {
	Signal            context.Context
	OnAuth            func(OAuthAuthInfo)
	OnDeviceCode      func(OAuthDeviceCodeInfo)
	OnPrompt          func(OAuthPrompt) (string, error)
	OnProgress        func(string)
	OnManualCodeInput func() (string, error)
	OnSelect          func(OAuthSelectPrompt) (*string, error)
}

type OAuthPrompt struct {
	Message     string
	Placeholder string
	AllowEmpty  bool
}

type OAuthProvider struct {
	Name         string
	Login        func(context.Context, OAuthLoginCallbacks) (OAuthCredentials, error)
	RefreshToken func(context.Context, OAuthCredentials) (OAuthCredentials, error)
	GetAPIKey    func(OAuthCredentials) (string, error)
	ModifyModels func([]ai.Model, OAuthCredentials) ([]ai.Model, error)
}

type OAuthSelectOption struct {
	ID    string
	Label string
}

type OAuthSelectPrompt struct {
	Message string
	Options []OAuthSelectOption
}

type OverlayAnchor string

type OverlayHandle interface {
	Hide()
	SetHidden(bool)
	IsHidden() bool
	Focus()
	Unfocus(...OverlayUnfocusOptions)
	IsFocused() bool
}

type OverlayOptions struct {
	Width        any
	MinWidth     int
	MaxHeight    any
	Anchor       OverlayAnchor
	OffsetX      int
	OffsetY      int
	Row          any
	Column       any
	Margin       any
	Visible      func(width, height int) bool
	NonCapturing bool
	// Backdrop dims the page behind the overlay so the window visibly floats.
	Backdrop bool
}

type OverlayUnfocusOptions struct {
	Target Component
}

type ProjectTrustContext interface {
	CWD() string
	Mode() Mode
	HasUI() bool
	UI() TrustUI
}

type ProjectTrustDecision string

type ProjectTrustEvent struct{ CWD string }

type ProjectTrustResult struct {
	Trusted  ProjectTrustDecision `json:"trusted"`
	Remember bool                 `json:"remember,omitempty"`
}

type Provider struct {
	ID            string
	Name          string
	BaseURL       string
	Headers       map[string]string
	Auth          aiauth.ProviderAuth
	Config        ProviderConfig
	FilterModels  func([]ai.Model, *aiauth.Credential) ([]ai.Model, error)
	GetModels     func() ([]ai.Model, error)
	RefreshModels func(RefreshModelsContext) error
	Stream        engine.StreamFn
	StreamSimple  engine.StreamFn
	// RegistrationValue is returned only to the VM that owns it; callbacks
	// above remain the cross-VM representation held by the shared registry.
	RegistrationValue any
}

type ProviderConfig struct {
	Name          string
	BaseURL       string
	APIKey        string
	API           ai.API
	Stream        engine.StreamFn
	Headers       map[string]string
	AuthHeader    *bool
	Models        []ProviderModelConfig
	RefreshModels func(RefreshModelsContext) ([]ProviderModelConfig, error)
	OAuth         *OAuthProvider
	Defined       map[string]bool
	// RegistrationValues retains owner-scoped values solely so the bridge can
	// expose the effective registration through the owning VM.
	RegistrationValues map[string]any
}

type ProviderModelConfig struct {
	ID               string
	Name             string
	API              ai.API
	BaseURL          string
	Reasoning        bool
	ThinkingLevelMap *map[ai.ModelThinkingLevel]*string
	Input            ai.InputModalities
	Cost             ai.ModelCost
	ContextWindow    float64
	MaxTokens        float64
	InputLimits      *ai.ModelInputLimits
	SamplingParams   map[string]any
	Headers          map[string]string
	Compat           json.RawMessage
}

type ProviderModelStore interface {
	Read(context.Context) (*ProviderModelsStoreEntry, error)
	Write(context.Context, ProviderModelsStoreEntry) error
	Delete(context.Context) error
}

type ProviderModelsStoreEntry struct {
	Models    []ai.Model `json:"models"`
	CheckedAt *int64     `json:"checkedAt,omitempty"`
}

type ProviderRequestResult struct {
	Payload any
	Replace bool
}

type ProviderStreamEvent struct {
	Provider ai.ProviderID
	API      ai.API
	Model    string
	Data     json.RawMessage
}

type ReadonlySessionManager interface {
	IsPersisted() bool
	GetCWD() string
	GetSessionDir() string
	GetSessionID() string
	GetSessionFile() string
	GetLeafID() *string
	GetLeafEntry() *session.SessionEntry
	GetEntry(string) *session.SessionEntry
	GetEntries() []session.SessionEntry
	GetHeader() *session.SessionHeader
	GetSessionName() *string
	GetLabel(string) *string
	GetChildren(string) []session.SessionEntry
	GetBranch(...string) []session.SessionEntry
	GetTree() []*session.SessionTreeNode
	BuildContextEntries() []session.SessionEntry
	BuildSessionContext() session.SessionContext
}

type RefreshModelsContext struct {
	Credential   *aiauth.Credential
	Store        ProviderModelStore
	AllowNetwork bool
	Force        bool
	Signal       context.Context
}

type RegisterOption func(*registerOptions)

type RegisteredTool struct {
	Definition ToolDefinition
	SourceInfo SourceInfo
}

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

type RenderShell string

type ReplacedSessionContext interface {
	CommandContext
	SendMessage(context.Context, CustomMessage, *SendMessageOptions) error
	SendUserMessage(context.Context, ai.UserContent, *SendUserMessageOptions) error
}

type ResolvedCommand struct {
	Command
	InvocationName string
}

type ResourcesDiscoverEvent struct {
	CWD    string
	Reason ResourcesDiscoverReason
}

type ResourcesDiscoverReason string

type ResourcesDiscoverResult struct {
	SkillPaths  []string `json:"skillPaths,omitempty"`
	PromptPaths []string `json:"promptPaths,omitempty"`
	ThemePaths  []string `json:"themePaths,omitempty"`
}

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

type RunnerOptions struct {
	CWD            string
	SessionManager ReadonlySessionManager
	ModelRegistry  ModelRegistry
	Mode           Mode
	UI             UI
	Actions        Actions
	ContextActions ContextActions
	CommandActions *CommandActions
	ErrorHandler   func(ExtensionError)
}

type ScopedModel struct {
	Model         ai.Model               `json:"model"`
	ThinkingLevel *ai.ModelThinkingLevel `json:"thinkingLevel,omitempty"`
}

type SendMessageOptions struct {
	// Tri-state as upstream: unset still steers a streaming turn, an explicit
	// false suppresses it, true prompts when idle.
	TriggerTurn *bool
	DeliverAs   DeliveryMode
}

type SendUserMessageOptions struct {
	DeliverAs DeliveryMode
	// ExpandPromptTemplates dispatches extension commands and expands skill
	// commands and prompt templates. Defaults to off, as upstream.
	ExpandPromptTemplates bool
}

type SessionBeforeCompactEvent struct {
	Preparation        harness.CompactionPreparation
	BranchEntries      []session.SessionEntry
	CustomInstructions *string
	Reason             CompactionReason
	WillRetry          bool
	Signal             context.Context
}

type SessionBeforeCompactResult struct {
	Cancel     bool
	Compaction *session.CompactionResult
}

type SessionBeforeForkEvent struct {
	EntryID  string
	Position ForkPosition
}

type SessionBeforeForkResult struct {
	Cancel                  bool
	SkipConversationRestore bool
}

type SessionBeforeSwitchEvent struct {
	Reason            SessionSwitchReason
	TargetSessionFile *string
}

type SessionBeforeSwitchResult struct{ Cancel bool }

type SessionBeforeTreeEvent struct {
	Preparation TreePreparation
	Signal      context.Context
}

type SessionBeforeTreeResult struct {
	Cancel              bool
	Summary             *TreeSummary
	CustomInstructions  *string
	ReplaceInstructions *bool
	Label               *string
}

type SessionBoundaryDraft struct {
	Type             string          `json:"type"`
	CustomType       string          `json:"customType,omitempty"`
	Data             any             `json:"data,omitempty"`
	Content          any             `json:"content,omitempty"`
	Display          bool            `json:"display,omitempty"`
	Details          any             `json:"details,omitempty"`
	TargetID         string          `json:"targetId,omitempty"`
	Replacement      json.RawMessage `json:"replacement,omitempty"`
	Summary          string          `json:"summary,omitempty"`
	FirstKeptEntryID *string         `json:"firstKeptEntryId,omitempty"`
	Usage            *ai.Usage       `json:"usage,omitempty"`
}

type SessionCompactEvent struct {
	CompactionEntry session.SessionEntry
	FromExtension   bool
	Reason          CompactionReason
	WillRetry       bool
}

type SessionCompactFailedEvent struct {
	Reason        CompactionReason
	ErrorMessage  *string `json:"errorMessage,omitempty"`
	Aborted       bool
	WillRetry     bool
	FromExtension bool
}

type SessionInfoChangedEvent struct{ Name *string }

type SessionReplacementResult struct{ Cancelled bool }

type SessionShutdownEvent struct {
	Reason            SessionShutdownReason
	TargetSessionFile *string
}

type SessionShutdownReason string

type SessionStartEvent struct {
	Reason              SessionStartReason
	PreviousSessionFile *string
}

type SessionStartReason string

type SessionSwitchReason string

type SessionTreeEvent struct {
	NewLeafID     *string
	OldLeafID     *string
	SummaryEntry  *session.SessionEntry
	FromExtension *bool
}

type Shortcut struct {
	Shortcut      string
	Description   string
	Handler       func(context.Context, Context) error
	ExtensionPath string
}

type Skill struct {
	Name                   string     `json:"name"`
	Description            string     `json:"description"`
	FilePath               string     `json:"filePath"`
	BaseDir                string     `json:"baseDir"`
	SourceInfo             SourceInfo `json:"sourceInfo"`
	DisableModelInvocation bool       `json:"disableModelInvocation"`
}

type SlashCommandInfo struct {
	Name        string             `json:"name"`
	Description string             `json:"description,omitempty"`
	Source      SlashCommandSource `json:"source"`
	SourceInfo  SourceInfo         `json:"sourceInfo"`
}

type SlashCommandSource string

type SourceInfo struct {
	Path    string       `json:"path"`
	Source  string       `json:"source"`
	Scope   SourceScope  `json:"scope"`
	Origin  SourceOrigin `json:"origin"`
	BaseDir *string      `json:"baseDir,omitempty"`
}

type SourceOrigin string

type SourceScope string

type SwitchSessionOptions struct {
	WithSession func(context.Context, ReplacedSessionContext) error
}

type SystemPromptOptions struct {
	CustomPrompt       *string             `json:"customPrompt,omitempty"`
	ForceSystemPrompt  *string             `json:"forceSystemPrompt,omitempty"`
	SelectedTools      []string            `json:"selectedTools"`
	ToolSnippets       map[string]string   `json:"toolSnippets"`
	ToolGuidelines     map[string][]string `json:"toolGuidelines"`
	PromptGuidelines   []string            `json:"promptGuidelines"`
	AppendSystemPrompt *string             `json:"appendSystemPrompt"`
	Sections           map[string]string   `json:"sections"`
	CWD                string              `json:"cwd"`
	ContextFiles       []ContextFile       `json:"contextFiles"`
	Skills             []Skill             `json:"skills"`
}

type TerminalInputHandler func(string) *TerminalInputResult

type TerminalInputResult struct {
	Consume bool
	Data    *string
}

type Theme interface {
	FG(color, text string) string
	BG(color, text string) string
	Bold(string) string
	Italic(string) string
	Underline(string) string
	Inverse(string) string
	Strikethrough(string) string
	FGANSI(string) string
	BGANSI(string) string
	ColorMode() string
	// Colors maps every token to its concrete #rrggbb color.
	Colors() map[string]string
	// Appearance is "dark" or "light".
	Appearance() string
	ThinkingBorderColor(engine.ThinkingLevel) func(string) string
	BashModeBorderColor() func(string) string
}

type ThemeInfo struct {
	Name string
	Path *string
}

type ThemeSetResult struct {
	Success bool
	Error   string
}

type ThinkingLevelSelectEvent struct {
	Level         engine.ThinkingLevel
	PreviousLevel engine.ThinkingLevel
}

type ToolAnnotations struct {
	ReadOnlyHint    *bool `json:"readOnlyHint,omitempty"`
	DestructiveHint *bool `json:"destructiveHint,omitempty"`
	IdempotentHint  *bool `json:"idempotentHint,omitempty"`
	OpenWorldHint   *bool `json:"openWorldHint,omitempty"`
}

type ToolCallEvent struct {
	ToolCallID       string
	ToolName         string
	ParentToolCallID string `json:",omitempty"`
	Input            map[string]any
}

type ToolCallHost struct {
	Tools   func() []LoadoutTool
	Execute func(ctx context.Context, parentToolCallID, name string, args any, onUpdate engine.AgentToolUpdateCallback) engine.AgentToolCallOutcome
}

type ToolCallResult struct {
	// Approved carries Go host consent without changing the JS extension protocol.
	Approved bool   `json:"-"`
	Block    bool   `json:"block,omitempty"`
	Reason   string `json:"reason,omitempty"`
}

type ToolContext interface {
	Context
	// Tools are the tools ExecuteTool can call.
	Tools() []LoadoutTool
	// ExecuteTool runs another tool through the same validation, hooks and
	// permission checks as model-issued calls. The call gets the id
	// "<calling id>/<n>" and its events carry ParentToolCallID; it is not in
	// the transcript but recorded on the caller's result. Failures (unknown
	// tools, validation errors, blocked calls) come back as IsError outcomes.
	ExecuteTool(ctx context.Context, name string, args any, onUpdate engine.AgentToolUpdateCallback) engine.AgentToolCallOutcome
}

type ToolDefinition struct {
	Name          string
	Label         string
	Description   string
	PromptSnippet string
	// PromptGuidelines is the registration-time snapshot of the tool's prompt
	// guidelines.
	PromptGuidelines []string
	// PromptGuidelinesFunc, when set, re-reads the tool's current prompt
	// guidelines (upstream tools may declare a lazy `get promptGuidelines()`
	// whose value changes between turns, e.g. an available-model list). The
	// session runtime consults it before building each turn's system prompt
	// and falls back to the PromptGuidelines snapshot on nil or error.
	PromptGuidelinesFunc func(context.Context) ([]string, error)
	Parameters           ai.JSONSchema
	ConstrainedSampling  *ai.ConstrainedSamplingConfig
	RenderShell          RenderShell
	PrepareArguments     engine.PrepareArgumentsFunc
	ExecutionMode        engine.ToolExecutionMode
	// OutputSchema is the JSON Schema of StructuredContent in successful results.
	OutputSchema ai.JSONSchema
	// Exposure defaults to ToolDirect.
	Exposure    ToolExposure
	Namespace   *ToolNamespace
	Annotations *ToolAnnotations
	// DefaultActive false keeps a direct or model-only tool off until named in
	// --tools, defaultTools or SetActiveTools.
	DefaultActive *bool
	// PrepareLoadout adjusts how the loadout is presented while this tool is
	// active; orchestrating tools list the callable tools in their description.
	PrepareLoadout func(ToolLoadout) *ToolLoadoutChanges
	Execute        func(context.Context, string, any, engine.AgentToolUpdateCallback, Context) (engine.AgentToolResult, error)
	RenderCall     func(any, Theme, ToolRenderContext) Component
	RenderResult   func(engine.AgentToolResult, ToolRenderResultOptions, Theme, ToolRenderContext) Component
}

type ToolExecutionEndEvent struct {
	ToolCallID       string
	ToolName         string
	Result           any
	IsError          bool
	ParentToolCallID string `json:",omitempty"`
}

type ToolExecutionStartEvent struct {
	ToolCallID       string
	ToolName         string
	Args             any
	ParentToolCallID string `json:",omitempty"`
}

type ToolExecutionUpdateEvent struct {
	ToolCallID       string
	ToolName         string
	Args             any
	PartialResult    any
	ParentToolCallID string `json:",omitempty"`
}

type ToolExposure string

type ToolInfo struct {
	Name             string           `json:"name"`
	Description      string           `json:"description"`
	Parameters       ai.JSONSchema    `json:"parameters"`
	PromptGuidelines []string         `json:"promptGuidelines,omitempty"`
	Exposure         ToolExposure     `json:"exposure"`
	Namespace        *ToolNamespace   `json:"namespace,omitempty"`
	Annotations      *ToolAnnotations `json:"annotations,omitempty"`
	SourceInfo       SourceInfo       `json:"sourceInfo"`
}

type ToolLoadout struct {
	// Declared are the active tools, in order, with their original descriptions.
	Declared []LoadoutTool `json:"declared"`
	// Callable are the tools reachable through ctx.ExecuteTool.
	Callable []LoadoutTool `json:"callable"`
	// Registered is every registered tool.
	Registered []LoadoutTool            `json:"registered"`
	Exposures  map[string]ToolExposure  `json:"exposures"`
	Namespaces map[string]ToolNamespace `json:"namespaces,omitempty"`
}

type ToolLoadoutChanges struct {
	// Descriptions are model-facing descriptions of declared tools, by name.
	Descriptions map[string]string `json:"descriptions,omitempty"`
	// HiddenDeclarations stay active and callable, and recorded in the
	// transcript, but requests leave their declarations out.
	HiddenDeclarations []string `json:"hiddenDeclarations,omitempty"`
}

type ToolNamespace struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	// Instructions is longer usage guidance, such as MCP server instructions;
	// not part of tool listings.
	Instructions string `json:"instructions,omitempty"`
}

type ToolRenderContext struct {
	Args             any
	ToolCallID       string
	Invalidate       func()
	LastComponent    Component
	State            map[string]any
	CWD              string
	ExecutionStarted bool
	ArgsComplete     bool
	IsPartial        bool
	Expanded         bool
	ShowImages       bool
	IsError          bool
}

type ToolRenderResultOptions struct {
	Expanded  bool
	IsPartial bool
}

type ToolResultEvent struct {
	ToolCallID        string
	ToolName          string
	ParentToolCallID  string `json:",omitempty"`
	Input             map[string]any
	Content           ai.ToolResultContent
	Details           any
	StructuredContent any `json:",omitempty"`
	IsError           bool
	Usage             *ai.Usage
}

type ToolResultResult struct {
	Content *ai.ToolResultContent
	Details *any
	IsError *bool
	Usage   *ai.Usage
}

type TreePreparation struct {
	TargetID            string
	OldLeafID           *string
	CommonAncestorID    *string
	EntriesToSummarize  []session.SessionEntry
	UserWantsSummary    bool
	CustomInstructions  *string
	ReplaceInstructions bool
	Label               *string
}

type TreeSummary struct {
	Summary string
	Details any
	Usage   *ai.Usage
}

type TrustUI interface {
	Select(context.Context, string, []string, *DialogOptions) (string, bool, error)
	Confirm(context.Context, string, string, *DialogOptions) (bool, error)
	Input(context.Context, string, *string, *DialogOptions) (string, bool, error)
	Notify(string, NotificationType)
}

type TurnEndEvent struct {
	TurnIndex          int
	Message            engine.AgentMessage
	ToolResults        []*ai.ToolResultMessage
	MessageEntryID     string
	ToolResultEntryIDs []string
	BoundaryState
}

type TurnStartEvent struct {
	TurnIndex int
	Timestamp int64
}

type UI interface {
	TrustUI
	OnTerminalInput(TerminalInputHandler) func()
	SetStatus(string, *string)
	SetWorkingMessage(*string)
	SetWorkingVisible(bool)
	SetWorkingIndicator(*WorkingIndicatorOptions)
	SetHiddenThinkingLabel(*string)
	SetWidget(string, *Widget, *WidgetOptions)
	SetFooter(FooterFactory)
	SetHeader(HeaderFactory)
	SetTitle(string)
	Custom(context.Context, CustomFactory, *CustomOptions) (any, bool, error)
	PasteToEditor(string)
	SetEditorText(string)
	GetEditorText() string
	Editor(context.Context, string, *string) (string, bool, error)
	AddAutocompleteProvider(AutocompleteProviderFactory)
	SetEditorComponent(EditorFactory)
	GetEditorComponent() EditorFactory
	Theme() Theme
	GetAllThemes() []ThemeInfo
	GetTheme(string) Theme
	SetTheme(any) ThemeSetResult
	GetToolsExpanded() bool
	SetToolsExpanded(bool)
}

type UIHost interface {
	Width() int
	Height() int
	Invalidate()
}

type UIPromptEndEvent UIPromptStartEvent

type UIPromptKind string

type UIPromptStartEvent struct {
	Reason string
	Kind   UIPromptKind
	Title  *string `json:"title,omitempty"`
}

type UserBashEvent struct {
	Command            string
	ExcludeFromContext bool
	CWD                string
}

type UserBashResult struct {
	Operations tools.BashOperations
	Result     *BashResult
}

type Widget struct {
	Lines   []string
	Factory ComponentFactory
}

type WidgetOptions struct{ Placement WidgetPlacement }

type WidgetPlacement string

type WorkingIndicatorOptions struct {
	Frames     []string
	IntervalMS int64
}