@hamsa-ai/voice-agents-sdk 0.5.5-beta.1 → 0.5.5

package/package.json

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

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

@@ -299,7 +299,8 @@ export declare class LiveKitToolRegistry extends EventEmitter {
      * wrapped with error handling and JSON serialization for secure, reliable
      * execution. Registration only occurs when both room and tools are available.
      *
-     * @fires toolsRegistered When tools are successfully registered with count
+     * @fires toolsRegistered When tools are successfully registered with the list of tools
+     * @fires rpcError When a tool execution fails
      *
      * @example
      * ```typescript
@@ -307,14 +308,14 @@ export declare class LiveKitToolRegistry extends EventEmitter {
      * registry.registerTools();
      *
      * // Listen for registration confirmation
-     * registry.on('toolsRegistered', (count) => {
-     *   console.log(`${count} tools registered successfully`);
+     * registry.on('toolsRegistered', (tools) => {
+     *   console.log(`${tools.length} tools registered successfully`);
      *
      *   // Notify agent about available tools
      *   sendAgentMessage({
      *     type: 'tools_ready',
-     *     count: count,
-     *     tools: registry.getTools().map(t => ({
+     *     count: tools.length,
+     *     tools: tools.map(t => ({
      *       name: t.function_name,
      *       description: t.description
      *     }))
@@ -326,7 +327,7 @@ export declare class LiveKitToolRegistry extends EventEmitter {
      * 1. Validates tool structure (function_name, fn)
      * 2. Creates RPC method wrapper with error handling
      * 3. Registers with LiveKit room's local participant
-     * 4. Emits toolsRegistered event with count
+     * 4. Emits toolsRegistered event with tools list
      * 5. Tools become immediately available for agent calls
      */
     registerTools(): void;

package/types/main.d.ts

@@ -3,6 +3,8 @@ import type { ConnectionState, LocalTrack, LocalTrackPublication, Participant, R
 import LiveKitManager, { type AgentState, type AudioLevelsResult, type CallAnalyticsResult, type ConnectionStatsResult, type ParticipantData, type PerformanceMetricsResult, type TrackStatsResult } from './classes/livekit-manager';
 import ScreenWakeLock from './classes/screen-wake-lock';
 import type { AudioCaptureCallback, AudioCaptureOptions, ConnectionQualityData, DTMFDigit, TrackSubscriptionData, TrackUnsubscriptionData } from './classes/types';
+export type { RpcInvocationData } from 'livekit-client';
+export { RpcError } from 'livekit-client';
 export type { AgentState } from './classes/livekit-manager';
 export type { AudioCaptureCallback, AudioCaptureFormat, AudioCaptureMetadata, AudioCaptureOptions, AudioCaptureSource, DTMFDigit, } from './classes/types';
 /**
@@ -105,6 +107,8 @@ type Tool = {
     required?: string[];
     /** Internal function mapping (used for tool execution) */
     func_map?: Record<string, unknown>;
+    /** The implementation function to execute when the agent calls this tool */
+    fn?: (...args: unknown[]) => unknown | Promise<unknown>;
 };
 /**
  * Definition of a parameter for a client-side tool
@@ -225,6 +229,10 @@ type HamsaVoiceAgentEvents = {
     customEvent: (eventType: string, eventData: unknown, metadata?: Record<string, unknown>) => void;
     /** Emitted for informational messages */
     info: (info: string) => void;
+    /** Emitted when tools are registered with the agent */
+    toolsRegistered: (tools: Tool[]) => void;
+    /** Emitted when a client-side tool execution fails */
+    rpcError: (functionName: string, error: unknown) => void;
 };
 /**
  * HamsaVoiceAgent - Main SDK class for voice agent integration