@yeaft/webchat-agent 0.1.751 → 0.1.753

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeaft/webchat-agent",
-  "version": "0.1.751",
+  "version": "0.1.753",
   "description": "Remote agent for Yeaft WebChat — connects worker machines to the central server",
   "main": "index.js",
   "type": "module",

package/unify/compact/compactor.js

@@ -62,12 +62,17 @@ export class Compactor {
    *        treats that as a soft failure).
    * @param {() => number|undefined} [opts.getMaxContextTokens]
    *        Returns `config.maxContextTokens` for `shouldCompactHistory`.
+   * @param {() => string|undefined} [opts.getLanguage]
+   *        Returns the live `config.language`. Threaded into
+   *        `compactHistory` so the compactor's summary prompt + the
+   *        "session continued" wrapper render in the user's preferred
+   *        locale instead of always English.
    * @param {(groupId: string, result: CompactedResult) => void} [opts.onCompacted]
    *        Optional sink. Bridge wires this to send the
    *        `unify_history_compacted` WS event. Default: no-op. Can be
    *        replaced post-construction via `setOnCompacted`.
    */
-  constructor({ summarize, getMaxContextTokens, onCompacted } = {}) {
+  constructor({ summarize, getMaxContextTokens, getLanguage, onCompacted } = {}) {
     if (typeof summarize !== 'function') {
       throw new TypeError('Compactor: summarize is required');
     }
@@ -75,6 +80,9 @@ export class Compactor {
     this._getMaxContextTokens = typeof getMaxContextTokens === 'function'
       ? getMaxContextTokens
       : () => undefined;
+    this._getLanguage = typeof getLanguage === 'function'
+      ? getLanguage
+      : () => undefined;
     this._onCompacted = typeof onCompacted === 'function' ? onCompacted : () => {};
     /** @type {Map<string, { inFlight: Promise<void>|null, pending: boolean }>} */
     this._states = new Map();
@@ -186,7 +194,11 @@ export class Compactor {
       const summarize = ({ system, prompt }) =>
         this._summarize({ system, prompt, maxTokens: SUMMARIZER_MAX_TOKENS });
 
-      const result = await compactHistory(snapshot, { summarize, maxContextTokens });
+      const result = await compactHistory(snapshot, {
+        summarize,
+        maxContextTokens,
+        language: this._getLanguage(),
+      });
       if (!result || !result.compacted) {
         if (result && result.error) {
           console.warn(

package/unify/dream-v2/apply.js

@@ -28,7 +28,11 @@ import { snapshotScope } from './snapshot.js';
 import { parseJsonSafe } from './triage.js';
 import { render } from './prompts/index.js';
 
-const SYSTEM = `You are the Apply stage of a dream pipeline. You rewrite a single scope's memory.md and summary.md based on recent group conversations. Reply with strict JSON only — no prose, no fences.`;
+function applySystem(language) {
+  return String(language || '').toLowerCase().startsWith('zh')
+    ? '你是梦境流水线的 Apply 阶段。你会根据最近的群组对话重写单个 scope 的 memory.md 和 summary.md。请只回复严格 JSON，不要输出说明文字或 markdown fence。memory_md 和 summary_md 的自然语言内容必须使用中文；JSON key、scope、schema 字段和代码标识符保持英文。'
+    : 'You are the Apply stage of a dream pipeline. You rewrite a single scope\'s memory.md and summary.md based on recent group conversations. Reply with strict JSON only — no prose, no fences.';
+}
 
 /**
  * Build the UPDATE prompt body. Accepts the current scope state +
@@ -44,16 +48,18 @@ const SYSTEM = `You are the Apply stage of a dream pipeline. You rewrite a singl
  */
 export function buildUpdatePrompt(ctx) {
   const batchHeader = (ctx.batchInfo && ctx.batchInfo.total > 1)
-    ? `This is batch ${ctx.batchInfo.index} of ${ctx.batchInfo.total}.\nEarlier batches have already been folded into the current memory.md below.\n`
+    ? (String(ctx.language || '').toLowerCase().startsWith('zh')
+      ? `这是第 ${ctx.batchInfo.index}/${ctx.batchInfo.total} 批。前面的批次已经合并进下面当前的 memory.md。\n`
+      : `This is batch ${ctx.batchInfo.index} of ${ctx.batchInfo.total}.\nEarlier batches have already been folded into the current memory.md below.\n`)
     : '';
-  const sources = renderSourceBlocks(ctx.sources);
+  const sources = renderSourceBlocks(ctx.sources, ctx.language);
   return render('update', {
     target: ctx.target,
     batchHeader,
     memoryMd: ctx.memoryMd || '',
     summaryMd: ctx.summaryMd || '',
     sources,
-  });
+  }, { language: ctx.language });
 }
 
 /**
@@ -67,10 +73,10 @@ export function buildUpdatePrompt(ctx) {
  * }} ctx
  */
 export function buildCreatePrompt(ctx) {
-  const sources = renderSourceBlocks(ctx.sources);
+  const sources = renderSourceBlocks(ctx.sources, ctx.language);
   let siblingsBlock = '';
   if (ctx.siblingTopics && ctx.siblingTopics.length > 0) {
-    const lines = ['For tone reference, sibling/parent topic summaries:'];
+    const lines = [String(ctx.language || '').toLowerCase().startsWith('zh') ? '语气参考：同级/父级 topic 摘要：' : 'For tone reference, sibling/parent topic summaries:'];
     for (const t of ctx.siblingTopics) lines.push(`  - ${t.path}: ${oneLine(t.summary)}`);
     lines.push('');
     siblingsBlock = lines.join('\n');
@@ -79,7 +85,7 @@ export function buildCreatePrompt(ctx) {
     target: ctx.target,
     sources,
     siblingsBlock,
-  });
+  }, { language: ctx.language });
 }
 
 /**
@@ -89,13 +95,13 @@ export function buildCreatePrompt(ctx) {
  *
  * @param {Array<{ groupId: string, diff: Array<object> }>} sources
  */
-function renderSourceBlocks(sources) {
+function renderSourceBlocks(sources, language) {
   const out = [];
   for (const src of (sources || [])) {
     out.push('');
     out.push(`[group/${src.groupId}]`);
     for (const m of (src.diff || [])) {
-      const head = `[${m.role || 'message'}${m.kind === 'overlap' ? ' (already processed)' : ''}]`;
+      const head = `[${m.role || 'message'}${m.kind === 'overlap' ? (String(language || '').toLowerCase().startsWith('zh') ? '（已处理）' : ' (already processed)') : ''}]`;
       out.push(head);
       out.push(truncateMessage(m.body || ''));
     }
@@ -174,9 +180,10 @@ export async function applyMergedTarget(merged, opts) {
       target: merged.target,
       sources: merged.sources,
       siblingTopics: siblings,
+      language: opts.language,
     });
     if (opts.onProgress) opts.onProgress({ phase: 'apply', target: merged.target, status: 'llm', batch: 1, of: 1 });
-    const raw = await opts.llm({ pass: 'create', prompt, system: SYSTEM });
+    const raw = await opts.llm({ pass: 'create', prompt, system: applySystem(opts.language) });
     const parsed = parseJsonSafe(raw);
     if (!parsed || typeof parsed.memory_md !== 'string') {
       throw new Error(`apply: CREATE returned malformed JSON for ${merged.target}`);
@@ -202,9 +209,10 @@ export async function applyMergedTarget(merged, opts) {
         summaryMd,
         sources: batch,
         batchInfo: { index: i, total: batches.length },
+        language: opts.language,
       });
       if (opts.onProgress) opts.onProgress({ phase: 'apply', target: merged.target, status: 'llm', batch: i, of: batches.length });
-      const raw = await opts.llm({ pass: 'update', prompt, system: SYSTEM });
+      const raw = await opts.llm({ pass: 'update', prompt, system: applySystem(opts.language) });
       const parsed = parseJsonSafe(raw);
       if (!parsed || typeof parsed.memory_md !== 'string') {
         throw new Error(`apply: UPDATE batch ${i} returned malformed JSON for ${merged.target}`);

package/unify/dream-v2/prompts/index.js

@@ -48,6 +48,16 @@ export function extractTemplateForScope(scope) {
 /** @type {Record<string, string>} */
 const cache = {};
 
+export function normalizePromptLanguage(language) {
+  return String(language || '').toLowerCase().startsWith('zh') ? 'zh' : 'en';
+}
+
+function languageDirective(language) {
+  return normalizePromptLanguage(language) === 'zh'
+    ? '语言要求：请用中文生成所有自然语言内容，尤其是 memory_md 和 summary_md；工具名、scope、JSON key、schema 字段、代码标识符和枚举值必须保持英文。严格按要求输出 JSON 时，不要翻译 JSON key。'
+    : 'Language requirement: write all natural-language memory content in English. Keep tool names, scopes, JSON keys, schema fields, code identifiers, and enum values in English. When strict JSON is required, do not rename JSON keys.';
+}
+
 function load(name) {
   if (cache[name]) return cache[name];
   const file = FILES[name];
@@ -63,13 +73,17 @@ function load(name) {
  *
  * @param {string} name
  * @param {Record<string, string>} vars
+ * @param {{ language?: string, includeLanguageDirective?: boolean }} [opts]
  */
-export function render(name, vars) {
+export function render(name, vars, opts = {}) {
   const tpl = load(name);
-  return tpl.replace(/\{\{(\w+)\}\}/g, (_m, key) => {
+  const body = tpl.replace(/\{\{(\w+)\}\}/g, (_m, key) => {
     if (!(key in vars)) throw new Error(`prompts.${name}: missing var ${key}`);
     return vars[key];
   });
+  if (opts.includeLanguageDirective === false) return body;
+  if (!opts.language) return body;
+  return `${languageDirective(opts.language)}\n\n${body}`;
 }
 
 /** Test-only: drop the in-memory cache so a fresh read re-loads from disk. */

package/unify/dream-v2/runner.js

@@ -143,6 +143,7 @@ export async function runDream(opts) {
         topicSummaries,
         llm: opts.llm,
         onProgress,
+        language: opts.language,
       });
     } catch (err) {
       groupsReport.push({ groupId, new: newCount, status: 'error', error: err.message });
@@ -178,6 +179,7 @@ export async function runDream(opts) {
         nowIso: opts.nowIso || (() => nowIso),
         onProgress,
         siblingTopicsFor: opts.siblingTopicsFor,
+        language: opts.language,
       });
       targetsReport.push({ ...r, sources: merged.sources.length, status: 'done' });
     } catch (err) {

package/unify/dream-v2/session-wiring.js

@@ -31,6 +31,7 @@ export function buildRunDreamOpts(session, onProgress) {
 
   return {
     root: memoryRoot,
+    language: session.config?.language || 'en',
     llm: makeLlm(session),
     listGroups: async () => {
       try { return listGroups(groupsRoot).map(g => g.id); }
@@ -110,7 +111,9 @@ function makeLlm(session) {
     }
     const r = await adapter.call({
       model,
-      system: system || `You are the dream pipeline — pass: ${pass}.`,
+      system: system || (String(session.config?.language || '').toLowerCase().startsWith('zh')
+        ? `你是梦境流水线 — pass: ${pass}。请用中文生成自然语言内容；JSON key 保持英文。`
+        : `You are the dream pipeline — pass: ${pass}.`),
       messages: [{ role: 'user', content: prompt }],
       maxTokens: 2048,
     });

package/unify/dream-v2/triage.js

@@ -39,7 +39,11 @@ import { isValidTopic } from '../memory/store-v2.js';
 import { truncateMessage } from './segment.js';
 import { render } from './prompts/index.js';
 
-const SYSTEM = `You are the Triage stage of a dream pipeline that decides which scopes a recent group conversation should affect. Reply with strict JSON only — no prose, no markdown fences.`;
+function triageSystem(language) {
+  return String(language || '').toLowerCase().startsWith('zh')
+    ? '你是梦境流水线的 Triage 阶段，负责判断最近的群组对话会影响哪些 scope。请只回复严格 JSON，不要输出说明文字或 markdown fence。自然语言内容使用中文；JSON key、scope 和枚举值保持英文。'
+    : 'You are the Triage stage of a dream pipeline that decides which scopes a recent group conversation should affect. Reply with strict JSON only — no prose, no markdown fences.';
+}
 
 /**
  * Hard rules: deterministically derive must-include scopes from the
@@ -89,11 +93,11 @@ export function applyHardRules({ groupId, messages }) {
  */
 export function buildPass1Prompt(ctx) {
   const topicSummaries = (!ctx.topicSummaries || ctx.topicSummaries.length === 0)
-    ? '  (none)'
+    ? (String(ctx.language || '').toLowerCase().startsWith('zh') ? '  （无）' : '  (none)')
     : ctx.topicSummaries.map(t => `  - ${t.path} — ${oneLine(t.summary)}`).join('\n');
   const conv = [];
   for (const m of (ctx.messages || [])) {
-    const head = `[${m.role || 'message'}${m.kind === 'overlap' ? ' (already processed)' : ''}]`;
+    const head = `[${m.role || 'message'}${m.kind === 'overlap' ? (String(ctx.language || '').toLowerCase().startsWith('zh') ? '（已处理）' : ' (already processed)') : ''}]`;
     conv.push(head);
     conv.push(truncateMessage(m.body || ''));
     conv.push('');
@@ -102,7 +106,7 @@ export function buildPass1Prompt(ctx) {
     groupId: ctx.groupId,
     topicSummaries,
     conversation: conv.join('\n').trimEnd(),
-  });
+  }, { language: ctx.language });
 }
 
 /**
@@ -112,12 +116,12 @@ export function buildPass1Prompt(ctx) {
  */
 export function buildPass2Prompt(ctx) {
   const existingTopics = (!ctx.existingTopics || ctx.existingTopics.length === 0)
-    ? '  (none)'
+    ? (String(ctx.language || '').toLowerCase().startsWith('zh') ? '  （无）' : '  (none)')
     : ctx.existingTopics.map(t => `  - ${t.path} — ${oneLine(t.summary)}`).join('\n');
   return render('triagePass2', {
     description: ctx.description,
     existingTopics,
-  });
+  }, { language: ctx.language });
 }
 
 /**
@@ -131,10 +135,10 @@ export function buildPass2Prompt(ctx) {
  * }} args
  * @returns {Promise<Array<{ kind: 'update'|'create', scope: string }>>}
  */
-export async function classifySoft({ groupId, messages, topicSummaries, llm }) {
+export async function classifySoft({ groupId, messages, topicSummaries, llm, language }) {
   if (!llm) throw new Error('triage.classifySoft: llm callable required');
-  const pass1Prompt = buildPass1Prompt({ groupId, messages, topicSummaries });
-  const pass1Raw = await llm({ pass: 'triage-pass1', prompt: pass1Prompt, system: SYSTEM });
+  const pass1Prompt = buildPass1Prompt({ groupId, messages, topicSummaries, language });
+  const pass1Raw = await llm({ pass: 'triage-pass1', prompt: pass1Prompt, system: triageSystem(language) });
   const pass1 = parseJsonSafe(pass1Raw);
   const out = [];
 
@@ -151,8 +155,9 @@ export async function classifySoft({ groupId, messages, topicSummaries, llm }) {
     const pass2Prompt = buildPass2Prompt({
       description: description.trim(),
       existingTopics: topicSummaries || [],
+      language,
     });
-    const pass2Raw = await llm({ pass: 'triage-pass2', prompt: pass2Prompt, system: SYSTEM });
+    const pass2Raw = await llm({ pass: 'triage-pass2', prompt: pass2Prompt, system: triageSystem(language) });
     const pass2 = parseJsonSafe(pass2Raw);
     if (!pass2 || !pass2.decision) continue;
     if (pass2.decision === 'none') continue;
@@ -201,7 +206,7 @@ export async function triageOneSegment(args) {
  * }} args
  * @returns {Promise<Array<{ kind: 'update'|'create', scope: string }>>}
  */
-export async function triageGroupSegments({ groupId, segments, topicSummaries, llm, onProgress }) {
+export async function triageGroupSegments({ groupId, segments, topicSummaries, llm, onProgress, language }) {
   let acc = [];
   let i = 0;
   for (const seg of (segments || [])) {
@@ -212,6 +217,7 @@ export async function triageGroupSegments({ groupId, segments, topicSummaries, l
       messages: seg.messages,
       topicSummaries,
       llm,
+      language,
     });
     acc = dedupeActions([...acc, ...segActions]);
   }

package/unify/engine.js

@@ -464,7 +464,7 @@ export class Engine {
    */
   #getToolDefs() {
     if (this.#toolRegistry) {
-      return this.#toolRegistry.getToolDefs();
+      return this.#toolRegistry.getToolDefs(this.#config?.language || 'en');
     }
     // Legacy path: no mode filtering
     const defs = [];
@@ -645,7 +645,9 @@ export class Engine {
         runLLM: async (prompt) => {
           const out = await this.#adapter.call({
             model: this.#fastConfig.model,
-            system: 'You are a memory-management subroutine. Reply with a single JSON object as instructed.',
+            system: (String(this.#config?.language || '').toLowerCase().startsWith('zh')
+          ? '你是记忆管理子程序。请按要求只回复一个 JSON 对象，不要输出额外说明。'
+          : 'You are a memory-management subroutine. Reply with a single JSON object as instructed.'),
             messages: [{ role: 'user', content: prompt }],
             maxTokens: 1024,
           });
@@ -973,13 +975,23 @@ export class Engine {
 
     const archiveIds = [];
 
+    // Language-aware summarizer prompts. The orchestrator-track summary
+    // ends up in the system prompt as a "previous conversation summary"
+    // block, so it needs to match the user's preferred language to avoid
+    // a jarring locale flip mid-context.
+    const isZh = String(this.#config.language || '').toLowerCase().startsWith('zh');
+    const summariserSystem = isZh
+      ? '你是对话摘要器。请用中文写出 2–3 段简明摘要，保留决策、事实与上下文。'
+      : 'You are a conversation summarizer. Summarize concisely in 2–3 paragraphs, preserving decisions, facts, and context.';
+    const summariserPromptPrefix = isZh ? '请概括：\n\n' : 'Summarize:\n\n';
+
     const hooks = {
       summarise: async () => {
         try {
           const result = await adapter.call({
             model: fastConfig.model,
-            system: 'You are a conversation summarizer. Summarize concisely in 2–3 paragraphs, preserving decisions, facts, and context.',
-            messages: [{ role: 'user', content: `Summarize:\n\n${toArchive.map(m => `[${m.role}] ${(m.content || '').slice(0, 500)}`).join('\n\n')}` }],
+            system: summariserSystem,
+            messages: [{ role: 'user', content: `${summariserPromptPrefix}${toArchive.map(m => `[${m.role}] ${(m.content || '').slice(0, 500)}`).join('\n\n')}` }],
             maxTokens: 1024,
           });
           return (result.text || '').trim();

package/unify/history-compact.js

@@ -328,16 +328,22 @@ export function findCutIndex(messages, keepRecent) {
  * `server/db/message-db.js`) recognise it.
  *
  * @param {string} summary
+ * @param {{ language?: string }} [opts]
  * @returns {{role:'user', content:string, _compactSummary: true}}
  */
-export function wrapSummaryAsUserMessage(summary) {
+export function wrapSummaryAsUserMessage(summary, opts = {}) {
   const body = (summary || '').trim() || '(no summary produced)';
-  const content =
-    'This session is being continued from a previous conversation. ' +
-    'The earlier context has been summarized for efficiency.\n\n' +
-    'Summary of conversation so far:\n' +
-    body +
-    '\n\nContinue the conversation from where it left off without asking the user any further questions.';
+  const isZh = String(opts.language || '').toLowerCase().startsWith('zh');
+  const content = isZh
+    ? '本会话延续自之前的对话。早期上下文已经被概括以节省空间。\n\n' +
+      '至此为止的对话摘要：\n' +
+      body +
+      '\n\n请从中断处继续对话，不要再向用户重复确认。'
+    : 'This session is being continued from a previous conversation. ' +
+      'The earlier context has been summarized for efficiency.\n\n' +
+      'Summary of conversation so far:\n' +
+      body +
+      '\n\nContinue the conversation from where it left off without asking the user any further questions.';
   return {
     role: 'user',
     content,
@@ -349,24 +355,36 @@ export function wrapSummaryAsUserMessage(summary) {
  * Build the prompt fed to the fast-model summarizer. Kept in code (not in
  * a template file) because it's small and lives alongside the call site.
  *
+ * The summarizer prompt itself is language-aware: callers pass the live
+ * `config.language` so the produced summary is written in the user's
+ * preferred language. JSON-style structural cues stay English so the
+ * summary remains easy to splice into the next turn regardless of locale.
+ *
  * @param {Array<{role:string, content:string}>} cleanedMessages
+ * @param {{ language?: string }} [opts]
  * @returns {{system: string, prompt: string}}
  */
-export function buildSummaryPrompt(cleanedMessages) {
+export function buildSummaryPrompt(cleanedMessages, opts = {}) {
   const transcript = cleanedMessages
     .map(m => `[${m.role}]\n${m.content}`)
     .join('\n\n---\n\n');
-  const system =
-    'You are a conversation summarizer for a multi-agent group chat. ' +
-    'Produce a concise (4–8 short bullet points) summary of the conversation ' +
-    'so far. Preserve: (1) decisions made, (2) facts learned, (3) the user\'s ' +
-    'current goal, (4) any open questions or pending actions, (5) which VPs ' +
-    'are participating and what each contributed. Do NOT include raw tool ' +
-    'output. Do NOT speculate. Be specific.';
-  const prompt =
-    'Summarize the following conversation. Output ONLY the summary, no ' +
-    'preamble.\n\n' +
-    transcript;
+  const isZh = String(opts.language || '').toLowerCase().startsWith('zh');
+  const system = isZh
+    ? '你是多 agent 群聊的对话摘要器。请用中文写出 4–8 条简明 bullet 摘要。' +
+      '保留：(1) 已做的决策，(2) 已学到的事实，(3) 用户当前目标，' +
+      '(4) 任何未解决的问题或待办事项，(5) 哪些 VP 参与了对话以及各自贡献。' +
+      '不要包含原始工具输出。不要臆测。要具体。'
+    : 'You are a conversation summarizer for a multi-agent group chat. ' +
+      'Produce a concise (4–8 short bullet points) summary of the conversation ' +
+      'so far. Preserve: (1) decisions made, (2) facts learned, (3) the user\'s ' +
+      'current goal, (4) any open questions or pending actions, (5) which VPs ' +
+      'are participating and what each contributed. Do NOT include raw tool ' +
+      'output. Do NOT speculate. Be specific.';
+  const prompt = isZh
+    ? '请概括下面的对话。只输出摘要正文，不要前言。\n\n' + transcript
+    : 'Summarize the following conversation. Output ONLY the summary, no ' +
+      'preamble.\n\n' +
+      transcript;
   return { system, prompt };
 }
 
@@ -384,6 +402,7 @@ export function buildSummaryPrompt(cleanedMessages) {
  *   maxContextTokens?: number,
  *   tokenFraction?: number,
  *   hardTokenCeiling?: number,
+ *   language?: string,
  * }} options
  * @returns {Promise<{
  *   messages: Array<object>,
@@ -407,6 +426,7 @@ export async function compactHistory(messages, options) {
     maxContextTokens,
     tokenFraction,
     hardTokenCeiling,
+    language,
   } = options || {};
 
   if (typeof summarize !== 'function') {
@@ -460,7 +480,7 @@ export async function compactHistory(messages, options) {
 
   let summaryText = '';
   if (cleaned.length > 0) {
-    const { system, prompt } = buildSummaryPrompt(cleaned);
+    const { system, prompt } = buildSummaryPrompt(cleaned, { language });
     try {
       summaryText = (await summarize({ system, prompt })) || '';
     } catch (err) {
@@ -498,7 +518,7 @@ export async function compactHistory(messages, options) {
     }
   }
 
-  const summaryMsg = wrapSummaryAsUserMessage(summaryText);
+  const summaryMsg = wrapSummaryAsUserMessage(summaryText, { language });
 
   // Defensive pair-sanitize: the cut at `cutIdx` lands at a user-message
   // boundary so an `[assistant(toolCalls), tool…]` arc is not split, but

package/unify/prompts.js

@@ -178,6 +178,7 @@ const PROMPTS = {
       `💡 ${min}min since last summary (+${count} new messages). Consider calling \`task_summary_post\`.`,
     // DESIGN-PROMPT §3 ④ — Active Scope header
     activeScopeHeader: '## active_scope',
+    groupAnnouncementHeader: '[Group Announcement]',
     vpPersonaIntro: (name, role) =>
       `You ARE **${name}**${role ? ` (${role})` : ''}. Speak in the first person as ${name}; do not refer to yourself as "Yeaft" or as a generic AI assistant. The text below is your identity, expertise, and decision style.`,
   },
@@ -193,6 +194,7 @@ const PROMPTS = {
       `💡 距上次 summary 已过 ${min}min，新增 ${count} 条消息，建议调用 \`task_summary_post\`。`,
     // DESIGN-PROMPT §3 ④ — Active Scope header
     activeScopeHeader: '## active_scope',
+    groupAnnouncementHeader: '[群组公告]',
     vpPersonaIntro: (name, role) =>
       `你就是 **${name}**${role ? `（${role}）` : ''}。请以 ${name} 的第一人称发言；不要自称 "Yeaft" 或泛指的 AI 助手。下面的文字是你的身份、专业方向与判断风格。`,
   },
@@ -201,6 +203,28 @@ const PROMPTS = {
 /** Supported language codes. */
 export const SUPPORTED_LANGUAGES = Object.keys(PROMPTS);
 
+/**
+ * Return true for Chinese locales. Real app config persists values like
+ * `zh-CN`; prompt templates are keyed by the base language (`zh`).
+ *
+ * @param {string} language
+ * @returns {boolean}
+ */
+export function isZhLanguage(language) {
+  return String(language || '').toLowerCase().startsWith('zh');
+}
+
+/**
+ * Normalize app/user locale to the prompt dictionary key.
+ * Protocol identifiers stay English; this only selects visible prose.
+ *
+ * @param {string} language
+ * @returns {'en'|'zh'}
+ */
+export function normalizePromptLanguage(language) {
+  return isZhLanguage(language) ? 'zh' : 'en';
+}
+
 /**
  * Build the system prompt for a given language.
  *
@@ -267,9 +291,9 @@ export function buildSystemPrompt({
   vpPersona,
   groupAnnouncement = '',
 } = {}) {
-  // Fallback to English for unknown languages
-  const lang = PROMPTS[language] || PROMPTS.en;
-  const effectiveLang = PROMPTS[language] ? language : 'en';
+  // Normalize app locales like `zh-CN` to prompt dictionary/template keys.
+  const effectiveLang = normalizePromptLanguage(language);
+  const lang = PROMPTS[effectiveLang] || PROMPTS.en;
 
   const parts = [];
 
@@ -299,7 +323,7 @@ export function buildSystemPrompt({
   // instructions. Empty/whitespace = no block emitted.
   const annText = (typeof groupAnnouncement === 'string') ? groupAnnouncement.trim() : '';
   if (annText) {
-    parts.push(`[Group Announcement]\n${annText}`);
+    parts.push(`${lang.groupAnnouncementHeader || '[Group Announcement]'}\n${annText}`);
   }
 
   // ─── 2. Date Metadata ──────────────────────────────────
@@ -674,7 +698,8 @@ const LAYER_A_HEADERS = {
  */
 export function renderLayerASummaries(summaries, language = 'en') {
   if (!summaries || typeof summaries !== 'object') return '';
-  const headers = LAYER_A_HEADERS[language] || LAYER_A_HEADERS.en;
+  const effectiveLang = normalizePromptLanguage(language);
+  const headers = LAYER_A_HEADERS[effectiveLang] || LAYER_A_HEADERS.en;
   const out = [];
   for (const key of ['user', 'group', 'vp']) {
     const body = typeof summaries[key] === 'string' ? summaries[key].trim() : '';
@@ -712,17 +737,18 @@ export function buildWorkerPrompt(params = {}) {
     includeShape = true,
     ...rest
   } = params;
+  const effectiveLang = normalizePromptLanguage(language);
 
   const parts = [];
 
   // Optional harness — describes the layered shape.
   if (includeShape) {
-    const shape = getTemplate('harnessWorkerShape', language);
+    const shape = getTemplate('harnessWorkerShape', effectiveLang);
     if (shape) parts.push(shape);
   }
 
   // Identity + Rules + Memory + Active Scope (DESIGN-PROMPT §3).
-  const baseBlock = buildSystemPrompt({ ...rest, language });
+  const baseBlock = buildSystemPrompt({ ...rest, language: effectiveLang });
   if (baseBlock) parts.push(baseBlock);
 
   return parts.join('\n\n');
@@ -739,7 +765,8 @@ export function buildWorkerPrompt(params = {}) {
  */
 export function renderPriorPlan(priorPlan, language = 'en') {
   if (!priorPlan || typeof priorPlan !== 'object') return '';
-  const header = language === 'zh' ? '## 上一轮 plan' : '## prior_plan';
+  const effectiveLang = normalizePromptLanguage(language);
+  const header = effectiveLang === 'zh' ? '## 上一轮 plan' : '## prior_plan';
   const lines = [];
   if (priorPlan.vpId) lines.push(`vpId: ${priorPlan.vpId}`);
   const fq = priorPlan.forwardQuery;
@@ -780,17 +807,18 @@ export function renderPriorPlan(priorPlan, language = 'en') {
  */
 export function buildRouterPrompt(params = {}) {
   const { language = 'en', summaries, routerContext, priorPlan, includeShape = true } = params;
+  const effectiveLang = normalizePromptLanguage(language);
   const parts = [];
 
   if (includeShape) {
-    const shape = getTemplate('harnessRouterShape', language);
+    const shape = getTemplate('harnessRouterShape', effectiveLang);
     if (shape) parts.push(shape);
   }
 
-  const summaryBlock = renderLayerASummaries(summaries, language);
+  const summaryBlock = renderLayerASummaries(summaries, effectiveLang);
   if (summaryBlock) parts.push(summaryBlock);
 
-  const priorBlock = renderPriorPlan(priorPlan, language);
+  const priorBlock = renderPriorPlan(priorPlan, effectiveLang);
   if (priorBlock) parts.push(priorBlock);
 
   if (typeof routerContext === 'string' && routerContext.trim()) {

package/unify/session.js

@@ -315,6 +315,13 @@ export async function loadSession(options = {}) {
       engine.summarizeForCompact({ system, prompt, maxTokens }),
     getMaxContextTokens: () =>
       typeof config.maxContextTokens === 'number' ? config.maxContextTokens : undefined,
+    // Live-read: `config.language` is mutated in place by
+    // `engine.setLanguage()` (which broadcastLanguageChange fans out to
+    // every per-VP engine). The compactor must see the post-broadcast
+    // value, not a boot-time snapshot, so the summary prompt + the
+    // "session continued" wrapper render in the user's current locale.
+    getLanguage: () =>
+      typeof config.language === 'string' ? config.language : undefined,
   });
 
   // ─── 9a. Create dream scheduler ────────────

package/unify/tools/registry.js

@@ -41,6 +41,69 @@ import { DEFAULT_CONTEXT_WINDOW } from '../models.js';
 const TOOL_RESULT_CAP_RATIO = 0.10;
 const TOOL_RESULT_MIN_CAP = 8 * 1024;
 
+function normalizeLanguage(language) {
+  return String(language || '').toLowerCase().startsWith('zh') ? 'zh' : 'en';
+}
+
+function localizeVisibleText(value, language, toolName) {
+  const lang = normalizeLanguage(language);
+  if (typeof value === 'function') return localizeVisibleText(value(lang), lang, toolName);
+  if (value && typeof value === 'object') {
+    const picked = value[lang] || value[lang === 'zh' ? 'zh-CN' : 'en-US'] || value.en || value.default;
+    if (typeof picked === 'string') return picked;
+  }
+  const text = typeof value === 'string' ? value : String(value || '');
+  if (lang !== 'zh') return text;
+  if (!text.trim()) return text;
+  return [
+    `工具说明：${toolName || '该工具'}。请严格按照 schema 调用；工具名、参数名、JSON key 和枚举值保持英文，不要翻译。`,
+    `原始协议说明（英文，供精确调用参考）：${text}`,
+  ].join('\n');
+}
+
+/**
+ * Walk a JSON Schema `parameters` object and localize the human-readable
+ * `description` strings to the requested language. All other schema bits
+ * (`type`, `enum`, `required`, `items`, nested `properties`, etc.) are
+ * preserved by value.
+ *
+ * Critical correctness rule: a JSON Schema can have a *property named*
+ * `description` whose value is itself a sub-schema (e.g.
+ * `properties: { description: { type: 'string', description: 'Detailed...' }}`).
+ * In that case the OUTER `description` key holds the sub-schema and must
+ * be recursed into; only the INNER `description: 'Detailed...'` value
+ * (which is a string) should be localized.
+ *
+ * Previous bug: this walker localized ANY value under a `description`
+ * key, including sub-schema objects. `localizeVisibleText` then ran
+ * `String(value)` on the object, producing the literal string
+ * `'[object Object]'`. GPT-5's strict schema validator rejected the
+ * resulting `{ description: '[object Object]' }` with
+ * `"'[object Object]' is not of type 'object', 'boolean'"`. This made
+ * FeatureCreate (and any tool whose schema contains a property named
+ * `description`) unusable in zh locale on strict providers.
+ *
+ * The fix: only treat a `description` value as localizable text when it
+ * is actually a string. Object/array values under a `description` key
+ * are sub-schemas and must be recursed into normally.
+ */
+function localizeParameters(parameters, language, toolName) {
+  const lang = normalizeLanguage(language);
+  if (lang !== 'zh' || !parameters || typeof parameters !== 'object') return parameters;
+  if (Array.isArray(parameters)) return parameters.map(v => localizeParameters(v, lang, toolName));
+  const out = {};
+  for (const [key, value] of Object.entries(parameters)) {
+    if (key === 'description' && typeof value === 'string') {
+      out[key] = localizeVisibleText(value, lang, toolName);
+    } else if (value && typeof value === 'object') {
+      out[key] = localizeParameters(value, lang, toolName);
+    } else {
+      out[key] = value;
+    }
+  }
+  return out;
+}
+
 /**
  * Per-tool execution timeout (ms).
  *
@@ -99,7 +162,7 @@ export class ToolExecutionTimeoutError extends Error {
  * @param {{ contextWindow?: number, toolName: string }} opts
  * @returns {string}
  */
-export function truncateToolResultIfNeeded(output, { contextWindow, toolName }) {
+export function truncateToolResultIfNeeded(output, { contextWindow, toolName, language } = {}) {
   let text;
   if (typeof output === 'string') {
     text = output;
@@ -116,7 +179,9 @@ export function truncateToolResultIfNeeded(output, { contextWindow, toolName })
   const cap = Math.max(TOOL_RESULT_MIN_CAP, Math.floor(ctx * TOOL_RESULT_CAP_RATIO));
   if (text.length <= cap) return text;
   const head = text.slice(0, cap);
-  const marker = `\n\n[truncated: ${toolName} returned ${formatSize(text.length)}, capped at ${formatSize(cap)}; the model will not see the rest of this output]`;
+  const marker = normalizeLanguage(language) === 'zh'
+    ? `\n\n[已截断：${toolName} 返回 ${formatSize(text.length)}，上限为 ${formatSize(cap)}；模型不会看到剩余内容]`
+    : `\n\n[truncated: ${toolName} returned ${formatSize(text.length)}, capped at ${formatSize(cap)}; the model will not see the rest of this output]`;
   return head + marker;
 }
 
@@ -213,13 +278,15 @@ export class ToolRegistry {
   /**
    * Get tool definitions for the LLM adapter.
    * Returns all registered tools — mode filtering was removed in task-297.
+   * @param {string} [language='en']
    * @returns {{ name: string, description: string, parameters: object }[]}
    */
-  getToolDefs() {
+  getToolDefs(language = 'en') {
+    const lang = normalizeLanguage(language);
     return this.getAllTools().map(t => ({
       name: t.name,
-      description: t.description,
-      parameters: t.parameters,
+      description: localizeVisibleText(t.description, lang, t.name),
+      parameters: localizeParameters(t.parameters, lang, t.name),
     }));
   }
 
@@ -264,6 +331,7 @@ export class ToolRegistry {
     return truncateToolResultIfNeeded(output, {
       contextWindow: ctx.contextWindow,
       toolName: name,
+      language: ctx.config?.language,
     });
   }