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

package/dist/types/lsp/index.d.ts

@@ -1,130 +1,9 @@
-import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback, ToolApprovalDecision } from "@oh-my-pi/pi-agent-core";
-import type { BunFile } from "bun";
-import { type Theme } from "../modes/theme/theme.js";
-import type { ToolSession } from "../tools/index.js";
-import { type LspServerStatus } from "./client.js";
-import { type LspParams, type LspToolDetails, lspSchema } from "./types.js";
 export type { LspServerStatus } from "./client.js";
+export type { FileDiagnosticsResult } from "./diagnostics.js";
+export { FileFormatResult } from "./diagnostics.js";
+export type { LspStartupServerInfo, LspWarmupOptions, LspWarmupResult } from "./servers.js";
+export { discoverStartupLspServers, getLspStatus, LSP_READONLY_ACTIONS, warmupLspServers, } from "./servers.js";
+export { LspTool } from "./tool.js";
 export type { LspToolDetails } from "./types.js";
-/**
- * LSP actions that do not mutate the workspace or language-server state.
- * Anything not in this set (rename, code_actions with apply, rename_file,
- * reload, raw request, etc.) is classified as write-tier.
- */
-export declare const LSP_READONLY_ACTIONS: ReadonlySet<string>;
-export interface LspStartupServerInfo {
-    name: string;
-    status: "connecting" | "ready" | "error" | "available";
-    fileTypes: string[];
-    error?: string;
-}
-/** Result from warming up LSP servers */
-export interface LspWarmupResult {
-    servers: Array<LspStartupServerInfo & {
-        status: "ready" | "error";
-    }>;
-}
-/** Options for warming up LSP servers */
-export interface LspWarmupOptions {
-    /** Called when starting to connect to servers */
-    onConnecting?: (serverNames: string[]) => void;
-}
-export declare function discoverStartupLspServers(cwd: string, status?: LspStartupServerInfo["status"]): LspStartupServerInfo[];
-/**
- * Warm up LSP servers for a directory by connecting to all detected servers.
- * This should be called at startup to avoid cold-start delays.
- *
- * @param cwd - Working directory to detect and start servers for
- * @param options - Optional callbacks for progress reporting
- * @returns Status of each server that was started
- */
-export declare function warmupLspServers(cwd: string, options?: LspWarmupOptions): Promise<LspWarmupResult>;
-/**
- * Get status of currently active LSP servers.
- */
-export declare function getLspStatus(): LspServerStatus[];
-/** Result from getDiagnosticsForFile */
-export interface FileDiagnosticsResult {
-    /** Name of the LSP server used (if available) */
-    server?: string;
-    /** Formatted diagnostic messages */
-    messages: string[];
-    /** Summary string (e.g., "2 error(s), 1 warning(s)") */
-    summary: string;
-    /** Whether there are any errors (severity 1) */
-    errored: boolean;
-    /** Whether the file was formatted */
-    formatter?: FileFormatResult;
-}
-export declare enum FileFormatResult {
-    UNCHANGED = "unchanged",
-    FORMATTED = "formatted"
-}
-/** Options for creating the LSP writethrough callback */
-export interface WritethroughOptions {
-    /** Whether to format the file using LSP after writing */
-    enableFormat?: boolean;
-    /** Whether to get LSP diagnostics after writing */
-    enableDiagnostics?: boolean;
-    /** Called when diagnostics arrive after the main timeout. */
-    onDeferredDiagnostics?: (diagnostics: FileDiagnosticsResult) => void;
-    /** Signal to cancel a pending deferred diagnostics fetch. */
-    deferredSignal?: AbortSignal;
-    /** Transform diagnostics before surfacing them after a successful fetch. */
-    transformDiagnostics?: (absPath: string, result: FileDiagnosticsResult) => FileDiagnosticsResult;
-}
-/** Per-file deferred LSP diagnostics wiring for {@link WritethroughCallback}. */
-export type WritethroughDeferredHandle = {
-    onDeferredDiagnostics: (diagnostics: FileDiagnosticsResult) => void;
-    signal: AbortSignal;
-    finalize: (diagnostics: FileDiagnosticsResult | undefined) => void;
-};
-/** Callback type for the LSP writethrough */
-export type WritethroughCallback = (dst: string, content: string, signal?: AbortSignal, file?: BunFile, batch?: LspWritethroughBatchRequest, getDeferred?: (dst: string) => WritethroughDeferredHandle | undefined) => Promise<FileDiagnosticsResult | undefined>;
-/** No-op writethrough callback */
-export declare function writethroughNoop(dst: string, content: string, _signal?: AbortSignal, file?: BunFile, _batch?: LspWritethroughBatchRequest, _getDeferred?: (dst: string) => WritethroughDeferredHandle | undefined): Promise<FileDiagnosticsResult | undefined>;
-interface LspWritethroughBatchRequest {
-    id: string;
-    flush: boolean;
-}
-export declare function flushLspWritethroughBatch(id: string, cwd: string, signal?: AbortSignal): Promise<FileDiagnosticsResult | undefined>;
-/** Create a writethrough callback for LSP aware write operations */
-export declare function createLspWritethrough(cwd: string, options?: WritethroughOptions): WritethroughCallback;
-/**
- * LSP tool for language server protocol operations.
- */
-export declare class LspTool implements AgentTool<typeof lspSchema, LspToolDetails, Theme> {
-    private readonly session;
-    readonly name = "lsp";
-    readonly approval: (args: unknown) => ToolApprovalDecision;
-    readonly formatApprovalDetails: (args: unknown) => string[];
-    readonly label = "LSP";
-    readonly loadMode = "discoverable";
-    readonly summary = "Query LSP (language server) for diagnostics, hover info, and references";
-    readonly description: string;
-    readonly parameters: import("@oh-my-pi/omptype").FluentType<{
-        action: "capabilities" | "code_actions" | "definition" | "diagnostics" | "hover" | "implementation" | "references" | "reload" | "rename" | "rename_file" | "request" | "status" | "symbols" | "type_definition";
-        apply?: boolean | undefined;
-        file?: string | undefined;
-        line?: number | undefined;
-        new_name?: string | undefined;
-        payload?: string | undefined;
-        query?: string | undefined;
-        symbol?: string | undefined;
-        timeout?: number | undefined;
-    }, {
-        action: "capabilities" | "code_actions" | "definition" | "diagnostics" | "hover" | "implementation" | "references" | "reload" | "rename" | "rename_file" | "request" | "status" | "symbols" | "type_definition";
-        apply?: boolean | undefined;
-        file?: string | undefined;
-        line?: number | undefined;
-        new_name?: string | undefined;
-        payload?: string | undefined;
-        query?: string | undefined;
-        symbol?: string | undefined;
-        timeout?: number | undefined;
-    }>;
-    readonly strict = true;
-    constructor(session: ToolSession);
-    static createIf(session: ToolSession): LspTool | null;
-    execute(_toolCallId: string, params: LspParams, signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<LspToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<LspToolDetails>>;
-}
+export type { WritethroughCallback, WritethroughDeferredHandle, WritethroughOptions, } from "./writethrough.js";
+export { createLspWritethrough, flushLspWritethroughBatch, writethroughNoop, } from "./writethrough.js";

package/dist/types/lsp/servers.d.ts

@@ -0,0 +1,72 @@
+import { type LspServerStatus } from "./client.js";
+import { type LspConfig } from "./config.js";
+import type { LspClient, ServerConfig } from "./types.js";
+/**
+ * LSP actions that do not mutate the workspace or language-server state.
+ * Anything not in this set (rename, code_actions with apply, rename_file,
+ * reload, raw request, etc.) is classified as write-tier.
+ */
+export declare const LSP_READONLY_ACTIONS: ReadonlySet<string>;
+export interface LspStartupServerInfo {
+    name: string;
+    status: "connecting" | "ready" | "error" | "available";
+    fileTypes: string[];
+    error?: string;
+}
+/** Result from warming up LSP servers */
+export interface LspWarmupResult {
+    servers: Array<LspStartupServerInfo & {
+        status: "ready" | "error";
+    }>;
+}
+/** Options for warming up LSP servers */
+export interface LspWarmupOptions {
+    /** Called when starting to connect to servers */
+    onConnecting?: (serverNames: string[]) => void;
+}
+export declare function discoverStartupLspServers(cwd: string, status?: LspStartupServerInfo["status"]): LspStartupServerInfo[];
+/**
+ * Warm up LSP servers for a directory by connecting to all detected servers.
+ * This should be called at startup to avoid cold-start delays.
+ *
+ * @param cwd - Working directory to detect and start servers for
+ * @param options - Optional callbacks for progress reporting
+ * @returns Status of each server that was started
+ */
+export declare function warmupLspServers(cwd: string, options?: LspWarmupOptions): Promise<LspWarmupResult>;
+/**
+ * Get status of currently active LSP servers.
+ */
+export declare function getLspStatus(): LspServerStatus[];
+/**
+ * Sync in-memory file content to all applicable LSP servers.
+ * Sends didOpen (if new) or didChange (if already open).
+ *
+ * @param absolutePath - Absolute path to the file
+ * @param content - The new file content
+ * @param cwd - Working directory for LSP config resolution
+ * @param servers - Servers to sync to
+ */
+export declare function syncFileContent(absolutePath: string, content: string, cwd: string, servers: Array<[string, ServerConfig]>, signal?: AbortSignal, createMissing?: boolean): Promise<void>;
+/**
+ * Notify all LSP servers that a file was saved.
+ * Assumes content was already synced via syncFileContent.
+ *
+ * @param absolutePath - Absolute path to the file
+ * @param cwd - Working directory for LSP config resolution
+ * @param servers - Servers to notify
+ */
+export declare function notifyFileSaved(absolutePath: string, cwd: string, servers: Array<[string, ServerConfig]>, signal?: AbortSignal, createMissing?: boolean): Promise<void>;
+export declare const configCache: Map<string, LspConfig>;
+export declare function getConfig(cwd: string): LspConfig;
+export declare function splitServers(servers: Array<[string, ServerConfig]>): {
+    lspServers: Array<[string, ServerConfig]>;
+    customLinterServers: Array<[string, ServerConfig]>;
+};
+export declare function getLspServers(config: LspConfig): Array<[string, ServerConfig]>;
+export declare function getLspServersForFile(config: LspConfig, filePath: string): Array<[string, ServerConfig]>;
+export declare function getLspServerForFile(config: LspConfig, filePath: string): [string, ServerConfig] | null;
+export declare function isProjectAwareLspServer(serverConfig: ServerConfig): boolean;
+/** True when an LSP error indicates the server doesn't implement the requested method. */
+export declare function isMethodNotFoundError(err: unknown): boolean;
+export declare function reloadServer(client: LspClient, serverName: string, signal?: AbortSignal): Promise<string>;

package/dist/types/lsp/tool.d.ts

@@ -0,0 +1,42 @@
+import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback, ToolApprovalDecision } from "@oh-my-pi/pi-agent-core";
+import { type Theme } from "../modes/theme/theme.js";
+import type { ToolSession } from "../tools/index.js";
+import { type LspParams, type LspToolDetails, lspSchema } from "./types.js";
+/**
+ * LSP tool for language server protocol operations.
+ */
+export declare class LspTool implements AgentTool<typeof lspSchema, LspToolDetails, Theme> {
+    private readonly session;
+    readonly name = "lsp";
+    readonly approval: (args: unknown) => ToolApprovalDecision;
+    readonly formatApprovalDetails: (args: unknown) => string[];
+    readonly label = "LSP";
+    readonly loadMode = "discoverable";
+    readonly summary = "Query LSP (language server) for diagnostics, hover info, and references";
+    readonly description: string;
+    readonly parameters: import("@oh-my-pi/omptype").FluentType<{
+        action: "capabilities" | "code_actions" | "definition" | "diagnostics" | "hover" | "implementation" | "references" | "reload" | "rename" | "rename_file" | "request" | "status" | "symbols" | "type_definition";
+        apply?: boolean | undefined;
+        file?: string | undefined;
+        line?: number | undefined;
+        new_name?: string | undefined;
+        payload?: string | undefined;
+        query?: string | undefined;
+        symbol?: string | undefined;
+        timeout?: number | undefined;
+    }, {
+        action: "capabilities" | "code_actions" | "definition" | "diagnostics" | "hover" | "implementation" | "references" | "reload" | "rename" | "rename_file" | "request" | "status" | "symbols" | "type_definition";
+        apply?: boolean | undefined;
+        file?: string | undefined;
+        line?: number | undefined;
+        new_name?: string | undefined;
+        payload?: string | undefined;
+        query?: string | undefined;
+        symbol?: string | undefined;
+        timeout?: number | undefined;
+    }>;
+    readonly strict = true;
+    constructor(session: ToolSession);
+    static createIf(session: ToolSession): LspTool | null;
+    execute(_toolCallId: string, params: LspParams, signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<LspToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<LspToolDetails>>;
+}

package/dist/types/lsp/workspace-diagnostics.d.ts

@@ -0,0 +1,12 @@
+/** Project type detection result */
+interface ProjectType {
+    type: "rust" | "typescript" | "go" | "python" | "unknown";
+    command?: string[];
+    description: string;
+}
+/** Run workspace diagnostics command and parse output */
+export declare function runWorkspaceDiagnostics(cwd: string, signal?: AbortSignal): Promise<{
+    output: string;
+    projectType: ProjectType;
+}>;
+export {};

package/dist/types/lsp/writethrough.d.ts

@@ -0,0 +1,33 @@
+import type { BunFile } from "bun";
+import { type FileDiagnosticsResult } from "./diagnostics.js";
+/** Options for creating the LSP writethrough callback */
+export interface WritethroughOptions {
+    /** Whether to format the file using LSP after writing */
+    enableFormat?: boolean;
+    /** Whether to get LSP diagnostics after writing */
+    enableDiagnostics?: boolean;
+    /** Called when diagnostics arrive after the main timeout. */
+    onDeferredDiagnostics?: (diagnostics: FileDiagnosticsResult) => void;
+    /** Signal to cancel a pending deferred diagnostics fetch. */
+    deferredSignal?: AbortSignal;
+    /** Transform diagnostics before surfacing them after a successful fetch. */
+    transformDiagnostics?: (absPath: string, result: FileDiagnosticsResult) => FileDiagnosticsResult;
+}
+/** Per-file deferred LSP diagnostics wiring for {@link WritethroughCallback}. */
+export type WritethroughDeferredHandle = {
+    onDeferredDiagnostics: (diagnostics: FileDiagnosticsResult) => void;
+    signal: AbortSignal;
+    finalize: (diagnostics: FileDiagnosticsResult | undefined) => void;
+};
+/** Callback type for the LSP writethrough */
+export type WritethroughCallback = (dst: string, content: string, signal?: AbortSignal, file?: BunFile, batch?: LspWritethroughBatchRequest, getDeferred?: (dst: string) => WritethroughDeferredHandle | undefined) => Promise<FileDiagnosticsResult | undefined>;
+/** No-op writethrough callback */
+export declare function writethroughNoop(dst: string, content: string, _signal?: AbortSignal, file?: BunFile, _batch?: LspWritethroughBatchRequest, _getDeferred?: (dst: string) => WritethroughDeferredHandle | undefined): Promise<FileDiagnosticsResult | undefined>;
+interface LspWritethroughBatchRequest {
+    id: string;
+    flush: boolean;
+}
+export declare function flushLspWritethroughBatch(id: string, cwd: string, signal?: AbortSignal): Promise<FileDiagnosticsResult | undefined>;
+/** Create a writethrough callback for LSP aware write operations */
+export declare function createLspWritethrough(cwd: string, options?: WritethroughOptions): WritethroughCallback;
+export {};

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

@@ -13,7 +13,7 @@
  *    origin. Method-changing redirects of non-GET requests are refused.
  */
 /** Header buckets for one MCP HTTP request. */
-export interface MCPHeaderSources {
+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). */
@@ -43,3 +43,4 @@ export interface MCPFetchInit {
  * 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/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/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;