@azure/ai-projects 2.6.0 → 2.7.0

package/dist/commonjs/package.json

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

package/dist/commonjs/realtime/asyncQueue.d.ts

@@ -0,0 +1,29 @@
+interface AsyncQueueOptions {
+    onOverflow?: (error: Error) => void;
+}
+/** @internal */
+export declare class AsyncQueue<T> implements AsyncIterator<T> {
+    private readonly capacity;
+    private readonly options;
+    private readonly values;
+    private readonly pendingReads;
+    private valueHead;
+    private pendingReadHead;
+    private terminalError?;
+    private isClosed;
+    /**
+     * @param capacity - Maximum number of buffered values before the queue fails with an overflow
+     * error. Realtime sessions can produce events faster than the consumer iterates (or the caller
+     * may never start iterating), so an unbounded buffer would otherwise grow without limit.
+     */
+    constructor(capacity?: number, options?: AsyncQueueOptions);
+    enqueue(value: T): void;
+    close(): void;
+    fail(error: Error): void;
+    next(): Promise<IteratorResult<T>>;
+    private takePendingRead;
+    private compactValues;
+    private compactPendingReads;
+}
+export {};
+//# sourceMappingURL=asyncQueue.d.ts.map

package/dist/commonjs/realtime/asyncQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncQueue.d.ts","sourceRoot":"","sources":["../../../src/realtime/asyncQueue.ts"],"names":[],"mappings":"AAQA,UAAU,iBAAiB;IACzB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrC;AAED,gBAAgB;AAChB,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAclD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAd1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,aAAa,CAAC,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAS;IAEzB;;;;OAIG;gBAEgB,QAAQ,SAAS,EACjB,OAAO,GAAE,iBAAsB;IAG3C,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAyBvB,KAAK,IAAI,IAAI;IAab,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAclB,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAmB/C,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,mBAAmB;CAM5B"}

package/dist/commonjs/realtime/asyncQueue.js

@@ -0,0 +1,127 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var asyncQueue_exports = {};
+__export(asyncQueue_exports, {
+  AsyncQueue: () => AsyncQueue
+});
+module.exports = __toCommonJS(asyncQueue_exports);
+class AsyncQueue {
+  /**
+   * @param capacity - Maximum number of buffered values before the queue fails with an overflow
+   * error. Realtime sessions can produce events faster than the consumer iterates (or the caller
+   * may never start iterating), so an unbounded buffer would otherwise grow without limit.
+   */
+  constructor(capacity = 1e4, options = {}) {
+    this.capacity = capacity;
+    this.options = options;
+  }
+  capacity;
+  options;
+  values = [];
+  pendingReads = [];
+  valueHead = 0;
+  pendingReadHead = 0;
+  terminalError;
+  isClosed = false;
+  enqueue(value) {
+    if (this.isClosed) {
+      return;
+    }
+    const pendingRead = this.takePendingRead();
+    if (pendingRead) {
+      pendingRead.resolve({ done: false, value });
+      return;
+    }
+    if (this.values.length - this.valueHead >= this.capacity) {
+      const error = new Error(
+        `The voice-agent event queue exceeded its capacity of ${this.capacity} buffered event(s); the consumer is not iterating events fast enough.`
+      );
+      try {
+        this.options.onOverflow?.(error);
+      } finally {
+        this.fail(error);
+      }
+      return;
+    }
+    this.values.push(value);
+  }
+  close() {
+    if (this.isClosed) {
+      return;
+    }
+    this.isClosed = true;
+    for (const pendingRead of this.pendingReads.slice(this.pendingReadHead)) {
+      pendingRead.resolve({ done: true, value: void 0 });
+    }
+    this.pendingReads.length = 0;
+    this.pendingReadHead = 0;
+  }
+  fail(error) {
+    if (this.isClosed) {
+      return;
+    }
+    this.isClosed = true;
+    this.terminalError = error;
+    for (const pendingRead of this.pendingReads.slice(this.pendingReadHead)) {
+      pendingRead.reject(error);
+    }
+    this.pendingReads.length = 0;
+    this.pendingReadHead = 0;
+  }
+  async next() {
+    if (this.valueHead < this.values.length) {
+      const value = this.values[this.valueHead++];
+      this.compactValues();
+      return { done: false, value };
+    }
+    if (this.terminalError) {
+      throw this.terminalError;
+    }
+    if (this.isClosed) {
+      return { done: true, value: void 0 };
+    }
+    return new Promise((resolve, reject) => {
+      this.pendingReads.push({ resolve, reject });
+    });
+  }
+  takePendingRead() {
+    if (this.pendingReadHead >= this.pendingReads.length) {
+      return void 0;
+    }
+    const pendingRead = this.pendingReads[this.pendingReadHead++];
+    this.compactPendingReads();
+    return pendingRead;
+  }
+  compactValues() {
+    if (this.valueHead > 64 && this.valueHead * 2 >= this.values.length) {
+      this.values.splice(0, this.valueHead);
+      this.valueHead = 0;
+    }
+  }
+  compactPendingReads() {
+    if (this.pendingReadHead > 64 && this.pendingReadHead * 2 >= this.pendingReads.length) {
+      this.pendingReads.splice(0, this.pendingReadHead);
+      this.pendingReadHead = 0;
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AsyncQueue
+});
+//# sourceMappingURL=asyncQueue.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/realtime/asyncQueue.ts"],
+  "sourcesContent": ["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\ninterface PendingRead<T> {\n  resolve: (result: IteratorResult<T>) => void;\n  reject: (reason: unknown) => void;\n}\n\ninterface AsyncQueueOptions {\n  onOverflow?: (error: Error) => void;\n}\n\n/** @internal */\nexport class AsyncQueue<T> implements AsyncIterator<T> {\n  private readonly values: T[] = [];\n  private readonly pendingReads: PendingRead<T>[] = [];\n  private valueHead = 0;\n  private pendingReadHead = 0;\n  private terminalError?: Error;\n  private isClosed = false;\n\n  /**\n   * @param capacity - Maximum number of buffered values before the queue fails with an overflow\n   * error. Realtime sessions can produce events faster than the consumer iterates (or the caller\n   * may never start iterating), so an unbounded buffer would otherwise grow without limit.\n   */\n  public constructor(\n    private readonly capacity = 10_000,\n    private readonly options: AsyncQueueOptions = {},\n  ) {}\n\n  public enqueue(value: T): void {\n    if (this.isClosed) {\n      return;\n    }\n\n    const pendingRead = this.takePendingRead();\n    if (pendingRead) {\n      pendingRead.resolve({ done: false, value });\n      return;\n    }\n    if (this.values.length - this.valueHead >= this.capacity) {\n      const error = new Error(\n        `The voice-agent event queue exceeded its capacity of ${this.capacity} buffered event(s); the consumer is not iterating events fast enough.`,\n      );\n      try {\n        // Let the owner fail the queue with its public error before applying the fallback.\n        this.options.onOverflow?.(error);\n      } finally {\n        this.fail(error);\n      }\n      return;\n    }\n    this.values.push(value);\n  }\n\n  public close(): void {\n    if (this.isClosed) {\n      return;\n    }\n\n    this.isClosed = true;\n    for (const pendingRead of this.pendingReads.slice(this.pendingReadHead)) {\n      pendingRead.resolve({ done: true, value: undefined });\n    }\n    this.pendingReads.length = 0;\n    this.pendingReadHead = 0;\n  }\n\n  public fail(error: Error): void {\n    if (this.isClosed) {\n      return;\n    }\n\n    this.isClosed = true;\n    this.terminalError = error;\n    for (const pendingRead of this.pendingReads.slice(this.pendingReadHead)) {\n      pendingRead.reject(error);\n    }\n    this.pendingReads.length = 0;\n    this.pendingReadHead = 0;\n  }\n\n  public async next(): Promise<IteratorResult<T>> {\n    if (this.valueHead < this.values.length) {\n      const value = this.values[this.valueHead++];\n      this.compactValues();\n      return { done: false, value };\n    }\n    if (this.terminalError) {\n      throw this.terminalError;\n    }\n    if (this.isClosed) {\n      return { done: true, value: undefined };\n    }\n\n    // Nothing buffered: park a read for `enqueue`/`close`/`fail` to settle.\n    return new Promise<IteratorResult<T>>((resolve, reject) => {\n      this.pendingReads.push({ resolve, reject });\n    });\n  }\n\n  private takePendingRead(): PendingRead<T> | undefined {\n    if (this.pendingReadHead >= this.pendingReads.length) {\n      return undefined;\n    }\n    const pendingRead = this.pendingReads[this.pendingReadHead++];\n    this.compactPendingReads();\n    return pendingRead;\n  }\n\n  private compactValues(): void {\n    if (this.valueHead > 64 && this.valueHead * 2 >= this.values.length) {\n      this.values.splice(0, this.valueHead);\n      this.valueHead = 0;\n    }\n  }\n\n  private compactPendingReads(): void {\n    if (this.pendingReadHead > 64 && this.pendingReadHead * 2 >= this.pendingReads.length) {\n      this.pendingReads.splice(0, this.pendingReadHead);\n      this.pendingReadHead = 0;\n    }\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAaO,MAAM,WAA0C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAa9C,YACY,WAAW,KACX,UAA6B,CAAC,GAC/C;AAFiB;AACA;AAAA,EAChB;AAAA,EAFgB;AAAA,EACA;AAAA,EAdF,SAAc,CAAC;AAAA,EACf,eAAiC,CAAC;AAAA,EAC3C,YAAY;AAAA,EACZ,kBAAkB;AAAA,EAClB;AAAA,EACA,WAAW;AAAA,EAYZ,QAAQ,OAAgB;AAC7B,QAAI,KAAK,UAAU;AACjB;AAAA,IACF;AAEA,UAAM,cAAc,KAAK,gBAAgB;AACzC,QAAI,aAAa;AACf,kBAAY,QAAQ,EAAE,MAAM,OAAO,MAAM,CAAC;AAC1C;AAAA,IACF;AACA,QAAI,KAAK,OAAO,SAAS,KAAK,aAAa,KAAK,UAAU;AACxD,YAAM,QAAQ,IAAI;AAAA,QAChB,wDAAwD,KAAK,QAAQ;AAAA,MACvE;AACA,UAAI;AAEF,aAAK,QAAQ,aAAa,KAAK;AAAA,MACjC,UAAE;AACA,aAAK,KAAK,KAAK;AAAA,MACjB;AACA;AAAA,IACF;AACA,SAAK,OAAO,KAAK,KAAK;AAAA,EACxB;AAAA,EAEO,QAAc;AACnB,QAAI,KAAK,UAAU;AACjB;AAAA,IACF;AAEA,SAAK,WAAW;AAChB,eAAW,eAAe,KAAK,aAAa,MAAM,KAAK,eAAe,GAAG;AACvE,kBAAY,QAAQ,EAAE,MAAM,MAAM,OAAO,OAAU,CAAC;AAAA,IACtD;AACA,SAAK,aAAa,SAAS;AAC3B,SAAK,kBAAkB;AAAA,EACzB;AAAA,EAEO,KAAK,OAAoB;AAC9B,QAAI,KAAK,UAAU;AACjB;AAAA,IACF;AAEA,SAAK,WAAW;AAChB,SAAK,gBAAgB;AACrB,eAAW,eAAe,KAAK,aAAa,MAAM,KAAK,eAAe,GAAG;AACvE,kBAAY,OAAO,KAAK;AAAA,IAC1B;AACA,SAAK,aAAa,SAAS;AAC3B,SAAK,kBAAkB;AAAA,EACzB;AAAA,EAEA,MAAa,OAAmC;AAC9C,QAAI,KAAK,YAAY,KAAK,OAAO,QAAQ;AACvC,YAAM,QAAQ,KAAK,OAAO,KAAK,WAAW;AAC1C,WAAK,cAAc;AACnB,aAAO,EAAE,MAAM,OAAO,MAAM;AAAA,IAC9B;AACA,QAAI,KAAK,eAAe;AACtB,YAAM,KAAK;AAAA,IACb;AACA,QAAI,KAAK,UAAU;AACjB,aAAO,EAAE,MAAM,MAAM,OAAO,OAAU;AAAA,IACxC;AAGA,WAAO,IAAI,QAA2B,CAAC,SAAS,WAAW;AACzD,WAAK,aAAa,KAAK,EAAE,SAAS,OAAO,CAAC;AAAA,IAC5C,CAAC;AAAA,EACH;AAAA,EAEQ,kBAA8C;AACpD,QAAI,KAAK,mBAAmB,KAAK,aAAa,QAAQ;AACpD,aAAO;AAAA,IACT;AACA,UAAM,cAAc,KAAK,aAAa,KAAK,iBAAiB;AAC5D,SAAK,oBAAoB;AACzB,WAAO;AAAA,EACT;AAAA,EAEQ,gBAAsB;AAC5B,QAAI,KAAK,YAAY,MAAM,KAAK,YAAY,KAAK,KAAK,OAAO,QAAQ;AACnE,WAAK,OAAO,OAAO,GAAG,KAAK,SAAS;AACpC,WAAK,YAAY;AAAA,IACnB;AAAA,EACF;AAAA,EAEQ,sBAA4B;AAClC,QAAI,KAAK,kBAAkB,MAAM,KAAK,kBAAkB,KAAK,KAAK,aAAa,QAAQ;AACrF,WAAK,aAAa,OAAO,GAAG,KAAK,eAAe;AAChD,WAAK,kBAAkB;AAAA,IACzB;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/commonjs/realtime/errors.d.ts

@@ -0,0 +1,34 @@
+/** Error codes raised by the Voice Agents realtime client. */
+export type VoiceAgentRealtimeErrorCode = "authenticationFailed" | "connectionFailed" | "connectionClosed" | "invalidState" | "operationCancelled" | "protocolError" | "sendFailed";
+/** Base error raised by the Voice Agents realtime client. */
+export declare class VoiceAgentRealtimeError extends Error {
+    /** A stable code identifying the error category. */
+    readonly code: VoiceAgentRealtimeErrorCode;
+    /** The underlying error, when available. */
+    readonly cause?: unknown;
+    constructor(message: string, code: VoiceAgentRealtimeErrorCode, options?: {
+        cause?: unknown;
+    });
+}
+/** An error raised while acquiring a Microsoft Entra access token. */
+export declare class VoiceAgentAuthenticationError extends VoiceAgentRealtimeError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** An error raised by the WebSocket connection. */
+export declare class VoiceAgentConnectionError extends VoiceAgentRealtimeError {
+    /** The WebSocket close code, when the error was caused by a close frame. */
+    readonly closeCode?: number;
+    constructor(message: string, code: Extract<VoiceAgentRealtimeErrorCode, "connectionFailed" | "connectionClosed" | "invalidState" | "operationCancelled" | "sendFailed">, options?: {
+        cause?: unknown;
+        closeCode?: number;
+    });
+}
+/** An error raised when a WebSocket message does not match the voice-agent protocol. */
+export declare class VoiceAgentProtocolError extends VoiceAgentRealtimeError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/commonjs/realtime/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/realtime/errors.ts"],"names":[],"mappings":"AAGA,8DAA8D;AAC9D,MAAM,MAAM,2BAA2B,GACnC,sBAAsB,GACtB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,oBAAoB,GACpB,eAAe,GACf,YAAY,CAAC;AAEjB,6DAA6D;AAC7D,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,oDAAoD;IACpD,SAAgB,IAAI,EAAE,2BAA2B,CAAC;IAClD,4CAA4C;IAC5C,SAAyB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAGvC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,2BAA2B,EACjC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAOpC;AAED,sEAAsE;AACtE,qBAAa,6BAA8B,SAAQ,uBAAuB;gBACrD,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAItE;AAED,mDAAmD;AACnD,qBAAa,yBAA0B,SAAQ,uBAAuB;IACpE,4EAA4E;IAC5E,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,CACX,2BAA2B,EAC3B,kBAAkB,GAAG,kBAAkB,GAAG,cAAc,GAAG,oBAAoB,GAAG,YAAY,CAC/F,EACD,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;CAMxD;AAED,wFAAwF;AACxF,qBAAa,uBAAwB,SAAQ,uBAAuB;gBAC/C,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;CAItE"}

package/dist/commonjs/realtime/errors.js

@@ -0,0 +1,66 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var errors_exports = {};
+__export(errors_exports, {
+  VoiceAgentAuthenticationError: () => VoiceAgentAuthenticationError,
+  VoiceAgentConnectionError: () => VoiceAgentConnectionError,
+  VoiceAgentProtocolError: () => VoiceAgentProtocolError,
+  VoiceAgentRealtimeError: () => VoiceAgentRealtimeError
+});
+module.exports = __toCommonJS(errors_exports);
+class VoiceAgentRealtimeError extends Error {
+  /** A stable code identifying the error category. */
+  code;
+  /** The underlying error, when available. */
+  cause;
+  constructor(message, code, options = {}) {
+    super(message);
+    this.name = "VoiceAgentRealtimeError";
+    this.code = code;
+    this.cause = options.cause;
+  }
+}
+class VoiceAgentAuthenticationError extends VoiceAgentRealtimeError {
+  constructor(message, options = {}) {
+    super(message, "authenticationFailed", options);
+    this.name = "VoiceAgentAuthenticationError";
+  }
+}
+class VoiceAgentConnectionError extends VoiceAgentRealtimeError {
+  /** The WebSocket close code, when the error was caused by a close frame. */
+  closeCode;
+  constructor(message, code, options = {}) {
+    super(message, code, options);
+    this.name = "VoiceAgentConnectionError";
+    this.closeCode = options.closeCode;
+  }
+}
+class VoiceAgentProtocolError extends VoiceAgentRealtimeError {
+  constructor(message, options = {}) {
+    super(message, "protocolError", options);
+    this.name = "VoiceAgentProtocolError";
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VoiceAgentAuthenticationError,
+  VoiceAgentConnectionError,
+  VoiceAgentProtocolError,
+  VoiceAgentRealtimeError
+});
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/realtime/errors.ts"],
+  "sourcesContent": ["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\n/** Error codes raised by the Voice Agents realtime client. */\nexport type VoiceAgentRealtimeErrorCode =\n  | \"authenticationFailed\"\n  | \"connectionFailed\"\n  | \"connectionClosed\"\n  | \"invalidState\"\n  | \"operationCancelled\"\n  | \"protocolError\"\n  | \"sendFailed\";\n\n/** Base error raised by the Voice Agents realtime client. */\nexport class VoiceAgentRealtimeError extends Error {\n  /** A stable code identifying the error category. */\n  public readonly code: VoiceAgentRealtimeErrorCode;\n  /** The underlying error, when available. */\n  public override readonly cause?: unknown;\n\n  public constructor(\n    message: string,\n    code: VoiceAgentRealtimeErrorCode,\n    options: { cause?: unknown } = {},\n  ) {\n    super(message);\n    this.name = \"VoiceAgentRealtimeError\";\n    this.code = code;\n    this.cause = options.cause;\n  }\n}\n\n/** An error raised while acquiring a Microsoft Entra access token. */\nexport class VoiceAgentAuthenticationError extends VoiceAgentRealtimeError {\n  public constructor(message: string, options: { cause?: unknown } = {}) {\n    super(message, \"authenticationFailed\", options);\n    this.name = \"VoiceAgentAuthenticationError\";\n  }\n}\n\n/** An error raised by the WebSocket connection. */\nexport class VoiceAgentConnectionError extends VoiceAgentRealtimeError {\n  /** The WebSocket close code, when the error was caused by a close frame. */\n  public readonly closeCode?: number;\n\n  public constructor(\n    message: string,\n    code: Extract<\n      VoiceAgentRealtimeErrorCode,\n      \"connectionFailed\" | \"connectionClosed\" | \"invalidState\" | \"operationCancelled\" | \"sendFailed\"\n    >,\n    options: { cause?: unknown; closeCode?: number } = {},\n  ) {\n    super(message, code, options);\n    this.name = \"VoiceAgentConnectionError\";\n    this.closeCode = options.closeCode;\n  }\n}\n\n/** An error raised when a WebSocket message does not match the voice-agent protocol. */\nexport class VoiceAgentProtocolError extends VoiceAgentRealtimeError {\n  public constructor(message: string, options: { cause?: unknown } = {}) {\n    super(message, \"protocolError\", options);\n    this.name = \"VoiceAgentProtocolError\";\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAcO,MAAM,gCAAgC,MAAM;AAAA;AAAA,EAEjC;AAAA;AAAA,EAES;AAAA,EAElB,YACL,SACA,MACA,UAA+B,CAAC,GAChC;AACA,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,QAAQ,QAAQ;AAAA,EACvB;AACF;AAGO,MAAM,sCAAsC,wBAAwB;AAAA,EAClE,YAAY,SAAiB,UAA+B,CAAC,GAAG;AACrE,UAAM,SAAS,wBAAwB,OAAO;AAC9C,SAAK,OAAO;AAAA,EACd;AACF;AAGO,MAAM,kCAAkC,wBAAwB;AAAA;AAAA,EAErD;AAAA,EAET,YACL,SACA,MAIA,UAAmD,CAAC,GACpD;AACA,UAAM,SAAS,MAAM,OAAO;AAC5B,SAAK,OAAO;AACZ,SAAK,YAAY,QAAQ;AAAA,EAC3B;AACF;AAGO,MAAM,gCAAgC,wBAAwB;AAAA,EAC5D,YAAY,SAAiB,UAA+B,CAAC,GAAG;AACrE,UAAM,SAAS,iBAAiB,OAAO;AACvC,SAAK,OAAO;AAAA,EACd;AACF;",
+  "names": []
+}

package/dist/commonjs/realtime/events.d.ts

@@ -0,0 +1,24 @@
+import type { VoiceAgentServerEvent } from "../models/models.js";
+/**
+ * A server event whose wire type is not recognized by this version of the SDK.
+ *
+ * The SDK delivers these events without closing the connection or applying known-event
+ * validation or normalization. Inspect and validate raw fields before using them.
+ */
+export interface VoiceAgentUnknownEvent {
+    /** SDK fallback discriminator, distinct from every known server event type. */
+    type: "unknown";
+    /** Original `type` discriminator received from the service. */
+    eventType: string;
+    /** Complete parsed JSON event, including its original `type` and all other wire fields. */
+    rawEvent: Record<string, unknown>;
+}
+/**
+ * An event received from a voice-agent realtime connection.
+ *
+ * Known events retain their generated types and normalization. Unrecognized wire types
+ * are wrapped in {@link VoiceAgentUnknownEvent}. Switch on `type` to narrow known events,
+ * or exclude `type === "unknown"` before passing an event to a known-event handler.
+ */
+export type VoiceAgentRealtimeEvent = VoiceAgentServerEvent | VoiceAgentUnknownEvent;
+//# sourceMappingURL=events.d.ts.map

package/dist/commonjs/realtime/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/realtime/events.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,IAAI,EAAE,SAAS,CAAC;IAChB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAAG,qBAAqB,GAAG,sBAAsB,CAAC"}

package/dist/commonjs/realtime/events.js

@@ -0,0 +1,16 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var events_exports = {};
+module.exports = __toCommonJS(events_exports);
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/realtime/events.ts"],
+  "sourcesContent": ["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { VoiceAgentServerEvent } from \"../models/models.js\";\n\n/**\n * A server event whose wire type is not recognized by this version of the SDK.\n *\n * The SDK delivers these events without closing the connection or applying known-event\n * validation or normalization. Inspect and validate raw fields before using them.\n */\nexport interface VoiceAgentUnknownEvent {\n  /** SDK fallback discriminator, distinct from every known server event type. */\n  type: \"unknown\";\n  /** Original `type` discriminator received from the service. */\n  eventType: string;\n  /** Complete parsed JSON event, including its original `type` and all other wire fields. */\n  rawEvent: Record<string, unknown>;\n}\n\n/**\n * An event received from a voice-agent realtime connection.\n *\n * Known events retain their generated types and normalization. Unrecognized wire types\n * are wrapped in {@link VoiceAgentUnknownEvent}. Switch on `type` to narrow known events,\n * or exclude `type === \"unknown\"` before passing an event to a known-event handler.\n */\nexport type VoiceAgentRealtimeEvent = VoiceAgentServerEvent | VoiceAgentUnknownEvent;\n"],
+  "mappings": ";;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/dist/commonjs/realtime/protocol.d.ts

@@ -0,0 +1,7 @@
+import type { VoiceAgentClientEvent } from "../models/models.js";
+import type { VoiceAgentRealtimeEvent } from "./events.js";
+/** @internal */
+export declare function serializeVoiceAgentClientEvent(event: VoiceAgentClientEvent): string;
+/** @internal */
+export declare function deserializeVoiceAgentServerEvent(data: string | ArrayBuffer): VoiceAgentRealtimeEvent;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/commonjs/realtime/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/realtime/protocol.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAyB,MAAM,qBAAqB,CAAC;AAGxF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAiH3D,gBAAgB;AAChB,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAiBnF;AAeD,gBAAgB;AAChB,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,MAAM,GAAG,WAAW,GACzB,uBAAuB,CAuCzB"}