codingagent

type AgentSessionRuntimeDiagnostic struct {
	Type    string
	Message string
}

type BashExecutionEntry struct {
	SessionEntryBase
	Role               string `json:"-"` // always "bashExecution"; set on read
	Command            string `json:"-"`
	Output             string `json:"-"`
	ExitCode           *int   `json:"-"`
	Cancelled          bool   `json:"-"`
	Truncated          bool   `json:"-"`
	FullOutputPath     string `json:"-"`
	ExcludeFromContext bool   `json:"-"`
}

type BashExecutionMessage struct {
	Role               string `json:"role"` // "bashExecution"
	Command            string `json:"command"`
	Output             string `json:"output"`
	ExitCode           *int   `json:"exitCode"`
	Cancelled          bool   `json:"cancelled"`
	Truncated          bool   `json:"truncated"`
	FullOutputPath     string `json:"fullOutputPath,omitempty"`
	Timestamp          int64  `json:"timestamp,omitempty"`
	ExcludeFromContext bool   `json:"excludeFromContext,omitempty"`
}

type BinaryUpdate struct {
	CurrentVersion string
	LatestVersion  string
	Command        string // the command that applies it: "/upgrade"
}

type BranchSummaryConfig struct {
	ReserveTokens int
	SkipPrompt    bool
}

type BranchSummaryEntry struct {
	SessionEntryBase
	FromID   string    `json:"fromId"`
	Summary  string    `json:"summary"`
	Details  any       `json:"details,omitempty"`
	FromHook bool      `json:"fromHook,omitempty"`
	Usage    *ai.Usage `json:"usage,omitempty"`
}

type BranchSummarySettings struct {
	ReserveTokens *int  `json:"reserveTokens,omitempty"`
	SkipPrompt    *bool `json:"skipPrompt,omitempty"`
}

type BugReportAssistantDiagnostic struct {
	EntryID       string                          `json:"entryId"`
	Timestamp     string                          `json:"timestamp"`
	Provider      string                          `json:"provider"`
	Model         string                          `json:"model"`
	API           string                          `json:"api"`
	StopReason    string                          `json:"stopReason"`
	RawStopReason string                          `json:"rawStopReason,omitempty"`
	ErrorMessage  string                          `json:"errorMessage,omitempty"`
	Diagnostics   []ai.AssistantMessageDiagnostic `json:"diagnostics"`
}

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

type BugReportBundle struct {
	Metadata     BugReportMetadata
	Diagnostics  BugReportDiagnostics
	SessionJSONL *string
	Summary      *string
}

type BugReportDiagnostics struct {
	SchemaVersion         int                            `json:"schemaVersion"`
	SessionID             string                         `json:"sessionId"`
	EntryCount            int                            `json:"entryCount"`
	AssistantMessageCount int                            `json:"assistantMessageCount"`
	Assistant             []BugReportAssistantDiagnostic `json:"assistant"`
	Crashes               []CrashRecord                  `json:"crashes"`
}

type BugReportEnvironment struct {
	Version   string               `json:"version"`
	UserAgent string               `json:"userAgent"`
	Runtime   string               `json:"runtime"`
	Platform  string               `json:"platform"`
	Arch      string               `json:"arch"`
	OSRelease string               `json:"osRelease"`
	OSVersion string               `json:"osVersion"`
	Shell     *string              `json:"shell"`
	Terminal  BugReportTerminalEnv `json:"terminal"`
	// EnvironmentVariables lists WOPR_* names only; values never leave the
	// machine.
	EnvironmentVariables []string `json:"environmentVariables"`
}

type BugReportFile struct {
	Name string
	Data []byte
}

type BugReportInputs struct {
	Version         string
	SessionID       string
	CWD             string
	MessageCount    int
	Model           *ai.Model
	Provider        *BugReportProvider
	ThinkingLevel   string
	GlobalSettings  Settings
	ProjectSettings Settings
	Entries         []SessionEntry
	Branch          []SessionEntry
	Header          SessionHeader
}

type BugReportMetadata struct {
	SchemaVersion int                  `json:"schemaVersion"`
	ID            string               `json:"id"`
	CreatedAt     string               `json:"createdAt"`
	Hint          *string              `json:"hint"`
	Environment   BugReportEnvironment `json:"environment"`
	Session       BugReportSessionInfo `json:"session"`
	Model         *BugReportModel      `json:"model"`
	Provider      *BugReportProvider   `json:"provider"`
	ThinkingLevel string               `json:"thinkingLevel"`
	Settings      BugReportSettings    `json:"settings"`
}

type BugReportModel struct {
	Provider         string              `json:"provider"`
	ID               string              `json:"id"`
	Name             string              `json:"name"`
	API              string              `json:"api"`
	BaseURL          string              `json:"baseUrl"`
	Reasoning        bool                `json:"reasoning"`
	Input            []string            `json:"input"`
	ContextWindow    int                 `json:"contextWindow"`
	MaxTokens        int                 `json:"maxTokens"`
	SamplingParams   any                 `json:"samplingParams"`
	Compat           any                 `json:"compat"`
	ThinkingLevelMap ai.ThinkingLevelMap `json:"thinkingLevelMap"`
	HeaderNames      []string            `json:"headerNames"`
}

type BugReportOptions struct {
	Hint           string
	IncludeSession bool
}

type BugReportProvider struct {
	ID                  string              `json:"id"`
	Name                string              `json:"name"`
	BaseURL             *string             `json:"baseUrl"`
	HeaderNames         []string            `json:"headerNames"`
	AuthStatus          BugReportAuthStatus `json:"authStatus"`
	UsingOAuth          bool                `json:"usingOAuth"`
	RegisteredAtRuntime bool                `json:"registeredAtRuntime"`
}

type BugReportSessionEntryData struct {
	ID              string  `json:"id"`
	CreatedAt       string  `json:"createdAt"`
	Hint            *string `json:"hint"`
	SessionIncluded bool    `json:"sessionIncluded"`
	SummaryIncluded bool    `json:"summaryIncluded"`
	Delivery        string  `json:"delivery"`
	Path            string  `json:"path,omitempty"`
}

type BugReportSessionInfo struct {
	ID              string `json:"id"`
	Included        bool   `json:"included"`
	SummaryIncluded bool   `json:"summaryIncluded"`
	MessageCount    int    `json:"messageCount"`
	CWD             string `json:"cwd,omitempty"`
}

type BugReportSettings struct {
	Global  any `json:"global"`
	Project any `json:"project"`
}

type BugReportTerminalEnv struct {
	Term           *string `json:"term"`
	Program        *string `json:"program"`
	ProgramVersion *string `json:"programVersion"`
	Colorterm      *string `json:"colorterm"`
	Tmux           bool    `json:"tmux"`
	SSH            bool    `json:"ssh"`
	CI             bool    `json:"ci"`
}

type BuiltinSlashCommand struct {
	Name        string
	Aliases     []string
	Description string
	// ArgumentHint is shown after the command in autocomplete (e.g.
	// "<provider/model>").
	ArgumentHint string
	// Hidden commands dispatch normally but are omitted from autocomplete
	// and the docs (e.g. /debug).
	Hidden bool
	// contains filtered or unexported fields
}

type CacheWarmRequest struct {
	Model   *ai.Model
	Context ai.TranscriptContext
	Options ai.StreamOptions
}

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

type CacheWarmerSessionManager interface {
	AppendUsage(kind, provider, model string, usage ai.Usage, note string) (UsageEntry, error)
	GetBranch() []SessionEntry
}

type CacheWarmingAction string

type CacheWarmingDecision struct {
	// Phase is "streaming" while the agent run that sent the request is still
	// active, then "idle".
	Phase string `json:"phase"`
	// WarmCost is the price of this refresh: a cache read of the prompt plus
	// one output token.
	WarmCost float64 `json:"warmCost"`
	// MissCost is the extra price of the next real request if the entry is lost.
	MissCost float64 `json:"missCost"`
	// ContinuationProbability estimates the chance that a real request
	// arrives before the entry expires.
	ContinuationProbability float64 `json:"continuationProbability"`
	// ExpectedSavings is ContinuationProbability*MissCost - WarmCost.
	ExpectedSavings float64 `json:"expectedSavings"`
	// EconomicsAvailable is false when the prompt size or prices are unknown.
	EconomicsAvailable bool `json:"economicsAvailable"`
	// Action is "warm" when ExpectedSavings is at least $0.05.
	Action CacheWarmingAction `json:"action"`
}

type CacheWarmingMode string

type CacheWarmingStatus struct {
	// State is "inactive", "scheduled" (a refresh timer is armed), or
	// "refreshing" (a warm request is in flight).
	State string `json:"state"`
	// Reason says why nothing is scheduled.
	Reason string `json:"reason,omitempty"`
	// NextWarmAt is the Unix millisecond time of the next decision, or 0.
	NextWarmAt int64 `json:"nextWarmAt,omitempty"`
	// Decision is the pending decision, or the decision that stopped warming.
	Decision *CacheWarmingDecision `json:"decision,omitempty"`
}

type ChangelogEntry struct {
	Major   int
	Minor   int
	Patch   int
	Content string // includes the `## [x.y.z]` header line itself, trimmed
}

type ChatViewport struct {
	Root       tui.Component
	Transcript *tui.ScrollView
}

type ChatViewportOptions struct {
	Document        tui.Component
	PendingMessages tui.Component
	Status          tui.Component
	Editor          tui.Component
	Footer          tui.Component
	WidgetsAbove    tui.Component
	WidgetsBelow    tui.Component
	Sidebar         tui.Component
	// SidebarVisible decides the sidebar's visibility at a terminal width;
	// nil shows it on terminals wider than 120 columns.
	SidebarVisible      func(width int) bool
	Scrollbar           string
	ScrollbarTrackStyle func(text string) string
	ScrollbarThumbStyle func(text string) string
}

type CompactionConfig struct {
	Enabled          bool
	ReserveTokens    int
	KeepRecentTokens int
	MaxContextTokens int
}

type CompactionEntry struct {
	SessionEntryBase
	Summary          string    `json:"summary"`
	FirstKeptEntryID string    `json:"firstKeptEntryId"`
	TokensBefore     int       `json:"tokensBefore"`
	Details          any       `json:"details,omitempty"`
	Usage            *ai.Usage `json:"usage,omitempty"`
	FromHook         bool      `json:"fromHook"`
	// SystemMessage is the complete prompt and tool state at this compaction
	// boundary. It is absent when the projected context has no system state.
	SystemMessage json.RawMessage `json:"systemMessage,omitempty"`
}

type CompactionModelOverride struct {
	ReserveTokens    *int `json:"reserveTokens,omitempty"`
	KeepRecentTokens *int `json:"keepRecentTokens,omitempty"`
}

type CompactionSettingsJSON struct {
	Enabled          *bool `json:"enabled,omitempty"`
	ReserveTokens    *int  `json:"reserveTokens,omitempty"`
	KeepRecentTokens *int  `json:"keepRecentTokens,omitempty"`
	// MaxContextTokens compacts once the context passes it, even on a larger
	// window. Default 200000; 0 lets the window alone decide.
	MaxContextTokens *int `json:"maxContextTokens,omitempty"`
	// ModelOverrides maps exact "provider/modelId" keys to token settings
	// that take precedence for that model.
	ModelOverrides map[string]CompactionModelOverride `json:"modelOverrides,omitempty"`
}

type ContextEditEntry struct {
	SessionEntryBase
	TargetID    string                  `json:"targetId"`
	Replacement *ContextEditReplacement `json:"replacement"`
}

type ContextEditReplacement struct {
	Content json.RawMessage `json:"content"`
}

type ContextFile struct {
	Path    string
	Content string
}

type CrashInput struct {
	Kind        string
	Message     string
	Stack       string
	SessionFile string
	CWD         string
	Version     string
}

type CrashRecord struct {
	Timestamp   string  `json:"timestamp"`
	Version     string  `json:"version"`
	Kind        string  `json:"kind"`
	Message     string  `json:"message"`
	Stack       *string `json:"stack"`
	SessionFile *string `json:"sessionFile"`
	CWD         string  `json:"cwd"`
	Notified    bool    `json:"notified,omitempty"`
}

type CustomEntry struct {
	SessionEntryBase
	CustomType string `json:"customType"`
	Data       any    `json:"data,omitempty"`
}

type CustomMessageEntry struct {
	SessionEntryBase
	CustomType string `json:"customType"`
	Content    any    `json:"content"` // string | []ContentBlock
	Display    bool   `json:"display"`
	Details    any    `json:"details,omitempty"`
}

type DiagnosticsSettings struct {
	// Enabled defaults to true.
	Enabled *bool `json:"enabled,omitempty"`
	// TimeoutMs bounds one checker run (default 4000).
	TimeoutMs int `json:"timeoutMs,omitempty"`
	// Commands overrides the checker per language (go, typescript,
	// javascript, python, shell) with {file} and {dir} placeholders; "off"
	// turns a language off.
	Commands map[string]string `json:"commands,omitempty"`
}

type ImageSettings struct {
	// AutoResize fits images to the width. Default: true.
	AutoResize *bool `json:"autoResize,omitempty"`
	// BlockImages hides images in the transcript. Default: false.
	BlockImages *bool `json:"blockImages,omitempty"`
}

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

type InteractiveOptions struct {
	CWD      string
	AgentDir string
	Model    *ai.Model
	// SettingsManager holds the settings, including this run's flag
	// overrides. Wired by main.go via coding.Services.
	SettingsManager *SettingsManager
	// SystemPrompt overrides the assembled system prompt. If empty,
	// callers should build one via prompts.BuildDefaultPrompt and pass
	// it in.
	SystemPrompt string
	// AllowedTools restricts which tool names may execute. nil means no
	// restriction; a non-nil empty map blocks every tool. Set from the
	// `tools:` allowlist on agent .md frontmatter.
	AllowedTools map[string]struct{}
	// ActiveBuiltinTools, when non-nil, restricts which built-in coding
	// tools are active (caller tools unaffected). nil = all
	// built-in tools. CLI default [read, bash, edit, write]; grep/find/ls
	// inactive unless requested via --tools.
	ActiveBuiltinTools map[string]struct{}
	// ExcludedTools is a denylist of tool names made non-callable, gating
	// built-in and caller tools alike.
	ExcludedTools map[string]struct{}
	// NoBuiltinTools hides built-in tools while leaving custom tools.
	NoBuiltinTools bool
	// PromptPaths lists additional prompt-template directories.
	// Directories are searched after the default <agentDir>/prompts/ and
	// <cwd>/.wopr/prompts/ (last-wins by name, same as project scope).
	PromptPaths []string
	// SessionDir overrides the on-disk session directory used by /new,
	// /resume, and other interactive session-management flows.
	SessionDir string
	// SessionID specifies an exact session ID for new sessions.
	// Set by --session-id. When non-empty and no
	// existing session matches, Create uses this ID instead of
	// generating a random one.
	SessionID string
	// ThemePaths lists additional theme files/directories to load.
	ThemePaths []string
	// NoPromptTemplates disables prompt template discovery.
	NoPromptTemplates bool
	// NoThemes disables custom theme discovery from disk.
	NoThemes bool

	// SessionHandle, when non-nil, is the pre-constructed agent +
	// on-disk session that InteractiveMode wraps for the TUI.
	// Constructed by the caller via coding.NewSession from the public
	// SDK package; main.go does the bridging between coding.* and
	// internal/codingagent.*. When nil, Run() returns an error: the
	// SDK is the only supported construction path post-Chunk F.
	//
	// Mutually exclusive with ResumePath: if SessionHandle is set,
	// the caller is responsible for having loaded the session via
	// coding.NewSession's ResumePath field.
	SessionHandle InteractiveSessionHandle

	// ContextUsage returns the live Session projection estimate for footer updates.
	ContextUsage func() (tokens *int, contextWindow int)

	// ModelBuilder constructs an *ai.Model from a "<provider>/<id>"
	// spec. Wired by main.go to coding.BuildModel: the public SDK
	// can't be imported from internal/codingagent (cycle), so the
	// caller injects the constructor. nil disables /model switching
	// (handler falls back to print-only).
	ModelBuilder func(spec string) (*ai.Model, error)

	// RequestAuthRuntime is the composed checkAuth/getAuth surface used by
	// warning-only auth checks. Wired by main.go from the same credential and
	// provider configuration used for model requests.
	RequestAuthRuntime *RequestAuthRuntime

	// ModelRegistry is the model registry for auth-aware operations
	// (Refresh, GetAvailable, HasConfiguredAuth). Wired by main.go.
	// nil is safe; post-login refresh is skipped.
	ModelRegistry *ModelRegistry

	// ResumePath, when non-empty, is loaded as the active session at
	// startup. The agent's message history is rebuilt from
	// session.BuildContext() and the transcript is replayed inline so
	// the user sees prior conversation.
	ResumePath string
	// InitialMessage, when non-empty, is auto-submitted to the agent
	// immediately after the TUI initialises. Sourced by main.go from
	// positional args + piped stdin so users can `wopr "hello"`,
	// `wopr < file.txt`, or pipe + run.
	InitialMessage string
	InitialImages  []ai.ImageContent
	// InitialMessages are the positional messages after the first. Each is
	// sent as its own prompt once the previous one settles.
	InitialMessages []string

	// AppVersion is wopr's release version. It records the last changelog
	// version seen and gates the startup "what's new" notification.
	AppVersion string

	// BinaryUpdateChecker, if set, is invoked asynchronously at startup and
	// returns a newer-release notice for the wopr binary itself, or nil. The
	// notice names the command that applies it (/upgrade).
	BinaryUpdateChecker func() *BinaryUpdate

	// ReleaseSource is where /upgrade reads releases; nil disables /upgrade.
	ReleaseSource func() ReleaseSource

	// Llama is the built-in llama.cpp provider: /llama manages its router
	// models, /login configures it, and startup refreshes its catalog.
	Llama *llama.Host
	// OfflineMode skips startup network catalog refreshes, like WOPR_OFFLINE.
	OfflineMode bool

	// ResourceSourceInfoProvider returns source metadata for currently known
	// prompts/skills/themes, keyed by absolute path. Used to enrich
	// verbose startup output and /reload diagnostics with package origin.
	ResourceSourceInfoProvider func() map[string]ResourceSourceInfo
	// ReloadResourceProvider recomputes settings-backed prompt/theme/skill/
	// context-file inputs on /reload instead of reusing startup snapshots.
	ReloadResourceProvider func() ReloadResourceSnapshot

	// Verbose forces verbose startup output (overrides quietStartup).
	Verbose bool

	// Skills is the loaded set of skill definitions, used to expand
	// /skill:name commands in user prompts.
	Skills []*SkillDef
	// RebuildSystemPrompt reconstructs the base system prompt + structured
	// prompt options after /reload from the current skills/context files.
	RebuildSystemPrompt func(skills []*SkillDef, contextFiles []ContextFile) string
	// SkillPaths are the source paths from which Skills were loaded.
	// Used by /reload to re-discover skills from disk. If empty, skills
	// are not reloaded (only the initial set from startup is used).
	SkillPaths []string
	// NoSkills disables skill loading and reload.
	NoSkills bool

	// ContextFiles lists the loaded AGENTS.md/CLAUDE.md project context files.
	// Shown in the startup banner when verbose/non-quiet.
	ContextFiles []ContextFile

	// ThinkingLevel is the initial thinking level override from --thinking.
	// Empty means use default (settings or "medium").
	ThinkingLevel string

	// NoModelWarning, when non-empty, is rendered as a yellow warning
	// line immediately before the welcome banner, e.g. "Warning: No models
	// available. ..." when the user starts without `--model` and has no
	// detectable credentials.
	NoModelWarning string
	// RunSetup opens setup at launch (wopr setup). Setup also opens on its
	// own on a first run.
	RunSetup bool
	// ModelFromFlag reports a model named on the command line: an explicit
	// choice, so a first run doesn't open setup.
	ModelFromFlag bool
	// StartupDiagnostics are shown in the chat after the welcome banner.
	StartupDiagnostics []AgentSessionRuntimeDiagnostic

	// StartupMark, when non-nil, is called at key phases during Run()
	// for startup timing. See cmd/wopr/startup_trace.go.
	StartupMark func(label string)
}

type InteractiveSessionHandle interface {
	// Agent returns the underlying agent loop.
	Agent() *agent.Agent
	// Inner returns the on-disk session. The local-package type
	// reference (*Session) is the same as *icodingagent.Session
	// from coding/'s point of view.
	Inner() *Session
	// Events returns the agent's streaming event channel. Used by
	// processAgentEvents to drive live UI updates.
	Events() <-chan agent.AgentEvent
	// SetModel swaps the active LLM model mid-session and persists a
	// model_change audit entry.
	SetModel(*ai.Model, ...ModelMutationOptions) error
	// SetThinkingLevel applies and records reasoning without changing defaults unless Persist is set.
	SetThinkingLevel(ai.ThinkingLevel, ...ModelMutationOptions) error
	// StreamModel starts a mode-independent model operation through the
	// Session-owned runtime.
	StreamModel(context.Context, *ai.Model, ai.Context, ai.StreamOptions) *ai.AssistantMessageEventStream
	// AbortCompaction cancels an in-flight Compact() call. Safe to
	// call when no compaction is running (no-op).
	AbortCompaction()
	// CheckPromptCompaction runs prompt()'s compaction check before a new
	// user message starts a run.
	CheckPromptCompaction(ctx context.Context) error
	// RunAgentPrompt runs one agent run to settlement: start seeds it, then
	// automatic retry, overflow and length recovery, threshold compaction,
	// and queued input continue it until nothing asks for another run or ctx
	// is cancelled. The Events consumer must acknowledge the barriers it
	// waits on (see eventBarrier).
	RunAgentPrompt(ctx context.Context, start func(context.Context) ([]agent.AgentMessage, error)) ([]agent.AgentMessage, error)
	// AbortRetry cancels a pending automatic-retry delay without aborting
	// the run.
	AbortRetry()
	// AbortBranchSummary cancels an in-flight branch summarization. Safe
	// to call when no summarization is running (no-op).
	AbortBranchSummary()
	// ReplaceInner swaps the underlying on-disk session. Used by /resume
	// to point the SessionHandle at a newly loaded session so tree
	// navigation and compaction operate on the correct entries.
	ReplaceInner(sess *Session)
	// NavigateTree forks the session to targetID with optional branch
	// summarization. Returns NavigateTreeResult.
	NavigateTreeHandle(ctx context.Context, targetID string, summarize bool, customInstructions string) (NavigateTreeResult, error)
	// CacheWarmingStatus reports the Session's cache warmer, or nil when it
	// has none.
	CacheWarmingStatus() *CacheWarmingStatus
	// SetCacheWarmingMode persists the mode and reconciles active warming.
	SetCacheWarmingMode(CacheWarmingMode) error
	// OnAgentSettled tells the cache warmer that an agent run settled.
	OnAgentSettled()
}

type KeyID = string

type KeybindingDefinition struct {
	DefaultKeys []KeyID
	Description string
}

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

type LabelEntry struct {
	SessionEntryBase
	TargetID string  `json:"targetId"`
	Label    *string `json:"label"`
}

type LoadPromptTemplatesResult struct {
	Templates   []PromptTemplate
	Diagnostics []ResourceDiagnostic
}

type MCPController interface {
	// MCPCommand runs one /mcp subcommand and returns markdown.
	MCPCommand(args string) (string, error)
}

type MarkdownMessageType string

type MarkdownSettings struct {
	// Mermaid is "streaming" (the default), "final", or "off".
	Mermaid string `json:"mermaid,omitempty"`
}

type MarkdownTransformContext struct {
	MessageType    MarkdownMessageType
	IsStreaming    bool
	AvailableWidth int
}

type MessageEntry struct {
	SessionEntryBase
	Message agent.AgentMessage `json:"message"`
}

type ModelChangeEntry struct {
	SessionEntryBase
	Provider string `json:"provider"`
	ModelID  string `json:"modelId"`
}

type ModelEntry struct {
	ProviderID       string
	ModelID          string
	APIKey           string
	BaseURL          string
	DisplayName      string
	API              string            // "openai-completions" | "anthropic-messages" | etc.
	Headers          map[string]string // resolved request headers from provider/model configuration
	ModelHeaders     map[string]string // intrinsic public Model.headers from the generated catalog
	AuthHeader       bool              // put API key in Authorization header (for custom providers)
	Compat           *ai.ModelCompat   // compat flags for OpenAI-compatible providers
	Reasoning        bool              // whether the model supports reasoning/thinking
	ThinkingLevelMap ai.ThinkingLevelMap
	SamplingParams   map[string]any
	InputLimits      *ai.ModelInputLimits
	Input            []string // ["text"] or ["text","image"]
	ContextWindow    int      // default: ai.DefaultContextWindow
	MaxTokens        int      // default: 16384
	InputCost        float64
	OutputCost       float64
	CacheReadCost    float64
	CacheWriteCost   float64
	CostTiers        []ai.CostTier
	// PriceUnknown marks a model nothing gave a price for: zero costs are
	// unknown, not free.
	PriceUnknown bool
	PromptCache  ai.ModelPromptCache
	Env          map[string]string // provider-scoped env overrides (auth.json env)
	Insecure     bool              // skip TLS verification (self-signed/internal-CA on-prem endpoints)
}

type ModelMutationOptions struct {
	Persist bool
}

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

type NavigateTreeResult struct {
	EditorText string
	Cancelled  bool
	Aborted    bool
}

type ParsedSkillBlockFromText struct {
	Name        string
	Location    string
	Content     string
	UserMessage string // trailing user text after </skill>\n\n, or ""
}

type ProcessedCLIArgs struct {
	Text   string
	Images []ai.ImageContent
}

type ProjectTrustOption struct {
	Label     string
	Trusted   bool
	Updates   []ProjectTrustUpdate
	SavedPath string
}

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

type ProjectTrustStoreEntry struct {
	Path     string
	Decision bool
}

type ProjectTrustUpdate struct {
	Path     string
	Decision *bool
}

type ProjectedSessionEntry struct {
	SourceEntry SessionEntry
	Messages    []agent.AgentMessage
}

type PromptTemplate struct {
	Name         string // basename without .md
	Description  string // from frontmatter, or first non-empty body line truncated to 60
	ArgumentHint string // from frontmatter `argument-hint`, optional
	Content      string // body (without frontmatter)
	FilePath     string // absolute path on disk
	Scope        string // "user" | "project" | "external"
}

type ProviderRetryConfig struct {
	TimeoutMs       int
	MaxRetries      int
	MaxRetryDelayMs int
}

type ProviderRetrySettings struct {
	TimeoutMs  *int `json:"timeoutMs,omitempty"`
	MaxRetries *int `json:"maxRetries,omitempty"`
	// MaxRetryDelayMs caps each retry delay; an explicit 0 removes the cap.
	// Default: 60000.
	MaxRetryDelayMs *int `json:"maxRetryDelayMs,omitempty"`
}

type ReleaseArchive struct {
	Version string
	Name    string // wopr-<version>-<goos>-<goarch>.tar.gz
	Dir     string // top-level directory inside the archive
	URL     string
	SHA256  string
}

type ReleaseSource struct {
	// BaseURL is the GitHub web origin (https://github.com). Tests point it
	// at an httptest TLS server.
	BaseURL string
	// Repo is owner/name.
	Repo string
	// PublicKey is the base64 Ed25519 key that must sign SHA256SUMS. Empty
	// fails closed.
	PublicKey string
	Client    *http.Client
	// GOOS and GOARCH select the archive; empty means the running platform.
	GOOS, GOARCH string
}

type ReloadResourceSnapshot struct {
	PromptPaths        []string
	ThemePaths         []string
	SkillPaths         []string
	ContextFiles       []ContextFile
	ResourceSourceInfo map[string]ResourceSourceInfo
}

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

type RequestAuthRuntimeOptions struct {
	Credentials ai.CredentialStore
	// AgentDir holds models.json; empty means no models.json.
	AgentDir string
	// RefreshOnCreate computes configured-provider availability at creation.
	RefreshOnCreate bool
	// AuthContext overrides the process environment and filesystem.
	AuthContext *ai.AuthContext
}

type ResourceCollision struct {
	ResourceType string
	Name         string
	WinnerPath   string
	LoserPath    string
}

type ResourceDiagnostic struct {
	// Type is "warning" or "collision".
	Type      string
	Message   string
	Path      string
	Collision *ResourceCollision
}

type ResourceSourceInfo struct {
	Path         string
	ResourceType string // "skills" | "prompts" | "themes"
	Enabled      bool
	Scope        string // "user" | "project"
	Origin       string // "package" | "top-level"
	Source       string // package source string or "local"
	BaseDir      string // package root for package-relative shortening
}

type RetryConfig struct {
	Enabled     bool
	MaxRetries  int
	BaseDelayMs int
	MaxDelayMs  int
}

type RetrySettingsJSON struct {
	Enabled         *bool                  `json:"enabled,omitempty"`
	MaxRetries      *int                   `json:"maxRetries,omitempty"`
	BaseDelayMs     *int                   `json:"baseDelayMs,omitempty"`
	MaxAgentDelayMs *int                   `json:"maxAgentDelayMs,omitempty"`
	Provider        *ProviderRetrySettings `json:"provider,omitempty"`
}

type RouterController interface {
	// RouterCommand runs one /router subcommand and returns markdown.
	RouterCommand(args string) (string, error)
}

type RuntimeModel struct {
	Provider string
	ID       string
	Name     string
	// Headers are the model's intrinsic catalog headers.
	Headers ai.ProviderHeaders
}

type RuntimeProvider struct {
	ID   string
	Auth ai.ProviderAuth
	// contains filtered or unexported fields
}

type SelfUpdateActionResult struct {
	Done    bool
	Action  string
	Message string
	Cause   error
}

type SelfUpdateProvenance struct {
	Tier    SelfUpdateTier
	ExePath string
}

type SelfUpdateRefused struct{ Message string }

type SelfUpdateResult struct {
	Latest string
	// UpToDate means nothing was installed because current is the latest.
	UpToDate bool
	// ExePath is the replaced executable when an update was installed.
	ExePath string
}

type SelfUpdateTier string

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

type SessionAccounting struct {
	UserMessages      int
	AssistantMessages int
	ToolCalls         int
	ToolResults       int
	TotalMessages     int
	Tokens            SessionTokenStats
	UsageBreakdown    []SessionUsageBreakdown
	CacheWaste        SessionCacheWaste
	// LatestCacheHitRate is the cache-read share (percent) of the last
	// assistant message's prompt, nil when that prompt had no tokens.
	LatestCacheHitRate *float64
}

type SessionCacheWaste struct {
	MissedTokens int
	MissedCost   float64
	MissCount    int
}

type SessionEntry struct {
	Base SessionEntryBase
	// contains filtered or unexported fields
}

type SessionEntryBase struct {
	Type      string  `json:"type"`
	ID        string  `json:"id"`
	ParentID  *string `json:"parentId"`
	Timestamp string  `json:"timestamp"`
}

type SessionHeader struct {
	Type      string `json:"type"` // always "session"
	Version   int    `json:"version,omitempty"`
	ID        string `json:"id"`
	Timestamp string `json:"timestamp"`
	CWD       string `json:"cwd"`
	// ParentSession holds the absolute path of the SOURCE jsonl on a
	// clone (separate JSONL with linear path-to-leaf snapshot). Empty
	// on plain Create.
	ParentSession string `json:"parentSession,omitempty"`
}

type SessionInfo struct {
	Path            string
	ID              string
	CWD             string
	Name            string // user-set name (via /name): empty when unset
	ParentSession   string // path of source jsonl when this session is a clone
	Created         time.Time
	Modified        time.Time
	MessageCount    int
	FirstMessage    string // first user message text: for picker preview
	AllMessagesText string // concatenated text: for fuzzy search
}

type SessionInfoEntry struct {
	SessionEntryBase
	Name string `json:"name,omitempty"`
}

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

type SessionProjection struct {
	Entries  []ProjectedSessionEntry
	Messages []agent.AgentMessage
}

type SessionTokenStats struct {
	Input      int
	Output     int
	CacheRead  int
	CacheWrite int
	Total      int
	Cost       float64 // USD
	// CostUnknown marks a session that used a model nothing gave a price
	// for: Cost leaves that usage out.
	CostUnknown bool
}

type SessionTreeNode struct {
	Entry    SessionEntry
	Children []*SessionTreeNode
	Label    string
	// LabelTimestamp is the on-disk timestamp of the LabelEntry that
	// set Label, in the ISO-8601-ish wire format. Empty when
	// no label is set. Used by the /tree picker to render `hh:mm`
	// next to the label when the user toggles label timestamps on.
	LabelTimestamp string
}

type SessionUsageBreakdown struct {
	Key    string
	Cost   float64
	Tokens int
}

type Settings struct {
	DefaultProvider      string `json:"defaultProvider,omitempty"`
	DefaultModel         string `json:"defaultModel,omitempty"`
	DefaultThinkingLevel string `json:"defaultThinkingLevel,omitempty"`
	// Routing is the orchestrator's last choice, restored at the next start
	// while routing is on: a mode name (the router picks the orchestrator
	// under it) or "pinned" (the default model orchestrates).
	Routing string `json:"routing,omitempty"`
	// Subagents is the subagents' last choice, restored at the next start:
	// a mode name (routed under it), a "provider/model" spec, or "same"
	// (the orchestrator's model).
	Subagents string `json:"subagents,omitempty"`
	// ModelThinkingLevels holds per-model default thinking levels keyed by
	// "provider/modelId".
	ModelThinkingLevels map[string]string `json:"modelThinkingLevels,omitempty"`
	// Transport is "sse", "websocket", "websocket-cached", or "auto" (the
	// default).
	Transport string `json:"transport,omitempty"`
	// SteeringMode and FollowUpMode dispatch queued messages "all" at once or
	// "one-at-a-time" (the default).
	SteeringMode string `json:"steeringMode,omitempty"`
	FollowUpMode string `json:"followUpMode,omitempty"`

	Theme string `json:"theme,omitempty"`
	// FullscreenExitOutput is "clear" (the default), "transcript", or
	// "resume-hint".
	FullscreenExitOutput string `json:"fullscreenExitOutput,omitempty"`
	// FullscreenScrollbar is "auto" (the default), "always", or "hidden".
	FullscreenScrollbar string `json:"fullscreenScrollbar,omitempty"`
	// FullscreenSidebar is "" (auto: shown when the terminal is wide enough),
	// "show", or "hide"; ctrl+x b toggles it and saves the choice.
	FullscreenSidebar string `json:"fullscreenSidebar,omitempty"`
	// FullscreenCopyOnSelect copies a completed selection. Default: true.
	FullscreenCopyOnSelect *bool `json:"fullscreenCopyOnSelect,omitempty"`
	// FullscreenScrollSpeed is the lines one wheel step scrolls (1-10,
	// default 3).
	FullscreenScrollSpeed *int `json:"fullscreenScrollSpeed,omitempty"`

	Compaction    *CompactionSettingsJSON `json:"compaction,omitempty"`
	BranchSummary *BranchSummarySettings  `json:"branchSummary,omitempty"`
	Retry         *RetrySettingsJSON      `json:"retry,omitempty"`

	// HideThinkingBlock shows thinking blocks as stubs; Ctrl+T toggles it.
	HideThinkingBlock *bool  `json:"hideThinkingBlock,omitempty"`
	ShellPath         string `json:"shellPath,omitempty"`
	// CommandPrefix is prepended to every bash tool command as its own
	// first line (e.g. "set -e").
	CommandPrefix     string `json:"shellCommandPrefix,omitempty"`
	QuietStartup      *bool  `json:"quietStartup,omitempty"`
	CollapseChangelog *bool  `json:"collapseChangelog,omitempty"`
	// ShowCacheMissNotices adds transcript notices for significant prompt
	// cache misses. Default: false.
	ShowCacheMissNotices *bool `json:"showCacheMissNotices,omitempty"`
	// EnableAttributionHeaders sends wopr's app-attribution headers to
	// OpenRouter, NVIDIA, and Cloudflare. Default: true.
	EnableAttributionHeaders *bool `json:"enableAttributionHeaders,omitempty"`

	Skills  []string `json:"skills,omitempty"`
	Prompts []string `json:"prompts,omitempty"`
	Themes  []string `json:"themes,omitempty"`
	// CleanupTempFiles deletes the temp files sessions create (default on).
	CleanupTempFiles *bool `json:"cleanupTempFiles,omitempty"`
	// WarCouncil configures Global Thermonuclear War's council.
	WarCouncil *WarCouncilSettings `json:"warCouncil,omitempty"`
	// EnableSkillCommands lists /skill:name commands in autocomplete.
	// Default: true.
	EnableSkillCommands *bool `json:"enableSkillCommands,omitempty"`

	Terminal *TerminalSettings `json:"terminal,omitempty"`
	Images   *ImageSettings    `json:"images,omitempty"`

	// DefaultTools is the initial built-in tool selection; nil means the
	// default read, bash, edit and write.
	DefaultTools []string `json:"defaultTools,omitempty"`
	// DoubleEscapeAction is what double-Esc on an empty editor does: "fork",
	// "tree" (the default), or "none".
	DoubleEscapeAction string `json:"doubleEscapeAction,omitempty"`
	// TreeFilterMode is the filter /tree opens with.
	TreeFilterMode string `json:"treeFilterMode,omitempty"`
	// Hashline selects hashline anchors on read and edit: "auto" (the
	// default: on for models on free router tiers), "on", or "off". A router
	// model's own "hashline" flag wins.
	Hashline string `json:"hashline,omitempty"`
	// Diagnostics configures the checker edit and write run on the file they
	// changed.
	Diagnostics *DiagnosticsSettings `json:"diagnostics,omitempty"`
	// BashCompaction drops known noise (git hints, passing test lines) from
	// bash output before the model sees it. Default: true.
	BashCompaction *bool `json:"bashCompaction,omitempty"`
	// DefaultProjectTrust applies when no saved decision resolves project
	// trust: "ask" (the default), "always", or "never". Global only.
	DefaultProjectTrust string                   `json:"defaultProjectTrust,omitempty"`
	ThinkingBudgets     *ThinkingBudgetsSettings `json:"thinkingBudgets,omitempty"`
	// EditorPaddingX (0-3, default 0), OutputPad (0-1, default 1), and
	// AutocompleteMaxVisible (3-20, default 5) size the prompt and transcript.
	EditorPaddingX         *int   `json:"editorPaddingX,omitempty"`
	OutputPad              *int   `json:"outputPad,omitempty"`
	AutocompleteMaxVisible *int   `json:"autocompleteMaxVisible,omitempty"`
	ExternalEditor         string `json:"externalEditor,omitempty"`
	// ShowHardwareCursor shows the terminal's own cursor. Default: false, or
	// WOPR_HARDWARE_CURSOR=1.
	ShowHardwareCursor *bool             `json:"showHardwareCursor,omitempty"`
	Markdown           *MarkdownSettings `json:"markdown,omitempty"`
	SessionDir         string            `json:"sessionDir,omitempty"`
	// HTTPIdleTimeoutMs keeps the authored value: a number, a numeric string,
	// or "disabled". GetHttpIdleTimeoutMs parses it.
	HTTPIdleTimeoutMs json.RawMessage `json:"httpIdleTimeoutMs,omitempty"`
	// CacheWarming is read from global settings only, because each refresh
	// costs money.
	CacheWarming CacheWarmingMode `json:"cacheWarming,omitempty"`
	// LastChangelogVersion is the version whose changelog the user last saw.
	LastChangelogVersion string `json:"lastChangelogVersion,omitempty"`
}

type SettingsError struct {
	Scope string
	// Path is the settings file behind the error.
	Path  string
	Error error
}

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

type ShareState struct {
	SystemPrompt string
	Tools        []ShareTool
}

type ShareTool struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	Parameters  any    `json:"parameters,omitempty"`
}

type SkillDef struct {
	Name                   string
	Description            string
	DisableModelInvocation bool
	// Body is the markdown content (stripped of frontmatter).
	Body string
	// Path is the source SKILL.md file.
	Path string
	// Dir is the skill's containing directory: used so callers can
	// resolve referenced sibling files.
	Dir string
}

type SlashContext struct {
	// Args is the text after the command name, trimmed.
	Args string

	Append     func(string) // markdown output
	AppendText func(string) // plain output
	Clear      func()
	Quit       func()
	// Reset clears the agent's messages for /new.
	Reset func()

	ModelName        func() string
	LastAssistant    func() string
	CopyClipboard    func(text string) error
	CurrentSession   func() *Session
	SetSessionName   func(name string) error
	ForkToNewSession func(userMsgEntryID string) error
	CloneCurrent     func() (newPath string, err error)
	ListSessions     func() ([]SessionInfo, error)
	RenderTree       func() string
}

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

type StartupUIOptions struct {
	AgentDir   string
	Settings   Settings
	ThemePaths []string
}

type StatusLine struct {
	tui.BaseComponent
	// contains filtered or unexported fields
}

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