@wrongstack/runtime 0.277.2 → 0.280.1

package/dist/index.js

@@ -1,124 +1,185 @@
+import { buildChildEnv, Container, DefaultConfigStore, TOKENS, DefaultSecretScrubber, DefaultRetryPolicy, DefaultErrorHandler, buildRecoveryStrategies, DefaultTokenCounter, DefaultModeStore, DefaultSessionStore, DefaultMemoryStore, DefaultSkillLoader, DefaultPromptLoader, DefaultSystemPromptBuilder, DefaultPermissionPolicy, createStrategyCompactor, EventBus, resolveModelMatrix, resolveModelTargetFromEntry, ToolRegistry, Context, createDefaultPipelines, applyModelRuntime, mergeModelRuntime, WIDE_SUBAGENT_CAPABILITIES, AutoApprovePermissionPolicy, ToolExecutor, Agent, createFallbackModelExtension, assertNotPrivateHost } from '@wrongstack/core';
+export { DefaultSystemPromptBuilder } from '@wrongstack/core';
 export * from '@wrongstack/core/defaults';
 export { DefaultPathResolver, DefaultTokenCounter } from '@wrongstack/core/infrastructure';
-import { Container, DefaultConfigStore, TOKENS, DefaultSecretScrubber, DefaultRetryPolicy, DefaultErrorHandler, buildRecoveryStrategies, DefaultTokenCounter, DefaultModeStore, DefaultSessionStore, DefaultMemoryStore, DefaultSkillLoader, DefaultPromptLoader, DefaultSystemPromptBuilder, DefaultPermissionPolicy, createStrategyCompactor, assertNotPrivateHost, buildChildEnv, EventBus, resolveModelMatrix, resolveModelTargetFromEntry, ToolRegistry, Context, WIDE_SUBAGENT_CAPABILITIES, AutoApprovePermissionPolicy, ToolExecutor, Agent, createDefaultPipelines, createFallbackModelExtension } from '@wrongstack/core';
-export { DefaultSystemPromptBuilder } from '@wrongstack/core';
-import * as fs2 from 'fs/promises';
-import * as os2 from 'os';
-import * as path from 'path';
 import { spawn } from 'child_process';
 import { randomUUID } from 'crypto';
+import * as fs from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
 
 // src/index.ts
-
-// src/host.ts
-function createRuntimeHostFromParts(parts) {
-  return {
-    agent: parts.agent,
-    context: parts.context,
-    events: parts.events,
-    tools: parts.tools,
-    providers: parts.providers,
-    slashCommands: parts.slashCommands,
-    session: parts.session,
-    extensions: parts.extensions,
-    async shutdown() {
-      await parts.shutdown?.();
-    }
-  };
+var MAX_IMAGE_BYTES = 10 * 1024 * 1024;
+async function readClipboardImage() {
+  const platform = process.platform;
+  if (platform === "win32") return readWindows();
+  if (platform === "darwin") return readDarwin();
+  if (platform === "linux") return readLinux();
+  return null;
 }
-async function applyWrongStackPack(host, pack, opts = {}) {
-  const owner = opts.owner ?? pack.name;
-  const unregisterExtensions = [];
-  const registeredToolNames = [];
-  const registeredCommandNames = [];
-  const registeredProviderTypes = [];
-  if (pack.tools) {
-    const tools = [...pack.tools];
-    host.tools.registerAllOrThrow(tools, owner);
-    for (const t of tools) registeredToolNames.push(t.name);
-  }
-  if (pack.providers) {
-    const providers = [...pack.providers];
-    host.providers.registerAll(providers);
-    for (const p of providers) registeredProviderTypes.push(p.type);
+async function readClipboardText() {
+  const platform = process.platform;
+  if (platform === "win32") {
+    const ps = "[Console]::OutputEncoding = [System.Text.Encoding]::UTF8; Get-Clipboard -Raw";
+    const out = await runCmd("powershell", ["-NoProfile", "-Command", ps]);
+    if (out == null) return null;
+    const text = out.replace(/\r?\n$/, "");
+    return text.length > 0 ? text : null;
   }
-  if (pack.slashCommands) {
-    const cmds = [...pack.slashCommands];
-    host.slashCommands.registerAll(cmds, owner);
-    for (const c of cmds) registeredCommandNames.push(c.name);
+  if (platform === "darwin") {
+    const out = await runCmd("pbpaste", []);
+    return out && out.length > 0 ? out : null;
   }
-  if (pack.extensions && host.extensions) {
-    for (const ext of pack.extensions) {
-      unregisterExtensions.push(host.extensions.register(ext));
+  if (platform === "linux") {
+    const tries = [
+      ["wl-paste", ["--no-newline"]],
+      ["xclip", ["-selection", "clipboard", "-o"]]
+    ];
+    for (const [cmd, args] of tries) {
+      const out = await runCmd(cmd, args);
+      if (out && out.length > 0) return out;
     }
+    return null;
   }
-  if (pack.setup) {
-    if (!opts.api) {
-      throw new Error(`Pack "${pack.name}" defines setup() but no PluginAPI was provided`);
-    }
-    try {
-      await pack.setup(opts.api);
-    } catch (setupErr) {
-      for (const unregister of unregisterExtensions.reverse()) {
-        unregister();
-      }
-      for (const name of registeredCommandNames.reverse()) {
-        host.slashCommands.unregister(name);
-      }
-      for (const name of registeredToolNames.reverse()) {
-        host.tools.unregister(name);
-      }
-      for (const type of registeredProviderTypes.reverse()) {
-        host.providers.unregister(type);
-      }
-      throw setupErr;
-    }
+  return null;
+}
+async function readWindows() {
+  const tmp = path.join(os.tmpdir(), `wstack-clip-${randomUUID()}.png`);
+  const ps = [
+    "Add-Type -AssemblyName System.Windows.Forms",
+    "Add-Type -AssemblyName System.Drawing",
+    "$img = [System.Windows.Forms.Clipboard]::GetImage()",
+    'if ($img -eq $null) { Write-Output "NO_IMAGE"; exit 0 }',
+    `$img.Save('${tmp.replace(/\\/g, "\\\\")}', [System.Drawing.Imaging.ImageFormat]::Png)`,
+    'Write-Output "OK"'
+  ].join("; ");
+  const out = await runCmd("powershell", ["-NoProfile", "-Command", ps]);
+  if (!out || out.trim() === "NO_IMAGE") return null;
+  if (!out.includes("OK")) return null;
+  return readPngFile(tmp);
+}
+async function readDarwin() {
+  const tmp = path.join(os.tmpdir(), `wstack-clip-${randomUUID()}.png`);
+  const script = [
+    "try",
+    `  set the_file to (open for access POSIX file "${tmp}" with write permission)`,
+    "  write (the clipboard as \xABclass PNGf\xBB) to the_file",
+    "  close access the_file",
+    "on error",
+    "  try",
+    '    close access POSIX file "' + tmp + '"',
+    "  end try",
+    '  return "NO_IMAGE"',
+    "end try",
+    'return "OK"'
+  ].join("\n");
+  const out = await runCmd("osascript", ["-e", script]);
+  if (out?.trim() !== "OK") return null;
+  return readPngFile(tmp);
+}
+async function readLinux() {
+  const tmp = path.join(os.tmpdir(), `wstack-clip-${randomUUID()}.png`);
+  const tries = [
+    ["wl-paste", ["--type", "image/png"]],
+    ["xclip", ["-selection", "clipboard", "-t", "image/png", "-o"]]
+  ];
+  for (const [cmd, args] of tries) {
+    const ok = await runCmdToFile(cmd, args, tmp).catch(() => false);
+    if (ok) return readPngFile(tmp);
   }
-  return {
-    pack,
-    owner,
-    async teardown() {
-      for (const unregister of unregisterExtensions.reverse()) {
-        unregister();
-      }
-      for (const name of registeredCommandNames.reverse()) {
-        host.slashCommands.unregister(name);
-      }
-      for (const name of registeredToolNames.reverse()) {
-        host.tools.unregister(name);
-      }
-      for (const type of registeredProviderTypes.reverse()) {
-        host.providers.unregister(type);
-      }
-      if (pack.teardown) {
-        if (!opts.api) {
-          throw new Error(`Pack "${pack.name}" defines teardown() but no PluginAPI was provided`);
-        }
-        await pack.teardown(opts.api);
-      }
-    }
-  };
+  return null;
 }
-async function applyWrongStackPacks(host, packs, opts = {}) {
-  const applied = [];
+async function readPngFile(p) {
   try {
-    for (const pack of packs) {
-      applied.push(await applyWrongStackPack(host, pack, opts));
+    const buf = await fs.readFile(p);
+    if (buf.length === 0) {
+      await fs.unlink(p).catch(() => void 0);
+      return null;
     }
-    return applied;
-  } catch (err) {
-    for (const mounted of applied.reverse()) {
-      await mounted.teardown().catch((teardownErr) => {
-        const detail = teardownErr instanceof Error ? teardownErr.message : String(teardownErr);
-        process.emitWarning(
-          `Pack teardown during error rollback failed: ${detail}`,
-          "PackRollbackWarning"
-        );
-      });
+    if (buf.length > MAX_IMAGE_BYTES) {
+      await fs.unlink(p).catch(() => void 0);
+      throw new Error(`Clipboard image exceeds ${MAX_IMAGE_BYTES / 1024 / 1024}MB limit`);
+    }
+    if (buf[0] !== 137 || buf[1] !== 80 || buf[2] !== 78 || buf[3] !== 71) {
+      await fs.unlink(p).catch(() => void 0);
+      return null;
     }
+    await fs.unlink(p).catch(() => void 0);
+    return { base64: buf.toString("base64"), mediaType: "image/png", bytes: buf.length };
+  } catch (err) {
+    if (err.code === "ENOENT") return null;
     throw err;
   }
 }
+var CLIPBOARD_CMD_TIMEOUT_MS = 5e3;
+function runCmd(cmd, args) {
+  return new Promise((resolve) => {
+    const child = spawn(cmd, args, {
+      env: buildChildEnv(),
+      stdio: ["ignore", "pipe", "pipe"],
+      windowsHide: true
+    });
+    let out = "";
+    let settled = false;
+    let killedByTimeout = false;
+    const finish = (value) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      clearTimeout(killCap);
+      resolve(value);
+    };
+    const timer = setTimeout(() => {
+      killedByTimeout = true;
+      child.kill("SIGTERM");
+    }, CLIPBOARD_CMD_TIMEOUT_MS);
+    const killCap = setTimeout(() => finish(null), CLIPBOARD_CMD_TIMEOUT_MS + 2e3);
+    child.stdout.on("data", (c) => {
+      out += String(c);
+    });
+    child.on("error", () => finish(null));
+    child.on("exit", (code) => {
+      if (killedByTimeout) return finish(null);
+      finish(code === 0 ? out : null);
+    });
+  });
+}
+function runCmdToFile(cmd, args, outPath) {
+  return new Promise((resolve) => {
+    const child = spawn(cmd, args, {
+      env: buildChildEnv(),
+      stdio: ["ignore", "pipe", "pipe"],
+      windowsHide: true
+    });
+    const chunks = [];
+    let settled = false;
+    let killedByTimeout = false;
+    const finish = (value) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      clearTimeout(killCap);
+      resolve(value);
+    };
+    const timer = setTimeout(() => {
+      killedByTimeout = true;
+      child.kill("SIGTERM");
+    }, CLIPBOARD_CMD_TIMEOUT_MS);
+    const killCap = setTimeout(() => finish(false), CLIPBOARD_CMD_TIMEOUT_MS + 2e3);
+    child.stdout.on("data", (c) => chunks.push(c));
+    child.on("error", () => finish(false));
+    child.on("exit", async (code) => {
+      if (killedByTimeout) return finish(false);
+      if (code !== 0 || chunks.length === 0) return finish(false);
+      try {
+        await fs.writeFile(outPath, Buffer.concat(chunks));
+        finish(true);
+      } catch {
+        finish(false);
+      }
+    });
+  });
+}
 function createDefaultContainer(opts) {
   const { config, wpaths, logger, modelsRegistry } = opts;
   const container = new Container();
@@ -140,7 +201,11 @@ function createDefaultContainer(opts) {
   container.bind(TOKENS.ModelsRegistry, () => modelsRegistry);
   container.bind(
     TOKENS.TokenCounter,
-    () => new DefaultTokenCounter({ registry: modelsRegistry, providerId: config.provider, events: opts.events })
+    () => new DefaultTokenCounter({
+      registry: modelsRegistry,
+      providerId: config.provider,
+      events: opts.events
+    })
   );
   const modeStore = new DefaultModeStore({ directory: wpaths.configDir });
   container.bind(TOKENS.ModeStore, () => modeStore);
@@ -155,9 +220,18 @@ function createDefaultContainer(opts) {
   );
   const memoryStore = new DefaultMemoryStore({ paths: wpaths, events: opts.events });
   container.bind(TOKENS.MemoryStore, () => memoryStore);
-  const skillLoader = new DefaultSkillLoader({ paths: wpaths, bundledDir: opts.bundledSkillsDir });
+  const skillLoader = new DefaultSkillLoader({
+    paths: wpaths,
+    bundledDir: opts.bundledSkillsDir,
+    readClaudeSkills: config.skills?.readClaudeSkills,
+    foreignSources: config.skills?.foreignSources,
+    extraDirs: config.skills?.extraDirs
+  });
   container.bind(TOKENS.SkillLoader, () => skillLoader);
-  const promptLoader = new DefaultPromptLoader({ paths: wpaths, bundledDir: opts.bundledPromptsDir });
+  const promptLoader = new DefaultPromptLoader({
+    paths: wpaths,
+    bundledDir: opts.bundledPromptsDir
+  });
   container.bind(TOKENS.PromptLoader, () => promptLoader);
   if (opts.systemPrompt) {
     container.bind(
@@ -167,25 +241,24 @@ function createDefaultContainer(opts) {
           globalDir: wpaths.globalInstructions,
           projectDir: wpaths.inProjectInstructions
         },
+        skillMode: config.skills?.mode,
+        skillEagerMaxChars: config.skills?.eagerMaxChars,
         ...opts.systemPrompt
       })
     );
   }
-  container.bind(
-    TOKENS.PermissionPolicy,
-    () => {
-      const policyOptions = {
-        trustFile: wpaths.projectTrust,
-        yolo: opts.permission?.yolo ?? false,
-        yoloDestructive: opts.permission?.yoloDestructive ?? opts.permission?.forceAllYolo ?? false,
-        confirmDestructive: opts.permission?.confirmDestructive ?? false
-      };
-      if (opts.permission?.promptDelegate !== void 0) {
-        policyOptions.promptDelegate = opts.permission.promptDelegate;
-      }
-      return new DefaultPermissionPolicy(policyOptions);
+  container.bind(TOKENS.PermissionPolicy, () => {
+    const policyOptions = {
+      trustFile: wpaths.projectTrust,
+      yolo: opts.permission?.yolo ?? false,
+      yoloDestructive: opts.permission?.yoloDestructive ?? opts.permission?.forceAllYolo ?? false,
+      confirmDestructive: opts.permission?.confirmDestructive ?? false
+    };
+    if (opts.permission?.promptDelegate !== void 0) {
+      policyOptions.promptDelegate = opts.permission.promptDelegate;
     }
-  );
+    return new DefaultPermissionPolicy(policyOptions);
+  });
   container.bind(
     TOKENS.Compactor,
     () => (
@@ -209,196 +282,594 @@ function createDefaultContainer(opts) {
   );
   return container;
 }
-var ImageInputUnsupportedError = class extends Error {
-  constructor(opts) {
-    const target = [opts.providerId, opts.model].filter(Boolean).join("/") || "current model";
-    super(
-      `${target} does not support image input, and no image-understanding adapter is available for ${opts.imageCount} image${opts.imageCount === 1 ? "" : "s"}. Switch to a vision model or enable an MCP/tool adapter that can describe images.`
-    );
-    this.name = "ImageInputUnsupportedError";
-  }
-};
-var VisionUrlBlockedError = class extends Error {
-  url;
-  constructor(opts) {
-    super(`vision: blocked unsafe image URL "${opts.url}" (${opts.reason})`);
-    this.name = "VisionUrlBlockedError";
-    this.url = opts.url;
-  }
-};
-async function routeImagesForModel(blocks, opts) {
-  const images = blocks.filter((b) => b.type === "image");
-  if (images.length === 0) {
-    return { blocks, route: "none", convertedImages: 0 };
-  }
-  if (opts.supportsVision) {
-    return { blocks, route: "native", convertedImages: 0 };
-  }
-  const adapters = await resolveAdapters(opts.adapters);
-  if (adapters.length === 0) {
-    throw new ImageInputUnsupportedError({
-      providerId: opts.providerId,
-      model: opts.model,
-      imageCount: images.length
-    });
-  }
-  const out = [];
-  let convertedImages = 0;
-  let lastErr;
-  let adapterName;
-  for (const block of blocks) {
-    if (block.type !== "image") {
-      out.push(block);
-      continue;
+var SUBAGENT_BASELINE = "You are a subagent executing one delegated task end-to-end. Work autonomously with your tools; do not ask for confirmation on routine in-project actions. Keep output concise.";
+var _SUBAGENT_ABORT = "wrongstack:subagent-abort-controller";
+function makeLightSubagentFactory(deps) {
+  const configStore = deps.container.resolve(TOKENS.ConfigStore);
+  const tokenCounter = deps.container.resolve(TOKENS.TokenCounter);
+  const secretScrubber = deps.container.resolve(TOKENS.SecretScrubber);
+  const systemPromptBuilder = deps.container.resolve(TOKENS.SystemPromptBuilder);
+  return async (subCfg) => {
+    const events = new EventBus();
+    const config = configStore.get();
+    const modelsRegistry = deps.modelsRegistry ?? deps.container.safeResolve(TOKENS.ModelsRegistry);
+    const matrixEntry = subCfg.model ? void 0 : resolveModelMatrix(config.modelMatrix, subCfg.role);
+    const matrixTarget = resolveModelTargetFromEntry(config, matrixEntry);
+    const effProvider = subCfg.provider ?? matrixTarget?.provider ?? config.provider;
+    const effModel = subCfg.model ?? matrixTarget?.model ?? config.model;
+    const provider = buildProvider(deps.providerRegistry, config, effProvider, effModel);
+    let subReasoningConfig = await resolveReasoningConfig(modelsRegistry, effProvider, effModel);
+    const runtimeOverride = subCfg.modelRuntime ?? matrixTarget?.modelRuntime;
+    const subCwd = subCfg.cwd ?? deps.cwd ?? deps.projectRoot;
+    const allowed = filterToolList(deps.toolRegistry, subCfg.tools);
+    const subRegistry = new ToolRegistry();
+    for (const t of allowed) subRegistry.register(t);
+    const baseSystem = await systemPromptBuilder.build({
+      cwd: subCwd,
+      projectRoot: deps.projectRoot,
+      tools: allowed,
+      model: effModel,
+      provider: effProvider,
+      subagent: true
+    });
+    baseSystem.unshift({ type: "text", text: SUBAGENT_BASELINE });
+    if (subCfg.systemPromptOverride) {
+      baseSystem.push({ type: "text", text: subCfg.systemPromptOverride });
     }
-    let description;
-    for (const adapter of adapters) {
-      try {
-        description = await adapter.describe({
-          image: block,
-          prompt: opts.prompt,
-          ctx: opts.ctx,
-          signal: opts.signal
+    const agentName = subCfg.name ?? subCfg.id ?? `sub_${cryptoId()}`;
+    const session = makeSubagentSessionShim(deps.session);
+    const ac = new AbortController();
+    const ctx = new Context({
+      systemPrompt: baseSystem,
+      provider,
+      session,
+      signal: ac.signal,
+      tokenCounter,
+      cwd: subCwd,
+      projectRoot: deps.projectRoot,
+      allowOutsideProjectRoot: config.features?.allowOutsideProjectRoot ?? !(config.tools?.restrictToProjectRoot ?? false),
+      model: effModel,
+      tools: allowed,
+      agentId: agentName,
+      agentName,
+      traceId: deps.session.traceId
+    });
+    if (subCfg.role) ctx.meta["agentRole"] = subCfg.role;
+    ctx.meta[_SUBAGENT_ABORT] = ac;
+    const pipelines = createDefaultPipelines();
+    pipelines.request.use({
+      name: "ModelRuntimeSettings",
+      async handler(req) {
+        return applyModelRuntime(req, {
+          getSettings: () => mergeModelRuntime(configStore.get().modelRuntime, runtimeOverride),
+          getReasoningConfig: () => subReasoningConfig,
+          getCapabilities: () => ctx.provider.capabilities
         });
-        adapterName = adapter.name;
-        break;
-      } catch (err) {
-        lastErr = err;
       }
-    }
-    if (!description?.trim()) {
-      throw new Error(
-        `No image-understanding adapter could process an image.${lastErr instanceof Error ? ` Last error: ${lastErr.message}` : ""}`
-      );
-    }
-    convertedImages++;
-    out.push({
-      type: "text",
-      text: `[Image ${convertedImages} analyzed via ${adapterName ?? "vision adapter"}]
-${description.trim()}`
     });
+    const caps = subCfg.allowedCapabilities ?? WIDE_SUBAGENT_CAPABILITIES;
+    const permissionPolicy = new AutoApprovePermissionPolicy(caps);
+    const toolExecutor = new ToolExecutor(subRegistry, {
+      permissionPolicy,
+      secretScrubber,
+      events,
+      confirmAwaiter: void 0,
+      iterationTimeoutMs: config.tools?.iterationTimeoutMs ?? 12e4,
+      perIterationOutputCapBytes: config.tools?.perIterationOutputCapBytes ?? 1e5,
+      tracer: void 0
+    });
+    const agent = new Agent({
+      container: deps.container,
+      tools: subRegistry,
+      providers: deps.providerRegistry,
+      events,
+      pipelines,
+      context: ctx,
+      permissionPolicy,
+      toolExecutor
+    });
+    const subFallbacks = subCfg.fallbackModels;
+    const matrixFallbacks = matrixTarget?.fallbackModels;
+    agent.extensions.register(
+      createFallbackModelExtension({
+        getConfig: () => {
+          const live = configStore.get();
+          if (subFallbacks?.length) return { ...live, fallbackModels: subFallbacks };
+          if (matrixFallbacks?.length) return { ...live, fallbackModels: matrixFallbacks };
+          return live;
+        },
+        buildProvider: (id, model) => buildProvider(deps.providerRegistry, configStore.get(), id, model ?? effModel),
+        onModelSwitch: async (id, model) => {
+          subReasoningConfig = await resolveReasoningConfig(modelsRegistry, id, model);
+        },
+        events
+      })
+    );
+    return { agent, events };
+  };
+}
+function filterToolList(registry, allow) {
+  const all = registry.list();
+  if (!allow || allow.length === 0) return all;
+  const allowSet = new Set(allow);
+  return all.filter((t) => allowSet.has(t.name));
+}
+function buildProvider(registry, config, providerId, model) {
+  const providerConfig = config.providers?.[providerId] ?? {
+    type: providerId,
+    apiKey: config.apiKey,
+    baseUrl: config.baseUrl
+  };
+  if (!registry.has(providerId)) {
+    throw new Error(
+      `No provider factory registered for "${providerId}" \u2014 cannot build a subagent provider for the SDD run.`
+    );
   }
-  return { blocks: out, route: "adapter", convertedImages, adapterName };
+  return registry.create({ ...providerConfig, type: providerId, model });
 }
-async function resolveAdapters(adapters) {
-  if (!adapters) return [];
-  return typeof adapters === "function" ? await adapters() : adapters;
+async function resolveReasoningConfig(registry, providerId, modelId) {
+  if (!registry) return void 0;
+  try {
+    return (await registry.getModel(providerId, modelId))?.capabilities.reasoningConfig;
+  } catch {
+    return void 0;
+  }
 }
-function createToolVisionAdapters(registry, opts = {}) {
-  return registry.list().filter(isLikelyVisionTool).map((tool) => ({
-    name: tool.name,
-    async describe(input) {
-      const currentTool = registry.get(tool.name);
-      if (!currentTool) {
-        throw new Error(`Tool "${tool.name}" is no longer registered`);
-      }
-      const built = await buildToolPayload(currentTool, input.image, input.prompt ?? opts.prompt);
-      if (!built) {
-        throw new Error(`Tool "${currentTool.name}" does not expose a supported image input schema`);
-      }
-      try {
-        const result = await currentTool.execute(built.payload, input.ctx, {
-          signal: input.signal
-        });
-        return stringifyToolResult(result);
-      } finally {
-        await built.cleanup?.();
-      }
+function makeSubagentSessionShim(parent) {
+  return {
+    id: parent.id,
+    transcriptPath: parent.transcriptPath,
+    get traceId() {
+      return parent.traceId;
+    },
+    set traceId(value) {
+      parent.traceId = value;
+    },
+    get pendingToolUses() {
+      return [];
+    },
+    append: (ev) => parent.append({ ...ev }),
+    appendBatch: (evs) => parent.appendBatch(evs.map((e) => ({ ...e }))),
+    flush: () => parent.flush(),
+    close: async () => {
+    },
+    recordFileChange: () => {
+    },
+    recordSideEffect: () => {
+    },
+    writeCheckpoint: async () => {
+    },
+    writeFileSnapshot: async () => {
+    },
+    truncateToCheckpoint: async () => 0,
+    clearSession: async () => {
+    },
+    writeInFlightMarker: async () => {
+    },
+    clearInFlightMarker: async () => {
     }
-  }));
+  };
 }
-function isLikelyVisionTool(tool) {
-  if (tool.permission !== "auto" || tool.mutating) return false;
-  const haystack = `${tool.name} ${tool.description ?? ""} ${tool.usageHint ?? ""}`.toLowerCase();
-  if (/(generate|create|draw|paint|edit|upscale|remove|write|delete)/.test(haystack)) return false;
-  if (!/(vision|image|screenshot|ocr|describe|analy[sz]e)/.test(haystack)) return false;
-  const props = schemaProperties(tool);
-  return [
-    "image",
-    "base64",
-    "data",
-    "url",
-    "image_url",
-    "imageUrl",
-    "path",
-    "image_path",
-    "imagePath",
-    "image_url",
-    "imageUrl",
-    "file_path",
-    "filePath",
-    "filename",
-    "file",
-    "mediaType",
-    "mimeType"
-  ].some((key) => key in props);
+function cryptoId() {
+  return randomUUID().slice(0, 8);
 }
-async function buildToolPayload(tool, image, prompt = "Describe this image for a coding agent. Include visible text, UI state, errors, layout, and any details needed to answer the user.") {
-  const props = schemaProperties(tool);
-  const payload = {};
-  const mediaType = image.source.media_type ?? "image/png";
-  const data = image.source.data;
-  const url = image.source.url;
-  let cleanup;
-  if (image.source.type === "url" && url) {
-    try {
-      await assertNotPrivateHost(new URL(url).hostname);
-    } catch (err) {
-      const reason = err instanceof Error && err.message.startsWith("fetch:") ? err.message.slice("fetch:".length).trim() : "unresolvable host";
-      throw new VisionUrlBlockedError({ url, reason });
+
+// src/host.ts
+function createRuntimeHostFromParts(parts) {
+  return {
+    agent: parts.agent,
+    context: parts.context,
+    events: parts.events,
+    tools: parts.tools,
+    providers: parts.providers,
+    slashCommands: parts.slashCommands,
+    session: parts.session,
+    extensions: parts.extensions,
+    async shutdown() {
+      await parts.shutdown?.();
     }
+  };
+}
+async function applyWrongStackPack(host, pack, opts = {}) {
+  const owner = opts.owner ?? pack.name;
+  const unregisterExtensions = [];
+  const registeredToolNames = [];
+  const registeredCommandNames = [];
+  const registeredProviderTypes = [];
+  if (pack.tools) {
+    const tools = [...pack.tools];
+    host.tools.registerAllOrThrow(tools, owner);
+    for (const t of tools) registeredToolNames.push(t.name);
   }
-  const pathKey = firstPresent(props, [
-    "path",
-    "image_path",
-    "imagePath",
-    "image_url",
-    "imageUrl",
-    "file_path",
-    "filePath",
-    "filename",
-    "file"
-  ]);
-  if (pathKey && image.source.type === "base64" && data) {
-    const p = await writeTempImage(data, mediaType);
-    payload[pathKey] = p;
-    cleanup = async () => {
-      await fs2.unlink(p).catch(() => void 0);
-      await fs2.rmdir(path.dirname(p)).catch(() => void 0);
-    };
-  } else if ("image" in props) {
-    payload.image = image.source.type === "base64" ? { type: "base64", mediaType, media_type: mediaType, data } : { type: "url", url };
-  } else if (image.source.type === "base64" && "base64" in props) {
-    payload.base64 = data;
-  } else if (image.source.type === "base64" && "data" in props) {
-    payload.data = data;
-  } else if (image.source.type === "url" && "url" in props) {
-    payload.url = url;
-  } else if (image.source.type === "url" && "image_url" in props) {
-    payload.image_url = url;
-  } else if (image.source.type === "url" && "imageUrl" in props) {
-    payload.imageUrl = url;
-  } else {
-    return null;
+  if (pack.providers) {
+    const providers = [...pack.providers];
+    host.providers.registerAll(providers);
+    for (const p of providers) registeredProviderTypes.push(p.type);
   }
-  if ("mediaType" in props) payload.mediaType = mediaType;
-  if ("mimeType" in props) payload.mimeType = mediaType;
-  if ("media_type" in props) payload.media_type = mediaType;
-  if ("prompt" in props) payload.prompt = prompt;
-  if ("query" in props) payload.query = prompt;
-  if ("instruction" in props) payload.instruction = prompt;
-  const built = { payload };
-  if (cleanup !== void 0) built.cleanup = cleanup;
-  return built;
+  if (pack.slashCommands) {
+    const cmds = [...pack.slashCommands];
+    host.slashCommands.registerAll(cmds, owner);
+    for (const c of cmds)
+      registeredCommandNames.push(owner === "core" ? c.name : `${owner}:${c.name}`);
+  }
+  if (pack.extensions && host.extensions) {
+    for (const ext of pack.extensions) {
+      unregisterExtensions.push(host.extensions.register(ext));
+    }
+  }
+  if (pack.setup) {
+    if (!opts.api) {
+      throw new Error(`Pack "${pack.name}" defines setup() but no PluginAPI was provided`);
+    }
+    try {
+      await pack.setup(opts.api);
+    } catch (setupErr) {
+      for (let i = unregisterExtensions.length - 1; i >= 0; i--) {
+        unregisterExtensions[i]();
+      }
+      for (let i = registeredCommandNames.length - 1; i >= 0; i--) {
+        host.slashCommands.unregister(registeredCommandNames[i]);
+      }
+      for (let i = registeredToolNames.length - 1; i >= 0; i--) {
+        host.tools.unregister(registeredToolNames[i]);
+      }
+      for (let i = registeredProviderTypes.length - 1; i >= 0; i--) {
+        host.providers.unregister(registeredProviderTypes[i]);
+      }
+      throw setupErr;
+    }
+  }
+  return {
+    pack,
+    owner,
+    async teardown() {
+      for (let i = unregisterExtensions.length - 1; i >= 0; i--) {
+        unregisterExtensions[i]();
+      }
+      for (let i = registeredCommandNames.length - 1; i >= 0; i--) {
+        host.slashCommands.unregister(registeredCommandNames[i]);
+      }
+      for (let i = registeredToolNames.length - 1; i >= 0; i--) {
+        host.tools.unregister(registeredToolNames[i]);
+      }
+      for (let i = registeredProviderTypes.length - 1; i >= 0; i--) {
+        host.providers.unregister(registeredProviderTypes[i]);
+      }
+      if (pack.teardown) {
+        if (!opts.api) {
+          throw new Error(`Pack "${pack.name}" defines teardown() but no PluginAPI was provided`);
+        }
+        await pack.teardown(opts.api);
+      }
+    }
+  };
+}
+async function applyWrongStackPacks(host, packs, opts = {}) {
+  const applied = [];
+  try {
+    for (const pack of packs) {
+      applied.push(await applyWrongStackPack(host, pack, opts));
+    }
+    return applied;
+  } catch (err) {
+    for (let i = applied.length - 1; i >= 0; i--) {
+      const mounted = applied[i];
+      await mounted.teardown().catch((teardownErr) => {
+        const detail = teardownErr instanceof Error ? teardownErr.message : String(teardownErr);
+        process.emitWarning(
+          `Pack teardown during error rollback failed: ${detail}`,
+          "PackRollbackWarning"
+        );
+      });
+    }
+    throw err;
+  }
+}
+
+// src/local-llm-probe.ts
+var PROBE_TIMEOUT_MS = 3e3;
+async function probeLocalLlm(opts) {
+  const { baseUrl, apiKey, noAuth, scrubber, fetchImpl, timeoutMs } = opts;
+  const fetchFn = fetchImpl ?? fetch;
+  const timeout = timeoutMs ?? PROBE_TIMEOUT_MS;
+  const base = baseUrl.replace(/\/+$/, "");
+  const url = /\/models$/.test(base) ? base : `${base}/models`;
+  const headers = { accept: "application/json" };
+  if (!noAuth && apiKey) {
+    headers["authorization"] = `Bearer ${apiKey}`;
+  }
+  const started = Date.now();
+  let res;
+  try {
+    res = await fetchFn(url, {
+      method: "GET",
+      headers,
+      signal: AbortSignal.timeout(timeout)
+    });
+  } catch (err) {
+    const elapsed2 = Date.now() - started;
+    const name = err?.name;
+    if (name === "TimeoutError" || name === "AbortError") {
+      return { ok: false, status: "timeout", elapsedMs: elapsed2, detail: `> ${timeout}ms` };
+    }
+    const detail = scrubber.scrub(err?.message ?? String(err));
+    return { ok: false, status: "unreachable", elapsedMs: elapsed2, detail };
+  }
+  const elapsed = Date.now() - started;
+  if (!res.ok) {
+    let bodySlice = "";
+    try {
+      const txt = await res.text();
+      bodySlice = txt.slice(0, 200);
+    } catch {
+    }
+    return {
+      ok: false,
+      status: "http_error",
+      httpStatus: res.status,
+      elapsedMs: elapsed,
+      detail: scrubber.scrub(bodySlice) || void 0
+    };
+  }
+  const modelIds = [];
+  try {
+    const parsed = await res.json();
+    if (!parsed || typeof parsed !== "object") {
+      return {
+        ok: false,
+        status: "invalid_response",
+        httpStatus: res.status,
+        elapsedMs: elapsed,
+        detail: "response is not a JSON object"
+      };
+    }
+    const obj = parsed;
+    const dataList = obj["data"];
+    const modelsList = obj["models"];
+    const rawList = Array.isArray(dataList) ? dataList : Array.isArray(modelsList) ? modelsList : null;
+    if (rawList === null) {
+      return {
+        ok: false,
+        status: "invalid_response",
+        httpStatus: res.status,
+        elapsedMs: elapsed,
+        detail: "no `data` or `models` array in response"
+      };
+    }
+    const seen = /* @__PURE__ */ new Set();
+    for (const entry of rawList) {
+      if (!entry || typeof entry !== "object") continue;
+      const e = entry;
+      const raw = typeof e["id"] === "string" ? e["id"] : typeof e["name"] === "string" ? e["name"] : null;
+      if (raw === null) continue;
+      const id = scrubber.scrub(raw).trim();
+      if (id.length === 0) continue;
+      if (seen.has(id)) continue;
+      seen.add(id);
+      modelIds.push(id);
+    }
+  } catch (err) {
+    return {
+      ok: false,
+      status: "invalid_response",
+      httpStatus: res.status,
+      elapsedMs: elapsed,
+      detail: scrubber.scrub(err?.message ?? "parse failed")
+    };
+  }
+  return {
+    ok: true,
+    status: "ok",
+    httpStatus: res.status,
+    elapsedMs: elapsed,
+    modelCount: modelIds.length,
+    modelIds
+  };
+}
+var ImageInputUnsupportedError = class extends Error {
+  constructor(opts) {
+    const target = [opts.providerId, opts.model].filter(Boolean).join("/") || "current model";
+    super(
+      `${target} does not support image input, and no image-understanding adapter is available for ${opts.imageCount} image${opts.imageCount === 1 ? "" : "s"}. Switch to a vision model or enable an MCP/tool adapter that can describe images.`
+    );
+    this.name = "ImageInputUnsupportedError";
+  }
+};
+var VisionUrlBlockedError = class extends Error {
+  url;
+  constructor(opts) {
+    super(`vision: blocked unsafe image URL "${opts.url}" (${opts.reason})`);
+    this.name = "VisionUrlBlockedError";
+    this.url = opts.url;
+  }
+};
+async function routeImagesForModel(blocks, opts) {
+  const images = blocks.filter((b) => b.type === "image");
+  if (images.length === 0) {
+    return { blocks, route: "none", convertedImages: 0 };
+  }
+  if (opts.supportsVision) {
+    for (const img of images) {
+      if (img.source.type === "url" && img.source.url) {
+        try {
+          await assertNotPrivateHost(new URL(img.source.url).hostname);
+        } catch (err) {
+          const reason = err instanceof Error && err.message.startsWith("fetch:") ? err.message.slice("fetch:".length).trim() : "unresolvable host";
+          throw new VisionUrlBlockedError({ url: img.source.url, reason });
+        }
+      }
+    }
+    return { blocks, route: "native", convertedImages: 0 };
+  }
+  const adapters = await resolveAdapters(opts.adapters);
+  if (adapters.length === 0) {
+    throw new ImageInputUnsupportedError({
+      providerId: opts.providerId,
+      model: opts.model,
+      imageCount: images.length
+    });
+  }
+  const out = [];
+  let convertedImages = 0;
+  let lastErr;
+  let adapterName;
+  for (const block of blocks) {
+    if (block.type !== "image") {
+      out.push(block);
+      continue;
+    }
+    let description;
+    for (const adapter of adapters) {
+      try {
+        description = await adapter.describe({
+          image: block,
+          prompt: opts.prompt,
+          ctx: opts.ctx,
+          signal: opts.signal
+        });
+        adapterName = adapter.name;
+        break;
+      } catch (err) {
+        lastErr = err;
+      }
+    }
+    if (!description?.trim()) {
+      throw new Error(
+        `No image-understanding adapter could process an image.${lastErr instanceof Error ? ` Last error: ${lastErr.message}` : ""}`
+      );
+    }
+    convertedImages++;
+    out.push({
+      type: "text",
+      text: `[Image ${convertedImages} analyzed via ${adapterName ?? "vision adapter"}]
+${description.trim()}`
+    });
+  }
+  return { blocks: out, route: "adapter", convertedImages, adapterName };
+}
+async function resolveAdapters(adapters) {
+  if (!adapters) return [];
+  return typeof adapters === "function" ? await adapters() : adapters;
+}
+function createToolVisionAdapters(registry, opts = {}) {
+  return registry.list().filter(isLikelyVisionTool).map((tool) => ({
+    name: tool.name,
+    async describe(input) {
+      const currentTool = registry.get(tool.name);
+      if (!currentTool) {
+        throw new Error(`Tool "${tool.name}" is no longer registered`);
+      }
+      const built = await buildToolPayload(currentTool, input.image, input.prompt ?? opts.prompt);
+      if (!built) {
+        throw new Error(
+          `Tool "${currentTool.name}" does not expose a supported image input schema`
+        );
+      }
+      try {
+        const result = await currentTool.execute(built.payload, input.ctx, {
+          signal: input.signal
+        });
+        return stringifyToolResult(result);
+      } finally {
+        await built.cleanup?.();
+      }
+    }
+  }));
+}
+var VISION_IMAGE_KEYS = [
+  "image",
+  "base64",
+  "data",
+  "url",
+  "image_url",
+  "imageUrl",
+  "path",
+  "image_path",
+  "imagePath",
+  "file_path",
+  "filePath",
+  "filename",
+  "file",
+  "mediaType",
+  "mimeType"
+];
+var VISION_PATH_KEYS = [
+  "path",
+  "image_path",
+  "imagePath",
+  "image_url",
+  "imageUrl",
+  "file_path",
+  "filePath",
+  "filename",
+  "file"
+];
+var VISION_MEDIA_TYPE_KEYS = ["mediaType", "mimeType", "media_type"];
+var VISION_PROMPT_KEYS = ["prompt", "query", "instruction"];
+function isLikelyVisionTool(tool) {
+  if (tool.permission !== "auto" || tool.mutating) return false;
+  const haystack = `${tool.name} ${tool.description ?? ""} ${tool.usageHint ?? ""}`.toLowerCase();
+  if (/(generate|create|draw|paint|edit|upscale|remove|write|delete)/.test(haystack)) return false;
+  if (!/(vision|image|screenshot|ocr|describe|analy[sz]e)/.test(haystack)) return false;
+  const props = schemaProperties(tool);
+  return VISION_IMAGE_KEYS.some((key) => key in props);
+}
+async function buildToolPayload(tool, image, prompt = "Describe this image for a coding agent. Include visible text, UI state, errors, layout, and any details needed to answer the user.") {
+  const props = schemaProperties(tool);
+  const payload = {};
+  const mediaType = image.source.media_type ?? "image/png";
+  const data = image.source.data;
+  const url = image.source.url;
+  let cleanup;
+  if (image.source.type === "url" && url) {
+    try {
+      await assertNotPrivateHost(new URL(url).hostname);
+    } catch (err) {
+      const reason = err instanceof Error && err.message.startsWith("fetch:") ? err.message.slice("fetch:".length).trim() : "unresolvable host";
+      throw new VisionUrlBlockedError({ url, reason });
+    }
+  }
+  const pathKey = firstPresent(props, [...VISION_PATH_KEYS]);
+  if (pathKey && image.source.type === "base64" && data) {
+    const p = await writeTempImage(data, mediaType);
+    payload[pathKey] = p;
+    cleanup = async () => {
+      await fs.unlink(p).catch(() => void 0);
+      await fs.rmdir(path.dirname(p)).catch(() => void 0);
+    };
+  } else if ("image" in props) {
+    payload.image = image.source.type === "base64" ? { type: "base64", mediaType, media_type: mediaType, data } : { type: "url", url };
+  } else if (image.source.type === "base64" && "base64" in props) {
+    payload.base64 = data;
+  } else if (image.source.type === "base64" && "data" in props) {
+    payload.data = data;
+  } else if (image.source.type === "url" && "url" in props) {
+    payload.url = url;
+  } else if (image.source.type === "url" && "image_url" in props) {
+    payload.image_url = url;
+  } else if (image.source.type === "url" && "imageUrl" in props) {
+    payload.imageUrl = url;
+  } else {
+    return null;
+  }
+  for (const key of VISION_MEDIA_TYPE_KEYS) {
+    if (key in props) payload[key] = mediaType;
+  }
+  for (const key of VISION_PROMPT_KEYS) {
+    if (key in props) payload[key] = prompt;
+  }
+  const built = { payload };
+  if (cleanup !== void 0) built.cleanup = cleanup;
+  return built;
 }
 function firstPresent(props, keys) {
   return keys.find((key) => key in props);
 }
 async function writeTempImage(data, mediaType) {
   const ext = mediaType.includes("jpeg") || mediaType.includes("jpg") ? "jpg" : "png";
-  const dir = await fs2.mkdtemp(path.join(os2.tmpdir(), "wstack-vision-"));
+  const dir = await fs.mkdtemp(path.join(os.tmpdir(), "wstack-vision-"));
   const file = path.join(dir, `image.${ext}`);
-  await fs2.writeFile(file, data, "base64");
+  await fs.writeFile(file, data, "base64");
   return file;
 }
 function schemaProperties(tool) {
@@ -422,299 +893,7 @@ function stringifyToolResult(value) {
   }
   return JSON.stringify(value);
 }
-var MAX_IMAGE_BYTES = 10 * 1024 * 1024;
-async function readClipboardImage() {
-  const platform = process.platform;
-  if (platform === "win32") return readWindows();
-  if (platform === "darwin") return readDarwin();
-  if (platform === "linux") return readLinux();
-  return null;
-}
-async function readClipboardText() {
-  const platform = process.platform;
-  if (platform === "win32") {
-    const ps = "[Console]::OutputEncoding = [System.Text.Encoding]::UTF8; Get-Clipboard -Raw";
-    const out = await runCmd("powershell", ["-NoProfile", "-Command", ps]);
-    if (out == null) return null;
-    const text = out.replace(/\r?\n$/, "");
-    return text.length > 0 ? text : null;
-  }
-  if (platform === "darwin") {
-    const out = await runCmd("pbpaste", []);
-    return out && out.length > 0 ? out : null;
-  }
-  if (platform === "linux") {
-    const tries = [
-      ["wl-paste", ["--no-newline"]],
-      ["xclip", ["-selection", "clipboard", "-o"]]
-    ];
-    for (const [cmd, args] of tries) {
-      const out = await runCmd(cmd, args);
-      if (out && out.length > 0) return out;
-    }
-    return null;
-  }
-  return null;
-}
-async function readWindows() {
-  const tmp = path.join(os2.tmpdir(), `wstack-clip-${randomUUID()}.png`);
-  const ps = [
-    "Add-Type -AssemblyName System.Windows.Forms",
-    "Add-Type -AssemblyName System.Drawing",
-    "$img = [System.Windows.Forms.Clipboard]::GetImage()",
-    'if ($img -eq $null) { Write-Output "NO_IMAGE"; exit 0 }',
-    `$img.Save('${tmp.replace(/\\/g, "\\\\")}', [System.Drawing.Imaging.ImageFormat]::Png)`,
-    'Write-Output "OK"'
-  ].join("; ");
-  const out = await runCmd("powershell", ["-NoProfile", "-Command", ps]);
-  if (!out || out.trim() === "NO_IMAGE") return null;
-  if (!out.includes("OK")) return null;
-  return readPngFile(tmp);
-}
-async function readDarwin() {
-  const tmp = path.join(os2.tmpdir(), `wstack-clip-${randomUUID()}.png`);
-  const script = [
-    "try",
-    `  set the_file to (open for access POSIX file "${tmp}" with write permission)`,
-    "  write (the clipboard as \xABclass PNGf\xBB) to the_file",
-    "  close access the_file",
-    "on error",
-    "  try",
-    '    close access POSIX file "' + tmp + '"',
-    "  end try",
-    '  return "NO_IMAGE"',
-    "end try",
-    'return "OK"'
-  ].join("\n");
-  const out = await runCmd("osascript", ["-e", script]);
-  if (out?.trim() !== "OK") return null;
-  return readPngFile(tmp);
-}
-async function readLinux() {
-  const tmp = path.join(os2.tmpdir(), `wstack-clip-${randomUUID()}.png`);
-  const tries = [
-    ["wl-paste", ["--type", "image/png"]],
-    ["xclip", ["-selection", "clipboard", "-t", "image/png", "-o"]]
-  ];
-  for (const [cmd, args] of tries) {
-    const ok = await runCmdToFile(cmd, args, tmp).catch(() => false);
-    if (ok) return readPngFile(tmp);
-  }
-  return null;
-}
-async function readPngFile(p) {
-  try {
-    const buf = await fs2.readFile(p);
-    if (buf.length === 0) {
-      await fs2.unlink(p).catch(() => void 0);
-      return null;
-    }
-    if (buf.length > MAX_IMAGE_BYTES) {
-      await fs2.unlink(p).catch(() => void 0);
-      throw new Error(`Clipboard image exceeds ${MAX_IMAGE_BYTES / 1024 / 1024}MB limit`);
-    }
-    if (buf[0] !== 137 || buf[1] !== 80 || buf[2] !== 78 || buf[3] !== 71) {
-      await fs2.unlink(p).catch(() => void 0);
-      return null;
-    }
-    await fs2.unlink(p).catch(() => void 0);
-    return { base64: buf.toString("base64"), mediaType: "image/png", bytes: buf.length };
-  } catch (err) {
-    if (err.code === "ENOENT") return null;
-    throw err;
-  }
-}
-var CLIPBOARD_CMD_TIMEOUT_MS = 5e3;
-function runCmd(cmd, args) {
-  return new Promise((resolve) => {
-    const child = spawn(cmd, args, { env: buildChildEnv(), stdio: ["ignore", "pipe", "pipe"], windowsHide: true });
-    let out = "";
-    let settled = false;
-    const finish = (value) => {
-      if (settled) return;
-      settled = true;
-      clearTimeout(timer);
-      resolve(value);
-    };
-    const timer = setTimeout(() => {
-      child.kill("SIGTERM");
-      finish(null);
-    }, CLIPBOARD_CMD_TIMEOUT_MS);
-    child.stdout.on("data", (c) => {
-      out += String(c);
-    });
-    child.on("error", () => finish(null));
-    child.on("exit", (code) => finish(code === 0 ? out : null));
-  });
-}
-function runCmdToFile(cmd, args, outPath) {
-  return new Promise((resolve) => {
-    const child = spawn(cmd, args, { env: buildChildEnv(), stdio: ["ignore", "pipe", "pipe"], windowsHide: true });
-    const chunks = [];
-    let settled = false;
-    const finish = (value) => {
-      if (settled) return;
-      settled = true;
-      clearTimeout(timer);
-      resolve(value);
-    };
-    const timer = setTimeout(() => {
-      child.kill("SIGTERM");
-      finish(false);
-    }, CLIPBOARD_CMD_TIMEOUT_MS);
-    child.stdout.on("data", (c) => chunks.push(c));
-    child.on("error", () => finish(false));
-    child.on("exit", async (code) => {
-      if (code !== 0 || chunks.length === 0) return finish(false);
-      try {
-        await fs2.writeFile(outPath, Buffer.concat(chunks));
-        finish(true);
-      } catch {
-        finish(false);
-      }
-    });
-  });
-}
-var SUBAGENT_BASELINE = "You are a subagent executing one delegated task end-to-end. Work autonomously with your tools; do not ask for confirmation on routine in-project actions. Keep output concise.";
-var _SUBAGENT_ABORT = "wrongstack:subagent-abort-controller";
-function makeLightSubagentFactory(deps) {
-  const configStore = deps.container.resolve(TOKENS.ConfigStore);
-  const tokenCounter = deps.container.resolve(TOKENS.TokenCounter);
-  const secretScrubber = deps.container.resolve(TOKENS.SecretScrubber);
-  const systemPromptBuilder = deps.container.resolve(TOKENS.SystemPromptBuilder);
-  return async (subCfg) => {
-    const events = new EventBus();
-    const config = configStore.get();
-    const matrixEntry = subCfg.model ? void 0 : resolveModelMatrix(config.modelMatrix, subCfg.role);
-    const matrixTarget = resolveModelTargetFromEntry(config, matrixEntry);
-    const effProvider = subCfg.provider ?? matrixTarget?.provider ?? config.provider;
-    const effModel = subCfg.model ?? matrixTarget?.model ?? config.model;
-    const provider = buildProvider(deps.providerRegistry, config, effProvider, effModel);
-    const subCwd = subCfg.cwd ?? deps.cwd ?? deps.projectRoot;
-    const allowed = filterToolList(deps.toolRegistry, subCfg.tools);
-    const subRegistry = new ToolRegistry();
-    for (const t of allowed) subRegistry.register(t);
-    const baseSystem = await systemPromptBuilder.build({
-      cwd: subCwd,
-      projectRoot: deps.projectRoot,
-      tools: allowed,
-      model: effModel,
-      provider: effProvider,
-      subagent: true
-    });
-    baseSystem.unshift({ type: "text", text: SUBAGENT_BASELINE });
-    if (subCfg.systemPromptOverride) {
-      baseSystem.push({ type: "text", text: subCfg.systemPromptOverride });
-    }
-    const agentName = subCfg.name ?? subCfg.id ?? `sub_${cryptoId()}`;
-    const session = makeSubagentSessionShim(deps.session);
-    const ac = new AbortController();
-    const ctx = new Context({
-      systemPrompt: baseSystem,
-      provider,
-      session,
-      signal: ac.signal,
-      tokenCounter,
-      cwd: subCwd,
-      projectRoot: deps.projectRoot,
-      allowOutsideProjectRoot: config.features?.allowOutsideProjectRoot ?? !(config.tools?.restrictToProjectRoot ?? false),
-      model: effModel,
-      tools: allowed,
-      agentId: agentName,
-      agentName
-    });
-    if (subCfg.role) ctx.meta["agentRole"] = subCfg.role;
-    ctx.meta[_SUBAGENT_ABORT] = ac;
-    const caps = subCfg.allowedCapabilities ?? WIDE_SUBAGENT_CAPABILITIES;
-    const permissionPolicy = new AutoApprovePermissionPolicy(caps);
-    const toolExecutor = new ToolExecutor(subRegistry, {
-      permissionPolicy,
-      secretScrubber,
-      events,
-      confirmAwaiter: void 0,
-      iterationTimeoutMs: config.tools?.iterationTimeoutMs ?? 12e4,
-      perIterationOutputCapBytes: config.tools?.perIterationOutputCapBytes ?? 1e5,
-      tracer: void 0
-    });
-    const agent = new Agent({
-      container: deps.container,
-      tools: subRegistry,
-      providers: deps.providerRegistry,
-      events,
-      pipelines: createDefaultPipelines(),
-      context: ctx,
-      permissionPolicy,
-      toolExecutor
-    });
-    const subFallbacks = subCfg.fallbackModels;
-    const matrixFallbacks = matrixTarget?.fallbackModels;
-    agent.extensions.register(
-      createFallbackModelExtension({
-        getConfig: () => {
-          const live = configStore.get();
-          if (subFallbacks && subFallbacks.length) return { ...live, fallbackModels: subFallbacks };
-          if (matrixFallbacks && matrixFallbacks.length) return { ...live, fallbackModels: matrixFallbacks };
-          return live;
-        },
-        buildProvider: (id) => buildProvider(deps.providerRegistry, configStore.get(), id, effModel),
-        events
-      })
-    );
-    return { agent, events };
-  };
-}
-function filterToolList(registry, allow) {
-  const all = registry.list();
-  if (!allow || allow.length === 0) return all;
-  const allowSet = new Set(allow);
-  return all.filter((t) => allowSet.has(t.name));
-}
-function buildProvider(registry, config, providerId, model) {
-  const providerConfig = config.providers?.[providerId] ?? {
-    type: providerId,
-    apiKey: config.apiKey,
-    baseUrl: config.baseUrl
-  };
-  if (!registry.has(providerId)) {
-    throw new Error(
-      `No provider factory registered for "${providerId}" \u2014 cannot build a subagent provider for the SDD run.`
-    );
-  }
-  return registry.create({ ...providerConfig, type: providerId, model });
-}
-function makeSubagentSessionShim(parent) {
-  return {
-    id: parent.id,
-    transcriptPath: parent.transcriptPath,
-    get pendingToolUses() {
-      return [];
-    },
-    append: (ev) => parent.append({ ...ev }),
-    appendBatch: (evs) => parent.appendBatch(evs.map((e) => ({ ...e }))),
-    flush: () => parent.flush(),
-    close: async () => {
-    },
-    recordFileChange: () => {
-    },
-    recordSideEffect: () => {
-    },
-    writeCheckpoint: async () => {
-    },
-    writeFileSnapshot: async () => {
-    },
-    truncateToCheckpoint: async () => 0,
-    clearSession: async () => {
-    },
-    writeInFlightMarker: async () => {
-    },
-    clearInFlightMarker: async () => {
-    }
-  };
-}
-function cryptoId() {
-  return crypto.randomUUID().slice(0, 8);
-}
 
-export { ImageInputUnsupportedError, VisionUrlBlockedError, applyWrongStackPack, applyWrongStackPacks, createDefaultContainer, createRuntimeHostFromParts, createToolVisionAdapters, makeLightSubagentFactory, readClipboardImage, readClipboardText, routeImagesForModel };
+export { ImageInputUnsupportedError, VISION_IMAGE_KEYS, VISION_MEDIA_TYPE_KEYS, VISION_PATH_KEYS, VISION_PROMPT_KEYS, VisionUrlBlockedError, applyWrongStackPack, applyWrongStackPacks, createDefaultContainer, createRuntimeHostFromParts, createToolVisionAdapters, makeLightSubagentFactory, probeLocalLlm, readClipboardImage, readClipboardText, routeImagesForModel };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map