@seastudio/sdk 5.0.0 → 5.2.0

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

@@ -1,4 +1,4 @@
-import { g as MCPTool, h as MCPToolAnnotations, j as MCPToolInputSchema, k as MCPToolResult } from '../../types-D7xY0bt6.cjs';
+import { g as MCPTool, h as MCPToolAnnotations, j as MCPToolInputSchema, k as MCPToolResult } from '../../types-S2uWCEaN.cjs';
 
 /**
  * Git 共享类型契约
@@ -336,36 +336,34 @@ interface SeastudioShellOneShotResult {
     durationMs: number;
     timedOut: boolean;
 }
-type SeastudioBrowserRuntimeStatus = 'idle' | 'loading' | 'ready' | 'error';
-interface SeastudioBrowserRuntimeCertificateError {
+type SeastudioBrowserStatus = 'idle' | 'loading' | 'ready' | 'error';
+interface SeastudioBrowserCertificateError {
     requestId: string;
     url: string;
     error: string;
 }
-interface SeastudioBrowserRuntimeTab {
+interface SeastudioBrowserTab {
     id: string;
     title: string;
     url: string | null;
-    status: SeastudioBrowserRuntimeStatus;
+    status: SeastudioBrowserStatus;
     errorMessage: string | null;
     canGoBack: boolean;
     canGoForward: boolean;
-    certificateError?: SeastudioBrowserRuntimeCertificateError | null;
+    certificateError?: SeastudioBrowserCertificateError | null;
     ownerInstanceId?: string;
 }
-interface SeastudioBrowserRuntimeState {
-    browserRuntimeSessionId: string;
+interface SeastudioBrowserState {
+    browserId: string;
     label?: string;
     storagePartitionKey: string;
     homepage: string;
-    tabs: SeastudioBrowserRuntimeTab[];
+    tabs: SeastudioBrowserTab[];
     activeTabId: string | null;
-}
-interface SeastudioBrowserRuntimeSession extends SeastudioBrowserRuntimeState {
     createdAt: number;
     updatedAt: number;
 }
-interface SeastudioBrowserRuntimeSessionOpenOptions {
+interface SeastudioBrowserOpenOptions {
     label?: string;
     storagePartitionKey?: string;
     homepage?: string;
@@ -376,13 +374,13 @@ interface SeastudioBrowserViewportRect {
     width: number;
     height: number;
 }
-interface SeastudioBrowserRuntimeViewportBinding {
-    browserRuntimeSessionId: string;
+interface SeastudioBrowserViewportBinding {
+    browserId: string;
     ownerInstanceId?: string;
     rect: SeastudioBrowserViewportRect;
 }
-interface SeastudioBrowserRuntimeViewportBindOptions {
-    browserRuntimeSessionId?: string;
+interface SeastudioBrowserViewportBindOptions {
+    browserId?: string;
     ownerInstanceId?: string;
 }
 declare function callTool(name: string, args?: Record<string, unknown>): Promise<MCPToolResult>;
@@ -486,72 +484,68 @@ declare const seastudio: {
         };
     };
     browser: {
-        runtimeSession: {
-            open: (options?: SeastudioBrowserRuntimeSessionOpenOptions) => Promise<SeastudioBrowserRuntimeSession>;
-            list: () => Promise<{
-                sessions: SeastudioBrowserRuntimeSession[];
-            }>;
-            get: (browserRuntimeSessionId?: string) => Promise<SeastudioBrowserRuntimeSession>;
-            close: (browserRuntimeSessionId?: string) => Promise<{
-                browserRuntimeSessionId: string;
-                closed: boolean;
-            }>;
-        };
-        runtimeTab: {
-            create: (browserRuntimeSessionId?: string, url?: string, ownerInstanceId?: string) => Promise<{
-                browserRuntimeSessionId: string;
-                tab: SeastudioBrowserRuntimeTab;
+        open: (options?: SeastudioBrowserOpenOptions) => Promise<SeastudioBrowserState>;
+        list: () => Promise<{
+            browsers: SeastudioBrowserState[];
+        }>;
+        get: (browserId?: string) => Promise<SeastudioBrowserState>;
+        close: (browserId?: string) => Promise<{
+            browserId: string;
+            closed: boolean;
+        }>;
+        show: (url: string) => Promise<{
+            url: string;
+            browserId: string;
+            instanceId?: string;
+            tab?: SeastudioBrowserTab;
+        }>;
+        evaluate: <T = unknown>(browserId: string, tabId: string, script: string, timeoutMs?: number) => Promise<{
+            result: T;
+        }>;
+        tab: {
+            create: (browserId?: string, url?: string, ownerInstanceId?: string) => Promise<{
+                browserId: string;
+                tab: SeastudioBrowserTab;
                 activeTabId: string;
             }>;
-            close: (browserRuntimeSessionId: string, tabId: string) => Promise<{
-                browserRuntimeSessionId: string;
+            close: (browserId: string, tabId: string) => Promise<{
+                browserId: string;
                 closedTabId: string;
                 activeTabId: string | null;
             }>;
-            activate: (browserRuntimeSessionId: string, tabId: string) => Promise<{
-                browserRuntimeSessionId: string;
+            activate: (browserId: string, tabId: string) => Promise<{
+                browserId: string;
                 activeTabId: string;
             }>;
-            navigate: (browserRuntimeSessionId: string, tabId: string, url: string) => Promise<{
-                browserRuntimeSessionId: string;
+            navigate: (browserId: string, tabId: string, url: string) => Promise<{
+                browserId: string;
                 tabId: string;
                 url: string;
             }>;
-            goBack: (browserRuntimeSessionId: string, tabId: string) => Promise<{
+            goBack: (browserId: string, tabId: string) => Promise<{
                 ok: boolean;
             }>;
-            goForward: (browserRuntimeSessionId: string, tabId: string) => Promise<{
+            goForward: (browserId: string, tabId: string) => Promise<{
                 ok: boolean;
             }>;
-            reload: (browserRuntimeSessionId: string, tabId: string) => Promise<{
+            reload: (browserId: string, tabId: string) => Promise<{
                 ok: boolean;
             }>;
-            stop: (browserRuntimeSessionId: string, tabId: string) => Promise<{
+            stop: (browserId: string, tabId: string) => Promise<{
                 ok: boolean;
             }>;
             getOrCreateForInstance: (ownerInstanceId: string, url?: string) => Promise<{
-                browserRuntimeSessionId: string;
-                tab: SeastudioBrowserRuntimeTab;
+                browserId: string;
+                tab: SeastudioBrowserTab;
                 activeTabId: string;
                 created: boolean;
             }>;
         };
         viewport: {
-            bind: (rect: SeastudioBrowserViewportRect, options?: SeastudioBrowserRuntimeViewportBindOptions) => Promise<SeastudioBrowserRuntimeViewportBinding>;
-        };
-        runtime: {
-            show: (url: string) => Promise<{
-                url: string;
-                browserRuntimeSessionId: string;
-                instanceId?: string;
-                tab?: SeastudioBrowserRuntimeTab;
-            }>;
-            evaluate: <T = unknown>(browserRuntimeSessionId: string, tabId: string, script: string, timeoutMs?: number) => Promise<{
-                result: T;
-            }>;
+            bind: (rect: SeastudioBrowserViewportRect, options?: SeastudioBrowserViewportBindOptions) => Promise<SeastudioBrowserViewportBinding>;
         };
         certificate: {
-            respond: (browserRuntimeSessionId: string, requestId: string, allow: boolean) => Promise<{
+            respond: (browserId: string, requestId: string, allow: boolean) => Promise<{
                 ok: boolean;
             }>;
         };
@@ -600,8 +594,8 @@ declare const projectTools: MCPTool[];
 
 declare const skillTools: MCPTool[];
 
-declare const SINGLETON_BROWSER_RUNTIME_SESSION_ID = "browser-runtime-session-default";
-declare const browserRuntimeTools: MCPTool[];
+declare const SINGLETON_BROWSER_ID = "browser-default";
+declare const browserTools: MCPTool[];
 
 /**
  * 插件发送给主程序的请求主题
@@ -685,14 +679,14 @@ declare const SeastudioNotifications: {
     readonly PROPOSAL_FEEDBACK: "seastudio:proposal-feedback";
     /** 插件实例请求更新宿主 plugin tab 标题 */
     readonly PLUGIN_TAB_TITLE_CHANGED: "plugin:tab-title_changed";
-    /** BrowserRuntimeSession 状态变化 */
-    readonly BROWSER_RUNTIME_SESSION_CHANGED: "browser-runtime:session_changed";
-    /** BrowserRuntimeSession 关闭 */
-    readonly BROWSER_RUNTIME_SESSION_CLOSED: "browser-runtime:session_closed";
-    /** BrowserRuntimeSession 证书错误，需要客户端 UI 决策 */
-    readonly BROWSER_RUNTIME_CERTIFICATE_ERROR: "browser-runtime:certificate_error";
-    /** BrowserRuntimeSession 收到网页新标签请求 */
-    readonly BROWSER_RUNTIME_NEW_TAB_REQUESTED: "browser-runtime:new_tab_requested";
+    /** Browser 状态变化 */
+    readonly BROWSER_STATE_CHANGED: "browser:state_changed";
+    /** Browser 关闭 */
+    readonly BROWSER_CLOSED: "browser:closed";
+    /** Browser 证书错误，需要客户端 UI 决策 */
+    readonly BROWSER_CERTIFICATE_ERROR: "browser:certificate_error";
+    /** Browser 收到网页新标签请求 */
+    readonly BROWSER_NEW_TAB_REQUESTED: "browser:new_tab_requested";
     /**
      * Agent 对话 session：新建。消息历史仍由 Agent 前端持有，宿主仅同步列表用于侧栏。
      * 通常由 Agent 通过 notifications/publish 发出；其他订阅者（含 host-ui）可据此更新 UI。
@@ -741,6 +735,10 @@ declare const SeastudioNotifications: {
     readonly HOST_APP_VISIBILITY: "host:app_visibility";
     /** Host MCP tools/list 发生变化（例如 Seaflow bridge 动态注册工具） */
     readonly RUNTIME_TOOLS_CHANGED: "mcp:runtime_tools_changed";
+    /** Host 精确路由到插件实例的工具调用请求 */
+    readonly PLUGIN_TOOL_CALL: "plugin:tool_call";
+    /** 插件实例返回给 Host 的工具调用结果 */
+    readonly PLUGIN_TOOL_RESULT: "plugin:tool_result";
     /** 主程序用户登录态变化；不包含访问令牌 */
     readonly AUTH_SESSION_CHANGED: "auth:session_changed";
 };
@@ -814,6 +812,39 @@ interface AuthSessionChangedParams {
         user: AuthSessionUser | null;
     };
 }
+interface PluginToolCallCaller {
+    type: 'agent' | 'plugin' | 'host';
+    agentInstanceId?: string;
+    pluginId?: string;
+    pluginInstanceId?: string;
+    projectId?: string;
+    threadId?: string;
+}
+interface PluginToolCallTarget {
+    providerId: string;
+    pluginId: string;
+    pluginInstanceId: string;
+    contractHash: string;
+}
+interface PluginToolCallEnvelope {
+    callId: string;
+    caller: PluginToolCallCaller;
+    target: PluginToolCallTarget;
+    toolName: string;
+    arguments: Record<string, unknown>;
+    timeoutMs: number;
+}
+interface PluginToolCallError {
+    name?: string;
+    message: string;
+    code?: string;
+    details?: unknown;
+}
+interface PluginToolResultEnvelope {
+    callId: string;
+    result?: unknown;
+    error?: PluginToolCallError;
+}
 interface SeastudioDragFileData {
     sourcePath: string;
     sourceRootId?: SeastudioDragRootId;
@@ -1102,4 +1133,4 @@ interface HostAppVisibilityParams {
 declare const allTools: MCPTool[];
 declare const tools: MCPTool[];
 
-export { type AgentInstanceSessionSnapshot, type AuthSessionChangedParams, type AuthSessionStatus, type AuthSessionUser, type FileDeletedParams, type FileKeepRequestedParams, type FileModifiedParams, type FileOpenRequestedParams, type FileRenamedParams, type FileSavedParams, type FileSelectedParams, type FileSendRequestedParams, type FileTransferRequestedParams, type FilesChangedParams, type GitBranchInfo, type GitBranchesResult, type GitChangeKind, type GitChangedParams, type GitCommitRef, type GitCommitRefType, type GitFileChange, type GitLineChange, type GitLineChangeKind, type GitLogCommit, type GitLogResult, type GitOpenDiffRequestedParams, type GitStatusResult, type GitSummary, type HostAppVisibilityParams, type PluginTabTitleChangedParams, type ProposalChangedParams, type ProposalFeedbackFileSummary, type ProposalFeedbackHunk, type ProposalFeedbackOrigin, type ProposalFeedbackParams, type ProposalRecord, type ProposalRequestedFile, type ProposalRequestedHunk, type ProposalRequestedParams, type ProposalStatus, type RootsChangedParams, SINGLETON_BROWSER_RUNTIME_SESSION_ID, type SeastudioBatchFlattenCopyOptions, type SeastudioBatchFlattenPreviewOptions, type SeastudioBrowserRuntimeCertificateError, type SeastudioBrowserRuntimeSession, type SeastudioBrowserRuntimeSessionOpenOptions, type SeastudioBrowserRuntimeState, type SeastudioBrowserRuntimeStatus, type SeastudioBrowserRuntimeTab, type SeastudioBrowserRuntimeViewportBindOptions, type SeastudioBrowserRuntimeViewportBinding, type SeastudioBrowserViewportRect, type SeastudioDragDropParams, type SeastudioDragEnterParams, type SeastudioDragFileData, type SeastudioDragRootId, type SeastudioDragStartParams, type SeastudioEditorProposalAction, type SeastudioEditorProposalOptions, type SeastudioEditorProposeOptions, type SeastudioFileDownloadOptions, type SeastudioFileInfo, type SeastudioFileInfoOptions, type SeastudioFileListOptions, type SeastudioFileReadOptions, type SeastudioFileSaveAsOptions, type SeastudioFileSearchMatch, type SeastudioFileSearchOptions, type SeastudioFileTransferOptions, type SeastudioFileTreeOptions, type SeastudioFileWriteOptions, type SeastudioFilesystemRoot, type SeastudioFilesystemRootId, SeastudioNotifications, type SeastudioProjectInfo, type SeastudioProposalFile, type SeastudioProposalHunk, SeastudioRequests, type SeastudioRootId, 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 SeastudioWriteReviewMode, type SessionArchiveRequestedParams, type SessionCreatedParams, type SessionDeleteRequestedParams, type SessionNewRequestedParams, type SessionNotificationBase, type SessionRemovedParams, type SessionRenameRequestedParams, type SessionSelectedParams, type SessionSelectedReason, type SessionSnapshotItem, type SessionStateSnapshotParams, type SessionStatus, type SessionStatusParams, type SessionSummaryParams, type TextSendRequestedParams, type TextSendRequestedSelectionRange, type TextSendRequestedSource, agentManagementTools, agentTabTools, allTools, annotateTool, batchFlattenCopyEvidenceOutputSchema, browserRuntimeTools, callTool, callToolText, dualPathEvidenceOutputSchema, editorTools, fileDownloadEvidenceOutputSchema, fileSaveAsEvidenceOutputSchema, fileTools, fileUrlEvidenceOutputSchema, gitTools, pluginManagementTools, pluginTabTools, projectTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, runOneShotShellCommand, seastudio, shellSessionCloseEvidenceOutputSchema, shellSessionOpenEvidenceOutputSchema, shellSessionRunEvidenceOutputSchema, shellSessionSignalEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, skillTools, tools };
+export { type AgentInstanceSessionSnapshot, type AuthSessionChangedParams, type AuthSessionStatus, type AuthSessionUser, type FileDeletedParams, type FileKeepRequestedParams, type FileModifiedParams, type FileOpenRequestedParams, type FileRenamedParams, type FileSavedParams, type FileSelectedParams, type FileSendRequestedParams, type FileTransferRequestedParams, type FilesChangedParams, type GitBranchInfo, type GitBranchesResult, type GitChangeKind, type GitChangedParams, type GitCommitRef, type GitCommitRefType, type GitFileChange, type GitLineChange, type GitLineChangeKind, type GitLogCommit, type GitLogResult, type GitOpenDiffRequestedParams, type GitStatusResult, type GitSummary, type HostAppVisibilityParams, type PluginTabTitleChangedParams, type PluginToolCallCaller, type PluginToolCallEnvelope, type PluginToolCallError, type PluginToolCallTarget, type PluginToolResultEnvelope, type ProposalChangedParams, type ProposalFeedbackFileSummary, type ProposalFeedbackHunk, type ProposalFeedbackOrigin, type ProposalFeedbackParams, type ProposalRecord, type ProposalRequestedFile, type ProposalRequestedHunk, type ProposalRequestedParams, type ProposalStatus, type RootsChangedParams, SINGLETON_BROWSER_ID, type SeastudioBatchFlattenCopyOptions, type SeastudioBatchFlattenPreviewOptions, type SeastudioBrowserCertificateError, type SeastudioBrowserOpenOptions, type SeastudioBrowserState, type SeastudioBrowserStatus, type SeastudioBrowserTab, type SeastudioBrowserViewportBindOptions, type SeastudioBrowserViewportBinding, type SeastudioBrowserViewportRect, type SeastudioDragDropParams, type SeastudioDragEnterParams, type SeastudioDragFileData, type SeastudioDragRootId, type SeastudioDragStartParams, type SeastudioEditorProposalAction, type SeastudioEditorProposalOptions, type SeastudioEditorProposeOptions, type SeastudioFileDownloadOptions, type SeastudioFileInfo, type SeastudioFileInfoOptions, type SeastudioFileListOptions, type SeastudioFileReadOptions, type SeastudioFileSaveAsOptions, type SeastudioFileSearchMatch, type SeastudioFileSearchOptions, type SeastudioFileTransferOptions, type SeastudioFileTreeOptions, type SeastudioFileWriteOptions, type SeastudioFilesystemRoot, type SeastudioFilesystemRootId, SeastudioNotifications, type SeastudioProjectInfo, type SeastudioProposalFile, type SeastudioProposalHunk, SeastudioRequests, type SeastudioRootId, 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 SeastudioWriteReviewMode, type SessionArchiveRequestedParams, type SessionCreatedParams, type SessionDeleteRequestedParams, type SessionNewRequestedParams, type SessionNotificationBase, type SessionRemovedParams, type SessionRenameRequestedParams, type SessionSelectedParams, type SessionSelectedReason, type SessionSnapshotItem, type SessionStateSnapshotParams, type SessionStatus, type SessionStatusParams, type SessionSummaryParams, type TextSendRequestedParams, type TextSendRequestedSelectionRange, type TextSendRequestedSource, agentManagementTools, agentTabTools, allTools, annotateTool, batchFlattenCopyEvidenceOutputSchema, browserTools, callTool, callToolText, dualPathEvidenceOutputSchema, editorTools, fileDownloadEvidenceOutputSchema, fileSaveAsEvidenceOutputSchema, fileTools, fileUrlEvidenceOutputSchema, gitTools, pluginManagementTools, pluginTabTools, projectTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, runOneShotShellCommand, seastudio, shellSessionCloseEvidenceOutputSchema, shellSessionOpenEvidenceOutputSchema, shellSessionRunEvidenceOutputSchema, shellSessionSignalEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, skillTools, tools };

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

@@ -1,4 +1,4 @@
-import { g as MCPTool, h as MCPToolAnnotations, j as MCPToolInputSchema, k as MCPToolResult } from '../../types-D7xY0bt6.js';
+import { g as MCPTool, h as MCPToolAnnotations, j as MCPToolInputSchema, k as MCPToolResult } from '../../types-S2uWCEaN.js';
 
 /**
  * Git 共享类型契约
@@ -336,36 +336,34 @@ interface SeastudioShellOneShotResult {
     durationMs: number;
     timedOut: boolean;
 }
-type SeastudioBrowserRuntimeStatus = 'idle' | 'loading' | 'ready' | 'error';
-interface SeastudioBrowserRuntimeCertificateError {
+type SeastudioBrowserStatus = 'idle' | 'loading' | 'ready' | 'error';
+interface SeastudioBrowserCertificateError {
     requestId: string;
     url: string;
     error: string;
 }
-interface SeastudioBrowserRuntimeTab {
+interface SeastudioBrowserTab {
     id: string;
     title: string;
     url: string | null;
-    status: SeastudioBrowserRuntimeStatus;
+    status: SeastudioBrowserStatus;
     errorMessage: string | null;
     canGoBack: boolean;
     canGoForward: boolean;
-    certificateError?: SeastudioBrowserRuntimeCertificateError | null;
+    certificateError?: SeastudioBrowserCertificateError | null;
     ownerInstanceId?: string;
 }
-interface SeastudioBrowserRuntimeState {
-    browserRuntimeSessionId: string;
+interface SeastudioBrowserState {
+    browserId: string;
     label?: string;
     storagePartitionKey: string;
     homepage: string;
-    tabs: SeastudioBrowserRuntimeTab[];
+    tabs: SeastudioBrowserTab[];
     activeTabId: string | null;
-}
-interface SeastudioBrowserRuntimeSession extends SeastudioBrowserRuntimeState {
     createdAt: number;
     updatedAt: number;
 }
-interface SeastudioBrowserRuntimeSessionOpenOptions {
+interface SeastudioBrowserOpenOptions {
     label?: string;
     storagePartitionKey?: string;
     homepage?: string;
@@ -376,13 +374,13 @@ interface SeastudioBrowserViewportRect {
     width: number;
     height: number;
 }
-interface SeastudioBrowserRuntimeViewportBinding {
-    browserRuntimeSessionId: string;
+interface SeastudioBrowserViewportBinding {
+    browserId: string;
     ownerInstanceId?: string;
     rect: SeastudioBrowserViewportRect;
 }
-interface SeastudioBrowserRuntimeViewportBindOptions {
-    browserRuntimeSessionId?: string;
+interface SeastudioBrowserViewportBindOptions {
+    browserId?: string;
     ownerInstanceId?: string;
 }
 declare function callTool(name: string, args?: Record<string, unknown>): Promise<MCPToolResult>;
@@ -486,72 +484,68 @@ declare const seastudio: {
         };
     };
     browser: {
-        runtimeSession: {
-            open: (options?: SeastudioBrowserRuntimeSessionOpenOptions) => Promise<SeastudioBrowserRuntimeSession>;
-            list: () => Promise<{
-                sessions: SeastudioBrowserRuntimeSession[];
-            }>;
-            get: (browserRuntimeSessionId?: string) => Promise<SeastudioBrowserRuntimeSession>;
-            close: (browserRuntimeSessionId?: string) => Promise<{
-                browserRuntimeSessionId: string;
-                closed: boolean;
-            }>;
-        };
-        runtimeTab: {
-            create: (browserRuntimeSessionId?: string, url?: string, ownerInstanceId?: string) => Promise<{
-                browserRuntimeSessionId: string;
-                tab: SeastudioBrowserRuntimeTab;
+        open: (options?: SeastudioBrowserOpenOptions) => Promise<SeastudioBrowserState>;
+        list: () => Promise<{
+            browsers: SeastudioBrowserState[];
+        }>;
+        get: (browserId?: string) => Promise<SeastudioBrowserState>;
+        close: (browserId?: string) => Promise<{
+            browserId: string;
+            closed: boolean;
+        }>;
+        show: (url: string) => Promise<{
+            url: string;
+            browserId: string;
+            instanceId?: string;
+            tab?: SeastudioBrowserTab;
+        }>;
+        evaluate: <T = unknown>(browserId: string, tabId: string, script: string, timeoutMs?: number) => Promise<{
+            result: T;
+        }>;
+        tab: {
+            create: (browserId?: string, url?: string, ownerInstanceId?: string) => Promise<{
+                browserId: string;
+                tab: SeastudioBrowserTab;
                 activeTabId: string;
             }>;
-            close: (browserRuntimeSessionId: string, tabId: string) => Promise<{
-                browserRuntimeSessionId: string;
+            close: (browserId: string, tabId: string) => Promise<{
+                browserId: string;
                 closedTabId: string;
                 activeTabId: string | null;
             }>;
-            activate: (browserRuntimeSessionId: string, tabId: string) => Promise<{
-                browserRuntimeSessionId: string;
+            activate: (browserId: string, tabId: string) => Promise<{
+                browserId: string;
                 activeTabId: string;
             }>;
-            navigate: (browserRuntimeSessionId: string, tabId: string, url: string) => Promise<{
-                browserRuntimeSessionId: string;
+            navigate: (browserId: string, tabId: string, url: string) => Promise<{
+                browserId: string;
                 tabId: string;
                 url: string;
             }>;
-            goBack: (browserRuntimeSessionId: string, tabId: string) => Promise<{
+            goBack: (browserId: string, tabId: string) => Promise<{
                 ok: boolean;
             }>;
-            goForward: (browserRuntimeSessionId: string, tabId: string) => Promise<{
+            goForward: (browserId: string, tabId: string) => Promise<{
                 ok: boolean;
             }>;
-            reload: (browserRuntimeSessionId: string, tabId: string) => Promise<{
+            reload: (browserId: string, tabId: string) => Promise<{
                 ok: boolean;
             }>;
-            stop: (browserRuntimeSessionId: string, tabId: string) => Promise<{
+            stop: (browserId: string, tabId: string) => Promise<{
                 ok: boolean;
             }>;
             getOrCreateForInstance: (ownerInstanceId: string, url?: string) => Promise<{
-                browserRuntimeSessionId: string;
-                tab: SeastudioBrowserRuntimeTab;
+                browserId: string;
+                tab: SeastudioBrowserTab;
                 activeTabId: string;
                 created: boolean;
             }>;
         };
         viewport: {
-            bind: (rect: SeastudioBrowserViewportRect, options?: SeastudioBrowserRuntimeViewportBindOptions) => Promise<SeastudioBrowserRuntimeViewportBinding>;
-        };
-        runtime: {
-            show: (url: string) => Promise<{
-                url: string;
-                browserRuntimeSessionId: string;
-                instanceId?: string;
-                tab?: SeastudioBrowserRuntimeTab;
-            }>;
-            evaluate: <T = unknown>(browserRuntimeSessionId: string, tabId: string, script: string, timeoutMs?: number) => Promise<{
-                result: T;
-            }>;
+            bind: (rect: SeastudioBrowserViewportRect, options?: SeastudioBrowserViewportBindOptions) => Promise<SeastudioBrowserViewportBinding>;
         };
         certificate: {
-            respond: (browserRuntimeSessionId: string, requestId: string, allow: boolean) => Promise<{
+            respond: (browserId: string, requestId: string, allow: boolean) => Promise<{
                 ok: boolean;
             }>;
         };
@@ -600,8 +594,8 @@ declare const projectTools: MCPTool[];
 
 declare const skillTools: MCPTool[];
 
-declare const SINGLETON_BROWSER_RUNTIME_SESSION_ID = "browser-runtime-session-default";
-declare const browserRuntimeTools: MCPTool[];
+declare const SINGLETON_BROWSER_ID = "browser-default";
+declare const browserTools: MCPTool[];
 
 /**
  * 插件发送给主程序的请求主题
@@ -685,14 +679,14 @@ declare const SeastudioNotifications: {
     readonly PROPOSAL_FEEDBACK: "seastudio:proposal-feedback";
     /** 插件实例请求更新宿主 plugin tab 标题 */
     readonly PLUGIN_TAB_TITLE_CHANGED: "plugin:tab-title_changed";
-    /** BrowserRuntimeSession 状态变化 */
-    readonly BROWSER_RUNTIME_SESSION_CHANGED: "browser-runtime:session_changed";
-    /** BrowserRuntimeSession 关闭 */
-    readonly BROWSER_RUNTIME_SESSION_CLOSED: "browser-runtime:session_closed";
-    /** BrowserRuntimeSession 证书错误，需要客户端 UI 决策 */
-    readonly BROWSER_RUNTIME_CERTIFICATE_ERROR: "browser-runtime:certificate_error";
-    /** BrowserRuntimeSession 收到网页新标签请求 */
-    readonly BROWSER_RUNTIME_NEW_TAB_REQUESTED: "browser-runtime:new_tab_requested";
+    /** Browser 状态变化 */
+    readonly BROWSER_STATE_CHANGED: "browser:state_changed";
+    /** Browser 关闭 */
+    readonly BROWSER_CLOSED: "browser:closed";
+    /** Browser 证书错误，需要客户端 UI 决策 */
+    readonly BROWSER_CERTIFICATE_ERROR: "browser:certificate_error";
+    /** Browser 收到网页新标签请求 */
+    readonly BROWSER_NEW_TAB_REQUESTED: "browser:new_tab_requested";
     /**
      * Agent 对话 session：新建。消息历史仍由 Agent 前端持有，宿主仅同步列表用于侧栏。
      * 通常由 Agent 通过 notifications/publish 发出；其他订阅者（含 host-ui）可据此更新 UI。
@@ -741,6 +735,10 @@ declare const SeastudioNotifications: {
     readonly HOST_APP_VISIBILITY: "host:app_visibility";
     /** Host MCP tools/list 发生变化（例如 Seaflow bridge 动态注册工具） */
     readonly RUNTIME_TOOLS_CHANGED: "mcp:runtime_tools_changed";
+    /** Host 精确路由到插件实例的工具调用请求 */
+    readonly PLUGIN_TOOL_CALL: "plugin:tool_call";
+    /** 插件实例返回给 Host 的工具调用结果 */
+    readonly PLUGIN_TOOL_RESULT: "plugin:tool_result";
     /** 主程序用户登录态变化；不包含访问令牌 */
     readonly AUTH_SESSION_CHANGED: "auth:session_changed";
 };
@@ -814,6 +812,39 @@ interface AuthSessionChangedParams {
         user: AuthSessionUser | null;
     };
 }
+interface PluginToolCallCaller {
+    type: 'agent' | 'plugin' | 'host';
+    agentInstanceId?: string;
+    pluginId?: string;
+    pluginInstanceId?: string;
+    projectId?: string;
+    threadId?: string;
+}
+interface PluginToolCallTarget {
+    providerId: string;
+    pluginId: string;
+    pluginInstanceId: string;
+    contractHash: string;
+}
+interface PluginToolCallEnvelope {
+    callId: string;
+    caller: PluginToolCallCaller;
+    target: PluginToolCallTarget;
+    toolName: string;
+    arguments: Record<string, unknown>;
+    timeoutMs: number;
+}
+interface PluginToolCallError {
+    name?: string;
+    message: string;
+    code?: string;
+    details?: unknown;
+}
+interface PluginToolResultEnvelope {
+    callId: string;
+    result?: unknown;
+    error?: PluginToolCallError;
+}
 interface SeastudioDragFileData {
     sourcePath: string;
     sourceRootId?: SeastudioDragRootId;
@@ -1102,4 +1133,4 @@ interface HostAppVisibilityParams {
 declare const allTools: MCPTool[];
 declare const tools: MCPTool[];
 
-export { type AgentInstanceSessionSnapshot, type AuthSessionChangedParams, type AuthSessionStatus, type AuthSessionUser, type FileDeletedParams, type FileKeepRequestedParams, type FileModifiedParams, type FileOpenRequestedParams, type FileRenamedParams, type FileSavedParams, type FileSelectedParams, type FileSendRequestedParams, type FileTransferRequestedParams, type FilesChangedParams, type GitBranchInfo, type GitBranchesResult, type GitChangeKind, type GitChangedParams, type GitCommitRef, type GitCommitRefType, type GitFileChange, type GitLineChange, type GitLineChangeKind, type GitLogCommit, type GitLogResult, type GitOpenDiffRequestedParams, type GitStatusResult, type GitSummary, type HostAppVisibilityParams, type PluginTabTitleChangedParams, type ProposalChangedParams, type ProposalFeedbackFileSummary, type ProposalFeedbackHunk, type ProposalFeedbackOrigin, type ProposalFeedbackParams, type ProposalRecord, type ProposalRequestedFile, type ProposalRequestedHunk, type ProposalRequestedParams, type ProposalStatus, type RootsChangedParams, SINGLETON_BROWSER_RUNTIME_SESSION_ID, type SeastudioBatchFlattenCopyOptions, type SeastudioBatchFlattenPreviewOptions, type SeastudioBrowserRuntimeCertificateError, type SeastudioBrowserRuntimeSession, type SeastudioBrowserRuntimeSessionOpenOptions, type SeastudioBrowserRuntimeState, type SeastudioBrowserRuntimeStatus, type SeastudioBrowserRuntimeTab, type SeastudioBrowserRuntimeViewportBindOptions, type SeastudioBrowserRuntimeViewportBinding, type SeastudioBrowserViewportRect, type SeastudioDragDropParams, type SeastudioDragEnterParams, type SeastudioDragFileData, type SeastudioDragRootId, type SeastudioDragStartParams, type SeastudioEditorProposalAction, type SeastudioEditorProposalOptions, type SeastudioEditorProposeOptions, type SeastudioFileDownloadOptions, type SeastudioFileInfo, type SeastudioFileInfoOptions, type SeastudioFileListOptions, type SeastudioFileReadOptions, type SeastudioFileSaveAsOptions, type SeastudioFileSearchMatch, type SeastudioFileSearchOptions, type SeastudioFileTransferOptions, type SeastudioFileTreeOptions, type SeastudioFileWriteOptions, type SeastudioFilesystemRoot, type SeastudioFilesystemRootId, SeastudioNotifications, type SeastudioProjectInfo, type SeastudioProposalFile, type SeastudioProposalHunk, SeastudioRequests, type SeastudioRootId, 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 SeastudioWriteReviewMode, type SessionArchiveRequestedParams, type SessionCreatedParams, type SessionDeleteRequestedParams, type SessionNewRequestedParams, type SessionNotificationBase, type SessionRemovedParams, type SessionRenameRequestedParams, type SessionSelectedParams, type SessionSelectedReason, type SessionSnapshotItem, type SessionStateSnapshotParams, type SessionStatus, type SessionStatusParams, type SessionSummaryParams, type TextSendRequestedParams, type TextSendRequestedSelectionRange, type TextSendRequestedSource, agentManagementTools, agentTabTools, allTools, annotateTool, batchFlattenCopyEvidenceOutputSchema, browserRuntimeTools, callTool, callToolText, dualPathEvidenceOutputSchema, editorTools, fileDownloadEvidenceOutputSchema, fileSaveAsEvidenceOutputSchema, fileTools, fileUrlEvidenceOutputSchema, gitTools, pluginManagementTools, pluginTabTools, projectTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, runOneShotShellCommand, seastudio, shellSessionCloseEvidenceOutputSchema, shellSessionOpenEvidenceOutputSchema, shellSessionRunEvidenceOutputSchema, shellSessionSignalEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, skillTools, tools };
+export { type AgentInstanceSessionSnapshot, type AuthSessionChangedParams, type AuthSessionStatus, type AuthSessionUser, type FileDeletedParams, type FileKeepRequestedParams, type FileModifiedParams, type FileOpenRequestedParams, type FileRenamedParams, type FileSavedParams, type FileSelectedParams, type FileSendRequestedParams, type FileTransferRequestedParams, type FilesChangedParams, type GitBranchInfo, type GitBranchesResult, type GitChangeKind, type GitChangedParams, type GitCommitRef, type GitCommitRefType, type GitFileChange, type GitLineChange, type GitLineChangeKind, type GitLogCommit, type GitLogResult, type GitOpenDiffRequestedParams, type GitStatusResult, type GitSummary, type HostAppVisibilityParams, type PluginTabTitleChangedParams, type PluginToolCallCaller, type PluginToolCallEnvelope, type PluginToolCallError, type PluginToolCallTarget, type PluginToolResultEnvelope, type ProposalChangedParams, type ProposalFeedbackFileSummary, type ProposalFeedbackHunk, type ProposalFeedbackOrigin, type ProposalFeedbackParams, type ProposalRecord, type ProposalRequestedFile, type ProposalRequestedHunk, type ProposalRequestedParams, type ProposalStatus, type RootsChangedParams, SINGLETON_BROWSER_ID, type SeastudioBatchFlattenCopyOptions, type SeastudioBatchFlattenPreviewOptions, type SeastudioBrowserCertificateError, type SeastudioBrowserOpenOptions, type SeastudioBrowserState, type SeastudioBrowserStatus, type SeastudioBrowserTab, type SeastudioBrowserViewportBindOptions, type SeastudioBrowserViewportBinding, type SeastudioBrowserViewportRect, type SeastudioDragDropParams, type SeastudioDragEnterParams, type SeastudioDragFileData, type SeastudioDragRootId, type SeastudioDragStartParams, type SeastudioEditorProposalAction, type SeastudioEditorProposalOptions, type SeastudioEditorProposeOptions, type SeastudioFileDownloadOptions, type SeastudioFileInfo, type SeastudioFileInfoOptions, type SeastudioFileListOptions, type SeastudioFileReadOptions, type SeastudioFileSaveAsOptions, type SeastudioFileSearchMatch, type SeastudioFileSearchOptions, type SeastudioFileTransferOptions, type SeastudioFileTreeOptions, type SeastudioFileWriteOptions, type SeastudioFilesystemRoot, type SeastudioFilesystemRootId, SeastudioNotifications, type SeastudioProjectInfo, type SeastudioProposalFile, type SeastudioProposalHunk, SeastudioRequests, type SeastudioRootId, 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 SeastudioWriteReviewMode, type SessionArchiveRequestedParams, type SessionCreatedParams, type SessionDeleteRequestedParams, type SessionNewRequestedParams, type SessionNotificationBase, type SessionRemovedParams, type SessionRenameRequestedParams, type SessionSelectedParams, type SessionSelectedReason, type SessionSnapshotItem, type SessionStateSnapshotParams, type SessionStatus, type SessionStatusParams, type SessionSummaryParams, type TextSendRequestedParams, type TextSendRequestedSelectionRange, type TextSendRequestedSource, agentManagementTools, agentTabTools, allTools, annotateTool, batchFlattenCopyEvidenceOutputSchema, browserTools, callTool, callToolText, dualPathEvidenceOutputSchema, editorTools, fileDownloadEvidenceOutputSchema, fileSaveAsEvidenceOutputSchema, fileTools, fileUrlEvidenceOutputSchema, gitTools, pluginManagementTools, pluginTabTools, projectTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, runOneShotShellCommand, seastudio, shellSessionCloseEvidenceOutputSchema, shellSessionOpenEvidenceOutputSchema, shellSessionRunEvidenceOutputSchema, shellSessionSignalEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, skillTools, tools };

package/dist/mcp/seastudio/index.js

@@ -1,2 +1,2 @@
-export { SINGLETON_BROWSER_RUNTIME_SESSION_ID, SeastudioNotifications, SeastudioRequests, agentManagementTools, agentTabTools, allTools, annotateTool, batchFlattenCopyEvidenceOutputSchema, browserRuntimeTools, callTool, callToolText, dualPathEvidenceOutputSchema, editorTools, fileDownloadEvidenceOutputSchema, fileSaveAsEvidenceOutputSchema, fileTools, fileUrlEvidenceOutputSchema, gitTools, pluginManagementTools, pluginTabTools, projectTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, runOneShotShellCommand, seastudio, shellSessionCloseEvidenceOutputSchema, shellSessionOpenEvidenceOutputSchema, shellSessionRunEvidenceOutputSchema, shellSessionSignalEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, skillTools, tools } from '../../chunk-FNA3TFHQ.js';
-import '../../chunk-TJ3CGHWJ.js';
+export { SINGLETON_BROWSER_ID, SeastudioNotifications, SeastudioRequests, agentManagementTools, agentTabTools, allTools, annotateTool, batchFlattenCopyEvidenceOutputSchema, browserTools, callTool, callToolText, dualPathEvidenceOutputSchema, editorTools, fileDownloadEvidenceOutputSchema, fileSaveAsEvidenceOutputSchema, fileTools, fileUrlEvidenceOutputSchema, gitTools, pluginManagementTools, pluginTabTools, projectTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, runOneShotShellCommand, seastudio, shellSessionCloseEvidenceOutputSchema, shellSessionOpenEvidenceOutputSchema, shellSessionRunEvidenceOutputSchema, shellSessionSignalEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, skillTools, tools } from '../../chunk-352PJTT7.js';
+import '../../chunk-6XG5DRQW.js';

package/dist/{types-D7xY0bt6.d.cts → types-S2uWCEaN.d.cts}

@@ -43,7 +43,7 @@ interface MCPToolInputSchema {
 interface MCPToolAnnotations {
     operationKind?: 'read' | 'mutate' | 'system' | 'workflow';
     requiresExecutionEvidence?: boolean;
-    rawDomain?: 'workspace' | 'filesystem' | 'editor' | 'seaflow' | 'asset' | 'git' | 'preview' | 'shell' | 'browser' | 'excel' | 'word' | 'skill' | `plugin-${string}`;
+    rawDomain?: 'workspace' | 'filesystem' | 'editor' | 'seaflow' | 'asset' | 'git' | 'preview' | 'shell' | 'browser' | 'webview' | 'excel' | 'word' | 'skill' | `plugin-${string}`;
     hostForwarding?: {
         timeoutMs?: number;
     };

package/dist/{types-D7xY0bt6.d.ts → types-S2uWCEaN.d.ts}

@@ -43,7 +43,7 @@ interface MCPToolInputSchema {
 interface MCPToolAnnotations {
     operationKind?: 'read' | 'mutate' | 'system' | 'workflow';
     requiresExecutionEvidence?: boolean;
-    rawDomain?: 'workspace' | 'filesystem' | 'editor' | 'seaflow' | 'asset' | 'git' | 'preview' | 'shell' | 'browser' | 'excel' | 'word' | 'skill' | `plugin-${string}`;
+    rawDomain?: 'workspace' | 'filesystem' | 'editor' | 'seaflow' | 'asset' | 'git' | 'preview' | 'shell' | 'browser' | 'webview' | 'excel' | 'word' | 'skill' | `plugin-${string}`;
     hostForwarding?: {
         timeoutMs?: number;
     };

package/package.json

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