@voicethere/agent 0.1.6 → 0.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voicethere/agent",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "VoiceThere customer agent SDK — IPC types and runtime helpers for sandboxed child bundles",
   "type": "module",
   "exports": {

package/templates/README.md

@@ -1,5 +1,22 @@
 # Agent templates
 
+## `echo.ts`
+
+Full echo debug agent for the VoiceThere dashboard — speaks **"you said: …"** on voice finals and text chat, relays speech events over DataChannel, and echoes chat replies on DC.
+
+**Build:**
+
+```bash
+npm install @voicethere/agent
+npx @voicethere/agent build --entry templates/echo.ts
+```
+
+Platform auto-seeds the built bundle when a project is created with the **Echo (voice + chat)** template.
+
+## `echo-dc.ts`
+
+Data-channel-only echo — relays speech events and chat text over DC without TTS. Use when debugging the dashboard chat panel without agent playback.
+
 ## `agent.ts`
 
 Full starter bundle covering every speech event from `@node-webrtc-rust/sdk/voice`:

package/templates/echo.ts

@@ -0,0 +1,65 @@
+/**
+ * Full echo agent — speaks and chats back "you said: …" for voice and text.
+ *
+ * Build:
+ *   npm install @voicethere/agent
+ *   npx @voicethere/agent build --entry templates/echo.ts
+ */
+import {
+  agentLog,
+  defineAgent,
+  parseChatText,
+  sendToClient,
+  speak,
+  type SpeechEvent,
+} from "@voicethere/agent";
+
+const echoPrefix =
+  (process.env.AGENT_ECHO_PREFIX ?? "you said:").trim() || "you said:";
+
+function formatEcho(text: string): string {
+  return `${echoPrefix} ${text}`.trim();
+}
+
+defineAgent({
+  onSessionStart({ sessionId }) {
+    sendToClient(sessionId, {
+      type: "agent_event",
+      event: "session_start",
+      sessionId,
+    });
+    agentLog("info", `echo session_start ${sessionId}`);
+  },
+
+  onSpeechEvent({ sessionId }, event: SpeechEvent) {
+    sendToClient(sessionId, {
+      type: "agent_event",
+      event: event.type,
+      text: event.text,
+      raw: event,
+    });
+  },
+
+  onUserSpeechFinal({ sessionId, text }) {
+    const reply = formatEcho(text);
+    speak(sessionId, reply);
+    sendToClient(sessionId, { type: "chat_reply", text: reply });
+  },
+
+  onDataChannelMessage(ctx) {
+    const text = parseChatText(ctx.message);
+    if (!text) return;
+    const reply = formatEcho(text);
+    sendToClient(ctx.sessionId, { type: "chat_reply", text: reply });
+    speak(ctx.sessionId, reply);
+  },
+
+  onSessionEnd({ sessionId }) {
+    sendToClient(sessionId, {
+      type: "agent_event",
+      event: "session_end",
+      sessionId,
+    });
+    agentLog("info", `echo session_end ${sessionId}`);
+  },
+});