@parall/claude-agent 1.62.0 → 1.64.0

package/dist/dispatch.d.ts

@@ -1,4 +1,4 @@
-import type { CleanupForkOpts, CompactOpts, CompactResult, DispatchAdapter, DispatchInputLifecycle, DispatchOpts, ForkOpts, GatewayLogger, RuntimeActivityEvent, RuntimeBusyState, RuntimeEvent } from '@parall/agent-core';
+import type { CleanupForkOpts, CompactOpts, CompactResult, DiscardedInjectionOutcome, DispatchAdapter, DispatchInputLifecycle, DispatchOpts, ForkOpts, GatewayLogger, RuntimeActivityEvent, RuntimeBusyState, RuntimeEvent } from '@parall/agent-core';
 import type { ClaudeAgentConfig } from './config.js';
 import { ClaudeInputRegistry } from './input-lifecycle.js';
 import { ClaudeProcessPump } from './process-pump.js';
@@ -18,12 +18,8 @@ type ClaudeCodeAdapterOptions = Pick<ClaudeAgentConfig, 'additionalDirs' | 'allo
     /** @deprecated Use contextFilePathForSession. */
     stepIdFilePathForSession?: (sessionKey: string) => string;
     /**
-     * PRLL_CONTEXT_DIR root for per-lane dispatch context files. Like the
-     * Parall credentials above, this is bridge-static — the long-lived
-     * subprocess env is built ONCE from the placeholder context, so a value
-     * only present on per-dispatch DispatchContexts would never reach the
-     * CLI and every reply would silently lose its lane binding (turns would
-     * resolve no_action instead of reply-effect dedupe).
+     * Bridge-static PRLL_CONTEXT_DIR root: a value only in per-dispatch context
+     * never reaches the long-lived CLI, so replies lose their lane binding.
      */
     contextDirPath?: string;
     /**
@@ -64,6 +60,7 @@ export type ProcessState = {
 export declare class ClaudeCodeAdapter implements DispatchAdapter {
     private readonly opts;
     readonly inputLifecycleMode: "explicit";
+    readonly inputSettlementMode: "receipt";
     private readonly processes;
     /** Retired by abortDispatch while the CLI still had its own work: busy until idle, then terminated. */
     private readonly retiring;
@@ -92,7 +89,19 @@ export declare class ClaudeCodeAdapter implements DispatchAdapter {
     abortDispatch(sessionKey: string): void;
     hasPendingInjections(sessionKey: string): boolean;
     hasUnsettledInjections(sessionKey: string): boolean;
-    acknowledgeDiscardedInjection(sessionKey: string, deliveryKey: string): void;
+    /**
+     * The gateway discarded the buffered copy of an injection without a
+     * dispatch(). A settled injection only owes bookkeeping. One that has NOT
+     * settled is an orphan: nothing will ever drain it, and the CLI does not
+     * start a queued input on its own once the turn it was steered into has
+     * ended — it works its queue only when the next stdin frame arrives, which
+     * would be the batch re-delivering this very member (prod 2026-09-03: lane
+     * dethroned after 10 idle minutes, then "refusing duplicate stdin write"
+     * on every retry). Withdraw it: kill the process (the session survives via
+     * --resume), report the input failed so the server releases the member,
+     * and let the gateway run it as a real turn.
+     */
+    acknowledgeDiscardedInjection(sessionKey: string, deliveryKey: string): Promise<DiscardedInjectionOutcome>;
     dispatch({ event, bodyForAgent, sessionKey, context, inputLifecycle, noteActivity, }: DispatchOpts): AsyncIterable<RuntimeEvent>;
     getBranchPoint(_sessionKey: string): string | undefined;
     getSessionHistoryPath(sessionKey: string): string | undefined;
@@ -129,6 +138,7 @@ export declare class ClaudeCodeAdapter implements DispatchAdapter {
     private maybeApplyRestart;
     private ensureProcess;
     private spawnProcess;
+    /** Resolves once every live input's failed report has settled (best effort). */
     private killProcess;
     private endStdin;
     private terminateHandle;

package/dist/dispatch.d.ts.map

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

package/dist/dispatch.js

@@ -33,6 +33,7 @@ function killWin32Tree(pid) {
 export class ClaudeCodeAdapter {
     opts;
     inputLifecycleMode = 'explicit';
+    inputSettlementMode = 'receipt';
     processes = new Map();
     /** Retired by abortDispatch while the CLI still had its own work: busy until idle, then terminated. */
     retiring = new Set();
@@ -169,16 +170,44 @@ export class ClaudeCodeAdapter {
             return false;
         return state.inputs.hasUnsettledInjections();
     }
-    acknowledgeDiscardedInjection(sessionKey, deliveryKey) {
+    /**
+     * The gateway discarded the buffered copy of an injection without a
+     * dispatch(). A settled injection only owes bookkeeping. One that has NOT
+     * settled is an orphan: nothing will ever drain it, and the CLI does not
+     * start a queued input on its own once the turn it was steered into has
+     * ended — it works its queue only when the next stdin frame arrives, which
+     * would be the batch re-delivering this very member (prod 2026-09-03: lane
+     * dethroned after 10 idle minutes, then "refusing duplicate stdin write"
+     * on every retry). Withdraw it: kill the process (the session survives via
+     * --resume), report the input failed so the server releases the member,
+     * and let the gateway run it as a real turn.
+     */
+    async acknowledgeDiscardedInjection(sessionKey, deliveryKey) {
         const state = this.processes.get(sessionKey);
         if (!state)
-            return;
+            return 'discarded';
+        const delivery = state.inputs.getByKey(deliveryKey);
+        if (delivery && !delivery.terminal) {
+            state.log?.warn?.(`withdrawing orphaned Claude input ${delivery.commandUuid} (${delivery.reportedState ?? 'queued'}) on ${sessionKey}: its buffered copy was discarded before the CLI settled it${state.pump.hasOwnWork() ? '; the runtime-initiated turn dies with the process' : ''}`);
+            await this.killProcess(sessionKey, state);
+            state.inputs.discardBookkeeping(deliveryKey);
+            // 'cancelled' only when the server confirmed the failed receipt: the
+            // member is released and un-folded, so the gateway can re-fold and run
+            // it locally. A lost receipt (reportedState never reached 'failed') or
+            // a 'settled' answer (a reply effect already resolved the member)
+            // leaves nothing to re-run here — the lane complete releases an unread
+            // member for re-drive instead.
+            const confirmed = delivery.reportedState === 'failed' && delivery.terminal === 'failed';
+            if (!confirmed) {
+                state.log?.warn?.(`withdrawal of Claude input ${delivery.commandUuid} was not confirmed by the server (${delivery.terminal}); leaving the member to the lane complete`);
+            }
+            return confirmed ? 'cancelled' : 'discarded';
+        }
         state.inputs.discardBookkeeping(deliveryKey);
         // The discarded copy may have been the last thing a lazy restart was
-        // waiting on. Unlike the consume path's tail, the discarded delivery may
-        // still be RUNNING (non-terminal): killing the process now would fail a
-        // live input, so the restart also waits for every injection to settle.
+        // waiting on.
         this.maybeApplyRestart(sessionKey, state);
+        return 'discarded';
     }
     async *dispatch({ event, bodyForAgent, sessionKey, context, inputLifecycle, noteActivity, }) {
         const deliveryKey = inputLifecycle?.deliveryKey ?? event.dispatchEventId ?? event.messageId;
@@ -246,13 +275,13 @@ export class ClaudeCodeAdapter {
     cleanupFork({ fork }) {
         const state = this.processes.get(fork.sessionKey);
         if (state) {
-            this.killProcess(fork.sessionKey, state);
+            void this.killProcess(fork.sessionKey, state);
         }
         this.opts.sessionManager.cleanupFork(fork.sessionKey);
     }
     resetProcesses() {
         for (const [sessionKey, state] of this.processes) {
-            this.killProcess(sessionKey, state);
+            void this.killProcess(sessionKey, state);
         }
         this.processes.clear();
         const retired = [...this.retiring];
@@ -282,7 +311,10 @@ export class ClaudeCodeAdapter {
         }
         catch (err) {
             try {
-                await lifecycle?.update('failed');
+                await lifecycle?.update('failed', {
+                    outcomeClass: 'runtime_crash',
+                    detail: `Claude spawn failed: ${String(err)}`,
+                });
             }
             catch (reportErr) {
                 log?.warn?.(`failed to report rejected Claude input as failed: ${String(reportErr)}`);
@@ -297,10 +329,10 @@ export class ClaudeCodeAdapter {
             this.writeUserMessage(state.handle, promptBody, delivery.commandUuid);
         }
         catch (err) {
-            await state.inputs.failBestEffort(delivery, log);
+            await state.inputs.failBestEffort(delivery, log, `Claude stdin write failed: ${String(err)}`);
             state.inputs.remove(delivery);
             yield { type: 'error', message: `Claude stdin write failed: ${String(err)}` };
-            this.killProcess(sessionKey, state);
+            void this.killProcess(sessionKey, state);
             return;
         }
         try {
@@ -315,7 +347,9 @@ export class ClaudeCodeAdapter {
         return runClaudeCompact({
             ensureRuntimeCapability: (log) => this.ensureRuntimeCapability(log),
             ensureProcess: (sessionKey, log) => this.ensureProcess(sessionKey, log),
-            killProcess: (sessionKey, state) => this.killProcess(sessionKey, state),
+            killProcess: (sessionKey, state) => {
+                void this.killProcess(sessionKey, state);
+            },
             writeUserMessage: (handle, text, uuid) => this.writeUserMessage(handle, text, uuid),
             applyPendingRestart: (sessionKey, state) => this.maybeApplyRestart(sessionKey, state),
         }, opts);
@@ -448,7 +482,7 @@ export class ClaudeCodeAdapter {
         if (outstanding.total > 0) {
             state.log?.warn?.(`restarting ${sessionKey} with ${outstanding.total} live background task(s); they die with the process`);
         }
-        this.killProcess(sessionKey, state);
+        void this.killProcess(sessionKey, state);
     }
     ensureProcess(sessionKey, log) {
         if (this.shuttingDown) {
@@ -463,7 +497,7 @@ export class ClaudeCodeAdapter {
                     log?.info?.(`deferring lazy restart of ${sessionKey}: runtime-initiated turn in progress`);
                     return existing;
                 }
-                this.killProcess(sessionKey, existing);
+                void this.killProcess(sessionKey, existing);
             }
             else if (alive) {
                 return existing;
@@ -498,7 +532,7 @@ export class ClaudeCodeAdapter {
                     onFatal: () => {
                         const current = this.processes.get(sessionKey);
                         if (current === state)
-                            this.killProcess(sessionKey, state);
+                            void this.killProcess(sessionKey, state);
                     },
                     onEof: () => {
                         state.done = true;
@@ -546,7 +580,8 @@ export class ClaudeCodeAdapter {
         proc.stderr.on('data', (chunk) => {
             stderrChunks.push(chunk.toString());
         });
-        proc.stdin.on('error', () => {
+        proc.stdin.on('error', (err) => {
+            stderrChunks.push(`Claude stdin failed: ${String(err)}\n`);
             proc.stdin.destroy();
             if (proc.exitCode === null && proc.signalCode === null) {
                 if (!IS_WIN32 || !proc.pid || !killWin32Tree(proc.pid)) {
@@ -560,10 +595,12 @@ export class ClaudeCodeAdapter {
         });
         return { proc, exitPromise, stderrChunks };
     }
+    /** Resolves once every live input's failed report has settled (best effort). */
     killProcess(sessionKey, state) {
+        const reports = [];
         for (const delivery of state.inputs.values()) {
             if (!delivery.terminal)
-                void state.inputs.failBestEffort(delivery);
+                reports.push(state.inputs.failBestEffort(delivery, state.log));
         }
         state.done = true;
         const current = this.processes.get(sessionKey);
@@ -572,6 +609,7 @@ export class ClaudeCodeAdapter {
         }
         state.pump.close('killed', 'Claude process terminated by the bridge');
         this.terminateHandle(state.handle);
+        return Promise.all(reports).then(() => undefined);
     }
     endStdin(handle) {
         try {

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import * as os from 'node:os';
-import { capabilityBinDir, childLogger, clearAllProviderCreds, configureHttpKeepAlive, createLogger, createOtelLogger, createPlatformConfigManager, deriveModelIsPin, identityFromMe, initAgentTelemetry, llmSource, resolveServiceVersion, materializeChannelCapabilities, ParallAgentGateway, parseDispatchDeadlineMs, parseForkDeadlineMs, parseProviderConfig, parseShutdownDeadlineMs, resolveRuntimeContextWindow, resolveRuntimeMaxTokens, resolveRuntimeModel, traceContextHeaders, } from '@parall/agent-core';
+import { classifyStartupFailure, capabilityBinDir, childLogger, clearAllProviderCreds, configureHttpKeepAlive, createLogger, createOtelLogger, createPlatformConfigManager, deriveModelIsPin, identityFromMe, initAgentTelemetry, llmSource, resolveServiceVersion, materializeChannelCapabilities, ParallAgentGateway, parseDispatchDeadlineMs, parseForkDeadlineMs, parseProviderConfig, parseShutdownDeadlineMs, resolveRuntimeContextWindow, resolveRuntimeMaxTokens, resolveRuntimeModel, traceContextHeaders, newRuntimeInstanceId, } from '@parall/agent-core';
 import { ApiError, ParallClient, ParallWs } from '@parall/sdk';
 import { buildClaudeRuntimeKey, contextFilePathForSession, dispatchContextDirPath, resolveClaudeAgentConfig, resolveWsUrl, sessionStateFilePathForRuntime, stepIdFilePathForSession, } from './config.js';
 import { ClaudeCodeAdapter } from './dispatch.js';
@@ -84,8 +84,12 @@ async function main() {
         const sessionStateFilePath = sessionStateFilePathForRuntime(config.stateDir, runtimeKey);
         const sessionManager = new ClaudeSessionManager(runtimeKey, sessionStateFilePath, agentLog);
         const resolvedWsUrl = resolveWsUrl(config.apiUrl, config.wsUrl, config.swimlaneName);
+        // This process's runtime instance: rides the WS ticket and every claim so
+        // the server owns turns by process identity instead of a lease clock
+        // (agent-dispatch-idempotency-design.md#instance-ownership).
+        const instanceId = newRuntimeInstanceId();
         const ws = new ParallWs({
-            getTicket: () => client.getWsTicket(),
+            getTicket: () => client.getWsTicket({ instance_id: instanceId }),
             wsUrl: resolvedWsUrl,
         });
         const configMgr = createPlatformConfigManager({
@@ -237,6 +241,7 @@ async function main() {
             accountId: agentUserId,
             client,
             ws,
+            instanceId,
             connectionLabel: resolvedWsUrl,
             config: {
                 parall_url: config.apiUrl,
@@ -300,6 +305,19 @@ async function main() {
     }
 }
 main().catch((err) => {
-    activeLog.error(`fatal: ${String(err)}`);
-    process.exitCode = 1;
+    // A credential the server rejects during bootstrap is the same terminal
+    // failure the gateway reports as auth-invalid: exit with the re-mint code
+    // so the daemon mints a fresh launch credential instead of restarting
+    // this process with the same dead key.
+    const { exitCode, authRejection } = classifyStartupFailure(err);
+    if (authRejection) {
+        activeLog.error(`AUTH-INVALID at startup status=${authRejection.status}` +
+            `${authRejection.code ? ` code=${authRejection.code}` : ''} — ` +
+            `the server rejected this runtime's credential (${authRejection.message}); ` +
+            `exiting with code ${exitCode} so the supervisor can re-mint the launch credential.`);
+    }
+    else {
+        activeLog.error(`fatal: ${String(err)}`);
+    }
+    process.exitCode = exitCode;
 });

package/dist/input-lifecycle.d.ts

@@ -63,8 +63,8 @@ export declare class ClaudeInputRegistry {
      */
     discardBookkeeping(deliveryKey: string): void;
     apply(delivery: ClaudeInputDelivery, state: 'queued' | 'started' | 'completed' | 'cancelled' | 'discarded'): Promise<void>;
-    fail(delivery: ClaudeInputDelivery): Promise<void>;
-    failBestEffort(delivery: ClaudeInputDelivery, log?: GatewayLogger): Promise<void>;
-    failAllBestEffort(log?: GatewayLogger): Promise<void>;
+    fail(delivery: ClaudeInputDelivery, detail?: string): Promise<void>;
+    failBestEffort(delivery: ClaudeInputDelivery, log?: GatewayLogger, detail?: string): Promise<void>;
+    failAllBestEffort(log?: GatewayLogger, detail?: string): Promise<void>;
 }
 //# sourceMappingURL=input-lifecycle.d.ts.map

package/dist/input-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-lifecycle.d.ts","sourceRoot":"","sources":["../src/input-lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACnG,OAAO,EACL,KAAK,cAAc,EAGnB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC9C,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,YAAY,EAAE,OAAO,CAAC;IACtB,kFAAkF;IAClF,IAAI,EAAE,cAAc,CAAC;IACrB,uEAAuE;IACvE,QAAQ,EAAE,YAAY,CAAC;IACvB,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,8DAA8D;IAC9D,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IAEpE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAI9D,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIlE,eAAe,CAAC,gBAAgB,EAAE,MAAM,EAAE,GAAG,mBAAmB,GAAG,SAAS;IAU5E,MAAM,IAAI,gBAAgB,CAAC,mBAAmB,CAAC;IAI/C,oBAAoB,IAAI,OAAO;IAI/B;;;;;;;;;OASG;IACH,sBAAsB,IAAI,OAAO;IAIjC,QAAQ,CACN,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,sBAAsB,GAAG,SAAS,EAC7C,QAAQ,EAAE,OAAO,EACjB,YAAY,CAAC,EAAE,MAAM,IAAI,EACzB,GAAG,CAAC,EAAE,aAAa,GAClB,mBAAmB;IAsBtB,MAAM,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAY3C;;;;;;;;OAQG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAOvC,KAAK,CACT,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GACpE,OAAO,CAAC,IAAI,CAAC;IA0BV,IAAI,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBlD,cAAc,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjF,iBAAiB,CAAC,GAAG,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAO5D"}
+{"version":3,"file":"input-lifecycle.d.ts","sourceRoot":"","sources":["../src/input-lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEnG,OAAO,EACL,KAAK,cAAc,EAGnB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC9C,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,YAAY,EAAE,OAAO,CAAC;IACtB,kFAAkF;IAClF,IAAI,EAAE,cAAc,CAAC;IACrB,uEAAuE;IACvE,QAAQ,EAAE,YAAY,CAAC;IACvB,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,8DAA8D;IAC9D,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IAEpE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAI9D,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIlE,eAAe,CAAC,gBAAgB,EAAE,MAAM,EAAE,GAAG,mBAAmB,GAAG,SAAS;IAU5E,MAAM,IAAI,gBAAgB,CAAC,mBAAmB,CAAC;IAI/C,oBAAoB,IAAI,OAAO;IAI/B;;;;;;;;;OASG;IACH,sBAAsB,IAAI,OAAO;IAIjC,QAAQ,CACN,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,sBAAsB,GAAG,SAAS,EAC7C,QAAQ,EAAE,OAAO,EACjB,YAAY,CAAC,EAAE,MAAM,IAAI,EACzB,GAAG,CAAC,EAAE,aAAa,GAClB,mBAAmB;IAsBtB,MAAM,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAY3C;;;;;;;;OAQG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAOvC,KAAK,CACT,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GACpE,OAAO,CAAC,IAAI,CAAC;IA0BV,IAAI,CAAC,QAAQ,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BnE,cAAc,CAClB,QAAQ,EAAE,mBAAmB,EAC7B,GAAG,CAAC,EAAE,aAAa,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAUV,iBAAiB,CAAC,GAAG,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAO7E"}

package/dist/input-lifecycle.js

@@ -1,4 +1,5 @@
 import { randomUUID } from 'node:crypto';
+import { classifyClaudeTurn } from './turn-outcome.js';
 import { newTurnEvidence, newTurnSink, } from './turn-sink.js';
 /**
  * Per-process registry that maps Parall WorkItem batches to Claude stdin
@@ -116,7 +117,7 @@ export class ClaudeInputRegistry {
         if (delivery.drained)
             this.remove(delivery);
     }
-    async fail(delivery) {
+    async fail(delivery, detail) {
         if (delivery.terminal)
             return;
         if (delivery.suppressFailReport) {
@@ -127,7 +128,13 @@ export class ClaudeInputRegistry {
         }
         try {
             if (delivery.reportedState !== 'failed') {
-                const result = await delivery.lifecycle?.update('failed');
+                const classified = classifyClaudeTurn(delivery.evidence.lastResultMeta, delivery.evidence.noticeTexts);
+                const result = await delivery.lifecycle?.update('failed', {
+                    outcomeClass: classified.outcome === 'ok' || classified.outcome === 'usage_limit'
+                        ? 'runtime_crash'
+                        : classified.outcome,
+                    detail: detail ?? classified.detail ?? 'Claude input failed',
+                });
                 delivery.reportedState = 'failed';
                 delivery.terminal = result?.retry === false ? 'settled' : 'failed';
             }
@@ -138,17 +145,17 @@ export class ClaudeInputRegistry {
                 this.remove(delivery);
         }
     }
-    async failBestEffort(delivery, log) {
+    async failBestEffort(delivery, log, detail) {
         try {
-            await this.fail(delivery);
+            await this.fail(delivery, detail);
         }
         catch (err) {
             log?.warn?.(`failed to report Claude input ${delivery.commandUuid} as failed: ${String(err)}`);
         }
     }
-    async failAllBestEffort(log) {
+    async failAllBestEffort(log, detail) {
         await Promise.all([...this.byKey.values()]
             .filter((delivery) => !delivery.terminal)
-            .map((delivery) => this.failBestEffort(delivery, log)));
+            .map((delivery) => this.failBestEffort(delivery, log, detail)));
     }
 }

package/dist/process-pump.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-pump.d.ts","sourceRoot":"","sources":["../src/process-pump.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"process-pump.d.ts","sourceRoot":"","sources":["../src/process-pump.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EAEtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,KAAK,EAAE,iBAAiB,EAA0B,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,KAAK,EAAE,mBAAmB,EAAgC,MAAM,gBAAgB,CAAC;AAKxF,MAAM,MAAM,sBAAsB,GAAG;IACnC,oFAAoF;IACpF,aAAa,CAAC,IAAI,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,MAAM,GAAG,SAAS,CAAC;IACxF,mEAAmE;IACnE,OAAO,IAAI,IAAI,CAAC;IAChB,yCAAyC;IACzC,KAAK,IAAI,IAAI,CAAC;IACd,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnD,mBAAmB,IAAI,IAAI,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAC1C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,sBAAsB,CAAC;IAC9B,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,iBAAiB;IAWhB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAVjC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,YAAY,cAAyC;IACrD,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IAC7C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEN,IAAI,EAAE,wBAAwB;IAK3D,KAAK,IAAI,IAAI;IAIb,+EAA+E;IAC/E,cAAc,CAAC,QAAQ,EAAE,mBAAmB,EAAE,YAAY,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;IAK9E,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAIrD,kBAAkB,IAAI,OAAO;IAK7B;;;;;OAKG;IACH,UAAU,CAAC,GAAG,SAAa,GAAG,OAAO;IAIrC,SAAS,CAAC,GAAG,SAAa,GAAG,gBAAgB;IAU7C,sEAAsE;IACtE,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQtC;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAYzD;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAK9B,OAAO,CAAC,SAAS;IA0BjB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;YAevD,GAAG;YAeH,KAAK;IAkDnB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,eAAe;IAkCvB,OAAO,CAAC,UAAU;YAsBJ,eAAe;IA8C7B,OAAO,CAAC,UAAU;YA6BJ,aAAa;IA8C3B,OAAO,CAAC,qBAAqB;YAOf,SAAS;CA0BxB"}

package/dist/process-pump.js

@@ -321,6 +321,9 @@ export class ClaudeProcessPump {
                 kind: 'runtime',
                 event: { type: 'error', message: `Claude input lifecycle update failed: ${String(err)}` },
             });
+            // failBestEffort may unregister this delivery before onFatal closes
+            // the process's remaining sinks. Its waiting drain still needs EOF.
+            delivery.sink.close();
             this.opts.hooks.onFatal();
             return;
         }
@@ -417,8 +420,11 @@ export class ClaudeProcessPump {
             if (!delivery.terminal && settledAsLimit(delivery.evidence))
                 delivery.suppressFailReport = true;
         }
-        await inputs.failAllBestEffort(log);
-        for (const delivery of inputs.values()) {
+        // Failing removes drained deliveries from the registry. Their sinks must
+        // still receive EOF, or a startup failure waits for the dispatch timeout.
+        const deliveries = [...inputs.values()];
+        await inputs.failAllBestEffort(log, message);
+        for (const delivery of deliveries) {
             delivery.sink.push({ kind: 'ended', reason: 'eof', message });
             delivery.sink.close();
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/claude-agent",
-  "version": "1.62.0",
+  "version": "1.64.0",
   "description": "Claude Code bridge runtime for self-hosted Parall agents",
   "license": "MIT",
   "repository": {
@@ -25,9 +25,9 @@
     "src"
   ],
   "dependencies": {
-    "@parall/agent-core": "1.62.0",
-    "@parall/cli": "1.62.0",
-    "@parall/sdk": "1.62.0"
+    "@parall/agent-core": "1.64.0",
+    "@parall/cli": "1.64.0",
+    "@parall/sdk": "1.64.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/dispatch.ts

@@ -6,6 +6,7 @@ import type {
   CleanupForkOpts,
   CompactOpts,
   CompactResult,
+  DiscardedInjectionOutcome,
   DispatchAdapter,
   DispatchInputLifecycle,
   DispatchOpts,
@@ -57,12 +58,8 @@ type ClaudeCodeAdapterOptions = Pick<
   /** @deprecated Use contextFilePathForSession. */
   stepIdFilePathForSession?: (sessionKey: string) => string;
   /**
-   * PRLL_CONTEXT_DIR root for per-lane dispatch context files. Like the
-   * Parall credentials above, this is bridge-static — the long-lived
-   * subprocess env is built ONCE from the placeholder context, so a value
-   * only present on per-dispatch DispatchContexts would never reach the
-   * CLI and every reply would silently lose its lane binding (turns would
-   * resolve no_action instead of reply-effect dedupe).
+   * Bridge-static PRLL_CONTEXT_DIR root: a value only in per-dispatch context
+   * never reaches the long-lived CLI, so replies lose their lane binding.
    */
   contextDirPath?: string;
   /**
@@ -123,6 +120,7 @@ export type ProcessState = {
 
 export class ClaudeCodeAdapter implements DispatchAdapter {
   readonly inputLifecycleMode = 'explicit' as const;
+  readonly inputSettlementMode = 'receipt' as const;
   private readonly processes = new Map<string, ProcessState>();
   /** Retired by abortDispatch while the CLI still had its own work: busy until idle, then terminated. */
   private readonly retiring = new Set<ProcessState>();
@@ -264,15 +262,50 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
     return state.inputs.hasUnsettledInjections();
   }
 
-  acknowledgeDiscardedInjection(sessionKey: string, deliveryKey: string): void {
+  /**
+   * The gateway discarded the buffered copy of an injection without a
+   * dispatch(). A settled injection only owes bookkeeping. One that has NOT
+   * settled is an orphan: nothing will ever drain it, and the CLI does not
+   * start a queued input on its own once the turn it was steered into has
+   * ended — it works its queue only when the next stdin frame arrives, which
+   * would be the batch re-delivering this very member (prod 2026-09-03: lane
+   * dethroned after 10 idle minutes, then "refusing duplicate stdin write"
+   * on every retry). Withdraw it: kill the process (the session survives via
+   * --resume), report the input failed so the server releases the member,
+   * and let the gateway run it as a real turn.
+   */
+  async acknowledgeDiscardedInjection(
+    sessionKey: string,
+    deliveryKey: string,
+  ): Promise<DiscardedInjectionOutcome> {
     const state = this.processes.get(sessionKey);
-    if (!state) return;
+    if (!state) return 'discarded';
+    const delivery = state.inputs.getByKey(deliveryKey);
+    if (delivery && !delivery.terminal) {
+      state.log?.warn?.(
+        `withdrawing orphaned Claude input ${delivery.commandUuid} (${delivery.reportedState ?? 'queued'}) on ${sessionKey}: its buffered copy was discarded before the CLI settled it${state.pump.hasOwnWork() ? '; the runtime-initiated turn dies with the process' : ''}`,
+      );
+      await this.killProcess(sessionKey, state);
+      state.inputs.discardBookkeeping(deliveryKey);
+      // 'cancelled' only when the server confirmed the failed receipt: the
+      // member is released and un-folded, so the gateway can re-fold and run
+      // it locally. A lost receipt (reportedState never reached 'failed') or
+      // a 'settled' answer (a reply effect already resolved the member)
+      // leaves nothing to re-run here — the lane complete releases an unread
+      // member for re-drive instead.
+      const confirmed = delivery.reportedState === 'failed' && delivery.terminal === 'failed';
+      if (!confirmed) {
+        state.log?.warn?.(
+          `withdrawal of Claude input ${delivery.commandUuid} was not confirmed by the server (${delivery.terminal}); leaving the member to the lane complete`,
+        );
+      }
+      return confirmed ? 'cancelled' : 'discarded';
+    }
     state.inputs.discardBookkeeping(deliveryKey);
     // The discarded copy may have been the last thing a lazy restart was
-    // waiting on. Unlike the consume path's tail, the discarded delivery may
-    // still be RUNNING (non-terminal): killing the process now would fail a
-    // live input, so the restart also waits for every injection to settle.
+    // waiting on.
     this.maybeApplyRestart(sessionKey, state);
+    return 'discarded';
   }
 
   async *dispatch({
@@ -364,14 +397,14 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
   cleanupFork({ fork }: CleanupForkOpts) {
     const state = this.processes.get(fork.sessionKey);
     if (state) {
-      this.killProcess(fork.sessionKey, state);
+      void this.killProcess(fork.sessionKey, state);
     }
     this.opts.sessionManager.cleanupFork(fork.sessionKey);
   }
 
   resetProcesses(): void {
     for (const [sessionKey, state] of this.processes) {
-      this.killProcess(sessionKey, state);
+      void this.killProcess(sessionKey, state);
     }
     this.processes.clear();
     const retired = [...this.retiring];
@@ -410,7 +443,10 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
       state = this.ensureProcess(sessionKey, log);
     } catch (err) {
       try {
-        await lifecycle?.update('failed');
+        await lifecycle?.update('failed', {
+          outcomeClass: 'runtime_crash',
+          detail: `Claude spawn failed: ${String(err)}`,
+        });
       } catch (reportErr) {
         log?.warn?.(`failed to report rejected Claude input as failed: ${String(reportErr)}`);
       }
@@ -423,10 +459,10 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
     try {
       this.writeUserMessage(state.handle, promptBody, delivery.commandUuid);
     } catch (err) {
-      await state.inputs.failBestEffort(delivery, log);
+      await state.inputs.failBestEffort(delivery, log, `Claude stdin write failed: ${String(err)}`);
       state.inputs.remove(delivery);
       yield { type: 'error', message: `Claude stdin write failed: ${String(err)}` };
-      this.killProcess(sessionKey, state);
+      void this.killProcess(sessionKey, state);
       return;
     }
 
@@ -443,7 +479,9 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
       {
         ensureRuntimeCapability: (log) => this.ensureRuntimeCapability(log),
         ensureProcess: (sessionKey, log) => this.ensureProcess(sessionKey, log),
-        killProcess: (sessionKey, state) => this.killProcess(sessionKey, state),
+        killProcess: (sessionKey, state) => {
+          void this.killProcess(sessionKey, state);
+        },
         writeUserMessage: (handle, text, uuid) => this.writeUserMessage(handle, text, uuid),
         applyPendingRestart: (sessionKey, state) => this.maybeApplyRestart(sessionKey, state),
       },
@@ -584,7 +622,7 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
         `restarting ${sessionKey} with ${outstanding.total} live background task(s); they die with the process`,
       );
     }
-    this.killProcess(sessionKey, state);
+    void this.killProcess(sessionKey, state);
   }
 
   private ensureProcess(sessionKey: string, log: GatewayLogger | undefined): ProcessState {
@@ -603,7 +641,7 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
           );
           return existing;
         }
-        this.killProcess(sessionKey, existing);
+        void this.killProcess(sessionKey, existing);
       } else if (alive) {
         return existing;
       } else {
@@ -636,7 +674,7 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
           },
           onFatal: () => {
             const current = this.processes.get(sessionKey);
-            if (current === state) this.killProcess(sessionKey, state);
+            if (current === state) void this.killProcess(sessionKey, state);
           },
           onEof: () => {
             state.done = true;
@@ -704,7 +742,8 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
     proc.stderr.on('data', (chunk: Buffer) => {
       stderrChunks.push(chunk.toString());
     });
-    proc.stdin.on('error', () => {
+    proc.stdin.on('error', (err) => {
+      stderrChunks.push(`Claude stdin failed: ${String(err)}\n`);
       proc.stdin.destroy();
       if (proc.exitCode === null && proc.signalCode === null) {
         if (!IS_WIN32 || !proc.pid || !killWin32Tree(proc.pid)) {
@@ -723,9 +762,11 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
     return { proc, exitPromise, stderrChunks };
   }
 
-  private killProcess(sessionKey: string, state: ProcessState) {
+  /** Resolves once every live input's failed report has settled (best effort). */
+  private killProcess(sessionKey: string, state: ProcessState): Promise<void> {
+    const reports: Promise<void>[] = [];
     for (const delivery of state.inputs.values()) {
-      if (!delivery.terminal) void state.inputs.failBestEffort(delivery);
+      if (!delivery.terminal) reports.push(state.inputs.failBestEffort(delivery, state.log));
     }
     state.done = true;
     const current = this.processes.get(sessionKey);
@@ -734,6 +775,7 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
     }
     state.pump.close('killed', 'Claude process terminated by the bridge');
     this.terminateHandle(state.handle);
+    return Promise.all(reports).then(() => undefined);
   }
 
   private endStdin(handle: ClaudeProcessHandle): void {

package/src/index.ts

@@ -2,6 +2,7 @@
 
 import * as os from 'node:os';
 import {
+  classifyStartupFailure,
   capabilityBinDir,
   childLogger,
   clearAllProviderCreds,
@@ -24,6 +25,7 @@ import {
   resolveRuntimeMaxTokens,
   resolveRuntimeModel,
   traceContextHeaders,
+  newRuntimeInstanceId,
 } from '@parall/agent-core';
 import { ApiError, ParallClient, ParallWs } from '@parall/sdk';
 import {
@@ -124,8 +126,12 @@ async function main() {
     const sessionManager = new ClaudeSessionManager(runtimeKey, sessionStateFilePath, agentLog);
 
     const resolvedWsUrl = resolveWsUrl(config.apiUrl, config.wsUrl, config.swimlaneName);
+    // This process's runtime instance: rides the WS ticket and every claim so
+    // the server owns turns by process identity instead of a lease clock
+    // (agent-dispatch-idempotency-design.md#instance-ownership).
+    const instanceId = newRuntimeInstanceId();
     const ws = new ParallWs({
-      getTicket: () => client.getWsTicket(),
+      getTicket: () => client.getWsTicket({ instance_id: instanceId }),
       wsUrl: resolvedWsUrl,
     });
 
@@ -299,6 +305,7 @@ async function main() {
       accountId: agentUserId,
       client,
       ws,
+      instanceId,
       connectionLabel: resolvedWsUrl,
       config: {
         parall_url: config.apiUrl,
@@ -365,6 +372,20 @@ async function main() {
 }
 
 main().catch((err) => {
-  activeLog.error(`fatal: ${String(err)}`);
-  process.exitCode = 1;
+  // A credential the server rejects during bootstrap is the same terminal
+  // failure the gateway reports as auth-invalid: exit with the re-mint code
+  // so the daemon mints a fresh launch credential instead of restarting
+  // this process with the same dead key.
+  const { exitCode, authRejection } = classifyStartupFailure(err);
+  if (authRejection) {
+    activeLog.error(
+      `AUTH-INVALID at startup status=${authRejection.status}` +
+        `${authRejection.code ? ` code=${authRejection.code}` : ''} — ` +
+        `the server rejected this runtime's credential (${authRejection.message}); ` +
+        `exiting with code ${exitCode} so the supervisor can re-mint the launch credential.`,
+    );
+  } else {
+    activeLog.error(`fatal: ${String(err)}`);
+  }
+  process.exitCode = exitCode;
 });

package/src/input-lifecycle.ts

@@ -1,5 +1,6 @@
 import { randomUUID } from 'node:crypto';
 import type { DispatchInputLifecycle, GatewayLogger, RuntimeInputState } from '@parall/agent-core';
+import { classifyClaudeTurn } from './turn-outcome.js';
 import {
   type ClaudeTurnSink,
   newTurnEvidence,
@@ -168,7 +169,7 @@ export class ClaudeInputRegistry {
     if (delivery.drained) this.remove(delivery);
   }
 
-  async fail(delivery: ClaudeInputDelivery): Promise<void> {
+  async fail(delivery: ClaudeInputDelivery, detail?: string): Promise<void> {
     if (delivery.terminal) return;
     if (delivery.suppressFailReport) {
       delivery.terminal = 'settled';
@@ -177,7 +178,17 @@ export class ClaudeInputRegistry {
     }
     try {
       if (delivery.reportedState !== 'failed') {
-        const result = await delivery.lifecycle?.update('failed');
+        const classified = classifyClaudeTurn(
+          delivery.evidence.lastResultMeta,
+          delivery.evidence.noticeTexts,
+        );
+        const result = await delivery.lifecycle?.update('failed', {
+          outcomeClass:
+            classified.outcome === 'ok' || classified.outcome === 'usage_limit'
+              ? 'runtime_crash'
+              : classified.outcome,
+          detail: detail ?? classified.detail ?? 'Claude input failed',
+        });
         delivery.reportedState = 'failed';
         delivery.terminal = result?.retry === false ? 'settled' : 'failed';
       }
@@ -187,9 +198,13 @@ export class ClaudeInputRegistry {
     }
   }
 
-  async failBestEffort(delivery: ClaudeInputDelivery, log?: GatewayLogger): Promise<void> {
+  async failBestEffort(
+    delivery: ClaudeInputDelivery,
+    log?: GatewayLogger,
+    detail?: string,
+  ): Promise<void> {
     try {
-      await this.fail(delivery);
+      await this.fail(delivery, detail);
     } catch (err) {
       log?.warn?.(
         `failed to report Claude input ${delivery.commandUuid} as failed: ${String(err)}`,
@@ -197,11 +212,11 @@ export class ClaudeInputRegistry {
     }
   }
 
-  async failAllBestEffort(log?: GatewayLogger): Promise<void> {
+  async failAllBestEffort(log?: GatewayLogger, detail?: string): Promise<void> {
     await Promise.all(
       [...this.byKey.values()]
         .filter((delivery) => !delivery.terminal)
-        .map((delivery) => this.failBestEffort(delivery, log)),
+        .map((delivery) => this.failBestEffort(delivery, log, detail)),
     );
   }
 }

package/src/process-pump.ts

@@ -361,6 +361,9 @@ export class ClaudeProcessPump {
         kind: 'runtime',
         event: { type: 'error', message: `Claude input lifecycle update failed: ${String(err)}` },
       });
+      // failBestEffort may unregister this delivery before onFatal closes
+      // the process's remaining sinks. Its waiting drain still needs EOF.
+      delivery.sink.close();
       this.opts.hooks.onFatal();
       return;
     }
@@ -470,8 +473,11 @@ export class ClaudeProcessPump {
       if (!delivery.terminal && settledAsLimit(delivery.evidence))
         delivery.suppressFailReport = true;
     }
-    await inputs.failAllBestEffort(log);
-    for (const delivery of inputs.values()) {
+    // Failing removes drained deliveries from the registry. Their sinks must
+    // still receive EOF, or a startup failure waits for the dispatch timeout.
+    const deliveries = [...inputs.values()];
+    await inputs.failAllBestEffort(log, message);
+    for (const delivery of deliveries) {
       delivery.sink.push({ kind: 'ended', reason: 'eof', message });
       delivery.sink.close();
     }