@personaai/runtime 0.9.1 → 0.9.4

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.4";
+var RUNTIME_VERSION = "0.9.4";
 
 // src/routes/health.ts
 var alwaysOnCapabilities = {
@@ -237,6 +237,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) => {
@@ -562,7 +589,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) => {
@@ -574,7 +606,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 = {
@@ -592,7 +625,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", {
@@ -785,9 +819,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,
@@ -1385,6 +1421,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) {
@@ -1405,9 +1452,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) {