@nocobase/plugin-localization 2.1.0-beta.34 → 2.1.0-beta.35

package/dist/server/tasks/localization-ai-translate.js

@@ -32,16 +32,16 @@ __export(localization_ai_translate_exports, {
 module.exports = __toCommonJS(localization_ai_translate_exports);
 var import_plugin_async_task_manager = require("@nocobase/plugin-async-task-manager");
 var import_messages = require("@langchain/core/messages");
+var import_translation_scope = require("../translation-scope");
 const LOCALIZATION_AI_TRANSLATE_TASK_TYPE = "localization:ai-translate";
-const TRANSLATION_BATCH_SIZE = 10;
 const DEFAULT_TRANSLATION_WORKER_COUNT = 10;
 const MIN_TRANSLATION_WORKER_COUNT = 1;
 const MAX_TRANSLATION_WORKER_COUNT = 20;
-const MAX_TRANSLATION_QUEUE_SIZE = TRANSLATION_BATCH_SIZE * 2;
+const TRANSLATION_CHUNK_SIZE = 200;
 const elapsed = (start) => Date.now() - start;
-const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 const truncateForLog = (value, maxLength = 500) => value.length > maxLength ? `${value.slice(0, maxLength)}...` : value;
 const LEGACY_SYMBOL_TRANSLATIONS = /* @__PURE__ */ new Set(["<", "=", ">"]);
+const isString = (value) => typeof value === "string" && value.length > 0;
 const getTranslationWorkerCount = () => {
   const value = Number.parseInt(process.env.AI_LOCALIZATION_CONCURRENCY || "", 10);
   if (Number.isInteger(value) && value >= MIN_TRANSLATION_WORKER_COUNT && value <= MAX_TRANSLATION_WORKER_COUNT) {
@@ -74,11 +74,21 @@ class LocalizationAITranslateTask extends import_plugin_async_task_manager.TaskT
     const resolvedModel = await aiPlugin.aiEmployeesManager.resolveModel(employee, params.model);
     const { provider, model, service } = await aiPlugin.aiManager.getLLMService(resolvedModel);
     const defaultReferenceLocale = await this.getSystemDefaultLocale();
-    const builtInReferenceResources = await this.app.localeManager.getBuiltInResources("zh-CN");
     const builtInMatchResources = await this.app.localeManager.getBuiltInResources("en-US");
+    const referenceLocales = this.resolveReferenceLocales(params.referenceLocales, defaultReferenceLocale);
+    const findTextsOptions = await (0, import_translation_scope.buildFindTextsOptions)({
+      app: this.app,
+      mode: params.mode,
+      locale,
+      scope: params.scope || "all",
+      textIds: params.textIds,
+      fields: ["id", "text", "module"],
+      sort: ["id"]
+    });
     const workerCount = getTranslationWorkerCount();
+    const chunkSize = TRANSLATION_CHUNK_SIZE;
     const countStart = Date.now();
-    const total = await this.countTexts(params.mode, locale, params.textIds);
+    const total = await this.countTexts(findTextsOptions);
     (_a = this.logger) == null ? void 0 : _a.debug("Localization AI translation task started", {
       taskId: this.record.id,
       mode: params.mode,
@@ -86,96 +96,86 @@ class LocalizationAITranslateTask extends import_plugin_async_task_manager.TaskT
       total,
       countElapsedMs: elapsed(countStart),
       workerCount,
-      queueLimit: MAX_TRANSLATION_QUEUE_SIZE,
+      chunkSize,
       defaultReferenceLocale,
+      referenceLocales,
+      scope: params.scope || "all",
       provider: service == null ? void 0 : service.provider,
       llmService: service == null ? void 0 : service.name,
       model
     });
     let translated = 0;
     let chunkIndex = 0;
-    let producerDone = false;
-    let firstError;
-    const queue = [];
     this.reportProgress({ total, current: 0 });
-    const workers = Array.from(
-      { length: workerCount },
-      (_, workerIndex) => this.runTranslationWorker({
-        workerIndex: workerIndex + 1,
-        queue,
-        isDone: () => producerDone,
-        getError: () => firstError,
-        setError: (error) => {
-          firstError = firstError ?? error;
-        },
-        total,
-        getTranslated: () => translated,
-        incrementTranslated: () => {
-          translated += 1;
-          return translated;
-        },
-        locale,
-        employeeUsername,
-        employee,
-        provider,
-        service,
-        model
-      })
-    );
-    try {
-      await this.app.db.getRepository("localizationTexts").chunkWithCursor({
-        ...this.buildFindTextsOptions(params.mode, locale, params.textIds),
-        chunkSize: TRANSLATION_BATCH_SIZE,
-        beforeFind: async () => {
-          while (!firstError && queue.length >= MAX_TRANSLATION_QUEUE_SIZE) {
-            await sleep(100);
-          }
-          if (firstError) {
-            throw firstError;
+    const repository = this.app.db.getRepository("localizationTexts");
+    const chunk = params.mode === "selected" ? repository.chunk.bind(repository) : repository.chunkWithCursor.bind(repository);
+    await chunk({
+      ...findTextsOptions,
+      chunkSize,
+      callback: async (rows) => {
+        var _a2, _b2, _c;
+        chunkIndex += 1;
+        const chunkStart = Date.now();
+        const textRows = rows.map((row) => (0, import_translation_scope.normalizeTextRecord)(row)).filter(Boolean);
+        const rowsWithScope = textRows.map((row) => ({
+          row,
+          isBuiltIn: (0, import_translation_scope.isBuiltInText)(row, builtInMatchResources)
+        }));
+        (_a2 = this.logger) == null ? void 0 : _a2.debug("Localization AI translation chunk loaded", {
+          taskId: this.record.id,
+          chunkIndex,
+          rows: textRows.length,
+          workerCount,
+          translated,
+          total
+        });
+        for (let start = 0; start < rowsWithScope.length; start += workerCount) {
+          if (this.isCanceled) {
+            throw new import_plugin_async_task_manager.CancelError();
           }
-        },
-        callback: async (rows) => {
-          var _a2;
-          chunkIndex += 1;
-          const chunkStart = Date.now();
-          const textRows = rows.map((row) => this.normalizeTextRecord(row)).filter(Boolean);
-          const textIds = textRows.map((row) => row.id);
-          const englishReferences = await this.getLocaleReferences(textIds, "en-US");
-          const defaultLocaleReferences = defaultReferenceLocale === "en-US" ? englishReferences : await this.getLocaleReferences(textIds, defaultReferenceLocale);
-          const queueItems = textRows.map((row) => {
-            const isBuiltIn = this.isBuiltInText(row, builtInMatchResources);
-            return {
-              row,
-              chunkIndex,
-              englishReference: englishReferences.get(String(row.id)),
-              referenceTranslation: isBuiltIn ? this.getBuiltInReference(row, builtInReferenceResources) : defaultLocaleReferences.get(String(row.id)),
-              referenceLocale: isBuiltIn ? "zh-CN" : defaultReferenceLocale,
-              isBuiltIn
-            };
-          });
-          queue.push(...queueItems);
-          (_a2 = this.logger) == null ? void 0 : _a2.debug("Localization AI translation chunk enqueued", {
+          const batchStart = Date.now();
+          const batch = rowsWithScope.slice(start, start + workerCount);
+          const items = await this.buildTranslationItems(batch, referenceLocales, chunkIndex);
+          await Promise.all(
+            items.map(
+              (item, index) => this.translateItem({
+                workerIndex: index + 1,
+                item,
+                total,
+                getTranslated: () => translated,
+                incrementTranslated: () => {
+                  translated += 1;
+                  return translated;
+                },
+                locale,
+                employeeUsername,
+                employee,
+                provider,
+                service,
+                model
+              })
+            )
+          );
+          (_b2 = this.logger) == null ? void 0 : _b2.debug("Localization AI translation batch completed", {
             taskId: this.record.id,
             chunkIndex,
-            rows: textRows.length,
-            englishReferences: englishReferences.size,
-            referenceLocale: defaultReferenceLocale,
-            referenceTranslations: queueItems.filter((item) => item.referenceTranslation).length,
-            builtInReferences: queueItems.filter((item) => item.isBuiltIn && item.referenceTranslation).length,
-            queueSize: queue.length,
-            elapsedMs: elapsed(chunkStart),
+            batchSize: items.length,
+            referenceTranslations: items.filter((item) => item.referenceTranslation).length,
+            elapsedMs: elapsed(batchStart),
             translated,
             total
           });
         }
-      });
-    } finally {
-      producerDone = true;
-    }
-    await Promise.all(workers);
-    if (firstError) {
-      throw firstError;
-    }
+        (_c = this.logger) == null ? void 0 : _c.debug("Localization AI translation chunk completed", {
+          taskId: this.record.id,
+          chunkIndex,
+          rows: textRows.length,
+          elapsedMs: elapsed(chunkStart),
+          translated,
+          total
+        });
+      }
+    });
     (_b = this.logger) == null ? void 0 : _b.debug("Localization AI translation task completed", {
       taskId: this.record.id,
       translated,
@@ -186,34 +186,8 @@ class LocalizationAITranslateTask extends import_plugin_async_task_manager.TaskT
       total
     };
   }
-  async countTexts(mode, locale, textIds) {
-    return await this.app.db.getRepository("localizationTexts").count(this.buildFindTextsOptions(mode, locale, textIds));
-  }
-  buildFindTextsOptions(mode, locale, textIds) {
-    const options = {
-      fields: ["id", "text", "module"],
-      sort: ["id"]
-    };
-    if (mode === "selected") {
-      options.filter = {
-        id: {
-          $in: textIds || []
-        }
-      };
-    }
-    if (mode === "incremental") {
-      options.include = [{ association: "translations", where: { locale }, required: false }];
-      options.where = {
-        "$translations.id$": null
-      };
-    }
-    return options;
-  }
-  normalizeTextRecord(row) {
-    if (!row) {
-      return void 0;
-    }
-    return typeof row.toJSON === "function" ? row.toJSON() : row;
+  async countTexts(options) {
+    return await this.app.db.getRepository("localizationTexts").count(options);
   }
   async getLocaleReferences(textIds, locale) {
     const references = /* @__PURE__ */ new Map();
@@ -223,10 +197,10 @@ class LocalizationAITranslateTask extends import_plugin_async_task_manager.TaskT
     const rows = await this.app.db.getRepository("localizationTranslations").find({
       fields: ["textId", "translation"],
       filter: {
-        locale,
         textId: {
           $in: textIds
-        }
+        },
+        locale
       }
     });
     for (const row of rows) {
@@ -237,34 +211,72 @@ class LocalizationAITranslateTask extends import_plugin_async_task_manager.TaskT
     }
     return references;
   }
+  async getReferenceMaps(textIds, locales) {
+    const result = /* @__PURE__ */ new Map();
+    await Promise.all(
+      locales.map(async (locale) => {
+        result.set(locale, await this.getLocaleReferences(textIds, locale));
+      })
+    );
+    return result;
+  }
+  pickDbReference(row, references, locales) {
+    var _a;
+    for (const locale of [locales.primary, locales.fallback].filter(isString)) {
+      const translation = (_a = references.get(locale)) == null ? void 0 : _a.get(String(row.id));
+      if (translation) {
+        return { locale, translation };
+      }
+    }
+    return {};
+  }
   async getSystemDefaultLocale() {
     var _a;
     const systemSetting = await ((_a = this.app.db.getRepository("systemSettings")) == null ? void 0 : _a.findOne());
     const enabledLanguages = (systemSetting == null ? void 0 : systemSetting.get("enabledLanguages")) || [];
     return (enabledLanguages == null ? void 0 : enabledLanguages[0]) || process.env.APP_LANG || "en-US";
   }
-  getModuleName(row) {
-    var _a;
-    return (_a = row.module) == null ? void 0 : _a.replace("resources.", "");
-  }
-  isBuiltInText(row, resources) {
-    var _a;
-    const moduleName = this.getModuleName(row);
-    return Boolean(moduleName && ((_a = resources[moduleName]) == null ? void 0 : _a[row.text]) !== void 0);
+  resolveReferenceLocales(referenceLocales, defaultReferenceLocale) {
+    var _a, _b, _c, _d;
+    return {
+      builtIn: {
+        primary: ((_a = referenceLocales == null ? void 0 : referenceLocales.builtIn) == null ? void 0 : _a.primary) || "zh-CN",
+        fallback: ((_b = referenceLocales == null ? void 0 : referenceLocales.builtIn) == null ? void 0 : _b.fallback) || "ja-JP"
+      },
+      custom: {
+        primary: ((_c = referenceLocales == null ? void 0 : referenceLocales.custom) == null ? void 0 : _c.primary) || defaultReferenceLocale,
+        fallback: ((_d = referenceLocales == null ? void 0 : referenceLocales.custom) == null ? void 0 : _d.fallback) || "zh-CN"
+      }
+    };
   }
-  getBuiltInReference(row, resources) {
-    var _a;
-    const moduleName = this.getModuleName(row);
-    return moduleName ? (_a = resources[moduleName]) == null ? void 0 : _a[row.text] : void 0;
+  async buildTranslationItems(batch, referenceLocales, chunkIndex) {
+    const builtInTextIds = batch.filter((item) => item.isBuiltIn).map((item) => item.row.id);
+    const customTextIds = batch.filter((item) => !item.isBuiltIn).map((item) => item.row.id);
+    const builtInReferences = await this.getReferenceMaps(
+      builtInTextIds,
+      [referenceLocales.builtIn.primary, referenceLocales.builtIn.fallback].filter(isString)
+    );
+    const customReferences = await this.getReferenceMaps(
+      customTextIds,
+      [referenceLocales.custom.primary, referenceLocales.custom.fallback].filter(isString)
+    );
+    return batch.map(({ row, isBuiltIn }) => {
+      const references = isBuiltIn ? referenceLocales.builtIn : referenceLocales.custom;
+      const reference = this.pickDbReference(row, isBuiltIn ? builtInReferences : customReferences, references);
+      return {
+        row,
+        chunkIndex,
+        referenceTranslation: reference.translation,
+        referenceLocale: reference.locale,
+        isBuiltIn
+      };
+    });
   }
-  async runTranslationWorker(options) {
+  async translateItem(options) {
     var _a, _b, _c, _d, _e, _f, _g, _h;
     const {
       workerIndex,
-      queue,
-      isDone,
-      getError,
-      setError,
+      item,
       total,
       getTranslated,
       incrementTranslated,
@@ -275,102 +287,85 @@ class LocalizationAITranslateTask extends import_plugin_async_task_manager.TaskT
       service,
       model
     } = options;
-    while (!isDone() || queue.length > 0) {
-      if (getError()) {
-        return;
-      }
-      if (this.isCanceled) {
-        throw new import_plugin_async_task_manager.CancelError();
-      }
-      const item = queue.shift();
-      if (!item) {
-        await sleep(50);
-        continue;
-      }
-      const { row, chunkIndex, englishReference, referenceTranslation, referenceLocale, isBuiltIn } = item;
-      try {
-        const textStart = Date.now();
-        (_c = (_a = this.logger) == null ? void 0 : _a.trace) == null ? void 0 : _c.call(_a, "Localization AI translation text started", {
+    if (this.isCanceled) {
+      throw new import_plugin_async_task_manager.CancelError();
+    }
+    const { row, chunkIndex, referenceTranslation, referenceLocale, isBuiltIn } = item;
+    try {
+      const textStart = Date.now();
+      (_c = (_a = this.logger) == null ? void 0 : _a.trace) == null ? void 0 : _c.call(_a, "Localization AI translation text started", {
+        taskId: this.record.id,
+        workerIndex,
+        chunkIndex,
+        textId: row.id,
+        textLength: ((_b = row.text) == null ? void 0 : _b.length) ?? 0,
+        hasReferenceTranslation: Boolean(referenceTranslation),
+        referenceLocale,
+        isBuiltIn,
+        translated: getTranslated(),
+        total
+      });
+      const isLegacySymbolTranslation = LEGACY_SYMBOL_TRANSLATIONS.has(row.text);
+      if (isLegacySymbolTranslation) {
+        (_e = (_d = this.logger) == null ? void 0 : _d.trace) == null ? void 0 : _e.call(_d, "Localization AI translation legacy symbol skipped", {
           taskId: this.record.id,
           workerIndex,
           chunkIndex,
           textId: row.id,
-          textLength: ((_b = row.text) == null ? void 0 : _b.length) ?? 0,
-          hasEnglishReference: Boolean(englishReference),
-          hasReferenceTranslation: Boolean(referenceTranslation),
-          referenceLocale,
-          isBuiltIn,
-          queueSize: queue.length,
-          translated: getTranslated(),
-          total
+          text: row.text
         });
-        const isLegacySymbolTranslation = LEGACY_SYMBOL_TRANSLATIONS.has(row.text);
-        if (isLegacySymbolTranslation) {
-          (_e = (_d = this.logger) == null ? void 0 : _d.trace) == null ? void 0 : _e.call(_d, "Localization AI translation legacy symbol skipped", {
-            taskId: this.record.id,
-            workerIndex,
-            chunkIndex,
-            textId: row.id,
-            text: row.text
-          });
-        }
-        const translation = isLegacySymbolTranslation ? row.text : await this.translateText({
-          text: row.text,
-          module: row.module,
-          englishReference,
-          referenceTranslation,
-          referenceLocale,
-          isBuiltIn,
-          locale,
-          employeeUsername,
-          employee,
-          provider,
-          service,
-          model
-        });
-        const aiElapsedMs = elapsed(textStart);
-        const writeStart = Date.now();
-        await this.app.db.getRepository("localizationTranslations").updateOrCreate({
-          filterKeys: ["textId", "locale"],
-          values: {
-            textId: row.id,
-            locale,
-            translation
-          }
-        });
-        const writeElapsedMs = elapsed(writeStart);
-        const translated = incrementTranslated();
-        this.reportProgress({ total, current: translated });
-        (_g = this.logger) == null ? void 0 : _g.debug("Localization AI translation text completed", {
-          taskId: this.record.id,
-          workerIndex,
-          chunkIndex,
+      }
+      const translation = isLegacySymbolTranslation ? row.text : await this.translateText({
+        text: row.text,
+        module: row.module,
+        referenceTranslation,
+        referenceLocale,
+        isBuiltIn,
+        locale,
+        employeeUsername,
+        employee,
+        provider,
+        service,
+        model
+      });
+      const aiElapsedMs = elapsed(textStart);
+      const writeStart = Date.now();
+      await this.app.db.getRepository("localizationTranslations").updateOrCreate({
+        filterKeys: ["textId", "locale"],
+        values: {
           textId: row.id,
-          textLength: ((_f = row.text) == null ? void 0 : _f.length) ?? 0,
-          translationLength: translation.length,
-          aiElapsedMs,
-          writeElapsedMs,
-          totalElapsedMs: elapsed(textStart),
-          translated,
-          total,
-          queueSize: queue.length
-        });
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        const details = {
-          id: row.id,
-          text: row.text,
-          error: message
-        };
-        (_h = this.logger) == null ? void 0 : _h.error(`Failed to translate localization text ${row.id}: ${message}`, { error });
-        if (error instanceof import_plugin_async_task_manager.CancelError) {
-          throw error;
+          locale,
+          translation
         }
-        setError(
-          new LocalizationAITranslationError(`Failed to translate localization text ${row.id}: ${message}`, details)
-        );
-        return;
+      });
+      const writeElapsedMs = elapsed(writeStart);
+      const translated = incrementTranslated();
+      this.reportProgress({ total, current: translated });
+      (_g = this.logger) == null ? void 0 : _g.debug("Localization AI translation text completed", {
+        taskId: this.record.id,
+        workerIndex,
+        chunkIndex,
+        textId: row.id,
+        textLength: ((_f = row.text) == null ? void 0 : _f.length) ?? 0,
+        translationLength: translation.length,
+        aiElapsedMs,
+        writeElapsedMs,
+        totalElapsedMs: elapsed(textStart),
+        translated,
+        total
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      const details = {
+        id: row.id,
+        text: row.text,
+        error: message
+      };
+      (_h = this.logger) == null ? void 0 : _h.error(`Failed to translate localization text ${row.id}: ${message}`, { error });
+      if (error instanceof import_plugin_async_task_manager.CancelError) {
+        throw error;
       }
+      throw new LocalizationAITranslationError(`Failed to translate localization text ${row.id}: ${message}`, details);
     }
   }
   async translateText(options) {
@@ -378,7 +373,6 @@ class LocalizationAITranslateTask extends import_plugin_async_task_manager.TaskT
     const {
       text,
       module: module2,
-      englishReference,
       referenceTranslation,
       referenceLocale,
       isBuiltIn,
@@ -390,14 +384,13 @@ class LocalizationAITranslateTask extends import_plugin_async_task_manager.TaskT
       employee
     } = options;
     const setupStart = Date.now();
-    const sourceText = englishReference || text;
-    const sourceLang = englishReference ? "English" : "auto";
+    const sourceText = text;
     const targetLang = this.getLanguageName(locale);
     const context = this.buildProviderContext({
+      systemPrompt: this.getEmployeeSystemPrompt(employee),
       sourceText,
       targetLang,
-      referenceSourceTerm: sourceText,
-      referenceTargetTerm: referenceTranslation
+      referenceTranslation
     });
     const invokeStart = Date.now();
     (_b = (_a = this.logger) == null ? void 0 : _a.trace) == null ? void 0 : _b.call(_a, "Localization AI translation invoke started", {
@@ -405,44 +398,29 @@ class LocalizationAITranslateTask extends import_plugin_async_task_manager.TaskT
       textLength: (text == null ? void 0 : text.length) ?? 0,
       sourceTextLength: (sourceText == null ? void 0 : sourceText.length) ?? 0,
       locale,
-      sourceLang,
       targetLang,
       module: module2,
       employeeUsername,
       provider: service == null ? void 0 : service.provider,
       llmService: service == null ? void 0 : service.name,
       model,
-      hasEnglishReference: Boolean(englishReference),
       hasReferenceTranslation: Boolean(referenceTranslation),
       referenceLocale,
       isBuiltIn
     });
-    const result = await provider.invoke(context, {
-      modelRequestParams: {
-        sourceText,
-        sourceLang,
-        targetLang,
-        terms: this.buildTranslationTerms({
-          sourceTerm: sourceText,
-          targetTerm: referenceTranslation,
-          targetLang
-        })
-      }
-    });
+    const result = await provider.invoke(context);
     const invokeElapsedMs = elapsed(invokeStart);
     (_d = (_c = this.logger) == null ? void 0 : _c.trace) == null ? void 0 : _d.call(_c, "Localization AI translation invoke completed", {
       taskId: this.record.id,
       textLength: (text == null ? void 0 : text.length) ?? 0,
       sourceTextLength: (sourceText == null ? void 0 : sourceText.length) ?? 0,
       locale,
-      sourceLang,
       targetLang,
       module: module2,
       employeeUsername,
       provider: service == null ? void 0 : service.provider,
       llmService: service == null ? void 0 : service.name,
       model,
-      hasEnglishReference: Boolean(englishReference),
       hasReferenceTranslation: Boolean(referenceTranslation),
       referenceLocale,
       isBuiltIn,
@@ -460,14 +438,12 @@ class LocalizationAITranslateTask extends import_plugin_async_task_manager.TaskT
       sourceTextLength: (sourceText == null ? void 0 : sourceText.length) ?? 0,
       translationLength: translation.length,
       locale,
-      sourceLang,
       targetLang,
       module: module2,
       employeeUsername,
       provider: service == null ? void 0 : service.provider,
       llmService: service == null ? void 0 : service.name,
       model,
-      hasEnglishReference: Boolean(englishReference),
       hasReferenceTranslation: Boolean(referenceTranslation),
       referenceLocale,
       isBuiltIn,
@@ -477,32 +453,25 @@ class LocalizationAITranslateTask extends import_plugin_async_task_manager.TaskT
     });
     return translation;
   }
+  getEmployeeSystemPrompt(employee) {
+    var _a, _b;
+    return ((_a = employee == null ? void 0 : employee.get) == null ? void 0 : _a.call(employee, "about")) || ((_b = employee == null ? void 0 : employee.get) == null ? void 0 : _b.call(employee, "defaultPrompt")) || (employee == null ? void 0 : employee.about) || (employee == null ? void 0 : employee.defaultPrompt) || "";
+  }
   buildProviderContext(options) {
-    const { sourceText, targetLang, referenceSourceTerm, referenceTargetTerm } = options;
-    const reference = referenceSourceTerm && referenceTargetTerm ? `Refer to the following translation:
-${referenceSourceTerm} is translated as ${referenceTargetTerm}
+    const { systemPrompt, sourceText, targetLang, referenceTranslation } = options;
+    const prompt = (systemPrompt || "").trim();
+    const reference = referenceTranslation ? `Refer to the following translation:
+${sourceText} is translated as ${referenceTranslation}
 
 ` : "";
-    const content = `${reference}Translate the following text into ${targetLang}. Output only the translated result without any additional explanation:
-
+    const task = `Translate the following text into ${targetLang}. Output only the translated result without any additional explanation:
 ${sourceText}
 `;
+    const content = [prompt, `${reference}${task}`].filter(Boolean).join("\n\n");
     return {
       messages: [new import_messages.HumanMessage(content)]
     };
   }
-  buildTranslationTerms(options) {
-    const { sourceTerm, targetTerm, targetLang } = options;
-    if (!sourceTerm || !targetTerm || !["Chinese", "Traditional Chinese"].includes(targetLang)) {
-      return void 0;
-    }
-    return [
-      {
-        source: sourceTerm,
-        target: targetTerm
-      }
-    ];
-  }
   getLanguageName(locale) {
     const normalized = locale.replace("_", "-");
     const map = {