@cohortapp/agent-sdk 2.3.0

package/scripts/test-voice-parser.mjs

@@ -0,0 +1,316 @@
+#!/usr/bin/env node
+/**
+ * Test suite for voice call transcript parser.
+ * Run: node scripts/test-voice-parser.mjs
+ */
+
+import {
+  isVoiceTranscript,
+  parseVoiceTranscript,
+  toInboxItems,
+} from "./parse-voice-transcript.mjs";
+
+let passed = 0;
+let failed = 0;
+
+function assert(condition, message) {
+  if (condition) {
+    passed++;
+    console.log(`  PASS: ${message}`);
+  } else {
+    failed++;
+    console.error(`  FAIL: ${message}`);
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Test 1: Detection — isVoiceTranscript
+// ---------------------------------------------------------------------------
+
+console.log("\n=== Test 1: isVoiceTranscript detection ===");
+
+const validTranscript = `*Phone call completed* — +971585291799 (243s, 38 turns)
+
+*Caller said:*
+> Hello this is Alex
+> Can you search for flights to Australia for me, my wife and my son
+> Also can you time box my calendar for this week
+
+_Action items from this call should be processed immediately._`;
+
+const regularMessage =
+  "Hey Robin, can you check the status of the the regulator application?";
+const partialMatch1 = "Phone call completed but nothing else";
+const partialMatch2 = "Caller said: something random";
+
+assert(
+  isVoiceTranscript(validTranscript) === true,
+  "Valid transcript detected",
+);
+assert(isVoiceTranscript(regularMessage) === false, "Regular message rejected");
+assert(
+  isVoiceTranscript(partialMatch1) === false,
+  "Partial match 1 rejected (no Caller said)",
+);
+assert(
+  isVoiceTranscript(partialMatch2) === false,
+  "Partial match 2 rejected (no Phone call completed)",
+);
+assert(isVoiceTranscript("") === false, "Empty string rejected");
+assert(isVoiceTranscript(null) === false, "Null rejected");
+assert(isVoiceTranscript(undefined) === false, "Undefined rejected");
+
+// ---------------------------------------------------------------------------
+// Test 2: Header parsing
+// ---------------------------------------------------------------------------
+
+console.log("\n=== Test 2: Header parsing ===");
+
+const parsed = parseVoiceTranscript(validTranscript, {
+  ts: "1775160348.003859",
+  channel: "D099N1JGKRQ",
+});
+
+assert(
+  parsed.type === "voice_call_transcript",
+  "Type is voice_call_transcript",
+);
+assert(parsed.callerPhone === "+971585291799", "Caller phone extracted");
+assert(parsed.durationSeconds === 243, "Duration seconds extracted");
+assert(parsed.duration === "4m 3s", "Duration formatted correctly");
+assert(parsed.turns === 38, "Turns extracted");
+assert(parsed.caller === "alex-chen", "Caller resolved to known identity");
+assert(parsed.callerIdentity.privilege === "ceo", "Caller privilege resolved");
+assert(parsed.slackTs === "1775160348.003859", "Slack timestamp preserved");
+assert(parsed.slackChannel === "D099N1JGKRQ", "Slack channel preserved");
+
+// ---------------------------------------------------------------------------
+// Test 3: Caller statement extraction
+// ---------------------------------------------------------------------------
+
+console.log("\n=== Test 3: Caller statement extraction ===");
+
+assert(
+  parsed.callerStatements.length === 3,
+  `Got ${parsed.callerStatements.length} statements (expected 3)`,
+);
+assert(
+  parsed.callerStatements[0] === "Hello this is Alex",
+  "First statement correct",
+);
+assert(
+  parsed.callerStatements[1].includes("flights to Australia"),
+  "Second statement contains flight request",
+);
+assert(
+  parsed.callerStatements[2].includes("time box"),
+  "Third statement contains calendar request",
+);
+
+// ---------------------------------------------------------------------------
+// Test 4: Topic classification
+// ---------------------------------------------------------------------------
+
+console.log("\n=== Test 4: Topic classification ===");
+
+assert(parsed.topics.includes("travel"), "Travel topic detected");
+assert(parsed.topics.includes("calendar"), "Calendar topic detected");
+
+// ---------------------------------------------------------------------------
+// Test 5: Action item extraction
+// ---------------------------------------------------------------------------
+
+console.log("\n=== Test 5: Action item extraction ===");
+
+assert(
+  parsed.actionItems.length >= 1,
+  `At least 1 action item extracted (got ${parsed.actionItems.length})`,
+);
+
+// Check that action items have required fields
+for (const item of parsed.actionItems) {
+  assert(
+    item.title && item.title.length > 0,
+    `Action has title: ${item.title}`,
+  );
+  assert(item.context && item.context.length > 0, "Action has context");
+  assert(
+    ["critical", "high", "medium", "low"].includes(item.priority),
+    `Action has valid priority: ${item.priority}`,
+  );
+  assert(item.source === "voice-call", "Action source is voice-call");
+  assert(item.caller === "alex-chen", "Action caller is resolved");
+  assert(item.caller_privilege === "ceo", "Action caller privilege is ceo");
+}
+
+// ---------------------------------------------------------------------------
+// Test 6: Inbox item generation
+// ---------------------------------------------------------------------------
+
+console.log("\n=== Test 6: Inbox item generation (toInboxItems) ===");
+
+const inboxItems = toInboxItems(parsed);
+
+assert(
+  inboxItems.length >= 1,
+  `At least 1 inbox item generated (got ${inboxItems.length})`,
+);
+
+for (const item of inboxItems) {
+  assert(item.id && item.id.length > 0, "Inbox item has id");
+  assert(item.service === "slack", "Inbox item service is slack");
+  assert(item.sender === "alex-chen", "Inbox item sender resolved");
+  assert(item.sender_privilege === "ceo", "Inbox item sender privilege is ceo");
+  assert(
+    item.is_voice_transcript === true,
+    "Inbox item marked as voice transcript",
+  );
+  assert(item.priority_signals.from_ceo === true, "Priority signal: from_ceo");
+  assert(item.voice_meta !== undefined, "Inbox item has voice_meta");
+  assert(
+    item.voice_meta.caller_phone === "+971585291799",
+    "Voice meta has caller phone",
+  );
+  assert(item.voice_meta.duration_seconds === 243, "Voice meta has duration");
+}
+
+// ---------------------------------------------------------------------------
+// Test 7: Unknown caller
+// ---------------------------------------------------------------------------
+
+console.log("\n=== Test 7: Unknown caller ===");
+
+const unknownCallerTranscript = `*Phone call completed* — +14155551234 (60s, 8 turns)
+
+*Caller said:*
+> Hi I'm looking for information about Northwind
+> Can you tell me about your services
+
+_Action items from this call should be processed immediately._`;
+
+const unknownParsed = parseVoiceTranscript(unknownCallerTranscript);
+assert(
+  unknownParsed.callerPhone === "+14155551234",
+  "Unknown caller phone extracted",
+);
+assert(
+  unknownParsed.caller === "+14155551234",
+  "Unknown caller uses phone as name",
+);
+assert(
+  unknownParsed.callerIdentity.privilege === "unknown",
+  "Unknown caller privilege is unknown",
+);
+
+// ---------------------------------------------------------------------------
+// Test 8: CEO fallback — no action items detected still generates inbox item
+// ---------------------------------------------------------------------------
+
+console.log("\n=== Test 8: CEO fallback for no detected actions ===");
+
+const ceoNoActionsTranscript = `*Phone call completed* — +971585291799 (15s, 4 turns)
+
+*Caller said:*
+> Hello
+> Goodbye
+
+_Action items from this call should be processed immediately._`;
+
+const ceoNoActions = parseVoiceTranscript(ceoNoActionsTranscript, {
+  ts: "test.123",
+  channel: "D099N1JGKRQ",
+});
+const fallbackItems = toInboxItems(ceoNoActions);
+assert(
+  fallbackItems.length >= 1,
+  "CEO call with no detected actions still generates fallback inbox item",
+);
+assert(
+  fallbackItems[0].priority_signals.from_ceo === true,
+  "Fallback item marked as from CEO",
+);
+
+// ---------------------------------------------------------------------------
+// Test 9: Non-CEO no action items — should generate nothing
+// ---------------------------------------------------------------------------
+
+console.log("\n=== Test 9: Non-CEO no actions generates nothing ===");
+
+const nonCeoNoActions = parseVoiceTranscript(unknownCallerTranscript);
+// This one actually has "Can you tell me" which is actionable
+// Use a truly non-actionable one
+const nonCeoTrivial = `*Phone call completed* — +14155551234 (10s, 2 turns)
+
+*Caller said:*
+> Hello
+> Bye
+
+_Action items from this call should be processed immediately._`;
+
+const trivialParsed = parseVoiceTranscript(nonCeoTrivial);
+const trivialItems = toInboxItems(trivialParsed);
+assert(
+  trivialItems.length === 0,
+  `Non-CEO trivial call generates no inbox items (got ${trivialItems.length})`,
+);
+
+// ---------------------------------------------------------------------------
+// Test 10: Realistic multi-action transcript
+// ---------------------------------------------------------------------------
+
+console.log("\n=== Test 10: Realistic multi-action transcript ===");
+
+const realisticTranscript = `*Phone call completed* — +971585291799 (312s, 42 turns)
+
+*Caller said:*
+> Hey Robin
+> I need you to search for flights to Sydney for me, Bronwyn and Leon
+> We need to leave on April 6th or 7th and come back around the 15th
+> Also can you time box my calendar for this week based on priorities
+> Send me an email with the calendar plan as a PDF
+> Oh and another thing, can you follow up with Jordan about the board resolutions
+> He hasn't responded to the last email
+
+_Action items from this call should be processed immediately._`;
+
+const realisticParsed = parseVoiceTranscript(realisticTranscript, {
+  ts: "1775160000.000000",
+  channel: "D099N1JGKRQ",
+});
+
+assert(
+  realisticParsed.callerStatements.length === 7,
+  `Got ${realisticParsed.callerStatements.length} statements (expected 7)`,
+);
+assert(
+  realisticParsed.topics.includes("travel"),
+  "Travel topic detected in realistic",
+);
+assert(
+  realisticParsed.topics.includes("calendar"),
+  "Calendar topic detected in realistic",
+);
+assert(
+  realisticParsed.topics.includes("communication"),
+  "Communication topic detected in realistic",
+);
+assert(
+  realisticParsed.actionItems.length >= 2,
+  `At least 2 action items from realistic (got ${realisticParsed.actionItems.length})`,
+);
+
+const realisticInbox = toInboxItems(realisticParsed);
+assert(
+  realisticInbox.length >= 2,
+  `At least 2 inbox items from realistic (got ${realisticInbox.length})`,
+);
+
+// ---------------------------------------------------------------------------
+// Summary
+// ---------------------------------------------------------------------------
+
+console.log(`\n${"=".repeat(50)}`);
+console.log(`Results: ${passed} passed, ${failed} failed`);
+console.log(`${"=".repeat(50)}\n`);
+
+process.exit(failed > 0 ? 1 : 0);