@parall/claude-agent 1.45.0 → 1.46.0

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

@@ -5,6 +5,10 @@ import { execSync, spawn } from 'node:child_process';
 import { appendPreparedLocalAttachmentRefs, pinLocalAttachmentPaths, } from '@parall/agent-core/internal/attachment-input';
 import { parseClaudeStreamJson } from './output-parser.js';
 const IS_WIN32 = process.platform === 'win32';
+// Upper bound on spurious empty turn_end frames skipped per turn (see the
+// guard in runTurn) — keeps a pathological stream of empty `result` frames
+// from spinning the drain loop forever.
+const MAX_SPURIOUS_TURN_END_SKIPS = 3;
 function quoteWin32Arg(arg) {
     if (!/[\s"&|^<>()]/.test(arg))
         return arg;
@@ -293,6 +297,17 @@ export class ClaudeCodeAdapter {
         }
         const groupKey = randomUUID();
         let sawError = false;
+        // Poison-frame guard. When `--resume` (with or without `--fork-session`)
+        // targets a transcript whose tail is dangling (previous process was
+        // killed mid-turn — exactly the fork-on-busy case), Claude CLI emits a
+        // spurious EMPTY result frame (num_turns: 0) at startup, BEFORE the
+        // queued stdin user frame is processed. Treating its turn_end as the
+        // dispatch boundary returns with zero output, the work item sweeps as
+        // no_action, and the real reply is orphaned in a soon-to-be-killed
+        // subprocess. A legitimate turn always reports num_turns >= 1 (even with
+        // no visible text); undefined (CLIs that omit the field) must NOT skip.
+        let sawSubstantiveEvent = false;
+        let spuriousTurnEndSkips = 0;
         try {
             this.writeUserMessage(state.handle, promptBody);
         }
@@ -306,6 +321,15 @@ export class ClaudeCodeAdapter {
             state.steerReadPending = undefined;
             if (!orphaned.done) {
                 const parsed = orphaned.value;
+                // An orphaned read can deliver this turn's FIRST event — if it is
+                // substantive it must count toward the poison-frame guard below, or
+                // a later num_turns=0 turn_end would be wrongly skipped despite real
+                // output having been produced this turn.
+                if (parsed.type !== 'session_id' &&
+                    parsed.type !== 'runtime_session' &&
+                    parsed.type !== 'turn_end') {
+                    sawSubstantiveEvent = true;
+                }
                 if (parsed.type === 'session_id') {
                     this.opts.sessionManager.recordSessionId(sessionKey, parsed.sessionId);
                     yield {
@@ -354,6 +378,11 @@ export class ClaudeCodeAdapter {
                 return;
             }
             const parsed = next.value;
+            if (parsed.type !== 'session_id' &&
+                parsed.type !== 'runtime_session' &&
+                parsed.type !== 'turn_end') {
+                sawSubstantiveEvent = true;
+            }
             if (parsed.type === 'session_id') {
                 this.opts.sessionManager.recordSessionId(sessionKey, parsed.sessionId);
                 yield {
@@ -364,6 +393,13 @@ export class ClaudeCodeAdapter {
                 continue;
             }
             if (parsed.type === 'turn_end') {
+                if (parsed.numTurns === 0 &&
+                    !sawSubstantiveEvent &&
+                    spuriousTurnEndSkips < MAX_SPURIOUS_TURN_END_SKIPS) {
+                    spuriousTurnEndSkips++;
+                    log?.warn?.('ignoring spurious empty turn_end (num_turns=0) — resume/fork poison frame');
+                    continue;
+                }
                 if (state.needsRestart) {
                     this.killProcess(sessionKey, state);
                 }

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import * as os from 'node:os';
-import { ParallAgentGateway, capabilityBinDir, createPlatformConfigManager, createLogger, createOtelLogger, childLogger, deriveModelIsPin, materializeChannelCapabilities, resolveRuntimeModel, parseShutdownDeadlineMs, parseForkDeadlineMs, parseDispatchDeadlineMs, parseProviderConfig, clearAllProviderCreds, llmSource, initAgentTelemetry, } from '@parall/agent-core';
+import { ParallAgentGateway, capabilityBinDir, configureHttpKeepAlive, createPlatformConfigManager, createLogger, createOtelLogger, childLogger, deriveModelIsPin, materializeChannelCapabilities, resolveRuntimeModel, parseShutdownDeadlineMs, parseForkDeadlineMs, parseDispatchDeadlineMs, parseProviderConfig, clearAllProviderCreds, llmSource, initAgentTelemetry, } 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';
@@ -41,6 +41,8 @@ function resolveProviderEnv() {
     }
 }
 async function main() {
+    // Before any fetch: long-lived HTTP connections for every bridge→api call.
+    configureHttpKeepAlive();
     const telemetry = await initAgentTelemetry('parall-claude-agent', 'claude-code');
     activeLog = createOtelLogger('agent', 'claude-agent');
     try {

package/dist/output-parser.d.ts

@@ -7,6 +7,7 @@ export type ClaudeParsedEvent = RuntimeEvent | {
     type: 'turn_end';
     sessionId?: string;
     isError: boolean;
+    numTurns?: number;
 };
 export declare function parseClaudeStreamJson(readable: Readable): AsyncGenerator<ClaudeParsedEvent>;
 //# sourceMappingURL=output-parser.d.ts.map

package/dist/output-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output-parser.d.ts","sourceRoot":"","sources":["../src/output-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAWzC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AA4E/D,wBAAuB,qBAAqB,CAC1C,QAAQ,EAAE,QAAQ,GACjB,cAAc,CAAC,iBAAiB,CAAC,CAiInC"}
+{"version":3,"file":"output-parser.d.ts","sourceRoot":"","sources":["../src/output-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAkBzC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAgFlF,wBAAuB,qBAAqB,CAC1C,QAAQ,EAAE,QAAQ,GACjB,cAAc,CAAC,iBAAiB,CAAC,CAmInC"}

package/dist/output-parser.js

@@ -4,6 +4,9 @@ function asTrimmedString(value) {
     const trimmed = value.trim();
     return trimmed.length > 0 ? trimmed : undefined;
 }
+function asFiniteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
 function parseEventTimestampMs(event) {
     if (!event || typeof event !== 'object')
         return undefined;
@@ -187,10 +190,12 @@ export async function* parseClaudeStreamJson(readable) {
             // the next turn's accounting. Drop them here rather than letting
             // the map grow unbounded or mislabel durations on id collisions.
             toolUses.clear();
+            const numTurns = asFiniteNumber(eventRecord.num_turns);
             yield {
                 type: 'turn_end',
                 sessionId: asTrimmedString(eventRecord.session_id),
                 isError,
+                ...(numTurns !== undefined ? { numTurns } : {}),
             };
         }
     }

package/package.json

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

package/src/dispatch.ts

@@ -59,6 +59,11 @@ type ClaudeCodeAdapterOptions = Pick<
 
 const IS_WIN32 = process.platform === 'win32';
 
+// Upper bound on spurious empty turn_end frames skipped per turn (see the
+// guard in runTurn) — keeps a pathological stream of empty `result` frames
+// from spinning the drain loop forever.
+const MAX_SPURIOUS_TURN_END_SKIPS = 3;
+
 function quoteWin32Arg(arg: string): string {
   if (!/[\s"&|^<>()]/.test(arg)) return arg;
   return `"${arg.replace(/"/g, '""')}"`;
@@ -399,6 +404,17 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
     }
     const groupKey = randomUUID();
     let sawError = false;
+    // Poison-frame guard. When `--resume` (with or without `--fork-session`)
+    // targets a transcript whose tail is dangling (previous process was
+    // killed mid-turn — exactly the fork-on-busy case), Claude CLI emits a
+    // spurious EMPTY result frame (num_turns: 0) at startup, BEFORE the
+    // queued stdin user frame is processed. Treating its turn_end as the
+    // dispatch boundary returns with zero output, the work item sweeps as
+    // no_action, and the real reply is orphaned in a soon-to-be-killed
+    // subprocess. A legitimate turn always reports num_turns >= 1 (even with
+    // no visible text); undefined (CLIs that omit the field) must NOT skip.
+    let sawSubstantiveEvent = false;
+    let spuriousTurnEndSkips = 0;
 
     try {
       this.writeUserMessage(state.handle, promptBody);
@@ -413,6 +429,17 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
       state.steerReadPending = undefined;
       if (!orphaned.done) {
         const parsed = orphaned.value;
+        // An orphaned read can deliver this turn's FIRST event — if it is
+        // substantive it must count toward the poison-frame guard below, or
+        // a later num_turns=0 turn_end would be wrongly skipped despite real
+        // output having been produced this turn.
+        if (
+          parsed.type !== 'session_id' &&
+          parsed.type !== 'runtime_session' &&
+          parsed.type !== 'turn_end'
+        ) {
+          sawSubstantiveEvent = true;
+        }
         if (parsed.type === 'session_id') {
           this.opts.sessionManager.recordSessionId(sessionKey, parsed.sessionId);
           yield {
@@ -462,6 +489,14 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
 
       const parsed = next.value;
 
+      if (
+        parsed.type !== 'session_id' &&
+        parsed.type !== 'runtime_session' &&
+        parsed.type !== 'turn_end'
+      ) {
+        sawSubstantiveEvent = true;
+      }
+
       if (parsed.type === 'session_id') {
         this.opts.sessionManager.recordSessionId(sessionKey, parsed.sessionId);
         yield {
@@ -473,6 +508,15 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
       }
 
       if (parsed.type === 'turn_end') {
+        if (
+          parsed.numTurns === 0 &&
+          !sawSubstantiveEvent &&
+          spuriousTurnEndSkips < MAX_SPURIOUS_TURN_END_SKIPS
+        ) {
+          spuriousTurnEndSkips++;
+          log?.warn?.('ignoring spurious empty turn_end (num_turns=0) — resume/fork poison frame');
+          continue;
+        }
         if (state.needsRestart) {
           this.killProcess(sessionKey, state);
         }

package/src/index.ts

@@ -4,6 +4,7 @@ import * as os from 'node:os';
 import {
   ParallAgentGateway,
   capabilityBinDir,
+  configureHttpKeepAlive,
   createPlatformConfigManager,
   createLogger,
   createOtelLogger,
@@ -67,6 +68,8 @@ function resolveProviderEnv(): void {
 }
 
 async function main() {
+  // Before any fetch: long-lived HTTP connections for every bridge→api call.
+  configureHttpKeepAlive();
   const telemetry = await initAgentTelemetry('parall-claude-agent', 'claude-code');
   activeLog = createOtelLogger('agent', 'claude-agent');
   try {

package/src/output-parser.ts

@@ -14,7 +14,14 @@ export type ClaudeParsedEvent =
   // stream. For a short-lived `--print <prompt>` invocation the final
   // `result` frame arrives right before stdout EOF, so this event is
   // redundant there — safe to ignore.
-  | { type: 'turn_end'; sessionId?: string; isError: boolean };
+  //
+  // `numTurns` mirrors the frame's `num_turns` (absent on CLIs that don't
+  // report it): a legitimate turn always reports >= 1 even when the model
+  // replies with no visible text, while the spurious empty result frame the
+  // CLI emits at startup when `--resume` (with or without `--fork-session`)
+  // targets a dangling-tail transcript reports 0 — consumers use it to
+  // discriminate that poison frame from a real turn boundary.
+  | { type: 'turn_end'; sessionId?: string; isError: boolean; numTurns?: number };
 
 type ToolUseMeta = {
   toolName: string;
@@ -27,6 +34,10 @@ function asTrimmedString(value: unknown): string | undefined {
   return trimmed.length > 0 ? trimmed : undefined;
 }
 
+function asFiniteNumber(value: unknown): number | undefined {
+  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+
 function parseEventTimestampMs(event: unknown): number | undefined {
   if (!event || typeof event !== 'object') return undefined;
   const timestamp = (event as { timestamp?: unknown }).timestamp;
@@ -214,10 +225,12 @@ export async function* parseClaudeStreamJson(
       // the next turn's accounting. Drop them here rather than letting
       // the map grow unbounded or mislabel durations on id collisions.
       toolUses.clear();
+      const numTurns = asFiniteNumber(eventRecord.num_turns);
       yield {
         type: 'turn_end',
         sessionId: asTrimmedString(eventRecord.session_id),
         isError,
+        ...(numTurns !== undefined ? { numTurns } : {}),
       };
     }
   }