@elevo-ai/plugin-sdk 0.4.0 → 0.4.2

package/README.md

@@ -28,16 +28,16 @@ export default function MyPluginApp() {
     });
   };
 
-  const handleListArtifacts = async () => {
-    const artifacts = await sdk.workspace.artifacts.list();
-    console.log('Artifacts:', artifacts);
+  const handleListFiles = async () => {
+    const files = await sdk.workspace.files.list();
+    console.log('Files:', files);
   };
 
   return (
     <div>
       <h1>我的插件</h1>
       <button onClick={handleSendMessage}>发送消息</button>
-      <button onClick={handleListArtifacts}>列出制品</button>
+      <button onClick={handleListFiles}>列出文件</button>
     </div>
   );
 }
@@ -53,9 +53,8 @@ import type {
 
   // Workspace API
   WorkspaceAPI,
-  ArtifactsAPI,
-  Artifact,
-  ArtifactContent,
+  FilesAPI,
+  WorkspaceFile,
 
   // Conversation API
   ConversationAPI,
@@ -86,18 +85,18 @@ import type {
 | 属性/方法 | 描述 |
 |----------|------|
 | `id` | 当前工作空间 ID |
-| `artifacts` | 制品管理 API |
+| `files` | 文件管理 API |
 
-### ArtifactsAPI
+### FilesAPI
 
-制品管理操作：
+文件管理操作：
 
 | 方法 | 描述 |
 |------|------|
-| `list(options?)` | 列出工作空间制品 |
-| `upload(file, options?)` | 上传文件作为制品 |
-| `download(artifactId)` | 下载制品 |
-| `getContent(artifactId)` | 获取制品内容（预览） |
+| `list(dirPath?, pattern?)` | 列出目录中的文件 |
+| `read(filePath)` | 读取文件内容 |
+| `write(filePath, content)` | 写入文件内容 |
+| `delete(filePath)` | 删除文件 |
 
 ### ConversationAPI
 

package/index.cjs.js

@@ -6,4 +6,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 
 exports.usePluginSDK = _a.usePluginSDK;
 exports.useInjectCSS = _a.useInjectCSS;
-exports.CopilotPanel = _a.CopilotPanel;
+exports.useWorkspaceFiles = _a.useWorkspaceFiles;
+exports.WorkspaceFileTree = _a.WorkspaceFileTree;

package/index.d.ts

@@ -1,32 +1,5 @@
 import React from 'react';
 
-/**
- * Workspace artifact (file or document)
- */
-export interface Artifact {
-  id: string;
-  workspace_id: string;
-  conversation_id: string | null;
-  file_path: string;
-  file_size: number;
-  mime_type: string;
-  created_at: string;
-  created_by_agent: string | null;
-  tags: string[];
-  metadata: Record<string, unknown>;
-}
-
-/**
- * Artifact content response
- */
-export interface ArtifactContent {
-  artifact_id: string;
-  content: string;
-  encoding: 'utf-8' | 'base64';
-  is_preview: boolean;
-  preview_size?: number;
-}
-
 /**
  * Workspace file information
  */
@@ -38,6 +11,7 @@ export interface WorkspaceFile {
   is_dir: boolean;
   mod_time: string;
   permission: 'readonly' | 'readwrite';
+  children?: WorkspaceFile[];
 }
 
 /**
@@ -71,44 +45,6 @@ export interface ChatPanelProps {
 
 // ==================== SDK 接口 ====================
 
-/**
- * Workspace artifacts API
- */
-export interface ArtifactsAPI {
-  /**
-   * List workspace artifacts
-   * @param options - Optional filters (conversationId)
-   */
-  list(options?: { conversationId?: string }): Promise<Artifact[]>;
-
-  /**
-   * Upload a file as artifact
-   * @param file - File to upload
-   * @param options - Optional metadata (filePath, conversationId, tags)
-   */
-  upload(
-    file: File,
-    options?: {
-      filePath?: string;
-      conversationId?: string;
-      tags?: string[];
-      metadata?: Record<string, unknown>;
-    }
-  ): Promise<Artifact>;
-
-  /**
-   * Download an artifact
-   * @param artifactId - Artifact ID
-   */
-  download(artifactId: string): Promise<Blob>;
-
-  /**
-   * Get artifact content (text or base64)
-   * @param artifactId - Artifact ID
-   */
-  getContent(artifactId: string): Promise<ArtifactContent>;
-}
-
 /**
  * Workspace files API - Read/write files in the workspace directory
  */
@@ -163,7 +99,6 @@ export interface ConversationAPI {
  */
 export interface WorkspaceAPI {
   id: string;
-  artifacts: ArtifactsAPI;
   files: FilesAPI;
 }
 
@@ -272,4 +207,49 @@ export interface ElevoPluginSDK {
 
 export declare function usePluginSDK(): ElevoPluginSDK;
 export declare function useInjectCSS(cssText: string): void;
-export declare function CopilotPanel(): React.ReactElement;
+export declare function useWorkspaceFiles(options: UseWorkspaceFilesOptions): UseWorkspaceFilesReturn;
+export declare function WorkspaceFileTree(props: WorkspaceFileTreeProps): React.ReactNode;
+
+export interface UseWorkspaceFilesOptions {
+  workspaceId: string;
+  path?: string;
+  pattern?: string;
+  enabled?: boolean;
+}
+
+export interface UseWorkspaceFilesReturn {
+  files: WorkspaceFile[];
+  loading: boolean;
+  error: Error | null;
+  refresh: () => Promise<void>;
+}
+
+export interface WorkspaceFileTreeProps {
+  files: WorkspaceFile[];
+  loading?: boolean;
+  onFileClick?: (file: WorkspaceFile) => void;
+  onFolderSelect?: (file: WorkspaceFile) => void;
+  onRename?: (file: WorkspaceFile) => void;
+  onDelete?: (file: WorkspaceFile) => void;
+  onCreateFile?: (parentPath: string) => void;
+  onCreateFolder?: (parentPath: string) => void;
+  onUpload?: (parentPath: string) => void;
+  onMove?: (sourcePath: string, targetPath: string) => void;
+  onSyncFromGit?: (parentPath: string) => void;
+  /** Path-based metadata for custom icons, read-only state, badges */
+  fileMetadata?: Map<string, FileNodeMetadata>;
+  enableContextMenu?: boolean;
+  enableDragDrop?: boolean;
+  compact?: boolean;
+  emptyState?: React.ReactNode;
+}
+
+/** Metadata overlay for a file/folder path */
+export interface FileNodeMetadata {
+  /** Custom icon type to render instead of default folder/file icon */
+  iconType?: 'git' | 'git-error';
+  /** Whether this node and its children are read-only (no rename/delete/upload) */
+  isReadOnly?: boolean;
+  /** Status badge text */
+  badge?: string;
+}

package/index.esm.js

@@ -2,4 +2,5 @@ var _a = window.__ELEVO_PLUGIN_API__ || {};
 
 export const usePluginSDK = _a.usePluginSDK;
 export const useInjectCSS = _a.useInjectCSS;
-export const CopilotPanel = _a.CopilotPanel;
+export const useWorkspaceFiles = _a.useWorkspaceFiles;
+export const WorkspaceFileTree = _a.WorkspaceFileTree;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevo-ai/plugin-sdk",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Elevo Plugin SDK - Build plugins for the Elevo platform",
   "type": "module",
   "main": "./index.cjs.js",