@personaai/runtime 0.23.0 → 0.24.0

package/dist/index.d.cts

@@ -292,9 +292,12 @@ interface RuntimeCapabilities {
 /** What {@link CreateRuntimeOptions.selectVersion} is asked about. */
 interface VersionSelectionContext {
     userId: string;
-    agentId: string;
     /** Which route is starting the run. */
-    kind: 'chat' | 'voice';
+    kind: 'chat' | 'voice' | 'messages' | 'workflow';
+    /** The Agent (absent for `kind: 'workflow'`, whose choice applies to every agent step). */
+    agentId?: string;
+    /** Set for `kind: 'workflow'`. */
+    workflowId?: string;
 }
 /** Which published version of an Agent a run uses. Empty = the Agent's own default. */
 interface VersionSelection {
@@ -495,7 +498,8 @@ interface CreateRuntimeOptions {
     /**
      * Picks the published version a run uses, per request — canaries, beta
      * users on `development`, pinning one customer to a version. Applies to
-     * `/chat` and `/voice/sessions`. Return `undefined` for the default.
+     * `/chat`, `/voice/sessions`, `/messages/agent` and workflow runs (their
+     * agent steps). Return `undefined` for the default.
      */
     selectVersion?: (ctx: VersionSelectionContext) => VersionSelection | undefined | Promise<VersionSelection | undefined>;
     /**
@@ -514,8 +518,9 @@ interface CreateRuntimeOptions {
      */
     allowClientVersionSelection?: boolean;
     /**
-     * Forward the incoming `traceparent` header to Persona on `/chat`, so the
-     * run's spans join your own OpenTelemetry trace. @default true
+     * Forward the incoming `traceparent` header to Persona on `/chat`,
+     * `/voice/sessions`, `/messages/agent` and workflow runs, so their traces
+     * join your own OpenTelemetry trace. @default true
      */
     forwardTraceparent?: boolean;
     /** Receive Persona webhooks at `POST /webhooks/persona`. See {@link WebhooksOptions}. Unset by default. */
@@ -546,7 +551,7 @@ declare class RuntimeHttpError extends Error {
     constructor(status: number, code: string, message: string);
 }
 
-declare const RUNTIME_VERSION = "0.23.0";
+declare const RUNTIME_VERSION = "0.24.0";
 
 /** The API key scope each capability needs (`*` covers everything). */
 declare const CAPABILITY_SCOPES: Record<keyof RuntimeCapabilities, string[]>;

package/dist/index.d.ts

@@ -292,9 +292,12 @@ interface RuntimeCapabilities {
 /** What {@link CreateRuntimeOptions.selectVersion} is asked about. */
 interface VersionSelectionContext {
     userId: string;
-    agentId: string;
     /** Which route is starting the run. */
-    kind: 'chat' | 'voice';
+    kind: 'chat' | 'voice' | 'messages' | 'workflow';
+    /** The Agent (absent for `kind: 'workflow'`, whose choice applies to every agent step). */
+    agentId?: string;
+    /** Set for `kind: 'workflow'`. */
+    workflowId?: string;
 }
 /** Which published version of an Agent a run uses. Empty = the Agent's own default. */
 interface VersionSelection {
@@ -495,7 +498,8 @@ interface CreateRuntimeOptions {
     /**
      * Picks the published version a run uses, per request — canaries, beta
      * users on `development`, pinning one customer to a version. Applies to
-     * `/chat` and `/voice/sessions`. Return `undefined` for the default.
+     * `/chat`, `/voice/sessions`, `/messages/agent` and workflow runs (their
+     * agent steps). Return `undefined` for the default.
      */
     selectVersion?: (ctx: VersionSelectionContext) => VersionSelection | undefined | Promise<VersionSelection | undefined>;
     /**
@@ -514,8 +518,9 @@ interface CreateRuntimeOptions {
      */
     allowClientVersionSelection?: boolean;
     /**
-     * Forward the incoming `traceparent` header to Persona on `/chat`, so the
-     * run's spans join your own OpenTelemetry trace. @default true
+     * Forward the incoming `traceparent` header to Persona on `/chat`,
+     * `/voice/sessions`, `/messages/agent` and workflow runs, so their traces
+     * join your own OpenTelemetry trace. @default true
      */
     forwardTraceparent?: boolean;
     /** Receive Persona webhooks at `POST /webhooks/persona`. See {@link WebhooksOptions}. Unset by default. */
@@ -546,7 +551,7 @@ declare class RuntimeHttpError extends Error {
     constructor(status: number, code: string, message: string);
 }
 
-declare const RUNTIME_VERSION = "0.23.0";
+declare const RUNTIME_VERSION = "0.24.0";
 
 /** The API key scope each capability needs (`*` covers everything). */
 declare const CAPABILITY_SCOPES: Record<keyof RuntimeCapabilities, string[]>;

package/dist/index.js

@@ -169,7 +169,7 @@ function evictStaleRuns(runs, now, graceMs = DEFAULT_RUN_GRACE_MS, maxTracked =
 }
 
 // src/version.ts
-var RUNTIME_VERSION = "0.23.0";
+var RUNTIME_VERSION = "0.24.0";
 
 // src/routes/health.ts
 var alwaysOnCapabilities = {
@@ -335,17 +335,18 @@ function validateTurnContext(value) {
   return context;
 }
 var ENVIRONMENTS = ["development", "production"];
-function clientVersionFields(body) {
+function clientVersionFields(body, envField = "environment") {
   const out = {};
-  if (body.environment !== void 0 && body.environment !== null) {
-    if (!ENVIRONMENTS.includes(body.environment)) {
+  const env = body[envField];
+  if (env !== void 0 && env !== null) {
+    if (!ENVIRONMENTS.includes(env)) {
       throw new RuntimeHttpError(
         400,
         "INVALID_REQUEST",
-        '"environment" must be "development" or "production".'
+        `"${envField}" must be "development" or "production".`
       );
     }
-    out.environment = body.environment;
+    out.environment = env;
   }
   if (body.agentVersion !== void 0 && body.agentVersion !== null) {
     const v = body.agentVersion;
@@ -360,10 +361,10 @@ function clientVersionFields(body) {
   }
   return out;
 }
-async function resolveRunVersion(body, ctx, selection) {
+async function resolveRunVersion(body, ctx, selection, envField = "environment") {
   const { selectVersion, defaultEnvironment, allowClientVersionSelection } = ctx.versioning;
   if (allowClientVersionSelection) {
-    const fromClient = clientVersionFields(body);
+    const fromClient = clientVersionFields(body, envField);
     if (fromClient.environment || fromClient.agentVersion) return fromClient;
   }
   if (selectVersion) {
@@ -1027,8 +1028,11 @@ var createVoiceSession = async (request, ctx) => {
     agentId,
     kind: "voice"
   });
+  const traceparent = incomingTraceparent(request.headers, ctx.forwardTraceparent);
   const ticket = await ctx.client.voice.createSession(agentId, {
     ...version,
+    // `traceparent` needs @personaai/sdk >= 0.27 (older SDKs ignore it).
+    ...traceparent ? { traceparent } : {},
     ...threadId ? { threadId } : {},
     ...contextOverride ? { contextOverride } : {},
     ...context ? { context } : {},
@@ -1119,12 +1123,23 @@ var sendAgentMessage = async (request, ctx) => {
   const prompt = requireStringField(body, "prompt");
   const channel = optionalChannel(body);
   const displayName = optionalStringField(body, "displayName");
+  const version = await resolveRunVersion(body, ctx, {
+    userId: request.userId,
+    agentId,
+    kind: "messages"
+  });
+  const traceparent = incomingTraceparent(request.headers, ctx.forwardTraceparent);
+  const runOptions = {
+    ...version,
+    ...traceparent ? { traceparent } : {}
+  };
   const delivery = await ctx.client.messages.sendFromAgent({
     agentId,
     to,
     prompt,
     ...channel ? { channel } : {},
-    ...displayName ? { displayName } : {}
+    ...displayName ? { displayName } : {},
+    ...runOptions
   });
   return json(200, delivery);
 };
@@ -1820,11 +1835,26 @@ var workflowStreamRoute = async (request, ctx) => {
     workflowId,
     input: body.input
   };
+  const agentVersion = await resolveRunVersion(
+    request.body ?? {},
+    ctx,
+    { userId, workflowId, kind: "workflow" },
+    "agentEnvironment"
+  );
+  if (agentVersion.environment) runCtx.environment = agentVersion.environment;
+  if (agentVersion.agentVersion) runCtx.agentVersion = agentVersion.agentVersion;
+  const traceparent = incomingTraceparent(request.headers, ctx.forwardTraceparent);
   await ctx.hooks?.beforeRun?.(runCtx);
+  const runOptions = {
+    ...agentVersion.environment ? { agentEnvironment: agentVersion.environment } : {},
+    ...agentVersion.agentVersion ? { agentVersion: agentVersion.agentVersion } : {},
+    ...traceparent ? { traceparent } : {}
+  };
   const stream = ctx.client.workflows.stream(workflowId, {
     input: body.input,
     dryRun: body.dryRun,
-    version: body.version
+    version: body.version,
+    ...runOptions
   });
   const runId = crypto.randomUUID();
   const driver = new RunDriver(runId, runCtx, stream, ctx.hooks, ctx.mode);