@armadra/agent 0.6.1 → 0.6.3

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

@@ -5,7 +5,8 @@
  * `agentDirs` → config `agents.dirs` → 用户级 → 项目级（需信任）），建类型目录并绑到 task 工具
  * （描述里的类型清单）；工厂给每个根会话装一个扩展：建任务注册表（subagent-registry.ts，并发 /
  * 排队上限与模型别名取自 config），`getStats().tasks` 汇总，会话 dispose 时停止后台任务。
- * task 子会话（depth ≥ 1）与没有 task 工具的会话不装。
+ * task 子会话（depth ≥ 1）与没有 task 工具的会话不装。[W7-B1] `subagents.background`（auto：交互 / RPC /
+ * ACP 后台、`-p` 前台）解析成本进程的缺省，同时决定 task 描述的版本；`autoBackgroundAfterMs` 透传。
  *
  * [W5-EG] 外部 runner（claude / codex / acp:* / 宿主注入）经 agents/external.ts 接入 `runners`：每个主
  * 会话一个 ExternalAgents（审批接 requestApproval，只交给人）；PATH 上的 claude / codex 登记进类型

package/dist/cli/compose-agents.js

@@ -5,7 +5,8 @@
  * `agentDirs` → config `agents.dirs` → 用户级 → 项目级（需信任）），建类型目录并绑到 task 工具
  * （描述里的类型清单）；工厂给每个根会话装一个扩展：建任务注册表（subagent-registry.ts，并发 /
  * 排队上限与模型别名取自 config），`getStats().tasks` 汇总，会话 dispose 时停止后台任务。
- * task 子会话（depth ≥ 1）与没有 task 工具的会话不装。
+ * task 子会话（depth ≥ 1）与没有 task 工具的会话不装。[W7-B1] `subagents.background`（auto：交互 / RPC /
+ * ACP 后台、`-p` 前台）解析成本进程的缺省，同时决定 task 描述的版本；`autoBackgroundAfterMs` 透传。
  *
  * [W5-EG] 外部 runner（claude / codex / acp:* / 宿主注入）经 agents/external.ts 接入 `runners`：每个主
  * 会话一个 ExternalAgents（审批接 requestApproval，只交给人）；PATH 上的 claude / codex 登记进类型
@@ -17,7 +18,8 @@ import { AgentCatalog } from "../agents/catalog.js";
 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 { bindTaskAgents, bindTaskBackground } from "../tools/task.js";
+import { resolveTaskBackground } from "../agent/subagent-background.js";
 import { msg } from "../i18n/index.js";
 /** 同一装配材料只提示一次（`/new` 等会重新装配会话）。 */
 const warned = new WeakSet();
@@ -54,6 +56,12 @@ export function subagentEnvironment(deps, catalog) {
     const pending = config.subagents?.maxPending;
     if (pending !== undefined)
         env.maxPending = pending;
+    // [W7-B1] 缺省后台与自动转后台（配置键 W7-B2 登记于 config/types-w5.ts）
+    const sub = config.subagents;
+    env.background = resolveTaskBackground(sub?.background, deps.assembly.unattended === true);
+    const after = sub?.autoBackgroundAfterMs;
+    if (typeof after === "number" && after > 0)
+        env.autoBackgroundAfterMs = after;
     return env;
 }
 /** 外部 Agent 的装配材料（宿主、信任、探测开关取自装配材料与环境）。 */
@@ -108,5 +116,6 @@ export function createSubagentsFactory(deps) {
     registerExternalAgents(catalog, wiring);
     bindTaskAgents(task, catalog);
     const env = subagentEnvironment(deps, catalog);
+    bindTaskBackground(task, env.background === true);
     return ({ core }) => (core.depth > 0 ? undefined : createSubagentExtension(core, env, wiring));
 }

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

@@ -12,7 +12,8 @@
  * - [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）。
+ * - 发现缓存（`<dataDir>/models/discovered/<provider>.json`）并入模型表为空的供应商（discovered-cache.ts）；
+ *   chatgpt 的缓存 flavor 与当前登录不符时视为过期、不并入。
  */
 import type { ApiRegistry } from "../ai/apis/api.js";
 import { ProviderRegistry } from "../ai/providers/registry.js";

package/dist/cli/compose-providers.js

@@ -12,7 +12,8 @@
  * - [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）。
+ * - 发现缓存（`<dataDir>/models/discovered/<provider>.json`）并入模型表为空的供应商（discovered-cache.ts）；
+ *   chatgpt 的缓存 flavor 与当前登录不符时视为过期、不并入。
  */
 import { loadModelsDevIndex } from "../ai/providers/models-dev-cache.js";
 import { ProviderRegistry, discoverLocalModels } from "../ai/providers/registry.js";
@@ -108,8 +109,10 @@ export async function buildProviderRegistry(input, options = {}) {
             registry = make({ provider, apiKey: cli.apiKey });
     }
     // 发现缓存（`ama auth login chatgpt` / `ama models discover chatgpt`）并入模型表为空的供应商
-    if (dataDir !== undefined)
-        mergeDiscoveredModels(registry, dataDir, lazyIndex(() => loadModelsDevIndex(dataDir)));
+    if (dataDir !== undefined) {
+        const flavor = readOAuthEntry(input.authFile, CHATGPT_PROVIDER_ID)?.flavor;
+        mergeDiscoveredModels(registry, dataDir, lazyIndex(() => loadModelsDevIndex(dataDir)), (id) => (id === CHATGPT_PROVIDER_ID ? flavor : undefined));
+    }
     const probe = options.probeLocal ?? env[NO_LOCAL_PROBE_ENV] !== "1";
     if (probe && config.defaultModel === undefined && !anyKeyConfigured(registry)) {
         await probeLocalProviders(registry, options.probeTimeoutMs ?? LOCAL_PROBE_TIMEOUT_MS);

package/dist/cli/startup-steps.js

@@ -4,6 +4,7 @@
  */
 import { describeLookupFailure } from "../ai/providers/suggest.js";
 import { formatModelRef } from "../ai/providers/channels.js";
+import { CHATGPT_PROVIDER_ID } from "../auth/chatgpt/presets.js";
 import { statSync } from "node:fs";
 import { isAbsolute, resolve } from "node:path";
 import { AmaError, StartupError, isAmaError } from "../errors.js";
@@ -126,10 +127,12 @@ export async function resolveModel(args, registry, manager, defaultModel, deps,
     else {
         const change = lastEntry(manager, (e) => e.type === "model_change");
         if (change?.type === "model_change") {
+            // ChatGPT 的渠道跟随当前登录方式：会话里记的渠道不当显式渠道（可能是换登录前的）
+            const channel = change.provider === CHATGPT_PROVIDER_ID ? undefined : change.channel;
             const found = registry.findModel(formatModelRef({
                 provider: change.provider,
                 id: change.modelId,
-                ...(change.channel !== undefined ? { channel: change.channel } : {}),
+                ...(channel !== undefined ? { channel } : {}),
             }));
             if (found.ok)
                 choice = { model: found.model, provider: found.provider };

package/dist/cli/subcommands/models-discover.d.ts

@@ -18,8 +18,10 @@
  * 匹配结果；`--write` 跳过 models.dev 标明不支持工具调用的模型。元数据不写进配置——运行时从缓存补。
  *
  * [W6-O] `chatgpt`：按登录的 flavor 调对应后端的模型列表（SIWC `GET /v1/models` 筛 `visibility: list`；codex
- * `GET /models?client_version=…`），只取 slug 与显示名；`--probe` 不适用（订阅后端只有一种协议）。结果另写进
- * 发现缓存 `<dataDir>/models/discovered/chatgpt.json`（discovered-cache.ts），`/model` 选择器由此列出。
+ * `GET /models?client_version=<codexClientVersion>`，另带上下文窗口 / 输入模态 / 推理强度），取 slug 与显示名；
+ * `--probe` 不适用（订阅后端只有一种协议）。结果另写进发现缓存 `<dataDir>/models/discovered/chatgpt.json`
+ * （discovered-cache.ts，0 个也写），`/model` 选择器由此列出；codex 返回 0 个时提示 codexClientVersion 可能过旧。
+ * 后端给了上下文窗口就显示它（标「后端」），注册表同样以它为准；没给的列出来，说明改用 models.dev。
  */
 import type { Api, Model, ProviderData, ProviderRegistryApi } from "../../ai/types.js";
 import type { ModelsAction } from "./models.js";
@@ -31,6 +33,7 @@ export declare const PROBE_APIS: readonly Api[];
 export declare function modelsUrl(provider: ProviderData): string;
 export declare function discoverModels(provider: ProviderData, apiKey: string | undefined, options?: {
     timeoutMs?: number;
+    codexClientVersion?: string;
 }): Promise<Model[]>;
 export declare function probeOrder(provider: ProviderData): Api[];
 export interface ProbeOptions {

package/dist/cli/subcommands/models-discover.js

@@ -18,15 +18,17 @@
  * 匹配结果；`--write` 跳过 models.dev 标明不支持工具调用的模型。元数据不写进配置——运行时从缓存补。
  *
  * [W6-O] `chatgpt`：按登录的 flavor 调对应后端的模型列表（SIWC `GET /v1/models` 筛 `visibility: list`；codex
- * `GET /models?client_version=…`），只取 slug 与显示名；`--probe` 不适用（订阅后端只有一种协议）。结果另写进
- * 发现缓存 `<dataDir>/models/discovered/chatgpt.json`（discovered-cache.ts），`/model` 选择器由此列出。
+ * `GET /models?client_version=<codexClientVersion>`，另带上下文窗口 / 输入模态 / 推理强度），取 slug 与显示名；
+ * `--probe` 不适用（订阅后端只有一种协议）。结果另写进发现缓存 `<dataDir>/models/discovered/chatgpt.json`
+ * （discovered-cache.ts，0 个也写），`/model` 选择器由此列出；codex 返回 0 个时提示 codexClientVersion 可能过旧。
+ * 后端给了上下文窗口就显示它（标「后端」），注册表同样以它为准；没给的列出来，说明改用 models.dev。
  */
 import { authHeaders, mergeHeaders } from "../../ai/http.js";
 import { listChatGptModels } from "../../auth/chatgpt/backend-client.js";
-import { CHATGPT_PROVIDER_ID } from "../../auth/chatgpt/presets.js";
+import { CHATGPT_PROVIDER_ID, codexClientVersion } from "../../auth/chatgpt/presets.js";
 import { liveToken } from "../../auth/oauth/live.js";
 import { discoverLocalModels, materializeModel } from "../../ai/providers/registry.js";
-import { writeDiscoveredCache } from "../../ai/providers/discovered-cache.js";
+import { thinkingMapOf, writeDiscoveredCache, } from "../../ai/providers/discovered-cache.js";
 import { withCustomDefaults } from "../../ai/providers/catalog.js";
 import { describeModelsDev, loadModelsDevIndex } from "../../ai/providers/models-dev-cache.js";
 import { matchLabel, modelsDevFields } from "../../ai/providers/models-dev.js";
@@ -65,11 +67,20 @@ export async function discoverModels(provider, apiKey, options = {}) {
             accessToken: apiKey,
             accountId: live?.accountId,
             originator: channel?.headers?.["originator"],
+            clientVersion: options.codexClientVersion,
         });
         return models.map((m) => {
             const model = withCustomDefaults({ id: m.id }, provider.id, provider.api);
             if (m.name !== undefined)
                 model.name = m.name;
+            if (m.contextWindow !== undefined)
+                model.contextWindow = m.contextWindow;
+            if (m.input !== undefined)
+                model.input = m.input;
+            if (m.reasoningLevels?.some((x) => x !== "none") === true) {
+                model.reasoning = true;
+                model.thinkingLevelMap = thinkingMapOf(m.reasoningLevels);
+            }
             return model;
         });
     }
@@ -191,7 +202,9 @@ async function run(ctx) {
     }
     let found;
     try {
-        found = await discoverModels(provider, key.apiKey);
+        found = await discoverModels(provider, key.apiKey, {
+            codexClientVersion: codexClientVersion(ctx.level.merged.config.auth?.chatgpt, io.env),
+        });
     }
     catch (error) {
         io.stderr(m.listFailed(provider.id, error.message));
@@ -214,13 +227,22 @@ async function run(ctx) {
             noTools.add(model.id);
         if (match === undefined)
             unmatched.add(model.id);
+        // 后端给的上下文窗口优先于 models.dev（订阅后端的生效窗口可能远小于 API 版）
+        const backendCtx = model.contextWindow !== undefined
+            ? `  ctx ${compactTokens(model.contextWindow)}${m.fromBackend}`
+            : undefined;
         const meta = fields === undefined
-            ? m.unmatched
-            : `  ctx ${compactTokens(fields.contextWindow)} · out ${compactTokens(fields.maxTokens)}` +
+            ? `${backendCtx ?? ""}${m.unmatched}`
+            : `${backendCtx ?? `  ctx ${compactTokens(fields.contextWindow)}`} · out ${compactTokens(fields.maxTokens)}` +
                 `${fields.input?.includes("image") ? m.image : ""}${fields.reasoning ? m.reasoning : ""}` +
                 `${fields.toolCall === false ? m.noTools : ""} · ${matchLabel(match)}`;
         io.stdout(`  ${model.id}${known !== undefined ? m.configured(known.api) : ""}${meta}\n`);
     }
+    if (provider.id === CHATGPT_PROVIDER_ID) {
+        const missing = found.filter((x) => x.contextWindow === undefined).map((x) => x.id);
+        if (missing.length > 0)
+            io.stdout(m.noBackendWindow(missing.join(", ")));
+    }
     const write = ctx.flags.has("write");
     if (!ctx.flags.has("probe") || provider.id === CHATGPT_PROVIDER_ID) {
         if (write)
@@ -256,17 +278,37 @@ async function run(ctx) {
     }
     return ExitCode.Ok;
 }
-/** chatgpt 的发现结果写进发现缓存（选择器与注册表读它）；写失败不影响列表输出。 */
+/** 发现得到的模型 → 缓存条目（后端给的元数据一并写入；推理强度由映射表还原）。 */
+function cacheEntry(m) {
+    const entry = { id: m.id };
+    if (m.name !== m.id)
+        entry.name = m.name;
+    if (m.contextWindow !== undefined)
+        entry.contextWindow = m.contextWindow;
+    if (m.input.length !== 1 || m.input[0] !== "text")
+        entry.input = [...m.input];
+    if (m.reasoning && m.thinkingLevelMap !== undefined)
+        entry.reasoningLevels = Object.entries(m.thinkingLevelMap).flatMap(([level, value]) => typeof value !== "string" ? [] : level === "off" ? ["none"] : [level]);
+    return entry;
+}
+/**
+ * chatgpt 的发现结果写进发现缓存（选择器与注册表读它；0 个也写，免得残留另一 flavor 的缓存）；写失败不影响
+ * 列表输出。codex 返回 0 个时提示 codexClientVersion 可能过旧。
+ */
 function cacheChatGpt(ctx, found, apiKey) {
+    const flavor = liveToken(apiKey)?.flavor;
     try {
-        const flavor = liveToken(apiKey)?.flavor;
-        const models = found.map((m) => ({ id: m.id, ...(m.name !== m.id ? { name: m.name } : {}) }));
+        const models = found.map(cacheEntry);
         const path = writeDiscoveredCache(ctx.level.dataDir, CHATGPT_PROVIDER_ID, { models, flavor });
         ctx.io.stdout(msg().subcommands.discover.cached(path));
     }
     catch (error) {
         ctx.io.stderr(`ama: ${error.message}\n`);
     }
+    if (found.length === 0 && flavor === "codex") {
+        const version = codexClientVersion(ctx.level.merged.config.auth?.chatgpt, ctx.io.env);
+        ctx.io.stderr(`${msg().auth.login.codexNoModels(version)}\n`);
+    }
 }
 export const DISCOVER_ACTION = {
     usage: "ama models discover <provider> [--probe] [--write] [--limit <n>] [--concurrency <n>] [--probe-timeout <ms>]",

package/dist/config/json-schema.js

@@ -13,7 +13,7 @@ import { defaultFor, isDynamicDefault, keyDoc } from "./key-docs.js";
 import { HOOK_TIMEOUT_MAX_MS, THINKING_LEVELS } from "./schema.js";
 import { CACHE_RETENTIONS, CHANNEL_NAME_PATTERN, CHECKPOINT_MODES, SANDBOX_ENABLED_MODES, SANDBOX_NETWORK_MODES, CODEMODE_MODES, IMAGE_RESIZE_MODES, PLAN_BASH_MODES_STRICT_FIRST, PLAN_UNATTENDED_MODES, STATUS_LINE_MODES, TOOLS_PRESET_INPUTS, LANGUAGE_SETTINGS, AGENT_BAR_MODES, CHATGPT_FLAVORS, MEMORY_SCOPES, MEMORY_SUBAGENT_MODES, } from "./types.js";
 import { AGENT_ID_PATTERN } from "./schema-w5.js";
-import { AGENTS_RESERVED_KEYS } from "./types-w5.js";
+import { AGENTS_RESERVED_KEYS, SUBAGENT_BACKGROUND_MODES } from "./types-w5.js";
 export const CONFIG_SCHEMA_FILE = "config.schema.json";
 export const CONFIG_SCHEMA_ID = "https://github.com/Owlbay/armadra-agent/config.schema.json";
 const KNOWN_APIS = [
@@ -150,7 +150,13 @@ function w5Sections() {
                 pattern: `^(${AGENTS_RESERVED_KEYS.join("|")}|${AGENT_ID_PATTERN.source.slice(1, -1)})$`,
             },
         }),
-        subagents: object({ maxConcurrent: num(1, 64), maxPending: num(0, 1024), defaultModel: str() }),
+        subagents: object({
+            maxConcurrent: num(1, 64),
+            maxPending: num(0, 1024),
+            defaultModel: str(),
+            background: oneOf(SUBAGENT_BACKGROUND_MODES),
+            autoBackgroundAfterMs: num(0),
+        }),
         models: object({ aliases: object({ fast: str(), strong: str() }), enabled: strings }),
         fallbackModel: str(),
         limits: object({ maxTurns: num(1), maxCostUsd: num(0) }),
@@ -180,6 +186,7 @@ function w6Sections() {
                 clientId: str(),
                 issuer: str(),
                 originator: str(),
+                codexClientVersion: str(),
                 redirectPorts: {
                     type: "array",
                     items: { type: "integer", minimum: 0, maximum: 65535 },
@@ -270,6 +277,7 @@ function buildBaseSchema() {
                 quietStartup: oneOf(["normal", "header", "silent"]),
                 ascii: bool(),
                 compact: bool(),
+                logo: oneOf(["auto", "off"]),
                 animation: bool(),
                 restoreOnCancel: bool(),
                 statusLine: oneOf(STATUS_LINE_MODES),

package/dist/config/key-docs.js

@@ -10,6 +10,7 @@
  *   DISPLAY_DEFAULTS 相同，DISPLAY_DEFAULTS 本身通过 `validateConfig`。
  */
 import { DEFAULT_IDLE_TIMEOUT_MS } from "../ai/http.js";
+import { DEFAULT_CODEX_CLIENT_VERSION } from "../auth/chatgpt/presets.js";
 import { messagesFor, msg } from "../i18n/index.js";
 import { DEFAULT_INLINE_BUDGET } from "../codemode/declarations.js";
 import { DEFAULT_CONFIG, mergeConfig } from "./merge.js";
@@ -22,7 +23,7 @@ const IMPLICIT_DEFAULTS = {
     codemode: { inlineBudget: DEFAULT_INLINE_BUDGET, requireStrict: false },
     cache: { ...DEFAULT_CACHE_CONFIG },
     request: { idleTimeoutMs: DEFAULT_IDLE_TIMEOUT_MS },
-    ui: { compact: false, animation: true, restoreOnCancel: true, language: "auto" },
+    ui: { compact: false, logo: "auto", animation: true, restoreOnCancel: true, language: "auto" },
     // [W6-C0] 第六波键的缺省（行为由各批次实现）
     memory: {
         enabled: false,
@@ -33,7 +34,12 @@ const IMPLICIT_DEFAULTS = {
         subagents: "read",
     },
     auth: {
-        chatgpt: { flavor: "siwc", issuer: "https://auth.openai.com", originator: "codex_cli_rs" },
+        chatgpt: {
+            flavor: "siwc",
+            issuer: "https://auth.openai.com",
+            originator: "codex_cli_rs",
+            codexClientVersion: DEFAULT_CODEX_CLIENT_VERSION,
+        },
     },
     checkpoints: { ...DEFAULT_CHECKPOINTS_CONFIG },
     sandbox: { enabled: "auto", bash: "off", network: "deny", writable: [] },
@@ -42,7 +48,7 @@ const IMPLICIT_DEFAULTS = {
     images: { resize: "auto" },
     plan: { bash: "readonly", unattended: "stop" },
     agents: { maxConcurrent: 3, dirs: [] },
-    subagents: { maxConcurrent: 4, maxPending: 16 },
+    subagents: { maxConcurrent: 4, maxPending: 16, background: "auto", autoBackgroundAfterMs: 0 },
     reminders: { todo: true, fileChanges: true, contextPressure: true, budget: true },
     todo: { reminder: 10 },
 };

package/dist/config/merge.d.ts

@@ -9,7 +9,7 @@
  *   `compaction`、`tools.disabled`、`tools.preset`（只能更严）、`codemode.mode: "off"`、`ui`、
  *   `checkpoints.mode: "off"`、`checkpoints.maxFileBytes`（只能调小）、（W5-C0）`plan.bash`（只能更严）、
  *   `reminders`；`compaction.prune / pruneExclude` 与第五波其余段只认用户级；（W6-C0）`ui.language` /
- *   `ui.agentBar` 随 `ui` 段、`memory.enabled: false`；`ui.replyLanguage`、`memory` 其余键、`auth` 只认用户级；
+ *   `ui.agentBar` 随 `ui` 段、`memory.enabled: false`；（W7-B2）`subagents.background / autoBackgroundAfterMs`；`ui.replyLanguage`、`memory` 其余键、`auth` 只认用户级；
  *   其它字段与放宽项（含 `permission.builtinDeny / autoModel / autoSafeCommands`）被忽略并记 warning。
  * - 同时产出带来源的权限规则清单（`ruleSpecs`），交给权限管线（B3 的 rules.ts 解析）。
  */

package/dist/config/merge.js

@@ -9,7 +9,7 @@
  *   `compaction`、`tools.disabled`、`tools.preset`（只能更严）、`codemode.mode: "off"`、`ui`、
  *   `checkpoints.mode: "off"`、`checkpoints.maxFileBytes`（只能调小）、（W5-C0）`plan.bash`（只能更严）、
  *   `reminders`；`compaction.prune / pruneExclude` 与第五波其余段只认用户级；（W6-C0）`ui.language` /
- *   `ui.agentBar` 随 `ui` 段、`memory.enabled: false`；`ui.replyLanguage`、`memory` 其余键、`auth` 只认用户级；
+ *   `ui.agentBar` 随 `ui` 段、`memory.enabled: false`；（W7-B2）`subagents.background / autoBackgroundAfterMs`；`ui.replyLanguage`、`memory` 其余键、`auth` 只认用户级；
  *   其它字段与放宽项（含 `permission.builtinDeny / autoModel / autoSafeCommands`）被忽略并记 warning。
  * - 同时产出带来源的权限规则清单（`ruleSpecs`），交给权限管线（B3 的 rules.ts 解析）。
  */
@@ -35,8 +35,9 @@ export const DEFAULT_CONFIG = Object.freeze({
 });
 /** 嵌入宿主（有 profile）时的缺省覆盖（§12.10）。 */
 export const PROFILE_DEFAULTS = Object.freeze({
-    // [W5-A] 嵌入宿主以「最后一行 = 状态栏」锚定，底部信息行缺省单行；[W6-C0] 宿主自己展示节点，Agent 栏缺省关
-    ui: { quietStartup: "header", statusLine: "compact", agentBar: "off" },
+    // [W5-A] 嵌入宿主以「最后一行 = 状态栏」锚定，底部信息行缺省单行；[W7-A] Agent 栏不再缺省关，
+    // 宿主要关就在自己的 profile 写 `ui.agentBar: "off"`
+    ui: { quietStartup: "header", statusLine: "compact" },
 });
 /** 层名 → 规则来源（RuleSource）。 */
 const RULE_SOURCE = {
@@ -120,6 +121,22 @@ export function restrictProjectConfig(project, currentMode, label = ".ama/config
                 if (project.reminders !== undefined)
                     accepted.reminders = structuredClone(project.reminders);
                 break;
+            case "subagents": {
+                // [W7-B2] 前台 / 后台只影响呈现与等待，不放宽权限：项目级可设；并发、模型仍只认用户级
+                const subagents = project.subagents ?? {};
+                const result = {};
+                for (const sub of Object.keys(subagents)) {
+                    if (sub !== "background" && sub !== "autoBackgroundAfterMs")
+                        warnings.push(msg().config.merge.projectOnlyKeys(label, "subagents.background / subagents.autoBackgroundAfterMs", `subagents.${sub}`));
+                }
+                if (subagents.background !== undefined)
+                    result.background = subagents.background;
+                if (subagents.autoBackgroundAfterMs !== undefined)
+                    result.autoBackgroundAfterMs = subagents.autoBackgroundAfterMs;
+                if (Object.keys(result).length > 0)
+                    accepted.subagents = result;
+                break;
+            }
             case "plan": {
                 const plan = restrictPlan(project.plan ?? {}, currentPlanBash, label, warnings);
                 if (plan !== undefined)

package/dist/config/schema-w5.js

@@ -7,7 +7,7 @@
 import { PERMISSION_MODES_STRICT_FIRST } from "../permissions/types.js";
 import { msg } from "../i18n/index.js";
 import { Checker, THINKING_LEVELS, checkSection, join } from "./checker.js";
-import { AGENTS_RESERVED_KEYS, IMAGE_RESIZE_MODES, MODELS_ENABLED_REF, PLAN_BASH_MODES_STRICT_FIRST, PLAN_UNATTENDED_MODES, STATUS_LINE_MODES, } from "./types-w5.js";
+import { AGENTS_RESERVED_KEYS, IMAGE_RESIZE_MODES, MODELS_ENABLED_REF, PLAN_BASH_MODES_STRICT_FIRST, PLAN_UNATTENDED_MODES, STATUS_LINE_MODES, SUBAGENT_BACKGROUND_MODES, } from "./types-w5.js";
 /** 第五波新增的顶层键（schema.ts 的 CONFIG_KEYS 并入）。 */
 export const W5_CONFIG_KEYS = [
     "images",
@@ -83,10 +83,12 @@ export function validateConfigW5(c, config) {
         c.oneOf(s, "thinkingLevel", p, THINKING_LEVELS);
     });
     checkAgents(c, config);
-    checkSection(c, config, "subagents", ["maxConcurrent", "maxPending", "defaultModel"], (s, p) => {
+    checkSection(c, config, "subagents", ["maxConcurrent", "maxPending", "defaultModel", "background", "autoBackgroundAfterMs"], (s, p) => {
         c.number(s, "maxConcurrent", p, 1, 64);
         c.number(s, "maxPending", p, 0, 1024);
         c.string(s, "defaultModel", p);
+        c.oneOf(s, "background", p, SUBAGENT_BACKGROUND_MODES);
+        c.number(s, "autoBackgroundAfterMs", p, 0);
     });
     checkSection(c, config, "models", ["aliases", "enabled"], (s, p) => {
         c.stringArray(s, "enabled", p);

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

@@ -9,7 +9,7 @@ export declare const W6_CONFIG_KEYS: readonly ["memory", "auth"];
 /** 已有 `ui` 段新增的键。 */
 export declare const W6_UI_KEYS: readonly ["language", "replyLanguage", "agentBar"];
 export declare const MEMORY_KEYS: readonly ["enabled", "scopes", "indexMaxBytes", "fileMaxBytes", "maxFiles", "subagents"];
-export declare const CHATGPT_AUTH_KEYS: readonly ["flavor", "clientId", "issuer", "originator", "redirectPorts"];
+export declare const CHATGPT_AUTH_KEYS: readonly ["flavor", "clientId", "issuer", "originator", "codexClientVersion", "redirectPorts"];
 export declare function checkUiW6(c: Checker, ui: Obj, path: string): void;
 /** 第六波顶层段的校验（validateConfig 末尾调用）。 */
 export declare function validateConfigW6(c: Checker, config: Obj): void;

package/dist/config/schema-w6.js

@@ -24,6 +24,7 @@ export const CHATGPT_AUTH_KEYS = [
     "clientId",
     "issuer",
     "originator",
+    "codexClientVersion",
     "redirectPorts",
 ];
 export function checkUiW6(c, ui, path) {
@@ -63,7 +64,7 @@ export function validateConfigW6(c, config) {
             return;
         c.keys(chatgpt, cp, CHATGPT_AUTH_KEYS);
         c.oneOf(chatgpt, "flavor", cp, CHATGPT_FLAVORS);
-        for (const key of ["clientId", "issuer", "originator"])
+        for (const key of ["clientId", "issuer", "originator", "codexClientVersion"])
             c.string(chatgpt, key, cp);
         checkPorts(c, chatgpt, "redirectPorts", cp);
     });

package/dist/config/schema.js

@@ -257,6 +257,7 @@ export function validateConfig(value) {
         "quietStartup",
         "ascii",
         "compact",
+        "logo",
         "animation",
         "restoreOnCancel",
         ...W5_UI_KEYS,
@@ -269,6 +270,7 @@ export function validateConfig(value) {
         c.oneOf(s, "quietStartup", p, ["normal", "header", "silent"]);
         c.boolean(s, "ascii", p);
         c.boolean(s, "compact", p);
+        c.oneOf(s, "logo", p, ["auto", "off"]);
         c.boolean(s, "animation", p);
         c.boolean(s, "restoreOnCancel", p);
         checkUiW5(c, s, p);

package/dist/config/settings-registry.js

@@ -31,6 +31,7 @@ const ROWS = [
     row("ui.showThinking", "ui", "now", "any"),
     row("ui.compact", "ui", "now", "any"),
     row("ui.animation", "ui", "now", "any"),
+    row("ui.logo", "ui", "restart", "any"),
     row("ui.statusLine", "ui", "now", "any"),
     row("ui.restoreOnCancel", "ui", "nextSession", "any"),
     row("ui.quietStartup", "ui", "restart", "any"),
@@ -92,6 +93,9 @@ const ROWS = [
     row("agents.sessionBudgetUsd", "agents", "nextSession", "deny", { kind: "optionalNumber" }),
     row("subagents.maxConcurrent", "agents", "nextSession", "deny"),
     row("subagents.maxPending", "agents", "nextSession", "deny"),
+    // [W7-B2] 改 task 工具描述（缺省后台 / 前台两种文案），故 prefix
+    row("subagents.background", "agents", "restart", "any", { prefix: true }),
+    row("subagents.autoBackgroundAfterMs", "agents", "restart", "any"),
     // [W6-M]
     row("memory.enabled", "memory", "nextSession", "tighten", { envOverride: "AMA_MEMORY" }),
     row("memory.subagents", "memory", "nextSession", "deny"),

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

@@ -59,6 +59,9 @@ export interface AgentsConfig {
 }
 /** 取 `agents.<id>`（保留键返回 undefined）。 */
 export declare function agentEntry(agents: AgentsConfig | undefined, agentId: string): AgentEntryConfig | undefined;
+/** [W7-B2] 子 Agent 缺省前台还是后台（docs/agents-concurrency-plan.md §2.6）。 */
+export declare const SUBAGENT_BACKGROUND_MODES: readonly ["auto", "always", "never"];
+export type SubagentBackgroundMode = (typeof SUBAGENT_BACKGROUND_MODES)[number];
 /** [W5-G] ama 自己的子会话。 */
 export interface SubagentsConfig {
     /** 同时运行的子会话，缺省 4。 */
@@ -67,6 +70,13 @@ export interface SubagentsConfig {
     maxPending?: number;
     /** 子会话缺省模型；不设继承父会话。 */
     defaultModel?: string;
+    /**
+     * [W7-B2] task 缺省后台：auto（缺省）= 交互 / RPC / ACP 下后台、`-p` 下前台；always / never 固定。
+     * 优先级：调用参数 > 类型定义 > 本键。用户 / 项目 / 宿主级都认。
+     */
+    background?: SubagentBackgroundMode;
+    /** [W7-B2] 前台任务运行超过该毫秒数自动转后台；缺省 0 关闭。用户 / 项目级都认。 */
+    autoBackgroundAfterMs?: number;
 }
 /** `models.enabled` 的一项：`provider/model[@channel]` 或 `provider/*`。 */
 export declare const MODELS_ENABLED_REF: RegExp;

package/dist/config/types-w5.js

@@ -18,5 +18,7 @@ export function agentEntry(agents, agentId) {
     const entry = agents[agentId];
     return typeof entry === "object" && !Array.isArray(entry) ? entry : undefined;
 }
+/** [W7-B2] 子 Agent 缺省前台还是后台（docs/agents-concurrency-plan.md §2.6）。 */
+export const SUBAGENT_BACKGROUND_MODES = ["auto", "always", "never"];
 /** `models.enabled` 的一项：`provider/model[@channel]` 或 `provider/*`。 */
 export const MODELS_ENABLED_REF = /^[^/\s]+\/\S+$/;

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

@@ -53,6 +53,11 @@ export interface ChatGptAuthConfig {
     issuer?: string;
     /** codex flavor 的 `originator` 请求头，缺省 codex_cli_rs。 */
     originator?: string;
+    /**
+     * codex flavor 模型列表的 `client_version`（Codex CLI 版本号，后端按它过滤模型），缺省见
+     * `DEFAULT_CODEX_CLIENT_VERSION`；`AMA_CHATGPT_CODEX_CLIENT_VERSION` 优先。
+     */
+    codexClientVersion?: string;
     /** 本地回调端口（依次尝试；0 = 任意空闲端口）。 */
     redirectPorts?: number[];
 }

package/dist/config/types.d.ts

@@ -143,8 +143,10 @@ export interface UiConfig extends UiConfigW6 {
     quietStartup?: "normal" | "header" | "silent";
     /** ASCII 字形（`AMA_ASCII=1` 等价）；缺省按区域设置 / TERM 自动检测。 */
     ascii?: boolean;
-    /** 消息区块间不空行、启动头无框，缺省 false。 */
+    /** 消息区块间不空行、启动头不画字符画，缺省 false。 */
     compact?: boolean;
+    /** 启动头的「AMA」字符画：auto（缺省，宽度够时画）/ off（只画信息列）。 */
+    logo?: "auto" | "off";
     /** false：运行中 spinner 固定为 `·`，缺省 true。 */
     animation?: boolean;
     /** 运行中 Esc 中断、本回合还没有任何输出时撤回该回合并回填原消息，缺省 true。 */

package/dist/git/info.d.ts

@@ -7,6 +7,9 @@
  *   `GIT_OPTIONAL_LOCKS=0`；两次之间 ≥ `minIntervalMs`（缺省 10 s），超过 `timeoutMs`（缺省 2 s）或
  *   非零退出 / 起不来就省略增删项，并在本实例（本会话）停用 numstat，HEAD 仍照常显示。
  *   `AMA_STATUS_GIT=0` 直接关闭 numstat（排错用）。
+ * - [W6] 领先 / 落后上游：当前分支在 git 配置里有 `branch.<名>.merge`（零依赖读 config，不起进程判断）时，
+ *   numstat 之后同一节流周期再跑 `git rev-list --left-right --count @{upstream}...HEAD`（同样的超时与环境）；
+ *   没有上游、detached、非零退出就省略；超时则本会话不再统计领先 / 落后。`AMA_STATUS_GIT=0` 同样关闭。
  * - 非 git 目录 `current()` 为 undefined（状态行整段省略）。
  * - `refresh()` 在回合边界调用（agent_settled、写类工具结束、回滚、/tree），只发起读取、不阻塞；
  *   结果有变化时通知 `onChange` 的监听者。
@@ -19,6 +22,9 @@ export interface GitInfo {
     /** 工作区（含暂存）相对 HEAD；拿不到为 undefined。 */
     insertions?: number;
     deletions?: number;
+    /** [W6] 领先 / 落后上游的提交数；没有上游为 undefined。 */
+    ahead?: number;
+    behind?: number;
 }
 /** numstat 子进程的最小接口（测试注入）。 */
 export interface NumstatProcess {
@@ -45,6 +51,13 @@ export declare function parseNumstat(text: string): {
     insertions: number;
     deletions: number;
 };
+/** `git rev-list --left-right --count @{upstream}...HEAD` 的输出：左（上游独有）= 落后，右 = 领先。 */
+export declare function parseLeftRight(text: string): {
+    ahead: number;
+    behind: number;
+} | undefined;
+/** 分支在 git 配置里有没有上游（`[branch "<名>"]` 段里的 `merge`）；worktree 读主仓库的 config。 */
+export declare function hasUpstream(cwd: string, branch: string): Promise<boolean>;
 export declare class GitInfoWatcher {
     private readonly cwd;
     private info;
@@ -61,6 +74,8 @@ export declare class GitInfoWatcher {
     private headAgain;
     private disposed;
     private diff;
+    private upstream;
+    private upstreamDisabled;
     constructor(cwd: string, deps?: GitInfoDeps);
     current(): GitInfo | undefined;
     /** numstat 已因超时 / 失败 / 环境变量停用。 */
@@ -71,5 +86,9 @@ export declare class GitInfoWatcher {
     dispose(): void;
     private update;
     private maybeNumstat;
+    /** 领先 / 落后上游：只在配置里有上游时起进程；超时本会话停用，非零退出只省略这一次。 */
+    private leftRight;
     private numstat;
+    /** 后台起一次 git；起不来为 undefined，超时杀掉并返回 `"timeout"`。 */
+    private run;
 }