@wrongstack/runtime 0.2.0 → 0.3.3

package/README.md

@@ -20,3 +20,25 @@ import { Agent, Container, EventBus } from '@wrongstack/core';
 The `WrongStackPack` interface in `@wrongstack/runtime/pack` is the target shape
 for extension packages that contribute tools, providers, slash commands, or
 agent lifecycle extensions.
+
+## Image routing
+
+`@wrongstack/runtime/vision` owns the host-level image input decision:
+
+- if the active provider reports `capabilities.vision`, image blocks are sent
+  natively;
+- otherwise, the host can provide `VisionAdapter`s that turn images into text
+  descriptions before `agent.run()`;
+- if neither route exists, the router throws a clear unsupported-image error
+  instead of silently flattening the image to `[image]`.
+
+`createToolVisionAdapters(toolRegistry)` can discover safe, read-only
+image-understanding tools, including MCP-wrapped tools, and expose them through
+the same adapter contract. Built-in MCP presets such as `zai-vision` and
+`minimax-vision` are configured as read-only adapter candidates. Hosts may pass
+a function that calls `createToolVisionAdapters()` at routing time so MCP
+reconnects and `tools/list_changed` refreshes are picked up before each image
+is analyzed.
+
+`@wrongstack/runtime/clipboard` exposes the shared OS clipboard PNG reader used
+by TUI `Alt+V` and CLI `/image`.

package/dist/clipboard.d.ts

@@ -0,0 +1,8 @@
+interface ClipboardImage {
+    base64: string;
+    mediaType: 'image/png';
+    bytes: number;
+}
+declare function readClipboardImage(): Promise<ClipboardImage | null>;
+
+export { type ClipboardImage, readClipboardImage };

package/dist/clipboard.js

@@ -0,0 +1,114 @@
+import { spawn } from 'child_process';
+import * as fs from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+
+// src/clipboard.ts
+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 readWindows() {
+  const tmp = path.join(os.tmpdir(), `wstack-clip-${Date.now()}.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-${Date.now()}.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 || out.trim() !== "OK") return null;
+  return readPngFile(tmp);
+}
+async function readLinux() {
+  const tmp = path.join(os.tmpdir(), `wstack-clip-${Date.now()}.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 fs.readFile(p);
+    if (buf.length === 0) {
+      await fs.unlink(p).catch(() => void 0);
+      return null;
+    }
+    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;
+  }
+}
+function runCmd(cmd, args) {
+  return new Promise((resolve) => {
+    const child = spawn(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
+    let out = "";
+    child.stdout.on("data", (c) => {
+      out += String(c);
+    });
+    child.on("error", () => resolve(null));
+    child.on("exit", (code) => resolve(code === 0 ? out : null));
+  });
+}
+function runCmdToFile(cmd, args, outPath) {
+  return new Promise((resolve) => {
+    const child = spawn(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
+    const chunks = [];
+    child.stdout.on("data", (c) => chunks.push(c));
+    child.on("error", () => resolve(false));
+    child.on("exit", async (code) => {
+      if (code !== 0 || chunks.length === 0) return resolve(false);
+      try {
+        await fs.writeFile(outPath, Buffer.concat(chunks));
+        resolve(true);
+      } catch {
+        resolve(false);
+      }
+    });
+  });
+}
+
+export { readClipboardImage };
+//# sourceMappingURL=clipboard.js.map
+//# sourceMappingURL=clipboard.js.map

package/dist/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/clipboard.ts"],"names":[],"mappings":"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","file":"clipboard.js","sourcesContent":["import { spawn } from 'node:child_process';\nimport * as fs from 'node:fs/promises';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\n\nexport interface ClipboardImage {\n  base64: string;\n  mediaType: 'image/png';\n  bytes: number;\n}\n\nconst MAX_IMAGE_BYTES = 10 * 1024 * 1024;\n\nexport async function readClipboardImage(): Promise<ClipboardImage | null> {\n  const platform = process.platform;\n  if (platform === 'win32') return readWindows();\n  if (platform === 'darwin') return readDarwin();\n  if (platform === 'linux') return readLinux();\n  return null;\n}\n\nasync function readWindows(): Promise<ClipboardImage | null> {\n  const tmp = path.join(os.tmpdir(), `wstack-clip-${Date.now()}.png`);\n  const ps = [\n    'Add-Type -AssemblyName System.Windows.Forms',\n    'Add-Type -AssemblyName System.Drawing',\n    '$img = [System.Windows.Forms.Clipboard]::GetImage()',\n    'if ($img -eq $null) { Write-Output \"NO_IMAGE\"; exit 0 }',\n    `$img.Save('${tmp.replace(/\\\\/g, '\\\\\\\\')}', [System.Drawing.Imaging.ImageFormat]::Png)`,\n    'Write-Output \"OK\"',\n  ].join('; ');\n  const out = await runCmd('powershell', ['-NoProfile', '-Command', ps]);\n  if (!out || out.trim() === 'NO_IMAGE') return null;\n  if (!out.includes('OK')) return null;\n  return readPngFile(tmp);\n}\n\nasync function readDarwin(): Promise<ClipboardImage | null> {\n  const tmp = path.join(os.tmpdir(), `wstack-clip-${Date.now()}.png`);\n  const script = [\n    'try',\n    `  set the_file to (open for access POSIX file \"${tmp}\" with write permission)`,\n    '  write (the clipboard as «class PNGf») to the_file',\n    '  close access the_file',\n    'on error',\n    '  try',\n    '    close access POSIX file \"' + tmp + '\"',\n    '  end try',\n    '  return \"NO_IMAGE\"',\n    'end try',\n    'return \"OK\"',\n  ].join('\\n');\n  const out = await runCmd('osascript', ['-e', script]);\n  if (!out || out.trim() !== 'OK') return null;\n  return readPngFile(tmp);\n}\n\nasync function readLinux(): Promise<ClipboardImage | null> {\n  const tmp = path.join(os.tmpdir(), `wstack-clip-${Date.now()}.png`);\n  const tries: Array<[string, string[]]> = [\n    ['wl-paste', ['--type', 'image/png']],\n    ['xclip', ['-selection', 'clipboard', '-t', 'image/png', '-o']],\n  ];\n  for (const [cmd, args] of tries) {\n    const ok = await runCmdToFile(cmd, args, tmp).catch(() => false);\n    if (ok) return readPngFile(tmp);\n  }\n  return null;\n}\n\nasync function readPngFile(p: string): Promise<ClipboardImage | null> {\n  try {\n    const buf = await fs.readFile(p);\n    if (buf.length === 0) {\n      await fs.unlink(p).catch(() => undefined);\n      return null;\n    }\n    if (buf.length > MAX_IMAGE_BYTES) {\n      await fs.unlink(p).catch(() => undefined);\n      throw new Error(`Clipboard image exceeds ${MAX_IMAGE_BYTES / 1024 / 1024}MB limit`);\n    }\n    if (buf[0] !== 0x89 || buf[1] !== 0x50 || buf[2] !== 0x4e || buf[3] !== 0x47) {\n      await fs.unlink(p).catch(() => undefined);\n      return null;\n    }\n    await fs.unlink(p).catch(() => undefined);\n    return { base64: buf.toString('base64'), mediaType: 'image/png', bytes: buf.length };\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code === 'ENOENT') return null;\n    throw err;\n  }\n}\n\nfunction runCmd(cmd: string, args: string[]): Promise<string | null> {\n  return new Promise((resolve) => {\n    const child = spawn(cmd, args, { stdio: ['ignore', 'pipe', 'pipe'] });\n    let out = '';\n    child.stdout.on('data', (c) => {\n      out += String(c);\n    });\n    child.on('error', () => resolve(null));\n    child.on('exit', (code) => resolve(code === 0 ? out : null));\n  });\n}\n\nfunction runCmdToFile(cmd: string, args: string[], outPath: string): Promise<boolean> {\n  return new Promise((resolve) => {\n    const child = spawn(cmd, args, { stdio: ['ignore', 'pipe', 'pipe'] });\n    const chunks: Buffer[] = [];\n    child.stdout.on('data', (c: Buffer) => chunks.push(c));\n    child.on('error', () => resolve(false));\n    child.on('exit', async (code) => {\n      if (code !== 0 || chunks.length === 0) return resolve(false);\n      try {\n        await fs.writeFile(outPath, Buffer.concat(chunks));\n        resolve(true);\n      } catch {\n        resolve(false);\n      }\n    });\n  });\n}\n"]}

package/dist/host.d.ts

@@ -1,5 +1,3 @@
-import '@wrongstack/core/defaults';
-import '@wrongstack/core/infrastructure';
 import { PluginAPI, Agent, Context, EventBus, ToolRegistry, ProviderRegistry, SlashCommandRegistry, SessionWriter, ExtensionRegistry } from '@wrongstack/core';
 import { WrongStackPack } from './pack.js';
 

package/dist/index.d.ts

@@ -1,5 +1,33 @@
 export * from '@wrongstack/core/defaults';
 export { DefaultPathResolver, DefaultTokenCounter } from '@wrongstack/core/infrastructure';
+import { Config, WstackPaths, Logger, ModelsRegistry, DefaultSystemPromptBuilderOptions, Container } from '@wrongstack/core';
 export { DefaultSystemPromptBuilder, DefaultSystemPromptBuilderOptions } from '@wrongstack/core';
 export { WrongStackPack } from './pack.js';
 export { AppliedPack, ApplyPackOptions, RuntimeHost, RuntimeHostParts, applyWrongStackPack, applyWrongStackPacks, createRuntimeHostFromParts } from './host.js';
+export { ImageInputUnsupportedError, ToolVisionAdapterOptions, VisionAdapter, VisionAdapterInput, VisionAdapters, VisionRoutingOptions, VisionRoutingResult, createToolVisionAdapters, routeImagesForModel } from './vision.js';
+export { ClipboardImage, readClipboardImage } from './clipboard.js';
+
+interface CreateContainerOptions {
+    config: Config;
+    wpaths: WstackPaths;
+    logger: Logger;
+    modelsRegistry: ModelsRegistry;
+    permission?: {
+        yolo?: boolean;
+        promptDelegate?: (tool: unknown, input: unknown, suggestedPattern: string) => Promise<'yes' | 'no' | 'always' | 'deny'>;
+    };
+    compactor?: {
+        preserveK?: number;
+        eliseThreshold?: number;
+    };
+    systemPrompt?: Partial<DefaultSystemPromptBuilderOptions>;
+    /** Bundled skills directory path (resolved at boot time). */
+    bundledSkillsDir?: string;
+}
+/**
+ * Create a Container pre-bound with all default service implementations.
+ * Both CLI and WebUI use this factory so container wiring stays in one place.
+ */
+declare function createDefaultContainer(opts: CreateContainerOptions): Container;
+
+export { type CreateContainerOptions, createDefaultContainer };

package/dist/index.js

@@ -1,6 +1,11 @@
 export * from '@wrongstack/core/defaults';
 export { DefaultPathResolver, DefaultTokenCounter } from '@wrongstack/core/infrastructure';
+import { Container, DefaultConfigStore, TOKENS, DefaultSecretScrubber, DefaultRetryPolicy, DefaultErrorHandler, DefaultTokenCounter, DefaultModeStore, DefaultSessionStore, DefaultMemoryStore, DefaultSkillLoader, DefaultSystemPromptBuilder, DefaultPermissionPolicy, HybridCompactor } 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';
 
 // src/index.ts
 
@@ -73,7 +78,344 @@ async function applyWrongStackPacks(host, packs, opts = {}) {
     throw err;
   }
 }
+function createDefaultContainer(opts) {
+  const { config, wpaths, logger, modelsRegistry } = opts;
+  const container = new Container();
+  const configStore = new DefaultConfigStore(config);
+  container.bind(TOKENS.ConfigStore, () => configStore);
+  container.bind(TOKENS.Logger, () => logger);
+  container.bind(TOKENS.SecretScrubber, () => new DefaultSecretScrubber());
+  container.bind(TOKENS.RetryPolicy, () => new DefaultRetryPolicy());
+  container.bind(TOKENS.ErrorHandler, () => new DefaultErrorHandler());
+  container.bind(TOKENS.ModelsRegistry, () => modelsRegistry);
+  container.bind(TOKENS.TokenCounter, () => new DefaultTokenCounter({ registry: modelsRegistry, providerId: config.provider }));
+  const modeStore = new DefaultModeStore({ directory: wpaths.configDir });
+  container.bind(TOKENS.ModeStore, () => modeStore);
+  container.bind(TOKENS.SessionStore, () => new DefaultSessionStore({ dir: wpaths.projectSessions }));
+  const memoryStore = new DefaultMemoryStore({ paths: wpaths });
+  container.bind(TOKENS.MemoryStore, () => memoryStore);
+  const skillLoader = new DefaultSkillLoader({ paths: wpaths, bundledDir: opts.bundledSkillsDir });
+  container.bind(TOKENS.SkillLoader, () => skillLoader);
+  if (opts.systemPrompt) {
+    container.bind(TOKENS.SystemPromptBuilder, () => new DefaultSystemPromptBuilder(opts.systemPrompt));
+  }
+  container.bind(
+    TOKENS.PermissionPolicy,
+    () => new DefaultPermissionPolicy({
+      trustFile: wpaths.projectTrust,
+      yolo: opts.permission?.yolo ?? false,
+      promptDelegate: opts.permission?.promptDelegate
+    })
+  );
+  container.bind(
+    TOKENS.Compactor,
+    () => new HybridCompactor({
+      preserveK: opts.compactor?.preserveK ?? 20,
+      eliseThreshold: opts.compactor?.eliseThreshold ?? 0.7
+    })
+  );
+  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";
+  }
+};
+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;
+    }
+    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?.();
+      }
+    }
+  }));
+}
+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);
+}
+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;
+  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 ("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;
+  return { payload, cleanup };
+}
+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 file = path.join(dir, `image.${ext}`);
+  await fs2.writeFile(file, data, "base64");
+  return file;
+}
+function schemaProperties(tool) {
+  const schema = tool.inputSchema;
+  if (!schema || typeof schema !== "object") return {};
+  const props = schema.properties;
+  return props && typeof props === "object" ? props : {};
+}
+function stringifyToolResult(value) {
+  if (typeof value === "string") return value;
+  if (Array.isArray(value)) {
+    return value.map((item) => {
+      if (item && typeof item === "object" && "text" in item) {
+        return String(item.text ?? "");
+      }
+      return typeof item === "string" ? item : JSON.stringify(item);
+    }).join("\n");
+  }
+  if (value && typeof value === "object" && "text" in value) {
+    return String(value.text ?? "");
+  }
+  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 readWindows() {
+  const tmp = path.join(os2.tmpdir(), `wstack-clip-${Date.now()}.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-${Date.now()}.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 || out.trim() !== "OK") return null;
+  return readPngFile(tmp);
+}
+async function readLinux() {
+  const tmp = path.join(os2.tmpdir(), `wstack-clip-${Date.now()}.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;
+  }
+}
+function runCmd(cmd, args) {
+  return new Promise((resolve) => {
+    const child = spawn(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
+    let out = "";
+    child.stdout.on("data", (c) => {
+      out += String(c);
+    });
+    child.on("error", () => resolve(null));
+    child.on("exit", (code) => resolve(code === 0 ? out : null));
+  });
+}
+function runCmdToFile(cmd, args, outPath) {
+  return new Promise((resolve) => {
+    const child = spawn(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
+    const chunks = [];
+    child.stdout.on("data", (c) => chunks.push(c));
+    child.on("error", () => resolve(false));
+    child.on("exit", async (code) => {
+      if (code !== 0 || chunks.length === 0) return resolve(false);
+      try {
+        await fs2.writeFile(outPath, Buffer.concat(chunks));
+        resolve(true);
+      } catch {
+        resolve(false);
+      }
+    });
+  });
+}
 
-export { applyWrongStackPack, applyWrongStackPacks, createRuntimeHostFromParts };
+export { ImageInputUnsupportedError, applyWrongStackPack, applyWrongStackPacks, createDefaultContainer, createRuntimeHostFromParts, createToolVisionAdapters, readClipboardImage, routeImagesForModel };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/host.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type {\n  Agent,\n  Context,\n  EventBus,\n  ExtensionRegistry,\n  PluginAPI,\n  ProviderRegistry,\n  SessionWriter,\n  SlashCommandRegistry,\n  ToolRegistry,\n} from '@wrongstack/core';\nimport type { WrongStackPack } from './pack.js';\n\nexport interface RuntimeHost {\n  agent: Agent;\n  context: Context;\n  events: EventBus;\n  tools: ToolRegistry;\n  providers: ProviderRegistry;\n  slashCommands: SlashCommandRegistry;\n  session: SessionWriter;\n  extensions?: ExtensionRegistry;\n  shutdown(): Promise<void>;\n}\n\nexport interface RuntimeHostParts {\n  agent: Agent;\n  context: Context;\n  events: EventBus;\n  tools: ToolRegistry;\n  providers: ProviderRegistry;\n  slashCommands: SlashCommandRegistry;\n  session: SessionWriter;\n  extensions?: ExtensionRegistry;\n  shutdown?: () => void | Promise<void>;\n}\n\nexport function createRuntimeHostFromParts(parts: RuntimeHostParts): RuntimeHost {\n  return {\n    agent: parts.agent,\n    context: parts.context,\n    events: parts.events,\n    tools: parts.tools,\n    providers: parts.providers,\n    slashCommands: parts.slashCommands,\n    session: parts.session,\n    extensions: parts.extensions,\n    async shutdown() {\n      await parts.shutdown?.();\n    },\n  };\n}\n\nexport interface ApplyPackOptions {\n  owner?: string;\n  api?: PluginAPI;\n}\n\nexport interface AppliedPack {\n  pack: WrongStackPack;\n  owner: string;\n  teardown(): Promise<void>;\n}\n\nexport async function applyWrongStackPack(\n  host: Pick<RuntimeHost, 'tools' | 'providers' | 'slashCommands'> & {\n    extensions?: ExtensionRegistry;\n  },\n  pack: WrongStackPack,\n  opts: ApplyPackOptions = {},\n): Promise<AppliedPack> {\n  const owner = opts.owner ?? pack.name;\n  const unregisterExtensions: Array<() => void> = [];\n\n  if (pack.tools) {\n    host.tools.registerAllOrThrow([...pack.tools], owner);\n  }\n  if (pack.providers) {\n    host.providers.registerAll([...pack.providers]);\n  }\n  if (pack.slashCommands) {\n    host.slashCommands.registerAll([...pack.slashCommands], owner);\n  }\n  if (pack.extensions && host.extensions) {\n    for (const ext of pack.extensions) {\n      unregisterExtensions.push(host.extensions.register(ext));\n    }\n  }\n  if (pack.setup) {\n    if (!opts.api) {\n      throw new Error(`Pack \"${pack.name}\" defines setup() but no PluginAPI was provided`);\n    }\n    await pack.setup(opts.api);\n  }\n\n  return {\n    pack,\n    owner,\n    async teardown() {\n      for (const unregister of unregisterExtensions.reverse()) {\n        unregister();\n      }\n      if (pack.teardown) {\n        if (!opts.api) {\n          throw new Error(`Pack \"${pack.name}\" defines teardown() but no PluginAPI was provided`);\n        }\n        await pack.teardown(opts.api);\n      }\n    },\n  };\n}\n\nexport async function applyWrongStackPacks(\n  host: Pick<RuntimeHost, 'tools' | 'providers' | 'slashCommands'> & {\n    extensions?: ExtensionRegistry;\n  },\n  packs: readonly WrongStackPack[],\n  opts: ApplyPackOptions = {},\n): Promise<AppliedPack[]> {\n  const applied: AppliedPack[] = [];\n  try {\n    for (const pack of packs) {\n      applied.push(await applyWrongStackPack(host, pack, opts));\n    }\n    return applied;\n  } catch (err) {\n    for (const mounted of applied.reverse()) {\n      await mounted.teardown().catch(() => undefined);\n    }\n    throw err;\n  }\n}\n"]}
+{"version":3,"sources":["../src/host.ts","../src/container.ts","../src/vision.ts","../src/clipboard.ts"],"names":["fs","os","path2"],"mappings":"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","file":"index.js","sourcesContent":["import type {\n  Agent,\n  Context,\n  EventBus,\n  ExtensionRegistry,\n  PluginAPI,\n  ProviderRegistry,\n  SessionWriter,\n  SlashCommandRegistry,\n  ToolRegistry,\n} from '@wrongstack/core';\nimport type { WrongStackPack } from './pack.js';\n\nexport interface RuntimeHost {\n  agent: Agent;\n  context: Context;\n  events: EventBus;\n  tools: ToolRegistry;\n  providers: ProviderRegistry;\n  slashCommands: SlashCommandRegistry;\n  session: SessionWriter;\n  extensions?: ExtensionRegistry;\n  shutdown(): Promise<void>;\n}\n\nexport interface RuntimeHostParts {\n  agent: Agent;\n  context: Context;\n  events: EventBus;\n  tools: ToolRegistry;\n  providers: ProviderRegistry;\n  slashCommands: SlashCommandRegistry;\n  session: SessionWriter;\n  extensions?: ExtensionRegistry;\n  shutdown?: () => void | Promise<void>;\n}\n\nexport function createRuntimeHostFromParts(parts: RuntimeHostParts): RuntimeHost {\n  return {\n    agent: parts.agent,\n    context: parts.context,\n    events: parts.events,\n    tools: parts.tools,\n    providers: parts.providers,\n    slashCommands: parts.slashCommands,\n    session: parts.session,\n    extensions: parts.extensions,\n    async shutdown() {\n      await parts.shutdown?.();\n    },\n  };\n}\n\nexport interface ApplyPackOptions {\n  owner?: string;\n  api?: PluginAPI;\n}\n\nexport interface AppliedPack {\n  pack: WrongStackPack;\n  owner: string;\n  teardown(): Promise<void>;\n}\n\nexport async function applyWrongStackPack(\n  host: Pick<RuntimeHost, 'tools' | 'providers' | 'slashCommands'> & {\n    extensions?: ExtensionRegistry;\n  },\n  pack: WrongStackPack,\n  opts: ApplyPackOptions = {},\n): Promise<AppliedPack> {\n  const owner = opts.owner ?? pack.name;\n  const unregisterExtensions: Array<() => void> = [];\n\n  if (pack.tools) {\n    host.tools.registerAllOrThrow([...pack.tools], owner);\n  }\n  if (pack.providers) {\n    host.providers.registerAll([...pack.providers]);\n  }\n  if (pack.slashCommands) {\n    host.slashCommands.registerAll([...pack.slashCommands], owner);\n  }\n  if (pack.extensions && host.extensions) {\n    for (const ext of pack.extensions) {\n      unregisterExtensions.push(host.extensions.register(ext));\n    }\n  }\n  if (pack.setup) {\n    if (!opts.api) {\n      throw new Error(`Pack \"${pack.name}\" defines setup() but no PluginAPI was provided`);\n    }\n    await pack.setup(opts.api);\n  }\n\n  return {\n    pack,\n    owner,\n    async teardown() {\n      for (const unregister of unregisterExtensions.reverse()) {\n        unregister();\n      }\n      if (pack.teardown) {\n        if (!opts.api) {\n          throw new Error(`Pack \"${pack.name}\" defines teardown() but no PluginAPI was provided`);\n        }\n        await pack.teardown(opts.api);\n      }\n    },\n  };\n}\n\nexport async function applyWrongStackPacks(\n  host: Pick<RuntimeHost, 'tools' | 'providers' | 'slashCommands'> & {\n    extensions?: ExtensionRegistry;\n  },\n  packs: readonly WrongStackPack[],\n  opts: ApplyPackOptions = {},\n): Promise<AppliedPack[]> {\n  const applied: AppliedPack[] = [];\n  try {\n    for (const pack of packs) {\n      applied.push(await applyWrongStackPack(host, pack, opts));\n    }\n    return applied;\n  } catch (err) {\n    for (const mounted of applied.reverse()) {\n      await mounted.teardown().catch(() => undefined);\n    }\n    throw err;\n  }\n}\n","import {\n  Container,\n  DefaultConfigStore,\n  DefaultErrorHandler,\n  DefaultMemoryStore,\n  DefaultModeStore,\n  DefaultPermissionPolicy,\n  DefaultRetryPolicy,\n  DefaultSecretScrubber,\n  DefaultSessionStore,\n  DefaultSkillLoader,\n  DefaultSystemPromptBuilder,\n  DefaultTokenCounter,\n  HybridCompactor,\n  TOKENS,\n  type Config,\n  type Logger,\n  type ModelsRegistry,\n  type WstackPaths,\n} from '@wrongstack/core';\nimport type { DefaultSystemPromptBuilderOptions } from '@wrongstack/core';\n\nexport interface CreateContainerOptions {\n  config: Config;\n  wpaths: WstackPaths;\n  logger: Logger;\n  modelsRegistry: ModelsRegistry;\n  permission?: {\n    yolo?: boolean;\n    promptDelegate?: (tool: unknown, input: unknown, suggestedPattern: string) => Promise<'yes' | 'no' | 'always' | 'deny'>;\n  };\n  compactor?: { preserveK?: number; eliseThreshold?: number };\n  systemPrompt?: Partial<DefaultSystemPromptBuilderOptions>;\n  /** Bundled skills directory path (resolved at boot time). */\n  bundledSkillsDir?: string;\n}\n\n/**\n * Create a Container pre-bound with all default service implementations.\n * Both CLI and WebUI use this factory so container wiring stays in one place.\n */\nexport function createDefaultContainer(opts: CreateContainerOptions): Container {\n  const { config, wpaths, logger, modelsRegistry } = opts;\n  const container = new Container();\n\n  const configStore = new DefaultConfigStore(config);\n  container.bind(TOKENS.ConfigStore, () => configStore);\n  container.bind(TOKENS.Logger, () => logger);\n  container.bind(TOKENS.SecretScrubber, () => new DefaultSecretScrubber());\n  container.bind(TOKENS.RetryPolicy, () => new DefaultRetryPolicy());\n  container.bind(TOKENS.ErrorHandler, () => new DefaultErrorHandler());\n  container.bind(TOKENS.ModelsRegistry, () => modelsRegistry);\n  container.bind(TOKENS.TokenCounter, () => new DefaultTokenCounter({ registry: modelsRegistry, providerId: config.provider }));\n\n  const modeStore = new DefaultModeStore({ directory: wpaths.configDir });\n  container.bind(TOKENS.ModeStore, () => modeStore);\n  container.bind(TOKENS.SessionStore, () => new DefaultSessionStore({ dir: wpaths.projectSessions }));\n\n  const memoryStore = new DefaultMemoryStore({ paths: wpaths });\n  container.bind(TOKENS.MemoryStore, () => memoryStore);\n\n  const skillLoader = new DefaultSkillLoader({ paths: wpaths, bundledDir: opts.bundledSkillsDir });\n  container.bind(TOKENS.SkillLoader, () => skillLoader);\n\n  if (opts.systemPrompt) {\n    container.bind(TOKENS.SystemPromptBuilder, () => new DefaultSystemPromptBuilder(opts.systemPrompt as DefaultSystemPromptBuilderOptions));\n  }\n\n  container.bind(TOKENS.PermissionPolicy, () =>\n    new DefaultPermissionPolicy({\n      trustFile: wpaths.projectTrust,\n      yolo: opts.permission?.yolo ?? false,\n      promptDelegate: opts.permission?.promptDelegate as any,\n    }),\n  );\n\n  container.bind(TOKENS.Compactor, () =>\n    new HybridCompactor({\n      preserveK: opts.compactor?.preserveK ?? 20,\n      eliseThreshold: opts.compactor?.eliseThreshold ?? 0.7,\n    }),\n  );\n\n  return container;\n}\n","import * as fs from 'node:fs/promises';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\nimport type { ContentBlock, Context, ImageBlock, Tool, ToolRegistry } from '@wrongstack/core';\n\nexport interface VisionAdapterInput {\n  image: ImageBlock;\n  prompt?: string;\n  ctx: Context;\n  signal: AbortSignal;\n}\n\nexport interface VisionAdapter {\n  name: string;\n  describe(input: VisionAdapterInput): Promise<string>;\n}\n\nexport type VisionAdapters =\n  | readonly VisionAdapter[]\n  | (() => readonly VisionAdapter[] | Promise<readonly VisionAdapter[]>);\n\nexport interface VisionRoutingOptions {\n  supportsVision: boolean;\n  adapters?: VisionAdapters;\n  ctx: Context;\n  signal: AbortSignal;\n  prompt?: string;\n  providerId?: string;\n  model?: string;\n}\n\nexport interface VisionRoutingResult {\n  blocks: ContentBlock[];\n  route: 'native' | 'adapter' | 'none';\n  convertedImages: number;\n  adapterName?: string;\n}\n\nexport class ImageInputUnsupportedError extends Error {\n  constructor(opts: { providerId?: string; model?: string; imageCount: number }) {\n    const target = [opts.providerId, opts.model].filter(Boolean).join('/') || 'current model';\n    super(\n      `${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.`,\n    );\n    this.name = 'ImageInputUnsupportedError';\n  }\n}\n\nexport async function routeImagesForModel(\n  blocks: ContentBlock[],\n  opts: VisionRoutingOptions,\n): Promise<VisionRoutingResult> {\n  const images = blocks.filter((b): b is ImageBlock => b.type === 'image');\n  if (images.length === 0) {\n    return { blocks, route: 'none', convertedImages: 0 };\n  }\n  if (opts.supportsVision) {\n    return { blocks, route: 'native', convertedImages: 0 };\n  }\n\n  const adapters = await resolveAdapters(opts.adapters);\n  if (adapters.length === 0) {\n    throw new ImageInputUnsupportedError({\n      providerId: opts.providerId,\n      model: opts.model,\n      imageCount: images.length,\n    });\n  }\n\n  const out: ContentBlock[] = [];\n  let convertedImages = 0;\n  let lastErr: unknown;\n  let adapterName: string | undefined;\n  for (const block of blocks) {\n    if (block.type !== 'image') {\n      out.push(block);\n      continue;\n    }\n    let description: string | undefined;\n    for (const adapter of adapters) {\n      try {\n        description = await adapter.describe({\n          image: block,\n          prompt: opts.prompt,\n          ctx: opts.ctx,\n          signal: opts.signal,\n        });\n        adapterName = adapter.name;\n        break;\n      } catch (err) {\n        lastErr = err;\n      }\n    }\n    if (!description?.trim()) {\n      throw new Error(\n        `No image-understanding adapter could process an image.${lastErr instanceof Error ? ` Last error: ${lastErr.message}` : ''}`,\n      );\n    }\n    convertedImages++;\n    out.push({\n      type: 'text',\n      text: `[Image ${convertedImages} analyzed via ${adapterName ?? 'vision adapter'}]\\n${description.trim()}`,\n    });\n  }\n\n  return { blocks: out, route: 'adapter', convertedImages, adapterName };\n}\n\nasync function resolveAdapters(adapters: VisionAdapters | undefined): Promise<readonly VisionAdapter[]> {\n  if (!adapters) return [];\n  return typeof adapters === 'function' ? await adapters() : adapters;\n}\n\nexport interface ToolVisionAdapterOptions {\n  prompt?: string;\n}\n\nexport function createToolVisionAdapters(\n  registry: ToolRegistry,\n  opts: ToolVisionAdapterOptions = {},\n): VisionAdapter[] {\n  return registry\n    .list()\n    .filter(isLikelyVisionTool)\n    .map((tool) => ({\n      name: tool.name,\n      async describe(input: VisionAdapterInput): Promise<string> {\n        const currentTool = registry.get(tool.name);\n        if (!currentTool) {\n          throw new Error(`Tool \"${tool.name}\" is no longer registered`);\n        }\n        const built = await buildToolPayload(currentTool, input.image, input.prompt ?? opts.prompt);\n        if (!built) {\n          throw new Error(`Tool \"${currentTool.name}\" does not expose a supported image input schema`);\n        }\n        try {\n          const result = await currentTool.execute(built.payload, input.ctx, {\n            signal: input.signal,\n          });\n          return stringifyToolResult(result);\n        } finally {\n          await built.cleanup?.();\n        }\n      },\n    }));\n}\n\nfunction isLikelyVisionTool(tool: Tool): boolean {\n  if (tool.permission !== 'auto' || tool.mutating) return false;\n  const haystack = `${tool.name} ${tool.description ?? ''} ${tool.usageHint ?? ''}`.toLowerCase();\n  if (/(generate|create|draw|paint|edit|upscale|remove|write|delete)/.test(haystack)) return false;\n  if (!/(vision|image|screenshot|ocr|describe|analy[sz]e)/.test(haystack)) return false;\n  const props = schemaProperties(tool);\n  return [\n    'image',\n    'base64',\n    'data',\n    'url',\n    'image_url',\n    'imageUrl',\n    'path',\n    'image_path',\n    'imagePath',\n    'image_url',\n    'imageUrl',\n    'file_path',\n    'filePath',\n    'filename',\n    'file',\n    'mediaType',\n    'mimeType',\n  ].some((key) => key in props);\n}\n\nasync function buildToolPayload(\n  tool: Tool,\n  image: ImageBlock,\n  prompt = 'Describe this image for a coding agent. Include visible text, UI state, errors, layout, and any details needed to answer the user.',\n): Promise<{ payload: Record<string, unknown>; cleanup?: () => Promise<void> } | null> {\n  const props = schemaProperties(tool);\n  const payload: Record<string, unknown> = {};\n  const mediaType = image.source.media_type ?? 'image/png';\n  const data = image.source.data;\n  const url = image.source.url;\n  let cleanup: (() => Promise<void>) | undefined;\n\n  const pathKey = firstPresent(props, [\n    'path',\n    'image_path',\n    'imagePath',\n    'image_url',\n    'imageUrl',\n    'file_path',\n    'filePath',\n    'filename',\n    'file',\n  ]);\n  if (pathKey && image.source.type === 'base64' && data) {\n    const p = await writeTempImage(data, mediaType);\n    payload[pathKey] = p;\n    cleanup = async () => {\n      await fs.unlink(p).catch(() => undefined);\n      await fs.rmdir(path.dirname(p)).catch(() => undefined);\n    };\n  } else if ('image' in props) {\n    payload.image =\n      image.source.type === 'base64'\n        ? { type: 'base64', mediaType, media_type: mediaType, data }\n        : { type: 'url', url };\n  } else if (image.source.type === 'base64' && 'base64' in props) {\n    payload.base64 = data;\n  } else if (image.source.type === 'base64' && 'data' in props) {\n    payload.data = data;\n  } else if (image.source.type === 'url' && 'url' in props) {\n    payload.url = url;\n  } else if (image.source.type === 'url' && 'image_url' in props) {\n    payload.image_url = url;\n  } else if (image.source.type === 'url' && 'imageUrl' in props) {\n    payload.imageUrl = url;\n  } else {\n    return null;\n  }\n\n  if ('mediaType' in props) payload.mediaType = mediaType;\n  if ('mimeType' in props) payload.mimeType = mediaType;\n  if ('media_type' in props) payload.media_type = mediaType;\n  if ('prompt' in props) payload.prompt = prompt;\n  if ('query' in props) payload.query = prompt;\n  if ('instruction' in props) payload.instruction = prompt;\n  return { payload, cleanup };\n}\n\nfunction firstPresent(props: Record<string, unknown>, keys: string[]): string | undefined {\n  return keys.find((key) => key in props);\n}\n\nasync function writeTempImage(data: string, mediaType: string): Promise<string> {\n  const ext = mediaType.includes('jpeg') || mediaType.includes('jpg') ? 'jpg' : 'png';\n  const dir = await fs.mkdtemp(path.join(os.tmpdir(), 'wstack-vision-'));\n  const file = path.join(dir, `image.${ext}`);\n  await fs.writeFile(file, data, 'base64');\n  return file;\n}\n\nfunction schemaProperties(tool: Tool): Record<string, unknown> {\n  const schema = tool.inputSchema;\n  if (!schema || typeof schema !== 'object') return {};\n  const props = (schema as { properties?: unknown }).properties;\n  return props && typeof props === 'object' ? (props as Record<string, unknown>) : {};\n}\n\nfunction stringifyToolResult(value: unknown): string {\n  if (typeof value === 'string') return value;\n  if (Array.isArray(value)) {\n    return value\n      .map((item) => {\n        if (item && typeof item === 'object' && 'text' in item) {\n          return String((item as { text?: unknown }).text ?? '');\n        }\n        return typeof item === 'string' ? item : JSON.stringify(item);\n      })\n      .join('\\n');\n  }\n  if (value && typeof value === 'object' && 'text' in value) {\n    return String((value as { text?: unknown }).text ?? '');\n  }\n  return JSON.stringify(value);\n}\n","import { spawn } from 'node:child_process';\nimport * as fs from 'node:fs/promises';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\n\nexport interface ClipboardImage {\n  base64: string;\n  mediaType: 'image/png';\n  bytes: number;\n}\n\nconst MAX_IMAGE_BYTES = 10 * 1024 * 1024;\n\nexport async function readClipboardImage(): Promise<ClipboardImage | null> {\n  const platform = process.platform;\n  if (platform === 'win32') return readWindows();\n  if (platform === 'darwin') return readDarwin();\n  if (platform === 'linux') return readLinux();\n  return null;\n}\n\nasync function readWindows(): Promise<ClipboardImage | null> {\n  const tmp = path.join(os.tmpdir(), `wstack-clip-${Date.now()}.png`);\n  const ps = [\n    'Add-Type -AssemblyName System.Windows.Forms',\n    'Add-Type -AssemblyName System.Drawing',\n    '$img = [System.Windows.Forms.Clipboard]::GetImage()',\n    'if ($img -eq $null) { Write-Output \"NO_IMAGE\"; exit 0 }',\n    `$img.Save('${tmp.replace(/\\\\/g, '\\\\\\\\')}', [System.Drawing.Imaging.ImageFormat]::Png)`,\n    'Write-Output \"OK\"',\n  ].join('; ');\n  const out = await runCmd('powershell', ['-NoProfile', '-Command', ps]);\n  if (!out || out.trim() === 'NO_IMAGE') return null;\n  if (!out.includes('OK')) return null;\n  return readPngFile(tmp);\n}\n\nasync function readDarwin(): Promise<ClipboardImage | null> {\n  const tmp = path.join(os.tmpdir(), `wstack-clip-${Date.now()}.png`);\n  const script = [\n    'try',\n    `  set the_file to (open for access POSIX file \"${tmp}\" with write permission)`,\n    '  write (the clipboard as «class PNGf») to the_file',\n    '  close access the_file',\n    'on error',\n    '  try',\n    '    close access POSIX file \"' + tmp + '\"',\n    '  end try',\n    '  return \"NO_IMAGE\"',\n    'end try',\n    'return \"OK\"',\n  ].join('\\n');\n  const out = await runCmd('osascript', ['-e', script]);\n  if (!out || out.trim() !== 'OK') return null;\n  return readPngFile(tmp);\n}\n\nasync function readLinux(): Promise<ClipboardImage | null> {\n  const tmp = path.join(os.tmpdir(), `wstack-clip-${Date.now()}.png`);\n  const tries: Array<[string, string[]]> = [\n    ['wl-paste', ['--type', 'image/png']],\n    ['xclip', ['-selection', 'clipboard', '-t', 'image/png', '-o']],\n  ];\n  for (const [cmd, args] of tries) {\n    const ok = await runCmdToFile(cmd, args, tmp).catch(() => false);\n    if (ok) return readPngFile(tmp);\n  }\n  return null;\n}\n\nasync function readPngFile(p: string): Promise<ClipboardImage | null> {\n  try {\n    const buf = await fs.readFile(p);\n    if (buf.length === 0) {\n      await fs.unlink(p).catch(() => undefined);\n      return null;\n    }\n    if (buf.length > MAX_IMAGE_BYTES) {\n      await fs.unlink(p).catch(() => undefined);\n      throw new Error(`Clipboard image exceeds ${MAX_IMAGE_BYTES / 1024 / 1024}MB limit`);\n    }\n    if (buf[0] !== 0x89 || buf[1] !== 0x50 || buf[2] !== 0x4e || buf[3] !== 0x47) {\n      await fs.unlink(p).catch(() => undefined);\n      return null;\n    }\n    await fs.unlink(p).catch(() => undefined);\n    return { base64: buf.toString('base64'), mediaType: 'image/png', bytes: buf.length };\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code === 'ENOENT') return null;\n    throw err;\n  }\n}\n\nfunction runCmd(cmd: string, args: string[]): Promise<string | null> {\n  return new Promise((resolve) => {\n    const child = spawn(cmd, args, { stdio: ['ignore', 'pipe', 'pipe'] });\n    let out = '';\n    child.stdout.on('data', (c) => {\n      out += String(c);\n    });\n    child.on('error', () => resolve(null));\n    child.on('exit', (code) => resolve(code === 0 ? out : null));\n  });\n}\n\nfunction runCmdToFile(cmd: string, args: string[], outPath: string): Promise<boolean> {\n  return new Promise((resolve) => {\n    const child = spawn(cmd, args, { stdio: ['ignore', 'pipe', 'pipe'] });\n    const chunks: Buffer[] = [];\n    child.stdout.on('data', (c: Buffer) => chunks.push(c));\n    child.on('error', () => resolve(false));\n    child.on('exit', async (code) => {\n      if (code !== 0 || chunks.length === 0) return resolve(false);\n      try {\n        await fs.writeFile(outPath, Buffer.concat(chunks));\n        resolve(true);\n      } catch {\n        resolve(false);\n      }\n    });\n  });\n}\n"]}

package/dist/vision.d.ts

@@ -0,0 +1,42 @@
+import { ImageBlock, Context, ContentBlock, ToolRegistry } from '@wrongstack/core';
+
+interface VisionAdapterInput {
+    image: ImageBlock;
+    prompt?: string;
+    ctx: Context;
+    signal: AbortSignal;
+}
+interface VisionAdapter {
+    name: string;
+    describe(input: VisionAdapterInput): Promise<string>;
+}
+type VisionAdapters = readonly VisionAdapter[] | (() => readonly VisionAdapter[] | Promise<readonly VisionAdapter[]>);
+interface VisionRoutingOptions {
+    supportsVision: boolean;
+    adapters?: VisionAdapters;
+    ctx: Context;
+    signal: AbortSignal;
+    prompt?: string;
+    providerId?: string;
+    model?: string;
+}
+interface VisionRoutingResult {
+    blocks: ContentBlock[];
+    route: 'native' | 'adapter' | 'none';
+    convertedImages: number;
+    adapterName?: string;
+}
+declare class ImageInputUnsupportedError extends Error {
+    constructor(opts: {
+        providerId?: string;
+        model?: string;
+        imageCount: number;
+    });
+}
+declare function routeImagesForModel(blocks: ContentBlock[], opts: VisionRoutingOptions): Promise<VisionRoutingResult>;
+interface ToolVisionAdapterOptions {
+    prompt?: string;
+}
+declare function createToolVisionAdapters(registry: ToolRegistry, opts?: ToolVisionAdapterOptions): VisionAdapter[];
+
+export { ImageInputUnsupportedError, type ToolVisionAdapterOptions, type VisionAdapter, type VisionAdapterInput, type VisionAdapters, type VisionRoutingOptions, type VisionRoutingResult, createToolVisionAdapters, routeImagesForModel };

package/dist/vision.js

@@ -0,0 +1,204 @@
+import * as fs from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+
+// src/vision.ts
+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";
+  }
+};
+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;
+    }
+    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?.();
+      }
+    }
+  }));
+}
+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);
+}
+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;
+  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 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;
+  }
+  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;
+  return { payload, cleanup };
+}
+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 fs.mkdtemp(path.join(os.tmpdir(), "wstack-vision-"));
+  const file = path.join(dir, `image.${ext}`);
+  await fs.writeFile(file, data, "base64");
+  return file;
+}
+function schemaProperties(tool) {
+  const schema = tool.inputSchema;
+  if (!schema || typeof schema !== "object") return {};
+  const props = schema.properties;
+  return props && typeof props === "object" ? props : {};
+}
+function stringifyToolResult(value) {
+  if (typeof value === "string") return value;
+  if (Array.isArray(value)) {
+    return value.map((item) => {
+      if (item && typeof item === "object" && "text" in item) {
+        return String(item.text ?? "");
+      }
+      return typeof item === "string" ? item : JSON.stringify(item);
+    }).join("\n");
+  }
+  if (value && typeof value === "object" && "text" in value) {
+    return String(value.text ?? "");
+  }
+  return JSON.stringify(value);
+}
+
+export { ImageInputUnsupportedError, createToolVisionAdapters, routeImagesForModel };
+//# sourceMappingURL=vision.js.map
+//# sourceMappingURL=vision.js.map

package/dist/vision.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vision.ts"],"names":[],"mappings":"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","file":"vision.js","sourcesContent":["import * as fs from 'node:fs/promises';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\nimport type { ContentBlock, Context, ImageBlock, Tool, ToolRegistry } from '@wrongstack/core';\n\nexport interface VisionAdapterInput {\n  image: ImageBlock;\n  prompt?: string;\n  ctx: Context;\n  signal: AbortSignal;\n}\n\nexport interface VisionAdapter {\n  name: string;\n  describe(input: VisionAdapterInput): Promise<string>;\n}\n\nexport type VisionAdapters =\n  | readonly VisionAdapter[]\n  | (() => readonly VisionAdapter[] | Promise<readonly VisionAdapter[]>);\n\nexport interface VisionRoutingOptions {\n  supportsVision: boolean;\n  adapters?: VisionAdapters;\n  ctx: Context;\n  signal: AbortSignal;\n  prompt?: string;\n  providerId?: string;\n  model?: string;\n}\n\nexport interface VisionRoutingResult {\n  blocks: ContentBlock[];\n  route: 'native' | 'adapter' | 'none';\n  convertedImages: number;\n  adapterName?: string;\n}\n\nexport class ImageInputUnsupportedError extends Error {\n  constructor(opts: { providerId?: string; model?: string; imageCount: number }) {\n    const target = [opts.providerId, opts.model].filter(Boolean).join('/') || 'current model';\n    super(\n      `${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.`,\n    );\n    this.name = 'ImageInputUnsupportedError';\n  }\n}\n\nexport async function routeImagesForModel(\n  blocks: ContentBlock[],\n  opts: VisionRoutingOptions,\n): Promise<VisionRoutingResult> {\n  const images = blocks.filter((b): b is ImageBlock => b.type === 'image');\n  if (images.length === 0) {\n    return { blocks, route: 'none', convertedImages: 0 };\n  }\n  if (opts.supportsVision) {\n    return { blocks, route: 'native', convertedImages: 0 };\n  }\n\n  const adapters = await resolveAdapters(opts.adapters);\n  if (adapters.length === 0) {\n    throw new ImageInputUnsupportedError({\n      providerId: opts.providerId,\n      model: opts.model,\n      imageCount: images.length,\n    });\n  }\n\n  const out: ContentBlock[] = [];\n  let convertedImages = 0;\n  let lastErr: unknown;\n  let adapterName: string | undefined;\n  for (const block of blocks) {\n    if (block.type !== 'image') {\n      out.push(block);\n      continue;\n    }\n    let description: string | undefined;\n    for (const adapter of adapters) {\n      try {\n        description = await adapter.describe({\n          image: block,\n          prompt: opts.prompt,\n          ctx: opts.ctx,\n          signal: opts.signal,\n        });\n        adapterName = adapter.name;\n        break;\n      } catch (err) {\n        lastErr = err;\n      }\n    }\n    if (!description?.trim()) {\n      throw new Error(\n        `No image-understanding adapter could process an image.${lastErr instanceof Error ? ` Last error: ${lastErr.message}` : ''}`,\n      );\n    }\n    convertedImages++;\n    out.push({\n      type: 'text',\n      text: `[Image ${convertedImages} analyzed via ${adapterName ?? 'vision adapter'}]\\n${description.trim()}`,\n    });\n  }\n\n  return { blocks: out, route: 'adapter', convertedImages, adapterName };\n}\n\nasync function resolveAdapters(adapters: VisionAdapters | undefined): Promise<readonly VisionAdapter[]> {\n  if (!adapters) return [];\n  return typeof adapters === 'function' ? await adapters() : adapters;\n}\n\nexport interface ToolVisionAdapterOptions {\n  prompt?: string;\n}\n\nexport function createToolVisionAdapters(\n  registry: ToolRegistry,\n  opts: ToolVisionAdapterOptions = {},\n): VisionAdapter[] {\n  return registry\n    .list()\n    .filter(isLikelyVisionTool)\n    .map((tool) => ({\n      name: tool.name,\n      async describe(input: VisionAdapterInput): Promise<string> {\n        const currentTool = registry.get(tool.name);\n        if (!currentTool) {\n          throw new Error(`Tool \"${tool.name}\" is no longer registered`);\n        }\n        const built = await buildToolPayload(currentTool, input.image, input.prompt ?? opts.prompt);\n        if (!built) {\n          throw new Error(`Tool \"${currentTool.name}\" does not expose a supported image input schema`);\n        }\n        try {\n          const result = await currentTool.execute(built.payload, input.ctx, {\n            signal: input.signal,\n          });\n          return stringifyToolResult(result);\n        } finally {\n          await built.cleanup?.();\n        }\n      },\n    }));\n}\n\nfunction isLikelyVisionTool(tool: Tool): boolean {\n  if (tool.permission !== 'auto' || tool.mutating) return false;\n  const haystack = `${tool.name} ${tool.description ?? ''} ${tool.usageHint ?? ''}`.toLowerCase();\n  if (/(generate|create|draw|paint|edit|upscale|remove|write|delete)/.test(haystack)) return false;\n  if (!/(vision|image|screenshot|ocr|describe|analy[sz]e)/.test(haystack)) return false;\n  const props = schemaProperties(tool);\n  return [\n    'image',\n    'base64',\n    'data',\n    'url',\n    'image_url',\n    'imageUrl',\n    'path',\n    'image_path',\n    'imagePath',\n    'image_url',\n    'imageUrl',\n    'file_path',\n    'filePath',\n    'filename',\n    'file',\n    'mediaType',\n    'mimeType',\n  ].some((key) => key in props);\n}\n\nasync function buildToolPayload(\n  tool: Tool,\n  image: ImageBlock,\n  prompt = 'Describe this image for a coding agent. Include visible text, UI state, errors, layout, and any details needed to answer the user.',\n): Promise<{ payload: Record<string, unknown>; cleanup?: () => Promise<void> } | null> {\n  const props = schemaProperties(tool);\n  const payload: Record<string, unknown> = {};\n  const mediaType = image.source.media_type ?? 'image/png';\n  const data = image.source.data;\n  const url = image.source.url;\n  let cleanup: (() => Promise<void>) | undefined;\n\n  const pathKey = firstPresent(props, [\n    'path',\n    'image_path',\n    'imagePath',\n    'image_url',\n    'imageUrl',\n    'file_path',\n    'filePath',\n    'filename',\n    'file',\n  ]);\n  if (pathKey && image.source.type === 'base64' && data) {\n    const p = await writeTempImage(data, mediaType);\n    payload[pathKey] = p;\n    cleanup = async () => {\n      await fs.unlink(p).catch(() => undefined);\n      await fs.rmdir(path.dirname(p)).catch(() => undefined);\n    };\n  } else if ('image' in props) {\n    payload.image =\n      image.source.type === 'base64'\n        ? { type: 'base64', mediaType, media_type: mediaType, data }\n        : { type: 'url', url };\n  } else if (image.source.type === 'base64' && 'base64' in props) {\n    payload.base64 = data;\n  } else if (image.source.type === 'base64' && 'data' in props) {\n    payload.data = data;\n  } else if (image.source.type === 'url' && 'url' in props) {\n    payload.url = url;\n  } else if (image.source.type === 'url' && 'image_url' in props) {\n    payload.image_url = url;\n  } else if (image.source.type === 'url' && 'imageUrl' in props) {\n    payload.imageUrl = url;\n  } else {\n    return null;\n  }\n\n  if ('mediaType' in props) payload.mediaType = mediaType;\n  if ('mimeType' in props) payload.mimeType = mediaType;\n  if ('media_type' in props) payload.media_type = mediaType;\n  if ('prompt' in props) payload.prompt = prompt;\n  if ('query' in props) payload.query = prompt;\n  if ('instruction' in props) payload.instruction = prompt;\n  return { payload, cleanup };\n}\n\nfunction firstPresent(props: Record<string, unknown>, keys: string[]): string | undefined {\n  return keys.find((key) => key in props);\n}\n\nasync function writeTempImage(data: string, mediaType: string): Promise<string> {\n  const ext = mediaType.includes('jpeg') || mediaType.includes('jpg') ? 'jpg' : 'png';\n  const dir = await fs.mkdtemp(path.join(os.tmpdir(), 'wstack-vision-'));\n  const file = path.join(dir, `image.${ext}`);\n  await fs.writeFile(file, data, 'base64');\n  return file;\n}\n\nfunction schemaProperties(tool: Tool): Record<string, unknown> {\n  const schema = tool.inputSchema;\n  if (!schema || typeof schema !== 'object') return {};\n  const props = (schema as { properties?: unknown }).properties;\n  return props && typeof props === 'object' ? (props as Record<string, unknown>) : {};\n}\n\nfunction stringifyToolResult(value: unknown): string {\n  if (typeof value === 'string') return value;\n  if (Array.isArray(value)) {\n    return value\n      .map((item) => {\n        if (item && typeof item === 'object' && 'text' in item) {\n          return String((item as { text?: unknown }).text ?? '');\n        }\n        return typeof item === 'string' ? item : JSON.stringify(item);\n      })\n      .join('\\n');\n  }\n  if (value && typeof value === 'object' && 'text' in value) {\n    return String((value as { text?: unknown }).text ?? '');\n  }\n  return JSON.stringify(value);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrongstack/runtime",
-  "version": "0.2.0",
+  "version": "0.3.3",
   "license": "MIT",
   "description": "WrongStack default runtime implementations and host-level composition helpers built on @wrongstack/core.",
   "repository": {
@@ -28,6 +28,14 @@
       "types": "./dist/host.d.ts",
       "import": "./dist/host.js"
     },
+    "./vision": {
+      "types": "./dist/vision.d.ts",
+      "import": "./dist/vision.js"
+    },
+    "./clipboard": {
+      "types": "./dist/clipboard.d.ts",
+      "import": "./dist/clipboard.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -35,7 +43,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@wrongstack/core": "0.3.1"
+    "@wrongstack/core": "0.3.3"
   },
   "devDependencies": {
     "@types/node": "^22.19.19",