@xmanrui/dsh-im 4.13.0 → 4.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmanrui/dsh-im",
-  "version": "4.13.0",
+  "version": "4.15.0",
   "description": "把九种 IM 机器人和公网 AI Office 接入本机 DeepSeek Harness。 Connect nine IM channels and a public AI Office to a local DeepSeek Harness.",
   "keywords": [
     "deepseek-harness",

package/plugin-src/client/channels/feishu/api.js

@@ -32,6 +32,7 @@ export const FEISHU_ENDPOINTS = Object.freeze({
   setAccessPolicy: "bot.access-policy.set",
   setGroupResponseMode: "bot.group-response-mode.set",
   setGroupTopicReply: "bot.group-topic-reply.set",
+  setStepPush: "bot.step-push.set",
   // Kept for rolling upgrades. The multi-bot UI never calls these endpoints.
   testConnection: "connection.test",
   disconnect: "connection.disconnect",
@@ -217,6 +218,7 @@ export function normalizeBotConnection(value, fallbackBotId) {
       : {}),
     groupResponseMode: normalizeGroupResponseMode(value.groupResponseMode),
     groupTopicReply: value.groupTopicReply === true,
+    stepPush: value.stepPush === true,
     groupMessagePermissionGranted: value.groupMessagePermissionGranted === true,
     bot: normalizeBot(value.bot),
     health: normalizeHealth(value.health, connected),

package/plugin-src/client/channels/feishu/index.js

@@ -310,7 +310,7 @@ function QrPane({ provision, now, onRefresh, onCancel, busy }) {
               ? "使用飞书确认群消息权限"
               : "使用飞书扫码创建机器人"),
         h("p", null, repairing
-          ? "扫码会更新现有飞书应用，增量补充当前缺少的卡片按钮回调、读取用户消息内图片或文件所需的 im:message:readonly（飞书显示为“获取单聊、群组消息”）、上传机器人图片或文件所需的 im:resource，以及原生命令面板所需的 application:app_slash_command:read / write；不会创建新应用。确认页只显示当前缺少项，完成后此机器人会短暂重连，其他机器人不受影响。"
+          ? "扫码会更新现有飞书应用，增量补充当前缺少的卡片按钮回调、读取用户消息内图片或文件所需的 im:message:readonly（飞书显示为“获取单聊、群组消息”）、上传机器人图片或文件所需的 im:resource、接收群内其他机器人 @ 当前机器人所需的 im:message.group_at_msg.include_bot:readonly，以及原生命令面板所需的 application:app_slash_command:read / write；不会创建新应用。确认页只显示当前缺少项，完成后此机器人会短暂重连，其他机器人不受影响。"
           : grantingGroupMessages
             ? "扫码会更新现有飞书应用，只增量开通“获取群组中所有消息”权限；不会创建新应用。确认后会自动启用“响应所有群消息”，其他机器人不受影响。"
             : "扫码只会新增一个机器人，已接入的机器人会继续正常收发消息。"),
@@ -464,6 +464,53 @@ function RemoveConfirmation({ bot, busy, onConfirm, onCancel }) {
   );
 }
 
+/** Toggle row for 分步直推, mirroring the group-topic reply toggle pattern. */
+function StepPushEditor({ value = false, disabled = false, onSave }) {
+  const titleId = React.useId();
+  const current = value === true ? "on" : "off";
+  const [saving, setSaving] = React.useState(false);
+  const [error, setError] = React.useState(null);
+
+  const change = async (event) => {
+    const next = event.target.value === "on";
+    if ((next ? "on" : "off") === current || saving || disabled) return;
+    setSaving(true);
+    setError(null);
+    try {
+      await onSave?.(next);
+    } catch (cause) {
+      setError(cause?.message ?? "分步直推设置保存失败，请重试。");
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  return h("section", {
+    className: "dim-feishuGroupControl",
+    "aria-labelledby": titleId,
+  },
+  h("div", { className: "dim-feishuGroupControlHeader" },
+    h("h3", { id: titleId }, "分步直推"),
+    saving
+      ? h("span", { className: "dim-feishuGroupControlStatus", role: "status" }, "保存中…")
+      : null),
+  h("select", {
+    className: "dim-feishuGroupSelect",
+    value: current,
+    disabled: disabled || saving,
+    "aria-label": "分步直推",
+    onChange: (event) => { void change(event); },
+  },
+  h("option", { value: "off" }, "关闭（保持流式卡模式）"),
+  h("option", { value: "on" }, "开启（逐步推送工具调用与过程说明）")),
+  h("p", { className: "dim-feishuGroupHelp" },
+    "开启后逐步推送工具调用与过程说明"),
+  error ? h("p", {
+    className: "dim-feishuGroupError",
+    role: "alert",
+  }, error) : null);
+}
+
 export function BotCard({
   connection,
   busy,
@@ -479,6 +526,7 @@ export function BotCard({
   onModelSave,
   onAgentPresetSave,
   onContextEnhancementSave,
+  onStepPushSave,
   onRequestRemove,
   onConfirmRemove,
   onCancelRemove,
@@ -565,6 +613,11 @@ export function BotCard({
         disabled: Boolean(busy),
         onSave: onContextEnhancementSave,
       }),
+      h(StepPushEditor, {
+        value: connection.stepPush,
+        disabled: Boolean(busy),
+        onSave: onStepPushSave,
+      }),
       provisionContent
         ? h("section", {
             className: "bxf-botProvision dim-botProvision",
@@ -657,6 +710,7 @@ function BotList(props) {
           onModelSave: (model) => props.onModelSave(bot, model),
           onAgentPresetSave: (agentPreset) => props.onAgentPresetSave(bot, agentPreset),
           onContextEnhancementSave: (config) => props.onContextEnhancementSave(bot, config),
+          onStepPushSave: (stepPush) => props.onStepPushSave(bot, stepPush),
           onRequestRemove: () => props.onRequestRemove(bot),
           onConfirmRemove: () => props.onConfirmRemove(bot),
           onCancelRemove: props.onCancelRemove,
@@ -1431,6 +1485,9 @@ export function FeishuSettingsTab({ rpcCall }) {
                   onContextEnhancementSave: (connection, config) => saveBotSetting(
                     connection, "context-enhancement", FEISHU_ENDPOINTS.setContextEnhancement, { config },
                   ),
+                  onStepPushSave: (connection, stepPush) => saveBotSetting(
+                    connection, "step-push", FEISHU_ENDPOINTS.setStepPush, { stepPush },
+                  ),
                   onRequestRemove: requestRemove,
                   onConfirmRemove: (bot) => void confirmRemove(bot),
                   onCancelRemove: cancelRemove,

package/plugin-src/client/i18n.js

@@ -220,6 +220,11 @@ const EN = Object.freeze({
   '关闭（群内直接回复）': 'Off (reply in the group feed)',
   '开启（自动开启独立飞书话题）': 'On (auto-open a dedicated Feishu topic)',
   '开启后，群聊中向机器人提问会自动开启独立飞书话题，回复落在话题内；每个话题是 dsh 会话列表里一条独立会话，上下文互不串。私聊不受影响。': 'When enabled, questions to the bot in a group auto-open a dedicated Feishu topic and replies stay inside it. Each topic is an independent conversation in dsh with its own context. Private chats are unaffected.',
+  '分步直推': 'Step push',
+  '开启后逐步推送工具调用与过程说明': 'Push tool calls and process notes step by step',
+  '关闭（保持流式卡模式）': 'Off (keep the streaming card)',
+  '开启（逐步推送工具调用与过程说明）': 'On (push tool calls and process notes step by step)',
+  '分步直推设置保存失败，请重试。': 'Could not save the step push setting. Try again.',
   '钉钉设置': 'DingTalk settings',
   '企业微信设置': 'WeCom settings',
   '扫码接入机器人': 'Scan QR code',
@@ -454,7 +459,7 @@ const EN = Object.freeze({
   '权限配置已提交，正在启用全部消息模式并重连此机器人；此阶段无法取消，其他机器人不会中断。': 'The permission update was submitted. Enabling all-message mode and reconnecting this bot. This stage cannot be cancelled; other bots will not be interrupted.',
   '正在为现有飞书应用申请群消息权限二维码，请稍候。': 'Requesting a group-message permission QR code for the existing Feishu app…',
   '群消息权限没有开通完成': 'Group-message permission was not granted',
-  '扫码会更新现有飞书应用，增量补充当前缺少的卡片按钮回调、读取用户消息内图片或文件所需的 im:message:readonly（飞书显示为“获取单聊、群组消息”）、上传机器人图片或文件所需的 im:resource，以及原生命令面板所需的 application:app_slash_command:read / write；不会创建新应用。确认页只显示当前缺少项，完成后此机器人会短暂重连，其他机器人不受影响。': 'Scanning updates the existing Feishu app with the missing card-button callback, im:message:readonly for reading images or files in user messages (shown by Feishu as “Read direct and group messages”), im:resource for uploading images or files sent by the bot, and application:app_slash_command:read / write for the native command panel. It does not create a new app. The confirmation page shows only missing items; this bot reconnects briefly afterward, while other bots are unaffected.',
+  '扫码会更新现有飞书应用，增量补充当前缺少的卡片按钮回调、读取用户消息内图片或文件所需的 im:message:readonly（飞书显示为“获取单聊、群组消息”）、上传机器人图片或文件所需的 im:resource、接收群内其他机器人 @ 当前机器人所需的 im:message.group_at_msg.include_bot:readonly，以及原生命令面板所需的 application:app_slash_command:read / write；不会创建新应用。确认页只显示当前缺少项，完成后此机器人会短暂重连，其他机器人不受影响。': 'Scanning updates the existing Feishu app with the missing card-button callback, im:message:readonly for reading images or files in user messages (shown by Feishu as “Read direct and group messages”), im:resource for uploading images or files sent by the bot, im:message.group_at_msg.include_bot:readonly for receiving group messages from other bots that mention this bot, and application:app_slash_command:read / write for the native command panel. It does not create a new app. The confirmation page shows only missing items; this bot reconnects briefly afterward, while other bots are unaffected.',
   '核对现有应用名称，并确认只新增当前缺少的上述配置': 'Review the existing app name and confirm that only the missing items described above are added',
   '保持本页打开，等待权限与回调补全完成': 'Keep this page open until permissions and the callback are complete',
   '取消补全': 'Cancel setup',

package/plugin-src/client/index.js

@@ -59,6 +59,7 @@ import {
   replacePageLocation,
 } from './loopback-recovery.js';
 import { installImStyles } from './styles.js';
+import { installSessionChannelLogos } from './session-channel-logos.js';
 import { UpdatePanel, UPDATE_RPC_CHANNEL } from './update-panel.js';
 import { WorkspaceDirectoryPickerContext } from './workspace-editor.js';
 
@@ -366,6 +367,8 @@ export function apply(ctx) {
   const t = ctx.locale.bind(IM_LOCALE_NAMESPACE);
   setImTranslator(t);
 
+  ctx.effect(() => installSessionChannelLogos(), 'im-settings: Session channel logos');
+
   ctx.effect(() => {
     const disposers = [
       installFeishuStyles(),

package/plugin-src/client/session-channel-logos.js

@@ -0,0 +1,241 @@
+import { parseSessionChannelTitle } from '../../src/channels/shared/session-channel-labels.mjs';
+import {
+  WeixinLogoGlyph, FeishuLogoGlyph, DingtalkLogoGlyph, WecomLogoGlyph, QqLogoGlyph,
+  SlackLogoGlyph, TelegramLogoGlyph, DiscordLogoGlyph, WhatsappLogoGlyph, OfficeLogoGlyph,
+} from './channel-logos.js';
+
+const GLYPHS = Object.freeze({
+  weixin: [WeixinLogoGlyph, '#07c160'],
+  feishu: [FeishuLogoGlyph, '#3370ff'],
+  dingtalk: [DingtalkLogoGlyph, '#1677ff'],
+  wecom: [WecomLogoGlyph, '#3370ff'],
+  qq: [QqLogoGlyph, '#12b7f5'],
+  slack: [SlackLogoGlyph, '#e01e5a'],
+  telegram: [TelegramLogoGlyph, '#229ed9'],
+  discord: [DiscordLogoGlyph, '#5865f2'],
+  whatsapp: [WhatsappLogoGlyph, '#25d366'],
+  office: [OfficeLogoGlyph, '#f97316'],
+});
+const CHANNEL_ATTR = 'data-dsh-im-session-channel';
+const TITLE_ATTR = 'data-dsh-im-session-text';
+const MARKED = `[${CHANNEL_ATTR}]`;
+const ROW = '[role="treeitem"][aria-selected]';
+const SVG_NS = 'http://www.w3.org/2000/svg';
+const installations = new WeakMap();
+
+function hasClassPart(element, part) {
+  const match = new RegExp(`(?:^|[_-])${part}(?:$|[_-])`, 'u');
+  return [...element.classList].some((token) => match.test(token));
+}
+
+function titleOf(row) {
+  if (!row.matches(ROW) || row.closest('input, textarea, [contenteditable]:not([contenteditable="false"])')) return null;
+  let title;
+  if (row.tagName === 'DIV' && hasClassPart(row, 'sessionRow')) {
+    title = [...row.children].find((child) => child.tagName === 'SPAN' && hasClassPart(child, 'title'));
+  } else if (row.tagName === 'BUTTON' && hasClassPart(row, 'searchResultRow')) {
+    const heading = [...row.children].find((child) => hasClassPart(child, 'searchResultHeading'));
+    title = heading && [...heading.children].find((child) => child.tagName === 'SPAN' && hasClassPart(child, 'searchResultTitle'));
+  }
+  // Never cover inline rename inputs, highlighted search markup, or a future
+  // row structure that this adapter does not understand.
+  return title?.childNodes.length === 1 && title.firstChild.nodeType === 3 ? title : null;
+}
+
+/** Serialize the existing, static SVG glyphs without mounting React nodes. */
+function logoUri(document, channel) {
+  const [Glyph, color] = GLYPHS[channel];
+  const render = (node) => {
+    if (!['svg', 'path'].includes(node.type)) throw new Error('Unsupported channel logo element');
+    const element = document.createElementNS(SVG_NS, node.type);
+    for (const [name, value] of Object.entries(node.props)) {
+      if (name === 'children') continue;
+      const attribute = name.startsWith('stroke')
+        ? name.replace(/[A-Z]/gu, (letter) => `-${letter.toLowerCase()}`)
+        : name;
+      element.setAttribute(attribute, String(value));
+    }
+    for (const child of [node.props.children].flat().filter(Boolean)) element.appendChild(render(child));
+    return element;
+  };
+  const svg = render(Glyph({ size: 16 }));
+  svg.setAttribute('xmlns', SVG_NS);
+  svg.setAttribute('color', color);
+  return `data:image/svg+xml,${encodeURIComponent(svg.outerHTML)}`;
+}
+
+function createInstallation(document) {
+  const view = document.defaultView;
+  const ready = new Set();
+  const owned = new Map();
+  const queued = new Set();
+  const images = [];
+  let closed = false;
+  let scheduled = false;
+  const style = document.createElement('style');
+  style.dataset.pluginCss = 'dsh-im-session-channel-logos';
+  const uris = Object.fromEntries(Object.keys(GLYPHS).map((channel) => [channel, logoUri(document, channel)]));
+  style.textContent = `
+${MARKED}[${TITLE_ATTR}] {
+  position: relative;
+  -webkit-text-fill-color: transparent;
+  text-overflow: clip !important;
+  overflow: hidden;
+}
+${MARKED}[${TITLE_ATTR}]::before {
+  content: "";
+  position: absolute;
+  inset-inline-start: 0;
+  top: 50%;
+  transform: translateY(-50%);
+  width: 16px;
+  height: 16px;
+  background: var(--dsh-im-session-logo) center / contain no-repeat;
+  text-indent: 0;
+  pointer-events: none;
+}
+${MARKED}[${TITLE_ATTR}]::after {
+  content: attr(${TITLE_ATTR}) / "";
+  position: absolute;
+  inset: 0;
+  inset-inline-start: 22px;
+  -webkit-text-fill-color: currentColor;
+  text-indent: 0;
+  overflow: hidden;
+  white-space: nowrap;
+  text-overflow: ellipsis;
+  pointer-events: none;
+}
+${Object.entries(uris).map(([channel, uri]) => `[${CHANNEL_ATTR}="${channel}"] { --dsh-im-session-logo: url("${uri}"); }`).join('\n')}
+`;
+  document.head.appendChild(style);
+
+  const restore = (title) => {
+    const previous = owned.get(title);
+    if (!previous) return;
+    owned.delete(title);
+    for (const [attribute, value] of previous) {
+      if (value === null) title.removeAttribute(attribute);
+      else title.setAttribute(attribute, value);
+    }
+  };
+  const update = (row) => {
+    const title = row.isConnected ? titleOf(row) : null;
+    for (const marked of row.querySelectorAll(MARKED)) {
+      if (marked !== title) restore(marked);
+    }
+    if (!title) return;
+    const parsed = parseSessionChannelTitle(title.textContent);
+    if (!parsed || !ready.has(parsed.channel)) {
+      restore(title);
+      return;
+    }
+    if (!owned.has(title)) {
+      owned.set(title, [CHANNEL_ATTR, TITLE_ATTR].map((attribute) => [attribute, title.getAttribute(attribute)]));
+    }
+    // React retains its original text node, content, row, and handlers. Only
+    // plugin-owned attributes drive the visual replacement via pseudo-elements.
+    title.setAttribute(TITLE_ATTR, parsed.title);
+    title.setAttribute(CHANNEL_ATTR, parsed.channel);
+  };
+  const schedule = () => {
+    if (closed || scheduled || !queued.size) return;
+    scheduled = true;
+    queueMicrotask(() => {
+      scheduled = false;
+      if (closed) return;
+      const rows = [...queued];
+      queued.clear();
+      for (const row of rows) {
+        try {
+          update(row);
+        } catch {
+          for (const marked of row.querySelectorAll(MARKED)) restore(marked);
+        }
+      }
+    });
+  };
+  const collect = (node, descendants = false) => {
+    const element = node.nodeType === 1 ? node : node.parentElement;
+    if (!element) return;
+    const row = element.closest(ROW);
+    if (row) queued.add(row);
+    if (descendants) {
+      for (const child of element.querySelectorAll(ROW)) queued.add(child);
+      // Also restore an already decorated title moved outside a recognized row.
+      const marked = [...element.querySelectorAll(MARKED)];
+      if (owned.has(element)) marked.push(element);
+      for (const title of marked) {
+        const owner = title.closest(ROW);
+        if (owner) queued.add(owner);
+        else restore(title);
+      }
+    }
+    schedule();
+  };
+  const observer = new view.MutationObserver((records) => {
+    if (closed) return;
+    for (const record of records) {
+      collect(record.target, record.type === 'attributes');
+      if (record.type !== 'childList') continue;
+      for (const node of record.addedNodes) collect(node, true);
+      for (const node of record.removedNodes) {
+        if (node.nodeType !== 1 || node.isConnected) continue;
+        if (owned.has(node)) restore(node);
+        for (const title of node.querySelectorAll(MARKED)) restore(title);
+      }
+    }
+  });
+  observer.observe(document.body, {
+    subtree: true, childList: true, characterData: true,
+    attributes: true, attributeFilter: ['class', 'role', 'aria-selected', 'contenteditable'],
+  });
+
+  // A CSP or an image-loading failure leaves that channel's readable text
+  // prefix in place. No title is hidden until its actual SVG has loaded.
+  for (const [channel, uri] of Object.entries(uris)) {
+    const image = new view.Image();
+    images.push(image);
+    image.onload = () => {
+      if (closed) return;
+      ready.add(channel);
+      collect(document.body, true);
+    };
+    image.src = uri;
+  }
+  return () => {
+    closed = true;
+    observer.disconnect();
+    queued.clear();
+    for (const image of images) image.onload = null;
+    for (const title of [...owned.keys()]) restore(title);
+    style.remove();
+  };
+}
+
+/** Browser-only enhancement; unknown/unsupported surfaces keep text prefixes. */
+export function installSessionChannelLogos(document = globalThis.document) {
+  const view = document?.defaultView;
+  if (!document?.body || !document?.head || !view?.MutationObserver || !view?.Image
+    || !view.CSS?.supports?.('content', `attr(${TITLE_ATTR}) / ""`)
+    || !view.CSS.supports('-webkit-text-fill-color', 'transparent')) return () => {};
+  let entry = installations.get(document);
+  if (!entry) {
+    try {
+      entry = { references: 0, close: createInstallation(document) };
+    } catch {
+      return () => {};
+    }
+    installations.set(document, entry);
+  }
+  entry.references += 1;
+  let released = false;
+  return () => {
+    if (released) return;
+    released = true;
+    entry.references -= 1;
+    if (entry.references > 0) return;
+    entry.close();
+    installations.delete(document);
+  };
+}

package/plugin-src/host/channels/feishu/production.mjs

@@ -218,6 +218,7 @@ export async function createProductionController(ctx, config = {}, internals = {
         botOpenId: botConfig.botOpenId,
         groupResponseMode: botConfig.groupResponseMode,
         groupTopicReply: botConfig.groupTopicReply,
+        stepPush: botConfig.stepPush,
         ownerOpenIds: botConfig.ownerOpenIds ?? [botConfig.ownerOpenId],
         harness: workspaceScope.harness,
         state: workspaceScope.state,

package/plugin-src/host/channels/feishu/rpc.mjs

@@ -294,6 +294,7 @@ function publicBotEntry(entry) {
     accessPolicy: normalizeAccessPolicy(source.accessPolicy),
     groupResponseMode: normalizeFeishuGroupResponseMode(source.groupResponseMode),
     groupTopicReply: source.groupTopicReply === true,
+    stepPush: source.stepPush === true,
     groupMessagePermissionGranted: source.groupMessagePermissionGranted === true,
     bot: publicBot(source.bot),
     health: publicHealth(source, connected),
@@ -458,6 +459,13 @@ function validPayload(endpoint, payload) {
       ? null
       : '请选择是否以话题方式回复。';
   }
+  if (endpoint === FEISHU_ENDPOINTS.setStepPush) {
+    return hasOnlyKeys(payload, new Set(['botId', 'stepPush']))
+      && safeOpaqueId(payload.botId)
+      && typeof payload.stepPush === 'boolean'
+      ? null
+      : '请选择是否分步直推。';
+  }
   return 'Unknown Feishu endpoint.';
 }
 
@@ -742,6 +750,14 @@ export function createFeishuRpcHandler(controller, { encodeQr = qrCodeDataUrl }
           await controller.updateGroupTopicReply(payload.botId, payload.groupTopicReply),
           { encodeQr: cachedEncodeQr },
         );
+      } else if (endpoint === FEISHU_ENDPOINTS.setStepPush) {
+        if (typeof controller.updateStepPush !== 'function') {
+          throw new Error('Step push update is unavailable');
+        }
+        value = await toPublicFeishuStatus(
+          await controller.updateStepPush(payload.botId, payload.stepPush),
+          { encodeQr: cachedEncodeQr },
+        );
       } else {
         if (typeof controller.deleteBot !== 'function') throw new Error('Multi-bot delete is unavailable');
         value = await toPublicFeishuStatus(await controller.deleteBot(payload.botId), { encodeQr: cachedEncodeQr });

package/plugin-src/host/index.mjs

@@ -15,6 +15,7 @@ import { installDeliveryHttp } from './delivery-http.mjs';
 import { createDeliveryService } from './delivery-service.mjs';
 import { installInboundTtlRpc } from './inbound-ttl-rpc.mjs';
 import { installSessionSyncCoordinator } from './session-sync-coordinator.mjs';
+import { installSessionTitlePrefix } from './session-title-prefix.mjs';
 import { installUpdateRpc } from './update-rpc.mjs';
 
 export const name = 'dsh-im-host';
@@ -103,6 +104,19 @@ export function createImHostPlugin(internals = {}) {
 
   async function activateChannels(ctx, config, deliveryService) {
     setImHostLanguage(config.language ?? process.env.DSH_IM_LANGUAGE);
+    const startTitlePrefix = (titleCtx) => {
+      // The installer owns its cleanup through ctx.effect(). Cordis startup
+      // callbacks must not return its controller object as an effect.
+      installSessionTitlePrefix(titleCtx, {
+        logger: typeof titleCtx?.logger === 'function'
+          ? titleCtx.logger('dsh-im:session-title') : (titleCtx?.logger ?? console),
+      });
+    };
+    if (typeof ctx?.inject === 'function') {
+      ctx.inject(['sessions'], startTitlePrefix);
+    } else if (ctx?.sessions && typeof ctx.on === 'function') {
+      startTitlePrefix(ctx);
+    }
     if (typeof ctx?.inject === 'function') {
       ctx.inject(['tools', 'systemPrompt'], (artifactCtx) => {
         installOutboundArtifactTool(artifactCtx);

package/plugin-src/host/session-title-prefix.mjs

@@ -0,0 +1,122 @@
+import { getImHostLanguage } from '../../src/channels/shared/i18n.mjs';
+import { SESSION_CHANNEL_LABELS as CHANNEL_LABELS } from '../../src/channels/shared/session-channel-labels.mjs';
+const UUID = '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}';
+// HarnessClient uses these ids for prompts and steering, independently of
+// context enhancement. Read the durable source, never the message's text.
+const IM_RPC_ID = new RegExp(`^(${Object.keys(CHANNEL_LABELS).join('|')})-(?:steer-)?${UUID}$`, 'u');
+const LEGACY_SESSION_ID = new RegExp(`^(${Object.keys(CHANNEL_LABELS).join('|')})-.+`, 'u');
+
+function eventsOf(session) {
+  const events = typeof session?.snapshotEvents === 'function'
+    ? session.snapshotEvents()
+    : session?.events;
+  return Array.isArray(events) ? events : [];
+}
+
+function channelOf(session, events) {
+  // A Web-created fork must not acquire a channel just from its parent's
+  // messages. Both supported Session implementations expose this boundary.
+  const inherited = session.inheritedEventCount;
+  if (session.header?.parentSession && !Number.isSafeInteger(inherited)) return null;
+  for (const event of events) {
+    if (Number.isSafeInteger(inherited) && event.seq < inherited) continue;
+    if (event.type !== 'user/message' || event.data?.source?.kind !== 'user') continue;
+    const channel = IM_RPC_ID.exec(event.data.source.rpcId)?.[1];
+    if (channel) return channel;
+  }
+  if (session.header?.parentSession) return null;
+  return LEGACY_SESSION_ID.exec(session.id ?? session.sessionId)?.[1] ?? null;
+}
+
+export function withSessionChannelPrefix(title, channel, language = getImHostLanguage()) {
+  const labels = CHANNEL_LABELS[channel];
+  if (!labels || typeof title !== 'string' || !title.trim()) return title;
+  // Keep the original title intact, including Unicode graphemes. The Host
+  // has already normalized and capped its generated text before this point.
+  if (labels.some((label) => title.startsWith(`${label} · `))) return title;
+  return `${labels[language === 'en' ? 1 : 0]} · ${title}`;
+}
+
+function validTitleData(data) {
+  if (typeof data?.title !== 'string' || !data.title.trim()
+    || !Array.isArray(data.messageSeqs)) return false;
+  if (data.source?.kind === 'user') return data.messageSeqs.length === 0;
+  if (!['fallback', 'provider'].includes(data.source?.kind)
+    || data.messageSeqs.length === 0
+    || data.messageSeqs.some((seq) => !Number.isSafeInteger(seq) || seq < 0)) return false;
+  return data.source.kind !== 'provider'
+    || (typeof data.source.provider === 'string' && Boolean(data.source.provider));
+}
+
+/**
+ * Decorate accepted titles without session.rename(): rename pins them as
+ * user-owned and supersedes automatic generation. Appending a log-only title
+ * with the same source and citations preserves the Host's scheduling and
+ * explicit-rename semantics. No provider, prompt, or stored event is changed.
+ */
+export function installSessionTitlePrefix(ctx, { logger = console } = {}) {
+  if (typeof ctx?.on !== 'function' || typeof ctx?.sessions?.get !== 'function'
+    || typeof ctx?.sessions?.list !== 'function') {
+    throw new TypeError('Session title prefixes require Host sessions and events');
+  }
+  const pending = new Map();
+  let closed = false;
+
+  const decorate = (session) => {
+    if (closed || ctx.sessions.get(session.id ?? session.sessionId) !== session
+      || typeof session.append !== 'function') return;
+    const events = eventsOf(session);
+    const channel = channelOf(session, events);
+    if (!channel) return;
+    const latest = events.findLast((event) => event.type === 'session/title');
+    if (!validTitleData(latest?.data)) return;
+    const title = withSessionChannelPrefix(latest.data.title, channel);
+    if (title === latest.data.title) return;
+    // There is no await between the latest-title read and this append. A
+    // queued old result can therefore never replace a newer/manual title.
+    session.append('session/title', {
+      ...structuredClone(latest.data),
+      title,
+    });
+  };
+
+  const enqueue = (session) => {
+    if (closed || pending.has(session)) return;
+    // Leave the current append/notification stack before writing another
+    // event, so persistence and client projections observe monotonically
+    // ordered events. Read the newest title when the microtask runs.
+    const task = Promise.resolve().then(() => {
+      pending.delete(session);
+      decorate(session);
+    }).catch((error) => {
+      logger.warn?.('[dsh-im] unable to add Session channel prefix:', error?.message ?? error);
+    }).finally(() => {
+      if (pending.get(session) === task) pending.delete(session);
+    });
+    pending.set(session, task);
+  };
+
+  const disposeEvent = ctx.on('session/event', (session, event) => {
+    if (event?.type === 'session/title'
+      || (event?.type === 'user/message' && IM_RPC_ID.test(event.data?.source?.rpcId))) {
+      enqueue(session);
+    }
+  }, { global: true });
+  const disposeCreated = ctx.on('session/created', enqueue, { global: true });
+  const close = () => {
+    if (closed) return;
+    closed = true;
+    disposeEvent?.();
+    disposeCreated?.();
+  };
+  if (typeof ctx.effect === 'function') {
+    ctx.effect(() => close, 'dsh-im: Session title channel prefixes');
+  }
+  for (const session of ctx.sessions.list()) enqueue(session);
+  return Object.freeze({
+    close,
+    async whenIdle() {
+      while (pending.size) await Promise.allSettled([...pending.values()]);
+    },
+  });
+}