@parall/agent-core 1.26.3 → 1.28.0

package/dist/dispatch-adapter.d.ts

@@ -24,6 +24,11 @@ export type DispatchContext = {
     log?: GatewayLogger;
 };
 export type RuntimeEvent = {
+    type: "runtime_session";
+    runtimeSessionId: string;
+    runtimeLaneKey?: string;
+    runtimeRef?: Record<string, unknown>;
+} | {
     type: "thinking";
     text: string;
     groupKey?: string;
@@ -80,5 +85,7 @@ export interface DispatchAdapter {
     cleanupFork?(opts: CleanupForkOpts): Promise<void> | void;
     /** Return the current on-disk branch point (leaf ID) for the given session, if available. */
     getBranchPoint?(sessionKey: string): string | undefined;
+    /** Return the path to the session's history file on disk, if the runtime persists it. */
+    getSessionHistoryPath?(sessionKey: string): string | undefined;
 }
 //# sourceMappingURL=dispatch-adapter.d.ts.map

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":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,aAAa,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,GACD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9G;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACjI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,eAAe,CAAC;IACzB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAE1D,+FAA+F;IAC/F,WAAW,CAAC,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,iBAAiB,GAAG,IAAI,CAAC;IAE3F,wDAAwD;IACxD,WAAW,CAAC,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAE1D,6FAA6F;IAC7F,cAAc,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAExD,yFAAyF;IACzF,qBAAqB,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAChE"}

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;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAK/D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CASnE"}
+{"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,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAK/D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAWnE"}

package/dist/event-format.js

@@ -69,7 +69,7 @@ export function buildForkScopePrefix(event) {
     const targetLabel = event.targetName
         ? `"${event.targetName}" (prll://${event.targetId})`
         : `prll://${event.targetId}`;
-    return `[Fork scope: You are a parallel worker handling ${targetLabel} only. The conversation history above is inherited context — do NOT complete unfinished work, retry failed tool calls, or send messages to other chats from that history. Only act on the event below.]\n\n`;
+    return `[Fork scope: You are a parallel worker forked from the main session to handle ${targetLabel}. The conversation history above belongs to the main session's in-progress dispatch — do NOT continue it or complete it, or produce external output (comments, messages) for work visible there. The main session owns its own output.\n\nOnly act on the event below within your target scope. If your event reveals findings about the main session's work, report them in your summary — do not post them externally.\n\nEnd with a brief "Fork summary" of actions taken and decisions made.]\n\n`;
 }
 export function buildForkResultPrefix(results) {
     if (!results.length)
@@ -79,6 +79,10 @@ export function buildForkResultPrefix(results) {
         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}]`);
         return lines.join("\n");
     });
     return blocks.join("\n\n") + "\n\n---\n\n";

package/dist/gateway-base.d.ts

@@ -28,6 +28,12 @@ export type ParallGatewayOptions = {
         ws: ParallWs;
         runtimeKey: string;
     }) => Promise<void> | void;
+    onSessionBinding?: (state: {
+        sessionKey: string;
+        agentSessionId: string;
+        runtimeSessionId: string;
+        runtimeLaneKey: string;
+    }) => Promise<void> | void;
     onBeforeDisconnect?: () => Promise<void> | void;
 };
 export declare function parseShutdownDeadlineMs(raw: string | undefined): number | undefined;
@@ -41,6 +47,7 @@ export declare class ParallAgentGateway {
     private readonly dispatchState;
     private sessionId;
     private activeSessionId;
+    private readonly sessionBindings;
     private heartbeatTimer;
     private hadSuccessfulHello;
     private lastHeartbeatAt;
@@ -61,11 +68,13 @@ export declare class ParallAgentGateway {
     private createRuntimeStep;
     private writeContextFile;
     private updateContextFileStepId;
+    private updateContextFileSessionId;
     /** @deprecated Use writeContextFile / updateContextFileStepId. */
     private writeStepIdFile;
     /** @deprecated Use writeContextFile / updateContextFileStepId. */
     private clearStepIdFile;
     private createInputStepsForEarlierEvents;
+    private bindRuntimeSession;
     private runDispatch;
     private runForkDrainLoop;
     private drainMainBuffer;

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

@@ -66,6 +66,7 @@ export class ParallAgentGateway {
     };
     sessionId = "";
     activeSessionId;
+    sessionBindings = new Map();
     heartbeatTimer = null;
     hadSuccessfulHello = false;
     lastHeartbeatAt = Date.now();
@@ -266,6 +267,7 @@ export class ParallAgentGateway {
             this.opts.ws.sendTyping(chatId, "stop");
     }
     buildDispatchContext(event, sessionKey) {
+        const binding = this.sessionBindings.get(sessionKey);
         return {
             accountId: this.opts.accountId,
             apiUrl: this.opts.config.parall_url,
@@ -274,7 +276,7 @@ export class ParallAgentGateway {
             agentUserId: this.opts.agentUserId,
             runtimeType: this.opts.runtimeType,
             runtimeKey: this.opts.runtimeKey,
-            sessionId: this.activeSessionId,
+            sessionId: binding?.agentSessionId,
             chatId: (event.type === "message" || event.type === "approval") ? event.targetId : undefined,
             triggerMessageId: event.messageId,
             noReply: event.noReply ?? false,
@@ -284,12 +286,10 @@ export class ParallAgentGateway {
             log: this.opts.log,
         };
     }
-    async createInputStep(event) {
-        if (!this.activeSessionId)
-            return;
+    async createInputStep(sessionId, event) {
         const target = resolveStepTarget(event);
         try {
-            await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, {
+            await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, sessionId, {
                 step_type: "input",
                 target_type: target.target_type,
                 target_id: target.target_id,
@@ -314,14 +314,12 @@ export class ParallAgentGateway {
             this.opts.log?.warn(`parall[${this.opts.accountId}]: failed to create input step: ${String(err)}`);
         }
     }
-    async createRuntimeStep(event, runtimeEvent, stepIdFilePath, contextFilePath) {
-        if (!this.activeSessionId)
-            return;
+    async createRuntimeStep(sessionId, event, runtimeEvent, stepIdFilePath, contextFilePath) {
         const target = resolveStepTarget(event);
         try {
             switch (runtimeEvent.type) {
                 case "thinking":
-                    await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, {
+                    await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, sessionId, {
                         step_type: "thinking",
                         target_type: target.target_type,
                         target_id: target.target_id,
@@ -330,7 +328,7 @@ export class ParallAgentGateway {
                     });
                     break;
                 case "text":
-                    await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, {
+                    await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, sessionId, {
                         step_type: "text",
                         target_type: target.target_type,
                         target_id: target.target_id,
@@ -343,7 +341,7 @@ export class ParallAgentGateway {
                     });
                     break;
                 case "tool_call": {
-                    const step = await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, {
+                    const step = await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, sessionId, {
                         step_type: "tool_call",
                         target_type: target.target_type,
                         target_id: target.target_id,
@@ -366,7 +364,7 @@ export class ParallAgentGateway {
                     break;
                 }
                 case "tool_result":
-                    await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, {
+                    await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, sessionId, {
                         step_type: "tool_result",
                         target_type: target.target_type,
                         target_id: target.target_id,
@@ -388,7 +386,7 @@ export class ParallAgentGateway {
                     }
                     break;
                 case "error":
-                    await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, {
+                    await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, sessionId, {
                         step_type: "text",
                         target_type: target.target_type,
                         target_id: target.target_id,
@@ -422,6 +420,17 @@ export class ParallAgentGateway {
             this.opts.log?.warn(`parall[${this.opts.accountId}]: failed to update context file step_id ${filePath}: ${String(err)}`);
         }
     }
+    updateContextFileSessionId(filePath, sessionId) {
+        try {
+            const raw = fs.readFileSync(filePath, "utf8");
+            const ctx = JSON.parse(raw);
+            ctx.session_id = sessionId;
+            fs.writeFileSync(filePath, JSON.stringify(ctx), "utf8");
+        }
+        catch (err) {
+            this.opts.log?.warn(`parall[${this.opts.accountId}]: failed to update context file session_id ${filePath}: ${String(err)}`);
+        }
+    }
     /** @deprecated Use writeContextFile / updateContextFileStepId. */
     writeStepIdFile(filePath, stepId) {
         try {
@@ -441,16 +450,56 @@ export class ParallAgentGateway {
             // Best-effort cleanup.
         }
     }
-    async createInputStepsForEarlierEvents(events) {
+    async createInputStepsForEarlierEvents(sessionId, events) {
         for (const event of events) {
-            await this.createInputStep(event);
+            await this.createInputStep(sessionId, event);
         }
     }
+    async bindRuntimeSession(sessionKey, runtimeEvent, contextFilePath) {
+        const runtimeLaneKey = runtimeEvent.runtimeLaneKey || sessionKey;
+        const existing = this.sessionBindings.get(sessionKey);
+        if (existing &&
+            existing.runtimeLaneKey === runtimeLaneKey &&
+            existing.runtimeSessionId === runtimeEvent.runtimeSessionId) {
+            return existing;
+        }
+        const parentSessionId = sessionKey === this.opts.runtimeKey
+            ? undefined
+            : this.sessionBindings.get(this.opts.runtimeKey)?.agentSessionId;
+        const runtimeRef = {
+            ...(this.opts.runtimeRef ?? {}),
+            ...(runtimeEvent.runtimeRef ?? {}),
+        };
+        const session = await this.opts.client.createAgentSession(this.opts.config.org_id, this.opts.agentUserId, {
+            runtime_type: this.opts.runtimeType,
+            runtime_key: runtimeLaneKey,
+            runtime_lane_key: runtimeLaneKey,
+            runtime_session_id: runtimeEvent.runtimeSessionId,
+            parent_session_id: parentSessionId,
+            runtime_ref: Object.keys(runtimeRef).length > 0 ? runtimeRef : undefined,
+        });
+        const binding = {
+            sessionKey,
+            agentSessionId: session.id,
+            runtimeLaneKey,
+            runtimeSessionId: runtimeEvent.runtimeSessionId,
+            parentSessionId,
+        };
+        this.sessionBindings.set(sessionKey, binding);
+        if (sessionKey === this.opts.runtimeKey) {
+            this.activeSessionId = session.id;
+        }
+        if (contextFilePath) {
+            this.updateContextFileSessionId(contextFilePath, session.id);
+        }
+        await this.opts.onSessionBinding?.(binding);
+        return binding;
+    }
     // Returns true if the dispatch actually ran; false if skipped because we
     // are shutting down. Callers MUST treat `false` as "not dispatched" and
     // skip the server-side ack so the event stays in the dispatch queue for
     // catch-up on the replacement pod — otherwise we silently drop work.
-    async runDispatch(event, sessionKey, bodyForAgent, earlierEvents = []) {
+    async runDispatch(event, sessionKey, bodyForAgent, earlierEvents = [], captureText) {
         // Graceful shutdown: once SIGTERM has fired we stop accepting new work.
         // In-flight dispatches that started before the flag flipped keep running
         // and are awaited by shutdown() up to SHUTDOWN_DEADLINE_MS.
@@ -478,23 +527,10 @@ export class ParallAgentGateway {
         // — JS event loop is single-threaded, so shutdown() cannot interleave
         // here and miss our in-flight count.
         this.inFlightDispatches++;
+        let binding = this.sessionBindings.get(sessionKey);
+        let inputStepsCreated = false;
+        let triggerMessageSet = false;
         try {
-            if (this.activeSessionId) {
-                try {
-                    await this.opts.client.updateAgentSession(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, { status: "active", trigger_message_id: event.messageId });
-                }
-                catch (err) {
-                    this.opts.log?.warn(`parall[${this.opts.accountId}]: failed to set session active: ${String(err)}`);
-                }
-            }
-            // Persist input steps for "earlier events" (batched events that arrived
-            // while a dispatch was in flight) inside the in-flight window so a
-            // shutdown short-circuit BEFORE this point cannot leave orphan input
-            // steps that the replacement pod would duplicate on replay.
-            if (earlierEvents.length > 0) {
-                await this.createInputStepsForEarlierEvents(earlierEvents);
-            }
-            await this.createInputStep(event);
             for await (const runtimeEvent of this.opts.dispatchAdapter.dispatch({
                 event,
                 earlierEvents,
@@ -502,17 +538,57 @@ export class ParallAgentGateway {
                 sessionKey,
                 context: dispatchContext,
             })) {
-                await this.createRuntimeStep(event, runtimeEvent, stepIdFilePath, contextFilePath);
+                if (runtimeEvent.type === "runtime_session") {
+                    binding = await this.bindRuntimeSession(sessionKey, runtimeEvent, contextFilePath);
+                    if (!inputStepsCreated) {
+                        // Persist input steps for "earlier events" (batched events that arrived
+                        // while a dispatch was in flight) inside the in-flight window so a
+                        // shutdown short-circuit BEFORE this point cannot leave orphan input
+                        // steps that the replacement pod would duplicate on replay.
+                        if (earlierEvents.length > 0) {
+                            await this.createInputStepsForEarlierEvents(binding.agentSessionId, earlierEvents);
+                        }
+                        await this.createInputStep(binding.agentSessionId, event);
+                        inputStepsCreated = true;
+                    }
+                    continue;
+                }
+                if (!binding) {
+                    throw new Error(`runtime emitted ${runtimeEvent.type} before runtime_session`);
+                }
+                if (!triggerMessageSet) {
+                    triggerMessageSet = true;
+                    this.opts.client.updateAgentSession(this.opts.config.org_id, this.opts.agentUserId, binding.agentSessionId, { status: "active", trigger_message_id: event.messageId }).catch((err) => this.opts.log?.warn?.(`failed to set session active: ${err}`));
+                }
+                if (!inputStepsCreated) {
+                    if (earlierEvents.length > 0) {
+                        await this.createInputStepsForEarlierEvents(binding.agentSessionId, earlierEvents);
+                    }
+                    await this.createInputStep(binding.agentSessionId, event);
+                    inputStepsCreated = true;
+                }
+                if (captureText && runtimeEvent.type === "text" && runtimeEvent.text) {
+                    captureText.push(runtimeEvent.text);
+                }
+                await this.createRuntimeStep(binding.agentSessionId, event, runtimeEvent, stepIdFilePath, contextFilePath);
+            }
+            if (!binding) {
+                throw new Error("runtime completed without runtime_session");
             }
         }
         catch (err) {
-            await this.createRuntimeStep(event, {
-                type: "error",
-                message: `Dispatch failed: ${String(err)}`,
-            }, stepIdFilePath, contextFilePath);
+            if (binding) {
+                await this.createRuntimeStep(binding.agentSessionId, event, {
+                    type: "error",
+                    message: `Dispatch failed: ${String(err)}`,
+                }, stepIdFilePath, contextFilePath);
+            }
             throw err;
         }
         finally {
+            if (triggerMessageSet && binding) {
+                this.opts.client.updateAgentSession(this.opts.config.org_id, this.opts.agentUserId, binding.agentSessionId, { status: "idle" }).catch((err) => this.opts.log?.warn?.(`failed to set session idle: ${err}`));
+            }
             clearSessionMessageId(sessionKey);
             clearDispatchMessageId(sessionKey);
             clearDispatchNoReply(sessionKey);
@@ -522,14 +598,6 @@ export class ParallAgentGateway {
             else if (stepIdFilePath) {
                 this.clearStepIdFile(stepIdFilePath);
             }
-            if (this.activeSessionId) {
-                try {
-                    await this.opts.client.updateAgentSession(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, { status: "idle" });
-                }
-                catch (err) {
-                    this.opts.log?.warn(`parall[${this.opts.accountId}]: failed to set session idle: ${String(err)}`);
-                }
-            }
             this.inFlightDispatches--;
             if (this.inFlightDispatches === 0 && this.drainResolvers.length > 0) {
                 const resolvers = this.drainResolvers.splice(0);
@@ -540,6 +608,7 @@ export class ParallAgentGateway {
         return true;
     }
     async runForkDrainLoop(fork) {
+        let lastCapturedText = [];
         try {
             while (fork.queue.length > 0) {
                 // Early shutdown guard — pure optimization to avoid wasted draining
@@ -558,7 +627,8 @@ export class ParallAgentGateway {
                 const last = events[events.length - 1];
                 const earlier = events.slice(0, -1);
                 try {
-                    const dispatched = await this.runDispatch(last, fork.fork.sessionKey, buildForkScopePrefix(last) + buildEventBody(last), earlier);
+                    const batchText = [];
+                    const dispatched = await this.runDispatch(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.
@@ -567,6 +637,8 @@ export class ParallAgentGateway {
                         }
                         break;
                     }
+                    if (batchText.length > 0)
+                        lastCapturedText = batchText;
                     fork.processedEvents.push(...events);
                     for (const item of items) {
                         item.resolve(true);
@@ -587,6 +659,14 @@ export class ParallAgentGateway {
         finally {
             if (fork.processedEvents.length > 0) {
                 const first = fork.processedEvents[0];
+                const agentSummary = lastCapturedText.join("").trim() || undefined;
+                let historyPath;
+                try {
+                    historyPath = this.opts.dispatchAdapter.getSessionHistoryPath?.(fork.fork.sessionKey);
+                }
+                catch (err) {
+                    this.opts.log?.warn?.(`parall[${this.opts.accountId}]: failed to resolve fork history path: ${String(err)}`);
+                }
                 this.dispatchState.pendingForkResults.push({
                     forkSessionKey: fork.fork.sessionKey,
                     sourceEvent: {
@@ -597,10 +677,13 @@ export class ParallAgentGateway {
                             : `${fork.processedEvents.length} events in ${first.targetName ?? fork.targetId}`,
                     },
                     actions: [],
+                    agentSummary,
+                    historyPath,
                 });
             }
             this.forkStates.delete(fork.targetId);
             this.dispatchState.activeForks.delete(fork.targetId);
+            const forkBinding = this.sessionBindings.get(fork.fork.sessionKey);
             if (this.opts.dispatchAdapter.cleanupFork) {
                 const cleanupOpts = {
                     fork: fork.fork,
@@ -612,7 +695,7 @@ export class ParallAgentGateway {
                         agentUserId: this.opts.agentUserId,
                         runtimeType: this.opts.runtimeType,
                         runtimeKey: this.opts.runtimeKey,
-                        sessionId: this.activeSessionId,
+                        sessionId: forkBinding?.agentSessionId,
                         noReply: false,
                         client: this.opts.client,
                         log: this.opts.log,
@@ -620,6 +703,10 @@ export class ParallAgentGateway {
                 };
                 await this.opts.dispatchAdapter.cleanupFork(cleanupOpts);
             }
+            if (forkBinding) {
+                this.opts.client.updateAgentSession(this.opts.config.org_id, this.opts.agentUserId, forkBinding.agentSessionId, { status: "closed" }).catch(() => { });
+                this.sessionBindings.delete(fork.fork.sessionKey);
+            }
         }
     }
     async drainMainBuffer() {
@@ -1233,20 +1320,6 @@ export class ParallAgentGateway {
         try {
             const count = await fetchAllChats(client, config.org_id, this.chatInfoMap);
             log?.info(`parall[${this.opts.accountId}]: WebSocket connected, ${count} chats cached`);
-            if (!this.activeSessionId) {
-                try {
-                    const session = await client.createAgentSession(config.org_id, this.opts.agentUserId, {
-                        runtime_type: this.opts.runtimeType,
-                        runtime_key: this.opts.runtimeKey,
-                        runtime_ref: this.opts.runtimeRef,
-                    });
-                    this.activeSessionId = session.id;
-                    log?.info(`parall[${this.opts.accountId}]: created agent session ${session.id}`);
-                }
-                catch (err) {
-                    log?.warn(`parall[${this.opts.accountId}]: failed to create agent session: ${String(err)}`);
-                }
-            }
             await this.opts.onSessionReady?.({
                 activeSessionId: this.activeSessionId,
                 ws: this.opts.ws,
@@ -1329,16 +1402,6 @@ export class ParallAgentGateway {
         }
         this.activeDispatches.clear();
         await this.opts.onBeforeDisconnect?.();
-        if (this.activeSessionId) {
-            try {
-                await this.opts.client.updateAgentSession(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, {
-                    status: "completed",
-                });
-            }
-            catch (err) {
-                this.opts.log?.warn(`parall[${this.opts.accountId}]: failed to complete session: ${String(err)}`);
-            }
-        }
         this.opts.ws.disconnect();
         this.opts.log?.info(`parall[${this.opts.accountId}]: disconnected`);
     }

package/dist/types.d.ts

@@ -7,6 +7,10 @@ export type ForkResult = {
         summary: string;
     };
     actions: string[];
+    /** Agent's own summary of what it did (captured from the fork's last text output). */
+    agentSummary?: string;
+    /** Path to the fork session's history file on disk, when the runtime persists it. */
+    historyPath?: string;
 };
 /** Mutable dispatch state for the orchestrator gateway. */
 export type DispatchState = {

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;CACnB,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,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"}

package/package.json

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

package/src/dispatch-adapter.ts

@@ -27,6 +27,12 @@ export type DispatchContext = {
 };
 
 export type RuntimeEvent =
+  | {
+      type: "runtime_session";
+      runtimeSessionId: string;
+      runtimeLaneKey?: string;
+      runtimeRef?: Record<string, unknown>;
+    }
   | { type: "thinking"; text: string; groupKey?: string }
   | { type: "tool_call"; callId: string; toolName: string; input: unknown; startedAt?: string; groupKey?: string }
   | { type: "tool_result"; callId: string; toolName: string; output: string; error?: string; durationMs?: number; groupKey?: string }
@@ -69,4 +75,7 @@ export interface DispatchAdapter {
 
   /** Return the current on-disk branch point (leaf ID) for the given session, if available. */
   getBranchPoint?(sessionKey: string): string | undefined;
+
+  /** Return the path to the session's history file on disk, if the runtime persists it. */
+  getSessionHistoryPath?(sessionKey: string): string | undefined;
 }

package/src/event-format.ts

@@ -64,7 +64,7 @@ export function buildForkScopePrefix(event: ParallEvent): string {
   const targetLabel = event.targetName
     ? `"${event.targetName}" (prll://${event.targetId})`
     : `prll://${event.targetId}`;
-  return `[Fork scope: You are a parallel worker handling ${targetLabel} only. The conversation history above is inherited context — do NOT complete unfinished work, retry failed tool calls, or send messages to other chats from that history. Only act on the event below.]\n\n`;
+  return `[Fork scope: You are a parallel worker forked from the main session to handle ${targetLabel}. The conversation history above belongs to the main session's in-progress dispatch — do NOT continue it or complete it, or produce external output (comments, messages) for work visible there. The main session owns its own output.\n\nOnly act on the event below within your target scope. If your event reveals findings about the main session's work, report them in your summary — do not post them externally.\n\nEnd with a brief "Fork summary" of actions taken and decisions made.]\n\n`;
 }
 
 export function buildForkResultPrefix(results: ForkResult[]): string {
@@ -73,6 +73,8 @@ export function buildForkResultPrefix(results: ForkResult[]): string {
     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}]`);
     return lines.join("\n");
   });
   return blocks.join("\n\n") + "\n\n---\n\n";

package/src/gateway-base.ts

@@ -5,6 +5,7 @@ import { randomUUID } from "node:crypto";
 import { MENTION_ALL_USER_ID, ParallClient, ParallWs } from "@parall/sdk";
 import type {
   AgentConfigUpdateData,
+  AgentSessionDB,
   Approval,
   Chat,
   ChatUpdateData,
@@ -104,9 +105,18 @@ export type ParallGatewayOptions = {
   stepIdFilePathForSession?: (sessionKey: string) => string | undefined;
   onConfigUpdate?: (data: AgentConfigUpdateData) => Promise<void> | void;
   onSessionReady?: (state: { activeSessionId?: string; ws: ParallWs; runtimeKey: string }) => Promise<void> | void;
+  onSessionBinding?: (state: { sessionKey: string; agentSessionId: string; runtimeSessionId: string; runtimeLaneKey: string }) => Promise<void> | void;
   onBeforeDisconnect?: () => Promise<void> | void;
 };
 
+type AgentSessionBinding = {
+  sessionKey: string;
+  agentSessionId: string;
+  runtimeLaneKey: string;
+  runtimeSessionId: string;
+  parentSessionId?: string;
+};
+
 // Parse PRLL_SHUTDOWN_DEADLINE_MS (or any string env value) into a positive
 // integer milliseconds value, or undefined if unset/invalid. Runtimes pass
 // the result into ParallGatewayOptions.shutdownDeadlineMs; leaving it
@@ -172,6 +182,7 @@ export class ParallAgentGateway {
 
   private sessionId = "";
   private activeSessionId: string | undefined;
+  private readonly sessionBindings = new Map<string, AgentSessionBinding>();
   private heartbeatTimer: ReturnType<typeof setInterval> | null = null;
   private hadSuccessfulHello = false;
   private lastHeartbeatAt = Date.now();
@@ -367,6 +378,7 @@ export class ParallAgentGateway {
   }
 
   private buildDispatchContext(event: ParallEvent, sessionKey: string): DispatchContext {
+    const binding = this.sessionBindings.get(sessionKey);
     return {
       accountId: this.opts.accountId,
       apiUrl: this.opts.config.parall_url,
@@ -375,7 +387,7 @@ export class ParallAgentGateway {
       agentUserId: this.opts.agentUserId,
       runtimeType: this.opts.runtimeType,
       runtimeKey: this.opts.runtimeKey,
-      sessionId: this.activeSessionId,
+      sessionId: binding?.agentSessionId,
       chatId: (event.type === "message" || event.type === "approval") ? event.targetId : undefined,
       triggerMessageId: event.messageId,
       noReply: event.noReply ?? false,
@@ -386,11 +398,10 @@ export class ParallAgentGateway {
     };
   }
 
-  private async createInputStep(event: ParallEvent) {
-    if (!this.activeSessionId) return;
+  private async createInputStep(sessionId: string, event: ParallEvent) {
     const target = resolveStepTarget(event);
     try {
-      await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, {
+      await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, sessionId, {
         step_type: "input",
         target_type: target.target_type,
         target_id: target.target_id,
@@ -417,14 +428,13 @@ export class ParallAgentGateway {
     }
   }
 
-  private async createRuntimeStep(event: ParallEvent, runtimeEvent: RuntimeEvent, stepIdFilePath?: string, contextFilePath?: string) {
-    if (!this.activeSessionId) return;
+  private async createRuntimeStep(sessionId: string, event: ParallEvent, runtimeEvent: RuntimeEvent, stepIdFilePath?: string, contextFilePath?: string) {
 
     const target = resolveStepTarget(event);
     try {
       switch (runtimeEvent.type) {
         case "thinking":
-          await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, {
+          await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, sessionId, {
             step_type: "thinking",
             target_type: target.target_type,
             target_id: target.target_id,
@@ -434,7 +444,7 @@ export class ParallAgentGateway {
           break;
 
         case "text":
-          await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, {
+          await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, sessionId, {
             step_type: "text",
             target_type: target.target_type,
             target_id: target.target_id,
@@ -448,7 +458,7 @@ export class ParallAgentGateway {
           break;
 
         case "tool_call": {
-          const step = await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, {
+          const step = await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, sessionId, {
             step_type: "tool_call",
             target_type: target.target_type,
             target_id: target.target_id,
@@ -471,7 +481,7 @@ export class ParallAgentGateway {
         }
 
         case "tool_result":
-          await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, {
+          await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, sessionId, {
             step_type: "tool_result",
             target_type: target.target_type,
             target_id: target.target_id,
@@ -493,7 +503,7 @@ export class ParallAgentGateway {
           break;
 
         case "error":
-          await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, {
+          await this.opts.client.createAgentStep(this.opts.config.org_id, this.opts.agentUserId, sessionId, {
             step_type: "text",
             target_type: target.target_type,
             target_id: target.target_id,
@@ -527,6 +537,17 @@ export class ParallAgentGateway {
     }
   }
 
+  private updateContextFileSessionId(filePath: string, sessionId: string) {
+    try {
+      const raw = fs.readFileSync(filePath, "utf8");
+      const ctx = JSON.parse(raw);
+      ctx.session_id = sessionId;
+      fs.writeFileSync(filePath, JSON.stringify(ctx), "utf8");
+    } catch (err) {
+      this.opts.log?.warn(`parall[${this.opts.accountId}]: failed to update context file session_id ${filePath}: ${String(err)}`);
+    }
+  }
+
   /** @deprecated Use writeContextFile / updateContextFileStepId. */
   private writeStepIdFile(filePath: string, stepId: string) {
     try {
@@ -546,12 +567,60 @@ export class ParallAgentGateway {
     }
   }
 
-  private async createInputStepsForEarlierEvents(events: ParallEvent[]) {
+  private async createInputStepsForEarlierEvents(sessionId: string, events: ParallEvent[]) {
     for (const event of events) {
-      await this.createInputStep(event);
+      await this.createInputStep(sessionId, event);
     }
   }
 
+  private async bindRuntimeSession(
+    sessionKey: string,
+    runtimeEvent: Extract<RuntimeEvent, { type: "runtime_session" }>,
+    contextFilePath?: string,
+  ): Promise<AgentSessionBinding> {
+    const runtimeLaneKey = runtimeEvent.runtimeLaneKey || sessionKey;
+    const existing = this.sessionBindings.get(sessionKey);
+    if (
+      existing &&
+      existing.runtimeLaneKey === runtimeLaneKey &&
+      existing.runtimeSessionId === runtimeEvent.runtimeSessionId
+    ) {
+      return existing;
+    }
+
+    const parentSessionId = sessionKey === this.opts.runtimeKey
+      ? undefined
+      : this.sessionBindings.get(this.opts.runtimeKey)?.agentSessionId;
+    const runtimeRef = {
+      ...(this.opts.runtimeRef ?? {}),
+      ...(runtimeEvent.runtimeRef ?? {}),
+    };
+    const session: AgentSessionDB = await this.opts.client.createAgentSession(this.opts.config.org_id, this.opts.agentUserId, {
+      runtime_type: this.opts.runtimeType,
+      runtime_key: runtimeLaneKey,
+      runtime_lane_key: runtimeLaneKey,
+      runtime_session_id: runtimeEvent.runtimeSessionId,
+      parent_session_id: parentSessionId,
+      runtime_ref: Object.keys(runtimeRef).length > 0 ? runtimeRef : undefined,
+    });
+    const binding: AgentSessionBinding = {
+      sessionKey,
+      agentSessionId: session.id,
+      runtimeLaneKey,
+      runtimeSessionId: runtimeEvent.runtimeSessionId,
+      parentSessionId,
+    };
+    this.sessionBindings.set(sessionKey, binding);
+    if (sessionKey === this.opts.runtimeKey) {
+      this.activeSessionId = session.id;
+    }
+    if (contextFilePath) {
+      this.updateContextFileSessionId(contextFilePath, session.id);
+    }
+    await this.opts.onSessionBinding?.(binding);
+    return binding;
+  }
+
   // Returns true if the dispatch actually ran; false if skipped because we
   // are shutting down. Callers MUST treat `false` as "not dispatched" and
   // skip the server-side ack so the event stays in the dispatch queue for
@@ -561,6 +630,7 @@ export class ParallAgentGateway {
     sessionKey: string,
     bodyForAgent: string,
     earlierEvents: ParallEvent[] = [],
+    captureText?: string[],
   ): Promise<boolean> {
     // Graceful shutdown: once SIGTERM has fired we stop accepting new work.
     // In-flight dispatches that started before the flag flipped keep running
@@ -595,24 +665,10 @@ export class ParallAgentGateway {
     // — JS event loop is single-threaded, so shutdown() cannot interleave
     // here and miss our in-flight count.
     this.inFlightDispatches++;
+    let binding = this.sessionBindings.get(sessionKey);
+    let inputStepsCreated = false;
+    let triggerMessageSet = false;
     try {
-      if (this.activeSessionId) {
-        try {
-          await this.opts.client.updateAgentSession(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, { status: "active", trigger_message_id: event.messageId });
-        } catch (err) {
-          this.opts.log?.warn(`parall[${this.opts.accountId}]: failed to set session active: ${String(err)}`);
-        }
-      }
-
-      // Persist input steps for "earlier events" (batched events that arrived
-      // while a dispatch was in flight) inside the in-flight window so a
-      // shutdown short-circuit BEFORE this point cannot leave orphan input
-      // steps that the replacement pod would duplicate on replay.
-      if (earlierEvents.length > 0) {
-        await this.createInputStepsForEarlierEvents(earlierEvents);
-      }
-      await this.createInputStep(event);
-
       for await (const runtimeEvent of this.opts.dispatchAdapter.dispatch({
         event,
         earlierEvents,
@@ -620,15 +676,62 @@ export class ParallAgentGateway {
         sessionKey,
         context: dispatchContext,
       })) {
-        await this.createRuntimeStep(event, runtimeEvent, stepIdFilePath, contextFilePath);
+        if (runtimeEvent.type === "runtime_session") {
+          binding = await this.bindRuntimeSession(sessionKey, runtimeEvent, contextFilePath);
+          if (!inputStepsCreated) {
+            // Persist input steps for "earlier events" (batched events that arrived
+            // while a dispatch was in flight) inside the in-flight window so a
+            // shutdown short-circuit BEFORE this point cannot leave orphan input
+            // steps that the replacement pod would duplicate on replay.
+            if (earlierEvents.length > 0) {
+              await this.createInputStepsForEarlierEvents(binding.agentSessionId, earlierEvents);
+            }
+            await this.createInputStep(binding.agentSessionId, event);
+            inputStepsCreated = true;
+          }
+          continue;
+        }
+
+        if (!binding) {
+          throw new Error(`runtime emitted ${runtimeEvent.type} before runtime_session`);
+        }
+        if (!triggerMessageSet) {
+          triggerMessageSet = true;
+          this.opts.client.updateAgentSession(
+            this.opts.config.org_id, this.opts.agentUserId, binding.agentSessionId,
+            { status: "active", trigger_message_id: event.messageId },
+          ).catch((err) => this.opts.log?.warn?.(`failed to set session active: ${err}`));
+        }
+        if (!inputStepsCreated) {
+          if (earlierEvents.length > 0) {
+            await this.createInputStepsForEarlierEvents(binding.agentSessionId, earlierEvents);
+          }
+          await this.createInputStep(binding.agentSessionId, event);
+          inputStepsCreated = true;
+        }
+        if (captureText && runtimeEvent.type === "text" && runtimeEvent.text) {
+          captureText.push(runtimeEvent.text);
+        }
+        await this.createRuntimeStep(binding.agentSessionId, event, runtimeEvent, stepIdFilePath, contextFilePath);
+      }
+      if (!binding) {
+        throw new Error("runtime completed without runtime_session");
       }
     } catch (err) {
-      await this.createRuntimeStep(event, {
-        type: "error",
-        message: `Dispatch failed: ${String(err)}`,
-      }, stepIdFilePath, contextFilePath);
+      if (binding) {
+        await this.createRuntimeStep(binding.agentSessionId, event, {
+          type: "error",
+          message: `Dispatch failed: ${String(err)}`,
+        }, stepIdFilePath, contextFilePath);
+      }
       throw err;
     } finally {
+      if (triggerMessageSet && binding) {
+        this.opts.client.updateAgentSession(
+          this.opts.config.org_id, this.opts.agentUserId, binding.agentSessionId,
+          { status: "idle" },
+        ).catch((err) => this.opts.log?.warn?.(`failed to set session idle: ${err}`));
+      }
       clearSessionMessageId(sessionKey);
       clearDispatchMessageId(sessionKey);
       clearDispatchNoReply(sessionKey);
@@ -637,13 +740,6 @@ export class ParallAgentGateway {
       } else if (stepIdFilePath) {
         this.clearStepIdFile(stepIdFilePath);
       }
-      if (this.activeSessionId) {
-        try {
-          await this.opts.client.updateAgentSession(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, { status: "idle" });
-        } catch (err) {
-          this.opts.log?.warn(`parall[${this.opts.accountId}]: failed to set session idle: ${String(err)}`);
-        }
-      }
       this.inFlightDispatches--;
       if (this.inFlightDispatches === 0 && this.drainResolvers.length > 0) {
         const resolvers = this.drainResolvers.splice(0);
@@ -654,6 +750,7 @@ export class ParallAgentGateway {
   }
 
   private async runForkDrainLoop(fork: ActiveForkState) {
+    let lastCapturedText: string[] = [];
     try {
       while (fork.queue.length > 0) {
         // Early shutdown guard — pure optimization to avoid wasted draining
@@ -671,7 +768,8 @@ export class ParallAgentGateway {
         const last = events[events.length - 1];
         const earlier = events.slice(0, -1);
         try {
-          const dispatched = await this.runDispatch(last, fork.fork.sessionKey, buildForkScopePrefix(last) + buildEventBody(last), earlier);
+          const batchText: string[] = [];
+          const dispatched = await this.runDispatch(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.
@@ -680,6 +778,7 @@ export class ParallAgentGateway {
             }
             break;
           }
+          if (batchText.length > 0) lastCapturedText = batchText;
           fork.processedEvents.push(...events);
           for (const item of items) {
             item.resolve(true);
@@ -699,6 +798,13 @@ export class ParallAgentGateway {
     } finally {
       if (fork.processedEvents.length > 0) {
         const first = fork.processedEvents[0];
+        const agentSummary = lastCapturedText.join("").trim() || undefined;
+        let historyPath: string | undefined;
+        try {
+          historyPath = this.opts.dispatchAdapter.getSessionHistoryPath?.(fork.fork.sessionKey);
+        } catch (err) {
+          this.opts.log?.warn?.(`parall[${this.opts.accountId}]: failed to resolve fork history path: ${String(err)}`);
+        }
         this.dispatchState.pendingForkResults.push({
           forkSessionKey: fork.fork.sessionKey,
           sourceEvent: {
@@ -709,10 +815,13 @@ export class ParallAgentGateway {
               : `${fork.processedEvents.length} events in ${first.targetName ?? fork.targetId}`,
           },
           actions: [],
+          agentSummary,
+          historyPath,
         });
       }
       this.forkStates.delete(fork.targetId);
       this.dispatchState.activeForks.delete(fork.targetId);
+      const forkBinding = this.sessionBindings.get(fork.fork.sessionKey);
       if (this.opts.dispatchAdapter.cleanupFork) {
         const cleanupOpts: CleanupForkOpts = {
           fork: fork.fork,
@@ -724,7 +833,7 @@ export class ParallAgentGateway {
             agentUserId: this.opts.agentUserId,
             runtimeType: this.opts.runtimeType,
             runtimeKey: this.opts.runtimeKey,
-            sessionId: this.activeSessionId,
+            sessionId: forkBinding?.agentSessionId,
             noReply: false,
             client: this.opts.client,
             log: this.opts.log,
@@ -732,6 +841,13 @@ export class ParallAgentGateway {
         };
         await this.opts.dispatchAdapter.cleanupFork(cleanupOpts);
       }
+      if (forkBinding) {
+        this.opts.client.updateAgentSession(
+          this.opts.config.org_id, this.opts.agentUserId, forkBinding.agentSessionId,
+          { status: "closed" },
+        ).catch(() => {});
+        this.sessionBindings.delete(fork.fork.sessionKey);
+      }
     }
   }
 
@@ -1365,20 +1481,6 @@ export class ParallAgentGateway {
       const count = await fetchAllChats(client, config.org_id, this.chatInfoMap);
       log?.info(`parall[${this.opts.accountId}]: WebSocket connected, ${count} chats cached`);
 
-      if (!this.activeSessionId) {
-        try {
-          const session = await client.createAgentSession(config.org_id, this.opts.agentUserId, {
-            runtime_type: this.opts.runtimeType,
-            runtime_key: this.opts.runtimeKey,
-            runtime_ref: this.opts.runtimeRef,
-          });
-          this.activeSessionId = session.id;
-          log?.info(`parall[${this.opts.accountId}]: created agent session ${session.id}`);
-        } catch (err) {
-          log?.warn(`parall[${this.opts.accountId}]: failed to create agent session: ${String(err)}`);
-        }
-      }
-
       await this.opts.onSessionReady?.({
         activeSessionId: this.activeSessionId,
         ws: this.opts.ws,
@@ -1466,16 +1568,6 @@ export class ParallAgentGateway {
 
     await this.opts.onBeforeDisconnect?.();
 
-    if (this.activeSessionId) {
-      try {
-        await this.opts.client.updateAgentSession(this.opts.config.org_id, this.opts.agentUserId, this.activeSessionId, {
-          status: "completed",
-        });
-      } catch (err) {
-        this.opts.log?.warn(`parall[${this.opts.accountId}]: failed to complete session: ${String(err)}`);
-      }
-    }
-
     this.opts.ws.disconnect();
     this.opts.log?.info(`parall[${this.opts.accountId}]: disconnected`);
   }

package/src/types.ts

@@ -3,6 +3,10 @@ export type ForkResult = {
   forkSessionKey: string;
   sourceEvent: { type: string; targetId: string; summary: string };
   actions: string[];
+  /** Agent's own summary of what it did (captured from the fork's last text output). */
+  agentSummary?: string;
+  /** Path to the fork session's history file on disk, when the runtime persists it. */
+  historyPath?: string;
 };
 
 /** Mutable dispatch state for the orchestrator gateway. */