scoutline 0.12.0 → 0.13.0

package/dist/providers/parallel/adapter.js

@@ -0,0 +1,270 @@
+/**
+ * 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 crypto from "node:crypto";
+import { decodeResearchResult } from "../../capabilities/research.js";
+import { decodeReaderFetchResult } from "../../capabilities/reader.js";
+import { ApiError, AuthError, ConfigurationError, NetworkError, QuotaError, TimeoutError, UnsupportedOptionError, ValidationError, } from "../../lib/errors.js";
+import { requireParallelApiKey, isParallelConfigured } from "./credentials.js";
+import { fetchParallelSearch, fetchParallelExtract, } from "./client.js";
+import { createParallelDiagnosticsCapability } from "./diagnostics.js";
+function credentialFingerprint(apiKey) {
+    return crypto.createHash("sha256").update(apiKey).digest("hex");
+}
+/**
+ * Normalize a Provider failure with sanitized messages. Raw response
+ * bodies never cross the adapter boundary. Same pattern as the Tavily
+ * adapter's `normalizeTavilyError`.
+ */
+function normalizeParallelError(error) {
+    if (error instanceof QuotaError ||
+        error instanceof ValidationError ||
+        error instanceof UnsupportedOptionError ||
+        error instanceof ConfigurationError ||
+        error instanceof AuthError ||
+        error instanceof ApiError ||
+        error instanceof NetworkError ||
+        error instanceof TimeoutError) {
+        return error;
+    }
+    return new ApiError(`Parallel AI request failed: ${error instanceof Error ? error.message : String(error)}`, 500);
+}
+function assertHttpUrl(url) {
+    if (typeof url !== "string" || url.length === 0) {
+        throw new ValidationError("Parallel reader URL must be a non-empty string");
+    }
+    if (!/^https?:\/\//.test(url)) {
+        throw new ValidationError("URL must start with http:// or https://");
+    }
+}
+export class ParallelAdapter {
+    context;
+    id = "parallel";
+    search;
+    research;
+    reader;
+    diagnostics;
+    constructor(context, deps = {}) {
+        this.context = context;
+        const transport = deps.transport;
+        const env = context.env;
+        this.search = {
+            validate(request) {
+                if (!request.query || request.query.trim().length === 0) {
+                    throw new ValidationError("Search query must not be empty");
+                }
+                if (request.controls?.type !== undefined) {
+                    throw new UnsupportedOptionError("parallel", "search", "type");
+                }
+                if (request.controls?.location !== undefined) {
+                    throw new UnsupportedOptionError("parallel", "search", "location");
+                }
+                if (request.controls?.domain !== undefined) {
+                    throw new UnsupportedOptionError("parallel", "search", "domain");
+                }
+                if (request.controls?.recency !== undefined) {
+                    throw new UnsupportedOptionError("parallel", "search", "recency");
+                }
+                if (request.controls?.contentSize !== undefined) {
+                    throw new UnsupportedOptionError("parallel", "search", "contentSize");
+                }
+            },
+            cacheIdentity(request) {
+                const apiKey = requireParallelApiKey(env);
+                return {
+                    provider: "parallel",
+                    capability: "search",
+                    credentialFingerprint: credentialFingerprint(apiKey),
+                    request: {
+                        query: request.query.trim(),
+                        controls: request.controls,
+                    },
+                };
+            },
+            async invoke(request) {
+                const apiKey = requireParallelApiKey(env);
+                let query = request.query.trim();
+                // Parallel AI has no native topic parameter, so we append it to
+                // the query string to bias results.
+                if (request.controls?.topic && request.controls.topic !== "general") {
+                    query = `${query} ${request.controls.topic}`;
+                }
+                const params = {};
+                try {
+                    const response = await fetchParallelSearch(apiKey, query, params, transport);
+                    const results = response.results || [];
+                    return results.map((item) => ({
+                        title: item.title || "Untitled",
+                        url: item.url || "",
+                        summary: item.excerpts?.join("\n\n") || "",
+                        source: "Parallel AI",
+                        date: item.publish_date || undefined,
+                    }));
+                }
+                catch (error) {
+                    throw normalizeParallelError(error);
+                }
+            },
+        };
+        this.research = {
+            run: {
+                kind: "research-fetch",
+                validate(request) {
+                    if (!request.query || request.query.trim().length === 0) {
+                        throw new ValidationError("Research query must not be empty");
+                    }
+                    for (const option of [
+                        "model",
+                        "outputLength",
+                        "citationFormat",
+                        "domain",
+                    ]) {
+                        if (request[option] !== undefined) {
+                            throw new UnsupportedOptionError("parallel", "research", option);
+                        }
+                    }
+                },
+                cacheIdentity(request) {
+                    const apiKey = requireParallelApiKey(env);
+                    return {
+                        provider: "parallel",
+                        capability: "research",
+                        operation: "research-fetch",
+                        credentialFingerprint: credentialFingerprint(apiKey),
+                        request,
+                    };
+                },
+                decodeCached: decodeResearchResult,
+                async invoke(request) {
+                    const apiKey = requireParallelApiKey(env);
+                    const query = request.query.trim();
+                    try {
+                        const response = await fetchParallelSearch(apiKey, query, { objective: "deep-research" }, transport);
+                        const results = response.results || [];
+                        // Parallel AI does not return a synthesized report field.
+                        // Build the report from the excerpts of all results.
+                        const report = results.length > 0
+                            ? results
+                                .map((r) => r.excerpts?.join("\n"))
+                                .filter((text) => typeof text === "string" && text.length > 0)
+                                .join("\n\n")
+                            : "No research findings available.";
+                        return {
+                            schemaVersion: 1,
+                            query,
+                            model: "auto",
+                            report,
+                            sources: results
+                                .filter((r) => r.url)
+                                .map((r) => ({
+                                title: r.title || "Untitled",
+                                url: r.url,
+                            })),
+                        };
+                    }
+                    catch (error) {
+                        throw normalizeParallelError(error);
+                    }
+                },
+            },
+        };
+        this.reader = {
+            fetch: {
+                kind: "reader-fetch",
+                validate(request) {
+                    assertHttpUrl(request.url);
+                    // Parallel Extract always returns markdown content.
+                    if (request.format === "text") {
+                        throw new UnsupportedOptionError("parallel", "reader", "format");
+                    }
+                    for (const key of [
+                        "withLinksSummary",
+                        "noGfm",
+                        "keepImgDataUrl",
+                        "withImagesSummary",
+                        "retainImages",
+                    ]) {
+                        if (request[key] === true) {
+                            throw new UnsupportedOptionError("parallel", "reader", key);
+                        }
+                    }
+                },
+                cacheIdentity(request) {
+                    const apiKey = requireParallelApiKey(env);
+                    return {
+                        provider: "parallel",
+                        capability: "reader",
+                        operation: "reader-fetch",
+                        credentialFingerprint: credentialFingerprint(apiKey),
+                        request,
+                        legacyCandidates: [],
+                    };
+                },
+                decodeCached: decodeReaderFetchResult,
+                async invoke(request) {
+                    const apiKey = requireParallelApiKey(env);
+                    try {
+                        const response = await fetchParallelExtract(apiKey, request.url, transport);
+                        // Check for extraction errors for the requested URL
+                        if (response.errors && response.errors.length > 0) {
+                            for (const err of response.errors) {
+                                if (err.url === request.url) {
+                                    throw new ApiError(`Parallel AI extract failed for URL (${err.error_type || "unknown"})`, err.http_status_code || 422);
+                                }
+                            }
+                        }
+                        const result = response.results?.[0];
+                        const content = result?.full_content || result?.excerpts?.join("\n\n") || "";
+                        if (content.length === 0) {
+                            throw new ApiError("Parallel AI extract returned no content", 422);
+                        }
+                        return {
+                            schemaVersion: 1,
+                            url: request.url,
+                            finalUrl: result?.url || request.url,
+                            title: result?.title || null,
+                            content,
+                            contentFormat: "markdown",
+                        };
+                    }
+                    catch (error) {
+                        throw normalizeParallelError(error);
+                    }
+                },
+            },
+        };
+        this.diagnostics = createParallelDiagnosticsCapability({ env, transport });
+    }
+}
+export function createParallelDescriptor() {
+    return {
+        id: "parallel",
+        credentialEnvVars: ["PARALLEL_API_KEY"],
+        isConfigured: isParallelConfigured,
+        capabilities() {
+            return new Set(["search", "research", "reader", "diagnostics"]);
+        },
+        create: (context) => new ParallelAdapter(context),
+    };
+}
+//# sourceMappingURL=adapter.js.map

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * Parallel AI direct HTTP transport.
+ *
+ * Performs direct HTTP requests against Parallel AI API endpoints.
+ */
+import type { ProviderQuotaFetchResponse } from "../types.js";
+export interface ParallelTransportDeps {
+    readonly fetch?: (input: string, init: Record<string, unknown>) => Promise<ProviderQuotaFetchResponse>;
+    readonly setTimeout?: typeof setTimeout;
+    readonly clearTimeout?: typeof clearTimeout;
+    readonly env?: NodeJS.ProcessEnv;
+}
+export interface ParallelSearchParams {
+    readonly objective?: string;
+}
+export interface ParallelSearchResultItem {
+    readonly title?: string;
+    readonly url?: string;
+    readonly excerpts?: readonly string[];
+    readonly publish_date?: string | null;
+}
+export interface ParallelSearchResponse {
+    readonly search_id?: string;
+    readonly results?: readonly ParallelSearchResultItem[];
+    readonly usage?: readonly unknown[];
+    readonly session_id?: string;
+}
+export declare function fetchParallelSearch(apiKey: string, query: string, params?: ParallelSearchParams, deps?: ParallelTransportDeps): Promise<ParallelSearchResponse>;
+export interface ParallelExtractResultItem {
+    readonly url?: string;
+    readonly title?: string;
+    readonly publish_date?: string | null;
+    readonly excerpts?: readonly string[];
+    readonly full_content?: string;
+}
+export interface ParallelExtractErrorEntry {
+    readonly url?: string;
+    readonly error_type?: string;
+    readonly http_status_code?: number;
+}
+export interface ParallelExtractResponse {
+    readonly results?: readonly ParallelExtractResultItem[];
+    readonly errors?: readonly ParallelExtractErrorEntry[];
+}
+export declare function fetchParallelExtract(apiKey: string, targetUrl: string, deps?: ParallelTransportDeps): Promise<ParallelExtractResponse>;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/providers/parallel/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAW9D,MAAM,WAAW,qBAAqB;IACpC,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,oBAAoB;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AA0BD,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,oBAAyB,EACjC,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAoDjC;AAMD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;CACxD;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CA+ClC"}

package/dist/providers/parallel/client.js

@@ -0,0 +1,127 @@
+/**
+ * Parallel AI direct HTTP transport.
+ *
+ * Performs direct HTTP requests against Parallel AI API endpoints.
+ */
+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.parallel.ai";
+const DEFAULT_TIMEOUT_MS = 30000;
+const USER_AGENT = `scoutline/${VERSION}`;
+const TIMEOUT_HELP_TEXT = "Try again or increase timeout with PARALLEL_TIMEOUT env var";
+function resolveTimeoutMs(env) {
+    const raw = parseInt(env.PARALLEL_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("Parallel AI authentication failed", "PARALLEL_API_KEY");
+    }
+    if (status === 408 || status === 504) {
+        return new TimeoutError(timeoutMs, TIMEOUT_HELP_TEXT);
+    }
+    if (status === 429) {
+        return new ApiError("Parallel AI rate limit exceeded", 429);
+    }
+    if (status >= 400 && status < 500) {
+        return new ApiError(`Parallel AI API client error (${status})`, status);
+    }
+    if (status >= 500) {
+        return new ApiError(`Parallel AI API server error (${status})`, status);
+    }
+    return new ApiError(`Parallel AI request failed (${status})`, status);
+}
+export async function fetchParallelSearch(apiKey, query, params = {}, 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 url = `${BASE_URL}/v1/search`;
+    const body = {
+        search_queries: [query],
+    };
+    if (params.objective) {
+        body.objective = params.objective;
+    }
+    const controller = new AbortController();
+    const timer = setTimer(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetchFn(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Authorization": `Bearer ${apiKey}`,
+                "User-Agent": USER_AGENT,
+            },
+            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("Parallel AI returned a malformed JSON response", 500);
+        }
+        if (err instanceof Error && err.name === "AbortError") {
+            throw new TimeoutError(timeoutMs, TIMEOUT_HELP_TEXT);
+        }
+        throw new NetworkError(`Parallel AI request failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    finally {
+        clearTimer(timer);
+    }
+}
+export async function fetchParallelExtract(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 url = `${BASE_URL}/v1/extract`;
+    const body = { urls: [targetUrl] };
+    const controller = new AbortController();
+    const timer = setTimer(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetchFn(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Authorization": `Bearer ${apiKey}`,
+                "User-Agent": USER_AGENT,
+            },
+            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("Parallel AI returned a malformed JSON response", 500);
+        }
+        if (err instanceof Error && err.name === "AbortError") {
+            throw new TimeoutError(timeoutMs, TIMEOUT_HELP_TEXT);
+        }
+        throw new NetworkError(`Parallel AI extract failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    finally {
+        clearTimer(timer);
+    }
+}
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * Parallel AI credential resolution.
+ *
+ * Single source of truth for the Parallel AI API key (`PARALLEL_API_KEY`).
+ */
+export declare function resolveParallelApiKey(env: NodeJS.ProcessEnv): string | undefined;
+export declare function requireParallelApiKey(env: NodeJS.ProcessEnv): string;
+export declare function isParallelConfigured(env: NodeJS.ProcessEnv): boolean;
+//# sourceMappingURL=credentials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../../src/providers/parallel/credentials.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,SAAS,CAEhF;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CASpE;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAEpE"}

package/dist/providers/parallel/credentials.js

@@ -0,0 +1,26 @@
+/**
+ * Parallel AI credential resolution.
+ *
+ * Single source of truth for the Parallel AI API key (`PARALLEL_API_KEY`).
+ */
+import { ConfigurationError } from "../../lib/errors.js";
+const MISSING_KEY_HELP = 'export PARALLEL_API_KEY="your-parallel-api-key"';
+function pickNonBlank(raw) {
+    if (typeof raw !== "string")
+        return undefined;
+    return raw.trim().length > 0 ? raw : undefined;
+}
+export function resolveParallelApiKey(env) {
+    return pickNonBlank(env.PARALLEL_API_KEY);
+}
+export function requireParallelApiKey(env) {
+    const key = resolveParallelApiKey(env);
+    if (key === undefined) {
+        throw new ConfigurationError("PARALLEL_API_KEY environment variable is required", MISSING_KEY_HELP);
+    }
+    return key;
+}
+export function isParallelConfigured(env) {
+    return resolveParallelApiKey(env) !== undefined;
+}
+//# sourceMappingURL=credentials.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../../src/providers/parallel/credentials.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,gBAAgB,GAAG,iDAAiD,CAAC;AAE3E,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,qBAAqB,CAAC,GAAsB;IAC1D,OAAO,YAAY,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAsB;IAC1D,MAAM,GAAG,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,kBAAkB,CAC1B,mDAAmD,EACnD,gBAAgB,CACjB,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAsB;IACzD,OAAO,qBAAqB,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;AAClD,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/providers/parallel/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAqB,MAAM,mCAAmC,CAAC;AAUlG,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAgB9E,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;CAC5C;AAED,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,oCAAoC,GAC5C,qBAAqB,CAavB"}

package/dist/providers/parallel/diagnostics.js

@@ -0,0 +1,36 @@
+/**
+ * Parallel AI Diagnostics Capability.
+ *
+ * Probes Parallel AI connectivity with a lightweight probe request.
+ */
+import { ApiError, AuthError, ConfigurationError, NetworkError, QuotaError, TimeoutError, } from "../../lib/errors.js";
+import { requireParallelApiKey } from "./credentials.js";
+import { fetchParallelSearch } 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("Parallel AI diagnostics probe failed", 500);
+}
+export function createParallelDiagnosticsCapability(options) {
+    const { env, transport } = options;
+    return {
+        async invoke(diagOptions) {
+            if (!diagOptions.probe)
+                return;
+            const apiKey = requireParallelApiKey(env);
+            try {
+                await fetchParallelSearch(apiKey, "scoutline-doctor-probe", {}, transport);
+            }
+            catch (error) {
+                throw normalizeProbeError(error);
+            }
+        },
+    };
+}
+//# sourceMappingURL=diagnostics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../src/providers/parallel/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,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAA8B,MAAM,aAAa,CAAC;AAE9E,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,sCAAsC,EAAE,GAAG,CAAC,CAAC;AACnE,CAAC;AAOD,MAAM,UAAU,mCAAmC,CACjD,OAA6C;IAE7C,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,qBAAqB,CAAC,GAAG,CAAC,CAAC;YAC1C,IAAI,CAAC;gBACH,MAAM,mBAAmB,CAAC,MAAM,EAAE,wBAAwB,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;YAC7E,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,mBAAmB,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,56 @@
+/**
+ * Perplexity Provider Adapter.
+ *
+ * Implements Search, Research, and Diagnostics capabilities for the
+ * Perplexity API.
+ *
+ * Search uses the dedicated Search API (POST /search) which returns
+ * structured results with titles, URLs, snippets, and dates — far richer
+ * than mapping chat completions to citations.
+ *
+ * Research uses the Sonar Chat Completions endpoint with the
+ * `sonar-deep-research` model, which is designed for comprehensive
+ * report synthesis. The response includes `search_results[]` with
+ * structured source data (title, url, date, snippet).
+ *
+ * Reader is intentionally omitted: Perplexity does not offer a
+ * dedicated webpage extraction API.
+ *
+ * Field mapping:
+ *   Search (/search):
+ *     results[].title   -> title
+ *     results[].url     -> url
+ *     results[].snippet -> summary
+ *     results[].date    -> date
+ *   Research (/chat/completions):
+ *     choices[0].message.content -> report
+ *     search_results[].title/url -> sources[]
+ *     citations[] (fallback)     -> sources[]
+ *
+ * Control mapping (SearchControls → Search API params):
+ *   domain      -> search_domain_filter: [domain]
+ *   recency     -> search_recency_filter (oneDay→"day", oneWeek→"week",
+ *                  oneMonth→"month", oneYear→"year", noLimit→omit)
+ *   contentSize -> search_context_size (medium→"medium", high→"high")
+ *   type        -> REJECTED (UnsupportedOptionError)
+ *   location    -> REJECTED (UnsupportedOptionError)
+ *   topic       -> REJECTED (UnsupportedOptionError)
+ */
+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 { DiagnosticsCapability } from "../../capabilities/diagnostics.js";
+import { type PerplexityTransportDeps } from "./client.js";
+export interface PerplexityAdapterDependencies {
+    readonly transport?: PerplexityTransportDeps;
+}
+export declare class PerplexityAdapter implements ProviderAdapter {
+    private readonly context;
+    readonly id: ProviderId;
+    readonly search: SearchCapability;
+    readonly research: ResearchCapability;
+    readonly diagnostics: DiagnosticsCapability;
+    constructor(context: ProviderContext, deps?: PerplexityAdapterDependencies);
+}
+export declare function createPerplexityDescriptor(): ProviderDescriptor;
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/perplexity/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAGH,OAAO,KAAK,EACV,eAAe,EAEf,eAAe,EACf,kBAAkB,EAClB,UAAU,EACX,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAIV,gBAAgB,EAGjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,kBAAkB,EAGnB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAY/E,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,aAAa,CAAC;AAoErB,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,uBAAuB,CAAC;CAC9C;AAED,qBAAa,iBAAkB,YAAW,eAAe;IAOrD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAgB;IACvC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAE5C,YACmB,OAAO,EAAE,eAAe,EACzC,IAAI,GAAE,6BAAkC,EAyIzC;CACF;AAED,wBAAgB,0BAA0B,IAAI,kBAAkB,CAU/D"}