@azure/ai-projects 2.6.0 → 2.7.0

package/dist/commonjs/realtime/voiceAgentRealtimeClient.js

@@ -0,0 +1,443 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var voiceAgentRealtimeClient_exports = {};
+__export(voiceAgentRealtimeClient_exports, {
+  KnownVoiceAgentConnectionState: () => KnownVoiceAgentConnectionState,
+  VoiceAgentRealtimeClient: () => VoiceAgentRealtimeClient
+});
+module.exports = __toCommonJS(voiceAgentRealtimeClient_exports);
+var import_core_util = require("@azure/core-util");
+var import_constants = require("../constants.js");
+var import_logger = require("../logger.js");
+var import_asyncQueue = require("./asyncQueue.js");
+var import_errors = require("./errors.js");
+var import_protocol = require("./protocol.js");
+const defaultCredentialScope = "https://ai.azure.com/.default";
+const voiceAgentsPreview = "VoiceAgents=V1Preview";
+const KnownVoiceAgentConnectionState = {
+  Disconnected: "disconnected",
+  Connecting: "connecting",
+  Connected: "connected",
+  Closing: "closing"
+};
+class VoiceAgentRealtimeClient {
+  endpoint;
+  credential;
+  options;
+  constructor(endpoint, credential, options = {}) {
+    if (!endpoint.trim()) {
+      throw new TypeError("endpoint must not be empty.");
+    }
+    this.endpoint = endpoint;
+    this.credential = credential;
+    this.options = {
+      ...options,
+      connectionTimeoutInMs: options.connectionTimeoutInMs ?? 3e4,
+      apiVersion: options.apiVersion ?? "v1"
+    };
+  }
+  /** Establishes a WebSocket connection to a managed voice agent. */
+  async connect(agentName, options = {}) {
+    if (!agentName.trim()) {
+      throw new TypeError("agentName must not be empty.");
+    }
+    const factory = this.options.webSocketFactory ?? (await import("../webSocketTransport.js")).createDefaultVoiceAgentWebSocketFactory();
+    const connection = new VoiceAgentConnectionImpl(
+      normalizeEndpoint(this.endpoint),
+      agentName,
+      this.credential,
+      this.options,
+      options,
+      factory
+    );
+    await connection.open();
+    return connection;
+  }
+}
+class VoiceAgentConnectionImpl {
+  constructor(endpoint, agentName, credential, clientOptions, connectOptions, factory) {
+    this.endpoint = endpoint;
+    this.agentName = agentName;
+    this.credential = credential;
+    this.clientOptions = clientOptions;
+    this.connectOptions = connectOptions;
+    this.events = new import_asyncQueue.AsyncQueue(1e4, {
+      onOverflow: (error) => this.handleEventQueueOverflow(error)
+    });
+    this.transport = factory.create();
+    this.closePromise = new Promise((resolve) => {
+      this.resolveClose = resolve;
+    });
+    this.transport.setHandlers({
+      onMessage: (data) => this.handleMessage(data),
+      onClose: (code, reason, wasClean) => this.handleClose(code, reason, wasClean),
+      onError: (error) => this.handleTransportError(error)
+    });
+  }
+  endpoint;
+  agentName;
+  credential;
+  clientOptions;
+  connectOptions;
+  events;
+  transport;
+  closePromise;
+  resolveClose;
+  currentState = KnownVoiceAgentConnectionState.Disconnected;
+  iteratorStarted = false;
+  finished = false;
+  get state() {
+    return this.currentState;
+  }
+  get closed() {
+    return this.closePromise;
+  }
+  async open() {
+    this.setState(KnownVoiceAgentConnectionState.Connecting);
+    let token;
+    try {
+      const accessToken = await this.credential.getToken(
+        this.clientOptions.credentialScopes ?? defaultCredentialScope,
+        { abortSignal: this.connectOptions.abortSignal }
+      );
+      if (!accessToken) {
+        throw new import_errors.VoiceAgentAuthenticationError("The credential returned no access token.");
+      }
+      token = accessToken.token;
+    } catch (error) {
+      if (this.connectOptions.abortSignal?.aborted) {
+        const cancelledError = new import_errors.VoiceAgentConnectionError(
+          "Voice-agent connection was cancelled.",
+          "operationCancelled",
+          { cause: error }
+        );
+        this.finish(1006, cancelledError.message, false, cancelledError);
+        throw cancelledError;
+      }
+      const authenticationError = error instanceof import_errors.VoiceAgentAuthenticationError ? error : new import_errors.VoiceAgentAuthenticationError("Failed to acquire a Voice Agents access token.", {
+        cause: error
+      });
+      this.finish(1006, authenticationError.message, false, authenticationError);
+      throw authenticationError;
+    }
+    try {
+      await this.transport.connect({
+        url: buildWebSocketUrl(
+          this.endpoint,
+          this.agentName,
+          this.clientOptions.apiVersion,
+          this.connectOptions
+        ),
+        protocols: ["realtime"],
+        headers: buildHeaders(token, this.clientOptions, this.connectOptions),
+        connectionTimeoutInMs: this.connectOptions.connectionTimeoutInMs ?? this.clientOptions.connectionTimeoutInMs,
+        abortSignal: this.connectOptions.abortSignal
+      });
+      this.setState(KnownVoiceAgentConnectionState.Connected);
+      import_logger.logger.info("Connected to voice agent", { agentName: this.agentName });
+    } catch (error) {
+      const cancelled = this.connectOptions.abortSignal?.aborted === true;
+      const connectionError = new import_errors.VoiceAgentConnectionError(
+        cancelled ? "Voice-agent connection was cancelled." : "Failed to connect to the voice agent.",
+        cancelled ? "operationCancelled" : "connectionFailed",
+        { cause: error }
+      );
+      this.finish(1006, connectionError.message, false, connectionError);
+      throw connectionError;
+    }
+  }
+  async sendEvent(event, options = {}) {
+    if (this.state !== KnownVoiceAgentConnectionState.Connected) {
+      throw new import_errors.VoiceAgentConnectionError(
+        `Cannot send while the connection is ${this.state}.`,
+        "invalidState"
+      );
+    }
+    if (options.abortSignal?.aborted) {
+      throw new import_errors.VoiceAgentConnectionError("Send operation was cancelled.", "operationCancelled");
+    }
+    try {
+      await this.transport.send((0, import_protocol.serializeVoiceAgentClientEvent)(event), options.abortSignal);
+    } catch (error) {
+      if (error instanceof import_errors.VoiceAgentProtocolError) {
+        throw error;
+      }
+      throw new import_errors.VoiceAgentConnectionError("Failed to send a voice-agent event.", "sendFailed", {
+        cause: error
+      });
+    }
+  }
+  configureSession(session, options = {}) {
+    return this.sendEvent({ type: "session.update", event_id: options.eventId, session }, options);
+  }
+  async sendText(text, options = {}) {
+    await this.sendEvent(
+      {
+        type: "conversation.item.create",
+        event_id: options.eventId,
+        previous_item_id: options.previousItemId,
+        // `RealtimeConversationItemUnion` no longer enumerates a "message" item in the generated
+        // models, but the wire protocol still accepts this shape; see the TypeSpec regeneration
+        // report for details.
+        item: {
+          type: "message",
+          role: "user",
+          content: [{ type: "input_text", text }]
+        }
+      },
+      options
+    );
+    if (options.createResponse !== false) {
+      await this.requestResponse({ abortSignal: options.abortSignal });
+    }
+  }
+  sendAudio(audio, options = {}) {
+    const bytes = audio instanceof Uint8Array ? audio : new Uint8Array(audio);
+    return this.sendEvent(
+      {
+        type: "input_audio_buffer.append",
+        event_id: options.eventId,
+        audio: (0, import_core_util.uint8ArrayToString)(bytes, "base64")
+      },
+      options
+    );
+  }
+  commitAudio(options = {}) {
+    return this.sendEvent(
+      { type: "input_audio_buffer.commit", event_id: options.eventId },
+      options
+    );
+  }
+  clearInputAudio(options = {}) {
+    return this.sendEvent({ type: "input_audio_buffer.clear", event_id: options.eventId }, options);
+  }
+  clearOutputAudio(options = {}) {
+    return this.sendEvent(
+      { type: "output_audio_buffer.clear", event_id: options.eventId },
+      options
+    );
+  }
+  async sendToolOutput(callId, output, options = {}) {
+    await this.sendEvent(
+      {
+        type: "conversation.item.create",
+        event_id: options.eventId,
+        item: { type: "function_call_output", call_id: callId, output }
+      },
+      options
+    );
+    if (options.createResponse !== false) {
+      await this.requestResponse({ abortSignal: options.abortSignal });
+    }
+  }
+  requestResponse(options = {}) {
+    return this.sendEvent(
+      { type: "response.create", event_id: options.eventId, response: options.response },
+      options
+    );
+  }
+  cancelResponse(options = {}) {
+    return this.sendEvent(
+      { type: "response.cancel", event_id: options.eventId, response_id: options.responseId },
+      options
+    );
+  }
+  async close(code = 1e3, reason = "Client closed the voice-agent connection.") {
+    if (this.state === KnownVoiceAgentConnectionState.Disconnected || this.state === KnownVoiceAgentConnectionState.Closing) {
+      await this.closed;
+      return;
+    }
+    this.setState(KnownVoiceAgentConnectionState.Closing);
+    try {
+      await this.transport.close(code, reason);
+    } finally {
+      this.finish(code, reason, false);
+    }
+  }
+  dispose() {
+    return this.close();
+  }
+  async *[Symbol.asyncIterator]() {
+    if (this.iteratorStarted) {
+      throw new import_errors.VoiceAgentConnectionError(
+        "A voice-agent connection supports one active event iterator.",
+        "invalidState"
+      );
+    }
+    this.iteratorStarted = true;
+    try {
+      while (true) {
+        const result = await this.events.next();
+        if (result.done) {
+          return;
+        }
+        yield result.value;
+      }
+    } finally {
+      if (this.state === KnownVoiceAgentConnectionState.Connected) {
+        await this.close();
+      }
+    }
+  }
+  handleMessage(data) {
+    try {
+      this.events.enqueue((0, import_protocol.deserializeVoiceAgentServerEvent)(data));
+    } catch (error) {
+      const protocolError = error instanceof import_errors.VoiceAgentProtocolError ? error : new import_errors.VoiceAgentProtocolError("Failed to process a voice-agent event.", { cause: error });
+      this.finish(1002, protocolError.message, false, protocolError);
+    }
+  }
+  handleEventQueueOverflow(cause) {
+    if (this.finished) {
+      return;
+    }
+    const error = new import_errors.VoiceAgentConnectionError(cause.message, "connectionClosed", {
+      cause
+    });
+    this.finish(1006, error.message, false, error);
+  }
+  handleClose(code, reason, wasClean) {
+    if (this.finished) {
+      return;
+    }
+    if (wasClean || this.state === KnownVoiceAgentConnectionState.Closing) {
+      this.finish(code, reason, wasClean);
+    } else {
+      const error = new import_errors.VoiceAgentConnectionError(
+        `Voice-agent connection closed unexpectedly (${code}${reason ? `: ${reason}` : ""}).`,
+        "connectionClosed",
+        { closeCode: code }
+      );
+      this.finish(code, reason, false, error);
+    }
+  }
+  handleTransportError(cause) {
+    if (this.finished) {
+      return;
+    }
+    const error = new import_errors.VoiceAgentConnectionError(
+      "Voice-agent WebSocket transport failed.",
+      "connectionClosed",
+      {
+        cause
+      }
+    );
+    this.finish(1006, cause.message, false, error);
+  }
+  finish(code, reason, wasClean, error) {
+    if (this.finished) {
+      return;
+    }
+    this.finished = true;
+    if (error) {
+      this.events.fail(error);
+    } else {
+      this.events.close();
+    }
+    this.setState(KnownVoiceAgentConnectionState.Disconnected);
+    this.resolveClose({ code, reason, wasClean, error });
+    import_logger.logger.info("Voice-agent connection closed", { code, reason, wasClean });
+    void this.closeTransportQuietly(code, reason);
+  }
+  /**
+   * Closes the transport, logging rather than rejecting: this is best-effort cleanup running after
+   * the connection has already settled. A no-op if the transport is already closed.
+   */
+  async closeTransportQuietly(code, reason) {
+    try {
+      await this.transport.close(code, reason);
+    } catch (error) {
+      import_logger.logger.warning("Failed to close the voice-agent transport", { error });
+    }
+  }
+  setState(state) {
+    if (state === this.currentState) {
+      return;
+    }
+    const previousState = this.currentState;
+    this.currentState = state;
+    try {
+      this.connectOptions.onConnectionStateChange?.(state, previousState);
+    } catch (error) {
+      import_logger.logger.warning("onConnectionStateChange callback threw an error", { error });
+    }
+  }
+}
+function normalizeEndpoint(endpoint) {
+  const normalized = endpoint.trim();
+  if (!normalized) {
+    throw new TypeError("endpoint must not be empty.");
+  }
+  const url = new URL(normalized.includes("://") ? normalized : `https://${normalized}`);
+  if (url.protocol !== "https:") {
+    throw new TypeError(
+      "endpoint must use https; a plaintext endpoint would send the bearer token over an unencrypted connection."
+    );
+  }
+  return url.toString().replace(/\/$/, "");
+}
+function buildWebSocketUrl(endpoint, agentName, apiVersion, options) {
+  const url = new URL(endpoint);
+  url.protocol = "wss:";
+  url.pathname = `${url.pathname.replace(/\/$/, "")}/agents/${encodeURIComponent(agentName)}/endpoint/protocols/voice`;
+  url.searchParams.set("api-version", apiVersion);
+  url.searchParams.set("x-ms-client-sdk", `azsdk-js-ai-projects/${import_constants.SDK_VERSION}`);
+  if (options.agentSessionId) {
+    url.searchParams.set("agent_session_id", options.agentSessionId);
+  }
+  if (options.store !== void 0) {
+    url.searchParams.set("store", String(options.store));
+  }
+  if (options.agentVersionOverride) {
+    url.searchParams.set("x-agent-version-override", options.agentVersionOverride);
+  }
+  return url.toString();
+}
+function buildHeaders(token, clientOptions, connectOptions) {
+  const sdkUserAgent = `azsdk-js-ai-projects/${import_constants.SDK_VERSION}`;
+  const headers = {
+    authorization: `Bearer ${token}`,
+    "foundry-features": voiceAgentsPreview,
+    "x-ms-client-request-id": createRequestId(),
+    "x-ms-client-sdk": sdkUserAgent,
+    "user-agent": clientOptions.userAgentPrefix ? `${clientOptions.userAgentPrefix} ${sdkUserAgent}` : sdkUserAgent
+  };
+  if (connectOptions.structuredInputs) {
+    headers["x-ms-voice-structured-inputs"] = JSON.stringify(connectOptions.structuredInputs);
+  }
+  return headers;
+}
+function createRequestId() {
+  return globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  KnownVoiceAgentConnectionState,
+  VoiceAgentRealtimeClient
+});
+//# sourceMappingURL=voiceAgentRealtimeClient.js.map

package/dist/commonjs/realtime/voiceAgentRealtimeClient.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/realtime/voiceAgentRealtimeClient.ts"],
+  "sourcesContent": ["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport type { TokenCredential } from \"@azure/core-auth\";\nimport type { OperationOptions } from \"@azure-rest/core-client\";\nimport { uint8ArrayToString } from \"@azure/core-util\";\nimport { SDK_VERSION } from \"../constants.js\";\nimport type {\n  RealtimeConversationItemUnion,\n  VoiceAgentClientEvent,\n  VoiceAgentResponseCreateParams,\n  VoiceAgentSessionUpdateConfig,\n} from \"../models/models.js\";\nimport { logger } from \"../logger.js\";\nimport { AsyncQueue } from \"./asyncQueue.js\";\nimport {\n  VoiceAgentAuthenticationError,\n  VoiceAgentConnectionError,\n  VoiceAgentProtocolError,\n} from \"./errors.js\";\nimport { deserializeVoiceAgentServerEvent, serializeVoiceAgentClientEvent } from \"./protocol.js\";\nimport type { VoiceAgentRealtimeEvent } from \"./events.js\";\nimport type {\n  VoiceAgentWebSocketFactory,\n  VoiceAgentWebSocketTransport,\n} from \"./webSocketTransportLike.js\";\n\nconst defaultCredentialScope = \"https://ai.azure.com/.default\";\nconst voiceAgentsPreview = \"VoiceAgents=V1Preview\";\n\n/** Known values of {@link VoiceAgentConnectionState} reported by a voice-agent realtime connection. */\nexport const KnownVoiceAgentConnectionState = {\n  Disconnected: \"disconnected\",\n  Connecting: \"connecting\",\n  Connected: \"connected\",\n  Closing: \"closing\",\n} as const;\n\n/** Connection states reported by a voice-agent realtime connection. */\nexport type VoiceAgentConnectionState =\n  (typeof KnownVoiceAgentConnectionState)[keyof typeof KnownVoiceAgentConnectionState];\n\n/** Called when a voice-agent connection changes state. */\nexport type VoiceAgentConnectionStateChangedHandler = (\n  state: VoiceAgentConnectionState,\n  previousState: VoiceAgentConnectionState,\n) => void;\n\n/** Options for the Voice Agents realtime client. */\nexport interface VoiceAgentRealtimeClientOptions {\n  /** Microsoft Entra scopes used to acquire a WebSocket access token. */\n  credentialScopes?: string | string[];\n  /** Default connection timeout in milliseconds. */\n  connectionTimeoutInMs?: number;\n  /** API version sent during the WebSocket upgrade. */\n  apiVersion?: string;\n  /** Prefix added to the SDK user-agent value in Node.js. */\n  userAgentPrefix?: string;\n  /**\n   * Overrides the transport used to establish the realtime WebSocket connection. Defaults to the\n   * platform transport (`ws` in Node.js, the browser's native `WebSocket` in browsers/React Native).\n   * Provide a custom factory to customize connection establishment.\n   */\n  webSocketFactory?: VoiceAgentWebSocketFactory;\n}\n\n/** Options for connecting the realtime client to a voice agent. */\nexport interface VoiceAgentRealtimeClientConnectOptions extends OperationOptions {\n  /** Identifier used to correlate the voice session. */\n  agentSessionId?: string;\n  /** Overrides whether the conversation created by this session is persisted. */\n  store?: boolean;\n  /** Selects a specific immutable agent version. */\n  agentVersionOverride?: string;\n  /** Values used to render the agent's structured prompt inputs. */\n  structuredInputs?: Record<string, unknown>;\n  /** Overrides the client connection timeout in milliseconds. */\n  connectionTimeoutInMs?: number;\n  /** Cancels the connection attempt. */\n  abortSignal?: AbortSignalLike;\n  /** Receives connection-state transitions. */\n  onConnectionStateChange?: VoiceAgentConnectionStateChangedHandler;\n}\n\n/** Result supplied when a voice-agent connection closes. */\nexport interface VoiceAgentCloseResult {\n  /** WebSocket close code. */\n  code: number;\n  /** WebSocket close reason. */\n  reason: string;\n  /** Whether the peer completed a normal WebSocket close handshake. */\n  wasClean: boolean;\n  /** Transport or protocol error associated with the close, if any. */\n  error?: Error;\n}\n\n/** Options shared by realtime send operations. */\nexport interface VoiceAgentSendOptions extends OperationOptions {}\n\n/** Options shared by operations that build a protocol event on the caller's behalf. */\nexport interface VoiceAgentEventOptions extends VoiceAgentSendOptions {\n  /** Client-generated event identifier. */\n  eventId?: string;\n}\n\n/** Options shared by operations that add a conversation item and, by default, request a response. */\nexport interface VoiceAgentSendItemOptions extends VoiceAgentEventOptions {\n  /** Whether to request a response after adding the item. Defaults to true. */\n  createResponse?: boolean;\n}\n\n/** Options for sending text input. */\nexport interface VoiceAgentSendTextOptions extends VoiceAgentSendItemOptions {\n  /** Item after which the new text item is inserted. */\n  previousItemId?: string;\n}\n\n/** Options for returning a function result. */\nexport interface VoiceAgentSendToolOutputOptions extends VoiceAgentSendItemOptions {}\n\n/** Options for updating the live session. */\nexport interface VoiceAgentSessionUpdateOptions extends VoiceAgentEventOptions {}\n\n/** Options for creating a response. */\nexport interface VoiceAgentResponseOptions extends VoiceAgentEventOptions {\n  /** Response-specific configuration. */\n  response?: VoiceAgentResponseCreateParams;\n}\n\n/** Options for cancelling a response. */\nexport interface VoiceAgentCancelResponseOptions extends VoiceAgentEventOptions {\n  /** Specific response to cancel. The active default-conversation response is used when omitted. */\n  responseId?: string;\n}\n\n/**\n * A connected, bidirectional voice-agent stream.\n *\n * Supports exactly one `for await` iteration over server events; a second attempt throws.\n * Exiting the loop early (`break`, `return`, or an uncaught error in the loop body) closes\n * the connection as a side effect.\n * Unrecognized server event types are delivered as {@link VoiceAgentUnknownEvent} without\n * interrupting the stream. Malformed events still fail the iteration with a protocol error.\n */\nexport interface VoiceAgentConnection extends AsyncIterable<VoiceAgentRealtimeEvent> {\n  /** Current connection state. */\n  readonly state: VoiceAgentConnectionState;\n  /** Resolves once the connection is closed. */\n  readonly closed: Promise<VoiceAgentCloseResult>;\n  /** Sends any generated client protocol event. */\n  sendEvent(event: VoiceAgentClientEvent, options?: VoiceAgentSendOptions): Promise<void>;\n  /** Updates supported live-session settings. */\n  configureSession(\n    session: VoiceAgentSessionUpdateConfig,\n    options?: VoiceAgentSessionUpdateOptions,\n  ): Promise<void>;\n  /** Adds a user text item and, by default, requests a response. */\n  sendText(text: string, options?: VoiceAgentSendTextOptions): Promise<void>;\n  /** Appends base64-encoded audio bytes to the input buffer. */\n  sendAudio(audio: Uint8Array | ArrayBuffer, options?: VoiceAgentEventOptions): Promise<void>;\n  /** Commits buffered input audio. */\n  commitAudio(options?: VoiceAgentEventOptions): Promise<void>;\n  /** Clears buffered input audio. */\n  clearInputAudio(options?: VoiceAgentEventOptions): Promise<void>;\n  /** Clears pending output audio at the service. */\n  clearOutputAudio(options?: VoiceAgentEventOptions): Promise<void>;\n  /** Returns a client-executed function result to the agent. */\n  sendToolOutput(\n    callId: string,\n    output: string,\n    options?: VoiceAgentSendToolOutputOptions,\n  ): Promise<void>;\n  /** Requests a new response. */\n  requestResponse(options?: VoiceAgentResponseOptions): Promise<void>;\n  /** Cancels an in-progress response. */\n  cancelResponse(options?: VoiceAgentCancelResponseOptions): Promise<void>;\n  /** Gracefully closes the WebSocket connection. */\n  close(code?: number, reason?: string): Promise<void>;\n  /** Releases the connection. Equivalent to close(). */\n  dispose(): Promise<void>;\n}\n\n/** Client for establishing realtime sessions with managed Foundry voice agents. */\nexport class VoiceAgentRealtimeClient {\n  private readonly endpoint: string;\n  private readonly credential: TokenCredential;\n  private readonly options: Required<\n    Pick<VoiceAgentRealtimeClientOptions, \"connectionTimeoutInMs\" | \"apiVersion\">\n  > &\n    VoiceAgentRealtimeClientOptions;\n\n  public constructor(\n    endpoint: string,\n    credential: TokenCredential,\n    options: VoiceAgentRealtimeClientOptions = {},\n  ) {\n    // Endpoint validation (https-only) is deferred to connect() so that merely constructing an\n    // AIProjectClient (which eagerly creates this client) doesn't reject callers who intentionally\n    // use an insecure local endpoint for the REST surface and never touch realtime connections.\n    if (!endpoint.trim()) {\n      throw new TypeError(\"endpoint must not be empty.\");\n    }\n    this.endpoint = endpoint;\n    this.credential = credential;\n    this.options = {\n      ...options,\n      connectionTimeoutInMs: options.connectionTimeoutInMs ?? 30_000,\n      apiVersion: options.apiVersion ?? \"v1\",\n    };\n  }\n\n  /** Establishes a WebSocket connection to a managed voice agent. */\n  public async connect(\n    agentName: string,\n    options: VoiceAgentRealtimeClientConnectOptions = {},\n  ): Promise<VoiceAgentConnection> {\n    if (!agentName.trim()) {\n      throw new TypeError(\"agentName must not be empty.\");\n    }\n    const factory =\n      this.options.webSocketFactory ??\n      (await import(\"#platform/webSocketTransport\")).createDefaultVoiceAgentWebSocketFactory();\n    const connection = new VoiceAgentConnectionImpl(\n      normalizeEndpoint(this.endpoint),\n      agentName,\n      this.credential,\n      this.options,\n      options,\n      factory,\n    );\n    await connection.open();\n    return connection;\n  }\n}\n\nclass VoiceAgentConnectionImpl implements VoiceAgentConnection {\n  private readonly events: AsyncQueue<VoiceAgentRealtimeEvent>;\n  private readonly transport: VoiceAgentWebSocketTransport;\n  private readonly closePromise: Promise<VoiceAgentCloseResult>;\n  private resolveClose!: (result: VoiceAgentCloseResult) => void;\n  private currentState: VoiceAgentConnectionState = KnownVoiceAgentConnectionState.Disconnected;\n  private iteratorStarted = false;\n  private finished = false;\n\n  public constructor(\n    private readonly endpoint: string,\n    private readonly agentName: string,\n    private readonly credential: TokenCredential,\n    private readonly clientOptions: VoiceAgentRealtimeClientOptions & {\n      connectionTimeoutInMs: number;\n      apiVersion: string;\n    },\n    private readonly connectOptions: VoiceAgentRealtimeClientConnectOptions,\n    factory: VoiceAgentWebSocketFactory,\n  ) {\n    this.events = new AsyncQueue<VoiceAgentRealtimeEvent>(10_000, {\n      onOverflow: (error) => this.handleEventQueueOverflow(error),\n    });\n    this.transport = factory.create();\n    this.closePromise = new Promise<VoiceAgentCloseResult>((resolve) => {\n      this.resolveClose = resolve;\n    });\n    this.transport.setHandlers({\n      onMessage: (data) => this.handleMessage(data),\n      onClose: (code, reason, wasClean) => this.handleClose(code, reason, wasClean),\n      onError: (error) => this.handleTransportError(error),\n    });\n  }\n\n  public get state(): VoiceAgentConnectionState {\n    return this.currentState;\n  }\n\n  public get closed(): Promise<VoiceAgentCloseResult> {\n    return this.closePromise;\n  }\n\n  public async open(): Promise<void> {\n    this.setState(KnownVoiceAgentConnectionState.Connecting);\n    let token: string;\n    try {\n      const accessToken = await this.credential.getToken(\n        this.clientOptions.credentialScopes ?? defaultCredentialScope,\n        { abortSignal: this.connectOptions.abortSignal },\n      );\n      if (!accessToken) {\n        throw new VoiceAgentAuthenticationError(\"The credential returned no access token.\");\n      }\n      token = accessToken.token;\n    } catch (error) {\n      if (this.connectOptions.abortSignal?.aborted) {\n        const cancelledError = new VoiceAgentConnectionError(\n          \"Voice-agent connection was cancelled.\",\n          \"operationCancelled\",\n          { cause: error },\n        );\n        this.finish(1006, cancelledError.message, false, cancelledError);\n        throw cancelledError;\n      }\n      const authenticationError =\n        error instanceof VoiceAgentAuthenticationError\n          ? error\n          : new VoiceAgentAuthenticationError(\"Failed to acquire a Voice Agents access token.\", {\n              cause: error,\n            });\n      this.finish(1006, authenticationError.message, false, authenticationError);\n      throw authenticationError;\n    }\n\n    try {\n      await this.transport.connect({\n        url: buildWebSocketUrl(\n          this.endpoint,\n          this.agentName,\n          this.clientOptions.apiVersion,\n          this.connectOptions,\n        ),\n        protocols: [\"realtime\"],\n        headers: buildHeaders(token, this.clientOptions, this.connectOptions),\n        connectionTimeoutInMs:\n          this.connectOptions.connectionTimeoutInMs ?? this.clientOptions.connectionTimeoutInMs,\n        abortSignal: this.connectOptions.abortSignal,\n      });\n      this.setState(KnownVoiceAgentConnectionState.Connected);\n      logger.info(\"Connected to voice agent\", { agentName: this.agentName });\n    } catch (error) {\n      const cancelled = this.connectOptions.abortSignal?.aborted === true;\n      const connectionError = new VoiceAgentConnectionError(\n        cancelled\n          ? \"Voice-agent connection was cancelled.\"\n          : \"Failed to connect to the voice agent.\",\n        cancelled ? \"operationCancelled\" : \"connectionFailed\",\n        { cause: error },\n      );\n      this.finish(1006, connectionError.message, false, connectionError);\n      throw connectionError;\n    }\n  }\n\n  public async sendEvent(\n    event: VoiceAgentClientEvent,\n    options: VoiceAgentSendOptions = {},\n  ): Promise<void> {\n    if (this.state !== KnownVoiceAgentConnectionState.Connected) {\n      throw new VoiceAgentConnectionError(\n        `Cannot send while the connection is ${this.state}.`,\n        \"invalidState\",\n      );\n    }\n    if (options.abortSignal?.aborted) {\n      throw new VoiceAgentConnectionError(\"Send operation was cancelled.\", \"operationCancelled\");\n    }\n\n    try {\n      await this.transport.send(serializeVoiceAgentClientEvent(event), options.abortSignal);\n    } catch (error) {\n      if (error instanceof VoiceAgentProtocolError) {\n        throw error;\n      }\n      throw new VoiceAgentConnectionError(\"Failed to send a voice-agent event.\", \"sendFailed\", {\n        cause: error,\n      });\n    }\n  }\n\n  public configureSession(\n    session: VoiceAgentSessionUpdateConfig,\n    options: VoiceAgentSessionUpdateOptions = {},\n  ): Promise<void> {\n    return this.sendEvent({ type: \"session.update\", event_id: options.eventId, session }, options);\n  }\n\n  public async sendText(text: string, options: VoiceAgentSendTextOptions = {}): Promise<void> {\n    await this.sendEvent(\n      {\n        type: \"conversation.item.create\",\n        event_id: options.eventId,\n        previous_item_id: options.previousItemId,\n        // `RealtimeConversationItemUnion` no longer enumerates a \"message\" item in the generated\n        // models, but the wire protocol still accepts this shape; see the TypeSpec regeneration\n        // report for details.\n        item: {\n          type: \"message\",\n          role: \"user\",\n          content: [{ type: \"input_text\", text }],\n        } as unknown as RealtimeConversationItemUnion,\n      },\n      options,\n    );\n    if (options.createResponse !== false) {\n      await this.requestResponse({ abortSignal: options.abortSignal });\n    }\n  }\n\n  public sendAudio(\n    audio: Uint8Array | ArrayBuffer,\n    options: VoiceAgentEventOptions = {},\n  ): Promise<void> {\n    const bytes = audio instanceof Uint8Array ? audio : new Uint8Array(audio);\n    return this.sendEvent(\n      {\n        type: \"input_audio_buffer.append\",\n        event_id: options.eventId,\n        audio: uint8ArrayToString(bytes, \"base64\"),\n      },\n      options,\n    );\n  }\n\n  public commitAudio(options: VoiceAgentEventOptions = {}): Promise<void> {\n    return this.sendEvent(\n      { type: \"input_audio_buffer.commit\", event_id: options.eventId },\n      options,\n    );\n  }\n\n  public clearInputAudio(options: VoiceAgentEventOptions = {}): Promise<void> {\n    return this.sendEvent({ type: \"input_audio_buffer.clear\", event_id: options.eventId }, options);\n  }\n\n  public clearOutputAudio(options: VoiceAgentEventOptions = {}): Promise<void> {\n    return this.sendEvent(\n      { type: \"output_audio_buffer.clear\", event_id: options.eventId },\n      options,\n    );\n  }\n\n  public async sendToolOutput(\n    callId: string,\n    output: string,\n    options: VoiceAgentSendToolOutputOptions = {},\n  ): Promise<void> {\n    await this.sendEvent(\n      {\n        type: \"conversation.item.create\",\n        event_id: options.eventId,\n        item: { type: \"function_call_output\", call_id: callId, output },\n      },\n      options,\n    );\n    if (options.createResponse !== false) {\n      await this.requestResponse({ abortSignal: options.abortSignal });\n    }\n  }\n\n  public requestResponse(options: VoiceAgentResponseOptions = {}): Promise<void> {\n    return this.sendEvent(\n      { type: \"response.create\", event_id: options.eventId, response: options.response },\n      options,\n    );\n  }\n\n  public cancelResponse(options: VoiceAgentCancelResponseOptions = {}): Promise<void> {\n    return this.sendEvent(\n      { type: \"response.cancel\", event_id: options.eventId, response_id: options.responseId },\n      options,\n    );\n  }\n\n  public async close(\n    code = 1000,\n    reason = \"Client closed the voice-agent connection.\",\n  ): Promise<void> {\n    if (\n      this.state === KnownVoiceAgentConnectionState.Disconnected ||\n      this.state === KnownVoiceAgentConnectionState.Closing\n    ) {\n      await this.closed;\n      return;\n    }\n    this.setState(KnownVoiceAgentConnectionState.Closing);\n    try {\n      await this.transport.close(code, reason);\n    } finally {\n      this.finish(code, reason, false);\n    }\n  }\n\n  public dispose(): Promise<void> {\n    return this.close();\n  }\n\n  public async *[Symbol.asyncIterator](): AsyncIterator<VoiceAgentRealtimeEvent> {\n    if (this.iteratorStarted) {\n      throw new VoiceAgentConnectionError(\n        \"A voice-agent connection supports one active event iterator.\",\n        \"invalidState\",\n      );\n    }\n    this.iteratorStarted = true;\n    try {\n      while (true) {\n        const result = await this.events.next();\n        if (result.done) {\n          return;\n        }\n        yield result.value;\n      }\n    } finally {\n      if (this.state === KnownVoiceAgentConnectionState.Connected) {\n        await this.close();\n      }\n    }\n  }\n\n  private handleMessage(data: string | ArrayBuffer): void {\n    try {\n      this.events.enqueue(deserializeVoiceAgentServerEvent(data));\n    } catch (error) {\n      const protocolError =\n        error instanceof VoiceAgentProtocolError\n          ? error\n          : new VoiceAgentProtocolError(\"Failed to process a voice-agent event.\", { cause: error });\n      // finish() closes the transport itself, so no additional close is needed here.\n      this.finish(1002, protocolError.message, false, protocolError);\n    }\n  }\n\n  private handleEventQueueOverflow(cause: Error): void {\n    if (this.finished) {\n      return;\n    }\n    const error = new VoiceAgentConnectionError(cause.message, \"connectionClosed\", {\n      cause,\n    });\n    this.finish(1006, error.message, false, error);\n  }\n\n  private handleClose(code: number, reason: string, wasClean: boolean): void {\n    if (this.finished) {\n      return;\n    }\n    if (wasClean || this.state === KnownVoiceAgentConnectionState.Closing) {\n      this.finish(code, reason, wasClean);\n    } else {\n      const error = new VoiceAgentConnectionError(\n        `Voice-agent connection closed unexpectedly (${code}${reason ? `: ${reason}` : \"\"}).`,\n        \"connectionClosed\",\n        { closeCode: code },\n      );\n      this.finish(code, reason, false, error);\n    }\n  }\n\n  private handleTransportError(cause: Error): void {\n    if (this.finished) {\n      return;\n    }\n    const error = new VoiceAgentConnectionError(\n      \"Voice-agent WebSocket transport failed.\",\n      \"connectionClosed\",\n      {\n        cause,\n      },\n    );\n    this.finish(1006, cause.message, false, error);\n  }\n\n  private finish(code: number, reason: string, wasClean: boolean, error?: Error): void {\n    if (this.finished) {\n      return;\n    }\n    this.finished = true;\n    if (error) {\n      this.events.fail(error);\n    } else {\n      this.events.close();\n    }\n    this.setState(KnownVoiceAgentConnectionState.Disconnected);\n    this.resolveClose({ code, reason, wasClean, error });\n    logger.info(\"Voice-agent connection closed\", { code, reason, wasClean });\n    // Ensure the socket never outlives the connection, even on paths that never closed it\n    // themselves. Not awaited: finish() is synchronous because its callers are.\n    void this.closeTransportQuietly(code, reason);\n  }\n\n  /**\n   * Closes the transport, logging rather than rejecting: this is best-effort cleanup running after\n   * the connection has already settled. A no-op if the transport is already closed.\n   */\n  private async closeTransportQuietly(code: number, reason: string): Promise<void> {\n    try {\n      await this.transport.close(code, reason);\n    } catch (error) {\n      logger.warning(\"Failed to close the voice-agent transport\", { error });\n    }\n  }\n\n  private setState(state: VoiceAgentConnectionState): void {\n    if (state === this.currentState) {\n      return;\n    }\n    const previousState = this.currentState;\n    this.currentState = state;\n    try {\n      this.connectOptions.onConnectionStateChange?.(state, previousState);\n    } catch (error) {\n      // A throwing caller callback must never interrupt connection lifecycle/cleanup.\n      logger.warning(\"onConnectionStateChange callback threw an error\", { error });\n    }\n  }\n}\n\nfunction normalizeEndpoint(endpoint: string): string {\n  const normalized = endpoint.trim();\n  if (!normalized) {\n    throw new TypeError(\"endpoint must not be empty.\");\n  }\n  const url = new URL(normalized.includes(\"://\") ? normalized : `https://${normalized}`);\n  if (url.protocol !== \"https:\") {\n    throw new TypeError(\n      \"endpoint must use https; a plaintext endpoint would send the bearer token over an unencrypted connection.\",\n    );\n  }\n  return url.toString().replace(/\\/$/, \"\");\n}\n\nfunction buildWebSocketUrl(\n  endpoint: string,\n  agentName: string,\n  apiVersion: string,\n  options: VoiceAgentRealtimeClientConnectOptions,\n): string {\n  const url = new URL(endpoint);\n  url.protocol = \"wss:\";\n  url.pathname = `${url.pathname.replace(/\\/$/, \"\")}/agents/${encodeURIComponent(agentName)}/endpoint/protocols/voice`;\n  url.searchParams.set(\"api-version\", apiVersion);\n  url.searchParams.set(\"x-ms-client-sdk\", `azsdk-js-ai-projects/${SDK_VERSION}`);\n  if (options.agentSessionId) {\n    url.searchParams.set(\"agent_session_id\", options.agentSessionId);\n  }\n  if (options.store !== undefined) {\n    url.searchParams.set(\"store\", String(options.store));\n  }\n  if (options.agentVersionOverride) {\n    url.searchParams.set(\"x-agent-version-override\", options.agentVersionOverride);\n  }\n  return url.toString();\n}\n\nfunction buildHeaders(\n  token: string,\n  clientOptions: VoiceAgentRealtimeClientOptions,\n  connectOptions: VoiceAgentRealtimeClientConnectOptions,\n): Record<string, string> {\n  const sdkUserAgent = `azsdk-js-ai-projects/${SDK_VERSION}`;\n  const headers: Record<string, string> = {\n    authorization: `Bearer ${token}`,\n    \"foundry-features\": voiceAgentsPreview,\n    \"x-ms-client-request-id\": createRequestId(),\n    \"x-ms-client-sdk\": sdkUserAgent,\n    \"user-agent\": clientOptions.userAgentPrefix\n      ? `${clientOptions.userAgentPrefix} ${sdkUserAgent}`\n      : sdkUserAgent,\n  };\n  if (connectOptions.structuredInputs) {\n    headers[\"x-ms-voice-structured-inputs\"] = JSON.stringify(connectOptions.structuredInputs);\n  }\n  return headers;\n}\n\nfunction createRequestId(): string {\n  return (\n    globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/commonjs/realtime/webSocketTransportLike.d.ts

@@ -0,0 +1,44 @@
+import type { AbortSignalLike } from "@azure/abort-controller";
+/** Callbacks invoked by a {@link VoiceAgentWebSocketTransport} as connection events occur. */
+export interface VoiceAgentWebSocketHandlers {
+    /** Invoked when a message is received from the service. */
+    onMessage: (data: string | ArrayBuffer) => void;
+    /** Invoked when the connection closes. */
+    onClose: (code: number, reason: string, wasClean: boolean) => void;
+    /** Invoked when the transport encounters an error. */
+    onError: (error: Error) => void;
+}
+/** Options passed to {@link VoiceAgentWebSocketTransport.connect}. */
+export interface VoiceAgentWebSocketConnectOptions {
+    /** The WebSocket URL to connect to. */
+    url: string;
+    /** The WebSocket subprotocols to negotiate. */
+    protocols: string[];
+    /** Headers to send with the connection upgrade request, where supported by the transport. */
+    headers: Record<string, string>;
+    /** Connection timeout, in milliseconds. */
+    connectionTimeoutInMs: number;
+    /** Cancels the connection attempt. */
+    abortSignal?: AbortSignalLike;
+}
+/**
+ * A pluggable WebSocket transport used by {@link VoiceAgentRealtimeClient}. Implement this
+ * interface to customize how the realtime connection is established, for example to route it
+ * through an authenticated relay.
+ */
+export interface VoiceAgentWebSocketTransport {
+    /** Registers the handlers invoked as connection events occur. */
+    setHandlers(handlers: VoiceAgentWebSocketHandlers): void;
+    /** Establishes the WebSocket connection. */
+    connect(options: VoiceAgentWebSocketConnectOptions): Promise<void>;
+    /** Sends a message over the connection. */
+    send(data: string, abortSignal?: AbortSignalLike): Promise<void>;
+    /** Closes the connection. */
+    close(code: number, reason: string): Promise<void>;
+}
+/** Creates {@link VoiceAgentWebSocketTransport} instances for {@link VoiceAgentRealtimeClient}. */
+export interface VoiceAgentWebSocketFactory {
+    /** Creates a new transport instance for a single connection attempt. */
+    create(): VoiceAgentWebSocketTransport;
+}
+//# sourceMappingURL=webSocketTransportLike.d.ts.map

package/dist/commonjs/realtime/webSocketTransportLike.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webSocketTransportLike.d.ts","sourceRoot":"","sources":["../../../src/realtime/webSocketTransportLike.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,8FAA8F;AAC9F,MAAM,WAAW,2BAA2B;IAC1C,2DAA2D;IAC3D,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,KAAK,IAAI,CAAC;IAChD,0CAA0C;IAC1C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACnE,sDAAsD;IACtD,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAED,sEAAsE;AACtE,MAAM,WAAW,iCAAiC;IAChD,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,6FAA6F;IAC7F,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,2CAA2C;IAC3C,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sCAAsC;IACtC,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,iEAAiE;IACjE,WAAW,CAAC,QAAQ,EAAE,2BAA2B,GAAG,IAAI,CAAC;IACzD,4CAA4C;IAC5C,OAAO,CAAC,OAAO,EAAE,iCAAiC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,2CAA2C;IAC3C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,6BAA6B;IAC7B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED,mGAAmG;AACnG,MAAM,WAAW,0BAA0B;IACzC,wEAAwE;IACxE,MAAM,IAAI,4BAA4B,CAAC;CACxC"}

package/dist/commonjs/realtime/webSocketTransportLike.js

@@ -0,0 +1,16 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var webSocketTransportLike_exports = {};
+module.exports = __toCommonJS(webSocketTransportLike_exports);
+//# sourceMappingURL=webSocketTransportLike.js.map

package/dist/commonjs/realtime/webSocketTransportLike.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/realtime/webSocketTransportLike.ts"],
+  "sourcesContent": ["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\n\n/** Callbacks invoked by a {@link VoiceAgentWebSocketTransport} as connection events occur. */\nexport interface VoiceAgentWebSocketHandlers {\n  /** Invoked when a message is received from the service. */\n  onMessage: (data: string | ArrayBuffer) => void;\n  /** Invoked when the connection closes. */\n  onClose: (code: number, reason: string, wasClean: boolean) => void;\n  /** Invoked when the transport encounters an error. */\n  onError: (error: Error) => void;\n}\n\n/** Options passed to {@link VoiceAgentWebSocketTransport.connect}. */\nexport interface VoiceAgentWebSocketConnectOptions {\n  /** The WebSocket URL to connect to. */\n  url: string;\n  /** The WebSocket subprotocols to negotiate. */\n  protocols: string[];\n  /** Headers to send with the connection upgrade request, where supported by the transport. */\n  headers: Record<string, string>;\n  /** Connection timeout, in milliseconds. */\n  connectionTimeoutInMs: number;\n  /** Cancels the connection attempt. */\n  abortSignal?: AbortSignalLike;\n}\n\n/**\n * A pluggable WebSocket transport used by {@link VoiceAgentRealtimeClient}. Implement this\n * interface to customize how the realtime connection is established, for example to route it\n * through an authenticated relay.\n */\nexport interface VoiceAgentWebSocketTransport {\n  /** Registers the handlers invoked as connection events occur. */\n  setHandlers(handlers: VoiceAgentWebSocketHandlers): void;\n  /** Establishes the WebSocket connection. */\n  connect(options: VoiceAgentWebSocketConnectOptions): Promise<void>;\n  /** Sends a message over the connection. */\n  send(data: string, abortSignal?: AbortSignalLike): Promise<void>;\n  /** Closes the connection. */\n  close(code: number, reason: string): Promise<void>;\n}\n\n/** Creates {@link VoiceAgentWebSocketTransport} instances for {@link VoiceAgentRealtimeClient}. */\nexport interface VoiceAgentWebSocketFactory {\n  /** Creates a new transport instance for a single connection attempt. */\n  create(): VoiceAgentWebSocketTransport;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/dist/commonjs/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.58.12"
+      "packageVersion": "7.59.1"
     }
   ]
 }

package/dist/commonjs/webSocketTransport.d.ts

@@ -0,0 +1,15 @@
+import type { AbortSignalLike } from "@azure/abort-controller";
+import type { VoiceAgentWebSocketConnectOptions, VoiceAgentWebSocketFactory, VoiceAgentWebSocketHandlers, VoiceAgentWebSocketTransport } from "./realtime/webSocketTransportLike.js";
+export declare class NodeWebSocketTransport implements VoiceAgentWebSocketTransport {
+    private webSocket?;
+    private handlers?;
+    private readonly closeTimeoutInMs;
+    constructor(closeTimeoutInMs?: number);
+    setHandlers(handlers: VoiceAgentWebSocketHandlers): void;
+    connect(options: VoiceAgentWebSocketConnectOptions): Promise<void>;
+    send(data: string, abortSignal?: AbortSignalLike): Promise<void>;
+    close(code: number, reason: string): Promise<void>;
+}
+/** @internal */
+export declare function createDefaultVoiceAgentWebSocketFactory(): VoiceAgentWebSocketFactory;
+//# sourceMappingURL=webSocketTransport.d.ts.map

package/dist/commonjs/webSocketTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webSocketTransport.d.ts","sourceRoot":"","sources":["../../src/webSocketTransport.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EACV,iCAAiC,EACjC,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,sCAAsC,CAAC;AAE9C,qBAAa,sBAAuB,YAAW,4BAA4B;IACzE,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAA8B;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAEvB,gBAAgB,SAAQ;IAIpC,WAAW,CAAC,QAAQ,EAAE,2BAA2B,GAAG,IAAI;IAIlD,OAAO,CAAC,OAAO,EAAE,iCAAiC,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBlE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAwBhE;AAuKD,gBAAgB;AAChB,wBAAgB,uCAAuC,IAAI,0BAA0B,CAEpF"}