@oh-my-pi/pi-coding-agent 16.1.13 → 16.1.15

package/dist/types/eval/rb/index.d.ts

@@ -0,0 +1,11 @@
+import type { ToolSession } from "../../tools";
+import { type ExecutorBackendExecOptions, type ExecutorBackendResult } from "../backend";
+export declare function namespaceSessionId(sessionId: string): string;
+declare const _default: {
+    id: "ruby";
+    label: string;
+    highlightLang: string;
+    isAvailable(session: ToolSession): Promise<boolean>;
+    execute(code: string, opts: ExecutorBackendExecOptions): Promise<ExecutorBackendResult>;
+};
+export default _default;

package/dist/types/eval/rb/kernel.d.ts

@@ -0,0 +1,31 @@
+import { BaseKernel, type KernelRuntimeEnv, type KernelStartOptions } from "../kernel-base";
+import type { KernelDisplayOutput } from "../py/display";
+import { type RubyRuntime } from "./runtime";
+export type { KernelExecuteResult, KernelRuntimeEnv, KernelShutdownResult } from "../kernel-base";
+export type { KernelDisplayOutput, PythonStatusEvent } from "../py/display";
+export { renderKernelDisplay } from "../py/display";
+export interface KernelExecuteOptions {
+    id?: string;
+    /** Runtime working directory applied immediately before this request executes. */
+    cwd?: string;
+    /** Managed runtime environment variables applied immediately before this request executes. */
+    env?: KernelRuntimeEnv;
+    signal?: AbortSignal;
+    onChunk?: (text: string) => Promise<void> | void;
+    onDisplay?: (output: KernelDisplayOutput) => Promise<void> | void;
+    timeoutMs?: number;
+    silent?: boolean;
+    storeHistory?: boolean;
+}
+export interface RubyKernelAvailability {
+    ok: boolean;
+    rubyPath?: string;
+    reason?: string;
+    /** The probed-working runtime, when one was found. */
+    runtime?: RubyRuntime;
+}
+export declare function checkRubyKernelAvailability(cwd: string, interpreter?: string): Promise<RubyKernelAvailability>;
+export declare class RubyKernel extends BaseKernel<KernelExecuteOptions> {
+    private constructor();
+    static start(options: KernelStartOptions): Promise<RubyKernel>;
+}

package/dist/types/eval/rb/prelude.d.ts

@@ -0,0 +1 @@
+export declare const RUBY_PRELUDE: string;

package/dist/types/eval/rb/runtime.d.ts

@@ -0,0 +1,23 @@
+export interface RubyRuntime {
+    /** Path to the ruby executable. */
+    rubyPath: string;
+    /** Filtered environment variables. */
+    env: Record<string, string | undefined>;
+}
+export declare const filterEnv: (env: Record<string, string | undefined>) => Record<string, string | undefined>;
+/**
+ * Resolve an explicitly configured interpreter (`ruby.interpreter`) into a
+ * runtime, bypassing discovery. Does not probe the executable — callers must
+ * check it actually runs. `~` expands to the home directory and relative paths
+ * resolve against `cwd`.
+ */
+export declare function resolveExplicitRubyRuntime(interpreter: string, cwd: string, baseEnv: Record<string, string | undefined>): RubyRuntime;
+/**
+ * Enumerate candidate Ruby runtimes in priority order. With an explicit
+ * interpreter that is the only candidate; otherwise the first `ruby` on PATH.
+ */
+export declare function enumerateRubyRuntimes(cwd: string, baseEnv: Record<string, string | undefined>, interpreter?: string): RubyRuntime[];
+/**
+ * Resolve the highest-priority Ruby runtime. Throws when none exists.
+ */
+export declare function resolveRubyRuntime(cwd: string, baseEnv: Record<string, string | undefined>, interpreter?: string): RubyRuntime;

package/dist/types/eval/runtime-env.d.ts

@@ -0,0 +1,24 @@
+export declare const CASE_INSENSITIVE_ENV: boolean;
+export declare const SECRET_KEY_PATTERN: RegExp;
+export interface EnvFilterOptions {
+    allowList: string[];
+    windowsAllowList: string[];
+    denyList: string[];
+    allowPrefixes: string[];
+}
+/**
+ * Creates an environment filter function based on the provided allowlists, denylists, and prefixes.
+ */
+export declare function createEnvFilter(options: EnvFilterOptions): (env: Record<string, string | undefined>) => Record<string, string | undefined>;
+/**
+ * Resolve an explicitly configured interpreter path, expanding `~` to the home directory.
+ */
+export declare function resolveExplicitPath(interpreter: string, cwd: string): string;
+/**
+ * Enumerates candidate runtimes in priority order.
+ */
+export declare function enumerateRuntimes<T>(cwd: string, baseEnv: Record<string, string | undefined>, binaryName: string, createRuntime: (executablePath: string, env: Record<string, string | undefined>) => T, interpreter?: string): T[];
+/**
+ * Resolves the highest-priority runtime. Throws when none exists.
+ */
+export declare function resolveRuntime<T>(cwd: string, baseEnv: Record<string, string | undefined>, binaryName: string, createRuntime: (executablePath: string, env: Record<string, string | undefined>) => T, interpreter?: string): T;

package/dist/types/eval/types.d.ts

@@ -1,13 +1,13 @@
 /** Runtime backend that an eval cell dispatches to. */
-export type EvalLanguage = "python" | "js";
+export type EvalLanguage = "python" | "js" | "ruby" | "julia";
 import type { ImageContent } from "@oh-my-pi/pi-ai";
 import type { OutputMeta } from "../tools/output-meta";
-/** Status event emitted by prelude helpers (python or js) for TUI rendering. */
+/** Status event emitted by eval prelude helpers for TUI rendering. */
 export interface EvalStatusEvent {
     op: string;
     [key: string]: unknown;
 }
-/** Display output captured during eval execution. Union of python and js shapes. */
+/** Display output captured during eval execution across supported backends. */
 export type EvalDisplayOutput = {
     type: "json";
     data: unknown;

package/dist/types/export/share.d.ts

@@ -6,9 +6,16 @@ import { type SessionData } from "./html";
 export { DEFAULT_SHARE_URL };
 /** Hard cap for blobs accepted by the share server (mirrors relay shareMaxBytes). */
 export declare const SERVER_MAX_SEALED_BYTES = 1000000;
+export type ShareStore = "blob" | "gist";
 export interface ShareSessionOptions {
     /** Share server/viewer base URL; defaults to {@link DEFAULT_SHARE_URL}. */
     serverUrl?: string;
+    /**
+     * Where to upload the sealed blob. `"blob"` (default) posts to the share
+     * server; `"gist"` pushes to a secret GitHub gist first (needs an
+     * authenticated `gh`) and falls back to the server.
+     */
+    store?: ShareStore;
     /** Agent state for system prompt + tool descriptions in the snapshot. */
     state?: AgentState;
     /**
@@ -36,7 +43,7 @@ export interface ShareSessionResult {
 }
 /** Build the snapshot that gets sealed and uploaded, redacted when an obfuscator is provided. */
 export declare function buildShareSnapshot(sm: SessionManager, options?: ShareSessionOptions): SessionData;
-/** Share the session; tries a secret gist first, then the share server. */
+/** Share the session; uploads to the share server unless `options.store` is `"gist"`. */
 export declare function shareSession(sm: SessionManager, options?: ShareSessionOptions): Promise<ShareSessionResult>;
 /** Strip trailing slashes so `<base>/<id>` composes cleanly. */
 export declare function normalizeShareServerUrl(serverUrl?: string): string;

package/dist/types/extensibility/extensions/runner.d.ts

@@ -8,6 +8,7 @@ import type { ModelRegistry } from "../../config/model-registry";
 import type { Settings } from "../../config/settings";
 import type { MemoryRuntimeContext } from "../../memory-backend";
 import type { SessionManager } from "../../session/session-manager";
+import type { BranchHandler, NavigateTreeHandler, NewSessionHandler } from "../session-handler-types";
 import type { AfterProviderResponseEvent, AssistantThinkingRenderer, BeforeAgentStartEvent, BeforeAgentStartEventResult, BeforeProviderRequestEvent, BeforeProviderRequestEventResult, ContextEvent, Extension, ExtensionActions, ExtensionCommandContext, ExtensionCommandContextActions, ExtensionContext, ExtensionContextActions, ExtensionError, ExtensionEvent, ExtensionFlag, ExtensionRuntime, ExtensionShortcut, ExtensionUIContext, InputEvent, InputEventResult, MessageRenderer, RegisteredCommand, RegisteredTool, ResourcesDiscoverEvent, SessionBeforeBranchResult, SessionBeforeCompactResult, SessionBeforeSwitchResult, SessionBeforeTreeResult, SessionCompactingResult, SessionStopEvent, SessionStopEventResult, ToolCallEvent, ToolCallEventResult, ToolResultEvent, ToolResultEventResult, UserBashEvent, UserBashEventResult, UserPythonEvent, UserPythonEventResult } from "./types";
 /** Combined result from all before_agent_start handlers */
 interface BeforeAgentStartCombinedResult {
@@ -46,20 +47,7 @@ type RunnerEmitResult<TEvent extends RunnerEmitEvent> = TEvent extends {
 } ? SessionCompactingResult | undefined : TEvent extends {
     type: "session_stop";
 } ? SessionStopEventResult | undefined : undefined;
-export type NewSessionHandler = (options?: {
-    parentSession?: string;
-    setup?: (sessionManager: SessionManager) => Promise<void>;
-}) => Promise<{
-    cancelled: boolean;
-}>;
-export type BranchHandler = (entryId: string) => Promise<{
-    cancelled: boolean;
-}>;
-export type NavigateTreeHandler = (targetId: string, options?: {
-    summarize?: boolean;
-}) => Promise<{
-    cancelled: boolean;
-}>;
+export type { BranchHandler, NavigateTreeHandler, NewSessionHandler };
 export type SwitchSessionHandler = (sessionPath: string) => Promise<{
     cancelled: boolean;
 }>;
@@ -156,4 +144,3 @@ export declare class ExtensionRunner {
     emitAfterProviderResponse(response: ProviderResponseMetadata, _model?: Model): Promise<void>;
     emitBeforeAgentStart(prompt: string, images: ImageContent[] | undefined, systemPrompt: string[]): Promise<BeforeAgentStartCombinedResult | undefined>;
 }
-export {};

package/dist/types/extensibility/hooks/loader.d.ts

@@ -1,5 +1,4 @@
 import type { HookMessage } from "../../session/messages";
-import type { SessionManager } from "../../session/session-manager";
 import type { HookMessageRenderer, RegisteredCommand } from "./types";
 /**
  * Generic handler function type.
@@ -16,29 +15,7 @@ export type SendMessageHandler = <T = unknown>(message: Pick<HookMessage<T>, "cu
  * Append entry handler type for pi.appendEntry().
  */
 export type AppendEntryHandler = <T = unknown>(customType: string, data?: T) => void;
-/**
- * New session handler type for ctx.newSession() in HookCommandContext.
- */
-export type NewSessionHandler = (options?: {
-    parentSession?: string;
-    setup?: (sessionManager: SessionManager) => Promise<void>;
-}) => Promise<{
-    cancelled: boolean;
-}>;
-/**
- * Branch handler type for ctx.branch() in HookCommandContext.
- */
-export type BranchHandler = (entryId: string) => Promise<{
-    cancelled: boolean;
-}>;
-/**
- * Navigate tree handler type for ctx.navigateTree() in HookCommandContext.
- */
-export type NavigateTreeHandler = (targetId: string, options?: {
-    summarize?: boolean;
-}) => Promise<{
-    cancelled: boolean;
-}>;
+export type { BranchHandler, NavigateTreeHandler, NewSessionHandler } from "../session-handler-types";
 /**
  * Registered handlers for a loaded hook.
  */
@@ -86,4 +63,3 @@ export declare function loadHooks(paths: string[], cwd: string): Promise<LoadHoo
  * Plus any explicitly configured paths from settings.
  */
 export declare function discoverAndLoadHooks(configuredPaths: string[], cwd: string): Promise<LoadHooksResult>;
-export {};

package/dist/types/extensibility/session-handler-types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Session-lifecycle handler types shared by the extension runner and the hook
+ * loader/runner. Both surfaces wire the same new-session / branch / navigate
+ * handlers into their command contexts; this is the single source of truth.
+ */
+import type { SessionManager } from "../session/session-manager";
+/** Handler for `ctx.newSession()` — creates (and optionally seeds) a session. */
+export type NewSessionHandler = (options?: {
+    parentSession?: string;
+    setup?: (sessionManager: SessionManager) => Promise<void>;
+}) => Promise<{
+    cancelled: boolean;
+}>;
+/** Handler for `ctx.branch()` — branches from a transcript entry. */
+export type BranchHandler = (entryId: string) => Promise<{
+    cancelled: boolean;
+}>;
+/** Handler for `ctx.navigateTree()` — navigates the session tree. */
+export type NavigateTreeHandler = (targetId: string, options?: {
+    summarize?: boolean;
+}) => Promise<{
+    cancelled: boolean;
+}>;

package/dist/types/jsonrpc/message-framing.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared Content-Length message framing for the JSON byte streams spoken by the
+ * LSP and DAP stdio clients. Both protocols use the same base-protocol framing:
+ * each message is a `Content-Length: <n>\r\n\r\n` header block followed by `<n>`
+ * bytes of UTF-8 JSON. This module owns the incremental decode so the two
+ * clients don't each reimplement chunk accumulation, header scanning, and the
+ * mid-message remainder handoff.
+ */
+/**
+ * Incremental Content-Length frame decoder for a JSON message byte stream.
+ *
+ * Incoming bytes are buffered as a list of chunks and only joined when a full
+ * message is framed — concatenating the accumulator on every read is O(n^2) for
+ * messages that span many reads (e.g. a large initial diagnostics burst). Feed
+ * raw chunks with {@link push}, pull every complete message with {@link drain},
+ * and persist {@link remainder} when the reader stops so a restarted reader
+ * resumes mid-message.
+ */
+export declare class MessageFramer {
+    #private;
+    /** Seed the buffer with any unparsed remainder left by a previous reader. */
+    constructor(seed: Buffer);
+    /** Append a freshly read chunk to the pending buffer. */
+    push(chunk: Buffer): void;
+    /**
+     * Yield the JSON text of every complete message currently buffered. A header
+     * block without a `Content-Length` is non-protocol noise (e.g. a server
+     * printing to stdout); `onResync` is invoked with the offending header text
+     * and the framer drops past the bogus terminator to recover instead of
+     * stalling on the same junk header forever.
+     */
+    drain(onResync: (headerText: string) => void): Generator<string>;
+    /** The unparsed remainder, to persist when the reader stops. */
+    remainder(): Buffer;
+}

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

@@ -16,7 +16,18 @@ export interface ResolveStdioSpawnOptions {
     env: Record<string, string | undefined>;
     platform?: NodeJS.Platform;
 }
-/** Resolve the subprocess argv used to launch an MCP stdio server. */
+/**
+ * Resolve the subprocess argv used to launch an MCP stdio server.
+ *
+ * On Windows, our PATH/PATHEXT walk may return `null` for a bare command
+ * (e.g. `npx`) — `Bun.env.PATH` empty under a restricted parent process,
+ * UNC/network mounts that reject `fs.access`, locked-down shells. The
+ * legacy fallback handed `Bun.spawn` the bare name, but `CreateProcess`
+ * only appends `.exe` for extensionless names — `.cmd`/`.bat` are never
+ * tried, so `npx` (which exists only as `npx.cmd` on Windows) crashes the
+ * subprocess immediately. When the resolver can't pin the command down,
+ * route through `cmd.exe /d /s /c` so Windows's own PATHEXT lookup runs.
+ */
 export declare function resolveStdioSpawnCommand(config: MCPStdioServerConfig, options: ResolveStdioSpawnOptions): Promise<StdioSpawnCommand>;
 /** Minimal write surface of `Subprocess.stdin` we need for framed sends. */
 interface FrameSink {

package/dist/types/mnemopi/embed-client.d.ts

@@ -1,43 +1,27 @@
-import type { Subprocess } from "bun";
+import { type SpawnedSubprocess, type WorkerHandle } from "../subprocess/worker-client";
 import type { MnemopiEmbedModelId, MnemopiEmbedWorkerInbound, MnemopiEmbedWorkerOutbound } from "./embed-protocol";
 /**
- * Abstraction over the mnemopi embeddings subprocess. The runtime
+ * Parent-side handle for the mnemopi embeddings subprocess. The runtime
  * implementation is a Bun child process so `onnxruntime-node`'s NAPI
  * constructor + finalizer never run inside the main agent address space —
  * those destructors segfault Bun on Windows when mnemopi's local embedding
  * provider loads fastembed in the main process (issue #3031; the mnemopi
  * sibling of the tiny-model fix from #1606 / #1607).
  */
-export interface MnemopiEmbedWorkerHandle {
-    send(message: MnemopiEmbedWorkerInbound): void;
-    onMessage(handler: (message: MnemopiEmbedWorkerOutbound) => void): () => void;
-    onError(handler: (error: Error) => void): () => void;
-    terminate(): Promise<void>;
-}
+export type MnemopiEmbedWorkerHandle = WorkerHandle<MnemopiEmbedWorkerInbound, MnemopiEmbedWorkerOutbound>;
 /**
  * Hidden subcommand on the main CLI that boots the mnemopi embeddings worker
  * in the spawned subprocess. Kept in sync with the dispatch in `cli.ts`.
  */
 export declare const MNEMOPI_EMBED_WORKER_ARG = "__omp_worker_mnemopi_embed";
-interface SpawnedSubprocess {
-    proc: Subprocess<"ignore", "ignore", "ignore">;
-    inbound: Set<(message: MnemopiEmbedWorkerOutbound) => void>;
-    errors: Set<(error: Error) => void>;
-    /**
-     * Flipped to `true` right before the deliberate SIGKILL so `onExit` can
-     * distinguish the expected hard-kill from a crash (SIGSEGV from a native
-     * fault, OOM SIGKILL, operator `kill -9`). Only the latter surfaces as a
-     * worker error so callers don't await forever.
-     */
-    intentionalExit: {
-        value: boolean;
-    };
-}
 /**
  * Spawn the mnemopi embeddings worker as a subprocess. Exported for tests and
  * the smoke probe; production callers go through {@link spawnMnemopiEmbedWorker}.
+ * The child inherits the parent env verbatim — fastembed honours `HF_HUB_*`,
+ * `HTTPS_PROXY`, etc., and our `loadFastembed()` reads the same `OMP_*`
+ * runtime-install knobs the parent uses.
  */
-export declare function createMnemopiEmbedSubprocess(): SpawnedSubprocess;
+export declare function createMnemopiEmbedSubprocess(): SpawnedSubprocess<MnemopiEmbedWorkerOutbound>;
 /**
  * Per-model wrapper produced by {@link MnemopiEmbedClient.initialize}.
  * `embed()` round-trips one batch of texts through the worker subprocess and
@@ -67,4 +51,3 @@ export declare function shutdownMnemopiEmbedClient(): Promise<void>;
 export declare function smokeTestMnemopiEmbedWorker({ timeoutMs, }?: {
     timeoutMs?: number;
 }): Promise<void>;
-export {};

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

@@ -12,7 +12,7 @@
  * component reuse could.
  */
 import type { AgentTool } from "@oh-my-pi/pi-agent-core";
-import { type TUI } from "@oh-my-pi/pi-tui";
+import type { TUI } from "@oh-my-pi/pi-tui";
 import type { MessageRenderer } from "../../extensibility/extensions/types";
 import type { SessionMessageEntry } from "../../session/session-entries";
 import { TranscriptContainer } from "./transcript-container";

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

@@ -1,3 +1,4 @@
+import type { ImageContent } from "@oh-my-pi/pi-ai";
 import { Editor, type KeyId } from "@oh-my-pi/pi-tui";
 import type { AppKeybinding } from "../../config/keybindings";
 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.thinking.toggle" | "app.editor.external" | "app.history.search" | "app.message.dequeue" | "app.retry" | "app.clipboard.pasteImage" | "app.clipboard.pasteTextRaw" | "app.clipboard.copyPrompt">;
@@ -26,6 +27,16 @@ export declare function extractBracketedImagePastePath(data: string): string | u
 export declare class CustomEditor extends Editor {
     #private;
     imageLinks?: readonly (string | undefined)[];
+    /** Draft images pasted into the composer, consumed on submit. Co-located with
+     *  {@link imageLinks} so every piece of draft-image state lives on the editor. */
+    pendingImages: ImageContent[];
+    /** Per-image source links (file:// targets) parallel to {@link pendingImages};
+     *  `undefined` entries are images without a backing reference yet. */
+    pendingImageLinks: (string | undefined)[];
+    /** Clear the composer draft: optionally commit `historyText` to history, then
+     *  reset the editor text and all pending draft-image state. The shared tail of
+     *  every "message submitted" path; pass no argument for a plain discard. */
+    clearDraft(historyText?: string): void;
     /** Treat image/paste markers as indivisible: a stray backspace deletes the whole token
      *  instead of corrupting `[Paste #1, +30 lines]` into plain text. */
     atomicTokenPattern: RegExp;

package/dist/types/modes/components/selector-helpers.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Render `rows` through a {@link ScrollView} with the shared list theme (muted
+ * track / accent thumb) and an "auto" scrollbar, positioned at `scrollOffset`.
+ * Returns the rendered lines for the caller to append to its output.
+ */
+export declare function renderScrollableList(rows: readonly string[], options: {
+    width: number;
+    totalRows: number;
+    scrollOffset: number;
+}): readonly string[];
+/**
+ * Center a viewport window of `maxVisible` rows on `selectedIndex` within a
+ * list of `total` rows, clamped to valid bounds. Used by the selection-centered
+ * list panes (history search, tree selector).
+ */
+export declare function centeredWindow(selectedIndex: number, total: number, maxVisible: number): {
+    startIndex: number;
+    endIndex: number;
+};
+/**
+ * Width available for row content, reserving the rightmost column for the
+ * scrollbar when the list overflows its visible window.
+ */
+export declare function contentRowWidth(width: number, total: number, maxVisible: number): number;
+/**
+ * Clamp `selectedIndex` into `[0, total)` and nudge `scrollOffset` so the
+ * selection stays within the visible window of `maxVisible` rows. Returns the
+ * adjusted pair; on an empty list both reset to 0.
+ */
+export declare function clampSelection(selectedIndex: number, scrollOffset: number, total: number, maxVisible: number): {
+    selectedIndex: number;
+    scrollOffset: number;
+};
+/**
+ * Classify a key event for search-query text entry. Returns the single
+ * printable character to append to the query, or `null` when the key is not a
+ * searchable character: non-printable, multi-byte, or a reserved `j`/`k`
+ * navigation key.
+ */
+export declare function searchableChar(data: string): string | null;
+/**
+ * Handle the shared tab-cycling keys: Tab/Right advance to the next tab,
+ * Shift+Tab/Left to the previous. Invokes `switchTab` with the direction and
+ * returns true when the key was consumed.
+ */
+export declare function handleTabSwitchKey(data: string, switchTab: (direction: 1 | -1) => void): boolean;
+/**
+ * Pad `lines` with blank rows up to `rows` so a full-screen overlay covers the
+ * viewport instead of letting the transcript peek through below it. Copies
+ * before padding — the source array may be component-owned and must not be
+ * mutated.
+ */
+export declare function padLinesToHeight(lines: readonly string[], rows: number): readonly string[];

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

@@ -2,8 +2,9 @@ import type { ThemeColor } from "../../../modes/theme/theme";
 export type ContextUsageLevel = "normal" | "warning" | "purple" | "error";
 export declare function getContextUsageLevel(contextPercent: number, contextWindow: number): ContextUsageLevel;
 /**
- * Format context usage as `<percent>%/<window>` (e.g. `5.1%/1M`), matching the
- * status line's context gauge so subagent and footer renderers stay in sync.
+ * Format context usage as `<percent>%/<window>` when the model window is known.
+ * Unknown windows render as `<tokens>/?`, because `0.0%/0` suggests a real
+ * empty context instead of missing provider metadata.
  */
-export declare function formatContextUsage(contextPercent: number | null | undefined, contextWindow: number): string;
+export declare function formatContextUsage(contextPercent: number | null | undefined, contextWindow: number, usedTokens?: number): string;
 export declare function getContextUsageThemeColor(level: ContextUsageLevel): ThemeColor;

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

@@ -72,6 +72,7 @@ export interface SegmentContext {
     };
     /** Context usage percent, or null when unknown (e.g. right after compaction). */
     contextPercent: number | null;
+    contextTokens: number;
     contextWindow: number;
     autoCompactEnabled: boolean;
     subagentCount: number;

package/dist/types/modes/interactive-mode.d.ts

@@ -110,8 +110,6 @@ export declare class InteractiveMode implements InteractiveModeContext {
     todoPhases: TodoPhase[];
     hideThinkingBlock: boolean;
     proseOnlyThinking: boolean;
-    pendingImages: ImageContent[];
-    pendingImageLinks: (string | undefined)[];
     compactionQueuedMessages: CompactionQueuedMessage[];
     pendingTools: Map<string, ToolExecutionHandle>;
     pendingBashComponents: BashExecutionComponent[];

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

@@ -6,7 +6,7 @@ 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.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "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.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.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" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "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.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.inspectImage" | "tool.goal" | "tool.irc";
+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.goal" | "icon.pause" | "icon.loop" | "icon.folder" | "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.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.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" | "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.task" | "tool.todo" | "tool.memory" | "tool.ask" | "tool.resolve" | "tool.review" | "tool.inspectImage" | "tool.goal" | "tool.irc";
 export type SpinnerType = "status" | "activity";
 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" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";
 /** Check if a string is a valid ThemeColor value */
@@ -241,6 +241,13 @@ export declare class Theme {
      * Maps common language names to their corresponding symbol keys.
      */
     getLangIcon(lang: string | undefined): string;
+    /**
+     * Language icon tinted with the language's brand color (see
+     * {@link LANG_BRAND_COLORS}). Falls back to the muted theme color for
+     * languages without a brand entry, and returns the bare (possibly empty)
+     * icon when the active symbol preset has none.
+     */
+    getLangIconStyled(lang: string | undefined): string;
 }
 export declare function getAvailableThemes(): Promise<string[]>;
 export interface ThemeInfo {

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

@@ -141,8 +141,6 @@ export interface InteractiveModeContext {
     planModePlanFilePath?: string;
     hideThinkingBlock: boolean;
     proseOnlyThinking: boolean;
-    pendingImages: ImageContent[];
-    pendingImageLinks: (string | undefined)[];
     compactionQueuedMessages: CompactionQueuedMessage[];
     pendingTools: Map<string, ToolExecutionHandle>;
     pendingBashComponents: BashExecutionComponent[];

package/dist/types/modes/utils/copy-targets.d.ts

@@ -21,7 +21,7 @@ export type MessageBlock = ({
 export interface LastCommand {
     kind: "bash" | "eval";
     code: string;
-    /** Highlight language: "bash" for bash, "python"/"javascript" for eval. */
+    /** Highlight language: "bash" for bash, or the resolved eval language ("python"/"javascript"/"ruby"/"julia"). */
     language: string;
 }
 /**

package/dist/types/modes/utils/interactive-context-helpers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Small helpers over {@link InteractiveModeContext} shared between
+ * {@link UiHelpers} and the input/event controllers, so the live chat surfaces
+ * construct components and reset editor state identically.
+ */
+import type { AssistantMessage } from "@oh-my-pi/pi-ai";
+import { AssistantMessageComponent } from "../components/assistant-message";
+import type { InteractiveModeContext } from "../types";
+/**
+ * Construct an {@link AssistantMessageComponent} wired to the live context's
+ * thinking/image settings. `message` is omitted for the streaming placeholder
+ * component and supplied when rendering a persisted turn.
+ */
+export declare function createAssistantMessageComponent(ctx: InteractiveModeContext, message?: AssistantMessage): AssistantMessageComponent;

package/dist/types/modes/utils/transcript-render-helpers.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Render helpers shared between the live transcript ({@link UiHelpers}) and the
+ * file/remote-backed {@link ChatTranscriptBuilder}. Both surfaces build the same
+ * transcript rows from persisted message entries; holding the row construction
+ * here keeps the two byte-for-byte identical.
+ */
+import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
+import { type Component } from "@oh-my-pi/pi-tui";
+import { type FileMentionMessage } from "../../session/messages";
+import { TranscriptBlock } from "../components/transcript-container";
+type CustomOrHookMessage = Extract<AgentMessage, {
+    role: "custom" | "hookMessage";
+}>;
+type AssistantAgentMessage = Extract<AgentMessage, {
+    role: "assistant";
+}>;
+/**
+ * Render an `async-result` custom message (a completed background bash/task job,
+ * or a batch of them) as a transcript block of one "Background job completed"
+ * row per job.
+ */
+export declare function buildAsyncResultBlock(message: CustomOrHookMessage): TranscriptBlock;
+/**
+ * Render a live IRC traffic custom message (`irc:incoming` / `irc:autoreply` /
+ * `irc:relay`) as a transcript card. `getExpanded` supplies the live
+ * expanded-state getter for the cached card.
+ */
+export declare function buildIrcMessageCard(message: CustomOrHookMessage, getExpanded: () => boolean): Component;
+/**
+ * Render a `fileMention` message's files as a transcript block of "Read <path>"
+ * rows. `indent` sets the left pad: the live chat renders within an outer gutter
+ * (0), the transcript viewer renders body rows without one so rows own their pad
+ * (1).
+ */
+export declare function buildFileMentionBlock(files: FileMentionMessage["files"], indent: number): TranscriptBlock;
+/**
+ * Whether an assistant turn has visible text or thinking content (after
+ * canonicalization) — i.e. content that closes the current read-tool run.
+ */
+export declare function assistantHasVisibleContent(message: AssistantAgentMessage): boolean;
+/**
+ * Normalize raw tool-call arguments to a plain record, collapsing non-object or
+ * array values to an empty object.
+ */
+export declare function normalizeToolArgs(args: unknown): Record<string, unknown>;
+/**
+ * Resolve the inline error label, if any, for a turn-ending assistant message.
+ * Silent aborts yield no label. `retryAttempt` tunes the abort label wording.
+ */
+export declare function resolveAssistantErrorMessage(message: AssistantAgentMessage, retryAttempt?: number): {
+    hasErrorStop: boolean;
+    errorMessage: string | null;
+};
+export {};

package/dist/types/sdk.d.ts

@@ -128,7 +128,7 @@ export interface CreateAgentSessionOptions {
     mcpManager?: MCPManager;
     /** Enable LSP integration (tool, formatting, diagnostics, warmup). Default: true */
     enableLsp?: boolean;
-    /** Skip Python kernel availability check and prelude warmup */
+    /** Skip subprocess-kernel availability checks and prelude warmup */
     skipPythonPreflight?: boolean;
     /** Tool names explicitly requested (enables disabled-by-default tools) */
     toolNames?: string[];