u-foo 3.0.1 → 3.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u-foo",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "description": "Multi-Agent Workspace Protocol. Just add u. claude → uclaude, codex → ucodex.",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://ufoo.dev",

package/src/agents/prompts/native/tasks.js

@@ -11,7 +11,10 @@ function getDoingTasksSection() {
  - Don't add error handling, fallbacks, or validation for scenarios that can't happen. Trust internal code and framework guarantees. Only validate at system boundaries (user input, external APIs).
  - Don't create helpers, utilities, or abstractions for one-time operations. Three similar lines of code is better than a premature abstraction.
  - Follow workspace conventions and project instructions (AGENTS.md) when present.
- - Prefer concrete code edits and verifiable outcomes over explanations.`;
+ - Prefer concrete code edits and verifiable outcomes over explanations.
+ - For simple, single-goal work, execute directly with read/write/edit/bash.
+ - For complex work — multiple goals, several subsystems, long multi-step delivery, or clear parallel tracks — automatically decompose before diving in: split into concrete sub-objectives, then start one or more TaskRuns via task_run (standalone; no Plan Mode required). Use plan_graph only when durable dependencies, checkpoints, or a shared executable plan are needed.
+ - When decomposing, each TaskRun objective should be independently verifiable; prefer a few sharp tasks over one vague mega-task.`;
 }
 
 module.exports = { getDoingTasksSection };

package/src/agents/prompts/native/toolDescriptions/readImage.js

@@ -0,0 +1,23 @@
+"use strict";
+
+/**
+ * Tool description for read_image (workspace vision).
+ */
+
+const READ_IMAGE_TOOL_NAME = "read_image";
+
+function getReadImageToolDescription() {
+  return `Read an image file from the workspace so the model can see it.
+
+Usage notes:
+- The path parameter is relative to the workspace root.
+- Supports png, jpeg, gif, and webp. Max size ~5MB.
+- Use this instead of read for screenshots, UI mocks, diagrams, and other binary images.
+- Text files still use read. Do not call read_image on non-image files.
+- Vision is attached for the current model call only; call read_image again if you need the image later.`;
+}
+
+module.exports = {
+  READ_IMAGE_TOOL_NAME,
+  getReadImageToolDescription,
+};

package/src/app/chat/commandExecutor.js

@@ -166,6 +166,7 @@ function createCommandExecutor(options = {}) {
     sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
     schedule = (fn, ms) => setTimeout(fn, ms),
     clearLog = null,
+    fetchModelsImpl = null,
   } = options;
 
   if (!projectRoot) {
@@ -1623,7 +1624,35 @@ function createCommandExecutor(options = {}) {
       logMessage("system", `  • url: ${url || "(unset)"}`);
       logMessage("system", `  • key: ${maskSecret(key)}`);
       logMessage("system", `  • transport: ${transport} (auto)`);
+      try {
+        const { currentThinkingLevel } = require("../../code/modelCommand");
+        logMessage("system", `  • thinking: ${currentThinkingLevel({})}`);
+      } catch {
+        // ignore
+      }
       logMessage("system", "  • tip: url supports generic gateway base, transport is auto-detected");
+      try {
+        const { listUcodeModels } = require("../../code/modelCommand");
+        const listed = await listUcodeModels({
+          provider,
+          model,
+        }, {
+          workspaceRoot: getActiveProjectRoot() || projectRoot,
+          fetchImpl: fetchModelsImpl || undefined,
+        });
+        if (listed.ok && listed.models.length > 0) {
+          const sample = listed.models.slice(0, 10);
+          logMessage("system", `  • models route: ${listed.models.length} available`);
+          logMessage("system", `  • models: ${sample.join(", ")}${listed.models.length > 10 ? "…" : ""}`);
+          if (model && !listed.models.includes(model)) {
+            logMessage("system", `  • warning: configured model "${model}" is not in the provider catalog`);
+          }
+        } else if (listed.error) {
+          logMessage("system", `  • models route: ${listed.error}`);
+        }
+      } catch (err) {
+        logMessage("system", `  • models route: ${err && err.message ? err.message : "unavailable"}`);
+      }
       return;
     }
 
@@ -1645,6 +1674,52 @@ function createCommandExecutor(options = {}) {
         logMessage("error", "{white-fg}✗{/white-fg} Usage: /settings ucode set provider=<openai|anthropic> model=<id> url=<baseUrl> key=<apiKey>");
         return;
       }
+
+      // Preview the config that would apply after this set, then confirm the
+      // model id against the provider /models route when a model is present.
+      const preview = {
+        ...(loadUcodeConfig() || {}),
+        ...updates,
+      };
+      const modelToConfirm = String(preview.ucodeModel || "").trim();
+      if (modelToConfirm) {
+        try {
+          const { confirmModelSupported } = require("../../code/providers/modelsCatalog");
+          const { resolveRuntimeConfig } = require("../../code/nativeRunner");
+          const runtime = resolveRuntimeConfig({
+            workspaceRoot: getActiveProjectRoot() || projectRoot,
+            provider: preview.ucodeProvider || "",
+            model: modelToConfirm,
+          });
+          // Prefer the previewed url/key over env-only resolution so a single
+          // set line that changes url+model validates against the new gateway.
+          const confirmation = await confirmModelSupported({
+            provider: runtime.provider,
+            transport: inferUcodeTransport(preview.ucodeProvider, preview.ucodeBaseUrl || runtime.baseUrl),
+            baseUrl: String(preview.ucodeBaseUrl || runtime.baseUrl || "").trim(),
+            apiKey: String(preview.ucodeApiKey || runtime.apiKey || "").trim(),
+            model: modelToConfirm,
+            strict: false,
+            fetchImpl: fetchModelsImpl || undefined,
+          });
+          if (!confirmation.allowed) {
+            logMessage("error", `{white-fg}✗{/white-fg} ${escapeBlessed(confirmation.error || "model not supported")}`);
+            if (confirmation.models && confirmation.models.length > 0) {
+              const sample = confirmation.models.slice(0, 10).join(", ");
+              logMessage("system", `  • available: ${escapeBlessed(sample)}${confirmation.models.length > 10 ? "…" : ""}`);
+            }
+            return;
+          }
+          if (confirmation.warning) {
+            logMessage("system", `{gray-fg}note:{/gray-fg} ${escapeBlessed(confirmation.warning)}`);
+          } else if (confirmation.ok) {
+            logMessage("system", `{gray-fg}models route:{/gray-fg} confirmed ${escapeBlessed(modelToConfirm)}`);
+          }
+        } catch (err) {
+          logMessage("system", `{gray-fg}note:{/gray-fg} models route check skipped (${escapeBlessed(err && err.message ? err.message : "unavailable")})`);
+        }
+      }
+
       saveUcodeConfig(updates);
       logMessage("system", "{white-fg}✓{/white-fg} ucode config updated (global)");
       if (Object.prototype.hasOwnProperty.call(updates, "ucodeProvider")) {
@@ -1664,6 +1739,41 @@ function createCommandExecutor(options = {}) {
       return;
     }
 
+    if (action === "models") {
+      try {
+        const { listUcodeModels } = require("../../code/modelCommand");
+        const config = loadUcodeConfig() || {};
+        const listed = await listUcodeModels({
+          provider: config.ucodeProvider || "",
+          model: config.ucodeModel || "",
+        }, {
+          workspaceRoot: getActiveProjectRoot() || projectRoot,
+          skipCache: true,
+          fetchImpl: fetchModelsImpl || undefined,
+        });
+        if (!listed.ok) {
+          logMessage("error", `{white-fg}✗{/white-fg} ${escapeBlessed(listed.error || "models route failed")}`);
+          if (listed.url) logMessage("system", `  • url: ${escapeBlessed(listed.url)}`);
+          return;
+        }
+        logMessage("system", `{cyan-fg}ucode models:{/cyan-fg} ${listed.models.length} from ${escapeBlessed(listed.url)}`);
+        if (listed.models.length === 0) {
+          logMessage("system", "  • (empty catalog)");
+          return;
+        }
+        listed.models.slice(0, 40).forEach((id) => {
+          const current = String(config.ucodeModel || "").trim() === id ? " {gray-fg}(current){/gray-fg}" : "";
+          logMessage("system", `  • ${escapeBlessed(id)}${current}`);
+        });
+        if (listed.models.length > 40) {
+          logMessage("system", `  • … ${listed.models.length - 40} more`);
+        }
+      } catch (err) {
+        logMessage("error", `{white-fg}✗{/white-fg} ${escapeBlessed(err && err.message ? err.message : "models route failed")}`);
+      }
+      return;
+    }
+
     if (action === "clear") {
       const fieldsRaw = args.slice(1).map((item) => String(item || "").trim().toLowerCase()).filter(Boolean);
       const fields = fieldsRaw.length === 0 ? ["all"] : fieldsRaw;
@@ -1682,7 +1792,7 @@ function createCommandExecutor(options = {}) {
       return;
     }
 
-    logMessage("error", "{white-fg}✗{/white-fg} Unknown settings ucode action. Use: show, set, clear");
+    logMessage("error", "{white-fg}✗{/white-fg} Unknown settings ucode action. Use: show, set, models, clear");
   }
 
   async function executeCommand(text) {

package/src/app/chat/commands.js

@@ -135,7 +135,8 @@ const COMMAND_TREE = {
         children: {
           show: { desc: "Show ucode provider/model/url/key", order: 1 },
           set: { desc: "Set ucode provider/model/url/key", order: 2 },
-          clear: { desc: "Clear ucode provider/model/url/key", order: 3 },
+          models: { desc: "List models from the provider /models route", order: 3 },
+          clear: { desc: "Clear ucode provider/model/url/key", order: 4 },
         },
       },
     },

package/src/app/chat/daemonMessageRouter.js

@@ -416,7 +416,7 @@ function createDaemonMessageRouter(options = {}) {
       const publisher = report.agent_id || data.publisher || "ufoo-agent";
       const displayName = resolveAgentDisplayName(publisher);
       const detail = report.summary || report.message || data.message || report.task_id || "report";
-      logMessage("bus", `${speakerPrefix(displayName)}${escapeBlessed(detail)}`);
+      logMessage("report", `${speakerPrefix(displayName)}${escapeBlessed(detail)}`, data);
       requestStatus();
       renderScreen();
       return true;

package/src/app/chat/inputSubmitHandler.js

@@ -33,8 +33,9 @@ function createInputSubmitHandler(options = {}) {
 
   function userEcho(text, targetLabel = "") {
     const body = escapeBlessed(text);
-    if (!targetLabel) return body;
-    return `{magenta-fg}@${escapeBlessed(targetLabel)}{/magenta-fg} ${body}`;
+    // Match ucode › prompt echo so history reload and live log share a prefix.
+    if (!targetLabel) return `› ${body}`;
+    return `› {magenta-fg}@${escapeBlessed(targetLabel)}{/magenta-fg} ${body}`;
   }
 
   async function tryActivateTargetAgent(agentId) {

package/src/code/commands.js

@@ -7,7 +7,7 @@
 const UCODE_COMMAND_REGISTRY = [
   { cmd: "/help", desc: "Show available commands", order: 10 },
   { cmd: "/status", desc: "Show session / usage status", order: 20 },
-  { cmd: "/model", desc: "Show or switch the active model", order: 25 },
+  { cmd: "/model", desc: "Show or switch model (+ thinking intensity)", order: 25 },
   { cmd: "/plan", desc: "Show plan progress or set plan mode", order: 27 },
   { cmd: "/ubus", desc: "Check pending bus messages", order: 30 },
   { cmd: "/resume", desc: "Resume a saved session", order: 40 },
@@ -20,7 +20,7 @@ const UCODE_COMMAND_TREE = {
   "/help": { desc: "Show available commands" },
   "/status": { desc: "Show session / usage status" },
   "/model": {
-    desc: "Show or switch the active model",
+    desc: "Show or switch model, then pick thinking intensity",
     hasArguments: true,
     optionalArguments: true,
   },
@@ -59,7 +59,7 @@ function listUcodeCommandsForHelp() {
     "  /exit|/quit",
     "  /ubus",
     "  /status",
-    "  /model [model-id]",
+    "  /model [model-id] [off|low|medium|high|max]",
     "  /plan [on|off|show|hide|focus|debug|clear]",
     "  /skills [list]",
     "  /skills show <name>",

package/src/code/context/assembler.js

@@ -34,6 +34,7 @@ const {
 const { renderExecutionSegmentContext } = require("./executionSegment");
 const { renderPlanModeContext } = require("./planMode");
 const { drainAgentMailboxForTurn } = require("../runtime/agentWakeup");
+const { stripVisionBase64, degradeVisionContent } = require("../providers/visionBlocks");
 
 const DEFAULT_TRANSCRIPT_WINDOW = 12;
 const DEFAULT_RECENT_TOOL_EVENTS = 4;
@@ -291,6 +292,19 @@ function sanitizeModelMessages(messages = []) {
       continue;
     }
 
+    // Drop ephemeral OpenAI vision companion user messages (image_url data URIs)
+    // when rebuilding history so base64 does not re-enter later turns.
+    if (role === "user" && Array.isArray(message.content)) {
+      const hasImageUrl = message.content.some((block) => (
+        block && String(block.type || "").trim().toLowerCase() === "image_url"
+      ));
+      if (hasImageUrl) {
+        const degraded = degradeVisionContent(message.content);
+        out.push({ role: "user", content: degraded });
+        continue;
+      }
+    }
+
     out.push(message);
   }
   return out;
@@ -435,16 +449,18 @@ function persistToolResultToContext({
   rawResult = {},
   segmentId = "",
 } = {}) {
+  const rawForStorage = stripVisionBase64(rawResult);
   const saved = saveArtifact(workspaceRoot, sessionId, {
     type: "tool_result",
     tool,
     args,
-    raw: rawResult,
+    raw: rawForStorage,
     createdBy: tool,
   });
   const artifactId = saved.artifact && saved.artifact.artifactId
     ? saved.artifact.artifactId
     : "";
+  // Reduce from the live result so vision base64 stays available for this turn.
   const reduced = reduceToolResult(tool, rawResult, artifactId, args);
   return {
     artifactId,

package/src/code/context/planMode.js

@@ -181,7 +181,7 @@ function formatPlanModeStatus(executionState = null) {
     lines.push("Rules while ON:");
     lines.push("  - Use plan_graph to create/expand/complete the plan");
     lines.push("  - write / edit / bash are blocked as direct tools");
-    lines.push("  - read / artifact_read allowed for exploration");
+    lines.push("  - read / read_image / artifact_read allowed for exploration");
     lines.push("  - Runtime auto-advances ready tool nodes after plan_graph");
     lines.push("  - User leaves with /plan off (agents cannot toggle Plan Mode)");
   } else {
@@ -223,7 +223,7 @@ function renderPlanModeContext(executionState = null) {
   }
 
   lines.push(
-    "Allowed direct tools: read, artifact_read, plan_graph, ask_user.",
+    "Allowed direct tools: read, read_image, artifact_read, plan_graph, ask_user.",
     "Blocked direct tools: write, edit, bash (route them as plan_graph tool nodes or task_loop).",
     "Plan Mode constrains the Agent Loop only; running TaskLoops are not paused or reconfigured by /plan off.",
     "Only the user can leave Plan Mode (/plan off). That does not cancel the graph or TaskRuns — use cancel_graph / control.cancel_task.",

package/src/code/context/promptLayers.js

@@ -31,7 +31,7 @@ const {
 } = require("../skills");
 const { hashContent } = require("./artifacts");
 
-const PROMPT_VERSION = "native-v5";
+const PROMPT_VERSION = "native-v7";
 
 function buildImmutablePrefix() {
   return [
@@ -44,22 +44,24 @@ function buildImmutablePrefix() {
     getOutputEfficiencySection(),
     [
       "Tool calling grammar:",
-      "- Use read, write, edit, bash, and artifact_read for direct work, even when it takes several tool calls. Use plan_graph only when the work needs a durable semantic/executable plan, explicit dependencies or checkpoints, or asynchronous TaskRuns.",
-      "- Plan Mode is a runtime posture for the Agent Loop, not an agent tool. While Plan Mode is ON, direct write, edit, and bash calls from the Agent Loop are blocked; read and artifact_read remain available.",
+      "- Use read, write, edit, bash, and artifact_read for direct, single-goal text work, even when it takes several tool calls.",
+      "- Use read_image to load workspace png/jpeg/gif/webp images for vision. Do not use read on binary images. Vision is attached for the active model call only; call read_image again if you need the image later.",
+      "- TaskRuns are orthogonal to Plan Mode. A TaskRun does not require Plan Mode or a plan_graph. Use task_run operation=start with an objective for a standalone single-point TaskRun; it starts asynchronously and returns immediately.",
+      "- On complex or multi-goal requests, automatically decompose into concrete sub-objectives and start TaskRun(s) via task_run. Prefer task_run for independent or loosely coupled tracks; use plan_graph only when you need durable dependencies, checkpoints, or a shared executable plan.",
+      "- Use plan_graph for durable graph structure: create, patch, inspect, cancel_graph, and control. Graph-bound TaskRuns use plan_graph control.start_task on execution.kind=task_loop nodes.",
+      "- Plan Mode is a runtime posture for the Agent Loop, not an agent tool. While Plan Mode is ON, direct write, edit, and bash calls from the Agent Loop are blocked; read, read_image, and artifact_read remain available. TaskRuns still run independently of Plan Mode.",
       "- In the Agent Loop, plan_graph operation=create automatically enables Plan Mode. The user may also use /plan on or /plan off.",
-      "- Turning Plan Mode off does not cancel an existing graph or running TaskRuns. Use plan_graph operation=cancel_graph or operation=control with cancel_task to stop them.",
+      "- Turning Plan Mode off does not cancel an existing graph or running TaskRuns. Cancel with task_run (standalone) or plan_graph operation=cancel_graph / control.cancel_task (graph-bound).",
       "- When the user enables Plan Mode and no active graph exists, create a plan_graph before performing side effects.",
-      "- Use plan_graph for durable graph structure and TaskRun lifecycle: create, patch, inspect, cancel_graph, and control.",
       "- After an accepted plan_graph create or patch, Runtime automatically advances ready tool nodes. Never invent or request an execute_graph tool.",
-      "- Do not call plan_graph together with read, write, edit, bash, or artifact_read in the same assistant turn.",
+      "- Do not call plan_graph or task_run together with read, read_image, write, edit, bash, or artifact_read in the same assistant turn.",
       "- When an active graph is waiting on a task, advance that node through plan_graph instead of bypassing it with direct workspace tools: use patch.expand_node for execution.kind=expand, control.complete_task (nodeId) for execution.kind=inline_llm, or control.start_task for execution.kind=task_loop.",
-      "- control.complete_task with nodeId completes a waiting_llm inline_llm task for the current Graph owner. control.complete_task with taskRunId is reserved for the owning TaskLoop. Do not directly complete expand or aggregate tasks.",
-      "- While Plan Mode is ON, workspace mutations must be represented as plan_graph tool nodes or performed inside a running task_loop.",
+      "- control.complete_task with nodeId completes a waiting_llm inline_llm task for the current Graph owner. control.complete_task with taskRunId (or task_run complete) is reserved for the owning TaskLoop. Do not directly complete expand or aggregate tasks.",
+      "- While Plan Mode is ON, workspace mutations must be represented as plan_graph tool nodes or performed inside a running TaskRun/task_loop.",
       "- Treat a User reminder as the latest user instruction. Reconcile it before continuing from tool results. If it is compatible with the active plan, resume the waiting plan node; otherwise patch, cancel, or replan first.",
-      "- Use execution.kind=task_loop for work that should continue asynchronously without occupying the Agent Loop. plan_graph operation=control action=start_task starts the TaskRun and returns immediately.",
       "- TaskLoops do not consume User reminders. The Agent Loop is woken by runtime task_started, task_succeeded, task_failed, and task_cancelled events.",
       "- Runtime enforces TaskRun concurrency limits and workspace write leases. Direct Agent write, edit, or bash calls may be rejected while writing TaskRuns are active.",
-      "- Tool results may contain an artifactId. Use artifact_read to hydrate raw stored output or a slice of it; use read for workspace file paths.",
+      "- Tool results may contain an artifactId. Use artifact_read to hydrate raw stored output or a slice of it; use read for workspace text paths; use read_image for workspace images.",
       "- Use ask_user only when user input is required to proceed. It must be the only tool call in the turn. Use kind=approval for yes/no confirmation, kind=choice for numbered options, and kind=chat for free text.",
       "- The answer to ask_user is returned only as that tool's result, not as a separate user message or pending User reminder. Continue from the returned answer and do not repeat the question.",
       "- ask_user is available only to the Agent Loop. It pauses the Agent Loop, but running TaskRuns continue unless explicitly cancelled.",

package/src/code/context/reducers.js

@@ -287,9 +287,43 @@ function reduceArtifactReadResult(raw = {}, artifactId = "") {
   };
 }
 
+function reduceReadImageResult(raw = {}, artifactId = "") {
+  const source = raw && typeof raw === "object" ? raw : {};
+  const pathText = String(source.path || "").trim();
+  const mediaType = String(source.mediaType || "").trim();
+  const bytes = Number.isFinite(source.bytes) ? source.bytes : null;
+  const preview = source.ok === false
+    ? clipText(String(source.error || "read_image failed"), PREVIEW_MAX_CHARS)
+    : clipText(
+      `image ${pathText || "file"} (${mediaType || "unknown"}, ${bytes != null ? `${bytes} bytes` : "size?"})`,
+      PREVIEW_MAX_CHARS,
+    );
+  const modelPayload = {
+    ok: source.ok !== false,
+    kind: "image",
+    artifactId,
+    path: pathText,
+    mediaType,
+    bytes,
+    preview,
+  };
+  if (source.error) modelPayload.error = String(source.error);
+  // Keep base64 in the in-memory model payload for the current turn only.
+  // Artifacts / transcript strip it via stripVisionBase64 before persistence.
+  if (modelPayload.ok && source.base64) {
+    modelPayload.base64 = String(source.base64);
+  }
+  return {
+    preview,
+    summary: `read_image ${pathText || "file"} (${mediaType || "image"})`,
+    modelPayload,
+  };
+}
+
 function reduceToolResult(tool = "", raw = {}, artifactId = "", args = {}) {
   const name = String(tool || "").trim().toLowerCase();
   if (name === "read") return reduceReadResult(raw, artifactId);
+  if (name === "read_image") return reduceReadImageResult(raw, artifactId);
   if (name === "bash") return reduceBashResult(raw, artifactId, args);
   if (name === "write") return reduceWriteResult(raw, artifactId);
   if (name === "edit") return reduceEditResult(raw, artifactId);
@@ -318,6 +352,7 @@ module.exports = {
   parseSearchMatches,
   reduceToolResult,
   reduceReadResult,
+  reduceReadImageResult,
   reduceBashResult,
   reduceTestResult,
   reduceGitDiffResult,

package/src/code/context/transcriptSync.js

@@ -5,6 +5,7 @@ const {
   createTranscriptEventId,
   appendTranscriptEvent,
 } = require("./transcript");
+const { stripVisionBase64, degradeVisionContent } = require("../providers/visionBlocks");
 
 function messageRole(message = {}) {
   return String(message && message.role || "").trim().toLowerCase();
@@ -35,6 +36,24 @@ function parseToolArtifactContent(content = "") {
   }
 }
 
+function contentForStorage(content) {
+  if (typeof content === "string") return content;
+  if (Array.isArray(content)) {
+    const hasVision = content.some((block) => {
+      if (!block || typeof block !== "object") return false;
+      const type = String(block.type || "").trim().toLowerCase();
+      return type === "image" || type === "image_url"
+        || (type === "tool_result" && Array.isArray(block.content));
+    });
+    if (hasVision) return degradeVisionContent(stripVisionBase64(content));
+    return stripVisionBase64(content);
+  }
+  if (content && typeof content === "object") {
+    return stripVisionBase64(content);
+  }
+  return content;
+}
+
 function messageToTranscriptEventForStorage(message = {}, extra = {}) {
   if (!message || typeof message !== "object") return null;
   const role = messageRole(message);
@@ -60,9 +79,10 @@ function messageToTranscriptEventForStorage(message = {}, extra = {}) {
         toolCallId: message.tool_call_id ? String(message.tool_call_id) : undefined,
       });
     }
-    const preview = typeof message.content === "string"
-      ? message.content.slice(0, 600)
-      : JSON.stringify(message.content).slice(0, 600);
+    const stored = contentForStorage(message.content);
+    const preview = typeof stored === "string"
+      ? stored.slice(0, 600)
+      : JSON.stringify(stored).slice(0, 600);
     return normalizeTranscriptEvent({
       ...base,
       role: "tool",
@@ -75,14 +95,14 @@ function messageToTranscriptEventForStorage(message = {}, extra = {}) {
   if (role === "assistant" && Array.isArray(message.tool_calls) && message.tool_calls.length > 0) {
     return normalizeTranscriptEvent({
       ...base,
-      content: message.content,
+      content: contentForStorage(message.content),
       toolCalls: message.tool_calls,
     });
   }
 
   return normalizeTranscriptEvent({
     ...base,
-    content: message.content,
+    content: contentForStorage(message.content),
   });
 }
 

package/src/code/dispatch.js

@@ -1,31 +1,37 @@
 "use strict";
 
 const { runReadTool } = require("./tools/read");
+const { runReadImageTool } = require("./tools/readImage");
 const { runWriteTool } = require("./tools/write");
 const { runEditTool } = require("./tools/edit");
 const { runBashTool } = require("./tools/bash");
 const { runArtifactReadTool } = require("./tools/artifactRead");
 const { runPlanGraphTool } = require("./tools/planGraph");
+const { runTaskRunTool } = require("./tools/taskRun");
 const { runAskUserTool } = require("./tools/askUser");
 
 const TOOL_NAMES = [
   "read",
+  "read_image",
   "write",
   "edit",
   "bash",
   "artifact_read",
   "plan_graph",
+  "task_run",
   "ask_user",
 ];
 
 function normalizeToolName(value = "") {
   const text = String(value || "").trim().toLowerCase();
   if (text === "read") return "read";
+  if (text === "read_image" || text === "read-image" || text === "readimage") return "read_image";
   if (text === "write") return "write";
   if (text === "edit") return "edit";
   if (text === "bash") return "bash";
   if (text === "artifact_read" || text === "artifact-read" || text === "artifactread") return "artifact_read";
   if (text === "plan_graph" || text === "plan-graph" || text === "plangraph") return "plan_graph";
+  if (text === "task_run" || text === "task-run" || text === "taskrun") return "task_run";
   if (text === "ask_user" || text === "ask-user" || text === "askuser") return "ask_user";
   return "";
 }
@@ -41,10 +47,12 @@ function runToolCall(input = {}, options = {}) {
     };
   }
   if (tool === "read") return runReadTool(args, options);
+  if (tool === "read_image") return runReadImageTool(args, options);
   if (tool === "write") return runWriteTool(args, options);
   if (tool === "edit") return runEditTool(args, options);
   if (tool === "artifact_read") return runArtifactReadTool(args, options);
   if (tool === "plan_graph") return runPlanGraphTool(args, options);
+  if (tool === "task_run") return runTaskRunTool(args, options);
   if (tool === "ask_user") return runAskUserTool(args, options);
   return runBashTool(args, options);
 }