scoutline 0.12.0 → 0.13.0

package/dist/providers/jina/adapter.js.map

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

package/dist/providers/jina/client.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Jina AI direct HTTP transport.
+ *
+ * Performs direct HTTP requests against Jina Reader (r.jina.ai) and Search (s.jina.ai).
+ */
+import type { ProviderQuotaFetchResponse } from "../types.js";
+export interface JinaTransportDeps {
+    readonly fetch?: (input: string, init: Record<string, unknown>) => Promise<ProviderQuotaFetchResponse>;
+    readonly setTimeout?: typeof setTimeout;
+    readonly clearTimeout?: typeof clearTimeout;
+    readonly env?: NodeJS.ProcessEnv;
+}
+export interface JinaDataItem {
+    readonly title?: string;
+    readonly url?: string;
+    readonly content?: string;
+    readonly description?: string;
+    readonly publishedTime?: string;
+    readonly metadata?: unknown;
+    readonly external?: unknown;
+}
+export interface JinaResponse {
+    readonly code?: number;
+    readonly data?: JinaDataItem | readonly JinaDataItem[];
+}
+export declare function fetchJinaReader(apiKey: string | undefined, targetUrl: string, deps?: JinaTransportDeps): Promise<JinaDataItem>;
+export declare function fetchJinaSearch(apiKey: string | undefined, query: string, deps?: JinaTransportDeps): Promise<readonly JinaDataItem[]>;
+export interface JinaDeepSearchUrlCitation {
+    readonly title?: string;
+    readonly url: string;
+    readonly exactQuote?: string;
+}
+export interface JinaDeepSearchAnnotation {
+    readonly url_citation?: JinaDeepSearchUrlCitation;
+}
+export interface JinaDeepSearchResponse {
+    readonly choices?: readonly {
+        readonly message?: {
+            readonly content?: string;
+            readonly annotations?: readonly JinaDeepSearchAnnotation[];
+        };
+    }[];
+    readonly visitedURLs?: readonly string[];
+}
+export declare function fetchJinaDeepSearch(apiKey: string | undefined, query: string, deps?: JinaTransportDeps): Promise<JinaDeepSearchResponse>;
+//# sourceMappingURL=client.d.ts.map

package/dist/providers/jina/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/providers/jina/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAY9D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,CACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,UAAU,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,YAAY,CAAC;IAC5C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,CAAC;CACxD;AA0BD,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAyDvB;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAyDlC;AAWD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,yBAAyB,CAAC;CACnD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS;QAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE;YACjB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;YAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;SAC5D,CAAC;KACH,EAAE,CAAC;IACJ,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAOD,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CAyDjC"}

package/dist/providers/jina/client.js

@@ -0,0 +1,203 @@
+/**
+ * Jina AI direct HTTP transport.
+ *
+ * Performs direct HTTP requests against Jina Reader (r.jina.ai) and Search (s.jina.ai).
+ */
+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 READER_BASE_URL = "https://r.jina.ai";
+const SEARCH_BASE_URL = "https://s.jina.ai";
+const DEFAULT_TIMEOUT_MS = 30000;
+const USER_AGENT = `scoutline/${VERSION}`;
+const TIMEOUT_HELP_TEXT = "Try again or increase timeout with JINA_TIMEOUT env var";
+function resolveTimeoutMs(env) {
+    const raw = parseInt(env.JINA_TIMEOUT || String(DEFAULT_TIMEOUT_MS), 10);
+    return Number.isFinite(raw) && raw > 0 ? raw : DEFAULT_TIMEOUT_MS;
+}
+function mapStatusError(status, timeoutMs) {
+    if (status === 401 || status === 403) {
+        return new AuthError("Jina AI authentication failed", "JINA_API_KEY");
+    }
+    if (status === 408 || status === 504) {
+        return new TimeoutError(timeoutMs, TIMEOUT_HELP_TEXT);
+    }
+    if (status === 429) {
+        return new ApiError("Jina AI rate limit exceeded", 429);
+    }
+    if (status >= 400 && status < 500) {
+        return new ApiError(`Jina AI API client error (${status})`, status);
+    }
+    if (status >= 500) {
+        return new ApiError(`Jina AI API server error (${status})`, status);
+    }
+    return new ApiError(`Jina AI request failed (${status})`, status);
+}
+export async function fetchJinaReader(apiKey, targetUrl, deps = {}) {
+    const fetchFn = deps.fetch || globalThis.fetch;
+    const setTimer = deps.setTimeout || globalThis.setTimeout;
+    const clearTimer = deps.clearTimeout || globalThis.clearTimeout;
+    const env = deps.env || process.env;
+    const timeoutMs = resolveTimeoutMs(env);
+    const endpoint = `${READER_BASE_URL}/${encodeURIComponent(targetUrl)}`;
+    const headers = {
+        "Accept": "application/json",
+        "User-Agent": USER_AGENT,
+    };
+    if (apiKey) {
+        headers["Authorization"] = `Bearer ${apiKey}`;
+    }
+    const controller = new AbortController();
+    const timer = setTimer(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetchFn(endpoint, {
+            method: "GET",
+            headers,
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            throw mapStatusError(response.status, timeoutMs);
+        }
+        const text = await response.text();
+        const json = JSON.parse(text);
+        const data = json.data;
+        if (Array.isArray(data)) {
+            return data[0] || { url: targetUrl, content: "" };
+        }
+        if (data && typeof data === "object") {
+            return data;
+        }
+        return { url: targetUrl, content: "" };
+    }
+    catch (err) {
+        if (err instanceof AuthError || err instanceof ApiError || err instanceof TimeoutError) {
+            throw err;
+        }
+        if (err instanceof SyntaxError) {
+            throw new ApiError("Jina AI returned a malformed JSON response", 500);
+        }
+        if (err instanceof Error && err.name === "AbortError") {
+            throw new TimeoutError(timeoutMs, TIMEOUT_HELP_TEXT);
+        }
+        throw new NetworkError(`Jina AI request failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    finally {
+        clearTimer(timer);
+    }
+}
+export async function fetchJinaSearch(apiKey, query, deps = {}) {
+    const fetchFn = deps.fetch || globalThis.fetch;
+    const setTimer = deps.setTimeout || globalThis.setTimeout;
+    const clearTimer = deps.clearTimeout || globalThis.clearTimeout;
+    const env = deps.env || process.env;
+    const timeoutMs = resolveTimeoutMs(env);
+    const endpoint = `${SEARCH_BASE_URL}/${encodeURIComponent(query)}`;
+    const headers = {
+        "Accept": "application/json",
+        "User-Agent": USER_AGENT,
+    };
+    if (apiKey) {
+        headers["Authorization"] = `Bearer ${apiKey}`;
+    }
+    const controller = new AbortController();
+    const timer = setTimer(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetchFn(endpoint, {
+            method: "GET",
+            headers,
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            throw mapStatusError(response.status, timeoutMs);
+        }
+        const text = await response.text();
+        const json = JSON.parse(text);
+        const data = json.data;
+        if (Array.isArray(data)) {
+            return data;
+        }
+        if (data && typeof data === "object") {
+            return [data];
+        }
+        return [];
+    }
+    catch (err) {
+        if (err instanceof AuthError || err instanceof ApiError || err instanceof TimeoutError) {
+            throw err;
+        }
+        if (err instanceof SyntaxError) {
+            throw new ApiError("Jina AI returned a malformed JSON response", 500);
+        }
+        if (err instanceof Error && err.name === "AbortError") {
+            throw new TimeoutError(timeoutMs, TIMEOUT_HELP_TEXT);
+        }
+        throw new NetworkError(`Jina AI request failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    finally {
+        clearTimer(timer);
+    }
+}
+// ---------------------------------------------------------------------------
+// DeepSearch API — deepsearch.jina.ai (OpenAI-compatible chat completions)
+// ---------------------------------------------------------------------------
+const DEEPSEARCH_BASE_URL = "https://deepsearch.jina.ai";
+const DEFAULT_DEEPSEARCH_TIMEOUT_MS = 120000;
+const DEEPSEARCH_TIMEOUT_HELP_TEXT = "Try again or increase timeout with JINA_DEEPSEARCH_TIMEOUT env var";
+function resolveDeepSearchTimeoutMs(env) {
+    const raw = parseInt(env.JINA_DEEPSEARCH_TIMEOUT || String(DEFAULT_DEEPSEARCH_TIMEOUT_MS), 10);
+    return Number.isFinite(raw) && raw > 0 ? raw : DEFAULT_DEEPSEARCH_TIMEOUT_MS;
+}
+export async function fetchJinaDeepSearch(apiKey, query, deps = {}) {
+    const fetchFn = deps.fetch || globalThis.fetch;
+    const setTimer = deps.setTimeout || globalThis.setTimeout;
+    const clearTimer = deps.clearTimeout || globalThis.clearTimeout;
+    const env = deps.env || process.env;
+    const timeoutMs = resolveDeepSearchTimeoutMs(env);
+    const url = `${DEEPSEARCH_BASE_URL}/v1/chat/completions`;
+    const body = {
+        model: "jina-deepsearch-v1",
+        messages: [{ role: "user", content: query }],
+        stream: false,
+        reasoning_effort: "medium",
+        max_returned_urls: 10,
+    };
+    const headers = {
+        "Content-Type": "application/json",
+        "User-Agent": USER_AGENT,
+    };
+    if (apiKey) {
+        headers["Authorization"] = `Bearer ${apiKey}`;
+    }
+    const controller = new AbortController();
+    const timer = setTimer(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetchFn(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            throw mapStatusError(response.status, timeoutMs);
+        }
+        const text = await response.text();
+        return JSON.parse(text);
+    }
+    catch (err) {
+        if (err instanceof AuthError || err instanceof ApiError || err instanceof TimeoutError) {
+            throw err;
+        }
+        if (err instanceof SyntaxError) {
+            throw new ApiError("Jina AI returned a malformed JSON response", 500);
+        }
+        if (err instanceof Error && err.name === "AbortError") {
+            throw new TimeoutError(timeoutMs, DEEPSEARCH_TIMEOUT_HELP_TEXT);
+        }
+        throw new NetworkError(`Jina AI DeepSearch failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    finally {
+        clearTimer(timer);
+    }
+}
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * Jina AI credential resolution.
+ *
+ * Single source of truth for the Jina AI API key (`JINA_API_KEY`).
+ *
+ * Jina supports keyless access (free tier), so the key is optional.
+ * `isJinaConfigured` always returns true because the transport works
+ * without authentication. An API key raises rate limits and is
+ * recommended for production use, but is not required for the provider
+ * to participate in selection, fallback, or diagnostics.
+ */
+export declare function resolveJinaApiKey(env: NodeJS.ProcessEnv): string | undefined;
+export declare function isJinaConfigured(_env: NodeJS.ProcessEnv): boolean;
+//# sourceMappingURL=credentials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../../src/providers/jina/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,SAAS,CAE5E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAGjE"}

package/dist/providers/jina/credentials.js

@@ -0,0 +1,24 @@
+/**
+ * Jina AI credential resolution.
+ *
+ * Single source of truth for the Jina AI API key (`JINA_API_KEY`).
+ *
+ * Jina supports keyless access (free tier), so the key is optional.
+ * `isJinaConfigured` always returns true because the transport works
+ * without authentication. An API key raises rate limits and is
+ * recommended for production use, but is not required for the provider
+ * to participate in selection, fallback, or diagnostics.
+ */
+function pickNonBlank(raw) {
+    if (typeof raw !== "string")
+        return undefined;
+    return raw.trim().length > 0 ? raw : undefined;
+}
+export function resolveJinaApiKey(env) {
+    return pickNonBlank(env.JINA_API_KEY);
+}
+export function isJinaConfigured(_env) {
+    // Jina supports keyless access — always available.
+    return true;
+}
+//# sourceMappingURL=credentials.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../../src/providers/jina/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,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,MAAM,UAAU,iBAAiB,CAAC,GAAsB;IACtD,OAAO,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAuB;IACtD,mDAAmD;IACnD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Jina AI Diagnostics Capability.
+ *
+ * Probes Jina AI connectivity with a lightweight probe request.
+ */
+import type { DiagnosticsCapability } from "../../capabilities/diagnostics.js";
+import { type JinaTransportDeps } from "./client.js";
+export interface JinaDiagnosticsCapabilityOptions {
+    readonly env: NodeJS.ProcessEnv;
+    readonly transport?: JinaTransportDeps;
+}
+export declare function createJinaDiagnosticsCapability(options: JinaDiagnosticsCapabilityOptions): DiagnosticsCapability;
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/providers/jina/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAqB,MAAM,mCAAmC,CAAC;AAUlG,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAgBtE,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,iBAAiB,CAAC;CACxC;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,gCAAgC,GACxC,qBAAqB,CAavB"}

package/dist/providers/jina/diagnostics.js

@@ -0,0 +1,36 @@
+/**
+ * Jina AI Diagnostics Capability.
+ *
+ * Probes Jina AI connectivity with a lightweight probe request.
+ */
+import { ApiError, AuthError, ConfigurationError, NetworkError, QuotaError, TimeoutError, } from "../../lib/errors.js";
+import { resolveJinaApiKey } from "./credentials.js";
+import { fetchJinaSearch } from "./client.js";
+function normalizeProbeError(error) {
+    if (error instanceof AuthError ||
+        error instanceof QuotaError ||
+        error instanceof ApiError ||
+        error instanceof NetworkError ||
+        error instanceof TimeoutError ||
+        error instanceof ConfigurationError) {
+        return error;
+    }
+    return new ApiError("Jina AI diagnostics probe failed", 500);
+}
+export function createJinaDiagnosticsCapability(options) {
+    const { env, transport } = options;
+    return {
+        async invoke(diagOptions) {
+            if (!diagOptions.probe)
+                return;
+            const apiKey = resolveJinaApiKey(env);
+            try {
+                await fetchJinaSearch(apiKey, "scoutline-doctor-probe", transport);
+            }
+            catch (error) {
+                throw normalizeProbeError(error);
+            }
+        },
+    };
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/providers/jina/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../src/providers/jina/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACV,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAA0B,MAAM,aAAa,CAAC;AAEtE,SAAS,mBAAmB,CAAC,KAAc;IACzC,IACE,KAAK,YAAY,SAAS;QAC1B,KAAK,YAAY,UAAU;QAC3B,KAAK,YAAY,QAAQ;QACzB,KAAK,YAAY,YAAY;QAC7B,KAAK,YAAY,YAAY;QAC7B,KAAK,YAAY,kBAAkB,EACnC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;AAC/D,CAAC;AAOD,MAAM,UAAU,+BAA+B,CAC7C,OAAyC;IAEzC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IACnC,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,WAA8B;YACzC,IAAI,CAAC,WAAW,CAAC,KAAK;gBAAE,OAAO;YAC/B,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,eAAe,CAAC,MAAM,EAAE,wBAAwB,EAAE,SAAS,CAAC,CAAC;YACrE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,mBAAmB,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/providers/parallel/adapter.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Parallel AI Provider Adapter.
+ *
+ * Implements Search, Research, and Diagnostics capabilities for Parallel AI.
+ *
+ * Field mapping (Parallel API → Provider-neutral):
+ *   results[].title         -> title
+ *   results[].url           -> url
+ *   results[].excerpts[]    -> summary (joined with double newlines)
+ *   results[].publish_date  -> date
+ *
+ * Reader (Extract API):
+ *   results[].full_content  -> content (fallback: excerpts joined)
+ *   results[].title         -> title
+ *   results[].url           -> finalUrl
+ *
+ * Control mapping (SearchControls → Parallel-native API params):
+ *   topic     -> appended to query string (Parallel has no native topic field)
+ *   type      -> REJECTED (UnsupportedOptionError)
+ *   location  -> REJECTED (UnsupportedOptionError)
+ *   domain    -> REJECTED (UnsupportedOptionError; API does not accept it)
+ *   recency   -> REJECTED (UnsupportedOptionError; API does not accept it)
+ */
+import type { ProviderAdapter, ProviderContext, ProviderDescriptor, ProviderId } from "../types.js";
+import type { SearchCapability } from "../../capabilities/search.js";
+import type { ResearchCapability } from "../../capabilities/research.js";
+import type { ReaderCapability } from "../../capabilities/reader.js";
+import type { DiagnosticsCapability } from "../../capabilities/diagnostics.js";
+import { type ParallelTransportDeps } from "./client.js";
+export interface ParallelAdapterDependencies {
+    readonly transport?: ParallelTransportDeps;
+}
+export declare class ParallelAdapter implements ProviderAdapter {
+    private readonly context;
+    readonly id: ProviderId;
+    readonly search: SearchCapability;
+    readonly research: ResearchCapability;
+    readonly reader: ReaderCapability;
+    readonly diagnostics: DiagnosticsCapability;
+    constructor(context: ProviderContext, deps?: ParallelAdapterDependencies);
+}
+export declare function createParallelDescriptor(): ProviderDescriptor;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/providers/parallel/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/parallel/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EACV,eAAe,EAEf,eAAe,EACf,kBAAkB,EAClB,UAAU,EACX,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAEV,gBAAgB,EAGjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,kBAAkB,EAGnB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAY/E,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,aAAa,CAAC;AA+BrB,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;CAC5C;AAWD,qBAAa,eAAgB,YAAW,eAAe;IAQnD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAc;IACrC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAE5C,YACmB,OAAO,EAAE,eAAe,EACzC,IAAI,GAAE,2BAAgC,EA2NvC;CACF;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAU7D"}