@oh-my-pi/pi-coding-agent 17.2.10 → 17.2.12

package/dist/types/mcp/transports/header-policy.d.ts

@@ -0,0 +1,46 @@
+/**
+ * HTTP header precedence and redirect-origin policy for remote MCP transports.
+ *
+ * Two invariants, applied at every transport fetch:
+ *
+ * 1. Client-generated headers (protocol headers like `Content-Type`, `Accept`,
+ *    `Mcp-Session-Id`, and authorization) take precedence over configured
+ *    headers with the same case-insensitive name. Configured headers can never
+ *    corrupt the MCP wire protocol via casing tricks.
+ * 2. Origin-locked servers (Agent Plugins §7.2.1) never forward configured
+ *    headers to a different origin: redirects are followed manually and
+ *    configured headers are attached only when the hop targets the configured
+ *    origin. Method-changing redirects of non-GET requests are refused.
+ */
+/** Header buckets for one MCP HTTP request. */
+interface MCPHeaderSources {
+    /** Client-generated HTTP/MCP/authorization headers; win case-insensitively. */
+    generated: Record<string, string>;
+    /** Configured headers from the server entry (package or user config). */
+    configured?: Record<string, string>;
+}
+/**
+ * Merge configured headers under client-generated ones: a configured entry is
+ * dropped when a generated header with the same case-insensitive name exists.
+ */
+export declare function mergeMCPHeaders({ generated, configured }: MCPHeaderSources): Record<string, string>;
+/**
+ * Set a client-generated header, removing any existing entry with the same
+ * case-insensitive name so the generated value is the only one sent.
+ */
+export declare function setGeneratedHeader(headers: Record<string, string>, name: string, value: string): void;
+export interface MCPFetchInit {
+    method: "GET" | "POST" | "DELETE";
+    body?: string;
+    signal?: AbortSignal;
+}
+/**
+ * Fetch an MCP endpoint with header precedence and, for origin-locked servers,
+ * manual redirect handling that strips configured headers on cross-origin hops.
+ *
+ * Non-locked servers keep the platform default redirect behavior. Locked
+ * non-GET requests only follow 307/308 (method-preserving); a 301/302/303
+ * redirect of a JSON-RPC POST is a connection error, never a silent GET.
+ */
+export declare function mcpFetch(url: string, init: MCPFetchInit, sources: MCPHeaderSources, originLocked: boolean): Promise<Response>;
+export {};

package/dist/types/mcp/types.d.ts

@@ -82,6 +82,13 @@ export interface MCPStdioServerConfig extends MCPServerConfigBase {
     command: string;
     args?: string[];
     env?: Record<string, string>;
+    /**
+     * `literal`: env values are opaque plugin package data (Agent Plugins
+     * §§4.1/9.2) — no env-name lookup, no `!command` execution, no dropping of
+     * empty values. The provider already applied the only permitted expansion
+     * (`${PLUGIN_ROOT}`/`${PLUGIN_DATA}`).
+     */
+    envPolicy?: "literal";
     cwd?: string;
 }
 /** HTTP server configuration (Streamable HTTP transport) */
@@ -89,12 +96,20 @@ export interface MCPHttpServerConfig extends MCPServerConfigBase {
     type: "http";
     url: string;
     headers?: Record<string, string>;
+    /**
+     * `origin-locked`: configured headers are literal package data pinned to the
+     * configured URL's origin (Agent Plugins §7.2.1) — never expanded, never
+     * forwarded cross-origin, and client-generated headers win case-insensitively.
+     */
+    headerPolicy?: "origin-locked";
 }
 /** SSE server configuration (deprecated, use HTTP) */
 export interface MCPSseServerConfig extends MCPServerConfigBase {
     type: "sse";
     url: string;
     headers?: Record<string, string>;
+    /** See {@link MCPHttpServerConfig.headerPolicy}. */
+    headerPolicy?: "origin-locked";
 }
 export type MCPServerConfig = MCPStdioServerConfig | MCPHttpServerConfig | MCPSseServerConfig;
 export declare const MCP_CONFIG_SCHEMA_URL = "https://raw.githubusercontent.com/can1357/oh-my-pi/main/packages/coding-agent/src/config/mcp-schema.json";

package/dist/types/modes/components/agent-hub-projection.d.ts

@@ -6,7 +6,7 @@ export interface AggregateMetrics extends AgentMetrics {
     /** Rows whose duration is an observer-measured active runtime. */
     activeDurationAgents: number;
 }
-export interface AgentTreeProjection {
+interface AgentTreeProjection {
     rows: AgentRef[];
     depthById: Map<string, number>;
     parentById: Map<string, string>;
@@ -15,12 +15,6 @@ export interface AgentTreeProjection {
 export declare const STATUS_ORDER: Record<AgentStatus, number>;
 /** Exact observer usage for one roster entry. */
 export declare function progressMetrics(observed: ObservableSession | undefined): AgentMetrics | undefined;
-/**
- * Read direct assistant usage from a live session. SessionStats also includes
- * usage embedded in completed `task` tool results, so using it for a parent
- * row would double-count child rows in the aggregate.
- */
-export declare function readSessionMetrics(session: NonNullable<AgentRef["session"]>): AgentMetrics | undefined;
 export declare function aggregateMetrics(args: {
     rows: readonly AgentRef[];
     observedById: ReadonlyMap<string, ObservableSession>;
@@ -36,3 +30,4 @@ export declare function aggregateMetrics(args: {
 };
 /** Parent-before-child projection preserving the roster's stable sibling order. */
 export declare function projectAgentTree(refs: readonly AgentRef[]): AgentTreeProjection;
+export {};

package/dist/types/modes/components/agent-hub-renderer.d.ts

@@ -1,4 +1,3 @@
-import { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import type { Settings } from "../../config/settings.js";
 import { type AgentRef } from "../../registry/agent-registry.js";
 import type { ObservableSession } from "../session-observer-registry.js";
@@ -7,8 +6,6 @@ export interface RosterRender {
     lines: string[];
     hitRows: Array<number | undefined>;
 }
-/** Legacy progress snapshots may omit counters; snapshot absence remains distinct. */
-export declare function metricNumber(value: number | undefined): number;
 /** Compute the max content width for the current terminal, accounting for chrome. */
 export declare function contentWidth(): number;
 /** Remove terminal controls and normalize a value before it reaches the TUI. */
@@ -19,12 +16,8 @@ export declare function clampHubLine(line: string, width: number): string;
 /** Status glyph, colored per theme status conventions. The title-line counts spell out the words. */
 export declare function statusGlyph(status: AgentRef["status"]): string;
 export declare function statusText(status: AgentRef["status"], text: string): string;
-/** Model id + thinking level (`sonnet-4-6 ◒ high`), level colored per theme. */
-export declare function formatModelBadge(modelId: string, level: ThinkingLevel | undefined): string;
 /** Textual model-role tag; color reinforces (but never replaces) the label. */
 export declare function formatRoleBadge(role: string, settings: Settings): string;
-/** Format a resolved selector, preserving provider identity when requested. */
-export declare function formatResolvedModelBadge(resolved: string, preserveProvider?: boolean, fallbackLevel?: ThinkingLevel): string;
 /**
  * Resolved model + reasoning level for a hub row. Exact executor progress is
  * authoritative (and survives completion); direct live sessions are the

package/dist/types/modes/components/agent-hub.d.ts

@@ -56,6 +56,8 @@ export interface AgentHubDeps {
     ui?: TUI;
     /** Tool lookup for transcript renderers (labels, custom render functions). */
     getTool?: (name: string) => AgentTool | undefined;
+    /** Whether the active registry entry came from a built-in factory. */
+    isBuiltInTool?: (name: string) => boolean;
     /** Extension message renderers for custom messages in the transcript. */
     getMessageRenderer?: (customType: string) => MessageRenderer | undefined;
     /** Cwd used by tool renderers for path shortening; defaults to the project dir. */

package/dist/types/modes/components/agent-transcript-viewer.d.ts

@@ -17,6 +17,8 @@ export interface AgentTranscriptViewerDeps {
     lifecycle?: () => AgentLifecycleManager;
     ui: TUI;
     getTool?: (name: string) => AgentTool | undefined;
+    /** Whether the active registry entry came from a built-in factory. */
+    isBuiltInTool?: (name: string) => boolean;
     getMessageRenderer?: (customType: string) => MessageRenderer | undefined;
     cwd: string;
     hideThinkingBlock?: () => boolean;

package/dist/types/modes/components/chat-transcript-builder.d.ts

@@ -19,6 +19,8 @@ import { TranscriptContainer } from "./transcript-container.js";
 export interface ChatTranscriptBuilderDeps {
     ui: TUI;
     getTool?: (name: string) => AgentTool | undefined;
+    /** Whether the active registry entry came from a built-in factory. */
+    isBuiltInTool?: (name: string) => boolean;
     getMessageRenderer?: (customType: string) => MessageRenderer | undefined;
     cwd: string;
     hideThinkingBlock?: () => boolean;

package/dist/types/modes/components/custom-editor.d.ts

@@ -1,7 +1,7 @@
 import type { ImageContent } from "@oh-my-pi/pi-ai";
 import { Editor, type KeyId, TUI } from "@oh-my-pi/pi-tui";
 import type { AppKeybinding } from "../../config/keybindings.js";
-type ConfigurableEditorAction = Extract<AppKeybinding, "app.interrupt" | "app.clear" | "app.exit" | "app.suspend" | "app.display.reset" | "app.thinking.cycle" | "app.model.cycleForward" | "app.model.cycleBackward" | "app.model.select" | "app.model.selectTemporary" | "app.tools.expand" | "app.tools.toggleVisibility" | "app.thinking.toggle" | "app.editor.external" | "app.history.search" | "app.message.dequeue" | "app.retry" | "app.clipboard.pasteImage" | "app.clipboard.pasteTextRaw" | "app.clipboard.copyPrompt">;
+type ConfigurableEditorAction = Extract<AppKeybinding, "app.interrupt" | "app.clear" | "app.exit" | "app.suspend" | "app.display.reset" | "app.thinking.cycle" | "app.model.cycleForward" | "app.model.cycleBackward" | "app.model.select" | "app.model.selectTemporary" | "app.tools.toggleVisibility" | "app.thinking.toggle" | "app.editor.external" | "app.history.search" | "app.message.dequeue" | "app.retry" | "app.clipboard.pasteImage" | "app.clipboard.pasteTextRaw" | "app.clipboard.copyPrompt">;
 /** Max gap (ms) between two spaces for the later one to count as OS key auto-repeat rather than a
  *  deliberate press. OS auto-repeat is fast; a deliberate tap (even a fast one) is slower. */
 export declare const SPACE_REPEAT_MAX_GAP_MS = 120;
@@ -140,7 +140,6 @@ export declare class CustomEditor extends Editor {
     onCycleModelForward?: () => void;
     onCycleModelBackward?: () => void;
     onSelectModel?: () => void;
-    onExpandTools?: () => void;
     onToggleToolActivity?: () => void;
     onToggleThinking?: () => void;
     onExternalEditor?: () => void;

package/dist/types/modes/components/status-line/types.d.ts

@@ -52,6 +52,8 @@ export interface SegmentContext {
     session: AgentSession;
     /** Focused subagent id while the view is proxied at its session, undefined otherwise. */
     focusedAgentId?: string | undefined;
+    /** Effective `statusLine.sessionAccent`; `false` disables hash-derived accent colors, while `true` or omission enables them. */
+    sessionAccent?: boolean;
     activeRepo: ActiveRepoContext | null;
     width: number;
     options: StatusLineSegmentOptions;

package/dist/types/modes/components/tool-execution.d.ts

@@ -28,6 +28,8 @@ export interface ToolExecutionOptions {
     /** Session-persistent edit clipboard register, forked per preview frame. */
     clipboard?: Clipboard;
     showImages?: boolean;
+    /** Allow the name-keyed renderer registry only when the active tool is the built-in implementation. */
+    useBuiltInRenderer?: boolean;
     editFuzzyThreshold?: number;
     editAllowFuzzy?: boolean;
     /** Live-region probe used to settle detached task progress once the block

package/dist/types/modes/theme/color.d.ts

@@ -0,0 +1,19 @@
+import type { ColorMode, ColorValue } from "./schema.js";
+export declare function detectColorMode(): ColorMode;
+export declare function colorToAnsi(color: string, mode: ColorMode): string;
+export declare function fgAnsi(color: string | number, mode: ColorMode): string;
+export declare function bgAnsi(color: string | number, mode: ColorMode): string;
+export declare function resolveVarRefs(value: ColorValue, vars: Record<string, ColorValue>, visited?: Set<string>): string | number;
+export declare function resolveThemeColors<T extends Record<string, ColorValue>>(colors: T, vars?: Record<string, ColorValue>): Record<keyof T, string | number>;
+/**
+ * Resolve a theme color value (hex string or 256-color index) to a CSS hex string.
+ * Empty string represents the default terminal color.
+ */
+export declare function resolveToHex(value: string | number, isLight: boolean): string;
+/**
+ * Convert a 256-color index to hex string.
+ * Indices 0-15: basic colors (approximate)
+ * Indices 16-231: 6x6x6 color cube
+ * Indices 232-255: grayscale ramp
+ */
+export declare function ansi256ToHex(index: number): string;

package/dist/types/modes/theme/loader.d.ts

@@ -0,0 +1,19 @@
+import { type ColorMode, type ThemeJson } from "./schema.js";
+import { type SymbolPreset } from "./symbols.js";
+import { Theme } from "./theme-class.js";
+export declare function getBuiltinThemes(): Record<string, ThemeJson>;
+export declare function getAvailableThemes(): Promise<string[]>;
+export interface ThemeInfo {
+    name: string;
+    path: string | undefined;
+}
+export declare function getAvailableThemesWithPaths(): Promise<ThemeInfo[]>;
+export declare function loadThemeJson(name: string): Promise<ThemeJson>;
+export interface CreateThemeOptions {
+    mode?: ColorMode;
+    symbolPresetOverride?: SymbolPreset;
+    colorBlindMode?: boolean;
+}
+export declare function createTheme(themeJson: ThemeJson, options?: CreateThemeOptions): Theme;
+export declare function loadTheme(name: string, options?: CreateThemeOptions): Promise<Theme>;
+export declare function getThemeByName(name: string): Promise<Theme | undefined>;

package/dist/types/modes/theme/schema.d.ts

@@ -0,0 +1,175 @@
+import type { SpinnerFramesOverride } from "./symbols.js";
+export type ColorValue = string | number;
+export declare const themeJsonSchema: import("@oh-my-pi/omptype").FluentType<{
+    $schema?: string | undefined;
+    colors: {
+        accent: string | number;
+        bashMode: string | number;
+        border: string | number;
+        borderAccent: string | number;
+        borderMuted: string | number;
+        customMessageBg: string | number;
+        customMessageLabel: string | number;
+        customMessageText: string | number;
+        dim: string | number;
+        error: string | number;
+        mdCode: string | number;
+        mdCodeBlock: string | number;
+        mdCodeBlockBorder: string | number;
+        mdHeading: string | number;
+        mdHr: string | number;
+        mdLink: string | number;
+        mdLinkUrl: string | number;
+        mdListBullet: string | number;
+        mdQuote: string | number;
+        mdQuoteBorder: string | number;
+        muted: string | number;
+        pythonMode: string | number;
+        selectedBg: string | number;
+        statusLineBg: string | number;
+        statusLineContext: string | number;
+        statusLineCost: string | number;
+        statusLineDirty: string | number;
+        statusLineGitClean: string | number;
+        statusLineGitDirty: string | number;
+        statusLineModel: string | number;
+        statusLineOutput: string | number;
+        statusLinePath: string | number;
+        statusLineSep: string | number;
+        statusLineSpend: string | number;
+        statusLineStaged: string | number;
+        statusLineSubagents: string | number;
+        statusLineUntracked: string | number;
+        success: string | number;
+        syntaxComment: string | number;
+        syntaxFunction: string | number;
+        syntaxKeyword: string | number;
+        syntaxNumber: string | number;
+        syntaxOperator: string | number;
+        syntaxPunctuation: string | number;
+        syntaxString: string | number;
+        syntaxType: string | number;
+        syntaxVariable: string | number;
+        text: string | number;
+        thinkingHigh: string | number;
+        thinkingLow: string | number;
+        thinkingMax?: string | number | undefined;
+        thinkingMedium: string | number;
+        thinkingMinimal: string | number;
+        thinkingOff: string | number;
+        thinkingText: string | number;
+        thinkingXhigh: string | number;
+        toolDiffAdded: string | number;
+        toolDiffContext: string | number;
+        toolDiffRemoved: string | number;
+        toolErrorBg: string | number;
+        toolOutput: string | number;
+        toolPendingBg: string | number;
+        toolSuccessBg: string | number;
+        toolTitle: string | number;
+        userMessageBg: string | number;
+        userMessageText: string | number;
+        warning: string | number;
+    };
+    export?: {
+        cardBg?: string | number | undefined;
+        infoBg?: string | number | undefined;
+        pageBg?: string | number | undefined;
+    } | undefined;
+    name: string;
+    symbols?: {
+        overrides?: Record<string, string> | undefined;
+        preset?: "ascii" | "nerd" | "unicode" | undefined;
+        spinnerFrames?: SpinnerFramesOverride | undefined;
+    } | undefined;
+    vars?: Record<string, string | number> | undefined;
+}, {
+    $schema?: string | undefined;
+    colors: {
+        accent: string | number;
+        bashMode: string | number;
+        border: string | number;
+        borderAccent: string | number;
+        borderMuted: string | number;
+        customMessageBg: string | number;
+        customMessageLabel: string | number;
+        customMessageText: string | number;
+        dim: string | number;
+        error: string | number;
+        mdCode: string | number;
+        mdCodeBlock: string | number;
+        mdCodeBlockBorder: string | number;
+        mdHeading: string | number;
+        mdHr: string | number;
+        mdLink: string | number;
+        mdLinkUrl: string | number;
+        mdListBullet: string | number;
+        mdQuote: string | number;
+        mdQuoteBorder: string | number;
+        muted: string | number;
+        pythonMode: string | number;
+        selectedBg: string | number;
+        statusLineBg: string | number;
+        statusLineContext: string | number;
+        statusLineCost: string | number;
+        statusLineDirty: string | number;
+        statusLineGitClean: string | number;
+        statusLineGitDirty: string | number;
+        statusLineModel: string | number;
+        statusLineOutput: string | number;
+        statusLinePath: string | number;
+        statusLineSep: string | number;
+        statusLineSpend: string | number;
+        statusLineStaged: string | number;
+        statusLineSubagents: string | number;
+        statusLineUntracked: string | number;
+        success: string | number;
+        syntaxComment: string | number;
+        syntaxFunction: string | number;
+        syntaxKeyword: string | number;
+        syntaxNumber: string | number;
+        syntaxOperator: string | number;
+        syntaxPunctuation: string | number;
+        syntaxString: string | number;
+        syntaxType: string | number;
+        syntaxVariable: string | number;
+        text: string | number;
+        thinkingHigh: string | number;
+        thinkingLow: string | number;
+        thinkingMax?: string | number | undefined;
+        thinkingMedium: string | number;
+        thinkingMinimal: string | number;
+        thinkingOff: string | number;
+        thinkingText: string | number;
+        thinkingXhigh: string | number;
+        toolDiffAdded: string | number;
+        toolDiffContext: string | number;
+        toolDiffRemoved: string | number;
+        toolErrorBg: string | number;
+        toolOutput: string | number;
+        toolPendingBg: string | number;
+        toolSuccessBg: string | number;
+        toolTitle: string | number;
+        userMessageBg: string | number;
+        userMessageText: string | number;
+        warning: string | number;
+    };
+    export?: {
+        cardBg?: string | number | undefined;
+        infoBg?: string | number | undefined;
+        pageBg?: string | number | undefined;
+    } | undefined;
+    name: string;
+    symbols?: {
+        overrides?: Record<string, string> | undefined;
+        preset?: "ascii" | "nerd" | "unicode" | undefined;
+        spinnerFrames?: unknown;
+    } | undefined;
+    vars?: Record<string, string | number> | undefined;
+}>;
+export type ThemeJson = typeof themeJsonSchema.infer;
+export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "thinkingMax" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";
+/** Check if a string is a valid ThemeColor value */
+export declare function isValidThemeColor(color: string): color is ThemeColor;
+export type ThemeBg = "selectedBg" | "userMessageBg" | "customMessageBg" | "toolPendingBg" | "toolSuccessBg" | "toolErrorBg" | "statusLineBg";
+export type ColorMode = "truecolor" | "256color";

package/dist/types/modes/theme/symbols.d.ts

@@ -0,0 +1,28 @@
+export type SymbolPreset = "unicode" | "nerd" | "ascii";
+/**
+ * All available symbol keys organized by category.
+ */
+export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "status.done" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.prewalk" | "icon.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "icon.worktree" | "icon.search" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.ghost" | "icon.agents" | "icon.job" | "icon.cache" | "icon.cacheMiss" | "icon.input" | "icon.output" | "icon.throughput" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "icon.camera" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "thinking.autoPending" | "checkbox.checked" | "checkbox.unchecked" | "radio.selected" | "radio.unselected" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "md.colorSwatch" | "advisor.rail" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.julia" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.files" | "tab.shell" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tool.write" | "tool.edit" | "tool.bash" | "tool.ssh" | "tool.lsp" | "tool.gh" | "tool.webSearch" | "tool.exa" | "tool.browser" | "tool.eval" | "tool.debug" | "tool.mcp" | "tool.job" | "tool.launch" | "tool.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.inspectImage" | "tool.goal" | "tool.irc" | "tool.delete" | "tool.move";
+export type SymbolMap = Record<SymbolKey, string>;
+export declare const SYMBOL_PRESETS: Record<SymbolPreset, SymbolMap>;
+export type SpinnerType = "status" | "activity";
+export declare const SPINNER_FRAMES: Record<SymbolPreset, Record<SpinnerType, string[]>>;
+/**
+ * Shape accepted by `themeJson.symbols.spinnerFrames`. A flat array applies to
+ * both spinner types; an object lets a theme override `status` and/or
+ * `activity` independently. Anything not specified falls back to the symbol
+ * preset's default frames.
+ */
+export type SpinnerFramesOverride = string[] | {
+    status?: string[];
+    activity?: string[];
+};
+export declare function normalizeSpinnerFramesOverride(value: SpinnerFramesOverride | undefined): Partial<Record<SpinnerType, string[]>>;
+/**
+ * Get available symbol presets.
+ */
+export declare function getAvailableSymbolPresets(): SymbolPreset[];
+/**
+ * Check if a string is a valid symbol preset.
+ */
+export declare function isValidSymbolPreset(preset: string): preset is SymbolPreset;