instar 1.3.330 → 1.3.331

package/dist/core/AnthropicSubscriptionRouter.d.ts

@@ -0,0 +1,68 @@
+/**
+ * AnthropicSubscriptionRouter — per-call routing between the two ALLOWED
+ * Anthropic paths for internal intelligence calls:
+ *
+ *   - `claude -p` one-shots (anthropic-headless / ClaudeCliIntelligenceProvider)
+ *     — the Agent SDK credit path post-2026-06-15. Prepaid accelerator.
+ *   - the interactive REPL pool (InteractivePoolIntelligenceProvider)
+ *     — the Max-subscription floor. Always available (Rule 1).
+ *
+ * Modes (intelligence.subscriptionPath.mode):
+ *   - 'auto'  — drain the SDK pot while it's known-healthy, fall to the
+ *               subscription floor when the pot is unknown/at-margin
+ *               (decideSdkVsSubscription — same thresholds as the
+ *               registry-level CostAwareRoutingPolicy, single source of
+ *               truth). A failed primary gets ONE fallback attempt on the
+ *               other path, with an onDegrade report — Rule 1 resilience.
+ *   - 'force' — subscription pool ONLY. No SDK fallback: the whole point
+ *               of force mode (soak tests, June-15 emergency lever) is
+ *               proving/guaranteeing zero `claude -p` traffic. Failures
+ *               are LOUD throws.
+ *
+ * Mode 'off' never constructs this class — buildIntelligenceProvider
+ * returns the plain ClaudeCliIntelligenceProvider, byte-for-byte today's
+ * behavior.
+ *
+ * This router sits INSIDE the circuit-breaker wrap (breaker stays
+ * outermost), and BELOW the per-component IntelligenceRouter (framework
+ * routing decides claude-vs-codex first; this decides WHICH Claude path).
+ */
+import type { IntelligenceProvider, IntelligenceOptions } from './types.js';
+import type { AgentSdkCreditSnapshot } from '../providers/primitives/observability/usageMeterProvider.js';
+export type SubscriptionPathMode = 'auto' | 'force';
+export interface SubscriptionRouteInfo {
+    /** Which path served (or was chosen for) the call. */
+    path: 'sdk-credit' | 'subscription-pool';
+    /** Decision reason (threshold text, 'forced', or fallback note). */
+    reason: string;
+    /** Attribution component when the caller supplied one. */
+    component?: string;
+}
+export interface SubscriptionDegradeInfo {
+    from: 'sdk-credit' | 'subscription-pool';
+    to: 'sdk-credit' | 'subscription-pool';
+    reason: string;
+    component?: string;
+}
+export interface AnthropicSubscriptionRouterOptions {
+    /** The `claude -p` provider (UNWRAPPED — the breaker wraps this router). */
+    headless: IntelligenceProvider;
+    /** The interactive-pool provider. */
+    pool: IntelligenceProvider;
+    mode: SubscriptionPathMode;
+    /** Real credit reader (bootRegistration.buildReadSdkCredit) — never throws. */
+    readSdkCredit: () => Promise<AgentSdkCreditSnapshot | null>;
+    /** Mirrors CostAwareRoutingPolicy's default (10% of the monthly pot). */
+    safetyMarginFraction?: number;
+    /** Observability tap — every routing decision (T-05: no invisible routing). */
+    onRoute?: (info: SubscriptionRouteInfo) => void;
+    /** Observability tap — auto-mode fallback after a primary failure. */
+    onDegrade?: (info: SubscriptionDegradeInfo) => void;
+}
+export declare class AnthropicSubscriptionRouter implements IntelligenceProvider {
+    private readonly opts;
+    private readonly safetyMarginFraction;
+    constructor(options: AnthropicSubscriptionRouterOptions);
+    evaluate(prompt: string, options?: IntelligenceOptions): Promise<string>;
+}
+//# sourceMappingURL=AnthropicSubscriptionRouter.d.ts.map

package/dist/core/AnthropicSubscriptionRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnthropicSubscriptionRouter.d.ts","sourceRoot":"","sources":["../../src/core/AnthropicSubscriptionRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6DAA6D,CAAC;AAE1G,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,IAAI,EAAE,YAAY,GAAG,mBAAmB,CAAC;IACzC,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,YAAY,GAAG,mBAAmB,CAAC;IACzC,EAAE,EAAE,YAAY,GAAG,mBAAmB,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kCAAkC;IACjD,4EAA4E;IAC5E,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,qCAAqC;IACrC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,+EAA+E;IAC/E,aAAa,EAAE,MAAM,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAC5D,yEAAyE;IACzE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAChD,sEAAsE;IACtE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,uBAAuB,KAAK,IAAI,CAAC;CACrD;AAID,qBAAa,2BAA4B,YAAW,oBAAoB;IACtE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqC;IAC1D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;gBAElC,OAAO,EAAE,kCAAkC;IAWjD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;CAwC/E"}

package/dist/core/AnthropicSubscriptionRouter.js

@@ -0,0 +1,82 @@
+/**
+ * AnthropicSubscriptionRouter — per-call routing between the two ALLOWED
+ * Anthropic paths for internal intelligence calls:
+ *
+ *   - `claude -p` one-shots (anthropic-headless / ClaudeCliIntelligenceProvider)
+ *     — the Agent SDK credit path post-2026-06-15. Prepaid accelerator.
+ *   - the interactive REPL pool (InteractivePoolIntelligenceProvider)
+ *     — the Max-subscription floor. Always available (Rule 1).
+ *
+ * Modes (intelligence.subscriptionPath.mode):
+ *   - 'auto'  — drain the SDK pot while it's known-healthy, fall to the
+ *               subscription floor when the pot is unknown/at-margin
+ *               (decideSdkVsSubscription — same thresholds as the
+ *               registry-level CostAwareRoutingPolicy, single source of
+ *               truth). A failed primary gets ONE fallback attempt on the
+ *               other path, with an onDegrade report — Rule 1 resilience.
+ *   - 'force' — subscription pool ONLY. No SDK fallback: the whole point
+ *               of force mode (soak tests, June-15 emergency lever) is
+ *               proving/guaranteeing zero `claude -p` traffic. Failures
+ *               are LOUD throws.
+ *
+ * Mode 'off' never constructs this class — buildIntelligenceProvider
+ * returns the plain ClaudeCliIntelligenceProvider, byte-for-byte today's
+ * behavior.
+ *
+ * This router sits INSIDE the circuit-breaker wrap (breaker stays
+ * outermost), and BELOW the per-component IntelligenceRouter (framework
+ * routing decides claude-vs-codex first; this decides WHICH Claude path).
+ */
+import { decideSdkVsSubscription } from '../providers/costAwareRouting.js';
+const DEFAULT_SAFETY_MARGIN_FRACTION = 0.1;
+export class AnthropicSubscriptionRouter {
+    opts;
+    safetyMarginFraction;
+    constructor(options) {
+        this.opts = options;
+        this.safetyMarginFraction =
+            options.safetyMarginFraction ?? DEFAULT_SAFETY_MARGIN_FRACTION;
+        if (this.safetyMarginFraction < 0 || this.safetyMarginFraction > 1) {
+            throw new Error(`AnthropicSubscriptionRouter: safetyMarginFraction must be in [0,1], got ${this.safetyMarginFraction}`);
+        }
+    }
+    async evaluate(prompt, options) {
+        const component = options?.attribution?.component;
+        if (this.opts.mode === 'force') {
+            this.opts.onRoute?.({ path: 'subscription-pool', reason: 'forced-subscription-mode', component });
+            // No fallback by design — force mode guarantees zero `claude -p`
+            // traffic; a pool failure must surface, not silently re-route.
+            return this.opts.pool.evaluate(prompt, options);
+        }
+        // auto — decide on live credit state (cached reader; never throws).
+        const snapshot = await this.opts.readSdkCredit();
+        const decision = decideSdkVsSubscription(snapshot, this.safetyMarginFraction);
+        const primaryIsSdk = decision.path === 'sdk-credit';
+        const primary = primaryIsSdk ? this.opts.headless : this.opts.pool;
+        const fallback = primaryIsSdk ? this.opts.pool : this.opts.headless;
+        const primaryLabel = primaryIsSdk
+            ? 'sdk-credit'
+            : 'subscription-pool';
+        const fallbackLabel = primaryIsSdk
+            ? 'subscription-pool'
+            : 'sdk-credit';
+        this.opts.onRoute?.({ path: primaryLabel, reason: decision.reason, component });
+        try {
+            return await primary.evaluate(prompt, options);
+        }
+        catch (err) {
+            // @silent-fallback-ok — auto-mode cross-path fallback is the Rule-1
+            // contract; the failure is reported via onDegrade (DegradationReporter
+            // at the server wiring), and a fallback failure re-throws loudly.
+            const reason = err instanceof Error ? err.message : String(err);
+            this.opts.onDegrade?.({ from: primaryLabel, to: fallbackLabel, reason, component });
+            this.opts.onRoute?.({
+                path: fallbackLabel,
+                reason: `fallback-after-primary-failure: ${reason.slice(0, 200)}`,
+                component,
+            });
+            return fallback.evaluate(prompt, options);
+        }
+    }
+}
+//# sourceMappingURL=AnthropicSubscriptionRouter.js.map

package/dist/core/AnthropicSubscriptionRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnthropicSubscriptionRouter.js","sourceRoot":"","sources":["../../src/core/AnthropicSubscriptionRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAqC3E,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAE3C,MAAM,OAAO,2BAA2B;IACrB,IAAI,CAAqC;IACzC,oBAAoB,CAAS;IAE9C,YAAY,OAA2C;QACrD,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;QACpB,IAAI,CAAC,oBAAoB;YACvB,OAAO,CAAC,oBAAoB,IAAI,8BAA8B,CAAC;QACjE,IAAI,IAAI,CAAC,oBAAoB,GAAG,CAAC,IAAI,IAAI,CAAC,oBAAoB,GAAG,CAAC,EAAE,CAAC;YACnE,MAAM,IAAI,KAAK,CACb,2EAA2E,IAAI,CAAC,oBAAoB,EAAE,CACvG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,OAA6B;QAC1D,MAAM,SAAS,GAAG,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC;QAElD,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,0BAA0B,EAAE,SAAS,EAAE,CAAC,CAAC;YAClG,iEAAiE;YACjE,+DAA+D;YAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QAED,oEAAoE;QACpE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;QACjD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,QAAQ,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC9E,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,KAAK,YAAY,CAAC;QACpD,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QACnE,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;QACpE,MAAM,YAAY,GAAkC,YAAY;YAC9D,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,mBAAmB,CAAC;QACxB,MAAM,aAAa,GAAkC,YAAY;YAC/D,CAAC,CAAC,mBAAmB;YACrB,CAAC,CAAC,YAAY,CAAC;QAEjB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAChF,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,oEAAoE;YACpE,uEAAuE;YACvE,kEAAkE;YAClE,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YACpF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClB,IAAI,EAAE,aAAa;gBACnB,MAAM,EAAE,mCAAmC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;gBACjE,SAAS;aACV,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;CACF"}

package/dist/core/InteractivePoolIntelligenceProvider.d.ts

@@ -0,0 +1,38 @@
+/**
+ * InteractivePoolIntelligenceProvider — IntelligenceProvider over the
+ * anthropic-interactive-pool adapter (the SUBSCRIPTION path).
+ *
+ * This is the Rule-1 floor for internal LLM judgment calls
+ * (specs/provider-portability/04-anthropic-path-constraints.md): instead of
+ * a `claude -p` one-shot (which bills the Agent SDK credit pot after
+ * 2026-06-15), the call is typed into a long-lived interactive `claude`
+ * REPL drawn from the Max subscription — the path that keeps working when
+ * the credit pot is empty.
+ *
+ * Honest limitations (inherent to the pool transport, documented in
+ * specs/provider-portability/prototype/interactive-pool/findings.md):
+ *   - No per-call model selection: the pool runs ONE model, fixed at
+ *     session spawn (`InteractivePoolConfig.model`). The per-call
+ *     `options.model` tier is accepted but cannot be honored — per Rule 1,
+ *     the option is advisory, not the path.
+ *   - No per-call token usage: the REPL reports cumulative usage only, so
+ *     `options.onUsage` is NEVER invoked. /metrics/features still counts
+ *     calls + latency for attributed callers; token columns read 0 for
+ *     pool-served calls.
+ *   - Latency: ~8s/prompt steady-state (4s of that is the stability
+ *     window) vs ~5s for `claude -p`.
+ *
+ * Failure honesty: pool errors (spawn failure, allocate timeout, prompt
+ * timeout) propagate as loud throws with the pool's reason — never a
+ * silent empty answer. Callers (circuit breaker, AnthropicSubscriptionRouter)
+ * decide fallback.
+ */
+import type { IntelligenceProvider, IntelligenceOptions } from './types.js';
+import type { ProviderAdapter } from '../providers/registry.js';
+export declare class InteractivePoolIntelligenceProvider implements IntelligenceProvider {
+    private adapter;
+    private oneShot;
+    constructor(poolAdapter: ProviderAdapter);
+    evaluate(prompt: string, options?: IntelligenceOptions): Promise<string>;
+}
+//# sourceMappingURL=InteractivePoolIntelligenceProvider.d.ts.map

package/dist/core/InteractivePoolIntelligenceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractivePoolIntelligenceProvider.d.ts","sourceRoot":"","sources":["../../src/core/InteractivePoolIntelligenceProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAG5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAKhE,qBAAa,mCAAoC,YAAW,oBAAoB;IAC9E,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,OAAO,CAAkC;gBAErC,WAAW,EAAE,eAAe;IAQlC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;CAsB/E"}

package/dist/core/InteractivePoolIntelligenceProvider.js

@@ -0,0 +1,61 @@
+/**
+ * InteractivePoolIntelligenceProvider — IntelligenceProvider over the
+ * anthropic-interactive-pool adapter (the SUBSCRIPTION path).
+ *
+ * This is the Rule-1 floor for internal LLM judgment calls
+ * (specs/provider-portability/04-anthropic-path-constraints.md): instead of
+ * a `claude -p` one-shot (which bills the Agent SDK credit pot after
+ * 2026-06-15), the call is typed into a long-lived interactive `claude`
+ * REPL drawn from the Max subscription — the path that keeps working when
+ * the credit pot is empty.
+ *
+ * Honest limitations (inherent to the pool transport, documented in
+ * specs/provider-portability/prototype/interactive-pool/findings.md):
+ *   - No per-call model selection: the pool runs ONE model, fixed at
+ *     session spawn (`InteractivePoolConfig.model`). The per-call
+ *     `options.model` tier is accepted but cannot be honored — per Rule 1,
+ *     the option is advisory, not the path.
+ *   - No per-call token usage: the REPL reports cumulative usage only, so
+ *     `options.onUsage` is NEVER invoked. /metrics/features still counts
+ *     calls + latency for attributed callers; token columns read 0 for
+ *     pool-served calls.
+ *   - Latency: ~8s/prompt steady-state (4s of that is the stability
+ *     window) vs ~5s for `claude -p`.
+ *
+ * Failure honesty: pool errors (spawn failure, allocate timeout, prompt
+ * timeout) propagate as loud throws with the pool's reason — never a
+ * silent empty answer. Callers (circuit breaker, AnthropicSubscriptionRouter)
+ * decide fallback.
+ */
+import { assertClaudeAllowed } from './claudeForbiddenGuard.js';
+import { CapabilityFlag } from '../providers/capabilities.js';
+const DEFAULT_TIMEOUT_MS = 30_000;
+export class InteractivePoolIntelligenceProvider {
+    adapter;
+    oneShot = null;
+    constructor(poolAdapter) {
+        // Same codex-only enforcement as ClaudeCliIntelligenceProvider: on a
+        // codex-only agent, constructing ANY Claude-backed intelligence path
+        // is forbidden, loudly.
+        assertClaudeAllowed('InteractivePoolIntelligenceProvider');
+        this.adapter = poolAdapter;
+    }
+    async evaluate(prompt, options) {
+        if (!this.oneShot) {
+            this.oneShot = this.adapter.primitive(CapabilityFlag.OneShotCompletion);
+        }
+        const result = await this.oneShot.evaluate(prompt, {
+            // Advisory on this path — the pool runs one model fixed at spawn.
+            model: options?.model ?? 'fast',
+            maxTokens: options?.maxTokens,
+            temperature: options?.temperature,
+            timeoutMs: options?.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+        });
+        // The pool transport cannot report per-call usage (usage is null by
+        // contract) — options.onUsage is deliberately NOT invoked. Invoking it
+        // with zeros would corrupt the per-feature token ledger with
+        // fake-precision data; absent is honest.
+        return result.text;
+    }
+}
+//# sourceMappingURL=InteractivePoolIntelligenceProvider.js.map

package/dist/core/InteractivePoolIntelligenceProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractivePoolIntelligenceProvider.js","sourceRoot":"","sources":["../../src/core/InteractivePoolIntelligenceProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAI9D,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,MAAM,OAAO,mCAAmC;IACtC,OAAO,CAAkB;IACzB,OAAO,GAA6B,IAAI,CAAC;IAEjD,YAAY,WAA4B;QACtC,qEAAqE;QACrE,qEAAqE;QACrE,wBAAwB;QACxB,mBAAmB,CAAC,qCAAqC,CAAC,CAAC;QAC3D,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,OAA6B;QAC1D,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CACnC,cAAc,CAAC,iBAAiB,CACZ,CAAC;QACzB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE;YACjD,kEAAkE;YAClE,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,MAAM;YAC/B,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,WAAW,EAAE,OAAO,EAAE,WAAW;YACjC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,kBAAkB;SACpD,CAAC,CAAC;QAEH,oEAAoE;QACpE,uEAAuE;QACvE,6DAA6D;QAC7D,yCAAyC;QAEzC,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;CACF"}

package/dist/core/PostUpdateMigrator.d.ts.map

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

package/dist/core/PostUpdateMigrator.js

@@ -2890,6 +2890,23 @@ Check where codex account usage sits without the interactive TUI. The codex CLI
             patched = true;
             result.upgraded.push('CLAUDE.md: added Codex Usage (/codex/usage) awareness (codex-usage-visibility)');
         }
+        // subscription-path-routing (Agent Awareness + Migration Parity): existing
+        // agents must learn the June-15 lever exists — the registry introspection
+        // route and the intelligence.subscriptionPath mode switch. Content-sniff
+        // on the route marker.
+        if (!content.includes('/providers/registry')) {
+            const subscriptionPathSection = `
+### Anthropic Subscription-Path Routing (June-15 readiness)
+
+Your internal background LLM calls (sentinels, gates, extractors) normally run as \`claude -p\` one-shots, which bill the Agent SDK credit pot after 2026-06-15. The subscription-path lever routes them through a pool of long-lived interactive Claude sessions instead — the path that keeps working when the pot is empty.
+- What's actually wired in: \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/providers/registry\` → registered provider adapters + capability flags. Both \`anthropic-headless\` and \`anthropic-interactive-pool\` listed = the escape hatch is installed.
+- The lever: \`.instar/config.json\` → \`intelligence.subscriptionPath.mode\`: \`off\` (default — today's behavior), \`auto\` (drain the SDK pot while healthy, slide to the interactive pool when it's unknown/near-empty), \`force\` (interactive pool ONLY — zero \`claude -p\` traffic). Restart sessions/server to apply.
+- **When to use** (PROACTIVE): "are we ready for the June 15 change?" / "what happens when the SDK credits run out?" → read \`GET /providers/registry\` + report the configured mode. SDK-pot exhaustion → offer the \`force\`/\`auto\` flip instead of letting background checks fail. (Spec: \`docs/specs/provider-substrate-live-wiring.md\`.)
+`;
+            content += '\n' + subscriptionPathSection;
+            patched = true;
+            result.upgraded.push('CLAUDE.md: added Anthropic Subscription-Path Routing (/providers/registry) awareness (provider-substrate-live-wiring)');
+        }
         // session-clock (Agent Awareness + Migration Parity): existing agents must
         // learn they can ask how long they've been running / how much is left,
         // instead of guessing. Content-sniff on the route marker.