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

package/cli/dist-server/types/node/telemetry/sandbox-telemetry-protocol.d.ts

@@ -0,0 +1,164 @@
+import type { ModifyBackupCommittedPayload, SafeDeleteBulkApprovalPayload, SandboxDaemonFailurePayload, SandboxDaemonStartupFinishedPayload, SandboxSafetyTogglePayload, SandboxThreatDatabaseHitPayload, SandboxThreatDatabaseLoadPayload, SandboxTurnStatePayload, SecurityReviewApprovalPayload, SecurityReviewModelCallPayload, SecurityReviewResultProtectionPayload, SecurityReviewToolCallPayload, ToolCallInterceptPayload, ToolCallNativeRerunPayload, ToolCallOutcomePayload, ToolCallSandboxFirstRunPayload } from '../../workspace/telemetry/lib/common/index.js';
+import type { ReportEventRequest } from '../sandbox-cli/sandbox-cli-protocol';
+/**
+ * Sandbox 上报场景化门面。
+ *
+ * 设计契约：[apps/workbuddy-desktop/docs/沙盒上报设计.md]。
+ *
+ * 业务代码调用沙箱事件的**唯一入口**：
+ * - 屏蔽底层 `GalileoService.logInfo / logError` 的弱类型
+ * - 每个方法对应一个独立伽利略 message，attribute set 各自约束
+ * - 集中处理"埋点失败不影响主流程"
+ * - 自动剔除 undefined attribute，避免 tags 里塞一堆空值
+ *
+ * 核心事件（伽利略 message）：
+ * - `sandbox.turn_sandbox_cli_usage.recorded` — 每轮 sandbox-cli 生效状态记录
+ * - `sandbox.enable_switch.changed`           — 沙箱启用开关状态变更（保留契约，当前无生产注入）
+ * - `sandbox.daemon.startup.finished` — sandbox-cli 启动 / 重启尝试终态
+ * - `sandbox.daemon.failure`    — sandbox-cli 启动 / 运行期失败（当前生成 11 个 phase 子场景）
+ * - `sandbox.tool_call.sandbox_first_run.finished` — 沙箱首跑结果
+ * - `sandbox.tool_call.native_rerun.finished` — native 重跑结果
+ * - `sandbox.tool_call.outcome` — 命令终局（全量漏斗与分母）
+ * - `sandbox.tool_call.intercept` — 用户授权弹窗选择
+ * - `sandbox.safe_delete.bulk_approval.finished` — safe-delete 批量删除保护审批结果
+ */
+export declare const SandboxTelemetryReporter: unique symbol;
+/**
+ * Sandbox 上报场景化门面接口。每个方法对应一个伽利略事件 message。
+ */
+export interface SandboxTelemetryReporter {
+    reportSecurityReviewToolCall(payload: SecurityReviewToolCallPayload): void;
+    /** 每次 reviewer 模型调用（含降级调用）结算一条。 */
+    reportSecurityReviewModelCall(payload: SecurityReviewModelCallPayload): void;
+    reportSecurityReviewApproval(payload: SecurityReviewApprovalPayload): void;
+    reportSecurityReviewResultProtection(payload: SecurityReviewResultProtectionPayload): void;
+    /** 每个真实用户 turn 上报本轮 sandbox-cli 是否在执行链路里生效。 */
+    reportTurnState(payload: SandboxTurnStatePayload): void;
+    /** 安全中心中用户手动切换沙箱启用开关；当前仅保留契约，没有生产调用方。 */
+    reportSandboxSafetyToggle(payload: SandboxSafetyTogglePayload): void;
+    /** 每次真实 bootstrap / restart 尝试最终严格上报一条。 */
+    reportDaemonStartupFinished(payload: SandboxDaemonStartupFinishedPayload): void;
+    /**
+     * sandbox-cli daemon 失败统一上报入口。
+     *
+     * 覆盖 daemon 整个生命周期当前生成的 11 个失败 phase（startup-* / runtime-*）。
+     * 调用方按 phase 填充对应字段，参考 `SandboxDaemonFailurePayload` 上的
+     * 字段命中矩阵。
+     */
+    reportDaemonFailure(payload: SandboxDaemonFailurePayload): void;
+    /**
+     * 命令进入沙箱后的首跑结果。
+     *
+     * 只在命令真正进入沙箱后上报；pre-exec 阶段直接放行 / 拒绝的命令不触发。
+     * 本事件记录首跑阶段事实，终局放行 / 拒绝仍由 `reportToolCallOutcome` 表达。
+     */
+    reportToolCallSandboxFirstRun(payload: ToolCallSandboxFirstRunPayload): void;
+    /**
+     * native 重跑真实执行结果。
+     *
+     * 只在沙箱首跑后发生本地重跑时上报；pre-exec 直接本地放行 / 会话缓存放行
+     * 不触发。本事件记录 native 重跑是否真的成功，权限链路结论仍由
+     * `reportToolCallOutcome` 表达。
+     */
+    reportToolCallNativeRerun(payload: ToolCallNativeRerunPayload): void;
+    /**
+     * 真正向用户弹出授权弹窗的拦截场景上报。
+     *
+     * 由 `SandboxOrchestrator` 在新权限路径真正展示授权弹窗、并拿到用户 `decision`
+     * 后调用；auto-approve（零弹窗）与未拦截命令都不触发。
+     */
+    reportToolCallIntercept(payload: ToolCallInterceptPayload): void;
+    /**
+     * safe-delete 批量删除保护审批结果。
+     *
+     * 由 `SandboxOrchestrator` 在 safe-delete runtime 输出 bulk confirm marker、
+     * 复用授权 UI 拿到用户选择后调用。它不是沙箱文件 / 网络权限拦截，不应复用
+     * `reportToolCallIntercept`。
+     */
+    reportSafeDeleteBulkApproval(payload: SafeDeleteBulkApprovalPayload): void;
+    /**
+     * 命令终局全链路上报（pre-exec + post-exec 全漏斗）。
+     *
+     * 由 `SandboxOrchestrator` 在 `execute()` 的每个终止点调用一条。Payload 中的
+     * `stage/outcome/reason/prompted/autoApproveReason` 用于调用点内部归因和兼容，v2
+     * reporter 不输出这些旧字段；最终日志使用 `decisionReason/route/permissionResult/
+     * sandboxPrompted/autoReleaseReason` 等 v2 字段。与 `reportToolCallIntercept`
+     * （真实弹窗子集）互补，本事件提供完整漏斗与分母。
+     * `status` 仍由内部 `outcome/reason` 派生（reporter 内部处理）。
+     */
+    reportToolCallOutcome(payload: ToolCallOutcomePayload): void;
+    /**
+     * FinalStop 收尾阶段 CommitModifyBackup 成功后上报 modify backup 统计数据。
+     *
+     * 仅当 IPC 响应同时携带 `totalModifyBackupSizeMb` 和
+     * `modifyBackupSessionCount` 时调用。用于观测磁盘占用和 session 数量趋势。
+     */
+    reportModifyBackupCommitted(payload: ModifyBackupCommittedPayload): void;
+    /**
+     * 恶意域名威胁库同步尝试结果上报。
+     *
+     * 只描述实际进入 ThreatDomainChecker 的同步尝试，不代表所有用户 turn 的
+     * Sandbox 覆盖率；整体覆盖率需结合 sandbox.turn_sandbox_cli_usage.recorded。
+     * reporter 必须是纯旁路，调用异常不得影响 DB 同步或恶意域名判断。
+     */
+    reportThreatDatabaseLoad(payload: SandboxThreatDatabaseLoadPayload): void;
+    /**
+     * 上报一次恶意域名命中，回答「防护实际拦下了什么」。
+     *
+     * 与安全中心审计写入同址、共用同一套去重，条数与用户看到的记录一一对应。
+     * reporter 必须是纯旁路，调用异常不得影响拦截行为或审计写入。
+     */
+    reportThreatDatabaseHit(payload: SandboxThreatDatabaseHitPayload): void;
+    /**
+     * 接收 sandbox-cli 通过反向事件 `ReportEvent` 上送的原始 envelope。
+     *
+     * 当前没有任何 scene/action 需要翻译成伽利略事件，全部丢弃：sandbox-cli 每次
+     * OpenSession 都会上送 `sandbox_projfs.mount`，静默丢弃避免刷 warn；其余未知
+     * scene/action 写 warn 日志后丢弃，便于发现协议漂移。
+     */
+    ingestRawEvent(envelope: ReportEventRequest): void;
+}
+export interface SandboxExecResultLike {
+    exitCode: number | null;
+    signal: NodeJS.Signals | string | null;
+    interrupted: boolean;
+    sandboxDenied?: boolean;
+    /**
+     * sandbox 内被升级 / 提权拒绝的标记。仅在升级流程下相关，普通 deny 路径
+     * 上不一定填。详见 SandboxOrchestratorResult。
+     */
+    sandboxEscalationDenied?: boolean;
+    fileBlockRecords?: ReadonlyArray<FileBlockRecordLike> | undefined;
+    networkBlockRecords?: ReadonlyArray<NetworkBlockRecordLike> | undefined;
+}
+/**
+ * 单条文件拦截记录的窄接口 —— sandbox-cli-protocol 同名类型的字段子集。
+ *
+ * 故意不直接 import `FileBlockRecord` 类型：避免 telemetry 包反向依赖
+ * sandbox-cli protocol（保持依赖方向：tools / orchestrator → telemetry）。
+ *
+ * 字段：
+ * - `path` 文件绝对路径（不脱敏，按业务上报需要全文上报）
+ * - `actionMask` 操作 bitmask：0x01=READ, 0x02=WRITE, 0x04=DELETE, 0x08=EXECUTE
+ *   解码为人类可读字符串走 [`decodeFileActionMask`] helper
+ */
+export interface FileBlockRecordLike {
+    path: string;
+    actionMask: number;
+}
+/**
+ * 单条网络拦截记录的窄接口 —— sandbox-cli-protocol 同名类型的字段子集。
+ *
+ * 字段：
+ * - `host` 被拦截的域名 / IP（不脱敏）
+ * - `port` 端口（可选）
+ * - `protocol` 协议（"tcp" / "udp" / "dns" 等；与 sandbox-cli-protocol 字段名保持一致）
+ * - `actionMask` 操作 bitmask：0x01=CONNECT, 0x02=DNS_RESOLVE, 0x04=SENDTO
+ *   解码为人类可读字符串走 [`decodeNetworkActionMask`] helper
+ */
+export interface NetworkBlockRecordLike {
+    host: string;
+    port?: number;
+    protocol: string;
+    actionMask: number;
+}

package/cli/dist-server/types/node/telemetry/sandbox-telemetry-service.d.ts

@@ -0,0 +1,181 @@
+import { Logger } from '@celljs/core';
+import { type ModifyBackupCommittedPayload, type SafeDeleteBulkApprovalPayload, type SandboxDaemonFailurePayload, type SandboxDaemonStartupFinishedPayload, type SandboxInterceptType, type SandboxSafetyTogglePayload, type SandboxStatus, type SandboxThreatDatabaseHitPayload, type SandboxThreatDatabaseLoadPayload, type SandboxThreatDatabaseUnavailableReason, type SandboxToolCallOutcome, type SandboxTurnStatePayload, type SecurityReviewApprovalPayload, type SecurityReviewModelCallPayload, type SecurityReviewResultProtectionPayload, type SecurityReviewToolCallPayload, type ToolCallInterceptPayload, type ToolCallNativeRerunPayload, type ToolCallOutcomePayload, type ToolCallSandboxFirstRunPayload } from '../../workspace/telemetry/lib/common/index.js';
+import { GalileoService } from '../galileo/galileo-protocol';
+import type { ReportEventRequest } from '../sandbox-cli/sandbox-cli-protocol';
+import { type SandboxExecResultLike, SandboxTelemetryReporter } from './sandbox-telemetry-protocol';
+/**
+ * `SandboxTelemetryReporter` 默认实现。
+ *
+ * 实现注意事项：
+ * - 每个 `report*` 方法直接构造伽利略 attribute 对象（语义化 key，零 JSON 序列化），
+ *   并同步写入 OTel 本地 buffer；实际网络导出由 Galileo BatchProcessor 异步完成，
+ *   不返回可被主链路等待的 Promise。
+ * - 字段长度护栏：errorMsg 等可能超长的字段在 reporter 内部截断到位。
+ * - 报错容错：序列化或 GalileoService 任一环节失败，记 warn 后吞掉，不影响主流程。
+ *
+ * 上报通路：
+ * - 业务字段统一通过 `GalileoService.logInfo / logError` 落到伽利略 logs。
+ * - 失败 / 超时（status ∈ {failed, timeout}）走 `logError`，其余走 `logInfo`。
+ *   伽利略后台日志级别可直接当告警入口。
+ */
+export declare class SandboxTelemetryReporterImpl implements SandboxTelemetryReporter {
+    protected readonly galileoService: GalileoService;
+    protected readonly logger: Logger;
+    reportSecurityReviewToolCall(payload: SecurityReviewToolCallPayload): void;
+    reportSecurityReviewModelCall(payload: SecurityReviewModelCallPayload): void;
+    reportSecurityReviewApproval(payload: SecurityReviewApprovalPayload): void;
+    reportSecurityReviewResultProtection(payload: SecurityReviewResultProtectionPayload): void;
+    reportTurnState(payload: SandboxTurnStatePayload): void;
+    reportSandboxSafetyToggle(payload: SandboxSafetyTogglePayload): void;
+    reportDaemonStartupFinished(payload: SandboxDaemonStartupFinishedPayload): void;
+    /**
+     * 上报 daemon 失败事件，兼容 main 历史 phase 并覆盖 5.3.x 新 phase
+     * （详见 `SandboxDaemonFailurePayload`）。
+     * undefined 字段被 `_buildAttributes` 自动剔除。
+     */
+    reportDaemonFailure(payload: SandboxDaemonFailurePayload): void;
+    /**
+     * 上报命令进入沙箱后的首跑结果。`status` 只承载日志严重级：
+     * 基础设施异常进 logError，其余业务结果进 logInfo，业务结论看 `result`。
+     */
+    reportToolCallSandboxFirstRun(payload: ToolCallSandboxFirstRunPayload): void;
+    /**
+     * 上报沙箱首跑后的 native 重跑结果。`status` 只承载日志严重级：
+     * native 执行基础设施异常进 logError，其余业务执行结果进 logInfo。
+     */
+    reportToolCallNativeRerun(payload: ToolCallNativeRerunPayload): void;
+    /**
+     * 上报真正向用户弹出授权弹窗的拦截场景（带用户最终 decision）。
+     *
+     * 由 `SandboxOrchestrator` 在新权限路径真正展示弹窗、拿到 `decision` 后调用；
+     * auto-approve（零弹窗）与未拦截命令都不触发。`status` 恒为 `failed`。
+     */
+    reportToolCallIntercept(payload: ToolCallInterceptPayload): void;
+    /**
+     * 上报 safe-delete 批量删除保护审批结果。它复用授权 UI，但业务含义不是
+     * 沙箱权限拦截，因此独立成事件；用户拒绝也是正常审批结果，status 仍为 success。
+     */
+    reportSafeDeleteBulkApproval(payload: SafeDeleteBulkApprovalPayload): void;
+    /**
+     * 命令终局全链路上报。`status` 由 `(outcome, reason)` 派生：仅**策略硬拦**
+     * （`forbidden` / `system-tool-blocked`）的 `deny` → failed（logError，留作安全
+     * 审计告警入口）；**用户主动拒绝**的 deny 及其余结局 → success（logInfo），避免
+     * 把正常用户拒绝灌进告警流。详见 {@link outcomeToStatus}。
+     */
+    reportToolCallOutcome(payload: ToolCallOutcomePayload): void;
+    reportModifyBackupCommitted(payload: ModifyBackupCommittedPayload): void;
+    /** 上报威胁库加载进 sandbox-cli 的结果；底层 _emit 已吞掉全部上报异常。 */
+    reportThreatDatabaseLoad(payload: SandboxThreatDatabaseLoadPayload): void;
+    /**
+     * 上报一次恶意域名命中；底层 `_emit` 已吞掉全部上报异常。
+     *
+     * 命中是防护成功生效，`status` 恒为 `success`——不能因为「拦了」就记 failed，否则告警
+     * 通道会被正常防护行为填满。拦截量与风险类型分布按 tags 聚合。
+     */
+    reportThreatDatabaseHit(payload: SandboxThreatDatabaseHitPayload): void;
+    /**
+     * sandbox-cli 通过反向事件 `ReportEvent` 上送的原始 envelope 入口。
+     *
+     * 当前没有任何 scene/action 需要翻译成伽利略事件，全部丢弃。`sandbox_projfs.mount`
+     * 由 sandbox-cli 每次 OpenSession 主动上送，静默丢弃避免刷 warn；其余未知
+     * scene/action 仍写 warn，便于发现协议漂移。
+     */
+    ingestRawEvent(envelope: ReportEventRequest): void;
+    /**
+     * 构造 attribute 并写入 Galileo 本地 OTel buffer。
+     *
+     * - 自动剔除 undefined value（保持 attribute 紧凑，伽利略后台"日志转指标"
+     *   配规则时按 dim 切片更干净）
+     * - SDK 类型 `Attributes` 是 `Record<string, string>`——number / boolean
+     *   会被 GalileoService 内部 normalizeAttributes 统一转字符串，业务侧无感
+     * - 失败 / 超时进 logError，其余进 logInfo
+     * - 字段构造和本地入队任一阶段失败都静默吞掉，不向调用方返回 Promise
+     *
+     * 这里刻意不再套 `setImmediate`：`GalileoService.logInfo / logError` 只执行本地
+     * BatchProcessor 入队，网络导出本来就是异步的。额外延后一轮会让退出 flush 看不到
+     * 尚未入队的最后一批事件，造成尾部少报。
+     */
+    private _emit;
+    /**
+     * 从统一字段清单提取最终关联 ID。这里不读取 SessionManager：事件可能在异步
+     * callback 中结算，必须使用调用方在事件入口固化的快照，避免多 Session 串值。
+     */
+    private _pickCorrelationAttributes;
+    /** 诊断日志独立测试缝；生产把 telemetry 自身的 warn 延后，避免影响调用栈。 */
+    protected _scheduleTelemetry(task: () => void): void;
+    /**
+     * 构造伽利略 attributes：把 status / module 升格为 attribute、剔除 undefined / null value。
+     *
+     * `module='sandbox'` 是所有沙箱事件共享的一等切片维度——伽利略后台直接用
+     * `{tags.module="sandbox"}` 一键聚合所有沙箱事件，不必走 `message =~ "sandbox\\..*"`
+     * 正则。注入点放在 _buildAttributes 这一公共出口，所有最终调用 `_emit` 的 reporter
+     * 方法全部命中，调用方零感知；`ingestRawEvent` 当前只丢弃原始 envelope，不经过这里。
+     */
+    private _buildAttributes;
+    /**
+     * 截断 errorMsg 到 1KB 字节长度上限。
+     *
+     * UTF-8 字节长度计数（避免中文等多字节字符在边界处被截成乱码）。
+     * 截断时 `logger.warn` 一次（不输出原文，避免日志爆量）。
+     */
+    private _truncateMessage;
+    private _truncateField;
+    private _warnSafely;
+    /**
+     * UTF-8 安全截断：按字节数截但不切断多字节字符。
+     *
+     * 实现：先按 `maxBytes` 切 Buffer，然后用 `TextDecoder('utf-8', { fatal: false })`
+     * 解码并丢弃尾部 `\uFFFD` 替换字符。
+     */
+    private _truncateUtf8;
+}
+/**
+ * errorMsg 字段字节上限（跨事件统一）。
+ */
+export declare const ERROR_MESSAGE_MAX_BYTES = 1024;
+/** 解码文件拦截 actionMask（导出供 reporter 内部和单测使用）。 */
+export declare function decodeFileActionMask(mask: number): string;
+/** 解码网络拦截 actionMask（导出供 reporter 内部和单测使用）。 */
+export declare function decodeNetworkActionMask(mask: number): string;
+/**
+ * 由命令终局 `(outcome, reason)` 派生伽利略 severity 状态。
+ *
+ * - `deny` 且 `reason` ∈ 策略硬拦（`forbidden` / `system-tool-blocked`）→ `failed`
+ *   （logError，留作安全审计告警入口：有人在跑被禁命令）
+ * - `deny` 其余（**用户主动拒绝**：`user-denied` / `bypass-user-denied` /
+ *   `sensitive-denied` / `system-tool-rejected` / `command-safety-ask-denied`）→
+ *   `success`（logInfo）——拒绝是正常用户行为，不该灌进告警流
+ * - `allow` / `prompt-allow` / `error` / `dispatched` → `success`（logInfo）；
+ *   `error`（命令自挂/异常）、`dispatched`（后台未裁决）同样刻意不进错误流
+ *
+ * 注意：`status` 只承载日志级别（severity），不承载放通/拒绝语义——放通率、拒绝率
+ * 一律按 `tags.outcome` 统计，不依赖 `status`。
+ */
+export declare function outcomeToStatus(outcome: SandboxToolCallOutcome, reason?: string): SandboxStatus;
+/**
+ * 由威胁库加载结果派生伽利略 severity 状态。
+ *
+ * 只有 `sync-failed` 进 `failed`/logError 告警通道——那是「DB 已经在本地、却没能
+ * 加载进 sandbox-cli」，属真实故障。其余不生效原因是预期状态，进 logInfo：
+ *
+ * - `no-db-path`：daemon 还没发布首个 DB。新装用户必然先经历这段窗口，按失败上报
+ *   会让告警通道被开箱即用的正常样本淹没，真实加载故障反而看不出来。
+ * - `lifecycle-unavailable`：沙箱未启用或生命周期缺失。用户关掉沙箱是正常配置，
+ *   且本轮沙箱覆盖率由 `sandbox.turn_sandbox_cli_usage.recorded` 回答，不靠本事件。
+ * - `disabled`：用户主动关闭了恶意域名拦截。
+ * - `protocol-unsupported`：当前 sandbox-cli 版本不认这条命令。版本落后期间每一轮都会命中，
+ *   按失败上报等于用一个可预期的过渡态把告警通道占满。这类样本按 `tags.reason` 单独看即可。
+ *
+ * 与 {@link outcomeToStatus} 同理：`status` 只承载日志级别，防护是否生效一律按
+ * `tags.available` 与 `tags.reason` 统计，不依赖 `status`。
+ */
+export declare function threatDatabaseLoadToStatus(available: boolean, reason?: SandboxThreatDatabaseUnavailableReason): SandboxStatus;
+/**
+ * 由 fileBlock / networkBlock 数量判定 interceptType。
+ *
+ * - 两类都非空 → 'mixed'
+ * - 仅 fileBlock → 'file'
+ * - 仅 networkBlock → 'network'
+ * - 均无 → 'none'
+ */
+export declare function deriveInterceptType(result: SandboxExecResultLike): SandboxInterceptType;

package/cli/dist-server/types/node/telemetry/startup-profiler.d.ts

@@ -0,0 +1,32 @@
+import { StartupPhase, StartupProfiler, StartupProfileReport } from './startup-profiler-protocol';
+declare global {
+    var __CODEBUDDY_PROCESS_START_TIME__: number | undefined;
+}
+export declare class StartupProfilerImpl implements StartupProfiler {
+    private phases;
+    private phaseOrder;
+    private enabled;
+    private uiReadyTime;
+    constructor();
+    init(): void;
+    isEnabled(): boolean;
+    markStart(phase: StartupPhase | string, label?: string, metadata?: Record<string, unknown>): void;
+    markEnd(phase: StartupPhase | string, metadata?: Record<string, unknown>): void;
+    markEvent(phase: StartupPhase | string, label?: string, metadata?: Record<string, unknown>): void;
+    markUIReady(): void;
+    getUIReadyTime(): number | undefined;
+    measure<T>(phase: StartupPhase | string, label: string, fn: () => Promise<T>): Promise<T>;
+    getTotalDuration(): number;
+    getReport(): StartupProfileReport;
+    formatReport(options?: {
+        showAll?: boolean;
+        threshold?: number;
+    }): string;
+    private formatDuration;
+    private createProgressBar;
+    private getPhaseLabel;
+}
+/**
+ * 获取进程启动时间（用于在模块加载阶段记录）
+ */
+export declare function getProcessStartTime(): number;

package/cli/dist-server/types/node/telemetry/status-reporter.d.ts

@@ -0,0 +1,39 @@
+import { Application, ApplicationLifecycle, IntervalTimer } from '@celljs/core';
+import { AuthenticationManager } from '../../workspace/authentication/lib/common/index.js';
+import { ProductManager } from '../../workspace/product/lib/common/index.js';
+import { EventService, Logger, PluginStatusTelemetry } from '../../workspace/telemetry/lib/common/index.js';
+import { type IPrewarmStateService } from '../prewarm/prewarm-protocol';
+interface PluginStatusDailyState {
+    version: 1;
+    reports: Record<string, string>;
+}
+export declare class PluginStatusServiceImpl implements ApplicationLifecycle<Application> {
+    protected readonly productManager: ProductManager;
+    protected readonly logger: Logger;
+    protected readonly eventService: EventService;
+    protected readonly authenticationManager: AuthenticationManager;
+    protected readonly prewarmState: IPrewarmStateService;
+    protected readonly timer: IntervalTimer;
+    protected pluginStartReportPending: boolean;
+    protected readonly checkInterval: number;
+    private stopped;
+    private activationDeferred;
+    private cancelAuthWait?;
+    initialize(): void;
+    protected init(): void;
+    protected doInit(): void;
+    onStop(): void;
+    protected startPeriodicChecking(): Promise<void>;
+    protected reportPluginStatusOnStart(): void;
+    protected doReportPluginStatusOnStart(): Promise<void>;
+    protected waitAuthReadyForPluginStart(): Promise<void>;
+    protected delay(ms: number): Promise<void>;
+    protected checkAndReportDaily(): Promise<void>;
+    protected reportOncePerAccountPerDay(payload: PluginStatusTelemetry): Promise<boolean>;
+    protected getAccountUid(): string | undefined;
+    protected getLocalDateKey(date?: Date): string;
+    protected getDailyReportStatePath(): string;
+    protected readDailyReportState(): Promise<PluginStatusDailyState>;
+    protected writeDailyReportState(state: PluginStatusDailyState): Promise<void>;
+}
+export {};

package/cli/dist-server/types/node/telemetry/telemetry-client-carrier.d.ts

@@ -0,0 +1,14 @@
+import { type Session } from '../../vendor/cbc-core/node/index.js';
+/**
+ * 把发起本次请求的客户端遥测信息（`session.telemetryClientInfo`）作为临时载体字段
+ * 塞进 event payload，供 {@link TelemetryClientInfoEventProcessor} 在 processor 阶段展开成
+ * 正式公共字段后删除（对齐 `fileUri` → `VCSEventProcessor` 的临时载体范式）。
+ *
+ * - 无session 或 session 未携带客户端信息（普通 CLI）→ 原样返回 payload，processor 走进程级兜底。
+ * - **就地写入并返回同一对象**：调用点 `report(code, attachTelemetryClientCarrier(payload, session))`
+ *   即可，不改变原有 report 调用形态（await / options / 是否 modelEventService 均不受影响）。
+ *
+ * 供`TelemetryServiceImpl` 及包外上报点（friction / credit-refund / mcp 等持有 session 者）复用，
+ * 避免每处重复拼载体。
+ */
+export declare function attachTelemetryClientCarrier<T extends object>(payload: T, session: Session | undefined): T;

package/cli/dist-server/types/node/telemetry/telemetry-client-info-event-processor.d.ts

@@ -0,0 +1,8 @@
+import { EventProcessContext, EventProcessor } from '../../workspace/telemetry/lib/common/index.js';
+/**
+ * processor 顺序不保证；客户端值有值即覆盖，进程级 processor 只兜底空值。
+ * 载体是内部字段，用后删除，避免泄漏进最终上报 payload。
+ */
+export declare class TelemetryClientInfoEventProcessor implements EventProcessor {
+    process({ event }: EventProcessContext): Promise<void>;
+}

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

@@ -0,0 +1,137 @@
+import type { ToolCallLoopEventKind, ToolCallLoopEvidence } from '../../vendor/cbc-core/node/index.js';
+import { ModelCallGeneration, ModelResponseMetadata, Session } from '../../vendor/cbc-core/node/index.js';
+import { RunResult, StreamedRunResult } from '../../vendor/cbc-shared/node/index.js';
+import { ChatMessageSendTelemetry } from '../../workspace/telemetry/lib/common/event/types/craft.js';
+export declare const TelemetryService: unique symbol;
+export type UserTaskFailedCreditRefundReason = 'loop_detected' | 'abnormal_finish_reason';
+export interface TelemetryService {
+    /**
+     * 记录当前 rootRequestId 下出现过的 conversationRequestId，用于失败退费逐条上报。
+     */
+    recordCreditRefundConversationRequest(session: Session): void;
+    /**
+     * 记录当前 conversationRequestId 的模型 finish_reason，用于过滤未进入 Tool Calls 的请求。
+     */
+    recordCreditRefundConversationRequestEnd(session: Session, finishReason: string | undefined): void;
+    /**
+     * 标记当前 conversationRequestId 不参与退费上报。
+     */
+    suppressCreditRefundConversationRequest(session: Session): void;
+    /**
+     * 上报用户任务失败退费检测事件；触发后消费当前 rootRequestId 的累积 request 列表。
+     */
+    reportUserTaskFailedCreditRefund(session: Session, reason: UserTaskFailedCreditRefundReason): Promise<void>;
+    /**
+     * 上报工具调用循环观测事件：弹窗展示（suspected）、用户继续（continue）、
+     * 弹不出窗的自动继续（auto_continue）、用户停止（detected）。
+     * 只做观测，不影响退费；退费仍走 reportUserTaskFailedCreditRefund。
+     */
+    reportToolCallLoopEvent(kind: ToolCallLoopEventKind, session: Session, evidence: ToolCallLoopEvidence): Promise<void>;
+    /**
+     * 创建并发送消息发送埋点
+     * @param headers 请求头
+     * @param body 请求体
+     * @param isStream 是否为流式请求
+     * @param session Session the model call belongs to; defaults to the current one
+     * @returns 发送埋点数据
+     */
+    reportMessageSendTelemetry(headers: Record<string, string>, body: any, isStream: boolean, session?: Session): ChatMessageSendTelemetry & {
+        sendTime: number;
+        isStream: boolean;
+    };
+    /**
+     * 发送非流式消息响应埋点
+     * @param session 会话对象
+     * @param sendTelemetry 发送埋点数据
+     * @param axiosResponse 响应对象（用于从 data.usage 提取 token）
+     * @param isSuccessful 是否成功
+     * @param error 错误信息（可选）
+     */
+    reportMessageResponseTelemetryNonStream(session: Session, sendTelemetry: ChatMessageSendTelemetry & {
+        sendTime: number;
+        isStream: boolean;
+    }, axiosResponse: any, isSuccessful: boolean, error?: any): Promise<void>;
+    /**
+     * 发送聊天请求埋点
+     * @param session 会话对象
+     */
+    reportChatRequestSendTelemetry(session: Session): Promise<void>;
+    /**
+     * 上报等待模型 X-Request-ID 的增长埋点。
+     * @param session 会话对象
+     * @param requestId 实际 /v2/chat/completions 请求头 X-Request-ID
+     */
+    flushPendingGrowthTelemetry(session: Session, requestId: string): Promise<void>;
+    /**
+     * 发送请求响应埋点
+     * @param session 会话对象
+     * @param result 运行结果
+     * @param isSuccessful 是否成功
+     * @param error 错误信息（可选）
+     * @param modelResponseMetadata 模型响应元数据（可选）
+     */
+    reportChatRequestResponseTelemetry(session: Session, result?: RunResult<any, any> | StreamedRunResult<any, any> | undefined, isSuccessful?: boolean, error?: any, modelResponseMetadata?: ModelResponseMetadata): Promise<void>;
+    /**
+     * 上报流式请求的消息响应埋点
+     * @param session 会话对象
+     */
+    reportMessageResponseTelemetryStream(session: Session, usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+        requests?: number | undefined;
+        inputTokensDetails?: Record<string, number> | undefined;
+        outputTokensDetails?: Record<string, number> | undefined;
+    }, modelResponseMetadata?: ModelResponseMetadata, error?: any): Promise<void>;
+    /**
+     * 上报模型工具调用埋点
+     * @param session 会话对象
+     * @param functionCallResultItem 工具调用结果项
+     */
+    reportModelToolCall(session: Session, functionCallResultItem: any): Promise<void>;
+    /**
+     * 上报手动工具调用埋点
+     * @param session 会话对象
+     * @param toolCallItem 工具调用项
+     * @param toolCallSuccessful 调用是否成功
+     * @param toolStatus 工具状态
+     * @param toolErrorCode 错误代码
+     */
+    reportManualToolCall(session: Session, toolCallItem: any, toolCallSuccessful: boolean, toolStatus: string, toolErrorCode: unknown): Promise<void>;
+    /**
+     * 上报聊天文件操作埋点
+     * @param session 会话对象
+     * @param fileActionData 文件操作数据
+     */
+    reportChatFileAction(session: Session, fileActionData: {
+        languageId: string;
+        isNewFile: boolean;
+        addLineCount: number;
+        removedLines: number;
+        addCharCount: number;
+        deleteCharCount: number;
+    }): Promise<void>;
+    /**
+     * 上报消息状态埋点（成功或失败）
+     * @param session 会话对象
+     * @param messageErrorCode 错误代码，成功时为 '0'
+     * @param generation 该状态所属的那次模型调用，与同一调用的 chat_message_send / response 同 id
+     */
+    reportChatMessageStatus(session: Session, messageErrorCode: string, generation: ModelCallGeneration, error?: unknown): Promise<void>;
+    /**
+     * 上报达到最大 Token 限制埋点
+     * @param session 会话对象
+     * @param responseModelId 响应模型 ID（可选）
+     */
+    reportChatMaxTokenReached(session: Session, responseModelId?: string): Promise<void>;
+    /**
+     * 上报代码编辑统计埋点
+     * @param languageId 语言 ID
+     * @param fileCount 变更文件数
+     * @param lineCount 变更行数
+     * @param characterCount 变更字符数
+     * @param traceId 关联 trace（仅在有 session 上下文时透传）
+     * @param session 发起本次请求的 session，用于按客户端来源端归属公共字段
+     */
+    reportCodeEdit(languageId: string, fileCount: number, lineCount: number, characterCount: number, traceId?: string, session?: Session): Promise<void>;
+}