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

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

@@ -226,10 +226,10 @@ export declare abstract class HistoryUtils {
      * <conversation_history_summary>…</conversation_history_summary> 包裹的正文)。
      *
      * 规则(与 replaceCompactWithSummary / getCompactHistory 对齐):
-     *   1. 仅查看 `providerData.agent === AgentNames.COMPACT` 且为 assistant 的 message
-     *   2. 从后向前扫描,命中第一条满足格式的 compact assistant 即返回
-     *   3. "满足格式"由 `SummaryUtils.extractCompactSummaryFromText` 统一判定
-     *      (内含结构校验 + 非空正文双闸)
+     *   1. 查看 compact-agent assistant，或 PreMessage/MaxToken 写入的显式 compact boundary
+     *   2. 从后向前扫描,命中第一条可用摘要即返回
+     *   3. compact assistant 继续要求结构化 summary envelope；显式 boundary 同时支持
+     *      工程压缩的 `<cb_summary>` 与 LLM summary envelope
      *   4. 全程扫描都拿不到 → 返回 `undefined`(history 中**从未**出现过合法摘要)
      *
      * ⚠️ 不适合用于"判断本次 compact run 是否成功"!
@@ -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/input-item-utils.d.ts

@@ -256,6 +256,14 @@ export declare abstract class InputItemUtils {
     static isUserInterrupted(item: AgentInputItem): boolean;
     static isSuccessfulFunctionCallResultItem(item: AgentInputItem): item is FunctionCallResultItem;
     static isCompactBoundaryMessage(item: AgentInputItem): boolean;
+    /**
+     * 仅凭 providerData 结构化标记判定 compact boundary，不使用内容正则兜底。
+     *
+     * 会删除或改写消息的路径（如 replaceCompactWithSummary）必须用这个版本：
+     * 内容兜底会把用户粘贴的 `<cb_summary>` / `<conversation_history_summary>` 文本
+     * 误判为 boundary，导致真实用户输入被移除。
+     */
+    static isStructuredCompactBoundaryMessage(item: AgentInputItem): boolean;
     static isReplayRecoverableCompactMessage(item: AgentInputItem): item is UserMessageItem;
     static isCompactUserMessage(item: AgentInputItem): item is UserMessageItem;
     private static hasCompactBoundaryContent;

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-core/lib/node/utils/token-utils.d.ts

@@ -64,7 +64,9 @@ export declare class TokenUtils {
      * tool call 执行后产生的 function_call_result（这些结果在 API 返回后才追加到 history）。
      * 为了更准确地判断是否需要触发压缩，需要把这部分 token 补上。
      *
-     * 从 history 末尾往前扫描，收集连续的 function_call_result 条目直到遇到其他类型为止。
+     * 从 history 末尾往前扫描，只收集紧挨在末尾的连续 function_call_result。
+     * 一遇到非 function_call_result（含 function_call）即停止：function_call 属于上一轮
+     * 已经进过请求的内容，穿过它会把更早轮次的 result 重复计入 inputTokens（#133055）。
      * 注意：估算前会移除图片内容，避免 base64 图片数据导致 token 严重偏高。
      */
     static estimateTrailingToolResultTokens(history: any[]): number;

package/cli/dist-server/types/workspace/cbc-shared/lib/node/agent/openai-agents-types.d.ts

@@ -31,6 +31,7 @@ import type { AgentOutputType, getAllMcpTools as getAllMcpToolsFn, MaxTurnsExcee
 import type { TextOutput, UnknownContext, UserContent } from '@openai/agents-core/types';
 import type { AcpTerminalStateItem, FileHistorySnapshotItem, ModelUsageItem, ResendForkNoticeItem } from './custom-input-item-types.js';
 export * from './custom-input-item-types.js';
+export type { RunStreamEvent } from '@openai/agents-core';
 export type Agent<TContext = UnknownContext, TOutput extends AgentOutputType = TextOutput> = AgentTypeCtor<TContext, TOutput>;
 export type RunContext<TContext = UnknownContext> = RunContextTypeCtor<TContext>;
 export type Runner = RunnerTypeCtor;

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

@@ -64,4 +64,10 @@ export interface CheckpointFileChangeStats {
     additions: number;
     /** 删除行数 */
     deletions: number;
+    /**
+     * 行数为近似值（PTC/Code Mode 兜底：files 来自本轮 trackFile 快照，additions/deletions
+     * 暂记 0）。需要精确行数的调用方（如 TUI rewind 面板）据此异步调用
+     * compareWithCurrentFiles 补齐后清除本标记。仅内存态，不持久化。
+     */
+    approximate?: boolean;
 }

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,26 @@ 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 恢复预算重试——
+ * 但仅限流没跑太久的那些：已经烧满上游硬时限的同样形态重跑必然再次跑满，由
+ * `isRetryableEmptyStreamError` 按 {@link EmptyStreamError.elapsedMs} 收口（#132616）。
+ * placeholder 必须与 no-token 分开——两者共用一个值时，放开 no-token 会连带
+ * 推翻空 200 的终态判定。
+ */
+export type EmptyStreamKind = 'placeholder' | 'reasoning-only' | 'no-token';
+/**
+ * 空流错误的结构化 category，两条上报通道共用一个值。
+ *
+ * ACP 侧 `classifyErrorAsRequestError` 早就用它（前端按此映射业务码 3008「模型服务未返回消息」）；
+ * stream-json 侧此前没有任何结构化维度，`errors_info` 整体缺席，sandbox-proxy 的
+ * `BuildErrorMessageFromCLIErrors` 只能兜底成 `category=internal`，再由
+ * `ClassifyInBandPromptError` 推出 `error_origin=cli`——把上游故障记成 CLI 内部错误。
+ * 挂到错误对象的 `data` 上让两条通道读到同一个值，不再各说各话。
  */
-export type EmptyStreamKind = 'placeholder' | 'reasoning-only';
+export declare const EMPTY_STREAM_ERROR_CATEGORY = "empty_model_response";
 /**
  * 空流错误
  * 语义上仍然是"上游没有提供模型输出"，所以继承 StreamTimeoutError
@@ -29,10 +45,26 @@ export type EmptyStreamKind = 'placeholder' | 'reasoning-only';
  * 典型触发：某些 OpenAI 兼容网关在后端异常时没有透传错误码，而是发一帧全空
  * `{"delta":{"role":"assistant","content":"","tool_calls":[],"refusal":""},"finish_reason":""}`
  * 然后直接关闭连接——用户看到的现象是 cbc 当前轮"空响应"并被 ACP 分类为 refusal。
+ *
+ * message **必须**按 kind 分开写：三种 kind 共用一句「only placeholder chunks」会谎报失败形态。
+ * 0924 沙箱实测的 reasoning-only 样本里上游发了 20397 帧 / 9.5 MB 真实 reasoning，
+ * 与「只有占位帧」正相反；而下游报表、看板、排障全靠这个字符串归因，于是把上游
+ * ~900s 时限问题记成了 CLI 内部错误（#132616）。
  */
 export declare class EmptyStreamError extends StreamTimeoutError {
     readonly emptyStreamKind: EmptyStreamKind;
-    constructor(chunkCount: number, totalBytes: number, kind?: EmptyStreamKind);
+    /**
+     * 流从打开到判定空流的时长。
+     *
+     * 用来区分「上游瞬时抖动（秒级空响应）」和「跑满上游硬时限（0924 实测 ~900s）」——
+     * 后者重跑同一段 prompt 必然再次跑满，重试只是把静默时长翻倍，见
+     * `isRetryableEmptyStreamError` 的时长闸门。
+     */
+    readonly elapsedMs: number;
+    readonly data: Readonly<{
+        category: "empty_model_response";
+    }>;
+    constructor(chunkCount: number, totalBytes: number, kind?: EmptyStreamKind, elapsedMs?: number);
 }
 /**
  * 认证缺失错误

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-service.d.ts

@@ -76,6 +76,11 @@ export declare class WorktreeServiceImpl implements IWorktreeService {
      * 删除分支（如果存在）
      */
     private deleteBranchIfExists;
+    /**
+     * 回滚失败的 git worktree add：此时 worktree 可能未完整检出，
+     * 不能依赖从 worktreePath 反查仓库，统一以主仓库为准清理目录、记录和分支。
+     */
+    private rollbackFailedAdd;
     /**
      * 带重试的分支删除
      * git worktree remove 后文件系统可能尚未释放锁，

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/core/lib/common/protocol.d.ts

@@ -42,8 +42,15 @@ export declare const REQUEST_ID_HEADER = "X-Request-ID";
 export declare const ROOT_REQUEST_ID_HEADER = "X-Root-Request-ID";
 /** 父会话 ID，子 Agent / team member 模型请求携带，主 Agent 不带 */
 export declare const PARENT_CONVERSATION_ID_HEADER = "X-Parent-Conversation-ID";
-/** Agent 角色：main / subagent / team，主 Agent 也显式携带 */
+/**
+ * Role of the model call: main / subagent / team, `auxiliary` for one-shot helpers and
+ * `compaction` for compaction summaries (Claude Code `x-claude-code-request-class`).
+ */
 export declare const AGENT_TYPE_HEADER = "X-Agent-Type";
+/** Compaction calls: class of the compaction, manual / auto / reactive (Claude Code `x-claude-code-compaction`). */
+export declare const COMPACTION_HEADER = "X-Compaction";
+/** First agent-loop call after a compaction: its class (Claude Code `x-claude-code-context-compacted`). */
+export declare const CONTEXT_COMPACTED_HEADER = "X-Context-Compacted";
 export declare const CONVERSATION_ID_HEADER = "X-Conversation-ID";
 export declare const SESSION_ID_HEADER = "X-Session-ID";
 export declare const CONVERSATION_REQUEST_ID_HEADER = "X-Conversation-Request-ID";

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';
@@ -23,4 +24,5 @@ export * from './abtest-feature-aliases.js';
 export * from './abtest-service.js';
 export * from './tool-control-catalog.js';
 export * from './static-resource-url.js';
+export * from './tencent-docs-endpoint.js';
 export { AUTO_MODEL_ID, AUTO_MODEL_IDS, AUTO_TIER_MODEL_IDS, AUTO_TIER_MODELS, expandAutoModelIds, isAutoModelId, replaceAutoModelInList, replaceAutoWithTierModels, shouldReplaceAutoWithTierModels, } from './auto-tier-models.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/tencent-docs-endpoint.d.ts

@@ -0,0 +1,37 @@
+import type { ProductConfiguration } from './types/product.js';
+/**
+ * 腾讯文档企业版（VPC / 专享版 / 私有化）MCP 域名派生（占位符渲染方案）。
+ *
+ * 纯函数集，从 `workbuddy-server/src/connector/enterprise-variant/default-variants.ts`
+ * 抽出为双 fork 共享实现：agent-cli 与 workbuddy-server 的插件物化渲染、
+ * `resolveTencentDocsSkillApiBase` 三处统一消费，禁止各放一份。
+ */
+/** endpoint 首段追加该后缀派生腾讯文档 MCP 子域（与 connector variant 链路一致）。 */
+export declare const TENCENT_DOCS_HOST_SUFFIX = "-docs";
+/** 派生 MCP URL 的 path 部分（渲染只取 origin，path 仅为保持与 connector 派生同构）。 */
+export declare const TENCENT_DOCS_MCP_PATH = "/api/v6/open/agent/mcp";
+/**
+ * 归一化私有化 MCP host 为 origin（保留下发协议，裸 host 按 https 补全，非法值返回 undefined）。
+ *
+ * 与 `auth-service.ts::buildLexiangPrivateOrigin` 同语义：私有化下发可能是 `http://`（内网环境），
+ * 必须保留下发协议，不强制升 https。带路径时只取 origin。
+ * 安全前提：privateMcpHost 来自受信 daemon 产品配置（/v3/config），不来自用户输入。
+ */
+export declare function buildPrivateMcpOrigin(privateMcpHost?: string): string | undefined;
+export declare function deriveSubdomainBasedMcpUrl(endpoint: string | undefined, hostSuffix: string, mcpPath: string): string | undefined;
+/**
+ * 派生腾讯文档企业版 VPC MCP URL：`privateMcpHost`（即 `privateHost.docHost`）下发即为准，
+ * 缺省回退 endpoint 首段 `-docs` 派生。
+ */
+export declare function deriveTencentDocsVpcMcpUrlFromEndpoint(endpoint?: string, privateMcpHost?: string): string | undefined;
+/**
+ * 解析插件占位符渲染用的腾讯文档 API base origin，取值优先级（与 connector variant 链路对齐）：
+ *
+ * `privateHost.docHost ?? endpoint -docs 派生（取 origin） ?? undefined`
+ *
+ * - 专享版（Cloud-Hosted）：不下发 docHost，值为 endpoint 派生；
+ * - 私有化：`/v3/config` 下发 docHost，下发即为准；
+ * - 公有云 / 旗舰版：endpoint 空 / 不可派生 → undefined，渲染回填默认域
+ *   （但旗舰版根本不配置 `exclusivePluginVariants`，渲染整体不执行）。
+ */
+export declare function resolveTencentDocsApiBase(config: ProductConfiguration | 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/config.d.ts

@@ -63,6 +63,18 @@ export interface RemoteConfiguration {
     customAgentMaxCount?: number;
     mcpSchemaUrl?: string;
     mcpOauthTimeout?: number;
+    /**
+     * 海外桌面版内置 Outlook MCP 的 Microsoft Entra public-client 配置。
+     *
+     * clientId 不是秘密；桌面包严禁携带 client secret。OAuth 使用 PKCE +
+     * localhost 随机端口回调，权限 scope 由客户端代码固定，远端配置不能扩权。
+     */
+    outlookMcp?: {
+        enabled?: boolean;
+        clientId?: string;
+        /** common / organizations / consumers / fixed tenant UUID */
+        tenantId?: string;
+    };
     enterpriseLimitHintCN?: string;
     enterpriseLimitHint?: string;
     /** 生图工具超时时间（毫秒） */