@parall/parel-channel 1.56.2 → 1.57.2

package/dist/channel-prompt.d.ts

@@ -36,8 +36,12 @@ export interface ChatPromptArgs {
     chatId: string;
     /** Display name of the chat; undefined when unresolved (best-effort). */
     chatName?: string;
-    /** Sender user id (usr_); display-name enrichment is a follow-up. */
+    /** Sender user id (usr_). */
     senderId?: string;
+    /** Sender display name; rendered before the id when resolved (best-effort). */
+    senderName?: string;
+    /** Chat shape (direct/group); the type segment is omitted when unresolved. */
+    chatType?: 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.
@@ -70,6 +74,7 @@ export interface ChannelPromptArgs {
     /** Conversation shape as recorded on the ChannelConversation (dm/group). */
     conversationType?: string;
     externalConversationId?: string;
+    externalConversationName?: string;
     externalMessageId?: string;
     senderName: string;
     /** The inbound message text (raw, un-framed). */

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;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;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,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,CAqB5D;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,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,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,CAwC5D;AAgBD,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,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,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,CA2BlE"}

package/dist/channel-prompt.js

@@ -73,16 +73,31 @@ function attachmentLines(attachments) {
  * not re-created here.
  */
 export function buildChatPrompt(args) {
-    const chatLabel = args.chatName
-        ? `${sanitizeMeta(args.chatId)} — ${sanitizeMeta(args.chatName)}`
-        : sanitizeMeta(args.chatId);
-    const lines = [`[Chat: ${chatLabel}]`];
-    if (args.senderId)
-        lines.push(`[From: ${sanitizeMeta(args.senderId)}]`);
+    // agent-core's event-format.ts message branch is the SSOT for this frame:
+    // same lines, same order, same send-hint. The only sanctioned deltas are
+    // absent-field fallbacks (no chat name → bare URI, no sender name → bare
+    // id, no chat type → segment omitted) — agent-core's host always has them.
+    const lines = [`[Event: message.new]`];
+    const chatUri = `prll://${args.chatId}`;
+    const chatLabel = args.chatName ? `"${sanitizeMeta(args.chatName)}" (${chatUri})` : chatUri;
+    const typeSeg = args.chatType ? ` | type: ${sanitizeMeta(args.chatType)}` : '';
+    lines.push(`[Chat: ${chatLabel}${typeSeg}]`);
+    if (args.senderId) {
+        lines.push(args.senderName
+            ? `[From: ${sanitizeMeta(args.senderName)} (prll://${args.senderId})]`
+            : `[From: prll://${args.senderId}]`);
+    }
+    if (args.messageId)
+        lines.push(`[Message ID: prll://${args.messageId}]`);
     if (args.threadRootId)
-        lines.push(`[Thread: ${sanitizeMeta(args.threadRootId)}]`);
+        lines.push(`[Thread: prll://${sanitizeMeta(args.threadRootId)}]`);
     if (args.deliveryReason)
         lines.push(`[Delivery: ${sanitizeMeta(args.deliveryReason)}]`);
+    if (args.deliveryReason === 'watcher' && args.threadRootId) {
+        // agent-core's threadWatcherHint, verbatim — the cooperative nudge under
+        // the server's agent-loop ceiling (agent-dm-loop-prevention.md Layer 4).
+        lines.push(`[Hint: watcher — you were not addressed in this reply. Reply only if you add something new; otherwise run \`parall no-reply\`. If this thread is not relevant to you, or you have nothing more to contribute, run \`parall messages unwatch prll://${sanitizeMeta(args.threadRootId)}\` so later replies stop waking you.]`);
+    }
     if (args.noReply)
         lines.push(`[Hint: no_reply]`);
     if (isForwardedMessageBody(args.text)) {
@@ -94,13 +109,36 @@ export function buildChatPrompt(args) {
     }
     lines.push(...attachmentLines(args.attachments));
     lines.push('', args.text);
-    return lines.join('\n');
+    return lines.join('\n') + chatSendHint(args);
+}
+/**
+ * agent-core's buildSendMessageHint chat branch, verbatim: every chat event
+ * ends with the concrete send command. The standing system prompt teaches the
+ * CLI-only reply contract too, but a per-event reminder is what the standard
+ * runtimes ship — and weak models demonstrably drop the send step without it.
+ */
+function chatSendHint(args) {
+    if (args.noReply)
+        return '';
+    if (args.threadRootId) {
+        return `\n<system-reminder>To reply in this thread, run \`parall messages send prll://${args.chatId} --thread-root-id ${sanitizeMeta(args.threadRootId)} --text-file - <<'EOF'\` … \`EOF\` — the quoted heredoc keeps \`$\`, backticks and apostrophes literal (plain \`--text "$1,000"\` sends \`,000\`). Your plain text output is not delivered to the chat.</system-reminder>`;
+    }
+    return `\n<system-reminder>To reply, run \`parall messages send prll://${args.chatId} --text-file - <<'EOF'\` … \`EOF\` — the quoted heredoc keeps \`$\`, backticks and apostrophes literal (plain \`--text "$1,000"\` sends \`,000\`). Your plain text output is not delivered to the chat.</system-reminder>`;
 }
 export function buildChannelPrompt(args) {
     const providerLabel = sanitizeMeta(args.provider ?? 'external IM');
-    const convLabel = args.externalConversationId
-        ? `${sanitizeMeta(args.externalConversationId)} (${sanitizeMeta(args.conversationType ?? 'conversation')})`
-        : sanitizeMeta(args.conversationType ?? 'conversation');
+    const convType = sanitizeMeta(args.conversationType ?? 'conversation');
+    const convId = args.externalConversationId
+        ? sanitizeMeta(args.externalConversationId)
+        : undefined;
+    const convName = args.externalConversationName
+        ? sanitizeMeta(args.externalConversationName)
+        : undefined;
+    const convLabel = convName
+        ? `${convName} (${convId ? `${convId}, ` : ''}${convType})`
+        : convId
+            ? `${convId} (${convType})`
+            : convType;
     const lines = [
         '[Event: channel.message]',
         `[Channel: ${providerLabel} | conversation: ${convLabel}]`,
@@ -114,14 +152,23 @@ export function buildChannelPrompt(args) {
     return lines.join('\n') + buildChannelReplyHint(args);
 }
 function buildChannelReplyHint(args) {
-    // Single-path routing (multi-channel-architecture-design §6/§8.3): with
-    // the feishu-cli grant, the minted LARKSUITE_CLI_* env rides this turn's
-    // invocation context, so the official lark-cli works ambiently in the
-    // sandbox and is THE reply path. Without the grant there is no outbound
-    // path — say so instead of pointing at the retired provider clip.
-    // cliCapable alone decides: the mint is feishu-specific, so a successful
-    // grant implies Feishu even when the cosmetic provider-label lookup failed.
-    if (args.cliCapable) {
+    // The outbound path is a property of the PROVIDER, not of the agent's
+    // grants. Feishu replies go through the vendor CLI with a platform-brokered
+    // credential; Slack and WeChat replies are platform verbs the `parall` CLI
+    // already carries under the agent's own identity — nothing to mint.
+    //
+    // Deciding on the Feishu grant alone told a Slack or WeChat inbound that
+    // outbound was disabled while its own system prompt declared the matching
+    // `parall <provider> send` verb, and could hand a dual-bound agent a
+    // `lark-cli` instruction addressed to a Slack conversation.
+    //
+    // Whether the command is ALLOWED stays a runtime question: every verb and
+    // the Feishu broker re-check the grant at call time. This only names the
+    // right door.
+    // Both halves are required: the mint is Feishu-only and says nothing about
+    // where the message arrived, so a dual-bound agent's Slack inbound must not
+    // fall into this branch just because its Feishu grant is live.
+    if (args.cliCapable && args.provider === 'feishu') {
         const convRef = args.externalConversationId
             ? `chat_id "${args.externalConversationId}"`
             : 'the conversation id named in this event';
@@ -130,6 +177,24 @@ function buildChannelReplyHint(args) {
             : '';
         return `\n<system-reminder>To reply, use the official Feishu CLI in your sandbox: send a message to ${convRef} with \`lark-cli im\` (see \`lark-cli im --help\` for send syntax; auth is provisioned in your environment — if lark-cli is missing, install it once with \`npm i -g @larksuite/cli\`).${threadAlt} lark-cli is the ONLY outbound path — your plain text output is NOT delivered to the external conversation.</system-reminder>`;
     }
+    if (args.provider === 'slack') {
+        // The flag and its value together, as agent-core renders it: writing the
+        // option separately from a labelled reference produced
+        // `--channel channel "C123"`.
+        const channelArg = args.externalConversationId
+            ? ` --channel "${args.externalConversationId}"`
+            : ' --channel <conversation id from this event>';
+        // Channel sends REQUIRE a reply anchor; DMs take one too so a question
+        // asked in a thread is answered in that thread.
+        const replyTo = args.externalMessageId ? ` --reply-to "${args.externalMessageId}"` : '';
+        return `\n<system-reminder>To reply, use \`parall slack send${channelArg}${replyTo} --text <text>\` from your sandbox (use \`--text-file -\` with a quoted heredoc for anything containing \`$\`, backticks or quotes). That verb is the ONLY outbound path — your plain text output is NOT delivered to the external conversation.</system-reminder>`;
+    }
+    if (args.provider === 'wechat') {
+        const toArg = args.externalConversationId
+            ? `"${args.externalConversationId}"`
+            : '<wxid from this event>';
+        return `\n<system-reminder>To reply, use \`parall wechat send --to ${toArg} --text <text>\` from your sandbox (use \`--text-file -\` with a quoted heredoc for anything containing \`$\`, backticks or quotes). WeChat has no threads: a group reply lands in the whole room. That verb is the ONLY outbound path — your plain text output is NOT delivered to the external conversation.</system-reminder>`;
+    }
     const platform = args.provider ?? 'the external platform';
     return `\n<system-reminder>This message arrived from ${platform}, but outbound replies are currently disabled for this org (no channel capability granted). Do NOT attempt to reply on the external platform. If action is needed, surface it inside Parall (\`parall messages send\` / \`parall dm\`). Your plain text output is not delivered anywhere.</system-reminder>`;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"inbound-channel.d.ts","sourceRoot":"","sources":["../src/inbound-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAkB3E;;;;GAIG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CAwL5B"}
+{"version":3,"file":"inbound-channel.d.ts","sourceRoot":"","sources":["../src/inbound-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAkB3E;;;;GAIG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CAmM5B"}

package/dist/inbound-channel.js

@@ -1,7 +1,7 @@
 import { channelCapabilityEnv } from './channel-capability.js';
 import { buildChannelPrompt } from './channel-prompt.js';
 import { parallApiUrl, parallOrgId, requireAgk } from './connect.js';
-import { claimDispatchSource, completeSourceEffect, createChannelInputStep, ensureSession, invalidateSession, nextEnvelopeId, patchSession, readActiveEmit, REQUEST_TIMEOUT_MS, TURN_ENVELOPE_KEY, writeActiveEmit, } from './session.js';
+import { claimDispatchSource, completeSourceEffect, createChannelInputStep, ensureSession, invalidateSession, nextEnvelopeId, patchSession, REQUEST_TIMEOUT_MS, readActiveEmit, TURN_ENVELOPE_KEY, writeActiveEmit, } from './session.js';
 /**
  * External IM inbound (channel_message dispatches — Feishu/Slack via the
  * platform-mediated channel, external-im-channel-design.md). Split from
@@ -70,13 +70,18 @@ export async function effectsForChannelDispatch(sourceId, ctx) {
     }
     const conv = (await c.json().catch(() => null));
     // Provider (= clip alias) for prompt labeling + the reply hint.
-    // Best-effort: an unresolved provider degrades the wording, never blocks.
+    // A gone connection degrades the wording; an unreachable platform throws,
+    // because the provider now decides the turn's outbound path (see the
+    // resolver).
     const connectionId = conv?.connection_id ? String(conv.connection_id) : undefined;
     const provider = connectionId ? await resolveChannelProvider(ctx, connectionId, get) : undefined;
     const senderName = msg?.external_user_name || msg?.external_user_id || 'external user';
     const externalConversationId = conv?.external_conversation_id
         ? String(conv.external_conversation_id)
         : undefined;
+    const externalConversationName = conv?.external_conversation_name
+        ? String(conv.external_conversation_name)
+        : undefined;
     const externalMessageId = msg?.external_message_id ? String(msg.external_message_id) : undefined;
     // Progress reporting — identical ordering contract to the message path
     // (see the comments there): received settles before this function returns;
@@ -141,7 +146,10 @@ export async function effectsForChannelDispatch(sourceId, ctx) {
     await writeActiveEmit(ctx, 'channel_message', sourceId, envelopeId, sessionId ?? undefined);
     // Live capability grant → this turn's lark-cli auth env (mint gate = the
     // no-drift revocation point) + the hint teaching the single reply path.
-    const capabilityEnv = await channelCapabilityEnv(ctx);
+    // The mint is Feishu-only. Asking for it on a Slack or WeChat inbound buys
+    // nothing (those replies are platform verbs under the agent's own identity)
+    // and would put a Feishu credential in a turn that has no use for one.
+    const capabilityEnv = provider === 'feishu' ? await channelCapabilityEnv(ctx) : null;
     return [
         {
             type: 'emitEvent',
@@ -163,6 +171,7 @@ export async function effectsForChannelDispatch(sourceId, ctx) {
                         provider,
                         conversationType: conv?.conversation_type ? String(conv.conversation_type) : undefined,
                         externalConversationId,
+                        externalConversationName,
                         externalMessageId,
                         senderName,
                         text,
@@ -172,6 +181,7 @@ export async function effectsForChannelDispatch(sourceId, ctx) {
                     channelMessageId: sourceId,
                     provider,
                     externalConversationId,
+                    externalConversationName,
                     externalMessageId,
                 },
                 // No chatId on purpose: the reply is the agent's own lark-cli send,
@@ -225,17 +235,20 @@ async function resolveChannelProvider(ctx, connectionId, get) {
     const cached = await ctx.store?.get(cacheKey).catch(() => null);
     if (typeof cached === 'string' && cached)
         return cached;
-    try {
-        const res = await get(`/channel-connections/${connectionId}`, PROVIDER_LOOKUP_TIMEOUT_MS);
-        if (!res.ok)
-            return undefined;
-        const body = (await res.json().catch(() => null));
-        const provider = body?.provider ? String(body.provider) : undefined;
-        if (provider)
-            await ctx.store?.set(cacheKey, provider).catch(() => { });
-        return provider;
-    }
-    catch {
+    const res = await get(`/channel-connections/${connectionId}`, PROVIDER_LOOKUP_TIMEOUT_MS);
+    // A gone connection is an ANSWER (no provider); anything else is the
+    // platform failing to answer. That distinction used to be moot — the
+    // provider was prompt wording — but it now decides which outbound path the
+    // turn is taught, and a turn taught nothing still completes its source and
+    // is never revisited. Throwing leaves the dispatch for the catch-up pass.
+    if (res.status === 404 || res.status === 410)
         return undefined;
+    if (!res.ok) {
+        throw new Error(`channel connection lookup failed (${res.status})`);
     }
+    const body = (await res.json().catch(() => null));
+    const provider = body?.provider ? String(body.provider) : undefined;
+    if (provider)
+        await ctx.store?.set(cacheKey, provider).catch(() => { });
+    return provider;
 }

package/dist/inbound.js

@@ -1,10 +1,10 @@
+import { armCatchUpEffect, beginCatchUp, CATCHUP_TIMER_KEY, deferToCatchUp, runCatchUpRound, } from './catchup.js';
 import { channelCapabilityEnv } from './channel-capability.js';
 import { buildChatPrompt } from './channel-prompt.js';
-import { armCatchUpEffect, beginCatchUp, CATCHUP_TIMER_KEY, deferToCatchUp, runCatchUpRound, } from './catchup.js';
 import { parallApiUrl, parallOrgId, requireAgk, sandboxEnabled } from './connect.js';
-import { effectsForChannelDispatch, PROVIDER_LOOKUP_TIMEOUT_MS } from './inbound-channel.js';
 import { buildForkScopePrefix, bumpForkRetryAttempts, childConfirmed, childRefKnown, clearForkState, clearForkSubject, FORK_RETRY_DELAY_MS, FORK_RETRY_PREFIX, handleChildSpawnFailed, MAX_SPAWN_VERIFY_ATTEMPTS, noteMainTurnEvent, planForkDecision, recordSpawn, settleChildEvent, trackFollowUpAck, } from './fork.js';
-import { ackByIdEffect, claimDispatchSource, completeFencedEnvelopes, completeSourceEffect, conversationKey, createErrorStep, createInputStep, createTraceStep, createTypedInputStep, EMIT_TTL_MS, ensureChildSession, ensureSession, invalidateChildSession, invalidateSession, nextEnvelopeId, noteTurnEventsObserved, patchSession, readActiveEmit, reportingEnabled, REQUEST_TIMEOUT_MS, TURN_ENVELOPE_KEY, writeActiveEmit, } from './session.js';
+import { effectsForChannelDispatch, PROVIDER_LOOKUP_TIMEOUT_MS } from './inbound-channel.js';
+import { ackByIdEffect, claimDispatchSource, completeFencedEnvelopes, completeSourceEffect, conversationKey, createErrorStep, createInputStep, createTraceStep, createTypedInputStep, EMIT_TTL_MS, ensureChildSession, ensureSession, invalidateChildSession, invalidateSession, nextEnvelopeId, noteTurnEventsObserved, patchSession, REQUEST_TIMEOUT_MS, readActiveEmit, reportingEnabled, TURN_ENVELOPE_KEY, writeActiveEmit, } from './session.js';
 import { isTypedEventType, planTypedDispatch } from './typed-dispatch.js';
 /**
  * Connection-keyed hook serialization — a v1-host compatibility shim. The v1

package/package.json

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

@@ -67,8 +67,12 @@ export interface ChatPromptArgs {
   chatId: string;
   /** Display name of the chat; undefined when unresolved (best-effort). */
   chatName?: string;
-  /** Sender user id (usr_); display-name enrichment is a follow-up. */
+  /** Sender user id (usr_). */
   senderId?: string;
+  /** Sender display name; rendered before the id when resolved (best-effort). */
+  senderName?: string;
+  /** Chat shape (direct/group); the type segment is omitted when unresolved. */
+  chatType?: 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.
@@ -113,13 +117,32 @@ function attachmentLines(attachments: PromptAttachment[] | undefined): string[]
  * not re-created here.
  */
 export function buildChatPrompt(args: ChatPromptArgs): string {
-  const chatLabel = args.chatName
-    ? `${sanitizeMeta(args.chatId)} — ${sanitizeMeta(args.chatName)}`
-    : sanitizeMeta(args.chatId);
-  const lines = [`[Chat: ${chatLabel}]`];
-  if (args.senderId) lines.push(`[From: ${sanitizeMeta(args.senderId)}]`);
-  if (args.threadRootId) lines.push(`[Thread: ${sanitizeMeta(args.threadRootId)}]`);
+  // agent-core's event-format.ts message branch is the SSOT for this frame:
+  // same lines, same order, same send-hint. The only sanctioned deltas are
+  // absent-field fallbacks (no chat name → bare URI, no sender name → bare
+  // id, no chat type → segment omitted) — agent-core's host always has them.
+  const lines = [`[Event: message.new]`];
+  const chatUri = `prll://${args.chatId}`;
+  const chatLabel = args.chatName ? `"${sanitizeMeta(args.chatName)}" (${chatUri})` : chatUri;
+  const typeSeg = args.chatType ? ` | type: ${sanitizeMeta(args.chatType)}` : '';
+  lines.push(`[Chat: ${chatLabel}${typeSeg}]`);
+  if (args.senderId) {
+    lines.push(
+      args.senderName
+        ? `[From: ${sanitizeMeta(args.senderName)} (prll://${args.senderId})]`
+        : `[From: prll://${args.senderId}]`,
+    );
+  }
+  if (args.messageId) lines.push(`[Message ID: prll://${args.messageId}]`);
+  if (args.threadRootId) lines.push(`[Thread: prll://${sanitizeMeta(args.threadRootId)}]`);
   if (args.deliveryReason) lines.push(`[Delivery: ${sanitizeMeta(args.deliveryReason)}]`);
+  if (args.deliveryReason === 'watcher' && args.threadRootId) {
+    // agent-core's threadWatcherHint, verbatim — the cooperative nudge under
+    // the server's agent-loop ceiling (agent-dm-loop-prevention.md Layer 4).
+    lines.push(
+      `[Hint: watcher — you were not addressed in this reply. Reply only if you add something new; otherwise run \`parall no-reply\`. If this thread is not relevant to you, or you have nothing more to contribute, run \`parall messages unwatch prll://${sanitizeMeta(args.threadRootId)}\` so later replies stop waking you.]`,
+    );
+  }
   if (args.noReply) lines.push(`[Hint: no_reply]`);
   if (isForwardedMessageBody(args.text)) {
     // Embed the concrete --from anchor: parel snapshots one invocation
@@ -132,7 +155,21 @@ export function buildChatPrompt(args: ChatPromptArgs): string {
   }
   lines.push(...attachmentLines(args.attachments));
   lines.push('', args.text);
-  return lines.join('\n');
+  return lines.join('\n') + chatSendHint(args);
+}
+
+/**
+ * agent-core's buildSendMessageHint chat branch, verbatim: every chat event
+ * ends with the concrete send command. The standing system prompt teaches the
+ * CLI-only reply contract too, but a per-event reminder is what the standard
+ * runtimes ship — and weak models demonstrably drop the send step without it.
+ */
+function chatSendHint(args: ChatPromptArgs): string {
+  if (args.noReply) return '';
+  if (args.threadRootId) {
+    return `\n<system-reminder>To reply in this thread, run \`parall messages send prll://${args.chatId} --thread-root-id ${sanitizeMeta(args.threadRootId)} --text-file - <<'EOF'\` … \`EOF\` — the quoted heredoc keeps \`$\`, backticks and apostrophes literal (plain \`--text "$1,000"\` sends \`,000\`). Your plain text output is not delivered to the chat.</system-reminder>`;
+  }
+  return `\n<system-reminder>To reply, run \`parall messages send prll://${args.chatId} --text-file - <<'EOF'\` … \`EOF\` — the quoted heredoc keeps \`$\`, backticks and apostrophes literal (plain \`--text "$1,000"\` sends \`,000\`). Your plain text output is not delivered to the chat.</system-reminder>`;
 }
 
 export interface ChannelPromptArgs {
@@ -141,6 +178,7 @@ export interface ChannelPromptArgs {
   /** Conversation shape as recorded on the ChannelConversation (dm/group). */
   conversationType?: string;
   externalConversationId?: string;
+  externalConversationName?: string;
   externalMessageId?: string;
   senderName: string;
   /** The inbound message text (raw, un-framed). */
@@ -156,9 +194,18 @@ export interface ChannelPromptArgs {
 
 export function buildChannelPrompt(args: ChannelPromptArgs): string {
   const providerLabel = sanitizeMeta(args.provider ?? 'external IM');
-  const convLabel = args.externalConversationId
-    ? `${sanitizeMeta(args.externalConversationId)} (${sanitizeMeta(args.conversationType ?? 'conversation')})`
-    : sanitizeMeta(args.conversationType ?? 'conversation');
+  const convType = sanitizeMeta(args.conversationType ?? 'conversation');
+  const convId = args.externalConversationId
+    ? sanitizeMeta(args.externalConversationId)
+    : undefined;
+  const convName = args.externalConversationName
+    ? sanitizeMeta(args.externalConversationName)
+    : undefined;
+  const convLabel = convName
+    ? `${convName} (${convId ? `${convId}, ` : ''}${convType})`
+    : convId
+      ? `${convId} (${convType})`
+      : convType;
   const lines = [
     '[Event: channel.message]',
     `[Channel: ${providerLabel} | conversation: ${convLabel}]`,
@@ -175,14 +222,23 @@ export function buildChannelPrompt(args: ChannelPromptArgs): string {
 }
 
 function buildChannelReplyHint(args: ChannelPromptArgs): string {
-  // Single-path routing (multi-channel-architecture-design §6/§8.3): with
-  // the feishu-cli grant, the minted LARKSUITE_CLI_* env rides this turn's
-  // invocation context, so the official lark-cli works ambiently in the
-  // sandbox and is THE reply path. Without the grant there is no outbound
-  // path — say so instead of pointing at the retired provider clip.
-  // cliCapable alone decides: the mint is feishu-specific, so a successful
-  // grant implies Feishu even when the cosmetic provider-label lookup failed.
-  if (args.cliCapable) {
+  // The outbound path is a property of the PROVIDER, not of the agent's
+  // grants. Feishu replies go through the vendor CLI with a platform-brokered
+  // credential; Slack and WeChat replies are platform verbs the `parall` CLI
+  // already carries under the agent's own identity — nothing to mint.
+  //
+  // Deciding on the Feishu grant alone told a Slack or WeChat inbound that
+  // outbound was disabled while its own system prompt declared the matching
+  // `parall <provider> send` verb, and could hand a dual-bound agent a
+  // `lark-cli` instruction addressed to a Slack conversation.
+  //
+  // Whether the command is ALLOWED stays a runtime question: every verb and
+  // the Feishu broker re-check the grant at call time. This only names the
+  // right door.
+  // Both halves are required: the mint is Feishu-only and says nothing about
+  // where the message arrived, so a dual-bound agent's Slack inbound must not
+  // fall into this branch just because its Feishu grant is live.
+  if (args.cliCapable && args.provider === 'feishu') {
     const convRef = args.externalConversationId
       ? `chat_id "${args.externalConversationId}"`
       : 'the conversation id named in this event';
@@ -191,6 +247,24 @@ function buildChannelReplyHint(args: ChannelPromptArgs): string {
       : '';
     return `\n<system-reminder>To reply, use the official Feishu CLI in your sandbox: send a message to ${convRef} with \`lark-cli im\` (see \`lark-cli im --help\` for send syntax; auth is provisioned in your environment — if lark-cli is missing, install it once with \`npm i -g @larksuite/cli\`).${threadAlt} lark-cli is the ONLY outbound path — your plain text output is NOT delivered to the external conversation.</system-reminder>`;
   }
+  if (args.provider === 'slack') {
+    // The flag and its value together, as agent-core renders it: writing the
+    // option separately from a labelled reference produced
+    // `--channel channel "C123"`.
+    const channelArg = args.externalConversationId
+      ? ` --channel "${args.externalConversationId}"`
+      : ' --channel <conversation id from this event>';
+    // Channel sends REQUIRE a reply anchor; DMs take one too so a question
+    // asked in a thread is answered in that thread.
+    const replyTo = args.externalMessageId ? ` --reply-to "${args.externalMessageId}"` : '';
+    return `\n<system-reminder>To reply, use \`parall slack send${channelArg}${replyTo} --text <text>\` from your sandbox (use \`--text-file -\` with a quoted heredoc for anything containing \`$\`, backticks or quotes). That verb is the ONLY outbound path — your plain text output is NOT delivered to the external conversation.</system-reminder>`;
+  }
+  if (args.provider === 'wechat') {
+    const toArg = args.externalConversationId
+      ? `"${args.externalConversationId}"`
+      : '<wxid from this event>';
+    return `\n<system-reminder>To reply, use \`parall wechat send --to ${toArg} --text <text>\` from your sandbox (use \`--text-file -\` with a quoted heredoc for anything containing \`$\`, backticks or quotes). WeChat has no threads: a group reply lands in the whole room. That verb is the ONLY outbound path — your plain text output is NOT delivered to the external conversation.</system-reminder>`;
+  }
   const platform = args.provider ?? 'the external platform';
   return `\n<system-reminder>This message arrived from ${platform}, but outbound replies are currently disabled for this org (no channel capability granted). Do NOT attempt to reply on the external platform. If action is needed, surface it inside Parall (\`parall messages send\` / \`parall dm\`). Your plain text output is not delivered anywhere.</system-reminder>`;
 }

package/src/inbound-channel.ts

@@ -10,8 +10,8 @@ import {
   invalidateSession,
   nextEnvelopeId,
   patchSession,
-  readActiveEmit,
   REQUEST_TIMEOUT_MS,
+  readActiveEmit,
   TURN_ENVELOPE_KEY,
   writeActiveEmit,
 } from './session.js';
@@ -100,11 +100,14 @@ export async function effectsForChannelDispatch(
   const conv = (await c.json().catch(() => null)) as {
     connection_id?: string;
     external_conversation_id?: string;
+    external_conversation_name?: string;
     conversation_type?: string;
   } | null;
 
   // Provider (= clip alias) for prompt labeling + the reply hint.
-  // Best-effort: an unresolved provider degrades the wording, never blocks.
+  // A gone connection degrades the wording; an unreachable platform throws,
+  // because the provider now decides the turn's outbound path (see the
+  // resolver).
   const connectionId = conv?.connection_id ? String(conv.connection_id) : undefined;
   const provider = connectionId ? await resolveChannelProvider(ctx, connectionId, get) : undefined;
 
@@ -112,6 +115,9 @@ export async function effectsForChannelDispatch(
   const externalConversationId = conv?.external_conversation_id
     ? String(conv.external_conversation_id)
     : undefined;
+  const externalConversationName = conv?.external_conversation_name
+    ? String(conv.external_conversation_name)
+    : undefined;
   const externalMessageId = msg?.external_message_id ? String(msg.external_message_id) : undefined;
 
   // Progress reporting — identical ordering contract to the message path
@@ -178,7 +184,10 @@ export async function effectsForChannelDispatch(
 
   // Live capability grant → this turn's lark-cli auth env (mint gate = the
   // no-drift revocation point) + the hint teaching the single reply path.
-  const capabilityEnv = await channelCapabilityEnv(ctx);
+  // The mint is Feishu-only. Asking for it on a Slack or WeChat inbound buys
+  // nothing (those replies are platform verbs under the agent's own identity)
+  // and would put a Feishu credential in a turn that has no use for one.
+  const capabilityEnv = provider === 'feishu' ? await channelCapabilityEnv(ctx) : null;
 
   return [
     {
@@ -201,6 +210,7 @@ export async function effectsForChannelDispatch(
             provider,
             conversationType: conv?.conversation_type ? String(conv.conversation_type) : undefined,
             externalConversationId,
+            externalConversationName,
             externalMessageId,
             senderName,
             text,
@@ -210,6 +220,7 @@ export async function effectsForChannelDispatch(
           channelMessageId: sourceId,
           provider,
           externalConversationId,
+          externalConversationName,
           externalMessageId,
         },
         // No chatId on purpose: the reply is the agent's own lark-cli send,
@@ -272,14 +283,18 @@ async function resolveChannelProvider(
   const cacheKey = `channelProvider:${connectionId}`;
   const cached = await ctx.store?.get(cacheKey).catch(() => null);
   if (typeof cached === 'string' && cached) return cached;
-  try {
-    const res = await get(`/channel-connections/${connectionId}`, PROVIDER_LOOKUP_TIMEOUT_MS);
-    if (!res.ok) return undefined;
-    const body = (await res.json().catch(() => null)) as { provider?: string } | null;
-    const provider = body?.provider ? String(body.provider) : undefined;
-    if (provider) await ctx.store?.set(cacheKey, provider).catch(() => {});
-    return provider;
-  } catch {
-    return undefined;
+  const res = await get(`/channel-connections/${connectionId}`, PROVIDER_LOOKUP_TIMEOUT_MS);
+  // A gone connection is an ANSWER (no provider); anything else is the
+  // platform failing to answer. That distinction used to be moot — the
+  // provider was prompt wording — but it now decides which outbound path the
+  // turn is taught, and a turn taught nothing still completes its source and
+  // is never revisited. Throwing leaves the dispatch for the catch-up pass.
+  if (res.status === 404 || res.status === 410) return undefined;
+  if (!res.ok) {
+    throw new Error(`channel connection lookup failed (${res.status})`);
   }
+  const body = (await res.json().catch(() => null)) as { provider?: string } | null;
+  const provider = body?.provider ? String(body.provider) : undefined;
+  if (provider) await ctx.store?.set(cacheKey, provider).catch(() => {});
+  return provider;
 }

package/src/inbound.ts

@@ -5,8 +5,6 @@ import type {
   ConnectorEffect,
   WebSocketFrame,
 } from '@parel/plugin-sdk';
-import { channelCapabilityEnv } from './channel-capability.js';
-import { buildChatPrompt, type PromptAttachment } from './channel-prompt.js';
 import {
   armCatchUpEffect,
   beginCatchUp,
@@ -14,8 +12,9 @@ import {
   deferToCatchUp,
   runCatchUpRound,
 } from './catchup.js';
+import { channelCapabilityEnv } from './channel-capability.js';
+import { buildChatPrompt, type PromptAttachment } from './channel-prompt.js';
 import { parallApiUrl, parallOrgId, requireAgk, sandboxEnabled } from './connect.js';
-import { effectsForChannelDispatch, PROVIDER_LOOKUP_TIMEOUT_MS } from './inbound-channel.js';
 import {
   buildForkScopePrefix,
   bumpForkRetryAttempts,
@@ -33,6 +32,7 @@ import {
   settleChildEvent,
   trackFollowUpAck,
 } from './fork.js';
+import { effectsForChannelDispatch, PROVIDER_LOOKUP_TIMEOUT_MS } from './inbound-channel.js';
 import {
   ackByIdEffect,
   claimDispatchSource,
@@ -51,9 +51,9 @@ import {
   nextEnvelopeId,
   noteTurnEventsObserved,
   patchSession,
+  REQUEST_TIMEOUT_MS,
   readActiveEmit,
   reportingEnabled,
-  REQUEST_TIMEOUT_MS,
   TURN_ENVELOPE_KEY,
   writeActiveEmit,
 } from './session.js';