@personaai/runtime 0.6.0 → 0.7.1

package/dist/index.d.cts

@@ -113,6 +113,12 @@ interface MemoryWriteContext {
     agentId?: string;
     path: string;
 }
+interface VoiceSessionCreateContext {
+    userId: string;
+    agentId: string;
+    /** Set when the session resumed an existing conversation (optional `threadId` on the request). */
+    threadId?: string;
+}
 /**
  * Lifecycle hooks — the host application's voice inside the runtime's
  * request handling. Plain async event listeners, not middleware: the
@@ -138,6 +144,8 @@ interface RuntimeHooks {
     onThreadCreate?(ctx: ThreadCreateContext): void | Promise<void>;
     /** Fires after a memory file is written via `PUT /memory/file`. */
     onMemoryWrite?(ctx: MemoryWriteContext): void | Promise<void>;
+    /** Fires after a voice session ticket is minted via `POST /voice/sessions`. */
+    onVoiceSessionCreate?(ctx: VoiceSessionCreateContext): void | Promise<void>;
 }
 
 /**
@@ -248,4 +256,4 @@ declare class RuntimeHttpError extends Error {
 
 declare const RUNTIME_VERSION = "0.5.4";
 
-export { type CreateRuntimeOptions, type ErrorContext, type FileUploadContext, type MemoryWriteContext, RUNTIME_VERSION, type ResolveUser, type RunContext, type RunResult, type Runtime, type RuntimeBinaryResponse, type RuntimeBufferedResponse, type RuntimeCapabilities, type RuntimeHooks, RuntimeHttpError, type RuntimeMethod, type RuntimeRequest, type RuntimeResponse, type RuntimeStreamResponse, type RuntimeUploadedFile, type ThreadCreateContext, type ToolCallContext, createRuntime };
+export { type CreateRuntimeOptions, type ErrorContext, type FileUploadContext, type MemoryWriteContext, RUNTIME_VERSION, type ResolveUser, type RunContext, type RunResult, type Runtime, type RuntimeBinaryResponse, type RuntimeBufferedResponse, type RuntimeCapabilities, type RuntimeHooks, RuntimeHttpError, type RuntimeMethod, type RuntimeRequest, type RuntimeResponse, type RuntimeStreamResponse, type RuntimeUploadedFile, type ThreadCreateContext, type ToolCallContext, type VoiceSessionCreateContext, createRuntime };

package/dist/index.d.ts

@@ -113,6 +113,12 @@ interface MemoryWriteContext {
     agentId?: string;
     path: string;
 }
+interface VoiceSessionCreateContext {
+    userId: string;
+    agentId: string;
+    /** Set when the session resumed an existing conversation (optional `threadId` on the request). */
+    threadId?: string;
+}
 /**
  * Lifecycle hooks — the host application's voice inside the runtime's
  * request handling. Plain async event listeners, not middleware: the
@@ -138,6 +144,8 @@ interface RuntimeHooks {
     onThreadCreate?(ctx: ThreadCreateContext): void | Promise<void>;
     /** Fires after a memory file is written via `PUT /memory/file`. */
     onMemoryWrite?(ctx: MemoryWriteContext): void | Promise<void>;
+    /** Fires after a voice session ticket is minted via `POST /voice/sessions`. */
+    onVoiceSessionCreate?(ctx: VoiceSessionCreateContext): void | Promise<void>;
 }
 
 /**
@@ -248,4 +256,4 @@ declare class RuntimeHttpError extends Error {
 
 declare const RUNTIME_VERSION = "0.5.4";
 
-export { type CreateRuntimeOptions, type ErrorContext, type FileUploadContext, type MemoryWriteContext, RUNTIME_VERSION, type ResolveUser, type RunContext, type RunResult, type Runtime, type RuntimeBinaryResponse, type RuntimeBufferedResponse, type RuntimeCapabilities, type RuntimeHooks, RuntimeHttpError, type RuntimeMethod, type RuntimeRequest, type RuntimeResponse, type RuntimeStreamResponse, type RuntimeUploadedFile, type ThreadCreateContext, type ToolCallContext, createRuntime };
+export { type CreateRuntimeOptions, type ErrorContext, type FileUploadContext, type MemoryWriteContext, RUNTIME_VERSION, type ResolveUser, type RunContext, type RunResult, type Runtime, type RuntimeBinaryResponse, type RuntimeBufferedResponse, type RuntimeCapabilities, type RuntimeHooks, RuntimeHttpError, type RuntimeMethod, type RuntimeRequest, type RuntimeResponse, type RuntimeStreamResponse, type RuntimeUploadedFile, type ThreadCreateContext, type ToolCallContext, type VoiceSessionCreateContext, createRuntime };

package/dist/index.js

@@ -715,6 +715,20 @@ 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 threadId = typeof body.threadId === "string" && body.threadId ? body.threadId : void 0;
+  const ticket = await ctx.client.voice.createSession(agentId, threadId ? { threadId } : {});
+  await ctx.hooks?.onVoiceSessionCreate?.({
+    userId: request.userId,
+    agentId,
+    threadId
+  });
+  return json(201, ticket);
+};
+
 // src/routes/agents.ts
 var listAgents = async (request, ctx) => {
   const items = await ctx.client.agents.list({
@@ -1256,6 +1270,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.