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

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

@@ -0,0 +1,13 @@
+import { ClientInfoProvider } from '../../workspace/product/lib/common/index.js';
+import { EventProcessContext, EventProcessor } from '../../workspace/telemetry/lib/common/index.js';
+/**
+ * 扩展插件相关信息
+ */
+export declare class ExtensionInfoEventProcessor implements EventProcessor {
+    protected clientInfoProvider: ClientInfoProvider;
+    process({ event }: EventProcessContext): Promise<void>;
+}
+export declare class ExtensionInfoModelEventProcessor implements EventProcessor {
+    protected clientInfoProvider: ClientInfoProvider;
+    process({ event }: EventProcessContext): Promise<void>;
+}

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

@@ -0,0 +1,54 @@
+import { ProductManager } from '../../workspace/product/lib/common/index.js';
+import { EventService, Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { ChatRequestSendTelemetry } from '../../workspace/telemetry/lib/common/event/types/craft.js';
+import { Session } from '../../vendor/cbc-core/node/index.js';
+import { FrictionRecallClient } from './friction-recall-client';
+export declare const FrictionAnalysisService: unique symbol;
+export declare const CHAT_PROMPT_FRICTION_ANALYSIS_EVENT = "chat_prompt_friction_analysis";
+export type FrictionSeverity = 'high' | 'medium' | 'low';
+export type FrictionType = 'error_tool_failure' | 'performance_friction' | 'repeated_rephrasing' | 'escalation_tone' | 'platform_confusion' | 'abandoned_tool_flow' | 'backtracking_revert' | 'context_churn' | 'quality_disappointment' | 'trust_degradation' | 'communication_mismatch' | 'specification_drift' | 'unexpected_side_effect' | 'data_loss_risk' | 'no_progress_looping' | 'unclear_status' | 'safety_privacy_concern' | 'approval_fatigue' | 'insufficient_evidence';
+export type FrictionRootCauseCandidate = 'tool_reliability' | 'model_runtime' | 'product_ux' | 'latency' | 'model_understanding' | 'context_retrieval' | 'output_quality' | 'permission_or_policy' | 'workflow_orchestration' | 'specification_drift' | 'user_requirement_ambiguity' | 'communication_mismatch';
+export interface FrictionAnalysisService {
+    capturePrompt(session: Session, userPrompt: string): void;
+    tryReportOnRequestSend(session: Session, requestTelemetry: ChatRequestSendTelemetry): void;
+}
+export interface FrictionAnalysisResult {
+    frictionType: FrictionType;
+    severity: FrictionSeverity;
+    evidenceText: string;
+    rootCauseCandidate: FrictionRootCauseCandidate;
+}
+export interface ChatPromptFrictionAnalysisTelemetry {
+    conversationId: string;
+    requestId: string;
+    requestModelId: string;
+    requestModelName: string;
+    presentAt: number;
+    userPrompt: string;
+    linkedPreviousRequestId?: string;
+    frictionType: FrictionType;
+    severity: FrictionSeverity;
+    evidenceText: string;
+    linkedExecutionSignal?: string;
+    rootCauseCandidate: FrictionRootCauseCandidate;
+}
+export declare function extractVisibleUserPromptFromAcpPrompt(prompt: unknown): string;
+export declare function extractVisibleUserPromptFromAgentInput(input: unknown): string;
+export declare function buildFrictionTelemetryPayload(session: Session, requestTelemetry: ChatRequestSendTelemetry, userPrompt: string, result: FrictionAnalysisResult, linkedPreviousRequestId?: string, linkedExecutionSignal?: string): ChatPromptFrictionAnalysisTelemetry;
+export declare class FrictionAnalysisServiceImpl implements FrictionAnalysisService {
+    protected readonly eventService: EventService;
+    protected readonly logger: Logger;
+    protected readonly frictionRecallClient: FrictionRecallClient;
+    protected readonly productManager: ProductManager;
+    private readonly pendingPromptBySession;
+    private readonly pendingAnalysisByRequest;
+    private readonly reportedKeys;
+    capturePrompt(session: Session, userPrompt: string): void;
+    tryReportOnRequestSend(session: Session, requestTelemetry: ChatRequestSendTelemetry): void;
+    private flushPending;
+    private isFeatureEnabledForReport;
+    private getRequestKey;
+    private extractLinkedPreviousRequestId;
+    private findRequestId;
+    private extractLinkedExecutionSignal;
+}

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

@@ -0,0 +1,15 @@
+import { RestOperations } from '@celljs/http';
+import { ProductManager } from '../../workspace/product/lib/common/index.js';
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import type { FrictionAnalysisResult } from './friction-analysis';
+export declare const FrictionRecallClient: unique symbol;
+export interface FrictionRecallClient {
+    recall(userPrompt: string): Promise<FrictionAnalysisResult | undefined>;
+}
+export declare function parseFrictionRecallResponse(payload: unknown): FrictionAnalysisResult | undefined;
+export declare class FrictionRecallClientImpl implements FrictionRecallClient {
+    protected readonly restOperations: RestOperations;
+    protected readonly productManager: ProductManager;
+    protected readonly logger: Logger;
+    recall(userPrompt: string): Promise<FrictionAnalysisResult | undefined>;
+}

package/cli/dist-server/types/node/telemetry/host-ide-info-processor.d.ts

@@ -0,0 +1,11 @@
+import { ClientInfoProvider } from '../../workspace/product/lib/common/index.js';
+import { EventProcessContext, EventProcessor } from '../../workspace/telemetry/lib/common/index.js';
+/**
+ * 宿主 IDE 相关信息
+ */
+export declare class HostIDEInfoEventProcessor implements EventProcessor {
+    protected clientInfoProvider: ClientInfoProvider;
+    process({ event }: EventProcessContext): Promise<void>;
+    private ensureLocalCliFeatureModule;
+    private isCliIdentity;
+}

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

@@ -0,0 +1,21 @@
+export * from './startup-profiler-protocol';
+export * from './cost-protocol';
+export * from './telemetry-protocol';
+export * from './plugin-telemetry-protocol';
+export * from './sandbox-telemetry-protocol';
+export * from './startup-profiler';
+export * from './cost-service';
+export * from './logger';
+export * from './status-reporter';
+export * from './friction-recall-client';
+export * from './friction-analysis';
+export * from './telemetry-service';
+export * from './plugin-telemetry-service';
+export * from './host-ide-info-processor';
+export * from './extension-info-processor';
+export * from './telemetry-client-info-event-processor';
+export * from './telemetry-client-carrier';
+export * from './turn-baggage-processor';
+export * from './vcs-event-processor';
+export * from './qimei-env-detector';
+export * from './sandbox-telemetry-service';

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

@@ -0,0 +1 @@
+export * from './storage-path-provider';

package/cli/dist-server/types/node/telemetry/logger/storage-path-provider.d.ts

@@ -0,0 +1,4 @@
+import { LoggerStoragePathProvider } from '../../../workspace/telemetry/lib/common/index.js';
+export declare class LoggerStoragePathProviderImpl implements LoggerStoragePathProvider {
+    provide(): string;
+}

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

@@ -0,0 +1,68 @@
+import { Marketplace, MarketplaceType, PluginInfo, PluginInstallScope } from '../../workspace/cbc-plugins/lib/node/index.js';
+/**
+ * 插件市场埋点服务
+ * 负责上报插件市场相关的埋点事件
+ */
+export declare const PluginTelemetryService: unique symbol;
+export interface PluginTelemetryService {
+    /**
+     * 上报市场操作事件 (plugin_marketplace_action)
+     * 用户添加/删除/刷新市场时调用
+     */
+    reportMarketplaceAction(data: MarketplaceActionData): void;
+    /**
+     * 上报市场页面曝光事件 (plugin_marketplace_page_show)
+     * 用户进入插件市场页面时调用
+     */
+    reportMarketplacePageShow(data: MarketplacePageShowData): void;
+    /**
+     * 上报插件操作事件 (plugin_action)
+     * 用户安装/卸载/启用/禁用插件时调用
+     */
+    reportPluginAction(data: PluginActionData): void;
+}
+/**
+ * 市场操作埋点数据
+ */
+export interface MarketplaceActionData {
+    /** 市场信息（操作失败时可能为 undefined） */
+    marketplace?: Marketplace;
+    /** 市场名称（操作失败时如果没有 marketplace 则使用此字段） */
+    marketplaceName?: string;
+    /** 市场来源（操作失败时如果没有 marketplace 则使用此字段） */
+    marketplaceSource?: string;
+    /** 市场类型（操作失败时如果没有 marketplace 则使用此字段） */
+    marketplaceType?: MarketplaceType;
+    /** 用户操作 */
+    action: 'add' | 'remove' | 'refresh';
+    /** 操作是否成功 */
+    actionSuccessful: boolean;
+    /** 错误代码（操作失败时） */
+    errorCode?: string;
+    /** 错误信息（操作失败时） */
+    errorMessage?: string;
+}
+/**
+ * 市场页面曝光埋点数据
+ */
+export interface MarketplacePageShowData {
+    /** 当前选中的市场名称 */
+    marketplaceName?: string;
+    /** 可用市场总数 */
+    marketplaceCount: number;
+    /** 已安装插件总数 */
+    installedPluginCount: number;
+}
+/**
+ * 插件操作埋点数据
+ */
+export interface PluginActionData {
+    /** 插件信息 */
+    plugin: PluginInfo;
+    /** 所属市场 */
+    marketplace: Marketplace;
+    /** 用户操作 */
+    action: 'install' | 'uninstall' | 'enable' | 'disable' | 'update';
+    /** 安装作用域 */
+    scope: PluginInstallScope;
+}

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

@@ -0,0 +1,31 @@
+import { EventService, Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { MarketplaceActionData, MarketplacePageShowData, PluginActionData, PluginTelemetryService } from './plugin-telemetry-protocol';
+export declare class PluginTelemetryServiceImpl implements PluginTelemetryService {
+    protected readonly eventService: EventService;
+    protected readonly logger: Logger;
+    reportMarketplaceAction(data: MarketplaceActionData): void;
+    reportMarketplacePageShow(data: MarketplacePageShowData): void;
+    reportPluginAction(data: PluginActionData): void;
+    /**
+     * 获取市场来源字符串
+     */
+    private getMarketplaceSource;
+    /**
+     * 映射市场类型到埋点定义的类型
+     * directory -> local
+     * github/git/url -> github
+     */
+    private mapMarketplaceType;
+    /**
+     * 映射安装作用域到埋点定义的类型
+     */
+    private mapScope;
+    /**
+     * 获取插件能力标志
+     */
+    private getPluginCapabilities;
+    /**
+     * 判断能力是否存在
+     */
+    private hasCapability;
+}

package/cli/dist-server/types/node/telemetry/qimei-env-detector.d.ts

@@ -0,0 +1,16 @@
+import { Logger } from '@celljs/core';
+import { QimeiDetector } from '../../workspace/telemetry/lib/common/index.js';
+/**
+ * agent-cli 侧 QIMEI36 探测器。
+ *
+ * WorkBuddy Desktop/app-server 负责 native SDK 探测，agent-cli 子进程只从环境变量
+ * 动态读取已探测到的值，避免在 CLI 进程里再次加载 native SDK。
+ */
+export declare class EnvQimeiDetector implements QimeiDetector {
+    protected readonly logger: Logger;
+    /** env 缺失只 warn 一次，避免每次遥测上报都刷日志。 */
+    private missingWarned;
+    getSync(): string | undefined;
+    getAsync(): Promise<string | undefined>;
+    protected readEnv(): string | undefined;
+}

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;