@axiom-lattice/client-sdk 1.0.43 → 1.0.44

package/dist/index.d.ts

@@ -283,34 +283,48 @@ declare class AuthenticationError extends Error {
 }
 
 /**
- * Main client class for interacting with the Axiom Lattice Agent Service API
+ * Abstract client class for interacting with the Axiom Lattice Agent Service API
+ * Provides common functionality for different client implementations
  */
-declare class Client {
-    private config;
-    private assistantId;
-    private tenantId;
-    private registeredTools;
-    private headers;
+declare abstract class AbstractClient {
+    protected config: ClientConfig;
+    protected assistantId: string;
+    protected tenantId: string;
+    protected registeredTools: Map<string, RegisterToolOptions>;
     /**
-     * Creates a new Client instance
+     * Creates a new AbstractClient instance
      * @param config - Configuration options for the client
      */
     constructor(config: ClientConfig);
     /**
-     * Helper method to handle fetch responses and errors
-     * @private
+     * Set tenant ID for multi-tenant environments
+     * @param tenantId - Tenant identifier
      */
-    private handleResponse;
+    abstract setTenantId(tenantId: string): void;
     /**
-     * Helper method to make fetch requests
-     * @private
+     * Abstract method for making API requests
+     * To be implemented by concrete client classes
      */
-    private fetchWithTimeout;
+    protected abstract makeRequest<T>(url: string, options?: {
+        method?: string;
+        body?: any;
+        headers?: Record<string, string>;
+    }): Promise<T>;
     /**
-     * Set tenant ID for multi-tenant environments
-     * @param tenantId - Tenant identifier
+     * Abstract method for streaming API requests
+     * To be implemented by concrete client classes
      */
-    setTenantId(tenantId: string): void;
+    /**
+     * Helper method to build stream request parameters
+     * @param options - Options for running the agent
+     * @returns The formatted request parameters
+     */
+    protected buildStreamRequestParams(options: RunOptions): {
+        url: string;
+        method: string;
+        body: any;
+    };
+    protected abstract streamRequest(options: RunOptions, onEvent: (event: MessageChunk) => void, onComplete?: (state?: AgentState) => void, onError?: (error: Error) => void): () => void;
     /**
      * Creates a new thread
      * @param options - Options for creating a thread
@@ -358,15 +372,6 @@ declare class Client {
      * @returns A promise that resolves to the run result
      */
     run(options: RunOptions): Promise<ChatResponse>;
-    /**
-     * Stream run results
-     * @param options - Options for streaming run results
-     * @param onEvent - Callback function that receives stream events
-     * @param onComplete - Optional callback function called when streaming completes
-     * @param onError - Optional callback function called when an error occurs
-     * @returns A function that can be called to stop the stream
-     */
-    private streamRun;
     /**
      * Chat namespace for sending messages and streaming responses
      */
@@ -405,75 +410,90 @@ declare class Client {
 }
 
 /**
- * WeChat Mini Program client for interacting with the Axiom Lattice Agent Service API
+ * Web client class for interacting with the Axiom Lattice Agent Service API
  */
-declare class WeChatClient {
-    private config;
-    private assistantId;
-    private tenantId;
-    private registeredTools;
+declare class Client extends AbstractClient {
+    private headers;
     /**
-     * Creates a new WeChatClient instance
+     * Creates a new Client instance
      * @param config - Configuration options for the client
      */
     constructor(config: ClientConfig);
     /**
-     * Set tenant ID for multi-tenant environments
-     * @param tenantId - Tenant identifier
+     * Helper method to handle fetch responses and errors
+     * @private
      */
-    setTenantId(tenantId: string): void;
+    private handleResponse;
     /**
-     * Helper method to make WeChat HTTP requests
+     * Helper method to make fetch requests
      * @private
      */
-    private request;
+    private fetchWithTimeout;
     /**
-     * Creates a new thread
-     * @param options - Options for creating a thread
-     * @returns A promise that resolves to the thread ID
+     * Set tenant ID for multi-tenant environments
+     * @param tenantId - Tenant identifier
      */
-    createThread(options: CreateThreadOptions): Promise<string>;
+    setTenantId(tenantId: string): void;
     /**
-     * Retrieves thread information
-     * @param threadId - Thread identifier
-     * @returns A promise that resolves to the thread information
+     * Implementation of the abstract makeRequest method for web clients
+     * @param url - The URL to make the request to
+     * @param options - Request options
+     * @returns A promise that resolves to the response data
      */
-    getThread(threadId: string): Promise<Thread>;
+    protected makeRequest<T>(url: string, options?: {
+        method?: string;
+        body?: any;
+        headers?: Record<string, string>;
+    }): Promise<T>;
     /**
-     * Lists all threads
-     * @param options - Options for listing threads
-     * @returns A promise that resolves to an array of threads
+     * Implementation of the abstract streamRequest method for web clients
      */
-    listThreads(options?: ListThreadsOptions): Promise<Thread[]>;
+    protected streamRequest(options: RunOptions, onEvent: (event: MessageChunk) => void, onComplete?: (state?: AgentState) => void, onError?: (error: Error) => void): () => void;
     /**
-     * Deletes a thread
-     * @param threadId - Thread identifier
-     * @returns A promise that resolves when the thread is deleted
+     * Stream run results
+     * @param options - Options for streaming run results
+     * @param onEvent - Callback function that receives stream events
+     * @param onComplete - Optional callback function called when streaming completes
+     * @param onError - Optional callback function called when an error occurs
+     * @returns A function that can be called to stop the stream
      */
-    deleteThread(threadId: string): Promise<void>;
+    private streamRun;
+}
+
+/**
+ * WeChat Mini Program client for interacting with the Axiom Lattice Agent Service API
+ */
+declare class WeChatClient extends AbstractClient {
     /**
-     * Retrieves messages from a thread
-     * @param options - Options for retrieving messages
-     * @returns A promise that resolves to an array of messages
+     * Creates a new WeChatClient instance
+     * @param config - Configuration options for the client
      */
-    getMessages(options: GetMessagesOptions): Promise<Message[]>;
+    constructor(config: ClientConfig);
     /**
-     * Retrieves agent state
-     * @param threadId - Thread identifier
-     * @returns A promise that resolves to the agent state
+     * Set tenant ID for multi-tenant environments
+     * @param tenantId - Tenant identifier
      */
-    getAgentState(threadId: string): Promise<AgentState>;
+    setTenantId(tenantId: string): void;
     /**
-     * Gets agent graph visualization
-     * @returns A promise that resolves to the graph visualization data
+     * Implementation of the abstract makeRequest method for WeChat clients
+     * @param url - The URL to make the request to
+     * @param options - Request options
+     * @returns A promise that resolves to the response data
      */
-    getAgentGraph(): Promise<string>;
+    protected makeRequest<T>(url: string, options?: {
+        method?: string;
+        body?: any;
+        headers?: Record<string, string>;
+    }): Promise<T>;
     /**
-     * Run agent with options
-     * @param options - Options for running the agent
-     * @returns A promise that resolves to the run result
+     * Implementation of the abstract streamRequest method for WeChat clients
+     */
+    protected streamRequest(options: RunOptions, onEvent: (event: MessageChunk) => void, onComplete?: (state?: AgentState) => void, onError?: (error: Error) => void): () => void;
+    /**
+     * Helper method to make WeChat HTTP requests
+     * @private
      */
-    run(options: RunOptions): Promise<any>;
+    private request;
     /**
      * Stream run results using WeChat's downloadFile API
      * @param options - Options for streaming run results
@@ -483,41 +503,14 @@ declare class WeChatClient {
      * @returns A function that can be called to stop the stream
      */
     private streamRun;
+    decodeUint8Array(uint8Array: ArrayBuffer): any;
+    buf2hex(arrayBuffer: ArrayBuffer): string;
     /**
-     * Chat namespace for sending messages and streaming responses
-     */
-    chat: {
-        /**
-         * Sends a message to a thread and receives a response
-         * @param options - Options for sending a message
-         * @returns A promise that resolves to the chat response
-         */
-        send: (options: ChatSendOptions) => Promise<ChatResponse>;
-        /**
-         * Sends a message to a thread and streams the response
-         * @param options - Options for streaming a message
-         * @param onEvent - Callback function that receives stream events
-         * @param onComplete - Optional callback function called when streaming completes
-         * @param onError - Optional callback function called when an error occurs
-         * @returns A function that can be called to stop the stream
-         */
-        stream: (options: ChatStreamOptions, onEvent: (event: MessageChunk) => void, onComplete?: (state?: AgentState) => void, onError?: (error: Error) => void) => (() => void);
-    };
-    /**
-     * Tools namespace for registering and unregistering client-side tools
+     * 十六进制字符串转中文
+     * @param {String} hex 为十六进制字符串
+     * @return {String} 包含中文的字符串
      */
-    tools: {
-        /**
-         * Registers a client-side tool
-         * @param options - Options for registering a tool
-         */
-        register: (options: RegisterToolOptions) => void;
-        /**
-         * Unregisters a client-side tool
-         * @param name - Tool name
-         */
-        unregister: (name: string) => void;
-    };
+    hexToStr(hex: string): any;
 }
 
 /**
@@ -538,4 +531,4 @@ declare function createSimpleMessageMerger(): {
     reset: () => void;
 };
 
-export { AgentState, ApiError, AuthenticationError, ChatResponse, ChatSendOptions, ChatStreamOptions, Client, ClientConfig, CreateThreadOptions, GetMessagesOptions, ListThreadsOptions, NetworkError, RegisterToolOptions, RetryConfig, RunOptions, StreamCallbacks, Thread, Transport, WeChatClient, createSimpleMessageMerger };
+export { AbstractClient, AgentState, ApiError, AuthenticationError, ChatResponse, ChatSendOptions, ChatStreamOptions, Client, ClientConfig, CreateThreadOptions, GetMessagesOptions, ListThreadsOptions, NetworkError, RegisterToolOptions, RetryConfig, RunOptions, StreamCallbacks, Thread, Transport, WeChatClient, createSimpleMessageMerger };

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC"}