@oh-my-pi/pi-coding-agent 16.1.22 → 16.2.0

package/dist/types/tools/builtin-names.d.ts

@@ -1,2 +1,6 @@
-export declare const BUILTIN_TOOL_NAMES: readonly ["read", "bash", "edit", "ast_grep", "ast_edit", "ask", "debug", "eval", "ssh", "github", "find", "search", "lsp", "inspect_image", "browser", "checkpoint", "rewind", "task", "job", "irc", "todo", "web_search", "search_tool_bm25", "write", "memory_edit", "retain", "recall", "reflect", "learn", "manage_skill"];
+export declare const BUILTIN_TOOL_NAMES: readonly ["read", "bash", "edit", "ast_grep", "ast_edit", "ask", "debug", "eval", "ssh", "github", "glob", "grep", "lsp", "inspect_image", "browser", "checkpoint", "rewind", "task", "job", "irc", "todo", "web_search", "search_tool_bm25", "write", "memory_edit", "retain", "recall", "reflect", "learn", "manage_skill"];
 export type BuiltinToolName = (typeof BUILTIN_TOOL_NAMES)[number];
+/** Return the canonical tool name for current and legacy built-in tool IDs. */
+export declare function normalizeToolName(name: string): string;
+/** Normalize and deduplicate tool names while preserving first-seen order. */
+export declare function normalizeToolNames(names: Iterable<string>): string[];

package/dist/types/tools/{find.d.ts → glob.d.ts}

@@ -12,8 +12,8 @@ declare const findSchema: import("arktype/internal/variants/object.ts").ObjectTy
     gitignore?: boolean | undefined;
     limit?: number | undefined;
 }, {}>;
-export type FindToolInput = typeof findSchema.infer;
-export interface FindToolDetails {
+export type GlobToolInput = typeof findSchema.infer;
+export interface GlobToolDetails {
     truncation?: TruncationResult;
     resultLimitReached?: number;
     meta?: OutputMeta;
@@ -34,7 +34,7 @@ export interface FindToolDetails {
  * Pluggable operations for the find tool.
  * Override these to delegate file search to remote systems (e.g., SSH).
  */
-export interface FindOperations {
+export interface GlobOperations {
     /** Check if path exists */
     exists: (absolutePath: string) => Promise<boolean> | boolean;
     /** Optional stat for distinguishing files vs directories. */
@@ -51,17 +51,17 @@ export interface FindOperations {
         limit: number;
     }) => Promise<string[]> | string[];
 }
-export interface FindToolOptions {
+export interface GlobToolOptions {
     /** Custom operations for find. Default: local filesystem + rg */
-    operations?: FindOperations;
+    operations?: GlobOperations;
 }
-export declare class FindTool implements AgentTool<typeof findSchema, FindToolDetails> {
+export declare class GlobTool implements AgentTool<typeof findSchema, GlobToolDetails> {
     #private;
     private readonly session;
-    readonly name = "find";
+    readonly name = "glob";
     readonly approval: "read";
     readonly loadMode = "essential";
-    readonly label = "Find";
+    readonly label = "Glob";
     readonly description: string;
     readonly parameters: import("arktype/internal/variants/object.ts").ObjectType<{
         paths: string[];
@@ -71,24 +71,24 @@ export declare class FindTool implements AgentTool<typeof findSchema, FindToolDe
     }, {}>;
     readonly examples: readonly ToolExample<typeof findSchema.infer>[];
     readonly strict = true;
-    constructor(session: ToolSession, options?: FindToolOptions);
-    execute(_toolCallId: string, params: typeof findSchema.infer, signal?: AbortSignal, onUpdate?: AgentToolUpdateCallback<FindToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<FindToolDetails>>;
+    constructor(session: ToolSession, options?: GlobToolOptions);
+    execute(_toolCallId: string, params: typeof findSchema.infer, signal?: AbortSignal, onUpdate?: AgentToolUpdateCallback<GlobToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<GlobToolDetails>>;
 }
-interface FindRenderArgs {
+interface GlobRenderArgs {
     paths?: string | string[];
     limit?: number;
 }
-export declare const findToolRenderer: {
+export declare const globToolRenderer: {
     inline: boolean;
-    renderCall(args: FindRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component;
+    renderCall(args: GlobRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component;
     renderResult(result: {
         content: Array<{
             type: string;
             text?: string;
         }>;
-        details?: FindToolDetails;
+        details?: GlobToolDetails;
         isError?: boolean;
-    }, options: RenderResultOptions, uiTheme: Theme, args?: FindRenderArgs): Component;
+    }, options: RenderResultOptions, uiTheme: Theme, args?: GlobRenderArgs): Component;
     mergeCallAndResult: boolean;
 };
 export {};

package/dist/types/tools/{search.d.ts → grep.d.ts}

@@ -1,4 +1,4 @@
-import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
+import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback, ToolTier } from "@oh-my-pi/pi-agent-core";
 import type { Component } from "@oh-my-pi/pi-tui";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
 import type { Theme } from "../modes/theme/theme";
@@ -12,7 +12,7 @@ declare const searchSchema: import("arktype/internal/variants/object.ts").Object
     gitignore?: boolean | undefined;
     skip?: number | null | undefined;
 }, {}>;
-export type SearchToolInput = typeof searchSchema.infer;
+export type GrepToolInput = typeof searchSchema.infer;
 export declare function toPathList(input: string | string[] | undefined): string[];
 /** Maximum number of distinct files surfaced in a single response. The
  * agent paginates further pages via `skip`. */
@@ -23,7 +23,7 @@ export declare const MULTI_FILE_PER_FILE_MATCHES = 20;
 /** Per-file match cap for single-file searches — there's no diversity
  * concern when the scope is one file. */
 export declare const SINGLE_FILE_MATCHES = 200;
-export interface SearchToolDetails {
+export interface GrepToolDetails {
     truncation?: TruncationResult;
     fileLimitReached?: number;
     perFileLimitReached?: number;
@@ -56,13 +56,13 @@ export interface SearchToolDetails {
     missingPaths?: string[];
 }
 type SearchParams = typeof searchSchema.infer;
-export declare class SearchTool implements AgentTool<typeof searchSchema, SearchToolDetails> {
+export declare class GrepTool implements AgentTool<typeof searchSchema, GrepToolDetails> {
     private readonly session;
-    readonly name = "search";
-    readonly approval: "read";
-    readonly label = "Search";
+    readonly name = "grep";
+    readonly approval: (args: unknown) => ToolTier;
+    readonly label = "Grep";
     readonly loadMode = "discoverable";
-    readonly summary = "Search file contents using ripgrep (fast text search)";
+    readonly summary = "Grep file contents using ripgrep (fast regex search)";
     readonly description: string;
     readonly parameters: import("arktype/internal/variants/object.ts").ObjectType<{
         pattern: string;
@@ -73,26 +73,26 @@ export declare class SearchTool implements AgentTool<typeof searchSchema, Search
     }, {}>;
     readonly strict = true;
     constructor(session: ToolSession);
-    execute(_toolCallId: string, params: SearchParams, signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<SearchToolDetails>, _toolContext?: AgentToolContext): Promise<AgentToolResult<SearchToolDetails>>;
+    execute(_toolCallId: string, params: SearchParams, signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<GrepToolDetails>, _toolContext?: AgentToolContext): Promise<AgentToolResult<GrepToolDetails>>;
 }
-interface SearchRenderArgs {
+interface GrepRenderArgs {
     pattern: string;
     paths?: string | string[];
     case?: boolean;
     gitignore?: boolean;
     skip?: number;
 }
-export declare const searchToolRenderer: {
+export declare const grepToolRenderer: {
     inline: boolean;
-    renderCall(args: SearchRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component;
+    renderCall(args: GrepRenderArgs, _options: RenderResultOptions, uiTheme: Theme): Component;
     renderResult(result: {
         content: Array<{
             type: string;
             text?: string;
         }>;
-        details?: SearchToolDetails;
+        details?: GrepToolDetails;
         isError?: boolean;
-    }, options: RenderResultOptions, uiTheme: Theme, args?: SearchRenderArgs): Component;
+    }, options: RenderResultOptions, uiTheme: Theme, args?: GrepRenderArgs): Component;
     mergeCallAndResult: boolean;
 };
 export {};

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

@@ -23,7 +23,7 @@ import type { AgentOutputManager } from "../task/output-manager";
 import type { DiscoverableTool, DiscoverableToolSearchIndex } from "../tool-discovery/tool-index";
 import type { EventBus } from "../utils/event-bus";
 import type { WorkspaceTree } from "../workspace-tree";
-import type { BuiltinToolName } from "./builtin-names";
+import { type BuiltinToolName } from "./builtin-names";
 import { type CheckpointState } from "./checkpoint";
 import { type TodoPhase } from "./todo";
 export * from "../edit";
@@ -41,8 +41,9 @@ export * from "./checkpoint";
 export * from "./debug";
 export * from "./eval";
 export * from "./eval-backends";
-export * from "./find";
 export * from "./gh";
+export * from "./glob";
+export * from "./grep";
 export * from "./image-gen";
 export * from "./inspect-image";
 export * from "./irc";
@@ -57,7 +58,6 @@ export * from "./read";
 export * from "./report-tool-issue";
 export * from "./resolve";
 export * from "./review";
-export * from "./search";
 export * from "./search-tool-bm25";
 export * from "./ssh";
 export * from "./todo";

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

@@ -58,8 +58,37 @@ export declare function splitInternalUrlSel(rawPath: string): {
     path: string;
     sel?: string;
 };
+/**
+ * Peel a read-tool selector off an internal-URL write target so `write` resolves
+ * the same file `read` does (e.g. `ssh://h/f:raw` -> `ssh://h/f`). Only the
+ * whole-file display modes `raw`/`conflicts` are accepted (they do not change
+ * which bytes are written); any other selector-shaped tail `splitInternalUrlSel`
+ * peels — a line range, a compound like `raw:1-20`, or a malformed `:-N` — throws,
+ * because `write` addresses a whole file, not a partial range, and silently
+ * stripping it would write to a path the caller never named. Non-URL paths and
+ * URLs without a selector pass through unchanged.
+ */
+export declare function peelWriteUrlSelector(rawPath: string): string;
 export declare function normalizeLocalScheme(filePath: string): string;
 export declare function isInternalUrlPath(filePath: string): boolean;
+/**
+ * True when a tool path argument references the `ssh://` scheme anywhere.
+ *
+ * Substring (not anchored) on purpose: it feeds the read/search/write approval
+ * tier, which runs synchronously on the raw args. `search` only flattens a
+ * delimited `paths: "a,ssh://h/x"` into separate entries *after* approval, so an
+ * anchored check would let an embedded `ssh://` slip through at the read tier.
+ * Matching the literal `ssh://` substring also tracks exactly what routes to the
+ * SSH handler; over-matching only over-prompts (fail-closed).
+ */
+export declare function pathTargetsSsh(path: string): boolean;
+/**
+ * True when a path is specifically an `ssh://` URL (anchored scheme match).
+ * Unlike {@link pathTargetsSsh} (substring, for the pre-expansion approval
+ * scan), this is the exact per-entry check used to reject `ssh://` *before* a
+ * side-effecting `InternalUrlRouter.resolve` in tools that need a local file.
+ */
+export declare function isSshUrl(path: string): boolean;
 /**
  * Resolve a path relative to the given cwd.
  * Handles ~ expansion and absolute paths.

package/dist/types/tools/plan-mode-guard.d.ts

@@ -6,6 +6,13 @@ import type { ToolSession } from ".";
  *  resolver surfaces the real error. Exported for callers (e.g. `write`) that
  *  make scheme/bridge-routing decisions before {@link resolvePlanPath} runs. */
 export declare function unwrapHashlineHeaderPath(targetPath: string): string;
+/** True when `targetPath` resolves into the session-local artifact sandbox.
+ *  Routes through {@link resolvePlanPath} so the guard and the eventual write
+ *  always agree on the absolute target (including bracketed hashline headers,
+ *  `local://` URLs, and bare absolute paths). Files inside the sandbox are not
+ *  part of the working tree, so plan mode treats them as freely writable
+ *  scratch/plan space — and tag-based path recovery may rebind onto them. */
+export declare function targetsLocalSandbox(session: ToolSession, targetPath: string): boolean;
 /**
  * Resolve a write/edit target to its absolute filesystem path, honoring the
  * `local://` and `vault://` schemes. Plain paths resolve against the session cwd.

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

@@ -1,4 +1,4 @@
-import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
+import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback, ToolTier } from "@oh-my-pi/pi-agent-core";
 import type { Component } from "@oh-my-pi/pi-tui";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
 import { type Theme } from "../modes/theme/theme";
@@ -53,7 +53,7 @@ export declare class ReadTool implements AgentTool<typeof readSchema, ReadToolDe
     #private;
     private readonly session;
     readonly name = "read";
-    readonly approval: "read";
+    readonly approval: (args: unknown) => ToolTier;
     readonly label = "Read";
     readonly loadMode = "essential";
     readonly description: string;

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

@@ -52,6 +52,14 @@ export declare function expandKeyHint(): string;
  * Get first N lines of text as preview, with each line truncated.
  */
 export declare function getPreviewLines(text: string, maxLines: number, maxLineLen: number, ellipsis?: Ellipsis): string[];
+/**
+ * Collapse a possibly multi-line string into a single line, then truncate it to
+ * `maxWidth` display cells. {@link truncateToWidth} alone caps width but
+ * newlines are zero-width, so multi-line content (markdown briefs, tool args,
+ * provider errors) would otherwise spill a single status row across several
+ * visual lines. Whitespace runs collapse to one space, so tabs are handled too.
+ */
+export declare function previewLine(text: string, maxWidth: number, ellipsis?: Ellipsis): string;
 /**
  * Extract domain from URL, stripping www. prefix.
  */

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

@@ -30,5 +30,16 @@ export type ToolRenderer = {
      * streams rows the result render preserves.
      */
     provisionalPendingPreview?: boolean | "collapsed";
+    /**
+     * Whether the partial-result render is provisional: chrome rows (header
+     * glyph, frame state) that change between `options.isPartial === true` and
+     * the final result render. When `true`, the block is treated as
+     * commit-unstable while a partial result is in flight, so the
+     * stable-prefix ratchet in `deriveLiveCommitState` cannot promote the
+     * partial chrome to native scrollback only to have the final render strand
+     * it above the settled frame. Absent = the partial render is byte-stable
+     * with the final render and may commit like any settled stream.
+     */
+    provisionalPartialResult?: boolean;
 };
 export declare const toolRenderers: Record<string, ToolRenderer>;

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

@@ -62,10 +62,12 @@ export declare const sshToolRenderer: {
             text?: string;
         }>;
         details?: SSHToolDetails;
+        isError?: boolean;
     }, options: RenderResultOptions & {
         renderContext?: SshRenderContext;
     }, uiTheme: Theme, args?: SshRenderArgs): Component;
     mergeCallAndResult: boolean;
     provisionalPendingPreview: string;
+    provisionalPartialResult: boolean;
 };
 export {};

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

@@ -37,22 +37,6 @@ type TodoParams = TodoSchema;
 type TodoSchema = typeof todoSchema.infer;
 export declare const USER_TODO_EDIT_CUSTOM_TYPE = "user_todo_edit";
 export declare function getLatestTodoPhasesFromEntries(entries: SessionEntry[]): TodoPhase[];
-/**
- * Pick the actionable window of tasks to display in the sticky todo panel.
- *
- * Returns up to `maxVisible` open (pending / in_progress) tasks in their
- * original phase order, plus the count of remaining open tasks not shown so
- * 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`.
- *
- * Task identity and order are preserved — this is a slice, never a sort.
- */
-export declare function selectStickyTodoWindow(tasks: TodoItem[], maxVisible?: number): {
-    visible: TodoItem[];
-    hiddenOpenCount: number;
-};
 /**
  * Report whether `content` likely names the same work as any entry in
  * `descriptions`. Used by the sticky todo panel to light up a pending todo

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

@@ -1,4 +1,4 @@
-import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
+import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback, ToolTier } from "@oh-my-pi/pi-agent-core";
 import type { Component } from "@oh-my-pi/pi-tui";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
 import { type FileDiagnosticsResult } from "../lsp";
@@ -30,7 +30,7 @@ export declare class WriteTool implements AgentTool<typeof writeSchema, WriteToo
     #private;
     private readonly session;
     readonly name = "write";
-    readonly approval: (args: unknown) => "read" | "write";
+    readonly approval: (args: unknown) => ToolTier;
     readonly formatApprovalDetails: (args: unknown) => string[];
     readonly label = "Write";
     readonly description: string;

package/dist/types/utils/active-repo-context.d.ts

@@ -0,0 +1,8 @@
+export interface ActiveRepoContext {
+    cwd: string;
+    repoRoot: string;
+    relativeRepoRoot: string;
+    source: "single-direct-child-repo";
+}
+export declare function resolveActiveRepoContext(cwd: string): Promise<ActiveRepoContext | null>;
+export declare function resolveActiveRepoContextSync(cwd: string): ActiveRepoContext | null;

package/dist/types/utils/image-resize.d.ts

@@ -16,6 +16,7 @@ export interface ResizedImage {
     width: number;
     height: number;
     wasResized: boolean;
+    decodeFailed?: boolean;
     get data(): string;
 }
 /**

package/dist/types/utils/markit-cache.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Cache schema/format revision. Bumping it changes the on-disk key prefix
+ * (`v<N>-...`), so old entries become unreachable and are pruned naturally.
+ * Bump when the cache *file* shape changes (entry JSON layout, key scheme).
+ *
+ * Converter *output* changes are handled separately: the package version is
+ * folded into the key (see {@link markitConversionCacheKey}), so any release
+ * that ships new markdown from `src/markit/converters/*` auto-invalidates the
+ * cache without a manual bump here.
+ */
+export declare const MARKIT_CONVERSION_CACHE_VERSION = 1;
+export declare const MAX_MARKIT_CONVERSION_CACHE_BYTES: number;
+export type MarkitConversionCacheStatus = "hit" | "miss" | "skipped";
+export type MarkitConversionCacheReadResult = {
+    status: "hit";
+    content: string;
+} | {
+    status: "miss";
+};
+export declare function markitConversionCacheKey(bytes: Uint8Array, extension: string): string;
+export declare function readMarkitConversionCache(key: string): Promise<MarkitConversionCacheReadResult>;
+export declare function pruneMarkitConversionCache(cacheDir: string): Promise<void>;
+export declare function writeMarkitConversionCache(key: string, content: string): Promise<void>;

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

@@ -1,7 +1,9 @@
+import { type MarkitConversionCacheStatus } from "./markit-cache";
 export interface MarkitConversionResult {
     content: string;
     ok: boolean;
     error?: string;
+    cache?: MarkitConversionCacheStatus;
 }
 export interface MarkitFileConversionOptions {
     /**
@@ -13,4 +15,6 @@ export interface MarkitFileConversionOptions {
     imageDir?: string;
 }
 export declare function convertFileWithMarkit(filePath: string, signal?: AbortSignal, options?: MarkitFileConversionOptions): Promise<MarkitConversionResult>;
-export declare function convertBufferWithMarkit(buffer: Uint8Array, extension: string, signal?: AbortSignal): Promise<MarkitConversionResult>;
+export declare function convertBufferWithMarkit(buffer: Uint8Array, extension: string, signal?: AbortSignal, options?: {
+    useCache?: boolean;
+}): Promise<MarkitConversionResult>;

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

@@ -0,0 +1 @@
+export declare function normalizePromptPath(value: string): string;

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

@@ -0,0 +1,14 @@
+import type { AuthStorage } from "@oh-my-pi/pi-ai";
+import type { SearchResponse } from "../../../web/search/types";
+import type { SearchParams } from "./base";
+import { SearchProvider } from "./base";
+/** Execute DuckDuckGo Instant Answer API search. */
+export declare function searchDuckDuckGo(params: SearchParams): Promise<SearchResponse>;
+/** Search provider for DuckDuckGo Instant Answer API. */
+export declare class DuckDuckGoProvider extends SearchProvider {
+    readonly id = "duckduckgo";
+    readonly label = "DuckDuckGo";
+    isAvailable(_authStorage: AuthStorage): boolean;
+    isExplicitlyAvailable(_authStorage: AuthStorage): boolean;
+    search(params: SearchParams): Promise<SearchResponse>;
+}

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

@@ -0,0 +1,28 @@
+/**
+ * Firecrawl Web Search Provider
+ *
+ * Calls Firecrawl's search API and maps web results into the unified
+ * SearchResponse shape used by the web search tool.
+ */
+import { type AuthStorage, type FetchImpl } from "@oh-my-pi/pi-ai";
+import type { SearchResponse } from "../../../web/search/types";
+import type { SearchParams } from "./base";
+import { SearchProvider } from "./base";
+export interface FirecrawlSearchParams {
+    query: string;
+    num_results?: number;
+    recency?: SearchParams["recency"];
+    signal?: AbortSignal;
+    fetch?: FetchImpl;
+}
+/** Resolve Firecrawl API key through the shared auth storage pipeline. */
+export declare function findApiKey(authStorage: AuthStorage, sessionId?: string, signal?: AbortSignal): Promise<string | undefined>;
+/** Execute Firecrawl web search. */
+export declare function searchFirecrawl(params: SearchParams): Promise<SearchResponse>;
+/** Search provider for Firecrawl web search. */
+export declare class FirecrawlProvider extends SearchProvider {
+    readonly id = "firecrawl";
+    readonly label = "Firecrawl";
+    isAvailable(authStorage: AuthStorage): boolean;
+    search(params: SearchParams): Promise<SearchResponse>;
+}

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

@@ -0,0 +1,29 @@
+/**
+ * TinyFish Web Search Provider
+ *
+ * Calls TinyFish's search API and maps results into the unified
+ * SearchResponse shape used by the web search tool.
+ */
+import { type AuthStorage, type FetchImpl } from "@oh-my-pi/pi-ai";
+import type { SearchResponse } from "../../../web/search/types";
+import type { SearchParams } from "./base";
+import { SearchProvider } from "./base";
+export interface TinyFishSearchParams {
+    query: string;
+    num_results?: number;
+    recency?: SearchParams["recency"];
+    page?: number;
+    signal?: AbortSignal;
+    fetch?: FetchImpl;
+}
+/** Resolve TinyFish API key through the shared auth storage pipeline. */
+export declare function findApiKey(authStorage: AuthStorage, sessionId?: string, signal?: AbortSignal): Promise<string | undefined>;
+/** Execute TinyFish web search. */
+export declare function searchTinyFish(params: SearchParams): Promise<SearchResponse>;
+/** Search provider for TinyFish web search. */
+export declare class TinyFishProvider extends SearchProvider {
+    readonly id = "tinyfish";
+    readonly label = "TinyFish";
+    isAvailable(authStorage: AuthStorage): boolean;
+    search(params: SearchParams): Promise<SearchResponse>;
+}

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

@@ -0,0 +1,13 @@
+import { type AuthStorage } from "@oh-my-pi/pi-ai";
+import type { SearchResponse } from "../../../web/search/types";
+import type { SearchParams } from "./base";
+import { SearchProvider } from "./base";
+/** Execute xAI Responses API web search. */
+export declare function searchXAI(params: SearchParams): Promise<SearchResponse>;
+/** Search provider for xAI web search. */
+export declare class XAIProvider extends SearchProvider {
+    readonly id = "xai";
+    readonly label = "xAI";
+    isAvailable(authStorage: AuthStorage): boolean;
+    search(params: SearchParams): Promise<SearchResponse>;
+}

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

@@ -23,6 +23,10 @@ export declare const SEARCH_PROVIDER_OPTIONS: readonly [{
     readonly value: "codex";
     readonly label: "OpenAI";
     readonly description: "OpenAI's native web_search (uses ChatGPT OAuth via /login openai-codex)";
+}, {
+    readonly value: "xai";
+    readonly label: "xAI";
+    readonly description: "Grok web search via xAI Responses API (requires XAI_API_KEY)";
 }, {
     readonly value: "zai";
     readonly label: "Z.AI";
@@ -31,6 +35,10 @@ export declare const SEARCH_PROVIDER_OPTIONS: readonly [{
     readonly value: "exa";
     readonly label: "Exa";
     readonly description: "Uses Exa API when EXA_API_KEY is set; falls back to Exa MCP";
+}, {
+    readonly value: "tinyfish";
+    readonly label: "TinyFish";
+    readonly description: "Requires TINYFISH_API_KEY";
 }, {
     readonly value: "jina";
     readonly label: "Jina";
@@ -43,6 +51,10 @@ export declare const SEARCH_PROVIDER_OPTIONS: readonly [{
     readonly value: "tavily";
     readonly label: "Tavily";
     readonly description: "Requires TAVILY_API_KEY";
+}, {
+    readonly value: "firecrawl";
+    readonly label: "Firecrawl";
+    readonly description: "Requires FIRECRAWL_API_KEY";
 }, {
     readonly value: "brave";
     readonly label: "Brave";
@@ -63,6 +75,10 @@ export declare const SEARCH_PROVIDER_OPTIONS: readonly [{
     readonly value: "searxng";
     readonly label: "SearXNG";
     readonly description: "Requires SEARXNG_ENDPOINT or searxng.endpoint";
+}, {
+    readonly value: "duckduckgo";
+    readonly label: "DuckDuckGo";
+    readonly description: "Uses DuckDuckGo Instant Answer API (no API key)";
 }];
 /** Supported web search providers (every option except `auto`). */
 export type SearchProviderId = Exclude<(typeof SEARCH_PROVIDER_OPTIONS)[number]["value"], "auto">;
@@ -88,7 +104,7 @@ export interface SearchSource {
     ageSeconds?: number;
     author?: string;
 }
-/** Citation with text reference (anthropic, perplexity) */
+/** Citation with text reference (LLM-mediated providers) */
 export interface SearchCitation {
     url: string;
     title: string;
@@ -106,7 +122,7 @@ export interface SearchUsage {
 /** Unified response across providers */
 export interface SearchResponse {
     provider: SearchProviderId | "none";
-    /** Synthesized answer text (anthropic, perplexity) */
+    /** Synthesized answer text (LLM-mediated providers) */
     answer?: string;
     /** Search result sources */
     sources: SearchSource[];

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "16.1.22",
+	"version": "16.2.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -39,26 +39,33 @@
 		"fix": "biome check --write --unsafe . && bun run format-prompts",
 		"fmt": "biome format --write . && bun run format-prompts",
 		"format-prompts": "bun scripts/format-prompts.ts",
-		"generate-docs-index": "bun scripts/generate-docs-index.ts --generate",
-		"prepack": "bun scripts/generate-docs-index.ts --generate && bun --cwd=../collab-web run build:tool-views && bun scripts/bundle-dist.ts || ( bun scripts/generate-docs-index.ts --reset; exit 1 )",
-		"postpack": "bun scripts/generate-docs-index.ts --reset",
+		"gen:docs": "bun scripts/generate-docs-index.ts --generate",
+		"gen:docs:reset": "bun scripts/generate-docs-index.ts --reset",
+		"gen:tool-views": "bun --cwd=../collab-web run gen:tool-views",
+		"gen:bundle": "bun scripts/bundle-dist.ts",
+		"gen:mupdf": "bun scripts/embed-mupdf-wasm.ts --generate",
+		"gen:mupdf:reset": "bun scripts/embed-mupdf-wasm.ts --reset",
+		"gen:native": "bun --cwd=../natives run gen:native",
+		"gen:native:reset": "bun --cwd=../natives run gen:native:reset",
+		"prepack": "bun run gen:docs && bun run gen:tool-views && bun run gen:bundle || ( bun run gen:docs:reset; exit 1 )",
+		"postpack": "bun run gen:docs:reset",
 		"bench:guard": "bun scripts/bench-guard.ts"
 	},
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.25.0",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "16.1.22",
-		"@oh-my-pi/omp-stats": "16.1.22",
-		"@oh-my-pi/pi-agent-core": "16.1.22",
-		"@oh-my-pi/pi-ai": "16.1.22",
-		"@oh-my-pi/pi-catalog": "16.1.22",
-		"@oh-my-pi/pi-mnemopi": "16.1.22",
-		"@oh-my-pi/pi-natives": "16.1.22",
-		"@oh-my-pi/pi-tui": "16.1.22",
-		"@oh-my-pi/pi-utils": "16.1.22",
-		"@oh-my-pi/pi-wire": "16.1.22",
-		"@oh-my-pi/snapcompact": "16.1.22",
+		"@oh-my-pi/hashline": "16.2.0",
+		"@oh-my-pi/omp-stats": "16.2.0",
+		"@oh-my-pi/pi-agent-core": "16.2.0",
+		"@oh-my-pi/pi-ai": "16.2.0",
+		"@oh-my-pi/pi-catalog": "16.2.0",
+		"@oh-my-pi/pi-mnemopi": "16.2.0",
+		"@oh-my-pi/pi-natives": "16.2.0",
+		"@oh-my-pi/pi-tui": "16.2.0",
+		"@oh-my-pi/pi-utils": "16.2.0",
+		"@oh-my-pi/pi-wire": "16.2.0",
+		"@oh-my-pi/snapcompact": "16.2.0",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/context-async-hooks": "^2.7.1",
 		"@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",
@@ -375,6 +382,14 @@
 			"types": "./dist/types/lsp/clients/*.d.ts",
 			"import": "./src/lsp/clients/*.ts"
 		},
+		"./markit": {
+			"types": "./dist/types/markit/index.d.ts",
+			"import": "./src/markit/index.ts"
+		},
+		"./markit/*": {
+			"types": "./dist/types/markit/*.d.ts",
+			"import": "./src/markit/*.ts"
+		},
 		"./mcp": {
 			"types": "./dist/types/mcp/index.d.ts",
 			"import": "./src/mcp/index.ts"

package/scripts/bench-guard.ts

@@ -22,7 +22,7 @@ import * as path from "node:path";
 
 const THRESHOLD = 1.05; // 5% regression budget
 const BASELINE_PATH = path.join(import.meta.dir, "..", "bench", "boot-baseline.json");
-const BENCH_COMMAND = "PI_TIMING=x bun src/cli.ts";
+const BENCH_COMMAND = "PI_TIMING=x PI_STRICT_EDIT_MODE=1 bun src/cli.ts";
 const cwd = path.join(import.meta.dir, "..");
 
 function medianOf(hyperfineJson: string): number {