@oh-my-pi/pi-coding-agent 17.0.9 → 17.1.1

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

@@ -0,0 +1,38 @@
+/**
+ * Image Generation Providers
+ *
+ * Leaf module (no runtime deps) shared by the image_gen tool, the settings
+ * schema, and settings migrations — mirrors `web/search/types.ts` so the
+ * provider list, auto order, and settings choices never drift apart.
+ */
+/** Image generation backends, in settings/tool vocabulary. */
+export type ImageProvider = "antigravity" | "gemini" | "openai" | "openai-codex" | "openrouter" | "xai";
+/** Auto-resolution fallback order when no configured entry or session provider matches. */
+export declare const AUTO_IMAGE_PROVIDER_ORDER: readonly ImageProvider[];
+/** Settings choices for `providers.imageOrder` (labels shared with the retired single-preference enum). */
+export declare const IMAGE_PROVIDER_CHOICES: readonly [{
+    readonly value: "openai";
+    readonly label: "OpenAI";
+    readonly description: "OPENAI_API_KEY (gpt-image-2) or active GPT model; falls back to a connected Codex subscription";
+}, {
+    readonly value: "openai-codex";
+    readonly label: "OpenAI Codex (ChatGPT)";
+    readonly description: "Uses a connected Codex / ChatGPT subscription — no OPENAI_API_KEY needed";
+}, {
+    readonly value: "antigravity";
+    readonly label: "Antigravity";
+    readonly description: "Requires google-antigravity OAuth";
+}, {
+    readonly value: "xai";
+    readonly label: "xAI Grok Imagine";
+    readonly description: "Requires xAI Grok OAuth or XAI_API_KEY";
+}, {
+    readonly value: "gemini";
+    readonly label: "Gemini";
+    readonly description: "Requires GEMINI_API_KEY";
+}, {
+    readonly value: "openrouter";
+    readonly label: "OpenRouter";
+    readonly description: "Requires OPENROUTER_API_KEY";
+}];
+export declare function isImageProviderId(value: unknown): value is ImageProvider;

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

@@ -19,6 +19,7 @@ import type { ArtifactManager } from "../session/artifacts.js";
 import type { ClientBridge } from "../session/client-bridge.js";
 import type { CustomMessage } from "../session/messages.js";
 import type { UsageStatistics } from "../session/session-entries.js";
+import type { SessionManager } from "../session/session-manager.js";
 import type { ToolChoiceQueue } from "../session/tool-choice-queue.js";
 import type { AgentOutputManager } from "../task/output-manager.js";
 import { type StructuredSubagentSchemaMode } from "../task/types.js";
@@ -41,6 +42,8 @@ export * from "./ast-grep.js";
 export * from "./bash.js";
 export * from "./browser.js";
 export * from "./checkpoint.js";
+export * from "./computer.js";
+export * from "./computer/supervisor.js";
 export * from "./debug.js";
 export * from "./essential-tools.js";
 export * from "./eval.js";
@@ -106,6 +109,8 @@ export interface DeferredDiagnosticsEntry {
 export interface ToolSession {
     /** Current working directory */
     cwd: string;
+    /** Additional workspace directories beyond cwd (multi-root), forwarded to subagents. */
+    additionalDirectories?: string[];
     /** Whether UI is available */
     hasUI: boolean;
     /**
@@ -177,6 +182,8 @@ export interface ToolSession {
     getEvalSessionId?: () => string | null;
     /** Get session file */
     getSessionFile: () => string | null;
+    /** Parent session journal used by tools that persist runtime lifecycle state. */
+    sessionManager?: Pick<SessionManager, "appendCustomEntry" | "ensureOnDisk" | "flush" | "getBranch" | "getEntries">;
     /** Get eval kernel owner ID for session-scoped retained-kernel cleanup. */
     getEvalKernelOwnerId?: () => string | null;
     /** Reject new eval work once session disposal has started. */

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

@@ -236,6 +236,14 @@ export declare function partitionExistingPaths(items: string[], cwd: string, spl
     basePath: string;
 }): Promise<PartitionedPaths>;
 export declare function resolveReadPath(filePath: string, cwd: string): string;
+/**
+ * Find a unique workspace entry whose trailing path matches a missing authored path.
+ * Returns `null` for no match, ambiguity, timeout, or scan failure.
+ */
+export declare function findUniqueWorkspaceSuffix(rawPath: string, cwd: string, signal?: AbortSignal): Promise<{
+    absolutePath: string;
+    displayPath: string;
+} | null>;
 /** Local file materialized from a readable external URL for shared tool-scope resolution. */
 export interface ResolvedExternalSearchUrl {
     /** Absolute or cwd-relative file path to search. */

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

@@ -5,17 +5,21 @@ import type { RenderResultOptions } from "../extensibility/custom-tools/types.js
 import type { Theme } from "../modes/theme/theme.js";
 import type { ToolSession } from "../sdk.js";
 import type { SessionEntry } from "../session/session-entries.js";
-export type TodoStatus = "pending" | "in_progress" | "completed" | "abandoned";
+export type TodoStatus = "pending" | "in_progress" | "completed" | "abandoned" | "blocked";
 /** Operation names accepted by the todo tool and echoed in successful result details. */
-export type TodoOperation = "init" | "start" | "done" | "rm" | "drop" | "append" | "view";
+export type TodoOperation = "init" | "start" | "done" | "rm" | "drop" | "block" | "unblock" | "append" | "view";
 export interface TodoItem {
     content: string;
     status: TodoStatus;
+    /** When `status === "blocked"`, an optional note on what the task is waiting for. */
+    blocker?: string;
 }
 export interface TodoPhase {
     name: string;
     tasks: TodoItem[];
 }
+/** Whether an unknown value is a persisted todo phase. */
+export declare function isTodoPhase(value: unknown): value is TodoPhase;
 export interface TodoCompletionTransition {
     phase: string;
     content: string;
@@ -28,7 +32,7 @@ export interface TodoToolDetails {
     completedTasks?: TodoCompletionTransition[];
 }
 declare const todoSchema: import("arktype/internal/variants/object.ts").ObjectType<{
-    op: "append" | "done" | "drop" | "init" | "rm" | "start" | "view";
+    op: "append" | "block" | "done" | "drop" | "init" | "rm" | "start" | "unblock" | "view";
     list?: {
         phase: string;
         items: string[];
@@ -36,6 +40,7 @@ declare const todoSchema: import("arktype/internal/variants/object.ts").ObjectTy
     task?: string | undefined;
     phase?: string | undefined;
     items?: string[] | undefined;
+    reason?: string | undefined;
 }, {}>;
 type TodoParams = TodoSchema;
 type TodoSchema = typeof todoSchema.infer;
@@ -107,7 +112,7 @@ export declare class TodoTool implements AgentTool<typeof todoSchema, TodoToolDe
     readonly summary = "Write a structured todo list to track progress within a session";
     readonly description: string;
     readonly parameters: import("arktype/internal/variants/object.ts").ObjectType<{
-        op: "append" | "done" | "drop" | "init" | "rm" | "start" | "view";
+        op: "append" | "block" | "done" | "drop" | "init" | "rm" | "start" | "unblock" | "view";
         list?: {
             phase: string;
             items: string[];
@@ -115,6 +120,7 @@ export declare class TodoTool implements AgentTool<typeof todoSchema, TodoToolDe
         task?: string | undefined;
         phase?: string | undefined;
         items?: string[] | undefined;
+        reason?: string | undefined;
     }, {}>;
     readonly concurrency = "exclusive";
     readonly strict = true;

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

@@ -47,6 +47,8 @@ export declare const XDEV_KEEP_TOP_LEVEL: Record<string, true>;
  * declared `loadMode`.
  */
 export declare const XDEV_TRANSPORT_TOOLS: Record<string, true>;
+/** Controls which mounted-device docs are inlined into the system prompt. */
+export type XdevDocsMode = "inline" | "builtins" | "catalog";
 /**
  * Whether an enabled tool is presented under `xd://` (rather than top-level)
  * while the `xd://` transport is active. Discoverable tools mount unless they
@@ -120,7 +122,9 @@ export declare class XdevRegistry {
      * Dynamic mounts embed at most {@link EXTERNAL_DESCRIPTION_CAP} description
      * chars (schema always intact); `read xd://<tool>` returns the full text.
      */
-    docsAll(): string;
+    docsAll(mode?: XdevDocsMode, inlinePatterns?: readonly string[]): string;
+    /** Docs for selected mounted devices under the configured prompt-doc policy. */
+    docsFor(names: Iterable<string>, mode: XdevDocsMode, inlinePatterns?: readonly string[]): string;
     /**
      * Execute a device write: `content` is the JSON args object (empty, `?`, or
      * `help` returns docs). Args validate against the wrapped tool's schema —

package/dist/types/tts/streaming-player.d.ts

@@ -1,40 +1,21 @@
-import { type PlayerCommand } from "./player.js";
-/** Output gain applied while ducked (the user is speaking over the assistant). */
+/** Output gain applied while the user speaks over assistant audio. */
 export declare const DUCK_GAIN = 0.25;
-/** Injection seam for {@link streamingPlayerCommandsFor} — defaults to real PATH/tools lookups. */
-export interface StreamingPlayerLookup {
-    which?: (bin: string) => string | null;
-    ffmpeg?: () => string | null;
-}
-/**
- * Ordered candidate commands for a persistent raw-PCM player on `platform`: each
- * reads 32-bit-float little-endian mono PCM at `sampleRate` from stdin (`pipe:0`)
- * and plays it to the default output device. An empty list means no streaming
- * backend is available and the caller should fall back to per-file playback.
- *
- * - darwin: `ffmpeg` (AudioToolbox output device) → sox's `play` (coreaudio).
- * - linux/other POSIX: `ffmpeg` (`-f pulse` then `-f alsa`) → `paplay`/`aplay`
- *   raw fallbacks.
- * - win32: none (PowerShell `SoundPlayer` is file-only).
- */
-export declare function streamingPlayerCommandsFor(platform: NodeJS.Platform, sampleRate: number, lookup?: StreamingPlayerLookup): PlayerCommand[];
 /**
- * Single-session gapless player. Lifecycle: {@link start} once, {@link write}
- * chunks in order, then {@link end} to drain or {@link stop} to abort. Not
- * reusable after stop/end — create a new instance per utterance.
+ * One native gapless playback session. Call {@link start}, enqueue mono `f32`
+ * chunks with {@link write}, then {@link end} to drain or {@link stop} to abort.
  */
 export declare class StreamingAudioPlayer {
     #private;
-    /** Pick a backend and begin draining. Idempotent; the first call's rate wins. */
-    start(sampleRate: number): void;
-    /** Queue a mono float32 PCM chunk for playback in arrival order. */
+    /** Opens the default speaker at the stream's logical sample rate. */
+    start(sampleRate?: number): void;
+    /** Queues one mono `f32` PCM chunk without copying it in TypeScript. */
     write(pcm: Float32Array): void;
-    /** Scale subsequent output (1 = normal, <1 = ducked). Applies within {@link LEAD_SECONDS}. */
+    /** Applies gain at render time, including to samples already queued natively. */
     setGain(gain: number): void;
-    /** Close the input; resolves once all queued audio has finished playing. */
+    /** Closes input and resolves after every queued sample reaches the speaker. */
     end(): Promise<void>;
-    /** Stop immediately: kill the player, drop everything still queued. */
+    /** Stops immediately and discards queued audio. Safe to call repeatedly. */
     stop(): void;
 }
-/** Factory the vocalizer calls; a function so tests can stub it without spawning a player. */
+/** Creates the single-use player used by the speech vocalizer. */
 export declare function createStreamingPlayer(): StreamingAudioPlayer;

package/dist/types/tts/vocalizer.d.ts

@@ -11,6 +11,11 @@ export declare class Vocalizer {
     constructor(createPlayer?: () => VocalizerPlayer);
     /** Wire (or drop) the per-session enhanced-rewrite service. */
     setEnhancer(enhancer: SpeechEnhancer | null): void;
+    /**
+     * Suppress new vocalization until the returned idempotent release function runs.
+     * Existing synthesis and playback stop immediately; nested scopes release independently.
+     */
+    suspend(): () => void;
     /**
      * Stream a delta of assistant text into the pipeline. No-op when
      * vocalization is disabled. The synthesis session (worker, player) is only

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

@@ -1,3 +1,4 @@
+import * as git from "./git.js";
 /** Result from a completed `jj` subprocess invocation. */
 export interface JjCommandResult {
     /** Process exit code reported by `jj`. */
@@ -32,14 +33,41 @@ export declare class JjCommandError extends Error {
     /** Create an error for a failed checked `jj` command. */
     constructor(args: readonly string[], result: JjCommandResult);
 }
+declare function parseWorkingCopyLabel(raw: string): string | null;
+declare function parseStatusSummary(raw: string): git.GitStatusSummary;
 /** Run `jj diff --git` for the current workspace commit and return the raw Git-format diff text. */
 export declare const diff: ((cwd: string, options?: DiffOptions) => Promise<string>) & {
     /** List changed file paths. */
     changedFiles(cwd: string, options?: Pick<DiffOptions, "files" | "signal">): Promise<string[]>;
 };
+/** Jujutsu working-copy metadata used by status displays. */
+export declare const workingCopy: {
+    /**
+     * Label `@` with its nearest bookmark, falling back to its short change ID.
+     * Returns `null` when `jj` is unavailable or the query fails.
+     */
+    label(cwd: string, signal?: AbortSignal): Promise<string | null>;
+    /** Parse working-copy label query output. */
+    parseLabel: typeof parseWorkingCopyLabel;
+};
+/** Jujutsu working-copy status derived from the changes in `@`. */
+export declare const status: {
+    /**
+     * Count changes in `@` relative to its parent using the Git status shape.
+     * Jujutsu has no index, so `staged` is always zero.
+     */
+    summary(cwd: string, signal?: AbortSignal): Promise<git.GitStatusSummary | null>;
+    /** Parse `jj diff --summary` output into status counts. */
+    parse: typeof parseStatusSummary;
+};
 export declare const repo: {
     /** Clear cached workspace roots. Intended for tests that mutate JJ metadata under an existing path. */
     clearRootCache(): void;
+    /**
+     * Resolve the current workspace root synchronously from on-disk metadata.
+     * Intended for render paths that cannot await filesystem I/O.
+     */
+    rootSync(cwd: string): string | null;
     /** Resolve the current Jujutsu workspace root, or `null` when `cwd` is not in a JJ repository. */
     root(cwd: string): Promise<string | null>;
     /** Full Jujutsu workspace metadata. */
@@ -72,3 +100,4 @@ export declare const repo: {
  * - `false` for directories backed by neither tool.
  */
 export declare function isPureJjRepo(cwd: string): Promise<boolean>;
+export {};

package/dist/types/utils/lang-from-path.d.ts

@@ -2,6 +2,7 @@
  * Language id for syntax highlighting and UI (icons, read tool), or undefined if unknown.
  */
 export declare function getLanguageFromPath(filePath: string): string | undefined;
+export declare function isMarkdownPath(filePath: string): boolean;
 /**
  * LSP language identifier; falls back to `plaintext`.
  */

package/dist/types/utils/title-generator.d.ts

@@ -24,6 +24,36 @@ export declare function formatSessionTerminalTitle(sessionName: string | undefin
  */
 export declare function setTerminalTitle(title: string): void;
 export declare function setSessionTerminalTitle(sessionName: string | undefined, cwd?: string): void;
+/**
+ * Set a terminal title from an extension's `setTitle()`. Unlike the session base
+ * title, this owns the terminal verbatim: the run-state separator will not rewrite
+ * it on the next spinner tick or state change. Cleared when the app next sets an
+ * authoritative session title via {@link setSessionTerminalTitle}.
+ */
+export declare function setExtensionTerminalTitle(title: string): void;
+export type TerminalTitleState = "idle" | "working" | "attention";
+/**
+ * Compose the terminal title from the `π` brand, a state-carrying SEPARATOR, and
+ * the session label. The brand never gains a prefix glyph — the separator slot
+ * expresses the run state instead. Pure (no I/O) so the state→separator contract
+ * is unit-testable:
+ *   - `idle` (user's turn):  `π > label`  — reads like a prompt awaiting input;
+ *   - `working`:             `π ⠋ label`  — spinner frames animate the separator;
+ *   - `attention`:           `π ! label`  — agent blocked on the user;
+ *   - disabled:              `π: label`   — the pre-state layout.
+ * Without a label the separator trails the brand (`π >`) so the state stays visible.
+ */
+export declare function buildTerminalTitleWithState(label: string | undefined, state: TerminalTitleState, frame: number, enabled: boolean): string;
+/**
+ * Reflect the agent run state in the terminal title's separator: `working`
+ * animates spinner frames in the separator slot, `idle` shows `>` (your turn),
+ * `attention` shows `!` (agent blocked on you). Gated off by `tui.titleState`.
+ */
+export declare function setTerminalTitleState(state: TerminalTitleState): void;
+/** Enable/disable the run-state separator (driven by the `tui.titleState` setting). */
+export declare function setTerminalTitleStateEnabled(enabled: boolean): void;
+/** Stop the spinner timer; call on session/UI teardown. */
+export declare function disposeTerminalTitleState(): void;
 /**
  * Save the current terminal title on terminals that support xterm window ops.
  */

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

@@ -1,5 +1,4 @@
-export declare function ffmpegAssetName(_version: string, plat: string, architecture: string): string | null;
-export type ToolName = "sd" | "sg" | "yt-dlp" | "trafilatura" | "ffmpeg";
+export type ToolName = "sd" | "sg" | "yt-dlp" | "trafilatura";
 export declare function getToolPath(tool: ToolName): string | null;
 /** Download a tool asset without handing the streaming Response to Bun.write. */
 export declare function downloadFile(url: string, dest: string, signal?: AbortSignal): Promise<void>;

package/dist/types/vibe/runtime.d.ts

@@ -1,4 +1,6 @@
 import type { AsyncJobManager } from "../async/job-manager.js";
+import type { SessionEntry } from "../session/session-entries.js";
+import { SessionManager } from "../session/session-manager.js";
 import type { ToolSession } from "../tools/index.js";
 /** The two worker CLI flavors the director drives. */
 export type VibeCli = "fast" | "good";
@@ -12,6 +14,21 @@ export type VibeCli = "fast" | "good";
 export declare const VIBE_CLI_AGENT: Record<VibeCli, string>;
 /** Worker session lifecycle as shown to the director. */
 export type VibeSessionState = "starting" | "running" | "idle" | "dead";
+export interface VibeOwnerScope {
+    ownerId: string;
+    parentSessionId: string;
+    parentSessionFile: string | null;
+}
+export interface VibeParentSession {
+    getAgentId?: () => string | null;
+    getSessionId?: () => string | null;
+    getSessionFile: () => string | null;
+    sessionManager?: ToolSession["sessionManager"] & Partial<Pick<SessionManager, "appendModeChange" | "appendEntriesAtomically" | "recoverPersistenceFromCurrentState">>;
+    asyncJobManager?: AsyncJobManager;
+    settings: ToolSession["settings"];
+    getActiveModelString?: () => string | undefined;
+    getModelString?: () => string | undefined;
+}
 /**
  * Live per-session "screen" for rich rendering: what the worker is doing right
  * now (tool trace, current tool, streamed text tail) plus roster metadata.
@@ -70,13 +87,15 @@ export interface VibeWaitOutcome {
     stillRunning: string[];
     timedOut: boolean;
 }
+/** Child ids claimed by any valid Vibe spawn event, independent of current parent scope. */
+export declare function persistedVibeChildIds(entries: Iterable<SessionEntry>): Set<string>;
 /** Thrown from a turn job body so the job manager marks the job failed while carrying the formatted result. */
 export declare class VibeTurnError extends Error {
 }
 /**
- * Process-global registry of vibe worker sessions, scoped per owner agent id
- * (same convention as AsyncJobManager owner filters). The interactive mode
- * kills an owner's sessions on vibe-mode exit via {@link killAll}.
+ * Process-global registry of vibe worker sessions, scoped by both owner agent
+ * id and stable parent session id. Persisted lifecycle events rebuild idle
+ * records after a process restart; live turn jobs remain process-local.
  */
 export declare class VibeSessionRegistry {
     #private;
@@ -94,14 +113,21 @@ export declare class VibeSessionRegistry {
         ownerId: string;
         state?: VibeSessionState;
     }): void;
-    listIds(owner: string): string[];
+    ownerScope(session: VibeParentSession): VibeOwnerScope;
+    /** Re-open spawn admission after an explicit Vibe-mode entry. */
+    activateScope(scope: VibeOwnerScope): void;
+    listIds(session: ToolSession): string[];
+    /** Ids of every live worker owned by `ownerId`, across all parent scopes (status-line tok/s aggregation). */
+    listIdsByOwner(ownerId: string): string[];
     /**
      * Live screen snapshots for rich rendering (the "TV wall"): one entry per
      * session in creation order, carrying the in-flight turn's trace, current
      * tool, and streamed text tail. All strings are one-line sanitized here so
      * renderers can print them verbatim.
      */
-    screens(owner: string, ids?: string[]): VibeScreenSnapshot[];
+    screens(session: ToolSession, ids?: string[]): VibeScreenSnapshot[];
+    /** Reconcile resumable and terminal workers from the persisted parent journal. */
+    rehydrate(session: VibeParentSession): Promise<number>;
     /** Spawn a persistent worker session and start its first turn in the background. */
     spawn(session: ToolSession, args: {
         cli: VibeCli;
@@ -128,10 +154,12 @@ export declare class VibeSessionRegistry {
         timeoutMs?: number;
         signal?: AbortSignal;
     }): Promise<VibeWaitOutcome>;
-    /** Terminate a worker: cancel its in-flight turn and dispose + unregister its session. */
+    /** Detach one parent's process-local workers without tombstoning their persisted conversations. */
+    suspendScope(scope: VibeOwnerScope, manager?: AsyncJobManager): Promise<number>;
+    /** Terminate one worker; a tombstone failure still tears it down before reconciliation and error delivery. */
     kill(session: ToolSession, id: string): Promise<VibeKillOutcome>;
-    /** Kill every session belonging to `owner` (vibe-mode exit / teardown). Returns the number killed. */
-    killAll(owner: string, manager?: AsyncJobManager): Promise<number>;
+    /** Kill every live session in one parent scope after durably recording the complete mode-exit intent. */
+    killAll(session: VibeParentSession, ownerScope?: VibeOwnerScope): Promise<number>;
 }
 /**
  * Aggregate tok/s across every live vibe worker session owned by `ownerId`.

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

@@ -71,6 +71,6 @@ export declare class WebSearchTool implements AgentTool<typeof webSearchSchema,
 /** Web search tool as CustomTool (for TUI rendering support) */
 export declare const webSearchCustomTool: CustomTool<typeof webSearchSchema, SearchRenderDetails>;
 export declare function getSearchTools(): CustomTool<any, any>[];
-export { getSearchProvider, setExcludedSearchProviders, setPreferredSearchProvider } from "./provider.js";
+export { getSearchProvider, setExcludedSearchProviders, setSearchProviderOrder } from "./provider.js";
 export type { SearchProviderId as SearchProvider, SearchResponse } from "./types.js";
 export { isSearchProviderId, isSearchProviderPreference } from "./types.js";

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

@@ -18,8 +18,14 @@ export declare function formatSearchProviderFailures(failures: readonly {
  * underlying module; subsequent calls return the cached singleton.
  */
 export declare function getSearchProvider(id: SearchProviderId): Promise<SearchProvider>;
-/** Set the preferred web search provider from settings */
-export declare function setPreferredSearchProvider(provider: SearchProviderId | "auto"): void;
+/**
+ * Prioritize configured providers while retaining every unlisted provider in
+ * its built-in relative order. Invalid IDs are ignored defensively. Listed
+ * providers are treated as explicit selections: they resolve through
+ * `isExplicitlyAvailable`, so e.g. a hand-listed Perplexity may fall back to
+ * anonymous search exactly like the retired single-preference setting did.
+ */
+export declare function setSearchProviderOrder(providers: readonly SearchProviderId[]): void;
 /** Set providers that web search should never use, including fallbacks. */
 export declare function setExcludedSearchProviders(providers: readonly SearchProviderId[]): void;
 /** `true` when settings exclude `id` from web search (auto chain and the Public Web fan-out). */
@@ -28,12 +34,16 @@ export interface SearchProviderCandidate {
     id: SearchProviderId;
     explicit: boolean;
 }
-/** Return provider candidates in fallback order without loading their modules. */
-export declare function resolveProviderCandidates(preferredProvider?: SearchProviderId | "auto"): SearchProviderCandidate[];
+/**
+ * Return provider candidates in fallback order without loading their modules.
+ * `forcedProvider` (a per-request `provider` argument) is terminal-first and
+ * bypasses exclusion; configured-order entries carry `explicit: true`.
+ */
+export declare function resolveProviderCandidates(forcedProvider?: SearchProviderId): SearchProviderCandidate[];
 /**
  * Resolve the complete available provider chain.
  *
  * This compatibility helper loads every candidate. Search execution should use
  * {@link resolveProviderCandidates} so fallback modules load only when reached.
  */
-export declare function resolveProviderChain(authStorage: AuthStorage, preferredProvider?: SearchProviderId | "auto"): Promise<SearchProvider[]>;
+export declare function resolveProviderChain(authStorage: AuthStorage, forcedProvider?: SearchProviderId): Promise<SearchProvider[]>;

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

@@ -108,6 +108,100 @@ export type SearchProviderId = Exclude<(typeof SEARCH_PROVIDER_OPTIONS)[number][
  * share one source of truth and never drift apart.
  */
 export declare const SEARCH_PROVIDER_ORDER: readonly SearchProviderId[];
+/** Concrete provider choices (no `auto` sentinel) — for list-valued settings like order/exclude. */
+export declare const SEARCH_PROVIDER_CHOICES: ({
+    readonly value: "perplexity";
+    readonly label: "Perplexity";
+    readonly description: "Uses auth when configured; explicit selection falls back to anonymous search";
+} | {
+    readonly value: "gemini";
+    readonly label: "Gemini";
+    readonly description: "Google Search grounding via Gemini (uses google-gemini-cli or google-antigravity OAuth)";
+} | {
+    readonly value: "anthropic";
+    readonly label: "Anthropic";
+    readonly description: "Claude's native web_search tool (uses Anthropic OAuth or ANTHROPIC_API_KEY)";
+} | {
+    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";
+    readonly description: "Calls Z.AI webSearchPrime MCP";
+} | {
+    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";
+    readonly description: "Requires JINA_API_KEY";
+} | {
+    readonly value: "kagi";
+    readonly label: "Kagi";
+    readonly description: "Requires KAGI_API_KEY and Kagi Search API beta access";
+} | {
+    readonly value: "tavily";
+    readonly label: "Tavily";
+    readonly description: "Requires TAVILY_API_KEY";
+} | {
+    readonly value: "firecrawl";
+    readonly label: "Firecrawl";
+    readonly description: "Uses Firecrawl API when FIRECRAWL_API_KEY is set; falls back to keyless mode";
+} | {
+    readonly value: "brave";
+    readonly label: "Brave";
+    readonly description: "Requires BRAVE_API_KEY";
+} | {
+    readonly value: "kimi";
+    readonly label: "Kimi";
+    readonly description: "Kimi Code search (requires a Kimi Code Console key via KIMI_SEARCH_API_KEY/MOONSHOT_SEARCH_API_KEY or /login kimi-code; not MOONSHOT_API_KEY)";
+} | {
+    readonly value: "parallel";
+    readonly label: "Parallel";
+    readonly description: "Requires PARALLEL_API_KEY";
+} | {
+    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";
+} | {
+    readonly value: "startpage";
+    readonly label: "Startpage";
+    readonly description: "Credential-free scrape of Startpage (Google-backed) results; may be bot-challenged";
+} | {
+    readonly value: "duckduckgo";
+    readonly label: "DuckDuckGo";
+    readonly description: "Credential-free best-effort fallback; may be bot-challenged on datacenter/shared-egress IPs";
+} | {
+    readonly value: "ecosia";
+    readonly label: "Ecosia";
+    readonly description: "Credential-free browser-backed scrape of Ecosia (Google-backed) results";
+} | {
+    readonly value: "google";
+    readonly label: "Google";
+    readonly description: "Credential-free browser-backed fallback; slower and may be bot-challenged";
+} | {
+    readonly value: "mojeek";
+    readonly label: "Mojeek";
+    readonly description: "Credential-free browser-backed scrape of Mojeek's independent index";
+} | {
+    readonly value: "public";
+    readonly label: "Public Web";
+    readonly description: "Queries every credential-free engine in parallel and consolidates deduplicated results";
+})[];
 export declare const SEARCH_PROVIDER_PREFERENCES: readonly ["auto", ...SearchProviderId[]];
 /** Display labels, derived from {@link SEARCH_PROVIDER_OPTIONS}. */
 export declare const SEARCH_PROVIDER_LABELS: Record<SearchProviderId, string>;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "17.0.9",
+	"version": "17.1.1",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -53,17 +53,17 @@
 		"@babel/parser": "^7.29.7",
 		"@babel/traverse": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "17.0.9",
-		"@oh-my-pi/omp-stats": "17.0.9",
-		"@oh-my-pi/pi-agent-core": "17.0.9",
-		"@oh-my-pi/pi-ai": "17.0.9",
-		"@oh-my-pi/pi-catalog": "17.0.9",
-		"@oh-my-pi/pi-mnemopi": "17.0.9",
-		"@oh-my-pi/pi-natives": "17.0.9",
-		"@oh-my-pi/pi-tui": "17.0.9",
-		"@oh-my-pi/pi-utils": "17.0.9",
-		"@oh-my-pi/pi-wire": "17.0.9",
-		"@oh-my-pi/snapcompact": "17.0.9",
+		"@oh-my-pi/hashline": "17.1.1",
+		"@oh-my-pi/omp-stats": "17.1.1",
+		"@oh-my-pi/pi-agent-core": "17.1.1",
+		"@oh-my-pi/pi-ai": "17.1.1",
+		"@oh-my-pi/pi-catalog": "17.1.1",
+		"@oh-my-pi/pi-mnemopi": "17.1.1",
+		"@oh-my-pi/pi-natives": "17.1.1",
+		"@oh-my-pi/pi-tui": "17.1.1",
+		"@oh-my-pi/pi-utils": "17.1.1",
+		"@oh-my-pi/pi-wire": "17.1.1",
+		"@oh-my-pi/snapcompact": "17.1.1",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/api-logs": "^0.220.0",
 		"@opentelemetry/context-async-hooks": "^2.9.0",