@lcap/wave-sandbox-sdk 0.0.1 → 0.0.3

package/README.md

@@ -232,6 +232,28 @@ items.forEach(([name, type]) => {
 });
 ```
 
+##### `files(dirPath: string): Promise<Record<string, ProjectFile>>`
+
+获取指定目录下的所有文件（递归）。
+
+**参数：**
+- `dirPath`: 目录路径
+
+**返回：** Promise<Record<string, ProjectFile>> 文件路径到文件信息的映射
+
+**示例：**
+```typescript
+const files = await client.fs.files('.');
+Object.entries(files).forEach(([path, file]) => {
+  console.log(`文件路径: ${path}`);
+  console.log(`文件名: ${file.name}`);
+  console.log(`MIME类型: ${file.type}`);
+  console.log(`是否二进制: ${file.isBinary}`);
+  console.log(`最后修改时间: ${new Date(file.lastModified)}`);
+  console.log(`文件大小: ${file.size} 字节`);
+});
+```
+
 ##### `writeFile(filePath: string, data: string | Blob | ArrayBuffer | Uint8Array, chunkSize?: number): Promise<void>`
 
 写入文件（流式）。
@@ -427,7 +449,7 @@ console.log('工作空间模式:', info.workspace);
 
 ##### `getFiles(): Promise<ProjectFile[]>`
 
-获取项目文件列表。
+获取项目文件列表（仅返回文件，不包含目录）。
 
 **返回：** Promise<ProjectFile[]> 项目文件数组
 
@@ -435,7 +457,12 @@ console.log('工作空间模式:', info.workspace);
 ```typescript
 const files = await client.project.getFiles();
 files.forEach((file) => {
-  console.log('文件:', file.path);
+  console.log('文件路径:', file.path);
+  console.log('文件名:', file.name);
+  console.log('MIME类型:', file.type);
+  console.log('是否二进制:', file.isBinary);
+  console.log('最后修改时间:', new Date(file.lastModified));
+  console.log('文件大小:', file.size, '字节');
 });
 ```
 
@@ -860,6 +887,12 @@ enum FileType {
 interface FileChangeEvent {
   type: 'add' | 'change' | 'unlink' | 'addDir' | 'unlinkDir';
   path: string;
+  /** 是否为二进制文件（仅在 add 和 change 事件中存在） */
+  isBinary?: boolean;
+  /** 最后修改时间（毫秒时间戳，仅在文件事件中存在） */
+  lastModified?: number;
+  /** 文件大小（字节，仅在文件事件中存在） */
+  size?: number;
 }
 ```
 
@@ -882,6 +915,19 @@ interface ProjectInfo {
 }
 ```
 
+### ProjectFile
+
+```typescript
+interface ProjectFile {
+  path: string;           // 文件相对路径
+  name: string;            // 文件名
+  type: string;            // MIME 类型
+  isBinary: boolean;       // 是否为二进制文件
+  lastModified: number;    // 最后修改时间（毫秒时间戳）
+  size: number;           // 文件大小（字节）
+}
+```
+
 ### SendMessageOptions
 
 ```typescript

package/dist/index.d.ts

@@ -6,4 +6,4 @@ export { FileSystemModule } from './modules/file-system.js';
 export { PortModule } from './modules/port.js';
 export { ProjectModule } from './modules/project.js';
 export { AgentModule } from './modules/agent.js';
-export type { Attachment, SendMessageOptions, ProcessQueueItem, MessageQueueChangedEvent, MessageSendEvent, MessageRunningEvent, MessageFinishedEvent, InitializingEvent, InitializedEvent, MessageBlockAddedEvent, MessageBlockUpdatedEvent, MessageToolBlockUpdatedEvent, MessageSubagentBlockAddEvent, MessageSubagentBlockStatusUpdatedEvent, MessageSubagentBlockContentUpdatedEvent, MessageSubagentToolBlockUpdatedEvent, MessageErrorBlockAddedEvent, MessageCommandOutputMessageAddedEvent, MessageCommandOutputMessageUpdatedEvent, MessageCommandOutputMessageCompletedEvent, McpServersChangeEvent, DocumentParseStartEvent, DocumentParseCompleteEvent, DocumentParseErrorEvent, AgentEventMap, AgentEventName, } from './modules/agent.js';
+export type { Attachment, SendMessageOptions, ProcessQueueItem, MessageQueueChangedEvent, MessageSendEvent, MessageRunningEvent, MessageFinishedEvent, InitializingEvent, InitializedEvent, MessageBlockAddedEvent, MessageBlockUpdatedEvent, MessageToolBlockUpdatedEvent, MessageSubagentBlockAddEvent, MessageSubagentBlockStatusUpdatedEvent, MessageSubagentBlockContentUpdatedEvent, MessageSubagentToolBlockUpdatedEvent, MessageErrorBlockAddedEvent, MessageCommandOutputMessageAddedEvent, MessageCommandOutputMessageUpdatedEvent, MessageCommandOutputMessageCompletedEvent, McpServersChangeEvent, DocumentParseStartEvent, DocumentParseCompleteEvent, DocumentParseErrorEvent, AskUserQuestionEvent, ClientCallBackOptions, AgentEventMap, AgentEventName, } from './modules/agent.js';

package/dist/modules/agent.d.ts

@@ -242,6 +242,32 @@ export interface DocumentParseErrorEvent {
     mimeType: string;
     error: string;
 }
+export interface AskUserQuestionOption {
+    label: string;
+    description?: string;
+    isRecommended?: boolean;
+}
+export interface AskUserQuestion {
+    question: string;
+    header: string;
+    options: AskUserQuestionOption[];
+    multiSelect?: boolean;
+}
+/**
+ * 询问用户问题事件数据
+ */
+export interface AskUserQuestionEvent {
+    questionId: string;
+    questions?: AskUserQuestion[];
+}
+/**
+ * 客户端回调选项
+ */
+export interface ClientCallBackOptions<T> {
+    event: string;
+    id: string;
+    data: T;
+}
 /**
  * Agent 事件名称映射
  */
@@ -267,6 +293,7 @@ export type AgentEventMap = {
     'agent:document-parse-start': DocumentParseStartEvent;
     'agent:document-parse-complete': DocumentParseCompleteEvent;
     'agent:document-parse-error': DocumentParseErrorEvent;
+    'agent:ask-user-question': AskUserQuestionEvent;
 };
 /**
  * Agent 事件名称类型
@@ -438,6 +465,17 @@ export declare class AgentModule {
      * @returns 取消监听的函数
      */
     onDocumentParseError(callback: (event: DocumentParseErrorEvent) => void): () => void;
+    /**
+     * 监听询问用户问题事件
+     * @param callback 回调函数
+     * @returns 取消监听的函数
+     */
+    onAskUserQuestion(callback: (event: AskUserQuestionEvent) => void): () => void;
+    /**
+     * 发送客户端回调
+     * @param options 客户端回调选项
+     */
+    clientCallBack<T = unknown>(options: ClientCallBackOptions<T>): Promise<void>;
     /**
      * 通用事件监听方法，用于监听自定义事件
      * @param eventName 事件名称（必须以 'agent:' 开头）

package/dist/modules/agent.js

@@ -236,6 +236,21 @@ export class AgentModule {
     onDocumentParseError(callback) {
         return onSocketEvent(this.socket, 'agent:document-parse-error', callback);
     }
+    /**
+     * 监听询问用户问题事件
+     * @param callback 回调函数
+     * @returns 取消监听的函数
+     */
+    onAskUserQuestion(callback) {
+        return onSocketEvent(this.socket, 'agent:ask-user-question', callback);
+    }
+    /**
+     * 发送客户端回调
+     * @param options 客户端回调选项
+     */
+    async clientCallBack(options) {
+        return createSocketHandler(this.socket, 'agent:clientCallBack', () => options);
+    }
     /**
      * 通用事件监听方法，用于监听自定义事件
      * @param eventName 事件名称（必须以 'agent:' 开头）

package/dist/modules/file-system.d.ts

@@ -1,5 +1,5 @@
 import type { Socket } from 'socket.io-client';
-import type { FileStat, DirectoryItem, FileChangeEvent } from '../types/index.js';
+import type { FileStat, DirectoryItem, FileChangeEvent, ProjectFile } from '../types/index.js';
 /**
  * 文件系统模块
  */
@@ -12,6 +12,10 @@ export declare class FileSystemModule {
      * 获取查询参数
      */
     private getQueryParams;
+    /**
+     * 获取查询参数（用于目录路径）
+     */
+    private getDirQueryParams;
     /**
      * 获取文件状态
      */
@@ -34,6 +38,12 @@ export declare class FileSystemModule {
      * 读取目录
      */
     readdir(filePath: string): Promise<DirectoryItem[]>;
+    /**
+     * 获取指定目录下的所有文件
+     * @param dirPath 目录路径
+     * @returns Promise<Record<string, ProjectFile>> 文件路径到文件信息的映射
+     */
+    files(dirPath: string): Promise<Record<string, ProjectFile>>;
     /**
      * 写入文件（流式）
      * @param filePath 文件路径

package/dist/modules/file-system.js

@@ -18,6 +18,16 @@ export class FileSystemModule {
         }
         return params.toString();
     }
+    /**
+     * 获取查询参数（用于目录路径）
+     */
+    getDirQueryParams(dirPath) {
+        const params = new URLSearchParams({ dirPath });
+        if (this.projectId) {
+            params.set('projectId', this.projectId);
+        }
+        return params.toString();
+    }
     /**
      * 获取文件状态
      */
@@ -71,6 +81,20 @@ export class FileSystemModule {
         }
         return result.data;
     }
+    /**
+     * 获取指定目录下的所有文件
+     * @param dirPath 目录路径
+     * @returns Promise<Record<string, ProjectFile>> 文件路径到文件信息的映射
+     */
+    async files(dirPath) {
+        const url = `${this.baseUrl}/api/fs/files?${this.getDirQueryParams(dirPath)}`;
+        const response = await fetch(url);
+        const result = await response.json();
+        if (result.status === 'error') {
+            throw new Error(result.message);
+        }
+        return result.data;
+    }
     /**
      * 写入文件（流式）
      * @param filePath 文件路径

package/dist/types/index.d.ts

@@ -56,6 +56,10 @@ export interface FileChangeEvent {
     path: string;
     /** 是否为二进制文件（仅在 add 和 change 事件中存在） */
     isBinary?: boolean;
+    /** 最后修改时间（毫秒时间戳，仅在文件事件中存在） */
+    lastModified?: number;
+    /** 文件大小（字节，仅在文件事件中存在） */
+    size?: number;
 }
 /**
  * 端口状态类型
@@ -81,6 +85,11 @@ export interface ProjectInfo {
  */
 export interface ProjectFile {
     path: string;
+    name: string;
+    type: string;
+    isBinary: boolean;
+    lastModified: number;
+    size: number;
 }
 /**
  * SDK 配置选项

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lcap/wave-sandbox-sdk",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "SDK for Wave Sandbox Client",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,7 +11,7 @@
     "README.md"
   ],
   "dependencies": {
-    "socket.io-client": "^4.8.1"
+    "socket.io-client": "^4.8.3"
   },
   "devDependencies": {
     "rimraf": "^6.1.2",

package/src/index.ts

@@ -55,6 +55,8 @@ export type {
   DocumentParseStartEvent,
   DocumentParseCompleteEvent,
   DocumentParseErrorEvent,
+  AskUserQuestionEvent,
+  ClientCallBackOptions,
   AgentEventMap,
   AgentEventName,
 } from './modules/agent.js';

package/src/modules/agent.ts

@@ -276,6 +276,36 @@ export interface DocumentParseErrorEvent {
   error: string;
 }
 
+export interface AskUserQuestionOption {
+  label: string;
+  description?: string;
+  isRecommended?: boolean;
+}
+
+export interface AskUserQuestion {
+  question: string;
+  header: string;
+  options: AskUserQuestionOption[];
+  multiSelect?: boolean;
+}
+
+/**
+ * 询问用户问题事件数据
+ */
+export interface AskUserQuestionEvent {
+  questionId: string;
+  questions?: AskUserQuestion[];
+}
+
+/**
+ * 客户端回调选项
+ */
+export interface ClientCallBackOptions<T> {
+  event: string;
+  id: string;
+  data: T;
+}
+
 /**
  * Agent 事件名称映射
  */
@@ -301,6 +331,7 @@ export type AgentEventMap = {
   'agent:document-parse-start': DocumentParseStartEvent;
   'agent:document-parse-complete': DocumentParseCompleteEvent;
   'agent:document-parse-error': DocumentParseErrorEvent;
+  'agent:ask-user-question': AskUserQuestionEvent;
 };
 
 /**
@@ -609,6 +640,23 @@ export class AgentModule {
     return onSocketEvent<DocumentParseErrorEvent>(this.socket, 'agent:document-parse-error', callback);
   }
 
+  /**
+   * 监听询问用户问题事件
+   * @param callback 回调函数
+   * @returns 取消监听的函数
+   */
+  onAskUserQuestion(callback: (event: AskUserQuestionEvent) => void): () => void {
+    return onSocketEvent<AskUserQuestionEvent>(this.socket, 'agent:ask-user-question', callback);
+  }
+
+  /**
+   * 发送客户端回调
+   * @param options 客户端回调选项
+   */
+  async clientCallBack<T = unknown>(options: ClientCallBackOptions<T>): Promise<void> {
+    return createSocketHandler<ClientCallBackOptions<T>, void>(this.socket, 'agent:clientCallBack', () => options);
+  }
+
   /**
    * 通用事件监听方法，用于监听自定义事件
    * @param eventName 事件名称（必须以 'agent:' 开头）

package/src/modules/file-system.ts

@@ -1,6 +1,6 @@
 import type { Socket } from 'socket.io-client';
 import { createSocketHandler, onSocketEvent } from '../utils/socket.js';
-import type { FileStat, DirectoryItem, FileChangeEvent, HttpResponse } from '../types/index.js';
+import type { FileStat, DirectoryItem, FileChangeEvent, HttpResponse, ProjectFile } from '../types/index.js';
 
 /**
  * 文件系统模块
@@ -23,6 +23,17 @@ export class FileSystemModule {
     return params.toString();
   }
 
+  /**
+   * 获取查询参数（用于目录路径）
+   */
+  private getDirQueryParams(dirPath: string): string {
+    const params = new URLSearchParams({ dirPath });
+    if (this.projectId) {
+      params.set('projectId', this.projectId);
+    }
+    return params.toString();
+  }
+
   /**
    * 获取文件状态
    */
@@ -93,6 +104,23 @@ export class FileSystemModule {
     return result.data;
   }
 
+  /**
+   * 获取指定目录下的所有文件
+   * @param dirPath 目录路径
+   * @returns Promise<Record<string, ProjectFile>> 文件路径到文件信息的映射
+   */
+  async files(dirPath: string): Promise<Record<string, ProjectFile>> {
+    const url = `${this.baseUrl}/api/fs/files?${this.getDirQueryParams(dirPath)}`;
+    const response = await fetch(url);
+    const result: HttpResponse<Record<string, ProjectFile>> = await response.json();
+
+    if (result.status === 'error') {
+      throw new Error(result.message);
+    }
+
+    return result.data;
+  }
+
   /**
    * 写入文件（流式）
    * @param filePath 文件路径

package/src/types/index.ts

@@ -66,6 +66,10 @@ export interface FileChangeEvent {
   path: string;
   /** 是否为二进制文件（仅在 add 和 change 事件中存在） */
   isBinary?: boolean;
+  /** 最后修改时间（毫秒时间戳，仅在文件事件中存在） */
+  lastModified?: number;
+  /** 文件大小（字节，仅在文件事件中存在） */
+  size?: number;
 }
 
 /**
@@ -95,7 +99,11 @@ export interface ProjectInfo {
  */
 export interface ProjectFile {
   path: string;
-  // 可以根据实际需要添加更多字段
+  name: string;
+  type: string;
+  isBinary: boolean;
+  lastModified: number;
+  size: number;
 }
 
 /**