opencode-swarm 7.167.2 → 7.168.0

package/dist/cli/{scope-persistence-3xnr59y8.js → scope-persistence-a493gv51.js}

@@ -23,30 +23,30 @@ import {
   tombstoneScopeBinding,
   writeScopeBindingToDisk,
   writeScopeToDisk
-} from "./index-jhd3pmd1.js";
-import"./index-z7z3g5wt.js";
-import"./index-z6we1abx.js";
-import"./index-g409c7ke.js";
-import"./index-962qme08.js";
-import"./index-hhkm64wh.js";
-import"./index-n4fzmqz8.js";
+} from "./index-an8b5gda.js";
+import"./index-yv76j77m.js";
+import"./index-a8xbvsse.js";
+import"./index-pyf517sz.js";
+import"./index-h439y187.js";
+import"./index-wst6n478.js";
+import"./index-rdm3px0g.js";
 import"./index-ry16d01s.js";
-import"./index-gs12223x.js";
-import"./index-18rfc7qv.js";
+import"./index-qwsh0h2g.js";
+import"./index-j950hqmq.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-0q839sg6.js";
-import"./index-vgpedapd.js";
+import"./index-8ybjqg51.js";
+import"./index-4r5pmtvk.js";
 import"./index-7g4c7s5r.js";
-import"./index-x7pm61wk.js";
-import"./index-tcj8v6my.js";
+import"./index-v3xc4sde.js";
+import"./index-z6qreakh.js";
 import"./index-1xnse449.js";
 import"./index-ee6ydtfe.js";
-import"./index-wjet7x0a.js";
+import"./index-seetnhpx.js";
 import"./index-0mhftbpp.js";
 import"./index-a1w58b47.js";
-import"./index-2b1hd1fx.js";
-import"./index-g5m43paw.js";
+import"./index-exatbqwj.js";
+import"./index-sxt7fgcw.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{skill-generator-3mvaghxk.js → skill-generator-2qqzkdpv.js}

@@ -33,33 +33,33 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-f91fhch0.js";
+} from "./index-64phnth4.js";
 import"./index-q7sjgr1y.js";
-import"./index-m3z83nhs.js";
-import"./index-8vbahc4c.js";
+import"./index-nsyxj57e.js";
+import"./index-kear8gb7.js";
 import"./index-p612v1mv.js";
-import"./index-shrf0wt3.js";
-import"./index-syedr4e3.js";
+import"./index-3dywbkyr.js";
+import"./index-m35hybf0.js";
 import"./index-rtry5xyf.js";
-import"./index-s7a9dqtb.js";
+import"./index-x7k3dps5.js";
 import"./index-3qf1vxtb.js";
 import"./index-n832052r.js";
-import"./index-gs12223x.js";
-import"./index-18rfc7qv.js";
+import"./index-qwsh0h2g.js";
+import"./index-j950hqmq.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-0q839sg6.js";
-import"./index-vgpedapd.js";
+import"./index-8ybjqg51.js";
+import"./index-4r5pmtvk.js";
 import"./index-7g4c7s5r.js";
-import"./index-x7pm61wk.js";
-import"./index-tcj8v6my.js";
+import"./index-v3xc4sde.js";
+import"./index-z6qreakh.js";
 import"./index-1xnse449.js";
 import"./index-ee6ydtfe.js";
-import"./index-wjet7x0a.js";
+import"./index-seetnhpx.js";
 import"./index-0mhftbpp.js";
 import"./index-a1w58b47.js";
-import"./index-2b1hd1fx.js";
-import"./index-g5m43paw.js";
+import"./index-exatbqwj.js";
+import"./index-sxt7fgcw.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{snapshot-coordination-init-arnc77r9.js → snapshot-coordination-init-8yt8p7q0.js}

@@ -8,64 +8,64 @@ import {
   markSnapshotCoordinationClosing,
   retrySnapshotCoordinationInitialization,
   startSnapshotCoordinationInitialization
-} from "./index-y1sj2e1n.js";
+} from "./index-yevn4jpe.js";
 import"./index-d5qf7hvh.js";
-import"./index-k73ehxa1.js";
-import"./index-dme7wvwg.js";
-import"./index-f8cc92g7.js";
-import"./index-rrne6g2m.js";
-import"./index-arqv4psy.js";
-import"./index-83r0v5tn.js";
+import"./index-qhey6vc3.js";
+import"./index-30h1pk05.js";
+import"./index-nwwk3dej.js";
+import"./index-cyenn3pf.js";
+import"./index-21ree67h.js";
+import"./index-gp9yzr1v.js";
 import"./index-txdagbh7.js";
 import"./index-9br68j86.js";
 import"./index-cw912re7.js";
-import"./index-f91fhch0.js";
-import"./index-ce8p9t28.js";
-import"./index-pdcperq5.js";
+import"./index-64phnth4.js";
+import"./index-mr0wn36f.js";
+import"./index-wnzxcr0z.js";
 import"./index-fyfbpz4f.js";
-import"./index-mtepgqan.js";
+import"./index-dfyv3xkd.js";
 import"./index-zsrtt42s.js";
-import"./index-5sjq3shs.js";
-import"./index-m7cwnt9r.js";
-import"./index-gmjg65tm.js";
+import"./index-ze520xw1.js";
+import"./index-5zqakgp4.js";
+import"./index-bvqqwx84.js";
 import"./index-b43rt5ph.js";
 import"./index-q7sjgr1y.js";
-import"./index-3r6k6qa7.js";
-import"./index-09gv90d7.js";
-import"./index-sjkg2hc4.js";
-import"./index-m3z83nhs.js";
-import"./index-8vbahc4c.js";
+import"./index-00zx94vn.js";
+import"./index-8f0kscpg.js";
+import"./index-nprngf8p.js";
+import"./index-nsyxj57e.js";
+import"./index-kear8gb7.js";
 import"./index-p612v1mv.js";
-import"./index-shrf0wt3.js";
-import"./index-syedr4e3.js";
+import"./index-3dywbkyr.js";
+import"./index-m35hybf0.js";
 import"./index-rtry5xyf.js";
-import"./index-s7a9dqtb.js";
+import"./index-x7k3dps5.js";
 import"./index-3qf1vxtb.js";
 import"./index-n832052r.js";
-import"./index-jhd3pmd1.js";
-import"./index-z7z3g5wt.js";
-import"./index-z6we1abx.js";
-import"./index-g409c7ke.js";
-import"./index-962qme08.js";
-import"./index-hhkm64wh.js";
-import"./index-n4fzmqz8.js";
+import"./index-an8b5gda.js";
+import"./index-yv76j77m.js";
+import"./index-a8xbvsse.js";
+import"./index-pyf517sz.js";
+import"./index-h439y187.js";
+import"./index-wst6n478.js";
+import"./index-rdm3px0g.js";
 import"./index-ry16d01s.js";
-import"./index-gs12223x.js";
-import"./index-18rfc7qv.js";
+import"./index-qwsh0h2g.js";
+import"./index-j950hqmq.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-0q839sg6.js";
-import"./index-vgpedapd.js";
+import"./index-8ybjqg51.js";
+import"./index-4r5pmtvk.js";
 import"./index-7g4c7s5r.js";
-import"./index-x7pm61wk.js";
-import"./index-tcj8v6my.js";
+import"./index-v3xc4sde.js";
+import"./index-z6qreakh.js";
 import"./index-1xnse449.js";
 import"./index-ee6ydtfe.js";
-import"./index-wjet7x0a.js";
+import"./index-seetnhpx.js";
 import"./index-0mhftbpp.js";
 import"./index-a1w58b47.js";
-import"./index-2b1hd1fx.js";
-import"./index-g5m43paw.js";
+import"./index-exatbqwj.js";
+import"./index-sxt7fgcw.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{sqlite-loader-xrnf6bq8.js → sqlite-loader-amp9z7ty.js}

@@ -3,7 +3,7 @@ import {
   _internals,
   createNodeDatabaseCtor,
   loadDatabaseCtor
-} from "./index-n4fzmqz8.js";
+} from "./index-rdm3px0g.js";
 import"./index-a76rekgs.js";
 export {
   loadDatabaseCtor,

package/dist/cli/{telemetry-g9pppt9e.js → telemetry-2wzapf11.js}

@@ -14,7 +14,7 @@ import {
   startHeartbeatTracking,
   stopHeartbeatTracking,
   telemetry
-} from "./index-tcj8v6my.js";
+} from "./index-z6qreakh.js";
 import"./index-1xnse449.js";
 import"./index-ee6ydtfe.js";
 import"./index-bpmtbmy9.js";

package/dist/cli/{workspace-snapshot-hvsjtepd.js → workspace-snapshot-rkgxhj9b.js}

@@ -45,10 +45,10 @@ import {
   shouldSkipSnapshot,
   switchPrFeedbackTrackingCandidateAsync,
   workspaceSnapshotMatches
-} from "./index-m7cwnt9r.js";
-import"./index-8vbahc4c.js";
+} from "./index-5zqakgp4.js";
+import"./index-kear8gb7.js";
 import"./index-p612v1mv.js";
-import"./index-x7pm61wk.js";
+import"./index-v3xc4sde.js";
 import"./index-1xnse449.js";
 import"./index-ee6ydtfe.js";
 import"./index-0mhftbpp.js";

package/dist/cli/{worktree-collision-ownership-vj8anvb7.js → worktree-collision-ownership-xttafc4h.js}

@@ -6,29 +6,29 @@ import {
   WORKTREE_PROVISIONING_OWNER_LEASE_MS,
   removeWorktreeProvisioningOwner,
   scanWorktreeProvisioningOwnersForRecovery
-} from "./index-gmjg65tm.js";
+} from "./index-bvqqwx84.js";
 import {
   scanDelegationFallbacksForRecovery,
   scanDelegationsForRecovery
-} from "./index-sjkg2hc4.js";
-import"./index-8vbahc4c.js";
+} from "./index-nprngf8p.js";
+import"./index-kear8gb7.js";
 import {
   bunSpawn
 } from "./index-p612v1mv.js";
-import"./index-g409c7ke.js";
-import"./index-962qme08.js";
-import"./index-hhkm64wh.js";
-import"./index-n4fzmqz8.js";
+import"./index-pyf517sz.js";
+import"./index-h439y187.js";
+import"./index-wst6n478.js";
+import"./index-rdm3px0g.js";
 import"./index-ry16d01s.js";
-import"./index-gs12223x.js";
-import"./index-18rfc7qv.js";
+import"./index-qwsh0h2g.js";
+import"./index-j950hqmq.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-0q839sg6.js";
-import"./index-vgpedapd.js";
+import"./index-8ybjqg51.js";
+import"./index-4r5pmtvk.js";
 import"./index-7g4c7s5r.js";
-import"./index-x7pm61wk.js";
-import"./index-tcj8v6my.js";
+import"./index-v3xc4sde.js";
+import"./index-z6qreakh.js";
 import {
   canonicalRootKeyFresh
 } from "./index-1xnse449.js";

package/dist/cli/{worktree-isolation-mt7z75hz.js → worktree-isolation-e5q5rewk.js}

@@ -21,66 +21,66 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-y1sj2e1n.js";
+} from "./index-yevn4jpe.js";
 import"./index-d5qf7hvh.js";
-import"./index-k73ehxa1.js";
-import"./index-dme7wvwg.js";
-import"./index-f8cc92g7.js";
-import"./index-rrne6g2m.js";
-import"./index-arqv4psy.js";
-import"./index-83r0v5tn.js";
+import"./index-qhey6vc3.js";
+import"./index-30h1pk05.js";
+import"./index-nwwk3dej.js";
+import"./index-cyenn3pf.js";
+import"./index-21ree67h.js";
+import"./index-gp9yzr1v.js";
 import"./index-txdagbh7.js";
 import"./index-9br68j86.js";
 import"./index-cw912re7.js";
-import"./index-f91fhch0.js";
-import"./index-ce8p9t28.js";
-import"./index-pdcperq5.js";
+import"./index-64phnth4.js";
+import"./index-mr0wn36f.js";
+import"./index-wnzxcr0z.js";
 import"./index-fyfbpz4f.js";
-import"./index-mtepgqan.js";
+import"./index-dfyv3xkd.js";
 import"./index-zsrtt42s.js";
-import"./index-5sjq3shs.js";
-import"./index-m7cwnt9r.js";
-import"./index-gmjg65tm.js";
+import"./index-ze520xw1.js";
+import"./index-5zqakgp4.js";
+import"./index-bvqqwx84.js";
 import"./index-b43rt5ph.js";
 import"./index-q7sjgr1y.js";
-import"./index-3r6k6qa7.js";
-import"./index-09gv90d7.js";
-import"./index-sjkg2hc4.js";
-import"./index-m3z83nhs.js";
-import"./index-8vbahc4c.js";
+import"./index-00zx94vn.js";
+import"./index-8f0kscpg.js";
+import"./index-nprngf8p.js";
+import"./index-nsyxj57e.js";
+import"./index-kear8gb7.js";
 import"./index-p612v1mv.js";
-import"./index-shrf0wt3.js";
-import"./index-syedr4e3.js";
+import"./index-3dywbkyr.js";
+import"./index-m35hybf0.js";
 import"./index-rtry5xyf.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-s7a9dqtb.js";
+} from "./index-x7k3dps5.js";
 import"./index-3qf1vxtb.js";
 import"./index-n832052r.js";
-import"./index-jhd3pmd1.js";
-import"./index-z7z3g5wt.js";
-import"./index-z6we1abx.js";
-import"./index-g409c7ke.js";
-import"./index-962qme08.js";
-import"./index-hhkm64wh.js";
-import"./index-n4fzmqz8.js";
+import"./index-an8b5gda.js";
+import"./index-yv76j77m.js";
+import"./index-a8xbvsse.js";
+import"./index-pyf517sz.js";
+import"./index-h439y187.js";
+import"./index-wst6n478.js";
+import"./index-rdm3px0g.js";
 import"./index-ry16d01s.js";
-import"./index-gs12223x.js";
-import"./index-18rfc7qv.js";
+import"./index-qwsh0h2g.js";
+import"./index-j950hqmq.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-0q839sg6.js";
-import"./index-vgpedapd.js";
+import"./index-8ybjqg51.js";
+import"./index-4r5pmtvk.js";
 import"./index-7g4c7s5r.js";
-import"./index-x7pm61wk.js";
-import"./index-tcj8v6my.js";
+import"./index-v3xc4sde.js";
+import"./index-z6qreakh.js";
 import"./index-1xnse449.js";
 import"./index-ee6ydtfe.js";
-import"./index-wjet7x0a.js";
+import"./index-seetnhpx.js";
 import"./index-0mhftbpp.js";
 import"./index-a1w58b47.js";
-import"./index-2b1hd1fx.js";
-import"./index-g5m43paw.js";
+import"./index-exatbqwj.js";
+import"./index-sxt7fgcw.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";
 import"./index-zpsr8rpc.js";

package/dist/commands/reset.d.ts

@@ -1,3 +1,6 @@
+import * as fs from 'node:fs';
+import { clearPlanLedgerForReset } from '../plan/ledger.js';
+import { withPlanLifecycleLock } from '../plan/manager.js';
 import { type ResetBackupResult } from './reset-backup';
 /**
  * _internals DI seam so tests can stub the pre-deletion backup without touching
@@ -6,6 +9,13 @@ import { type ResetBackupResult } from './reset-backup';
  */
 export declare const _internals: {
     backupSwarmStateBeforeReset: (directory: string, kind: 'reset' | 'reset-session', relEntries: string[]) => ResetBackupResult;
+    clearPlanLedgerForReset: typeof clearPlanLedgerForReset;
+    withPlanLifecycleLock: typeof withPlanLifecycleLock;
+    existsSync: typeof fs.existsSync;
+    readFileSync: typeof fs.readFileSync;
+    unlinkSync: typeof fs.unlinkSync;
+    writeFileSync: typeof fs.writeFileSync;
+    rmSync: typeof fs.rmSync;
 };
 /**
  * Handles the /swarm reset command.

package/dist/commands/rollback.d.ts

@@ -1,3 +1,12 @@
+import { clearPlanLedgerForReset, peekPlanFromLedger, replacePlanLedgerWithRoot } from '../plan/ledger';
+import { withPlanLifecycleLock } from '../plan/manager';
+/** Test-only seam for the atomic ledger re-root lifecycle transition. */
+export declare const _internals: {
+    replacePlanLedgerWithRoot: typeof replacePlanLedgerWithRoot;
+    clearPlanLedgerForReset: typeof clearPlanLedgerForReset;
+    peekPlanFromLedger: typeof peekPlanFromLedger;
+    withPlanLifecycleLock: typeof withPlanLifecycleLock;
+};
 /**
  * Handle /swarm rollback command
  * Restores .swarm/ state from a checkpoint using direct overwrite

package/dist/config/schema.d.ts

@@ -1395,6 +1395,7 @@ export declare const WorktreeIsolationConfigSchema: z.ZodObject<{
     }>>;
     serialization_release_after_dispatches: z.ZodDefault<z.ZodNumber>;
     serialization_release_after_ms: z.ZodDefault<z.ZodNumber>;
+    session_create_timeout_ms: z.ZodDefault<z.ZodNumber>;
     runtime_isolation: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         port_base: z.ZodOptional<z.ZodNumber>;
@@ -1889,6 +1890,26 @@ export declare const LaneLivenessWatchdogConfigSchema: z.ZodObject<{
     stall_token_threshold: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 export type LaneLivenessWatchdogConfig = z.infer<typeof LaneLivenessWatchdogConfigSchema>;
+/**
+ * Issue #2507 dispatch protection: an action-local spawn-protection circuit
+ * plus a token-bucket dispatch rate limit for native task delegations.
+ *
+ * Default-ON follows the guardrails family (`guardrails.enabled` defaults
+ * true): the numbers are deliberately conservative (10 dispatches per second
+ * with a burst of 10 never waits in normal use), and every knob is
+ * user-overridable — set `enabled: false` to opt out entirely, or
+ * `rate_per_second: 0` to disable only the limiter. Parameter surface
+ * adopted with credit from opencode-ensemble (reimplemented per ADR 0002 —
+ * no upstream code is ported).
+ */
+export declare const DispatchProtectionConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    spawn_failure_threshold: z.ZodDefault<z.ZodNumber>;
+    half_open_after_ms: z.ZodDefault<z.ZodNumber>;
+    rate_per_second: z.ZodDefault<z.ZodNumber>;
+    burst_capacity: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type DispatchProtectionConfig = z.infer<typeof DispatchProtectionConfigSchema>;
 /**
  * Issue #2384: deprecated transcript-row settlement for Profile A PR-review
  * base/micro discovery lanes is an explicit compatibility opt-in. Omitted
@@ -2001,6 +2022,13 @@ export declare const PluginConfigSchema: z.ZodObject<{
         stall_min_steps: z.ZodDefault<z.ZodNumber>;
         stall_token_threshold: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
+    dispatch_protection: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        spawn_failure_threshold: z.ZodDefault<z.ZodNumber>;
+        half_open_after_ms: z.ZodDefault<z.ZodNumber>;
+        rate_per_second: z.ZodDefault<z.ZodNumber>;
+        burst_capacity: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
     pr_review_legacy_transcript_compatibility: z.ZodOptional<z.ZodBoolean>;
     gates: z.ZodOptional<z.ZodObject<{
         syntax_check: z.ZodDefault<z.ZodObject<{
@@ -2801,6 +2829,7 @@ export declare const PluginConfigSchema: z.ZodObject<{
         }>>;
         serialization_release_after_dispatches: z.ZodDefault<z.ZodNumber>;
         serialization_release_after_ms: z.ZodDefault<z.ZodNumber>;
+        session_create_timeout_ms: z.ZodDefault<z.ZodNumber>;
         runtime_isolation: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             port_base: z.ZodOptional<z.ZodNumber>;

package/dist/db/project-db.d.ts

@@ -39,6 +39,14 @@ export declare function projectDbPath(directory: string): string;
  * workspace just to check for a missing record.
  */
 export declare function projectDbExists(directory: string): boolean;
+/**
+ * Open the existing project database for one observational callback.
+ *
+ * Unlike `getProjectDb`, this never creates directories, negotiates WAL, runs
+ * migrations, or enters the shared connection cache. It is the only suitable
+ * path for lifecycle previews such as `/swarm close --dry-run`.
+ */
+export declare function withProjectDbReadOnly<T>(directory: string, read: (db: Database) => T): T | null;
 /**
  * Best-effort WAL checkpoint before close (issue #2480 checkpoint policy).
  *

package/dist/db/sqlite-loader.d.ts

@@ -51,8 +51,9 @@ interface NodeDatabaseSync {
     loadExtension(path: string): void;
     close(): void;
 }
-type NodeDatabaseSyncCtor = new (filename: string, options?: {
+type NodeDatabaseSyncCtor = new (filename: string | URL, options?: {
     allowExtension?: boolean;
+    readOnly?: boolean;
 }) => NodeDatabaseSync;
 /**
  * Build a `bun:sqlite`-`Database`-compatible constructor backed by `node:sqlite`'s

package/dist/dispatch/spawn-circuit.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Action-local spawn-protection circuit for native task delegations
+ * (issue #2507 / ADR 0002 G3 — reimplemented, no upstream code ported).
+ *
+ * Ownership boundary (one accounting owner per failure category,
+ * docs/invocation-failures.md): this circuit owns repeated ACTUAL dispatch
+ * failures of the SAME semantic action on the native `task` route. Policy
+ * denials stay with the gate-denial tracker, shell-structural failures with
+ * the non-transient circuit, PR-review lane provider-terminal with the
+ * PR-review resilience circuit, provable-non-acceptance launch retry with
+ * #2473, and lane liveness with #2506.
+ *
+ * State machine (the src/pr-review/circuit.ts timed HALF_OPEN precedent):
+ * CLOSED -> (threshold failures) -> OPEN -> (denyUntil elapses, next dispatch
+ * admitted) -> HALF_OPEN (exactly one probe) -> completed probe closes |
+ * failed probe re-opens with a fresh interval.
+ *
+ * The state is process-local, invocation-owned, and bounded — the
+ * docs/invocation-failures.md contract for action circuits (only the
+ * PR-review resilience circuit is durable).
+ */
+/** Bounded memory: same discipline as MAX_TRACKED_ACTION_CIRCUITS. */
+export declare const MAX_TRACKED_SPAWN_CIRCUITS = 500;
+export declare const SPAWN_CIRCUIT_TTL_MS: number;
+/** Bounded armed-digest map (late toolAfter results must not grow it). */
+export declare const MAX_ARMED_DISPATCH_IDENTITIES = 500;
+/** Frozen denial code — gate-denial-tracker exempts exactly this code. */
+export declare const SPAWN_CIRCUIT_DENIAL_CODE = "SPAWN PROTECTION CIRCUIT OPEN";
+export interface SpawnCircuitEntry {
+    state: 'CLOSED' | 'OPEN' | 'HALF_OPEN';
+    sessionID: string;
+    invocationID: string;
+    actionDigest: string;
+    failureCount: number;
+    openedAt: number;
+    denyUntil: number;
+    /** Denials issued in the current OPEN episode (reset on each OPEN). */
+    denialsInEpisode: number;
+    updatedAt: number;
+}
+export declare function invocationIdForSession(sessionID: string): string;
+/**
+ * Compute the dispatch identity for a tool + args WITHOUT storing anything.
+ * Shared by armDispatchIdentity (before-hook step 0) and by the after-hook
+ * recorder's fallback (which must not re-insert into the bounded armed map
+ * — a stored-but-never-consumed entry would evict legitimate pending
+ * identities under review feedback WD-1).
+ */
+export declare function dispatchIdentityFor(tool: string, args: unknown): {
+    digest: string;
+    pattern: string;
+};
+/**
+ * Arm the pre-mutation dispatch identity for a callID. Step 0 of the
+ * fail-closed tool.execute.before region calls this BEFORE any hook can
+ * mutate `output.args` (skill / delegate-directive injection), so the
+ * toolAfter recorder consumes the SAME digest the circuit was keyed with —
+ * a corrected success can never clear a phantom key (plan Round 1
+ * revision 2).
+ */
+export declare function armDispatchIdentity(callID: string, tool: string, args: unknown): {
+    digest: string;
+    pattern: string;
+};
+/** Consume the armed identity for a callID (fallback: undefined). */
+export declare function takeArmedDispatchIdentity(callID: string): {
+    digest: string;
+    pattern: string;
+} | undefined;
+/**
+ * Record one ACTUAL dispatch failure for the matching action. Returns the
+ * entry and whether this call performed the CLOSED->OPEN transition (the
+ * caller emits exactly one bounded telemetry event on that transition).
+ */
+export declare function noteDispatchSpawnFailure(input: {
+    sessionID: string;
+    invocationID: string;
+    actionDigest: string;
+    threshold: number;
+    halfOpenAfterMs: number;
+    now?: number;
+}): {
+    entry: SpawnCircuitEntry;
+    opened: boolean;
+};
+/**
+ * Deny when the matching action's circuit is OPEN (before its interval
+ * elapses) or when a half-open probe is already in flight. When the open
+ * interval has elapsed, this call is ADMITTED as the single probe.
+ * Throws an Error whose leading token is the frozen
+ * SPAWN_CIRCUIT_DENIAL_CODE so the gate-denial tracker can exempt it.
+ */
+export declare function assertDispatchSpawnCircuitAdmits(input: {
+    sessionID: string;
+    invocationID: string;
+    actionDigest: string;
+    threshold: number;
+    halfOpenAfterMs: number;
+    now?: number;
+}): void;
+/**
+ * A corrected successful execution clears ONLY the matching action's entry
+ * (and closes an in-flight half-open probe). Failures of other actions are
+ * never touched.
+ */
+export declare function noteDispatchSpawnSuccess(input: {
+    sessionID: string;
+    invocationID: string;
+    actionDigest: string;
+}): void;
+export declare function getSpawnCircuitEntry(input: {
+    sessionID: string;
+    invocationID: string;
+    actionDigest: string;
+}): SpawnCircuitEntry | undefined;
+export declare function spawnCircuitIsTaskTool(tool: string): boolean;
+/** Test seam: reset all circuits + armed identities between test files. */
+export declare function _clearAllSpawnCircuits(): void;
+export declare const _internals: {
+    now: () => number;
+};