@seastudio/sdk 3.0.0

package/dist/mcp/seastudio/index.d.cts

@@ -0,0 +1,341 @@
+import { g as MCPTool, k as MCPToolResult, h as MCPToolAnnotations, j as MCPToolInputSchema } from '../../types-Clgf5gBf.cjs';
+
+/**
+ * Plugin MCP Tools
+ *
+ * 插件管理 + 插件标签操作
+ */
+
+declare const pluginManagementTools: MCPTool[];
+declare const pluginTabTools: MCPTool[];
+
+/**
+ * Agent MCP Tools
+ *
+ * Agent 管理 + Agent 标签操作
+ */
+
+declare const agentManagementTools: MCPTool[];
+declare const agentTabTools: MCPTool[];
+
+/**
+ * SeaStudio MCP Tools
+ *
+ * 主程序基础能力：file, shell, git
+ */
+
+type SeastudioFilesystemRootId = 'workspace';
+interface SeastudioFilesystemRoot {
+    id: SeastudioFilesystemRootId;
+    label: string;
+    description: string;
+}
+interface SeastudioFileInfo {
+    rootId: SeastudioFilesystemRootId;
+    path: string;
+    name: string;
+    type: 'file' | 'directory';
+    size: number;
+    mtime: number;
+    modified: number;
+    mime?: string;
+    isFile: boolean;
+    isDirectory: boolean;
+}
+interface SeastudioFileSearchMatch {
+    path: string;
+    line: number;
+    text: string;
+}
+interface SeastudioFileReadOptions {
+    rootId?: SeastudioFilesystemRootId;
+    offset?: number;
+    limit?: number;
+}
+interface SeastudioFileListOptions {
+    rootId?: SeastudioFilesystemRootId;
+}
+interface SeastudioFileTreeOptions {
+    rootId?: SeastudioFilesystemRootId;
+    depth?: number;
+}
+interface SeastudioFileInfoOptions {
+    rootId?: SeastudioFilesystemRootId;
+}
+interface SeastudioSinglePathOptions {
+    rootId?: SeastudioFilesystemRootId;
+}
+interface SeastudioFileDownloadOptions {
+    rootId?: SeastudioFilesystemRootId;
+}
+interface SeastudioFileSearchOptions {
+    rootId?: SeastudioFilesystemRootId;
+    path?: string;
+    glob?: string;
+    headLimit?: number;
+}
+type SeastudioWorkspacePathMode = 'workspace' | 'absolute';
+interface SeastudioFileTransferOptions {
+    sourceRootId?: SeastudioFilesystemRootId;
+    destRootId?: SeastudioFilesystemRootId;
+    sourcePathMode?: SeastudioWorkspacePathMode;
+    destPathMode?: SeastudioWorkspacePathMode;
+}
+interface SeastudioBatchFlattenPreviewOptions {
+    sourceRootId?: SeastudioFilesystemRootId;
+    sourcePathMode?: SeastudioWorkspacePathMode;
+}
+interface SeastudioBatchFlattenCopyOptions extends SeastudioFileTransferOptions {
+}
+type SeastudioShellSessionEntryLevel = 'command' | 'stdout' | 'stderr' | 'meta';
+interface SeastudioShellSessionEntry {
+    id: number;
+    level: SeastudioShellSessionEntryLevel;
+    content: string;
+    createdAt: number;
+}
+interface SeastudioShellSessionSnapshot {
+    projectPath: string | null;
+    cwd: string | null;
+    promptLabel: string;
+    isRunning: boolean;
+    lastExitCode: number | null;
+    lastDurationMs: number | null;
+    lastCommandAt: number | null;
+    historyCount: number;
+    entryCount: number;
+}
+interface SeastudioShellCommandResult {
+    command: string;
+    cwd: string;
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    error: string | null;
+    durationMs: number;
+    usedFallback: boolean;
+}
+declare function annotateTool(tool: MCPTool, annotations: MCPToolAnnotations, outputSchema?: MCPToolInputSchema): MCPTool;
+declare const fileTools: MCPTool[];
+declare const shellTools: MCPTool[];
+declare const gitTools: MCPTool[];
+declare const clipboardTools: MCPTool[];
+declare const codeQualityTools: MCPTool[];
+declare const batchFileTools: MCPTool[];
+declare const seaCloudTools: MCPTool[];
+
+declare const allTools: MCPTool[];
+declare const tools: MCPTool[];
+declare const seastudio: {
+    roots: {
+        list: () => Promise<{
+            roots: SeastudioFilesystemRoot[];
+        }>;
+    };
+    file: {
+        getSelected: () => Promise<MCPToolResult>;
+        read: (path: string, options?: SeastudioFileReadOptions) => Promise<MCPToolResult>;
+        write: (path: string, content: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        list: (path?: string, options?: SeastudioFileListOptions) => Promise<MCPToolResult>;
+        delete: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        mkdir: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        exists: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        stat: (path: string, options?: SeastudioFileInfoOptions) => Promise<MCPToolResult>;
+        info: (path: string, options?: SeastudioFileInfoOptions) => Promise<MCPToolResult>;
+        search: (query: string, options?: SeastudioFileSearchOptions) => Promise<MCPToolResult>;
+        rename: (path: string, newName: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        move: (sourcePath: string, destDir: string, options?: SeastudioFileTransferOptions) => Promise<MCPToolResult>;
+        copyTo: (sourcePath: string, destDir: string, options?: SeastudioFileTransferOptions) => Promise<MCPToolResult>;
+        copy: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        paste: (path?: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        clipboardCheck: () => Promise<MCPToolResult>;
+        copyPath: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        trash: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        batchFlattenPreview: (sourcePath: string, options?: SeastudioBatchFlattenPreviewOptions) => Promise<MCPToolResult>;
+        batchFlattenCopy: (sourcePath: string, destDir: string, taskId?: string, options?: SeastudioBatchFlattenCopyOptions) => Promise<MCPToolResult>;
+        getUrl: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        download: (url: string, path: string, filenameHint?: string, options?: SeastudioFileDownloadOptions) => Promise<MCPToolResult>;
+        writeBinary: (path: string, base64: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        readBinary: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+    };
+    shell: {
+        execute: (command: string, cwd?: string, timeout?: number) => Promise<MCPToolResult>;
+        session: {
+            get: () => Promise<MCPToolResult>;
+            getEntries: (limit?: number) => Promise<MCPToolResult>;
+            runCommand: (command: string, cwd?: string, timeout?: number) => Promise<MCPToolResult>;
+            setCwd: (cwd: string) => Promise<MCPToolResult>;
+            clear: () => Promise<MCPToolResult>;
+            reset: () => Promise<MCPToolResult>;
+        };
+    };
+    git: {
+        status: () => Promise<MCPToolResult>;
+        diff: (staged?: boolean, path?: string) => Promise<MCPToolResult>;
+    };
+    codeQuality: {
+        runTest: (command?: string, timeout?: number) => Promise<MCPToolResult>;
+        runTypecheck: (command?: string, timeout?: number) => Promise<MCPToolResult>;
+        runLint: (command?: string, timeout?: number) => Promise<MCPToolResult>;
+        codeSearch: (pattern: string, path?: string, glob?: string, headLimit?: number) => Promise<MCPToolResult>;
+    };
+};
+
+/**
+ * SeaStudio MCP Notifications
+ *
+ * 主程序发布的 MCP 通知定义
+ *
+ * 架构说明：
+ * - 插件通过 SeastudioRequests 发送请求到主程序
+ * - 主程序处理请求后，通过 SeastudioNotifications 发布标准通知
+ * - 所有插件订阅 SeastudioNotifications 中的标准通知
+ */
+/**
+ * 插件发送给主程序的请求主题
+ *
+ * 插件不应直接发布通知，而是发送请求，由主程序统一处理后发布标准通知。
+ *
+ * @example
+ * ```typescript
+ * import { getDefaultClient } from '@seastudio/sdk/mcp/core';
+ * import { SeastudioRequests } from '@seastudio/sdk/mcp/seastudio';
+ *
+ * const client = getDefaultClient();
+ * // 请求打开文件（主程序会发布 FILE_OPEN_REQUESTED 通知）
+ * client.publish(SeastudioRequests.FILE_OPEN, { path: '/path/to/file.ts' });
+ * ```
+ */
+declare const SeastudioRequests: {
+    /** 请求打开文件 -> 主程序发布 FILE_OPEN_REQUESTED */
+    readonly FILE_OPEN: "request:file_open";
+    /** 请求标记文件已修改 -> 主程序发布 FILE_MODIFIED */
+    readonly FILE_MODIFIED: "request:file_modified";
+    /** 请求标记文件已保存 -> 主程序发布 FILE_SAVED */
+    readonly FILE_SAVED: "request:file_saved";
+    /** 请求发送文本给 Agent -> 主程序发布 TEXT_SEND_REQUESTED */
+    readonly TEXT_SEND: "request:text_send";
+};
+/**
+ * SeaStudio 主程序发布的通知主题
+ *
+ * 这些通知由主程序统一发布，插件应订阅这些通知以获取状态更新。
+ *
+ * @example
+ * ```typescript
+ * import { getDefaultServer, getDefaultClient } from '@seastudio/sdk/mcp/core';
+ * import { SeastudioNotifications } from '@seastudio/sdk/mcp/seastudio';
+ *
+ * // 订阅通知
+ * const client = getDefaultClient();
+ * client.subscribe([SeastudioNotifications.FILES_CHANGED]);
+ *
+ * // 处理通知
+ * const server = getDefaultServer();
+ * server.onNotification(SeastudioNotifications.FILES_CHANGED, (params) => {
+ *   const { type, path } = params as FilesChangedParams;
+ *   // 刷新文件树
+ * });
+ * ```
+ */
+declare const SeastudioNotifications: {
+    /** 文件系统变化通知（fs.watch 触发） */
+    readonly FILES_CHANGED: "files:changed";
+    /** 根目录变化通知 */
+    readonly ROOTS_CHANGED: "roots:changed";
+    /** 文件打开请求，可广播也可定向 */
+    readonly FILE_OPEN_REQUESTED: "seastudio:file-open_requested";
+    /** 文件已修改通知（内容变化，未保存） */
+    readonly FILE_MODIFIED: "file:modified";
+    /** 文件已保存通知 */
+    readonly FILE_SAVED: "file:saved";
+    /** 文件发送请求 */
+    readonly FILE_SEND_REQUESTED: "seastudio:file-send_requested";
+    /** 文本发送请求 */
+    readonly TEXT_SEND_REQUESTED: "seastudio:text-send_requested";
+};
+/**
+ * files:changed 通知参数
+ */
+interface FilesChangedParams {
+    /** 变化类型：project（工作区） */
+    type: 'project';
+    /** 发生变化的目录路径 */
+    path: string;
+}
+interface RootsChangedParams {
+    roots: Array<{
+        id: 'workspace';
+        label: string;
+        description: string;
+    }>;
+}
+type SeastudioDragRootId = 'workspace';
+interface SeastudioDragFileData {
+    sourcePath: string;
+    sourceRootId?: SeastudioDragRootId;
+    sourcePlugin?: string;
+    sourceType: 'file' | 'directory';
+    sourceZone: string;
+    isExternal?: boolean;
+}
+interface SeastudioDragStartParams extends SeastudioDragFileData {
+    pluginId?: string;
+}
+interface SeastudioDragEnterParams extends SeastudioDragFileData {
+}
+interface SeastudioDragDropParams extends SeastudioDragFileData {
+}
+interface FileTransferRequestedParams {
+    source: 'workspace';
+    rootId: 'workspace';
+    path: string;
+    name: string;
+    kind: 'file' | 'directory';
+    isDirectory: boolean;
+}
+interface FileOpenRequestedParams extends FileTransferRequestedParams {
+}
+interface FileSendRequestedParams extends FileTransferRequestedParams {
+}
+interface TextSendRequestedSelectionRange {
+    startLine?: number;
+    startColumn?: number;
+    endLine?: number;
+    endColumn?: number;
+}
+interface TextSendRequestedSource {
+    type: 'editor' | 'plugin';
+    id?: string;
+    label?: string;
+    path?: string;
+    uri?: string;
+    language?: string;
+    selection?: TextSendRequestedSelectionRange;
+}
+interface TextSendRequestedParams {
+    source: TextSendRequestedSource;
+    text: string;
+}
+/**
+ * file:modified 通知参数
+ */
+interface FileModifiedParams {
+    /** 文件路径 */
+    path: string;
+    /** 是否有未保存的修改 */
+    isDirty: boolean;
+    /** 触发来源插件 ID */
+    source?: string;
+}
+/**
+ * file:saved 通知参数
+ */
+interface FileSavedParams {
+    /** 文件路径 */
+    path: string;
+    /** 触发来源插件 ID */
+    source?: string;
+}
+
+export { type FileModifiedParams, type FileOpenRequestedParams, type FileSavedParams, type FileSendRequestedParams, type FileTransferRequestedParams, type FilesChangedParams, type RootsChangedParams, type SeastudioBatchFlattenCopyOptions, type SeastudioBatchFlattenPreviewOptions, type SeastudioDragDropParams, type SeastudioDragEnterParams, type SeastudioDragFileData, type SeastudioDragRootId, type SeastudioDragStartParams, type SeastudioFileDownloadOptions, type SeastudioFileInfo, type SeastudioFileInfoOptions, type SeastudioFileListOptions, type SeastudioFileReadOptions, type SeastudioFileSearchMatch, type SeastudioFileSearchOptions, type SeastudioFileTransferOptions, type SeastudioFileTreeOptions, type SeastudioFilesystemRoot, type SeastudioFilesystemRootId, SeastudioNotifications, SeastudioRequests, type SeastudioShellCommandResult, type SeastudioShellSessionEntry, type SeastudioShellSessionEntryLevel, type SeastudioShellSessionSnapshot, type SeastudioSinglePathOptions, type SeastudioWorkspacePathMode, type TextSendRequestedParams, type TextSendRequestedSelectionRange, type TextSendRequestedSource, agentManagementTools, agentTabTools, allTools, annotateTool, batchFileTools, clipboardTools, codeQualityTools, fileTools, gitTools, pluginManagementTools, pluginTabTools, seaCloudTools, seastudio, shellTools, tools };

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

@@ -0,0 +1,341 @@
+import { g as MCPTool, k as MCPToolResult, h as MCPToolAnnotations, j as MCPToolInputSchema } from '../../types-Clgf5gBf.js';
+
+/**
+ * Plugin MCP Tools
+ *
+ * 插件管理 + 插件标签操作
+ */
+
+declare const pluginManagementTools: MCPTool[];
+declare const pluginTabTools: MCPTool[];
+
+/**
+ * Agent MCP Tools
+ *
+ * Agent 管理 + Agent 标签操作
+ */
+
+declare const agentManagementTools: MCPTool[];
+declare const agentTabTools: MCPTool[];
+
+/**
+ * SeaStudio MCP Tools
+ *
+ * 主程序基础能力：file, shell, git
+ */
+
+type SeastudioFilesystemRootId = 'workspace';
+interface SeastudioFilesystemRoot {
+    id: SeastudioFilesystemRootId;
+    label: string;
+    description: string;
+}
+interface SeastudioFileInfo {
+    rootId: SeastudioFilesystemRootId;
+    path: string;
+    name: string;
+    type: 'file' | 'directory';
+    size: number;
+    mtime: number;
+    modified: number;
+    mime?: string;
+    isFile: boolean;
+    isDirectory: boolean;
+}
+interface SeastudioFileSearchMatch {
+    path: string;
+    line: number;
+    text: string;
+}
+interface SeastudioFileReadOptions {
+    rootId?: SeastudioFilesystemRootId;
+    offset?: number;
+    limit?: number;
+}
+interface SeastudioFileListOptions {
+    rootId?: SeastudioFilesystemRootId;
+}
+interface SeastudioFileTreeOptions {
+    rootId?: SeastudioFilesystemRootId;
+    depth?: number;
+}
+interface SeastudioFileInfoOptions {
+    rootId?: SeastudioFilesystemRootId;
+}
+interface SeastudioSinglePathOptions {
+    rootId?: SeastudioFilesystemRootId;
+}
+interface SeastudioFileDownloadOptions {
+    rootId?: SeastudioFilesystemRootId;
+}
+interface SeastudioFileSearchOptions {
+    rootId?: SeastudioFilesystemRootId;
+    path?: string;
+    glob?: string;
+    headLimit?: number;
+}
+type SeastudioWorkspacePathMode = 'workspace' | 'absolute';
+interface SeastudioFileTransferOptions {
+    sourceRootId?: SeastudioFilesystemRootId;
+    destRootId?: SeastudioFilesystemRootId;
+    sourcePathMode?: SeastudioWorkspacePathMode;
+    destPathMode?: SeastudioWorkspacePathMode;
+}
+interface SeastudioBatchFlattenPreviewOptions {
+    sourceRootId?: SeastudioFilesystemRootId;
+    sourcePathMode?: SeastudioWorkspacePathMode;
+}
+interface SeastudioBatchFlattenCopyOptions extends SeastudioFileTransferOptions {
+}
+type SeastudioShellSessionEntryLevel = 'command' | 'stdout' | 'stderr' | 'meta';
+interface SeastudioShellSessionEntry {
+    id: number;
+    level: SeastudioShellSessionEntryLevel;
+    content: string;
+    createdAt: number;
+}
+interface SeastudioShellSessionSnapshot {
+    projectPath: string | null;
+    cwd: string | null;
+    promptLabel: string;
+    isRunning: boolean;
+    lastExitCode: number | null;
+    lastDurationMs: number | null;
+    lastCommandAt: number | null;
+    historyCount: number;
+    entryCount: number;
+}
+interface SeastudioShellCommandResult {
+    command: string;
+    cwd: string;
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    error: string | null;
+    durationMs: number;
+    usedFallback: boolean;
+}
+declare function annotateTool(tool: MCPTool, annotations: MCPToolAnnotations, outputSchema?: MCPToolInputSchema): MCPTool;
+declare const fileTools: MCPTool[];
+declare const shellTools: MCPTool[];
+declare const gitTools: MCPTool[];
+declare const clipboardTools: MCPTool[];
+declare const codeQualityTools: MCPTool[];
+declare const batchFileTools: MCPTool[];
+declare const seaCloudTools: MCPTool[];
+
+declare const allTools: MCPTool[];
+declare const tools: MCPTool[];
+declare const seastudio: {
+    roots: {
+        list: () => Promise<{
+            roots: SeastudioFilesystemRoot[];
+        }>;
+    };
+    file: {
+        getSelected: () => Promise<MCPToolResult>;
+        read: (path: string, options?: SeastudioFileReadOptions) => Promise<MCPToolResult>;
+        write: (path: string, content: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        list: (path?: string, options?: SeastudioFileListOptions) => Promise<MCPToolResult>;
+        delete: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        mkdir: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        exists: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        stat: (path: string, options?: SeastudioFileInfoOptions) => Promise<MCPToolResult>;
+        info: (path: string, options?: SeastudioFileInfoOptions) => Promise<MCPToolResult>;
+        search: (query: string, options?: SeastudioFileSearchOptions) => Promise<MCPToolResult>;
+        rename: (path: string, newName: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        move: (sourcePath: string, destDir: string, options?: SeastudioFileTransferOptions) => Promise<MCPToolResult>;
+        copyTo: (sourcePath: string, destDir: string, options?: SeastudioFileTransferOptions) => Promise<MCPToolResult>;
+        copy: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        paste: (path?: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        clipboardCheck: () => Promise<MCPToolResult>;
+        copyPath: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        trash: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        batchFlattenPreview: (sourcePath: string, options?: SeastudioBatchFlattenPreviewOptions) => Promise<MCPToolResult>;
+        batchFlattenCopy: (sourcePath: string, destDir: string, taskId?: string, options?: SeastudioBatchFlattenCopyOptions) => Promise<MCPToolResult>;
+        getUrl: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        download: (url: string, path: string, filenameHint?: string, options?: SeastudioFileDownloadOptions) => Promise<MCPToolResult>;
+        writeBinary: (path: string, base64: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        readBinary: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+    };
+    shell: {
+        execute: (command: string, cwd?: string, timeout?: number) => Promise<MCPToolResult>;
+        session: {
+            get: () => Promise<MCPToolResult>;
+            getEntries: (limit?: number) => Promise<MCPToolResult>;
+            runCommand: (command: string, cwd?: string, timeout?: number) => Promise<MCPToolResult>;
+            setCwd: (cwd: string) => Promise<MCPToolResult>;
+            clear: () => Promise<MCPToolResult>;
+            reset: () => Promise<MCPToolResult>;
+        };
+    };
+    git: {
+        status: () => Promise<MCPToolResult>;
+        diff: (staged?: boolean, path?: string) => Promise<MCPToolResult>;
+    };
+    codeQuality: {
+        runTest: (command?: string, timeout?: number) => Promise<MCPToolResult>;
+        runTypecheck: (command?: string, timeout?: number) => Promise<MCPToolResult>;
+        runLint: (command?: string, timeout?: number) => Promise<MCPToolResult>;
+        codeSearch: (pattern: string, path?: string, glob?: string, headLimit?: number) => Promise<MCPToolResult>;
+    };
+};
+
+/**
+ * SeaStudio MCP Notifications
+ *
+ * 主程序发布的 MCP 通知定义
+ *
+ * 架构说明：
+ * - 插件通过 SeastudioRequests 发送请求到主程序
+ * - 主程序处理请求后，通过 SeastudioNotifications 发布标准通知
+ * - 所有插件订阅 SeastudioNotifications 中的标准通知
+ */
+/**
+ * 插件发送给主程序的请求主题
+ *
+ * 插件不应直接发布通知，而是发送请求，由主程序统一处理后发布标准通知。
+ *
+ * @example
+ * ```typescript
+ * import { getDefaultClient } from '@seastudio/sdk/mcp/core';
+ * import { SeastudioRequests } from '@seastudio/sdk/mcp/seastudio';
+ *
+ * const client = getDefaultClient();
+ * // 请求打开文件（主程序会发布 FILE_OPEN_REQUESTED 通知）
+ * client.publish(SeastudioRequests.FILE_OPEN, { path: '/path/to/file.ts' });
+ * ```
+ */
+declare const SeastudioRequests: {
+    /** 请求打开文件 -> 主程序发布 FILE_OPEN_REQUESTED */
+    readonly FILE_OPEN: "request:file_open";
+    /** 请求标记文件已修改 -> 主程序发布 FILE_MODIFIED */
+    readonly FILE_MODIFIED: "request:file_modified";
+    /** 请求标记文件已保存 -> 主程序发布 FILE_SAVED */
+    readonly FILE_SAVED: "request:file_saved";
+    /** 请求发送文本给 Agent -> 主程序发布 TEXT_SEND_REQUESTED */
+    readonly TEXT_SEND: "request:text_send";
+};
+/**
+ * SeaStudio 主程序发布的通知主题
+ *
+ * 这些通知由主程序统一发布，插件应订阅这些通知以获取状态更新。
+ *
+ * @example
+ * ```typescript
+ * import { getDefaultServer, getDefaultClient } from '@seastudio/sdk/mcp/core';
+ * import { SeastudioNotifications } from '@seastudio/sdk/mcp/seastudio';
+ *
+ * // 订阅通知
+ * const client = getDefaultClient();
+ * client.subscribe([SeastudioNotifications.FILES_CHANGED]);
+ *
+ * // 处理通知
+ * const server = getDefaultServer();
+ * server.onNotification(SeastudioNotifications.FILES_CHANGED, (params) => {
+ *   const { type, path } = params as FilesChangedParams;
+ *   // 刷新文件树
+ * });
+ * ```
+ */
+declare const SeastudioNotifications: {
+    /** 文件系统变化通知（fs.watch 触发） */
+    readonly FILES_CHANGED: "files:changed";
+    /** 根目录变化通知 */
+    readonly ROOTS_CHANGED: "roots:changed";
+    /** 文件打开请求，可广播也可定向 */
+    readonly FILE_OPEN_REQUESTED: "seastudio:file-open_requested";
+    /** 文件已修改通知（内容变化，未保存） */
+    readonly FILE_MODIFIED: "file:modified";
+    /** 文件已保存通知 */
+    readonly FILE_SAVED: "file:saved";
+    /** 文件发送请求 */
+    readonly FILE_SEND_REQUESTED: "seastudio:file-send_requested";
+    /** 文本发送请求 */
+    readonly TEXT_SEND_REQUESTED: "seastudio:text-send_requested";
+};
+/**
+ * files:changed 通知参数
+ */
+interface FilesChangedParams {
+    /** 变化类型：project（工作区） */
+    type: 'project';
+    /** 发生变化的目录路径 */
+    path: string;
+}
+interface RootsChangedParams {
+    roots: Array<{
+        id: 'workspace';
+        label: string;
+        description: string;
+    }>;
+}
+type SeastudioDragRootId = 'workspace';
+interface SeastudioDragFileData {
+    sourcePath: string;
+    sourceRootId?: SeastudioDragRootId;
+    sourcePlugin?: string;
+    sourceType: 'file' | 'directory';
+    sourceZone: string;
+    isExternal?: boolean;
+}
+interface SeastudioDragStartParams extends SeastudioDragFileData {
+    pluginId?: string;
+}
+interface SeastudioDragEnterParams extends SeastudioDragFileData {
+}
+interface SeastudioDragDropParams extends SeastudioDragFileData {
+}
+interface FileTransferRequestedParams {
+    source: 'workspace';
+    rootId: 'workspace';
+    path: string;
+    name: string;
+    kind: 'file' | 'directory';
+    isDirectory: boolean;
+}
+interface FileOpenRequestedParams extends FileTransferRequestedParams {
+}
+interface FileSendRequestedParams extends FileTransferRequestedParams {
+}
+interface TextSendRequestedSelectionRange {
+    startLine?: number;
+    startColumn?: number;
+    endLine?: number;
+    endColumn?: number;
+}
+interface TextSendRequestedSource {
+    type: 'editor' | 'plugin';
+    id?: string;
+    label?: string;
+    path?: string;
+    uri?: string;
+    language?: string;
+    selection?: TextSendRequestedSelectionRange;
+}
+interface TextSendRequestedParams {
+    source: TextSendRequestedSource;
+    text: string;
+}
+/**
+ * file:modified 通知参数
+ */
+interface FileModifiedParams {
+    /** 文件路径 */
+    path: string;
+    /** 是否有未保存的修改 */
+    isDirty: boolean;
+    /** 触发来源插件 ID */
+    source?: string;
+}
+/**
+ * file:saved 通知参数
+ */
+interface FileSavedParams {
+    /** 文件路径 */
+    path: string;
+    /** 触发来源插件 ID */
+    source?: string;
+}
+
+export { type FileModifiedParams, type FileOpenRequestedParams, type FileSavedParams, type FileSendRequestedParams, type FileTransferRequestedParams, type FilesChangedParams, type RootsChangedParams, type SeastudioBatchFlattenCopyOptions, type SeastudioBatchFlattenPreviewOptions, type SeastudioDragDropParams, type SeastudioDragEnterParams, type SeastudioDragFileData, type SeastudioDragRootId, type SeastudioDragStartParams, type SeastudioFileDownloadOptions, type SeastudioFileInfo, type SeastudioFileInfoOptions, type SeastudioFileListOptions, type SeastudioFileReadOptions, type SeastudioFileSearchMatch, type SeastudioFileSearchOptions, type SeastudioFileTransferOptions, type SeastudioFileTreeOptions, type SeastudioFilesystemRoot, type SeastudioFilesystemRootId, SeastudioNotifications, SeastudioRequests, type SeastudioShellCommandResult, type SeastudioShellSessionEntry, type SeastudioShellSessionEntryLevel, type SeastudioShellSessionSnapshot, type SeastudioSinglePathOptions, type SeastudioWorkspacePathMode, type TextSendRequestedParams, type TextSendRequestedSelectionRange, type TextSendRequestedSource, agentManagementTools, agentTabTools, allTools, annotateTool, batchFileTools, clipboardTools, codeQualityTools, fileTools, gitTools, pluginManagementTools, pluginTabTools, seaCloudTools, seastudio, shellTools, tools };

package/dist/mcp/seastudio/index.js

@@ -0,0 +1,2 @@
+export { SeastudioNotifications, SeastudioRequests, agentManagementTools, agentTabTools, allTools, annotateTool, batchFileTools, clipboardTools, codeQualityTools, fileTools, gitTools, pluginManagementTools, pluginTabTools, seaCloudTools, seastudio, shellTools, tools } from '../../chunk-DDVRUPMZ.js';
+import '../../chunk-ANWOL7SM.js';

package/dist/tools-LMW67LIY.js

@@ -0,0 +1,2 @@
+export { commandTools, sessionTools, shellPlugin, tools } from './chunk-FLATZQA2.js';
+import './chunk-ANWOL7SM.js';