@excitedjs/agent-runtime-claude-code 0.5.0 → 0.6.0-alpha.gfd00db650f43

package/dist/runtime.d.ts

@@ -1,15 +1,14 @@
 /** Resident Claude Code AgentRuntime using stream-json stdio. */
 import type { ClaudeCodeRuntimeDeps } from './runtime-deps.js';
-import type { AgentRuntimeCapabilities, AgentRuntime, AgentRuntimeIdentity, AgentRuntimeStatus, AgentRuntimeTextInput, InboundTurnInput, RuntimeAdmission } from '@excitedjs/dreamux-types';
+import type { AgentRuntime, AgentRuntimeIdentity, AgentRuntimeSessionRef, AgentRuntimeStartOutcome, AgentRuntimeSubmissionInput, RuntimeAdmission } from '@excitedjs/dreamux-types';
 /**
  * The Claude Code agent runtime for one dispatcher. A single resident
  * stream-json child serves every turn. Turns run serially (one at a time) and
- * `channelInput` returns after the message is accepted — not after the turn
+ * `submit` returns after the message is accepted — not after the turn
  * completes — matching the Codex runtime's submit-then-serialize contract.
  */
 export declare class ClaudeCodeRuntime implements AgentRuntime {
     private readonly deps;
-    readonly providerRef = "builtin:claude-code";
     private readonly dispatcherId;
     private readonly config;
     private readonly bin;
@@ -20,17 +19,16 @@ export declare class ClaudeCodeRuntime implements AgentRuntime {
     private readonly logger;
     private status;
     private threadId;
-    private transcriptLocator;
     private resumeOnNextSpawn;
-    private resumed;
+    private readonly resumed;
+    /**
+     * The provider-local fatal path for authoritative state writes. Any failure
+     * to persist — a revoked lease or a plain write failure — fences input and
+     * tears the resident child down; the runtime never continues on a state
+     * record it could not update.
+     */
+    private readonly fence;
     private stopped;
-    private readonly seen;
-    private readonly seenOrder;
-    private readonly seenTextInputIds;
-    private readonly seenTextInputIdOrder;
-    private readonly sourceIdDedupeWindow;
-    private readonly pendingChannelSources;
-    private readonly pendingTextSources;
     private readonly pendingAdmissions;
     private queue;
     private session;
@@ -40,32 +38,35 @@ export declare class ClaudeCodeRuntime implements AgentRuntime {
     private generation;
     private activeTurn;
     private queuedTurnCount;
-    private idlePromise;
-    private idleResolve;
-    constructor(identity: AgentRuntimeIdentity, deps: ClaudeCodeRuntimeDeps);
-    getStatus(): AgentRuntimeStatus;
-    getCapabilities(): AgentRuntimeCapabilities;
-    getCheckpoint(): {
-        id: string;
-        transcript_locator?: string | null;
-    } | null;
-    wasCheckpointResumed(): boolean;
-    getContext(): Promise<null>;
-    resume(): Promise<void>;
-    start(): Promise<void>;
+    constructor(identity: AgentRuntimeIdentity<AgentRuntimeSessionRef>, deps: ClaudeCodeRuntimeDeps);
+    start(): Promise<AgentRuntimeStartOutcome>;
+    /**
+     * Recovery is continuous by contract: when a prior session exists the child is
+     * always spawned with `--resume`, and a failed resume propagates out of
+     * `start` rather than silently becoming a fresh session.
+     */
     private startRuntime;
+    private startOutcome;
     stop(): Promise<void>;
+    /** Single-flight the stop task, releasing the slot so a failure can retry. */
+    private track;
+    /**
+     * Converge a stop that arrived after the fence already started the fatal
+     * teardown. A teardown that succeeded left the runtime stopped; one that
+     * failed retained the resident session, so this retries against that retained
+     * authority and rejects if the retry fails too.
+     */
+    private stopAfterFatalTeardown;
     private stopRuntime;
-    completionInput(input: AgentRuntimeTextInput): Promise<RuntimeAdmission>;
-    private completionInputImpl;
-    private acceptTextInput;
-    channelInput(input: InboundTurnInput): Promise<RuntimeAdmission>;
-    private channelInputImpl;
-    private acceptChannelInput;
+    /**
+     * Admit one already-rendered submission. The runtime holds no source ledger:
+     * the text is the complete model-facing message, and deduplication is Core's,
+     * ahead of this call.
+     */
+    submit(input: AgentRuntimeSubmissionInput): Promise<RuntimeAdmission>;
     private acceptInput;
     private trackAdmission;
     private drainAdmissions;
-    waitIdle(): Promise<void>;
     private runActiveTurnOnQueue;
     private runActiveTurn;
     private steerActiveTurn;
@@ -74,15 +75,47 @@ export declare class ClaudeCodeRuntime implements AgentRuntime {
     private stopUnsettled;
     private recordQueuedTurnStart;
     private recordQueuedTurnEnd;
-    private resolveIdleWaitersIfIdle;
     /** Ensure a live resident session exists, resuming after a child exit. */
     private ensureSession;
     private createSession;
-    private resolveTranscriptPath;
     /** React to an unexpected resident-child exit: degrade and drop the session. */
     private onSessionExit;
     private onProtocolEvent;
     private assertGeneration;
+    /**
+     * The fence's native teardown. Deliberately not `stop()`: `stop()` publishes
+     * `stopping`/`stopped` through the very sink that just proved unusable, so it
+     * would only produce a second failure. This closes the resident child and
+     * settles in-flight work, and nothing else.
+     *
+     * It runs synchronously up to its first await, so `stopped` and the bumped
+     * generation fence input immediately — a submit arriving after the fatal
+     * write is already refused.
+     */
+    private terminateForFence;
+    private publishStatus;
+    /**
+     * Persist a status the caller's own outcome does not depend on, but whose
+     * ordering does: `stop` must not resolve before its terminal write lands,
+     * because Core keeps this generation's lease valid exactly until stop
+     * settles and a detached write would race the revocation that follows.
+     *
+     * The error is not rethrown. The fence has already made it terminal, and
+     * these callers report something else — whether the child terminated, or the
+     * original start failure — which a state-write failure does not change.
+     */
+    private settleStatus;
+    /**
+     * Record a status on the background paths (turn failure, child exit).
+     *
+     * Core's durable state is the authority; this field is only the runtime's own
+     * lifecycle guard, and it is updated first so the guard stays correct even as
+     * the fence closes. The write itself is detached: it
+     * must not surface as an unhandled rejection on the shared event loop (#85),
+     * and a failure is already terminal through the fence, so there is nothing
+     * left for this caller to do about it. The start path awaits `publishStatus`
+     * instead, because the ready state must be durable before `start` resolves.
+     */
     private setStatus;
     private log;
 }

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAgBjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAS/D,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EAExB,2BAA2B,EAE3B,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAMlC;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IAoClD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAnCvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAGnB;IACH,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAwC;IAC1E,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,eAAe,CAA2C;IAClE,OAAO,CAAC,SAAS,CAAkD;IACnE,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,eAAe,CAAK;gBAG1B,QAAQ,EAAE,oBAAoB,CAAC,sBAAsB,CAAC,EACrC,IAAI,EAAE,qBAAqB;IA4B9C,KAAK,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAe1C;;;;OAIG;YACW,YAAY;IA6B1B,OAAO,CAAC,YAAY;IAMd,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,8EAA8E;IAC9E,OAAO,CAAC,KAAK;IAQb;;;;;OAKG;YACW,sBAAsB;YA2BtB,WAAW;IAiBzB;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAIvD,WAAW;IA8CzB,OAAO,CAAC,cAAc;YAUR,eAAe;IAM7B,OAAO,CAAC,oBAAoB;YAYd,aAAa;YAwBb,eAAe;IAyB7B,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,mBAAmB;IAI3B,0EAA0E;YAC5D,aAAa;YAab,aAAa;IA6E3B,gFAAgF;YAClE,aAAa;IAmB3B,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,gBAAgB;IAMxB;;;;;;;;;OASG;YACW,iBAAiB;YAiBjB,aAAa;IAY3B;;;;;;;;;OASG;YACW,YAAY;IAW1B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,GAAG;CAOZ"}