@runtypelabs/cli 2.18.0 → 2.19.1

package/README.md

@@ -211,7 +211,7 @@ milestones:
 EOF
 ```
 
-**Search order**: Exact path → `.runtype/marathons/playbooks/<name>.yaml|yml|json` (repo) → `~/.runtype/marathons/playbooks/<name>.yaml|yml|json` (user).
+**Search order**: Exact path → `.runtype/marathons/playbooks/<name>.yaml|yml|json|ts|mts` (repo) → `~/.runtype/marathons/playbooks/<name>.yaml|yml|json|ts|mts` (user).
 
 **Completion criteria types**:
 
@@ -248,6 +248,33 @@ milestones:
 | `requireVerification`    | `boolean`  | Require verification before `TASK_COMPLETE`.                                                                                  |
 | `outputRoot`             | `string`   | For creation tasks: confine writes to this directory (e.g. `"public/"`).                                                      |
 
+#### TypeScript playbooks
+
+Playbooks can also be TypeScript modules (`.ts`/`.mts`), loaded at runtime via jiti — no build step or special Node version required. Every behavior slot (`instructions`, `completionCriteria`, `recovery`, `intercept`, ...) then accepts a plain function in addition to inline data and hook references:
+
+```ts
+// .runtype/marathons/playbooks/my-task.ts
+import { definePlaybook, type RunTaskStateSlice } from '@runtypelabs/sdk'
+
+export default definePlaybook({
+  name: 'my-task',
+  stallPolicy: { nudgeAfter: 1, stopAfter: 4 },
+  milestones: [
+    {
+      name: 'build',
+      instructions: (state: RunTaskStateSlice) => `Build it. Plan: ${state.planPath}`,
+      recovery: (state) =>
+        `You went ${state.consecutiveEmptySessions ?? 0} sessions without a tool call. Write a file now.`,
+      canAcceptCompletion: true,
+    },
+  ],
+})
+```
+
+`definePlaybook` (from `@runtypelabs/sdk`, install as a devDependency for editor types) is optional sugar — a plain object export with the same shape works without the package installed. To register named hooks (reusable from YAML playbooks too), export a factory instead: `export default ({ registerWorkflowHook }) => ({ ... })`. A complete example lives at [`examples/playbooks/release-notes.ts`](./examples/playbooks/release-notes.ts).
+
+**Hook references**: any slot can reference a registered behavior by name instead of carrying data — `builtin:*` names expose the default workflow's behaviors (e.g. `instructions: builtin:research-instructions`, `completionCriteria: { type: builtin:research-complete }`), and YAML playbooks can load custom hooks from JS modules listed under `plugins:` (paths relative to the playbook file). See the comments in [`examples/playbooks/design-library.yaml`](./examples/playbooks/design-library.yaml).
+
 #### Marathon Anatomy
 
 ```

package/dist/index.js

@@ -7,8 +7,13 @@ var __require = /* @__PURE__ */ ((x2) => typeof require !== "undefined" ? requir
   if (typeof require !== "undefined") return require.apply(this, arguments);
   throw Error('Dynamic require of "' + x2 + '" is not supported');
 });
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+var __esm = (fn, res, err) => function __init() {
+  if (err) throw err[0];
+  try {
+    return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+  } catch (e) {
+    throw err = [e], e;
+  }
 };
 var __export = (target, all) => {
   for (var name in all)
@@ -15159,7 +15164,7 @@ var apiRoutingDocSchema = external_exports.object({
   path: ["api", "activeScript"]
 });
 
-// ../shared/dist/chunk-3V2W6XMX.mjs
+// ../shared/dist/chunk-R66POVE6.mjs
 function getNestedValue(obj, path18) {
   let normalizedPath = path18;
   normalizedPath = normalizedPath.replace(/^\$\.?/, "");
@@ -15195,6 +15200,55 @@ function getNestedValue(obj, path18) {
   return current;
 }
 var DANGEROUS_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
+var SYSTEM_VARIABLES = /* @__PURE__ */ new Set([
+  "_flow",
+  "_user",
+  "_execution",
+  "_record",
+  "_now",
+  "_schedule",
+  "messages",
+  "userMessage",
+  "lastMessage",
+  "messageCount"
+]);
+var SECRET_REF_PATTERN = /\{\{secret:([A-Z][A-Z0-9_]*[A-Z0-9])\}\}/g;
+var RUNTIME_PREFIXES = {
+  "secret:": {
+    prefix: "secret:",
+    namespace: "secret",
+    resolvedBy: "the secret pre-pass (substituteSecretReferences) before the template engine runs \u2014 never the template engine itself",
+    mayReachModelUnresolved: false
+  },
+  "flow:": {
+    prefix: "flow:",
+    namespace: "flow",
+    resolvedBy: "the template engine, which treats it as an alias for the bare flow variable of the same name",
+    mayReachModelUnresolved: false
+  }
+};
+var PREFIX_PATTERN = /^([A-Za-z][A-Za-z0-9_-]*):(.*)$/s;
+function classifyVariableReference(token) {
+  const trimmed = token.trim();
+  const prefixMatch = PREFIX_PATTERN.exec(trimmed);
+  if (prefixMatch) {
+    const prefix = `${prefixMatch[1]}:`;
+    const rest = prefixMatch[2] ?? "";
+    const spec = RUNTIME_PREFIXES[prefix];
+    if (spec) {
+      return { namespace: spec.namespace, baseName: rest.trim() };
+    }
+    return { namespace: "unknown", raw: trimmed };
+  }
+  if (isSystemVariable(trimmed)) {
+    return { namespace: "system", baseName: trimmed };
+  }
+  return { namespace: "plain", baseName: trimmed };
+}
+function isSystemVariable(varName) {
+  const rootSegment = varName.split(".")[0] || "";
+  return SYSTEM_VARIABLES.has(rootSegment);
+}
 var TEMPLATE_EXPRESSION_PATTERN = /\{\{([^{}]+)\}\}/g;
 function parseTemplateExpression(expr) {
   const tokens = tokenizeFallbackExpression(expr);
@@ -15281,7 +15335,7 @@ function parseOperand(raw) {
 }
 function evaluateOperand(operand, context) {
   if (operand.kind === "literal") return operand.value;
-  return getNestedValue(context, operand.path);
+  return getNestedValue(context, classifiedLookupKey(operand.path));
 }
 function countTrailingBackslashes(s, i) {
   let n = 0;
@@ -15306,6 +15360,7 @@ var _SimpleTemplateEngine = class _SimpleTemplateEngine2 {
     const usedVariables = [];
     const usedDefaults = [];
     const missingVariables = [];
+    const unknownNamespaceVariables = [];
     const result = template.replace(_SimpleTemplateEngine2.EXPRESSION_PATTERN, (match, expr) => {
       let parsed;
       try {
@@ -15318,12 +15373,14 @@ var _SimpleTemplateEngine = class _SimpleTemplateEngine2 {
           usedVariables,
           usedDefaults,
           missingVariables,
+          unknownNamespaceVariables,
           match
         });
       }
       return resolveFallback(parsed, context, {
         usedVariables,
         missingVariables,
+        unknownNamespaceVariables,
         match
       });
     });
@@ -15331,7 +15388,8 @@ var _SimpleTemplateEngine = class _SimpleTemplateEngine2 {
       result,
       usedVariables,
       usedDefaults,
-      missingVariables
+      missingVariables,
+      unknownNamespaceVariables
     };
   }
   /**
@@ -15406,28 +15464,49 @@ var _SimpleTemplateEngine = class _SimpleTemplateEngine2 {
 };
 _SimpleTemplateEngine.EXPRESSION_PATTERN = TEMPLATE_EXPRESSION_PATTERN;
 var SimpleTemplateEngine = _SimpleTemplateEngine;
+function classifiedLookupKey(rawKey, onUnknown) {
+  const classification = classifyVariableReference(rawKey);
+  if (classification.namespace === "flow") {
+    return classification.baseName;
+  }
+  if (classification.namespace === "unknown") {
+    onUnknown?.(classification.raw);
+    return rawKey;
+  }
+  return rawKey;
+}
 function resolveLegacy(parsed, context, tracking) {
-  const value = getNestedValue(context, parsed.variable);
+  const lookupKey = classifiedLookupKey(
+    parsed.variable,
+    (raw) => tracking.unknownNamespaceVariables.push(raw)
+  );
+  const value = getNestedValue(context, lookupKey);
   if (value !== void 0 && value !== null) {
-    tracking.usedVariables.push(parsed.variable);
+    tracking.usedVariables.push(lookupKey);
     return stringifyValue(value);
   }
   if (parsed.defaultValue !== void 0) {
     tracking.usedDefaults.push({
-      variable: parsed.variable,
+      variable: lookupKey,
       defaultValue: parsed.defaultValue
     });
     return parsed.defaultValue;
   }
-  tracking.missingVariables.push(parsed.variable);
+  tracking.missingVariables.push(lookupKey);
   return tracking.match;
 }
 function resolveFallback(parsed, context, tracking) {
   let chosen = null;
   for (const operand of parsed.operands) {
     const value = evaluateOperand(operand, context);
-    if (operand.kind === "path" && value !== void 0) {
-      tracking.usedVariables.push(operand.path);
+    if (operand.kind === "path") {
+      const key = classifiedLookupKey(
+        operand.path,
+        (raw) => tracking.unknownNamespaceVariables.push(raw)
+      );
+      if (value !== void 0) {
+        tracking.usedVariables.push(key);
+      }
     }
     if (chosen === null && passesOperator(value, parsed.operator)) {
       chosen = { value, isPath: operand.kind === "path" };
@@ -15439,13 +15518,18 @@ function resolveFallback(parsed, context, tracking) {
     return stringifyValue(last.value);
   }
   for (const operand of parsed.operands) {
-    if (operand.kind === "path") tracking.missingVariables.push(operand.path);
+    if (operand.kind === "path") {
+      tracking.missingVariables.push(classifiedLookupKey(operand.path));
+    }
   }
   return tracking.match;
 }
 var templateEngine = new SimpleTemplateEngine();
 
 // ../shared/dist/index.mjs
+function neutralizeCsvFormula(value) {
+  return /^[=+\-@\t\r\n]/.test(value) ? `'${value}` : value;
+}
 var mediaAnnotationsSchema = external_exports.object({
   audience: external_exports.array(external_exports.enum(["user", "assistant"])).optional()
 });
@@ -30444,7 +30528,7 @@ var CORE_BUILTIN_TOOLS_REGISTRY = [
   {
     id: "publish_page",
     name: "Publish Page",
-    description: "Publish an HTML page on Runtype's CDN and get back a shareable URL that renders the page inline in the browser. Two source modes: (1) pass `url` to download an HTML file from an HTTP(S) URL, or (2) pass base64-encoded `content` (defaults to `contentType: text/html`) to upload inline HTML directly \u2014 useful when running inside a sandboxed code-execution environment with restricted outbound network. Exactly one of `url` or `content` must be provided. Served inline from a `/preview/` path under a locked-down CSP that blocks scripts, network requests, and form submissions. Page URLs are public and expire after 7 days. Accepts only HTML content. 25 MB max. To host a non-HTML file, or HTML as a permanent downloadable file, use `store_asset` instead.",
+    description: "Publish an HTML page on Runtype's CDN and get back a shareable URL that renders the page inline in the browser. Two source modes: (1) pass `url` to download an HTML file from an HTTP(S) URL, or (2) pass base64-encoded `content` (defaults to `contentType: text/html`) to upload inline HTML directly \u2014 useful when running inside a sandboxed code-execution environment with restricted outbound network. Exactly one of `url` or `content` must be provided. Served inline from a `/preview/` path under a locked-down CSP that blocks scripts, network requests, and form submissions. Page URLs are public and expire based on the account's plan (7 days on the default plan; longer or permanent on higher tiers \u2014 check `expiresAt` in the result). Pass `expiresInSeconds` to choose a shorter lifetime; the plan TTL is a hard ceiling. A page can be re-upped to the current plan TTL at the same URL via `POST /v1/assets/:assetId/extend`. Accepts only HTML content. 25 MB max. To host a non-HTML file, or HTML as a permanent downloadable file, use `store_asset` instead.",
     category: BuiltInToolCategory.FILE_OPERATIONS,
     toolGroup: BuiltInToolGroup.FILE_OUTPUTS,
     providers: [BuiltInToolProvider.MULTI],
@@ -30466,6 +30550,10 @@ var CORE_BUILTIN_TOOLS_REGISTRY = [
         filename: {
           type: "string",
           description: "Optional filename for the stored page"
+        },
+        expiresInSeconds: {
+          type: "number",
+          description: "Optional page lifetime in seconds (positive integer). Capped at the account plan's preview TTL \u2014 a shorter lifetime is honored, a longer one is clamped to the plan ceiling. Omit to use the plan default."
         }
       },
       required: []
@@ -33515,7 +33603,15 @@ var userProfileFeaturesSchema = external_exports.object({
   enableDashboardAssistant: external_exports.boolean(),
   // Routed model id the dashboard assistant dispatches with. Driven by the
   // `dashboard-assistant-model` string flag.
-  dashboardAssistantModel: external_exports.string()
+  dashboardAssistantModel: external_exports.string(),
+  // Gates the chrome_extension surface type in the dashboard (surface picker
+  // and downstream config/ship UI). Driven by the `CHROME_SURFACE` boolean
+  // flag.
+  enableChromeSurface: external_exports.boolean(),
+  // Gates the Runtype Apps nav entry + routes in the dashboard. Driven by the
+  // `enable-runtype-apps` boolean flag (fail-closed in production until the
+  // prod ops set lands). The whole /v1/apps surface 404s when this is off.
+  enableRuntypeApps: external_exports.boolean()
 });
 var MODEL_FAMILY_PROVIDER_IDS = {
   "claude-fable-5": {
@@ -36151,7 +36247,6 @@ var agentRuntimeConfigSchema = external_exports.object({
   // mirroring how `temporalConfigSchema` is shared.
   memory: memoryConfigSchema.optional()
 });
-var SECRET_REF_PATTERN = /\{\{secret:([A-Z][A-Z0-9_]*[A-Z0-9])\}\}/g;
 function extractSecretReferences(template) {
   const keys = /* @__PURE__ */ new Set();
   let match;
@@ -36482,7 +36577,8 @@ var surfaceSchema = external_exports.object({
     "messaging",
     "telegram",
     "a2a",
-    "hosted-page"
+    "hosted-page",
+    "chrome_extension"
   ]),
   config: external_exports.record(external_exports.string(), external_exports.any()),
   createPolicy: createPolicySchema,
@@ -37946,7 +38042,8 @@ var PLATFORM_CATALOG = {
     "whatsapp",
     "messaging",
     "telegram",
-    "a2a"
+    "a2a",
+    "chrome_extension"
   ],
   availableFlowPrimitives: FLOW_STEP_TYPES.map((stepType) => {
     const meta3 = FLOW_STEP_TYPE_METADATA[stepType];
@@ -38336,6 +38433,37 @@ var SURFACE_TYPE_METADATA = {
       maxResponseLength: null,
       executionHint: null
     }
+  },
+  // @snake-case-ok: surface type identifier
+  chrome_extension: {
+    description: "Downloadable Manifest V3 Chrome extension embedding the agent in the browser side panel, with packaged browser tools (read page, fill forms, navigate tabs) executed locally via the WebMCP client-tool loop.",
+    useCases: [
+      "browser copilots",
+      "page-aware assistants",
+      "form filling and data extraction",
+      "internal browser tooling"
+    ],
+    examples: [
+      "CRM sidekick that reads and updates records on the page",
+      "Research assistant that summarizes and compares open tabs",
+      "Support agent that drafts replies inside a ticketing UI"
+    ],
+    traits: {
+      streaming: "required",
+      messagesMutable: false,
+      deliveryModel: "real_time",
+      mediaSupport: "images",
+      interactiveUI: "generative",
+      inboundMediaSupport: true,
+      consumerType: "human",
+      reasoningVisibility: "pass_through",
+      markdownDialect: "mdx",
+      threadModel: "flat",
+      senderIdentity: "anonymous",
+      maxResponseLength: null,
+      executionHint: "You are running inside a Chrome extension side panel. You may have browser tools (chrome:*) to read the current page, interact with forms, and manage tabs \u2014 use them when the user asks about or wants to act on the page they are viewing. Mutating actions (clicking, filling, navigating) ask the user for confirmation before running."
+    },
+    behaviorTypeRef: "runtype://types/surface-configs"
   }
 };
 var SURFACE_TYPE_GUIDE = (() => {
@@ -41084,6 +41212,131 @@ recordsCommand.command("get <id>").description("Get record details").option("--j
   const { waitUntilExit } = render3(React3.createElement(App));
   await waitUntilExit();
 });
+recordsCommand.command("results <id>").description("Get step-level execution results for a record").option("--flow-id <flowId>", "Filter by flow ID").option("--batch-id <batchId>", "Filter by batch ID").option("--status <status>", "Filter by status").option("--limit <n>", "Limit number of results").option("--offset <n>", "Offset for pagination").option("--json", "Output as JSON").option("--tty", "Force TTY mode").option("--no-tty", "Force non-TTY mode").action(
+  async (id, options) => {
+    const apiKey = await ensureAuth();
+    if (!apiKey) return;
+    const client = createCliClient(apiKey);
+    const params = {
+      ...options.flowId ? { flowId: options.flowId } : {},
+      ...options.batchId ? { batchId: options.batchId } : {},
+      ...options.status ? { status: options.status } : {},
+      ...options.limit ? { limit: parseInt(options.limit, 10) } : {},
+      ...options.offset ? { offset: parseInt(options.offset, 10) } : {}
+    };
+    if (!isTTY(options) || options.json) {
+      try {
+        const data = await client.records.getStepResults(id, params);
+        if (options.json) {
+          printJson(data);
+          return;
+        }
+        const results = data.data ?? [];
+        if (results.length === 0) {
+          console.log(chalk6.yellow("No step results found"));
+          return;
+        }
+        for (const r of results) {
+          console.log(
+            `  ${chalk6.green(r.id)}  ${r.stepName} (${r.stepType})  ${r.status}` + (r.modelUsed ? `  ${r.modelUsed}` : "")
+          );
+        }
+      } catch (error51) {
+        const message = error51 instanceof Error ? error51.message : "Unknown error";
+        console.error(chalk6.red(`Failed to fetch step results: ${message}`));
+        process.exit(1);
+      }
+      return;
+    }
+    const App = () => {
+      const [items, setItems] = useState4(null);
+      const [error51, setError] = useState4(null);
+      useEffect5(() => {
+        client.records.getStepResults(id, params).then((res) => setItems(res.data ?? [])).catch((err) => setError(err instanceof Error ? err : new Error(String(err))));
+      }, []);
+      return React3.createElement(DataList, {
+        title: "Step results",
+        items,
+        error: error51,
+        loading: items === null && error51 === null,
+        renderCard: (item) => {
+          const r = item;
+          return React3.createElement(EntityCard, {
+            fields: [
+              { label: "ID", value: r.id, color: "green" },
+              { label: "Step", value: `${r.stepName} (${r.stepType})` },
+              { label: "Status", value: r.status },
+              { label: "Model", value: r.modelUsed ?? null },
+              {
+                label: "Duration",
+                value: r.durationMs !== null ? `${r.durationMs}ms` : null
+              }
+            ]
+          });
+        }
+      });
+    };
+    const { waitUntilExit } = render3(React3.createElement(App));
+    await waitUntilExit();
+  }
+);
+recordsCommand.command("costs <id>").description("Get aggregated cost breakdown for a record").option("--json", "Output as JSON").option("--tty", "Force TTY mode").option("--no-tty", "Force non-TTY mode").action(async (id, options) => {
+  const apiKey = await ensureAuth();
+  if (!apiKey) return;
+  const client = createCliClient(apiKey);
+  if (!isTTY(options) || options.json) {
+    try {
+      const data = await client.records.getCosts(id);
+      if (options.json) {
+        printJson(data);
+        return;
+      }
+      console.log(`  Total cost: $${data.totalCost}`);
+      console.log(`  Total tokens: ${data.totalTokens}`);
+      console.log(`  Executions: ${data.executionCount}`);
+      if (data.modelBreakdown.length > 0) {
+        console.log("  By model:");
+        for (const m2 of data.modelBreakdown) {
+          console.log(`    ${m2.model}: $${m2.cost}  ${m2.tokens} tokens  ${m2.count} calls`);
+        }
+      }
+    } catch (error51) {
+      const message = error51 instanceof Error ? error51.message : "Unknown error";
+      console.error(chalk6.red(`Failed to fetch record costs: ${message}`));
+      process.exit(1);
+    }
+    return;
+  }
+  const App = () => {
+    const [items, setItems] = useState4(null);
+    const [error51, setError] = useState4(null);
+    useEffect5(() => {
+      client.records.getCosts(id).then((res) => setItems([res])).catch((err) => setError(err instanceof Error ? err : new Error(String(err))));
+    }, []);
+    return React3.createElement(DataList, {
+      title: "Record costs",
+      items,
+      error: error51,
+      loading: items === null && error51 === null,
+      renderCard: (item) => {
+        const c2 = item;
+        return React3.createElement(EntityCard, {
+          fields: [
+            { label: "Total cost", value: `$${c2.totalCost}`, color: "green" },
+            { label: "Total tokens", value: String(c2.totalTokens) },
+            { label: "Executions", value: String(c2.executionCount) },
+            {
+              label: "Models",
+              value: c2.modelBreakdown.map((m2) => `${m2.model} ($${m2.cost})`).join(", ") || null
+            }
+          ]
+        });
+      }
+    });
+  };
+  const { waitUntilExit } = render3(React3.createElement(App));
+  await waitUntilExit();
+});
 recordsCommand.command("create").description("Create a new record").requiredOption("-n, --name <name>", "Record name").requiredOption("-t, --type <type>", "Record type").option("-m, --metadata <json>", "Metadata as JSON string").option("--json", "Output as JSON").option("--tty", "Force TTY mode").option("--no-tty", "Force non-TTY mode").action(
   async (options) => {
     const apiKey = await ensureAuth();
@@ -41491,10 +41744,11 @@ recordsCommand.command("export").description("Export records to a file").option(
   }
 });
 function csvEscape(value) {
-  if (value.includes(",") || value.includes('"') || value.includes("\n")) {
-    return `"${value.replace(/"/g, '""')}"`;
+  const text = neutralizeCsvFormula(value);
+  if (text.includes(",") || text.includes('"') || text.includes("\n")) {
+    return `"${text.replace(/"/g, '""')}"`;
   }
-  return value;
+  return text;
 }
 
 // src/commands/prompts.ts
@@ -48861,29 +49115,40 @@ function primeTreeLogSyncFromState(stateFilePath2, log, state) {
     lastCheckpointJson: JSON.stringify(toCheckpoint(state))
   });
 }
+function ensureTreeLogSync(stateFilePath2, seed) {
+  const logPath = treeLogPathForStateFile(stateFilePath2);
+  let sync = syncStates.get(stateFilePath2);
+  if (!sync || sync.log.filePath !== logPath) {
+    const existing = loadTreeLog(logPath);
+    if (existing) {
+      const materialized = materializeAtHead(existing);
+      sync = {
+        log: existing,
+        lastMessages: materialized?.messages ?? [],
+        lastCheckpointJson: JSON.stringify(materialized?.state ?? null)
+      };
+    } else {
+      const log = createTreeLog(logPath, {
+        taskName: seed.taskName,
+        agentId: seed.agentId,
+        ...seed.originalMessage ? { originalMessage: seed.originalMessage } : {}
+      });
+      sync = { log, lastMessages: [], lastCheckpointJson: "null" };
+    }
+    syncStates.set(stateFilePath2, sync);
+  }
+  return sync;
+}
+function getOrLoadTreeLogSync(stateFilePath2, seed) {
+  return ensureTreeLogSync(stateFilePath2, seed).log;
+}
 function syncTreeLogWithState(stateFilePath2, state) {
   try {
-    const logPath = treeLogPathForStateFile(stateFilePath2);
-    let sync = syncStates.get(stateFilePath2);
-    if (!sync || sync.log.filePath !== logPath) {
-      const existing = loadTreeLog(logPath);
-      if (existing) {
-        const materialized = materializeAtHead(existing);
-        sync = {
-          log: existing,
-          lastMessages: materialized?.messages ?? [],
-          lastCheckpointJson: JSON.stringify(materialized?.state ?? null)
-        };
-      } else {
-        const log = createTreeLog(logPath, {
-          taskName: state.taskName,
-          agentId: state.agentId,
-          ...state.originalMessage ? { originalMessage: state.originalMessage } : {}
-        });
-        sync = { log, lastMessages: [], lastCheckpointJson: "null" };
-      }
-      syncStates.set(stateFilePath2, sync);
-    }
+    const sync = ensureTreeLogSync(stateFilePath2, {
+      taskName: state.taskName,
+      agentId: state.agentId,
+      ...state.originalMessage ? { originalMessage: state.originalMessage } : {}
+    });
     const nextMessages = state.messages ?? sync.lastMessages;
     const messagesDelta = computeMessagesDelta(sync.lastMessages, nextMessages);
     const checkpoint = toCheckpoint(state);
@@ -55430,9 +55695,8 @@ function stateFilePathForTask(taskName, stateDir) {
 }
 function recordOffloadedArtifact(details) {
   const stateFilePath2 = details.options.ledger?.stateFilePath || stateFilePathForTask(details.taskName, details.stateDir);
-  const logPath = treeLogPathForStateFile(stateFilePath2);
   try {
-    const log = loadTreeLog(logPath) || createTreeLog(logPath, {
+    const log = getOrLoadTreeLogSync(stateFilePath2, {
       taskName: details.taskName,
       agentId: details.options.ledger?.agentId || "unknown",
       ...details.options.ledger?.originalMessage ? { originalMessage: details.options.ledger.originalMessage } : {}
@@ -55751,14 +56015,17 @@ function resolveErrorHandlingForPhase(phase, cliFallbackModel, milestoneFallback
 import * as fs14 from "fs";
 import * as path15 from "path";
 import * as os5 from "os";
+import { pathToFileURL } from "url";
+import { createJiti } from "jiti";
 import micromatch from "micromatch";
 import { parse as parseYaml } from "yaml";
-var DISCOVERY_TOOLS = /* @__PURE__ */ new Set([
-  "search_repo",
-  "glob_files",
-  "tree_directory",
-  "list_directory"
-]);
+import {
+  DEFAULT_STALL_STOP_AFTER,
+  compileWorkflowConfig,
+  ensureDefaultWorkflowHooks,
+  isWorkflowHookRef,
+  registerWorkflowHook
+} from "@runtypelabs/sdk";
 var PLAYBOOKS_DIR = ".runtype/marathons/playbooks";
 function getCandidatePaths(nameOrPath, cwd) {
   const home = os5.homedir();
@@ -55769,12 +56036,43 @@ function getCandidatePaths(nameOrPath, cwd) {
     path15.resolve(cwd, PLAYBOOKS_DIR, `${nameOrPath}.yaml`),
     path15.resolve(cwd, PLAYBOOKS_DIR, `${nameOrPath}.yml`),
     path15.resolve(cwd, PLAYBOOKS_DIR, `${nameOrPath}.json`),
+    path15.resolve(cwd, PLAYBOOKS_DIR, `${nameOrPath}.ts`),
+    path15.resolve(cwd, PLAYBOOKS_DIR, `${nameOrPath}.mts`),
     // User-level
     path15.resolve(home, PLAYBOOKS_DIR, `${nameOrPath}.yaml`),
     path15.resolve(home, PLAYBOOKS_DIR, `${nameOrPath}.yml`),
-    path15.resolve(home, PLAYBOOKS_DIR, `${nameOrPath}.json`)
+    path15.resolve(home, PLAYBOOKS_DIR, `${nameOrPath}.json`),
+    path15.resolve(home, PLAYBOOKS_DIR, `${nameOrPath}.ts`),
+    path15.resolve(home, PLAYBOOKS_DIR, `${nameOrPath}.mts`)
   ];
 }
+var MODULE_PLAYBOOK_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".mts"]);
+var jitiLoader;
+async function loadModulePlaybook(filePath) {
+  jitiLoader ??= createJiti(import.meta.url, { interopDefault: false });
+  let mod;
+  try {
+    mod = await jitiLoader.import(filePath);
+  } catch (error51) {
+    const message = error51 instanceof Error ? error51.message : String(error51);
+    throw new Error(`Failed to load TypeScript playbook at ${filePath}: ${message}`, {
+      cause: error51
+    });
+  }
+  const exported = mod.default;
+  if (exported === void 0 || exported === null) {
+    throw new Error(
+      `TypeScript playbook at ${filePath} must have a default export: a playbook config object, or a factory function receiving { registerWorkflowHook }. Wrap it in definePlaybook(...) from @runtypelabs/sdk for type inference.`
+    );
+  }
+  const config3 = typeof exported === "function" ? await exported({ registerWorkflowHook }) : exported;
+  if (!config3 || typeof config3 !== "object" || Array.isArray(config3)) {
+    throw new Error(
+      `TypeScript playbook at ${filePath} did not produce a playbook config object.`
+    );
+  }
+  return config3;
+}
 function parsePlaybookFile(filePath) {
   const raw = fs14.readFileSync(filePath, "utf-8");
   const ext = path15.extname(filePath).toLowerCase();
@@ -55783,6 +56081,12 @@ function parsePlaybookFile(filePath) {
   }
   return parseYaml(raw);
 }
+function assertPositiveInteger(value, label, playbookName) {
+  if (value === void 0) return;
+  if (typeof value !== "number" || !Number.isInteger(value) || value < 1) {
+    throw new Error(`Playbook '${playbookName}': ${label} must be a positive integer`);
+  }
+}
 function validatePlaybook(config3, filePath) {
   if (!config3.name) {
     throw new Error(`Playbook at ${filePath} is missing required 'name' field`);
@@ -55797,131 +56101,140 @@ function validatePlaybook(config3, filePath) {
     if (!milestone.instructions) {
       throw new Error(`Playbook '${config3.name}': milestone '${milestone.name}' is missing 'instructions'`);
     }
+    if (milestone.recovery !== void 0 && typeof milestone.recovery !== "function" && !isWorkflowHookRef(milestone.recovery)) {
+      const recovery = milestone.recovery;
+      if (typeof recovery.message !== "string" || !recovery.message.trim()) {
+        throw new Error(
+          `Playbook '${config3.name}': milestone '${milestone.name}' recovery is missing 'message'`
+        );
+      }
+      assertPositiveInteger(
+        recovery.afterEmptySessions,
+        `milestone '${milestone.name}' recovery.afterEmptySessions`,
+        config3.name
+      );
+    }
   }
-}
-function interpolate(template, state) {
-  return template.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
-    const value = state[key];
-    if (value === void 0 || value === null) return `{{${key}}}`;
-    return String(value);
-  });
-}
-function buildIsComplete(criteria) {
-  if (!criteria) return () => false;
-  switch (criteria.type) {
-    case "evidence":
-      return (ctx) => {
-        const minFiles = criteria.minReadFiles ?? 1;
-        return (ctx.state.recentReadPaths?.length ?? 0) >= minFiles;
-      };
-    case "sessions": {
-      let baselineSessionCount;
-      return (ctx) => {
-        const minSessions = criteria.minSessions ?? 1;
-        if (baselineSessionCount === void 0) {
-          baselineSessionCount = ctx.state.sessions.length;
-        }
-        return ctx.state.sessions.length - baselineSessionCount >= minSessions;
-      };
+  if (config3.stallPolicy) {
+    assertPositiveInteger(config3.stallPolicy.nudgeAfter, "stallPolicy.nudgeAfter", config3.name);
+    assertPositiveInteger(
+      config3.stallPolicy.escalateModelAfter,
+      "stallPolicy.escalateModelAfter",
+      config3.name
+    );
+    assertPositiveInteger(config3.stallPolicy.stopAfter, "stallPolicy.stopAfter", config3.name);
+  }
+  if (config3.plugins !== void 0) {
+    if (!Array.isArray(config3.plugins)) {
+      throw new Error(`Playbook '${config3.name}': 'plugins' must be a list of relative module paths`);
+    }
+    for (const plugin of config3.plugins) {
+      if (typeof plugin !== "string" || !plugin.trim()) {
+        throw new Error(`Playbook '${config3.name}': each plugins entry must be a relative module path`);
+      }
     }
-    case "planWritten":
-      return (ctx) => {
-        return ctx.trace.planWritten;
-      };
-    case "never":
-    default:
-      return () => false;
   }
 }
-function buildPolicyIntercept(policy) {
-  if (!policy.blockedTools?.length && !policy.blockDiscoveryTools && !policy.allowedReadGlobs?.length && !policy.allowedWriteGlobs?.length && !policy.requirePlanBeforeWrite) {
-    return void 0;
-  }
-  const blockedSet = new Set(
-    (policy.blockedTools ?? []).map((t) => t.trim()).filter(Boolean)
+function collectPlaybookWarnings(config3) {
+  const warnings = [];
+  const anyCompletable = config3.milestones.some(
+    (m2) => m2.canAcceptCompletion === true || typeof m2.canAcceptCompletion === "function" || isWorkflowHookRef(m2.canAcceptCompletion)
   );
-  const readGlobs = policy.allowedReadGlobs ?? [];
-  const writeGlobs = policy.allowedWriteGlobs ?? [];
-  return (toolName, args, ctx) => {
-    if (blockedSet.has(toolName)) {
-      return `Blocked by playbook policy: ${toolName} is not allowed for this task.`;
-    }
-    if (policy.blockDiscoveryTools && DISCOVERY_TOOLS.has(toolName)) {
-      return `Blocked by playbook policy: discovery tools are disabled for this task.`;
-    }
-    const pathArg = typeof args.path === "string" && args.path.trim() ? ctx.normalizePath(String(args.path)) : void 0;
-    if (pathArg) {
-      const isWrite = toolName === "write_file" || toolName === "restore_file_checkpoint";
-      const isRead = toolName === "read_file";
-      if (isRead && readGlobs.length > 0) {
-        const allowed = micromatch.some(pathArg, readGlobs, { dot: true });
-        if (!allowed) {
-          return `Blocked by playbook policy: ${toolName} path "${pathArg}" is outside allowed read globs: ${readGlobs.join(", ")}`;
-        }
-      }
-      if (isWrite && writeGlobs.length > 0) {
-        const planPath = ctx.state.planPath ? ctx.normalizePath(ctx.state.planPath) : void 0;
-        if (planPath && pathArg === planPath) {
-        } else {
-          const allowed = micromatch.some(pathArg, writeGlobs, { dot: true });
-          if (!allowed) {
-            return `Blocked by playbook policy: ${toolName} path "${pathArg}" is outside allowed write globs: ${writeGlobs.join(", ")}`;
-          }
-        }
-      }
-      if (isWrite && policy.requirePlanBeforeWrite && !ctx.state.planWritten && !ctx.trace.planWritten) {
-        const planPath = ctx.state.planPath ? ctx.normalizePath(ctx.state.planPath) : void 0;
-        if (!planPath || pathArg !== planPath) {
-          return `Blocked by playbook policy: write the plan before creating other files.`;
-        }
-      }
+  if (!anyCompletable) {
+    warnings.push(
+      `Playbook '${config3.name}': no milestone sets canAcceptCompletion: true \u2014 TASK_COMPLETE will never be accepted and the run can only end by stalling or exhausting its budget. Set it on the final milestone.`
+    );
+  }
+  const escalateAfter = config3.stallPolicy?.escalateModelAfter;
+  if (escalateAfter !== void 0) {
+    const anyFallbacks = config3.milestones.some((m2) => m2.fallbackModels?.length);
+    if (!anyFallbacks) {
+      warnings.push(
+        `Playbook '${config3.name}': stallPolicy.escalateModelAfter is set but no milestone defines fallbackModels \u2014 the escalation signal will have no model to switch to.`
+      );
     }
-    return void 0;
-  };
+    const stopAfter = config3.stallPolicy?.stopAfter ?? DEFAULT_STALL_STOP_AFTER;
+    if (escalateAfter >= stopAfter) {
+      warnings.push(
+        `Playbook '${config3.name}': stallPolicy.escalateModelAfter (${escalateAfter}) is not below stopAfter (${stopAfter}) \u2014 the run will stall before model escalation can fire.`
+      );
+    }
+  }
+  return warnings;
 }
-function convertToWorkflow(config3) {
-  const policyIntercept = config3.policy ? buildPolicyIntercept(config3.policy) : void 0;
-  const phases = config3.milestones.map((milestone) => ({
+var PLUGIN_EXTENSIONS = /* @__PURE__ */ new Set([".js", ".mjs", ".cjs"]);
+async function loadPlaybookPlugins(plugins, playbookFilePath, playbookName) {
+  if (!plugins?.length) return;
+  const baseDir = path15.dirname(playbookFilePath);
+  for (const plugin of plugins) {
+    if (path15.isAbsolute(plugin)) {
+      throw new Error(
+        `Playbook '${playbookName}': plugin "${plugin}" must be a relative path (resolved against the playbook's directory).`
+      );
+    }
+    const resolved = path15.resolve(baseDir, plugin);
+    if (resolved !== baseDir && !resolved.startsWith(baseDir + path15.sep)) {
+      throw new Error(
+        `Playbook '${playbookName}': plugin "${plugin}" resolves outside the playbook's directory. Keep plugin modules next to the playbook.`
+      );
+    }
+    if (!PLUGIN_EXTENSIONS.has(path15.extname(resolved).toLowerCase())) {
+      throw new Error(
+        `Playbook '${playbookName}': plugin "${plugin}" must be a .js, .mjs, or .cjs module.`
+      );
+    }
+    if (!fs14.existsSync(resolved)) {
+      throw new Error(`Playbook '${playbookName}': plugin "${plugin}" not found at ${resolved}.`);
+    }
+    const mod = await import(pathToFileURL(resolved).href);
+    if (typeof mod.default !== "function") {
+      throw new Error(
+        `Playbook '${playbookName}': plugin "${plugin}" must export a default function: export default ({ registerWorkflowHook }) => { ... }`
+      );
+    }
+    await mod.default({ registerWorkflowHook });
+  }
+}
+function toWorkflowConfig(config3) {
+  const milestones = config3.milestones.map((milestone) => ({
     name: milestone.name,
-    description: milestone.description,
-    buildInstructions(state) {
-      const header = `--- Workflow Phase: ${milestone.name} ---`;
-      const desc = milestone.description ? `
-${milestone.description}` : "";
-      const instructions = interpolate(milestone.instructions, state);
-      return `${header}${desc}
-${instructions}`;
-    },
-    buildToolGuidance(_state) {
-      return milestone.toolGuidance ?? [];
-    },
-    isComplete: buildIsComplete(milestone.completionCriteria),
-    interceptToolCall: policyIntercept,
-    // Default to rejecting TASK_COMPLETE unless the playbook explicitly allows it.
-    // The SDK accepts completion by default when canAcceptCompletion is undefined,
-    // which would let the model end the marathon prematurely in early phases.
-    canAcceptCompletion: milestone.canAcceptCompletion !== void 0 ? () => milestone.canAcceptCompletion : () => false
+    ...milestone.description !== void 0 ? { description: milestone.description } : {},
+    instructions: milestone.instructions,
+    ...milestone.toolGuidance !== void 0 ? { toolGuidance: milestone.toolGuidance } : {},
+    ...milestone.completionCriteria ? { completionCriteria: milestone.completionCriteria } : {},
+    ...milestone.recovery !== void 0 ? { recovery: milestone.recovery } : {},
+    ...milestone.transitionSummary !== void 0 ? { transitionSummary: milestone.transitionSummary } : {},
+    ...milestone.intercept ? { intercept: milestone.intercept } : {},
+    ...milestone.forceEndTurn ? { forceEndTurn: milestone.forceEndTurn } : {},
+    // Playbooks reject TASK_COMPLETE unless explicitly allowed — the SDK
+    // accepts completion when the slot is absent, which would let the model
+    // end the marathon prematurely in early milestones.
+    canAcceptCompletion: milestone.canAcceptCompletion ?? false
   }));
   return {
     name: config3.name,
-    phases
-  };
-}
-function normalizeFallbackModel(input) {
-  if (typeof input === "string") return { model: input };
-  return {
-    model: input.model,
-    ...input.temperature !== void 0 ? { temperature: input.temperature } : {},
-    ...input.maxTokens !== void 0 ? { maxTokens: input.maxTokens } : {}
+    ...config3.description !== void 0 ? { description: config3.description } : {},
+    ...config3.stallPolicy ? { stallPolicy: config3.stallPolicy } : {},
+    ...config3.policy ? { policy: config3.policy } : {},
+    ...config3.classifyVariant ? { classifyVariant: config3.classifyVariant } : {},
+    ...config3.bootstrap ? { bootstrap: config3.bootstrap } : {},
+    ...config3.candidateBlock ? { candidateBlock: config3.candidateBlock } : {},
+    milestones
   };
 }
-function loadPlaybook(nameOrPath, cwd) {
+async function loadPlaybook(nameOrPath, cwd) {
   const baseCwd = cwd || process.cwd();
   const candidates = getCandidatePaths(nameOrPath, baseCwd);
   for (const candidate of candidates) {
     if (!fs14.existsSync(candidate) || fs14.statSync(candidate).isDirectory()) continue;
-    const config3 = parsePlaybookFile(candidate);
+    const ext = path15.extname(candidate).toLowerCase();
+    const config3 = MODULE_PLAYBOOK_EXTENSIONS.has(ext) ? await loadModulePlaybook(candidate) : parsePlaybookFile(candidate);
     validatePlaybook(config3, candidate);
+    await loadPlaybookPlugins(config3.plugins, candidate, config3.name);
+    ensureDefaultWorkflowHooks();
+    const workflow = compileWorkflowConfig(toWorkflowConfig(config3), {
+      matchPathGlobs: (filePath, globs) => micromatch.some(filePath, globs, { dot: true })
+    });
     const milestoneModels = {};
     const milestoneFallbackModels = {};
     for (const m2 of config3.milestones) {
@@ -55931,13 +56244,14 @@ function loadPlaybook(nameOrPath, cwd) {
       }
     }
     return {
-      workflow: convertToWorkflow(config3),
+      workflow,
       milestones: config3.milestones.map((m2) => m2.name),
       milestoneModels: Object.keys(milestoneModels).length > 0 ? milestoneModels : void 0,
       milestoneFallbackModels: Object.keys(milestoneFallbackModels).length > 0 ? milestoneFallbackModels : void 0,
       verification: config3.verification,
       rules: config3.rules,
-      policy: config3.policy
+      policy: config3.policy,
+      warnings: collectPlaybookWarnings(config3)
     };
   }
   throw new Error(
@@ -55945,6 +56259,14 @@ function loadPlaybook(nameOrPath, cwd) {
 ${candidates.map((c2) => `  ${c2}`).join("\n")}`
   );
 }
+function normalizeFallbackModel(input) {
+  if (typeof input === "string") return { model: input };
+  return {
+    model: input.model,
+    ...input.temperature !== void 0 ? { temperature: input.temperature } : {},
+    ...input.maxTokens !== void 0 ? { maxTokens: input.maxTokens } : {}
+  };
+}
 
 // src/commands/agents-task.ts
 function shouldRequestResumeCheckpoint(status, resumeMessage, noCheckpoint, originalMessage, continuations) {
@@ -56485,12 +56807,19 @@ async function taskAction(agent, options) {
   let playbookMilestoneFallbackModels;
   let playbookPolicy;
   if (options.playbook) {
-    const result = loadPlaybook(options.playbook);
+    const result = await loadPlaybook(options.playbook);
     playbookWorkflow = result.workflow;
     playbookMilestones = result.milestones;
     playbookMilestoneModels = result.milestoneModels;
     playbookMilestoneFallbackModels = result.milestoneFallbackModels;
     playbookPolicy = result.policy;
+    for (const warning of result.warnings) {
+      if (useStartupShell) {
+        setStartupStatus(`playbook warning: ${warning}`);
+      } else {
+        console.log(chalk23.yellow(`Playbook warning: ${warning}`));
+      }
+    }
   } else {
     playbookPolicy = void 0;
   }
@@ -56696,6 +57025,30 @@ ${rulesContext}`;
     return tools;
   };
   localTools = applyOffloadWrapping(localTools);
+  const ledgerOffloadRecorder = offloadOptions ? (details) => {
+    const result = offloadToolOutput(
+      taskName,
+      details.toolName,
+      details.content,
+      {
+        ...offloadOptions,
+        threshold: 0,
+        ledger: { stateFilePath: filePath, agentId, originalMessage: baseMessage },
+        onEvent: (event) => {
+          if (event.kind !== "offloaded") return;
+          reportContextNotice({
+            kind: "tool_output_offloaded",
+            message: `${event.toolName} returned ${Math.ceil(event.outputLength / 4).toLocaleString()} estimated tokens and was offloaded to the context ledger to protect the context window.`,
+            toolName: event.toolName,
+            outputLength: event.outputLength,
+            filePath: event.filePath
+          });
+        }
+      },
+      options.stateDir
+    );
+    return result.offloaded ? { reference: result.content } : void 0;
+  } : void 0;
   let toolsEnabled = true;
   const checkpointHasConfigChanges = (result) => Boolean(result.model) || result.tools === true || result.sandbox !== void 0;
   const rebuildCheckpointTools = () => applyOffloadWrapping(
@@ -56866,6 +57219,20 @@ Saving state... done. Session saved to ${filePath}`);
           break;
       }
     }
+    const stallEscalationUsedModels = /* @__PURE__ */ new Map();
+    const pickNextStallFallbackModel = (phase, currentModel) => {
+      if (!phase) return void 0;
+      const chain = [
+        ...playbookMilestoneFallbackModels?.[phase]?.map((fb) => fb.model) ?? [],
+        ...options.fallbackModel ? [options.fallbackModel] : []
+      ];
+      const used = stallEscalationUsedModels.get(phase) ?? /* @__PURE__ */ new Set();
+      const next = chain.find((model) => model !== currentModel && !used.has(model));
+      if (!next) return void 0;
+      used.add(next);
+      stallEscalationUsedModels.set(phase, used);
+      return next;
+    };
     let shouldContinue = true;
     let accumulatedSessions = 0;
     let accumulatedCost = 0;
@@ -56932,6 +57299,7 @@ Saving state... done. Session saved to ${filePath}`);
         stream: true,
         streamCallbacks: currentStreamCallbacks,
         localTools,
+        ...ledgerOffloadRecorder ? { offloadRecorder: ledgerOffloadRecorder } : {},
         trackProgress: options.track ? taskName : void 0,
         // Mid-run steering queue (Enter while streaming): the UI owns the
         // queue; the SDK drains it at session boundaries and ends in-flight
@@ -57081,6 +57449,20 @@ Saving state... done. Session saved to ${filePath}`);
               });
             }
           }
+          if (state.stallEscalationRequested && state.status === "running") {
+            const escalationPhase = state.workflowPhase;
+            const activeModel = phaseModel || options.model;
+            const nextModel = pickNextStallFallbackModel(escalationPhase, activeModel);
+            if (escalationPhase && nextModel) {
+              playbookMilestoneModels = {
+                ...playbookMilestoneModels ?? {},
+                [escalationPhase]: nextModel
+              };
+              options.model = nextModel;
+              shouldContinue = true;
+              return false;
+            }
+          }
           if (state.recentActionKeys && state.recentActionKeys.length > 0) {
             for (const key of state.recentActionKeys) {
               loopDetector.recordAction(key);
@@ -59901,9 +60283,9 @@ import { execFileSync } from "child_process";
 // src/lib/persona-init.ts
 init_credential_store();
 
-// ../../node_modules/.pnpm/@runtypelabs+persona@3.31.0/node_modules/@runtypelabs/persona/dist/codegen.js
-var S = { name: "@runtypelabs/persona", version: "3.31.0", description: "Themeable, pluggable streaming agent widget for websites, in plain JS with support for voice input and reasoning / tool output.", type: "module", main: "dist/index.cjs", module: "dist/index.js", types: "dist/index.d.ts", exports: { ".": { types: "./dist/index.d.ts", import: "./dist/index.js", require: "./dist/index.cjs" }, "./theme-reference": { types: "./dist/theme-reference.d.ts", import: "./dist/theme-reference.js", require: "./dist/theme-reference.cjs" }, "./codegen": { types: "./dist/codegen.d.ts", import: "./dist/codegen.js", require: "./dist/codegen.cjs" }, "./theme-editor": { types: "./dist/theme-editor.d.ts", import: "./dist/theme-editor.js", require: "./dist/theme-editor.cjs" }, "./testing": { types: "./dist/testing.d.ts", import: "./dist/testing.js", require: "./dist/testing.cjs" }, "./smart-dom-reader": { types: "./dist/smart-dom-reader.d.ts", import: "./dist/smart-dom-reader.js", require: "./dist/smart-dom-reader.cjs" }, "./plugin-kit": { types: "./dist/plugin-kit.d.ts", import: "./dist/plugin-kit.js", require: "./dist/plugin-kit.cjs" }, "./animations/glyph-cycle": { types: "./dist/animations/glyph-cycle.d.ts", import: "./dist/animations/glyph-cycle.js", require: "./dist/animations/glyph-cycle.cjs" }, "./animations/wipe": { types: "./dist/animations/wipe.d.ts", import: "./dist/animations/wipe.js", require: "./dist/animations/wipe.cjs" }, "./widget.css": "./dist/widget.css" }, files: ["dist", "src"], scripts: { build: "rimraf dist && pnpm run build:styles && pnpm run build:client && pnpm run build:installer && pnpm run build:launcher && pnpm run build:theme-ref && pnpm run build:codegen && pnpm run build:theme-editor && pnpm run build:testing && pnpm run build:smart-dom-reader && pnpm run build:plugin-kit && pnpm run build:animations", "build:plugin-kit": "tsup src/plugin-kit.ts --format esm,cjs --minify --dts --out-dir dist --no-splitting", "build:theme-editor": "tsup src/theme-editor.ts --format esm,cjs --minify --dts --out-dir dist --no-splitting", "build:testing": "tsup src/testing.ts --format esm,cjs --minify --dts --out-dir dist --no-splitting", "build:smart-dom-reader": "tsup src/smart-dom-reader.ts --format esm,cjs --minify --dts --out-dir dist --no-splitting", "build:animations": "tsup src/animations/glyph-cycle.ts src/animations/wipe.ts --format esm,cjs --minify --dts --out-dir dist/animations --no-splitting", "build:theme-ref": "tsup src/theme-reference.ts --format esm,cjs --minify --dts", "build:codegen": "tsup src/codegen.ts --format esm,cjs --minify --dts", "build:styles": `node -e "const fs=require('fs');fs.mkdirSync('dist',{recursive:true});fs.copyFileSync('src/styles/widget.css','dist/widget.css');"`, "build:client": `tsup src/index.ts --format esm,cjs --minify --sourcemap --splitting false --dts --loader ".css=text" && tsup src/index-global.ts --format iife --global-name AgentWidget --minify --sourcemap --splitting false --out-dir dist --loader ".css=text" && node -e "const fs=require('fs');for(const ext of ['.global.js','.global.js.map']){const from='dist/index-global'+ext;if(fs.existsSync(from))fs.renameSync(from,'dist/index'+ext);}"`, "build:installer": "tsup src/install.ts --format iife --global-name SiteAgentInstaller --out-dir dist --minify --sourcemap --no-splitting", "build:launcher": `tsup src/launcher-global.ts --format iife --global-name AgentWidgetLauncher --minify --sourcemap --splitting false --out-dir dist && node -e "const fs=require('fs');for(const ext of ['.global.js','.global.js.map']){const from='dist/launcher-global'+ext;if(fs.existsSync(from))fs.renameSync(from,'dist/launcher'+ext);}"`, lint: "eslint . --ext .ts", typecheck: "pnpm run check:runtype-types && tsc --noEmit", test: "vitest", "test:ui": "vitest --ui", "test:run": "vitest run", size: "size-limit", "fetch:runtype-openapi": "node scripts/fetch-runtype-openapi.mjs", "generate:runtype-types": "pnpm run fetch:runtype-openapi && node scripts/generate-runtype-openapi-types.mjs", "check:runtype-types": "pnpm run fetch:runtype-openapi && node scripts/generate-runtype-openapi-types.mjs --check" }, dependencies: { "@mcp-b/webmcp-polyfill": "^3.0.0", dompurify: "^3.3.3", idiomorph: "^0.7.4", lucide: "^0.552.0", marked: "^12.0.2", "partial-json": "^0.1.7", zod: "^3.22.4" }, devDependencies: { "@size-limit/file": "^12.1.0", "@types/node": "^20.12.7", "@typescript-eslint/eslint-plugin": "^7.0.0", "@typescript-eslint/parser": "^7.0.0", "@vitest/ui": "^4.0.9", eslint: "^8.57.0", "eslint-config-prettier": "^9.1.0", "fake-indexeddb": "^6.2.5", rimraf: "^5.0.5", "size-limit": "^12.1.0", tsup: "^8.0.1", typescript: "^5.4.5", vitest: "^4.0.9" }, engines: { node: ">=20.0.0" }, author: "Runtype", license: "MIT", keywords: ["ai", "chat", "widget", "streaming", "typescript", "persona", "agent"], repository: { type: "git", url: "git+https://github.com/runtypelabs/persona.git", directory: "packages/widget" }, bugs: { url: "https://github.com/runtypelabs/persona/issues" }, homepage: "https://github.com/runtypelabs/persona/tree/main/packages/widget#readme", publishConfig: { access: "public" } };
-var c = S.version;
+// ../../node_modules/.pnpm/@runtypelabs+persona@3.34.0/node_modules/@runtypelabs/persona/dist/codegen.js
+var S = "3.34.0";
+var c = S;
 function u(e) {
   if (e !== void 0) return typeof e == "string" ? e : Array.isArray(e) ? `[${e.map((r) => r.toString()).join(", ")}]` : e.toString();
 }
@@ -60065,7 +60447,7 @@ function I(e, r = "esm", n) {
   let s = { ...e };
   delete s.postprocessMessage, delete s.initialMessages;
   let o = n ? { ...n, hooks: T(n.hooks) } : void 0;
-  return r === "esm" ? W(s, o) : r === "script-installer" ? k(s, o) : r === "script-advanced" ? F(s, o) : r === "react-component" ? H(s, o) : r === "react-advanced" ? N(s, o) : D(s, o);
+  return r === "esm" ? W(s, o) : r === "script-installer" ? D(s, o) : r === "script-advanced" ? F(s, o) : r === "react-component" ? H(s, o) : r === "react-advanced" ? N(s, o) : k(s, o);
 }
 function W(e, r) {
   let n = r == null ? void 0 : r.hooks, s = h(e), o = s !== "plain", t = ["import '@runtypelabs/persona/widget.css';", "import { initAgentWidget, markdownPostprocessor } from '@runtypelabs/persona';", "", "initAgentWidget({", `  target: '${g(r)}',`, "  config: {"];
@@ -60161,11 +60543,11 @@ function P(e) {
   }
   return s;
 }
-function k(e, r) {
+function D(e, r) {
   let n = P(e), o = !!(r != null && r.windowKey || r != null && r.target) ? { config: n, ...r != null && r.windowKey ? { windowKey: r.windowKey } : {}, ...r != null && r.target ? { target: r.target } : {} } : n, t = JSON.stringify(o, null, 0).replace(/'/g, "&#39;");
   return `<script src="https://cdn.jsdelivr.net/npm/@runtypelabs/persona@${c}/dist/install.global.js" data-config='${t}'></script>`;
 }
-function D(e, r) {
+function k(e, r) {
   let n = r == null ? void 0 : r.hooks, s = h(e), o = s !== "plain", t = ["<!-- Load CSS -->", `<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@runtypelabs/persona@${c}/dist/widget.css" />`, "", "<!-- Load JavaScript -->", `<script src="https://cdn.jsdelivr.net/npm/@runtypelabs/persona@${c}/dist/index.global.js"></script>`, "", "<!-- Initialize widget -->", "<script>", "  var handle = window.AgentWidget.initAgentWidget({", `    target: '${g(r)}',`, ...r != null && r.windowKey ? [`    windowKey: '${r.windowKey}',`] : [], "    config: {"];
   return e.apiUrl && t.push(`      apiUrl: "${e.apiUrl}",`), e.clientToken && t.push(`      clientToken: "${e.clientToken}",`), e.flowId && t.push(`      flowId: "${e.flowId}",`), o && t.push(`      parserType: "${s}",`), e.theme && typeof e.theme == "object" && Object.keys(e.theme).length > 0 && l(t, "theme", e.theme, "      "), e.launcher && l(t, "launcher", e.launcher, "      "), e.copy && (t.push("      copy: {"), Object.entries(e.copy).forEach(([i, a]) => {
     t.push(`        ${i}: "${a}",`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/cli",
-  "version": "2.18.0",
+  "version": "2.19.1",
   "description": "Command-line interface for Runtype AI platform",
   "type": "module",
   "main": "dist/index.js",
@@ -16,6 +16,7 @@
     "ink": "6.7.0",
     "ink-select-input": "^6.2.0",
     "ink-text-input": "^6.0.0",
+    "jiti": "^2.7.0",
     "micromatch": "^4.0.8",
     "oauth4webapi": "^3.8.5",
     "open": "^10.1.0",
@@ -23,11 +24,11 @@
     "rosie-skills": "0.8.1",
     "yaml": "^2.9.0",
     "@runtypelabs/ink-components": "0.3.2",
-    "@runtypelabs/sdk": "4.10.0",
+    "@runtypelabs/sdk": "4.12.0",
     "@runtypelabs/terminal-animations": "0.2.1"
   },
   "devDependencies": {
-    "@runtypelabs/persona": "3.31.0",
+    "@runtypelabs/persona": "3.34.0",
     "@types/express": "^5.0.6",
     "@types/micromatch": "^4.0.9",
     "@types/node": "^25.3.3",
@@ -38,7 +39,7 @@
     "tsx": "^4.7.1",
     "typescript": "^5.3.3",
     "vitest": "^4.1.0",
-    "@runtypelabs/shared": "1.23.0"
+    "@runtypelabs/shared": "1.26.0"
   },
   "engines": {
     "node": ">=22.0.0"