@livekit/agents 1.1.0 → 1.2.0

package/dist/connection_pool.test.js

@@ -0,0 +1,255 @@
+import { describe, expect, it, vi } from "vitest";
+import { ConnectionPool } from "./connection_pool.js";
+describe("ConnectionPool", () => {
+  const makeConnectCb = () => {
+    let n = 0;
+    return vi.fn(async (_timeout) => `conn_${++n}`);
+  };
+  describe("basic operations", () => {
+    it("should create and return a connection", async () => {
+      const connections = [];
+      const connectCb = vi.fn(async (_timeout) => {
+        const conn3 = `conn_${connections.length}`;
+        connections.push(conn3);
+        return conn3;
+      });
+      const closeCb = vi.fn(async (_conn) => {
+      });
+      const pool = new ConnectionPool({
+        connectCb,
+        closeCb
+      });
+      const conn = await pool.get();
+      expect(conn).toBe("conn_0");
+      expect(connectCb).toHaveBeenCalledTimes(1);
+      pool.put(conn);
+      const conn2 = await pool.get();
+      expect(conn2).toBe("conn_0");
+      expect(connectCb).toHaveBeenCalledTimes(1);
+    });
+    it("should create new connection when none available", async () => {
+      const connectCb = makeConnectCb();
+      const closeCb = vi.fn(async (_conn) => {
+      });
+      const pool = new ConnectionPool({
+        connectCb,
+        closeCb
+      });
+      const conn1 = await pool.get();
+      pool.put(conn1);
+      const conn2 = await pool.get();
+      expect(conn1).toBe(conn2);
+      expect(connectCb).toHaveBeenCalledTimes(1);
+    });
+    it("should remove connection from pool", async () => {
+      const connectCb = makeConnectCb();
+      const closeCb = vi.fn(async (_conn) => {
+      });
+      const pool = new ConnectionPool({
+        connectCb,
+        closeCb
+      });
+      const conn = await pool.get();
+      pool.put(conn);
+      pool.remove(conn);
+      const conn2 = await pool.get();
+      expect(conn2).not.toBe(conn);
+      expect(connectCb).toHaveBeenCalledTimes(2);
+      expect(closeCb).toHaveBeenCalledTimes(1);
+    });
+  });
+  describe("maxSessionDuration", () => {
+    it("should expire connections after maxSessionDuration", async () => {
+      const connectCb = makeConnectCb();
+      const closeCb = vi.fn(async (_conn) => {
+      });
+      const pool = new ConnectionPool({
+        connectCb,
+        closeCb,
+        maxSessionDuration: 100
+        // 100ms
+      });
+      const conn1 = await pool.get();
+      pool.put(conn1);
+      await new Promise((resolve) => setTimeout(resolve, 150));
+      const conn2 = await pool.get();
+      expect(conn2).not.toBe(conn1);
+      expect(connectCb).toHaveBeenCalledTimes(2);
+      expect(closeCb).toHaveBeenCalledTimes(1);
+    });
+    it("should refresh connection timestamp when markRefreshedOnGet is true", async () => {
+      const connectCb = makeConnectCb();
+      const closeCb = vi.fn(async (_conn) => {
+      });
+      const pool = new ConnectionPool({
+        connectCb,
+        closeCb,
+        maxSessionDuration: 200,
+        // 200ms
+        markRefreshedOnGet: true
+      });
+      const conn1 = await pool.get();
+      pool.put(conn1);
+      await new Promise((resolve) => setTimeout(resolve, 100));
+      const conn2 = await pool.get();
+      expect(conn2).toBe(conn1);
+      pool.put(conn2);
+      await new Promise((resolve) => setTimeout(resolve, 100));
+      const conn3 = await pool.get();
+      expect(conn3).toBe(conn1);
+      expect(connectCb).toHaveBeenCalledTimes(1);
+    });
+  });
+  describe("withConnection", () => {
+    it("should return connection to pool on success", async () => {
+      const connectCb = makeConnectCb();
+      const closeCb = vi.fn(async (_conn) => {
+      });
+      const pool = new ConnectionPool({
+        connectCb,
+        closeCb
+      });
+      let capturedConn;
+      await pool.withConnection(async (conn) => {
+        capturedConn = conn;
+        return "result";
+      });
+      const conn2 = await pool.get();
+      expect(conn2).toBe(capturedConn);
+      expect(connectCb).toHaveBeenCalledTimes(1);
+    });
+    it("should remove connection from pool on error", async () => {
+      const connectCb = makeConnectCb();
+      const closeCb = vi.fn(async (_conn) => {
+      });
+      const pool = new ConnectionPool({
+        connectCb,
+        closeCb
+      });
+      let capturedConn;
+      try {
+        await pool.withConnection(async (conn) => {
+          capturedConn = conn;
+          throw new Error("test error");
+        });
+      } catch (e) {
+      }
+      const conn2 = await pool.get();
+      expect(conn2).not.toBe(capturedConn);
+      expect(connectCb).toHaveBeenCalledTimes(2);
+      expect(closeCb).toHaveBeenCalledTimes(1);
+    });
+    it("should handle abort signal", async () => {
+      const connectCb = makeConnectCb();
+      const closeCb = vi.fn(async (_conn) => {
+      });
+      const pool = new ConnectionPool({
+        connectCb,
+        closeCb
+      });
+      const abortController = new AbortController();
+      let capturedConn;
+      const promise = pool.withConnection(
+        async (conn) => {
+          capturedConn = conn;
+          await new Promise((resolve) => setTimeout(resolve, 1e3));
+          return "result";
+        },
+        { signal: abortController.signal }
+      );
+      setTimeout(() => abortController.abort(), 10);
+      await expect(promise).rejects.toThrow();
+      const conn2 = await pool.get();
+      expect(conn2).not.toBe(capturedConn);
+      expect(closeCb).toHaveBeenCalledTimes(1);
+    });
+  });
+  describe("prewarm", () => {
+    it("should create connection in background", async () => {
+      let n = 0;
+      const connectCb = vi.fn(async (_timeout) => {
+        await new Promise((resolve) => setTimeout(resolve, 50));
+        return `conn_${++n}`;
+      });
+      const closeCb = vi.fn(async (_conn) => {
+      });
+      const pool = new ConnectionPool({
+        connectCb,
+        closeCb
+      });
+      pool.prewarm();
+      await new Promise((resolve) => setTimeout(resolve, 100));
+      const conn = await pool.get();
+      expect(conn).toBeDefined();
+      expect(connectCb).toHaveBeenCalledTimes(1);
+    });
+    it("should not prewarm if connections already exist", async () => {
+      const connectCb = makeConnectCb();
+      const closeCb = vi.fn(async (_conn) => {
+      });
+      const pool = new ConnectionPool({
+        connectCb,
+        closeCb
+      });
+      const conn1 = await pool.get();
+      pool.put(conn1);
+      pool.prewarm();
+      const conn2 = await pool.get();
+      expect(conn2).toBe(conn1);
+      expect(connectCb).toHaveBeenCalledTimes(1);
+    });
+  });
+  describe("close", () => {
+    it("should close all connections", async () => {
+      const connectCb = makeConnectCb();
+      const closeCb = vi.fn(async (_conn) => {
+      });
+      const pool = new ConnectionPool({
+        connectCb,
+        closeCb
+      });
+      const conn1 = await pool.get();
+      const conn2 = await pool.get();
+      pool.put(conn1);
+      pool.put(conn2);
+      await pool.close();
+      expect(closeCb).toHaveBeenCalledTimes(2);
+    });
+    it("should invalidate all connections", async () => {
+      const connectCb = makeConnectCb();
+      const closeCb = vi.fn(async (_conn) => {
+      });
+      const pool = new ConnectionPool({
+        connectCb,
+        closeCb
+      });
+      const conn1 = await pool.get();
+      const conn2 = await pool.get();
+      pool.put(conn1);
+      pool.put(conn2);
+      pool.invalidate();
+      await pool.close();
+      expect(closeCb).toHaveBeenCalledTimes(2);
+    });
+  });
+  describe("concurrent access", () => {
+    it("should handle concurrent get requests", async () => {
+      const connectCb = vi.fn(async (_timeout) => {
+        await new Promise((resolve) => setTimeout(resolve, 10));
+        return `conn_${Date.now()}_${Math.random()}`;
+      });
+      const closeCb = vi.fn(async (_conn) => {
+      });
+      const pool = new ConnectionPool({
+        connectCb,
+        closeCb
+      });
+      const promises = Array.from({ length: 5 }, () => pool.get());
+      const connections = await Promise.all(promises);
+      const uniqueConnections = new Set(connections);
+      expect(uniqueConnections.size).toBe(5);
+      expect(connectCb).toHaveBeenCalledTimes(5);
+    });
+  });
+});
+//# sourceMappingURL=connection_pool.test.js.map

package/dist/connection_pool.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/connection_pool.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { describe, expect, it, vi } from 'vitest';\nimport { ConnectionPool } from './connection_pool.js';\n\ndescribe('ConnectionPool', () => {\n  const makeConnectCb = () => {\n    let n = 0;\n    return vi.fn(async (_timeout: number): Promise<string> => `conn_${++n}`);\n  };\n\n  describe('basic operations', () => {\n    it('should create and return a connection', async () => {\n      const connections: string[] = [];\n      const connectCb = vi.fn(async (_timeout: number): Promise<string> => {\n        const conn = `conn_${connections.length}`;\n        connections.push(conn);\n        return conn;\n      });\n      const closeCb = vi.fn(async (_conn: string) => {\n        // Mock close\n      });\n\n      const pool = new ConnectionPool<string>({\n        connectCb,\n        closeCb,\n      });\n\n      const conn = await pool.get();\n      expect(conn).toBe('conn_0');\n      expect(connectCb).toHaveBeenCalledTimes(1);\n\n      pool.put(conn);\n      const conn2 = await pool.get();\n      expect(conn2).toBe('conn_0'); // Should reuse\n      expect(connectCb).toHaveBeenCalledTimes(1);\n    });\n\n    it('should create new connection when none available', async () => {\n      const connectCb = makeConnectCb();\n      const closeCb = vi.fn(async (_conn: string) => {\n        // Mock close\n      });\n\n      const pool = new ConnectionPool<string>({\n        connectCb,\n        closeCb,\n      });\n\n      const conn1 = await pool.get();\n      pool.put(conn1);\n      const conn2 = await pool.get();\n      expect(conn1).toBe(conn2); // Should reuse\n      expect(connectCb).toHaveBeenCalledTimes(1);\n    });\n\n    it('should remove connection from pool', async () => {\n      const connectCb = makeConnectCb();\n      const closeCb = vi.fn(async (_conn: string) => {\n        // Mock close\n      });\n\n      const pool = new ConnectionPool<string>({\n        connectCb,\n        closeCb,\n      });\n\n      const conn = await pool.get();\n      pool.put(conn);\n      pool.remove(conn);\n\n      const conn2 = await pool.get();\n      expect(conn2).not.toBe(conn); // Should create new connection\n      expect(connectCb).toHaveBeenCalledTimes(2);\n      expect(closeCb).toHaveBeenCalledTimes(1);\n    });\n  });\n\n  describe('maxSessionDuration', () => {\n    it('should expire connections after maxSessionDuration', async () => {\n      const connectCb = makeConnectCb();\n      const closeCb = vi.fn(async (_conn: string) => {\n        // Mock close\n      });\n\n      const pool = new ConnectionPool<string>({\n        connectCb,\n        closeCb,\n        maxSessionDuration: 100, // 100ms\n      });\n\n      const conn1 = await pool.get();\n      pool.put(conn1);\n\n      // Wait for expiration\n      await new Promise((resolve) => setTimeout(resolve, 150));\n\n      const conn2 = await pool.get();\n      expect(conn2).not.toBe(conn1); // Should create new connection\n      expect(connectCb).toHaveBeenCalledTimes(2);\n      expect(closeCb).toHaveBeenCalledTimes(1);\n    });\n\n    it('should refresh connection timestamp when markRefreshedOnGet is true', async () => {\n      const connectCb = makeConnectCb();\n      const closeCb = vi.fn(async (_conn: string) => {\n        // Mock close\n      });\n\n      const pool = new ConnectionPool<string>({\n        connectCb,\n        closeCb,\n        maxSessionDuration: 200, // 200ms\n        markRefreshedOnGet: true,\n      });\n\n      const conn1 = await pool.get();\n      pool.put(conn1);\n\n      // Wait 100ms (less than expiration)\n      await new Promise((resolve) => setTimeout(resolve, 100));\n\n      // Get again - should refresh timestamp\n      const conn2 = await pool.get();\n      expect(conn2).toBe(conn1); // Should reuse\n      pool.put(conn2);\n\n      // Wait another 100ms (total 200ms, but refreshed at 100ms)\n      await new Promise((resolve) => setTimeout(resolve, 100));\n\n      // Should still be valid\n      const conn3 = await pool.get();\n      expect(conn3).toBe(conn1); // Should still reuse\n      expect(connectCb).toHaveBeenCalledTimes(1);\n    });\n  });\n\n  describe('withConnection', () => {\n    it('should return connection to pool on success', async () => {\n      const connectCb = makeConnectCb();\n      const closeCb = vi.fn(async (_conn: string) => {\n        // Mock close\n      });\n\n      const pool = new ConnectionPool<string>({\n        connectCb,\n        closeCb,\n      });\n\n      let capturedConn: string | undefined;\n      await pool.withConnection(async (conn) => {\n        capturedConn = conn;\n        return 'result';\n      });\n\n      // Connection should be returned to pool\n      const conn2 = await pool.get();\n      expect(conn2).toBe(capturedConn); // Should reuse\n      expect(connectCb).toHaveBeenCalledTimes(1);\n    });\n\n    it('should remove connection from pool on error', async () => {\n      const connectCb = makeConnectCb();\n      const closeCb = vi.fn(async (_conn: string) => {\n        // Mock close\n      });\n\n      const pool = new ConnectionPool<string>({\n        connectCb,\n        closeCb,\n      });\n\n      let capturedConn: string | undefined;\n      try {\n        await pool.withConnection(async (conn) => {\n          capturedConn = conn;\n          throw new Error('test error');\n        });\n      } catch (e) {\n        // Expected\n      }\n\n      // Connection should be removed from pool\n      const conn2 = await pool.get();\n      expect(conn2).not.toBe(capturedConn); // Should create new connection\n      expect(connectCb).toHaveBeenCalledTimes(2);\n      expect(closeCb).toHaveBeenCalledTimes(1);\n    });\n\n    it('should handle abort signal', async () => {\n      const connectCb = makeConnectCb();\n      const closeCb = vi.fn(async (_conn: string) => {\n        // Mock close\n      });\n\n      const pool = new ConnectionPool<string>({\n        connectCb,\n        closeCb,\n      });\n\n      const abortController = new AbortController();\n      let capturedConn: string | undefined;\n\n      const promise = pool.withConnection(\n        async (conn) => {\n          capturedConn = conn;\n          await new Promise((resolve) => setTimeout(resolve, 1000));\n          return 'result';\n        },\n        { signal: abortController.signal },\n      );\n\n      // Abort after a short delay\n      setTimeout(() => abortController.abort(), 10);\n\n      await expect(promise).rejects.toThrow();\n\n      // Connection should be removed from pool\n      const conn2 = await pool.get();\n      expect(conn2).not.toBe(capturedConn); // Should create new connection\n      expect(closeCb).toHaveBeenCalledTimes(1);\n    });\n  });\n\n  describe('prewarm', () => {\n    it('should create connection in background', async () => {\n      let n = 0;\n      const connectCb = vi.fn(async (_timeout: number): Promise<string> => {\n        await new Promise((resolve) => setTimeout(resolve, 50));\n        return `conn_${++n}`;\n      });\n      const closeCb = vi.fn(async (_conn: string) => {\n        // Mock close\n      });\n\n      const pool = new ConnectionPool<string>({\n        connectCb,\n        closeCb,\n      });\n\n      pool.prewarm();\n\n      // Wait for prewarm to complete\n      await new Promise((resolve) => setTimeout(resolve, 100));\n\n      const conn = await pool.get();\n      expect(conn).toBeDefined();\n      expect(connectCb).toHaveBeenCalledTimes(1);\n    });\n\n    it('should not prewarm if connections already exist', async () => {\n      const connectCb = makeConnectCb();\n      const closeCb = vi.fn(async (_conn: string) => {\n        // Mock close\n      });\n\n      const pool = new ConnectionPool<string>({\n        connectCb,\n        closeCb,\n      });\n\n      // Create a connection first\n      const conn1 = await pool.get();\n      pool.put(conn1);\n\n      pool.prewarm(); // Should not create new connection\n\n      const conn2 = await pool.get();\n      expect(conn2).toBe(conn1); // Should reuse existing\n      expect(connectCb).toHaveBeenCalledTimes(1);\n    });\n  });\n\n  describe('close', () => {\n    it('should close all connections', async () => {\n      const connectCb = makeConnectCb();\n      const closeCb = vi.fn(async (_conn: string) => {\n        // Mock close\n      });\n\n      const pool = new ConnectionPool<string>({\n        connectCb,\n        closeCb,\n      });\n\n      // Create two distinct connections by checking out both before returning either.\n      const conn1 = await pool.get();\n      const conn2 = await pool.get();\n      pool.put(conn1);\n      pool.put(conn2);\n\n      await pool.close();\n\n      expect(closeCb).toHaveBeenCalledTimes(2);\n    });\n\n    it('should invalidate all connections', async () => {\n      const connectCb = makeConnectCb();\n      const closeCb = vi.fn(async (_conn: string) => {\n        // Mock close\n      });\n\n      const pool = new ConnectionPool<string>({\n        connectCb,\n        closeCb,\n      });\n\n      // Create two distinct connections by checking out both before returning either.\n      const conn1 = await pool.get();\n      const conn2 = await pool.get();\n      pool.put(conn1);\n      pool.put(conn2);\n\n      pool.invalidate();\n      await pool.close(); // Drain to close\n\n      expect(closeCb).toHaveBeenCalledTimes(2);\n    });\n  });\n\n  describe('concurrent access', () => {\n    it('should handle concurrent get requests', async () => {\n      const connectCb = vi.fn(async (_timeout: number): Promise<string> => {\n        await new Promise((resolve) => setTimeout(resolve, 10));\n        return `conn_${Date.now()}_${Math.random()}`;\n      });\n      const closeCb = vi.fn(async (_conn: string) => {\n        // Mock close\n      });\n\n      const pool = new ConnectionPool<string>({\n        connectCb,\n        closeCb,\n      });\n\n      const promises = Array.from({ length: 5 }, () => pool.get());\n      const connections = await Promise.all(promises);\n\n      // All should be different connections\n      const uniqueConnections = new Set(connections);\n      expect(uniqueConnections.size).toBe(5);\n      expect(connectCb).toHaveBeenCalledTimes(5);\n    });\n  });\n});\n"],"mappings":"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","names":["conn"]}

package/dist/constants.cjs

@@ -18,11 +18,21 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var constants_exports = {};
 __export(constants_exports, {
+  ATTRIBUTE_AGENT_NAME: () => ATTRIBUTE_AGENT_NAME,
+  ATTRIBUTE_AGENT_STATE: () => ATTRIBUTE_AGENT_STATE,
   ATTRIBUTE_PUBLISH_ON_BEHALF: () => ATTRIBUTE_PUBLISH_ON_BEHALF,
   ATTRIBUTE_TRANSCRIPTION_FINAL: () => ATTRIBUTE_TRANSCRIPTION_FINAL,
   ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID: () => ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID,
   ATTRIBUTE_TRANSCRIPTION_TRACK_ID: () => ATTRIBUTE_TRANSCRIPTION_TRACK_ID,
+  RPC_GET_AGENT_INFO: () => RPC_GET_AGENT_INFO,
+  RPC_GET_CHAT_HISTORY: () => RPC_GET_CHAT_HISTORY,
+  RPC_GET_SESSION_STATE: () => RPC_GET_SESSION_STATE,
+  RPC_SEND_MESSAGE: () => RPC_SEND_MESSAGE,
+  TOPIC_AGENT_REQUEST: () => TOPIC_AGENT_REQUEST,
+  TOPIC_AGENT_RESPONSE: () => TOPIC_AGENT_RESPONSE,
   TOPIC_CHAT: () => TOPIC_CHAT,
+  TOPIC_CLIENT_EVENTS: () => TOPIC_CLIENT_EVENTS,
+  TOPIC_SESSION_MESSAGES: () => TOPIC_SESSION_MESSAGES,
   TOPIC_TRANSCRIPTION: () => TOPIC_TRANSCRIPTION
 });
 module.exports = __toCommonJS(constants_exports);
@@ -32,13 +42,33 @@ const TOPIC_TRANSCRIPTION = "lk.transcription";
 const ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID = "lk.segment_id";
 const ATTRIBUTE_PUBLISH_ON_BEHALF = "lk.publish_on_behalf";
 const TOPIC_CHAT = "lk.chat";
+const ATTRIBUTE_AGENT_STATE = "lk.agent.state";
+const ATTRIBUTE_AGENT_NAME = "lk.agent.name";
+const TOPIC_CLIENT_EVENTS = "lk.agent.events";
+const RPC_GET_SESSION_STATE = "lk.agent.get_session_state";
+const RPC_GET_CHAT_HISTORY = "lk.agent.get_chat_history";
+const RPC_GET_AGENT_INFO = "lk.agent.get_agent_info";
+const RPC_SEND_MESSAGE = "lk.agent.send_message";
+const TOPIC_AGENT_REQUEST = "lk.agent.request";
+const TOPIC_AGENT_RESPONSE = "lk.agent.response";
+const TOPIC_SESSION_MESSAGES = "lk.agent.session";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ATTRIBUTE_AGENT_NAME,
+  ATTRIBUTE_AGENT_STATE,
   ATTRIBUTE_PUBLISH_ON_BEHALF,
   ATTRIBUTE_TRANSCRIPTION_FINAL,
   ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID,
   ATTRIBUTE_TRANSCRIPTION_TRACK_ID,
+  RPC_GET_AGENT_INFO,
+  RPC_GET_CHAT_HISTORY,
+  RPC_GET_SESSION_STATE,
+  RPC_SEND_MESSAGE,
+  TOPIC_AGENT_REQUEST,
+  TOPIC_AGENT_RESPONSE,
   TOPIC_CHAT,
+  TOPIC_CLIENT_EVENTS,
+  TOPIC_SESSION_MESSAGES,
   TOPIC_TRANSCRIPTION
 });
 //# sourceMappingURL=constants.cjs.map

package/dist/constants.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport const ATTRIBUTE_TRANSCRIPTION_TRACK_ID = 'lk.transcribed_track_id';\nexport const ATTRIBUTE_TRANSCRIPTION_FINAL = 'lk.transcription_final';\nexport const TOPIC_TRANSCRIPTION = 'lk.transcription';\nexport const ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID = 'lk.segment_id';\nexport const ATTRIBUTE_PUBLISH_ON_BEHALF = 'lk.publish_on_behalf';\nexport const TOPIC_CHAT = 'lk.chat';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGO,MAAM,mCAAmC;AACzC,MAAM,gCAAgC;AACtC,MAAM,sBAAsB;AAC5B,MAAM,qCAAqC;AAC3C,MAAM,8BAA8B;AACpC,MAAM,aAAa;","names":[]}
+{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport const ATTRIBUTE_TRANSCRIPTION_TRACK_ID = 'lk.transcribed_track_id';\nexport const ATTRIBUTE_TRANSCRIPTION_FINAL = 'lk.transcription_final';\nexport const TOPIC_TRANSCRIPTION = 'lk.transcription';\nexport const ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID = 'lk.segment_id';\nexport const ATTRIBUTE_PUBLISH_ON_BEHALF = 'lk.publish_on_behalf';\nexport const TOPIC_CHAT = 'lk.chat';\n\nexport const ATTRIBUTE_AGENT_STATE = 'lk.agent.state';\nexport const ATTRIBUTE_AGENT_NAME = 'lk.agent.name';\n\n// TODO(eval): export const ATTRIBUTE_SIMULATOR = 'lk.simulator';\n\nexport const TOPIC_CLIENT_EVENTS = 'lk.agent.events';\nexport const RPC_GET_SESSION_STATE = 'lk.agent.get_session_state';\nexport const RPC_GET_CHAT_HISTORY = 'lk.agent.get_chat_history';\nexport const RPC_GET_AGENT_INFO = 'lk.agent.get_agent_info';\nexport const RPC_SEND_MESSAGE = 'lk.agent.send_message';\nexport const TOPIC_AGENT_REQUEST = 'lk.agent.request';\nexport const TOPIC_AGENT_RESPONSE = 'lk.agent.response';\nexport const TOPIC_SESSION_MESSAGES = 'lk.agent.session';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGO,MAAM,mCAAmC;AACzC,MAAM,gCAAgC;AACtC,MAAM,sBAAsB;AAC5B,MAAM,qCAAqC;AAC3C,MAAM,8BAA8B;AACpC,MAAM,aAAa;AAEnB,MAAM,wBAAwB;AAC9B,MAAM,uBAAuB;AAI7B,MAAM,sBAAsB;AAC5B,MAAM,wBAAwB;AAC9B,MAAM,uBAAuB;AAC7B,MAAM,qBAAqB;AAC3B,MAAM,mBAAmB;AACzB,MAAM,sBAAsB;AAC5B,MAAM,uBAAuB;AAC7B,MAAM,yBAAyB;","names":[]}

package/dist/constants.d.cts

@@ -4,4 +4,14 @@ export declare const TOPIC_TRANSCRIPTION = "lk.transcription";
 export declare const ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID = "lk.segment_id";
 export declare const ATTRIBUTE_PUBLISH_ON_BEHALF = "lk.publish_on_behalf";
 export declare const TOPIC_CHAT = "lk.chat";
+export declare const ATTRIBUTE_AGENT_STATE = "lk.agent.state";
+export declare const ATTRIBUTE_AGENT_NAME = "lk.agent.name";
+export declare const TOPIC_CLIENT_EVENTS = "lk.agent.events";
+export declare const RPC_GET_SESSION_STATE = "lk.agent.get_session_state";
+export declare const RPC_GET_CHAT_HISTORY = "lk.agent.get_chat_history";
+export declare const RPC_GET_AGENT_INFO = "lk.agent.get_agent_info";
+export declare const RPC_SEND_MESSAGE = "lk.agent.send_message";
+export declare const TOPIC_AGENT_REQUEST = "lk.agent.request";
+export declare const TOPIC_AGENT_RESPONSE = "lk.agent.response";
+export declare const TOPIC_SESSION_MESSAGES = "lk.agent.session";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts

@@ -4,4 +4,14 @@ export declare const TOPIC_TRANSCRIPTION = "lk.transcription";
 export declare const ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID = "lk.segment_id";
 export declare const ATTRIBUTE_PUBLISH_ON_BEHALF = "lk.publish_on_behalf";
 export declare const TOPIC_CHAT = "lk.chat";
+export declare const ATTRIBUTE_AGENT_STATE = "lk.agent.state";
+export declare const ATTRIBUTE_AGENT_NAME = "lk.agent.name";
+export declare const TOPIC_CLIENT_EVENTS = "lk.agent.events";
+export declare const RPC_GET_SESSION_STATE = "lk.agent.get_session_state";
+export declare const RPC_GET_CHAT_HISTORY = "lk.agent.get_chat_history";
+export declare const RPC_GET_AGENT_INFO = "lk.agent.get_agent_info";
+export declare const RPC_SEND_MESSAGE = "lk.agent.send_message";
+export declare const TOPIC_AGENT_REQUEST = "lk.agent.request";
+export declare const TOPIC_AGENT_RESPONSE = "lk.agent.response";
+export declare const TOPIC_SESSION_MESSAGES = "lk.agent.session";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gCAAgC,4BAA4B,CAAC;AAC1E,eAAO,MAAM,6BAA6B,2BAA2B,CAAC;AACtE,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AACtD,eAAO,MAAM,kCAAkC,kBAAkB,CAAC;AAClE,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAClE,eAAO,MAAM,UAAU,YAAY,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gCAAgC,4BAA4B,CAAC;AAC1E,eAAO,MAAM,6BAA6B,2BAA2B,CAAC;AACtE,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AACtD,eAAO,MAAM,kCAAkC,kBAAkB,CAAC;AAClE,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAClE,eAAO,MAAM,UAAU,YAAY,CAAC;AAEpC,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AACtD,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAIpD,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AACrD,eAAO,MAAM,qBAAqB,+BAA+B,CAAC;AAClE,eAAO,MAAM,oBAAoB,8BAA8B,CAAC;AAChE,eAAO,MAAM,kBAAkB,4BAA4B,CAAC;AAC5D,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AACxD,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AACtD,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AACxD,eAAO,MAAM,sBAAsB,qBAAqB,CAAC"}

package/dist/constants.js

@@ -4,12 +4,32 @@ const TOPIC_TRANSCRIPTION = "lk.transcription";
 const ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID = "lk.segment_id";
 const ATTRIBUTE_PUBLISH_ON_BEHALF = "lk.publish_on_behalf";
 const TOPIC_CHAT = "lk.chat";
+const ATTRIBUTE_AGENT_STATE = "lk.agent.state";
+const ATTRIBUTE_AGENT_NAME = "lk.agent.name";
+const TOPIC_CLIENT_EVENTS = "lk.agent.events";
+const RPC_GET_SESSION_STATE = "lk.agent.get_session_state";
+const RPC_GET_CHAT_HISTORY = "lk.agent.get_chat_history";
+const RPC_GET_AGENT_INFO = "lk.agent.get_agent_info";
+const RPC_SEND_MESSAGE = "lk.agent.send_message";
+const TOPIC_AGENT_REQUEST = "lk.agent.request";
+const TOPIC_AGENT_RESPONSE = "lk.agent.response";
+const TOPIC_SESSION_MESSAGES = "lk.agent.session";
 export {
+  ATTRIBUTE_AGENT_NAME,
+  ATTRIBUTE_AGENT_STATE,
   ATTRIBUTE_PUBLISH_ON_BEHALF,
   ATTRIBUTE_TRANSCRIPTION_FINAL,
   ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID,
   ATTRIBUTE_TRANSCRIPTION_TRACK_ID,
+  RPC_GET_AGENT_INFO,
+  RPC_GET_CHAT_HISTORY,
+  RPC_GET_SESSION_STATE,
+  RPC_SEND_MESSAGE,
+  TOPIC_AGENT_REQUEST,
+  TOPIC_AGENT_RESPONSE,
   TOPIC_CHAT,
+  TOPIC_CLIENT_EVENTS,
+  TOPIC_SESSION_MESSAGES,
   TOPIC_TRANSCRIPTION
 };
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport const ATTRIBUTE_TRANSCRIPTION_TRACK_ID = 'lk.transcribed_track_id';\nexport const ATTRIBUTE_TRANSCRIPTION_FINAL = 'lk.transcription_final';\nexport const TOPIC_TRANSCRIPTION = 'lk.transcription';\nexport const ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID = 'lk.segment_id';\nexport const ATTRIBUTE_PUBLISH_ON_BEHALF = 'lk.publish_on_behalf';\nexport const TOPIC_CHAT = 'lk.chat';\n"],"mappings":"AAGO,MAAM,mCAAmC;AACzC,MAAM,gCAAgC;AACtC,MAAM,sBAAsB;AAC5B,MAAM,qCAAqC;AAC3C,MAAM,8BAA8B;AACpC,MAAM,aAAa;","names":[]}
+{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport const ATTRIBUTE_TRANSCRIPTION_TRACK_ID = 'lk.transcribed_track_id';\nexport const ATTRIBUTE_TRANSCRIPTION_FINAL = 'lk.transcription_final';\nexport const TOPIC_TRANSCRIPTION = 'lk.transcription';\nexport const ATTRIBUTE_TRANSCRIPTION_SEGMENT_ID = 'lk.segment_id';\nexport const ATTRIBUTE_PUBLISH_ON_BEHALF = 'lk.publish_on_behalf';\nexport const TOPIC_CHAT = 'lk.chat';\n\nexport const ATTRIBUTE_AGENT_STATE = 'lk.agent.state';\nexport const ATTRIBUTE_AGENT_NAME = 'lk.agent.name';\n\n// TODO(eval): export const ATTRIBUTE_SIMULATOR = 'lk.simulator';\n\nexport const TOPIC_CLIENT_EVENTS = 'lk.agent.events';\nexport const RPC_GET_SESSION_STATE = 'lk.agent.get_session_state';\nexport const RPC_GET_CHAT_HISTORY = 'lk.agent.get_chat_history';\nexport const RPC_GET_AGENT_INFO = 'lk.agent.get_agent_info';\nexport const RPC_SEND_MESSAGE = 'lk.agent.send_message';\nexport const TOPIC_AGENT_REQUEST = 'lk.agent.request';\nexport const TOPIC_AGENT_RESPONSE = 'lk.agent.response';\nexport const TOPIC_SESSION_MESSAGES = 'lk.agent.session';\n"],"mappings":"AAGO,MAAM,mCAAmC;AACzC,MAAM,gCAAgC;AACtC,MAAM,sBAAsB;AAC5B,MAAM,qCAAqC;AAC3C,MAAM,8BAA8B;AACpC,MAAM,aAAa;AAEnB,MAAM,wBAAwB;AAC9B,MAAM,uBAAuB;AAI7B,MAAM,sBAAsB;AAC5B,MAAM,wBAAwB;AAC9B,MAAM,uBAAuB;AAC7B,MAAM,qBAAqB;AAC3B,MAAM,mBAAmB;AACzB,MAAM,sBAAsB;AAC5B,MAAM,uBAAuB;AAC7B,MAAM,yBAAyB;","names":[]}

package/dist/cpu.cjs

@@ -0,0 +1,189 @@
+"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 cpu_exports = {};
+__export(cpu_exports, {
+  CGroupV1CpuMonitor: () => CGroupV1CpuMonitor,
+  CGroupV2CpuMonitor: () => CGroupV2CpuMonitor,
+  DefaultCpuMonitor: () => DefaultCpuMonitor,
+  getCpuMonitor: () => getCpuMonitor
+});
+module.exports = __toCommonJS(cpu_exports);
+var import_node_fs = require("node:fs");
+var import_node_os = __toESM(require("node:os"), 1);
+function cpuCountFromEnv() {
+  const raw = process.env.NUM_CPUS;
+  if (raw === void 0) return void 0;
+  const parsed = parseFloat(raw);
+  if (Number.isNaN(parsed)) {
+    console.warn("Failed to parse NUM_CPUS from environment");
+    return void 0;
+  }
+  return parsed;
+}
+class DefaultCpuMonitor {
+  cpuCount() {
+    return cpuCountFromEnv() ?? (import_node_os.default.cpus().length || 1);
+  }
+  cpuPercent(intervalMs) {
+    return new Promise((resolve) => {
+      const cpus1 = import_node_os.default.cpus();
+      const timer = setTimeout(() => {
+        const cpus2 = import_node_os.default.cpus();
+        let idle = 0;
+        let total = 0;
+        for (let i = 0; i < cpus1.length; i++) {
+          const cpu1 = cpus1[i].times;
+          const cpu2 = cpus2[i].times;
+          idle += cpu2.idle - cpu1.idle;
+          const total1 = Object.values(cpu1).reduce((acc, v) => acc + v, 0);
+          const total2 = Object.values(cpu2).reduce((acc, v) => acc + v, 0);
+          total += total2 - total1;
+        }
+        resolve(total === 0 ? 0 : Math.max(Math.min(+(1 - idle / total).toFixed(2), 1), 0));
+      }, intervalMs);
+      timer.unref();
+    });
+  }
+}
+class CGroupV2CpuMonitor {
+  cpuCount() {
+    const envCpus = cpuCountFromEnv();
+    if (envCpus !== void 0) return envCpus;
+    const [quota, period] = this.#readCpuMax();
+    if (quota === "max") return import_node_os.default.cpus().length || 1;
+    return parseInt(quota) / period;
+  }
+  cpuPercent(intervalMs) {
+    return new Promise((resolve, reject) => {
+      const usageStart = this.#readCpuUsage();
+      const timer = setTimeout(() => {
+        try {
+          const usageEnd = this.#readCpuUsage();
+          const usageDiffUsec = usageEnd - usageStart;
+          const usageSeconds = usageDiffUsec / 1e6;
+          const numCpus = this.cpuCount();
+          const intervalSeconds = intervalMs / 1e3;
+          const percent = usageSeconds / (intervalSeconds * numCpus);
+          resolve(Math.max(Math.min(percent, 1), 0));
+        } catch (e) {
+          reject(e);
+        }
+      }, intervalMs);
+      timer.unref();
+    });
+  }
+  #readCpuMax() {
+    try {
+      const data = (0, import_node_fs.readFileSync)("/sys/fs/cgroup/cpu.max", "utf-8").trim().split(/\s+/);
+      const quota = data[0] ?? "max";
+      const period = data[1] ? parseInt(data[1]) : 1e5;
+      return [quota, Number.isNaN(period) ? 1e5 : period];
+    } catch {
+      return ["max", 1e5];
+    }
+  }
+  #readCpuUsage() {
+    const content = (0, import_node_fs.readFileSync)("/sys/fs/cgroup/cpu.stat", "utf-8");
+    for (const line of content.split("\n")) {
+      if (line.startsWith("usage_usec")) {
+        return parseInt(line.split(/\s+/)[1]);
+      }
+    }
+    throw new Error("Failed to read CPU usage from /sys/fs/cgroup/cpu.stat");
+  }
+}
+class CGroupV1CpuMonitor {
+  cpuCount() {
+    const envCpus = cpuCountFromEnv();
+    if (envCpus !== void 0) return envCpus;
+    const [quota, period] = this.#readCfsQuotaAndPeriod();
+    if (quota === null || quota < 0 || period === null || period <= 0) {
+      return 2;
+    }
+    return Math.max(quota / period, 1);
+  }
+  cpuPercent(intervalMs) {
+    return new Promise((resolve, reject) => {
+      const usageStart = this.#readCpuacctUsage();
+      const timer = setTimeout(() => {
+        try {
+          const usageEnd = this.#readCpuacctUsage();
+          const usageDiffNs = usageEnd - usageStart;
+          const usageSeconds = usageDiffNs / 1e9;
+          const numCpus = this.cpuCount();
+          const intervalSeconds = intervalMs / 1e3;
+          const percent = usageSeconds / (intervalSeconds * numCpus);
+          resolve(Math.max(Math.min(percent, 1), 0));
+        } catch (e) {
+          reject(e);
+        }
+      }, intervalMs);
+      timer.unref();
+    });
+  }
+  #readCfsQuotaAndPeriod() {
+    const quota = readFirstInt("/sys/fs/cgroup/cpu/cpu.cfs_quota_us");
+    const period = readFirstInt("/sys/fs/cgroup/cpu/cpu.cfs_period_us");
+    return [quota, period];
+  }
+  #readCpuacctUsage() {
+    const value = readFirstInt("/sys/fs/cgroup/cpuacct/cpuacct.usage");
+    if (value === null) {
+      throw new Error("Failed to read cpuacct.usage for cgroup v1");
+    }
+    return value;
+  }
+}
+function readFirstInt(path) {
+  try {
+    const val = parseInt((0, import_node_fs.readFileSync)(path, "utf-8").trim());
+    return Number.isNaN(val) ? null : val;
+  } catch {
+    return null;
+  }
+}
+function isCGroupV2() {
+  return (0, import_node_fs.existsSync)("/sys/fs/cgroup/cpu.stat");
+}
+function isCGroupV1() {
+  return (0, import_node_fs.existsSync)("/sys/fs/cgroup/cpuacct/cpuacct.usage");
+}
+function getCpuMonitor() {
+  if (isCGroupV2()) return new CGroupV2CpuMonitor();
+  if (isCGroupV1()) return new CGroupV1CpuMonitor();
+  return new DefaultCpuMonitor();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CGroupV1CpuMonitor,
+  CGroupV2CpuMonitor,
+  DefaultCpuMonitor,
+  getCpuMonitor
+});
+//# sourceMappingURL=cpu.cjs.map

package/dist/cpu.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cpu.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { existsSync, readFileSync } from 'node:fs';\nimport os from 'node:os';\n\n/** @internal */\nexport interface CpuMonitor {\n  cpuCount(): number;\n  cpuPercent(intervalMs: number): Promise<number>;\n}\n\nfunction cpuCountFromEnv(): number | undefined {\n  const raw = process.env.NUM_CPUS;\n  if (raw === undefined) return undefined;\n  const parsed = parseFloat(raw);\n  if (Number.isNaN(parsed)) {\n    console.warn('Failed to parse NUM_CPUS from environment');\n    return undefined;\n  }\n  return parsed;\n}\n\n/** @internal */\nexport class DefaultCpuMonitor implements CpuMonitor {\n  cpuCount(): number {\n    return cpuCountFromEnv() ?? (os.cpus().length || 1);\n  }\n\n  cpuPercent(intervalMs: number): Promise<number> {\n    return new Promise((resolve) => {\n      const cpus1 = os.cpus();\n      const timer = setTimeout(() => {\n        const cpus2 = os.cpus();\n        let idle = 0;\n        let total = 0;\n        for (let i = 0; i < cpus1.length; i++) {\n          const cpu1 = cpus1[i]!.times;\n          const cpu2 = cpus2[i]!.times;\n          idle += cpu2.idle - cpu1.idle;\n          const total1 = Object.values(cpu1).reduce((acc, v) => acc + v, 0);\n          const total2 = Object.values(cpu2).reduce((acc, v) => acc + v, 0);\n          total += total2 - total1;\n        }\n        resolve(total === 0 ? 0 : Math.max(Math.min(+(1 - idle / total).toFixed(2), 1), 0));\n      }, intervalMs);\n      timer.unref();\n    });\n  }\n}\n\n/** @internal */\nexport class CGroupV2CpuMonitor implements CpuMonitor {\n  cpuCount(): number {\n    const envCpus = cpuCountFromEnv();\n    if (envCpus !== undefined) return envCpus;\n    const [quota, period] = this.#readCpuMax();\n    if (quota === 'max') return os.cpus().length || 1;\n    return parseInt(quota) / period;\n  }\n\n  cpuPercent(intervalMs: number): Promise<number> {\n    return new Promise((resolve, reject) => {\n      const usageStart = this.#readCpuUsage();\n      const timer = setTimeout(() => {\n        try {\n          const usageEnd = this.#readCpuUsage();\n          const usageDiffUsec = usageEnd - usageStart;\n          const usageSeconds = usageDiffUsec / 1_000_000;\n          const numCpus = this.cpuCount();\n          const intervalSeconds = intervalMs / 1000;\n          const percent = usageSeconds / (intervalSeconds * numCpus);\n          resolve(Math.max(Math.min(percent, 1), 0));\n        } catch (e) {\n          reject(e);\n        }\n      }, intervalMs);\n      timer.unref();\n    });\n  }\n\n  #readCpuMax(): [string, number] {\n    try {\n      const data = readFileSync('/sys/fs/cgroup/cpu.max', 'utf-8').trim().split(/\\s+/);\n      const quota = data[0] ?? 'max';\n      const period = data[1] ? parseInt(data[1]) : 100_000;\n      return [quota, Number.isNaN(period) ? 100_000 : period];\n    } catch {\n      return ['max', 100_000];\n    }\n  }\n\n  #readCpuUsage(): number {\n    const content = readFileSync('/sys/fs/cgroup/cpu.stat', 'utf-8');\n    for (const line of content.split('\\n')) {\n      if (line.startsWith('usage_usec')) {\n        return parseInt(line.split(/\\s+/)[1]!);\n      }\n    }\n    throw new Error('Failed to read CPU usage from /sys/fs/cgroup/cpu.stat');\n  }\n}\n\n/** @internal */\nexport class CGroupV1CpuMonitor implements CpuMonitor {\n  cpuCount(): number {\n    const envCpus = cpuCountFromEnv();\n    if (envCpus !== undefined) return envCpus;\n    const [quota, period] = this.#readCfsQuotaAndPeriod();\n    if (quota === null || quota < 0 || period === null || period <= 0) {\n      // do not use the host CPU count as it could overstate the number available to the container\n      return 2.0;\n    }\n    return Math.max(quota / period, 1.0);\n  }\n\n  cpuPercent(intervalMs: number): Promise<number> {\n    return new Promise((resolve, reject) => {\n      const usageStart = this.#readCpuacctUsage();\n      const timer = setTimeout(() => {\n        try {\n          const usageEnd = this.#readCpuacctUsage();\n          const usageDiffNs = usageEnd - usageStart;\n          const usageSeconds = usageDiffNs / 1_000_000_000;\n          const numCpus = this.cpuCount();\n          const intervalSeconds = intervalMs / 1000;\n          const percent = usageSeconds / (intervalSeconds * numCpus);\n          resolve(Math.max(Math.min(percent, 1.0), 0.0));\n        } catch (e) {\n          reject(e);\n        }\n      }, intervalMs);\n      timer.unref();\n    });\n  }\n\n  #readCfsQuotaAndPeriod(): [number | null, number | null] {\n    const quota = readFirstInt('/sys/fs/cgroup/cpu/cpu.cfs_quota_us');\n    const period = readFirstInt('/sys/fs/cgroup/cpu/cpu.cfs_period_us');\n    return [quota, period];\n  }\n\n  #readCpuacctUsage(): number {\n    const value = readFirstInt('/sys/fs/cgroup/cpuacct/cpuacct.usage');\n    if (value === null) {\n      throw new Error('Failed to read cpuacct.usage for cgroup v1');\n    }\n    return value;\n  }\n}\n\nfunction readFirstInt(path: string): number | null {\n  try {\n    const val = parseInt(readFileSync(path, 'utf-8').trim());\n    return Number.isNaN(val) ? null : val;\n  } catch {\n    return null;\n  }\n}\n\nfunction isCGroupV2(): boolean {\n  return existsSync('/sys/fs/cgroup/cpu.stat');\n}\n\nfunction isCGroupV1(): boolean {\n  return existsSync('/sys/fs/cgroup/cpuacct/cpuacct.usage');\n}\n\nexport function getCpuMonitor(): CpuMonitor {\n  if (isCGroupV2()) return new CGroupV2CpuMonitor();\n  if (isCGroupV1()) return new CGroupV1CpuMonitor();\n  return new DefaultCpuMonitor();\n}\n"],"mappings":"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","names":["os"]}