@armadra/agent 0.5.1 → 0.6.1

package/dist/cli/bootstrap.js

@@ -19,13 +19,17 @@ import { loadHookConfigs } from "../hooks/config.js";
 import { HookDispatcher } from "../hooks/dispatcher.js";
 import { AgentEventBus, createHostApi } from "../host/api-impl.js";
 import { activateHost, disposeHost } from "../host/loader.js";
-import { HELP_TEXT, parseArgs, UsageError } from "./args.js";
+import { helpText, parseArgs, UsageError } from "./args.js";
 import { applyFromOption } from "./from-prompt.js";
 import { ExitCode } from "./exit-codes.js";
 import { applyProfile, applyToolFilters, decideMode, defaultSendUser, instructionSources, resolveModel, sessionRequestOf, sourceOf, step, thinkingOf, toStartupError, } from "./startup-steps.js";
 import { resolveSystemPromptArg } from "./system-prompt-arg.js";
+import { memoryEnvOverride, resolveMemory } from "./compose-memory.js";
+import { msg, resolveLocale, setLocale } from "../i18n/index.js";
 /** §11.1 第 3–14 步。 */
 export async function bootstrap(argsIn, deps, io) {
+    // 文案按调用时的语言取（第 9 步可能按 profile / 项目级 ui.language 补定语言）
+    const m = () => msg().cli.bootstrap;
     const warnings = [];
     const warn = (message) => {
         warnings.push(message);
@@ -43,13 +47,13 @@ export async function bootstrap(argsIn, deps, io) {
     const mode = decideMode(args, io);
     const interactive = mode === "interactive" || mode === "line";
     // 5. 目录
-    const paths = await step(ExitCode.Config, "目录", () => {
+    const paths = await step(ExitCode.Config, m().steps.dirs, () => {
         const resolved = resolvePaths({ env: io.env, cwd: io.cwd, sessionDirFlag: args.sessionDir });
         ensurePaths(resolved);
         return resolved;
     });
     // 6. 用户级 + profile.config
-    const base = await step(ExitCode.Config, "配置", () => {
+    const base = await step(ExitCode.Config, m().steps.config, () => {
         const user = loadConfigFile("config", userFile(paths, CONFIG_FILE));
         if (user !== undefined)
             warnings.push(...user.warnings);
@@ -63,27 +67,27 @@ export async function bootstrap(argsIn, deps, io) {
     let request = sessionRequestOf(args);
     if (request === "pick") {
         if (!interactive || deps.ui?.pickSession === undefined || deps.sessions.list === undefined) {
-            throw new UsageError("--resume 在非交互模式下需要会话 id");
+            throw new UsageError(m().resumeNeedsId);
         }
-        const items = await step(ExitCode.Session, "会话列表", () => deps.sessions.list?.({ sessionDir: paths.sessionDir, cwd: paths.cwd }) ?? []);
+        const items = await step(ExitCode.Session, m().steps.sessionList, () => deps.sessions.list?.({ sessionDir: paths.sessionDir, cwd: paths.cwd }) ?? []);
         const id = await deps.ui.pickSession(items);
         if (id === undefined)
-            throw new StartupError("session_not_found", "未选择会话", ExitCode.Session);
+            throw new StartupError("session_not_found", m().noSessionPicked, ExitCode.Session);
         request = { kind: "resume", id };
     }
     const sessionRequest = request;
-    const sessionManager = await step(ExitCode.Session, "会话", () => deps.sessions.open(sessionRequest, { sessionDir: paths.sessionDir, cwd: paths.cwd }));
+    const sessionManager = await step(ExitCode.Session, m().steps.session, () => deps.sessions.open(sessionRequest, { sessionDir: paths.sessionDir, cwd: paths.cwd }));
     let sessionCwd = sessionManager.cwd;
     if (!existsSync(sessionCwd)) {
         const replacement = interactive ? await deps.ui?.askCwd?.(sessionCwd) : undefined;
         if (replacement === undefined) {
-            throw new StartupError("session_corrupt", `会话的工作目录不存在：${sessionCwd}`, ExitCode.Session);
+            throw new StartupError("session_corrupt", m().sessionCwdMissing(sessionCwd), ExitCode.Session);
         }
         sessionCwd = resolve(replacement);
     }
     const runtimePaths = { ...paths, cwd: sessionCwd };
     // 8. 信任（以会话 cwd 为准）
-    const trust = await step(ExitCode.Config, "信任", () => decideTrust({
+    const trust = await step(ExitCode.Config, m().steps.trust, () => decideTrust({
         cwd: sessionCwd,
         configDir: paths.configDir,
         flag: args.trust,
@@ -92,7 +96,7 @@ export async function bootstrap(argsIn, deps, io) {
         prompt: deps.ui?.promptTrust,
     }));
     // 9. 项目级配置（只能收紧）+ 命令行
-    const merged = await step(ExitCode.Config, "项目配置", () => {
+    const merged = await step(ExitCode.Config, m().steps.projectConfig, () => {
         const project = loadConfigFile("config", projectFile(sessionCwd, CONFIG_FILE));
         if (project !== undefined)
             warnings.push(...project.warnings);
@@ -105,16 +109,21 @@ export async function bootstrap(argsIn, deps, io) {
             tuiMode: args.tuiMode,
             toolsPreset: args.toolsPreset,
             codemode: args.codemode,
+            memory: args.memory ?? memoryEnvOverride(io.env),
         });
     });
     warnings.push(...merged.warnings);
     const config = merged.config;
+    // [W6-C0] main.ts 只看了用户级；profile 的 language 与合并后的 ui.language 在这里补定（AMA_LANG / --lang 仍优先）
+    const language = profile?.language ?? config.ui?.language;
+    if (language === "zh" || language === "en")
+        setLocale(resolveLocale(io.env, { language }, args.lang));
     // 10. 资源发现
     const context = findContextFiles({ cwd: sessionCwd, configDir: paths.configDir });
     warnings.push(...context.warnings);
     const discovered = deps.resources === undefined
         ? { skills: [], prompts: [], warnings: [] }
-        : await step(ExitCode.Config, "Skill 发现", () => deps.resources?.discover({
+        : await step(ExitCode.Config, m().steps.skillDiscovery, () => deps.resources?.discover({
             cwd: sessionCwd,
             configDir: paths.configDir,
             trusted: trust.trusted,
@@ -139,7 +148,7 @@ export async function bootstrap(argsIn, deps, io) {
         instructions,
     };
     // 11. 供应商与模型
-    const providers = await step(ExitCode.Config, "供应商", () => deps.providers.create({
+    const providers = await step(ExitCode.Config, m().steps.providers, () => deps.providers.create({
         config,
         cwd: sessionCwd,
         authFile: args.authFile !== undefined
@@ -157,18 +166,25 @@ export async function bootstrap(argsIn, deps, io) {
             }
             : {}),
     }));
-    const { model, provider } = await step(ExitCode.NoModel, "模型", () => resolveModel(args, providers, sessionManager, config.defaultModel, deps, interactive, io.env));
+    const { model, provider } = await step(ExitCode.NoModel, m().steps.model, () => resolveModel(args, providers, sessionManager, config.defaultModel, deps, interactive, io.env));
     const thinkingLevel = thinkingOf(args, sessionManager, config.thinkingLevel);
     // 12. 工具注册表
-    const tools = await step(ExitCode.RuntimeError, "工具", () => deps.tools.create({
+    const tools = await step(ExitCode.RuntimeError, m().steps.tools, () => deps.tools.create({
         config,
         cwd: sessionCwd,
         mode,
         paths: { configDir: paths.configDir, dataDir: paths.dataDir },
+        memory: resolveMemory({
+            config,
+            cwd: sessionCwd,
+            dataDir: paths.dataDir,
+            trusted: trust.trusted,
+            embedded: profile,
+        }),
     }));
     for (const name of config.tools?.disabled ?? []) {
         if (tools.get(name) === undefined)
-            warn(`config tools.disabled：未知工具 ${name}，已忽略`);
+            warn(m().unknownDisabledTool(name));
         else
             tools.disable(name);
     }
@@ -176,7 +192,7 @@ export async function bootstrap(argsIn, deps, io) {
     let session;
     const events = new AgentEventBus((level, message, detail) => {
         if (level === "warn" || level === "error")
-            warn(`${message}${detail instanceof Error ? `：${detail.message}` : ""}`);
+            warn(m().eventWarning(message, detail instanceof Error ? detail.message : undefined));
     });
     const binding = createHostApi({
         mode,
@@ -191,7 +207,7 @@ export async function bootstrap(argsIn, deps, io) {
         bus: events,
         sendUser: (text, origin) => {
             if (session === undefined)
-                return Promise.reject(new AmaError("busy", "会话尚未就绪"));
+                return Promise.reject(new AmaError("busy", m().sessionNotReady));
             return (deps.sendUser ?? defaultSendUser)(session, text, origin);
         },
         stderr: io.stderr,
@@ -200,7 +216,7 @@ export async function bootstrap(argsIn, deps, io) {
     const hostSpec = args.host;
     let host;
     if (hostSpec !== undefined) {
-        host = await step(ExitCode.HostOrHook, "宿主适配器", () => activateHost({ module: hostSpec, binding, cwd: io.cwd }));
+        host = await step(ExitCode.HostOrHook, m().steps.host, () => activateHost({ module: hostSpec, binding, cwd: io.cwd }));
     }
     let shutdown;
     try {
@@ -209,7 +225,7 @@ export async function bootstrap(argsIn, deps, io) {
         const unattended = mode === "print";
         const builtinDeny = config.permission?.builtinDeny;
         const autoSafeCommands = config.permission?.autoSafeCommands;
-        const permission = await step(ExitCode.Config, "权限", () => deps.permissions.create({
+        const permission = await step(ExitCode.Config, m().steps.permission, () => deps.permissions.create({
             mode: config.permission?.mode ?? "default",
             rules: merged.ruleSpecs,
             unattended,
@@ -285,14 +301,14 @@ export async function bootstrap(argsIn, deps, io) {
             overrides.systemPrompt = systemPrompt;
         if (Object.keys(overrides).length > 0)
             assembly.overrides = overrides;
-        session = await step(ExitCode.RuntimeError, "会话组装", () => deps.session.create(assembly));
+        session = await step(ExitCode.RuntimeError, m().steps.assembly, () => deps.session.create(assembly));
         const active = session;
         let disposed;
         shutdown = (reason) => {
             disposed ??= (async () => {
                 await events.emit("session_shutdown", {});
                 await hooks.run("SessionEnd", { reason }).catch(() => undefined);
-                await disposeHost(host, (e) => warn(`宿主适配器 dispose 失败：${String(e)}`));
+                await disposeHost(host, (e) => warn(m().hostDisposeFailed(String(e))));
                 // 会话被替换过时 dispose 当前那个（旧会话由替换方负责）
                 await (session ?? active).dispose();
             })();
@@ -306,14 +322,18 @@ export async function bootstrap(argsIn, deps, io) {
         });
         const outcome = await hooks.run("SessionStart", { source });
         if (outcome.decision === "block") {
-            throw new StartupError("hook_failed", `SessionStart Hook 阻止启动：${outcome.reason ?? "（无原因）"}`, ExitCode.HostOrHook);
+            throw new StartupError("hook_failed", m().sessionStartBlocked(outcome.reason), ExitCode.HostOrHook);
         }
         sessionStartContext = outcome.additionalContext;
         const finalShutdown = shutdown;
         return {
             mode,
             paths: runtimePaths,
-            config,
+            // [W6-S] /config 换配置：getter 跟随 assembly.config（/new 组装会话读它）
+            get config() {
+                return assembly.config;
+            },
+            replaceConfig: (next) => void (assembly.config = next),
             trust,
             resources,
             providers,
@@ -340,7 +360,7 @@ export async function bootstrap(argsIn, deps, io) {
             await shutdown("exit").catch(() => undefined);
         else
             await disposeHost(host);
-        throw toStartupError(error, ExitCode.RuntimeError, "启动");
+        throw toStartupError(error, ExitCode.RuntimeError, m().steps.startup);
     }
 }
 /** 非交互模式接管 stdout：console.log / info / debug 改写到 stderr；返回还原函数。 */
@@ -362,14 +382,14 @@ export async function runCli(argv, deps, io) {
     try {
         const parsed = parseArgs(argv);
         if (parsed.kind !== "run")
-            throw new UsageError("子命令应由 main 分派");
+            throw new UsageError(msg().cli.bootstrap.subcommandNotDispatched);
         args = parsed.args;
     }
     catch (error) {
         return reportError(error, io);
     }
     if (args.help) {
-        io.stdout(HELP_TEXT);
+        io.stdout(helpText());
         return ExitCode.Ok;
     }
     // [W5-E] --mode acp：装配同 rpc（宿主看到的 mode 也是 rpc），分派到 ACP 服务端
@@ -377,7 +397,7 @@ export async function runCli(argv, deps, io) {
     if (acp)
         args = { ...args, mode: "rpc" };
     if (deps === undefined) {
-        io.stderr("ama: 运行时尚未装配（集成批次通过 registerRuntimeDeps 注入实现）\n");
+        io.stderr(msg().cli.bootstrap.runtimeNotAssembled);
         return ExitCode.RuntimeError;
     }
     let runtime;
@@ -392,7 +412,7 @@ export async function runCli(argv, deps, io) {
     try {
         if (runtime.mode !== "interactive")
             for (const w of runtime.warnings)
-                io.stderr(`ama: 警告：${w}\n`);
+                io.stderr(msg().cli.bootstrap.warning(w));
         // [W4-D] --from：旧会话的一条用户消息作提示（-p 时连图片，临时文件在 finally 删除）。
         const from = applyFromOption(args, runtime, io);
         cleanupFrom = from.cleanup;
@@ -401,7 +421,9 @@ export async function runCli(argv, deps, io) {
             ? (await import("../modes/acp/acp-mode.js")).runAcpMode
             : deps.modes[runtime.mode];
         if (runner === undefined)
-            throw new AmaError("not_implemented", `模式 ${runtime.mode} 尚未装配`, { exitCode: 1 });
+            throw new AmaError("not_implemented", msg().cli.bootstrap.modeNotAssembled(runtime.mode), {
+                exitCode: 1,
+            });
         try {
             return await runner(runtime, context);
         }
@@ -409,7 +431,7 @@ export async function runCli(argv, deps, io) {
             const line = deps.modes.line;
             if (runtime.mode !== "interactive" || !isTerminalInitError(error) || line === undefined)
                 throw error;
-            io.stderr(`ama: 警告：终端初始化失败，降级为行式界面（${error.message}）\n`);
+            io.stderr(msg().cli.bootstrap.terminalFallback(error.message));
             return await line(runtime, context);
         }
     }
@@ -424,7 +446,7 @@ export async function runCli(argv, deps, io) {
 }
 export function reportError(error, io, fallback = ExitCode.RuntimeError) {
     if (error instanceof UsageError) {
-        io.stderr(`ama: ${error.message}\n（ama --help 查看用法）\n`);
+        io.stderr(msg().cli.bootstrap.usageError(error.message));
         return ExitCode.Usage;
     }
     const message = error instanceof Error ? error.message : String(error);

package/dist/cli/choice-prompt.js

@@ -10,6 +10,7 @@
  */
 import { createInterface } from "node:readline/promises";
 import { createTheme, defaultKeybindings, detectCapabilities, padToWidth, resolveAscii, visibleWidth, } from "../tui.js";
+import { msg } from "../i18n/index.js";
 const HIDE_CURSOR = "\x1b[?25l";
 const SHOW_CURSOR = "\x1b[?25h";
 /** 能否用方向键选择：输入是 TTY 且能开 raw。 */
@@ -45,7 +46,7 @@ export function promptChoice(options) {
             const keys = item.keys === undefined ? "" : `  ${theme.fg("dim", item.keys.padEnd(keyWidth))}`;
             return (on ? theme.fg("accent", theme.bold(left)) : left) + keys;
         }),
-        theme.fg("dim", `${g.arrowUp}${g.arrowDown} 选择 · Enter 确认 · 1-${n} 直接选 · Esc 取消`),
+        theme.fg("dim", msg().cli.choicePrompt.hint(`${g.arrowUp}${g.arrowDown}`, n)),
     ];
     const draw = (lines) => {
         const up = drawn > 0 ? `\x1b[${drawn}A` : "";
@@ -66,7 +67,7 @@ export function promptChoice(options) {
             input.off("data", onData);
             input.off("end", onEnd);
             process.off("exit", restore);
-            const answer = index === undefined ? "（已取消）" : items[index].label;
+            const answer = index === undefined ? msg().cli.choicePrompt.cancelled : items[index].label;
             draw([`${question} ${theme.fg("dim", answer)}`]);
             restore();
             input.pause?.();
@@ -113,14 +114,15 @@ export function promptChoice(options) {
  * 否则回落为文本 `继续？[y/N]`（只有 y / yes 算同意）。
  */
 export async function confirmContinue(options = {}) {
-    const question = options.question ?? "继续？";
+    const m = msg().cli.choicePrompt;
+    const question = options.question ?? m.continueQuestion;
     const input = options.input ?? process.stdin;
     if (canPromptChoice(input)) {
         const index = await promptChoice({
             question,
             options: [
-                { label: "继续", keys: "y" },
-                { label: "取消", keys: "n Esc" },
+                { label: m.continue, keys: "y" },
+                { label: m.cancel, keys: "n Esc" },
             ],
             selected: 1,
             input,
@@ -132,7 +134,7 @@ export async function confirmContinue(options = {}) {
     }
     const rl = createInterface({ input, output: options.output ?? process.stderr });
     try {
-        return /^y(es)?$/i.test((await rl.question(`${question}[y/N] `)).trim());
+        return /^y(es)?$/i.test((await rl.question(m.textQuestion(question))).trim());
     }
     finally {
         rl.close();

package/dist/cli/codemode-notice.js

@@ -11,6 +11,7 @@
 import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { resolveCodemodeMode } from "../tools/presets.js";
+import { msg } from "../i18n/index.js";
 export const NOTICES_FILE = "notices.json";
 const KEY = "codemodeNonStrictDefault";
 function readNotices(path) {
@@ -30,8 +31,7 @@ function readNotices(path) {
     return { version: 1 };
 }
 export function codemodeNoticeText(capability) {
-    return (`Node ${capability.nodeMajor} < 25 且没有可用的操作系统沙箱：codemode 沙箱的网络未隔离，codemode 缺省关闭；` +
-        "用 `--codemode on` 或 config 的 codemode.mode 开启（每个配置目录只提示一次）");
+    return msg().cli.codemodeNotice(capability.nodeMajor);
 }
 /** 需要提示时返回文案并记下（之后同一配置目录不再提示）；不需要时 undefined。 */
 export function takeCodemodeNotice(input) {

package/dist/cli/compose-agents.js

@@ -18,6 +18,7 @@ import { agentSources, discoverAgents } from "../agents/discover.js";
 import { NO_AGENT_PROBE_ENV, SessionExternalAgents, registerExternalAgents, } from "../agents/external.js";
 import { hostRunnersOf } from "../host/api-impl.js";
 import { bindTaskAgents } from "../tools/task.js";
+import { msg } from "../i18n/index.js";
 /** 同一装配材料只提示一次（`/new` 等会重新装配会话）。 */
 const warned = new WeakSet();
 export function loadAgentCatalog(deps) {
@@ -33,7 +34,7 @@ export function loadAgentCatalog(deps) {
         for (const warning of found.warnings)
             assembly.warn(warning);
         for (const dir of found.skippedUntrusted)
-            assembly.warn(`项目未信任，跳过子 Agent 定义目录 ${dir}（--trust 后生效）`);
+            assembly.warn(msg().cli.composeAgents.untrustedAgentDir(dir));
     }
     return new AgentCatalog(found.agents);
 }

package/dist/cli/compose-extensions.js

@@ -19,6 +19,7 @@
  * 配置从 `deps.assembly.config` 读（键与校验已在 config/schema-w5.ts，C0 统一加好）。
  */
 import { telemetryFactory } from "../agent/session-telemetry.js";
+import { traceWriterFactory } from "../agent/session-trace-writer.js";
 import { createImageBudgetExtension } from "../agent/session-images.js";
 import { createLimitsExtension } from "../agent/limits.js";
 import { createRemindersExtension, remindersSettings } from "../agent/reminders.js";
@@ -37,6 +38,7 @@ export function composeExtensions(deps) {
         ({ core }) => createImageBudgetExtension(core),
         // [W5-A]  createTelemetryExtension(...)
         telemetryFactory(deps.assembly.config.ui),
+        traceWriterFactory(), // [W6-C0] ama.trace（主会话与子会话都写）
         // [W5-E] 外部 Agent 记账 → SessionStats.external（只主会话）
         ({ core }) => core.depth > 0 ? undefined : createExternalStatsExtension(() => core.manager.branch()),
         createSubagentsFactory(deps), // [W5-G] 子 Agent 任务注册表

package/dist/cli/compose-memory.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 记忆的组装（docs/wave6-plan.md §3、D8、D9、D11、D12）。[W6-M]
+ *
+ * - 开关：独立终端看合并后的 `memory.enabled`（用户级 / profile.config；项目级只能设 false；`--memory` /
+ *   `--no-memory`；`AMA_MEMORY=0|1` 经 bootstrap 并入命令行覆盖，命令行优先）。缺省关闭：不建运行期、不读盘、
+ *   不注册工具、不渲染节。
+ * - 嵌入宿主（有 profile；SDK `createAgentSession`）：只看 `profile.memory = { enabled, dir }`，作用域只有
+ *   `workspace`（= dir），不读用户级；合并配置里显式 `memory.enabled: false`（项目级、`--no-memory`、
+ *   `AMA_MEMORY=0`）仍可关掉。
+ * - 项目作用域要求项目已受信任，否则跳过（`/memory` 提示）。
+ * - 系统节：会话开始（新会话）渲染一次；resume / fork 沿用会话里已有的 `memory` 节；压缩结束后重渲染
+ *   （`compaction_end` 时 `updateSystem`，压缩本就是前缀重置点）；`/memory reload` 显式重渲染。
+ */
+import type { AgentSessionImpl } from "../agent/session.js";
+import type { AgentSession } from "../agent/types.js";
+import type { AmaConfig, ProfileMemoryOptions } from "../config/types.js";
+import { MemoryRuntime } from "../memory/runtime.js";
+import type { SessionManager } from "../session/manager.js";
+/** `AMA_MEMORY=0|1`（也认 true / false / on / off）；其它值或未设 → undefined。 */
+export declare function memoryEnvOverride(env: Readonly<Record<string, string | undefined>>): boolean | undefined;
+export interface MemorySetupInput {
+    config: Pick<AmaConfig, "memory">;
+    cwd: string;
+    dataDir: string;
+    trusted: boolean;
+    /** 嵌入宿主：profile 存在（或 SDK 会话）时给出（`memory` 可缺省 = 禁用）。 */
+    embedded?: {
+        memory?: ProfileMemoryOptions | undefined;
+    } | undefined;
+    today?(): string;
+}
+/** 按配置建运行期；关闭时返回 undefined（什么都不做）。 */
+export declare function resolveMemory(input: MemorySetupInput): MemoryRuntime | undefined;
+/** 会话的记忆运行期（未开启 → undefined）。 */
+export declare function memoryOf(session: AgentSession): MemoryRuntime | undefined;
+/**
+ * 新会话渲染当前索引；会话里已有 system 状态（resume / fork）时沿用其中的 `memory` 节（可能没有）。
+ * 未开启 → undefined。
+ */
+export declare function initialMemorySection(runtime: MemoryRuntime | undefined, manager: Pick<SessionManager, "branch">): string | undefined;
+/** 把 `memory` 节并进静态系统输入（未开启时原样返回同一对象，字节不变）。 */
+export declare function withMemorySection<T extends {
+    memory?: string;
+}>(system: T, runtime: MemoryRuntime | undefined, manager: Pick<SessionManager, "branch">): T;
+/** 会话建好后：登记运行期，压缩结束后重渲染 `memory` 节。 */
+export declare function attachMemory(session: AgentSessionImpl, runtime: MemoryRuntime | undefined): void;
+/**
+ * `/memory reload`：按磁盘重渲染 `memory` 节。返回 undefined = 会话未开启记忆；`changed` = 节有变化
+ * （下次请求产生一条 system 补丁，缓存前缀断一次）。
+ */
+export declare function reloadMemorySection(session: AgentSession): {
+    changed: boolean;
+} | undefined;

package/dist/cli/compose-memory.js

@@ -0,0 +1,127 @@
+/**
+ * 记忆的组装（docs/wave6-plan.md §3、D8、D9、D11、D12）。[W6-M]
+ *
+ * - 开关：独立终端看合并后的 `memory.enabled`（用户级 / profile.config；项目级只能设 false；`--memory` /
+ *   `--no-memory`；`AMA_MEMORY=0|1` 经 bootstrap 并入命令行覆盖，命令行优先）。缺省关闭：不建运行期、不读盘、
+ *   不注册工具、不渲染节。
+ * - 嵌入宿主（有 profile；SDK `createAgentSession`）：只看 `profile.memory = { enabled, dir }`，作用域只有
+ *   `workspace`（= dir），不读用户级；合并配置里显式 `memory.enabled: false`（项目级、`--no-memory`、
+ *   `AMA_MEMORY=0`）仍可关掉。
+ * - 项目作用域要求项目已受信任，否则跳过（`/memory` 提示）。
+ * - 系统节：会话开始（新会话）渲染一次；resume / fork 沿用会话里已有的 `memory` 节；压缩结束后重渲染
+ *   （`compaction_end` 时 `updateSystem`，压缩本就是前缀重置点）；`/memory reload` 显式重渲染。
+ */
+import { AmaError } from "../errors.js";
+import { projectRootOf, standaloneRoots } from "../memory/paths.js";
+import { MemoryRuntime } from "../memory/runtime.js";
+import { DEFAULT_MEMORY_LIMITS, MemoryStore } from "../memory/store.js";
+import { replaySystem } from "../session/projection.js";
+/** `AMA_MEMORY=0|1`（也认 true / false / on / off）；其它值或未设 → undefined。 */
+export function memoryEnvOverride(env) {
+    const raw = env["AMA_MEMORY"]?.trim().toLowerCase();
+    if (raw === "1" || raw === "true" || raw === "on")
+        return true;
+    if (raw === "0" || raw === "false" || raw === "off")
+        return false;
+    return undefined;
+}
+/** 按配置建运行期；关闭时返回 undefined（什么都不做）。 */
+export function resolveMemory(input) {
+    const config = input.config.memory ?? {};
+    const limits = {
+        indexMaxBytes: config.indexMaxBytes ?? DEFAULT_MEMORY_LIMITS.indexMaxBytes,
+        fileMaxBytes: config.fileMaxBytes ?? DEFAULT_MEMORY_LIMITS.fileMaxBytes,
+        maxFiles: config.maxFiles ?? DEFAULT_MEMORY_LIMITS.maxFiles,
+    };
+    const subagents = config.subagents ?? "read";
+    const storeOptions = input.today === undefined ? {} : { today: input.today };
+    if (input.embedded !== undefined) {
+        const profile = input.embedded.memory;
+        if (profile?.enabled !== true || config.enabled === false)
+            return undefined;
+        if (profile.dir === undefined || profile.dir === "")
+            throw new AmaError("invalid_arguments", "memory.enabled is true but memory.dir is missing (embedded hosts must give a per-workspace directory)");
+        const roots = { workspace: profile.dir };
+        return new MemoryRuntime(new MemoryStore(roots, limits, storeOptions), {
+            subagents,
+            embedded: true,
+        });
+    }
+    if (config.enabled !== true)
+        return undefined;
+    const scopes = config.scopes ?? ["user", "project"];
+    const skipped = [];
+    let projectRoot;
+    if (scopes.includes("project")) {
+        if (input.trusted)
+            projectRoot = projectRootOf(input.cwd);
+        else
+            skipped.push({ scope: "project", reason: "untrusted" });
+    }
+    const roots = standaloneRoots({
+        dataDir: input.dataDir,
+        projectRoot,
+        user: scopes.includes("user"),
+    });
+    const store = new MemoryStore(roots, limits, {
+        ...storeOptions,
+        ...(projectRoot === undefined ? {} : { projectRoot }),
+    });
+    return new MemoryRuntime(store, {
+        subagents,
+        embedded: false,
+        skipped,
+        ...(projectRoot === undefined ? {} : { projectRoot }),
+    });
+}
+const attached = new WeakMap();
+/** 会话的记忆运行期（未开启 → undefined）。 */
+export function memoryOf(session) {
+    return attached.get(session);
+}
+/**
+ * 新会话渲染当前索引；会话里已有 system 状态（resume / fork）时沿用其中的 `memory` 节（可能没有）。
+ * 未开启 → undefined。
+ */
+export function initialMemorySection(runtime, manager) {
+    if (runtime === undefined)
+        return undefined;
+    const messages = manager
+        .branch()
+        .flatMap((entry) => (entry.type === "message" ? [entry.message] : []));
+    const existing = replaySystem(messages);
+    if (existing !== undefined)
+        return existing.sections["memory"];
+    return runtime.renderSection();
+}
+/** 把 `memory` 节并进静态系统输入（未开启时原样返回同一对象，字节不变）。 */
+export function withMemorySection(system, runtime, manager) {
+    const section = initialMemorySection(runtime, manager);
+    return section === undefined ? system : { ...system, memory: section };
+}
+/** 会话建好后：登记运行期，压缩结束后重渲染 `memory` 节。 */
+export function attachMemory(session, runtime) {
+    if (runtime === undefined)
+        return;
+    attached.set(session, runtime);
+    session.subscribe((event) => {
+        if (event.type === "compaction_end" && event.result !== undefined)
+            session.updateSystem({ memory: runtime.renderSection() ?? "" });
+    });
+}
+/**
+ * `/memory reload`：按磁盘重渲染 `memory` 节。返回 undefined = 会话未开启记忆；`changed` = 节有变化
+ * （下次请求产生一条 system 补丁，缓存前缀断一次）。
+ */
+export function reloadMemorySection(session) {
+    const runtime = memoryOf(session);
+    if (runtime === undefined)
+        return undefined;
+    const impl = session;
+    const before = impl.childBase().system?.memory;
+    const next = runtime.renderSection() ?? "";
+    if ((before ?? "") === next)
+        return { changed: false };
+    impl.updateSystem({ memory: next });
+    return { changed: true };
+}

package/dist/cli/compose-providers.d.ts

@@ -9,6 +9,10 @@
  * - SDK 追加的供应商（`ProviderData[]`）折成 `config.providers` 条目，走同一条合并路径。
  * - 零配置（设计 §10.0）：没有 `defaultModel`、也没有任何需要 key 的供应商配了 key 时，探测本地
  *   ollama / lmstudio（短超时），把枚举到的模型加进注册表，供 `pickDefaultModel` 选用。
+ * - [W6-O] ChatGPT 登录（docs/wave6-plan.md D14）：`chatgpt` 的缺省渠道按 auth.json 条目的 flavor 定（用户写了
+ *   `defaultChannel` 时不动）；`AMA_CHATGPT_BASE_URL` 改该渠道地址；`auth.chatgpt.originator` 改 codex 渠道的
+ *   `originator` 头；OAuth 刷新拿到 `auth.chatgpt` 配置与同一份 env。
+ * - 发现缓存（`<dataDir>/models/discovered/<provider>.json`）并入模型表为空的供应商（discovered-cache.ts）。
  */
 import type { ApiRegistry } from "../ai/apis/api.js";
 import { ProviderRegistry } from "../ai/providers/registry.js";
@@ -32,6 +36,8 @@ export interface ProviderComposeOptions {
 }
 export declare function providerConfigOf(provider: ProviderData): ProviderConfig;
 export declare function withExtraProviders(config: AmaConfig, providers: readonly ProviderData[] | undefined): AmaConfig;
+/** [W6-O] 按 auth.json 的 ChatGPT 条目与 `AMA_CHATGPT_BASE_URL` / `auth.chatgpt.originator` 补 chatgpt 的渠道配置。 */
+export declare function withChatGptChannels(config: AmaConfig, authFile: string, env: Readonly<Record<string, string | undefined>>): AmaConfig;
 export declare function buildProviderRegistry(input: ProviderBuildInput, options?: ProviderComposeOptions): Promise<ProviderRegistry>;
 /** 本地服务（无需 key、模型表为空）的模型枚举；连不上静默跳过。 */
 export declare function probeLocalProviders(registry: ProviderRegistry, timeoutMs?: number): Promise<string[]>;