@juspay/neurolink 9.54.3 → 9.54.5

package/dist/{types/clientTypes.d.ts → lib/types/client.d.ts}

@@ -8,7 +8,8 @@
  * @module @neurolink/client/types
  */
 import type { JsonValue, JsonObject, UnknownRecord } from "./common.js";
-import type { ToolCall, ToolResult } from "./streamTypes.js";
+import type { StreamToolCall, StreamToolResult } from "./stream.js";
+import type { StreamResult } from "./stream.js";
 /**
  * Client configuration options for initializing the NeuroLink client
  */
@@ -52,7 +53,7 @@ export type ClientRetryConfig = {
 /**
  * Request options that can be passed to individual API calls
  */
-export type RequestOptions = {
+export type ClientRequestOptions = {
     /** Request timeout override in milliseconds */
     timeout?: number;
     /** Signal for request cancellation */
@@ -80,7 +81,7 @@ export type ClientApiResponse<T> = {
 /**
  * Error response from API
  */
-export type ApiError = {
+export type ClientApiError = {
     /** Error code (e.g., "RATE_LIMIT_EXCEEDED", "INVALID_REQUEST") */
     code: string;
     /** Human-readable error message */
@@ -117,21 +118,21 @@ export type ClientProviderStatus = {
 /**
  * Stream event types for real-time communication
  */
-export type StreamEventType = "text" | "tool-call" | "tool-result" | "error" | "done" | "metadata" | "audio" | "thinking";
+export type ClientStreamEventType = "text" | "tool-call" | "tool-result" | "error" | "done" | "metadata" | "audio" | "thinking";
 /**
  * Stream event from SSE/WebSocket
  */
 export type ClientStreamEvent = {
     /** Event type */
-    type: StreamEventType;
+    type: ClientStreamEventType;
     /** Text content (for text events) */
     content?: string;
     /** Tool call data (for tool-call events) */
-    toolCall?: ToolCall;
+    toolCall?: StreamToolCall;
     /** Tool result data (for tool-result events) */
-    toolResult?: ToolResult;
+    toolResult?: StreamToolResult;
     /** Error data (for error events) */
-    error?: ApiError;
+    error?: ClientApiError;
     /** Metadata (for metadata events) */
     metadata?: JsonObject;
     /** Audio data (for audio events) */
@@ -148,15 +149,15 @@ export type ClientStreamEvent = {
 /**
  * Streaming callback handlers
  */
-export type StreamCallbacks = {
+export type ClientStreamCallbacks = {
     /** Called for each text chunk */
     onText?: (text: string) => void;
     /** Called for each tool call */
-    onToolCall?: (toolCall: ToolCall) => void;
+    onToolCall?: (toolCall: StreamToolCall) => void;
     /** Called for each tool result */
-    onToolResult?: (toolResult: ToolResult) => void;
+    onToolResult?: (toolResult: StreamToolResult) => void;
     /** Called on stream error */
-    onError?: (error: ApiError) => void;
+    onError?: (error: ClientApiError) => void;
     /** Called when stream completes */
     onDone?: (result: ClientStreamResult) => void;
     /** Called for metadata updates */
@@ -176,9 +177,9 @@ export type ClientStreamResult = {
     /** Full accumulated text content */
     content: string;
     /** All tool calls made */
-    toolCalls?: ToolCall[];
+    toolCalls?: StreamToolCall[];
     /** All tool results */
-    toolResults?: ToolResult[];
+    toolResults?: StreamToolResult[];
     /** Token usage information */
     usage?: {
         promptTokens: number;
@@ -193,7 +194,7 @@ export type ClientStreamResult = {
 /**
  * Generate request options (client-side version)
  */
-export type GenerateRequestOptions = {
+export type ClientGenerateRequestOptions = {
     /** Input for generation */
     input: {
         text: string;
@@ -220,7 +221,7 @@ export type GenerateRequestOptions = {
 /**
  * Generate response (client-side version)
  */
-export type GenerateResponse = {
+export type ClientGenerateResponse = {
     /** Generated content */
     content: string;
     /** Provider used */
@@ -234,9 +235,9 @@ export type GenerateResponse = {
         totalTokens: number;
     };
     /** Tool calls made */
-    toolCalls?: ToolCall[];
+    toolCalls?: StreamToolCall[];
     /** Tool results */
-    toolResults?: ToolResult[];
+    toolResults?: StreamToolResult[];
     /** Finish reason */
     finishReason?: string;
     /** Response metadata */
@@ -245,14 +246,14 @@ export type GenerateResponse = {
 /**
  * Stream request options (client-side version)
  */
-export type StreamRequestOptions = GenerateRequestOptions & {
+export type ClientStreamRequestOptions = ClientGenerateRequestOptions & {
     /** Enable streaming */
     stream: true;
 };
 /**
  * Agent execution options
  */
-export type AgentExecuteOptions = {
+export type ClientAgentExecuteOptions = {
     /** Agent ID */
     agentId: string;
     /** Input message */
@@ -276,7 +277,7 @@ export type AgentExecuteOptions = {
 /**
  * Agent execution result
  */
-export type AgentExecuteResult = {
+export type ClientAgentExecuteResult = {
     /** Response content */
     content: string;
     /** Agent ID */
@@ -304,7 +305,7 @@ export type AgentExecuteResult = {
 /**
  * Agent information
  */
-export type AgentInfo = {
+export type ClientAgentInfo = {
     /** Agent ID */
     id: string;
     /** Agent name */
@@ -323,7 +324,7 @@ export type AgentInfo = {
 /**
  * Workflow execution options
  */
-export type WorkflowExecuteOptions = {
+export type ClientWorkflowExecuteOptions = {
     /** Workflow ID */
     workflowId: string;
     /** Workflow input data */
@@ -338,7 +339,7 @@ export type WorkflowExecuteOptions = {
 /**
  * Workflow execution result
  */
-export type WorkflowExecuteResult = {
+export type ClientWorkflowExecuteResult = {
     /** Workflow run ID */
     runId: string;
     /** Workflow ID */
@@ -348,7 +349,7 @@ export type WorkflowExecuteResult = {
     /** Output data (if completed) */
     output?: UnknownRecord;
     /** Error information (if failed) */
-    error?: ApiError;
+    error?: ClientApiError;
     /** Suspend token (if suspended) */
     suspendToken?: string;
     /** Step results */
@@ -364,7 +365,7 @@ export type WorkflowExecuteResult = {
 /**
  * Workflow information
  */
-export type WorkflowInfo = {
+export type ClientWorkflowInfo = {
     /** Workflow ID */
     id: string;
     /** Workflow name */
@@ -383,7 +384,7 @@ export type WorkflowInfo = {
 /**
  * Tool information for client use
  */
-export type ToolInfo = {
+export type ClientToolInfo = {
     /** Tool name */
     name: string;
     /** Tool description */
@@ -398,13 +399,13 @@ export type ToolInfo = {
     requiresConfirmation?: boolean;
 };
 /**
- * Middleware function type
+ * ClientMiddleware function type
  */
-export type Middleware = (request: MiddlewareRequest, next: () => Promise<MiddlewareResponse>) => Promise<MiddlewareResponse>;
+export type ClientMiddleware = (request: ClientMiddlewareRequest, next: () => Promise<ClientMiddlewareResponse>) => Promise<ClientMiddlewareResponse>;
 /**
- * Middleware request object
+ * ClientMiddleware request object
  */
-export type MiddlewareRequest = {
+export type ClientMiddlewareRequest = {
     /** Request URL */
     url: string;
     /** HTTP method */
@@ -413,24 +414,24 @@ export type MiddlewareRequest = {
     headers: Record<string, string>;
     /** Request body */
     body?: unknown;
-    /** Middleware context */
+    /** ClientMiddleware context */
     context: ClientMiddlewareContext;
 };
 /**
- * Middleware response object
+ * ClientMiddleware response object
  */
-export type MiddlewareResponse = {
+export type ClientMiddlewareResponse = {
     /** HTTP status code */
     status: number;
     /** Response headers */
     headers: Record<string, string>;
     /** Response body */
     body: unknown;
-    /** Middleware context */
+    /** ClientMiddleware context */
     context: ClientMiddlewareContext;
 };
 /**
- * Middleware context for passing data between middleware
+ * ClientMiddleware context for passing data between middleware
  */
 export type ClientMiddlewareContext = {
     /** Request start time */
@@ -465,9 +466,9 @@ export type ClientChatMessage = {
     /** Message content */
     content: string;
     /** Tool calls in this message */
-    toolCalls?: ToolCall[];
+    toolCalls?: StreamToolCall[];
     /** Tool results in this message */
-    toolResults?: ToolResult[];
+    toolResults?: StreamToolResult[];
     /** Message timestamp */
     createdAt: Date;
     /** Additional metadata */
@@ -492,9 +493,9 @@ export type UseChatOptions = {
     /** Called when response finishes */
     onFinish?: (message: ClientChatMessage) => void;
     /** Called on error */
-    onError?: (error: ApiError) => void;
+    onError?: (error: ClientApiError) => void;
     /** Called for each tool call */
-    onToolCall?: (toolCall: ToolCall) => void;
+    onToolCall?: (toolCall: StreamToolCall) => void;
     /** Request body customization */
     body?: UnknownRecord;
     /** Request headers */
@@ -537,11 +538,11 @@ export type UseChatReturn = {
     /** Loading state */
     isLoading: boolean;
     /** Error state */
-    error: ApiError | null;
+    error: ClientApiError | null;
     /** Clear error */
     clearError: () => void;
     /** Current tool calls being executed */
-    toolCalls: ToolCall[];
+    toolCalls: StreamToolCall[];
 };
 /**
  * useAgent hook options
@@ -552,11 +553,11 @@ export type UseAgentOptions = {
     /** Initial session ID */
     sessionId?: string;
     /** Called on agent response */
-    onResponse?: (result: AgentExecuteResult) => void;
+    onResponse?: (result: ClientAgentExecuteResult) => void;
     /** Called on error */
-    onError?: (error: ApiError) => void;
+    onError?: (error: ClientApiError) => void;
     /** Called when tool is called */
-    onToolCall?: (toolCall: ToolCall) => void;
+    onToolCall?: (toolCall: StreamToolCall) => void;
     /** Auto-execute on mount with initial input */
     initialInput?: string;
 };
@@ -565,9 +566,9 @@ export type UseAgentOptions = {
  */
 export type UseAgentReturn = {
     /** Execute the agent */
-    execute: (input: string, options?: Partial<AgentExecuteOptions>) => Promise<AgentExecuteResult>;
+    execute: (input: string, options?: Partial<ClientAgentExecuteOptions>) => Promise<ClientAgentExecuteResult>;
     /** Stream execution */
-    stream: (input: string, callbacks?: StreamCallbacks) => Promise<void>;
+    stream: (input: string, callbacks?: ClientStreamCallbacks) => Promise<void>;
     /** Current session ID */
     sessionId: string | null;
     /** Set session ID */
@@ -577,9 +578,9 @@ export type UseAgentReturn = {
     /** Streaming state */
     isStreaming: boolean;
     /** Last result */
-    result: AgentExecuteResult | null;
+    result: ClientAgentExecuteResult | null;
     /** Error state */
-    error: ApiError | null;
+    error: ClientApiError | null;
     /** Clear error */
     clearError: () => void;
     /** Abort current execution */
@@ -592,9 +593,9 @@ export type UseWorkflowOptions = {
     /** Workflow ID */
     workflowId: string;
     /** Called on workflow completion */
-    onComplete?: (result: WorkflowExecuteResult) => void;
+    onComplete?: (result: ClientWorkflowExecuteResult) => void;
     /** Called on workflow error */
-    onError?: (error: ApiError) => void;
+    onError?: (error: ClientApiError) => void;
     /** Called on step completion */
     onStepComplete?: (step: {
         stepId: string;
@@ -609,23 +610,23 @@ export type UseWorkflowOptions = {
  */
 export type UseWorkflowReturn = {
     /** Execute the workflow */
-    execute: (input: UnknownRecord, options?: Partial<WorkflowExecuteOptions>) => Promise<WorkflowExecuteResult>;
+    execute: (input: UnknownRecord, options?: Partial<ClientWorkflowExecuteOptions>) => Promise<ClientWorkflowExecuteResult>;
     /** Resume a suspended workflow */
-    resume: (resumeToken: string, resumeData?: UnknownRecord) => Promise<WorkflowExecuteResult>;
+    resume: (resumeToken: string, resumeData?: UnknownRecord) => Promise<ClientWorkflowExecuteResult>;
     /** Get workflow status */
-    getStatus: (runId: string) => Promise<WorkflowExecuteResult>;
+    getStatus: (runId: string) => Promise<ClientWorkflowExecuteResult>;
     /** Cancel workflow execution */
     cancel: (runId: string) => Promise<void>;
     /** Current run ID */
     runId: string | null;
     /** Execution status */
-    status: WorkflowExecuteResult["status"] | null;
+    status: ClientWorkflowExecuteResult["status"] | null;
     /** Loading state */
     isLoading: boolean;
     /** Last result */
-    result: WorkflowExecuteResult | null;
+    result: ClientWorkflowExecuteResult | null;
     /** Error state */
-    error: ApiError | null;
+    error: ClientApiError | null;
     /** Clear error */
     clearError: () => void;
 };
@@ -644,7 +645,7 @@ export type UseVoiceOptions = {
     /** Called when speech ends */
     onSpeechEnd?: () => void;
     /** Called on error */
-    onError?: (error: ApiError) => void;
+    onError?: (error: ClientApiError) => void;
     /** API endpoint for voice */
     api?: string;
     /** Enable speech recognition */
@@ -675,7 +676,7 @@ export type UseVoiceReturn = {
     /** Last response */
     response: string | null;
     /** Error state */
-    error: ApiError | null;
+    error: ClientApiError | null;
     /** Supported by browser */
     isSupported: boolean;
 };
@@ -686,7 +687,7 @@ export type UseStreamOptions = {
     /** API endpoint */
     api?: string;
     /** Stream callbacks */
-    callbacks?: StreamCallbacks;
+    callbacks?: ClientStreamCallbacks;
 };
 /**
  * useStream hook return type
@@ -705,7 +706,7 @@ export type UseStreamReturn = {
     /** Streaming state */
     isStreaming: boolean;
     /** Error state */
-    error: ApiError | null;
+    error: ClientApiError | null;
 };
 /**
  * useTools hook options
@@ -723,7 +724,7 @@ export type UseToolsOptions = {
  */
 export type UseToolsReturn = {
     /** Available tools */
-    tools: ToolInfo[];
+    tools: ClientToolInfo[];
     /** Execute a tool */
     execute: (toolName: string, params: UnknownRecord) => Promise<unknown>;
     /** Refresh tool list */
@@ -731,25 +732,25 @@ export type UseToolsReturn = {
     /** Loading state */
     isLoading: boolean;
     /** Error state */
-    error: ApiError | null;
+    error: ClientApiError | null;
 };
 /**
  * AI SDK Language Model interface (Vercel AI SDK compatible)
  */
-export type LanguageModel = {
+export type ClientLanguageModel = {
     /** Model specification string */
     modelId: string;
     /** Provider name */
     provider: string;
     /** Generate non-streaming response */
-    doGenerate: (options: LanguageModelCallOptions) => Promise<LanguageModelResponse>;
+    doGenerate: (options: ClientLanguageModelCallOptions) => Promise<ClientLanguageModelResponse>;
     /** Generate streaming response */
-    doStream: (options: LanguageModelCallOptions) => Promise<LanguageModelStreamResponse>;
+    doStream: (options: ClientLanguageModelCallOptions) => Promise<ClientLanguageModelStreamResponse>;
 };
 /**
  * Language model call options
  */
-export type LanguageModelCallOptions = {
+export type ClientLanguageModelCallOptions = {
     /** Input prompt */
     prompt: string;
     /** System prompt */
@@ -771,7 +772,7 @@ export type LanguageModelCallOptions = {
 /**
  * Language model response
  */
-export type LanguageModelResponse = {
+export type ClientLanguageModelResponse = {
     /** Generated text */
     text: string;
     /** Finish reason */
@@ -787,7 +788,7 @@ export type LanguageModelResponse = {
 /**
  * Language model stream response
  */
-export type LanguageModelStreamResponse = {
+export type ClientLanguageModelStreamResponse = {
     /** Stream of text deltas */
     stream: AsyncIterable<{
         type: "text-delta" | "finish";
@@ -821,7 +822,7 @@ export type NeuroLinkProviderOptions = {
 /**
  * Model creation options for AI SDK adapter
  */
-export type ModelOptions = {
+export type ClientModelOptions = {
     /** Model ID */
     modelId?: string;
     /** Provider name */
@@ -834,7 +835,7 @@ export type ModelOptions = {
 /**
  * WebSocket connection options
  */
-export type WebSocketOptions = {
+export type ClientWebSocketOptions = {
     /** WebSocket URL */
     url: string;
     /** Protocols */
@@ -851,11 +852,11 @@ export type WebSocketOptions = {
 /**
  * WebSocket connection state
  */
-export type WebSocketState = "connecting" | "connected" | "disconnecting" | "disconnected" | "reconnecting";
+export type ClientWebSocketState = "connecting" | "connected" | "disconnecting" | "disconnected" | "reconnecting";
 /**
  * WebSocket message handler
  */
-export type WebSocketMessageHandler = (data: unknown) => void;
+export type ClientWebSocketMessageHandler = (data: unknown) => void;
 /**
  * Connection state for the dedicated NeuroLinkWebSocket client
  */
@@ -900,7 +901,7 @@ export type WSClientEventHandlers = {
 /**
  * Speech recognition result
  */
-export type SpeechRecognitionResult = {
+export type ClientSpeechRecognitionResult = {
     /** Transcript text */
     transcript: string;
     /** Confidence score (0-1) */
@@ -911,7 +912,7 @@ export type SpeechRecognitionResult = {
 /**
  * Speech synthesis options
  */
-export type SpeechSynthesisOptions = {
+export type ClientSpeechSynthesisOptions = {
     /** Voice to use */
     voice?: string;
     /** Speaking rate (0.1-10) */
@@ -926,7 +927,7 @@ export type SpeechSynthesisOptions = {
 /**
  * Authentication configuration options
  */
-export type AuthConfig = {
+export type ClientAuthConfig = {
     /** API key for header-based authentication */
     apiKey?: string;
     /** Bearer token for JWT/OAuth authentication */
@@ -975,7 +976,7 @@ export type ClientTokenRefreshResult = {
 /**
  * Web Speech API event map for SpeechRecognition
  */
-export interface SpeechRecognitionEventMap {
+export type SpeechRecognitionEventMap = {
     audioend: Event;
     audiostart: Event;
     end: Event;
@@ -987,25 +988,25 @@ export interface SpeechRecognitionEventMap {
     speechend: Event;
     speechstart: Event;
     start: Event;
-}
+};
 /**
  * Internal speech recognition event with results
  */
-export interface SpeechRecognitionEventInternal extends Event {
+export type SpeechRecognitionEventInternal = Event & {
     readonly resultIndex: number;
     readonly results: SpeechRecognitionResultList;
-}
+};
 /**
  * Internal speech recognition error event
  */
-export interface SpeechRecognitionErrorEventInternal extends Event {
+export type SpeechRecognitionErrorEventInternal = Event & {
     readonly error: string;
     readonly message: string;
-}
+};
 /**
  * Internal speech recognition interface for browser Web Speech API
  */
-export interface SpeechRecognitionInternal extends EventTarget {
+export type SpeechRecognitionInternal = EventTarget & {
     continuous: boolean;
     grammars: SpeechGrammarList;
     interimResults: boolean;
@@ -1025,44 +1026,228 @@ export interface SpeechRecognitionInternal extends EventTarget {
     abort(): void;
     start(): void;
     stop(): void;
-}
+};
 /**
  * Speech grammar list interface
  */
-export interface SpeechGrammarList {
+export type SpeechGrammarList = {
     readonly length: number;
     addFromString(string: string, weight?: number): void;
     addFromURI(src: string, weight?: number): void;
     item(index: number): SpeechGrammar;
     [index: number]: SpeechGrammar;
-}
+};
 /**
  * Speech grammar interface
  */
-export interface SpeechGrammar {
+export type SpeechGrammar = {
     src: string;
     weight: number;
-}
+};
 /**
  * Re-export common types for convenience
  */
 export type { JsonValue, JsonObject, UnknownRecord };
-export type { ToolCall, ToolResult };
-/** @deprecated Use {@link ClientRetryConfig} instead */
-export type RetryConfig = ClientRetryConfig;
-/** @deprecated Use {@link ClientApiResponse} instead */
-export type ApiResponse<T = unknown> = ClientApiResponse<T>;
-/** @deprecated Use {@link ClientProviderStatus} instead */
-export type ProviderStatus = ClientProviderStatus;
-/** @deprecated Use {@link ClientStreamEvent} instead */
-export type StreamEvent = ClientStreamEvent;
-/** @deprecated Use {@link ClientStreamResult} instead */
-export type StreamResult = ClientStreamResult;
-/** @deprecated Use {@link ClientMiddlewareContext} instead */
-export type MiddlewareContext = ClientMiddlewareContext;
-/** @deprecated Use {@link ClientChatMessage} instead */
-export type ChatMessage = ClientChatMessage;
-/** @deprecated Use {@link ClientOAuth2Config} instead */
-export type OAuth2Config = ClientOAuth2Config;
-/** @deprecated Use {@link ClientTokenRefreshResult} instead */
-export type TokenRefreshResult = ClientTokenRefreshResult;
+export type { StreamToolCall, StreamToolResult };
+/**
+ * Standard error codes for NeuroLink API errors.
+ * Mirrors the `ErrorCode` const object in client/errors.ts — keep in sync.
+ */
+export type ErrorCodeType = "BAD_REQUEST" | "UNAUTHORIZED" | "FORBIDDEN" | "NOT_FOUND" | "METHOD_NOT_ALLOWED" | "CONFLICT" | "PAYLOAD_TOO_LARGE" | "RATE_LIMITED" | "INVALID_REQUEST" | "VALIDATION_ERROR" | "INTERNAL_ERROR" | "SERVICE_UNAVAILABLE" | "GATEWAY_TIMEOUT" | "BAD_GATEWAY" | "NETWORK_ERROR" | "TIMEOUT" | "CONNECTION_REFUSED" | "DNS_ERROR" | "CONFIGURATION_ERROR" | "SERIALIZATION_ERROR" | "STREAM_ERROR" | "ABORT_ERROR" | "PROVIDER_ERROR" | "MODEL_NOT_FOUND" | "CONTEXT_LENGTH_EXCEEDED" | "CONTENT_FILTERED" | "UNKNOWN";
+/**
+ * Logging interceptor options
+ */
+export type LoggingInterceptorOptions = {
+    /** Log request details */
+    logRequest?: boolean;
+    /** Log response details */
+    logResponse?: boolean;
+    /** Log request body */
+    logBody?: boolean;
+    /** Log response body */
+    logResponseBody?: boolean;
+    /** Custom logger function */
+    logger?: (message: string, data?: unknown) => void;
+    /** Redact sensitive fields */
+    redactFields?: string[];
+};
+/**
+ * Retry interceptor options
+ */
+export type RetryInterceptorOptions = ClientRetryConfig & {
+    /** Callback when a retry is attempted */
+    onRetry?: (attempt: number, error: Error | ClientApiError, request: ClientMiddlewareRequest) => void;
+    /** Custom retry condition */
+    shouldRetry?: (response: ClientMiddlewareResponse, attempt: number) => boolean;
+};
+/**
+ * Rate limiter options
+ */
+export type RateLimiterOptions = {
+    /** Maximum requests per window */
+    maxRequests: number;
+    /** Window size in milliseconds */
+    windowMs: number;
+    /** Strategy when limit is reached: 'queue' or 'throw' */
+    strategy?: "queue" | "throw";
+    /** Callback when rate limited */
+    onRateLimited?: (waitTime: number) => void;
+};
+/**
+ * Cache options
+ */
+export type CacheInterceptorOptions = {
+    /** Cache TTL in milliseconds */
+    ttl: number;
+    /** Maximum cache size */
+    maxSize?: number;
+    /** Cache key generator */
+    keyGenerator?: (request: ClientMiddlewareRequest) => string;
+    /** Methods to cache (default: ['GET']) */
+    methods?: string[];
+    /** Paths to cache (regex patterns) */
+    includePaths?: RegExp[];
+    /** Paths to exclude from cache */
+    excludePaths?: RegExp[];
+};
+/**
+ * Timeout interceptor options
+ */
+export type TimeoutInterceptorOptions = {
+    /** Timeout in milliseconds */
+    timeout: number;
+    /** Callback when timeout occurs */
+    onTimeout?: (request: ClientMiddlewareRequest) => void;
+};
+/**
+ * Error handling interceptor options
+ */
+export type ErrorHandlerOptions = {
+    /** Custom error handler */
+    onError?: (error: Error, request: ClientMiddlewareRequest) => Error | void;
+    /** Transform error response */
+    transformError?: (error: unknown) => ClientApiError;
+    /** Report errors to external service */
+    reportError?: (error: Error, context: ClientMiddlewareContext) => void | Promise<void>;
+};
+/**
+ * SSE connection state
+ */
+export type SSEState = "connecting" | "connected" | "disconnected" | "error";
+/**
+ * SSE client configuration
+ */
+export type SSEConfig = ClientConfig & {
+    /** Auto-reconnect on disconnect (default: true) */
+    autoReconnect?: boolean;
+    /** Maximum reconnection attempts (default: 5) */
+    maxReconnectAttempts?: number;
+    /** Initial reconnection delay in ms (default: 1000) */
+    reconnectDelay?: number;
+    /** Maximum reconnection delay in ms (default: 30000) */
+    maxReconnectDelay?: number;
+    /** Use native EventSource when available (default: false for more control) */
+    useNativeEventSource?: boolean;
+};
+/**
+ * SSE request options
+ */
+export type SSERequestOptions = {
+    /** Request body */
+    body?: unknown;
+    /** Additional headers */
+    headers?: Record<string, string>;
+    /** Abort signal */
+    signal?: AbortSignal;
+};
+/**
+ * SSE event handlers
+ */
+export type SSEEventHandlers = {
+    onOpen?: () => void;
+    onClose?: () => void;
+    onError?: (error: Error) => void;
+    onEvent?: (event: ClientStreamEvent) => void;
+    onReconnect?: (attempt: number) => void;
+    onStateChange?: (state: SSEState) => void;
+};
+/**
+ * SSE connection options
+ */
+export type SSEConnectionOptions = {
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Request credentials */
+    credentials?: RequestCredentials;
+    /** Reconnect on disconnect */
+    autoReconnect?: boolean;
+    /** Reconnect delay in milliseconds */
+    reconnectDelay?: number;
+    /** Maximum reconnect attempts */
+    maxReconnectAttempts?: number;
+    /** Signal for request cancellation */
+    signal?: AbortSignal;
+};
+/**
+ * SSE connection state
+ */
+export type SSEConnectionState = "connecting" | "connected" | "disconnected" | "reconnecting" | "error";
+/**
+ * Streaming request options
+ */
+export type StreamingRequestOptions = {
+    /** Input text or data */
+    input: {
+        text: string;
+    } & UnknownRecord;
+    /** Provider to use */
+    provider?: string;
+    /** Model to use */
+    model?: string;
+    /** Temperature */
+    temperature?: number;
+    /** Maximum tokens */
+    maxTokens?: number;
+    /** System prompt */
+    systemPrompt?: string;
+    /** Enable tools */
+    enableTools?: boolean;
+    /** Context data */
+    context?: UnknownRecord;
+};
+/**
+ * Streaming event emitter interface
+ */
+export type StreamingEventEmitter = {
+    on(event: "text", callback: (text: string) => void): void;
+    on(event: "tool-call", callback: (toolCall: StreamToolCall) => void): void;
+    on(event: "tool-result", callback: (toolResult: StreamToolResult) => void): void;
+    on(event: "error", callback: (error: ClientApiError) => void): void;
+    on(event: "done", callback: (result: StreamResult) => void): void;
+    on(event: "metadata", callback: (metadata: JsonObject) => void): void;
+    off(event: string, callback: (...args: unknown[]) => void): void;
+    emit(event: string, ...args: unknown[]): void;
+};
+/**
+ * Streaming client configuration
+ */
+export type StreamingClientConfig = {
+    /** Base URL for the API */
+    baseUrl: string;
+    /** API key */
+    apiKey?: string;
+    /** Bearer token */
+    token?: string;
+    /** Default headers */
+    headers?: Record<string, string>;
+    /** Preferred transport: 'sse' or 'websocket' */
+    transport?: "sse" | "websocket";
+};
+/** @see WSClientState */
+export type ClientClientWebSocketState = WSClientState;
+/** @see WSClientConfig */
+export type ClientWebSocketConfig = WSClientConfig;
+/** @see WSClientMessage */
+export type ClientWebSocketMessage = WSClientMessage;
+/** @see WSClientEventHandlers */
+export type WebSocketEventHandlers = WSClientEventHandlers;