@livekit/agents-plugin-protoface 1.5.3

package/dist/avatar.test.cjs

@@ -0,0 +1,107 @@
+"use strict";
+var import_agents = require("@livekit/agents");
+var import_rtc_node = require("@livekit/rtc-node");
+var import_node_events = require("node:events");
+var import_vitest = require("vitest");
+var import_api = require("./api.cjs");
+var import_avatar = require("./avatar.cjs");
+function fakeRoom() {
+  const emitter = new import_node_events.EventEmitter();
+  const remoteParticipant = {
+    identity: "protoface-avatar-agent",
+    trackPublications: /* @__PURE__ */ new Map([["video", { kind: import_rtc_node.TrackKind.KIND_VIDEO }]])
+  };
+  return {
+    name: "test-room",
+    isConnected: true,
+    localParticipant: {
+      identity: "local-agent",
+      registerRpcMethod: import_vitest.vi.fn()
+    },
+    remoteParticipants: /* @__PURE__ */ new Map([[remoteParticipant.identity, remoteParticipant]]),
+    on: import_vitest.vi.fn((event, listener) => {
+      emitter.on(event, listener);
+      return emitter;
+    }),
+    off: import_vitest.vi.fn((event, listener) => {
+      emitter.off(event, listener);
+      return emitter;
+    })
+  };
+}
+function fakeAgentSession() {
+  const emitter = new import_node_events.EventEmitter();
+  return {
+    _started: true,
+    output: { audio: null },
+    on: import_vitest.vi.fn((event, listener) => {
+      emitter.on(event, listener);
+      return emitter;
+    }),
+    off: import_vitest.vi.fn((event, listener) => {
+      emitter.off(event, listener);
+      return emitter;
+    })
+  };
+}
+(0, import_vitest.describe)("Protoface AvatarSession", () => {
+  (0, import_vitest.afterEach)(() => {
+    import_vitest.vi.restoreAllMocks();
+    import_agents.voice.DataStreamAudioOutput._playbackFinishedRpcRegistered = false;
+    import_agents.voice.DataStreamAudioOutput._playbackFinishedHandlers = {};
+    import_agents.voice.DataStreamAudioOutput._playbackStartedRpcRegistered = false;
+    import_agents.voice.DataStreamAudioOutput._playbackStartedHandlers = {};
+  });
+  (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({ apiKey: "protoface-key" });
+    await (0, import_vitest.expect)(avatar.start(fakeAgentSession(), fakeRoom())).rejects.toThrow(
+      "super-start-called"
+    );
+    (0, import_vitest.expect)(superStartSpy).toHaveBeenCalledTimes(1);
+  });
+  (0, import_vitest.it)("starts a Protoface session and routes agent audio to the avatar", async () => {
+    import_vitest.vi.spyOn(import_agents.voice.AvatarSession.prototype, "start").mockResolvedValue(void 0);
+    import_vitest.vi.spyOn(import_agents.voice.AvatarSession.prototype, "aclose").mockResolvedValue(void 0);
+    const startSessionSpy = import_vitest.vi.spyOn(import_api.ProtofaceAPI.prototype, "startSession").mockResolvedValue({ id: "protoface-session-1" });
+    const endSessionSpy = import_vitest.vi.spyOn(import_api.ProtofaceAPI.prototype, "endSession").mockResolvedValue({});
+    const avatar = new import_avatar.AvatarSession({
+      apiKey: "protoface-key",
+      avatarId: "avatar-1",
+      maxDurationMs: 12e4
+    });
+    const agentSession = fakeAgentSession();
+    await avatar.start(agentSession, fakeRoom(), {
+      livekitUrl: "wss://livekit.example.com",
+      livekitApiKey: "livekit-api-key",
+      livekitApiSecret: "livekit-api-secret"
+    });
+    (0, import_vitest.expect)(avatar.sessionId).toBe("protoface-session-1");
+    (0, import_vitest.expect)(startSessionSpy).toHaveBeenCalledWith({
+      avatarId: "avatar-1",
+      transport: import_vitest.expect.objectContaining({
+        type: "livekit",
+        url: "wss://livekit.example.com",
+        room_name: "test-room",
+        worker_identity: "protoface-avatar-agent",
+        audio_source: "data_stream",
+        worker_token: import_vitest.expect.any(String)
+      }),
+      maxDurationMs: 12e4
+    });
+    const audioOutput = agentSession.output.audio;
+    (0, import_vitest.expect)(audioOutput).toBeInstanceOf(import_agents.voice.DataStreamAudioOutput);
+    (0, import_vitest.expect)(audioOutput.destinationIdentity).toBe(
+      "protoface-avatar-agent"
+    );
+    (0, import_vitest.expect)(audioOutput.sampleRate).toBe(16e3);
+    (0, import_vitest.expect)(audioOutput.waitRemoteTrack).toBe(
+      import_rtc_node.TrackKind.KIND_VIDEO
+    );
+    await avatar.aclose();
+    (0, import_vitest.expect)(endSessionSpy).toHaveBeenCalledWith("protoface-session-1");
+    (0, import_vitest.expect)(avatar.sessionId).toBeNull();
+  });
+});
+//# 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 type { Room } from '@livekit/rtc-node';\nimport { TrackKind } from '@livekit/rtc-node';\nimport { EventEmitter } from 'node:events';\nimport { afterEach, describe, expect, it, vi } from 'vitest';\nimport { ProtofaceAPI } from './api.js';\nimport { AvatarSession } from './avatar.js';\n\ntype DataStreamAudioOutputInternals = {\n  destinationIdentity: string;\n  sampleRate: number;\n  waitRemoteTrack?: TrackKind;\n};\n\nfunction fakeRoom(): Room {\n  const emitter = new EventEmitter();\n  const remoteParticipant = {\n    identity: 'protoface-avatar-agent',\n    trackPublications: new Map([['video', { kind: TrackKind.KIND_VIDEO }]]),\n  };\n\n  return {\n    name: 'test-room',\n    isConnected: true,\n    localParticipant: {\n      identity: 'local-agent',\n      registerRpcMethod: vi.fn(),\n    },\n    remoteParticipants: new Map([[remoteParticipant.identity, remoteParticipant]]),\n    on: vi.fn((event: string | symbol, listener: (...args: unknown[]) => void) => {\n      emitter.on(event, listener);\n      return emitter;\n    }),\n    off: vi.fn((event: string | symbol, listener: (...args: unknown[]) => void) => {\n      emitter.off(event, listener);\n      return emitter;\n    }),\n  } as unknown as Room;\n}\n\nfunction fakeAgentSession(): voice.AgentSession {\n  const emitter = new EventEmitter();\n  return {\n    _started: true,\n    output: { audio: null as voice.AudioOutput | null },\n    on: vi.fn((event: string | symbol, listener: (...args: unknown[]) => void) => {\n      emitter.on(event, listener);\n      return emitter;\n    }),\n    off: vi.fn((event: string | symbol, listener: (...args: unknown[]) => void) => {\n      emitter.off(event, listener);\n      return emitter;\n    }),\n  } as unknown as voice.AgentSession;\n}\n\ndescribe('Protoface AvatarSession', () => {\n  afterEach(() => {\n    vi.restoreAllMocks();\n    voice.DataStreamAudioOutput._playbackFinishedRpcRegistered = false;\n    voice.DataStreamAudioOutput._playbackFinishedHandlers = {};\n    voice.DataStreamAudioOutput._playbackStartedRpcRegistered = false;\n    voice.DataStreamAudioOutput._playbackStartedHandlers = {};\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({ apiKey: 'protoface-key' });\n\n    await expect(avatar.start(fakeAgentSession(), fakeRoom())).rejects.toThrow(\n      'super-start-called',\n    );\n    expect(superStartSpy).toHaveBeenCalledTimes(1);\n  });\n\n  it('starts a Protoface session and routes agent audio to the avatar', async () => {\n    vi.spyOn(voice.AvatarSession.prototype, 'start').mockResolvedValue(undefined);\n    vi.spyOn(voice.AvatarSession.prototype, 'aclose').mockResolvedValue(undefined);\n    const startSessionSpy = vi\n      .spyOn(ProtofaceAPI.prototype, 'startSession')\n      .mockResolvedValue({ id: 'protoface-session-1' });\n    const endSessionSpy = vi.spyOn(ProtofaceAPI.prototype, 'endSession').mockResolvedValue({});\n\n    const avatar = new AvatarSession({\n      apiKey: 'protoface-key',\n      avatarId: 'avatar-1',\n      maxDurationMs: 120_000,\n    });\n    const agentSession = fakeAgentSession();\n\n    await avatar.start(agentSession, fakeRoom(), {\n      livekitUrl: 'wss://livekit.example.com',\n      livekitApiKey: 'livekit-api-key',\n      livekitApiSecret: 'livekit-api-secret',\n    });\n\n    expect(avatar.sessionId).toBe('protoface-session-1');\n    expect(startSessionSpy).toHaveBeenCalledWith({\n      avatarId: 'avatar-1',\n      transport: expect.objectContaining({\n        type: 'livekit',\n        url: 'wss://livekit.example.com',\n        room_name: 'test-room',\n        worker_identity: 'protoface-avatar-agent',\n        audio_source: 'data_stream',\n        worker_token: expect.any(String),\n      }),\n      maxDurationMs: 120_000,\n    });\n\n    const audioOutput = agentSession.output.audio;\n    expect(audioOutput).toBeInstanceOf(voice.DataStreamAudioOutput);\n    expect((audioOutput as unknown as DataStreamAudioOutputInternals).destinationIdentity).toBe(\n      'protoface-avatar-agent',\n    );\n    expect((audioOutput as unknown as DataStreamAudioOutputInternals).sampleRate).toBe(16000);\n    expect((audioOutput as unknown as DataStreamAudioOutputInternals).waitRemoteTrack).toBe(\n      TrackKind.KIND_VIDEO,\n    );\n\n    await avatar.aclose();\n    expect(endSessionSpy).toHaveBeenCalledWith('protoface-session-1');\n    expect(avatar.sessionId).toBeNull();\n  });\n});\n"],"mappings":"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","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,106 @@
+import { voice } from "@livekit/agents";
+import { TrackKind } from "@livekit/rtc-node";
+import { EventEmitter } from "node:events";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { ProtofaceAPI } from "./api.js";
+import { AvatarSession } from "./avatar.js";
+function fakeRoom() {
+  const emitter = new EventEmitter();
+  const remoteParticipant = {
+    identity: "protoface-avatar-agent",
+    trackPublications: /* @__PURE__ */ new Map([["video", { kind: TrackKind.KIND_VIDEO }]])
+  };
+  return {
+    name: "test-room",
+    isConnected: true,
+    localParticipant: {
+      identity: "local-agent",
+      registerRpcMethod: vi.fn()
+    },
+    remoteParticipants: /* @__PURE__ */ new Map([[remoteParticipant.identity, remoteParticipant]]),
+    on: vi.fn((event, listener) => {
+      emitter.on(event, listener);
+      return emitter;
+    }),
+    off: vi.fn((event, listener) => {
+      emitter.off(event, listener);
+      return emitter;
+    })
+  };
+}
+function fakeAgentSession() {
+  const emitter = new EventEmitter();
+  return {
+    _started: true,
+    output: { audio: null },
+    on: vi.fn((event, listener) => {
+      emitter.on(event, listener);
+      return emitter;
+    }),
+    off: vi.fn((event, listener) => {
+      emitter.off(event, listener);
+      return emitter;
+    })
+  };
+}
+describe("Protoface AvatarSession", () => {
+  afterEach(() => {
+    vi.restoreAllMocks();
+    voice.DataStreamAudioOutput._playbackFinishedRpcRegistered = false;
+    voice.DataStreamAudioOutput._playbackFinishedHandlers = {};
+    voice.DataStreamAudioOutput._playbackStartedRpcRegistered = false;
+    voice.DataStreamAudioOutput._playbackStartedHandlers = {};
+  });
+  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({ apiKey: "protoface-key" });
+    await expect(avatar.start(fakeAgentSession(), fakeRoom())).rejects.toThrow(
+      "super-start-called"
+    );
+    expect(superStartSpy).toHaveBeenCalledTimes(1);
+  });
+  it("starts a Protoface session and routes agent audio to the avatar", async () => {
+    vi.spyOn(voice.AvatarSession.prototype, "start").mockResolvedValue(void 0);
+    vi.spyOn(voice.AvatarSession.prototype, "aclose").mockResolvedValue(void 0);
+    const startSessionSpy = vi.spyOn(ProtofaceAPI.prototype, "startSession").mockResolvedValue({ id: "protoface-session-1" });
+    const endSessionSpy = vi.spyOn(ProtofaceAPI.prototype, "endSession").mockResolvedValue({});
+    const avatar = new AvatarSession({
+      apiKey: "protoface-key",
+      avatarId: "avatar-1",
+      maxDurationMs: 12e4
+    });
+    const agentSession = fakeAgentSession();
+    await avatar.start(agentSession, fakeRoom(), {
+      livekitUrl: "wss://livekit.example.com",
+      livekitApiKey: "livekit-api-key",
+      livekitApiSecret: "livekit-api-secret"
+    });
+    expect(avatar.sessionId).toBe("protoface-session-1");
+    expect(startSessionSpy).toHaveBeenCalledWith({
+      avatarId: "avatar-1",
+      transport: expect.objectContaining({
+        type: "livekit",
+        url: "wss://livekit.example.com",
+        room_name: "test-room",
+        worker_identity: "protoface-avatar-agent",
+        audio_source: "data_stream",
+        worker_token: expect.any(String)
+      }),
+      maxDurationMs: 12e4
+    });
+    const audioOutput = agentSession.output.audio;
+    expect(audioOutput).toBeInstanceOf(voice.DataStreamAudioOutput);
+    expect(audioOutput.destinationIdentity).toBe(
+      "protoface-avatar-agent"
+    );
+    expect(audioOutput.sampleRate).toBe(16e3);
+    expect(audioOutput.waitRemoteTrack).toBe(
+      TrackKind.KIND_VIDEO
+    );
+    await avatar.aclose();
+    expect(endSessionSpy).toHaveBeenCalledWith("protoface-session-1");
+    expect(avatar.sessionId).toBeNull();
+  });
+});
+//# 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 type { Room } from '@livekit/rtc-node';\nimport { TrackKind } from '@livekit/rtc-node';\nimport { EventEmitter } from 'node:events';\nimport { afterEach, describe, expect, it, vi } from 'vitest';\nimport { ProtofaceAPI } from './api.js';\nimport { AvatarSession } from './avatar.js';\n\ntype DataStreamAudioOutputInternals = {\n  destinationIdentity: string;\n  sampleRate: number;\n  waitRemoteTrack?: TrackKind;\n};\n\nfunction fakeRoom(): Room {\n  const emitter = new EventEmitter();\n  const remoteParticipant = {\n    identity: 'protoface-avatar-agent',\n    trackPublications: new Map([['video', { kind: TrackKind.KIND_VIDEO }]]),\n  };\n\n  return {\n    name: 'test-room',\n    isConnected: true,\n    localParticipant: {\n      identity: 'local-agent',\n      registerRpcMethod: vi.fn(),\n    },\n    remoteParticipants: new Map([[remoteParticipant.identity, remoteParticipant]]),\n    on: vi.fn((event: string | symbol, listener: (...args: unknown[]) => void) => {\n      emitter.on(event, listener);\n      return emitter;\n    }),\n    off: vi.fn((event: string | symbol, listener: (...args: unknown[]) => void) => {\n      emitter.off(event, listener);\n      return emitter;\n    }),\n  } as unknown as Room;\n}\n\nfunction fakeAgentSession(): voice.AgentSession {\n  const emitter = new EventEmitter();\n  return {\n    _started: true,\n    output: { audio: null as voice.AudioOutput | null },\n    on: vi.fn((event: string | symbol, listener: (...args: unknown[]) => void) => {\n      emitter.on(event, listener);\n      return emitter;\n    }),\n    off: vi.fn((event: string | symbol, listener: (...args: unknown[]) => void) => {\n      emitter.off(event, listener);\n      return emitter;\n    }),\n  } as unknown as voice.AgentSession;\n}\n\ndescribe('Protoface AvatarSession', () => {\n  afterEach(() => {\n    vi.restoreAllMocks();\n    voice.DataStreamAudioOutput._playbackFinishedRpcRegistered = false;\n    voice.DataStreamAudioOutput._playbackFinishedHandlers = {};\n    voice.DataStreamAudioOutput._playbackStartedRpcRegistered = false;\n    voice.DataStreamAudioOutput._playbackStartedHandlers = {};\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({ apiKey: 'protoface-key' });\n\n    await expect(avatar.start(fakeAgentSession(), fakeRoom())).rejects.toThrow(\n      'super-start-called',\n    );\n    expect(superStartSpy).toHaveBeenCalledTimes(1);\n  });\n\n  it('starts a Protoface session and routes agent audio to the avatar', async () => {\n    vi.spyOn(voice.AvatarSession.prototype, 'start').mockResolvedValue(undefined);\n    vi.spyOn(voice.AvatarSession.prototype, 'aclose').mockResolvedValue(undefined);\n    const startSessionSpy = vi\n      .spyOn(ProtofaceAPI.prototype, 'startSession')\n      .mockResolvedValue({ id: 'protoface-session-1' });\n    const endSessionSpy = vi.spyOn(ProtofaceAPI.prototype, 'endSession').mockResolvedValue({});\n\n    const avatar = new AvatarSession({\n      apiKey: 'protoface-key',\n      avatarId: 'avatar-1',\n      maxDurationMs: 120_000,\n    });\n    const agentSession = fakeAgentSession();\n\n    await avatar.start(agentSession, fakeRoom(), {\n      livekitUrl: 'wss://livekit.example.com',\n      livekitApiKey: 'livekit-api-key',\n      livekitApiSecret: 'livekit-api-secret',\n    });\n\n    expect(avatar.sessionId).toBe('protoface-session-1');\n    expect(startSessionSpy).toHaveBeenCalledWith({\n      avatarId: 'avatar-1',\n      transport: expect.objectContaining({\n        type: 'livekit',\n        url: 'wss://livekit.example.com',\n        room_name: 'test-room',\n        worker_identity: 'protoface-avatar-agent',\n        audio_source: 'data_stream',\n        worker_token: expect.any(String),\n      }),\n      maxDurationMs: 120_000,\n    });\n\n    const audioOutput = agentSession.output.audio;\n    expect(audioOutput).toBeInstanceOf(voice.DataStreamAudioOutput);\n    expect((audioOutput as unknown as DataStreamAudioOutputInternals).destinationIdentity).toBe(\n      'protoface-avatar-agent',\n    );\n    expect((audioOutput as unknown as DataStreamAudioOutputInternals).sampleRate).toBe(16000);\n    expect((audioOutput as unknown as DataStreamAudioOutputInternals).waitRemoteTrack).toBe(\n      TrackKind.KIND_VIDEO,\n    );\n\n    await avatar.aclose();\n    expect(endSessionSpy).toHaveBeenCalledWith('protoface-session-1');\n    expect(avatar.sessionId).toBeNull();\n  });\n});\n"],"mappings":"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","names":[]}

package/dist/index.cjs

@@ -0,0 +1,36 @@
+"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("./api.cjs"), module.exports);
+__reExport(index_exports, require("./avatar.cjs"), module.exports);
+class ProtofacePlugin extends import_agents.Plugin {
+  constructor() {
+    super({
+      title: "protoface",
+      version: "1.5.3",
+      package: "@livekit/agents-plugin-protoface"
+    });
+  }
+}
+import_agents.Plugin.registerPlugin(new ProtofacePlugin());
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...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: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { Plugin } from '@livekit/agents';\n\nexport * from './api.js';\nexport * from './avatar.js';\n\nclass ProtofacePlugin extends Plugin {\n  constructor() {\n    super({\n      title: 'protoface',\n      version: __PACKAGE_VERSION__,\n      package: __PACKAGE_NAME__,\n    });\n  }\n}\n\nPlugin.registerPlugin(new ProtofacePlugin());\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAGA,oBAAuB;AAEvB,0BAAc,qBALd;AAMA,0BAAc,wBANd;AAQA,MAAM,wBAAwB,qBAAO;AAAA,EACnC,cAAc;AACZ,UAAM;AAAA,MACJ,OAAO;AAAA,MACP,SAAS;AAAA,MACT,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACF;AAEA,qBAAO,eAAe,IAAI,gBAAgB,CAAC;","names":[]}

package/dist/index.d.cts

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+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,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/index.js

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

package/dist/index.js.map

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

package/dist/log.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 log_exports = {};
+__export(log_exports, {
+  log: () => log
+});
+module.exports = __toCommonJS(log_exports);
+var import_agents = require("@livekit/agents");
+const log = () => (0, import_agents.log)().child({ plugin: "protoface" });
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  log
+});
+//# sourceMappingURL=log.cjs.map

package/dist/log.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/log.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { log as agentsLog } from '@livekit/agents';\nimport type { Logger } from 'pino';\n\nexport const log = (): Logger => agentsLog().child({ plugin: 'protoface' });\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,oBAAiC;AAG1B,MAAM,MAAM,UAAc,cAAAA,KAAU,EAAE,MAAM,EAAE,QAAQ,YAAY,CAAC;","names":["agentsLog"]}

package/dist/log.d.cts

@@ -0,0 +1,3 @@
+import type { Logger } from 'pino';
+export declare const log: () => Logger;
+//# sourceMappingURL=log.d.ts.map

package/dist/log.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from 'pino';
+export declare const log: () => Logger;
+//# sourceMappingURL=log.d.ts.map

package/dist/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,eAAO,MAAM,GAAG,QAAO,MAAoD,CAAC"}

package/dist/log.js

@@ -0,0 +1,6 @@
+import { log as agentsLog } from "@livekit/agents";
+const log = () => agentsLog().child({ plugin: "protoface" });
+export {
+  log
+};
+//# sourceMappingURL=log.js.map

package/dist/log.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/log.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { log as agentsLog } from '@livekit/agents';\nimport type { Logger } from 'pino';\n\nexport const log = (): Logger => agentsLog().child({ plugin: 'protoface' });\n"],"mappings":"AAGA,SAAS,OAAO,iBAAiB;AAG1B,MAAM,MAAM,MAAc,UAAU,EAAE,MAAM,EAAE,QAAQ,YAAY,CAAC;","names":[]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@livekit/agents-plugin-protoface",
+  "version": "1.5.3",
+  "description": "Protoface avatar 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.31",
+    "@microsoft/api-extractor": "^7.35.0",
+    "pino": "^8.19.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.0.0",
+    "@livekit/agents": "1.5.4"
+  },
+  "dependencies": {
+    "livekit-server-sdk": "^2.13.3"
+  },
+  "peerDependencies": {
+    "@livekit/rtc-node": "^0.13.31",
+    "@livekit/agents": "1.5.4"
+  },
+  "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.test.ts

@@ -0,0 +1,65 @@
+// SPDX-FileCopyrightText: 2026 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { ProtofaceAPI, ProtofaceException } from './api.js';
+
+describe('ProtofaceAPI', () => {
+  afterEach(() => {
+    vi.unstubAllEnvs();
+    vi.unstubAllGlobals();
+  });
+
+  it('requires an API key', () => {
+    vi.stubEnv('PROTOFACE_API_KEY', '');
+
+    expect(() => new ProtofaceAPI()).toThrow(ProtofaceException);
+  });
+
+  it('uses env configuration and sends the expected start session request', async () => {
+    vi.stubEnv('PROTOFACE_API_KEY', 'sk_test');
+    vi.stubEnv('PROTOFACE_API_URL', 'https://api.example.test/');
+    const fetchMock = vi.fn(async () => new Response('{"id":"sess_test"}', { status: 200 }));
+    vi.stubGlobal('fetch', fetchMock);
+
+    const client = new ProtofaceAPI();
+    const session = await client.startSession({
+      avatarId: 'av_test',
+      transport: { type: 'livekit' },
+      maxDurationMs: 120_000,
+    });
+
+    expect(session).toEqual({ id: 'sess_test' });
+    expect(fetchMock).toHaveBeenCalledTimes(1);
+    expect(fetchMock).toHaveBeenCalledWith(
+      'https://api.example.test/v1/sessions',
+      expect.objectContaining({
+        method: 'POST',
+        headers: expect.objectContaining({
+          accept: 'application/json',
+          authorization: 'Bearer sk_test',
+          'content-type': 'application/json',
+          'user-agent': '@livekit/agents-plugin-protoface/0.0.0-test',
+        }),
+        body: JSON.stringify({
+          avatar_id: 'av_test',
+          transport: { type: 'livekit' },
+          max_duration_seconds: 120,
+        }),
+      }),
+    );
+  });
+
+  it('ends a session', async () => {
+    const fetchMock = vi.fn(async () => new Response('{}', { status: 200 }));
+    vi.stubGlobal('fetch', fetchMock);
+
+    const client = new ProtofaceAPI({ apiKey: 'sk_test', apiUrl: 'https://api.example.test' });
+    await expect(client.endSession('sess_test')).resolves.toEqual({});
+
+    expect(fetchMock).toHaveBeenCalledWith(
+      'https://api.example.test/v1/sessions/sess_test/end',
+      expect.objectContaining({ method: 'POST' }),
+    );
+  });
+});