@parall/claude-agent 1.27.0 → 1.28.1

package/dist/dispatch.d.ts

@@ -17,6 +17,7 @@ export declare function buildSpawnEnv(parentEnv: NodeJS.ProcessEnv, claudeHome:
 export declare class ClaudeCodeAdapter implements DispatchAdapter {
     private readonly opts;
     private readonly processes;
+    private readonly pendingInjections;
     private shuttingDown;
     private _model;
     private _effortLevel;
@@ -27,12 +28,26 @@ export declare class ClaudeCodeAdapter implements DispatchAdapter {
         model?: string | null;
         effort?: string | null;
     }): void;
+    enqueueDuringDispatch(sessionKey: string, body: string): boolean;
+    hasPendingInjections(sessionKey: string): boolean;
     dispatch({ event, bodyForAgent, sessionKey, context }: DispatchOpts): AsyncIterable<RuntimeEvent>;
     getBranchPoint(_sessionKey: string): string | undefined;
     getSessionHistoryPath(sessionKey: string): string | undefined;
     forkSession({ sessionKey }: ForkOpts): import("@parall/agent-core").ForkSessionHandle | null;
     cleanupFork({ fork }: CleanupForkOpts): void;
     shutdown(): Promise<void>;
+    private static readonly STEER_TURN_TIMEOUT_MS;
+    /**
+     * Consume a steer turn whose message was already written to stdin via
+     * enqueueDuringDispatch. Skip the stdin write — only read parser output.
+     * If no output arrives within STEER_TURN_TIMEOUT_MS, the steer was
+     * incorporated into the previous turn and there is nothing to consume.
+     *
+     * On timeout, the losing parser.next() promise is saved to
+     * state.steerReadPending so the next runTurn can drain it instead of
+     * silently losing the first event of the subsequent turn.
+     */
+    private consumeSteerTurn;
     private runTurn;
     private ensureProcess;
     private spawnProcess;

package/dist/dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EAER,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EACL,oBAAoB,EAErB,MAAM,sBAAsB,CAAC;AAE9B,KAAK,wBAAwB,GAAG,IAAI,CAClC,iBAAiB,EACf,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,oBAAoB,GACpB,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,OAAO,GACP,gBAAgB,GAChB,cAAc,CACjB,GAAG;IACF,cAAc,EAAE,oBAAoB,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3D,iDAAiD;IACjD,wBAAwB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;CAC3D,CAAC;AAEF,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,CAAC,UAAU,EAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,EAChC,IAAI,EAAE;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,MAAM,CAAC,UAAU,CAuBnB;AAgBD,qBAAa,iBAAkB,YAAW,eAAe;IAM3C,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,YAAY,CAAqB;gBAEZ,IAAI,EAAE,wBAAwB;IAI3D,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAAwB;IAC9D,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAA8B;IAErE,YAAY,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI;IAYtE,QAAQ,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,YAAY,GAAG,aAAa,CAAC,YAAY,CAAC;IAuBxG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIvD,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAQ7D,WAAW,CAAC,EAAE,UAAU,EAAE,EAAE,QAAQ;IAIpC,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,eAAe;IAQ/B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAShB,OAAO;IAgFtB,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,YAAY;IA8CpB,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,SAAS;IAyCjB,OAAO,CAAC,uBAAuB;CAkBhC"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EAER,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EACL,oBAAoB,EAErB,MAAM,sBAAsB,CAAC;AAE9B,KAAK,wBAAwB,GAAG,IAAI,CAClC,iBAAiB,EACf,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,oBAAoB,GACpB,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,OAAO,GACP,gBAAgB,GAChB,cAAc,CACjB,GAAG;IACF,cAAc,EAAE,oBAAoB,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3D,iDAAiD;IACjD,wBAAwB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;CAC3D,CAAC;AAEF,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,CAAC,UAAU,EAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,EAChC,IAAI,EAAE;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,MAAM,CAAC,UAAU,CAuBnB;AAiBD,qBAAa,iBAAkB,YAAW,eAAe;IAO3C,OAAO,CAAC,QAAQ,CAAC,IAAI;IANjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA6B;IAC/D,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,YAAY,CAAqB;gBAEZ,IAAI,EAAE,wBAAwB;IAI3D,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAAwB;IAC9D,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAA8B;IAErE,YAAY,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI;IAY7E,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAchE,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI1C,QAAQ,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,YAAY,GAAG,aAAa,CAAC,YAAY,CAAC;IAiCxG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIvD,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAQ7D,WAAW,CAAC,EAAE,UAAU,EAAE,EAAE,QAAQ;IAIpC,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,eAAe;IAQ/B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAU;IAEvD;;;;;;;;;OASG;YACY,gBAAgB;YAsDhB,OAAO;IAwGtB,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,YAAY;IA8CpB,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,SAAS;IAyCjB,OAAO,CAAC,uBAAuB;CAkBhC"}

package/dist/dispatch.js

@@ -31,6 +31,7 @@ export function buildSpawnEnv(parentEnv, claudeHome, context, opts) {
 export class ClaudeCodeAdapter {
     opts;
     processes = new Map();
+    pendingInjections = new Map();
     shuttingDown = false;
     _model;
     _effortLevel;
@@ -53,7 +54,35 @@ export class ClaudeCodeAdapter {
             }
         }
     }
+    enqueueDuringDispatch(sessionKey, body) {
+        const state = this.processes.get(sessionKey);
+        if (!state || state.done)
+            return false;
+        const { proc } = state.handle;
+        if (proc.exitCode !== null || proc.signalCode !== null || proc.stdin.destroyed)
+            return false;
+        try {
+            this.writeUserMessage(state.handle, body);
+            this.pendingInjections.set(sessionKey, (this.pendingInjections.get(sessionKey) ?? 0) + 1);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    hasPendingInjections(sessionKey) {
+        return (this.pendingInjections.get(sessionKey) ?? 0) > 0;
+    }
     async *dispatch({ event, bodyForAgent, sessionKey, context }) {
+        const pending = this.pendingInjections.get(sessionKey) ?? 0;
+        if (pending > 0) {
+            this.pendingInjections.delete(sessionKey);
+            context.log?.info?.(`claude-agent[${context.accountId}]: consuming ${pending} steer turn(s)`);
+            for (let i = 0; i < pending; i++) {
+                yield* this.consumeSteerTurn(sessionKey, context.log);
+            }
+            return;
+        }
         let promptBody = bodyForAgent;
         let releasePreparedAttachments = () => { };
         try {
@@ -103,6 +132,66 @@ export class ClaudeCodeAdapter {
         this.processes.clear();
         await this.opts.sessionManager.shutdownAll();
     }
+    static STEER_TURN_TIMEOUT_MS = 10_000;
+    /**
+     * Consume a steer turn whose message was already written to stdin via
+     * enqueueDuringDispatch. Skip the stdin write — only read parser output.
+     * If no output arrives within STEER_TURN_TIMEOUT_MS, the steer was
+     * incorporated into the previous turn and there is nothing to consume.
+     *
+     * On timeout, the losing parser.next() promise is saved to
+     * state.steerReadPending so the next runTurn can drain it instead of
+     * silently losing the first event of the subsequent turn.
+     */
+    async *consumeSteerTurn(sessionKey, log) {
+        const state = this.processes.get(sessionKey);
+        if (!state || state.done) {
+            throw new Error("claude-agent: process dead during steer consumption");
+        }
+        const groupKey = randomUUID();
+        const parserNext = state.parser.next();
+        const firstRead = await Promise.race([
+            parserNext.then((r) => ({ kind: "value", result: r })),
+            new Promise((resolve) => setTimeout(() => resolve({ kind: "timeout" }), ClaudeCodeAdapter.STEER_TURN_TIMEOUT_MS)),
+        ]);
+        if (firstRead.kind === "timeout") {
+            state.steerReadPending = parserNext;
+            log?.info?.(`claude-agent: steer turn timeout — steer was incorporated into previous turn`);
+            return;
+        }
+        let next = firstRead.result;
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            if (next.done) {
+                state.done = true;
+                this.processes.delete(sessionKey);
+                throw new Error("claude-agent: process exited while consuming steer turn");
+            }
+            const parsed = next.value;
+            if (parsed.type === "session_id") {
+                this.opts.sessionManager.recordSessionId(sessionKey, parsed.sessionId);
+                yield { type: "runtime_session", runtimeSessionId: parsed.sessionId, runtimeLaneKey: sessionKey };
+            }
+            else if (parsed.type === "turn_end") {
+                if (state.needsRestart)
+                    this.killProcess(sessionKey, state);
+                return;
+            }
+            else if (parsed.type === "error") {
+                yield parsed;
+            }
+            else if (parsed.type === "text") {
+                yield { ...parsed, project: false, groupKey };
+            }
+            else if (parsed.type === "runtime_session") {
+                yield parsed;
+            }
+            else {
+                yield { ...parsed, groupKey };
+            }
+            next = await state.parser.next();
+        }
+    }
     async *runTurn(sessionKey, promptBody, log) {
         let state;
         try {
@@ -122,6 +211,35 @@ export class ClaudeCodeAdapter {
             this.killProcess(sessionKey, state);
             return;
         }
+        if (state.steerReadPending) {
+            const orphaned = await state.steerReadPending;
+            state.steerReadPending = undefined;
+            if (!orphaned.done) {
+                const parsed = orphaned.value;
+                if (parsed.type === "session_id") {
+                    this.opts.sessionManager.recordSessionId(sessionKey, parsed.sessionId);
+                    yield { type: "runtime_session", runtimeSessionId: parsed.sessionId, runtimeLaneKey: sessionKey };
+                }
+                else if (parsed.type === "turn_end") {
+                    if (state.needsRestart)
+                        this.killProcess(sessionKey, state);
+                    return;
+                }
+                else if (parsed.type === "error") {
+                    sawError = true;
+                    yield parsed;
+                }
+                else if (parsed.type === "text") {
+                    yield { ...parsed, project: false, groupKey };
+                }
+                else if (parsed.type === "runtime_session") {
+                    yield parsed;
+                }
+                else {
+                    yield { ...parsed, groupKey };
+                }
+            }
+        }
         while (true) {
             const next = await state.parser.next();
             if (next.done) {

package/package.json

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

package/src/dispatch.ts

@@ -85,10 +85,12 @@ type ProcessState = {
   parser: AsyncGenerator<ClaudeParsedEvent>;
   done: boolean;
   needsRestart: boolean;
+  steerReadPending?: Promise<IteratorResult<ClaudeParsedEvent>>;
 };
 
 export class ClaudeCodeAdapter implements DispatchAdapter {
   private readonly processes = new Map<string, ProcessState>();
+  private readonly pendingInjections = new Map<string, number>();
   private shuttingDown = false;
   private _model: string | undefined;
   private _effortLevel: string | undefined;
@@ -112,7 +114,35 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
     }
   }
 
+  enqueueDuringDispatch(sessionKey: string, body: string): boolean {
+    const state = this.processes.get(sessionKey);
+    if (!state || state.done) return false;
+    const { proc } = state.handle;
+    if (proc.exitCode !== null || proc.signalCode !== null || proc.stdin.destroyed) return false;
+    try {
+      this.writeUserMessage(state.handle, body);
+      this.pendingInjections.set(sessionKey, (this.pendingInjections.get(sessionKey) ?? 0) + 1);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  hasPendingInjections(sessionKey: string): boolean {
+    return (this.pendingInjections.get(sessionKey) ?? 0) > 0;
+  }
+
   async *dispatch({ event, bodyForAgent, sessionKey, context }: DispatchOpts): AsyncIterable<RuntimeEvent> {
+    const pending = this.pendingInjections.get(sessionKey) ?? 0;
+    if (pending > 0) {
+      this.pendingInjections.delete(sessionKey);
+      context.log?.info?.(`claude-agent[${context.accountId}]: consuming ${pending} steer turn(s)`);
+      for (let i = 0; i < pending; i++) {
+        yield* this.consumeSteerTurn(sessionKey, context.log);
+      }
+      return;
+    }
+
     let promptBody = bodyForAgent;
     let releasePreparedAttachments = () => {};
     try {
@@ -168,6 +198,72 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
     await this.opts.sessionManager.shutdownAll();
   }
 
+  private static readonly STEER_TURN_TIMEOUT_MS = 10_000;
+
+  /**
+   * Consume a steer turn whose message was already written to stdin via
+   * enqueueDuringDispatch. Skip the stdin write — only read parser output.
+   * If no output arrives within STEER_TURN_TIMEOUT_MS, the steer was
+   * incorporated into the previous turn and there is nothing to consume.
+   *
+   * On timeout, the losing parser.next() promise is saved to
+   * state.steerReadPending so the next runTurn can drain it instead of
+   * silently losing the first event of the subsequent turn.
+   */
+  private async *consumeSteerTurn(
+    sessionKey: string,
+    log: GatewayLogger | undefined,
+  ): AsyncGenerator<RuntimeEvent> {
+    const state = this.processes.get(sessionKey);
+    if (!state || state.done) {
+      throw new Error("claude-agent: process dead during steer consumption");
+    }
+
+    const groupKey = randomUUID();
+
+    const parserNext = state.parser.next();
+    const firstRead = await Promise.race([
+      parserNext.then((r) => ({ kind: "value" as const, result: r })),
+      new Promise<{ kind: "timeout" }>((resolve) =>
+        setTimeout(() => resolve({ kind: "timeout" }), ClaudeCodeAdapter.STEER_TURN_TIMEOUT_MS),
+      ),
+    ]);
+
+    if (firstRead.kind === "timeout") {
+      state.steerReadPending = parserNext;
+      log?.info?.(`claude-agent: steer turn timeout — steer was incorporated into previous turn`);
+      return;
+    }
+
+    let next = firstRead.result;
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+      if (next.done) {
+        state.done = true;
+        this.processes.delete(sessionKey);
+        throw new Error("claude-agent: process exited while consuming steer turn");
+      }
+      const parsed = next.value;
+
+      if (parsed.type === "session_id") {
+        this.opts.sessionManager.recordSessionId(sessionKey, parsed.sessionId);
+        yield { type: "runtime_session", runtimeSessionId: parsed.sessionId, runtimeLaneKey: sessionKey };
+      } else if (parsed.type === "turn_end") {
+        if (state.needsRestart) this.killProcess(sessionKey, state);
+        return;
+      } else if (parsed.type === "error") {
+        yield parsed;
+      } else if (parsed.type === "text") {
+        yield { ...parsed, project: false, groupKey };
+      } else if (parsed.type === "runtime_session") {
+        yield parsed;
+      } else {
+        yield { ...parsed, groupKey };
+      }
+      next = await state.parser.next();
+    }
+  }
+
   private async *runTurn(
     sessionKey: string,
     promptBody: string,
@@ -191,6 +287,30 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
       return;
     }
 
+    if (state.steerReadPending) {
+      const orphaned = await state.steerReadPending;
+      state.steerReadPending = undefined;
+      if (!orphaned.done) {
+        const parsed = orphaned.value;
+        if (parsed.type === "session_id") {
+          this.opts.sessionManager.recordSessionId(sessionKey, parsed.sessionId);
+          yield { type: "runtime_session", runtimeSessionId: parsed.sessionId, runtimeLaneKey: sessionKey };
+        } else if (parsed.type === "turn_end") {
+          if (state.needsRestart) this.killProcess(sessionKey, state);
+          return;
+        } else if (parsed.type === "error") {
+          sawError = true;
+          yield parsed;
+        } else if (parsed.type === "text") {
+          yield { ...parsed, project: false, groupKey };
+        } else if (parsed.type === "runtime_session") {
+          yield parsed;
+        } else {
+          yield { ...parsed, groupKey };
+        }
+      }
+    }
+
     while (true) {
       const next = await state.parser.next();