@seastudio/sdk 3.0.0

package/dist/mcp/core/index.d.ts

@@ -0,0 +1,124 @@
+import { j as MCPToolInputSchema, g as MCPTool, b as JSONRPCMessage, k as MCPToolResult, N as NotificationHandler, d as JSONRPCRequest, e as JSONRPCResponse } from '../../types-Clgf5gBf.js';
+export { F as FileItem, a as FileNode, J as JSONRPCError, c as JSONRPCNotification, M as MCPMessageEnvelope, f as MCPMethod, h as MCPToolAnnotations, i as MCPToolCallRequest, P as PublishParams, S as SubscribeParams, l as createNotification, m as createRequest, n as createResponse, o as isMCPMessage, p as isNotification } from '../../types-Clgf5gBf.js';
+
+interface NormalizeMCPToolInputSchemaOptions {
+    defaultType?: MCPToolInputSchema['type'];
+}
+declare function normalizeMCPToolInputSchema(schema?: MCPToolInputSchema, options?: NormalizeMCPToolInputSchemaOptions): MCPToolInputSchema;
+declare function normalizeMCPToolObjectSchema(schema?: MCPToolInputSchema): MCPToolInputSchema;
+declare function normalizeMCPTool(tool: MCPTool): MCPTool;
+
+/**
+ * MCP Transport Layer
+ *
+ * 基于 postMessage 的 JSON-RPC 2.0 传输层
+ */
+
+interface MCPTransport {
+    send(message: JSONRPCMessage): void;
+    onMessage(handler: (message: JSONRPCMessage) => void): () => void;
+    destroy(): void;
+}
+interface PostMessageTransportOptions {
+    target?: Window;
+    origin?: string;
+}
+declare class PostMessageTransport implements MCPTransport {
+    private target;
+    private origin;
+    private handlers;
+    private messageListener;
+    constructor(options?: PostMessageTransportOptions);
+    private setupListener;
+    send(message: JSONRPCMessage): void;
+    onMessage(handler: (message: JSONRPCMessage) => void): () => void;
+    destroy(): void;
+}
+declare function getDefaultTransport(): MCPTransport;
+declare function setDefaultTransport(transport: MCPTransport): void;
+
+/**
+ * MCP Client
+ *
+ * 插件侧使用的 MCP 客户端
+ */
+
+interface MCPClientOptions {
+    transport?: MCPTransport;
+    timeout?: number;
+}
+interface MCPRequestOptions {
+    timeout?: number;
+}
+declare class MCPClient {
+    private transport;
+    private timeout;
+    private pendingRequests;
+    private notificationHandlers;
+    private unsubscribe;
+    constructor(options?: MCPClientOptions);
+    private setupResponseHandler;
+    private handleNotification;
+    request<T = unknown>(method: string, params?: Record<string, unknown>, options?: MCPRequestOptions): Promise<T>;
+    private resolveToolCallTimeout;
+    callTool(name: string, args?: Record<string, unknown>, options?: MCPRequestOptions): Promise<MCPToolResult>;
+    callToolText(name: string, args?: Record<string, unknown>, options?: MCPRequestOptions): Promise<string>;
+    ping(): Promise<boolean>;
+    subscribe(topics: string[]): Promise<void>;
+    unsubscribeTopics(topics: string[]): Promise<void>;
+    publish(topic: string, data?: Record<string, unknown>): Promise<void>;
+    onNotification(topic: string, handler: NotificationHandler): () => void;
+    offNotification(topic: string, handler?: NotificationHandler): void;
+    destroy(): void;
+}
+declare function createMCPClient(options?: MCPClientOptions): MCPClient;
+declare function getDefaultClient(): MCPClient;
+declare function setDefaultClient(client: MCPClient): void;
+/**
+ * 调用 Host 提供的 MCP 工具（便捷函数）
+ *
+ * 使用默认客户端调用工具，适合在插件中直接使用。
+ *
+ * @example
+ * ```ts
+ * import { callHostTool } from '@seastudio/sdk';
+ *
+ * const result = await callHostTool('seastudio-project_get_path', {});
+ * const data = JSON.parse(result.content[0].text);
+ * ```
+ */
+declare function callHostTool(toolName: string, args?: Record<string, unknown>): Promise<MCPToolResult>;
+/**
+ * 调用 Host 提供的 MCP 工具并返回文本结果（便捷函数）
+ *
+ * 如果调用出错会抛出异常。
+ */
+declare function callHostToolText(toolName: string, args?: Record<string, unknown>): Promise<string>;
+
+/**
+ * MCP Server (Plugin Side)
+ *
+ * 插件端的 MCP Server，用于处理来自 Host 的 tools/call 请求
+ */
+
+type MCPToolHandler = (args: Record<string, unknown>) => Promise<MCPToolResult> | MCPToolResult;
+declare class MCPServer {
+    private tools;
+    private notificationHandlers;
+    private unsubscribe;
+    registerTool(definition: MCPTool, handler: MCPToolHandler): void;
+    registerTools(definitions: MCPTool[], handlers: Record<string, MCPToolHandler>): void;
+    getTools(): MCPTool[];
+    handleMessage(request: JSONRPCRequest): Promise<JSONRPCResponse | null>;
+    sendNotification(method: string, params?: Record<string, unknown>): void;
+    onNotification(topic: string, handler: NotificationHandler): () => void;
+    offNotification(topic: string, handler?: NotificationHandler): void;
+    private handleNotification;
+    start(): void;
+    stop(): void;
+}
+declare function createMCPServer(): MCPServer;
+declare function getDefaultServer(): MCPServer;
+declare function startDefaultServer(): void;
+
+export { JSONRPCMessage, JSONRPCRequest, JSONRPCResponse, MCPClient, type MCPClientOptions, type MCPRequestOptions, MCPServer, MCPTool, type MCPToolHandler, MCPToolInputSchema, MCPToolResult, type MCPTransport, type NormalizeMCPToolInputSchemaOptions, NotificationHandler, PostMessageTransport, type PostMessageTransportOptions, callHostTool, callHostToolText, createMCPClient, createMCPServer, getDefaultClient, getDefaultServer, getDefaultTransport, normalizeMCPTool, normalizeMCPToolInputSchema, normalizeMCPToolObjectSchema, setDefaultClient, setDefaultTransport, startDefaultServer };

package/dist/mcp/core/index.js

@@ -0,0 +1 @@
+export { MCPClient, MCPServer, PostMessageTransport, callHostTool, callHostToolText, createMCPClient, createMCPServer, createNotification, createRequest, createResponse, getDefaultClient, getDefaultServer, getDefaultTransport, isMCPMessage, isNotification, normalizeMCPTool, normalizeMCPToolInputSchema, normalizeMCPToolObjectSchema, setDefaultClient, setDefaultTransport, startDefaultServer } from '../../chunk-ANWOL7SM.js';

package/dist/mcp/index.cjs

@@ -0,0 +1,317 @@
+'use strict';
+
+var chunkN33Y5NY7_cjs = require('../chunk-N33Y5NY7.cjs');
+var chunkCVF4QHS6_cjs = require('../chunk-CVF4QHS6.cjs');
+var chunkAGBZJGTY_cjs = require('../chunk-AGBZJGTY.cjs');
+var chunkISI2OLPI_cjs = require('../chunk-ISI2OLPI.cjs');
+var chunkSNGU4SHO_cjs = require('../chunk-SNGU4SHO.cjs');
+var chunkMYURVLGP_cjs = require('../chunk-MYURVLGP.cjs');
+var chunkHJJTBVKQ_cjs = require('../chunk-HJJTBVKQ.cjs');
+var chunkTFOJLA2F_cjs = require('../chunk-TFOJLA2F.cjs');
+
+
+
+Object.defineProperty(exports, "MCP_PACKAGES", {
+  enumerable: true,
+  get: function () { return chunkN33Y5NY7_cjs.MCP_PACKAGES; }
+});
+Object.defineProperty(exports, "getMCPPackageIdForTool", {
+  enumerable: true,
+  get: function () { return chunkN33Y5NY7_cjs.getMCPPackageIdForTool; }
+});
+Object.defineProperty(exports, "getMCPPackages", {
+  enumerable: true,
+  get: function () { return chunkN33Y5NY7_cjs.getMCPPackages; }
+});
+Object.defineProperty(exports, "getMCPToolPackageIndex", {
+  enumerable: true,
+  get: function () { return chunkN33Y5NY7_cjs.getMCPToolPackageIndex; }
+});
+Object.defineProperty(exports, "getToolsForLLM", {
+  enumerable: true,
+  get: function () { return chunkN33Y5NY7_cjs.getToolsForLLM; }
+});
+Object.defineProperty(exports, "listAllTools", {
+  enumerable: true,
+  get: function () { return chunkN33Y5NY7_cjs.listAllTools; }
+});
+Object.defineProperty(exports, "listAvailableTools", {
+  enumerable: true,
+  get: function () { return chunkN33Y5NY7_cjs.listAvailableTools; }
+});
+Object.defineProperty(exports, "listAvailableToolsForLLM", {
+  enumerable: true,
+  get: function () { return chunkN33Y5NY7_cjs.listAvailableToolsForLLM; }
+});
+Object.defineProperty(exports, "loadPlugin", {
+  enumerable: true,
+  get: function () { return chunkN33Y5NY7_cjs.loadPlugin; }
+});
+Object.defineProperty(exports, "mcpToolToOpenAI", {
+  enumerable: true,
+  get: function () { return chunkN33Y5NY7_cjs.mcpToolToOpenAI; }
+});
+Object.defineProperty(exports, "excel", {
+  enumerable: true,
+  get: function () { return chunkCVF4QHS6_cjs.excel; }
+});
+Object.defineProperty(exports, "excelAllTools", {
+  enumerable: true,
+  get: function () { return chunkCVF4QHS6_cjs.allTools; }
+});
+Object.defineProperty(exports, "excelLifecycleTools", {
+  enumerable: true,
+  get: function () { return chunkCVF4QHS6_cjs.lifecycleTools; }
+});
+Object.defineProperty(exports, "excelMutateTools", {
+  enumerable: true,
+  get: function () { return chunkCVF4QHS6_cjs.mutateTools; }
+});
+Object.defineProperty(exports, "excelReadTools", {
+  enumerable: true,
+  get: function () { return chunkCVF4QHS6_cjs.readTools; }
+});
+Object.defineProperty(exports, "excelTools", {
+  enumerable: true,
+  get: function () { return chunkCVF4QHS6_cjs.tools; }
+});
+Object.defineProperty(exports, "SeastudioNotifications", {
+  enumerable: true,
+  get: function () { return chunkAGBZJGTY_cjs.SeastudioNotifications; }
+});
+Object.defineProperty(exports, "SeastudioRequests", {
+  enumerable: true,
+  get: function () { return chunkAGBZJGTY_cjs.SeastudioRequests; }
+});
+Object.defineProperty(exports, "agentManagementTools", {
+  enumerable: true,
+  get: function () { return chunkAGBZJGTY_cjs.agentManagementTools; }
+});
+Object.defineProperty(exports, "agentTabTools", {
+  enumerable: true,
+  get: function () { return chunkAGBZJGTY_cjs.agentTabTools; }
+});
+Object.defineProperty(exports, "batchFileTools", {
+  enumerable: true,
+  get: function () { return chunkAGBZJGTY_cjs.batchFileTools; }
+});
+Object.defineProperty(exports, "clipboardTools", {
+  enumerable: true,
+  get: function () { return chunkAGBZJGTY_cjs.clipboardTools; }
+});
+Object.defineProperty(exports, "codeQualityTools", {
+  enumerable: true,
+  get: function () { return chunkAGBZJGTY_cjs.codeQualityTools; }
+});
+Object.defineProperty(exports, "fileTools", {
+  enumerable: true,
+  get: function () { return chunkAGBZJGTY_cjs.fileTools; }
+});
+Object.defineProperty(exports, "gitTools", {
+  enumerable: true,
+  get: function () { return chunkAGBZJGTY_cjs.gitTools; }
+});
+Object.defineProperty(exports, "pluginManagementTools", {
+  enumerable: true,
+  get: function () { return chunkAGBZJGTY_cjs.pluginManagementTools; }
+});
+Object.defineProperty(exports, "pluginTabTools", {
+  enumerable: true,
+  get: function () { return chunkAGBZJGTY_cjs.pluginTabTools; }
+});
+Object.defineProperty(exports, "seastudio", {
+  enumerable: true,
+  get: function () { return chunkAGBZJGTY_cjs.seastudio; }
+});
+Object.defineProperty(exports, "seastudioAllTools", {
+  enumerable: true,
+  get: function () { return chunkAGBZJGTY_cjs.allTools; }
+});
+Object.defineProperty(exports, "seastudioTools", {
+  enumerable: true,
+  get: function () { return chunkAGBZJGTY_cjs.tools; }
+});
+Object.defineProperty(exports, "shellTools", {
+  enumerable: true,
+  get: function () { return chunkAGBZJGTY_cjs.shellTools; }
+});
+Object.defineProperty(exports, "shellPlugin", {
+  enumerable: true,
+  get: function () { return chunkISI2OLPI_cjs.shellPlugin; }
+});
+Object.defineProperty(exports, "shellPluginCommandTools", {
+  enumerable: true,
+  get: function () { return chunkISI2OLPI_cjs.commandTools; }
+});
+Object.defineProperty(exports, "shellPluginSessionTools", {
+  enumerable: true,
+  get: function () { return chunkISI2OLPI_cjs.sessionTools; }
+});
+Object.defineProperty(exports, "shellPluginTools", {
+  enumerable: true,
+  get: function () { return chunkISI2OLPI_cjs.tools; }
+});
+Object.defineProperty(exports, "editor", {
+  enumerable: true,
+  get: function () { return chunkSNGU4SHO_cjs.editor; }
+});
+Object.defineProperty(exports, "editorAllTools", {
+  enumerable: true,
+  get: function () { return chunkSNGU4SHO_cjs.allTools; }
+});
+Object.defineProperty(exports, "editorExtensionTools", {
+  enumerable: true,
+  get: function () { return chunkSNGU4SHO_cjs.extensionTools; }
+});
+Object.defineProperty(exports, "editorFileMutationTools", {
+  enumerable: true,
+  get: function () { return chunkSNGU4SHO_cjs.fileMutationTools; }
+});
+Object.defineProperty(exports, "editorPreviewTools", {
+  enumerable: true,
+  get: function () { return chunkSNGU4SHO_cjs.previewTools; }
+});
+Object.defineProperty(exports, "editorProposalTools", {
+  enumerable: true,
+  get: function () { return chunkSNGU4SHO_cjs.proposalTools; }
+});
+Object.defineProperty(exports, "editorReferenceTools", {
+  enumerable: true,
+  get: function () { return chunkSNGU4SHO_cjs.referenceTools; }
+});
+Object.defineProperty(exports, "editorSessionTools", {
+  enumerable: true,
+  get: function () { return chunkSNGU4SHO_cjs.sessionTools; }
+});
+Object.defineProperty(exports, "editorTools", {
+  enumerable: true,
+  get: function () { return chunkSNGU4SHO_cjs.tools; }
+});
+Object.defineProperty(exports, "fileOperationTools", {
+  enumerable: true,
+  get: function () { return chunkSNGU4SHO_cjs.fileOperationTools; }
+});
+Object.defineProperty(exports, "preview", {
+  enumerable: true,
+  get: function () { return chunkMYURVLGP_cjs.preview; }
+});
+Object.defineProperty(exports, "previewCoreTools", {
+  enumerable: true,
+  get: function () { return chunkMYURVLGP_cjs.coreTools; }
+});
+Object.defineProperty(exports, "previewEnhancedTools", {
+  enumerable: true,
+  get: function () { return chunkMYURVLGP_cjs.enhancedTools; }
+});
+Object.defineProperty(exports, "previewTools", {
+  enumerable: true,
+  get: function () { return chunkMYURVLGP_cjs.tools; }
+});
+Object.defineProperty(exports, "seaflow", {
+  enumerable: true,
+  get: function () { return chunkHJJTBVKQ_cjs.seaflow; }
+});
+Object.defineProperty(exports, "seaflowAllTools", {
+  enumerable: true,
+  get: function () { return chunkHJJTBVKQ_cjs.allTools; }
+});
+Object.defineProperty(exports, "seaflowCanvasAuthTools", {
+  enumerable: true,
+  get: function () { return chunkHJJTBVKQ_cjs.canvasAuthTools; }
+});
+Object.defineProperty(exports, "seaflowCanvasContextTools", {
+  enumerable: true,
+  get: function () { return chunkHJJTBVKQ_cjs.canvasContextTools; }
+});
+Object.defineProperty(exports, "seaflowCanvasExecutionTools", {
+  enumerable: true,
+  get: function () { return chunkHJJTBVKQ_cjs.canvasExecutionTools; }
+});
+Object.defineProperty(exports, "seaflowTools", {
+  enumerable: true,
+  get: function () { return chunkHJJTBVKQ_cjs.tools; }
+});
+Object.defineProperty(exports, "MCPClient", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.MCPClient; }
+});
+Object.defineProperty(exports, "MCPServer", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.MCPServer; }
+});
+Object.defineProperty(exports, "PostMessageTransport", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.PostMessageTransport; }
+});
+Object.defineProperty(exports, "callHostTool", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.callHostTool; }
+});
+Object.defineProperty(exports, "callHostToolText", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.callHostToolText; }
+});
+Object.defineProperty(exports, "createMCPClient", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.createMCPClient; }
+});
+Object.defineProperty(exports, "createMCPServer", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.createMCPServer; }
+});
+Object.defineProperty(exports, "createNotification", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.createNotification; }
+});
+Object.defineProperty(exports, "createRequest", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.createRequest; }
+});
+Object.defineProperty(exports, "createResponse", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.createResponse; }
+});
+Object.defineProperty(exports, "getDefaultClient", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.getDefaultClient; }
+});
+Object.defineProperty(exports, "getDefaultServer", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.getDefaultServer; }
+});
+Object.defineProperty(exports, "getDefaultTransport", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.getDefaultTransport; }
+});
+Object.defineProperty(exports, "isMCPMessage", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.isMCPMessage; }
+});
+Object.defineProperty(exports, "isNotification", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.isNotification; }
+});
+Object.defineProperty(exports, "normalizeMCPTool", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.normalizeMCPTool; }
+});
+Object.defineProperty(exports, "normalizeMCPToolInputSchema", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.normalizeMCPToolInputSchema; }
+});
+Object.defineProperty(exports, "normalizeMCPToolObjectSchema", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.normalizeMCPToolObjectSchema; }
+});
+Object.defineProperty(exports, "setDefaultClient", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.setDefaultClient; }
+});
+Object.defineProperty(exports, "setDefaultTransport", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.setDefaultTransport; }
+});
+Object.defineProperty(exports, "startDefaultServer", {
+  enumerable: true,
+  get: function () { return chunkTFOJLA2F_cjs.startDefaultServer; }
+});

package/dist/mcp/index.d.cts

@@ -0,0 +1,123 @@
+import { k as MCPToolResult, g as MCPTool, h as MCPToolAnnotations, j as MCPToolInputSchema } from '../types-Clgf5gBf.cjs';
+export { F as FileItem, a as FileNode, J as JSONRPCError, b as JSONRPCMessage, c as JSONRPCNotification, d as JSONRPCRequest, e as JSONRPCResponse, M as MCPMessageEnvelope, f as MCPMethod, i as MCPToolCallRequest, N as NotificationHandler, P as PublishParams, S as SubscribeParams, l as createNotification, m as createRequest, n as createResponse, o as isMCPMessage, p as isNotification } from '../types-Clgf5gBf.cjs';
+export { MCPClient, MCPClientOptions, MCPRequestOptions, MCPServer, MCPToolHandler, MCPTransport, NormalizeMCPToolInputSchemaOptions, PostMessageTransport, PostMessageTransportOptions, callHostTool, callHostToolText, createMCPClient, createMCPServer, getDefaultClient, getDefaultServer, getDefaultTransport, normalizeMCPTool, normalizeMCPToolInputSchema, normalizeMCPToolObjectSchema, setDefaultClient, setDefaultTransport, startDefaultServer } from './core/index.cjs';
+export { FileModifiedParams, FileOpenRequestedParams, FileSavedParams, FileSendRequestedParams, FilesChangedParams, RootsChangedParams, SeastudioDragDropParams, SeastudioDragEnterParams, SeastudioDragFileData, SeastudioDragRootId, SeastudioDragStartParams, SeastudioFileDownloadOptions, SeastudioFileTreeOptions, SeastudioNotifications, SeastudioRequests, TextSendRequestedParams, agentManagementTools, agentTabTools, batchFileTools, clipboardTools, codeQualityTools, fileTools, gitTools, pluginManagementTools, pluginTabTools, seastudio, allTools as seastudioAllTools, tools as seastudioTools, shellTools } from './seastudio/index.cjs';
+export { CodeSearchMatch, CodeSearchResult, EditorFileInfo, LintResult, TestResult, TypecheckResult, editor, allTools as editorAllTools, extensionTools as editorExtensionTools, fileMutationTools as editorFileMutationTools, previewTools as editorPreviewTools, proposalTools as editorProposalTools, referenceTools as editorReferenceTools, sessionTools as editorSessionTools, tools as editorTools, fileOperationTools } from './plugin-editor/index.cjs';
+export { PreviewBatchEntry, PreviewBatchGetResponse, PreviewBatchItem, PreviewBatchResult, PreviewCapability, PreviewCompareVersionsResult, PreviewGetResponse, PreviewMetadata, PreviewMode, PreviewThumbnail, RenderKind, preview, coreTools as previewCoreTools, enhancedTools as previewEnhancedTools, tools as previewTools } from './plugin-preview/index.cjs';
+export { CanvasBatchApplyResult, CanvasEdgeListItem, CanvasEdgeListResult, CanvasExecutionAuthSnapshot, CanvasExecutionAuthState, CanvasExecutionPersistMode, CanvasExecutionTaskState, CanvasNodeDetailResult, CanvasNodeOutputsResult, CanvasNodeValidationResult, CanvasTaskListItem, CanvasTaskListResult, CanvasTaskStatus, CanvasTaskWaitResult, seaflow, allTools as seaflowAllTools, canvasAuthTools as seaflowCanvasAuthTools, canvasContextTools as seaflowCanvasContextTools, canvasExecutionTools as seaflowCanvasExecutionTools, tools as seaflowTools } from './plugin-seaflow/index.cjs';
+export { ExcelContext, ExcelFindMatch, ExcelSelectionInfo, ExcelSheetInfo, ExcelStats, excel, allTools as excelAllTools, lifecycleTools as excelLifecycleTools, mutateTools as excelMutateTools, readTools as excelReadTools, tools as excelTools } from './plugin-excel/index.cjs';
+
+/**
+ * Shell Plugin MCP Tools
+ *
+ * Shell 插件提供的 MCP Tools
+ */
+
+declare const sessionTools: MCPTool[];
+declare const commandTools: MCPTool[];
+declare const tools: MCPTool[];
+declare const shellPlugin: {
+    getSession: () => Promise<MCPToolResult>;
+    getEntries: (limit?: number) => Promise<MCPToolResult>;
+    runCommand: (command: string, cwd?: string, timeout?: number) => Promise<MCPToolResult>;
+    setCwd: (cwd: string) => Promise<MCPToolResult>;
+    clearOutput: () => Promise<MCPToolResult>;
+    resetSession: () => Promise<MCPToolResult>;
+};
+
+/**
+ * MCP Module Entry
+ *
+ * MCP 信息交换中心入口
+ */
+
+declare function loadPlugin(pluginName: string): Promise<unknown>;
+
+/**
+ * MCP 包定义
+ */
+declare const MCP_PACKAGES: readonly [{
+    readonly id: "seastudio";
+    readonly name: "SeaStudio";
+    readonly description: "文件/Shell/Git 基础能力";
+    readonly tools: MCPTool[];
+}, {
+    readonly id: "codeEditor";
+    readonly name: "Code Editor";
+    readonly description: "代码编辑器能力";
+    readonly tools: MCPTool[];
+}, {
+    readonly id: "preview";
+    readonly name: "Preview";
+    readonly description: "预览器能力";
+    readonly tools: MCPTool[];
+}, {
+    readonly id: "seaflow";
+    readonly name: "SeaFlow";
+    readonly description: "流程画布执行与编排能力";
+    readonly tools: MCPTool[];
+}, {
+    readonly id: "shell";
+    readonly name: "Shell";
+    readonly description: "Shell 会话与命令执行能力";
+    readonly tools: MCPTool[];
+}, {
+    readonly id: "excel";
+    readonly name: "Excel";
+    readonly description: "Excel 电子表格操作能力";
+    readonly tools: MCPTool[];
+}];
+type MCPPackageId = (typeof MCP_PACKAGES)[number]['id'];
+interface MCPPackageInfo {
+    id: MCPPackageId;
+    name: string;
+    description: string;
+    toolCount: number;
+}
+/**
+ * OpenAI function 格式的工具定义
+ */
+type MCPToolCapabilityRisk = 'low' | 'medium' | 'high';
+interface MCPToolCapabilityMetadata {
+    id: string;
+    risk: MCPToolCapabilityRisk;
+    preconditions?: string[];
+    successSignals?: Array<Record<string, unknown>>;
+    failureCodes?: string[];
+}
+interface OpenAITool {
+    type: 'function';
+    annotations?: MCPToolAnnotations;
+    outputSchema?: MCPToolInputSchema;
+    function: {
+        name: string;
+        description: string;
+        parameters: MCPToolInputSchema;
+        outputSchema?: MCPToolInputSchema;
+    };
+}
+/**
+ * 将 MCP Tool 转换为 OpenAI function 格式
+ */
+declare function mcpToolToOpenAI(tool: MCPTool): OpenAITool;
+/**
+ * 获取所有 MCP Tools
+ */
+declare function listAllTools(): MCPTool[];
+/**
+ * @deprecated 使用 listAllTools() 替代
+ */
+declare const listAvailableTools: typeof listAllTools;
+declare function getMCPToolPackageIndex(): Map<string, MCPPackageId>;
+declare function getMCPPackageIdForTool(toolName: string): MCPPackageId | null;
+declare function listAvailableToolsForLLM(): OpenAITool[];
+/**
+ * 获取包列表（含工具数量，静态获取）
+ */
+declare function getMCPPackages(): MCPPackageInfo[];
+/**
+ * 根据启用的包获取工具列表（OpenAI 格式）
+ */
+declare function getToolsForLLM(disabledPackages: Set<MCPPackageId>): OpenAITool[];
+
+export { type MCPPackageId, type MCPPackageInfo, MCPTool, MCPToolAnnotations, type MCPToolCapabilityMetadata, type MCPToolCapabilityRisk, MCPToolInputSchema, MCPToolResult, MCP_PACKAGES, type OpenAITool, getMCPPackageIdForTool, getMCPPackages, getMCPToolPackageIndex, getToolsForLLM, listAllTools, listAvailableTools, listAvailableToolsForLLM, loadPlugin, mcpToolToOpenAI, shellPlugin, commandTools as shellPluginCommandTools, sessionTools as shellPluginSessionTools, tools as shellPluginTools };