@voicethere/agent 0.7.11 → 0.7.13

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

@@ -152,6 +152,12 @@ function isPlayStopAckMessage(value) {
   const msg = value;
   return msg.type === "play_stop_ack" && typeof msg.requestId === "string";
 }
+function isPlayPoseAckMessage(value) {
+  if (!value || typeof value !== "object")
+    return false;
+  const msg = value;
+  return msg.type === "play_pose_ack" && typeof msg.requestId === "string";
+}
 function isRecordingControlAckMessage(value) {
   if (!value || typeof value !== "object")
     return false;
@@ -212,7 +218,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 === "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 === "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);
@@ -235,7 +241,9 @@ var pendingRecordingAcks = /* @__PURE__ */ new Map();
 var pendingPlayAcks = /* @__PURE__ */ new Map();
 var pendingPlayStatusAcks = /* @__PURE__ */ new Map();
 var pendingPlayStopAcks = /* @__PURE__ */ new Map();
+var pendingPlayPoseAcks = /* @__PURE__ */ new Map();
 var MIX_CONTROL_ACK_TIMEOUT_MS = 5e3;
+var STT_CONTROL_ACK_TIMEOUT_MS = 5e3;
 var pendingMixAcks = /* @__PURE__ */ new Map();
 var pendingSttAcks = /* @__PURE__ */ new Map();
 function handleRecordingControlAck(message) {
@@ -290,6 +298,19 @@ function handlePlayStopAck(message) {
     requestId: message.requestId
   });
 }
+function handlePlayPoseAck(message) {
+  const pending = pendingPlayPoseAcks.get(message.requestId);
+  if (!pending)
+    return;
+  clearTimeout(pending.timer);
+  pendingPlayPoseAcks.delete(message.requestId);
+  pending.resolve({
+    ok: message.ok,
+    playId: message.playId,
+    reason: message.reason,
+    requestId: message.requestId
+  });
+}
 function handleMixControlAck(message) {
   const pending = pendingMixAcks.get(message.requestId);
   if (!pending)
@@ -402,7 +423,7 @@ function sendParentMessage(message) {
     process.send?.(message);
     return;
   }
-  if (msgType === "play" || msgType === "play_status" || msgType === "play_stop") {
+  if (msgType === "play" || msgType === "play_status" || msgType === "play_stop" || msgType === "play_pose") {
     process.send?.(message);
     return;
   }
@@ -588,6 +609,10 @@ function defineAgent(handlers) {
       handlePlayStopAck(message);
       return;
     }
+    if (isPlayPoseAckMessage(message)) {
+      handlePlayPoseAck(message);
+      return;
+    }
     if (isMixControlAckMessage(message)) {
       handleMixControlAck(message);
       return;
@@ -778,6 +803,26 @@ async function sendTtsPoseControl(action, payload) {
     });
   });
 }
+async function sendSttControl(options) {
+  const requestId = randomUUID();
+  if (!isVoicethereAgentChild()) {
+    return { ok: true, reason: "local_mock", requestId };
+  }
+  return new Promise((resolve) => {
+    const timer = setTimeout(() => {
+      pendingSttAcks.delete(requestId);
+      resolve({ ok: false, reason: "timeout", requestId });
+    }, STT_CONTROL_ACK_TIMEOUT_MS);
+    pendingSttAcks.set(requestId, { resolve, timer });
+    sendParentMessage({
+      type: "stt_control",
+      requestId,
+      enabled: options.enabled,
+      ...options.clientId ? { clientId: options.clientId } : {},
+      ...options.sessionId ? { sessionId: options.sessionId } : {}
+    });
+  });
+}
 function createMixGroup(options) {
   return sendMixControl("create_group", {
     groupId: options.id,
@@ -809,6 +854,9 @@ function setListenerMute(options) {
     muted: options.muted
   });
 }
+function setSttEnabled(options) {
+  return sendSttControl(options);
+}
 function validatePlayOptions(options) {
   const requestId = randomUUID();
   const url = options.url?.trim();
@@ -928,6 +976,36 @@ function getPlay(playId) {
 function stopPlay(playId) {
   return sendPlayStop(playId);
 }
+async function sendPlayPose(playId, pose) {
+  const requestId = randomUUID();
+  if (!playId?.trim() || !pose) {
+    return {
+      ok: false,
+      playId: playId ?? "",
+      reason: "invalid_payload",
+      requestId
+    };
+  }
+  if (!isVoicethereAgentChild()) {
+    return { ok: true, playId, reason: "local_mock", requestId };
+  }
+  return new Promise((resolve) => {
+    const timer = setTimeout(() => {
+      pendingPlayPoseAcks.delete(requestId);
+      resolve({ ok: false, playId, reason: "timeout", requestId });
+    }, PLAY_CONTROL_ACK_TIMEOUT_MS);
+    pendingPlayPoseAcks.set(requestId, { playId, resolve, timer });
+    sendParentMessage({
+      type: "play_pose",
+      requestId,
+      playId,
+      pose
+    });
+  });
+}
+function setPlayPose(playId, pose) {
+  return sendPlayPose(playId, pose);
+}
 function sendToClient(sessionId, payload) {
   sendParentMessage({ type: "send_to_client", sessionId, payload });
 }
@@ -1059,6 +1137,8 @@ function resolveClipUrl(assetOrigin, clipId) {
 var SHOWCASE_DEMOS = /* @__PURE__ */ new Set(["orbit", "soundboard", "proximity"]);
 var MAX_SAY_TEXT_LENGTH = 200;
 var MAX_XZ = 5;
+var ORBIT_SINE_MIN_FREQUENCY_HZ = 110;
+var ORBIT_SINE_MAX_FREQUENCY_HZ = 1760;
 function isFiniteNumber(value) {
   return typeof value === "number" && Number.isFinite(value);
 }
@@ -1068,6 +1148,9 @@ function clampVolume(value) {
 function isInXzRange(value) {
   return value >= -MAX_XZ && value <= MAX_XZ;
 }
+function isOrbitSineFrequencyHz(value) {
+  return value >= ORBIT_SINE_MIN_FREQUENCY_HZ && value <= ORBIT_SINE_MAX_FREQUENCY_HZ;
+}
 function isMixPlacement(value) {
   return value === "center" || value === "left" || value === "right" || value === "front" || value === "behind" || value === "below" || value === "above";
 }
@@ -1116,15 +1199,33 @@ function parseShowcaseMessage(message) {
         if (set.paused !== void 0 && typeof set.paused !== "boolean") {
           return null;
         }
+        if (set.frequencyHz !== void 0 && (!isFiniteNumber(set.frequencyHz) || !isOrbitSineFrequencyHz(set.frequencyHz))) {
+          return null;
+        }
+        if (set.sinePlaying !== void 0 && typeof set.sinePlaying !== "boolean") {
+          return null;
+        }
         return {
           type: "orbit",
           action: "set",
           ...set.radius !== void 0 ? { radius: set.radius } : {},
           ...set.periodSec !== void 0 ? { periodSec: set.periodSec } : {},
           ...set.elevation !== void 0 ? { elevation: set.elevation } : {},
-          ...set.paused !== void 0 ? { paused: set.paused } : {}
+          ...set.paused !== void 0 ? { paused: set.paused } : {},
+          ...set.frequencyHz !== void 0 ? { frequencyHz: set.frequencyHz } : {},
+          ...set.sinePlaying !== void 0 ? { sinePlaying: set.sinePlaying } : {}
         };
       }
+      if (orbit.action === "place") {
+        const place = message;
+        if (!isFiniteNumber(place.x) || !isInXzRange(place.x)) {
+          return null;
+        }
+        if (!isFiniteNumber(place.z) || !isInXzRange(place.z)) {
+          return null;
+        }
+        return { type: "orbit", action: "place", x: place.x, z: place.z };
+      }
       if (orbit.action === "say") {
         const say = message;
         if (typeof say.text !== "string" || say.text.length === 0 || say.text.length > MAX_SAY_TEXT_LENGTH) {
@@ -1176,6 +1277,24 @@ function parseShowcaseMessage(message) {
       }
       return { type: "pad_status", playId: status.playId.trim() };
     }
+    case "pad_move": {
+      const padMove = message;
+      if (!isNonEmptyString(padMove.playId)) {
+        return null;
+      }
+      if (!isFiniteNumber(padMove.x) || !isInXzRange(padMove.x)) {
+        return null;
+      }
+      if (!isFiniteNumber(padMove.z) || !isInXzRange(padMove.z)) {
+        return null;
+      }
+      return {
+        type: "pad_move",
+        playId: padMove.playId.trim(),
+        x: padMove.x,
+        z: padMove.z
+      };
+    }
     case "move": {
       const move = message;
       if (!isFiniteNumber(move.x) || !isInXzRange(move.x)) {
@@ -1286,12 +1405,60 @@ var ProximityRoom = class {
   }
 };
 
+// templates/spatial-showcase/sine.ts
+var ORBIT_SINE_DURATION_MS = 2e3;
+var ORBIT_SINE_FREQUENCY_HZ = 440;
+var ORBIT_SINE_AMPLITUDE = 8e3;
+var ORBIT_SINE_SAMPLE_RATE = 16e3;
+var ORBIT_SINE_INLINE_URL = "https://example.com/inline-orbit-sine.wav";
+function orbitSineSampleCount(durationMs = ORBIT_SINE_DURATION_MS, frequencyHz = ORBIT_SINE_FREQUENCY_HZ, sampleRate = ORBIT_SINE_SAMPLE_RATE) {
+  const targetCycles = durationMs / 1e3 * frequencyHz;
+  const cycles = Math.max(1, Math.floor(targetCycles));
+  return Math.round(cycles * sampleRate / frequencyHz);
+}
+function orbitSineClipDurationMs(durationMs = ORBIT_SINE_DURATION_MS, frequencyHz = ORBIT_SINE_FREQUENCY_HZ, sampleRate = ORBIT_SINE_SAMPLE_RATE) {
+  const numSamples = orbitSineSampleCount(durationMs, frequencyHz, sampleRate);
+  return numSamples / sampleRate * 1e3;
+}
+function buildOrbitSineInlineClipBase64(durationMs = ORBIT_SINE_DURATION_MS, frequencyHz = ORBIT_SINE_FREQUENCY_HZ, amplitude = ORBIT_SINE_AMPLITUDE, phaseRad = 0) {
+  const sampleRate = ORBIT_SINE_SAMPLE_RATE;
+  const channels = 1;
+  const bytesPerSample = 2;
+  const numSamples = orbitSineSampleCount(durationMs, frequencyHz, sampleRate);
+  const dataSize = numSamples * channels * bytesPerSample;
+  const buffer = Buffer.alloc(44 + dataSize);
+  buffer.write("RIFF", 0);
+  buffer.writeUInt32LE(36 + dataSize, 4);
+  buffer.write("WAVE", 8);
+  buffer.write("fmt ", 12);
+  buffer.writeUInt32LE(16, 16);
+  buffer.writeUInt16LE(1, 20);
+  buffer.writeUInt16LE(channels, 22);
+  buffer.writeUInt32LE(sampleRate, 24);
+  buffer.writeUInt32LE(sampleRate * channels * bytesPerSample, 28);
+  buffer.writeUInt16LE(channels * bytesPerSample, 32);
+  buffer.writeUInt16LE(16, 34);
+  buffer.write("data", 36);
+  buffer.writeUInt32LE(dataSize, 40);
+  for (let i = 0; i < numSamples; i++) {
+    const t = i / sampleRate;
+    const sample = Math.round(
+      amplitude * Math.sin(2 * Math.PI * frequencyHz * t + phaseRad)
+    );
+    buffer.writeInt16LE(sample, 44 + i * 2);
+  }
+  return buffer.toString("base64");
+}
+
 // templates/spatial-showcase/agent.ts
 var ORBIT_TICK_MS = 50;
 var ORBIT_POSE_EMIT_MS = 100;
 var ROOM_STATE_TICK_MS = 100;
 var LOOP_PAD_POLL_MS = 250;
-var MAX_ACTIVE_PLAYS = 4;
+var ORBIT_SINE_POLL_MS = 250;
+var ORBIT_SINE_GAPLESS_LEAD_MS = 200;
+var ORBIT_SINE_VOLUME = 0.25;
+var MAX_ACTIVE_PLAYS = 12;
 var SHOWCASE_ROOM_GROUP_ID = "showcase-room";
 var sessions = /* @__PURE__ */ new Map();
 var proximityRoom = new ProximityRoom();
@@ -1314,12 +1481,13 @@ function ack(sessionId, action, extra) {
     ...extra
   });
 }
-function ackError(sessionId, action, error) {
+function ackError(sessionId, action, error, extra) {
   sendToClient(sessionId, {
     type: "showcase_ack",
     action,
     ok: false,
-    error
+    error,
+    ...extra?.clipId !== void 0 ? { clipId: extra.clipId } : {}
   });
 }
 async function safeMixCall(sessionId, label, fn) {
@@ -1351,6 +1519,9 @@ function defaultSessionState(demo, assetOrigin) {
     playIds: /* @__PURE__ */ new Set(),
     loopPads: /* @__PURE__ */ new Map(),
     loopPollTimers: /* @__PURE__ */ new Map(),
+    orbitSineFrequencyHz: 440,
+    orbitSineEnabled: true,
+    orbitSinePhaseRad: 0,
     inProximityRoom: false
   };
 }
@@ -1360,6 +1531,14 @@ function clearRoomStateTimer(state) {
     state.roomStateTimer = void 0;
   }
 }
+function stopLoopPadsForClip(sessionId, state, clipId) {
+  for (const [playId, pad] of [...state.loopPads.entries()]) {
+    if (pad.clipId === clipId) {
+      void stopPlay(playId);
+      clearLoopPad(sessionId, state, playId);
+    }
+  }
+}
 function clearLoopPad(sessionId, state, playId) {
   const timer = state.loopPollTimers.get(playId);
   if (timer) {
@@ -1383,8 +1562,162 @@ function clearAllPlays(sessionId, state) {
   state.loopPads.clear();
   state.loopPollTimers.clear();
 }
-function emitOrbitPose(sessionId, state) {
+function currentOrbitPose(state) {
+  if (state.orbitManualPose) {
+    const elevation = state.orbit.elevation ?? 0;
+    return {
+      position: {
+        x: state.orbitManualPose.x,
+        y: elevation,
+        z: state.orbitManualPose.z
+      },
+      orientation: { x: 0, y: 0, z: 0, w: 1 }
+    };
+  }
   if (!state.orbitStartMs) {
+    return orbitTtsPose(0, state.orbit);
+  }
+  const elapsedSec = (Date.now() - state.orbitStartMs) / 1e3;
+  return orbitTtsPose(elapsedSec, state.orbit);
+}
+function orbitPoseFromXz(state, x, z) {
+  const elevation = state.orbit.elevation ?? 0;
+  return {
+    position: { x, y: elevation, z },
+    orientation: { x: 0, y: 0, z: 0, w: 1 }
+  };
+}
+function syncOrbitClockFromManualPose(state) {
+  const manual = state.orbitManualPose;
+  if (!manual) {
+    return;
+  }
+  const periodSec = state.orbit.periodSec ?? 2 * Math.PI;
+  const angleRad = Math.atan2(manual.z, manual.x);
+  const elapsedSec = angleRad * periodSec / (2 * Math.PI);
+  state.orbitStartMs = Date.now() - elapsedSec * 1e3;
+  state.orbitManualPose = void 0;
+}
+function clearOrbitSinePoll(state) {
+  if (state.orbitSinePollTimer) {
+    clearInterval(state.orbitSinePollTimer);
+    state.orbitSinePollTimer = void 0;
+  }
+}
+function clearOrbitSineRestartTimer(state) {
+  if (state.orbitSineRestartTimer) {
+    clearTimeout(state.orbitSineRestartTimer);
+    state.orbitSineRestartTimer = void 0;
+  }
+}
+async function stopOrbitSine(state) {
+  clearOrbitSinePoll(state);
+  clearOrbitSineRestartTimer(state);
+  const playId = state.orbitSinePlayId;
+  state.orbitSinePlayId = void 0;
+  if (playId) {
+    await stopPlay(playId);
+  }
+}
+function orbitSineClipBytes(state) {
+  return buildOrbitSineInlineClipBase64(
+    ORBIT_SINE_DURATION_MS,
+    state.orbitSineFrequencyHz,
+    void 0,
+    state.orbitSinePhaseRad
+  );
+}
+function orbitSineClipDuration(state) {
+  return orbitSineClipDurationMs(
+    ORBIT_SINE_DURATION_MS,
+    state.orbitSineFrequencyHz
+  );
+}
+function scheduleOrbitSineGaplessRestart(sessionId, state) {
+  clearOrbitSineRestartTimer(state);
+  const durationMs = orbitSineClipDuration(state);
+  const delayMs = Math.max(0, durationMs - ORBIT_SINE_GAPLESS_LEAD_MS);
+  state.orbitSineRestartTimer = setTimeout(() => {
+    state.orbitSineRestartTimer = void 0;
+    void restartOrbitSineGapless(sessionId, state);
+  }, delayMs);
+}
+async function restartOrbitSineGapless(sessionId, state) {
+  if (!state.orbitSineEnabled || !state.orbitSinePlayId) {
+    return;
+  }
+  const previousPlayId = state.orbitSinePlayId;
+  const result = await play({
+    url: ORBIT_SINE_INLINE_URL,
+    bytes: orbitSineClipBytes(state),
+    sessionIds: [sessionId],
+    volume: ORBIT_SINE_VOLUME,
+    pose: currentOrbitPose(state)
+  });
+  if (!result.ok || !result.playId) {
+    agentLog(
+      "warn",
+      `spatial-showcase orbit sine gapless restart failed: ${result.reason ?? "play_failed"}`,
+      sessionId
+    );
+    startOrbitSineLoopPoll(sessionId, state);
+    return;
+  }
+  state.orbitSinePlayId = result.playId;
+  void stopPlay(previousPlayId);
+  scheduleOrbitSineGaplessRestart(sessionId, state);
+}
+function startOrbitSineLoopPoll(sessionId, state) {
+  if (state.orbitSineRestartTimer) {
+    return;
+  }
+  clearOrbitSinePoll(state);
+  const playId = state.orbitSinePlayId;
+  if (!playId) {
+    return;
+  }
+  state.orbitSinePollTimer = setInterval(() => {
+    void (async () => {
+      if (!state.orbitSinePlayId || state.orbitSineRestartTimer) {
+        clearOrbitSinePoll(state);
+        return;
+      }
+      const status = await getPlay(state.orbitSinePlayId);
+      if (!status.ok) {
+        return;
+      }
+      if (status.status === "ended") {
+        await restartOrbitSineGapless(sessionId, state);
+      }
+    })();
+  }, ORBIT_SINE_POLL_MS);
+}
+async function startOrbitSinePlay(sessionId, state) {
+  if (!state.orbitSineEnabled) {
+    return;
+  }
+  await stopOrbitSine(state);
+  const result = await play({
+    url: ORBIT_SINE_INLINE_URL,
+    bytes: orbitSineClipBytes(state),
+    sessionIds: [sessionId],
+    volume: ORBIT_SINE_VOLUME,
+    pose: currentOrbitPose(state)
+  });
+  if (!result.ok || !result.playId) {
+    agentLog(
+      "warn",
+      `spatial-showcase orbit sine play failed: ${result.reason ?? "play_failed"}`,
+      sessionId
+    );
+    return;
+  }
+  state.orbitSinePlayId = result.playId;
+  scheduleOrbitSineGaplessRestart(sessionId, state);
+  startOrbitSineLoopPoll(sessionId, state);
+}
+function emitOrbitPose(sessionId, state) {
+  if (!state.orbitStartMs && !state.orbitManualPose) {
     return;
   }
   const now = Date.now();
@@ -1392,9 +1725,8 @@ function emitOrbitPose(sessionId, state) {
     return;
   }
   state.lastOrbitPoseEmitMs = now;
-  const elapsedSec = (now - state.orbitStartMs) / 1e3;
-  const pose = orbitTtsPose(elapsedSec, state.orbit);
-  const angleRad = 2 * Math.PI * elapsedSec / (state.orbit.periodSec ?? 2 * Math.PI);
+  const pose = currentOrbitPose(state);
+  const angleRad = state.orbitManualPose ? Math.atan2(state.orbitManualPose.z, state.orbitManualPose.x) : 2 * Math.PI * (now - state.orbitStartMs) / 1e3 / (state.orbit.periodSec ?? 2 * Math.PI);
   sendToClient(sessionId, {
     type: "orbit_pose",
     angleDeg: angleRad * 180 / Math.PI,
@@ -1402,18 +1734,36 @@ function emitOrbitPose(sessionId, state) {
     z: pose.position.z
   });
 }
+function emitOrbitPlacePose(sessionId, state, x, z) {
+  state.lastOrbitPoseEmitMs = Date.now();
+  const angleRad = Math.atan2(z, x);
+  sendToClient(sessionId, {
+    type: "orbit_pose",
+    angleDeg: angleRad * 180 / Math.PI,
+    x,
+    z
+  });
+}
 function startOrbitDemo(sessionId, state) {
   stopOrbitInterval(state);
   beginOrbitClock(state);
+  void startOrbitSinePlay(sessionId, state);
   state.orbitTimer = setInterval(() => {
-    if (state.orbit.paused || !state.orbitStartMs) {
+    if (state.orbit.paused || !state.orbitStartMs && !state.orbitManualPose) {
       return;
     }
-    const elapsedSec = (Date.now() - state.orbitStartMs) / 1e3;
+    const pose = currentOrbitPose(state);
+    if (state.orbitSinePlayId) {
+      void safeMixCall(
+        sessionId,
+        "setPlayPose",
+        () => setPlayPose(state.orbitSinePlayId, pose)
+      );
+    }
     void safeMixCall(
       sessionId,
       "setTtsPose",
-      () => setTtsPose(sessionId, orbitTtsPose(elapsedSec, state.orbit))
+      () => setTtsPose(sessionId, pose)
     );
     emitOrbitPose(sessionId, state);
   }, ORBIT_TICK_MS);
@@ -1482,6 +1832,13 @@ async function startLoopPadPoll(sessionId, state, playId, pad) {
           clearLoopPad(sessionId, state, playId);
           state.playIds.add(replay.playId);
           state.loopPads.set(replay.playId, pad);
+          ack(sessionId, "pad", {
+            playId: replay.playId,
+            clipId: pad.clipId,
+            x: pad.x,
+            z: pad.z,
+            ...pad.placement !== void 0 ? { placement: pad.placement } : {}
+          });
           void startLoopPadPoll(sessionId, state, replay.playId, pad);
         }
       } else if (status.status) {
@@ -1496,21 +1853,24 @@ async function startLoopPadPoll(sessionId, state, playId, pad) {
   state.loopPollTimers.set(playId, timer);
 }
 async function handlePadPlay(sessionId, state, clipId, x, z, volume, placement) {
-  if (state.playIds.size >= MAX_ACTIVE_PLAYS) {
-    ackError(sessionId, "pad", "busy");
-    return;
-  }
   const assetOrigin = state.assetOrigin;
   if (!assetOrigin) {
-    ackError(sessionId, "pad", "missing_asset_origin");
+    ackError(sessionId, "pad", "missing_asset_origin", { clipId });
     return;
   }
   const url = resolveClipUrl(assetOrigin, clipId);
   if (!url) {
-    ackError(sessionId, "pad", "invalid_asset_origin");
+    ackError(sessionId, "pad", "invalid_asset_origin", { clipId });
     return;
   }
   const sound = SHOWCASE_SOUND_FILES[clipId];
+  if (sound.loop) {
+    stopLoopPadsForClip(sessionId, state, clipId);
+  }
+  if (state.playIds.size >= MAX_ACTIVE_PLAYS) {
+    ackError(sessionId, "pad", "busy", { clipId });
+    return;
+  }
   const playVolume = volume ?? sound.defaultVolume;
   const options = {
     url,
@@ -1520,11 +1880,17 @@ async function handlePadPlay(sessionId, state, clipId, x, z, volume, placement)
   };
   const result = await play(options);
   if (!result.ok || !result.playId) {
-    ackError(sessionId, "pad", result.reason ?? "play_failed");
+    ackError(sessionId, "pad", result.reason ?? "play_failed", { clipId });
     return;
   }
   state.playIds.add(result.playId);
-  ack(sessionId, "pad", { playId: result.playId });
+  ack(sessionId, "pad", {
+    playId: result.playId,
+    clipId,
+    x,
+    z,
+    ...placement !== void 0 ? { placement } : {}
+  });
   if (sound.loop) {
     const pad = {
       clipId,
@@ -1538,6 +1904,24 @@ async function handlePadPlay(sessionId, state, clipId, x, z, volume, placement)
     void startLoopPadPoll(sessionId, state, result.playId, pad);
   }
 }
+async function handlePadMove(sessionId, state, playId, x, z) {
+  if (!state.playIds.has(playId)) {
+    ackError(sessionId, "pad_move", "unknown_play");
+    return;
+  }
+  const poseResult = await setPlayPose(playId, poseAt(x, z));
+  if (!poseResult.ok) {
+    ackError(sessionId, "pad_move", poseResult.reason ?? "set_pose_failed");
+    return;
+  }
+  const loopPad = state.loopPads.get(playId);
+  if (loopPad) {
+    loopPad.x = x;
+    loopPad.z = z;
+    delete loopPad.placement;
+  }
+  ack(sessionId, "pad_move", { playId, x, z });
+}
 async function handleJoin(sessionId, demo, assetOrigin) {
   teardownSession(sessionId);
   const state = defaultSessionState(demo, assetOrigin);
@@ -1553,9 +1937,15 @@ async function handleJoin(sessionId, demo, assetOrigin) {
   }
   ack(sessionId, "join");
   switch (demo) {
-    case "orbit":
+    case "orbit": {
+      void safeMixCall(
+        sessionId,
+        "setSttEnabled",
+        () => setSttEnabled({ enabled: false, sessionId })
+      );
       startOrbitDemo(sessionId, state);
       break;
+    }
     case "soundboard":
       break;
     case "proximity": {
@@ -1600,8 +1990,14 @@ function teardownSession(sessionId) {
   }
   resetOrbitSession(state);
   clearRoomStateTimer(state);
+  void stopOrbitSine(state);
   clearAllPlays(sessionId, state);
   void safeMixCall(sessionId, "clearTtsPose", () => clearTtsPose(sessionId));
+  void safeMixCall(
+    sessionId,
+    "setSttEnabled",
+    () => setSttEnabled({ enabled: true, sessionId })
+  );
   if (state.inProximityRoom) {
     proximityRoom.leave(sessionId);
     void safeMixCall(
@@ -1652,11 +2048,54 @@ async function dispatchMessage(sessionId, message) {
           state.orbit.elevation = message.elevation;
         }
         if (message.paused !== void 0) {
+          if (message.paused === false && state.orbitManualPose) {
+            syncOrbitClockFromManualPose(state);
+          }
           state.orbit.paused = message.paused;
         }
+        if (message.frequencyHz !== void 0) {
+          state.orbitSineFrequencyHz = message.frequencyHz;
+          if (state.orbitSineEnabled && state.orbitSinePlayId) {
+            void startOrbitSinePlay(sessionId, state);
+          }
+        }
+        if (message.sinePlaying !== void 0) {
+          state.orbitSineEnabled = message.sinePlaying;
+          if (message.sinePlaying) {
+            if (!state.orbitSinePlayId) {
+              void startOrbitSinePlay(sessionId, state);
+            }
+          } else {
+            void stopOrbitSine(state);
+          }
+        }
         ack(sessionId, "orbit_set");
         return;
       }
+      if (message.action === "place") {
+        state.orbit.paused = true;
+        state.orbitManualPose = { x: message.x, z: message.z };
+        const pose = orbitPoseFromXz(state, message.x, message.z);
+        if (state.orbitSinePlayId) {
+          void safeMixCall(
+            sessionId,
+            "setPlayPose",
+            () => setPlayPose(state.orbitSinePlayId, pose)
+          );
+        }
+        void safeMixCall(
+          sessionId,
+          "setTtsPose",
+          () => setTtsPose(sessionId, pose)
+        );
+        emitOrbitPlacePose(sessionId, state, message.x, message.z);
+        ack(sessionId, "orbit_place");
+        return;
+      }
+      sendToClient(sessionId, {
+        type: "orbit_say_status",
+        status: "playing"
+      });
       speak(sessionId, message.text);
       ack(sessionId, "orbit_say");
       return;
@@ -1666,6 +2105,10 @@ async function dispatchMessage(sessionId, message) {
         ackError(sessionId, "pad", "wrong_demo");
         return;
       }
+      if (!isShowcaseClipId(message.clipId)) {
+        ackError(sessionId, "pad", "invalid_clip_id");
+        return;
+      }
       await handlePadPlay(
         sessionId,
         state,
@@ -1709,6 +2152,20 @@ async function dispatchMessage(sessionId, message) {
       }
       return;
     }
+    case "pad_move": {
+      if (state.demo !== "soundboard") {
+        ackError(sessionId, "pad_move", "wrong_demo");
+        return;
+      }
+      await handlePadMove(
+        sessionId,
+        state,
+        message.playId,
+        message.x,
+        message.z
+      );
+      return;
+    }
     case "move": {
       if (state.demo !== "proximity") {
         ackError(sessionId, "move", "wrong_demo");
@@ -1784,13 +2241,6 @@ defineAgent({
       ok: true
     });
   },
-  onUserSpeechFinal({ sessionId, text }) {
-    const state = sessions.get(sessionId);
-    if (!state || state.demo !== "orbit") {
-      return;
-    }
-    speak(sessionId, `You said: ${text}`);
-  },
   onDataChannelMessage(ctx) {
     const message = parseShowcaseMessage(ctx.message);
     if (!message) {
@@ -1798,11 +2248,30 @@ defineAgent({
     }
     void dispatchMessage(ctx.sessionId, message);
   },
+  onSpeechEvent(ctx, event) {
+    const state = sessions.get(ctx.sessionId);
+    if (!state || state.demo !== "orbit") {
+      return;
+    }
+    if (event.type === "agent_speaking_start") {
+      sendToClient(ctx.sessionId, {
+        type: "orbit_say_status",
+        status: "playing"
+      });
+    } else if (event.type === "agent_speaking_end") {
+      sendToClient(ctx.sessionId, {
+        type: "orbit_say_status",
+        status: "ended"
+      });
+    }
+  },
   onSessionEnd({ sessionId }) {
     teardownSession(sessionId);
     agentLog("info", `spatial-showcase session_end ${sessionId}`, sessionId);
   }
 });
 export {
+  MAX_ACTIVE_PLAYS,
+  handlePadMove,
   handlePadPlay
 };