scoutline 0.17.7 → 0.18.0

package/dist/providers/linkup/credentials.js

@@ -0,0 +1,66 @@
+/**
+ * Linkup credential resolution.
+ *
+ * Single source of truth for the Linkup API key (`LINKUP_API_KEY`).
+ * Whitespace-only values are treated as absent, matching the
+ * descriptor's `isConfigured` contract. Resolved keys are returned
+ * trimmed so wire headers never carry stray whitespace.
+ *
+ * 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 crypto from "node:crypto";
+import { ConfigurationError } from "../../lib/errors.js";
+const MISSING_KEY_HELP = 'export LINKUP_API_KEY="your-api-key"';
+/**
+ * Pick a non-blank raw value from the environment and trim it. Returns
+ * `undefined` when the value is absent, non-string, or all whitespace.
+ */
+function pickNonBlank(raw) {
+    if (typeof raw !== "string")
+        return undefined;
+    const trimmed = raw.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+/**
+ * Resolve the Linkup API key without throwing. Returns the trimmed key
+ * or `undefined` when no non-blank value is present.
+ */
+export function getLinkupApiKey(env) {
+    return pickNonBlank(env.LINKUP_API_KEY);
+}
+/**
+ * Resolve the Linkup API key or throw {@link ConfigurationError}
+ * (exit 3) when it is missing. Call this at every capability
+ * invocation gate.
+ */
+export function requireLinkupApiKey(env) {
+    const key = getLinkupApiKey(env);
+    if (key === undefined) {
+        throw new ConfigurationError("LINKUP_API_KEY environment variable is required", MISSING_KEY_HELP);
+    }
+    return key;
+}
+/**
+ * True when a non-blank Linkup API key is configured. Metadata-only:
+ * performs no transport construction and reads no other Provider's
+ * credentials.
+ */
+export function isLinkupConfigured(env) {
+    return getLinkupApiKey(env) !== undefined;
+}
+/**
+ * Lowercase hex SHA-256 fingerprint of the Linkup API key. Used for
+ * partitioned cache identity; the raw key must never appear in cache
+ * filenames, errors, or logs.
+ */
+export function hashLinkupApiKey(key) {
+    return crypto.createHash("sha256").update(key).digest("hex");
+}
+//# sourceMappingURL=credentials.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../../src/providers/linkup/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,gBAAgB,GAAG,sCAAsC,CAAC;AAEhE;;;GAGG;AACH,SAAS,YAAY,CAAC,GAAY;IAChC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAsB;IACpD,OAAO,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAsB;IACxD,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACjC,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,eAAe,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * Linkup Diagnostics Capability.
+ *
+ * Probes Linkup connectivity with the SAME non-destructive
+ * `GET /v1/credits/balance` the Quota Capability reads: the probe
+ * authenticates the Bearer key without spending credits. The probe
+ * NEVER POSTs a search — a diagnostics probe must not be metered.
+ *
+ * Structurally cloned from the Jina diagnostics pattern
+ * (non-destructive GET, IMPLEMENTATION-CONTRACT analog-adapter table).
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - May import the diagnostics capability contract, Adapter-local
+ *     credentials, Adapter-local transport, and normalized errors.
+ *   - Must NOT import command presentation or another Provider's
+ *     Adapter.
+ */
+import type { DiagnosticsCapability } from "../../capabilities/diagnostics.js";
+import { type LinkupTransportDeps } from "./client.js";
+/**
+ * Options for the Linkup DiagnosticsCapability. The API key is
+ * resolved from `env`; transport dependencies (`fetch`, timers) are
+ * injectable for deterministic tests through the unified `transport`
+ * seam.
+ */
+export interface LinkupDiagnosticsCapabilityOptions {
+    readonly env: NodeJS.ProcessEnv;
+    readonly transport?: LinkupTransportDeps;
+}
+/**
+ * Build the Linkup DiagnosticsCapability. The probe performs ONE GET
+ * against `/credits/balance` — the cheapest credible authentication
+ * check, costless on metered billing. 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 createLinkupDiagnosticsCapability(options: LinkupDiagnosticsCapabilityOptions): DiagnosticsCapability;
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/providers/linkup/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EAA4B,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAOjF;;;;;GAKG;AACH,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,kCAAkC,GAC1C,qBAAqB,CAavB"}

package/dist/providers/linkup/diagnostics.js

@@ -0,0 +1,49 @@
+/**
+ * Linkup Diagnostics Capability.
+ *
+ * Probes Linkup connectivity with the SAME non-destructive
+ * `GET /v1/credits/balance` the Quota Capability reads: the probe
+ * authenticates the Bearer key without spending credits. The probe
+ * NEVER POSTs a search — a diagnostics probe must not be metered.
+ *
+ * Structurally cloned from the Jina diagnostics pattern
+ * (non-destructive GET, IMPLEMENTATION-CONTRACT analog-adapter table).
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - May import the diagnostics capability contract, Adapter-local
+ *     credentials, Adapter-local transport, and normalized errors.
+ *   - Must NOT import command presentation or another Provider's
+ *     Adapter.
+ */
+import { createProbeErrorNormalizer, STANDARD_PROBE_PASS_THROUGH } from "../../lib/probe-errors.js";
+import { requireLinkupApiKey } from "./credentials.js";
+import { fetchLinkupCreditBalance } from "./client.js";
+const normalizeProbeError = createProbeErrorNormalizer({
+    passThrough: STANDARD_PROBE_PASS_THROUGH,
+    fallbackMessage: "Linkup diagnostics probe failed",
+});
+/**
+ * Build the Linkup DiagnosticsCapability. The probe performs ONE GET
+ * against `/credits/balance` — the cheapest credible authentication
+ * check, costless on metered billing. 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 function createLinkupDiagnosticsCapability(options) {
+    const { env, transport } = options;
+    return {
+        async invoke(diagOptions) {
+            if (!diagOptions.probe)
+                return;
+            const apiKey = requireLinkupApiKey(env);
+            try {
+                await fetchLinkupCreditBalance(apiKey, transport);
+            }
+            catch (error) {
+                throw normalizeProbeError(error);
+            }
+        },
+    };
+}
+//# sourceMappingURL=diagnostics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../src/providers/linkup/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACpG,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAA4B,MAAM,aAAa,CAAC;AAEjF,MAAM,mBAAmB,GAAG,0BAA0B,CAAC;IACrD,WAAW,EAAE,2BAA2B;IACxC,eAAe,EAAE,iCAAiC;CACnD,CAAC,CAAC;AAaH;;;;;;;GAOG;AACH,MAAM,UAAU,iCAAiC,CAC/C,OAA2C;IAE3C,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,mBAAmB,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,wBAAwB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACpD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,mBAAmB,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/providers/linkup/quota.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Linkup Quota Capability.
+ *
+ * Maps the Linkup `GET /v1/credits/balance` response into the
+ * normalized Provider-quota interface. Linkup is metered billing: the
+ * endpoint reports ONLY a remaining credit `balance`, never a limit,
+ * so the single "credits" category publishes the exact `remaining`
+ * with `used`, `limit`, and `remainingPercent` omitted (GitHub #49
+ * unknown-limit window) — nothing is fabricated against an invented
+ * ceiling or percentage.
+ *
+ * Structurally cloned from the Jina quota pattern (non-destructive
+ * GET, IMPLEMENTATION-CONTRACT analog-adapter table): one direct GET
+ * per invoke, shared execution owns retry policy, quota never uses
+ * the response cache.
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - May import the quota capability contract, Adapter-local
+ *     credentials, Adapter-local quota transport, and normalized
+ *     errors.
+ *   - Must NOT import command presentation or another Provider's
+ *     Adapter.
+ */
+import type { ProviderQuotaSuccess, QuotaCapability } from "../../capabilities/quota.js";
+import { type LinkupTransportDeps } from "./client.js";
+/**
+ * Normalize a raw Linkup credit-balance payload
+ * (`{ balance: <number> }`) into the shared quota interface.
+ *
+ * A missing or non-finite `balance` is a malformed response and throws
+ * `ApiError` 500. A valid balance flows through
+ * `buildQuotaWindow({ remaining: balance })`, which publishes the
+ * exact remaining count and omits `used`, `limit`, and
+ * `remainingPercent` — the limit is unknown and no percentage is
+ * invented.
+ */
+export declare function normalizeLinkupQuota(raw: unknown): ProviderQuotaSuccess;
+/**
+ * Options for the Linkup QuotaCapability. The API key is resolved
+ * from `env`; transport dependencies (`fetch`, timers) are injectable
+ * for deterministic tests through the unified `transport` seam.
+ */
+export interface LinkupQuotaCapabilityOptions {
+    readonly env: NodeJS.ProcessEnv;
+    readonly transport?: LinkupTransportDeps;
+}
+/**
+ * Build the Linkup QuotaCapability. `invoke` resolves the API key
+ * (required — the credit-balance endpoint authenticates the Bearer
+ * header), performs one non-destructive GET, and normalizes the
+ * balance into the shared interface. Shared execution wraps this in
+ * the retry policy; quota never uses the response cache.
+ */
+export declare function createLinkupQuotaCapability(options: LinkupQuotaCapabilityOptions): QuotaCapability;
+//# sourceMappingURL=quota.d.ts.map

package/dist/providers/linkup/quota.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.d.ts","sourceRoot":"","sources":["../../../src/providers/linkup/quota.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EAChB,MAAM,6BAA6B,CAAC;AAIrC,OAAO,EAA4B,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAMjF;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,CAmBvE;AAqBD;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,eAAe,CAajB"}

package/dist/providers/linkup/quota.js

@@ -0,0 +1,100 @@
+/**
+ * Linkup Quota Capability.
+ *
+ * Maps the Linkup `GET /v1/credits/balance` response into the
+ * normalized Provider-quota interface. Linkup is metered billing: the
+ * endpoint reports ONLY a remaining credit `balance`, never a limit,
+ * so the single "credits" category publishes the exact `remaining`
+ * with `used`, `limit`, and `remainingPercent` omitted (GitHub #49
+ * unknown-limit window) — nothing is fabricated against an invented
+ * ceiling or percentage.
+ *
+ * Structurally cloned from the Jina quota pattern (non-destructive
+ * GET, IMPLEMENTATION-CONTRACT analog-adapter table): one direct GET
+ * per invoke, shared execution owns retry policy, quota never uses
+ * the response cache.
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - May import the quota capability contract, Adapter-local
+ *     credentials, Adapter-local quota transport, and normalized
+ *     errors.
+ *   - Must NOT import command presentation or another Provider's
+ *     Adapter.
+ */
+import { ApiError, ScoutlineError } from "../../lib/errors.js";
+import { requireLinkupApiKey } from "./credentials.js";
+import { fetchLinkupCreditBalance } from "./client.js";
+// ---------------------------------------------------------------------------
+// Normalizer
+// ---------------------------------------------------------------------------
+/**
+ * Normalize a raw Linkup credit-balance payload
+ * (`{ balance: <number> }`) into the shared quota interface.
+ *
+ * A missing or non-finite `balance` is a malformed response and throws
+ * `ApiError` 500. A valid balance flows through
+ * `buildQuotaWindow({ remaining: balance })`, which publishes the
+ * exact remaining count and omits `used`, `limit`, and
+ * `remainingPercent` — the limit is unknown and no percentage is
+ * invented.
+ */
+export function normalizeLinkupQuota(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new ApiError("Linkup quota returned a malformed response", 500);
+    }
+    const balance = raw.balance;
+    if (typeof balance !== "number" || !Number.isFinite(balance)) {
+        throw new ApiError("Linkup quota returned a malformed response", 500);
+    }
+    return {
+        provider: "linkup",
+        status: "ok",
+        categories: [
+            {
+                name: "credits",
+                unit: "credits",
+                current: { remaining: balance },
+            },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// Capability factory
+// ---------------------------------------------------------------------------
+/**
+ * Map a thrown error into a normalized Linkup quota error. Every typed
+ * transport error (ConfigurationError, QuotaError, ValidationError,
+ * ApiError, TimeoutError, NetworkError) extends
+ * {@link ScoutlineError}, so the single guard passes them through
+ * verbatim (GitHub #49); anything else is wrapped as a generic
+ * `ApiError`.
+ */
+function normalizeLinkupQuotaError(error) {
+    if (error instanceof ScoutlineError) {
+        return error;
+    }
+    return new ApiError("Linkup quota request failed", 500);
+}
+/**
+ * Build the Linkup QuotaCapability. `invoke` resolves the API key
+ * (required — the credit-balance endpoint authenticates the Bearer
+ * header), performs one non-destructive GET, and normalizes the
+ * balance into the shared interface. Shared execution wraps this in
+ * the retry policy; quota never uses the response cache.
+ */
+export function createLinkupQuotaCapability(options) {
+    const { env, transport } = options;
+    return {
+        async invoke() {
+            const apiKey = requireLinkupApiKey(env);
+            try {
+                const raw = await fetchLinkupCreditBalance(apiKey, transport);
+                return normalizeLinkupQuota(raw);
+            }
+            catch (error) {
+                throw normalizeLinkupQuotaError(error);
+            }
+        },
+    };
+}
+//# sourceMappingURL=quota.js.map

package/dist/providers/linkup/quota.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.js","sourceRoot":"","sources":["../../../src/providers/linkup/quota.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAA4B,MAAM,aAAa,CAAC;AAEjF,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,QAAQ,CAAC,4CAA4C,EAAE,GAAG,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,OAAO,GAAI,GAA+B,CAAC,OAAO,CAAC;IACzD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,QAAQ,CAAC,4CAA4C,EAAE,GAAG,CAAC,CAAC;IACxE,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,IAAI;QACZ,UAAU,EAAE;YACV;gBACE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE;aAChC;SACF;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;;;;;GAOG;AACH,SAAS,yBAAyB,CAAC,KAAc;IAC/C,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;AAC1D,CAAC;AAYD;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAqC;IAErC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IACnC,OAAO;QACL,KAAK,CAAC,MAAM;YACV,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,wBAAwB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBAC9D,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAC;YACnC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,yBAAyB,CAAC,KAAK,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/providers/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAWH,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAMjE;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,EAAE,SAAS,kBAAkB,EAUtE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,UAAU,EACd,WAAW,GAAE,SAAS,kBAAkB,EAAkC,GACzE,kBAAkB,CAEpB;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,WAAW,GAAE,SAAS,kBAAkB,EAAkC,GACzE,SAAS,kBAAkB,EAAE,CAE/B"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAa0D,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM9H;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,EAAE,SAAS,kBAAkB,EAatE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,UAAU,EACd,WAAW,GAAE,SAAS,kBAAkB,EAAkC,GACzE,kBAAkB,CAEpB;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,WAAW,GAAE,SAAS,kBAAkB,EAAkC,GACzE,SAAS,kBAAkB,EAAE,CAE/B"}

package/dist/providers/registry.js

@@ -23,6 +23,9 @@ import { createFirecrawlDescriptor } from "./firecrawl/adapter.js";
 import { createParallelDescriptor } from "./parallel/adapter.js";
 import { createPerplexityDescriptor } from "./perplexity/adapter.js";
 import { createJinaDescriptor } from "./jina/adapter.js";
+import { createLinkupDescriptor } from "./linkup/adapter.js";
+import { createYouDescriptor } from "./you/adapter.js";
+import { createSpiderDescriptor } from "./spider/adapter.js";
 import { getProviderDescriptor as lookupProviderDescriptor, getConfiguredProviderDescriptors as lookupConfigured, } from "./types.js";
 /**
  * Built-in Provider Descriptors in canonical order. Each Descriptor is
@@ -40,6 +43,9 @@ export const BUILT_IN_PROVIDER_DESCRIPTORS = [
     createParallelDescriptor(),
     createPerplexityDescriptor(),
     createJinaDescriptor(),
+    createYouDescriptor(),
+    createLinkupDescriptor(),
+    createSpiderDescriptor(),
 ];
 /**
  * Look up a built-in Descriptor by ID. The optional `descriptors`

package/dist/providers/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EACL,qBAAqB,IAAI,wBAAwB,EACjD,gCAAgC,IAAI,gBAAgB,GACrD,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAkC;IAC1E,mBAAmB,EAAE;IACrB,uBAAuB,EAAE;IACzB,sBAAsB,EAAE;IACxB,mBAAmB,EAAE;IACrB,qBAAqB,EAAE;IACvB,yBAAyB,EAAE;IAC3B,wBAAwB,EAAE;IAC1B,0BAA0B,EAAE;IAC5B,oBAAoB,EAAE;CACvB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,EAAc,EACd,WAAW,GAAkC,6BAA6B;IAE1E,OAAO,wBAAwB,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,GAAsB,EACtB,WAAW,GAAkC,6BAA6B;IAE1E,OAAO,gBAAgB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EACL,qBAAqB,IAAI,wBAAwB,EACjD,gCAAgC,IAAI,gBAAgB,GACrD,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAkC;IAC1E,mBAAmB,EAAE;IACrB,uBAAuB,EAAE;IACzB,sBAAsB,EAAE;IACxB,mBAAmB,EAAE;IACrB,qBAAqB,EAAE;IACvB,yBAAyB,EAAE;IAC3B,wBAAwB,EAAE;IAC1B,0BAA0B,EAAE;IAC5B,oBAAoB,EAAE;IACtB,mBAAmB,EAAE;IACrB,sBAAsB,EAAE;IACxB,sBAAsB,EAAE;CACzB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,EAAc,EACd,WAAW,GAAkC,6BAA6B;IAE1E,OAAO,wBAAwB,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,GAAsB,EACtB,WAAW,GAAkC,6BAA6B;IAE1E,OAAO,gBAAgB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC"}

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

@@ -0,0 +1,130 @@
+import type { SearchRequest, SearchSource } from "../../capabilities/search.js";
+import type { ReaderFetchRequest, ReaderFetchResult, LegacyReaderCacheCandidate } from "../../capabilities/reader.js";
+import type { CrawlRequest, CrawlResult } from "../../capabilities/crawl.js";
+import type { MapRequest, MapResult } from "../../capabilities/map.js";
+import type { DiagnosticsCapability } from "../../capabilities/diagnostics.js";
+import type { ProviderCapability, ProviderContext } from "../types.js";
+import { type SpiderTransportDeps } from "./client.js";
+import { type SpiderQuotaCapability } from "./quota.js";
+/**
+ * Local cache-identity type: identical to the shared
+ * `SearchCacheIdentity` except `provider` is the `"spider"` literal.
+ * Assignable to the shared contract once `"spider"` joins `PROVIDER_IDS`.
+ */
+interface SpiderSearchCacheIdentity {
+    readonly provider: "spider";
+    readonly capability: "search";
+    readonly credentialFingerprint: string;
+    readonly request: Readonly<SearchRequest>;
+}
+/** Local Search contract — see the module header. */
+interface SpiderSearchCapability {
+    validate(request: SearchRequest): void;
+    cacheIdentity(request: SearchRequest): SpiderSearchCacheIdentity;
+    invoke(request: SearchRequest): Promise<readonly SearchSource[]>;
+}
+/**
+ * Local cache-identity type: identical to the shared
+ * `ReaderCacheIdentity` except `provider` is the `"spider"` literal.
+ * Assignable to the shared contract once `"spider"` joins `PROVIDER_IDS`.
+ */
+interface SpiderReaderCacheIdentity {
+    readonly provider: "spider";
+    readonly capability: "reader";
+    readonly operation: "reader-fetch";
+    readonly credentialFingerprint: string;
+    readonly request: Readonly<ReaderFetchRequest>;
+    readonly legacyCandidates: readonly LegacyReaderCacheCandidate<ReaderFetchResult>[];
+}
+/** Local Reader operation contract — see the module header. */
+interface SpiderReaderOperation {
+    readonly kind: "reader-fetch";
+    validate(request: ReaderFetchRequest): void;
+    cacheIdentity(request: ReaderFetchRequest): SpiderReaderCacheIdentity;
+    decodeCached(value: unknown): ReaderFetchResult | null;
+    invoke(request: ReaderFetchRequest, signal?: AbortSignal): Promise<ReaderFetchResult>;
+}
+/** Local Reader contract — see the module header. */
+interface SpiderReaderCapability {
+    readonly fetch: SpiderReaderOperation;
+}
+/**
+ * Local cache-identity type: identical to the shared `CacheIdentity`
+ * for crawl except `provider` is the `"spider"` literal. Assignable to
+ * the shared contract once `"spider"` joins `PROVIDER_IDS`.
+ */
+interface SpiderCrawlCacheIdentity {
+    readonly provider: "spider";
+    readonly capability: "crawl";
+    readonly credentialFingerprint: string;
+    readonly request: Readonly<CrawlRequest>;
+}
+/** Local Crawl operation contract — see the module header. */
+interface SpiderCrawlOperation {
+    readonly kind: "crawl-fetch";
+    validate(request: CrawlRequest): void;
+    cacheIdentity(request: CrawlRequest): SpiderCrawlCacheIdentity;
+    decodeCached(value: unknown): CrawlResult | null;
+    invoke(request: CrawlRequest): Promise<CrawlResult>;
+}
+/** Local Crawl contract — see the module header. */
+interface SpiderCrawlCapability {
+    readonly fetch: SpiderCrawlOperation;
+}
+/**
+ * Local cache-identity type: identical to the shared `CacheIdentity`
+ * for map except `provider` is the `"spider"` literal. Assignable to
+ * the shared contract once `"spider"` joins `PROVIDER_IDS`.
+ */
+interface SpiderMapCacheIdentity {
+    readonly provider: "spider";
+    readonly capability: "map";
+    readonly credentialFingerprint: string;
+    readonly request: Readonly<MapRequest>;
+}
+/** Local Map operation contract — see the module header. */
+interface SpiderMapOperation {
+    readonly kind: "map-fetch";
+    validate(request: MapRequest): void;
+    cacheIdentity(request: MapRequest): SpiderMapCacheIdentity;
+    decodeCached(value: unknown): MapResult | null;
+    invoke(request: MapRequest): Promise<MapResult>;
+}
+/** Local Map contract — see the module header. */
+interface SpiderMapCapability {
+    readonly fetch: SpiderMapOperation;
+}
+/**
+ * Dependencies the Spider Adapter accepts. The unified `transport` seam
+ * carries `fetch` and timer injection.
+ */
+export interface SpiderAdapterDependencies {
+    readonly transport?: SpiderTransportDeps;
+}
+/** Local Adapter contract — see the module header. */
+interface SpiderAdapter {
+    readonly id: "spider";
+    readonly search: SpiderSearchCapability;
+    readonly reader: SpiderReaderCapability;
+    readonly crawl: SpiderCrawlCapability;
+    readonly map: SpiderMapCapability;
+    readonly quota: SpiderQuotaCapability;
+    readonly diagnostics: DiagnosticsCapability;
+}
+/** Local Descriptor contract — see the module header. */
+interface SpiderDescriptor {
+    readonly id: "spider";
+    isConfigured(env: NodeJS.ProcessEnv): boolean;
+    capabilities(): ReadonlySet<ProviderCapability>;
+    create(context: ProviderContext): SpiderAdapter;
+    readonly credentialEnvVars: readonly string[];
+}
+/**
+ * Build the Spider.cloud Provider Descriptor. Advertises the full
+ * Spider.cloud capability set (Search, Reader, Crawl, Map, Quota,
+ * Diagnostics). `create()` is side-effect-free; the transport is
+ * invoked per Capability call.
+ */
+export declare function createSpiderDescriptor(dependencies?: SpiderAdapterDependencies): SpiderDescriptor;
+export {};
+//# sourceMappingURL=adapter.d.ts.map

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

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