@dexto/client-sdk 1.2.4 → 1.2.5

package/dist/streaming.d.ts

@@ -0,0 +1,57 @@
+import type { StreamingEvent } from '@dexto/core';
+/**
+ * SSE (Server-Sent Events) streaming utilities for client SDK
+ * Adapted from @dexto/webui EventStreamClient
+ */
+export type MessageStreamEvent = StreamingEvent;
+export interface SSEEvent<T = string> {
+    event?: string;
+    data?: T;
+    id?: string;
+    retry?: number;
+}
+export declare class SSEError extends Error {
+    status: number;
+    body: any;
+    constructor(status: number, body: any);
+}
+/**
+ * Creates an async generator that yields SSE events from a Response object.
+ *
+ * @param response The fetch Response object containing the SSE stream
+ * @param options Optional configuration including AbortSignal
+ */
+export declare function stream<T = string>(response: Response, options?: {
+    signal?: AbortSignal;
+}): AsyncGenerator<SSEEvent<T>>;
+/**
+ * Helper to create a stream from a promise that resolves to a Response.
+ * Useful for chaining with Hono client requests.
+ *
+ * @example
+ * ```typescript
+ * const stream = createStream(client.api.chat.$post({ json: { message: 'hi' } }));
+ * for await (const event of stream) { ... }
+ * ```
+ */
+export declare function createStream<T = string>(responsePromise: Promise<Response>, options?: {
+    signal?: AbortSignal;
+}): AsyncGenerator<SSEEvent<T>>;
+/**
+ * Helper to create a typed message stream from a promise that resolves to a Response.
+ * Automatically parses JSON data and yields typed MessageStreamEvent objects.
+ *
+ * @example
+ * ```typescript
+ * const stream = createMessageStream(client.api['message-stream'].$post({ ... }));
+ * for await (const event of stream) {
+ *   if (event.type === 'llm:chunk') {
+ *     console.log(event.content);
+ *   }
+ * }
+ * ```
+ */
+export declare function createMessageStream(responsePromise: Promise<Response>, options?: {
+    signal?: AbortSignal;
+}): AsyncGenerator<MessageStreamEvent>;
+//# sourceMappingURL=streaming.d.ts.map

package/dist/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;GAGG;AAEH,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAEhD,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,MAAM;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,QAAS,SAAQ,KAAK;IAEpB,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,GAAG;gBADT,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,GAAG;CAKvB;AAED;;;;;GAKG;AACH,wBAAuB,MAAM,CAAC,CAAC,GAAG,MAAM,EACpC,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GACnC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAkF7B;AAED;;;;;;;;;GASG;AACH,wBAAuB,YAAY,CAAC,CAAC,GAAG,MAAM,EAC1C,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,EAClC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GACnC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAG7B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAuB,mBAAmB,CACtC,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,EAClC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GACnC,cAAc,CAAC,kBAAkB,CAAC,CAgBpC"}

package/dist/types.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Client configuration for Dexto SDK
+ */
+export interface ClientConfig {
+    /** Base URL of the Dexto server */
+    baseUrl: string;
+    /** Optional API key for authentication */
+    apiKey?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexto/client-sdk",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "private": false,
   "type": "module",
   "main": "./dist/index.cjs",
@@ -16,7 +16,14 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@dexto/core": "1.2.4"
+    "hono": "^4.6.14"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.2",
+    "typescript": "^5.4.2",
+    "vitest": "^1.3.1",
+    "@dexto/core": "1.2.5",
+    "@dexto/server": "1.2.5"
   },
   "files": [
     "dist",
@@ -27,8 +34,9 @@
   },
   "sideEffects": false,
   "scripts": {
-    "build": "tsup",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build": "tsup && tsc -p tsconfig.json --emitDeclarationOnly",
+    "dev": "tsup --watch",
+    "typecheck": "tsc -p tsconfig.typecheck.json --noEmit",
     "lint": "eslint . --ext .ts,.tsx",
     "test": "vitest run",
     "test:watch": "vitest watch"

package/dist/index.d.cts

@@ -1,232 +0,0 @@
-import { ImageData, FileData, ProviderInfo, LLMRouter, SupportedFileType, ModelInfo, McpServerConfig, ToolSet, AgentEventMap, SessionEventMap, SessionMetadata, LLMConfig, SearchOptions, SearchResponse, SessionSearchResponse } from '@dexto/core';
-export { AgentEventMap, FileData, ImageData, InternalMessage, LLMConfig, LLMProvider, LLMRouter, McpServerConfig, ModelInfo, ProviderInfo, SearchOptions, SearchResponse, SearchResult, SessionEventMap, SessionMetadata, SessionSearchResponse, SessionSearchResult, SupportedFileType, ToolSet } from '@dexto/core';
-
-interface ClientConfig {
-    baseUrl: string;
-    apiKey?: string | undefined;
-    timeout?: number | undefined;
-    retries?: number | undefined;
-}
-interface ClientOptions {
-    enableWebSocket?: boolean | undefined;
-    reconnect?: boolean | undefined;
-    reconnectInterval?: number | undefined;
-    debug?: boolean | undefined;
-}
-interface MessageInput {
-    content: string;
-    imageData?: ImageData;
-    fileData?: FileData;
-    sessionId?: string;
-    stream?: boolean;
-}
-interface MessageResponse {
-    response: string;
-    sessionId: string;
-}
-type ClientProviderInfo = ProviderInfo;
-type McpServer = McpServerConfig;
-type Tool = ToolSet;
-type CatalogModel = ModelInfo;
-type CatalogProvider = ProviderInfo;
-interface CatalogOptions {
-    provider?: string;
-    hasKey?: boolean;
-    router?: LLMRouter;
-    fileType?: SupportedFileType;
-    defaultOnly?: boolean;
-    mode?: 'grouped' | 'flat';
-}
-interface CatalogResponse {
-    providers?: Record<string, CatalogProvider>;
-    models?: Array<CatalogModel & {
-        provider: string;
-    }>;
-}
-type DextoEvent = {
-    [K in keyof AgentEventMap as K extends string ? K : never]: {
-        type: K;
-        data: AgentEventMap[K];
-    };
-}[keyof AgentEventMap] | {
-    [K in keyof SessionEventMap as K extends string ? K : never]: {
-        type: K;
-        data: SessionEventMap[K];
-        sessionId: string;
-    };
-}[keyof SessionEventMap];
-
-type EventHandler = (event: DextoEvent) => void;
-
-/**
- * Dexto Client SDK - Ultra-lightweight HTTP/WebSocket wrapper
- *
- * This SDK provides a thin interface for interacting with Dexto API.
- * All validation is handled by the server - we just pass data through.
- *
- * @example
- * ```typescript
- * const client = new DextoClient({
- *   baseUrl: 'https://your-dexto-server.com',
- *   apiKey: 'optional-api-key'
- * });
- *
- * await client.connect();
- *
- * const response = await client.sendMessage({
- *   content: 'Hello, how can you help me?'
- * });
- *
- * console.log(response.response);
- * ```
- */
-declare class DextoClient {
-    private http;
-    private ws;
-    private config;
-    private options;
-    constructor(config: ClientConfig, options?: ClientOptions);
-    private initializeWebSocket;
-    /**
-     * Establish connection to Dexto server (including WebSocket if enabled)
-     */
-    connect(): Promise<void>;
-    /**
-     * Disconnect from Dexto server
-     */
-    disconnect(): void;
-    /**
-     * Send a message to the Dexto agent
-     */
-    sendMessage(input: MessageInput): Promise<MessageResponse>;
-    /**
-     * Send a message via WebSocket for streaming responses
-     */
-    sendMessageStream(input: MessageInput): boolean;
-    /**
-     * List all sessions
-     */
-    listSessions(): Promise<SessionMetadata[]>;
-    /**
-     * Create a new session
-     */
-    createSession(sessionId?: string): Promise<SessionMetadata>;
-    /**
-     * Get session details
-     */
-    getSession(sessionId: string): Promise<SessionMetadata>;
-    /**
-     * Get session conversation history
-     */
-    getSessionHistory(sessionId: string): Promise<any[]>;
-    /**
-     * Delete a session permanently
-     */
-    deleteSession(sessionId: string): Promise<void>;
-    /**
-     * Load a session as the current working session
-     */
-    loadSession(sessionId: string | null): Promise<void>;
-    /**
-     * Get the current working session
-     */
-    getCurrentSession(): Promise<string>;
-    /**
-     * Reset conversation (clear history while keeping session alive)
-     */
-    resetConversation(sessionId?: string): Promise<void>;
-    /**
-     * Get current LLM configuration
-     */
-    getCurrentLLMConfig(sessionId?: string): Promise<LLMConfig>;
-    /**
-     * Switch LLM configuration
-     */
-    switchLLM(config: Partial<LLMConfig>, sessionId?: string): Promise<LLMConfig>;
-    /**
-     * Get available LLM providers and models
-     */
-    getLLMProviders(): Promise<Record<string, ClientProviderInfo>>;
-    /**
-     * Get LLM catalog with filtering options
-     */
-    getLLMCatalog(options?: CatalogOptions): Promise<CatalogResponse>;
-    /**
-     * List connected MCP servers
-     */
-    listMCPServers(): Promise<McpServer[]>;
-    /**
-     * Connect to a new MCP server
-     */
-    connectMCPServer(name: string, config: Record<string, unknown>): Promise<void>;
-    /**
-     * Disconnect from an MCP server
-     */
-    disconnectMCPServer(serverId: string): Promise<void>;
-    /**
-     * Get tools from a specific MCP server
-     */
-    getMCPServerTools(serverId: string): Promise<Tool[]>;
-    /**
-     * Execute a tool from an MCP server
-     */
-    executeMCPTool(serverId: string, toolName: string, args: unknown): Promise<unknown>;
-    /**
-     * Search messages across sessions
-     */
-    searchMessages(query: string, options?: SearchOptions): Promise<SearchResponse>;
-    /**
-     * Search sessions that contain the query
-     */
-    searchSessions(query: string): Promise<SessionSearchResponse>;
-    /**
-     * Subscribe to real-time events
-     */
-    on(eventType: string, handler: EventHandler): () => void;
-    /**
-     * Subscribe to connection state changes
-     */
-    onConnectionState(handler: (state: 'connecting' | 'open' | 'closed' | 'error') => void): () => void;
-    /**
-     * Get agent greeting message
-     */
-    getGreeting(sessionId?: string): Promise<string | null>;
-    /**
-     * Get connection status
-     */
-    get connectionState(): 'connecting' | 'open' | 'closed' | 'error';
-    /**
-     * Check if client is connected
-     */
-    get isConnected(): boolean;
-    /**
-     * Get client configuration
-     */
-    get clientConfig(): Readonly<ClientConfig>;
-}
-
-/**
- * Simple error factory for client SDK
- * No complex validation - let server handle validation and return appropriate errors
- */
-declare class ClientError {
-    /**
-     * Connection and Network Errors
-     */
-    static connectionFailed(baseUrl: string, originalError?: Error): Error;
-    static networkError(message: string, originalError?: Error): Error;
-    static httpError(status: number, statusText: string, endpoint?: string, details?: unknown): Error;
-    static timeoutError(operation: string, timeout: number): Error;
-    /**
-     * WebSocket Errors
-     */
-    static websocketConnectionFailed(url: string, originalError?: Error): Error;
-    static websocketSendFailed(originalError?: Error): Error;
-    /**
-     * Configuration Errors
-     */
-    static invalidConfig(field: string, value: unknown, reason: string): Error;
-    static responseParseError(originalError?: Error): Error;
-}
-
-export { type CatalogModel, type CatalogOptions, type CatalogProvider, type CatalogResponse, type ClientConfig, ClientError, type ClientOptions, type ClientProviderInfo, DextoClient, type DextoEvent, type McpServer, type MessageInput, type MessageResponse, type Tool };