@runtypelabs/cli 2.17.0 → 2.19.0

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)
@@ -68,9 +73,9 @@ var init_credential_store = __esm({
         }
       }
       getMachineKey() {
-        const hostname3 = os.hostname();
+        const hostname4 = os.hostname();
         const username = os.userInfo().username;
-        return crypto3.createHash("sha256").update(`runtype-cli-${hostname3}-${username}`).digest("hex").substring(0, 32);
+        return crypto3.createHash("sha256").update(`runtype-cli-${hostname4}-${username}`).digest("hex").substring(0, 32);
       }
       async saveCredentials(credentials) {
         const configData = {
@@ -131,15 +136,15 @@ var init_credential_store = __esm({
 });
 
 // src/index.ts
-import { Command as Command32 } from "commander";
-import chalk41 from "chalk";
+import { Command as Command33 } from "commander";
+import chalk42 from "chalk";
 
 // src/lib/load-env.ts
 import { readFileSync } from "fs";
 import { resolve } from "path";
-function loadEnv(path17 = resolve(process.cwd(), ".env")) {
+function loadEnv(path18 = resolve(process.cwd(), ".env")) {
   try {
-    const content = readFileSync(path17, "utf8").replace(/\r\n?/g, "\n");
+    const content = readFileSync(path18, "utf8").replace(/\r\n?/g, "\n");
     for (const line of content.split("\n")) {
       if (!line.trim() || line.trimStart().startsWith("#")) continue;
       const match = line.match(/^\s*([\w.-]+)\s*=\s*(.*)?\s*$/);
@@ -174,8 +179,8 @@ var CallbackServer = class {
   expectedState;
   constructor() {
     this.app = express();
-    this.codePromise = new Promise((resolve10, reject) => {
-      this.codeResolve = resolve10;
+    this.codePromise = new Promise((resolve11, reject) => {
+      this.codeResolve = resolve11;
       this.codeReject = reject;
     });
     this.app.get("/callback", (req, res) => {
@@ -1381,10 +1386,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path17) {
-  if (!path17)
+function getElementAtPath(obj, path18) {
+  if (!path18)
     return obj;
-  return path17.reduce((acc, key) => acc?.[key], obj);
+  return path18.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -1793,11 +1798,11 @@ function explicitlyAborted(x2, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path17, issues) {
+function prefixIssues(path18, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path17);
+    iss.path.unshift(path18);
     return iss;
   });
 }
@@ -1944,16 +1949,16 @@ function flattenError(error51, mapper = (issue2) => issue2.message) {
 }
 function formatError(error51, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error52, path17 = []) => {
+  const processError = (error52, path18 = []) => {
     for (const issue2 of error52.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path17, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path18, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path17, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path18, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path17, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path18, ...issue2.path]);
       } else {
-        const fullpath = [...path17, ...issue2.path];
+        const fullpath = [...path18, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -1980,17 +1985,17 @@ function formatError(error51, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error51, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error52, path17 = []) => {
+  const processError = (error52, path18 = []) => {
     var _a3, _b;
     for (const issue2 of error52.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path17, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path18, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path17, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path18, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path17, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path18, ...issue2.path]);
       } else {
-        const fullpath = [...path17, ...issue2.path];
+        const fullpath = [...path18, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -2022,8 +2027,8 @@ function treeifyError(error51, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path17 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path17) {
+  const path18 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path18) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -14709,13 +14714,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path17 = ref.slice(1).split("/").filter(Boolean);
-  if (path17.length === 0) {
+  const path18 = ref.slice(1).split("/").filter(Boolean);
+  if (path18.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path17[0] === defsKey) {
-    const key = path17[1];
+  if (path18[0] === defsKey) {
+    const key = path18[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -15160,8 +15165,8 @@ var apiRoutingDocSchema = external_exports.object({
 });
 
 // ../shared/dist/chunk-3V2W6XMX.mjs
-function getNestedValue(obj, path17) {
-  let normalizedPath = path17;
+function getNestedValue(obj, path18) {
+  let normalizedPath = path18;
   normalizedPath = normalizedPath.replace(/^\$\.?/, "");
   normalizedPath = normalizedPath.replace(/\[(\d+)\]/g, ".$1");
   normalizedPath = normalizedPath.replace(/\[['"]([^'"\]]+)['"]\]/g, ".$1");
@@ -16095,6 +16100,27 @@ var artifactSSEEventSchema = external_exports.discriminatedUnion("type", [
   artifactCompleteEventSchema,
   artifactSingleEventSchema
 ]);
+var AGENT_CONTENT_CONFIG_KEYS = {
+  model: true,
+  systemPrompt: true,
+  temperature: true,
+  topP: true,
+  topK: true,
+  frequencyPenalty: true,
+  presencePenalty: true,
+  seed: true,
+  tools: true,
+  reasoning: true,
+  advisor: true,
+  loopConfig: true,
+  voice: true,
+  errorHandling: true,
+  artifacts: true,
+  loggingPolicy: true,
+  temporal: true,
+  memory: true
+};
+var AGENT_CONTENT_CONFIG_KEY_LIST = Object.keys(AGENT_CONTENT_CONFIG_KEYS).sort();
 var configurationStatusSchema = external_exports.enum([
   "configured",
   "needs_configuration",
@@ -17594,6 +17620,10 @@ var runtimeArtifactSandboxSchema = external_exports.enum([
 var runtimeArtifactServiceBackingSchema = external_exports.enum(["none", "service-binding"]);
 var runtimeArtifactPersistenceSchema = external_exports.enum(["none", "kv", "service-binding"]);
 var runtimeArtifactKeyModeSchema = external_exports.enum(["own", "platform", "hybrid"]);
+var runtimeArtifactServiceBindingTargetSchema = external_exports.string().regex(
+  /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/,
+  "Service binding target must be a Cloudflare service name (lowercase letters, numbers, and hyphens; no leading/trailing hyphen)."
+);
 var runtimeArtifactBindingTypeSchema = external_exports.enum([
   "service",
   "kv_namespace",
@@ -17613,6 +17643,13 @@ var runtimeArtifactBindingSchema = external_exports.object({
   type: runtimeArtifactBindingTypeSchema,
   target: external_exports.string().min(1).optional(),
   optional: external_exports.boolean().optional()
+}).superRefine((binding, ctx) => {
+  if (binding.type !== "service" || binding.target === void 0) return;
+  const parsed = runtimeArtifactServiceBindingTargetSchema.safeParse(binding.target);
+  if (parsed.success) return;
+  for (const issue2 of parsed.error.issues) {
+    ctx.addIssue({ ...issue2, path: ["target", ...issue2.path] });
+  }
 });
 var runtimeArtifactEligibilityReasonSchema = external_exports.object({
   code: external_exports.string().min(1),
@@ -33460,9 +33497,9 @@ var DEFAULT_MODELS_FOR_NEW_ACCOUNTS = [
   { provider: "runtype", modelId: "gemini-3-1-flash-lite", isDefault: false },
   { provider: "runtype", modelId: "gemini-3-1-flash-image", isDefault: false },
   { provider: "runtype", modelId: "gemini-3.1-pro", isDefault: false },
-  // xAI models (routed via xAI direct, with Vercel fallback)
-  { provider: "runtype", modelId: "grok-4", isDefault: false },
-  { provider: "runtype", modelId: "grok-4-fast", isDefault: false },
+  // xAI models (routed via Vercel, with xAI fallback when available)
+  { provider: "runtype", modelId: "grok-4.3", isDefault: false },
+  { provider: "runtype", modelId: "grok-4.1-fast-non-reasoning", isDefault: false },
   // Inception models (routed via Vercel)
   { provider: "runtype", modelId: "mercury-2", isDefault: false },
   // Moonshot models (routed via Cloudflare Workers AI)
@@ -33483,16 +33520,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()
 });
 var MODEL_FAMILY_PROVIDER_IDS = {
-  "claude-4-opus": {
-    "vercel": "anthropic/claude-4-opus"
-  },
-  "claude-4-sonnet": {
-    "vercel": "anthropic/claude-4-sonnet"
-  },
   "claude-fable-5": {
+    "anthropic": "claude-fable-5",
     "vercel": "anthropic/claude-fable-5"
   },
   "claude-haiku-4-5": {
@@ -33507,12 +33543,13 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   },
   "claude-opus-4": {
     "anthropic": "claude-opus-4-20250514",
-    "bedrock": "bedrock/claude-opus-4",
     "vercel": "anthropic/claude-opus-4"
   },
+  "claude-opus-4-0": {
+    "anthropic": "claude-opus-4-0"
+  },
   "claude-opus-4-1": {
     "anthropic": "claude-opus-4-1-20250805",
-    "bedrock": "bedrock/claude-opus-4-1",
     "vercel": "anthropic/claude-opus-4.1"
   },
   "claude-opus-4-1-20250805": {
@@ -33522,17 +33559,22 @@ var MODEL_FAMILY_PROVIDER_IDS = {
     "anthropic": "claude-opus-4-20250514"
   },
   "claude-opus-4-5": {
-    "anthropic": "anthropic/claude-opus-4-5",
+    "anthropic": "claude-opus-4-5-20251101",
     "vercel": "anthropic/claude-opus-4.5"
   },
+  "claude-opus-4-5-20251101": {
+    "anthropic": "claude-opus-4-5-20251101"
+  },
   "claude-opus-4-6": {
-    "anthropic": "anthropic/claude-opus-4-6",
+    "anthropic": "claude-opus-4-6",
     "vercel": "anthropic/claude-opus-4.6"
   },
   "claude-opus-4-7": {
+    "anthropic": "claude-opus-4-7",
     "vercel": "anthropic/claude-opus-4.7"
   },
   "claude-opus-4-8": {
+    "anthropic": "claude-opus-4-8",
     "vercel": "anthropic/claude-opus-4.8"
   },
   "claude-opus-4.1": {
@@ -33552,9 +33594,11 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   },
   "claude-sonnet-4": {
     "anthropic": "claude-sonnet-4-20250514",
-    "bedrock": "bedrock/claude-sonnet-4",
     "vercel": "anthropic/claude-sonnet-4"
   },
+  "claude-sonnet-4-0": {
+    "anthropic": "claude-sonnet-4-0"
+  },
   "claude-sonnet-4-20250514": {
     "anthropic": "claude-sonnet-4-20250514"
   },
@@ -33566,12 +33610,9 @@ var MODEL_FAMILY_PROVIDER_IDS = {
     "anthropic": "claude-sonnet-4-5-20250929"
   },
   "claude-sonnet-4-6": {
-    "anthropic": "claude-sonnet-4-6-20260217",
+    "anthropic": "claude-sonnet-4-6",
     "vercel": "anthropic/claude-sonnet-4.6"
   },
-  "claude-sonnet-4-6-20260217": {
-    "anthropic": "claude-sonnet-4-6-20260217"
-  },
   "claude-sonnet-4.5": {
     "vercel": "anthropic/claude-sonnet-4.5"
   },
@@ -33584,36 +33625,40 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "codestral-embed": {
     "vercel": "mistral/codestral-embed"
   },
+  "cogito-v2-1-671b": {
+    "togetherai": "togetherai/deepcogito/cogito-v2-1-671b"
+  },
   "command-a": {
     "vercel": "cohere/command-a"
   },
-  "command-r": {
-    "vercel": "cohere/command-r"
-  },
-  "command-r-plus": {
-    "vercel": "cohere/command-r-plus"
+  "deepcogito/cogito-v2-1-671b": {
+    "togetherai": "togetherai/deepcogito/cogito-v2-1-671b"
   },
   "deepseek": {
-    "togetherai": "deepseek-ai/DeepSeek-V3",
+    "togetherai": "togetherai/deepseek-ai/DeepSeek-V3",
     "vercel": "deepseek/deepseek-v3"
   },
-  "deepseek-r1": {
-    "togetherai": "deepseek-ai/DeepSeek-R1",
-    "vercel": "deepseek/deepseek-r1"
+  "deepseek-ai/DeepSeek-R1": {
+    "togetherai": "togetherai/deepseek-ai/DeepSeek-R1"
+  },
+  "deepseek-ai/DeepSeek-V3": {
+    "togetherai": "togetherai/deepseek-ai/DeepSeek-V3"
   },
-  "DeepSeek-R1": {
-    "togetherai": "deepseek-ai/DeepSeek-R1"
+  "deepseek-ai/DeepSeek-V3-1": {
+    "togetherai": "togetherai/deepseek-ai/DeepSeek-V3-1"
   },
-  "deepseek-r1-distill-llama-70b": {
-    "vercel": "deepseek/deepseek-r1-distill-llama-70b"
+  "deepseek-ai/DeepSeek-V4-Pro": {
+    "togetherai": "togetherai/deepseek-ai/DeepSeek-V4-Pro"
+  },
+  "deepseek-r1": {
+    "togetherai": "togetherai/deepseek-ai/DeepSeek-R1",
+    "vercel": "deepseek/deepseek-r1"
   },
   "deepseek-v3": {
     "vercel": "deepseek/deepseek-v3"
   },
-  "DeepSeek-V3": {
-    "togetherai": "deepseek-ai/DeepSeek-V3"
-  },
   "deepseek-v3-1": {
+    "togetherai": "togetherai/deepseek-ai/DeepSeek-V3-1",
     "vercel": "deepseek/deepseek-v3.1"
   },
   "deepseek-v3-1-terminus": {
@@ -33638,6 +33683,7 @@ var MODEL_FAMILY_PROVIDER_IDS = {
     "vercel": "deepseek/deepseek-v4-flash"
   },
   "deepseek-v4-pro": {
+    "togetherai": "togetherai/deepseek-ai/DeepSeek-V4-Pro",
     "vercel": "deepseek/deepseek-v4-pro"
   },
   "devstral-2": {
@@ -33655,91 +33701,162 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "embed-v4.0": {
     "vercel": "cohere/embed-v4.0"
   },
+  "essentialai/Rnj-1-Instruct": {
+    "togetherai": "togetherai/essentialai/Rnj-1-Instruct"
+  },
+  "flux-2-flex": {
+    "vercel": "bfl/flux-2-flex"
+  },
+  "flux-2-klein-4b": {
+    "vercel": "bfl/flux-2-klein-4b"
+  },
+  "flux-2-klein-9b": {
+    "vercel": "bfl/flux-2-klein-9b"
+  },
+  "flux-2-max": {
+    "vercel": "bfl/flux-2-max"
+  },
+  "flux-2-pro": {
+    "vercel": "bfl/flux-2-pro"
+  },
+  "flux-fast-schnell": {
+    "vercel": "prodia/flux-fast-schnell"
+  },
+  "flux-kontext-max": {
+    "vercel": "bfl/flux-kontext-max"
+  },
+  "flux-kontext-pro": {
+    "vercel": "bfl/flux-kontext-pro"
+  },
+  "flux-pro-1-0-fill": {
+    "vercel": "bfl/flux-pro-1.0-fill"
+  },
+  "flux-pro-1-1": {
+    "vercel": "bfl/flux-pro-1.1"
+  },
+  "flux-pro-1-1-ultra": {
+    "vercel": "bfl/flux-pro-1.1-ultra"
+  },
+  "flux-pro-1.0-fill": {
+    "vercel": "bfl/flux-pro-1.0-fill"
+  },
+  "flux-pro-1.1": {
+    "vercel": "bfl/flux-pro-1.1"
+  },
+  "flux-pro-1.1-ultra": {
+    "vercel": "bfl/flux-pro-1.1-ultra"
+  },
   "gemini-2-5-flash": {
-    "google": "google/gemini-2.5-flash-preview",
-    "vercel": "google/gemini-2-5-flash"
+    "google": "gemini-2.5-flash",
+    "vercel": "google/gemini-2.5-flash"
   },
   "gemini-2-5-flash-image": {
     "google": "google/gemini-2.5-flash-image-preview",
     "vercel": "google/gemini-2.5-flash-image"
   },
   "gemini-2-5-flash-lite": {
+    "google": "gemini-2.5-flash-lite",
     "vercel": "google/gemini-2.5-flash-lite"
   },
-  "gemini-2-5-flash-preview-image": {
-    "google": "google/gemini-2.5-flash-preview-image"
+  "gemini-2-5-flash-preview-tts": {
+    "google": "gemini-2.5-flash-preview-tts"
   },
   "gemini-2-5-pro": {
     "google": "gemini-2.5-pro",
-    "vercel": "google/gemini-2-5-pro"
+    "vercel": "google/gemini-2.5-pro"
+  },
+  "gemini-2-5-pro-preview-tts": {
+    "google": "gemini-2.5-pro-preview-tts"
   },
   "gemini-2.5-flash": {
     "google": "gemini-2.5-flash",
     "vercel": "google/gemini-2.5-flash"
   },
   "gemini-2.5-flash-image": {
+    "google": "gemini-2.5-flash-image",
     "vercel": "google/gemini-2.5-flash-image"
   },
   "gemini-2.5-flash-image-preview": {
     "google": "google/gemini-2.5-flash-image-preview"
   },
   "gemini-2.5-flash-lite": {
+    "google": "gemini-2.5-flash-lite",
     "vercel": "google/gemini-2.5-flash-lite"
   },
-  "gemini-2.5-flash-preview": {
-    "google": "google/gemini-2.5-flash-preview"
-  },
-  "gemini-2.5-flash-preview-image": {
-    "google": "google/gemini-2.5-flash-preview-image"
+  "gemini-2.5-flash-preview-tts": {
+    "google": "gemini-2.5-flash-preview-tts"
   },
   "gemini-2.5-pro": {
     "google": "gemini-2.5-pro",
     "vercel": "google/gemini-2.5-pro"
   },
+  "gemini-2.5-pro-preview-tts": {
+    "google": "gemini-2.5-pro-preview-tts"
+  },
   "gemini-3-1-flash-image": {
     "vercel": "google/gemini-3.1-flash-image"
   },
   "gemini-3-1-flash-lite": {
+    "google": "gemini-3.1-flash-lite",
     "vercel": "google/gemini-3.1-flash-lite"
   },
   "gemini-3-1-pro": {
+    "google": "gemini-3.1-pro-preview",
     "vercel": "google/gemini-3.1-pro-preview"
   },
+  "gemini-3-1-pro-preview-customtools": {
+    "google": "gemini-3.1-pro-preview-customtools"
+  },
   "gemini-3-5-flash": {
+    "google": "gemini-3.5-flash",
     "vercel": "google/gemini-3.5-flash"
   },
   "gemini-3-flash": {
-    "google": "google/gemini-3-flash-preview",
+    "google": "gemini-3-flash-preview",
     "vercel": "google/gemini-3-flash"
   },
   "gemini-3-flash-preview": {
-    "google": "google/gemini-3-flash-preview"
+    "google": "gemini-3-flash-preview"
   },
   "gemini-3-pro-image": {
+    "google": "gemini-3-pro-image-preview",
     "vercel": "google/gemini-3-pro-image"
   },
+  "gemini-3-pro-image-preview": {
+    "google": "gemini-3-pro-image-preview"
+  },
   "gemini-3.1-flash-image": {
     "vercel": "google/gemini-3.1-flash-image"
   },
   "gemini-3.1-flash-lite": {
+    "google": "gemini-3.1-flash-lite",
     "vercel": "google/gemini-3.1-flash-lite"
   },
   "gemini-3.1-pro-preview": {
+    "google": "gemini-3.1-pro-preview",
     "vercel": "google/gemini-3.1-pro-preview"
   },
+  "gemini-3.1-pro-preview-customtools": {
+    "google": "gemini-3.1-pro-preview-customtools"
+  },
   "gemini-3.5-flash": {
+    "google": "gemini-3.5-flash",
     "vercel": "google/gemini-3.5-flash"
   },
   "gemini-embedding-001": {
+    "google": "gemini-embedding-001",
     "vercel": "google/gemini-embedding-001"
   },
   "gemini-embedding-2": {
     "vercel": "google/gemini-embedding-2"
   },
   "gemma-4-26b-a4b-it": {
+    "google": "gemma-4-26b-a4b-it",
     "vercel": "google/gemma-4-26b-a4b-it"
   },
   "gemma-4-31b-it": {
+    "google": "gemma-4-31b-it",
+    "togetherai": "togetherai/pearl-ai/gemma-4-31b-it",
     "vercel": "google/gemma-4-31b-it"
   },
   "glm-4-5": {
@@ -33797,9 +33914,11 @@ var MODEL_FAMILY_PROVIDER_IDS = {
     "vercel": "zai/glm-4.7-flashx"
   },
   "glm-5": {
+    "togetherai": "togetherai/zai-org/GLM-5",
     "vercel": "zai/glm-5"
   },
   "glm-5-1": {
+    "togetherai": "togetherai/zai-org/GLM-5.1",
     "vercel": "zai/glm-5.1"
   },
   "glm-5-turbo": {
@@ -33811,87 +33930,47 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "glm-5v-turbo": {
     "vercel": "zai/glm-5v-turbo"
   },
+  "google/gemma-4-31B-it": {
+    "togetherai": "togetherai/google/gemma-4-31B-it"
+  },
   "gpt-4-1": {
     "openai": "gpt-4.1",
-    "vercel": "openai/gpt-4-1"
-  },
-  "gpt-4-1-batch": {
-    "openai": "gpt-4.1-batch"
+    "vercel": "openai/gpt-4.1"
   },
   "gpt-4-1-mini": {
     "openai": "gpt-4.1-mini",
-    "vercel": "openai/gpt-4-1-mini"
-  },
-  "gpt-4-1-mini-batch": {
-    "openai": "gpt-4.1-mini-batch"
+    "vercel": "openai/gpt-4.1-mini"
   },
   "gpt-4-1-nano": {
     "openai": "gpt-4.1-nano",
-    "vercel": "openai/gpt-4-1-nano"
-  },
-  "gpt-4-1-nano-batch": {
-    "openai": "gpt-4.1-nano-batch"
+    "vercel": "openai/gpt-4.1-nano"
   },
   "gpt-4.1": {
     "openai": "gpt-4.1",
     "vercel": "openai/gpt-4.1"
   },
-  "gpt-4.1-batch": {
-    "openai": "gpt-4.1-batch"
-  },
   "gpt-4.1-mini": {
     "openai": "gpt-4.1-mini",
     "vercel": "openai/gpt-4.1-mini"
   },
-  "gpt-4.1-mini-batch": {
-    "openai": "gpt-4.1-mini-batch"
-  },
   "gpt-4.1-nano": {
     "openai": "gpt-4.1-nano",
     "vercel": "openai/gpt-4.1-nano"
   },
-  "gpt-4.1-nano-batch": {
-    "openai": "gpt-4.1-nano-batch"
-  },
   "gpt-4o": {
     "openai": "gpt-4o",
     "vercel": "openai/gpt-4o"
   },
-  "gpt-4o-batch": {
-    "openai": "gpt-4o-batch"
-  },
   "gpt-4o-mini": {
     "openai": "gpt-4o-mini",
     "vercel": "openai/gpt-4o-mini"
   },
-  "gpt-4o-mini-batch": {
-    "openai": "gpt-4o-mini-batch"
-  },
-  "gpt-4o-mini-realtime": {
-    "openai": "openai/gpt-4o-mini-realtime"
-  },
-  "gpt-4o-mini-realtime-batch": {
-    "openai": "gpt-4o-mini-realtime-batch"
-  },
   "gpt-4o-mini-search": {
-    "openai": "openai/openai/gpt-4o-mini-search-preview",
     "vercel": "openai/gpt-4o-mini-search-preview"
   },
   "gpt-4o-mini-search-preview": {
     "vercel": "openai/gpt-4o-mini-search-preview"
   },
-  "gpt-4o-mini-search-preview-batch": {
-    "openai": "openai/gpt-4o-mini-search-preview-batch"
-  },
-  "gpt-4o-realtime": {
-    "openai": "openai/gpt-4o-realtime"
-  },
-  "gpt-4o-realtime-batch": {
-    "openai": "gpt-4o-realtime-batch"
-  },
-  "gpt-4o-search-preview-batch": {
-    "openai": "gpt-4o-search-preview-batch"
-  },
   "gpt-5": {
     "openai": "gpt-5",
     "vercel": "openai/gpt-5"
@@ -33900,26 +33979,18 @@ var MODEL_FAMILY_PROVIDER_IDS = {
     "openai": "gpt-5.1",
     "vercel": "openai/gpt-5.1-thinking"
   },
-  "gpt-5-1-batch": {
-    "openai": "gpt-5.1-batch"
-  },
   "gpt-5-1-codex": {
     "openai": "gpt-5.1-codex",
     "vercel": "openai/gpt-5.1-codex"
   },
-  "gpt-5-1-codex-batch": {
-    "openai": "gpt-5.1-codex-batch"
-  },
   "gpt-5-1-codex-max": {
+    "openai": "gpt-5.1-codex-max",
     "vercel": "openai/gpt-5.1-codex-max"
   },
   "gpt-5-1-codex-mini": {
     "openai": "gpt-5.1-codex-mini",
     "vercel": "openai/gpt-5.1-codex-mini"
   },
-  "gpt-5-1-codex-mini-batch": {
-    "openai": "gpt-5.1-codex-mini-batch"
-  },
   "gpt-5-1-instant": {
     "vercel": "openai/gpt-5.1-instant"
   },
@@ -33927,95 +33998,85 @@ var MODEL_FAMILY_PROVIDER_IDS = {
     "openai": "gpt-5.2",
     "vercel": "openai/gpt-5.2"
   },
-  "gpt-5-2-batch": {
-    "openai": "gpt-5.2-batch"
-  },
   "gpt-5-2-chat": {
     "vercel": "openai/gpt-5.2-chat"
   },
   "gpt-5-2-codex": {
+    "openai": "gpt-5.2-codex",
     "vercel": "openai/gpt-5.2-codex"
   },
   "gpt-5-2-pro": {
     "openai": "gpt-5.2-pro",
     "vercel": "openai/gpt-5.2-pro"
   },
-  "gpt-5-2-pro-batch": {
-    "openai": "gpt-5.2-pro-batch"
-  },
   "gpt-5-3-chat": {
     "vercel": "openai/gpt-5.3-chat"
   },
   "gpt-5-3-codex": {
+    "openai": "gpt-5.3-codex",
     "vercel": "openai/gpt-5.3-codex"
   },
+  "gpt-5-3-codex-spark": {
+    "openai": "gpt-5.3-codex-spark"
+  },
   "gpt-5-4": {
+    "openai": "gpt-5.4",
     "vercel": "openai/gpt-5.4"
   },
   "gpt-5-4-mini": {
+    "openai": "gpt-5.4-mini",
     "vercel": "openai/gpt-5.4-mini"
   },
   "gpt-5-4-nano": {
+    "openai": "gpt-5.4-nano",
     "vercel": "openai/gpt-5.4-nano"
   },
   "gpt-5-4-pro": {
+    "openai": "gpt-5.4-pro",
     "vercel": "openai/gpt-5.4-pro"
   },
   "gpt-5-5": {
+    "openai": "gpt-5.5",
     "vercel": "openai/gpt-5.5"
   },
   "gpt-5-5-pro": {
+    "openai": "gpt-5.5-pro",
     "vercel": "openai/gpt-5.5-pro"
   },
-  "gpt-5-batch": {
-    "openai": "gpt-5-batch"
-  },
   "gpt-5-chat": {
     "vercel": "openai/gpt-5-chat"
   },
   "gpt-5-codex": {
+    "openai": "gpt-5-codex",
     "vercel": "openai/gpt-5-codex"
   },
   "gpt-5-mini": {
     "openai": "gpt-5-mini",
     "vercel": "openai/gpt-5-mini"
   },
-  "gpt-5-mini-batch": {
-    "openai": "gpt-5-mini-batch"
-  },
   "gpt-5-nano": {
     "openai": "gpt-5-nano",
     "vercel": "openai/gpt-5-nano"
   },
-  "gpt-5-nano-batch": {
-    "openai": "gpt-5-nano-batch"
-  },
   "gpt-5-pro": {
+    "openai": "gpt-5-pro",
     "vercel": "openai/gpt-5-pro"
   },
   "gpt-5.1": {
     "openai": "gpt-5.1"
   },
-  "gpt-5.1-batch": {
-    "openai": "gpt-5.1-batch"
-  },
   "gpt-5.1-codex": {
     "openai": "gpt-5.1-codex",
     "vercel": "openai/gpt-5.1-codex"
   },
-  "gpt-5.1-codex-batch": {
-    "openai": "gpt-5.1-codex-batch"
-  },
   "gpt-5.1-codex-max": {
+    "openai": "gpt-5.1-codex-max",
     "vercel": "openai/gpt-5.1-codex-max"
   },
   "gpt-5.1-codex-mini": {
     "openai": "gpt-5.1-codex-mini",
     "vercel": "openai/gpt-5.1-codex-mini"
   },
-  "gpt-5.1-codex-mini-batch": {
-    "openai": "gpt-5.1-codex-mini-batch"
-  },
   "gpt-5.1-instant": {
     "vercel": "openai/gpt-5.1-instant"
   },
@@ -34026,68 +34087,99 @@ var MODEL_FAMILY_PROVIDER_IDS = {
     "openai": "gpt-5.2",
     "vercel": "openai/gpt-5.2"
   },
-  "gpt-5.2-batch": {
-    "openai": "gpt-5.2-batch"
-  },
   "gpt-5.2-chat": {
     "vercel": "openai/gpt-5.2-chat"
   },
   "gpt-5.2-codex": {
+    "openai": "gpt-5.2-codex",
     "vercel": "openai/gpt-5.2-codex"
   },
   "gpt-5.2-pro": {
     "openai": "gpt-5.2-pro",
     "vercel": "openai/gpt-5.2-pro"
   },
-  "gpt-5.2-pro-batch": {
-    "openai": "gpt-5.2-pro-batch"
-  },
   "gpt-5.3-chat": {
     "vercel": "openai/gpt-5.3-chat"
   },
   "gpt-5.3-codex": {
+    "openai": "gpt-5.3-codex",
     "vercel": "openai/gpt-5.3-codex"
   },
+  "gpt-5.3-codex-spark": {
+    "openai": "gpt-5.3-codex-spark"
+  },
   "gpt-5.4": {
+    "openai": "gpt-5.4",
     "vercel": "openai/gpt-5.4"
   },
   "gpt-5.4-mini": {
+    "openai": "gpt-5.4-mini",
     "vercel": "openai/gpt-5.4-mini"
   },
   "gpt-5.4-nano": {
+    "openai": "gpt-5.4-nano",
     "vercel": "openai/gpt-5.4-nano"
   },
   "gpt-5.4-pro": {
+    "openai": "gpt-5.4-pro",
     "vercel": "openai/gpt-5.4-pro"
   },
   "gpt-5.5": {
+    "openai": "gpt-5.5",
     "vercel": "openai/gpt-5.5"
   },
   "gpt-5.5-pro": {
+    "openai": "gpt-5.5-pro",
     "vercel": "openai/gpt-5.5-pro"
   },
+  "gpt-image-1": {
+    "openai": "gpt-image-1",
+    "vercel": "openai/gpt-image-1"
+  },
+  "gpt-image-1-5": {
+    "openai": "gpt-image-1.5",
+    "vercel": "openai/gpt-image-1.5"
+  },
+  "gpt-image-1-mini": {
+    "openai": "gpt-image-1-mini",
+    "vercel": "openai/gpt-image-1-mini"
+  },
+  "gpt-image-1.5": {
+    "openai": "gpt-image-1.5",
+    "vercel": "openai/gpt-image-1.5"
+  },
+  "gpt-image-2": {
+    "vercel": "openai/gpt-image-2"
+  },
   "gpt-oss-120b": {
+    "togetherai": "togetherai/openai/gpt-oss-120b",
     "vercel": "openai/gpt-oss-120b"
   },
   "gpt-oss-20b": {
+    "togetherai": "togetherai/openai/gpt-oss-20b",
     "vercel": "openai/gpt-oss-20b"
   },
   "gpt-oss-safeguard-20b": {
     "vercel": "openai/gpt-oss-safeguard-20b"
   },
-  "grok-4": {
-    "vercel": "xai/grok-4",
-    "xai": "x/grok-4"
-  },
   "grok-4-1-fast-non-reasoning": {
     "vercel": "xai/grok-4.1-fast-non-reasoning"
   },
   "grok-4-1-fast-reasoning": {
     "vercel": "xai/grok-4.1-fast-reasoning"
   },
+  "grok-4-20-0309-non-reasoning": {
+    "xai": "grok-4.20-0309-non-reasoning"
+  },
+  "grok-4-20-0309-reasoning": {
+    "xai": "grok-4.20-0309-reasoning"
+  },
   "grok-4-20-multi-agent": {
     "vercel": "xai/grok-4.20-multi-agent"
   },
+  "grok-4-20-multi-agent-0309": {
+    "xai": "grok-4.20-multi-agent-0309"
+  },
   "grok-4-20-multi-agent-beta": {
     "vercel": "xai/grok-4.20-multi-agent-beta"
   },
@@ -34104,10 +34196,8 @@ var MODEL_FAMILY_PROVIDER_IDS = {
     "vercel": "xai/grok-4.20-reasoning-beta"
   },
   "grok-4-3": {
-    "vercel": "xai/grok-4.3"
-  },
-  "grok-4-fast": {
-    "xai": "x/grok-4-fast"
+    "vercel": "xai/grok-4.3",
+    "xai": "grok-4.3"
   },
   "grok-4.1-fast-non-reasoning": {
     "vercel": "xai/grok-4.1-fast-non-reasoning"
@@ -34115,9 +34205,18 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "grok-4.1-fast-reasoning": {
     "vercel": "xai/grok-4.1-fast-reasoning"
   },
+  "grok-4.20-0309-non-reasoning": {
+    "xai": "grok-4.20-0309-non-reasoning"
+  },
+  "grok-4.20-0309-reasoning": {
+    "xai": "grok-4.20-0309-reasoning"
+  },
   "grok-4.20-multi-agent": {
     "vercel": "xai/grok-4.20-multi-agent"
   },
+  "grok-4.20-multi-agent-0309": {
+    "xai": "grok-4.20-multi-agent-0309"
+  },
   "grok-4.20-multi-agent-beta": {
     "vercel": "xai/grok-4.20-multi-agent-beta"
   },
@@ -34134,16 +34233,51 @@ var MODEL_FAMILY_PROVIDER_IDS = {
     "vercel": "xai/grok-4.20-reasoning-beta"
   },
   "grok-4.3": {
-    "vercel": "xai/grok-4.3"
+    "vercel": "xai/grok-4.3",
+    "xai": "grok-4.3"
   },
   "grok-build-0-1": {
-    "vercel": "xai/grok-build-0.1"
+    "vercel": "xai/grok-build-0.1",
+    "xai": "grok-build-0.1"
   },
   "grok-build-0.1": {
-    "vercel": "xai/grok-build-0.1"
+    "vercel": "xai/grok-build-0.1",
+    "xai": "grok-build-0.1"
+  },
+  "grok-imagine-image": {
+    "vercel": "xai/grok-imagine-image",
+    "xai": "grok-imagine-image"
+  },
+  "grok-imagine-image-quality": {
+    "xai": "grok-imagine-image-quality"
+  },
+  "grok-imagine-video": {
+    "vercel": "xai/grok-imagine-video",
+    "xai": "grok-imagine-video"
+  },
+  "grok-imagine-video-1-5": {
+    "vercel": "xai/grok-imagine-video-1.5-preview"
+  },
+  "grok-imagine-video-1.5-preview": {
+    "vercel": "xai/grok-imagine-video-1.5-preview"
+  },
+  "imagen-4-0-fast-generate-001": {
+    "vercel": "google/imagen-4.0-fast-generate-001"
   },
-  "grok-code-fast-1": {
-    "xai": "x/grok-code-fast-1"
+  "imagen-4-0-generate-001": {
+    "vercel": "google/imagen-4.0-generate-001"
+  },
+  "imagen-4-0-ultra-generate-001": {
+    "vercel": "google/imagen-4.0-ultra-generate-001"
+  },
+  "imagen-4.0-fast-generate-001": {
+    "vercel": "google/imagen-4.0-fast-generate-001"
+  },
+  "imagen-4.0-generate-001": {
+    "vercel": "google/imagen-4.0-generate-001"
+  },
+  "imagen-4.0-ultra-generate-001": {
+    "vercel": "google/imagen-4.0-ultra-generate-001"
   },
   "interfaze-beta": {
     "vercel": "interfaze/interfaze-beta"
@@ -34161,49 +34295,96 @@ var MODEL_FAMILY_PROVIDER_IDS = {
     "vercel": "moonshotai/kimi-k2-thinking"
   },
   "kimi-k2-5": {
+    "togetherai": "togetherai/moonshotai/Kimi-K2.5",
     "vercel": "moonshotai/kimi-k2.5"
   },
   "kimi-k2-6": {
+    "togetherai": "togetherai/moonshotai/Kimi-K2.6",
     "vercel": "moonshotai/kimi-k2.6"
   },
+  "kimi-k2-7-code": {
+    "vercel": "moonshotai/kimi-k2.7-code"
+  },
   "kimi-k2-thinking": {
     "vercel": "moonshotai/kimi-k2-thinking"
   },
-  "kimi-k2-thinking-turbo": {
-    "vercel": "moonshotai/kimi-k2-thinking-turbo"
-  },
-  "kimi-k2-turbo": {
-    "vercel": "moonshotai/kimi-k2-turbo"
-  },
   "kimi-k2.5": {
     "vercel": "moonshotai/kimi-k2.5"
   },
   "kimi-k2.6": {
     "vercel": "moonshotai/kimi-k2.6"
   },
-  "llama-3-1-70b": {
-    "vercel": "meta/llama-3-1-70b"
+  "kimi-k2.7-code": {
+    "vercel": "moonshotai/kimi-k2.7-code"
+  },
+  "kling-v2-5-turbo-i2v": {
+    "vercel": "klingai/kling-v2.5-turbo-i2v"
+  },
+  "kling-v2-5-turbo-t2v": {
+    "vercel": "klingai/kling-v2.5-turbo-t2v"
+  },
+  "kling-v2-6-i2v": {
+    "vercel": "klingai/kling-v2.6-i2v"
+  },
+  "kling-v2-6-motion-control": {
+    "vercel": "klingai/kling-v2.6-motion-control"
+  },
+  "kling-v2-6-t2v": {
+    "vercel": "klingai/kling-v2.6-t2v"
+  },
+  "kling-v2.5-turbo-i2v": {
+    "vercel": "klingai/kling-v2.5-turbo-i2v"
+  },
+  "kling-v2.5-turbo-t2v": {
+    "vercel": "klingai/kling-v2.5-turbo-t2v"
+  },
+  "kling-v2.6-i2v": {
+    "vercel": "klingai/kling-v2.6-i2v"
+  },
+  "kling-v2.6-motion-control": {
+    "vercel": "klingai/kling-v2.6-motion-control"
+  },
+  "kling-v2.6-t2v": {
+    "vercel": "klingai/kling-v2.6-t2v"
+  },
+  "kling-v3-0-i2v": {
+    "vercel": "klingai/kling-v3.0-i2v"
+  },
+  "kling-v3-0-motion-control": {
+    "vercel": "klingai/kling-v3.0-motion-control"
+  },
+  "kling-v3-0-t2v": {
+    "vercel": "klingai/kling-v3.0-t2v"
+  },
+  "kling-v3.0-i2v": {
+    "vercel": "klingai/kling-v3.0-i2v"
+  },
+  "kling-v3.0-motion-control": {
+    "vercel": "klingai/kling-v3.0-motion-control"
+  },
+  "kling-v3.0-t2v": {
+    "vercel": "klingai/kling-v3.0-t2v"
+  },
+  "lfm2-24b-a2b": {
+    "togetherai": "togetherai/LiquidAI/LFM2-24B-A2B"
   },
-  "llama-3-1-8b": {
-    "vercel": "meta/llama-3-1-8b"
+  "LiquidAI/LFM2-24B-A2B": {
+    "togetherai": "togetherai/LiquidAI/LFM2-24B-A2B"
   },
   "llama-3-2-11b": {
-    "vercel": "meta/llama-3-2-11b"
+    "vercel": "meta/llama-3.2-11b"
   },
   "llama-3-2-1b": {
-    "vercel": "meta/llama-3-2-1b"
+    "vercel": "meta/llama-3.2-1b"
   },
   "llama-3-2-3b": {
-    "vercel": "meta/llama-3-2-3b"
+    "vercel": "meta/llama-3.2-3b"
   },
   "llama-3-2-90b": {
-    "vercel": "meta/llama-3-2-90b"
-  },
-  "llama-3-3-70b": {
-    "vercel": "meta/llama-3-3-70b"
+    "vercel": "meta/llama-3.2-90b"
   },
   "llama-3-3-70b-instruct-turbo": {
-    "togetherai": "meta-llama/Llama-3.3-70B-Instruct-Turbo"
+    "togetherai": "togetherai/meta-llama/Llama-3.3-70B-Instruct-Turbo"
   },
   "llama-3.1-70b": {
     "vercel": "meta/llama-3.1-70b"
@@ -34226,17 +34407,14 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "llama-3.3-70b": {
     "vercel": "meta/llama-3.3-70b"
   },
-  "Llama-3.3-70B-Instruct-Turbo": {
-    "togetherai": "meta-llama/Llama-3.3-70B-Instruct-Turbo"
-  },
   "llama3-1-70b": {
-    "vercel": "meta/llama-3-1-70b"
+    "vercel": "meta/llama-3.1-70b"
   },
   "llama3-1-8b": {
-    "vercel": "meta/llama-3-1-8b"
+    "vercel": "meta/llama-3.1-8b"
   },
   "llama3-3-70b": {
-    "vercel": "meta/llama-3-3-70b"
+    "vercel": "meta/llama-3.3-70b"
   },
   "longcat-flash-chat": {
     "vercel": "meituan/longcat-flash-chat"
@@ -34256,29 +34434,8 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "mercury-coder-small": {
     "vercel": "inception/mercury-coder-small"
   },
-  "meta-llama-3-1-405b-instruct-turbo": {
-    "togetherai": "meta-llama/Meta-Llama-3.1-405B-Instruct-Turbo"
-  },
-  "meta-llama-3-1-70b-instruct-turbo": {
-    "togetherai": "meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo"
-  },
-  "meta-llama-3-1-8b-instruct-turbo": {
-    "togetherai": "meta-llama/Meta-Llama-3.1-8B-Instruct-Turbo"
-  },
-  "meta-llama-3-3-70b-instruct-turbo": {
-    "togetherai": "meta-llama/Meta-Llama-3.3-70B-Instruct-Turbo"
-  },
-  "Meta-Llama-3.1-405B-Instruct-Turbo": {
-    "togetherai": "meta-llama/Meta-Llama-3.1-405B-Instruct-Turbo"
-  },
-  "Meta-Llama-3.1-70B-Instruct-Turbo": {
-    "togetherai": "meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo"
-  },
-  "Meta-Llama-3.1-8B-Instruct-Turbo": {
-    "togetherai": "meta-llama/Meta-Llama-3.1-8B-Instruct-Turbo"
-  },
-  "Meta-Llama-3.3-70B-Instruct-Turbo": {
-    "togetherai": "meta-llama/Meta-Llama-3.3-70B-Instruct-Turbo"
+  "meta-llama/Llama-3.3-70B-Instruct-Turbo": {
+    "togetherai": "togetherai/meta-llama/Llama-3.3-70B-Instruct-Turbo"
   },
   "mimo-v2-5": {
     "vercel": "xiaomi/mimo-v2.5"
@@ -34308,6 +34465,7 @@ var MODEL_FAMILY_PROVIDER_IDS = {
     "vercel": "minimax/minimax-m2.1-lightning"
   },
   "minimax-m2-5": {
+    "togetherai": "togetherai/MiniMaxAI/MiniMax-M2.5",
     "vercel": "minimax/minimax-m2.5"
   },
   "minimax-m2-5-highspeed": {
@@ -34315,6 +34473,7 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   },
   "minimax-m2-7": {
     "general-compute": "general-compute/minimax-m2.7",
+    "togetherai": "togetherai/MiniMaxAI/MiniMax-M2.7",
     "vercel": "minimax/minimax-m2.7"
   },
   "minimax-m2-7-highspeed": {
@@ -34342,6 +34501,12 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "minimax-m3": {
     "vercel": "minimax/minimax-m3"
   },
+  "MiniMaxAI/MiniMax-M2.5": {
+    "togetherai": "togetherai/MiniMaxAI/MiniMax-M2.5"
+  },
+  "MiniMaxAI/MiniMax-M2.7": {
+    "togetherai": "togetherai/MiniMaxAI/MiniMax-M2.7"
+  },
   "ministral-14b": {
     "vercel": "mistral/ministral-14b"
   },
@@ -34351,9 +34516,6 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "ministral-8b": {
     "vercel": "mistral/ministral-8b"
   },
-  "mistral-large": {
-    "vercel": "mistral/mistral-large"
-  },
   "mistral-large-3": {
     "vercel": "mistral/mistral-large-3"
   },
@@ -34363,12 +34525,15 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "mistral-medium-3.5": {
     "vercel": "mistral/mistral-medium-3.5"
   },
-  "mistral-saba-24b": {
-    "vercel": "mistral/mistral-saba-24b"
-  },
   "mistral-small": {
     "vercel": "mistral/mistral-small"
   },
+  "moonshotai/Kimi-K2.5": {
+    "togetherai": "togetherai/moonshotai/Kimi-K2.5"
+  },
+  "moonshotai/Kimi-K2.6": {
+    "togetherai": "togetherai/moonshotai/Kimi-K2.6"
+  },
   "morph-v3-fast": {
     "vercel": "morph/morph-v3-fast"
   },
@@ -34382,6 +34547,7 @@ var MODEL_FAMILY_PROVIDER_IDS = {
     "vercel": "nvidia/nemotron-3-super-120b-a12b"
   },
   "nemotron-3-ultra-550b-a55b": {
+    "togetherai": "togetherai/nvidia/nemotron-3-ultra-550b-a55b",
     "vercel": "nvidia/nemotron-3-ultra-550b-a55b"
   },
   "nemotron-nano-12b-v2-vl": {
@@ -34405,26 +34571,36 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "nova-pro": {
     "vercel": "amazon/nova-pro"
   },
+  "nvidia/nemotron-3-ultra-550b-a55b": {
+    "togetherai": "togetherai/nvidia/nemotron-3-ultra-550b-a55b"
+  },
   "o3": {
+    "openai": "o3",
     "vercel": "openai/o3"
   },
   "o3-deep-research": {
+    "openai": "o3-deep-research",
     "vercel": "openai/o3-deep-research"
   },
   "o3-pro": {
+    "openai": "o3-pro",
     "vercel": "openai/o3-pro"
   },
-  "o3-pro-batch": {
-    "openai": "o3-pro-batch"
-  },
   "o4-mini": {
+    "openai": "o4-mini",
     "vercel": "openai/o4-mini"
   },
-  "o4-mini-batch": {
-    "openai": "o4-mini-batch"
+  "o4-mini-deep-research": {
+    "openai": "o4-mini-deep-research"
   },
-  "openai/gpt-4o-mini-search-preview": {
-    "openai": "openai/openai/gpt-4o-mini-search-preview"
+  "openai/gpt-oss-120b": {
+    "togetherai": "togetherai/openai/gpt-oss-120b"
+  },
+  "openai/gpt-oss-20b": {
+    "togetherai": "togetherai/openai/gpt-oss-20b"
+  },
+  "pearl-ai/gemma-4-31b-it": {
+    "togetherai": "togetherai/pearl-ai/gemma-4-31b-it"
   },
   "pixtral-12b": {
     "vercel": "mistral/pixtral-12b"
@@ -34450,26 +34626,55 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "qwen-3.6-max-preview": {
     "vercel": "alibaba/qwen-3.6-max-preview"
   },
+  "Qwen/Qwen3-235B-A22B-Instruct-2507-tput": {
+    "togetherai": "togetherai/Qwen/Qwen3-235B-A22B-Instruct-2507-tput"
+  },
+  "Qwen/Qwen3-Coder-480B-A35B-Instruct-FP8": {
+    "togetherai": "togetherai/Qwen/Qwen3-Coder-480B-A35B-Instruct-FP8"
+  },
+  "Qwen/Qwen3-Coder-Next-FP8": {
+    "togetherai": "togetherai/Qwen/Qwen3-Coder-Next-FP8"
+  },
+  "Qwen/Qwen3.5-397B-A17B": {
+    "togetherai": "togetherai/Qwen/Qwen3.5-397B-A17B"
+  },
+  "Qwen/Qwen3.5-9B": {
+    "togetherai": "togetherai/Qwen/Qwen3.5-9B"
+  },
+  "Qwen/Qwen3.6-Plus": {
+    "togetherai": "togetherai/Qwen/Qwen3.6-Plus"
+  },
+  "Qwen/Qwen3.7-Max": {
+    "togetherai": "togetherai/Qwen/Qwen3.7-Max"
+  },
   "qwen3-235b-a22b": {
     "vercel": "alibaba/qwen3-235b-a22b-thinking"
   },
+  "qwen3-235b-a22b-instruct-2507-tput": {
+    "togetherai": "togetherai/Qwen/Qwen3-235B-A22B-Instruct-2507-tput"
+  },
   "qwen3-235b-a22b-thinking": {
     "vercel": "alibaba/qwen3-235b-a22b-thinking"
   },
   "qwen3-32b": {
     "vercel": "alibaba/qwen-3-32b"
   },
+  "qwen3-5-122b-a10b": {
+    "mixlayer": "qwen/qwen3.5-122b-a10b"
+  },
   "qwen3-5-35b-a3b": {
     "mixlayer": "qwen/qwen3.5-35b-a3b"
   },
   "qwen3-5-397b-a17b": {
-    "mixlayer": "qwen/qwen3.5-397b-a17b"
+    "mixlayer": "qwen/qwen3.5-397b-a17b",
+    "togetherai": "togetherai/Qwen/Qwen3.5-397B-A17B"
   },
   "qwen3-5-4b-free": {
     "mixlayer": "qwen/qwen3.5-4b-free"
   },
   "qwen3-5-9b": {
-    "mixlayer": "qwen/qwen3.5-9b"
+    "mixlayer": "qwen/qwen3.5-9b",
+    "togetherai": "togetherai/Qwen/Qwen3.5-9B"
   },
   "qwen3-5-flash": {
     "vercel": "alibaba/qwen3.5-flash"
@@ -34485,9 +34690,11 @@ var MODEL_FAMILY_PROVIDER_IDS = {
     "mixlayer": "qwen/qwen3.6-35b-a3b"
   },
   "qwen3-6-plus": {
+    "togetherai": "togetherai/Qwen/Qwen3.6-Plus",
     "vercel": "alibaba/qwen3.6-plus"
   },
   "qwen3-7-max": {
+    "togetherai": "togetherai/Qwen/Qwen3.7-Max",
     "vercel": "alibaba/qwen3.7-max"
   },
   "qwen3-7-plus": {
@@ -34499,9 +34706,15 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "qwen3-coder-30b-a3b": {
     "vercel": "alibaba/qwen3-coder-30b-a3b"
   },
+  "qwen3-coder-480b-a35b-instruct-fp8": {
+    "togetherai": "togetherai/Qwen/Qwen3-Coder-480B-A35B-Instruct-FP8"
+  },
   "qwen3-coder-next": {
     "vercel": "alibaba/qwen3-coder-next"
   },
+  "qwen3-coder-next-fp8": {
+    "togetherai": "togetherai/Qwen/Qwen3-Coder-Next-FP8"
+  },
   "qwen3-coder-plus": {
     "vercel": "alibaba/qwen3-coder-plus"
   },
@@ -34547,6 +34760,9 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "qwen3-vl-thinking": {
     "vercel": "alibaba/qwen3-vl-thinking"
   },
+  "qwen3.5-122b-a10b": {
+    "mixlayer": "qwen/qwen3.5-122b-a10b"
+  },
   "qwen3.5-35b-a3b": {
     "mixlayer": "qwen/qwen3.5-35b-a3b"
   },
@@ -34581,6 +34797,72 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "qwen3.7-plus": {
     "vercel": "alibaba/qwen3.7-plus"
   },
+  "recraft": {
+    "vercel": "recraft/recraft-v4"
+  },
+  "recraft-v2": {
+    "vercel": "recraft/recraft-v2"
+  },
+  "recraft-v3": {
+    "vercel": "recraft/recraft-v3"
+  },
+  "recraft-v4": {
+    "vercel": "recraft/recraft-v4"
+  },
+  "recraft-v4-1": {
+    "vercel": "recraft/recraft-v4.1"
+  },
+  "recraft-v4-1-pro": {
+    "vercel": "recraft/recraft-v4.1-pro"
+  },
+  "recraft-v4-1-utility": {
+    "vercel": "recraft/recraft-v4.1-utility"
+  },
+  "recraft-v4-1-utility-pro": {
+    "vercel": "recraft/recraft-v4.1-utility-pro"
+  },
+  "recraft-v4-pro": {
+    "vercel": "recraft/recraft-v4-pro"
+  },
+  "recraft-v4.1": {
+    "vercel": "recraft/recraft-v4.1"
+  },
+  "recraft-v4.1-pro": {
+    "vercel": "recraft/recraft-v4.1-pro"
+  },
+  "recraft-v4.1-utility": {
+    "vercel": "recraft/recraft-v4.1-utility"
+  },
+  "recraft-v4.1-utility-pro": {
+    "vercel": "recraft/recraft-v4.1-utility-pro"
+  },
+  "rerank-2-5": {
+    "vercel": "voyage/rerank-2.5"
+  },
+  "rerank-2-5-lite": {
+    "vercel": "voyage/rerank-2.5-lite"
+  },
+  "rerank-2.5": {
+    "vercel": "voyage/rerank-2.5"
+  },
+  "rerank-2.5-lite": {
+    "vercel": "voyage/rerank-2.5-lite"
+  },
+  "rerank-v3-5": {
+    "vercel": "cohere/rerank-v3.5"
+  },
+  "rerank-v3.5": {
+    "vercel": "cohere/rerank-v3.5"
+  },
+  "rerank-v4-fast": {
+    "vercel": "cohere/rerank-v4-fast"
+  },
+  "rerank-v4-pro": {
+    "vercel": "cohere/rerank-v4-pro"
+  },
+  "rnj-1-instruct": {
+    "togetherai": "togetherai/essentialai/Rnj-1-Instruct"
+  },
   "seed-1-6": {
     "vercel": "bytedance/seed-1.6"
   },
@@ -34593,15 +34875,72 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "seed-1.8": {
     "vercel": "bytedance/seed-1.8"
   },
+  "seedance-2-0": {
+    "vercel": "bytedance/seedance-2.0"
+  },
+  "seedance-2-0-fast": {
+    "vercel": "bytedance/seedance-2.0-fast"
+  },
+  "seedance-2.0": {
+    "vercel": "bytedance/seedance-2.0"
+  },
+  "seedance-2.0-fast": {
+    "vercel": "bytedance/seedance-2.0-fast"
+  },
+  "seedance-v1-0-lite-i2v": {
+    "vercel": "bytedance/seedance-v1.0-lite-i2v"
+  },
+  "seedance-v1-0-lite-t2v": {
+    "vercel": "bytedance/seedance-v1.0-lite-t2v"
+  },
+  "seedance-v1-0-pro": {
+    "vercel": "bytedance/seedance-v1.0-pro"
+  },
+  "seedance-v1-0-pro-fast": {
+    "vercel": "bytedance/seedance-v1.0-pro-fast"
+  },
+  "seedance-v1-5-pro": {
+    "vercel": "bytedance/seedance-v1.5-pro"
+  },
+  "seedance-v1.0-lite-i2v": {
+    "vercel": "bytedance/seedance-v1.0-lite-i2v"
+  },
+  "seedance-v1.0-lite-t2v": {
+    "vercel": "bytedance/seedance-v1.0-lite-t2v"
+  },
+  "seedance-v1.0-pro": {
+    "vercel": "bytedance/seedance-v1.0-pro"
+  },
+  "seedance-v1.0-pro-fast": {
+    "vercel": "bytedance/seedance-v1.0-pro-fast"
+  },
+  "seedance-v1.5-pro": {
+    "vercel": "bytedance/seedance-v1.5-pro"
+  },
+  "seedream-4-0": {
+    "vercel": "bytedance/seedream-4.0"
+  },
+  "seedream-4-5": {
+    "vercel": "bytedance/seedream-4.5"
+  },
+  "seedream-4.0": {
+    "vercel": "bytedance/seedream-4.0"
+  },
+  "seedream-4.5": {
+    "vercel": "bytedance/seedream-4.5"
+  },
+  "seedream-5-0-lite": {
+    "vercel": "bytedance/seedream-5.0-lite"
+  },
+  "seedream-5.0-lite": {
+    "vercel": "bytedance/seedream-5.0-lite"
+  },
   "sonar": {
     "vercel": "perplexity/sonar"
   },
   "sonar-pro": {
     "vercel": "perplexity/sonar-pro"
   },
-  "sonar-reasoning": {
-    "vercel": "perplexity/sonar-reasoning"
-  },
   "sonar-reasoning-pro": {
     "vercel": "perplexity/sonar-reasoning-pro"
   },
@@ -34624,35 +34963,14 @@ var MODEL_FAMILY_PROVIDER_IDS = {
     "openai": "text-embedding-3-large",
     "vercel": "openai/text-embedding-3-large"
   },
-  "text-embedding-3-large-batch": {
-    "openai": "text-embedding-3-large-batch"
-  },
   "text-embedding-3-small": {
     "openai": "text-embedding-3-small",
     "vercel": "openai/text-embedding-3-small"
   },
-  "text-embedding-3-small-batch": {
-    "openai": "text-embedding-3-small-batch"
-  },
-  "text-embedding-ada": {
-    "openai": "text-embedding-ada"
-  },
   "text-embedding-ada-002": {
-    "openai": "text-embedding-ada-002-v2",
+    "openai": "text-embedding-ada-002",
     "vercel": "openai/text-embedding-ada-002"
   },
-  "text-embedding-ada-002-batch": {
-    "openai": "text-embedding-ada-002-batch"
-  },
-  "text-embedding-ada-002-v2": {
-    "openai": "text-embedding-ada-002-v2"
-  },
-  "text-embedding-ada-002-v2-batch": {
-    "openai": "text-embedding-ada-002-v2-batch"
-  },
-  "text-embedding-ada-batch": {
-    "openai": "text-embedding-ada-batch"
-  },
   "text-multilingual-embedding-002": {
     "vercel": "google/text-multilingual-embedding-002"
   },
@@ -34674,17 +34992,29 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "trinity-mini": {
     "vercel": "arcee-ai/trinity-mini"
   },
-  "v0-1-0-md": {
-    "vercel": "v0-1.0-md"
+  "veo-3-0-fast-generate-001": {
+    "vercel": "google/veo-3.0-fast-generate-001"
   },
-  "v0-1-5-md": {
-    "vercel": "v0-1.5-md"
+  "veo-3-0-generate-001": {
+    "vercel": "google/veo-3.0-generate-001"
   },
-  "v0-1.0-md": {
-    "vercel": "v0-1.0-md"
+  "veo-3-1-fast-generate-001": {
+    "vercel": "google/veo-3.1-fast-generate-001"
   },
-  "v0-1.5-md": {
-    "vercel": "v0-1.5-md"
+  "veo-3-1-generate-001": {
+    "vercel": "google/veo-3.1-generate-001"
+  },
+  "veo-3.0-fast-generate-001": {
+    "vercel": "google/veo-3.0-fast-generate-001"
+  },
+  "veo-3.0-generate-001": {
+    "vercel": "google/veo-3.0-generate-001"
+  },
+  "veo-3.1-fast-generate-001": {
+    "vercel": "google/veo-3.1-fast-generate-001"
+  },
+  "veo-3.1-generate-001": {
+    "vercel": "google/veo-3.1-generate-001"
   },
   "voyage-3-5": {
     "vercel": "voyage/voyage-3.5"
@@ -34721,6 +35051,48 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   },
   "voyage-law-2": {
     "vercel": "voyage/voyage-law-2"
+  },
+  "wan-v2-5-t2v": {
+    "vercel": "alibaba/wan-v2.5-t2v-preview"
+  },
+  "wan-v2-6-i2v": {
+    "vercel": "alibaba/wan-v2.6-i2v"
+  },
+  "wan-v2-6-i2v-flash": {
+    "vercel": "alibaba/wan-v2.6-i2v-flash"
+  },
+  "wan-v2-6-r2v": {
+    "vercel": "alibaba/wan-v2.6-r2v"
+  },
+  "wan-v2-6-r2v-flash": {
+    "vercel": "alibaba/wan-v2.6-r2v-flash"
+  },
+  "wan-v2-6-t2v": {
+    "vercel": "alibaba/wan-v2.6-t2v"
+  },
+  "wan-v2.5-t2v-preview": {
+    "vercel": "alibaba/wan-v2.5-t2v-preview"
+  },
+  "wan-v2.6-i2v": {
+    "vercel": "alibaba/wan-v2.6-i2v"
+  },
+  "wan-v2.6-i2v-flash": {
+    "vercel": "alibaba/wan-v2.6-i2v-flash"
+  },
+  "wan-v2.6-r2v": {
+    "vercel": "alibaba/wan-v2.6-r2v"
+  },
+  "wan-v2.6-r2v-flash": {
+    "vercel": "alibaba/wan-v2.6-r2v-flash"
+  },
+  "wan-v2.6-t2v": {
+    "vercel": "alibaba/wan-v2.6-t2v"
+  },
+  "zai-org/GLM-5": {
+    "togetherai": "togetherai/zai-org/GLM-5"
+  },
+  "zai-org/GLM-5.1": {
+    "togetherai": "togetherai/zai-org/GLM-5.1"
   }
 };
 var PLATFORM_KEY_PROVIDER_MAP = {
@@ -34751,12 +35123,13 @@ var MANUAL_PROVIDER_MAP_OVERRIDES = {
   "claude-sonnet-4-5": {
     "bedrock": "anthropic.claude-3-5-sonnet-20241022-v2:0"
   },
-  // xAI uses x/ prefix internally
+  // Legacy xAI aliases route to the current successor model IDs.
   "grok-4": {
-    "xai": "x/grok-4"
+    "vercel": "xai/grok-4.3",
+    "xai": "grok-4.3"
   },
   "grok-4-fast": {
-    "xai": "x/grok-4-fast"
+    "vercel": "xai/grok-4.1-fast-non-reasoning"
   },
   // TogetherAI uses their own model ID format
   "llama-3-3-70b": {
@@ -34775,6 +35148,9 @@ var MANUAL_PROVIDER_MAP_OVERRIDES = {
   "kimi-k2.6": {
     "workers-ai": "@cf/moonshotai/kimi-k2.6"
   },
+  "kimi-k2.7-code": {
+    "workers-ai": "@cf/moonshotai/kimi-k2.7-code"
+  },
   "nemotron-3-120b-a12b": {
     "workers-ai": "@cf/nvidia/nemotron-3-120b-a12b"
   },
@@ -36115,7 +36491,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,
@@ -36258,8 +36635,8 @@ var FLAT_ADVANCED_CONFIG_KEYS = {
 var FLAT_ADVANCED_CONFIG_KEY_LIST = Object.keys(
   FLAT_ADVANCED_CONFIG_KEYS
 );
-function createIssue(severity, code, message, path17, suggestedFix) {
-  return { code, message, path: path17, severity, ...suggestedFix ? { suggestedFix } : {} };
+function createIssue(severity, code, message, path18, suggestedFix) {
+  return { code, message, path: path18, severity, ...suggestedFix ? { suggestedFix } : {} };
 }
 function emptyResult() {
   return { valid: true, errors: [], warnings: [], recommendations: [] };
@@ -36965,16 +37342,16 @@ var fullProductObjectTemplateSchema = external_exports.object({
 });
 var FLOW_PREFIX = "flow:";
 var SECRET_PREFIX = "secret:";
-function collectStringLeafPaths(value, path17 = []) {
+function collectStringLeafPaths(value, path18 = []) {
   if (typeof value === "string") {
-    return [{ path: path17, value }];
+    return [{ path: path18, value }];
   }
   if (Array.isArray(value)) {
-    return value.flatMap((item, index) => collectStringLeafPaths(item, [...path17, String(index)]));
+    return value.flatMap((item, index) => collectStringLeafPaths(item, [...path18, String(index)]));
   }
   if (value && typeof value === "object") {
     return Object.entries(value).flatMap(
-      ([key, nestedValue]) => collectStringLeafPaths(nestedValue, [...path17, key])
+      ([key, nestedValue]) => collectStringLeafPaths(nestedValue, [...path18, key])
     );
   }
   return [];
@@ -37579,7 +37956,8 @@ var PLATFORM_CATALOG = {
     "whatsapp",
     "messaging",
     "telegram",
-    "a2a"
+    "a2a",
+    "chrome_extension"
   ],
   availableFlowPrimitives: FLOW_STEP_TYPES.map((stepType) => {
     const meta3 = FLOW_STEP_TYPE_METADATA[stepType];
@@ -37969,6 +38347,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 = (() => {
@@ -38773,7 +39182,7 @@ function buildDashboardUrl(opts) {
   while (base.endsWith("/")) {
     base = base.slice(0, -1);
   }
-  const path17 = opts.path.startsWith("/") ? opts.path : `/${opts.path}`;
+  const path18 = opts.path.startsWith("/") ? opts.path : `/${opts.path}`;
   const params = new URLSearchParams();
   if (isValidAccountId(opts.account)) {
     params.set(ACCOUNT_QUERY_PARAM, opts.account);
@@ -38786,7 +39195,7 @@ function buildDashboardUrl(opts) {
     }
   }
   const qs = params.toString();
-  return qs ? `${base}${path17}?${qs}` : `${base}${path17}`;
+  return qs ? `${base}${path18}?${qs}` : `${base}${path18}`;
 }
 function parseAccountId(value) {
   if (!value) return null;
@@ -40018,13 +40427,13 @@ function parseJsonObject(raw, label) {
   }
   return parsed;
 }
-function readJsonFile(path17, opts = {}) {
+function readJsonFile(path18, opts = {}) {
   const label = opts.label ?? "file";
   let raw;
   try {
-    raw = readFileSync3(path17, "utf-8");
+    raw = readFileSync3(path18, "utf-8");
   } catch {
-    console.error(chalk2.red(`Failed to read ${label}: ${path17}`));
+    console.error(chalk2.red(`Failed to read ${label}: ${path18}`));
     process.exit(1);
   }
   const obj = parseJsonObject(raw, label);
@@ -40068,14 +40477,14 @@ async function promptConfirm(message, options) {
     output: process.stdout,
     terminal: true
   });
-  return new Promise((resolve10) => {
+  return new Promise((resolve11) => {
     rl.question(chalk3.cyan(`${message} (${hint}): `), (answer) => {
       rl.close();
       const trimmed = answer.trim().toLowerCase();
       if (trimmed === "") {
-        resolve10(defaultYes);
+        resolve11(defaultYes);
       } else {
-        resolve10(trimmed === "y" || trimmed === "yes");
+        resolve11(trimmed === "y" || trimmed === "yes");
       }
     });
   });
@@ -41523,13 +41932,13 @@ promptsCommand.command("delete <id>").description("Delete a prompt").option("--t
     await waitUntilExit2();
     return;
   }
-  const confirmed = await new Promise((resolve10) => {
+  const confirmed = await new Promise((resolve11) => {
     const { unmount } = render4(
       React4.createElement(ConfirmPrompt, {
         message: `Delete prompt ${id}?`,
         defaultValue: false,
         onConfirm: (result) => {
-          resolve10(result);
+          resolve11(result);
           unmount();
         }
       })
@@ -42414,13 +42823,13 @@ secretsCommand.command("delete <id>").description("Delete a secret").option("--t
     await waitUntilExit2();
     return;
   }
-  const confirmed = await new Promise((resolve10) => {
+  const confirmed = await new Promise((resolve11) => {
     const { unmount } = render6(
       React6.createElement(ConfirmPrompt, {
         message: `Delete secret ${id}?`,
         defaultValue: false,
         onConfirm: (result) => {
-          resolve10(result);
+          resolve11(result);
           unmount();
         }
       })
@@ -42832,13 +43241,13 @@ toolsCommand.command("delete <id>").description("Delete a tool").option("--tty",
     await waitUntilExit2();
     return;
   }
-  const confirmed = await new Promise((resolve10) => {
+  const confirmed = await new Promise((resolve11) => {
     const { unmount } = render7(
       React7.createElement(ConfirmPrompt, {
         message: `Delete tool ${id}?`,
         defaultValue: false,
         onConfirm: (result) => {
-          resolve10(result);
+          resolve11(result);
           unmount();
         }
       })
@@ -45229,13 +45638,13 @@ conversationsCommand.command("delete <id>").description("Delete a conversation")
     await waitUntilExit2();
     return;
   }
-  const confirmed = await new Promise((resolve10) => {
+  const confirmed = await new Promise((resolve11) => {
     const { unmount } = render14(
       React14.createElement(ConfirmPrompt, {
         message: `Delete conversation ${id}?`,
         defaultValue: false,
         onConfirm: (result) => {
-          resolve10(result);
+          resolve11(result);
           unmount();
         }
       })
@@ -47492,7 +47901,8 @@ var CHECKPOINT_COMMANDS = [
 var STEERING_SHORTCUTS = [
   { key: "Enter", desc: "Queue a steering message while the agent works" },
   { key: "Tab", desc: "Toggle delivery: next turn / after all work" },
-  { key: "Esc", desc: "Close the composer (keeps your draft)" }
+  { key: "Esc", desc: "Close the composer (keeps your draft)" },
+  { key: "Esc Esc", desc: "Interrupt the agent (queued text restores at the prompt)" }
 ];
 function buildLines(isCheckpoint) {
   const lines = [];
@@ -48185,14 +48595,24 @@ function readSessionEventLog(stateFilePath2, sessionIndex) {
 import * as fs4 from "fs";
 import * as path4 from "path";
 import { randomUUID } from "crypto";
+import * as os3 from "os";
 var TREE_LOG_FORMAT_VERSION = 1;
 function treeLogPathForStateFile(stateFilePath2) {
   return `${stateFilePath2.replace(/\.json$/, "")}.tree.jsonl`;
 }
+function artifactStoreDirForStateFile(stateFilePath2) {
+  return path4.join(path4.dirname(stateFilePath2), path4.basename(stateFilePath2, ".json"), "outputs");
+}
+function artifactRelativePathForStateFile(stateFilePath2, fileName) {
+  return path4.relative(
+    path4.dirname(treeLogPathForStateFile(stateFilePath2)),
+    path4.join(artifactStoreDirForStateFile(stateFilePath2), fileName)
+  ).replace(/\\/g, "/");
+}
 function isTreeLogEntry(value) {
   if (typeof value !== "object" || value === null) return false;
   const record2 = value;
-  return record2.v === TREE_LOG_FORMAT_VERSION && typeof record2.id === "string" && (record2.parentId === null || typeof record2.parentId === "string") && typeof record2.ts === "string" && (record2.type === "meta" || record2.type === "delta" || record2.type === "fork" || record2.type === "head") && typeof record2.payload === "object" && record2.payload !== null;
+  return record2.v === TREE_LOG_FORMAT_VERSION && typeof record2.id === "string" && (record2.parentId === null || typeof record2.parentId === "string") && typeof record2.ts === "string" && (record2.type === "meta" || record2.type === "delta" || record2.type === "fork" || record2.type === "artifact" || record2.type === "summary" || record2.type === "head") && typeof record2.payload === "object" && record2.payload !== null;
 }
 function loadTreeLog(filePath) {
   let raw;
@@ -48281,6 +48701,33 @@ function appendFork(log, fromEntryId, payload) {
   appendLine(log, entry);
   return entry;
 }
+function appendArtifact(log, payload) {
+  const entry = {
+    v: TREE_LOG_FORMAT_VERSION,
+    id: newEntryId(),
+    parentId: log.headId,
+    ts: (/* @__PURE__ */ new Date()).toISOString(),
+    type: "artifact",
+    payload: {
+      ...payload,
+      host: payload.host || os3.hostname()
+    }
+  };
+  appendLine(log, entry);
+  return entry;
+}
+function appendSummary(log, payload) {
+  const entry = {
+    v: TREE_LOG_FORMAT_VERSION,
+    id: newEntryId(),
+    parentId: log.headId,
+    ts: (/* @__PURE__ */ new Date()).toISOString(),
+    type: "summary",
+    payload
+  };
+  appendLine(log, entry);
+  return entry;
+}
 function setHead(log, entryId) {
   if (!log.byId.has(entryId)) {
     throw new Error(`Cannot set head to unknown entry ${entryId}`);
@@ -48345,6 +48792,7 @@ function materializeAtEntry(log, entryId) {
   let meta3 = null;
   let state = null;
   let messages = [];
+  const summaries = [];
   for (const entry of chain) {
     if (entry.type === "meta") {
       meta3 = entry.payload;
@@ -48357,9 +48805,31 @@ function materializeAtEntry(log, entryId) {
       if (entry.payload.truncateAtMessageIndex !== void 0) {
         messages = messages.slice(0, entry.payload.truncateAtMessageIndex);
       }
+    } else if (entry.type === "artifact") {
+    } else if (entry.type === "summary") {
+      summaries.push(entry.payload);
+    }
+  }
+  return { meta: meta3, state, messages, summaries };
+}
+function summariesToContextEntries(summaries) {
+  return summaries.slice(-20).map((summary) => ({
+    id: summary.summaryId,
+    sessionIndex: summary.sessionIndex,
+    mode: summary.mode,
+    strategy: summary.strategy,
+    content: summary.content,
+    createdAt: summary.createdAt
+  }));
+}
+function findArtifactPayload(log, id) {
+  for (const entry of log.entries) {
+    if (entry.type !== "artifact") continue;
+    if (entry.payload.artifactId === id || entry.payload.outputId === id) {
+      return entry.payload;
     }
   }
-  return { meta: meta3, state, messages };
+  return void 0;
 }
 function materializeAtHead(log) {
   if (!log.headId) return null;
@@ -48398,10 +48868,33 @@ function toCheckpoint(state) {
   const {
     messages: _messages,
     sessionSnapshots: _snapshots,
+    contextCompactionSummaries: _summaries,
     ...checkpoint
   } = state;
   return checkpoint;
 }
+function collectNewSummaries(log, state) {
+  const summaries = state.contextCompactionSummaries ?? [];
+  if (summaries.length === 0) return [];
+  const existingIds = new Set(
+    log.entries.filter(
+      (entry) => entry.type === "summary"
+    ).map((entry) => entry.payload.summaryId)
+  );
+  return summaries.filter((summary) => !existingIds.has(summary.id));
+}
+function appendNewSummaries(log, newSummaries) {
+  for (const summary of newSummaries) {
+    appendSummary(log, {
+      summaryId: summary.id,
+      sessionIndex: summary.sessionIndex,
+      mode: summary.mode,
+      strategy: summary.strategy,
+      content: summary.content,
+      createdAt: summary.createdAt
+    });
+  }
+}
 var syncStates = /* @__PURE__ */ new Map();
 function primeTreeLogSyncFromState(stateFilePath2, log, state) {
   syncStates.set(stateFilePath2, {
@@ -48437,15 +48930,19 @@ function syncTreeLogWithState(stateFilePath2, state) {
     const messagesDelta = computeMessagesDelta(sync.lastMessages, nextMessages);
     const checkpoint = toCheckpoint(state);
     const checkpointJson = JSON.stringify(checkpoint);
-    if (!messagesDelta && checkpointJson === sync.lastCheckpointJson) {
+    const newSummaries = collectNewSummaries(sync.log, state);
+    if (!messagesDelta && checkpointJson === sync.lastCheckpointJson && newSummaries.length === 0) {
       return;
     }
-    appendDelta(sync.log, {
-      ...messagesDelta ? { messages: messagesDelta } : {},
-      state: checkpoint
-    });
-    sync.lastMessages = nextMessages.map((message) => structuredClone(message));
-    sync.lastCheckpointJson = checkpointJson;
+    appendNewSummaries(sync.log, newSummaries);
+    if (messagesDelta || checkpointJson !== sync.lastCheckpointJson) {
+      appendDelta(sync.log, {
+        ...messagesDelta ? { messages: messagesDelta } : {},
+        state: checkpoint
+      });
+      sync.lastMessages = nextMessages.map((message) => structuredClone(message));
+      sync.lastCheckpointJson = checkpointJson;
+    }
   } catch {
   }
 }
@@ -48465,6 +48962,13 @@ function entryLabel(entry) {
     const where = entry.payload.truncateAtMessageIndex !== void 0 ? ` @ message ${entry.payload.truncateAtMessageIndex}` : "";
     return entry.payload.label ? `fork${where} \xB7 ${previewText(entry.payload.label)}` : `fork${where}`;
   }
+  if (entry.type === "artifact") {
+    const tool = entry.payload.toolName ? `${entry.payload.toolName} ` : "";
+    return `artifact \xB7 ${tool}${entry.payload.artifactId} (${entry.payload.charLength.toLocaleString()} chars)`;
+  }
+  if (entry.type === "summary") {
+    return `summary \xB7 session ${entry.payload.sessionIndex} ${entry.payload.mode}`;
+  }
   if (entry.type !== "delta") return entry.type;
   const state = entry.payload.state;
   const cost = typeof state.totalCost === "number" ? ` \xB7 $${state.totalCost.toFixed(4)}` : "";
@@ -48503,7 +49007,8 @@ function buildTreeView(log) {
       kind: entry.type,
       label: entryLabel(entry),
       isHead: entry.id === log.headId,
-      isOnHeadPath: onHeadPath.has(entry.id)
+      isOnHeadPath: onHeadPath.has(entry.id),
+      isSelectable: entry.type === "delta" || entry.type === "fork"
     });
     const children = childrenByParent.get(entry.id) ?? [];
     for (const child of children) {
@@ -49372,9 +49877,10 @@ function CheckpointRecap({
   reasoningTokens,
   cost,
   historyWarning,
-  isTerminal
+  isTerminal,
+  isStopped
 }) {
-  const label = isTerminal ? `\u2713 Run ${sessionNumber} complete` : `Run ${sessionNumber} complete`;
+  const label = isStopped ? `Run ${sessionNumber} stopped` : isTerminal ? `\u2713 Run ${sessionNumber} complete` : `Run ${sessionNumber} complete`;
   const separator = theme22.separator ?? " \xB7 ";
   const usageSummary = [
     `Tools: ${toolCallsMade}`,
@@ -49392,7 +49898,7 @@ function CheckpointRecap({
       paddingX: theme22.panelPaddingX,
       paddingY: theme22.panelPaddingY,
       children: [
-        /* @__PURE__ */ jsx23(Text23, { color: isTerminal ? theme22.accentActive : theme22.accent, children: label }),
+        /* @__PURE__ */ jsx23(Text23, { color: isStopped ? theme22.warning : isTerminal ? theme22.accentActive : theme22.accent, children: label }),
         /* @__PURE__ */ jsx23(Text23, { color: theme22.textMuted, children: usageSummary }),
         historyWarning && /* @__PURE__ */ jsx23(Text23, { color: theme22.warning, children: historyWarning })
       ]
@@ -49418,7 +49924,8 @@ function TreePanel({ rows, onSelect, onCancel }) {
       return;
     }
     if (key.return) {
-      if (rows.length > 0) onSelect(rows[selectedIndex]);
+      const selected = rows[selectedIndex];
+      if (selected && selected.isSelectable !== false) onSelect(selected);
       return;
     }
     if (key.upArrow) {
@@ -49455,10 +49962,11 @@ function TreePanel({ rows, onSelect, onCancel }) {
           const indicator = isHighlighted ? "\u203A " : "  ";
           const indent = "  ".repeat(row.depth);
           const headMark = row.isHead ? " \u2190 head" : "";
+          const disabledMark = row.isSelectable === false ? " \xB7 metadata" : "";
           const color = isHighlighted ? theme23.accentActive : row.isOnHeadPath ? theme23.textMuted : theme23.textSubtle;
-          return /* @__PURE__ */ jsx24(Box21, { children: /* @__PURE__ */ jsx24(Text24, { color, bold: isHighlighted, children: `${indicator}${indent}${row.label}${headMark}` }) }, row.entryId);
+          return /* @__PURE__ */ jsx24(Box21, { children: /* @__PURE__ */ jsx24(Text24, { color, bold: isHighlighted, children: `${indicator}${indent}${row.label}${headMark}${disabledMark}` }) }, row.entryId);
         }) }),
-        /* @__PURE__ */ jsx24(Box21, { marginTop: 1, children: /* @__PURE__ */ jsx24(Text24, { color: theme23.textSubtle, children: ["\u2191\u2193 navigate", "Enter switch to entry", "Esc cancel"].join(
+        /* @__PURE__ */ jsx24(Box21, { marginTop: 1, children: /* @__PURE__ */ jsx24(Text24, { color: theme23.textSubtle, children: ["\u2191\u2193 navigate", "Enter switch to checkpoint", "Esc cancel"].join(
           theme23.separator ?? " \xB7 "
         ) }) })
       ]
@@ -49540,10 +50048,11 @@ function ForkPicker({ candidates, onSelect, onCancel }) {
 // src/ink/marathon/checkpoint-prompt-state.ts
 function shouldPauseCheckpointTimer(state) {
   return Boolean(
-    state.isTerminal || state.timeout === 0 || state.isTyping || state.hasPendingChanges || state.showModelPicker || state.showReflectEditor || state.showCommandPicker || state.showTreePanel || state.showForkPicker || state.isReviewing
+    state.isTerminal || state.isStopped || state.timeout === 0 || state.isTyping || state.hasPendingChanges || state.showModelPicker || state.showReflectEditor || state.showCommandPicker || state.showTreePanel || state.showForkPicker || state.isReviewing
   );
 }
 function getCheckpointCountdownText(state) {
+  if (state.isStopped) return "(stopped)";
   if (state.isTerminal) return "(complete)";
   if (state.timeout === 0) return "";
   if (state.isTyping) return "(typing)";
@@ -49564,13 +50073,15 @@ function CheckpointPrompt({
   onLoadForkCandidates,
   timeout,
   isTerminal,
+  isStopped = false,
+  initialMessage,
   currentModel,
   recap,
   isReviewing = false
 }) {
-  const [value, setValue] = useState26("");
+  const [value, setValue] = useState26(initialMessage ?? "");
   const [remaining, setRemaining] = useState26(timeout);
-  const [isTyping, setIsTyping] = useState26(false);
+  const [isTyping, setIsTyping] = useState26(Boolean(initialMessage));
   const [showModelPicker, setShowModelPicker] = useState26(false);
   const [showReflectEditor, setShowReflectEditor] = useState26(false);
   const [showCommandPicker, setShowCommandPicker] = useState26(false);
@@ -49618,7 +50129,7 @@ function CheckpointPrompt({
   };
   useEffect21(() => {
     const title = "Marathon";
-    const body = isTerminal ? "Marathon complete" : `Run ${recap?.sessionNumber ?? "?"} complete`;
+    const body = isStopped ? `Run ${recap?.sessionNumber ?? "?"} stopped` : isTerminal ? "Marathon complete" : `Run ${recap?.sessionNumber ?? "?"} complete`;
     process.stderr.write(`\x1B]777;notify;${title};${body}\x07`);
     process.stderr.write(`\x1B]9;${body}\x07`);
     process.stderr.write("\x07");
@@ -49639,6 +50150,7 @@ function CheckpointPrompt({
   useEffect21(() => {
     if (shouldPauseCheckpointTimer({
       isTerminal,
+      isStopped,
       timeout,
       isTyping,
       hasPendingChanges,
@@ -49671,7 +50183,20 @@ function CheckpointPrompt({
         timerRef.current = null;
       }
     };
-  }, [isTerminal, timeout, isTyping, hasPendingChanges, showModelPicker, showReflectEditor, showCommandPicker, treePanelRows, forkCandidates, isReviewing, onSubmit]);
+  }, [
+    isTerminal,
+    isStopped,
+    timeout,
+    isTyping,
+    hasPendingChanges,
+    showModelPicker,
+    showReflectEditor,
+    showCommandPicker,
+    treePanelRows,
+    forkCandidates,
+    isReviewing,
+    onSubmit
+  ]);
   const handleSubmit = (text) => {
     const trimmed = text.trim();
     const modelArg = trimmed.startsWith("/model") ? trimmed.slice("/model".length).trim() : "";
@@ -49779,6 +50304,7 @@ ${trimmed}` : trimmed);
   };
   const handleTreeSelect = (row) => {
     setTreePanelRows(null);
+    if (row.isSelectable === false) return;
     if (row.isHead) return;
     setPendingFork(void 0);
     setPendingTreeHead({ entryId: row.entryId, label: row.label });
@@ -49790,6 +50316,7 @@ ${trimmed}` : trimmed);
   };
   const countdownText = getCheckpointCountdownText({
     isTerminal,
+    isStopped,
     timeout,
     isTyping,
     hasPendingChanges,
@@ -49808,17 +50335,11 @@ ${trimmed}` : trimmed);
   const enterHint = (() => {
     if (isCommandDraft) return "Enter: stage command";
     if (pendingStop || hasPendingChanges || isTyping) return "Enter: submit";
-    if (isTerminal) return "Enter: exit";
+    if (isTerminal || isStopped) return "Enter: exit";
     return "Enter: continue";
   })();
   return /* @__PURE__ */ jsxs22(Box23, { flexDirection: "column", flexShrink: 0, children: [
-    showCommandPicker ? /* @__PURE__ */ jsx26(
-      CommandPicker,
-      {
-        onSelect: handleCommandSelect,
-        onCancel: handleCommandCancel
-      }
-    ) : treePanelRows !== null ? /* @__PURE__ */ jsx26(
+    showCommandPicker ? /* @__PURE__ */ jsx26(CommandPicker, { onSelect: handleCommandSelect, onCancel: handleCommandCancel }) : treePanelRows !== null ? /* @__PURE__ */ jsx26(
       TreePanel,
       {
         rows: treePanelRows,
@@ -49839,13 +50360,7 @@ ${trimmed}` : trimmed);
         onSelect: handleModelSelect,
         onCancel: handleModelCancel
       }
-    ) : showReflectEditor ? /* @__PURE__ */ jsx26(
-      ReflectEditor,
-      {
-        onSubmit: handleReflectSubmit,
-        onCancel: handleReflectCancel
-      }
-    ) : /* @__PURE__ */ jsxs22(
+    ) : showReflectEditor ? /* @__PURE__ */ jsx26(ReflectEditor, { onSubmit: handleReflectSubmit, onCancel: handleReflectCancel }) : /* @__PURE__ */ jsxs22(
       Box23,
       {
         borderStyle: "bold",
@@ -49867,7 +50382,7 @@ ${trimmed}` : trimmed);
                 value,
                 onChange: handleChange,
                 onSubmit: handleSubmit,
-                placeholder: isTerminal ? "Send new instructions to continue marathon, or press enter to exit..." : "Guide next iteration..."
+                placeholder: isStopped ? "Send new instructions to continue, or press enter to exit..." : isTerminal ? "Send new instructions to continue marathon, or press enter to exit..." : "Guide next iteration..."
               }
             ) }),
             countdownText && /* @__PURE__ */ jsxs22(Text26, { color: theme25.textSubtle, children: [
@@ -49875,16 +50390,12 @@ ${trimmed}` : trimmed);
               countdownText
             ] })
           ] }),
-          /* @__PURE__ */ jsx26(Text26, { color: theme25.textSubtle, children: [
-            enterHint,
-            "/: commands",
-            "/help"
-          ].join(separator) }),
+          /* @__PURE__ */ jsx26(Text26, { color: theme25.textSubtle, children: [enterHint, "/: commands", "/help"].join(separator) }),
           pendingSummary.length > 0 && /* @__PURE__ */ jsx26(Text26, { color: theme25.textMuted, children: `Pending: ${pendingSummary.join(separator)}` })
         ]
       }
     ),
-    /* @__PURE__ */ jsx26(CheckpointRecap, { ...recap, isTerminal })
+    /* @__PURE__ */ jsx26(CheckpointRecap, { ...recap, isTerminal, isStopped })
   ] });
 }
 
@@ -50830,7 +51341,7 @@ function MarathonApp({
   stateFilePath: stateFilePath2,
   debug: _debug,
   plainText,
-  noCheckpoint: _noCheckpoint,
+  noCheckpoint = false,
   checkpointTimeout,
   workflowMilestones,
   currentMilestone: initialCurrentMilestone,
@@ -50838,6 +51349,7 @@ function MarathonApp({
   billingUrl,
   onSaveState,
   onComplete: _onComplete,
+  onAbortTurn,
   streamRef
 }) {
   const {
@@ -50876,6 +51388,7 @@ function MarathonApp({
   const [previewUrl, setPreviewUrl] = useState31(initialPreviewUrl);
   const [isCheckpointExploring, setIsCheckpointExploring] = useState31(false);
   const isRunnerAnimating = state.phase === "thinking" || state.phase === "streaming" || state.phase === "tool" || Boolean(state.contextCompaction?.active);
+  const isAgentWorkingPhase = state.phase === "thinking" || state.phase === "streaming" || state.phase === "tool";
   const isTerminalCheckpointRef = useRef9(false);
   const markCheckpointExploring = useCallback8(() => {
     if (state.phase === "checkpoint" && checkpointRecap) {
@@ -50895,6 +51408,8 @@ function MarathonApp({
   const handleCheckpointSubmit = useCallback8(
     (result) => {
       setIsCheckpointExploring(false);
+      setIsStoppedCheckpoint(false);
+      setCheckpointInitialMessage(void 0);
       if (result.model) {
         setCurrentModel(result.model);
       }
@@ -50957,12 +51472,10 @@ function MarathonApp({
         setCheckpoint();
         setCheckpointRecap(recap);
         setIsCheckpointExploring(false);
-        if (isTerminal) {
-          setIsTerminalCheckpoint(true);
-          isTerminalCheckpointRef.current = true;
-        }
-        return new Promise((resolve10) => {
-          checkpointResolveRef.current = resolve10;
+        setIsTerminalCheckpoint(Boolean(isTerminal));
+        isTerminalCheckpointRef.current = Boolean(isTerminal);
+        return new Promise((resolve11) => {
+          checkpointResolveRef.current = resolve11;
         });
       },
       updateMilestone: (milestone) => {
@@ -51002,6 +51515,18 @@ function MarathonApp({
   const toolPanelWidth = terminalWidth < NARROW_THRESHOLD ? TOOL_PANEL_NARROW : TOOL_PANEL_WIDE;
   const [ctrlCPressed, setCtrlCPressed] = useState31(false);
   const ctrlCTimeout = useRef9(null);
+  const [escAbortArmed, setEscAbortArmed] = useState31(false);
+  const escAbortTimeout = useRef9(null);
+  const [isStoppedCheckpoint, setIsStoppedCheckpoint] = useState31(false);
+  const [checkpointInitialMessage, setCheckpointInitialMessage] = useState31(
+    void 0
+  );
+  useEffect25(() => {
+    if (!isAgentWorkingPhase && escAbortArmed) {
+      if (escAbortTimeout.current) clearTimeout(escAbortTimeout.current);
+      setEscAbortArmed(false);
+    }
+  }, [isAgentWorkingPhase, escAbortArmed]);
   const steeringQueueRef = useRef9([]);
   const followUpQueueRef = useRef9([]);
   const [queuedSteerCount, setQueuedSteerCount] = useState31(0);
@@ -51340,6 +51865,10 @@ function MarathonApp({
     [filteredEvents]
   );
   useInput14((_input, key) => {
+    if (escAbortArmed && !key.escape) {
+      if (escAbortTimeout.current) clearTimeout(escAbortTimeout.current);
+      setEscAbortArmed(false);
+    }
     if (_input === "u" && upgradePrompt) {
       void open4(billingPageUrl);
       setUpgradeModalDismissed(true);
@@ -51495,6 +52024,24 @@ function MarathonApp({
         setActiveScreen("overview");
       } else if (goalExpanded) {
         setGoalExpanded(false);
+      } else if (state.phase === "thinking" || state.phase === "streaming" || state.phase === "tool") {
+        if (escAbortArmed) {
+          if (escAbortTimeout.current) clearTimeout(escAbortTimeout.current);
+          setEscAbortArmed(false);
+          if (onAbortTurn?.() && !noCheckpoint) {
+            const queued = steeringQueueRef.current.splice(0);
+            setQueuedSteerCount(0);
+            const restored = [...queued, steerDraft].map((text) => text.trim()).filter(Boolean).join("\n\n");
+            setSteerDraft("");
+            setCheckpointInitialMessage(restored || void 0);
+            setIsStoppedCheckpoint(true);
+          }
+        } else {
+          setEscAbortArmed(true);
+          escAbortTimeout.current = setTimeout(() => {
+            setEscAbortArmed(false);
+          }, 3e3);
+        }
       }
       return;
     }
@@ -51780,6 +52327,7 @@ function MarathonApp({
   const statusRight = (() => {
     const joinHints = (...parts) => parts.filter(Boolean).join(separator);
     if (ctrlCPressed) return "Press Ctrl+C again to exit";
+    if (escAbortArmed) return "Press Esc again to interrupt the agent";
     if (clipboardFlash) return clipboardFlash;
     if (showUpgradeModal) return joinHints("u: upgrade", "Enter: upgrade", "Esc: close", "Ctrl+C");
     if (state.phase === "error" && !canBrowseAfterUpgradeError) return joinHints("Enter: exit", "Ctrl+C");
@@ -52048,6 +52596,8 @@ function MarathonApp({
                         onLoadForkCandidates: handleLoadForkCandidates,
                         timeout: checkpointTimeout ?? 10,
                         isTerminal: isTerminalCheckpoint,
+                        isStopped: isStoppedCheckpoint,
+                        initialMessage: checkpointInitialMessage,
                         currentModel,
                         currentSandbox,
                         recap: checkpointRecap,
@@ -52330,16 +52880,16 @@ function MarathonStartupShell({
   latestAppPropsRef.current = marathonAppProps;
   useEffect26(() => {
     if (scene !== "app" || !appReadyResolverRef.current) return;
-    const resolve10 = appReadyResolverRef.current;
+    const resolve11 = appReadyResolverRef.current;
     appReadyResolverRef.current = null;
-    resolve10();
+    resolve11();
   }, [scene]);
   const beginTransition = (target) => {
     if (transitionPromiseRef.current) return transitionPromiseRef.current;
     if (target === "app" && !latestAppPropsRef.current) {
       throw new Error("Cannot complete startup before marathon app props are ready.");
     }
-    const promise2 = new Promise((resolve10) => {
+    const promise2 = new Promise((resolve11) => {
       globalThis.setTimeout(() => {
         setPrompt(null);
         setModelChoices(null);
@@ -52360,12 +52910,12 @@ function MarathonStartupShell({
         if (target === "app") {
           appReadyResolverRef.current = () => {
             transitionPromiseRef.current = null;
-            resolve10();
+            resolve11();
           };
         } else {
           dismissResolverRef.current = () => {
             transitionPromiseRef.current = null;
-            resolve10();
+            resolve11();
           };
         }
       }, Math.max(0, MIN_HOLD_MS - (Date.now() - mountedAtRef.current)));
@@ -52382,8 +52932,8 @@ function MarathonStartupShell({
         setModelChoices(null);
         setPrompt(nextPrompt);
         setSelectedPromptIndex(0);
-        return new Promise((resolve10) => {
-          promptResolverRef.current = resolve10;
+        return new Promise((resolve11) => {
+          promptResolverRef.current = resolve11;
         });
       },
       requestModelChoice: async (nextCurrentModel, models) => {
@@ -52391,8 +52941,8 @@ function MarathonStartupShell({
         setPlaybookConfirm(null);
         setCurrentModel(nextCurrentModel);
         setModelChoices(models);
-        return new Promise((resolve10) => {
-          modelResolverRef.current = resolve10;
+        return new Promise((resolve11) => {
+          modelResolverRef.current = resolve11;
         });
       },
       requestPlaybookModelConfirm: async (playbookName, milestoneModels) => {
@@ -52407,8 +52957,8 @@ function MarathonStartupShell({
           // Default selection is the "Confirm" action (first item after milestones)
           selectedIndex: names.length
         });
-        return new Promise((resolve10) => {
-          playbookConfirmResolverRef.current = resolve10;
+        return new Promise((resolve11) => {
+          playbookConfirmResolverRef.current = resolve11;
         });
       },
       completeStartup: () => beginTransition("app"),
@@ -52675,7 +53225,7 @@ function MarathonStartupShell({
 }
 
 // src/commands/agents-task.ts
-import * as fs14 from "fs";
+import * as fs15 from "fs";
 import {
   RuntypeClient as RuntypeClient2,
   defaultWorkflow,
@@ -52706,12 +53256,12 @@ import * as fs7 from "fs";
 import * as path8 from "path";
 
 // src/config/paths.ts
-import * as os3 from "os";
+import * as os4 from "os";
 import * as path7 from "path";
 import * as crypto4 from "crypto";
 import * as fs6 from "fs";
 function getRuntypeHomeDir() {
-  return process.env.RUNTYPE_STATE_DIR || path7.join(os3.homedir(), ".runtype");
+  return process.env.RUNTYPE_STATE_DIR || path7.join(os4.homedir(), ".runtype");
 }
 function getProjectStateDir(projectDir) {
   const dir = projectDir || process.cwd();
@@ -52735,20 +53285,23 @@ function defaultStateDir() {
 function stateSafeName(name) {
   return name.replace(/[^a-zA-Z0-9_-]/g, "_");
 }
-function marathonArtifactsDir(taskName, stateDir) {
+function marathonArtifactsDir(taskName, stateDir, stateFilePath2) {
+  if (stateFilePath2) {
+    return path8.join(path8.dirname(stateFilePath2), path8.basename(stateFilePath2, ".json"));
+  }
   return path8.join(stateDir || defaultStateDir(), stateSafeName(taskName));
 }
-function resolveMarathonCheckpointPath(taskName, targetPath, stateDir) {
+function resolveMarathonCheckpointPath(taskName, targetPath, stateDir, stateFilePath2) {
   const normalizedTargetPath = path8.normalize(targetPath);
   const relativeTargetPath = path8.isAbsolute(normalizedTargetPath) ? path8.relative(process.cwd(), normalizedTargetPath) : normalizedTargetPath;
   return path8.join(
-    marathonArtifactsDir(taskName, stateDir),
+    marathonArtifactsDir(taskName, stateDir, stateFilePath2),
     "checkpoints",
     "original",
     relativeTargetPath
   );
 }
-function ensureMarathonFileCheckpoint(taskName, targetPath, stateDir) {
+function ensureMarathonFileCheckpoint(taskName, targetPath, stateDir, stateFilePath2) {
   const normalizedTargetPath = path8.resolve(targetPath);
   const relativeTargetPath = path8.relative(process.cwd(), normalizedTargetPath);
   if (!relativeTargetPath || relativeTargetPath.startsWith("..")) return void 0;
@@ -52757,13 +53310,18 @@ function ensureMarathonFileCheckpoint(taskName, targetPath, stateDir) {
   const normalizedRelativeTargetPath = relativeTargetPath.replace(/\\/g, "/");
   if (normalizedRelativeTargetPath.startsWith(".runtype/")) return void 0;
   if (normalizedTargetPath.startsWith(getRuntypeHomeDir() + path8.sep)) return void 0;
-  const checkpointPath = resolveMarathonCheckpointPath(taskName, normalizedTargetPath, stateDir);
+  const checkpointPath = resolveMarathonCheckpointPath(
+    taskName,
+    normalizedTargetPath,
+    stateDir,
+    stateFilePath2
+  );
   if (fs7.existsSync(checkpointPath)) return checkpointPath;
   fs7.mkdirSync(path8.dirname(checkpointPath), { recursive: true });
   fs7.copyFileSync(normalizedTargetPath, checkpointPath);
   return checkpointPath;
 }
-function restoreMarathonFileCheckpoint(taskName, targetPath, stateDir) {
+function restoreMarathonFileCheckpoint(taskName, targetPath, stateDir, stateFilePath2) {
   const normalizedTargetPath = path8.resolve(targetPath);
   const relativeTargetPath = path8.relative(process.cwd(), normalizedTargetPath);
   if (!relativeTargetPath || relativeTargetPath.startsWith("..")) {
@@ -52772,7 +53330,12 @@ function restoreMarathonFileCheckpoint(taskName, targetPath, stateDir) {
       error: `Cannot restore checkpoint outside the current repository: ${normalizedTargetPath}`
     };
   }
-  const checkpointPath = resolveMarathonCheckpointPath(taskName, normalizedTargetPath, stateDir);
+  const checkpointPath = resolveMarathonCheckpointPath(
+    taskName,
+    normalizedTargetPath,
+    stateDir,
+    stateFilePath2
+  );
   if (!fs7.existsSync(checkpointPath)) {
     return {
       restored: false,
@@ -52897,16 +53460,33 @@ async function retryOnNetworkError(fn, opts = {}) {
   const maxDelay = opts.maxDelayMs ?? 6e4;
   let lastError;
   for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    if (attempt > 0 && opts.signal?.aborted) {
+      throw lastError;
+    }
     try {
       return await fn();
     } catch (error51) {
       lastError = error51;
-      if (!isTransientNetworkError(error51) || attempt === maxRetries) {
+      if (opts.signal?.aborted || !isTransientNetworkError(error51) || attempt === maxRetries) {
         throw error51;
       }
       const delay = Math.min(baseDelay * 2 ** attempt, maxDelay);
       opts.onRetry?.(attempt + 1, delay, error51);
-      await new Promise((resolve10) => setTimeout(resolve10, delay));
+      await new Promise((resolve11) => {
+        const signal = opts.signal;
+        const onAbort = () => {
+          clearTimeout(timer);
+          resolve11();
+        };
+        const timer = setTimeout(() => {
+          signal?.removeEventListener("abort", onAbort);
+          resolve11();
+        }, delay);
+        if (signal) {
+          if (signal.aborted) onAbort();
+          else signal.addEventListener("abort", onAbort, { once: true });
+        }
+      });
     }
   }
   throw lastError;
@@ -53166,14 +53746,14 @@ async function promptNumericSelect(choices, promptLabel) {
     output: process.stdout,
     terminal: true
   });
-  return new Promise((resolve10) => {
+  return new Promise((resolve11) => {
     const ask = () => {
       rl.question(chalk21.cyan(`
 ${promptLabel} (1-${choices.length}): `), (answer) => {
         const value = parseInt(answer.trim(), 10);
         if (value >= 1 && value <= choices.length) {
           rl.close();
-          resolve10(choices[value - 1].value);
+          resolve11(choices[value - 1].value);
           return;
         }
         console.log(chalk21.red(`Please enter a number between 1 and ${choices.length}.`));
@@ -53201,7 +53781,7 @@ ${message}`));
   const previousRawMode = input.isRaw === true;
   let selectedIndex = 0;
   let renderedLineCount = 0;
-  return new Promise((resolve10) => {
+  return new Promise((resolve11) => {
     const renderMenu = () => {
       if (renderedLineCount > 0) {
         clearRenderedLines(output, renderedLineCount);
@@ -53223,7 +53803,7 @@ ${message}`));
     };
     const finish = (value) => {
       cleanup();
-      resolve10(value);
+      resolve11(value);
     };
     const onKeypress = (_, key) => {
       if (key.ctrl && key.name === "c") {
@@ -53373,7 +53953,9 @@ function sanitizeMarathonSessionSnapshots(snapshots) {
     };
     bySessionIndex.set(sanitizedSnapshot.sessionIndex, sanitizedSnapshot);
   }
-  return Array.from(bySessionIndex.values()).sort((left, right) => left.sessionIndex - right.sessionIndex);
+  return Array.from(bySessionIndex.values()).sort(
+    (left, right) => left.sessionIndex - right.sessionIndex
+  );
 }
 function upsertMarathonSessionSnapshot(snapshots, nextSnapshot) {
   const bySessionIndex = /* @__PURE__ */ new Map();
@@ -53381,7 +53963,9 @@ function upsertMarathonSessionSnapshot(snapshots, nextSnapshot) {
     bySessionIndex.set(snapshot.sessionIndex, cloneSessionSnapshot2(snapshot));
   }
   bySessionIndex.set(nextSnapshot.sessionIndex, cloneSessionSnapshot2(nextSnapshot));
-  return Array.from(bySessionIndex.values()).sort((left, right) => left.sessionIndex - right.sessionIndex);
+  return Array.from(bySessionIndex.values()).sort(
+    (left, right) => left.sessionIndex - right.sessionIndex
+  );
 }
 function mergeMarathonSessionSummaries(existingSessions, nextSessions, offset) {
   const byIndex = /* @__PURE__ */ new Map();
@@ -53434,7 +54018,9 @@ function sanitizeLoadedMarathonState(state) {
     (candidatePath) => marathonStatePathExists(candidatePath)
   );
   const normalizedBestCandidate = normalizeMarathonStatePath(state.bestCandidatePath);
-  const bestCandidatePath = normalizedBestCandidate && !isMarathonArtifactStatePath(normalizedBestCandidate) && marathonStatePathExists(normalizedBestCandidate) ? normalizedBestCandidate : [...candidatePaths, ...recentReadPaths].sort((left, right) => scoreMarathonCandidatePath(right) - scoreMarathonCandidatePath(left))[0];
+  const bestCandidatePath = normalizedBestCandidate && !isMarathonArtifactStatePath(normalizedBestCandidate) && marathonStatePathExists(normalizedBestCandidate) ? normalizedBestCandidate : [...candidatePaths, ...recentReadPaths].sort(
+    (left, right) => scoreMarathonCandidatePath(right) - scoreMarathonCandidatePath(left)
+  )[0];
   const persisted = state;
   const {
     runnerPosition: _runnerPosition,
@@ -53493,8 +54079,25 @@ function extractRunTaskResumeState(state) {
     ...sanitized.verificationRequired !== void 0 ? { verificationRequired: sanitized.verificationRequired } : {},
     ...sanitized.lastVerificationPassed ? { lastVerificationPassed: sanitized.lastVerificationPassed } : {},
     ...sanitized.isCreationTask !== void 0 ? { isCreationTask: sanitized.isCreationTask } : {},
-    ...sanitized.outputRoot ? { outputRoot: sanitized.outputRoot } : {}
-  };
+    ...sanitized.outputRoot ? { outputRoot: sanitized.outputRoot } : {},
+    ...sanitized.contextCompactionSummaries?.length ? { contextCompactionSummaries: sanitized.contextCompactionSummaries } : {},
+    ...typeof sanitized.contextWindowBaseIndex === "number" && sanitized.contextWindowBaseIndex > 0 ? { contextWindowBaseIndex: sanitized.contextWindowBaseIndex } : {}
+  };
+}
+function offsetNewContextCompactionSummaries(summaries, existingSummaryIds, sessionOffset) {
+  if (!summaries?.length) return void 0;
+  if (sessionOffset === 0) return summaries;
+  const existingIds = new Set(existingSummaryIds);
+  return summaries.map((summary) => {
+    if (existingIds.has(summary.id)) return summary;
+    const absoluteSessionIndex = summary.sessionIndex + sessionOffset;
+    const idPrefix = `ctx_${summary.sessionIndex}_`;
+    return {
+      ...summary,
+      id: summary.id.startsWith(idPrefix) ? `ctx_${absoluteSessionIndex}_${summary.id.slice(idPrefix.length)}` : summary.id,
+      sessionIndex: absoluteSessionIndex
+    };
+  });
 }
 function findStateFile(name, stateDir) {
   if (stateDir) {
@@ -53649,6 +54252,8 @@ function applyCheckpointTreeNavigation(stateFilePath2, navigation) {
   if (!log || !log.headId) return null;
   const destinationId = navigation.fork ? log.headId : navigation.treeHead;
   if (!destinationId || !log.byId.has(destinationId)) return null;
+  const destination = log.byId.get(destinationId);
+  if (!destination || destination.type !== "delta" && destination.type !== "fork") return null;
   try {
     if (!materializeAtEntry(log, destinationId).state) return null;
   } catch {
@@ -53675,21 +54280,39 @@ function applyCheckpointTreeNavigation(stateFilePath2, navigation) {
     lastOutput: anchor.lastOutput,
     lastStopReason: anchor.lastStopReason
   } : {};
+  const forkAnchoredBase = anchor?.contextWindowBaseIndex ?? 0;
+  const windowBaseOverride = navigation.fork ? {
+    contextWindowBaseIndex: forkAnchoredBase <= navigation.fork.atMessageIndex ? forkAnchoredBase : 0
+  } : {};
   const effectiveSessionCount = sessionShapedOverrides.sessionCount ?? materialized.state.sessionCount;
   const currentJson = loadState(stateFilePath2);
   const now = (/* @__PURE__ */ new Date()).toISOString();
-  const { sessionSnapshots: priorSnapshots, ...restJson } = currentJson ?? {};
+  const {
+    sessionSnapshots: priorSnapshots,
+    contextCompactionSummaries: _priorSummaries,
+    ...restJson
+  } = currentJson ?? {};
   const keptSnapshots = (priorSnapshots ?? []).filter(
     (snapshot) => snapshot.sessionIndex <= effectiveSessionCount
   );
+  const branchSummaries = summariesToContextEntries(materialized.summaries);
+  const contextCompactionSummaries = branchSummaries.length ? branchSummaries : materialized.state.contextCompactionSummaries;
   const mergedState = {
     ...restJson,
     ...materialized.state,
     ...sessionShapedOverrides,
+    ...windowBaseOverride,
     messages: materialized.messages,
+    ...contextCompactionSummaries?.length ? { contextCompactionSummaries } : {},
     ...keptSnapshots.length > 0 ? { sessionSnapshots: keptSnapshots } : {},
     updatedAt: now
   };
+  if (typeof mergedState.contextWindowBaseIndex === "number") {
+    mergedState.contextWindowBaseIndex = Math.max(
+      0,
+      Math.min(mergedState.contextWindowBaseIndex, materialized.messages.length)
+    );
+  }
   primeTreeLogSyncFromState(stateFilePath2, log, mergedState);
   saveState(stateFilePath2, mergedState);
   return { messages: materialized.messages, mergedState };
@@ -53698,7 +54321,11 @@ function applyCheckpointTreeNavigation(stateFilePath2, navigation) {
 // src/marathon/local-tools.ts
 import * as fs10 from "fs";
 import * as path11 from "path";
+import { createHash as createHash2 } from "crypto";
 import { spawnSync } from "child_process";
+import {
+  LEDGER_ARTIFACT_LINE_PREFIX
+} from "@runtypelabs/sdk";
 
 // src/marathon/repo-discovery.ts
 import * as fs9 from "fs";
@@ -53914,8 +54541,11 @@ var DIRECT_TOOL_BLOCKED_SEGMENTS = /* @__PURE__ */ new Set([".git", ".runtype"])
 function stateSafeName3(name) {
   return name.replace(/[^a-zA-Z0-9_-]/g, "_");
 }
-function getOffloadedOutputDir(taskName, stateDir) {
-  return path11.join(stateDir || getMarathonStateDir(), stateSafeName3(taskName), "outputs");
+function getStateFilePathForTask(taskName, stateDir, stateFilePath2) {
+  return stateFilePath2 || path11.join(stateDir || getMarathonStateDir(), `${stateSafeName3(taskName)}.json`);
+}
+function getOffloadedOutputDir(taskName, stateDir, stateFilePath2) {
+  return artifactStoreDirForStateFile(getStateFilePathForTask(taskName, stateDir, stateFilePath2));
 }
 function isPathWithinRoot(targetPath, rootPath) {
   const relativePath = path11.relative(rootPath, targetPath);
@@ -53962,11 +54592,10 @@ function resolveToolPath(toolPath, options = {}) {
     return { ok: false, error: `Path does not exist: ${requestedPath}` };
   }
   const workspaceRoot = fs10.realpathSync.native(process.cwd());
-  const extraRoots = (options.allowedRoots || []).map((rootPath) => canonicalizeAllowedRoot(rootPath));
-  const allowedRoots = [
-    ...extraRoots,
-    workspaceRoot
-  ];
+  const extraRoots = (options.allowedRoots || []).map(
+    (rootPath) => canonicalizeAllowedRoot(rootPath)
+  );
+  const allowedRoots = [...extraRoots, workspaceRoot];
   const matchedRoot = allowedRoots.find(
     (rootPath) => isPathWithinRoot(resolved.canonicalPath, rootPath)
   );
@@ -54016,15 +54645,15 @@ function resolveToolPath(toolPath, options = {}) {
   }
   return { ok: true, resolvedPath: resolved.canonicalPath };
 }
-function getTaskStateRoot(taskName, stateDir) {
-  return path11.join(stateDir || getMarathonStateDir(), stateSafeName3(taskName));
+function getTaskStateRoot(taskName, stateDir, stateFilePath2) {
+  return path11.dirname(getOffloadedOutputDir(taskName, stateDir, stateFilePath2));
 }
 function createDefaultLocalTools(context) {
-  const taskStateRoot = context?.taskName ? getTaskStateRoot(context.taskName, context.stateDir) : void 0;
+  const taskStateRoot = context?.taskName ? getTaskStateRoot(context.taskName, context.stateDir, context.stateFilePath) : void 0;
   const planDir = context?.taskName ? path11.resolve(`.runtype/marathons/${stateSafeName3(context.taskName)}`) : void 0;
   const planPathDir = context?.planPath ? path11.resolve(path11.dirname(context.planPath)) : void 0;
   const allowedReadRoots = context?.taskName ? [
-    getOffloadedOutputDir(context.taskName, context.stateDir),
+    getOffloadedOutputDir(context.taskName, context.stateDir, context.stateFilePath),
     ...taskStateRoot ? [taskStateRoot] : [],
     ...planDir ? [planDir] : [],
     ...planPathDir ? [planPathDir] : []
@@ -54082,7 +54711,9 @@ function createDefaultLocalTools(context) {
           requireDirectory: true
         });
         if (!resolvedPath.ok) return `Error: ${resolvedPath.error}`;
-        return fs10.readdirSync(resolvedPath.resolvedPath, { withFileTypes: true }).filter((entry) => !shouldIgnoreRepoEntry(path11.join(resolvedPath.resolvedPath, entry.name))).map((entry) => entry.name).join("\n");
+        return fs10.readdirSync(resolvedPath.resolvedPath, { withFileTypes: true }).filter(
+          (entry) => !shouldIgnoreRepoEntry(path11.join(resolvedPath.resolvedPath, entry.name))
+        ).map((entry) => entry.name).join("\n");
       }
     },
     search_repo: {
@@ -54114,7 +54745,10 @@ function createDefaultLocalTools(context) {
         if (!startPath.ok) return `Error: ${startPath.error}`;
         const maxResults = Math.max(
           1,
-          Math.min(100, Number.isFinite(Number(args.maxResults)) ? Math.floor(Number(args.maxResults)) : 20)
+          Math.min(
+            100,
+            Number.isFinite(Number(args.maxResults)) ? Math.floor(Number(args.maxResults)) : 20
+          )
         );
         const needle = query.toLowerCase();
         const tokens = tokenizeSearchQuery(query);
@@ -54221,20 +54855,31 @@ function createDefaultLocalTools(context) {
         if (!dirPath.ok) return `Error: ${dirPath.error}`;
         const maxDepth = Math.max(
           0,
-          Math.min(6, Number.isFinite(Number(args.maxDepth)) ? Math.floor(Number(args.maxDepth)) : 2)
+          Math.min(
+            6,
+            Number.isFinite(Number(args.maxDepth)) ? Math.floor(Number(args.maxDepth)) : 2
+          )
         );
-        const lines = [`${normalizeToolPath(dirPath.resolvedPath)}/`, ...buildTree(dirPath.resolvedPath, maxDepth)];
+        const lines = [
+          `${normalizeToolPath(dirPath.resolvedPath)}/`,
+          ...buildTree(dirPath.resolvedPath, maxDepth)
+        ];
         return lines.join("\n");
       }
     }
   };
 }
-function createCheckpointedWriteFileTool(taskName, stateDir, planPath) {
-  const taskStateRoot = getTaskStateRoot(taskName, stateDir);
+function createCheckpointedWriteFileTool(taskName, stateDir, planPath, stateFilePath2) {
+  const taskStateRoot = getTaskStateRoot(taskName, stateDir, stateFilePath2);
   const planDir = path11.resolve(`.runtype/marathons/${stateSafeName3(taskName)}`);
   const marathonPlanRoot = path11.resolve(".runtype/marathons");
   const planPathDir = planPath ? path11.resolve(path11.dirname(planPath)) : void 0;
-  const writeAllowedRoots = [taskStateRoot, planDir, marathonPlanRoot, ...planPathDir ? [planPathDir] : []];
+  const writeAllowedRoots = [
+    taskStateRoot,
+    planDir,
+    marathonPlanRoot,
+    ...planPathDir ? [planPathDir] : []
+  ];
   return {
     description: "Write content to a file, creating directories as needed and checkpointing original repo files",
     parametersSchema: {
@@ -54252,7 +54897,7 @@ function createCheckpointedWriteFileTool(taskName, stateDir, planPath) {
       });
       if (!resolvedPath.ok) return `Error: ${resolvedPath.error}`;
       const content = String(args.content || "");
-      ensureMarathonFileCheckpoint(taskName, resolvedPath.resolvedPath, stateDir);
+      ensureMarathonFileCheckpoint(taskName, resolvedPath.resolvedPath, stateDir, stateFilePath2);
       const dir = path11.dirname(resolvedPath.resolvedPath);
       fs10.mkdirSync(dir, { recursive: true });
       fs10.writeFileSync(resolvedPath.resolvedPath, content);
@@ -54280,12 +54925,17 @@ function quickJsSyntaxCheck(content) {
     return void 0;
   }
 }
-function createEditFileTool(taskName, stateDir, planPath) {
-  const taskStateRoot = getTaskStateRoot(taskName, stateDir);
+function createEditFileTool(taskName, stateDir, planPath, stateFilePath2) {
+  const taskStateRoot = getTaskStateRoot(taskName, stateDir, stateFilePath2);
   const planDir = path11.resolve(`.runtype/marathons/${stateSafeName3(taskName)}`);
   const marathonPlanRoot = path11.resolve(".runtype/marathons");
   const planPathDir = planPath ? path11.resolve(path11.dirname(planPath)) : void 0;
-  const writeAllowedRoots = [taskStateRoot, planDir, marathonPlanRoot, ...planPathDir ? [planPathDir] : []];
+  const writeAllowedRoots = [
+    taskStateRoot,
+    planDir,
+    marathonPlanRoot,
+    ...planPathDir ? [planPathDir] : []
+  ];
   return {
     description: "Make a targeted edit to a file by replacing a specific string. Much more efficient than rewriting the entire file with write_file. The old_string must appear exactly once in the file (or use replace_all for global replacement). Always read the file first to get the exact text to replace.",
     parametersSchema: {
@@ -54293,7 +54943,10 @@ function createEditFileTool(taskName, stateDir, planPath) {
       properties: {
         path: { type: "string", description: "File path to edit" },
         // @snake-case-ok: Parameter names use snake_case to match agent tool conventions
-        old_string: { type: "string", description: "Exact string to find and replace (must be unique in the file)" },
+        old_string: {
+          type: "string",
+          description: "Exact string to find and replace (must be unique in the file)"
+        },
         // @snake-case-ok: Parameter names use snake_case to match agent tool conventions
         new_string: { type: "string", description: "Replacement string" },
         // @snake-case-ok: Parameter names use snake_case to match agent tool conventions
@@ -54332,7 +54985,7 @@ function createEditFileTool(taskName, stateDir, planPath) {
           return `Error: old_string appears ${count} times in the file. Provide more surrounding context to make it unique, or set replace_all to true.`;
         }
       }
-      ensureMarathonFileCheckpoint(taskName, resolvedPath.resolvedPath, stateDir);
+      ensureMarathonFileCheckpoint(taskName, resolvedPath.resolvedPath, stateDir, stateFilePath2);
       const updated = replaceAll ? content.split(oldString).join(newString) : content.replace(oldString, newString);
       fs10.writeFileSync(resolvedPath.resolvedPath, updated);
       const ext = path11.extname(resolvedPath.resolvedPath).toLowerCase();
@@ -54348,7 +55001,7 @@ function createEditFileTool(taskName, stateDir, planPath) {
     }
   };
 }
-function createRestoreFileCheckpointTool(taskName, stateDir) {
+function createRestoreFileCheckpointTool(taskName, stateDir, stateFilePath2) {
   return {
     description: "Restore the original checkpointed contents for a previously edited repo file if a change regresses behavior",
     parametersSchema: {
@@ -54363,7 +55016,12 @@ function createRestoreFileCheckpointTool(taskName, stateDir) {
         requireFile: true
       });
       if (!resolvedPath.ok) return `Error: ${resolvedPath.error}`;
-      const result = restoreMarathonFileCheckpoint(taskName, resolvedPath.resolvedPath, stateDir);
+      const result = restoreMarathonFileCheckpoint(
+        taskName,
+        resolvedPath.resolvedPath,
+        stateDir,
+        stateFilePath2
+      );
       if (!result.restored) {
         return result.error || `No checkpoint found for ${String(args.path || "")}`;
       }
@@ -54371,15 +55029,15 @@ function createRestoreFileCheckpointTool(taskName, stateDir) {
     }
   };
 }
-function createReadOffloadedOutputTool(taskName, stateDir) {
+function createReadOffloadedOutputTool(taskName, stateDir, stateFilePath2) {
   return {
-    description: "Read the full contents of a previously offloaded tool result by id",
+    description: "Read the full contents of a previously offloaded ledger artifact by id",
     parametersSchema: {
       type: "object",
       properties: {
         id: {
           type: "string",
-          description: "Offloaded output id returned by a previous tool result"
+          description: "Offloaded output or ledger artifact id returned by a previous tool result"
         }
       },
       required: ["id"]
@@ -54390,11 +55048,41 @@ function createReadOffloadedOutputTool(taskName, stateDir) {
       if (!/^[a-zA-Z0-9_-]+$/.test(outputId)) {
         return `Error: invalid offloaded output id: ${outputId}`;
       }
-      const outputPath = path11.join(getOffloadedOutputDir(taskName, stateDir), `${outputId}.txt`);
+      const verifyContent = (content, expectedSha256) => {
+        if (!expectedSha256) return content;
+        const actual = createHash2("sha256").update(content).digest("hex");
+        if (actual === expectedSha256) return content;
+        return [
+          `[Warning: artifact content no longer matches its recorded sha256 (${outputId}) \u2014 the file was modified after it was offloaded]`,
+          content
+        ].join("\n");
+      };
+      const idEmbeddedSha256 = /^art_([0-9a-f]{64})$/.exec(outputId)?.[1];
+      const outputPath = path11.join(
+        getOffloadedOutputDir(taskName, stateDir, stateFilePath2),
+        `${outputId}.txt`
+      );
       if (!fs10.existsSync(outputPath) || !fs10.statSync(outputPath).isFile()) {
+        const resolvedStateFilePath = getStateFilePathForTask(taskName, stateDir, stateFilePath2);
+        const log = loadTreeLog(treeLogPathForStateFile(resolvedStateFilePath));
+        const artifact = log ? findArtifactPayload(log, outputId) : void 0;
+        if (artifact) {
+          const ledgerPath = path11.resolve(
+            path11.dirname(treeLogPathForStateFile(resolvedStateFilePath)),
+            artifact.relativePath
+          );
+          if (fs10.existsSync(ledgerPath) && fs10.statSync(ledgerPath).isFile()) {
+            return verifyContent(fs10.readFileSync(ledgerPath, "utf-8"), artifact.sha256);
+          }
+          return [
+            `Error: offloaded output recorded in the context ledger but missing locally: ${outputId}`,
+            artifact.host ? `Stored on host: ${artifact.host}` : void 0,
+            `${LEDGER_ARTIFACT_LINE_PREFIX}${artifact.relativePath}`
+          ].filter(Boolean).join("\n");
+        }
         return `Error: offloaded output not found: ${outputId}`;
       }
-      return fs10.readFileSync(outputPath, "utf-8");
+      return verifyContent(fs10.readFileSync(outputPath, "utf-8"), idEmbeddedSha256);
     }
   };
 }
@@ -54533,19 +55221,34 @@ function buildLocalTools(client, sandboxProvider, options, context) {
   if (!options.noLocalTools) {
     Object.assign(enabledTools, createDefaultLocalTools(context));
     if (context) {
-      enabledTools.write_file = createCheckpointedWriteFileTool(context.taskName, context.stateDir, context.planPath);
-      enabledTools.edit_file = createEditFileTool(context.taskName, context.stateDir, context.planPath);
+      enabledTools.write_file = createCheckpointedWriteFileTool(
+        context.taskName,
+        context.stateDir,
+        context.planPath,
+        context.stateFilePath
+      );
+      enabledTools.edit_file = createEditFileTool(
+        context.taskName,
+        context.stateDir,
+        context.planPath,
+        context.stateFilePath
+      );
       enabledTools.restore_file_checkpoint = createRestoreFileCheckpointTool(
         context.taskName,
-        context.stateDir
+        context.stateDir,
+        context.stateFilePath
       );
       enabledTools.read_offloaded_output = createReadOffloadedOutputTool(
         context.taskName,
-        context.stateDir
+        context.stateDir,
+        context.stateFilePath
       );
       enabledTools.run_check = createRunCheckTool();
-      if (options.sessionSearch === true) {
-        enabledTools.search_session_history = createSearchSessionHistoryTool(client, context.taskName);
+      if (options.sessionSearch !== false) {
+        enabledTools.search_session_history = createSearchSessionHistoryTool(
+          client,
+          context.taskName
+        );
       }
     }
   }
@@ -54561,9 +55264,33 @@ function buildLocalTools(client, sandboxProvider, options, context) {
 }
 
 // src/marathon/session-chunker.ts
+import * as fs11 from "fs";
+import * as path12 from "path";
+import {
+  parseLedgerArtifactRelativePath,
+  parseOffloadedOutputId
+} from "@runtypelabs/sdk";
 var DEFAULT_MAX_CHUNK_CHARS = 2e3;
 var MIN_CONTENT_LENGTH = 50;
-function extractSessionChunks(snapshot, maxChunkChars = DEFAULT_MAX_CHUNK_CHARS) {
+function extractSessionChunksWithLedger(snapshot, options) {
+  const maxChunkChars = options.maxChunkChars ?? DEFAULT_MAX_CHUNK_CHARS;
+  const log = loadTreeLog(treeLogPathForStateFile(options.stateFilePath));
+  const chunks = extractCoreSessionChunks(
+    snapshot,
+    maxChunkChars,
+    (tool) => resolveLedgerToolResult(tool, options.stateFilePath, log)
+  );
+  for (const summary of options.summaries ?? []) {
+    if (summary.sessionIndex !== snapshot.sessionIndex) continue;
+    const content = `[Compaction summary]
+${summary.content}`;
+    if (content.length >= MIN_CONTENT_LENGTH) {
+      chunks.push(...chunkText(content, "reasoning", maxChunkChars));
+    }
+  }
+  return chunks;
+}
+function extractCoreSessionChunks(snapshot, maxChunkChars, resolveToolResult) {
   const chunks = [];
   if (snapshot.content && snapshot.content.length >= MIN_CONTENT_LENGTH) {
     chunks.push(...chunkText(snapshot.content, "response", maxChunkChars));
@@ -54572,15 +55299,43 @@ function extractSessionChunks(snapshot, maxChunkChars = DEFAULT_MAX_CHUNK_CHARS)
     chunks.push(...chunkText(snapshot.reasoning, "reasoning", maxChunkChars));
   }
   for (const tool of snapshot.tools) {
-    const result = typeof tool.result === "string" ? tool.result : JSON.stringify(tool.result ?? "");
+    const result = resolveToolResult(tool);
     if (result.length >= MIN_CONTENT_LENGTH) {
-      chunks.push(
-        ...chunkText(result, "tool_output", maxChunkChars, tool.name)
-      );
+      chunks.push(...chunkText(result, "tool_output", maxChunkChars, tool.name));
     }
   }
   return chunks;
 }
+function stringifyToolResult(result) {
+  return typeof result === "string" ? result : JSON.stringify(result ?? "");
+}
+function resolveLedgerToolResult(tool, stateFilePath2, log) {
+  const result = stringifyToolResult(tool.result);
+  const artifact = findReferencedArtifact(result, log);
+  if (!artifact) return result;
+  const artifactPath = path12.resolve(
+    path12.dirname(treeLogPathForStateFile(stateFilePath2)),
+    artifact.relativePath
+  );
+  try {
+    if (fs11.existsSync(artifactPath) && fs11.statSync(artifactPath).isFile()) {
+      return fs11.readFileSync(artifactPath, "utf-8");
+    }
+  } catch {
+  }
+  return result;
+}
+function findReferencedArtifact(result, log) {
+  if (!log) return void 0;
+  const id = parseOffloadedOutputId(result);
+  if (id) {
+    const artifact = findArtifactPayload(log, id);
+    if (artifact) return artifact;
+  }
+  const relativePath = parseLedgerArtifactRelativePath(result);
+  if (!relativePath) return void 0;
+  return log.entries.filter((entry) => entry.type === "artifact").map((entry) => entry.payload).find((payload) => payload.relativePath === relativePath);
+}
 function chunkText(text, type, maxChars, toolName) {
   if (text.length <= maxChars) {
     return [{ content: text, type, ...toolName ? { toolName } : {} }];
@@ -54696,14 +55451,15 @@ function createLoopDetector(options = {}) {
 }
 
 // src/marathon/context-offload.ts
-import * as fs11 from "fs";
-import * as path12 from "path";
+import * as fs12 from "fs";
+import * as path13 from "path";
+import { createHash as createHash3 } from "crypto";
+import { buildLedgerOffloadReference } from "@runtypelabs/sdk";
 var DEFAULT_OUTPUT_THRESHOLD = 2e3;
 var DEFAULT_PREVIEW_LENGTH = 200;
-function buildOffloadedOutputId(toolName) {
-  offloadCounter += 1;
-  const safeToolName = toolName.replace(/[^a-zA-Z0-9_-]/g, "_");
-  return `${safeToolName}-${offloadCounter}`;
+function buildOffloadedOutputId(output) {
+  const sha256 = createHash3("sha256").update(output).digest("hex");
+  return `art_${sha256}`;
 }
 function defaultStateDir3() {
   return getMarathonStateDir();
@@ -54711,7 +55467,33 @@ function defaultStateDir3() {
 function stateSafeName4(name) {
   return name.replace(/[^a-zA-Z0-9_-]/g, "_");
 }
-var offloadCounter = 0;
+function stateFilePathForTask(taskName, stateDir) {
+  return path13.join(stateDir || defaultStateDir3(), `${stateSafeName4(taskName)}.json`);
+}
+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, {
+      taskName: details.taskName,
+      agentId: details.options.ledger?.agentId || "unknown",
+      ...details.options.ledger?.originalMessage ? { originalMessage: details.options.ledger.originalMessage } : {}
+    });
+    if (findArtifactPayload(log, details.outputId)) return;
+    appendArtifact(log, {
+      artifactId: details.outputId,
+      outputId: details.outputId,
+      kind: "tool_output",
+      toolName: details.toolName,
+      relativePath: artifactRelativePathForStateFile(stateFilePath2, details.fileName),
+      contentType: "text/plain",
+      sha256: details.sha256,
+      byteLength: Buffer.byteLength(details.output, "utf-8"),
+      charLength: details.output.length
+    });
+  } catch {
+  }
+}
 function offloadToolOutput(taskName, toolName, output, options = {}, stateDir) {
   const threshold = options.threshold ?? DEFAULT_OUTPUT_THRESHOLD;
   const warnThreshold = options.warnThreshold;
@@ -54728,23 +55510,35 @@ function offloadToolOutput(taskName, toolName, output, options = {}, stateDir) {
   if (output.length <= threshold) {
     return { offloaded: false, content: output };
   }
-  const outputId = buildOffloadedOutputId(toolName);
-  const dir = path12.join(
-    stateDir || defaultStateDir3(),
-    stateSafeName4(taskName),
-    "outputs"
-  );
+  const outputId = buildOffloadedOutputId(output);
+  const sha256 = outputId.replace(/^art_/, "");
+  const stateFilePath2 = options.ledger?.stateFilePath || stateFilePathForTask(taskName, stateDir);
+  const dir = artifactStoreDirForStateFile(stateFilePath2);
   const fileName = `${outputId}.txt`;
-  const filePath = path12.join(dir, fileName);
-  fs11.mkdirSync(dir, { recursive: true });
-  fs11.writeFileSync(filePath, output, "utf-8");
+  const filePath = path13.join(dir, fileName);
+  fs12.mkdirSync(dir, { recursive: true });
+  if (!fs12.existsSync(filePath)) {
+    fs12.writeFileSync(filePath, output, "utf-8");
+  }
+  recordOffloadedArtifact({
+    taskName,
+    toolName,
+    outputId,
+    sha256,
+    output,
+    fileName,
+    options,
+    stateDir
+  });
   const preview = output.slice(0, previewLength).replace(/\n/g, " ");
-  const reference = [
-    `[Output offloaded as ${outputId} \u2014 ${output.length.toLocaleString()} chars stored internally]`,
-    `Preview: ${preview}${output.length > previewLength ? "..." : ""}`,
-    "",
-    `Use read_offloaded_output with id "${outputId}" to retrieve the full output if needed.`
-  ].join("\n");
+  const relativePath = artifactRelativePathForStateFile(stateFilePath2, fileName);
+  const reference = buildLedgerOffloadReference({
+    outputId,
+    charLength: output.length,
+    relativePath,
+    preview,
+    truncated: output.length > previewLength
+  });
   options.onEvent?.({
     kind: "offloaded",
     toolName,
@@ -54909,20 +55703,20 @@ function resolveAutoCompactTokenThreshold(modelContextLength, rawThreshold, stra
 }
 
 // src/marathon/recipes.ts
-import * as fs12 from "fs";
-import * as path13 from "path";
+import * as fs13 from "fs";
+import * as path14 from "path";
 var RULES_DIR = ".marathon/rules";
 function loadRules(cwd) {
   const baseCwd = cwd || process.cwd();
-  const rulesDir = path13.resolve(baseCwd, RULES_DIR);
-  if (!fs12.existsSync(rulesDir)) return [];
+  const rulesDir = path14.resolve(baseCwd, RULES_DIR);
+  if (!fs13.existsSync(rulesDir)) return [];
   const rules = [];
   try {
-    const entries = fs12.readdirSync(rulesDir).filter((f2) => f2.endsWith(".md"));
+    const entries = fs13.readdirSync(rulesDir).filter((f2) => f2.endsWith(".md"));
     for (const entry of entries) {
-      const filePath = path13.join(rulesDir, entry);
+      const filePath = path14.join(rulesDir, entry);
       try {
-        const raw = fs12.readFileSync(filePath, "utf-8");
+        const raw = fs13.readFileSync(filePath, "utf-8");
         const parsed = parseRuleFile(raw);
         rules.push({ ...parsed, filePath });
       } catch {
@@ -54996,41 +55790,81 @@ function resolveErrorHandlingForPhase(phase, cliFallbackModel, milestoneFallback
 }
 
 // src/marathon/playbook-loader.ts
-import * as fs13 from "fs";
-import * as path14 from "path";
-import * as os4 from "os";
+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 = os4.homedir();
+  const home = os5.homedir();
   return [
     // Exact path
-    path14.resolve(cwd, nameOrPath),
+    path15.resolve(cwd, nameOrPath),
     // Repo-level
-    path14.resolve(cwd, PLAYBOOKS_DIR, `${nameOrPath}.yaml`),
-    path14.resolve(cwd, PLAYBOOKS_DIR, `${nameOrPath}.yml`),
-    path14.resolve(cwd, PLAYBOOKS_DIR, `${nameOrPath}.json`),
+    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
-    path14.resolve(home, PLAYBOOKS_DIR, `${nameOrPath}.yaml`),
-    path14.resolve(home, PLAYBOOKS_DIR, `${nameOrPath}.yml`),
-    path14.resolve(home, PLAYBOOKS_DIR, `${nameOrPath}.json`)
+    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}.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 = fs13.readFileSync(filePath, "utf-8");
-  const ext = path14.extname(filePath).toLowerCase();
+  const raw = fs14.readFileSync(filePath, "utf-8");
+  const ext = path15.extname(filePath).toLowerCase();
   if (ext === ".json") {
     return JSON.parse(raw);
   }
   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`);
@@ -55045,131 +55879,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 (!fs13.existsSync(candidate) || fs13.statSync(candidate).isDirectory()) continue;
-    const config3 = parsePlaybookFile(candidate);
+    if (!fs14.existsSync(candidate) || fs14.statSync(candidate).isDirectory()) continue;
+    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) {
@@ -55179,13 +56022,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(
@@ -55193,6 +56037,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) {
@@ -55352,7 +56204,9 @@ function normalizeMarathonAgentArgument(agent) {
 }
 function buildMarathonAutoCreatedAgentBootstrap(agentName, options = {}) {
   const normalizedModel = options.model?.trim();
-  const normalizedToolIds = [...new Set((options.toolIds || []).map((toolId) => toolId.trim()).filter(Boolean))];
+  const normalizedToolIds = [
+    ...new Set((options.toolIds || []).map((toolId) => toolId.trim()).filter(Boolean))
+  ];
   const normalizedFallbackModel = options.fallbackModel?.trim();
   const errorHandling = normalizedFallbackModel ? {
     onError: "fallback",
@@ -55428,7 +56282,11 @@ async function taskAction(agent, options) {
   });
   let parsedSandbox = parseSandboxProvider(options.sandbox);
   if (options.sandbox && !parsedSandbox) {
-    console.error(chalk23.red(`Invalid --sandbox value "${options.sandbox}". Use: cloudflare-worker, runtype-sandbox, quickjs, or daytona`));
+    console.error(
+      chalk23.red(
+        `Invalid --sandbox value "${options.sandbox}". Use: cloudflare-worker, runtype-sandbox, quickjs, or daytona`
+      )
+    );
     process.exit(1);
   }
   let requestedCompactStrategy;
@@ -55442,11 +56300,9 @@ async function taskAction(agent, options) {
   const rulesContext = rules.length > 0 ? rules.map((r) => r.content).join("\n\n---\n\n") : "";
   const allModels = [
     ...new Set(
-      [
-        options.model,
-        options.planningModel,
-        options.executionModel
-      ].filter((m2) => Boolean(m2))
+      [options.model, options.planningModel, options.executionModel].filter(
+        (m2) => Boolean(m2)
+      )
     )
   ];
   let resolvedToolIds = [];
@@ -55488,7 +56344,7 @@ async function taskAction(agent, options) {
     waitForUiExit = renderedShell.waitUntilExit;
     rerenderUi = renderedShell.rerender;
     unmountUi = renderedShell.unmount;
-    await new Promise((resolve10) => setTimeout(resolve10, 0));
+    await new Promise((resolve11) => setTimeout(resolve11, 0));
     if (!startupShellRef.current) {
       exitAltScreen();
       unmountUi?.();
@@ -55565,10 +56421,7 @@ async function taskAction(agent, options) {
         await failBeforeMain(formatMarathonApiError(error51));
       }
       const errMsg = error51 instanceof Error ? error51.message : String(error51);
-      await failBeforeMain([
-        chalk23.red("Failed to list agents"),
-        chalk23.red(errMsg)
-      ]);
+      await failBeforeMain([chalk23.red("Failed to list agents"), chalk23.red(errMsg)]);
     }
   }
   let agentConfigModel;
@@ -55617,7 +56470,7 @@ async function taskAction(agent, options) {
       forcedResumeFilePath = stateResolution.filePath;
     } else {
       resumeRequested = false;
-      if (options.fresh && fs14.existsSync(filePath)) {
+      if (options.fresh && fs15.existsSync(filePath)) {
         if (useStartupShell) {
           setStartupStatus("starting fresh");
         } else {
@@ -55732,12 +56585,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;
   }
@@ -55757,7 +56617,10 @@ async function taskAction(agent, options) {
           if (firstMilestoneModel) options.model = firstMilestoneModel;
           confirmed = true;
         } else if (confirmResult.action === "edit" && confirmResult.editMilestone) {
-          let startupModelOptions = buildMarathonStartupModelOptions(configuredModels, availableModels);
+          let startupModelOptions = buildMarathonStartupModelOptions(
+            configuredModels,
+            availableModels
+          );
           if (startupModelOptions.length === 0) {
             startupModelOptions = DEFAULT_MODELS;
           }
@@ -55831,11 +56694,15 @@ ${sandboxPrompt}`;
 
 ${rulesContext}`;
   const currentPhase = resumeState?.workflowPhase;
-  const resolvedModel = resolveModelForPhase(currentPhase, {
-    planningModel: options.planningModel,
-    executionModel: options.executionModel,
-    defaultModel: options.model
-  }, playbookMilestoneModels);
+  const resolvedModel = resolveModelForPhase(
+    currentPhase,
+    {
+      planningModel: options.planningModel,
+      executionModel: options.executionModel,
+      defaultModel: options.model
+    },
+    playbookMilestoneModels
+  );
   if (resolvedModel) options.model = resolvedModel;
   if (autoCreatedAgent) {
     const bootstrapPayload = buildMarathonAutoCreatedAgentBootstrap(normalizedAgent, {
@@ -55872,6 +56739,7 @@ ${rulesContext}`;
   let localTools = buildLocalTools(client, parsedSandbox, options, {
     taskName,
     stateDir: options.stateDir,
+    stateFilePath: filePath,
     planPath: resolvedPlanPath
   });
   const resolveContextLimitForModel = (modelId) => resolveModelContextLength(modelId, configuredModels, availableModels);
@@ -55894,16 +56762,21 @@ ${rulesContext}`;
   const reportContextNotice = (event) => {
     streamRef.current?.reportContextNotice(event);
   };
-  if (localTools && offloadOptions) {
-    const toolNames = Object.keys(localTools);
-    for (const toolName of toolNames) {
+  const applyOffloadWrapping = (tools) => {
+    if (!tools || !offloadOptions) return tools;
+    for (const toolName of Object.keys(tools)) {
       if (toolName === "search_repo" || toolName === "read_file" || toolName === "glob_files" || toolName === "tree_directory" || toolName === "list_directory") {
-        localTools[toolName] = withOffloading(
-          localTools[toolName],
+        tools[toolName] = withOffloading(
+          tools[toolName],
           taskName,
           toolName,
           {
             ...offloadOptions,
+            ledger: {
+              stateFilePath: filePath,
+              agentId,
+              originalMessage: baseMessage
+            },
             onEvent: (event) => {
               if (event.kind === "warning") {
                 reportContextNotice({
@@ -55927,14 +56800,19 @@ ${rulesContext}`;
         );
       }
     }
-  }
+    return tools;
+  };
+  localTools = applyOffloadWrapping(localTools);
   let toolsEnabled = true;
   const checkpointHasConfigChanges = (result) => Boolean(result.model) || result.tools === true || result.sandbox !== void 0;
-  const rebuildCheckpointTools = () => buildLocalTools(client, parsedSandbox, options, {
-    taskName,
-    stateDir: options.stateDir,
-    planPath: resolvedPlanPath
-  });
+  const rebuildCheckpointTools = () => applyOffloadWrapping(
+    buildLocalTools(client, parsedSandbox, options, {
+      taskName,
+      stateDir: options.stateDir,
+      stateFilePath: filePath,
+      planPath: resolvedPlanPath
+    })
+  );
   const applyCheckpointConfig = (result) => {
     if (result.model) {
       options.model = result.model;
@@ -55961,6 +56839,7 @@ ${rulesContext}`;
   let lastKnownState = null;
   try {
     const marathonDashboardBaseUrl = getDashboardUrl().replace(/\/$/, "");
+    const turnAbortRef = { current: null };
     const marathonAppProps = {
       taskName,
       agentId,
@@ -55999,7 +56878,9 @@ ${rulesContext}`;
           sessions: persistedSessionSummaries,
           startedAt: lastKnownState?.startedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
           updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-          ...persistedSessionSnapshots.length > 0 || payload.sessionSnapshots.length > 0 ? { sessionSnapshots: payload.sessionSnapshots.length > 0 ? payload.sessionSnapshots : persistedSessionSnapshots } : {},
+          ...persistedSessionSnapshots.length > 0 || payload.sessionSnapshots.length > 0 ? {
+            sessionSnapshots: payload.sessionSnapshots.length > 0 ? payload.sessionSnapshots : persistedSessionSnapshots
+          } : {},
           ...priorContinuations.length > 0 ? { continuations: priorContinuations } : {},
           ...Object.keys(priorCostByModel).length > 0 ? { costByModel: priorCostByModel } : {},
           ...priorOriginalMessage ? { originalMessage: priorOriginalMessage } : {},
@@ -56012,6 +56893,14 @@ Saving state... done. Session saved to ${filePath}`);
       },
       onComplete: () => {
       },
+      onAbortTurn: () => {
+        const controller = turnAbortRef.current;
+        if (controller && !controller.signal.aborted) {
+          controller.abort();
+          return true;
+        }
+        return false;
+      },
       streamRef
     };
     setMarathonTitle();
@@ -56027,14 +56916,13 @@ Saving state... done. Session saved to ${filePath}`);
       await startupShellRef.current?.completeStartup();
     } else {
       exitAltScreen = enterAltScreen();
-      const renderedApp = render15(
-        React15.createElement(MarathonApp, marathonAppProps),
-        { exitOnCtrlC: false }
-      );
+      const renderedApp = render15(React15.createElement(MarathonApp, marathonAppProps), {
+        exitOnCtrlC: false
+      });
       waitForUiExit = renderedApp.waitUntilExit;
       unmountUi = renderedApp.unmount;
     }
-    await new Promise((resolve10) => setTimeout(resolve10, 0));
+    await new Promise((resolve11) => setTimeout(resolve11, 0));
     const streamActions = streamRef.current;
     if (!streamActions) {
       exitAltScreen();
@@ -56085,6 +56973,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;
@@ -56092,6 +56994,7 @@ Saving state... done. Session saved to ${filePath}`);
     let accumulatedToolCalls = 0;
     let lastResult = null;
     let lastSessionMessages = [];
+    let undeliveredSteering = [];
     if (resumeLoadedState) {
       const continuationStartedAt = (/* @__PURE__ */ new Date()).toISOString();
       const continuation = {
@@ -56133,14 +57036,18 @@ Saving state... done. Session saved to ${filePath}`);
       const effectiveModelForContext = phaseModel || options.model || agentConfigModel || defaultConfiguredModel;
       const compactStrategy = resolveCompactStrategyForModel(effectiveModelForContext);
       const contextLimitTokens = resolveContextLimitForModel(effectiveModelForContext);
-      const autoCompactTokenThreshold = resolveCompactThresholdForModel(
-        effectiveModelForContext
+      const autoCompactTokenThreshold = resolveCompactThresholdForModel(effectiveModelForContext);
+      const existingContextSummaryIds = new Set(
+        (resumeState?.contextCompactionSummaries ?? []).map((summary) => summary.id)
       );
+      const turnAbortController = new AbortController();
+      turnAbortRef.current = turnAbortController;
       const runTaskOptions = {
         message: taskMessage,
         maxSessions: remainingSessions - accumulatedSessions,
         maxCost: currentRemainingCost,
         model: phaseModel || options.model,
+        abortSignal: turnAbortController.signal,
         reasoning: !options.noReasoning,
         debugMode: options.debug ?? true,
         stream: true,
@@ -56174,7 +57081,7 @@ Saving state... done. Session saved to ${filePath}`);
           };
           if (event.phase === "start") {
             currentActions.startContextCompaction(absoluteEvent);
-            await new Promise((resolve10) => setTimeout(resolve10, 0));
+            await new Promise((resolve11) => setTimeout(resolve11, 0));
             return;
           }
           currentActions.finishContextCompaction(absoluteEvent);
@@ -56227,11 +57134,17 @@ Saving state... done. Session saved to ${filePath}`);
             );
             currentActions.appendSessionSnapshot(sessionSnapshot);
           }
+          const contextCompactionSummaries = offsetNewContextCompactionSummaries(
+            state.contextCompactionSummaries,
+            existingContextSummaryIds,
+            currentSessionOffset
+          );
           const adjustedState = {
             ...state,
             sessionCount: currentSessionOffset + state.sessionCount,
             totalCost: priorCost + accumulatedCost + state.totalCost,
             sessions: persistedSessionSummaries,
+            ...contextCompactionSummaries?.length ? { contextCompactionSummaries } : {},
             ...persistedSessionSnapshots.length > 0 ? { sessionSnapshots: persistedSessionSnapshots } : {},
             ...getActiveDeploySandboxId() ? { deploySandboxId: getActiveDeploySandboxId() } : {},
             ...getActiveDeploySandboxPreviewUrl() ? { deploySandboxPreviewUrl: getActiveDeploySandboxPreviewUrl() } : {}
@@ -56240,10 +57153,13 @@ Saving state... done. Session saved to ${filePath}`);
           resumeState = extractRunTaskResumeState(adjustedState);
           lastSessionMessages = state.messages ?? [];
           saveState(filePath, adjustedState, { stripSnapshotEvents: !!eventLogWriter });
-          if (options.sessionSearch === true) {
+          if (options.sessionSearch !== false) {
             const latestSnapshot = persistedSessionSnapshots[persistedSessionSnapshots.length - 1];
             if (latestSnapshot) {
-              const chunks = extractSessionChunks(latestSnapshot);
+              const chunks = extractSessionChunksWithLedger(latestSnapshot, {
+                stateFilePath: filePath,
+                summaries: adjustedState.contextCompactionSummaries
+              });
               if (chunks.length > 0) {
                 const sessionIdx = currentSessionOffset + state.sessionCount - 1;
                 client.post("/session-context/index", {
@@ -56286,6 +57202,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);
@@ -56348,17 +57278,21 @@ Saving state... done. Session saved to ${filePath}`);
       if (resumeRequested) {
         streamActions.markPendingStart();
       }
-      const result2 = await retryOnNetworkError(
-        () => client.agents.runTask(agentId, runTaskOptions),
-        {
+      let result2;
+      try {
+        result2 = await retryOnNetworkError(() => client.agents.runTask(agentId, runTaskOptions), {
           maxRetries: 3,
           baseDelayMs: 5e3,
           maxDelayMs: 6e4,
+          // A user hard abort surfaces as an AbortError — never retry it
+          signal: turnAbortController.signal,
           onRetry: (attempt, delayMs, error51) => {
             const delaySec = Math.round(delayMs / 1e3);
             const msg = error51 instanceof Error ? error51.message : String(error51);
             console.error(
-              chalk23.yellow(`Network error (attempt ${attempt}/3): ${msg}. Retrying in ${delaySec}s...`)
+              chalk23.yellow(
+                `Network error (attempt ${attempt}/3): ${msg}. Retrying in ${delaySec}s...`
+              )
             );
             if (lastKnownState) {
               previousMessages = lastSessionMessages;
@@ -56369,8 +57303,23 @@ Saving state... done. Session saved to ${filePath}`);
               runTaskOptions.compact = false;
             }
           }
-        }
-      );
+        });
+      } catch (error51) {
+        if (!turnAbortController.signal.aborted) throw error51;
+        const knownState2 = lastKnownState;
+        result2 = {
+          status: "paused",
+          sessionCount: Math.max(
+            0,
+            (knownState2?.sessionCount ?? currentSessionOffset) - currentSessionOffset
+          ),
+          totalCost: Math.max(0, (knownState2?.totalCost ?? 0) - (priorCost + accumulatedCost)),
+          lastOutput: knownState2?.lastOutput ?? "",
+          sessions: []
+        };
+      }
+      const wasAborted = turnAbortController.signal.aborted;
+      turnAbortRef.current = null;
       persistedSessionSummaries = mergeMarathonSessionSummaries(
         persistedSessionSummaries,
         result2.sessions,
@@ -56385,7 +57334,7 @@ Saving state... done. Session saved to ${filePath}`);
           const completedTools = existingSnapshot.tools.map(
             (t) => t.status === "running" ? { ...t, status: "complete", executionTime: Date.now() - t.startedAt } : t
           );
-          const finalStatus = mapRunTaskStatusToSnapshotStatus(result2.status, existingSnapshot.status);
+          const finalStatus = wasAborted ? "stopped" : mapRunTaskStatusToSnapshotStatus(result2.status, existingSnapshot.status);
           const updatedSnapshot = {
             ...existingSnapshot,
             status: finalStatus,
@@ -56396,7 +57345,10 @@ Saving state... done. Session saved to ${filePath}`);
             tools: completedTools,
             ...finalStatus === "error" && lastKnownState?.lastError ? { errorMessage: lastKnownState.lastError } : {}
           };
-          persistedSessionSnapshots = upsertMarathonSessionSnapshot(persistedSessionSnapshots, updatedSnapshot);
+          persistedSessionSnapshots = upsertMarathonSessionSnapshot(
+            persistedSessionSnapshots,
+            updatedSnapshot
+          );
           streamRef.current?.appendSessionSnapshot(updatedSnapshot);
         }
       }
@@ -56419,11 +57371,16 @@ Saving state... done. Session saved to ${filePath}`);
         useCompact = false;
         resumeState = extractRunTaskResumeState(lastKnownState);
       }
-      if (result2.status === "complete" || result2.status === "budget_exceeded" || result2.status === "max_sessions") {
-        if (options.noCheckpoint) break;
+      if (wasAborted || result2.status === "complete" || result2.status === "budget_exceeded" || result2.status === "max_sessions") {
+        if (options.noCheckpoint) {
+          if (wasAborted) {
+            undeliveredSteering = streamRef.current?.drainSteeringQueue?.() ?? [];
+          }
+          break;
+        }
         const currentActions = streamRef.current;
         if (!currentActions) break;
-        const queuedFollowUps = currentActions.drainFollowUpQueue?.();
+        const queuedFollowUps = wasAborted ? void 0 : currentActions.drainFollowUpQueue?.();
         if (queuedFollowUps && queuedFollowUps.length > 0) {
           currentActions.resetForNewSession();
           taskMessage = queuedFollowUps.join("\n\n");
@@ -56533,6 +57490,18 @@ Saving state... done. Session saved to ${filePath}`);
     if (typeof finalState.lastError === "string" && finalState.lastError.trim()) {
       console.log(`Last error: ${chalk23.red(finalState.lastError)}`);
     }
+    if (undeliveredSteering.length > 0) {
+      console.log(
+        chalk23.yellow(
+          `
+Undelivered steering (${undeliveredSteering.length} message${undeliveredSteering.length === 1 ? "" : "s"} queued before the abort):`
+        )
+      );
+      for (const message of undeliveredSteering) {
+        console.log(chalk23.gray(`  - ${message}`));
+      }
+      console.log(chalk23.gray('  Include it when resuming, e.g. --resume "<message>".'));
+    }
     const dashboardBaseUrl = getDashboardUrl();
     console.log(`Dashboard:  ${chalk23.cyan(`${dashboardBaseUrl}/agents/${agentId}`)}`);
     if (result.recordId) {
@@ -56554,7 +57523,9 @@ Saving state... done. Session saved to ${filePath}`);
         const msg = c2.userMessage ? ` "${c2.userMessage.slice(0, 50)}"` : " (no message)";
         const modelName = c2.model ? ` [${c2.model}]` : "";
         console.log(
-          chalk23.gray(`  #${i + 1}: ${c2.continuedAt}${modelName}${msg} \u2014 $${c2.segmentCost.toFixed(4)}`)
+          chalk23.gray(
+            `  #${i + 1}: ${c2.continuedAt}${modelName}${msg} \u2014 $${c2.segmentCost.toFixed(4)}`
+          )
         );
       }
     }
@@ -56565,12 +57536,8 @@ Saving state... done. Session saved to ${filePath}`);
       }
     }
     if (isMarathonResumableStatus(result.status)) {
-      console.log(
-        chalk23.gray(
-          `
-Resume: ${buildResumeCommand(agent, options, parsedSandbox)}`
-        )
-      );
+      console.log(chalk23.gray(`
+Resume: ${buildResumeCommand(agent, options, parsedSandbox)}`));
     }
     if (options.json) {
       console.log();
@@ -56600,7 +57567,9 @@ Resume: ${buildResumeCommand(agent, options, parsedSandbox)}`
     }
     if (isTransientNetworkError(error51)) {
       console.error(chalk23.red("Network connection lost after multiple retry attempts."));
-      console.error(chalk23.gray("Your progress has been saved. Resume when connectivity is restored:"));
+      console.error(
+        chalk23.gray("Your progress has been saved. Resume when connectivity is restored:")
+      );
     } else {
       for (const line of formatMarathonApiError(error51)) {
         console.error(line);
@@ -56648,7 +57617,9 @@ function resolveBuiltinToolIds(tools, models) {
   }
   const errors = [];
   if (invalid.length > 0) {
-    errors.push(`Unknown built-in tool(s): ${invalid.join(", ")}. Available tools: ${available.join(", ")}`);
+    errors.push(
+      `Unknown built-in tool(s): ${invalid.join(", ")}. Available tools: ${available.join(", ")}`
+    );
   }
   if (excluded.length > 0) {
     errors.push(
@@ -56701,7 +57672,53 @@ function resolveSandboxWorkflowSelection(message, sandboxProvider, resumeState)
   };
 }
 function applyTaskOptions(cmd) {
-  return cmd.argument("<agent>", "Agent ID or name").option("-g, --goal <text>", "Goal message for the agent").option("--max-sessions <n>", "Maximum sessions", "50").option("--max-cost <n>", "Budget in USD").option("--model <modelId>", "Model ID to use (overrides agent config)").option("--name <name>", "Task name (used for state file, defaults to agent name)").option("--session <name>", "Resume a specific session by name").option("--state-dir <path>", "Directory for state files (default: ~/.runtype/projects/<hash>/marathons/)").option("--resume [message]", "Resume from existing local state, optionally with a new message").option("--fresh", "Start a new run and ignore any existing local state for this task").option("--compact", "Force compact-summary resume mode instead of replaying full history").option("--compact-strategy <strategy>", "Compaction strategy: auto (default), provider_native, or summary_fallback").option("--compact-threshold <value>", "Auto-compact when estimated context crosses this threshold (default: 80% fallback, 90% native; accepts percent like 90% or absolute token count like 120000)").option("--compact-instructions <text>", "Extra instructions for what a compact summary must preserve").option("--no-auto-compact", "Disable automatic context-aware history compaction").option("--track", "Sync progress to a Runtype record (visible in dashboard)").option("--debug", "Show debug output from each session").option("--json", "Output final result as JSON").option("--sandbox <provider>", "Enable sandbox code execution tool (cloudflare-worker, quickjs, or daytona)").option("--no-local-tools", "Disable built-in local tool execution (read_file, write_file, list_directory)").option("--session-search", "Enable session context indexing and search_session_history tool").option("-t, --tools <tools...>", "Enable built-in tools (e.g., exa, firecrawl, dalle, openai_web_search, anthropic_web_search)").option("--plain-text", "Disable markdown rendering in output").option("--no-reasoning", "Disable model reasoning/thinking (enabled by default for supported models)").option("--no-checkpoint", "Run all iterations without checkpoint pauses (fully autonomous)").option("--checkpoint-timeout <seconds>", "Auto-continue timeout in seconds (default: 10)", "10").option("--planning-model <modelId>", "Model to use during research/planning phases").option("--execution-model <modelId>", "Model to use during execution phase").option("--fallback-model <modelId>", "Model to fall back to when primary model fails").option("--playbook <name>", "Load a playbook from .runtype/marathons/playbooks/").option("--offload-threshold <chars>", 'Offload tool outputs larger than this to files (default: 100000; use "off" or "0" to disable guardrails)').option("--tool-context <mode>", "Tool result storage: hot-tail (default), observation-mask, or full-inline").option("--tool-window <window>", 'Compaction window: "session" (default) or a number for last-N tool results (e.g. 10)').option("--runner-char <char>", "Custom runner emoji (default: \u{1F3C3})").option("--finish-char <char>", "Custom finish line emoji (default: \u{1F3C1})").option("--no-runner", "Hide the runner emoji from the header border").option("--no-finish", "Hide the finish line emoji from the header border").action(taskAction);
+  return cmd.argument("<agent>", "Agent ID or name").option("-g, --goal <text>", "Goal message for the agent").option("--max-sessions <n>", "Maximum sessions", "50").option("--max-cost <n>", "Budget in USD").option("--model <modelId>", "Model ID to use (overrides agent config)").option("--name <name>", "Task name (used for state file, defaults to agent name)").option("--session <name>", "Resume a specific session by name").option(
+    "--state-dir <path>",
+    "Directory for state files (default: ~/.runtype/projects/<hash>/marathons/)"
+  ).option(
+    "--resume [message]",
+    "Resume from existing local state, optionally with a new message"
+  ).option("--fresh", "Start a new run and ignore any existing local state for this task").option("--compact", "Force compact-summary resume mode instead of replaying full history").option(
+    "--compact-strategy <strategy>",
+    "Compaction strategy: auto (default), provider_native, or summary_fallback"
+  ).option(
+    "--compact-threshold <value>",
+    "Auto-compact when estimated context crosses this threshold (default: 80% fallback, 90% native; accepts percent like 90% or absolute token count like 120000)"
+  ).option(
+    "--compact-instructions <text>",
+    "Extra instructions for what a compact summary must preserve"
+  ).option("--no-auto-compact", "Disable automatic context-aware history compaction").option("--track", "Sync progress to a Runtype record (visible in dashboard)").option("--debug", "Show debug output from each session").option("--json", "Output final result as JSON").option(
+    "--sandbox <provider>",
+    "Enable sandbox code execution tool (cloudflare-worker, quickjs, or daytona)"
+  ).option(
+    "--no-local-tools",
+    "Disable built-in local tool execution (read_file, write_file, list_directory)"
+  ).option(
+    "--session-search",
+    "Enable session context indexing and search_session_history tool (default)"
+  ).option(
+    "--no-session-search",
+    "Disable session context indexing and search_session_history tool"
+  ).option(
+    "-t, --tools <tools...>",
+    "Enable built-in tools (e.g., exa, firecrawl, dalle, openai_web_search, anthropic_web_search)"
+  ).option("--plain-text", "Disable markdown rendering in output").option(
+    "--no-reasoning",
+    "Disable model reasoning/thinking (enabled by default for supported models)"
+  ).option("--no-checkpoint", "Run all iterations without checkpoint pauses (fully autonomous)").option(
+    "--checkpoint-timeout <seconds>",
+    "Auto-continue timeout in seconds (default: 10)",
+    "10"
+  ).option("--planning-model <modelId>", "Model to use during research/planning phases").option("--execution-model <modelId>", "Model to use during execution phase").option("--fallback-model <modelId>", "Model to fall back to when primary model fails").option("--playbook <name>", "Load a playbook from .runtype/marathons/playbooks/").option(
+    "--offload-threshold <chars>",
+    'Offload tool outputs larger than this to files (default: 100000; use "off" or "0" to disable guardrails)'
+  ).option(
+    "--tool-context <mode>",
+    "Tool result storage: hot-tail (default), observation-mask, or full-inline"
+  ).option(
+    "--tool-window <window>",
+    'Compaction window: "session" (default) or a number for last-N tool results (e.g. 10)'
+  ).option("--runner-char <char>", "Custom runner emoji (default: \u{1F3C3})").option("--finish-char <char>", "Custom finish line emoji (default: \u{1F3C1})").option("--no-runner", "Hide the runner emoji from the header border").option("--no-finish", "Hide the finish line emoji from the header border").action(taskAction);
 }
 var taskCommand = applyTaskOptions(
   new Command16("task").description("Run a multi-session agent task")
@@ -57865,14 +58882,14 @@ import React19 from "react";
 import { render as render19 } from "ink";
 import { useState as useState36, useEffect as useEffect30 } from "react";
 import { Text as Text34 } from "ink";
-import { readFileSync as readFileSync15 } from "fs";
+import { readFileSync as readFileSync16 } from "fs";
 var evalCommand = new Command20("eval").description("Manage evaluations");
 evalCommand.command("submit").description("Submit an eval batch").requiredOption("-f, --flow <id>", "Flow ID to evaluate").requiredOption("-r, --records <file>", "JSON file with record IDs").option("-n, --name <name>", "Eval batch name").option("--json", "Output as JSON").option("--tty", "Force TTY mode").option("--no-tty", "Force non-TTY mode").action(async (options) => {
   const apiKey = await ensureAuth();
   if (!apiKey) return;
   let recordIds;
   try {
-    const content = readFileSync15(options.records, "utf-8");
+    const content = readFileSync16(options.records, "utf-8");
     const parsed = JSON.parse(content);
     recordIds = Array.isArray(parsed) ? parsed : parsed.recordIds || parsed.records || [];
   } catch (error51) {
@@ -58430,13 +59447,13 @@ apiKeysCommand.command("delete <id>").description("Delete an API key").option("-
     await waitUntilExit2();
     return;
   }
-  const confirmed = await new Promise((resolve10) => {
+  const confirmed = await new Promise((resolve11) => {
     const { unmount } = render20(
       React20.createElement(ConfirmPrompt, {
         message: `Delete API key ${id}?`,
         defaultValue: false,
         onConfirm: (result) => {
-          resolve10(result);
+          resolve11(result);
           unmount();
         }
       })
@@ -58541,8 +59558,8 @@ apiKeysCommand.command("analytics").description("Show API key usage analytics").
   const client = createCliClient(apiKey);
   if (!isTTY(options) || options.json) {
     try {
-      const path17 = options.key ? `/api-keys/${options.key}/analytics` : "/api-keys/analytics";
-      const data = await client.get(path17);
+      const path18 = options.key ? `/api-keys/${options.key}/analytics` : "/api-keys/analytics";
+      const data = await client.get(path18);
       printJson(data);
     } catch (error51) {
       const message = error51 instanceof Error ? error51.message : "Unknown error";
@@ -58559,8 +59576,8 @@ apiKeysCommand.command("analytics").description("Show API key usage analytics").
     useEffect31(() => {
       const run2 = async () => {
         try {
-          const path17 = options.key ? `/api-keys/${options.key}/analytics` : "/api-keys/analytics";
-          const data = await client.get(path17);
+          const path18 = options.key ? `/api-keys/${options.key}/analytics` : "/api-keys/analytics";
+          const data = await client.get(path18);
           printJson(data);
           setSuccess(true);
           setLoading(false);
@@ -58902,13 +59919,13 @@ clientTokensCommand.command("delete <id>").description("Delete a client token").
     await waitUntilExit2();
     return;
   }
-  const confirmed = await new Promise((resolve10) => {
+  const confirmed = await new Promise((resolve11) => {
     const { unmount } = render21(
       React21.createElement(ConfirmPrompt, {
         message: `Delete client token ${id}?`,
         defaultValue: false,
         onConfirm: (result) => {
-          resolve10(result);
+          resolve11(result);
           unmount();
         }
       })
@@ -59432,8 +60449,8 @@ function defaultTokenName(agentName) {
 }
 async function promptLine(rl, question, defaultValue) {
   const hint = defaultValue ? chalk30.dim(` (${defaultValue})`) : "";
-  const answer = await new Promise((resolve10) => {
-    rl.question(`${question}${hint}: `, resolve10);
+  const answer = await new Promise((resolve11) => {
+    rl.question(`${question}${hint}: `, resolve11);
   });
   const trimmed = answer.trim();
   if (!trimmed && defaultValue !== void 0) {
@@ -59443,8 +60460,8 @@ async function promptLine(rl, question, defaultValue) {
 }
 async function promptConfirm2(rl, message, defaultYes = false) {
   const hint = defaultYes ? chalk30.dim(" (Y/n)") : chalk30.dim(" (y/N)");
-  const answer = await new Promise((resolve10) => {
-    rl.question(`${message}${hint}: `, resolve10);
+  const answer = await new Promise((resolve11) => {
+    rl.question(`${message}${hint}: `, resolve11);
   });
   const t = answer.trim().toLowerCase();
   if (t === "") return defaultYes;
@@ -59513,18 +60530,18 @@ Dashboard: ${initial.dashboardUrl}`));
     process.stdin.removeAllListeners("keypress");
     process.stdin.pause();
   };
-  await new Promise((resolve10) => {
+  await new Promise((resolve11) => {
     const onKeypress = async (_str, key) => {
       if (!key) return;
       if (key.ctrl && key.name === "c") {
         cleanup();
-        resolve10();
+        resolve11();
         process.exit(0);
       }
       const name = key.name;
       if (name === "q" || name === "escape") {
         cleanup();
-        resolve10();
+        resolve11();
         return;
       }
       if (name === "c") {
@@ -60884,11 +61901,11 @@ async function runTail(options) {
       process.stderr.write(
         (useColor ? chalk35.gray(`Retrying in ${delay / 1e3}s (attempt ${attempt}/${MAX_ATTEMPTS})...`) : `Retrying in ${delay / 1e3}s (attempt ${attempt}/${MAX_ATTEMPTS})...`) + "\n"
       );
-      await new Promise((resolve10) => {
-        const timer = setTimeout(resolve10, delay);
+      await new Promise((resolve11) => {
+        const timer = setTimeout(resolve11, delay);
         const onAbort = () => {
           clearTimeout(timer);
-          resolve10();
+          resolve11();
         };
         controller.signal.addEventListener("abort", onAbort, { once: true });
       });
@@ -60904,7 +61921,7 @@ var tailCommand = new Command28("tail").description("Stream live execution logs
 // src/commands/validate-product.ts
 import { Command as Command29, Option } from "commander";
 import chalk36 from "chalk";
-import { readFileSync as readFileSync16 } from "fs";
+import { readFileSync as readFileSync17 } from "fs";
 function createValidateProductCommand() {
   return new Command29("validate-product").description("Validate a product (FPO) or FPO template locally (no API call)").argument(
     "[input]",
@@ -60984,7 +62001,7 @@ async function readInput(input) {
   if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
     return trimmed;
   }
-  return readFileSync16(input, "utf-8");
+  return readFileSync17(input, "utf-8");
 }
 async function readStdin() {
   if (process.stdin.isTTY) {
@@ -61086,8 +62103,8 @@ function printIssues(title, issues, color) {
 // src/commands/deploy.ts
 import { Command as Command30 } from "commander";
 import chalk37 from "chalk";
-import * as fs15 from "fs";
-import * as path15 from "path";
+import * as fs16 from "fs";
+import * as path16 from "path";
 import { RuntypeApiError as RuntypeApiError4 } from "@runtypelabs/sdk";
 function bashSingleQuote(s) {
   return "'" + s.replace(/'/g, "'\\''") + "'";
@@ -62057,8 +63074,8 @@ var deployCommand = new Command30("deploy").description("Export an agent or flow
     const apiKey = await ensureAuth();
     if (!apiKey) return;
     const client = createCliClient(apiKey);
-    const outDir = path15.resolve(options.output);
-    const projectName = options.name ?? slugify2(path15.basename(outDir));
+    const outDir = path16.resolve(options.output);
+    const projectName = options.name ?? slugify2(path16.basename(outDir));
     console.log(chalk37.cyan(`
 Scaffolding ${target} deployment to ${outDir}
 `));
@@ -62123,18 +63140,18 @@ Scaffolding ${target} deployment to ${outDir}
       }
       slugSet.add(slug);
     }
-    fs15.mkdirSync(path15.join(outDir, "agents"), { recursive: true });
-    fs15.mkdirSync(path15.join(outDir, "packages"), { recursive: true });
+    fs16.mkdirSync(path16.join(outDir, "agents"), { recursive: true });
+    fs16.mkdirSync(path16.join(outDir, "packages"), { recursive: true });
     for (const { name, def } of agentDefs) {
       const filename = `${slugify2(name)}.json`;
-      fs15.writeFileSync(path15.join(outDir, "agents", filename), JSON.stringify(def, null, 2));
+      fs16.writeFileSync(path16.join(outDir, "agents", filename), JSON.stringify(def, null, 2));
       console.log(`  Wrote agents/${filename}`);
     }
     const agentNames = agentDefs.map((a) => a.name);
     let monorepoRoot = process.cwd();
     for (let i = 0; i < 8; i++) {
-      if (fs15.existsSync(path15.join(monorepoRoot, "pnpm-workspace.yaml"))) break;
-      const parent = path15.dirname(monorepoRoot);
+      if (fs16.existsSync(path16.join(monorepoRoot, "pnpm-workspace.yaml"))) break;
+      const parent = path16.dirname(monorepoRoot);
       if (parent === monorepoRoot) break;
       monorepoRoot = parent;
     }
@@ -62144,35 +63161,35 @@ Scaffolding ${target} deployment to ${outDir}
     }
     const secretNames = Array.from(allSecrets);
     if (target === "cloudflare") {
-      fs15.mkdirSync(path15.join(outDir, "src"), { recursive: true });
-      fs15.writeFileSync(path15.join(outDir, "src", "index.ts"), workerIndexTs(agentSlugs));
-      fs15.writeFileSync(path15.join(outDir, "wrangler.toml"), wranglerToml(projectName));
-      fs15.writeFileSync(path15.join(outDir, "package.json"), workerPackageJson(projectName, "workspace:*"));
-      fs15.writeFileSync(path15.join(outDir, "tsconfig.json"), workerTsconfigJson());
-      const setupPath = path15.join(outDir, "setup.sh");
-      fs15.writeFileSync(setupPath, workerSetupSh(monorepoRoot));
-      fs15.chmodSync(setupPath, 493);
-      fs15.writeFileSync(path15.join(outDir, "README.md"), workerReadme(agentNames, secretNames));
+      fs16.mkdirSync(path16.join(outDir, "src"), { recursive: true });
+      fs16.writeFileSync(path16.join(outDir, "src", "index.ts"), workerIndexTs(agentSlugs));
+      fs16.writeFileSync(path16.join(outDir, "wrangler.toml"), wranglerToml(projectName));
+      fs16.writeFileSync(path16.join(outDir, "package.json"), workerPackageJson(projectName, "workspace:*"));
+      fs16.writeFileSync(path16.join(outDir, "tsconfig.json"), workerTsconfigJson());
+      const setupPath = path16.join(outDir, "setup.sh");
+      fs16.writeFileSync(setupPath, workerSetupSh(monorepoRoot));
+      fs16.chmodSync(setupPath, 493);
+      fs16.writeFileSync(path16.join(outDir, "README.md"), workerReadme(agentNames, secretNames));
     } else if (target === "vercel") {
-      fs15.mkdirSync(path15.join(outDir, "api"), { recursive: true });
-      fs15.writeFileSync(path15.join(outDir, "api", "[[...route]].ts"), vercelRouteTs(agentSlugs));
-      fs15.writeFileSync(path15.join(outDir, "vercel.json"), vercelJson());
-      fs15.writeFileSync(path15.join(outDir, "package.json"), vercelPackageJson(projectName, "workspace:*"));
-      fs15.writeFileSync(path15.join(outDir, "tsconfig.json"), vercelTsconfigJson());
-      const setupPath = path15.join(outDir, "setup.sh");
-      fs15.writeFileSync(setupPath, vercelSetupSh(monorepoRoot));
-      fs15.chmodSync(setupPath, 493);
-      fs15.writeFileSync(path15.join(outDir, "README.md"), vercelReadme(agentNames, secretNames));
+      fs16.mkdirSync(path16.join(outDir, "api"), { recursive: true });
+      fs16.writeFileSync(path16.join(outDir, "api", "[[...route]].ts"), vercelRouteTs(agentSlugs));
+      fs16.writeFileSync(path16.join(outDir, "vercel.json"), vercelJson());
+      fs16.writeFileSync(path16.join(outDir, "package.json"), vercelPackageJson(projectName, "workspace:*"));
+      fs16.writeFileSync(path16.join(outDir, "tsconfig.json"), vercelTsconfigJson());
+      const setupPath = path16.join(outDir, "setup.sh");
+      fs16.writeFileSync(setupPath, vercelSetupSh(monorepoRoot));
+      fs16.chmodSync(setupPath, 493);
+      fs16.writeFileSync(path16.join(outDir, "README.md"), vercelReadme(agentNames, secretNames));
     } else {
-      fs15.writeFileSync(path15.join(outDir, "server.ts"), serverTs());
-      fs15.writeFileSync(path15.join(outDir, "Dockerfile"), dockerfile());
-      fs15.writeFileSync(path15.join(outDir, ".dockerignore"), dockerignore());
-      fs15.writeFileSync(path15.join(outDir, "tsconfig.json"), tsconfigJson());
-      fs15.writeFileSync(path15.join(outDir, "package.json"), packageJson(projectName, "workspace:*"));
-      const setupPath = path15.join(outDir, "setup.sh");
-      fs15.writeFileSync(setupPath, setupSh(monorepoRoot));
-      fs15.chmodSync(setupPath, 493);
-      fs15.writeFileSync(path15.join(outDir, "README.md"), readme(agentNames, secretNames));
+      fs16.writeFileSync(path16.join(outDir, "server.ts"), serverTs());
+      fs16.writeFileSync(path16.join(outDir, "Dockerfile"), dockerfile());
+      fs16.writeFileSync(path16.join(outDir, ".dockerignore"), dockerignore());
+      fs16.writeFileSync(path16.join(outDir, "tsconfig.json"), tsconfigJson());
+      fs16.writeFileSync(path16.join(outDir, "package.json"), packageJson(projectName, "workspace:*"));
+      const setupPath = path16.join(outDir, "setup.sh");
+      fs16.writeFileSync(setupPath, setupSh(monorepoRoot));
+      fs16.chmodSync(setupPath, 493);
+      fs16.writeFileSync(path16.join(outDir, "README.md"), readme(agentNames, secretNames));
     }
     console.log("");
     console.log(chalk37.green(`\u2713 Scaffold written to ${outDir}`));
@@ -62230,19 +63247,19 @@ import { Command as Command31 } from "commander";
 import chalk39 from "chalk";
 
 // src/lib/skills-install.ts
-import { mkdirSync as mkdirSync9, readFileSync as readFileSync17, writeFileSync as writeFileSync7 } from "fs";
-import path16 from "path";
+import { mkdirSync as mkdirSync9, readFileSync as readFileSync18, writeFileSync as writeFileSync7 } from "fs";
+import path17 from "path";
 import readline4 from "readline";
 import chalk38 from "chalk";
 var SKILLS_REPO = "runtypelabs/skills";
 var SKILLS_INSTALL_RETRY_HINT = "Retry with `runtype skills install`, or install manually: npx skills add runtypelabs/skills";
 var METADATA_FILENAME = "agents-skills-install.json";
 function metadataPath() {
-  return path16.join(getRuntypeHomeDir(), METADATA_FILENAME);
+  return path17.join(getRuntypeHomeDir(), METADATA_FILENAME);
 }
 function readSkillsInstallMetadata() {
   try {
-    const raw = readFileSync17(metadataPath(), "utf8");
+    const raw = readFileSync18(metadataPath(), "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) && parsed.version === 1 && typeof parsed.accepted === "boolean") {
       return parsed;
@@ -62254,7 +63271,7 @@ function readSkillsInstallMetadata() {
 }
 function writeSkillsInstallMetadata(metadata) {
   try {
-    mkdirSync9(path16.dirname(metadataPath()), { recursive: true });
+    mkdirSync9(path17.dirname(metadataPath()), { recursive: true });
     writeFileSync7(metadataPath(), JSON.stringify(metadata, null, 2));
   } catch {
   }
@@ -62305,8 +63322,8 @@ async function promptConfirm3(message, defaultYes = true) {
   const rl = readline4.createInterface({ input: process.stdin, output: process.stdout });
   const hint = defaultYes ? chalk38.dim(" (Y/n)") : chalk38.dim(" (y/N)");
   try {
-    const answer = await new Promise((resolve10) => {
-      rl.question(`${message}${hint}: `, resolve10);
+    const answer = await new Promise((resolve11) => {
+      rl.question(`${message}${hint}: `, resolve11);
     });
     const t = answer.trim().toLowerCase();
     if (t === "") return defaultYes;
@@ -62510,11 +63527,265 @@ skillsCommand.command("install").description(`Install Runtype skills (${SKILLS_R
   }
 );
 
+// src/commands/apps.ts
+import { readdirSync as readdirSync6, readFileSync as readFileSync19, lstatSync, statSync as statSync7, existsSync as existsSync14 } from "fs";
+import { join as join12, relative as relative5 } from "path";
+import { Command as Command32 } from "commander";
+import chalk40 from "chalk";
+import { zipSync } from "fflate";
+var appsCommand = new Command32("apps").description(
+  "Manage Runtype Apps (hosted AI apps on *.runtype.run)"
+);
+var MANIFEST_FILENAME = "runtype.app.json";
+function collectBundleFiles(dir) {
+  const zippable = {};
+  const walk = (current) => {
+    for (const entry of readdirSync6(current)) {
+      if (entry.startsWith(".")) continue;
+      const full = join12(current, entry);
+      const stat = lstatSync(full);
+      if (stat.isSymbolicLink()) continue;
+      if (stat.isDirectory()) {
+        if (entry === "node_modules") continue;
+        walk(full);
+      } else {
+        zippable[relative5(dir, full).split("\\").join("/")] = readFileSync19(full);
+      }
+    }
+  };
+  walk(dir);
+  return zippable;
+}
+function fail(message, jsonMode, code) {
+  if (jsonMode) {
+    printJson({ status: "error", error: message, code });
+  } else {
+    console.error(chalk40.red(message));
+  }
+  process.exit(1);
+}
+appsCommand.command("list").description("List your apps").option("--json", "Structured JSON output").action(async (options, cmd) => {
+  const globals = cmd.optsWithGlobals();
+  const jsonMode = !!(options.json ?? globals.json);
+  const apiKey = await ensureAuth();
+  if (!apiKey) return;
+  const client = createCliClient(apiKey);
+  try {
+    const { data } = await client.apps.list();
+    if (jsonMode) {
+      printJson({ data });
+      return;
+    }
+    if (data.length === 0) {
+      console.log(chalk40.yellow("No apps yet. Create one with `runtype apps create`."));
+      return;
+    }
+    for (const app of data) {
+      const status = app.status === "suspended" ? chalk40.red("suspended") : chalk40.green("active");
+      const serving = app.activeVersionId ? "" : chalk40.dim(" (no active version)");
+      console.log(`${chalk40.bold(app.name)} ${chalk40.dim(app.id)}`);
+      console.log(`  ${app.url}  ${status}  ${app.visibility}${serving}`);
+    }
+  } catch (error51) {
+    fail(
+      `Failed to list apps: ${error51 instanceof Error ? error51.message : String(error51)}`,
+      jsonMode,
+      "LIST_FAILED"
+    );
+  }
+});
+appsCommand.command("create").description("Create an app (the hostname is {slug}-{shortId}.runtype.run)").requiredOption("-s, --slug <slug>", "Hostname slug (lowercase, must start with a letter)").requiredOption("-n, --name <name>", "Display name").option("-d, --description <text>", "Description").option("--visibility <visibility>", "public or unlisted (default unlisted)").option("--json", "Structured JSON output").action(
+  async (options, cmd) => {
+    const globals = cmd.optsWithGlobals();
+    const jsonMode = !!(options.json ?? globals.json);
+    const apiKey = await ensureAuth();
+    if (!apiKey) return;
+    const client = createCliClient(apiKey);
+    try {
+      const app = await client.apps.create({
+        slug: options.slug,
+        name: options.name,
+        description: options.description,
+        visibility: options.visibility
+      });
+      if (jsonMode) {
+        printJson(app);
+        return;
+      }
+      console.log(chalk40.green(`Created ${app.name} (${app.id})`));
+      console.log(`  ${app.url}`);
+      console.log(chalk40.dim("  Deploy a bundle with `runtype apps deploy <dir> --app " + app.id + "`"));
+    } catch (error51) {
+      fail(
+        `Failed to create app: ${error51 instanceof Error ? error51.message : String(error51)}`,
+        jsonMode,
+        "CREATE_FAILED"
+      );
+    }
+  }
+);
+appsCommand.command("deploy <dir>").description("Zip a bundle directory, upload it as a new version, and activate it").requiredOption("-a, --app <appId>", "The app id (app_...) to deploy to").option("--no-activate", "Upload without activating (what is served stays unchanged)").option("--json", "Structured JSON output").action(
+  async (dir, options, cmd) => {
+    const globals = cmd.optsWithGlobals();
+    const jsonMode = !!(options.json ?? globals.json);
+    const apiKey = await ensureAuth();
+    if (!apiKey) return;
+    if (!existsSync14(dir) || !statSync7(dir).isDirectory()) {
+      fail(`Not a directory: ${dir}`, jsonMode, "INVALID_DIR");
+    }
+    let bundleFiles = {};
+    try {
+      bundleFiles = collectBundleFiles(dir);
+    } catch (error51) {
+      fail(
+        `Failed to read ${dir}: ${error51 instanceof Error ? error51.message : String(error51)}`,
+        jsonMode,
+        "INVALID_DIR"
+      );
+    }
+    if (!bundleFiles["index.html"]) {
+      fail(
+        `${dir} is missing index.html at its root (symlinked files are not bundled).`,
+        jsonMode,
+        "MISSING_INDEX"
+      );
+    }
+    if (!bundleFiles[MANIFEST_FILENAME]) {
+      fail(
+        `${dir} is missing ${MANIFEST_FILENAME} at its root (symlinked files are not bundled). Every app bundle needs a manifest; see the build-runtype-app skill or the Runtype docs.`,
+        jsonMode,
+        "MISSING_MANIFEST"
+      );
+    }
+    const client = createCliClient(apiKey);
+    try {
+      const zipBytes = zipSync(bundleFiles);
+      if (!jsonMode) console.log(chalk40.dim(`Uploading ${(zipBytes.byteLength / 1024).toFixed(1)} KB bundle...`));
+      const version2 = await client.apps.uploadVersion(options.app, zipBytes);
+      let app;
+      if (options.activate) {
+        try {
+          const activated = await client.apps.activate(options.app, version2.id);
+          app = activated.app;
+        } catch (error51) {
+          const message = error51 instanceof Error ? error51.message : String(error51);
+          if (jsonMode) {
+            printJson({
+              status: "error",
+              error: `Activation failed: ${message}`,
+              code: "ACTIVATE_FAILED",
+              version: version2,
+              activated: false
+            });
+          } else {
+            console.error(chalk40.red(`Uploaded version ${version2.versionNumber}, but activation failed: ${message}`));
+            console.error(chalk40.dim(`  Retry with \`runtype apps activate ${options.app} ${version2.id}\` (no re-upload needed).`));
+          }
+          process.exit(1);
+        }
+      }
+      if (jsonMode) {
+        printJson({ version: version2, app, activated: options.activate });
+        return;
+      }
+      console.log(
+        chalk40.green(
+          `Deployed version ${version2.versionNumber} (${version2.fileCount} files, ${(version2.sizeBytes / 1024).toFixed(1)} KB)`
+        )
+      );
+      if (app) {
+        console.log(`  Live at ${chalk40.bold(app.url)}`);
+      } else {
+        console.log(chalk40.dim(`  Uploaded but not activated. Activate with \`runtype apps activate ${options.app} ${version2.id}\``));
+      }
+    } catch (error51) {
+      fail(
+        `Deploy failed: ${error51 instanceof Error ? error51.message : String(error51)}`,
+        jsonMode,
+        "DEPLOY_FAILED"
+      );
+    }
+  }
+);
+appsCommand.command("versions <appId>").description("List an app's versions, newest first").option("--json", "Structured JSON output").action(async (appId, options, cmd) => {
+  const globals = cmd.optsWithGlobals();
+  const jsonMode = !!(options.json ?? globals.json);
+  const apiKey = await ensureAuth();
+  if (!apiKey) return;
+  const client = createCliClient(apiKey);
+  try {
+    const { data } = await client.apps.listVersions(appId);
+    if (jsonMode) {
+      printJson({ data });
+      return;
+    }
+    if (data.length === 0) {
+      console.log(chalk40.yellow("No versions uploaded yet."));
+      return;
+    }
+    for (const version2 of data) {
+      const marker = version2.status === "active" ? chalk40.green(" (active)") : "";
+      console.log(
+        `v${version2.versionNumber} ${chalk40.dim(version2.id)} ${version2.fileCount} files, ${(version2.sizeBytes / 1024).toFixed(1)} KB${marker}`
+      );
+    }
+  } catch (error51) {
+    fail(
+      `Failed to list versions: ${error51 instanceof Error ? error51.message : String(error51)}`,
+      jsonMode,
+      "VERSIONS_FAILED"
+    );
+  }
+});
+appsCommand.command("activate <appId> <versionId>").description("Activate an uploaded version (deploy or rollback)").option("--json", "Structured JSON output").action(async (appId, versionId, options, cmd) => {
+  const globals = cmd.optsWithGlobals();
+  const jsonMode = !!(options.json ?? globals.json);
+  const apiKey = await ensureAuth();
+  if (!apiKey) return;
+  const client = createCliClient(apiKey);
+  try {
+    const { app, version: version2 } = await client.apps.activate(appId, versionId);
+    if (jsonMode) {
+      printJson({ app, version: version2 });
+      return;
+    }
+    console.log(chalk40.green(`Activated version ${version2.versionNumber}`));
+    console.log(`  Live at ${chalk40.bold(app.url)}`);
+  } catch (error51) {
+    fail(
+      `Activation failed: ${error51 instanceof Error ? error51.message : String(error51)}`,
+      jsonMode,
+      "ACTIVATE_FAILED"
+    );
+  }
+});
+appsCommand.command("delete <appId>").description("Permanently delete an app, its versions, and its hosting").option("--json", "Structured JSON output").action(async (appId, options, cmd) => {
+  const globals = cmd.optsWithGlobals();
+  const jsonMode = !!(options.json ?? globals.json);
+  const apiKey = await ensureAuth();
+  if (!apiKey) return;
+  const client = createCliClient(apiKey);
+  try {
+    await client.apps.delete(appId);
+    if (jsonMode) {
+      printJson({ status: "deleted", appId });
+      return;
+    }
+    console.log(chalk40.green(`Deleted ${appId}`));
+  } catch (error51) {
+    fail(
+      `Delete failed: ${error51 instanceof Error ? error51.message : String(error51)}`,
+      jsonMode,
+      "DELETE_FAILED"
+    );
+  }
+});
+
 // src/index.ts
 init_credential_store();
 
 // src/lib/update-check.ts
-import chalk40 from "chalk";
+import chalk41 from "chalk";
 import Conf3 from "conf";
 var UPDATE_CHECK_INTERVAL_MS = 12 * 60 * 60 * 1e3;
 var UPDATE_NOTIFY_INTERVAL_MS = 24 * 60 * 60 * 1e3;
@@ -62608,7 +63879,7 @@ function notifyFromCachedCliUpdate(args, options = {}) {
     console.error(message);
   });
   notify(
-    `${chalk40.yellow("Update available:")} ${chalk40.red(currentVersion)} ${chalk40.gray("->")} ${chalk40.green(latestVersion)}  ${chalk40.gray(`(${getUpgradeCommand()})`)}`
+    `${chalk41.yellow("Update available:")} ${chalk41.red(currentVersion)} ${chalk41.gray("->")} ${chalk41.green(latestVersion)}  ${chalk41.gray(`(${getUpgradeCommand()})`)}`
   );
   store.set("lastNotifiedAt", now.toISOString());
   store.set("lastNotifiedVersion", latestVersion);
@@ -62650,7 +63921,7 @@ function maybeNotifyAboutCliUpdate(args, options = {}) {
 // src/index.ts
 loadEnv();
 setCliTitle();
-var program = new Command32();
+var program = new Command33();
 program.name("runtype").description("CLI for Runtype AI Platform").version(getCliVersion()).option("-v, --verbose", "Enable verbose output").option("--api-url <url>", "Override API URL").option("--json", "Output as JSON");
 program.addCommand(initCommand);
 program.addCommand(loginCommand);
@@ -62684,6 +63955,7 @@ program.addCommand(tailCommand);
 program.addCommand(validateProductCommand);
 program.addCommand(deployCommand);
 program.addCommand(skillsCommand);
+program.addCommand(appsCommand);
 program.exitOverride();
 async function run() {
   const userArgs = process.argv.slice(2);
@@ -62701,15 +63973,15 @@ async function run() {
 run().catch((error51) => {
   const commanderError = error51;
   if (commanderError.code === "commander.missingArgument") {
-    console.error(chalk41.red(`Error: ${commanderError.message}`));
+    console.error(chalk42.red(`Error: ${commanderError.message}`));
     process.exit(1);
   } else if (commanderError.code === "commander.unknownOption") {
-    console.error(chalk41.red(`Error: ${commanderError.message}`));
+    console.error(chalk42.red(`Error: ${commanderError.message}`));
     process.exit(1);
   } else if (commanderError.code === "commander.help" || commanderError.code === "commander.version") {
     process.exit(0);
   } else {
-    console.error(chalk41.red("An unexpected error occurred:"));
+    console.error(chalk42.red("An unexpected error occurred:"));
     console.error(error51);
     process.exit(1);
   }
@@ -62718,12 +63990,12 @@ async function handleNoCommand() {
   const store = new CredentialStore();
   const hasCredentials = await store.hasCredentials();
   if (!hasCredentials) {
-    console.log(chalk41.cyan("\nWelcome to Runtype CLI!\n"));
+    console.log(chalk42.cyan("\nWelcome to Runtype CLI!\n"));
     console.log("It looks like this is your first time. Run the setup wizard:");
-    console.log(`  ${chalk41.green("runtype init")}
+    console.log(`  ${chalk42.green("runtype init")}
 `);
     console.log("Or see all available commands:");
-    console.log(`  ${chalk41.green("runtype --help")}
+    console.log(`  ${chalk42.green("runtype --help")}
 `);
   } else {
     try {