@parall/parel-channel 1.55.3 → 1.55.5

package/dist/channel-prompt.d.ts

@@ -38,6 +38,11 @@ export interface ChatPromptArgs {
     chatName?: string;
     /** Sender user id (usr_); display-name enrichment is a follow-up. */
     senderId?: string;
+    /**
+     * The inbound message id (msg_); anchors the forwarded-message hint's
+     * explicit --from so coalesced turns don't lean on the single trigger id.
+     */
+    messageId?: string;
     threadRootId?: string;
     /** The inbound message text (raw, un-framed); may be empty (attachment-only). */
     text: string;

package/dist/channel-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-prompt.d.ts","sourceRoot":"","sources":["../src/channel-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AASH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACjC,8FAA8F;IAC9F,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAmBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAW5D;AAED,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAkBlE"}
+{"version":3,"file":"channel-prompt.d.ts","sourceRoot":"","sources":["../src/channel-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AA+BH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACjC,8FAA8F;IAC9F,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAmBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAoB5D;AAED,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAkBlE"}

package/dist/channel-prompt.js

@@ -32,6 +32,24 @@ function sanitizeMeta(value) {
         .replace(/[[\]|]/g, ' ')
         .trim();
 }
+const MESSAGE_REF_URI = 'prll:\\/\\/msg_[A-Za-z0-9_-]+(?:\\/content\\?v=[1-9][0-9]{0,8}#t=[0-9]+-[0-9]+)?';
+const MESSAGE_RANGE_REF_URI = 'prll:\\/\\/cht_[A-Za-z0-9_-]+#range=msg_[A-Za-z0-9_-]+,msg_[A-Za-z0-9_-]+';
+const REF_URI = `(?:${MESSAGE_REF_URI}|${MESSAGE_RANGE_REF_URI})`;
+// Mirrors the web forward-card rule (ts/app/src/lib/messageRefParagraph.ts):
+// human clients render a paragraph made only of message refs as forward
+// cards, whether each ref is a bare URI, a markdown link wrapping one
+// ([ctx](prll://…), label may be empty), or an autolink (<prll://…>).
+// Shared vectors pin all three readers:
+// ts/protocol-vectors/forwarded-message-bodies.json.
+const REF_TOKEN = `(?:${REF_URI}|\\[(?:[^\\[\\]]|\\[[^\\[\\]]*\\])*\\]\\(${REF_URI}\\)|<${REF_URI}>)`;
+const FORWARDED_REF_LINE = new RegExp(`^${REF_TOKEN}(?:\\s+${REF_TOKEN})*$`);
+function isForwardedMessageBody(body) {
+    const lines = body
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    return lines.length > 0 && lines.every((line) => FORWARDED_REF_LINE.test(line));
+}
 /**
  * One reference line per attachment, byte-identical to agent-core's
  * event-format rendering: the agent learns the attachment EXISTS and pulls
@@ -65,6 +83,13 @@ export function buildChatPrompt(args) {
         lines.push(`[Thread: ${sanitizeMeta(args.threadRootId)}]`);
     if (args.noReply)
         lines.push(`[Hint: no_reply]`);
+    if (isForwardedMessageBody(args.text)) {
+        // Embed the concrete --from anchor: parel snapshots one invocation
+        // context per coalesced turn, so each event's hint must carry its own
+        // forwarding grant instead of leaning on the single trigger id.
+        const from = args.messageId ? ` --from ${sanitizeMeta(`prll://${args.messageId}`)}` : '';
+        lines.push(`[Hint: forwarded_message — run parall refs resolve --full${from} with the prll:// references below; that message carries the cross-chat forwarding access for these refs.]`);
+    }
     lines.push(...attachmentLines(args.attachments));
     lines.push('', args.text);
     return lines.join('\n');

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;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"}
+{"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;AA0oBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAE7B"}

package/dist/inbound.js

@@ -263,6 +263,7 @@ async function effectsForDispatch(data, ctx) {
         chatId,
         chatName,
         senderId,
+        messageId: sourceId,
         threadRootId,
         text,
         attachments,

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

@@ -1 +1 @@
-{"version":3,"file":"typed-dispatch.d.ts","sourceRoot":"","sources":["../src/typed-dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,kIAQpB,CAAC;AAEX,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChD,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,GAC3B,cAAc;AAChB,2CAA2C;GACzC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE;AACtB;oEACoE;GAClE;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC;AAiB3B;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAmC9B"}
+{"version":3,"file":"typed-dispatch.d.ts","sourceRoot":"","sources":["../src/typed-dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,kIAQpB,CAAC;AAEX,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChD,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,GAC3B,cAAc;AAChB,2CAA2C;GACzC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE;AACtB;oEACoE;GAClE;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC;AA0B3B;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAmC9B"}

package/dist/typed-dispatch.js

@@ -25,6 +25,12 @@ function sanitizeMeta(value) {
         .replace(/[[\]|]/g, ' ')
         .trim();
 }
+function formatApprovalDecisionReason(status, reason) {
+    const normalized = reason?.trim();
+    if (status !== 'rejected' || !normalized)
+        return '';
+    return `Reason (JSON): ${JSON.stringify(normalized)}`;
+}
 /**
  * Build the plan for one typed dispatch. Throws on transient failures
  * (including unexpected handler errors — a poisoned row surfaces as catch-up
@@ -344,6 +350,9 @@ async function planApprovalDecided(ctx, approvalId, chatId, actor) {
         lines.push(`[Chat: prll://${resolvedChat}]`);
     lines.push(`[Decided by: ${sanitizeMeta(actor ?? approval.decided_by ?? 'system')}]`);
     lines.push('', `${statusLabel}: ${approval.title ?? ''}${execInfo}`);
+    const reasonLine = formatApprovalDecisionReason(approval.status, approval.decision_reason);
+    if (reasonLine)
+        lines.push(reasonLine);
     return {
         outcome: 'emit',
         // The decision belongs to the chat conversation it happened in — group

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/parel-channel",
-  "version": "1.55.3",
+  "version": "1.55.5",
   "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/channel-prompt.ts

@@ -34,6 +34,28 @@ function sanitizeMeta(value: string): string {
     .trim();
 }
 
+const MESSAGE_REF_URI =
+  'prll:\\/\\/msg_[A-Za-z0-9_-]+(?:\\/content\\?v=[1-9][0-9]{0,8}#t=[0-9]+-[0-9]+)?';
+const MESSAGE_RANGE_REF_URI =
+  'prll:\\/\\/cht_[A-Za-z0-9_-]+#range=msg_[A-Za-z0-9_-]+,msg_[A-Za-z0-9_-]+';
+const REF_URI = `(?:${MESSAGE_REF_URI}|${MESSAGE_RANGE_REF_URI})`;
+// Mirrors the web forward-card rule (ts/app/src/lib/messageRefParagraph.ts):
+// human clients render a paragraph made only of message refs as forward
+// cards, whether each ref is a bare URI, a markdown link wrapping one
+// ([ctx](prll://…), label may be empty), or an autolink (<prll://…>).
+// Shared vectors pin all three readers:
+// ts/protocol-vectors/forwarded-message-bodies.json.
+const REF_TOKEN = `(?:${REF_URI}|\\[(?:[^\\[\\]]|\\[[^\\[\\]]*\\])*\\]\\(${REF_URI}\\)|<${REF_URI}>)`;
+const FORWARDED_REF_LINE = new RegExp(`^${REF_TOKEN}(?:\\s+${REF_TOKEN})*$`);
+
+function isForwardedMessageBody(body: string): boolean {
+  const lines = body
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter(Boolean);
+  return lines.length > 0 && lines.every((line) => FORWARDED_REF_LINE.test(line));
+}
+
 export interface PromptAttachment {
   id: string;
   fileName: string;
@@ -47,6 +69,11 @@ export interface ChatPromptArgs {
   chatName?: string;
   /** Sender user id (usr_); display-name enrichment is a follow-up. */
   senderId?: string;
+  /**
+   * The inbound message id (msg_); anchors the forwarded-message hint's
+   * explicit --from so coalesced turns don't lean on the single trigger id.
+   */
+  messageId?: string;
   threadRootId?: string;
   /** The inbound message text (raw, un-framed); may be empty (attachment-only). */
   text: string;
@@ -87,6 +114,15 @@ export function buildChatPrompt(args: ChatPromptArgs): string {
   if (args.senderId) lines.push(`[From: ${sanitizeMeta(args.senderId)}]`);
   if (args.threadRootId) lines.push(`[Thread: ${sanitizeMeta(args.threadRootId)}]`);
   if (args.noReply) lines.push(`[Hint: no_reply]`);
+  if (isForwardedMessageBody(args.text)) {
+    // Embed the concrete --from anchor: parel snapshots one invocation
+    // context per coalesced turn, so each event's hint must carry its own
+    // forwarding grant instead of leaning on the single trigger id.
+    const from = args.messageId ? ` --from ${sanitizeMeta(`prll://${args.messageId}`)}` : '';
+    lines.push(
+      `[Hint: forwarded_message — run parall refs resolve --full${from} with the prll:// references below; that message carries the cross-chat forwarding access for these refs.]`,
+    );
+  }
   lines.push(...attachmentLines(args.attachments));
   lines.push('', args.text);
   return lines.join('\n');

package/src/inbound.ts

@@ -414,6 +414,7 @@ async function effectsForDispatch(
     chatId,
     chatName,
     senderId,
+    messageId: sourceId,
     threadRootId,
     text,
     attachments,

package/src/typed-dispatch.ts

@@ -106,6 +106,15 @@ function sanitizeMeta(value: string): string {
     .trim();
 }
 
+function formatApprovalDecisionReason(
+  status: string | undefined,
+  reason: string | null | undefined,
+): string {
+  const normalized = reason?.trim();
+  if (status !== 'rejected' || !normalized) return '';
+  return `Reason (JSON): ${JSON.stringify(normalized)}`;
+}
+
 /**
  * Build the plan for one typed dispatch. Throws on transient failures
  * (including unexpected handler errors — a poisoned row surfaces as catch-up
@@ -501,6 +510,7 @@ interface ApprovalRow {
   execution_status?: string;
   chat_id?: string;
   decided_by?: string;
+  decision_reason?: string | null;
 }
 
 async function planApprovalDecided(
@@ -530,6 +540,8 @@ async function planApprovalDecided(
   if (resolvedChat) lines.push(`[Chat: prll://${resolvedChat}]`);
   lines.push(`[Decided by: ${sanitizeMeta(actor ?? approval.decided_by ?? 'system')}]`);
   lines.push('', `${statusLabel}: ${approval.title ?? ''}${execInfo}`);
+  const reasonLine = formatApprovalDecisionReason(approval.status, approval.decision_reason);
+  if (reasonLine) lines.push(reasonLine);
 
   return {
     outcome: 'emit',