crosscheck-mcp 0.2.28 → 0.2.30

package/dist/embed.cjs

@@ -31,16 +31,22 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/entrypoints/embed.ts
 var embed_exports = {};
 __export(embed_exports, {
+  ACTIVITY_TEXT_CAP: () => ACTIVITY_TEXT_CAP,
   DEFAULT_EXCLUDED_PROVIDERS: () => DEFAULT_EXCLUDED_PROVIDERS,
   DEFAULT_FALLBACKS: () => DEFAULT_FALLBACKS,
   DEFAULT_MODELS: () => DEFAULT_MODELS,
+  IMAGE_MEDIA_TYPES: () => IMAGE_MEDIA_TYPES,
+  MAX_RUN_IMAGES: () => MAX_RUN_IMAGES,
+  SUPER_MODELS: () => SUPER_MODELS,
+  VISION_PROVIDERS: () => VISION_PROVIDERS,
   __KEY_ENV: () => KEY_ENV,
   __MODEL_ENV: () => MODEL_ENV,
   __test_internals: () => __test_internals,
   createEmbeddedEngine: () => createEmbeddedEngine,
   isAlive: () => isAlive,
   listProcesses: () => listProcesses,
-  processRegistryPath: () => processRegistryPath
+  processRegistryPath: () => processRegistryPath,
+  withRunImages: () => withRunImages
 });
 module.exports = __toCommonJS(embed_exports);
 
@@ -49,6 +55,7 @@ var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${_
 var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
 
 // src/entrypoints/embed.ts
+var import_node_async_hooks3 = require("async_hooks");
 var import_node_fs16 = require("fs");
 var import_node_path15 = __toESM(require("path"), 1);
 var import_node_url2 = require("url");
@@ -220,6 +227,11 @@ function reasoningSharesOutputBudget(provider) {
 }
 
 // src/providers/types.ts
+var IMAGE_MEDIA_TYPES = ["image/png", "image/jpeg", "image/webp", "image/gif"];
+function imagesOf(m) {
+  if (m.role !== "user" || !Array.isArray(m.images)) return [];
+  return m.images.filter((i) => Boolean(i) && typeof i.data === "string" && i.data.length > 0 && IMAGE_MEDIA_TYPES.includes(i.mediaType));
+}
 var ProviderError = class extends Error {
   name = "ProviderError";
   kind;
@@ -533,6 +545,52 @@ function rejectsDisabledThinking(model) {
   const m = model.toLowerCase();
   return ADAPTIVE_THINKING_PREFIXES.some((p) => m.startsWith(p));
 }
+var NO_FORCED_TOOL_PREFIXES = [
+  "claude-fable-5-1",
+  "claude-mythos-5-1",
+  "claude-opus-5-5",
+  "claude-sonnet-5-5"
+];
+function rejectsForcedToolUse(model) {
+  const m = model.toLowerCase();
+  return NO_FORCED_TOOL_PREFIXES.some((p) => m.startsWith(p));
+}
+var UNSUPPORTED_SCHEMA_KEYS = /* @__PURE__ */ new Set([
+  "minimum",
+  "maximum",
+  "exclusiveMinimum",
+  "exclusiveMaximum",
+  "multipleOf",
+  "minLength",
+  "maxLength",
+  "pattern",
+  "minItems",
+  "maxItems",
+  "uniqueItems",
+  "minProperties",
+  "maxProperties",
+  "$schema"
+]);
+function toStructuredOutputSchema(schema) {
+  const walk = (node) => {
+    if (Array.isArray(node)) return node.map(walk);
+    if (!node || typeof node !== "object") return node;
+    const out = {};
+    for (const [k, v] of Object.entries(node)) {
+      if (UNSUPPORTED_SCHEMA_KEYS.has(k)) continue;
+      if (k === "properties" && v && typeof v === "object") {
+        out[k] = Object.fromEntries(Object.entries(v).map(([pk, pv]) => [pk, walk(pv)]));
+      } else if (["items", "anyOf", "allOf", "oneOf", "not", "$defs", "definitions"].includes(k)) {
+        out[k] = k === "$defs" || k === "definitions" ? Object.fromEntries(Object.entries(v ?? {}).map(([dk, dv]) => [dk, walk(dv)])) : walk(v);
+      } else {
+        out[k] = v;
+      }
+    }
+    if (out["type"] === "object" || "properties" in out) out["additionalProperties"] = false;
+    return out;
+  };
+  return walk(schema);
+}
 var ANTHROPIC_STRUCTURED_TOOL_NAME = "structured_output";
 function applyPromptCaching(body, env = process.env) {
   const flag = (env["CROSSCHECK_ANTHROPIC_PROMPT_CACHE"] ?? "").trim();
@@ -562,7 +620,12 @@ function buildAnthropicRequest(opts) {
       }
       continue;
     }
-    convo.push({ role: m.role, content: typeof m.content === "string" ? m.content : "" });
+    const text = typeof m.content === "string" ? m.content : "";
+    const images = imagesOf(m);
+    convo.push(images.length ? { role: m.role, content: [
+      ...images.map((i) => ({ type: "image", source: { type: "base64", media_type: i.mediaType, data: i.data } })),
+      { type: "text", text }
+    ] } : { role: m.role, content: text });
   }
   const body = {
     model: opts.model,
@@ -584,7 +647,12 @@ function buildAnthropicRequest(opts) {
       body.thinking = { type: "disabled" };
     }
   }
-  if (opts.jsonSchema) {
+  if (opts.jsonSchema && rejectsForcedToolUse(opts.model)) {
+    body.output_config = {
+      ...body.output_config ?? {},
+      format: { type: "json_schema", schema: toStructuredOutputSchema(opts.jsonSchema) }
+    };
+  } else if (opts.jsonSchema) {
     body.tools = [{
       name: ANTHROPIC_STRUCTURED_TOOL_NAME,
       description: "Emit a single JSON object matching the requested schema.",
@@ -797,7 +865,10 @@ function buildGeminiRequest(opts) {
     const role = m.role === "user" ? "user" : "model";
     contents.push({
       role,
-      parts: [{ text: typeof m.content === "string" ? m.content : "" }]
+      parts: [
+        ...imagesOf(m).map((i) => ({ inline_data: { mime_type: i.mediaType, data: i.data } })),
+        { text: typeof m.content === "string" ? m.content : "" }
+      ]
     });
   }
   const body = {
@@ -965,10 +1036,11 @@ function supportsNativeJsonSchema(provider, model) {
   return true;
 }
 function buildOpenAICompatibleRequest(opts) {
-  const msgs = opts.messages.map((m) => ({
-    role: m.role,
-    content: typeof m.content === "string" ? m.content : ""
-  }));
+  const msgs = opts.messages.map((m) => {
+    const text = typeof m.content === "string" ? m.content : "";
+    const images = imagesOf(m);
+    return images.length ? { role: m.role, content: [{ type: "text", text }, ...images.map((i) => ({ type: "image_url", image_url: { url: `data:${i.mediaType};base64,${i.data}` } }))] } : { role: m.role, content: text };
+  });
   const body = {
     model: opts.model,
     messages: msgs
@@ -985,7 +1057,15 @@ function buildOpenAICompatibleRequest(opts) {
       json_schema: {
         name: "structured_output",
         schema: opts.jsonSchema,
-        strict: true
+        // NOT strict. Strict mode requires `additionalProperties: false` on
+        // every object and every property listed in `required` — the
+        // engine's schemas don't meet that, so every structured OpenAI call
+        // (planner, judges, synthesis) was a 400, unnoticed until the canary
+        // grew a structured check (2026-10-11). Non-strict still shapes the
+        // reply to the schema, and structured.ts validates it against the
+        // full schema regardless, so strictness added a failure mode and no
+        // safety.
+        strict: false
       }
     };
   }
@@ -1273,7 +1353,7 @@ var import_zod = require("zod");
 
 // src/server-meta.ts
 var SERVER_NAME = "crosscheck-agent";
-var SERVER_VERSION = true ? "0.2.28" : "0.0.0-dev";
+var SERVER_VERSION = true ? "0.2.30" : "0.0.0-dev";
 
 // src/tools/audit.ts
 var import_node_fs4 = require("fs");
@@ -4237,6 +4317,7 @@ async function pickAutoPanel(storage, purpose, n, providers, allowlist) {
 }
 
 // src/core/super-mode.ts
+var import_node_async_hooks = require("async_hooks");
 var SUPER_MODELS = {
   // Fable 5.1 verified present on the account; 5 as the fallback for accounts
   // that haven't been granted 5.1 yet.
@@ -4279,7 +4360,12 @@ function parseChain(v) {
   }
   return out;
 }
-function superChainFor(provider, env = process.env) {
+var superEnvStore = new import_node_async_hooks.AsyncLocalStorage();
+function withSuperEnv(env, fn) {
+  return superEnvStore.run(env, fn);
+}
+var currentEnv = () => superEnvStore.getStore() ?? process.env;
+function superChainFor(provider, env = currentEnv()) {
   const varName = SUPER_ENV_VARS[provider];
   const user = varName ? parseChain(env[varName]) : [];
   if (user.length > 0) {
@@ -4288,14 +4374,14 @@ function superChainFor(provider, env = process.env) {
   }
   return SUPER_MODELS[provider] ?? [];
 }
-function superPrimary(provider, env = process.env) {
+function superPrimary(provider, env = currentEnv()) {
   return superChainFor(provider, env)[0];
 }
 var SUPER_PROVIDER_NAMES = Object.keys(SUPER_MODELS);
 function isSuperRequested(args) {
   return args["super"] === true;
 }
-function retargetForSuper(p, env = process.env) {
+function retargetForSuper(p, env = currentEnv()) {
   const chain = superChainFor(p.name, env);
   if (chain.length === 0) return p;
   const [primary, ...fallbacks] = chain;
@@ -6366,9 +6452,22 @@ var import_node_path9 = __toESM(require("path"), 1);
 var import_node_perf_hooks6 = require("perf_hooks");
 
 // src/core/progress.ts
-var import_node_async_hooks = require("async_hooks");
+var import_node_async_hooks2 = require("async_hooks");
 var import_node_perf_hooks5 = require("perf_hooks");
-var progressStorage = new import_node_async_hooks.AsyncLocalStorage();
+var progressStorage = new import_node_async_hooks2.AsyncLocalStorage();
+async function withProgress(token, sendNotification, fn) {
+  if (token === void 0 || token === null) {
+    return fn();
+  }
+  const ctx = {
+    token,
+    wallStart: import_node_perf_hooks5.performance.now(),
+    cpuStart: process.cpuUsage(),
+    step: { value: 0 },
+    sendNotification
+  };
+  return progressStorage.run(ctx, fn);
+}
 async function emitProgress(message, opts) {
   const ctx = progressStorage.getStore();
   const wallStart = ctx ? ctx.wallStart : import_node_perf_hooks5.performance.now();
@@ -7888,6 +7987,16 @@ function buildCallContext(args) {
 var CREATE_DOC_MAX_BYTES = 32 * 1024;
 var CREATE_AUDIT_THRESHOLD = 0.7;
 async function runCreate(args, opts) {
+  const subEnvelopes = [];
+  const tracked = (fn) => async (...a) => {
+    const out = await fn(...a);
+    subEnvelopes.push(out);
+    return out;
+  };
+  const confer = tracked(runConfer);
+  const orchestrate = tracked(runOrchestrate);
+  const review = tracked(runReview);
+  const audit = tracked(runAudit);
   const instruction = typeof args["instruction"] === "string" ? args["instruction"] : String(args["instruction"] ?? "");
   if (!instruction) {
     return errorEnvelope6(
@@ -7924,7 +8033,7 @@ ${constraints}
 
 ` : "") + `DOCUMENTS (${okCount} of ${descriptors.length} ingested):
 ${documentsPayload}`;
-  const scope = await runConfer({
+  const scope = await confer({
     question: "We are about to orchestrate a full plan->build->review->audit lifecycle for this instruction. List 3-6 concrete sub-tasks (each with a one-line description and a difficulty: low|med|high), any critical assumptions, and any missing-information risks. Be concise and decisive \u2014 your output will be used to build the orchestration DAG.\n\nINSTRUCTION:\n" + instruction,
     context: contextBlock,
     ...providers !== void 0 ? { providers } : {},
@@ -7951,7 +8060,7 @@ ${scopeAnswer || "(none)"}
   };
   if (providers !== void 0) orchestrateArgs["providers"] = providers;
   if (planOnly) orchestrateArgs["plan_only"] = true;
-  let orchestration = await runOrchestrate(orchestrateArgs, {
+  let orchestration = await orchestrate(orchestrateArgs, {
     providers: opts.providers,
     allowlist: opts.allowlist ?? null,
     moderator,
@@ -7980,7 +8089,7 @@ ${scopeAnswer || "(none)"}
   }
   let reviewEnvelope = null;
   if (!skipReview && typeof orchestration["final"] === "string" && orchestration["final"]) {
-    reviewEnvelope = await runReview({
+    reviewEnvelope = await review({
       snippet: orchestration["final"],
       intent: `final deliverable for: ${instruction}`,
       ...providers !== void 0 ? { providers } : {},
@@ -8000,7 +8109,7 @@ ${scopeAnswer || "(none)"}
     const panelExhausted = producingPanel.length > 0 && producingPanel.every(
       (p) => p in opts.providers || Object.keys(opts.providers).includes(p.toLowerCase())
     ) && producingPanel.length >= Object.keys(opts.providers).length;
-    auditEnvelope = await runAudit({
+    auditEnvelope = await audit({
       output_to_audit: orchestration["final"],
       producing_panelists: producingPanel,
       ...auditRubric !== void 0 ? { rubric: auditRubric } : {},
@@ -8029,7 +8138,7 @@ ${retryConstraints}
 DOCUMENTS:
 ${documentsPayload}`
       };
-      const retryOrchestration = await runOrchestrate(
+      const retryOrchestration = await orchestrate(
         retryOrchestrateArgs,
         {
           providers: opts.providers,
@@ -8043,7 +8152,7 @@ ${documentsPayload}`
       if (typeof retryOrchestration["final"] === "string" && retryOrchestration["final"]) {
         const retryPanel = computeProducingPanel(retryOrchestration);
         const retryPanelExhausted = retryPanel.length > 0 && retryPanel.length >= Object.keys(opts.providers).length;
-        auditEnvelope = await runAudit({
+        auditEnvelope = await audit({
           output_to_audit: retryOrchestration["final"],
           producing_panelists: retryPanel,
           ...auditRubric !== void 0 ? { rubric: auditRubric } : {},
@@ -8118,9 +8227,28 @@ ${documentsPayload}`
       ["auditor", "items", "overall_score", "passed", "rubric"]
     ),
     artifacts,
-    warnings
+    warnings,
+    ...combinedUsage(subEnvelopes)
   };
 }
+function combinedUsage(envelopes) {
+  const usages = [];
+  const byCallTiming = [];
+  let wall = 0, cpu = 0;
+  for (const env of envelopes) {
+    const e = env ?? {};
+    const calls = e["usage"]?.["by_call"] ?? [];
+    const t = e["timing"] ?? {};
+    const timing = Array.isArray(t["by_call"]) ? t["by_call"] : [];
+    if (!Array.isArray(calls) || calls.length === 0) continue;
+    usages.push(...calls);
+    if (timing.length === calls.length) byCallTiming.push(...timing);
+    else for (const c of calls) byCallTiming.push({ provider: c.provider, model: c.model, purpose: c.purpose ?? null, wall_ms: 0, cpu_ms: 0, cache_hit: false });
+    wall += Number(t["wall_ms"] ?? 0) || 0;
+    cpu += Number(t["cpu_ms"] ?? 0) || 0;
+  }
+  return { usage: aggregateUsage(usages), timing: { wall_ms: wall, cpu_ms: cpu, by_call: byCallTiming } };
+}
 async function ingestDocuments(documents, sessionId, opts) {
   if (documents.length === 0) return [];
   const out = [];
@@ -11597,7 +11725,7 @@ var CHECK_INTERVAL_SECONDS = 3 * 24 * 60 * 60;
 var DEFAULT_PACKAGE = "crosscheck-cli";
 var FETCH_TIMEOUT_MS = 3e3;
 function engineVersion() {
-  return true ? "0.2.28" : "0.0.0-dev";
+  return true ? "0.2.30" : "0.0.0-dev";
 }
 function defaultUpdateCachePath() {
   const base = process.env["CROSSCHECK_DATA_DIR"] || import_node_path12.default.join(import_node_os2.default.homedir() || import_node_os2.default.tmpdir(), ".crosscheck");
@@ -13388,6 +13516,133 @@ var ENGINE_TO_VAULT = { xai: "grok" };
 function vaultId(engineName) {
   return ENGINE_TO_VAULT[engineName] ?? engineName;
 }
+var ACTIVITY_TEXT_CAP = 8e3;
+var ASKED_CAP = 280;
+var VISION_PROVIDERS = ["anthropic", "openai", "gemini", "grok"];
+var NO_IMAGE_PURPOSES = /* @__PURE__ */ new Set(["early_stop", "extract", "canary", "classify"]);
+var MAX_RUN_IMAGES = 8;
+function withRunImages(args, provider, images) {
+  if (!images?.length || NO_IMAGE_PURPOSES.has(args.purpose ?? "")) return args;
+  const msgs = [...args.messages];
+  let idx = -1;
+  for (let i = msgs.length - 1; i >= 0; i--) if (msgs[i]?.role === "user") {
+    idx = i;
+    break;
+  }
+  if (idx < 0) return args;
+  const m = msgs[idx];
+  if (VISION_PROVIDERS.includes(provider)) {
+    msgs[idx] = { ...m, images: [...m.images ?? [], ...images] };
+  } else {
+    const n = images.length;
+    msgs[idx] = {
+      ...m,
+      content: `${m.content}
+
+[The user also attached ${n} image${n === 1 ? "" : "s"} that this model can't see. Don't guess at ${n === 1 ? "its" : "their"} contents \u2014 work from the text, and say so if the answer depends on ${n === 1 ? "it" : "them"}.]`
+    };
+  }
+  return { ...args, messages: msgs };
+}
+var runContext = new import_node_async_hooks3.AsyncLocalStorage();
+var SYNTHESIS_PURPOSES = /* @__PURE__ */ new Set(["synth", "moderator", "recombine", "judge", "unify"]);
+function exemptFromSkip(ctx, provider, purpose) {
+  return provider === ctx.moderator && SYNTHESIS_PURPOSES.has(purpose);
+}
+function skippedError(provider, why, limitMs) {
+  return new ProviderError(
+    "client",
+    why === "timeout" ? `${provider}: stopped after ${Math.round((limitMs ?? 0) / 1e3)}s (your per-model time limit)` : `${provider}: stopped waiting (you skipped it)`,
+    { transient: false }
+  );
+}
+function lastUserText(args) {
+  const msgs = args.messages;
+  for (let i = msgs.length - 1; i >= 0; i--) {
+    const m = msgs[i];
+    if (m && m.role === "user" && typeof m.content === "string") {
+      const t = m.content.replace(/\s+/g, " ").trim();
+      return t.length > ASKED_CAP ? `${t.slice(0, ASKED_CAP - 1)}\u2026` : t;
+    }
+  }
+  return "";
+}
+function withActivity(p) {
+  const send = p.send.bind(p);
+  return {
+    name: p.name,
+    model: p.model,
+    ...p.fallbackModels ? { fallbackModels: p.fallbackModels } : {},
+    send: async (args) => {
+      const ctx = runContext.getStore();
+      if (!ctx) return send(args);
+      const callId = ctx.nextCallId();
+      const provider = vaultId(p.name);
+      const model = args.modelOverride ?? p.model;
+      const purpose = args.purpose ?? "worker";
+      const started = Date.now();
+      const exempt = exemptFromSkip(ctx, provider, purpose);
+      if (!exempt && ctx.skipped.has(provider)) throw skippedError(provider, "user");
+      ctx.emit({ type: "call.start", runId: ctx.runId, at: started, callId, provider, model, purpose, asked: lastUserText(args) });
+      const controller = new AbortController();
+      if (args.signal) {
+        if (args.signal.aborted) controller.abort(args.signal.reason);
+        else args.signal.addEventListener("abort", () => controller.abort(args.signal.reason), { once: true });
+      }
+      let stopped;
+      if (!exempt) ctx.inflight.set(callId, { provider, purpose, controller });
+      const timer = !exempt && ctx.callTimeoutMs && ctx.callTimeoutMs > 0 ? setTimeout(() => {
+        stopped = "timeout";
+        controller.abort("timeout");
+      }, ctx.callTimeoutMs) : void 0;
+      controller.signal.addEventListener("abort", () => {
+        if (!stopped && controller.signal.reason === "skip") stopped = "user";
+      }, { once: true });
+      try {
+        const res = await send({ ...withRunImages(args, provider, ctx.images), signal: controller.signal });
+        const text = typeof res.text === "string" ? res.text : "";
+        ctx.emit({
+          type: "call.done",
+          runId: ctx.runId,
+          at: Date.now(),
+          callId,
+          provider,
+          model,
+          purpose,
+          ok: true,
+          ms: Date.now() - started,
+          text: text.slice(0, ACTIVITY_TEXT_CAP),
+          truncated: text.length > ACTIVITY_TEXT_CAP,
+          error: null,
+          usage: usageOf(res)
+        });
+        return res;
+      } catch (err) {
+        const out = stopped ? skippedError(provider, stopped, ctx.callTimeoutMs) : err;
+        ctx.emit({
+          type: "call.done",
+          runId: ctx.runId,
+          at: Date.now(),
+          callId,
+          provider,
+          model,
+          purpose,
+          ok: false,
+          ms: Date.now() - started,
+          text: "",
+          truncated: false,
+          error: out instanceof Error ? out.message : String(out),
+          usage: null,
+          ...stopped ? { stopped } : {}
+        });
+        throw out;
+      } finally {
+        if (timer) clearTimeout(timer);
+        ctx.inflight.delete(callId);
+      }
+    }
+  };
+}
 function usageOf(answer) {
   const u = answer["usage"];
   if (!u || typeof u !== "object") return null;
@@ -13423,6 +13678,8 @@ function bundledPricingPath() {
   }
 }
 var runCounter = 0;
+var callCounter = 0;
+var nextCallId = () => ++callCounter;
 function nextRunId() {
   runCounter += 1;
   return `run_${Date.now().toString(36)}_${runCounter}`;
@@ -13437,11 +13694,19 @@ function createEmbeddedEngine(opts) {
     const varName = MODEL_ENV[provider.trim().toLowerCase()];
     if (varName && model) env[varName] = model;
   }
+  const superEnv = {};
+  for (const [provider, model] of Object.entries(opts.superModels ?? {})) {
+    const p = provider.trim().toLowerCase();
+    const varName = SUPER_ENV_VARS[p === "grok" ? "xai" : p];
+    if (varName && model) superEnv[varName] = model;
+  }
   const pricingPath = [opts.pricingPath, bundledPricingPath()].find(
     (p) => Boolean(p) && (0, import_node_fs16.existsSync)(p)
   );
   const pricing = pricingPath ? loadPricing(pricingPath) : {};
-  const built = buildProviders({ env, pricing });
+  const built = Object.fromEntries(
+    Object.entries(buildProviders({ env, pricing })).map(([name, p]) => [name, withActivity(p)])
+  );
   const moderator = opts.moderator ?? "anthropic";
   const tools = registerCoreTools({ providers: built, pricing });
   const providerIds = Object.keys(built).map(vaultId).sort();
@@ -13458,7 +13723,8 @@ function createEmbeddedEngine(opts) {
     if (!tool) return Promise.reject(new Error(`unknown tool: ${name}`));
     return Promise.resolve(tool.handler(args));
   };
-  const run = async (name, args, onEvent) => {
+  const liveRuns = /* @__PURE__ */ new Map();
+  const run = async (name, args, onEvent, runOpts = {}) => {
     const runId = nextRunId();
     const started = Date.now();
     const emit = (e) => {
@@ -13467,6 +13733,79 @@ function createEmbeddedEngine(opts) {
       } catch {
       }
     };
+    const ctx = {
+      runId,
+      emit,
+      nextCallId,
+      skipped: /* @__PURE__ */ new Set(),
+      inflight: /* @__PURE__ */ new Map(),
+      moderator: vaultId(moderator),
+      ...runOpts.callTimeoutMs && runOpts.callTimeoutMs > 0 ? { callTimeoutMs: runOpts.callTimeoutMs } : {},
+      ...runOpts.images?.length ? { images: runOpts.images.filter((i) => IMAGE_MEDIA_TYPES.includes(i.mediaType) && typeof i.data === "string" && i.data.length > 0).slice(0, MAX_RUN_IMAGES) } : {}
+    };
+    liveRuns.set(runId, ctx);
+    try {
+      return await runContext.run(ctx, () => withProgress(runId, (n) => {
+        if (n.params.message) emit({ type: "progress", runId, at: Date.now(), message: n.params.message });
+      }, () => withSuperEnv(superEnv, () => runInner(name, args, runId, started, emit))));
+    } finally {
+      liveRuns.delete(runId);
+    }
+  };
+  const skip = (runId, provider) => {
+    const ctx = liveRuns.get(runId);
+    if (!ctx) return 0;
+    ctx.skipped.add(provider);
+    let stopped = 0;
+    for (const call2 of ctx.inflight.values()) {
+      if (call2.provider === provider && !exemptFromSkip(ctx, call2.provider, call2.purpose)) {
+        call2.controller.abort("skip");
+        stopped += 1;
+      }
+    }
+    return stopped;
+  };
+  const ask = async (o) => {
+    const engineName = Object.keys(built).find((n) => vaultId(n) === o.provider);
+    const base = engineName ? built[engineName] : void 0;
+    if (!base) {
+      return { ok: false, text: "", json: null, model: o.model ?? "", error: `No ${o.provider} key is configured, so it can't be asked.` };
+    }
+    const provider = o.model && o.model !== base.model ? retargetProvider(base, o.model) : base;
+    const maxTokens = o.maxTokens ?? 8e3;
+    const doAsk = async () => {
+      if (o.schema) {
+        const res = await requestStructured(provider, o.messages, o.schema, { maxTokens, purpose: o.purpose, maxRetries: 1 });
+        return {
+          ok: res.obj !== null,
+          text: res.answer.response ?? "",
+          json: res.obj,
+          error: res.obj !== null ? null : res.answer.error ?? res.errors.join("; ") ?? "invalid reply",
+          model: provider.model
+        };
+      }
+      const a = await askOne(provider, o.messages, { maxTokens, temperature: 0.3, purpose: o.purpose });
+      return { ok: !a.error, text: a.response ?? "", json: null, error: a.error ?? null, model: provider.model };
+    };
+    if (!o.runId || !o.onEvent) return doAsk();
+    const sink = o.onEvent;
+    const emit = (e) => {
+      try {
+        sink(e);
+      } catch {
+      }
+    };
+    const ctx = {
+      runId: o.runId,
+      emit,
+      nextCallId,
+      skipped: /* @__PURE__ */ new Set(),
+      inflight: /* @__PURE__ */ new Map(),
+      moderator: o.provider
+    };
+    return runContext.run(ctx, doAsk);
+  };
+  const runInner = async (name, args, runId, started, emit) => {
     emit({
       type: "run.start",
       runId,
@@ -13544,8 +13883,16 @@ function createEmbeddedEngine(opts) {
     providers: providerIds,
     models,
     listTools: () => [...tools.keys()],
+    requiredArgs: (name) => {
+      const tool = tools.get(name);
+      if (!tool) return null;
+      const req = tool.inputSchema?.required;
+      return Array.isArray(req) ? req.filter((x) => typeof x === "string") : [];
+    },
     call,
     run,
+    skip,
+    ask,
     close: async () => {
       await flush().catch(() => {
       });
@@ -13555,15 +13902,21 @@ function createEmbeddedEngine(opts) {
 var __test_internals = { usageOf, textOf, errorOf, vaultId };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ACTIVITY_TEXT_CAP,
   DEFAULT_EXCLUDED_PROVIDERS,
   DEFAULT_FALLBACKS,
   DEFAULT_MODELS,
+  IMAGE_MEDIA_TYPES,
+  MAX_RUN_IMAGES,
+  SUPER_MODELS,
+  VISION_PROVIDERS,
   __KEY_ENV,
   __MODEL_ENV,
   __test_internals,
   createEmbeddedEngine,
   isAlive,
   listProcesses,
-  processRegistryPath
+  processRegistryPath,
+  withRunImages
 });
 //# sourceMappingURL=embed.cjs.map