@voicethere/agent 0.8.0 → 0.8.2

package/dist/templates/voice-showcase/agent.js

@@ -160,6 +160,12 @@ function isRecordingControlAckMessage(value) {
   const msg = value;
   return msg.type === "recording_control_ack" && typeof msg.requestId === "string";
 }
+function isConversationHistoryControlAckMessage(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const msg = value;
+  return msg.type === "conversation_history_control_ack" && typeof msg.requestId === "string";
+}
 function isMixControlAckMessage(value) {
   if (!value || typeof value !== "object")
     return false;
@@ -214,7 +220,7 @@ function isParentMessage(value) {
   if (!value || typeof value !== "object")
     return false;
   const msg = value;
-  return msg.type === "session_start" || msg.type === "speech_event" || msg.type === "session_end" || msg.type === "data_channel_message" || msg.type === "data_channel_binary" || msg.type === "idle_timeout" || msg.type === "recording_control_ack" || msg.type === "play_ack" || msg.type === "play_status_ack" || msg.type === "play_stop_ack" || msg.type === "play_pose_ack" || msg.type === "mix_control_ack" || msg.type === "stt_control_ack" || msg.type === "webhook";
+  return msg.type === "session_start" || msg.type === "speech_event" || msg.type === "session_end" || msg.type === "data_channel_message" || msg.type === "data_channel_binary" || msg.type === "idle_timeout" || msg.type === "recording_control_ack" || msg.type === "conversation_history_control_ack" || msg.type === "play_ack" || msg.type === "play_status_ack" || msg.type === "play_stop_ack" || msg.type === "play_pose_ack" || msg.type === "mix_control_ack" || msg.type === "stt_control_ack" || msg.type === "webhook";
 }
 function isSessionScopedParentMessage(value) {
   return isParentMessage(value) && !isWebhookMessage(value);
@@ -228,11 +234,13 @@ function parseDataChannelPayload(raw) {
 }
 var peerEnvBySessionId = /* @__PURE__ */ new Map();
 var recordingAvailableBySessionId = /* @__PURE__ */ new Map();
+var conversationHistoryAvailableBySessionId = /* @__PURE__ */ new Map();
 var mixAvailableBySessionId = /* @__PURE__ */ new Map();
 var ttsPoseAvailableBySessionId = /* @__PURE__ */ new Map();
 var endedSessionIds = /* @__PURE__ */ new Set();
 var PLAY_BYTES_MAX_DECODED_LENGTH = 64 * 1024;
 var pendingRecordingAcks = /* @__PURE__ */ new Map();
+var pendingConversationHistoryAcks = /* @__PURE__ */ new Map();
 var pendingPlayAcks = /* @__PURE__ */ new Map();
 var pendingPlayStatusAcks = /* @__PURE__ */ new Map();
 var pendingPlayStopAcks = /* @__PURE__ */ new Map();
@@ -251,6 +259,18 @@ function handleRecordingControlAck(message) {
     requestId: message.requestId
   });
 }
+function handleConversationHistoryControlAck(message) {
+  const pending = pendingConversationHistoryAcks.get(message.requestId);
+  if (!pending)
+    return;
+  clearTimeout(pending.timer);
+  pendingConversationHistoryAcks.delete(message.requestId);
+  pending.resolve({
+    ok: message.ok,
+    reason: message.reason,
+    requestId: message.requestId
+  });
+}
 function handlePlayAck(message) {
   const pending = pendingPlayAcks.get(message.requestId);
   if (!pending)
@@ -338,6 +358,15 @@ function clearPendingRecordingAcksForSession(sessionId, reason) {
     pending.resolve({ ok: false, reason, requestId });
   }
 }
+function clearPendingConversationHistoryAcksForSession(sessionId, reason) {
+  for (const [requestId, pending] of pendingConversationHistoryAcks) {
+    if (pending.sessionId !== sessionId)
+      continue;
+    clearTimeout(pending.timer);
+    pendingConversationHistoryAcks.delete(requestId);
+    pending.resolve({ ok: false, reason, requestId });
+  }
+}
 var sessionExecutionContext = new AsyncLocalStorage();
 var agentLogSessionContext = new AsyncLocalStorage();
 var inboundQueueAuthority = null;
@@ -484,6 +513,7 @@ async function handleParentMessage(message, handlers) {
       endedSessionIds.delete(message.sessionId);
       peerEnvBySessionId.set(message.sessionId, message.env);
       recordingAvailableBySessionId.set(message.sessionId, message.recordingAvailable ?? false);
+      conversationHistoryAvailableBySessionId.set(message.sessionId, message.conversationHistoryAvailable ?? false);
       mixAvailableBySessionId.set(message.sessionId, message.mixAvailable ?? false);
       ttsPoseAvailableBySessionId.set(message.sessionId, message.ttsPoseAvailable ?? false);
       const sessionStartInitDelayMs = resolveSessionStartInitDelayMs();
@@ -494,6 +524,7 @@ async function handleParentMessage(message, handlers) {
         sessionId: message.sessionId,
         env: message.env,
         recordingAvailable: message.recordingAvailable ?? false,
+        conversationHistoryAvailable: message.conversationHistoryAvailable ?? false,
         mixAvailable: message.mixAvailable ?? false,
         ttsPoseAvailable: message.ttsPoseAvailable ?? false
       });
@@ -540,8 +571,10 @@ async function handleParentMessage(message, handlers) {
       break;
     case "session_end":
       clearPendingRecordingAcksForSession(message.sessionId, "session_ended");
+      clearPendingConversationHistoryAcksForSession(message.sessionId, "session_ended");
       peerEnvBySessionId.delete(message.sessionId);
       recordingAvailableBySessionId.delete(message.sessionId);
+      conversationHistoryAvailableBySessionId.delete(message.sessionId);
       mixAvailableBySessionId.delete(message.sessionId);
       ttsPoseAvailableBySessionId.delete(message.sessionId);
       await (handlers.onClientLeave ?? handlers.onSessionEnd)?.({
@@ -563,6 +596,10 @@ function defineAgent(handlers) {
       handleRecordingControlAck(message);
       return;
     }
+    if (isConversationHistoryControlAckMessage(message)) {
+      handleConversationHistoryControlAck(message);
+      return;
+    }
     if (isPlayAckMessage(message)) {
       handlePlayAck(message);
       return;
@@ -596,6 +633,7 @@ function defineAgent(handlers) {
     if (message.type === "session_end") {
       endedSessionIds.add(message.sessionId);
       clearPendingRecordingAcksForSession(message.sessionId, "session_ended");
+      clearPendingConversationHistoryAcksForSession(message.sessionId, "session_ended");
       inboundBySession.clear(message.sessionId);
     }
     if (message.type === "session_start") {
@@ -723,6 +761,19 @@ function buildIdleEnv(sessionId) {
 function speak(sessionId, text) {
   sendParentMessage({ type: "speak", sessionId, text });
 }
+function speakAndChat(sessionId, text, options) {
+  const trimmed = text.trim();
+  if (!trimmed) {
+    return;
+  }
+  const payload = { type: "chat_reply", text: trimmed };
+  if (options?.stream) {
+    payload.stream = true;
+    payload.utteranceId = options.utteranceId ?? randomUUID();
+  }
+  sendToClient(sessionId, payload);
+  speak(sessionId, trimmed);
+}
 function sendToClient(sessionId, payload) {
   sendParentMessage({ type: "send_to_client", sessionId, payload });
 }
@@ -791,6 +842,9 @@ function parseChatText(message) {
   return trimmed.length > 0 ? trimmed : null;
 }
 
+// templates/voice-showcase/conversation.ts
+import { randomUUID as randomUUID2 } from "node:crypto";
+
 // templates/voice-showcase/recipes.ts
 var RECIPES = [
   {
@@ -1134,10 +1188,11 @@ function buildMenuMessages() {
     }
   ];
 }
-function speakAndChat(text) {
+function speakAndChat2(text) {
+  const utteranceId = randomUUID2();
   return {
     speakLines: [text],
-    messages: [{ type: "chat_reply", text }]
+    messages: [{ type: "chat_reply", text, stream: true, utteranceId }]
   };
 }
 function isHumanEscalation(utterance) {
@@ -1214,15 +1269,15 @@ function transitionAfterName(state, name, declined) {
   const lines = [];
   const messages = [];
   if (declined) {
-    const decline = speakAndChat(NAME_DECLINE_REPLY);
+    const decline = speakAndChat2(NAME_DECLINE_REPLY);
     lines.push(...decline.speakLines);
     messages.push(...decline.messages);
   } else if (name) {
-    const thanks = speakAndChat(`Great, thank you ${name}`);
+    const thanks = speakAndChat2(`Great, thank you ${name}`);
     lines.push(...thanks.speakLines);
     messages.push(...thanks.messages);
   }
-  const hello = speakAndChat(helloAfterName(next));
+  const hello = speakAndChat2(helloAfterName(next));
   lines.push(...hello.speakLines);
   messages.push(...hello.messages);
   messages.push(...buildMenuMessages());
@@ -1281,7 +1336,7 @@ function formatCountingSpeech(n) {
   return parts.join(", ");
 }
 function resendMenu(state) {
-  const menu = speakAndChat("Here is the menu again.");
+  const menu = speakAndChat2("Here is the menu again.");
   return {
     state: { ...state, phase: "awaitingMenuChoice" },
     speakLines: menu.speakLines,
@@ -1289,7 +1344,7 @@ function resendMenu(state) {
   };
 }
 function returnToMenu(state, line) {
-  const spoken = speakAndChat(line);
+  const spoken = speakAndChat2(line);
   return {
     state: {
       ...state,
@@ -1309,7 +1364,7 @@ function handleUtterance(state, utterance) {
     return { state, speakLines: [], messages: [] };
   }
   if (isHumanEscalation(text)) {
-    const reply = speakAndChat(HUMAN_ESCALATION_REPLY);
+    const reply = speakAndChat2(HUMAN_ESCALATION_REPLY);
     return {
       state,
       speakLines: reply.speakLines,
@@ -1338,7 +1393,7 @@ function handleUtterance(state, utterance) {
       const choice = parseMenuChoice(text);
       if (choice === "menu") return resendMenu(state);
       if (choice === "weather") {
-        const ask = speakAndChat(
+        const ask = speakAndChat2(
           "Sure. Please tell me a city or ZIP code and the country."
         );
         return {
@@ -1354,7 +1409,7 @@ function handleUtterance(state, utterance) {
         };
       }
       if (choice === "count") {
-        const ask = speakAndChat(
+        const ask = speakAndChat2(
           "Pick a number from 1 to 10 and I will count up to it."
         );
         return {
@@ -1368,7 +1423,7 @@ function handleUtterance(state, utterance) {
         };
       }
       if (choice === "recipe") {
-        const ask = speakAndChat(
+        const ask = speakAndChat2(
           "What do you fancy? Try pasta, soup, breakfast, cookies, or salad."
         );
         return {
@@ -1381,7 +1436,7 @@ function handleUtterance(state, utterance) {
         const fact = pickFunFact();
         return returnToMenu(state, `Here is a fun fact. ${fact}`);
       }
-      const retry = speakAndChat(
+      const retry = speakAndChat2(
         "I did not catch that. Pick 1 through 4 from the menu, or say weather, count, recipe, or fun fact."
       );
       return {
@@ -1402,7 +1457,7 @@ function handleUtterance(state, utterance) {
         }
       }
       if (!city) {
-        const ask = speakAndChat(
+        const ask = speakAndChat2(
           "Please tell me a city or ZIP code and the country."
         );
         return {
@@ -1412,16 +1467,15 @@ function handleUtterance(state, utterance) {
         };
       }
       if (!country) {
+        const ask = speakAndChat2("Got it. Which country is that in?");
         return {
           state: {
             ...state,
             phase: "weatherAwaitingLocation",
             weatherCity: city
           },
-          speakLines: ["Got it. Which country is that in?"],
-          messages: [
-            { type: "chat_reply", text: "Got it. Which country is that in?" }
-          ]
+          speakLines: ask.speakLines,
+          messages: ask.messages
         };
       }
       return {
@@ -1438,7 +1492,7 @@ function handleUtterance(state, utterance) {
         if (failures >= 2) {
           return returnToMenu(state, "Sorry, I cannot do this.");
         }
-        const retry = speakAndChat(
+        const retry = speakAndChat2(
           "I did not understand you. Please say a number from 1 to 10."
         );
         return {
@@ -1471,7 +1525,7 @@ function applyWeatherFailure(state) {
       "Sorry, I could not look up the weather right now."
     );
   }
-  const retry = speakAndChat(
+  const retry = speakAndChat2(
     "I could not find that location. Please try again with a city or ZIP and country."
   );
   return {
@@ -1499,6 +1553,7 @@ async function resolveWeatherTurn(state, city, country, fetchFn) {
 }
 
 // templates/voice-showcase/delivery.ts
+import { randomUUID as randomUUID3 } from "node:crypto";
 function spokenThenPlayOps(messages, speakLines) {
   const ops = [];
   for (const message of messages) {
@@ -1510,21 +1565,42 @@ function spokenThenPlayOps(messages, speakLines) {
   return ops;
 }
 function greetingOps(sessionId, greeting) {
+  const utteranceId = randomUUID3();
   return spokenThenPlayOps(
     [
       { type: "agent_event", event: "session_start", sessionId },
-      { type: "chat_reply", text: greeting }
+      {
+        type: "chat_reply",
+        text: greeting,
+        stream: true,
+        utteranceId
+      }
     ],
     [greeting]
   );
 }
 function applyOutboundOps(sessionId, ops, deps) {
+  const spokenViaSpeakAndChat = /* @__PURE__ */ new Set();
   for (const op of ops) {
     if (op.kind === "send") {
-      deps.sendToClient(sessionId, op.message);
-    } else {
-      deps.speak(sessionId, op.text);
+      const message = op.message;
+      if (message.type === "chat_reply" && message.stream === true && message.text?.trim()) {
+        const text = message.text.trim();
+        deps.speakAndChat(sessionId, text, {
+          stream: true,
+          utteranceId: message.utteranceId
+        });
+        spokenViaSpeakAndChat.add(text);
+      } else {
+        deps.sendToClient(sessionId, message);
+      }
+      continue;
+    }
+    const playText = op.text.trim();
+    if (spokenViaSpeakAndChat.has(playText)) {
+      continue;
     }
+    deps.speak(sessionId, op.text);
   }
 }
 
@@ -1550,7 +1626,7 @@ function deliverSpokenThenPlay(sessionId, result) {
   applyOutboundOps(
     sessionId,
     spokenThenPlayOps(result.messages, result.speakLines),
-    { sendToClient, speak }
+    { sendToClient, speak, speakAndChat }
   );
 }
 async function applyTurn(sessionId, result) {
@@ -1576,7 +1652,8 @@ defineAgent({
     sessions.set(sessionId, createInitialState());
     applyOutboundOps(sessionId, greetingOps(sessionId, GREETING), {
       sendToClient,
-      speak
+      speak,
+      speakAndChat
     });
     agentLog("info", `voice-showcase session_start ${sessionId}`);
   },

package/dist/templates/voice-starter/agent.js

@@ -160,6 +160,12 @@ function isRecordingControlAckMessage(value) {
   const msg = value;
   return msg.type === "recording_control_ack" && typeof msg.requestId === "string";
 }
+function isConversationHistoryControlAckMessage(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const msg = value;
+  return msg.type === "conversation_history_control_ack" && typeof msg.requestId === "string";
+}
 function isMixControlAckMessage(value) {
   if (!value || typeof value !== "object")
     return false;
@@ -214,7 +220,7 @@ function isParentMessage(value) {
   if (!value || typeof value !== "object")
     return false;
   const msg = value;
-  return msg.type === "session_start" || msg.type === "speech_event" || msg.type === "session_end" || msg.type === "data_channel_message" || msg.type === "data_channel_binary" || msg.type === "idle_timeout" || msg.type === "recording_control_ack" || msg.type === "play_ack" || msg.type === "play_status_ack" || msg.type === "play_stop_ack" || msg.type === "play_pose_ack" || msg.type === "mix_control_ack" || msg.type === "stt_control_ack" || msg.type === "webhook";
+  return msg.type === "session_start" || msg.type === "speech_event" || msg.type === "session_end" || msg.type === "data_channel_message" || msg.type === "data_channel_binary" || msg.type === "idle_timeout" || msg.type === "recording_control_ack" || msg.type === "conversation_history_control_ack" || msg.type === "play_ack" || msg.type === "play_status_ack" || msg.type === "play_stop_ack" || msg.type === "play_pose_ack" || msg.type === "mix_control_ack" || msg.type === "stt_control_ack" || msg.type === "webhook";
 }
 function isSessionScopedParentMessage(value) {
   return isParentMessage(value) && !isWebhookMessage(value);
@@ -228,11 +234,13 @@ function parseDataChannelPayload(raw) {
 }
 var peerEnvBySessionId = /* @__PURE__ */ new Map();
 var recordingAvailableBySessionId = /* @__PURE__ */ new Map();
+var conversationHistoryAvailableBySessionId = /* @__PURE__ */ new Map();
 var mixAvailableBySessionId = /* @__PURE__ */ new Map();
 var ttsPoseAvailableBySessionId = /* @__PURE__ */ new Map();
 var endedSessionIds = /* @__PURE__ */ new Set();
 var PLAY_BYTES_MAX_DECODED_LENGTH = 64 * 1024;
 var pendingRecordingAcks = /* @__PURE__ */ new Map();
+var pendingConversationHistoryAcks = /* @__PURE__ */ new Map();
 var pendingPlayAcks = /* @__PURE__ */ new Map();
 var pendingPlayStatusAcks = /* @__PURE__ */ new Map();
 var pendingPlayStopAcks = /* @__PURE__ */ new Map();
@@ -251,6 +259,18 @@ function handleRecordingControlAck(message) {
     requestId: message.requestId
   });
 }
+function handleConversationHistoryControlAck(message) {
+  const pending = pendingConversationHistoryAcks.get(message.requestId);
+  if (!pending)
+    return;
+  clearTimeout(pending.timer);
+  pendingConversationHistoryAcks.delete(message.requestId);
+  pending.resolve({
+    ok: message.ok,
+    reason: message.reason,
+    requestId: message.requestId
+  });
+}
 function handlePlayAck(message) {
   const pending = pendingPlayAcks.get(message.requestId);
   if (!pending)
@@ -338,6 +358,15 @@ function clearPendingRecordingAcksForSession(sessionId, reason) {
     pending.resolve({ ok: false, reason, requestId });
   }
 }
+function clearPendingConversationHistoryAcksForSession(sessionId, reason) {
+  for (const [requestId, pending] of pendingConversationHistoryAcks) {
+    if (pending.sessionId !== sessionId)
+      continue;
+    clearTimeout(pending.timer);
+    pendingConversationHistoryAcks.delete(requestId);
+    pending.resolve({ ok: false, reason, requestId });
+  }
+}
 var sessionExecutionContext = new AsyncLocalStorage();
 var agentLogSessionContext = new AsyncLocalStorage();
 var inboundQueueAuthority = null;
@@ -484,6 +513,7 @@ async function handleParentMessage(message, handlers) {
       endedSessionIds.delete(message.sessionId);
       peerEnvBySessionId.set(message.sessionId, message.env);
       recordingAvailableBySessionId.set(message.sessionId, message.recordingAvailable ?? false);
+      conversationHistoryAvailableBySessionId.set(message.sessionId, message.conversationHistoryAvailable ?? false);
       mixAvailableBySessionId.set(message.sessionId, message.mixAvailable ?? false);
       ttsPoseAvailableBySessionId.set(message.sessionId, message.ttsPoseAvailable ?? false);
       const sessionStartInitDelayMs = resolveSessionStartInitDelayMs();
@@ -494,6 +524,7 @@ async function handleParentMessage(message, handlers) {
         sessionId: message.sessionId,
         env: message.env,
         recordingAvailable: message.recordingAvailable ?? false,
+        conversationHistoryAvailable: message.conversationHistoryAvailable ?? false,
         mixAvailable: message.mixAvailable ?? false,
         ttsPoseAvailable: message.ttsPoseAvailable ?? false
       });
@@ -540,8 +571,10 @@ async function handleParentMessage(message, handlers) {
       break;
     case "session_end":
       clearPendingRecordingAcksForSession(message.sessionId, "session_ended");
+      clearPendingConversationHistoryAcksForSession(message.sessionId, "session_ended");
       peerEnvBySessionId.delete(message.sessionId);
       recordingAvailableBySessionId.delete(message.sessionId);
+      conversationHistoryAvailableBySessionId.delete(message.sessionId);
       mixAvailableBySessionId.delete(message.sessionId);
       ttsPoseAvailableBySessionId.delete(message.sessionId);
       await (handlers.onClientLeave ?? handlers.onSessionEnd)?.({
@@ -563,6 +596,10 @@ function defineAgent(handlers) {
       handleRecordingControlAck(message);
       return;
     }
+    if (isConversationHistoryControlAckMessage(message)) {
+      handleConversationHistoryControlAck(message);
+      return;
+    }
     if (isPlayAckMessage(message)) {
       handlePlayAck(message);
       return;
@@ -596,6 +633,7 @@ function defineAgent(handlers) {
     if (message.type === "session_end") {
       endedSessionIds.add(message.sessionId);
       clearPendingRecordingAcksForSession(message.sessionId, "session_ended");
+      clearPendingConversationHistoryAcksForSession(message.sessionId, "session_ended");
       inboundBySession.clear(message.sessionId);
     }
     if (message.type === "session_start") {

package/dist/templates/webhooks/agent.js

@@ -163,6 +163,12 @@ function isRecordingControlAckMessage(value) {
   const msg = value;
   return msg.type === "recording_control_ack" && typeof msg.requestId === "string";
 }
+function isConversationHistoryControlAckMessage(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const msg = value;
+  return msg.type === "conversation_history_control_ack" && typeof msg.requestId === "string";
+}
 function isMixControlAckMessage(value) {
   if (!value || typeof value !== "object")
     return false;
@@ -217,7 +223,7 @@ function isParentMessage(value) {
   if (!value || typeof value !== "object")
     return false;
   const msg = value;
-  return msg.type === "session_start" || msg.type === "speech_event" || msg.type === "session_end" || msg.type === "data_channel_message" || msg.type === "data_channel_binary" || msg.type === "idle_timeout" || msg.type === "recording_control_ack" || msg.type === "play_ack" || msg.type === "play_status_ack" || msg.type === "play_stop_ack" || msg.type === "play_pose_ack" || msg.type === "mix_control_ack" || msg.type === "stt_control_ack" || msg.type === "webhook";
+  return msg.type === "session_start" || msg.type === "speech_event" || msg.type === "session_end" || msg.type === "data_channel_message" || msg.type === "data_channel_binary" || msg.type === "idle_timeout" || msg.type === "recording_control_ack" || msg.type === "conversation_history_control_ack" || msg.type === "play_ack" || msg.type === "play_status_ack" || msg.type === "play_stop_ack" || msg.type === "play_pose_ack" || msg.type === "mix_control_ack" || msg.type === "stt_control_ack" || msg.type === "webhook";
 }
 function isSessionScopedParentMessage(value) {
   return isParentMessage(value) && !isWebhookMessage(value);
@@ -231,11 +237,13 @@ function parseDataChannelPayload(raw) {
 }
 var peerEnvBySessionId = /* @__PURE__ */ new Map();
 var recordingAvailableBySessionId = /* @__PURE__ */ new Map();
+var conversationHistoryAvailableBySessionId = /* @__PURE__ */ new Map();
 var mixAvailableBySessionId = /* @__PURE__ */ new Map();
 var ttsPoseAvailableBySessionId = /* @__PURE__ */ new Map();
 var endedSessionIds = /* @__PURE__ */ new Set();
 var PLAY_BYTES_MAX_DECODED_LENGTH = 64 * 1024;
 var pendingRecordingAcks = /* @__PURE__ */ new Map();
+var pendingConversationHistoryAcks = /* @__PURE__ */ new Map();
 var pendingPlayAcks = /* @__PURE__ */ new Map();
 var pendingPlayStatusAcks = /* @__PURE__ */ new Map();
 var pendingPlayStopAcks = /* @__PURE__ */ new Map();
@@ -254,6 +262,18 @@ function handleRecordingControlAck(message) {
     requestId: message.requestId
   });
 }
+function handleConversationHistoryControlAck(message) {
+  const pending = pendingConversationHistoryAcks.get(message.requestId);
+  if (!pending)
+    return;
+  clearTimeout(pending.timer);
+  pendingConversationHistoryAcks.delete(message.requestId);
+  pending.resolve({
+    ok: message.ok,
+    reason: message.reason,
+    requestId: message.requestId
+  });
+}
 function handlePlayAck(message) {
   const pending = pendingPlayAcks.get(message.requestId);
   if (!pending)
@@ -341,6 +361,15 @@ function clearPendingRecordingAcksForSession(sessionId, reason) {
     pending.resolve({ ok: false, reason, requestId });
   }
 }
+function clearPendingConversationHistoryAcksForSession(sessionId, reason) {
+  for (const [requestId, pending] of pendingConversationHistoryAcks) {
+    if (pending.sessionId !== sessionId)
+      continue;
+    clearTimeout(pending.timer);
+    pendingConversationHistoryAcks.delete(requestId);
+    pending.resolve({ ok: false, reason, requestId });
+  }
+}
 var sessionExecutionContext = new AsyncLocalStorage();
 var agentLogSessionContext = new AsyncLocalStorage();
 var inboundQueueAuthority = null;
@@ -487,6 +516,7 @@ async function handleParentMessage(message, handlers) {
       endedSessionIds.delete(message.sessionId);
       peerEnvBySessionId.set(message.sessionId, message.env);
       recordingAvailableBySessionId.set(message.sessionId, message.recordingAvailable ?? false);
+      conversationHistoryAvailableBySessionId.set(message.sessionId, message.conversationHistoryAvailable ?? false);
       mixAvailableBySessionId.set(message.sessionId, message.mixAvailable ?? false);
       ttsPoseAvailableBySessionId.set(message.sessionId, message.ttsPoseAvailable ?? false);
       const sessionStartInitDelayMs = resolveSessionStartInitDelayMs();
@@ -497,6 +527,7 @@ async function handleParentMessage(message, handlers) {
         sessionId: message.sessionId,
         env: message.env,
         recordingAvailable: message.recordingAvailable ?? false,
+        conversationHistoryAvailable: message.conversationHistoryAvailable ?? false,
         mixAvailable: message.mixAvailable ?? false,
         ttsPoseAvailable: message.ttsPoseAvailable ?? false
       });
@@ -543,8 +574,10 @@ async function handleParentMessage(message, handlers) {
       break;
     case "session_end":
       clearPendingRecordingAcksForSession(message.sessionId, "session_ended");
+      clearPendingConversationHistoryAcksForSession(message.sessionId, "session_ended");
       peerEnvBySessionId.delete(message.sessionId);
       recordingAvailableBySessionId.delete(message.sessionId);
+      conversationHistoryAvailableBySessionId.delete(message.sessionId);
       mixAvailableBySessionId.delete(message.sessionId);
       ttsPoseAvailableBySessionId.delete(message.sessionId);
       await (handlers.onClientLeave ?? handlers.onSessionEnd)?.({
@@ -566,6 +599,10 @@ function defineAgent(handlers) {
       handleRecordingControlAck(message);
       return;
     }
+    if (isConversationHistoryControlAckMessage(message)) {
+      handleConversationHistoryControlAck(message);
+      return;
+    }
     if (isPlayAckMessage(message)) {
       handlePlayAck(message);
       return;
@@ -599,6 +636,7 @@ function defineAgent(handlers) {
     if (message.type === "session_end") {
       endedSessionIds.add(message.sessionId);
       clearPendingRecordingAcksForSession(message.sessionId, "session_ended");
+      clearPendingConversationHistoryAcksForSession(message.sessionId, "session_ended");
       inboundBySession.clear(message.sessionId);
     }
     if (message.type === "session_start") {