@personaai/runtime 0.23.0 → 0.24.0

package/README.md

@@ -5,7 +5,7 @@ shared engine every framework adapter (`@personaai/adapters/express`, `@personaa
 to be a thin translation layer over — see
 [the SDK Ecosystem plan](https://github.com/hasanraiyan/agent-marketplace/blob/feat/ai/product-research/11-sdk-new/package-ecosystem.md).
 
-**v0.23.0** (built on `@personaai/sdk` 0.26.0):
+**v0.24.0** (built on `@personaai/sdk` 0.27.0):
 
 - **`POST /feedback`**: your end users rate a run 👍/👎 (with a comment and tags). Always on.
 - **Which version runs**: `selectVersion` / `defaultEnvironment` pick the published version for
@@ -352,14 +352,20 @@ createRuntime({
 });
 ```
 
-The browser can't choose: `environment` / `agentVersion` in the request body are ignored unless
-you set `allowClientVersionSelection: true` (e.g. for an internal preview build). Otherwise any
-end user could run an unreleased version. `beforeRun` / `afterRun` see the chosen
-`environment` / `agentVersion` on their context. Workflows and `/messages/agent` aren't covered
-(`@personaai/sdk` has no version option for them yet).
+It applies to `/chat`, `/voice/sessions`, `/messages/agent` and workflow runs. For a workflow,
+`selectVersion` gets `{ userId, kind: 'workflow', workflowId }` and the choice applies to every
+agent step (steps that a published workflow version pins keep their snapshot). The last two need
+`@personaai/sdk` 0.27 or newer.
 
-`/chat` also forwards a valid incoming `traceparent` header (`forwardTraceparent`, default
-`true`), so the run's spans join your OpenTelemetry trace.
+The browser can't choose: `environment` / `agentVersion` in the request body (for workflows,
+`agentEnvironment` / `agentVersion`) are ignored unless you set
+`allowClientVersionSelection: true` (e.g. for an internal preview build). Otherwise any end user
+could run an unreleased version. `beforeRun` / `afterRun` see the chosen `environment` /
+`agentVersion` on their context.
+
+A valid incoming `traceparent` header is forwarded (`forwardTraceparent`, default `true`) on
+`/chat`, `/voice/sessions`, `/messages/agent` and workflow runs (the last three with
+`@personaai/sdk` 0.27+), so those runs join your OpenTelemetry trace.
 
 ## Receiving Persona webhooks
 

package/dist/index.cjs

@@ -193,7 +193,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 = {
@@ -359,17 +359,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;
@@ -384,10 +385,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) {
@@ -1051,8 +1052,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 } : {},
@@ -1143,12 +1147,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);
 };
@@ -1844,11 +1859,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);