@ai-agent-forge/agent-forge 0.86.7 → 0.87.0

package/dist/main.js

@@ -29,6 +29,7 @@ import { formatNoModelsAvailableMessage } from "./core/auth-guidance.js";
 import { AuthStorage, ReadOnlyAuthStorage } from "./core/auth-storage.js";
 import { exportFromFile } from "./core/export-html/index.js";
 import { applyHttpProxySettings, configureHttpDispatcher } from "./core/http-dispatcher.js";
+import { setI18nLanguage, t } from "./core/i18n/index.js";
 import { createHostLogger } from "./core/logger.js";
 import { resolveCliModel, resolveModelScope } from "./core/model-resolver.js";
 import { ModelRuntime } from "./core/model-runtime.js";
@@ -135,8 +136,12 @@ function filterAcknowledgedSuiteNotices(diagnostics, settingsManager) {
 function reportDiagnostics(diagnostics) {
     for (const diagnostic of diagnostics) {
         const color = diagnostic.type === "error" ? chalk.red : diagnostic.type === "warning" ? chalk.yellow : chalk.dim;
-        const prefix = diagnostic.type === "error" ? "Error: " : diagnostic.type === "warning" ? "Warning: " : "";
-        console.error(color(`${prefix}${diagnostic.message}`));
+        const message = diagnostic.type === "error"
+            ? t("Error: {message}", { message: diagnostic.message })
+            : diagnostic.type === "warning"
+                ? t("Warning: {message}", { message: diagnostic.message })
+                : diagnostic.message;
+        console.error(color(message));
     }
 }
 function isTruthyEnvFlag(value) {
@@ -177,8 +182,8 @@ async function runAuthCommand(args) {
         command = parseAuthCommand(args);
     }
     catch (error) {
-        const message = error instanceof AuthCommandError ? error.message : "Failed to parse auth command";
-        console.error(chalk.red(`Error: ${message}`));
+        const message = error instanceof AuthCommandError ? error.message : t("Failed to parse auth command");
+        console.error(chalk.red(t("Error: {message}", { message })));
         process.exitCode = 1;
         return true;
     }
@@ -191,10 +196,13 @@ async function runAuthCommand(args) {
     const unknownLongOptions = parsed.diagnostics.filter((diagnostic) => diagnostic.message.startsWith("Unknown option: --"));
     if (unknownLongOptions.length > 0) {
         for (const diagnostic of unknownLongOptions) {
-            console.error(chalk.red(`Error: ${diagnostic.message}`));
+            console.error(chalk.red(t("Error: {message}", { message: diagnostic.message })));
         }
-        console.error(chalk.red(`Invalid arguments for "${getAuthCommandName(command.kind)}".`));
-        console.error(chalk.dim(`Use "${APP_NAME} --help" or "${getAuthCommandUsage(command.kind)}".`));
+        console.error(chalk.red(t('Invalid arguments for "{command}".', { command: getAuthCommandName(command.kind) })));
+        console.error(chalk.dim(t('Use "{help}" or "{usage}".', {
+            help: `${APP_NAME} --help`,
+            usage: getAuthCommandUsage(command.kind),
+        })));
         process.exitCode = 1;
         return true;
     }
@@ -239,8 +247,8 @@ async function runAuthCommand(args) {
         process.exitCode = result.status === "ready" ? 0 : result.status === "not_ready" ? 1 : 2;
     }
     catch (error) {
-        const message = error instanceof AuthCommandError ? error.message : "Failed to resolve credential";
-        console.error(chalk.red(`Error: ${message}`));
+        const message = error instanceof AuthCommandError ? error.message : t("Failed to resolve credential");
+        console.error(chalk.red(t("Error: {message}", { message })));
         process.exitCode = command.kind === "check" ? 2 : 1;
     }
     return true;
@@ -276,7 +284,7 @@ async function promptConfirm(message) {
 }
 function printSuiteLifecycleError(error) {
     const message = error instanceof Error ? error.message : String(error);
-    console.error(chalk.red(`Error: ${message}`));
+    console.error(chalk.red(t("Error: {message}", { message })));
 }
 function suiteWorkspaceExists(agentDir, id) {
     return existsSync(join(getSuiteWorkspaceDir(agentDir, id), SUITE_MANIFEST_FILENAME));
@@ -295,7 +303,7 @@ async function handleSuiteLifecycleCommands(parsed, cwd, agentDir) {
                 id: parsed.suiteCreate,
                 ...(parsed.cloneFrom === undefined ? {} : { cloneFrom: parsed.cloneFrom }),
             });
-            console.log(`Created suite "${result.suiteId}" at ${result.suiteDir}`);
+            console.log(t('Created suite "{id}" at {dir}', { id: result.suiteId, dir: result.suiteDir }));
         }
         catch (error) {
             printSuiteLifecycleError(error);
@@ -304,7 +312,7 @@ async function handleSuiteLifecycleCommands(parsed, cwd, agentDir) {
         process.exit(0);
     }
     if (parsed.cloneFrom !== undefined) {
-        console.error(chalk.red("Error: --clone-from requires --suite-create"));
+        console.error(chalk.red(t("Error: --clone-from requires --suite-create")));
         process.exit(1);
     }
     if (parsed.suiteDelete !== undefined) {
@@ -319,30 +327,39 @@ async function handleSuiteLifecycleCommands(parsed, cwd, agentDir) {
         }
         const refs = findSuiteSessionRefs(agentDir, id);
         if (refs.length > 0) {
-            console.error(chalk.red(`Error: suite "${id}" is referenced by ${refs.length} existing session(s); deletion refused:`));
+            console.error(chalk.red(t('Error: suite "{id}" is referenced by {count} existing session(s); deletion refused:', {
+                id,
+                count: refs.length,
+            })));
             for (const ref of refs) {
                 console.error(`  ${ref.sessionId}  ${ref.path}`);
             }
             process.exit(1);
         }
         const suiteDir = getSuiteWorkspaceDir(agentDir, id);
-        console.log(`Deleting suite "${id}": the workspace directory ${suiteDir} will be moved to the trash and released.`);
+        console.log(t('Deleting suite "{id}": the workspace directory {dir} will be moved to the trash and released.', {
+            id,
+            dir: suiteDir,
+        }));
         if (!process.stdin.isTTY) {
-            console.error(chalk.red(`Refusing to delete suite "${id}" without an interactive confirmation (non-interactive stdin). Re-run in a terminal to confirm.`));
+            console.error(chalk.red(t('Refusing to delete suite "{id}" without an interactive confirmation (non-interactive stdin). Re-run in a terminal to confirm.', { id })));
             process.exit(1);
         }
-        if (!(await promptConfirm(`Delete suite "${id}"?`))) {
-            console.log(`Aborted: suite "${id}" was not deleted.`);
+        if (!(await promptConfirm(t('Delete suite "{id}"?', { id })))) {
+            console.log(t('Aborted: suite "{id}" was not deleted.', { id }));
             process.exit(1);
         }
         try {
             const result = deleteSuite({ agentDir, id, refs });
             const cleanup = clearDanglingSuiteSettings(SettingsManager.create(cwd, agentDir), id);
             for (const scope of cleanup.clearedScopes) {
-                console.log(`Cleared the ${scope} settings "suite" key (pointed at "${id}").`);
+                console.log(t('Cleared the {scope} settings "suite" key (pointed at "{id}").', { scope, id }));
             }
             releaseTrashedSuite(result.trashPath);
-            console.log(`Deleted suite "${id}"; the workspace was moved to ${result.trashPath} and is being released.`);
+            console.log(t('Deleted suite "{id}"; the workspace was moved to {trashPath} and is being released.', {
+                id,
+                trashPath: result.trashPath,
+            }));
         }
         catch (error) {
             printSuiteLifecycleError(error);
@@ -354,29 +371,34 @@ async function handleSuiteLifecycleCommands(parsed, cwd, agentDir) {
         const id = parsed.suiteReset;
         if (!isBuiltinSuiteId(id)) {
             const message = listSuiteIds(agentDir).includes(id)
-                ? `Suite "${id}" is a user suite; only builtin suites can be reset — use --suite-delete instead.`
+                ? t('Suite "{id}" is a user suite; only builtin suites can be reset — use --suite-delete instead.', {
+                    id,
+                })
                 : new SuiteResolutionError(id, listSuiteIds(agentDir)).message;
-            console.error(chalk.red(`Error: ${message}`));
+            console.error(chalk.red(t("Error: {message}", { message })));
             process.exit(1);
         }
         try {
             const plan = resetSuite({ agentDir, id });
             if (plan.diffText.length === 0) {
-                console.log(`Suite "${id}" already matches the factory contents; nothing to reset.`);
+                console.log(t('Suite "{id}" already matches the factory contents; nothing to reset.', { id }));
                 process.exit(0);
             }
-            console.log(`Resetting builtin suite "${id}" to the factory contents:\n`);
+            console.log(`${t('Resetting builtin suite "{id}" to the factory contents:', { id })}\n`);
             console.log(plan.diffText);
             if (!process.stdin.isTTY) {
-                console.error(chalk.red(`Refusing to reset suite "${id}" without an interactive confirmation (non-interactive stdin). Review the diff above and re-run in a terminal to confirm.`));
+                console.error(chalk.red(t('Refusing to reset suite "{id}" without an interactive confirmation (non-interactive stdin). Review the diff above and re-run in a terminal to confirm.', { id })));
                 process.exit(1);
             }
-            if (!(await promptConfirm(`Apply reset of suite "${id}"?`))) {
-                console.log(`Aborted: suite "${id}" was not reset.`);
+            if (!(await promptConfirm(t('Apply reset of suite "{id}"?', { id })))) {
+                console.log(t('Aborted: suite "{id}" was not reset.', { id }));
                 process.exit(1);
             }
             const result = plan.apply();
-            console.log(`Suite "${id}" was reset to the factory contents (profile lock generation ${result.lock.generation}).`);
+            console.log(t('Suite "{id}" was reset to the factory contents (profile lock generation {generation}).', {
+                id,
+                generation: result.lock.generation,
+            }));
         }
         catch (error) {
             printSuiteLifecycleError(error);
@@ -395,7 +417,7 @@ function validateForkFlags(parsed) {
         parsed.noSession ? "--no-session" : undefined,
     ].filter((flag) => flag !== undefined);
     if (conflictingFlags.length > 0) {
-        console.error(chalk.red(`Error: --fork cannot be combined with ${conflictingFlags.join(", ")}`));
+        console.error(chalk.red(t("Error: --fork cannot be combined with {flags}", { flags: conflictingFlags.join(", ") })));
         process.exit(1);
     }
 }
@@ -408,7 +430,7 @@ function validateSessionIdFlags(parsed) {
         parsed.resume ? "--resume" : undefined,
     ].filter((flag) => flag !== undefined);
     if (conflictingFlags.length > 0) {
-        console.error(chalk.red(`Error: --session-id cannot be combined with ${conflictingFlags.join(", ")}. To resume that exact session, drop the other flags and use --session-id alone (or use --continue to resume the most recent session).`));
+        console.error(chalk.red(t("Error: --session-id cannot be combined with {flags}. To resume that exact session, drop the other flags and use --session-id alone (or use --continue to resume the most recent session).", { flags: conflictingFlags.join(", ") })));
         process.exit(1);
     }
     try {
@@ -416,7 +438,7 @@ function validateSessionIdFlags(parsed) {
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        console.error(chalk.red(`Error: ${message}`));
+        console.error(chalk.red(t("Error: {message}", { message })));
         process.exit(1);
     }
 }
@@ -426,7 +448,7 @@ function openSessionOrExit(path, sessionDir) {
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        console.error(chalk.red(`Error: ${message}`));
+        console.error(chalk.red(t("Error: {message}", { message })));
         process.exit(1);
     }
 }
@@ -436,7 +458,7 @@ function forkSessionOrExit(sourcePath, cwd, sessionDir, sessionId) {
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        console.error(chalk.red(`Error: ${message}`));
+        console.error(chalk.red(t("Error: {message}", { message })));
         process.exit(1);
     }
 }
@@ -448,7 +470,7 @@ export async function createSessionManager(parsed, cwd, sessionDir, settingsMana
         if (parsed.sessionId) {
             const existingTarget = findLocalSessionByExactId(parsed.sessionId, cwd, sessionDir);
             if (existingTarget) {
-                console.error(chalk.red(`Session already exists with id '${parsed.sessionId}'`));
+                console.error(chalk.red(t("Session already exists with id '{sessionId}'", { sessionId: parsed.sessionId })));
                 process.exit(1);
             }
         }
@@ -459,7 +481,7 @@ export async function createSessionManager(parsed, cwd, sessionDir, settingsMana
             case "global":
                 return forkSessionOrExit(resolved.path, cwd, sessionDir, parsed.sessionId);
             case "not_found":
-                console.error(chalk.red(`No session found matching '${resolved.arg}'`));
+                console.error(chalk.red(t("No session found matching '{arg}'", { arg: resolved.arg })));
                 process.exit(1);
         }
     }
@@ -470,16 +492,16 @@ export async function createSessionManager(parsed, cwd, sessionDir, settingsMana
             case "local":
                 return openSessionOrExit(resolved.path, sessionDir);
             case "global": {
-                console.log(chalk.yellow(`Session found in different project: ${resolved.cwd}`));
-                const shouldFork = await promptConfirm("Fork this session into current directory?");
+                console.log(chalk.yellow(t("Session found in different project: {cwd}", { cwd: resolved.cwd })));
+                const shouldFork = await promptConfirm(t("Fork this session into current directory?"));
                 if (!shouldFork) {
-                    console.log(chalk.dim("Aborted."));
+                    console.log(chalk.dim(t("Aborted.")));
                     process.exit(0);
                 }
                 return forkSessionOrExit(resolved.path, cwd, sessionDir);
             }
             case "not_found":
-                console.error(chalk.red(`No session found matching '${resolved.arg}'`));
+                console.error(chalk.red(t("No session found matching '{arg}'", { arg: resolved.arg })));
                 process.exit(1);
         }
     }
@@ -487,7 +509,7 @@ export async function createSessionManager(parsed, cwd, sessionDir, settingsMana
         try {
             const selectedPath = await selectSession((onProgress, signal) => SessionManager.list(cwd, sessionDir, onProgress, signal), (onProgress, signal) => SessionManager.listAll(sessionDir, onProgress, signal), settingsManager);
             if (!selectedPath) {
-                console.log(chalk.dim("No session selected"));
+                console.log(chalk.dim(t("No session selected")));
                 process.exit(0);
             }
             return SessionManager.open(selectedPath, sessionDir);
@@ -504,7 +526,9 @@ export async function createSessionManager(parsed, cwd, sessionDir, settingsMana
         if (existingSession) {
             return SessionManager.open(existingSession.path, sessionDir);
         }
-        console.error(chalk.yellow(`Warning: No project session found with id '${parsed.sessionId}'; creating a new session with that id.`));
+        console.error(chalk.yellow(t("Warning: No project session found with id '{sessionId}'; creating a new session with that id.", {
+            sessionId: parsed.sessionId,
+        })));
     }
     return SessionManager.create(cwd, sessionDir, { id: parsed.sessionId });
 }
@@ -713,6 +737,7 @@ export async function main(args, options) {
     const cwd = process.cwd();
     const agentDir = getAgentDir();
     const bootstrapSettingsManager = SettingsManager.create(cwd, agentDir);
+    setI18nLanguage(bootstrapSettingsManager.getUiLanguage());
     applyHttpProxySettings(bootstrapSettingsManager.getGlobalSettings().httpProxy);
     configureHttpDispatcher();
     if (await handlePackageCommand(args)) {
@@ -744,7 +769,9 @@ export async function main(args, options) {
     if (parsed.diagnostics.length > 0) {
         for (const d of parsed.diagnostics) {
             const color = d.type === "error" ? chalk.red : chalk.yellow;
-            console.error(color(`${d.type === "error" ? "Error" : "Warning"}: ${d.message}`));
+            console.error(color(d.type === "error"
+                ? t("Error: {message}", { message: d.message })
+                : t("Warning: {message}", { message: d.message })));
         }
         if (parsed.diagnostics.some((d) => d.type === "error")) {
             process.exit(1);
@@ -803,11 +830,11 @@ export async function main(args, options) {
             result = await exportFromFile(parsed.export, outputPath);
         }
         catch (error) {
-            const message = error instanceof Error ? error.message : "Failed to export session";
-            console.error(chalk.red(`Error: ${message}`));
+            const message = error instanceof Error ? error.message : t("Failed to export session");
+            console.error(chalk.red(t("Error: {message}", { message })));
             process.exit(1);
         }
-        console.log(`Exported to: ${result}`);
+        console.log(t("Exported to: {result}", { result }));
         process.exit(0);
     }
     // Trace viewer (设计 §8 第 3 期): same exit-style dispatch as --export above,
@@ -828,7 +855,7 @@ export async function main(args, options) {
             ...(parsed.traceLimit === undefined ? {} : { limit: parsed.traceLimit }),
         });
         if (!result.ok) {
-            console.error(chalk.red(`Error: ${result.message}`));
+            console.error(chalk.red(t("Error: {message}", { message: result.message ?? "Unknown error" })));
             process.exit(1);
         }
         process.exit(0);
@@ -875,7 +902,7 @@ export async function main(args, options) {
             parsed.cloneFrom ? "--clone-from" : undefined,
         ].filter((flag) => flag !== undefined);
         if (conflictingFlags.length > 0) {
-            console.error(chalk.red(`Error: --serve cannot be combined with ${conflictingFlags.join(", ")}`));
+            console.error(chalk.red(t("Error: --serve cannot be combined with {flags}", { flags: conflictingFlags.join(", ") })));
             process.exit(1);
         }
         // Remaining options would be silently ignored; list the ones the user
@@ -912,7 +939,7 @@ export async function main(args, options) {
         ];
         const ignoredFlags = ignoredFlagChecks.flatMap(([flag, passed]) => (passed ? [flag] : []));
         if (ignoredFlags.length > 0) {
-            console.warn(chalk.yellow(`--serve ignores session/model/tool options: ${ignoredFlags.join(", ")}`));
+            console.warn(chalk.yellow(t("--serve ignores session/model/tool options: {flags}", { flags: ignoredFlags.join(", ") })));
         }
         await runServeMode(parsed.serve, {
             ...(parsed.serveWorkspaceRoots === undefined ? {} : { workspaceRoots: parsed.serveWorkspaceRoots }),
@@ -940,7 +967,7 @@ export async function main(args, options) {
         takeOverStdout();
     }
     if (parsed.mode === "rpc" && parsed.fileArgs.length > 0) {
-        console.error(chalk.red("Error: @file arguments are not supported in RPC mode"));
+        console.error(chalk.red(t("Error: @file arguments are not supported in RPC mode")));
         process.exit(1);
     }
     validateForkFlags(parsed);
@@ -986,7 +1013,7 @@ export async function main(args, options) {
     if (parsed.name !== undefined) {
         const name = normalizeSessionName(parsed.name);
         if (name === undefined) {
-            console.error(chalk.red("Error: --name requires a non-empty value"));
+            console.error(chalk.red(t("Error: --name requires a non-empty value")));
             process.exit(1);
         }
         sessionManager.appendSessionInfo(name);
@@ -1045,7 +1072,7 @@ export async function main(args, options) {
         if (!parsed.noPlugins) {
             const bootstrapResult = await runStartupPluginBootstrap(cwd);
             for (const diagnostic of bootstrapResult.diagnostics) {
-                console.error(chalk.yellow(`Plugin bootstrap ${diagnostic.code}: ${diagnostic.message}`));
+                console.error(chalk.yellow(t("Plugin bootstrap {code}: {message}", { code: diagnostic.code, message: diagnostic.message })));
             }
         }
         const resolveActivePluginBindings = options?.resolveActivePluginBindings ?? createDefaultActivePluginBindingsResolverV1();
@@ -1171,8 +1198,10 @@ export async function main(args, options) {
                 const entry = scopedModels.find((candidate) => candidate.model.id === childModelId);
                 if (entry === undefined) {
                     const available = scopedModels.map((candidate) => candidate.model.id).sort();
-                    throw new Error(`agent task child profile model ${JSON.stringify(childModelId)} is not among the runner's scoped models` +
-                        (available.length === 0 ? " (none configured)" : `; available: ${available.join(", ")}`));
+                    throw new Error(t("agent task child profile model {model} is not among the runner's scoped models{available}", {
+                        model: JSON.stringify(childModelId),
+                        available: available.length === 0 ? " (none configured)" : `; available: ${available.join(", ")}`,
+                    }));
                 }
                 return entry.model;
             })();
@@ -1339,7 +1368,10 @@ export async function main(args, options) {
                         if (resumeRead === undefined ||
                             request.parentSessionId === undefined ||
                             resumeRead.parentAgentSession !== request.parentSessionId) {
-                            throw new Error(`resume target ${request.resumeSessionId} is not a persisted child of session ${String(request.parentSessionId)}`);
+                            throw new Error(t("resume target {resumeId} is not a persisted child of session {parentId}", {
+                                resumeId: request.resumeSessionId,
+                                parentId: String(request.parentSessionId),
+                            }));
                         }
                     }
                     const resumeFilePath = resumeRead !== undefined && typeof request.resumeSessionId === "string"
@@ -1444,7 +1476,7 @@ export async function main(args, options) {
         // 已绑定会话换 suite / Profile 身份漂移（SuiteRebindError）：用户可自行纠正的
         // 参数错误，干净的一行 stderr + 退出 1，不甩内部栈（dogfood 2026-09-25 实测）。
         if (error instanceof SuiteRebindError) {
-            console.error(chalk.red(`Error: ${error.message}`));
+            console.error(chalk.red(t("Error: {message}", { message: error.message })));
             process.exit(1);
         }
         // Unknown --suite/env/settings suite ids are a structured startup error
@@ -1452,7 +1484,7 @@ export async function main(args, options) {
         if (!(error instanceof SuiteResolutionError))
             throw error;
         if (appMode !== "interactive") {
-            console.error(chalk.red(`Error: ${error.message}`));
+            console.error(chalk.red(t("Error: {message}", { message: error.message })));
             process.exit(1);
         }
         // One in-process recovery attempt (设计 §9 startup selector): record the
@@ -1476,7 +1508,7 @@ export async function main(args, options) {
         }
         catch (retryError) {
             if (retryError instanceof SuiteResolutionError) {
-                console.error(chalk.red(`Error: ${retryError.message}`));
+                console.error(chalk.red(t("Error: {message}", { message: retryError.message })));
                 process.exit(1);
             }
             throw retryError;
@@ -1534,7 +1566,11 @@ export async function main(args, options) {
     // capability plugins get an explicit stderr note before the TUI takes over.
     if (appMode === "interactive") {
         for (const rejection of runtime.pluginRejections) {
-            console.error(chalk.yellow(`Warning: capability plugin rejected (${rejection.code}): ${rejection.pluginId ?? rejection.manifestPath}: ${rejection.message}`));
+            console.error(chalk.yellow(t("Warning: capability plugin rejected ({code}): {target}: {message}", {
+                code: rejection.code,
+                target: rejection.pluginId ?? rejection.manifestPath,
+                message: rejection.message,
+            })));
         }
     }
     time("createAgentSession");
@@ -1549,7 +1585,7 @@ export async function main(args, options) {
     }
     const startupBenchmark = isTruthyEnvFlag(process.env.AGENT_FORGE_STARTUP_BENCHMARK);
     if (startupBenchmark && appMode !== "interactive") {
-        console.error(chalk.red("Error: AGENT_FORGE_STARTUP_BENCHMARK only supports interactive mode"));
+        console.error(chalk.red(t("Error: AGENT_FORGE_STARTUP_BENCHMARK only supports interactive mode")));
         process.exit(1);
     }
     // RPC refreshes catalogs here in the background; interactive mode starts its refresh after TUI initialization.