@seastudio/sdk 4.0.2 → 4.0.4

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

@@ -20,6 +20,58 @@ declare const shellSessionSignalEvidenceOutputSchema: MCPToolInputSchema;
 declare const shellSessionCloseEvidenceOutputSchema: MCPToolInputSchema;
 declare const fileTools: MCPTool[];
 
+declare const editorTools: MCPTool[];
+
+/**
+ * Git MCP Tools
+ */
+
+declare const gitTools: MCPTool[];
+
+type GitChangeKind = 'added' | 'modified' | 'deleted' | 'renamed' | 'untracked' | 'conflicted' | 'unknown';
+type GitLineChangeKind = 'added' | 'modified' | 'deleted';
+interface GitFileChange {
+    path: string;
+    previousPath?: string;
+    stagedStatus: string;
+    unstagedStatus: string;
+    kind: GitChangeKind;
+    raw: string;
+}
+interface GitSummary {
+    total: number;
+    added: number;
+    modified: number;
+    deleted: number;
+    renamed: number;
+    untracked: number;
+    conflicted: number;
+    unknown: number;
+}
+interface GitLineChange {
+    kind: GitLineChangeKind;
+    startLine: number;
+    endLine: number;
+}
+interface GitChangedParams {
+    projectPath: string;
+    summary: GitSummary;
+    changes: GitFileChange[];
+    ignoredPaths?: string[];
+}
+interface GitOpenDiffRequestedParams {
+    source: 'workspace' | 'scm';
+    rootId?: 'workspace' | `proj-${string}`;
+    path: string;
+    focus?: 'staged' | 'unstaged' | 'all';
+}
+interface GitStatusResult {
+    changes: GitFileChange[];
+    summary: GitSummary;
+    isRepository: boolean;
+    ignoredPaths?: string[];
+}
+
 /**
  * Shell MCP Tools
  *
@@ -97,6 +149,10 @@ interface SeastudioFileInfoOptions {
 interface SeastudioSinglePathOptions {
     rootId?: SeastudioFilesystemRootId;
 }
+type SeastudioWriteReviewMode = 'auto' | 'direct' | 'proposal';
+interface SeastudioFileWriteOptions extends SeastudioSinglePathOptions {
+    reviewMode?: SeastudioWriteReviewMode;
+}
 interface SeastudioFileDownloadOptions {
     rootId?: SeastudioFilesystemRootId;
     /** 若设置则下载到该本地绝对目录（可含 ~），忽略 path 与 rootId */
@@ -121,6 +177,39 @@ interface SeastudioBatchFlattenPreviewOptions {
 }
 interface SeastudioBatchFlattenCopyOptions extends SeastudioFileTransferOptions {
 }
+interface SeastudioProposalHunk {
+    id?: string;
+    filePath?: string;
+    rootId?: SeastudioFilesystemRootId;
+    startLine: number;
+    endLine: number;
+    originalContent: string;
+    proposedContent: string;
+}
+interface SeastudioProposalFile {
+    path: string;
+    rootId?: SeastudioFilesystemRootId;
+    originalContent: string;
+    proposedContent: string;
+    hunks?: SeastudioProposalHunk[];
+}
+interface SeastudioEditorProposeOptions {
+    proposalId?: string;
+    title: string;
+    files: SeastudioProposalFile[];
+    targetPluginId?: string;
+    targetInstanceId?: string;
+    openFile?: boolean;
+    origin?: Record<string, unknown>;
+}
+type SeastudioEditorProposalAction = 'list' | 'get' | 'getForFile' | 'keepAll' | 'undoAll' | 'resolve';
+interface SeastudioEditorProposalOptions {
+    action: SeastudioEditorProposalAction;
+    proposalId?: string;
+    rootId?: SeastudioFilesystemRootId;
+    path?: string;
+    decision?: 'keep' | 'undo';
+}
 type SeastudioShellKind = 'bash' | 'pwsh' | 'cmd' | 'sh';
 type SeastudioShellEntryLevel = 'command' | 'stdout' | 'meta' | 'exit';
 interface SeastudioShellEntry {
@@ -259,7 +348,7 @@ declare const seastudio: {
     file: {
         getSelected: () => Promise<MCPToolResult>;
         read: (path: string, options?: SeastudioFileReadOptions) => Promise<MCPToolResult>;
-        write: (path: string, content: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
+        write: (path: string, content: string, options?: SeastudioFileWriteOptions) => Promise<MCPToolResult>;
         list: (path?: string, options?: SeastudioFileListOptions) => Promise<MCPToolResult>;
         tree: (path?: string, options?: SeastudioFileTreeOptions) => Promise<MCPToolResult>;
         delete: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
@@ -287,6 +376,48 @@ declare const seastudio: {
         writeBinary: (path: string, base64: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
         readBinary: (path: string, options?: SeastudioSinglePathOptions) => Promise<MCPToolResult>;
     };
+    git: {
+        probe: () => Promise<MCPToolResult>;
+        status: (options?: {
+            rootId?: SeastudioFilesystemRootId;
+        }) => Promise<MCPToolResult>;
+        diff: (path: string, options?: {
+            rootId?: SeastudioFilesystemRootId;
+            scope?: "staged" | "unstaged" | "all";
+        }) => Promise<MCPToolResult>;
+        show: (path: string, options?: {
+            rootId?: SeastudioFilesystemRootId;
+            ref?: "HEAD" | "INDEX";
+        }) => Promise<MCPToolResult>;
+        lineChanges: (path: string, options?: {
+            rootId?: SeastudioFilesystemRootId;
+        }) => Promise<MCPToolResult>;
+        init: (options?: {
+            rootId?: SeastudioFilesystemRootId;
+        }) => Promise<MCPToolResult>;
+        stage: (path: string, options?: {
+            rootId?: SeastudioFilesystemRootId;
+        }) => Promise<MCPToolResult>;
+        stageAll: (options?: {
+            rootId?: SeastudioFilesystemRootId;
+        }) => Promise<MCPToolResult>;
+        unstage: (path: string, options?: {
+            rootId?: SeastudioFilesystemRootId;
+        }) => Promise<MCPToolResult>;
+        unstageAll: (options?: {
+            rootId?: SeastudioFilesystemRootId;
+        }) => Promise<MCPToolResult>;
+        discard: (path: string, options?: {
+            rootId?: SeastudioFilesystemRootId;
+        }) => Promise<MCPToolResult>;
+        commit: (message: string, options?: {
+            rootId?: SeastudioFilesystemRootId;
+        }) => Promise<MCPToolResult>;
+    };
+    editor: {
+        propose: (options: SeastudioEditorProposeOptions) => Promise<MCPToolResult>;
+        proposal: (options: SeastudioEditorProposalOptions) => Promise<MCPToolResult>;
+    };
     shell: {
         session: {
             open: (options?: SeastudioShellOpenOptions) => Promise<MCPToolResult>;
@@ -423,6 +554,10 @@ declare const SeastudioRequests: {
     readonly FILE_SAVED: "request:file_saved";
     /** 请求发送文本给 Agent -> 主程序发布 TEXT_SEND_REQUESTED */
     readonly TEXT_SEND: "request:text_send";
+    /** 请求在 Code Editor 中打开 Git diff 视图 */
+    readonly GIT_OPEN_DIFF: "request:git_open_diff";
+    /** 请求提交代码变更提案 -> 主程序发布 PROPOSAL_REQUESTED */
+    readonly PROPOSAL_SUBMIT: "request:proposal_submit";
 };
 /**
  * SeaStudio 主程序发布的通知主题
@@ -446,6 +581,14 @@ declare const SeastudioRequests: {
 declare const SeastudioNotifications: {
     /** 文件系统变化通知（fs.watch 触发） */
     readonly FILES_CHANGED: "files:changed";
+    /** Git 仓库状态变化（mutate 或 files:changed 后刷新） */
+    readonly GIT_CHANGED: "git:changed";
+    /** Git diff 打开请求（主程序转发到 Code Editor） */
+    readonly GIT_OPEN_DIFF_REQUESTED: "seastudio:git-open_diff_requested";
+    /** 代码变更提案请求（主程序转发到 Code Editor） */
+    readonly PROPOSAL_REQUESTED: "seastudio:proposal-requested";
+    /** 代码变更提案状态变化 */
+    readonly PROPOSAL_CHANGED: "seastudio:proposal-changed";
     /** 文件或目录被重命名/移动 */
     readonly FILE_RENAMED: "file:renamed";
     /** 文件或目录被删除/移入回收站 */
@@ -588,9 +731,11 @@ interface FileTransferRequestedParams {
     kind: 'file' | 'directory';
     isDirectory: boolean;
 }
-interface FileOpenRequestedParams extends FileTransferRequestedParams {
+interface FileOpenRequestedParams extends Omit<FileTransferRequestedParams, 'source'> {
+    source: 'workspace' | 'scm';
 }
-interface FileKeepRequestedParams extends FileTransferRequestedParams {
+interface FileKeepRequestedParams extends Omit<FileTransferRequestedParams, 'source'> {
+    source: 'workspace' | 'scm';
 }
 interface FileSendRequestedParams extends FileTransferRequestedParams {
 }
@@ -632,7 +777,7 @@ interface ProposalFeedbackOrigin {
 interface ProposalFeedbackHunk {
     id: string;
     filePath: string;
-    rootId: 'workspace' | 'assets';
+    rootId: SeastudioRootId;
     startLine: number;
     endLine: number;
     originalContent: string;
@@ -640,14 +785,51 @@ interface ProposalFeedbackHunk {
 }
 interface ProposalFeedbackFileSummary {
     path: string;
-    rootId: 'workspace' | 'assets';
+    rootId: SeastudioRootId;
     acceptedHunkIds: string[];
     rejectedHunkIds: string[];
 }
+interface ProposalRequestedHunk {
+    id: string;
+    filePath: string;
+    rootId: SeastudioRootId;
+    startLine: number;
+    endLine: number;
+    originalContent: string;
+    proposedContent: string;
+}
+interface ProposalRequestedFile {
+    path: string;
+    rootId: SeastudioRootId;
+    originalContent: string;
+    proposedContent: string;
+    hunks: ProposalRequestedHunk[];
+}
+interface ProposalRequestedParams {
+    proposalId: string;
+    title: string;
+    origin?: ProposalFeedbackOrigin;
+    files: ProposalRequestedFile[];
+    openFile?: boolean;
+    createdAt?: string;
+}
+type ProposalStatus = 'pending' | 'kept' | 'undone';
+interface ProposalRecord extends ProposalRequestedParams {
+    status: ProposalStatus;
+    createdAt: string;
+}
+interface ProposalChangedParams {
+    proposalId: string;
+    status: ProposalStatus;
+    files: Array<{
+        path: string;
+        rootId: SeastudioRootId;
+    }>;
+}
 interface ProposalFeedbackParams {
     proposalId: string;
     title: string;
-    decision: 'rejected' | 'partial';
+    decision: 'kept' | 'undone' | 'partial';
     origin?: ProposalFeedbackOrigin;
     acceptedFilePaths: string[];
     rejectedHunks: ProposalFeedbackHunk[];
@@ -661,6 +843,8 @@ interface FileModifiedParams {
     path: string;
     /** 是否有未保存的修改 */
     isDirty: boolean;
+    /** 是否存在待确认 AI proposal */
+    proposalPending?: boolean;
     /** 触发来源插件 ID */
     source?: string;
 }
@@ -794,4 +978,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 PluginTabTitleChangedParams, type ProposalFeedbackFileSummary, type ProposalFeedbackHunk, type ProposalFeedbackOrigin, type ProposalFeedbackParams, type RootsChangedParams, 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 SeastudioFileDownloadOptions, type SeastudioFileInfo, type SeastudioFileInfoOptions, type SeastudioFileListOptions, type SeastudioFileReadOptions, type SeastudioFileSearchMatch, type SeastudioFileSearchOptions, type SeastudioFileTransferOptions, type SeastudioFileTreeOptions, type SeastudioFilesystemRoot, type SeastudioFilesystemRootId, SeastudioNotifications, type SeastudioProjectInfo, SeastudioRequests, type 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 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, fileDownloadEvidenceOutputSchema, fileTools, fileUrlEvidenceOutputSchema, 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 PluginTabTitleChangedParams, type ProposalChangedParams, type ProposalFeedbackFileSummary, type ProposalFeedbackHunk, type ProposalFeedbackOrigin, type ProposalFeedbackParams, type ProposalRecord, type ProposalRequestedFile, type ProposalRequestedHunk, type ProposalRequestedParams, type ProposalStatus, type RootsChangedParams, 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 };

package/dist/mcp/seastudio/index.js

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

package/package.json

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