@pentoshi/clai 4.11.7 → 4.11.8

package/dist/tools/web/providers/duckduckgo.d.ts

@@ -1,47 +1,6 @@
-/**
- * DuckDuckGo search-provider adapter.
- *
- * Used as the keyless default so `clai` works out of the box without
- * any API key (Requirement 3.5). The adapter targets DuckDuckGo's
- * lite-HTML endpoint at `https://html.duckduckgo.com/html/?q=…`,
- * parses the response with `cheerio`, unwraps the in-page redirect
- * shim (`/l/?uddg=<encoded>`) so callers see the destination URL, and
- * applies the same URL filter `web.search` enforces (Requirement 7.3)
- * before forwarding hits to the registry handler.
- *
- * The adapter does not need redirect-chain capture, fine-grained
- * timing, TLS metadata, or DNS-rebinding protection beyond the
- * per-invocation `AbortSignal`, so it deliberately bypasses the full
- * `fetch-core` pipeline. A small `node:https.request`-based helper
- * keeps the implementation simple while still honoring the 15-second
- * `web.search` invocation timeout (Requirement 1.8) via the supplied
- * `AbortSignal`.
- *
- * Per Requirement 6.7 the adapter issues exactly one outbound request
- * per invocation and never retries on transient failure.
- */
 import https from "node:https";
 import type { SearchProvider } from "./provider.js";
-/**
- * Inject point for the underlying HTTPS transport. Mirrors the seam in
- * `./brave.ts` so unit tests can drive the adapter without touching the
- * network. Production code never invokes the setter.
- */
 type HttpsRequestFn = typeof https.request;
-/**
- * Test-only seam: swap the HTTPS transport used by the adapter. Tests use
- * this to inject a stubbed `request` implementation that emits scripted
- * responses; production callers never invoke it.
- */
 export declare function __setDuckduckgoHttpsRequestForTesting(fn: HttpsRequestFn | undefined): void;
-/**
- * The DuckDuckGo {@link SearchProvider} adapter.
- *
- * Resolves a search query into a {@link RawProviderResponse} carrying
- * up to `maxResults` `{title, url, snippet}` hits. URL filtering and
- * `maxResults` truncation happen here so the registry handler does not
- * have to re-walk the cheerio tree; the handler still re-applies the
- * filter for defense in depth (Requirement 7.3).
- */
 export declare const duckduckgoProvider: SearchProvider;
 export {};

package/dist/tools/web/providers/duckduckgo.js

@@ -1,71 +1,14 @@
-/**
- * DuckDuckGo search-provider adapter.
- *
- * Used as the keyless default so `clai` works out of the box without
- * any API key (Requirement 3.5). The adapter targets DuckDuckGo's
- * lite-HTML endpoint at `https://html.duckduckgo.com/html/?q=…`,
- * parses the response with `cheerio`, unwraps the in-page redirect
- * shim (`/l/?uddg=<encoded>`) so callers see the destination URL, and
- * applies the same URL filter `web.search` enforces (Requirement 7.3)
- * before forwarding hits to the registry handler.
- *
- * The adapter does not need redirect-chain capture, fine-grained
- * timing, TLS metadata, or DNS-rebinding protection beyond the
- * per-invocation `AbortSignal`, so it deliberately bypasses the full
- * `fetch-core` pipeline. A small `node:https.request`-based helper
- * keeps the implementation simple while still honoring the 15-second
- * `web.search` invocation timeout (Requirement 1.8) via the supplied
- * `AbortSignal`.
- *
- * Per Requirement 6.7 the adapter issues exactly one outbound request
- * per invocation and never retries on transient failure.
- */
 import { Buffer } from "node:buffer";
 import https from "node:https";
 import * as cheerio from "cheerio/slim";
 import { searchProviders } from "./provider.js";
-/** Endpoint for DuckDuckGo's keyless lite-HTML search. */
 const ENDPOINT = "https://html.duckduckgo.com/html/";
-/**
- * User-Agent sent on the outbound DDG request.
- *
- * DuckDuckGo's html/lite endpoints anti-bot-challenge obvious
- * non-browser agents (replying HTTP 202 with a non-results page), so
- * we present a current desktop-browser UA to reduce the challenge rate.
- * Note this is best-effort: DDG also throttles by source IP, so on a
- * blocked network a keyed provider (Brave / Tavily) is the reliable
- * path.
- */
 const USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36";
 let httpsRequestFn = https.request;
-/**
- * Test-only seam: swap the HTTPS transport used by the adapter. Tests use
- * this to inject a stubbed `request` implementation that emits scripted
- * responses; production callers never invoke it.
- */
 export function __setDuckduckgoHttpsRequestForTesting(fn) {
     httpsRequestFn = fn ?? https.request;
 }
-/**
- * Cap on the bytes read from DDG's lite-HTML response. The page is
- * typically well under 200 KiB; the cap exists purely as a memory
- * guard so a misbehaving server cannot stream us an unbounded body.
- */
 const MAX_RESPONSE_BYTES = 1_048_576;
-/**
- * Issue a single GET request over HTTPS, honoring the supplied
- * abort signal (which `web.search` arms to a 15-second timer).
- *
- * Reads at most {@link MAX_RESPONSE_BYTES}, decodes as UTF-8 with
- * replacement of invalid sequences, and resolves with `{status, body}`.
- * Network failures and aborts surface as a rejected promise so the
- * registry handler can map them to the appropriate
- * `WebSearchErrorKind`.
- *
- * Redirect-chain capture is intentionally omitted here — DDG's lite
- * endpoint replies 200 directly in normal operation, and any 3xx is
- * treated as an empty result by the caller.
- */
 function httpsGetText(url, signal) {
     return new Promise((resolve, reject) => {
         let req;
@@ -92,7 +35,6 @@ function httpsGetText(url, signal) {
                         res.destroy();
                     }
                     catch {
-                        // ignore — we are abandoning the socket deliberately
                     }
                 };
                 res.on("data", (chunk) => {
@@ -117,9 +59,6 @@ function httpsGetText(url, signal) {
                     resolve({ status, body });
                 });
                 res.once("close", () => {
-                    // If the body was truncated by `stop()`, `end` does not
-                    // fire — resolve from `close` so the promise still
-                    // settles.
                     if (stopped) {
                         const body = Buffer.concat(chunks, received).toString("utf-8");
                         resolve({ status, body });
@@ -140,17 +79,7 @@ function httpsGetText(url, signal) {
         req.end();
     });
 }
-/**
- * Disallowed character class for hit URLs (Requirement 7.3): any
- * whitespace or ASCII control character. The handler in `web.search`
- * applies the same filter, so dropping here is purely an early exit.
- */
 const URL_INVALID_CHARS_RE = /[\s\u0000-\u001f\u007f]/;
-/**
- * Validate a candidate hit URL against the rules `web.search` enforces:
- * non-empty string, parseable as an absolute URL, scheme `http:` or
- * `https:`, no whitespace, no ASCII control characters.
- */
 function isValidHitUrl(raw) {
     if (typeof raw !== "string" || raw.length === 0)
         return false;
@@ -165,26 +94,11 @@ function isValidHitUrl(raw) {
     }
     return parsed.protocol === "http:" || parsed.protocol === "https:";
 }
-/**
- * Strip DuckDuckGo's in-page redirect wrapper so the destination URL
- * is what callers see.
- *
- * DDG renders result links as `/l/?uddg=<percent-encoded destination>`
- * (sometimes with extra tracking parameters). For non-wrapper links —
- * e.g. ad placements that point directly at an external URL — the
- * input is returned as an absolute URL unchanged.
- *
- * Returns `undefined` when the input is empty, fails URL parsing, or
- * is a `/l/` wrapper without a usable `uddg` parameter.
- */
 function unwrapDdgRedirect(href) {
     if (typeof href !== "string" || href.length === 0)
         return undefined;
     let parsed;
     try {
-        // Resolve protocol-relative (`//duckduckgo.com/l/…`) and absolute
-        // path (`/l/…`) forms against the DDG endpoint so URL parsing
-        // succeeds for every shape DDG emits.
         parsed = new URL(href, ENDPOINT);
     }
     catch {
@@ -198,15 +112,6 @@ function unwrapDdgRedirect(href) {
     }
     return parsed.toString();
 }
-/**
- * The DuckDuckGo {@link SearchProvider} adapter.
- *
- * Resolves a search query into a {@link RawProviderResponse} carrying
- * up to `maxResults` `{title, url, snippet}` hits. URL filtering and
- * `maxResults` truncation happen here so the registry handler does not
- * have to re-walk the cheerio tree; the handler still re-applies the
- * filter for defense in depth (Requirement 7.3).
- */
 export const duckduckgoProvider = {
     id: "duckduckgo",
     displayName: "DuckDuckGo",
@@ -214,10 +119,6 @@ export const duckduckgoProvider = {
     async search(query, maxResults, _auth, signal) {
         const url = `${ENDPOINT}?q=${encodeURIComponent(query)}`;
         const { status, body } = await httpsGetText(url, signal);
-        // Non-2xx responses surface to the handler with an empty hit
-        // list; the handler maps the status to the right
-        // `WebSearchErrorKind` (auth/rate-limit/server/http) per
-        // Requirements 6.1, 6.2, 6.6, and 1.9.
         if (status < 200 || status >= 300) {
             return { status, hits: [] };
         }
@@ -240,8 +141,6 @@ export const duckduckgoProvider = {
             const titleText = titleAnchor.text().trim();
             const href = titleAnchor.attr("href") ?? "";
             const destination = unwrapDdgRedirect(href);
-            // Drop hits whose URL is missing/invalid before they count
-            // toward `maxResults` (Requirement 7.3).
             if (destination === undefined || !isValidHitUrl(destination))
                 return;
             const snippet = $(el).find(".result__snippet").first().text().trim();
@@ -251,8 +150,5 @@ export const duckduckgoProvider = {
         return { status, hits };
     },
 };
-// Register the adapter in the shared registry so the `web.search`
-// handler can dispatch through it once `activeSearchProvider` is set
-// to `"duckduckgo"`.
 searchProviders.duckduckgo = duckduckgoProvider;
 //# sourceMappingURL=duckduckgo.js.map

package/dist/tools/web/providers/duckduckgo.js.map

@@ -1 +1 @@
-{"version":3,"file":"duckduckgo.js","sourceRoot":"","sources":["../../../../src/tools/web/providers/duckduckgo.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"duckduckgo.js","sourceRoot":"","sources":["../../../../src/tools/web/providers/duckduckgo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,MAAM,YAAY,CAAC;AAG/B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AAGxC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,QAAQ,GAAG,mCAAmC,CAAC;AAErD,MAAM,UAAU,GACd,uHAAuH,CAAC;AAI1H,IAAI,cAAc,GAAmB,KAAK,CAAC,OAAO,CAAC;AAEnD,MAAM,UAAU,qCAAqC,CACnD,EAA8B;IAE9B,cAAc,GAAG,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC;AACvC,CAAC;AAED,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAOrC,SAAS,YAAY,CAAC,GAAW,EAAE,MAAmB;IACpD,OAAO,IAAI,OAAO,CAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAClD,IAAI,GAAkB,CAAC;QACvB,IAAI,CAAC;YACH,GAAG,GAAG,cAAc,CAClB,GAAG,EACH;gBACE,MAAM,EAAE,KAAK;gBACb,MAAM;gBACN,OAAO,EAAE;oBACP,YAAY,EAAE,UAAU;oBACxB,MAAM,EAAE,iCAAiC;oBACzC,iBAAiB,EAAE,gBAAgB;oBACnC,iBAAiB,EAAE,UAAU;iBAC9B;aACF,EACD,CAAC,GAAoB,EAAE,EAAE;gBACvB,MAAM,MAAM,GACV,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC1D,MAAM,MAAM,GAAa,EAAE,CAAC;gBAC5B,IAAI,QAAQ,GAAG,CAAC,CAAC;gBACjB,IAAI,OAAO,GAAG,KAAK,CAAC;gBAEpB,MAAM,IAAI,GAAG,GAAS,EAAE;oBACtB,IAAI,OAAO;wBAAE,OAAO;oBACpB,OAAO,GAAG,IAAI,CAAC;oBACf,IAAI,CAAC;wBACH,GAAG,CAAC,OAAO,EAAE,CAAC;oBAChB,CAAC;oBAAC,MAAM,CAAC;oBACT,CAAC;gBACH,CAAC,CAAC;gBAEF,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;oBAC/B,IAAI,OAAO;wBAAE,OAAO;oBACpB,MAAM,SAAS,GAAG,kBAAkB,GAAG,QAAQ,CAAC;oBAChD,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;wBACnB,IAAI,EAAE,CAAC;wBACP,OAAO;oBACT,CAAC;oBACD,IAAI,KAAK,CAAC,UAAU,GAAG,SAAS,EAAE,CAAC;wBACjC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;wBAC1C,QAAQ,IAAI,SAAS,CAAC;wBACtB,IAAI,EAAE,CAAC;wBACP,OAAO;oBACT,CAAC;oBACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACnB,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC;gBAC/B,CAAC,CAAC,CAAC;gBAEH,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE;oBACnB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;oBAC/D,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC5B,CAAC,CAAC,CAAC;gBAEH,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;oBACrB,IAAI,OAAO,EAAE,CAAC;wBACZ,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;wBAC/D,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC5B,CAAC;gBACH,CAAC,CAAC,CAAC;gBAEH,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;oBACxB,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC,CAAC,CAAC;YACL,CAAC,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,CAAC,CAAC;YACZ,OAAO;QACT,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YAC/B,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,GAAG,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,oBAAoB,GAAG,yBAAyB,CAAC;AAEvD,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC;AACrE,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY;IACrC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACpE,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACjE,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1D,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/C,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,EAAE,EAAE,YAAY;IAChB,WAAW,EAAE,YAAY;IACzB,WAAW,EAAE,KAAK;IAClB,KAAK,CAAC,MAAM,CACV,KAAa,EACb,UAAkB,EAClB,KAA0B,EAC1B,MAAmB;QAEnB,MAAM,GAAG,GAAG,GAAG,QAAQ,MAAM,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAEzD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAEzD,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;YAClC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QAC9B,CAAC;QAED,IAAI,CAAqB,CAAC;QAC1B,IAAI,CAAC;YACH,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,MAAM;gBACN,IAAI,EAAE,EAAE;gBACR,UAAU,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aAC7D,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAA8D,EAAE,CAAC;QAE3E,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE;YAC7B,IAAI,IAAI,CAAC,MAAM,IAAI,UAAU;gBAAE,OAAO,KAAK,CAAC;YAE5C,MAAM,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,KAAK,EAAE,CAAC;YAC3D,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAE5C,IAAI,WAAW,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC;gBAAE,OAAO;YAErE,MAAM,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;YACrE,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;YAC3D,OAAO;QACT,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1B,CAAC;CACF,CAAC;AAEF,eAAe,CAAC,UAAU,GAAG,kBAAkB,CAAC"}

package/dist/tools/web/providers/exa.d.ts

@@ -1,51 +1,8 @@
-/**
- * Exa search-provider adapter for `web.search`.
- *
- * Implements the {@link SearchProvider} contract from `./provider.ts` and
- * registers itself in the {@link searchProviders} registry on import. Like
- * the Brave and Tavily adapters it issues exactly one outbound HTTPS request
- * per invocation (Requirement 6.7), forwards the caller-provided
- * {@link AbortSignal} so the `web.search` timeout is honored (Requirement
- * 1.8), and returns a {@link RawProviderResponse} carrying the raw HTTP
- * status plus the parsed hit list for uniform error classification in the
- * handler (Requirements 6.1, 6.2, 6.5, 6.6).
- *
- * Endpoint and request shape follow Exa's `/search` reference
- * (https://docs.exa.ai/reference/search-api-guide-for-coding-agents):
- *
- *   - POST `https://api.exa.ai/search`
- *   - Header: `x-api-key: <key>`
- *   - Body: `{ query, type, numResults, contents: { highlights: true } }`
- *     where `type` is the user-configured {@link ExaSearchType} and
- *     `contents` is omitted for the `instant` tier so it keeps its
- *     sub-second latency profile.
- *   - Response: `{ results: [{ title, url, highlights?, text?, summary? }] }`
- *     mapped into `SearchResult { title, url, snippet }`.
- *
- * Only raw `results` + `highlights` are requested; `outputSchema` synthesis
- * is intentionally not used because the handler maps discrete hits rather
- * than a single grounded answer, and skipping it keeps latency and response
- * shape stable across every search type.
- */
 import https from "node:https";
 import { type SearchProvider } from "./provider.js";
 import { type ExaSearchType } from "../types.js";
 type HttpsRequestFn = typeof https.request;
-/**
- * Test-only seam: swap the HTTPS transport used by the adapter. Production
- * callers never invoke this; tests use it to inject a stubbed `request`
- * implementation that emits scripted responses.
- */
 export declare function __setExaHttpsRequestForTesting(fn: HttpsRequestFn | undefined): void;
-/**
- * Test-only seam: override how the adapter resolves the configured search
- * type. Passing `undefined` restores the config-backed resolver.
- */
 export declare function __setExaSearchTypeResolverForTesting(resolver: (() => ExaSearchType) | undefined): void;
-/**
- * Exa adapter. Registered in {@link searchProviders} as a side-effect of
- * importing this module — `web.search` resolves the active provider via the
- * registry.
- */
 export declare const exaProvider: SearchProvider;
 export {};

package/dist/tools/web/providers/exa.js

@@ -1,72 +1,18 @@
-/**
- * Exa search-provider adapter for `web.search`.
- *
- * Implements the {@link SearchProvider} contract from `./provider.ts` and
- * registers itself in the {@link searchProviders} registry on import. Like
- * the Brave and Tavily adapters it issues exactly one outbound HTTPS request
- * per invocation (Requirement 6.7), forwards the caller-provided
- * {@link AbortSignal} so the `web.search` timeout is honored (Requirement
- * 1.8), and returns a {@link RawProviderResponse} carrying the raw HTTP
- * status plus the parsed hit list for uniform error classification in the
- * handler (Requirements 6.1, 6.2, 6.5, 6.6).
- *
- * Endpoint and request shape follow Exa's `/search` reference
- * (https://docs.exa.ai/reference/search-api-guide-for-coding-agents):
- *
- *   - POST `https://api.exa.ai/search`
- *   - Header: `x-api-key: <key>`
- *   - Body: `{ query, type, numResults, contents: { highlights: true } }`
- *     where `type` is the user-configured {@link ExaSearchType} and
- *     `contents` is omitted for the `instant` tier so it keeps its
- *     sub-second latency profile.
- *   - Response: `{ results: [{ title, url, highlights?, text?, summary? }] }`
- *     mapped into `SearchResult { title, url, snippet }`.
- *
- * Only raw `results` + `highlights` are requested; `outputSchema` synthesis
- * is intentionally not used because the handler maps discrete hits rather
- * than a single grounded answer, and skipping it keeps latency and response
- * shape stable across every search type.
- */
 import { Buffer } from "node:buffer";
 import https from "node:https";
 import { searchProviders, } from "./provider.js";
 import { DEFAULT_EXA_SEARCH_TYPE, } from "../types.js";
 import { getExaSearchType } from "../../../store/config.js";
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-/** Exa search endpoint (host + path). */
 const EXA_HOST = "api.exa.ai";
 const EXA_PATH = "/search";
-/**
- * `numResults` accepted by Exa. The `web.search` handler already clamps the
- * caller's `maxResults` to `[1, 20]`; we re-clamp defensively so the adapter
- * is self-consistent when invoked directly (e.g. from a unit test).
- */
 const EXA_MIN_RESULTS = 1;
 const EXA_MAX_RESULTS = 20;
-/** User-Agent sent on outbound Exa requests. */
 const DEFAULT_USER_AGENT = "clai-web-search/1.0";
-/**
- * Hard cap on the number of body bytes read before surfacing a `parse`
- * error. Deep-search responses with highlights are comfortably under this
- * cap; it exists purely as a memory guard against a misbehaving upstream.
- */
-const MAX_RESPONSE_BYTES = 4_194_304; // 4 MiB
+const MAX_RESPONSE_BYTES = 4_194_304;
 let httpsRequestFn = https.request;
-/**
- * Test-only seam: swap the HTTPS transport used by the adapter. Production
- * callers never invoke this; tests use it to inject a stubbed `request`
- * implementation that emits scripted responses.
- */
 export function __setExaHttpsRequestForTesting(fn) {
     httpsRequestFn = fn ?? https.request;
 }
-/**
- * Resolver for the configured search type. Reads `ClaiConfig.exaSearchType`
- * lazily so a config-store failure degrades to {@link DEFAULT_EXA_SEARCH_TYPE}
- * rather than throwing inside the search path. Tests may override it.
- */
 let searchTypeResolver = defaultSearchTypeResolver;
 function defaultSearchTypeResolver() {
     try {
@@ -76,14 +22,9 @@ function defaultSearchTypeResolver() {
         return DEFAULT_EXA_SEARCH_TYPE;
     }
 }
-/**
- * Test-only seam: override how the adapter resolves the configured search
- * type. Passing `undefined` restores the config-backed resolver.
- */
 export function __setExaSearchTypeResolverForTesting(resolver) {
     searchTypeResolver = resolver ?? defaultSearchTypeResolver;
 }
-/** Clamp `numResults` to the Exa-supported range. */
 function clampResults(count) {
     if (!Number.isFinite(count))
         return EXA_MIN_RESULTS;
@@ -94,11 +35,6 @@ function clampResults(count) {
         return EXA_MAX_RESULTS;
     return rounded;
 }
-/**
- * Drain `res` into a UTF-8 string, capped at {@link MAX_RESPONSE_BYTES}. The
- * body cap defends against a misbehaving upstream; the {@link AbortSignal}
- * short-circuits the read on the `web.search` timeout (Requirement 1.8).
- */
 function readBody(res, signal) {
     return new Promise((resolve, reject) => {
         const chunks = [];
@@ -144,11 +80,6 @@ function readBody(res, signal) {
         });
     });
 }
-/**
- * Build the JSON request body. `contents.highlights` is requested for every
- * tier except `instant`, matching Exa's guidance that the instant tier stays
- * content-free to preserve its ~250 ms latency.
- */
 function buildPayload(query, numResults, type) {
     const body = { query, type, numResults };
     if (type !== "instant") {
@@ -156,12 +87,6 @@ function buildPayload(query, numResults, type) {
     }
     return JSON.stringify(body);
 }
-/**
- * Issue the Exa HTTPS POST and resolve `{status, body}` once the response is
- * fully read. Network failures propagate as a thrown error so the adapter
- * can map them to a `status: 0` placeholder for the handler's `network`
- * classification (Requirement 6.3).
- */
 function dispatchRequest(query, numResults, type, apiKey, signal) {
     const payload = buildPayload(query, numResults, type);
     const bodyBytes = Buffer.from(payload, "utf8");
@@ -196,11 +121,6 @@ function dispatchRequest(query, numResults, type, apiKey, signal) {
         req.end();
     });
 }
-/**
- * Collapse an Exa result's `highlights` (query-relevant excerpts) into a
- * single snippet, falling back to `text` then `summary`. Returns an empty
- * string when none is present so the handler's normaliser can decide.
- */
 function extractSnippet(entry) {
     if (Array.isArray(entry.highlights)) {
         const joined = entry.highlights
@@ -216,12 +136,6 @@ function extractSnippet(entry) {
     }
     return "";
 }
-/**
- * Extract the Exa `results[]` array from a parsed JSON body and map it to
- * the {@link RawProviderResponse.hits} shape. Returns `null` when the body
- * did not carry a `{ results: [...] }` array so the adapter can surface a
- * `parseError` (Requirement 6.5).
- */
 function extractHits(parsed) {
     if (!parsed || typeof parsed !== "object")
         return null;
@@ -245,31 +159,18 @@ function extractHits(parsed) {
     }
     return hits;
 }
-// ---------------------------------------------------------------------------
-// Provider definition
-// ---------------------------------------------------------------------------
-/**
- * Exa adapter. Registered in {@link searchProviders} as a side-effect of
- * importing this module — `web.search` resolves the active provider via the
- * registry.
- */
 export const exaProvider = {
     id: "exa",
     displayName: "Exa",
     needsApiKey: true,
     envVar: "EXA_API_KEY",
     async search(query, maxResults, auth, signal) {
-        // Defensive: the handler resolves the key before calling us. If somehow
-        // invoked without one, surface a 0-status response so the handler maps
-        // it to `missing-key` / `network` rather than dispatching unauthenticated.
         if (!auth.apiKey) {
             return { status: 0, hits: [], parseError: "missing api key" };
         }
         const numResults = clampResults(maxResults);
         const type = searchTypeResolver();
         const { status, body } = await dispatchRequest(query, numResults, type, auth.apiKey, signal);
-        // Non-2xx: forward the status with an empty hit list; the handler maps
-        // the status to the appropriate error kind.
         if (status < 200 || status >= 300) {
             return { status, hits: [] };
         }
@@ -297,7 +198,5 @@ export const exaProvider = {
         return { status, hits };
     },
 };
-// Register on import so `searchProviders.exa` is populated by the time the
-// `web.search` handler dispatches.
 searchProviders.exa = exaProvider;
 //# sourceMappingURL=exa.js.map

package/dist/tools/web/providers/exa.js.map

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

package/dist/tools/web/providers/provider.d.ts

@@ -1,43 +1,8 @@
-/**
- * Search-provider adapter interface and registry stub.
- *
- * Concrete provider implementations (Brave, Tavily, DuckDuckGo) live next to
- * this file and register themselves into {@link searchProviders}. The registry
- * starts empty; it is populated by the per-provider modules so a missing
- * import surfaces immediately as a `Cannot read property 'search'` style error
- * rather than as a silently wrong dispatch.
- *
- * Shapes here match the design document's "Provider adapter interface"
- * section verbatim.
- */
 import { type SearchProviderId } from "../types.js";
-/**
- * Adapter implemented by every search-provider module.
- *
- * The `search` method is called by `web.search` after argument validation and
- * provider/key resolution. Implementations must:
- *
- * - Issue exactly one outbound HTTP request (no retry on transient failure;
- *   Requirement 6.7).
- * - Honor the provided {@link AbortSignal} for the 15-second invocation
- *   timeout (Requirement 1.8).
- * - Return a {@link RawProviderResponse} describing the HTTP outcome and the
- *   raw, unfiltered hit list. Shape validation, URL filtering, and
- *   `maxResults` truncation are performed by the `web.search` handler, not by
- *   the adapter.
- */
 export interface SearchProvider {
-    /** Stable identifier matching one of {@link SearchProviderId}. */
     id: SearchProviderId;
-    /** Human-friendly name shown in CLI listings. */
     displayName: string;
-    /** Whether the adapter requires an API key to dispatch a request. */
     needsApiKey: boolean;
-    /**
-     * Environment variable the key store consults first when resolving this
-     * provider's API key (e.g. `"BRAVE_SEARCH_API_KEY"`). Omitted for keyless
-     * providers.
-     */
     envVar?: string;
     /**
      * Dispatch a single search request.
@@ -52,48 +17,14 @@ export interface SearchProvider {
         apiKey?: string;
     }, signal: AbortSignal): Promise<RawProviderResponse>;
 }
-/**
- * Provider-agnostic view of a single dispatch's outcome.
- *
- * Adapters surface raw HTTP status + hit array here so the `web.search`
- * handler can map status codes to {@link import("../types.js").WebSearchErrorKind}
- * uniformly across providers (Requirements 6.1, 6.2, 6.5, 6.6, 1.9).
- */
 export interface RawProviderResponse {
-    /** HTTP status code returned by the provider's endpoint. */
     status: number;
-    /**
-     * Hit list extracted from the provider response. Fields are optional
-     * because validation/filtering happens in the handler — the adapter is
-     * permitted to forward whatever the provider produced.
-     */
     hits: Array<{
         title?: string;
         url?: string;
         snippet?: string;
     }>;
-    /**
-     * Populated when the provider returned a 2xx status but the body did not
-     * match the adapter's expected shape; surfaces as
-     * {@link import("../types.js").WebSearchErrorKind} `"parse"` (Requirement 6.5).
-     */
     parseError?: string;
 }
-/**
- * Registry of installed search-provider adapters, keyed by
- * {@link SearchProviderId}.
- *
- * Starts empty. Concrete adapters in `./brave.ts`, `./tavily.ts`, and
- * `./duckduckgo.ts` populate this object on module import; the
- * `web.search` handler resolves the active provider through it.
- */
 export declare const searchProviders: Record<SearchProviderId, SearchProvider>;
-/**
- * Validate that an arbitrary string is one of the supported
- * {@link SearchProviderId} values, returning the narrowed type.
- *
- * Mirrors `assertProvider` in `src/llm/provider.ts` so CLI surfaces such as
- * `clai set <provider>` and `clai search-provider <id>` get the same error
- * shape regardless of which keyspace the id belongs to (Requirement 3.7).
- */
 export declare function assertSearchProvider(value: string): SearchProviderId;

package/dist/tools/web/providers/provider.js

@@ -1,33 +1,5 @@
-/**
- * Search-provider adapter interface and registry stub.
- *
- * Concrete provider implementations (Brave, Tavily, DuckDuckGo) live next to
- * this file and register themselves into {@link searchProviders}. The registry
- * starts empty; it is populated by the per-provider modules so a missing
- * import surfaces immediately as a `Cannot read property 'search'` style error
- * rather than as a silently wrong dispatch.
- *
- * Shapes here match the design document's "Provider adapter interface"
- * section verbatim.
- */
 import { searchProviderIds, } from "../types.js";
-/**
- * Registry of installed search-provider adapters, keyed by
- * {@link SearchProviderId}.
- *
- * Starts empty. Concrete adapters in `./brave.ts`, `./tavily.ts`, and
- * `./duckduckgo.ts` populate this object on module import; the
- * `web.search` handler resolves the active provider through it.
- */
 export const searchProviders = {};
-/**
- * Validate that an arbitrary string is one of the supported
- * {@link SearchProviderId} values, returning the narrowed type.
- *
- * Mirrors `assertProvider` in `src/llm/provider.ts` so CLI surfaces such as
- * `clai set <provider>` and `clai search-provider <id>` get the same error
- * shape regardless of which keyspace the id belongs to (Requirement 3.7).
- */
 export function assertSearchProvider(value) {
     const normalized = value.trim().toLowerCase();
     if (searchProviderIds.includes(normalized)) {

package/dist/tools/web/providers/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/tools/web/providers/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,iBAAiB,GAElB,MAAM,aAAa,CAAC;AAuErB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,EAA8C,CAAC;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAK,iBAAuC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAClE,OAAO,UAA8B,CAAC;IACxC,CAAC;IACD,MAAM,IAAI,KAAK,CACb,gCAAgC,KAAK,2BAA2B,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/F,CAAC;AACJ,CAAC"}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/tools/web/providers/provider.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,GAElB,MAAM,aAAa,CAAC;AA8BrB,MAAM,CAAC,MAAM,eAAe,GAAG,EAA8C,CAAC;AAE9E,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAK,iBAAuC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAClE,OAAO,UAA8B,CAAC;IACxC,CAAC;IACD,MAAM,IAAI,KAAK,CACb,gCAAgC,KAAK,2BAA2B,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/F,CAAC;AACJ,CAAC"}