@runtypelabs/cli 2.22.7 → 2.22.9

package/dist/index.js

@@ -15181,7 +15181,7 @@ var edgeContextPayloadSchema = external_exports.object({
   exp: external_exports.number().int().positive()
 });
 
-// ../shared/dist/chunk-KR4LFVFE.mjs
+// ../shared/dist/chunk-3FPSMWBQ.mjs
 function getNestedValue(obj, path18) {
   let normalizedPath = path18;
   normalizedPath = normalizedPath.replace(/^\$\.?/, "");
@@ -15566,7 +15566,7 @@ function resolveFallback(parsed, context, tracking) {
 }
 var templateEngine = new SimpleTemplateEngine();
 
-// ../shared/dist/chunk-KYIGNRXE.mjs
+// ../shared/dist/chunk-MMDRPM6Q.mjs
 var tokensSchema = external_exports.object({ input: external_exports.number(), output: external_exports.number() });
 var wireStopReasonSchema = external_exports.enum([
   "end_turn",
@@ -15712,7 +15712,12 @@ var unifiedTextStartEventSchema = external_exports.object({
   id: external_exports.string(),
   role: external_exports.enum(["user", "assistant", "system"]).optional(),
   turnId: external_exports.string().optional(),
-  stepId: external_exports.string().optional()
+  stepId: external_exports.string().optional(),
+  // When this text block is produced by a flow running as a tool (nested
+  // execution), the parent model tool-call id — matches `tool_start.toolCallId`,
+  // so consumers route the nested streamed text into the parent tool's row.
+  // Absent for top-level (non-nested) text.
+  parentToolCallId: external_exports.string().optional()
 });
 var unifiedTextDeltaEventSchema = external_exports.object({
   ...unifiedBase,
@@ -15731,7 +15736,12 @@ var unifiedReasoningStartEventSchema = external_exports.object({
   type: external_exports.literal("reasoning_start"),
   id: external_exports.string(),
   // `scope:"loop"` marks loop-level reflection (E3 fold); default renders as thinking.
-  scope: external_exports.enum(["turn", "loop"]).optional()
+  scope: external_exports.enum(["turn", "loop"]).optional(),
+  // When this reasoning block is produced by a flow running as a tool (nested
+  // execution), the parent model tool-call id — matches `tool_start.toolCallId`,
+  // so consumers route the nested thinking into the parent tool's row. Absent
+  // for top-level (non-nested) reasoning. Mirrors `text_start.parentToolCallId`.
+  parentToolCallId: external_exports.string().optional()
 });
 var unifiedReasoningDeltaEventSchema = external_exports.object({
   ...unifiedBase,
@@ -15855,6 +15865,10 @@ var unifiedToolCompleteEventSchema = external_exports.object({
   iteration: external_exports.number().optional(),
   stepId: external_exports.string().optional()
 });
+var unifiedSubagentAttributionSchema = external_exports.object({
+  toolName: external_exports.string(),
+  agentName: external_exports.string().optional()
+});
 var unifiedApprovalStartEventSchema = external_exports.object({
   ...unifiedBase,
   type: external_exports.literal("approval_start"),
@@ -15868,7 +15882,10 @@ var unifiedApprovalStartEventSchema = external_exports.object({
   parameters: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
   timeout: external_exports.number().optional(),
   startedAt: external_exports.string().optional(),
-  iteration: external_exports.number().optional()
+  iteration: external_exports.number().optional(),
+  // Present when the approval originated inside a subagent's execution.
+  // Attribution only — never a control signal.
+  subagent: unifiedSubagentAttributionSchema.optional()
 });
 var unifiedApprovalCompleteEventSchema = external_exports.object({
   ...unifiedBase,
@@ -16005,6 +16022,10 @@ var externalAgentContextSchema = external_exports.object({
   contextId: external_exports.string().optional(),
   taskId: external_exports.string().optional()
 });
+var subagentAttributionSchema = external_exports.object({
+  toolName: external_exports.string(),
+  agentName: external_exports.string().optional()
+});
 var tokensSchema2 = external_exports.object({ input: external_exports.number(), output: external_exports.number() });
 var wireStopReasonSchema2 = external_exports.enum([
   "end_turn",
@@ -16156,7 +16177,11 @@ var agentApprovalStartEventSchema = external_exports.object({
   parameters: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
   timeout: external_exports.number(),
   startedAt: external_exports.string(),
-  externalAgent: externalAgentContextSchema.optional()
+  externalAgent: externalAgentContextSchema.optional(),
+  // Present when the approval originated inside a subagent's execution (a
+  // child agent's tool required approval). Attribution only — see
+  // {@link subagentAttributionSchema}.
+  subagent: subagentAttributionSchema.optional()
 });
 var agentApprovalCompleteEventSchema = external_exports.object({
   ...baseAgentEvent,
@@ -17058,7 +17083,13 @@ var setVariableConfigSchema = external_exports.object({
   // rejecting it. Required so nested set-variable steps validate when the
   // recursive conditional union lands (see
   // `docs/features/planning/2026-06-04-conditional-nested-step-strict-validation.md`).
-  value: external_exports.union([external_exports.string(), external_exports.number(), external_exports.boolean(), external_exports.null(), external_exports.record(external_exports.string(), external_exports.unknown())]),
+  value: external_exports.union([
+    external_exports.string(),
+    external_exports.number(),
+    external_exports.boolean(),
+    external_exports.null(),
+    external_exports.record(external_exports.string(), external_exports.unknown())
+  ]),
   valueTemplate: external_exports.string().optional()
 });
 var sendStreamConfigSchema = external_exports.object({
@@ -17694,10 +17725,63 @@ var promptConfigSchema = external_exports.object({
   mode: external_exports.string().optional()
   // UI mode (task, agent, etc.)
 });
+var conditionalBranchSchema = external_exports.object({
+  /** Stable identifier (unique within the conditional). */
+  id: external_exports.string().min(1, "Branch id is required"),
+  /** Display name ("High priority", "POST", ...). */
+  name: external_exports.string().optional(),
+  /** JS expression; template `{{var}}` references resolve first. */
+  condition: external_exports.string().min(1, "Branch condition is required"),
+  steps: external_exports.array(external_exports.lazy(() => contextStepSchema))
+});
 var conditionalConfigSchema = external_exports.object({
-  condition: external_exports.string().min(1, "Condition is required"),
-  trueSteps: external_exports.array(external_exports.lazy(() => contextStepSchema)),
-  falseSteps: external_exports.array(external_exports.lazy(() => contextStepSchema)).optional()
+  /** Legacy binary shape. Required unless `branches` is provided. */
+  condition: external_exports.string().min(1, "Condition is required").optional(),
+  trueSteps: external_exports.array(external_exports.lazy(() => contextStepSchema)).optional(),
+  falseSteps: external_exports.array(external_exports.lazy(() => contextStepSchema)).optional(),
+  /**
+   * N-way named branches, evaluated in order with first-match-wins. When
+   * present (non-empty), this takes precedence over the legacy
+   * `condition`/`trueSteps`/`falseSteps` shape.
+   */
+  branches: external_exports.array(conditionalBranchSchema).optional(),
+  /** Steps to run when no branch condition matches (the pinned "Otherwise"). */
+  otherwiseSteps: external_exports.array(external_exports.lazy(() => contextStepSchema)).optional(),
+  /**
+   * Optional unified branch output. After the taken branch runs, this variable
+   * is bound to the value of the branch's LAST enabled, explicitly-named,
+   * value-producing step (walking back past disabled / unnamed / `when`-skipped
+   * steps). Left absent if the taken branch produced no named output. Lets
+   * divergent branches surface a single result under one name.
+   * (This is an SSA φ-node — it merges the value out of whichever branch ran.)
+   */
+  outputVariable: external_exports.string().optional()
+}).superRefine((config3, ctx) => {
+  const hasBranches = Array.isArray(config3.branches) && config3.branches.length > 0;
+  if (!hasBranches) {
+    if (typeof config3.condition !== "string" || config3.condition.length === 0) {
+      ctx.addIssue({ code: "custom", path: ["condition"], message: "Condition is required" });
+    }
+    if (!Array.isArray(config3.trueSteps)) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["trueSteps"],
+        message: "trueSteps is required unless branches is provided"
+      });
+    }
+    return;
+  }
+  const seen = /* @__PURE__ */ new Set();
+  config3.branches.forEach((branch, index) => {
+    if (seen.has(branch.id)) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["branches", index, "id"],
+        message: `Duplicate branch id "${branch.id}"`
+      });
+    }
+    seen.add(branch.id);
+  });
 });
 var saveMemoryConfigSchema = external_exports.object({
   profileTemplate: external_exports.string().min(1, "Profile template is required"),
@@ -18352,7 +18436,8 @@ function normalizeCrawlConfig(config3) {
   if (maxAgeRaw !== void 0 && maxAgeRaw !== null) validateNumber(maxAgeRaw, "maxAge", "crawl");
   if (modifiedSince !== void 0) validateString(modifiedSince, "modifiedSince", "crawl");
   if (config3.options !== void 0) validateObject(config3.options, "options", "crawl");
-  if (config3.authenticate !== void 0) validateObject(config3.authenticate, "authenticate", "crawl");
+  if (config3.authenticate !== void 0)
+    validateObject(config3.authenticate, "authenticate", "crawl");
   if (config3.cookies !== void 0) validateArray(config3.cookies, "cookies", "crawl");
   if (setExtraHTTPHeaders !== void 0) {
     validateObject(setExtraHTTPHeaders, "setExtraHTTPHeaders", "crawl");
@@ -18375,7 +18460,8 @@ function normalizeCrawlConfig(config3) {
   }
   if (userAgent !== void 0) validateString(userAgent, "userAgent", "crawl");
   if (jsonOptions !== void 0) validateObject(jsonOptions, "jsonOptions", "crawl");
-  if (config3.streamOutput !== void 0) validateBoolean(config3.streamOutput, "streamOutput", "crawl");
+  if (config3.streamOutput !== void 0)
+    validateBoolean(config3.streamOutput, "streamOutput", "crawl");
   if (pollIntervalMsRaw !== void 0 && pollIntervalMsRaw !== null) {
     validateNumber(pollIntervalMsRaw, "pollIntervalMs", "crawl");
   }
@@ -18735,11 +18821,19 @@ function normalizeTemplateConfig(config3) {
     validateArray(config3.sampleData, "sampleData", "template");
     for (const [i, scenario] of config3.sampleData.entries()) {
       if (typeof scenario !== "object" || scenario === null || Array.isArray(scenario)) {
-        throw new NormalizationError(`sampleData[${i}] must be an object`, "template", `sampleData[${i}]`);
+        throw new NormalizationError(
+          `sampleData[${i}] must be an object`,
+          "template",
+          `sampleData[${i}]`
+        );
       }
       validateString(scenario.name, `sampleData[${i}].name`, "template", true);
       if (typeof scenario.data !== "object" || scenario.data === null || Array.isArray(scenario.data)) {
-        throw new NormalizationError(`sampleData[${i}].data must be an object`, "template", `sampleData[${i}].data`);
+        throw new NormalizationError(
+          `sampleData[${i}].data must be an object`,
+          "template",
+          `sampleData[${i}].data`
+        );
       }
     }
   }
@@ -18764,7 +18858,9 @@ function normalizeTemplateConfig(config3) {
 }
 function normalizeConditionalConfig(config3) {
   validateConfig(config3, "conditional");
-  validateString(config3.condition, "condition", "conditional", true);
+  const rawBranches = config3.branches;
+  const hasBranches = Array.isArray(rawBranches) && rawBranches.length > 0;
+  validateString(config3.condition, "condition", "conditional", !hasBranches);
   const trueSteps = config3.trueSteps ?? config3.true_steps;
   const falseSteps = config3.falseSteps ?? config3.false_steps;
   if (trueSteps) {
@@ -18786,10 +18882,37 @@ function normalizeConditionalConfig(config3) {
       return normalizeContextStep(stepWithDefaults);
     });
   };
+  let branches;
+  if (hasBranches) {
+    validateArray(rawBranches, "branches", "conditional");
+    branches = rawBranches.map((branch, index) => {
+      if (!branch || typeof branch !== "object") {
+        throw new NormalizationError(
+          `branches[${index}] must be an object`,
+          "conditional",
+          "branches"
+        );
+      }
+      validateString(branch.condition, `branches[${index}].condition`, "conditional", true);
+      const branchSteps = Array.isArray(branch.steps) ? branch.steps : [];
+      return {
+        id: typeof branch.id === "string" && branch.id.length > 0 ? branch.id : `branch-${index}`,
+        ...typeof branch.name === "string" && branch.name.length > 0 ? { name: branch.name } : {},
+        condition: branch.condition,
+        steps: normalizeNestedSteps(branchSteps, `conditional-branch-${index}`)
+      };
+    });
+  }
+  const otherwiseSteps = Array.isArray(config3.otherwiseSteps) ? normalizeNestedSteps(config3.otherwiseSteps, "conditional-otherwise") : void 0;
   return {
-    condition: config3.condition,
+    ...typeof config3.condition === "string" && config3.condition.length > 0 ? { condition: config3.condition } : {},
     trueSteps: trueSteps ? normalizeNestedSteps(trueSteps, "conditional-true") : [],
-    falseSteps: falseSteps ? normalizeNestedSteps(falseSteps, "conditional-false") : void 0
+    falseSteps: falseSteps ? normalizeNestedSteps(falseSteps, "conditional-false") : void 0,
+    ...branches ? { branches } : {},
+    ...otherwiseSteps ? { otherwiseSteps } : {},
+    // Preserve the optional unified branch-output binding through normalization —
+    // the manual rebuild above would otherwise drop it (not condition/branches).
+    ...typeof config3.outputVariable === "string" && config3.outputVariable.length > 0 ? { outputVariable: config3.outputVariable } : {}
   };
 }
 function normalizeSetVariableConfig(config3) {
@@ -19905,8 +20028,18 @@ function conditionalNestingDepth(config3) {
     if (depth > MAX_CONDITIONAL_NESTING_DEPTH) break;
     if (!node || typeof node !== "object") continue;
     const cfg = node;
-    for (const key of ["trueSteps", "falseSteps", "true_steps", "false_steps"]) {
-      const branch = cfg[key];
+    const branchArrays = [];
+    for (const key of ["trueSteps", "falseSteps", "true_steps", "false_steps", "otherwiseSteps"]) {
+      branchArrays.push(cfg[key]);
+    }
+    if (Array.isArray(cfg.branches)) {
+      for (const branch of cfg.branches) {
+        if (branch && typeof branch === "object") {
+          branchArrays.push(branch.steps);
+        }
+      }
+    }
+    for (const branch of branchArrays) {
       if (!Array.isArray(branch)) continue;
       for (const s of branch) {
         if (s && typeof s === "object" && s.type === "conditional") {
@@ -20955,7 +21088,7 @@ const helpers = (function createHelpers() {
 
     extractURLs: (text) => {
       if (typeof text !== 'string') return []
-      const urlRegex = /https?:\\/\\/(www\\.)?[-a-zA-Z0-9@:%._\\+~#=]{1,256}\\.[a-zA-Z0-9()]{1,6}\\b([-a-zA-Z0-9()@:%_\\+.~#?&//=]*)/g
+      const urlRegex = /https?:\\/\\/(www\\.)?[-a-zA-Z0-9@:%._\\+~#=]{1,256}\\.[a-zA-Z0-9()]{1,6}\\b([-a-zA-Z0-9()@:%_\\+.~#?&/=]*)/g
       const matches = text.match(urlRegex)
       return matches ? [...new Set(matches)] : []
     },
@@ -21142,6 +21275,13 @@ const helpers = (function createHelpers() {
         return str
       }
     },
+
+    coalesce: (...values) => {
+      for (const value of values) {
+        if (value !== null && value !== undefined) return value
+      }
+      return null
+    },
   }
 })()
 `.trim();
@@ -41536,10 +41676,10 @@ var FLOW_STEP_TYPE_METADATA = {
     configHints: "template (Liquid body), outputFormat, outputVariable, optional inputs map, optional partials, optional pdfOptions, optional asArtifact, optional streamOutput, optional sampleData"
   },
   conditional: {
-    description: "Branch the flow based on a JavaScript expression. Routes to trueSteps or falseSteps.",
+    description: "Branch the flow on JavaScript expressions. Either the legacy binary shape (condition \u2192 trueSteps / falseSteps) or N-way named branches evaluated first-match-wins with an otherwise fallback. Set outputVariable to merge the taken branch into one named result.",
     category: "control-flow",
     isPrompt: false,
-    configHints: "condition (JS expression), trueSteps, falseSteps"
+    configHints: "either { condition, trueSteps, falseSteps } or { branches: [{ id, name, condition, steps }], otherwiseSteps }, optional outputVariable"
   },
   "fetch-url": {
     description: "Make an HTTP request and capture the response.",
@@ -41870,6 +42010,7 @@ var SURFACE_TYPE_METADATA = {
       messagesMutable: false,
       deliveryModel: "real_time",
       mediaSupport: "images",
+      textMediaDelivery: "inline_html",
       interactiveUI: "generative",
       inboundMediaSupport: true,
       consumerType: "human",
@@ -41891,6 +42032,7 @@ var SURFACE_TYPE_METADATA = {
       messagesMutable: false,
       deliveryModel: "sync",
       mediaSupport: "none",
+      textMediaDelivery: "none",
       interactiveUI: "none",
       inboundMediaSupport: true,
       consumerType: "machine",
@@ -41912,6 +42054,7 @@ var SURFACE_TYPE_METADATA = {
       messagesMutable: false,
       deliveryModel: "sync",
       mediaSupport: "none",
+      textMediaDelivery: "none",
       interactiveUI: "none",
       inboundMediaSupport: false,
       consumerType: "agent",
@@ -41932,7 +42075,10 @@ var SURFACE_TYPE_METADATA = {
       streaming: "none",
       messagesMutable: false,
       deliveryModel: "async",
-      mediaSupport: "rich",
+      // Email delivers no native attachments — the adapter ignores
+      // OutboundMessage.media; images only render via inline HTML <img>.
+      mediaSupport: "images",
+      textMediaDelivery: "inline_html",
       interactiveUI: "none",
       inboundMediaSupport: true,
       consumerType: "human",
@@ -41959,6 +42105,7 @@ var SURFACE_TYPE_METADATA = {
       messagesMutable: false,
       deliveryModel: "sync",
       mediaSupport: "none",
+      textMediaDelivery: "none",
       interactiveUI: "none",
       inboundMediaSupport: false,
       consumerType: "machine",
@@ -41981,6 +42128,7 @@ var SURFACE_TYPE_METADATA = {
       messagesMutable: false,
       deliveryModel: "sync",
       mediaSupport: "none",
+      textMediaDelivery: "none",
       interactiveUI: "none",
       inboundMediaSupport: false,
       consumerType: "agent",
@@ -42002,6 +42150,7 @@ var SURFACE_TYPE_METADATA = {
       messagesMutable: true,
       deliveryModel: "real_time",
       mediaSupport: "rich",
+      textMediaDelivery: "link",
       interactiveUI: "forms",
       inboundMediaSupport: true,
       consumerType: "human",
@@ -42031,6 +42180,7 @@ var SURFACE_TYPE_METADATA = {
       messagesMutable: false,
       deliveryModel: "async",
       mediaSupport: "none",
+      textMediaDelivery: "none",
       interactiveUI: "none",
       inboundMediaSupport: false,
       consumerType: "machine",
@@ -42052,6 +42202,7 @@ var SURFACE_TYPE_METADATA = {
       messagesMutable: false,
       deliveryModel: "async",
       mediaSupport: "none",
+      textMediaDelivery: "none",
       interactiveUI: "none",
       inboundMediaSupport: false,
       consumerType: "human",
@@ -42072,6 +42223,7 @@ var SURFACE_TYPE_METADATA = {
       messagesMutable: false,
       deliveryModel: "async",
       mediaSupport: "images",
+      textMediaDelivery: "link",
       interactiveUI: "none",
       inboundMediaSupport: true,
       consumerType: "human",
@@ -42105,6 +42257,7 @@ var SURFACE_TYPE_METADATA = {
       messagesMutable: true,
       deliveryModel: "real_time",
       mediaSupport: "rich",
+      textMediaDelivery: "link",
       interactiveUI: "buttons",
       inboundMediaSupport: true,
       consumerType: "human",
@@ -42125,6 +42278,7 @@ var SURFACE_TYPE_METADATA = {
       messagesMutable: false,
       deliveryModel: "async",
       mediaSupport: "rich",
+      textMediaDelivery: "link",
       interactiveUI: "buttons",
       inboundMediaSupport: true,
       consumerType: "human",
@@ -42145,6 +42299,7 @@ var SURFACE_TYPE_METADATA = {
       messagesMutable: true,
       deliveryModel: "real_time",
       mediaSupport: "rich",
+      textMediaDelivery: "native",
       interactiveUI: "buttons",
       inboundMediaSupport: true,
       consumerType: "human",
@@ -42165,6 +42320,7 @@ var SURFACE_TYPE_METADATA = {
       messagesMutable: false,
       deliveryModel: "real_time",
       mediaSupport: "images",
+      textMediaDelivery: "link",
       interactiveUI: "none",
       inboundMediaSupport: false,
       consumerType: "human",
@@ -42185,6 +42341,7 @@ var SURFACE_TYPE_METADATA = {
       messagesMutable: false,
       deliveryModel: "sync",
       mediaSupport: "none",
+      textMediaDelivery: "none",
       interactiveUI: "none",
       inboundMediaSupport: false,
       consumerType: "agent",
@@ -42215,6 +42372,7 @@ var SURFACE_TYPE_METADATA = {
       messagesMutable: false,
       deliveryModel: "real_time",
       mediaSupport: "images",
+      textMediaDelivery: "inline_html",
       interactiveUI: "generative",
       inboundMediaSupport: true,
       consumerType: "human",
@@ -42228,6 +42386,11 @@ var SURFACE_TYPE_METADATA = {
     behaviorTypeRef: "runtype://types/surface-configs"
   }
 };
+var EMAIL_HTML_CAPABILITY_HINT = [
+  "## Channel capabilities",
+  '- Formatting: author the reply as an HTML email body. Write well-formed HTML and put all styling in inline `style="..."` attributes (no `<style>` blocks, no external CSS). Use semantic tags freely: `<p>`, `<h1>`-`<h3>`, `<ul>`/`<ol>`/`<li>`, `<table>`, `<a>`, `<strong>`/`<em>`, `<blockquote>`, `<img>`. Do NOT emit `<script>`, `<iframe>`, `<head>`, `<body>`, or `<html>` wrappers: Runtype wraps your body in the email document and strips any active or unsafe content before sending.',
+  '- Images: embed an image with `<img src="https://..." alt="...">` and it renders inline in the email. (Some clients ask the recipient to load remote images.)'
+].join("\n");
 var SURFACE_TYPE_GUIDE = (() => {
   const lines = Object.entries(SURFACE_TYPE_METADATA).map(([type, info]) => {
     return `- **${type}**: ${info.description}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/cli",
-  "version": "2.22.7",
+  "version": "2.22.9",
   "description": "Command-line interface for Runtype AI platform",
   "type": "module",
   "main": "dist/index.js",
@@ -24,8 +24,8 @@
     "rosie-skills": "0.8.1",
     "yaml": "^2.9.0",
     "@runtypelabs/ink-components": "0.3.2",
-    "@runtypelabs/sdk": "5.1.0",
-    "@runtypelabs/terminal-animations": "0.2.1"
+    "@runtypelabs/terminal-animations": "0.2.1",
+    "@runtypelabs/sdk": "5.2.1"
   },
   "devDependencies": {
     "@runtypelabs/persona": "3.37.0",
@@ -39,7 +39,7 @@
     "tsx": "^4.7.1",
     "typescript": "^5.3.3",
     "vitest": "^4.1.0",
-    "@runtypelabs/shared": "1.37.0"
+    "@runtypelabs/shared": "1.39.0"
   },
   "engines": {
     "node": ">=22.0.0"