harness-dispatch 0.4.0 → 0.5.0

package/dist/circuit-breaker.js

@@ -7,11 +7,37 @@
  */
 export const CIRCUIT_BREAKER_THRESHOLD = 5;
 export const CIRCUIT_BREAKER_DEFAULT_COOLDOWN_SEC = 300;
+/**
+ * Hard ceiling on any cooldown, in seconds (24h).
+ *
+ * Belt-and-braces alongside the clamp in rate-limit-headers.ts. That one
+ * guards the parser; this one guards the class, because `retryAfter` reaches
+ * trip()/recordFailure() from dispatcher code paths generally, not only from
+ * that parser — and because a cooldown is now written to disk and rehydrated
+ * by later processes, so a bad value stops being a per-process nuisance and
+ * becomes a permanent one.
+ */
+export const MAX_COOLDOWN_SEC = 24 * 60 * 60;
+/**
+ * Gap after which the consecutive-failure count restarts (30 min).
+ *
+ * Without this the counter only ever reset on success, so five failures
+ * separated by days tripped the breaker as readily as five in a burst — the
+ * opposite of what a breaker is for.
+ */
+export const FAILURE_DECAY_SEC = 30 * 60;
+function boundedCooldown(retryAfterSec) {
+    if (retryAfterSec === undefined || !Number.isFinite(retryAfterSec) || retryAfterSec <= 0) {
+        return CIRCUIT_BREAKER_DEFAULT_COOLDOWN_SEC;
+    }
+    return Math.min(retryAfterSec, MAX_COOLDOWN_SEC);
+}
 function monotonicSec() {
     return performance.now() / 1000;
 }
 export class CircuitBreaker {
     failures = 0;
+    lastFailureAt = null;
     trippedAt = null;
     cooldown = CIRCUIT_BREAKER_DEFAULT_COOLDOWN_SEC;
     get isTripped() {
@@ -25,13 +51,19 @@ export class CircuitBreaker {
         return true;
     }
     recordFailure(retryAfterSec) {
+        // Decay first: five failures spread across a week are not the same signal
+        // as five in a row, but the counter never reset except on success, so a
+        // route that fails rarely eventually tripped anyway. Any gap longer than
+        // the decay window starts the count over.
+        const now = monotonicSec();
+        if (this.lastFailureAt !== null && now - this.lastFailureAt > FAILURE_DECAY_SEC) {
+            this.failures = 0;
+        }
+        this.lastFailureAt = now;
         this.failures += 1;
         if (this.failures >= CIRCUIT_BREAKER_THRESHOLD) {
             this.trippedAt = monotonicSec();
-            this.cooldown =
-                retryAfterSec && retryAfterSec > 0
-                    ? retryAfterSec
-                    : CIRCUIT_BREAKER_DEFAULT_COOLDOWN_SEC;
+            this.cooldown = boundedCooldown(retryAfterSec);
         }
     }
     recordSuccess() {
@@ -40,10 +72,7 @@ export class CircuitBreaker {
     /** Immediately trip — use on 429 or explicit rate-limit response. */
     trip(retryAfterSec) {
         this.trippedAt = monotonicSec();
-        this.cooldown =
-            retryAfterSec && retryAfterSec > 0
-                ? retryAfterSec
-                : CIRCUIT_BREAKER_DEFAULT_COOLDOWN_SEC;
+        this.cooldown = boundedCooldown(retryAfterSec);
     }
     cooldownRemaining() {
         if (!this.isTripped || this.trippedAt === null) {
@@ -69,10 +98,27 @@ export class CircuitBreaker {
      * a restart) can compare against its own Date.now().
      */
     snapshot() {
+        // Order matters: the isTripped getter auto-resets on expiry, which also
+        // clears lastFailureAt — evaluate it first so the snapshot reflects the
+        // post-expiry state.
         if (!this.isTripped) {
-            return { failures: this.failures, blockedUntilMs: null };
+            return {
+                failures: this.failures,
+                blockedUntilMs: null,
+                lastFailureAtMs: this.lastFailureWallMs(),
+            };
         }
-        return { failures: this.failures, blockedUntilMs: Date.now() + this.cooldownRemaining() * 1000 };
+        return {
+            failures: this.failures,
+            blockedUntilMs: Date.now() + this.cooldownRemaining() * 1000,
+            lastFailureAtMs: this.lastFailureWallMs(),
+        };
+    }
+    /** The monotonic lastFailureAt as a wall-clock epoch, for persistence. */
+    lastFailureWallMs() {
+        if (this.lastFailureAt === null)
+            return null;
+        return Date.now() - (monotonicSec() - this.lastFailureAt) * 1000;
     }
     /**
      * Hydrate from a snapshot persisted by a previous process. A
@@ -81,6 +127,13 @@ export class CircuitBreaker {
      */
     restore(snapshot) {
         this.failures = snapshot.failures;
+        // Rehydrate the failure clock so FAILURE_DECAY_SEC keeps working across
+        // processes (a failure age in the future, from clock skew, clamps to 0
+        // rather than extending the decay window).
+        this.lastFailureAt =
+            typeof snapshot.lastFailureAtMs === "number"
+                ? monotonicSec() - Math.max(0, (Date.now() - snapshot.lastFailureAtMs) / 1000)
+                : null;
         if (snapshot.blockedUntilMs === null) {
             this.trippedAt = null;
             return;
@@ -90,11 +143,15 @@ export class CircuitBreaker {
             this.trippedAt = null;
             return;
         }
-        this.cooldown = remainingSec;
+        // Clamped on the way back in too: state written by an older build (or a
+        // hand-edited file) can carry a deadline centuries out, and hydrating it
+        // verbatim would make the ceiling above trivially bypassable.
+        this.cooldown = Math.min(remainingSec, MAX_COOLDOWN_SEC);
         this.trippedAt = monotonicSec();
     }
     reset() {
         this.failures = 0;
+        this.lastFailureAt = null;
         this.trippedAt = null;
         this.cooldown = CIRCUIT_BREAKER_DEFAULT_COOLDOWN_SEC;
     }

package/dist/circuit-breaker.js.map

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

package/dist/config/coercions.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Value coercion and enum narrowing for config parsing.
+ *
+ * Split out of config.ts, which reached 1738 lines with three parallel route
+ * builders — the shape that produced four separate silent-drop defects. These
+ * are the leaves of that parser: pure functions over `unknown`, no config
+ * state, no I/O, trivially testable in isolation.
+ *
+ * The convention throughout is DROP ON MISMATCH — every `*From` returns
+ * undefined rather than guessing, and the caller decides the fallback. That is
+ * deliberate, and it is also exactly why a typo could silently select a
+ * default. config.ts warns separately about unrecognised keys to cover it;
+ * the two belong together.
+ */
+import type { AuthSource, BillingConfidence, BillingKind, BillingProvider, BillingSurface, EndpointMode, EndpointProvider, ThinkingLevel, WireProtocol, WorkspacePolicy } from "../types.js";
+export declare function num(v: unknown, def: number): number;
+export declare function int(v: unknown, def: number): number;
+export declare function bool(v: unknown, def: boolean): boolean;
+export declare function str(v: unknown): string | undefined;
+export declare function thinkingFrom(v: unknown): ThinkingLevel | undefined;
+export declare function providerFrom(v: unknown): BillingProvider | undefined;
+export declare function surfaceFrom(v: unknown): BillingSurface | undefined;
+export declare function authSourceFrom(v: unknown): AuthSource | undefined;
+export declare function billingKindFrom(v: unknown): BillingKind | undefined;
+export declare function confidenceFrom(v: unknown): BillingConfidence | undefined;
+export declare function endpointModeFrom(v: unknown): EndpointMode | undefined;
+export declare function endpointProviderFrom(v: unknown): EndpointProvider | undefined;
+export declare function wireProtocolFrom(v: unknown): WireProtocol | undefined;
+export declare function workspacePolicyFrom(v: unknown): WorkspacePolicy | undefined;
+export declare function inferEndpointProvider(baseUrl: string | undefined): EndpointProvider;
+//# sourceMappingURL=coercions.d.ts.map

package/dist/config/coercions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coercions.d.ts","sourceRoot":"","sources":["../../src/config/coercions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,eAAe,EAChB,MAAM,aAAa,CAAC;AAErB,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAOnD;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAOtD;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIlD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAGlE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAYpE;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAmBlE;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAYjE;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAcnE;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAKxE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CASrE;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAY7E;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAWrE;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAK3E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAmBnF"}

package/dist/config/coercions.js

@@ -0,0 +1,169 @@
+/**
+ * Value coercion and enum narrowing for config parsing.
+ *
+ * Split out of config.ts, which reached 1738 lines with three parallel route
+ * builders — the shape that produced four separate silent-drop defects. These
+ * are the leaves of that parser: pure functions over `unknown`, no config
+ * state, no I/O, trivially testable in isolation.
+ *
+ * The convention throughout is DROP ON MISMATCH — every `*From` returns
+ * undefined rather than guessing, and the caller decides the fallback. That is
+ * deliberate, and it is also exactly why a typo could silently select a
+ * default. config.ts warns separately about unrecognised keys to cover it;
+ * the two belong together.
+ */
+export function num(v, def) {
+    if (typeof v === "number")
+        return v;
+    if (typeof v === "string" && v !== "") {
+        const n = Number(v);
+        if (!Number.isNaN(n))
+            return n;
+    }
+    return def;
+}
+export function int(v, def) {
+    return Math.trunc(num(v, def));
+}
+export function bool(v, def) {
+    if (typeof v === "boolean")
+        return v;
+    if (typeof v === "string") {
+        if (v === "true")
+            return true;
+        if (v === "false")
+            return false;
+    }
+    return def;
+}
+export function str(v) {
+    if (typeof v !== "string")
+        return undefined;
+    if (v === "")
+        return undefined;
+    return v;
+}
+export function thinkingFrom(v) {
+    if (v === "low" || v === "medium" || v === "high")
+        return v;
+    return undefined;
+}
+export function providerFrom(v) {
+    if (v === "anthropic" ||
+        v === "openai" ||
+        v === "cursor" ||
+        v === "google" ||
+        v === "local" ||
+        v === "custom") {
+        return v;
+    }
+    return undefined;
+}
+export function surfaceFrom(v) {
+    if (v === "claude_code" ||
+        v === "claude_agent_sdk" ||
+        v === "anthropic_api" ||
+        v === "codex_cli" ||
+        v === "codex_sdk" ||
+        v === "openai_api" ||
+        v === "cursor_agent_cli" ||
+        v === "antigravity_cli" ||
+        v === "gemini_api" ||
+        v === "vertex_ai" ||
+        v === "openai_compatible" ||
+        v === "local_endpoint" ||
+        v === "custom") {
+        return v;
+    }
+    return undefined;
+}
+export function authSourceFrom(v) {
+    if (v === "product_login" ||
+        v === "api_key" ||
+        v === "oauth_session" ||
+        v === "local_network" ||
+        v === "configured_endpoint" ||
+        v === "unknown") {
+        return v;
+    }
+    return undefined;
+}
+export function billingKindFrom(v) {
+    if (v === "local_compute" ||
+        v === "included_plan_usage" ||
+        v === "included_plan_then_flexible_credits" ||
+        v === "included_credit_then_optional_overage" ||
+        v === "included_usage_then_on_demand" ||
+        v === "metered_api" ||
+        v === "free_quota" ||
+        v === "unknown") {
+        return v;
+    }
+    return undefined;
+}
+export function confidenceFrom(v) {
+    if (v === "documented" || v === "inferred" || v === "unknown" || v === "unsupported") {
+        return v;
+    }
+    return undefined;
+}
+export function endpointModeFrom(v) {
+    if (v === "provider_cloud" ||
+        v === "direct_openai_compatible" ||
+        v === "harness_native_endpoint") {
+        return v;
+    }
+    return undefined;
+}
+export function endpointProviderFrom(v) {
+    if (v === "ollama" ||
+        v === "lmstudio" ||
+        v === "openai_compatible" ||
+        v === "anthropic_gateway" ||
+        v === "gemini_proxy" ||
+        v === "custom") {
+        return v;
+    }
+    return undefined;
+}
+export function wireProtocolFrom(v) {
+    if (v === "openai_chat_completions" ||
+        v === "anthropic_messages" ||
+        v === "gemini_generate_content" ||
+        v === "provider_native" ||
+        v === "unknown") {
+        return v;
+    }
+    return undefined;
+}
+export function workspacePolicyFrom(v) {
+    if (v === "shared" || v === "shared_locked" || v === "git_worktree" || v === "copy") {
+        return v;
+    }
+    return undefined;
+}
+export function inferEndpointProvider(baseUrl) {
+    if (!baseUrl)
+        return "custom";
+    try {
+        const url = new URL(baseUrl);
+        const host = url.hostname.toLowerCase();
+        const port = url.port;
+        if ((host === "localhost" || host === "127.0.0.1" || host === "::1") && port === "11434") {
+            return "ollama";
+        }
+        if ((host === "localhost" || host === "127.0.0.1" || host === "::1") && port === "1234") {
+            return "lmstudio";
+        }
+    }
+    catch {
+        // Fall through to substring checks for partial or nonstandard URLs.
+    }
+    const lower = baseUrl.toLowerCase();
+    if (lower.includes("ollama"))
+        return "ollama";
+    if (lower.includes("lmstudio") || lower.includes("lm-studio"))
+        return "lmstudio";
+    return "custom";
+}
+//# sourceMappingURL=coercions.js.map

package/dist/config/coercions.js.map

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

package/dist/config/env-interpolation.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `${VAR}` interpolation over a loaded config tree.
+ *
+ * Split out of config.ts. Small, but it carries two invariants worth keeping
+ * together and away from the parsing code:
+ *
+ * 1. It records every substitution it makes (`refs`), mapping the RESOLVED
+ *    value back to the reference that produced it. That map is what lets
+ *    `configure` write `${GROQ_API_KEY}` back out instead of the live secret
+ *    it resolved to — without it, regenerating a config leaks credentials into
+ *    a file people paste into bug reports.
+ * 2. It records references whose variable is unset (`unsetVars`), because the
+ *    result is an empty string that otherwise looks exactly like "not
+ *    configured" — a route silently losing its api_key and reporting ready.
+ */
+export declare const ENV_VAR_RE: RegExp;
+/**
+ * `unsetVars` collects the names of ${VAR} references that resolved to
+ * nothing because the env var isn't set at all — distinct from a var
+ * deliberately set to "". Without this, a typo'd or forgotten env var
+ * (${ANTHROPIC_API_KEY} when the real name is ${ANTHROPIC_KEY}) silently
+ * becomes an empty string: `str()` then drops the field entirely, a route
+ * that needed an api_key loses it with zero feedback, and doctor reports
+ * the route "ready" right up until the first real call 401s.
+ *
+ * Replacement applies ANYWHERE in the string, matching what the shipped
+ * config's comment has promised all along ("anywhere in a string value").
+ * The implementation was anchored to whole-string matches, so
+ * `base_url: https://${HOST}/v1` stayed a literal, got no unset-var warning
+ * (unsetVars only tracked whole-string matches), and failed downstream with
+ * an error about a URL containing a dollar sign.
+ */
+export declare function interpolateEnv(value: string, unsetVars: Set<string>, refs: Map<string, string>): string;
+/** Walk an object tree and replace any "${VAR}" string leaves with env values. */
+export declare function interpolateTree<T>(node: T, unsetVars: Set<string>, refs: Map<string, string>): T;
+//# sourceMappingURL=env-interpolation.d.ts.map

package/dist/config/env-interpolation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-interpolation.d.ts","sourceRoot":"","sources":["../../src/config/env-interpolation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,UAAU,QAAqC,CAAC;AAK7D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACxB,MAAM,CAgBR;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAehG"}

package/dist/config/env-interpolation.js

@@ -0,0 +1,73 @@
+/**
+ * `${VAR}` interpolation over a loaded config tree.
+ *
+ * Split out of config.ts. Small, but it carries two invariants worth keeping
+ * together and away from the parsing code:
+ *
+ * 1. It records every substitution it makes (`refs`), mapping the RESOLVED
+ *    value back to the reference that produced it. That map is what lets
+ *    `configure` write `${GROQ_API_KEY}` back out instead of the live secret
+ *    it resolved to — without it, regenerating a config leaks credentials into
+ *    a file people paste into bug reports.
+ * 2. It records references whose variable is unset (`unsetVars`), because the
+ *    result is an empty string that otherwise looks exactly like "not
+ *    configured" — a route silently losing its api_key and reporting ready.
+ */
+export const ENV_VAR_RE = /^\$\{([A-Za-z_][A-Za-z0-9_]*)\}$/;
+/** Every ${VAR} occurrence, not only a whole-string match. */
+const ENV_VAR_ANYWHERE_RE = /\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g;
+/**
+ * `unsetVars` collects the names of ${VAR} references that resolved to
+ * nothing because the env var isn't set at all — distinct from a var
+ * deliberately set to "". Without this, a typo'd or forgotten env var
+ * (${ANTHROPIC_API_KEY} when the real name is ${ANTHROPIC_KEY}) silently
+ * becomes an empty string: `str()` then drops the field entirely, a route
+ * that needed an api_key loses it with zero feedback, and doctor reports
+ * the route "ready" right up until the first real call 401s.
+ *
+ * Replacement applies ANYWHERE in the string, matching what the shipped
+ * config's comment has promised all along ("anywhere in a string value").
+ * The implementation was anchored to whole-string matches, so
+ * `base_url: https://${HOST}/v1` stayed a literal, got no unset-var warning
+ * (unsetVars only tracked whole-string matches), and failed downstream with
+ * an error about a URL containing a dollar sign.
+ */
+export function interpolateEnv(value, unsetVars, refs) {
+    if (!value.includes("${"))
+        return value;
+    const resolved = value.replace(ENV_VAR_ANYWHERE_RE, (_match, name) => {
+        if (!(name in process.env))
+            unsetVars.add(name);
+        return process.env[name] ?? "";
+    });
+    if (resolved === value)
+        return value; // nothing legal to substitute
+    // Remember which reference produced this value so `configure` can emit the
+    // ${VAR} template back instead of the secret it resolved to. Keyed by
+    // resolved value rather than by config path because interpolation runs over
+    // the raw tree before any of it is shaped into routes. Two variables holding
+    // the same secret collide, but harmlessly: either reference resolves to that
+    // same value, so emitting either is correct. Empty resolutions are skipped —
+    // they carry no secret and would collide with every other unset var.
+    if (resolved !== "")
+        refs.set(resolved, value);
+    return resolved;
+}
+/** Walk an object tree and replace any "${VAR}" string leaves with env values. */
+export function interpolateTree(node, unsetVars, refs) {
+    if (typeof node === "string") {
+        return interpolateEnv(node, unsetVars, refs);
+    }
+    if (Array.isArray(node)) {
+        return node.map((v) => interpolateTree(v, unsetVars, refs));
+    }
+    if (node !== null && typeof node === "object") {
+        const out = {};
+        for (const [k, v] of Object.entries(node)) {
+            out[k] = interpolateTree(v, unsetVars, refs);
+        }
+        return out;
+    }
+    return node;
+}
+//# sourceMappingURL=env-interpolation.js.map

package/dist/config/env-interpolation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-interpolation.js","sourceRoot":"","sources":["../../src/config/env-interpolation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,kCAAkC,CAAC;AAE7D,8DAA8D;AAC9D,MAAM,mBAAmB,GAAG,iCAAiC,CAAC;AAE9D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,SAAsB,EACtB,IAAyB;IAEzB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE;QAC3E,IAAI,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,8BAA8B;IACpE,2EAA2E;IAC3E,sEAAsE;IACtE,4EAA4E;IAC5E,6EAA6E;IAC7E,6EAA6E;IAC7E,6EAA6E;IAC7E,qEAAqE;IACrE,IAAI,QAAQ,KAAK,EAAE;QAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,eAAe,CAAI,IAAO,EAAE,SAAsB,EAAE,IAAyB;IAC3F,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAiB,CAAC;IAC/D,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,CAAiB,CAAC;IAC9E,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,GAAmB,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/config/protocol.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Parsing for a route's `protocol:` block — how a CLI harness is actually
+ * invoked and how its output is read.
+ *
+ * Split out of config.ts. This is the largest single concern in that file and
+ * the most self-contained: it turns YAML into a CliProtocolConfig and knows
+ * nothing about routes, billing, or defaults merging.
+ *
+ * It is also the reason `harness: generic` works at all — every CLI harness,
+ * built-in or user-added, is driven by this structure rather than by
+ * TypeScript. That is why a malformed protocol block skips the whole entry
+ * with a warning instead of landing a route that would fail at dispatch time.
+ */
+import type { CliEventRule, CliProtocolConfig } from "../types.js";
+/**
+ * Named protocols a route may reference by string or `extends:`.
+ *
+ * INJECTED rather than imported. config.ts builds presets by calling
+ * this very function (via the shipped-harness loader), so importing it here
+ * would be an initialisation cycle — protocol.ts would need a value that does
+ * not exist until protocol.ts has finished running. Passing it in keeps the
+ * dependency pointing one way.
+ */
+export type ProtocolPresets = Readonly<Record<string, CliProtocolConfig>>;
+/** The full set of `{{name}}` tokens expandToken() in generic-cli.ts understands. */
+export declare const KNOWN_ARG_PLACEHOLDERS: ReadonlySet<string>;
+export declare function stringArrayFrom(raw: unknown): string[] | undefined;
+/**
+ * Parse `protocol:` for any route (see CliProtocolConfig in types.ts).
+ * Three shapes:
+ *  - A string ("cursor", "codex", ...) — looked up in presets by
+ *    name. Lets a config select a known protocol without retyping it, and
+ *    is the extension point for "others add further protocols" — a new
+ *    named entry in the shipped config.default.yaml is immediately selectable here,
+ *    no code changes.
+ *  - An object with `extends: <preset name>` — starts from that preset and
+ *    overrides only the fields present, for the common "95% the same, one
+ *    flag different" case. safety merges per-profile (overriding just
+ *    full_auto doesn't erase read_only/workspace_edit from the preset).
+ *  - A plain object — the full protocol, no preset involved (unchanged
+ *    behavior from before presets existed).
+ *
+ * Returns undefined — with a warning — for anything malformed, so a broken
+ * block degrades to "route unusable" (isAvailable() checks for a missing
+ * protocol) rather than a half-built dispatcher silently doing the wrong
+ * thing.
+ */
+export declare function protocolFrom(raw: unknown, routeLabel: string, warnings: string[], presets: ProtocolPresets): CliProtocolConfig | undefined;
+export declare function parseProtocolFields(r: Record<string, unknown>, routeLabel: string, warnings: string[], base: CliProtocolConfig | undefined): CliProtocolConfig | undefined;
+export declare function eventRuleFrom(raw: unknown, label: string, warnings: string[]): CliEventRule | undefined;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/config/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/config/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EAGlB,MAAM,aAAa,CAAC;AAKrB;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAE1E,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAOrD,CAAC;AAEH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAIlE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAAE,EAKlB,OAAO,EAAE,eAAe,GACvB,iBAAiB,GAAG,SAAS,CA2B/B;AAED,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAAE,EAClB,IAAI,EAAE,iBAAiB,GAAG,SAAS,GAClC,iBAAiB,GAAG,SAAS,CAmK/B;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,GAAG,SAAS,CA+CvG"}