@personaai/runtime 0.6.0 → 0.7.0

package/README.md

@@ -92,6 +92,7 @@ user; `resolveUser` returning `null` or throwing responds `401`.
 | `DELETE` | `/threads/:id` | `client.threads.delete(id)` → `204` |
 | `GET` | `/threads/:id/messages` | `client.threads.getMessages(id)` — full history + graph state, the same data `chat.stream()` resumes from; load a past conversation on page reopen. |
 | `POST` | `/threads/:id/reset` | `client.threads.reset(id)` — clears message history/files/todos/subagent traces in place, keeping the same Thread id/title. |
+| `POST` | `/voice/sessions` | `client.voice.createSession(agentId)` → `{ticket, wsUrl, expiresAt, session}`. `agentId` required in the body. This route only mints the ticket — your frontend takes `wsUrl` (ticket already embedded) and opens `new WebSocket(wsUrl)` **directly to Persona**, not back through this runtime. Real-time audio, powered by Gemini Live. `201` |
 | `GET` | `/agents` | `client.agents.list({page, limit, search, category, scope})` — read-only discovery, e.g. "let the user pick an agent." |
 | `GET` | `/files` | `client.files.list({page, limit})` |
 | `POST` | `/files` | `client.files.upload({filename, content, contentType?, agentId?, threadId?})` — multipart, `file` part required. `201` |
@@ -230,7 +231,7 @@ resolved identity, is the capability on."
 
 Plain async event listeners, not middleware — the runtime proceeds with sensible defaults when a
 hook is omitted, and a hook that wants to reject a run just throws (the throw is caught and
-routed through the same sanitized error response as any other failure). **All eight are wired.**
+routed through the same sanitized error response as any other failure). **All nine are wired.**
 
 ```ts
 createRuntime({
@@ -273,6 +274,11 @@ createRuntime({
     onMemoryWrite(ctx) {
       // ctx: { userId, agentId?, path } — fires after PUT /memory/file succeeds.
     },
+    onVoiceSessionCreate(ctx) {
+      // ctx: { userId, agentId } — fires after POST /voice/sessions mints a
+      // ticket. Note this only covers the mint; the actual call happens on
+      // a direct browser-to-Persona WebSocket this runtime never sees.
+    },
   },
 });
 ```

package/dist/index.cjs

@@ -743,6 +743,18 @@ var resetThread = async (_request, ctx) => {
   return json(200, thread);
 };
 
+// src/routes/voice.ts
+var createVoiceSession = async (request, ctx) => {
+  const body = requireBodyObject(request.body);
+  const agentId = requireStringField(body, "agentId");
+  const ticket = await ctx.client.voice.createSession(agentId);
+  await ctx.hooks?.onVoiceSessionCreate?.({
+    userId: request.userId,
+    agentId
+  });
+  return json(201, ticket);
+};
+
 // src/routes/agents.ts
 var listAgents = async (request, ctx) => {
   const items = await ctx.client.agents.list({
@@ -1284,6 +1296,10 @@ function buildRoutes(capabilities) {
     { method: "DELETE", pattern: ["threads", ":id"], handler: deleteThread },
     { method: "GET", pattern: ["threads", ":id", "messages"], handler: getThreadMessages },
     { method: "POST", pattern: ["threads", ":id", "reset"], handler: resetThread },
+    // Voice — always on, end-user-scoped real-time voice sessions
+    // (powered by Gemini Live). Mints a ticket only; the host's own
+    // frontend opens the WebSocket directly, this runtime never proxies it.
+    { method: "POST", pattern: ["voice", "sessions"], handler: createVoiceSession },
     // Agents — read-only discovery always on; write ops behind agentsWrite.
     { method: "GET", pattern: ["agents"], handler: listAgents },
     // Files — always on, end-user-scoped uploads.