@parall/agent-core 1.28.1 → 1.29.1

package/dist/dispatch-adapter.d.ts

@@ -80,19 +80,20 @@ export interface DispatchAdapter {
     /** Dispatch a Parall event to the runtime and emit normalized runtime events. */
     dispatch(opts: DispatchOpts): AsyncIterable<RuntimeEvent>;
     /**
-     * Inject a user message into the running subprocess's stdin mid-turn so the
-     * runtime reads it between tool calls and steers immediately, rather than
-     * waiting for the current turn to complete.
+     * Inject a user message into the running runtime mid-turn so it steers
+     * immediately, rather than waiting for the current turn to complete.
      *
-     * Returns true if the message was successfully written to stdin; false if no
-     * live process exists for the session (caller should fall back to mainBuffer).
+     * Returns true if the injection succeeded; false if no live process/session
+     * exists (caller falls back to mainBuffer next-turn path). May return a
+     * Promise when the injection requires an async round-trip (e.g. Codex
+     * turn/steer JSON-RPC) — the gateway awaits it.
      *
      * The gateway still pushes the event to mainBuffer after a successful
      * injection — drainMainBuffer will call dispatch() for it, and dispatch()
-     * must detect the pending injection (skip the stdin write) and only consume
-     * the parser output that Claude produced in response.
+     * must detect the pending injection (skip the duplicate input) and only
+     * consume output produced in response.
      */
-    enqueueDuringDispatch?(sessionKey: string, body: string): boolean;
+    enqueueDuringDispatch?(sessionKey: string, body: string): boolean | Promise<boolean>;
     /** True if enqueueDuringDispatch was called and the injections have not yet been consumed by dispatch(). */
     hasPendingInjections?(sessionKey: string): boolean;
     /** Fork the current runtime session for concurrent handling. Return null to buffer on main. */

package/dist/dispatch-adapter.d.ts.map

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

package/dist/event-format.d.ts

@@ -1,5 +1,6 @@
 import type { ForkResult, ParallEvent } from "./types.js";
 export declare function buildEventBody(event: ParallEvent): string;
+export declare function buildEventBodyForForkResult(event: ParallEvent): string;
 export declare function buildForkScopePrefix(event: ParallEvent): string;
 export declare function buildForkResultPrefix(results: ForkResult[]): string;
 //# sourceMappingURL=event-format.d.ts.map

package/dist/event-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-format.d.ts","sourceRoot":"","sources":["../src/event-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM1D,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAsDzD;AAoBD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAK/D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAWnE"}
+{"version":3,"file":"event-format.d.ts","sourceRoot":"","sources":["../src/event-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM1D,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAsDzD;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAEtE;AAoBD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAK/D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAcnE"}

package/dist/event-format.js

@@ -65,6 +65,9 @@ export function buildEventBody(event) {
     }
     return lines.join("\n") + buildSendMessageHint(event);
 }
+export function buildEventBodyForForkResult(event) {
+    return buildEventBody(event).replace(/\n<system-reminder>[\s\S]*<\/system-reminder>$/, "");
+}
 function buildSendMessageHint(event) {
     if (event.noReply)
         return "";
@@ -89,14 +92,16 @@ export function buildForkResultPrefix(results) {
     if (!results.length)
         return "";
     const blocks = results.map((result) => {
-        const lines = [`[Fork result]`];
-        lines.push(`[Handled: ${result.sourceEvent.type} — ${result.sourceEvent.summary}]`);
+        const lines = [];
+        for (const body of result.eventBodies) {
+            lines.push(body);
+        }
+        lines.push(`[This event was handled by a parallel fork session. Do NOT re-handle, re-reply, or duplicate work for it.]`);
+        lines.push(`[Fork summary: ${result.agentSummary ? sanitizeMeta(result.agentSummary) : "No fork summary available — the fork completed without producing a text summary. Check the target chat/task for any actions the fork already took before acting."}]`);
         if (result.actions.length)
-            lines.push(`[Actions: ${result.actions.join("; ")}]`);
-        if (result.agentSummary)
-            lines.push(`[Summary: ${sanitizeMeta(result.agentSummary)}]`);
+            lines.push(`[Fork actions: ${result.actions.join("; ")}]`);
         if (result.historyPath)
-            lines.push(`[History: ${result.historyPath}]`);
+            lines.push(`[Fork history: ${result.historyPath}]`);
         return lines.join("\n");
     });
     return blocks.join("\n\n") + "\n\n---\n\n";

package/dist/gateway-base.d.ts

@@ -41,6 +41,7 @@ export declare class ParallAgentGateway {
     private readonly opts;
     private readonly chatInfoMap;
     private readonly activeDispatches;
+    private readonly injectedTypingCounts;
     private readonly dispatchedTasks;
     private readonly dispatchedMessages;
     private readonly forkStates;
@@ -63,6 +64,10 @@ export declare class ParallAgentGateway {
     private tryClaimMessage;
     private startTyping;
     private stopTyping;
+    private shouldShowTyping;
+    private startInjectedTyping;
+    private takeInjectedTypingCount;
+    private runDispatchWithTyping;
     private buildDispatchContext;
     private createInputStep;
     private createRuntimeStep;

package/dist/gateway-base.d.ts.map

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

package/dist/gateway-base.js

@@ -1,9 +1,8 @@
 import * as os from "node:os";
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { randomUUID } from "node:crypto";
 import { MENTION_ALL_USER_ID } from "@parall/sdk";
-import { buildEventBody, buildForkResultPrefix, buildForkScopePrefix } from "./event-format.js";
+import { buildEventBody, buildEventBodyForForkResult, buildForkResultPrefix, buildForkScopePrefix } from "./event-format.js";
 import { routeTrigger } from "./routing.js";
 import { clearDispatchMessageId, clearDispatchNoReply, clearSessionMessageId, setDispatchMessageId, setDispatchNoReply, setSessionChatId, setSessionMessageId, } from "./session-state.js";
 // Parse PRLL_SHUTDOWN_DEADLINE_MS (or any string env value) into a positive
@@ -55,6 +54,7 @@ export class ParallAgentGateway {
     opts;
     chatInfoMap = new Map();
     activeDispatches = new Map();
+    injectedTypingCounts = new Map();
     dispatchedTasks = new Set();
     dispatchedMessages = new Set();
     forkStates = new Map();
@@ -266,6 +266,35 @@ export class ParallAgentGateway {
         if (this.opts.ws.state === "connected")
             this.opts.ws.sendTyping(chatId, "stop");
     }
+    shouldShowTyping(event) {
+        return event.type === "message" && event.targetId.startsWith("cht_") && !event.noReply;
+    }
+    startInjectedTyping(event) {
+        if (!this.shouldShowTyping(event))
+            return;
+        this.startTyping(event.targetId);
+        this.injectedTypingCounts.set(event.targetId, (this.injectedTypingCounts.get(event.targetId) ?? 0) + 1);
+    }
+    takeInjectedTypingCount(chatId) {
+        const count = this.injectedTypingCounts.get(chatId) ?? 0;
+        this.injectedTypingCounts.delete(chatId);
+        return count;
+    }
+    async runDispatchWithTyping(event, sessionKey, bodyForAgent, earlierEvents = [], captureText, opts = {}) {
+        const showTyping = !opts.suppressStart && (this.shouldShowTyping(event) || earlierEvents.some(e => this.shouldShowTyping(e)));
+        if (showTyping)
+            this.startTyping(event.targetId);
+        try {
+            return await this.runDispatch(event, sessionKey, bodyForAgent, earlierEvents, captureText);
+        }
+        finally {
+            if (showTyping)
+                this.stopTyping(event.targetId);
+            for (let i = 0; i < (opts.injectedTypingCount ?? 0); i++) {
+                this.stopTyping(event.targetId);
+            }
+        }
+    }
     buildDispatchContext(event, sessionKey) {
         const binding = this.sessionBindings.get(sessionKey);
         return {
@@ -307,6 +336,7 @@ export class ParallAgentGateway {
                     sender_id: event.senderId,
                     sender_name: event.senderName,
                     summary: event.body.substring(0, 200),
+                    ...(event.sentAt ? { sent_at: event.sentAt } : {}),
                 },
             });
         }
@@ -554,7 +584,8 @@ export class ParallAgentGateway {
                     continue;
                 }
                 if (!binding) {
-                    throw new Error(`runtime emitted ${runtimeEvent.type} before runtime_session`);
+                    const detail = runtimeEvent.type === "error" ? `: ${runtimeEvent.message}` : "";
+                    throw new Error(`runtime emitted ${runtimeEvent.type} before runtime_session${detail}`);
                 }
                 if (!triggerMessageSet) {
                     triggerMessageSet = true;
@@ -637,7 +668,7 @@ export class ParallAgentGateway {
                 const earlier = events.slice(0, -1);
                 try {
                     const batchText = [];
-                    const dispatched = await this.runDispatch(last, fork.fork.sessionKey, buildForkScopePrefix(last) + buildEventBody(last), earlier, batchText);
+                    const dispatched = await this.runDispatchWithTyping(last, fork.fork.sessionKey, buildForkScopePrefix(last) + buildEventBody(last), earlier, batchText);
                     if (!dispatched) {
                         // Shutdown short-circuit — resolve un-acked so the server requeues
                         // for the replacement pod and stop draining further items.
@@ -685,6 +716,7 @@ export class ParallAgentGateway {
                             ? `${first.type} from ${first.senderName} in ${first.targetName ?? fork.targetId}`
                             : `${fork.processedEvents.length} events in ${first.targetName ?? fork.targetId}`,
                     },
+                    eventBodies: fork.processedEvents.map((e) => buildEventBodyForForkResult(e)),
                     actions: [],
                     agentSummary,
                     historyPath,
@@ -723,7 +755,7 @@ export class ParallAgentGateway {
             return;
         this.draining = true;
         try {
-            while (this.dispatchState.mainBuffer.length > 0 || this.dispatchState.pendingForkResults.length > 0) {
+            while (this.dispatchState.mainBuffer.length > 0) {
                 // Early shutdown guard — same reasoning as runForkDrainLoop: stop
                 // before any input AgentSteps are persisted, leaving the buffer +
                 // pendingForkResults intact so dispatch catch-up on the replacement
@@ -732,31 +764,6 @@ export class ParallAgentGateway {
                     this.opts.log?.info(`parall[${this.opts.accountId}]: drainMainBuffer halted (shutting down) — ${this.dispatchState.mainBuffer.length} buffered, ${this.dispatchState.pendingForkResults.length} pending fork results left for catch-up`);
                     break;
                 }
-                if (this.dispatchState.mainBuffer.length === 0 && this.dispatchState.pendingForkResults.length > 0) {
-                    const pending = this.dispatchState.pendingForkResults.splice(0);
-                    const forkPrefix = buildForkResultPrefix(pending);
-                    const syntheticEvent = {
-                        type: "message",
-                        targetId: "_orchestrator",
-                        targetType: "system",
-                        senderId: "system",
-                        senderName: "system",
-                        messageId: `synthetic-${this.opts.accountId}-${randomUUID()}`,
-                        body: "[Orchestrator: fork session(s) completed — review results above]",
-                    };
-                    this.dispatchState.mainCurrentTargetId = undefined;
-                    this.dispatchState.mainPreDispatchBranchPoint =
-                        this.opts.dispatchAdapter.getBranchPoint?.(this.opts.runtimeKey);
-                    const dispatched = await this.runDispatch(syntheticEvent, this.opts.runtimeKey, forkPrefix + buildEventBody(syntheticEvent));
-                    if (!dispatched) {
-                        // Shutdown: put the fork results back at the head so the synthetic
-                        // event is regenerated on the replacement pod. Synthetic events are
-                        // not ack'd, so this is the only state we need to preserve.
-                        this.dispatchState.pendingForkResults.unshift(...pending);
-                        break;
-                    }
-                    continue;
-                }
                 const targetId = this.dispatchState.mainBuffer[0].targetId;
                 const events = [];
                 while (this.dispatchState.mainBuffer[0]?.targetId === targetId) {
@@ -764,13 +771,14 @@ export class ParallAgentGateway {
                 }
                 const event = events[events.length - 1];
                 const earlier = events.slice(0, -1);
-                const skipForkSplice = this.opts.dispatchAdapter.hasPendingInjections?.(this.opts.runtimeKey) ?? false;
-                const pendingFork = skipForkSplice ? [] : this.dispatchState.pendingForkResults.splice(0);
+                const hasPendingInjections = this.opts.dispatchAdapter.hasPendingInjections?.(this.opts.runtimeKey) ?? false;
+                const injectedTypingCount = hasPendingInjections ? this.takeInjectedTypingCount(event.targetId) : 0;
+                const pendingFork = hasPendingInjections ? [] : this.dispatchState.pendingForkResults.splice(0);
                 const forkPrefix = buildForkResultPrefix(pendingFork);
                 this.dispatchState.mainCurrentTargetId = event.targetId;
                 this.dispatchState.mainPreDispatchBranchPoint =
                     this.opts.dispatchAdapter.getBranchPoint?.(this.opts.runtimeKey);
-                const dispatched = await this.runDispatch(event, this.opts.runtimeKey, forkPrefix + buildEventBody(event), earlier);
+                const dispatched = await this.runDispatchWithTyping(event, this.opts.runtimeKey, forkPrefix + buildEventBody(event), earlier, undefined, { suppressStart: injectedTypingCount > 0, injectedTypingCount });
                 if (!dispatched) {
                     // Shutdown: skip the ack so the server redelivers these buffered
                     // events to the replacement pod via dispatch catch-up. Put both the
@@ -811,7 +819,7 @@ export class ParallAgentGateway {
                     this.opts.dispatchAdapter.getBranchPoint?.(this.opts.runtimeKey);
                 let dispatched = false;
                 try {
-                    dispatched = await this.runDispatch(event, this.opts.runtimeKey, forkPrefix + buildEventBody(event));
+                    dispatched = await this.runDispatchWithTyping(event, this.opts.runtimeKey, forkPrefix + buildEventBody(event));
                     if (!dispatched) {
                         // Shutdown short-circuit — restore the fork results so a future
                         // pod can replay them, and return false so handleMessage skips ack.
@@ -827,11 +835,22 @@ export class ParallAgentGateway {
                 if (this.shuttingDown) {
                     return false;
                 }
+                // Push synchronously BEFORE the (possibly async) steer attempt so
+                // arrival order is preserved and the event cannot be orphaned in a
+                // gap between the steer await and the push.
+                this.dispatchState.mainBuffer.push(event);
                 if (this.dispatchState.mainCurrentTargetId === event.targetId &&
-                    this.opts.dispatchAdapter.enqueueDuringDispatch?.(this.opts.runtimeKey, buildEventBody(event))) {
-                    this.opts.log?.info(`parall[${this.opts.accountId}]: steer injected to stdin for ${event.messageId} (will drain for bookkeeping)`);
+                    await this.opts.dispatchAdapter.enqueueDuringDispatch?.(this.opts.runtimeKey, buildEventBody(event))) {
+                    this.startInjectedTyping(event);
+                    this.opts.log?.info(`parall[${this.opts.accountId}]: steer injected for ${event.messageId} (will drain for bookkeeping)`);
+                }
+                // If the main dispatch cycle ended while we awaited the steer RPC,
+                // our event is buffered but no drain is in flight. Re-enter the
+                // drain to process it. The draining guard prevents re-entry.
+                if (!this.dispatchState.mainDispatching && !this.draining && this.dispatchState.mainBuffer.length > 0) {
+                    this.dispatchState.mainDispatching = true;
+                    void this.drainMainBuffer();
                 }
-                this.dispatchState.mainBuffer.push(event);
                 return false;
             }
             case "buffer-fork": {
@@ -934,6 +953,7 @@ export class ParallAgentGateway {
                 threadRootId: message.thread_root_id ?? undefined,
                 noReply: message.hints?.no_reply ?? false,
                 attachments: attachments.length > 0 ? attachments : undefined,
+                sentAt: message.created_at,
                 ackSourceType: "message",
                 ackSourceId: message.id,
             },
@@ -955,9 +975,6 @@ export class ParallAgentGateway {
             return;
         }
         const event = decision.event;
-        const willDispatch = !this.dispatchState.mainDispatching || this.dispatchState.mainCurrentTargetId !== chatId;
-        if (willDispatch)
-            this.startTyping(chatId);
         try {
             const dispatched = await this.handleInboundEvent(event);
             if (dispatched) {
@@ -971,10 +988,6 @@ export class ParallAgentGateway {
             this.opts.log?.error(`parall[${this.opts.accountId}]: event dispatch failed for ${data.id}: ${String(err)}`);
             this.dispatchedMessages.delete(data.id);
         }
-        finally {
-            if (willDispatch)
-                this.stopTyping(chatId);
-        }
     }
     async handleTaskAssignment(task, ackSourceId) {
         if (this.shuttingDown)
@@ -1003,6 +1016,7 @@ export class ParallAgentGateway {
             senderName: "system",
             messageId: task.id,
             body: parts.join("\n"),
+            sentAt: task.updated_at ?? task.created_at,
             ackSourceType: "task_activity",
             ackSourceId,
         };

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export * from "./event-format.js";
 export * from "./prompt-fragments.js";
 export * from "./bridge-workspace.js";
 export * from "./dispatch-adapter.js";
+export { createLogger } from "./logger.js";
 export * from "./gateway-base.js";
 export * from "./platform-config.js";
 export { writeSkillFiles, buildSkillReferences, SKILLS } from "./skills/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAClF,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAClF,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -5,6 +5,7 @@ export * from "./event-format.js";
 export * from "./prompt-fragments.js";
 export * from "./bridge-workspace.js";
 export * from "./dispatch-adapter.js";
+export { createLogger } from "./logger.js";
 export * from "./gateway-base.js";
 export * from "./platform-config.js";
 export { writeSkillFiles, buildSkillReferences, SKILLS } from "./skills/index.js";

package/dist/logger.d.ts

@@ -0,0 +1,3 @@
+import type { GatewayLogger } from "./dispatch-adapter.js";
+export declare function createLogger(prefix: string): GatewayLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAM1D"}

package/dist/logger.js

@@ -0,0 +1,7 @@
+export function createLogger(prefix) {
+    return {
+        info: (msg) => console.log(`${new Date().toISOString()} [${prefix}] ${msg}`),
+        warn: (msg) => console.warn(`${new Date().toISOString()} [${prefix}] ${msg}`),
+        error: (msg) => console.error(`${new Date().toISOString()} [${prefix}] ${msg}`),
+    };
+}

package/dist/types.d.ts

@@ -6,6 +6,8 @@ export type ForkResult = {
         targetId: string;
         summary: string;
     };
+    /** Original event bodies that the fork processed, built via `buildEventBody()`. */
+    eventBodies: string[];
     actions: string[];
     /** Agent's own summary of what it did (captured from the fork's last text output). */
     agentSummary?: string;
@@ -45,6 +47,9 @@ export type ParallEvent = {
     scheduledFireAt?: string;
     /** Fire-time attached_to_uri snapshot, used for schedule events. */
     attachedUri?: string;
+    /** Original event timestamp (e.g., message.created_at). When present,
+     *  input steps use this instead of server insertion time for ordering. */
+    sentAt?: string;
     ackSourceType?: "message" | "task_activity" | "comment" | "schedule_run";
     ackSourceId?: string;
 };

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,MAAM,MAAM,UAAU,GAAG;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,aAAa,GAAG;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kBAAkB,EAAE,UAAU,EAAE,CAAC;IACjC,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,oFAAoF;IACpF,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,cAAc,GAAG,UAAU,GAAG,UAAU,CAAC;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,SAAS,GAAG,eAAe,GAAG,SAAS,GAAG,cAAc,CAAC;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,MAAM,MAAM,UAAU,GAAG;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,mFAAmF;IACnF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,aAAa,GAAG;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kBAAkB,EAAE,UAAU,EAAE,CAAC;IACjC,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,oFAAoF;IACpF,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,cAAc,GAAG,UAAU,GAAG,UAAU,CAAC;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;8EAC0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,SAAS,GAAG,eAAe,GAAG,SAAS,GAAG,cAAc,CAAC;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/agent-core",
-  "version": "1.28.1",
+  "version": "1.29.1",
   "description": "Shared agent runtime orchestration helpers for Parall",
   "license": "MIT",
   "repository": {
@@ -26,7 +26,7 @@
     "src"
   ],
   "dependencies": {
-    "@parall/sdk": "1.28.1"
+    "@parall/sdk": "1.29.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/dispatch-adapter.ts

@@ -68,19 +68,20 @@ export interface DispatchAdapter {
   dispatch(opts: DispatchOpts): AsyncIterable<RuntimeEvent>;
 
   /**
-   * Inject a user message into the running subprocess's stdin mid-turn so the
-   * runtime reads it between tool calls and steers immediately, rather than
-   * waiting for the current turn to complete.
+   * Inject a user message into the running runtime mid-turn so it steers
+   * immediately, rather than waiting for the current turn to complete.
    *
-   * Returns true if the message was successfully written to stdin; false if no
-   * live process exists for the session (caller should fall back to mainBuffer).
+   * Returns true if the injection succeeded; false if no live process/session
+   * exists (caller falls back to mainBuffer next-turn path). May return a
+   * Promise when the injection requires an async round-trip (e.g. Codex
+   * turn/steer JSON-RPC) — the gateway awaits it.
    *
    * The gateway still pushes the event to mainBuffer after a successful
    * injection — drainMainBuffer will call dispatch() for it, and dispatch()
-   * must detect the pending injection (skip the stdin write) and only consume
-   * the parser output that Claude produced in response.
+   * must detect the pending injection (skip the duplicate input) and only
+   * consume output produced in response.
    */
-  enqueueDuringDispatch?(sessionKey: string, body: string): boolean;
+  enqueueDuringDispatch?(sessionKey: string, body: string): boolean | Promise<boolean>;
 
   /** True if enqueueDuringDispatch was called and the injections have not yet been consumed by dispatch(). */
   hasPendingInjections?(sessionKey: string): boolean;

package/src/event-format.ts

@@ -60,6 +60,10 @@ export function buildEventBody(event: ParallEvent): string {
   return lines.join("\n") + buildSendMessageHint(event);
 }
 
+export function buildEventBodyForForkResult(event: ParallEvent): string {
+  return buildEventBody(event).replace(/\n<system-reminder>[\s\S]*<\/system-reminder>$/, "");
+}
+
 function buildSendMessageHint(event: ParallEvent): string {
   if (event.noReply) return "";
 
@@ -88,11 +92,14 @@ export function buildForkScopePrefix(event: ParallEvent): string {
 export function buildForkResultPrefix(results: ForkResult[]): string {
   if (!results.length) return "";
   const blocks = results.map((result) => {
-    const lines = [`[Fork result]`];
-    lines.push(`[Handled: ${result.sourceEvent.type} — ${result.sourceEvent.summary}]`);
-    if (result.actions.length) lines.push(`[Actions: ${result.actions.join("; ")}]`);
-    if (result.agentSummary) lines.push(`[Summary: ${sanitizeMeta(result.agentSummary)}]`);
-    if (result.historyPath) lines.push(`[History: ${result.historyPath}]`);
+    const lines: string[] = [];
+    for (const body of result.eventBodies) {
+      lines.push(body);
+    }
+    lines.push(`[This event was handled by a parallel fork session. Do NOT re-handle, re-reply, or duplicate work for it.]`);
+    lines.push(`[Fork summary: ${result.agentSummary ? sanitizeMeta(result.agentSummary) : "No fork summary available — the fork completed without producing a text summary. Check the target chat/task for any actions the fork already took before acting."}]`);
+    if (result.actions.length) lines.push(`[Fork actions: ${result.actions.join("; ")}]`);
+    if (result.historyPath) lines.push(`[Fork history: ${result.historyPath}]`);
     return lines.join("\n");
   });
   return blocks.join("\n\n") + "\n\n---\n\n";

package/src/gateway-base.ts

@@ -1,7 +1,6 @@
 import * as os from "node:os";
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { randomUUID } from "node:crypto";
 import { MENTION_ALL_USER_ID, ParallClient, ParallWs } from "@parall/sdk";
 import type {
   AgentConfigUpdateData,
@@ -19,7 +18,7 @@ import type {
   TaskAssignedData,
   TextContent,
 } from "@parall/sdk";
-import { buildEventBody, buildForkResultPrefix, buildForkScopePrefix } from "./event-format.js";
+import { buildEventBody, buildEventBodyForForkResult, buildForkResultPrefix, buildForkScopePrefix } from "./event-format.js";
 import type {
   CleanupForkOpts,
   DispatchAdapter,
@@ -72,6 +71,7 @@ type DispatchableMessage = {
   thread_root_id?: string | null;
   hints?: { no_reply?: boolean } | null;
   attachments?: Array<{ id: string; file_name: string; file_size: number; mime_type: string }>;
+  created_at?: string;
 };
 
 type MessageDispatchDecision =
@@ -170,6 +170,7 @@ async function fetchAllChats(
 export class ParallAgentGateway {
   private readonly chatInfoMap = new Map<string, ChatInfo>();
   private readonly activeDispatches = new Map<string, ActiveDispatch>();
+  private readonly injectedTypingCounts = new Map<string, number>();
   private readonly dispatchedTasks = new Set<string>();
   private readonly dispatchedMessages = new Set<string>();
   private readonly forkStates = new Map<string, ActiveForkState>();
@@ -377,6 +378,42 @@ export class ParallAgentGateway {
     if (this.opts.ws.state === "connected") this.opts.ws.sendTyping(chatId, "stop");
   }
 
+  private shouldShowTyping(event: ParallEvent): boolean {
+    return event.type === "message" && event.targetId.startsWith("cht_") && !event.noReply;
+  }
+
+  private startInjectedTyping(event: ParallEvent) {
+    if (!this.shouldShowTyping(event)) return;
+    this.startTyping(event.targetId);
+    this.injectedTypingCounts.set(event.targetId, (this.injectedTypingCounts.get(event.targetId) ?? 0) + 1);
+  }
+
+  private takeInjectedTypingCount(chatId: string): number {
+    const count = this.injectedTypingCounts.get(chatId) ?? 0;
+    this.injectedTypingCounts.delete(chatId);
+    return count;
+  }
+
+  private async runDispatchWithTyping(
+    event: ParallEvent,
+    sessionKey: string,
+    bodyForAgent: string,
+    earlierEvents: ParallEvent[] = [],
+    captureText?: string[],
+    opts: { suppressStart?: boolean; injectedTypingCount?: number } = {},
+  ): Promise<boolean> {
+    const showTyping = !opts.suppressStart && (this.shouldShowTyping(event) || earlierEvents.some(e => this.shouldShowTyping(e)));
+    if (showTyping) this.startTyping(event.targetId);
+    try {
+      return await this.runDispatch(event, sessionKey, bodyForAgent, earlierEvents, captureText);
+    } finally {
+      if (showTyping) this.stopTyping(event.targetId);
+      for (let i = 0; i < (opts.injectedTypingCount ?? 0); i++) {
+        this.stopTyping(event.targetId);
+      }
+    }
+  }
+
   private buildDispatchContext(event: ParallEvent, sessionKey: string): DispatchContext {
     const binding = this.sessionBindings.get(sessionKey);
     return {
@@ -421,6 +458,7 @@ export class ParallAgentGateway {
           sender_id: event.senderId,
           sender_name: event.senderName,
           summary: event.body.substring(0, 200),
+          ...(event.sentAt ? { sent_at: event.sentAt } : {}),
         },
       });
     } catch (err) {
@@ -693,7 +731,8 @@ export class ParallAgentGateway {
         }
 
         if (!binding) {
-          throw new Error(`runtime emitted ${runtimeEvent.type} before runtime_session`);
+          const detail = runtimeEvent.type === "error" ? `: ${runtimeEvent.message}` : "";
+          throw new Error(`runtime emitted ${runtimeEvent.type} before runtime_session${detail}`);
         }
         if (!triggerMessageSet) {
           triggerMessageSet = true;
@@ -778,7 +817,7 @@ export class ParallAgentGateway {
         const earlier = events.slice(0, -1);
         try {
           const batchText: string[] = [];
-          const dispatched = await this.runDispatch(last, fork.fork.sessionKey, buildForkScopePrefix(last) + buildEventBody(last), earlier, batchText);
+          const dispatched = await this.runDispatchWithTyping(last, fork.fork.sessionKey, buildForkScopePrefix(last) + buildEventBody(last), earlier, batchText);
           if (!dispatched) {
             // Shutdown short-circuit — resolve un-acked so the server requeues
             // for the replacement pod and stop draining further items.
@@ -823,6 +862,7 @@ export class ParallAgentGateway {
               ? `${first.type} from ${first.senderName} in ${first.targetName ?? fork.targetId}`
               : `${fork.processedEvents.length} events in ${first.targetName ?? fork.targetId}`,
           },
+          eventBodies: fork.processedEvents.map((e) => buildEventBodyForForkResult(e)),
           actions: [],
           agentSummary,
           historyPath,
@@ -864,7 +904,7 @@ export class ParallAgentGateway {
     if (this.draining) return;
     this.draining = true;
     try {
-      while (this.dispatchState.mainBuffer.length > 0 || this.dispatchState.pendingForkResults.length > 0) {
+      while (this.dispatchState.mainBuffer.length > 0) {
         // Early shutdown guard — same reasoning as runForkDrainLoop: stop
         // before any input AgentSteps are persisted, leaving the buffer +
         // pendingForkResults intact so dispatch catch-up on the replacement
@@ -875,31 +915,6 @@ export class ParallAgentGateway {
           );
           break;
         }
-        if (this.dispatchState.mainBuffer.length === 0 && this.dispatchState.pendingForkResults.length > 0) {
-          const pending = this.dispatchState.pendingForkResults.splice(0);
-          const forkPrefix = buildForkResultPrefix(pending);
-          const syntheticEvent: ParallEvent = {
-            type: "message",
-            targetId: "_orchestrator",
-            targetType: "system",
-            senderId: "system",
-            senderName: "system",
-            messageId: `synthetic-${this.opts.accountId}-${randomUUID()}`,
-            body: "[Orchestrator: fork session(s) completed — review results above]",
-          };
-          this.dispatchState.mainCurrentTargetId = undefined;
-          this.dispatchState.mainPreDispatchBranchPoint =
-            this.opts.dispatchAdapter.getBranchPoint?.(this.opts.runtimeKey);
-          const dispatched = await this.runDispatch(syntheticEvent, this.opts.runtimeKey, forkPrefix + buildEventBody(syntheticEvent));
-          if (!dispatched) {
-            // Shutdown: put the fork results back at the head so the synthetic
-            // event is regenerated on the replacement pod. Synthetic events are
-            // not ack'd, so this is the only state we need to preserve.
-            this.dispatchState.pendingForkResults.unshift(...pending);
-            break;
-          }
-          continue;
-        }
 
         const targetId = this.dispatchState.mainBuffer[0].targetId;
         const events: ParallEvent[] = [];
@@ -909,13 +924,21 @@ export class ParallAgentGateway {
 
         const event = events[events.length - 1];
         const earlier = events.slice(0, -1);
-        const skipForkSplice = this.opts.dispatchAdapter.hasPendingInjections?.(this.opts.runtimeKey) ?? false;
-        const pendingFork = skipForkSplice ? [] : this.dispatchState.pendingForkResults.splice(0);
+        const hasPendingInjections = this.opts.dispatchAdapter.hasPendingInjections?.(this.opts.runtimeKey) ?? false;
+        const injectedTypingCount = hasPendingInjections ? this.takeInjectedTypingCount(event.targetId) : 0;
+        const pendingFork = hasPendingInjections ? [] : this.dispatchState.pendingForkResults.splice(0);
         const forkPrefix = buildForkResultPrefix(pendingFork);
         this.dispatchState.mainCurrentTargetId = event.targetId;
         this.dispatchState.mainPreDispatchBranchPoint =
           this.opts.dispatchAdapter.getBranchPoint?.(this.opts.runtimeKey);
-        const dispatched = await this.runDispatch(event, this.opts.runtimeKey, forkPrefix + buildEventBody(event), earlier);
+        const dispatched = await this.runDispatchWithTyping(
+          event,
+          this.opts.runtimeKey,
+          forkPrefix + buildEventBody(event),
+          earlier,
+          undefined,
+          { suppressStart: injectedTypingCount > 0, injectedTypingCount },
+        );
         if (!dispatched) {
           // Shutdown: skip the ack so the server redelivers these buffered
           // events to the replacement pod via dispatch catch-up. Put both the
@@ -957,7 +980,7 @@ export class ParallAgentGateway {
           this.opts.dispatchAdapter.getBranchPoint?.(this.opts.runtimeKey);
         let dispatched = false;
         try {
-          dispatched = await this.runDispatch(event, this.opts.runtimeKey, forkPrefix + buildEventBody(event));
+          dispatched = await this.runDispatchWithTyping(event, this.opts.runtimeKey, forkPrefix + buildEventBody(event));
           if (!dispatched) {
             // Shutdown short-circuit — restore the fork results so a future
             // pod can replay them, and return false so handleMessage skips ack.
@@ -973,15 +996,26 @@ export class ParallAgentGateway {
         if (this.shuttingDown) {
           return false;
         }
+        // Push synchronously BEFORE the (possibly async) steer attempt so
+        // arrival order is preserved and the event cannot be orphaned in a
+        // gap between the steer await and the push.
+        this.dispatchState.mainBuffer.push(event);
         if (
           this.dispatchState.mainCurrentTargetId === event.targetId &&
-          this.opts.dispatchAdapter.enqueueDuringDispatch?.(this.opts.runtimeKey, buildEventBody(event))
+          await this.opts.dispatchAdapter.enqueueDuringDispatch?.(this.opts.runtimeKey, buildEventBody(event))
         ) {
+          this.startInjectedTyping(event);
           this.opts.log?.info(
-            `parall[${this.opts.accountId}]: steer injected to stdin for ${event.messageId} (will drain for bookkeeping)`,
+            `parall[${this.opts.accountId}]: steer injected for ${event.messageId} (will drain for bookkeeping)`,
           );
         }
-        this.dispatchState.mainBuffer.push(event);
+        // If the main dispatch cycle ended while we awaited the steer RPC,
+        // our event is buffered but no drain is in flight. Re-enter the
+        // drain to process it. The draining guard prevents re-entry.
+        if (!this.dispatchState.mainDispatching && !this.draining && this.dispatchState.mainBuffer.length > 0) {
+          this.dispatchState.mainDispatching = true;
+          void this.drainMainBuffer();
+        }
         return false;
       }
 
@@ -1098,6 +1132,7 @@ export class ParallAgentGateway {
         threadRootId: message.thread_root_id ?? undefined,
         noReply: message.hints?.no_reply ?? false,
         attachments: attachments.length > 0 ? attachments : undefined,
+        sentAt: message.created_at,
         ackSourceType: "message",
         ackSourceId: message.id,
       },
@@ -1118,8 +1153,6 @@ export class ParallAgentGateway {
     }
     const event = decision.event;
 
-    const willDispatch = !this.dispatchState.mainDispatching || this.dispatchState.mainCurrentTargetId !== chatId;
-    if (willDispatch) this.startTyping(chatId);
     try {
       const dispatched = await this.handleInboundEvent(event);
       if (dispatched) {
@@ -1130,8 +1163,6 @@ export class ParallAgentGateway {
     } catch (err) {
       this.opts.log?.error(`parall[${this.opts.accountId}]: event dispatch failed for ${data.id}: ${String(err)}`);
       this.dispatchedMessages.delete(data.id);
-    } finally {
-      if (willDispatch) this.stopTyping(chatId);
     }
   }
 
@@ -1160,6 +1191,7 @@ export class ParallAgentGateway {
       senderName: "system",
       messageId: task.id,
       body: parts.join("\n"),
+      sentAt: task.updated_at ?? task.created_at,
       ackSourceType: "task_activity",
       ackSourceId,
     };

package/src/index.ts

@@ -5,6 +5,7 @@ export * from "./event-format.js";
 export * from "./prompt-fragments.js";
 export * from "./bridge-workspace.js";
 export * from "./dispatch-adapter.js";
+export { createLogger } from "./logger.js";
 export * from "./gateway-base.js";
 export * from "./platform-config.js";
 export { writeSkillFiles, buildSkillReferences, SKILLS } from "./skills/index.js";

package/src/logger.ts

@@ -0,0 +1,9 @@
+import type { GatewayLogger } from "./dispatch-adapter.js";
+
+export function createLogger(prefix: string): GatewayLogger {
+  return {
+    info: (msg: string) => console.log(`${new Date().toISOString()} [${prefix}] ${msg}`),
+    warn: (msg: string) => console.warn(`${new Date().toISOString()} [${prefix}] ${msg}`),
+    error: (msg: string) => console.error(`${new Date().toISOString()} [${prefix}] ${msg}`),
+  };
+}

package/src/types.ts

@@ -2,6 +2,8 @@
 export type ForkResult = {
   forkSessionKey: string;
   sourceEvent: { type: string; targetId: string; summary: string };
+  /** Original event bodies that the fork processed, built via `buildEventBody()`. */
+  eventBodies: string[];
   actions: string[];
   /** Agent's own summary of what it did (captured from the fork's last text output). */
   agentSummary?: string;
@@ -43,6 +45,9 @@ export type ParallEvent = {
   scheduledFireAt?: string;
   /** Fire-time attached_to_uri snapshot, used for schedule events. */
   attachedUri?: string;
+  /** Original event timestamp (e.g., message.created_at). When present,
+   *  input steps use this instead of server insertion time for ordering. */
+  sentAt?: string;
   ackSourceType?: "message" | "task_activity" | "comment" | "schedule_run";
   ackSourceId?: string;
 };