@oh-my-pi/pi-coding-agent 15.13.1 → 15.13.3

package/dist/types/config/model-registry.d.ts

@@ -248,6 +248,7 @@ export interface ProviderConfigInput {
         reasoning: boolean;
         thinking?: ThinkingConfig;
         input: ("text" | "image")[];
+        supportsTools?: boolean;
         cost: {
             input: number;
             output: number;

package/dist/types/config/models-config-schema.d.ts

@@ -215,6 +215,7 @@ export declare const ModelOverrideSchema: z.ZodObject<{
         image: "image";
         text: "text";
     }>>>;
+    supportsTools: z.ZodOptional<z.ZodBoolean>;
     cost: z.ZodOptional<z.ZodObject<{
         input: z.ZodOptional<z.ZodNumber>;
         output: z.ZodOptional<z.ZodNumber>;
@@ -633,6 +634,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 image: "image";
                 text: "text";
             }>>>;
+            supportsTools: z.ZodOptional<z.ZodBoolean>;
             cost: z.ZodOptional<z.ZodObject<{
                 input: z.ZodNumber;
                 output: z.ZodNumber;
@@ -862,6 +864,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 image: "image";
                 text: "text";
             }>>>;
+            supportsTools: z.ZodOptional<z.ZodBoolean>;
             cost: z.ZodOptional<z.ZodObject<{
                 input: z.ZodOptional<z.ZodNumber>;
                 output: z.ZodOptional<z.ZodNumber>;

package/dist/types/config/models-config.d.ts

@@ -9,6 +9,7 @@ export interface ProviderValidationModel {
     id: string;
     api?: Api;
     contextWindow?: number;
+    supportsTools?: boolean;
     maxTokens?: number;
 }
 export interface ProviderValidationConfig {
@@ -150,6 +151,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                 supportsDisplay?: boolean | undefined;
             } | undefined;
             input?: ("image" | "text")[] | undefined;
+            supportsTools?: boolean | undefined;
             cost?: {
                 input: number;
                 output: number;
@@ -274,6 +276,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                 supportsDisplay?: boolean | undefined;
             } | undefined;
             input?: ("image" | "text")[] | undefined;
+            supportsTools?: boolean | undefined;
             cost?: {
                 input?: number | undefined;
                 output?: number | undefined;

package/dist/types/config/settings-schema.d.ts

@@ -1841,6 +1841,62 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Experimental: render large historical tool results as dense PNG image(s) instead of text (vision models only). Saves tokens on accumulated read/search output.";
         };
     };
+    readonly "tools.format": {
+        readonly type: "enum";
+        readonly values: readonly ["auto", "native", "glm", "hermes", "kimi", "xml", "anthropic", "deepseek", "harmony", "pi", "qwen3"];
+        readonly default: "auto";
+        readonly ui: {
+            readonly tab: "context";
+            readonly group: "Experimental";
+            readonly label: "Tool Call Format";
+            readonly description: "Controls how tools are exposed to the model. Auto uses native tool calls unless the selected model is marked as not supporting tools, then falls back to GLM-style in-band tool calls. Native forces provider-native tools; the other values force the named in-band syntax. Applies on session start.";
+            readonly options: readonly [{
+                readonly value: "auto";
+                readonly label: "Auto";
+                readonly description: "Use native tool calls unless the model is known not to support them.";
+            }, {
+                readonly value: "native";
+                readonly label: "Native";
+                readonly description: "Use provider-native tool calls.";
+            }, {
+                readonly value: "glm";
+                readonly label: "GLM";
+                readonly description: "Use GLM-style in-band tool calls.";
+            }, {
+                readonly value: "hermes";
+                readonly label: "Hermes";
+                readonly description: "Use Hermes-style in-band tool calls.";
+            }, {
+                readonly value: "kimi";
+                readonly label: "Kimi";
+                readonly description: "Use Kimi-style in-band tool calls.";
+            }, {
+                readonly value: "xml";
+                readonly label: "XML";
+                readonly description: "Use generic XML in-band tool calls.";
+            }, {
+                readonly value: "anthropic";
+                readonly label: "Anthropic";
+                readonly description: "Use Anthropic-style in-band tool calls.";
+            }, {
+                readonly value: "deepseek";
+                readonly label: "DeepSeek";
+                readonly description: "Use DeepSeek-style in-band tool calls.";
+            }, {
+                readonly value: "harmony";
+                readonly label: "Harmony";
+                readonly description: "Use Harmony-style in-band tool calls.";
+            }, {
+                readonly value: "pi";
+                readonly label: "Pi";
+                readonly description: "Use Pi-style in-band tool calls.";
+            }, {
+                readonly value: "qwen3";
+                readonly label: "Qwen3";
+                readonly description: "Use Qwen3-style in-band tool calls.";
+            }];
+        };
+    };
     readonly "snapcompact.shape": {
         readonly type: "enum";
         readonly values: readonly ["auto", ...("11on16-bw" | "5x8-bw" | "5x8-sent" | "6x12-dim" | "6x6u-bw" | "6x6u-sent" | "8on16-bw" | "8on22-bw" | "8x13-bw" | "8x8r-bw" | "8x8r-sent" | "8x8u-bw" | "8x8u-sent" | "doc-8on16-bw" | "doc-8on16-sent" | "doc-8on16-sent-dim")[]];
@@ -3315,6 +3371,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Ask the agent to describe the intent of each tool call before executing it";
         };
     };
+    readonly "tools.abortOnFabricatedResult": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly group: "Execution";
+            readonly label: "Abort On Fabricated Tool Result";
+            readonly description: "With in-band tool calls, stop the model immediately when it starts hallucinating a tool result mid-turn. Disable to let the model finish generating and discard the fabricated continuation instead.";
+        };
+    };
     readonly "tools.maxTimeout": {
         readonly type: "number";
         readonly default: 0;
@@ -4350,6 +4416,37 @@ export declare const SETTINGS_SCHEMA: {
             })[];
         };
     };
+    readonly "features.unexpectedStopDetection": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly group: "Agent";
+            readonly label: "Detect unexpected stops";
+            readonly description: "Use a small model to detect when the assistant says it will continue but stops without tool calls; automatically prompt it to continue.";
+        };
+    };
+    readonly "providers.unexpectedStopModel": {
+        readonly type: "enum";
+        readonly values: readonly ["online", "qwen3-1.7b", "gemma-3-1b", "qwen2.5-1.5b", "lfm2-1.2b"];
+        readonly default: "online";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly group: "Tiny Model";
+            readonly label: "Unexpected Stop Model";
+            readonly description: "Classifier for unexpected-stop detection: online smol by default, or a local on-device model.";
+            readonly condition: "unexpectedStopDetection";
+            readonly options: ({
+                value: "online";
+                label: string;
+                description: string;
+            } | {
+                value: "gemma-3-1b" | "lfm2-1.2b" | "qwen2.5-1.5b" | "qwen3-1.7b";
+                label: "Gemma 3 1B" | "LFM2 1.2B" | "Qwen2.5 1.5B" | "Qwen3 1.7B";
+                description: "Best consolidation/dedup; lighter footprint, but leaks small talk during extraction." | "Best extraction granularity (atomic facts); weaker consolidation." | "Fastest load; solid all-rounder, slightly noisier extraction labels." | "Recommended; most disciplined extraction (ignores chit-chat), good consolidation, about 1.1 GB cached.";
+            })[];
+        };
+    };
     readonly "providers.kimiApiFormat": {
         readonly type: "enum";
         readonly values: readonly ["openai", "anthropic"];

package/dist/types/edit/hashline/block-resolver.d.ts

@@ -1,5 +1,5 @@
 /**
- * Tree-sitter-backed {@link BlockResolver} for the hashline `replace block N:`
+ * Tree-sitter-backed {@link BlockResolver} for the hashline block replace
  * operator. Bridges the pure hashline seam to the native `blockRangeAt`
  * primitive in `@oh-my-pi/pi-natives`, which infers the language from the file
  * path and returns the 1-indexed line span of the syntactic block beginning on

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

@@ -1,4 +1,5 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
+import type { ToolExample } from "@oh-my-pi/pi-ai";
 import type { ToolSession } from "../tools";
 import { type EditMode } from "../utils/edit-mode";
 import { type HashlineParams, hashlineEditParamsSchema } from "./hashline";
@@ -34,6 +35,7 @@ export declare class EditTool implements AgentTool<TInput> {
     get mode(): EditMode;
     get description(): string;
     get parameters(): TInput;
+    get examples(): readonly ToolExample[] | undefined;
     /**
      * When in `apply_patch` mode, expose the Codex Lark grammar so providers
      * that support OpenAI-style custom tools can emit a grammar-constrained

package/dist/types/eval/js/context-manager.d.ts

@@ -7,6 +7,12 @@ export interface VmRunState {
     onText?: (chunk: string) => void;
     onDisplay?: (output: JsDisplayOutput) => void;
 }
+/**
+ * Test-only seam: override the graceful-close grace period (ms). Returns the
+ * previous value so callers can restore it. Production always uses
+ * {@link WORKER_CLOSE_TIMEOUT_MS}; never call this outside tests.
+ */
+export declare function setWorkerCloseTimeoutMsForTests(ms: number): number;
 export declare function executeInVmContext(options: {
     sessionKey: string;
     sessionId: string;
@@ -23,3 +29,12 @@ export declare function executeInVmContext(options: {
 }>;
 export declare function resetVmContext(sessionKey: string): Promise<void>;
 export declare function disposeAllVmContexts(): Promise<void>;
+/**
+ * Smoke probe: spawn the JS eval worker through the worker-host entry and prove
+ * it answers the `init` handshake on a real worker thread (not the inline
+ * fallback). Catches the silent worker-load and init-message-drop regressions
+ * that otherwise strand every cell on the init timeout in a distribution build —
+ * the failure mode that motivated `installWorkerInbox`. Wired into
+ * `omp --smoke-test` so binary / source / tarball installs all exercise it.
+ */
+export declare function smokeTestJsEvalWorker(): Promise<void>;

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

@@ -30,6 +30,7 @@ export declare class WelcomeComponent implements Component {
     private recentSessions;
     private lspServers;
     constructor(version: string, modelName: string, providerName: string, recentSessions?: RecentSession[], lspServers?: LspServerInfo[]);
+    get tip(): string | undefined;
     invalidate(): void;
     /**
      * Play a one-shot intro that sweeps the gradient through every phase

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

@@ -35,10 +35,10 @@ export declare class InputController {
      */
     handleLargePaste(text: string, lineCount: number): boolean;
     /**
-     * Present the large-paste menu and apply the chosen action: wrap in a code block or in XML tags
-     * (both collapse to a `[Paste]` marker that expands on submit), or save the text to a file and
-     * reference its path so the agent can `read` it on demand. Cancelling (Esc) falls back to the
-     * default inline paste marker, so the pasted content is never lost.
+     * Present the large-paste menu and apply the chosen action: wrap in `<attachment>` tags (collapsed
+     * to a `[Paste]` marker that expands on submit), save the text to a file and reference its path so
+     * the agent can `read` it on demand, or paste inline. Cancelling (Esc) falls back to the default
+     * inline paste marker, so the pasted content is never lost.
      */
     presentLargePasteMenu(text: string, lineCount: number): Promise<void>;
     createAutocompleteProvider(commands: SlashCommand[], basePath: string): AutocompleteProvider;

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

@@ -186,6 +186,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
         imageLinks?: (string | undefined)[];
         customType?: string;
         display?: boolean;
+        streamingBehavior?: "steer" | "followUp";
     }): SubmittedUserInput;
     cancelPendingSubmission(): boolean;
     markPendingSubmissionStarted(input: SubmittedUserInput): boolean;

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

@@ -6,7 +6,7 @@
  */
 import type { AgentMessage, AgentToolResult, ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import type { CompactionResult } from "@oh-my-pi/pi-agent-core/compaction";
-import type { Effort, ImageContent, Model } from "@oh-my-pi/pi-ai";
+import type { Effort, ImageContent, Model, ToolExample } from "@oh-my-pi/pi-ai";
 import type { BashResult } from "../../exec/bash-executor";
 import type { ContextUsage } from "../../extensibility/extensions/types";
 import type { AgentSessionEvent, SessionStats } from "../../session/agent-session";
@@ -186,6 +186,7 @@ export interface RpcSessionState {
         name: string;
         description: string;
         parameters: unknown;
+        examples?: readonly ToolExample[];
     }>;
     /** Current context window usage. Null tokens/percent when unknown (e.g. right after compaction). */
     contextUsage?: ContextUsage;

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

@@ -46,6 +46,11 @@ export type SubmittedUserInput = {
      *  turn. Used by the `c`/`.` continue shortcut. */
     synthetic?: boolean;
     display?: boolean;
+    /** Queue intent if the session is (or becomes) busy when this submission is
+     *  dispatched: "steer" (interrupt the active turn) or "followUp" (process after
+     *  it). Normal user Enter carries "steer" to match the streaming-branch Enter;
+     *  background/continuation submits omit it and default to "followUp". */
+    streamingBehavior?: "steer" | "followUp";
     cancelled: boolean;
     started: boolean;
 };
@@ -199,6 +204,7 @@ export interface InteractiveModeContext {
         imageLinks?: (string | undefined)[];
         customType?: string;
         display?: boolean;
+        streamingBehavior?: "steer" | "followUp";
     }): SubmittedUserInput;
     cancelPendingSubmission(): boolean;
     markPendingSubmissionStarted(input: SubmittedUserInput): boolean;

package/dist/types/sdk.d.ts

@@ -1,5 +1,6 @@
 import { type AgentTelemetryConfig, type ThinkingLevel } from "@oh-my-pi/pi-agent-core";
 import { type Model } from "@oh-my-pi/pi-ai";
+import type { ToolCallSyntax } from "@oh-my-pi/pi-ai/grammar";
 import { type Rule } from "./capability/rule";
 import { ModelRegistry } from "./config/model-registry";
 import { type PromptTemplate } from "./config/prompt-templates";
@@ -183,6 +184,8 @@ export interface CreateAgentSessionResult {
     /** Shared event bus for tool/extension communication */
     eventBus: EventBus;
 }
+export type ToolCallFormat = "auto" | "native" | ToolCallSyntax;
+export declare function resolveToolCallSyntax(format: ToolCallFormat, model: Pick<Model, "supportsTools"> | undefined): ToolCallSyntax | undefined;
 export type { PromptTemplate } from "./config/prompt-templates";
 export { Settings, type SkillsSettings } from "./config/settings";
 export type { CustomCommand, CustomCommandFactory } from "./extensibility/custom-commands/types";

package/dist/types/session/session-dump-format.d.ts

@@ -2,12 +2,13 @@
  * Plain-text / markdown session formatting (same shape as /dump clipboard export).
  */
 import type { AgentMessage, ThinkingLevel } from "@oh-my-pi/pi-agent-core";
-import type { Model } from "@oh-my-pi/pi-ai";
+import type { Model, ToolExample } from "@oh-my-pi/pi-ai";
 /** Minimal tool shape for dump output (matches AgentTool fields used by formatSessionDumpText). */
 export interface SessionDumpToolInfo {
     name: string;
     description: string;
     parameters: unknown;
+    examples?: readonly ToolExample[];
 }
 export interface FormatSessionDumpTextOptions {
     messages: readonly AgentMessage[];

package/dist/types/session/unexpected-stop-classifier.d.ts

@@ -0,0 +1,13 @@
+import { type AssistantMessage } from "@oh-my-pi/pi-ai";
+import type { ModelRegistry } from "../config/model-registry";
+import type { Settings } from "../config/settings";
+export interface ClassifyUnexpectedStopDeps {
+    settings: Settings;
+    registry: ModelRegistry;
+    sessionId: string;
+    metadataResolver?: (provider: string) => Record<string, unknown> | undefined;
+    signal?: AbortSignal;
+}
+export declare function isUnexpectedStopCandidate(message: AssistantMessage): boolean;
+export declare function classifyUnexpectedStop(text: string, deps: ClassifyUnexpectedStopDeps): Promise<boolean | undefined>;
+export declare function parseUnexpectedStopClassification(text: string): boolean | undefined;

package/dist/types/stt/asr-client.d.ts

@@ -43,7 +43,7 @@ export interface SttStreamOptions {
  * Hidden subcommand on the main CLI that boots the speech-recognition worker in
  * the spawned subprocess. Kept in sync with the dispatch in `cli.ts`.
  */
-export declare const STT_WORKER_ARG = "__omp_stt_worker";
+export declare const STT_WORKER_ARG = "__omp_worker_stt";
 interface SpawnedSubprocess {
     proc: Subprocess<"ignore", "ignore", "ignore">;
     inbound: Set<(message: SttWorkerOutbound) => void>;

package/dist/types/system-prompt.d.ts

@@ -2,6 +2,7 @@
  * System prompt construction and project context loading
  */
 import type { AgentTool } from "@oh-my-pi/pi-agent-core";
+import type { ToolExample, TSchema } from "@oh-my-pi/pi-ai";
 import type { Personality, SkillsSettings } from "./config/settings";
 import { type Skill } from "./extensibility/skills";
 import { type WorkspaceTree } from "./workspace-tree";
@@ -38,6 +39,10 @@ export interface SystemPromptToolMetadata {
     description: string;
     /** Tool name the model sees on the provider wire. Defaults to the internal tool name. */
     wireName?: string;
+    /** Tool parameters schema (Zod or JSON Schema), fed to the verbose inventory renderer. */
+    parameters?: TSchema;
+    /** Illustrative examples rendered into the verbose inventory. */
+    examples?: readonly ToolExample[];
 }
 export declare function buildSystemPromptToolMetadata(tools: Map<string, AgentTool>, overrides?: Partial<Record<string, Partial<SystemPromptToolMetadata>>>): Map<string, SystemPromptToolMetadata>;
 export interface BuildSystemPromptOptions {
@@ -51,6 +56,12 @@ export interface BuildSystemPromptOptions {
     appendSystemPrompt?: string;
     /** Repeat full tool descriptions in system prompt. Default: false */
     repeatToolDescriptions?: boolean;
+    /**
+     * Whether provider-native tool calling is active (no owned/in-band syntax).
+     * When true and `repeatToolDescriptions` is false, the inventory renders as a
+     * compact tool-name list; otherwise it renders full `# Tool:` sections. Default: true
+     */
+    nativeTools?: boolean;
     /** Skills settings for discovery. */
     skillsSettings?: SkillsSettings;
     /** Working directory. Default: getProjectDir() */

package/dist/types/tiny/title-client.d.ts

@@ -32,7 +32,7 @@ export interface TinyTitleGenerateOptions {
  * Hidden subcommand on the main CLI that boots the tiny-model worker in the
  * spawned subprocess. Kept in sync with the dispatch in `cli.ts`.
  */
-export declare const TINY_WORKER_ARG = "--tiny-worker";
+export declare const TINY_WORKER_ARG = "__omp_worker_tiny_inference";
 /**
  * Decide which `PI_TINY_DEVICE` / `PI_TINY_DTYPE` vars to overlay onto the worker
  * env. A present env var wins (left untouched); otherwise the mapped persisted

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

@@ -15,6 +15,7 @@
  *   - Questions may time out and auto-select the recommended option (configurable, disabled in plan mode)
  */
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
+import type { ToolExample } from "@oh-my-pi/pi-ai";
 import { type Component } from "@oh-my-pi/pi-tui";
 import { z } from "zod/v4";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
@@ -83,6 +84,7 @@ export declare class AskTool implements AgentTool<typeof askSchema, AskToolDetai
         }, z.core.$strip>>;
     }, z.core.$strip>;
     readonly strict = true;
+    readonly examples: readonly ToolExample<z.input<typeof askSchema>>[];
     readonly concurrency = "exclusive";
     readonly loadMode = "discoverable";
     constructor(session: ToolSession);

package/dist/types/tools/ast-edit.d.ts

@@ -1,4 +1,5 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
+import type { ToolExample } from "@oh-my-pi/pi-ai";
 import type { Component } from "@oh-my-pi/pi-tui";
 import { z } from "zod/v4";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
@@ -54,6 +55,7 @@ export declare class AstEditTool implements AgentTool<typeof astEditSchema, AstE
         paths: z.ZodArray<z.ZodString>;
     }, z.core.$strip>;
     readonly strict = true;
+    readonly examples: readonly ToolExample<z.input<typeof astEditSchema>>[];
     readonly deferrable = true;
     readonly loadMode = "discoverable";
     constructor(session: ToolSession);

package/dist/types/tools/ast-grep.d.ts

@@ -1,4 +1,5 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
+import type { ToolExample } from "@oh-my-pi/pi-ai";
 import type { Component } from "@oh-my-pi/pi-tui";
 import { z } from "zod/v4";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
@@ -48,6 +49,7 @@ export declare class AstGrepTool implements AgentTool<typeof astGrepSchema, AstG
         skip: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
     }, z.core.$strip>;
     readonly strict = true;
+    readonly examples: readonly ToolExample<z.input<typeof astGrepSchema>>[];
     readonly loadMode = "discoverable";
     constructor(session: ToolSession);
     execute(_toolCallId: string, params: z.infer<typeof astGrepSchema>, signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<AstGrepToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<AstGrepToolDetails>>;

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

@@ -1,4 +1,5 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
+import type { ToolExample } from "@oh-my-pi/pi-ai";
 import { z } from "zod/v4";
 import type { ToolSession } from "../sdk";
 import { type BrowserKindTag } from "./browser/registry";
@@ -110,6 +111,7 @@ export declare class BrowserTool implements AgentTool<typeof browserSchema, Brow
         kill: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     readonly strict = true;
+    readonly examples: readonly ToolExample<z.input<typeof browserSchema>>[];
     constructor(session: ToolSession);
     get description(): string;
     /** Restart browser to apply mode changes (e.g. headless toggle). Drops only headless browsers. */

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

@@ -1,4 +1,5 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback, RenderResultOptions, ToolApprovalDecision } from "@oh-my-pi/pi-agent-core";
+import type { ToolExample } from "@oh-my-pi/pi-ai";
 import { type Component } from "@oh-my-pi/pi-tui";
 import { z } from "zod/v4";
 import { type DapBreakpointRecord, type DapContinueOutcome, type DapDataBreakpointInfoResponse, type DapDataBreakpointRecord, type DapDisassembledInstruction, type DapEvaluateResponse, type DapFunctionBreakpointRecord, type DapInstructionBreakpointRecord, type DapModule, type DapScope, type DapSessionSummary, type DapSource, type DapStackFrame, type DapThread, type DapVariable } from "../dap";
@@ -208,6 +209,7 @@ export declare class DebugTool implements AgentTool<typeof debugSchema, DebugToo
         timeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     readonly strict = true;
+    readonly examples: readonly ToolExample<z.input<typeof debugSchema>>[];
     readonly concurrency = "exclusive";
     readonly loadMode = "discoverable";
     constructor(session: ToolSession);

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

@@ -1,4 +1,5 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
+import type { ToolExample } from "@oh-my-pi/pi-ai";
 import { z } from "zod/v4";
 import type { EvalToolDetails } from "../eval/types";
 import type { ToolSession } from ".";
@@ -65,6 +66,7 @@ export declare class EvalTool implements AgentTool<typeof evalSchema> {
     readonly loadMode = "discoverable";
     readonly label = "Eval";
     get description(): string;
+    readonly examples: readonly ToolExample<z.input<typeof evalSchema>>[];
     readonly parameters: z.ZodObject<{
         cells: z.ZodArray<z.ZodObject<{
             language: z.ZodEnum<{

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

@@ -1,4 +1,5 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
+import type { ToolExample } from "@oh-my-pi/pi-ai";
 import type { Component } from "@oh-my-pi/pi-tui";
 import { z } from "zod/v4";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
@@ -72,6 +73,7 @@ export declare class FindTool implements AgentTool<typeof findSchema, FindToolDe
         limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
         timeout: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
     }, z.core.$strict>;
+    readonly examples: readonly ToolExample<z.input<typeof findSchema>>[];
     readonly strict = true;
     constructor(session: ToolSession, options?: FindToolOptions);
     execute(_toolCallId: string, params: z.infer<typeof findSchema>, signal?: AbortSignal, onUpdate?: AgentToolUpdateCallback<FindToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<FindToolDetails>>;

package/dist/types/tools/inspect-image.d.ts

@@ -1,5 +1,5 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
-import { completeSimple } from "@oh-my-pi/pi-ai";
+import { completeSimple, type ToolExample } from "@oh-my-pi/pi-ai";
 import { z } from "zod/v4";
 import type { ToolSession } from "./index";
 declare const inspectImageSchema: z.ZodObject<{
@@ -26,6 +26,7 @@ export declare class InspectImageTool implements AgentTool<typeof inspectImageSc
         question: z.ZodString;
     }, z.core.$strict>;
     readonly strict = false;
+    readonly examples: readonly ToolExample<z.input<typeof inspectImageSchema>>[];
     constructor(session: ToolSession, completeImageRequest?: typeof completeSimple);
     execute(_toolCallId: string, params: InspectImageParams, signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<InspectImageToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<InspectImageToolDetails>>;
 }

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

@@ -9,6 +9,7 @@
  * drains pending messages; `list` shows every addressable peer.
  */
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
+import type { ToolExample } from "@oh-my-pi/pi-ai";
 import { type Component } from "@oh-my-pi/pi-tui";
 import { z } from "zod/v4";
 import type { Settings } from "../config/settings";
@@ -83,6 +84,7 @@ export declare class IrcTool implements AgentTool<typeof ircSchema, IrcDetails>
         peek: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     readonly strict = true;
+    readonly examples: readonly ToolExample<z.input<typeof ircSchema>>[];
     readonly loadMode = "discoverable";
     constructor(session: ToolSession);
     static createIf(session: ToolSession): IrcTool | null;

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

@@ -48,6 +48,7 @@ export declare class JobTool implements AgentTool<typeof jobSchema, JobToolDetai
         list: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     readonly strict = true;
+    readonly interruptible = true;
     readonly loadMode = "discoverable";
     constructor(session: ToolSession);
     execute(_toolCallId: string, params: JobParams, signal?: AbortSignal, onUpdate?: AgentToolUpdateCallback<JobToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<JobToolDetails>>;

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

@@ -1,4 +1,5 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
+import type { ToolExample } from "@oh-my-pi/pi-ai";
 import type { Component } from "@oh-my-pi/pi-tui";
 import { z } from "zod/v4";
 import type { SSHHost } from "../capability/ssh";
@@ -36,6 +37,7 @@ export declare class SshTool implements AgentTool<typeof sshSchema, SSHToolDetai
     }, z.core.$strip>;
     readonly concurrency = "exclusive";
     readonly strict = true;
+    readonly examples: readonly ToolExample<z.input<typeof sshSchema>>[];
     constructor(session: ToolSession, hostNames: string[], hostsByName: Map<string, SSHHost>, description: string);
     execute(_toolCallId: string, { host, command, cwd, timeout: rawTimeout }: SshToolParams, signal?: AbortSignal, onUpdate?: AgentToolUpdateCallback<SSHToolDetails>, _ctx?: AgentToolContext): Promise<AgentToolResult<SSHToolDetails>>;
 }

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

@@ -1,4 +1,5 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
+import type { ToolExample } from "@oh-my-pi/pi-ai";
 import type { Component } from "@oh-my-pi/pi-tui";
 import { z } from "zod/v4";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
@@ -117,6 +118,7 @@ export declare class TodoTool implements AgentTool<typeof todoSchema, TodoToolDe
     }, z.core.$strip>;
     readonly concurrency = "exclusive";
     readonly strict = true;
+    readonly examples: readonly ToolExample<z.input<typeof todoSchema>>[];
     readonly loadMode = "discoverable";
     constructor(session: ToolSession);
     execute(_toolCallId: string, params: TodoParams, _signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<TodoToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<TodoToolDetails>>;

package/dist/types/tts/tts-client.d.ts

@@ -54,7 +54,7 @@ export interface TtsStreamHandle {
  * Hidden subcommand on the main CLI that boots the TTS worker in the spawned
  * subprocess. Kept in sync with the dispatch in `cli.ts` (Main-owned).
  */
-export declare const TTS_WORKER_ARG = "__omp_tts_worker";
+export declare const TTS_WORKER_ARG = "__omp_worker_tts";
 interface SpawnedSubprocess {
     proc: Subprocess<"ignore", "ignore", "ignore">;
     inbound: Set<(message: TtsWorkerOutbound) => void>;

package/dist/types/tui/tree-list.d.ts

@@ -12,6 +12,7 @@ export interface TreeListOptions<T> {
      */
     maxCollapsedLines?: number;
     itemType?: string;
+    truncateFrom?: "start" | "end";
     /** Called once per item with `isLast: false` during budget calculation;
      *  line count MUST NOT vary based on `isLast`. */
     renderItem: (item: T, context: TreeContext) => string | string[];

package/dist/types/utils/thinking-display.d.ts

@@ -1,17 +1 @@
-import type { AssistantMessage } from "@oh-my-pi/pi-ai";
-type AssistantContentBlock = AssistantMessage["content"][number];
-type ThinkingBlock = Extract<AssistantContentBlock, {
-    type: "thinking";
-}>;
-/**
- * Returns the operator-visible thinking text for a block.
- *
- * Some OpenAI-compatible reasoning gateways require a non-empty
- * `reasoning_content` field on historical assistant tool-call turns even when
- * the model did not emit any reasoning. The provider adapter uses a single dot
- * as the wire-only placeholder those gateways accept; if that value is later
- * replayed or echoed as a thinking block, it should not render as model thought.
- */
-export declare function getVisibleThinkingText(block: ThinkingBlock): string;
-export declare function hasVisibleThinking(block: ThinkingBlock): boolean;
-export {};
+export declare function canonicalizeMessage(text: string | null | undefined): string;