@seastudio/sdk 3.2.2 → 3.2.5

package/dist/{chunk-HQB2A35M.js → chunk-3UVF6MLO.js}

@@ -51,12 +51,15 @@ var batchFlattenCopyEvidenceOutputSchema = {
 var fileDownloadEvidenceOutputSchema = {
   type: "object",
   properties: {
+    location: { type: "string", enum: ["workspace", "absolute"] },
     rootId: { type: "string" },
+    absoluteDir: { type: "string" },
     path: { type: "string" },
     savedPath: { type: "string" },
-    size: { type: "number" }
+    size: { type: "number" },
+    mime: { type: "string" }
   },
-  required: ["rootId", "path", "savedPath", "size"]
+  required: ["location", "path", "savedPath", "size"]
 };
 var shellCommandEvidenceOutputSchema = {
   type: "object",
@@ -321,16 +324,20 @@ var fileTools = [
   }),
   annotateTool({
     name: "seastudio-file_download",
-    description: "\u4ECE\u8FDC\u7A0B URL \u4E0B\u8F7D\u6587\u4EF6\u5230\u6307\u5B9A\u6839\u76EE\u5F55\u548C\u8DEF\u5F84\u3002\u4EC5\u5728\u9700\u8981\u771F\u5B9E\u5F15\u5165\u8FDC\u7AEF\u8D44\u6E90\u65F6\u4F7F\u7528\u3002",
+    description: "\u4ECE\u8FDC\u7A0B URL \u4E0B\u8F7D\u6587\u4EF6\u3002\u4E8C\u9009\u4E00\uFF1A\u2460 \u5728 workspace \u6839\u4E0B\u6307\u5B9A\u76F8\u5BF9\u5B50\u76EE\u5F55\uFF08rootId + path\uFF09\uFF1B\u2461 \u6307\u5B9A absoluteDir \u4E3A\u672C\u5730\u7EDD\u5BF9\u8DEF\u5F84\u76EE\u5F55\uFF08\u542B ~/ \u5C55\u5F00\uFF09\uFF0C\u5FFD\u7565 rootId/path\u3002\u4EC5\u5728\u9700\u8981\u771F\u5B9E\u5F15\u5165\u8FDC\u7AEF\u8D44\u6E90\u65F6\u4F7F\u7528\u3002",
     inputSchema: {
       type: "object",
       properties: {
-        rootId: { type: "string", enum: ["workspace"], description: "\u6839\u76EE\u5F55 ID" },
-        path: { type: "string", description: "\u4FDD\u5B58\u76EE\u5F55\u8DEF\u5F84\uFF08\u76F8\u5BF9\u4E8E rootId\uFF09" },
+        rootId: { type: "string", enum: ["workspace"], description: "\u6839\u76EE\u5F55 ID\uFF08\u4E0E path \u8054\u7528\uFF1B\u82E5\u63D0\u4F9B absoluteDir \u5219\u5FFD\u7565\uFF09" },
+        path: { type: "string", description: "\u4FDD\u5B58\u76EE\u5F55\u8DEF\u5F84\uFF08\u76F8\u5BF9\u4E8E rootId\uFF1B\u672A\u4F7F\u7528 absoluteDir \u65F6\u5FC5\u586B\uFF09" },
+        absoluteDir: {
+          type: "string",
+          description: "\u672C\u5730\u7EDD\u5BF9\u8DEF\u5F84\u76EE\u5F55\uFF08\u53EF\u542B ~ \u6216 ~/\uFF09\uFF1B\u82E5\u8BBE\u7F6E\u5219\u4E0B\u8F7D\u5230\u6B64\u76EE\u5F55\uFF0C\u4E0D\u518D\u4F7F\u7528 workspace \u76F8\u5BF9\u8DEF\u5F84"
+        },
         url: { type: "string", description: "\u8FDC\u7A0B\u6587\u4EF6 URL" },
         filenameHint: { type: "string", description: "\u6587\u4EF6\u540D\u63D0\u793A\uFF08\u53EF\u9009\uFF09" }
       },
-      required: ["rootId", "path", "url"]
+      required: ["url"]
     }
   }, {
     operationKind: "mutate",
@@ -799,7 +806,13 @@ var seastudio = {
       });
     },
     getUrl: (path, options) => callTool("seastudio-file_get_url", { rootId: options?.rootId ?? "workspace", path }),
-    download: (url, path, filenameHint, options) => callTool("seastudio-file_download", { rootId: options?.rootId ?? "workspace", path, url, filenameHint }),
+    download: (url, path, filenameHint, options) => {
+      const absoluteDir = options?.absoluteDir?.trim();
+      if (absoluteDir) {
+        return callTool("seastudio-file_download", { url, absoluteDir, filenameHint });
+      }
+      return callTool("seastudio-file_download", { rootId: options?.rootId ?? "workspace", path, url, filenameHint });
+    },
     writeBinary: (path, base64, options) => callTool("seastudio-file_write_binary", { rootId: options?.rootId ?? "workspace", path, base64 }),
     readBinary: (path, options) => callTool("seastudio-file_read_binary", { rootId: options?.rootId ?? "workspace", path })
   },
@@ -1214,6 +1227,12 @@ var SeastudioNotifications = {
   SESSION_SUMMARY: "session:summary",
   /** Agent 对话 session：从宿主列表移除（删除/归档等） */
   SESSION_REMOVED: "session:removed",
+  /**
+   * Agent 在初始化或线程列表与当前选中稳定后，向宿主全量同步：
+   * 每个 agent 实例（通常每项目一个）下的会话列表与当前选中的 sessionId。
+   * 宿主应用此通知重建侧栏列表，避免仅靠逐条 SESSION_CREATED 时重启后空白。
+   */
+  SESSION_STATE_SNAPSHOT: "session:state_snapshot",
   /**
    * 宿主请求 Agent 新建一条对话会话（例如侧栏项目行的「+」）。
    * 通过 notifications/publish + publishTo 定向到对应 Agent 实例。

package/dist/{chunk-OYA42WZ4.cjs → chunk-7LQXYJPQ.cjs}

@@ -53,12 +53,15 @@ var batchFlattenCopyEvidenceOutputSchema = {
 var fileDownloadEvidenceOutputSchema = {
   type: "object",
   properties: {
+    location: { type: "string", enum: ["workspace", "absolute"] },
     rootId: { type: "string" },
+    absoluteDir: { type: "string" },
     path: { type: "string" },
     savedPath: { type: "string" },
-    size: { type: "number" }
+    size: { type: "number" },
+    mime: { type: "string" }
   },
-  required: ["rootId", "path", "savedPath", "size"]
+  required: ["location", "path", "savedPath", "size"]
 };
 var shellCommandEvidenceOutputSchema = {
   type: "object",
@@ -323,16 +326,20 @@ var fileTools = [
   }),
   annotateTool({
     name: "seastudio-file_download",
-    description: "\u4ECE\u8FDC\u7A0B URL \u4E0B\u8F7D\u6587\u4EF6\u5230\u6307\u5B9A\u6839\u76EE\u5F55\u548C\u8DEF\u5F84\u3002\u4EC5\u5728\u9700\u8981\u771F\u5B9E\u5F15\u5165\u8FDC\u7AEF\u8D44\u6E90\u65F6\u4F7F\u7528\u3002",
+    description: "\u4ECE\u8FDC\u7A0B URL \u4E0B\u8F7D\u6587\u4EF6\u3002\u4E8C\u9009\u4E00\uFF1A\u2460 \u5728 workspace \u6839\u4E0B\u6307\u5B9A\u76F8\u5BF9\u5B50\u76EE\u5F55\uFF08rootId + path\uFF09\uFF1B\u2461 \u6307\u5B9A absoluteDir \u4E3A\u672C\u5730\u7EDD\u5BF9\u8DEF\u5F84\u76EE\u5F55\uFF08\u542B ~/ \u5C55\u5F00\uFF09\uFF0C\u5FFD\u7565 rootId/path\u3002\u4EC5\u5728\u9700\u8981\u771F\u5B9E\u5F15\u5165\u8FDC\u7AEF\u8D44\u6E90\u65F6\u4F7F\u7528\u3002",
     inputSchema: {
       type: "object",
       properties: {
-        rootId: { type: "string", enum: ["workspace"], description: "\u6839\u76EE\u5F55 ID" },
-        path: { type: "string", description: "\u4FDD\u5B58\u76EE\u5F55\u8DEF\u5F84\uFF08\u76F8\u5BF9\u4E8E rootId\uFF09" },
+        rootId: { type: "string", enum: ["workspace"], description: "\u6839\u76EE\u5F55 ID\uFF08\u4E0E path \u8054\u7528\uFF1B\u82E5\u63D0\u4F9B absoluteDir \u5219\u5FFD\u7565\uFF09" },
+        path: { type: "string", description: "\u4FDD\u5B58\u76EE\u5F55\u8DEF\u5F84\uFF08\u76F8\u5BF9\u4E8E rootId\uFF1B\u672A\u4F7F\u7528 absoluteDir \u65F6\u5FC5\u586B\uFF09" },
+        absoluteDir: {
+          type: "string",
+          description: "\u672C\u5730\u7EDD\u5BF9\u8DEF\u5F84\u76EE\u5F55\uFF08\u53EF\u542B ~ \u6216 ~/\uFF09\uFF1B\u82E5\u8BBE\u7F6E\u5219\u4E0B\u8F7D\u5230\u6B64\u76EE\u5F55\uFF0C\u4E0D\u518D\u4F7F\u7528 workspace \u76F8\u5BF9\u8DEF\u5F84"
+        },
         url: { type: "string", description: "\u8FDC\u7A0B\u6587\u4EF6 URL" },
         filenameHint: { type: "string", description: "\u6587\u4EF6\u540D\u63D0\u793A\uFF08\u53EF\u9009\uFF09" }
       },
-      required: ["rootId", "path", "url"]
+      required: ["url"]
     }
   }, {
     operationKind: "mutate",
@@ -801,7 +808,13 @@ var seastudio = {
       });
     },
     getUrl: (path, options) => callTool("seastudio-file_get_url", { rootId: options?.rootId ?? "workspace", path }),
-    download: (url, path, filenameHint, options) => callTool("seastudio-file_download", { rootId: options?.rootId ?? "workspace", path, url, filenameHint }),
+    download: (url, path, filenameHint, options) => {
+      const absoluteDir = options?.absoluteDir?.trim();
+      if (absoluteDir) {
+        return callTool("seastudio-file_download", { url, absoluteDir, filenameHint });
+      }
+      return callTool("seastudio-file_download", { rootId: options?.rootId ?? "workspace", path, url, filenameHint });
+    },
     writeBinary: (path, base64, options) => callTool("seastudio-file_write_binary", { rootId: options?.rootId ?? "workspace", path, base64 }),
     readBinary: (path, options) => callTool("seastudio-file_read_binary", { rootId: options?.rootId ?? "workspace", path })
   },
@@ -1216,6 +1229,12 @@ var SeastudioNotifications = {
   SESSION_SUMMARY: "session:summary",
   /** Agent 对话 session：从宿主列表移除（删除/归档等） */
   SESSION_REMOVED: "session:removed",
+  /**
+   * Agent 在初始化或线程列表与当前选中稳定后，向宿主全量同步：
+   * 每个 agent 实例（通常每项目一个）下的会话列表与当前选中的 sessionId。
+   * 宿主应用此通知重建侧栏列表，避免仅靠逐条 SESSION_CREATED 时重启后空白。
+   */
+  SESSION_STATE_SNAPSHOT: "session:state_snapshot",
   /**
    * 宿主请求 Agent 新建一条对话会话（例如侧栏项目行的「+」）。
    * 通过 notifications/publish + publishTo 定向到对应 Agent 实例。

package/dist/{chunk-SYMWE636.cjs → chunk-GEPSOYJN.cjs}

@@ -84,14 +84,21 @@ function MenuItem({
   onClick,
   className
 }) {
+  const handlePressStart = (event) => {
+    event.stopPropagation();
+    if (disabled || event.button !== 0) return;
+    onClick();
+  };
+  const handleKeyboardClick = (event) => {
+    event.stopPropagation();
+    if (disabled || event.detail !== 0) return;
+    onClick();
+  };
   return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "px-1", children: /* @__PURE__ */ jsxRuntime.jsxs(
     "button",
     {
-      onClick: () => {
-        if (!disabled) {
-          onClick();
-        }
-      },
+      onMouseDown: handlePressStart,
+      onClick: handleKeyboardClick,
       disabled,
       className: cn(
         "w-full flex items-center gap-2 px-2 py-1.5 text-xs text-left transition-colors rounded-md",

package/dist/{chunk-Z5Q7SKYD.cjs → chunk-PX2KWRKM.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkOYA42WZ4_cjs = require('./chunk-OYA42WZ4.cjs');
+var chunk7LQXYJPQ_cjs = require('./chunk-7LQXYJPQ.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: chunkOYA42WZ4_cjs.allTools }
+  { id: "seastudio", name: "SeaStudio", description: "\u6587\u4EF6/Shell/AIGC \u57FA\u7840\u80FD\u529B", tools: chunk7LQXYJPQ_cjs.allTools }
 ];
 function mcpToolToOpenAI(tool) {
   const normalizedTool = chunk3I7UM66P_cjs.normalizeMCPTool(tool);
@@ -29,7 +29,7 @@ function mcpToolToOpenAI(tool) {
   };
 }
 function listAllTools() {
-  return [...chunkOYA42WZ4_cjs.allTools];
+  return [...chunk7LQXYJPQ_cjs.allTools];
 }
 function toPackageName(source) {
   if (source === "seastudio") {
@@ -59,7 +59,7 @@ function normalizeAvailableTool(raw) {
   };
 }
 var MCP_TOOL_PACKAGE_INDEX = new Map(
-  chunkOYA42WZ4_cjs.allTools.map((tool) => [tool.name, "seastudio"])
+  chunk7LQXYJPQ_cjs.allTools.map((tool) => [tool.name, "seastudio"])
 );
 function getMCPToolPackageIndex() {
   return new Map(MCP_TOOL_PACKAGE_INDEX);

package/dist/{chunk-4JAYW5GM.js → chunk-X62SRZS4.js}

@@ -82,14 +82,21 @@ function MenuItem({
   onClick,
   className
 }) {
+  const handlePressStart = (event) => {
+    event.stopPropagation();
+    if (disabled || event.button !== 0) return;
+    onClick();
+  };
+  const handleKeyboardClick = (event) => {
+    event.stopPropagation();
+    if (disabled || event.detail !== 0) return;
+    onClick();
+  };
   return /* @__PURE__ */ jsx("div", { className: "px-1", children: /* @__PURE__ */ jsxs(
     "button",
     {
-      onClick: () => {
-        if (!disabled) {
-          onClick();
-        }
-      },
+      onMouseDown: handlePressStart,
+      onClick: handleKeyboardClick,
       disabled,
       className: cn(
         "w-full flex items-center gap-2 px-2 py-1.5 text-xs text-left transition-colors rounded-md",

package/dist/{chunk-RZA5HQMQ.js → chunk-YTHD4PO5.js}

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

package/dist/index.cjs

@@ -1,151 +1,151 @@
 'use strict';
 
-var chunkZ5Q7SKYD_cjs = require('./chunk-Z5Q7SKYD.cjs');
-var chunkSYMWE636_cjs = require('./chunk-SYMWE636.cjs');
-var chunkOYA42WZ4_cjs = require('./chunk-OYA42WZ4.cjs');
+var chunkPX2KWRKM_cjs = require('./chunk-PX2KWRKM.cjs');
+var chunkGEPSOYJN_cjs = require('./chunk-GEPSOYJN.cjs');
+var chunk7LQXYJPQ_cjs = require('./chunk-7LQXYJPQ.cjs');
 var chunk3I7UM66P_cjs = require('./chunk-3I7UM66P.cjs');
 
 
 
 Object.defineProperty(exports, "MCP_PACKAGES", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.MCP_PACKAGES; }
+  get: function () { return chunkPX2KWRKM_cjs.MCP_PACKAGES; }
 });
 Object.defineProperty(exports, "getMCPPackageIdForTool", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.getMCPPackageIdForTool; }
+  get: function () { return chunkPX2KWRKM_cjs.getMCPPackageIdForTool; }
 });
 Object.defineProperty(exports, "getMCPPackages", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.getMCPPackages; }
+  get: function () { return chunkPX2KWRKM_cjs.getMCPPackages; }
 });
 Object.defineProperty(exports, "getMCPToolPackageIndex", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.getMCPToolPackageIndex; }
+  get: function () { return chunkPX2KWRKM_cjs.getMCPToolPackageIndex; }
 });
 Object.defineProperty(exports, "getToolsForLLM", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.getToolsForLLM; }
+  get: function () { return chunkPX2KWRKM_cjs.getToolsForLLM; }
 });
 Object.defineProperty(exports, "listAllTools", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.listAllTools; }
+  get: function () { return chunkPX2KWRKM_cjs.listAllTools; }
 });
 Object.defineProperty(exports, "listAvailableTools", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.listAvailableTools; }
+  get: function () { return chunkPX2KWRKM_cjs.listAvailableTools; }
 });
 Object.defineProperty(exports, "listAvailableToolsForLLM", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.listAvailableToolsForLLM; }
+  get: function () { return chunkPX2KWRKM_cjs.listAvailableToolsForLLM; }
 });
 Object.defineProperty(exports, "loadPlugin", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.loadPlugin; }
+  get: function () { return chunkPX2KWRKM_cjs.loadPlugin; }
 });
 Object.defineProperty(exports, "mcpToolToOpenAI", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.mcpToolToOpenAI; }
+  get: function () { return chunkPX2KWRKM_cjs.mcpToolToOpenAI; }
 });
 Object.defineProperty(exports, "DialogBody", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.DialogBody; }
+  get: function () { return chunkGEPSOYJN_cjs.DialogBody; }
 });
 Object.defineProperty(exports, "DialogButton", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.DialogButton; }
+  get: function () { return chunkGEPSOYJN_cjs.DialogButton; }
 });
 Object.defineProperty(exports, "DialogContainer", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.DialogContainer; }
+  get: function () { return chunkGEPSOYJN_cjs.DialogContainer; }
 });
 Object.defineProperty(exports, "DialogFooter", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.DialogFooter; }
+  get: function () { return chunkGEPSOYJN_cjs.DialogFooter; }
 });
 Object.defineProperty(exports, "DialogHeader", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.DialogHeader; }
+  get: function () { return chunkGEPSOYJN_cjs.DialogHeader; }
 });
 Object.defineProperty(exports, "DialogOverlay", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.DialogOverlay; }
+  get: function () { return chunkGEPSOYJN_cjs.DialogOverlay; }
 });
 Object.defineProperty(exports, "MenuContainer", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.MenuContainer; }
+  get: function () { return chunkGEPSOYJN_cjs.MenuContainer; }
 });
 Object.defineProperty(exports, "MenuEmpty", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.MenuEmpty; }
+  get: function () { return chunkGEPSOYJN_cjs.MenuEmpty; }
 });
 Object.defineProperty(exports, "MenuItem", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.MenuItem; }
+  get: function () { return chunkGEPSOYJN_cjs.MenuItem; }
 });
 Object.defineProperty(exports, "MenuSeparator", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.MenuSeparator; }
+  get: function () { return chunkGEPSOYJN_cjs.MenuSeparator; }
 });
 Object.defineProperty(exports, "Tab", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.Tab; }
+  get: function () { return chunkGEPSOYJN_cjs.Tab; }
 });
 Object.defineProperty(exports, "cn", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.cn; }
+  get: function () { return chunkGEPSOYJN_cjs.cn; }
 });
 Object.defineProperty(exports, "showHostContextMenu", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.showHostContextMenu; }
+  get: function () { return chunkGEPSOYJN_cjs.showHostContextMenu; }
 });
 Object.defineProperty(exports, "SeastudioNotifications", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.SeastudioNotifications; }
+  get: function () { return chunk7LQXYJPQ_cjs.SeastudioNotifications; }
 });
 Object.defineProperty(exports, "SeastudioRequests", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.SeastudioRequests; }
+  get: function () { return chunk7LQXYJPQ_cjs.SeastudioRequests; }
 });
 Object.defineProperty(exports, "agentManagementTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.agentManagementTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.agentManagementTools; }
 });
 Object.defineProperty(exports, "agentTabTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.agentTabTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.agentTabTools; }
 });
 Object.defineProperty(exports, "fileTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.fileTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.fileTools; }
 });
 Object.defineProperty(exports, "pluginManagementTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.pluginManagementTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.pluginManagementTools; }
 });
 Object.defineProperty(exports, "pluginTabTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.pluginTabTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.pluginTabTools; }
 });
 Object.defineProperty(exports, "seaCloudTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.seaCloudTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.seaCloudTools; }
 });
 Object.defineProperty(exports, "seastudio", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.seastudio; }
+  get: function () { return chunk7LQXYJPQ_cjs.seastudio; }
 });
 Object.defineProperty(exports, "seastudioAllTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.allTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.allTools; }
 });
 Object.defineProperty(exports, "seastudioTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.tools; }
+  get: function () { return chunk7LQXYJPQ_cjs.tools; }
 });
 Object.defineProperty(exports, "shellTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.shellTools; }
+  get: function () { return chunk7LQXYJPQ_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-RZA5HQMQ.js';
-export { DialogBody, DialogButton, DialogContainer, DialogFooter, DialogHeader, DialogOverlay, MenuContainer, MenuEmpty, MenuItem, MenuSeparator, Tab, cn, showHostContextMenu } from './chunk-4JAYW5GM.js';
-export { SeastudioNotifications, SeastudioRequests, agentManagementTools, agentTabTools, fileTools, pluginManagementTools, pluginTabTools, seaCloudTools, seastudio, allTools as seastudioAllTools, tools as seastudioTools, shellTools } from './chunk-HQB2A35M.js';
+export { MCP_PACKAGES, getMCPPackageIdForTool, getMCPPackages, getMCPToolPackageIndex, getToolsForLLM, listAllTools, listAvailableTools, listAvailableToolsForLLM, loadPlugin, mcpToolToOpenAI } from './chunk-YTHD4PO5.js';
+export { DialogBody, DialogButton, DialogContainer, DialogFooter, DialogHeader, DialogOverlay, MenuContainer, MenuEmpty, MenuItem, MenuSeparator, Tab, cn, showHostContextMenu } from './chunk-X62SRZS4.js';
+export { SeastudioNotifications, SeastudioRequests, agentManagementTools, agentTabTools, fileTools, pluginManagementTools, pluginTabTools, seaCloudTools, seastudio, allTools as seastudioAllTools, tools as seastudioTools, shellTools } from './chunk-3UVF6MLO.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 chunkZ5Q7SKYD_cjs = require('../chunk-Z5Q7SKYD.cjs');
-var chunkOYA42WZ4_cjs = require('../chunk-OYA42WZ4.cjs');
+var chunkPX2KWRKM_cjs = require('../chunk-PX2KWRKM.cjs');
+var chunk7LQXYJPQ_cjs = require('../chunk-7LQXYJPQ.cjs');
 var chunk3I7UM66P_cjs = require('../chunk-3I7UM66P.cjs');
 
 
 
 Object.defineProperty(exports, "MCP_PACKAGES", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.MCP_PACKAGES; }
+  get: function () { return chunkPX2KWRKM_cjs.MCP_PACKAGES; }
 });
 Object.defineProperty(exports, "getMCPPackageIdForTool", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.getMCPPackageIdForTool; }
+  get: function () { return chunkPX2KWRKM_cjs.getMCPPackageIdForTool; }
 });
 Object.defineProperty(exports, "getMCPPackages", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.getMCPPackages; }
+  get: function () { return chunkPX2KWRKM_cjs.getMCPPackages; }
 });
 Object.defineProperty(exports, "getMCPToolPackageIndex", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.getMCPToolPackageIndex; }
+  get: function () { return chunkPX2KWRKM_cjs.getMCPToolPackageIndex; }
 });
 Object.defineProperty(exports, "getToolsForLLM", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.getToolsForLLM; }
+  get: function () { return chunkPX2KWRKM_cjs.getToolsForLLM; }
 });
 Object.defineProperty(exports, "listAllTools", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.listAllTools; }
+  get: function () { return chunkPX2KWRKM_cjs.listAllTools; }
 });
 Object.defineProperty(exports, "listAvailableTools", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.listAvailableTools; }
+  get: function () { return chunkPX2KWRKM_cjs.listAvailableTools; }
 });
 Object.defineProperty(exports, "listAvailableToolsForLLM", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.listAvailableToolsForLLM; }
+  get: function () { return chunkPX2KWRKM_cjs.listAvailableToolsForLLM; }
 });
 Object.defineProperty(exports, "loadPlugin", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.loadPlugin; }
+  get: function () { return chunkPX2KWRKM_cjs.loadPlugin; }
 });
 Object.defineProperty(exports, "mcpToolToOpenAI", {
   enumerable: true,
-  get: function () { return chunkZ5Q7SKYD_cjs.mcpToolToOpenAI; }
+  get: function () { return chunkPX2KWRKM_cjs.mcpToolToOpenAI; }
 });
 Object.defineProperty(exports, "SeastudioNotifications", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.SeastudioNotifications; }
+  get: function () { return chunk7LQXYJPQ_cjs.SeastudioNotifications; }
 });
 Object.defineProperty(exports, "SeastudioRequests", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.SeastudioRequests; }
+  get: function () { return chunk7LQXYJPQ_cjs.SeastudioRequests; }
 });
 Object.defineProperty(exports, "agentManagementTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.agentManagementTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.agentManagementTools; }
 });
 Object.defineProperty(exports, "agentTabTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.agentTabTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.agentTabTools; }
 });
 Object.defineProperty(exports, "fileTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.fileTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.fileTools; }
 });
 Object.defineProperty(exports, "pluginManagementTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.pluginManagementTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.pluginManagementTools; }
 });
 Object.defineProperty(exports, "pluginTabTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.pluginTabTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.pluginTabTools; }
 });
 Object.defineProperty(exports, "seaCloudTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.seaCloudTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.seaCloudTools; }
 });
 Object.defineProperty(exports, "seastudio", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.seastudio; }
+  get: function () { return chunk7LQXYJPQ_cjs.seastudio; }
 });
 Object.defineProperty(exports, "seastudioAllTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.allTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.allTools; }
 });
 Object.defineProperty(exports, "seastudioTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.tools; }
+  get: function () { return chunk7LQXYJPQ_cjs.tools; }
 });
 Object.defineProperty(exports, "shellTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.shellTools; }
+  get: function () { return chunk7LQXYJPQ_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-RZA5HQMQ.js';
-export { SeastudioNotifications, SeastudioRequests, agentManagementTools, agentTabTools, fileTools, pluginManagementTools, pluginTabTools, seaCloudTools, seastudio, allTools as seastudioAllTools, tools as seastudioTools, shellTools } from '../chunk-HQB2A35M.js';
+export { MCP_PACKAGES, getMCPPackageIdForTool, getMCPPackages, getMCPToolPackageIndex, getToolsForLLM, listAllTools, listAvailableTools, listAvailableToolsForLLM, loadPlugin, mcpToolToOpenAI } from '../chunk-YTHD4PO5.js';
+export { SeastudioNotifications, SeastudioRequests, agentManagementTools, agentTabTools, fileTools, pluginManagementTools, pluginTabTools, seaCloudTools, seastudio, allTools as seastudioAllTools, tools as seastudioTools, shellTools } from '../chunk-3UVF6MLO.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,99 +1,99 @@
 'use strict';
 
-var chunkOYA42WZ4_cjs = require('../../chunk-OYA42WZ4.cjs');
+var chunk7LQXYJPQ_cjs = require('../../chunk-7LQXYJPQ.cjs');
 require('../../chunk-3I7UM66P.cjs');
 
 
 
 Object.defineProperty(exports, "SeastudioNotifications", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.SeastudioNotifications; }
+  get: function () { return chunk7LQXYJPQ_cjs.SeastudioNotifications; }
 });
 Object.defineProperty(exports, "SeastudioRequests", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.SeastudioRequests; }
+  get: function () { return chunk7LQXYJPQ_cjs.SeastudioRequests; }
 });
 Object.defineProperty(exports, "agentManagementTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.agentManagementTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.agentManagementTools; }
 });
 Object.defineProperty(exports, "agentTabTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.agentTabTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.agentTabTools; }
 });
 Object.defineProperty(exports, "allTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.allTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.allTools; }
 });
 Object.defineProperty(exports, "annotateTool", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.annotateTool; }
+  get: function () { return chunk7LQXYJPQ_cjs.annotateTool; }
 });
 Object.defineProperty(exports, "batchFlattenCopyEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.batchFlattenCopyEvidenceOutputSchema; }
+  get: function () { return chunk7LQXYJPQ_cjs.batchFlattenCopyEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "callTool", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.callTool; }
+  get: function () { return chunk7LQXYJPQ_cjs.callTool; }
 });
 Object.defineProperty(exports, "callToolText", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.callToolText; }
+  get: function () { return chunk7LQXYJPQ_cjs.callToolText; }
 });
 Object.defineProperty(exports, "dualPathEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.dualPathEvidenceOutputSchema; }
+  get: function () { return chunk7LQXYJPQ_cjs.dualPathEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "fileDownloadEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.fileDownloadEvidenceOutputSchema; }
+  get: function () { return chunk7LQXYJPQ_cjs.fileDownloadEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "fileTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.fileTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.fileTools; }
 });
 Object.defineProperty(exports, "pluginManagementTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.pluginManagementTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.pluginManagementTools; }
 });
 Object.defineProperty(exports, "pluginTabTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.pluginTabTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.pluginTabTools; }
 });
 Object.defineProperty(exports, "request", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.request; }
+  get: function () { return chunk7LQXYJPQ_cjs.request; }
 });
 Object.defineProperty(exports, "rootedPathEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.rootedPathEvidenceOutputSchema; }
+  get: function () { return chunk7LQXYJPQ_cjs.rootedPathEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "rootedWriteEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.rootedWriteEvidenceOutputSchema; }
+  get: function () { return chunk7LQXYJPQ_cjs.rootedWriteEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "seaCloudTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.seaCloudTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.seaCloudTools; }
 });
 Object.defineProperty(exports, "seastudio", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.seastudio; }
+  get: function () { return chunk7LQXYJPQ_cjs.seastudio; }
 });
 Object.defineProperty(exports, "shellCommandEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.shellCommandEvidenceOutputSchema; }
+  get: function () { return chunk7LQXYJPQ_cjs.shellCommandEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "shellSessionSnapshotEvidenceOutputSchema", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.shellSessionSnapshotEvidenceOutputSchema; }
+  get: function () { return chunk7LQXYJPQ_cjs.shellSessionSnapshotEvidenceOutputSchema; }
 });
 Object.defineProperty(exports, "shellTools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.shellTools; }
+  get: function () { return chunk7LQXYJPQ_cjs.shellTools; }
 });
 Object.defineProperty(exports, "tools", {
   enumerable: true,
-  get: function () { return chunkOYA42WZ4_cjs.tools; }
+  get: function () { return chunk7LQXYJPQ_cjs.tools; }
 });

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

@@ -81,6 +81,8 @@ interface SeastudioSinglePathOptions {
 }
 interface SeastudioFileDownloadOptions {
     rootId?: SeastudioFilesystemRootId;
+    /** 若设置则下载到该本地绝对目录（可含 ~），忽略 path 与 rootId */
+    absoluteDir?: string;
 }
 interface SeastudioFileSearchOptions {
     rootId?: SeastudioFilesystemRootId;
@@ -288,6 +290,12 @@ declare const SeastudioNotifications: {
     readonly SESSION_SUMMARY: "session:summary";
     /** Agent 对话 session：从宿主列表移除（删除/归档等） */
     readonly SESSION_REMOVED: "session:removed";
+    /**
+     * Agent 在初始化或线程列表与当前选中稳定后，向宿主全量同步：
+     * 每个 agent 实例（通常每项目一个）下的会话列表与当前选中的 sessionId。
+     * 宿主应用此通知重建侧栏列表，避免仅靠逐条 SESSION_CREATED 时重启后空白。
+     */
+    readonly SESSION_STATE_SNAPSHOT: "session:state_snapshot";
     /**
      * 宿主请求 Agent 新建一条对话会话（例如侧栏项目行的「+」）。
      * 通过 notifications/publish + publishTo 定向到对应 Agent 实例。
@@ -455,7 +463,7 @@ interface SessionCreatedParams extends SessionNotificationBase {
     /** 是否同时成为当前选中的 session */
     isActive?: boolean;
 }
-type SessionSelectedReason = 'user' | 'agent' | 'host';
+type SessionSelectedReason = 'user' | 'agent' | 'host' | 'host_restore';
 interface SessionSelectedParams extends SessionNotificationBase {
     /** 变化原因：侧栏点击多为 host，Agent 内切换多为 agent */
     reason?: SessionSelectedReason;
@@ -472,6 +480,28 @@ interface SessionRemovedParams extends SessionNotificationBase {
     /** 移除原因，便于调试或 UI 提示 */
     reason?: 'deleted' | 'archived' | 'closed';
 }
+/** 单条会话在快照中的描述（与侧栏展示字段对齐，不含消息正文） */
+interface SessionSnapshotItem {
+    sessionId: string;
+    title?: string;
+    summary?: string;
+    updatedAt?: string;
+    /** 若提供 selectedSessionId，宿主应以该 id 为准标记 isActive */
+    isActive?: boolean;
+}
+/** 单个 agent 实例（通常对应一个项目）下的会话全量视图 */
+interface AgentInstanceSessionSnapshot {
+    agentInstanceId: string;
+    projectId: string;
+    /** 当前选中的会话；可为 null 表示无选中 */
+    selectedSessionId: string | null;
+    sessions: SessionSnapshotItem[];
+}
+/** Agent → 宿主：会话状态全量快照（单 iframe 可只传一条 instances） */
+interface SessionStateSnapshotParams {
+    reason?: 'init' | 'refresh';
+    instances: AgentInstanceSessionSnapshot[];
+}
 /** 宿主请求新建会话（无 sessionId，由 Agent 创建后通过 SESSION_CREATED 回传） */
 interface SessionNewRequestedParams {
     agentInstanceId: string;
@@ -496,4 +526,4 @@ interface SessionDeleteRequestedParams {
 declare const allTools: MCPTool[];
 declare const tools: MCPTool[];
 
-export { type FileDeletedParams, type FileModifiedParams, type FileOpenRequestedParams, type FileRenamedParams, type FileSavedParams, type FileSendRequestedParams, type FileTransferRequestedParams, type FilesChangedParams, type ProposalFeedbackFileSummary, type ProposalFeedbackHunk, type ProposalFeedbackOrigin, type ProposalFeedbackParams, type RootsChangedParams, type SeastudioBatchFlattenCopyOptions, type SeastudioBatchFlattenPreviewOptions, type SeastudioDragDropParams, type SeastudioDragEnterParams, type SeastudioDragFileData, type SeastudioDragRootId, type SeastudioDragStartParams, type SeastudioFileDownloadOptions, type SeastudioFileInfo, type SeastudioFileInfoOptions, type SeastudioFileListOptions, type SeastudioFileReadOptions, type SeastudioFileSearchMatch, type SeastudioFileSearchOptions, type SeastudioFileTransferOptions, type SeastudioFileTreeOptions, type SeastudioFilesystemRoot, type SeastudioFilesystemRootId, SeastudioNotifications, SeastudioRequests, type SeastudioShellCommandResult, type SeastudioShellSessionEntry, type SeastudioShellSessionEntryLevel, type SeastudioShellSessionSnapshot, type SeastudioSinglePathOptions, type SeastudioWorkspacePathMode, type SessionCreatedParams, type SessionDeleteRequestedParams, type SessionNewRequestedParams, type SessionNotificationBase, type SessionRemovedParams, type SessionSelectedParams, type SessionSelectedReason, type SessionSummaryParams, type TextSendRequestedParams, type TextSendRequestedSelectionRange, type TextSendRequestedSource, agentManagementTools, agentTabTools, allTools, annotateTool, batchFlattenCopyEvidenceOutputSchema, callTool, callToolText, dualPathEvidenceOutputSchema, fileDownloadEvidenceOutputSchema, fileTools, pluginManagementTools, pluginTabTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, seaCloudTools, seastudio, shellCommandEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, tools };
+export { type AgentInstanceSessionSnapshot, type FileDeletedParams, type FileModifiedParams, type FileOpenRequestedParams, type FileRenamedParams, type FileSavedParams, type FileSendRequestedParams, type FileTransferRequestedParams, type FilesChangedParams, type ProposalFeedbackFileSummary, type ProposalFeedbackHunk, type ProposalFeedbackOrigin, type ProposalFeedbackParams, type RootsChangedParams, type SeastudioBatchFlattenCopyOptions, type SeastudioBatchFlattenPreviewOptions, type SeastudioDragDropParams, type SeastudioDragEnterParams, type SeastudioDragFileData, type SeastudioDragRootId, type SeastudioDragStartParams, type SeastudioFileDownloadOptions, type SeastudioFileInfo, type SeastudioFileInfoOptions, type SeastudioFileListOptions, type SeastudioFileReadOptions, type SeastudioFileSearchMatch, type SeastudioFileSearchOptions, type SeastudioFileTransferOptions, type SeastudioFileTreeOptions, type SeastudioFilesystemRoot, type SeastudioFilesystemRootId, SeastudioNotifications, SeastudioRequests, type SeastudioShellCommandResult, type SeastudioShellSessionEntry, type SeastudioShellSessionEntryLevel, type SeastudioShellSessionSnapshot, type SeastudioSinglePathOptions, type SeastudioWorkspacePathMode, type SessionCreatedParams, type SessionDeleteRequestedParams, type SessionNewRequestedParams, type SessionNotificationBase, type SessionRemovedParams, type SessionSelectedParams, type SessionSelectedReason, type SessionSnapshotItem, type SessionStateSnapshotParams, type SessionSummaryParams, type TextSendRequestedParams, type TextSendRequestedSelectionRange, type TextSendRequestedSource, agentManagementTools, agentTabTools, allTools, annotateTool, batchFlattenCopyEvidenceOutputSchema, callTool, callToolText, dualPathEvidenceOutputSchema, fileDownloadEvidenceOutputSchema, fileTools, pluginManagementTools, pluginTabTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, seaCloudTools, seastudio, shellCommandEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, tools };

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

@@ -81,6 +81,8 @@ interface SeastudioSinglePathOptions {
 }
 interface SeastudioFileDownloadOptions {
     rootId?: SeastudioFilesystemRootId;
+    /** 若设置则下载到该本地绝对目录（可含 ~），忽略 path 与 rootId */
+    absoluteDir?: string;
 }
 interface SeastudioFileSearchOptions {
     rootId?: SeastudioFilesystemRootId;
@@ -288,6 +290,12 @@ declare const SeastudioNotifications: {
     readonly SESSION_SUMMARY: "session:summary";
     /** Agent 对话 session：从宿主列表移除（删除/归档等） */
     readonly SESSION_REMOVED: "session:removed";
+    /**
+     * Agent 在初始化或线程列表与当前选中稳定后，向宿主全量同步：
+     * 每个 agent 实例（通常每项目一个）下的会话列表与当前选中的 sessionId。
+     * 宿主应用此通知重建侧栏列表，避免仅靠逐条 SESSION_CREATED 时重启后空白。
+     */
+    readonly SESSION_STATE_SNAPSHOT: "session:state_snapshot";
     /**
      * 宿主请求 Agent 新建一条对话会话（例如侧栏项目行的「+」）。
      * 通过 notifications/publish + publishTo 定向到对应 Agent 实例。
@@ -455,7 +463,7 @@ interface SessionCreatedParams extends SessionNotificationBase {
     /** 是否同时成为当前选中的 session */
     isActive?: boolean;
 }
-type SessionSelectedReason = 'user' | 'agent' | 'host';
+type SessionSelectedReason = 'user' | 'agent' | 'host' | 'host_restore';
 interface SessionSelectedParams extends SessionNotificationBase {
     /** 变化原因：侧栏点击多为 host，Agent 内切换多为 agent */
     reason?: SessionSelectedReason;
@@ -472,6 +480,28 @@ interface SessionRemovedParams extends SessionNotificationBase {
     /** 移除原因，便于调试或 UI 提示 */
     reason?: 'deleted' | 'archived' | 'closed';
 }
+/** 单条会话在快照中的描述（与侧栏展示字段对齐，不含消息正文） */
+interface SessionSnapshotItem {
+    sessionId: string;
+    title?: string;
+    summary?: string;
+    updatedAt?: string;
+    /** 若提供 selectedSessionId，宿主应以该 id 为准标记 isActive */
+    isActive?: boolean;
+}
+/** 单个 agent 实例（通常对应一个项目）下的会话全量视图 */
+interface AgentInstanceSessionSnapshot {
+    agentInstanceId: string;
+    projectId: string;
+    /** 当前选中的会话；可为 null 表示无选中 */
+    selectedSessionId: string | null;
+    sessions: SessionSnapshotItem[];
+}
+/** Agent → 宿主：会话状态全量快照（单 iframe 可只传一条 instances） */
+interface SessionStateSnapshotParams {
+    reason?: 'init' | 'refresh';
+    instances: AgentInstanceSessionSnapshot[];
+}
 /** 宿主请求新建会话（无 sessionId，由 Agent 创建后通过 SESSION_CREATED 回传） */
 interface SessionNewRequestedParams {
     agentInstanceId: string;
@@ -496,4 +526,4 @@ interface SessionDeleteRequestedParams {
 declare const allTools: MCPTool[];
 declare const tools: MCPTool[];
 
-export { type FileDeletedParams, type FileModifiedParams, type FileOpenRequestedParams, type FileRenamedParams, type FileSavedParams, type FileSendRequestedParams, type FileTransferRequestedParams, type FilesChangedParams, type ProposalFeedbackFileSummary, type ProposalFeedbackHunk, type ProposalFeedbackOrigin, type ProposalFeedbackParams, type RootsChangedParams, type SeastudioBatchFlattenCopyOptions, type SeastudioBatchFlattenPreviewOptions, type SeastudioDragDropParams, type SeastudioDragEnterParams, type SeastudioDragFileData, type SeastudioDragRootId, type SeastudioDragStartParams, type SeastudioFileDownloadOptions, type SeastudioFileInfo, type SeastudioFileInfoOptions, type SeastudioFileListOptions, type SeastudioFileReadOptions, type SeastudioFileSearchMatch, type SeastudioFileSearchOptions, type SeastudioFileTransferOptions, type SeastudioFileTreeOptions, type SeastudioFilesystemRoot, type SeastudioFilesystemRootId, SeastudioNotifications, SeastudioRequests, type SeastudioShellCommandResult, type SeastudioShellSessionEntry, type SeastudioShellSessionEntryLevel, type SeastudioShellSessionSnapshot, type SeastudioSinglePathOptions, type SeastudioWorkspacePathMode, type SessionCreatedParams, type SessionDeleteRequestedParams, type SessionNewRequestedParams, type SessionNotificationBase, type SessionRemovedParams, type SessionSelectedParams, type SessionSelectedReason, type SessionSummaryParams, type TextSendRequestedParams, type TextSendRequestedSelectionRange, type TextSendRequestedSource, agentManagementTools, agentTabTools, allTools, annotateTool, batchFlattenCopyEvidenceOutputSchema, callTool, callToolText, dualPathEvidenceOutputSchema, fileDownloadEvidenceOutputSchema, fileTools, pluginManagementTools, pluginTabTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, seaCloudTools, seastudio, shellCommandEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, tools };
+export { type AgentInstanceSessionSnapshot, type FileDeletedParams, type FileModifiedParams, type FileOpenRequestedParams, type FileRenamedParams, type FileSavedParams, type FileSendRequestedParams, type FileTransferRequestedParams, type FilesChangedParams, type ProposalFeedbackFileSummary, type ProposalFeedbackHunk, type ProposalFeedbackOrigin, type ProposalFeedbackParams, type RootsChangedParams, type SeastudioBatchFlattenCopyOptions, type SeastudioBatchFlattenPreviewOptions, type SeastudioDragDropParams, type SeastudioDragEnterParams, type SeastudioDragFileData, type SeastudioDragRootId, type SeastudioDragStartParams, type SeastudioFileDownloadOptions, type SeastudioFileInfo, type SeastudioFileInfoOptions, type SeastudioFileListOptions, type SeastudioFileReadOptions, type SeastudioFileSearchMatch, type SeastudioFileSearchOptions, type SeastudioFileTransferOptions, type SeastudioFileTreeOptions, type SeastudioFilesystemRoot, type SeastudioFilesystemRootId, SeastudioNotifications, SeastudioRequests, type SeastudioShellCommandResult, type SeastudioShellSessionEntry, type SeastudioShellSessionEntryLevel, type SeastudioShellSessionSnapshot, type SeastudioSinglePathOptions, type SeastudioWorkspacePathMode, type SessionCreatedParams, type SessionDeleteRequestedParams, type SessionNewRequestedParams, type SessionNotificationBase, type SessionRemovedParams, type SessionSelectedParams, type SessionSelectedReason, type SessionSnapshotItem, type SessionStateSnapshotParams, type SessionSummaryParams, type TextSendRequestedParams, type TextSendRequestedSelectionRange, type TextSendRequestedSource, agentManagementTools, agentTabTools, allTools, annotateTool, batchFlattenCopyEvidenceOutputSchema, callTool, callToolText, dualPathEvidenceOutputSchema, fileDownloadEvidenceOutputSchema, fileTools, pluginManagementTools, pluginTabTools, request, rootedPathEvidenceOutputSchema, rootedWriteEvidenceOutputSchema, seaCloudTools, seastudio, shellCommandEvidenceOutputSchema, shellSessionSnapshotEvidenceOutputSchema, shellTools, tools };

package/dist/mcp/seastudio/index.js

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

package/dist/ui/index.cjs

@@ -1,58 +1,58 @@
 'use strict';
 
-var chunkSYMWE636_cjs = require('../chunk-SYMWE636.cjs');
+var chunkGEPSOYJN_cjs = require('../chunk-GEPSOYJN.cjs');
 
 
 
 Object.defineProperty(exports, "DialogBody", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.DialogBody; }
+  get: function () { return chunkGEPSOYJN_cjs.DialogBody; }
 });
 Object.defineProperty(exports, "DialogButton", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.DialogButton; }
+  get: function () { return chunkGEPSOYJN_cjs.DialogButton; }
 });
 Object.defineProperty(exports, "DialogContainer", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.DialogContainer; }
+  get: function () { return chunkGEPSOYJN_cjs.DialogContainer; }
 });
 Object.defineProperty(exports, "DialogFooter", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.DialogFooter; }
+  get: function () { return chunkGEPSOYJN_cjs.DialogFooter; }
 });
 Object.defineProperty(exports, "DialogHeader", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.DialogHeader; }
+  get: function () { return chunkGEPSOYJN_cjs.DialogHeader; }
 });
 Object.defineProperty(exports, "DialogOverlay", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.DialogOverlay; }
+  get: function () { return chunkGEPSOYJN_cjs.DialogOverlay; }
 });
 Object.defineProperty(exports, "MenuContainer", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.MenuContainer; }
+  get: function () { return chunkGEPSOYJN_cjs.MenuContainer; }
 });
 Object.defineProperty(exports, "MenuEmpty", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.MenuEmpty; }
+  get: function () { return chunkGEPSOYJN_cjs.MenuEmpty; }
 });
 Object.defineProperty(exports, "MenuItem", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.MenuItem; }
+  get: function () { return chunkGEPSOYJN_cjs.MenuItem; }
 });
 Object.defineProperty(exports, "MenuSeparator", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.MenuSeparator; }
+  get: function () { return chunkGEPSOYJN_cjs.MenuSeparator; }
 });
 Object.defineProperty(exports, "Tab", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.Tab; }
+  get: function () { return chunkGEPSOYJN_cjs.Tab; }
 });
 Object.defineProperty(exports, "cn", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.cn; }
+  get: function () { return chunkGEPSOYJN_cjs.cn; }
 });
 Object.defineProperty(exports, "showHostContextMenu", {
   enumerable: true,
-  get: function () { return chunkSYMWE636_cjs.showHostContextMenu; }
+  get: function () { return chunkGEPSOYJN_cjs.showHostContextMenu; }
 });

package/dist/ui/index.js

@@ -1 +1 @@
-export { DialogBody, DialogButton, DialogContainer, DialogFooter, DialogHeader, DialogOverlay, MenuContainer, MenuEmpty, MenuItem, MenuSeparator, Tab, cn, showHostContextMenu } from '../chunk-4JAYW5GM.js';
+export { DialogBody, DialogButton, DialogContainer, DialogFooter, DialogHeader, DialogOverlay, MenuContainer, MenuEmpty, MenuItem, MenuSeparator, Tab, cn, showHostContextMenu } from '../chunk-X62SRZS4.js';

package/package.json

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