@oh-my-pi/pi-coding-agent 15.3.2 → 15.4.1

package/dist/types/tools/output-schema-validator.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Shared output-schema validation for subagent yield + executor finalization.
+ *
+ * Both the in-process `yield` tool (subagent side) and the executor's post-mortem
+ * finalize path (parent side) need to validate yield payloads against the agent's
+ * declared output schema. This module is the single source of truth for that
+ * pipeline — keeping the two callsites in lockstep so a schema accepted in-tool
+ * cannot be rejected post-mortem (or vice versa).
+ */
+import { type JsonSchemaValidationIssue, type JsonSchemaValidationResult } from "@oh-my-pi/pi-ai/utils/schema";
+/** A validator bound to a specific output schema. */
+export interface OutputValidator {
+    /** Run JSON Schema validation; returns the raw `success`/`issues` shape so callers may inspect every failure. */
+    validate(value: unknown): JsonSchemaValidationResult;
+    /** Top-level required property names. Empty if the schema has no `required` array at root. */
+    readonly requiredFields: readonly string[];
+}
+export interface BuildOutputValidatorResult {
+    /** Present when the schema produced a usable validator (i.e. constraining schemas). Absent for missing/unconstrained schemas. */
+    validator?: OutputValidator;
+    /** Raw JSON Schema produced by `jtdToJsonSchema`. Available alongside the validator so callers can derive related artifacts (strict-mode probe, dereference, hint text). */
+    jsonSchema?: Record<string, unknown>;
+    /**
+     * Normalized schema (post-`normalizeSchema`). Surfaced so callers can distinguish
+     * "no schema provided" (`undefined`) from "intentionally unconstrained" (`true`)
+     * when both produce no validator.
+     */
+    normalized?: unknown;
+    /** Set when the schema cannot be used. Callers should treat this as a "no validation" case (loose acceptance) and surface the message in diagnostics. */
+    error?: string;
+}
+/**
+ * Build the canonical validator for a JTD-or-JSON-Schema output declaration.
+ *
+ * Returns:
+ * - `{ validator, jsonSchema, normalized }` for constraining schemas — both callers use this path.
+ * - `{ normalized: true }` for an intentionally unconstrained schema (the JSON Schema literal `true`).
+ *   No validator, but distinguishable from "no schema provided".
+ * - `{}` for an absent schema (`undefined`).
+ * - `{ error, normalized? }` when the schema cannot be honored (invalid syntax, `false`, malformed JTD).
+ */
+export declare function buildOutputValidator(schema: unknown): BuildOutputValidatorResult;
+/** Produce the executor's headline+missing-required summary from a failed validation. */
+export declare function summarizeValidationFailure(result: JsonSchemaValidationResult, value: unknown, requiredFields: readonly string[]): {
+    message: string;
+    missingRequired: string[];
+};
+export declare function extractRequiredFields(jsonSchema: unknown): string[];
+export declare function computeMissingRequired(required: readonly string[], value: unknown): string[];
+/**
+ * Format a single validation issue as `path.with.dots: message`.
+ *
+ * Used by the executor's post-mortem `schema_violation` headline — one line, dot-separated path,
+ * since the executor's error format already lists missing-required fields separately.
+ */
+export declare function formatValidationIssueHeadline(issue: JsonSchemaValidationIssue | undefined): string | undefined;
+/**
+ * Format every validation issue as `path/with/slashes: message; ...`.
+ *
+ * Used by the yield tool's model-facing retry feedback — the model gets every problem at once so it
+ * can fix the entire output in one retry instead of iterating issue-by-issue. The slash separator
+ * mirrors JSON Pointer convention and disambiguates against fields whose names contain dots.
+ */
+export declare function formatAllValidationIssues(issues: ReadonlyArray<JsonSchemaValidationIssue> | undefined): string;

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

@@ -8,6 +8,7 @@
 import type { AgentTool } from "@oh-my-pi/pi-agent-core";
 import * as z from "zod/v4";
 import type { Theme, ThemeColor } from "../modes/theme/theme";
+import type { ReviewFinding } from "../task/types";
 export type FindingPriority = "P0" | "P1" | "P2" | "P3";
 export interface FindingPriorityInfo {
     ord: 0 | 1 | 2 | 3;
@@ -48,3 +49,15 @@ export interface SubmitReviewDetails {
     confidence: number;
 }
 export type { ReportFindingDetails };
+/**
+ * Coerce a tool-side `ReportFindingDetails` into the cross-boundary
+ * `ReviewFinding` shape consumed by the reviewer agent's JTD output schema.
+ *
+ * The `report_finding` tool exposes `priority` as a string enum (`"P0".."P3"`)
+ * for ergonomics, but the bundled reviewer schema (and every custom review
+ * agent that mirrors it) declares `priority: number`. Without this coercion
+ * the auto-populated `findings[]` fails JTD validation and every review run
+ * that surfaces a finding is rejected with `findings.0.priority: expected
+ * number, received string`.
+ */
+export declare function toReviewFinding(details: ReportFindingDetails): ReviewFinding;

package/dist/types/tools/search-tool-bm25.d.ts

@@ -5,7 +5,6 @@ import type { RenderResultOptions } from "../extensibility/custom-tools/types";
 import type { Theme } from "../modes/theme/theme";
 import { type DiscoverableTool } from "../tool-discovery/tool-index";
 import type { ToolSession } from ".";
-export type { DiscoverableMCPSearchIndex, DiscoverableMCPTool, } from "../mcp/discoverable-tool-metadata";
 declare const searchToolBm25Schema: z.ZodObject<{
     query: z.ZodString;
     limit: z.ZodOptional<z.ZodNumber>;
@@ -63,3 +62,4 @@ export declare const searchToolBm25Renderer: {
     mergeCallAndResult: boolean;
     inline: boolean;
 };
+export {};

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

@@ -8,12 +8,13 @@ import type { ToolSession } from ".";
 import { type OutputMeta } from "./output-meta";
 declare const searchSchema: z.ZodObject<{
     pattern: z.ZodString;
-    paths: z.ZodArray<z.ZodString>;
+    paths: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
     i: z.ZodOptional<z.ZodBoolean>;
     gitignore: z.ZodOptional<z.ZodBoolean>;
     skip: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export type SearchToolInput = z.infer<typeof searchSchema>;
+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`. */
 export declare const DEFAULT_FILE_LIMIT = 20;
@@ -61,7 +62,7 @@ export declare class SearchTool implements AgentTool<typeof searchSchema, Search
     readonly description: string;
     readonly parameters: z.ZodObject<{
         pattern: z.ZodString;
-        paths: z.ZodArray<z.ZodString>;
+        paths: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
         i: z.ZodOptional<z.ZodBoolean>;
         gitignore: z.ZodOptional<z.ZodBoolean>;
         skip: z.ZodOptional<z.ZodNumber>;
@@ -72,7 +73,7 @@ export declare class SearchTool implements AgentTool<typeof searchSchema, Search
 }
 interface SearchRenderArgs {
     pattern: string;
-    paths?: string[];
+    paths?: string | string[];
     i?: boolean;
     gitignore?: boolean;
     skip?: number;

package/dist/types/utils/edit-mode.d.ts

@@ -1,4 +1,4 @@
-export type EditMode = "replace" | "patch" | "hashline" | "vim" | "apply_patch";
+export type EditMode = "replace" | "patch" | "hashline" | "apply_patch";
 export declare const DEFAULT_EDIT_MODE: EditMode;
 export declare const EDIT_MODES: EditMode[];
 export declare function normalizeEditMode(mode?: string | null): EditMode | undefined;

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

@@ -1,9 +1,11 @@
+import type { AuthStorage } from "@oh-my-pi/pi-ai";
 export declare class KagiApiError extends Error {
     readonly statusCode?: number;
     constructor(message: string, statusCode?: number);
 }
 export interface KagiSearchOptions {
     limit?: number;
+    sessionId?: string;
     signal?: AbortSignal;
 }
 export interface KagiSearchSource {
@@ -17,5 +19,5 @@ export interface KagiSearchResult {
     sources: KagiSearchSource[];
     relatedQuestions: string[];
 }
-export declare function findKagiApiKey(): Promise<string | null>;
-export declare function searchWithKagi(query: string, options?: KagiSearchOptions): Promise<KagiSearchResult>;
+export declare function findKagiApiKey(authStorage: AuthStorage, sessionId?: string, signal?: AbortSignal): Promise<string | null>;
+export declare function searchWithKagi(query: string, options: KagiSearchOptions | undefined, authStorage: AuthStorage): Promise<KagiSearchResult>;

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

@@ -1,3 +1,4 @@
+import type { AgentStorage } from "../session/agent-storage";
 export interface ParallelUsageItem {
     name?: string;
     count?: number;
@@ -51,7 +52,7 @@ export declare class ParallelApiError extends Error {
     readonly statusCode?: number;
     constructor(message: string, statusCode?: number);
 }
-export declare function findParallelApiKey(): Promise<string | null>;
+export declare function findParallelApiKey(storage: AgentStorage | null | undefined): string | null;
 export declare function getParallelExtractContent(document: ParallelExtractDocument): string;
-export declare function searchWithParallel(objective: string, queries: string[], options?: ParallelSearchOptions): Promise<ParallelSearchResult>;
-export declare function extractWithParallel(urls: string[], options?: ParallelExtractOptions): Promise<ParallelExtractResult>;
+export declare function searchWithParallel(objective: string, queries: string[], options: ParallelSearchOptions, storage: AgentStorage | null | undefined): Promise<ParallelSearchResult>;
+export declare function extractWithParallel(urls: string[], options: ParallelExtractOptions, storage: AgentStorage | null | undefined): Promise<ParallelExtractResult>;

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

@@ -1,3 +1,4 @@
+import type { AgentStorage } from "../../session/agent-storage";
 export { formatNumber } from "@oh-my-pi/pi-utils";
 export interface RenderResult {
     url: string;
@@ -9,7 +10,7 @@ export interface RenderResult {
     truncated: boolean;
     notes: string[];
 }
-export type SpecialHandler = (url: string, timeout: number, signal?: AbortSignal) => Promise<RenderResult | null>;
+export type SpecialHandler = (url: string, timeout: number, signal?: AbortSignal, storage?: AgentStorage | null) => Promise<RenderResult | null>;
 export declare const MAX_OUTPUT_CHARS = 500000;
 export declare const MAX_BYTES: number;
 /**

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

@@ -3,9 +3,9 @@
  *
  * Single tool supporting Anthropic, Perplexity, Exa, Brave, Jina, Kimi, Gemini, Codex, Tavily, Kagi, Z.AI, SearXNG, and Synthetic
  * providers with provider-specific parameters exposed conditionally.
- *
  */
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
+import type { AuthStorage } from "@oh-my-pi/pi-ai";
 import * as z from "zod/v4";
 import type { CustomTool } from "../../extensibility/custom-tools/types";
 import type { ToolSession } from "../../tools";
@@ -31,8 +31,16 @@ export interface SearchQueryParams extends SearchToolParams {
 }
 /**
  * Execute a web search query for CLI/testing workflows.
+ *
+ * `authStorage` may be omitted; in that case we discover one via the standard
+ * factory (`discoverAuthStorage`), which honours `OMP_AUTH_BROKER_URL` and
+ * otherwise opens the local SQLite credential store.
  */
-export declare function runSearchQuery(params: SearchQueryParams): Promise<{
+export declare function runSearchQuery(params: SearchQueryParams, options?: {
+    authStorage?: AuthStorage;
+    sessionId?: string;
+    signal?: AbortSignal;
+}): Promise<{
     content: Array<{
         type: "text";
         text: string;
@@ -43,9 +51,9 @@ export declare function runSearchQuery(params: SearchQueryParams): Promise<{
  * Web search tool implementation.
  *
  * Supports Anthropic, Perplexity, Exa, Brave, Jina, Kimi, Gemini, Codex, Z.AI, SearXNG, and Synthetic providers with automatic fallback.
- * Session is accepted for interface consistency but not used.
  */
 export declare class WebSearchTool implements AgentTool<typeof webSearchSchema, SearchRenderDetails> {
+    #private;
     readonly name = "web_search";
     readonly label = "Web Search";
     readonly description: string;
@@ -65,7 +73,7 @@ export declare class WebSearchTool implements AgentTool<typeof webSearchSchema,
     readonly strict = true;
     readonly loadMode = "discoverable";
     readonly summary = "Search the web for up-to-date information";
-    constructor(_session: ToolSession);
+    constructor(session: ToolSession);
     execute(_toolCallId: string, params: SearchToolParams, signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<SearchRenderDetails>, _context?: AgentToolContext): Promise<AgentToolResult<SearchRenderDetails>>;
 }
 /** Web search tool as CustomTool (for TUI rendering support) */

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

@@ -1,3 +1,4 @@
+import type { AuthStorage } from "@oh-my-pi/pi-ai";
 import type { SearchProvider } from "./providers/base";
 import type { SearchProviderId } from "./types";
 export type { SearchParams } from "./providers/base";
@@ -17,4 +18,4 @@ export declare function setPreferredSearchProvider(provider: SearchProviderId |
  * Each candidate is loaded (and its `isAvailable()` called) only as the chain
  * is walked, so unconfigured providers never pay the load cost.
  */
-export declare function resolveProviderChain(preferredProvider?: SearchProviderId | "auto"): Promise<SearchProvider[]>;
+export declare function resolveProviderChain(authStorage: AuthStorage, preferredProvider?: SearchProviderId | "auto"): Promise<SearchProvider[]>;

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

@@ -1,3 +1,10 @@
+/**
+ * Anthropic Web Search Provider
+ *
+ * Uses Claude's built-in web_search_20250305 tool to search the web.
+ * Returns synthesized answers with citations and source metadata.
+ */
+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";
@@ -5,9 +12,7 @@ export interface AnthropicSearchParams {
     query: string;
     system_prompt?: string;
     num_results?: number;
-    /** Maximum output tokens. Defaults to 4096. */
     max_tokens?: number;
-    /** Sampling temperature (0–1). Lower = more focused/factual. */
     temperature?: number;
     signal?: AbortSignal;
 }
@@ -17,11 +22,11 @@ export interface AnthropicSearchParams {
  * @returns Search response with synthesized answer, sources, and citations
  * @throws {Error} If no Anthropic credentials are configured
  */
-export declare function searchAnthropic(params: AnthropicSearchParams): Promise<SearchResponse>;
+export declare function searchAnthropic(params: SearchParams | AnthropicSearchParams, _legacyStorage?: unknown): Promise<SearchResponse>;
 /** Search provider for Anthropic Claude web search. */
 export declare class AnthropicProvider extends SearchProvider {
     readonly id = "anthropic";
     readonly label = "Anthropic";
-    isAvailable(): Promise<boolean>;
+    isAvailable(authStorage: AuthStorage): Promise<boolean> | boolean;
     search(params: SearchParams): Promise<SearchResponse>;
 }

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

@@ -1,5 +1,15 @@
+import type { AuthStorage } from "@oh-my-pi/pi-ai";
 import type { SearchProviderId, SearchResponse } from "../types";
-/** Shared web search parameters passed to providers. */
+/**
+ * Shared web search parameters passed to providers.
+ *
+ * `authStorage` is the **only** credential source providers may consult.
+ * Opening a sibling SQLite handle or calling provider-direct refresh helpers
+ * (e.g. `refreshOpenAICodexToken`, `refreshGoogleCloudToken`) is prohibited:
+ * it races the broker's per-credential refresh and POSTs the broker sentinel
+ * (`REMOTE_REFRESH_SENTINEL`) to the upstream token endpoint, which classifies
+ * as `invalid_grant` and disables the row.
+ */
 export interface SearchParams {
     query: string;
     limit?: number;
@@ -25,11 +35,33 @@ export interface SearchParams {
     googleSearch?: Record<string, unknown>;
     codeExecution?: Record<string, unknown>;
     urlContext?: Record<string, unknown>;
+    /**
+     * The single source of truth for credentials. Providers MUST consult this
+     * handle exclusively (`getApiKey` for bearer-style auth, `getOAuthAccess`
+     * when identity metadata is required). Do not open `AgentStorage` or any
+     * `AuthCredentialStore` directly — that bypasses the broker pipeline and
+     * the per-credential single-flight refresh.
+     */
+    authStorage: AuthStorage;
+    /**
+     * Optional session id used as the round-robin / sticky key when selecting
+     * among multiple credentials for the same provider. Pass through from the
+     * caller's agent session when available; otherwise omit.
+     */
+    sessionId?: string;
 }
 /** Base class for web search providers. */
 export declare abstract class SearchProvider {
     abstract readonly id: SearchProviderId;
     abstract readonly label: string;
-    abstract isAvailable(): Promise<boolean> | boolean;
+    /**
+     * Indicates whether this provider has the credentials/config it needs to
+     * service a request right now. Implementations consult the passed
+     * {@link AuthStorage} — never a sibling store.
+     */
+    abstract isAvailable(authStorage: AuthStorage): Promise<boolean> | boolean;
+    /**
+     * Execute a search. Credentials MUST be resolved through `params.authStorage`.
+     */
     abstract search(params: SearchParams): Promise<SearchResponse>;
 }

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

@@ -1,3 +1,10 @@
+/**
+ * Brave Web Search Provider
+ *
+ * Calls Brave's web search REST API and maps results into the unified
+ * SearchResponse shape used by the web search tool.
+ */
+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";
@@ -15,6 +22,6 @@ export declare function searchBrave(params: BraveSearchParams): Promise<SearchRe
 export declare class BraveProvider extends SearchProvider {
     readonly id = "brave";
     readonly label = "Brave";
-    isAvailable(): Promise<boolean>;
+    isAvailable(_authStorage: AuthStorage): boolean;
     search(params: SearchParams): Promise<SearchResponse>;
 }

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

@@ -1,3 +1,4 @@
+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";
@@ -11,21 +12,24 @@ export interface CodexSearchParams {
 }
 /**
  * Executes a web search using OpenAI Codex's built-in web search tool.
- * Requires OAuth credentials stored in agent.db for provider "openai-codex".
- * @param params - Search parameters including query and optional settings
- * @returns Search response with synthesized answer, sources, and usage
- * @throws {Error} If no Codex OAuth credentials are configured
+ *
+ * Default-model behavior:
+ * - If `PI_CODEX_WEB_SEARCH_MODEL` is set, use it exactly once and surface any
+ *   upstream error verbatim.
+ * - Otherwise prefer ChatGPT-account-safe bundled defaults (GPT-5.4, GPT-5
+ *   Codex, GPT-5, …) and retry the next candidate only when Codex returns the
+ *   known 400 "model is not supported" family. This avoids selecting
+ *   `gpt-5-codex-mini` first on ChatGPT accounts, which OpenAI rejects.
  */
-export declare function searchCodex(params: CodexSearchParams): Promise<SearchResponse>;
+export declare function searchCodex(params: SearchParams): Promise<SearchResponse>;
 /**
  * Checks if Codex web search is available.
- * @returns True if valid OAuth credentials exist for openai-codex
  */
-export declare function hasCodexSearch(): Promise<boolean>;
+export declare function hasCodexSearch(authStorage: AuthStorage): Promise<boolean>;
 /** Search provider for OpenAI Codex web search. */
 export declare class CodexProvider extends SearchProvider {
     readonly id = "codex";
-    readonly label = "Codex";
-    isAvailable(): Promise<boolean>;
+    readonly label = "OpenAI";
+    isAvailable(authStorage: AuthStorage): Promise<boolean> | boolean;
     search(params: SearchParams): Promise<SearchResponse>;
 }

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

@@ -1,3 +1,12 @@
+/**
+ * Exa Web Search Provider
+ *
+ * High-quality neural search via Exa Search API.
+ * Returns structured search results with optional content extraction.
+ * Requests per-result summaries via `contents.summary` and synthesizes
+ * them into a combined `answer` string on the SearchResponse.
+ */
+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";
@@ -37,7 +46,7 @@ export declare function searchExa(params: ExaSearchParams): Promise<SearchRespon
 export declare class ExaProvider extends SearchProvider {
     readonly id = "exa";
     readonly label = "Exa";
-    isAvailable(): boolean;
+    isAvailable(_authStorage: AuthStorage): boolean;
     search(params: SearchParams): Promise<SearchResponse>;
 }
 export {};

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

@@ -1,4 +1,14 @@
-import { AgentStorage } from "../../../session/agent-storage";
+/**
+ * Google Gemini Web Search Provider
+ *
+ * Uses Gemini's Google Search grounding via Cloud Code Assist API.
+ * Auth is resolved through `AuthStorage.getOAuthAccess(...)` for both
+ * `google-gemini-cli` (stable prod) and `google-antigravity` (daily sandbox)
+ * — the broker is the sole refresh authority, so this module never opens a
+ * sibling SQLite store and never POSTs the broker sentinel to a Google token
+ * endpoint.
+ */
+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";
@@ -16,45 +26,32 @@ export interface GeminiSearchParams extends GeminiToolParams {
     /** Sampling temperature (0–1). Lower = more focused/factual. */
     temperature?: number;
     signal?: AbortSignal;
+    authStorage: AuthStorage;
+    sessionId?: string;
 }
 export declare function buildGeminiRequestTools(params: GeminiToolParams): Array<Record<string, Record<string, unknown>>>;
-/** OAuth credential stored in agent.db */
-interface GeminiOAuthCredential {
-    type: "oauth";
-    access: string;
-    refresh?: string;
-    expires: number;
-    projectId?: string;
-}
-/** Auth info for Gemini API requests */
+/** Resolved auth for a Gemini API request. */
 interface GeminiAuth {
     accessToken: string;
-    refreshToken?: string;
     projectId: string;
     isAntigravity: boolean;
-    storage: AgentStorage;
-    credentialId: number;
-    credential: GeminiOAuthCredential;
 }
 /**
- * Finds valid Gemini OAuth credentials from agent.db.
- * Checks google-gemini-cli first (stable prod), then google-antigravity (daily sandbox).
- * @returns OAuth credential with access token and project ID, or null if none found
+ * Walks the configured Gemini OAuth providers in deterministic order and
+ * returns the first one that yields a usable access token + projectId via
+ * {@link AuthStorage.getOAuthAccess}. AuthStorage handles refresh + broker
+ * routing internally; this helper never touches refresh tokens directly.
  */
-export declare function findGeminiAuth(): Promise<GeminiAuth | null>;
+export declare function findGeminiAuth(authStorage: AuthStorage, sessionId: string | undefined, signal: AbortSignal | undefined): Promise<GeminiAuth | null>;
 /**
  * Executes a web search using Google Gemini with Google Search grounding.
- * Requires OAuth credentials stored in agent.db for provider "google-gemini-cli" or "google-antigravity".
- * @param params - Search parameters including query and optional settings
- * @returns Search response with synthesized answer, sources, and citations
- * @throws {Error} If no Gemini OAuth credentials are configured
  */
 export declare function searchGemini(params: GeminiSearchParams): Promise<SearchResponse>;
 /** Search provider for Google Gemini web search. */
 export declare class GeminiProvider extends SearchProvider {
     readonly id = "gemini";
     readonly label = "Gemini";
-    isAvailable(): Promise<boolean>;
+    isAvailable(authStorage: AuthStorage): boolean;
     search(params: SearchParams): Promise<SearchResponse>;
 }
 export {};

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

@@ -4,6 +4,7 @@
  * Uses the Jina Reader `s.jina.ai` endpoint to fetch search results with
  * cleaned content.
  */
+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";
@@ -20,6 +21,6 @@ export declare function searchJina(params: JinaSearchParams): Promise<SearchResp
 export declare class JinaProvider extends SearchProvider {
     readonly id = "jina";
     readonly label = "Jina";
-    isAvailable(): Promise<boolean>;
+    isAvailable(_authStorage: AuthStorage): boolean;
     search(params: SearchParams): Promise<SearchResponse>;
 }

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

@@ -3,6 +3,7 @@
  *
  * Thin wrapper that adapts shared Kagi API utilities to SearchResponse shape.
  */
+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";
@@ -11,11 +12,13 @@ export declare function searchKagi(params: {
     query: string;
     num_results?: number;
     signal?: AbortSignal;
+    authStorage: AuthStorage;
+    sessionId?: string;
 }): Promise<SearchResponse>;
 /** Search provider for Kagi web search. */
 export declare class KagiProvider extends SearchProvider {
     readonly id = "kagi";
     readonly label = "Kagi";
-    isAvailable(): Promise<boolean>;
+    isAvailable(authStorage: AuthStorage): boolean;
     search(params: SearchParams): Promise<SearchResponse>;
 }

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

@@ -1,3 +1,10 @@
+/**
+ * Kimi Web Search Provider
+ *
+ * Uses Moonshot Kimi Code search API to retrieve web results.
+ * Endpoint: POST https://api.kimi.com/coding/v1/search
+ */
+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";
@@ -6,6 +13,8 @@ export interface KimiSearchParams {
     num_results?: number;
     include_content?: boolean;
     signal?: AbortSignal;
+    authStorage: AuthStorage;
+    sessionId?: string;
 }
 /** Execute Kimi web search. */
 export declare function searchKimi(params: KimiSearchParams): Promise<SearchResponse>;
@@ -13,6 +22,6 @@ export declare function searchKimi(params: KimiSearchParams): Promise<SearchResp
 export declare class KimiProvider extends SearchProvider {
     readonly id = "kimi";
     readonly label = "Kimi";
-    isAvailable(): Promise<boolean>;
+    isAvailable(authStorage: AuthStorage): boolean;
     search(params: SearchParams): Promise<SearchResponse>;
 }

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

@@ -1,3 +1,4 @@
+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";
@@ -5,10 +6,10 @@ export declare function searchParallel(params: {
     query: string;
     num_results?: number;
     signal?: AbortSignal;
-}): Promise<SearchResponse>;
+}, authStorage: AuthStorage, sessionId?: string): Promise<SearchResponse>;
 export declare class ParallelProvider extends SearchProvider {
     readonly id = "parallel";
     readonly label = "Parallel";
-    isAvailable(): Promise<boolean>;
+    isAvailable(authStorage: AuthStorage): boolean;
     search(params: SearchParams): Promise<SearchResponse>;
 }

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

@@ -3,9 +3,10 @@
  *
  * Supports three auth modes:
  * - Cookies (`PERPLEXITY_COOKIES`) via `www.perplexity.ai/rest/sse/perplexity_ask`
- * - OAuth JWT (stored in `agent.db`) via `www.perplexity.ai/rest/sse/perplexity_ask`
+ * - OAuth/session bearer via `AuthStorage` and `www.perplexity.ai/rest/sse/perplexity_ask`
  * - API key (`PERPLEXITY_API_KEY`) via `api.perplexity.ai/chat/completions`
  */
+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";
@@ -21,6 +22,8 @@ export interface PerplexitySearchParams {
     temperature?: number;
     /** Number of search results to retrieve. Defaults to 10. */
     num_search_results?: number;
+    authStorage: AuthStorage;
+    sessionId?: string;
 }
 /** Find PERPLEXITY_API_KEY from environment or .env files (also checks PPLX_API_KEY) */
 export declare function findApiKey(): string | null;
@@ -30,6 +33,6 @@ export declare function searchPerplexity(params: PerplexitySearchParams): Promis
 export declare class PerplexityProvider extends SearchProvider {
     readonly id = "perplexity";
     readonly label = "Perplexity";
-    isAvailable(): Promise<boolean>;
+    isAvailable(authStorage: AuthStorage): boolean;
     search(params: SearchParams): Promise<SearchResponse>;
 }

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

@@ -24,6 +24,7 @@
  *
  * Reference: https://docs.searxng.org/dev/search_api.html
  */
+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";
@@ -38,6 +39,6 @@ export declare function searchSearXNG(params: {
 export declare class SearXNGProvider extends SearchProvider {
     readonly id = "searxng";
     readonly label = "SearXNG";
-    isAvailable(): boolean;
+    isAvailable(_authStorage: AuthStorage): boolean;
     search(params: SearchParams): Promise<SearchResponse>;
 }