@armadra/agent 0.5.1 → 0.6.0

package/dist/config/schema.js

@@ -6,8 +6,10 @@
  * （未知字段等）。`path` 是 JSON 指针风格的字段路径（`permission.mode`、`hooks.PreToolUse[0]`）。
  */
 import { isAbsolute } from "node:path";
+import { msg } from "../i18n/index.js";
 import { Checker, THINKING_LEVELS, checkSection, join, } from "./checker.js";
 import { W5_COMPACTION_KEYS, W5_CONFIG_KEYS, W5_UI_KEYS, checkCompactionW5, checkUiW5, validateConfigW5, } from "./schema-w5.js";
+import { W6_CONFIG_KEYS, W6_UI_KEYS, checkOAuthEntry, checkProfileMemory, checkUiW6, validateConfigW6, } from "./schema-w6.js";
 import { HOOK_EVENTS } from "../hooks/types.js";
 import { PERMISSION_MODES_STRICT_FIRST } from "../permissions/types.js";
 import { WARMING_MODES } from "../ai/cache/types.js";
@@ -40,6 +42,7 @@ const CONFIG_KEYS = [
     "checkpoints",
     "sandbox",
     ...W5_CONFIG_KEYS,
+    ...W6_CONFIG_KEYS,
     "$schema",
 ];
 const PROVIDER_KEYS = [
@@ -69,7 +72,7 @@ function checkModels(c, value, path, channels) {
     if (value === undefined)
         return;
     if (!Array.isArray(value)) {
-        c.error(path, "应为数组");
+        c.error(path, msg().config.schema.array);
         return;
     }
     value.forEach((item, index) => {
@@ -88,7 +91,7 @@ function checkModels(c, value, path, channels) {
         if (modelsDev !== undefined &&
             modelsDev !== false &&
             (typeof modelsDev !== "string" || !/^[^/]+\/.+$/.test(modelsDev))) {
-            c.error(join(p, "modelsDev"), `应为 "provider/model" 或 false`);
+            c.error(join(p, "modelsDev"), msg().config.schema.modelsDev);
         }
         c.stringArray(item, "channels", p);
         const used = item["channels"];
@@ -97,9 +100,9 @@ function checkModels(c, value, path, channels) {
                 if (typeof name !== "string")
                     return;
                 if (channels === undefined)
-                    c.error(join(join(p, "channels"), i), "供应商没有 channels");
+                    c.error(join(join(p, "channels"), i), msg().config.schema.noChannels);
                 else if (!channels.has(name))
-                    c.error(join(join(p, "channels"), i), `渠道 "${name}" 不存在（可用：${[...channels].join(", ")}）`);
+                    c.error(join(join(p, "channels"), i), msg().config.schema.unknownChannelOf(name, [...channels]));
             });
         }
         const promptCache = item["promptCache"];
@@ -112,7 +115,7 @@ function checkModels(c, value, path, channels) {
         const input = item["input"];
         if (input !== undefined &&
             (!Array.isArray(input) || input.some((m) => m !== "text" && m !== "image"))) {
-            c.error(join(p, "input"), `应为 ("text" | "image")[]`);
+            c.error(join(p, "input"), msg().config.schema.modelInput);
         }
     });
 }
@@ -142,7 +145,7 @@ function checkChannels(c, value, path, builtin) {
     for (const [name, channel] of Object.entries(channels)) {
         const p = join(cp, name);
         if (!CHANNEL_NAME_PATTERN.test(name)) {
-            c.error(p, "渠道名只能含字母、数字、_ 与 -（不含 / 与 @），最长 32");
+            c.error(p, msg().config.schema.channelName);
             continue;
         }
         names.add(name);
@@ -158,7 +161,7 @@ function checkChannels(c, value, path, builtin) {
         checkCompat(c, channel["compat"], join(p, "compat"));
     }
     if (names.size === 0 && Object.keys(channels).length === 0)
-        c.error(cp, "至少要有一个渠道");
+        c.error(cp, msg().config.schema.atLeastOneChannel);
     checkDefaultChannel(c, value, path, names);
     return names;
 }
@@ -167,9 +170,9 @@ function checkDefaultChannel(c, value, path, names) {
     if (preferred === undefined)
         return;
     if (typeof preferred !== "string")
-        c.error(join(path, "defaultChannel"), "应为字符串");
+        c.error(join(path, "defaultChannel"), msg().config.schema.string);
     else if (!names.has(preferred))
-        c.error(join(path, "defaultChannel"), `渠道 "${preferred}" 不存在`);
+        c.error(join(path, "defaultChannel"), msg().config.schema.unknownChannel(preferred));
 }
 function checkProvider(c, value, path, id) {
     if (!c.object(value, path))
@@ -186,7 +189,7 @@ function checkProvider(c, value, path, id) {
     const builtin = BUILTIN_PROVIDERS.find((p) => p.id === id)?.channels?.map((ch) => ch.name);
     const channels = checkChannels(c, value, path, builtin ?? []);
     if (channels === undefined && value["defaultChannel"] !== undefined)
-        c.error(join(path, "defaultChannel"), "没有 channels 时不能设 defaultChannel");
+        c.error(join(path, "defaultChannel"), msg().config.schema.defaultChannelWithoutChannels);
     checkModels(c, value["models"], join(path, "models"), channels);
     checkModels(c, value["modelOverrides"], join(path, "modelOverrides"), channels);
 }
@@ -215,7 +218,7 @@ export function validateConfig(value) {
         if (builtinDeny !== undefined &&
             typeof builtinDeny !== "boolean" &&
             (!Array.isArray(builtinDeny) || builtinDeny.some((item) => typeof item !== "string"))) {
-            c.error(join(p, "builtinDeny"), "应为布尔值或字符串数组");
+            c.error(join(p, "builtinDeny"), msg().config.schema.builtinDeny);
         }
     });
     const compactionKeys = ["enabled", "reserveTokens", "keepRecentTokens", ...W5_COMPACTION_KEYS];
@@ -257,6 +260,7 @@ export function validateConfig(value) {
         "animation",
         "restoreOnCancel",
         ...W5_UI_KEYS,
+        ...W6_UI_KEYS,
     ], (s, p) => {
         c.oneOf(s, "theme", p, ["dark", "light", "auto"]);
         c.boolean(s, "markdown", p);
@@ -268,6 +272,7 @@ export function validateConfig(value) {
         c.boolean(s, "animation", p);
         c.boolean(s, "restoreOnCancel", p);
         checkUiW5(c, s, p);
+        checkUiW6(c, s, p);
     });
     checkSection(c, value, "skills", ["dirs"], (s, p) => c.stringArray(s, "dirs", p));
     checkSection(c, value, "request", ["idleTimeoutMs"], (s, p) => {
@@ -287,7 +292,7 @@ export function validateConfig(value) {
         if (Array.isArray(writable))
             writable.forEach((item, i) => {
                 if (typeof item === "string" && !isAbsolute(item) && item !== "~" && !item.startsWith("~/"))
-                    c.warn(`${p}.writable[${i}]`, "应为绝对路径或 ~/…，已忽略");
+                    c.warn(`${p}.writable[${i}]`, msg().config.schema.writablePath);
             });
     });
     checkSection(c, value, "cache", ["warming", "retention", "minSavingsUsd", "missNotices", "warmSubagents"], (s, p) => {
@@ -298,6 +303,7 @@ export function validateConfig(value) {
         c.boolean(s, "warmSubagents", p);
     });
     validateConfigW5(c, value);
+    validateConfigW6(c, value);
     return c.diagnostics;
 }
 // ---------------------------------------------------------------------------
@@ -311,7 +317,7 @@ export function validateAuthFile(value) {
     c.keys(value, "", ["version", "providers"]);
     const providers = value["providers"];
     if (providers === undefined) {
-        c.error("providers", "缺少 providers");
+        c.error("providers", msg().config.schema.providersMissing);
         return c.diagnostics;
     }
     if (!c.object(providers, "providers"))
@@ -320,6 +326,10 @@ export function validateAuthFile(value) {
         const p = join("providers", id);
         if (!c.object(entry, p))
             continue;
+        if (entry["type"] === "oauth") {
+            checkOAuthEntry(c, entry, p);
+            continue;
+        }
         c.keys(entry, p, ["apiKey", "env", "baseUrl"]);
         c.string(entry, "apiKey", p, true);
         c.stringRecord(entry, "env", p);
@@ -351,6 +361,8 @@ export function validateProfile(value) {
         ...PROFILE_PATH_LIST_FIELDS,
         "authEnv",
         "trustProject",
+        "language",
+        "memory",
         "$schema",
     ]);
     for (const key of PROFILE_PATH_FIELDS)
@@ -359,6 +371,8 @@ export function validateProfile(value) {
         c.stringArray(value, key, "");
     c.boolean(value, "authEnv", "");
     c.boolean(value, "trustProject", "");
+    c.oneOf(value, "language", "", ["zh", "en"]);
+    checkProfileMemory(c, value);
     return c.diagnostics;
 }
 export function validateTrustFile(value) {
@@ -368,7 +382,7 @@ export function validateTrustFile(value) {
     c.version(value, "");
     const entries = value["entries"];
     if (!Array.isArray(entries)) {
-        c.error("entries", "应为数组");
+        c.error("entries", msg().config.schema.array);
         return c.diagnostics;
     }
     entries.forEach((entry, index) => {
@@ -378,7 +392,7 @@ export function validateTrustFile(value) {
         c.string(entry, "path", p, true);
         c.string(entry, "at", p, true);
         if (typeof entry["trusted"] !== "boolean")
-            c.error(join(p, "trusted"), "应为布尔值");
+            c.error(join(p, "trusted"), msg().config.schema.boolean);
     });
     return c.diagnostics;
 }
@@ -396,11 +410,11 @@ export function validateHookConfig(value) {
     for (const [event, groups] of Object.entries(hooks)) {
         const p = join("hooks", event);
         if (!HOOK_EVENTS.includes(event)) {
-            c.error(p, `未知事件（可用：${HOOK_EVENTS.join(", ")}）`);
+            c.error(p, msg().config.schema.hookEvent(HOOK_EVENTS));
             continue;
         }
         if (!Array.isArray(groups)) {
-            c.error(p, "应为数组");
+            c.error(p, msg().config.schema.array);
             continue;
         }
         groups.forEach((group, gi) => {
@@ -411,7 +425,7 @@ export function validateHookConfig(value) {
             c.string(group, "matcher", gp);
             const commands = group["hooks"];
             if (!Array.isArray(commands)) {
-                c.error(join(gp, "hooks"), "应为数组");
+                c.error(join(gp, "hooks"), msg().config.schema.array);
                 return;
             }
             commands.forEach((command, ci) => {
@@ -420,10 +434,10 @@ export function validateHookConfig(value) {
                     return;
                 c.keys(command, cp, ["type", "command", "timeoutMs"]);
                 if (command["type"] !== "command")
-                    c.error(join(cp, "type"), `type 必须为 "command"`);
+                    c.error(join(cp, "type"), msg().config.schema.hookType);
                 c.string(command, "command", cp, true);
                 if (typeof command["command"] === "string" && command["command"].trim() === "") {
-                    c.error(join(cp, "command"), "命令为空");
+                    c.error(join(cp, "command"), msg().config.schema.hookCommandEmpty);
                 }
                 c.number(command, "timeoutMs", cp, 1, HOOK_TIMEOUT_MAX_MS);
             });

package/dist/config/settings-registry.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Settings registry (docs/wave6-plan.md §6.1, D24-D26). [W6-S]
+ *
+ * One row per key that the `/config` panel and `ama config set` treat as a scalar setting: group, apply
+ * tier (now / next session / restart), whether it changes the cache prefix, project-level writability
+ * (same rule as `restrictProjectConfig`, cross-checked by settings-registry.test.ts) and the env var that
+ * overrides it. Kind and enum options are derived from `buildConfigJsonSchema()` -- the table never
+ * repeats them; only `model` / `text` / `optionalNumber` refine the schema type.
+ *
+ * Keys that are lists or objects (providers, permission rules, tool lists, dirs, agents.<id>, hooks,
+ * auth) are not panel rows; `SETTING_HINTS` points to where they are edited instead.
+ */
+export type SettingGroup = "ui" | "model" | "permission" | "tools" | "context" | "session" | "sandbox" | "agents" | "memory";
+export declare const SETTING_GROUPS: readonly SettingGroup[];
+/** `text` is a free string (`ui.replyLanguage`); `optionalNumber` may also be unset / a keyword. */
+export type SettingKind = "bool" | "enum" | "number" | "optionalNumber" | "model" | "text";
+export type SettingApply = "now" | "nextSession" | "restart";
+/** deny: user / profile only; tighten: project may only make it stricter; any: project may set it. */
+export type ProjectWritability = "deny" | "tighten" | "any";
+export interface SettingSpec {
+    key: string;
+    group: SettingGroup;
+    kind: SettingKind;
+    /** Enum values (from the JSON Schema). */
+    options?: readonly string[];
+    /** Words accepted besides numbers (`compaction.prune.clearAtLeast: "auto"`). */
+    keywords?: readonly string[];
+    minimum?: number;
+    maximum?: number;
+    apply: SettingApply;
+    /** Changing it changes the cache prefix (system prompt, tool table or model). */
+    prefix?: boolean;
+    project: ProjectWritability;
+    /** Env var that overrides the value (the row shows as locked while it is set). */
+    envOverride?: string;
+}
+/** Keys edited elsewhere: key prefix -> hint id (messages `settings.hints`). */
+export declare const SETTING_HINTS: readonly [{
+    readonly key: "providers";
+    readonly hint: "providers";
+}, {
+    readonly key: "permission.allow";
+    readonly hint: "permissionRules";
+}, {
+    readonly key: "tools.default";
+    readonly hint: "tools";
+}, {
+    readonly key: "skills.dirs";
+    readonly hint: "dirs";
+}, {
+    readonly key: "sandbox.writable";
+    readonly hint: "sandboxWritable";
+}, {
+    readonly key: "agents.<id>";
+    readonly hint: "agents";
+}, {
+    readonly key: "hooks";
+    readonly hint: "hooks";
+}, {
+    readonly key: "auth.chatgpt";
+    readonly hint: "auth";
+}];
+export type SettingHintId = (typeof SETTING_HINTS)[number]["hint"];
+type Schema = Record<string, unknown>;
+/** Schema node of a dotted key (undefined when the key is not in the schema). */
+export declare function schemaAt(key: string, root?: Schema): Schema | undefined;
+/** All settings, panel order. */
+export declare function settingsRegistry(): readonly SettingSpec[];
+export declare function settingSpec(key: string): SettingSpec | undefined;
+/** Keys `ama config set` accepts (documented leaves minus file metadata). */
+export declare function settableKeys(): string[];
+/** Built-in default of a key (undefined when it is unset or decided at run time). */
+export declare function settingDefault(key: string): unknown;
+/** Description of a key in the UI language (`keyDoc`, [W6-I4]). */
+export declare function settingDoc(key: string): string | undefined;
+/** Rule text for a key whose default is decided at run time, in the UI language. */
+export declare function settingDynamicDefault(key: string): string | undefined;
+export {};

package/dist/config/settings-registry.js

@@ -0,0 +1,184 @@
+/**
+ * Settings registry (docs/wave6-plan.md §6.1, D24-D26). [W6-S]
+ *
+ * One row per key that the `/config` panel and `ama config set` treat as a scalar setting: group, apply
+ * tier (now / next session / restart), whether it changes the cache prefix, project-level writability
+ * (same rule as `restrictProjectConfig`, cross-checked by settings-registry.test.ts) and the env var that
+ * overrides it. Kind and enum options are derived from `buildConfigJsonSchema()` -- the table never
+ * repeats them; only `model` / `text` / `optionalNumber` refine the schema type.
+ *
+ * Keys that are lists or objects (providers, permission rules, tool lists, dirs, agents.<id>, hooks,
+ * auth) are not panel rows; `SETTING_HINTS` points to where they are edited instead.
+ */
+import { buildConfigJsonSchema } from "./json-schema.js";
+import { defaultFor, documentedLeaves, dynamicDefaults, isDynamicDefault, keyDoc, } from "./key-docs.js";
+export const SETTING_GROUPS = [
+    "ui",
+    "model",
+    "permission",
+    "tools",
+    "context",
+    "session",
+    "sandbox",
+    "agents",
+    "memory",
+];
+const row = (key, group, apply, project, extra = {}) => ({ key, group, apply, project, ...extra });
+/** Panel order = table order. */
+const ROWS = [
+    row("ui.theme", "ui", "restart", "any"),
+    row("ui.markdown", "ui", "now", "any"),
+    row("ui.showThinking", "ui", "now", "any"),
+    row("ui.compact", "ui", "now", "any"),
+    row("ui.animation", "ui", "now", "any"),
+    row("ui.statusLine", "ui", "now", "any"),
+    row("ui.restoreOnCancel", "ui", "nextSession", "any"),
+    row("ui.quietStartup", "ui", "restart", "any"),
+    row("ui.ascii", "ui", "restart", "any", { envOverride: "AMA_ASCII" }),
+    row("ui.language", "ui", "restart", "any", { envOverride: "AMA_LANG" }),
+    row("ui.replyLanguage", "ui", "nextSession", "deny", { kind: "text", prefix: true }),
+    row("ui.agentBar", "ui", "restart", "any"),
+    row("defaultModel", "model", "now", "deny", { kind: "model", prefix: true }),
+    row("thinkingLevel", "model", "now", "deny", { prefix: true }),
+    row("fallbackModel", "model", "nextSession", "deny", { kind: "model" }),
+    row("plan.model", "model", "nextSession", "deny", { kind: "model" }),
+    row("plan.thinkingLevel", "model", "nextSession", "deny"),
+    row("subagents.defaultModel", "model", "nextSession", "deny", { kind: "model" }),
+    row("models.aliases.fast", "model", "nextSession", "deny", { kind: "model" }),
+    row("models.aliases.strong", "model", "nextSession", "deny", { kind: "model" }),
+    row("permission.mode", "permission", "now", "tighten"),
+    row("permission.autoModel", "permission", "nextSession", "deny", { kind: "model" }),
+    row("plan.bash", "permission", "nextSession", "tighten"),
+    row("plan.unattended", "permission", "nextSession", "deny"),
+    row("tools.preset", "tools", "restart", "tighten", { prefix: true }),
+    row("codemode.mode", "tools", "restart", "tighten", { prefix: true }),
+    row("codemode.inlineBudget", "tools", "restart", "deny", { prefix: true }),
+    row("codemode.requireStrict", "tools", "restart", "deny"),
+    row("tools.maxToolResultChars", "tools", "nextSession", "deny"),
+    row("tools.bashTimeoutMs", "tools", "restart", "deny"),
+    row("images.resize", "tools", "restart", "deny"),
+    row("hooks.timeoutMs", "tools", "restart", "deny"),
+    row("compaction.enabled", "context", "now", "any"),
+    row("compaction.reserveTokens", "context", "nextSession", "any"),
+    row("compaction.keepRecentTokens", "context", "nextSession", "any"),
+    row("compaction.prune.keepResults", "context", "nextSession", "deny"),
+    row("compaction.prune.clearAtLeast", "context", "nextSession", "deny"),
+    row("cache.warming", "context", "now", "deny", { envOverride: "AMA_CACHE_WARMING" }),
+    row("cache.retention", "context", "nextSession", "deny", { envOverride: "AMA_CACHE_RETENTION" }),
+    row("cache.minSavingsUsd", "context", "nextSession", "deny"),
+    row("cache.missNotices", "context", "nextSession", "deny"),
+    row("cache.warmSubagents", "context", "nextSession", "deny"),
+    row("request.idleTimeoutMs", "context", "nextSession", "deny", {
+        envOverride: "AMA_IDLE_TIMEOUT_MS",
+    }),
+    row("retry.enabled", "context", "now", "deny"),
+    row("retry.maxRetries", "context", "nextSession", "deny"),
+    row("retry.baseDelayMs", "context", "nextSession", "deny"),
+    row("retry.maxDelayMs", "context", "nextSession", "deny"),
+    row("limits.maxTurns", "session", "nextSession", "deny", { kind: "optionalNumber" }),
+    row("limits.maxCostUsd", "session", "nextSession", "deny", { kind: "optionalNumber" }),
+    row("reminders.todo", "session", "nextSession", "any"),
+    row("reminders.fileChanges", "session", "nextSession", "any"),
+    row("reminders.contextPressure", "session", "nextSession", "any"),
+    row("reminders.budget", "session", "nextSession", "any"),
+    row("todo.reminder", "session", "nextSession", "deny"),
+    row("checkpoints.mode", "session", "restart", "tighten", { envOverride: "AMA_CHECKPOINTS" }),
+    row("checkpoints.maxFileBytes", "session", "restart", "tighten"),
+    row("checkpoints.keep", "session", "restart", "deny"),
+    row("sandbox.enabled", "sandbox", "restart", "deny", { envOverride: "AMA_SANDBOX" }),
+    row("sandbox.bash", "sandbox", "restart", "deny"),
+    row("sandbox.network", "sandbox", "restart", "tighten"),
+    row("agents.maxConcurrent", "agents", "restart", "deny"),
+    row("agents.sessionBudgetUsd", "agents", "nextSession", "deny", { kind: "optionalNumber" }),
+    row("subagents.maxConcurrent", "agents", "nextSession", "deny"),
+    row("subagents.maxPending", "agents", "nextSession", "deny"),
+    // [W6-M]
+    row("memory.enabled", "memory", "nextSession", "tighten", { envOverride: "AMA_MEMORY" }),
+    row("memory.subagents", "memory", "nextSession", "deny"),
+];
+/** Keys edited elsewhere: key prefix -> hint id (messages `settings.hints`). */
+export const SETTING_HINTS = [
+    { key: "providers", hint: "providers" },
+    { key: "permission.allow", hint: "permissionRules" },
+    { key: "tools.default", hint: "tools" },
+    { key: "skills.dirs", hint: "dirs" },
+    { key: "sandbox.writable", hint: "sandboxWritable" },
+    { key: "agents.<id>", hint: "agents" },
+    { key: "hooks", hint: "hooks" },
+    { key: "auth.chatgpt", hint: "auth" },
+];
+/** Schema node of a dotted key (undefined when the key is not in the schema). */
+export function schemaAt(key, root = buildConfigJsonSchema()) {
+    let node = root;
+    for (const part of key.split(".")) {
+        const properties = node?.["properties"];
+        node = properties?.[part];
+        if (node === undefined)
+            return undefined;
+    }
+    return node;
+}
+function numberBounds(schema) {
+    const out = {};
+    if (typeof schema["minimum"] === "number")
+        out.minimum = schema["minimum"];
+    if (typeof schema["maximum"] === "number")
+        out.maximum = schema["maximum"];
+    return out;
+}
+/** Fill kind / options / bounds from the schema node. */
+function derive(entry, root) {
+    const schema = schemaAt(entry.key, root);
+    if (schema === undefined)
+        throw new Error(`settings registry: ${entry.key} is not in the schema`);
+    const spec = { ...entry, kind: entry.kind ?? "text" };
+    const anyOf = schema["anyOf"];
+    if (schema["type"] === "boolean")
+        spec.kind = "bool";
+    else if (Array.isArray(schema["enum"])) {
+        spec.kind = "enum";
+        spec.options = schema["enum"];
+    }
+    else if (schema["type"] === "number") {
+        if (entry.kind !== "optionalNumber")
+            spec.kind = "number";
+        Object.assign(spec, numberBounds(schema));
+    }
+    else if (anyOf !== undefined) {
+        spec.kind = "optionalNumber";
+        spec.keywords = anyOf.flatMap((s) => (typeof s["const"] === "string" ? [s["const"]] : []));
+        const numeric = anyOf.find((s) => s["type"] === "number");
+        if (numeric !== undefined)
+            Object.assign(spec, numberBounds(numeric));
+    }
+    return spec;
+}
+let cache;
+/** All settings, panel order. */
+export function settingsRegistry() {
+    if (cache === undefined) {
+        const root = buildConfigJsonSchema();
+        cache = Object.freeze(ROWS.map((entry) => Object.freeze(derive(entry, root))));
+    }
+    return cache;
+}
+export function settingSpec(key) {
+    return settingsRegistry().find((spec) => spec.key === key);
+}
+/** Keys `ama config set` accepts (documented leaves minus file metadata). */
+export function settableKeys() {
+    return documentedLeaves().filter((key) => key !== "$schema" && key !== "version");
+}
+/** Built-in default of a key (undefined when it is unset or decided at run time). */
+export function settingDefault(key) {
+    return isDynamicDefault(key) ? undefined : defaultFor(key);
+}
+/** Description of a key in the UI language (`keyDoc`, [W6-I4]). */
+export function settingDoc(key) {
+    return keyDoc(key);
+}
+/** Rule text for a key whose default is decided at run time, in the UI language. */
+export function settingDynamicDefault(key) {
+    const rules = dynamicDefaults();
+    return Object.hasOwn(rules, key) ? rules[key] : undefined;
+}

package/dist/config/types-w6.d.ts

@@ -0,0 +1,109 @@
+/**
+ * 第六波配置键的形状（docs/wave6-plan.md §7、§1.3、§3.1、§4.3、§4.4、§5.2）。[W6-C0] 契约文件：C0 只定形状、
+ * 校验（schema-w6.ts）、说明与缺省（key-docs.ts）、JSON Schema；行为由各批次实现，未实现前这些键被接受但不起作用。
+ *
+ * 层级（merge.ts）：项目级可设 `ui.language`、`ui.agentBar`，`memory` 只接受 `enabled: false`；`ui.replyLanguage`、
+ * `memory` 其余键、`auth` 只认用户级 / profile（项目级忽略并 warning）。
+ */
+/** `ui.language`：auto 按 `LC_ALL` / `LC_MESSAGES` / `LANG` 判断，判断不出用 en（docs/i18n.md）。 */
+export type LanguageSetting = "auto" | "zh" | "en";
+export declare const LANGUAGE_SETTINGS: readonly LanguageSetting[];
+/** [W6-A] Agent 栏：auto 有任务时显示；off 不显示（嵌入宿主缺省 off）。 */
+export type AgentBarMode = "auto" | "off";
+export declare const AGENT_BAR_MODES: readonly AgentBarMode[];
+/** 第六波在 `ui` 段新增的键。 */
+export interface UiConfigW6 {
+    /** 界面语言，缺省 auto；`AMA_LANG` / `--lang` 覆盖；项目级可设。 */
+    language?: LanguageSetting;
+    /**
+     * [D22] 模型回复语言（如 `Chinese`）：设置时会话开始在 `rules` 节末尾追加一句英文规则；不设零字节变化。
+     * 只认用户级 / profile。
+     */
+    replyLanguage?: string;
+    /** [W6-A] Agent 栏，缺省 auto；嵌入宿主（有 profile）缺省 off。 */
+    agentBar?: AgentBarMode;
+}
+/** [W6-M] 记忆作用域：独立终端 user / project；嵌入宿主只有 workspace（profile.memory.dir）。 */
+export type MemoryScopeName = "user" | "project";
+export declare const MEMORY_SCOPES: readonly MemoryScopeName[];
+export declare const MEMORY_SUBAGENT_MODES: readonly ["off", "read"];
+/** [W6-M] `memory` 段（docs/wave6-plan.md §3.1）。缺省关闭；关闭时系统提示、工具表、请求体逐字节不变。 */
+export interface MemoryConfig {
+    /** 总开关，缺省 false；项目级只能设为 false；`--memory` / `--no-memory`、`AMA_MEMORY=0|1` 覆盖。 */
+    enabled?: boolean;
+    /** 启用的作用域，缺省 ["user", "project"]。 */
+    scopes?: MemoryScopeName[];
+    /** 每作用域索引注入的硬顶（字节），缺省 4096。 */
+    indexMaxBytes?: number;
+    /** 单条记忆上限（字节），超出拒写，缺省 16384。 */
+    fileMaxBytes?: number;
+    /** 每作用域条目上限，缺省 200。 */
+    maxFiles?: number;
+    /** 子会话：read（缺省，写命令执行层拒绝）/ off（view 也拒绝）。 */
+    subagents?: (typeof MEMORY_SUBAGENT_MODES)[number];
+}
+/** [W6-O] ChatGPT 登录的两条路径（docs/wave6-plan.md §4.1、D13）。 */
+export type ChatGptFlavor = "siwc" | "codex";
+export declare const CHATGPT_FLAVORS: readonly ChatGptFlavor[];
+/** [W6-O] `auth.chatgpt`：不含密钥；只认用户级 / profile。 */
+export interface ChatGptAuthConfig {
+    /** 缺省 siwc（官方动态注册）；codex 是显式开启的备用。 */
+    flavor?: ChatGptFlavor;
+    clientId?: string;
+    issuer?: string;
+    /** codex flavor 的 `originator` 请求头，缺省 codex_cli_rs。 */
+    originator?: string;
+    /** 本地回调端口（依次尝试；0 = 任意空闲端口）。 */
+    redirectPorts?: number[];
+}
+/** [W6-O] `auth` 段。 */
+export interface AuthConfig {
+    chatgpt?: ChatGptAuthConfig;
+}
+/** 第六波并入 `AmaConfig` 的顶层段。 */
+export interface AmaConfigW6 {
+    memory?: MemoryConfig;
+    auth?: AuthConfig;
+}
+/**
+ * [W6-M] profile / SDK 的 `memory`（D11）：嵌入宿主缺省禁用；`enabled: true` 时 `dir` 必填（绝对路径），
+ * 作用域只有 `workspace`，不读用户级记忆。
+ */
+export interface ProfileMemoryOptions {
+    enabled: boolean;
+    dir?: string;
+}
+/** auth.json 里的 API key 条目（第一期起的形态）。 */
+export interface ApiKeyAuthEntry {
+    apiKey: string;
+    env?: Record<string, string>;
+    baseUrl?: string;
+}
+/**
+ * [W6-O] auth.json 里的 OAuth 条目（docs/wave6-plan.md §4.3、D15）。token 与 id_token 原文绝不进日志、错误、
+ * 事件、会话；`describeAuthFile` 只给 `{ kind: "oauth", flavor, plan, expiresIn, needsLogin }`。
+ */
+export interface OAuthAuthEntry {
+    type: "oauth";
+    flavor: ChatGptFlavor;
+    clientId?: string;
+    issuer?: string;
+    accountId?: string;
+    planType?: string;
+    email?: string;
+    accessToken: string;
+    refreshToken: string;
+    idToken?: string;
+    /** epoch ms。 */
+    expiresAt: number;
+    /** ISO 8601。 */
+    lastRefresh?: string;
+    /** codex flavor 首次登录的非官方用法确认时刻（ISO 8601）。 */
+    acknowledgedAt?: string;
+    /** 刷新永久失败：保留 token，等用户重新登录（错误 `auth_expired`）。 */
+    needsLogin?: boolean;
+}
+export type AuthFileEntry = ApiKeyAuthEntry | OAuthAuthEntry;
+export declare function isOAuthEntry(entry: AuthFileEntry | undefined): entry is OAuthAuthEntry;
+/** API key 条目（OAuth 条目返回 undefined）。 */
+export declare function apiKeyEntry(entry: AuthFileEntry | undefined): ApiKeyAuthEntry | undefined;

package/dist/config/types-w6.js

@@ -0,0 +1,19 @@
+/**
+ * 第六波配置键的形状（docs/wave6-plan.md §7、§1.3、§3.1、§4.3、§4.4、§5.2）。[W6-C0] 契约文件：C0 只定形状、
+ * 校验（schema-w6.ts）、说明与缺省（key-docs.ts）、JSON Schema；行为由各批次实现，未实现前这些键被接受但不起作用。
+ *
+ * 层级（merge.ts）：项目级可设 `ui.language`、`ui.agentBar`，`memory` 只接受 `enabled: false`；`ui.replyLanguage`、
+ * `memory` 其余键、`auth` 只认用户级 / profile（项目级忽略并 warning）。
+ */
+export const LANGUAGE_SETTINGS = ["auto", "zh", "en"];
+export const AGENT_BAR_MODES = ["auto", "off"];
+export const MEMORY_SCOPES = ["user", "project"];
+export const MEMORY_SUBAGENT_MODES = ["off", "read"];
+export const CHATGPT_FLAVORS = ["siwc", "codex"];
+export function isOAuthEntry(entry) {
+    return entry !== undefined && entry.type === "oauth";
+}
+/** API key 条目（OAuth 条目返回 undefined）。 */
+export function apiKeyEntry(entry) {
+    return entry === undefined || isOAuthEntry(entry) ? undefined : entry;
+}