@voicethere/agent 0.5.5 → 0.6.0

package/dist/templates/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/templates/registry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,KAAK,CAAC;AAE7C,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,YAAY,CAAC;IACnB,mFAAmF;IACnF,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,eAAe,EAAE,SAAS,uBAAuB,EAgHpD,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAMrE,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,eAAe,CAEnE;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,CAMnE;AAED,wBAAgB,yBAAyB,IAAI,uBAAuB,EAAE,CAErE"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/templates/registry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,KAAK,CAAC;AAE7C,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,YAAY,CAAC;IACnB,mFAAmF;IACnF,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,eAAe,EAAE,SAAS,uBAAuB,EA6HpD,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAMrE,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,eAAe,CAEnE;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,CAMnE;AAED,wBAAgB,yBAAyB,IAAI,uBAAuB,EAAE,CAErE"}

package/dist/templates/registry.js

@@ -46,11 +46,23 @@ export const AGENT_TEMPLATES = [
         sourceFiles: [
             "voice-showcase/agent.ts",
             "voice-showcase/conversation.ts",
+            "voice-showcase/delivery.ts",
             "voice-showcase/weather.ts",
             "voice-showcase/recipes.ts",
             "voice-showcase/fun-facts.ts",
         ],
     },
+    {
+        id: "recording-consent",
+        entry: "recording-consent/agent.ts",
+        kind: "product",
+        seedOnCreate: true,
+        description: "Recording consent flow — ask consent, pause capture for PII, resume when allowed.",
+        sourceFiles: [
+            "recording-consent/agent.ts",
+            "recording-consent/conversation.ts",
+        ],
+    },
     {
         id: "webhooks",
         entry: "webhooks.ts",

package/dist/templates/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/templates/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/templates/registry.ts"],"names":[],"mappings":"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"}

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

@@ -191,6 +191,7 @@ function parseDataChannelPayload(raw) {
   }
 }
 var peerEnvBySessionId = /* @__PURE__ */ new Map();
+var recordingAvailableBySessionId = /* @__PURE__ */ new Map();
 var endedSessionIds = /* @__PURE__ */ new Set();
 var pendingRecordingAcks = /* @__PURE__ */ new Map();
 function handleRecordingControlAck(message) {
@@ -340,6 +341,7 @@ async function handleParentMessage(message, handlers) {
     case "session_start":
       endedSessionIds.delete(message.sessionId);
       peerEnvBySessionId.set(message.sessionId, message.env);
+      recordingAvailableBySessionId.set(message.sessionId, message.recordingAvailable ?? false);
       const sessionStartInitDelayMs = resolveSessionStartInitDelayMs();
       if (sessionStartInitDelayMs > 0) {
         await new Promise((resolve) => setTimeout(resolve, sessionStartInitDelayMs));
@@ -384,6 +386,7 @@ async function handleParentMessage(message, handlers) {
     case "session_end":
       clearPendingRecordingAcksForSession(message.sessionId, "session_ended");
       peerEnvBySessionId.delete(message.sessionId);
+      recordingAvailableBySessionId.delete(message.sessionId);
       await (handlers.onClientLeave ?? handlers.onSessionEnd)?.({
         sessionId: message.sessionId
       });
@@ -1314,6 +1317,36 @@ async function resolveWeatherTurn(state, city, country, fetchFn) {
   }
 }
 
+// templates/voice-showcase/delivery.ts
+function spokenThenPlayOps(messages, speakLines) {
+  const ops = [];
+  for (const message of messages) {
+    ops.push({ kind: "send", message });
+  }
+  for (const text of speakLines) {
+    ops.push({ kind: "play", text });
+  }
+  return ops;
+}
+function greetingOps(sessionId, greeting) {
+  return spokenThenPlayOps(
+    [
+      { type: "agent_event", event: "session_start", sessionId },
+      { type: "chat_reply", text: greeting }
+    ],
+    [greeting]
+  );
+}
+function applyOutboundOps(sessionId, ops, deps) {
+  for (const op of ops) {
+    if (op.kind === "send") {
+      deps.sendToClient(sessionId, op.message);
+    } else {
+      deps.speak(sessionId, op.text);
+    }
+  }
+}
+
 // templates/voice-showcase/agent.ts
 var sessions = /* @__PURE__ */ new Map();
 function getState(sessionId) {
@@ -1332,20 +1365,16 @@ function relaySpeechEvent(sessionId, event) {
     raw: event
   });
 }
-function deliverMessages(sessionId, messages) {
-  for (const message of messages) {
-    sendToClient(sessionId, message);
-  }
-}
-function speakLines(sessionId, lines) {
-  for (const line of lines) {
-    speak(sessionId, line);
-  }
+function deliverSpokenThenPlay(sessionId, result) {
+  applyOutboundOps(
+    sessionId,
+    spokenThenPlayOps(result.messages, result.speakLines),
+    { sendToClient, speak }
+  );
 }
 async function applyTurn(sessionId, result) {
   sessions.set(sessionId, result.state);
-  speakLines(sessionId, result.speakLines);
-  deliverMessages(sessionId, result.messages);
+  deliverSpokenThenPlay(sessionId, result);
   if (result.pendingWeather) {
     const weatherResult = await resolveWeatherTurn(
       result.state,
@@ -1353,8 +1382,7 @@ async function applyTurn(sessionId, result) {
       result.pendingWeather.country
     );
     sessions.set(sessionId, weatherResult.state);
-    speakLines(sessionId, weatherResult.speakLines);
-    deliverMessages(sessionId, weatherResult.messages);
+    deliverSpokenThenPlay(sessionId, weatherResult);
   }
 }
 async function onUserText(sessionId, text) {
@@ -1365,13 +1393,10 @@ async function onUserText(sessionId, text) {
 defineAgent({
   onSessionStart({ sessionId }) {
     sessions.set(sessionId, createInitialState());
-    sendToClient(sessionId, {
-      type: "agent_event",
-      event: "session_start",
-      sessionId
+    applyOutboundOps(sessionId, greetingOps(sessionId, GREETING), {
+      sendToClient,
+      speak
     });
-    speak(sessionId, GREETING);
-    sendToClient(sessionId, { type: "chat_reply", text: GREETING });
     agentLog("info", `voice-showcase session_start ${sessionId}`);
   },
   onSpeechEvent({ sessionId }, event) {

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

@@ -191,6 +191,7 @@ function parseDataChannelPayload(raw) {
   }
 }
 var peerEnvBySessionId = /* @__PURE__ */ new Map();
+var recordingAvailableBySessionId = /* @__PURE__ */ new Map();
 var endedSessionIds = /* @__PURE__ */ new Set();
 var pendingRecordingAcks = /* @__PURE__ */ new Map();
 function handleRecordingControlAck(message) {
@@ -340,6 +341,7 @@ async function handleParentMessage(message, handlers) {
     case "session_start":
       endedSessionIds.delete(message.sessionId);
       peerEnvBySessionId.set(message.sessionId, message.env);
+      recordingAvailableBySessionId.set(message.sessionId, message.recordingAvailable ?? false);
       const sessionStartInitDelayMs = resolveSessionStartInitDelayMs();
       if (sessionStartInitDelayMs > 0) {
         await new Promise((resolve) => setTimeout(resolve, sessionStartInitDelayMs));
@@ -384,6 +386,7 @@ async function handleParentMessage(message, handlers) {
     case "session_end":
       clearPendingRecordingAcksForSession(message.sessionId, "session_ended");
       peerEnvBySessionId.delete(message.sessionId);
+      recordingAvailableBySessionId.delete(message.sessionId);
       await (handlers.onClientLeave ?? handlers.onSessionEnd)?.({
         sessionId: message.sessionId
       });

package/dist/templates/webhooks/agent.js

@@ -194,6 +194,7 @@ function parseDataChannelPayload(raw) {
   }
 }
 var peerEnvBySessionId = /* @__PURE__ */ new Map();
+var recordingAvailableBySessionId = /* @__PURE__ */ new Map();
 var endedSessionIds = /* @__PURE__ */ new Set();
 var pendingRecordingAcks = /* @__PURE__ */ new Map();
 function handleRecordingControlAck(message) {
@@ -343,6 +344,7 @@ async function handleParentMessage(message, handlers) {
     case "session_start":
       endedSessionIds.delete(message.sessionId);
       peerEnvBySessionId.set(message.sessionId, message.env);
+      recordingAvailableBySessionId.set(message.sessionId, message.recordingAvailable ?? false);
       const sessionStartInitDelayMs = resolveSessionStartInitDelayMs();
       if (sessionStartInitDelayMs > 0) {
         await new Promise((resolve) => setTimeout(resolve, sessionStartInitDelayMs));
@@ -387,6 +389,7 @@ async function handleParentMessage(message, handlers) {
     case "session_end":
       clearPendingRecordingAcksForSession(message.sessionId, "session_ended");
       peerEnvBySessionId.delete(message.sessionId);
+      recordingAvailableBySessionId.delete(message.sessionId);
       await (handlers.onClientLeave ?? handlers.onSessionEnd)?.({
         sessionId: message.sessionId
       });

package/dist/templates/webhooks-redis/agent.js

@@ -10946,6 +10946,7 @@ function parseDataChannelPayload(raw) {
   }
 }
 var peerEnvBySessionId = /* @__PURE__ */ new Map();
+var recordingAvailableBySessionId = /* @__PURE__ */ new Map();
 var endedSessionIds = /* @__PURE__ */ new Set();
 var pendingRecordingAcks = /* @__PURE__ */ new Map();
 function handleRecordingControlAck(message) {
@@ -11095,6 +11096,7 @@ async function handleParentMessage(message, handlers) {
     case "session_start":
       endedSessionIds.delete(message.sessionId);
       peerEnvBySessionId.set(message.sessionId, message.env);
+      recordingAvailableBySessionId.set(message.sessionId, message.recordingAvailable ?? false);
       const sessionStartInitDelayMs = resolveSessionStartInitDelayMs();
       if (sessionStartInitDelayMs > 0) {
         await new Promise((resolve) => setTimeout(resolve, sessionStartInitDelayMs));
@@ -11139,6 +11141,7 @@ async function handleParentMessage(message, handlers) {
     case "session_end":
       clearPendingRecordingAcksForSession(message.sessionId, "session_ended");
       peerEnvBySessionId.delete(message.sessionId);
+      recordingAvailableBySessionId.delete(message.sessionId);
       await (handlers.onClientLeave ?? handlers.onSessionEnd)?.({
         sessionId: message.sessionId
       });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voicethere/agent",
-  "version": "0.5.5",
+  "version": "0.6.0",
   "description": "VoiceThere customer agent SDK — IPC types and runtime helpers for sandboxed child bundles",
   "type": "module",
   "exports": {
@@ -28,6 +28,12 @@
       "require": "./dist/templates/index.js",
       "default": "./dist/templates/index.js"
     },
+    "./build": {
+      "types": "./dist/build-bundle.d.ts",
+      "import": "./dist/build-bundle.js",
+      "require": "./dist/build-bundle.js",
+      "default": "./dist/build-bundle.js"
+    },
     "./templates/redis-sync/world-layout": {
       "types": "./templates/redis-sync/world-layout.ts",
       "import": "./templates/redis-sync/world-layout.ts",

package/templates/README.md

@@ -15,10 +15,10 @@ import {
 
 ## Product vs e2e
 
-| Kind        | Dashboard create                                                                                      | Prebuilt seed bundle                 | Typical consumer        |
-| ----------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------ | ----------------------- |
-| **product** | Yes (`echo`, `echo-dc`, `voice-starter`, `game-sync`, `voice-showcase`, `webhooks`, `webhooks-redis`) | Yes — `dist/templates/<id>/agent.js` | Platform project create |
-| **e2e**     | No                                                                                                    | No — build from sources at test time | `voicethere/e2e` smokes |
+| Kind        | Dashboard create                                                                                                           | Prebuilt seed bundle                 | Typical consumer        |
+| ----------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | ----------------------- |
+| **product** | Yes (`echo`, `echo-dc`, `voice-starter`, `game-sync`, `voice-showcase`, `recording-consent`, `webhooks`, `webhooks-redis`) | Yes — `dist/templates/<id>/agent.js` | Platform project create |
+| **e2e**     | No                                                                                                                         | No — build from sources at test time | `voicethere/e2e` smokes |
 
 Product templates always set `seedOnCreate: true`. CI fails if a product template is missing its prebuilt bundle after `npm run build`.
 
@@ -63,9 +63,15 @@ When `AGENT_REDIS_URL` is set (project Redis), the world blob is stored at `game
 
 ### `voice-showcase/` (`voice-showcase`)
 
-Conversational voice demo for landing and dashboard previews — greets the user, asks for a name, then offers a menu: weather (Open-Meteo, no API key), count 1–10, short recipes, and rotating fun facts. Typed chat and voice finals share the same handler. Sends structured `menu` payloads plus `chat_reply` for the chat log.
+Conversational voice demo for landing and dashboard previews — greets the user, asks for a name, then offers a menu: weather (Open-Meteo, no API key), count 1–10, short recipes, and rotating fun facts. Typed chat and voice finals share the same handler. Sends structured `menu` payloads plus `chat_reply` for the chat log, then triggers TTS play so the client has the spoken text before audio starts.
 
-Sources: `voice-showcase/agent.ts` (defineAgent wiring), `conversation.ts` (pure state machine), `weather.ts`, `recipes.ts`, `fun-facts.ts`.
+Sources: `voice-showcase/agent.ts` (defineAgent wiring), `conversation.ts` (pure state machine), `delivery.ts` (send-then-play order), `weather.ts`, `recipes.ts`, `fun-facts.ts`.
+
+### `recording-consent/` (`recording-consent`)
+
+Demonstrates conversation recording consent on connect: asks whether recording is OK when the project has recording enabled, pauses capture while collecting name and date of birth, then resumes only if the customer consented. When project recording is off, logs a warning and never calls `startRecording`. Voice finals and typed chat share the same handler.
+
+Sources: `recording-consent/agent.ts` (defineAgent wiring), `conversation.ts` (pure state machine).
 
 ### `webhooks.ts` (`webhooks`)
 

package/templates/game-sync-world-layout.ts

@@ -162,6 +162,51 @@ export function collectActiveObjectIds(world: Float32Array): number[] {
   return ids;
 }
 
+export interface LiveWorldObjectInfo {
+  objectId: number;
+  ownerSessionId: string;
+}
+
+/** Snapshot occupancy from live world slots; ownerSessionId from map or empty string. */
+export function liveWorldSnapshot(
+  world: Float32Array,
+  owners: ReadonlyMap<number, string>,
+): LiveWorldObjectInfo[] {
+  const ids = collectActiveObjectIds(world);
+  ids.sort((a, b) => a - b);
+  return ids.map((objectId) => ({
+    objectId,
+    ownerSessionId: owners.get(objectId) ?? "",
+  }));
+}
+
+export function planRedisSimTick(options: {
+  lockAcquired: boolean;
+  connectedSessions: ReadonlySet<string>;
+}): "simulate" | "relay" | "noop" {
+  if (options.lockAcquired) {
+    return "simulate";
+  }
+  if (options.connectedSessions.size > 0) {
+    return "relay";
+  }
+  return "noop";
+}
+
+/** Finite positive elapsed seconds, clamped to [1/fallbackHz, 0.05]. */
+export function clampSimulationDtSec(
+  elapsedMs: number,
+  fallbackHz: number,
+): number {
+  const minDt = 1 / fallbackHz;
+  const maxDt = 0.05;
+  if (!Number.isFinite(elapsedMs) || elapsedMs <= 0) {
+    return minDt;
+  }
+  const elapsedSec = elapsedMs / 1000;
+  return Math.min(maxDt, Math.max(minDt, elapsedSec));
+}
+
 /**
  * Decode a Redis / Node Buffer into a fixed-size world Float32Array.
  */

package/templates/game-sync.ts

@@ -61,15 +61,17 @@ import {
   simulateWorldStep,
 } from "./game-sync-sim.js";
 import {
+  clampSimulationDtSec,
   collectActiveObjectIds,
-  commitSimulatedWorld,
   countLiveObjects,
   createEmptyWorldBuffer,
   findFirstEmptySlot,
+  liveWorldSnapshot,
   markSlotFree,
   normalizeWorldBuffer,
   objectIdToSlot,
   OBJECT_SLOT_BYTE_LENGTH,
+  planRedisSimTick,
   REDIS_SIM_LOCK_KEY,
   REDIS_WORLD_KEY,
   slotToObjectId,
@@ -92,6 +94,7 @@ let worldState = createEmptyWorldBuffer();
 let redis: Redis | null = null;
 let broadcastTimer: NodeJS.Timeout | null = null;
 let worldMutationChain: Promise<void> = Promise.resolve();
+let lastTickTimeMs = 0;
 
 function withWorldMutation<T>(fn: () => Promise<T>): Promise<T> {
   const run = worldMutationChain.then(fn);
@@ -140,11 +143,6 @@ async function withRedisSimLock<T>(
   }
 }
 
-interface TrackedObjectInfo {
-  objectId: number;
-  ownerSessionId: string;
-}
-
 function rand(min: number, max: number): number {
   return min + Math.random() * (max - min);
 }
@@ -315,13 +313,11 @@ async function unregisterObject(
   return { ok: true, objectId: target.objectId };
 }
 
-function trackedObjectsSnapshot(): TrackedObjectInfo[] {
-  const objects: TrackedObjectInfo[] = [];
-  for (const [objectId, ownerSessionId] of objectOwners) {
-    objects.push({ objectId, ownerSessionId });
+function broadcastWorldSnapshot(): void {
+  const objects = liveWorldSnapshot(worldState, objectOwners);
+  for (const sessionId of connectedSessions) {
+    sendToClient(sessionId, { type: "world_snapshot", objects });
   }
-  objects.sort((a, b) => a.objectId - b.objectId);
-  return objects;
 }
 
 function notifyObjectRegistered(
@@ -375,33 +371,47 @@ async function saveWorldToRedis(world: Float32Array): Promise<void> {
 }
 
 async function runSimulationTick(): Promise<void> {
+  const now = Date.now();
+  const dt = clampSimulationDtSec(
+    lastTickTimeMs === 0 ? 0 : now - lastTickTimeMs,
+    BROADCAST_HZ,
+  );
+  lastTickTimeMs = now;
+
   if (!redis) {
     await withWorldMutation(async () => {
-      const activeObjectIds = [...objectOwners.keys()];
-      simulateWorldStep(worldState, 1 / BROADCAST_HZ, activeObjectIds);
+      simulateWorldStep(worldState, dt, collectActiveObjectIds(worldState));
     });
     broadcastWorldBuffer(worldState);
     return;
   }
 
   await withWorldMutation(async () => {
-    await withRedisSimLock(
+    const lockResult = await withRedisSimLock(
       async () => {
         const world = await loadWorldFromRedis();
         const activeObjectIds = collectActiveObjectIds(world);
-        simulateWorldStep(world, 1 / BROADCAST_HZ, activeObjectIds);
-        const latestRedis = await loadWorldFromRedis();
-        commitSimulatedWorld(world, latestRedis);
+        simulateWorldStep(world, dt, activeObjectIds);
         await saveWorldToRedis(world);
         worldState = world;
+        broadcastWorldBuffer(world);
+        return true;
       },
       { retryUntilAcquired: false },
     );
-  });
 
-  const world = await loadWorldFromRedis();
-  worldState = world;
-  broadcastWorldBuffer(world);
+    if (lockResult === null) {
+      const plan = planRedisSimTick({
+        lockAcquired: false,
+        connectedSessions,
+      });
+      if (plan === "relay") {
+        const world = await loadWorldFromRedis();
+        worldState = world;
+        broadcastWorldBuffer(world);
+      }
+    }
+  });
 }
 
 function startBroadcastLoopIfNeeded(): void {
@@ -466,12 +476,15 @@ defineAgent({
     agentLog("info", "game-sync agent connected to project Redis world buffer");
   },
 
-  onClientJoin({ sessionId }) {
+  async onClientJoin({ sessionId }) {
     connectedSessions.add(sessionId);
     startBroadcastLoopIfNeeded();
+    if (redis) {
+      worldState = await loadWorldFromRedis();
+    }
     sendToClient(sessionId, {
       type: "world_snapshot",
-      objects: trackedObjectsSnapshot(),
+      objects: liveWorldSnapshot(worldState, objectOwners),
     });
     agentLog("info", `join ${sessionId} connected=${connectedSessions.size}`);
   },
@@ -516,6 +529,7 @@ defineAgent({
       }
       sendToClient(ctx.sessionId, { type: "register_ack", objectId });
       notifyObjectRegistered(objectId, ctx.sessionId);
+      broadcastWorldSnapshot();
       agentLog(
         "info",
         `register session=${ctx.sessionId} objectId=${objectId}`,
@@ -541,6 +555,7 @@ defineAgent({
         type: "unregister_ack",
         objectId: result.objectId,
       });
+      broadcastWorldSnapshot();
       agentLog(
         "info",
         `unregister_ack session=${ctx.sessionId} objectId=${result.objectId}`,

package/templates/recording-consent/agent.ts

@@ -0,0 +1,162 @@
+/**
+ * Recording consent template — ask consent, pause for PII, resume when allowed.
+ *
+ * Build:
+ *   npx @voicethere/agent build --entry templates/recording-consent/agent.ts
+ */
+import {
+  agentLog,
+  defineAgent,
+  parseChatText,
+  pauseRecording,
+  resumeRecording,
+  sendToClient,
+  speak,
+  stopRecording,
+  type SpeechEvent,
+} from "@voicethere/agent";
+
+import {
+  beginSession,
+  handleUtterance,
+  type ConversationState,
+  type ConversationTurnResult,
+  type OutboundMessage,
+  type RecordingAction,
+} from "./conversation.js";
+
+let sessions = new Map<string, ConversationState>();
+/** Per-session consent flag (shared-child safe — not one process-wide boolean). */
+let consentBySessionId = new Map<string, boolean>();
+
+function getState(sessionId: string): ConversationState {
+  const state = sessions.get(sessionId);
+  if (!state) {
+    throw new Error(
+      `recording-consent: missing session state for ${sessionId}`,
+    );
+  }
+  return state;
+}
+
+function relaySpeechEvent(sessionId: string, event: SpeechEvent): void {
+  sendToClient(sessionId, {
+    type: "agent_event",
+    event: event.type,
+    text: event.text,
+    raw: event,
+  });
+}
+
+function deliverMessages(sessionId: string, messages: OutboundMessage[]): void {
+  for (const message of messages) {
+    sendToClient(sessionId, message);
+  }
+}
+
+function speakLines(sessionId: string, lines: string[]): void {
+  for (const line of lines) {
+    speak(sessionId, line);
+  }
+}
+
+async function applyRecordingAction(
+  sessionId: string,
+  action: RecordingAction,
+): Promise<void> {
+  if (!action) return;
+  switch (action) {
+    case "pause":
+      await pauseRecording(sessionId);
+      break;
+    case "stop":
+      await stopRecording(sessionId);
+      break;
+    case "start":
+    case "resume":
+      await resumeRecording(sessionId);
+      break;
+  }
+}
+
+async function applyTurn(
+  sessionId: string,
+  result: ConversationTurnResult,
+): Promise<void> {
+  sessions.set(sessionId, result.state);
+  if (result.state.consent !== undefined) {
+    consentBySessionId.set(sessionId, result.state.consent);
+  }
+  if (result.warnRecordingDisabled) {
+    agentLog(
+      "warn",
+      "Project conversation recording is disabled; skipping consent and will not call startRecording",
+      sessionId,
+    );
+  }
+  speakLines(sessionId, result.speakLines);
+  deliverMessages(sessionId, result.messages);
+  await applyRecordingAction(sessionId, result.recordingAction);
+}
+
+async function onUserText(sessionId: string, text: string): Promise<void> {
+  const state = getState(sessionId);
+  const result = handleUtterance(state, text);
+  await applyTurn(sessionId, result);
+}
+
+defineAgent({
+  onAgentStart() {
+    sessions = new Map();
+    consentBySessionId = new Map();
+  },
+
+  onSessionStart({ sessionId, recordingAvailable }) {
+    const result = beginSession(recordingAvailable);
+    sessions.set(sessionId, result.state);
+    if (result.warnRecordingDisabled) {
+      agentLog(
+        "warn",
+        "Project conversation recording is disabled; skipping consent and will not call startRecording",
+        sessionId,
+      );
+    }
+    speakLines(sessionId, result.speakLines);
+    deliverMessages(sessionId, result.messages);
+    sendToClient(sessionId, {
+      type: "agent_event",
+      event: "session_start",
+      sessionId,
+    });
+    agentLog(
+      "info",
+      `recording-consent session_start ${sessionId} recordingAvailable=${recordingAvailable}`,
+      sessionId,
+    );
+  },
+
+  onSpeechEvent({ sessionId }, event: SpeechEvent) {
+    relaySpeechEvent(sessionId, event);
+  },
+
+  onUserSpeechFinal({ sessionId, text }) {
+    void onUserText(sessionId, text);
+  },
+
+  onDataChannelMessage(ctx) {
+    const text = parseChatText(ctx.message);
+    if (!text) return;
+    void onUserText(ctx.sessionId, text);
+  },
+
+  onSessionEnd({ sessionId }) {
+    sessions.delete(sessionId);
+    consentBySessionId.delete(sessionId);
+    sendToClient(sessionId, {
+      type: "agent_event",
+      event: "session_end",
+      sessionId,
+    });
+    agentLog("info", `recording-consent session_end ${sessionId}`, sessionId);
+  },
+});