@azure/ai-projects 2.5.0 → 2.7.0

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

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

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

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

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

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

package/dist/browser/realtime/webSocketTransportLike.js

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

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

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

package/dist/browser/static-helpers/pagingHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pagingHelpers.d.ts","sourceRoot":"","sources":["../../../src/static-helpers/pagingHelpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAG7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,QAAQ,EAAE,KAAK,GAAG,QAAQ,EAAE,IAAI,KAAK,GAAG;IAClE;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW,CAC1B,QAAQ,EACR,KAAK,GAAG,QAAQ,EAAE,EAClB,aAAa,SAAS,YAAY,GAAG,YAAY;IAEjD;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,KAAK,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC;IAC5F;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,aAAa,KAAK,qBAAqB,CAAC,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IAE/F;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,QAAQ,EAAE,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EACR,KAAK,GAAG,QAAQ,EAAE,EAClB,aAAa,SAAS,YAAY,GAAG,YAAY,EACjD,SAAS,SAAS,qBAAqB,GAAG,qBAAqB,EAE/D,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,MAAM,WAAW,CAAC,SAAS,CAAC,EAChD,mBAAmB,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,WAAW,CAAC,OAAO,CAAC,EAChE,gBAAgB,EAAE,MAAM,EAAE,EAC1B,OAAO,GAAE,8BAAmC,GAC3C,0BAA0B,CAAC,QAAQ,EAAE,KAAK,EAAE,aAAa,CAAC,CAiD5D"}
+{"version":3,"file":"pagingHelpers.d.ts","sourceRoot":"","sources":["../../../src/static-helpers/pagingHelpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAG7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,QAAQ,EAAE,KAAK,GAAG,QAAQ,EAAE,IAAI,KAAK,GAAG;IAClE;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW,CAC1B,QAAQ,EACR,KAAK,GAAG,QAAQ,EAAE,EAClB,aAAa,SAAS,YAAY,GAAG,YAAY;IAEjD;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,KAAK,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC;IAC5F;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,aAAa,KAAK,qBAAqB,CAAC,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IAE/F;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,QAAQ,EAAE,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EACR,KAAK,GAAG,QAAQ,EAAE,EAClB,aAAa,SAAS,YAAY,GAAG,YAAY,EACjD,SAAS,SAAS,qBAAqB,GAAG,qBAAqB,EAE/D,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,MAAM,WAAW,CAAC,SAAS,CAAC,EAChD,mBAAmB,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,WAAW,CAAC,OAAO,CAAC,EAChE,gBAAgB,EAAE,MAAM,EAAE,EAC1B,OAAO,GAAE,8BAAmC,GAC3C,0BAA0B,CAAC,QAAQ,EAAE,KAAK,EAAE,aAAa,CAAC,CAoD5D"}

package/dist/browser/static-helpers/pagingHelpers.js

@@ -25,6 +25,9 @@ export function buildPagedAsyncIterator(client, getInitialResponse, processRespo
             }
             else {
                 const resolvedPageLink = apiVersion ? addApiVersionToUrl(pageLink, apiVersion) : pageLink;
+                if (cursorFieldName && hasMoreFieldName) {
+                    initialRequestUrl = new URL(resolvedPageLink);
+                }
                 result =
                     nextLinkMethod === "POST"
                         ? await client.pathUnchecked(resolvedPageLink).post(nextPageRequestOptions)

package/dist/browser/static-helpers/pagingHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"pagingHelpers.js","sourceRoot":"","sources":["../../../src/static-helpers/pagingHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { PageSettings, PagedAsyncIterableIterator } from \"@azure/core-paging\";\nimport type { Client, PathUncheckedResponse } from \"@azure-rest/core-client\";\nimport { createRestError } from \"@azure-rest/core-client\";\nimport { RestError } from \"@azure/core-rest-pipeline\";\nimport type { KnownApiVersions } from \"../models/models.js\";\n\n/**\n * An interface that describes a page of results.\n */\nexport type ContinuablePage<TElement, TPage = TElement[]> = TPage & {\n  /**\n   * The token that keeps track of where to continue the iterator\n   */\n  continuationToken?: string;\n};\n\n/**\n * An interface that describes how to communicate with the service.\n */\nexport interface PagedResult<\n  TElement,\n  TPage = TElement[],\n  TPageSettings extends PageSettings = PageSettings,\n> {\n  /**\n   * Link to the first page of results.\n   */\n  firstPageLink?: string;\n  /**\n   * A method that returns a page of results.\n   */\n  getPage: (pageLink?: string) => Promise<{ page: TPage; nextPageLink?: string } | undefined>;\n  /**\n   * a function to implement the `byPage` method on the paged async iterator.\n   */\n  byPage?: (settings?: TPageSettings) => AsyncIterableIterator<ContinuablePage<TElement, TPage>>;\n\n  /**\n   * A function to extract elements from a page.\n   */\n  toElements?: (page: TPage) => TElement[];\n}\n\n/**\n * Options for the paging helper\n */\nexport interface BuildPagedAsyncIteratorOptions {\n  itemName?: string;\n  nextLinkName?: string;\n  nextLinkMethod?: \"GET\" | \"POST\";\n  apiVersion?: KnownApiVersions;\n  nextPageRequestOptions?: Record<string, unknown>;\n  cursorFieldName?: string;\n  hasMoreFieldName?: string;\n}\n\n/**\n * Helper to paginate results in a generic way and return a PagedAsyncIterableIterator\n */\nexport function buildPagedAsyncIterator<\n  TElement,\n  TPage = TElement[],\n  TPageSettings extends PageSettings = PageSettings,\n  TResponse extends PathUncheckedResponse = PathUncheckedResponse,\n>(\n  client: Client,\n  getInitialResponse: () => PromiseLike<TResponse>,\n  processResponseBody: (result: TResponse) => PromiseLike<unknown>,\n  expectedStatuses: string[],\n  options: BuildPagedAsyncIteratorOptions = {},\n): PagedAsyncIterableIterator<TElement, TPage, TPageSettings> {\n  const itemName = options.itemName ?? \"value\";\n  const nextLinkName = options.nextLinkName ?? \"nextLink\";\n  const nextLinkMethod = options.nextLinkMethod ?? \"GET\";\n  const apiVersion = options.apiVersion;\n  const nextPageRequestOptions = options.nextPageRequestOptions;\n  const cursorFieldName = options.cursorFieldName;\n  const hasMoreFieldName = options.hasMoreFieldName;\n  let initialRequestUrl: URL | undefined;\n  const pagedResult: PagedResult<TElement, TPage, TPageSettings> = {\n    getPage: async (pageLink?: string) => {\n      let result;\n      if (pageLink === undefined) {\n        result = await getInitialResponse();\n        if (cursorFieldName && hasMoreFieldName) {\n          initialRequestUrl = new URL(result.request.url);\n        }\n      } else {\n        const resolvedPageLink = apiVersion ? addApiVersionToUrl(pageLink, apiVersion) : pageLink;\n        result =\n          nextLinkMethod === \"POST\"\n            ? await client.pathUnchecked(resolvedPageLink).post(nextPageRequestOptions)\n            : await client.pathUnchecked(resolvedPageLink).get(nextPageRequestOptions);\n      }\n      checkPagingRequest(result, expectedStatuses);\n      const results = await processResponseBody(result as TResponse);\n      const nextLink = getNextLink(results, nextLinkName);\n      let resolvedNextLink = nextLink;\n      if (!resolvedNextLink && cursorFieldName && hasMoreFieldName && initialRequestUrl) {\n        const body = results as Record<string, unknown>;\n        if (body[hasMoreFieldName] === true && body[cursorFieldName]) {\n          initialRequestUrl.searchParams.set(\"after\", body[cursorFieldName] as string);\n          resolvedNextLink = initialRequestUrl.toString();\n        }\n      }\n      const values = getElements<TElement>(results, itemName) as TPage;\n      return {\n        page: values,\n        nextPageLink: resolvedNextLink,\n      };\n    },\n    byPage: (settings?: TPageSettings) => {\n      const { continuationToken } = settings ?? {};\n      return getPageAsyncIterator(pagedResult, {\n        pageLink: continuationToken,\n      });\n    },\n  };\n  return getPagedAsyncIterator(pagedResult);\n}\n\n/**\n * returns an async iterator that iterates over results. It also has a `byPage`\n * method that returns pages of items at once.\n *\n * @param pagedResult - an object that specifies how to get pages.\n * @returns a paged async iterator that iterates over results.\n */\n\nfunction getPagedAsyncIterator<\n  TElement,\n  TPage = TElement[],\n  TPageSettings extends PageSettings = PageSettings,\n>(\n  pagedResult: PagedResult<TElement, TPage, TPageSettings>,\n): PagedAsyncIterableIterator<TElement, TPage, TPageSettings> {\n  const iter = getItemAsyncIterator<TElement, TPage, TPageSettings>(pagedResult);\n  return {\n    next() {\n      return iter.next();\n    },\n    [Symbol.asyncIterator]() {\n      return this;\n    },\n    byPage:\n      pagedResult?.byPage ??\n      ((settings?: TPageSettings) => {\n        const { continuationToken } = settings ?? {};\n        return getPageAsyncIterator(pagedResult, {\n          pageLink: continuationToken,\n        });\n      }),\n  };\n}\n\nasync function* getItemAsyncIterator<TElement, TPage, TPageSettings extends PageSettings>(\n  pagedResult: PagedResult<TElement, TPage, TPageSettings>,\n): AsyncIterableIterator<TElement> {\n  const pages = getPageAsyncIterator(pagedResult);\n  for await (const page of pages) {\n    yield* page as unknown as TElement[];\n  }\n}\n\nasync function* getPageAsyncIterator<TElement, TPage, TPageSettings extends PageSettings>(\n  pagedResult: PagedResult<TElement, TPage, TPageSettings>,\n  options: {\n    pageLink?: string;\n  } = {},\n): AsyncIterableIterator<ContinuablePage<TElement, TPage>> {\n  const { pageLink } = options;\n  let response = await pagedResult.getPage(pageLink ?? pagedResult.firstPageLink);\n  if (!response) {\n    return;\n  }\n  let result = response.page as ContinuablePage<TElement, TPage>;\n  result.continuationToken = response.nextPageLink;\n  yield result;\n  while (response.nextPageLink) {\n    response = await pagedResult.getPage(response.nextPageLink);\n    if (!response) {\n      return;\n    }\n    result = response.page as ContinuablePage<TElement, TPage>;\n    result.continuationToken = response.nextPageLink;\n    yield result;\n  }\n}\n\n/**\n * Gets for the value of nextLink in the body\n */\nfunction getNextLink(body: unknown, nextLinkName?: string): string | undefined {\n  if (!nextLinkName) {\n    return undefined;\n  }\n\n  const nextLink = (body as Record<string, unknown>)[nextLinkName];\n\n  if (typeof nextLink !== \"string\" && typeof nextLink !== \"undefined\" && nextLink !== null) {\n    throw new RestError(\n      `Body Property ${nextLinkName} should be a string or undefined or null but got ${typeof nextLink}`,\n    );\n  }\n\n  if (nextLink === null) {\n    return undefined;\n  }\n\n  return nextLink;\n}\n\n/**\n * Gets the elements of the current request in the body.\n */\nfunction getElements<T = unknown>(body: unknown, itemName: string): T[] {\n  const value = (body as Record<string, unknown>)[itemName] as T[];\n  if (!Array.isArray(value)) {\n    throw new RestError(\n      `Couldn't paginate response\\n Body doesn't contain an array property with name: ${itemName}`,\n    );\n  }\n\n  return value ?? [];\n}\n\n/**\n * Checks if a request failed\n */\nfunction checkPagingRequest(response: PathUncheckedResponse, expectedStatuses: string[]): void {\n  if (!expectedStatuses.includes(response.status)) {\n    throw createRestError(\n      `Pagination failed with unexpected statusCode ${response.status}`,\n      response,\n    );\n  }\n}\n\n/**\n * Adds the api-version query parameter on a URL if it's not present.\n * @param url - the URL to modify\n * @param apiVersion - the API version to set\n * @returns - the URL with the api-version query parameter set\n */\nfunction addApiVersionToUrl(url: string, apiVersion: string): string {\n  // The base URL is only used for parsing and won't appear in the returned URL\n  const urlObj = new URL(url, \"https://microsoft.com\");\n  if (!urlObj.searchParams.get(\"api-version\")) {\n    // Append one if there is no apiVersion\n    return `${url}${\n      Array.from(urlObj.searchParams.keys()).length > 0 ? \"&\" : \"?\"\n    }api-version=${apiVersion}`;\n  }\n  return url;\n}\n"]}
+{"version":3,"file":"pagingHelpers.js","sourceRoot":"","sources":["../../../src/static-helpers/pagingHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { PageSettings, PagedAsyncIterableIterator } from \"@azure/core-paging\";\nimport type { Client, PathUncheckedResponse } from \"@azure-rest/core-client\";\nimport { createRestError } from \"@azure-rest/core-client\";\nimport { RestError } from \"@azure/core-rest-pipeline\";\nimport type { KnownApiVersions } from \"../models/models.js\";\n\n/**\n * An interface that describes a page of results.\n */\nexport type ContinuablePage<TElement, TPage = TElement[]> = TPage & {\n  /**\n   * The token that keeps track of where to continue the iterator\n   */\n  continuationToken?: string;\n};\n\n/**\n * An interface that describes how to communicate with the service.\n */\nexport interface PagedResult<\n  TElement,\n  TPage = TElement[],\n  TPageSettings extends PageSettings = PageSettings,\n> {\n  /**\n   * Link to the first page of results.\n   */\n  firstPageLink?: string;\n  /**\n   * A method that returns a page of results.\n   */\n  getPage: (pageLink?: string) => Promise<{ page: TPage; nextPageLink?: string } | undefined>;\n  /**\n   * a function to implement the `byPage` method on the paged async iterator.\n   */\n  byPage?: (settings?: TPageSettings) => AsyncIterableIterator<ContinuablePage<TElement, TPage>>;\n\n  /**\n   * A function to extract elements from a page.\n   */\n  toElements?: (page: TPage) => TElement[];\n}\n\n/**\n * Options for the paging helper\n */\nexport interface BuildPagedAsyncIteratorOptions {\n  itemName?: string;\n  nextLinkName?: string;\n  nextLinkMethod?: \"GET\" | \"POST\";\n  apiVersion?: KnownApiVersions;\n  nextPageRequestOptions?: Record<string, unknown>;\n  cursorFieldName?: string;\n  hasMoreFieldName?: string;\n}\n\n/**\n * Helper to paginate results in a generic way and return a PagedAsyncIterableIterator\n */\nexport function buildPagedAsyncIterator<\n  TElement,\n  TPage = TElement[],\n  TPageSettings extends PageSettings = PageSettings,\n  TResponse extends PathUncheckedResponse = PathUncheckedResponse,\n>(\n  client: Client,\n  getInitialResponse: () => PromiseLike<TResponse>,\n  processResponseBody: (result: TResponse) => PromiseLike<unknown>,\n  expectedStatuses: string[],\n  options: BuildPagedAsyncIteratorOptions = {},\n): PagedAsyncIterableIterator<TElement, TPage, TPageSettings> {\n  const itemName = options.itemName ?? \"value\";\n  const nextLinkName = options.nextLinkName ?? \"nextLink\";\n  const nextLinkMethod = options.nextLinkMethod ?? \"GET\";\n  const apiVersion = options.apiVersion;\n  const nextPageRequestOptions = options.nextPageRequestOptions;\n  const cursorFieldName = options.cursorFieldName;\n  const hasMoreFieldName = options.hasMoreFieldName;\n  let initialRequestUrl: URL | undefined;\n  const pagedResult: PagedResult<TElement, TPage, TPageSettings> = {\n    getPage: async (pageLink?: string) => {\n      let result;\n      if (pageLink === undefined) {\n        result = await getInitialResponse();\n        if (cursorFieldName && hasMoreFieldName) {\n          initialRequestUrl = new URL(result.request.url);\n        }\n      } else {\n        const resolvedPageLink = apiVersion ? addApiVersionToUrl(pageLink, apiVersion) : pageLink;\n        if (cursorFieldName && hasMoreFieldName) {\n          initialRequestUrl = new URL(resolvedPageLink);\n        }\n        result =\n          nextLinkMethod === \"POST\"\n            ? await client.pathUnchecked(resolvedPageLink).post(nextPageRequestOptions)\n            : await client.pathUnchecked(resolvedPageLink).get(nextPageRequestOptions);\n      }\n      checkPagingRequest(result, expectedStatuses);\n      const results = await processResponseBody(result as TResponse);\n      const nextLink = getNextLink(results, nextLinkName);\n      let resolvedNextLink = nextLink;\n      if (!resolvedNextLink && cursorFieldName && hasMoreFieldName && initialRequestUrl) {\n        const body = results as Record<string, unknown>;\n        if (body[hasMoreFieldName] === true && body[cursorFieldName]) {\n          initialRequestUrl.searchParams.set(\"after\", body[cursorFieldName] as string);\n          resolvedNextLink = initialRequestUrl.toString();\n        }\n      }\n      const values = getElements<TElement>(results, itemName) as TPage;\n      return {\n        page: values,\n        nextPageLink: resolvedNextLink,\n      };\n    },\n    byPage: (settings?: TPageSettings) => {\n      const { continuationToken } = settings ?? {};\n      return getPageAsyncIterator(pagedResult, {\n        pageLink: continuationToken,\n      });\n    },\n  };\n  return getPagedAsyncIterator(pagedResult);\n}\n\n/**\n * returns an async iterator that iterates over results. It also has a `byPage`\n * method that returns pages of items at once.\n *\n * @param pagedResult - an object that specifies how to get pages.\n * @returns a paged async iterator that iterates over results.\n */\n\nfunction getPagedAsyncIterator<\n  TElement,\n  TPage = TElement[],\n  TPageSettings extends PageSettings = PageSettings,\n>(\n  pagedResult: PagedResult<TElement, TPage, TPageSettings>,\n): PagedAsyncIterableIterator<TElement, TPage, TPageSettings> {\n  const iter = getItemAsyncIterator<TElement, TPage, TPageSettings>(pagedResult);\n  return {\n    next() {\n      return iter.next();\n    },\n    [Symbol.asyncIterator]() {\n      return this;\n    },\n    byPage:\n      pagedResult?.byPage ??\n      ((settings?: TPageSettings) => {\n        const { continuationToken } = settings ?? {};\n        return getPageAsyncIterator(pagedResult, {\n          pageLink: continuationToken,\n        });\n      }),\n  };\n}\n\nasync function* getItemAsyncIterator<TElement, TPage, TPageSettings extends PageSettings>(\n  pagedResult: PagedResult<TElement, TPage, TPageSettings>,\n): AsyncIterableIterator<TElement> {\n  const pages = getPageAsyncIterator(pagedResult);\n  for await (const page of pages) {\n    yield* page as unknown as TElement[];\n  }\n}\n\nasync function* getPageAsyncIterator<TElement, TPage, TPageSettings extends PageSettings>(\n  pagedResult: PagedResult<TElement, TPage, TPageSettings>,\n  options: {\n    pageLink?: string;\n  } = {},\n): AsyncIterableIterator<ContinuablePage<TElement, TPage>> {\n  const { pageLink } = options;\n  let response = await pagedResult.getPage(pageLink ?? pagedResult.firstPageLink);\n  if (!response) {\n    return;\n  }\n  let result = response.page as ContinuablePage<TElement, TPage>;\n  result.continuationToken = response.nextPageLink;\n  yield result;\n  while (response.nextPageLink) {\n    response = await pagedResult.getPage(response.nextPageLink);\n    if (!response) {\n      return;\n    }\n    result = response.page as ContinuablePage<TElement, TPage>;\n    result.continuationToken = response.nextPageLink;\n    yield result;\n  }\n}\n\n/**\n * Gets for the value of nextLink in the body\n */\nfunction getNextLink(body: unknown, nextLinkName?: string): string | undefined {\n  if (!nextLinkName) {\n    return undefined;\n  }\n\n  const nextLink = (body as Record<string, unknown>)[nextLinkName];\n\n  if (typeof nextLink !== \"string\" && typeof nextLink !== \"undefined\" && nextLink !== null) {\n    throw new RestError(\n      `Body Property ${nextLinkName} should be a string or undefined or null but got ${typeof nextLink}`,\n    );\n  }\n\n  if (nextLink === null) {\n    return undefined;\n  }\n\n  return nextLink;\n}\n\n/**\n * Gets the elements of the current request in the body.\n */\nfunction getElements<T = unknown>(body: unknown, itemName: string): T[] {\n  const value = (body as Record<string, unknown>)[itemName] as T[];\n  if (!Array.isArray(value)) {\n    throw new RestError(\n      `Couldn't paginate response\\n Body doesn't contain an array property with name: ${itemName}`,\n    );\n  }\n\n  return value ?? [];\n}\n\n/**\n * Checks if a request failed\n */\nfunction checkPagingRequest(response: PathUncheckedResponse, expectedStatuses: string[]): void {\n  if (!expectedStatuses.includes(response.status)) {\n    throw createRestError(\n      `Pagination failed with unexpected statusCode ${response.status}`,\n      response,\n    );\n  }\n}\n\n/**\n * Adds the api-version query parameter on a URL if it's not present.\n * @param url - the URL to modify\n * @param apiVersion - the API version to set\n * @returns - the URL with the api-version query parameter set\n */\nfunction addApiVersionToUrl(url: string, apiVersion: string): string {\n  // The base URL is only used for parsing and won't appear in the returned URL\n  const urlObj = new URL(url, \"https://microsoft.com\");\n  if (!urlObj.searchParams.get(\"api-version\")) {\n    // Append one if there is no apiVersion\n    return `${url}${\n      Array.from(urlObj.searchParams.keys()).length > 0 ? \"&\" : \"?\"\n    }api-version=${apiVersion}`;\n  }\n  return url;\n}\n"]}

package/dist/browser/static-helpers/pollingHelpers.d.ts

@@ -53,6 +53,18 @@ export interface JobOperationState<TResult> extends OperationState<TResult> {
 }
 /** A poller for a long-running operation that creates a job resource. */
 export type JobPoller<TResult> = PollerLike<JobOperationState<TResult>, TResult>;
+/**
+ * Operation state for a long-running operation that creates a run resource.
+ *
+ * CUSTOMIZATION: SDK-IMPROVEMENT: the emitted poller resolves to the run's terminal `result`
+ * payload, which carries no identifier; `runId` keeps the created run reachable.
+ */
+export interface RunOperationState<TResult> extends OperationState<TResult> {
+    /** Server-assigned id of the created run. Available once `submitted()` resolves. */
+    readonly runId?: string;
+}
+/** A poller for a long-running operation that creates a run resource. */
+export type RunPoller<TResult> = PollerLike<RunOperationState<TResult>, TResult>;
 /**
  * Builds a {@link JobPoller} that records the created job's id from the initial response.
  *
@@ -61,5 +73,13 @@ export type JobPoller<TResult> = PollerLike<JobOperationState<TResult>, TResult>
  * in https://github.com/Azure/azure-sdk-for-js/issues/39476.
  */
 export declare function getJobPoller<TResponse extends PathUncheckedResponse, TResult = void>(client: Client, processResponseBody: (result: TResponse) => Promise<TResult>, expectedStatuses: string[], options: GetLongRunningPollerOptions<TResponse>): JobPoller<TResult>;
+/**
+ * Builds a {@link RunPoller} that records the created run's id from the initial response.
+ *
+ * CUSTOMIZATION: SDK-IMPROVEMENT: core-lro v3 has no hook for writing service-derived data into
+ * poller state from the initial response, so the id is captured and merged in by hand. Tracked
+ * in https://github.com/Azure/azure-sdk-for-js/issues/39476.
+ */
+export declare function getRunPoller<TResponse extends PathUncheckedResponse, TResult>(client: Client, processResponseBody: (result: TResponse) => Promise<TResult>, expectedStatuses: string[], options: GetLongRunningPollerOptions<TResponse>): RunPoller<TResult>;
 export declare function getLongRunningPoller<TResponse extends PathUncheckedResponse, TResult = void>(client: Client, processResponseBody: (result: TResponse) => Promise<TResult>, expectedStatuses: string[], options: GetLongRunningPollerOptions<TResponse>): PollerLike<OperationState<TResult>, TResult>;
 //# sourceMappingURL=pollingHelpers.d.ts.map

package/dist/browser/static-helpers/pollingHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pollingHelpers.d.ts","sourceRoot":"","sources":["../../../src/static-helpers/pollingHelpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,eAAe,EACf,sBAAsB,EAGvB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAE7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,2BAA2B,CAAC,SAAS;IACpD,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B;;OAEG;IACH,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACvD;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,WAAW,CAAC,SAAS,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB,CAAC,OAAO,CAAE,SAAQ,cAAc,CAAC,OAAO,CAAC;IACzE,oFAAoF;IACpF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,yEAAyE;AACzE,MAAM,MAAM,SAAS,CAAC,OAAO,IAAI,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AAEjF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,SAAS,qBAAqB,EAAE,OAAO,GAAG,IAAI,EAClF,MAAM,EAAE,MAAM,EACd,mBAAmB,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,EAC5D,gBAAgB,EAAE,MAAM,EAAE,EAC1B,OAAO,EAAE,2BAA2B,CAAC,SAAS,CAAC,GAC9C,SAAS,CAAC,OAAO,CAAC,CA+DpB;AA0BD,wBAAgB,oBAAoB,CAAC,SAAS,SAAS,qBAAqB,EAAE,OAAO,GAAG,IAAI,EAC1F,MAAM,EAAE,MAAM,EACd,mBAAmB,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,EAC5D,gBAAgB,EAAE,MAAM,EAAE,EAC1B,OAAO,EAAE,2BAA2B,CAAC,SAAS,CAAC,GAC9C,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CA6D9C"}
+{"version":3,"file":"pollingHelpers.d.ts","sourceRoot":"","sources":["../../../src/static-helpers/pollingHelpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,eAAe,EACf,sBAAsB,EAGvB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAE7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,2BAA2B,CAAC,SAAS;IACpD,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B;;OAEG;IACH,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACvD;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,WAAW,CAAC,SAAS,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB,CAAC,OAAO,CAAE,SAAQ,cAAc,CAAC,OAAO,CAAC;IACzE,oFAAoF;IACpF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,yEAAyE;AACzE,MAAM,MAAM,SAAS,CAAC,OAAO,IAAI,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AAEjF;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB,CAAC,OAAO,CAAE,SAAQ,cAAc,CAAC,OAAO,CAAC;IACzE,oFAAoF;IACpF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,yEAAyE;AACzE,MAAM,MAAM,SAAS,CAAC,OAAO,IAAI,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AAEjF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,SAAS,qBAAqB,EAAE,OAAO,GAAG,IAAI,EAClF,MAAM,EAAE,MAAM,EACd,mBAAmB,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,EAC5D,gBAAgB,EAAE,MAAM,EAAE,EAC1B,OAAO,EAAE,2BAA2B,CAAC,SAAS,CAAC,GAC9C,SAAS,CAAC,OAAO,CAAC,CAQpB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,SAAS,qBAAqB,EAAE,OAAO,EAC3E,MAAM,EAAE,MAAM,EACd,mBAAmB,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,EAC5D,gBAAgB,EAAE,MAAM,EAAE,EAC1B,OAAO,EAAE,2BAA2B,CAAC,SAAS,CAAC,GAC9C,SAAS,CAAC,OAAO,CAAC,CAQpB;AAqGD,wBAAgB,oBAAoB,CAAC,SAAS,SAAS,qBAAqB,EAAE,OAAO,GAAG,IAAI,EAC1F,MAAM,EAAE,MAAM,EACd,mBAAmB,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,EAC5D,gBAAgB,EAAE,MAAM,EAAE,EAC1B,OAAO,EAAE,2BAA2B,CAAC,SAAS,CAAC,GAC9C,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CA6D9C"}

package/dist/browser/static-helpers/pollingHelpers.js

@@ -10,16 +10,29 @@ import { createRestError } from "@azure-rest/core-client";
  * in https://github.com/Azure/azure-sdk-for-js/issues/39476.
  */
 export function getJobPoller(client, processResponseBody, expectedStatuses, options) {
+    return getIdentifiedPoller(client, processResponseBody, expectedStatuses, options, "jobId");
+}
+/**
+ * Builds a {@link RunPoller} that records the created run's id from the initial response.
+ *
+ * CUSTOMIZATION: SDK-IMPROVEMENT: core-lro v3 has no hook for writing service-derived data into
+ * poller state from the initial response, so the id is captured and merged in by hand. Tracked
+ * in https://github.com/Azure/azure-sdk-for-js/issues/39476.
+ */
+export function getRunPoller(client, processResponseBody, expectedStatuses, options) {
+    return getIdentifiedPoller(client, processResponseBody, expectedStatuses, options, "runId");
+}
+function getIdentifiedPoller(client, processResponseBody, expectedStatuses, options, identityKey) {
     const { getInitialResponse } = options;
-    let jobId;
+    let resourceId;
     // core-lro awaits this from `sendInitialRequest`, which `submitted()` awaits in turn, so
-    // `jobId` is set by the time `submitted()` resolves.
+    // `resourceId` is set by the time `submitted()` resolves.
     const base = getLongRunningPoller(client, processResponseBody, expectedStatuses, {
         ...options,
         getInitialResponse: getInitialResponse
             ? async () => {
                 const response = await getInitialResponse();
-                jobId = extractJobId(response);
+                resourceId = extractResourceId(response);
                 return response;
             }
             : undefined,
@@ -28,8 +41,9 @@ export function getJobPoller(client, processResponseBody, expectedStatuses, opti
     // consistent and lets the id survive `serialize()`. `??=` preserves an id restored from
     // serialized state.
     const stamp = (state) => {
-        if (state && jobId !== undefined) {
-            state.jobId ??= jobId;
+        if (state && resourceId !== undefined) {
+            const identifiedState = state;
+            identifiedState[identityKey] ??= resourceId;
         }
         return state;
     };
@@ -53,7 +67,7 @@ export function getJobPoller(client, processResponseBody, expectedStatuses, opti
         onProgress: (callback) => base.onProgress((state) => callback(stamp(state))),
         async serialize() {
             // The id must be stamped before core-lro's state object is stringified; `submitted()`
-            // guarantees that object exists and that `jobId` has been captured.
+            // guarantees that object exists and that the resource id has been captured.
             await base.submitted();
             stamp(base.operationState);
             return base.serialize();
@@ -65,18 +79,18 @@ export function getJobPoller(client, processResponseBody, expectedStatuses, opti
     };
 }
 /**
- * Reads the created job's id from the initial response.
+ * Reads the created resource's id from the initial response.
  *
- * The create response body is the job resource with a required `id`, so it is authoritative.
- * The headers are a fallback for an empty body, preferring `location` (the resource URL) over
- * `operation-location` (the polling URL).
+ * The create response body is the resource with a required `id`, so it is authoritative.
+ * The `location` header is a fallback for an empty body because it identifies the resource.
+ * `operation-location` identifies the polling operation and is not a resource id.
  */
-function extractJobId(response) {
+function extractResourceId(response) {
     const id = response.body?.id;
     if (typeof id === "string" && id.length > 0) {
         return id;
     }
-    const url = response.headers["location"] ?? response.headers["operation-location"];
+    const url = response.headers["location"];
     if (!url) {
         return undefined;
     }

package/dist/browser/static-helpers/pollingHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"pollingHelpers.js","sourceRoot":"","sources":["../../../src/static-helpers/pollingHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type {\n  PollerLike,\n  OperationState,\n  OperationStatus,\n  ResourceLocationConfig,\n  RunningOperation,\n  OperationResponse,\n} from \"@azure/core-lro\";\nimport { createHttpPoller } from \"@azure/core-lro\";\n\nimport type { Client, PathUncheckedResponse } from \"@azure-rest/core-client\";\nimport { createRestError } from \"@azure-rest/core-client\";\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport type { KnownApiVersions } from \"../models/models.js\";\n\nexport interface GetLongRunningPollerOptions<TResponse> {\n  /** Delay to wait until next poll, in milliseconds. */\n  updateIntervalInMs?: number;\n  /**\n   * The signal which can be used to abort requests.\n   */\n  abortSignal?: AbortSignalLike;\n  /**\n   * The potential location of the result of the LRO if specified by the LRO extension in the swagger.\n   */\n  resourceLocationConfig?: ResourceLocationConfig;\n  /**\n   * The original url of the LRO\n   * Should not be null when restoreFrom is set\n   */\n  initialRequestUrl?: string;\n  /**\n   * A serialized poller which can be used to resume an existing paused Long-Running-Operation.\n   */\n  restoreFrom?: string;\n  /**\n   * The api-version of the LRO\n   */\n  apiVersion?: KnownApiVersions;\n  /**\n   * Additional headers to include on poll requests (e.g. feature-flag headers required by the endpoint).\n   */\n  pollHeaders?: Record<string, string>;\n  /**\n   * Optional mapping from service-specific status values to the core-lro status values\n   * (\"running\", \"succeeded\", \"failed\", \"canceled\"). Use this when the service returns\n   * non-standard terminal status strings (e.g. \"completed\" instead of \"succeeded\").\n   */\n  statusNormalizations?: Record<string, OperationStatus>;\n  /**\n   * The function to get the initial response\n   */\n  getInitialResponse?: () => PromiseLike<TResponse>;\n}\n\n/**\n * Operation state for a long-running operation that creates a job resource.\n *\n * CUSTOMIZATION: SDK-IMPROVEMENT: the emitted pollers resolve to the job's terminal `result`\n * payload, which carries no identifier; `jobId` keeps the created job reachable.\n */\nexport interface JobOperationState<TResult> extends OperationState<TResult> {\n  /** Server-assigned id of the created job. Available once `submitted()` resolves. */\n  readonly jobId?: string;\n}\n\n/** A poller for a long-running operation that creates a job resource. */\nexport type JobPoller<TResult> = PollerLike<JobOperationState<TResult>, TResult>;\n\n/**\n * Builds a {@link JobPoller} that records the created job's id from the initial response.\n *\n * CUSTOMIZATION: SDK-IMPROVEMENT: core-lro v3 has no hook for writing service-derived data into\n * poller state from the initial response, so the id is captured and merged in by hand. Tracked\n * in https://github.com/Azure/azure-sdk-for-js/issues/39476.\n */\nexport function getJobPoller<TResponse extends PathUncheckedResponse, TResult = void>(\n  client: Client,\n  processResponseBody: (result: TResponse) => Promise<TResult>,\n  expectedStatuses: string[],\n  options: GetLongRunningPollerOptions<TResponse>,\n): JobPoller<TResult> {\n  const { getInitialResponse } = options;\n  let jobId: string | undefined;\n\n  // core-lro awaits this from `sendInitialRequest`, which `submitted()` awaits in turn, so\n  // `jobId` is set by the time `submitted()` resolves.\n  const base = getLongRunningPoller(client, processResponseBody, expectedStatuses, {\n    ...options,\n    getInitialResponse: getInitialResponse\n      ? async () => {\n          const response = await getInitialResponse();\n          jobId = extractJobId(response);\n          return response;\n        }\n      : undefined,\n  });\n\n  // core-lro shares one state object across every channel, so mutating it in place keeps them\n  // consistent and lets the id survive `serialize()`. `??=` preserves an id restored from\n  // serialized state.\n  const stamp = (\n    state: OperationState<TResult> | undefined,\n  ): JobOperationState<TResult> | undefined => {\n    if (state && jobId !== undefined) {\n      (state as { jobId?: string }).jobId ??= jobId;\n    }\n    return state as JobOperationState<TResult> | undefined;\n  };\n\n  return {\n    get isDone(): boolean {\n      return base.isDone;\n    },\n    get result(): TResult | undefined {\n      return base.result;\n    },\n    get operationState(): JobOperationState<TResult> | undefined {\n      return stamp(base.operationState);\n    },\n    submitted: () => base.submitted(),\n    async poll(pollOptions?: {\n      abortSignal?: AbortSignalLike;\n    }): Promise<JobOperationState<TResult>> {\n      return stamp(await base.poll(pollOptions))!;\n    },\n    // Not wrapped: this drives core-lro's internal `poll`, not the one above, and the state it\n    // dispatches to progress handlers is already stamped.\n    pollUntilDone: (pollOptions?: { abortSignal?: AbortSignalLike }) =>\n      base.pollUntilDone(pollOptions),\n    onProgress: (callback: (state: JobOperationState<TResult>) => void) =>\n      base.onProgress((state) => callback(stamp(state)!)),\n    async serialize(): Promise<string> {\n      // The id must be stamped before core-lro's state object is stringified; `submitted()`\n      // guarantees that object exists and that `jobId` has been captured.\n      await base.submitted();\n      stamp(base.operationState);\n      return base.serialize();\n    },\n    then: (onfulfilled, onrejected) => base.then(onfulfilled, onrejected),\n    catch: (onrejected) => base.catch(onrejected),\n    finally: (onfinally) => base.finally(onfinally),\n    [Symbol.toStringTag]: \"Poller\",\n  };\n}\n\n/**\n * Reads the created job's id from the initial response.\n *\n * The create response body is the job resource with a required `id`, so it is authoritative.\n * The headers are a fallback for an empty body, preferring `location` (the resource URL) over\n * `operation-location` (the polling URL).\n */\nfunction extractJobId(response: PathUncheckedResponse): string | undefined {\n  const id = (response.body as { id?: unknown } | undefined)?.id;\n  if (typeof id === \"string\" && id.length > 0) {\n    return id;\n  }\n\n  const url = response.headers[\"location\"] ?? response.headers[\"operation-location\"];\n  if (!url) {\n    return undefined;\n  }\n\n  // The base only makes relative URLs parseable; it never appears in the result.\n  const { pathname } = new URL(url, \"https://placeholder.invalid\");\n  const segment = pathname.replace(/\\/+$/, \"\").split(\"/\").pop();\n  return segment ? decodeURIComponent(segment) : undefined;\n}\n\nexport function getLongRunningPoller<TResponse extends PathUncheckedResponse, TResult = void>(\n  client: Client,\n  processResponseBody: (result: TResponse) => Promise<TResult>,\n  expectedStatuses: string[],\n  options: GetLongRunningPollerOptions<TResponse>,\n): PollerLike<OperationState<TResult>, TResult> {\n  const { restoreFrom, getInitialResponse, apiVersion, pollHeaders, statusNormalizations } =\n    options;\n  if (!restoreFrom && !getInitialResponse) {\n    throw new Error(\"Either restoreFrom or getInitialResponse must be specified\");\n  }\n  let initialResponse: TResponse | undefined = undefined;\n  const pollAbortController = new AbortController();\n  const poller: RunningOperation<TResponse> = {\n    sendInitialRequest: async () => {\n      if (!getInitialResponse) {\n        throw new Error(\"getInitialResponse is required when initializing a new poller\");\n      }\n      initialResponse = await getInitialResponse();\n      return getLroResponse(initialResponse, expectedStatuses, statusNormalizations);\n    },\n    sendPollRequest: async (\n      path: string,\n      pollOptions?: {\n        abortSignal?: AbortSignalLike;\n      },\n    ) => {\n      // The poll request would both listen to the user provided abort signal and the poller's own abort signal\n      function abortListener(): void {\n        pollAbortController.abort();\n      }\n      const abortSignal = pollAbortController.signal;\n      if (options.abortSignal?.aborted) {\n        pollAbortController.abort();\n      } else if (pollOptions?.abortSignal?.aborted) {\n        pollAbortController.abort();\n      } else if (!abortSignal.aborted) {\n        options.abortSignal?.addEventListener(\"abort\", abortListener, {\n          once: true,\n        });\n        pollOptions?.abortSignal?.addEventListener(\"abort\", abortListener, {\n          once: true,\n        });\n      }\n      let response;\n      try {\n        const pollingPath = apiVersion ? addApiVersionToUrl(path, apiVersion) : path;\n        response = await client\n          .pathUnchecked(pollingPath)\n          .get({ abortSignal, headers: pollHeaders });\n      } finally {\n        options.abortSignal?.removeEventListener(\"abort\", abortListener);\n        pollOptions?.abortSignal?.removeEventListener(\"abort\", abortListener);\n      }\n\n      return getLroResponse(response as TResponse, expectedStatuses, statusNormalizations);\n    },\n  };\n  return createHttpPoller(poller, {\n    intervalInMs: options?.updateIntervalInMs,\n    resourceLocationConfig: options?.resourceLocationConfig,\n    restoreFrom: options?.restoreFrom,\n    processResult: (result: unknown) => {\n      return processResponseBody(result as TResponse);\n    },\n  });\n}\n/**\n * Converts a Rest Client response to a response that the LRO implementation understands\n * @param response - a rest client http response\n * @param deserializeFn - deserialize function to convert Rest response to modular output\n * @returns - An LRO response that the LRO implementation understands\n */\nfunction getLroResponse<TResponse extends PathUncheckedResponse>(\n  response: TResponse,\n  expectedStatuses: string[],\n  statusNormalizations?: Record<string, OperationStatus>,\n): OperationResponse<TResponse> {\n  if (!expectedStatuses.includes(response.status)) {\n    throw createRestError(response);\n  }\n\n  const body = response.body as Record<string, unknown> | undefined;\n  const rawStatus = body?.[\"status\"];\n  const normalizedBody =\n    statusNormalizations && typeof rawStatus === \"string\" && rawStatus in statusNormalizations\n      ? { ...body, status: statusNormalizations[rawStatus] }\n      : body;\n\n  return {\n    flatResponse: response,\n    rawResponse: {\n      ...response,\n      statusCode: Number.parseInt(response.status),\n      body: normalizedBody,\n    },\n  };\n}\n\n/**\n * Sets the api-version query parameter on a URL, replacing any existing value.\n * @param url - the URL to modify\n * @param apiVersion - the API version to set\n * @returns - the URL with the api-version query parameter set\n */\nfunction addApiVersionToUrl(url: string, apiVersion: string): string {\n  // The base URL is only used for parsing and won't appear in the returned URL\n  const urlObj = new URL(url, \"https://microsoft.com\");\n  const existingVersion = urlObj.searchParams.get(\"api-version\");\n  if (!existingVersion) {\n    // Append one if there is no apiVersion\n    return `${url}${\n      Array.from(urlObj.searchParams.keys()).length > 0 ? \"&\" : \"?\"\n    }api-version=${apiVersion}`;\n  }\n\n  if (existingVersion === apiVersion) {\n    return url;\n  }\n  // Replace the service-returned api-version with the client's configured version\n  return url.replace(`api-version=${existingVersion}`, `api-version=${apiVersion}`);\n}\n"]}
+{"version":3,"file":"pollingHelpers.js","sourceRoot":"","sources":["../../../src/static-helpers/pollingHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type {\n  PollerLike,\n  OperationState,\n  OperationStatus,\n  ResourceLocationConfig,\n  RunningOperation,\n  OperationResponse,\n} from \"@azure/core-lro\";\nimport { createHttpPoller } from \"@azure/core-lro\";\n\nimport type { Client, PathUncheckedResponse } from \"@azure-rest/core-client\";\nimport { createRestError } from \"@azure-rest/core-client\";\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport type { KnownApiVersions } from \"../models/models.js\";\n\nexport interface GetLongRunningPollerOptions<TResponse> {\n  /** Delay to wait until next poll, in milliseconds. */\n  updateIntervalInMs?: number;\n  /**\n   * The signal which can be used to abort requests.\n   */\n  abortSignal?: AbortSignalLike;\n  /**\n   * The potential location of the result of the LRO if specified by the LRO extension in the swagger.\n   */\n  resourceLocationConfig?: ResourceLocationConfig;\n  /**\n   * The original url of the LRO\n   * Should not be null when restoreFrom is set\n   */\n  initialRequestUrl?: string;\n  /**\n   * A serialized poller which can be used to resume an existing paused Long-Running-Operation.\n   */\n  restoreFrom?: string;\n  /**\n   * The api-version of the LRO\n   */\n  apiVersion?: KnownApiVersions;\n  /**\n   * Additional headers to include on poll requests (e.g. feature-flag headers required by the endpoint).\n   */\n  pollHeaders?: Record<string, string>;\n  /**\n   * Optional mapping from service-specific status values to the core-lro status values\n   * (\"running\", \"succeeded\", \"failed\", \"canceled\"). Use this when the service returns\n   * non-standard terminal status strings (e.g. \"completed\" instead of \"succeeded\").\n   */\n  statusNormalizations?: Record<string, OperationStatus>;\n  /**\n   * The function to get the initial response\n   */\n  getInitialResponse?: () => PromiseLike<TResponse>;\n}\n\n/**\n * Operation state for a long-running operation that creates a job resource.\n *\n * CUSTOMIZATION: SDK-IMPROVEMENT: the emitted pollers resolve to the job's terminal `result`\n * payload, which carries no identifier; `jobId` keeps the created job reachable.\n */\nexport interface JobOperationState<TResult> extends OperationState<TResult> {\n  /** Server-assigned id of the created job. Available once `submitted()` resolves. */\n  readonly jobId?: string;\n}\n\n/** A poller for a long-running operation that creates a job resource. */\nexport type JobPoller<TResult> = PollerLike<JobOperationState<TResult>, TResult>;\n\n/**\n * Operation state for a long-running operation that creates a run resource.\n *\n * CUSTOMIZATION: SDK-IMPROVEMENT: the emitted poller resolves to the run's terminal `result`\n * payload, which carries no identifier; `runId` keeps the created run reachable.\n */\nexport interface RunOperationState<TResult> extends OperationState<TResult> {\n  /** Server-assigned id of the created run. Available once `submitted()` resolves. */\n  readonly runId?: string;\n}\n\n/** A poller for a long-running operation that creates a run resource. */\nexport type RunPoller<TResult> = PollerLike<RunOperationState<TResult>, TResult>;\n\n/**\n * Builds a {@link JobPoller} that records the created job's id from the initial response.\n *\n * CUSTOMIZATION: SDK-IMPROVEMENT: core-lro v3 has no hook for writing service-derived data into\n * poller state from the initial response, so the id is captured and merged in by hand. Tracked\n * in https://github.com/Azure/azure-sdk-for-js/issues/39476.\n */\nexport function getJobPoller<TResponse extends PathUncheckedResponse, TResult = void>(\n  client: Client,\n  processResponseBody: (result: TResponse) => Promise<TResult>,\n  expectedStatuses: string[],\n  options: GetLongRunningPollerOptions<TResponse>,\n): JobPoller<TResult> {\n  return getIdentifiedPoller<TResponse, TResult, JobOperationState<TResult>>(\n    client,\n    processResponseBody,\n    expectedStatuses,\n    options,\n    \"jobId\",\n  );\n}\n\n/**\n * Builds a {@link RunPoller} that records the created run's id from the initial response.\n *\n * CUSTOMIZATION: SDK-IMPROVEMENT: core-lro v3 has no hook for writing service-derived data into\n * poller state from the initial response, so the id is captured and merged in by hand. Tracked\n * in https://github.com/Azure/azure-sdk-for-js/issues/39476.\n */\nexport function getRunPoller<TResponse extends PathUncheckedResponse, TResult>(\n  client: Client,\n  processResponseBody: (result: TResponse) => Promise<TResult>,\n  expectedStatuses: string[],\n  options: GetLongRunningPollerOptions<TResponse>,\n): RunPoller<TResult> {\n  return getIdentifiedPoller<TResponse, TResult, RunOperationState<TResult>>(\n    client,\n    processResponseBody,\n    expectedStatuses,\n    options,\n    \"runId\",\n  );\n}\n\nfunction getIdentifiedPoller<\n  TResponse extends PathUncheckedResponse,\n  TResult,\n  TState extends OperationState<TResult>,\n>(\n  client: Client,\n  processResponseBody: (result: TResponse) => Promise<TResult>,\n  expectedStatuses: string[],\n  options: GetLongRunningPollerOptions<TResponse>,\n  identityKey: \"jobId\" | \"runId\",\n): PollerLike<TState, TResult> {\n  const { getInitialResponse } = options;\n  let resourceId: string | undefined;\n\n  // core-lro awaits this from `sendInitialRequest`, which `submitted()` awaits in turn, so\n  // `resourceId` is set by the time `submitted()` resolves.\n  const base = getLongRunningPoller(client, processResponseBody, expectedStatuses, {\n    ...options,\n    getInitialResponse: getInitialResponse\n      ? async () => {\n          const response = await getInitialResponse();\n          resourceId = extractResourceId(response);\n          return response;\n        }\n      : undefined,\n  });\n\n  // core-lro shares one state object across every channel, so mutating it in place keeps them\n  // consistent and lets the id survive `serialize()`. `??=` preserves an id restored from\n  // serialized state.\n  const stamp = (state: OperationState<TResult> | undefined): TState | undefined => {\n    if (state && resourceId !== undefined) {\n      const identifiedState = state as OperationState<TResult> & {\n        jobId?: string;\n        runId?: string;\n      };\n      identifiedState[identityKey] ??= resourceId;\n    }\n    return state as TState | undefined;\n  };\n\n  return {\n    get isDone(): boolean {\n      return base.isDone;\n    },\n    get result(): TResult | undefined {\n      return base.result;\n    },\n    get operationState(): TState | undefined {\n      return stamp(base.operationState);\n    },\n    submitted: () => base.submitted(),\n    async poll(pollOptions?: { abortSignal?: AbortSignalLike }): Promise<TState> {\n      return stamp(await base.poll(pollOptions))!;\n    },\n    // Not wrapped: this drives core-lro's internal `poll`, not the one above, and the state it\n    // dispatches to progress handlers is already stamped.\n    pollUntilDone: (pollOptions?: { abortSignal?: AbortSignalLike }) =>\n      base.pollUntilDone(pollOptions),\n    onProgress: (callback: (state: TState) => void) =>\n      base.onProgress((state) => callback(stamp(state)!)),\n    async serialize(): Promise<string> {\n      // The id must be stamped before core-lro's state object is stringified; `submitted()`\n      // guarantees that object exists and that the resource id has been captured.\n      await base.submitted();\n      stamp(base.operationState);\n      return base.serialize();\n    },\n    then: (onfulfilled, onrejected) => base.then(onfulfilled, onrejected),\n    catch: (onrejected) => base.catch(onrejected),\n    finally: (onfinally) => base.finally(onfinally),\n    [Symbol.toStringTag]: \"Poller\",\n  };\n}\n\n/**\n * Reads the created resource's id from the initial response.\n *\n * The create response body is the resource with a required `id`, so it is authoritative.\n * The `location` header is a fallback for an empty body because it identifies the resource.\n * `operation-location` identifies the polling operation and is not a resource id.\n */\nfunction extractResourceId(response: PathUncheckedResponse): string | undefined {\n  const id = (response.body as { id?: unknown } | undefined)?.id;\n  if (typeof id === \"string\" && id.length > 0) {\n    return id;\n  }\n\n  const url = response.headers[\"location\"];\n  if (!url) {\n    return undefined;\n  }\n\n  // The base only makes relative URLs parseable; it never appears in the result.\n  const { pathname } = new URL(url, \"https://placeholder.invalid\");\n  const segment = pathname.replace(/\\/+$/, \"\").split(\"/\").pop();\n  return segment ? decodeURIComponent(segment) : undefined;\n}\n\nexport function getLongRunningPoller<TResponse extends PathUncheckedResponse, TResult = void>(\n  client: Client,\n  processResponseBody: (result: TResponse) => Promise<TResult>,\n  expectedStatuses: string[],\n  options: GetLongRunningPollerOptions<TResponse>,\n): PollerLike<OperationState<TResult>, TResult> {\n  const { restoreFrom, getInitialResponse, apiVersion, pollHeaders, statusNormalizations } =\n    options;\n  if (!restoreFrom && !getInitialResponse) {\n    throw new Error(\"Either restoreFrom or getInitialResponse must be specified\");\n  }\n  let initialResponse: TResponse | undefined = undefined;\n  const pollAbortController = new AbortController();\n  const poller: RunningOperation<TResponse> = {\n    sendInitialRequest: async () => {\n      if (!getInitialResponse) {\n        throw new Error(\"getInitialResponse is required when initializing a new poller\");\n      }\n      initialResponse = await getInitialResponse();\n      return getLroResponse(initialResponse, expectedStatuses, statusNormalizations);\n    },\n    sendPollRequest: async (\n      path: string,\n      pollOptions?: {\n        abortSignal?: AbortSignalLike;\n      },\n    ) => {\n      // The poll request would both listen to the user provided abort signal and the poller's own abort signal\n      function abortListener(): void {\n        pollAbortController.abort();\n      }\n      const abortSignal = pollAbortController.signal;\n      if (options.abortSignal?.aborted) {\n        pollAbortController.abort();\n      } else if (pollOptions?.abortSignal?.aborted) {\n        pollAbortController.abort();\n      } else if (!abortSignal.aborted) {\n        options.abortSignal?.addEventListener(\"abort\", abortListener, {\n          once: true,\n        });\n        pollOptions?.abortSignal?.addEventListener(\"abort\", abortListener, {\n          once: true,\n        });\n      }\n      let response;\n      try {\n        const pollingPath = apiVersion ? addApiVersionToUrl(path, apiVersion) : path;\n        response = await client\n          .pathUnchecked(pollingPath)\n          .get({ abortSignal, headers: pollHeaders });\n      } finally {\n        options.abortSignal?.removeEventListener(\"abort\", abortListener);\n        pollOptions?.abortSignal?.removeEventListener(\"abort\", abortListener);\n      }\n\n      return getLroResponse(response as TResponse, expectedStatuses, statusNormalizations);\n    },\n  };\n  return createHttpPoller(poller, {\n    intervalInMs: options?.updateIntervalInMs,\n    resourceLocationConfig: options?.resourceLocationConfig,\n    restoreFrom: options?.restoreFrom,\n    processResult: (result: unknown) => {\n      return processResponseBody(result as TResponse);\n    },\n  });\n}\n/**\n * Converts a Rest Client response to a response that the LRO implementation understands\n * @param response - a rest client http response\n * @param deserializeFn - deserialize function to convert Rest response to modular output\n * @returns - An LRO response that the LRO implementation understands\n */\nfunction getLroResponse<TResponse extends PathUncheckedResponse>(\n  response: TResponse,\n  expectedStatuses: string[],\n  statusNormalizations?: Record<string, OperationStatus>,\n): OperationResponse<TResponse> {\n  if (!expectedStatuses.includes(response.status)) {\n    throw createRestError(response);\n  }\n\n  const body = response.body as Record<string, unknown> | undefined;\n  const rawStatus = body?.[\"status\"];\n  const normalizedBody =\n    statusNormalizations && typeof rawStatus === \"string\" && rawStatus in statusNormalizations\n      ? { ...body, status: statusNormalizations[rawStatus] }\n      : body;\n\n  return {\n    flatResponse: response,\n    rawResponse: {\n      ...response,\n      statusCode: Number.parseInt(response.status),\n      body: normalizedBody,\n    },\n  };\n}\n\n/**\n * Sets the api-version query parameter on a URL, replacing any existing value.\n * @param url - the URL to modify\n * @param apiVersion - the API version to set\n * @returns - the URL with the api-version query parameter set\n */\nfunction addApiVersionToUrl(url: string, apiVersion: string): string {\n  // The base URL is only used for parsing and won't appear in the returned URL\n  const urlObj = new URL(url, \"https://microsoft.com\");\n  const existingVersion = urlObj.searchParams.get(\"api-version\");\n  if (!existingVersion) {\n    // Append one if there is no apiVersion\n    return `${url}${\n      Array.from(urlObj.searchParams.keys()).length > 0 ? \"&\" : \"?\"\n    }api-version=${apiVersion}`;\n  }\n\n  if (existingVersion === apiVersion) {\n    return url;\n  }\n  // Replace the service-returned api-version with the client's configured version\n  return url.replace(`api-version=${existingVersion}`, `api-version=${apiVersion}`);\n}\n"]}

package/dist/browser/static-helpers/serialization/get-binary-stream-response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-binary-stream-response.d.ts","sourceRoot":"","sources":["../../../../src/static-helpers/serialization/get-binary-stream-response.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAExE;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CACxF,YAAY,GAAG;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC,CACF,CAOA"}
+{"version":3,"file":"get-binary-stream-response.d.ts","sourceRoot":"","sources":["../../../../src/static-helpers/serialization/get-binary-stream-response.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGxE;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CACxF,YAAY,GAAG;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC,CACF,CAkBA"}

package/dist/browser/static-helpers/serialization/get-binary-stream-response.js

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
+import { parseJsonObject } from "./parse-json-object.js";
 /**
  * Resolves a StreamableMethod into a binary stream response using browser streaming.
  * Returns both the raw HttpResponse (for status/header inspection) and a blobBody Promise.
@@ -8,6 +9,17 @@
  */
 export async function getBinaryStreamResponse(streamableMethod) {
     const response = await streamableMethod.asBrowserStream();
+    if (!response.status.startsWith("2")) {
+        const body = response.body
+            ? parseJsonObject(await new Response(response.body).text())
+            : undefined;
+        return {
+            ...response,
+            body,
+            blobBody: undefined,
+            readableStreamBody: undefined,
+        };
+    }
     return {
         ...response,
         blobBody: new Response(response.body).blob(),

package/dist/browser/static-helpers/serialization/get-binary-stream-response.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-binary-stream-response.js","sourceRoot":"","sources":["../../../../src/static-helpers/serialization/get-binary-stream-response.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAKlC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,gBAAkC;IAM9E,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,eAAe,EAAE,CAAC;IAC1D,OAAO;QACL,GAAG,QAAQ;QACX,QAAQ,EAAE,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;QAC5C,kBAAkB,EAAE,SAAS;KAC9B,CAAC;AACJ,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { HttpResponse, StreamableMethod } from \"@azure-rest/core-client\";\nimport type { NodeReadableStream } from \"../platform-types-browser.mjs\";\n\n/**\n * Resolves a StreamableMethod into a binary stream response using browser streaming.\n * Returns both the raw HttpResponse (for status/header inspection) and a blobBody Promise.\n * Error handling is left to the caller so that generated deserializers can apply\n * operation-specific error deserialization (per-status-code details, exception headers, etc.).\n */\nexport async function getBinaryStreamResponse(streamableMethod: StreamableMethod): Promise<\n  HttpResponse & {\n    blobBody?: Promise<Blob>;\n    readableStreamBody?: NodeReadableStream;\n  }\n> {\n  const response = await streamableMethod.asBrowserStream();\n  return {\n    ...response,\n    blobBody: new Response(response.body).blob(),\n    readableStreamBody: undefined,\n  };\n}\n"]}
+{"version":3,"file":"get-binary-stream-response.js","sourceRoot":"","sources":["../../../../src/static-helpers/serialization/get-binary-stream-response.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAIlC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,gBAAkC;IAM9E,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,eAAe,EAAE,CAAC;IAC1D,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI;YACxB,CAAC,CAAC,eAAe,CAAC,MAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3D,CAAC,CAAC,SAAS,CAAC;QACd,OAAO;YACL,GAAG,QAAQ;YACX,IAAI;YACJ,QAAQ,EAAE,SAAS;YACnB,kBAAkB,EAAE,SAAS;SAC9B,CAAC;IACJ,CAAC;IACD,OAAO;QACL,GAAG,QAAQ;QACX,QAAQ,EAAE,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;QAC5C,kBAAkB,EAAE,SAAS;KAC9B,CAAC;AACJ,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { HttpResponse, StreamableMethod } from \"@azure-rest/core-client\";\nimport type { NodeReadableStream } from \"../platform-types-browser.mjs\";\nimport { parseJsonObject } from \"./parse-json-object.js\";\n\n/**\n * Resolves a StreamableMethod into a binary stream response using browser streaming.\n * Returns both the raw HttpResponse (for status/header inspection) and a blobBody Promise.\n * Error handling is left to the caller so that generated deserializers can apply\n * operation-specific error deserialization (per-status-code details, exception headers, etc.).\n */\nexport async function getBinaryStreamResponse(streamableMethod: StreamableMethod): Promise<\n  HttpResponse & {\n    blobBody?: Promise<Blob>;\n    readableStreamBody?: NodeReadableStream;\n  }\n> {\n  const response = await streamableMethod.asBrowserStream();\n  if (!response.status.startsWith(\"2\")) {\n    const body = response.body\n      ? parseJsonObject(await new Response(response.body).text())\n      : undefined;\n    return {\n      ...response,\n      body,\n      blobBody: undefined,\n      readableStreamBody: undefined,\n    };\n  }\n  return {\n    ...response,\n    blobBody: new Response(response.body).blob(),\n    readableStreamBody: undefined,\n  };\n}\n"]}

package/dist/browser/static-helpers/serialization/parse-json-object.d.ts

@@ -0,0 +1,2 @@
+export declare function parseJsonObject(text: string): Record<string, unknown> | undefined;
+//# sourceMappingURL=parse-json-object.d.ts.map

package/dist/browser/static-helpers/serialization/parse-json-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-json-object.d.ts","sourceRoot":"","sources":["../../../../src/static-helpers/serialization/parse-json-object.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CASjF"}

package/dist/browser/static-helpers/serialization/parse-json-object.js

@@ -0,0 +1,14 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export function parseJsonObject(text) {
+    try {
+        const value = JSON.parse(text);
+        return typeof value === "object" && value !== null && !Array.isArray(value)
+            ? value
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=parse-json-object.js.map

package/dist/browser/static-helpers/serialization/parse-json-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-json-object.js","sourceRoot":"","sources":["../../../../src/static-helpers/serialization/parse-json-object.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC;QACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACzE,CAAC,CAAE,KAAiC;YACpC,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nexport function parseJsonObject(text: string): Record<string, unknown> | undefined {\n  try {\n    const value: unknown = JSON.parse(text);\n    return typeof value === \"object\" && value !== null && !Array.isArray(value)\n      ? (value as Record<string, unknown>)\n      : undefined;\n  } catch {\n    return undefined;\n  }\n}\n"]}

package/dist/browser/tracing/configuration.js

@@ -35,7 +35,7 @@ export function resolveTracingConfig(options) {
         return { enabled: false, contentRecording: false, traceContextPropagation: true };
     }
     // Resolve contentRecording
-    let contentRecording = false;
+    let contentRecording;
     if (options?.contentRecording !== undefined) {
         contentRecording = options.contentRecording;
     }

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

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