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

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

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

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

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle IACR ePrint Archive URLs
+ */
+export declare const handleIacr: SpecialHandler;

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

@@ -0,0 +1,84 @@
+/**
+ * Web Fetch Special Handlers Index
+ *
+ * Exports all special handlers for site-specific content extraction.
+ */
+import { handleArtifactHub } from "./artifacthub";
+import { handleArxiv } from "./arxiv";
+import { handleAur } from "./aur";
+import { handleBiorxiv } from "./biorxiv";
+import { handleBluesky } from "./bluesky";
+import { handleBrew } from "./brew";
+import { handleCheatSh } from "./cheatsh";
+import { handleChocolatey } from "./chocolatey";
+import { handleChooseALicense } from "./choosealicense";
+import { handleCisaKev } from "./cisa-kev";
+import { handleClojars } from "./clojars";
+import { handleCoinGecko } from "./coingecko";
+import { handleCratesIo } from "./crates-io";
+import { handleCrossref } from "./crossref";
+import { handleDevTo } from "./devto";
+import { handleDiscogs } from "./discogs";
+import { handleDiscourse } from "./discourse";
+import { handleDockerHub } from "./dockerhub";
+import { handleDocsRs } from "./docs-rs";
+import { handleFdroid } from "./fdroid";
+import { handleFirefoxAddons } from "./firefox-addons";
+import { handleFlathub } from "./flathub";
+import { fetchGitHubApi, handleGitHub } from "./github";
+import { handleGitHubGist } from "./github-gist";
+import { handleGitLab } from "./gitlab";
+import { handleGoPkg } from "./go-pkg";
+import { handleHackage } from "./hackage";
+import { handleHackerNews } from "./hackernews";
+import { handleHex } from "./hex";
+import { handleHuggingFace } from "./huggingface";
+import { handleIacr } from "./iacr";
+import { handleJetBrainsMarketplace } from "./jetbrains-marketplace";
+import { handleLemmy } from "./lemmy";
+import { handleLobsters } from "./lobsters";
+import { handleMastodon } from "./mastodon";
+import { handleMaven } from "./maven";
+import { handleMDN } from "./mdn";
+import { handleMetaCPAN } from "./metacpan";
+import { handleMusicBrainz } from "./musicbrainz";
+import { handleNpm } from "./npm";
+import { handleNuGet } from "./nuget";
+import { handleNvd } from "./nvd";
+import { handleOllama } from "./ollama";
+import { handleOpenVsx } from "./open-vsx";
+import { handleOpenCorporates } from "./opencorporates";
+import { handleOpenLibrary } from "./openlibrary";
+import { handleOrcid } from "./orcid";
+import { handleOsv } from "./osv";
+import { handlePackagist } from "./packagist";
+import { handlePubDev } from "./pub-dev";
+import { handlePubMed } from "./pubmed";
+import { handlePyPI } from "./pypi";
+import { handleRawg } from "./rawg";
+import { handleReadTheDocs } from "./readthedocs";
+import { handleReddit } from "./reddit";
+import { handleRepology } from "./repology";
+import { handleRfc } from "./rfc";
+import { handleRubyGems } from "./rubygems";
+import { handleSearchcode } from "./searchcode";
+import { handleSecEdgar } from "./sec-edgar";
+import { handleSemanticScholar } from "./semantic-scholar";
+import { handleSnapcraft } from "./snapcraft";
+import { handleSourcegraph } from "./sourcegraph";
+import { handleSpdx } from "./spdx";
+import { handleSpotify } from "./spotify";
+import { handleStackOverflow } from "./stackoverflow";
+import { handleTerraform } from "./terraform";
+import { handleTldr } from "./tldr";
+import { handleTwitter } from "./twitter";
+import type { SpecialHandler } from "./types";
+import { handleVimeo } from "./vimeo";
+import { handleVscodeMarketplace } from "./vscode-marketplace";
+import { handleW3c } from "./w3c";
+import { handleWikidata } from "./wikidata";
+import { handleWikipedia } from "./wikipedia";
+import { handleYouTube } from "./youtube";
+export type { RenderResult, SpecialHandler } from "./types";
+export { fetchGitHubApi, handleArtifactHub, handleArxiv, handleAur, handleBiorxiv, handleBluesky, handleBrew, handleCheatSh, handleChocolatey, handleChooseALicense, handleCisaKev, handleClojars, handleCoinGecko, handleCratesIo, handleCrossref, handleDevTo, handleDiscogs, handleDiscourse, handleDockerHub, handleDocsRs, handleFdroid, handleFirefoxAddons, handleFlathub, handleGitHub, handleGitHubGist, handleGitLab, handleGoPkg, handleHackage, handleHackerNews, handleHex, handleHuggingFace, handleIacr, handleJetBrainsMarketplace, handleLemmy, handleLobsters, handleMastodon, handleMaven, handleMDN, handleMetaCPAN, handleMusicBrainz, handleNpm, handleNuGet, handleNvd, handleOllama, handleOpenCorporates, handleOpenLibrary, handleOpenVsx, handleOrcid, handleOsv, handlePackagist, handlePubDev, handlePubMed, handlePyPI, handleRawg, handleReadTheDocs, handleReddit, handleRepology, handleRfc, handleRubyGems, handleSearchcode, handleSecEdgar, handleSemanticScholar, handleSnapcraft, handleSourcegraph, handleSpdx, handleSpotify, handleStackOverflow, handleTerraform, handleTldr, handleTwitter, handleVimeo, handleVscodeMarketplace, handleW3c, handleWikidata, handleWikipedia, handleYouTube, };
+export declare const specialHandlers: SpecialHandler[];

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

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

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

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

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

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

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

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Mastodon/Fediverse URLs
+ */
+export declare const handleMastodon: SpecialHandler;

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>;
+}