@seastudio/sdk 4.0.9 → 4.0.11

package/dist/{chunk-KK6HF3XF.cjs → chunk-5OEF32AG.cjs}

@@ -65,6 +65,17 @@ var fileDownloadEvidenceOutputSchema = {
   },
   required: ["location", "path", "savedPath", "size"]
 };
+var fileSaveAsEvidenceOutputSchema = {
+  type: "object",
+  properties: {
+    rootId: { type: "string" },
+    path: { type: "string" },
+    savedPath: { type: "string" },
+    canceled: { type: "boolean" },
+    copied: { type: "boolean" }
+  },
+  required: ["rootId", "path", "canceled", "copied"]
+};
 var fileUrlEvidenceOutputSchema = {
   type: "object",
   properties: {
@@ -227,13 +238,13 @@ var fileTools = [
   }),
   annotateTool({
     name: "seastudio-filesystem_transfer",
-    description: "\u5904\u7406\u6587\u4EF6 URL\u3001\u8FDC\u7A0B\u4E0B\u8F7D\u3001\u590D\u5236\u7C98\u8D34\u548C\u526A\u8D34\u677F\u7B49\u7CFB\u7EDF\u6216\u5916\u90E8\u4EA4\u4E92\u3002\u4F7F\u7528 action \u9009\u62E9 getUrl\u3001download\u3001copy\u3001paste\u3001clipboardCheck \u6216 copyPath\u3002copy \u652F\u6301\u901A\u8FC7 path \u590D\u5236\u5355\u4E2A\u9879\u76EE\uFF0C\u6216\u901A\u8FC7 paths \u4E00\u6B21\u590D\u5236/\u526A\u5207\u591A\u4E2A\u9879\u76EE\u3002",
+    description: "\u5904\u7406\u6587\u4EF6 URL\u3001\u8FDC\u7A0B\u4E0B\u8F7D\u3001\u539F\u751F\u53E6\u5B58\u4E3A\u3001\u590D\u5236\u7C98\u8D34\u548C\u526A\u8D34\u677F\u7B49\u7CFB\u7EDF\u6216\u5916\u90E8\u4EA4\u4E92\u3002\u4F7F\u7528 action \u9009\u62E9 getUrl\u3001download\u3001saveAs\u3001copy\u3001paste\u3001clipboardCheck \u6216 copyPath\u3002copy \u652F\u6301\u901A\u8FC7 path \u590D\u5236\u5355\u4E2A\u9879\u76EE\uFF0C\u6216\u901A\u8FC7 paths \u4E00\u6B21\u590D\u5236/\u526A\u5207\u591A\u4E2A\u9879\u76EE\u3002",
     inputSchema: {
       type: "object",
       properties: {
         action: {
           type: "string",
-          enum: ["getUrl", "download", "copy", "paste", "clipboardCheck", "copyPath"],
+          enum: ["getUrl", "download", "saveAs", "copy", "paste", "clipboardCheck", "copyPath"],
           description: "\u6587\u4EF6\u4F20\u8F93\u6216\u526A\u8D34\u677F\u52A8\u4F5C\u3002"
         },
         rootId: rootIdParam,
@@ -250,7 +261,9 @@ var fileTools = [
         },
         url: { type: "string", description: "download \u7684\u8FDC\u7A0B\u6587\u4EF6 URL\u3002" },
         absoluteDir: { type: "string", description: "download \u7684\u672C\u5730\u7EDD\u5BF9\u4FDD\u5B58\u76EE\u5F55\uFF08\u53EF\u9009\uFF09\u3002" },
-        filenameHint: { type: "string", description: "download \u7684\u6587\u4EF6\u540D\u63D0\u793A\uFF08\u53EF\u9009\uFF09\u3002" }
+        filenameHint: { type: "string", description: "download \u7684\u6587\u4EF6\u540D\u63D0\u793A\uFF08\u53EF\u9009\uFF09\u3002" },
+        defaultPath: { type: "string", description: "saveAs \u7684\u9ED8\u8BA4\u4FDD\u5B58\u6587\u4EF6\u540D\u6216\u8DEF\u5F84\uFF08\u53EF\u9009\uFF09\u3002" },
+        title: { type: "string", description: "saveAs \u539F\u751F\u4FDD\u5B58\u5BF9\u8BDD\u6846\u6807\u9898\uFF08\u53EF\u9009\uFF09\u3002" }
       },
       required: ["action"]
     }
@@ -816,6 +829,12 @@ var seastudio = {
       }
       return callFilesystemTransfer("download", { rootId: options?.rootId ?? "workspace", path, url, filenameHint });
     },
+    saveAs: (path, options) => callFilesystemTransfer("saveAs", {
+      rootId: options?.rootId ?? "workspace",
+      path,
+      ...typeof options?.defaultPath === "string" ? { defaultPath: options.defaultPath } : {},
+      ...typeof options?.title === "string" ? { title: options.title } : {}
+    }),
     writeBinary: (path, base64, options) => callFilesystemMutate("writeBinary", { rootId: options?.rootId ?? "workspace", path, base64 }),
     readBinary: (path, options) => callFilesystemRead("readBinary", { rootId: options?.rootId ?? "workspace", path })
   },
@@ -1213,7 +1232,12 @@ var SeastudioNotifications = {
    * 宿主请求 Agent 删除/关闭某条对话会话（例如侧栏会话行「×」）。
    * 通过 notifications/publish + publishTo 定向到对应 Agent 实例。
    */
-  SESSION_DELETE_REQUESTED: "session:delete_requested"
+  SESSION_DELETE_REQUESTED: "session:delete_requested",
+  /**
+   * SeaStudio 主窗口前后台变化（blur/focus）。
+   * Agent 订阅后同步后端 host visibility，用于 session 完成 unread 策略。
+   */
+  HOST_APP_VISIBILITY: "host:app_visibility"
 };
 
 // src/mcp/seastudio/index.ts
@@ -1247,6 +1271,7 @@ exports.callToolText = callToolText;
 exports.dualPathEvidenceOutputSchema = dualPathEvidenceOutputSchema;
 exports.editorTools = editorTools;
 exports.fileDownloadEvidenceOutputSchema = fileDownloadEvidenceOutputSchema;
+exports.fileSaveAsEvidenceOutputSchema = fileSaveAsEvidenceOutputSchema;
 exports.fileTools = fileTools;
 exports.fileUrlEvidenceOutputSchema = fileUrlEvidenceOutputSchema;
 exports.gitTools = gitTools;

package/dist/{chunk-ZDUIJOH2.js → chunk-BRYHXO22.js}

@@ -63,6 +63,17 @@ var fileDownloadEvidenceOutputSchema = {
   },
   required: ["location", "path", "savedPath", "size"]
 };
+var fileSaveAsEvidenceOutputSchema = {
+  type: "object",
+  properties: {
+    rootId: { type: "string" },
+    path: { type: "string" },
+    savedPath: { type: "string" },
+    canceled: { type: "boolean" },
+    copied: { type: "boolean" }
+  },
+  required: ["rootId", "path", "canceled", "copied"]
+};
 var fileUrlEvidenceOutputSchema = {
   type: "object",
   properties: {
@@ -225,13 +236,13 @@ var fileTools = [
   }),
   annotateTool({
     name: "seastudio-filesystem_transfer",
-    description: "\u5904\u7406\u6587\u4EF6 URL\u3001\u8FDC\u7A0B\u4E0B\u8F7D\u3001\u590D\u5236\u7C98\u8D34\u548C\u526A\u8D34\u677F\u7B49\u7CFB\u7EDF\u6216\u5916\u90E8\u4EA4\u4E92\u3002\u4F7F\u7528 action \u9009\u62E9 getUrl\u3001download\u3001copy\u3001paste\u3001clipboardCheck \u6216 copyPath\u3002copy \u652F\u6301\u901A\u8FC7 path \u590D\u5236\u5355\u4E2A\u9879\u76EE\uFF0C\u6216\u901A\u8FC7 paths \u4E00\u6B21\u590D\u5236/\u526A\u5207\u591A\u4E2A\u9879\u76EE\u3002",
+    description: "\u5904\u7406\u6587\u4EF6 URL\u3001\u8FDC\u7A0B\u4E0B\u8F7D\u3001\u539F\u751F\u53E6\u5B58\u4E3A\u3001\u590D\u5236\u7C98\u8D34\u548C\u526A\u8D34\u677F\u7B49\u7CFB\u7EDF\u6216\u5916\u90E8\u4EA4\u4E92\u3002\u4F7F\u7528 action \u9009\u62E9 getUrl\u3001download\u3001saveAs\u3001copy\u3001paste\u3001clipboardCheck \u6216 copyPath\u3002copy \u652F\u6301\u901A\u8FC7 path \u590D\u5236\u5355\u4E2A\u9879\u76EE\uFF0C\u6216\u901A\u8FC7 paths \u4E00\u6B21\u590D\u5236/\u526A\u5207\u591A\u4E2A\u9879\u76EE\u3002",
     inputSchema: {
       type: "object",
       properties: {
         action: {
           type: "string",
-          enum: ["getUrl", "download", "copy", "paste", "clipboardCheck", "copyPath"],
+          enum: ["getUrl", "download", "saveAs", "copy", "paste", "clipboardCheck", "copyPath"],
           description: "\u6587\u4EF6\u4F20\u8F93\u6216\u526A\u8D34\u677F\u52A8\u4F5C\u3002"
         },
         rootId: rootIdParam,
@@ -248,7 +259,9 @@ var fileTools = [
         },
         url: { type: "string", description: "download \u7684\u8FDC\u7A0B\u6587\u4EF6 URL\u3002" },
         absoluteDir: { type: "string", description: "download \u7684\u672C\u5730\u7EDD\u5BF9\u4FDD\u5B58\u76EE\u5F55\uFF08\u53EF\u9009\uFF09\u3002" },
-        filenameHint: { type: "string", description: "download \u7684\u6587\u4EF6\u540D\u63D0\u793A\uFF08\u53EF\u9009\uFF09\u3002" }
+        filenameHint: { type: "string", description: "download \u7684\u6587\u4EF6\u540D\u63D0\u793A\uFF08\u53EF\u9009\uFF09\u3002" },
+        defaultPath: { type: "string", description: "saveAs \u7684\u9ED8\u8BA4\u4FDD\u5B58\u6587\u4EF6\u540D\u6216\u8DEF\u5F84\uFF08\u53EF\u9009\uFF09\u3002" },
+        title: { type: "string", description: "saveAs \u539F\u751F\u4FDD\u5B58\u5BF9\u8BDD\u6846\u6807\u9898\uFF08\u53EF\u9009\uFF09\u3002" }
       },
       required: ["action"]
     }
@@ -814,6 +827,12 @@ var seastudio = {
       }
       return callFilesystemTransfer("download", { rootId: options?.rootId ?? "workspace", path, url, filenameHint });
     },
+    saveAs: (path, options) => callFilesystemTransfer("saveAs", {
+      rootId: options?.rootId ?? "workspace",
+      path,
+      ...typeof options?.defaultPath === "string" ? { defaultPath: options.defaultPath } : {},
+      ...typeof options?.title === "string" ? { title: options.title } : {}
+    }),
     writeBinary: (path, base64, options) => callFilesystemMutate("writeBinary", { rootId: options?.rootId ?? "workspace", path, base64 }),
     readBinary: (path, options) => callFilesystemRead("readBinary", { rootId: options?.rootId ?? "workspace", path })
   },
@@ -1211,7 +1230,12 @@ var SeastudioNotifications = {
    * 宿主请求 Agent 删除/关闭某条对话会话（例如侧栏会话行「×」）。
    * 通过 notifications/publish + publishTo 定向到对应 Agent 实例。
    */
-  SESSION_DELETE_REQUESTED: "session:delete_requested"
+  SESSION_DELETE_REQUESTED: "session:delete_requested",
+  /**
+   * SeaStudio 主窗口前后台变化（blur/focus）。
+   * Agent 订阅后同步后端 host visibility，用于 session 完成 unread 策略。
+   */
+  HOST_APP_VISIBILITY: "host:app_visibility"
 };
 
 // src/mcp/seastudio/index.ts
@@ -1231,4 +1255,4 @@ var allTools = [
 ];
 var tools = allTools;
 
-export { SINGLETON_BROWSER_SESSION_ID, SeastudioNotifications, SeastudioRequests, agentManagementTools, agentTabTools, allTools, annotateTool, batchFlattenCopyEvidenceOutputSchema, browserRuntimeTools, callTool, callToolText, dualPathEvidenceOutputSchema, editorTools, fileDownloadEvidenceOutputSchema, fileTools, fileUrlEvidenceOutputSchema, gitTools, pluginManagementTools, pluginTabTools, projectTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, runOneShotShellCommand, seaCloudTools, seastudio, shellSessionCloseEvidenceOutputSchema, shellSessionOpenEvidenceOutputSchema, shellSessionRunEvidenceOutputSchema, shellSessionSignalEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, skillTools, tools };
+export { SINGLETON_BROWSER_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, seaCloudTools, seastudio, shellSessionCloseEvidenceOutputSchema, shellSessionOpenEvidenceOutputSchema, shellSessionRunEvidenceOutputSchema, shellSessionSignalEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, skillTools, tools };

package/dist/{chunk-7FYD7672.cjs → chunk-F7ATDLVY.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkKK6HF3XF_cjs = require('./chunk-KK6HF3XF.cjs');
+var chunk5OEF32AG_cjs = require('./chunk-5OEF32AG.cjs');
 var chunk3I7UM66P_cjs = require('./chunk-3I7UM66P.cjs');
 
 // src/mcp/index.ts
@@ -11,7 +11,7 @@ async function loadPlugin(pluginName) {
   throw new Error(`Unknown plugin: ${pluginName}. \u63D2\u4EF6 MCP \u4E0D\u518D\u901A\u8FC7 SDK \u9759\u6001\u5BFC\u5165\u3002`);
 }
 var MCP_PACKAGES = [
-  { id: "seastudio", name: "SeaStudio", description: "\u6587\u4EF6/Shell/AIGC \u57FA\u7840\u80FD\u529B", tools: chunkKK6HF3XF_cjs.allTools }
+  { id: "seastudio", name: "SeaStudio", description: "\u6587\u4EF6/Shell/AIGC \u57FA\u7840\u80FD\u529B", tools: chunk5OEF32AG_cjs.allTools }
 ];
 function mcpToolToOpenAI(tool) {
   const normalizedTool = chunk3I7UM66P_cjs.normalizeMCPTool(tool);
@@ -29,7 +29,7 @@ function mcpToolToOpenAI(tool) {
   };
 }
 function listAllTools() {
-  return [...chunkKK6HF3XF_cjs.allTools];
+  return [...chunk5OEF32AG_cjs.allTools];
 }
 function toPackageName(source) {
   if (source === "seastudio") {
@@ -62,7 +62,7 @@ function normalizeAvailableTool(raw) {
   };
 }
 var MCP_TOOL_PACKAGE_INDEX = new Map(
-  chunkKK6HF3XF_cjs.allTools.map((tool) => [tool.name, "seastudio"])
+  chunk5OEF32AG_cjs.allTools.map((tool) => [tool.name, "seastudio"])
 );
 function getMCPToolPackageIndex() {
   return new Map(MCP_TOOL_PACKAGE_INDEX);

package/dist/{chunk-EHA26OJY.js → chunk-QZTDCMJU.js}

@@ -1,4 +1,4 @@
-import { allTools } from './chunk-ZDUIJOH2.js';
+import { allTools } from './chunk-BRYHXO22.js';
 import { normalizeMCPTool, normalizeMCPToolObjectSchema, getDefaultClient } from './chunk-TJ3CGHWJ.js';
 
 // src/mcp/index.ts

package/dist/index.cjs

@@ -1,51 +1,51 @@
 'use strict';
 
-var chunk7FYD7672_cjs = require('./chunk-7FYD7672.cjs');
+var chunkF7ATDLVY_cjs = require('./chunk-F7ATDLVY.cjs');
 var chunk2L26XL3M_cjs = require('./chunk-2L26XL3M.cjs');
-var chunkKK6HF3XF_cjs = require('./chunk-KK6HF3XF.cjs');
+var chunk5OEF32AG_cjs = require('./chunk-5OEF32AG.cjs');
 var chunk3I7UM66P_cjs = require('./chunk-3I7UM66P.cjs');
 
 
 
 Object.defineProperty(exports, "MCP_PACKAGES", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.MCP_PACKAGES; }
+  get: function () { return chunkF7ATDLVY_cjs.MCP_PACKAGES; }
 });
 Object.defineProperty(exports, "getMCPPackageIdForTool", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.getMCPPackageIdForTool; }
+  get: function () { return chunkF7ATDLVY_cjs.getMCPPackageIdForTool; }
 });
 Object.defineProperty(exports, "getMCPPackages", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.getMCPPackages; }
+  get: function () { return chunkF7ATDLVY_cjs.getMCPPackages; }
 });
 Object.defineProperty(exports, "getMCPToolPackageIndex", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.getMCPToolPackageIndex; }
+  get: function () { return chunkF7ATDLVY_cjs.getMCPToolPackageIndex; }
 });
 Object.defineProperty(exports, "getToolsForLLM", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.getToolsForLLM; }
+  get: function () { return chunkF7ATDLVY_cjs.getToolsForLLM; }
 });
 Object.defineProperty(exports, "listAllTools", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.listAllTools; }
+  get: function () { return chunkF7ATDLVY_cjs.listAllTools; }
 });
 Object.defineProperty(exports, "listAvailableTools", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.listAvailableTools; }
+  get: function () { return chunkF7ATDLVY_cjs.listAvailableTools; }
 });
 Object.defineProperty(exports, "listAvailableToolsForLLM", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.listAvailableToolsForLLM; }
+  get: function () { return chunkF7ATDLVY_cjs.listAvailableToolsForLLM; }
 });
 Object.defineProperty(exports, "loadPlugin", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.loadPlugin; }
+  get: function () { return chunkF7ATDLVY_cjs.loadPlugin; }
 });
 Object.defineProperty(exports, "mcpToolToOpenAI", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.mcpToolToOpenAI; }
+  get: function () { return chunkF7ATDLVY_cjs.mcpToolToOpenAI; }
 });
 Object.defineProperty(exports, "DialogBody", {
   enumerable: true,
@@ -101,51 +101,51 @@ Object.defineProperty(exports, "showHostContextMenu", {
 });
 Object.defineProperty(exports, "SeastudioNotifications", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.SeastudioNotifications; }
+  get: function () { return chunk5OEF32AG_cjs.SeastudioNotifications; }
 });
 Object.defineProperty(exports, "SeastudioRequests", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.SeastudioRequests; }
+  get: function () { return chunk5OEF32AG_cjs.SeastudioRequests; }
 });
 Object.defineProperty(exports, "agentManagementTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.agentManagementTools; }
+  get: function () { return chunk5OEF32AG_cjs.agentManagementTools; }
 });
 Object.defineProperty(exports, "agentTabTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.agentTabTools; }
+  get: function () { return chunk5OEF32AG_cjs.agentTabTools; }
 });
 Object.defineProperty(exports, "fileTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.fileTools; }
+  get: function () { return chunk5OEF32AG_cjs.fileTools; }
 });
 Object.defineProperty(exports, "pluginManagementTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.pluginManagementTools; }
+  get: function () { return chunk5OEF32AG_cjs.pluginManagementTools; }
 });
 Object.defineProperty(exports, "pluginTabTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.pluginTabTools; }
+  get: function () { return chunk5OEF32AG_cjs.pluginTabTools; }
 });
 Object.defineProperty(exports, "seaCloudTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.seaCloudTools; }
+  get: function () { return chunk5OEF32AG_cjs.seaCloudTools; }
 });
 Object.defineProperty(exports, "seastudio", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.seastudio; }
+  get: function () { return chunk5OEF32AG_cjs.seastudio; }
 });
 Object.defineProperty(exports, "seastudioAllTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.allTools; }
+  get: function () { return chunk5OEF32AG_cjs.allTools; }
 });
 Object.defineProperty(exports, "seastudioTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.tools; }
+  get: function () { return chunk5OEF32AG_cjs.tools; }
 });
 Object.defineProperty(exports, "shellTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.shellTools; }
+  get: function () { return chunk5OEF32AG_cjs.shellTools; }
 });
 Object.defineProperty(exports, "MCPClient", {
   enumerable: true,

package/dist/index.js

@@ -1,4 +1,4 @@
-export { MCP_PACKAGES, getMCPPackageIdForTool, getMCPPackages, getMCPToolPackageIndex, getToolsForLLM, listAllTools, listAvailableTools, listAvailableToolsForLLM, loadPlugin, mcpToolToOpenAI } from './chunk-EHA26OJY.js';
+export { MCP_PACKAGES, getMCPPackageIdForTool, getMCPPackages, getMCPToolPackageIndex, getToolsForLLM, listAllTools, listAvailableTools, listAvailableToolsForLLM, loadPlugin, mcpToolToOpenAI } from './chunk-QZTDCMJU.js';
 export { DialogBody, DialogButton, DialogContainer, DialogFooter, DialogHeader, DialogOverlay, MenuContainer, MenuEmpty, MenuItem, MenuSeparator, Tab, cn, showHostContextMenu } from './chunk-BIOX6KGR.js';
-export { SeastudioNotifications, SeastudioRequests, agentManagementTools, agentTabTools, fileTools, pluginManagementTools, pluginTabTools, seaCloudTools, seastudio, allTools as seastudioAllTools, tools as seastudioTools, shellTools } from './chunk-ZDUIJOH2.js';
+export { SeastudioNotifications, SeastudioRequests, agentManagementTools, agentTabTools, fileTools, pluginManagementTools, pluginTabTools, seaCloudTools, seastudio, allTools as seastudioAllTools, tools as seastudioTools, shellTools } from './chunk-BRYHXO22.js';
 export { MCPClient, MCPServer, PostMessageTransport, callHostTool, callHostToolText, createMCPClient, createMCPServer, createNotification, createRequest, createResponse, getDefaultClient, getDefaultServer, getDefaultTransport, isMCPMessage, isNotification, normalizeMCPTool, normalizeMCPToolInputSchema, normalizeMCPToolObjectSchema, setDefaultClient, setDefaultTransport, startDefaultServer } from './chunk-TJ3CGHWJ.js';

package/dist/mcp/index.cjs

@@ -1,98 +1,98 @@
 'use strict';
 
-var chunk7FYD7672_cjs = require('../chunk-7FYD7672.cjs');
-var chunkKK6HF3XF_cjs = require('../chunk-KK6HF3XF.cjs');
+var chunkF7ATDLVY_cjs = require('../chunk-F7ATDLVY.cjs');
+var chunk5OEF32AG_cjs = require('../chunk-5OEF32AG.cjs');
 var chunk3I7UM66P_cjs = require('../chunk-3I7UM66P.cjs');
 
 
 
 Object.defineProperty(exports, "MCP_PACKAGES", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.MCP_PACKAGES; }
+  get: function () { return chunkF7ATDLVY_cjs.MCP_PACKAGES; }
 });
 Object.defineProperty(exports, "getMCPPackageIdForTool", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.getMCPPackageIdForTool; }
+  get: function () { return chunkF7ATDLVY_cjs.getMCPPackageIdForTool; }
 });
 Object.defineProperty(exports, "getMCPPackages", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.getMCPPackages; }
+  get: function () { return chunkF7ATDLVY_cjs.getMCPPackages; }
 });
 Object.defineProperty(exports, "getMCPToolPackageIndex", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.getMCPToolPackageIndex; }
+  get: function () { return chunkF7ATDLVY_cjs.getMCPToolPackageIndex; }
 });
 Object.defineProperty(exports, "getToolsForLLM", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.getToolsForLLM; }
+  get: function () { return chunkF7ATDLVY_cjs.getToolsForLLM; }
 });
 Object.defineProperty(exports, "listAllTools", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.listAllTools; }
+  get: function () { return chunkF7ATDLVY_cjs.listAllTools; }
 });
 Object.defineProperty(exports, "listAvailableTools", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.listAvailableTools; }
+  get: function () { return chunkF7ATDLVY_cjs.listAvailableTools; }
 });
 Object.defineProperty(exports, "listAvailableToolsForLLM", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.listAvailableToolsForLLM; }
+  get: function () { return chunkF7ATDLVY_cjs.listAvailableToolsForLLM; }
 });
 Object.defineProperty(exports, "loadPlugin", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.loadPlugin; }
+  get: function () { return chunkF7ATDLVY_cjs.loadPlugin; }
 });
 Object.defineProperty(exports, "mcpToolToOpenAI", {
   enumerable: true,
-  get: function () { return chunk7FYD7672_cjs.mcpToolToOpenAI; }
+  get: function () { return chunkF7ATDLVY_cjs.mcpToolToOpenAI; }
 });
 Object.defineProperty(exports, "SeastudioNotifications", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.SeastudioNotifications; }
+  get: function () { return chunk5OEF32AG_cjs.SeastudioNotifications; }
 });
 Object.defineProperty(exports, "SeastudioRequests", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.SeastudioRequests; }
+  get: function () { return chunk5OEF32AG_cjs.SeastudioRequests; }
 });
 Object.defineProperty(exports, "agentManagementTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.agentManagementTools; }
+  get: function () { return chunk5OEF32AG_cjs.agentManagementTools; }
 });
 Object.defineProperty(exports, "agentTabTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.agentTabTools; }
+  get: function () { return chunk5OEF32AG_cjs.agentTabTools; }
 });
 Object.defineProperty(exports, "fileTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.fileTools; }
+  get: function () { return chunk5OEF32AG_cjs.fileTools; }
 });
 Object.defineProperty(exports, "pluginManagementTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.pluginManagementTools; }
+  get: function () { return chunk5OEF32AG_cjs.pluginManagementTools; }
 });
 Object.defineProperty(exports, "pluginTabTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.pluginTabTools; }
+  get: function () { return chunk5OEF32AG_cjs.pluginTabTools; }
 });
 Object.defineProperty(exports, "seaCloudTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.seaCloudTools; }
+  get: function () { return chunk5OEF32AG_cjs.seaCloudTools; }
 });
 Object.defineProperty(exports, "seastudio", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.seastudio; }
+  get: function () { return chunk5OEF32AG_cjs.seastudio; }
 });
 Object.defineProperty(exports, "seastudioAllTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.allTools; }
+  get: function () { return chunk5OEF32AG_cjs.allTools; }
 });
 Object.defineProperty(exports, "seastudioTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.tools; }
+  get: function () { return chunk5OEF32AG_cjs.tools; }
 });
 Object.defineProperty(exports, "shellTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.shellTools; }
+  get: function () { return chunk5OEF32AG_cjs.shellTools; }
 });
 Object.defineProperty(exports, "MCPClient", {
   enumerable: true,

package/dist/mcp/index.js

@@ -1,3 +1,3 @@
-export { MCP_PACKAGES, getMCPPackageIdForTool, getMCPPackages, getMCPToolPackageIndex, getToolsForLLM, listAllTools, listAvailableTools, listAvailableToolsForLLM, loadPlugin, mcpToolToOpenAI } from '../chunk-EHA26OJY.js';
-export { SeastudioNotifications, SeastudioRequests, agentManagementTools, agentTabTools, fileTools, pluginManagementTools, pluginTabTools, seaCloudTools, seastudio, allTools as seastudioAllTools, tools as seastudioTools, shellTools } from '../chunk-ZDUIJOH2.js';
+export { MCP_PACKAGES, getMCPPackageIdForTool, getMCPPackages, getMCPToolPackageIndex, getToolsForLLM, listAllTools, listAvailableTools, listAvailableToolsForLLM, loadPlugin, mcpToolToOpenAI } from '../chunk-QZTDCMJU.js';
+export { SeastudioNotifications, SeastudioRequests, agentManagementTools, agentTabTools, fileTools, pluginManagementTools, pluginTabTools, seaCloudTools, seastudio, allTools as seastudioAllTools, tools as seastudioTools, shellTools } from '../chunk-BRYHXO22.js';
 export { MCPClient, MCPServer, PostMessageTransport, callHostTool, callHostToolText, createMCPClient, createMCPServer, createNotification, createRequest, createResponse, getDefaultClient, getDefaultServer, getDefaultTransport, isMCPMessage, isNotification, normalizeMCPTool, normalizeMCPToolInputSchema, normalizeMCPToolObjectSchema, setDefaultClient, setDefaultTransport, startDefaultServer } from '../chunk-TJ3CGHWJ.js';

package/dist/mcp/seastudio/index.cjs

@@ -1,143 +1,147 @@
 'use strict';
 
-var chunkKK6HF3XF_cjs = require('../../chunk-KK6HF3XF.cjs');
+var chunk5OEF32AG_cjs = require('../../chunk-5OEF32AG.cjs');
 require('../../chunk-3I7UM66P.cjs');
 
 
 
 Object.defineProperty(exports, "SINGLETON_BROWSER_SESSION_ID", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.SINGLETON_BROWSER_SESSION_ID; }
+  get: function () { return chunk5OEF32AG_cjs.SINGLETON_BROWSER_SESSION_ID; }
 });
 Object.defineProperty(exports, "SeastudioNotifications", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.SeastudioNotifications; }
+  get: function () { return chunk5OEF32AG_cjs.SeastudioNotifications; }
 });
 Object.defineProperty(exports, "SeastudioRequests", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.SeastudioRequests; }
+  get: function () { return chunk5OEF32AG_cjs.SeastudioRequests; }
 });
 Object.defineProperty(exports, "agentManagementTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.agentManagementTools; }
+  get: function () { return chunk5OEF32AG_cjs.agentManagementTools; }
 });
 Object.defineProperty(exports, "agentTabTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.agentTabTools; }
+  get: function () { return chunk5OEF32AG_cjs.agentTabTools; }
 });
 Object.defineProperty(exports, "allTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.allTools; }
+  get: function () { return chunk5OEF32AG_cjs.allTools; }
 });
 Object.defineProperty(exports, "annotateTool", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.annotateTool; }
+  get: function () { return chunk5OEF32AG_cjs.annotateTool; }
 });
 Object.defineProperty(exports, "batchFlattenCopyEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.batchFlattenCopyEvidenceOutputSchema; }
+  get: function () { return chunk5OEF32AG_cjs.batchFlattenCopyEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "browserRuntimeTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.browserRuntimeTools; }
+  get: function () { return chunk5OEF32AG_cjs.browserRuntimeTools; }
 });
 Object.defineProperty(exports, "callTool", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.callTool; }
+  get: function () { return chunk5OEF32AG_cjs.callTool; }
 });
 Object.defineProperty(exports, "callToolText", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.callToolText; }
+  get: function () { return chunk5OEF32AG_cjs.callToolText; }
 });
 Object.defineProperty(exports, "dualPathEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.dualPathEvidenceOutputSchema; }
+  get: function () { return chunk5OEF32AG_cjs.dualPathEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "editorTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.editorTools; }
+  get: function () { return chunk5OEF32AG_cjs.editorTools; }
 });
 Object.defineProperty(exports, "fileDownloadEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.fileDownloadEvidenceOutputSchema; }
+  get: function () { return chunk5OEF32AG_cjs.fileDownloadEvidenceOutputSchema; }
+});
+Object.defineProperty(exports, "fileSaveAsEvidenceOutputSchema", {
+  enumerable: true,
+  get: function () { return chunk5OEF32AG_cjs.fileSaveAsEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "fileTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.fileTools; }
+  get: function () { return chunk5OEF32AG_cjs.fileTools; }
 });
 Object.defineProperty(exports, "fileUrlEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.fileUrlEvidenceOutputSchema; }
+  get: function () { return chunk5OEF32AG_cjs.fileUrlEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "gitTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.gitTools; }
+  get: function () { return chunk5OEF32AG_cjs.gitTools; }
 });
 Object.defineProperty(exports, "pluginManagementTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.pluginManagementTools; }
+  get: function () { return chunk5OEF32AG_cjs.pluginManagementTools; }
 });
 Object.defineProperty(exports, "pluginTabTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.pluginTabTools; }
+  get: function () { return chunk5OEF32AG_cjs.pluginTabTools; }
 });
 Object.defineProperty(exports, "projectTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.projectTools; }
+  get: function () { return chunk5OEF32AG_cjs.projectTools; }
 });
 Object.defineProperty(exports, "request", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.request; }
+  get: function () { return chunk5OEF32AG_cjs.request; }
 });
 Object.defineProperty(exports, "rootedPathEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.rootedPathEvidenceOutputSchema; }
+  get: function () { return chunk5OEF32AG_cjs.rootedPathEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "rootedWriteEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.rootedWriteEvidenceOutputSchema; }
+  get: function () { return chunk5OEF32AG_cjs.rootedWriteEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "runOneShotShellCommand", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.runOneShotShellCommand; }
+  get: function () { return chunk5OEF32AG_cjs.runOneShotShellCommand; }
 });
 Object.defineProperty(exports, "seaCloudTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.seaCloudTools; }
+  get: function () { return chunk5OEF32AG_cjs.seaCloudTools; }
 });
 Object.defineProperty(exports, "seastudio", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.seastudio; }
+  get: function () { return chunk5OEF32AG_cjs.seastudio; }
 });
 Object.defineProperty(exports, "shellSessionCloseEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.shellSessionCloseEvidenceOutputSchema; }
+  get: function () { return chunk5OEF32AG_cjs.shellSessionCloseEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "shellSessionOpenEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.shellSessionOpenEvidenceOutputSchema; }
+  get: function () { return chunk5OEF32AG_cjs.shellSessionOpenEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "shellSessionRunEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.shellSessionRunEvidenceOutputSchema; }
+  get: function () { return chunk5OEF32AG_cjs.shellSessionRunEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "shellSessionSignalEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.shellSessionSignalEvidenceOutputSchema; }
+  get: function () { return chunk5OEF32AG_cjs.shellSessionSignalEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "shellSessionSnapshotEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.shellSessionSnapshotEvidenceOutputSchema; }
+  get: function () { return chunk5OEF32AG_cjs.shellSessionSnapshotEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "shellTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.shellTools; }
+  get: function () { return chunk5OEF32AG_cjs.shellTools; }
 });
 Object.defineProperty(exports, "skillTools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.skillTools; }
+  get: function () { return chunk5OEF32AG_cjs.skillTools; }
 });
 Object.defineProperty(exports, "tools", {
   enumerable: true,
-  get: function () { return chunkKK6HF3XF_cjs.tools; }
+  get: function () { return chunk5OEF32AG_cjs.tools; }
 });

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

@@ -61,6 +61,7 @@ declare const rootedWriteEvidenceOutputSchema: MCPToolInputSchema;
 declare const dualPathEvidenceOutputSchema: MCPToolInputSchema;
 declare const batchFlattenCopyEvidenceOutputSchema: MCPToolInputSchema;
 declare const fileDownloadEvidenceOutputSchema: MCPToolInputSchema;
+declare const fileSaveAsEvidenceOutputSchema: MCPToolInputSchema;
 declare const fileUrlEvidenceOutputSchema: MCPToolInputSchema;
 declare const shellSessionSnapshotEvidenceOutputSchema: MCPToolInputSchema;
 declare const shellSessionOpenEvidenceOutputSchema: MCPToolInputSchema;
@@ -163,6 +164,12 @@ interface SeastudioFileDownloadOptions {
     /** 若设置则下载到该本地绝对目录（可含 ~），忽略 path 与 rootId */
     absoluteDir?: string;
 }
+interface SeastudioFileSaveAsOptions extends SeastudioSinglePathOptions {
+    /** 原生保存对话框的默认文件名或路径 */
+    defaultPath?: string;
+    /** 原生保存对话框标题 */
+    title?: string;
+}
 interface SeastudioFileSearchOptions {
     rootId?: SeastudioFilesystemRootId;
     path?: string;
@@ -379,6 +386,7 @@ declare const seastudio: {
         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>;
+        saveAs: (path: string, options?: SeastudioFileSaveAsOptions) => Promise<MCPToolResult>;
         writeBinary: (path: string, base64: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
         readBinary: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
     };
@@ -672,6 +680,11 @@ declare const SeastudioNotifications: {
      * 通过 notifications/publish + publishTo 定向到对应 Agent 实例。
      */
     readonly SESSION_DELETE_REQUESTED: "session:delete_requested";
+    /**
+     * SeaStudio 主窗口前后台变化（blur/focus）。
+     * Agent 订阅后同步后端 host visibility，用于 session 完成 unread 策略。
+     */
+    readonly HOST_APP_VISIBILITY: "host:app_visibility";
 };
 
 /** 项目根在 MCP 文件工具中的寻址 id；browser 表示 URL 资源根 */
@@ -922,7 +935,7 @@ interface SessionCreatedParams extends SessionNotificationBase {
     /** 可选：状态文案，供 tooltip 展示 */
     statusLabel?: string;
 }
-type SessionSelectedReason = 'user' | 'agent' | 'host' | 'host_restore';
+type SessionSelectedReason = 'user' | 'agent' | 'host' | 'host_restore' | 'host_foreground';
 interface SessionSelectedParams extends Omit<SessionNotificationBase, 'sessionId'> {
     /** Agent 侧对话 session 标识；null 表示进入无会话状态 */
     sessionId: string | null;
@@ -989,6 +1002,13 @@ interface SessionDeleteRequestedParams {
     projectId?: string;
     reason?: 'host_sidebar';
 }
+/** 宿主主窗口前后台变化（blur/focus） */
+interface HostAppVisibilityParams {
+    agentInstanceId: string;
+    projectId?: string;
+    /** true = focus/前台，false = blur/后台 */
+    foreground: boolean;
+}
 
 /**
  * SeaStudio MCP Module
@@ -999,4 +1019,4 @@ interface SessionDeleteRequestedParams {
 declare const allTools: MCPTool[];
 declare const tools: MCPTool[];
 
-export { type AgentInstanceSessionSnapshot, type FileDeletedParams, type FileKeepRequestedParams, type FileModifiedParams, type FileOpenRequestedParams, type FileRenamedParams, type FileSavedParams, type FileSelectedParams, type FileSendRequestedParams, type FileTransferRequestedParams, type FilesChangedParams, type GitChangeKind, type GitChangedParams, type GitFileChange, type GitLineChange, type GitLineChangeKind, type GitOpenDiffRequestedParams, type GitStatusResult, type GitSummary, 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_SESSION_ID, type SeastudioBatchFlattenCopyOptions, type SeastudioBatchFlattenPreviewOptions, type SeastudioBrowserCertificateError, type SeastudioBrowserRect, type SeastudioBrowserSession, type SeastudioBrowserSessionOpenOptions, type SeastudioBrowserState, type SeastudioBrowserStatus, type SeastudioBrowserTab, type SeastudioBrowserViewportBinding, 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 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 SessionCreatedParams, type SessionDeleteRequestedParams, type SessionNewRequestedParams, type SessionNotificationBase, type SessionRemovedParams, 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, fileTools, fileUrlEvidenceOutputSchema, gitTools, pluginManagementTools, pluginTabTools, projectTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, runOneShotShellCommand, seaCloudTools, seastudio, shellSessionCloseEvidenceOutputSchema, shellSessionOpenEvidenceOutputSchema, shellSessionRunEvidenceOutputSchema, shellSessionSignalEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, skillTools, tools };
+export { type AgentInstanceSessionSnapshot, type FileDeletedParams, type FileKeepRequestedParams, type FileModifiedParams, type FileOpenRequestedParams, type FileRenamedParams, type FileSavedParams, type FileSelectedParams, type FileSendRequestedParams, type FileTransferRequestedParams, type FilesChangedParams, type GitChangeKind, type GitChangedParams, type GitFileChange, type GitLineChange, type GitLineChangeKind, 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_SESSION_ID, type SeastudioBatchFlattenCopyOptions, type SeastudioBatchFlattenPreviewOptions, type SeastudioBrowserCertificateError, type SeastudioBrowserRect, type SeastudioBrowserSession, type SeastudioBrowserSessionOpenOptions, type SeastudioBrowserState, type SeastudioBrowserStatus, type SeastudioBrowserTab, type SeastudioBrowserViewportBinding, 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 SessionCreatedParams, type SessionDeleteRequestedParams, type SessionNewRequestedParams, type SessionNotificationBase, type SessionRemovedParams, 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, seaCloudTools, seastudio, shellSessionCloseEvidenceOutputSchema, shellSessionOpenEvidenceOutputSchema, shellSessionRunEvidenceOutputSchema, shellSessionSignalEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, skillTools, tools };

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

@@ -61,6 +61,7 @@ declare const rootedWriteEvidenceOutputSchema: MCPToolInputSchema;
 declare const dualPathEvidenceOutputSchema: MCPToolInputSchema;
 declare const batchFlattenCopyEvidenceOutputSchema: MCPToolInputSchema;
 declare const fileDownloadEvidenceOutputSchema: MCPToolInputSchema;
+declare const fileSaveAsEvidenceOutputSchema: MCPToolInputSchema;
 declare const fileUrlEvidenceOutputSchema: MCPToolInputSchema;
 declare const shellSessionSnapshotEvidenceOutputSchema: MCPToolInputSchema;
 declare const shellSessionOpenEvidenceOutputSchema: MCPToolInputSchema;
@@ -163,6 +164,12 @@ interface SeastudioFileDownloadOptions {
     /** 若设置则下载到该本地绝对目录（可含 ~），忽略 path 与 rootId */
     absoluteDir?: string;
 }
+interface SeastudioFileSaveAsOptions extends SeastudioSinglePathOptions {
+    /** 原生保存对话框的默认文件名或路径 */
+    defaultPath?: string;
+    /** 原生保存对话框标题 */
+    title?: string;
+}
 interface SeastudioFileSearchOptions {
     rootId?: SeastudioFilesystemRootId;
     path?: string;
@@ -379,6 +386,7 @@ declare const seastudio: {
         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>;
+        saveAs: (path: string, options?: SeastudioFileSaveAsOptions) => Promise<MCPToolResult>;
         writeBinary: (path: string, base64: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
         readBinary: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
     };
@@ -672,6 +680,11 @@ declare const SeastudioNotifications: {
      * 通过 notifications/publish + publishTo 定向到对应 Agent 实例。
      */
     readonly SESSION_DELETE_REQUESTED: "session:delete_requested";
+    /**
+     * SeaStudio 主窗口前后台变化（blur/focus）。
+     * Agent 订阅后同步后端 host visibility，用于 session 完成 unread 策略。
+     */
+    readonly HOST_APP_VISIBILITY: "host:app_visibility";
 };
 
 /** 项目根在 MCP 文件工具中的寻址 id；browser 表示 URL 资源根 */
@@ -922,7 +935,7 @@ interface SessionCreatedParams extends SessionNotificationBase {
     /** 可选：状态文案，供 tooltip 展示 */
     statusLabel?: string;
 }
-type SessionSelectedReason = 'user' | 'agent' | 'host' | 'host_restore';
+type SessionSelectedReason = 'user' | 'agent' | 'host' | 'host_restore' | 'host_foreground';
 interface SessionSelectedParams extends Omit<SessionNotificationBase, 'sessionId'> {
     /** Agent 侧对话 session 标识；null 表示进入无会话状态 */
     sessionId: string | null;
@@ -989,6 +1002,13 @@ interface SessionDeleteRequestedParams {
     projectId?: string;
     reason?: 'host_sidebar';
 }
+/** 宿主主窗口前后台变化（blur/focus） */
+interface HostAppVisibilityParams {
+    agentInstanceId: string;
+    projectId?: string;
+    /** true = focus/前台，false = blur/后台 */
+    foreground: boolean;
+}
 
 /**
  * SeaStudio MCP Module
@@ -999,4 +1019,4 @@ interface SessionDeleteRequestedParams {
 declare const allTools: MCPTool[];
 declare const tools: MCPTool[];
 
-export { type AgentInstanceSessionSnapshot, type FileDeletedParams, type FileKeepRequestedParams, type FileModifiedParams, type FileOpenRequestedParams, type FileRenamedParams, type FileSavedParams, type FileSelectedParams, type FileSendRequestedParams, type FileTransferRequestedParams, type FilesChangedParams, type GitChangeKind, type GitChangedParams, type GitFileChange, type GitLineChange, type GitLineChangeKind, type GitOpenDiffRequestedParams, type GitStatusResult, type GitSummary, 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_SESSION_ID, type SeastudioBatchFlattenCopyOptions, type SeastudioBatchFlattenPreviewOptions, type SeastudioBrowserCertificateError, type SeastudioBrowserRect, type SeastudioBrowserSession, type SeastudioBrowserSessionOpenOptions, type SeastudioBrowserState, type SeastudioBrowserStatus, type SeastudioBrowserTab, type SeastudioBrowserViewportBinding, 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 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 SessionCreatedParams, type SessionDeleteRequestedParams, type SessionNewRequestedParams, type SessionNotificationBase, type SessionRemovedParams, 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, fileTools, fileUrlEvidenceOutputSchema, gitTools, pluginManagementTools, pluginTabTools, projectTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, runOneShotShellCommand, seaCloudTools, seastudio, shellSessionCloseEvidenceOutputSchema, shellSessionOpenEvidenceOutputSchema, shellSessionRunEvidenceOutputSchema, shellSessionSignalEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, skillTools, tools };
+export { type AgentInstanceSessionSnapshot, type FileDeletedParams, type FileKeepRequestedParams, type FileModifiedParams, type FileOpenRequestedParams, type FileRenamedParams, type FileSavedParams, type FileSelectedParams, type FileSendRequestedParams, type FileTransferRequestedParams, type FilesChangedParams, type GitChangeKind, type GitChangedParams, type GitFileChange, type GitLineChange, type GitLineChangeKind, 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_SESSION_ID, type SeastudioBatchFlattenCopyOptions, type SeastudioBatchFlattenPreviewOptions, type SeastudioBrowserCertificateError, type SeastudioBrowserRect, type SeastudioBrowserSession, type SeastudioBrowserSessionOpenOptions, type SeastudioBrowserState, type SeastudioBrowserStatus, type SeastudioBrowserTab, type SeastudioBrowserViewportBinding, 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 SessionCreatedParams, type SessionDeleteRequestedParams, type SessionNewRequestedParams, type SessionNotificationBase, type SessionRemovedParams, 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, seaCloudTools, seastudio, shellSessionCloseEvidenceOutputSchema, shellSessionOpenEvidenceOutputSchema, shellSessionRunEvidenceOutputSchema, shellSessionSignalEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, skillTools, tools };

package/dist/mcp/seastudio/index.js

@@ -1,2 +1,2 @@
-export { SINGLETON_BROWSER_SESSION_ID, SeastudioNotifications, SeastudioRequests, agentManagementTools, agentTabTools, allTools, annotateTool, batchFlattenCopyEvidenceOutputSchema, browserRuntimeTools, callTool, callToolText, dualPathEvidenceOutputSchema, editorTools, fileDownloadEvidenceOutputSchema, fileTools, fileUrlEvidenceOutputSchema, gitTools, pluginManagementTools, pluginTabTools, projectTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, runOneShotShellCommand, seaCloudTools, seastudio, shellSessionCloseEvidenceOutputSchema, shellSessionOpenEvidenceOutputSchema, shellSessionRunEvidenceOutputSchema, shellSessionSignalEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, skillTools, tools } from '../../chunk-ZDUIJOH2.js';
+export { SINGLETON_BROWSER_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, seaCloudTools, seastudio, shellSessionCloseEvidenceOutputSchema, shellSessionOpenEvidenceOutputSchema, shellSessionRunEvidenceOutputSchema, shellSessionSignalEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, skillTools, tools } from '../../chunk-BRYHXO22.js';
 import '../../chunk-TJ3CGHWJ.js';

package/package.json

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