@tencent-ai/agent-harness 0.2.0-beta.1 → 0.2.0-beta.2

package/cli/dist-server/types/workspace/cbc-core/lib/node/session/stream-timeout-retry-budget.d.ts

@@ -6,9 +6,21 @@ import type { Session } from './session-protocol.js';
  * terminal results are suppressed only while a retry will actually be scheduled.
  */
 export declare function hasExhaustedStreamTimeoutRetryBudget(session: Session, isFirstTokenTimeout: boolean): boolean;
+/**
+ * `finish_reason=error` 且没有可用输出的两种空流：reasoning-only 与 no-token。
+ * placeholder（空 200 / 心跳帧）仍是会话层终态，由拦截器切一次备站。
+ */
 export declare function isRetryableEmptyStreamError(error: unknown): boolean;
 /**
  * Empty 200 / placeholder-only：拦截器最多切一次备站，会话层终态（#115866）。
- * reasoning-only + finish_reason=error：上游瞬时失败，会话层最多重试 1 次（#122115）。
+ * reasoning-only / no-token + finish_reason=error：上游瞬时失败，按 error 预算重试。
+ * 流空闲超时 / 首 token 超时：按各自的超时预算重试。
  */
 export declare function shouldAutoRetryStreamTimeout(session: Session, error: unknown): boolean;
+/**
+ * 为一次流错误恢复认领额度，返回序号（1-based）；不可重试或已耗尽返回 `undefined`。
+ * 调用方必须先用 {@link shouldAutoRetryStreamTimeout} 判定，本函数只负责同步认领。
+ */
+export declare function claimStreamRecoveryAttempt(session: Session, error: unknown): number | undefined;
+/** 认领后没有真正发起恢复时退回额度。 */
+export declare function releaseStreamRecoveryAttempt(session: Session, error: unknown): void;

package/cli/dist-server/types/workspace/cbc-core/lib/node/utils/history-utils.d.ts

@@ -364,6 +364,29 @@ export declare abstract class HistoryUtils {
      */
     static filterApiErrorMessages(history: AgentInputItem[]): AgentInputItem[];
     static filterRenameHistory(history: AgentInputItem[]): AgentInputItem[];
+    /**
+     * 让 model input 里的 tool_call 与 tool_result 严格一一配对（issue #119545）。
+     *
+     * 背景：工具结果丢失（状态机吞掉 TOOL_ENDED、持久化缺口、压缩切断）后，历史里会留下
+     * 只有 call、没有任何 result 的孤儿。上游对 tool_calls 强制配对，一条孤儿就让整个
+     * 请求 400，会话从此不可恢复——而本地历史里的孤儿是持久化的，每次恢复都会重现。
+     *
+     * 三类都处理，因为上游拒的是"不配对"这件事本身，方向无关：
+     * 1. call 没有任何同 callId 的结果项 → 丢 call；
+     * 2. 同一 callId 出现多条 call（重放/重试残留）→ 只留最后一条；
+     * 3. 结果项的 callId 没有留下来的 call（头部被截断，或 call 属于上面两类）→ 丢结果。
+     *
+     * 判据只看"存在性"，不看结果的真伪：skipRun 占位/拒绝、partial aborted 等伪结果都算
+     * 配对，它们的取舍归 filterTruncatedToolCalls，两者职责不重叠。改写只落在当轮副本上，
+     * 因此日志按轮聚合成一条并截断样本。
+     */
+    static filterUnpairedToolCalls(modelData: {
+        input: AgentInputItem[];
+        instructions?: string;
+    }, logger?: Logger): {
+        input: AgentInputItem[];
+        instructions?: string;
+    };
     static getItemsNeedingFill(history: AgentInputItem[]): FunctionCallItem[];
     static getFillItemsForNeedingFill(itemsNeedingFill: FunctionCallItem[]): FunctionCallResultItem[];
     /**

package/cli/dist-server/types/workspace/cbc-core/lib/node/utils/index.d.ts

@@ -23,5 +23,6 @@ export * from './queue-dispatch-utils.js';
 export * from './run-result-utils.js';
 export * from './session-utils.js';
 export * from './summary-utils.js';
+export * from './string-retention-utils.js';
 export * from './token-utils.js';
 export * from './usage-utils.js';

package/cli/dist-server/types/workspace/cbc-core/lib/node/utils/message-utils.d.ts

@@ -79,6 +79,18 @@ export declare abstract class MessageUtils {
     static createFilteredCopyForCompaction(messages: AgentInputItem[]): AgentInputItem[];
     private static filterHiddenSystemRemindersForCompaction;
     static stripSystemRemindersOutsideUserQuery(text: string): string;
+    /**
+     * 压缩链路的统计日志出口。
+     *
+     * **禁止改回 `process.stderr.write` / `process.stdout.write`**（issue #76749）：
+     * TUI 下裸写 stderr 会破坏 Ink 帧间光标定位，导致行级 diff 错位、spinner 残留。
+     * 走 logger 落盘即可，既保留排查信息又不碰 TTY。
+     *
+     * `catch` 有意整段吞掉，不做分级上报：日志出口的任何失败（容器未就绪、logger 自身
+     * 抛错）都不得影响压缩本身；而「失败时改走 stderr 兜底」恰会在异常路径上重新引入
+     * 本 issue 要修掉的 TTY 裸写。统计丢失是可接受的降级。
+     */
+    private static logCompaction;
     /**
      * Microcompact: clear output of old tool results (> 1 hour) to reduce token count.
      * Modifies items in place. Should be called BEFORE createFilteredCopyForCompaction.

package/cli/dist-server/types/workspace/cbc-core/lib/node/utils/model-utils.d.ts

@@ -70,6 +70,13 @@ export declare abstract class ModelUtils {
      */
     private static readRuntimeModelId;
     static isHunyuanModel(session: Session): Promise<boolean>;
+    /**
+     * ImageGen 实际使用的图片模型是否为混元。
+     *
+     * 取「产品配置里第一个带 text-to-image tag 的模型」，与 image-service 的解析顺序一致；
+     * 配置里没有图片模型时会走客户端的混元兜底模型，同样按混元处理。
+     */
+    static isHunyuanImageModel(): Promise<boolean>;
     static isMandatoryApprovalTarget(session: Session, targetToolName: string): Promise<boolean>;
 }
 export {};

package/cli/dist-server/types/workspace/cbc-core/lib/node/utils/queue-dispatch-utils.d.ts

@@ -17,7 +17,8 @@ import type { Session } from '../session/session-protocol.js';
  * 取；CLI **不再自动 drain**。后果有两条，改这块代码前必须知道：
  *  1. `session.queue` 降级为 rich queue 的**展示镜像**（只给 CLI TUI 看），镜像段由
  *     `RichMessageQueueManagerImpl.syncToSessionQueue` 整体重建；
- *  2. 上面列举的那些 legacy 自动 drain 路径**全部被显式短路**。
+ *  2. 主会话的 legacy 自动 drain 路径被短路。子任务没有客户端派发者，仍由
+ *     MessageQueueAgentRunInterceptor 消费非镜像项（包括普通 user 消息）。
  *
  * 因此在 Mode B 下 `session.queue` 是两个所有者共用的数组：镜像段属于 rich queue，
  * 系统注入项（后台任务通知 / channel / teammate / ACP steer 等）属于各自的注入方。任何一方读写它时
@@ -63,9 +64,30 @@ export declare abstract class QueueDispatchUtils {
      * 从 `session.queue` 里挑出「自动 drain 通道」该消费的项。
      *
      * Mode A：整个队列都是待发输入，原样返回（保持既有行为）。
-     * Mode B：只返回系统注入项，rich queue 的展示镜像不属于本通道。
+     * Mode B 主会话：只返回系统注入项。子任务：所有非镜像项都是真实待发输入。
      */
     static ownedQueueItems(session: Session): AgentInputItem[];
+    /** Task runtimes have no client queue dispatcher, including restored child sessions. */
+    static isTaskQueue(session: Session): boolean;
+    /** The legacy interceptor owns all Mode A input and Mode B task input, never rich mirrors. */
+    static usesLocalQueueDispatch(session: Session): boolean;
+    static autoDrainQueueItems(session: Session): AgentInputItem[];
+    /**
+     * Observe which items one drain invocation actually consumed.
+     *
+     * **`input` is matched by array *identity*, not contents** — a copy observes
+     * nothing, and the caller then reads a failed drain as having consumed
+     * nothing. Per instance rather than per session because a session-wide
+     * snapshot cannot tell this batch apart from a competing run's.
+     *
+     * @returns disposer; call it once the run settles.
+     */
+    static observeQueueDrain(input: AgentInputItem[], observer: (items: AgentInputItem[], signal?: AbortSignal) => void): () => void;
+    /**
+     * Report the items consumed for `input`. No-op when nobody observes that
+     * exact array instance — see {@link observeQueueDrain} for the contract.
+     */
+    static recordQueueDrain(input: AgentInputItem[], items: AgentInputItem[], signal?: AbortSignal): void;
     /**
      * Async check — reads product config when env var is not set.
      */

package/cli/dist-server/types/workspace/cbc-core/lib/node/utils/session-utils.d.ts

@@ -11,7 +11,10 @@ export declare abstract class SessionUtils {
      * session 中发生实际可见的 ID 冲突。
      */
     static subAgentId(): string;
-    static isSubAgent(session: Session): boolean;
+    static isSubAgent(session: {
+        id?: string;
+        storeId?: string;
+    }): boolean;
     /**
      * Clone one history item for a fork without duplicating large string payloads.
      *

package/cli/dist-server/types/workspace/cbc-core/lib/node/utils/string-retention-utils.d.ts

@@ -0,0 +1,4 @@
+/** Materialize an independent string without changing its UTF-16 code units. */
+export declare function copyString(value: string): string;
+/** Truncate by JavaScript string length and detach the retained prefix from its parent. */
+export declare function truncateAndCopyString(value: string, maxLength: number, suffix?: string): string;

package/cli/dist-server/types/workspace/cbc-shared/lib/node/hooks/hook-types.d.ts

@@ -83,7 +83,13 @@ export declare enum HookEvent {
     FILE_CHANGED = "FileChanged",
     CWD_CHANGED = "CwdChanged",
     /** Terminal event; does not support continueRequest. */
-    FINAL_STOP = "FinalStop"
+    FINAL_STOP = "FinalStop",
+    /**
+     * Triggered when a user-typed command/skill expands into a prompt, before
+     * it reaches the model. Can block the expansion.
+     * Claude Code parity: matcher filters on `command_name`.
+     */
+    USER_PROMPT_EXPANSION = "UserPromptExpansion"
 }
 /** Hook script stdout payload. */
 export interface HookOutput {

package/cli/dist-server/types/workspace/cbc-shared/lib/node/index.d.ts

@@ -1,6 +1,8 @@
 export * from './agent/openai-agents-types.js';
 export * from './agent-home/agent-home-envelope-body.js';
 export * from './utils/abort-utils.js';
+export * from './utils/retry-backoff.js';
+export * from './utils/retry-policy.js';
 export * from './settings/settings-types.js';
 export * from './tools/tool-permission-types.js';
 export * from './tools/tool-permission-messages.js';

package/cli/dist-server/types/workspace/cbc-shared/lib/node/model/model-errors.d.ts

@@ -17,10 +17,14 @@ export declare class StreamTimeoutError extends CustomError {
 }
 /**
  * placeholder：空 200 / 心跳占位，拦截器最多切一次备站，会话层终态。
- * reasoning-only：已流出思考、finish_reason=error 且无可用输出（#63761 / #122115），
- * 会话层允许 1 次有界重试。
+ * reasoning-only：已流出思考、finish_reason=error 且无可用输出（#63761 / #122115）。
+ * no-token：finish_reason=error 到达时一个模型 token 都没有（连 reasoning 也没有）。
+ *
+ * reasoning-only 与 no-token 都是上游瞬时失败，会话层按 error 恢复预算重试；
+ * placeholder 必须与 no-token 分开——两者共用一个值时，放开 no-token 会连带
+ * 推翻空 200 的终态判定。
  */
-export type EmptyStreamKind = 'placeholder' | 'reasoning-only';
+export type EmptyStreamKind = 'placeholder' | 'reasoning-only' | 'no-token';
 /**
  * 空流错误
  * 语义上仍然是"上游没有提供模型输出"，所以继承 StreamTimeoutError

package/cli/dist-server/types/workspace/cbc-shared/lib/node/tools/tool-names.d.ts

@@ -63,6 +63,7 @@ export declare enum ToolNames {
     WAIT_FOR_MCP_SERVERS = "WaitForMcpServers",
     WORKFLOW = "Workflow",
     VIDEO_GEN = "VideoGen",
+    AUDIO_TRANSCRIBE = "AudioTranscribe",
     REPORT_FINDINGS = "ReportFindings",
     MONITOR = "Monitor",
     LIST_AGENTS = "ListAgents",

package/cli/dist-server/types/workspace/cbc-shared/lib/node/utils/retry-backoff.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 自动恢复链的统一口径：最多 3 次，1s 起步、2 倍指数退避（基准 1s → 2s → 4s）。
+ *
+ * 适用于会话层的 error / 网络 / 流超时恢复，以及模型层的连接级透明重试。
+ * 第 1 层请求级（429/502/503 等）不带网关 retry_policy 时仍保持自己的 500ms 基数，
+ * 所以这里只共享算法，基数与上限由调用方传入。
+ */
+export declare const MAX_RECOVERY_RETRIES = 3;
+export declare const RECOVERY_RETRY_BASE_DELAY_MS = 1000;
+export declare const RECOVERY_RETRY_MAX_DELAY_MS = 32000;
+export interface ExponentialBackoffOptions {
+    baseDelayMs: number;
+    maxDelayMs: number;
+    random?: () => number;
+}
+/**
+ * `base * 2^(attempt-1)` 封顶到 `maxDelayMs`，再做 25% 下减抖动（区间 `[0.75x, 1x]`）。
+ *
+ * 必须下减而不是上加：上加会让实际等待越过 `maxDelayMs` 25%，调用方对封顶的承诺就不成立。
+ * `attempt` 从 1 起，小于 1 按 1 处理。
+ */
+export declare function computeExponentialBackoffMs(attempt: number, options: ExponentialBackoffOptions): number;
+export declare function computeRecoveryBackoffMs(attempt: number, random?: () => number): number;
+/**
+ * 可取消的等待。`signal` 在等待前或等待中 abort 时返回 `false`，正常等满返回 `true`。
+ *
+ * 返回布尔而不是 reject：恢复链上的调用方拿到 `false` 后要自己决定退还额度、跳过发起，
+ * 用异常表达会把「用户取消」和「真正的错误」混在一条 catch 路径里。
+ */
+export declare function waitForRecoveryBackoff(ms: number, signal?: AbortSignal): Promise<boolean>;

package/cli/dist-server/types/workspace/cbc-shared/lib/node/utils/retry-policy.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 模型网关在 HTTP 错误体里下发的重试指示，与 `code` / `msg` / `displayMsg` 同层：
+ *
+ * ```json
+ * { "code": 11101, "msg": "...", "retry_policy": { "retry": false }, "displayMsg": { ... } }
+ * ```
+ *
+ * - `force-retry`：策略是普通对象且 `retry !== false`（含 `true`、缺 `retry` 键、类型异常）。
+ *   只在本地已判定可重试的范围内把请求级重试提到 3 次，不扩大可重试状态码。
+ * - `forbid-retry`：策略是普通对象且 `retry === false`。不重试、不换模型、不重放备站、不做鉴权刷新重试。
+ * - `unset`：字段缺失、`null`、数组或其他非对象形态，完全按原有逻辑处理。
+ *
+ * 只有显式 `false` 才阻断：网关形态小改动时宁可多试一次，也不要静默丧失恢复能力。
+ */
+export type RetryPolicyDecision = 'force-retry' | 'forbid-retry' | 'unset';
+export declare const RETRY_POLICY_FIELD = "retry_policy";
+/**
+ * 按固定层级找 `retry_policy` 原值，返回第一个存在的值（可能是非法形态，由调用方裁决）。
+ *
+ * 同一份策略会以三种形态出现：网关原始错误体（顶层或 `data` / `error.data`）、错误分析器
+ * 规范化后的 `{ error: { code, message, data } }`、SDK 包装后的 APIError（`error.data`，
+ * 外层再包一层时为 `error.error.data`）。层级写死、不递归，避免在任意嵌套里误捡字段。
+ */
+export declare function findRetryPolicy(source: unknown): unknown;
+export declare function decideRetryPolicy(policy: unknown): RetryPolicyDecision;
+export declare function resolveRetryPolicy(source: unknown): RetryPolicyDecision;

package/cli/dist-server/types/workspace/cbc-workflow/lib/node/workflow/workflow-execution.d.ts

@@ -194,7 +194,15 @@ export declare class WorkflowExecution {
     abortAgent(key: string, reason: string): boolean;
     private buildSpec;
     private makeStartedRecord;
-    /** Prompt 截到 ≤4KB,与 resultPreview 同口径 */
+    /**
+     * Prompt 截到 ≤4KB,与 resultPreview 同口径。
+     *
+     * **OOM 防护 · 父串不钉**:agentLog 长期驻留 ≤200 条 record(每 run),
+     * 若这里直接 `prompt.slice(0, max)` 返回,V8 会让该 substring 共享原 `prompt`
+     * 的 backing buffer —— 主 chat 一段 100KB 的用户输入,只要有一条 record
+     * 引用 4KB slice,整段 100KB 都无法被 GC。改走 `truncateAndCopyString`
+     * 强制 detach 到独立 buffer,length/marker 语义保持不变。
+     */
     static previewPrompt(prompt: string): string;
     private handleCacheHit;
     private markFailedAndEmit;
@@ -238,6 +246,11 @@ export declare class WorkflowExecution {
      *   不至于像一坨 `{"results":[{"url":"...","title":"..."}` 横向铺满终端
      * - 失败回落到 `String()`
      * - undefined / null → undefined(让 record.resultPreview 自然缺省)
+     *
+     * **OOM 防护 · 父串不钉**:同 previewPrompt —— agentLog 长期驻留,slice
+     * 会共享原始文本 backing buffer,导致原本可回收的大 result 被 record 钉住。
+     * 走 `truncateAndCopyString` 物化有界父串(短值同样 copy),
+     * length/marker 语义保持不变。
      */
     static previewOf(result: unknown): string | undefined;
 }

package/cli/dist-server/types/workspace/cbc-workflow/lib/node/workflow/workflow-manager.d.ts

@@ -129,6 +129,13 @@ export declare class WorkflowManagerImpl implements WorkflowManager {
      *   1. meta.description
      *   2. args 是字符串(CC v2.1 标准形态) → 直接截断
      *   3. args 是对象且有 .question(老形态兜底,保留兼容)
+     *
+     * **OOM 防护 · 父串不钉**:args/question 分支的 200 字符截断 走
+     * `truncateAndCopyString` —— description 会经 `initialRecord` → `finalRecord`
+     * → `recent[].record`(队列上限 50)长期驻留;直接 `.slice(0, 200)` 会让
+     * substring 共享原始 args 的 backing buffer,一段几十 KB 的用户输入被 200
+     * 字符预览钉住。长度语义保持不变(≤200 原样、>200 截到 200,不带 marker)。
+     * meta.description 走 JSDoc 元数据、既不是 slice 也无长度截断,保留原逻辑。
      */
     private deriveDescription;
 }

package/cli/dist-server/types/workspace/cbc-worktree/lib/node/worktree/worktree-session.d.ts

@@ -22,6 +22,8 @@ export declare class WorktreeSessionManagerImpl implements IWorktreeSessionManag
      * 在进程生命周期内维护
      */
     private currentSession;
+    /** 当前进行中的删除操作，避免重复退出事件并发删除同一个 worktree。 */
+    private removeOperation;
     private setSessionProgress;
     /**
      * 创建 worktree 会话
@@ -68,6 +70,7 @@ export declare class WorktreeSessionManagerImpl implements IWorktreeSessionManag
      * 4. 清除会话状态
      */
     removeWorktree(): Promise<WorktreeExitOperationResult | undefined>;
+    private performRemoveWorktree;
     /**
      * 处理退出
      * 检测变更并根据情况显示退出选项或自动清理

package/cli/dist-server/types/workspace/product/lib/common/cloud-product-provider.d.ts

@@ -15,6 +15,8 @@ export declare class CloudProductProvider implements ProductProvider {
     protected readonly cloudProductManager: CloudProductManager;
     /** Process-wide duplicate suppression for consecutive skip reasons. */
     protected lastSkipReason?: string;
+    /** Consecutive skips carrying {@link lastSkipReason}; drives the log schedule. */
+    protected consecutiveSkips: number;
     protected init(): void;
     /**
      * 记录一次「本轮没去拉云端配置」并返回空配置。
@@ -23,6 +25,13 @@ export declare class CloudProductProvider implements ProductProvider {
      * 「没去拉」与「拉失败」（#58031 因此被误判为模型未上线）。
      *
      * level：warn=非预期状态值得排查，info=按配置有意禁用，避免污染告警。
+     *
+     * 只打「同因首次」是不够的（#129839）：启动期竞态下第 1 轮因登录态未就绪判
+     * config-disabled，第 2 轮补拉**同因再跳一次**却被整条吃掉，现场只看得到一行，
+     * 误以为补拉已生效，实际 /model 一直是打包内置旧清单。改为按 1/2/4/8… 的次数
+     * 打点并带上连续计数：既保留原有的抗刷屏意图（`provide()` 每轮都跑，历史上无
+     * 条件 info 影响过流水线，见 9c1d1e55df0），又让「连续跳过」这一状态始终可见，
+     * 且行数是 O(log n) 有界的。现场日志不采集 debug，所以不能降级为 debug。
      */
     protected skip(ctx: ProductProviderContext, reason: string, level: 'warn' | 'info'): ProductConfiguration;
     provide(ctx: ProductProviderContext): Promise<ProductConfiguration>;

package/cli/dist-server/types/workspace/product/lib/common/index.d.ts

@@ -1,4 +1,5 @@
 export * from './types/index.js';
+export { pickMarketSkillIdFromMeta } from './pick-market-skill-id.js';
 export * from './product-protocol.js';
 export * from './repository-protocol.js';
 export * from './product-manager.js';

package/cli/dist-server/types/workspace/product/lib/common/pick-market-skill-id.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 从市场 meta（`_skillhub_meta` / `_knot_meta` / `_user_meta` / `_marketplace_meta`）
+ * 里取市场身份。
+ *
+ * 四级取值链取写侧最宽的那份。现实中 Knot 的 `slug` 恒非空
+ * （`knot.ts` 的 `metaSlug = slug || skillName || String(id)`），因此 `skill_id`
+ * 与 `id` 两级是防御性的；保留它们是为了让读写两侧用**同一个函数**，
+ * 而不是让读侧比写侧窄。
+ *
+ * 契约归属 `@genie/product`：写侧（listNonPlatformSkillBlacklistItems）与读侧
+ * （Skill.skillId / skill_info 遥测）必须算出同一个值，否则黑名单执法漏拦。
+ */
+export declare function pickMarketSkillIdFromMeta(meta: Record<string, unknown> | null | undefined): string | undefined;

package/cli/dist-server/types/workspace/product/lib/common/tool-control-catalog.d.ts

@@ -5,9 +5,9 @@
  * marketplace MCP Servers must not enter the policy surface implicitly.
  */
 export declare const WORKBUDDY_PRODUCT_TOOL_NAMES: readonly ['WebFetch', 'WebSearch', 'ImageGen', 'VideoGen', 'ListMcpResources', 'ReadMcpResource', 'DelegateTool', 'WeChatReply', 'WeComReply'];
-export declare const WORKBUDDY_REQUIRED_TOOL_NAMES: readonly ['Read', 'Write', 'Edit', 'MultiEdit', 'Glob', 'Grep', 'Bash', 'PowerShell', 'AskUserQuestion', 'TaskCreate', 'TaskGet', 'TaskUpdate', 'TaskList', 'TaskStop', 'TaskOutput', 'Skill', 'LSP', 'Agent', 'SendMessage', 'ToolSearch', 'DeferExecuteTool', 'EnterPlanMode', 'ExitPlanMode', 'present_files', 'widget_guidelines', 'show_widget', 'TeamCreate', 'TeamDelete', 'SkillManage', 'StructuredOutput'];
+export declare const WORKBUDDY_REQUIRED_TOOL_NAMES: readonly ['Read', 'Write', 'Edit', 'MultiEdit', 'Glob', 'Grep', 'Bash', 'PowerShell', 'AskUserQuestion', 'TaskCreate', 'TaskGet', 'TaskUpdate', 'TaskList', 'TaskStop', 'TaskOutput', 'Skill', 'LSP', 'Agent', 'SendMessage', 'ToolSearch', 'DeferExecuteTool', 'EnterPlanMode', 'ExitPlanMode', 'present_files', 'widget_guidelines', 'show_widget', 'TeamCreate', 'TeamDelete', 'StructuredOutput'];
 export declare const WORKBUDDY_BUNDLED_MCP_SERVERS: {
-    readonly 'connector-proxy': readonly ['connect_cloud_service', 'connect_open_platform', 'workbuddy_sites_deploy', 'workbuddy_sites_unpublish', 'workbuddy_cloud_service', 'workbuddy_update_app_preview_entry', 'workbuddy_marketplace_skill', 'domain_search', 'automation_update', 'conversation_search', 'pick_location', 'agent_mail_upload_attachment', 'agent_mail_download_attachment', 'search_plugins', 'suggest_plugin_install'];
+    readonly 'connector-proxy': readonly ['connect_cloud_service', 'connect_open_platform', 'workbuddy_sites_deploy', 'workbuddy_sites_unpublish', 'workbuddy_cloud_service', 'workbuddy_update_app_preview_entry', 'search_and_install_skills', 'skill_management', 'domain_search', 'automation_update', 'conversation_search', 'pick_location', 'agent_mail_upload_attachment', 'agent_mail_download_attachment', 'search_plugins', 'suggest_plugin_install', 'list_installed_plugins', 'uninstall_plugin'];
     readonly miora: readonly ['miora_write_canvas', 'miora_open_canvas', 'miora_text_to_image', 'miora_edit_image', 'miora_text_to_video', 'miora_frame_to_video', 'miora_reference_to_video', 'miora_query_task'];
     readonly sheetagent: readonly ['resolve_local_excel', 'get_cell_ranges', 'set_cell_range', 'read_table', 'run_command', 'search_data', 'calculate_single_formula', 'calculate_formulas', 'fill_formula'];
     readonly weixinpay: readonly ['weixinpay_register', 'weixinpay_feedback', 'weixinpay_retry_pay', 'weixinpay_pay'];

package/cli/dist-server/types/workspace/product/lib/common/types/features.d.ts

@@ -911,6 +911,10 @@ export declare enum ProductFeature {
      * 是否启用文生视频功能
      */
     VideoGen = "VideoGen",
+    /**
+     * 是否启用录音文件识别（长音频转文本）功能
+     */
+    AudioTranscribe = "AudioTranscribe",
     /**
      * 是否开启 Artifact（本地 HTML/Markdown → 上传 → 可分享公网链接）能力。
      * issue #81031：ShareLink 工具更名为 Artifact 后的新规范 key；
@@ -1056,6 +1060,41 @@ export declare enum ProductFeature {
      * @default false
      */
     QuickQa = "QuickQa",
+    /**
+     * 首页「快速问答」入口开关。issue #124324
+     *
+     * 与 `QuickQa` **相互独立，不做 AND**：`QuickQa` 管能力本体（划词入口、推荐胶囊、
+     * embed 空视图、会话内 mode 展示），本 key 只管首页那条新建链路 —— 场景 Tab
+     * （设计创意之后的第 4 项）、`Meta/Ctrl+Shift+N`、首页输入框的 quick 模式项。
+     *
+     * ⚠️ **缺省值按账号算，不是固定布尔**：IOA 企业（`IOA_ENTERPRISE_IDS`）缺省开启，
+     * 其余（个人账号 / 非 IOA 企业 / 未登录）缺省关闭。因此 **`product.json` 里故意
+     * 不登记这个 key** —— 注入快照里一旦有 key 就走不到 `missingKeyEnabled`，写成全局
+     * 布尔会把 IOA 判定整个压掉。远端 `v3/config` 显式下发时以远端为准。
+     *
+     * 实现见 `agent-ui` 的 `useHomeQuickAskEntryFeatureEnabled`。
+     * @default IOA 为 true，其余为 false
+     */
+    QuickAskEntry = "QuickAskEntry",
+    /**
+     * 侧栏一级入口收敛开关。issue #124324
+     *
+     * 启用后：宿主入口文案与图标从「更多」改为「发现」，下拉按分组补分割线；且对**没配置过
+     * 自定义菜单**的用户，一级栏收到「新建任务 / 定时任务 / 资料库」+ 末位「发现」共 4 项，
+     * 助理、项目、专家、运营自建菜单、其余 sidebar extension 默认下沉进「发现」。
+     * 关闭后：一级栏与下拉维持收敛前的原样（入口不下沉、宿主入口仍叫「更多」、无分割线）。
+     *
+     * ⚠️ 两个粒度不同，见 `useSidebarPrimaryCollapse`：
+     *   1. 「发现」外观与分割线**只看本 flag**，与用户有没有拖过菜单无关。
+     *   2. **下沉**额外要求用户没配置过自定义菜单 —— 已存配置里的 id 会被
+     *      `restoreCustomMenuDialogValue` 按存档分区放回去，下沉对这些用户只能半生效，
+     *      所以条目位置一律听用户的配置。
+     *
+     * 缺省值按账号算（IOA 开、其余关），因此 **`product.json` 故意不登记这个 key** —— 与
+     * `QuickAskEntry` 同理，注入快照里一旦有 key 就走不到 `missingKeyEnabled`。
+     * @default IOA 为 true，其余为 false
+     */
+    SidebarPrimaryCollapse = "SidebarPrimaryCollapse",
     /**
      * 主任务新引擎的**远端灰度/紧急回滚**开关。
      * - 远端缺 key → 解析为 true（不阻断）；显式 false → 强制回退 MainContentCore
@@ -1128,7 +1167,7 @@ export declare enum ProductFeature {
      */
     TencentDocsCloudSandboxBridge = "TencentDocsCloudSandboxBridge",
     /**
-     * 内置 tencent-pptx 插件首次 seed 时默认开启。
+     * 内置 workbuddy-pptx 插件首次 seed 时默认开启。
      * 设置为 false 时跳过默认写入 enabledPlugins（kill-switch）。
      * @default true
      */
@@ -1715,6 +1754,11 @@ export declare enum ProductFeature {
      * @see Issue #96599
      */
     ModelRateLimitCap = "ModelRateLimitCap",
+    /**
+     * 模型 Preview 试用期常驻 Banner 的结构化规则配置。
+     * 配置位于 `productFeaturesConfig[ModelTrialBanner].banners`，缺失即关闭。
+     */
+    ModelTrialBanner = "ModelTrialBanner",
     /**
      * Agent CLI 出站 A2A（Agent2Agent）能力总开关（issue #99451）。
      *
@@ -1825,7 +1869,23 @@ export declare enum ProductFeature {
      *
      * @default true
      */
-    TuringDeviceToken = "TuringDeviceToken"
+    TuringDeviceToken = "TuringDeviceToken",
+    /**
+     * 统一资产管理总开关（#92015，对齐 feature/unified-asset-mgmt 分支）。
+     * 打开即完整执法（拦截 / 执行 / 删除 / 付费），关闭时完全保持既有
+     * Expert/Skill/Connector 行为。消费方为 `@genie/unified-asset` 的
+     * `isUnifiedAssetEnabled`（CLI 侧 Skill Guard Hooks 与 server 侧门控共用）。
+     * @default false
+     */
+    UnifiedAsset = "UnifiedAsset",
+    /**
+     * 技能订阅门控（付费技能 pre-call 拦截）。
+     * check 链路已 fail-close，门控默认生效（缺省开）是更安全方向。
+     * 当前无云端开关设计，仅登记 key 预留口子——后续接灰度开关时经
+     * productFeatures 下发（消费方 skill-subscription-gate.isEnabled）。
+     * @default true
+     */
+    SkillSubscriptionGate = "SkillSubscriptionGate"
 }
 /**
  * 功能配置开关

package/cli/dist-server/types/workspace/product/lib/common/types/language-model.d.ts

@@ -32,6 +32,24 @@ export interface ModelContextWindow {
      */
     defaultLength?: number;
 }
+/**
+ * 视频生成能力声明（VideoGen 使用）。
+ *
+ * 分辨率未声明时按通用缺省处理：支持 720P / 1080P，默认 1080P。
+ * 时长未声明时仅使用通用默认值，且不接受调用方指定时长。
+ */
+export interface ModelVideoGeneration {
+    /** 支持的分辨率档位，如 ['480P', '720P'] */
+    resolutions?: ReadonlyArray<string>;
+    /** 默认分辨率档位，如 '720P'；应落在 resolutions 内 */
+    defaultResolution?: string;
+    /** 支持的最短视频时长（秒），如 4；与 maxSeconds 成对声明 */
+    minSeconds?: number;
+    /** 支持的最长视频时长（秒），如 30；与 minSeconds 成对声明 */
+    maxSeconds?: number;
+    /** 默认视频时长（秒），如 5；应落在 minSeconds 与 maxSeconds 之间 */
+    defaultSeconds?: number;
+}
 export interface ModelReasoning {
     /**
      * @deprecated 使用 {@link defaultEffort} 替代；保留仅为向后兼容旧 product config。
@@ -148,6 +166,52 @@ export interface ModelGroup {
     readonly trailingActions?: readonly string[];
     readonly order?: number;
 }
+/**
+ * 用户会员类型（Issue #87302），供 {@link ModelTier.requiredUserType} 引用。
+ *
+ * ⚠️ 这是 `@genie/agent-provider.UserType` 的镜像，字段必须保持一致。
+ * 不在此处直接 import `@genie/agent-provider`（product 是上层，会引入反向依赖），
+ * 与 {@link ModelPromotion} 同款处理。
+ */
+export type UserType = 'free' | 'standard' | 'youth' | 'advanced' | 'flagship';
+/** 模型会员权益档位级别（Issue #87302）：flagship > advanced > standard > trial。 */
+export type ModelTierLevel = 'flagship' | 'advanced' | 'standard' | 'trial';
+/** 档位徽章（Issue #87302），本期只下发文案，颜色由客户端按 tier 写死。 */
+export interface ModelTierBadge {
+    readonly label: string;
+}
+/** 档位 hover 底部说明 + 升级 CTA（Issue #87302）。 */
+export interface ModelTierHover {
+    readonly textZh?: string;
+    readonly textEn?: string;
+    readonly action?: {
+        readonly type: 'upgrade';
+        readonly labelZh?: string;
+        readonly labelEn?: string;
+    };
+}
+/**
+ * 模型会员权益档位展示配置（Issue #87302）。
+ *
+ * 由 product config 顶层 `modelTiers` 下发，按 `modelIds` 命中模型后附加到模型元数据的
+ * `tier` 上（多档位命中同一模型时按 `priority` 选主）。与 {@link ModelPromotion}（按时间
+ * 窗口生效的运营活动）语义不同：tier 表示「按会员等级的长期权益档位」。
+ *
+ * ⚠️ 此类型与 `@genie/agent-provider.ModelTier`、以及
+ * `packages/workbuddy-server/src/config/contract.ts` 引用的 canonical 定义互为镜像，
+ * 字段必须保持一致（同款处理见 {@link ModelPromotion}）。任一处改动需同步其余各处。
+ */
+export interface ModelTier {
+    readonly id: string;
+    readonly tier: ModelTierLevel;
+    readonly enabled?: boolean;
+    readonly priority?: number;
+    readonly modelIds: readonly string[];
+    readonly badge?: ModelTierBadge;
+    readonly hover?: ModelTierHover;
+    readonly requiredUserType?: UserType;
+    readonly trackKey?: string;
+}
 /**
  * 语言模型的定义接口，描述模型的基本属性和能力。
  */
@@ -206,6 +270,8 @@ export interface LanguageModel {
     readonly reasoning?: ModelReasoning;
     /** 上下文窗口预算配置（Issue #57413）；maxInputTokens 仍表示物理上限。 */
     readonly contextWindow?: ModelContextWindow;
+    /** 视频生成能力（VideoGen 使用）：支持的分辨率档位与默认档位。 */
+    readonly videoGeneration?: ModelVideoGeneration;
     /**
      * effort 级别到上游字面量的映射表。来自模型目录，
      * 由请求层在拼装 reasoning_effort 时按需翻译。

package/cli/dist-server/types/workspace/product/lib/common/types/product.d.ts

@@ -15,7 +15,7 @@ import { GalileoConfig } from './galileo.js';
 import { Instruction } from './instruction.js';
 import { IntegrationOverridesConfiguration } from './integrations.js';
 import { KnowledgeBaseConfiguration } from './knowledge-base.js';
-import { LanguageModel, ModelGroup, ModelPromotion, ModelRelatedModels } from './language-model.js';
+import { LanguageModel, ModelGroup, ModelPromotion, ModelRelatedModels, ModelTier } from './language-model.js';
 import { LinkConfiguration } from './links.js';
 import { LogConfiguration } from './log.js';
 import { LSPExtensionConfig } from './lsp.js';
@@ -290,6 +290,12 @@ export interface ProductConfiguration {
      * `/v3/config` 顶层下发；前端按 `group.modelIds` 组装二级面板，不再按 id 前缀隐式筛选。
      */
     modelGroups?: ModelGroup[];
+    /**
+     * 模型会员权益档位展示配置（Issue #87302）。顶层下发，按 `modelIds` 命中模型后附加
+     * 徽章 / hover 档位标签。白名单式返回（daemon config RPC）必须显式透传该字段，
+     * 否则 renderer 侧读不到、档位徽章不展示（回归见 Issue #126934）。
+     */
+    modelTiers?: ModelTier[];
     /**
      * 默认关联模型配置
      * 当模型自身没有配置 relatedModels 时，使用此默认配置作为兜底

package/cli/dist-server/types/workspace/sandbox-cli/lib/common/backup-policy.d.ts

@@ -1,9 +1,18 @@
 export declare const FILE_BACKUP_DEFAULT_MAX_SIZE_MB = 3000;
 export declare const FILE_BACKUP_MIN_SIZE_MB = 1000;
+/**
+ * 备份总大小上限的最大允许值（MB）。
+ *
+ * Rust 侧（sandbox-center）使用 u32 反序列化 `fileBackupMaxSizeMB`，
+ * 超过 u32 上限（4294967295）会导致 serde 报错、整条 EnableModifyBackup
+ * 失败，进而使当轮文件备份静默关闭。1_000_000 MB ≈ 1 TB，远超实际需求
+ * 且安全落在 u32 范围内。
+ */
+export declare const FILE_BACKUP_MAX_SIZE_MB = 1000000;
 export interface FileBackupConfig {
     /** 是否启用文件备份 */
     enabled?: boolean;
-    /** 备份总大小上限（MB），不小于 1000 */
+    /** 备份总大小上限（MB），有效范围 [1000, 1000000] */
     maxSizeMB?: number;
 }
 export declare const DEFAULT_MODIFY_BACKUP_EXCLUDED_DIRS: readonly ["~/.cache/", "~/.local/", "~/.npm/", "~/.pnpm-store/", "~/.cargo/", "~/.rustup/", "~/go/", "~/.gradle/", "~/.m2/", "~/.nuget/", "~/.bun/", "~/.deno/", "~/.npm-global/", "~/.pyenv/", "~/appdata/local/temp/", "~/appdata/local/npm-cache/", "~/appdata/local/pnpm/", "~/appdata/local/yarn/", "~/appdata/local/fnm_multishells/", "~/.yarn/", "~/.nvm/", "~/.fnm/", "~/appdata/local/pip/", "~/appdata/local/conda/", "~/appdata/local/uv/", "~/appdata/roaming/uv/", "~/.pyenv/", "~/.conda/", "~/miniconda3/", "~/miniforge3/", "~/appdata/local/go-build/", "~/appdata/roaming/go/", "~/.sdkman/", "~/.dotnet/", "~/appdata/local/nuget/", "~/.docker/", "~/.asdf/", "~/appdata/roaming/npm/", "~/appdata/local/microsoft/windowsapps/", "~/appdata/roaming/code/", "~/appdata/roaming/trae/", "~/appdata/roaming/microsoft/windows/powershell/", "~/appdata/local/microsoft/windows/powershell/", "~/appdata/roaming/microsoft/windows/recent/", "~/appdata/local/microsoft/windows/recent/", "C:\\openclaw\\openclaw\\", "~/Library/Caches/", "~/Library/Developer/Xcode/DerivedData/", "~/Library/Developer/CoreSimulator/Caches/", "~/.pub-cache/", "~/.ivy2/cache/", "~/.sbt/boot/", "~/.gem/specs/", "~/.cabal/packages/", "~/.cabal/store/", "~/.stack/pantry/", "~/appdata/local/pub/cache/", "~/appdata/local/pypa/virtualenv/", "**/node_modules/**", "**/.pnpm-store/**", "**/.venv/**", "**/.tox/**", "**/.nox/**", "**/__pycache__/**", "**/.pytest_cache/**", "**/.mypy_cache/**", "**/.ruff_cache/**", "**/.next/**", "**/.nuxt/**", "**/.svelte-kit/**", "**/.parcel-cache/**", "**/.turbo/**", "**/.vite/**", "**/.vite-temp/**", "**/.sass-cache/**", "**/.dart_tool/**", "**/.gradle/**", "**/.cxx/**", "**/.externalNativeBuild/**", "~/.codebuddy/debug/", "~/.codebuddy/statsig/", "~/.workbuddy/plugins/", "~/.workbuddy/skills-marketplace/", "~/.workbuddy/connectors/", "~/.workbuddy/connectors-marketplace/", "~/.workbuddy/binaries/", "~/appdata/local/codex/", "~/appdata/local/hermes/", "~/appdata/roaming/python/", "~/appdata/roaming/pip/", "~/appdata/roaming/npm-cache/", "~/appdata/roaming/nuget/", "~/appdata/local/pnpm-store/", "~/appdata/local/ms-playwright/", "~/appdata/local/google/chrome/", "~/appdata/local/google/chrome for testing/", "~/appdata/local/microsoft/windows/caches/", "~/appdata/local/microsoft/powershell/", "~/appdata/local/packages/", "C:\\Windows\\System32\\lxss\\", "**\\$RECYCLE.BIN\\**", "**\\.git\\**", "**\\.githooks\\**"];