@azure/ai-projects 2.7.1 → 2.8.0

package/dist/react-native/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure/ai-projects",
-  "version": "2.7.1",
+  "version": "2.8.0",
   "type": "module",
   "exports": {
     "./package.json": "./package.json"

package/dist/react-native/realtime/voiceAgentRealtimeClient.d.ts

@@ -1,7 +1,7 @@
 import type { AbortSignalLike } from "@azure/abort-controller";
 import type { TokenCredential } from "@azure/core-auth";
 import type { OperationOptions } from "@azure-rest/core-client";
-import type { VoiceAgentClientEvent, VoiceAgentResponseCreateParams, VoiceAgentSessionUpdateConfig } from "../models/models.js";
+import type { VoiceAgentClientEvent, VoiceAgentResponseCreateParams, VoiceAgentSessionUpdateConfig, VoiceAgentTransport } from "../models/models.js";
 import type { VoiceAgentRealtimeEvent } from "./events.js";
 import type { VoiceAgentWebSocketFactory } from "./webSocketTransportLike.js";
 /** Known values of {@link VoiceAgentConnectionState} reported by a voice-agent realtime connection. */
@@ -40,8 +40,30 @@ export interface VoiceAgentRealtimeClientConnectOptions extends OperationOptions
     store?: boolean;
     /** Selects a specific immutable agent version. */
     agentVersionOverride?: string;
-    /** Values used to render the agent's structured prompt inputs. */
+    /**
+     * Selects the transport used for the realtime connection. Defaults to `"websocket"`. Set to
+     * `"webrtc"` to negotiate a WebRTC peer connection instead; the caller is responsible for
+     * completing the SDP offer/answer exchange using the `rtc.call.sdp.create` and
+     * `rtc.call.sdp.created` events (see {@link VoiceAgentRealtimeEvent}).
+     */
+    transport?: VoiceAgentTransport;
+    /**
+     * Values used to render the agent's structured prompt inputs.
+     * Serialized when `connect()` is called, before authentication.
+     */
     structuredInputs?: Record<string, unknown>;
+    /**
+     * Additional query parameters for this connection's WebSocket upgrade URL.
+     * Provide a plain object, including a null-prototype object.
+     * Values override matching endpoint query parameters; `undefined` removes a parameter.
+     * Values are URL-encoded automatically. Numbers must be finite.
+     * SDK-managed parameters, authentication parameters, and names starting with `h-` are
+     * reserved (case-insensitively) and cause a `TypeError`. Use the corresponding typed
+     * options for session, version, storage, transport, and structured prompt inputs instead.
+     * Both `structured_input` and `structured_inputs` are reserved.
+     * Do not include secrets: query parameters can appear in server or proxy logs.
+     */
+    query?: Readonly<Record<string, string | number | boolean | undefined>>;
     /** Overrides the client connection timeout in milliseconds. */
     connectionTimeoutInMs?: number;
     /** Cancels the connection attempt. */

package/dist/react-native/realtime/voiceAgentRealtimeClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"voiceAgentRealtimeClient.d.ts","sourceRoot":"","sources":["../../../src/realtime/voiceAgentRealtimeClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"voiceAgentRealtimeClient.d.ts","sourceRoot":"","sources":["../../../src/realtime/voiceAgentRealtimeClient.ts"],"names":[],"mappings":"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"}

package/dist/react-native/realtime/voiceAgentRealtimeClient.js

@@ -8,6 +8,23 @@ import { VoiceAgentAuthenticationError, VoiceAgentConnectionError, VoiceAgentPro
 import { deserializeVoiceAgentServerEvent, serializeVoiceAgentClientEvent } from "./protocol.js";
 const defaultCredentialScope = "https://ai.azure.com/.default";
 const voiceAgentsPreview = "VoiceAgents=V1Preview";
+const reservedQueryParameters = new Set([
+    "api-version",
+    "agent_session_id",
+    "store",
+    "transport",
+    "x-agent-version-override",
+    "x-ms-client-sdk",
+    "authorization",
+    "api-key",
+    "foundry_features",
+    "foundry-features",
+    "client-request-id",
+    "x-ms-client-request-id",
+    "structured_input",
+    "structured_inputs",
+    "x-ms-voice-structured-inputs",
+]);
 /** Known values of {@link VoiceAgentConnectionState} reported by a voice-agent realtime connection. */
 export const KnownVoiceAgentConnectionState = {
     Disconnected: "disconnected",
@@ -40,19 +57,24 @@ export class VoiceAgentRealtimeClient {
         if (!agentName.trim()) {
             throw new TypeError("agentName must not be empty.");
         }
+        const url = buildWebSocketUrl(normalizeEndpoint(this.endpoint), agentName, this.options.apiVersion, options);
+        const serializedStructuredInputs = options.structuredInputs
+            ? JSON.stringify(options.structuredInputs)
+            : undefined;
         const factory = this.options.webSocketFactory ??
             (await import("../webSocketTransport.js")).createDefaultVoiceAgentWebSocketFactory();
-        const connection = new VoiceAgentConnectionImpl(normalizeEndpoint(this.endpoint), agentName, this.credential, this.options, options, factory);
+        const connection = new VoiceAgentConnectionImpl(url, agentName, this.credential, this.options, options, serializedStructuredInputs, factory);
         await connection.open();
         return connection;
     }
 }
 class VoiceAgentConnectionImpl {
-    endpoint;
+    url;
     agentName;
     credential;
     clientOptions;
     connectOptions;
+    serializedStructuredInputs;
     events;
     transport;
     closePromise;
@@ -60,12 +82,13 @@ class VoiceAgentConnectionImpl {
     currentState = KnownVoiceAgentConnectionState.Disconnected;
     iteratorStarted = false;
     finished = false;
-    constructor(endpoint, agentName, credential, clientOptions, connectOptions, factory) {
-        this.endpoint = endpoint;
+    constructor(url, agentName, credential, clientOptions, connectOptions, serializedStructuredInputs, factory) {
+        this.url = url;
         this.agentName = agentName;
         this.credential = credential;
         this.clientOptions = clientOptions;
         this.connectOptions = connectOptions;
+        this.serializedStructuredInputs = serializedStructuredInputs;
         this.events = new AsyncQueue(10_000, {
             onOverflow: (error) => this.handleEventQueueOverflow(error),
         });
@@ -111,9 +134,9 @@ class VoiceAgentConnectionImpl {
         }
         try {
             await this.transport.connect({
-                url: buildWebSocketUrl(this.endpoint, this.agentName, this.clientOptions.apiVersion, this.connectOptions),
+                url: this.url,
                 protocols: ["realtime"],
-                headers: buildHeaders(token, this.clientOptions, this.connectOptions),
+                headers: buildHeaders(token, this.clientOptions, this.serializedStructuredInputs),
                 connectionTimeoutInMs: this.connectOptions.connectionTimeoutInMs ?? this.clientOptions.connectionTimeoutInMs,
                 abortSignal: this.connectOptions.abortSignal,
             });
@@ -335,12 +358,35 @@ function normalizeEndpoint(endpoint) {
     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(/\/$/, "");
+    return url.toString();
 }
 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.pathname = `${url.pathname.replace(/\/+$/, "")}/agents/${encodeURIComponent(agentName)}/endpoint/protocols/voice`;
+    if (options.query !== undefined &&
+        (options.query === null ||
+            typeof options.query !== "object" ||
+            ![Object.prototype, null].includes(Object.getPrototypeOf(options.query)))) {
+        throw new TypeError("query must be a record of query parameters.");
+    }
+    for (const [name, value] of Object.entries(options.query ?? {})) {
+        const normalizedName = name.toLowerCase();
+        if (reservedQueryParameters.has(normalizedName) || normalizedName.startsWith("h-")) {
+            throw new TypeError(`Query parameter "${name}" is reserved; use the SDK's typed options.`);
+        }
+        if (value === undefined) {
+            url.searchParams.delete(name);
+        }
+        else if (typeof value === "string" ||
+            typeof value === "boolean" ||
+            (typeof value === "number" && Number.isFinite(value))) {
+            url.searchParams.set(name, String(value));
+        }
+        else {
+            throw new TypeError(`Query parameter "${name}" must be a string, boolean, finite number, or undefined.`);
+        }
+    }
     url.searchParams.set("api-version", apiVersion);
     url.searchParams.set("x-ms-client-sdk", `azsdk-js-ai-projects/${SDK_VERSION}`);
     if (options.agentSessionId) {
@@ -352,9 +398,12 @@ function buildWebSocketUrl(endpoint, agentName, apiVersion, options) {
     if (options.agentVersionOverride) {
         url.searchParams.set("x-agent-version-override", options.agentVersionOverride);
     }
+    if (options.transport) {
+        url.searchParams.set("transport", options.transport);
+    }
     return url.toString();
 }
-function buildHeaders(token, clientOptions, connectOptions) {
+function buildHeaders(token, clientOptions, serializedStructuredInputs) {
     const sdkUserAgent = `azsdk-js-ai-projects/${SDK_VERSION}`;
     const headers = {
         authorization: `Bearer ${token}`,
@@ -365,8 +414,8 @@ function buildHeaders(token, clientOptions, connectOptions) {
             ? `${clientOptions.userAgentPrefix} ${sdkUserAgent}`
             : sdkUserAgent,
     };
-    if (connectOptions.structuredInputs) {
-        headers["x-ms-voice-structured-inputs"] = JSON.stringify(connectOptions.structuredInputs);
+    if (serializedStructuredInputs !== undefined) {
+        headers["x-ms-voice-structured-inputs"] = serializedStructuredInputs;
     }
     return headers;
 }

package/dist/react-native/realtime/voiceAgentRealtimeClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"voiceAgentRealtimeClient.js","sourceRoot":"","sources":["../../../src/realtime/voiceAgentRealtimeClient.ts"],"names":[],"mappings":"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","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"]}
+{"version":3,"file":"voiceAgentRealtimeClient.js","sourceRoot":"","sources":["../../../src/realtime/voiceAgentRealtimeClient.ts"],"names":[],"mappings":"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","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  VoiceAgentTransport,\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\";\nconst reservedQueryParameters = new Set([\n  \"api-version\",\n  \"agent_session_id\",\n  \"store\",\n  \"transport\",\n  \"x-agent-version-override\",\n  \"x-ms-client-sdk\",\n  \"authorization\",\n  \"api-key\",\n  \"foundry_features\",\n  \"foundry-features\",\n  \"client-request-id\",\n  \"x-ms-client-request-id\",\n  \"structured_input\",\n  \"structured_inputs\",\n  \"x-ms-voice-structured-inputs\",\n]);\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  /**\n   * Selects the transport used for the realtime connection. Defaults to `\"websocket\"`. Set to\n   * `\"webrtc\"` to negotiate a WebRTC peer connection instead; the caller is responsible for\n   * completing the SDP offer/answer exchange using the `rtc.call.sdp.create` and\n   * `rtc.call.sdp.created` events (see {@link VoiceAgentRealtimeEvent}).\n   */\n  transport?: VoiceAgentTransport;\n  /**\n   * Values used to render the agent's structured prompt inputs.\n   * Serialized when `connect()` is called, before authentication.\n   */\n  structuredInputs?: Record<string, unknown>;\n  /**\n   * Additional query parameters for this connection's WebSocket upgrade URL.\n   * Provide a plain object, including a null-prototype object.\n   * Values override matching endpoint query parameters; `undefined` removes a parameter.\n   * Values are URL-encoded automatically. Numbers must be finite.\n   * SDK-managed parameters, authentication parameters, and names starting with `h-` are\n   * reserved (case-insensitively) and cause a `TypeError`. Use the corresponding typed\n   * options for session, version, storage, transport, and structured prompt inputs instead.\n   * Both `structured_input` and `structured_inputs` are reserved.\n   * Do not include secrets: query parameters can appear in server or proxy logs.\n   */\n  query?: Readonly<Record<string, string | number | boolean | undefined>>;\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 url = buildWebSocketUrl(\n      normalizeEndpoint(this.endpoint),\n      agentName,\n      this.options.apiVersion,\n      options,\n    );\n    const serializedStructuredInputs = options.structuredInputs\n      ? JSON.stringify(options.structuredInputs)\n      : undefined;\n    const factory =\n      this.options.webSocketFactory ??\n      (await import(\"#platform/webSocketTransport\")).createDefaultVoiceAgentWebSocketFactory();\n    const connection = new VoiceAgentConnectionImpl(\n      url,\n      agentName,\n      this.credential,\n      this.options,\n      options,\n      serializedStructuredInputs,\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 url: 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    private readonly serializedStructuredInputs: string | undefined,\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: this.url,\n        protocols: [\"realtime\"],\n        headers: buildHeaders(token, this.clientOptions, this.serializedStructuredInputs),\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();\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  if (\n    options.query !== undefined &&\n    (options.query === null ||\n      typeof options.query !== \"object\" ||\n      ![Object.prototype, null].includes(Object.getPrototypeOf(options.query)))\n  ) {\n    throw new TypeError(\"query must be a record of query parameters.\");\n  }\n  for (const [name, value] of Object.entries(options.query ?? {})) {\n    const normalizedName = name.toLowerCase();\n    if (reservedQueryParameters.has(normalizedName) || normalizedName.startsWith(\"h-\")) {\n      throw new TypeError(`Query parameter \"${name}\" is reserved; use the SDK's typed options.`);\n    }\n    if (value === undefined) {\n      url.searchParams.delete(name);\n    } else if (\n      typeof value === \"string\" ||\n      typeof value === \"boolean\" ||\n      (typeof value === \"number\" && Number.isFinite(value))\n    ) {\n      url.searchParams.set(name, String(value));\n    } else {\n      throw new TypeError(\n        `Query parameter \"${name}\" must be a string, boolean, finite number, or undefined.`,\n      );\n    }\n  }\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  if (options.transport) {\n    url.searchParams.set(\"transport\", options.transport);\n  }\n  return url.toString();\n}\n\nfunction buildHeaders(\n  token: string,\n  clientOptions: VoiceAgentRealtimeClientOptions,\n  serializedStructuredInputs: string | undefined,\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 (serializedStructuredInputs !== undefined) {\n    headers[\"x-ms-voice-structured-inputs\"] = serializedStructuredInputs;\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"]}

package/dist/react-native/webSocketTransport-browser.d.mts

@@ -6,6 +6,7 @@ import type { VoiceAgentWebSocketConnectOptions, VoiceAgentWebSocketFactory, Voi
  * Browsers cannot set an `Authorization` header on a WebSocket upgrade request. This transport sends
  * the Microsoft Entra bearer token as the `authorization.bearer.<token>` WebSocket subprotocol,
  * which the service converts back into an `Authorization` header before forwarding the request.
+ * Only preview features, client request IDs, and structured inputs are mapped to query parameters.
  */
 export declare class BrowserWebSocketTransport implements VoiceAgentWebSocketTransport {
     private webSocket?;

package/dist/react-native/webSocketTransport-browser.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"webSocketTransport-browser.d.mts","sourceRoot":"","sources":["../../src/webSocketTransport-browser.mts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EACV,iCAAiC,EACjC,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,sCAAsC,CAAC;AAS9C;;;;;;GAMG;AACH,qBAAa,yBAA0B,YAAW,4BAA4B;IAC5E,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAA8B;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,YAAY,CAAoC;IAIxD,OAAO,CAAC,aAAa,CAAoC;gBAEtC,gBAAgB,SAAQ;IAIpC,WAAW,CAAC,QAAQ,EAAE,2BAA2B,GAAG,IAAI;IAIlD,OAAO,CAAC,OAAO,EAAE,iCAAiC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoClE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7E,2FAA2F;YAC7E,cAAc;IAQ5B,iFAAiF;YACnE,YAAY;YAWZ,qBAAqB;IActB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAyBhE;AA6DD,gBAAgB;AAChB,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAyBpF;AAsBD,gBAAgB;AAChB,wBAAgB,uCAAuC,IAAI,0BAA0B,CAEpF"}
+{"version":3,"file":"webSocketTransport-browser.d.mts","sourceRoot":"","sources":["../../src/webSocketTransport-browser.mts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EACV,iCAAiC,EACjC,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,sCAAsC,CAAC;AAS9C;;;;;;;GAOG;AACH,qBAAa,yBAA0B,YAAW,4BAA4B;IAC5E,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAA8B;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,YAAY,CAAoC;IAIxD,OAAO,CAAC,aAAa,CAAoC;gBAEtC,gBAAgB,SAAQ;IAIpC,WAAW,CAAC,QAAQ,EAAE,2BAA2B,GAAG,IAAI;IAIlD,OAAO,CAAC,OAAO,EAAE,iCAAiC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoClE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7E,2FAA2F;YAC7E,cAAc;IAQ5B,iFAAiF;YACnE,YAAY;YAWZ,qBAAqB;IActB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAyBhE;AA6DD,gBAAgB;AAChB,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAgBpF;AAsBD,gBAAgB;AAChB,wBAAgB,uCAAuC,IAAI,0BAA0B,CAEpF"}

package/dist/react-native/webSocketTransport-browser.mjs

@@ -7,6 +7,7 @@ import { logger } from "./logger.js";
  * Browsers cannot set an `Authorization` header on a WebSocket upgrade request. This transport sends
  * the Microsoft Entra bearer token as the `authorization.bearer.<token>` WebSocket subprotocol,
  * which the service converts back into an `Authorization` header before forwarding the request.
+ * Only preview features, client request IDs, and structured inputs are mapped to query parameters.
  */
 export class BrowserWebSocketTransport {
     webSocket;
@@ -171,29 +172,20 @@ async function waitForClose(webSocket, closeNotified, timeoutInMs) {
 /** @internal */
 export function addHeadersToUrl(url, headers) {
     const target = new URL(url);
-    let foundryFeatures;
     for (const [name, value] of Object.entries(headers)) {
         switch (name.toLowerCase()) {
-            case "authorization":
-                break;
             case "foundry-features":
-                foundryFeatures = value;
+                target.searchParams.set("foundry_features", value);
                 break;
             case "x-ms-client-request-id":
                 target.searchParams.set("client-request-id", value);
                 break;
-            default:
-                target.searchParams.set(`h-${name.toLowerCase()}`, value);
+            case "x-ms-voice-structured-inputs":
+                target.searchParams.set("structured_input", value);
                 break;
         }
     }
-    const targetUrl = target.toString();
-    if (foundryFeatures === undefined) {
-        return targetUrl;
-    }
-    const separator = target.search ? "&" : "?";
-    const encodedFeatures = encodeURIComponent(foundryFeatures).replace(/%3D/gi, "=");
-    return `${targetUrl}${separator}foundry_features=${encodedFeatures}`;
+    return target.toString();
 }
 function addCredentialSubprotocol(protocols, headers) {
     const authorization = Object.entries(headers).find(([name]) => name.toLowerCase() === "authorization")?.[1];

package/dist/react-native/webSocketTransport-browser.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"webSocketTransport-browser.mjs","sourceRoot":"","sources":["../../src/webSocketTransport-browser.mts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport { logger } from \"./logger.js\";\nimport type {\n  VoiceAgentWebSocketConnectOptions,\n  VoiceAgentWebSocketFactory,\n  VoiceAgentWebSocketHandlers,\n  VoiceAgentWebSocketTransport,\n} from \"./realtime/webSocketTransportLike.js\";\n\n/** The `CloseEvent` fields this transport forwards; the DOM lib is not in scope here. */\ninterface NativeCloseEvent {\n  code: number;\n  reason: string;\n  wasClean: boolean;\n}\n\n/**\n * Default browser transport for the Voice Agents realtime client.\n *\n * Browsers cannot set an `Authorization` header on a WebSocket upgrade request. This transport sends\n * the Microsoft Entra bearer token as the `authorization.bearer.<token>` WebSocket subprotocol,\n * which the service converts back into an `Authorization` header before forwarding the request.\n */\nexport class BrowserWebSocketTransport implements VoiceAgentWebSocketTransport {\n  private webSocket?: WebSocket;\n  private handlers?: VoiceAgentWebSocketHandlers;\n  private readonly closeTimeoutInMs: number;\n  private messageChain: Promise<void> = Promise.resolve();\n  // Resolves once `onClose` has actually been invoked for the current connection (after\n  // `messageChain` drains). `close()` awaits this - not just the raw native \"close\" event -\n  // so it never resolves before the caller observes the authoritative close code/reason/wasClean.\n  private closeNotified: Promise<void> = Promise.resolve();\n\n  public constructor(closeTimeoutInMs = 5_000) {\n    this.closeTimeoutInMs = closeTimeoutInMs;\n  }\n\n  public setHandlers(handlers: VoiceAgentWebSocketHandlers): void {\n    this.handlers = handlers;\n  }\n\n  public async connect(options: VoiceAgentWebSocketConnectOptions): Promise<void> {\n    if (options.abortSignal?.aborted) {\n      throw new Error(\"WebSocket connection was cancelled.\");\n    }\n    const protocols = addCredentialSubprotocol(options.protocols, options.headers);\n    const url = addHeadersToUrl(options.url, options.headers);\n\n    let notifyClosed: () => void = () => {};\n    this.closeNotified = new Promise<void>((resolve) => {\n      notifyClosed = resolve;\n    });\n\n    const webSocket = new WebSocket(url, protocols);\n    webSocket.binaryType = \"arraybuffer\";\n    this.webSocket = webSocket;\n\n    // These forward events for the lifetime of the connection, independent of whether connect()\n    // itself is still pending.\n    webSocket.addEventListener(\"message\", (event: MessageEvent) => {\n      // Chain handling so an async Blob conversion can never let a later message be delivered to\n      // the protocol parser out of arrival order.\n      this.messageChain = this.deliverMessage(this.messageChain, event.data);\n    });\n    webSocket.addEventListener(\"close\", (event) => void this.deliverClose(event, notifyClosed));\n    webSocket.addEventListener(\"error\", () => {\n      this.handlers?.onError(new Error(\"WebSocket connection failed.\"));\n    });\n\n    try {\n      await waitForOpen(webSocket, options.connectionTimeoutInMs, options.abortSignal);\n    } catch (error) {\n      webSocket.close();\n      throw error;\n    }\n  }\n\n  public async send(data: string, abortSignal?: AbortSignalLike): Promise<void> {\n    if (!this.webSocket || this.webSocket.readyState !== WebSocket.OPEN) {\n      throw new Error(\"WebSocket is not connected.\");\n    }\n    if (abortSignal?.aborted) {\n      throw new Error(\"WebSocket send was cancelled.\");\n    }\n    this.webSocket.send(data);\n  }\n\n  /** Chains `data` behind `previous` so an async `Blob` conversion cannot reorder events. */\n  private async deliverMessage(\n    previous: Promise<void>,\n    data: string | ArrayBuffer | Blob,\n  ): Promise<void> {\n    await previous;\n    await this.handleIncomingMessage(data);\n  }\n\n  /** Reports the close only after every earlier message has reached the parser. */\n  private async deliverClose(event: Event, notifyClosed: () => void): Promise<void> {\n    const { code, reason, wasClean } = event as unknown as NativeCloseEvent;\n    try {\n      await this.messageChain;\n    } catch {\n      // handleIncomingMessage already reported the failure through onError.\n    }\n    this.handlers?.onClose(code, reason, wasClean);\n    notifyClosed();\n  }\n\n  private async handleIncomingMessage(data: string | ArrayBuffer | Blob): Promise<void> {\n    if (typeof data === \"string\" || data instanceof ArrayBuffer) {\n      this.handlers?.onMessage(data);\n      return;\n    }\n    if (data instanceof Blob) {\n      try {\n        this.handlers?.onMessage(await data.arrayBuffer());\n      } catch (error) {\n        this.handlers?.onError(error instanceof Error ? error : new Error(String(error)));\n      }\n    }\n  }\n\n  public async close(code: number, reason: string): Promise<void> {\n    if (!this.webSocket) {\n      return;\n    }\n    const webSocket = this.webSocket;\n    try {\n      if (webSocket.readyState !== WebSocket.CLOSING && webSocket.readyState !== WebSocket.CLOSED) {\n        if (code === 1000 || (code >= 3000 && code <= 4999)) {\n          webSocket.close(code, reason);\n        } else {\n          webSocket.close();\n        }\n      }\n      await waitForClose(webSocket, this.closeNotified, this.closeTimeoutInMs);\n    } catch (error) {\n      // close() is a best-effort cleanup operation and must never throw (callers, including our\n      // own VoiceAgentConnection.close()/dispose(), rely on it always resolving), so a transport\n      // error here is logged for diagnosability rather than rejecting.\n      logger.warning(\"Error while closing the voice-agent WebSocket transport\", { error });\n    } finally {\n      if (this.webSocket === webSocket) {\n        this.webSocket = undefined;\n      }\n    }\n  }\n}\n\n/** Waits for `webSocket` to open, or rejects early on an error, timeout, or abort. */\nfunction waitForOpen(\n  webSocket: WebSocket,\n  connectionTimeoutInMs: number,\n  abortSignal?: AbortSignalLike,\n): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      finish(() =>\n        reject(new Error(`WebSocket connection timed out after ${connectionTimeoutInMs}ms.`)),\n      );\n    }, connectionTimeoutInMs);\n    const onOpen = (): void => finish(resolve);\n    const onError = (): void => finish(() => reject(new Error(\"WebSocket connection failed.\")));\n    const onAbort = (): void =>\n      finish(() => reject(new Error(\"WebSocket connection was cancelled.\")));\n\n    function finish(settle: () => void): void {\n      clearTimeout(timeout);\n      webSocket.removeEventListener(\"open\", onOpen);\n      webSocket.removeEventListener(\"error\", onError);\n      abortSignal?.removeEventListener(\"abort\", onAbort);\n      settle();\n    }\n\n    webSocket.addEventListener(\"open\", onOpen, { once: true });\n    webSocket.addEventListener(\"error\", onError, { once: true });\n    abortSignal?.addEventListener(\"abort\", onAbort);\n  });\n}\n\n/**\n * Waits until `onClose` has been delivered to the handlers, so `close()` never returns before the\n * caller observes the true close outcome. Resolves on timeout if the socket never closes; rejects\n * if it errors instead.\n */\nasync function waitForClose(\n  webSocket: WebSocket,\n  closeNotified: Promise<void>,\n  timeoutInMs: number,\n): Promise<void> {\n  let timeout: ReturnType<typeof setTimeout> | undefined;\n  let onError: (() => void) | undefined;\n  const errorOrTimeout = new Promise<void>((resolve, reject) => {\n    timeout = setTimeout(resolve, timeoutInMs);\n    onError = (): void => reject(new Error(\"WebSocket connection failed while closing.\"));\n    webSocket.addEventListener(\"error\", onError, { once: true });\n  });\n\n  try {\n    await Promise.race([closeNotified, errorOrTimeout]);\n  } finally {\n    clearTimeout(timeout);\n    if (onError) {\n      webSocket.removeEventListener(\"error\", onError);\n    }\n  }\n}\n\n/** @internal */\nexport function addHeadersToUrl(url: string, headers: Record<string, string>): string {\n  const target = new URL(url);\n  let foundryFeatures: string | undefined;\n  for (const [name, value] of Object.entries(headers)) {\n    switch (name.toLowerCase()) {\n      case \"authorization\":\n        break;\n      case \"foundry-features\":\n        foundryFeatures = value;\n        break;\n      case \"x-ms-client-request-id\":\n        target.searchParams.set(\"client-request-id\", value);\n        break;\n      default:\n        target.searchParams.set(`h-${name.toLowerCase()}`, value);\n        break;\n    }\n  }\n  const targetUrl = target.toString();\n  if (foundryFeatures === undefined) {\n    return targetUrl;\n  }\n  const separator = target.search ? \"&\" : \"?\";\n  const encodedFeatures = encodeURIComponent(foundryFeatures).replace(/%3D/gi, \"=\");\n  return `${targetUrl}${separator}foundry_features=${encodedFeatures}`;\n}\n\nfunction addCredentialSubprotocol(protocols: string[], headers: Record<string, string>): string[] {\n  const authorization = Object.entries(headers).find(\n    ([name]) => name.toLowerCase() === \"authorization\",\n  )?.[1];\n  if (authorization === undefined) {\n    return protocols;\n  }\n  const bearerPrefix = \"Bearer \";\n  if (!authorization.startsWith(bearerPrefix) || authorization.length === bearerPrefix.length) {\n    throw new Error(\"Browser WebSocket authentication requires a Microsoft Entra bearer token.\");\n  }\n  return [...protocols, `authorization.bearer.${authorization.slice(bearerPrefix.length)}`];\n}\n\nclass BrowserWebSocketFactory implements VoiceAgentWebSocketFactory {\n  public create(): VoiceAgentWebSocketTransport {\n    return new BrowserWebSocketTransport();\n  }\n}\n\n/** @internal */\nexport function createDefaultVoiceAgentWebSocketFactory(): VoiceAgentWebSocketFactory {\n  return new BrowserWebSocketFactory();\n}\n"]}
+{"version":3,"file":"webSocketTransport-browser.mjs","sourceRoot":"","sources":["../../src/webSocketTransport-browser.mts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport { logger } from \"./logger.js\";\nimport type {\n  VoiceAgentWebSocketConnectOptions,\n  VoiceAgentWebSocketFactory,\n  VoiceAgentWebSocketHandlers,\n  VoiceAgentWebSocketTransport,\n} from \"./realtime/webSocketTransportLike.js\";\n\n/** The `CloseEvent` fields this transport forwards; the DOM lib is not in scope here. */\ninterface NativeCloseEvent {\n  code: number;\n  reason: string;\n  wasClean: boolean;\n}\n\n/**\n * Default browser transport for the Voice Agents realtime client.\n *\n * Browsers cannot set an `Authorization` header on a WebSocket upgrade request. This transport sends\n * the Microsoft Entra bearer token as the `authorization.bearer.<token>` WebSocket subprotocol,\n * which the service converts back into an `Authorization` header before forwarding the request.\n * Only preview features, client request IDs, and structured inputs are mapped to query parameters.\n */\nexport class BrowserWebSocketTransport implements VoiceAgentWebSocketTransport {\n  private webSocket?: WebSocket;\n  private handlers?: VoiceAgentWebSocketHandlers;\n  private readonly closeTimeoutInMs: number;\n  private messageChain: Promise<void> = Promise.resolve();\n  // Resolves once `onClose` has actually been invoked for the current connection (after\n  // `messageChain` drains). `close()` awaits this - not just the raw native \"close\" event -\n  // so it never resolves before the caller observes the authoritative close code/reason/wasClean.\n  private closeNotified: Promise<void> = Promise.resolve();\n\n  public constructor(closeTimeoutInMs = 5_000) {\n    this.closeTimeoutInMs = closeTimeoutInMs;\n  }\n\n  public setHandlers(handlers: VoiceAgentWebSocketHandlers): void {\n    this.handlers = handlers;\n  }\n\n  public async connect(options: VoiceAgentWebSocketConnectOptions): Promise<void> {\n    if (options.abortSignal?.aborted) {\n      throw new Error(\"WebSocket connection was cancelled.\");\n    }\n    const protocols = addCredentialSubprotocol(options.protocols, options.headers);\n    const url = addHeadersToUrl(options.url, options.headers);\n\n    let notifyClosed: () => void = () => {};\n    this.closeNotified = new Promise<void>((resolve) => {\n      notifyClosed = resolve;\n    });\n\n    const webSocket = new WebSocket(url, protocols);\n    webSocket.binaryType = \"arraybuffer\";\n    this.webSocket = webSocket;\n\n    // These forward events for the lifetime of the connection, independent of whether connect()\n    // itself is still pending.\n    webSocket.addEventListener(\"message\", (event: MessageEvent) => {\n      // Chain handling so an async Blob conversion can never let a later message be delivered to\n      // the protocol parser out of arrival order.\n      this.messageChain = this.deliverMessage(this.messageChain, event.data);\n    });\n    webSocket.addEventListener(\"close\", (event) => void this.deliverClose(event, notifyClosed));\n    webSocket.addEventListener(\"error\", () => {\n      this.handlers?.onError(new Error(\"WebSocket connection failed.\"));\n    });\n\n    try {\n      await waitForOpen(webSocket, options.connectionTimeoutInMs, options.abortSignal);\n    } catch (error) {\n      webSocket.close();\n      throw error;\n    }\n  }\n\n  public async send(data: string, abortSignal?: AbortSignalLike): Promise<void> {\n    if (!this.webSocket || this.webSocket.readyState !== WebSocket.OPEN) {\n      throw new Error(\"WebSocket is not connected.\");\n    }\n    if (abortSignal?.aborted) {\n      throw new Error(\"WebSocket send was cancelled.\");\n    }\n    this.webSocket.send(data);\n  }\n\n  /** Chains `data` behind `previous` so an async `Blob` conversion cannot reorder events. */\n  private async deliverMessage(\n    previous: Promise<void>,\n    data: string | ArrayBuffer | Blob,\n  ): Promise<void> {\n    await previous;\n    await this.handleIncomingMessage(data);\n  }\n\n  /** Reports the close only after every earlier message has reached the parser. */\n  private async deliverClose(event: Event, notifyClosed: () => void): Promise<void> {\n    const { code, reason, wasClean } = event as unknown as NativeCloseEvent;\n    try {\n      await this.messageChain;\n    } catch {\n      // handleIncomingMessage already reported the failure through onError.\n    }\n    this.handlers?.onClose(code, reason, wasClean);\n    notifyClosed();\n  }\n\n  private async handleIncomingMessage(data: string | ArrayBuffer | Blob): Promise<void> {\n    if (typeof data === \"string\" || data instanceof ArrayBuffer) {\n      this.handlers?.onMessage(data);\n      return;\n    }\n    if (data instanceof Blob) {\n      try {\n        this.handlers?.onMessage(await data.arrayBuffer());\n      } catch (error) {\n        this.handlers?.onError(error instanceof Error ? error : new Error(String(error)));\n      }\n    }\n  }\n\n  public async close(code: number, reason: string): Promise<void> {\n    if (!this.webSocket) {\n      return;\n    }\n    const webSocket = this.webSocket;\n    try {\n      if (webSocket.readyState !== WebSocket.CLOSING && webSocket.readyState !== WebSocket.CLOSED) {\n        if (code === 1000 || (code >= 3000 && code <= 4999)) {\n          webSocket.close(code, reason);\n        } else {\n          webSocket.close();\n        }\n      }\n      await waitForClose(webSocket, this.closeNotified, this.closeTimeoutInMs);\n    } catch (error) {\n      // close() is a best-effort cleanup operation and must never throw (callers, including our\n      // own VoiceAgentConnection.close()/dispose(), rely on it always resolving), so a transport\n      // error here is logged for diagnosability rather than rejecting.\n      logger.warning(\"Error while closing the voice-agent WebSocket transport\", { error });\n    } finally {\n      if (this.webSocket === webSocket) {\n        this.webSocket = undefined;\n      }\n    }\n  }\n}\n\n/** Waits for `webSocket` to open, or rejects early on an error, timeout, or abort. */\nfunction waitForOpen(\n  webSocket: WebSocket,\n  connectionTimeoutInMs: number,\n  abortSignal?: AbortSignalLike,\n): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      finish(() =>\n        reject(new Error(`WebSocket connection timed out after ${connectionTimeoutInMs}ms.`)),\n      );\n    }, connectionTimeoutInMs);\n    const onOpen = (): void => finish(resolve);\n    const onError = (): void => finish(() => reject(new Error(\"WebSocket connection failed.\")));\n    const onAbort = (): void =>\n      finish(() => reject(new Error(\"WebSocket connection was cancelled.\")));\n\n    function finish(settle: () => void): void {\n      clearTimeout(timeout);\n      webSocket.removeEventListener(\"open\", onOpen);\n      webSocket.removeEventListener(\"error\", onError);\n      abortSignal?.removeEventListener(\"abort\", onAbort);\n      settle();\n    }\n\n    webSocket.addEventListener(\"open\", onOpen, { once: true });\n    webSocket.addEventListener(\"error\", onError, { once: true });\n    abortSignal?.addEventListener(\"abort\", onAbort);\n  });\n}\n\n/**\n * Waits until `onClose` has been delivered to the handlers, so `close()` never returns before the\n * caller observes the true close outcome. Resolves on timeout if the socket never closes; rejects\n * if it errors instead.\n */\nasync function waitForClose(\n  webSocket: WebSocket,\n  closeNotified: Promise<void>,\n  timeoutInMs: number,\n): Promise<void> {\n  let timeout: ReturnType<typeof setTimeout> | undefined;\n  let onError: (() => void) | undefined;\n  const errorOrTimeout = new Promise<void>((resolve, reject) => {\n    timeout = setTimeout(resolve, timeoutInMs);\n    onError = (): void => reject(new Error(\"WebSocket connection failed while closing.\"));\n    webSocket.addEventListener(\"error\", onError, { once: true });\n  });\n\n  try {\n    await Promise.race([closeNotified, errorOrTimeout]);\n  } finally {\n    clearTimeout(timeout);\n    if (onError) {\n      webSocket.removeEventListener(\"error\", onError);\n    }\n  }\n}\n\n/** @internal */\nexport function addHeadersToUrl(url: string, headers: Record<string, string>): string {\n  const target = new URL(url);\n  for (const [name, value] of Object.entries(headers)) {\n    switch (name.toLowerCase()) {\n      case \"foundry-features\":\n        target.searchParams.set(\"foundry_features\", value);\n        break;\n      case \"x-ms-client-request-id\":\n        target.searchParams.set(\"client-request-id\", value);\n        break;\n      case \"x-ms-voice-structured-inputs\":\n        target.searchParams.set(\"structured_input\", value);\n        break;\n    }\n  }\n  return target.toString();\n}\n\nfunction addCredentialSubprotocol(protocols: string[], headers: Record<string, string>): string[] {\n  const authorization = Object.entries(headers).find(\n    ([name]) => name.toLowerCase() === \"authorization\",\n  )?.[1];\n  if (authorization === undefined) {\n    return protocols;\n  }\n  const bearerPrefix = \"Bearer \";\n  if (!authorization.startsWith(bearerPrefix) || authorization.length === bearerPrefix.length) {\n    throw new Error(\"Browser WebSocket authentication requires a Microsoft Entra bearer token.\");\n  }\n  return [...protocols, `authorization.bearer.${authorization.slice(bearerPrefix.length)}`];\n}\n\nclass BrowserWebSocketFactory implements VoiceAgentWebSocketFactory {\n  public create(): VoiceAgentWebSocketTransport {\n    return new BrowserWebSocketTransport();\n  }\n}\n\n/** @internal */\nexport function createDefaultVoiceAgentWebSocketFactory(): VoiceAgentWebSocketFactory {\n  return new BrowserWebSocketFactory();\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure/ai-projects",
-  "version": "2.7.1",
+  "version": "2.8.0",
   "description": "Azure AI Projects client library.",
   "engines": {
     "node": ">=22.0.0"
@@ -75,8 +75,8 @@
     "@opentelemetry/sdk-trace-node": "^2.9.0",
     "@types/node": "^22.0.0",
     "@types/ws": "^8.18.1",
-    "@vitest/browser-playwright": "^4.1.2",
-    "@vitest/coverage-istanbul": "^4.1.2",
+    "@vitest/browser-playwright": "^5.0.0",
+    "@vitest/coverage-istanbul": "^5.0.0",
     "cross-env": "^10.1.0",
     "dotenv": "^16.6.1",
     "eslint": "^10.8.0",
@@ -87,7 +87,7 @@
     "rimraf": "^6.1.0",
     "typescript": "~6.0.2",
     "vite": "^8.0.0",
-    "vitest": "^4.1.2",
+    "vitest": "^5.0.0",
     "zod": "^4.2.1"
   },
   "exports": {

package/dist/browser/api/beta/datasets/index.d.ts

@@ -1,3 +0,0 @@
-export { deleteGenerationJob, cancelGenerationJob, createGenerationJob, listGenerationJobs, getGenerationJob, } from "./operations.js";
-export type { BetaDatasetsDeleteGenerationJobOptionalParams, BetaDatasetsCancelGenerationJobOptionalParams, BetaDatasetsCreateGenerationJobOptionalParams, BetaDatasetsListGenerationJobsOptionalParams, BetaDatasetsGetGenerationJobOptionalParams, } from "./options.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/browser/api/beta/datasets/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/api/beta/datasets/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,6CAA6C,EAC7C,6CAA6C,EAC7C,6CAA6C,EAC7C,4CAA4C,EAC5C,0CAA0C,GAC3C,MAAM,cAAc,CAAC"}

package/dist/browser/api/beta/datasets/index.js

@@ -1,4 +0,0 @@
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT License.
-export { deleteGenerationJob, cancelGenerationJob, createGenerationJob, listGenerationJobs, getGenerationJob, } from "./operations.js";
-//# sourceMappingURL=index.js.map

package/dist/browser/api/beta/datasets/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/api/beta/datasets/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nexport {\n  deleteGenerationJob,\n  cancelGenerationJob,\n  createGenerationJob,\n  listGenerationJobs,\n  getGenerationJob,\n} from \"./operations.js\";\nexport type {\n  BetaDatasetsDeleteGenerationJobOptionalParams,\n  BetaDatasetsCancelGenerationJobOptionalParams,\n  BetaDatasetsCreateGenerationJobOptionalParams,\n  BetaDatasetsListGenerationJobsOptionalParams,\n  BetaDatasetsGetGenerationJobOptionalParams,\n} from \"./options.js\";\n"]}