@oh-my-pi/pi-coding-agent 15.7.5 → 15.8.0

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

@@ -34,6 +34,14 @@ export declare class ToolExecutionComponent extends Container {
      * This triggers an immediate final diff computation for edit-like tools.
      */
     setArgsComplete(_toolCallId?: string): void;
+    /**
+     * Await the streaming diff recompute kicked off by the most recent
+     * `updateArgs`/`setArgsComplete`. The recompute reads the file and re-runs the
+     * whole-file Myers diff off the render path, signalling completion only via a
+     * throttled `requestRender`. Tests await this to sample a *settled* preview
+     * deterministically instead of racing the spinner's render ticks.
+     */
+    whenPreviewSettled(): Promise<void>;
     updateResult(result: {
         content: Array<{
             type: string;

package/dist/types/modes/controllers/extension-ui-controller.d.ts

@@ -1,9 +1,9 @@
 import type { Component, TUI } from "@oh-my-pi/pi-tui";
 import { KeybindingsManager } from "../../config/keybindings";
-import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionWidgetContent, ExtensionWidgetOptions, TerminalInputHandler } from "../../extensibility/extensions";
+import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions, TerminalInputHandler } from "../../extensibility/extensions";
 import { type HookSelectorSlider } from "../../modes/components/hook-selector";
 import { type Theme } from "../../modes/theme/theme";
-import type { InteractiveModeContext } from "../../modes/types";
+import type { InteractiveModeContext, InteractiveSelectorDialogOptions } from "../../modes/types";
 export declare class ExtensionUiController {
     #private;
     private ctx;
@@ -30,7 +30,7 @@ export declare class ExtensionUiController {
     /**
      * Show a selector for hooks.
      */
-    showHookSelector(title: string, options: string[], dialogOptions?: ExtensionUIDialogOptions, extra?: {
+    showHookSelector(title: string, options: ExtensionUISelectItem[], dialogOptions?: InteractiveSelectorDialogOptions, extra?: {
         slider?: HookSelectorSlider;
     }): Promise<string | undefined>;
     /**

package/dist/types/modes/controllers/input-controller.d.ts

@@ -18,6 +18,7 @@ export declare class InputController {
     }): number;
     handleBackgroundCommand(): void;
     handleImagePaste(): Promise<boolean>;
+    handleClipboardTextRawPaste(): Promise<void>;
     createAutocompleteProvider(commands: SlashCommand[], basePath: string): AutocompleteProvider;
     /** Copy the current editor line to the system clipboard. */
     handleCopyCurrentLine(): void;

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

@@ -5,7 +5,7 @@ import type { Component, EditorTheme } from "@oh-my-pi/pi-tui";
 import { Container, Loader, Spacer, Text, TUI } from "@oh-my-pi/pi-tui";
 import { KeybindingsManager } from "../config/keybindings";
 import { Settings } from "../config/settings";
-import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
+import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
 import type { CompactOptions } from "../extensibility/extensions/types";
 import { type PlanApprovalDetails } from "../plan-mode/approved-plan";
 import type { AgentSession, AgentSessionEvent } from "../session/agent-session";
@@ -26,7 +26,7 @@ import type { ToolExecutionHandle } from "./components/tool-execution";
 import { type LoopLimitRuntime } from "./loop-limit";
 import { OAuthManualInputManager } from "./oauth-manual-input";
 import type { Theme } from "./theme/theme";
-import type { CompactionQueuedMessage, InteractiveModeContext, InteractiveModeInitOptions, SubmittedUserInput, TodoItem, TodoPhase } from "./types";
+import type { CompactionQueuedMessage, InteractiveModeContext, InteractiveModeInitOptions, InteractiveSelectorDialogOptions, SubmittedUserInput, TodoItem, TodoPhase } from "./types";
 /** Options for creating an InteractiveMode instance (for future API use) */
 export interface InteractiveModeOptions {
     /** Providers that were migrated during startup */
@@ -112,6 +112,13 @@ export declare class InteractiveMode implements InteractiveModeContext {
     init(options?: InteractiveModeInitOptions): Promise<void>;
     /** Reload slash commands and autocomplete for the provided working directory. */
     refreshSlashCommandState(cwd?: string): Promise<void>;
+    /**
+     * Re-point the process and every cwd-derived cache at `newCwd` after the
+     * active session's working directory changed (`/move` relocation or resuming
+     * a session from another project). The SessionManager's cwd MUST already
+     * reflect `newCwd` before this is called.
+     */
+    applyCwdChange(newCwd: string): Promise<void>;
     getUserInput(): Promise<SubmittedUserInput>;
     disableLoopMode(message?: string): void;
     /**
@@ -253,7 +260,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     emitCustomToolSessionEvent(reason: "start" | "switch" | "branch" | "tree" | "shutdown", previousSessionFile?: string): Promise<void>;
     setHookWidget(key: string, content: ExtensionWidgetContent, options?: ExtensionWidgetOptions): void;
     setHookStatus(key: string, text: string | undefined): void;
-    showHookSelector(title: string, options: string[], dialogOptions?: ExtensionUIDialogOptions, extra?: {
+    showHookSelector(title: string, options: ExtensionUISelectItem[], dialogOptions?: InteractiveSelectorDialogOptions, extra?: {
         slider?: HookSelectorSlider;
     }): Promise<string | undefined>;
     hideHookSelector(): void;

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

@@ -1,4 +1,4 @@
-import type { ExtensionUIContext, ExtensionUIDialogOptions } from "../../extensibility/extensions";
+import { type ExtensionUIContext, type ExtensionUIDialogOptions } from "../../extensibility/extensions";
 import type { AgentSession } from "../../session/agent-session";
 import type { RpcExtensionUIRequest, RpcExtensionUIResponse, RpcHostToolCallRequest, RpcHostToolCancelRequest, RpcHostUriCancelRequest, RpcHostUriRequest, RpcResponse } from "./rpc-types";
 export type * from "./rpc-types";

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

@@ -17,7 +17,7 @@ export declare class Theme {
     #private;
     private readonly mode;
     private readonly symbolPreset;
-    constructor(fgColors: Record<ThemeColor, string | number>, bgColors: Record<ThemeBg, string | number>, mode: ColorMode, symbolPreset: SymbolPreset, symbolOverrides: Partial<Record<SymbolKey, string>>);
+    constructor(fgColors: Record<ThemeColor, string | number>, bgColors: Record<ThemeBg, string | number>, mode: ColorMode, symbolPreset: SymbolPreset, symbolOverrides: Partial<Record<SymbolKey, string>>, spinnerFramesOverrides?: Partial<Record<SpinnerType, string[]>>);
     fg(color: ThemeColor, text: string): string;
     bg(color: ThemeBg, text: string): string;
     bold(text: string): string;

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

@@ -4,7 +4,7 @@ import type { AssistantMessage, ImageContent, Message, UsageReport } from "@oh-m
 import type { Component, Container, EditorTheme, Loader, Spacer, Text, TUI } from "@oh-my-pi/pi-tui";
 import type { KeybindingsManager } from "../config/keybindings";
 import type { Settings } from "../config/settings";
-import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
+import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
 import type { CompactOptions } from "../extensibility/extensions/types";
 import type { MCPManager } from "../mcp";
 import type { PlanApprovalDetails } from "../plan-mode/approved-plan";
@@ -19,7 +19,7 @@ import type { CustomEditor } from "./components/custom-editor";
 import type { EvalExecutionComponent } from "./components/eval-execution";
 import type { HookEditorComponent } from "./components/hook-editor";
 import type { HookInputComponent } from "./components/hook-input";
-import type { HookSelectorComponent } from "./components/hook-selector";
+import type { HookSelectorComponent, HookSelectorOptions } from "./components/hook-selector";
 import type { StatusLineComponent } from "./components/status-line";
 import type { ToolExecutionHandle } from "./components/tool-execution";
 import type { LoopLimitRuntime } from "./loop-limit";
@@ -51,6 +51,7 @@ export type TodoPhase = {
 export interface InteractiveModeInitOptions {
     suppressWelcomeIntro?: boolean;
 }
+export type InteractiveSelectorDialogOptions = ExtensionUIDialogOptions & Pick<HookSelectorOptions, "disabledIndices">;
 export interface InteractiveModeContext {
     ui: TUI;
     chatContainer: Container;
@@ -217,6 +218,7 @@ export interface InteractiveModeContext {
     executeCompaction(customInstructionsOrOptions?: string | CompactOptions, isAuto?: boolean): Promise<CompactionOutcome>;
     openInBrowser(urlOrPath: string): void;
     refreshSlashCommandState(cwd?: string): Promise<void>;
+    applyCwdChange(newCwd: string): Promise<void>;
     showSettingsSelector(): void;
     showHistorySearch(): void;
     showExtensionsDashboard(): void;
@@ -264,7 +266,7 @@ export interface InteractiveModeContext {
     emitCustomToolSessionEvent(reason: "start" | "switch" | "branch" | "tree" | "shutdown", previousSessionFile?: string): Promise<void>;
     setHookWidget(key: string, content: ExtensionWidgetContent, options?: ExtensionWidgetOptions): void;
     setHookStatus(key: string, text: string | undefined): void;
-    showHookSelector(title: string, options: string[], dialogOptions?: ExtensionUIDialogOptions): Promise<string | undefined>;
+    showHookSelector(title: string, options: ExtensionUISelectItem[], dialogOptions?: InteractiveSelectorDialogOptions): Promise<string | undefined>;
     hideHookSelector(): void;
     showHookInput(title: string, placeholder?: string): Promise<string | undefined>;
     hideHookInput(): void;

package/dist/types/registry/agent-registry.d.ts

@@ -6,7 +6,7 @@
  * creation and removed when the owner releases them.
  */
 import type { AgentSession } from "../session/agent-session";
-export declare const MAIN_AGENT_ID = "0-Main";
+export declare const MAIN_AGENT_ID = "Main";
 export type AgentStatus = "running" | "idle" | "completed" | "aborted";
 export type AgentKind = "main" | "sub";
 export interface AgentRef {

package/dist/types/sdk.d.ts

@@ -101,13 +101,13 @@ export interface CreateAgentSessionOptions {
     parentHindsightSessionState?: HindsightSessionState;
     /** Parent Mnemopi state to alias for subagent memory tools. */
     parentMnemopiSessionState?: MnemopiSessionState;
-    /** Pre-allocated agent identity for IRC routing. Default: "0-Main" for top-level, parentTaskPrefix-derived for sub. */
+    /** Pre-allocated agent identity for IRC routing. Default: "Main" for top-level, parentTaskPrefix-derived for sub. */
     agentId?: string;
     /** Display name for the agent in IRC. Default: "main" or "sub". */
     agentDisplayName?: string;
     /** Optional shared agent registry for IRC routing. Default: AgentRegistry.global(). */
     agentRegistry?: AgentRegistry;
-    /** Parent task ID prefix for nested artifact naming (e.g., "6-Extensions") */
+    /** Parent task ID prefix for nested artifact naming (e.g., "Extensions") */
     parentTaskPrefix?: string;
     /** Inherited eval executor session id for subagents sharing parent eval state. */
     parentEvalSessionId?: string;

package/dist/types/session/agent-session.d.ts

@@ -201,7 +201,7 @@ export interface AgentSessionConfig {
      * **MUST NOT** dispose it on their own teardown.
      */
     ownedAsyncJobManager?: AsyncJobManager;
-    /** Agent identity (registry id like "0-Main" or "3-Alice") used for IRC routing. */
+    /** Agent identity (registry id like "Main" or "Alice") used for IRC routing. */
     agentId?: string;
     /** Shared agent registry (for forwarding IRC observations to the main session UI). */
     agentRegistry?: AgentRegistry;
@@ -438,8 +438,15 @@ export declare class AgentSession {
     /**
      * Replace MCP tools in the registry and recompute the visible MCP tool set immediately.
      * This allows /mcp add/remove/reauth to take effect without restarting the session.
+     *
+     * @param mcpTools The new MCP tools to register.
+     * @param options.activateAll When true, force-activates every newly registered MCP tool
+     *   regardless of prior selection state. Used when an ACP client provisions MCP servers
+     *   for a session where MCP discovery is disabled.
      */
-    refreshMCPTools(mcpTools: CustomTool[]): Promise<void>;
+    refreshMCPTools(mcpTools: CustomTool[], options?: {
+        activateAll?: boolean;
+    }): Promise<void>;
     /**
      * Replace RPC host-owned tools and refresh the active tool set before the next model call.
      */
@@ -966,7 +973,9 @@ export declare class AgentSession {
      * Uses the last assistant message's usage data when available,
      * otherwise estimates tokens for all messages.
      */
-    getContextUsage(): ContextUsage | undefined;
+    getContextUsage(options?: {
+        contextWindow?: number;
+    }): ContextUsage | undefined;
     fetchUsageReports(signal?: AbortSignal): Promise<UsageReport[] | null>;
     /**
      * Export session to HTML.

package/dist/types/session/history-storage.d.ts

@@ -3,6 +3,8 @@ export interface HistoryEntry {
     prompt: string;
     created_at: number;
     cwd?: string;
+    /** ID of the session the prompt was submitted from, if known. */
+    sessionId?: string;
 }
 export declare class HistoryStorage {
     #private;
@@ -10,7 +12,20 @@ export declare class HistoryStorage {
     static open(dbPath?: string): HistoryStorage;
     /** @internal Reset the singleton — test-only. */
     static resetInstance(): void;
-    add(prompt: string, cwd?: string): Promise<void>;
+    /**
+     * Register a resolver that supplies the current session ID for prompts added
+     * without an explicit `sessionId`. Evaluated synchronously at `add()` time so
+     * batched writes capture the session active when the prompt was submitted.
+     */
+    setSessionResolver(resolver: () => string | undefined): void;
+    add(prompt: string, cwd?: string, sessionId?: string): Promise<void>;
     getRecent(limit: number): HistoryEntry[];
     search(query: string, limit: number): HistoryEntry[];
+    /**
+     * IDs of the sessions whose stored prompts match `query`, ordered by match
+     * relevance (most relevant/recent first) and de-duplicated. Prompts with no
+     * recorded session are skipped. Used to augment session ranking in the
+     * resume picker with prompts that the 4KB session-list prefix never sees.
+     */
+    matchingSessionIds(query: string, limit?: number): string[];
 }

package/dist/types/session/session-manager.d.ts

@@ -169,6 +169,8 @@ export interface SessionContext {
     /** Mode-specific data from the last mode_change entry */
     modeData?: Record<string, unknown>;
 }
+/** Lists session model strings to try when restoring, in fallback order. */
+export declare function getRestorableSessionModels(models: Readonly<Record<string, string>>, lastModelChangeRole: string | undefined): string[];
 export interface SessionInfo {
     path: string;
     id: string;
@@ -253,6 +255,8 @@ export interface ResolvedSessionMatch {
 }
 export declare function resolveResumableSession(sessionArg: string, cwd: string, sessionDir?: string, storage?: SessionStorage): Promise<ResolvedSessionMatch | undefined>;
 interface SessionManagerStateSnapshot {
+    cwd: string;
+    sessionDir: string;
     sessionId: string;
     sessionName: string | undefined;
     titleSource: "auto" | "user" | undefined;

package/dist/types/task/output-manager.d.ts

@@ -1,10 +1,9 @@
 /**
  * Manages agent output ID allocation to ensure uniqueness.
  *
- * Each allocated ID gets a numeric prefix based on allocation order.
- * If configured with a parent prefix, the numeric prefix is appended after
- * the parent (e.g., "0-Parent.0-Child").
- * On resume, scans existing files to find the next available index.
+ * The first allocation of a given name keeps the name as-is; subsequent
+ * allocations of the same name get a `-2`, `-3`, … suffix. On resume, scans
+ * existing output files so previously written outputs are never overwritten.
  */
 export declare class AgentOutputManager {
     #private;
@@ -12,10 +11,10 @@ export declare class AgentOutputManager {
         parentPrefix?: string;
     });
     /**
-     * Allocate a unique ID with numeric prefix.
+     * Allocate a unique ID.
      *
-     * @param id Requested ID (e.g., "AuthProvider")
-     * @returns Unique ID with prefix (e.g., "0-AuthProvider")
+     * @param id Requested ID (e.g., "Anna")
+     * @returns Unique ID ("Anna" first, then "Anna-2", "Anna-3", …)
      */
     allocate(id: string): Promise<string>;
     /**
@@ -25,12 +24,4 @@ export declare class AgentOutputManager {
      * @returns Array of unique IDs in same order
      */
     allocateBatch(ids: string[]): Promise<string[]>;
-    /**
-     * Get the next ID that would be allocated (without allocating).
-     */
-    peekNextIndex(): Promise<number>;
-    /**
-     * Reset state (primarily for testing).
-     */
-    reset(): void;
 }

package/dist/types/tools/ask.d.ts

@@ -26,6 +26,7 @@ declare const askSchema: z.ZodObject<{
         question: z.ZodString;
         options: z.ZodArray<z.ZodObject<{
             label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         multi: z.ZodOptional<z.ZodBoolean>;
         recommended: z.ZodOptional<z.ZodNumber>;
@@ -71,6 +72,7 @@ export declare class AskTool implements AgentTool<typeof askSchema, AskToolDetai
             question: z.ZodString;
             options: z.ZodArray<z.ZodObject<{
                 label: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             multi: z.ZodOptional<z.ZodBoolean>;
             recommended: z.ZodOptional<z.ZodNumber>;
@@ -82,18 +84,18 @@ export declare class AskTool implements AgentTool<typeof askSchema, AskToolDetai
     static createIf(session: ToolSession): AskTool | null;
     execute(_toolCallId: string, params: AskParams, signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<AskToolDetails>, context?: AgentToolContext): Promise<AgentToolResult<AskToolDetails>>;
 }
+interface AskRenderOption {
+    label: string;
+    description?: string;
+}
 interface AskRenderArgs {
     question?: string;
-    options?: Array<{
-        label: string;
-    }>;
+    options?: AskRenderOption[];
     multi?: boolean;
     questions?: Array<{
         id: string;
         question: string;
-        options: Array<{
-            label: string;
-        }>;
+        options: AskRenderOption[];
         multi?: boolean;
     }>;
 }

package/dist/types/tools/eval-backends.d.ts

@@ -0,0 +1,12 @@
+import type { ToolSession } from ".";
+export interface EvalBackendsAllowance {
+    python: boolean;
+    js: boolean;
+}
+/** Read per-backend allowance from settings (defaults true). */
+export declare function readEvalBackendsAllowance(session: ToolSession): EvalBackendsAllowance;
+/**
+ * Materialize the active eval backend allowance: PI_PY / PI_JS env flags
+ * override the per-key settings; otherwise settings (defaults true) win.
+ */
+export declare function resolveEvalBackends(session: ToolSession): EvalBackendsAllowance;

package/dist/types/tools/eval-render.d.ts

@@ -0,0 +1,52 @@
+/**
+ * TUI rendering for the eval tool.
+ *
+ * Split out from `eval.ts` so the renderer can be imported by `renderers.ts`
+ * without dragging the eval *runtime* (JS/Python backends -> agent bridge ->
+ * task executor -> sdk -> extension loader -> root barrel) into the renderer
+ * module graph. That transitive chain re-enters `renderers.ts` while `eval.ts`
+ * is still initializing, which previously crashed module load with a TDZ
+ * `Cannot access 'evalToolRenderer' before initialization`.
+ */
+import type { Component } from "@oh-my-pi/pi-tui";
+import type { EvalStatusEvent, EvalToolDetails } from "../eval/types";
+import type { RenderResultOptions } from "../extensibility/custom-tools/types";
+import { type Theme } from "../modes/theme/theme";
+export declare const EVAL_DEFAULT_PREVIEW_LINES = 10;
+interface EvalRenderCellArg {
+    language?: string;
+    code?: string;
+    title?: string;
+}
+interface EvalRenderArgs {
+    cells?: EvalRenderCellArg[];
+    __partialJson?: string;
+}
+interface EvalRenderContext {
+    output?: string;
+    expanded?: boolean;
+    previewLines?: number;
+    timeout?: number;
+}
+/**
+ * Append or replace a status event. `agent` events are progress snapshots keyed
+ * by `id`, so they coalesce in place (preserving first-seen order); every other
+ * op is a discrete action and simply appends. Keeps the persisted event list
+ * bounded even when a subagent emits hundreds of throttled progress ticks.
+ */
+export declare function upsertStatusEvent(events: EvalStatusEvent[], event: EvalStatusEvent): void;
+export declare const evalToolRenderer: {
+    renderCall(args: EvalRenderArgs, options: RenderResultOptions, uiTheme: Theme): Component;
+    renderResult(result: {
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+        details?: EvalToolDetails;
+    }, options: RenderResultOptions & {
+        renderContext?: EvalRenderContext;
+    }, uiTheme: Theme, _args?: EvalRenderArgs): Component;
+    mergeCallAndResult: boolean;
+    inline: boolean;
+};
+export {};

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

@@ -1,11 +1,8 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
-import type { Component } from "@oh-my-pi/pi-tui";
 import * as z from "zod/v4";
 import type { EvalToolDetails } from "../eval/types";
-import type { RenderResultOptions } from "../extensibility/custom-tools/types";
-import { type Theme } from "../modes/theme/theme";
-import { type ToolSession } from ".";
-export declare const EVAL_DEFAULT_PREVIEW_LINES = 10;
+import type { ToolSession } from ".";
+export { EVAL_DEFAULT_PREVIEW_LINES, evalToolRenderer } from "./eval-render";
 /**
  * Per-cell input. Each cell runs in order; state persists within a language
  * across cells and across tool calls.
@@ -78,33 +75,3 @@ export declare class EvalTool implements AgentTool<typeof evalSchema> {
     constructor(session: ToolSession | null, options?: EvalToolOptions);
     execute(_toolCallId: string, params: z.infer<typeof evalSchema>, signal?: AbortSignal, onUpdate?: AgentToolUpdateCallback, _ctx?: AgentToolContext): Promise<AgentToolResult<EvalToolDetails | undefined>>;
 }
-interface EvalRenderCellArg {
-    language?: string;
-    code?: string;
-    title?: string;
-}
-interface EvalRenderArgs {
-    cells?: EvalRenderCellArg[];
-    __partialJson?: string;
-}
-interface EvalRenderContext {
-    output?: string;
-    expanded?: boolean;
-    previewLines?: number;
-    timeout?: number;
-}
-export declare const evalToolRenderer: {
-    renderCall(args: EvalRenderArgs, options: RenderResultOptions, uiTheme: Theme): Component;
-    renderResult(result: {
-        content: Array<{
-            type: string;
-            text?: string;
-        }>;
-        details?: EvalToolDetails;
-    }, options: RenderResultOptions & {
-        renderContext?: EvalRenderContext;
-    }, uiTheme: Theme, _args?: EvalRenderArgs): Component;
-    mergeCallAndResult: boolean;
-    inline: boolean;
-};
-export {};

package/dist/types/tools/find.d.ts

@@ -14,15 +14,6 @@ declare const findSchema: z.ZodObject<{
     timeout: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
 }, z.core.$strict>;
 export type FindToolInput = z.infer<typeof findSchema>;
-/**
- * Reject comma-separated path lists packed into a single array element
- * (`["a.py,b.py"]`). The schema is array-of-string; agents that pass a
- * single comma-joined element get silent no-matches otherwise.
- *
- * Commas inside brace expansion (`{a,b}`) are legitimate glob syntax and
- * must pass through.
- */
-export declare function validateFindPathInputs(paths: readonly string[]): void;
 /**
  * Group find matches by their directory so the model doesn't pay repeated
  * tokens for shared path prefixes. Preserves the input order: groups appear in

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

@@ -37,6 +37,7 @@ export * from "./browser";
 export * from "./checkpoint";
 export * from "./debug";
 export * from "./eval";
+export * from "./eval-backends";
 export * from "./find";
 export * from "./gh";
 export * from "./image-gen";
@@ -111,7 +112,7 @@ export interface ToolSession {
     getHindsightSessionState?: () => HindsightSessionState | undefined;
     /** Get Mnemopi runtime state for this agent session. */
     getMnemopiSessionState?: () => MnemopiSessionState | undefined;
-    /** Agent identity used for IRC routing. Returns the registry id (e.g. "0-Main", "0-AuthLoader"). */
+    /** Agent identity used for IRC routing. Returns the registry id (e.g. "Main", "AuthLoader"). */
     getAgentId?: () => string | null;
     /** Look up a registered tool by name (used by the eval js backend's tool bridge). */
     getToolByName?: (name: string) => AgentTool | undefined;
@@ -218,6 +219,9 @@ export interface ToolSession {
      *  to splice the recorded region with replacement content. Lazily initialized
      *  by `getConflictHistory`. */
     conflictHistory?: import("./conflict-detect").ConflictHistory;
+    /** Per-session ledger of post-edit LSP diagnostics already surfaced to the
+     *  model for each file. Lazily initialized by `getDiagnosticsLedger`. */
+    diagnosticsLedger?: import("../lsp/diagnostics-ledger").DiagnosticsLedger;
     /** Queue a hidden message to be injected at the next agent turn. */
     queueDeferredMessage?(message: CustomMessage): void;
     /** Get the active OpenTelemetry config so subagent dispatch can forward
@@ -241,17 +245,6 @@ export declare function computeEssentialBuiltinNames(settings: Settings): string
 export declare const BUILTIN_TOOLS: Record<string, ToolFactory>;
 export declare const HIDDEN_TOOLS: Record<string, ToolFactory>;
 export type ToolName = keyof typeof BUILTIN_TOOLS;
-export interface EvalBackendsAllowance {
-    python: boolean;
-    js: boolean;
-}
-/** Read per-backend allowance from settings (defaults true). */
-export declare function readEvalBackendsAllowance(session: ToolSession): EvalBackendsAllowance;
-/**
- * Materialize the active eval backend allowance: PI_PY / PI_JS env flags
- * override the per-key settings; otherwise settings (defaults true) win.
- */
-export declare function resolveEvalBackends(session: ToolSession): EvalBackendsAllowance;
 /**
  * Create tools from BUILTIN_TOOLS registry.
  */

package/dist/types/tools/path-utils.d.ts

@@ -69,6 +69,21 @@ export declare function formatPathRelativeToCwd(filePath: string, cwd: string, o
 export declare function stripOuterDoubleQuotes(input: string): string;
 export declare function normalizePathLikeInput(input: string): string;
 export declare function hasGlobPathChars(filePath: string): boolean;
+type PathEntrySplitter = (item: string) => {
+    basePath: string;
+};
+/**
+ * Split one path-like entry whose multiple targets were flattened into one
+ * string. Existing paths are kept intact, so real filenames containing spaces,
+ * commas, or semicolons win over delimiter recovery.
+ */
+export declare function splitDelimitedPathEntry(entry: string, cwd: string, options?: {
+    splitter?: PathEntrySplitter;
+}): Promise<string[] | null>;
+/** Expand delimited entries in-place while preserving unsplit entries. */
+export declare function expandDelimitedPathEntries(entries: readonly string[], cwd: string, options?: {
+    splitter?: PathEntrySplitter;
+}): Promise<string[]>;
 export interface ParsedSearchPath {
     basePath: string;
     glob?: string;
@@ -170,3 +185,4 @@ export interface ToolScopeResolution {
  *  5. stat the resolved base path so callers can branch on directory vs file scope.
  */
 export declare function resolveToolSearchScope(opts: ToolScopeOptions): Promise<ToolScopeResolution>;
+export {};

package/dist/types/tools/sqlite-reader.d.ts

@@ -32,13 +32,33 @@ export type SqliteRowLookup = {
 } | {
     kind: "rowid";
 };
+/**
+ * Row count for a table in the listing.
+ * - `exact`: counted in full (the table is small enough to count cheaply).
+ * - `estimate`: the planner's `sqlite_stat1` figure; the table is too large to
+ *   scan, so this may be stale.
+ * - `atLeast`: a lower bound; counting was capped before reaching the end.
+ */
+export type TableRowCount = {
+    kind: "exact";
+    rows: number;
+} | {
+    kind: "estimate";
+    rows: number;
+} | {
+    kind: "atLeast";
+    rows: number;
+};
+export interface SqliteTableSummary {
+    name: string;
+    count: TableRowCount;
+}
 export declare function parseSqlitePathCandidates(filePath: string): SqlitePathCandidate[];
 export declare function isSqliteFile(absolutePath: string): Promise<boolean>;
 export declare function parseSqliteSelector(subPath: string, queryString: string): SqliteSelector;
-export declare function listTables(db: Database): {
-    name: string;
-    rowCount: number;
-}[];
+export declare function listTables(db: Database, options?: {
+    probeCap?: number;
+}): SqliteTableSummary[];
 export declare function getTableSchema(db: Database, table: string): string;
 export declare function getTablePrimaryKey(db: Database, table: string): {
     column: string;
@@ -75,10 +95,7 @@ export declare function deleteRowByKey(db: Database, table: string, pk: {
     type?: string;
 }, key: string): number;
 export declare function deleteRowByRowId(db: Database, table: string, key: string): number;
-export declare function renderTableList(tables: {
-    name: string;
-    rowCount: number;
-}[]): string;
+export declare function renderTableList(tables: SqliteTableSummary[]): string;
 export declare function renderSchema(createSql: string, sampleRows: {
     columns: string[];
     rows: Record<string, unknown>[];

package/dist/types/tui/output-block.d.ts

@@ -14,9 +14,10 @@ export interface OutputBlockOptions {
     animate?: boolean;
 }
 /**
- * Monotonic frame counter for animated borders. Quantized coarse enough to
- * coalesce multiple render passes inside one frame, fine enough to advance on
- * every spinner interval so cached blocks re-render while the segment travels.
+ * Monotonic frame counter for animated borders, quantized to the TUI's ~16ms
+ * render cap so the cache key advances once per ~60fps frame — fine enough for a
+ * smooth segment sweep, coarse enough to coalesce multiple render passes that
+ * land inside the same frame.
  */
 export declare function borderShimmerTick(): number;
 /**

package/dist/types/utils/clipboard.d.ts

@@ -20,3 +20,7 @@ export declare function copyToClipboard(text: string): Promise<void>;
  * @returns PNG payload or null when no image is available.
  */
 export declare function readImageFromClipboard(): Promise<ClipboardImage | null>;
+/**
+ * Read plain text from the system clipboard.
+ */
+export declare function readTextFromClipboard(): Promise<string>;