@prometheus-ai/agent 0.5.3 → 0.5.8

package/dist/types/utils/block-context.d.ts

@@ -0,0 +1,35 @@
+export interface LineSpan {
+    startLine: number;
+    endLine: number;
+}
+/** Where the source came from, so tree-sitter can pick a grammar. */
+export interface BlockContextSource {
+    path?: string;
+    lang?: string;
+}
+export type LineEntry = {
+    kind: "line";
+    lineNumber: number;
+    text: string;
+    context: boolean;
+} | {
+    kind: "ellipsis";
+};
+/**
+ * Resolve the off-window boundary lines for a visible window: tree-sitter
+ * syntactic spans first (covers brace and indentation languages), falling back
+ * to a lexical bracket scan when the grammar is unavailable. Returns a map of
+ * `lineNumber → source text` for the lines to surface, never including a line
+ * already visible.
+ */
+export declare function findBlockContextLines(fullLines: readonly string[], visibleInput: ReadonlySet<number> | readonly number[], source?: BlockContextSource): Map<number, string>;
+/**
+ * Build display entries for `visibleSpans` plus any off-window block-boundary
+ * lines, in source order, with `{ kind: "ellipsis" }` markers inserted across
+ * non-contiguous gaps. `options.lineText` lets callers substitute display text
+ * (e.g. column-truncated lines) for a given line number.
+ */
+export declare function buildLineEntriesWithBlockContext(fullLines: readonly string[], visibleSpans: readonly LineSpan[], source?: BlockContextSource, options?: {
+    lineText?: (lineNumber: number, sourceText: string, context: boolean) => string;
+}): LineEntry[];
+export declare function lineEntriesToPlainText(entries: readonly LineEntry[], ellipsis?: string): string;

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

@@ -23,3 +23,11 @@ export declare function compareVersions(v1: ChangelogEntry, v2: ChangelogEntry):
  */
 export declare function getNewEntries(entries: ChangelogEntry[], lastVersion: string): ChangelogEntry[];
 export { getChangelogPath } from "../config";
+/**
+ * Last prometheus version whose changelog the user has seen. Stored as a plain-text
+ * marker file (`~/.prometheus/agent/last-changelog-version`) rather than in
+ * `config.yml`, so version bumps never dirty user-tracked config files.
+ */
+export declare function readLastChangelogVersion(agentDir?: string): Promise<string | undefined>;
+/** Persist the last-seen changelog version marker. Best-effort: failures are logged, never thrown. */
+export declare function writeLastChangelogVersion(version: string, agentDir?: string): Promise<void>;

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

@@ -13,9 +13,10 @@ export declare function copyToClipboard(text: string): Promise<void>;
  * Read an image from the system clipboard.
  *
  * Returns null on Termux (no image clipboard support) or when no display
- * server is available (headless/SSH without forwarding). Under WSL the
- * Windows clipboard is reached through `powershell.exe`, since WSLg's
- * Wayland clipboard does not carry image payloads through to `arboard`.
+ * server is available (headless/SSH without forwarding). Under native Windows
+ * and WSL, the Windows clipboard is also reached through `powershell.exe`
+ * because terminal clipboard paths can leave image payloads invisible to the
+ * native bridge.
  *
  * @returns PNG payload or null when no image is available.
  */

package/dist/types/utils/enhanced-paste.d.ts

@@ -0,0 +1,20 @@
+import type { ImageContent } from "@prometheus-ai/ai";
+export interface Osc5522Packet {
+    metadata: Map<string, string>;
+    payload: string;
+}
+export interface EnhancedPasteHandlers {
+    write(data: string): void;
+    pasteText(text: string): void;
+    pasteImage(image: ImageContent): void | Promise<void>;
+    showStatus(message: string): void;
+}
+export declare function isOsc5522Packet(data: string): boolean;
+export declare function parseOsc5522Packet(data: string): Osc5522Packet | undefined;
+export declare class EnhancedPasteController {
+    #private;
+    constructor(handlers: EnhancedPasteHandlers);
+    enable(): void;
+    disable(): void;
+    handleInput(data: string): boolean;
+}

package/dist/types/utils/file-mentions.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Auto-read file mentions from user prompts.
+ *
+ * When users reference files with @path syntax (e.g., "@src/foo.ts"),
+ * we automatically inject the file contents as a FileMentionMessage
+ * so the agent doesn't need to read them manually.
+ */
 import type { AgentMessage } from "@prometheus-ai/agent-core";
 import { type SnapshotStore } from "@prometheus-ai/hashline";
 /** Extract all @filepath mentions from text */

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

@@ -10,6 +10,7 @@ export interface GitRepository {
     gitEntryPath: string;
     headPath: string;
     repoRoot: string;
+    isReftable?: boolean;
 }
 export interface GitStatusSummary {
     staged: number;
@@ -34,6 +35,10 @@ export interface StageHunksOptions {
     readonly rawDiff?: string;
     readonly signal?: AbortSignal;
 }
+export interface HunkSelectionValidationError {
+    readonly path: string;
+    readonly message: string;
+}
 export interface DiffOptions {
     readonly allowFailure?: boolean;
     readonly base?: string;
@@ -128,6 +133,8 @@ interface CommandOptions {
  * module never auto-acquire — callers wrap the critical section themselves.
  */
 export declare function withRepoLock<T>(cwd: string, fn: () => Promise<T>, signal?: AbortSignal): Promise<T>;
+export declare function createHunkSelectionValidator(rawDiff: string): (selections: readonly HunkSelection[]) => HunkSelectionValidationError[];
+export declare function validateHunkSelections(rawDiff: string, selections: readonly HunkSelection[]): HunkSelectionValidationError[];
 declare function parseStatusPorcelain(text: string): GitStatusSummary;
 /** Run `git diff` with the given options. Returns raw diff text. */
 export declare const diff: ((cwd: string, options?: DiffOptions) => Promise<string>) & {
@@ -170,7 +177,7 @@ export declare const stage: {
 };
 /** Create a commit with the given message (passed via stdin). */
 export declare function commit(cwd: string, message: string, options?: CommitOptions): Promise<GitCommandResult>;
-/** Push the current branch. */
+/** Push the current branch (branch-scoped: never follows tags). */
 export declare function push(cwd: string, options?: PushOptions): Promise<void>;
 /** Checkout a ref. */
 export declare function checkout(cwd: string, ref: string, signal?: AbortSignal): Promise<void>;
@@ -321,7 +328,7 @@ export declare const ls: {
 };
 export declare const head: {
     /** Full HEAD state (branch, commit, repo info). */
-    resolve(cwd: string): Promise<GitHeadState | null>;
+    resolve(cwd: string, signal?: AbortSignal): Promise<GitHeadState | null>;
     /** Full HEAD state (synchronous). */
     resolveSync(cwd: string): GitHeadState | null;
     /** Current HEAD commit SHA. */
@@ -332,12 +339,24 @@ export declare const head: {
 export declare const repo: {
     /** Resolve the repository root (may be a worktree root). */
     root(cwd: string, signal?: AbortSignal): Promise<string | null>;
-    /** Resolve the primary repository root (not a worktree — the main checkout). */
+    /** Resolve the primary checkout root, or the shared common dir for bare-repo worktrees. */
     primaryRoot(cwd: string, signal?: AbortSignal): Promise<string | null>;
+    /**
+     * Sync sibling of {@link primaryRoot}. Resolves only via on-disk `.git`/
+     * `commondir` walking — no subprocess fallback — so it stays usable from
+     * paths where async I/O is impractical (e.g. `computeBankScope`). Returns
+     * `null` when `cwd` is outside a repository. Bare-repo worktrees resolve to
+     * the shared common dir (`foo.git`) because they have no primary checkout.
+     */
+    primaryRootSync(cwd: string): string | null;
     /** Full GitRepository metadata (sync). */
     resolveSync(cwd: string): GitRepository | null;
     /** Full GitRepository metadata. */
     resolve(cwd: string): Promise<GitRepository | null>;
+    /** Check if the repository uses the reftable reference storage format (sync). */
+    isReftableSync(repository: GitRepository): boolean;
+    /** Check if the repository uses the reftable reference storage format. */
+    isReftable(repository: GitRepository): Promise<boolean>;
 };
 export interface GhCommandResult {
     exitCode: number;

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

@@ -1,6 +1,20 @@
-import type { ImageContent } from "@prometheus-ai/ai";
+import type { ImageContent, Model } from "@prometheus-ai/ai";
+import { type ImageResizeOptions } from "./image-resize";
 export declare const MAX_IMAGE_INPUT_BYTES: number;
 export declare const SUPPORTED_INPUT_IMAGE_MIME_TYPES: Set<string>;
+/**
+ * Ollama and its local-backend family decode image input through llama.cpp /
+ * `stb_image`, which is compiled without WebP support, so a WebP upload fails
+ * with an opaque HTTP 400. Detect those models so the resize pipeline encodes
+ * to PNG/JPEG instead — the automatic equivalent of `PROMETHEUS_NO_WEBP=1`.
+ */
+export declare function modelLacksWebpSupport(model: Pick<Model, "provider" | "api"> | undefined): boolean;
+/**
+ * `true` when `model` cannot decode WebP, otherwise `undefined` so the
+ * `PROMETHEUS_NO_WEBP` env fallback in {@link resizeImage} still applies. Feed straight
+ * into {@link ImageResizeOptions.excludeWebP}.
+ */
+export declare function webpExclusionForModel(model: Pick<Model, "provider" | "api"> | undefined): true | undefined;
 export interface LoadImageInputOptions {
     path: string;
     cwd: string;
@@ -8,6 +22,8 @@ export interface LoadImageInputOptions {
     maxBytes?: number;
     resolvedPath?: string;
     detectedMimeType?: string;
+    /** Force non-WebP output (e.g. for Ollama). Leave unset to honor `PROMETHEUS_NO_WEBP`. */
+    excludeWebP?: boolean;
 }
 export interface LoadedImageInput {
     resolvedPath: string;
@@ -23,4 +39,17 @@ export declare class ImageInputTooLargeError extends Error {
     constructor(bytes: number, maxBytes: number);
 }
 export declare function ensureSupportedImageInput(image: ImageContent): Promise<ImageContent | null>;
+export interface NormalizeModelContextImagesOptions {
+    /** Model the images are bound for; used to derive encoder constraints (WebP exclusion for Ollama). */
+    model?: Model;
+    resize?: ImageResizeOptions;
+}
+/**
+ * Normalize image blocks before they enter agent/model context. This keeps
+ * provider request construction from having to resize an unbounded batch of
+ * large images on the streaming hot path. Images are processed sequentially on
+ * purpose: `resizeImage` may fan out multiple encoders for one image, so the
+ * outer image batch must stay bounded.
+ */
+export declare function normalizeModelContextImages(images: ImageContent[] | undefined, options?: NormalizeModelContextImagesOptions): Promise<ImageContent[] | undefined>;
 export declare function loadImageInput(options: LoadImageInputOptions): Promise<LoadedImageInput | null>;

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

@@ -1,13 +1,25 @@
 /**
- * Derive a stable CSS hex accent color from a session name.
+ * Derive a stable CSS hex accent color from a session name and the active theme.
+ *
+ * Picks a hue from a **dark/light-specific range** so the accent feels natural
+ * for the theme type (warm on dark, cool on light). The session name hash
+ * determines the exact hue within the range. The result is checked against
+ * all theme color hues and shifted if it lands within {@link MIN_HUE_DISTANCE}
+ * of an existing theme hue, but is clamped to the hue band so it never
+ * drifts into an unrelated part of the spectrum.
  *
  * On dark themes (`surfaceLuminance` undefined) the accent is vivid (high
  * saturation, high lightness). On light themes the lightness is reduced until the
  * accent's perceived luminance clears {@link ACCENT_MIN_CONTRAST} against the
  * actual surface it renders on — so it stays legible on near-white *and* mid-light
- * backgrounds — while keeping the same per-session hue.
+ * backgrounds.
+ *
+ * @param name — session name for per-session uniqueness.
+ * @param themeColorHexes — all theme colors to check collision against.
+ * @param surfaceLuminance — undefined on dark themes; WCAG luminance of the
+ *   status-line background on light themes.
  */
-export declare function getSessionAccentHex(name: string, surfaceLuminance?: number): string;
+export declare function getSessionAccentHex(name: string, themeColorHexes: string[], surfaceLuminance?: number): string;
 /**
  * Convert a hex accent color to an ANSI-16m foreground escape sequence.
  * Returns `undefined` if `hex` is nullish or Bun.color conversion fails.

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

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

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

@@ -15,9 +15,10 @@ export declare function raceFirstNonNull<T>(primary: Promise<T | null>, startFal
  *   to produce request metadata (e.g. user_id for session attribution). Using a
  *   resolver instead of a pre-evaluated value ensures the metadata's account_uuid
  *   reflects the credential actually selected for this request.
+ * @param customSystemPrompt Optional title-specific system prompt override
  */
-export declare function generateSessionTitle(firstMessage: string, registry: ModelRegistry, settings: Settings, sessionId?: string, currentModel?: Model<Api>, metadataResolver?: (provider: string) => Record<string, unknown> | undefined): Promise<string | null>;
-export declare function generateTitleOnline(firstMessage: string, registry: ModelRegistry, settings: Settings, sessionId?: string, currentModel?: Model<Api>, metadataResolver?: (provider: string) => Record<string, unknown> | undefined, signal?: AbortSignal): Promise<string | null>;
+export declare function generateSessionTitle(firstMessage: string, registry: ModelRegistry, settings: Settings, sessionId?: string, currentModel?: Model<Api>, metadataResolver?: (provider: string) => Record<string, unknown> | undefined, customSystemPrompt?: string): Promise<string | null>;
+export declare function generateTitleOnline(firstMessage: string, registry: ModelRegistry, settings: Settings, sessionId?: string, currentModel?: Model<Api>, metadataResolver?: (provider: string) => Record<string, unknown> | undefined, signal?: AbortSignal, customSystemPrompt?: string): Promise<string | null>;
 export declare function formatSessionTerminalTitle(sessionName: string | undefined, cwd?: string): string;
 /**
  * Set the terminal title using OSC 0 (sets both tab and window title). Unsupported terminals ignore it.

package/dist/types/utils/tool-choice.d.ts

@@ -5,3 +5,11 @@ import type { Api, Model, ToolChoice } from "@prometheus-ai/ai";
  * narrowing their request tool list before transport.
  */
 export declare function buildNamedToolChoice(toolName: string, model?: Model<Api>): ToolChoice | undefined;
+/**
+ * Whether the given tool choice can be satisfied by the active tool set for the
+ * upcoming turn. Non-named choices (`"none"`, `"required"`, etc.) do not name a
+ * specific tool and are therefore always active.
+ */
+export declare function isToolChoiceActive(toolChoice: ToolChoice | undefined, tools: readonly {
+    name: string;
+}[]): boolean;

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

@@ -1,4 +1,5 @@
-export type ToolName = "sd" | "sg" | "yt-dlp" | "trafilatura";
+export declare function ffmpegAssetName(_version: string, plat: string, architecture: string): string | null;
+export type ToolName = "sd" | "sg" | "yt-dlp" | "trafilatura" | "ffmpeg";
 export declare function getToolPath(tool: ToolName): string | null;
 type EnsureToolOptions = {
     signal?: AbortSignal;

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

@@ -6,7 +6,7 @@
  * through the shared {@link AuthStorage} broker (Bearer token), and responses
  * are categorized result buckets rather than the legacy flat object array.
  */
-import type { AuthStorage } from "@prometheus-ai/ai";
+import { type AuthStorage, type FetchImpl } from "@prometheus-ai/ai";
 /** V1 search request body. */
 export interface KagiSearchRequest {
     query: string;
@@ -82,6 +82,7 @@ export interface KagiSearchOptions {
     recency?: "day" | "week" | "month" | "year";
     sessionId?: string;
     signal?: AbortSignal;
+    fetch?: FetchImpl;
 }
 export interface KagiSearchSource {
     title: string;
@@ -95,5 +96,4 @@ export interface KagiSearchResult {
     relatedQuestions: string[];
     answer?: string;
 }
-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 FetchImpl } from "@prometheus-ai/ai";
 import type { AgentStorage } from "../session/agent-storage";
 export interface ParallelUsageItem {
     name?: string;
@@ -40,6 +41,7 @@ export interface ParallelSearchOptions {
     mode?: "fast" | "research";
     maxCharsPerResult?: number;
     signal?: AbortSignal;
+    fetch?: FetchImpl;
 }
 export interface ParallelExtractOptions {
     objective?: string;
@@ -47,6 +49,7 @@ export interface ParallelExtractOptions {
     excerpts?: boolean;
     fullContent?: boolean;
     signal?: AbortSignal;
+    fetch?: FetchImpl;
 }
 export declare class ParallelApiError extends Error {
     readonly statusCode?: number;

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

@@ -1,4 +1,18 @@
 import type { SpecialHandler } from "./types";
+interface GitHubUrl {
+    type: "blob" | "tree" | "repo" | "commit" | "issue" | "issues" | "pull" | "pulls" | "discussion" | "discussions" | "actions-run" | "actions-job" | "other";
+    owner: string;
+    repo: string;
+    ref?: string;
+    path?: string;
+    number?: number;
+    runId?: number;
+    jobId?: number;
+}
+/**
+ * Parse GitHub URL into components
+ */
+export declare function parseGitHubUrl(url: string): GitHubUrl | null;
 /**
  * Fetch from GitHub API
  */
@@ -6,7 +20,15 @@ export declare function fetchGitHubApi(endpoint: string, timeout: number, signal
     data: unknown;
     ok: boolean;
 }>;
+/**
+ * Strip the per-line ISO-8601 timestamp prefix GitHub prepends to every job log line.
+ * Cuts ~28 bytes/line of noise while preserving the message text. Also drops the leading
+ * UTF-8 BOM GitHub puts at the start of the log file (otherwise the first line's timestamp
+ * survives because `^` no longer sits before a digit).
+ */
+export declare function stripActionsLogTimestamps(logs: string): string;
 /**
  * Handle GitHub URLs specially
  */
 export declare const handleGitHub: SpecialHandler;
+export {};

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

@@ -1,2 +1,5 @@
+/**
+ * Read the Docs handler for web-fetch
+ */
 import { type SpecialHandler } from "./types";
 export declare const handleReadTheDocs: SpecialHandler;

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

@@ -27,6 +27,12 @@ export interface LoadPageOptions {
     body?: string;
     maxBytes?: number;
     signal?: AbortSignal;
+    /**
+     * Return true to skip reading the response body for this content type
+     * (lowercased mime, no params). The caller is expected to re-fetch the
+     * payload as binary; this avoids streaming + decoding huge binaries twice.
+     */
+    skipBodyForContentType?: (contentType: string) => boolean;
 }
 export interface LoadPageResult {
     content: string;
@@ -34,6 +40,12 @@ export interface LoadPageResult {
     finalUrl: string;
     ok: boolean;
     status?: number;
+    /** True when the body was cut mid-stream at maxBytes. */
+    truncated?: boolean;
+    /** Last transport-level error message when ok is false. */
+    error?: string;
+    /** True when the body read was skipped via skipBodyForContentType. */
+    bodySkipped?: boolean;
 }
 /**
  * Fetch a page with timeout and size limit

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

@@ -6,7 +6,7 @@
  */
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@prometheus-ai/agent-core";
 import type { AuthStorage } from "@prometheus-ai/ai";
-import * as z from "zod/v4";
+import { z } from "zod/v4";
 import type { CustomTool } from "../../extensibility/custom-tools/types";
 import type { ToolSession } from "../../tools";
 import { type SearchRenderDetails } from "./render";

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

@@ -4,7 +4,7 @@
  * 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 "@prometheus-ai/ai";
+import { type AuthStorage, type FetchImpl } from "@prometheus-ai/ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";
@@ -15,6 +15,7 @@ export interface AnthropicSearchParams {
     max_tokens?: number;
     temperature?: number;
     signal?: AbortSignal;
+    fetch?: FetchImpl;
 }
 /**
  * Executes a web search using Anthropic's Claude with built-in web search tool.

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

@@ -1,4 +1,4 @@
-import type { AuthStorage } from "@prometheus-ai/ai";
+import type { AuthStorage, FetchImpl } from "@prometheus-ai/ai";
 import type { SearchProviderId, SearchResponse } from "../types";
 /**
  * Shared web search parameters passed to providers.
@@ -29,6 +29,7 @@ export interface SearchParams {
     recency?: "day" | "week" | "month" | "year";
     systemPrompt: string;
     signal?: AbortSignal;
+    fetch?: FetchImpl;
     maxOutputTokens?: number;
     numSearchResults?: number;
     temperature?: number;

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

@@ -4,7 +4,7 @@
  * 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 "@prometheus-ai/ai";
+import { type AuthStorage, type FetchImpl } from "@prometheus-ai/ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";
@@ -13,6 +13,7 @@ export interface BraveSearchParams {
     num_results?: number;
     recency?: "day" | "week" | "month" | "year";
     signal?: AbortSignal;
+    fetch?: FetchImpl;
 }
 /** Find BRAVE_API_KEY from environment or .env files. */
 export declare function findApiKey(): string | null;

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

@@ -1,9 +1,10 @@
-import { type AuthStorage } from "@prometheus-ai/ai";
+import { type AuthStorage, type FetchImpl } from "@prometheus-ai/ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";
 export interface CodexSearchParams {
     signal?: AbortSignal;
+    fetch?: FetchImpl;
     query: string;
     system_prompt?: string;
     num_results?: number;

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

@@ -6,7 +6,7 @@
  * Requests per-result summaries via `contents.summary` and synthesizes
  * them into a combined `answer` string on the SearchResponse.
  */
-import { type AuthStorage } from "@prometheus-ai/ai";
+import { type AuthStorage, type FetchImpl } from "@prometheus-ai/ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";
@@ -21,6 +21,7 @@ export interface ExaSearchParams {
     start_published_date?: string;
     end_published_date?: string;
     signal?: AbortSignal;
+    fetch?: FetchImpl;
     /**
      * Credential source. Resolved before falling back to `EXA_API_KEY` so
      * Exa works when the key is stored via the broker/auth pipeline.

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

@@ -8,10 +8,12 @@
  * sibling SQLite store and never POSTs the broker sentinel to a Google token
  * endpoint.
  */
-import { type AuthStorage } from "@prometheus-ai/ai";
+import { type AuthStorage, type FetchImpl, type OAuthAccess } from "@prometheus-ai/ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";
+declare const GEMINI_PROVIDERS: readonly ["google-gemini-cli", "google-antigravity"];
+type GeminiProviderId = (typeof GEMINI_PROVIDERS)[number];
 interface GeminiToolParams {
     google_search?: Record<string, unknown>;
     code_execution?: Record<string, unknown>;
@@ -28,21 +30,23 @@ export interface GeminiSearchParams extends GeminiToolParams {
     signal?: AbortSignal;
     authStorage: AuthStorage;
     sessionId?: string;
+    fetch?: FetchImpl;
 }
 export declare function buildGeminiRequestTools(params: GeminiToolParams): Array<Record<string, Record<string, unknown>>>;
-/** Resolved auth for a Gemini API request. */
-interface GeminiAuth {
-    accessToken: string;
+/** First configured Gemini OAuth provider plus its pre-resolved access. */
+interface GeminiAuthSeed {
+    provider: GeminiProviderId;
+    access: OAuthAccess;
     projectId: string;
-    isAntigravity: boolean;
 }
 /**
  * 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.
+ * The resolved access seeds `withOAuthAccess` so the happy path resolves once.
  */
-export declare function findGeminiAuth(authStorage: AuthStorage, sessionId: string | undefined, signal: AbortSignal | undefined): Promise<GeminiAuth | null>;
+export declare function findGeminiAuth(authStorage: AuthStorage, sessionId: string | undefined, signal: AbortSignal | undefined): Promise<GeminiAuthSeed | null>;
 /**
  * Executes a web search using Google Gemini with Google Search grounding.
  */

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

@@ -4,14 +4,18 @@
  * Uses the Jina Reader `s.jina.ai` endpoint to fetch search results with
  * cleaned content.
  */
-import { type AuthStorage } from "@prometheus-ai/ai";
+import { type AuthStorage, type FetchImpl } from "@prometheus-ai/ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";
+type SearchParamsWithFetch = SearchParams & {
+    fetch?: FetchImpl;
+};
 export interface JinaSearchParams {
     query: string;
     num_results?: number;
     signal?: AbortSignal;
+    fetch?: FetchImpl;
 }
 /** Find JINA_API_KEY from environment or .env files. */
 export declare function findApiKey(): string | null;
@@ -22,5 +26,6 @@ export declare class JinaProvider extends SearchProvider {
     readonly id = "jina";
     readonly label = "Jina";
     isAvailable(_authStorage: AuthStorage): boolean;
-    search(params: SearchParams): Promise<SearchResponse>;
+    search(params: SearchParamsWithFetch): Promise<SearchResponse>;
 }
+export {};

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

@@ -3,10 +3,13 @@
  *
  * Thin wrapper that adapts shared Kagi API utilities to SearchResponse shape.
  */
-import type { AuthStorage } from "@prometheus-ai/ai";
+import type { AuthStorage, FetchImpl } from "@prometheus-ai/ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";
+type SearchParamsWithFetch = SearchParams & {
+    fetch?: FetchImpl;
+};
 /** Execute Kagi web search. */
 export declare function searchKagi(params: {
     query: string;
@@ -15,11 +18,13 @@ export declare function searchKagi(params: {
     signal?: AbortSignal;
     authStorage: AuthStorage;
     sessionId?: string;
+    fetch?: FetchImpl;
 }): Promise<SearchResponse>;
 /** Search provider for Kagi web search. */
 export declare class KagiProvider extends SearchProvider {
     readonly id = "kagi";
     readonly label = "Kagi";
     isAvailable(authStorage: AuthStorage): boolean;
-    search(params: SearchParams): Promise<SearchResponse>;
+    search(params: SearchParamsWithFetch): Promise<SearchResponse>;
 }
+export {};

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

@@ -4,10 +4,13 @@
  * Uses Moonshot Kimi Code search API to retrieve web results.
  * Endpoint: POST https://api.kimi.com/coding/v1/search
  */
-import type { AuthStorage } from "@prometheus-ai/ai";
+import { type AuthStorage, type FetchImpl } from "@prometheus-ai/ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";
+type SearchParamsWithFetch = SearchParams & {
+    fetch?: FetchImpl;
+};
 export interface KimiSearchParams {
     query: string;
     num_results?: number;
@@ -15,6 +18,7 @@ export interface KimiSearchParams {
     signal?: AbortSignal;
     authStorage: AuthStorage;
     sessionId?: string;
+    fetch?: FetchImpl;
 }
 /** Execute Kimi web search. */
 export declare function searchKimi(params: KimiSearchParams): Promise<SearchResponse>;
@@ -23,5 +27,6 @@ export declare class KimiProvider extends SearchProvider {
     readonly id = "kimi";
     readonly label = "Kimi";
     isAvailable(authStorage: AuthStorage): boolean;
-    search(params: SearchParams): Promise<SearchResponse>;
+    search(params: SearchParamsWithFetch): Promise<SearchResponse>;
 }
+export {};