@seastudio/sdk 3.7.3 → 4.0.1

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

@@ -3,7 +3,7 @@ import { g as MCPTool, h as MCPToolAnnotations, j as MCPToolInputSchema, k as MC
 /**
  * File MCP Tools
  *
- * 文件能力 + 剪贴板文件能力 + 批量文件能力
+ * 文件系统读写、传输与剪贴板能力。
  */
 
 declare function annotateTool(tool: MCPTool, annotations: MCPToolAnnotations, outputSchema?: MCPToolInputSchema): MCPTool;
@@ -24,8 +24,6 @@ declare const fileTools: MCPTool[];
  * Shell MCP Tools
  *
  * 基于 PTY 的多 session 长会话工具。
- * 全部 session 命令式 API:
- *   open / list / get / run / wait / get_entries / signal / clear_entries / close
  */
 
 declare const shellTools: MCPTool[];
@@ -33,7 +31,7 @@ declare const shellTools: MCPTool[];
 /**
  * AIGC MCP Tools
  *
- * SeaCloud 多模态生成能力
+ * SeaCloud 多模态生成能力。
  */
 
 declare const seaCloudTools: MCPTool[];
@@ -275,6 +273,9 @@ declare const seastudio: {
         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>;
+        copyMany: (paths: string[], options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        cut: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        cutMany: (paths: string[], options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
         paste: (path?: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
         clipboardCheck: () => Promise<MCPToolResult>;
         copyPath: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
@@ -366,7 +367,7 @@ declare function runOneShotShellCommand(command: string, options?: SeastudioShel
 /**
  * Plugin MCP Tools
  *
- * 插件管理 + 插件标签操作
+ * 插件管理 + 插件标签操作。
  */
 
 declare const pluginManagementTools: MCPTool[];
@@ -375,7 +376,7 @@ declare const pluginTabTools: MCPTool[];
 /**
  * Agent MCP Tools
  *
- * Agent 管理 + Agent 标签操作
+ * Agent 管理 + Agent 标签操作。
  */
 
 declare const agentManagementTools: MCPTool[];
@@ -384,7 +385,7 @@ declare const agentTabTools: MCPTool[];
 /**
  * Project MCP Tools
  *
- * 项目枚举与寻址：让 agent 能列出所有项目并按需跨项目操作。
+ * 项目枚举与寻址。
  */
 
 declare const projectTools: MCPTool[];
@@ -393,26 +394,12 @@ declare const projectTools: MCPTool[];
  * Skill MCP Tools
  *
  * 把桌面端 skillManager 扫描到的 Agent Skill 暴露给 agent 插件（只读）。
- *
- * 说明：
- * - 写操作（安装 / 卸载 / 编辑 scope）不通过 MCP，只在桌面端 IPC engine:skill:* 给设置页 UI 用。
- * - "能 list 出来即生效"：scope 即语义，不需要 enabled 字段。
  */
 
 declare const skillTools: MCPTool[];
 
 declare const browserRuntimeTools: MCPTool[];
 
-/**
- * SeaStudio MCP Notifications
- *
- * 主程序发布的 MCP 通知定义
- *
- * 架构说明：
- * - 插件通过 SeastudioRequests 发送请求到主程序
- * - 主程序处理请求后，通过 SeastudioNotifications 发布标准通知
- * - 所有插件订阅 SeastudioNotifications 中的标准通知
- */
 /**
  * 插件发送给主程序的请求主题
  *
@@ -424,7 +411,6 @@ declare const browserRuntimeTools: MCPTool[];
  * import { SeastudioRequests } from '@seastudio/sdk/mcp/seastudio';
  *
  * const client = getDefaultClient();
- * // 请求打开文件（主程序会发布 FILE_OPEN_REQUESTED 通知）
  * client.publish(SeastudioRequests.FILE_OPEN, { path: '/path/to/file.ts' });
  * ```
  */
@@ -445,18 +431,15 @@ declare const SeastudioRequests: {
  *
  * @example
  * ```typescript
- * import { getDefaultServer, getDefaultClient } from '@seastudio/sdk/mcp/core';
+ * import { getDefaultClient, getDefaultServer } 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;
- *   // 刷新文件树
  * });
  * ```
  */
@@ -528,6 +511,10 @@ declare const SeastudioNotifications: {
      */
     readonly SESSION_DELETE_REQUESTED: "session:delete_requested";
 };
+
+/** 项目根在 MCP 文件工具中的寻址 id */
+type SeastudioRootId = 'workspace' | `proj-${string}`;
+type SeastudioDragRootId = SeastudioRootId;
 /**
  * files:changed 通知参数
  */
@@ -545,7 +532,6 @@ interface FilesChangedParams {
     /** 变化类型：内容变化、结构变化或未知兜底 */
     changeKind?: 'content' | 'structure' | 'unknown';
 }
-type SeastudioRootId = 'workspace' | `proj-${string}`;
 interface FileRenamedParams {
     /** 根目录 ID */
     rootId: SeastudioRootId;
@@ -579,7 +565,6 @@ interface RootsChangedParams {
         description: string;
     }>;
 }
-type SeastudioDragRootId = SeastudioRootId;
 interface SeastudioDragFileData {
     sourcePath: string;
     sourceRootId?: SeastudioDragRootId;
@@ -719,7 +704,7 @@ interface SessionNotificationBase {
     projectId?: string;
 }
 /** Agent 对话 session 的宿主展示状态 */
-type SessionStatus = 'idle' | 'processing' | 'completed' | 'failed';
+type SessionStatus = 'idle' | 'awaiting_user' | 'processing' | 'completed' | 'failed';
 interface SessionCreatedParams extends SessionNotificationBase {
     /** 展示用标题 */
     title?: string;

package/dist/mcp/seastudio/index.js

@@ -1,2 +1,2 @@
-export { SeastudioNotifications, SeastudioRequests, agentManagementTools, agentTabTools, allTools, annotateTool, batchFlattenCopyEvidenceOutputSchema, browserRuntimeTools, callTool, callToolText, dualPathEvidenceOutputSchema, fileDownloadEvidenceOutputSchema, fileTools, fileUrlEvidenceOutputSchema, pluginManagementTools, pluginTabTools, projectTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, runOneShotShellCommand, seaCloudTools, seastudio, shellSessionCloseEvidenceOutputSchema, shellSessionOpenEvidenceOutputSchema, shellSessionRunEvidenceOutputSchema, shellSessionSignalEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, skillTools, tools } from '../../chunk-PV6XSOI5.js';
+export { SeastudioNotifications, SeastudioRequests, agentManagementTools, agentTabTools, allTools, annotateTool, batchFlattenCopyEvidenceOutputSchema, browserRuntimeTools, callTool, callToolText, dualPathEvidenceOutputSchema, fileDownloadEvidenceOutputSchema, fileTools, fileUrlEvidenceOutputSchema, pluginManagementTools, pluginTabTools, projectTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, runOneShotShellCommand, seaCloudTools, seastudio, shellSessionCloseEvidenceOutputSchema, shellSessionOpenEvidenceOutputSchema, shellSessionRunEvidenceOutputSchema, shellSessionSignalEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, skillTools, tools } from '../../chunk-CRW5HIAT.js';
 import '../../chunk-TJ3CGHWJ.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seastudio/sdk",
-  "version": "3.7.3",
+  "version": "4.0.1",
   "description": "SeaStudio SDK - UI 组件 + MCP 信息交换中心",
   "main": "dist/index.cjs",
   "module": "dist/index.js",