@livekit/agents-plugin-anam 1.0.0

package/dist/avatar.cjs

@@ -0,0 +1,110 @@
+"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 avatar_exports = {};
+__export(avatar_exports, {
+  AvatarSession: () => AvatarSession,
+  mintAvatarJoinToken: () => mintAvatarJoinToken
+});
+module.exports = __toCommonJS(avatar_exports);
+var import_agents = require("@livekit/agents");
+var import_rtc_node = require("@livekit/rtc-node");
+var import_livekit_server_sdk = require("livekit-server-sdk");
+var import_api = require("./api.cjs");
+var import_types = require("./types.cjs");
+async function mintAvatarJoinToken({
+  roomName,
+  avatarIdentity,
+  publishOnBehalf,
+  apiKey = process.env.LIVEKIT_API_KEY,
+  apiSecret = process.env.LIVEKIT_API_SECRET,
+  ttl = "60s"
+}) {
+  const at = new import_livekit_server_sdk.AccessToken(apiKey, apiSecret);
+  at.identity = avatarIdentity;
+  at.name = "Anam Avatar";
+  at.kind = "agent";
+  at.ttl = ttl;
+  at.attributes = { "lk.publish_on_behalf": publishOnBehalf };
+  at.addGrant({ roomJoin: true, room: roomName });
+  return at.toJwt();
+}
+const AVATAR_IDENTITY = "anam-avatar-agent";
+const _AVATAR_NAME = "anam-avatar-agent";
+class AvatarSession {
+  constructor(opts) {
+    this.opts = opts;
+  }
+  sessionId;
+  async start(agentSession, room, params) {
+    var _a, _b, _c, _d;
+    const logger = (0, import_agents.log)().child({ module: "AnamAvatar" });
+    const apiKey = this.opts.apiKey ?? process.env.ANAM_API_KEY;
+    if (!apiKey) throw new import_types.AnamException("ANAM_API_KEY is required");
+    const apiUrl = this.opts.apiUrl ?? process.env.ANAM_API_URL;
+    const livekitUrl = (params == null ? void 0 : params.livekitUrl) ?? process.env.LIVEKIT_URL;
+    const lkKey = (params == null ? void 0 : params.livekitApiKey) ?? process.env.LIVEKIT_API_KEY;
+    const lkSecret = (params == null ? void 0 : params.livekitApiSecret) ?? process.env.LIVEKIT_API_SECRET;
+    if (!livekitUrl || !lkKey || !lkSecret) {
+      throw new import_types.AnamException("LIVEKIT_URL/API_KEY/API_SECRET must be set");
+    }
+    const localIdentity = room.localParticipant && room.localParticipant.identity || "agent";
+    logger.debug(
+      {
+        personaName: (_a = this.opts.personaConfig) == null ? void 0 : _a.name,
+        avatarId: (_b = this.opts.personaConfig) == null ? void 0 : _b.avatarId,
+        apiUrl: apiUrl ?? "(default https://api.anam.ai)",
+        livekitUrl,
+        avatarParticipantIdentity: this.opts.avatarParticipantIdentity ?? "anam-avatar-agent",
+        publishOnBehalf: localIdentity
+      },
+      "starting Anam avatar session"
+    );
+    const jwt = await mintAvatarJoinToken({
+      roomName: room.name,
+      avatarIdentity: this.opts.avatarParticipantIdentity ?? AVATAR_IDENTITY,
+      publishOnBehalf: localIdentity,
+      apiKey: lkKey,
+      apiSecret: lkSecret
+    });
+    const anam = new import_api.AnamAPI(apiKey, apiUrl, this.opts.connOptions);
+    logger.debug({ livekitUrl }, "requesting Anam session token");
+    const { sessionToken } = await anam.createSessionToken({
+      personaConfig: {
+        name: (_c = this.opts.personaConfig) == null ? void 0 : _c.name,
+        avatarId: (_d = this.opts.personaConfig) == null ? void 0 : _d.avatarId
+      },
+      livekitUrl,
+      livekitToken: jwt
+    });
+    logger.debug("starting Anam engine session");
+    const started = await anam.startEngineSession({ sessionToken });
+    this.sessionId = started.sessionId;
+    agentSession.output.audio = new import_agents.voice.DataStreamAudioOutput({
+      room,
+      destinationIdentity: this.opts.avatarParticipantIdentity ?? AVATAR_IDENTITY,
+      waitRemoteTrack: import_rtc_node.TrackKind.KIND_VIDEO
+    });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AvatarSession,
+  mintAvatarJoinToken
+});
+//# sourceMappingURL=avatar.cjs.map

package/dist/avatar.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/avatar.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { log, voice } from '@livekit/agents';\nimport type { Room } from '@livekit/rtc-node';\nimport { TrackKind } from '@livekit/rtc-node';\nimport { AccessToken, type VideoGrant } from 'livekit-server-sdk';\nimport { AnamAPI } from './api.js';\nimport { type APIConnectOptions, AnamException, type PersonaConfig } from './types.js';\n\nexport async function mintAvatarJoinToken({\n  roomName,\n  avatarIdentity,\n  publishOnBehalf,\n  apiKey = process.env.LIVEKIT_API_KEY!,\n  apiSecret = process.env.LIVEKIT_API_SECRET!,\n  ttl = '60s',\n}: {\n  roomName: string;\n  avatarIdentity: string;\n  publishOnBehalf: string;\n  apiKey?: string;\n  apiSecret?: string;\n  ttl?: string | number;\n}): Promise<string> {\n  const at = new AccessToken(apiKey, apiSecret);\n  at.identity = avatarIdentity;\n  at.name = 'Anam Avatar';\n  at.kind = 'agent';\n  at.ttl = ttl;\n  at.attributes = { 'lk.publish_on_behalf': publishOnBehalf };\n\n  at.addGrant({ roomJoin: true, room: roomName } as VideoGrant);\n  return at.toJwt();\n}\n\nconst AVATAR_IDENTITY = 'anam-avatar-agent';\nconst _AVATAR_NAME = 'anam-avatar-agent';\n\nexport class AvatarSession {\n  private sessionId?: string;\n\n  constructor(\n    private opts: {\n      personaConfig: PersonaConfig;\n      apiUrl?: string;\n      apiKey?: string;\n      avatarParticipantIdentity?: string;\n      avatarParticipantName?: string;\n      connOptions?: APIConnectOptions;\n    },\n  ) {}\n\n  async start(\n    agentSession: voice.AgentSession,\n    room: Room,\n    params?: {\n      livekitUrl?: string;\n      livekitApiKey?: string;\n      livekitApiSecret?: string;\n    },\n  ) {\n    const logger = log().child({ module: 'AnamAvatar' });\n    const apiKey = this.opts.apiKey ?? process.env.ANAM_API_KEY;\n    if (!apiKey) throw new AnamException('ANAM_API_KEY is required');\n\n    const apiUrl = this.opts.apiUrl ?? process.env.ANAM_API_URL;\n    const livekitUrl = params?.livekitUrl ?? process.env.LIVEKIT_URL;\n    const lkKey = params?.livekitApiKey ?? process.env.LIVEKIT_API_KEY;\n    const lkSecret = params?.livekitApiSecret ?? process.env.LIVEKIT_API_SECRET;\n\n    if (!livekitUrl || !lkKey || !lkSecret) {\n      throw new AnamException('LIVEKIT_URL/API_KEY/API_SECRET must be set');\n    }\n\n    const localIdentity = (room.localParticipant && room.localParticipant.identity) || 'agent';\n\n    logger.debug(\n      {\n        personaName: this.opts.personaConfig?.name,\n        avatarId: this.opts.personaConfig?.avatarId,\n        apiUrl: apiUrl ?? '(default https://api.anam.ai)',\n        livekitUrl,\n        avatarParticipantIdentity: this.opts.avatarParticipantIdentity ?? 'anam-avatar-agent',\n        publishOnBehalf: localIdentity,\n      },\n      'starting Anam avatar session',\n    );\n\n    const jwt = await mintAvatarJoinToken({\n      roomName: room.name!,\n      avatarIdentity: this.opts.avatarParticipantIdentity ?? AVATAR_IDENTITY,\n      publishOnBehalf: localIdentity,\n      apiKey: lkKey,\n      apiSecret: lkSecret,\n    });\n\n    const anam = new AnamAPI(apiKey, apiUrl, this.opts.connOptions);\n    logger.debug({ livekitUrl }, 'requesting Anam session token');\n\n    const { sessionToken } = await anam.createSessionToken({\n      personaConfig: {\n        name: this.opts.personaConfig?.name,\n        avatarId: this.opts.personaConfig?.avatarId,\n      },\n      livekitUrl,\n      livekitToken: jwt,\n    });\n    logger.debug('starting Anam engine session');\n    const started = await anam.startEngineSession({ sessionToken });\n    this.sessionId = started.sessionId;\n\n    agentSession.output.audio = new voice.DataStreamAudioOutput({\n      room,\n      destinationIdentity: this.opts.avatarParticipantIdentity ?? AVATAR_IDENTITY,\n      waitRemoteTrack: TrackKind.KIND_VIDEO,\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,oBAA2B;AAE3B,sBAA0B;AAC1B,gCAA6C;AAC7C,iBAAwB;AACxB,mBAA0E;AAE1E,eAAsB,oBAAoB;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,EACA,SAAS,QAAQ,IAAI;AAAA,EACrB,YAAY,QAAQ,IAAI;AAAA,EACxB,MAAM;AACR,GAOoB;AAClB,QAAM,KAAK,IAAI,sCAAY,QAAQ,SAAS;AAC5C,KAAG,WAAW;AACd,KAAG,OAAO;AACV,KAAG,OAAO;AACV,KAAG,MAAM;AACT,KAAG,aAAa,EAAE,wBAAwB,gBAAgB;AAE1D,KAAG,SAAS,EAAE,UAAU,MAAM,MAAM,SAAS,CAAe;AAC5D,SAAO,GAAG,MAAM;AAClB;AAEA,MAAM,kBAAkB;AACxB,MAAM,eAAe;AAEd,MAAM,cAAc;AAAA,EAGzB,YACU,MAQR;AARQ;AAAA,EAQP;AAAA,EAXK;AAAA,EAaR,MAAM,MACJ,cACA,MACA,QAKA;AA7DJ;AA8DI,UAAM,aAAS,mBAAI,EAAE,MAAM,EAAE,QAAQ,aAAa,CAAC;AACnD,UAAM,SAAS,KAAK,KAAK,UAAU,QAAQ,IAAI;AAC/C,QAAI,CAAC,OAAQ,OAAM,IAAI,2BAAc,0BAA0B;AAE/D,UAAM,SAAS,KAAK,KAAK,UAAU,QAAQ,IAAI;AAC/C,UAAM,cAAa,iCAAQ,eAAc,QAAQ,IAAI;AACrD,UAAM,SAAQ,iCAAQ,kBAAiB,QAAQ,IAAI;AACnD,UAAM,YAAW,iCAAQ,qBAAoB,QAAQ,IAAI;AAEzD,QAAI,CAAC,cAAc,CAAC,SAAS,CAAC,UAAU;AACtC,YAAM,IAAI,2BAAc,4CAA4C;AAAA,IACtE;AAEA,UAAM,gBAAiB,KAAK,oBAAoB,KAAK,iBAAiB,YAAa;AAEnF,WAAO;AAAA,MACL;AAAA,QACE,cAAa,UAAK,KAAK,kBAAV,mBAAyB;AAAA,QACtC,WAAU,UAAK,KAAK,kBAAV,mBAAyB;AAAA,QACnC,QAAQ,UAAU;AAAA,QAClB;AAAA,QACA,2BAA2B,KAAK,KAAK,6BAA6B;AAAA,QAClE,iBAAiB;AAAA,MACnB;AAAA,MACA;AAAA,IACF;AAEA,UAAM,MAAM,MAAM,oBAAoB;AAAA,MACpC,UAAU,KAAK;AAAA,MACf,gBAAgB,KAAK,KAAK,6BAA6B;AAAA,MACvD,iBAAiB;AAAA,MACjB,QAAQ;AAAA,MACR,WAAW;AAAA,IACb,CAAC;AAED,UAAM,OAAO,IAAI,mBAAQ,QAAQ,QAAQ,KAAK,KAAK,WAAW;AAC9D,WAAO,MAAM,EAAE,WAAW,GAAG,+BAA+B;AAE5D,UAAM,EAAE,aAAa,IAAI,MAAM,KAAK,mBAAmB;AAAA,MACrD,eAAe;AAAA,QACb,OAAM,UAAK,KAAK,kBAAV,mBAAyB;AAAA,QAC/B,WAAU,UAAK,KAAK,kBAAV,mBAAyB;AAAA,MACrC;AAAA,MACA;AAAA,MACA,cAAc;AAAA,IAChB,CAAC;AACD,WAAO,MAAM,8BAA8B;AAC3C,UAAM,UAAU,MAAM,KAAK,mBAAmB,EAAE,aAAa,CAAC;AAC9D,SAAK,YAAY,QAAQ;AAEzB,iBAAa,OAAO,QAAQ,IAAI,oBAAM,sBAAsB;AAAA,MAC1D;AAAA,MACA,qBAAqB,KAAK,KAAK,6BAA6B;AAAA,MAC5D,iBAAiB,0BAAU;AAAA,IAC7B,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/avatar.d.cts

@@ -0,0 +1,29 @@
+import { voice } from '@livekit/agents';
+import type { Room } from '@livekit/rtc-node';
+import { type APIConnectOptions, type PersonaConfig } from './types.js';
+export declare function mintAvatarJoinToken({ roomName, avatarIdentity, publishOnBehalf, apiKey, apiSecret, ttl, }: {
+    roomName: string;
+    avatarIdentity: string;
+    publishOnBehalf: string;
+    apiKey?: string;
+    apiSecret?: string;
+    ttl?: string | number;
+}): Promise<string>;
+export declare class AvatarSession {
+    private opts;
+    private sessionId?;
+    constructor(opts: {
+        personaConfig: PersonaConfig;
+        apiUrl?: string;
+        apiKey?: string;
+        avatarParticipantIdentity?: string;
+        avatarParticipantName?: string;
+        connOptions?: APIConnectOptions;
+    });
+    start(agentSession: voice.AgentSession, room: Room, params?: {
+        livekitUrl?: string;
+        livekitApiKey?: string;
+        livekitApiSecret?: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=avatar.d.ts.map

package/dist/avatar.d.ts

@@ -0,0 +1,29 @@
+import { voice } from '@livekit/agents';
+import type { Room } from '@livekit/rtc-node';
+import { type APIConnectOptions, type PersonaConfig } from './types.js';
+export declare function mintAvatarJoinToken({ roomName, avatarIdentity, publishOnBehalf, apiKey, apiSecret, ttl, }: {
+    roomName: string;
+    avatarIdentity: string;
+    publishOnBehalf: string;
+    apiKey?: string;
+    apiSecret?: string;
+    ttl?: string | number;
+}): Promise<string>;
+export declare class AvatarSession {
+    private opts;
+    private sessionId?;
+    constructor(opts: {
+        personaConfig: PersonaConfig;
+        apiUrl?: string;
+        apiKey?: string;
+        avatarParticipantIdentity?: string;
+        avatarParticipantName?: string;
+        connOptions?: APIConnectOptions;
+    });
+    start(agentSession: voice.AgentSession, room: Room, params?: {
+        livekitUrl?: string;
+        livekitApiKey?: string;
+        livekitApiSecret?: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=avatar.d.ts.map

package/dist/avatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar.d.ts","sourceRoot":"","sources":["../src/avatar.ts"],"names":[],"mappings":"AAGA,OAAO,EAAO,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAI9C,OAAO,EAAE,KAAK,iBAAiB,EAAiB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvF,wBAAsB,mBAAmB,CAAC,EACxC,QAAQ,EACR,cAAc,EACd,eAAe,EACf,MAAqC,EACrC,SAA2C,EAC3C,GAAW,GACZ,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CAUlB;AAKD,qBAAa,aAAa;IAItB,OAAO,CAAC,IAAI;IAHd,OAAO,CAAC,SAAS,CAAC,CAAS;gBAGjB,IAAI,EAAE;QACZ,aAAa,EAAE,aAAa,CAAC;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,yBAAyB,CAAC,EAAE,MAAM,CAAC;QACnC,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,WAAW,CAAC,EAAE,iBAAiB,CAAC;KACjC;IAGG,KAAK,CACT,YAAY,EAAE,KAAK,CAAC,YAAY,EAChC,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B;CA0DJ"}

package/dist/avatar.js

@@ -0,0 +1,85 @@
+import { log, voice } from "@livekit/agents";
+import { TrackKind } from "@livekit/rtc-node";
+import { AccessToken } from "livekit-server-sdk";
+import { AnamAPI } from "./api.js";
+import { AnamException } from "./types.js";
+async function mintAvatarJoinToken({
+  roomName,
+  avatarIdentity,
+  publishOnBehalf,
+  apiKey = process.env.LIVEKIT_API_KEY,
+  apiSecret = process.env.LIVEKIT_API_SECRET,
+  ttl = "60s"
+}) {
+  const at = new AccessToken(apiKey, apiSecret);
+  at.identity = avatarIdentity;
+  at.name = "Anam Avatar";
+  at.kind = "agent";
+  at.ttl = ttl;
+  at.attributes = { "lk.publish_on_behalf": publishOnBehalf };
+  at.addGrant({ roomJoin: true, room: roomName });
+  return at.toJwt();
+}
+const AVATAR_IDENTITY = "anam-avatar-agent";
+const _AVATAR_NAME = "anam-avatar-agent";
+class AvatarSession {
+  constructor(opts) {
+    this.opts = opts;
+  }
+  sessionId;
+  async start(agentSession, room, params) {
+    var _a, _b, _c, _d;
+    const logger = log().child({ module: "AnamAvatar" });
+    const apiKey = this.opts.apiKey ?? process.env.ANAM_API_KEY;
+    if (!apiKey) throw new AnamException("ANAM_API_KEY is required");
+    const apiUrl = this.opts.apiUrl ?? process.env.ANAM_API_URL;
+    const livekitUrl = (params == null ? void 0 : params.livekitUrl) ?? process.env.LIVEKIT_URL;
+    const lkKey = (params == null ? void 0 : params.livekitApiKey) ?? process.env.LIVEKIT_API_KEY;
+    const lkSecret = (params == null ? void 0 : params.livekitApiSecret) ?? process.env.LIVEKIT_API_SECRET;
+    if (!livekitUrl || !lkKey || !lkSecret) {
+      throw new AnamException("LIVEKIT_URL/API_KEY/API_SECRET must be set");
+    }
+    const localIdentity = room.localParticipant && room.localParticipant.identity || "agent";
+    logger.debug(
+      {
+        personaName: (_a = this.opts.personaConfig) == null ? void 0 : _a.name,
+        avatarId: (_b = this.opts.personaConfig) == null ? void 0 : _b.avatarId,
+        apiUrl: apiUrl ?? "(default https://api.anam.ai)",
+        livekitUrl,
+        avatarParticipantIdentity: this.opts.avatarParticipantIdentity ?? "anam-avatar-agent",
+        publishOnBehalf: localIdentity
+      },
+      "starting Anam avatar session"
+    );
+    const jwt = await mintAvatarJoinToken({
+      roomName: room.name,
+      avatarIdentity: this.opts.avatarParticipantIdentity ?? AVATAR_IDENTITY,
+      publishOnBehalf: localIdentity,
+      apiKey: lkKey,
+      apiSecret: lkSecret
+    });
+    const anam = new AnamAPI(apiKey, apiUrl, this.opts.connOptions);
+    logger.debug({ livekitUrl }, "requesting Anam session token");
+    const { sessionToken } = await anam.createSessionToken({
+      personaConfig: {
+        name: (_c = this.opts.personaConfig) == null ? void 0 : _c.name,
+        avatarId: (_d = this.opts.personaConfig) == null ? void 0 : _d.avatarId
+      },
+      livekitUrl,
+      livekitToken: jwt
+    });
+    logger.debug("starting Anam engine session");
+    const started = await anam.startEngineSession({ sessionToken });
+    this.sessionId = started.sessionId;
+    agentSession.output.audio = new voice.DataStreamAudioOutput({
+      room,
+      destinationIdentity: this.opts.avatarParticipantIdentity ?? AVATAR_IDENTITY,
+      waitRemoteTrack: TrackKind.KIND_VIDEO
+    });
+  }
+}
+export {
+  AvatarSession,
+  mintAvatarJoinToken
+};
+//# sourceMappingURL=avatar.js.map

package/dist/avatar.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/avatar.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { log, voice } from '@livekit/agents';\nimport type { Room } from '@livekit/rtc-node';\nimport { TrackKind } from '@livekit/rtc-node';\nimport { AccessToken, type VideoGrant } from 'livekit-server-sdk';\nimport { AnamAPI } from './api.js';\nimport { type APIConnectOptions, AnamException, type PersonaConfig } from './types.js';\n\nexport async function mintAvatarJoinToken({\n  roomName,\n  avatarIdentity,\n  publishOnBehalf,\n  apiKey = process.env.LIVEKIT_API_KEY!,\n  apiSecret = process.env.LIVEKIT_API_SECRET!,\n  ttl = '60s',\n}: {\n  roomName: string;\n  avatarIdentity: string;\n  publishOnBehalf: string;\n  apiKey?: string;\n  apiSecret?: string;\n  ttl?: string | number;\n}): Promise<string> {\n  const at = new AccessToken(apiKey, apiSecret);\n  at.identity = avatarIdentity;\n  at.name = 'Anam Avatar';\n  at.kind = 'agent';\n  at.ttl = ttl;\n  at.attributes = { 'lk.publish_on_behalf': publishOnBehalf };\n\n  at.addGrant({ roomJoin: true, room: roomName } as VideoGrant);\n  return at.toJwt();\n}\n\nconst AVATAR_IDENTITY = 'anam-avatar-agent';\nconst _AVATAR_NAME = 'anam-avatar-agent';\n\nexport class AvatarSession {\n  private sessionId?: string;\n\n  constructor(\n    private opts: {\n      personaConfig: PersonaConfig;\n      apiUrl?: string;\n      apiKey?: string;\n      avatarParticipantIdentity?: string;\n      avatarParticipantName?: string;\n      connOptions?: APIConnectOptions;\n    },\n  ) {}\n\n  async start(\n    agentSession: voice.AgentSession,\n    room: Room,\n    params?: {\n      livekitUrl?: string;\n      livekitApiKey?: string;\n      livekitApiSecret?: string;\n    },\n  ) {\n    const logger = log().child({ module: 'AnamAvatar' });\n    const apiKey = this.opts.apiKey ?? process.env.ANAM_API_KEY;\n    if (!apiKey) throw new AnamException('ANAM_API_KEY is required');\n\n    const apiUrl = this.opts.apiUrl ?? process.env.ANAM_API_URL;\n    const livekitUrl = params?.livekitUrl ?? process.env.LIVEKIT_URL;\n    const lkKey = params?.livekitApiKey ?? process.env.LIVEKIT_API_KEY;\n    const lkSecret = params?.livekitApiSecret ?? process.env.LIVEKIT_API_SECRET;\n\n    if (!livekitUrl || !lkKey || !lkSecret) {\n      throw new AnamException('LIVEKIT_URL/API_KEY/API_SECRET must be set');\n    }\n\n    const localIdentity = (room.localParticipant && room.localParticipant.identity) || 'agent';\n\n    logger.debug(\n      {\n        personaName: this.opts.personaConfig?.name,\n        avatarId: this.opts.personaConfig?.avatarId,\n        apiUrl: apiUrl ?? '(default https://api.anam.ai)',\n        livekitUrl,\n        avatarParticipantIdentity: this.opts.avatarParticipantIdentity ?? 'anam-avatar-agent',\n        publishOnBehalf: localIdentity,\n      },\n      'starting Anam avatar session',\n    );\n\n    const jwt = await mintAvatarJoinToken({\n      roomName: room.name!,\n      avatarIdentity: this.opts.avatarParticipantIdentity ?? AVATAR_IDENTITY,\n      publishOnBehalf: localIdentity,\n      apiKey: lkKey,\n      apiSecret: lkSecret,\n    });\n\n    const anam = new AnamAPI(apiKey, apiUrl, this.opts.connOptions);\n    logger.debug({ livekitUrl }, 'requesting Anam session token');\n\n    const { sessionToken } = await anam.createSessionToken({\n      personaConfig: {\n        name: this.opts.personaConfig?.name,\n        avatarId: this.opts.personaConfig?.avatarId,\n      },\n      livekitUrl,\n      livekitToken: jwt,\n    });\n    logger.debug('starting Anam engine session');\n    const started = await anam.startEngineSession({ sessionToken });\n    this.sessionId = started.sessionId;\n\n    agentSession.output.audio = new voice.DataStreamAudioOutput({\n      room,\n      destinationIdentity: this.opts.avatarParticipantIdentity ?? AVATAR_IDENTITY,\n      waitRemoteTrack: TrackKind.KIND_VIDEO,\n    });\n  }\n}\n"],"mappings":"AAGA,SAAS,KAAK,aAAa;AAE3B,SAAS,iBAAiB;AAC1B,SAAS,mBAAoC;AAC7C,SAAS,eAAe;AACxB,SAAiC,qBAAyC;AAE1E,eAAsB,oBAAoB;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,EACA,SAAS,QAAQ,IAAI;AAAA,EACrB,YAAY,QAAQ,IAAI;AAAA,EACxB,MAAM;AACR,GAOoB;AAClB,QAAM,KAAK,IAAI,YAAY,QAAQ,SAAS;AAC5C,KAAG,WAAW;AACd,KAAG,OAAO;AACV,KAAG,OAAO;AACV,KAAG,MAAM;AACT,KAAG,aAAa,EAAE,wBAAwB,gBAAgB;AAE1D,KAAG,SAAS,EAAE,UAAU,MAAM,MAAM,SAAS,CAAe;AAC5D,SAAO,GAAG,MAAM;AAClB;AAEA,MAAM,kBAAkB;AACxB,MAAM,eAAe;AAEd,MAAM,cAAc;AAAA,EAGzB,YACU,MAQR;AARQ;AAAA,EAQP;AAAA,EAXK;AAAA,EAaR,MAAM,MACJ,cACA,MACA,QAKA;AA7DJ;AA8DI,UAAM,SAAS,IAAI,EAAE,MAAM,EAAE,QAAQ,aAAa,CAAC;AACnD,UAAM,SAAS,KAAK,KAAK,UAAU,QAAQ,IAAI;AAC/C,QAAI,CAAC,OAAQ,OAAM,IAAI,cAAc,0BAA0B;AAE/D,UAAM,SAAS,KAAK,KAAK,UAAU,QAAQ,IAAI;AAC/C,UAAM,cAAa,iCAAQ,eAAc,QAAQ,IAAI;AACrD,UAAM,SAAQ,iCAAQ,kBAAiB,QAAQ,IAAI;AACnD,UAAM,YAAW,iCAAQ,qBAAoB,QAAQ,IAAI;AAEzD,QAAI,CAAC,cAAc,CAAC,SAAS,CAAC,UAAU;AACtC,YAAM,IAAI,cAAc,4CAA4C;AAAA,IACtE;AAEA,UAAM,gBAAiB,KAAK,oBAAoB,KAAK,iBAAiB,YAAa;AAEnF,WAAO;AAAA,MACL;AAAA,QACE,cAAa,UAAK,KAAK,kBAAV,mBAAyB;AAAA,QACtC,WAAU,UAAK,KAAK,kBAAV,mBAAyB;AAAA,QACnC,QAAQ,UAAU;AAAA,QAClB;AAAA,QACA,2BAA2B,KAAK,KAAK,6BAA6B;AAAA,QAClE,iBAAiB;AAAA,MACnB;AAAA,MACA;AAAA,IACF;AAEA,UAAM,MAAM,MAAM,oBAAoB;AAAA,MACpC,UAAU,KAAK;AAAA,MACf,gBAAgB,KAAK,KAAK,6BAA6B;AAAA,MACvD,iBAAiB;AAAA,MACjB,QAAQ;AAAA,MACR,WAAW;AAAA,IACb,CAAC;AAED,UAAM,OAAO,IAAI,QAAQ,QAAQ,QAAQ,KAAK,KAAK,WAAW;AAC9D,WAAO,MAAM,EAAE,WAAW,GAAG,+BAA+B;AAE5D,UAAM,EAAE,aAAa,IAAI,MAAM,KAAK,mBAAmB;AAAA,MACrD,eAAe;AAAA,QACb,OAAM,UAAK,KAAK,kBAAV,mBAAyB;AAAA,QAC/B,WAAU,UAAK,KAAK,kBAAV,mBAAyB;AAAA,MACrC;AAAA,MACA;AAAA,MACA,cAAc;AAAA,IAChB,CAAC;AACD,WAAO,MAAM,8BAA8B;AAC3C,UAAM,UAAU,MAAM,KAAK,mBAAmB,EAAE,aAAa,CAAC;AAC9D,SAAK,YAAY,QAAQ;AAEzB,iBAAa,OAAO,QAAQ,IAAI,MAAM,sBAAsB;AAAA,MAC1D;AAAA,MACA,qBAAqB,KAAK,KAAK,6BAA6B;AAAA,MAC5D,iBAAiB,UAAU;AAAA,IAC7B,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/index.cjs

@@ -0,0 +1,38 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var index_exports = {};
+module.exports = __toCommonJS(index_exports);
+var import_agents = require("@livekit/agents");
+__reExport(index_exports, require("./types.cjs"), module.exports);
+__reExport(index_exports, require("./api.cjs"), module.exports);
+__reExport(index_exports, require("./avatar.cjs"), module.exports);
+class AnamPlugin extends import_agents.Plugin {
+  constructor() {
+    super({
+      title: "anam",
+      version: "0.0.1",
+      package: "@livekit/agents-plugin-anam"
+    });
+  }
+}
+import_agents.Plugin.registerPlugin(new AnamPlugin());
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./types.cjs"),
+  ...require("./api.cjs"),
+  ...require("./avatar.cjs")
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { Plugin } from '@livekit/agents';\n\nexport * from './types.js';\nexport * from './api.js';\nexport * from './avatar.js';\n\nclass AnamPlugin extends Plugin {\n  constructor() {\n    super({\n      title: 'anam',\n      version: '0.0.1',\n      package: '@livekit/agents-plugin-anam',\n    });\n  }\n}\nPlugin.registerPlugin(new AnamPlugin());\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAGA,oBAAuB;AAEvB,0BAAc,uBALd;AAMA,0BAAc,qBANd;AAOA,0BAAc,wBAPd;AASA,MAAM,mBAAmB,qBAAO;AAAA,EAC9B,cAAc;AACZ,UAAM;AAAA,MACJ,OAAO;AAAA,MACP,SAAS;AAAA,MACT,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACF;AACA,qBAAO,eAAe,IAAI,WAAW,CAAC;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './api.js';
+export * from './avatar.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './api.js';
+export * from './avatar.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+import { Plugin } from "@livekit/agents";
+export * from "./types.js";
+export * from "./api.js";
+export * from "./avatar.js";
+class AnamPlugin extends Plugin {
+  constructor() {
+    super({
+      title: "anam",
+      version: "0.0.1",
+      package: "@livekit/agents-plugin-anam"
+    });
+  }
+}
+Plugin.registerPlugin(new AnamPlugin());
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { Plugin } from '@livekit/agents';\n\nexport * from './types.js';\nexport * from './api.js';\nexport * from './avatar.js';\n\nclass AnamPlugin extends Plugin {\n  constructor() {\n    super({\n      title: 'anam',\n      version: '0.0.1',\n      package: '@livekit/agents-plugin-anam',\n    });\n  }\n}\nPlugin.registerPlugin(new AnamPlugin());\n"],"mappings":"AAGA,SAAS,cAAc;AAEvB,cAAc;AACd,cAAc;AACd,cAAc;AAEd,MAAM,mBAAmB,OAAO;AAAA,EAC9B,cAAc;AACZ,UAAM;AAAA,MACJ,OAAO;AAAA,MACP,SAAS;AAAA,MACT,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACF;AACA,OAAO,eAAe,IAAI,WAAW,CAAC;","names":[]}

package/dist/types.cjs

@@ -0,0 +1,30 @@
+"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, {
+  AnamException: () => AnamException
+});
+module.exports = __toCommonJS(types_exports);
+class AnamException extends Error {
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AnamException
+});
+//# 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\nexport type PersonaConfig = {\n  /** Optional display name (prod flow) */\n  name?: string;\n  /** Optional avatar asset id (prod flow) */\n  avatarId?: string;\n  /** Optional persona id (dev flow) */\n  personaId?: string;\n};\n\nexport type APIConnectOptions = {\n  maxRetry?: number;\n  retryInterval?: number; // seconds\n  timeout?: number; // seconds\n};\n\nexport class AnamException extends Error {}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAkBO,MAAM,sBAAsB,MAAM;AAAC;","names":[]}

package/dist/types.d.cts

@@ -0,0 +1,16 @@
+export type PersonaConfig = {
+    /** Optional display name (prod flow) */
+    name?: string;
+    /** Optional avatar asset id (prod flow) */
+    avatarId?: string;
+    /** Optional persona id (dev flow) */
+    personaId?: string;
+};
+export type APIConnectOptions = {
+    maxRetry?: number;
+    retryInterval?: number;
+    timeout?: number;
+};
+export declare class AnamException extends Error {
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts

@@ -0,0 +1,16 @@
+export type PersonaConfig = {
+    /** Optional display name (prod flow) */
+    name?: string;
+    /** Optional avatar asset id (prod flow) */
+    avatarId?: string;
+    /** Optional persona id (dev flow) */
+    personaId?: string;
+};
+export type APIConnectOptions = {
+    maxRetry?: number;
+    retryInterval?: number;
+    timeout?: number;
+};
+export declare class AnamException extends Error {
+}
+//# 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,MAAM,MAAM,aAAa,GAAG;IAC1B,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,qBAAa,aAAc,SAAQ,KAAK;CAAG"}

package/dist/types.js

@@ -0,0 +1,6 @@
+class AnamException extends Error {
+}
+export {
+  AnamException
+};
+//# 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\nexport type PersonaConfig = {\n  /** Optional display name (prod flow) */\n  name?: string;\n  /** Optional avatar asset id (prod flow) */\n  avatarId?: string;\n  /** Optional persona id (dev flow) */\n  personaId?: string;\n};\n\nexport type APIConnectOptions = {\n  maxRetry?: number;\n  retryInterval?: number; // seconds\n  timeout?: number; // seconds\n};\n\nexport class AnamException extends Error {}\n"],"mappings":"AAkBO,MAAM,sBAAsB,MAAM;AAAC;","names":[]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@livekit/agents-plugin-anam",
+  "version": "1.0.0",
+  "description": "Anam 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.12",
+    "@microsoft/api-extractor": "^7.35.0",
+    "@types/ws": "^8.5.10",
+    "tsup": "^8.3.5",
+    "typescript": "^5.0.0",
+    "@livekit/agents": "1.0.10",
+    "@livekit/agents-plugins-test": "1.0.10",
+    "@livekit/agents-plugin-openai": "1.0.10"
+  },
+  "dependencies": {
+    "livekit-server-sdk": "^2.9.2",
+    "ws": "^8.16.0"
+  },
+  "peerDependencies": {
+    "@livekit/rtc-node": "^0.13.12",
+    "@livekit/agents": "1.0.10"
+  },
+  "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/api.ts

@@ -0,0 +1,151 @@
+// SPDX-FileCopyrightText: 2025 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+import { log } from '@livekit/agents';
+import { type APIConnectOptions, AnamException, type PersonaConfig } from './types.js';
+
+const DEFAULT_API_URL = 'https://api.anam.ai';
+
+export class AnamAPI {
+  constructor(
+    private apiKey: string,
+    private apiUrl: string = DEFAULT_API_URL,
+    private conn: APIConnectOptions = { maxRetry: 3, retryInterval: 2, timeout: 10 },
+  ) {}
+
+  private get tokenPath(): string {
+    return '/v1/auth/session-token';
+  }
+
+  private get startPath(): string {
+    return '/v1/engine/session';
+  }
+
+  private async postWithHeaders<T>(
+    path: string,
+    body: unknown,
+    headersIn: Record<string, string>,
+  ): Promise<T> {
+    const url = `${this.apiUrl}${path}`;
+    const { maxRetry = 3, retryInterval = 2 } = this.conn;
+    let lastErr: unknown;
+    const logger = log().child({ module: 'AnamAPI' });
+
+    for (let attempt = 0; attempt < maxRetry; attempt++) {
+      try {
+        const headers: Record<string, string> = {
+          'Content-Type': 'application/json',
+          ...headersIn,
+        };
+
+        const redactedHeaders: Record<string, string> = { ...headers };
+        if (redactedHeaders.Authorization) {
+          redactedHeaders.Authorization = 'Bearer ****';
+        }
+        const redactedBody = (() => {
+          if (body && typeof body === 'object') {
+            try {
+              const clone = { ...(body as Record<string, unknown>) } as Record<string, unknown>;
+              if ('livekitToken' in clone) clone.livekitToken = '****';
+              if ('sessionToken' in clone) clone.sessionToken = '****' as unknown as never;
+              return clone;
+            } catch {
+              return { note: 'unserializable body' };
+            }
+          }
+          return body;
+        })();
+
+        logger.debug(
+          {
+            url,
+            method: 'POST',
+            headers: redactedHeaders,
+            body: redactedBody,
+            attempt: attempt + 1,
+          },
+          'calling Anam API',
+        );
+
+        const res = await fetch(url, {
+          method: 'POST',
+          headers,
+          body: JSON.stringify(body),
+          // simple timeout: rely on AbortController in real impl
+        });
+        if (!res.ok) {
+          const text = await res.text();
+          logger.error(
+            {
+              url,
+              method: 'POST',
+              headers: redactedHeaders,
+              body: redactedBody,
+              status: res.status,
+              response: text,
+            },
+            'Anam API request failed',
+          );
+          throw new AnamException(`Anam ${path} failed: ${res.status} ${text}`);
+        }
+        const json = (await res.json()) as T;
+        logger.debug({ url }, 'Anam API request succeeded');
+        return json;
+      } catch (e) {
+        lastErr = e;
+        if (attempt === maxRetry - 1) break;
+        logger.warn(
+          {
+            url,
+            method: 'POST',
+            body:
+              body && typeof body === 'object'
+                ? { ...(body as Record<string, unknown>), livekitToken: '****' }
+                : body,
+            error: (e as Error)?.message,
+            nextRetrySec: retryInterval,
+          },
+          'Anam API error, retrying',
+        );
+        await new Promise((r) => setTimeout(r, retryInterval * 1000));
+      }
+    }
+    throw lastErr instanceof Error ? lastErr : new AnamException('Anam API error');
+  }
+
+  private async post<T>(path: string, body: unknown): Promise<T> {
+    return this.postWithHeaders<T>(path, body, { Authorization: `Bearer ${this.apiKey}` });
+  }
+
+  createSessionToken(params: {
+    personaConfig: PersonaConfig;
+    livekitUrl?: string;
+    livekitToken?: string;
+  }) {
+    const pc = params.personaConfig;
+    const personaPayload = {
+      type: 'ephemeral',
+      name: pc.name,
+      avatarId: pc.avatarId,
+      llmId: 'CUSTOMER_CLIENT_V1',
+    };
+
+    const payload: Record<string, unknown> = {
+      personaConfig: personaPayload,
+    };
+    payload.environment = {
+      livekitUrl: params.livekitUrl,
+      livekitToken: params.livekitToken,
+    };
+
+    return this.post<{ sessionToken: string }>(this.tokenPath, payload);
+  }
+
+  startEngineSession(params: { sessionToken: string }) {
+    return this.postWithHeaders<{ sessionId: string }>(
+      this.startPath,
+      {},
+      { Authorization: `Bearer ${params.sessionToken}` },
+    );
+  }
+}