@tencent-ai/agent-sdk 0.3.263-dev.90f0e98.202609190050 → 0.3.263

package/cli/dist-server/types/node/tools/repl/repl-sandbox-result.d.ts

@@ -1,111 +0,0 @@
-/**
- * Unwrap human-formatted tool `content` into a value the REPL sandbox can use
- * as data. Direct LLM tool results stay as display text; only this boundary
- * (broker.callTool → worker) should reshape them.
- *
- * The live failure this exists for: models write `const r = await Bash(...)`
- * then read `r.stdout`, get undefined, and burn turns writing a regex parser
- * for `Command:` / `Stdout:` / `Stderr:` blocks (and for Read's `   1→` prefix).
- */
-import type { BridgeImage } from './repl-protocol';
-export interface SandboxShellResult {
-    stdout: string;
-    stderr: string;
-    exitCode: number | null;
-    signal: string | null;
-}
-/** 骨架目录里写在 `Name(params)` 后面的返回值，不被 SUMMARY_MAX_CHARS 截断。 */
-export declare function sandboxReturnAnnotation(toolName: string): string | undefined;
-export declare function toSandboxToolResult(toolName: string, toolResult: {
-    content?: unknown;
-    rawResponse?: unknown;
-    renderer?: {
-        type?: string;
-        value?: unknown;
-    };
-}): unknown;
-/**
- * Broker → worker 的回包。TaskOutput 在「任务不存在」时仍带 `error`，
- * 但不能因此丢掉 `status`：worker 对非 Agent 错误原样 `{ error }`，
- * 模型会写 `r.status || "done"` 把 unknown 当成完成。
- */
-export declare function sandboxToolCallReply(toolName: string, toolResult: {
-    content?: unknown;
-    error?: string;
-    rawResponse?: unknown;
-    renderer?: {
-        type?: string;
-        value?: unknown;
-    };
-}): {
-    result?: unknown;
-    error?: string;
-};
-/** Read 图的 content：`[{ type:"image_url", image_url:{ url:"data:image/..." } }]`。 */
-export declare function parseImageToolContent(content: string): unknown | undefined;
-export declare function splitCellImages(value: unknown): {
-    result: unknown;
-    images: BridgeImage[];
-};
-/**
- * 人读的执行详情文本，供工具结果行的 renderer 展示（可折叠、ctrl+o 展开）。
- *
- * 与 {@link buildReplToolContent} 分工明确：后者产出**模型面**的结构化 JSON
- * （`{ result, stdout, stderr }`，供沙箱/模型索引），这里产出**人面**的纯文本。
- * 优先级：error > 返回值 > stdout，末尾附 stderr。图片一律脱敏/剔除（base64 不进
- * 展示文本，图片走 content 数组的 image_url 单独渲染）。无任何输出时返回空串，
- * 由调用方决定占位（如只显示耗时）。
- */
-export declare function buildReplDisplayText(out: {
-    result?: unknown;
-    stdout: string;
-    stderr: string;
-    error?: string;
-}): string;
-/**
- * 把 REPL 返回值压成文本，供模型面截断判定与落盘复用。
- *
- * - string 原样返回；
- * - 其余（多为结构化 JSON）压成**紧凑**序列化文本——模型面要控制 token，
- *   与 `buildReplDisplayText` 的 pretty JSON（人面）刻意不同。
- * - JSON.stringify 失败（如 cyclic）时退化为 String(result)。
- *
- * 截断只发生在主线程的模型面组装（buildReplToolContent）；沙箱内模型代码拿到的
- * 仍是完整返回值，人面展示也走完整 result，互不影响。
- */
-export declare function replResultToText(result: unknown): string;
-/**
- * REPL 出参。有图则走 read-tool 同款 image_url 数组，避免把 base64 再塞进 result 文本。
- */
-export declare function buildReplToolContent(out: {
-    result?: unknown;
-    stdout: string;
-    stderr: string;
-    error?: string;
-    images: BridgeImage[];
-}): string;
-export declare function parseShellFormatted(content: string, rawResponse?: unknown): SandboxShellResult | undefined;
-export declare function stripReadLineNumbers(content: string): string;
-export interface SandboxAgentSpawnResult {
-    taskId: string;
-    id: string;
-    name?: string;
-    agentId?: string;
-}
-/** Background Agent() returns labeled text to the LLM; sandbox wants `r.taskId`. */
-export declare function parseAgentSpawn(content: string): SandboxAgentSpawnResult | undefined;
-export interface SandboxTaskOutputResult {
-    status: string;
-    taskId?: string;
-    content: string;
-    result?: unknown;
-    error?: string;
-}
-/**
- * TaskOutput 对人读是 `Status: running` 文本；沙箱要的是 `r.status`。
- * 缺这个字段时模型会写 `r.status || "done"`，把还在跑的 teammate 当成完成。
- */
-export declare function parseTaskOutput(content: string, renderer?: {
-    type?: string;
-    value?: unknown;
-}): SandboxTaskOutputResult;

package/cli/dist-server/types/node/tools/repl/repl-tool.d.ts

@@ -1,128 +0,0 @@
-/**
- * REPLTool —— 模型面唯一入口:写 JS、import WorkBuddy 桥来编排。
- *
- * 见 docs/repl-code-mode/architecture.md。
- * - 暴露面:1 个工具;能力经 `await import("@wb/...")` 桥,不做直连工具、暂不给 tools.*。
- * - 执行委托 REPLWorkerManager(每 session 常驻 kernel = cell,状态跨调用存活)。
- * - 高权限:能触达桥,needsApproval=true;必须投影 code 给 auto 分类器(否则静默放行)。
- * - feature-gate:CODEBUDDY_REPL_ENABLED。
- */
-import { Session, type SessionManager as ISessionManager } from '../../../vendor/cbc-core/node/index.js';
-import { type FunctionCallItem, ToolArg, ToolNames } from '../../../vendor/cbc-shared/node/index.js';
-import { Logger } from '@genie/telemetry';
-import type { RunContext } from '@openai/agents';
-import { z } from 'zod';
-import { ToolResultBlobService } from '../../blob-store/tool-result-blob-service';
-import { BaseTool } from '../base-tool';
-import { type ShellStreamPusherService } from '../shell-stream-pusher';
-import { Tool, ToolCallArgumentRenderer, ToolManager, ToolResult } from '../tool-protocol';
-import { ReplCatalogSource } from './repl-catalog-protocol';
-import { REPLWorkerManager } from './repl-protocol';
-/**
- * 入参形状。运行时 schema 由 `parameters()` 动态生成（要把骨架目录拼进 code 描述），
- * 这里只声明 `execute` 的入参类型——两处字段必须保持一致。
- */
-interface ReplToolInput {
-    code: string;
-    timeout?: number;
-    description?: string;
-}
-export declare class REPLTool extends BaseTool implements Tool {
-    protected readonly logger: Logger;
-    protected readonly shellStreamPusher: ShellStreamPusherService;
-    protected readonly workers: REPLWorkerManager;
-    protected readonly catalogSource: ReplCatalogSource;
-    protected readonly sessionManager?: ISessionManager;
-    protected readonly toolManager?: ToolManager;
-    protected readonly toolResultBlobService?: ToolResultBlobService;
-    name: ToolNames;
-    readonly promptCacheStability: 'volatile';
-    description: string;
-    /**
-     * 动态 schema：把骨架目录注入 `code` 参数描述，让模型写 code 前就知道有哪些工具
-     * 及其参数形状（一次写对、不盲写）。ToolManager.get() 在 parameters 是函数时会
-     * 调用它并转成 JSON Schema，且把正在构建的 agent 传进来。
-     *
-     * **异常必须自吞**：ToolManager 对 parameters() 抛错的兜底是把 parameters 置为
-     * undefined，那对 REPL 是灾难（没有 code 参数就完全不可用）。所以采集失败一律
-     * 降级为"无目录但可用"。
-     */
-    parameters: (agentConfig?: {
-        name?: string;
-    }) => Promise<z.ZodTypeAny>;
-    argumentRenderer: ToolCallArgumentRenderer;
-    isEnabled: (args?: unknown) => Promise<boolean>;
-    /** 必须 override:REPL 能跑桥(含高权限),auto 模式不能静默放行。投影 code 给分类器。 */
-    toAutoClassifierInput(input: unknown): string;
-    resolveNeedPermissionArgs(_rc: RunContext, input: unknown): ToolArg[];
-    execute(input: ReplToolInput, context?: RunContext<Session>, details?: {
-        toolCall: FunctionCallItem;
-    }): Promise<ToolResult>;
-    /**
-     * details.toolCall.callId 缺失时（部分非交互路径），从 session.history 倒序反查本次 REPL
-     * function_call 的 callId——对齐 bash 的 findCallId。拿到与 UI 侧 function_call_group 一致
-     * 的 callId，流式进度帧才能就地并入同一条工具结果，而不是在对话流里堆积孤立行（issue #101579）。
-     * 用 code 精确匹配，避免命中同一会话里更早的 REPL 调用。
-     */
-    private findReplCallId;
-    /**
-     * 推一条聚合流式进度到 UI（复用 bash 的 `function_call_result` + `isStreaming` 模式，
-     * 不新增 sessionUpdate 类型）。用外层 REPL tool-call 的 callId + 固定 resultId，
-     * use-message-groups 据此就地更新同一条 in_progress 结果；运行时长由固定 startedAt
-     * 算，单调递增，天然取代内部子工具那种各自从 0 反复重置的孤立条目。
-     */
-    private emitStreaming;
-    /**
-     * 渲染骨架目录。**必须自吞全部异常并返回空串**——见 parameters 的注释。
-     *
-     * 总闸 `CODEBUDDY_REPL_ENABLED` 关闭时直接短路。`isEnabled` 只把工具从 LLM tools
-     * 列表里剔除，管不到这里：`parameters` 是动态函数，ToolManager 构建 agent tools 时
-     * **无条件** `await tool.parameters()`（tool-manager.ts:396-404）。不短路的话，总闸
-     * 关着也会为一个永不暴露给模型的工具跑一遍全量目录采集。
-     *
-     * 细闸 `CODEBUDDY_REPL_TOOLS_INJECT_CATALOG=0`（或 `false`）可单独关掉目录注入（工具仍
-     * 预加载，只是模型不提前知情，退化为纯渐进披露）。默认开启。
-     *
-     * 另有 `CODEBUDDY_REPL_TOOLS_INJECT_BUILTIN` 控制**内置工具**是否加载到 REPL
-     * （PTC/Minimal 默认开，其余模式默认关；`1`/`0` 强开强关）。控制点在
-     * ReplCatalogSource.collect（关闭时 catalog.builtin 为空，骨架目录与 sandbox
-     * 注入同时不含内置工具），不在本方法。
-     */
-    private renderSkeleton;
-    /**
-     * Code Mode 对齐标准模式的技能注入：标准模式的 `<available_skills>` 目录长在
-     * Skill 工具描述里；Code Mode 模型面只有 REPL、骨架每行摘要只截 80 字符，
-     * 目录会整体丢失。这里把 ToolManager 渲染的完整 Skill 描述（同一份字符预算 /
-     * skillOverrides 逻辑）附到 code 参数描述末尾，token 成本与标准模式等价。
-     *
-     * 与 catalog.collect 分开：骨架摘要每行只截 80 字符，技能列表会丢掉。
-     * 即使当前会话不是 Code Mode（正在 freeze ptc agent），只要
-     * specForReplParameters 认成 PTC/Minimal，也要把完整 Skill 描述打进去。
-     */
-    private renderSkillCatalogSection;
-    /** ACP 在 ALS 外 getCurrent 会抛；不能让整个 parameters() 失败。 */
-    private currentSessionSafe;
-    /**
-     * ToolManager ↔ REPL 循环依赖时 @Optional 注入会是 undefined。
-     * parameters() 在所有组件装配之后才跑，这时再懒取一次。
-     */
-    private resolveToolManager;
-    /**
-     * 完成态工具结果。
-     * - `content`：模型面结构化 JSON（`buildReplToolContent`，含 result/stdout/stderr[/images]）。
-     *   输出超阈值且已落盘时收敛为 `<persisted-output>` 占位符（2KB 预览 + 文件路径），
-     *   与 Bash 截断路径对齐——完整内容留在磁盘供 Read，避免跨轮重复发送全量结果。
-     * - `renderer.value`：人面展示。**不再显示 "ok"**——改为「耗时置顶 + 执行详情」：
-     *   耗时用 `formatTurnDuration`（"50s" / "1m 05s"，无 "ago"）置于首行且始终可见
-     *   （不被折叠吃掉）；执行详情（`buildReplDisplayText`）在下方，超 DEFAULT_DISPLAY_ROWS
-     *   自动折叠，`ctrl+o` 展开完整详情——与 bash 的结果行体验一致。
-     */
-    private toToolResult;
-    /**
-     * REPL 输出超阈值且完整内容已落盘时，把模型面 content 换成 `<persisted-output>` 占位符。
-     * 与 Bash buildForegroundResult 的 externalizeFromSpillFile 路径对齐；占位失败
-     * （service 缺失/异常）时保留截断文本兜底。
-     */
-    private externalizeReplOutput;
-}
-export {};

package/cli/dist-server/types/node/tools/repl/repl-worker-manager.d.ts

@@ -1,95 +0,0 @@
-/**
- * REPLWorkerManager 实现(checkpoint 2b:常驻 Bun worker,perf/错误隔离)。
- *
- * - 每个 session 一个常驻 worker = kernel,里面一个持久 vm.Context = cell,状态跨多次 run 存活。
- * - worker 只用 builtins(vm);acorn 的 import() 改写在主线程做好再发进去(见 repl-worker-source.ts 注释)。
- * - worker 的 __replImport / facade 通过 MessagePort 回主线程 → broker.resolve / broker.invoke。
- * - lifecycle:cell 超时/取消只结束这次 cell(abort 它在途的 bridge 调用让它 unwind),kernel 和状态都留着;
- *   只有 worker 崩溃/退出,或 hard abort(= reset),才销毁 worker、下次 run 重建。像 Jupyter / node_repl 的 kernel。
- *
- * 见 docs/repl-code-mode/architecture.md。
- */
-import { Session } from '../../../vendor/cbc-core/node/index.js';
-import { Logger } from '@genie/telemetry';
-import type { RunContext } from '@openai/agents';
-import { ToolResultBlobService } from '../../blob-store/tool-result-blob-service';
-import { ToolSearchService } from '../tool-search-protocol';
-import { ReplCatalogSource } from './repl-catalog-protocol';
-import { CellResult, REPLBridgeBroker, REPLRunOptions, REPLWorkerManager } from './repl-protocol';
-export declare class REPLWorkerManagerImpl implements REPLWorkerManager {
-    protected readonly logger: Logger;
-    protected readonly broker: REPLBridgeBroker;
-    protected readonly catalogSource: ReplCatalogSource;
-    protected readonly toolSearchService: ToolSearchService;
-    protected readonly toolResultBlobService?: ToolResultBlobService;
-    private readonly workers;
-    private callSeq;
-    run(context: RunContext<Session>, code: string, opts: REPLRunOptions): Promise<CellResult>;
-    /** 取消当前 cell:软取消(默认)结束这次 cell、保留 kernel;硬取消(hard=true)销毁 worker,下次 run 重建(= reset)。 */
-    abort(session: Session, _callId: string, hard?: boolean): void;
-    dispose(session: Session): Promise<void>;
-    /**
-     * 记一次 bridge 交互的起讫,驱动 idle 超时:发起 inflightBridges++,结算 --并刷新 lastBridgeActivity。
-     * 有在途调用(inflightBridges>0)idle 就续期,故 AskUserQuestion 等用户、长任务在途都不会被超时打断。
-     * active 用发起时捕获的引用——即便结算时 cell 已被换,写旧 active 也无副作用(其计数已无人读)。
-     */
-    private withBridgeActivity;
-    private ensureWorker;
-    /**
-     * 把当前工具集同步进 sandbox。
-     *
-     * 首次是全量 `init`；之后 epoch 变了才推 `toolsUpdate` 增量。cell 执行中到达的
-     * 变更排队到 `done` 之后（见 flushPendingTools）——否则模型 code 跑到一半时
-     * `const g = github` 脚下的对象会被换掉。
-     */
-    private syncTools;
-    /** cell 结束后补推排队的工具变更。 */
-    private flushPendingTools;
-    /**
-     * 推一次进度快照给本次 run 的 onProgress。
-     *
-     * 带 `callId` 校验：进度定时器/异步消息可能在 cell 已被 abandon（超时/取消）或换成
-     * 下一次 run 之后才触发，此时 entry.active 已是别的 cell 或 undefined，不能误推。
-     * 回调异常一律吞掉——UI 侧问题绝不能影响 cell 执行。
-     */
-    private emitProgress;
-    private postCatalog;
-    private onMessage;
-    /** 发现类 API 分流。只读，不过权限判定（把关的是可见性，见 §4.8）。 */
-    private dispatchReplApi;
-    /**
-     * done 的 async 收尾：只认当前 cell（被 abandon 的旧 cell 之后 unwind 发来的
-     * done，callId 不符直接丢，别误清新 cell 的 active）。
-     *
-     * 在 settle 前把 spill 文件收口（追加 result 文本 + 判定截断），这样上层拿到
-     * CellResult.persisted 时文件已完整可读。
-     */
-    private handleDone;
-    /** 执行期把完整 stdout/stderr 流式落盘（懒创建：无输出的 cell 不产生文件）。 */
-    private pushSpill;
-    /**
-     * 收尾本次 run 的 spill 文件：
-     * 1. 把完整 result 文本追加进文件（模型面只剩 head/tail 时，完整内容留给 Read）；
-     * 2. 关闭文件流；
-     * 3. 任一 buffer 截断且落盘成功 → 返回 persisted（上层把模型面收敛为占位符）；
-     *    未截断 / 落盘失败 → 删除临时文件，不产生垃圾。
-     *
-     * result 截断判定与 buildReplToolContent 的 truncateReplResult 同口径
-     * （replResultToText 文本超 MAX_SHELL_OUTPUT_LENGTH）。
-     */
-    private finalizeSpiller;
-    private createSpiller;
-    /** 中止/失败的 cell 不留落盘文件（内容不完整，Read 也没有意义）。 */
-    private cleanupSpiller;
-    /** cell 超时/软取消:让这次 cell 以错误结束,并 abort 它在途的 bridge 调用(cell 的 await 会抛错、自行 unwind);
-     *  worker(= kernel)保留,vm.Context 里的状态不丢——像 Jupyter / node_repl 那样。真卡死(CPU 打满)时靠 hard abort 重建。 */
-    private abandonCell;
-    /** 给 worker 发 abort 触发 unwind，并起 unwind 宽限；到期仍未 settle 就 terminate 重建。 */
-    private armAbandonGrace;
-    /** 清 unwind 宽限计时器（收到迟到 done / hard abort / 崩溃时调用；不动 abandonedCallId）。 */
-    private clearGrace;
-    /** 失败当前运行(崩溃/退出/dispose);active 的 promise 以错误态 settle，并清理 abandon 宽限。 */
-    private failActive;
-    /** 销毁 worker(崩溃/退出,或 hard abort / reset)并下线;下次 run 重建。 */
-    private killWorker;
-}

package/cli/dist-server/types/node/tools/repl/repl-worker-source.d.ts

@@ -1,16 +0,0 @@
-/**
- * REPL worker source string for `new Worker(src, { eval: true })`.
- *
- * The worker is authored as TypeScript in `./worker/repl-worker.ts` and bundled by
- * `scripts/gen-repl-worker-source.mjs` (vite) into `./repl-worker-source.generated.ts`.
- * This module only re-exports the generated constant so the import path stays stable.
- *
- * Why a string constant rather than a worker file:
- *   - agent-cli ships as a Bun single-file executable; there is no worker file to point at.
- *   - A string is opaque to rspack, so the worker's own `require` calls are never rewritten.
- *   - An inline worker inside the SFE has no node_modules, so the worker uses Node builtins
- *     only; acorn's import() rewrite runs on the main thread before the code is sent in.
- *
- * Protocol and sandbox rules are documented at the top of `./worker/repl-worker.ts`.
- */
-export { REPL_WORKER_SOURCE } from './repl-worker-source.generated';

package/cli/dist-server/types/node/tools/repl/repl-worker-source.generated.d.ts

@@ -1,2 +0,0 @@
-/** REPL worker script for `new Worker(src, { eval: true })`. */
-export declare const REPL_WORKER_SOURCE: string;

package/cli/dist-server/types/node/tools/report-findings-tool.d.ts

@@ -1,97 +0,0 @@
-import { z } from 'zod';
-import { BaseTool } from './base-tool';
-import { Tool, ToolResult } from './tool-protocol';
-import { ToolNames } from '../../vendor/cbc-shared/node/index.js';
-declare const ReportFindingsParameters: z.ZodObject<{
-    findings: z.ZodArray<z.ZodObject<{
-        file: z.ZodString;
-        summary: z.ZodString;
-        failureScenario: z.ZodString;
-        category: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        file: string;
-        summary: string;
-        failureScenario: string;
-        category?: string | undefined;
-    }, {
-        file: string;
-        summary: string;
-        failureScenario: string;
-        category?: string | undefined;
-    }>, "many">;
-}, "strip", z.ZodTypeAny, {
-    findings: {
-        file: string;
-        summary: string;
-        failureScenario: string;
-        category?: string | undefined;
-    }[];
-}, {
-    findings: {
-        file: string;
-        summary: string;
-        failureScenario: string;
-        category?: string | undefined;
-    }[];
-}>;
-/**
- * ReportFindings 工具（issue #74425）——让代码审查类 Agent（code-reviewer /
- * silent-failure-hunter / type-design-analyzer / comment-analyzer 等）把审查发现的
- * 问题以结构化字段（file / summary / failureScenario / 可选 category）提交，由终端 UI
- * 渲染成专门的列表组件，而不是纯文本堆在对话里。对齐 Claude Code Tools Reference 的
- * ReportFindings 章节。
- *
- * 数据契约本身与终端渲染无关，可被其他宿主（如 WorkBuddy）复用自己的 UI 消费同一份
- * 结构化数据，不需要复用本仓库的 FindingsToolCall 渲染组件。
- *
- * 默认开启：该工具不调用额外模型、不产生额度成本，与 ImageGen/VideoGen 那一档"默认关闭
- * 需 productFeature 开关"的工具不同，而是与 PushNotification 同档——仅用单层环境变量兜底，
- * 可通过 CODEBUDDY_REPORT_FINDINGS_ENABLED=false 关闭。
- *
- * 延迟加载：product.json 顶层 tools[] 给本工具设置了 deferLoading: true——默认不直接
- * 出现在模型工具列表里，需先经 ToolSearch 发现、再通过 DeferExecuteTool 间接调用。
- * 理由：该工具只在"代码审查"这一类特定场景下才会被调用（由生效的审查指令驱动，不是
- * 通用工具），常驻工具列表对绝大多数非审查会话是纯粹的体积浪费，对齐 PushNotification/
- * ImageGen 等同类工具的做法。isEnabled 只有单层 env 开关，不需要 shouldShowInToolSearch
- * （该方法只用于 ComputerUse/TeamCreate 这类存在运行时门控、索引后仍可能不可调用的场景）。
- */
-export declare class ReportFindingsTool extends BaseTool implements Tool {
-    name: ToolNames;
-    description: string;
-    parameters: z.ZodObject<{
-        findings: z.ZodArray<z.ZodObject<{
-            file: z.ZodString;
-            summary: z.ZodString;
-            failureScenario: z.ZodString;
-            category: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            file: string;
-            summary: string;
-            failureScenario: string;
-            category?: string | undefined;
-        }, {
-            file: string;
-            summary: string;
-            failureScenario: string;
-            category?: string | undefined;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        findings: {
-            file: string;
-            summary: string;
-            failureScenario: string;
-            category?: string | undefined;
-        }[];
-    }, {
-        findings: {
-            file: string;
-            summary: string;
-            failureScenario: string;
-            category?: string | undefined;
-        }[];
-    }>;
-    needsApproval: boolean;
-    isEnabled: () => Promise<boolean>;
-    execute(input: z.infer<typeof ReportFindingsParameters>): Promise<ToolResult>;
-}
-export {};

package/cli/dist-server/types/node/tools/running-background-tasks.d.ts

@@ -1,26 +0,0 @@
-import type { AgentTask, AgentTaskManager } from '../agent-task/agent-task-protocol';
-/**
- * 当前可作为 `task_id` 使用的后台任务，格式为 `id (类型: 标题)`。
- *
- * 为什么需要它：`TaskStop` / `TaskOutput` 的 not-found 文案原本让模型「用 /tasks 看看」，
- * 但 `/tasks` 是 TUI 面板路由（键盘进入、渲染给人看），对应的 CommandExecutor.execute()
- * 函数体是空的，不产出任何进入对话的文本 —— 模型既调不到也读不到。拿不到候选就只能猜
- * task_id：线上实测出现过 TaskStop 连续枚举 488 个不同 id 的失控循环（循环检测按
- * name+arguments 完全相同计数，参数每次都变所以拦不住，最后靠 Max turns (500) 才停，
- * 耗掉 725 credits）。把候选直接拼进错误文本是消除猜测动机的关键 —— 与 Claude Code 的
- * `nTa()` 同一思路：错误信号和可用候选在同一次工具结果里给齐。
- *
- * 口径与 `/tasks` 面板（ui/input/panel/tasks/tasks-panel.tsx）保持一致：同样的两个
- * registry、同样只列 running/pending、agent task 同样用 `agentType › description`
- * 三级兜底标题 —— 否则同一个任务在面板和这里显示的名字会不一样。
- */
-export declare function listRunningBackgroundTasks(agentTaskManager: AgentTaskManager): string[];
-/** agent task 的展示名，与 /tasks 面板及 TaskStop.stopAgentTask 同一套兜底顺序。 */
-export declare function describeAgentTask(task: AgentTask): string;
-/**
- * 目标 task_id 不存在时给模型的完整消息：说明找不到，并列出当前可用的候选。
- *
- * `TaskStop` 与 `TaskOutput` 共用 —— 两者都接受同一个 `task_id`、都在同样的两个
- * registry 里查找，因此候选集合必须一致；分头维护迟早会漂移。
- */
-export declare function buildNotFoundMessage(taskId: string, agentTaskManager: AgentTaskManager): string;

package/cli/dist-server/types/node/tools/sandbox-approval-helpers.d.ts

@@ -1,19 +0,0 @@
-/**
- * 沙箱审批请求的共享判定（bash / PowerShell 复用）。
- *
- * 抽离自 `bash-sandbox-approval-requester.ts`，让两个工具的「bypass 模式是否
- * 自动放行」判定单点收口，避免分叉（此前 PowerShell 漏了网络拦截处理）。
- */
-import type { SandboxApprovalRequest } from '../permission';
-/**
- * 网络拦截记录中是否存在「需要用户决策」的 reason（即使 bypass/fullAccess 模式也不自动放行）。
- *
- * 判定源是 Center `DecisionRecord` 投影出的 reason 枚举，而非 TS 侧
- * `interceptReason` 字符串——Center 已按 HttpIntercept rules 表判定三态并写入
- * reason，TS 据此决定是否必须弹窗。当前仅 `http_intercept_ask`（HTTP 明文拦截
- * 询问态）属于此列；其余 reason（block/黑名单等）由各自 post-exec 路径处理，
- * 不影响 bypass 自动放行判定。
- *
- * pre-exec 模式无 `sandboxResult`，返回 false（不排除 bypass 自动放行）。
- */
-export declare function needsUserDecisionForNetworkBlock(request: SandboxApprovalRequest): boolean;

package/cli/dist-server/types/node/tools/sandbox-intercept-message.d.ts

@@ -1,22 +0,0 @@
-import type { ShellResult } from '../shell';
-type SandboxInterceptResult = Pick<ShellResult, 'fileBlockRecords' | 'networkBlockRecords'>;
-/** 组合普通文件/网络拦截与程序黑名单提示，保持各安全域实现相互独立。 */
-export declare function formatSandboxInterceptMessage(result: SandboxInterceptResult): string;
-/** 仅组合必须阻止模型继续重试的程序黑名单与网络安全提示。 */
-export declare function formatBlockingSandboxInterceptMessage(result: SandboxInterceptResult): string;
-/**
- * `ShellResult.denialMessage` 已逐条给出终局拒绝原因时的补充提示。
- *
- * 与 {@link formatBlockingSandboxInterceptMessage} 只差一处：排除普通网络拦截记录。
- * 那些记录已被 denialMessage 涵盖，再经 `formatSandboxNetworkInterceptMessage` 标一遍
- * `Sandbox Intercept Info (non-blocking)` 会与权威口径矛盾。恶意网站库命中与程序
- * 黑名单超出 denialMessage 的表达范围（前者要给白名单指引，后者要阻止换 shell 重试），
- * 必须保留。
- */
-export declare function formatCriticalSandboxInterceptMessage(result: SandboxInterceptResult): string;
-interface BackgroundOutputBuffer {
-    push(chunk: string): void;
-}
-/** 将必须阻止模型重试的沙箱提示写入后台任务输出。 */
-export declare function pushBlockingSandboxInterceptToBackgroundOutput(buffer: BackgroundOutputBuffer, result: SandboxInterceptResult): void;
-export {};

package/cli/dist-server/types/node/tools/sandbox-network-intercept-message.d.ts

@@ -1,25 +0,0 @@
-import type { ShellResult } from '../shell';
-/**
- * 把非审批型的沙箱拦截记录转成给模型的结构化提示。
- *
- * 恶意网站不能沿用普通的“non-blocking”文案：模型必须明确知道
- * 访问已被拒绝、不应重试，以及唯一的放行方式是由用户加入安全中心白名单。
- * 其他文件/网络拦截保持原有文案，避免改变现有重试和审批语义。
- */
-export declare function formatSandboxNetworkInterceptMessage(result: Pick<ShellResult, 'fileBlockRecords' | 'networkBlockRecords'>): string;
-/** 后台任务的 stderr 汇聚缓冲，命令结束后可能已关闭。 */
-interface BackgroundOutputBuffer {
-    push(chunk: string): void;
-}
-/**
- * 把网络拦截提示写进后台任务输出。Bash 与 PowerShell 共用一份。
- *
- * 后台路径不走前台的结果拼装，只翻任务状态；脚本吞掉请求失败并以 0 退出时状态就是
- * completed，模型用 TaskOutput 追结果时会把这次执行当成完全成功，转头继续访问同一个
- * 恶意域名。所以这里必须显式写一条，且只渲染网络记录——文件拦截由各自的
- * sandbox_denied 分支输出，重复渲染会让模型看到两遍。
- *
- * 缓冲关闭属于正常收尾竞态，吞掉即可：写不进提示也不该让任务完成流程失败。
- */
-export declare function pushNetworkInterceptToBackgroundOutput(buffer: BackgroundOutputBuffer, networkBlockRecords: ShellResult['networkBlockRecords']): void;
-export {};

package/cli/dist-server/types/node/tools/sandbox-permission-file-tool.d.ts

@@ -1,14 +0,0 @@
-import type { RunContext, ToolExecuteArgument } from '../../vendor/cbc-shared/node/index.js';
-import type { Session } from '../../vendor/cbc-core/node/index.js';
-import { BaseTool } from './base-tool';
-/**
- * File-writing tools whose permission decision is delegated to the sandbox
- * write-rule guard whenever the sandbox path is active.
- *
- * The legacy permission service remains the fallback when sandbox execution is
- * disabled or unavailable. ToolManager still executes PreToolUse hooks on the
- * cache-miss path before SandboxWriteRuleGuard runs.
- */
-export declare abstract class SandboxPermissionFileTool extends BaseTool {
-    needsApproval: (runContext: RunContext<Session>, input: ToolExecuteArgument<any>, callId?: string) => Promise<boolean>;
-}

package/cli/dist-server/types/node/tools/sandbox-program-blacklist-message.d.ts

@@ -1,9 +0,0 @@
-import { type FileBlockRecord } from '../sandbox-cli/sandbox-cli-protocol';
-export interface ProgramBlacklistRecordPartition {
-    blockedProgramRecords: FileBlockRecord[];
-    otherFileRecords: FileBlockRecord[];
-}
-/** 把程序黑名单记录从普通文件拦截中分离，避免重复或误导性展示。 */
-export declare function partitionProgramBlacklistRecords(records: FileBlockRecord[] | undefined): ProgramBlacklistRecordPartition;
-/** 将程序黑名单命中转换为模型可理解且不可申请文件授权的明确说明。 */
-export declare function formatProgramBlacklistInterceptMessage(records: FileBlockRecord[] | undefined): string;