@azure/ai-voicelive 1.0.0-alpha.20251117.2

package/dist/browser/errors/connectionErrors.js

@@ -0,0 +1,136 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * Error codes for Voice Live WebSocket operations
+ */
+export var VoiceLiveErrorCodes;
+(function (VoiceLiveErrorCodes) {
+    // Connection errors
+    VoiceLiveErrorCodes["ConnectionFailed"] = "CONNECTION_FAILED";
+    VoiceLiveErrorCodes["ConnectionTimeout"] = "CONNECTION_TIMEOUT";
+    VoiceLiveErrorCodes["ConnectionLost"] = "CONNECTION_LOST";
+    VoiceLiveErrorCodes["AlreadyConnected"] = "ALREADY_CONNECTED";
+    VoiceLiveErrorCodes["NotConnected"] = "NOT_CONNECTED";
+    // WebSocket errors
+    VoiceLiveErrorCodes["WebSocketError"] = "WEBSOCKET_ERROR";
+    // Authentication errors
+    VoiceLiveErrorCodes["AuthenticationFailed"] = "AUTHENTICATION_FAILED";
+    VoiceLiveErrorCodes["InvalidCredentials"] = "INVALID_CREDENTIALS";
+    VoiceLiveErrorCodes["Unauthorized"] = "UNAUTHORIZED";
+    VoiceLiveErrorCodes["Forbidden"] = "FORBIDDEN";
+    // Protocol errors
+    VoiceLiveErrorCodes["InvalidMessage"] = "INVALID_MESSAGE";
+    VoiceLiveErrorCodes["MessageTooLarge"] = "MESSAGE_TOO_LARGE";
+    VoiceLiveErrorCodes["ProtocolError"] = "PROTOCOL_ERROR";
+    VoiceLiveErrorCodes["BufferOverflow"] = "BUFFER_OVERFLOW";
+    // General errors
+    VoiceLiveErrorCodes["OperationCancelled"] = "OPERATION_CANCELLED";
+    VoiceLiveErrorCodes["InvalidState"] = "INVALID_STATE";
+})(VoiceLiveErrorCodes || (VoiceLiveErrorCodes = {}));
+/**
+ * Base error class for Voice Live WebSocket operations
+ */
+export class VoiceLiveConnectionError extends Error {
+    /** Error code identifying the specific error type */
+    code;
+    /** Context information about where the error occurred */
+    context;
+    /** Indicates whether this error is potentially recoverable */
+    recoverable;
+    /** The original error that caused this error, if any */
+    cause;
+    /** Timestamp when the error occurred */
+    timestamp;
+    constructor(message, code, context = "websocket", recoverable = false, cause) {
+        super(message);
+        this.name = "VoiceLiveConnectionError";
+        this.code = code;
+        this.context = context;
+        this.recoverable = recoverable;
+        this.cause = cause;
+        this.timestamp = new Date();
+        // Ensure proper stack trace in V8
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, VoiceLiveConnectionError);
+        }
+        // Make properties enumerable for JSON.stringify (following Azure SDK pattern)
+        Object.defineProperty(this, "message", { enumerable: true });
+        Object.defineProperty(this, "name", { enumerable: true });
+        Object.defineProperty(this, "stack", { enumerable: true });
+    }
+}
+/**
+ * Authentication error class for Voice Live operations
+ */
+export class VoiceLiveAuthenticationError extends VoiceLiveConnectionError {
+    constructor(message, code, cause) {
+        super(message, code, "authentication", false, cause);
+        this.name = "VoiceLiveAuthenticationError";
+    }
+}
+/**
+ * Protocol error class for Voice Live message operations
+ */
+export class VoiceLiveProtocolError extends VoiceLiveConnectionError {
+    constructor(message, code, cause) {
+        super(message, code, "protocol", false, cause);
+        this.name = "VoiceLiveProtocolError";
+    }
+}
+/**
+ * General Voice Live error class
+ */
+export class VoiceLiveError extends VoiceLiveConnectionError {
+    constructor(message, code, context = "general", recoverable = false, cause) {
+        super(message, code, context, recoverable, cause);
+        this.name = "VoiceLiveError";
+    }
+}
+/**
+ * Classifies a WebSocket close event and returns appropriate error
+ */
+export function classifyWebSocketClose(code, reason) {
+    switch (code) {
+        case 1000: // Normal closure
+            return new VoiceLiveConnectionError("WebSocket connection closed normally", VoiceLiveErrorCodes.ConnectionLost, "websocket_close", false);
+        case 1001: // Going away
+        case 1006: // Abnormal closure
+            return new VoiceLiveConnectionError(`WebSocket connection lost: ${reason || "Abnormal closure"}`, VoiceLiveErrorCodes.ConnectionLost, "websocket_close", true);
+        case 1008: // Policy violation
+            return new VoiceLiveConnectionError(`WebSocket policy violation: ${reason}`, VoiceLiveErrorCodes.WebSocketError, "websocket_close", false);
+        case 1011: // Server error
+            return new VoiceLiveConnectionError(`WebSocket server error: ${reason}`, VoiceLiveErrorCodes.WebSocketError, "websocket_close", true);
+        default:
+            return new VoiceLiveConnectionError(`WebSocket closed with code ${code}: ${reason}`, VoiceLiveErrorCodes.ConnectionLost, "websocket_close", true);
+    }
+}
+/**
+ * Classifies connection errors
+ */
+export function classifyConnectionError(error) {
+    if (error instanceof VoiceLiveConnectionError) {
+        return error;
+    }
+    if (error instanceof Error) {
+        if (error.message.includes("timeout")) {
+            return new VoiceLiveConnectionError(`Connection timeout: ${error.message}`, VoiceLiveErrorCodes.ConnectionTimeout, "connection", true, error);
+        }
+        if (error.message.includes("ECONNREFUSED") || error.message.includes("ENOTFOUND")) {
+            return new VoiceLiveConnectionError(`Connection failed: ${error.message}`, VoiceLiveErrorCodes.ConnectionFailed, "connection", true, error);
+        }
+    }
+    return new VoiceLiveConnectionError(`Unknown connection error: ${error instanceof Error ? error.message : String(error)}`, VoiceLiveErrorCodes.ConnectionFailed, "connection", true, error instanceof Error ? error : new Error(String(error)));
+}
+/**
+ * Classifies protocol errors
+ */
+export function classifyProtocolError(error, messageType) {
+    if (error.message.includes("JSON")) {
+        return new VoiceLiveProtocolError(`Invalid JSON message: ${error.message}`, VoiceLiveErrorCodes.InvalidMessage, error);
+    }
+    if (error.message.includes("size") || error.message.includes("large")) {
+        return new VoiceLiveProtocolError(`Message too large: ${error.message}`, VoiceLiveErrorCodes.MessageTooLarge, error);
+    }
+    return new VoiceLiveProtocolError(`Protocol error in ${messageType}: ${error.message}`, VoiceLiveErrorCodes.ProtocolError, error);
+}
+//# sourceMappingURL=connectionErrors.js.map

package/dist/browser/errors/connectionErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionErrors.js","sourceRoot":"","sources":["../../../src/errors/connectionErrors.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\n/**\n * Error codes for Voice Live WebSocket operations\n */\nexport enum VoiceLiveErrorCodes {\n  // Connection errors\n  ConnectionFailed = \"CONNECTION_FAILED\",\n  ConnectionTimeout = \"CONNECTION_TIMEOUT\",\n  ConnectionLost = \"CONNECTION_LOST\",\n  AlreadyConnected = \"ALREADY_CONNECTED\",\n  NotConnected = \"NOT_CONNECTED\",\n\n  // WebSocket errors\n  WebSocketError = \"WEBSOCKET_ERROR\",\n\n  // Authentication errors\n  AuthenticationFailed = \"AUTHENTICATION_FAILED\",\n  InvalidCredentials = \"INVALID_CREDENTIALS\",\n  Unauthorized = \"UNAUTHORIZED\",\n  Forbidden = \"FORBIDDEN\",\n\n  // Protocol errors\n  InvalidMessage = \"INVALID_MESSAGE\",\n  MessageTooLarge = \"MESSAGE_TOO_LARGE\",\n  ProtocolError = \"PROTOCOL_ERROR\",\n  BufferOverflow = \"BUFFER_OVERFLOW\",\n\n  // General errors\n  OperationCancelled = \"OPERATION_CANCELLED\",\n  InvalidState = \"INVALID_STATE\",\n}\n\n/**\n * Base error class for Voice Live WebSocket operations\n */\nexport class VoiceLiveConnectionError extends Error {\n  /** Error code identifying the specific error type */\n  public readonly code: string;\n\n  /** Context information about where the error occurred */\n  public readonly context: string;\n\n  /** Indicates whether this error is potentially recoverable */\n  public readonly recoverable: boolean;\n\n  /** The original error that caused this error, if any */\n  public readonly cause?: Error;\n\n  /** Timestamp when the error occurred */\n  public readonly timestamp: Date;\n\n  constructor(\n    message: string,\n    code: string,\n    context: string = \"websocket\",\n    recoverable: boolean = false,\n    cause?: Error,\n  ) {\n    super(message);\n    this.name = \"VoiceLiveConnectionError\";\n    this.code = code;\n    this.context = context;\n    this.recoverable = recoverable;\n    this.cause = cause;\n    this.timestamp = new Date();\n\n    // Ensure proper stack trace in V8\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, VoiceLiveConnectionError);\n    }\n\n    // Make properties enumerable for JSON.stringify (following Azure SDK pattern)\n    Object.defineProperty(this, \"message\", { enumerable: true });\n    Object.defineProperty(this, \"name\", { enumerable: true });\n    Object.defineProperty(this, \"stack\", { enumerable: true });\n  }\n}\n\n/**\n * Authentication error class for Voice Live operations\n */\nexport class VoiceLiveAuthenticationError extends VoiceLiveConnectionError {\n  constructor(message: string, code: string, cause?: Error) {\n    super(message, code, \"authentication\", false, cause);\n    this.name = \"VoiceLiveAuthenticationError\";\n  }\n}\n\n/**\n * Protocol error class for Voice Live message operations\n */\nexport class VoiceLiveProtocolError extends VoiceLiveConnectionError {\n  constructor(message: string, code: string, cause?: Error) {\n    super(message, code, \"protocol\", false, cause);\n    this.name = \"VoiceLiveProtocolError\";\n  }\n}\n\n/**\n * General Voice Live error class\n */\nexport class VoiceLiveError extends VoiceLiveConnectionError {\n  constructor(\n    message: string,\n    code: string,\n    context: string = \"general\",\n    recoverable: boolean = false,\n    cause?: Error,\n  ) {\n    super(message, code, context, recoverable, cause);\n    this.name = \"VoiceLiveError\";\n  }\n}\n\n/**\n * Classifies a WebSocket close event and returns appropriate error\n */\nexport function classifyWebSocketClose(code: number, reason: string): VoiceLiveConnectionError {\n  switch (code) {\n    case 1000: // Normal closure\n      return new VoiceLiveConnectionError(\n        \"WebSocket connection closed normally\",\n        VoiceLiveErrorCodes.ConnectionLost,\n        \"websocket_close\",\n        false,\n      );\n\n    case 1001: // Going away\n    case 1006: // Abnormal closure\n      return new VoiceLiveConnectionError(\n        `WebSocket connection lost: ${reason || \"Abnormal closure\"}`,\n        VoiceLiveErrorCodes.ConnectionLost,\n        \"websocket_close\",\n        true, // Recoverable\n      );\n\n    case 1008: // Policy violation\n      return new VoiceLiveConnectionError(\n        `WebSocket policy violation: ${reason}`,\n        VoiceLiveErrorCodes.WebSocketError,\n        \"websocket_close\",\n        false, // Not recoverable\n      );\n\n    case 1011: // Server error\n      return new VoiceLiveConnectionError(\n        `WebSocket server error: ${reason}`,\n        VoiceLiveErrorCodes.WebSocketError,\n        \"websocket_close\",\n        true, // Recoverable\n      );\n\n    default:\n      return new VoiceLiveConnectionError(\n        `WebSocket closed with code ${code}: ${reason}`,\n        VoiceLiveErrorCodes.ConnectionLost,\n        \"websocket_close\",\n        true, // Default to recoverable\n      );\n  }\n}\n\n/**\n * Classifies connection errors\n */\nexport function classifyConnectionError(\n  error: VoiceLiveConnectionError | Error | unknown,\n): VoiceLiveConnectionError {\n  if (error instanceof VoiceLiveConnectionError) {\n    return error;\n  }\n\n  if (error instanceof Error) {\n    if (error.message.includes(\"timeout\")) {\n      return new VoiceLiveConnectionError(\n        `Connection timeout: ${error.message}`,\n        VoiceLiveErrorCodes.ConnectionTimeout,\n        \"connection\",\n        true,\n        error,\n      );\n    }\n\n    if (error.message.includes(\"ECONNREFUSED\") || error.message.includes(\"ENOTFOUND\")) {\n      return new VoiceLiveConnectionError(\n        `Connection failed: ${error.message}`,\n        VoiceLiveErrorCodes.ConnectionFailed,\n        \"connection\",\n        true,\n        error,\n      );\n    }\n  }\n\n  return new VoiceLiveConnectionError(\n    `Unknown connection error: ${error instanceof Error ? error.message : String(error)}`,\n    VoiceLiveErrorCodes.ConnectionFailed,\n    \"connection\",\n    true,\n    error instanceof Error ? error : new Error(String(error)),\n  );\n}\n\n/**\n * Classifies protocol errors\n */\nexport function classifyProtocolError(error: Error, messageType: string): VoiceLiveProtocolError {\n  if (error.message.includes(\"JSON\")) {\n    return new VoiceLiveProtocolError(\n      `Invalid JSON message: ${error.message}`,\n      VoiceLiveErrorCodes.InvalidMessage,\n      error,\n    );\n  }\n\n  if (error.message.includes(\"size\") || error.message.includes(\"large\")) {\n    return new VoiceLiveProtocolError(\n      `Message too large: ${error.message}`,\n      VoiceLiveErrorCodes.MessageTooLarge,\n      error,\n    );\n  }\n\n  return new VoiceLiveProtocolError(\n    `Protocol error in ${messageType}: ${error.message}`,\n    VoiceLiveErrorCodes.ProtocolError,\n    error,\n  );\n}\n"]}

package/dist/browser/errors/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./connectionErrors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/errors/index.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export * from "./connectionErrors.js";
+//# sourceMappingURL=index.js.map

package/dist/browser/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,cAAc,uBAAuB,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nexport * from \"./connectionErrors.js\";\n"]}

package/dist/browser/handlers/sessionHandlers.d.ts

@@ -0,0 +1,250 @@
+import type { ServerEventUnion, ServerEventError, ServerEventSessionCreated, ServerEventSessionUpdated, ServerEventSessionAvatarConnecting, ServerEventInputAudioBufferCommitted, ServerEventInputAudioBufferCleared, ServerEventInputAudioBufferSpeechStarted, ServerEventInputAudioBufferSpeechStopped, ServerEventConversationItemCreated, ServerEventConversationItemInputAudioTranscriptionCompleted, ServerEventConversationItemInputAudioTranscriptionFailed, ServerEventConversationItemInputAudioTranscriptionDelta, ServerEventConversationItemTruncated, ServerEventConversationItemDeleted, ServerEventConversationItemRetrieved, ServerEventResponseCreated, ServerEventResponseDone, ServerEventResponseOutputItemAdded, ServerEventResponseOutputItemDone, ServerEventResponseContentPartAdded, ServerEventResponseContentPartDone, ServerEventResponseTextDelta, ServerEventResponseTextDone, ServerEventResponseAudioDelta, ServerEventResponseAudioDone, ServerEventResponseAudioTranscriptDelta, ServerEventResponseAudioTranscriptDone, ServerEventResponseAnimationBlendshapeDelta, ServerEventResponseAnimationBlendshapeDone, ServerEventResponseAnimationVisemeDelta, ServerEventResponseAnimationVisemeDone, ServerEventResponseAudioTimestampDelta, ServerEventResponseAudioTimestampDone, ServerEventResponseFunctionCallArgumentsDelta, ServerEventResponseFunctionCallArgumentsDone } from "../models/index.js";
+/**
+ * Context information provided to connection-related handlers
+ */
+export interface ConnectionContext {
+    /** The session endpoint URL */
+    readonly endpoint: string;
+    /** The session ID (if available) */
+    readonly sessionId?: string;
+    /** When the event occurred */
+    readonly timestamp: Date;
+    /** The model being used for this session */
+    readonly model: string;
+}
+/**
+ * Context information provided to session-related handlers
+ */
+export interface SessionContext extends ConnectionContext {
+    /** The session ID (guaranteed to be available for session events) */
+    readonly sessionId: string;
+    /** The current conversation ID (if available) */
+    readonly conversationId?: string;
+}
+/**
+ * Arguments provided when a connection is established
+ */
+export interface ConnectedEventArgs {
+    /** Connection identifier */
+    connectionId: string;
+    /** When the connection was established */
+    timestamp: Date;
+}
+/**
+ * Arguments provided when a connection is lost
+ */
+export interface DisconnectedEventArgs {
+    /** WebSocket close code */
+    code: number;
+    /** Close reason */
+    reason: string;
+    /** Whether the close was clean */
+    wasClean: boolean;
+    /** When the disconnection occurred */
+    timestamp: Date;
+}
+/**
+ * Arguments provided when an error occurs
+ */
+export interface ErrorEventArgs {
+    /** The error that occurred */
+    error: Error;
+    /** Additional context about where the error occurred */
+    context: string;
+    /** Whether the error is recoverable (always false in fail-fast model) */
+    recoverable: boolean;
+    /** When the error occurred */
+    timestamp: Date;
+}
+/**
+ * Handler functions for VoiceLive session events following Azure SDK patterns.
+ *
+ * ALL handlers are optional - implement only the events you care about!
+ * Each handler receives strongly-typed event data and context information.
+ */
+export interface VoiceLiveSessionHandlers {
+    /**
+     * Called when the session connects successfully to the VoiceLive service
+     */
+    onConnected?: (args: ConnectedEventArgs, context: ConnectionContext) => Promise<void>;
+    /**
+     * Called when the session disconnects from the VoiceLive service
+     * In fail-fast mode, this indicates the session is permanently dead
+     */
+    onDisconnected?: (args: DisconnectedEventArgs, context: ConnectionContext) => Promise<void>;
+    /**
+     * Called when an error occurs that makes the session unusable
+     * In fail-fast mode, this indicates the session is permanently dead
+     */
+    onError?: (args: ErrorEventArgs, context: ConnectionContext) => Promise<void>;
+    /**
+     * Called when an error event is received from the server
+     */
+    onServerError?: (event: ServerEventError, context: SessionContext) => Promise<void>;
+    /**
+     * Called when the session is created on the server
+     */
+    onSessionCreated?: (event: ServerEventSessionCreated, context: SessionContext) => Promise<void>;
+    /**
+     * Called when the session configuration is updated
+     */
+    onSessionUpdated?: (event: ServerEventSessionUpdated, context: SessionContext) => Promise<void>;
+    /**
+     * Called when the server is establishing an avatar media connection
+     */
+    onSessionAvatarConnecting?: (event: ServerEventSessionAvatarConnecting, context: SessionContext) => Promise<void>;
+    /**
+     * Called when the input audio buffer is committed
+     */
+    onInputAudioBufferCommitted?: (event: ServerEventInputAudioBufferCommitted, context: SessionContext) => Promise<void>;
+    /**
+     * Called when the input audio buffer is cleared
+     */
+    onInputAudioBufferCleared?: (event: ServerEventInputAudioBufferCleared, context: SessionContext) => Promise<void>;
+    /**
+     * Called when speech is detected in the user's audio input
+     */
+    onInputAudioBufferSpeechStarted?: (event: ServerEventInputAudioBufferSpeechStarted, context: SessionContext) => Promise<void>;
+    /**
+     * Called when speech stops being detected in the user's audio input
+     */
+    onInputAudioBufferSpeechStopped?: (event: ServerEventInputAudioBufferSpeechStopped, context: SessionContext) => Promise<void>;
+    /**
+     * Called when a conversation item is created
+     */
+    onConversationItemCreated?: (event: ServerEventConversationItemCreated, context: SessionContext) => Promise<void>;
+    /**
+     * Called when input audio transcription is completed
+     */
+    onConversationItemInputAudioTranscriptionCompleted?: (event: ServerEventConversationItemInputAudioTranscriptionCompleted, context: SessionContext) => Promise<void>;
+    /**
+     * Called when input audio transcription fails
+     */
+    onConversationItemInputAudioTranscriptionFailed?: (event: ServerEventConversationItemInputAudioTranscriptionFailed, context: SessionContext) => Promise<void>;
+    /**
+     * Called when input audio transcription delta is received
+     */
+    onConversationItemInputAudioTranscriptionDelta?: (event: ServerEventConversationItemInputAudioTranscriptionDelta, context: SessionContext) => Promise<void>;
+    /**
+     * Called when a conversation item is truncated
+     */
+    onConversationItemTruncated?: (event: ServerEventConversationItemTruncated, context: SessionContext) => Promise<void>;
+    /**
+     * Called when a conversation item is deleted
+     */
+    onConversationItemDeleted?: (event: ServerEventConversationItemDeleted, context: SessionContext) => Promise<void>;
+    /**
+     * Called when a conversation item is retrieved
+     */
+    onConversationItemRetrieved?: (event: ServerEventConversationItemRetrieved, context: SessionContext) => Promise<void>;
+    /**
+     * Called when a response is created by the assistant
+     */
+    onResponseCreated?: (event: ServerEventResponseCreated, context: SessionContext) => Promise<void>;
+    /**
+     * Called when a response is completed by the assistant
+     */
+    onResponseDone?: (event: ServerEventResponseDone, context: SessionContext) => Promise<void>;
+    /**
+     * Called when a new output item is added to a response
+     */
+    onResponseOutputItemAdded?: (event: ServerEventResponseOutputItemAdded, context: SessionContext) => Promise<void>;
+    /**
+     * Called when an output item is completed
+     */
+    onResponseOutputItemDone?: (event: ServerEventResponseOutputItemDone, context: SessionContext) => Promise<void>;
+    /**
+     * Called when a new content part is added to a response
+     */
+    onResponseContentPartAdded?: (event: ServerEventResponseContentPartAdded, context: SessionContext) => Promise<void>;
+    /**
+     * Called when a content part is completed
+     */
+    onResponseContentPartDone?: (event: ServerEventResponseContentPartDone, context: SessionContext) => Promise<void>;
+    /**
+     * Called when text data is received from the assistant (streaming text response)
+     */
+    onResponseTextDelta?: (event: ServerEventResponseTextDelta, context: SessionContext) => Promise<void>;
+    /**
+     * Called when text response is completed
+     */
+    onResponseTextDone?: (event: ServerEventResponseTextDone, context: SessionContext) => Promise<void>;
+    /**
+     * Called when audio data is received from the assistant (streaming audio response)
+     */
+    onResponseAudioDelta?: (event: ServerEventResponseAudioDelta, context: SessionContext) => Promise<void>;
+    /**
+     * Called when audio response is completed
+     */
+    onResponseAudioDone?: (event: ServerEventResponseAudioDone, context: SessionContext) => Promise<void>;
+    /**
+     * Called when audio transcript data is received (what the assistant said as text)
+     */
+    onResponseAudioTranscriptDelta?: (event: ServerEventResponseAudioTranscriptDelta, context: SessionContext) => Promise<void>;
+    /**
+     * Called when audio transcript is completed
+     */
+    onResponseAudioTranscriptDone?: (event: ServerEventResponseAudioTranscriptDone, context: SessionContext) => Promise<void>;
+    /**
+     * Called when animation blendshape data is received
+     */
+    onResponseAnimationBlendshapeDelta?: (event: ServerEventResponseAnimationBlendshapeDelta, context: SessionContext) => Promise<void>;
+    /**
+     * Called when animation blendshape data is completed
+     */
+    onResponseAnimationBlendshapeDone?: (event: ServerEventResponseAnimationBlendshapeDone, context: SessionContext) => Promise<void>;
+    /**
+     * Called when animation viseme data is received
+     */
+    onResponseAnimationVisemeDelta?: (event: ServerEventResponseAnimationVisemeDelta, context: SessionContext) => Promise<void>;
+    /**
+     * Called when animation viseme data is completed
+     */
+    onResponseAnimationVisemeDone?: (event: ServerEventResponseAnimationVisemeDone, context: SessionContext) => Promise<void>;
+    /**
+     * Called when audio timestamp data is received
+     */
+    onResponseAudioTimestampDelta?: (event: ServerEventResponseAudioTimestampDelta, context: SessionContext) => Promise<void>;
+    /**
+     * Called when audio timestamp data is completed
+     */
+    onResponseAudioTimestampDone?: (event: ServerEventResponseAudioTimestampDone, context: SessionContext) => Promise<void>;
+    /**
+     * Called when function call arguments are received (streaming)
+     */
+    onResponseFunctionCallArgumentsDelta?: (event: ServerEventResponseFunctionCallArgumentsDelta, context: SessionContext) => Promise<void>;
+    /**
+     * Called when function call arguments are completed
+     */
+    onResponseFunctionCallArgumentsDone?: (event: ServerEventResponseFunctionCallArgumentsDone, context: SessionContext) => Promise<void>;
+    /**
+     * Called for all server events from the VoiceLive service.
+     * This is a catch-all handler that receives every server protocol message.
+     *
+     * Use this for:
+     * - Custom logging/monitoring of all events
+     * - Handling future events not yet covered by specific handlers
+     * - Debugging and development
+     *
+     * Note: This is called IN ADDITION TO any specific handlers above.
+     */
+    onServerEvent?: (event: ServerEventUnion, context: SessionContext) => Promise<void>;
+}
+/**
+ * Represents an active subscription to VoiceLive session events
+ */
+export interface VoiceLiveSubscription {
+    /**
+     * Stops the subscription and cleans up resources
+     */
+    close(): Promise<void>;
+    /**
+     * Whether the subscription is currently active
+     */
+    readonly isActive: boolean;
+    /**
+     * The subscription ID for tracking
+     */
+    readonly subscriptionId: string;
+}
+//# sourceMappingURL=sessionHandlers.d.ts.map

package/dist/browser/handlers/sessionHandlers.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export {};
+//# sourceMappingURL=sessionHandlers.js.map

package/dist/browser/handlers/sessionHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionHandlers.js","sourceRoot":"","sources":["../../../src/handlers/sessionHandlers.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type {\n  ServerEventUnion,\n  ServerEventError,\n  ServerEventSessionCreated,\n  ServerEventSessionUpdated,\n  ServerEventSessionAvatarConnecting,\n  ServerEventInputAudioBufferCommitted,\n  ServerEventInputAudioBufferCleared,\n  ServerEventInputAudioBufferSpeechStarted,\n  ServerEventInputAudioBufferSpeechStopped,\n  ServerEventConversationItemCreated,\n  ServerEventConversationItemInputAudioTranscriptionCompleted,\n  ServerEventConversationItemInputAudioTranscriptionFailed,\n  ServerEventConversationItemInputAudioTranscriptionDelta,\n  ServerEventConversationItemTruncated,\n  ServerEventConversationItemDeleted,\n  ServerEventConversationItemRetrieved,\n  ServerEventResponseCreated,\n  ServerEventResponseDone,\n  ServerEventResponseOutputItemAdded,\n  ServerEventResponseOutputItemDone,\n  ServerEventResponseContentPartAdded,\n  ServerEventResponseContentPartDone,\n  ServerEventResponseTextDelta,\n  ServerEventResponseTextDone,\n  ServerEventResponseAudioDelta,\n  ServerEventResponseAudioDone,\n  ServerEventResponseAudioTranscriptDelta,\n  ServerEventResponseAudioTranscriptDone,\n  ServerEventResponseAnimationBlendshapeDelta,\n  ServerEventResponseAnimationBlendshapeDone,\n  ServerEventResponseAnimationVisemeDelta,\n  ServerEventResponseAnimationVisemeDone,\n  ServerEventResponseAudioTimestampDelta,\n  ServerEventResponseAudioTimestampDone,\n  ServerEventResponseFunctionCallArgumentsDelta,\n  ServerEventResponseFunctionCallArgumentsDone,\n} from \"../models/index.js\";\n\n/**\n * Context information provided to connection-related handlers\n */\nexport interface ConnectionContext {\n  /** The session endpoint URL */\n  readonly endpoint: string;\n  /** The session ID (if available) */\n  readonly sessionId?: string;\n  /** When the event occurred */\n  readonly timestamp: Date;\n  /** The model being used for this session */\n  readonly model: string;\n}\n\n/**\n * Context information provided to session-related handlers\n */\nexport interface SessionContext extends ConnectionContext {\n  /** The session ID (guaranteed to be available for session events) */\n  readonly sessionId: string;\n  /** The current conversation ID (if available) */\n  readonly conversationId?: string;\n}\n\n/**\n * Arguments provided when a connection is established\n */\nexport interface ConnectedEventArgs {\n  /** Connection identifier */\n  connectionId: string;\n  /** When the connection was established */\n  timestamp: Date;\n}\n\n/**\n * Arguments provided when a connection is lost\n */\nexport interface DisconnectedEventArgs {\n  /** WebSocket close code */\n  code: number;\n  /** Close reason */\n  reason: string;\n  /** Whether the close was clean */\n  wasClean: boolean;\n  /** When the disconnection occurred */\n  timestamp: Date;\n}\n\n/**\n * Arguments provided when an error occurs\n */\nexport interface ErrorEventArgs {\n  /** The error that occurred */\n  error: Error;\n  /** Additional context about where the error occurred */\n  context: string;\n  /** Whether the error is recoverable (always false in fail-fast model) */\n  recoverable: boolean;\n  /** When the error occurred */\n  timestamp: Date;\n}\n\n/**\n * Handler functions for VoiceLive session events following Azure SDK patterns.\n *\n * ALL handlers are optional - implement only the events you care about!\n * Each handler receives strongly-typed event data and context information.\n */\nexport interface VoiceLiveSessionHandlers {\n  // ========================================\n  // CONNECTION LIFECYCLE EVENTS\n  // ========================================\n\n  /**\n   * Called when the session connects successfully to the VoiceLive service\n   */\n  onConnected?: (args: ConnectedEventArgs, context: ConnectionContext) => Promise<void>;\n\n  /**\n   * Called when the session disconnects from the VoiceLive service\n   * In fail-fast mode, this indicates the session is permanently dead\n   */\n  onDisconnected?: (args: DisconnectedEventArgs, context: ConnectionContext) => Promise<void>;\n\n  /**\n   * Called when an error occurs that makes the session unusable\n   * In fail-fast mode, this indicates the session is permanently dead\n   */\n  onError?: (args: ErrorEventArgs, context: ConnectionContext) => Promise<void>;\n\n  /**\n   * Called when an error event is received from the server\n   */\n  onServerError?: (event: ServerEventError, context: SessionContext) => Promise<void>;\n\n  /**\n   * Called when the session is created on the server\n   */\n  onSessionCreated?: (event: ServerEventSessionCreated, context: SessionContext) => Promise<void>;\n\n  /**\n   * Called when the session configuration is updated\n   */\n  onSessionUpdated?: (event: ServerEventSessionUpdated, context: SessionContext) => Promise<void>;\n\n  /**\n   * Called when the server is establishing an avatar media connection\n   */\n  onSessionAvatarConnecting?: (\n    event: ServerEventSessionAvatarConnecting,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  // ========================================\n  // INPUT AUDIO BUFFER EVENTS\n  // ========================================\n\n  /**\n   * Called when the input audio buffer is committed\n   */\n  onInputAudioBufferCommitted?: (\n    event: ServerEventInputAudioBufferCommitted,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when the input audio buffer is cleared\n   */\n  onInputAudioBufferCleared?: (\n    event: ServerEventInputAudioBufferCleared,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when speech is detected in the user's audio input\n   */\n  onInputAudioBufferSpeechStarted?: (\n    event: ServerEventInputAudioBufferSpeechStarted,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when speech stops being detected in the user's audio input\n   */\n  onInputAudioBufferSpeechStopped?: (\n    event: ServerEventInputAudioBufferSpeechStopped,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  // ========================================\n  // CONVERSATION ITEM EVENTS\n  // ========================================\n\n  /**\n   * Called when a conversation item is created\n   */\n  onConversationItemCreated?: (\n    event: ServerEventConversationItemCreated,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when input audio transcription is completed\n   */\n  onConversationItemInputAudioTranscriptionCompleted?: (\n    event: ServerEventConversationItemInputAudioTranscriptionCompleted,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when input audio transcription fails\n   */\n  onConversationItemInputAudioTranscriptionFailed?: (\n    event: ServerEventConversationItemInputAudioTranscriptionFailed,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when input audio transcription delta is received\n   */\n  onConversationItemInputAudioTranscriptionDelta?: (\n    event: ServerEventConversationItemInputAudioTranscriptionDelta,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when a conversation item is truncated\n   */\n  onConversationItemTruncated?: (\n    event: ServerEventConversationItemTruncated,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when a conversation item is deleted\n   */\n  onConversationItemDeleted?: (\n    event: ServerEventConversationItemDeleted,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when a conversation item is retrieved\n   */\n  onConversationItemRetrieved?: (\n    event: ServerEventConversationItemRetrieved,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  // ========================================\n  // RESPONSE LIFECYCLE EVENTS\n  // ========================================\n\n  /**\n   * Called when a response is created by the assistant\n   */\n  onResponseCreated?: (event: ServerEventResponseCreated, context: SessionContext) => Promise<void>;\n\n  /**\n   * Called when a response is completed by the assistant\n   */\n  onResponseDone?: (event: ServerEventResponseDone, context: SessionContext) => Promise<void>;\n\n  /**\n   * Called when a new output item is added to a response\n   */\n  onResponseOutputItemAdded?: (\n    event: ServerEventResponseOutputItemAdded,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when an output item is completed\n   */\n  onResponseOutputItemDone?: (\n    event: ServerEventResponseOutputItemDone,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when a new content part is added to a response\n   */\n  onResponseContentPartAdded?: (\n    event: ServerEventResponseContentPartAdded,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when a content part is completed\n   */\n  onResponseContentPartDone?: (\n    event: ServerEventResponseContentPartDone,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  // ========================================\n  // RESPONSE TEXT EVENTS\n  // ========================================\n\n  /**\n   * Called when text data is received from the assistant (streaming text response)\n   */\n  onResponseTextDelta?: (\n    event: ServerEventResponseTextDelta,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when text response is completed\n   */\n  onResponseTextDone?: (\n    event: ServerEventResponseTextDone,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  // ========================================\n  // RESPONSE AUDIO EVENTS\n  // ========================================\n\n  /**\n   * Called when audio data is received from the assistant (streaming audio response)\n   */\n  onResponseAudioDelta?: (\n    event: ServerEventResponseAudioDelta,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when audio response is completed\n   */\n  onResponseAudioDone?: (\n    event: ServerEventResponseAudioDone,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when audio transcript data is received (what the assistant said as text)\n   */\n  onResponseAudioTranscriptDelta?: (\n    event: ServerEventResponseAudioTranscriptDelta,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when audio transcript is completed\n   */\n  onResponseAudioTranscriptDone?: (\n    event: ServerEventResponseAudioTranscriptDone,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  // ========================================\n  // RESPONSE ANIMATION EVENTS\n  // ========================================\n\n  /**\n   * Called when animation blendshape data is received\n   */\n  onResponseAnimationBlendshapeDelta?: (\n    event: ServerEventResponseAnimationBlendshapeDelta,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when animation blendshape data is completed\n   */\n  onResponseAnimationBlendshapeDone?: (\n    event: ServerEventResponseAnimationBlendshapeDone,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when animation viseme data is received\n   */\n  onResponseAnimationVisemeDelta?: (\n    event: ServerEventResponseAnimationVisemeDelta,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when animation viseme data is completed\n   */\n  onResponseAnimationVisemeDone?: (\n    event: ServerEventResponseAnimationVisemeDone,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  // ========================================\n  // RESPONSE TIMING EVENTS\n  // ========================================\n\n  /**\n   * Called when audio timestamp data is received\n   */\n  onResponseAudioTimestampDelta?: (\n    event: ServerEventResponseAudioTimestampDelta,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when audio timestamp data is completed\n   */\n  onResponseAudioTimestampDone?: (\n    event: ServerEventResponseAudioTimestampDone,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  // ========================================\n  // FUNCTION CALL EVENTS\n  // ========================================\n\n  /**\n   * Called when function call arguments are received (streaming)\n   */\n  onResponseFunctionCallArgumentsDelta?: (\n    event: ServerEventResponseFunctionCallArgumentsDelta,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  /**\n   * Called when function call arguments are completed\n   */\n  onResponseFunctionCallArgumentsDone?: (\n    event: ServerEventResponseFunctionCallArgumentsDone,\n    context: SessionContext,\n  ) => Promise<void>;\n\n  // ========================================\n  // CATCH-ALL HANDLER (OPTIONAL)\n  // ========================================\n\n  /**\n   * Called for all server events from the VoiceLive service.\n   * This is a catch-all handler that receives every server protocol message.\n   *\n   * Use this for:\n   * - Custom logging/monitoring of all events\n   * - Handling future events not yet covered by specific handlers\n   * - Debugging and development\n   *\n   * Note: This is called IN ADDITION TO any specific handlers above.\n   */\n  onServerEvent?: (event: ServerEventUnion, context: SessionContext) => Promise<void>;\n}\n\n/**\n * Represents an active subscription to VoiceLive session events\n */\nexport interface VoiceLiveSubscription {\n  /**\n   * Stops the subscription and cleans up resources\n   */\n  close(): Promise<void>;\n\n  /**\n   * Whether the subscription is currently active\n   */\n  readonly isActive: boolean;\n\n  /**\n   * The subscription ID for tracking\n   */\n  readonly subscriptionId: string;\n}\n"]}

package/dist/browser/handlers/subscriptionManager.d.ts

@@ -0,0 +1,54 @@
+import type { VoiceLiveSessionHandlers, VoiceLiveSubscription, ConnectionContext, SessionContext, ConnectedEventArgs, DisconnectedEventArgs, ErrorEventArgs } from "./sessionHandlers.js";
+import type { ServerEventUnion } from "../models/index.js";
+/**
+ * Internal implementation of VoiceLiveSubscription
+ */
+export declare class VoiceLiveSubscriptionImpl implements VoiceLiveSubscription {
+    private _isActive;
+    private _handlers;
+    private _subscriptionId;
+    constructor(handlers: VoiceLiveSessionHandlers, subscriptionId: string);
+    get isActive(): boolean;
+    get subscriptionId(): string;
+    close(): Promise<void>;
+    /**
+     * Process a connection event
+     */
+    processConnectionEvent(eventType: "connected" | "disconnected" | "error", args: ConnectedEventArgs | DisconnectedEventArgs | ErrorEventArgs, context: ConnectionContext): Promise<void>;
+    /**
+     * Process a server event
+     */
+    processServerEvent(event: ServerEventUnion, context: SessionContext): Promise<void>;
+}
+/**
+ * Manages multiple subscriptions for a VoiceLive session
+ */
+export declare class SubscriptionManager {
+    private _subscriptions;
+    private _nextSubscriptionId;
+    /**
+     * Create a new subscription
+     */
+    createSubscription(handlers: VoiceLiveSessionHandlers): VoiceLiveSubscription;
+    /**
+     * Remove a subscription
+     */
+    removeSubscription(subscriptionId: string): void;
+    /**
+     * Process a connection event for all active subscriptions
+     */
+    processConnectionEvent(eventType: "connected" | "disconnected" | "error", args: ConnectedEventArgs | DisconnectedEventArgs | ErrorEventArgs, context: ConnectionContext): Promise<void>;
+    /**
+     * Process a server event for all active subscriptions
+     */
+    processServerEvent(event: ServerEventUnion, context: SessionContext): Promise<void>;
+    /**
+     * Close all subscriptions
+     */
+    closeAll(): Promise<void>;
+    /**
+     * Get count of active subscriptions
+     */
+    get activeCount(): number;
+}
+//# sourceMappingURL=subscriptionManager.d.ts.map