@hamsa-ai/voice-agents-sdk 0.6.0-beta.0 → 0.6.0-beta.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hamsa-ai/voice-agents-sdk",
-  "version": "0.6.0-beta.0",
+  "version": "0.6.0-beta.2",
   "description": "Hamsa AI - Voice Agents JavaScript SDK",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",

package/types/classes/livekit-connection.d.ts

@@ -190,6 +190,8 @@ export declare class LiveKitConnection extends EventEmitter {
     private hasEmittedConnected;
     /** Debug logger instance for conditional logging */
     private readonly logger;
+    /** When true, the session is text/chat-only and the microphone is never enabled */
+    private readonly isChatOnly;
     /**
      * Creates a new LiveKitConnection instance
      *
@@ -200,6 +202,7 @@ export declare class LiveKitConnection extends EventEmitter {
      * @param lkUrl - LiveKit WebSocket URL (e.g., 'wss://livekit.example.com')
      * @param accessToken - JWT token for room authentication and authorization
      * @param debug - Enable debug logging (defaults to false)
+     * @param isChatOnly - When true, the microphone is never enabled (text/chat-only session)
      *
      * @example
      * ```typescript
@@ -213,7 +216,7 @@ export declare class LiveKitConnection extends EventEmitter {
      * await connection.connect();
      * ```
      */
-    constructor(lkUrl: string, accessToken: string, debug?: boolean);
+    constructor(lkUrl: string, accessToken: string, debug?: boolean, isChatOnly?: boolean);
     /**
      * Provides access to the underlying LiveKit room instance
      *

package/types/classes/livekit-manager.d.ts

@@ -90,9 +90,10 @@ export default class LiveKitManager extends EventEmitter {
      * );
      * ```
      */
-    constructor(lkUrl: string, accessToken: string, tools?: Tool[], { debug, avatarContainerSelector, }?: {
+    constructor(lkUrl: string, accessToken: string, tools?: Tool[], { debug, avatarContainerSelector, isChatOnly, }?: {
         debug?: boolean;
         avatarContainerSelector?: string;
+        isChatOnly?: boolean;
     });
     /**
      * Establishes connection to the LiveKit room and initializes voice agent communication

package/types/classes/livekit-tool-registry.d.ts

@@ -180,6 +180,15 @@
 import { EventEmitter } from 'events';
 import type { Room } from 'livekit-client';
 import type { Tool } from './types';
+/**
+ * LiveKit text-stream topic used for chat messages.
+ *
+ * Both directions use this topic: the SDK publishes user messages here via
+ * `sendText`, and the agent publishes its replies here as text streams. The
+ * registry registers a handler on this topic to surface inbound agent messages
+ * as `messageReceived` events.
+ */
+export declare const LIVEKIT_CHAT_TOPIC = "lk.chat";
 /**
  * LiveKitToolRegistry class for client-side tool management and RPC handling
  *
@@ -201,6 +210,8 @@ export declare class LiveKitToolRegistry extends EventEmitter {
     private readonly logger;
     /** Monotonic counter for synthesizing message ids when a segment lacks one */
     private fallbackMessageIdCounter;
+    /** Whether the chat text-stream handler is currently registered on the room */
+    private chatStreamRegistered;
     /**
      * Creates a new LiveKitToolRegistry instance
      *
@@ -256,6 +267,20 @@ export declare class LiveKitToolRegistry extends EventEmitter {
      * ```
      */
     setRoom(room: Room | null): void;
+    /**
+     * Registers a text-stream handler on {@link LIVEKIT_CHAT_TOPIC} to receive the
+     * agent's chat replies.
+     *
+     * The agent publishes its responses as LiveKit text streams on this topic.
+     * Each stream's chunks are concatenated and emitted via `messageReceived`,
+     * streaming partials (`isFinal: false`) followed by a final message
+     * (`isFinal: true`). The stream id is reused as the message id so a chat UI
+     * can update the same bubble in place.
+     *
+     * Guarded so it registers at most once per room — `registerTextStreamHandler`
+     * throws if a handler already exists for the topic.
+     */
+    private registerChatStreamHandler;
     /**
      * Updates the available tools and re-registers them with the room
      *