@voicethere/agent 0.5.6 → 0.6.0

package/dist/templates/game-sync/agent.js

@@ -11460,16 +11460,6 @@ function writeObjectSlot(world, slot, objectId, posX, posY, posZ, posW, dirX, di
   world[start + 7] = dirZ;
   world[start + 8] = dirW;
 }
-function preserveEmptySlots(simulated, authoritative) {
-  for (let slot = 0; slot < MAX_LIVE_OBJECTS; slot += 1) {
-    if (readSlotObjectId(authoritative, slot) === 0) {
-      markSlotFree(simulated, slot);
-    }
-  }
-}
-function commitSimulatedWorld(simulated, latestRedis) {
-  preserveEmptySlots(simulated, latestRedis);
-}
 function collectActiveObjectIds(world) {
   const ids = [];
   for (let slot = 0; slot < MAX_LIVE_OBJECTS; slot += 1) {
@@ -11480,6 +11470,32 @@ function collectActiveObjectIds(world) {
   }
   return ids;
 }
+function liveWorldSnapshot(world, owners) {
+  const ids = collectActiveObjectIds(world);
+  ids.sort((a, b) => a - b);
+  return ids.map((objectId) => ({
+    objectId,
+    ownerSessionId: owners.get(objectId) ?? ""
+  }));
+}
+function planRedisSimTick(options) {
+  if (options.lockAcquired) {
+    return "simulate";
+  }
+  if (options.connectedSessions.size > 0) {
+    return "relay";
+  }
+  return "noop";
+}
+function clampSimulationDtSec(elapsedMs, fallbackHz) {
+  const minDt = 1 / fallbackHz;
+  const maxDt = 0.05;
+  if (!Number.isFinite(elapsedMs) || elapsedMs <= 0) {
+    return minDt;
+  }
+  const elapsedSec = elapsedMs / 1e3;
+  return Math.min(maxDt, Math.max(minDt, elapsedSec));
+}
 function normalizeWorldBuffer(raw) {
   if (!raw || raw.byteLength === 0) {
     return createEmptyWorldBuffer();
@@ -11718,6 +11734,7 @@ var worldState = createEmptyWorldBuffer();
 var redis = null;
 var broadcastTimer = null;
 var worldMutationChain = Promise.resolve();
+var lastTickTimeMs = 0;
 function withWorldMutation(fn) {
   const run = worldMutationChain.then(fn);
   worldMutationChain = run.then(
@@ -11902,13 +11919,11 @@ async function unregisterObject(sessionId, objectId) {
   }
   return { ok: true, objectId: target.objectId };
 }
-function trackedObjectsSnapshot() {
-  const objects = [];
-  for (const [objectId, ownerSessionId] of objectOwners) {
-    objects.push({ objectId, ownerSessionId });
+function broadcastWorldSnapshot() {
+  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(objectId, ownerSessionId) {
   for (const sessionId of connectedSessions) {
@@ -11952,31 +11967,44 @@ async function saveWorldToRedis(world) {
   await redis.setBuffer(REDIS_WORLD_KEY, copyWorldBuffer(world));
 }
 async function runSimulationTick() {
+  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 world2 = await loadWorldFromRedis();
-        const activeObjectIds = collectActiveObjectIds(world2);
-        simulateWorldStep(world2, 1 / BROADCAST_HZ, activeObjectIds);
-        const latestRedis = await loadWorldFromRedis();
-        commitSimulatedWorld(world2, latestRedis);
-        await saveWorldToRedis(world2);
-        worldState = world2;
+        const world = await loadWorldFromRedis();
+        const activeObjectIds = collectActiveObjectIds(world);
+        simulateWorldStep(world, dt, activeObjectIds);
+        await saveWorldToRedis(world);
+        worldState = world;
+        broadcastWorldBuffer(world);
+        return true;
       },
       { retryUntilAcquired: false }
     );
+    if (lockResult === null) {
+      const plan = planRedisSimTick({
+        lockAcquired: false,
+        connectedSessions
+      });
+      if (plan === "relay") {
+        const world = await loadWorldFromRedis();
+        worldState = world;
+        broadcastWorldBuffer(world);
+      }
+    }
   });
-  const world = await loadWorldFromRedis();
-  worldState = world;
-  broadcastWorldBuffer(world);
 }
 function startBroadcastLoopIfNeeded() {
   if (broadcastTimer) return;
@@ -12033,12 +12061,15 @@ defineAgent({
     startBroadcastLoopIfNeeded();
     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}`);
   },
@@ -12081,6 +12112,7 @@ defineAgent({
       }
       sendToClient(ctx.sessionId, { type: "register_ack", objectId });
       notifyObjectRegistered(objectId, ctx.sessionId);
+      broadcastWorldSnapshot();
       agentLog(
         "info",
         `register session=${ctx.sessionId} objectId=${objectId}`
@@ -12105,6 +12137,7 @@ defineAgent({
         type: "unregister_ack",
         objectId: result.objectId
       });
+      broadcastWorldSnapshot();
       agentLog(
         "info",
         `unregister_ack session=${ctx.sessionId} objectId=${result.objectId}`

package/dist/templates/index.d.ts

@@ -13,6 +13,8 @@ export declare function listTemplates(filter?: ListTemplatesFilter): AgentTempla
 export declare function getTemplate(id: string): AgentTemplateDefinition;
 export declare function resolveTemplateEntryPath(id: string): string;
 export declare function loadTemplateSources(id: string): TemplateSourceFile[];
+/** Like {@link loadTemplateSources}, but paths match registry `sourceFiles` (e.g. `voice-showcase/agent.ts`). */
+export declare function loadTemplateWorkspaceSources(id: string): TemplateSourceFile[];
 export declare function hasSeedBundle(id: string): boolean;
 export declare function loadTemplateBundle(id: string): Buffer;
 export declare function buildSeedTemplateBundles(): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EAGlB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,kBAAkB;IACjC,2FAA2F;IAC3F,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAaD,wBAAgB,aAAa,CAC3B,MAAM,CAAC,EAAE,mBAAmB,GAC3B,uBAAuB,EAAE,CAK3B;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,CAE/D;AAED,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAYpE;AAMD,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAMjD;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAYrD;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAS9D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EAGlB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,kBAAkB;IACjC,2FAA2F;IAC3F,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAaD,wBAAgB,aAAa,CAC3B,MAAM,CAAC,EAAE,mBAAmB,GAC3B,uBAAuB,EAAE,CAK3B;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,CAE/D;AAED,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAYpE;AAED,iHAAiH;AACjH,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAY7E;AAMD,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAMjD;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAYrD;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAS9D"}

package/dist/templates/index.js

@@ -43,6 +43,20 @@ export function loadTemplateSources(id) {
         };
     });
 }
+/** Like {@link loadTemplateSources}, but paths match registry `sourceFiles` (e.g. `voice-showcase/agent.ts`). */
+export function loadTemplateWorkspaceSources(id) {
+    const template = getTemplateById(id);
+    return template.sourceFiles.map((sourceFile) => {
+        const absolutePath = join(TEMPLATES_DIR, sourceFile);
+        if (!existsSync(absolutePath)) {
+            throw new Error(`Template source not found for ${id}: ${absolutePath}`);
+        }
+        return {
+            path: sourceFile,
+            content: readFileSync(absolutePath, "utf8"),
+        };
+    });
+}
 function seedBundlePath(id) {
     return join(PACKAGE_ROOT, "dist", "templates", id, "agent.js");
 }

package/dist/templates/index.js.map

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

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,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"}
+{"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,6 +46,7 @@ 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",

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

@@ -1317,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) {
@@ -1335,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,
@@ -1356,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) {
@@ -1368,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voicethere/agent",
-  "version": "0.5.6",
+  "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

@@ -63,9 +63,9 @@ 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`)
 

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/voice-showcase/agent.ts

@@ -19,8 +19,13 @@ import {
   handleUtterance,
   resolveWeatherTurn,
   type ConversationState,
-  type OutboundMessage,
+  type ConversationTurnResult,
 } from "./conversation.js";
+import {
+  applyOutboundOps,
+  greetingOps,
+  spokenThenPlayOps,
+} from "./delivery.js";
 
 const sessions = new Map<string, ConversationState>();
 
@@ -42,25 +47,23 @@ function relaySpeechEvent(sessionId: string, event: SpeechEvent): void {
   });
 }
 
-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);
-  }
+function deliverSpokenThenPlay(
+  sessionId: string,
+  result: Pick<ConversationTurnResult, "messages" | "speakLines">,
+): void {
+  applyOutboundOps(
+    sessionId,
+    spokenThenPlayOps(result.messages, result.speakLines),
+    { sendToClient, speak },
+  );
 }
 
 async function applyTurn(
   sessionId: string,
-  result: Awaited<ReturnType<typeof handleUtterance>>,
+  result: ConversationTurnResult,
 ): Promise<void> {
   sessions.set(sessionId, result.state);
-  speakLines(sessionId, result.speakLines);
-  deliverMessages(sessionId, result.messages);
+  deliverSpokenThenPlay(sessionId, result);
 
   if (result.pendingWeather) {
     const weatherResult = await resolveWeatherTurn(
@@ -69,8 +72,7 @@ async function applyTurn(
       result.pendingWeather.country,
     );
     sessions.set(sessionId, weatherResult.state);
-    speakLines(sessionId, weatherResult.speakLines);
-    deliverMessages(sessionId, weatherResult.messages);
+    deliverSpokenThenPlay(sessionId, weatherResult);
   }
 }
 
@@ -83,13 +85,10 @@ async function onUserText(sessionId: string, text: string): Promise<void> {
 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}`);
   },
 

package/templates/voice-showcase/delivery.ts

@@ -0,0 +1,57 @@
+/**
+ * Voice-showcase outbound order: send spoken TTS text to the client first,
+ * then trigger TTS play. Parent IPC preserves this order.
+ */
+
+import type { OutboundMessage } from "./conversation.js";
+
+export type OutboundOp =
+  | { kind: "send"; message: OutboundMessage }
+  | { kind: "play"; text: string };
+
+export interface OutboundDeps {
+  sendToClient: (sessionId: string, payload: unknown) => void;
+  speak: (sessionId: string, text: string) => void;
+}
+
+/** All DataChannel payloads, then TTS play commands. */
+export function spokenThenPlayOps(
+  messages: OutboundMessage[],
+  speakLines: string[],
+): OutboundOp[] {
+  const ops: OutboundOp[] = [];
+  for (const message of messages) {
+    ops.push({ kind: "send", message });
+  }
+  for (const text of speakLines) {
+    ops.push({ kind: "play", text });
+  }
+  return ops;
+}
+
+export function greetingOps(
+  sessionId: string,
+  greeting: string,
+): OutboundOp[] {
+  return spokenThenPlayOps(
+    [
+      { type: "agent_event", event: "session_start", sessionId },
+      { type: "chat_reply", text: greeting },
+    ],
+    [greeting],
+  );
+}
+
+export function applyOutboundOps(
+  sessionId: string,
+  ops: OutboundOp[],
+  deps: OutboundDeps,
+): void {
+  for (const op of ops) {
+    if (op.kind === "send") {
+      deps.sendToClient(sessionId, op.message);
+    } else {
+      deps.speak(sessionId, op.text);
+    }
+  }
+}