codingagent

type AgentSessionRuntimeDiagnostic struct {
	Type    string
	Message string
}

type BashExecOptions = tools.BashExecOptions

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:"-"`
	MessageTimestamp   int64  `json:"-"`
}

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

type BashResult = tools.BashResult

type BeforeAgentStartRun struct {
	// Options are the options the handlers shared, or the base options when no handler changed them.
	Options extension.BuildSystemPromptOptions
	// SelectedTools is an explicit selectedTools edit, which becomes the run's tool loadout. Nil keeps the live active tools, including a handler's setActiveTools call.
	SelectedTools []string
	// Sections are the run's validated custom prompt sections, or nil.
	Sections ai.OrderedSections
	// SystemPrompt is the exact replacement a handler returned, or nil.
	SystemPrompt *string
	// Messages are the custom messages the handlers returned.
	Messages []extension.CustomMessageRef
}

type BinaryUpdate struct {
	CurrentVersion string
	LatestVersion  string
	Notes          string // release note text; a bare URL is ChangelogURL instead
	ChangelogURL   string
	Binary         UpdateBinary
	Command        string // the command that applies it, e.g. "pig update self"
}

type BranchSummaryConfig struct {
	ReserveTokens int  `json:"reserveTokens,omitempty"`
	SkipPrompt    bool `json:"skipPrompt,omitempty"`
	// contains filtered or unexported fields
}

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 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"`
	// PiEnvironmentVariables lists PI_* names only; values never leave the
	// machine. PigEnvironmentVariables lists PiG's own PIG_* names.
	PiEnvironmentVariables  []string `json:"piEnvironmentVariables"`
	PigEnvironmentVariables []string `json:"pigEnvironmentVariables"`
}

type BugReportExtension struct {
	Path string `json:"path"`
}

type BugReportExtensionError struct {
	Error string `json:"error"`
}

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
	ExtensionPaths  []string
	ExtensionErrors []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"`
	Extensions      []BugReportExtension      `json:"extensions"`
	ExtensionErrors []BugReportExtensionError `json:"extensionErrors"`
	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"`
	RegisteredByExtension bool                `json:"registeredByExtension"`
}

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>"). Optional. Mirrors upstream argumentHint.
	ArgumentHint string
	Handler      SlashHandler
	// Hidden commands dispatch normally but are omitted from /help and
	// autocomplete. Mirrors upstream commands handled inline in the submit
	// handler that are absent from the canonical slash-commands.js list
	// (e.g. /debug).
	Hidden bool
}

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 CacheWarmingDecide func(context.Context, CacheWarmingDecisionEvent) (CacheWarmingAction, error)

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 CacheWarmingDecisionEvent struct {
	Type                    string             `json:"type"`
	WarmCost                float64            `json:"warmCost"`
	MissCost                float64            `json:"missCost"`
	ContinuationProbability float64            `json:"continuationProbability"`
	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"`
	// ExtensionOverride is true when an extension changed Decision.Action.
	ExtensionOverride bool `json:"extensionOverride,omitempty"`
}

type CatalogRefreshOptions struct {
	AllowNetwork bool
	Force        *bool
	Providers    []string
}

type CatalogRefreshResult struct {
	Aborted bool
	Errors  map[string]error
	// contains filtered or unexported fields
}

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
	Scrollbar           string
	ScrollbarTrackStyle func(text string) string
	ScrollbarThumbStyle func(text string) string
}

type CodemodeMode string

type CodemodeSettings struct {
	// Mode defaults to on.
	Mode CodemodeMode `json:"mode,omitempty"`
	// InlineBudget is the estimated tokens (characters / 4) the codemode description may spend on tool declarations. Default 3000.
	InlineBudget *int `json:"inlineBudget,omitempty"`
}

type CompactionConfig struct {
	Enabled          bool
	ReserveTokens    int
	KeepRecentTokens 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    *float64 `json:"reserveTokens,omitempty"`
	KeepRecentTokens *float64 `json:"keepRecentTokens,omitempty"`
	// contains filtered or unexported fields
}

type CompactionSettingsJSON struct {
	Enabled *bool `json:"enabled,omitempty"`
	// ReserveTokens and KeepRecentTokens retain JavaScript numbers until getter validation, including zero, fractions, and non-finite runtime overrides.
	ReserveTokens    *float64 `json:"reserveTokens,omitempty"`
	KeepRecentTokens *float64 `json:"keepRecentTokens,omitempty"`
	// ModelOverrides maps exact "provider/modelId" keys to token settings
	// that take precedence for that model.
	ModelOverrides map[string]CompactionModelOverride `json:"modelOverrides,omitempty"`
	// contains filtered or unexported fields
}

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 CredentialSynchronizationError struct {
	ProviderID string
	Operation  CredentialSynchronizationOperation
	Credential *ai.Credential
	Cause      error
}

type CredentialSynchronizationOperation string

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 ExtUIContext struct {
	// contains filtered or unexported fields
}

type ExtensionCommandLister interface {
	Commands() []extension.ResolvedCommand
}

type ExtensionConflict struct {
	Path    string
	Message string
}

type ExtensionContext struct {
	UI      ExtensionUIContext
	HasUI   bool
	CWD     string
	Session *Session
	Model   *ai.Model
	IsIdle  func() bool
	// IsProjectTrusted mirrors upstream ExtensionContext.isProjectTrusted
	// (types.ts:332). Trust can be granted mid-session, so it is a function
	// rather than a snapshot.
	IsProjectTrusted func() bool
	AbortSignal      context.Context
	AbortFunc        context.CancelFunc
}

type ExtensionOAuthConfig struct {
	Name           string
	IsSubscription bool
	Login          func(context.Context, ai.OAuthLoginCallbacks) (ai.Credential, error)
	RefreshToken   func(context.Context, ai.Credential) (ai.Credential, error)
	GetAPIKey      func(ai.Credential) string
	ModifyModels   func([]*ai.Model, ai.Credential) []*ai.Model
}

type ExtensionSessionView struct {
	Session    *Session
	CWD        string
	SessionDir string
}

type ExtensionStackMetadata struct {
	Path         string
	ResolvedPath string
	SourceInfo   ResourceSourceInfo
}

type ExtensionToolLister interface {
	Tools() []extension.RegisteredTool
	ToolSourceInfo(toolName string) (extension.SourceInfo, bool)
}

type ExtensionUIContext interface {
	Select(title string, options []string) (string, bool)
	Confirm(title, message string) bool
	Input(title, placeholder string) (string, bool)
	Notify(message, level string)
	SetStatus(key, text string)
	SetWidget(key string, lines []string)
}

type FetchUpdateManifestOptions struct {
	Retry bool
}

type FindInitialModelOptions struct {
	CLIProvider          string
	CLIModel             string
	ScopedModels         []ScopedModel
	IsContinuing         bool
	DefaultProvider      string
	DefaultModelId       string
	DefaultThinkingLevel string
	ModelThinkingLevels  map[string]string
	ModelRuntime         InitialModelRuntime
}

type FirstTimeSetupComponent struct {
	*tui.Container
	// contains filtered or unexported fields
}

type FirstTimeSetupOptions struct {
	OnThemePreview func(themeName string)
	OnSubmit       func(result FirstTimeSetupResult)
	OnCancel       func()
}

type FirstTimeSetupResult struct {
	Theme          string
	Sprite         string
	ShareAnalytics bool
}

type FirstTimeSetupSettings interface {
	SetTheme(name string) error
	SetEnableAnalytics(enabled bool) error
}

type InitialModelResult struct {
	Model           *RuntimeModel
	ThinkingLevel   string
	FallbackMessage string
}

type InitialModelRuntime interface {
	ModelResolverRuntime
	GetModel(providerID, modelID string) *RuntimeModel
	GetAvailableSnapshot() []RuntimeModel
}

type InteractiveForkResult struct {
	Cancelled    bool
	SelectedText *string
}

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

type InteractiveOptions struct {
	CWD      string
	AgentDir string
	Model    *ai.Model
	Settings Settings
	// InitialThemeSetting selects a theme for this run without changing the SettingsManager. A non-nil empty name is a selection that fails and falls back to dark. Explicit selections replace it; absent selections follow the current manager.
	InitialThemeSetting *string
	// TuiMode selects "regular" or "fullscreen" for this run without changing the SettingsManager. Empty captures Settings.TuiMode at construction; only a live mode switch changes it afterwards.
	TuiMode string
	// SettingsManager provides read/write access to global settings.
	// 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
	// SystemPromptOptions mirrors upstream
	// `BuildSystemPromptOptions` (system-prompt.ts:8-25). It carries
	// the structured inputs that produced SystemPrompt (custom prompt,
	// tools, append text, context files, skills) and is passed verbatim
	// to extensions on every before_agent_start event so they can
	// inspect what pi has loaded without re-discovering resources.
	//
	// upstream: agent-session.ts:_rebuildSystemPrompt
	SystemPromptOptions extension.BuildSystemPromptOptions
	// AllowedTools restricts which tool names may execute. nil means no
	// restriction; a non-nil empty map blocks every tool. Mirrors the
	// `tools:` allowlist on agent .md frontmatter.
	AllowedTools map[string]struct{}
	// ActiveBuiltinTools, when non-nil, restricts which built-in coding
	// tools are active (caller/extension tools unaffected). nil = all
	// built-in tools. Mirrors upstream defaultActiveToolNames (sdk.ts:244):
	// 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 extension tools alike. Mirrors upstream excludedToolNames
	// (sdk.ts:246) + isAllowedTool (agent-session.ts:2288).
	ExcludedTools map[string]struct{}
	// ToolRegistryAllowed is the --tools allowlist bounding the tool registry
	// pi.getAllTools() reports (upstream _allowedToolNames): nil admits every
	// tool, an empty map none. Unlike AllowedTools, active-tool changes never
	// modify it.
	ToolRegistryAllowed map[string]struct{}
	// NoBuiltinTools hides built-in tools while leaving extension/custom tools.
	NoBuiltinTools bool
	// PromptPaths lists additional prompt-template directories.
	// Mirrors upstream `additionalPromptTemplatePaths`.
	// Directories are searched after the default <agentDir>/prompts/ and
	// <cwd>/.pig/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.
	// Mirrors upstream --session-id (v0.76.0). When non-empty and no
	// existing session matches, Create uses this ID instead of
	// generating a random one.
	SessionID string
	// ThemePaths lists resolved theme files/directories in resource precedence order.
	ThemePaths []string
	// NoPromptTemplates disables prompt template discovery.
	NoPromptTemplates bool
	// NoThemes disables custom theme discovery from disk.
	NoThemes bool

	// UnknownFlags carries CLI flags not claimed by the core parser so
	// extensions can resolve their registered values at runtime.
	UnknownFlags map[string]any
	// BeforeToolCall hooks run at agent-loop time and can block tool
	// execution. The allowlist hook provides defense in depth alongside
	// the registration-time filter.
	BeforeToolCall []agent.BeforeToolCallHook

	// 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 stock footer and extension usage reads.
	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)

	// DefaultModelPerProvider shares the startup resolver's provider defaults with /login.
	DefaultModelPerProvider map[string]string

	// ModelLookup resolves a provider/model identity through the Session-owned runtime.
	ModelLookup  func(providerID, modelID string) *ai.Model
	ModelCatalog func() []*ai.Model
	// ModelClassify is the Session-owned runtime classify an extension's ctx.modelRegistry.classify reaches.
	ModelClassify func(context.Context, *ai.ClassifierModel, ai.ClassifierContext, ...ai.ModelsClassifierOptions) ai.ClassifierResult
	// ModelGenerateImages is the Session-owned runtime generateImages an extension's ctx.modelRegistry.generateImages reaches.
	ModelGenerateImages func(context.Context, *ai.ImageModel, ai.ImagesContext, ...ai.ModelsImagesOptions) ai.AssistantImages

	// 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.
	// Mirrors upstream session.modelRegistry (interactive-mode.ts:4394).
	ModelRegistry *ModelRegistry

	// ExtensionRunner is the new-style (`coding/extension`) runner.
	// May be nil during tests or when no extensions are loaded.
	// Events are dispatched through this runner via event_bridge.go.
	ExtensionRunner *inproc.Runner

	// SessionStartEvent is the factory-selected startup/new/resume/fork event for the current Session.
	SessionStartEvent *extension.SessionStartEvent

	// ExtensionContext is the live extension context shared with the
	// runner. Caller-supplied to ensure extCtx.Session points at the
	// SAME on-disk session SessionHandle wraps.
	ExtensionContext *ExtensionContext

	// 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. Mirrors upstream's
	// `initialMessage` plumbing at
	// `.upstream/current/packages/coding-agent/src/cli/initial-message.ts`.
	// Sourced by main.go from positional args + piped stdin so users
	// can `pig "hello"`, `pig < 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 (upstream
	// initialMessages).
	InitialMessages []string

	// AppVersion is the binary version string used to detect
	// changelog-seen state. Set to UpstreamVersion (the port target).
	// gate the startup "what's new" changelog notification.
	// Mirrors upstream this.version in InteractiveMode constructor.
	AppVersion string

	// PackageUpdateChecker, if set, is invoked asynchronously at startup
	// to check for available package updates. The returned strings are
	// the display names of packages with available updates. When the
	// returned slice is non-empty, an "X package updates available"
	// banner is shown. Mirrors upstream checkForPackageUpdates +
	// showPackageUpdateNotification (interactive-mode.ts:660-665, 3449).
	PackageUpdateChecker func() []string

	// BinaryUpdateChecker, if set, is invoked asynchronously at startup and
	// returns a newer-release notice for the pig binary itself, or nil. pig
	// divergence (D39): standalone-binary self-update. The notice names the
	// command that applies it (e.g. `pig update self`).
	BinaryUpdateChecker func() *BinaryUpdate

	// Llama is Pi's 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 PI_OFFLINE.
	OfflineMode bool

	// ResourceSourceInfoProvider returns source metadata for currently known
	// prompts/skills/extensions/themes, keyed by absolute path. Used to enrich
	// verbose startup output and /reload diagnostics with package origin.
	// Mirrors upstream resource-loader.ts PathMetadata/SourceInfo plumbing.
	ResourceSourceInfoProvider func() map[string]ResourceSourceInfo
	// ReloadResourceProvider recomputes settings-backed prompt/theme/skill/
	// context-file inputs on /reload so the interactive session mirrors
	// upstream resourceLoader.reload() instead of reusing startup snapshots.
	ReloadResourceProvider func() ReloadResourceSnapshot

	// Verbose forces verbose startup output (overrides quietStartup).
	// Mirrors upstream InteractiveOptions.verbose (interactive-mode.ts:184).
	Verbose bool

	// Skills is the loaded set of skill definitions, used to expand
	// /skill:name commands in user prompts.
	// Mirrors upstream resourceLoader.getSkills() (agent-session.ts:1124-1151).
	Skills []*SkillDef
	// SkillDiagnostics retains ordered load-time collisions for the startup listing.
	SkillDiagnostics []extension.ResourceDiagnostic
	// RebuildSystemPrompt reconstructs the base system prompt + structured
	// prompt options after /reload from the current skills/context files.
	// Mirrors upstream session.reload() → _rebuildSystemPrompt.
	RebuildSystemPrompt func(skills []*SkillDef, contextFiles []ContextFile) (string, extension.BuildSystemPromptOptions)
	// BridgeExtensionTools converts registered extension tools into
	// agent.AgentTool values so /reload can refresh the live tool registry.
	BridgeExtensionTools func([]extension.RegisteredTool) ([]agent.AgentTool, []error)
	// 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 automatic skill discovery; explicitly selected and extension-discovered paths still load on reload.
	NoSkills bool

	// ContextFiles lists the loaded AGENTS.md/CLAUDE.md project context files.
	// The loaded-resources [Context] section lists them after
	// SystemPromptSourcePaths.
	ContextFiles []ContextFile

	// SystemPromptSourcePaths are the existing files the system prompt and
	// then each appended system prompt were read from, as upstream
	// getSystemPromptSource and getAppendSystemPromptSources report them.
	SystemPromptSourcePaths []string

	// Runtime, when set, owns Session replacement: new, resume, fork, clone and import build the destination Session through its factory. ReplacementResources then supplies the destination build's options.
	Runtime InteractiveRuntime
	// ReplacementResources returns the cwd-bound options of the build that owns session.
	ReplacementResources func(session InteractiveSessionHandle) InteractiveReplacement

	// SubprocessUIBridge, when non-nil, is the UI bridge for subprocess
	// extensions. Run() wires it to the TUI after creation via
	// SetUIContext and SetInvalidate.
	//
	// pig-specific: no upstream equivalent.
	SubprocessUIBridge SubprocessUIBridge

	// SubprocessHost, when non-nil, manages subprocess extension lifecycle.
	// Used by /reload to rebuild and re-spawn changed extensions.
	//
	// pig-specific: no upstream equivalent.
	SubprocessHost SubprocessHost

	// TerminateExtensionProcesses, when set, kills every extension process without running extension callbacks. It runs before an emergency exit on a dead terminal, which skips orderly shutdown.
	TerminateExtensionProcesses func()

	// StageExtensionSDKs, when non-nil, materializes the SDKs this binary
	// embeds before /reload recompiles out-of-tree extensions, and prunes
	// builds whose fingerprint proves they came from an older SDK.
	//
	// Injected so this package does not depend on the SDK bundle implementation
	// and so a test can observe that reload stages before it rebuilds.
	//
	// pig-specific: no upstream equivalent, because upstream extensions are
	// in-process TypeScript and there is no SDK to stage.
	StageExtensionSDKs func() error

	// BuiltinExtensions contains generic in-process runtime extensions, such as
	// Piglet capability scoping, in configured load order after subprocess
	// extensions.
	BuiltinExtensions []extension.Extension

	// ReloadBuiltinExtensions reconstructs BuiltinExtensions for /reload. A
	// factory callback is required because copying an Extension would retain the
	// handler closures and state that upstream discards on reload.
	ReloadBuiltinExtensions func() []extension.Extension

	// NoModelWarning carries the interactive-only model-selection diagnostic, including a failed saved-model restoration followed by a fallback.
	NoModelWarning string
	// StartupDiagnostics are shown in the chat after the welcome banner.
	// Mirrors upstream InteractiveModeOptions.startupDiagnostics.
	StartupDiagnostics []AgentSessionRuntimeDiagnostic

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

	// LoginHeaderOptions contains host-owned operational text and terminal
	// rendering capabilities for an extension-provided login.
	LoginHeaderOptions LoginHeaderOptions

	// BuiltInHeaderLines are the stock text header restored when an extension
	// clears its custom header.
	BuiltInHeaderLines []string

	// LoginVisible applies the startup silence gate to built-in and native
	// extension login presentations.
	LoginVisible bool
}

type InteractiveReplacement struct {
	CWD                     string
	SessionDir              string
	Settings                Settings
	SettingsManager         *SettingsManager
	ModelRegistry           *ModelRegistry
	SystemPrompt            string
	SystemPromptOptions     extension.BuildSystemPromptOptions
	AllowedTools            map[string]struct{}
	ActiveBuiltinTools      map[string]struct{}
	ExcludedTools           map[string]struct{}
	ToolRegistryAllowed     map[string]struct{}
	NoBuiltinTools          bool
	PromptPaths             []string
	ThemePaths              []string
	SkillPaths              []string
	Skills                  []*SkillDef
	SkillDiagnostics        []extension.ResourceDiagnostic
	ContextFiles            []ContextFile
	SystemPromptSourcePaths []string
	RebuildSystemPrompt     func(skills []*SkillDef, contextFiles []ContextFile) (string, extension.BuildSystemPromptOptions)
	ResourceSourceInfo      func() map[string]ResourceSourceInfo
	ReloadResources         func() ReloadResourceSnapshot
	ExtensionRunner         *inproc.Runner
	SessionStartEvent       extension.SessionStartEvent
	// ExtensionConflicts are the tool and flag conflicts of the build's final extension set, which Pi lists with the extension load errors.
	ExtensionConflicts      []ExtensionConflict
	BuiltinExtensions       []extension.Extension
	ReloadBuiltinExtensions func() []extension.Extension
	Llama                   *llama.Host
	SubprocessUIBridge      SubprocessUIBridge
	SubprocessHost          SubprocessHost
	ModelLookup             func(providerID, modelID string) *ai.Model
	ModelCatalog            func() []*ai.Model
	ModelClassify           func(context.Context, *ai.ClassifierModel, ai.ClassifierContext, ...ai.ModelsClassifierOptions) ai.ClassifierResult
	ModelGenerateImages     func(context.Context, *ai.ImageModel, ai.ImagesContext, ...ai.ModelsImagesOptions) ai.AssistantImages
	RequestAuthRuntime      *RequestAuthRuntime
}

type InteractiveRuntime interface {
	NewSession(ctx context.Context, options *extension.NewSessionOptions) (extension.CancelledResult, error)
	// SwitchSession opens path and replaces the Session. projectTrustUI supplies the UI of the destination's project trust prompt, as Pi's projectTrustContextFactory does.
	SwitchSession(ctx context.Context, path, cwdOverride string, projectTrustUI func(cwd string) extension.UIContext, options *extension.SwitchSessionOptions) (extension.CancelledResult, error)
	Fork(ctx context.Context, entryID string, options *extension.ForkOptions) (InteractiveForkResult, error)
	ImportFromJsonl(ctx context.Context, path, cwdOverride string) (extension.CancelledResult, error)
	// ExtensionCommandActions returns the command actions of session with new, fork and switch routed through the runtime.
	ExtensionCommandActions(session InteractiveSessionHandle) extension.CommandActions
	// EmitQuitShutdown emits session_shutdown for quit once; closing the runtime does not repeat it.
	EmitQuitShutdown()
	// SetBeforeSessionReplacement installs the drain that runs after a replacement is approved and before the outgoing Session aborts.
	SetBeforeSessionReplacement(drain func(context.Context) error)
	// SetBeforeSessionInvalidate installs the synchronous hook that runs after session_shutdown and before the outgoing Session's extension contexts go stale.
	SetBeforeSessionInvalidate(hook func())
	// SetRebindSession installs the awaited callback that runs once the replacement Session is installed.
	SetRebindSession(rebind func(ctx context.Context, session InteractiveSessionHandle) error)
}

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
	// IsIdle and WaitForIdle observe the Session-owned operation, including work an extension started.
	IsIdle() bool
	WaitForIdle(context.Context) error
	// SetModel swaps the active LLM model mid-session and persists a
	// model_change audit entry.
	SetModel(*ai.Model, ...ModelMutationOptions) error
	// SetModelOnMain dispatches the synchronous state mutation to the owner loop, then waits for extension notifications on the caller. The dispatcher may reject a superseded mutation.
	SetModelOnMain(*ai.Model, ModelMutationOptions, func(func() error) error) error
	// CycleToModel applies a model-cycle selection as SetModel applies a direct one, and reports the selection to extensions with source "cycle".
	CycleToModel(*ai.Model, ...ModelMutationOptions) error
	// ExtensionCompact is the compact action Pi binds for extensions: it starts a manual compaction without waiting, reports the result to options.OnComplete and a failure to options.OnError, and drops the outcome without callbacks.
	ExtensionCompact(*extension.CompactOptions)
	// ExtensionSetModel answers an extension's pi.setModel: false without configured credentials, otherwise it switches as SetModel does and answers true.
	ExtensionSetModel(context.Context, *ai.Model) (bool, error)
	// SetThinkingLevel applies and records reasoning without changing defaults unless Persist is set.
	SetThinkingLevel(ai.ThinkingLevel, ...ModelMutationOptions) error
	// SetSessionName persists and publishes a sanitized Session name.
	SetSessionName(string) 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).
	// Mirrors upstream AgentSession.abortCompaction().
	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 like Pi's
	// _runAgentPrompt: 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)
	// RunInputHandlers runs the extension input handlers for user input
	// (upstream _runInputHandlers); behavior reaches them only while a run
	// is active.
	RunInputHandlers(ctx context.Context, text string, images []ai.ImageContent, source extension.InputSource, behavior string) (string, []ai.ImageContent, bool, error)
	// AbortRetry cancels a pending automatic-retry delay without aborting
	// the run. Mirrors upstream AgentSession.abortRetry().
	AbortRetry()
	// AbortBranchSummary cancels an in-flight branch summarization. Safe
	// to call when no summarization is running (no-op).
	// Mirrors upstream AgentSession.abortBranchSummary().
	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.
	// Mirrors upstream AgentSession.navigateTree().
	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. Mirrors upstream AgentSession.cacheWarmingStatus.
	CacheWarmingStatus() *CacheWarmingStatus
	// SetCacheWarmingMode persists the mode and reconciles active warming.
	// Mirrors upstream AgentSession.setCacheWarmingMode.
	SetCacheWarmingMode(CacheWarmingMode) error
	// OnAgentSettled tells the cache warmer that an agent run settled.
	OnAgentSettled()
}

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

type InteractiveThemeControllerOptions struct {
	GetSettingsManager  func() *SettingsManager
	ShowError           func(string)
	OnChanged           func()
	InitialThemeSetting *string
	Output              io.Writer
	RunOnMain           func(context.Context, func()) error
}

type InteractiveTuiOptions struct {
	TuiMode                string
	ShowHardwareCursor     *bool
	LogDirectory           string
	Output                 io.Writer
	OnRightClickPaste      func()
	FullscreenCopyOnSelect *bool
	// FullscreenWheelScrollLines is the fullscreen renderer's wheel line count; nil is auto (tui-renderer.ts:38).
	FullscreenWheelScrollLines *tui.WheelScrollLines
	OpenURL                    func(string) error
	CopySelection              func(string) error
}

type KeyID = string

type KeybindingConflict struct {
	Key     KeyID
	Actions []string
}

type KeybindingDefinition struct {
	DefaultKeys []KeyID
	Description string
}

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