@azure/ai-projects 2.5.0 → 2.7.0

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

@@ -0,0 +1,31 @@
+import type { AbortSignalLike } from "@azure/abort-controller";
+import type { VoiceAgentWebSocketConnectOptions, VoiceAgentWebSocketFactory, VoiceAgentWebSocketHandlers, VoiceAgentWebSocketTransport } from "./realtime/webSocketTransportLike.js";
+/**
+ * Default browser transport for the Voice Agents realtime client.
+ *
+ * Browsers cannot set an `Authorization` header on a WebSocket upgrade request. This transport sends
+ * the Microsoft Entra bearer token as the `authorization.bearer.<token>` WebSocket subprotocol,
+ * which the service converts back into an `Authorization` header before forwarding the request.
+ */
+export declare class BrowserWebSocketTransport implements VoiceAgentWebSocketTransport {
+    private webSocket?;
+    private handlers?;
+    private readonly closeTimeoutInMs;
+    private messageChain;
+    private closeNotified;
+    constructor(closeTimeoutInMs?: number);
+    setHandlers(handlers: VoiceAgentWebSocketHandlers): void;
+    connect(options: VoiceAgentWebSocketConnectOptions): Promise<void>;
+    send(data: string, abortSignal?: AbortSignalLike): Promise<void>;
+    /** Chains `data` behind `previous` so an async `Blob` conversion cannot reorder events. */
+    private deliverMessage;
+    /** Reports the close only after every earlier message has reached the parser. */
+    private deliverClose;
+    private handleIncomingMessage;
+    close(code: number, reason: string): Promise<void>;
+}
+/** @internal */
+export declare function addHeadersToUrl(url: string, headers: Record<string, string>): string;
+/** @internal */
+export declare function createDefaultVoiceAgentWebSocketFactory(): VoiceAgentWebSocketFactory;
+//# sourceMappingURL=webSocketTransport-browser.d.mts.map

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

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

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

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

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

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

package/dist/react-native/webSocketTransport.d.ts

@@ -0,0 +1,2 @@
+export * from "./webSocketTransport-browser.mjs";
+//# sourceMappingURL=webSocketTransport.d.ts.map

package/dist/react-native/webSocketTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webSocketTransport.d.ts","sourceRoot":"","sources":["../../src/webSocketTransport.ts"],"names":[],"mappings":"AAKA,cAAc,kCAAkC,CAAC"}

package/dist/react-native/webSocketTransport.js

@@ -0,0 +1,6 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+// React Native's global WebSocket is browser-compatible, so reuse that transport as-is
+// (same pattern as get-binary-stream-response-react-native.mts).
+export * from "./webSocketTransport-browser.mjs";
+//# sourceMappingURL=webSocketTransport.js.map

package/dist/react-native/webSocketTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webSocketTransport.js","sourceRoot":"","sources":["../../src/webSocketTransport.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,uFAAuF;AACvF,iEAAiE;AACjE,cAAc,kCAAkC,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\n// React Native's global WebSocket is browser-compatible, so reuse that transport as-is\n// (same pattern as get-binary-stream-response-react-native.mts).\nexport * from \"./webSocketTransport-browser.mjs\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure/ai-projects",
-  "version": "2.5.0",
+  "version": "2.7.0",
   "description": "Azure AI Projects client library.",
   "engines": {
     "node": ">=22.0.0"
@@ -54,19 +54,27 @@
     "@azure/logger": "^1.1.4",
     "@azure/storage-blob": "^12.26.0",
     "@opentelemetry/api": "^1.9.1",
+    "https-proxy-agent": "^7.0.1",
     "openai": "^6.16.0",
-    "tslib": "^2.6.2"
+    "tslib": "^2.6.2",
+    "ws": "^8.18.3"
   },
   "devDependencies": {
     "@azure-rest/ai-inference": "^1.0.0-beta.6",
+    "@azure-tools/test-credential": "^2.1.2",
+    "@azure-tools/test-recorder": "^4.1.1",
+    "@azure-tools/test-utils-vitest": "^2.0.1",
     "@azure/arm-cognitiveservices": "8.1.0",
-    "@azure/monitor-opentelemetry": "^1.19.0",
+    "@azure/dev-tool": "^1.0.0",
+    "@azure/eslint-plugin-azure-sdk": "^3.0.0",
+    "@azure/monitor-opentelemetry": "^1.20.0",
     "@azure/opentelemetry-instrumentation-azure-sdk": "^1.0.0",
     "@modelcontextprotocol/sdk": "^1.25.1",
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/instrumentation": "^0.220.0",
     "@opentelemetry/sdk-trace-node": "^2.9.0",
     "@types/node": "^22.0.0",
+    "@types/ws": "^8.18.1",
     "@vitest/browser-playwright": "^4.1.2",
     "@vitest/coverage-istanbul": "^4.1.2",
     "cross-env": "^10.1.0",
@@ -79,12 +87,7 @@
     "rimraf": "^6.1.0",
     "typescript": "~6.0.2",
     "vitest": "^4.1.2",
-    "zod": "^4.2.1",
-    "@azure-tools/test-credential": "^2.1.2",
-    "@azure-tools/test-recorder": "^4.1.1",
-    "@azure/dev-tool": "^1.0.0",
-    "@azure/eslint-plugin-azure-sdk": "^3.0.0",
-    "@azure-tools/test-utils-vitest": "^2.0.1"
+    "zod": "^4.2.1"
   },
   "exports": {
     "./package.json": "./package.json",