@kognitivedev/backend-cloud 0.2.29

package/dist/utils.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getString = getString;
+exports.getNumber = getNumber;
+exports.getRecord = getRecord;
+function getString(value, fallback = "") {
+    return typeof value === "string" && value.trim() ? value.trim() : fallback;
+}
+function getNumber(value, fallback) {
+    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+function getRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@kognitivedev/backend-cloud",
+  "version": "0.2.29",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc -w --noCheck",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@kognitivedev/telephony": "^0.2.29",
+    "@kognitivedev/voice-media-bridge": "^0.2.29",
+    "ws": "^8.20.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.0.0",
+    "vitest": "^3.0.0"
+  },
+  "description": "Reusable backend orchestration helpers for Kognitive Cloud products",
+  "keywords": [
+    "kognitive",
+    "backend",
+    "cloud",
+    "voice",
+    "agents"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kognitivedev/kognitive",
+    "directory": "packages/backend-cloud"
+  },
+  "homepage": "https://kognitive.dev"
+}

package/src/__tests__/audio-playout-tracker.test.ts

@@ -0,0 +1,46 @@
+import { describe, expect, it } from "vitest";
+import { PhonePlayoutTracker } from "../phone-runtime/audio-playout-tracker";
+
+describe("PhonePlayoutTracker", () => {
+    it("reports heard and queued assistant audio for interruptions", () => {
+        const tracker = new PhonePlayoutTracker({ frameDurationMs: 20 });
+        tracker.startAssistantItem("assistant-item-1");
+        tracker.recordOutboundFrame({ markName: "m1" });
+        tracker.recordOutboundFrame({ markName: "m2" });
+        tracker.recordCarrierMark("m1");
+
+        expect(tracker.interrupt({ elapsedMs: 30, providerTruncationSupported: true })).toMatchObject({
+            assistantItemId: "assistant-item-1",
+            heardAudioMs: 30,
+            queuedAudioMs: 40,
+            pendingMarks: 1,
+            interrupted: true,
+            providerTruncationSupported: true,
+        });
+    });
+
+    it("waits until carrier marks drain before reporting idle", async () => {
+        const tracker = new PhonePlayoutTracker({ frameDurationMs: 20 });
+        tracker.recordOutboundFrame({ markName: "m1" });
+
+        const wait = tracker.waitForIdle({ timeoutMs: 500, quietMs: 0, pollMs: 10 });
+        setTimeout(() => tracker.recordCarrierMark("m1"), 25);
+
+        await expect(wait).resolves.toMatchObject({
+            idle: true,
+            reason: "idle",
+            pendingMarks: 0,
+        });
+    });
+
+    it("times out when carrier marks never drain", async () => {
+        const tracker = new PhonePlayoutTracker({ frameDurationMs: 20 });
+        tracker.recordOutboundFrame({ markName: "m1" });
+
+        await expect(tracker.waitForIdle({ timeoutMs: 20, quietMs: 0, pollMs: 10 })).resolves.toMatchObject({
+            idle: false,
+            reason: "timeout",
+            pendingMarks: 1,
+        });
+    });
+});