@xmanrui/dsh-im 4.14.0 → 4.16.0

package/plugin-src/host/delivery-suggestions.mjs

@@ -3,6 +3,7 @@ const CHANNELS = new Set([
   'feishu',
   'dingtalk',
   'wecom',
+  'wecom-app',
   'qq',
   'slack',
   'telegram',
@@ -97,6 +98,8 @@ export function deliverySuggestionFromConversationKey(channel, key) {
         ['direct', 'user', 'chatId'],
         ['group', 'group', 'chatId'],
       ]);
+    case 'wecom-app':
+      return simpleSuggestion(key, [['p2p', 'user', 'chatId']]);
     case 'qq':
       return simpleSuggestion(key, [
         ['c2c', 'user', 'userOpenId'],
@@ -124,6 +127,7 @@ export function privateDeliverySuggestionFromConversationKey(channel, key) {
     feishu: 'p2p',
     dingtalk: 'p2p',
     wecom: 'direct',
+    'wecom-app': 'p2p',
     qq: 'c2c',
     slack: 'direct',
     telegram: 'direct',

package/plugin-src/host/index.mjs

@@ -6,6 +6,7 @@ import { apply as applyQq } from './channels/qq/index.mjs';
 import { apply as applySlack } from './channels/slack/index.mjs';
 import { apply as applyTelegram } from './channels/telegram/index.mjs';
 import { apply as applyWecom } from './channels/wecom/index.mjs';
+import { apply as applyWecomApp } from './channels/wecom-app/index.mjs';
 import { apply as applyWeixin } from './channels/weixin/index.mjs';
 import { apply as applyWhatsapp } from './channels/whatsapp/index.mjs';
 import { installOutboundArtifactTool } from '../../src/channels/shared/semantic/artifact.mjs';
@@ -15,6 +16,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';
@@ -44,6 +46,7 @@ export function createImHostPlugin(internals = {}) {
   const startWeixin = internals.applyWeixin ?? applyWeixin;
   const startDingtalk = internals.applyDingtalk ?? applyDingtalk;
   const startWecom = internals.applyWecom ?? applyWecom;
+  const startWecomApp = internals.applyWecomApp ?? applyWecomApp;
   const startQq = internals.applyQq ?? applyQq;
   const startSlack = internals.applySlack ?? applySlack;
   const startTelegram = internals.applyTelegram ?? applyTelegram;
@@ -55,6 +58,7 @@ export function createImHostPlugin(internals = {}) {
     ['weixin', startWeixin],
     ['dingtalk', startDingtalk],
     ['wecom', startWecom],
+    ['wecomApp', startWecomApp],
     ['qq', startQq],
     ['slack', startSlack],
     ['telegram', startTelegram],
@@ -103,6 +107,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);
@@ -131,14 +148,16 @@ export function createImHostPlugin(internals = {}) {
       }
     }
     const failures = [];
-    for (const [channel, start] of channels) {
+    // Each channel mounts its management RPC before awaiting initialization.
+    // Start them together so a slow channel cannot leave later routes absent.
+    await Promise.all(channels.map(async ([channel, start]) => {
       try {
         await start(ctx, channelConfig(config, channel, deliveryService));
       } catch (error) {
         failures.push(error);
         logger.error?.(`[dsh-im] failed to activate ${channel}; continuing with the remaining channels`, error);
       }
-    }
+    }));
     if (failures.length === channels.length) {
       throw new AggregateError(failures, 'dsh-im failed to activate every channel');
     }

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()]);
+    },
+  });
+}

package/scripts/verify-model-setting.mjs

@@ -0,0 +1,54 @@
+// Exercise the actual settings card in Chromium without a running Host or IM account.
+// Usage: node scripts/verify-model-setting.mjs [output-directory]
+import { execFile } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { mkdtemp, mkdir, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { promisify } from 'node:util';
+import { pathToFileURL } from 'node:url';
+import { build } from 'esbuild';
+
+const browser = process.env.CHROME_PATH ?? [
+  '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+  '/usr/bin/chromium', '/usr/bin/chromium-browser', '/usr/bin/google-chrome',
+].find(existsSync);
+if (!browser) throw new Error('Set CHROME_PATH to a Chromium/Chrome executable.');
+const output = process.argv[2] ? resolve(process.argv[2]) : await mkdtemp(join(tmpdir(), 'dsh-im-model-ui-'));
+await mkdir(output, { recursive: true });
+const built = await build({
+  entryPoints: [resolve(import.meta.dirname, '../test/browser/model-setting.fixture.js')],
+  bundle: true, write: false, format: 'iife', platform: 'browser', target: 'chrome100',
+  define: { 'process.env.NODE_ENV': '"development"' },
+});
+const htmlPath = join(output, 'preview.html');
+await writeFile(htmlPath, `<!doctype html><html lang="zh-CN"><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>DSH-IM Model Settings</title>
+<style>
+body{margin:0;padding:24px;background:#fff;color:#1f2329;font:14px/20px -apple-system,BlinkMacSystemFont,sans-serif}#app{max-width:760px;margin:auto}#result{max-width:760px;margin:18px auto;font:11px/17px monospace;white-space:pre-wrap;color:#687380}
+@media(max-width:600px){body{padding:12px}}
+@media(prefers-color-scheme:dark){:root{color-scheme:dark;--dsw-alias-bg-layer-1:#202125;--dsw-alias-bg-layer-3:#282a30;--dsw-specific-menu:#282a30;--dsw-alias-bg-module-platform:#25272c;--dsw-alias-label-primary:#e9ebef;--dsw-alias-label-secondary:#b1b5bf;--dsw-alias-label-tertiary:#9a9faa;--dsw-alias-border-l1:#34363c;--dsw-alias-border-l2:#41434c;--dsw-alias-border-l3:#7b9ff9;--dsw-alias-interactive-bg-hover:#353842}body{background:#202125;color:#e9ebef}}
+</style><body><div id="app"></div><pre id="result">Running browser checks…</pre><script>${built.outputFiles[0].text.replace(/<\/script/giu, '<\\/script')}</script></body></html>`);
+for (const [name, size, extra, query] of [
+  ['desktop', '1100,1100', [], ''],
+  ['mobile', '390,1250', [], '?mobile'],
+  ['dark-en', '1100,1100', ['--force-dark-mode'], '?en'],
+]) {
+  const profile = await mkdtemp(join(tmpdir(), 'dsh-im-model-browser-'));
+  const { stdout, stderr } = await promisify(execFile)(browser, [
+    '--headless', '--disable-gpu', '--no-sandbox', '--hide-scrollbars',
+    `--user-data-dir=${profile}`, '--no-first-run', '--no-default-browser-check',
+    `--window-size=${size}`, '--force-device-scale-factor=1', '--virtual-time-budget=8000',
+    ...extra, `--screenshot=${join(output, `${name}.png`)}`, '--dump-dom', pathToFileURL(htmlPath).href + query,
+  ], { maxBuffer: 8 * 1024 * 1024, timeout: 15_000, killSignal: 'SIGKILL' }).catch((error) => {
+    // Some desktop Chromium builds finish dump-dom and the screenshot but
+    // hang during shutdown. Only accept a fully returned fixture result.
+    if (error.killed && /<body\b[^>]*\bdata-result="(?:passed|failed)"/u.test(error.stdout ?? '')) return error;
+    throw error;
+  }).finally(() => rm(profile, { recursive: true, force: true }));
+  await writeFile(join(output, `${name}.html`), stdout);
+  await writeFile(join(output, `${name}.log`), stderr);
+  const result = stdout.match(/<pre id="result">([\s\S]*?)<\/pre>/u)?.[1] ?? 'No browser result';
+  if (!stdout.includes('data-result="passed"')) throw new Error(`${name}: ${result}`);
+  console.log(`${name}: ${result}`);
+}
+console.log(`Previews: ${output}`);

package/scripts/verify-session-channel-logos.mjs

@@ -0,0 +1,59 @@
+// Real browser/React verification, with no running DSH Host or IM accounts.
+// CHROME_PATH overrides the browser executable. An optional argument is the output directory.
+import { execFile } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { mkdtemp, mkdir, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { resolve, join } from 'node:path';
+import { promisify } from 'node:util';
+import { pathToFileURL } from 'node:url';
+import { build } from 'esbuild';
+
+const args = process.argv.slice(2);
+const prepareOnly = args.includes('--prepare-only');
+const outputArg = args.find((argument) => argument !== '--prepare-only');
+const browser = process.env.CHROME_PATH ?? [
+  '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+  '/usr/bin/chromium', '/usr/bin/chromium-browser', '/usr/bin/google-chrome',
+].find(existsSync);
+if (!browser && !prepareOnly) throw new Error('Set CHROME_PATH to a Chromium/Chrome executable.');
+const output = outputArg ? resolve(outputArg) : await mkdtemp(join(tmpdir(), 'dsh-im-session-logos-'));
+await mkdir(output, { recursive: true });
+const built = await build({
+  entryPoints: [resolve(import.meta.dirname, '../test/browser/session-channel-logos.fixture.js')],
+  bundle: true, write: false, format: 'iife', platform: 'browser', target: 'chrome100',
+  define: { 'process.env.NODE_ENV': '"development"' },
+});
+const html = `<!doctype html><html lang="zh-CN"><meta charset="utf-8"><title>DSH-IM Session Logo Preview</title>
+<style>
+*{box-sizing:border-box}body{margin:0;background:#f8f9fb;color:#202329;font:14px/20px -apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif}
+.preview{display:flex;min-height:720px}aside{width:350px;flex:none;padding:24px 12px;background:#f0f2f5;border-right:1px solid #e4e6eb}header{padding:0 12px 26px}header strong{display:block;font-size:17px;line-height:26px}small{display:block;color:#7a818e;font-size:11px}.workspace{padding:8px 12px;color:#6f7684;font-size:12px}
+._sessionRow_dsh_104{height:32px;display:flex;align-items:center;gap:0;border-radius:8px;padding:0 8px;cursor:pointer;user-select:none;color:inherit}._sessionRow_dsh_104:hover,._sessionRow_dsh_104.selected{background:#e0e5ec}._title_dsh_170{flex:1;min-width:0;margin:0 6px 0 4px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:14px;line-height:20px}.status{width:16px;flex:none;color:#77a891;text-align:center}.time{font-size:10px;color:#8d95a1}button{font:inherit;cursor:pointer}aside button{border:0;background:none;color:#707a89;width:22px;height:24px}
+main{flex:1;padding:55px 44px}.eyebrow{font-size:10px;font-weight:650;letter-spacing:.13em;color:#788292}h1{font-size:30px;line-height:40px;font-weight:650;margin:12px 0}main>p{color:#727c8a}.message{margin-top:35px;padding:18px 22px;border:1px solid #e3e7ed;border-radius:12px;background:#fff}.message strong{font-size:12px}.message p{color:#626d7c}h2{font-size:13px;font-weight:550;margin:26px 0 8px}._searchResultRow_dsh_25{display:flex;flex-direction:column;align-items:stretch;width:100%;border:1px solid #e3e7ed;border-radius:8px;padding:10px;background:white;text-align:left}._searchResultHeading_dsh_305{display:flex;min-width:0}._searchResultTitle_dsh_313{flex:1;min-width:0;font-size:14px;line-height:20px;overflow:hidden;white-space:nowrap;text-overflow:ellipsis}.search small{margin-top:5px}.note{font-size:11px;margin-top:32px}#result{margin:0;padding:14px 24px;border-top:1px solid #e4e6eb;background:#eef6f1;color:#357759;font:10px/16px ui-monospace,monospace}body[data-result=failed] #result{color:#a22;background:#fee}
+@media(prefers-color-scheme:dark){body{background:#1b1e23;color:#e4e7eb}aside{background:#22262d;border-color:#333941}._sessionRow_dsh_104:hover,._sessionRow_dsh_104.selected{background:#353d49}.message,._searchResultRow_dsh_25{background:#252a32;border-color:#39404b;color:inherit}.message p{color:#c1c8d1}#result{background:#23382e;color:#a2d0b2;border-color:#39404b}}
+</style><body><div id="app"></div><pre id="result">Running browser checks…</pre>
+<script>${built.outputFiles[0].text.replace(/<\/script/giu, '<\\/script')}</script></body></html>`;
+const htmlPath = join(output, 'preview.html');
+await writeFile(htmlPath, html
+  .replace('._sessionRow_dsh_104{', '._dsh_sessionRow,._sessionRow_dsh_104{')
+  .replaceAll('._sessionRow_dsh_104:hover,._sessionRow_dsh_104.selected{', '._dsh_sessionRow:hover,._dsh_sessionRow.selected,._sessionRow_dsh_104:hover,._sessionRow_dsh_104.selected{')
+  .replace('._title_dsh_170{', '._dsh_title,._title_dsh_170{')
+  .replace('._searchResultTitle_dsh_313{flex:1;', '._searchResultTitle_dsh_313{flex:0 auto;'));
+if (prepareOnly) {
+  console.log(`Prepared browser fixture: ${htmlPath}`);
+  process.exit(0);
+}
+const profile = await mkdtemp(join(tmpdir(), 'dsh-im-logo-browser-'));
+const screenshot = join(output, 'preview.png');
+const { stdout, stderr } = await promisify(execFile)(browser, [
+  '--headless', '--disable-gpu', '--no-sandbox', '--hide-scrollbars',
+  `--user-data-dir=${profile}`, '--no-first-run', '--no-default-browser-check',
+  '--window-size=1100,800', '--force-device-scale-factor=1', '--virtual-time-budget=8000',
+  `--screenshot=${screenshot}`, '--dump-dom', pathToFileURL(htmlPath).href,
+], { maxBuffer: 8 * 1024 * 1024, timeout: 30_000 }).finally(() => rm(profile, { recursive: true, force: true }));
+await writeFile(join(output, 'browser.log'), stderr);
+await writeFile(join(output, 'result.html'), stdout);
+const result = stdout.match(/<pre id="result">([\s\S]*?)<\/pre>/u)?.[1] ?? 'No browser result';
+if (!stdout.includes('data-result="passed"')) throw new Error(result);
+console.log(result);
+console.log(`Preview: ${screenshot}`);

package/scripts/verify-session-title-prefix.mjs

@@ -0,0 +1,149 @@
+// Exercise the plugin against an actual built Harness checkout, without an
+// LLM request or a running Host. Run:
+// node scripts/verify-session-title-prefix.mjs /path/to/dsh [all-prompts|first-prompt]
+import assert from 'node:assert/strict';
+import { createRequire } from 'node:module';
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+import { createImHostPlugin } from '../plugin-src/host/index.mjs';
+
+if (!process.argv[2]) throw new Error('Pass the path of a built DSH checkout.');
+const root = resolve(process.argv[2]);
+const automatic = process.argv[3] ?? 'all-prompts';
+assert.ok(['all-prompts', 'first-prompt'].includes(automatic));
+const fromHarness = createRequire(resolve(root, 'packages/session/session-title/package.json'));
+const load = (name) => import(pathToFileURL(fromHarness.resolve(name)).href);
+const { Context } = await load('@deepseek-ai/cordis');
+const { default: SessionStore, SessionId } = await load('@deepseek-ai/dsh-session');
+const { default: SessionProjectionRegistry } = await load('@deepseek-ai/dsh-session-projection');
+const { default: SessionTitleService, SessionTitleProviderId } = await load('@deepseek-ai/dsh-session-title');
+const { createUserMessage } = await load('@deepseek-ai/dsh-llm');
+
+const ctx = new Context();
+const fibers = [];
+for (const [plugin, config] of [
+  [SessionStore],
+  [SessionProjectionRegistry],
+  [SessionTitleService, { fallbackMaxWords: 10, fallbackMaxBytes: 60, maxTitleBytes: 60 }],
+]) {
+  const fiber = ctx.plugin(plugin, config);
+  fibers.push(fiber);
+  await fiber.await();
+}
+// Use the complete Host activation path: Cordis treats returned controller
+// objects as invalid effects and disposes their listeners after startup.
+for (const [name, value] of Object.entries({
+  connection: { rpc: { handle: () => () => {} } }, credentials: {},
+  typertGateway: { stream() {} }, sessionController: {}, workspaceController: {},
+})) ctx.provide(name, value);
+const internals = Object.fromEntries(
+  ['Feishu', 'Weixin', 'Dingtalk', 'Wecom', 'Qq', 'Slack', 'Telegram', 'Discord', 'Whatsapp', 'Office']
+    .map((channel) => [`apply${channel}`, async () => {}]),
+);
+Object.assign(internals, {
+  installUpdateRpc: () => {}, installInboundTtlRpc: () => {},
+  installDeliveryRpc: () => {}, installSessionSyncCoordinator: () => {},
+});
+const host = ctx.plugin(createImHostPlugin(internals));
+fibers.push(host);
+await host.await();
+const settle = async () => {
+  await new Promise((done) => setTimeout(done, 0));
+};
+await settle();
+const prompt = (session, text, channel = 'weixin') => session.append('user/message', createUserMessage({
+  content: [{ type: 'text', text }],
+  source: { kind: 'user', rpcId: `${channel}-00000000-0000-4000-8000-000000000000` },
+}), { surfaceOp: 'append' });
+const request = (session) => session.append('request/header', {
+  header: { config: { provider: 'test-provider', model: 'test-model' } }, reason: 'change',
+});
+let calls = 0;
+let release;
+let aborted = false;
+ctx.sessionTitle.register({
+  id: SessionTitleProviderId('test-title-provider'),
+  automatic,
+  async generate(input) {
+    calls += 1;
+    input.signal.addEventListener('abort', () => { aborted = true; });
+    if (calls === 1) await new Promise((done) => { release = done; });
+    return { title: `自动标题 ${calls}`, messageSeqs: input.messages.map((message) => message.seq) };
+  },
+});
+const session = ctx.sessions.create(SessionId('ordinary-host-generated-id'));
+session.append('turn/start', { turn: 1 });
+prompt(session, '第一次消息');
+request(session);
+await settle();
+assert.equal(ctx.sessionTitle.get(session).title, '微信 · 第一次消息');
+assert.equal(ctx.sessionTitle.get(session).source.kind, 'fallback');
+assert.equal(calls, 1);
+assert.equal(aborted, false, 'adding the fallback prefix must not abort the active title provider');
+release();
+await settle();
+assert.equal(ctx.sessionTitle.get(session).title, '微信 · 自动标题 1');
+assert.equal(ctx.sessionTitle.get(session).source.kind, 'provider');
+assert.equal(ctx.sessionTitle.get(session).source.provider, 'test-title-provider');
+
+prompt(session, '第二次消息');
+request(session);
+await settle();
+const automaticCalls = automatic === 'all-prompts' ? 2 : 1;
+assert.equal(calls, automaticCalls, 'the original automatic generation cadence must be preserved');
+assert.equal(ctx.sessionTitle.get(session).title, `微信 · 自动标题 ${automaticCalls}`);
+assert.equal(ctx.sessionProjections.stateOf(session, 'title'), `微信 · 自动标题 ${automaticCalls}`);
+assert.equal(aborted, false);
+
+ctx.sessionTitle.rename(session, '自定义标题');
+await settle();
+assert.equal(ctx.sessionTitle.get(session).title, '微信 · 自定义标题');
+assert.equal(ctx.sessionTitle.get(session).source.kind, 'user');
+prompt(session, '手动命名后的消息');
+request(session);
+await settle();
+assert.equal(calls, automaticCalls, 'a real user rename must retain the normal pin');
+await ctx.sessionTitle.refresh(session);
+await settle();
+assert.equal(calls, automaticCalls + 1);
+assert.equal(ctx.sessionTitle.get(session).title, `微信 · 自动标题 ${automaticCalls + 1}`);
+assert.equal(ctx.sessionTitle.get(session).source.kind, 'provider');
+
+const ordinary = ctx.sessions.create(SessionId('web-created'));
+ordinary.append('turn/start', { turn: 1 });
+prompt(ordinary, '网页消息', 'web');
+await settle();
+assert.equal(ctx.sessionTitle.get(ordinary).title, '网页消息');
+
+// The production Feishu path can create its initial title before the first
+// prompt. The listener must still be alive after the Host has finished loading.
+let feishu;
+const creator = ctx.plugin({
+  name: 'feishu-session-regression', inject: ['sessions'],
+  apply(scoped) {
+    feishu = scoped.sessions.create(SessionId('feishu-host-generated-id'));
+    feishu.append('session/title', {
+      title: '你好，你是谁？', messageSeqs: [], source: { kind: 'user' },
+    });
+    prompt(feishu, '你好，你是谁？', 'feishu');
+  },
+});
+fibers.push(creator);
+await creator.await();
+await settle();
+assert.equal(ctx.sessionTitle.get(feishu).title, '飞书 · 你好，你是谁？');
+assert.equal(ctx.sessionTitle.get(feishu).source.kind, 'user');
+
+const sourceEvents = session.snapshotEvents();
+for (const event of sourceEvents.filter((entry) => entry.type === 'session/title')) {
+  assert.equal(event.data.messageSeqs.length === 0, event.data.source.kind === 'user');
+  for (const seq of event.data.messageSeqs) {
+    assert.equal(sourceEvents[seq].type, 'user/message');
+    assert.equal(sourceEvents[seq].data.source.kind, 'user');
+    assert.ok(seq < event.seq);
+  }
+  assert.ok(!event.data.title.includes('微信 · 微信 · '));
+}
+for (const fiber of fibers.reverse()) await fiber.dispose();
+console.log(`Session channel prefix verified against ${root} (${automatic}): active generation, later generation, projections, manual rename, refresh, Web sessions, and title-source invariants passed.`);