@shumkov/orchestra 0.4.0 → 0.4.2

package/lib/process/cli-process.js

@@ -1470,6 +1470,11 @@ class CliProcess extends Process {
         files: args.files,
         messageId: args.message_id,         // 0.13: edit_message target bubble
         sourceMsgId,                        // reaction/quote target (A2)
+        // Quote participant rides the SAME ledger entry as sourceMsgId, so the quote's
+        // author can never disagree with its target. Present only when there's a resolved
+        // quote target; null otherwise so the dispatcher omits the quote (never a
+        // half-built quote — WhatsApp needs both fields).
+        participantJid: sourceMsgId != null ? (sourceEntry?.participantJid ?? null) : null,
         sessionCwd: this.sessionCwd,        // P0 #2: dispatcher uses this to allowlist file roots
         maxOutboundFileBytes: this.maxOutboundFileBytes, // backend/chat-derived upload cap
       });
@@ -1678,11 +1683,15 @@ class CliProcess extends Process {
 
   // ─── 0.13 D2: InputLedger ──────────────────────────────────────────
 
-  _ledgerAdd(turnId, { source, msgId = null } = {}) {
+  _ledgerAdd(turnId, { source, msgId = null, participantJid = null } = {}) {
     this.inputLedger.set(turnId, {
       turnId,
       source,
       msgId: msgId != null ? String(msgId) : null,
+      // The source message's author JID, carried so a reply can quote it (WhatsApp
+      // threading needs both the stanza id AND the participant). Null for backends /
+      // callers that don't supply one — the quote is then simply omitted downstream.
+      participantJid: participantJid != null ? String(participantJid) : null,
       chatId: this.chatId,
       writtenAt: Date.now(),
       state: 'written',
@@ -2546,7 +2555,11 @@ class CliProcess extends Process {
       // 0.13 D2: ledger the primary + keep the exact envelope for the delivery
       // watchdog's idempotent re-write (the pending owns it — no text in the
       // ledger, events stay content-free per L13).
-      this._ledgerAdd(turnId, { source: 'primary', msgId: opts.context?.sourceMsgId });
+      this._ledgerAdd(turnId, {
+        source: 'primary',
+        msgId: opts.context?.sourceMsgId,
+        participantJid: opts.context?.participantJid,
+      });
 
       // Review F#18: bridge-disconnect TOCTOU. The bridgeReady check at
       // top of send() can race the bridge socket close. If the bridge

package/lib/process/factory.js

@@ -105,6 +105,15 @@ function _maybeWarnR12Migration({ rawPm, canonical, chatId, threadId, chatCfg, t
  * @param {string} [opts.channelsClaudeBin] — absolute path to pinned claude binary;
  *   required when ANY chat routes to 'cli'. (Name kept for back-compat with
  *   existing wiring; can be renamed to `claudeBin` in a future refactor.)
+ * @param {string|Function} [opts.displayHint] — surface-rendering hint prepended to
+ *   the CliProcess system prompt. Accepts EITHER a static string (applied to every
+ *   session) OR a resolver `(chatId, threadId, config) => string` invoked once per
+ *   spawn, just before the CliProcess is constructed. The resolver receives the
+ *   spawning chat/topic and the factory's config so the consumer can implement its
+ *   own per-chat/topic precedence (e.g. a per-chat rich-text toggle) without the
+ *   engine knowing anything about the consumer's config shape. The resolved string
+ *   is what reaches CliProcess. Only the 'cli' backend uses this; the 'sdk' backend
+ *   gets its per-chat hint via spawnFn instead.
  * @returns {Function} processFactory(sessionKey, ctx) → Process
  */
 function createProcessFactory({
@@ -153,13 +162,20 @@ function createProcessFactory({
           `falling back to SdkProcess. Pass these to createProcessFactory.`,
         );
       } else {
+        // displayHint may be a static string (same hint for every session) or a
+        // resolver called per spawn with the current chat/topic and config, so the
+        // consumer can vary the hint per chat (e.g. a per-chat rich-text toggle).
+        // The string form is passed through unchanged.
+        const resolvedDisplayHint = typeof displayHint === 'function'
+          ? displayHint(chatId, threadId, config)
+          : displayHint;
         return new CliProcess({
           sessionKey, chatId, threadId, label,
           tmuxRunner,
           botName,
           claudeBin: channelsClaudeBin,
           toolDispatcher,
-          displayHint,
+          displayHint: resolvedDisplayHint,
           maxOutboundFileBytes,
           sessionPrefix, bridgeServerName, appDataDir, attachmentBase, productName, surfaceName,
           logger,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shumkov/orchestra",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Drive interactive Claude Code CLI sessions: spawn, inject messages via the MCP channels bridge, observe turns, recover. The transport-agnostic session engine extracted from polygram, shared by polygram (Telegram) and water (WhatsApp).",
   "type": "commonjs",
   "main": "index.js",