agentic-pi 0.2.2 → 0.2.4

package/dist/extensions/web-search/extract.js

@@ -0,0 +1,110 @@
+/**
+ * Minimal HTML → readable text extractor. No dependencies.
+ *
+ * Approach:
+ *   1. Strip <script>, <style>, <noscript>, <iframe>, and HTML comments
+ *      so the agent never sees code or hidden trackers.
+ *   2. Replace block-level tags with newlines so paragraphs stay separated.
+ *   3. Drop all other tags.
+ *   4. Decode the common named entities and any &#NN; / &#xHH; numeric
+ *      escapes.
+ *   5. Collapse runs of whitespace; cap output at MAX_BYTES.
+ *
+ * Not a Readability-style content-only extractor — for that, use Tavily or
+ * Exa's native extraction, which the provider clients invoke directly.
+ */
+export const EXTRACT_MAX_BYTES = 200 * 1024;
+const NAMED_ENTITIES = {
+    amp: "&",
+    lt: "<",
+    gt: ">",
+    quot: '"',
+    apos: "'",
+    nbsp: " ",
+    copy: "(c)",
+    reg: "(R)",
+    trade: "(TM)",
+    hellip: "…",
+    mdash: "—",
+    ndash: "–",
+    lsquo: "‘",
+    rsquo: "’",
+    ldquo: "“",
+    rdquo: "”",
+};
+function decodeEntities(s) {
+    return s.replace(/&(#x?[0-9a-fA-F]+|[a-zA-Z]+);/g, (_m, body) => {
+        if (body.startsWith("#x") || body.startsWith("#X")) {
+            const code = parseInt(body.slice(2), 16);
+            return Number.isFinite(code) ? safeFromCodePoint(code) : _m;
+        }
+        if (body.startsWith("#")) {
+            const code = parseInt(body.slice(1), 10);
+            return Number.isFinite(code) ? safeFromCodePoint(code) : _m;
+        }
+        const mapped = NAMED_ENTITIES[body];
+        return mapped ?? _m;
+    });
+}
+function safeFromCodePoint(code) {
+    if (code < 0 || code > 0x10ffff)
+        return "";
+    try {
+        return String.fromCodePoint(code);
+    }
+    catch {
+        return "";
+    }
+}
+const BLOCK_TAGS = new Set([
+    "p", "br", "div", "section", "article", "header", "footer", "main",
+    "nav", "aside", "ul", "ol", "li", "table", "tr", "td", "th",
+    "h1", "h2", "h3", "h4", "h5", "h6", "blockquote", "hr", "pre", "code",
+    "dl", "dt", "dd", "figure", "figcaption",
+]);
+export function extractTitle(html) {
+    const m = /<title[^>]*>([\s\S]*?)<\/title>/i.exec(html);
+    if (!m)
+        return undefined;
+    const t = decodeEntities(m[1]).replace(/\s+/g, " ").trim();
+    return t.length > 0 ? t : undefined;
+}
+export function htmlToText(html, maxBytes = EXTRACT_MAX_BYTES) {
+    // 1. Strip dangerous / noise sections wholesale.
+    let s = html.replace(/<!--[\s\S]*?-->/g, "");
+    s = s.replace(/<script\b[\s\S]*?<\/script\s*>/gi, "");
+    s = s.replace(/<style\b[\s\S]*?<\/style\s*>/gi, "");
+    s = s.replace(/<noscript\b[\s\S]*?<\/noscript\s*>/gi, "");
+    s = s.replace(/<iframe\b[\s\S]*?<\/iframe\s*>/gi, "");
+    // 2. Convert block-level open/close tags to newlines so paragraphs survive.
+    s = s.replace(/<\/?([a-zA-Z][a-zA-Z0-9]*)\b[^>]*>/g, (_match, tag) => {
+        if (BLOCK_TAGS.has(tag.toLowerCase()))
+            return "\n";
+        return "";
+    });
+    // 3. Decode entities.
+    s = decodeEntities(s);
+    // 4. Normalize whitespace: collapse runs of spaces/tabs; trim per line;
+    //    collapse runs of blank lines.
+    s = s.replace(/\r\n?/g, "\n");
+    s = s
+        .split("\n")
+        .map((line) => line.replace(/[ \t\f\v]+/g, " ").trim())
+        .filter((line, i, arr) => {
+        // collapse 2+ blank lines down to 1
+        if (line !== "")
+            return true;
+        return arr[i - 1] !== "";
+    })
+        .join("\n")
+        .trim();
+    // 5. Byte cap. UTF-8 size approximation by encoding; on overflow, slice
+    //    on code-point boundary then re-decode.
+    const encoder = new TextEncoder();
+    const bytes = encoder.encode(s);
+    if (bytes.byteLength <= maxBytes)
+        return s;
+    // Decode just the prefix.
+    return new TextDecoder("utf-8", { fatal: false }).decode(bytes.subarray(0, maxBytes));
+}
+//# sourceMappingURL=extract.js.map

package/dist/extensions/web-search/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../../src/extensions/web-search/extract.ts"],"names":[],"mappings":"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"}

package/dist/extensions/web-search/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Web-search extension entry point.
+ *
+ * Mirrors `src/extensions/github/index.ts`:
+ *   - silent skip when no provider is selected / no key present
+ *   - loud (warning-worthy) skip when the user explicitly asked for a
+ *     provider but didn't supply its key, or set an unknown name
+ *   - on success, hands a typed customTools list back to the runner
+ *
+ * Selection logic lives in `selection.ts`; this module wires the chosen
+ * provider to its tool builder and a per-run RateLimiter.
+ */
+import type { ToolDefinition } from "@earendil-works/pi-coding-agent";
+import type { ProviderName, WebSearchSkipReason } from "./types.js";
+export declare const DEFAULT_MAX_CALLS = 30;
+export interface WebSearchExtensionConfig {
+    /** When false, the extension is force-skipped (disabled-by-flag). Default: true. */
+    webSearch?: boolean;
+    /** Explicit provider override. */
+    webSearchProvider?: string;
+    /** Per-run call budget shared across web_search + web_fetch. Default: 30. */
+    webSearchMaxCalls?: number;
+    /** Env override (defaults to process.env). Injected by tests. */
+    env?: Record<string, string | undefined>;
+}
+export interface WebSearchExtensionResult {
+    /** Tools to merge into createAgentSession({ customTools }). */
+    customTools: ToolDefinition<any>[];
+    toolNames: string[];
+    status: "configured" | "skipped";
+    reason?: WebSearchSkipReason;
+    message?: string;
+    provider?: ProviderName;
+    /** The cap actually enforced (echoed for observability). */
+    maxCalls?: number;
+}
+export declare function loadWebSearchExtension(config?: WebSearchExtensionConfig): WebSearchExtensionResult;
+/**
+ * True if the skip is something the user almost certainly wants surfaced
+ * as a warning (vs. the silent "no keys set" case).
+ */
+export declare function isMisconfigurationSkip(result: WebSearchExtensionResult): boolean;
+export type { ProviderName, WebSearchSkipReason } from "./types.js";

package/dist/extensions/web-search/index.js

@@ -0,0 +1,86 @@
+/**
+ * Web-search extension entry point.
+ *
+ * Mirrors `src/extensions/github/index.ts`:
+ *   - silent skip when no provider is selected / no key present
+ *   - loud (warning-worthy) skip when the user explicitly asked for a
+ *     provider but didn't supply its key, or set an unknown name
+ *   - on success, hands a typed customTools list back to the runner
+ *
+ * Selection logic lives in `selection.ts`; this module wires the chosen
+ * provider to its tool builder and a per-run RateLimiter.
+ */
+import { createBraveProvider } from "./providers/brave.js";
+import { createExaProvider } from "./providers/exa.js";
+import { createTavilyProvider } from "./providers/tavily.js";
+import { RateLimiter } from "./rate-limit.js";
+import { selectProvider } from "./selection.js";
+import { buildWebSearchTools } from "./tools.js";
+export const DEFAULT_MAX_CALLS = 30;
+export function loadWebSearchExtension(config = {}) {
+    const env = config.env ?? process.env;
+    const input = {
+        webSearch: config.webSearch ?? true,
+        webSearchProvider: config.webSearchProvider,
+        env,
+    };
+    const selection = selectProvider(input);
+    if (selection.status === "skipped") {
+        return {
+            customTools: [],
+            toolNames: [],
+            status: "skipped",
+            reason: selection.reason,
+            message: selection.message,
+            provider: selection.provider,
+        };
+    }
+    const provider = instantiateProvider(selection.provider, selection.apiKey);
+    const maxCalls = clampMaxCalls(config.webSearchMaxCalls);
+    const limiter = new RateLimiter(maxCalls);
+    const tools = buildWebSearchTools(provider, limiter);
+    return {
+        customTools: tools,
+        toolNames: tools.map((t) => t.name),
+        status: "configured",
+        provider: selection.provider,
+        message: selection.message,
+        maxCalls,
+    };
+}
+/**
+ * True if the skip is something the user almost certainly wants surfaced
+ * as a warning (vs. the silent "no keys set" case).
+ */
+export function isMisconfigurationSkip(result) {
+    if (result.status !== "skipped")
+        return false;
+    if (result.reason === "invalid-config")
+        return true;
+    // Explicit provider asked for, but no key — louder than the generic
+    // "no creds at all" skip.
+    if (result.reason === "no-credentials" && result.provider !== undefined)
+        return true;
+    return false;
+}
+function instantiateProvider(name, apiKey) {
+    switch (name) {
+        case "tavily":
+            return createTavilyProvider({ apiKey });
+        case "brave":
+            return createBraveProvider({ apiKey });
+        case "exa":
+            return createExaProvider({ apiKey });
+    }
+}
+function clampMaxCalls(v) {
+    if (v === undefined || !Number.isFinite(v))
+        return DEFAULT_MAX_CALLS;
+    const n = Math.floor(v);
+    if (n < 1)
+        return 1;
+    if (n > 1000)
+        return 1000;
+    return n;
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/web-search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/web-search/index.ts"],"names":[],"mappings":"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"}

package/dist/extensions/web-search/providers/brave.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Brave Search provider. https://api.search.brave.com/app/documentation
+ *
+ * Endpoint used:
+ *   GET https://api.search.brave.com/res/v1/web/search?q=…&count=…
+ *   Header: X-Subscription-Token: <key>
+ *
+ * Brave has no content-extraction endpoint, so this provider has no
+ * `fetch()` method — the tool layer falls back to safeFetch + the HTML
+ * extractor for `web_fetch`.
+ *
+ * `include_domains` / `exclude_domains` are honored via client-side
+ * post-filtering so the tool's schema behaves uniformly across providers.
+ */
+import type { FetchImpl, Provider } from "../types.js";
+export interface BraveOptions {
+    apiKey: string;
+    fetchImpl?: FetchImpl;
+    baseUrl?: string;
+}
+export declare function createBraveProvider(options: BraveOptions): Provider;

package/dist/extensions/web-search/providers/brave.js

@@ -0,0 +1,73 @@
+/**
+ * Brave Search provider. https://api.search.brave.com/app/documentation
+ *
+ * Endpoint used:
+ *   GET https://api.search.brave.com/res/v1/web/search?q=…&count=…
+ *   Header: X-Subscription-Token: <key>
+ *
+ * Brave has no content-extraction endpoint, so this provider has no
+ * `fetch()` method — the tool layer falls back to safeFetch + the HTML
+ * extractor for `web_fetch`.
+ *
+ * `include_domains` / `exclude_domains` are honored via client-side
+ * post-filtering so the tool's schema behaves uniformly across providers.
+ */
+function hostMatches(url, pattern) {
+    let host;
+    try {
+        host = new URL(url).hostname.toLowerCase();
+    }
+    catch {
+        return false;
+    }
+    const p = pattern.toLowerCase();
+    return host === p || host.endsWith(`.${p}`);
+}
+export function createBraveProvider(options) {
+    const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    const baseUrl = options.baseUrl ?? "https://api.search.brave.com/res/v1";
+    return {
+        name: "brave",
+        supportsExtractedContent: false,
+        async search(params) {
+            const url = new URL(`${baseUrl}/web/search`);
+            url.searchParams.set("q", params.query);
+            // Brave's `count` caps at 20; we then post-filter and slice.
+            url.searchParams.set("count", String(Math.min(20, Math.max(1, params.maxResults * 2))));
+            const r = await fetchImpl(url.toString(), {
+                method: "GET",
+                headers: {
+                    accept: "application/json",
+                    "x-subscription-token": options.apiKey,
+                },
+            });
+            if (!r.ok) {
+                const text = await r.text().catch(() => "");
+                throw new Error(`brave search failed: http ${r.status} ${text.slice(0, 200)}`);
+            }
+            const data = (await r.json());
+            const items = (data.web?.results ?? []).map((it) => ({
+                title: it.title ?? "",
+                url: it.url ?? "",
+                snippet: it.description,
+                publishedDate: it.age,
+            }));
+            let filtered = items;
+            if (params.includeDomains?.length) {
+                const list = params.includeDomains;
+                filtered = filtered.filter((it) => it.url && list.some((d) => hostMatches(it.url, d)));
+            }
+            if (params.excludeDomains?.length) {
+                const list = params.excludeDomains;
+                filtered = filtered.filter((it) => !(it.url && list.some((d) => hostMatches(it.url, d))));
+            }
+            filtered = filtered.slice(0, params.maxResults);
+            return {
+                provider: "brave",
+                query: params.query,
+                results: filtered,
+            };
+        },
+    };
+}
+//# sourceMappingURL=brave.js.map

package/dist/extensions/web-search/providers/brave.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brave.js","sourceRoot":"","sources":["../../../../src/extensions/web-search/providers/brave.ts"],"names":[],"mappings":"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"}

package/dist/extensions/web-search/providers/exa.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Exa provider. https://docs.exa.ai/
+ *
+ * Endpoints used:
+ *   POST https://api.exa.ai/search    — neural/keyword search
+ *   POST https://api.exa.ai/contents  — fetch extracted content for one or more URLs
+ *
+ * Auth: `x-api-key: <key>`.
+ */
+import type { FetchImpl, Provider } from "../types.js";
+export interface ExaOptions {
+    apiKey: string;
+    fetchImpl?: FetchImpl;
+    baseUrl?: string;
+}
+export declare function createExaProvider(options: ExaOptions): Provider;

package/dist/extensions/web-search/providers/exa.js

@@ -0,0 +1,85 @@
+/**
+ * Exa provider. https://docs.exa.ai/
+ *
+ * Endpoints used:
+ *   POST https://api.exa.ai/search    — neural/keyword search
+ *   POST https://api.exa.ai/contents  — fetch extracted content for one or more URLs
+ *
+ * Auth: `x-api-key: <key>`.
+ */
+export function createExaProvider(options) {
+    const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    const baseUrl = options.baseUrl ?? "https://api.exa.ai";
+    return {
+        name: "exa",
+        supportsExtractedContent: true,
+        async search(params) {
+            const body = {
+                query: params.query,
+                numResults: params.maxResults,
+                type: params.searchDepth === "advanced" ? "neural" : "auto",
+            };
+            if (params.includeDomains?.length)
+                body.includeDomains = params.includeDomains;
+            if (params.excludeDomains?.length)
+                body.excludeDomains = params.excludeDomains;
+            if (params.includeContent === true) {
+                body.contents = { text: { maxCharacters: 4000 } };
+            }
+            const r = await fetchImpl(`${baseUrl}/search`, {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json",
+                    "x-api-key": options.apiKey,
+                },
+                body: JSON.stringify(body),
+            });
+            if (!r.ok) {
+                const text = await r.text().catch(() => "");
+                throw new Error(`exa search failed: http ${r.status} ${text.slice(0, 200)}`);
+            }
+            const data = (await r.json());
+            return {
+                provider: "exa",
+                query: params.query,
+                results: (data.results ?? []).map((it) => ({
+                    title: it.title ?? "",
+                    url: it.url ?? "",
+                    content: it.text,
+                    score: it.score,
+                    publishedDate: it.publishedDate,
+                })),
+            };
+        },
+        async fetch(params) {
+            const r = await fetchImpl(`${baseUrl}/contents`, {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json",
+                    "x-api-key": options.apiKey,
+                },
+                body: JSON.stringify({
+                    urls: [params.url],
+                    text: true,
+                }),
+            });
+            if (!r.ok) {
+                const text = await r.text().catch(() => "");
+                throw new Error(`exa contents failed: http ${r.status} ${text.slice(0, 200)}`);
+            }
+            const data = (await r.json());
+            const hit = data.results?.[0];
+            if (!hit?.text) {
+                throw new Error(`exa contents returned no text for ${params.url}`);
+            }
+            return {
+                provider: "exa",
+                url: params.url,
+                resolvedUrl: hit.url,
+                text: hit.text,
+                title: hit.title,
+            };
+        },
+    };
+}
+//# sourceMappingURL=exa.js.map

package/dist/extensions/web-search/providers/exa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exa.js","sourceRoot":"","sources":["../../../../src/extensions/web-search/providers/exa.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmCH,MAAM,UAAU,iBAAiB,CAAC,OAAmB;IACnD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAK,UAAU,CAAC,KAAmB,CAAC;IACvE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,oBAAoB,CAAC;IAExD,OAAO;QACL,IAAI,EAAE,KAAK;QACX,wBAAwB,EAAE,IAAI;QAE9B,KAAK,CAAC,MAAM,CAAC,MAAoB;YAC/B,MAAM,IAAI,GAA4B;gBACpC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,IAAI,EAAE,MAAM,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM;aAC5D,CAAC;YACF,IAAI,MAAM,CAAC,cAAc,EAAE,MAAM;gBAAE,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;YAC/E,IAAI,MAAM,CAAC,cAAc,EAAE,MAAM;gBAAE,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;YAC/E,IAAI,MAAM,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;gBACnC,IAAI,CAAC,QAAQ,GAAG,EAAE,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,CAAC;YACpD,CAAC;YAED,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC,GAAG,OAAO,SAAS,EAAE;gBAC7C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,WAAW,EAAE,OAAO,CAAC,MAAM;iBAC5B;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAC3B,CAAC,CAAC;YACH,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACV,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC5C,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/E,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAsB,CAAC;YACnD,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;oBACzC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE;oBACrB,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE;oBACjB,OAAO,EAAE,EAAE,CAAC,IAAI;oBAChB,KAAK,EAAE,EAAE,CAAC,KAAK;oBACf,aAAa,EAAE,EAAE,CAAC,aAAa;iBAChC,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,MAAmB;YAC7B,MAAM,CAAC,GAAG,MAAM,SAAS,CAAC,GAAG,OAAO,WAAW,EAAE;gBAC/C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,WAAW,EAAE,OAAO,CAAC,MAAM;iBAC5B;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,IAAI,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC;oBAClB,IAAI,EAAE,IAAI;iBACX,CAAC;aACH,CAAC,CAAC;YACH,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACV,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC5C,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACjF,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAwB,CAAC;YACrD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,qCAAqC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;YACrE,CAAC;YACD,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,WAAW,EAAE,GAAG,CAAC,GAAG;gBACpB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,KAAK,EAAE,GAAG,CAAC,KAAK;aACjB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/extensions/web-search/providers/tavily.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Tavily provider. https://docs.tavily.com/
+ *
+ * Endpoints used:
+ *   POST https://api.tavily.com/search   — ranked links + optional content + optional answer
+ *   POST https://api.tavily.com/extract  — bulk fetch + extracted text for a list of URLs
+ *
+ * API key passed as `api_key` in the JSON body (Tavily's documented
+ * convention; the Bearer header is rejected on /search).
+ */
+import type { FetchImpl, Provider } from "../types.js";
+export interface TavilyOptions {
+    apiKey: string;
+    fetchImpl?: FetchImpl;
+    /** Override for tests. */
+    baseUrl?: string;
+}
+export declare function createTavilyProvider(options: TavilyOptions): Provider;

package/dist/extensions/web-search/providers/tavily.js

@@ -0,0 +1,85 @@
+/**
+ * Tavily provider. https://docs.tavily.com/
+ *
+ * Endpoints used:
+ *   POST https://api.tavily.com/search   — ranked links + optional content + optional answer
+ *   POST https://api.tavily.com/extract  — bulk fetch + extracted text for a list of URLs
+ *
+ * API key passed as `api_key` in the JSON body (Tavily's documented
+ * convention; the Bearer header is rejected on /search).
+ */
+export function createTavilyProvider(options) {
+    const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    const baseUrl = options.baseUrl ?? "https://api.tavily.com";
+    return {
+        name: "tavily",
+        supportsExtractedContent: true,
+        async search(params) {
+            const body = {
+                api_key: options.apiKey,
+                query: params.query,
+                max_results: params.maxResults,
+                search_depth: params.searchDepth === "advanced" ? "advanced" : "basic",
+                include_answer: true,
+                include_raw_content: params.includeContent === true,
+            };
+            if (params.includeDomains?.length)
+                body.include_domains = params.includeDomains;
+            if (params.excludeDomains?.length)
+                body.exclude_domains = params.excludeDomains;
+            const r = await fetchImpl(`${baseUrl}/search`, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify(body),
+            });
+            if (!r.ok) {
+                const text = await r.text().catch(() => "");
+                throw new Error(`tavily search failed: http ${r.status} ${text.slice(0, 200)}`);
+            }
+            const data = (await r.json());
+            return {
+                provider: "tavily",
+                query: data.query ?? params.query,
+                answer: data.answer,
+                results: (data.results ?? []).map((it) => ({
+                    title: it.title ?? "",
+                    url: it.url ?? "",
+                    snippet: it.content,
+                    content: it.raw_content ?? undefined,
+                    score: it.score,
+                    publishedDate: it.published_date,
+                })),
+            };
+        },
+        async fetch(params) {
+            const r = await fetchImpl(`${baseUrl}/extract`, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({
+                    api_key: options.apiKey,
+                    urls: [params.url],
+                }),
+            });
+            if (!r.ok) {
+                const text = await r.text().catch(() => "");
+                throw new Error(`tavily extract failed: http ${r.status} ${text.slice(0, 200)}`);
+            }
+            const data = (await r.json());
+            const hit = data.results?.[0];
+            if (!hit?.raw_content) {
+                const fail = data.failed_results?.[0];
+                throw new Error(fail?.error
+                    ? `tavily extract returned no content for ${params.url}: ${fail.error}`
+                    : `tavily extract returned no content for ${params.url}`);
+            }
+            return {
+                provider: "tavily",
+                url: params.url,
+                resolvedUrl: hit.url,
+                text: hit.raw_content,
+                title: hit.title,
+            };
+        },
+    };
+}
+//# sourceMappingURL=tavily.js.map

package/dist/extensions/web-search/providers/tavily.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tavily.js","sourceRoot":"","sources":["../../../../src/extensions/web-search/providers/tavily.ts"],"names":[],"mappings":"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"}

package/dist/extensions/web-search/rate-limit.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tiny per-run call counter. Shared between web_search and web_fetch so the
+ * combined call count is bounded.
+ *
+ * When `max` is exceeded `consume()` returns false; the tool layer surfaces
+ * this as a structured error result (never throws).
+ */
+export declare class RateLimiter {
+    readonly max: number;
+    private used;
+    constructor(max: number);
+    consume(): boolean;
+    get remaining(): number;
+}

package/dist/extensions/web-search/rate-limit.js

@@ -0,0 +1,24 @@
+/**
+ * Tiny per-run call counter. Shared between web_search and web_fetch so the
+ * combined call count is bounded.
+ *
+ * When `max` is exceeded `consume()` returns false; the tool layer surfaces
+ * this as a structured error result (never throws).
+ */
+export class RateLimiter {
+    max;
+    used = 0;
+    constructor(max) {
+        this.max = max;
+    }
+    consume() {
+        if (this.used >= this.max)
+            return false;
+        this.used += 1;
+        return true;
+    }
+    get remaining() {
+        return Math.max(0, this.max - this.used);
+    }
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/extensions/web-search/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../../../src/extensions/web-search/rate-limit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,OAAO,WAAW;IAED;IADb,IAAI,GAAG,CAAC,CAAC;IACjB,YAAqB,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAEpC,OAAO;QACL,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;CACF"}