@personaai/runtime 0.9.0 → 0.9.3

package/dist/index.cjs

@@ -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", {
@@ -784,7 +818,13 @@ 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 } : {});
+  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 } : {},
+    ...context ? { context } : {}
+  });
   await ctx.hooks?.onVoiceSessionCreate?.({
     userId: request.userId,
     agentId,