@agent-compose/sdk 0.8.0 → 0.8.1

package/dist/index.js

@@ -959,6 +959,8 @@ function extractMetadata(source) {
     out.invokePolicy = freezeMetadataValue(source.invokePolicy);
   if (source.environmentBuild !== undefined)
     out.environmentBuild = source.environmentBuild;
+  if (source.factoryDrive !== undefined)
+    out.factoryDrive = source.factoryDrive;
   return Object.freeze(out);
 }
 function freezeMetadataValue(value) {
@@ -1446,14 +1448,47 @@ class AgentComposeClient {
         ...opts?.placeholders !== undefined ? { placeholders: opts.placeholders } : {},
         ...opts?.size !== undefined ? { size: opts.size } : {},
         ...parentRunId ? { parentRunId } : {},
-        ...opts?.agentId ? { agentId: opts.agentId } : {}
+        ...opts?.agentId ? { agentId: opts.agentId } : {},
+        ...opts?.funding !== undefined ? { funding: opts.funding } : {},
+        ...opts?.fundingSecret !== undefined ? { fundingSecret: opts.fundingSecret } : {}
+      }
+    });
+  }
+  invokeInline(workflow, input, opts) {
+    const parentRunId = opts?.parentRunId === undefined ? detectAmbientParentRunId() : opts.parentRunId;
+    const factorySlug = opts?.factorySlug ?? DEFAULT_FACTORY;
+    const headers = {};
+    if (opts?.idempotencyKey)
+      headers["Idempotency-Key"] = opts.idempotencyKey;
+    return this.fetch(`/api/v1/factories/${encodeURIComponent(factorySlug)}/invoke`, {
+      method: "POST",
+      ...opts?.idempotencyKey ? { headers } : {},
+      body: {
+        workflow,
+        input,
+        ...opts?.title !== undefined ? { title: opts.title } : {},
+        ...opts?.snapshots !== undefined ? { snapshots: opts.snapshots } : {},
+        ...opts?.networkPolicy !== undefined ? { networkPolicy: opts.networkPolicy } : {},
+        ...opts?.placeholders !== undefined ? { placeholders: opts.placeholders } : {},
+        ...opts?.size !== undefined ? { size: opts.size } : {},
+        ...parentRunId ? { parentRunId } : {},
+        ...opts?.agentId ? { agentId: opts.agentId } : {},
+        ...opts?.funding !== undefined ? { funding: opts.funding } : {},
+        ...opts?.fundingSecret !== undefined ? { fundingSecret: opts.fundingSecret } : {}
       }
     });
   }
   async invokeAndWait(name, input, opts) {
+    const { id: runId } = await this.invoke(name, input, opts);
+    return this.waitForRun(runId, opts);
+  }
+  async invokeInlineAndWait(workflow, input, opts) {
+    const { id: runId } = await this.invokeInline(workflow, input, opts);
+    return this.waitForRun(runId, opts);
+  }
+  async waitForRun(runId, opts) {
     const timeoutMs = opts?.timeoutMs ?? 30 * 60 * 1000;
     const pollMs = opts?.pollIntervalMs ?? 1000;
-    const { id: runId } = await this.invoke(name, input, opts);
     const deadline = Date.now() + timeoutMs;
     while (Date.now() < deadline) {
       const status = await this.getStatus(runId);
@@ -1462,7 +1497,7 @@ class AgentComposeClient {
       }
       await new Promise((r) => setTimeout(r, pollMs));
     }
-    throw new AgentComposeError(504, `invokeAndWait: run ${runId} did not settle within ${timeoutMs}ms`);
+    throw new AgentComposeError(504, `waitForRun: run ${runId} did not settle within ${timeoutMs}ms`);
   }
   async listSnapshots(opts) {
     const body = await this.listSnapshotsPage(opts);
@@ -1598,6 +1633,11 @@ class AgentComposeClient {
       preview: a.preview
     }));
   }
+  async getRunArtifactBytes(runId, path) {
+    const q2 = new URLSearchParams({ path });
+    const buf = await this.fetch(`/api/v1/workflows/${encodeURIComponent(runId)}/artifacts/content?${q2}`, { responseType: "arrayBuffer" });
+    return new Uint8Array(buf);
+  }
   async putFactoryFile(path, content, opts) {
     const factorySlug = opts?.factorySlug ?? (typeof process !== "undefined" ? process.env?.AGENT_COMPOSE_FACTORY : undefined) ?? DEFAULT_FACTORY;
     const runToken = typeof process !== "undefined" ? process.env?.AGENT_COMPOSE_RUN_TOKEN : undefined;
@@ -1621,12 +1661,28 @@ class AgentComposeClient {
     const q2 = new URLSearchParams({ path });
     if (opts?.revision !== undefined)
       q2.set("revision", String(opts.revision));
+    if (opts?.branch !== undefined)
+      q2.set("branch", opts.branch);
     const buf = await this.fetch(`/api/v1/factories/${encodeURIComponent(factorySlug)}/files/content?${q2}`, { responseType: "arrayBuffer" });
     return new Uint8Array(buf);
   }
   async getFactoryFile(path, opts) {
     return new TextDecoder().decode(await this.getFactoryFileBytes(path, opts));
   }
+  async createDriveMountSession(opts) {
+    const factorySlug = opts?.factorySlug ?? (typeof process !== "undefined" ? process.env?.AGENT_COMPOSE_FACTORY : undefined) ?? DEFAULT_FACTORY;
+    return this.fetch(`/api/v1/factories/${encodeURIComponent(factorySlug)}/files/mount-sessions`, {
+      method: "POST",
+      body: {
+        ...opts?.conversationId ? { conversationId: opts.conversationId } : {},
+        ...opts?.host ? { host: opts.host } : {}
+      }
+    });
+  }
+  async releaseDriveMountSession(conversationId, opts) {
+    const factorySlug = opts?.factorySlug ?? (typeof process !== "undefined" ? process.env?.AGENT_COMPOSE_FACTORY : undefined) ?? DEFAULT_FACTORY;
+    return this.fetch(`/api/v1/factories/${encodeURIComponent(factorySlug)}/files/mount-sessions/${encodeURIComponent(conversationId)}/release`, { method: "POST", body: {} });
+  }
   listConversations(opts) {
     const q2 = new URLSearchParams;
     if (opts?.cursor)
@@ -1639,8 +1695,9 @@ class AgentComposeClient {
       q2.set("cursor", opts.cursor);
     return this.fetch(`/api/v1/sessions?${q2}`);
   }
-  getConversation(id) {
-    return this.fetch(`/api/v1/conversations/${encodeURIComponent(id)}`);
+  getConversation(id, opts) {
+    const q2 = opts?.limit !== undefined ? `?limit=${opts.limit}` : "";
+    return this.fetch(`/api/v1/conversations/${encodeURIComponent(id)}${q2}`);
   }
   createCloudSession(input) {
     return this.fetch(`/api/v1/sessions/cloud`, {
@@ -1658,7 +1715,10 @@ class AgentComposeClient {
         ...input.templateId ? { templateId: input.templateId } : {},
         ...input.sandboxSize ? { sandboxSize: input.sandboxSize } : {},
         ...input.networkPolicy !== undefined ? { networkPolicy: input.networkPolicy } : {},
-        ...input.connectorProfileId !== undefined ? { connectorProfileId: input.connectorProfileId } : {}
+        ...input.connectorProfileId !== undefined ? { connectorProfileId: input.connectorProfileId } : {},
+        ...input.setupCommand !== undefined ? { setupCommand: input.setupCommand } : {},
+        ...input.handoffOrigin !== undefined ? { handoffOrigin: input.handoffOrigin } : {},
+        ...input.seedFiles !== undefined ? { seedFiles: input.seedFiles } : {}
       }
     });
   }
@@ -2466,6 +2526,7 @@ class AcpClientPeer {
 }
 // src/utils/bundler.ts
 import { createHash as createHash2 } from "node:crypto";
+import { dirname as dirname2 } from "node:path";
 import { parse as babelParse } from "@babel/parser";
 
 // src/utils/source-loader.ts
@@ -2495,15 +2556,119 @@ class WorkflowSourceValidationError extends Error {
     this.name = "WorkflowSourceValidationError";
   }
 }
+var SDK_PACKAGE = "@agent-compose/sdk";
+var SDK_SPECIFIER_ALIASES = [
+  "agentc/sdk",
+  "@agentc/sdk",
+  "agentc-sdk",
+  "agent-compose/sdk",
+  "agentcompose/sdk",
+  "@agentcompose/sdk",
+  "agent-compose-sdk"
+];
+var SDK_ALIAS_SET = new Set(SDK_SPECIFIER_ALIASES);
+function resolveSdkAlias(specifier) {
+  return SDK_ALIAS_SET.has(specifier) ? SDK_PACKAGE : null;
+}
+function aliasFilter() {
+  const alternation = SDK_SPECIFIER_ALIASES.map((s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|");
+  return new RegExp(`^(?:${alternation})$`);
+}
+function sdkAliasPlugin(bun) {
+  return {
+    name: "agent-compose-sdk-alias",
+    setup(build) {
+      build.onResolve({ filter: aliasFilter() }, (args) => {
+        const target = resolveSdkAlias(args.path);
+        if (!target)
+          return;
+        const from = args.importer ? dirname2(args.importer) : args.resolveDir;
+        try {
+          return { path: bun.resolveSync(target, from && from.length > 0 ? from : process.cwd()) };
+        } catch {
+          return;
+        }
+      });
+    }
+  };
+}
+function readUnresolvedSpecifier(diag) {
+  if (!diag || typeof diag !== "object")
+    return null;
+  const d = diag;
+  if (typeof d.specifier === "string" && d.specifier.length > 0)
+    return d.specifier;
+  const message = typeof d.message === "string" ? d.message : "";
+  const m = /Could not resolve:?\s*"([^"]+)"/.exec(message);
+  return m ? m[1] : null;
+}
+function flattenDiagnostics(failure) {
+  const out = [];
+  const seen = new Set;
+  const walk = (node, depth) => {
+    if (!node || depth > 4 || seen.has(node))
+      return;
+    seen.add(node);
+    if (Array.isArray(node)) {
+      for (const sub of node)
+        walk(sub, depth + 1);
+      return;
+    }
+    out.push(node);
+    if (typeof node === "object") {
+      const n = node;
+      if (Array.isArray(n.errors))
+        for (const sub of n.errors)
+          walk(sub, depth + 1);
+      if (n.cause)
+        walk(n.cause, depth + 1);
+    }
+  };
+  walk(failure, 0);
+  return out;
+}
+function diagnosticText(diag) {
+  if (diag instanceof Error)
+    return diag.message || String(diag);
+  if (diag && typeof diag === "object" && typeof diag.message === "string") {
+    return diag.message;
+  }
+  return String(diag);
+}
+function explainBundleFailure(err, label) {
+  const diagnostics = flattenDiagnostics(err);
+  const unresolved = [];
+  for (const diag of diagnostics) {
+    const specifier = readUnresolvedSpecifier(diag);
+    if (specifier && !unresolved.includes(specifier))
+      unresolved.push(specifier);
+  }
+  if (unresolved.length > 0) {
+    const quoted = unresolved.map((s) => `"${s}"`).join(", ");
+    return `Could not resolve ${quoted} — workflow source imports the platform SDK as "${SDK_PACKAGE}". ` + `Fix the import specifier in ${label}; anything that is genuinely a third-party ` + `package must be installed where the source is bundled.`;
+  }
+  const detail = diagnostics.map(diagnosticText).filter((t) => t.length > 0 && t !== "Bundle failed").join(`
+`);
+  return `Failed to bundle ${label}:
+${detail || "the bundler reported no diagnostics"}`;
+}
 async function bundle(path, label) {
   const bun = globalThis;
   if (!bun.Bun?.build)
     throw new Error("bundleWorkflow requires the Bun runtime (Bun.build)");
-  const result = await bun.Bun.build({ entrypoints: [path], format: "esm", target: "node" });
+  let result;
+  try {
+    result = await bun.Bun.build({
+      entrypoints: [path],
+      format: "esm",
+      target: "node",
+      plugins: [sdkAliasPlugin(bun.Bun)]
+    });
+  } catch (err) {
+    throw new WorkflowSourceValidationError(explainBundleFailure(err, label));
+  }
   if (!result.success) {
-    throw new Error(`Failed to bundle ${label}:
-${result.logs.map((l) => l.message).join(`
-`)}`);
+    throw new WorkflowSourceValidationError(explainBundleFailure(result.logs, label));
   }
   return result.outputs[0].text();
 }
@@ -2621,7 +2786,8 @@ async function bundleWorkflow(workflowPath, overrides) {
     ...metadata.connectors !== undefined ? { connectors: metadata.connectors } : {},
     ...metadata.connectorOperation !== undefined ? { connectorOperation: metadata.connectorOperation } : {},
     ...metadata.invokePolicy !== undefined ? { invokePolicy: metadata.invokePolicy } : {},
-    ...metadata.environmentBuild !== undefined ? { environmentBuild: metadata.environmentBuild } : {}
+    ...metadata.environmentBuild !== undefined ? { environmentBuild: metadata.environmentBuild } : {},
+    ...metadata.factoryDrive !== undefined ? { factoryDrive: metadata.factoryDrive } : {}
   };
 }
 function extractIOSchema(zodSchema) {
@@ -3019,7 +3185,8 @@ async function agentLoop(opts) {
       label,
       allowedTools: opts.allowedTools ?? DEFAULT_ALLOWED_TOOLS,
       ...client.model != null ? { model: client.model } : {},
-      ...client.kind != null ? { runtimeKind: client.kind } : {}
+      ...client.kind != null ? { runtimeKind: client.kind } : {},
+      ...opts.phase != null ? { phase: opts.phase } : {}
     });
   }
   const flushState = async (currentIteration) => {
@@ -3986,7 +4153,7 @@ var codexSpec = {
       "--skip-git-repo-check",
       "--dangerously-bypass-approvals-and-sandbox",
       ...model ? ["-m", shellQuote(model)] : [],
-      ...effort ? ["-c", `model_reasoning_effort=${effort}`] : [],
+      ...effort ? ["-c", `model_reasoning_effort=${effort === "max" ? "xhigh" : effort}`] : [],
       ...cwd ? ["-C", shellQuote(cwd)] : []
     ].join(" ");
     const exec = sessionId ? `codex exec resume ${shellQuote(sessionId)} ${flags}` : `codex exec ${flags}`;
@@ -4208,7 +4375,7 @@ function toolResultText(content) {
   }
   return content == null ? "" : JSON.stringify(content) ?? "";
 }
-var CLAUDE_CODE_THINKING_TOKENS = { low: 2048, medium: 8192, high: 16384 };
+var CLAUDE_CODE_EFFORT_LEVELS = ["low", "medium", "high", "xhigh", "max"];
 var claudeCodeSpec = {
   kind: "claude-code",
   authEnv: "ANTHROPIC_API_KEY",
@@ -4224,14 +4391,15 @@ var claudeCodeSpec = {
       "--include-partial-messages",
       "--dangerously-skip-permissions",
       ...model ? [`--model ${shellQuote(model)}`] : [],
+      ...effort ? [`--effort ${effort}`] : [],
       ...sessionId ? [`--resume ${shellQuote(sessionId)}`] : []
     ].join(" ");
-    const thinking = effort ? `MAX_THINKING_TOKENS=${CLAUDE_CODE_THINKING_TOKENS[effort]} ` : "";
-    return `${cwd ? `cd ${shellQuote(cwd)} && ` : ""}${thinking}IS_SANDBOX=1 claude ${flags} < ${shellQuote(promptPath)}`;
+    return `${cwd ? `cd ${shellQuote(cwd)} && ` : ""}IS_SANDBOX=1 claude ${flags} < ${shellQuote(promptPath)}`;
   },
   extractSessionId: (p) => typeof p.session_id === "string" ? p.session_id : undefined,
   mapEvent: (p) => {
     const ts = now10();
+    const parent = typeof p.parent_tool_use_id === "string" && p.parent_tool_use_id.length > 0 ? { parentToolUseId: p.parent_tool_use_id } : {};
     switch (p.type) {
       case "assistant": {
         const message = p.message;
@@ -4249,6 +4417,7 @@ var claudeCodeSpec = {
               toolName: String(b.name ?? "tool"),
               toolInput: b.input ?? {},
               toolUseId: String(b.id ?? ""),
+              ...parent,
               timestamp: ts
             }];
           }
@@ -4263,6 +4432,7 @@ var claudeCodeSpec = {
           toolUseId: String(b.tool_use_id ?? ""),
           output: toolResultText(b.content),
           isError: b.is_error === true,
+          ...parent,
           timestamp: ts
         }] : []);
       }
@@ -4892,7 +5062,7 @@ var vercelProviderDef = {
 
 // src/sandbox/providers/local.ts
 import { promises as fs2 } from "node:fs";
-import { dirname as dirname2 } from "node:path";
+import { dirname as dirname3 } from "node:path";
 import { spawn } from "node:child_process";
 import { Readable, Writable } from "node:stream";
 function makeLocalSandboxProvider() {
@@ -4958,7 +5128,7 @@ function makeLocalSandboxProvider() {
     },
     files: {
       async write(path, content) {
-        await fs2.mkdir(dirname2(path), { recursive: true });
+        await fs2.mkdir(dirname3(path), { recursive: true });
         await fs2.writeFile(path, content);
       },
       async read(path) {
@@ -5509,6 +5679,15 @@ async function runWorkflow(wf, ctx, opts) {
   }
 }
 // src/workflows/invoke-child.ts
+function deriveInvokeChildIdempotencyKey(parentRunId, childName) {
+  const step = getActiveStep();
+  if (!step)
+    return null;
+  const ordinal = nextPauseOrdinalInActiveStep(`invoke-child:${childName}`);
+  if (ordinal === null)
+    return null;
+  return `invoke-child:${parentRunId}:step${step.stepIndex}:${childName}:${ordinal}`;
+}
 function buildInvokeChild(runId, opts = {}) {
   let childClient = null;
   const getChildClient = () => {
@@ -5522,11 +5701,15 @@ function buildInvokeChild(runId, opts = {}) {
     childClient = new AgentComposeClient({ apiKey, baseUrl });
     return childClient;
   };
-  return (name, input, childOpts) => getChildClient().invokeAndWait(name, input, {
-    ...childOpts,
-    parentRunId: runId,
-    factorySlug: childOpts?.factorySlug ?? opts.defaultFactorySlug ?? process.env.AGENT_COMPOSE_FACTORY ?? process.env.AGENT_COMPOSE_FACTORY_SLUG ?? "default"
-  });
+  return (name, input, childOpts) => {
+    const idempotencyKey = childOpts?.idempotencyKey ?? deriveInvokeChildIdempotencyKey(runId, name) ?? undefined;
+    return getChildClient().invokeAndWait(name, input, {
+      ...childOpts,
+      ...idempotencyKey !== undefined ? { idempotencyKey } : {},
+      parentRunId: runId,
+      factorySlug: childOpts?.factorySlug ?? opts.defaultFactorySlug ?? process.env.AGENT_COMPOSE_FACTORY ?? process.env.AGENT_COMPOSE_FACTORY_SLUG ?? "default"
+    });
+  };
 }
 // src/workflow-steps/step.ts
 var CONTROL_CHARS = /[\u0000-\u001f\u007f]/;
@@ -6599,6 +6782,7 @@ async function agent(opts) {
       runtime: (runtimeOpts) => opts.runtime.create(opts.sandbox, { ...runtimeOpts, agentManual: buildAgentContextDoc(process.env) }),
       agentId,
       ...opts.label !== undefined ? { label: opts.label } : {},
+      ...opts.phase !== undefined ? { phase: opts.phase } : {},
       ...opts.budget?.turnsPerIteration !== undefined ? { turnsPerIteration: opts.budget.turnsPerIteration } : {},
       ...opts.budget?.maxIterations !== undefined ? { maxIterations: opts.budget.maxIterations } : {},
       ...opts.tools !== undefined ? { allowedTools: opts.tools } : {},
@@ -6669,7 +6853,21 @@ function clampPlanEntries(raw) {
 var TABLE_MAX_COLUMNS = 12;
 var TABLE_MAX_ROWS = 100;
 var TABLE_CELL_MAX_CHARS = 200;
-var IMAGE_PATH_MAX_CHARS = 512;
+var DRIVE_PATH_MAX_CHARS = 512;
+function isPlausibleDrivePath(raw) {
+  if (raw.trim().length === 0 || raw.length > DRIVE_PATH_MAX_CHARS)
+    return false;
+  if (raw.startsWith("-"))
+    return false;
+  if (/[\u0000-\u001f\u007f\\]/.test(raw))
+    return false;
+  if (/[|<>;`]|\$\(/.test(raw))
+    return false;
+  const trimmed = raw.replace(/^\/+|\/+$/g, "");
+  if (trimmed.length === 0)
+    return false;
+  return trimmed.split("/").every((seg) => seg !== "" && seg !== "." && seg !== "..");
+}
 function clampCellString(s) {
   return s.length > TABLE_CELL_MAX_CHARS ? `${s.slice(0, TABLE_CELL_MAX_CHARS - 1)}…` : s;
 }
@@ -6860,7 +7058,7 @@ function parseDisplayMarker(line) {
     }
     case "document": {
       const path = str("path");
-      if (!path)
+      if (!path || !isPlausibleDrivePath(path))
         return null;
       return {
         kind: "document",
@@ -6875,7 +7073,7 @@ function parseDisplayMarker(line) {
     }
     case "image": {
       const path = str("path");
-      if (!path || path.length > IMAGE_PATH_MAX_CHARS)
+      if (!path || !isPlausibleDrivePath(path))
         return null;
       return {
         kind: "image",
@@ -7014,6 +7212,8 @@ function detectAgentcInvocation(command) {
     const w = words[i];
     if (SHELL_STOPPERS.has(w))
       break;
+    if (/^\d*>&\d+$/.test(w))
+      continue;
     if (w.startsWith("--")) {
       if (VALUE_FLAGS.has(w) && i + 1 < words.length && !SHELL_STOPPERS.has(words[i + 1])) {
         flags.set(w, words[i + 1]);
@@ -7026,6 +7226,7 @@ function detectAgentcInvocation(command) {
   const factorySlug = flags.get("--factory");
   const withSlug = factorySlug ? { factorySlug } : {};
   const uuid = (v) => v && UUID_RE.test(v) ? v : null;
+  const drivePath = (v) => v && isPlausibleDrivePath(v) ? v : null;
   if (args[0] === "display") {
     switch (args[1]) {
       case "run": {
@@ -7036,19 +7237,27 @@ function detectAgentcInvocation(command) {
         const runId = uuid(args[2]);
         return runId ? { verb: "display-changes", runId, ...withSlug } : null;
       }
-      case "document":
-        return args[2] ? { verb: "display-document", path: args[2], ...withSlug } : null;
+      case "document": {
+        const path = drivePath(args[2]);
+        return path ? { verb: "display-document", path, ...withSlug } : null;
+      }
       case "plan":
         return { verb: "display-plan" };
-      case "image":
-        return args[2] ? { verb: "display-image", path: args[2], ...withSlug } : null;
-      case "preview":
-        return args[2] ? { verb: "display-preview", path: args[2] } : null;
+      case "image": {
+        const path = drivePath(args[2]);
+        return path ? { verb: "display-image", path, ...withSlug } : null;
+      }
+      case "preview": {
+        const path = drivePath(args[2]);
+        return path ? { verb: "display-preview", path } : null;
+      }
       case "table": {
         const file = flags.get("--file");
         const hasData = flags.has("--data");
-        if (file && !hasData)
-          return { verb: "display-table", source: "file", path: file };
+        if (file && !hasData) {
+          const path = drivePath(file);
+          return path ? { verb: "display-table", source: "file", path } : null;
+        }
         if (hasData && !file)
           return { verb: "display-table", source: "inline" };
         return null;
@@ -7060,11 +7269,12 @@ function detectAgentcInvocation(command) {
       case "diff": {
         const from = flags.get("--from");
         const to = flags.get("--to");
-        if (!args[2] || !from || !to)
+        const path = drivePath(args[2]);
+        if (!path || !from || !to)
           return null;
         if (!REVISION_SELECTOR_RE.test(from) || !REVISION_SELECTOR_RE.test(to))
           return null;
-        return { verb: "display-diff", path: args[2], from, to };
+        return { verb: "display-diff", path, from, to };
       }
       case "ask": {
         const prompt = flags.get("--prompt");
@@ -7095,8 +7305,9 @@ function detectAgentcInvocation(command) {
     const runId = uuid(args[2]);
     return runId ? { verb: "run-get", runId } : null;
   }
-  if (args[0] === "files" && args[1] === "read" && args[2]) {
-    return { verb: "files-read", path: args[2], ...withSlug };
+  if (args[0] === "files" && args[1] === "read") {
+    const path = drivePath(args[2]);
+    return path ? { verb: "files-read", path, ...withSlug } : null;
   }
   return null;
 }
@@ -7339,6 +7550,7 @@ export {
   runWorkflowSingleStep,
   runWorkflow,
   runProcessorChain,
+  resolveSdkAlias,
   requireScope,
   requestPauseAndAwait,
   requestContextPath,
@@ -7367,6 +7579,7 @@ export {
   killSandboxById,
   killAllSandboxes,
   isWorkflow,
+  isPlausibleDrivePath,
   isPlatformE2bTemplateAlias,
   isE2bSupportedSize,
   invokeStep,
@@ -7375,6 +7588,7 @@ export {
   getSandboxQuotas,
   formatError,
   findDisplayMarker,
+  explainBundleFailure,
   editTool,
   e2bMachineSpec,
   e2bDevboxTemplateRef,
@@ -7441,6 +7655,8 @@ export {
   STEP_RESULT_PREFIX,
   STEP_PAUSE_PREFIX,
   STEP_ENV,
+  SDK_SPECIFIER_ALIASES,
+  SDK_PACKAGE,
   SANDBOX_VCPUS,
   SANDBOX_UNAVAILABLE_PREFIX,
   ReservedKeyError,
@@ -7462,6 +7678,7 @@ export {
   E2B_DEVBOX_TEMPLATE,
   E2B_DEVBOX_SPEC,
   E2B_DEVBOX_RECIPE_VERSION,
+  DRIVE_PATH_MAX_CHARS,
   DISPLAY_MARKER_VERSION,
   DISPLAY_MARKER_KEY,
   DIRECTIVE_MARKER_SUFFIX,
@@ -7469,7 +7686,7 @@ export {
   DEFAULT_SANDBOX_SIZE,
   DEFAULT_CLAUDE_MODEL,
   ClaudeRunner,
-  CLAUDE_CODE_THINKING_TOKENS,
+  CLAUDE_CODE_EFFORT_LEVELS,
   CLAUDE_CODE_ACP_ADAPTER,
   CHART_MAX_SERIES,
   CHART_MAX_POINTS_PER_SERIES,

package/dist/runtimes/_cli-agent.d.ts

@@ -69,13 +69,15 @@ export declare const ACP_TURN_IDLE_TIMEOUT_MS: number;
  *  implements duplex) falls back to JSONL cleanly via the capability check in
  *  `sendMessage`. */
 export declare const ACP_TRANSPORT_READY = true;
-/** Reasoning-effort level a CLI turn may carry (T2 session effort). The
- *  per-CLI mapping lives in each spec's `buildCommand` — Claude Code takes a
- *  thinking-token budget via `MAX_THINKING_TOKENS`, codex takes
- *  `-c model_reasoning_effort=<level>`. Specs without a real knob
- *  (opencode/droid/cursor) never receive one: the server hides + rejects
- *  effort for those runtimes. */
-export type CliReasoningEffort = "low" | "medium" | "high";
+/** Reasoning-effort level a CLI turn may carry (T2 session effort) — the
+ *  UNION of what the effort-capable CLIs accept. The per-CLI mapping lives in
+ *  each spec's `buildCommand` — Claude Code takes its own `--effort` flag
+ *  (all five levels), codex takes `-c model_reasoning_effort=<level>`
+ *  (low|medium|high|xhigh — no "max"; the spec clamps it). Specs without a
+ *  real knob (opencode/droid/cursor) never receive one: the server hides +
+ *  rejects effort for those runtimes, and rejects levels a runtime lacks
+ *  (sessionEffortLockError). */
+export type CliReasoningEffort = "low" | "medium" | "high" | "xhigh" | "max";
 /** Per-CLI behaviour. The base owns the lifecycle (init/done/error) and the
  *  transport (spawn + JSONL parse); a spec owns the CLI-specific bits. */
 export interface CliAgentSpec {

package/dist/runtimes/claude-code.d.ts

@@ -40,18 +40,20 @@ import { type CliAgentSpec, type CliReasoningEffort } from "./_cli-agent.js";
  *  bridge daemon (cli/src/bridge/acp.ts) imports this same pin so both
  *  executors launch the identical adapter. Verified against 0.16.2. */
 export declare const CLAUDE_CODE_ACP_ADAPTER = "@zed-industries/claude-code-acp@0.16.2";
-/** Extended-thinking token budget per effort level — Claude Code's real knob
- *  is the `MAX_THINKING_TOKENS` env var (its documented settings env), set
- *  per invocation below. Values mirror the platform turn loop's
- *  `EFFORT_BUDGET_TOKENS` (server model-client) so "high" means the same
- *  thing in a channel and in a claude-code session. */
-export declare const CLAUDE_CODE_THINKING_TOKENS: Record<CliReasoningEffort, number>;
+/** Claude Code's real reasoning knob is its own `--effort <level>` flag
+ *  (low|medium|high|xhigh|max — verified against `claude -p --help`). The
+ *  CliReasoningEffort union IS the CLI's vocabulary, so the level rides the
+ *  flag verbatim; the CLI itself downgrades a level the selected model lacks
+ *  (its documented behaviour, e.g. xhigh → high off Opus). The old
+ *  `MAX_THINKING_TOKENS` env mapping is gone: the CLI deprecated it (treated
+ *  as on/off on current models) and it could never express xhigh/max. */
+export declare const CLAUDE_CODE_EFFORT_LEVELS: readonly CliReasoningEffort[];
 export declare const claudeCodeSpec: CliAgentSpec;
 export interface ClaudeCodeRuntimeConfig {
     /** Claude model id (`--model`). Omit to use the CLI's configured default. */
     model?: string;
-    /** Extended-thinking effort (`MAX_THINKING_TOKENS`). Omit for the CLI's
-     *  default behaviour (no forced budget). */
+    /** Reasoning effort (`--effort <level>`; the CLI accepts all five levels).
+     *  Omit for the CLI's default behaviour. */
     effort?: CliReasoningEffort;
 }
 export declare function createClaudeCodeRuntime(config?: ClaudeCodeRuntimeConfig): import("../index.js").AgentRuntime<import("../sandbox.js").SandboxProvider>;

package/dist/runtimes/codex.d.ts

@@ -20,12 +20,15 @@ export declare function isCodexAdvisoryNoise(text: string): boolean;
  *  `mapEvent` is the golden the ACP normaliser is asserted equal to. Not part
  *  of the public runtime surface — `createCodexRuntime` stays the entry point. */
 export declare const codexSpec: CliAgentSpec;
+/** The effort levels codex actually has (`model_reasoning_effort`):
+ *  low|medium|high|xhigh — no "max" (that level is Claude Code's alone). */
+export type CodexReasoningEffort = Exclude<CliReasoningEffort, "max">;
 export interface CodexRuntimeConfig {
     /** Codex model id (`-m`). Omit to use the codex CLI's configured default. */
     model?: string;
     /** Reasoning effort (`-c model_reasoning_effort=<level>`). Omit to use the
      *  codex CLI's configured default. */
-    effort?: CliReasoningEffort;
+    effort?: CodexReasoningEffort;
 }
 export declare function createCodexRuntime(config?: CodexRuntimeConfig): import("../index.js").AgentRuntime<import("../sandbox.js").SandboxProvider>;
 declare const _default: import("../index.js").AgentRuntime<import("../sandbox.js").SandboxProvider>;