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

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

@@ -1,71 +0,0 @@
-import { Session } from '../../vendor/cbc-core/node/index.js';
-import { ToolArg, ToolNames } from '../../vendor/cbc-shared/node/index.js';
-import { Workspace } from '@genie/runtime';
-import { Logger } from '@genie/telemetry';
-import type { RunContext } from '@openai/agents';
-import { z } from 'zod';
-import { ImageBlobService } from '../blob-store';
-import { BaseTool } from './base-tool';
-import { ReadFileStateService, Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
-declare const ReadParameters: z.ZodObject<{
-    file_path: z.ZodString;
-    offset: z.ZodOptional<z.ZodNumber>;
-    limit: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    file_path: string;
-    offset?: number | undefined;
-    limit?: number | undefined;
-}, {
-    file_path: string;
-    offset?: number | undefined;
-    limit?: number | undefined;
-}>;
-export declare class ReadTool extends BaseTool implements Tool {
-    protected readonly workspace: Workspace;
-    protected readonly readFileStateService: ReadFileStateService;
-    protected readonly logger: Logger;
-    protected readonly imageBlobService: ImageBlobService;
-    name: ToolNames;
-    aliases: string[];
-    parameters: z.ZodObject<{
-        file_path: z.ZodString;
-        offset: z.ZodOptional<z.ZodNumber>;
-        limit: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        file_path: string;
-        offset?: number | undefined;
-        limit?: number | undefined;
-    }, {
-        file_path: string;
-        offset?: number | undefined;
-        limit?: number | undefined;
-    }>;
-    argumentRenderer: ToolCallArgumentRenderer;
-    resolveNeedPermissionArgs(runContext: RunContext, input: z.infer<typeof ReadParameters>, callId?: string): ToolArg[];
-    /**
-     * Auto mode classifier projection: the file path (Claude alignment, decision
-     * D1). Read is in the read-only history set (dropped from history), so this is
-     * only consulted if Read is the current action being classified.
-     */
-    toAutoClassifierInput(input: unknown): string;
-    execute(input: z.infer<typeof ReadParameters>, context: RunContext<Session>): Promise<ToolResult>;
-    private validateToolParams;
-    private readFileContent;
-    private readFileContentStreaming;
-    private processFileContent;
-    private formatContentWithLineNumbers;
-    private readJupyterNotebook;
-    private formatJupyterNotebook;
-    /**
-     * 检查文件是否为图片文件
-     */
-    private isImageFile;
-    /**
-     * 读取图片文件并返回包含图片内容的 ToolResult
-     *
-     * 去重策略：同一 agent run 中相同内容的图片（相同 blob_id）只返回一次完整 base64，
-     * 后续重复读取返回文本占位符，避免向模型发送冗余的大体积图片数据。
-     */
-    private readImageFile;
-}
-export {};

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

@@ -1,10 +0,0 @@
-export * from './repl-protocol';
-export * from './repl-catalog-protocol';
-export * from './repl-catalog-render';
-export * from './repl-catalog-source';
-export * from './repl-import-rewrite';
-export * from './repl-worker-source';
-export * from './repl-bridge-broker';
-export * from './repl-bridge-host';
-export * from './repl-tool';
-export * from './repl-worker-manager';

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

@@ -1,109 +0,0 @@
-/**
- * REPLBridgeBroker —— worker 的 toolCall / replApi / resolve / bridgeOp 落点(主线程)。
- *
- * 三条分流(见 docs/repl-code-mode/mcp-code-mode-design.md §4.1):
- *  - 工具调用 callTool → 主动 checkPermission → 产品交互工具走 nested interruption，
- *    其余 DeferExecuteTool.routeToolCall
- *  - 工具发现 searchTools / describeTool(s) → ToolSearchService(只读,不过权限判定)
- *  - 外部桥   resolve / invoke → BridgeHost
- *
- * agent-cli 对外部桥零业务:只认 BridgeHost SPI,不知道 browser/computer 具体是什么。
- */
-import { InterruptionService, Session } from '../../../vendor/cbc-core/node/index.js';
-import { Logger } from '@genie/telemetry';
-import type { RunContext } from '@openai/agents';
-import { McpManager } from '../../mcp/mcp-protocol';
-import { ToolManager } from '../tool-protocol';
-import { ToolSearchService } from '../tool-search-protocol';
-import { AgentToolDeferOverlayCache } from '../tool-spec';
-import { BridgeEntry, SearchToolsOptions, ToolDescriptor, ToolSearchHit } from './repl-catalog-protocol';
-import { BridgeApiDescriptor, BridgeCallOpts, BridgeHost, BridgeInvokeOp, BridgeResult, REPLBridgeBroker } from './repl-protocol';
-export declare class REPLBridgeBrokerImpl implements REPLBridgeBroker {
-    protected readonly logger: Logger;
-    protected readonly host?: BridgeHost;
-    protected readonly toolSearchService: ToolSearchService;
-    protected readonly toolManager: ToolManager;
-    protected readonly overlayCache: AgentToolDeferOverlayCache;
-    protected readonly mcpManager?: McpManager;
-    protected readonly interruptionService?: InterruptionService;
-    resolve(_session: Session, specifier: string): Promise<BridgeApiDescriptor | null>;
-    invoke(session: Session, op: BridgeInvokeOp, opts?: BridgeCallOpts): Promise<BridgeResult>;
-    listBridges(_session: Session): Promise<BridgeEntry[]>;
-    callTool(context: RunContext<Session>, toolName: string, params: Record<string, unknown>, opts?: BridgeCallOpts): Promise<{
-        result?: unknown;
-        error?: string;
-    }>;
-    private callProductInteractionTool;
-    /**
-     * 主动跑权限判定。**必须主动调**:REPL 的 toolCall 不经 AgentService,不调则
-     * deny rules 与命令安全检查全被绕过(模型可在 code 里写 Bash({command:"rm -rf /"}))。
-     *
-     * 拦截口径分两类:
-     *  - **deny**:恒拦(deny 规则 / --disallowed-tools / dontAsk 转 deny / auto 分类器 deny)。
-     *  - **危险操作的 ask**:命令安全检查(CRITICAL/HIGH/unsafe 命令,`type:'toolValidation'`)
-     *    与敏感文件访问(`type:'sensitiveFile'`)产出的是 `ask` 而非 `deny`。直连 Bash 会
-     *    对这类 ask 弹窗让用户拦下,但 REPL 内层不弹窗——若同 deny 一样只看 behavior,
-     *    模型把 `rm -rf` / 读 SSH key 包进 code 就能绕过这道安全确认(比直连更弱)。故这里
-     *    把安全类 ask 也视为拦截,回错误给沙箱(不 abort 父 REPL,模型可 r.error 改路)。
-     *
-     * 其余 ask(`strategy`/`default`/`mode` 等"该工具默认需审批")仍放行:用户已对整段
-     * code 批准过一次,不对 code 内每个普通工具重复打扰。见 §4.8。
-     *
-     * @returns 被拒时返回错误文案；通过返回 undefined。
-     */
-    private checkPermission;
-    /**
-     * checkPermission 自身异常时的 fail 方向。返回 true = 拒绝（fail-closed）。
-     *
-     * 只有同时满足以下三条才允许放行（fail-open）——即正常路径上 deny 无从产生：
-     *  1. 无任何 deny 规则（settings `permissions.deny` 各 scope + `--disallowed-tools`）；
-     *  2. 非 print 模式（`shouldAvoidPermissionPrompts` 会把未 allow 的工具默认 deny）；
-     *  3. 权限模式在白名单内：Default / AcceptEdits（ask 在 broker 本就不拦）、
-     *     BypassPermissions / FullAccess（用户显式全放行）。DontAsk（ask→deny）、
-     *     Auto（分类器可 deny）、Plan / Delegate / 未知模式一律 fail-closed。
-     */
-    private mustFailClosedOnPermissionError;
-    /**
-     * 本会话是否配置了任何 deny 规则（settings `permissions.deny` 各 scope +
-     * `--disallowedTools`）。口径与 ToolPermissionService Phase 1 的
-     * `allDenyRules = [...denyRules, ...disallowedTools]` 同源。
-     */
-    private hasAnyDenyRule;
-    searchTools(context: RunContext<Session>, query: string | string[], opts?: SearchToolsOptions): Promise<ToolSearchHit[]>;
-    describeTool(context: RunContext<Session>, name: string): Promise<ToolDescriptor | null>;
-    describeTools(context: RunContext<Session>, names: string[]): Promise<Record<string, ToolDescriptor | null>>;
-    private overlayOf;
-    /**
-     * `Defer(X)` overlay 命中的内置工具可能尚未索引（索引按 product 静态配置建）。
-     * 点名查只索引问到的那个；关键词搜索引全部精确条目。
-     * 通配条目（`Defer(mcp__*)`）不处理——模式反向枚举不出工具名，且 MCP 索引由
-     * mcp-manager 异步驱动。见 §4.3.3 易漏点 ③。
-     */
-    private ensureForceDeferIndexed;
-    /**
-     * 模型面名 → canonical 路由名。
-     * `mcp_github.list_prs` → `mcp__github__list_prs`；内置单段名原样返回。
-     * sandbox global 一律带 `mcp_` 前缀（§4.7），此处还原成真 server 名。
-     */
-    private toCanonicalName;
-    private toHit;
-    private toDescriptor;
-    /** 目录教 `mcp_github`，hit.server 仍是裸 id `github`，两边都认。 */
-    private matchesSearchServer;
-    private serverNameOf;
-    /**
-     * 子代理 MCP 白名单：只约束 `mcp__` 前缀工具；裸名 MCP 是透明代理的全局能力，
-     * 走白名单会误杀。agent 未注册白名单时全部放行。
-     */
-    private isMcpToolAllowedForAgent;
-    /**
-     * repl_expose 白名单（执行层，与 repl-catalog-source.ts 同口径）：只约束 `mcp__`
-     * 前缀工具的 server 级 opt-in。裸名 MCP 是透明代理全局能力、内置工具不带前缀，两者
-     * 都不走此路径直接放行。
-     *
-     * **fail-closed**：查不到 server config / McpManager 缺失 / list() 抛错时一律拒绝
-     * （返回 false）。理由与发现层一致——白名单默认 false，"拿不到配置"必须等价于"未
-     * 暴露"，否则查询失败会变成绕过白名单的旁路。
-     */
-    private isMcpToolReplExposed;
-}

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

@@ -1,29 +0,0 @@
-/**
- * RemoteBridgeHost —— BridgeHost 的真实现(agent-cli 侧客户端)。
- *
- * 传输 = 一条**本地 socket / 命名管道**(Unix domain socket / Windows 命名管道),零端口。
- * 由 spawn agent-cli 的一方(如 WorkBuddy)经 env 传入:
- *   - `CODEBUDDY_REPL_HOST_PIPE_PATH` —— Unix domain socket 路径(mac/linux)或命名管道 `\\.\pipe\...`(Windows)。
- *   - `CODEBUDDY_REPL_HOST_TOKEN`     —— 授权 token(**强制**)。
- * agent-cli 只 `net.connect(path)`(跨平台透明)、写 `{op,...,token}\n`、读 `<json>\n`。
- *
- * 安全:**token 强制**——host 是高权限(浏览器/电脑控制),裸 socket 会被同机其它进程利用。
- *   pipe 或 token 任一未配置 → 无桥(不连接)→ `import("@wb/x")` 抛 not available。
- * 跨平台:Node `net` 对 Unix socket / Windows 命名管道透明,由提供方按平台给正确的 path。
- * 二进制:参数/返回值里的 Uint8Array/ArrayBuffer 在 socket 边界自动 ⇄ `{ $bytes: base64 }`,对模型/桥透明。
- * 超时:单次桥调用超时随 cell 预算(opts.timeoutMs / opts.signal),不写死。
- * 端到端验证需真提供方 + 真能力(本环境不具备);此为客户端半边 + 协议契约。见 docs/repl-code-mode/bridge-contract.md。
- */
-import { Logger } from '@genie/telemetry';
-import { BridgeApiDescriptor, BridgeCallOpts, BridgeHost, BridgeInvokeRequest, BridgeResult } from './repl-protocol';
-export declare class RemoteBridgeHost implements BridgeHost {
-    protected readonly logger: Logger;
-    listBridges(): Promise<string[]>;
-    resolveBridge(specifier: string): Promise<BridgeApiDescriptor | null>;
-    invokeBridge(req: BridgeInvokeRequest, opts?: BridgeCallOpts): Promise<BridgeResult>;
-    /**
-     * 一次连接一次请求:写 `{...,token}\n`,读 `<json>\n`。
-     * pipe 或 token 未配置 → undefined(无桥,不连接)。失败/超时 → undefined(调用方降级)。
-     */
-    private post;
-}

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

@@ -1,136 +0,0 @@
-/**
- * REPL 目录契约 —— 骨架目录（进 prompt）与发现 API（沙箱运行时）的共享类型。
- *
- * 设计见 docs/repl-code-mode/mcp-code-mode-design.md §4.3。
- * 要点:
- *  - 只有一份目录产物(骨架目录),档 A 给工具级明细 / 档 B 给 server 级索引,合起来全量收录。
- *  - 没有枚举 API:"有哪些工具"读骨架目录即可,零调用零 token。
- *  - 发现 API 只补骨架做不到的两件事:档 B 里找工具(searchTools)、完整 schema(describeTool)。
- */
-import type { RunContext } from '@openai/agents';
-import type { Session } from '../../../vendor/cbc-core/node/index.js';
-/** 工具归属：内置工具占顶层全局，MCP 工具收在 server 二级命名空间下。 */
-export type REPLToolCategory = 'builtin' | 'mcp';
-/** 采集层产出的单个工具元信息（渲染骨架与注入 sandbox 共用）。 */
-export interface REPLCatalogTool {
-    /** canonical 路由名："Bash" / "mcp__github__list_pull_requests"。 */
-    name: string;
-    /** 模型面调用名："Bash" / "mcp_github.list_pull_requests"（§4.7 统一前缀）。 */
-    displayName: string;
-    category: REPLToolCategory;
-    /** 一行摘要（渲染时再按预算截断）。 */
-    summary: string;
-    /**
-     * 沙箱返回值形状，渲染在参数骨架后面、摘要前面。
-     * 必须单独成字段：摘要会被 SUMMARY_MAX_CHARS 截断，返回值不能被吃掉。
-     */
-    returns?: string;
-    /** JSON Schema；渲染骨架与 describeTool 都用它。 */
-    parameters: Record<string, unknown>;
-    /** MCP 所属 server 名（category==='mcp' 时必有）。 */
-    server?: string;
-    /** MCP 原始 tool name。 */
-    serverToolName?: string;
-}
-/** 一个 MCP server 及其工具（分档的最小单位——整组降档，不半截）。 */
-export interface REPLCatalogServerGroup {
-    /** 真实 server 名（用于 canonical 名与 `{server}` 过滤）。 */
-    server: string;
-    /** sandbox 全局键名；一律 `mcp_<server>`（§4.7），不是撞保留字才加前缀。 */
-    globalName: string;
-    description?: string;
-    tools: REPLCatalogTool[];
-}
-/** 采集层产物。骨架渲染与 sandbox 注入同源于此，避免两处口径漂移。 */
-export interface REPLCatalog {
-    /** 内置工具（延迟 + 非延迟合并后）。 */
-    builtin: REPLCatalogTool[];
-    mcp: REPLCatalogServerGroup[];
-    /** 目录版本号 = ToolSearchService.indexEpoch，用于新鲜度对账（§4.3.4）。 */
-    epoch: number;
-}
-export declare const ReplCatalogSource: unique symbol;
-/**
- * 目录采集层 —— **无状态**：每次 collect 现采，不缓存。
- *
- * 不缓存的理由：调用频率极低（agent 构建时一次，见 §4.3.4「注入时机与生产次数」），
- * 而缓存 key 需覆盖 agent 白名单 / session --tools / overlay / 动态 shouldShow 四个维度
- * 并跟随 indexEpoch 失效——失效逻辑比重新采集更贵，且易出 stale bug。
- */
-export interface ReplCatalogSource {
-    /**
-     * 采集当前会话可见的全部工具。
-     *
-     * 收 `RunContext` 而非 `Session`：agent 工具白名单入口
-     * `getAllowedToolsForAgent(agentName, context)` 需要 RunContext 才能跑
-     * `isEnabled`，且 RunContext 无法从 Session 反推（§4.3.3 易漏点 ①）。
-     */
-    collect(context: RunContext<Session>): Promise<REPLCatalog>;
-}
-export interface SearchToolsOptions {
-    /** 默认 10，钳制到 [1, 50]。上限防止拿它当枚举用——枚举应读骨架目录。 */
-    topK?: number;
-    category?: REPLToolCategory;
-    /** 只搜某个 MCP server（隐含 category: 'mcp'）。 */
-    server?: string;
-}
-export interface ToolSearchHit {
-    /** 模型面调用名，可直接当 describeTool 的入参。 */
-    name: string;
-    category: REPLToolCategory;
-    server?: string;
-    /** 一行摘要（按 SUMMARY_MAX_CHARS 截断——索引里存的是 full description）。 */
-    description: string;
-    /** BM25 相关度，降序。 */
-    score: number;
-}
-export interface ToolDescriptor {
-    name: string;
-    category: REPLToolCategory;
-    description: string;
-    /** 完整 JSON Schema（含嵌套结构、约束与逐字段描述）。 */
-    parameters: Record<string, unknown>;
-    server?: string;
-    serverToolName?: string;
-}
-export interface BridgeEntry {
-    /** 桥标识："@wb/browser"。 */
-    specifier: string;
-}
-/** worker 侧注入 sandbox 全局所需的最小描述（结构化克隆友好）。 */
-export interface REPLToolDescriptor {
-    name: string;
-    displayName: string;
-    category: REPLToolCategory;
-    server?: string;
-    serverToolName?: string;
-}
-/** init / toolsUpdate 推给 worker 的载荷。 */
-export interface REPLToolsPayload {
-    epoch: number;
-    builtins: REPLToolDescriptor[];
-    /** globalName → 该 server 下工具的 displayName 尾段与 canonical 名映射。 */
-    servers: Array<{
-        globalName: string;
-        server: string;
-        tools: Array<{
-            method: string;
-            canonical: string;
-        }>;
-    }>;
-}
-export declare const REPL_SEARCH_TOOLS_DEFAULT_TOP_K = 10;
-export declare const REPL_SEARCH_TOOLS_MAX_TOP_K = 50;
-/** describeTools 的条数上限：精准批量，不是全量拉取。 */
-export declare const REPL_DESCRIBE_TOOLS_MAX = 10;
-/**
- * 所有 MCP server 的 sandbox global 统一前缀（§4.7）。
- *
- * 沙箱里 MCP 工具的可调用名是 `<前缀><serverName>.<rawToolName>`，其中
- * `serverName` / `rawToolName` 取自 `DeferredToolInfo`（见 mcp-manager 的索引段），
- * **不是** canonical 名 `mcp__server__tool` 的字符串切分——transparent_proxy 场景下
- * canonical 段可能与 serverName 不同（例如 connector-proxy 代管的服务）。
- * 放在 protocol 里是为了让目录构造（repl-catalog-source）与引导文案
- * （main-agent-session）用同一个前缀，避免两处各写一份漂移。
- */
-export declare const MCP_SANDBOX_GLOBAL_PREFIX = "mcp_";

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

@@ -1,56 +0,0 @@
-/**
- * 骨架目录渲染 —— 把 REPLCatalog 渲成拼进 `code` 参数描述的纯文本。
- *
- * 设计见 docs/repl-code-mode/mcp-code-mode-design.md §4.3.2。
- *
- * 分档降级（档 A/B）是本文件的核心：
- *  - 档 A（工具级，~100B/工具）：每工具一行 `name({ 参数骨架 }) — 描述`
- *  - 档 B（server 级，~70B/server）：一行 `name (N tools) — 描述`
- *
- * 降级单位是 **server 整组**，不半截——半截会让模型以为该 server 只有那几个工具。
- * 档 B 体积几乎不随工具数增长，所以任意规模都装得下：装不下的只是档 A。
- */
-import { REPLCatalog, REPLCatalogServerGroup, REPLCatalogTool } from './repl-catalog-protocol';
-/** 骨架总预算，对齐 DEFAULT_DEFERRED_TOOLS_CHAR_BUDGET（~20000 chars ≈ ~5000 tokens）。 */
-export declare const SKELETON_CHAR_BUDGET = 20000;
-/** 单工具最多列几个顶层参数，超出记 `…+N`。 */
-export declare const MAX_PARAMS_PER_TOOL = 6;
-/** 单工具一行摘要的截断长度（searchTools 的出参共用该常量）。 */
-export declare const SUMMARY_MAX_CHARS = 80;
-/** 档 B 里 server 描述的截断长度。 */
-export declare const SERVER_DESC_MAX_CHARS = 100;
-export declare function truncate(text: string, max: number): string;
-/**
- * 类型渲染：枚举原样列出（≤4 项），数组给壳，嵌套对象一律折叠成 `object`。
- *
- * 折叠是刻意的——完整嵌套 schema 可达数 KB（实测 AskUserQuestion 3966B vs 骨架 73B，
- * 54 倍）。代价是 `object` 对模型是信息不足的信号，因此兜底说明必须告诉它
- * "看到 object 就调 describeTool"，否则模型会把它当成"接受任意对象"。
- */
-export declare function renderType(def: unknown): string;
-/**
- * 从 JSON Schema 派生单个参数对象的骨架：只取顶层 properties，必填优先。
- *
- * REPL 预注入函数的运行时契约始终是 `Tool(params)`，不是多个位置参数。这里必须
- * 保留对象花括号；否则 `Artifact(filePath: string, ...)` 会误导模型传入字符串，导致
- * 工具侧收到的 `input.filePath` 为 undefined。
- */
-export declare function renderParameterSkeleton(schema: Record<string, unknown> | undefined): string;
-/** 档 B 一行：`name (N tools) — description`。 */
-export declare function renderServerTierB(group: REPLCatalogServerGroup): string;
-export interface TierAllocation {
-    tierA: REPLCatalogServerGroup[];
-    tierB: REPLCatalogServerGroup[];
-}
-/**
- * 档 A/B 分配：builtin 无条件档 A（不参与预算竞争）；MCP 按工具数升序填至预算，
- * 溢出的整组降档 B。
- *
- * 按工具数升序是性价比优先：一个小 server 只要几百字节，先进档 A 能覆盖更多 server。
- */
-export declare function allocateTiers(builtin: REPLCatalogTool[], mcpGroups: REPLCatalogServerGroup[], budget?: number): TierAllocation;
-/**
- * 渲染骨架目录全文。档 A + 档 B 合起来**全量收录**——所以模型读它即知会话里有什么，
- * 不需要任何枚举 API。
- */
-export declare function renderSkeletonCatalog(catalog: REPLCatalog, budget?: number): string;

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

@@ -1,117 +0,0 @@
-/**
- * ReplCatalogSource —— 骨架目录与发现 API 的统一采集层（主线程）。
- *
- * 设计见 docs/repl-code-mode/mcp-code-mode-design.md §4.3.2「目录数据源」。
- *
- * 三个数据源，各补一块：
- *  - ToolSearchService.listDeferredToolInfos() → 延迟工具（builtin + MCP），带 parameters
- *  - ToolManager.listRegisteredTools()        → 非延迟内置工具（不在延迟索引里）
- *  - McpManager.getConnectedServers()         → 补"已连接但尚无工具"的空分组
- *
- * **无状态**：每次 collect 现采、不缓存。理由见 protocol 里 ReplCatalogSource 的注释。
- */
-import { Logger } from '@genie/telemetry';
-import type { RunContext } from '@openai/agents';
-import { CliRuntimeOptions } from '../../cli/cli-runtime-options';
-import { McpManager } from '../../mcp/mcp-protocol';
-import type { Session } from '../../../vendor/cbc-core/node/index.js';
-import { ToolManager } from '../tool-protocol';
-import { ToolSearchService } from '../tool-search-protocol';
-import { AgentToolDeferOverlayCache } from '../tool-spec';
-import { REPLCatalog, ReplCatalogSource } from './repl-catalog-protocol';
-/**
- * 所有 MCP server 的 sandbox global 统一加 `mcp_` 前缀（§4.7，常量定义在 protocol）。
- * 与内置工具 / 基础设施（Bash、Read、REPL、tools…）彻底隔离，骨架目录里
- * 看到 `mcp_xxx:` 就能照抄。canonical 全名（mcp__server__tool）不受影响。
- * worker 侧 `INFRA_GLOBALS` 仍是第二道防线，防止漏改名的 catalog 顶掉 SDK。
- */
-export declare class ReplCatalogSourceImpl implements ReplCatalogSource {
-    protected readonly logger: Logger;
-    protected readonly toolSearchService: ToolSearchService;
-    protected readonly toolManager: ToolManager;
-    protected readonly overlayCache: AgentToolDeferOverlayCache;
-    protected readonly mcpManager?: McpManager;
-    protected readonly cliRuntimeOptions?: CliRuntimeOptions;
-    collect(context: RunContext<Session>): Promise<REPLCatalog>;
-    /**
-     * 构建期兜底：当 live session 未携带 `--tools`（agent 构建早于会话建立，
-     * getCurrent() 为 undefined）时，用进程级 CliRuntimeOptions 的 `--tools`
-     * 合成一个带 options.tools 的 context，交给 getAllowedToolsForAgent 走同一套
-     * 白名单解析。
-     *
-     * 优先级与 ToolManager.resolveSessionToolContext 对齐：live session 已有
-     * options.tools 时**不覆盖**（它是权威值）；仅在缺失时才回退到 CLI 快照。
-     * 未装配 CliRuntimeOptions（headless/单测）或无 `--tools` 时原样返回。
-     */
-    private contextWithCliTools;
-    private ensureGroup;
-    private appendEmptyServerGroups;
-    /**
-     * 采集全部 MCP server 的配置，建立 serverName → McpConfig 映射，供 repl_expose 判定用。
-     * 失败时返回空 map —— 白名单默认 false，等价于"任何 MCP 都不暴露给沙箱"，安全兜底。
-     */
-    private collectServerConfigs;
-    /**
-     * repl_expose 白名单判定（仅约束 MCP 工具，内置工具不走此路径）。
-     * 只认 server 级：显式 repl_expose:true 才暴露，其余（含未配置）一律默认 false。
-     */
-    private isReplExposed;
-    private toBuiltinTool;
-    /**
-     * 合并本会话的全部 deny 规则来源，口径与 ToolPermissionService Phase 1 的
-     * `allDenyRules = [...mergeRulesFromAllSources(denyRules), ...disallowedTools]` 同源。
-     */
-    private collectDenyRules;
-    /**
-     * 名字（含别名）是否命中**整工具级** deny 规则。
-     *
-     * 只有 `rule === '*'` 才整体隐藏；带参规则（`Bash(rm:*)`）交给执行期
-     * ToolPermissionService Phase 1，工具本身必须留在目录里，否则模型连
-     * 合法用法都看不到。
-     */
-    private isWholeToolDenied;
-    /**
-     * 整工具级 deny 规则命中的**内置**工具名集合（MCP 由调用方按单名逐个判）。
-     *
-     * 与 `AgentManager.isToolDisallowed` 严格同口径：匹配时**带上 aliases**——
-     * `--disallowed-tools read` 要能同时命中 LSP / BashOutput 等把 `read` 声明为
-     * 别名的工具（isToolDisallowed 用的是 `[toolName, ...aliases]`）。
-     *
-     * 无任何 deny 规则时立刻返回，避免为绝大多数会话白跑一遍 O(工具数×规则数)。
-     */
-    private collectWholeToolDenyNames;
-    private toMcpTool;
-    /** 裸名 MCP 工具没有 serverName 也不带 mcp__ 前缀，此时返回 undefined 归入 builtin 段。 */
-    private serverNameOf;
-    /**
-     * 内置工具的 agent 白名单判定：与 ToolSearchService.isAllowedByAgentTools 同口径
-     * （MCP 工具豁免，内置工具必须显式启用）。
-     */
-    private isAllowedBuiltin;
-    /**
-     * REPL 自己与 defer 机制的两个工具不进目录：
-     * REPL 不能自我递归调用；ToolSearch/DeferExecuteTool 在沙箱里被
-     * searchTools/describeTool 取代，暴露它们只会让模型混淆两条调用路径。
-     */
-    private isHiddenFromCatalog;
-    /**
-     * PTC 跳过直连白名单之后，仍要过工具自己的 isEnabled。
-     * 否则 WorkBuddy 的沙箱骨架会列出 SpeakInChannel / MessageColleague。
-     */
-    private isSandboxToolEnabled;
-    /**
-     * 归一化成 JSON Schema。三种入参形态都要处理：
-     *  - 已是 JSON Schema 对象 → 原样
-     *  - zod schema → `zodToJsonSchema`
-     *  - **函数**（`parameters(): ZodTypeAny` / `async () => ...`）→ 先调用再转
-     *
-     * 第三种必须处理：`ToolManager.init()` 对函数式 `parameters` **刻意跳过**转换
-     * （留给 `get()` 时动态生成），而这里走 `listRegisteredTools()` 拿的是原始 toolMap，
-     * `parameters` 仍是函数。漏掉它会让 Bash / PowerShell / Agent / StructuredOutput
-     * 在骨架目录里渲染成无参的 `Bash()` —— 而 Bash 恰是价值最高的工具。
-     *
-     * 函数必须带 `thisArg`：Agent 的 `parameters()` 是 `return this.buildParametersSchema()`，
-     * 抽成裸 `()` 调用会在 strict 下把 schema 打成 `{}`。
-     */
-    private asJsonSchema;
-}

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

@@ -1,17 +0,0 @@
-/**
- * 预处理用户 REPL 代码,在包进 async-IIFE 之前用 acorn 做两趟变换:
- *   1. 动态 import(x) → __replImport(x)(bridge resolver 全局;Bun 的 vm.SyntheticModule 有 bug,只能源码改写)。
- *   2. 顶层声明提升 + 末尾表达式 → return:
- *      - const/let/var/function/class 改写成对持久 vm.Context 的 global 赋值,让变量跨 cell 存活
- *        (kernel/cell 模型的关键——否则 IIFE 一结束声明就没了,`const x = 5` 下个 cell 就读不到);
- *      - 最后一条裸表达式前缀 `return`,所以 `return` 和末尾表达式两种写法都能拿到结果。
- *
- * 变换后由 manager 包进 (async () => { ... })()。顶层 await/return 落进这个 async 函数;顶层声明已经被改成
- * 对 global 的 bare 赋值——非严格模式下 bare 赋值写到 vm.Context 的 global,于是跨 cell 持久。
- */
-/** import() → __replImport() + 顶层声明提升到 global + 末尾表达式 → return。解析失败则原样返回(交给 vm.Script 报错)。
- *
- * async：内部走 acorn/acorn-walk lazy chunk（standby 不 parse）；本函数是 hot path
- * 上唯一使用者。caller `repl-worker-manager.executeCell` 在 async 上下文，加 await 即可。
- */
-export declare function transformReplCode(source: string): Promise<string>;

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

@@ -1,32 +0,0 @@
-/**
- * Nested product-interaction from inside a REPL cell.
- *
- * Broker `checkPermission` skips upgrading `ask` to a popup (the user already
- * approved the cell). That is correct for Write/Bash and wrong for tools whose
- * job *is* the interaction: AskUserQuestion needs `toolCallId` + `setAsk`,
- * ExitPlanMode needs the plan-approval panel.
- *
- * Do not use `session.state.approve/reject` here. CLI UI reject of a normal
- * tool interruption aborts the session (`interruption-service` ~833). Nested
- * calls must settle the cell without aborting the parent REPL run.
- *
- * Reuse the sandbox settle pattern (`_sandboxResolve` + `enqueueSandboxApproval`)
- * without sandbox UI flags. TUI/ACP dispatch on `rawItem.name`.
- */
-import type { RunContext } from '@openai/agents';
-import type { InterruptionService as IInterruptionService, Session } from '../../../vendor/cbc-core/node/index.js';
-import { type ToolResult } from '../tool-protocol';
-export declare const REPL_PLAN_REJECTED_MESSAGE = "The user rejected the plan. Stay in plan mode, revise the plan, then call ExitPlanMode again.";
-export declare const REPL_NESTED_NONINTERACTIVE_MESSAGE: string;
-export interface ReplNestedInteractionDeps {
-    interruptionService: Pick<IInterruptionService, 'enqueueSandboxApproval' | 'reject'>;
-    execute: (toolName: string, params: Record<string, unknown>, context: RunContext<Session>, details: {
-        toolCall: {
-            callId: string;
-            id: string;
-            name: string;
-            arguments: string;
-        };
-    }) => Promise<ToolResult>;
-}
-export declare function runReplProductInteraction(deps: ReplNestedInteractionDeps, context: RunContext<Session>, toolName: string, params: Record<string, unknown>, cellSignal?: AbortSignal): Promise<ToolResult>;