@seastudio/sdk 3.2.5 → 3.3.0

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

@@ -12,14 +12,19 @@ declare const rootedWriteEvidenceOutputSchema: MCPToolInputSchema;
 declare const dualPathEvidenceOutputSchema: MCPToolInputSchema;
 declare const batchFlattenCopyEvidenceOutputSchema: MCPToolInputSchema;
 declare const fileDownloadEvidenceOutputSchema: MCPToolInputSchema;
-declare const shellCommandEvidenceOutputSchema: MCPToolInputSchema;
 declare const shellSessionSnapshotEvidenceOutputSchema: MCPToolInputSchema;
+declare const shellSessionOpenEvidenceOutputSchema: MCPToolInputSchema;
+declare const shellSessionRunEvidenceOutputSchema: MCPToolInputSchema;
+declare const shellSessionSignalEvidenceOutputSchema: MCPToolInputSchema;
+declare const shellSessionCloseEvidenceOutputSchema: MCPToolInputSchema;
 declare const fileTools: MCPTool[];
 
 /**
  * Shell MCP Tools
  *
- * Shell 能力
+ * 基于 PTY 的多 session 长会话工具。
+ * 全部 session 命令式 API:
+ *   open / list / get / run / wait / get_entries / signal / clear_entries / close
  */
 
 declare const shellTools: MCPTool[];
@@ -38,7 +43,15 @@ declare const seaCloudTools: MCPTool[];
  * 供 TS/JS 代码直接调用 MCP 的便利 API
  */
 
-type SeastudioFilesystemRootId = 'workspace';
+type SeastudioFilesystemRootId = 'workspace' | `proj-${string}`;
+interface SeastudioProjectInfo {
+    id: string;
+    name: string;
+    path: string;
+    lastActiveAt: number;
+    isActive: boolean;
+    rootId: SeastudioFilesystemRootId;
+}
 interface SeastudioFilesystemRoot {
     id: SeastudioFilesystemRootId;
     label: string;
@@ -103,33 +116,83 @@ interface SeastudioBatchFlattenPreviewOptions {
 }
 interface SeastudioBatchFlattenCopyOptions extends SeastudioFileTransferOptions {
 }
-type SeastudioShellSessionEntryLevel = 'command' | 'stdout' | 'stderr' | 'meta';
-interface SeastudioShellSessionEntry {
+type SeastudioShellKind = 'bash' | 'pwsh' | 'cmd' | 'sh';
+type SeastudioShellEntryLevel = 'command' | 'stdout' | 'meta' | 'exit';
+interface SeastudioShellEntry {
     id: number;
-    level: SeastudioShellSessionEntryLevel;
+    level: SeastudioShellEntryLevel;
     content: string;
     createdAt: number;
+    commandId?: string;
 }
-interface SeastudioShellSessionSnapshot {
-    projectPath: string | null;
+interface SeastudioShellSession {
+    sessionId: string;
+    shell: SeastudioShellKind;
     cwd: string | null;
-    promptLabel: string;
-    isRunning: boolean;
+    pid: number;
+    alive: boolean;
+    openedAt: number;
+    label?: string;
+    pluginId?: string;
+    projectId?: string;
+    agentInstanceId?: string;
+    pendingCommandId: string | null;
+    lastCommandId: string | null;
     lastExitCode: number | null;
     lastDurationMs: number | null;
-    lastCommandAt: number | null;
-    historyCount: number;
     entryCount: number;
+    droppedCount: number;
+}
+interface SeastudioShellOpenOptions {
+    shell?: 'auto' | SeastudioShellKind;
+    cwd?: string;
+    env?: Record<string, string>;
+    label?: string;
+    cols?: number;
+    rows?: number;
+}
+interface SeastudioShellRunOptions {
+    timeoutMs?: number;
+}
+interface SeastudioShellRunResult {
+    sessionId: string;
+    commandId: string;
+    startedAt: number;
+    running: boolean;
+}
+interface SeastudioShellWaitResult {
+    commandId: string;
+    exitCode: number | null;
+    durationMs: number;
+    finished: boolean;
+    timedOut: boolean;
+}
+interface SeastudioShellGetEntriesOptions {
+    sinceId?: number;
+    limit?: number;
+}
+interface SeastudioShellGetEntriesResult {
+    entries: SeastudioShellEntry[];
+    nextSinceId: number;
+    totalEntries: number;
+    droppedCount: number;
+}
+interface SeastudioShellSignalResult {
+    sessionId: string;
+    signal: 'INT' | 'TERM' | 'KILL';
+    ok: boolean;
+    deliveredAt: number;
+}
+interface SeastudioShellCloseResult {
+    sessionId: string;
+    closed: boolean;
+    exitCode: number | null;
 }
-interface SeastudioShellCommandResult {
-    command: string;
-    cwd: string;
-    exitCode: number;
+interface SeastudioShellOneShotResult {
+    exitCode: number | null;
     stdout: string;
-    stderr: string;
-    error: string | null;
     durationMs: number;
-    usedFallback: boolean;
+    timedOut: boolean;
 }
 declare function callTool(name: string, args?: Record<string, unknown>): Promise<MCPToolResult>;
 declare function request<T = unknown>(method: string, params?: Record<string, unknown>): Promise<T>;
@@ -140,6 +203,10 @@ declare const seastudio: {
             roots: SeastudioFilesystemRoot[];
         }>;
     };
+    project: {
+        list: () => Promise<MCPToolResult>;
+        getActive: () => Promise<MCPToolResult>;
+    };
     file: {
         getSelected: () => Promise<MCPToolResult>;
         read: (path: string, options?: SeastudioFileReadOptions) => Promise<MCPToolResult>;
@@ -168,17 +235,27 @@ declare const seastudio: {
         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>;
+            open: (options?: SeastudioShellOpenOptions) => Promise<MCPToolResult>;
+            list: () => Promise<MCPToolResult>;
+            get: (sessionId: string) => Promise<MCPToolResult>;
+            run: (sessionId: string, command: string, options?: SeastudioShellRunOptions) => Promise<MCPToolResult>;
+            wait: (sessionId: string, commandId: string, timeoutMs?: number) => Promise<MCPToolResult>;
+            getEntries: (sessionId: string, options?: SeastudioShellGetEntriesOptions) => Promise<MCPToolResult>;
+            signal: (sessionId: string, signal: "INT" | "TERM" | "KILL", commandId?: string) => Promise<MCPToolResult>;
+            clearEntries: (sessionId: string) => Promise<MCPToolResult>;
+            close: (sessionId: string, force?: boolean) => Promise<MCPToolResult>;
         };
     };
 };
+/**
+ * One-shot helper: open a transient session, run command, wait, close.
+ * Returns aggregated stdout/exit info. Useful for short, non-interactive commands
+ * (e.g. `git status`). For long-running tasks use `seastudio.shell.session` directly.
+ */
+declare function runOneShotShellCommand(command: string, options?: SeastudioShellOpenOptions & {
+    timeoutMs?: number;
+}): Promise<SeastudioShellOneShotResult>;
 
 /**
  * Plugin MCP Tools
@@ -198,6 +275,14 @@ declare const pluginTabTools: MCPTool[];
 declare const agentManagementTools: MCPTool[];
 declare const agentTabTools: MCPTool[];
 
+/**
+ * Project MCP Tools
+ *
+ * 项目枚举与寻址：让 agent 能列出所有项目并按需跨项目操作。
+ */
+
+declare const projectTools: MCPTool[];
+
 /**
  * SeaStudio MCP Notifications
  *
@@ -526,4 +611,4 @@ interface SessionDeleteRequestedParams {
 declare const allTools: MCPTool[];
 declare const tools: MCPTool[];
 
-export { type AgentInstanceSessionSnapshot, type FileDeletedParams, type FileModifiedParams, type FileOpenRequestedParams, type FileRenamedParams, type FileSavedParams, type FileSendRequestedParams, type FileTransferRequestedParams, type FilesChangedParams, type ProposalFeedbackFileSummary, type ProposalFeedbackHunk, type ProposalFeedbackOrigin, type ProposalFeedbackParams, 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 SessionCreatedParams, type SessionDeleteRequestedParams, type SessionNewRequestedParams, type SessionNotificationBase, type SessionRemovedParams, type SessionSelectedParams, type SessionSelectedReason, type SessionSnapshotItem, type SessionStateSnapshotParams, type SessionSummaryParams, type TextSendRequestedParams, type TextSendRequestedSelectionRange, type TextSendRequestedSource, agentManagementTools, agentTabTools, allTools, annotateTool, batchFlattenCopyEvidenceOutputSchema, callTool, callToolText, dualPathEvidenceOutputSchema, fileDownloadEvidenceOutputSchema, fileTools, pluginManagementTools, pluginTabTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, seaCloudTools, seastudio, shellCommandEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, tools };
+export { type AgentInstanceSessionSnapshot, type FileDeletedParams, type FileModifiedParams, type FileOpenRequestedParams, type FileRenamedParams, type FileSavedParams, type FileSendRequestedParams, type FileTransferRequestedParams, type FilesChangedParams, type ProposalFeedbackFileSummary, type ProposalFeedbackHunk, type ProposalFeedbackOrigin, type ProposalFeedbackParams, 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, type SeastudioProjectInfo, SeastudioRequests, type SeastudioShellCloseResult, type SeastudioShellEntry, type SeastudioShellEntryLevel, type SeastudioShellGetEntriesOptions, type SeastudioShellGetEntriesResult, type SeastudioShellKind, type SeastudioShellOneShotResult, type SeastudioShellOpenOptions, type SeastudioShellRunOptions, type SeastudioShellRunResult, type SeastudioShellSession, type SeastudioShellSignalResult, type SeastudioShellWaitResult, type SeastudioSinglePathOptions, type SeastudioWorkspacePathMode, type SessionCreatedParams, type SessionDeleteRequestedParams, type SessionNewRequestedParams, type SessionNotificationBase, type SessionRemovedParams, type SessionSelectedParams, type SessionSelectedReason, type SessionSnapshotItem, type SessionStateSnapshotParams, type SessionSummaryParams, type TextSendRequestedParams, type TextSendRequestedSelectionRange, type TextSendRequestedSource, agentManagementTools, agentTabTools, allTools, annotateTool, batchFlattenCopyEvidenceOutputSchema, callTool, callToolText, dualPathEvidenceOutputSchema, fileDownloadEvidenceOutputSchema, fileTools, pluginManagementTools, pluginTabTools, projectTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, runOneShotShellCommand, seaCloudTools, seastudio, shellSessionCloseEvidenceOutputSchema, shellSessionOpenEvidenceOutputSchema, shellSessionRunEvidenceOutputSchema, shellSessionSignalEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, tools };

package/dist/mcp/seastudio/index.js

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

package/package.json

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