fix(voice-call): emit canonical agent-scoped session keys for per-phone and per-call scopes (#80064)

hclsys · hclsys · commit ad8ea561ae07 · 2026-05-10T18:06:49.000+08:00
Before this fix, `resolveVoiceCallSessionKey` produced raw `voice:*` keys
(`voice:&lt;phone&gt;`, `voice:call:&lt;callId&gt;`). Gateway startup migration
canonicalizes those keys to `agent:&lt;agentId&gt;:voice:*` format, so after a
restart the per-phone/per-call resolver and the session store used different
keys — breaking caller continuity across restarts.

Fix: include `agentId` in the Pick type and prefix every generated key with
`agent:&lt;agentId || "main"&gt;:voice:`. Explicit session keys pass through
unchanged. All four call sites already supply full VoiceCallConfig objects,
so no call-site changes are required.
diff --git a/extensions/voice-call/src/config.test.ts b/extensions/voice-call/src/config.test.ts
@@ -270,7 +270,23 @@ describe("resolveVoiceCallConfig session routing", () => {
         callId: "call-123",
         phone: "+1 (555) 000-1111",
       }),
-    ).toBe("voice:15550001111");
+    ).toBe("agent:main:voice:15550001111");
+  });
+
+  it("uses configured agentId in per-phone session key", () => {
+    const config = resolveVoiceCallConfig({
+      enabled: true,
+      provider: "mock",
+      agentId: "reception",
+    });
+
+    expect(
+      resolveVoiceCallSessionKey({
+        config,
+        callId: "call-123",
+        phone: "+1 (555) 000-1111",
+      }),
+    ).toBe("agent:reception:voice:15550001111");
   });
 
   it("can scope voice sessions to each call", () => {
@@ -287,7 +303,7 @@ describe("resolveVoiceCallConfig session routing", () => {
         callId: "call-123",
         phone: "+1 (555) 000-1111",
       }),
-    ).toBe("voice:call:call-123");
+    ).toBe("agent:main:voice:call:call-123");
   });
 
   it("preserves explicit voice session keys", () => {
diff --git a/extensions/voice-call/src/config.ts b/extensions/voice-call/src/config.ts
@@ -717,7 +717,7 @@ export function normalizeVoiceCallConfig(config: VoiceCallConfigInput): VoiceCal
 }
 
 export function resolveVoiceCallSessionKey(params: {
-  config: Pick<VoiceCallConfig, "sessionScope">;
+  config: Pick<VoiceCallConfig, "sessionScope" | "agentId">;
   callId: string;
   phone?: string;
   explicitSessionKey?: string;
@@ -726,11 +726,14 @@ export function resolveVoiceCallSessionKey(params: {
   if (explicit) {
     return explicit;
   }
+  const agentId = params.config.agentId ?? "main";
   if (params.config.sessionScope === "per-call") {
-    return `voice:call:${params.callId}`;
+    return `agent:${agentId}:voice:call:${params.callId}`;
   }
   const normalizedPhone = params.phone?.replace(/\D/g, "");
-  return normalizedPhone ? `voice:${normalizedPhone}` : `voice:${params.callId}`;
+  return normalizedPhone
+    ? `agent:${agentId}:voice:${normalizedPhone}`
+    : `agent:${agentId}:voice:${params.callId}`;
 }
 
 /**

Original file line number	Diff line number	Diff line change
`@@ -717,7 +717,7 @@ export function normalizeVoiceCallConfig(config: VoiceCallConfigInput): VoiceCal`
`717`	`717`	`}`
`718`	`718`
`719`	`719`	`export function resolveVoiceCallSessionKey(params: {`
`720`		`- config: Pick<VoiceCallConfig, "sessionScope">;`
	`720`	`+ config: Pick<VoiceCallConfig, "sessionScope" \| "agentId">;`
`721`	`721`	`callId: string;`
`722`	`722`	`phone?: string;`
`723`	`723`	`explicitSessionKey?: string;`
`@@ -726,11 +726,14 @@ export function resolveVoiceCallSessionKey(params: {`
`726`	`726`	`if (explicit) {`
`727`	`727`	`return explicit;`
`728`	`728`	`}`
	`729`	`+ const agentId = params.config.agentId ?? "main";`
`729`	`730`	`if (params.config.sessionScope === "per-call") {`
`730`		- return `voice:call:${params.callId}`;
	`731`	+ return `agent:${agentId}:voice:call:${params.callId}`;
`731`	`732`	`}`
`732`	`733`	`const normalizedPhone = params.phone?.replace(/\D/g, "");`
`733`		- return normalizedPhone ? `voice:${normalizedPhone}` : `voice:${params.callId}`;
	`734`	`+ return normalizedPhone`
	`735`	+ ? `agent:${agentId}:voice:${normalizedPhone}`
	`736`	+ : `agent:${agentId}:voice:${params.callId}`;
`734`	`737`	`}`
`735`	`738`
`736`	`739`	`/**`