@yeaft/webchat-agent 0.1.751 → 0.1.752

package/package.json

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

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

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/tools/registry.js

@@ -41,6 +41,41 @@ 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');
+}
+
+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') {
+      out[key] = localizeVisibleText(value, lang, toolName);
+    } else {
+      out[key] = localizeParameters(value, lang, toolName);
+    }
+  }
+  return out;
+}
+
 /**
  * Per-tool execution timeout (ms).
  *
@@ -99,7 +134,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 +151,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 +250,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 +303,7 @@ export class ToolRegistry {
     return truncateToolResultIfNeeded(output, {
       contextWindow: ctx.contextWindow,
       toolName: name,
+      language: ctx.config?.language,
     });
   }