@lcap/wave-sandbox-sdk 0.0.2 → 0.0.3

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lcap/wave-sandbox-sdk",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "SDK for Wave Sandbox Client",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,15 +10,6 @@
     "src",
     "README.md"
   ],
-  "scripts": {
-    "build": "rimraf dist && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
-    "type-check": "tsc --noEmit",
-    "dev": "tsc -p tsconfig.build.json --watch & tsc-alias -p tsconfig.build.json --watch",
-    "test": "vitest run",
-    "lint": "eslint --cache",
-    "format": "prettier --write .",
-    "prepublishOnly": "pnpm run build"
-  },
   "dependencies": {
     "socket.io-client": "^4.8.3"
   },
@@ -31,5 +22,13 @@
   "engines": {
     "node": ">=16.0.0"
   },
-  "license": "MIT"
-}
+  "license": "MIT",
+  "scripts": {
+    "build": "rimraf dist && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "type-check": "tsc --noEmit",
+    "dev": "tsc -p tsconfig.build.json --watch & tsc-alias -p tsconfig.build.json --watch",
+    "test": "vitest run",
+    "lint": "eslint --cache",
+    "format": "prettier --write ."
+  }
+}

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:' 开头）