scoutline 0.1.0 → 0.6.0

package/dist/lib/execution.js

@@ -0,0 +1,383 @@
+/**
+ * Shared Execution Contract (DESIGN.md §10).
+ *
+ * Owns cache lookup, legacy read-through, retry policy, and local count
+ * truncation for every Provider Capability. Capability Modules define
+ * shared meaning; Adapters perform a single transport attempt; this
+ * module is the single retry and cache-policy owner.
+ *
+ * Boundary rules (ARCHITECTURE.md §2):
+ *   - May import capability types, Provider identity types, cache, and
+ *     normalized errors.
+ *   - Must NOT import a concrete Provider Adapter, UTCP, or `mmx-cli`.
+ *   - Must NOT import command presentation or output mode modules.
+ *
+ * Order of operations for `executeSearch`:
+ *   1. `capability.validate(request)`
+ *   2. `capability.cacheIdentity(request, { legacyCount: options.count })`
+ *   3. Read the provider-partitioned cache key
+ *   4. Try and decode Adapter-supplied legacy candidates when applicable
+ *   5. Invoke through `executeProviderOperation`
+ *   6. Retry only normalized retryable failures
+ *   7. Cache the full normalized result
+ *   8. Apply local count truncation
+ */
+import { ScoutlineError } from "./errors.js";
+import { buildProviderCacheKey } from "./cache.js";
+const DEFAULT_BASE_DELAY_MS = 500;
+const DEFAULT_MAX_DELAY_MS = 8000;
+const DEFAULT_JITTER_MS = 250;
+/**
+ * Default retry policy per operation. Search, quota, diagnostics, the
+ * three repository operations, and the reader operation allow one
+ * retry; Vision allows two to preserve shipped Z.AI behaviour. Base
+ * delay 500 ms, max delay 8000 ms, jitter up to 250 ms.
+ *
+ * The repository and reader operations inherit the existing single-
+ * retry non-Vision policy (DESIGN.md §18) without altering the
+ * behaviour of Search/Vision/Quota/Diagnostics; the new values are
+ * routed through the same default branch as Search/Quota/Diagnostics.
+ */
+export function defaultRetryPolicy(operation) {
+    const base = {
+        baseDelayMs: DEFAULT_BASE_DELAY_MS,
+        maxDelayMs: DEFAULT_MAX_DELAY_MS,
+        jitterMs: DEFAULT_JITTER_MS,
+    };
+    switch (operation) {
+        case "vision":
+            return { ...base, maxRetries: 2 };
+        case "search":
+        case "quota":
+        case "diagnostics":
+        case "repository-search":
+        case "repository-read-file":
+        case "repository-list-directory":
+        case "reader-fetch":
+        default:
+            return { ...base, maxRetries: 1 };
+    }
+}
+/**
+ * Classify whether a normalized error is retryable for a Provider
+ * operation. Authentication, validation, unsupported, content-policy,
+ * and exhausted-quota failures are terminal. Normalized timeout,
+ * network, HTTP 429, and any 5xx (statusCode 500..599, inclusive)
+ * equivalents are retryable.
+ *
+ * The 5xx range is matched as a closed interval so Provider-encoded
+ * statuses that the upstream gateway passes through verbatim (501,
+ * 505, 599, etc.) retry exactly once, matching Design §18 and
+ * FR-090. Other 4xx codes remain terminal.
+ *
+ * An explicit `retryable: true` on a `ScoutlineError` wins; an explicit
+ * `retryable: false` overrides a code-based default. Non-Scoutline
+ * errors never retry — Adapters must normalize failures before they
+ * leave the Adapter boundary.
+ */
+function isOperationRetryableError(error) {
+    if (!(error instanceof ScoutlineError))
+        return false;
+    // Explicit retryable flag wins over code-based defaults.
+    if (error.retryable)
+        return true;
+    switch (error.code) {
+        case "TIMEOUT_ERROR":
+        case "NETWORK_ERROR":
+            return true;
+        case "API_ERROR": {
+            // Design §18 / FR-090: 429 and any 5xx (500..599 inclusive) retry
+            // once. The interval is closed so encoded Provider statuses that
+            // pass through verbatim (501, 505, 599, ...) match the contract.
+            const status = error.statusCode;
+            return status !== undefined && (status === 429 || (status >= 500 && status <= 599));
+        }
+        default:
+            return false;
+    }
+}
+/**
+ * Generic uncached retry wrapper. Performs no I/O of its own; the
+ * caller supplies the invoke thunk and the cache strategy. Each
+ * outward Provider operation has exactly one retry wrapper; Adapter
+ * transport methods perform one attempt and never retry internally.
+ */
+export async function executeProviderOperation(operation, invoke, dependencies, retryPolicy) {
+    const policy = retryPolicy ?? defaultRetryPolicy(operation);
+    let attempt = 0;
+    for (;;) {
+        try {
+            return await invoke();
+        }
+        catch (error) {
+            if (attempt >= policy.maxRetries)
+                throw error;
+            if (!isOperationRetryableError(error))
+                throw error;
+            const backoff = Math.min(policy.maxDelayMs, policy.baseDelayMs * Math.pow(2, attempt));
+            const jitter = Math.floor(dependencies.random() * policy.jitterMs);
+            await dependencies.sleep(backoff + jitter);
+            attempt += 1;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Search execution
+// ---------------------------------------------------------------------------
+/**
+ * Apply command-level count truncation to a normalized result. Count
+ * is meaning local to the command Module: zero returns an empty list,
+ * a positive count slices, and an absent count returns everything.
+ */
+function applyCount(result, count) {
+    if (count === undefined)
+        return result;
+    if (count <= 0)
+        return [];
+    return result.slice(0, count);
+}
+/**
+ * Execute a normalized Search through the shared pipeline:
+ * validate → cache identity → new-key read → optional legacy
+ * read-through → invoke with retry → cache the full result → apply
+ * count truncation.
+ *
+ * Count never enters the cache identity request or the Provider
+ * request; it is supplied only as `legacyCount` so the Z.AI Adapter
+ * can reconstruct old keys.
+ */
+export async function executeSearch(capability, request, options, dependencies) {
+    // 1. Validate Capability request.
+    capability.validate(request);
+    // 2. Adapter-owned cache identity (after validation).
+    const identity = capability.cacheIdentity(request, {
+        legacyCount: options.count,
+    });
+    // 3. Read the provider-partitioned cache key.
+    const newKey = buildProviderCacheKey({
+        provider: identity.provider,
+        capability: identity.capability,
+        credentialFingerprint: identity.credentialFingerprint,
+        request: identity.request,
+    });
+    if (!options.noCache) {
+        const cached = await dependencies.cache.get(newKey);
+        if (cached !== null) {
+            return applyCount(cached, options.count);
+        }
+        // 4. Adapter-owned legacy candidates (Z.AI only). Invalid raw data
+        //    is a miss; a valid hit populates the new key but the legacy
+        //    file is never changed or deleted.
+        if (identity.legacyCandidates) {
+            for (const candidate of identity.legacyCandidates) {
+                const raw = await dependencies.cache.get(candidate.key);
+                if (raw === null)
+                    continue;
+                const decoded = candidate.decode(raw);
+                if (decoded !== null) {
+                    await dependencies.cache.set(newKey, decoded);
+                    return applyCount(decoded, options.count);
+                }
+            }
+        }
+    }
+    // 5 + 6. Invoke through executeProviderOperation; retryable failures
+    //        are retried with backoff driven by the injected sleep+random.
+    const result = await executeProviderOperation("search", () => capability.invoke(request), dependencies, options.retryPolicy);
+    // 7. Cache the full normalized result before count is applied.
+    if (!options.noCache) {
+        await dependencies.cache.set(newKey, result);
+    }
+    // 8. Local count truncation.
+    return applyCount(result, options.count);
+}
+/**
+ * Generic cache + retry executor for every cacheable Repository
+ * Capability operation (Search, Read File, Directory Listing).
+ *
+ * The observable order is fixed and exhaustively enumerated in
+ * DESIGN.md §18:
+ *
+ *   1. `operation.validate(request)` — throws `ValidationError`
+ *      synchronously before any cache or Adapter work.
+ *   2. `operation.cacheIdentity(request)` — Adapter computes the
+ *      provider-partitioned cache key and ordered legacy candidates
+ *      from the validated request and a single resolved credential.
+ *   3. Read the provider-partitioned cache key and pass the raw value
+ *      through `operation.decodeCached`. A valid decode returns
+ *      immediately; `null` is a miss; malformed values never propagate
+ *      through a generic cast.
+ *   4. For each legacy candidate, in declaration order, read the
+ *      legacy key and pass it through the candidate's `decode`. A
+ *      valid legacy hit is written through to the normalized key
+ *      (the legacy file is never changed or deleted) and returned.
+ *      A malformed legacy value is a miss.
+ *   5. `operation.invoke(request)` is wrapped through
+ *      `executeProviderOperation` with the existing single-retry
+ *      non-Vision policy. Each retry creates a fresh Adapter
+ *      transport attempt; cache hits create no transport.
+ *   6. The normalized result is written to the provider-partitioned
+ *      cache key.
+ *
+ * `--no-cache` skips steps 3, 4, and 6. It never skips validation
+ * (1), identity (2), invoke (5), or retry semantics.
+ *
+ * `executeRepositoryOperation` imports no Z.AI, MiniMax, MCP, UTCP,
+ * command-output, BFS, selection, or presentation module.
+ */
+export async function executeRepositoryOperation(operation, request, options, dependencies) {
+    // 1. Validate Capability request.
+    operation.validate(request);
+    // 2. Adapter-owned cache identity (after validation). The Adapter
+    //    resolves its credential exactly once and returns legacy
+    //    candidates alongside the full fingerprint and canonical
+    //    request. Candidate construction performs no ambient
+    //    environment read.
+    const identity = operation.cacheIdentity(request);
+    // 3. Provider-partitioned cache key.
+    //
+    // The key namespace is `<capability>-<operation>` rather than the
+    // umbrella Capability alone, so File and Directory operations —
+    // which share the `{ repository, path }` request shape — cannot
+    // collide. This composes the existing `buildProviderCacheKey` slot
+    // without mutating `buildProviderCacheKey` or its existing callers
+    // (Search, Vision, Quota, Diagnostics still pass a single Capability
+    // name). The canonical request object is unchanged; only the
+    // capability argument gains the operation suffix.
+    const newKey = buildProviderCacheKey({
+        provider: identity.provider,
+        capability: `${identity.capability}-${identity.operation}`,
+        credentialFingerprint: identity.credentialFingerprint,
+        request: identity.request,
+    });
+    if (!options.noCache) {
+        const raw = await dependencies.cache.get(newKey);
+        if (raw !== null) {
+            const decoded = operation.decodeCached(raw);
+            if (decoded !== null) {
+                return decoded;
+            }
+            // Malformed normalized value: treat as a miss and fall through.
+        }
+        // 4. Ordered legacy candidates. Each candidate's decode is
+        //    total — invalid raw data is a miss. A valid legacy hit
+        //    populates the new key but the legacy file is never
+        //    changed or deleted.
+        for (const candidate of identity.legacyCandidates) {
+            const legacyRaw = await dependencies.cache.get(candidate.key);
+            if (legacyRaw === null)
+                continue;
+            const decoded = candidate.decode(legacyRaw);
+            if (decoded !== null) {
+                await dependencies.cache.set(newKey, decoded);
+                return decoded;
+            }
+        }
+    }
+    // 5. Retry-wrapped invoke. Auth, Validation, Unsupported, and
+    //    exhausted Quota failures are terminal; transient timeout,
+    //    network, and 5xx/429-equivalent failures get one retry.
+    const result = await executeProviderOperation(
+    // `operation.kind` is `RepositoryOperationKind`, which is
+    // composed into `ProviderOperation` directly — no cast needed
+    // and a future kind union change propagates automatically.
+    operation.kind, () => operation.invoke(request), dependencies, options.retryPolicy);
+    // 6. Cache the full normalized result before returning.
+    if (!options.noCache) {
+        await dependencies.cache.set(newKey, result);
+    }
+    return result;
+}
+/**
+ * Generic cache + retry executor for the Reader Capability's
+ * `reader-fetch` operation. Structurally identical to
+ * {@link executeRepositoryOperation}; the two are duplicated rather
+ * than shared because factoring them would widen this ticket's
+ * scope (modifying repository.ts further). Future consolidation is
+ * a separate refactor.
+ *
+ * The observable order is fixed:
+ *
+ *   1. `operation.validate(request)` — throws `ValidationError`
+ *      synchronously before any cache or Adapter work.
+ *   2. `operation.cacheIdentity(request)` — Adapter computes the
+ *      provider-partitioned cache key and ordered legacy candidates
+ *      from the validated request and a single resolved credential.
+ *   3. Read the provider-partitioned cache key and pass the raw
+ *      value through `operation.decodeCached`. A valid decode
+ *      returns immediately; `null` is a miss; malformed values
+ *      never propagate through a generic cast.
+ *   4. For each legacy candidate, in declaration order, read the
+ *      legacy key and pass it through the candidate's `decode`. A
+ *      valid legacy hit is written through to the normalized key
+ *      (the legacy file is never changed or deleted) and returned.
+ *      A malformed legacy value is a miss.
+ *   5. `operation.invoke(request)` is wrapped through
+ *      `executeProviderOperation` with the single-retry non-Vision
+ *      policy. Each retry creates a fresh Adapter transport attempt;
+ *      cache hits create no transport.
+ *   6. The normalized result is written to the provider-partitioned
+ *      cache key.
+ *
+ * `--no-cache` skips steps 3, 4, and 6. It never skips validation
+ * (1), identity (2), invoke (5), or retry semantics.
+ *
+ * `executeReaderOperation` imports no Z.AI, MiniMax, MCP, UTCP,
+ * command-output, selection, or presentation module.
+ */
+export async function executeReaderOperation(operation, request, options, dependencies) {
+    // 1. Validate Capability request.
+    operation.validate(request);
+    // 2. Adapter-owned cache identity (after validation). The Adapter
+    //    resolves its credential exactly once and returns legacy
+    //    candidates alongside the full fingerprint and canonical
+    //    request. Candidate construction performs no ambient
+    //    environment read.
+    const identity = operation.cacheIdentity(request);
+    // 3. Provider-partitioned cache key.
+    //
+    // The key namespace is `${capability}-${operation}` rather than the
+    // umbrella Capability alone, mirroring the repository convention so
+    // future Reader operations cannot collide. The capability argument
+    // gains the operation suffix.
+    const newKey = buildProviderCacheKey({
+        provider: identity.provider,
+        capability: `${identity.capability}-${identity.operation}`,
+        credentialFingerprint: identity.credentialFingerprint,
+        request: identity.request,
+    });
+    if (!options.noCache) {
+        const raw = await dependencies.cache.get(newKey);
+        if (raw !== null) {
+            const decoded = operation.decodeCached(raw);
+            if (decoded !== null) {
+                return decoded;
+            }
+            // Malformed normalized value: treat as a miss and fall through.
+        }
+        // 4. Ordered legacy candidates. Each candidate's decode is
+        //    total — invalid raw data is a miss. A valid legacy hit
+        //    populates the new key but the legacy file is never
+        //    changed or deleted.
+        for (const candidate of identity.legacyCandidates) {
+            const legacyRaw = await dependencies.cache.get(candidate.key);
+            if (legacyRaw === null)
+                continue;
+            const decoded = candidate.decode(legacyRaw);
+            if (decoded !== null) {
+                await dependencies.cache.set(newKey, decoded);
+                return decoded;
+            }
+        }
+    }
+    // 5. Retry-wrapped invoke. Auth, Validation, Unsupported, and
+    //    exhausted Quota failures are terminal; transient timeout,
+    //    network, and 5xx/429-equivalent failures get one retry.
+    const result = await executeProviderOperation(operation.kind, () => operation.invoke(request), dependencies, options.retryPolicy);
+    // 6. Cache the full normalized result before returning.
+    if (!options.noCache) {
+        await dependencies.cache.set(newKey, result);
+    }
+    return result;
+}
+//# sourceMappingURL=execution.js.map

package/dist/lib/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../src/lib/execution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAWH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAsB,MAAM,YAAY,CAAC;AA+CvE,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAClC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAA4B;IAC7D,MAAM,IAAI,GAAG;QACX,WAAW,EAAE,qBAAqB;QAClC,UAAU,EAAE,oBAAoB;QAChC,QAAQ,EAAE,iBAAiB;KAC5B,CAAC;IACF,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QACpC,KAAK,QAAQ,CAAC;QACd,KAAK,OAAO,CAAC;QACb,KAAK,aAAa,CAAC;QACnB,KAAK,mBAAmB,CAAC;QACzB,KAAK,sBAAsB,CAAC;QAC5B,KAAK,2BAA2B,CAAC;QACjC,KAAK,cAAc,CAAC;QACpB;YACE,OAAO,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IACtC,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAS,yBAAyB,CAAC,KAAc;IAC/C,IAAI,CAAC,CAAC,KAAK,YAAY,cAAc,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,yDAAyD;IACzD,IAAI,KAAK,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IACjC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,eAAe,CAAC;QACrB,KAAK,eAAe;YAClB,OAAO,IAAI,CAAC;QACd,KAAK,WAAW,EAAE,CAAC;YACjB,kEAAkE;YAClE,iEAAiE;YACjE,iEAAiE;YACjE,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC;YAChC,OAAO,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC;QACtF,CAAC;QACD;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,SAA4B,EAC5B,MAAwB,EACxB,YAA6D,EAC7D,WAAyB;IAEzB,MAAM,MAAM,GAAG,WAAW,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,SAAS,CAAC;QACR,IAAI,CAAC;YACH,OAAO,MAAM,MAAM,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,IAAI,MAAM,CAAC,UAAU;gBAAE,MAAM,KAAK,CAAC;YAC9C,IAAI,CAAC,yBAAyB,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;YACnD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;YACvF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;YACnE,MAAM,YAAY,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;YAC3C,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;GAIG;AACH,SAAS,UAAU,CACjB,MAA+B,EAC/B,KAAyB;IAEzB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACvC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAA4B,EAC5B,OAAsB,EACtB,OAAyE,EACzE,YAAmC;IAEnC,kCAAkC;IAClC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE7B,sDAAsD;IACtD,MAAM,QAAQ,GAAG,UAAU,CAAC,aAAa,CAAC,OAAO,EAAE;QACjD,WAAW,EAAE,OAAO,CAAC,KAAK;KAC3B,CAAC,CAAC;IAEH,8CAA8C;IAC9C,MAAM,MAAM,GAAG,qBAAqB,CAAC;QACnC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,qBAAqB,EAAE,QAAQ,CAAC,qBAAqB;QACrD,OAAO,EAAE,QAAQ,CAAC,OAAO;KAC1B,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,GAAG,CAA0B,MAAM,CAAC,CAAC;QAC7E,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC;QAED,mEAAmE;QACnE,iEAAiE;QACjE,uCAAuC;QACvC,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;YAC9B,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;gBAClD,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,GAAG,CAAU,SAAS,CAAC,GAAG,CAAC,CAAC;gBACjE,IAAI,GAAG,KAAK,IAAI;oBAAE,SAAS;gBAC3B,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACtC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;oBACrB,MAAM,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;oBAC9C,OAAO,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,uEAAuE;IACvE,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAC3C,QAAQ,EACR,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,EAChC,YAAY,EACZ,OAAO,CAAC,WAAW,CACpB,CAAC;IAEF,+DAA+D;IAC/D,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,6BAA6B;IAC7B,OAAO,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,SAA+C,EAC/C,OAAgB,EAChB,OAAiC,EACjC,YAAmC;IAEnC,kCAAkC;IAClC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE5B,kEAAkE;IAClE,6DAA6D;IAC7D,6DAA6D;IAC7D,yDAAyD;IACzD,uBAAuB;IACvB,MAAM,QAAQ,GAAG,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAElD,qCAAqC;IACrC,EAAE;IACF,kEAAkE;IAClE,gEAAgE;IAChE,gEAAgE;IAChE,mEAAmE;IACnE,mEAAmE;IACnE,qEAAqE;IACrE,6DAA6D;IAC7D,kDAAkD;IAClD,MAAM,MAAM,GAAG,qBAAqB,CAAC;QACnC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,UAAU,EAAE,GAAG,QAAQ,CAAC,UAAU,IAAI,QAAQ,CAAC,SAAS,EAAE;QAC1D,qBAAqB,EAAE,QAAQ,CAAC,qBAAqB;QACrD,OAAO,EAAE,QAAQ,CAAC,OAAO;KAC1B,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,GAAG,CAAU,MAAM,CAAC,CAAC;QAC1D,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YAC5C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,gEAAgE;QAClE,CAAC;QAED,2DAA2D;QAC3D,4DAA4D;QAC5D,wDAAwD;QACxD,yBAAyB;QACzB,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;YAClD,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,GAAG,CAAU,SAAS,CAAC,GAAG,CAAC,CAAC;YACvE,IAAI,SAAS,KAAK,IAAI;gBAAE,SAAS;YACjC,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC5C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,MAAM,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAC9C,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,+DAA+D;IAC/D,6DAA6D;IAC7D,MAAM,MAAM,GAAG,MAAM,wBAAwB;IAC3C,0DAA0D;IAC1D,8DAA8D;IAC9D,2DAA2D;IAC3D,SAAS,CAAC,IAAI,EACd,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,EAC/B,YAAY,EACZ,OAAO,CAAC,WAAW,CACpB,CAAC;IAEF,wDAAwD;IACxD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAmBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,SAAiE,EACjE,OAA2B,EAC3B,OAA6B,EAC7B,YAAmC;IAEnC,kCAAkC;IAClC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE5B,kEAAkE;IAClE,6DAA6D;IAC7D,6DAA6D;IAC7D,yDAAyD;IACzD,uBAAuB;IACvB,MAAM,QAAQ,GACZ,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAEnC,qCAAqC;IACrC,EAAE;IACF,oEAAoE;IACpE,oEAAoE;IACpE,mEAAmE;IACnE,8BAA8B;IAC9B,MAAM,MAAM,GAAG,qBAAqB,CAAC;QACnC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,UAAU,EAAE,GAAG,QAAQ,CAAC,UAAU,IAAI,QAAQ,CAAC,SAAS,EAAE;QAC1D,qBAAqB,EAAE,QAAQ,CAAC,qBAAqB;QACrD,OAAO,EAAE,QAAQ,CAAC,OAAO;KAC1B,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,GAAG,CAAU,MAAM,CAAC,CAAC;QAC1D,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YAC5C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,gEAAgE;QAClE,CAAC;QAED,2DAA2D;QAC3D,4DAA4D;QAC5D,wDAAwD;QACxD,yBAAyB;QACzB,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;YAClD,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,GAAG,CAAU,SAAS,CAAC,GAAG,CAAC,CAAC;YACvE,IAAI,SAAS,KAAK,IAAI;gBAAE,SAAS;YACjC,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC5C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,MAAM,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAC9C,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,+DAA+D;IAC/D,6DAA6D;IAC7D,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAC3C,SAAS,CAAC,IAAI,EACd,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,EAC/B,YAAY,EACZ,OAAO,CAAC,WAAW,CACpB,CAAC;IAEF,wDAAwD;IACxD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/lib/index.d.ts

@@ -1,8 +1,16 @@
 /**
- * Library exports for programmatic usage
+ * Library exports for programmatic usage.
+ *
+ * `formatErrorOutput` lives in `./output.js` (DESIGN.md §3, canonical
+ * invocation-local 2-arg form). `./errors.js` keeps a legacy 1-arg
+ * compat version that Phase 1 command handlers import directly until
+ * P1-10 migrates them. To avoid a duplicate-export error in this
+ * aggregator, the errors-module re-export below is explicit and omits
+ * `formatErrorOutput`; the canonical 2-arg version from `./output.js`
+ * wins through `export *` below.
  */
 export * from "./config.js";
-export * from "./errors.js";
+export { type ScoutlineErrorCode, type ScoutlineErrorOptions, ScoutlineError, ZaiError, ValidationError, ConfigurationError, UnsupportedCapabilityError, UnsupportedOptionError, AuthError, ApiError, NetworkError, TimeoutError, FileError, QuotaError, isRetryableError, getErrorExitCode, } from "./errors.js";
 export * from "./output.js";
 export * from "./image.js";
 export * from "./api-client.js";

package/dist/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,cAAc,EACd,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/dist/lib/index.js

@@ -1,8 +1,16 @@
 /**
- * Library exports for programmatic usage
+ * Library exports for programmatic usage.
+ *
+ * `formatErrorOutput` lives in `./output.js` (DESIGN.md §3, canonical
+ * invocation-local 2-arg form). `./errors.js` keeps a legacy 1-arg
+ * compat version that Phase 1 command handlers import directly until
+ * P1-10 migrates them. To avoid a duplicate-export error in this
+ * aggregator, the errors-module re-export below is explicit and omits
+ * `formatErrorOutput`; the canonical 2-arg version from `./output.js`
+ * wins through `export *` below.
  */
 export * from "./config.js";
-export * from "./errors.js";
+export { ScoutlineError, ZaiError, ValidationError, ConfigurationError, UnsupportedCapabilityError, UnsupportedOptionError, AuthError, ApiError, NetworkError, TimeoutError, FileError, QuotaError, isRetryableError, getErrorExitCode, } from "./errors.js";
 export * from "./output.js";
 export * from "./image.js";
 export * from "./api-client.js";

package/dist/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,aAAa,CAAC;AAC5B,OAAO,EAGL,cAAc,EACd,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/dist/lib/mcp-client.d.ts

@@ -7,8 +7,9 @@
  * - Web Search: Real-time web search
  * - Web Reader: Web page content extraction
  */
-import { type Tool } from "@utcp/sdk";
+import { UtcpClient, type Tool } from "@utcp/sdk";
 import "@utcp/mcp";
+import type { ReaderRawResponse } from "../capabilities/reader.js";
 export interface ZReadSearchResult {
     title: string;
     content: string;
@@ -24,6 +25,23 @@ export interface WebSearchResult {
     icon: string;
     publish_date?: string;
 }
+/**
+ * Constructor options for {@link ZaiMcpClient}.
+ *
+ * `utcpFactory` is a behaviour-preserving injection seam: when omitted the
+ * production path uses `UtcpClient.create()`. Tests inject a fake to avoid
+ * touching process globals.
+ *
+ * `disableRetry` (P2-03) lets the Z.AI Search Adapter hand retry policy
+ * to shared execution. When omitted, the client retains its existing
+ * direct-client retry behaviour.
+ */
+export interface ZaiMcpClientOptions {
+    enableVision?: boolean;
+    noCache?: boolean;
+    disableRetry?: boolean;
+    utcpFactory?: () => Promise<UtcpClient>;
+}
 /**
  * Unified MCP client for all Z.AI MCP services
  */
@@ -32,10 +50,7 @@ export declare class ZaiMcpClient {
     private initPromise;
     private isInitialized;
     private options;
-    constructor(options?: {
-        enableVision?: boolean;
-        noCache?: boolean;
-    });
+    constructor(options?: ZaiMcpClientOptions);
     /**
      * Initialize the UTCP client and register all MCP servers
      */
@@ -49,18 +64,49 @@ export declare class ZaiMcpClient {
     private getRetryCount;
     private isRetriableError;
     private resolveEnableVision;
-    private getToolCacheKey;
-    private getToolCachePath;
-    private readToolsCache;
-    private writeToolsCache;
     /**
-     * List all discovered tools from registered MCP servers
+     * Build the tool-cache config (D4 — adapter encapsulates the
+     * config + endpoints + vision-resolution inputs that the extracted
+     * `tool-cache.ts` needs to compute a stable key). Owned here because
+     * the inputs come from this class's options and the shared config
+     * module; the extracted module stays pure of `loadConfig` / `getMcpEndpoints`.
+     */
+    private getToolCacheConfig;
+    /**
+     * List all discovered tools from registered MCP servers.
+     *
+     * Returns the PUBLIC projected view: internal UTCP names (e.g.
+     * `scoutline_zai.search.web_search_prime`) are rewritten to the
+     * stable dotted form (e.g. `scoutline.zai.search.web_search_prime`).
+     * The private unprojected discovery list is retained for invocation
+     * through {@link getTool} / {@link resolveToolName}.
      */
     listTools(refresh?: boolean): Promise<Tool[]>;
     /**
-     * Find a tool by exact name or by suffix match
+     * Private unprojected discovery list. Tools keep their exact UTCP
+     * names so {@link getTool} can resolve public aliases back to the
+     * internal invocation identity.
+     *
+     * Tool-cache I/O is delegated to the extracted {@link tool-cache.ts}
+     * module (D1 — owns its I/O directly against the `tools/` subdir).
+     */
+    private discoverTools;
+    /**
+     * Find a tool by exact internal name, public dotted name, or leaf
+     * suffix. Resolution order:
+     *   1. Exact discovered name (e.g. `scoutline_zai.search.web_search_prime`).
+     *   2. Public dotted name (e.g. `scoutline.zai.search.web_search_prime`):
+     *      derive the provider-relative suffix after the public prefix and
+     *      match exactly one discovered name ending in `.<suffix>`. Zero or
+     *      multiple matches fail.
+     *   3. Legacy short-suffix fallback: a single discovered name ending in
+     *      `.<name>` (e.g. for callers that pass only `web_search_prime`).
+     *
+     * Public names never replace the private discovered-name record — the
+     * returned {@link Tool} always carries its internal UTCP name.
      */
     getTool(toolName: string): Promise<Tool | undefined>;
+    private findToolByResolvedName;
     /**
      * Resolve a tool name, accepting full names or suffixes
      */
@@ -69,6 +115,22 @@ export declare class ZaiMcpClient {
      * Call a tool by full name or suffix
      */
     callToolRaw<T>(toolName: string, args: Record<string, unknown>): Promise<T>;
+    /**
+     * P6-01A: invoke a tool while preserving the public dotted tool name as
+     * the cache identity, then resolve to the internal sanitized identity
+     * only on a cache miss.
+     *
+     * The legacy v0.2 repository cache contract (P0–P2) keyed entries under
+     * the public dotted name and returned them before any transport work.
+     * A naive `callToolRaw` migration routes through `resolveToolName` first,
+     * which forces discovery, registration, and `init()` even when a v0.2
+     * hit is present. This helper restores the legacy cache identity and
+     * skips discovery on hits while keeping the translation fix for misses.
+     *
+     * Other callers (`callTool`, `callToolRaw`, Vision, Search, Reader, raw
+     * tools) are unchanged.
+     */
+    private callToolWithPublicCacheIdentity;
     /**
      * Search documentation and code in a GitHub repository
      */
@@ -105,7 +167,7 @@ export declare class ZaiMcpClient {
         noGfm?: boolean;
         keepImgDataUrl?: boolean;
         withImagesSummary?: boolean;
-    }): Promise<string>;
+    }): Promise<ReaderRawResponse>;
     visionAnalyze(params: {
         imageSource: string;
         prompt: string;
@@ -150,10 +212,7 @@ export declare class ZaiMcpClient {
     close(timeoutMs?: number): Promise<void>;
 }
 export declare class ZReadMcpClient extends ZaiMcpClient {
-    constructor(options?: {
-        enableVision?: boolean;
-        noCache?: boolean;
-    });
+    constructor(options?: ZaiMcpClientOptions);
     searchDoc(repo: string, query: string, language?: "zh" | "en"): Promise<string>;
     getRepoStructure(repo: string, dirPath?: string): Promise<string>;
     readFile(repo: string, path: string): Promise<string>;

package/dist/lib/mcp-client.d.ts.map

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