@livekit/agents 1.1.0 → 1.2.1

package/dist/typed_promise.d.ts

@@ -0,0 +1,24 @@
+type InferErrors<T> = T extends TypedPromise<any, infer E> ? E : never;
+interface PromiseRejectedResult<E> {
+    status: 'rejected';
+    reason: E;
+}
+type SettledResult<T> = T extends TypedPromise<infer U, infer E> ? PromiseFulfilledResult<U> | PromiseRejectedResult<E> : T extends PromiseLike<infer U> ? PromiseFulfilledResult<U> | PromiseRejectedResult<unknown> : PromiseFulfilledResult<T> | PromiseRejectedResult<unknown>;
+export default class TypedPromise<T, E extends Error> extends Promise<T> {
+    constructor(executor: (resolve: (value: T | PromiseLike<T>) => void, reject: (reason: E) => void) => void);
+    catch<TResult = never>(onrejected?: ((reason: E) => TResult | PromiseLike<TResult>) | null | undefined): TypedPromise<T | TResult, E>;
+    static resolve: {
+        (): TypedPromise<void, never>;
+        <V>(value: V): TypedPromise<Awaited<V>, never>;
+    };
+    static reject<E extends Error>(reason: E): TypedPromise<never, E>;
+    static all<T extends readonly unknown[] | []>(values: T): TypedPromise<{
+        -readonly [P in keyof T]: Awaited<T[P]>;
+    }, InferErrors<T[number]>>;
+    static allSettled<T extends readonly unknown[] | []>(values: T): TypedPromise<{
+        -readonly [P in keyof T]: SettledResult<T[P]>;
+    }, never>;
+    static race<T extends readonly (TypedPromise<any, any> | any)[]>(values: T): TypedPromise<T[number] extends TypedPromise<infer U, any> ? U : T[number] extends PromiseLike<infer U> ? U : Awaited<T[number]>, InferErrors<T[number]>>;
+}
+export {};
+//# sourceMappingURL=typed_promise.d.ts.map

package/dist/typed_promise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed_promise.d.ts","sourceRoot":"","sources":["../src/typed_promise.ts"],"names":[],"mappings":"AAGA,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEvE,UAAU,qBAAqB,CAAC,CAAC;IAC/B,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,CAAC,CAAC;CACX;AAED,KAAK,aAAa,CAAC,CAAC,IAClB,CAAC,SAAS,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GACpC,sBAAsB,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,GACpD,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,CAAC,GAC5B,sBAAsB,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,OAAO,CAAC,GAC1D,sBAAsB,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAEnE,MAAM,CAAC,OAAO,OAAO,YAAY,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;gBAGpE,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,KAAK,IAAI;IAK/F,KAAK,CAAC,OAAO,GAAG,KAAK,EACnB,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GAC9E,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,CAAC;IAI/B,MAAM,CAAC,OAAO,EAAE;QACd,IAAI,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;KAChD,CAEC;IAEF,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC;IAIjE,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,GAAG,EAAE,EAC1C,MAAM,EAAE,CAAC,GACR,YAAY,CAAC;QAAE,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAIpF,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,GAAG,EAAE,EACjD,MAAM,EAAE,CAAC,GACR,YAAY,CAAC;QAAE,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,EAAE,KAAK,CAAC;IAIzE,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,EAAE,EAC7D,MAAM,EAAE,CAAC,GACR,YAAY,CACb,CAAC,CAAC,MAAM,CAAC,SAAS,YAAY,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,GACxC,CAAC,GACD,CAAC,CAAC,MAAM,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,CAAC,GACpC,CAAC,GACD,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EACxB,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CACvB;CAGF"}

package/dist/typed_promise.js

@@ -0,0 +1,28 @@
+class TypedPromise extends Promise {
+  // eslint-disable-next-line @typescript-eslint/no-useless-constructor
+  constructor(executor) {
+    super(executor);
+  }
+  catch(onrejected) {
+    return super.catch(onrejected);
+  }
+  static resolve = (value) => {
+    return super.resolve(value);
+  };
+  static reject(reason) {
+    return super.reject(reason);
+  }
+  static all(values) {
+    return super.all(values);
+  }
+  static allSettled(values) {
+    return super.allSettled(values);
+  }
+  static race(values) {
+    return super.race(values);
+  }
+}
+export {
+  TypedPromise as default
+};
+//# sourceMappingURL=typed_promise.js.map

package/dist/typed_promise.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/typed_promise.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\ntype InferErrors<T> = T extends TypedPromise<any, infer E> ? E : never;\n\ninterface PromiseRejectedResult<E> {\n  status: 'rejected';\n  reason: E;\n}\n\ntype SettledResult<T> =\n  T extends TypedPromise<infer U, infer E>\n    ? PromiseFulfilledResult<U> | PromiseRejectedResult<E>\n    : T extends PromiseLike<infer U>\n      ? PromiseFulfilledResult<U> | PromiseRejectedResult<unknown>\n      : PromiseFulfilledResult<T> | PromiseRejectedResult<unknown>;\n\nexport default class TypedPromise<T, E extends Error> extends Promise<T> {\n  // eslint-disable-next-line @typescript-eslint/no-useless-constructor\n  constructor(\n    executor: (resolve: (value: T | PromiseLike<T>) => void, reject: (reason: E) => void) => void,\n  ) {\n    super(executor);\n  }\n\n  catch<TResult = never>(\n    onrejected?: ((reason: E) => TResult | PromiseLike<TResult>) | null | undefined,\n  ): TypedPromise<T | TResult, E> {\n    return super.catch(onrejected);\n  }\n\n  static resolve: {\n    (): TypedPromise<void, never>;\n    <V>(value: V): TypedPromise<Awaited<V>, never>;\n  } = <V>(value?: V): TypedPromise<Awaited<V>, never> => {\n    return super.resolve(value) as TypedPromise<Awaited<V>, never>;\n  };\n\n  static reject<E extends Error>(reason: E): TypedPromise<never, E> {\n    return super.reject(reason);\n  }\n\n  static all<T extends readonly unknown[] | []>(\n    values: T,\n  ): TypedPromise<{ -readonly [P in keyof T]: Awaited<T[P]> }, InferErrors<T[number]>> {\n    return super.all(values) as any;\n  }\n\n  static allSettled<T extends readonly unknown[] | []>(\n    values: T,\n  ): TypedPromise<{ -readonly [P in keyof T]: SettledResult<T[P]> }, never> {\n    return super.allSettled(values) as any;\n  }\n\n  static race<T extends readonly (TypedPromise<any, any> | any)[]>(\n    values: T,\n  ): TypedPromise<\n    T[number] extends TypedPromise<infer U, any>\n      ? U\n      : T[number] extends PromiseLike<infer U>\n        ? U\n        : Awaited<T[number]>,\n    InferErrors<T[number]>\n  > {\n    return super.race(values);\n  }\n}\n"],"mappings":"AAiBA,MAAO,qBAAuD,QAAW;AAAA;AAAA,EAEvE,YACE,UACA;AACA,UAAM,QAAQ;AAAA,EAChB;AAAA,EAEA,MACE,YAC8B;AAC9B,WAAO,MAAM,MAAM,UAAU;AAAA,EAC/B;AAAA,EAEA,OAAO,UAGH,CAAI,UAA+C;AACrD,WAAO,MAAM,QAAQ,KAAK;AAAA,EAC5B;AAAA,EAEA,OAAO,OAAwB,QAAmC;AAChE,WAAO,MAAM,OAAO,MAAM;AAAA,EAC5B;AAAA,EAEA,OAAO,IACL,QACmF;AACnF,WAAO,MAAM,IAAI,MAAM;AAAA,EACzB;AAAA,EAEA,OAAO,WACL,QACwE;AACxE,WAAO,MAAM,WAAW,MAAM;AAAA,EAChC;AAAA,EAEA,OAAO,KACL,QAQA;AACA,WAAO,MAAM,KAAK,MAAM;AAAA,EAC1B;AACF;","names":[]}

package/dist/types.cjs

@@ -18,43 +18,35 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var types_exports = {};
 __export(types_exports, {
-  APIConnectOptions: () => APIConnectOptions,
-  DEFAULT_API_CONNECT_OPTIONS: () => DEFAULT_API_CONNECT_OPTIONS
+  DEFAULT_API_CONNECT_OPTIONS: () => DEFAULT_API_CONNECT_OPTIONS,
+  DEFAULT_SESSION_CONNECT_OPTIONS: () => DEFAULT_SESSION_CONNECT_OPTIONS,
+  USERDATA_TIMED_TRANSCRIPT: () => USERDATA_TIMED_TRANSCRIPT,
+  intervalForRetry: () => intervalForRetry
 });
 module.exports = __toCommonJS(types_exports);
-class APIConnectOptions {
-  /** Maximum number of retries to connect to the API. */
-  maxRetry;
-  /** Interval between retries to connect to the API in milliseconds. */
-  retryIntervalMs;
-  /** Timeout for connecting to the API in milliseconds. */
-  timeoutMs;
-  constructor(options = {}) {
-    this.maxRetry = options.maxRetry ?? 3;
-    this.retryIntervalMs = options.retryIntervalMs ?? 2e3;
-    this.timeoutMs = options.timeoutMs ?? 1e4;
-    if (this.maxRetry < 0) {
-      throw new Error("maxRetry must be greater than or equal to 0");
-    }
-    if (this.retryIntervalMs < 0) {
-      throw new Error("retryIntervalMs must be greater than or equal to 0");
-    }
-    if (this.timeoutMs < 0) {
-      throw new Error("timeoutMs must be greater than or equal to 0");
-    }
-  }
-  /** @internal */
-  _intervalForRetry(numRetries) {
-    if (numRetries === 0) {
-      return 0.1;
-    }
-    return this.retryIntervalMs;
+const USERDATA_TIMED_TRANSCRIPT = "lk.timed_transcripts";
+const DEFAULT_API_CONNECT_OPTIONS = {
+  maxRetry: 3,
+  retryIntervalMs: 2e3,
+  timeoutMs: 1e4
+};
+function intervalForRetry(connOptions, numRetries) {
+  if (numRetries === 0) {
+    return 0.1;
   }
+  return connOptions.retryIntervalMs;
 }
-const DEFAULT_API_CONNECT_OPTIONS = new APIConnectOptions();
+const DEFAULT_SESSION_CONNECT_OPTIONS = {
+  sttConnOptions: DEFAULT_API_CONNECT_OPTIONS,
+  llmConnOptions: DEFAULT_API_CONNECT_OPTIONS,
+  ttsConnOptions: DEFAULT_API_CONNECT_OPTIONS,
+  maxUnrecoverableErrors: 3
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  APIConnectOptions,
-  DEFAULT_API_CONNECT_OPTIONS
+  DEFAULT_API_CONNECT_OPTIONS,
+  DEFAULT_SESSION_CONNECT_OPTIONS,
+  USERDATA_TIMED_TRANSCRIPT,
+  intervalForRetry
 });
 //# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport class APIConnectOptions {\n  /** Maximum number of retries to connect to the API. */\n  readonly maxRetry: number;\n  /** Interval between retries to connect to the API in milliseconds. */\n  readonly retryIntervalMs: number;\n  /** Timeout for connecting to the API in milliseconds. */\n  readonly timeoutMs: number;\n\n  constructor(options: Partial<APIConnectOptions> = {}) {\n    this.maxRetry = options.maxRetry ?? 3;\n    this.retryIntervalMs = options.retryIntervalMs ?? 2000;\n    this.timeoutMs = options.timeoutMs ?? 10000;\n\n    if (this.maxRetry < 0) {\n      throw new Error('maxRetry must be greater than or equal to 0');\n    }\n    if (this.retryIntervalMs < 0) {\n      throw new Error('retryIntervalMs must be greater than or equal to 0');\n    }\n    if (this.timeoutMs < 0) {\n      throw new Error('timeoutMs must be greater than or equal to 0');\n    }\n  }\n\n  /** @internal */\n  _intervalForRetry(numRetries: number): number {\n    /**\n     * Return the interval for the given number of retries.\n     *\n     * The first retry is immediate, and then uses specified retryIntervalMs\n     */\n    if (numRetries === 0) {\n      return 0.1;\n    }\n    return this.retryIntervalMs;\n  }\n}\n\nexport const DEFAULT_API_CONNECT_OPTIONS = new APIConnectOptions();\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGO,MAAM,kBAAkB;AAAA;AAAA,EAEpB;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA,EAET,YAAY,UAAsC,CAAC,GAAG;AACpD,SAAK,WAAW,QAAQ,YAAY;AACpC,SAAK,kBAAkB,QAAQ,mBAAmB;AAClD,SAAK,YAAY,QAAQ,aAAa;AAEtC,QAAI,KAAK,WAAW,GAAG;AACrB,YAAM,IAAI,MAAM,6CAA6C;AAAA,IAC/D;AACA,QAAI,KAAK,kBAAkB,GAAG;AAC5B,YAAM,IAAI,MAAM,oDAAoD;AAAA,IACtE;AACA,QAAI,KAAK,YAAY,GAAG;AACtB,YAAM,IAAI,MAAM,8CAA8C;AAAA,IAChE;AAAA,EACF;AAAA;AAAA,EAGA,kBAAkB,YAA4B;AAM5C,QAAI,eAAe,GAAG;AACpB,aAAO;AAAA,IACT;AACA,WAAO,KAAK;AAAA,EACd;AACF;AAEO,MAAM,8BAA8B,IAAI,kBAAkB;","names":[]}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Key used to store timed transcripts in AudioFrame.userdata.\n */\nexport const USERDATA_TIMED_TRANSCRIPT = 'lk.timed_transcripts';\n\n/**\n * Connection options for API calls, controlling retry and timeout behavior.\n */\nexport interface APIConnectOptions {\n  /** Maximum number of retries to connect to the API. Default: 3 */\n  maxRetry: number;\n  /** Interval between retries to connect to the API in milliseconds. Default: 2000 */\n  retryIntervalMs: number;\n  /** Timeout for connecting to the API in milliseconds. Default: 10000 */\n  timeoutMs: number;\n}\n\nexport const DEFAULT_API_CONNECT_OPTIONS: APIConnectOptions = {\n  maxRetry: 3,\n  retryIntervalMs: 2000,\n  timeoutMs: 10000,\n};\n\n/**\n * Return the interval for the given number of retries.\n * The first retry is immediate, and then uses specified retryIntervalMs.\n * @internal\n */\nexport function intervalForRetry(connOptions: APIConnectOptions, numRetries: number): number {\n  if (numRetries === 0) {\n    return 0.1;\n  }\n  return connOptions.retryIntervalMs;\n}\n\n/**\n * Connection options for the agent session, controlling retry and timeout behavior\n * for STT, LLM, and TTS connections.\n */\nexport interface SessionConnectOptions {\n  /** Connection options for speech-to-text. */\n  sttConnOptions?: Partial<APIConnectOptions>;\n  /** Connection options for the language model. */\n  llmConnOptions?: Partial<APIConnectOptions>;\n  /** Connection options for text-to-speech. */\n  ttsConnOptions?: Partial<APIConnectOptions>;\n  /** Maximum number of consecutive unrecoverable errors from LLM or TTS before closing the session. Default: 3 */\n  maxUnrecoverableErrors?: number;\n}\n\n/**\n * Resolved session connect options with all values populated.\n * @internal\n */\nexport interface ResolvedSessionConnectOptions {\n  sttConnOptions: APIConnectOptions;\n  llmConnOptions: APIConnectOptions;\n  ttsConnOptions: APIConnectOptions;\n  maxUnrecoverableErrors: number;\n}\n\nexport const DEFAULT_SESSION_CONNECT_OPTIONS: ResolvedSessionConnectOptions = {\n  sttConnOptions: DEFAULT_API_CONNECT_OPTIONS,\n  llmConnOptions: DEFAULT_API_CONNECT_OPTIONS,\n  ttsConnOptions: DEFAULT_API_CONNECT_OPTIONS,\n  maxUnrecoverableErrors: 3,\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAOO,MAAM,4BAA4B;AAclC,MAAM,8BAAiD;AAAA,EAC5D,UAAU;AAAA,EACV,iBAAiB;AAAA,EACjB,WAAW;AACb;AAOO,SAAS,iBAAiB,aAAgC,YAA4B;AAC3F,MAAI,eAAe,GAAG;AACpB,WAAO;AAAA,EACT;AACA,SAAO,YAAY;AACrB;AA4BO,MAAM,kCAAiE;AAAA,EAC5E,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,wBAAwB;AAC1B;","names":[]}

package/dist/types.d.cts

@@ -1,13 +1,48 @@
-export declare class APIConnectOptions {
-    /** Maximum number of retries to connect to the API. */
-    readonly maxRetry: number;
-    /** Interval between retries to connect to the API in milliseconds. */
-    readonly retryIntervalMs: number;
-    /** Timeout for connecting to the API in milliseconds. */
-    readonly timeoutMs: number;
-    constructor(options?: Partial<APIConnectOptions>);
-    /** @internal */
-    _intervalForRetry(numRetries: number): number;
+/**
+ * Key used to store timed transcripts in AudioFrame.userdata.
+ */
+export declare const USERDATA_TIMED_TRANSCRIPT = "lk.timed_transcripts";
+/**
+ * Connection options for API calls, controlling retry and timeout behavior.
+ */
+export interface APIConnectOptions {
+    /** Maximum number of retries to connect to the API. Default: 3 */
+    maxRetry: number;
+    /** Interval between retries to connect to the API in milliseconds. Default: 2000 */
+    retryIntervalMs: number;
+    /** Timeout for connecting to the API in milliseconds. Default: 10000 */
+    timeoutMs: number;
 }
 export declare const DEFAULT_API_CONNECT_OPTIONS: APIConnectOptions;
+/**
+ * Return the interval for the given number of retries.
+ * The first retry is immediate, and then uses specified retryIntervalMs.
+ * @internal
+ */
+export declare function intervalForRetry(connOptions: APIConnectOptions, numRetries: number): number;
+/**
+ * Connection options for the agent session, controlling retry and timeout behavior
+ * for STT, LLM, and TTS connections.
+ */
+export interface SessionConnectOptions {
+    /** Connection options for speech-to-text. */
+    sttConnOptions?: Partial<APIConnectOptions>;
+    /** Connection options for the language model. */
+    llmConnOptions?: Partial<APIConnectOptions>;
+    /** Connection options for text-to-speech. */
+    ttsConnOptions?: Partial<APIConnectOptions>;
+    /** Maximum number of consecutive unrecoverable errors from LLM or TTS before closing the session. Default: 3 */
+    maxUnrecoverableErrors?: number;
+}
+/**
+ * Resolved session connect options with all values populated.
+ * @internal
+ */
+export interface ResolvedSessionConnectOptions {
+    sttConnOptions: APIConnectOptions;
+    llmConnOptions: APIConnectOptions;
+    ttsConnOptions: APIConnectOptions;
+    maxUnrecoverableErrors: number;
+}
+export declare const DEFAULT_SESSION_CONNECT_OPTIONS: ResolvedSessionConnectOptions;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts

@@ -1,13 +1,48 @@
-export declare class APIConnectOptions {
-    /** Maximum number of retries to connect to the API. */
-    readonly maxRetry: number;
-    /** Interval between retries to connect to the API in milliseconds. */
-    readonly retryIntervalMs: number;
-    /** Timeout for connecting to the API in milliseconds. */
-    readonly timeoutMs: number;
-    constructor(options?: Partial<APIConnectOptions>);
-    /** @internal */
-    _intervalForRetry(numRetries: number): number;
+/**
+ * Key used to store timed transcripts in AudioFrame.userdata.
+ */
+export declare const USERDATA_TIMED_TRANSCRIPT = "lk.timed_transcripts";
+/**
+ * Connection options for API calls, controlling retry and timeout behavior.
+ */
+export interface APIConnectOptions {
+    /** Maximum number of retries to connect to the API. Default: 3 */
+    maxRetry: number;
+    /** Interval between retries to connect to the API in milliseconds. Default: 2000 */
+    retryIntervalMs: number;
+    /** Timeout for connecting to the API in milliseconds. Default: 10000 */
+    timeoutMs: number;
 }
 export declare const DEFAULT_API_CONNECT_OPTIONS: APIConnectOptions;
+/**
+ * Return the interval for the given number of retries.
+ * The first retry is immediate, and then uses specified retryIntervalMs.
+ * @internal
+ */
+export declare function intervalForRetry(connOptions: APIConnectOptions, numRetries: number): number;
+/**
+ * Connection options for the agent session, controlling retry and timeout behavior
+ * for STT, LLM, and TTS connections.
+ */
+export interface SessionConnectOptions {
+    /** Connection options for speech-to-text. */
+    sttConnOptions?: Partial<APIConnectOptions>;
+    /** Connection options for the language model. */
+    llmConnOptions?: Partial<APIConnectOptions>;
+    /** Connection options for text-to-speech. */
+    ttsConnOptions?: Partial<APIConnectOptions>;
+    /** Maximum number of consecutive unrecoverable errors from LLM or TTS before closing the session. Default: 3 */
+    maxUnrecoverableErrors?: number;
+}
+/**
+ * Resolved session connect options with all values populated.
+ * @internal
+ */
+export interface ResolvedSessionConnectOptions {
+    sttConnOptions: APIConnectOptions;
+    llmConnOptions: APIConnectOptions;
+    ttsConnOptions: APIConnectOptions;
+    maxUnrecoverableErrors: number;
+}
+export declare const DEFAULT_SESSION_CONNECT_OPTIONS: ResolvedSessionConnectOptions;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,qBAAa,iBAAiB;IAC5B,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM;IAgBpD,gBAAgB;IAChB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;CAW9C;AAED,eAAO,MAAM,2BAA2B,mBAA0B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,2BAA2B,EAAE,iBAIzC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK3F;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC5C,iDAAiD;IACjD,cAAc,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC5C,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC5C,gHAAgH;IAChH,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C,cAAc,EAAE,iBAAiB,CAAC;IAClC,cAAc,EAAE,iBAAiB,CAAC;IAClC,cAAc,EAAE,iBAAiB,CAAC;IAClC,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,eAAO,MAAM,+BAA+B,EAAE,6BAK7C,CAAC"}

package/dist/types.js

@@ -1,35 +1,25 @@
-class APIConnectOptions {
-  /** Maximum number of retries to connect to the API. */
-  maxRetry;
-  /** Interval between retries to connect to the API in milliseconds. */
-  retryIntervalMs;
-  /** Timeout for connecting to the API in milliseconds. */
-  timeoutMs;
-  constructor(options = {}) {
-    this.maxRetry = options.maxRetry ?? 3;
-    this.retryIntervalMs = options.retryIntervalMs ?? 2e3;
-    this.timeoutMs = options.timeoutMs ?? 1e4;
-    if (this.maxRetry < 0) {
-      throw new Error("maxRetry must be greater than or equal to 0");
-    }
-    if (this.retryIntervalMs < 0) {
-      throw new Error("retryIntervalMs must be greater than or equal to 0");
-    }
-    if (this.timeoutMs < 0) {
-      throw new Error("timeoutMs must be greater than or equal to 0");
-    }
-  }
-  /** @internal */
-  _intervalForRetry(numRetries) {
-    if (numRetries === 0) {
-      return 0.1;
-    }
-    return this.retryIntervalMs;
+const USERDATA_TIMED_TRANSCRIPT = "lk.timed_transcripts";
+const DEFAULT_API_CONNECT_OPTIONS = {
+  maxRetry: 3,
+  retryIntervalMs: 2e3,
+  timeoutMs: 1e4
+};
+function intervalForRetry(connOptions, numRetries) {
+  if (numRetries === 0) {
+    return 0.1;
   }
+  return connOptions.retryIntervalMs;
 }
-const DEFAULT_API_CONNECT_OPTIONS = new APIConnectOptions();
+const DEFAULT_SESSION_CONNECT_OPTIONS = {
+  sttConnOptions: DEFAULT_API_CONNECT_OPTIONS,
+  llmConnOptions: DEFAULT_API_CONNECT_OPTIONS,
+  ttsConnOptions: DEFAULT_API_CONNECT_OPTIONS,
+  maxUnrecoverableErrors: 3
+};
 export {
-  APIConnectOptions,
-  DEFAULT_API_CONNECT_OPTIONS
+  DEFAULT_API_CONNECT_OPTIONS,
+  DEFAULT_SESSION_CONNECT_OPTIONS,
+  USERDATA_TIMED_TRANSCRIPT,
+  intervalForRetry
 };
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport class APIConnectOptions {\n  /** Maximum number of retries to connect to the API. */\n  readonly maxRetry: number;\n  /** Interval between retries to connect to the API in milliseconds. */\n  readonly retryIntervalMs: number;\n  /** Timeout for connecting to the API in milliseconds. */\n  readonly timeoutMs: number;\n\n  constructor(options: Partial<APIConnectOptions> = {}) {\n    this.maxRetry = options.maxRetry ?? 3;\n    this.retryIntervalMs = options.retryIntervalMs ?? 2000;\n    this.timeoutMs = options.timeoutMs ?? 10000;\n\n    if (this.maxRetry < 0) {\n      throw new Error('maxRetry must be greater than or equal to 0');\n    }\n    if (this.retryIntervalMs < 0) {\n      throw new Error('retryIntervalMs must be greater than or equal to 0');\n    }\n    if (this.timeoutMs < 0) {\n      throw new Error('timeoutMs must be greater than or equal to 0');\n    }\n  }\n\n  /** @internal */\n  _intervalForRetry(numRetries: number): number {\n    /**\n     * Return the interval for the given number of retries.\n     *\n     * The first retry is immediate, and then uses specified retryIntervalMs\n     */\n    if (numRetries === 0) {\n      return 0.1;\n    }\n    return this.retryIntervalMs;\n  }\n}\n\nexport const DEFAULT_API_CONNECT_OPTIONS = new APIConnectOptions();\n"],"mappings":"AAGO,MAAM,kBAAkB;AAAA;AAAA,EAEpB;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA,EAET,YAAY,UAAsC,CAAC,GAAG;AACpD,SAAK,WAAW,QAAQ,YAAY;AACpC,SAAK,kBAAkB,QAAQ,mBAAmB;AAClD,SAAK,YAAY,QAAQ,aAAa;AAEtC,QAAI,KAAK,WAAW,GAAG;AACrB,YAAM,IAAI,MAAM,6CAA6C;AAAA,IAC/D;AACA,QAAI,KAAK,kBAAkB,GAAG;AAC5B,YAAM,IAAI,MAAM,oDAAoD;AAAA,IACtE;AACA,QAAI,KAAK,YAAY,GAAG;AACtB,YAAM,IAAI,MAAM,8CAA8C;AAAA,IAChE;AAAA,EACF;AAAA;AAAA,EAGA,kBAAkB,YAA4B;AAM5C,QAAI,eAAe,GAAG;AACpB,aAAO;AAAA,IACT;AACA,WAAO,KAAK;AAAA,EACd;AACF;AAEO,MAAM,8BAA8B,IAAI,kBAAkB;","names":[]}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Key used to store timed transcripts in AudioFrame.userdata.\n */\nexport const USERDATA_TIMED_TRANSCRIPT = 'lk.timed_transcripts';\n\n/**\n * Connection options for API calls, controlling retry and timeout behavior.\n */\nexport interface APIConnectOptions {\n  /** Maximum number of retries to connect to the API. Default: 3 */\n  maxRetry: number;\n  /** Interval between retries to connect to the API in milliseconds. Default: 2000 */\n  retryIntervalMs: number;\n  /** Timeout for connecting to the API in milliseconds. Default: 10000 */\n  timeoutMs: number;\n}\n\nexport const DEFAULT_API_CONNECT_OPTIONS: APIConnectOptions = {\n  maxRetry: 3,\n  retryIntervalMs: 2000,\n  timeoutMs: 10000,\n};\n\n/**\n * Return the interval for the given number of retries.\n * The first retry is immediate, and then uses specified retryIntervalMs.\n * @internal\n */\nexport function intervalForRetry(connOptions: APIConnectOptions, numRetries: number): number {\n  if (numRetries === 0) {\n    return 0.1;\n  }\n  return connOptions.retryIntervalMs;\n}\n\n/**\n * Connection options for the agent session, controlling retry and timeout behavior\n * for STT, LLM, and TTS connections.\n */\nexport interface SessionConnectOptions {\n  /** Connection options for speech-to-text. */\n  sttConnOptions?: Partial<APIConnectOptions>;\n  /** Connection options for the language model. */\n  llmConnOptions?: Partial<APIConnectOptions>;\n  /** Connection options for text-to-speech. */\n  ttsConnOptions?: Partial<APIConnectOptions>;\n  /** Maximum number of consecutive unrecoverable errors from LLM or TTS before closing the session. Default: 3 */\n  maxUnrecoverableErrors?: number;\n}\n\n/**\n * Resolved session connect options with all values populated.\n * @internal\n */\nexport interface ResolvedSessionConnectOptions {\n  sttConnOptions: APIConnectOptions;\n  llmConnOptions: APIConnectOptions;\n  ttsConnOptions: APIConnectOptions;\n  maxUnrecoverableErrors: number;\n}\n\nexport const DEFAULT_SESSION_CONNECT_OPTIONS: ResolvedSessionConnectOptions = {\n  sttConnOptions: DEFAULT_API_CONNECT_OPTIONS,\n  llmConnOptions: DEFAULT_API_CONNECT_OPTIONS,\n  ttsConnOptions: DEFAULT_API_CONNECT_OPTIONS,\n  maxUnrecoverableErrors: 3,\n};\n"],"mappings":"AAOO,MAAM,4BAA4B;AAclC,MAAM,8BAAiD;AAAA,EAC5D,UAAU;AAAA,EACV,iBAAiB;AAAA,EACjB,WAAW;AACb;AAOO,SAAS,iBAAiB,aAAgC,YAA4B;AAC3F,MAAI,eAAe,GAAG;AACpB,WAAO;AAAA,EACT;AACA,SAAO,YAAY;AACrB;AA4BO,MAAM,kCAAiE;AAAA,EAC5E,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,wBAAwB;AAC1B;","names":[]}