livekit-server-sdk 2.8.1 → 2.9.1

package/dist/AccessToken.test.cjs

@@ -0,0 +1,147 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var import_protocol = require("@livekit/protocol");
+var jose = __toESM(require("jose"), 1);
+var import_vitest = require("vitest");
+var import_AccessToken = require("./AccessToken");
+const testApiKey = "abcdefg";
+const testSecret = "abababa";
+(0, import_vitest.describe)("encoded tokens are valid", () => {
+  const t = new import_AccessToken.AccessToken(testApiKey, testSecret, {
+    identity: "me",
+    name: "myname"
+  });
+  t.addGrant({ room: "myroom" });
+  const EncodedTestSecret = new TextEncoder().encode(testSecret);
+  (0, import_vitest.it)("can be decoded", async () => {
+    const { payload } = await jose.jwtVerify(await t.toJwt(), EncodedTestSecret, {
+      issuer: testApiKey
+    });
+    (0, import_vitest.expect)(payload).not.toBe(void 0);
+  });
+  (0, import_vitest.it)("has name set", async () => {
+    const { payload } = await jose.jwtVerify(await t.toJwt(), EncodedTestSecret, {
+      issuer: testApiKey
+    });
+    (0, import_vitest.expect)(payload.name).toBe("myname");
+  });
+  (0, import_vitest.it)("has video grants set", async () => {
+    var _a;
+    const { payload } = await jose.jwtVerify(await t.toJwt(), EncodedTestSecret, {
+      issuer: testApiKey
+    });
+    (0, import_vitest.expect)(payload.video).toBeTruthy();
+    (0, import_vitest.expect)((_a = payload.video) == null ? void 0 : _a.room).toEqual("myroom");
+  });
+});
+(0, import_vitest.describe)("identity is required for only join grants", () => {
+  (0, import_vitest.it)("allows empty identity for create", async () => {
+    const t = new import_AccessToken.AccessToken(testApiKey, testSecret);
+    t.addGrant({ roomCreate: true });
+    (0, import_vitest.expect)(await t.toJwt()).toBeTruthy();
+  });
+  (0, import_vitest.it)("throws error when identity is not provided for join", async () => {
+    const t = new import_AccessToken.AccessToken(testApiKey, testSecret);
+    t.addGrant({ roomJoin: true });
+    await (0, import_vitest.expect)(async () => {
+      await t.toJwt();
+    }).rejects.toThrow();
+  });
+});
+(0, import_vitest.describe)("verify token is valid", () => {
+  (0, import_vitest.it)("can decode encoded token", async () => {
+    var _a;
+    const t = new import_AccessToken.AccessToken(testApiKey, testSecret);
+    t.sha256 = "abcdefg";
+    t.kind = "agent";
+    t.addGrant({ roomCreate: true });
+    t.attributes = { foo: "bar", live: "kit" };
+    const v = new import_AccessToken.TokenVerifier(testApiKey, testSecret);
+    const decoded = await v.verify(await t.toJwt());
+    (0, import_vitest.expect)(decoded).not.toBe(void 0);
+    (0, import_vitest.expect)(decoded.sha256).toEqual("abcdefg");
+    (0, import_vitest.expect)((_a = decoded.video) == null ? void 0 : _a.roomCreate).toBeTruthy();
+    (0, import_vitest.expect)(decoded.kind).toEqual("agent");
+    (0, import_vitest.expect)(decoded.attributes).toEqual(t.attributes);
+  });
+});
+(0, import_vitest.describe)("adding grants should not overwrite existing grants", () => {
+  const EncodedTestSecret = new TextEncoder().encode(testSecret);
+  (0, import_vitest.it)("should not overwrite existing grants", async () => {
+    var _a, _b;
+    const t = new import_AccessToken.AccessToken(testApiKey, testSecret, {
+      identity: "me",
+      name: "myname"
+    });
+    t.addGrant({ roomCreate: true });
+    t.addGrant({ roomJoin: true });
+    const { payload } = await jose.jwtVerify(
+      await t.toJwt(),
+      EncodedTestSecret,
+      { issuer: testApiKey }
+    );
+    (0, import_vitest.expect)((_a = payload.video) == null ? void 0 : _a.roomCreate).toBeTruthy();
+    (0, import_vitest.expect)((_b = payload.video) == null ? void 0 : _b.roomJoin).toBeTruthy();
+  });
+});
+(0, import_vitest.describe)("room configuration with agents and egress", () => {
+  (0, import_vitest.it)("should set agents and egress in room configuration", async () => {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n;
+    const t = new import_AccessToken.AccessToken(testApiKey, testSecret, {
+      identity: "test-identity"
+    });
+    const roomConfig = new import_protocol.RoomConfiguration({
+      name: "test-room",
+      maxParticipants: 10
+    });
+    const agents = [
+      new import_protocol.RoomAgentDispatch({
+        agentName: "agent1",
+        metadata: "metadata-1"
+      }),
+      new import_protocol.RoomAgentDispatch({
+        agentName: "agent2",
+        metadata: "metadata-2"
+      })
+    ];
+    const egress = new import_protocol.RoomEgress({
+      room: new import_protocol.RoomCompositeEgressRequest({ roomName: "test-room" })
+    });
+    roomConfig.agents = agents;
+    roomConfig.egress = egress;
+    t.roomConfig = roomConfig;
+    const v = new import_AccessToken.TokenVerifier(testApiKey, testSecret);
+    const decoded = await v.verify(await t.toJwt());
+    (0, import_vitest.expect)(decoded.roomConfig).toBeDefined();
+    (0, import_vitest.expect)((_a = decoded.roomConfig) == null ? void 0 : _a.name).toEqual("test-room");
+    (0, import_vitest.expect)((_b = decoded.roomConfig) == null ? void 0 : _b.maxParticipants).toEqual(10);
+    (0, import_vitest.expect)((_c = decoded.roomConfig) == null ? void 0 : _c.agents).toHaveLength(2);
+    (0, import_vitest.expect)((_e = (_d = decoded.roomConfig) == null ? void 0 : _d.agents) == null ? void 0 : _e[0].agentName).toEqual("agent1");
+    (0, import_vitest.expect)((_g = (_f = decoded.roomConfig) == null ? void 0 : _f.agents) == null ? void 0 : _g[0].metadata).toEqual("metadata-1");
+    (0, import_vitest.expect)((_i = (_h = decoded.roomConfig) == null ? void 0 : _h.agents) == null ? void 0 : _i[1].agentName).toEqual("agent2");
+    (0, import_vitest.expect)((_k = (_j = decoded.roomConfig) == null ? void 0 : _j.agents) == null ? void 0 : _k[1].metadata).toEqual("metadata-2");
+    (0, import_vitest.expect)((_n = (_m = (_l = decoded.roomConfig) == null ? void 0 : _l.egress) == null ? void 0 : _m.room) == null ? void 0 : _n.roomName).toEqual("test-room");
+  });
+});
+//# sourceMappingURL=AccessToken.test.cjs.map

package/dist/AccessToken.test.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/AccessToken.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport {\n  RoomAgentDispatch,\n  RoomCompositeEgressRequest,\n  RoomConfiguration,\n  RoomEgress,\n} from '@livekit/protocol';\nimport * as jose from 'jose';\nimport { describe, expect, it } from 'vitest';\nimport { AccessToken, TokenVerifier } from './AccessToken';\nimport type { ClaimGrants } from './grants';\n\nconst testApiKey = 'abcdefg';\nconst testSecret = 'abababa';\n\ndescribe('encoded tokens are valid', () => {\n  const t = new AccessToken(testApiKey, testSecret, {\n    identity: 'me',\n    name: 'myname',\n  });\n  t.addGrant({ room: 'myroom' });\n  const EncodedTestSecret = new TextEncoder().encode(testSecret);\n  it('can be decoded', async () => {\n    const { payload } = await jose.jwtVerify(await t.toJwt(), EncodedTestSecret, {\n      issuer: testApiKey,\n    });\n\n    expect(payload).not.toBe(undefined);\n  });\n\n  it('has name set', async () => {\n    const { payload } = await jose.jwtVerify(await t.toJwt(), EncodedTestSecret, {\n      issuer: testApiKey,\n    });\n\n    expect(payload.name).toBe('myname');\n  });\n\n  it('has video grants set', async () => {\n    const { payload } = await jose.jwtVerify(await t.toJwt(), EncodedTestSecret, {\n      issuer: testApiKey,\n    });\n\n    expect(payload.video).toBeTruthy();\n    expect((payload as ClaimGrants).video?.room).toEqual('myroom');\n  });\n});\n\ndescribe('identity is required for only join grants', () => {\n  it('allows empty identity for create', async () => {\n    const t = new AccessToken(testApiKey, testSecret);\n    t.addGrant({ roomCreate: true });\n\n    expect(await t.toJwt()).toBeTruthy();\n  });\n  it('throws error when identity is not provided for join', async () => {\n    const t = new AccessToken(testApiKey, testSecret);\n    t.addGrant({ roomJoin: true });\n\n    await expect(async () => {\n      await t.toJwt();\n    }).rejects.toThrow();\n  });\n});\n\ndescribe('verify token is valid', () => {\n  it('can decode encoded token', async () => {\n    const t = new AccessToken(testApiKey, testSecret);\n    t.sha256 = 'abcdefg';\n    t.kind = 'agent';\n    t.addGrant({ roomCreate: true });\n    t.attributes = { foo: 'bar', live: 'kit' };\n\n    const v = new TokenVerifier(testApiKey, testSecret);\n    const decoded = await v.verify(await t.toJwt());\n\n    expect(decoded).not.toBe(undefined);\n    expect(decoded.sha256).toEqual('abcdefg');\n    expect(decoded.video?.roomCreate).toBeTruthy();\n    expect(decoded.kind).toEqual('agent');\n    expect(decoded.attributes).toEqual(t.attributes);\n  });\n});\n\ndescribe('adding grants should not overwrite existing grants', () => {\n  const EncodedTestSecret = new TextEncoder().encode(testSecret);\n\n  it('should not overwrite existing grants', async () => {\n    const t = new AccessToken(testApiKey, testSecret, {\n      identity: 'me',\n      name: 'myname',\n    });\n    t.addGrant({ roomCreate: true });\n    t.addGrant({ roomJoin: true });\n\n    const { payload }: jose.JWTVerifyResult<ClaimGrants> = await jose.jwtVerify(\n      await t.toJwt(),\n      EncodedTestSecret,\n      { issuer: testApiKey },\n    );\n    expect(payload.video?.roomCreate).toBeTruthy();\n    expect(payload.video?.roomJoin).toBeTruthy();\n  });\n});\n\ndescribe('room configuration with agents and egress', () => {\n  it('should set agents and egress in room configuration', async () => {\n    const t = new AccessToken(testApiKey, testSecret, {\n      identity: 'test-identity',\n    });\n\n    const roomConfig = new RoomConfiguration({\n      name: 'test-room',\n      maxParticipants: 10,\n    });\n\n    const agents: RoomAgentDispatch[] = [\n      new RoomAgentDispatch({\n        agentName: 'agent1',\n        metadata: 'metadata-1',\n      }),\n      new RoomAgentDispatch({\n        agentName: 'agent2',\n        metadata: 'metadata-2',\n      }),\n    ];\n\n    const egress = new RoomEgress({\n      room: new RoomCompositeEgressRequest({ roomName: 'test-room' }),\n    });\n\n    roomConfig.agents = agents;\n    roomConfig.egress = egress;\n\n    t.roomConfig = roomConfig;\n\n    const v = new TokenVerifier(testApiKey, testSecret);\n    const decoded = await v.verify(await t.toJwt());\n\n    expect(decoded.roomConfig).toBeDefined();\n    expect(decoded.roomConfig?.name).toEqual('test-room');\n    expect(decoded.roomConfig?.maxParticipants).toEqual(10);\n    expect(decoded.roomConfig?.agents).toHaveLength(2);\n    expect(decoded.roomConfig?.agents?.[0].agentName).toEqual('agent1');\n    expect(decoded.roomConfig?.agents?.[0].metadata).toEqual('metadata-1');\n    expect(decoded.roomConfig?.agents?.[1].agentName).toEqual('agent2');\n    expect(decoded.roomConfig?.agents?.[1].metadata).toEqual('metadata-2');\n    expect(decoded.roomConfig?.egress?.room?.roomName).toEqual('test-room');\n  });\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAGA,sBAKO;AACP,WAAsB;AACtB,oBAAqC;AACrC,yBAA2C;AAG3C,MAAM,aAAa;AACnB,MAAM,aAAa;AAAA,IAEnB,wBAAS,4BAA4B,MAAM;AACzC,QAAM,IAAI,IAAI,+BAAY,YAAY,YAAY;AAAA,IAChD,UAAU;AAAA,IACV,MAAM;AAAA,EACR,CAAC;AACD,IAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7B,QAAM,oBAAoB,IAAI,YAAY,EAAE,OAAO,UAAU;AAC7D,wBAAG,kBAAkB,YAAY;AAC/B,UAAM,EAAE,QAAQ,IAAI,MAAM,KAAK,UAAU,MAAM,EAAE,MAAM,GAAG,mBAAmB;AAAA,MAC3E,QAAQ;AAAA,IACV,CAAC;AAED,8BAAO,OAAO,EAAE,IAAI,KAAK,MAAS;AAAA,EACpC,CAAC;AAED,wBAAG,gBAAgB,YAAY;AAC7B,UAAM,EAAE,QAAQ,IAAI,MAAM,KAAK,UAAU,MAAM,EAAE,MAAM,GAAG,mBAAmB;AAAA,MAC3E,QAAQ;AAAA,IACV,CAAC;AAED,8BAAO,QAAQ,IAAI,EAAE,KAAK,QAAQ;AAAA,EACpC,CAAC;AAED,wBAAG,wBAAwB,YAAY;AAxCzC;AAyCI,UAAM,EAAE,QAAQ,IAAI,MAAM,KAAK,UAAU,MAAM,EAAE,MAAM,GAAG,mBAAmB;AAAA,MAC3E,QAAQ;AAAA,IACV,CAAC;AAED,8BAAO,QAAQ,KAAK,EAAE,WAAW;AACjC,+BAAQ,aAAwB,UAAxB,mBAA+B,IAAI,EAAE,QAAQ,QAAQ;AAAA,EAC/D,CAAC;AACH,CAAC;AAAA,IAED,wBAAS,6CAA6C,MAAM;AAC1D,wBAAG,oCAAoC,YAAY;AACjD,UAAM,IAAI,IAAI,+BAAY,YAAY,UAAU;AAChD,MAAE,SAAS,EAAE,YAAY,KAAK,CAAC;AAE/B,8BAAO,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW;AAAA,EACrC,CAAC;AACD,wBAAG,uDAAuD,YAAY;AACpE,UAAM,IAAI,IAAI,+BAAY,YAAY,UAAU;AAChD,MAAE,SAAS,EAAE,UAAU,KAAK,CAAC;AAE7B,cAAM,sBAAO,YAAY;AACvB,YAAM,EAAE,MAAM;AAAA,IAChB,CAAC,EAAE,QAAQ,QAAQ;AAAA,EACrB,CAAC;AACH,CAAC;AAAA,IAED,wBAAS,yBAAyB,MAAM;AACtC,wBAAG,4BAA4B,YAAY;AApE7C;AAqEI,UAAM,IAAI,IAAI,+BAAY,YAAY,UAAU;AAChD,MAAE,SAAS;AACX,MAAE,OAAO;AACT,MAAE,SAAS,EAAE,YAAY,KAAK,CAAC;AAC/B,MAAE,aAAa,EAAE,KAAK,OAAO,MAAM,MAAM;AAEzC,UAAM,IAAI,IAAI,iCAAc,YAAY,UAAU;AAClD,UAAM,UAAU,MAAM,EAAE,OAAO,MAAM,EAAE,MAAM,CAAC;AAE9C,8BAAO,OAAO,EAAE,IAAI,KAAK,MAAS;AAClC,8BAAO,QAAQ,MAAM,EAAE,QAAQ,SAAS;AACxC,+BAAO,aAAQ,UAAR,mBAAe,UAAU,EAAE,WAAW;AAC7C,8BAAO,QAAQ,IAAI,EAAE,QAAQ,OAAO;AACpC,8BAAO,QAAQ,UAAU,EAAE,QAAQ,EAAE,UAAU;AAAA,EACjD,CAAC;AACH,CAAC;AAAA,IAED,wBAAS,sDAAsD,MAAM;AACnE,QAAM,oBAAoB,IAAI,YAAY,EAAE,OAAO,UAAU;AAE7D,wBAAG,wCAAwC,YAAY;AAzFzD;AA0FI,UAAM,IAAI,IAAI,+BAAY,YAAY,YAAY;AAAA,MAChD,UAAU;AAAA,MACV,MAAM;AAAA,IACR,CAAC;AACD,MAAE,SAAS,EAAE,YAAY,KAAK,CAAC;AAC/B,MAAE,SAAS,EAAE,UAAU,KAAK,CAAC;AAE7B,UAAM,EAAE,QAAQ,IAAuC,MAAM,KAAK;AAAA,MAChE,MAAM,EAAE,MAAM;AAAA,MACd;AAAA,MACA,EAAE,QAAQ,WAAW;AAAA,IACvB;AACA,+BAAO,aAAQ,UAAR,mBAAe,UAAU,EAAE,WAAW;AAC7C,+BAAO,aAAQ,UAAR,mBAAe,QAAQ,EAAE,WAAW;AAAA,EAC7C,CAAC;AACH,CAAC;AAAA,IAED,wBAAS,6CAA6C,MAAM;AAC1D,wBAAG,sDAAsD,YAAY;AA5GvE;AA6GI,UAAM,IAAI,IAAI,+BAAY,YAAY,YAAY;AAAA,MAChD,UAAU;AAAA,IACZ,CAAC;AAED,UAAM,aAAa,IAAI,kCAAkB;AAAA,MACvC,MAAM;AAAA,MACN,iBAAiB;AAAA,IACnB,CAAC;AAED,UAAM,SAA8B;AAAA,MAClC,IAAI,kCAAkB;AAAA,QACpB,WAAW;AAAA,QACX,UAAU;AAAA,MACZ,CAAC;AAAA,MACD,IAAI,kCAAkB;AAAA,QACpB,WAAW;AAAA,QACX,UAAU;AAAA,MACZ,CAAC;AAAA,IACH;AAEA,UAAM,SAAS,IAAI,2BAAW;AAAA,MAC5B,MAAM,IAAI,2CAA2B,EAAE,UAAU,YAAY,CAAC;AAAA,IAChE,CAAC;AAED,eAAW,SAAS;AACpB,eAAW,SAAS;AAEpB,MAAE,aAAa;AAEf,UAAM,IAAI,IAAI,iCAAc,YAAY,UAAU;AAClD,UAAM,UAAU,MAAM,EAAE,OAAO,MAAM,EAAE,MAAM,CAAC;AAE9C,8BAAO,QAAQ,UAAU,EAAE,YAAY;AACvC,+BAAO,aAAQ,eAAR,mBAAoB,IAAI,EAAE,QAAQ,WAAW;AACpD,+BAAO,aAAQ,eAAR,mBAAoB,eAAe,EAAE,QAAQ,EAAE;AACtD,+BAAO,aAAQ,eAAR,mBAAoB,MAAM,EAAE,aAAa,CAAC;AACjD,+BAAO,mBAAQ,eAAR,mBAAoB,WAApB,mBAA6B,GAAG,SAAS,EAAE,QAAQ,QAAQ;AAClE,+BAAO,mBAAQ,eAAR,mBAAoB,WAApB,mBAA6B,GAAG,QAAQ,EAAE,QAAQ,YAAY;AACrE,+BAAO,mBAAQ,eAAR,mBAAoB,WAApB,mBAA6B,GAAG,SAAS,EAAE,QAAQ,QAAQ;AAClE,+BAAO,mBAAQ,eAAR,mBAAoB,WAApB,mBAA6B,GAAG,QAAQ,EAAE,QAAQ,YAAY;AACrE,+BAAO,yBAAQ,eAAR,mBAAoB,WAApB,mBAA4B,SAA5B,mBAAkC,QAAQ,EAAE,QAAQ,WAAW;AAAA,EACxE,CAAC;AACH,CAAC;","names":[]}

package/dist/AccessToken.test.js

@@ -0,0 +1,129 @@
+import {
+  RoomAgentDispatch,
+  RoomCompositeEgressRequest,
+  RoomConfiguration,
+  RoomEgress
+} from "@livekit/protocol";
+import * as jose from "jose";
+import { describe, expect, it } from "vitest";
+import { AccessToken, TokenVerifier } from "./AccessToken";
+const testApiKey = "abcdefg";
+const testSecret = "abababa";
+describe("encoded tokens are valid", () => {
+  const t = new AccessToken(testApiKey, testSecret, {
+    identity: "me",
+    name: "myname"
+  });
+  t.addGrant({ room: "myroom" });
+  const EncodedTestSecret = new TextEncoder().encode(testSecret);
+  it("can be decoded", async () => {
+    const { payload } = await jose.jwtVerify(await t.toJwt(), EncodedTestSecret, {
+      issuer: testApiKey
+    });
+    expect(payload).not.toBe(void 0);
+  });
+  it("has name set", async () => {
+    const { payload } = await jose.jwtVerify(await t.toJwt(), EncodedTestSecret, {
+      issuer: testApiKey
+    });
+    expect(payload.name).toBe("myname");
+  });
+  it("has video grants set", async () => {
+    var _a;
+    const { payload } = await jose.jwtVerify(await t.toJwt(), EncodedTestSecret, {
+      issuer: testApiKey
+    });
+    expect(payload.video).toBeTruthy();
+    expect((_a = payload.video) == null ? void 0 : _a.room).toEqual("myroom");
+  });
+});
+describe("identity is required for only join grants", () => {
+  it("allows empty identity for create", async () => {
+    const t = new AccessToken(testApiKey, testSecret);
+    t.addGrant({ roomCreate: true });
+    expect(await t.toJwt()).toBeTruthy();
+  });
+  it("throws error when identity is not provided for join", async () => {
+    const t = new AccessToken(testApiKey, testSecret);
+    t.addGrant({ roomJoin: true });
+    await expect(async () => {
+      await t.toJwt();
+    }).rejects.toThrow();
+  });
+});
+describe("verify token is valid", () => {
+  it("can decode encoded token", async () => {
+    var _a;
+    const t = new AccessToken(testApiKey, testSecret);
+    t.sha256 = "abcdefg";
+    t.kind = "agent";
+    t.addGrant({ roomCreate: true });
+    t.attributes = { foo: "bar", live: "kit" };
+    const v = new TokenVerifier(testApiKey, testSecret);
+    const decoded = await v.verify(await t.toJwt());
+    expect(decoded).not.toBe(void 0);
+    expect(decoded.sha256).toEqual("abcdefg");
+    expect((_a = decoded.video) == null ? void 0 : _a.roomCreate).toBeTruthy();
+    expect(decoded.kind).toEqual("agent");
+    expect(decoded.attributes).toEqual(t.attributes);
+  });
+});
+describe("adding grants should not overwrite existing grants", () => {
+  const EncodedTestSecret = new TextEncoder().encode(testSecret);
+  it("should not overwrite existing grants", async () => {
+    var _a, _b;
+    const t = new AccessToken(testApiKey, testSecret, {
+      identity: "me",
+      name: "myname"
+    });
+    t.addGrant({ roomCreate: true });
+    t.addGrant({ roomJoin: true });
+    const { payload } = await jose.jwtVerify(
+      await t.toJwt(),
+      EncodedTestSecret,
+      { issuer: testApiKey }
+    );
+    expect((_a = payload.video) == null ? void 0 : _a.roomCreate).toBeTruthy();
+    expect((_b = payload.video) == null ? void 0 : _b.roomJoin).toBeTruthy();
+  });
+});
+describe("room configuration with agents and egress", () => {
+  it("should set agents and egress in room configuration", async () => {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n;
+    const t = new AccessToken(testApiKey, testSecret, {
+      identity: "test-identity"
+    });
+    const roomConfig = new RoomConfiguration({
+      name: "test-room",
+      maxParticipants: 10
+    });
+    const agents = [
+      new RoomAgentDispatch({
+        agentName: "agent1",
+        metadata: "metadata-1"
+      }),
+      new RoomAgentDispatch({
+        agentName: "agent2",
+        metadata: "metadata-2"
+      })
+    ];
+    const egress = new RoomEgress({
+      room: new RoomCompositeEgressRequest({ roomName: "test-room" })
+    });
+    roomConfig.agents = agents;
+    roomConfig.egress = egress;
+    t.roomConfig = roomConfig;
+    const v = new TokenVerifier(testApiKey, testSecret);
+    const decoded = await v.verify(await t.toJwt());
+    expect(decoded.roomConfig).toBeDefined();
+    expect((_a = decoded.roomConfig) == null ? void 0 : _a.name).toEqual("test-room");
+    expect((_b = decoded.roomConfig) == null ? void 0 : _b.maxParticipants).toEqual(10);
+    expect((_c = decoded.roomConfig) == null ? void 0 : _c.agents).toHaveLength(2);
+    expect((_e = (_d = decoded.roomConfig) == null ? void 0 : _d.agents) == null ? void 0 : _e[0].agentName).toEqual("agent1");
+    expect((_g = (_f = decoded.roomConfig) == null ? void 0 : _f.agents) == null ? void 0 : _g[0].metadata).toEqual("metadata-1");
+    expect((_i = (_h = decoded.roomConfig) == null ? void 0 : _h.agents) == null ? void 0 : _i[1].agentName).toEqual("agent2");
+    expect((_k = (_j = decoded.roomConfig) == null ? void 0 : _j.agents) == null ? void 0 : _k[1].metadata).toEqual("metadata-2");
+    expect((_n = (_m = (_l = decoded.roomConfig) == null ? void 0 : _l.egress) == null ? void 0 : _m.room) == null ? void 0 : _n.roomName).toEqual("test-room");
+  });
+});
+//# sourceMappingURL=AccessToken.test.js.map

package/dist/AccessToken.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/AccessToken.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport {\n  RoomAgentDispatch,\n  RoomCompositeEgressRequest,\n  RoomConfiguration,\n  RoomEgress,\n} from '@livekit/protocol';\nimport * as jose from 'jose';\nimport { describe, expect, it } from 'vitest';\nimport { AccessToken, TokenVerifier } from './AccessToken';\nimport type { ClaimGrants } from './grants';\n\nconst testApiKey = 'abcdefg';\nconst testSecret = 'abababa';\n\ndescribe('encoded tokens are valid', () => {\n  const t = new AccessToken(testApiKey, testSecret, {\n    identity: 'me',\n    name: 'myname',\n  });\n  t.addGrant({ room: 'myroom' });\n  const EncodedTestSecret = new TextEncoder().encode(testSecret);\n  it('can be decoded', async () => {\n    const { payload } = await jose.jwtVerify(await t.toJwt(), EncodedTestSecret, {\n      issuer: testApiKey,\n    });\n\n    expect(payload).not.toBe(undefined);\n  });\n\n  it('has name set', async () => {\n    const { payload } = await jose.jwtVerify(await t.toJwt(), EncodedTestSecret, {\n      issuer: testApiKey,\n    });\n\n    expect(payload.name).toBe('myname');\n  });\n\n  it('has video grants set', async () => {\n    const { payload } = await jose.jwtVerify(await t.toJwt(), EncodedTestSecret, {\n      issuer: testApiKey,\n    });\n\n    expect(payload.video).toBeTruthy();\n    expect((payload as ClaimGrants).video?.room).toEqual('myroom');\n  });\n});\n\ndescribe('identity is required for only join grants', () => {\n  it('allows empty identity for create', async () => {\n    const t = new AccessToken(testApiKey, testSecret);\n    t.addGrant({ roomCreate: true });\n\n    expect(await t.toJwt()).toBeTruthy();\n  });\n  it('throws error when identity is not provided for join', async () => {\n    const t = new AccessToken(testApiKey, testSecret);\n    t.addGrant({ roomJoin: true });\n\n    await expect(async () => {\n      await t.toJwt();\n    }).rejects.toThrow();\n  });\n});\n\ndescribe('verify token is valid', () => {\n  it('can decode encoded token', async () => {\n    const t = new AccessToken(testApiKey, testSecret);\n    t.sha256 = 'abcdefg';\n    t.kind = 'agent';\n    t.addGrant({ roomCreate: true });\n    t.attributes = { foo: 'bar', live: 'kit' };\n\n    const v = new TokenVerifier(testApiKey, testSecret);\n    const decoded = await v.verify(await t.toJwt());\n\n    expect(decoded).not.toBe(undefined);\n    expect(decoded.sha256).toEqual('abcdefg');\n    expect(decoded.video?.roomCreate).toBeTruthy();\n    expect(decoded.kind).toEqual('agent');\n    expect(decoded.attributes).toEqual(t.attributes);\n  });\n});\n\ndescribe('adding grants should not overwrite existing grants', () => {\n  const EncodedTestSecret = new TextEncoder().encode(testSecret);\n\n  it('should not overwrite existing grants', async () => {\n    const t = new AccessToken(testApiKey, testSecret, {\n      identity: 'me',\n      name: 'myname',\n    });\n    t.addGrant({ roomCreate: true });\n    t.addGrant({ roomJoin: true });\n\n    const { payload }: jose.JWTVerifyResult<ClaimGrants> = await jose.jwtVerify(\n      await t.toJwt(),\n      EncodedTestSecret,\n      { issuer: testApiKey },\n    );\n    expect(payload.video?.roomCreate).toBeTruthy();\n    expect(payload.video?.roomJoin).toBeTruthy();\n  });\n});\n\ndescribe('room configuration with agents and egress', () => {\n  it('should set agents and egress in room configuration', async () => {\n    const t = new AccessToken(testApiKey, testSecret, {\n      identity: 'test-identity',\n    });\n\n    const roomConfig = new RoomConfiguration({\n      name: 'test-room',\n      maxParticipants: 10,\n    });\n\n    const agents: RoomAgentDispatch[] = [\n      new RoomAgentDispatch({\n        agentName: 'agent1',\n        metadata: 'metadata-1',\n      }),\n      new RoomAgentDispatch({\n        agentName: 'agent2',\n        metadata: 'metadata-2',\n      }),\n    ];\n\n    const egress = new RoomEgress({\n      room: new RoomCompositeEgressRequest({ roomName: 'test-room' }),\n    });\n\n    roomConfig.agents = agents;\n    roomConfig.egress = egress;\n\n    t.roomConfig = roomConfig;\n\n    const v = new TokenVerifier(testApiKey, testSecret);\n    const decoded = await v.verify(await t.toJwt());\n\n    expect(decoded.roomConfig).toBeDefined();\n    expect(decoded.roomConfig?.name).toEqual('test-room');\n    expect(decoded.roomConfig?.maxParticipants).toEqual(10);\n    expect(decoded.roomConfig?.agents).toHaveLength(2);\n    expect(decoded.roomConfig?.agents?.[0].agentName).toEqual('agent1');\n    expect(decoded.roomConfig?.agents?.[0].metadata).toEqual('metadata-1');\n    expect(decoded.roomConfig?.agents?.[1].agentName).toEqual('agent2');\n    expect(decoded.roomConfig?.agents?.[1].metadata).toEqual('metadata-2');\n    expect(decoded.roomConfig?.egress?.room?.roomName).toEqual('test-room');\n  });\n});\n"],"mappings":"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","names":[]}

package/dist/AgentDispatchClient.cjs

@@ -0,0 +1,133 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var AgentDispatchClient_exports = {};
+__export(AgentDispatchClient_exports, {
+  AgentDispatchClient: () => AgentDispatchClient
+});
+module.exports = __toCommonJS(AgentDispatchClient_exports);
+var import_protocol = require("@livekit/protocol");
+var import_ServiceBase = __toESM(require("./ServiceBase.cjs"), 1);
+var import_TwirpRPC = require("./TwirpRPC.cjs");
+const svc = "AgentDispatchService";
+class AgentDispatchClient extends import_ServiceBase.default {
+  /**
+   * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'
+   * @param apiKey - API Key, can be set in env var LIVEKIT_API_KEY
+   * @param secret - API Secret, can be set in env var LIVEKIT_API_SECRET
+   */
+  constructor(host, apiKey, secret) {
+    super(apiKey, secret);
+    this.rpc = new import_TwirpRPC.TwirpRpc(host, import_TwirpRPC.livekitPackage);
+  }
+  /**
+   * Create an explicit dispatch for an agent to join a room. To use explicit
+   * dispatch, your agent must be registered with an `agentName`.
+   * @param roomName - name of the room to dispatch to
+   * @param agentName - name of the agent to dispatch
+   * @param options - optional metadata to send along with the dispatch
+   * @returns the dispatch that was created
+   */
+  async createDispatch(roomName, agentName, options) {
+    const req = new import_protocol.CreateAgentDispatchRequest({
+      room: roomName,
+      agentName,
+      metadata: options == null ? void 0 : options.metadata
+    }).toJson();
+    const data = await this.rpc.request(
+      svc,
+      "CreateDispatch",
+      req,
+      await this.authHeader({ roomAdmin: true, room: roomName })
+    );
+    return import_protocol.AgentDispatch.fromJson(data, { ignoreUnknownFields: true });
+  }
+  /**
+   * Delete an explicit dispatch for an agent in a room.
+   * @param dispatchId - id of the dispatch to delete
+   * @param roomName - name of the room the dispatch is for
+   */
+  async deleteDispatch(dispatchId, roomName) {
+    const req = new import_protocol.DeleteAgentDispatchRequest({
+      dispatchId,
+      room: roomName
+    }).toJson();
+    await this.rpc.request(
+      svc,
+      "DeleteDispatch",
+      req,
+      await this.authHeader({ roomAdmin: true, room: roomName })
+    );
+  }
+  /**
+   * Get an Agent dispatch by ID
+   * @param dispatchId - id of the dispatch to get
+   * @param roomName - name of the room the dispatch is for
+   * @returns the dispatch that was found, or undefined if not found
+   */
+  async getDispatch(dispatchId, roomName) {
+    const req = new import_protocol.ListAgentDispatchRequest({
+      dispatchId,
+      room: roomName
+    }).toJson();
+    const data = await this.rpc.request(
+      svc,
+      "ListDispatch",
+      req,
+      await this.authHeader({ roomAdmin: true, room: roomName })
+    );
+    const res = import_protocol.ListAgentDispatchResponse.fromJson(data, { ignoreUnknownFields: true });
+    if (res.agentDispatches.length === 0) {
+      return void 0;
+    }
+    return res.agentDispatches[0];
+  }
+  /**
+   * List all agent dispatches for a room
+   * @param roomName - name of the room to list dispatches for
+   * @returns the list of dispatches
+   */
+  async listDispatch(roomName) {
+    const req = new import_protocol.ListAgentDispatchRequest({
+      room: roomName
+    }).toJson();
+    const data = await this.rpc.request(
+      svc,
+      "ListDispatch",
+      req,
+      await this.authHeader({ roomAdmin: true, room: roomName })
+    );
+    const res = import_protocol.ListAgentDispatchResponse.fromJson(data, { ignoreUnknownFields: true });
+    return res.agentDispatches;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentDispatchClient
+});
+//# sourceMappingURL=AgentDispatchClient.cjs.map

package/dist/AgentDispatchClient.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/AgentDispatchClient.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport {\n  AgentDispatch,\n  CreateAgentDispatchRequest,\n  DeleteAgentDispatchRequest,\n  ListAgentDispatchRequest,\n  ListAgentDispatchResponse,\n} from '@livekit/protocol';\nimport ServiceBase from './ServiceBase.js';\nimport { type Rpc, TwirpRpc, livekitPackage } from './TwirpRPC.js';\n\ninterface CreateDispatchOptions {\n  // any custom data to send along with the job.\n  // note: this is different from room and participant metadata\n  metadata?: string;\n}\n\nconst svc = 'AgentDispatchService';\n\n/**\n * Client to access Agent APIs\n */\nexport class AgentDispatchClient extends ServiceBase {\n  private readonly rpc: Rpc;\n\n  /**\n   * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'\n   * @param apiKey - API Key, can be set in env var LIVEKIT_API_KEY\n   * @param secret - API Secret, can be set in env var LIVEKIT_API_SECRET\n   */\n  constructor(host: string, apiKey?: string, secret?: string) {\n    super(apiKey, secret);\n    this.rpc = new TwirpRpc(host, livekitPackage);\n  }\n\n  /**\n   * Create an explicit dispatch for an agent to join a room. To use explicit\n   * dispatch, your agent must be registered with an `agentName`.\n   * @param roomName - name of the room to dispatch to\n   * @param agentName - name of the agent to dispatch\n   * @param options - optional metadata to send along with the dispatch\n   * @returns the dispatch that was created\n   */\n  async createDispatch(\n    roomName: string,\n    agentName: string,\n    options?: CreateDispatchOptions,\n  ): Promise<AgentDispatch> {\n    const req = new CreateAgentDispatchRequest({\n      room: roomName,\n      agentName,\n      metadata: options?.metadata,\n    }).toJson();\n    const data = await this.rpc.request(\n      svc,\n      'CreateDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n    return AgentDispatch.fromJson(data, { ignoreUnknownFields: true });\n  }\n\n  /**\n   * Delete an explicit dispatch for an agent in a room.\n   * @param dispatchId - id of the dispatch to delete\n   * @param roomName - name of the room the dispatch is for\n   */\n  async deleteDispatch(dispatchId: string, roomName: string): Promise<void> {\n    const req = new DeleteAgentDispatchRequest({\n      dispatchId,\n      room: roomName,\n    }).toJson();\n    await this.rpc.request(\n      svc,\n      'DeleteDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n  }\n\n  /**\n   * Get an Agent dispatch by ID\n   * @param dispatchId - id of the dispatch to get\n   * @param roomName - name of the room the dispatch is for\n   * @returns the dispatch that was found, or undefined if not found\n   */\n  async getDispatch(dispatchId: string, roomName: string): Promise<AgentDispatch | undefined> {\n    const req = new ListAgentDispatchRequest({\n      dispatchId,\n      room: roomName,\n    }).toJson();\n    const data = await this.rpc.request(\n      svc,\n      'ListDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n    const res = ListAgentDispatchResponse.fromJson(data, { ignoreUnknownFields: true });\n    if (res.agentDispatches.length === 0) {\n      return undefined;\n    }\n    return res.agentDispatches[0];\n  }\n\n  /**\n   * List all agent dispatches for a room\n   * @param roomName - name of the room to list dispatches for\n   * @returns the list of dispatches\n   */\n  async listDispatch(roomName: string): Promise<AgentDispatch[]> {\n    const req = new ListAgentDispatchRequest({\n      room: roomName,\n    }).toJson();\n    const data = await this.rpc.request(\n      svc,\n      'ListDispatch',\n      req,\n      await this.authHeader({ roomAdmin: true, room: roomName }),\n    );\n    const res = ListAgentDispatchResponse.fromJson(data, { ignoreUnknownFields: true });\n    return res.agentDispatches;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,sBAMO;AACP,yBAAwB;AACxB,sBAAmD;AAQnD,MAAM,MAAM;AAKL,MAAM,4BAA4B,mBAAAA,QAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQnD,YAAY,MAAc,QAAiB,QAAiB;AAC1D,UAAM,QAAQ,MAAM;AACpB,SAAK,MAAM,IAAI,yBAAS,MAAM,8BAAc;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,eACJ,UACA,WACA,SACwB;AACxB,UAAM,MAAM,IAAI,2CAA2B;AAAA,MACzC,MAAM;AAAA,MACN;AAAA,MACA,UAAU,mCAAS;AAAA,IACrB,CAAC,EAAE,OAAO;AACV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AACA,WAAO,8BAAc,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAAA,EACnE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,eAAe,YAAoB,UAAiC;AACxE,UAAM,MAAM,IAAI,2CAA2B;AAAA,MACzC;AAAA,MACA,MAAM;AAAA,IACR,CAAC,EAAE,OAAO;AACV,UAAM,KAAK,IAAI;AAAA,MACb;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,YAAY,YAAoB,UAAsD;AAC1F,UAAM,MAAM,IAAI,yCAAyB;AAAA,MACvC;AAAA,MACA,MAAM;AAAA,IACR,CAAC,EAAE,OAAO;AACV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AACA,UAAM,MAAM,0CAA0B,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAClF,QAAI,IAAI,gBAAgB,WAAW,GAAG;AACpC,aAAO;AAAA,IACT;AACA,WAAO,IAAI,gBAAgB,CAAC;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,aAAa,UAA4C;AAC7D,UAAM,MAAM,IAAI,yCAAyB;AAAA,MACvC,MAAM;AAAA,IACR,CAAC,EAAE,OAAO;AACV,UAAM,OAAO,MAAM,KAAK,IAAI;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,KAAK,WAAW,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AAAA,IAC3D;AACA,UAAM,MAAM,0CAA0B,SAAS,MAAM,EAAE,qBAAqB,KAAK,CAAC;AAClF,WAAO,IAAI;AAAA,EACb;AACF;","names":["ServiceBase"]}

package/dist/AgentDispatchClient.js

@@ -1,82 +1,105 @@
-// SPDX-FileCopyrightText: 2024 LiveKit, Inc.
-//
-// SPDX-License-Identifier: Apache-2.0
-import { AgentDispatch, CreateAgentDispatchRequest, DeleteAgentDispatchRequest, ListAgentDispatchRequest, ListAgentDispatchResponse, } from '@livekit/protocol';
-import ServiceBase from './ServiceBase.js';
-import { TwirpRpc, livekitPackage } from './TwirpRPC.js';
-const svc = 'AgentDispatchService';
-/**
- * Client to access Agent APIs
- */
-export class AgentDispatchClient extends ServiceBase {
-    /**
-     * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'
-     * @param apiKey - API Key, can be set in env var LIVEKIT_API_KEY
-     * @param secret - API Secret, can be set in env var LIVEKIT_API_SECRET
-     */
-    constructor(host, apiKey, secret) {
-        super(apiKey, secret);
-        this.rpc = new TwirpRpc(host, livekitPackage);
-    }
-    /**
-     * Create an explicit dispatch for an agent to join a room. To use explicit
-     * dispatch, your agent must be registered with an `agentName`.
-     * @param roomName - name of the room to dispatch to
-     * @param agentName - name of the agent to dispatch
-     * @param options - optional metadata to send along with the dispatch
-     * @returns the dispatch that was created
-     */
-    async createDispatch(roomName, agentName, options) {
-        const req = new CreateAgentDispatchRequest({
-            room: roomName,
-            agentName,
-            metadata: options === null || options === void 0 ? void 0 : options.metadata,
-        }).toJson();
-        const data = await this.rpc.request(svc, 'CreateDispatch', req, await this.authHeader({ roomAdmin: true, room: roomName }));
-        return AgentDispatch.fromJson(data, { ignoreUnknownFields: true });
-    }
-    /**
-     * Delete an explicit dispatch for an agent in a room.
-     * @param dispatchId - id of the dispatch to delete
-     * @param roomName - name of the room the dispatch is for
-     */
-    async deleteDispatch(dispatchId, roomName) {
-        const req = new DeleteAgentDispatchRequest({
-            dispatchId,
-            room: roomName,
-        }).toJson();
-        await this.rpc.request(svc, 'DeleteDispatch', req, await this.authHeader({ roomAdmin: true, room: roomName }));
-    }
-    /**
-     * Get an Agent dispatch by ID
-     * @param dispatchId - id of the dispatch to get
-     * @param roomName - name of the room the dispatch is for
-     * @returns the dispatch that was found, or undefined if not found
-     */
-    async getDispatch(dispatchId, roomName) {
-        const req = new ListAgentDispatchRequest({
-            dispatchId,
-            room: roomName,
-        }).toJson();
-        const data = await this.rpc.request(svc, 'ListDispatch', req, await this.authHeader({ roomAdmin: true, room: roomName }));
-        const res = ListAgentDispatchResponse.fromJson(data, { ignoreUnknownFields: true });
-        if (res.agentDispatches.length === 0) {
-            return undefined;
-        }
-        return res.agentDispatches[0];
-    }
-    /**
-     * List all agent dispatches for a room
-     * @param roomName - name of the room to list dispatches for
-     * @returns the list of dispatches
-     */
-    async listDispatch(roomName) {
-        const req = new ListAgentDispatchRequest({
-            room: roomName,
-        }).toJson();
-        const data = await this.rpc.request(svc, 'ListDispatch', req, await this.authHeader({ roomAdmin: true, room: roomName }));
-        const res = ListAgentDispatchResponse.fromJson(data, { ignoreUnknownFields: true });
-        return res.agentDispatches;
+import {
+  AgentDispatch,
+  CreateAgentDispatchRequest,
+  DeleteAgentDispatchRequest,
+  ListAgentDispatchRequest,
+  ListAgentDispatchResponse
+} from "@livekit/protocol";
+import ServiceBase from "./ServiceBase.js";
+import { TwirpRpc, livekitPackage } from "./TwirpRPC.js";
+const svc = "AgentDispatchService";
+class AgentDispatchClient extends ServiceBase {
+  /**
+   * @param host - hostname including protocol. i.e. 'https://<project>.livekit.cloud'
+   * @param apiKey - API Key, can be set in env var LIVEKIT_API_KEY
+   * @param secret - API Secret, can be set in env var LIVEKIT_API_SECRET
+   */
+  constructor(host, apiKey, secret) {
+    super(apiKey, secret);
+    this.rpc = new TwirpRpc(host, livekitPackage);
+  }
+  /**
+   * Create an explicit dispatch for an agent to join a room. To use explicit
+   * dispatch, your agent must be registered with an `agentName`.
+   * @param roomName - name of the room to dispatch to
+   * @param agentName - name of the agent to dispatch
+   * @param options - optional metadata to send along with the dispatch
+   * @returns the dispatch that was created
+   */
+  async createDispatch(roomName, agentName, options) {
+    const req = new CreateAgentDispatchRequest({
+      room: roomName,
+      agentName,
+      metadata: options == null ? void 0 : options.metadata
+    }).toJson();
+    const data = await this.rpc.request(
+      svc,
+      "CreateDispatch",
+      req,
+      await this.authHeader({ roomAdmin: true, room: roomName })
+    );
+    return AgentDispatch.fromJson(data, { ignoreUnknownFields: true });
+  }
+  /**
+   * Delete an explicit dispatch for an agent in a room.
+   * @param dispatchId - id of the dispatch to delete
+   * @param roomName - name of the room the dispatch is for
+   */
+  async deleteDispatch(dispatchId, roomName) {
+    const req = new DeleteAgentDispatchRequest({
+      dispatchId,
+      room: roomName
+    }).toJson();
+    await this.rpc.request(
+      svc,
+      "DeleteDispatch",
+      req,
+      await this.authHeader({ roomAdmin: true, room: roomName })
+    );
+  }
+  /**
+   * Get an Agent dispatch by ID
+   * @param dispatchId - id of the dispatch to get
+   * @param roomName - name of the room the dispatch is for
+   * @returns the dispatch that was found, or undefined if not found
+   */
+  async getDispatch(dispatchId, roomName) {
+    const req = new ListAgentDispatchRequest({
+      dispatchId,
+      room: roomName
+    }).toJson();
+    const data = await this.rpc.request(
+      svc,
+      "ListDispatch",
+      req,
+      await this.authHeader({ roomAdmin: true, room: roomName })
+    );
+    const res = ListAgentDispatchResponse.fromJson(data, { ignoreUnknownFields: true });
+    if (res.agentDispatches.length === 0) {
+      return void 0;
     }
+    return res.agentDispatches[0];
+  }
+  /**
+   * List all agent dispatches for a room
+   * @param roomName - name of the room to list dispatches for
+   * @returns the list of dispatches
+   */
+  async listDispatch(roomName) {
+    const req = new ListAgentDispatchRequest({
+      room: roomName
+    }).toJson();
+    const data = await this.rpc.request(
+      svc,
+      "ListDispatch",
+      req,
+      await this.authHeader({ roomAdmin: true, room: roomName })
+    );
+    const res = ListAgentDispatchResponse.fromJson(data, { ignoreUnknownFields: true });
+    return res.agentDispatches;
+  }
 }
+export {
+  AgentDispatchClient
+};
 //# sourceMappingURL=AgentDispatchClient.js.map