@tanstack/ai-client 0.18.3 → 0.18.4

package/dist/esm/realtime-types.d.ts

@@ -1,45 +1,5 @@
-import { AnyClientTool, AudioVisualization, RealtimeEvent, RealtimeEventHandler, RealtimeMessage, RealtimeMode, RealtimeSessionConfig, RealtimeStatus, RealtimeToken } from '@tanstack/ai/client';
-/**
- * Adapter interface for connecting to realtime providers.
- * Each provider (OpenAI, ElevenLabs, etc.) implements this interface.
- */
-export interface RealtimeAdapter {
-    /** Provider identifier */
-    provider: string;
-    /**
-     * Create a connection using the provided token
-     * @param token - The ephemeral token from the server
-     * @param clientTools - Optional client-side tools to register with the provider
-     * @returns A connection instance
-     */
-    connect: (token: RealtimeToken, clientTools?: ReadonlyArray<AnyClientTool>) => Promise<RealtimeConnection>;
-}
-/**
- * Connection interface representing an active realtime session.
- * Handles audio I/O, events, and session management.
- */
-export interface RealtimeConnection {
-    /** Disconnect from the realtime session */
-    disconnect: () => Promise<void>;
-    /** Start capturing audio from the microphone */
-    startAudioCapture: () => Promise<void>;
-    /** Stop capturing audio */
-    stopAudioCapture: () => void;
-    /** Send a text message (fallback for when voice isn't available) */
-    sendText: (text: string) => void;
-    /** Send an image to the conversation */
-    sendImage: (imageData: string, mimeType: string) => void;
-    /** Send a tool execution result back to the provider */
-    sendToolResult: (callId: string, result: string) => void;
-    /** Update session configuration */
-    updateSession: (config: Partial<RealtimeSessionConfig>) => void;
-    /** Interrupt the current response */
-    interrupt: () => void;
-    /** Subscribe to connection events */
-    on: <TEvent extends RealtimeEvent>(event: TEvent, handler: RealtimeEventHandler<TEvent>) => () => void;
-    /** Get audio visualization data */
-    getAudioVisualization: () => AudioVisualization;
-}
+import { AnyClientTool, RealtimeAdapter, RealtimeMessage, RealtimeMode, RealtimeStatus, RealtimeToken } from '@tanstack/ai/client';
+export type { RealtimeAdapter, RealtimeConnection } from '@tanstack/ai/client';
 /**
  * Options for the RealtimeClient
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-client",
-  "version": "0.18.3",
+  "version": "0.18.4",
   "description": "Framework-agnostic headless client for TanStack AI chat, realtime sessions, streaming transports, and media generations.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -49,7 +49,7 @@
     "src"
   ],
   "dependencies": {
-    "@tanstack/ai": "0.34.1",
+    "@tanstack/ai": "0.35.0",
     "@tanstack/ai-event-client": "0.6.6"
   },
   "devDependencies": {

package/src/realtime-types.ts

@@ -1,83 +1,17 @@
 import type {
   AnyClientTool,
-  AudioVisualization,
-  RealtimeEvent,
-  RealtimeEventHandler,
+  RealtimeAdapter,
   RealtimeMessage,
   RealtimeMode,
-  RealtimeSessionConfig,
   RealtimeStatus,
   RealtimeToken,
 } from '@tanstack/ai/client'
 
-// ============================================================================
-// Adapter Interface
-// ============================================================================
-
-/**
- * Adapter interface for connecting to realtime providers.
- * Each provider (OpenAI, ElevenLabs, etc.) implements this interface.
- */
-export interface RealtimeAdapter {
-  /** Provider identifier */
-  provider: string
-
-  /**
-   * Create a connection using the provided token
-   * @param token - The ephemeral token from the server
-   * @param clientTools - Optional client-side tools to register with the provider
-   * @returns A connection instance
-   */
-  connect: (
-    token: RealtimeToken,
-    clientTools?: ReadonlyArray<AnyClientTool>,
-  ) => Promise<RealtimeConnection>
-}
-
-/**
- * Connection interface representing an active realtime session.
- * Handles audio I/O, events, and session management.
- */
-export interface RealtimeConnection {
-  // Lifecycle
-  /** Disconnect from the realtime session */
-  disconnect: () => Promise<void>
-
-  // Audio I/O
-  /** Start capturing audio from the microphone */
-  startAudioCapture: () => Promise<void>
-  /** Stop capturing audio */
-  stopAudioCapture: () => void
-
-  // Text input
-  /** Send a text message (fallback for when voice isn't available) */
-  sendText: (text: string) => void
-
-  // Image input
-  /** Send an image to the conversation */
-  sendImage: (imageData: string, mimeType: string) => void
-
-  // Tool results
-  /** Send a tool execution result back to the provider */
-  sendToolResult: (callId: string, result: string) => void
-
-  // Session management
-  /** Update session configuration */
-  updateSession: (config: Partial<RealtimeSessionConfig>) => void
-  /** Interrupt the current response */
-  interrupt: () => void
-
-  // Events
-  /** Subscribe to connection events */
-  on: <TEvent extends RealtimeEvent>(
-    event: TEvent,
-    handler: RealtimeEventHandler<TEvent>,
-  ) => () => void
-
-  // Audio visualization
-  /** Get audio visualization data */
-  getAudioVisualization: () => AudioVisualization
-}
+// The realtime adapter contract lives in `@tanstack/ai` (the shared layer both
+// providers and this client depend on) so provider packages don't need to
+// depend on `@tanstack/ai-client`. Re-exported here for backwards compatibility
+// — `import { RealtimeAdapter } from '@tanstack/ai-client'` keeps working.
+export type { RealtimeAdapter, RealtimeConnection } from '@tanstack/ai/client'
 
 // ============================================================================
 // Client Options