@oh-my-pi/pi-coding-agent 15.1.1 → 15.1.2

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

@@ -0,0 +1,6 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Maven Central URLs via Solr API
+ * Supports: search.maven.org/artifact/... and mvnrepository.com/artifact/...
+ */
+export declare const handleMaven: SpecialHandler;

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

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleMDN: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle MetaCPAN URLs via fastapi.metacpan.org
+ */
+export declare const handleMetaCPAN: SpecialHandler;

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

@@ -0,0 +1,5 @@
+/**
+ * MusicBrainz URL handler for artists, releases, and recordings
+ */
+import type { SpecialHandler } from "./types";
+export declare const handleMusicBrainz: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle npm URLs via registry API
+ */
+export declare const handleNpm: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle NuGet URLs via API
+ */
+export declare const handleNuGet: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle NVD (National Vulnerability Database) CVE URLs
+ */
+export declare const handleNvd: SpecialHandler;

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

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleOllama: SpecialHandler;

package/dist/types/web/scrapers/open-vsx.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Open VSX URLs via their API
+ */
+export declare const handleOpenVsx: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle OpenCorporates URLs via API
+ */
+export declare const handleOpenCorporates: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Open Library URLs via their API
+ */
+export declare const handleOpenLibrary: SpecialHandler;

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

@@ -0,0 +1,5 @@
+/**
+ * ORCID handler for web-fetch
+ */
+import type { SpecialHandler } from "./types";
+export declare const handleOrcid: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle OSV (Open Source Vulnerabilities) URLs
+ */
+export declare const handleOsv: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Packagist URLs via JSON API
+ */
+export declare const handlePackagist: SpecialHandler;

package/dist/types/web/scrapers/pub-dev.d.ts

@@ -0,0 +1,5 @@
+import { type SpecialHandler } from "./types";
+/**
+ * Handle pub.dev URLs via API
+ */
+export declare const handlePubDev: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import { type SpecialHandler } from "./types";
+/**
+ * Handle PubMed URLs - fetch article metadata, abstract, MeSH terms
+ */
+export declare const handlePubMed: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import { type SpecialHandler } from "./types";
+/**
+ * Handle PyPI URLs via JSON API
+ */
+export declare const handlePyPI: SpecialHandler;

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

@@ -0,0 +1,2 @@
+import { type SpecialHandler } from "./types";
+export declare const handleRawg: SpecialHandler;

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

@@ -0,0 +1,2 @@
+import { type SpecialHandler } from "./types";
+export declare const handleReadTheDocs: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import { type SpecialHandler } from "./types";
+/**
+ * Handle Reddit URLs via JSON API
+ */
+export declare const handleReddit: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import { type SpecialHandler } from "./types";
+/**
+ * Handle Repology URLs via API
+ */
+export declare const handleRepology: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import { type SpecialHandler } from "./types";
+/**
+ * Handle RFC Editor URLs - fetches IETF RFCs
+ */
+export declare const handleRfc: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import { type SpecialHandler } from "./types";
+/**
+ * Handle RubyGems URLs via API
+ */
+export declare const handleRubyGems: SpecialHandler;

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

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleSearchcode: SpecialHandler;

package/dist/types/web/scrapers/sec-edgar.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle SEC EDGAR URLs via data.sec.gov API
+ */
+export declare const handleSecEdgar: SpecialHandler;

package/dist/types/web/scrapers/semantic-scholar.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleSemanticScholar: SpecialHandler;

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

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleSnapcraft: SpecialHandler;

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

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleSourcegraph: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle SPDX license URLs via SPDX JSON API
+ */
+export declare const handleSpdx: SpecialHandler;

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

@@ -0,0 +1,8 @@
+/**
+ * Spotify URL handler for podcasts, tracks, albums, and playlists
+ *
+ * Uses oEmbed API and Open Graph metadata to extract information
+ * from Spotify URLs without requiring authentication.
+ */
+import type { SpecialHandler } from "./types";
+export declare const handleSpotify: SpecialHandler;

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

@@ -0,0 +1,6 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Stack Exchange network URLs via API
+ * Supports stackoverflow.com, *.stackexchange.com, superuser.com, serverfault.com, askubuntu.com, etc.
+ */
+export declare const handleStackOverflow: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Terraform Registry URLs via API
+ */
+export declare const handleTerraform: SpecialHandler;

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

@@ -0,0 +1,7 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle tldr page URLs
+ * - https://tldr.sh/{command}
+ * - https://tldr.ostera.io/{command}
+ */
+export declare const handleTldr: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Twitter/X URLs via Nitter
+ */
+export declare const handleTwitter: SpecialHandler;

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

@@ -0,0 +1,77 @@
+export { formatNumber } from "@oh-my-pi/pi-utils";
+export interface RenderResult {
+    url: string;
+    finalUrl: string;
+    contentType: string;
+    method: string;
+    content: string;
+    fetchedAt: string;
+    truncated: boolean;
+    notes: string[];
+}
+export type SpecialHandler = (url: string, timeout: number, signal?: AbortSignal) => Promise<RenderResult | null>;
+export declare const MAX_OUTPUT_CHARS = 500000;
+export declare const MAX_BYTES: number;
+/**
+ * Truncate and cleanup output
+ */
+export declare function finalizeOutput(content: string): {
+    content: string;
+    truncated: boolean;
+};
+export interface LoadPageOptions {
+    timeout?: number;
+    headers?: Record<string, string>;
+    method?: string;
+    body?: string;
+    maxBytes?: number;
+    signal?: AbortSignal;
+}
+export interface LoadPageResult {
+    content: string;
+    contentType: string;
+    finalUrl: string;
+    ok: boolean;
+    status?: number;
+}
+/**
+ * Fetch a page with timeout and size limit
+ */
+export declare function loadPage(url: string, options?: LoadPageOptions): Promise<LoadPageResult>;
+/**
+ * Convert HTML to markdown using Turndown with GFM support.
+ * Strips script/style tags before conversion.
+ */
+export declare function htmlToBasicMarkdown(html: string): Promise<string>;
+/**
+ * Build a RenderResult from markdown content. Calls finalizeOutput internally.
+ */
+export declare function buildResult(md: string, opts: {
+    url: string;
+    finalUrl?: string;
+    method: string;
+    fetchedAt: string;
+    notes?: string[];
+    contentType?: string;
+}): RenderResult;
+/**
+ * Format a date value as YYYY-MM-DD. Returns empty string on invalid input.
+ */
+export declare function formatIsoDate(value?: string | number | Date): string;
+/**
+ * Decode common HTML entities.
+ */
+export declare function decodeHtmlEntities(text: string): string;
+/**
+ * Format seconds into HH:MM:SS or MM:SS.
+ */
+export declare function formatMediaDuration(totalSeconds: number): string;
+/**
+ * Extract localized text, preferring en-US/en.
+ */
+export type LocalizedText = string | Record<string, string | null> | null | undefined;
+export declare function getLocalizedText(value: LocalizedText, defaultLocale?: string): string | undefined;
+/**
+ * Check if content looks like HTML by inspecting the leading tag.
+ */
+export declare function looksLikeHtml(content: string): boolean;

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

@@ -0,0 +1,26 @@
+import { isRecord } from "@oh-my-pi/pi-utils";
+export { isRecord };
+export declare function asRecord(value: unknown): Record<string, unknown> | null;
+export declare function asString(value: unknown): string | null;
+export declare function asNumber(value: unknown): number | null;
+export interface BinaryFetchSuccess {
+    ok: true;
+    buffer: Uint8Array;
+    contentDisposition?: string;
+}
+export type BinaryFetchResult = BinaryFetchSuccess | {
+    ok: false;
+    error?: string;
+};
+/**
+ * Fetch binary content from a URL
+ */
+export declare function fetchBinary(url: string, timeout?: number, signal?: AbortSignal): Promise<BinaryFetchResult>;
+/**
+ * Convert binary content to markdown using markit.
+ */
+export declare function convertWithMarkit(buffer: Uint8Array, extension: string, timeout?: number, signal?: AbortSignal): Promise<{
+    content: string;
+    ok: boolean;
+    error?: string;
+}>;

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

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Vimeo URLs via oEmbed API
+ */
+export declare const handleVimeo: SpecialHandler;

package/dist/types/web/scrapers/vscode-marketplace.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle VS Code Marketplace URLs via extension query API
+ */
+export declare const handleVscodeMarketplace: SpecialHandler;

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

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleW3c: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Wikidata URLs via EntityData API
+ */
+export declare const handleWikidata: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Wikipedia URLs via Wikipedia API
+ */
+export declare const handleWikipedia: SpecialHandler;

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

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle YouTube URLs - fetch metadata and transcript
+ */
+export declare const handleYouTube: SpecialHandler;

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

@@ -0,0 +1,76 @@
+/**
+ * Unified Web Search Tool
+ *
+ * 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 * as z from "zod/v4";
+import type { CustomTool } from "../../extensibility/custom-tools/types";
+import type { ToolSession } from "../../tools";
+import { type SearchRenderDetails } from "./render";
+import type { SearchProviderId } from "./types";
+/** Web search tool parameters schema */
+export declare const webSearchSchema: z.ZodObject<{
+    query: z.ZodString;
+    recency: z.ZodOptional<z.ZodEnum<{
+        day: "day";
+        month: "month";
+        week: "week";
+        year: "year";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    max_tokens: z.ZodOptional<z.ZodNumber>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    num_search_results: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type SearchToolParams = z.infer<typeof webSearchSchema>;
+export interface SearchQueryParams extends SearchToolParams {
+    provider?: SearchProviderId | "auto";
+}
+/**
+ * Execute a web search query for CLI/testing workflows.
+ */
+export declare function runSearchQuery(params: SearchQueryParams): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    details: SearchRenderDetails;
+}>;
+/**
+ * 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> {
+    readonly name = "web_search";
+    readonly label = "Web Search";
+    readonly description: string;
+    readonly parameters: z.ZodObject<{
+        query: z.ZodString;
+        recency: z.ZodOptional<z.ZodEnum<{
+            day: "day";
+            month: "month";
+            week: "week";
+            year: "year";
+        }>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        max_tokens: z.ZodOptional<z.ZodNumber>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        num_search_results: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    readonly strict = true;
+    readonly loadMode = "discoverable";
+    readonly summary = "Search the web for up-to-date information";
+    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) */
+export declare const webSearchCustomTool: CustomTool<typeof webSearchSchema, SearchRenderDetails>;
+export declare function getSearchTools(): CustomTool<any, any>[];
+export { getSearchProvider, setPreferredSearchProvider } from "./provider";
+export type { SearchProviderId as SearchProvider, SearchResponse } from "./types";
+export { isSearchProviderPreference } from "./types";

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

@@ -0,0 +1,20 @@
+import type { SearchProvider } from "./providers/base";
+import type { SearchProviderId } from "./types";
+export type { SearchParams } from "./providers/base";
+export { SearchProvider } from "./providers/base";
+/** Cheap, sync metadata accessor — never triggers a provider load. */
+export declare function getSearchProviderLabel(id: SearchProviderId): string;
+/**
+ * Resolve and cache a provider instance. First call for a given id loads the
+ * underlying module; subsequent calls return the cached singleton.
+ */
+export declare function getSearchProvider(id: SearchProviderId): Promise<SearchProvider>;
+export declare const SEARCH_PROVIDER_ORDER: SearchProviderId[];
+/** Set the preferred web search provider from settings */
+export declare function setPreferredSearchProvider(provider: SearchProviderId | "auto"): void;
+/**
+ * Determine which providers are configured and currently available.
+ * 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[]>;

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

@@ -0,0 +1,27 @@
+import type { SearchResponse } from "../../../web/search/types";
+import type { SearchParams } from "./base";
+import { SearchProvider } from "./base";
+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;
+}
+/**
+ * Executes a web search using Anthropic's Claude with built-in web search tool.
+ * @param params - Search parameters including query and optional settings
+ * @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>;
+/** Search provider for Anthropic Claude web search. */
+export declare class AnthropicProvider extends SearchProvider {
+    readonly id = "anthropic";
+    readonly label = "Anthropic";
+    isAvailable(): Promise<boolean>;
+    search(params: SearchParams): Promise<SearchResponse>;
+}

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

@@ -0,0 +1,35 @@
+import type { SearchProviderId, SearchResponse } from "../types";
+/** Shared web search parameters passed to providers. */
+export interface SearchParams {
+    query: string;
+    limit?: number;
+    /**
+     * Temporal filter narrowing results to the specified time window.
+     *
+     * Providers MUST interpret this as a pure time filter. Providers MUST NOT
+     * use recency as an implicit signal to change topic scope, content domain,
+     * or ranking strategy. If a provider API couples temporal filtering with
+     * other dimensions (e.g. Tavily's `topic=news`), the provider implementation
+     * is responsible for decoupling them before calling the upstream API.
+     *
+     * Providers that do not support temporal filtering MUST ignore this field
+     * silently; they MUST NOT approximate it by rewriting the query or altering
+     * any other request parameter.
+     */
+    recency?: "day" | "week" | "month" | "year";
+    systemPrompt: string;
+    signal?: AbortSignal;
+    maxOutputTokens?: number;
+    numSearchResults?: number;
+    temperature?: number;
+    googleSearch?: Record<string, unknown>;
+    codeExecution?: Record<string, unknown>;
+    urlContext?: Record<string, unknown>;
+}
+/** Base class for web search providers. */
+export declare abstract class SearchProvider {
+    abstract readonly id: SearchProviderId;
+    abstract readonly label: string;
+    abstract isAvailable(): Promise<boolean> | boolean;
+    abstract search(params: SearchParams): Promise<SearchResponse>;
+}

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

@@ -0,0 +1,20 @@
+import type { SearchResponse } from "../../../web/search/types";
+import type { SearchParams } from "./base";
+import { SearchProvider } from "./base";
+export interface BraveSearchParams {
+    query: string;
+    num_results?: number;
+    recency?: "day" | "week" | "month" | "year";
+    signal?: AbortSignal;
+}
+/** Find BRAVE_API_KEY from environment or .env files. */
+export declare function findApiKey(): string | null;
+/** Execute Brave web search. */
+export declare function searchBrave(params: BraveSearchParams): Promise<SearchResponse>;
+/** Search provider for Brave web search. */
+export declare class BraveProvider extends SearchProvider {
+    readonly id = "brave";
+    readonly label = "Brave";
+    isAvailable(): Promise<boolean>;
+    search(params: SearchParams): Promise<SearchResponse>;
+}

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

@@ -0,0 +1,31 @@
+import type { SearchResponse } from "../../../web/search/types";
+import type { SearchParams } from "./base";
+import { SearchProvider } from "./base";
+export interface CodexSearchParams {
+    signal?: AbortSignal;
+    query: string;
+    system_prompt?: string;
+    num_results?: number;
+    /** Search context size: controls how much web content to include */
+    search_context_size?: "low" | "medium" | "high";
+}
+/**
+ * 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
+ */
+export declare function searchCodex(params: CodexSearchParams): 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>;
+/** Search provider for OpenAI Codex web search. */
+export declare class CodexProvider extends SearchProvider {
+    readonly id = "codex";
+    readonly label = "Codex";
+    isAvailable(): Promise<boolean>;
+    search(params: SearchParams): Promise<SearchResponse>;
+}

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

@@ -0,0 +1,43 @@
+import type { SearchResponse } from "../../../web/search/types";
+import type { SearchParams } from "./base";
+import { SearchProvider } from "./base";
+type ExaSearchType = "neural" | "fast" | "auto" | "deep";
+type ExaSearchParamType = ExaSearchType | "keyword";
+export interface ExaSearchParams {
+    query: string;
+    num_results?: number;
+    type?: ExaSearchParamType;
+    include_domains?: string[];
+    exclude_domains?: string[];
+    start_published_date?: string;
+    end_published_date?: string;
+    signal?: AbortSignal;
+}
+interface ExaSearchResult {
+    title?: string | null;
+    url?: string | null;
+    author?: string | null;
+    publishedDate?: string | null;
+    text?: string | null;
+    highlights?: string[] | null;
+    summary?: string | null;
+}
+export declare function normalizeSearchType(type: ExaSearchParamType | undefined): ExaSearchType;
+/**
+ * Synthesize an answer string from per-result summaries returned by Exa.
+ * Returns `undefined` when no non-empty summaries are available so callers
+ * can leave `SearchResponse.answer` unset (matching other providers).
+ */
+export declare function synthesizeAnswer(results: ExaSearchResult[]): string | undefined;
+/** Build the request body for `callExaSearch`. Exported for testing. */
+export declare function buildExaRequestBody(params: ExaSearchParams): Record<string, unknown>;
+/** Execute Exa web search */
+export declare function searchExa(params: ExaSearchParams): Promise<SearchResponse>;
+/** Search provider for Exa. */
+export declare class ExaProvider extends SearchProvider {
+    readonly id = "exa";
+    readonly label = "Exa";
+    isAvailable(): boolean;
+    search(params: SearchParams): Promise<SearchResponse>;
+}
+export {};