@livekit/agents 0.7.8 → 1.0.0-next.0

package/dist/llm/chat_context.test.js

@@ -0,0 +1,385 @@
+import { describe, expect, it } from "vitest";
+import {
+  ChatContext,
+  ChatMessage,
+  FunctionCall,
+  FunctionCallOutput,
+  ReadonlyChatContext
+} from "./chat_context.js";
+describe("ChatContext.toJSON", () => {
+  it("should match snapshot for empty context", () => {
+    const context = new ChatContext();
+    expect(context.toJSON()).toMatchSnapshot();
+  });
+  it("should match snapshot for simple conversation", () => {
+    const context = new ChatContext();
+    context.addMessage({
+      id: "msg_system_1",
+      role: "system",
+      content: "You are a helpful assistant.",
+      createdAt: 1e9
+    });
+    context.addMessage({
+      id: "msg_user_1",
+      role: "user",
+      content: "Hello, how are you?",
+      createdAt: 1000000001
+    });
+    context.addMessage({
+      id: "msg_assistant_1",
+      role: "assistant",
+      content: "I'm doing well, thank you! How can I help you today?",
+      createdAt: 1000000002
+    });
+    expect(context.toJSON()).toMatchSnapshot("simple-conversation-no-timestamps");
+    expect(context.toJSON({ excludeTimestamp: false })).toMatchSnapshot(
+      "simple-conversation-with-timestamps"
+    );
+  });
+  it("should match snapshot for multimodal content", () => {
+    const context = new ChatContext();
+    const imageContent = {
+      id: "img_test_1",
+      type: "image_content",
+      image: "https://example.com/test-image.jpg",
+      inferenceDetail: "high",
+      inferenceWidth: 1024,
+      inferenceHeight: 768,
+      mimeType: "image/jpeg",
+      _cache: {}
+    };
+    const audioContent = {
+      type: "audio_content",
+      frame: [],
+      // This won't be included in JSON
+      transcript: "This is a test audio transcript"
+    };
+    context.addMessage({
+      id: "msg_user_2",
+      role: "user",
+      content: [
+        "Check out this image and audio:",
+        imageContent,
+        audioContent,
+        "What do you think?"
+      ],
+      createdAt: 2e9
+    });
+    expect(context.toJSON()).toMatchSnapshot("multimodal-default-exclusions");
+    expect(
+      context.toJSON({
+        excludeImage: false,
+        excludeAudio: true
+      })
+    ).toMatchSnapshot("multimodal-with-images-only");
+    expect(
+      context.toJSON({
+        excludeImage: true,
+        excludeAudio: false
+      })
+    ).toMatchSnapshot("multimodal-with-audio-only");
+    expect(
+      context.toJSON({
+        excludeImage: false,
+        excludeAudio: false,
+        excludeTimestamp: false
+      })
+    ).toMatchSnapshot("multimodal-full-content");
+  });
+  it("should match snapshot for function calls", () => {
+    const context = new ChatContext();
+    context.addMessage({
+      id: "msg_user_3",
+      role: "user",
+      content: "What's the weather in Paris?",
+      createdAt: 3e9
+    });
+    const functionCall = new FunctionCall({
+      id: "func_call_1",
+      callId: "call_weather_123",
+      name: "get_weather",
+      args: '{"location": "Paris, France", "unit": "celsius"}',
+      createdAt: 3000000001
+    });
+    context.insert(functionCall);
+    const functionOutput = new FunctionCallOutput({
+      id: "func_output_1",
+      callId: "call_weather_123",
+      name: "get_weather",
+      output: '{"temperature": 22, "condition": "partly cloudy", "humidity": 65}',
+      isError: false,
+      createdAt: 3000000002
+    });
+    context.insert(functionOutput);
+    context.addMessage({
+      id: "msg_assistant_2",
+      role: "assistant",
+      content: "The weather in Paris is currently 22\xB0C and partly cloudy with 65% humidity.",
+      createdAt: 3000000003
+    });
+    expect(context.toJSON()).toMatchSnapshot("conversation-with-function-calls");
+    expect(
+      context.toJSON({
+        excludeFunctionCall: true
+      })
+    ).toMatchSnapshot("conversation-without-function-calls");
+    expect(
+      context.toJSON({
+        excludeTimestamp: false
+      })
+    ).toMatchSnapshot("conversation-with-function-calls-and-timestamps");
+  });
+  it("should match snapshot for edge cases", () => {
+    const context = new ChatContext();
+    context.addMessage({
+      id: "msg_empty_1",
+      role: "user",
+      content: [],
+      createdAt: 5e9
+    });
+    const silentAudio = {
+      type: "audio_content",
+      frame: [],
+      transcript: void 0
+    };
+    context.addMessage({
+      id: "msg_silent_audio",
+      role: "user",
+      content: [silentAudio],
+      createdAt: 5000000001
+    });
+    context.addMessage({
+      id: "msg_multi_text",
+      role: "assistant",
+      content: ["Part 1. ", "Part 2. ", "Part 3."],
+      createdAt: 5000000002
+    });
+    const minimalCall = new FunctionCall({
+      id: "func_minimal",
+      callId: "minimal",
+      name: "test",
+      args: "{}",
+      createdAt: 5000000003
+    });
+    context.insert(minimalCall);
+    const namelessOutput = new FunctionCallOutput({
+      id: "func_output_nameless",
+      callId: "minimal",
+      output: "OK",
+      isError: false,
+      createdAt: 5000000004
+    });
+    context.insert(namelessOutput);
+    context.addMessage({
+      id: "msg_special_chars",
+      role: "user",
+      content: `Test with special chars: 
+	\r "quotes" 'apostrophes' \\backslashes\\ {braces} [brackets]`,
+      createdAt: 5000000005
+    });
+    expect(context.toJSON()).toMatchSnapshot("edge-cases-default");
+    expect(
+      context.toJSON({
+        excludeTimestamp: false,
+        excludeAudio: false
+      })
+    ).toMatchSnapshot("edge-cases-with-details");
+  });
+  it("should match snapshot for message property variations", () => {
+    const context = new ChatContext();
+    context.addMessage({
+      id: "custom-message-id-123",
+      role: "user",
+      content: "Message with custom ID",
+      createdAt: 6e9
+    });
+    context.addMessage({
+      id: "msg_interrupted",
+      role: "assistant",
+      content: "This response was interrupted...",
+      interrupted: true,
+      createdAt: 6000000001
+    });
+    context.addMessage({
+      id: "msg_dev_2",
+      role: "developer",
+      content: "Developer message",
+      createdAt: 6000000002
+    });
+    context.addMessage({
+      id: "msg_system_3",
+      role: "system",
+      content: "System message",
+      createdAt: 6000000003
+    });
+    const detailedImage = {
+      id: "img_detailed",
+      type: "image_content",
+      image: "https://example.com/image.jpg",
+      inferenceDetail: "low",
+      inferenceWidth: 512,
+      inferenceHeight: 512,
+      mimeType: "image/png",
+      _cache: { cached: true }
+    };
+    context.addMessage({
+      id: "msg_with_image",
+      role: "user",
+      content: ["Image with all properties:", detailedImage],
+      createdAt: 6000000004
+    });
+    expect(context.toJSON()).toMatchSnapshot("message-properties-default");
+    expect(
+      context.toJSON({
+        excludeImage: false,
+        excludeTimestamp: false
+      })
+    ).toMatchSnapshot("message-properties-full");
+  });
+});
+describe("ReadonlyChatContext with immutable array", () => {
+  it("should have readonly property set to true", () => {
+    const items = [
+      new ChatMessage({
+        id: "msg_1",
+        role: "user",
+        content: ["Test"],
+        interrupted: false,
+        createdAt: Date.now()
+      })
+    ];
+    const readonlyContext = new ReadonlyChatContext(items);
+    expect(readonlyContext.readonly).toBe(true);
+  });
+  it("should prevent setting items property", () => {
+    const items = [
+      new ChatMessage({
+        id: "msg_1",
+        role: "user",
+        content: ["Test"],
+        interrupted: false,
+        createdAt: Date.now()
+      })
+    ];
+    const readonlyContext = new ReadonlyChatContext(items);
+    expect(() => {
+      readonlyContext.items = [];
+    }).toThrow(
+      `Cannot set items on a read-only chat context. Please use .copy() and agent.update_chat_ctx() to modify the chat context.`
+    );
+  });
+  it("should prevent modifications through array methods", () => {
+    const items = [
+      new ChatMessage({
+        id: "msg_1",
+        role: "user",
+        content: ["Test"],
+        interrupted: false,
+        createdAt: Date.now()
+      })
+    ];
+    const readonlyContext = new ReadonlyChatContext(items);
+    const newItem = new ChatMessage({
+      id: "msg_2",
+      role: "assistant",
+      content: ["Response"],
+      interrupted: false,
+      createdAt: Date.now()
+    });
+    const mutableItems = readonlyContext.items;
+    expect(() => mutableItems.push(newItem)).toThrow(
+      "Cannot call push() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context."
+    );
+    expect(() => mutableItems.pop()).toThrow(
+      "Cannot call pop() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context."
+    );
+    expect(() => mutableItems.shift()).toThrow(
+      "Cannot call shift() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context."
+    );
+    expect(() => mutableItems.unshift(newItem)).toThrow(
+      "Cannot call unshift() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context."
+    );
+    expect(() => mutableItems.splice(0, 1)).toThrow(
+      "Cannot call splice() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context."
+    );
+    expect(() => mutableItems.sort()).toThrow(
+      "Cannot call sort() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context."
+    );
+    expect(() => mutableItems.reverse()).toThrow(
+      "Cannot call reverse() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context."
+    );
+    expect(() => mutableItems.fill(newItem)).toThrow(
+      "Cannot call fill() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context."
+    );
+    expect(() => mutableItems.copyWithin(0, 1)).toThrow(
+      "Cannot call copyWithin() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context."
+    );
+  });
+  it("should prevent bracket notation assignment and deletion", () => {
+    const items = [
+      new ChatMessage({
+        id: "msg_1",
+        role: "user",
+        content: ["Test"],
+        interrupted: false,
+        createdAt: Date.now()
+      })
+    ];
+    const readonlyContext = new ReadonlyChatContext(items);
+    const newItem = new ChatMessage({
+      id: "msg_2",
+      role: "assistant",
+      content: ["Response"],
+      interrupted: false,
+      createdAt: Date.now()
+    });
+    expect(() => {
+      readonlyContext.items[0] = newItem;
+    }).toThrow(
+      'Cannot assign to read-only array index "0". Please use .copy() and agent.update_chat_ctx() to modify the chat context.'
+    );
+    expect(() => {
+      delete readonlyContext.items[0];
+    }).toThrow(
+      'Cannot delete read-only array index "0". Please use .copy() and agent.update_chat_ctx() to modify the chat context.'
+    );
+    expect(() => {
+      readonlyContext.items[99] = newItem;
+    }).toThrow(
+      'Cannot assign to read-only array index "99". Please use .copy() and agent.update_chat_ctx() to modify the chat context.'
+    );
+  });
+  it("should allow read operations on the immutable array", () => {
+    const items = [
+      new ChatMessage({
+        id: "msg_1",
+        role: "user",
+        content: ["Test 1"],
+        interrupted: false,
+        createdAt: 1e3
+      }),
+      new ChatMessage({
+        id: "msg_2",
+        role: "assistant",
+        content: ["Test 2"],
+        interrupted: false,
+        createdAt: 2e3
+      })
+    ];
+    const readonlyContext = new ReadonlyChatContext(items);
+    expect(readonlyContext.items.length).toBe(2);
+    expect(readonlyContext.items[0]).toEqual(items[0]);
+    expect(readonlyContext.items[1]).toEqual(items[1]);
+    expect(readonlyContext.items.find((item) => item.id === "msg_2")).toEqual(items[1]);
+    expect(readonlyContext.items.map((item) => item.id)).toEqual(["msg_1", "msg_2"]);
+    expect(
+      readonlyContext.items.filter(
+        (item) => item.type === "message" && item.role === "user"
+      )
+    ).toHaveLength(1);
+    const ids = [];
+    readonlyContext.items.forEach((item) => ids.push(item.id));
+    expect(ids).toEqual(["msg_1", "msg_2"]);
+  });
+});
+//# sourceMappingURL=chat_context.test.js.map

package/dist/llm/chat_context.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/llm/chat_context.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { describe, expect, it } from 'vitest';\nimport {\n  type AudioContent,\n  ChatContext,\n  type ChatItem,\n  ChatMessage,\n  FunctionCall,\n  FunctionCallOutput,\n  type ImageContent,\n  ReadonlyChatContext,\n} from './chat_context.js';\n\ndescribe('ChatContext.toJSON', () => {\n  it('should match snapshot for empty context', () => {\n    const context = new ChatContext();\n    expect(context.toJSON()).toMatchSnapshot();\n  });\n\n  it('should match snapshot for simple conversation', () => {\n    const context = new ChatContext();\n\n    context.addMessage({\n      id: 'msg_system_1',\n      role: 'system',\n      content: 'You are a helpful assistant.',\n      createdAt: 1000000000,\n    });\n\n    context.addMessage({\n      id: 'msg_user_1',\n      role: 'user',\n      content: 'Hello, how are you?',\n      createdAt: 1000000001,\n    });\n\n    context.addMessage({\n      id: 'msg_assistant_1',\n      role: 'assistant',\n      content: \"I'm doing well, thank you! How can I help you today?\",\n      createdAt: 1000000002,\n    });\n\n    expect(context.toJSON()).toMatchSnapshot('simple-conversation-no-timestamps');\n\n    expect(context.toJSON({ excludeTimestamp: false })).toMatchSnapshot(\n      'simple-conversation-with-timestamps',\n    );\n  });\n\n  it('should match snapshot for multimodal content', () => {\n    const context = new ChatContext();\n\n    const imageContent: ImageContent = {\n      id: 'img_test_1',\n      type: 'image_content',\n      image: 'https://example.com/test-image.jpg',\n      inferenceDetail: 'high',\n      inferenceWidth: 1024,\n      inferenceHeight: 768,\n      mimeType: 'image/jpeg',\n      _cache: {},\n    };\n\n    const audioContent: AudioContent = {\n      type: 'audio_content',\n      frame: [], // This won't be included in JSON\n      transcript: 'This is a test audio transcript',\n    };\n\n    context.addMessage({\n      id: 'msg_user_2',\n      role: 'user',\n      content: [\n        'Check out this image and audio:',\n        imageContent,\n        audioContent,\n        'What do you think?',\n      ],\n      createdAt: 2000000000,\n    });\n\n    expect(context.toJSON()).toMatchSnapshot('multimodal-default-exclusions');\n\n    expect(\n      context.toJSON({\n        excludeImage: false,\n        excludeAudio: true,\n      }),\n    ).toMatchSnapshot('multimodal-with-images-only');\n\n    expect(\n      context.toJSON({\n        excludeImage: true,\n        excludeAudio: false,\n      }),\n    ).toMatchSnapshot('multimodal-with-audio-only');\n\n    expect(\n      context.toJSON({\n        excludeImage: false,\n        excludeAudio: false,\n        excludeTimestamp: false,\n      }),\n    ).toMatchSnapshot('multimodal-full-content');\n  });\n\n  it('should match snapshot for function calls', () => {\n    const context = new ChatContext();\n\n    context.addMessage({\n      id: 'msg_user_3',\n      role: 'user',\n      content: \"What's the weather in Paris?\",\n      createdAt: 3000000000,\n    });\n\n    const functionCall = new FunctionCall({\n      id: 'func_call_1',\n      callId: 'call_weather_123',\n      name: 'get_weather',\n      args: '{\"location\": \"Paris, France\", \"unit\": \"celsius\"}',\n      createdAt: 3000000001,\n    });\n    context.insert(functionCall);\n\n    const functionOutput = new FunctionCallOutput({\n      id: 'func_output_1',\n      callId: 'call_weather_123',\n      name: 'get_weather',\n      output: '{\"temperature\": 22, \"condition\": \"partly cloudy\", \"humidity\": 65}',\n      isError: false,\n      createdAt: 3000000002,\n    });\n    context.insert(functionOutput);\n\n    context.addMessage({\n      id: 'msg_assistant_2',\n      role: 'assistant',\n      content: 'The weather in Paris is currently 22°C and partly cloudy with 65% humidity.',\n      createdAt: 3000000003,\n    });\n\n    expect(context.toJSON()).toMatchSnapshot('conversation-with-function-calls');\n\n    expect(\n      context.toJSON({\n        excludeFunctionCall: true,\n      }),\n    ).toMatchSnapshot('conversation-without-function-calls');\n\n    expect(\n      context.toJSON({\n        excludeTimestamp: false,\n      }),\n    ).toMatchSnapshot('conversation-with-function-calls-and-timestamps');\n  });\n\n  it('should match snapshot for edge cases', () => {\n    const context = new ChatContext();\n\n    context.addMessage({\n      id: 'msg_empty_1',\n      role: 'user',\n      content: [],\n      createdAt: 5000000000,\n    });\n\n    const silentAudio: AudioContent = {\n      type: 'audio_content',\n      frame: [],\n      transcript: undefined,\n    };\n\n    context.addMessage({\n      id: 'msg_silent_audio',\n      role: 'user',\n      content: [silentAudio],\n      createdAt: 5000000001,\n    });\n\n    context.addMessage({\n      id: 'msg_multi_text',\n      role: 'assistant',\n      content: ['Part 1. ', 'Part 2. ', 'Part 3.'],\n      createdAt: 5000000002,\n    });\n\n    const minimalCall = new FunctionCall({\n      id: 'func_minimal',\n      callId: 'minimal',\n      name: 'test',\n      args: '{}',\n      createdAt: 5000000003,\n    });\n    context.insert(minimalCall);\n\n    const namelessOutput = new FunctionCallOutput({\n      id: 'func_output_nameless',\n      callId: 'minimal',\n      output: 'OK',\n      isError: false,\n      createdAt: 5000000004,\n    });\n    context.insert(namelessOutput);\n\n    context.addMessage({\n      id: 'msg_special_chars',\n      role: 'user',\n      content:\n        'Test with special chars: \\n\\t\\r \"quotes\" \\'apostrophes\\' \\\\backslashes\\\\ {braces} [brackets]',\n      createdAt: 5000000005,\n    });\n\n    expect(context.toJSON()).toMatchSnapshot('edge-cases-default');\n    expect(\n      context.toJSON({\n        excludeTimestamp: false,\n        excludeAudio: false,\n      }),\n    ).toMatchSnapshot('edge-cases-with-details');\n  });\n\n  it('should match snapshot for message property variations', () => {\n    const context = new ChatContext();\n\n    context.addMessage({\n      id: 'custom-message-id-123',\n      role: 'user',\n      content: 'Message with custom ID',\n      createdAt: 6000000000,\n    });\n\n    context.addMessage({\n      id: 'msg_interrupted',\n      role: 'assistant',\n      content: 'This response was interrupted...',\n      interrupted: true,\n      createdAt: 6000000001,\n    });\n\n    context.addMessage({\n      id: 'msg_dev_2',\n      role: 'developer',\n      content: 'Developer message',\n      createdAt: 6000000002,\n    });\n\n    context.addMessage({\n      id: 'msg_system_3',\n      role: 'system',\n      content: 'System message',\n      createdAt: 6000000003,\n    });\n\n    const detailedImage: ImageContent = {\n      id: 'img_detailed',\n      type: 'image_content',\n      image: 'https://example.com/image.jpg',\n      inferenceDetail: 'low',\n      inferenceWidth: 512,\n      inferenceHeight: 512,\n      mimeType: 'image/png',\n      _cache: { cached: true },\n    };\n\n    context.addMessage({\n      id: 'msg_with_image',\n      role: 'user',\n      content: ['Image with all properties:', detailedImage],\n      createdAt: 6000000004,\n    });\n\n    expect(context.toJSON()).toMatchSnapshot('message-properties-default');\n    expect(\n      context.toJSON({\n        excludeImage: false,\n        excludeTimestamp: false,\n      }),\n    ).toMatchSnapshot('message-properties-full');\n  });\n});\n\ndescribe('ReadonlyChatContext with immutable array', () => {\n  it('should have readonly property set to true', () => {\n    const items: ChatItem[] = [\n      new ChatMessage({\n        id: 'msg_1',\n        role: 'user',\n        content: ['Test'],\n        interrupted: false,\n        createdAt: Date.now(),\n      }),\n    ];\n    const readonlyContext = new ReadonlyChatContext(items);\n\n    expect(readonlyContext.readonly).toBe(true);\n  });\n\n  it('should prevent setting items property', () => {\n    const items: ChatItem[] = [\n      new ChatMessage({\n        id: 'msg_1',\n        role: 'user',\n        content: ['Test'],\n        interrupted: false,\n        createdAt: Date.now(),\n      }),\n    ];\n    const readonlyContext = new ReadonlyChatContext(items);\n    expect(() => {\n      readonlyContext.items = [];\n    }).toThrow(\n      `Cannot set items on a read-only chat context. Please use .copy() and agent.update_chat_ctx() to modify the chat context.`,\n    );\n  });\n\n  it('should prevent modifications through array methods', () => {\n    const items: ChatItem[] = [\n      new ChatMessage({\n        id: 'msg_1',\n        role: 'user',\n        content: ['Test'],\n        interrupted: false,\n        createdAt: Date.now(),\n      }),\n    ];\n    const readonlyContext = new ReadonlyChatContext(items);\n    const newItem = new ChatMessage({\n      id: 'msg_2',\n      role: 'assistant',\n      content: ['Response'],\n      interrupted: false,\n      createdAt: Date.now(),\n    });\n\n    const mutableItems = readonlyContext.items;\n    expect(() => mutableItems.push(newItem)).toThrow(\n      'Cannot call push() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context.',\n    );\n\n    expect(() => mutableItems.pop()).toThrow(\n      'Cannot call pop() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context.',\n    );\n\n    expect(() => mutableItems.shift()).toThrow(\n      'Cannot call shift() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context.',\n    );\n\n    expect(() => mutableItems.unshift(newItem)).toThrow(\n      'Cannot call unshift() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context.',\n    );\n\n    expect(() => mutableItems.splice(0, 1)).toThrow(\n      'Cannot call splice() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context.',\n    );\n\n    expect(() => mutableItems.sort()).toThrow(\n      'Cannot call sort() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context.',\n    );\n\n    expect(() => mutableItems.reverse()).toThrow(\n      'Cannot call reverse() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context.',\n    );\n\n    expect(() => mutableItems.fill(newItem)).toThrow(\n      'Cannot call fill() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context.',\n    );\n\n    expect(() => mutableItems.copyWithin(0, 1)).toThrow(\n      'Cannot call copyWithin() on a read-only array. Please use .copy() and agent.update_chat_ctx() to modify the chat context.',\n    );\n  });\n\n  it('should prevent bracket notation assignment and deletion', () => {\n    const items: ChatItem[] = [\n      new ChatMessage({\n        id: 'msg_1',\n        role: 'user',\n        content: ['Test'],\n        interrupted: false,\n        createdAt: Date.now(),\n      }),\n    ];\n    const readonlyContext = new ReadonlyChatContext(items);\n    const newItem = new ChatMessage({\n      id: 'msg_2',\n      role: 'assistant',\n      content: ['Response'],\n      interrupted: false,\n      createdAt: Date.now(),\n    });\n\n    expect(() => {\n      readonlyContext.items[0] = newItem;\n    }).toThrow(\n      'Cannot assign to read-only array index \"0\". Please use .copy() and agent.update_chat_ctx() to modify the chat context.',\n    );\n\n    expect(() => {\n      delete readonlyContext.items[0];\n    }).toThrow(\n      'Cannot delete read-only array index \"0\". Please use .copy() and agent.update_chat_ctx() to modify the chat context.',\n    );\n\n    expect(() => {\n      readonlyContext.items[99] = newItem;\n    }).toThrow(\n      'Cannot assign to read-only array index \"99\". Please use .copy() and agent.update_chat_ctx() to modify the chat context.',\n    );\n  });\n\n  it('should allow read operations on the immutable array', () => {\n    const items: ChatItem[] = [\n      new ChatMessage({\n        id: 'msg_1',\n        role: 'user',\n        content: ['Test 1'],\n        interrupted: false,\n        createdAt: 1000,\n      }),\n      new ChatMessage({\n        id: 'msg_2',\n        role: 'assistant',\n        content: ['Test 2'],\n        interrupted: false,\n        createdAt: 2000,\n      }),\n    ];\n    const readonlyContext = new ReadonlyChatContext(items);\n\n    expect(readonlyContext.items.length).toBe(2);\n    expect(readonlyContext.items[0]).toEqual(items[0]);\n    expect(readonlyContext.items[1]).toEqual(items[1]);\n    expect(readonlyContext.items.find((item: ChatItem) => item.id === 'msg_2')).toEqual(items[1]);\n    expect(readonlyContext.items.map((item: ChatItem) => item.id)).toEqual(['msg_1', 'msg_2']);\n    expect(\n      readonlyContext.items.filter(\n        (item: ChatItem) => item.type === 'message' && item.role === 'user',\n      ),\n    ).toHaveLength(1);\n\n    // forEach should work for reading\n    const ids: string[] = [];\n    readonlyContext.items.forEach((item) => ids.push(item.id));\n    expect(ids).toEqual(['msg_1', 'msg_2']);\n  });\n});\n"],"mappings":"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","names":[]}

package/dist/llm/index.cjs

@@ -20,26 +20,55 @@ var llm_exports = {};
 __export(llm_exports, {
   ChatContext: () => import_chat_context.ChatContext,
   ChatMessage: () => import_chat_context.ChatMessage,
-  ChatRole: () => import_chat_context.ChatRole,
+  FunctionCall: () => import_chat_context.FunctionCall,
+  FunctionCallOutput: () => import_chat_context.FunctionCallOutput,
   LLM: () => import_llm.LLM,
-  LLMEvent: () => import_llm.LLMEvent,
   LLMStream: () => import_llm.LLMStream,
-  oaiBuildFunctionInfo: () => import_function_context.oaiBuildFunctionInfo,
-  oaiParams: () => import_function_context.oaiParams
+  RealtimeModel: () => import_realtime.RealtimeModel,
+  RealtimeSession: () => import_realtime.RealtimeSession,
+  RemoteChatContext: () => import_remote_chat_context.RemoteChatContext,
+  ToolError: () => import_tool_context.ToolError,
+  computeChatCtxDiff: () => import_utils.computeChatCtxDiff,
+  createAudioContent: () => import_chat_context.createAudioContent,
+  createImageContent: () => import_chat_context.createImageContent,
+  createToolOptions: () => import_utils.createToolOptions,
+  executeToolCall: () => import_utils.executeToolCall,
+  handoff: () => import_tool_context.handoff,
+  isFunctionTool: () => import_tool_context.isFunctionTool,
+  oaiBuildFunctionInfo: () => import_utils.oaiBuildFunctionInfo,
+  oaiParams: () => import_utils.oaiParams,
+  toJsonSchema: () => import_utils.toJsonSchema,
+  tool: () => import_tool_context.tool
 });
 module.exports = __toCommonJS(llm_exports);
-var import_function_context = require("./function_context.cjs");
+var import_tool_context = require("./tool_context.cjs");
 var import_chat_context = require("./chat_context.cjs");
 var import_llm = require("./llm.cjs");
+var import_realtime = require("./realtime.cjs");
+var import_remote_chat_context = require("./remote_chat_context.cjs");
+var import_utils = require("./utils.cjs");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ChatContext,
   ChatMessage,
-  ChatRole,
+  FunctionCall,
+  FunctionCallOutput,
   LLM,
-  LLMEvent,
   LLMStream,
+  RealtimeModel,
+  RealtimeSession,
+  RemoteChatContext,
+  ToolError,
+  computeChatCtxDiff,
+  createAudioContent,
+  createImageContent,
+  createToolOptions,
+  executeToolCall,
+  handoff,
+  isFunctionTool,
   oaiBuildFunctionInfo,
-  oaiParams
+  oaiParams,
+  toJsonSchema,
+  tool
 });
 //# sourceMappingURL=index.cjs.map

package/dist/llm/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/llm/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport {\n  type CallableFunction,\n  type FunctionCallInfo,\n  type CallableFunctionResult,\n  type FunctionContext,\n  type inferParameters,\n  oaiParams,\n  oaiBuildFunctionInfo,\n} from './function_context.js';\n\nexport {\n  type ChatImage,\n  type ChatAudio,\n  type ChatContent,\n  ChatRole,\n  ChatMessage,\n  ChatContext,\n} from './chat_context.js';\n\nexport {\n  type ChoiceDelta,\n  type CompletionUsage,\n  type Choice,\n  type ChatChunk,\n  type LLMCallbacks,\n  LLMEvent,\n  LLM,\n  LLMStream,\n} from './llm.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,8BAQO;AAEP,0BAOO;AAEP,iBASO;","names":[]}
+{"version":3,"sources":["../../src/llm/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport {\n  handoff,\n  isFunctionTool,\n  tool,\n  ToolError,\n  type AgentHandoff,\n  type FunctionTool,\n  type ProviderDefinedTool,\n  type Tool,\n  type ToolChoice,\n  type ToolContext,\n  type ToolOptions,\n  type ToolType,\n} from './tool_context.js';\n\nexport {\n  ChatContext,\n  ChatMessage,\n  createAudioContent,\n  createImageContent,\n  FunctionCall,\n  FunctionCallOutput,\n  type AudioContent,\n  type ChatContent,\n  type ChatItem,\n  type ChatRole,\n  type ImageContent,\n} from './chat_context.js';\n\nexport type { ProviderFormat } from './provider_format/index.js';\n\nexport {\n  LLM,\n  LLMStream,\n  type ChatChunk,\n  type ChoiceDelta,\n  type CompletionUsage,\n  type LLMCallbacks,\n} from './llm.js';\n\nexport {\n  RealtimeModel,\n  RealtimeSession,\n  type GenerationCreatedEvent,\n  type InputSpeechStartedEvent,\n  type InputSpeechStoppedEvent,\n  type InputTranscriptionCompleted,\n  type MessageGeneration,\n  type RealtimeCapabilities,\n  type RealtimeModelError,\n  type RealtimeSessionReconnectedEvent,\n} from './realtime.js';\n\nexport { RemoteChatContext } from './remote_chat_context.js';\n\nexport {\n  computeChatCtxDiff,\n  createToolOptions,\n  executeToolCall,\n  oaiBuildFunctionInfo,\n  oaiParams,\n  toJsonSchema,\n  type OpenAIFunctionParameters,\n} from './utils.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,0BAaO;AAEP,0BAYO;AAIP,iBAOO;AAEP,sBAWO;AAEP,iCAAkC;AAElC,mBAQO;","names":[]}

package/dist/llm/index.d.cts

@@ -1,4 +1,8 @@
-export { type CallableFunction, type FunctionCallInfo, type CallableFunctionResult, type FunctionContext, type inferParameters, oaiParams, oaiBuildFunctionInfo, } from './function_context.js';
-export { type ChatImage, type ChatAudio, type ChatContent, ChatRole, ChatMessage, ChatContext, } from './chat_context.js';
-export { type ChoiceDelta, type CompletionUsage, type Choice, type ChatChunk, type LLMCallbacks, LLMEvent, LLM, LLMStream, } from './llm.js';
+export { handoff, isFunctionTool, tool, ToolError, type AgentHandoff, type FunctionTool, type ProviderDefinedTool, type Tool, type ToolChoice, type ToolContext, type ToolOptions, type ToolType, } from './tool_context.js';
+export { ChatContext, ChatMessage, createAudioContent, createImageContent, FunctionCall, FunctionCallOutput, type AudioContent, type ChatContent, type ChatItem, type ChatRole, type ImageContent, } from './chat_context.js';
+export type { ProviderFormat } from './provider_format/index.js';
+export { LLM, LLMStream, type ChatChunk, type ChoiceDelta, type CompletionUsage, type LLMCallbacks, } from './llm.js';
+export { RealtimeModel, RealtimeSession, type GenerationCreatedEvent, type InputSpeechStartedEvent, type InputSpeechStoppedEvent, type InputTranscriptionCompleted, type MessageGeneration, type RealtimeCapabilities, type RealtimeModelError, type RealtimeSessionReconnectedEvent, } from './realtime.js';
+export { RemoteChatContext } from './remote_chat_context.js';
+export { computeChatCtxDiff, createToolOptions, executeToolCall, oaiBuildFunctionInfo, oaiParams, toJsonSchema, type OpenAIFunctionParameters, } from './utils.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/llm/index.d.ts

@@ -1,4 +1,8 @@
-export { type CallableFunction, type FunctionCallInfo, type CallableFunctionResult, type FunctionContext, type inferParameters, oaiParams, oaiBuildFunctionInfo, } from './function_context.js';
-export { type ChatImage, type ChatAudio, type ChatContent, ChatRole, ChatMessage, ChatContext, } from './chat_context.js';
-export { type ChoiceDelta, type CompletionUsage, type Choice, type ChatChunk, type LLMCallbacks, LLMEvent, LLM, LLMStream, } from './llm.js';
+export { handoff, isFunctionTool, tool, ToolError, type AgentHandoff, type FunctionTool, type ProviderDefinedTool, type Tool, type ToolChoice, type ToolContext, type ToolOptions, type ToolType, } from './tool_context.js';
+export { ChatContext, ChatMessage, createAudioContent, createImageContent, FunctionCall, FunctionCallOutput, type AudioContent, type ChatContent, type ChatItem, type ChatRole, type ImageContent, } from './chat_context.js';
+export type { ProviderFormat } from './provider_format/index.js';
+export { LLM, LLMStream, type ChatChunk, type ChoiceDelta, type CompletionUsage, type LLMCallbacks, } from './llm.js';
+export { RealtimeModel, RealtimeSession, type GenerationCreatedEvent, type InputSpeechStartedEvent, type InputSpeechStoppedEvent, type InputTranscriptionCompleted, type MessageGeneration, type RealtimeCapabilities, type RealtimeModelError, type RealtimeSessionReconnectedEvent, } from './realtime.js';
+export { RemoteChatContext } from './remote_chat_context.js';
+export { computeChatCtxDiff, createToolOptions, executeToolCall, oaiBuildFunctionInfo, oaiParams, toJsonSchema, type OpenAIFunctionParameters, } from './utils.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,SAAS,EACT,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,QAAQ,EACR,WAAW,EACX,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,QAAQ,EACR,GAAG,EACH,SAAS,GACV,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,OAAO,EACP,cAAc,EACd,IAAI,EACJ,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,QAAQ,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,YAAY,GAClB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EACL,GAAG,EACH,SAAS,EACT,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,aAAa,EACb,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,+BAA+B,GACrC,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,SAAS,EACT,YAAY,EACZ,KAAK,wBAAwB,GAC9B,MAAM,YAAY,CAAC"}

package/dist/llm/index.js

@@ -1,25 +1,55 @@
 import {
-  oaiParams,
-  oaiBuildFunctionInfo
-} from "./function_context.js";
+  handoff,
+  isFunctionTool,
+  tool,
+  ToolError
+} from "./tool_context.js";
 import {
-  ChatRole,
+  ChatContext,
   ChatMessage,
-  ChatContext
+  createAudioContent,
+  createImageContent,
+  FunctionCall,
+  FunctionCallOutput
 } from "./chat_context.js";
 import {
-  LLMEvent,
   LLM,
   LLMStream
 } from "./llm.js";
+import {
+  RealtimeModel,
+  RealtimeSession
+} from "./realtime.js";
+import { RemoteChatContext } from "./remote_chat_context.js";
+import {
+  computeChatCtxDiff,
+  createToolOptions,
+  executeToolCall,
+  oaiBuildFunctionInfo,
+  oaiParams,
+  toJsonSchema
+} from "./utils.js";
 export {
   ChatContext,
   ChatMessage,
-  ChatRole,
+  FunctionCall,
+  FunctionCallOutput,
   LLM,
-  LLMEvent,
   LLMStream,
+  RealtimeModel,
+  RealtimeSession,
+  RemoteChatContext,
+  ToolError,
+  computeChatCtxDiff,
+  createAudioContent,
+  createImageContent,
+  createToolOptions,
+  executeToolCall,
+  handoff,
+  isFunctionTool,
   oaiBuildFunctionInfo,
-  oaiParams
+  oaiParams,
+  toJsonSchema,
+  tool
 };
 //# sourceMappingURL=index.js.map

package/dist/llm/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/llm/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport {\n  type CallableFunction,\n  type FunctionCallInfo,\n  type CallableFunctionResult,\n  type FunctionContext,\n  type inferParameters,\n  oaiParams,\n  oaiBuildFunctionInfo,\n} from './function_context.js';\n\nexport {\n  type ChatImage,\n  type ChatAudio,\n  type ChatContent,\n  ChatRole,\n  ChatMessage,\n  ChatContext,\n} from './chat_context.js';\n\nexport {\n  type ChoiceDelta,\n  type CompletionUsage,\n  type Choice,\n  type ChatChunk,\n  type LLMCallbacks,\n  LLMEvent,\n  LLM,\n  LLMStream,\n} from './llm.js';\n"],"mappings":"AAGA;AAAA,EAME;AAAA,EACA;AAAA,OACK;AAEP;AAAA,EAIE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP;AAAA,EAME;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../../src/llm/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport {\n  handoff,\n  isFunctionTool,\n  tool,\n  ToolError,\n  type AgentHandoff,\n  type FunctionTool,\n  type ProviderDefinedTool,\n  type Tool,\n  type ToolChoice,\n  type ToolContext,\n  type ToolOptions,\n  type ToolType,\n} from './tool_context.js';\n\nexport {\n  ChatContext,\n  ChatMessage,\n  createAudioContent,\n  createImageContent,\n  FunctionCall,\n  FunctionCallOutput,\n  type AudioContent,\n  type ChatContent,\n  type ChatItem,\n  type ChatRole,\n  type ImageContent,\n} from './chat_context.js';\n\nexport type { ProviderFormat } from './provider_format/index.js';\n\nexport {\n  LLM,\n  LLMStream,\n  type ChatChunk,\n  type ChoiceDelta,\n  type CompletionUsage,\n  type LLMCallbacks,\n} from './llm.js';\n\nexport {\n  RealtimeModel,\n  RealtimeSession,\n  type GenerationCreatedEvent,\n  type InputSpeechStartedEvent,\n  type InputSpeechStoppedEvent,\n  type InputTranscriptionCompleted,\n  type MessageGeneration,\n  type RealtimeCapabilities,\n  type RealtimeModelError,\n  type RealtimeSessionReconnectedEvent,\n} from './realtime.js';\n\nexport { RemoteChatContext } from './remote_chat_context.js';\n\nexport {\n  computeChatCtxDiff,\n  createToolOptions,\n  executeToolCall,\n  oaiBuildFunctionInfo,\n  oaiParams,\n  toJsonSchema,\n  type OpenAIFunctionParameters,\n} from './utils.js';\n"],"mappings":"AAGA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OASK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAMK;AAIP;AAAA,EACE;AAAA,EACA;AAAA,OAKK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,OASK;AAEP,SAAS,yBAAyB;AAElC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;","names":[]}