@lcap/wave-sandbox-sdk 0.0.2 → 0.0.4

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, AskInfo, ClientCallBackOptions, AskUserQuestion, AskUserQuestionOption, AgentEventMap, AgentEventName, } from './modules/agent.js';

package/dist/modules/agent.d.ts

@@ -242,6 +242,43 @@ 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[];
+}
+/**
+ * Ask 信息状态
+ */
+export interface AskInfo {
+    questionId: string;
+    sessionId: string;
+    questions: AskUserQuestion[];
+    createdAt: number;
+    answered: boolean;
+    answer?: string;
+}
+/**
+ * 客户端回调选项
+ */
+export interface ClientCallBackOptions<T> {
+    event: string;
+    id: string;
+    data: T;
+}
 /**
  * Agent 事件名称映射
  */
@@ -267,6 +304,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 事件名称类型
@@ -312,6 +350,12 @@ export declare class AgentModule {
      * @returns Promise<MessageQueueChangedEvent | null> 返回当前状态，如果没有活动状态则返回 null
      */
     getCurrentState(): Promise<MessageQueueChangedEvent | null>;
+    /**
+     * 获取指定 session 的 ask 信息
+     * @param sessionId 会话 ID
+     * @returns Promise<AskInfo | null> 返回 ask 信息，如果不存在则返回 null
+     */
+    getAskInfo(sessionId: string): Promise<AskInfo | null>;
     /**
      * 监听消息发送事件
      * @param callback 回调函数
@@ -438,6 +482,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

@@ -68,6 +68,23 @@ export class AgentModule {
         }
         return result.data;
     }
+    /**
+     * 获取指定 session 的 ask 信息
+     * @param sessionId 会话 ID
+     * @returns Promise<AskInfo | null> 返回 ask 信息，如果不存在则返回 null
+     */
+    async getAskInfo(sessionId) {
+        const queryParams = this.getQueryParams();
+        const sessionIdParam = `sessionId=${encodeURIComponent(sessionId)}`;
+        const params = queryParams ? `${queryParams}&${sessionIdParam}` : sessionIdParam;
+        const url = `${this.baseUrl}/api/agent/askInfo?${params}`;
+        const response = await fetch(url);
+        const result = await response.json();
+        if (result.status === 'error') {
+            throw new Error(result.message);
+        }
+        return result.data;
+    }
     /**
      * 监听消息发送事件
      * @param callback 回调函数
@@ -236,6 +253,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.4",
   "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,11 @@ export type {
   DocumentParseStartEvent,
   DocumentParseCompleteEvent,
   DocumentParseErrorEvent,
+  AskUserQuestionEvent,
+  AskInfo,
+  ClientCallBackOptions,
+  AskUserQuestion,
+  AskUserQuestionOption,
   AgentEventMap,
   AgentEventName,
 } from './modules/agent.js';

package/src/modules/agent.ts

@@ -276,6 +276,48 @@ 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[];
+}
+
+/**
+ * Ask 信息状态
+ */
+export interface AskInfo {
+  questionId: string;
+  sessionId: string;
+  questions: AskUserQuestion[];
+  createdAt: number; // 时间戳（毫秒）
+  answered: boolean;
+  answer?: string;
+}
+
+/**
+ * 客户端回调选项
+ */
+export interface ClientCallBackOptions<T> {
+  event: string;
+  id: string;
+  data: T;
+}
+
 /**
  * Agent 事件名称映射
  */
@@ -301,6 +343,7 @@ export type AgentEventMap = {
   'agent:document-parse-start': DocumentParseStartEvent;
   'agent:document-parse-complete': DocumentParseCompleteEvent;
   'agent:document-parse-error': DocumentParseErrorEvent;
+  'agent:ask-user-question': AskUserQuestionEvent;
 };
 
 /**
@@ -394,6 +437,26 @@ export class AgentModule {
     return result.data;
   }
 
+  /**
+   * 获取指定 session 的 ask 信息
+   * @param sessionId 会话 ID
+   * @returns Promise<AskInfo | null> 返回 ask 信息，如果不存在则返回 null
+   */
+  async getAskInfo(sessionId: string): Promise<AskInfo | null> {
+    const queryParams = this.getQueryParams();
+    const sessionIdParam = `sessionId=${encodeURIComponent(sessionId)}`;
+    const params = queryParams ? `${queryParams}&${sessionIdParam}` : sessionIdParam;
+    const url = `${this.baseUrl}/api/agent/askInfo?${params}`;
+    const response = await fetch(url);
+    const result: HttpResponse<AskInfo | null> = await response.json();
+
+    if (result.status === 'error') {
+      throw new Error(result.message);
+    }
+
+    return result.data;
+  }
+
   /**
    * 监听消息发送事件
    * @param callback 回调函数
@@ -609,6 +672,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:' 开头）