@azure/ai-projects 2.3.1 → 2.5.0

package/dist/react-native/static-helpers/pollingHelpers.d.ts

@@ -41,5 +41,25 @@ export interface GetLongRunningPollerOptions<TResponse> {
      */
     getInitialResponse?: () => PromiseLike<TResponse>;
 }
+/**
+ * Operation state for a long-running operation that creates a job resource.
+ *
+ * CUSTOMIZATION: SDK-IMPROVEMENT: the emitted pollers resolve to the job's terminal `result`
+ * payload, which carries no identifier; `jobId` keeps the created job reachable.
+ */
+export interface JobOperationState<TResult> extends OperationState<TResult> {
+    /** Server-assigned id of the created job. Available once `submitted()` resolves. */
+    readonly jobId?: string;
+}
+/** A poller for a long-running operation that creates a job resource. */
+export type JobPoller<TResult> = PollerLike<JobOperationState<TResult>, TResult>;
+/**
+ * Builds a {@link JobPoller} that records the created job'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 getJobPoller<TResponse extends PathUncheckedResponse, TResult = void>(client: Client, processResponseBody: (result: TResponse) => Promise<TResult>, expectedStatuses: string[], options: GetLongRunningPollerOptions<TResponse>): JobPoller<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/react-native/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;AACD,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;;;;;;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"}

package/dist/react-native/static-helpers/pollingHelpers.js

@@ -2,6 +2,89 @@
 // Licensed under the MIT License.
 import { createHttpPoller } from "@azure/core-lro";
 import { createRestError } from "@azure-rest/core-client";
+/**
+ * Builds a {@link JobPoller} that records the created job'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 getJobPoller(client, processResponseBody, expectedStatuses, options) {
+    const { getInitialResponse } = options;
+    let jobId;
+    // core-lro awaits this from `sendInitialRequest`, which `submitted()` awaits in turn, so
+    // `jobId` is set by the time `submitted()` resolves.
+    const base = getLongRunningPoller(client, processResponseBody, expectedStatuses, {
+        ...options,
+        getInitialResponse: getInitialResponse
+            ? async () => {
+                const response = await getInitialResponse();
+                jobId = extractJobId(response);
+                return response;
+            }
+            : undefined,
+    });
+    // core-lro shares one state object across every channel, so mutating it in place keeps them
+    // consistent and lets the id survive `serialize()`. `??=` preserves an id restored from
+    // serialized state.
+    const stamp = (state) => {
+        if (state && jobId !== undefined) {
+            state.jobId ??= jobId;
+        }
+        return state;
+    };
+    return {
+        get isDone() {
+            return base.isDone;
+        },
+        get result() {
+            return base.result;
+        },
+        get operationState() {
+            return stamp(base.operationState);
+        },
+        submitted: () => base.submitted(),
+        async poll(pollOptions) {
+            return stamp(await base.poll(pollOptions));
+        },
+        // Not wrapped: this drives core-lro's internal `poll`, not the one above, and the state it
+        // dispatches to progress handlers is already stamped.
+        pollUntilDone: (pollOptions) => base.pollUntilDone(pollOptions),
+        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.
+            await base.submitted();
+            stamp(base.operationState);
+            return base.serialize();
+        },
+        then: (onfulfilled, onrejected) => base.then(onfulfilled, onrejected),
+        catch: (onrejected) => base.catch(onrejected),
+        finally: (onfinally) => base.finally(onfinally),
+        [Symbol.toStringTag]: "Poller",
+    };
+}
+/**
+ * Reads the created job'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).
+ */
+function extractJobId(response) {
+    const id = response.body?.id;
+    if (typeof id === "string" && id.length > 0) {
+        return id;
+    }
+    const url = response.headers["location"] ?? response.headers["operation-location"];
+    if (!url) {
+        return undefined;
+    }
+    // The base only makes relative URLs parseable; it never appears in the result.
+    const { pathname } = new URL(url, "https://placeholder.invalid");
+    const segment = pathname.replace(/\/+$/, "").split("/").pop();
+    return segment ? decodeURIComponent(segment) : undefined;
+}
 export function getLongRunningPoller(client, processResponseBody, expectedStatuses, options) {
     const { restoreFrom, getInitialResponse, apiVersion, pollHeaders, statusNormalizations } = options;
     if (!restoreFrom && !getInitialResponse) {

package/dist/react-native/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}\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 * 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"]}

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

@@ -0,0 +1,16 @@
+import type { Agent, AgentVersion } from "../models/models.js";
+import type { ResolvedTracingConfig } from "./configuration.js";
+/**
+ * Wraps an agent-create operation with tracing. When tracing is disabled,
+ * the operation is executed directly. When enabled, a span is created and
+ * the operation runs inside runInSpanContext so child spans (e.g. HTTP)
+ * are correctly parented.
+ * @internal
+ */
+export declare function traceAgentCreate(name: string, endpoint: string, tracingConfig: ResolvedTracingConfig | undefined, operation: () => Promise<Agent>): Promise<Agent>;
+/**
+ * Wraps an agent-version-create operation with tracing.
+ * @internal
+ */
+export declare function traceAgentVersionCreate(agentName: string, endpoint: string, tracingConfig: ResolvedTracingConfig | undefined, operation: () => Promise<AgentVersion>): Promise<AgentVersion>;
+//# sourceMappingURL=agentTracing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentTracing.d.ts","sourceRoot":"","sources":["../../../src/tracing/agentTracing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAUhE;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,qBAAqB,GAAG,SAAS,EAChD,SAAS,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,GAC9B,OAAO,CAAC,KAAK,CAAC,CAoBhB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,qBAAqB,GAAG,SAAS,EAChD,SAAS,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,GACrC,OAAO,CAAC,YAAY,CAAC,CAoBvB"}

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

@@ -0,0 +1,61 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { startSpan, runInSpanContext, SpanStatusCode } from "./tracingClient.js";
+import { setCommonAttributes, setAgentAttributes, setAgentVersionAttributes, setErrorAttributes, } from "./attributes.js";
+import { OperationName } from "./constants.js";
+/**
+ * Wraps an agent-create operation with tracing. When tracing is disabled,
+ * the operation is executed directly. When enabled, a span is created and
+ * the operation runs inside runInSpanContext so child spans (e.g. HTTP)
+ * are correctly parented.
+ * @internal
+ */
+export async function traceAgentCreate(name, endpoint, tracingConfig, operation) {
+    if (!tracingConfig?.enabled) {
+        return operation();
+    }
+    const { span, ctx } = startSpan(`${OperationName.CREATE_AGENT} ${name}`);
+    try {
+        setCommonAttributes(span, OperationName.CREATE_AGENT, endpoint);
+        const agent = await runInSpanContext(ctx, operation);
+        setAgentAttributes(span, agent, tracingConfig.contentRecording);
+        span.end();
+        return agent;
+    }
+    catch (error) {
+        setErrorAttributes(span, error);
+        span.setStatus({
+            code: SpanStatusCode.ERROR,
+            message: error instanceof Error ? error.name : "Error",
+        });
+        span.end();
+        throw error;
+    }
+}
+/**
+ * Wraps an agent-version-create operation with tracing.
+ * @internal
+ */
+export async function traceAgentVersionCreate(agentName, endpoint, tracingConfig, operation) {
+    if (!tracingConfig?.enabled) {
+        return operation();
+    }
+    const { span, ctx } = startSpan(`${OperationName.CREATE_AGENT} ${agentName}`);
+    try {
+        setCommonAttributes(span, OperationName.CREATE_AGENT, endpoint);
+        const version = await runInSpanContext(ctx, operation);
+        setAgentVersionAttributes(span, version, tracingConfig.contentRecording);
+        span.end();
+        return version;
+    }
+    catch (error) {
+        setErrorAttributes(span, error);
+        span.setStatus({
+            code: SpanStatusCode.ERROR,
+            message: error instanceof Error ? error.name : "Error",
+        });
+        span.end();
+        throw error;
+    }
+}
+//# sourceMappingURL=agentTracing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentTracing.js","sourceRoot":"","sources":["../../../src/tracing/agentTracing.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAIlC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,QAAgB,EAChB,aAAgD,EAChD,SAA+B;IAE/B,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE,CAAC;QAC5B,OAAO,SAAS,EAAE,CAAC;IACrB,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,aAAa,CAAC,YAAY,IAAI,IAAI,EAAE,CAAC,CAAC;IACzE,IAAI,CAAC;QACH,mBAAmB,CAAC,IAAI,EAAE,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACrD,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;QAChE,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,cAAc,CAAC,KAAK;YAC1B,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;SACvD,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,SAAiB,EACjB,QAAgB,EAChB,aAAgD,EAChD,SAAsC;IAEtC,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE,CAAC;QAC5B,OAAO,SAAS,EAAE,CAAC;IACrB,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,aAAa,CAAC,YAAY,IAAI,SAAS,EAAE,CAAC,CAAC;IAC9E,IAAI,CAAC;QACH,mBAAmB,CAAC,IAAI,EAAE,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACvD,yBAAyB,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;QACzE,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,cAAc,CAAC,KAAK;YAC1B,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;SACvD,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { Agent, AgentVersion } from \"../models/models.js\";\nimport type { ResolvedTracingConfig } from \"./configuration.js\";\nimport { startSpan, runInSpanContext, SpanStatusCode } from \"./tracingClient.js\";\nimport {\n  setCommonAttributes,\n  setAgentAttributes,\n  setAgentVersionAttributes,\n  setErrorAttributes,\n} from \"./attributes.js\";\nimport { OperationName } from \"./constants.js\";\n\n/**\n * Wraps an agent-create operation with tracing. When tracing is disabled,\n * the operation is executed directly. When enabled, a span is created and\n * the operation runs inside runInSpanContext so child spans (e.g. HTTP)\n * are correctly parented.\n * @internal\n */\nexport async function traceAgentCreate(\n  name: string,\n  endpoint: string,\n  tracingConfig: ResolvedTracingConfig | undefined,\n  operation: () => Promise<Agent>,\n): Promise<Agent> {\n  if (!tracingConfig?.enabled) {\n    return operation();\n  }\n  const { span, ctx } = startSpan(`${OperationName.CREATE_AGENT} ${name}`);\n  try {\n    setCommonAttributes(span, OperationName.CREATE_AGENT, endpoint);\n    const agent = await runInSpanContext(ctx, operation);\n    setAgentAttributes(span, agent, tracingConfig.contentRecording);\n    span.end();\n    return agent;\n  } catch (error) {\n    setErrorAttributes(span, error);\n    span.setStatus({\n      code: SpanStatusCode.ERROR,\n      message: error instanceof Error ? error.name : \"Error\",\n    });\n    span.end();\n    throw error;\n  }\n}\n\n/**\n * Wraps an agent-version-create operation with tracing.\n * @internal\n */\nexport async function traceAgentVersionCreate(\n  agentName: string,\n  endpoint: string,\n  tracingConfig: ResolvedTracingConfig | undefined,\n  operation: () => Promise<AgentVersion>,\n): Promise<AgentVersion> {\n  if (!tracingConfig?.enabled) {\n    return operation();\n  }\n  const { span, ctx } = startSpan(`${OperationName.CREATE_AGENT} ${agentName}`);\n  try {\n    setCommonAttributes(span, OperationName.CREATE_AGENT, endpoint);\n    const version = await runInSpanContext(ctx, operation);\n    setAgentVersionAttributes(span, version, tracingConfig.contentRecording);\n    span.end();\n    return version;\n  } catch (error) {\n    setErrorAttributes(span, error);\n    span.setStatus({\n      code: SpanStatusCode.ERROR,\n      message: error instanceof Error ? error.name : \"Error\",\n    });\n    span.end();\n    throw error;\n  }\n}\n"]}

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

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

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

@@ -1,5 +1,6 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
+import { logger } from "../logger.js";
 /**
  * Resolves tracing options into a frozen config object for the client instance.
  * For each setting not explicitly provided, the corresponding environment variable
@@ -24,7 +25,8 @@ export function resolveTracingConfig(options) {
             const envVal = process.env.AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING;
             experimental = !!envVal && (envVal.toLowerCase() === "true" || envVal === "1");
         }
-        catch {
+        catch (e) {
+            logger.verbose(`Unable to read AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING env var, tracing disabled: ${e}`);
             experimental = false;
         }
     }
@@ -42,7 +44,8 @@ export function resolveTracingConfig(options) {
             const envVal = process.env.OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT;
             contentRecording = !!envVal && (envVal.toLowerCase() === "true" || envVal === "1");
         }
-        catch {
+        catch (e) {
+            logger.verbose(`Unable to read OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT env var: ${e}`);
             contentRecording = false;
         }
     }
@@ -58,8 +61,8 @@ export function resolveTracingConfig(options) {
                 traceContextPropagation = false;
             }
         }
-        catch {
-            // process.env may not exist in browser environments
+        catch (e) {
+            logger.verbose(`Unable to read AZURE_TRACING_GEN_AI_ENABLE_TRACE_CONTEXT_PROPAGATION env var: ${e}`);
         }
     }
     return { enabled, contentRecording, traceContextPropagation };

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

@@ -1 +1 @@
-{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../../src/tracing/configuration.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAiDlC;;;;;;;;;;;;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,MAAM,CAAC;YACP,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,MAAM,CAAC;YACP,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,MAAM,CAAC;YACP,oDAAoD;QACtD,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\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 {\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 {\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 {\n      // process.env may not exist in browser environments\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,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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure/ai-projects",
-  "version": "2.3.1",
+  "version": "2.5.0",
   "description": "Azure AI Projects client library.",
   "engines": {
     "node": ">=22.0.0"
@@ -35,10 +35,6 @@
   "prettier": "@azure/eslint-plugin-azure-sdk/prettier.json",
   "//metadata": {
     "constantPaths": [
-      {
-        "path": "src/aiProjectClient.ts",
-        "prefix": "userAgentInfo"
-      },
       {
         "path": "src/constants.ts",
         "prefix": "SDK_VERSION"
@@ -57,25 +53,25 @@
     "@azure/identity": "^4.13.0",
     "@azure/logger": "^1.1.4",
     "@azure/storage-blob": "^12.26.0",
-    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/api": "^1.9.1",
     "openai": "^6.16.0",
     "tslib": "^2.6.2"
   },
   "devDependencies": {
     "@azure-rest/ai-inference": "^1.0.0-beta.6",
     "@azure/arm-cognitiveservices": "8.1.0",
-    "@azure/monitor-opentelemetry": "^1.17.0",
+    "@azure/monitor-opentelemetry": "^1.19.0",
     "@azure/opentelemetry-instrumentation-azure-sdk": "^1.0.0",
     "@modelcontextprotocol/sdk": "^1.25.1",
-    "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/instrumentation": "^0.57.0",
-    "@opentelemetry/sdk-trace-node": "^2.0.0",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/instrumentation": "^0.220.0",
+    "@opentelemetry/sdk-trace-node": "^2.9.0",
     "@types/node": "^22.0.0",
     "@vitest/browser-playwright": "^4.1.2",
     "@vitest/coverage-istanbul": "^4.1.2",
     "cross-env": "^10.1.0",
     "dotenv": "^16.6.1",
-    "eslint": "^9.39.1",
+    "eslint": "^10.8.0",
     "mkdirp": "^3.0.1",
     "playwright": "^1.60.0",
     "prettier": "^3.9.1",
@@ -86,9 +82,9 @@
     "zod": "^4.2.1",
     "@azure-tools/test-credential": "^2.1.2",
     "@azure-tools/test-recorder": "^4.1.1",
-    "@azure-tools/test-utils-vitest": "^2.0.1",
     "@azure/dev-tool": "^1.0.0",
-    "@azure/eslint-plugin-azure-sdk": "^3.0.0"
+    "@azure/eslint-plugin-azure-sdk": "^3.0.0",
+    "@azure-tools/test-utils-vitest": "^2.0.1"
   },
   "exports": {
     "./package.json": "./package.json",