@azure/ai-projects 2.7.1 → 2.9.0

package/dist/commonjs/package.json

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

package/dist/commonjs/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/commonjs/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/commonjs/realtime/voiceAgentRealtimeClient.js

@@ -28,7 +28,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var voiceAgentRealtimeClient_exports = {};
 __export(voiceAgentRealtimeClient_exports, {
   KnownVoiceAgentConnectionState: () => KnownVoiceAgentConnectionState,
-  VoiceAgentRealtimeClient: () => VoiceAgentRealtimeClient
+  VoiceAgentRealtimeClient: () => VoiceAgentRealtimeClient,
+  createVoiceAgentRealtimeClient: () => createVoiceAgentRealtimeClient
 });
 module.exports = __toCommonJS(voiceAgentRealtimeClient_exports);
 var import_core_util = require("@azure/core-util");
@@ -37,8 +38,27 @@ var import_logger = require("../logger.js");
 var import_asyncQueue = require("./asyncQueue.js");
 var import_errors = require("./errors.js");
 var import_protocol = require("./protocol.js");
+var import_voiceAgentTracing = require("../tracing/voiceAgentTracing.js");
+const projectTracingConfigs = /* @__PURE__ */ new WeakMap();
 const defaultCredentialScope = "https://ai.azure.com/.default";
 const voiceAgentsPreview = "VoiceAgents=V1Preview";
+const reservedQueryParameters = /* @__PURE__ */ 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"
+]);
 const KnownVoiceAgentConnectionState = {
   Disconnected: "disconnected",
   Connecting: "connecting",
@@ -66,26 +86,49 @@ 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(
+    const url = buildWebSocketUrl(
       normalizeEndpoint(this.endpoint),
       agentName,
-      this.credential,
-      this.options,
-      options,
-      factory
+      this.options.apiVersion,
+      options
     );
-    await connection.open();
-    return connection;
+    const serializedStructuredInputs = options.structuredInputs ? JSON.stringify(options.structuredInputs) : void 0;
+    const tracingConfig = projectTracingConfigs.get(this);
+    const tracing = tracingConfig?.enabled ? new import_voiceAgentTracing.VoiceAgentRealtimeTracing(this.endpoint, tracingConfig, options.transport) : void 0;
+    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(void 0, false, error);
+      throw error;
+    }
   }
 }
+function createVoiceAgentRealtimeClient(endpoint, credential, options, tracingConfig) {
+  const client = new VoiceAgentRealtimeClient(endpoint, credential, options);
+  if (tracingConfig) projectTracingConfigs.set(client, tracingConfig);
+  return client;
+}
 class VoiceAgentConnectionImpl {
-  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 import_asyncQueue.AsyncQueue(1e4, {
       onOverflow: (error) => this.handleEventQueueOverflow(error)
     });
@@ -99,11 +142,13 @@ class VoiceAgentConnectionImpl {
       onError: (error) => this.handleTransportError(error)
     });
   }
-  endpoint;
+  url;
   agentName;
   credential;
   clientOptions;
   connectOptions;
+  serializedStructuredInputs;
+  tracing;
   events;
   transport;
   closePromise;
@@ -147,17 +192,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);
       import_logger.logger.info("Connected to voice agent", { agentName: this.agentName });
     } catch (error) {
@@ -181,9 +222,14 @@ class VoiceAgentConnectionImpl {
     if (options.abortSignal?.aborted) {
       throw new import_errors.VoiceAgentConnectionError("Send operation was cancelled.", "operationCancelled");
     }
+    let reservation = void 0;
     try {
-      await this.transport.send((0, import_protocol.serializeVoiceAgentClientEvent)(event), options.abortSignal);
+      const serialized = (0, import_protocol.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 import_errors.VoiceAgentProtocolError) {
         throw error;
       }
@@ -306,7 +352,9 @@ class VoiceAgentConnectionImpl {
   }
   handleMessage(data) {
     try {
-      this.events.enqueue((0, import_protocol.deserializeVoiceAgentServerEvent)(data));
+      const event = (0, import_protocol.deserializeVoiceAgentServerEvent)(data);
+      this.tracing?.received(event);
+      this.events.enqueue(event);
     } catch (error) {
       const protocolError = error instanceof import_errors.VoiceAgentProtocolError ? error : new import_errors.VoiceAgentProtocolError("Failed to process a voice-agent event.", { cause: error });
       this.finish(1002, protocolError.message, false, protocolError);
@@ -354,6 +402,7 @@ class VoiceAgentConnectionImpl {
       return;
     }
     this.finished = true;
+    this.tracing?.close(code, wasClean, error);
     if (error) {
       this.events.fail(error);
     } else {
@@ -399,12 +448,30 @@ function normalizeEndpoint(endpoint) {
       "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 !== void 0 && (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 === void 0) {
+      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/${import_constants.SDK_VERSION}`);
   if (options.agentSessionId) {
@@ -416,9 +483,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/${import_constants.SDK_VERSION}`;
   const headers = {
     authorization: `Bearer ${token}`,
@@ -427,8 +497,8 @@ function buildHeaders(token, clientOptions, connectOptions) {
     "x-ms-client-sdk": sdkUserAgent,
     "user-agent": clientOptions.userAgentPrefix ? `${clientOptions.userAgentPrefix} ${sdkUserAgent}` : sdkUserAgent
   };
-  if (connectOptions.structuredInputs) {
-    headers["x-ms-voice-structured-inputs"] = JSON.stringify(connectOptions.structuredInputs);
+  if (serializedStructuredInputs !== void 0) {
+    headers["x-ms-voice-structured-inputs"] = serializedStructuredInputs;
   }
   return headers;
 }
@@ -438,6 +508,7 @@ function createRequestId() {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   KnownVoiceAgentConnectionState,
-  VoiceAgentRealtimeClient
+  VoiceAgentRealtimeClient,
+  createVoiceAgentRealtimeClient
 });
 //# sourceMappingURL=voiceAgentRealtimeClient.js.map

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/realtime/voiceAgentRealtimeClient.ts"],
-  "sourcesContent": ["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport type { TokenCredential } from \"@azure/core-auth\";\nimport type { OperationOptions } from \"@azure-rest/core-client\";\nimport { uint8ArrayToString } from \"@azure/core-util\";\nimport { SDK_VERSION } from \"../constants.js\";\nimport type {\n  RealtimeConversationItemUnion,\n  VoiceAgentClientEvent,\n  VoiceAgentResponseCreateParams,\n  VoiceAgentSessionUpdateConfig,\n} from \"../models/models.js\";\nimport { logger } from \"../logger.js\";\nimport { AsyncQueue } from \"./asyncQueue.js\";\nimport {\n  VoiceAgentAuthenticationError,\n  VoiceAgentConnectionError,\n  VoiceAgentProtocolError,\n} from \"./errors.js\";\nimport { deserializeVoiceAgentServerEvent, serializeVoiceAgentClientEvent } from \"./protocol.js\";\nimport type { VoiceAgentRealtimeEvent } from \"./events.js\";\nimport type {\n  VoiceAgentWebSocketFactory,\n  VoiceAgentWebSocketTransport,\n} from \"./webSocketTransportLike.js\";\n\nconst defaultCredentialScope = \"https://ai.azure.com/.default\";\nconst voiceAgentsPreview = \"VoiceAgents=V1Preview\";\n\n/** Known values of {@link VoiceAgentConnectionState} reported by a voice-agent realtime connection. */\nexport const KnownVoiceAgentConnectionState = {\n  Disconnected: \"disconnected\",\n  Connecting: \"connecting\",\n  Connected: \"connected\",\n  Closing: \"closing\",\n} as const;\n\n/** Connection states reported by a voice-agent realtime connection. */\nexport type VoiceAgentConnectionState =\n  (typeof KnownVoiceAgentConnectionState)[keyof typeof KnownVoiceAgentConnectionState];\n\n/** Called when a voice-agent connection changes state. */\nexport type VoiceAgentConnectionStateChangedHandler = (\n  state: VoiceAgentConnectionState,\n  previousState: VoiceAgentConnectionState,\n) => void;\n\n/** Options for the Voice Agents realtime client. */\nexport interface VoiceAgentRealtimeClientOptions {\n  /** Microsoft Entra scopes used to acquire a WebSocket access token. */\n  credentialScopes?: string | string[];\n  /** Default connection timeout in milliseconds. */\n  connectionTimeoutInMs?: number;\n  /** API version sent during the WebSocket upgrade. */\n  apiVersion?: string;\n  /** Prefix added to the SDK user-agent value in Node.js. */\n  userAgentPrefix?: string;\n  /**\n   * Overrides the transport used to establish the realtime WebSocket connection. Defaults to the\n   * platform transport (`ws` in Node.js, the browser's native `WebSocket` in browsers/React Native).\n   * Provide a custom factory to customize connection establishment.\n   */\n  webSocketFactory?: VoiceAgentWebSocketFactory;\n}\n\n/** Options for connecting the realtime client to a voice agent. */\nexport interface VoiceAgentRealtimeClientConnectOptions extends OperationOptions {\n  /** Identifier used to correlate the voice session. */\n  agentSessionId?: string;\n  /** Overrides whether the conversation created by this session is persisted. */\n  store?: boolean;\n  /** Selects a specific immutable agent version. */\n  agentVersionOverride?: string;\n  /** Values used to render the agent's structured prompt inputs. */\n  structuredInputs?: Record<string, unknown>;\n  /** Overrides the client connection timeout in milliseconds. */\n  connectionTimeoutInMs?: number;\n  /** Cancels the connection attempt. */\n  abortSignal?: AbortSignalLike;\n  /** Receives connection-state transitions. */\n  onConnectionStateChange?: VoiceAgentConnectionStateChangedHandler;\n}\n\n/** Result supplied when a voice-agent connection closes. */\nexport interface VoiceAgentCloseResult {\n  /** WebSocket close code. */\n  code: number;\n  /** WebSocket close reason. */\n  reason: string;\n  /** Whether the peer completed a normal WebSocket close handshake. */\n  wasClean: boolean;\n  /** Transport or protocol error associated with the close, if any. */\n  error?: Error;\n}\n\n/** Options shared by realtime send operations. */\nexport interface VoiceAgentSendOptions extends OperationOptions {}\n\n/** Options shared by operations that build a protocol event on the caller's behalf. */\nexport interface VoiceAgentEventOptions extends VoiceAgentSendOptions {\n  /** Client-generated event identifier. */\n  eventId?: string;\n}\n\n/** Options shared by operations that add a conversation item and, by default, request a response. */\nexport interface VoiceAgentSendItemOptions extends VoiceAgentEventOptions {\n  /** Whether to request a response after adding the item. Defaults to true. */\n  createResponse?: boolean;\n}\n\n/** Options for sending text input. */\nexport interface VoiceAgentSendTextOptions extends VoiceAgentSendItemOptions {\n  /** Item after which the new text item is inserted. */\n  previousItemId?: string;\n}\n\n/** Options for returning a function result. */\nexport interface VoiceAgentSendToolOutputOptions extends VoiceAgentSendItemOptions {}\n\n/** Options for updating the live session. */\nexport interface VoiceAgentSessionUpdateOptions extends VoiceAgentEventOptions {}\n\n/** Options for creating a response. */\nexport interface VoiceAgentResponseOptions extends VoiceAgentEventOptions {\n  /** Response-specific configuration. */\n  response?: VoiceAgentResponseCreateParams;\n}\n\n/** Options for cancelling a response. */\nexport interface VoiceAgentCancelResponseOptions extends VoiceAgentEventOptions {\n  /** Specific response to cancel. The active default-conversation response is used when omitted. */\n  responseId?: string;\n}\n\n/**\n * A connected, bidirectional voice-agent stream.\n *\n * Supports exactly one `for await` iteration over server events; a second attempt throws.\n * Exiting the loop early (`break`, `return`, or an uncaught error in the loop body) closes\n * the connection as a side effect.\n * Unrecognized server event types are delivered as {@link VoiceAgentUnknownEvent} without\n * interrupting the stream. Malformed events still fail the iteration with a protocol error.\n */\nexport interface VoiceAgentConnection extends AsyncIterable<VoiceAgentRealtimeEvent> {\n  /** Current connection state. */\n  readonly state: VoiceAgentConnectionState;\n  /** Resolves once the connection is closed. */\n  readonly closed: Promise<VoiceAgentCloseResult>;\n  /** Sends any generated client protocol event. */\n  sendEvent(event: VoiceAgentClientEvent, options?: VoiceAgentSendOptions): Promise<void>;\n  /** Updates supported live-session settings. */\n  configureSession(\n    session: VoiceAgentSessionUpdateConfig,\n    options?: VoiceAgentSessionUpdateOptions,\n  ): Promise<void>;\n  /** Adds a user text item and, by default, requests a response. */\n  sendText(text: string, options?: VoiceAgentSendTextOptions): Promise<void>;\n  /** Appends base64-encoded audio bytes to the input buffer. */\n  sendAudio(audio: Uint8Array | ArrayBuffer, options?: VoiceAgentEventOptions): Promise<void>;\n  /** Commits buffered input audio. */\n  commitAudio(options?: VoiceAgentEventOptions): Promise<void>;\n  /** Clears buffered input audio. */\n  clearInputAudio(options?: VoiceAgentEventOptions): Promise<void>;\n  /** Clears pending output audio at the service. */\n  clearOutputAudio(options?: VoiceAgentEventOptions): Promise<void>;\n  /** Returns a client-executed function result to the agent. */\n  sendToolOutput(\n    callId: string,\n    output: string,\n    options?: VoiceAgentSendToolOutputOptions,\n  ): Promise<void>;\n  /** Requests a new response. */\n  requestResponse(options?: VoiceAgentResponseOptions): Promise<void>;\n  /** Cancels an in-progress response. */\n  cancelResponse(options?: VoiceAgentCancelResponseOptions): Promise<void>;\n  /** Gracefully closes the WebSocket connection. */\n  close(code?: number, reason?: string): Promise<void>;\n  /** Releases the connection. Equivalent to close(). */\n  dispose(): Promise<void>;\n}\n\n/** Client for establishing realtime sessions with managed Foundry voice agents. */\nexport class VoiceAgentRealtimeClient {\n  private readonly endpoint: string;\n  private readonly credential: TokenCredential;\n  private readonly options: Required<\n    Pick<VoiceAgentRealtimeClientOptions, \"connectionTimeoutInMs\" | \"apiVersion\">\n  > &\n    VoiceAgentRealtimeClientOptions;\n\n  public constructor(\n    endpoint: string,\n    credential: TokenCredential,\n    options: VoiceAgentRealtimeClientOptions = {},\n  ) {\n    // Endpoint validation (https-only) is deferred to connect() so that merely constructing an\n    // AIProjectClient (which eagerly creates this client) doesn't reject callers who intentionally\n    // use an insecure local endpoint for the REST surface and never touch realtime connections.\n    if (!endpoint.trim()) {\n      throw new TypeError(\"endpoint must not be empty.\");\n    }\n    this.endpoint = endpoint;\n    this.credential = credential;\n    this.options = {\n      ...options,\n      connectionTimeoutInMs: options.connectionTimeoutInMs ?? 30_000,\n      apiVersion: options.apiVersion ?? \"v1\",\n    };\n  }\n\n  /** Establishes a WebSocket connection to a managed voice agent. */\n  public async connect(\n    agentName: string,\n    options: VoiceAgentRealtimeClientConnectOptions = {},\n  ): Promise<VoiceAgentConnection> {\n    if (!agentName.trim()) {\n      throw new TypeError(\"agentName must not be empty.\");\n    }\n    const factory =\n      this.options.webSocketFactory ??\n      (await import(\"#platform/webSocketTransport\")).createDefaultVoiceAgentWebSocketFactory();\n    const connection = new VoiceAgentConnectionImpl(\n      normalizeEndpoint(this.endpoint),\n      agentName,\n      this.credential,\n      this.options,\n      options,\n      factory,\n    );\n    await connection.open();\n    return connection;\n  }\n}\n\nclass VoiceAgentConnectionImpl implements VoiceAgentConnection {\n  private readonly events: AsyncQueue<VoiceAgentRealtimeEvent>;\n  private readonly transport: VoiceAgentWebSocketTransport;\n  private readonly closePromise: Promise<VoiceAgentCloseResult>;\n  private resolveClose!: (result: VoiceAgentCloseResult) => void;\n  private currentState: VoiceAgentConnectionState = KnownVoiceAgentConnectionState.Disconnected;\n  private iteratorStarted = false;\n  private finished = false;\n\n  public constructor(\n    private readonly endpoint: string,\n    private readonly agentName: string,\n    private readonly credential: TokenCredential,\n    private readonly clientOptions: VoiceAgentRealtimeClientOptions & {\n      connectionTimeoutInMs: number;\n      apiVersion: string;\n    },\n    private readonly connectOptions: VoiceAgentRealtimeClientConnectOptions,\n    factory: VoiceAgentWebSocketFactory,\n  ) {\n    this.events = new AsyncQueue<VoiceAgentRealtimeEvent>(10_000, {\n      onOverflow: (error) => this.handleEventQueueOverflow(error),\n    });\n    this.transport = factory.create();\n    this.closePromise = new Promise<VoiceAgentCloseResult>((resolve) => {\n      this.resolveClose = resolve;\n    });\n    this.transport.setHandlers({\n      onMessage: (data) => this.handleMessage(data),\n      onClose: (code, reason, wasClean) => this.handleClose(code, reason, wasClean),\n      onError: (error) => this.handleTransportError(error),\n    });\n  }\n\n  public get state(): VoiceAgentConnectionState {\n    return this.currentState;\n  }\n\n  public get closed(): Promise<VoiceAgentCloseResult> {\n    return this.closePromise;\n  }\n\n  public async open(): Promise<void> {\n    this.setState(KnownVoiceAgentConnectionState.Connecting);\n    let token: string;\n    try {\n      const accessToken = await this.credential.getToken(\n        this.clientOptions.credentialScopes ?? defaultCredentialScope,\n        { abortSignal: this.connectOptions.abortSignal },\n      );\n      if (!accessToken) {\n        throw new VoiceAgentAuthenticationError(\"The credential returned no access token.\");\n      }\n      token = accessToken.token;\n    } catch (error) {\n      if (this.connectOptions.abortSignal?.aborted) {\n        const cancelledError = new VoiceAgentConnectionError(\n          \"Voice-agent connection was cancelled.\",\n          \"operationCancelled\",\n          { cause: error },\n        );\n        this.finish(1006, cancelledError.message, false, cancelledError);\n        throw cancelledError;\n      }\n      const authenticationError =\n        error instanceof VoiceAgentAuthenticationError\n          ? error\n          : new VoiceAgentAuthenticationError(\"Failed to acquire a Voice Agents access token.\", {\n              cause: error,\n            });\n      this.finish(1006, authenticationError.message, false, authenticationError);\n      throw authenticationError;\n    }\n\n    try {\n      await this.transport.connect({\n        url: buildWebSocketUrl(\n          this.endpoint,\n          this.agentName,\n          this.clientOptions.apiVersion,\n          this.connectOptions,\n        ),\n        protocols: [\"realtime\"],\n        headers: buildHeaders(token, this.clientOptions, this.connectOptions),\n        connectionTimeoutInMs:\n          this.connectOptions.connectionTimeoutInMs ?? this.clientOptions.connectionTimeoutInMs,\n        abortSignal: this.connectOptions.abortSignal,\n      });\n      this.setState(KnownVoiceAgentConnectionState.Connected);\n      logger.info(\"Connected to voice agent\", { agentName: this.agentName });\n    } catch (error) {\n      const cancelled = this.connectOptions.abortSignal?.aborted === true;\n      const connectionError = new VoiceAgentConnectionError(\n        cancelled\n          ? \"Voice-agent connection was cancelled.\"\n          : \"Failed to connect to the voice agent.\",\n        cancelled ? \"operationCancelled\" : \"connectionFailed\",\n        { cause: error },\n      );\n      this.finish(1006, connectionError.message, false, connectionError);\n      throw connectionError;\n    }\n  }\n\n  public async sendEvent(\n    event: VoiceAgentClientEvent,\n    options: VoiceAgentSendOptions = {},\n  ): Promise<void> {\n    if (this.state !== KnownVoiceAgentConnectionState.Connected) {\n      throw new VoiceAgentConnectionError(\n        `Cannot send while the connection is ${this.state}.`,\n        \"invalidState\",\n      );\n    }\n    if (options.abortSignal?.aborted) {\n      throw new VoiceAgentConnectionError(\"Send operation was cancelled.\", \"operationCancelled\");\n    }\n\n    try {\n      await this.transport.send(serializeVoiceAgentClientEvent(event), options.abortSignal);\n    } catch (error) {\n      if (error instanceof VoiceAgentProtocolError) {\n        throw error;\n      }\n      throw new VoiceAgentConnectionError(\"Failed to send a voice-agent event.\", \"sendFailed\", {\n        cause: error,\n      });\n    }\n  }\n\n  public configureSession(\n    session: VoiceAgentSessionUpdateConfig,\n    options: VoiceAgentSessionUpdateOptions = {},\n  ): Promise<void> {\n    return this.sendEvent({ type: \"session.update\", event_id: options.eventId, session }, options);\n  }\n\n  public async sendText(text: string, options: VoiceAgentSendTextOptions = {}): Promise<void> {\n    await this.sendEvent(\n      {\n        type: \"conversation.item.create\",\n        event_id: options.eventId,\n        previous_item_id: options.previousItemId,\n        // `RealtimeConversationItemUnion` no longer enumerates a \"message\" item in the generated\n        // models, but the wire protocol still accepts this shape; see the TypeSpec regeneration\n        // report for details.\n        item: {\n          type: \"message\",\n          role: \"user\",\n          content: [{ type: \"input_text\", text }],\n        } as unknown as RealtimeConversationItemUnion,\n      },\n      options,\n    );\n    if (options.createResponse !== false) {\n      await this.requestResponse({ abortSignal: options.abortSignal });\n    }\n  }\n\n  public sendAudio(\n    audio: Uint8Array | ArrayBuffer,\n    options: VoiceAgentEventOptions = {},\n  ): Promise<void> {\n    const bytes = audio instanceof Uint8Array ? audio : new Uint8Array(audio);\n    return this.sendEvent(\n      {\n        type: \"input_audio_buffer.append\",\n        event_id: options.eventId,\n        audio: uint8ArrayToString(bytes, \"base64\"),\n      },\n      options,\n    );\n  }\n\n  public commitAudio(options: VoiceAgentEventOptions = {}): Promise<void> {\n    return this.sendEvent(\n      { type: \"input_audio_buffer.commit\", event_id: options.eventId },\n      options,\n    );\n  }\n\n  public clearInputAudio(options: VoiceAgentEventOptions = {}): Promise<void> {\n    return this.sendEvent({ type: \"input_audio_buffer.clear\", event_id: options.eventId }, options);\n  }\n\n  public clearOutputAudio(options: VoiceAgentEventOptions = {}): Promise<void> {\n    return this.sendEvent(\n      { type: \"output_audio_buffer.clear\", event_id: options.eventId },\n      options,\n    );\n  }\n\n  public async sendToolOutput(\n    callId: string,\n    output: string,\n    options: VoiceAgentSendToolOutputOptions = {},\n  ): Promise<void> {\n    await this.sendEvent(\n      {\n        type: \"conversation.item.create\",\n        event_id: options.eventId,\n        item: { type: \"function_call_output\", call_id: callId, output },\n      },\n      options,\n    );\n    if (options.createResponse !== false) {\n      await this.requestResponse({ abortSignal: options.abortSignal });\n    }\n  }\n\n  public requestResponse(options: VoiceAgentResponseOptions = {}): Promise<void> {\n    return this.sendEvent(\n      { type: \"response.create\", event_id: options.eventId, response: options.response },\n      options,\n    );\n  }\n\n  public cancelResponse(options: VoiceAgentCancelResponseOptions = {}): Promise<void> {\n    return this.sendEvent(\n      { type: \"response.cancel\", event_id: options.eventId, response_id: options.responseId },\n      options,\n    );\n  }\n\n  public async close(\n    code = 1000,\n    reason = \"Client closed the voice-agent connection.\",\n  ): Promise<void> {\n    if (\n      this.state === KnownVoiceAgentConnectionState.Disconnected ||\n      this.state === KnownVoiceAgentConnectionState.Closing\n    ) {\n      await this.closed;\n      return;\n    }\n    this.setState(KnownVoiceAgentConnectionState.Closing);\n    try {\n      await this.transport.close(code, reason);\n    } finally {\n      this.finish(code, reason, false);\n    }\n  }\n\n  public dispose(): Promise<void> {\n    return this.close();\n  }\n\n  public async *[Symbol.asyncIterator](): AsyncIterator<VoiceAgentRealtimeEvent> {\n    if (this.iteratorStarted) {\n      throw new VoiceAgentConnectionError(\n        \"A voice-agent connection supports one active event iterator.\",\n        \"invalidState\",\n      );\n    }\n    this.iteratorStarted = true;\n    try {\n      while (true) {\n        const result = await this.events.next();\n        if (result.done) {\n          return;\n        }\n        yield result.value;\n      }\n    } finally {\n      if (this.state === KnownVoiceAgentConnectionState.Connected) {\n        await this.close();\n      }\n    }\n  }\n\n  private handleMessage(data: string | ArrayBuffer): void {\n    try {\n      this.events.enqueue(deserializeVoiceAgentServerEvent(data));\n    } catch (error) {\n      const protocolError =\n        error instanceof VoiceAgentProtocolError\n          ? error\n          : new VoiceAgentProtocolError(\"Failed to process a voice-agent event.\", { cause: error });\n      // finish() closes the transport itself, so no additional close is needed here.\n      this.finish(1002, protocolError.message, false, protocolError);\n    }\n  }\n\n  private handleEventQueueOverflow(cause: Error): void {\n    if (this.finished) {\n      return;\n    }\n    const error = new VoiceAgentConnectionError(cause.message, \"connectionClosed\", {\n      cause,\n    });\n    this.finish(1006, error.message, false, error);\n  }\n\n  private handleClose(code: number, reason: string, wasClean: boolean): void {\n    if (this.finished) {\n      return;\n    }\n    if (wasClean || this.state === KnownVoiceAgentConnectionState.Closing) {\n      this.finish(code, reason, wasClean);\n    } else {\n      const error = new VoiceAgentConnectionError(\n        `Voice-agent connection closed unexpectedly (${code}${reason ? `: ${reason}` : \"\"}).`,\n        \"connectionClosed\",\n        { closeCode: code },\n      );\n      this.finish(code, reason, false, error);\n    }\n  }\n\n  private handleTransportError(cause: Error): void {\n    if (this.finished) {\n      return;\n    }\n    const error = new VoiceAgentConnectionError(\n      \"Voice-agent WebSocket transport failed.\",\n      \"connectionClosed\",\n      {\n        cause,\n      },\n    );\n    this.finish(1006, cause.message, false, error);\n  }\n\n  private finish(code: number, reason: string, wasClean: boolean, error?: Error): void {\n    if (this.finished) {\n      return;\n    }\n    this.finished = true;\n    if (error) {\n      this.events.fail(error);\n    } else {\n      this.events.close();\n    }\n    this.setState(KnownVoiceAgentConnectionState.Disconnected);\n    this.resolveClose({ code, reason, wasClean, error });\n    logger.info(\"Voice-agent connection closed\", { code, reason, wasClean });\n    // Ensure the socket never outlives the connection, even on paths that never closed it\n    // themselves. Not awaited: finish() is synchronous because its callers are.\n    void this.closeTransportQuietly(code, reason);\n  }\n\n  /**\n   * Closes the transport, logging rather than rejecting: this is best-effort cleanup running after\n   * the connection has already settled. A no-op if the transport is already closed.\n   */\n  private async closeTransportQuietly(code: number, reason: string): Promise<void> {\n    try {\n      await this.transport.close(code, reason);\n    } catch (error) {\n      logger.warning(\"Failed to close the voice-agent transport\", { error });\n    }\n  }\n\n  private setState(state: VoiceAgentConnectionState): void {\n    if (state === this.currentState) {\n      return;\n    }\n    const previousState = this.currentState;\n    this.currentState = state;\n    try {\n      this.connectOptions.onConnectionStateChange?.(state, previousState);\n    } catch (error) {\n      // A throwing caller callback must never interrupt connection lifecycle/cleanup.\n      logger.warning(\"onConnectionStateChange callback threw an error\", { error });\n    }\n  }\n}\n\nfunction normalizeEndpoint(endpoint: string): string {\n  const normalized = endpoint.trim();\n  if (!normalized) {\n    throw new TypeError(\"endpoint must not be empty.\");\n  }\n  const url = new URL(normalized.includes(\"://\") ? normalized : `https://${normalized}`);\n  if (url.protocol !== \"https:\") {\n    throw new TypeError(\n      \"endpoint must use https; a plaintext endpoint would send the bearer token over an unencrypted connection.\",\n    );\n  }\n  return url.toString().replace(/\\/$/, \"\");\n}\n\nfunction buildWebSocketUrl(\n  endpoint: string,\n  agentName: string,\n  apiVersion: string,\n  options: VoiceAgentRealtimeClientConnectOptions,\n): string {\n  const url = new URL(endpoint);\n  url.protocol = \"wss:\";\n  url.pathname = `${url.pathname.replace(/\\/$/, \"\")}/agents/${encodeURIComponent(agentName)}/endpoint/protocols/voice`;\n  url.searchParams.set(\"api-version\", apiVersion);\n  url.searchParams.set(\"x-ms-client-sdk\", `azsdk-js-ai-projects/${SDK_VERSION}`);\n  if (options.agentSessionId) {\n    url.searchParams.set(\"agent_session_id\", options.agentSessionId);\n  }\n  if (options.store !== undefined) {\n    url.searchParams.set(\"store\", String(options.store));\n  }\n  if (options.agentVersionOverride) {\n    url.searchParams.set(\"x-agent-version-override\", options.agentVersionOverride);\n  }\n  return url.toString();\n}\n\nfunction buildHeaders(\n  token: string,\n  clientOptions: VoiceAgentRealtimeClientOptions,\n  connectOptions: VoiceAgentRealtimeClientConnectOptions,\n): Record<string, string> {\n  const sdkUserAgent = `azsdk-js-ai-projects/${SDK_VERSION}`;\n  const headers: Record<string, string> = {\n    authorization: `Bearer ${token}`,\n    \"foundry-features\": voiceAgentsPreview,\n    \"x-ms-client-request-id\": createRequestId(),\n    \"x-ms-client-sdk\": sdkUserAgent,\n    \"user-agent\": clientOptions.userAgentPrefix\n      ? `${clientOptions.userAgentPrefix} ${sdkUserAgent}`\n      : sdkUserAgent,\n  };\n  if (connectOptions.structuredInputs) {\n    headers[\"x-ms-voice-structured-inputs\"] = JSON.stringify(connectOptions.structuredInputs);\n  }\n  return headers;\n}\n\nfunction createRequestId(): string {\n  return (\n    globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`\n  );\n}\n"],
-  "mappings": "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",
+  "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"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,uBAAmC;AACnC,uBAA4B;AAQ5B,oBAAuB;AACvB,wBAA2B;AAC3B,oBAIO;AACP,sBAAiF;AAOjF,+BAA0C;AAG1C,MAAM,wBAAwB,oBAAI,QAAyD;AAE3F,MAAM,yBAAyB;AAC/B,MAAM,qBAAqB;AAC3B,MAAM,0BAA0B,oBAAI,IAAI;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAGM,MAAM,iCAAiC;AAAA,EAC5C,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,SAAS;AACX;AAyKO,MAAM,yBAAyB;AAAA,EACnB;AAAA,EACA;AAAA,EACA;AAAA,EAKV,YACL,UACA,YACA,UAA2C,CAAC,GAC5C;AAIA,QAAI,CAAC,SAAS,KAAK,GAAG;AACpB,YAAM,IAAI,UAAU,6BAA6B;AAAA,IACnD;AACA,SAAK,WAAW;AAChB,SAAK,aAAa;AAClB,SAAK,UAAU;AAAA,MACb,GAAG;AAAA,MACH,uBAAuB,QAAQ,yBAAyB;AAAA,MACxD,YAAY,QAAQ,cAAc;AAAA,IACpC;AAAA,EACF;AAAA;AAAA,EAGA,MAAa,QACX,WACA,UAAkD,CAAC,GACpB;AAC/B,QAAI,CAAC,UAAU,KAAK,GAAG;AACrB,YAAM,IAAI,UAAU,8BAA8B;AAAA,IACpD;AACA,UAAM,MAAM;AAAA,MACV,kBAAkB,KAAK,QAAQ;AAAA,MAC/B;AAAA,MACA,KAAK,QAAQ;AAAA,MACb;AAAA,IACF;AACA,UAAM,6BAA6B,QAAQ,mBACvC,KAAK,UAAU,QAAQ,gBAAgB,IACvC;AACJ,UAAM,gBAAgB,sBAAsB,IAAI,IAAI;AACpD,UAAM,UAAU,eAAe,UAC3B,IAAI,mDAA0B,KAAK,UAAU,eAAe,QAAQ,SAAS,IAC7E;AACJ,QAAI;AACF,YAAM,UACJ,KAAK,QAAQ,qBACZ,MAAM,OAAO,8BAA8B,GAAG,wCAAwC;AACzF,YAAM,aAAa,IAAI;AAAA,QACrB;AAAA,QACA;AAAA,QACA,KAAK;AAAA,QACL,KAAK;AAAA,QACL;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AACA,YAAM,WAAW,KAAK;AACtB,aAAO;AAAA,IACT,SAAS,OAAO;AACd,eAAS,MAAM,QAAW,OAAO,KAAK;AACtC,YAAM;AAAA,IACR;AAAA,EACF;AACF;AAGO,SAAS,+BACd,UACA,YACA,SACA,eAC0B;AAC1B,QAAM,SAAS,IAAI,yBAAyB,UAAU,YAAY,OAAO;AACzE,MAAI,cAAe,uBAAsB,IAAI,QAAQ,aAAa;AAClE,SAAO;AACT;AAEA,MAAM,yBAAyD;AAAA,EAStD,YACY,KACA,WACA,YACA,eAIA,gBACA,4BACjB,SACiB,SACjB;AAXiB;AACA;AACA;AACA;AAIA;AACA;AAEA;AAEjB,SAAK,SAAS,IAAI,6BAAoC,KAAQ;AAAA,MAC5D,YAAY,CAAC,UAAU,KAAK,yBAAyB,KAAK;AAAA,IAC5D,CAAC;AACD,SAAK,YAAY,QAAQ,OAAO;AAChC,SAAK,eAAe,IAAI,QAA+B,CAAC,YAAY;AAClE,WAAK,eAAe;AAAA,IACtB,CAAC;AACD,SAAK,UAAU,YAAY;AAAA,MACzB,WAAW,CAAC,SAAS,KAAK,cAAc,IAAI;AAAA,MAC5C,SAAS,CAAC,MAAM,QAAQ,aAAa,KAAK,YAAY,MAAM,QAAQ,QAAQ;AAAA,MAC5E,SAAS,CAAC,UAAU,KAAK,qBAAqB,KAAK;AAAA,IACrD,CAAC;AAAA,EACH;AAAA,EAxBmB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAIA;AAAA,EACA;AAAA,EAEA;AAAA,EAnBF;AAAA,EACA;AAAA,EACA;AAAA,EACT;AAAA,EACA,eAA0C,+BAA+B;AAAA,EACzE,kBAAkB;AAAA,EAClB,WAAW;AAAA,EA6BnB,IAAW,QAAmC;AAC5C,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAW,SAAyC;AAClD,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAa,OAAsB;AACjC,SAAK,SAAS,+BAA+B,UAAU;AACvD,QAAI;AACJ,QAAI;AACF,YAAM,cAAc,MAAM,KAAK,WAAW;AAAA,QACxC,KAAK,cAAc,oBAAoB;AAAA,QACvC,EAAE,aAAa,KAAK,eAAe,YAAY;AAAA,MACjD;AACA,UAAI,CAAC,aAAa;AAChB,cAAM,IAAI,4CAA8B,0CAA0C;AAAA,MACpF;AACA,cAAQ,YAAY;AAAA,IACtB,SAAS,OAAO;AACd,UAAI,KAAK,eAAe,aAAa,SAAS;AAC5C,cAAM,iBAAiB,IAAI;AAAA,UACzB;AAAA,UACA;AAAA,UACA,EAAE,OAAO,MAAM;AAAA,QACjB;AACA,aAAK,OAAO,MAAM,eAAe,SAAS,OAAO,cAAc;AAC/D,cAAM;AAAA,MACR;AACA,YAAM,sBACJ,iBAAiB,8CACb,QACA,IAAI,4CAA8B,kDAAkD;AAAA,QAClF,OAAO;AAAA,MACT,CAAC;AACP,WAAK,OAAO,MAAM,oBAAoB,SAAS,OAAO,mBAAmB;AACzE,YAAM;AAAA,IACR;AAEA,QAAI;AACF,YAAM,KAAK,UAAU,QAAQ;AAAA,QAC3B,KAAK,KAAK;AAAA,QACV,WAAW,CAAC,UAAU;AAAA,QACtB,SAAS,aAAa,OAAO,KAAK,eAAe,KAAK,0BAA0B;AAAA,QAChF,uBACE,KAAK,eAAe,yBAAyB,KAAK,cAAc;AAAA,QAClE,aAAa,KAAK,eAAe;AAAA,MACnC,CAAC;AACD,WAAK,SAAS,OAAO;AACrB,WAAK,SAAS,+BAA+B,SAAS;AACtD,2BAAO,KAAK,4BAA4B,EAAE,WAAW,KAAK,UAAU,CAAC;AAAA,IACvE,SAAS,OAAO;AACd,YAAM,YAAY,KAAK,eAAe,aAAa,YAAY;AAC/D,YAAM,kBAAkB,IAAI;AAAA,QAC1B,YACI,0CACA;AAAA,QACJ,YAAY,uBAAuB;AAAA,QACnC,EAAE,OAAO,MAAM;AAAA,MACjB;AACA,WAAK,OAAO,MAAM,gBAAgB,SAAS,OAAO,eAAe;AACjE,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEA,MAAa,UACX,OACA,UAAiC,CAAC,GACnB;AACf,QAAI,KAAK,UAAU,+BAA+B,WAAW;AAC3D,YAAM,IAAI;AAAA,QACR,uCAAuC,KAAK,KAAK;AAAA,QACjD;AAAA,MACF;AAAA,IACF;AACA,QAAI,QAAQ,aAAa,SAAS;AAChC,YAAM,IAAI,wCAA0B,iCAAiC,oBAAoB;AAAA,IAC3F;AAEA,QAAI,cAAoE;AACxE,QAAI;AACF,YAAM,iBAAa,gDAA+B,KAAK;AACvD,oBAAc,KAAK,SAAS,YAAY,KAAK;AAC7C,YAAM,KAAK,UAAU,KAAK,YAAY,QAAQ,WAAW;AACzD,WAAK,SAAS,KAAK,OAAO,WAAW;AAAA,IACvC,SAAS,OAAO;AACd,WAAK,SAAS,WAAW,OAAO,WAAW;AAC3C,UAAI,iBAAiB,uCAAyB;AAC5C,cAAM;AAAA,MACR;AACA,YAAM,IAAI,wCAA0B,uCAAuC,cAAc;AAAA,QACvF,OAAO;AAAA,MACT,CAAC;AAAA,IACH;AAAA,EACF;AAAA,EAEO,iBACL,SACA,UAA0C,CAAC,GAC5B;AACf,WAAO,KAAK,UAAU,EAAE,MAAM,kBAAkB,UAAU,QAAQ,SAAS,QAAQ,GAAG,OAAO;AAAA,EAC/F;AAAA,EAEA,MAAa,SAAS,MAAc,UAAqC,CAAC,GAAkB;AAC1F,UAAM,KAAK;AAAA,MACT;AAAA,QACE,MAAM;AAAA,QACN,UAAU,QAAQ;AAAA,QAClB,kBAAkB,QAAQ;AAAA;AAAA;AAAA;AAAA,QAI1B,MAAM;AAAA,UACJ,MAAM;AAAA,UACN,MAAM;AAAA,UACN,SAAS,CAAC,EAAE,MAAM,cAAc,KAAK,CAAC;AAAA,QACxC;AAAA,MACF;AAAA,MACA;AAAA,IACF;AACA,QAAI,QAAQ,mBAAmB,OAAO;AACpC,YAAM,KAAK,gBAAgB,EAAE,aAAa,QAAQ,YAAY,CAAC;AAAA,IACjE;AAAA,EACF;AAAA,EAEO,UACL,OACA,UAAkC,CAAC,GACpB;AACf,UAAM,QAAQ,iBAAiB,aAAa,QAAQ,IAAI,WAAW,KAAK;AACxE,WAAO,KAAK;AAAA,MACV;AAAA,QACE,MAAM;AAAA,QACN,UAAU,QAAQ;AAAA,QAClB,WAAO,qCAAmB,OAAO,QAAQ;AAAA,MAC3C;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAEO,YAAY,UAAkC,CAAC,GAAkB;AACtE,WAAO,KAAK;AAAA,MACV,EAAE,MAAM,6BAA6B,UAAU,QAAQ,QAAQ;AAAA,MAC/D;AAAA,IACF;AAAA,EACF;AAAA,EAEO,gBAAgB,UAAkC,CAAC,GAAkB;AAC1E,WAAO,KAAK,UAAU,EAAE,MAAM,4BAA4B,UAAU,QAAQ,QAAQ,GAAG,OAAO;AAAA,EAChG;AAAA,EAEO,iBAAiB,UAAkC,CAAC,GAAkB;AAC3E,WAAO,KAAK;AAAA,MACV,EAAE,MAAM,6BAA6B,UAAU,QAAQ,QAAQ;AAAA,MAC/D;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAa,eACX,QACA,QACA,UAA2C,CAAC,GAC7B;AACf,UAAM,KAAK;AAAA,MACT;AAAA,QACE,MAAM;AAAA,QACN,UAAU,QAAQ;AAAA,QAClB,MAAM,EAAE,MAAM,wBAAwB,SAAS,QAAQ,OAAO;AAAA,MAChE;AAAA,MACA;AAAA,IACF;AACA,QAAI,QAAQ,mBAAmB,OAAO;AACpC,YAAM,KAAK,gBAAgB,EAAE,aAAa,QAAQ,YAAY,CAAC;AAAA,IACjE;AAAA,EACF;AAAA,EAEO,gBAAgB,UAAqC,CAAC,GAAkB;AAC7E,WAAO,KAAK;AAAA,MACV,EAAE,MAAM,mBAAmB,UAAU,QAAQ,SAAS,UAAU,QAAQ,SAAS;AAAA,MACjF;AAAA,IACF;AAAA,EACF;AAAA,EAEO,eAAe,UAA2C,CAAC,GAAkB;AAClF,WAAO,KAAK;AAAA,MACV,EAAE,MAAM,mBAAmB,UAAU,QAAQ,SAAS,aAAa,QAAQ,WAAW;AAAA,MACtF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAa,MACX,OAAO,KACP,SAAS,6CACM;AACf,QACE,KAAK,UAAU,+BAA+B,gBAC9C,KAAK,UAAU,+BAA+B,SAC9C;AACA,YAAM,KAAK;AACX;AAAA,IACF;AACA,SAAK,SAAS,+BAA+B,OAAO;AACpD,QAAI;AACF,YAAM,KAAK,UAAU,MAAM,MAAM,MAAM;AAAA,IACzC,UAAE;AACA,WAAK,OAAO,MAAM,QAAQ,KAAK;AAAA,IACjC;AAAA,EACF;AAAA,EAEO,UAAyB;AAC9B,WAAO,KAAK,MAAM;AAAA,EACpB;AAAA,EAEA,QAAe,OAAO,aAAa,IAA4C;AAC7E,QAAI,KAAK,iBAAiB;AACxB,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,SAAK,kBAAkB;AACvB,QAAI;AACF,aAAO,MAAM;AACX,cAAM,SAAS,MAAM,KAAK,OAAO,KAAK;AACtC,YAAI,OAAO,MAAM;AACf;AAAA,QACF;AACA,cAAM,OAAO;AAAA,MACf;AAAA,IACF,UAAE;AACA,UAAI,KAAK,UAAU,+BAA+B,WAAW;AAC3D,cAAM,KAAK,MAAM;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,cAAc,MAAkC;AACtD,QAAI;AACF,YAAM,YAAQ,kDAAiC,IAAI;AACnD,WAAK,SAAS,SAAS,KAAK;AAC5B,WAAK,OAAO,QAAQ,KAAK;AAAA,IAC3B,SAAS,OAAO;AACd,YAAM,gBACJ,iBAAiB,wCACb,QACA,IAAI,sCAAwB,0CAA0C,EAAE,OAAO,MAAM,CAAC;AAE5F,WAAK,OAAO,MAAM,cAAc,SAAS,OAAO,aAAa;AAAA,IAC/D;AAAA,EACF;AAAA,EAEQ,yBAAyB,OAAoB;AACnD,QAAI,KAAK,UAAU;AACjB;AAAA,IACF;AACA,UAAM,QAAQ,IAAI,wCAA0B,MAAM,SAAS,oBAAoB;AAAA,MAC7E;AAAA,IACF,CAAC;AACD,SAAK,OAAO,MAAM,MAAM,SAAS,OAAO,KAAK;AAAA,EAC/C;AAAA,EAEQ,YAAY,MAAc,QAAgB,UAAyB;AACzE,QAAI,KAAK,UAAU;AACjB;AAAA,IACF;AACA,QAAI,YAAY,KAAK,UAAU,+BAA+B,SAAS;AACrE,WAAK,OAAO,MAAM,QAAQ,QAAQ;AAAA,IACpC,OAAO;AACL,YAAM,QAAQ,IAAI;AAAA,QAChB,+CAA+C,IAAI,GAAG,SAAS,KAAK,MAAM,KAAK,EAAE;AAAA,QACjF;AAAA,QACA,EAAE,WAAW,KAAK;AAAA,MACpB;AACA,WAAK,OAAO,MAAM,QAAQ,OAAO,KAAK;AAAA,IACxC;AAAA,EACF;AAAA,EAEQ,qBAAqB,OAAoB;AAC/C,QAAI,KAAK,UAAU;AACjB;AAAA,IACF;AACA,UAAM,QAAQ,IAAI;AAAA,MAChB;AAAA,MACA;AAAA,MACA;AAAA,QACE;AAAA,MACF;AAAA,IACF;AACA,SAAK,OAAO,MAAM,MAAM,SAAS,OAAO,KAAK;AAAA,EAC/C;AAAA,EAEQ,OAAO,MAAc,QAAgB,UAAmB,OAAqB;AACnF,QAAI,KAAK,UAAU;AACjB;AAAA,IACF;AACA,SAAK,WAAW;AAChB,SAAK,SAAS,MAAM,MAAM,UAAU,KAAK;AACzC,QAAI,OAAO;AACT,WAAK,OAAO,KAAK,KAAK;AAAA,IACxB,OAAO;AACL,WAAK,OAAO,MAAM;AAAA,IACpB;AACA,SAAK,SAAS,+BAA+B,YAAY;AACzD,SAAK,aAAa,EAAE,MAAM,QAAQ,UAAU,MAAM,CAAC;AACnD,yBAAO,KAAK,iCAAiC,EAAE,MAAM,QAAQ,SAAS,CAAC;AAGvE,SAAK,KAAK,sBAAsB,MAAM,MAAM;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,sBAAsB,MAAc,QAA+B;AAC/E,QAAI;AACF,YAAM,KAAK,UAAU,MAAM,MAAM,MAAM;AAAA,IACzC,SAAS,OAAO;AACd,2BAAO,QAAQ,6CAA6C,EAAE,MAAM,CAAC;AAAA,IACvE;AAAA,EACF;AAAA,EAEQ,SAAS,OAAwC;AACvD,QAAI,UAAU,KAAK,cAAc;AAC/B;AAAA,IACF;AACA,UAAM,gBAAgB,KAAK;AAC3B,SAAK,eAAe;AACpB,QAAI;AACF,WAAK,eAAe,0BAA0B,OAAO,aAAa;AAAA,IACpE,SAAS,OAAO;AAEd,2BAAO,QAAQ,mDAAmD,EAAE,MAAM,CAAC;AAAA,IAC7E;AAAA,EACF;AACF;AAEA,SAAS,kBAAkB,UAA0B;AACnD,QAAM,aAAa,SAAS,KAAK;AACjC,MAAI,CAAC,YAAY;AACf,UAAM,IAAI,UAAU,6BAA6B;AAAA,EACnD;AACA,QAAM,MAAM,IAAI,IAAI,WAAW,SAAS,KAAK,IAAI,aAAa,WAAW,UAAU,EAAE;AACrF,MAAI,IAAI,aAAa,UAAU;AAC7B,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO,IAAI,SAAS;AACtB;AAEA,SAAS,kBACP,UACA,WACA,YACA,SACQ;AACR,QAAM,MAAM,IAAI,IAAI,QAAQ;AAC5B,MAAI,WAAW;AACf,MAAI,WAAW,GAAG,IAAI,SAAS,QAAQ,QAAQ,EAAE,CAAC,WAAW,mBAAmB,SAAS,CAAC;AAC1F,MACE,QAAQ,UAAU,WACjB,QAAQ,UAAU,QACjB,OAAO,QAAQ,UAAU,YACzB,CAAC,CAAC,OAAO,WAAW,IAAI,EAAE,SAAS,OAAO,eAAe,QAAQ,KAAK,CAAC,IACzE;AACA,UAAM,IAAI,UAAU,6CAA6C;AAAA,EACnE;AACA,aAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,QAAQ,SAAS,CAAC,CAAC,GAAG;AAC/D,UAAM,iBAAiB,KAAK,YAAY;AACxC,QAAI,wBAAwB,IAAI,cAAc,KAAK,eAAe,WAAW,IAAI,GAAG;AAClF,YAAM,IAAI,UAAU,oBAAoB,IAAI,6CAA6C;AAAA,IAC3F;AACA,QAAI,UAAU,QAAW;AACvB,UAAI,aAAa,OAAO,IAAI;AAAA,IAC9B,WACE,OAAO,UAAU,YACjB,OAAO,UAAU,aAChB,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,GACnD;AACA,UAAI,aAAa,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,IAC1C,OAAO;AACL,YAAM,IAAI;AAAA,QACR,oBAAoB,IAAI;AAAA,MAC1B;AAAA,IACF;AAAA,EACF;AACA,MAAI,aAAa,IAAI,eAAe,UAAU;AAC9C,MAAI,aAAa,IAAI,mBAAmB,wBAAwB,4BAAW,EAAE;AAC7E,MAAI,QAAQ,gBAAgB;AAC1B,QAAI,aAAa,IAAI,oBAAoB,QAAQ,cAAc;AAAA,EACjE;AACA,MAAI,QAAQ,UAAU,QAAW;AAC/B,QAAI,aAAa,IAAI,SAAS,OAAO,QAAQ,KAAK,CAAC;AAAA,EACrD;AACA,MAAI,QAAQ,sBAAsB;AAChC,QAAI,aAAa,IAAI,4BAA4B,QAAQ,oBAAoB;AAAA,EAC/E;AACA,MAAI,QAAQ,WAAW;AACrB,QAAI,aAAa,IAAI,aAAa,QAAQ,SAAS;AAAA,EACrD;AACA,SAAO,IAAI,SAAS;AACtB;AAEA,SAAS,aACP,OACA,eACA,4BACwB;AACxB,QAAM,eAAe,wBAAwB,4BAAW;AACxD,QAAM,UAAkC;AAAA,IACtC,eAAe,UAAU,KAAK;AAAA,IAC9B,oBAAoB;AAAA,IACpB,0BAA0B,gBAAgB;AAAA,IAC1C,mBAAmB;AAAA,IACnB,cAAc,cAAc,kBACxB,GAAG,cAAc,eAAe,IAAI,YAAY,KAChD;AAAA,EACN;AACA,MAAI,+BAA+B,QAAW;AAC5C,YAAQ,8BAA8B,IAAI;AAAA,EAC5C;AACA,SAAO;AACT;AAEA,SAAS,kBAA0B;AACjC,SACE,WAAW,QAAQ,aAAa,KAAK,GAAG,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;AAE7F;",
   "names": []
 }

package/dist/commonjs/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/commonjs/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/commonjs/tracing/configuration.js

@@ -69,7 +69,11 @@ function resolveTracingConfig(options) {
       );
     }
   }
-  return { enabled, contentRecording, traceContextPropagation };
+  return {
+    enabled,
+    contentRecording,
+    traceContextPropagation
+  };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/commonjs/tracing/configuration.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/tracing/configuration.ts"],
-  "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 \u2014 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 \u2014 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"],
-  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,oBAAuB;AA8DhB,SAAS,qBAAqB,SAAsD;AAEzF,MAAI;AACJ,MAAI,SAAS,iBAAiB,QAAW;AACvC,mBAAe,QAAQ;AAAA,EACzB,OAAO;AACL,QAAI;AACF,YAAM,SAAS,QAAQ,IAAI;AAC3B,qBAAe,CAAC,CAAC,WAAW,OAAO,YAAY,MAAM,UAAU,WAAW;AAAA,IAC5E,SAAS,GAAG;AACV,2BAAO;AAAA,QACL,qFAAqF,CAAC;AAAA,MACxF;AACA,qBAAe;AAAA,IACjB;AAAA,EACF;AAEA,QAAM,UAAU,YAAY,UAAa;AAEzC,MAAI,CAAC,SAAS;AACZ,WAAO,EAAE,SAAS,OAAO,kBAAkB,OAAO,yBAAyB,KAAK;AAAA,EAClF;AAGA,MAAI;AACJ,MAAI,SAAS,qBAAqB,QAAW;AAC3C,uBAAmB,QAAQ;AAAA,EAC7B,OAAO;AACL,QAAI;AACF,YAAM,SAAS,QAAQ,IAAI;AAC3B,yBAAmB,CAAC,CAAC,WAAW,OAAO,YAAY,MAAM,UAAU,WAAW;AAAA,IAChF,SAAS,GAAG;AACV,2BAAO;AAAA,QACL,8EAA8E,CAAC;AAAA,MACjF;AACA,yBAAmB;AAAA,IACrB;AAAA,EACF;AAGA,MAAI,0BAA0B;AAC9B,MAAI,SAAS,4BAA4B,QAAW;AAClD,8BAA0B,QAAQ;AAAA,EACpC,OAAO;AACL,QAAI;AACF,YAAM,SAAS,QAAQ,IAAI;AAC3B,UAAI,WAAW,OAAO,YAAY,MAAM,WAAW,WAAW,MAAM;AAClE,kCAA0B;AAAA,MAC5B;AAAA,IACF,SAAS,GAAG;AACV,2BAAO;AAAA,QACL,iFAAiF,CAAC;AAAA,MACpF;AAAA,IACF;AAAA,EACF;AAEA,SAAO,EAAE,SAAS,kBAAkB,wBAAwB;AAC9D;",
+  "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 \u2014 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"],
+  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,oBAAuB;AA4DhB,SAAS,qBAAqB,SAAsD;AAEzF,MAAI;AACJ,MAAI,SAAS,iBAAiB,QAAW;AACvC,mBAAe,QAAQ;AAAA,EACzB,OAAO;AACL,QAAI;AACF,YAAM,SAAS,QAAQ,IAAI;AAC3B,qBAAe,CAAC,CAAC,WAAW,OAAO,YAAY,MAAM,UAAU,WAAW;AAAA,IAC5E,SAAS,GAAG;AACV,2BAAO;AAAA,QACL,qFAAqF,CAAC;AAAA,MACxF;AACA,qBAAe;AAAA,IACjB;AAAA,EACF;AAEA,QAAM,UAAU,YAAY,UAAa;AAEzC,MAAI,CAAC,SAAS;AACZ,WAAO,EAAE,SAAS,OAAO,kBAAkB,OAAO,yBAAyB,KAAK;AAAA,EAClF;AAGA,MAAI;AACJ,MAAI,SAAS,qBAAqB,QAAW;AAC3C,uBAAmB,QAAQ;AAAA,EAC7B,OAAO;AACL,QAAI;AACF,YAAM,SAAS,QAAQ,IAAI;AAC3B,yBAAmB,CAAC,CAAC,WAAW,OAAO,YAAY,MAAM,UAAU,WAAW;AAAA,IAChF,SAAS,GAAG;AACV,2BAAO;AAAA,QACL,8EAA8E,CAAC;AAAA,MACjF;AACA,yBAAmB;AAAA,IACrB;AAAA,EACF;AAGA,MAAI,0BAA0B;AAC9B,MAAI,SAAS,4BAA4B,QAAW;AAClD,8BAA0B,QAAQ;AAAA,EACpC,OAAO;AACL,QAAI;AACF,YAAM,SAAS,QAAQ,IAAI;AAC3B,UAAI,WAAW,OAAO,YAAY,MAAM,WAAW,WAAW,MAAM;AAClE,kCAA0B;AAAA,MAC5B;AAAA,IACF,SAAS,GAAG;AACV,2BAAO;AAAA,QACL,iFAAiF,CAAC;AAAA,MACpF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/commonjs/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/commonjs/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/commonjs/tracing/tracingClient.js

@@ -26,9 +26,9 @@ module.exports = __toCommonJS(tracingClient_exports);
 var import_api = require("@opentelemetry/api");
 var import_constants = require("../constants.js");
 var import_api2 = require("@opentelemetry/api");
-function startSpan(name) {
+function startSpan(name, parentContext = import_api.context.active()) {
   const tracer = import_api.trace.getTracer(import_constants.PACKAGE_NAME, import_constants.SDK_VERSION);
-  const ctx = import_api.context.active();
+  const ctx = parentContext;
   const span = tracer.startSpan(name, { kind: import_api.SpanKind.CLIENT }, ctx);
   const spanCtx = import_api.trace.setSpan(ctx, span);
   return { span, ctx: spanCtx };