@livekit/agents-plugin-cartesia 0.0.0-next-20260624041820

package/dist/tts.test.cjs

@@ -0,0 +1,17 @@
+"use strict";
+var import_agents_plugin_openai = require("@livekit/agents-plugin-openai");
+var import_agents_plugins_test = require("@livekit/agents-plugins-test");
+var import_vitest = require("vitest");
+var import_tts = require("./tts.cjs");
+const hasCartesiaConfig = Boolean(process.env.CARTESIA_API_KEY && process.env.OPENAI_API_KEY);
+if (hasCartesiaConfig) {
+  (0, import_vitest.describe)("Cartesia", async () => {
+    await (0, import_agents_plugins_test.tts)(new import_tts.TTS(), new import_agents_plugin_openai.STT());
+  });
+} else {
+  (0, import_vitest.describe)("Cartesia", () => {
+    import_vitest.it.skip("requires CARTESIA_API_KEY and OPENAI_API_KEY", () => {
+    });
+  });
+}
+//# sourceMappingURL=tts.test.cjs.map

package/dist/tts.test.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tts.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { STT } from '@livekit/agents-plugin-openai';\nimport { tts } from '@livekit/agents-plugins-test';\nimport { describe, it } from 'vitest';\nimport { TTS } from './tts.js';\n\nconst hasCartesiaConfig = Boolean(process.env.CARTESIA_API_KEY && process.env.OPENAI_API_KEY);\n\nif (hasCartesiaConfig) {\n  describe('Cartesia', async () => {\n    await tts(new TTS(), new STT());\n  });\n} else {\n  describe('Cartesia', () => {\n    it.skip('requires CARTESIA_API_KEY and OPENAI_API_KEY', () => {});\n  });\n}\n"],"mappings":";AAGA,kCAAoB;AACpB,iCAAoB;AACpB,oBAA6B;AAC7B,iBAAoB;AAEpB,MAAM,oBAAoB,QAAQ,QAAQ,IAAI,oBAAoB,QAAQ,IAAI,cAAc;AAE5F,IAAI,mBAAmB;AACrB,8BAAS,YAAY,YAAY;AAC/B,cAAM,gCAAI,IAAI,eAAI,GAAG,IAAI,gCAAI,CAAC;AAAA,EAChC,CAAC;AACH,OAAO;AACL,8BAAS,YAAY,MAAM;AACzB,qBAAG,KAAK,gDAAgD,MAAM;AAAA,IAAC,CAAC;AAAA,EAClE,CAAC;AACH;","names":[]}

package/dist/tts.test.d.cts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tts.test.d.ts.map

package/dist/tts.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tts.test.d.ts.map

package/dist/tts.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts.test.d.ts","sourceRoot":"","sources":["../src/tts.test.ts"],"names":[],"mappings":""}

package/dist/tts.test.js

@@ -0,0 +1,16 @@
+import { STT } from "@livekit/agents-plugin-openai";
+import { tts } from "@livekit/agents-plugins-test";
+import { describe, it } from "vitest";
+import { TTS } from "./tts.js";
+const hasCartesiaConfig = Boolean(process.env.CARTESIA_API_KEY && process.env.OPENAI_API_KEY);
+if (hasCartesiaConfig) {
+  describe("Cartesia", async () => {
+    await tts(new TTS(), new STT());
+  });
+} else {
+  describe("Cartesia", () => {
+    it.skip("requires CARTESIA_API_KEY and OPENAI_API_KEY", () => {
+    });
+  });
+}
+//# sourceMappingURL=tts.test.js.map

package/dist/tts.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tts.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { STT } from '@livekit/agents-plugin-openai';\nimport { tts } from '@livekit/agents-plugins-test';\nimport { describe, it } from 'vitest';\nimport { TTS } from './tts.js';\n\nconst hasCartesiaConfig = Boolean(process.env.CARTESIA_API_KEY && process.env.OPENAI_API_KEY);\n\nif (hasCartesiaConfig) {\n  describe('Cartesia', async () => {\n    await tts(new TTS(), new STT());\n  });\n} else {\n  describe('Cartesia', () => {\n    it.skip('requires CARTESIA_API_KEY and OPENAI_API_KEY', () => {});\n  });\n}\n"],"mappings":"AAGA,SAAS,WAAW;AACpB,SAAS,WAAW;AACpB,SAAS,UAAU,UAAU;AAC7B,SAAS,WAAW;AAEpB,MAAM,oBAAoB,QAAQ,QAAQ,IAAI,oBAAoB,QAAQ,IAAI,cAAc;AAE5F,IAAI,mBAAmB;AACrB,WAAS,YAAY,YAAY;AAC/B,UAAM,IAAI,IAAI,IAAI,GAAG,IAAI,IAAI,CAAC;AAAA,EAChC,CAAC;AACH,OAAO;AACL,WAAS,YAAY,MAAM;AACzB,OAAG,KAAK,gDAAgD,MAAM;AAAA,IAAC,CAAC;AAAA,EAClE,CAAC;AACH;","names":[]}

package/dist/types.cjs

@@ -0,0 +1,124 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+__export(types_exports, {
+  cartesiaChunkMessageSchema: () => cartesiaChunkMessageSchema,
+  cartesiaDoneMessageSchema: () => cartesiaDoneMessageSchema,
+  cartesiaErrorMessageSchema: () => cartesiaErrorMessageSchema,
+  cartesiaFlushDoneMessageSchema: () => cartesiaFlushDoneMessageSchema,
+  cartesiaMessageSchema: () => cartesiaMessageSchema,
+  cartesiaServerMessageSchema: () => cartesiaServerMessageSchema,
+  cartesiaTimestampsMessageSchema: () => cartesiaTimestampsMessageSchema,
+  cartesiaWordTimestampsSchema: () => cartesiaWordTimestampsSchema,
+  hasWordTimestamps: () => hasWordTimestamps,
+  isChunkMessage: () => isChunkMessage,
+  isDoneMessage: () => isDoneMessage,
+  isErrorMessage: () => isErrorMessage,
+  isFlushDoneMessage: () => isFlushDoneMessage,
+  isTimestampsMessage: () => isTimestampsMessage
+});
+module.exports = __toCommonJS(types_exports);
+var import_zod = require("zod");
+const cartesiaWordTimestampsSchema = import_zod.z.object({
+  words: import_zod.z.array(import_zod.z.string()),
+  start: import_zod.z.array(import_zod.z.number()),
+  end: import_zod.z.array(import_zod.z.number())
+});
+const cartesiaChunkMessageSchema = import_zod.z.object({
+  type: import_zod.z.literal("chunk"),
+  data: import_zod.z.string(),
+  done: import_zod.z.boolean(),
+  status_code: import_zod.z.number(),
+  step_time: import_zod.z.number(),
+  context_id: import_zod.z.string()
+});
+const cartesiaTimestampsMessageSchema = import_zod.z.object({
+  type: import_zod.z.literal("timestamps"),
+  done: import_zod.z.boolean(),
+  status_code: import_zod.z.number(),
+  context_id: import_zod.z.string(),
+  word_timestamps: cartesiaWordTimestampsSchema
+});
+const cartesiaDoneMessageSchema = import_zod.z.object({
+  type: import_zod.z.literal("done"),
+  done: import_zod.z.boolean(),
+  status_code: import_zod.z.number(),
+  context_id: import_zod.z.string()
+});
+const cartesiaFlushDoneMessageSchema = import_zod.z.object({
+  type: import_zod.z.literal("flush_done"),
+  done: import_zod.z.boolean(),
+  flush_done: import_zod.z.boolean(),
+  flush_id: import_zod.z.number(),
+  status_code: import_zod.z.number(),
+  context_id: import_zod.z.string()
+});
+const cartesiaErrorMessageSchema = import_zod.z.object({
+  type: import_zod.z.string(),
+  done: import_zod.z.boolean(),
+  error: import_zod.z.string(),
+  status_code: import_zod.z.number(),
+  context_id: import_zod.z.string()
+});
+const cartesiaServerMessageSchema = import_zod.z.discriminatedUnion("type", [
+  cartesiaChunkMessageSchema,
+  cartesiaTimestampsMessageSchema,
+  cartesiaDoneMessageSchema,
+  cartesiaFlushDoneMessageSchema
+]);
+const cartesiaMessageSchema = import_zod.z.union([
+  cartesiaServerMessageSchema,
+  cartesiaErrorMessageSchema
+]);
+function isChunkMessage(msg) {
+  return "type" in msg && msg.type === "chunk";
+}
+function isTimestampsMessage(msg) {
+  return "type" in msg && msg.type === "timestamps";
+}
+function isDoneMessage(msg) {
+  return "type" in msg && msg.type === "done";
+}
+function isFlushDoneMessage(msg) {
+  return "type" in msg && msg.type === "flush_done";
+}
+function isErrorMessage(msg) {
+  return "error" in msg && typeof msg.error === "string";
+}
+function hasWordTimestamps(msg) {
+  return isTimestampsMessage(msg);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cartesiaChunkMessageSchema,
+  cartesiaDoneMessageSchema,
+  cartesiaErrorMessageSchema,
+  cartesiaFlushDoneMessageSchema,
+  cartesiaMessageSchema,
+  cartesiaServerMessageSchema,
+  cartesiaTimestampsMessageSchema,
+  cartesiaWordTimestampsSchema,
+  hasWordTimestamps,
+  isChunkMessage,
+  isDoneMessage,
+  isErrorMessage,
+  isFlushDoneMessage,
+  isTimestampsMessage
+});
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { z } from 'zod';\n\n// ============================================================================\n// Cartesia WebSocket API Schemas\n// Ref: https://docs.cartesia.ai/api-reference/tts/websocket\n// ============================================================================\n\n/** Word timestamps schema - contains timing info for each word */\nexport const cartesiaWordTimestampsSchema = z.object({\n  words: z.array(z.string()),\n  start: z.array(z.number()),\n  end: z.array(z.number()),\n});\n\n/** Audio chunk message - type: \"chunk\" with base64-encoded audio data */\nexport const cartesiaChunkMessageSchema = z.object({\n  type: z.literal('chunk'),\n  data: z.string(),\n  done: z.boolean(),\n  status_code: z.number(),\n  step_time: z.number(),\n  context_id: z.string(),\n});\n\n/** Word timestamps message - type: \"timestamps\" with word timing data */\nexport const cartesiaTimestampsMessageSchema = z.object({\n  type: z.literal('timestamps'),\n  done: z.boolean(),\n  status_code: z.number(),\n  context_id: z.string(),\n  word_timestamps: cartesiaWordTimestampsSchema,\n});\n\n/** Done message - type: \"done\" indicates completion */\nexport const cartesiaDoneMessageSchema = z.object({\n  type: z.literal('done'),\n  done: z.boolean(),\n  status_code: z.number(),\n  context_id: z.string(),\n});\n\n/** Flush done message - type: \"flush_done\" indicates flush completion */\nexport const cartesiaFlushDoneMessageSchema = z.object({\n  type: z.literal('flush_done'),\n  done: z.boolean(),\n  flush_done: z.boolean(),\n  flush_id: z.number(),\n  status_code: z.number(),\n  context_id: z.string(),\n});\n\n/** Error message - has error field */\nexport const cartesiaErrorMessageSchema = z.object({\n  type: z.string(),\n  done: z.boolean(),\n  error: z.string(),\n  status_code: z.number(),\n  context_id: z.string(),\n});\n\n/** Union of all possible Cartesia server messages using discriminated union on 'type' */\nexport const cartesiaServerMessageSchema = z.discriminatedUnion('type', [\n  cartesiaChunkMessageSchema,\n  cartesiaTimestampsMessageSchema,\n  cartesiaDoneMessageSchema,\n  cartesiaFlushDoneMessageSchema,\n]);\n\n// Fallback schema for error messages (can't be in discriminated union due to dynamic type)\nexport const cartesiaMessageSchema = z.union([\n  cartesiaServerMessageSchema,\n  cartesiaErrorMessageSchema,\n]);\n\n// ============================================================================\n// Type exports from Zod schemas\n// ============================================================================\n\nexport type CartesiaWordTimestamps = z.infer<typeof cartesiaWordTimestampsSchema>;\nexport type CartesiaChunkMessage = z.infer<typeof cartesiaChunkMessageSchema>;\nexport type CartesiaTimestampsMessage = z.infer<typeof cartesiaTimestampsMessageSchema>;\nexport type CartesiaDoneMessage = z.infer<typeof cartesiaDoneMessageSchema>;\nexport type CartesiaFlushDoneMessage = z.infer<typeof cartesiaFlushDoneMessageSchema>;\nexport type CartesiaErrorMessage = z.infer<typeof cartesiaErrorMessageSchema>;\nexport type CartesiaServerMessage = z.infer<typeof cartesiaMessageSchema>;\n\n// ============================================================================\n// Helper type guards for message discrimination\n// ============================================================================\n\nexport function isChunkMessage(msg: CartesiaServerMessage): msg is CartesiaChunkMessage {\n  return 'type' in msg && msg.type === 'chunk';\n}\n\nexport function isTimestampsMessage(msg: CartesiaServerMessage): msg is CartesiaTimestampsMessage {\n  return 'type' in msg && msg.type === 'timestamps';\n}\n\nexport function isDoneMessage(msg: CartesiaServerMessage): msg is CartesiaDoneMessage {\n  return 'type' in msg && msg.type === 'done';\n}\n\nexport function isFlushDoneMessage(msg: CartesiaServerMessage): msg is CartesiaFlushDoneMessage {\n  return 'type' in msg && msg.type === 'flush_done';\n}\n\nexport function isErrorMessage(msg: CartesiaServerMessage): msg is CartesiaErrorMessage {\n  return 'error' in msg && typeof msg.error === 'string';\n}\n\nexport function hasWordTimestamps(msg: CartesiaServerMessage): msg is CartesiaTimestampsMessage {\n  return isTimestampsMessage(msg);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,iBAAkB;AAQX,MAAM,+BAA+B,aAAE,OAAO;AAAA,EACnD,OAAO,aAAE,MAAM,aAAE,OAAO,CAAC;AAAA,EACzB,OAAO,aAAE,MAAM,aAAE,OAAO,CAAC;AAAA,EACzB,KAAK,aAAE,MAAM,aAAE,OAAO,CAAC;AACzB,CAAC;AAGM,MAAM,6BAA6B,aAAE,OAAO;AAAA,EACjD,MAAM,aAAE,QAAQ,OAAO;AAAA,EACvB,MAAM,aAAE,OAAO;AAAA,EACf,MAAM,aAAE,QAAQ;AAAA,EAChB,aAAa,aAAE,OAAO;AAAA,EACtB,WAAW,aAAE,OAAO;AAAA,EACpB,YAAY,aAAE,OAAO;AACvB,CAAC;AAGM,MAAM,kCAAkC,aAAE,OAAO;AAAA,EACtD,MAAM,aAAE,QAAQ,YAAY;AAAA,EAC5B,MAAM,aAAE,QAAQ;AAAA,EAChB,aAAa,aAAE,OAAO;AAAA,EACtB,YAAY,aAAE,OAAO;AAAA,EACrB,iBAAiB;AACnB,CAAC;AAGM,MAAM,4BAA4B,aAAE,OAAO;AAAA,EAChD,MAAM,aAAE,QAAQ,MAAM;AAAA,EACtB,MAAM,aAAE,QAAQ;AAAA,EAChB,aAAa,aAAE,OAAO;AAAA,EACtB,YAAY,aAAE,OAAO;AACvB,CAAC;AAGM,MAAM,iCAAiC,aAAE,OAAO;AAAA,EACrD,MAAM,aAAE,QAAQ,YAAY;AAAA,EAC5B,MAAM,aAAE,QAAQ;AAAA,EAChB,YAAY,aAAE,QAAQ;AAAA,EACtB,UAAU,aAAE,OAAO;AAAA,EACnB,aAAa,aAAE,OAAO;AAAA,EACtB,YAAY,aAAE,OAAO;AACvB,CAAC;AAGM,MAAM,6BAA6B,aAAE,OAAO;AAAA,EACjD,MAAM,aAAE,OAAO;AAAA,EACf,MAAM,aAAE,QAAQ;AAAA,EAChB,OAAO,aAAE,OAAO;AAAA,EAChB,aAAa,aAAE,OAAO;AAAA,EACtB,YAAY,aAAE,OAAO;AACvB,CAAC;AAGM,MAAM,8BAA8B,aAAE,mBAAmB,QAAQ;AAAA,EACtE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAGM,MAAM,wBAAwB,aAAE,MAAM;AAAA,EAC3C;AAAA,EACA;AACF,CAAC;AAkBM,SAAS,eAAe,KAAyD;AACtF,SAAO,UAAU,OAAO,IAAI,SAAS;AACvC;AAEO,SAAS,oBAAoB,KAA8D;AAChG,SAAO,UAAU,OAAO,IAAI,SAAS;AACvC;AAEO,SAAS,cAAc,KAAwD;AACpF,SAAO,UAAU,OAAO,IAAI,SAAS;AACvC;AAEO,SAAS,mBAAmB,KAA6D;AAC9F,SAAO,UAAU,OAAO,IAAI,SAAS;AACvC;AAEO,SAAS,eAAe,KAAyD;AACtF,SAAO,WAAW,OAAO,OAAO,IAAI,UAAU;AAChD;AAEO,SAAS,kBAAkB,KAA8D;AAC9F,SAAO,oBAAoB,GAAG;AAChC;","names":[]}

package/dist/types.d.cts

@@ -0,0 +1,133 @@
+import { z } from 'zod';
+/** Word timestamps schema - contains timing info for each word */
+export declare const cartesiaWordTimestampsSchema: z.ZodObject<{
+    words: z.ZodArray<z.ZodString>;
+    start: z.ZodArray<z.ZodNumber>;
+    end: z.ZodArray<z.ZodNumber>;
+}, z.core.$strip>;
+/** Audio chunk message - type: "chunk" with base64-encoded audio data */
+export declare const cartesiaChunkMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"chunk">;
+    data: z.ZodString;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    step_time: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>;
+/** Word timestamps message - type: "timestamps" with word timing data */
+export declare const cartesiaTimestampsMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"timestamps">;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+    word_timestamps: z.ZodObject<{
+        words: z.ZodArray<z.ZodString>;
+        start: z.ZodArray<z.ZodNumber>;
+        end: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Done message - type: "done" indicates completion */
+export declare const cartesiaDoneMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"done">;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>;
+/** Flush done message - type: "flush_done" indicates flush completion */
+export declare const cartesiaFlushDoneMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"flush_done">;
+    done: z.ZodBoolean;
+    flush_done: z.ZodBoolean;
+    flush_id: z.ZodNumber;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>;
+/** Error message - has error field */
+export declare const cartesiaErrorMessageSchema: z.ZodObject<{
+    type: z.ZodString;
+    done: z.ZodBoolean;
+    error: z.ZodString;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>;
+/** Union of all possible Cartesia server messages using discriminated union on 'type' */
+export declare const cartesiaServerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"chunk">;
+    data: z.ZodString;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    step_time: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"timestamps">;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+    word_timestamps: z.ZodObject<{
+        words: z.ZodArray<z.ZodString>;
+        start: z.ZodArray<z.ZodNumber>;
+        end: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"done">;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"flush_done">;
+    done: z.ZodBoolean;
+    flush_done: z.ZodBoolean;
+    flush_id: z.ZodNumber;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>], "type">;
+export declare const cartesiaMessageSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"chunk">;
+    data: z.ZodString;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    step_time: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"timestamps">;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+    word_timestamps: z.ZodObject<{
+        words: z.ZodArray<z.ZodString>;
+        start: z.ZodArray<z.ZodNumber>;
+        end: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"done">;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"flush_done">;
+    done: z.ZodBoolean;
+    flush_done: z.ZodBoolean;
+    flush_id: z.ZodNumber;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>], "type">, z.ZodObject<{
+    type: z.ZodString;
+    done: z.ZodBoolean;
+    error: z.ZodString;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>]>;
+export type CartesiaWordTimestamps = z.infer<typeof cartesiaWordTimestampsSchema>;
+export type CartesiaChunkMessage = z.infer<typeof cartesiaChunkMessageSchema>;
+export type CartesiaTimestampsMessage = z.infer<typeof cartesiaTimestampsMessageSchema>;
+export type CartesiaDoneMessage = z.infer<typeof cartesiaDoneMessageSchema>;
+export type CartesiaFlushDoneMessage = z.infer<typeof cartesiaFlushDoneMessageSchema>;
+export type CartesiaErrorMessage = z.infer<typeof cartesiaErrorMessageSchema>;
+export type CartesiaServerMessage = z.infer<typeof cartesiaMessageSchema>;
+export declare function isChunkMessage(msg: CartesiaServerMessage): msg is CartesiaChunkMessage;
+export declare function isTimestampsMessage(msg: CartesiaServerMessage): msg is CartesiaTimestampsMessage;
+export declare function isDoneMessage(msg: CartesiaServerMessage): msg is CartesiaDoneMessage;
+export declare function isFlushDoneMessage(msg: CartesiaServerMessage): msg is CartesiaFlushDoneMessage;
+export declare function isErrorMessage(msg: CartesiaServerMessage): msg is CartesiaErrorMessage;
+export declare function hasWordTimestamps(msg: CartesiaServerMessage): msg is CartesiaTimestampsMessage;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts

@@ -0,0 +1,133 @@
+import { z } from 'zod';
+/** Word timestamps schema - contains timing info for each word */
+export declare const cartesiaWordTimestampsSchema: z.ZodObject<{
+    words: z.ZodArray<z.ZodString>;
+    start: z.ZodArray<z.ZodNumber>;
+    end: z.ZodArray<z.ZodNumber>;
+}, z.core.$strip>;
+/** Audio chunk message - type: "chunk" with base64-encoded audio data */
+export declare const cartesiaChunkMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"chunk">;
+    data: z.ZodString;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    step_time: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>;
+/** Word timestamps message - type: "timestamps" with word timing data */
+export declare const cartesiaTimestampsMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"timestamps">;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+    word_timestamps: z.ZodObject<{
+        words: z.ZodArray<z.ZodString>;
+        start: z.ZodArray<z.ZodNumber>;
+        end: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Done message - type: "done" indicates completion */
+export declare const cartesiaDoneMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"done">;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>;
+/** Flush done message - type: "flush_done" indicates flush completion */
+export declare const cartesiaFlushDoneMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"flush_done">;
+    done: z.ZodBoolean;
+    flush_done: z.ZodBoolean;
+    flush_id: z.ZodNumber;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>;
+/** Error message - has error field */
+export declare const cartesiaErrorMessageSchema: z.ZodObject<{
+    type: z.ZodString;
+    done: z.ZodBoolean;
+    error: z.ZodString;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>;
+/** Union of all possible Cartesia server messages using discriminated union on 'type' */
+export declare const cartesiaServerMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"chunk">;
+    data: z.ZodString;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    step_time: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"timestamps">;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+    word_timestamps: z.ZodObject<{
+        words: z.ZodArray<z.ZodString>;
+        start: z.ZodArray<z.ZodNumber>;
+        end: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"done">;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"flush_done">;
+    done: z.ZodBoolean;
+    flush_done: z.ZodBoolean;
+    flush_id: z.ZodNumber;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>], "type">;
+export declare const cartesiaMessageSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"chunk">;
+    data: z.ZodString;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    step_time: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"timestamps">;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+    word_timestamps: z.ZodObject<{
+        words: z.ZodArray<z.ZodString>;
+        start: z.ZodArray<z.ZodNumber>;
+        end: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"done">;
+    done: z.ZodBoolean;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"flush_done">;
+    done: z.ZodBoolean;
+    flush_done: z.ZodBoolean;
+    flush_id: z.ZodNumber;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>], "type">, z.ZodObject<{
+    type: z.ZodString;
+    done: z.ZodBoolean;
+    error: z.ZodString;
+    status_code: z.ZodNumber;
+    context_id: z.ZodString;
+}, z.core.$strip>]>;
+export type CartesiaWordTimestamps = z.infer<typeof cartesiaWordTimestampsSchema>;
+export type CartesiaChunkMessage = z.infer<typeof cartesiaChunkMessageSchema>;
+export type CartesiaTimestampsMessage = z.infer<typeof cartesiaTimestampsMessageSchema>;
+export type CartesiaDoneMessage = z.infer<typeof cartesiaDoneMessageSchema>;
+export type CartesiaFlushDoneMessage = z.infer<typeof cartesiaFlushDoneMessageSchema>;
+export type CartesiaErrorMessage = z.infer<typeof cartesiaErrorMessageSchema>;
+export type CartesiaServerMessage = z.infer<typeof cartesiaMessageSchema>;
+export declare function isChunkMessage(msg: CartesiaServerMessage): msg is CartesiaChunkMessage;
+export declare function isTimestampsMessage(msg: CartesiaServerMessage): msg is CartesiaTimestampsMessage;
+export declare function isDoneMessage(msg: CartesiaServerMessage): msg is CartesiaDoneMessage;
+export declare function isFlushDoneMessage(msg: CartesiaServerMessage): msg is CartesiaFlushDoneMessage;
+export declare function isErrorMessage(msg: CartesiaServerMessage): msg is CartesiaErrorMessage;
+export declare function hasWordTimestamps(msg: CartesiaServerMessage): msg is CartesiaTimestampsMessage;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,kEAAkE;AAClE,eAAO,MAAM,4BAA4B;;;;iBAIvC,CAAC;AAEH,yEAAyE;AACzE,eAAO,MAAM,0BAA0B;;;;;;;iBAOrC,CAAC;AAEH,yEAAyE;AACzE,eAAO,MAAM,+BAA+B;;;;;;;;;;iBAM1C,CAAC;AAEH,uDAAuD;AACvD,eAAO,MAAM,yBAAyB;;;;;iBAKpC,CAAC;AAEH,yEAAyE;AACzE,eAAO,MAAM,8BAA8B;;;;;;;iBAOzC,CAAC;AAEH,sCAAsC;AACtC,eAAO,MAAM,0BAA0B;;;;;;iBAMrC,CAAC;AAEH,yFAAyF;AACzF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAKtC,CAAC;AAGH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAGhC,CAAC;AAMH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAM1E,wBAAgB,cAAc,CAAC,GAAG,EAAE,qBAAqB,GAAG,GAAG,IAAI,oBAAoB,CAEtF;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,qBAAqB,GAAG,GAAG,IAAI,yBAAyB,CAEhG;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,qBAAqB,GAAG,GAAG,IAAI,mBAAmB,CAEpF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,qBAAqB,GAAG,GAAG,IAAI,wBAAwB,CAE9F;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,qBAAqB,GAAG,GAAG,IAAI,oBAAoB,CAEtF;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,qBAAqB,GAAG,GAAG,IAAI,yBAAyB,CAE9F"}

package/dist/types.js

@@ -0,0 +1,87 @@
+import { z } from "zod";
+const cartesiaWordTimestampsSchema = z.object({
+  words: z.array(z.string()),
+  start: z.array(z.number()),
+  end: z.array(z.number())
+});
+const cartesiaChunkMessageSchema = z.object({
+  type: z.literal("chunk"),
+  data: z.string(),
+  done: z.boolean(),
+  status_code: z.number(),
+  step_time: z.number(),
+  context_id: z.string()
+});
+const cartesiaTimestampsMessageSchema = z.object({
+  type: z.literal("timestamps"),
+  done: z.boolean(),
+  status_code: z.number(),
+  context_id: z.string(),
+  word_timestamps: cartesiaWordTimestampsSchema
+});
+const cartesiaDoneMessageSchema = z.object({
+  type: z.literal("done"),
+  done: z.boolean(),
+  status_code: z.number(),
+  context_id: z.string()
+});
+const cartesiaFlushDoneMessageSchema = z.object({
+  type: z.literal("flush_done"),
+  done: z.boolean(),
+  flush_done: z.boolean(),
+  flush_id: z.number(),
+  status_code: z.number(),
+  context_id: z.string()
+});
+const cartesiaErrorMessageSchema = z.object({
+  type: z.string(),
+  done: z.boolean(),
+  error: z.string(),
+  status_code: z.number(),
+  context_id: z.string()
+});
+const cartesiaServerMessageSchema = z.discriminatedUnion("type", [
+  cartesiaChunkMessageSchema,
+  cartesiaTimestampsMessageSchema,
+  cartesiaDoneMessageSchema,
+  cartesiaFlushDoneMessageSchema
+]);
+const cartesiaMessageSchema = z.union([
+  cartesiaServerMessageSchema,
+  cartesiaErrorMessageSchema
+]);
+function isChunkMessage(msg) {
+  return "type" in msg && msg.type === "chunk";
+}
+function isTimestampsMessage(msg) {
+  return "type" in msg && msg.type === "timestamps";
+}
+function isDoneMessage(msg) {
+  return "type" in msg && msg.type === "done";
+}
+function isFlushDoneMessage(msg) {
+  return "type" in msg && msg.type === "flush_done";
+}
+function isErrorMessage(msg) {
+  return "error" in msg && typeof msg.error === "string";
+}
+function hasWordTimestamps(msg) {
+  return isTimestampsMessage(msg);
+}
+export {
+  cartesiaChunkMessageSchema,
+  cartesiaDoneMessageSchema,
+  cartesiaErrorMessageSchema,
+  cartesiaFlushDoneMessageSchema,
+  cartesiaMessageSchema,
+  cartesiaServerMessageSchema,
+  cartesiaTimestampsMessageSchema,
+  cartesiaWordTimestampsSchema,
+  hasWordTimestamps,
+  isChunkMessage,
+  isDoneMessage,
+  isErrorMessage,
+  isFlushDoneMessage,
+  isTimestampsMessage
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { z } from 'zod';\n\n// ============================================================================\n// Cartesia WebSocket API Schemas\n// Ref: https://docs.cartesia.ai/api-reference/tts/websocket\n// ============================================================================\n\n/** Word timestamps schema - contains timing info for each word */\nexport const cartesiaWordTimestampsSchema = z.object({\n  words: z.array(z.string()),\n  start: z.array(z.number()),\n  end: z.array(z.number()),\n});\n\n/** Audio chunk message - type: \"chunk\" with base64-encoded audio data */\nexport const cartesiaChunkMessageSchema = z.object({\n  type: z.literal('chunk'),\n  data: z.string(),\n  done: z.boolean(),\n  status_code: z.number(),\n  step_time: z.number(),\n  context_id: z.string(),\n});\n\n/** Word timestamps message - type: \"timestamps\" with word timing data */\nexport const cartesiaTimestampsMessageSchema = z.object({\n  type: z.literal('timestamps'),\n  done: z.boolean(),\n  status_code: z.number(),\n  context_id: z.string(),\n  word_timestamps: cartesiaWordTimestampsSchema,\n});\n\n/** Done message - type: \"done\" indicates completion */\nexport const cartesiaDoneMessageSchema = z.object({\n  type: z.literal('done'),\n  done: z.boolean(),\n  status_code: z.number(),\n  context_id: z.string(),\n});\n\n/** Flush done message - type: \"flush_done\" indicates flush completion */\nexport const cartesiaFlushDoneMessageSchema = z.object({\n  type: z.literal('flush_done'),\n  done: z.boolean(),\n  flush_done: z.boolean(),\n  flush_id: z.number(),\n  status_code: z.number(),\n  context_id: z.string(),\n});\n\n/** Error message - has error field */\nexport const cartesiaErrorMessageSchema = z.object({\n  type: z.string(),\n  done: z.boolean(),\n  error: z.string(),\n  status_code: z.number(),\n  context_id: z.string(),\n});\n\n/** Union of all possible Cartesia server messages using discriminated union on 'type' */\nexport const cartesiaServerMessageSchema = z.discriminatedUnion('type', [\n  cartesiaChunkMessageSchema,\n  cartesiaTimestampsMessageSchema,\n  cartesiaDoneMessageSchema,\n  cartesiaFlushDoneMessageSchema,\n]);\n\n// Fallback schema for error messages (can't be in discriminated union due to dynamic type)\nexport const cartesiaMessageSchema = z.union([\n  cartesiaServerMessageSchema,\n  cartesiaErrorMessageSchema,\n]);\n\n// ============================================================================\n// Type exports from Zod schemas\n// ============================================================================\n\nexport type CartesiaWordTimestamps = z.infer<typeof cartesiaWordTimestampsSchema>;\nexport type CartesiaChunkMessage = z.infer<typeof cartesiaChunkMessageSchema>;\nexport type CartesiaTimestampsMessage = z.infer<typeof cartesiaTimestampsMessageSchema>;\nexport type CartesiaDoneMessage = z.infer<typeof cartesiaDoneMessageSchema>;\nexport type CartesiaFlushDoneMessage = z.infer<typeof cartesiaFlushDoneMessageSchema>;\nexport type CartesiaErrorMessage = z.infer<typeof cartesiaErrorMessageSchema>;\nexport type CartesiaServerMessage = z.infer<typeof cartesiaMessageSchema>;\n\n// ============================================================================\n// Helper type guards for message discrimination\n// ============================================================================\n\nexport function isChunkMessage(msg: CartesiaServerMessage): msg is CartesiaChunkMessage {\n  return 'type' in msg && msg.type === 'chunk';\n}\n\nexport function isTimestampsMessage(msg: CartesiaServerMessage): msg is CartesiaTimestampsMessage {\n  return 'type' in msg && msg.type === 'timestamps';\n}\n\nexport function isDoneMessage(msg: CartesiaServerMessage): msg is CartesiaDoneMessage {\n  return 'type' in msg && msg.type === 'done';\n}\n\nexport function isFlushDoneMessage(msg: CartesiaServerMessage): msg is CartesiaFlushDoneMessage {\n  return 'type' in msg && msg.type === 'flush_done';\n}\n\nexport function isErrorMessage(msg: CartesiaServerMessage): msg is CartesiaErrorMessage {\n  return 'error' in msg && typeof msg.error === 'string';\n}\n\nexport function hasWordTimestamps(msg: CartesiaServerMessage): msg is CartesiaTimestampsMessage {\n  return isTimestampsMessage(msg);\n}\n"],"mappings":"AAGA,SAAS,SAAS;AAQX,MAAM,+BAA+B,EAAE,OAAO;AAAA,EACnD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;AAAA,EACzB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;AAAA,EACzB,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC;AACzB,CAAC;AAGM,MAAM,6BAA6B,EAAE,OAAO;AAAA,EACjD,MAAM,EAAE,QAAQ,OAAO;AAAA,EACvB,MAAM,EAAE,OAAO;AAAA,EACf,MAAM,EAAE,QAAQ;AAAA,EAChB,aAAa,EAAE,OAAO;AAAA,EACtB,WAAW,EAAE,OAAO;AAAA,EACpB,YAAY,EAAE,OAAO;AACvB,CAAC;AAGM,MAAM,kCAAkC,EAAE,OAAO;AAAA,EACtD,MAAM,EAAE,QAAQ,YAAY;AAAA,EAC5B,MAAM,EAAE,QAAQ;AAAA,EAChB,aAAa,EAAE,OAAO;AAAA,EACtB,YAAY,EAAE,OAAO;AAAA,EACrB,iBAAiB;AACnB,CAAC;AAGM,MAAM,4BAA4B,EAAE,OAAO;AAAA,EAChD,MAAM,EAAE,QAAQ,MAAM;AAAA,EACtB,MAAM,EAAE,QAAQ;AAAA,EAChB,aAAa,EAAE,OAAO;AAAA,EACtB,YAAY,EAAE,OAAO;AACvB,CAAC;AAGM,MAAM,iCAAiC,EAAE,OAAO;AAAA,EACrD,MAAM,EAAE,QAAQ,YAAY;AAAA,EAC5B,MAAM,EAAE,QAAQ;AAAA,EAChB,YAAY,EAAE,QAAQ;AAAA,EACtB,UAAU,EAAE,OAAO;AAAA,EACnB,aAAa,EAAE,OAAO;AAAA,EACtB,YAAY,EAAE,OAAO;AACvB,CAAC;AAGM,MAAM,6BAA6B,EAAE,OAAO;AAAA,EACjD,MAAM,EAAE,OAAO;AAAA,EACf,MAAM,EAAE,QAAQ;AAAA,EAChB,OAAO,EAAE,OAAO;AAAA,EAChB,aAAa,EAAE,OAAO;AAAA,EACtB,YAAY,EAAE,OAAO;AACvB,CAAC;AAGM,MAAM,8BAA8B,EAAE,mBAAmB,QAAQ;AAAA,EACtE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAGM,MAAM,wBAAwB,EAAE,MAAM;AAAA,EAC3C;AAAA,EACA;AACF,CAAC;AAkBM,SAAS,eAAe,KAAyD;AACtF,SAAO,UAAU,OAAO,IAAI,SAAS;AACvC;AAEO,SAAS,oBAAoB,KAA8D;AAChG,SAAO,UAAU,OAAO,IAAI,SAAS;AACvC;AAEO,SAAS,cAAc,KAAwD;AACpF,SAAO,UAAU,OAAO,IAAI,SAAS;AACvC;AAEO,SAAS,mBAAmB,KAA6D;AAC9F,SAAO,UAAU,OAAO,IAAI,SAAS;AACvC;AAEO,SAAS,eAAe,KAAyD;AACtF,SAAO,WAAW,OAAO,OAAO,IAAI,UAAU;AAChD;AAEO,SAAS,kBAAkB,KAA8D;AAC9F,SAAO,oBAAoB,GAAG;AAChC;","names":[]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@livekit/agents-plugin-cartesia",
+  "version": "0.0.0-next-20260624041820",
+  "description": "Cartesia plugin for LiveKit Node Agents",
+  "main": "dist/index.js",
+  "require": "dist/index.cjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    "import": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "require": {
+      "types": "./dist/index.d.cts",
+      "default": "./dist/index.cjs"
+    }
+  },
+  "author": "LiveKit",
+  "type": "module",
+  "repository": "git@github.com:livekit/agents-js.git",
+  "license": "Apache-2.0",
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "devDependencies": {
+    "@livekit/rtc-node": "^0.13.29",
+    "@microsoft/api-extractor": "^7.35.0",
+    "@types/ws": "^8.5.10",
+    "tsup": "^8.3.5",
+    "typescript": "^5.0.0",
+    "@livekit/agents": "0.0.0-next-20260624041820",
+    "@livekit/agents-plugin-silero": "0.0.0-next-20260624041820",
+    "@livekit/agents-plugin-openai": "0.0.0-next-20260624041820",
+    "@livekit/agents-plugins-test": "0.0.0-next-20260624041820"
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "peerDependencies": {
+    "@livekit/rtc-node": "^0.13.29",
+    "zod": "^3.25.76 || ^4.1.8",
+    "@livekit/agents": "0.0.0-next-20260624041820"
+  },
+  "scripts": {
+    "build": "tsup --onSuccess \"pnpm build:types\"",
+    "build:types": "tsc --declaration --emitDeclarationOnly && node ../../scripts/copyDeclarationOutput.js",
+    "clean": "rm -rf dist",
+    "clean:build": "pnpm clean && pnpm build",
+    "lint": "eslint -f unix \"src/**/*.{ts,js}\"",
+    "api:check": "api-extractor run --typescript-compiler-folder ../../node_modules/typescript",
+    "api:update": "api-extractor run --local --typescript-compiler-folder ../../node_modules/typescript --verbose"
+  }
+}

package/src/index.ts

@@ -0,0 +1,19 @@
+// SPDX-FileCopyrightText: 2025 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+import { Plugin } from '@livekit/agents';
+
+export * from './stt.js';
+export * from './tts.js';
+
+class CartesiaPlugin extends Plugin {
+  constructor() {
+    super({
+      title: 'cartesia',
+      version: __PACKAGE_VERSION__,
+      package: __PACKAGE_NAME__,
+    });
+  }
+}
+
+Plugin.registerPlugin(new CartesiaPlugin());