@personaai/runtime 0.19.0 → 0.21.0

package/dist/index.d.cts

@@ -407,6 +407,6 @@ declare class RuntimeHttpError extends Error {
     constructor(status: number, code: string, message: string);
 }
 
-declare const RUNTIME_VERSION = "0.19.0";
+declare const RUNTIME_VERSION = "0.21.0";
 
 export { type ChannelsOptions, type CreateRuntimeOptions, type ErrorContext, type FileUploadContext, type MemoryWriteContext, RUNTIME_VERSION, type RcpManifestOptions, type ResolveTwilioChannelUser, 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 TwilioChannelOptions, type TwilioChannelRequest, type TwilioChannelUser, type VoiceSessionCreateContext, type WorkflowNodeContext, createRuntime };

package/dist/index.d.ts

@@ -407,6 +407,6 @@ declare class RuntimeHttpError extends Error {
     constructor(status: number, code: string, message: string);
 }
 
-declare const RUNTIME_VERSION = "0.19.0";
+declare const RUNTIME_VERSION = "0.21.0";
 
 export { type ChannelsOptions, type CreateRuntimeOptions, type ErrorContext, type FileUploadContext, type MemoryWriteContext, RUNTIME_VERSION, type RcpManifestOptions, type ResolveTwilioChannelUser, 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 TwilioChannelOptions, type TwilioChannelRequest, type TwilioChannelUser, type VoiceSessionCreateContext, type WorkflowNodeContext, 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.19.0";
+var RUNTIME_VERSION = "0.21.0";
 
 // src/routes/health.ts
 var alwaysOnCapabilities = {
@@ -163,6 +163,17 @@ var healthRoute = async (_request, ctx) => {
 };
 
 // src/routeHelpers.ts
+function parseFrontendTools(value) {
+  if (value === void 0 || value === null) return void 0;
+  if (!Array.isArray(value) || !value.every((t) => typeof t === "object" && t !== null && typeof t.name === "string")) {
+    throw new RuntimeHttpError(
+      400,
+      "INVALID_REQUEST",
+      '"tools" must be an array of { name, description?, parameters? } objects.'
+    );
+  }
+  return value.length > 0 ? value : void 0;
+}
 function json(status, value) {
   return {
     kind: "buffered",
@@ -578,16 +589,26 @@ async function* withHeartbeats(source, intervalMs = 15e3) {
 }
 
 // src/routes/chat.ts
-function parseTools(value) {
+var MAX_ATTACHMENTS = 4;
+function parseAttachments(value) {
   if (value === void 0 || value === null) return void 0;
-  if (!Array.isArray(value) || !value.every((t) => typeof t === "object" && t !== null && typeof t.name === "string")) {
+  if (!Array.isArray(value) || !value.every(
+    (a) => typeof a === "object" && a !== null && typeof a.fileId === "string" && a.fileId.length > 0 && a.fileId.length <= 64
+  )) {
     throw new RuntimeHttpError(
       400,
       "INVALID_REQUEST",
-      '"tools" must be an array of { name, description?, parameters? } objects.'
+      '"attachments" must be an array of { fileId } objects.'
     );
   }
-  return value.length > 0 ? value : void 0;
+  if (value.length > MAX_ATTACHMENTS) {
+    throw new RuntimeHttpError(
+      400,
+      "INVALID_REQUEST",
+      `At most ${MAX_ATTACHMENTS} attachments per message.`
+    );
+  }
+  return value.length > 0 ? value.map((a) => ({ fileId: a.fileId })) : void 0;
 }
 function parseChatBody(body) {
   if (typeof body !== "object" || body === null) {
@@ -619,7 +640,8 @@ function parseChatBody(body) {
     // 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),
-    tools: parseTools(b.tools)
+    tools: parseFrontendTools(b.tools),
+    attachments: parseAttachments(b.attachments)
   };
 }
 var chatRoute = async (request, ctx) => {
@@ -652,7 +674,8 @@ var chatRoute = async (request, ctx) => {
     resume: body.resume,
     contextOverride: body.contextOverride,
     context: body.context,
-    tools: body.tools
+    tools: body.tools,
+    attachments: body.attachments
   });
   const runId = crypto.randomUUID();
   logger.info("chat run created", {
@@ -850,10 +873,12 @@ var createVoiceSession = async (request, ctx) => {
   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 tools = parseFrontendTools(body.tools);
   const ticket = await ctx.client.voice.createSession(agentId, {
     ...threadId ? { threadId } : {},
     ...contextOverride ? { contextOverride } : {},
-    ...context ? { context } : {}
+    ...context ? { context } : {},
+    ...tools ? { tools } : {}
   });
   await ctx.hooks?.onVoiceSessionCreate?.({
     userId: request.userId,
@@ -983,6 +1008,7 @@ var createAgent = async (request, ctx) => {
     webSearchEnabled: typeof body.webSearchEnabled === "boolean" ? body.webSearchEnabled : void 0,
     sandboxEnabled: typeof body.sandboxEnabled === "boolean" ? body.sandboxEnabled : void 0,
     frontendToolsEnabled: typeof body.frontendToolsEnabled === "boolean" ? body.frontendToolsEnabled : void 0,
+    imageInputEnabled: typeof body.imageInputEnabled === "boolean" ? body.imageInputEnabled : void 0,
     visibility: body.visibility,
     category: body.category,
     skills: Array.isArray(body.skills) ? body.skills : void 0,