@parall/parel-channel 1.52.1 → 1.52.2

package/dist/fork.d.ts

@@ -146,13 +146,17 @@ export declare function handleChildSpawnFailed(ctx: ConnectorContext, event: Chi
  * this line keeps the child from "finishing" main's visible work).
  *
  * Replies are CLI-only on EVERY fork turn (the platform reply contract —
- * nothing auto-delivers, parel-reply-contract-alignment.md). The opening
- * turn additionally has no envelope (it starts from the spawn input), so it
- * gets no per-turn invocation context either — the prefix therefore spells
- * out the full CLI reply command with the explicit chat target; follow-ups
- * arrive as deliverTo envelopes whose invocation context presets
- * PRLL_CHAT_ID, so the system prompt's bare `parall messages send` teaching
- * covers them.
+ * nothing auto-delivers, parel-reply-contract-alignment.md). The opening turn
+ * has no envelope of its own (it starts from the spawn input), so its per-turn
+ * context rides the effect's `invocationContext` instead; follow-ups arrive as
+ * deliverTo envelopes carrying theirs the usual way.
+ *
+ * The prefix still spells out the full CLI reply command with the explicit chat
+ * target rather than relying on the bare `parall messages send` the system
+ * prompt teaches. That is deliberate: effects are duck-typed by the host, so a
+ * parel deployment predating `invocationContext` silently drops it, and the
+ * opening turn would then have no PRLL_CHAT_ID to default to. The explicit
+ * target costs nothing and keeps the reply path independent of that skew.
  */
 export declare function buildForkScopePrefix(subject: string, threadRootId?: string): string;
 export {};

package/dist/fork.d.ts.map

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

package/dist/fork.js

@@ -314,13 +314,17 @@ export async function handleChildSpawnFailed(ctx, event) {
  * this line keeps the child from "finishing" main's visible work).
  *
  * Replies are CLI-only on EVERY fork turn (the platform reply contract —
- * nothing auto-delivers, parel-reply-contract-alignment.md). The opening
- * turn additionally has no envelope (it starts from the spawn input), so it
- * gets no per-turn invocation context either — the prefix therefore spells
- * out the full CLI reply command with the explicit chat target; follow-ups
- * arrive as deliverTo envelopes whose invocation context presets
- * PRLL_CHAT_ID, so the system prompt's bare `parall messages send` teaching
- * covers them.
+ * nothing auto-delivers, parel-reply-contract-alignment.md). The opening turn
+ * has no envelope of its own (it starts from the spawn input), so its per-turn
+ * context rides the effect's `invocationContext` instead; follow-ups arrive as
+ * deliverTo envelopes carrying theirs the usual way.
+ *
+ * The prefix still spells out the full CLI reply command with the explicit chat
+ * target rather than relying on the bare `parall messages send` the system
+ * prompt teaches. That is deliberate: effects are duck-typed by the host, so a
+ * parel deployment predating `invocationContext` silently drops it, and the
+ * opening turn would then have no PRLL_CHAT_ID to default to. The explicit
+ * target costs nothing and keeps the reply path independent of that skew.
  */
 export function buildForkScopePrefix(subject, threadRootId) {
     // Quoted-heredoc input form (mirrors agent-core's send hint): plain

package/dist/inbound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../src/inbound.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACf,MAAM,mBAAmB,CAAC;AA0H3B,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAWrF;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CAE5B;AAoDD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EACtB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CAE5B;AAsCD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAElF;AAkoBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAE7B"}
+{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../src/inbound.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACf,MAAM,mBAAmB,CAAC;AAsI3B,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAWrF;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CAE5B;AAoDD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EACtB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CAE5B;AAsCD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAElF;AAyoBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAE7B"}

package/dist/inbound.js

@@ -473,26 +473,34 @@ async function effectsForDispatch(data, ctx) {
                 ]);
                 if (results.includes('stale'))
                     await invalidateChildSession(ctx, decision.childRef);
+                // Same stamp — and same never-stamp-a-stale-ase_ rule — as the
+                // deliverTo branch above. Now that the opening turn carries context,
+                // its CLI reply links to the child session directly instead of
+                // resolving through dispatch provenance alone.
+                else
+                    invocationContext.PRLL_SESSION_ID = childAse;
             }
             await recordSpawn(ctx, subject, decision.childRef, { dispatchId, sourceId });
             await receivedSettled;
-            // Known gap: SpawnChildSessionEffect (plugin-sdk 0.12) carries no
-            // invocation context, so the fork's OPENING turn runs without the
-            // capability env (lark-cli workspace ops would need a follow-up turn)
-            // AND without PRLL_SESSION_ID (its reply links via dispatch provenance
-            // instead) — deliverTo follow-ups inherit the full context, including
-            // the session stamp. Channel replies are unaffected: channel_message
-            // dispatches always ride main. Fix belongs parel-side (context on
-            // spawnChildSession) — tracked as a parel ask.
-            return [
-                {
-                    type: 'spawnChildSession',
-                    childRef: decision.childRef,
-                    input: buildForkScopePrefix(chatId, threadRootId) + framedText,
-                    subject,
-                },
-                ...timerEffects,
-            ];
+            // The opening turn gets the SAME per-turn context as any deliverTo
+            // envelope (parel `spawnChildSession.invocationContext`): PRLL_CHAT_ID,
+            // the dispatch-source pair and the session stamp reach the sandbox, and
+            // the capability env (lark-cli) is live from turn one. It used to be the
+            // single turn of a child's life that ran blind — it starts from the spawn
+            // input, not an envelope, and the effect had nowhere to carry context.
+            //
+            // A parel deployment that predates the field ignores it (effects are
+            // duck-typed, not schema-validated), which is why buildForkScopePrefix
+            // still spells out the explicit chat target: the reply path must not
+            // depend on the host having shipped this yet.
+            const spawn = {
+                type: 'spawnChildSession',
+                childRef: decision.childRef,
+                input: buildForkScopePrefix(chatId, threadRootId) + framedText,
+                subject,
+                invocationContext,
+            };
+            return [spawn, ...timerEffects];
         }
         // fall through: black-holed spawn rides main below.
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/parel-channel",
-  "version": "1.52.1",
+  "version": "1.52.2",
   "description": "Parall channel plugin for the parel runtime — lets a parel agent treat Parall as a managed_ws channel (receive dispatches, reply via the Parall API)",
   "license": "MIT",
   "repository": {

package/src/fork.ts

@@ -426,13 +426,17 @@ export async function handleChildSpawnFailed(
  * this line keeps the child from "finishing" main's visible work).
  *
  * Replies are CLI-only on EVERY fork turn (the platform reply contract —
- * nothing auto-delivers, parel-reply-contract-alignment.md). The opening
- * turn additionally has no envelope (it starts from the spawn input), so it
- * gets no per-turn invocation context either — the prefix therefore spells
- * out the full CLI reply command with the explicit chat target; follow-ups
- * arrive as deliverTo envelopes whose invocation context presets
- * PRLL_CHAT_ID, so the system prompt's bare `parall messages send` teaching
- * covers them.
+ * nothing auto-delivers, parel-reply-contract-alignment.md). The opening turn
+ * has no envelope of its own (it starts from the spawn input), so its per-turn
+ * context rides the effect's `invocationContext` instead; follow-ups arrive as
+ * deliverTo envelopes carrying theirs the usual way.
+ *
+ * The prefix still spells out the full CLI reply command with the explicit chat
+ * target rather than relying on the bare `parall messages send` the system
+ * prompt teaches. That is deliberate: effects are duck-typed by the host, so a
+ * parel deployment predating `invocationContext` silently drops it, and the
+ * opening turn would then have no PRLL_CHAT_ID to default to. The explicit
+ * target costs nothing and keeps the reply path independent of that skew.
  */
 export function buildForkScopePrefix(subject: string, threadRootId?: string): string {
   // Quoted-heredoc input form (mirrors agent-core's send hint): plain

package/src/inbound.ts

@@ -97,6 +97,18 @@ import { isTypedEventType, planTypedDispatch } from './typed-dispatch.js';
  * pending rather than being acked-and-dropped.
  */
 
+/**
+ * The spawn effect plus parel's `invocationContext`, which carries per-turn
+ * context into the child's opening turn. The field is native in
+ * `@parel/plugin-sdk` 0.14.0, but this package still resolves `^0.12.0` and a
+ * 0.x caret never crosses minors — so the alias stays until that dependency is
+ * bumped, then it can go. Effects are duck-typed by the host, so an older parel
+ * deployment ignores the field rather than rejecting the spawn.
+ */
+type SpawnChildEffect = Extract<ConnectorEffect, { type: 'spawnChildSession' }> & {
+  invocationContext?: Record<string, unknown>;
+};
+
 interface DispatchData {
   id?: unknown;
   event_type?: unknown;
@@ -614,26 +626,33 @@ async function effectsForDispatch(
           }),
         ]);
         if (results.includes('stale')) await invalidateChildSession(ctx, decision.childRef);
+        // Same stamp — and same never-stamp-a-stale-ase_ rule — as the
+        // deliverTo branch above. Now that the opening turn carries context,
+        // its CLI reply links to the child session directly instead of
+        // resolving through dispatch provenance alone.
+        else invocationContext.PRLL_SESSION_ID = childAse;
       }
       await recordSpawn(ctx, subject, decision.childRef, { dispatchId, sourceId });
       await receivedSettled;
-      // Known gap: SpawnChildSessionEffect (plugin-sdk 0.12) carries no
-      // invocation context, so the fork's OPENING turn runs without the
-      // capability env (lark-cli workspace ops would need a follow-up turn)
-      // AND without PRLL_SESSION_ID (its reply links via dispatch provenance
-      // instead) — deliverTo follow-ups inherit the full context, including
-      // the session stamp. Channel replies are unaffected: channel_message
-      // dispatches always ride main. Fix belongs parel-side (context on
-      // spawnChildSession) — tracked as a parel ask.
-      return [
-        {
-          type: 'spawnChildSession',
-          childRef: decision.childRef,
-          input: buildForkScopePrefix(chatId, threadRootId) + framedText,
-          subject,
-        },
-        ...timerEffects,
-      ];
+      // The opening turn gets the SAME per-turn context as any deliverTo
+      // envelope (parel `spawnChildSession.invocationContext`): PRLL_CHAT_ID,
+      // the dispatch-source pair and the session stamp reach the sandbox, and
+      // the capability env (lark-cli) is live from turn one. It used to be the
+      // single turn of a child's life that ran blind — it starts from the spawn
+      // input, not an envelope, and the effect had nowhere to carry context.
+      //
+      // A parel deployment that predates the field ignores it (effects are
+      // duck-typed, not schema-validated), which is why buildForkScopePrefix
+      // still spells out the explicit chat target: the reply path must not
+      // depend on the host having shipped this yet.
+      const spawn: SpawnChildEffect = {
+        type: 'spawnChildSession',
+        childRef: decision.childRef,
+        input: buildForkScopePrefix(chatId, threadRootId) + framedText,
+        subject,
+        invocationContext,
+      };
+      return [spawn, ...timerEffects];
     }
     // fall through: black-holed spawn rides main below.
   }