@armadra/agent 0.6.2 → 0.6.3

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

@@ -80,6 +80,16 @@ export interface SubagentEndEvent {
         changed: boolean;
     };
 }
+/**
+ * [W7-B1] 前台任务转后台（docs/agents-concurrency-plan.md §2.5）：`user` = 人（TUI `Ctrl+B` 等），
+ * `timeout` = `subagents.autoBackgroundAfterMs` 到时，`host` = 宿主 / SDK（`session.backgroundTask`）。
+ */
+export interface SubagentBackgroundEvent {
+    type: "subagent_background";
+    taskId: string;
+    parentToolCallId: string;
+    reason: "user" | "timeout" | "host";
+}
 export interface PlanStep {
     /** `S1`、`S2` …；编号列表时按序号生成。 */
     id: string;
@@ -161,7 +171,7 @@ export type SessionEventW5 =
 /** 流式中 ≤ 2 Hz（`ui.animation: false` 时不发）；数据从 `getStats().telemetry` 取。 */
 {
     type: "telemetry_tick";
-} | SubagentStartEvent | SubagentUpdateEvent | SubagentEndEvent | PlanProposedEvent | PlanResolvedEvent | TodoUpdatedEvent | LimitReachedEvent | ModelFallbackEvent | BackgroundJobEvent;
+} | SubagentStartEvent | SubagentUpdateEvent | SubagentEndEvent | SubagentBackgroundEvent | PlanProposedEvent | PlanResolvedEvent | TodoUpdatedEvent | LimitReachedEvent | ModelFallbackEvent | BackgroundJobEvent;
 /** 外部 Agent 记账（`custom{ama.agent-usage}` 汇总，§5.4）。 */
 export interface ExternalAgentStats {
     byAgent: Record<string, {

package/dist/agent/types.d.ts

@@ -397,6 +397,11 @@ export interface AgentSession {
         steering: string[];
         followUp: string[];
     };
+    /**
+     * [W7-B1] 阻塞中的前台子 Agent 任务转后台（不给 taskId = 全部；docs/agents-concurrency-plan.md §2.5）。
+     * `reason` 缺省 `"host"`（宿主 / SDK）；TUI 的人工操作传 `"user"`。返回被转后台或被打断等待的 taskId。
+     */
+    backgroundTask(taskId?: string, reason?: "user" | "timeout" | "host"): string[];
     subscribe(listener: (event: SessionEvent) => void): () => void;
     compact(instructions?: string): Promise<CompactionResult>;
     fork(entryId: string): Promise<AgentSession>;

package/dist/agents/builtin.js

@@ -17,7 +17,6 @@ function builtin(name, description, prompt, permissionMode) {
         model: "inherit",
         maxTurns: 30,
         isolation: "none",
-        background: false,
         runner: "ama",
         prompt,
         source: "builtin",

package/dist/agents/external.js

@@ -48,7 +48,6 @@ function definition(name, runner, description, source) {
         model: "inherit",
         maxTurns: 30,
         isolation: "none",
-        background: false,
         // 驱动表 id（gemini 等）与宿主 id 不在 AgentRunnerSpec 的字面量里，线上照样是字符串
         runner: runner,
         prompt: "",

package/dist/agents/parse.js

@@ -85,8 +85,8 @@ export function parseAgentDefinition(text, filePath, source) {
     const isolation = data["isolation"] ?? "none";
     if (isolation !== "none" && isolation !== "worktree")
         return fail("isolation must be none or worktree");
-    const background = data["background"] ?? false;
-    if (typeof background !== "boolean")
+    const background = data["background"];
+    if (background !== undefined && typeof background !== "boolean")
         return fail("background must be true or false");
     if (runner !== "ama") {
         const ignored = ["tools", "disallowed-tools", "permission-mode"].filter((key) => data[key] !== undefined);
@@ -100,12 +100,13 @@ export function parseAgentDefinition(text, filePath, source) {
         model: model.trim(),
         maxTurns,
         isolation,
-        background,
         runner,
         prompt: fm.body.trim(),
         source,
         filePath,
     };
+    if (background !== undefined)
+        agent.background = background;
     if (tools !== undefined)
         agent.tools = tools;
     if (disallowedTools !== undefined)

package/dist/agents/result.d.ts

@@ -28,5 +28,11 @@ export interface NotificationInput {
     report: string;
 }
 export declare function taskNotification(input: NotificationInput): string;
+export declare const NOTIFY_HINT = "A <task-notification> arrives when it finishes; use task_ctl to wait, stop or read output.";
+export declare function startedText(taskId: string, agent: string): string;
+/** 前台转后台的工具结果（§2.5.3）：固定英文；task 工具在前面加 `[task tN] `。 */
+export declare function backgroundedText(reason: "user" | "timeout" | "host", afterMs: number): string;
+/** `task_ctl wait` 被转后台打断时的文案（§2.5.4）。 */
+export declare function waitDetachedText(taskId: string): string;
 /** 系统提示 rules 节的一句（task 工具的 promptGuidelines；会话开始即固定）。 */
-export declare const TASK_NOTIFICATION_RULE = "A <task-notification> message is a background task's report, not the user speaking.";
+export declare const TASK_NOTIFICATION_RULE: string;

package/dist/agents/result.js

@@ -63,5 +63,24 @@ export function taskNotification(input) {
         attrs.push(`outputFile="${attr(input.outputFile)}"`);
     return `<task-notification ${attrs.join(" ")}>\n${input.report}\n</task-notification>`;
 }
+// [W7-B1] 后台任务的固定英文文案（docs/agents-concurrency-plan.md §2.5；工具结果不进缓存前缀，但要
+// 稳定，便于测试与模型学习）。
+export const NOTIFY_HINT = "A <task-notification> arrives when it finishes; use task_ctl to wait, stop or read output.";
+export function startedText(taskId, agent) {
+    return `Started background task ${taskId} (agent ${agent}). ${NOTIFY_HINT}`;
+}
+/** 前台转后台的工具结果（§2.5.3）：固定英文；task 工具在前面加 `[task tN] `。 */
+export function backgroundedText(reason, afterMs) {
+    const head = reason === "timeout"
+        ? `Still running after ${Math.round(afterMs / 1000)}s and moved to the background`
+        : "Moved to the background by the user";
+    return `${head}; it was not interrupted. ${NOTIFY_HINT} Do not wait for it unless the user asks.`;
+}
+/** `task_ctl wait` 被转后台打断时的文案（§2.5.4）。 */
+export function waitDetachedText(taskId) {
+    return (`Task ${taskId} is still running and was moved to the background by the user; do not wait ` +
+        "again — a <task-notification> arrives when it finishes.");
+}
 /** 系统提示 rules 节的一句（task 工具的 promptGuidelines；会话开始即固定）。 */
-export const TASK_NOTIFICATION_RULE = "A <task-notification> message is a background task's report, not the user speaking.";
+export const TASK_NOTIFICATION_RULE = "A <task-notification> is a background task's report, not the user speaking; never sleep or " +
+    "poll for it.";

package/dist/agents/task-control.d.ts

@@ -8,9 +8,20 @@ import type { SubagentResult, TaskRegistryView } from "../tools/types.js";
 export interface TaskControl extends TaskRegistryView {
     /** 运行中是已有输出，结束后是最终文本。 */
     output(taskId: string): string | undefined;
-    /** 等结束或超时（超时返回 undefined）；未知 taskId 抛 `task_not_found`。 */
-    wait(taskId: string, timeoutMs: number): Promise<SubagentResult | undefined>;
+    /**
+     * 等结束、超时或 `signal` 触发（后两者返回 undefined）；未知 taskId 抛 `task_not_found`。
+     * [W7-B1] 不给 signal 时由 `background()` 打断（见 `detachSignal`）。
+     */
+    wait(taskId: string, timeoutMs: number, options?: {
+        signal?: AbortSignal;
+    }): Promise<SubagentResult | undefined>;
     stop(taskId: string): Promise<SubagentResult | undefined>;
+    /** [W7-B1] 前台任务转后台（不给 taskId = 全部）；返回被转后台或被打断等待的 taskId。 */
+    background(taskId?: string): string[];
+    /** [W7-B1] 该任务的转后台信号：`background()` 触发后 abort（下次取到新的）。 */
+    detachSignal(taskId: string): AbortSignal;
+    /** [W7-B1] 正在阻塞父回合的任务（前台运行中、或有 `task_ctl wait` 在等）。 */
+    blocking(): string[];
 }
 export declare function registerTaskControl(sessionId: string, control: TaskControl): void;
 export declare function unregisterTaskControl(sessionId: string, control: TaskControl): void;

package/dist/agents/task-record.d.ts

@@ -3,7 +3,7 @@
  * `custom{ama.task}` 快照的写入形状与 resume 重建（docs/wave5-plan.md §7.4–§7.5）。[W5-G]
  * 编排在 agent/subagent-registry.ts。
  */
-import type { SubagentUpdateEvent } from "../agent/types-w5.js";
+import type { SessionTaskStats, SubagentStartEvent, SubagentUpdateEvent } from "../agent/types-w5.js";
 import type { MessageOrigin } from "../ai/types.js";
 import type { SessionEvent } from "../agent/types.js";
 import type { TraceExternalTurnData } from "../trace/types.js";
@@ -130,6 +130,14 @@ export interface TaskRecord {
     direct?: string[];
     /** [W6-A] 下一次续聊是人在视图里发的（子会话 user 消息记 `origin: "direct"`）。 */
     directNext?: boolean;
+    /**
+     * [W7-B1] 前台等待者：launch 时建，转后台时 resolve（工具调用先返回）；结束时删掉。
+     * `detachParent` 解绑父 signal 与进度回调（父回合 Esc 不再连带停止它）。
+     */
+    foregroundWaiter?: {
+        resolve(result: SubagentResult): void;
+        detachParent(): void;
+    };
 }
 export declare function newRecord(info: TaskInfo, agent: AgentDefinition, parentToolCallId: string, cwd: string, isolation?: "none" | "worktree"): TaskRecord;
 export interface ProgressSink {
@@ -142,6 +150,10 @@ export interface ProgressSink {
 export declare function flushText(record: TaskRecord, sink: ProgressSink): void;
 /** runner 进度 → 记录与 `subagent_update`（文本 ≥ 250 ms 合并，轮次与结束时冲刷）。 */
 export declare function applyRunnerEvent(record: TaskRecord, event: SubagentEvent, sink: ProgressSink): void;
+/** `subagent_start` 事件（新开或续聊都发）。 */
+export declare function startEvent(record: TaskRecord, handle: TaskHandle): SubagentStartEvent;
+/** `getStats().tasks`：没有任务时 undefined。 */
+export declare function taskStats(records: Iterable<TaskRecord>): SessionTaskStats | undefined;
 /** 父会话 `custom{ama.task}` 的 data：TaskInfo + 父 toolCallId + 运行目录（带 `status`）。 */
 export declare function recordData(record: TaskRecord): Record<string, unknown>;
 /** 从父会话分支重建（同一 taskId 取最后一条；未结束的标 interrupted）；返回最大序号。 */

package/dist/agents/task-record.js

@@ -209,6 +209,38 @@ function recordDisplay(record, event, now) {
             return;
     }
 }
+/** `subagent_start` 事件（新开或续聊都发）。 */
+export function startEvent(record, handle) {
+    const event = {
+        type: "subagent_start",
+        taskId: record.info.taskId,
+        parentToolCallId: record.parentToolCallId,
+        agent: record.agent.name,
+        runner: record.agent.runner,
+        description: record.info.description,
+        background: record.info.background,
+        cwd: record.cwd,
+    };
+    if (handle.model !== undefined)
+        event.model = handle.model;
+    if (handle.sessionFile !== undefined)
+        event.sessionFile = handle.sessionFile;
+    return event;
+}
+/** `getStats().tasks`：没有任务时 undefined。 */
+export function taskStats(records) {
+    const byStatus = {};
+    let total = 0;
+    let running = 0;
+    for (const { info } of records) {
+        total++;
+        if (info.status === "running")
+            running++;
+        else
+            byStatus[info.status] = (byStatus[info.status] ?? 0) + 1;
+    }
+    return total === 0 ? undefined : { total, running, byStatus };
+}
 /** 父会话 `custom{ama.task}` 的 data：TaskInfo + 父 toolCallId + 运行目录（带 `status`）。 */
 export function recordData(record) {
     return { ...record.info, parentToolCallId: record.parentToolCallId, cwd: record.cwd };

package/dist/agents/types.d.ts

@@ -25,7 +25,11 @@ export interface AgentDefinition {
     /** 缺省 30。 */
     maxTurns: number;
     isolation: "none" | "worktree";
-    background: boolean;
+    /**
+     * 显式覆盖缺省前台 / 后台；不设由 `subagents.background` 决定（[W7-B1]，优先级：调用参数 > 类型
+     * 定义 > 配置）。
+     */
+    background?: boolean;
     runner: AgentRunnerSpec;
     /** 正文：追加到子会话系统提示末尾的角色说明。 */
     prompt: string;

package/dist/ai/providers/discovered-cache.d.ts

@@ -3,9 +3,13 @@
  *
  * 模型表为空、接受任意 slug 的供应商（`chatgpt` 的订阅后端）在选择器里原本一个模型都看不到。
  * `ama auth login chatgpt` 成功后与 `ama models discover chatgpt` 把账户可用的 slug 写进这里；组装注册表时
- * （`mergeDiscoveredModels`）并入**模型表仍为空**的供应商，元数据用 models.dev（快照 ⊕ 用户刷新）补全。
- * `ama auth logout chatgpt` 删掉它。只存 slug、显示名、后端给的元数据（codex：上下文窗口、输入模态、推理强度，
- * models.dev 补不到时用）、flavor 与时间戳——没有 token、账户 id。
+ * （`mergeDiscoveredModels`）并入**模型表仍为空**的供应商。`ama auth logout chatgpt` 删掉它。只存 slug、显示名、
+ * 后端给的元数据（上下文窗口、输入模态、推理强度）、flavor 与时间戳——没有 token、账户 id。
+ *
+ * 元数据优先级：后端明确给的 > models.dev（快照 ⊕ 用户刷新）> 自定义缺省。上下文窗口尤其如此：订阅后端的生效
+ * 窗口（如 codex 的 272k）可能远小于 models.dev 记的 API 版窗口（1.1M），按后者算压缩阈值会让请求超窗被拒。
+ * 旧版本写的缓存（siwc 不含上下文窗口）照旧用 models.dev；`chatgpt` 两边都没有时用保守缺省
+ * `SUBSCRIPTION_FALLBACK_CONTEXT_WINDOW`，不让自动压缩关闭。
  *
  * ChatGPT 的缓存带登录 flavor；组装时与当前登录的 flavor 不符视为过期、不并入（选择器提示重新发现）。
  */
@@ -44,7 +48,9 @@ export declare function writeDiscoveredCache(dataDir: string, provider: string,
 export declare function clearDiscoveredCache(dataDir: string, provider: string): boolean;
 /** 后端给的推理强度 → 思考级别映射（`none` 对应 off；没列出的级别不支持）。 */
 export declare function thinkingMapOf(levels: readonly string[]): Partial<Record<ModelThinkingLevel, string | null>>;
-/** 缓存里的模型 → 注册表模型（models.dev 补元数据，补不到用后端给的，再补不到用自定义缺省）。 */
+/** 订阅后端：models.dev 与后端都没给上下文窗口时的保守缺省。 */
+export declare const SUBSCRIPTION_FALLBACK_CONTEXT_WINDOW = 128000;
+/** 缓存里的模型 → 注册表模型（后端给的元数据优先，其次 models.dev，再次自定义缺省）。 */
 export declare function discoveredModels(file: DiscoveredCacheFile, provider: ProviderData, modelsDev: () => ModelsDevIndex | undefined): Model[];
 /** 注册表里能追加模型的最小接口（`ProviderRegistry.addModels`）。 */
 export interface DiscoveredTarget {

package/dist/ai/providers/discovered-cache.js

@@ -3,9 +3,13 @@
  *
  * 模型表为空、接受任意 slug 的供应商（`chatgpt` 的订阅后端）在选择器里原本一个模型都看不到。
  * `ama auth login chatgpt` 成功后与 `ama models discover chatgpt` 把账户可用的 slug 写进这里；组装注册表时
- * （`mergeDiscoveredModels`）并入**模型表仍为空**的供应商，元数据用 models.dev（快照 ⊕ 用户刷新）补全。
- * `ama auth logout chatgpt` 删掉它。只存 slug、显示名、后端给的元数据（codex：上下文窗口、输入模态、推理强度，
- * models.dev 补不到时用）、flavor 与时间戳——没有 token、账户 id。
+ * （`mergeDiscoveredModels`）并入**模型表仍为空**的供应商。`ama auth logout chatgpt` 删掉它。只存 slug、显示名、
+ * 后端给的元数据（上下文窗口、输入模态、推理强度）、flavor 与时间戳——没有 token、账户 id。
+ *
+ * 元数据优先级：后端明确给的 > models.dev（快照 ⊕ 用户刷新）> 自定义缺省。上下文窗口尤其如此：订阅后端的生效
+ * 窗口（如 codex 的 272k）可能远小于 models.dev 记的 API 版窗口（1.1M），按后者算压缩阈值会让请求超窗被拒。
+ * 旧版本写的缓存（siwc 不含上下文窗口）照旧用 models.dev；`chatgpt` 两边都没有时用保守缺省
+ * `SUBSCRIPTION_FALLBACK_CONTEXT_WINDOW`，不让自动压缩关闭。
  *
  * ChatGPT 的缓存带登录 flavor；组装时与当前登录的 flavor 不符视为过期、不并入（选择器提示重新发现）。
  */
@@ -93,26 +97,38 @@ export function thinkingMapOf(levels) {
         map[level] = levels.includes(level) ? level : null;
     return map;
 }
-/** models.dev 没补上的字段用后端给的元数据。 */
-function withBackendMetadata(model, cached, matched) {
-    if (model.contextWindow === undefined && cached.contextWindow !== undefined)
+/** 订阅后端：models.dev 与后端都没给上下文窗口时的保守缺省。 */
+export const SUBSCRIPTION_FALLBACK_CONTEXT_WINDOW = 128_000;
+const SUBSCRIPTION_PROVIDERS = new Set(["chatgpt"]);
+/** 后端明确给的元数据覆盖 models.dev 补的；没给的字段保留 models.dev 的（maxTokens 只来自 models.dev）。 */
+function withBackendMetadata(model, cached) {
+    if (cached.contextWindow !== undefined) {
         model.contextWindow = cached.contextWindow;
-    if (matched)
-        return;
+        // models.dev 的输入上限是 API 版的，超过后端窗口就没有意义
+        if (model.inputLimit !== undefined && model.inputLimit >= cached.contextWindow)
+            delete model.inputLimit;
+    }
     if (cached.input !== undefined)
         model.input = [...cached.input];
-    const efforts = (cached.reasoningLevels ?? []).filter((x) => x !== "none");
-    if (efforts.length > 0) {
+    if (cached.reasoningLevels === undefined)
+        return;
+    if (cached.reasoningLevels.some((x) => x !== "none")) {
         model.reasoning = true;
-        model.thinkingLevelMap = thinkingMapOf(cached.reasoningLevels ?? []);
+        model.thinkingLevelMap = thinkingMapOf(cached.reasoningLevels);
+    }
+    else {
+        model.reasoning = false;
+        delete model.thinkingLevelMap;
     }
 }
-/** 缓存里的模型 → 注册表模型（models.dev 补元数据，补不到用后端给的，再补不到用自定义缺省）。 */
+/** 缓存里的模型 → 注册表模型（后端给的元数据优先，其次 models.dev，再次自定义缺省）。 */
 export function discoveredModels(file, provider, modelsDev) {
     return file.models.map((m) => {
-        const { entry, metadata } = enrichEntry(m.name ? { id: m.id, name: m.name } : { id: m.id }, modelsDev);
+        const { entry } = enrichEntry(m.name ? { id: m.id, name: m.name } : { id: m.id }, modelsDev);
         const model = withCustomDefaults(entry, provider.id, provider.api);
-        withBackendMetadata(model, m, metadata.match !== undefined);
+        withBackendMetadata(model, m);
+        if (model.contextWindow === undefined && SUBSCRIPTION_PROVIDERS.has(provider.id))
+            model.contextWindow = SUBSCRIPTION_FALLBACK_CONTEXT_WINDOW;
         // 只挂发现时登录的 flavor 对应的渠道（订阅后端的另一条渠道用不了，不在说明与 `@` 行里出现）；
         // 缓存没写 flavor 或渠道不存在时用供应商的缺省渠道
         const names = (provider.channels ?? []).map((c) => c.name);

package/dist/auth/chatgpt/backend-client.d.ts

@@ -1,12 +1,13 @@
 /**
  * ChatGPT 后端的只读查询（[W6-O]）：模型列表（`ama models discover chatgpt`）与 codex 的 `wham/usage`。
  *
- * - SIWC：`GET {base}/models`，只留 `visibility === "list"`（没有该字段的也留）；
+ * - SIWC：`GET {base}/models`，只留 `visibility === "list"`（没有该字段的也留）；条目若带下述元数据字段同样取；
  * - codex：`GET {base}/models?client_version=<Codex CLI 版本>`（`codexClientVersion()`；后端按每个模型的
  *   `minimal_client_version` 过滤，发 ama 自己的版本号会一个都拿不到），`models[].slug`（同样按 visibility 筛），
- *   另取 `context_window`、`input_modalities`、`supported_reasoning_levels` 作元数据（models.dev 补不到时用）；
- *   `GET https://chatgpt.com/backend-api/wham/usage`（由 codex base 推出），私有格式，解析失败返回 undefined。
- * SIWC 只取 slug 与显示名。请求带 Bearer；codex 另带 `ChatGPT-Account-ID` 与 `originator`。
+ *   另取 `context_window`、`input_modalities`、`supported_reasoning_levels` 作元数据（后端给了就优先于 models.dev，
+ *   见 discovered-cache.ts；`max_context_window` 是可调上限而非生效值、`auto_compact_token_limit` 没有对应的模型字段，
+ *   都不取）；`GET https://chatgpt.com/backend-api/wham/usage`（由 codex base 推出），私有格式，解析失败返回 undefined。
+ * 请求带 Bearer；codex 另带 `ChatGPT-Account-ID` 与 `originator`。
  */
 import { type QuotaSnapshot } from "../../ai/apis/chatgpt-rate-limits.js";
 import type { ChatGptFlavor } from "../../config/types-w6.js";
@@ -23,7 +24,7 @@ export interface BackendAuth {
 export interface DiscoveredModel {
     id: string;
     name?: string;
-    /** 以下只有 codex 后端给。 */
+    /** 以下是后端给的元数据（codex 后端给；SIWC 条目带了也取）。 */
     contextWindow?: number;
     input?: ("text" | "image")[];
     /** 支持的推理强度（`none` / `minimal` / `low` / `medium` / `high` / `xhigh` …）。 */

package/dist/auth/chatgpt/backend-client.js

@@ -1,12 +1,13 @@
 /**
  * ChatGPT 后端的只读查询（[W6-O]）：模型列表（`ama models discover chatgpt`）与 codex 的 `wham/usage`。
  *
- * - SIWC：`GET {base}/models`，只留 `visibility === "list"`（没有该字段的也留）；
+ * - SIWC：`GET {base}/models`，只留 `visibility === "list"`（没有该字段的也留）；条目若带下述元数据字段同样取；
  * - codex：`GET {base}/models?client_version=<Codex CLI 版本>`（`codexClientVersion()`；后端按每个模型的
  *   `minimal_client_version` 过滤，发 ama 自己的版本号会一个都拿不到），`models[].slug`（同样按 visibility 筛），
- *   另取 `context_window`、`input_modalities`、`supported_reasoning_levels` 作元数据（models.dev 补不到时用）；
- *   `GET https://chatgpt.com/backend-api/wham/usage`（由 codex base 推出），私有格式，解析失败返回 undefined。
- * SIWC 只取 slug 与显示名。请求带 Bearer；codex 另带 `ChatGPT-Account-ID` 与 `originator`。
+ *   另取 `context_window`、`input_modalities`、`supported_reasoning_levels` 作元数据（后端给了就优先于 models.dev，
+ *   见 discovered-cache.ts；`max_context_window` 是可调上限而非生效值、`auto_compact_token_limit` 没有对应的模型字段，
+ *   都不取）；`GET https://chatgpt.com/backend-api/wham/usage`（由 codex base 推出），私有格式，解析失败返回 undefined。
+ * 请求带 Bearer；codex 另带 `ChatGPT-Account-ID` 与 `originator`。
  */
 import { parseUsagePayload } from "../../ai/apis/chatgpt-rate-limits.js";
 import { DEFAULT_CODEX_CLIENT_VERSION, DEFAULT_ORIGINATOR } from "./presets.js";
@@ -27,8 +28,8 @@ function listed(item) {
     const visibility = item["visibility"];
     return visibility === undefined || visibility === "list";
 }
-/** codex 模型条目里的元数据；字段缺失或形状不对就不填。 */
-function codexMetadata(item) {
+/** 模型条目里的元数据；字段缺失或形状不对就不填。 */
+function backendMetadata(item) {
     const out = {};
     const window = item["context_window"];
     if (typeof window === "number" && Number.isInteger(window) && window > 0)
@@ -80,7 +81,7 @@ export async function listChatGptModels(fetchFn, baseUrl, auth) {
         out.push({
             id,
             ...(typeof name === "string" && name !== "" ? { name } : {}),
-            ...(auth.flavor === "codex" ? codexMetadata(item) : {}),
+            ...backendMetadata(item),
         });
     }
     return out;