@azure/ai-projects 2.7.1 → 2.9.0

package/dist/react-native/package.json

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

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

@@ -1,9 +1,10 @@
 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";
+import type { ResolvedTracingConfig } from "../tracing/configuration.js";
 /** Known values of {@link VoiceAgentConnectionState} reported by a voice-agent realtime connection. */
 export declare const KnownVoiceAgentConnectionState: {
     readonly Disconnected: "disconnected";
@@ -40,8 +41,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. */
@@ -142,4 +165,6 @@ export declare class VoiceAgentRealtimeClient {
     /** Establishes a WebSocket connection to a managed voice agent. */
     connect(agentName: string, options?: VoiceAgentRealtimeClientConnectOptions): Promise<VoiceAgentConnection>;
 }
+/** Creates the project's realtime client using its already-resolved tracing settings. @internal */
+export declare function createVoiceAgentRealtimeClient(endpoint: string, credential: TokenCredential, options: VoiceAgentRealtimeClientOptions | undefined, tracingConfig: ResolvedTracingConfig | undefined): VoiceAgentRealtimeClient;
 //# sourceMappingURL=voiceAgentRealtimeClient.d.ts.map

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

@@ -6,8 +6,28 @@ import { logger } from "../logger.js";
 import { AsyncQueue } from "./asyncQueue.js";
 import { VoiceAgentAuthenticationError, VoiceAgentConnectionError, VoiceAgentProtocolError, } from "./errors.js";
 import { deserializeVoiceAgentServerEvent, serializeVoiceAgentClientEvent } from "./protocol.js";
+import { VoiceAgentRealtimeTracing } from "../tracing/voiceAgentTracing.js";
+// Project-owned configuration stays private; the standalone constructor/options are unchanged.
+const projectTracingConfigs = new WeakMap();
 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 +60,42 @@ export class VoiceAgentRealtimeClient {
         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;
+        const url = buildWebSocketUrl(normalizeEndpoint(this.endpoint), agentName, this.options.apiVersion, options);
+        const serializedStructuredInputs = options.structuredInputs
+            ? JSON.stringify(options.structuredInputs)
+            : undefined;
+        const tracingConfig = projectTracingConfigs.get(this);
+        const tracing = tracingConfig?.enabled
+            ? new VoiceAgentRealtimeTracing(this.endpoint, tracingConfig, options.transport)
+            : undefined;
+        try {
+            const factory = this.options.webSocketFactory ??
+                (await import("../webSocketTransport.js")).createDefaultVoiceAgentWebSocketFactory();
+            const connection = new VoiceAgentConnectionImpl(url, agentName, this.credential, this.options, options, serializedStructuredInputs, factory, tracing);
+            await connection.open();
+            return connection;
+        }
+        catch (error) {
+            tracing?.close(undefined, false, error);
+            throw error;
+        }
     }
 }
+/** Creates the project's realtime client using its already-resolved tracing settings. @internal */
+export function createVoiceAgentRealtimeClient(endpoint, credential, options, tracingConfig) {
+    const client = new VoiceAgentRealtimeClient(endpoint, credential, options);
+    if (tracingConfig)
+        projectTracingConfigs.set(client, tracingConfig);
+    return client;
+}
 class VoiceAgentConnectionImpl {
-    endpoint;
+    url;
     agentName;
     credential;
     clientOptions;
     connectOptions;
+    serializedStructuredInputs;
+    tracing;
     events;
     transport;
     closePromise;
@@ -60,12 +103,14 @@ 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, tracing) {
+        this.url = url;
         this.agentName = agentName;
         this.credential = credential;
         this.clientOptions = clientOptions;
         this.connectOptions = connectOptions;
+        this.serializedStructuredInputs = serializedStructuredInputs;
+        this.tracing = tracing;
         this.events = new AsyncQueue(10_000, {
             onOverflow: (error) => this.handleEventQueueOverflow(error),
         });
@@ -111,12 +156,13 @@ 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,
             });
+            this.tracing?.opened();
             this.setState(KnownVoiceAgentConnectionState.Connected);
             logger.info("Connected to voice agent", { agentName: this.agentName });
         }
@@ -136,10 +182,15 @@ class VoiceAgentConnectionImpl {
         if (options.abortSignal?.aborted) {
             throw new VoiceAgentConnectionError("Send operation was cancelled.", "operationCancelled");
         }
+        let reservation = undefined;
         try {
-            await this.transport.send(serializeVoiceAgentClientEvent(event), options.abortSignal);
+            const serialized = serializeVoiceAgentClientEvent(event);
+            reservation = this.tracing?.reserveSend(event);
+            await this.transport.send(serialized, options.abortSignal);
+            this.tracing?.sent(event, reservation);
         }
         catch (error) {
+            this.tracing?.sendFailed(error, reservation);
             if (error instanceof VoiceAgentProtocolError) {
                 throw error;
             }
@@ -241,7 +292,9 @@ class VoiceAgentConnectionImpl {
     }
     handleMessage(data) {
         try {
-            this.events.enqueue(deserializeVoiceAgentServerEvent(data));
+            const event = deserializeVoiceAgentServerEvent(data);
+            this.tracing?.received(event);
+            this.events.enqueue(event);
         }
         catch (error) {
             const protocolError = error instanceof VoiceAgentProtocolError
@@ -286,6 +339,7 @@ class VoiceAgentConnectionImpl {
             return;
         }
         this.finished = true;
+        this.tracing?.close(code, wasClean, error);
         if (error) {
             this.events.fail(error);
         }
@@ -335,12 +389,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 +429,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 +445,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\";\nimport type { ResolvedTracingConfig } from \"../tracing/configuration.js\";\nimport { VoiceAgentRealtimeTracing } from \"../tracing/voiceAgentTracing.js\";\n\n// Project-owned configuration stays private; the standalone constructor/options are unchanged.\nconst projectTracingConfigs = new WeakMap<VoiceAgentRealtimeClient, ResolvedTracingConfig>();\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 tracingConfig = projectTracingConfigs.get(this);\n    const tracing = tracingConfig?.enabled\n      ? new VoiceAgentRealtimeTracing(this.endpoint, tracingConfig, options.transport)\n      : undefined;\n    try {\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        tracing,\n      );\n      await connection.open();\n      return connection;\n    } catch (error) {\n      tracing?.close(undefined, false, error);\n      throw error;\n    }\n  }\n}\n\n/** Creates the project's realtime client using its already-resolved tracing settings. @internal */\nexport function createVoiceAgentRealtimeClient(\n  endpoint: string,\n  credential: TokenCredential,\n  options: VoiceAgentRealtimeClientOptions | undefined,\n  tracingConfig: ResolvedTracingConfig | undefined,\n): VoiceAgentRealtimeClient {\n  const client = new VoiceAgentRealtimeClient(endpoint, credential, options);\n  if (tracingConfig) projectTracingConfigs.set(client, tracingConfig);\n  return client;\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    private readonly tracing?: VoiceAgentRealtimeTracing,\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.tracing?.opened();\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    let reservation: ReturnType<VoiceAgentRealtimeTracing[\"reserveSend\"]> = undefined;\n    try {\n      const serialized = serializeVoiceAgentClientEvent(event);\n      reservation = this.tracing?.reserveSend(event);\n      await this.transport.send(serialized, options.abortSignal);\n      this.tracing?.sent(event, reservation);\n    } catch (error) {\n      this.tracing?.sendFailed(error, reservation);\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      const event = deserializeVoiceAgentServerEvent(data);\n      this.tracing?.received(event);\n      this.events.enqueue(event);\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    this.tracing?.close(code, wasClean, error);\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/tracing/configuration.d.ts

@@ -44,14 +44,12 @@ export interface ResolvedTracingConfig {
     traceContextPropagation: boolean;
 }
 /**
- * Resolves tracing options into a frozen config object for the client instance.
+ * Resolves tracing options into a config object for the client instance.
  * For each setting not explicitly provided, the corresponding environment variable
  * is checked. If the env var is also not set, the default value is used.
  *
- * - `enabled`: defaults to `false`. Env var: `AZURE_TRACING_GEN_AI_CONTENT_RECORDING_ENABLED`
- *   is not used for enabled — passing `tracingOptions` (even `{}`) enables tracing.
- *   Env var `AZURE_TRACING_GEN_AI_ENABLE` (accepts `"true"` or `"1"`) enables tracing
- *   when `tracingOptions` is not provided.
+ * - `enabled`: requires options and the experimental gate, resolved from
+ *   `experimental` or `AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING`.
  * - `contentRecording`: defaults to `false`. Env var: `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT`
  * - `traceContextPropagation`: defaults to `true`. Env var: `AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION`
  * @internal

package/dist/react-native/tracing/configuration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../../src/tracing/configuration.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mDAAmD;IACnD,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,qBAAqB,CAyDzF"}
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../../src/tracing/configuration.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mDAAmD;IACnD,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,qBAAqB,CA6DzF"}

package/dist/react-native/tracing/configuration.js

@@ -2,14 +2,12 @@
 // Licensed under the MIT License.
 import { logger } from "../logger.js";
 /**
- * Resolves tracing options into a frozen config object for the client instance.
+ * Resolves tracing options into a config object for the client instance.
  * For each setting not explicitly provided, the corresponding environment variable
  * is checked. If the env var is also not set, the default value is used.
  *
- * - `enabled`: defaults to `false`. Env var: `AZURE_TRACING_GEN_AI_CONTENT_RECORDING_ENABLED`
- *   is not used for enabled — passing `tracingOptions` (even `{}`) enables tracing.
- *   Env var `AZURE_TRACING_GEN_AI_ENABLE` (accepts `"true"` or `"1"`) enables tracing
- *   when `tracingOptions` is not provided.
+ * - `enabled`: requires options and the experimental gate, resolved from
+ *   `experimental` or `AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING`.
  * - `contentRecording`: defaults to `false`. Env var: `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT`
  * - `traceContextPropagation`: defaults to `true`. Env var: `AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION`
  * @internal
@@ -65,6 +63,10 @@ export function resolveTracingConfig(options) {
             logger.verbose(`Unable to read AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION env var: ${e}`);
         }
     }
-    return { enabled, contentRecording, traceContextPropagation };
+    return {
+        enabled,
+        contentRecording,
+        traceContextPropagation,
+    };
 }
 //# sourceMappingURL=configuration.js.map

package/dist/react-native/tracing/configuration.js.map

@@ -1 +1 @@
-{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../../src/tracing/configuration.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAiDtC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA6B;IAChE,yEAAyE;IACzE,IAAI,YAAqB,CAAC;IAC1B,IAAI,OAAO,EAAE,YAAY,KAAK,SAAS,EAAE,CAAC;QACxC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC;YACnE,YAAY,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,OAAO,CACZ,qFAAqF,CAAC,EAAE,CACzF,CAAC;YACF,YAAY,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,KAAK,SAAS,IAAI,YAAY,CAAC;IAEtD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC;IACpF,CAAC;IAED,2BAA2B;IAC3B,IAAI,gBAAyB,CAAC;IAC9B,IAAI,OAAO,EAAE,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC5C,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC;YAC9E,gBAAgB,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC;QACrF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,OAAO,CACZ,8EAA8E,CAAC,EAAE,CAClF,CAAC;YACF,gBAAgB,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,IAAI,uBAAuB,GAAG,IAAI,CAAC;IACnC,IAAI,OAAO,EAAE,uBAAuB,KAAK,SAAS,EAAE,CAAC;QACnD,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC;YACjF,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,OAAO,IAAI,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC;gBACnE,uBAAuB,GAAG,KAAK,CAAC;YAClC,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,OAAO,CACZ,iFAAiF,CAAC,EAAE,CACrF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,CAAC;AAChE,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { logger } from \"../logger.js\";\n\n/**\n * Options for configuring GenAI tracing on a specific AIProjectClient instance.\n *\n * Pass these under the `tracingOptions` key of AIProjectClientOptionalParams\n * to enable GenAI tracing when the client is instantiated. Each client instance\n * maintains its own independent tracing configuration.\n */\nexport interface GenAITracingOptions {\n  /**\n   * Acknowledge that GenAI tracing features are experimental and may change\n   * or be removed in future releases without notice.\n   * When set to `true`, tracing is enabled.\n   * When omitted, the `AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING` environment variable\n   * is checked (accepts `\"true\"` case-insensitive or `\"1\"`). Defaults to `false`.\n   */\n  experimental?: boolean;\n  /**\n   * Whether to capture message content in traces.\n   * Content includes chat messages, function call names, arguments, and return values.\n   * When set to `true` or `false`, that value is used directly.\n   * When omitted, the `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT` environment\n   * variable is checked (accepts `\"true\"` case-insensitive or `\"1\"`). Defaults to `false`.\n   */\n  contentRecording?: boolean;\n  /**\n   * Whether to inject W3C trace context headers (`traceparent`, `tracestate`)\n   * into outgoing OpenAI requests.\n   * When set to `true` or `false`, that value is used directly.\n   * When omitted, the `AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION` environment\n   * variable is checked (accepts `\"true\"` case-insensitive or `\"1\"`). Defaults to `true`.\n   */\n  traceContextPropagation?: boolean;\n}\n\n/**\n * Resolved tracing configuration for a specific client instance.\n * @internal\n */\nexport interface ResolvedTracingConfig {\n  /** Whether tracing is enabled. */\n  enabled: boolean;\n  /** Whether to record content (messages, tool calls, etc.). */\n  contentRecording: boolean;\n  /** Whether to inject W3C trace context headers. */\n  traceContextPropagation: boolean;\n}\n\n/**\n * Resolves tracing options into a frozen config object for the client instance.\n * For each setting not explicitly provided, the corresponding environment variable\n * is checked. If the env var is also not set, the default value is used.\n *\n * - `enabled`: defaults to `false`. Env var: `AZURE_TRACING_GEN_AI_CONTENT_RECORDING_ENABLED`\n *   is not used for enabled — passing `tracingOptions` (even `{}`) enables tracing.\n *   Env var `AZURE_TRACING_GEN_AI_ENABLE` (accepts `\"true\"` or `\"1\"`) enables tracing\n *   when `tracingOptions` is not provided.\n * - `contentRecording`: defaults to `false`. Env var: `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT`\n * - `traceContextPropagation`: defaults to `true`. Env var: `AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION`\n * @internal\n */\nexport function resolveTracingConfig(options?: GenAITracingOptions): ResolvedTracingConfig {\n  // Determine if tracing is enabled — requires experimental acknowledgment\n  let experimental: boolean;\n  if (options?.experimental !== undefined) {\n    experimental = options.experimental;\n  } else {\n    try {\n      const envVal = process.env.AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING;\n      experimental = !!envVal && (envVal.toLowerCase() === \"true\" || envVal === \"1\");\n    } catch (e) {\n      logger.verbose(\n        `Unable to read AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING env var, tracing disabled: ${e}`,\n      );\n      experimental = false;\n    }\n  }\n\n  const enabled = options !== undefined && experimental;\n\n  if (!enabled) {\n    return { enabled: false, contentRecording: false, traceContextPropagation: true };\n  }\n\n  // Resolve contentRecording\n  let contentRecording: boolean;\n  if (options?.contentRecording !== undefined) {\n    contentRecording = options.contentRecording;\n  } else {\n    try {\n      const envVal = process.env.OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT;\n      contentRecording = !!envVal && (envVal.toLowerCase() === \"true\" || envVal === \"1\");\n    } catch (e) {\n      logger.verbose(\n        `Unable to read OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT env var: ${e}`,\n      );\n      contentRecording = false;\n    }\n  }\n\n  // Resolve traceContextPropagation\n  let traceContextPropagation = true;\n  if (options?.traceContextPropagation !== undefined) {\n    traceContextPropagation = options.traceContextPropagation;\n  } else {\n    try {\n      const envVal = process.env.AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION;\n      if (envVal && (envVal.toLowerCase() === \"false\" || envVal === \"0\")) {\n        traceContextPropagation = false;\n      }\n    } catch (e) {\n      logger.verbose(\n        `Unable to read AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION env var: ${e}`,\n      );\n    }\n  }\n\n  return { enabled, contentRecording, traceContextPropagation };\n}\n"]}
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../../src/tracing/configuration.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAiDtC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA6B;IAChE,yEAAyE;IACzE,IAAI,YAAqB,CAAC;IAC1B,IAAI,OAAO,EAAE,YAAY,KAAK,SAAS,EAAE,CAAC;QACxC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC;YACnE,YAAY,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,OAAO,CACZ,qFAAqF,CAAC,EAAE,CACzF,CAAC;YACF,YAAY,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,KAAK,SAAS,IAAI,YAAY,CAAC;IAEtD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,CAAC;IACpF,CAAC;IAED,2BAA2B;IAC3B,IAAI,gBAAyB,CAAC;IAC9B,IAAI,OAAO,EAAE,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC5C,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC;YAC9E,gBAAgB,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC;QACrF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,OAAO,CACZ,8EAA8E,CAAC,EAAE,CAClF,CAAC;YACF,gBAAgB,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,IAAI,uBAAuB,GAAG,IAAI,CAAC;IACnC,IAAI,OAAO,EAAE,uBAAuB,KAAK,SAAS,EAAE,CAAC;QACnD,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC;YACjF,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,OAAO,IAAI,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC;gBACnE,uBAAuB,GAAG,KAAK,CAAC;YAClC,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,OAAO,CACZ,iFAAiF,CAAC,EAAE,CACrF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO;QACP,gBAAgB;QAChB,uBAAuB;KACxB,CAAC;AACJ,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { logger } from \"../logger.js\";\n\n/**\n * Options for configuring GenAI tracing on a specific AIProjectClient instance.\n *\n * Pass these under the `tracingOptions` key of AIProjectClientOptionalParams\n * to enable GenAI tracing when the client is instantiated. Each client instance\n * maintains its own independent tracing configuration.\n */\nexport interface GenAITracingOptions {\n  /**\n   * Acknowledge that GenAI tracing features are experimental and may change\n   * or be removed in future releases without notice.\n   * When set to `true`, tracing is enabled.\n   * When omitted, the `AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING` environment variable\n   * is checked (accepts `\"true\"` case-insensitive or `\"1\"`). Defaults to `false`.\n   */\n  experimental?: boolean;\n  /**\n   * Whether to capture message content in traces.\n   * Content includes chat messages, function call names, arguments, and return values.\n   * When set to `true` or `false`, that value is used directly.\n   * When omitted, the `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT` environment\n   * variable is checked (accepts `\"true\"` case-insensitive or `\"1\"`). Defaults to `false`.\n   */\n  contentRecording?: boolean;\n  /**\n   * Whether to inject W3C trace context headers (`traceparent`, `tracestate`)\n   * into outgoing OpenAI requests.\n   * When set to `true` or `false`, that value is used directly.\n   * When omitted, the `AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION` environment\n   * variable is checked (accepts `\"true\"` case-insensitive or `\"1\"`). Defaults to `true`.\n   */\n  traceContextPropagation?: boolean;\n}\n\n/**\n * Resolved tracing configuration for a specific client instance.\n * @internal\n */\nexport interface ResolvedTracingConfig {\n  /** Whether tracing is enabled. */\n  enabled: boolean;\n  /** Whether to record content (messages, tool calls, etc.). */\n  contentRecording: boolean;\n  /** Whether to inject W3C trace context headers. */\n  traceContextPropagation: boolean;\n}\n\n/**\n * Resolves tracing options into a config object for the client instance.\n * For each setting not explicitly provided, the corresponding environment variable\n * is checked. If the env var is also not set, the default value is used.\n *\n * - `enabled`: requires options and the experimental gate, resolved from\n *   `experimental` or `AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING`.\n * - `contentRecording`: defaults to `false`. Env var: `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT`\n * - `traceContextPropagation`: defaults to `true`. Env var: `AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION`\n * @internal\n */\nexport function resolveTracingConfig(options?: GenAITracingOptions): ResolvedTracingConfig {\n  // Determine if tracing is enabled — requires experimental acknowledgment\n  let experimental: boolean;\n  if (options?.experimental !== undefined) {\n    experimental = options.experimental;\n  } else {\n    try {\n      const envVal = process.env.AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING;\n      experimental = !!envVal && (envVal.toLowerCase() === \"true\" || envVal === \"1\");\n    } catch (e) {\n      logger.verbose(\n        `Unable to read AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING env var, tracing disabled: ${e}`,\n      );\n      experimental = false;\n    }\n  }\n\n  const enabled = options !== undefined && experimental;\n\n  if (!enabled) {\n    return { enabled: false, contentRecording: false, traceContextPropagation: true };\n  }\n\n  // Resolve contentRecording\n  let contentRecording: boolean;\n  if (options?.contentRecording !== undefined) {\n    contentRecording = options.contentRecording;\n  } else {\n    try {\n      const envVal = process.env.OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT;\n      contentRecording = !!envVal && (envVal.toLowerCase() === \"true\" || envVal === \"1\");\n    } catch (e) {\n      logger.verbose(\n        `Unable to read OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT env var: ${e}`,\n      );\n      contentRecording = false;\n    }\n  }\n\n  // Resolve traceContextPropagation\n  let traceContextPropagation = true;\n  if (options?.traceContextPropagation !== undefined) {\n    traceContextPropagation = options.traceContextPropagation;\n  } else {\n    try {\n      const envVal = process.env.AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION;\n      if (envVal && (envVal.toLowerCase() === \"false\" || envVal === \"0\")) {\n        traceContextPropagation = false;\n      }\n    } catch (e) {\n      logger.verbose(\n        `Unable to read AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION env var: ${e}`,\n      );\n    }\n  }\n\n  return {\n    enabled,\n    contentRecording,\n    traceContextPropagation,\n  };\n}\n"]}

package/dist/react-native/tracing/tracingClient.d.ts

@@ -8,7 +8,7 @@ export interface StartSpanResult {
 /**
  * Starts a new client span using the global OTel TracerProvider.
  */
-export declare function startSpan(name: string): StartSpanResult;
+export declare function startSpan(name: string, parentContext?: Context): StartSpanResult;
 /**
  * Injects trace context headers (traceparent/tracestate) for the current active span.
  */

package/dist/react-native/tracing/tracingClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracingClient.d.ts","sourceRoot":"","sources":["../../../src/tracing/tracingClient.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGxD,YAAY,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAMvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEhE"}
+{"version":3,"file":"tracingClient.d.ts","sourceRoot":"","sources":["../../../src/tracing/tracingClient.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGxD,YAAY,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,aAAa,GAAE,OAA0B,GACxC,eAAe,CAMjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEhE"}

package/dist/react-native/tracing/tracingClient.js

@@ -11,9 +11,9 @@ export { SpanStatusCode } from "@opentelemetry/api";
 /**
  * Starts a new client span using the global OTel TracerProvider.
  */
-export function startSpan(name) {
+export function startSpan(name, parentContext = context.active()) {
     const tracer = trace.getTracer(PACKAGE_NAME, SDK_VERSION);
-    const ctx = context.active();
+    const ctx = parentContext;
     const span = tracer.startSpan(name, { kind: SpanKind.CLIENT }, ctx);
     const spanCtx = trace.setSpan(ctx, span);
     return { span, ctx: spanCtx };