@tencent-ai/agent-harness 0.2.0-beta.6 → 0.2.0-beta.7

package/cli/dist-server/types/node/server/types.d.ts

@@ -142,7 +142,14 @@ export type QueryInput = string | unknown[] | {
     readonly type: 'compact';
 };
 export interface QueryOptions {
-    /** W3C trace context and baggage captured for this individual query. */
+    /**
+     * Opaque request metadata, captured for this query. The reserved W3C keys
+     * propagate through this request and its children using the turn context.
+     * Unknown extensions do not become session settings or arbitrary HTTP headers.
+     * `baggage: 'x-agent-intent=ask'` supplies attribution, not permissions.
+     * Host baggage and intent mapping are sent only to built-in model endpoints.
+     * The legacy `codebuddy.ai.mode` extension fills the scene only when baggage does not supply it.
+     */
     _meta?: Record<string, unknown> | null;
     /**
      * Working directory for the session. Defaults to process.cwd().

package/cli/dist-server/types/vendor/cbc-core/node/agent/agent-protocol.d.ts

@@ -760,6 +760,11 @@ export interface AgentRunRequest<TContext = Session> extends SessionOptions {
     skipAddHistory?: boolean;
     bypassMessageQueue?: boolean;
     inputOrigin?: AgentRunOrigin;
+    /**
+     * Whether the batch admitted by MessageQueue contains an external user prompt.
+     * Captured before History replaces input with the active conversation history.
+     */
+    hasExternalUserPromptAtAdmission?: boolean;
     /** Process-local arrival callback; never passed to the SDK. */
     onResult?: AgentStandardRunOptions['onResult'];
     traceId?: string;

package/cli/dist-server/types/vendor/cbc-core/node/session/background-task-protocol.d.ts

@@ -1,8 +1,22 @@
 import type { AcpTerminalEndReason } from '../../../cbc-shared/node/index.js';
+export interface BackgroundTaskOutputRead {
+    /** Absolute character offset requested for this read, clamped to the current output range. */
+    fromOffset: number;
+    /** Absolute character offset immediately after the returned snapshot. */
+    nextOffset: number;
+    /** Preserved output for the requested range, including an omission marker when needed. */
+    content: string;
+    /** Unread characters no longer retained by the bounded buffer. */
+    omittedLength: number;
+}
 /** Output buffer capabilities used by task producers and consumers. */
 export interface BackgroundTaskOutputBuffer {
     push(data: string): void;
     toString(withMarker?: boolean): string;
+    /** Absolute character offset at the current end of the output stream. */
+    getEndOffset(): number;
+    /** Read output retained after an absolute character offset. */
+    readSince(offset: number): BackgroundTaskOutputRead;
     isEmpty(): boolean;
     getHead(): string;
     getTail(): string;

package/cli/dist-server/types/vendor/cbc-core/node/session/session-protocol.d.ts

@@ -1062,13 +1062,13 @@ export interface SessionFactory {
 /**
  * 传给 SessionManager/SessionStore.get() 的选项。
  *
- * 默认情况下，session 反序列化会施加一个逆序截断（仅读最近 ~1000 条历史），
+ * 默认情况下，session 反序列化会从尾部截断（仅读最近 ~1000 条历史），
  * 目的是保证正常运行时（会话续聊、模型上下文装配）的性能与内存占用。
  * 展示型场景（如历史回放给前端完整聊天视图）可以通过 `historyLimit` 放大上限。
  */
 export interface SessionGetOptions {
     /**
-     * 从 jsonl 逆序读取的历史 item 数上限。
+     * 从 jsonl 尾部加载的历史 item 数上限。
      *
      * - 未传：沿用默认 1000（服务于续聊、checkpoint、模型上下文等场景）。
      * - 显式传值：按该值截断（如展示型 replay 传 10000）。

package/cli/dist-server/types/vendor/cbc-core/node/session/session-store.d.ts

@@ -5,6 +5,12 @@ import { LocalJsonlSessionStore } from './local-jsonl-session-store';
 import { type Session, SessionFactory, type SessionForkMutationOptions, type SessionGetOptions, type SessionRewindMutationOptions, SessionStore, type TranscriptPersistenceMetrics } from './session-protocol';
 import type { Lane, LanePointer, SessionKey, SessionStoreEntry } from './session-store-contract';
 import { SessionImageStorage as ImageBlobService, SessionRestoreHost, SessionStoragePaths, SessionToolOutputStorage as ToolResultBlobService } from './session-store-host-protocol';
+/**
+ * Read transcript tails in moderately sized blocks. Small files naturally use
+ * one read, while large files stop as soon as the requested history window is
+ * complete instead of retaining the entire transcript in memory.
+ */
+export declare const SESSION_REVERSE_READ_CHUNK_BYTES: number;
 /**
  * session/load 回放时 history 的默认最大条数。
  * 达到此阈值且遇到 user message 时停止逆序读取，避免启动时全量读 JSONL。
@@ -291,6 +297,13 @@ export declare class SessionStoreImpl implements SessionStore {
      */
     protected deserializeSessionFromPath(filePath: string, options?: SessionGetOptions): Promise<Session | undefined>;
     protected getSessionId(filePath: string): string;
+    /**
+     * Read complete UTF-8 JSONL records from newest to oldest with bounded I/O.
+     * Newline bytes are safe boundaries in UTF-8; a record is decoded only
+     * after all of its cross-chunk Buffer fragments have been assembled.
+     */
+    protected readLinesFromEnd(filePath: string, fileSize: number, consumeLine: (line: string) => boolean): Promise<number>;
+    private decodeReverseLine;
     private getPreferredProjectDirs;
     get(id: string, options?: SessionGetOptions): Promise<Session | undefined>;
     getAcrossProjects(id: string, options?: SessionGetOptions): Promise<Session | undefined>;

package/cli/dist-server/types/vendor/cbc-core/node/session/truncation-recovery.d.ts

@@ -98,3 +98,11 @@ export declare function readTruncatedResponseUsage(lastTurnResponse: unknown): {
  * 截断不该因为落在不同入口而收到不同指导。
  */
 export declare function buildRecoveryPrompt(truncatedToolNames?: readonly string[]): string;
+/**
+ * 包成 error-recovery system-reminder 后再注入。
+ *
+ * 裸文本会被 `UserQueryWrapperAgentRunInterceptor` 当成用户输入包进 `<user_query>`，
+ * 模型会把内部续写提示读成用户提问；包成带 data-role 的 reminder 后，它与
+ * `buildErrorRecoveryReminder` 等其他恢复提示同形，也不会被当成规则型 reminder。
+ */
+export declare function buildTruncationRecoveryReminder(truncatedToolNames?: readonly string[]): string;

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

@@ -266,6 +266,7 @@ export declare abstract class InputItemUtils {
     static isStructuredCompactBoundaryMessage(item: AgentInputItem): boolean;
     static isReplayRecoverableCompactMessage(item: AgentInputItem): item is UserMessageItem;
     static isCompactUserMessage(item: AgentInputItem): item is UserMessageItem;
+    static isCompactEnvelopeMessage(item: AgentInputItem): item is UserMessageItem;
     private static hasCompactBoundaryContent;
     static isCompactContinuePromptMessage(item: AgentInputItem): item is UserMessageItem;
     private static hasTeammateMessageContent;

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

@@ -12,6 +12,7 @@ export declare abstract class MessageUtils {
      * @returns 合并后的消息列表
      */
     static mergeConsecutiveUserMessages(messages: AgentInputItem[]): AgentInputItem[];
+    private static shouldKeepUserMessageSeparate;
     /**
      * 合并用户消息组
      *

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

@@ -1,6 +1,7 @@
 export * from './agent/openai-agents-types';
 export * from './agent-home/agent-home-envelope-body';
 export * from './utils/abort-utils';
+export * from './utils/concurrency-utils';
 export * from './utils/retry-backoff';
 export * from './utils/retry-policy';
 export * from './settings/settings-types';

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

@@ -35,6 +35,8 @@ export declare enum ToolNames {
     IMAGE_EDIT = "ImageEdit",
     ARTIFACT = "Artifact",
     ARTIFACT_CONTROL = "ArtifactControl",
+    /** 资料库上传：把本地单个文件上传为资料库节点。工具名按既有外部契约固定为下划线风格。 */
+    LIBRARY_UPLOAD = "LibraryUpload",
     TEAM_CREATE = "TeamCreate",
     TEAM_DELETE = "TeamDelete",
     SEND_MESSAGE = "SendMessage",

package/cli/dist-server/types/vendor/cbc-shared/node/utils/concurrency-utils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Map items with a bounded number of async workers while preserving input
+ * order in the returned results.
+ */
+export declare function mapWithConcurrency<T, R>(items: readonly T[], concurrency: number, mapper: (item: T, index: number) => Promise<R>): Promise<R[]>;

package/cli/dist-server/types/workspace/cbc-core/lib/node/agent/agent-protocol.d.ts

@@ -760,6 +760,11 @@ export interface AgentRunRequest<TContext = Session> extends SessionOptions {
     skipAddHistory?: boolean;
     bypassMessageQueue?: boolean;
     inputOrigin?: AgentRunOrigin;
+    /**
+     * Whether the batch admitted by MessageQueue contains an external user prompt.
+     * Captured before History replaces input with the active conversation history.
+     */
+    hasExternalUserPromptAtAdmission?: boolean;
     /** Process-local arrival callback; never passed to the SDK. */
     onResult?: AgentStandardRunOptions['onResult'];
     traceId?: string;

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

@@ -1,8 +1,22 @@
 import type { AcpTerminalEndReason } from '../../../../cbc-shared/lib/node/index.js';
+export interface BackgroundTaskOutputRead {
+    /** Absolute character offset requested for this read, clamped to the current output range. */
+    fromOffset: number;
+    /** Absolute character offset immediately after the returned snapshot. */
+    nextOffset: number;
+    /** Preserved output for the requested range, including an omission marker when needed. */
+    content: string;
+    /** Unread characters no longer retained by the bounded buffer. */
+    omittedLength: number;
+}
 /** Output buffer capabilities used by task producers and consumers. */
 export interface BackgroundTaskOutputBuffer {
     push(data: string): void;
     toString(withMarker?: boolean): string;
+    /** Absolute character offset at the current end of the output stream. */
+    getEndOffset(): number;
+    /** Read output retained after an absolute character offset. */
+    readSince(offset: number): BackgroundTaskOutputRead;
     isEmpty(): boolean;
     getHead(): string;
     getTail(): string;

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

@@ -1062,13 +1062,13 @@ export interface SessionFactory {
 /**
  * 传给 SessionManager/SessionStore.get() 的选项。
  *
- * 默认情况下，session 反序列化会施加一个逆序截断（仅读最近 ~1000 条历史），
+ * 默认情况下，session 反序列化会从尾部截断（仅读最近 ~1000 条历史），
  * 目的是保证正常运行时（会话续聊、模型上下文装配）的性能与内存占用。
  * 展示型场景（如历史回放给前端完整聊天视图）可以通过 `historyLimit` 放大上限。
  */
 export interface SessionGetOptions {
     /**
-     * 从 jsonl 逆序读取的历史 item 数上限。
+     * 从 jsonl 尾部加载的历史 item 数上限。
      *
      * - 未传：沿用默认 1000（服务于续聊、checkpoint、模型上下文等场景）。
      * - 显式传值：按该值截断（如展示型 replay 传 10000）。

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

@@ -5,6 +5,12 @@ import { LocalJsonlSessionStore } from './local-jsonl-session-store.js';
 import { type Session, SessionFactory, type SessionForkMutationOptions, type SessionGetOptions, type SessionRewindMutationOptions, SessionStore, type TranscriptPersistenceMetrics } from './session-protocol.js';
 import type { Lane, LanePointer, SessionKey, SessionStoreEntry } from './session-store-contract.js';
 import { SessionImageStorage as ImageBlobService, SessionRestoreHost, SessionStoragePaths, SessionToolOutputStorage as ToolResultBlobService } from './session-store-host-protocol.js';
+/**
+ * Read transcript tails in moderately sized blocks. Small files naturally use
+ * one read, while large files stop as soon as the requested history window is
+ * complete instead of retaining the entire transcript in memory.
+ */
+export declare const SESSION_REVERSE_READ_CHUNK_BYTES: number;
 /**
  * session/load 回放时 history 的默认最大条数。
  * 达到此阈值且遇到 user message 时停止逆序读取，避免启动时全量读 JSONL。
@@ -291,6 +297,13 @@ export declare class SessionStoreImpl implements SessionStore {
      */
     protected deserializeSessionFromPath(filePath: string, options?: SessionGetOptions): Promise<Session | undefined>;
     protected getSessionId(filePath: string): string;
+    /**
+     * Read complete UTF-8 JSONL records from newest to oldest with bounded I/O.
+     * Newline bytes are safe boundaries in UTF-8; a record is decoded only
+     * after all of its cross-chunk Buffer fragments have been assembled.
+     */
+    protected readLinesFromEnd(filePath: string, fileSize: number, consumeLine: (line: string) => boolean): Promise<number>;
+    private decodeReverseLine;
     private getPreferredProjectDirs;
     get(id: string, options?: SessionGetOptions): Promise<Session | undefined>;
     getAcrossProjects(id: string, options?: SessionGetOptions): Promise<Session | undefined>;

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

@@ -98,3 +98,11 @@ export declare function readTruncatedResponseUsage(lastTurnResponse: unknown): {
  * 截断不该因为落在不同入口而收到不同指导。
  */
 export declare function buildRecoveryPrompt(truncatedToolNames?: readonly string[]): string;
+/**
+ * 包成 error-recovery system-reminder 后再注入。
+ *
+ * 裸文本会被 `UserQueryWrapperAgentRunInterceptor` 当成用户输入包进 `<user_query>`，
+ * 模型会把内部续写提示读成用户提问；包成带 data-role 的 reminder 后，它与
+ * `buildErrorRecoveryReminder` 等其他恢复提示同形，也不会被当成规则型 reminder。
+ */
+export declare function buildTruncationRecoveryReminder(truncatedToolNames?: readonly string[]): string;

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

@@ -266,6 +266,7 @@ export declare abstract class InputItemUtils {
     static isStructuredCompactBoundaryMessage(item: AgentInputItem): boolean;
     static isReplayRecoverableCompactMessage(item: AgentInputItem): item is UserMessageItem;
     static isCompactUserMessage(item: AgentInputItem): item is UserMessageItem;
+    static isCompactEnvelopeMessage(item: AgentInputItem): item is UserMessageItem;
     private static hasCompactBoundaryContent;
     static isCompactContinuePromptMessage(item: AgentInputItem): item is UserMessageItem;
     private static hasTeammateMessageContent;

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

@@ -12,6 +12,7 @@ export declare abstract class MessageUtils {
      * @returns 合并后的消息列表
      */
     static mergeConsecutiveUserMessages(messages: AgentInputItem[]): AgentInputItem[];
+    private static shouldKeepUserMessageSeparate;
     /**
      * 合并用户消息组
      *

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

@@ -1,6 +1,7 @@
 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/concurrency-utils.js';
 export * from './utils/retry-backoff.js';
 export * from './utils/retry-policy.js';
 export * from './settings/settings-types.js';

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

@@ -35,6 +35,8 @@ export declare enum ToolNames {
     IMAGE_EDIT = "ImageEdit",
     ARTIFACT = "Artifact",
     ARTIFACT_CONTROL = "ArtifactControl",
+    /** 资料库上传：把本地单个文件上传为资料库节点。工具名按既有外部契约固定为下划线风格。 */
+    LIBRARY_UPLOAD = "LibraryUpload",
     TEAM_CREATE = "TeamCreate",
     TEAM_DELETE = "TeamDelete",
     SEND_MESSAGE = "SendMessage",

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

@@ -0,0 +1,5 @@
+/**
+ * Map items with a bounded number of async workers while preserving input
+ * order in the returned results.
+ */
+export declare function mapWithConcurrency<T, R>(items: readonly T[], concurrency: number, mapper: (item: T, index: number) => Promise<R>): Promise<R[]>;

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

@@ -915,6 +915,12 @@ export declare enum ProductFeature {
      * @default false
      */
     Artifact = "Artifact",
+    /**
+     * 是否开启资料库上传（把本地单个文件上传为资料库节点）能力。
+     * 关闭时工具不注册，模型看不到；endpoint / 登录态等其它前置条件由工具自身再校验。
+     * @default false
+     */
+    LibraryUpload = "LibraryUpload",
     /**
      * 是否开启 ShareLink（本地 HTML → 上传 → 可分享公网链接）能力
      * @deprecated 兼容保留，请改用 Artifact key（新 key 优先，本 key 兜底）。
@@ -1095,21 +1101,10 @@ export declare enum ProductFeature {
      */
     ConversationEngine = "ConversationEngine",
     /**
-     * TencentDesignX 设计能力开关
-     * 设置为 true 时，启用 TencentDesignX 相关功能入口。
-     *
-     * 版本说明：5.4.0 之前的客户端版本仍使用 `TencentDesignX` 开关控制 Ardot 设计入口；
-     * 5.4.0 版本之后 `TencentDesignX` 开关作废，改为使用 `EnableArdot` 开关控制 Ardot 设计入口。
-     * @deprecated 新版客户端改用 `EnableArdot` 控制 Ardot 设计入口；本 key 不再参与门控，
-     * 仅为兼容历史下发保留 enum 登记。
-     * @default false
-     */
-    TencentDesignX = "TencentDesignX",
-    /**
-     * Ardot 设计入口特性开关（unleash / product feature flag）。
-     * 取代旧的 `TencentDesignX` 成为新版客户端 Ardot「设计创意」入口的唯一门控 key：
+     * Ardot 族（画布设计）能力开关（unleash / product feature flag）。
      * 客户端 product.json 写默认值，后端 `/v3/config` 下发覆盖。
-     * 设置为 true 时启用 Ardot 设计入口；缺省 / false 关闭（opt-in）。
+     * 设置为 true 时向设计会话暴露 ardot MCP（含其静默授权）、展示 Ardot 场景胶囊并自动注入 ardot skill；缺省 / false 关闭（opt-in）。
+     * 「设计创意」Tab 不再由本开关决定：Miora 能力恒可用，Tab 始终展示。
      * 各版本默认值：SaaS（个人版 / 旗舰版）= true；专享版 / 专享版私有化 / 海外版 = false。
      *
      * 版本说明：5.4.0 之前的客户端版本仍使用 `TencentDesignX` 开关控制 Ardot 设计入口；
@@ -1329,6 +1324,31 @@ export declare enum ProductFeature {
      * @default false（未配置默认不启用云端专家能力）
      */
     EnableExpertToCloud = "EnableExpertToCloud",
+    /**
+     * 客户端是否消费企业「专家页」装配布局（Issue #100136）。
+     *
+     * 开启后客户端专家页的三个区域（顶部推荐槽 / Tab 条 / 分类 chip 栏）
+     * 按 admin 装配的布局渲染；关闭时全部回落客户端本地默认布局。
+     *
+     * 「专享版 / 私有化」的判定依据：该形态下 `enterpriseId` 可能为空或不可靠，
+     * 仅靠 `enterpriseId` 判定会把专享版误判成个人版而丢失企业配置
+     * （与 skill 侧 `EnableSkillPageLayout` 同款实测结论）。故本 flag 随
+     * **专享版包**注入 true，客户端判定为：
+     *
+     * ```
+     * 消费 layout = 本 flag === true
+     *            || (enterpriseId 存在 && !isTencentSSO(enterpriseId))   // 旗舰版
+     * ```
+     *
+     * 只在 `build/patches/workbuddy-custom/product.json`（专享版）置 true，
+     * **其余产品配置不写** —— 缺失即 false，判定回落到 enterpriseId 分支。
+     *
+     * ⚠️ 同一变量也决定 admin 侧是否展示「客户端页面装配 / 推荐位 / 分类管理」
+     * 三个 Tab，两端共用同一源以避免判定漂移（对齐 skill 侧 §7.1.2 的结论）。
+     *
+     * @default false（缺省即关闭；仅专享版 product.json 置 true）
+     */
+    EnableExpertPageLayout = "EnableExpertPageLayout",
     /**
      * 禁用对话框中的语音输入（ASR）入口
      * 设置为 true 时，隐藏聊天输入框中的麦克风按钮，
@@ -1650,14 +1670,6 @@ export declare enum ProductFeature {
      * @default false（未配置默认不启用云端 Skill 能力）
      */
     EnableSkillToCloud = "EnableSkillToCloud",
-    /**
-     * 是否禁用侧边栏扩展菜单入口（disable 语义）。#114901
-     * 设置为 true 时，侧边栏与「更多」下拉均不渲染扩展（extension）菜单入口。
-     * 用于无需暴露扩展导航栏的发行版（如海外版 workbuddy-ai）。
-     * 缺省 / false 时行为不变（正常展示扩展入口）。
-     * @default false
-     */
-    DisableExtensionMenuEntries = "DisableExtensionMenuEntries",
     /**
      * 是否禁用「存储扩容/升级」入口（disable 语义）。#73830 #73721
      *

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

@@ -17,6 +17,7 @@ export * from './enhance-prompt.js';
 export * from './config.js';
 export * from './security-center.js';
 export * from './ai-asset-security.js';
+export * from './workspace-report.js';
 export * from './updates.js';
 export * from './log.js';
 export * from './completion.js';

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

@@ -104,7 +104,11 @@ export interface ModelReasoning {
 export type ModelPromotionKind = 'discount' | 'new_model' | 'recommendation' | 'free_trial';
 export interface ModelPromotionBadge {
     readonly label: string;
-    readonly color: string;
+    readonly shortLabel?: string;
+    readonly labelEn?: string;
+    readonly shortLabelEn?: string;
+    readonly icon?: string;
+    readonly color?: string;
     readonly display?: 'always' | 'activeOnly';
 }
 export interface ModelPromotionDailyWindow {

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

@@ -28,6 +28,7 @@ import { Skill } from './skill.js';
 import { TelemetryConfiguration } from './telemetry.js';
 import { TokenUsageThresholds } from './token-usage-thresholds.js';
 import { UpdatesConfiguration } from './updates.js';
+import { WorkspaceReportConfig } from './workspace-report.js';
 /**
  * 输出样式配置
  */
@@ -165,6 +166,12 @@ export interface ProductConfiguration {
      * 见 ai-asset-security.ts 的 RemoteAiAssetSecurity / resolveForbidHighRiskSkillInstall。
      */
     aiAssetSecurity?: RemoteAiAssetSecurity;
+    /**
+     * 「Workspace 全量上报」阈值 / 过滤配置（issue #125146，需求 WB-TLM-WS-001 v1.1）。
+     * /v3/config 顶层下发，与 aiAssetSecurity / tokenUsageThresholds 同级。缺省关闭。
+     * 见 workspace-report.ts 的 WorkspaceReportConfig / resolveWorkspaceReportConfig。
+     */
+    workspaceReport?: WorkspaceReportConfig;
     /**
      * TAB 实验配置拉取开关。
      *

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

@@ -0,0 +1,119 @@
+/**
+ * 「Workspace 全量上报」阈值 / 过滤配置下发契约（issue #125146，需求 WB-TLM-WS-001 v1.1）。
+ *
+ * 放在 @genie/product 以便 workbuddy-server（daemon）与渲染层共用同一真值来源，
+ * 与 tokenUsageThresholds / aiAssetSecurity 的定位一致，挂在 /v3/config **顶层**。
+ *
+ * 设计取向：**全部字段可选**。远端不下发 / 下发脏值时，一律回落到 `resolveWorkspaceReportConfig()`
+ * 内置的 fail-safe 默认值（= PRD R4 定义的门限）。上报功能是旁路能力，配置读取绝不可抛错
+ * 打断对话链路——resolve 内部 try/catch 兜底成默认值。
+ *
+ * 降级判定（自上而下命中即停，全基于扫描统计，唯 ④ 需压缩后判定）：
+ *   ① fileCount > hardAbortFileCount                                → meta（停扫兜底防超大仓，仍产元数据）
+ *   ② fileCount > maxFileCount 或 totalBytes > maxTotalBytes 或 超时  → meta（仅统计，不扫内容）
+ *   ③ totalBytes > maxInputBytesForFull 或 fileCount > maxInputFileCountForFull → manifest（仅目录树）
+ *   ④ full 打包后 产物 > maxOutputBytesForFull                        → manifest（回落，产物过大不带内容）
+ *   否则 → full（完整内容包 tar+zstd）
+ *
+ * size 与 fileCount 正交：size 挡「少量大文件」，count 挡「海量小文件」，两个门限都保留、都靠
+ * 扫描 stat 免费获得。v1.1 起 **SKIP 已并入 meta**：不再有「彻底不产元数据」的静默档，超大仓
+ * 命中 ① 时停扫并按 meta 上报停扫时的 fileCount（让服务端也能感知超大仓的存在）。
+ * full/manifest/meta 任一级别都产出一行元数据（客户端只负责采集/上传，不做去重）。
+ */
+/** 打包压缩相关配置。 */
+export interface WorkspaceReportCompression {
+    /** zstd 压缩级别（1-22）。缺省 10。 */
+    zstdLevel?: number;
+}
+/** 采集缓存复用配置（R4：30 分钟内且顶层 mtime 未变则复用上次内容包）。 */
+export interface WorkspaceReportCache {
+    /** 缓存有效期（毫秒）。缺省 30 分钟。 */
+    ttlMs?: number;
+}
+/** 过滤规则：与仓库 .gitignore 合并后喂给 `ignore` 包。 */
+export interface WorkspaceReportFilter {
+    /**
+     * 额外排除的文件后缀（含点，如 ".log"）。**缺省空、默认不过滤任何后缀**。
+     *
+     * 注意：刻意**不**内置媒体/二进制后缀黑名单。WorkBuddy 主要面向办公场景，pptx / docx / 视频 /
+     * 图片 / 各类二进制文档都是用户真实工作产物，**都需要上报**，绝不能默认过滤掉。
+     * 仅当远端出于特定分析需求显式下发时才按此清单排除，客户端不做任何内置类型裁剪。
+     */
+    excludeSuffixes?: string[];
+    /** 额外的 ignore glob 规则（gitignore 语法）。缺省空。 */
+    extraIgnorePatterns?: string[];
+}
+/** /v3/config 顶层下发的「Workspace 全量上报」配置。全局生效。 */
+export interface WorkspaceReportConfig {
+    /** 总开关。缺省 / 非 `true` 视为关闭（不采集、不上报），维持现网零开销。 */
+    enabled?: boolean;
+    /** full 级别输入内容上限（字节）。超过降级为 manifest。缺省 200MB（客户端压缩成本瓶颈）。 */
+    maxInputBytesForFull?: number;
+    /** full 级别输入文件数上限。超过降级为 manifest（海量小文件也压不动）。缺省 20000。 */
+    maxInputFileCountForFull?: number;
+    /** full 级别打包产物上限（字节）。超过降级为 manifest。缺省 100MB（服务端可收 200MB，留半余量）。 */
+    maxOutputBytesForFull?: number;
+    /** meta 级别文件数门限。超过直接降级为 meta。缺省 100000。 */
+    maxFileCount?: number;
+    /** meta 级别总大小门限（字节）。超过直接降级为 meta。缺省 2GB。 */
+    maxTotalBytes?: number;
+    /** 超大仓兜底门限：文件数超过此值停止扫描，按 meta 上报停扫时的 fileCount（v1.1 起并入 meta，不再彻底静默）。缺省 500000。 */
+    hardAbortFileCount?: number;
+    /** 扫描超时（毫秒）。超时降级为 meta。缺省 10 秒。 */
+    scanTimeoutMs?: number;
+    /** base manifest 缓存的 LRU 容量上限（每 workspace 一条）。缺省 32。 */
+    workspaceBaseCacheMaxEntries?: number;
+    compression?: WorkspaceReportCompression;
+    cache?: WorkspaceReportCache;
+    filter?: WorkspaceReportFilter;
+}
+/** 解析后的配置（所有字段必存，供 daemon 直接消费）。 */
+export interface ResolvedWorkspaceReportConfig {
+    enabled: boolean;
+    maxInputBytesForFull: number;
+    maxInputFileCountForFull: number;
+    maxOutputBytesForFull: number;
+    maxFileCount: number;
+    maxTotalBytes: number;
+    hardAbortFileCount: number;
+    scanTimeoutMs: number;
+    workspaceBaseCacheMaxEntries: number;
+    zstdLevel: number;
+    cacheTtlMs: number;
+    excludeSuffixes: string[];
+    extraIgnorePatterns: string[];
+}
+/**
+ * 默认忽略清单（gitignore 语法，合并进 extraIgnorePatterns）。
+ *
+ * 只收录**确定为依赖 / 构建产物 / 工具缓存**的目录，避免误伤源码。参考本仓已实战的
+ * `packages/codebase/src/node/constants/file.ts` DEFAULT_IGNORE 裁剪而来。
+ *
+ * 刻意**不加**的高误伤项：`build/`（项目常把构建脚本放这）、`out/` `bin/` `obj/`（含义
+ * 因语言而异）、`vendor/`（Go modules 时代可能是显式 vendored 依赖）。远端可通过
+ * extraIgnorePatterns 追加，仓库 .gitignore 也照常生效。
+ */
+export declare const WORKSPACE_REPORT_DEFAULT_IGNORE: readonly string[];
+/**
+ * 密钥 / 敏感文件 denylist（gitignore 语法）。
+ *
+ * **安全边界，与 {@link WORKSPACE_REPORT_DEFAULT_IGNORE} 分离**：默认忽略清单是「省体积」的
+ * 依赖/产物过滤，可被仓库 `.gitignore` 或远端 `extraIgnorePatterns` 用 `!` 取反覆盖；本 denylist
+ * 是「防外发」的密钥保护，由采集侧独立 matcher 判定，命中即排除——**不参与合并、不可被 `!`
+ * 取反、不受仓库 `.gitignore` 或远端配置影响**（BL-CLI-11 敏感信息外发须经统一策略、不得被替代
+ * 入口绕过；BL-CLI-13 最小必要）。命中的文件既不进内容包 tar，也不进 manifest 文件清单。
+ *
+ * 覆盖常见凭据形态：环境变量文件、私钥/证书、SSH 身份、云厂商与 K8s 凭据目录、包管理器 token。
+ * 采用宽匹配（如 `*.pem`）优先防漏，误伤真源码的概率极低（这些后缀/文件名本就不该是业务源码）。
+ */
+export declare const WORKSPACE_REPORT_SECRET_DENYLIST: readonly string[];
+/** PRD R4 门限的 fail-safe 默认值。 */
+export declare const WORKSPACE_REPORT_DEFAULTS: ResolvedWorkspaceReportConfig;
+/**
+ * 解析「Workspace 全量上报」配置。
+ *
+ * 缺省 / 脏值一律回落默认值；`enabled` 只有显式 `true` 才开启（对齐 aiAssetSecurity
+ * 的 `=== true` 口径——上报是主动能力，缺省必须是关，绝不能因脏值凭空开启采集/上传）。
+ * 任何异常 fail-safe 到全默认（含 enabled=false），保证读配置永不打断对话链路。
+ */
+export declare function resolveWorkspaceReportConfig(product: unknown): ResolvedWorkspaceReportConfig;

package/cli/package.json

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