scoutline 0.6.4 → 0.7.0

package/dist/providers/tavily/client.js

@@ -0,0 +1,486 @@
+/**
+ * Tavily direct HTTP transport (DESIGN.md §5, §7; tech-plan §7).
+ *
+ * Performs direct POSTs against the Tavily REST endpoints with an
+ * `Authorization: Bearer <apiKey>` header. There is NO internal retry —
+ * shared execution owns retry policy. Fetch and timer are injectable for
+ * tests.
+ *
+ * Mirrors `providers/minimax/coding-plan-client.ts` in structure, but
+ * SIMPLER: Tavily uses HTTP-status exclusively for errors (no body-level
+ * business status code like MiniMax's `base_resp.status_code`). Error
+ * responses are `{ "detail": { "error": "message" } }`; the transport
+ * maps HTTP status to Scoutline errors at the transport layer only — no
+ * second body-parsing layer needed.
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - May import Adapter-local config and normalized errors.
+ *   - May import `ProviderQuotaFetch` from `providers/types.ts`.
+ *   - Must NOT import command presentation, capability contracts, or
+ *     another Provider's Adapter.
+ *   - Must NOT perform response field normalization — the Adapter owns
+ *     that. This module declares Provider-native request-body types
+ *     only (Tavily API field names); it does not import SearchControls
+ *     or any capability contract.
+ */
+import { createRequire } from "node:module";
+import { ApiError, AuthError, NetworkError, TimeoutError } from "../../lib/errors.js";
+const require = createRequire(import.meta.url);
+const { version: VERSION } = require("../../../package.json");
+const BASE_URL = "https://api.tavily.com";
+const SEARCH_PATH = "/search";
+const EXTRACT_PATH = "/extract";
+const CRAWL_PATH = "/crawl";
+const MAP_PATH = "/map";
+const RESEARCH_PATH = "/research";
+const USAGE_PATH = "/usage";
+const DEFAULT_TIMEOUT_MS = 30000;
+const USER_AGENT = `scoutline/${VERSION}`;
+const TIMEOUT_HELP_TEXT = "Try again or increase timeout with TAVILY_TIMEOUT env var";
+function resolveTimeoutMs(env) {
+    const raw = parseInt(env.TAVILY_TIMEOUT || String(DEFAULT_TIMEOUT_MS), 10);
+    return Number.isFinite(raw) && raw > 0 ? raw : DEFAULT_TIMEOUT_MS;
+}
+/**
+ * Layer 1 — HTTP-status mapping. Runs BEFORE the body is parsed; on a
+ * non-200 response we discard the body and throw a typed error.
+ *
+ * Tavily uses HTTP-status exclusively. The non-standard 432/433 codes
+ * are Tavily-specific plan/paygo limits; they are mapped to `ApiError`
+ * (NOT `QuotaError`, which hardcodes statusCode 429 and would collide
+ * with actual rate limits) with the real status preserved so scripting
+ * users can distinguish plan-limit from paygo-limit from rate-limit.
+ * Both are terminal because `isOperationRetryableError` treats an
+ * `ApiError` with non-429/non-5xx status as non-retryable.
+ *
+ * `timeoutMs` is forwarded so 408/504 can throw `TimeoutError`
+ * carrying the configured duration (and the `TAVILY_TIMEOUT` help
+ * text). The transport never embeds credential material in any error
+ * message.
+ */
+function mapStatusError(status, timeoutMs) {
+    if (status === 401 || status === 403) {
+        return new AuthError("Tavily authentication failed", "TAVILY_API_KEY");
+    }
+    if (status === 408 || status === 504) {
+        return new TimeoutError(timeoutMs, TIMEOUT_HELP_TEXT);
+    }
+    if (status === 429) {
+        return new ApiError("Tavily rate limit exceeded", 429);
+    }
+    if (status === 432) {
+        return new ApiError("Tavily plan limit exceeded. Upgrade your plan at app.tavily.com.", 432);
+    }
+    if (status === 433) {
+        return new ApiError("Tavily pay-as-you-go limit exceeded. Increase your limit on the Tavily dashboard.", 433);
+    }
+    if (status === 400 || status === 404 || status === 410 || status === 422) {
+        return new ApiError("Tavily request failed", status);
+    }
+    if (status >= 500) {
+        return new ApiError("Tavily request failed", status);
+    }
+    return new ApiError("Tavily request failed", status);
+}
+function normalizeTransportError(err, timeoutMs) {
+    if (err instanceof AuthError || err instanceof ApiError || err instanceof TimeoutError) {
+        return err;
+    }
+    if (err instanceof Error) {
+        if (err.name === "AbortError") {
+            return new TimeoutError(timeoutMs, TIMEOUT_HELP_TEXT);
+        }
+        const lower = err.message.toLowerCase();
+        if (lower.includes("fetch") ||
+            lower.includes("econnrefused") ||
+            lower.includes("econnreset") ||
+            lower.includes("enotfound") ||
+            lower.includes("network")) {
+            return new NetworkError("Tavily network error");
+        }
+    }
+    return new ApiError("Tavily request failed", 500);
+}
+async function postTavilyJson(apiKey, path, body, deps, endpointLabel, 
+/**
+ * Optional client-side AbortController timeout in ms. When omitted, the
+ * transport resolves the timeout from `deps.env` (`TAVILY_TIMEOUT`,
+ * default 30s). Crawl passes an explicit value so the client waits at
+ * least as long as the server-side `body.timeout` ceiling (150s default).
+ */
+timeoutMsOverride) {
+    const f = deps.fetch ?? fetch;
+    const setT = deps.setTimeout ?? setTimeout;
+    const clearT = deps.clearTimeout ?? clearTimeout;
+    const env = deps.env ?? process.env;
+    const timeoutMs = timeoutMsOverride ?? resolveTimeoutMs(env);
+    const url = `${BASE_URL}${path}`;
+    const controller = new AbortController();
+    const timeoutId = setT(() => controller.abort(), timeoutMs);
+    try {
+        const res = await f(url, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                "Content-Type": "application/json",
+                "User-Agent": USER_AGENT,
+            },
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+        clearT(timeoutId);
+        if (!res.ok) {
+            await res.text().catch(() => { });
+            throw mapStatusError(res.status, timeoutMs);
+        }
+        let parsed;
+        try {
+            parsed = await res.json();
+        }
+        catch {
+            throw new ApiError(`Tavily ${endpointLabel} returned a malformed response`, 500);
+        }
+        return parsed;
+    }
+    catch (err) {
+        clearT(timeoutId);
+        throw normalizeTransportError(err, timeoutMs);
+    }
+    finally {
+        controller.abort();
+    }
+}
+/**
+ * Perform ONE POST against the Tavily /search endpoint. No retry; no
+ * response body in public errors. Returns the parsed JSON body (raw;
+ * the Adapter post-processes into normalized search sources).
+ *
+ * `params` carries Tavily-native API fields already mapped from
+ * `SearchControls` by the Adapter.
+ */
+export async function fetchTavilySearch(apiKey, query, params, deps = {}) {
+    const body = { query };
+    if (params) {
+        if (params.topic !== undefined) {
+            body.topic = params.topic;
+        }
+        if (params.search_depth !== undefined) {
+            body.search_depth = params.search_depth;
+        }
+        if (params.include_domains !== undefined) {
+            body.include_domains = [...params.include_domains];
+        }
+        if (params.time_range !== undefined) {
+            body.time_range = params.time_range;
+        }
+    }
+    return postTavilyJson(apiKey, SEARCH_PATH, body, deps, "search");
+}
+/**
+ * Perform ONE POST against the Tavily /extract endpoint. No retry; no
+ * response body in public errors. Returns the parsed JSON body (raw;
+ * the Adapter post-processes into a normalized ReaderFetchResult).
+ *
+ * `url` is a single URL; the transport wraps it as `urls: [url]` per
+ * the Tavily API contract.
+ */
+export async function fetchTavilyExtract(apiKey, url, params, deps = {}) {
+    const body = { urls: [url] };
+    if (params?.extract_depth !== undefined) {
+        body.extract_depth = params.extract_depth;
+    }
+    return postTavilyJson(apiKey, EXTRACT_PATH, body, deps, "extract");
+}
+/**
+ * Perform ONE POST against the Tavily /crawl endpoint. No retry; no
+ * response body in public errors. Returns the parsed JSON body (raw; the
+ * Adapter post-processes into a normalized CrawlResult).
+ *
+ * `params` carries Tavily-native API fields already mapped from
+ * `CrawlRequest` by the Adapter.
+ */
+export async function fetchTavilyCrawl(apiKey, url, params, deps = {}) {
+    const body = { url };
+    if (params) {
+        if (params.max_depth !== undefined) {
+            body.max_depth = params.max_depth;
+        }
+        if (params.max_breadth !== undefined) {
+            body.max_breadth = params.max_breadth;
+        }
+        if (params.limit !== undefined) {
+            body.limit = params.limit;
+        }
+        if (params.select_paths !== undefined) {
+            body.select_paths = [...params.select_paths];
+        }
+        if (params.exclude_paths !== undefined) {
+            body.exclude_paths = [...params.exclude_paths];
+        }
+        if (params.instructions !== undefined) {
+            body.instructions = params.instructions;
+        }
+        if (params.format !== undefined) {
+            body.format = params.format;
+        }
+        if (params.extract_depth !== undefined) {
+            body.extract_depth = params.extract_depth;
+        }
+        if (params.timeout !== undefined) {
+            body.timeout = params.timeout;
+        }
+    }
+    // The client-side AbortController MUST wait at least as long as the
+    // server-side ceiling. Tavily's crawl `timeout` (seconds) caps how long
+    // the server works; the default is 150s. If the transport default
+    // (`TAVILY_TIMEOUT`, 30s) is shorter, any crawl exceeding it would be
+    // aborted client-side regardless of `--timeout`. Take the larger of the
+    // transport default and (server ceiling * 1000 + 5s network buffer).
+    const serverCeilingSeconds = params?.timeout ?? 150;
+    const clientTimeoutMs = Math.max(resolveTimeoutMs(deps.env ?? process.env), serverCeilingSeconds * 1000 + 5000);
+    return postTavilyJson(apiKey, CRAWL_PATH, body, deps, "crawl", clientTimeoutMs);
+}
+/**
+ * Perform ONE POST against the Tavily /map endpoint. No retry; no
+ * response body in public errors. Returns the parsed JSON body (raw; the
+ * Adapter post-processes into a normalized MapResult).
+ *
+ * `params` carries Tavily-native API fields already mapped from
+ * `MapRequest` by the Adapter. The /map response is `{ results: string[] }`
+ * — an array of URL strings, NOT an array of page objects — and is
+ * returned as raw `unknown` for the Adapter to normalize.
+ */
+export async function fetchTavilyMap(apiKey, url, params, deps = {}) {
+    const body = { url };
+    if (params) {
+        if (params.max_depth !== undefined) {
+            body.max_depth = params.max_depth;
+        }
+        if (params.max_breadth !== undefined) {
+            body.max_breadth = params.max_breadth;
+        }
+        if (params.limit !== undefined) {
+            body.limit = params.limit;
+        }
+        if (params.select_paths !== undefined) {
+            body.select_paths = [...params.select_paths];
+        }
+        if (params.exclude_paths !== undefined) {
+            body.exclude_paths = [...params.exclude_paths];
+        }
+        if (params.instructions !== undefined) {
+            body.instructions = params.instructions;
+        }
+    }
+    return postTavilyJson(apiKey, MAP_PATH, body, deps, "map");
+}
+/**
+ * Layer 1 — HTTP-status mapping for GET requests. Same semantics as
+ * `postTavilyJson`'s mapping (`mapStatusError`); duplicated here so a
+ * transport seam that only ever issues GETs does not have to import
+ * the POST-only path.
+ */
+async function getTavilyJson(apiKey, path, deps, endpointLabel) {
+    const f = deps.fetch ?? fetch;
+    const setT = deps.setTimeout ?? setTimeout;
+    const clearT = deps.clearTimeout ?? clearTimeout;
+    const env = deps.env ?? process.env;
+    const timeoutMs = resolveTimeoutMs(env);
+    const url = `${BASE_URL}${path}`;
+    const controller = new AbortController();
+    const timeoutId = setT(() => controller.abort(), timeoutMs);
+    try {
+        const res = await f(url, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                "User-Agent": USER_AGENT,
+            },
+            signal: controller.signal,
+        });
+        clearT(timeoutId);
+        if (!res.ok) {
+            await res.text().catch(() => { });
+            throw mapStatusError(res.status, timeoutMs);
+        }
+        let parsed;
+        try {
+            parsed = await res.json();
+        }
+        catch {
+            throw new ApiError(`Tavily ${endpointLabel} returned a malformed response`, 500);
+        }
+        return parsed;
+    }
+    catch (err) {
+        clearT(timeoutId);
+        throw normalizeTransportError(err, timeoutMs);
+    }
+    finally {
+        controller.abort();
+    }
+} /**
+ * Perform ONE GET against the Tavily /usage endpoint. No retry; no
+ * response body in public errors. Returns the parsed JSON body (raw;
+ * the Adapter post-processes into normalized quota categories).
+ *
+ * Tavily's /usage is rate-limited (10 calls per 10 minutes per key).
+ * It is therefore ONLY safe to invoke through the Quota Capability
+ * path (interactive `quota` command) — the Diagnostics Capability
+ * intentionally uses /search (1 credit) to avoid hitting this
+ * restrictive window.
+ */
+export async function fetchTavilyUsage(apiKey, deps = {}) {
+    return getTavilyJson(apiKey, USAGE_PATH, deps, "usage");
+}
+// ---------------------------------------------------------------------------
+// Research — async create/poll transport (tech-plan §3, §7)
+// ---------------------------------------------------------------------------
+//
+// Research is the only Tavily capability with an asynchronous lifecycle:
+// POST /research creates the task (HTTP 201, { request_id, status }),
+// then GET /research/{id} polls until completion (200 completed), failure
+// (200 failed), or the task disappears (404). The transport performs ONE
+// request per call and never polls internally — the Adapter's `invoke()`
+// owns the poll loop and the state file.
+/**
+ * Perform ONE POST against the Tavily /research endpoint. No retry; no
+ * response body in public errors. Returns the structured create result
+ * `{ requestId, status }`.
+ *
+ * Note: /research returns HTTP 201 (Created) on success, not 200. The
+ * shared `postTavilyJson` treats any 2xx as success (`res.ok`), so 201
+ * is handled correctly without special-casing the status mapping.
+ */
+export async function createTavilyResearch(apiKey, query, params, deps = {}) {
+    const body = { input: query };
+    if (params) {
+        if (params.model !== undefined)
+            body.model = params.model;
+        if (params.output_length !== undefined)
+            body.output_length = params.output_length;
+        if (params.citation_format !== undefined)
+            body.citation_format = params.citation_format;
+        if (params.domain !== undefined)
+            body.include_domains = [params.domain];
+    }
+    const raw = (await postTavilyJson(apiKey, RESEARCH_PATH, body, deps, "research"));
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new ApiError("Tavily research returned a malformed response", 500);
+    }
+    const obj = raw;
+    const requestId = obj.request_id;
+    const status = obj.status;
+    if (typeof requestId !== "string" || requestId.length === 0) {
+        throw new ApiError("Tavily research returned a malformed response", 500);
+    }
+    return { requestId, status: typeof status === "string" ? status : "pending" };
+}
+/**
+ * Perform ONE GET against the Tavily /research/{request_id} endpoint.
+ * No retry. Returns a structured poll result.
+ *
+ * Unlike other GETs, a 404 is NOT a terminal transport error here: it
+ * means the server-side task has expired/disappeared, so the Adapter can
+ * delete the stale state file and create a fresh task. The poll result
+ * carries `status: "not_found"` for that case. All other non-2xx statuses
+ * throw the standard mapped error (auth, rate limit, 5xx).
+ */
+export async function pollTavilyResearch(apiKey, requestId, deps = {}) {
+    const f = deps.fetch ?? fetch;
+    const setT = deps.setTimeout ?? setTimeout;
+    const clearT = deps.clearTimeout ?? clearTimeout;
+    const env = deps.env ?? process.env;
+    const timeoutMs = resolveTimeoutMs(env);
+    const url = `${BASE_URL}${RESEARCH_PATH}/${encodeURIComponent(requestId)}`;
+    const controller = new AbortController();
+    const timeoutId = setT(() => controller.abort(), timeoutMs);
+    try {
+        let res;
+        try {
+            res = await f(url, {
+                method: "GET",
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "User-Agent": USER_AGENT,
+                },
+                signal: controller.signal,
+            });
+            clearT(timeoutId);
+        }
+        catch (err) {
+            clearT(timeoutId);
+            throw normalizeTransportError(err, timeoutMs);
+        }
+        if (res.status === 404) {
+            await res.text().catch(() => { });
+            return { status: "not_found" };
+        }
+        if (!res.ok) {
+            await res.text().catch(() => { });
+            throw mapStatusError(res.status, timeoutMs);
+        }
+        let parsed;
+        try {
+            parsed = await res.json();
+        }
+        catch {
+            throw new ApiError("Tavily research returned a malformed response", 500);
+        }
+        return normalizeResearchPollResult(parsed);
+    }
+    finally {
+        controller.abort();
+    }
+}
+/**
+ * Normalize a parsed poll body into a {@link TavilyResearchPollResult}.
+ * Accepts `{ status, content?, sources? }`. Unknown/missing status maps
+ * to a malformed-response error so the Adapter never silently advances
+ * on garbage.
+ */
+function normalizeResearchPollResult(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new ApiError("Tavily research returned a malformed response", 500);
+    }
+    const obj = value;
+    const status = obj.status;
+    if (status !== "pending" &&
+        status !== "in_progress" &&
+        status !== "completed" &&
+        status !== "failed") {
+        throw new ApiError("Tavily research returned a malformed response", 500);
+    }
+    const result = { status };
+    if (status === "completed") {
+        const content = obj.content;
+        if (typeof content !== "string") {
+            throw new ApiError("Tavily research returned a malformed response", 500);
+        }
+        const sources = obj.sources;
+        if (sources !== undefined && !Array.isArray(sources)) {
+            throw new ApiError("Tavily research returned a malformed response", 500);
+        }
+        let decodedSources;
+        if (Array.isArray(sources)) {
+            decodedSources = [];
+            for (const entry of sources) {
+                if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+                    throw new ApiError("Tavily research returned a malformed response", 500);
+                }
+                const src = entry;
+                decodedSources.push({
+                    title: typeof src.title === "string" ? src.title : undefined,
+                    url: typeof src.url === "string" ? src.url : undefined,
+                });
+            }
+        }
+        return {
+            status: "completed",
+            content,
+            ...(decodedSources !== undefined ? { sources: decodedSources } : {}),
+        };
+    }
+    return result;
+}
+//# sourceMappingURL=client.js.map

package/dist/providers/tavily/client.js.map

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

package/dist/providers/tavily/credentials.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Tavily credential resolution (DESIGN.md §6, tech-plan §7).
+ *
+ * Single source of truth for the Tavily API key. Whitespace-only values
+ * are treated as absent, matching the descriptor's `isConfigured`
+ * contract.
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - May import the normalized-error contract only.
+ *   - Must NOT import transport, command presentation, or another
+ *     Provider's Adapter.
+ *
+ * Missing credentials are surfaced as {@link ConfigurationError}
+ * (exit 3), distinct from {@link AuthError} (exit 1) which means the
+ * Provider REJECTED a presented credential.
+ */
+/**
+ * Resolve the Tavily API key without throwing. Returns `undefined`
+ * when no non-blank value is present.
+ */
+export declare function resolveTavilyApiKey(env: NodeJS.ProcessEnv): string | undefined;
+/**
+ * Resolve the Tavily API key or throw {@link ConfigurationError}
+ * (exit 3) when it is missing. Call this at every capability
+ * invocation gate.
+ */
+export declare function requireTavilyApiKey(env: NodeJS.ProcessEnv): string;
+/**
+ * True when a non-blank Tavily API key is configured. Metadata-only:
+ * performs no transport construction and reads no other Provider's
+ * credentials.
+ */
+export declare function isTavilyConfigured(env: NodeJS.ProcessEnv): boolean;
+//# sourceMappingURL=credentials.d.ts.map

package/dist/providers/tavily/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../../src/providers/tavily/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAgBH;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,SAAS,CAE9E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CASlE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAElE"}

package/dist/providers/tavily/credentials.js

@@ -0,0 +1,56 @@
+/**
+ * Tavily credential resolution (DESIGN.md §6, tech-plan §7).
+ *
+ * Single source of truth for the Tavily API key. Whitespace-only values
+ * are treated as absent, matching the descriptor's `isConfigured`
+ * contract.
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - May import the normalized-error contract only.
+ *   - Must NOT import transport, command presentation, or another
+ *     Provider's Adapter.
+ *
+ * Missing credentials are surfaced as {@link ConfigurationError}
+ * (exit 3), distinct from {@link AuthError} (exit 1) which means the
+ * Provider REJECTED a presented credential.
+ */
+import { ConfigurationError } from "../../lib/errors.js";
+const MISSING_KEY_HELP = 'export TAVILY_API_KEY="your-api-key"';
+/**
+ * Pick a non-blank raw value from the environment. Returns the original
+ * (untrimmed) string when it contains at least one non-whitespace
+ * character, otherwise `undefined`.
+ */
+function pickNonBlank(raw) {
+    if (typeof raw !== "string")
+        return undefined;
+    return raw.trim().length > 0 ? raw : undefined;
+}
+/**
+ * Resolve the Tavily API key without throwing. Returns `undefined`
+ * when no non-blank value is present.
+ */
+export function resolveTavilyApiKey(env) {
+    return pickNonBlank(env.TAVILY_API_KEY);
+}
+/**
+ * Resolve the Tavily API key or throw {@link ConfigurationError}
+ * (exit 3) when it is missing. Call this at every capability
+ * invocation gate.
+ */
+export function requireTavilyApiKey(env) {
+    const key = resolveTavilyApiKey(env);
+    if (key === undefined) {
+        throw new ConfigurationError("TAVILY_API_KEY environment variable is required", MISSING_KEY_HELP);
+    }
+    return key;
+}
+/**
+ * True when a non-blank Tavily API key is configured. Metadata-only:
+ * performs no transport construction and reads no other Provider's
+ * credentials.
+ */
+export function isTavilyConfigured(env) {
+    return resolveTavilyApiKey(env) !== undefined;
+}
+//# sourceMappingURL=credentials.js.map

package/dist/providers/tavily/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../../src/providers/tavily/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,gBAAgB,GAAG,sCAAsC,CAAC;AAEhE;;;;GAIG;AACH,SAAS,YAAY,CAAC,GAAY;IAChC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9C,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAsB;IACxD,OAAO,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAsB;IACxD,MAAM,GAAG,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,kBAAkB,CAC1B,iDAAiD,EACjD,gBAAgB,CACjB,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAsB;IACvD,OAAO,mBAAmB,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;AAChD,CAAC"}

package/dist/providers/tavily/diagnostics.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Tavily Diagnostics Capability (DESIGN.md §14, tech-plan §10, T08).
+ *
+ * Probes Tavily connectivity with a single, cheapest-possible request
+ * — `/search` with `search_depth: "basic"` and a stub query — so the
+ * doctor command can verify a credential authenticates without
+ * burning plan credits.
+ *
+ * The probe intentionally avoids `/usage`. Tavily throttles `/usage`
+ * to 10 requests per 10 minutes per key (tech-plan §10), which would
+ * make a routine doctor run rate-limit itself. `/search` with basic
+ * depth costs a single credit and is bounded by the search rate limit,
+ * which is far more generous than the usage endpoint.
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - May import the diagnostics capability contract, Adapter-local
+ *     config, Adapter-local search transport, and normalized errors.
+ *   - Must NOT import command presentation or another Provider's
+ *     Adapter.
+ */
+import type { DiagnosticsCapability } from "../../capabilities/diagnostics.js";
+import { type TavilyTransportDeps } from "./client.js";
+/**
+ * Options for the Tavily DiagnosticsCapability. The API key is
+ * resolved from `env`; transport dependencies (`fetch`, timer) are
+ * injectable for deterministic tests through the unified `transport`
+ * seam.
+ */
+export interface TavilyDiagnosticsCapabilityOptions {
+    readonly env: NodeJS.ProcessEnv;
+    readonly transport?: TavilyTransportDeps;
+}
+/**
+ * Build the Tavily DiagnosticsCapability. The probe performs ONE
+ * `/search` request with `search_depth: "basic"` and a stub query so
+ * it costs a single credit. Shared execution owns the retry policy;
+ * this transport performs exactly one attempt per invocation.
+ *
+ * When `options.probe` is false, `invoke` resolves immediately without
+ * touching the network — the doctor command skips probing unconfigured
+ * or tools-disabled Providers before reaching this Capability.
+ */
+export declare function createTavilyDiagnosticsCapability(options: TavilyDiagnosticsCapabilityOptions): DiagnosticsCapability;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/providers/tavily/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/providers/tavily/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,mCAAmC,CAAC;AAS3C,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,aAAa,CAAC;AA6BrB;;;;;GAKG;AACH,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;CAC1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,kCAAkC,GAC1C,qBAAqB,CAcvB"}