@parall/cli 1.52.0 → 1.52.1

package/dist/commands/messages.d.ts

@@ -1,3 +1,33 @@
 import type { Command } from 'commander';
+/**
+ * Message ↔ session/step attribution for a send. Lane context WINS over the
+ * process-level runtime context: the lane file is written per dispatch (a
+ * fork turn carries its child ase_/step), while PRLL_CONTEXT_FILE on
+ * single-process runtimes (codex app-server) is pinned to the MAIN session
+ * for the process's whole life — letting it win stamps fork replies and
+ * their dispatch rows with main's session. Runtime context only fills what
+ * the lane context does not provide.
+ *
+ * session and step are resolved as a PAIR, never independently: the server
+ * validates agent_step_id first and derives agent_session_id FROM that step,
+ * ignoring the supplied session whenever the step is valid (its check is
+ * chat-level, so a main-session step passes for a same-chat fork); when the
+ * step is stale it falls back to the supplied session instead. Either half
+ * can therefore decide the attribution, so a pair mixed from two sources has
+ * no single correct reading. The lane file writes session_id and step_id
+ * independently and may carry either alone — so once the lane supplies ANY
+ * attribution it owns both fields, and the runtime fills a gap only when it
+ * demonstrably describes the same session the lane names.
+ */
+export declare function resolveSendAttribution(ctx: {
+    sessionId?: string;
+    stepId?: string;
+}, laneCtx: {
+    sessionId?: string;
+    stepId?: string;
+} | null): {
+    sessionId?: string;
+    stepId?: string;
+};
 export declare function registerMessageCommands(program: Command): void;
 //# sourceMappingURL=messages.d.ts.map

package/dist/commands/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/commands/messages.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QAsPvD"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/commands/messages.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBzC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5C,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GACtD;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CASzC;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QAoPvD"}

package/dist/commands/messages.js

@@ -4,6 +4,36 @@ import { LaneContextError, markLaneReplyCommitted, resolveCredentials, resolveLa
 import { printError, printJson, printRefHint, stripPrllScheme } from '../lib/output.js';
 import { NO_BODY_ERROR, resolveMessageText, TEXT_FILE_OPTION_DESC, TEXT_OPTION_DESC, } from '../lib/text-input.js';
 import { uploadFile } from '../lib/upload.js';
+/**
+ * Message ↔ session/step attribution for a send. Lane context WINS over the
+ * process-level runtime context: the lane file is written per dispatch (a
+ * fork turn carries its child ase_/step), while PRLL_CONTEXT_FILE on
+ * single-process runtimes (codex app-server) is pinned to the MAIN session
+ * for the process's whole life — letting it win stamps fork replies and
+ * their dispatch rows with main's session. Runtime context only fills what
+ * the lane context does not provide.
+ *
+ * session and step are resolved as a PAIR, never independently: the server
+ * validates agent_step_id first and derives agent_session_id FROM that step,
+ * ignoring the supplied session whenever the step is valid (its check is
+ * chat-level, so a main-session step passes for a same-chat fork); when the
+ * step is stale it falls back to the supplied session instead. Either half
+ * can therefore decide the attribution, so a pair mixed from two sources has
+ * no single correct reading. The lane file writes session_id and step_id
+ * independently and may carry either alone — so once the lane supplies ANY
+ * attribution it owns both fields, and the runtime fills a gap only when it
+ * demonstrably describes the same session the lane names.
+ */
+export function resolveSendAttribution(ctx, laneCtx) {
+    if (!laneCtx?.sessionId && !laneCtx?.stepId) {
+        return { sessionId: ctx.sessionId, stepId: ctx.stepId };
+    }
+    const sameSession = laneCtx.sessionId !== undefined && laneCtx.sessionId === ctx.sessionId;
+    return {
+        sessionId: laneCtx.sessionId,
+        stepId: laneCtx.stepId ?? (sameSession ? ctx.stepId : undefined),
+    };
+}
 export function registerMessageCommands(program) {
     const messages = program.command('messages').description('Manage messages');
     messages
@@ -129,10 +159,6 @@ export function registerMessageCommands(program) {
                 req.thread_root_id = threadRootId;
             if (opts.reply === false)
                 req.hints = { no_reply: true };
-            if (ctx.stepId)
-                req.agent_step_id = ctx.stepId;
-            if (ctx.sessionId)
-                req.agent_session_id = ctx.sessionId;
             // Dispatch lane binding (PRLL_CONTEXT_DIR contract): a send whose
             // exact (chat, thread) target has an active lane context rides the
             // server's dispatch ledger — the lane token authorizes the write,
@@ -143,6 +169,11 @@ export function registerMessageCommands(program) {
             // per-invocation idempotency key. All of this stays out of the
             // model's view.
             const laneCtx = resolveLaneDispatchContext(chatId, threadRootId);
+            const attribution = resolveSendAttribution(ctx, laneCtx);
+            if (attribution.stepId)
+                req.agent_step_id = attribution.stepId;
+            if (attribution.sessionId)
+                req.agent_session_id = attribution.sessionId;
             let usedReplyKey = false;
             if (laneCtx) {
                 req.dispatch_lane = laneCtx.lane;
@@ -153,10 +184,6 @@ export function registerMessageCommands(program) {
                 else {
                     req.idempotency_key = `cli:${randomUUID()}`;
                 }
-                if (!req.agent_step_id && laneCtx.stepId)
-                    req.agent_step_id = laneCtx.stepId;
-                if (!req.agent_session_id && laneCtx.sessionId)
-                    req.agent_session_id = laneCtx.sessionId;
             }
             else {
                 // By-source dispatch binding (parel — PRLL_DISPATCH_SOURCE_* env,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/cli",
-  "version": "1.52.0",
+  "version": "1.52.1",
   "description": "CLI client for Parall — universal agent & human access to Parall API",
   "license": "MIT",
   "repository": {
@@ -36,14 +36,14 @@
     "diff": "^8.0.3",
     "js-yaml": "^4.1.0",
     "zod": "^4.3.6",
-    "@parall/sdk": "1.52.0",
-    "@parall/agent-core": "1.52.0"
+    "@parall/sdk": "1.52.1",
+    "@parall/agent-core": "1.52.1"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.0.0",
     "typescript": "^5.7.0",
-    "@parall/agent-core": "1.52.0"
+    "@parall/agent-core": "1.52.1"
   },
   "scripts": {
     "build": "tsc",