@personaai/runtime 0.9.1 → 0.9.4

package/dist/index.d.cts

@@ -307,6 +307,6 @@ declare class RuntimeHttpError extends Error {
     constructor(status: number, code: string, message: string);
 }
 
-declare const RUNTIME_VERSION = "0.5.4";
+declare const RUNTIME_VERSION = "0.9.4";
 
 export { type CreateRuntimeOptions, type ErrorContext, type FileUploadContext, type MemoryWriteContext, RUNTIME_VERSION, type RcpManifestOptions, type ResolveUser, type RestToolManifestEntry, type RestToolsManifestOptions, 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

@@ -307,6 +307,6 @@ declare class RuntimeHttpError extends Error {
     constructor(status: number, code: string, message: string);
 }
 
-declare const RUNTIME_VERSION = "0.5.4";
+declare const RUNTIME_VERSION = "0.9.4";
 
 export { type CreateRuntimeOptions, type ErrorContext, type FileUploadContext, type MemoryWriteContext, RUNTIME_VERSION, type RcpManifestOptions, type ResolveUser, type RestToolManifestEntry, type RestToolsManifestOptions, 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

@@ -131,7 +131,7 @@ function evictStaleRuns(runs, now, graceMs = DEFAULT_RUN_GRACE_MS, maxTracked =
 }
 
 // src/version.ts
-var RUNTIME_VERSION = "0.5.4";
+var RUNTIME_VERSION = "0.9.4";
 
 // src/routes/health.ts
 var alwaysOnCapabilities = {
@@ -209,6 +209,33 @@ function requireStringField(body, field) {
   }
   return value;
 }
+var MAX_TURN_CONTEXT_BYTES = 2e3;
+function validateTurnContext(value) {
+  if (value === void 0) return void 0;
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw new RuntimeHttpError(400, "INVALID_CONTEXT", "context must be a flat object.");
+  }
+  const context = value;
+  for (const [key, entry] of Object.entries(context)) {
+    const entryType = typeof entry;
+    if (entryType !== "string" && entryType !== "number" && entryType !== "boolean") {
+      throw new RuntimeHttpError(
+        400,
+        "INVALID_CONTEXT",
+        `context.${key} must be a string, number, or boolean.`
+      );
+    }
+  }
+  const byteLength = new TextEncoder().encode(JSON.stringify(context)).length;
+  if (byteLength > MAX_TURN_CONTEXT_BYTES) {
+    throw new RuntimeHttpError(
+      400,
+      "CONTEXT_TOO_LARGE",
+      `context must be ${MAX_TURN_CONTEXT_BYTES} bytes or fewer when serialized.`
+    );
+  }
+  return context;
+}
 
 // src/routes/restToolsManifest.ts
 var restToolsManifestRoute = async (request, ctx) => {
@@ -534,7 +561,12 @@ function parseChatBody(body) {
     messages: b.messages,
     threadId: typeof b.threadId === "string" ? b.threadId : void 0,
     resume: b.resume ?? void 0,
-    contextOverride: typeof b.contextOverride === "string" ? b.contextOverride : void 0
+    contextOverride: typeof b.contextOverride === "string" ? b.contextOverride : void 0,
+    // Distinct from contextOverride above — never shown to the model, only
+    // ever read live by an RCP tool's resolver. validateTurnContext throws
+    // a 400 on any shape violation (not a flat string/number/boolean
+    // object, or over the byte cap) rather than coercing/dropping it.
+    context: validateTurnContext(b.context)
   };
 }
 var chatRoute = async (request, ctx) => {
@@ -546,7 +578,8 @@ var chatRoute = async (request, ctx) => {
     threadId: body.threadId,
     messageCount: body.messages?.length ?? 0,
     hasResume: !!body.resume,
-    hasContextOverride: !!body.contextOverride
+    hasContextOverride: !!body.contextOverride,
+    hasContext: !!body.context
   });
   const userId = request.userId;
   const runCtx = {
@@ -564,7 +597,8 @@ var chatRoute = async (request, ctx) => {
     messages: body.messages,
     threadId: body.threadId,
     resume: body.resume,
-    contextOverride: body.contextOverride
+    contextOverride: body.contextOverride,
+    context: body.context
   });
   const runId = crypto.randomUUID();
   logger.info("chat run created", {
@@ -757,9 +791,11 @@ var createVoiceSession = async (request, ctx) => {
   const agentId = requireStringField(body, "agentId");
   const threadId = typeof body.threadId === "string" && body.threadId ? body.threadId : void 0;
   const contextOverride = typeof body.contextOverride === "string" && body.contextOverride ? body.contextOverride : void 0;
+  const context = validateTurnContext(body.context);
   const ticket = await ctx.client.voice.createSession(agentId, {
     ...threadId ? { threadId } : {},
-    ...contextOverride ? { contextOverride } : {}
+    ...contextOverride ? { contextOverride } : {},
+    ...context ? { context } : {}
   });
   await ctx.hooks?.onVoiceSessionCreate?.({
     userId: request.userId,
@@ -1357,6 +1393,17 @@ function buildRoutes(capabilities) {
       method: "GET",
       pattern: ["agents", ":id", "mcp-connections"],
       handler: getAgentMcpConnections
+    },
+    // MCP App resources and widget tool calls — always on for conversational widgets.
+    {
+      method: "GET",
+      pattern: ["mcps", ":id", "resource"],
+      handler: readMcpResource
+    },
+    {
+      method: "POST",
+      pattern: ["mcps", ":id", "call-tool"],
+      handler: callMcpTool
     }
   ];
   if (capabilities.agentsWrite) {
@@ -1377,9 +1424,7 @@ function buildRoutes(capabilities) {
       { method: "PATCH", pattern: ["mcps", ":id"], handler: updateMcp },
       { method: "DELETE", pattern: ["mcps", ":id"], handler: deleteMcp },
       { method: "GET", pattern: ["mcps", ":id", "usage"], handler: getMcpUsage },
-      { method: "POST", pattern: ["mcps", ":id", "test"], handler: testMcpConnection },
-      { method: "GET", pattern: ["mcps", ":id", "resource"], handler: readMcpResource },
-      { method: "POST", pattern: ["mcps", ":id", "call-tool"], handler: callMcpTool }
+      { method: "POST", pattern: ["mcps", ":id", "test"], handler: testMcpConnection }
     );
   }
   if (capabilities.providers) {