@personaai/runtime 0.5.4 → 0.7.0

package/README.md

@@ -91,6 +91,8 @@ user; `resolveUser` returning `null` or throwing responds `401`.
 | `PATCH` | `/threads/:id` | `client.threads.update(id, {title?, isArchived?})` |
 | `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` |
@@ -229,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({
@@ -272,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

@@ -159,7 +159,7 @@ function evictStaleRuns(runs, now, graceMs = DEFAULT_RUN_GRACE_MS, maxTracked =
 }
 
 // src/version.ts
-var RUNTIME_VERSION = "0.5.3";
+var RUNTIME_VERSION = "0.5.4";
 
 // src/routes/health.ts
 var alwaysOnCapabilities = {
@@ -738,6 +738,22 @@ var getThreadMessages = async (_request, ctx) => {
   const messages = await ctx.client.threads.getMessages(requireParam(ctx.params, "id"));
   return json(200, messages);
 };
+var resetThread = async (_request, ctx) => {
+  const thread = await ctx.client.threads.reset(requireParam(ctx.params, "id"));
+  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) => {
@@ -1279,6 +1295,11 @@ function buildRoutes(capabilities) {
     { method: "PATCH", pattern: ["threads", ":id"], handler: updateThread },
     { 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.