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

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

@@ -0,0 +1,107 @@
+import { Session } from '../../vendor/cbc-core/node/index.js';
+import { Agent, ToolNames } from '../../vendor/cbc-shared/node/index.js';
+import { ProductManager } from '../../workspace/product/lib/common/index.js';
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import type { RunContext } from '@openai/agents';
+import { z } from 'zod';
+import { BaseTool } from './base-tool';
+import { ImageService, Tool, ToolResult } from './tool-protocol';
+export { TEXT_TO_IMAGE_MODEL_TAG } from './tool-protocol';
+/**
+ * 文生图 + 图生图参数 Schema
+ * image1-3 为可选参数：传入则为图生图（支持 1-3 张参考图），不传则为文生图
+ */
+declare const ImageGenParameters: z.ZodObject<{
+    prompt: z.ZodString;
+    size: z.ZodOptional<z.ZodString>;
+    quality: z.ZodOptional<z.ZodString>;
+    style: z.ZodOptional<z.ZodString>;
+    background: z.ZodOptional<z.ZodString>;
+    footnote: z.ZodOptional<z.ZodString>;
+    revise: z.ZodOptional<z.ZodBoolean>;
+    output_dir: z.ZodOptional<z.ZodString>;
+} & {
+    image1: z.ZodOptional<z.ZodString>;
+    image2: z.ZodOptional<z.ZodString>;
+    image3: z.ZodOptional<z.ZodString>;
+    input_fidelity: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    size?: string | undefined;
+    background?: string | undefined;
+    quality?: string | undefined;
+    style?: string | undefined;
+    footnote?: string | undefined;
+    revise?: boolean | undefined;
+    output_dir?: string | undefined;
+    input_fidelity?: string | undefined;
+    image1?: string | undefined;
+    image2?: string | undefined;
+    image3?: string | undefined;
+}, {
+    prompt: string;
+    size?: string | undefined;
+    background?: string | undefined;
+    quality?: string | undefined;
+    style?: string | undefined;
+    footnote?: string | undefined;
+    revise?: boolean | undefined;
+    output_dir?: string | undefined;
+    input_fidelity?: string | undefined;
+    image1?: string | undefined;
+    image2?: string | undefined;
+    image3?: string | undefined;
+}>;
+export declare class ImageGenTool extends BaseTool implements Tool {
+    protected readonly imageService: ImageService;
+    protected readonly productManager: ProductManager;
+    protected readonly logger: Logger;
+    name: ToolNames;
+    description: string;
+    parameters: z.ZodObject<{
+        prompt: z.ZodString;
+        size: z.ZodOptional<z.ZodString>;
+        quality: z.ZodOptional<z.ZodString>;
+        style: z.ZodOptional<z.ZodString>;
+        background: z.ZodOptional<z.ZodString>;
+        footnote: z.ZodOptional<z.ZodString>;
+        revise: z.ZodOptional<z.ZodBoolean>;
+        output_dir: z.ZodOptional<z.ZodString>;
+    } & {
+        image1: z.ZodOptional<z.ZodString>;
+        image2: z.ZodOptional<z.ZodString>;
+        image3: z.ZodOptional<z.ZodString>;
+        input_fidelity: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        prompt: string;
+        size?: string | undefined;
+        background?: string | undefined;
+        quality?: string | undefined;
+        style?: string | undefined;
+        footnote?: string | undefined;
+        revise?: boolean | undefined;
+        output_dir?: string | undefined;
+        input_fidelity?: string | undefined;
+        image1?: string | undefined;
+        image2?: string | undefined;
+        image3?: string | undefined;
+    }, {
+        prompt: string;
+        size?: string | undefined;
+        background?: string | undefined;
+        quality?: string | undefined;
+        style?: string | undefined;
+        footnote?: string | undefined;
+        revise?: boolean | undefined;
+        output_dir?: string | undefined;
+        input_fidelity?: string | undefined;
+        image1?: string | undefined;
+        image2?: string | undefined;
+        image3?: string | undefined;
+    }>;
+    isEnabled: (_args: {
+        runContext: RunContext<Session>;
+        agent: Agent;
+    }) => Promise<boolean>;
+    execute(input: z.infer<typeof ImageGenParameters>, context: RunContext<Session>): Promise<ToolResult>;
+}

package/cli/dist-server/types/node/tools/image-service.d.ts

@@ -0,0 +1,113 @@
+import { RestOperations } from '@celljs/http';
+import { AuthenticationManager } from '../../workspace/authentication/lib/common/index.js';
+import { LanguageModel, ProductConfiguration, ProductManager } from '../../workspace/product/lib/common/index.js';
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import type { RunContext } from '@openai/agents';
+import { Session } from '../../vendor/cbc-core/node/index.js';
+import { SettingsManager } from '../settings';
+import { EditImageParams, GenerateImageParams, ImageGenData, type ImageGenerationResult, ImageService } from './tool-protocol';
+/**
+ * 图片服务实现
+ * 封装文生图和图生图的共享逻辑
+ */
+export declare class ImageServiceImpl implements ImageService {
+    protected readonly restOperations: RestOperations;
+    protected readonly authenticationManager: AuthenticationManager;
+    protected readonly productManager: ProductManager;
+    protected readonly logger: Logger;
+    protected readonly settingsManager: SettingsManager;
+    private outputDir;
+    /**
+     * 初始化输出目录
+     */
+    initializeOutputDir(customOutputDir?: string): Promise<void>;
+    /**
+     * 文生图 API 调用
+     */
+    generateImage(params: GenerateImageParams, context: RunContext<Session>): Promise<ImageGenerationResult>;
+    /**
+     * 图生图 API 调用
+     */
+    editImage(params: EditImageParams, context: RunContext<Session>): Promise<ImageGenerationResult>;
+    /**
+     * 处理图片输入，转换为 base64 格式
+     * 支持多种输入格式：
+     * 1. 文件路径: "/path/to/image.png"
+     * 2. Data URL: "data:image/png;base64,iVBOR..."
+     * 3. 纯 base64 字符串
+     * 4. HTTP/HTTPS URL: "https://example.com/image.png"
+     *
+     * @param imageInput 图片输入（文件路径、base64、data URL 或 HTTP URL）
+     * @returns base64 编码的图片数据，格式: "image/jpeg;base64,..."
+     */
+    processImageInput(imageInput: string, signal?: AbortSignal): Promise<string>;
+    /**
+     * 检查字符串是否可能是 base64 编码
+     * - 不包含路径分隔符
+     * - 只包含 base64 字符集 (A-Z, a-z, 0-9, +, /, =)
+     * - 长度足够长（至少 100 字符，避免误判短文件名）
+     */
+    private isLikelyBase64;
+    /**
+     * 处理 Data URL 格式的输入
+     */
+    private processDataUrl;
+    /**
+     * 处理纯 base64 字符串
+     * 尝试检测图片类型，如果无法检测则默认使用 image/png
+     */
+    private processRawBase64;
+    /**
+     * 处理 HTTP/HTTPS URL
+     */
+    private processHttpUrl;
+    /**
+     * 处理本地文件路径
+     */
+    private processFilePath;
+    /**
+     * 从 base64 内容检测图片 MIME 类型
+     * 通过检查文件头魔数（magic bytes）来判断
+     */
+    private detectMimeTypeFromBase64;
+    /**
+     * 根据文件扩展名获取 MIME 类型
+     */
+    private getMimeType;
+    /**
+     * 保存图片到本地
+     */
+    saveImage(imageData: ImageGenData, prompt: string, index: number, signal?: AbortSignal): Promise<string>;
+    /**
+     * 从错误中提取错误信息
+     */
+    extractErrorMessage(error: unknown): string;
+    /**
+     * 获取指定 tag 的模型列表
+     */
+    getModelsByTag(product: ProductConfiguration, tag: string): LanguageModel[];
+    /**
+     * 准备请求所需的认证和配置信息
+     */
+    private prepareRequest;
+    /**
+     * 构建基础请求体
+     *
+     * 按模型分发可选字段，避免给后端发送目标模型不支持的字段
+     * （Hunyuan / Gemini 模型不接受 OpenAI-only 字段，发送会触发后端校验失败，
+     * 例如 hunyuan-image-v3.0-art 会返回 14401 "exceeds the maximum supported limit (0)"）：
+     * - OpenAI 模型：支持 n / quality / background / response_format / style
+     * - Hunyuan 模型：仅支持 footnote / revise
+     * - Gemini 模型：仅基础字段（model / prompt / size / image）
+     */
+    private buildBaseRequestBody;
+    /**
+     * 处理 API 响应
+     */
+    private processResponse;
+    /**
+     * 解析模型
+     * 优先级：session options > 环境变量 > 合并设置 > 配置中第一个对应 tag 的模型 > fallback
+     */
+    resolveModel(session: Session | undefined, tag: string): Promise<string>;
+}

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

@@ -0,0 +1,109 @@
+export * from './tool-protocol';
+export * from './produced-artifact';
+export * from './produced-artifact-report';
+export * from './file-change-artifact';
+export * from './file-change-artifact-publisher';
+export * from './auto-mode';
+export * from './tool-search-protocol';
+export * from './tool-search-service';
+export * from './tool-search-tool';
+export * from './tool-manager';
+export * from './deferred-tool-bridge';
+export * from './read-tool';
+export * from './write-tool';
+export * from './edit-tool';
+export * from './bash-tool';
+export * from './glob-tool';
+export * from './grep-tool';
+export * from './todo-write-tool';
+export * from './todo-storage-service';
+export * from './plan-storage-service';
+export * from './memory-tool';
+export * from './web-fetch-tool';
+export * from './web-search-tool';
+export * from './multi-edit-tool';
+export * from './notebook-read-tool';
+export * from './notebook-edit-tool';
+export * from './notebook-write-tool';
+export * from './tool-permission-strategy';
+export * from './agent-tool';
+export * from './task-output-tool';
+export * from './task-storage-service';
+export * from './task-create-tool';
+export * from './task-get-tool';
+export * from './task-update-tool';
+export * from './task-list-tool';
+export * from './tool-argument-rewrite-service';
+export * from './enter-planmode-tool';
+export * from './exit-planmode-tool';
+export * from './bash-output-tool';
+export * from './kill-shell-tool';
+export * from './task-stop-tool';
+export * from './read-file-state-service';
+export * from './slash-command-tool';
+export * from './skill-tool';
+export * from './skill-manage-tool';
+export * from './tool-always-approval-service';
+export * from './tool-hook-manager';
+export * from './tool-permission-service';
+export * from './sandbox-write-rule-guard';
+export * from './ask-user-question-tool';
+export * from './ask-user-for-structured-input-tool';
+export * from './lsp-tool';
+export * from './structured-output-tool';
+export * from './image-gen-tool';
+export * from './defer-tool-config-protocol';
+export * from './defer-tool-config-service';
+export * from './defer-execute-tool';
+export * from './image-edit-tool';
+export * from './image-service';
+export * from './video-gen-tool';
+export * from './video-service';
+export * from './audio-transcribe-tool';
+export * from './audio-transcribe-service';
+export * from './artifact-tool';
+export * from './artifact-control-tool';
+export * from './library-upload-tool';
+export * from './team-create-tool';
+export * from './team-delete-tool';
+export * from './send-message-tool';
+export * from './message-colleague-tool';
+export * from './speak-in-channel-tool';
+export * from './channel-tasks-tool';
+export * from './create-colleague-tool';
+export * from './create-channel-tool';
+export * from './list-colleagues-tool';
+export * from './brief-mode-service';
+export * from './send-user-message-tool';
+export * from './enter-worktree-tool';
+export * from './leave-worktree-tool';
+export * from './cron-create-tool';
+export * from './cron-delete-tool';
+export * from './cron-list-tool';
+export * from './delegate-tool';
+export * from './wechat-reply-tool';
+export * from './wecom-reply-tool';
+export * from './push-notification-tool';
+export * from './powershell-tool';
+export * from './powershell-detection';
+export * from './powershell-security';
+export * from './powershell-command-semantics';
+export * from './powershell-clm-types';
+export * from './powershell-dangerous-cmdlets';
+export * from './powershell-destructive-warning';
+export * from './powershell-git-safety';
+export * from './computer-use-tool';
+export * from './list-mcp-resources-tool';
+export * from './read-mcp-resource-tool';
+export * from './wait-for-mcp-servers-tool';
+export * from './workflow-tool';
+export * from './report-findings-tool';
+export * from './monitor-tool';
+export * from './main-agent-meta-tools';
+export * from './repl';
+export * from './tool-spec';
+export * from './a2a-tool-guards';
+export * from './a2a-get-agent-card-tool';
+export * from './a2a-send-message-tool';
+export * from './a2a-get-task-tool';
+export * from './a2a-cancel-task-tool';

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

@@ -0,0 +1,27 @@
+import type { RunContext } from '@openai/agents';
+import { z } from 'zod';
+import { Session } from '../../vendor/cbc-core/node/index.js';
+import { BaseTool } from './base-tool';
+import { Tool } from './tool-protocol';
+import { ToolNames } from '../../vendor/cbc-shared/node/index.js';
+declare const KillShellParameters: z.ZodObject<{
+    shell_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    shell_id: string;
+}, {
+    shell_id: string;
+}>;
+export declare class KillShellTool extends BaseTool implements Tool {
+    name: ToolNames;
+    aliases: string[];
+    parameters: z.ZodObject<{
+        shell_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        shell_id: string;
+    }, {
+        shell_id: string;
+    }>;
+    execute(input: z.infer<typeof KillShellParameters>, context: RunContext<Session>): Promise<any>;
+    private formatDuration;
+}
+export {};

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

@@ -0,0 +1,54 @@
+/**
+ * LeaveWorktree Agent Tool
+ *
+ * 允许 Agent 在会话中离开当前 worktree 并切换回原始工作目录。
+ * 与 EnterWorktree 对称，确保 worktree 生命周期完整闭环。
+ *
+ * 没有这个 Tool，Agent 完成工作后只能用 Bash 自行组装 git 命令清理 worktree，
+ * 会导致会话状态、工作目录、分支等清理不干净。
+ */
+import { z } from 'zod';
+import { BaseTool } from './base-tool';
+import { Tool, ToolResult } from './tool-protocol';
+import { ToolNames } from '../../vendor/cbc-shared/node/index.js';
+/**
+ * LeaveWorktree 工具参数 schema
+ */
+declare const LeaveWorktreeParameters: z.ZodObject<{
+    action: z.ZodOptional<z.ZodEnum<["keep", "remove"]>>;
+    force: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    force?: boolean | undefined;
+    action?: "keep" | "remove" | undefined;
+}, {
+    force?: boolean | undefined;
+    action?: "keep" | "remove" | undefined;
+}>;
+type LeaveWorktreeInput = z.infer<typeof LeaveWorktreeParameters>;
+export declare class LeaveWorktreeTool extends BaseTool implements Tool {
+    name: ToolNames;
+    description: string;
+    aliases: string[];
+    parameters: z.ZodObject<{
+        action: z.ZodOptional<z.ZodEnum<["keep", "remove"]>>;
+        force: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        force?: boolean | undefined;
+        action?: "keep" | "remove" | undefined;
+    }, {
+        force?: boolean | undefined;
+        action?: "keep" | "remove" | undefined;
+    }>;
+    private worktreeSessionManager;
+    private worktreeChangeDetector?;
+    /**
+     * 权限：始终需要用户确认
+     * 原因：会改变进程工作目录，影响后续所有操作
+     */
+    needsApproval: boolean;
+    /**
+     * 执行离开 worktree
+     */
+    execute(input: LeaveWorktreeInput): Promise<ToolResult>;
+}
+export {};

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

@@ -0,0 +1,70 @@
+import { AuthenticationManager } from '../../workspace/authentication/lib/common/index.js';
+import { Session } from '../../vendor/cbc-core/node/index.js';
+import { ToolArg, ToolNames } from '../../vendor/cbc-shared/node/index.js';
+import { AbTestService, ProductManager } from '../../workspace/product/lib/common/index.js';
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import type { RunContext } from '@openai/agents';
+import { z } from 'zod';
+import { BaseTool } from './base-tool';
+import { type LocalFileFailureCode, type SpaceUploadFailure } from './space-upload';
+import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
+/**
+ * 把本地单个文件上传为资料库节点（首位接口为 SpaceEngine 公开 View API）。
+ *
+ * - 读的是**用户本机**的文件，因此文件访问受 workspace / 信任目录 / `--add-dir` 约束，
+ *   且软链逃逸在发出任何网络请求之前就会被拒绝（见 `space-upload/local-file-source.ts`）。
+ * - 上传后节点保持私有：本工具不设置公开权限，也不生成分享链接（那是 Artifact 的语义）。
+ * - 开关见 `ProductFeature.LibraryUpload`（默认关闭）；endpoint 与登录态在 `isEnabled` 里一并校验。
+ */
+declare const LibraryUploadParameters: z.ZodObject<{
+    path: z.ZodString;
+    file_name: z.ZodOptional<z.ZodString>;
+    parent_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    file_name?: string | undefined;
+    parent_id?: string | undefined;
+}, {
+    path: string;
+    file_name?: string | undefined;
+    parent_id?: string | undefined;
+}>;
+/** 工具契约错误码（对外稳定，见资料库上传方案 §3.3）。 */
+type LibraryUploadErrorCode = LocalFileFailureCode | 'UNAUTHENTICATED' | 'ENDPOINT_UNAVAILABLE' | 'UNSUPPORTED_FILE_TYPE' | 'FILE_TOO_LARGE' | 'CAPACITY_EXCEEDED' | 'CONTENT_BLOCKED' | 'PERMISSION_DENIED' | 'UPLOAD_FAILED' | 'IMPORT_FAILED' | 'IMPORT_STATUS_UNKNOWN' | 'TIMEOUT';
+/** 把 `space-upload` 的失败映射成工具契约错误码与用户文案（导出以便表驱动测试）。 */
+export declare function mapUploadFailure(failure: SpaceUploadFailure): {
+    code: LibraryUploadErrorCode;
+    retryable: boolean;
+    message: string;
+};
+export declare class LibraryUploadTool extends BaseTool implements Tool {
+    protected readonly authManager: AuthenticationManager;
+    protected readonly productManager: ProductManager;
+    protected readonly abTestService?: AbTestService;
+    protected readonly logger: Logger;
+    name: ToolNames;
+    description: string;
+    parameters: z.ZodObject<{
+        path: z.ZodString;
+        file_name: z.ZodOptional<z.ZodString>;
+        parent_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        file_name?: string | undefined;
+        parent_id?: string | undefined;
+    }, {
+        path: string;
+        file_name?: string | undefined;
+        parent_id?: string | undefined;
+    }>;
+    argumentRenderer: ToolCallArgumentRenderer;
+    isEnabled: () => Promise<boolean>;
+    resolveNeedPermissionArgs(_runContext: RunContext, input: z.infer<typeof LibraryUploadParameters>, _callId?: string): ToolArg[];
+    /**
+     * Auto mode classifier projection：文件路径 + 「持久化上传到资料库」的目的。
+     * 文件内容不进投影（大文件无法在分类器里展开）。
+     */
+    toAutoClassifierInput(input: unknown): string;
+    execute(input: z.infer<typeof LibraryUploadParameters>, _context: RunContext<Session>): Promise<ToolResult>;
+}
+export {};

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

@@ -0,0 +1,35 @@
+/**
+ * ListColleagues —— Agent Home 通讯录：现有同事 + 频道，都带 id。
+ *
+ * 为什么必须有它：CreateChannel 要 `memberAgentIds`（id），ChannelTasks / SpeakInChannel
+ * 要 `channel`（id），而注入的组队提示为了省 token 会把名册截断（`(+N more)`）——
+ * 模型拿不到后面的 id，就只能猜、把已有同事重复建一遍，或者干脆卡住问用户。
+ * 一次调用把「有谁、在哪几个频道、谁是 lead」给全。
+ *
+ * 只读：走 channelsForSelf（和工具口径一致），不拿目录锁。
+ */
+import type { Session } from '../../vendor/cbc-core/node/index.js';
+import type { RunContext } from '../../vendor/cbc-shared/node/index.js';
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { z } from 'zod';
+import { SettingsManager } from '../settings/settings-protocol';
+import { BaseTool } from './base-tool';
+import { Tool, ToolCallArgumentRenderer, ToolNames, ToolResult } from './tool-protocol';
+export declare class ListColleaguesTool extends BaseTool implements Tool {
+    protected readonly logger: Logger;
+    protected readonly settingsManager?: SettingsManager;
+    name: ToolNames;
+    description: string;
+    needsApproval: boolean;
+    shouldShowInToolSearch: () => boolean;
+    parameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    argumentRenderer: ToolCallArgumentRenderer;
+    toAutoClassifierInput(_input: unknown): string;
+    isEnabled: (args?: {
+        runContext?: RunContext<Session>;
+        agent?: {
+            name?: string;
+        };
+    }) => Promise<boolean>;
+    execute(_input: unknown, context?: RunContext<Session>): Promise<ToolResult>;
+}

package/cli/dist-server/types/node/tools/list-mcp-resources-tool.d.ts

@@ -0,0 +1,58 @@
+import { Logger } from '@celljs/core';
+import { Session } from '../../vendor/cbc-core/node/index.js';
+import { RunContext, ToolNames } from '../../vendor/cbc-shared/node/index.js';
+import { z } from 'zod';
+import { McpResourceCatalogService } from '../mcp/mcp-resource-catalog-protocol';
+import { BaseTool } from './base-tool';
+import { Tool, ToolCallArgumentRenderer, ToolResult } from './tool-protocol';
+declare const ListMcpResourcesParameters: z.ZodObject<{
+    server: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    server?: string | undefined;
+}, {
+    server?: string | undefined;
+}>;
+type ListMcpResourcesInput = z.infer<typeof ListMcpResourcesParameters>;
+/**
+ * ListMcpResources — list all resources/templates exposed by connected MCP
+ * servers.
+ *
+ * Pairs with `ReadMcpResource`. The two-tool split (vs. the previous single
+ * `FetchMcpResource` that baked the resource catalog into its description)
+ * keeps the system prompt small even when an MCP server exposes many
+ * resources, and matches the upstream Claude Code naming convention
+ * (ListMcpResourcesTool / ReadMcpResourceTool). Issue #40458.
+ */
+export declare class ListMcpResourcesTool extends BaseTool implements Tool {
+    protected readonly catalogService: McpResourceCatalogService;
+    protected readonly logger: Logger;
+    name: ToolNames;
+    description: string;
+    parameters: z.ZodObject<{
+        server: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        server?: string | undefined;
+    }, {
+        server?: string | undefined;
+    }>;
+    argumentRenderer: ToolCallArgumentRenderer;
+    /** Read-only — no approval needed. */
+    needsApproval: boolean;
+    /**
+     * Enable the tool when a connected server declares the `resources`
+     * capability, rather than when a live listing happens to return rows.
+     *
+     * Issue #102572: the old gate counted actual resources, so an 8s
+     * `resources/list` timeout on one slow server (企查查 connector) collapsed
+     * the count to zero and removed this tool — and ReadMcpResource with it —
+     * from the model's tool list mid-session, restoring it on the next turn.
+     * Observed gaps between a successful and a failing listing ranged from
+     * milliseconds to four hours, so no cache window can paper over it. The
+     * capability is captured during `initialize` and read from memory, so it
+     * cannot time out and stays stable for the life of the connection.
+     */
+    isEnabled: () => Promise<boolean>;
+    execute(input: ListMcpResourcesInput, _context: RunContext<Session>): Promise<ToolResult>;
+}
+export { ListMcpResourcesParameters };
+export type { ListMcpResourcesInput };

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

@@ -0,0 +1,68 @@
+/**
+ * LSP Tool - 与 LSP 服务器交互以获取代码智能功能
+ */
+import { Session } from '../../vendor/cbc-core/node/index.js';
+import { RunContext, ToolNames } from '../../vendor/cbc-shared/node/index.js';
+import { Workspace } from '../../workspace/runtime/lib/common/index.js';
+import { Logger } from '../../workspace/telemetry/lib/common/index.js';
+import { z } from 'zod';
+import { LSPManager } from '../lsp';
+import { BaseTool } from './base-tool';
+import { Tool, ToolResult } from './tool-protocol';
+declare const LspParameters: z.ZodObject<{
+    operation: z.ZodEnum<["goToDefinition", "findReferences", "hover", "documentSymbol", "workspaceSymbol", "goToImplementation", "prepareCallHierarchy", "incomingCalls", "outgoingCalls"]>;
+    filePath: z.ZodString;
+    line: z.ZodNumber;
+    character: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    operation: "goToDefinition" | "findReferences" | "hover" | "documentSymbol" | "workspaceSymbol" | "goToImplementation" | "prepareCallHierarchy" | "incomingCalls" | "outgoingCalls";
+    filePath: string;
+    line: number;
+    character: number;
+}, {
+    operation: "goToDefinition" | "findReferences" | "hover" | "documentSymbol" | "workspaceSymbol" | "goToImplementation" | "prepareCallHierarchy" | "incomingCalls" | "outgoingCalls";
+    filePath: string;
+    line: number;
+    character: number;
+}>;
+export declare class LspTool extends BaseTool implements Tool {
+    protected readonly logger: Logger;
+    protected readonly workspace: Workspace;
+    protected readonly lspManager: LSPManager;
+    name: ToolNames;
+    aliases: string[];
+    description: string;
+    parameters: z.ZodObject<{
+        operation: z.ZodEnum<["goToDefinition", "findReferences", "hover", "documentSymbol", "workspaceSymbol", "goToImplementation", "prepareCallHierarchy", "incomingCalls", "outgoingCalls"]>;
+        filePath: z.ZodString;
+        line: z.ZodNumber;
+        character: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        operation: "goToDefinition" | "findReferences" | "hover" | "documentSymbol" | "workspaceSymbol" | "goToImplementation" | "prepareCallHierarchy" | "incomingCalls" | "outgoingCalls";
+        filePath: string;
+        line: number;
+        character: number;
+    }, {
+        operation: "goToDefinition" | "findReferences" | "hover" | "documentSymbol" | "workspaceSymbol" | "goToImplementation" | "prepareCallHierarchy" | "incomingCalls" | "outgoingCalls";
+        filePath: string;
+        line: number;
+        character: number;
+    }>;
+    private readonly MAX_RESULTS;
+    execute(input: z.infer<typeof LspParameters>, context: RunContext<Session>): Promise<ToolResult>;
+    /**
+     * 执行 LSP 操作
+     */
+    private performOperation;
+    private goToDefinition;
+    private findReferences;
+    private hover;
+    private documentSymbol;
+    private workspaceSymbol;
+    private goToImplementation;
+    private prepareCallHierarchy;
+    private callHierarchy;
+    private formatSymbols;
+    private getSymbolKindName;
+}
+export {};