scoutline 0.6.4 → 0.9.0

package/README.md

@@ -21,7 +21,7 @@
 - **Repo** - Search and read GitHub repository code via ZRead
 - **Tools** - MCP tool discovery, schemas, and raw calls
 - **Code Mode** - TypeScript tool chaining for agent automation
-- **Provider selection** - Run shared capabilities through Z.AI or MiniMax Token Plan
+- **Provider selection** - Run shared capabilities through Z.AI, MiniMax Token Plan, Tavily, or Brave
 
 ## Quick Start
 
@@ -42,6 +42,14 @@ export MINIMAX_API_KEY="your-minimax-key"
 npx scoutline --provider minimax search "latest LLM benchmarks"
 ```
 
+To use Brave (Search: web, news, video):
+
+```bash
+export BRAVE_SEARCH_API_KEY="your-brave-key"
+npx scoutline --provider brave search "AI policy news" --topic news
+npx scoutline --provider brave search "rust async" --type video
+```
+
 ## Installation
 
 ### As an Agent Skill
@@ -74,9 +82,9 @@ npx scoutline --help
 ## Provider Selection
 
 Shared commands (`search`, `vision`, `quota`, `doctor`, `repo`) accept a global
-`--provider <zai|minimax>` flag. Resolution precedence:
+`--provider <zai|minimax|tavily|brave>` flag. Resolution precedence:
 
-1. Explicit `--provider <zai|minimax>` on the command line
+1. Explicit `--provider <zai|minimax|tavily|brave>` on the command line
 2. `SCOUTLINE_PROVIDER` environment variable
 3. Compatibility default `zai`
 
@@ -398,11 +406,10 @@ Cache hits construct and close no transport.
 
 ### Diagnostics inventory
 
-`sharedCapabilities` and `zaiOnlyCapabilities` are derived from descriptor
-metadata (intersection across built-in Providers; Z.AI minus the union of
-the others). `repository-exploration` is therefore `zaiOnlyCapabilities`
-while still participating in Provider selection. Doctor help names MiniMax
-as unsupported for `repo`.
+`capabilityMatrix` is derived from descriptor metadata: for each advertised
+capability, the providers that supply it (in descriptor order).
+`repository-exploration` therefore lists only `zai` while still participating
+in Provider selection. Doctor help names MiniMax as unsupported for `repo`.
 
 ### Non-goals
 
@@ -502,10 +509,10 @@ result. Cache hits construct and close no transport.
 
 ### Diagnostics inventory
 
-`sharedCapabilities` and `zaiOnlyCapabilities` are derived from descriptor
-metadata. `reader` is therefore `zaiOnlyCapabilities` while still
-participating in Provider selection, and Doctor help names MiniMax as
-unsupported for `read`.
+`capabilityMatrix` is derived from descriptor metadata: for each advertised
+capability, the providers that supply it. `reader` therefore lists only
+`zai` while still participating in Provider selection, and Doctor help names
+MiniMax as unsupported for `read`.
 
 ### Non-goals
 

package/bin/scoutline.js

@@ -10,12 +10,11 @@ import("../dist/index.js")
       env: process.env,
     });
     adapter.setExitCode(status);
+    process.exit(status);
   })
   .catch(async (err) => {
     try {
-      const { formatLoadFailure } = await import(
-        "../dist/node-command-invocation-adapter.js"
-      );
+      const { formatLoadFailure } = await import("../dist/node-command-invocation-adapter.js");
       console.error(formatLoadFailure(err));
     } catch {
       // If the dist module is unavailable for any reason, fall back to a

package/dist/capabilities/crawl.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Provider-neutral Crawl Capability Contract (tech-plan §2a).
+ *
+ * Declares the single Crawl operation (`crawl-fetch`), its
+ * provider-neutral request, identity, cache, and result shapes, and a
+ * total normalized cache decoder.
+ *
+ * It imports NO concrete Provider, transport, or Adapter. It does no URL
+ * validation, raw response parsing, Provider field mapping, Provider
+ * selection, retries, or presentation.
+ */
+import type { CachedOperation } from "../lib/execution.js";
+/**
+ * The single Crawl Capability operation. Cache identity partitions by
+ * the composite `${capability}-${operation}` literal; the v2 partitioned
+ * key shape is
+ * `v2.crawl-crawl-fetch.<provider>.<credential-hash>.<request-hash>.json`.
+ *
+ * `--max-chars` is a handler-level projection and does NOT participate in
+ * the cache identity.
+ */
+export type CrawlOperationKind = "crawl-fetch";
+/**
+ * Provider-neutral crawl request. `url` MUST be supplied explicitly (the
+ * handler rejects non-`http(s)` values at parse time before this request
+ * reaches the Adapter).
+ *
+ * Every field except `url` participates in the v2 partitioned cache
+ * identity. `--max-chars` and `--no-cache` NEVER appear here — they are
+ * projections applied after the cached normalized result.
+ */
+export interface CrawlRequest {
+    readonly url: string;
+    /** Crawl depth, 1-5. Default 1 (single page). */
+    readonly depth?: number;
+    /** Max links to follow per page, 1-500. Default 20. */
+    readonly breadth?: number;
+    /** Total number of links to process, default 50. */
+    readonly limit?: number;
+    /** Regex patterns to select only matching URL paths. */
+    readonly selectPaths?: string;
+    /** Regex patterns to exclude matching URL paths. */
+    readonly excludePaths?: string;
+    /** Natural language instructions guiding which pages to crawl. */
+    readonly instructions?: string;
+    /** Output format: markdown (default) or text. */
+    readonly format?: "markdown" | "text";
+    /** Extraction depth: medium (basic, default) or high (advanced). */
+    readonly contentSize?: "medium" | "high";
+    /** Request timeout in seconds, default 150. */
+    readonly timeout?: number;
+}
+/**
+ * A single crawled page. `truncated` and `originalContentLength` are NOT
+ * part of this contract — they are handler-level projections applied by
+ * `commands/crawl.ts` after the cached normalized result is produced.
+ * The cache stores the full content; truncation state is recomputed on
+ * every read.
+ */
+export interface CrawlPage {
+    readonly url: string;
+    readonly content: string;
+    readonly contentFormat: "markdown" | "text";
+}
+/**
+ * Normalized crawl result. `schemaVersion: 1` is the breaking shape.
+ */
+export interface CrawlResult {
+    readonly schemaVersion: 1;
+    readonly baseUrl: string;
+    readonly pages: readonly CrawlPage[];
+    readonly totalPages: number;
+}
+/**
+ * Generic Crawl operation descriptor. The Adapter supplies one of these
+ * for the `crawl-fetch` operation it supports.
+ */
+export interface CrawlOperation extends CachedOperation<CrawlRequest, CrawlResult> {
+    readonly kind: CrawlOperationKind;
+}
+/**
+ * Crawl Capability contract. Every Adapter that supports crawl
+ * implements this interface and exposes it as `adapter.crawl`.
+ */
+export interface CrawlCapability {
+    readonly fetch: CrawlOperation;
+}
+/**
+ * Decode a CrawlResult from the cache. Returns the canonical
+ * `CrawlResult` on success, `null` for any malformed value.
+ */
+export declare function decodeCrawlResult(value: unknown): CrawlResult | null;
+//# sourceMappingURL=crawl.d.ts.map

package/dist/capabilities/crawl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawl.d.ts","sourceRoot":"","sources":["../../src/capabilities/crawl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAM1E;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAM/C;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IACtC,oEAAoE;IACpE,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACzC,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,UAAU,GAAG,MAAM,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAMD;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe,CAAC,YAAY,EAAE,WAAW,CAAC;IAChF,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC;AAkBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CA6BpE"}

package/dist/capabilities/crawl.js

@@ -0,0 +1,62 @@
+/**
+ * Provider-neutral Crawl Capability Contract (tech-plan §2a).
+ *
+ * Declares the single Crawl operation (`crawl-fetch`), its
+ * provider-neutral request, identity, cache, and result shapes, and a
+ * total normalized cache decoder.
+ *
+ * It imports NO concrete Provider, transport, or Adapter. It does no URL
+ * validation, raw response parsing, Provider field mapping, Provider
+ * selection, retries, or presentation.
+ */
+// ===========================================================================
+// Total normalized cache decoder
+// ===========================================================================
+//
+// Accepts `unknown`, returns the typed result or `null`, never throws, and
+// never trusts a generic cast. Shape contract is local; the Adapter is
+// responsible for producing values that conform to `CrawlResult`.
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+/**
+ * Decode a CrawlResult from the cache. Returns the canonical
+ * `CrawlResult` on success, `null` for any malformed value.
+ */
+export function decodeCrawlResult(value) {
+    if (!isPlainObject(value))
+        return null;
+    if (value.schemaVersion !== 1)
+        return null;
+    if (!isNonEmptyString(value.baseUrl))
+        return null;
+    const pages = value.pages;
+    if (!Array.isArray(pages))
+        return null;
+    const decodedPages = [];
+    for (const page of pages) {
+        if (!isPlainObject(page))
+            return null;
+        if (!isNonEmptyString(page.url))
+            return null;
+        if (!isNonEmptyString(page.content))
+            return null;
+        const contentFormat = page.contentFormat;
+        if (contentFormat !== "markdown" && contentFormat !== "text")
+            return null;
+        decodedPages.push({ url: page.url, content: page.content, contentFormat });
+    }
+    const totalPages = value.totalPages;
+    if (typeof totalPages !== "number" || !Number.isFinite(totalPages))
+        return null;
+    return {
+        schemaVersion: 1,
+        baseUrl: value.baseUrl,
+        pages: decodedPages,
+        totalPages,
+    };
+}
+//# sourceMappingURL=crawl.js.map

package/dist/capabilities/crawl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawl.js","sourceRoot":"","sources":["../../src/capabilities/crawl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqGH,8EAA8E;AAC9E,iCAAiC;AACjC,8EAA8E;AAC9E,EAAE;AACF,2EAA2E;AAC3E,uEAAuE;AACvE,kEAAkE;AAElE,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAElD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,YAAY,GAAgB,EAAE,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACtC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7C,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QACjD,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACzC,IAAI,aAAa,KAAK,UAAU,IAAI,aAAa,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QAC1E,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACpC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAEhF,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,YAAY;QACnB,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/capabilities/diagnostics.d.ts

@@ -1,7 +1,7 @@
 /**
- * Diagnostics Capability Contract (DESIGN.md §14, P4-04, P6-06).
+ * Diagnostics Capability Contract (DESIGN.md §14, P4-04, P6-06, Doctor Schema v2).
  *
- * Defines the schema-version-1 diagnostics report every `doctor`
+ * Defines the schema-version-2 diagnostics report every `doctor`
  * invocation returns, plus the capability contract each Provider
  * Adapter implements so its connectivity can be probed without a
  * generative request.
@@ -22,17 +22,19 @@
  *     hand-maintained inventory required those imports; the
  *     descriptor-derived inventory does not.
  *
- * Inventory derivation (P6-06):
- *   - `sharedCapabilities` is the intersection across every descriptor
- *     passed to `buildDiagnosticsReport`, preserving deterministic
- *     canonical order from the FIRST descriptor.
- *   - `zaiOnlyCapabilities` is the Z.AI descriptor's capabilities
- *     minus the union of every OTHER built-in descriptor's
- *     capabilities, preserving Z.AI descriptor order. Values are
- *     descriptor capability IDs only — no hand-maintained aliases.
- *   - `repository-exploration` is excluded from shared while any
- *     built-in lacks it, and included in Z.AI-only the moment Z.AI
- *     advertises it and another built-in does not.
+ * Inventory derivation (Doctor Schema v2):
+ *   - `capabilityMatrix` is the per-capability provider list across
+ *     every descriptor passed to `buildDiagnosticsReport`. It replaced
+ *     the schema-version-1 `sharedCapabilities` (intersection) and
+ *     `zaiOnlyCapabilities` (Z.AI-minus-others) pair, which silently
+ *     hid any capability shared by 2-of-3 providers under three
+ *     built-ins. The matrix is strictly more informative: every
+ *     capability is visible with exactly the providers that supply it.
+ *   - Capability order: first descriptor's declared order, then
+ *     capabilities unique to subsequent descriptors in descriptor
+ *     order. Provider order within an entry: descriptor order.
+ *   - Values are descriptor capability IDs only — no hand-maintained
+ *     aliases.
  */
 import type { ProviderCapability, ProviderDescriptor, ProviderId } from "../providers/types.js";
 import { type ScoutlineErrorCode } from "../lib/errors.js";
@@ -51,11 +53,20 @@ export interface ProviderDiagnostic {
         help?: string;
     };
 }
+/**
+ * One row of the schema-version-2 capability matrix: a capability and
+ * the providers (in descriptor order) that advertise it. Replaces the
+ * schema-version-1 `sharedCapabilities`/`zaiOnlyCapabilities` pair,
+ * which could not represent a capability supplied by 2-of-3 providers.
+ */
+export interface CapabilityProviderEntry {
+    readonly capability: ProviderCapability;
+    readonly providers: readonly ProviderId[];
+}
 export interface DiagnosticsReport {
-    readonly schemaVersion: 1;
+    readonly schemaVersion: 2;
     readonly effectiveProvider: ProviderId;
-    readonly sharedCapabilities: readonly ProviderCapability[];
-    readonly zaiOnlyCapabilities: readonly string[];
+    readonly capabilityMatrix: readonly CapabilityProviderEntry[];
     readonly node: {
         readonly version: string;
         readonly visionMcpCompatible: boolean;
@@ -87,40 +98,31 @@ export interface DiagnosticsCapability {
     invoke(options: DiagnosticOptions): Promise<void>;
 }
 /**
- * Derive the shared Capabilities inventory: the intersection of every
- * descriptor's `capabilities()` set, preserving deterministic
- * canonical order from the FIRST descriptor in the list.
+ * Derive the schema-version-2 capability matrix: for each capability
+ * advertised by any descriptor, the list of providers (in descriptor
+ * order) that supply it.
  *
- * Edge cases:
- *   - Empty descriptor list: returns an empty array.
- *   - Single descriptor: returns that descriptor's capabilities in
- *     their declared order (the intersection of one set is itself).
- *   - Two or more: keeps a capability from the first descriptor iff
- *     every other descriptor also advertises it.
+ * Capability order:
+ *   - First, the FIRST descriptor's capabilities in their declared
+ *     order.
+ *   - Then, capabilities unique to each subsequent descriptor, in
+ *     descriptor order.
  *
- * The returned array is frozen so callers cannot mutate the cached
- * derivation in place.
- */
-export declare function deriveSharedCapabilities(descriptors: readonly ProviderDescriptor[]): readonly ProviderCapability[];
-/**
- * Derive the Z.AI-only Capabilities inventory: capabilities advertised
- * by the Z.AI descriptor minus the union of capabilities advertised by
- * every OTHER descriptor in the list. Preserves Z.AI descriptor order.
+ * Provider order within an entry: descriptor order (the order
+ * descriptors appear in the passed-in list).
  *
  * Edge cases:
  *   - Empty descriptor list: returns an empty array.
- *   - Z.AI absent from the list: returns an empty array.
- *   - Z.AI present as the only descriptor: returns its capabilities
- *     verbatim (the "minus nothing" case).
- *   - Z.AI with other descriptors: each capability in Z.AI descriptor
- *     order is kept iff no other descriptor advertises it.
+ *   - Single descriptor: one entry per capability, each listing only
+ *     that descriptor's id.
+ *   - Two or more: a capability supplied by multiple descriptors lists
+ *     every supplying descriptor's id — unlike the schema-version-1
+ *     intersection/minus pair, nothing is hidden.
  *
- * The returned values are descriptor capability IDs only. No
- * hand-maintained aliases, no parallel base-release list, no
- * invented names. `repository-exploration` lands here naturally the
- * moment Z.AI advertises it and another built-in does not.
+ * The returned array (and each entry's `providers`) is frozen so
+ * callers cannot mutate the cached derivation in place.
  */
-export declare function deriveZaiOnlyCapabilities(descriptors: readonly ProviderDescriptor[]): readonly ProviderCapability[];
+export declare function deriveCapabilityMatrix(descriptors: readonly ProviderDescriptor[]): readonly CapabilityProviderEntry[];
 /**
  * Map a thrown error into a normalized diagnostic error entry. The
  * caller is responsible for recursive redaction before the entry

package/dist/capabilities/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/capabilities/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAM3E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CAAC;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,kBAAkB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/E;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,UAAU,CAAC;IACvC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC3D,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;KACvC,CAAC;IACF,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAClD;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAYD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,SAAS,kBAAkB,EAAE,GACzC,SAAS,kBAAkB,EAAE,CAc/B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,SAAS,kBAAkB,EAAE,GACzC,SAAS,kBAAkB,EAAE,CAoB/B;AAMD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG;IACxD,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAYA"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/capabilities/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAM3E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CAAC;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,kBAAkB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/E;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,SAAS,UAAU,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,UAAU,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC9D,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;KACvC,CAAC;IACF,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAClD;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAYD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,SAAS,kBAAkB,EAAE,GACzC,SAAS,uBAAuB,EAAE,CAiCpC;AAMD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG;IACxD,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAYA"}

package/dist/capabilities/diagnostics.js

@@ -1,7 +1,7 @@
 /**
- * Diagnostics Capability Contract (DESIGN.md §14, P4-04, P6-06).
+ * Diagnostics Capability Contract (DESIGN.md §14, P4-04, P6-06, Doctor Schema v2).
  *
- * Defines the schema-version-1 diagnostics report every `doctor`
+ * Defines the schema-version-2 diagnostics report every `doctor`
  * invocation returns, plus the capability contract each Provider
  * Adapter implements so its connectivity can be probed without a
  * generative request.
@@ -22,17 +22,19 @@
  *     hand-maintained inventory required those imports; the
  *     descriptor-derived inventory does not.
  *
- * Inventory derivation (P6-06):
- *   - `sharedCapabilities` is the intersection across every descriptor
- *     passed to `buildDiagnosticsReport`, preserving deterministic
- *     canonical order from the FIRST descriptor.
- *   - `zaiOnlyCapabilities` is the Z.AI descriptor's capabilities
- *     minus the union of every OTHER built-in descriptor's
- *     capabilities, preserving Z.AI descriptor order. Values are
- *     descriptor capability IDs only — no hand-maintained aliases.
- *   - `repository-exploration` is excluded from shared while any
- *     built-in lacks it, and included in Z.AI-only the moment Z.AI
- *     advertises it and another built-in does not.
+ * Inventory derivation (Doctor Schema v2):
+ *   - `capabilityMatrix` is the per-capability provider list across
+ *     every descriptor passed to `buildDiagnosticsReport`. It replaced
+ *     the schema-version-1 `sharedCapabilities` (intersection) and
+ *     `zaiOnlyCapabilities` (Z.AI-minus-others) pair, which silently
+ *     hid any capability shared by 2-of-3 providers under three
+ *     built-ins. The matrix is strictly more informative: every
+ *     capability is visible with exactly the providers that supply it.
+ *   - Capability order: first descriptor's declared order, then
+ *     capabilities unique to subsequent descriptors in descriptor
+ *     order. Provider order within an entry: descriptor order.
+ *   - Values are descriptor capability IDs only — no hand-maintained
+ *     aliases.
  */
 import { ScoutlineError } from "../lib/errors.js";
 // ---------------------------------------------------------------------------
@@ -45,74 +47,59 @@ import { ScoutlineError } from "../lib/errors.js";
 // indexing accidents.
 // ---------------------------------------------------------------------------
 /**
- * Derive the shared Capabilities inventory: the intersection of every
- * descriptor's `capabilities()` set, preserving deterministic
- * canonical order from the FIRST descriptor in the list.
+ * Derive the schema-version-2 capability matrix: for each capability
+ * advertised by any descriptor, the list of providers (in descriptor
+ * order) that supply it.
  *
- * Edge cases:
- *   - Empty descriptor list: returns an empty array.
- *   - Single descriptor: returns that descriptor's capabilities in
- *     their declared order (the intersection of one set is itself).
- *   - Two or more: keeps a capability from the first descriptor iff
- *     every other descriptor also advertises it.
+ * Capability order:
+ *   - First, the FIRST descriptor's capabilities in their declared
+ *     order.
+ *   - Then, capabilities unique to each subsequent descriptor, in
+ *     descriptor order.
  *
- * The returned array is frozen so callers cannot mutate the cached
- * derivation in place.
- */
-export function deriveSharedCapabilities(descriptors) {
-    if (descriptors.length === 0)
-        return Object.freeze([]);
-    const [first, ...rest] = descriptors;
-    if (rest.length === 0) {
-        return Object.freeze([...first.capabilities()]);
-    }
-    const otherSets = rest.map((d) => d.capabilities());
-    const out = [];
-    for (const cap of first.capabilities()) {
-        if (otherSets.every((set) => set.has(cap))) {
-            out.push(cap);
-        }
-    }
-    return Object.freeze(out);
-}
-/**
- * Derive the Z.AI-only Capabilities inventory: capabilities advertised
- * by the Z.AI descriptor minus the union of capabilities advertised by
- * every OTHER descriptor in the list. Preserves Z.AI descriptor order.
+ * Provider order within an entry: descriptor order (the order
+ * descriptors appear in the passed-in list).
  *
  * Edge cases:
  *   - Empty descriptor list: returns an empty array.
- *   - Z.AI absent from the list: returns an empty array.
- *   - Z.AI present as the only descriptor: returns its capabilities
- *     verbatim (the "minus nothing" case).
- *   - Z.AI with other descriptors: each capability in Z.AI descriptor
- *     order is kept iff no other descriptor advertises it.
+ *   - Single descriptor: one entry per capability, each listing only
+ *     that descriptor's id.
+ *   - Two or more: a capability supplied by multiple descriptors lists
+ *     every supplying descriptor's id — unlike the schema-version-1
+ *     intersection/minus pair, nothing is hidden.
  *
- * The returned values are descriptor capability IDs only. No
- * hand-maintained aliases, no parallel base-release list, no
- * invented names. `repository-exploration` lands here naturally the
- * moment Z.AI advertises it and another built-in does not.
+ * The returned array (and each entry's `providers`) is frozen so
+ * callers cannot mutate the cached derivation in place.
  */
-export function deriveZaiOnlyCapabilities(descriptors) {
-    const zai = descriptors.find((d) => d.id === "zai");
-    if (!zai)
+export function deriveCapabilityMatrix(descriptors) {
+    if (descriptors.length === 0)
         return Object.freeze([]);
-    const others = descriptors.filter((d) => d.id !== "zai");
-    if (others.length === 0) {
-        return Object.freeze([...zai.capabilities()]);
-    }
-    const union = new Set();
-    for (const descriptor of others) {
-        for (const cap of descriptor.capabilities()) {
-            union.add(cap);
-        }
-    }
-    const out = [];
-    for (const cap of zai.capabilities()) {
-        if (!union.has(cap)) {
-            out.push(cap);
+    // Materialize each descriptor's capability set once (pure metadata).
+    const capabilitySets = descriptors.map((d) => d.capabilities());
+    // Establish deterministic capability order: first descriptor's
+    // declared order, then capabilities unique to subsequent descriptors
+    // in descriptor order.
+    const seen = new Set();
+    const ordered = [];
+    for (const set of capabilitySets) {
+        for (const cap of set) {
+            if (!seen.has(cap)) {
+                seen.add(cap);
+                ordered.push(cap);
+            }
         }
     }
+    // For each capability, list the providers that advertise it, in
+    // descriptor order.
+    const out = ordered.map((cap) => {
+        const providers = [];
+        capabilitySets.forEach((set, index) => {
+            if (set.has(cap)) {
+                providers.push(descriptors[index].id);
+            }
+        });
+        return { capability: cap, providers: Object.freeze(providers) };
+    });
     return Object.freeze(out);
 }
 // ---------------------------------------------------------------------------

package/dist/capabilities/diagnostics.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/capabilities/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAGH,OAAO,EAAE,cAAc,EAA2B,MAAM,kBAAkB,CAAC;AAsD3E,8EAA8E;AAC9E,wCAAwC;AACxC,EAAE;AACF,6DAA6D;AAC7D,qEAAqE;AACrE,iEAAiE;AACjE,gEAAgE;AAChE,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,wBAAwB,CACtC,WAA0C;IAE1C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,WAAW,CAAC;IACrC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;IACpD,MAAM,GAAG,GAAyB,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC;QACvC,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC3C,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,yBAAyB,CACvC,WAA0C;IAE1C,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;IACpD,IAAI,CAAC,GAAG;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;IACzD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC5C,KAAK,MAAM,UAAU,IAAI,MAAM,EAAE,CAAC;QAChC,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,YAAY,EAAE,EAAE,CAAC;YAC5C,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,MAAM,GAAG,GAAyB,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAc;IAKrD,MAAM,IAAI,GACR,KAAK,YAAY,cAAc,CAAC,CAAC,CAAE,KAAK,CAAC,IAA2B,CAAC,CAAC,CAAC,eAAe,CAAC;IACzF,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,MAAM,GAAiE;QAC3E,IAAI;QACJ,OAAO;KACR,CAAC;IACF,IAAI,KAAK,YAAY,cAAc,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAClD,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IAC3B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/capabilities/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAGH,OAAO,EAAE,cAAc,EAA2B,MAAM,kBAAkB,CAAC;AAgE3E,8EAA8E;AAC9E,wCAAwC;AACxC,EAAE;AACF,6DAA6D;AAC7D,qEAAqE;AACrE,iEAAiE;AACjE,gEAAgE;AAChE,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAA0C;IAE1C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAEvD,qEAAqE;IACrE,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;IAEhE,+DAA+D;IAC/D,qEAAqE;IACrE,uBAAuB;IACvB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC3C,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,oBAAoB;IACpB,MAAM,GAAG,GAA8B,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACzD,MAAM,SAAS,GAAiB,EAAE,CAAC;QACnC,cAAc,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YACpC,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjB,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAA0B,EAAE,CAAC;IAC3F,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAc;IAKrD,MAAM,IAAI,GACR,KAAK,YAAY,cAAc,CAAC,CAAC,CAAE,KAAK,CAAC,IAA2B,CAAC,CAAC,CAAC,eAAe,CAAC;IACzF,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,MAAM,GAAiE;QAC3E,IAAI;QACJ,OAAO;KACR,CAAC;IACF,IAAI,KAAK,YAAY,cAAc,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAClD,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IAC3B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/capabilities/map.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Provider-neutral Map Capability Contract (tech-plan §2b).
+ *
+ * Declares the single Map operation (`map-fetch`), its provider-neutral
+ * request, identity, cache, and result shapes, and a total normalized
+ * cache decoder.
+ *
+ * It imports NO concrete Provider, transport, or Adapter. It does no URL
+ * validation, raw response parsing, Provider field mapping, Provider
+ * selection, retries, or presentation.
+ *
+ * Map is the simplest of the three new Tavily capabilities: the API
+ * returns URLs only (no per-page content), so there is no per-page
+ * projection or truncation concern. The handler therefore needs no
+ * `--max-chars` flag.
+ */
+import type { CacheIdentity, CachedOperation } from "../lib/execution.js";
+/**
+ * The single Map Capability operation. Cache identity partitions by the
+ * composite `${capability}-${operation}` literal; the v2 partitioned key
+ * shape is
+ * `v2.map-map-fetch.<provider>.<credential-hash>.<request-hash>.json`.
+ */
+export type MapOperationKind = "map-fetch";
+/**
+ * Provider-neutral map request. `url` MUST be supplied explicitly (the
+ * handler rejects non-`http(s)` values at parse time before this request
+ * reaches the Adapter).
+ *
+ * Every field except `url` participates in the v2 partitioned cache
+ * identity. `--no-cache` and output mode never appear here — they are
+ * policy applied around the cached normalized result.
+ */
+export interface MapRequest {
+    readonly url: string;
+    /** Map depth, 1-5. Default 1 (single page). */
+    readonly depth?: number;
+    /** Max links to follow per page, 1-500. Default 20. */
+    readonly breadth?: number;
+    /** Total number of links to process, default 50. */
+    readonly limit?: number;
+    /** Regex patterns to select only matching URL paths. */
+    readonly selectPaths?: string;
+    /** Regex patterns to exclude matching URL paths. */
+    readonly excludePaths?: string;
+    /** Natural language instructions guiding which pages to map. */
+    readonly instructions?: string;
+}
+/**
+ * Normalized map result. `schemaVersion: 1` is the breaking shape.
+ * `urls` is the exact set of URLs the Provider returned (in Provider
+ * order); `totalUrls` is the array length. `baseUrl` is the request
+ * URL, recorded for symmetry with the Crawl result.
+ */
+export interface MapResult {
+    readonly schemaVersion: 1;
+    readonly baseUrl: string;
+    readonly urls: readonly string[];
+    readonly totalUrls: number;
+}
+/**
+ * Generic Map operation descriptor. The Adapter supplies one of these
+ * for the `map-fetch` operation it supports.
+ */
+export interface MapOperation extends CachedOperation<MapRequest, MapResult> {
+    readonly kind: MapOperationKind;
+}
+/**
+ * Map Capability contract. Every Adapter that supports map implements
+ * this interface and exposes it as `adapter.map`.
+ */
+export interface MapCapability {
+    readonly fetch: MapOperation;
+}
+/**
+ * Decode a MapResult from the cache. Returns the canonical `MapResult`
+ * on success, `null` for any malformed value.
+ */
+export declare function decodeMapResult(value: unknown): MapResult | null;
+export type MapCacheIdentity = CacheIdentity<MapRequest, MapResult>;
+//# sourceMappingURL=map.d.ts.map