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

package/cli/dist-server/types/workspace/cbc-core/lib/node/trace/turn-context.d.ts

@@ -34,6 +34,33 @@ export interface TurnContext {
     /** Canonical id assigned when the external user input is admitted. */
     conversationRequestId?: string;
 }
+export interface RequestOwner {
+    readonly session: Session;
+    readonly requestId: string;
+    readonly turn: TurnContext;
+    latestExecution?: object;
+}
+export type RequestTerminalOutcome = 'written' | 'failed' | 'unconfirmed';
+export interface RequestTerminal {
+    readonly attempt: object;
+    outcome?: RequestTerminalOutcome;
+    readonly completed: Promise<RequestTerminalOutcome>;
+}
+export declare function getRequestOwner(ref: object): RequestOwner | undefined;
+export declare function getRequestExecution(ref: object): object | undefined;
+export declare function associateRequestOwner(ref: object, owner: RequestOwner, execution?: object): void;
+/** Carry physical execution through admission without inventing a request owner. */
+export declare function associateRequestExecution(ref: object, execution: object): void;
+/** Reserve completion ownership at admission, retaining the prior result if startup fails. */
+export declare function beginRequestExecution(owner: RequestOwner, execution: object): void;
+/** A failed startup never owns a result; restore only the execution it actually replaced. */
+export declare function abandonRequestExecution(execution: object): Session['resultSubject']['value'];
+export declare function getRequestTerminal(owner: RequestOwner, destination: string): RequestTerminal | undefined;
+export declare function claimRequestTerminal(owner: RequestOwner, destination: string, attempt: object): boolean;
+export declare function settleRequestTerminal(owner: RequestOwner, destination: string, attempt: object, outcome: RequestTerminalOutcome): void;
+/** The admission boundary, not trace binding, creates a new logical request. */
+export declare function admitRequestOwner(session: Session, requestId: string): RequestOwner;
+export declare function runInRequestOwner<T>(owner: RequestOwner, callback: () => T): T;
 /** Transient provider-data key; stripped before history/model persistence. */
 export declare const TURN_CARRIER_CANDIDATE_KEY = "codebuddy.ai/turnCarrierCandidate";
 export declare const BAGGAGE_KEY_SESSION_ID = "codebuddy.session_id";
@@ -83,7 +110,7 @@ export declare function bindCurrentTurnContext(session: Session, conversationReq
 /** Carrier for one exact admitted request; never returns the latest other turn. */
 export declare function turnCarrierForRequest(session: Session, conversationRequestId: string | undefined): W3CTraceContextMeta;
 /** Release an exact request binding. */
-export declare function releaseTurnContext(session: Session, conversationRequestId: string | undefined): void;
+export declare function releaseTurnContext(session: Session, conversationRequestId: string | undefined, owner?: RequestOwner): void;
 /** The current turn as an injectable three-key carrier; `{}` outside a turn. */
 export declare function currentTurnCarrier(): W3CTraceContextMeta;
 /**

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

@@ -58,6 +58,26 @@ export declare abstract class CommandMessageUtils {
      * 解析XML格式的命令输出
      */
     static parseOutput(xmlText: string): ParseCommandMessage | undefined;
+    /**
+     * 是否为本地命令在会话历史里留下的记账项：caveat、命令回显（`<command-name>`）、
+     * 命令输出（`<local-command-stdout>`）、本地 bash 的输入输出、plan 输出。
+     *
+     * 这些 item 的 role 是 user、也不带 skipRun，因此按「真实用户消息」判定会命中；
+     * 但它们只是本地命令的痕迹，**不代表用户开启了新一轮对话**。调用方（如 TUI 的
+     * loading 计时器）需要区分「新一轮」和「本地命令留痕」时用这个判据。
+     *
+     * 识别口径复用 parseInput / parseOutput / parsePlanOutput，避免调用方各自
+     * 维护一份 XML 标签清单而漂移。
+     */
+    static isLocalCommandRecord(text: string): boolean;
+    /**
+     * {@link isLocalCommandRecord} 的 item 版本。
+     *
+     * 必须读 **原始** content：`MessageContentUtils.extractTextContent` 已经把命令 XML
+     * 拆开（`<command-name>/doctor</command-name>` → `/doctor`），拿它的结果再判就永远
+     * 判不出来。
+     */
+    static isLocalCommandRecordItem(item: UserMessageItem): boolean;
     /**
      * 解析计划输出
      */

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 是否成功"!

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

@@ -1,6 +1,6 @@
 import { type AcpTerminalStateItem, type AgentInputItem, type AssistantMessageItem, type CustomTitleItem, type FileHistorySnapshotItem, type FunctionCallItem, type FunctionCallResultItem, type HookBlockingDetail, HookEvent, type ResendForkNoticeItem, type UserMessageItem } from '../../../../cbc-shared/lib/node/index.js';
 type ItemStatus = 'in_progress' | 'completed' | 'incomplete';
-export type HookStatus = 'success' | 'blocked' | 'warning' | 'error';
+export type HookStatus = 'success' | 'blocked' | 'warning' | 'error' | 'mod-log';
 interface ItemOptions {
     readonly skipRun?: boolean;
     readonly status?: ItemStatus;
@@ -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/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/model/model-errors.d.ts

@@ -20,11 +20,23 @@ export declare class StreamTimeoutError extends CustomError {
  * reasoning-only：已流出思考、finish_reason=error 且无可用输出（#63761 / #122115）。
  * no-token：finish_reason=error 到达时一个模型 token 都没有（连 reasoning 也没有）。
  *
- * reasoning-only 与 no-token 都是上游瞬时失败，会话层按 error 恢复预算重试；
+ * 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 declare const EMPTY_STREAM_ERROR_CATEGORY = "empty_model_response";
 /**
  * 空流错误
  * 语义上仍然是"上游没有提供模型输出"，所以继承 StreamTimeoutError
@@ -33,10 +45,26 @@ export type EmptyStreamKind = 'placeholder' | 'reasoning-only' | 'no-token';
  * 典型触发：某些 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-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/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/index.d.ts

@@ -24,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/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/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;
     /** 生图工具超时时间（毫秒） */

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

@@ -340,6 +340,7 @@ export declare enum ProductFeature {
     SkillSecurityScan = "SkillSecurityScan",
     SkillRecommend = "SkillRecommend",
     BeforeConversationRecommend = "BeforeConversationRecommend",
+    AfterConversationRecommend = "AfterConversationRecommend",
     /**
      * 是否开启文本选择操作功能
      */
@@ -514,20 +515,12 @@ export declare enum ProductFeature {
     /**
      * 是否禁用积分入口（用户菜单「积分」项 + 设置页账户「积分」区块）
      * 设置为 true 时，完全隐藏积分入口（不展示菜单项与账户面板积分区块）。
-     * 用于无积分体系的发行版（如海外版 workbuddy-ai）。
+     * 用于无积分体系的发行版（如私有化、云托管和 Custom 产品）。
      * 注意与 ShowCreditsBalance 区分：ShowCreditsBalance 控制「是否展示积分数值」，
      * 本 flag 控制「积分入口是否存在」。
      * @default false（默认有积分入口）
      */
     DisableCreditsEntry = "DisableCreditsEntry",
-    /**
-     * 是否禁用设置页「订阅和用量」入口
-     * 设置为 true 时隐藏该导航项，并禁止通过 Settings hash 直达该页面。
-     * 积分入口仍可保留；点击后回落到设置页「个人主页」。
-     * 用于海外版等保留积分体系、但不开放订阅管理页的发行版。
-     * @default false（默认显示）
-     */
-    DisableSubscriptionUsageEntry = "DisableSubscriptionUsageEntry",
     /**
      * 是否禁用侧栏「邀请好友」入口
      * 设置为 true 时隐藏入口及邀请积分弹窗。
@@ -1428,6 +1421,21 @@ export declare enum ProductFeature {
      * @default false
      */
     EnableClawChannelControl = "EnableClawChannelControl",
+    /**
+     * 是否隐藏设置面板「助理设置 → 远程渠道」整个区块（含微信助理 / 企微机器人 /
+     * QQ 机器人等通道卡片与定时任务企微 bot 推送卡片）。
+     *
+     * 仅隐藏 UI 入口，不影响「上下文管理」（Session Management）等其他区块。
+     * 专享版（Cloud-Hosted）与私有化（Self-Hosted）定制渠道不支持远程助理渠道，
+     * 在 workbuddy-custom base 的 productFeatures 配置 true（私有化构建自动继承）；
+     * 运行期也可经 /v3/config 下发覆盖（如放开某个已部署网关的租户）。
+     *
+     * - 旗舰版（标准渠道）：不配置该 key → 不禁用，远程渠道照常展示（fail-open）
+     * - 专享版 / 私有化：配置 true → 隐藏区块；缺省（未配置）同旗舰版展示
+     *
+     * @default false
+     */
+    DisableClawRemoteChannels = "DisableClawRemoteChannels",
     /**
      * 是否启用 AI 代码入库率统计能力
      *

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

@@ -400,6 +400,21 @@ export interface ProductConfiguration {
     marketplaceVersionCheckIntervalMs?: number;
     /** 内置插件配置，用于初始化时自动安装 */
     builtInMarketPlugins?: BuiltInPluginConfig[];
+    /**
+     * 专享版/私有化插件变体映射（占位符渲染方案）。
+     *
+     * key 为 marketplace 内 plugin name，value 为同 marketplace 下变体目录名（与原插件
+     * source 目录同级）。**构建期**消费：`apps/workbuddy-desktop` 的
+     * `syncBundledRuntimeAssets()`（`scripts/exclusive-plugin-build-render.mjs`）在
+     * 拷贝 resources → dist 之后渲染变体内的 `${TENCENT_DOCS_DOMAIN}` 占位符为
+     * `privateHost.docHost ?? endpoint -docs 派生`（域名不可得时构建失败，不回填
+     * 默认域），再用变体内容覆盖原插件目录。运行时物化链零感知。
+     *
+     * 仅专享版/私有化打包配置写入（`build/patches/workbuddy-custom/product.json`，
+     * 私有化构建自动继承 base）；旗舰版/C 端不写 → 字段 undefined → 构建期
+     * 零触发（fail-safe）。
+     */
+    exclusivePluginVariants?: Record<string, string>;
     /**
      * 内置插件合并配置（通过 Unleash 远程下发）
      * 与 product.json 和 /v3/config 的 builtInMarketPlugins 结果合并

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

@@ -1,9 +1,11 @@
 import { Application, ApplicationLifecycle } from '@celljs/core';
-import { ProductManager } from '../../../product/lib/common/index.js';
+import { ProductConfigurationContext, ProductManager } from '../../../product/lib/common/index.js';
 import { BehaviorSubject } from 'rxjs';
 import { PromptProvider, PromptTemplate } from './prompt-protocol.js';
 export declare class ProductPromptProvider implements PromptProvider, ApplicationLifecycle<Application> {
     protected readonly productManager: ProductManager;
+    protected readonly executionConfiguration?: ProductConfigurationContext;
     productTemplateSubject: BehaviorSubject<PromptTemplate[]>;
+    getScopedTemplates(): PromptTemplate[] | undefined;
     initialize(): void;
 }

package/cli/dist-server/types/workspace/prompts/lib/common/prompt-protocol.d.ts

@@ -39,6 +39,12 @@ export interface PromptManager {
 }
 export interface PromptProvider {
     productTemplateSubject: BehaviorSubject<PromptTemplate[]>;
+    /**
+     * Replace this provider's process templates for the current execution.
+     * undefined uses the process snapshot; [] explicitly supplies no templates.
+     * The result must never be published to the shared template map.
+     */
+    getScopedTemplates?(): PromptTemplate[] | undefined;
 }
 export interface PromptEvaluator {
     priority(context: PromptRenderContext): Promise<number>;

package/cli/dist-server/types/workspace/sandbox-cli/lib/common/center-protocol.generated.d.ts

@@ -846,6 +846,7 @@ export interface FileRuleItem {
     comment?: string;
     isDirectory: boolean;
     category?: RuleCategory;
+    ruleRef?: string;
 }
 /**
  * 网络端点规则(三态)。action 为 allow/deny/ask。endpoint 为 host/host:port/ip/CIDR/*。
@@ -856,6 +857,7 @@ export interface NetworkRuleItem {
     action: RuleAction;
     comment?: string;
     category?: RuleCategory;
+    ruleRef?: string;
 }
 /**
  * HTTP 明文拦截规则(三态)。命中 target 的明文 HTTP 请求按 action 处理。
@@ -900,6 +902,7 @@ export interface CmdRuleItem {
     comment?: string;
     reason?: string;
     category?: RuleCategory;
+    ruleRef?: string;
 }
 /**
  * AddFileRule 请求 data — 追加文件规则(按 category 分层存储)。category 缺省 = session(2026-08-24 R-HST-2 改定,原为 temp)。
@@ -1158,6 +1161,8 @@ export interface MatchedRuleInfo {
      * 失败），category 仅作审计/展示（规则列表 join key 的一部分）。
      */
     category?: RuleCategory;
+    /** 宿主提供的不透明规则身份；沙箱仅随实际胜出规则透传，不用于裁决。 */
+    ruleRef?: string;
 }
 /**
  * bidirectional：cli 侧消费 center 响应时需反序列化（ProcessExit 统一决策记录

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

@@ -1,5 +1,5 @@
 import { type FileRuleActions } from './file-rule-action.js';
-import type { SecurityCenterFileRule, SecurityCenterOrderedRuleSet } from './rule-config.js';
+import { type SecurityCenterFileRule, type SecurityCenterOrderedRuleBase, type SecurityCenterOrderedRuleSet } from './rule-config.js';
 export { getLegacyFilePreset } from './legacy-file-preset.js';
 export declare const FILE_POLICY_PRESET_VERSION = 4;
 export declare function getDefaultFileRuleSet(platform: NodeJS.Platform): SecurityCenterOrderedRuleSet<SecurityCenterFileRule>;
@@ -14,11 +14,14 @@ export interface FilePolicyRule {
     isDirectory: boolean;
     action: string;
     comment?: string;
+    ruleRef?: string;
 }
 /** Existing Security Center storage/UI format. Conversion preserves order and actions. */
 export interface FileRuleSettings extends FileRuleActions {
     path: string;
     isDirectory?: boolean;
+    id?: string;
+    source?: SecurityCenterOrderedRuleBase['source'];
 }
 export declare const FILE_ACTION_ASK = "read=ask|write=ask|delete=ask";
 export declare const FILE_ACTION_PROTECT_MUTATION = "read=allow|write=ask|delete=ask";

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

@@ -31,6 +31,26 @@ export interface HttpInterceptPolicyConfig {
 }
 /** 默认 HTTP 明文请求拦截策略：远程默认询问、本地默认放行。 */
 export declare const DEFAULT_HTTP_INTERCEPT_CONFIG: HttpInterceptPolicyConfig;
+/**
+ * 本地段枚举，对齐 `network-policy.ts` 的 `isLoopbackHost` 判定口径（仅 loopback），
+ * 由 http-intercept-policy.spec.ts 的对齐用例锁定。
+ *
+ * Center 侧 `handle_plain_http` 按 rules 顺序匹配 target（支持域名/IP/CIDR/`*`），
+ * 故把这些本地段以 `action=<local 态>` 前置于 `*` 兜底之前，使 loopback 走
+ * local 策略、其余走 remote 策略。Center 不内置 local/remote 语义，完全由
+ * 这张表表达。target 不自动覆盖子域，故 `localhost` 之外还须带 `*.localhost`
+ * （isLoopbackHost 把 `foo.localhost` 判为 loopback）。
+ *
+ * 「本地」口径 = 仅 loopback（产品决策：局域网/链路本地不算本地）：
+ * - hostname `localhost` 及其子域（`*.localhost`）
+ * - IPv4 loopback `127.0.0.0/8`
+ * - IPv6 loopback `::1`
+ *
+ * **不包含**局域网私有段（10/172.16/192.168）、链路本地（169.254，含云元数据
+ * 169.254.169.254）、ULA（fc00::/7）等——这些按远程策略处理（默认 ask→弹窗，
+ * 堵 SSRF）。
+ */
+export declare const LOCAL_HTTP_INTERCEPT_TARGETS: readonly string[];
 /** buildHttpInterceptRules 的输入：SandboxConfig 的网络子集。 */
 export interface HttpInterceptRulesInput {
     /** 用户三态配置（缺省 remote='ask' / local='allow'）。 */

package/cli/dist-server/types/workspace/sandbox-cli/lib/common/rule-config.d.ts

@@ -1,5 +1,15 @@
 export type SecurityCenterRuleSource = 'enterprise' | 'preset' | 'user';
 export type SecurityCenterRuleAction = 'allow' | 'ask' | 'deny';
+/**
+ * 有界传输身份；原始配置ID与权限匹配语义保持不变。
+ *
+ * 不直接透传原始 id：Windows 命中身份经审计共享内存传回宿主，槽位固定为
+ * `rec_rule_ref[96]`（含 NUL），而企业规则 id 来自远端配置、没有长度上限，
+ * 截断会定位到错误规则。固定 68 字符的 hash 保证三平台都能精确定位。
+ * source 与 domain 参与计算，避免不同来源或类别的同名 id 被当成同一条规则。
+ * 仅用于展示定位，不得作为授权条件、删除键或裁决缓存键。
+ */
+export declare function createSandboxRuleRef(domain: 'file' | 'command' | 'network', source: SecurityCenterRuleSource, originalId: string): string;
 export interface SecurityCenterOrderedRuleBase {
     id: string;
     source: SecurityCenterRuleSource;

package/cli/dist-server/types/workspace/sandbox-cli/lib/node/sandbox-center-client.d.ts

@@ -17,12 +17,14 @@ export interface SandboxCenterRequestOptions {
 export type SandboxRulesCommand = (typeof SANDBOX_RULES_COMMANDS)[keyof typeof SANDBOX_RULES_COMMANDS];
 export type SandboxCenterCommand = SandboxCommand;
 export interface SandboxCenterFileRule {
+    ruleRef?: string;
     path: string;
     action: string;
     comment?: string;
     isDirectory: boolean;
 }
 export interface SandboxCenterNetworkRule {
+    ruleRef?: string;
     endpoint: string;
     action: string;
     comment?: string;
@@ -33,6 +35,7 @@ export interface SandboxCenterMachRule {
     comment?: string;
 }
 export interface SandboxCenterCmdRule {
+    ruleRef?: string;
     cmd: string;
     args: string[];
     action: string;

package/cli/dist-server/types/workspace/telemetry/lib/common/event/types/craft.d.ts

@@ -22,10 +22,29 @@ export interface CraftRequest {
     actionCode: string;
 }
 /**
- * 聊天请求发送遥测数据接口
+ * Role of a model call, mirroring Claude Code's `x-claude-code-request-class`: main /
+ * subagent / team agent loops, `compaction` summary calls, and `auxiliary` for other
+ * one-shot helpers (title, WebFetch analysis, ...) on any Session.
+ */
+export type AgentType = 'main' | 'subagent' | 'team' | 'auxiliary' | 'compaction';
+/**
+ * Compaction class, with the values of Claude Code's `x-claude-code-compaction` /
+ * `x-claude-code-context-compacted` headers.
+ */
+export type CompactionKind = 'manual' | 'auto' | 'reactive';
+/**
+ * Why the harness compacted (`blocking_limit` / `ptl` are Claude Code's terms):
+ *
+ * | trigger | kind | condition |
+ * |---|---|---|
+ * | `manual` | manual | `/compact` from any entry (TUI, IM, /server, typed command) |
+ * | `pre_message_threshold` | auto | before a user message, tokens ≥ `tokenUsageThresholds.inputTokens.preMessage` |
+ * | `cache_expired` | auto | before a user message, the used prompt cache is ≥ 1h old and tokens ≥ 50% of the budget |
+ * | `emergency_threshold` | auto | before a model call, tokens ≥ `tokenUsageThresholds.inputTokens.emergency`; the call is sent, then interrupted |
+ * | `blocking_limit` | auto | before a model call, tokens + max output would exceed the context budget; the call waits |
+ * | `ptl` | reactive | the model rejected the prompt as too long |
  */
-/** Agent 角色类型：main = 主 agent，subagent = fork 子 agent，team = 团队成员 agent */
-export type AgentType = 'main' | 'subagent' | 'team';
+export type CompactionTrigger = 'manual' | 'pre_message_threshold' | 'cache_expired' | 'emergency_threshold' | 'blocking_limit' | 'ptl';
 export interface UserTaskFailedCreditRefundTelemetry {
     /** 用户 ID，对齐公共 userId 字段；业务侧显式传入，避免特定宿主未注入 UserinfoProvider 时缺失。 */
     userId: string;
@@ -74,6 +93,9 @@ export interface ToolCallLoopTelemetry {
     /** 重复序列的周期长度；连续同工具为 1。 */
     total: number;
 }
+/**
+ * 聊天请求发送遥测数据接口
+ */
 export interface ChatRequestSendTelemetry {
     /** 聊天模式，枚举值：ask / chat */
     mode: string;
@@ -307,6 +329,20 @@ export interface ChatMessageSendTelemetry {
     isContextTruncated: boolean;
     /** 当前 stepCount 数值 */
     currentStepCount: number;
+    /**
+     * Agent-loop model call number within this conversation. Unlike
+     * `currentStepCount` it never resets (runs, compaction, resume); retries of
+     * one call share the number.
+     */
+    totalStepCount?: number;
+    /** Completed context compactions of this conversation when the call is sent; never resets. */
+    compactionCount?: number;
+    /** Compaction the call's context starts from (`cmp_*`, the JSONL boundary item id). */
+    compactionId?: string;
+    /** First call after a compaction: the compaction's class. */
+    contextCompacted?: CompactionKind;
+    /** Set with `contextCompacted`: why the harness compacted. */
+    compactionTrigger?: CompactionTrigger;
     /** 是否是自定义模型 */
     isCustomModel?: boolean;
     /**
@@ -352,6 +388,8 @@ export interface ChatMessageResponseTelemetry {
     requestId: string;
     /** 模型调用 ID */
     messageId: string;
+    /** Same value as the paired `chat_message_send.totalStepCount`. */
+    totalStepCount?: number;
     /** 模型 ID */
     requestModelId: string;
     /** 模型名称 */
@@ -425,6 +463,8 @@ export interface ChatToolActionTelemetry {
     messageId: string;
     /** 当前 stepCount 数值 */
     stepCount: number;
+    /** Agent-loop step (`chat_message_send.totalStepCount`) whose response requested this tool call. */
+    totalStepCount?: number;
     /** 工具 ID */
     toolCallId: string;
     /** 工具名称 */

package/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencent-ai/codebuddy-code",
-  "version": "2.157.0",
+  "version": "2.159.0",
   "private": true,
   "description": "CodeBuddy runtime embedded in @tencent-ai/agent-harness",
   "license": "SEE LICENSE IN LICENSE.txt",