@livekit/agents-plugin-openai 1.0.46 → 1.0.47

package/dist/responses/llm.cjs

@@ -0,0 +1,274 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var llm_exports = {};
+__export(llm_exports, {
+  LLM: () => LLM,
+  LLMStream: () => LLMStream
+});
+module.exports = __toCommonJS(llm_exports);
+var import_agents = require("@livekit/agents");
+var import_openai = __toESM(require("openai"), 1);
+const defaultLLMOptions = {
+  model: "gpt-4.1",
+  apiKey: process.env.OPENAI_API_KEY,
+  strictToolSchema: true
+};
+class LLM extends import_agents.llm.LLM {
+  #client;
+  #opts;
+  /**
+   * Create a new instance of OpenAI Responses LLM.
+   *
+   * @remarks
+   * `apiKey` must be set to your OpenAI API key, either using the argument or by setting the
+   * `OPENAI_API_KEY` environment variable.
+   */
+  constructor(opts = defaultLLMOptions) {
+    super();
+    this.#opts = { ...defaultLLMOptions, ...opts };
+    if (this.#opts.apiKey === void 0) {
+      throw new Error("OpenAI API key is required, whether as an argument or as $OPENAI_API_KEY");
+    }
+    this.#client = this.#opts.client || new import_openai.default({
+      baseURL: this.#opts.baseURL,
+      apiKey: this.#opts.apiKey
+    });
+  }
+  label() {
+    return "openai.responses.LLM";
+  }
+  get model() {
+    return this.#opts.model;
+  }
+  chat({
+    chatCtx,
+    toolCtx,
+    connOptions = import_agents.DEFAULT_API_CONNECT_OPTIONS,
+    parallelToolCalls,
+    toolChoice,
+    extraKwargs
+  }) {
+    const modelOptions = { ...extraKwargs || {} };
+    parallelToolCalls = parallelToolCalls !== void 0 ? parallelToolCalls : this.#opts.parallelToolCalls;
+    if (toolCtx && Object.keys(toolCtx).length > 0 && parallelToolCalls !== void 0) {
+      modelOptions.parallel_tool_calls = parallelToolCalls;
+    }
+    toolChoice = toolChoice !== void 0 ? toolChoice : this.#opts.toolChoice;
+    if (toolChoice) {
+      modelOptions.tool_choice = toolChoice;
+    }
+    if (this.#opts.temperature !== void 0) {
+      modelOptions.temperature = this.#opts.temperature;
+    }
+    if (this.#opts.store !== void 0) {
+      modelOptions.store = this.#opts.store;
+    }
+    if (this.#opts.metadata) {
+      modelOptions.metadata = this.#opts.metadata;
+    }
+    return new LLMStream(this, {
+      model: this.#opts.model,
+      client: this.#client,
+      chatCtx,
+      toolCtx,
+      connOptions,
+      modelOptions,
+      strictToolSchema: this.#opts.strictToolSchema ?? true
+    });
+  }
+}
+class LLMStream extends import_agents.llm.LLMStream {
+  model;
+  client;
+  modelOptions;
+  strictToolSchema;
+  responseId;
+  constructor(llm2, {
+    model,
+    client,
+    chatCtx,
+    toolCtx,
+    connOptions,
+    modelOptions,
+    strictToolSchema
+  }) {
+    super(llm2, { chatCtx, toolCtx, connOptions });
+    this.model = model;
+    this.client = client;
+    this.modelOptions = modelOptions;
+    this.strictToolSchema = strictToolSchema;
+    this.responseId = "";
+  }
+  async run() {
+    let retryable = true;
+    try {
+      const messages = await this.chatCtx.toProviderFormat(
+        "openai.responses"
+      );
+      const tools = this.toolCtx ? Object.entries(this.toolCtx).map(([name, func]) => {
+        const oaiParams = {
+          type: "function",
+          name,
+          description: func.description,
+          parameters: import_agents.llm.toJsonSchema(
+            func.parameters,
+            true,
+            this.strictToolSchema
+          )
+        };
+        if (this.strictToolSchema) {
+          oaiParams.strict = true;
+        }
+        return oaiParams;
+      }) : void 0;
+      const requestOptions = { ...this.modelOptions };
+      if (!tools) {
+        delete requestOptions.tool_choice;
+      }
+      const stream = await this.client.responses.create(
+        {
+          model: this.model,
+          input: messages,
+          tools,
+          stream: true,
+          ...requestOptions
+        },
+        {
+          timeout: this.connOptions.timeoutMs
+        }
+      );
+      for await (const event of stream) {
+        retryable = false;
+        let chunk;
+        switch (event.type) {
+          case "error":
+            this.handleError(event);
+            break;
+          case "response.created":
+            this.handleResponseCreated(event);
+            break;
+          case "response.output_item.done":
+            chunk = this.handleResponseOutputItemDone(event);
+            break;
+          case "response.output_text.delta":
+            chunk = this.handleResponseOutputTextDelta(event);
+            break;
+          case "response.completed":
+            chunk = this.handleResponseCompleted(event);
+            break;
+        }
+        if (chunk) {
+          this.queue.put(chunk);
+        }
+      }
+    } catch (error) {
+      if (error instanceof import_agents.APIStatusError || error instanceof import_agents.APITimeoutError || error instanceof import_agents.APIConnectionError) {
+        throw error;
+      } else if (error instanceof import_openai.default.APIConnectionTimeoutError) {
+        throw new import_agents.APITimeoutError({ options: { retryable } });
+      } else if (error instanceof import_openai.default.APIError) {
+        throw new import_agents.APIStatusError({
+          message: error.message,
+          options: {
+            statusCode: error.status,
+            body: error.error,
+            requestId: error.requestID,
+            retryable
+          }
+        });
+      } else {
+        throw new import_agents.APIConnectionError({
+          message: (0, import_agents.toError)(error).message,
+          options: { retryable }
+        });
+      }
+    }
+  }
+  handleError(event) {
+    throw new import_agents.APIStatusError({
+      message: event.message,
+      options: {
+        statusCode: -1,
+        retryable: false
+      }
+    });
+  }
+  handleResponseCreated(event) {
+    this.responseId = event.response.id;
+  }
+  handleResponseOutputItemDone(event) {
+    let chunk;
+    if (event.item.type === "function_call") {
+      chunk = {
+        id: this.responseId,
+        delta: {
+          role: "assistant",
+          content: void 0,
+          toolCalls: [
+            import_agents.llm.FunctionCall.create({
+              callId: event.item.call_id || "",
+              name: event.item.name,
+              args: event.item.arguments
+            })
+          ]
+        }
+      };
+    }
+    return chunk;
+  }
+  handleResponseOutputTextDelta(event) {
+    return {
+      id: this.responseId,
+      delta: {
+        role: "assistant",
+        content: event.delta
+      }
+    };
+  }
+  handleResponseCompleted(event) {
+    if (event.response.usage) {
+      return {
+        id: this.responseId,
+        usage: {
+          completionTokens: event.response.usage.output_tokens,
+          promptTokens: event.response.usage.input_tokens,
+          promptCachedTokens: event.response.usage.input_tokens_details.cached_tokens,
+          totalTokens: event.response.usage.total_tokens
+        }
+      };
+    }
+    return void 0;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LLM,
+  LLMStream
+});
+//# sourceMappingURL=llm.cjs.map

package/dist/responses/llm.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/responses/llm.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { APIConnectOptions } from '@livekit/agents';\nimport {\n  APIConnectionError,\n  APIStatusError,\n  APITimeoutError,\n  DEFAULT_API_CONNECT_OPTIONS,\n  llm,\n  toError,\n} from '@livekit/agents';\nimport OpenAI from 'openai';\nimport type { ChatModels } from '../models.js';\n\ninterface LLMOptions {\n  model: ChatModels;\n  apiKey?: string;\n  baseURL?: string;\n  client?: OpenAI;\n  temperature?: number;\n  parallelToolCalls?: boolean;\n  toolChoice?: llm.ToolChoice;\n  store?: boolean;\n  metadata?: Record<string, string>;\n  strictToolSchema?: boolean;\n}\n\nconst defaultLLMOptions: LLMOptions = {\n  model: 'gpt-4.1',\n  apiKey: process.env.OPENAI_API_KEY,\n  strictToolSchema: true,\n};\n\nexport class LLM extends llm.LLM {\n  #client: OpenAI;\n  #opts: LLMOptions;\n\n  /**\n   * Create a new instance of OpenAI Responses LLM.\n   *\n   * @remarks\n   * `apiKey` must be set to your OpenAI API key, either using the argument or by setting the\n   * `OPENAI_API_KEY` environment variable.\n   */\n  constructor(opts: Partial<LLMOptions> = defaultLLMOptions) {\n    super();\n\n    this.#opts = { ...defaultLLMOptions, ...opts };\n    if (this.#opts.apiKey === undefined) {\n      throw new Error('OpenAI API key is required, whether as an argument or as $OPENAI_API_KEY');\n    }\n\n    this.#client =\n      this.#opts.client ||\n      new OpenAI({\n        baseURL: this.#opts.baseURL,\n        apiKey: this.#opts.apiKey,\n      });\n  }\n\n  label(): string {\n    return 'openai.responses.LLM';\n  }\n\n  get model(): string {\n    return this.#opts.model;\n  }\n\n  chat({\n    chatCtx,\n    toolCtx,\n    connOptions = DEFAULT_API_CONNECT_OPTIONS,\n    parallelToolCalls,\n    toolChoice,\n    extraKwargs,\n  }: {\n    chatCtx: llm.ChatContext;\n    toolCtx?: llm.ToolContext;\n    connOptions?: APIConnectOptions;\n    parallelToolCalls?: boolean;\n    toolChoice?: llm.ToolChoice;\n    extraKwargs?: Record<string, unknown>;\n  }): LLMStream {\n    const modelOptions: Record<string, unknown> = { ...(extraKwargs || {}) };\n\n    parallelToolCalls =\n      parallelToolCalls !== undefined ? parallelToolCalls : this.#opts.parallelToolCalls;\n\n    if (toolCtx && Object.keys(toolCtx).length > 0 && parallelToolCalls !== undefined) {\n      modelOptions.parallel_tool_calls = parallelToolCalls;\n    }\n\n    toolChoice =\n      toolChoice !== undefined ? toolChoice : (this.#opts.toolChoice as llm.ToolChoice | undefined);\n\n    if (toolChoice) {\n      modelOptions.tool_choice = toolChoice;\n    }\n\n    if (this.#opts.temperature !== undefined) {\n      modelOptions.temperature = this.#opts.temperature;\n    }\n\n    if (this.#opts.store !== undefined) {\n      modelOptions.store = this.#opts.store;\n    }\n\n    if (this.#opts.metadata) {\n      modelOptions.metadata = this.#opts.metadata;\n    }\n\n    return new LLMStream(this, {\n      model: this.#opts.model,\n      client: this.#client,\n      chatCtx,\n      toolCtx,\n      connOptions,\n      modelOptions,\n      strictToolSchema: this.#opts.strictToolSchema ?? true,\n    });\n  }\n}\n\nexport class LLMStream extends llm.LLMStream {\n  private model: string | ChatModels;\n  private client: OpenAI;\n  private modelOptions: Record<string, unknown>;\n  private strictToolSchema: boolean;\n  private responseId: string;\n\n  constructor(\n    llm: LLM,\n    {\n      model,\n      client,\n      chatCtx,\n      toolCtx,\n      connOptions,\n      modelOptions,\n      strictToolSchema,\n    }: {\n      model: ChatModels;\n      client: OpenAI;\n      chatCtx: llm.ChatContext;\n      toolCtx?: llm.ToolContext;\n      connOptions: APIConnectOptions;\n      modelOptions: Record<string, unknown>;\n      strictToolSchema: boolean;\n    },\n  ) {\n    super(llm, { chatCtx, toolCtx, connOptions });\n    this.model = model;\n    this.client = client;\n    this.modelOptions = modelOptions;\n    this.strictToolSchema = strictToolSchema;\n    this.responseId = '';\n  }\n\n  protected async run(): Promise<void> {\n    let retryable = true;\n\n    try {\n      const messages = (await this.chatCtx.toProviderFormat(\n        'openai.responses',\n      )) as OpenAI.Responses.ResponseInputItem[];\n\n      const tools = this.toolCtx\n        ? Object.entries(this.toolCtx).map(([name, func]) => {\n            const oaiParams = {\n              type: 'function' as const,\n              name: name,\n              description: func.description,\n              parameters: llm.toJsonSchema(\n                func.parameters,\n                true,\n                this.strictToolSchema,\n              ) as unknown as OpenAI.Responses.FunctionTool['parameters'],\n            } as OpenAI.Responses.FunctionTool;\n\n            if (this.strictToolSchema) {\n              oaiParams.strict = true;\n            }\n\n            return oaiParams;\n          })\n        : undefined;\n\n      const requestOptions: Record<string, unknown> = { ...this.modelOptions };\n      if (!tools) {\n        delete requestOptions.tool_choice;\n      }\n\n      const stream = await this.client.responses.create(\n        {\n          model: this.model,\n          input: messages,\n          tools: tools,\n          stream: true,\n          ...requestOptions,\n        },\n        {\n          timeout: this.connOptions.timeoutMs,\n        },\n      );\n\n      for await (const event of stream) {\n        retryable = false;\n        let chunk: llm.ChatChunk | undefined;\n\n        switch (event.type) {\n          case 'error':\n            this.handleError(event);\n            break;\n          case 'response.created':\n            this.handleResponseCreated(event);\n            break;\n          case 'response.output_item.done':\n            chunk = this.handleResponseOutputItemDone(event);\n            break;\n          case 'response.output_text.delta':\n            chunk = this.handleResponseOutputTextDelta(event);\n            break;\n          case 'response.completed':\n            chunk = this.handleResponseCompleted(event);\n            break;\n        }\n\n        if (chunk) {\n          this.queue.put(chunk);\n        }\n      }\n    } catch (error) {\n      if (\n        error instanceof APIStatusError ||\n        error instanceof APITimeoutError ||\n        error instanceof APIConnectionError\n      ) {\n        throw error;\n      } else if (error instanceof OpenAI.APIConnectionTimeoutError) {\n        throw new APITimeoutError({ options: { retryable } });\n      } else if (error instanceof OpenAI.APIError) {\n        throw new APIStatusError({\n          message: error.message,\n          options: {\n            statusCode: error.status,\n            body: error.error,\n            requestId: error.requestID,\n            retryable,\n          },\n        });\n      } else {\n        throw new APIConnectionError({\n          message: toError(error).message,\n          options: { retryable },\n        });\n      }\n    }\n  }\n\n  private handleError(event: OpenAI.Responses.ResponseErrorEvent): void {\n    throw new APIStatusError({\n      message: event.message,\n      options: {\n        statusCode: -1,\n        retryable: false,\n      },\n    });\n  }\n\n  private handleResponseCreated(event: OpenAI.Responses.ResponseCreatedEvent): void {\n    this.responseId = event.response.id;\n  }\n\n  private handleResponseOutputItemDone(\n    event: OpenAI.Responses.ResponseOutputItemDoneEvent,\n  ): llm.ChatChunk | undefined {\n    let chunk: llm.ChatChunk | undefined;\n\n    if (event.item.type === 'function_call') {\n      chunk = {\n        id: this.responseId,\n        delta: {\n          role: 'assistant',\n          content: undefined,\n          toolCalls: [\n            llm.FunctionCall.create({\n              callId: event.item.call_id || '',\n              name: event.item.name,\n              args: event.item.arguments,\n            }),\n          ],\n        },\n      };\n    }\n    return chunk;\n  }\n\n  private handleResponseOutputTextDelta(\n    event: OpenAI.Responses.ResponseTextDeltaEvent,\n  ): llm.ChatChunk {\n    return {\n      id: this.responseId,\n      delta: {\n        role: 'assistant',\n        content: event.delta,\n      },\n    };\n  }\n\n  private handleResponseCompleted(\n    event: OpenAI.Responses.ResponseCompletedEvent,\n  ): llm.ChatChunk | undefined {\n    if (event.response.usage) {\n      return {\n        id: this.responseId,\n        usage: {\n          completionTokens: event.response.usage.output_tokens,\n          promptTokens: event.response.usage.input_tokens,\n          promptCachedTokens: event.response.usage.input_tokens_details.cached_tokens,\n          totalTokens: event.response.usage.total_tokens,\n        },\n      };\n    }\n    return undefined;\n  }\n}\n"],"mappings":"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","names":["OpenAI","llm"]}

package/dist/responses/llm.d.cts

@@ -0,0 +1,61 @@
+import type { APIConnectOptions } from '@livekit/agents';
+import { llm } from '@livekit/agents';
+import OpenAI from 'openai';
+import type { ChatModels } from '../models.js';
+interface LLMOptions {
+    model: ChatModels;
+    apiKey?: string;
+    baseURL?: string;
+    client?: OpenAI;
+    temperature?: number;
+    parallelToolCalls?: boolean;
+    toolChoice?: llm.ToolChoice;
+    store?: boolean;
+    metadata?: Record<string, string>;
+    strictToolSchema?: boolean;
+}
+export declare class LLM extends llm.LLM {
+    #private;
+    /**
+     * Create a new instance of OpenAI Responses LLM.
+     *
+     * @remarks
+     * `apiKey` must be set to your OpenAI API key, either using the argument or by setting the
+     * `OPENAI_API_KEY` environment variable.
+     */
+    constructor(opts?: Partial<LLMOptions>);
+    label(): string;
+    get model(): string;
+    chat({ chatCtx, toolCtx, connOptions, parallelToolCalls, toolChoice, extraKwargs, }: {
+        chatCtx: llm.ChatContext;
+        toolCtx?: llm.ToolContext;
+        connOptions?: APIConnectOptions;
+        parallelToolCalls?: boolean;
+        toolChoice?: llm.ToolChoice;
+        extraKwargs?: Record<string, unknown>;
+    }): LLMStream;
+}
+export declare class LLMStream extends llm.LLMStream {
+    private model;
+    private client;
+    private modelOptions;
+    private strictToolSchema;
+    private responseId;
+    constructor(llm: LLM, { model, client, chatCtx, toolCtx, connOptions, modelOptions, strictToolSchema, }: {
+        model: ChatModels;
+        client: OpenAI;
+        chatCtx: llm.ChatContext;
+        toolCtx?: llm.ToolContext;
+        connOptions: APIConnectOptions;
+        modelOptions: Record<string, unknown>;
+        strictToolSchema: boolean;
+    });
+    protected run(): Promise<void>;
+    private handleError;
+    private handleResponseCreated;
+    private handleResponseOutputItemDone;
+    private handleResponseOutputTextDelta;
+    private handleResponseCompleted;
+}
+export {};
+//# sourceMappingURL=llm.d.ts.map

package/dist/responses/llm.d.ts

@@ -0,0 +1,61 @@
+import type { APIConnectOptions } from '@livekit/agents';
+import { llm } from '@livekit/agents';
+import OpenAI from 'openai';
+import type { ChatModels } from '../models.js';
+interface LLMOptions {
+    model: ChatModels;
+    apiKey?: string;
+    baseURL?: string;
+    client?: OpenAI;
+    temperature?: number;
+    parallelToolCalls?: boolean;
+    toolChoice?: llm.ToolChoice;
+    store?: boolean;
+    metadata?: Record<string, string>;
+    strictToolSchema?: boolean;
+}
+export declare class LLM extends llm.LLM {
+    #private;
+    /**
+     * Create a new instance of OpenAI Responses LLM.
+     *
+     * @remarks
+     * `apiKey` must be set to your OpenAI API key, either using the argument or by setting the
+     * `OPENAI_API_KEY` environment variable.
+     */
+    constructor(opts?: Partial<LLMOptions>);
+    label(): string;
+    get model(): string;
+    chat({ chatCtx, toolCtx, connOptions, parallelToolCalls, toolChoice, extraKwargs, }: {
+        chatCtx: llm.ChatContext;
+        toolCtx?: llm.ToolContext;
+        connOptions?: APIConnectOptions;
+        parallelToolCalls?: boolean;
+        toolChoice?: llm.ToolChoice;
+        extraKwargs?: Record<string, unknown>;
+    }): LLMStream;
+}
+export declare class LLMStream extends llm.LLMStream {
+    private model;
+    private client;
+    private modelOptions;
+    private strictToolSchema;
+    private responseId;
+    constructor(llm: LLM, { model, client, chatCtx, toolCtx, connOptions, modelOptions, strictToolSchema, }: {
+        model: ChatModels;
+        client: OpenAI;
+        chatCtx: llm.ChatContext;
+        toolCtx?: llm.ToolContext;
+        connOptions: APIConnectOptions;
+        modelOptions: Record<string, unknown>;
+        strictToolSchema: boolean;
+    });
+    protected run(): Promise<void>;
+    private handleError;
+    private handleResponseCreated;
+    private handleResponseOutputItemDone;
+    private handleResponseOutputTextDelta;
+    private handleResponseCompleted;
+}
+export {};
+//# sourceMappingURL=llm.d.ts.map

package/dist/responses/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/responses/llm.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAKL,GAAG,EAEJ,MAAM,iBAAiB,CAAC;AACzB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,UAAU,UAAU;IAClB,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAQD,qBAAa,GAAI,SAAQ,GAAG,CAAC,GAAG;;IAI9B;;;;;;OAMG;gBACS,IAAI,GAAE,OAAO,CAAC,UAAU,CAAqB;IAgBzD,KAAK,IAAI,MAAM;IAIf,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,CAAC,EACH,OAAO,EACP,OAAO,EACP,WAAyC,EACzC,iBAAiB,EACjB,UAAU,EACV,WAAW,GACZ,EAAE;QACD,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC;QACzB,OAAO,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC;QAC1B,WAAW,CAAC,EAAE,iBAAiB,CAAC;QAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,UAAU,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvC,GAAG,SAAS;CAuCd;AAED,qBAAa,SAAU,SAAQ,GAAG,CAAC,SAAS;IAC1C,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,UAAU,CAAS;gBAGzB,GAAG,EAAE,GAAG,EACR,EACE,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,EACP,WAAW,EACX,YAAY,EACZ,gBAAgB,GACjB,EAAE;QACD,KAAK,EAAE,UAAU,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC;QACzB,OAAO,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC;QAC1B,WAAW,EAAE,iBAAiB,CAAC;QAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,gBAAgB,EAAE,OAAO,CAAC;KAC3B;cAUa,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAqGpC,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,4BAA4B;IAwBpC,OAAO,CAAC,6BAA6B;IAYrC,OAAO,CAAC,uBAAuB;CAgBhC"}

package/dist/responses/llm.js

@@ -0,0 +1,246 @@
+import {
+  APIConnectionError,
+  APIStatusError,
+  APITimeoutError,
+  DEFAULT_API_CONNECT_OPTIONS,
+  llm,
+  toError
+} from "@livekit/agents";
+import OpenAI from "openai";
+const defaultLLMOptions = {
+  model: "gpt-4.1",
+  apiKey: process.env.OPENAI_API_KEY,
+  strictToolSchema: true
+};
+class LLM extends llm.LLM {
+  #client;
+  #opts;
+  /**
+   * Create a new instance of OpenAI Responses LLM.
+   *
+   * @remarks
+   * `apiKey` must be set to your OpenAI API key, either using the argument or by setting the
+   * `OPENAI_API_KEY` environment variable.
+   */
+  constructor(opts = defaultLLMOptions) {
+    super();
+    this.#opts = { ...defaultLLMOptions, ...opts };
+    if (this.#opts.apiKey === void 0) {
+      throw new Error("OpenAI API key is required, whether as an argument or as $OPENAI_API_KEY");
+    }
+    this.#client = this.#opts.client || new OpenAI({
+      baseURL: this.#opts.baseURL,
+      apiKey: this.#opts.apiKey
+    });
+  }
+  label() {
+    return "openai.responses.LLM";
+  }
+  get model() {
+    return this.#opts.model;
+  }
+  chat({
+    chatCtx,
+    toolCtx,
+    connOptions = DEFAULT_API_CONNECT_OPTIONS,
+    parallelToolCalls,
+    toolChoice,
+    extraKwargs
+  }) {
+    const modelOptions = { ...extraKwargs || {} };
+    parallelToolCalls = parallelToolCalls !== void 0 ? parallelToolCalls : this.#opts.parallelToolCalls;
+    if (toolCtx && Object.keys(toolCtx).length > 0 && parallelToolCalls !== void 0) {
+      modelOptions.parallel_tool_calls = parallelToolCalls;
+    }
+    toolChoice = toolChoice !== void 0 ? toolChoice : this.#opts.toolChoice;
+    if (toolChoice) {
+      modelOptions.tool_choice = toolChoice;
+    }
+    if (this.#opts.temperature !== void 0) {
+      modelOptions.temperature = this.#opts.temperature;
+    }
+    if (this.#opts.store !== void 0) {
+      modelOptions.store = this.#opts.store;
+    }
+    if (this.#opts.metadata) {
+      modelOptions.metadata = this.#opts.metadata;
+    }
+    return new LLMStream(this, {
+      model: this.#opts.model,
+      client: this.#client,
+      chatCtx,
+      toolCtx,
+      connOptions,
+      modelOptions,
+      strictToolSchema: this.#opts.strictToolSchema ?? true
+    });
+  }
+}
+class LLMStream extends llm.LLMStream {
+  model;
+  client;
+  modelOptions;
+  strictToolSchema;
+  responseId;
+  constructor(llm2, {
+    model,
+    client,
+    chatCtx,
+    toolCtx,
+    connOptions,
+    modelOptions,
+    strictToolSchema
+  }) {
+    super(llm2, { chatCtx, toolCtx, connOptions });
+    this.model = model;
+    this.client = client;
+    this.modelOptions = modelOptions;
+    this.strictToolSchema = strictToolSchema;
+    this.responseId = "";
+  }
+  async run() {
+    let retryable = true;
+    try {
+      const messages = await this.chatCtx.toProviderFormat(
+        "openai.responses"
+      );
+      const tools = this.toolCtx ? Object.entries(this.toolCtx).map(([name, func]) => {
+        const oaiParams = {
+          type: "function",
+          name,
+          description: func.description,
+          parameters: llm.toJsonSchema(
+            func.parameters,
+            true,
+            this.strictToolSchema
+          )
+        };
+        if (this.strictToolSchema) {
+          oaiParams.strict = true;
+        }
+        return oaiParams;
+      }) : void 0;
+      const requestOptions = { ...this.modelOptions };
+      if (!tools) {
+        delete requestOptions.tool_choice;
+      }
+      const stream = await this.client.responses.create(
+        {
+          model: this.model,
+          input: messages,
+          tools,
+          stream: true,
+          ...requestOptions
+        },
+        {
+          timeout: this.connOptions.timeoutMs
+        }
+      );
+      for await (const event of stream) {
+        retryable = false;
+        let chunk;
+        switch (event.type) {
+          case "error":
+            this.handleError(event);
+            break;
+          case "response.created":
+            this.handleResponseCreated(event);
+            break;
+          case "response.output_item.done":
+            chunk = this.handleResponseOutputItemDone(event);
+            break;
+          case "response.output_text.delta":
+            chunk = this.handleResponseOutputTextDelta(event);
+            break;
+          case "response.completed":
+            chunk = this.handleResponseCompleted(event);
+            break;
+        }
+        if (chunk) {
+          this.queue.put(chunk);
+        }
+      }
+    } catch (error) {
+      if (error instanceof APIStatusError || error instanceof APITimeoutError || error instanceof APIConnectionError) {
+        throw error;
+      } else if (error instanceof OpenAI.APIConnectionTimeoutError) {
+        throw new APITimeoutError({ options: { retryable } });
+      } else if (error instanceof OpenAI.APIError) {
+        throw new APIStatusError({
+          message: error.message,
+          options: {
+            statusCode: error.status,
+            body: error.error,
+            requestId: error.requestID,
+            retryable
+          }
+        });
+      } else {
+        throw new APIConnectionError({
+          message: toError(error).message,
+          options: { retryable }
+        });
+      }
+    }
+  }
+  handleError(event) {
+    throw new APIStatusError({
+      message: event.message,
+      options: {
+        statusCode: -1,
+        retryable: false
+      }
+    });
+  }
+  handleResponseCreated(event) {
+    this.responseId = event.response.id;
+  }
+  handleResponseOutputItemDone(event) {
+    let chunk;
+    if (event.item.type === "function_call") {
+      chunk = {
+        id: this.responseId,
+        delta: {
+          role: "assistant",
+          content: void 0,
+          toolCalls: [
+            llm.FunctionCall.create({
+              callId: event.item.call_id || "",
+              name: event.item.name,
+              args: event.item.arguments
+            })
+          ]
+        }
+      };
+    }
+    return chunk;
+  }
+  handleResponseOutputTextDelta(event) {
+    return {
+      id: this.responseId,
+      delta: {
+        role: "assistant",
+        content: event.delta
+      }
+    };
+  }
+  handleResponseCompleted(event) {
+    if (event.response.usage) {
+      return {
+        id: this.responseId,
+        usage: {
+          completionTokens: event.response.usage.output_tokens,
+          promptTokens: event.response.usage.input_tokens,
+          promptCachedTokens: event.response.usage.input_tokens_details.cached_tokens,
+          totalTokens: event.response.usage.total_tokens
+        }
+      };
+    }
+    return void 0;
+  }
+}
+export {
+  LLM,
+  LLMStream
+};
+//# sourceMappingURL=llm.js.map