@voicethere/agent 0.5.4 → 0.5.6

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,EA4HpD,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

@@ -51,6 +51,17 @@ export const AGENT_TEMPLATES = [
             "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
       });
@@ -669,6 +672,136 @@ function pickFunFact() {
 var GEOCODE_URL = "https://geocoding-api.open-meteo.com/v1/search";
 var FORECAST_URL = "https://api.open-meteo.com/v1/forecast";
 var FETCH_TIMEOUT_MS = 8e3;
+var DIGIT_WORDS = {
+  zero: "0",
+  oh: "0",
+  o: "0",
+  one: "1",
+  two: "2",
+  three: "3",
+  four: "4",
+  five: "5",
+  six: "6",
+  seven: "7",
+  eight: "8",
+  nine: "9"
+};
+var COUNTRY_ALIASES = {
+  thailand: "Thailand",
+  us: "United States",
+  usa: "United States",
+  america: "United States",
+  "united states": "United States",
+  "united states of america": "United States",
+  uk: "United Kingdom",
+  britain: "United Kingdom",
+  england: "United Kingdom",
+  "united kingdom": "United Kingdom",
+  "great britain": "United Kingdom",
+  germany: "Germany",
+  france: "France",
+  spain: "Spain",
+  italy: "Italy",
+  japan: "Japan",
+  china: "China",
+  india: "India",
+  australia: "Australia",
+  canada: "Canada",
+  brazil: "Brazil",
+  mexico: "Mexico",
+  netherlands: "Netherlands",
+  holland: "Netherlands",
+  "the netherlands": "Netherlands",
+  belgium: "Belgium",
+  switzerland: "Switzerland",
+  sweden: "Sweden",
+  norway: "Norway",
+  denmark: "Denmark",
+  finland: "Finland",
+  poland: "Poland",
+  portugal: "Portugal",
+  greece: "Greece",
+  turkey: "Turkey",
+  egypt: "Egypt",
+  "south africa": "South Africa",
+  "new zealand": "New Zealand",
+  ireland: "Ireland",
+  singapore: "Singapore",
+  malaysia: "Malaysia",
+  indonesia: "Indonesia",
+  vietnam: "Vietnam",
+  philippines: "Philippines",
+  "south korea": "South Korea",
+  korea: "South Korea",
+  taiwan: "Taiwan",
+  "hong kong": "Hong Kong",
+  israel: "Israel",
+  uae: "United Arab Emirates",
+  "united arab emirates": "United Arab Emirates",
+  "saudi arabia": "Saudi Arabia",
+  pakistan: "Pakistan",
+  bangladesh: "Bangladesh",
+  nigeria: "Nigeria",
+  kenya: "Kenya",
+  argentina: "Argentina",
+  chile: "Chile",
+  colombia: "Colombia",
+  peru: "Peru",
+  austria: "Austria",
+  "czech republic": "Czechia",
+  czechia: "Czechia",
+  romania: "Romania",
+  hungary: "Hungary",
+  ukraine: "Ukraine"
+};
+function matchCountryName(text) {
+  const key = text.trim().toLowerCase().replace(/[.,!?]+$/g, "").replace(/\s+/g, " ");
+  if (!key) return null;
+  return COUNTRY_ALIASES[key] ?? null;
+}
+function spokenDigitsToPostal(text) {
+  const tokens = text.toLowerCase().split(/[^a-z0-9]+/).filter(Boolean);
+  const digits = [];
+  for (const token of tokens) {
+    if (/^\d$/.test(token)) {
+      digits.push(token);
+      continue;
+    }
+    const mapped = DIGIT_WORDS[token];
+    if (mapped) {
+      digits.push(mapped);
+    }
+  }
+  if (digits.length >= 4 && digits.length <= 6) {
+    return digits.join("");
+  }
+  return null;
+}
+function splitTrailingCountry(text) {
+  const words = text.trim().split(/\s+/).filter(Boolean);
+  if (words.length < 2) return null;
+  for (let n = Math.min(3, words.length - 1); n >= 1; n -= 1) {
+    const tail = words.slice(-n).join(" ");
+    const country = matchCountryName(tail);
+    if (country) {
+      return { rest: words.slice(0, -n).join(" "), country };
+    }
+  }
+  return null;
+}
+function cityFromRemainder(rest) {
+  const trimmed = rest.trim().replace(/[.,!?;:]+$/g, "").replace(/\s+(?:in the|in|of)$/i, "").trim();
+  if (!trimmed) return null;
+  if (/^\d{4,6}(-\d{4})?$/.test(trimmed)) {
+    return trimmed;
+  }
+  const spoken = spokenDigitsToPostal(trimmed);
+  if (spoken) return spoken;
+  if (trimmed.length >= 2 && trimmed.length <= 60) {
+    return trimmed;
+  }
+  return null;
+}
 function wmoCodeToPhrase(code) {
   if (code === 0) return "clear sky";
   if (code <= 3) return "partly cloudy";
@@ -689,29 +822,48 @@ function formatWeatherSpeech(result) {
 function parseLocationUtterance(utterance) {
   const text = utterance.trim();
   if (!text) return null;
+  const countryOnly = matchCountryName(text);
+  if (countryOnly) {
+    return { country: countryOnly };
+  }
+  const trailing = splitTrailingCountry(text);
+  if (trailing) {
+    const city = cityFromRemainder(trailing.rest);
+    if (city) {
+      return { city, country: trailing.country };
+    }
+    return { country: trailing.country };
+  }
   const inMatch = text.match(
     /^(?:in\s+)?(.+?)\s+in\s+([a-zA-Z][\w\s.-]{1,40})$/i
   );
   if (inMatch) {
-    return { city: inMatch[1].trim(), country: inMatch[2].trim() };
+    const country = matchCountryName(inMatch[2]) ?? inMatch[2].trim();
+    return { city: inMatch[1].trim(), country };
   }
   const commaMatch = text.match(/^(.+?),\s*([a-zA-Z][\w\s.-]{1,40})$/);
   if (commaMatch) {
-    return { city: commaMatch[1].trim(), country: commaMatch[2].trim() };
+    const country = matchCountryName(commaMatch[2]) ?? commaMatch[2].trim();
+    return { city: commaMatch[1].trim(), country };
   }
   const countryMatch = text.match(
     /^(.+?)\s+(?:country\s+)?([a-zA-Z][\w\s.-]{2,40})$/i
   );
   if (countryMatch && countryMatch[2].split(/\s+/).length <= 3) {
     const city = countryMatch[1].trim();
-    const country = countryMatch[2].trim();
+    const countryRaw = countryMatch[2].trim();
+    const country = matchCountryName(countryRaw) ?? countryRaw;
     if (city.length >= 2 && country.length >= 2) {
       return { city, country };
     }
   }
-  if (/^\d{5}(-\d{4})?$/.test(text)) {
+  if (/^\d{4,6}(-\d{4})?$/.test(text)) {
     return { city: text };
   }
+  const spokenPostal = spokenDigitsToPostal(text);
+  if (spokenPostal) {
+    return { city: spokenPostal };
+  }
   if (text.length >= 2 && text.length <= 60) {
     return { city: text };
   }
@@ -1059,8 +1211,15 @@ function handleUtterance(state, utterance) {
     }
     case "weatherAwaitingLocation": {
       const parsed = parseLocationUtterance(text);
-      const city = parsed?.city ?? state.weatherCity;
-      const country = parsed?.country ?? state.weatherCountry;
+      let city = parsed?.city || state.weatherCity;
+      let country = parsed?.country || state.weatherCountry;
+      if (state.weatherCity && !country) {
+        const followUp = matchCountryName(text) ?? (parsed?.city ? matchCountryName(parsed.city) : null);
+        if (followUp) {
+          city = state.weatherCity;
+          country = followUp;
+        }
+      }
       if (!city) {
         const ask = speakAndChat(
           "Please tell me a city or ZIP code and the country."
@@ -1071,7 +1230,7 @@ function handleUtterance(state, utterance) {
           messages: ask.messages
         };
       }
-      if (!country && !parsed?.country && !state.weatherCountry) {
+      if (!country) {
         return {
           state: {
             ...state,
@@ -1084,12 +1243,11 @@ function handleUtterance(state, utterance) {
           ]
         };
       }
-      const resolvedCountry = country ?? state.weatherCountry;
       return {
-        state: { ...state, weatherCity: city, weatherCountry: resolvedCountry },
+        state: { ...state, weatherCity: city, weatherCountry: country },
         speakLines: [],
         messages: [],
-        pendingWeather: { city, country: resolvedCountry }
+        pendingWeather: { city, country }
       };
     }
     case "countAwaitingNumber": {

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.4",
+  "version": "0.5.6",
   "description": "VoiceThere customer agent SDK — IPC types and runtime helpers for sandboxed child bundles",
   "type": "module",
   "exports": {

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`.
 
@@ -67,6 +67,12 @@ Conversational voice demo for landing and dashboard previews — greets the user
 
 Sources: `voice-showcase/agent.ts` (defineAgent wiring), `conversation.ts` (pure state machine), `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`)
 
 Inbound HTTP webhook sample — verifies `x-agent-webhook-signature` HMAC on the **raw body** with `AGENT_WEBHOOK_SIGNING_SECRET`, then `JSON.parse` and fans out to connected sessions via DataChannel + `speak`.

package/templates/game-sync-protocol.ts

@@ -19,6 +19,19 @@ export interface UnregisterCommand {
   objectId?: number;
 }
 
+export function resolveRemoveTarget(
+  objectId: number | undefined,
+  ownedObjectIds: ReadonlySet<number> | undefined | null,
+): { ok: true; objectId: number } | { ok: false; reason: string } {
+  if (objectId !== undefined) {
+    return { ok: true, objectId };
+  }
+  if (!ownedObjectIds || ownedObjectIds.size === 0) {
+    return { ok: false, reason: UNREGISTER_NACK_REASON_NOT_FOUND };
+  }
+  return { ok: true, objectId: Math.max(...ownedObjectIds) };
+}
+
 export function parseUnregisterCommand(
   message: unknown,
 ): UnregisterCommand | null {

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

@@ -124,6 +124,33 @@ export function writeObjectSlot(
   world[start + 8] = dirW;
 }
 
+/**
+ * After simulating from a Redis load, keep slots empty that a concurrent release
+ * zeroed in Redis while the tick was in flight — prevents saveWorldToRedis from
+ * restoring an object Lua just cleared (sim GET → simulate → SET race).
+ *
+ * `authoritative` must be a fresh Redis GET after simulate (never stale in-memory
+ * worldState — an empty buffer would wipe every live slot).
+ */
+export function preserveEmptySlots(
+  simulated: Float32Array,
+  authoritative: Float32Array,
+): void {
+  for (let slot = 0; slot < MAX_LIVE_OBJECTS; slot += 1) {
+    if (readSlotObjectId(authoritative, slot) === 0) {
+      markSlotFree(simulated, slot);
+    }
+  }
+}
+
+/** Merge a simulated world with the latest Redis snapshot before SET. */
+export function commitSimulatedWorld(
+  simulated: Float32Array,
+  latestRedis: Float32Array,
+): void {
+  preserveEmptySlots(simulated, latestRedis);
+}
+
 export function collectActiveObjectIds(world: Float32Array): number[] {
   const ids: number[] = [];
   for (let slot = 0; slot < MAX_LIVE_OBJECTS; slot += 1) {