@oh-my-pi/pi-coding-agent 15.8.3 → 15.9.0

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

@@ -1,16 +1,16 @@
-import type { SessionStorage, SessionStorageStat, SessionStorageWriter } from "./session-storage";
+import { IndexedSessionStorage, type SessionStorageBackend } from "./indexed-session-storage";
 /**
  * Supported `bun:sql` adapter dialects. `Bun.SQL` reports this string on
  * `client.options.adapter`; we detect it once at construction and pick the
- * correct DDL / upsert / concat syntax for the underlying engine.
+ * correct DDL / upsert / concat / byte-slice syntax for the underlying engine.
  */
 export type SqlSessionStorageAdapter = "postgres" | "mysql" | "sqlite";
 /**
  * Minimal subset of the `Bun.SQL` instance surface used by
- * {@link SqlSessionStorage}. The real client exposes a callable
- * tagged-template too; we only ever call `unsafe()` so the contract here is
- * narrow — making it trivial to swap in a test double or wrap a pooled
- * client.
+ * {@link SqlSessionStorage}. Bun's SQL client exposes a tagged-template API too,
+ * but this implementation intentionally uses `unsafe(query, values)` because
+ * the table identifier is validated and then inlined while values remain bound
+ * parameters.
  */
 export interface SqlSessionStorageClient {
     unsafe(query: string, values?: unknown[]): Promise<unknown[]>;
@@ -50,92 +50,23 @@ export interface SqlSessionStorageOptions {
 }
 /**
  * SQL-backed implementation of {@link SessionStorage} using `bun:sql`. Each
- * session JSONL file maps to a row keyed by `path`; one table stores
- * everything.
+ * session JSONL file maps to a row keyed by `path`; one table stores the file
+ * contents while this process keeps only a metadata index (`size`, `mtimeMs`) in
+ * memory for synchronous `existsSync` / `statSync` / `listFilesSync` calls.
  *
  * Works against PostgreSQL, MySQL/MariaDB, and SQLite by selecting the
- * dialect-correct DDL, upsert, and string-concat syntax at construction.
- *
- * Trade-offs vs `FileSessionStorage`:
- * - An in-memory mirror is loaded on construction so the interface's
- *   synchronous methods (`existsSync`, `statSync`, `listFilesSync`, …) keep
- *   their contracts; `bun:sql` is async only. Mirror state is process-local,
- *   matching `FileSessionStorage`'s existing single-writer assumption — peer
- *   processes need {@link refresh} to pick up out-of-band writes.
- * - `writeLineSync` updates the mirror synchronously and queues an async
- *   upsert that appends the line to the existing row (or inserts it as the
- *   first chunk). The promise is awaited by `flush()` / `close()` /
- *   {@link drain}. A SIGKILL between the sync mirror update and the network
- *   round-trip loses the last line.
- * - Blobs (image data) and tool artifact files still live on disk via
- *   `BlobStore` / `ArtifactManager`. Those are out of scope for this storage.
+ * dialect-correct DDL, upsert, string-concat, byte-length, and byte-slice syntax
+ * at construction.
  */
-export declare class SqlSessionStorage implements SessionStorage {
+export declare class SqlSessionStorage extends IndexedSessionStorage {
     #private;
-    private constructor();
+    constructor(backend: SessionStorageBackend, adapter: SqlSessionStorageAdapter, table: string);
     /**
-     * Apply the dialect-correct DDL (unless `createTable: false` is set) and
-     * warm the in-memory mirror with every existing row. Must be awaited
-     * before passing the storage into `SessionManager.create()`.
+     * Apply the dialect-correct DDL (unless `createTable: false` is set) and warm
+     * the metadata index with every existing row. Must be awaited before passing
+     * the storage into `SessionManager.create()`.
      */
     static create(options: SqlSessionStorageOptions): Promise<SqlSessionStorage>;
     get adapter(): SqlSessionStorageAdapter;
     get table(): string;
-    /**
-     * Re-load the mirror from the database. Call this from a different
-     * process that took over the table, or after an out-of-band write made
-     * by another agent.
-     */
-    refresh(): Promise<void>;
-    /**
-     * Resolve once every pending background write (issued via `writeTextSync`
-     * or `writer.writeLineSync`) has been acknowledged by the database.
-     * Throws if any background write failed since the last drain. Call on
-     * graceful shutdown to avoid losing the last unflushed line.
-     */
-    drain(): Promise<void>;
-    ensureDirSync(_dir: string): void;
-    existsSync(path: string): boolean;
-    writeTextSync(path: string, content: string): void;
-    readTextSync(path: string): string;
-    statSync(path: string): SessionStorageStat;
-    listFilesSync(dir: string, pattern: string): string[];
-    exists(path: string): Promise<boolean>;
-    readText(path: string): Promise<string>;
-    readTextPrefix(path: string, maxBytes: number): Promise<string>;
-    writeText(path: string, content: string): Promise<void>;
-    rename(src: string, dst: string): Promise<void>;
-    unlink(path: string): Promise<void>;
-    deleteSessionWithArtifacts(sessionPath: string): Promise<void>;
-    openWriter(path: string, options?: {
-        flags?: "a" | "w";
-        onError?: (err: Error) => void;
-    }): SessionStorageWriter;
-    _writerClosed(writer: SqlSessionStorageWriter): void;
-    _mirrorAppend(path: string, line: string): {
-        content: string;
-        mtimeMs: number;
-    };
-    _mirrorTruncate(path: string): void;
-    _remoteTruncate(path: string): Promise<void>;
-    /**
-     * Append a chunk to the row at `path`, inserting if the row doesn't
-     * exist yet. Single round-trip via the dialect-specific `upsertAppend`.
-     */
-    _remoteAppend(path: string, line: string, mtimeMs: number): Promise<void>;
-    _attachPending(promise: Promise<void>): void;
-}
-declare class SqlSessionStorageWriter implements SessionStorageWriter {
-    #private;
-    constructor(storage: SqlSessionStorage, path: string, options?: {
-        flags?: "a" | "w";
-        onError?: (err: Error) => void;
-    });
-    writeLineSync(line: string): void;
-    writeLine(line: string): Promise<void>;
-    flush(): Promise<void>;
-    fsync(): Promise<void>;
-    close(): Promise<void>;
-    getError(): Error | undefined;
 }
-export {};

package/dist/types/task/executor.d.ts

@@ -26,6 +26,15 @@ export interface ExecutorOptions {
     task: string;
     assignment?: string;
     context?: string;
+    /**
+     * The session's active overall plan, handed off so subagents spawned during
+     * plan execution share the same plan context as the main agent. Omitted when
+     * the session did not start with a plan (or while plan mode is still active).
+     */
+    planReference?: {
+        path: string;
+        content: string;
+    };
     description?: string;
     index: number;
     id: string;

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

@@ -1,7 +1,7 @@
 import type { AgentTool, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
 import type { ToolSession } from "..";
 import type { Theme } from "../modes/theme/theme";
-import { type TaskToolDetails, type TaskToolSchemaInstance } from "./types";
+import { type AgentDefinition, type TaskToolDetails, type TaskToolSchemaInstance } from "./types";
 import "../tools/review";
 import { renderResult, renderCall as renderTaskCall } from "./render";
 export { loadBundledAgents as BUNDLED_AGENTS } from "./agents";
@@ -10,6 +10,8 @@ export { discoverAgents, getAgent } from "./discovery";
 export { AgentOutputManager } from "./output-manager";
 export type { AgentDefinition, AgentProgress, SingleResult, SubagentLifecyclePayload, SubagentProgressPayload, TaskParams, TaskToolDetails, } from "./types";
 export { TASK_SUBAGENT_EVENT_CHANNEL, TASK_SUBAGENT_LIFECYCLE_CHANNEL, TASK_SUBAGENT_PROGRESS_CHANNEL, taskSchema, } from "./types";
+export declare const READ_ONLY_TOOL_NAMES: ReadonlySet<string>;
+export declare function isReadOnlyAgent(agent: AgentDefinition): boolean;
 /**
  * Task tool - Delegate tasks to specialized agents.
  *

package/dist/types/telemetry-export.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Whether {@link initTelemetryExport} registered a real provider. The CLI uses
+ * this to decide whether to switch on the agent loop's telemetry config — there
+ * is no point emitting spans into a no-op tracer.
+ */
+export declare function isTelemetryExportEnabled(): boolean;
+/**
+ * Register the global TracerProvider + OTLP exporter when an OTLP endpoint is
+ * configured via env. Idempotent, and a no-op when no endpoint is set (or when
+ * the OTEL kill-switches are engaged), so it is safe to call unconditionally at
+ * startup.
+ */
+export declare function initTelemetryExport(): void;
+/**
+ * Flush any buffered spans to the exporter. No-op when export is disabled.
+ * Hosts embedding the agent can call this at natural boundaries (e.g. the end
+ * of a turn) so traces surface promptly rather than on the batch interval.
+ */
+export declare function flushTelemetryExport(): Promise<void>;

package/dist/types/tiny/compiled-runtime.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Walk a conditional `exports` target (string, array of fallbacks, or a
+ * condition object) and return the first relative path that matches a runtime
+ * condition in declaration order. Returns `null` when nothing applies (e.g.
+ * `import`-only targets).
+ */
+export declare function selectConditionalTarget(target: unknown): string | null;
+/**
+ * Split a bare specifier into its package name and optional subpath, handling
+ * scoped packages (`@scope/name/sub` → `@scope/name` + `sub`).
+ */
+export declare function splitBareSpecifier(specifier: string): {
+    packageName: string;
+    subpath: string | undefined;
+};
+/**
+ * Resolve a bare specifier against an installed `node_modules` directory,
+ * honoring `exports` (CommonJS conditions), then `main`, then `index.js`.
+ * Returns an absolute file path, or `null` when the package/entry is absent.
+ */
+export declare function resolveRuntimeModule(runtimeNodeModules: string, specifier: string): string | null;
+interface ResolverOptions {
+    /** Absolute path to the runtime cache's `node_modules`. */
+    runtimeNodeModules: string;
+    /** Bare specifier → absolute file path overrides (e.g. `sharp` → no-op stub). */
+    stubs?: Record<string, string>;
+}
+/**
+ * Patch `node:module`'s resolver (idempotently) so bare specifiers that the
+ * stock compiled-binary resolver cannot find fall back to the runtime cache.
+ * Stock resolution is tried first, so this never changes behavior for modules
+ * that already resolve (the worker's own bundled imports, node builtins).
+ */
+export declare function installRuntimeModuleResolver({ runtimeNodeModules, stubs }: ResolverOptions): void;
+export {};

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

@@ -100,6 +100,7 @@ interface AskRenderArgs {
     }>;
 }
 export declare const askToolRenderer: {
+    mergeCallAndResult: boolean;
     renderCall(args: AskRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component;
     renderResult(result: {
         content: Array<{

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

@@ -20,7 +20,7 @@ import type { DiscoverableTool, DiscoverableToolSearchIndex } from "../tool-disc
 import type { EventBus } from "../utils/event-bus";
 import type { WorkspaceTree } from "../workspace-tree";
 import { type CheckpointState } from "./checkpoint";
-import { type TodoPhase } from "./todo-write";
+import { type TodoPhase } from "./todo";
 export * from "../edit";
 export * from "../exa";
 export type * from "../exa/types";
@@ -56,7 +56,7 @@ export * from "./review";
 export * from "./search";
 export * from "./search-tool-bm25";
 export * from "./ssh";
-export * from "./todo-write";
+export * from "./todo";
 export * from "./tts";
 export * from "./write";
 export * from "./yield";
@@ -147,6 +147,8 @@ export interface ToolSession {
     settings: Settings;
     /** Plan mode state (if active) */
     getPlanModeState?: () => PlanModeState | undefined;
+    /** Path of the session's active plan reference (e.g. `local://<title>.md`); defaults to `local://PLAN.md`. */
+    getPlanReferencePath?: () => string;
     /** Goal mode state (if active or paused) */
     getGoalModeState?: () => GoalModeState | undefined;
     /** Goal runtime for the active agent session. */

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

@@ -9,7 +9,7 @@ export interface LineRange {
     startLine: number;
     endLine: number | undefined;
 }
-/** Parse a single `N`, `N-M`, `N-`, or `N+K` chunk. Throws via {@link ToolError} on invalid bounds. */
+/** Parse a single `N`, `N-M`, `N-`, `N+K`, or `..`-aliased (`N..M`, `N..`) chunk. Throws via {@link ToolError} on invalid bounds. */
 export declare function parseLineRangeChunk(sel: string): LineRange | null;
 /**
  * Parse a comma-separated list of line ranges (e.g. `5-16,960-973`). Returns

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

@@ -8,7 +8,7 @@ import type { ToolSession } from ".";
 import { type OutputMeta } from "./output-meta";
 declare const searchSchema: z.ZodObject<{
     pattern: z.ZodString;
-    paths: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    paths: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
     i: z.ZodOptional<z.ZodBoolean>;
     gitignore: z.ZodOptional<z.ZodBoolean>;
     skip: z.ZodOptional<z.ZodNumber>;
@@ -63,7 +63,7 @@ export declare class SearchTool implements AgentTool<typeof searchSchema, Search
     readonly description: string;
     readonly parameters: z.ZodObject<{
         pattern: z.ZodString;
-        paths: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        paths: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
         i: z.ZodOptional<z.ZodBoolean>;
         gitignore: z.ZodOptional<z.ZodBoolean>;
         skip: z.ZodOptional<z.ZodNumber>;

package/dist/types/tools/{todo-write.d.ts → todo.d.ts}

@@ -25,12 +25,12 @@ export interface TodoCompletionTransition {
     phase: string;
     content: string;
 }
-export interface TodoWriteToolDetails {
+export interface TodoToolDetails {
     phases: TodoPhase[];
     storage: "session" | "memory";
     completedTasks?: TodoCompletionTransition[];
 }
-declare const todoWriteSchema: z.ZodObject<{
+declare const todoSchema: z.ZodObject<{
     ops: z.ZodArray<z.ZodObject<{
         op: z.ZodEnum<{
             append: "append";
@@ -51,7 +51,7 @@ declare const todoWriteSchema: z.ZodObject<{
         text: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
-type TodoWriteParams = z.infer<typeof todoWriteSchema>;
+type TodoParams = z.infer<typeof todoSchema>;
 export declare const USER_TODO_EDIT_CUSTOM_TYPE = "user_todo_edit";
 export declare function getLatestTodoPhasesFromEntries(entries: SessionEntry[]): TodoPhase[];
 /**
@@ -62,7 +62,7 @@ export declare function getLatestTodoPhasesFromEntries(entries: SessionEntry[]):
  * the caller can render a `+N more` hint. When every task in `tasks` is
  * closed (completed or abandoned), returns the trailing `maxVisible` tasks
  * with `hiddenOpenCount = 0`, so the panel keeps useful context until the
- * active-phase pointer advances on the next `todo_write`.
+ * active-phase pointer advances on the next `todo`.
  *
  * Task identity and order are preserved — this is a slice, never a sort.
  */
@@ -84,8 +84,8 @@ export declare function selectStickyTodoWindow(tasks: TodoItem[], maxVisible?: n
  * the contained side.
  */
 export declare function todoMatchesAnyDescription(content: string, descriptions: readonly string[]): boolean;
-/** Apply an array of `todo_write`-style ops to existing phases. Used by /todo slash command. */
-export declare function applyOpsToPhases(currentPhases: TodoPhase[], ops: TodoWriteParams["ops"]): {
+/** Apply an array of `todo`-style ops to existing phases. Used by /todo slash command. */
+export declare function applyOpsToPhases(currentPhases: TodoPhase[], ops: TodoParams["ops"]): {
     phases: TodoPhase[];
     errors: string[];
 };
@@ -96,11 +96,11 @@ export declare function markdownToPhases(md: string): {
     phases: TodoPhase[];
     errors: string[];
 };
-export declare class TodoWriteTool implements AgentTool<typeof todoWriteSchema, TodoWriteToolDetails> {
+export declare class TodoTool implements AgentTool<typeof todoSchema, TodoToolDetails> {
     private readonly session;
-    readonly name = "todo_write";
+    readonly name = "todo";
     readonly approval: "read";
-    readonly label = "Todo Write";
+    readonly label = "Todo";
     readonly summary = "Write a structured todo list to track progress within a session";
     readonly description: string;
     readonly parameters: z.ZodObject<{
@@ -128,9 +128,9 @@ export declare class TodoWriteTool implements AgentTool<typeof todoWriteSchema,
     readonly strict = true;
     readonly loadMode = "discoverable";
     constructor(session: ToolSession);
-    execute(_toolCallId: string, params: TodoWriteParams, _signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<TodoWriteToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<TodoWriteToolDetails>>;
+    execute(_toolCallId: string, params: TodoParams, _signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<TodoToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<TodoToolDetails>>;
 }
-type TodoWriteRenderArgs = {
+type TodoRenderArgs = {
     ops?: Array<{
         op?: string;
         task?: string;
@@ -142,18 +142,18 @@ type TodoWriteRenderArgs = {
 export declare function phaseRomanNumeral(oneBasedIndex: number): string;
 /** Display-only phase header: `I. Foundation`. State and prompts never see this. */
 export declare function formatPhaseDisplayName(name: string, oneBasedIndex: number): string;
-export declare const TODO_WRITE_STRIKE_HOLD_FRAMES = 2;
-export declare const TODO_WRITE_STRIKE_REVEAL_FRAMES = 12;
-export declare const TODO_WRITE_STRIKE_TOTAL_FRAMES: number;
-export declare const todoWriteToolRenderer: {
-    renderCall(args: TodoWriteRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component;
+export declare const TODO_STRIKE_HOLD_FRAMES = 2;
+export declare const TODO_STRIKE_REVEAL_FRAMES = 12;
+export declare const TODO_STRIKE_TOTAL_FRAMES: number;
+export declare const todoToolRenderer: {
+    renderCall(args: TodoRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component;
     renderResult(result: {
         content: Array<{
             type: string;
             text?: string;
         }>;
-        details?: TodoWriteToolDetails;
-    }, options: RenderResultOptions, uiTheme: Theme, _args?: TodoWriteRenderArgs): Component;
+        details?: TodoToolDetails;
+    }, options: RenderResultOptions, uiTheme: Theme, _args?: TodoRenderArgs): Component;
     mergeCallAndResult: boolean;
 };
 export {};

package/dist/types/utils/session-color.d.ts

@@ -1,8 +1,13 @@
 /**
  * Derive a stable CSS hex accent color from a session name.
- * High saturation, vivid — suitable for both status bar text and border coloring.
+ *
+ * On dark themes (`surfaceLuminance` undefined) the accent is vivid (high
+ * saturation, high lightness). On light themes the lightness is reduced until the
+ * accent's perceived luminance clears {@link ACCENT_MIN_CONTRAST} against the
+ * actual surface it renders on — so it stays legible on near-white *and* mid-light
+ * backgrounds — while keeping the same per-session hue.
  */
-export declare function getSessionAccentHex(name: string): string;
+export declare function getSessionAccentHex(name: string, surfaceLuminance?: number): string;
 /**
  * Convert a hex accent color to an ANSI-16m foreground escape sequence.
  * Returns `undefined` if `hex` is nullish or Bun.color conversion fails.

package/dist/types/web/search/index.d.ts

@@ -50,7 +50,7 @@ export declare function runSearchQuery(params: SearchQueryParams, options?: {
 /**
  * Web search tool implementation.
  *
- * Supports Anthropic, Perplexity, Exa, Brave, Jina, Kimi, Gemini, Codex, Z.AI, SearXNG, and Synthetic providers with automatic fallback.
+ * Supports the configured web-search provider chain with automatic fallback.
  */
 export declare class WebSearchTool implements AgentTool<typeof webSearchSchema, SearchRenderDetails> {
     #private;

package/dist/types/web/search/provider.d.ts

@@ -1,8 +1,9 @@
 import type { AuthStorage } from "@oh-my-pi/pi-ai";
 import type { SearchProvider } from "./providers/base";
-import type { SearchProviderId } from "./types";
+import { type SearchProviderId } from "./types";
 export type { SearchParams } from "./providers/base";
 export { SearchProvider } from "./providers/base";
+export { SEARCH_PROVIDER_ORDER } from "./types";
 /** Cheap, sync metadata accessor — never triggers a provider load. */
 export declare function getSearchProviderLabel(id: SearchProviderId): string;
 /**
@@ -10,7 +11,6 @@ export declare function getSearchProviderLabel(id: SearchProviderId): string;
  * underlying module; subsequent calls return the cached singleton.
  */
 export declare function getSearchProvider(id: SearchProviderId): Promise<SearchProvider>;
-export declare const SEARCH_PROVIDER_ORDER: SearchProviderId[];
 /** Set the preferred web search provider from settings */
 export declare function setPreferredSearchProvider(provider: SearchProviderId | "auto"): void;
 /**

package/dist/types/web/search/types.d.ts

@@ -3,8 +3,72 @@
  *
  * Unified types for web search responses across supported providers.
  */
+export declare const SEARCH_PROVIDER_ORDER: readonly ["tavily", "perplexity", "brave", "jina", "kimi", "anthropic", "gemini", "codex", "zai", "exa", "parallel", "kagi", "synthetic", "searxng"];
 /** Supported web search providers */
-export type SearchProviderId = "exa" | "brave" | "jina" | "kimi" | "zai" | "anthropic" | "perplexity" | "gemini" | "codex" | "tavily" | "parallel" | "kagi" | "synthetic" | "searxng";
+export type SearchProviderId = (typeof SEARCH_PROVIDER_ORDER)[number];
+export declare const SEARCH_PROVIDER_PREFERENCES: readonly ["auto", "tavily", "perplexity", "brave", "jina", "kimi", "anthropic", "gemini", "codex", "zai", "exa", "parallel", "kagi", "synthetic", "searxng"];
+export declare const SEARCH_PROVIDER_OPTIONS: readonly [{
+    readonly value: "auto";
+    readonly label: "Auto";
+    readonly description: "Automatically uses the first configured web-search provider";
+}, {
+    readonly value: "tavily";
+    readonly label: "Tavily";
+    readonly description: "Requires TAVILY_API_KEY";
+}, {
+    readonly value: "perplexity";
+    readonly label: "Perplexity";
+    readonly description: "Requires PERPLEXITY_COOKIES or PERPLEXITY_API_KEY";
+}, {
+    readonly value: "brave";
+    readonly label: "Brave";
+    readonly description: "Requires BRAVE_API_KEY";
+}, {
+    readonly value: "jina";
+    readonly label: "Jina";
+    readonly description: "Requires JINA_API_KEY";
+}, {
+    readonly value: "kimi";
+    readonly label: "Kimi";
+    readonly description: "Requires MOONSHOT_SEARCH_API_KEY or MOONSHOT_API_KEY";
+}, {
+    readonly value: "anthropic";
+    readonly label: "Anthropic";
+    readonly description: "Claude's native web_search tool (uses Anthropic OAuth or ANTHROPIC_API_KEY)";
+}, {
+    readonly value: "gemini";
+    readonly label: "Gemini";
+    readonly description: "Google Search grounding via Gemini (uses google-gemini-cli or google-antigravity OAuth)";
+}, {
+    readonly value: "codex";
+    readonly label: "OpenAI";
+    readonly description: "OpenAI's native web_search (uses ChatGPT OAuth via /login openai-codex)";
+}, {
+    readonly value: "zai";
+    readonly label: "Z.AI";
+    readonly description: "Calls Z.AI webSearchPrime MCP";
+}, {
+    readonly value: "exa";
+    readonly label: "Exa";
+    readonly description: "Requires EXA_API_KEY";
+}, {
+    readonly value: "parallel";
+    readonly label: "Parallel";
+    readonly description: "Requires PARALLEL_API_KEY";
+}, {
+    readonly value: "kagi";
+    readonly label: "Kagi";
+    readonly description: "Requires KAGI_API_KEY and Kagi Search API beta access";
+}, {
+    readonly value: "synthetic";
+    readonly label: "Synthetic";
+    readonly description: "Requires SYNTHETIC_API_KEY";
+}, {
+    readonly value: "searxng";
+    readonly label: "SearXNG";
+    readonly description: "Requires SEARXNG_ENDPOINT or searxng.endpoint";
+}];
+export declare const SEARCH_PROVIDER_LABELS: Record<SearchProviderId, string>;
 export declare function isSearchProviderId(value: string): value is SearchProviderId;
 export declare function isSearchProviderPreference(value: string): value is SearchProviderId | "auto";
 /** Source returned by search (all providers) */

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "15.8.3",
+	"version": "15.9.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -47,14 +47,20 @@
 		"@agentclientprotocol/sdk": "0.22.1",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "15.8.3",
-		"@oh-my-pi/omp-stats": "15.8.3",
-		"@oh-my-pi/pi-agent-core": "15.8.3",
-		"@oh-my-pi/pi-ai": "15.8.3",
-		"@oh-my-pi/pi-mnemopi": "15.8.3",
-		"@oh-my-pi/pi-natives": "15.8.3",
-		"@oh-my-pi/pi-tui": "15.8.3",
-		"@oh-my-pi/pi-utils": "15.8.3",
+		"@oh-my-pi/hashline": "15.9.0",
+		"@oh-my-pi/omp-stats": "15.9.0",
+		"@oh-my-pi/pi-agent-core": "15.9.0",
+		"@oh-my-pi/pi-ai": "15.9.0",
+		"@oh-my-pi/pi-mnemopi": "15.9.0",
+		"@oh-my-pi/pi-natives": "15.9.0",
+		"@oh-my-pi/pi-tui": "15.9.0",
+		"@oh-my-pi/pi-utils": "15.9.0",
+		"@opentelemetry/api": "^1.9.1",
+		"@opentelemetry/context-async-hooks": "^2.7.1",
+		"@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",
+		"@opentelemetry/resources": "^2.7.1",
+		"@opentelemetry/sdk-trace-base": "^2.7.1",
+		"@opentelemetry/sdk-trace-node": "^2.7.1",
 		"@puppeteer/browsers": "^3.0.4",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",

package/scripts/build-binary.ts

@@ -1,10 +1,20 @@
 #!/usr/bin/env bun
 
+import { createRequire } from "node:module";
 import * as path from "node:path";
 
 const packageDir = path.join(import.meta.dir, "..");
 const outputPath = path.join(packageDir, "dist", "omp");
 
+// Transformers.js is an optional, native-heavy dependency that is never bundled
+// into the binary; the tiny-model worker `bun install`s it into a runtime cache
+// on first use. The `catalog:` spec cannot be resolved from inside the compiled
+// bunfs (issue #1763), so embed the concrete installed version here for the
+// worker to pin its runtime install against.
+const transformersVersion = (
+	createRequire(import.meta.url)("@huggingface/transformers/package.json") as { version: string }
+).version;
+
 function shouldAdhocSignDarwinBinary(): boolean {
 	return process.platform === "darwin";
 }
@@ -40,6 +50,8 @@ async function main(): Promise<void> {
 					"--keep-names",
 					"--define",
 					'process.env.PI_COMPILED="true"',
+					"--define",
+					`process.env.PI_TINY_TRANSFORMERS_VERSION=${JSON.stringify(transformersVersion)}`,
 					"--external",
 					"mupdf",
 					"--root",

package/src/capability/skill.ts

@@ -21,6 +21,13 @@ export interface SkillFrontmatter {
 	 * rather than ones the model should auto-discover.
 	 */
 	hide?: boolean;
+	/**
+	 * Agent Skills standard equivalent of `hide`.
+	 * When `true`, the skill is excluded from the system prompt listing.
+	 * Normalized from kebab-case `disable-model-invocation` in YAML frontmatter.
+	 * @see https://agentskills.io/specification
+	 */
+	disableModelInvocation?: boolean;
 	[key: string]: unknown;
 }
 

package/src/cli/args.ts

@@ -313,7 +313,7 @@ ${chalk.bold("Available Tools (default-enabled unless noted):")}
   inspect_image - Analyze images with a vision model
   browser       - Browser automation (Puppeteer)
   task          - Launch sub-agents for parallel tasks
-  todo_write    - Manage todo/task lists
+  todo          - Manage todo/task lists
   web_search    - Search the web
   ask           - Ask user questions (interactive mode only)