@livekit/agents-plugin-anam 1.3.0 → 1.3.3

package/dist/avatar.cjs

@@ -46,13 +46,15 @@ async function mintAvatarJoinToken({
 }
 const AVATAR_IDENTITY = "anam-avatar-agent";
 const _AVATAR_NAME = "anam-avatar-agent";
-class AvatarSession {
+class AvatarSession extends import_agents.voice.AvatarSession {
   constructor(opts) {
+    super();
     this.opts = opts;
   }
   sessionId;
   async start(agentSession, room, params) {
     var _a, _b, _c, _d;
+    await super.start(agentSession, room);
     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");

package/dist/avatar.cjs.map

@@ -1 +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":[]}
+{"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 extends voice.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    super();\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    await super.start(agentSession, room);\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,sBAAsB,oBAAM,cAAc;AAAA,EAGrD,YACU,MAQR;AACA,UAAM;AATE;AAAA,EAUV;AAAA,EAbQ;AAAA,EAeR,MAAM,MACJ,cACA,MACA,QAKA;AA/DJ;AAgEI,UAAM,MAAM,MAAM,cAAc,IAAI;AAEpC,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

@@ -9,7 +9,7 @@ export declare function mintAvatarJoinToken({ roomName, avatarIdentity, publishO
     apiSecret?: string;
     ttl?: string | number;
 }): Promise<string>;
-export declare class AvatarSession {
+export declare class AvatarSession extends voice.AvatarSession {
     private opts;
     private sessionId?;
     constructor(opts: {

package/dist/avatar.d.ts

@@ -9,7 +9,7 @@ export declare function mintAvatarJoinToken({ roomName, avatarIdentity, publishO
     apiSecret?: string;
     ttl?: string | number;
 }): Promise<string>;
-export declare class AvatarSession {
+export declare class AvatarSession extends voice.AvatarSession {
     private opts;
     private sessionId?;
     constructor(opts: {

package/dist/avatar.d.ts.map

@@ -1 +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"}
+{"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,aAAc,SAAQ,KAAK,CAAC,aAAa;IAIlD,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;IAKG,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;CA4DJ"}

package/dist/avatar.js

@@ -22,13 +22,15 @@ async function mintAvatarJoinToken({
 }
 const AVATAR_IDENTITY = "anam-avatar-agent";
 const _AVATAR_NAME = "anam-avatar-agent";
-class AvatarSession {
+class AvatarSession extends voice.AvatarSession {
   constructor(opts) {
+    super();
     this.opts = opts;
   }
   sessionId;
   async start(agentSession, room, params) {
     var _a, _b, _c, _d;
+    await super.start(agentSession, room);
     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");

package/dist/avatar.js.map

@@ -1 +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":[]}
+{"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 extends voice.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    super();\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    await super.start(agentSession, room);\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,sBAAsB,MAAM,cAAc;AAAA,EAGrD,YACU,MAQR;AACA,UAAM;AATE;AAAA,EAUV;AAAA,EAbQ;AAAA,EAeR,MAAM,MACJ,cACA,MACA,QAKA;AA/DJ;AAgEI,UAAM,MAAM,MAAM,cAAc,IAAI;AAEpC,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/avatar.test.cjs

@@ -0,0 +1,23 @@
+"use strict";
+var import_agents = require("@livekit/agents");
+var import_vitest = require("vitest");
+var import_avatar = require("./avatar.cjs");
+(0, import_vitest.describe)("Anam AvatarSession", () => {
+  (0, import_vitest.afterEach)(() => {
+    import_vitest.vi.restoreAllMocks();
+  });
+  (0, import_vitest.it)("calls base AvatarSession.start first", async () => {
+    const sentinel = new Error("super-start-called");
+    const superStartSpy = import_vitest.vi.spyOn(import_agents.voice.AvatarSession.prototype, "start").mockRejectedValue(sentinel);
+    const avatar = new import_avatar.AvatarSession({
+      personaConfig: {
+        personaId: "persona-test"
+      }
+    });
+    await (0, import_vitest.expect)(
+      avatar.start({ _started: false, output: { audio: null } }, {})
+    ).rejects.toThrow("super-start-called");
+    (0, import_vitest.expect)(superStartSpy).toHaveBeenCalledTimes(1);
+  });
+});
+//# sourceMappingURL=avatar.test.cjs.map

package/dist/avatar.test.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/avatar.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { voice } from '@livekit/agents';\nimport { afterEach, describe, expect, it, vi } from 'vitest';\nimport { AvatarSession } from './avatar.js';\n\ndescribe('Anam AvatarSession', () => {\n  afterEach(() => {\n    vi.restoreAllMocks();\n  });\n\n  it('calls base AvatarSession.start first', async () => {\n    const sentinel = new Error('super-start-called');\n    const superStartSpy = vi\n      .spyOn(voice.AvatarSession.prototype, 'start')\n      .mockRejectedValue(sentinel);\n\n    const avatar = new AvatarSession({\n      personaConfig: {\n        personaId: 'persona-test',\n      },\n    });\n\n    await expect(\n      avatar.start({ _started: false, output: { audio: null } } as any, {} as any),\n    ).rejects.toThrow('super-start-called');\n    expect(superStartSpy).toHaveBeenCalledTimes(1);\n  });\n});\n"],"mappings":";AAGA,oBAAsB;AACtB,oBAAoD;AACpD,oBAA8B;AAAA,IAE9B,wBAAS,sBAAsB,MAAM;AACnC,+BAAU,MAAM;AACd,qBAAG,gBAAgB;AAAA,EACrB,CAAC;AAED,wBAAG,wCAAwC,YAAY;AACrD,UAAM,WAAW,IAAI,MAAM,oBAAoB;AAC/C,UAAM,gBAAgB,iBACnB,MAAM,oBAAM,cAAc,WAAW,OAAO,EAC5C,kBAAkB,QAAQ;AAE7B,UAAM,SAAS,IAAI,4BAAc;AAAA,MAC/B,eAAe;AAAA,QACb,WAAW;AAAA,MACb;AAAA,IACF,CAAC;AAED,cAAM;AAAA,MACJ,OAAO,MAAM,EAAE,UAAU,OAAO,QAAQ,EAAE,OAAO,KAAK,EAAE,GAAU,CAAC,CAAQ;AAAA,IAC7E,EAAE,QAAQ,QAAQ,oBAAoB;AACtC,8BAAO,aAAa,EAAE,sBAAsB,CAAC;AAAA,EAC/C,CAAC;AACH,CAAC;","names":[]}

package/dist/avatar.test.d.cts

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

package/dist/avatar.test.d.ts

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

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

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

package/dist/avatar.test.js

@@ -0,0 +1,22 @@
+import { voice } from "@livekit/agents";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { AvatarSession } from "./avatar.js";
+describe("Anam AvatarSession", () => {
+  afterEach(() => {
+    vi.restoreAllMocks();
+  });
+  it("calls base AvatarSession.start first", async () => {
+    const sentinel = new Error("super-start-called");
+    const superStartSpy = vi.spyOn(voice.AvatarSession.prototype, "start").mockRejectedValue(sentinel);
+    const avatar = new AvatarSession({
+      personaConfig: {
+        personaId: "persona-test"
+      }
+    });
+    await expect(
+      avatar.start({ _started: false, output: { audio: null } }, {})
+    ).rejects.toThrow("super-start-called");
+    expect(superStartSpy).toHaveBeenCalledTimes(1);
+  });
+});
+//# sourceMappingURL=avatar.test.js.map

package/dist/avatar.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/avatar.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { voice } from '@livekit/agents';\nimport { afterEach, describe, expect, it, vi } from 'vitest';\nimport { AvatarSession } from './avatar.js';\n\ndescribe('Anam AvatarSession', () => {\n  afterEach(() => {\n    vi.restoreAllMocks();\n  });\n\n  it('calls base AvatarSession.start first', async () => {\n    const sentinel = new Error('super-start-called');\n    const superStartSpy = vi\n      .spyOn(voice.AvatarSession.prototype, 'start')\n      .mockRejectedValue(sentinel);\n\n    const avatar = new AvatarSession({\n      personaConfig: {\n        personaId: 'persona-test',\n      },\n    });\n\n    await expect(\n      avatar.start({ _started: false, output: { audio: null } } as any, {} as any),\n    ).rejects.toThrow('super-start-called');\n    expect(superStartSpy).toHaveBeenCalledTimes(1);\n  });\n});\n"],"mappings":"AAGA,SAAS,aAAa;AACtB,SAAS,WAAW,UAAU,QAAQ,IAAI,UAAU;AACpD,SAAS,qBAAqB;AAE9B,SAAS,sBAAsB,MAAM;AACnC,YAAU,MAAM;AACd,OAAG,gBAAgB;AAAA,EACrB,CAAC;AAED,KAAG,wCAAwC,YAAY;AACrD,UAAM,WAAW,IAAI,MAAM,oBAAoB;AAC/C,UAAM,gBAAgB,GACnB,MAAM,MAAM,cAAc,WAAW,OAAO,EAC5C,kBAAkB,QAAQ;AAE7B,UAAM,SAAS,IAAI,cAAc;AAAA,MAC/B,eAAe;AAAA,QACb,WAAW;AAAA,MACb;AAAA,IACF,CAAC;AAED,UAAM;AAAA,MACJ,OAAO,MAAM,EAAE,UAAU,OAAO,QAAQ,EAAE,OAAO,KAAK,EAAE,GAAU,CAAC,CAAQ;AAAA,IAC7E,EAAE,QAAQ,QAAQ,oBAAoB;AACtC,WAAO,aAAa,EAAE,sBAAsB,CAAC;AAAA,EAC/C,CAAC;AACH,CAAC;","names":[]}

package/dist/index.cjs

@@ -23,7 +23,7 @@ class AnamPlugin extends import_agents.Plugin {
   constructor() {
     super({
       title: "anam",
-      version: "1.3.0",
+      version: "1.3.3",
       package: "@livekit/agents-plugin-anam"
     });
   }

package/dist/index.js

@@ -6,7 +6,7 @@ class AnamPlugin extends Plugin {
   constructor() {
     super({
       title: "anam",
-      version: "1.3.0",
+      version: "1.3.3",
       package: "@livekit/agents-plugin-anam"
     });
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livekit/agents-plugin-anam",
-  "version": "1.3.0",
+  "version": "1.3.3",
   "description": "Anam plugin for LiveKit Node Agents",
   "main": "dist/index.js",
   "require": "dist/index.cjs",
@@ -25,22 +25,22 @@
     "README.md"
   ],
   "devDependencies": {
-    "@livekit/rtc-node": "^0.13.25",
+    "@livekit/rtc-node": "^0.13.27",
     "@microsoft/api-extractor": "^7.35.0",
     "@types/ws": "^8.5.10",
     "tsup": "^8.3.5",
     "typescript": "^5.0.0",
-    "@livekit/agents": "1.3.0",
-    "@livekit/agents-plugin-openai": "1.3.0",
-    "@livekit/agents-plugins-test": "1.3.0"
+    "@livekit/agents": "1.3.3",
+    "@livekit/agents-plugin-openai": "1.3.3",
+    "@livekit/agents-plugins-test": "1.3.3"
   },
   "dependencies": {
     "livekit-server-sdk": "^2.9.2",
     "ws": "^8.18.0"
   },
   "peerDependencies": {
-    "@livekit/rtc-node": "^0.13.25",
-    "@livekit/agents": "1.3.0"
+    "@livekit/rtc-node": "^0.13.27",
+    "@livekit/agents": "1.3.3"
   },
   "scripts": {
     "build": "tsup --onSuccess \"pnpm build:types\"",

package/src/avatar.test.ts

@@ -0,0 +1,30 @@
+// SPDX-FileCopyrightText: 2026 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+import { voice } from '@livekit/agents';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { AvatarSession } from './avatar.js';
+
+describe('Anam AvatarSession', () => {
+  afterEach(() => {
+    vi.restoreAllMocks();
+  });
+
+  it('calls base AvatarSession.start first', async () => {
+    const sentinel = new Error('super-start-called');
+    const superStartSpy = vi
+      .spyOn(voice.AvatarSession.prototype, 'start')
+      .mockRejectedValue(sentinel);
+
+    const avatar = new AvatarSession({
+      personaConfig: {
+        personaId: 'persona-test',
+      },
+    });
+
+    await expect(
+      avatar.start({ _started: false, output: { audio: null } } as any, {} as any),
+    ).rejects.toThrow('super-start-called');
+    expect(superStartSpy).toHaveBeenCalledTimes(1);
+  });
+});

package/src/avatar.ts

@@ -37,7 +37,7 @@ export async function mintAvatarJoinToken({
 const AVATAR_IDENTITY = 'anam-avatar-agent';
 const _AVATAR_NAME = 'anam-avatar-agent';
 
-export class AvatarSession {
+export class AvatarSession extends voice.AvatarSession {
   private sessionId?: string;
 
   constructor(
@@ -49,7 +49,9 @@ export class AvatarSession {
       avatarParticipantName?: string;
       connOptions?: APIConnectOptions;
     },
-  ) {}
+  ) {
+    super();
+  }
 
   async start(
     agentSession: voice.AgentSession,
@@ -60,6 +62,8 @@ export class AvatarSession {
       livekitApiSecret?: string;
     },
   ) {
+    await super.start(agentSession, room);
+
     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');