omnius 1.0.368 → 1.0.370

package/dist/index.js

@@ -9629,6 +9629,14 @@ var init_vision = __esm({
             type: "string",
             description: "Path to the image file (PNG, JPG, GIF, WebP, BMP, TIFF)"
           },
+          path: {
+            type: "string",
+            description: "Alias for image path"
+          },
+          file: {
+            type: "string",
+            description: "Alias for image path"
+          },
           action: {
             type: "string",
             enum: ["caption", "query", "detect", "point"],
@@ -9664,13 +9672,13 @@ var init_vision = __esm({
       }
       async execute(args) {
         const start2 = performance.now();
-        const rawPath = args["image"];
+        const rawPath = args["image"] ?? args["path"] ?? args["file"];
         const action = args["action"] ?? "caption";
         const prompt = args["prompt"];
         const length4 = args["length"] ?? "normal";
         const preferredModel = normalizeVisionModelName(args["model"]);
         if (!rawPath) {
-          return { success: false, output: "", error: "image path is required", durationMs: 0 };
+          return { success: false, output: "", error: "image path is required (accepted keys: image, path, file)", durationMs: 0 };
         }
         if ((action === "query" || action === "detect" || action === "point") && !prompt) {
           return {
@@ -35488,11 +35496,13 @@ var init_image = __esm({
     ImageReadTool = class {
       workingDir;
       name = "image_read";
-      description = "Read an image file and return its base64 encoding, dimensions, and OCR text extraction. The base64 data can be used for multimodal model input. Supports: PNG, JPG, GIF, WebP, BMP, TIFF, SVG.";
+      description = "Read an image file and return its base64 encoding, dimensions, and OCR text extraction. The base64 data can be used for multimodal model input. For semantic visual understanding, object/person identification, or captions, prefer vision first (Moondream) and use image_read for metadata/OCR/raw image ingress. Supports: PNG, JPG, GIF, WebP, BMP, TIFF, SVG.";
       parameters = {
         type: "object",
         properties: {
           path: { type: "string", description: "Path to the image file" },
+          file: { type: "string", description: "Alias for path" },
+          image: { type: "string", description: "Alias for path" },
           ocr: { type: "boolean", description: "Extract text via OCR (default: true if tesseract available)" },
           max_size_kb: { type: "number", description: "Maximum file size in KB to read (default: 10240 = 10MB)" }
         },
@@ -35503,11 +35513,11 @@ var init_image = __esm({
       }
       async execute(args) {
         const start2 = Date.now();
-        const rawPath = String(args["path"] ?? "");
+        const rawPath = String(args["path"] ?? args["file"] ?? args["image"] ?? "");
         const doOcr = args["ocr"] !== false;
         const maxSizeKb = typeof args["max_size_kb"] === "number" ? args["max_size_kb"] : 10240;
         if (!rawPath) {
-          return { success: false, output: "", error: "path is required", durationMs: 0 };
+          return { success: false, output: "", error: "path is required (accepted keys: path, file, image)", durationMs: 0 };
         }
         const fullPath = resolve19(this.workingDir, rawPath);
         if (!existsSync31(fullPath)) {
@@ -269267,8 +269277,8 @@ var require_pattern = __commonJS({
     }
     exports.endsWithSlashGlobStar = endsWithSlashGlobStar;
     function isAffectDepthOfReadingPattern(pattern) {
-      const basename39 = path12.basename(pattern);
-      return endsWithSlashGlobStar(pattern) || isStaticPattern(basename39);
+      const basename40 = path12.basename(pattern);
+      return endsWithSlashGlobStar(pattern) || isStaticPattern(basename40);
     }
     exports.isAffectDepthOfReadingPattern = isAffectDepthOfReadingPattern;
     function expandPatternsWithBraceExpansion(patterns) {
@@ -273144,7 +273154,7 @@ print("${sentinel}")
         if (!this.proc || this.proc.killed) {
           return { success: false, path: "" };
         }
-        const { mkdirSync: mkdirSync106, writeFileSync: writeFileSync91 } = await import("node:fs");
+        const { mkdirSync: mkdirSync106, writeFileSync: writeFileSync90 } = await import("node:fs");
         const sessionDir2 = join43(this.cwd, ".omnius", "rlm");
         mkdirSync106(sessionDir2, { recursive: true });
         const sessionPath2 = join43(sessionDir2, "session.json");
@@ -273170,7 +273180,7 @@ print("__SESSION__" + json.dumps(_session) + "__SESSION__")
               trajectoryCount: this.trajectory.length,
               subCallCount: this.subCallCount
             };
-            writeFileSync91(sessionPath2, JSON.stringify(sessionData, null, 2), "utf8");
+            writeFileSync90(sessionPath2, JSON.stringify(sessionData, null, 2), "utf8");
             return { success: true, path: sessionPath2 };
           }
         } catch {
@@ -273789,7 +273799,7 @@ ${issues.map((i2) => `  - ${i2}`).join("\n")}` : "  No issues found."),
       /** Update memory scores based on task outcome. Called after task completion.
        *  Memories used in successful tasks get boosted. Memories present during failures get decayed. */
       updateFromOutcomeSync(surfacedMemoryText, succeeded) {
-        const { readFileSync: readFileSync133, writeFileSync: writeFileSync91, existsSync: existsSync164, mkdirSync: mkdirSync106 } = __require("node:fs");
+        const { readFileSync: readFileSync133, writeFileSync: writeFileSync90, existsSync: existsSync164, mkdirSync: mkdirSync106 } = __require("node:fs");
         const metaDir = join44(this.cwd, ".omnius", "memory", "metabolism");
         const storeFile = join44(metaDir, "store.json");
         if (!existsSync164(storeFile))
@@ -273821,7 +273831,7 @@ ${issues.map((i2) => `  - ${i2}`).join("\n")}` : "  No issues found."),
         }
         if (updated) {
           mkdirSync106(metaDir, { recursive: true });
-          writeFileSync91(storeFile, JSON.stringify(store2, null, 2));
+          writeFileSync90(storeFile, JSON.stringify(store2, null, 2));
         }
       }
       // ── Storage ──────────────────────────────────────────────────────────
@@ -274267,7 +274277,7 @@ Recommendation: Strategy ${scored[0].index + 1} scores highest.`;
       }
       /** Archive a strategy variant synchronously (for task completion path) */
       archiveVariantSync(strategy, outcome, tags = []) {
-        const { readFileSync: readFileSync133, writeFileSync: writeFileSync91, existsSync: existsSync164, mkdirSync: mkdirSync106 } = __require("node:fs");
+        const { readFileSync: readFileSync133, writeFileSync: writeFileSync90, existsSync: existsSync164, mkdirSync: mkdirSync106 } = __require("node:fs");
         const dir = join46(this.cwd, ".omnius", "arche");
         const archiveFile = join46(dir, "variants.json");
         let variants = [];
@@ -274289,7 +274299,7 @@ Recommendation: Strategy ${scored[0].index + 1} scores highest.`;
         if (variants.length > 50)
           variants = variants.slice(-50);
         mkdirSync106(dir, { recursive: true });
-        writeFileSync91(archiveFile, JSON.stringify(variants, null, 2));
+        writeFileSync90(archiveFile, JSON.stringify(variants, null, 2));
       }
       async saveArchive(variants) {
         const dir = join46(this.cwd, ".omnius", "arche");
@@ -295142,7 +295152,13 @@ var init_todo_write = __esm({
 - completed: fully done (tests pass, code works, goal met)
 - blocked: stuck on a dependency (include blocker text)
 
-Mark tasks complete IMMEDIATELY after finishing — don't batch. Never mark completed if tests are failing or implementation is partial. The user watches this list in the chat UI in real time. Canonical call shape: todo_write({"todos":[{"content":"Inspect files","status":"in_progress"},{"content":"Make changes","status":"pending"},{"content":"Verify results","status":"pending"}]})`;
+## Nested decomposition
+- Use stable ids plus parentId to create subtasks under a parent objective.
+- Work on leaf subtasks; a parent is completed only after every child is completed with evidence.
+- When evidence changes the plan, rewrite the tree: add new child todos, block invalidated children with root cause, and keep the parent in_progress/blocked until the child set is truthful.
+- If a tool fails for a child, do not mark that child completed. Reconfigure it: re-read/observe current state, choose a different target/tool, or leave it blocked.
+
+Mark tasks complete IMMEDIATELY after finishing — don't batch. Never mark completed if tests are failing or implementation is partial. The user watches this list in the chat UI in real time. Canonical call shape: todo_write({"todos":[{"id":"p1","content":"Implement feature","status":"in_progress"},{"id":"c1","parentId":"p1","content":"Inspect files","status":"in_progress"},{"id":"c2","parentId":"p1","content":"Make changes","status":"pending"},{"id":"c3","parentId":"p1","content":"Verify results","status":"pending"}]})`;
       parameters = {
         type: "object",
         required: ["todos"],
@@ -295160,7 +295176,7 @@ Mark tasks complete IMMEDIATELY after finishing — don't batch. Never mark comp
                   type: "string",
                   enum: ["pending", "in_progress", "completed", "blocked"]
                 },
-                parentId: { type: "string", description: "Parent todo id for sub-tasks" },
+                parentId: { type: "string", description: "Parent todo id for nested sub-tasks. Parents summarize objectives; children carry concrete implementation/verification work. Never complete a parent until every child is completed with evidence." },
                 blocker: { type: "string", description: "Reason this is blocked (status=blocked only)" },
                 verifyCommand: {
                   type: "string",
@@ -295277,6 +295293,7 @@ Mark tasks complete IMMEDIATELY after finishing — don't batch. Never mark comp
           const reminder = "Todos have been modified successfully. Ensure that you continue to use the todo list to track your progress. Mark the current task in_progress and the next task pending. Proceed with the current task.";
           const payload = {
             reminder,
+            decompositionContract: "Use parentId for sub-todos. Keep parents in_progress/blocked until all children are completed with objective evidence. When tool evidence invalidates a child, rewrite that child as blocked or split it into new children instead of overclaiming completion.",
             oldTodos: result.oldTodos,
             newTodos: result.newTodos,
             verificationNudgeNeeded
@@ -295285,9 +295302,10 @@ Mark tasks complete IMMEDIATELY after finishing — don't batch. Never mark comp
             payload["inputRepair"] = Array.from(new Set(repairNotes));
             payload["canonicalShape"] = {
               todos: [
-                { content: "Inspect files", status: "in_progress" },
-                { content: "Make changes", status: "pending" },
-                { content: "Verify results", status: "pending" }
+                { id: "p1", content: "Implement the requested change", status: "in_progress" },
+                { id: "c1", parentId: "p1", content: "Inspect files", status: "in_progress" },
+                { id: "c2", parentId: "p1", content: "Make changes", status: "pending" },
+                { id: "c3", parentId: "p1", content: "Verify results", status: "pending" }
               ]
             };
           }
@@ -321828,9 +321846,9 @@ ${lanes.join("\n")}
       function isJsonEqual(a2, b) {
         return a2 === b || typeof a2 === "object" && a2 !== null && typeof b === "object" && b !== null && equalOwnProperties(a2, b, isJsonEqual);
       }
-      function parsePseudoBigInt(stringValue2) {
+      function parsePseudoBigInt(stringValue3) {
         let log2Base;
-        switch (stringValue2.charCodeAt(1)) {
+        switch (stringValue3.charCodeAt(1)) {
           // "x" in "0x123"
           case 98:
           case 66:
@@ -321845,19 +321863,19 @@ ${lanes.join("\n")}
             log2Base = 4;
             break;
           default:
-            const nIndex = stringValue2.length - 1;
+            const nIndex = stringValue3.length - 1;
             let nonZeroStart = 0;
-            while (stringValue2.charCodeAt(nonZeroStart) === 48) {
+            while (stringValue3.charCodeAt(nonZeroStart) === 48) {
               nonZeroStart++;
             }
-            return stringValue2.slice(nonZeroStart, nIndex) || "0";
+            return stringValue3.slice(nonZeroStart, nIndex) || "0";
         }
-        const startIndex = 2, endIndex = stringValue2.length - 1;
+        const startIndex = 2, endIndex = stringValue3.length - 1;
         const bitsNeeded = (endIndex - startIndex) * log2Base;
         const segments = new Uint16Array((bitsNeeded >>> 4) + (bitsNeeded & 15 ? 1 : 0));
         for (let i2 = endIndex - 1, bitOffset = 0; i2 >= startIndex; i2--, bitOffset += log2Base) {
           const segment = bitOffset >>> 4;
-          const digitChar = stringValue2.charCodeAt(i2);
+          const digitChar = stringValue3.charCodeAt(i2);
           const digit = digitChar <= 57 ? digitChar - 48 : 10 + digitChar - (digitChar <= 70 ? 65 : 97);
           const shiftedDigit = digit << (bitOffset & 15);
           segments[segment] |= shiftedDigit;
@@ -435385,9 +435403,9 @@ ${lanes.join("\n")}
             /*ignoreCase*/
             false
           )) {
-            const basename39 = getBaseFileName(a2.fileName);
-            if (basename39 === "lib.d.ts" || basename39 === "lib.es6.d.ts") return 0;
-            const name10 = removeSuffix(removePrefix(basename39, "lib."), ".d.ts");
+            const basename40 = getBaseFileName(a2.fileName);
+            if (basename40 === "lib.d.ts" || basename40 === "lib.es6.d.ts") return 0;
+            const name10 = removeSuffix(removePrefix(basename40, "lib."), ".d.ts");
             const index = libs.indexOf(name10);
             if (index !== -1) return index + 1;
           }
@@ -499313,8 +499331,8 @@ ${options2.prefix}` : "\n" : options2.prefix
             }
           };
           for (const file of files) {
-            const basename39 = getBaseFileName(file);
-            if (basename39 === "package.json" || basename39 === "bower.json") {
+            const basename40 = getBaseFileName(file);
+            if (basename40 === "package.json" || basename40 === "bower.json") {
               createProjectWatcher(
                 file,
                 "FileWatcher"
@@ -502998,8 +503016,8 @@ All files are: ${JSON.stringify(names)}`,
               var _a;
               const fileOrDirectoryPath = removeIgnoredPath(this.toPath(fileOrDirectory));
               if (!fileOrDirectoryPath) return;
-              const basename39 = getBaseFileName(fileOrDirectoryPath);
-              if (((_a = result.affectedModuleSpecifierCacheProjects) == null ? void 0 : _a.size) && (basename39 === "package.json" || basename39 === "node_modules")) {
+              const basename40 = getBaseFileName(fileOrDirectoryPath);
+              if (((_a = result.affectedModuleSpecifierCacheProjects) == null ? void 0 : _a.size) && (basename40 === "package.json" || basename40 === "node_modules")) {
                 result.affectedModuleSpecifierCacheProjects.forEach((project) => {
                   var _a2;
                   (_a2 = project.getModuleSpecifierCache()) == null ? void 0 : _a2.clear();
@@ -511902,7 +511920,7 @@ var require_path_browserify = __commonJS({
         if (hasRoot && end === 1) return "//";
         return path12.slice(0, end);
       },
-      basename: function basename39(path12, ext) {
+      basename: function basename40(path12, ext) {
         if (ext !== void 0 && typeof ext !== "string") throw new TypeError('"ext" argument must be a string');
         assertPath(path12);
         var start2 = 0;
@@ -546577,6 +546595,32 @@ ${content.slice(0, 500)}`,
   }
 });
 
+// packages/execution/dist/tools/clip-feature-python.js
+var CLIP_FEATURE_HELPERS_PY;
+var init_clip_feature_python = __esm({
+  "packages/execution/dist/tools/clip-feature-python.js"() {
+    "use strict";
+    CLIP_FEATURE_HELPERS_PY = `
+def _omnius_feature_tensor(features):
+    if hasattr(features, "image_embeds"):
+        return features.image_embeds
+    if hasattr(features, "text_embeds"):
+        return features.text_embeds
+    if hasattr(features, "pooler_output"):
+        return features.pooler_output
+    if hasattr(features, "last_hidden_state"):
+        return features.last_hidden_state[:, 0]
+    if isinstance(features, (tuple, list)):
+        return features[0]
+    return features
+
+def _omnius_normalized_features(features):
+    tensor = _omnius_feature_tensor(features)
+    return tensor / tensor.norm(dim=-1, keepdim=True)
+`;
+  }
+});
+
 // packages/execution/dist/tools/visual-memory.js
 import { execSync as execSync39 } from "node:child_process";
 import { existsSync as existsSync66, mkdirSync as mkdirSync39, writeFileSync as writeFileSync31, readFileSync as readFileSync48 } from "node:fs";
@@ -546587,33 +546631,123 @@ function visualMemoryPythonEnv(extra = {}) {
   applyMediaCudaDeviceFilterToEnv(env2, "vision");
   return env2;
 }
-var VMEM_DIR, VENV_DIR2, VENV_PY, VENV_PIP2, VisualMemoryTool;
+function stringArg2(args, ...keys) {
+  for (const key of keys) {
+    const value2 = args[key];
+    if (typeof value2 === "string" && value2.trim())
+      return value2.trim();
+  }
+  return "";
+}
+function stringListArg(value2) {
+  if (Array.isArray(value2)) {
+    return value2.filter((item) => typeof item === "string" && item.trim().length > 0).map((item) => item.trim());
+  }
+  if (typeof value2 === "string" && value2.trim())
+    return [value2.trim()];
+  return [];
+}
+function imagePathArg(args) {
+  return stringArg2(args, "image", "path", "file", "media");
+}
+function associationLabelArg(args) {
+  return stringArg2(args, "name", "label", "title", "object", "person") || stringListArg(args["labels"])[0] || stringListArg(args["aliases"])[0] || "";
+}
+function pyLiteral(value2) {
+  return JSON.stringify(value2);
+}
+function normalizeVisualMemoryAction(args) {
+  const raw = stringArg2(args, "action").toLowerCase();
+  if (!raw) {
+    if (imagePathArg(args) && associationLabelArg(args))
+      return "teach";
+    if (imagePathArg(args))
+      return "recognize";
+    return "";
+  }
+  if (raw === "learn" || raw === "remember" || raw === "associate")
+    return "teach";
+  if (raw === "score" || raw === "classify")
+    return "describe";
+  return raw;
+}
+function summarizeProcessFailure(stdout, stderr) {
+  const normalize2 = (text2) => text2.replace(/\r/g, "\n").split("\n").map((line) => line.trim()).filter(Boolean);
+  const stderrLines = normalize2(stderr);
+  const stdoutLines = normalize2(stdout);
+  const tagged = [
+    ...stderrLines.map((line) => `stderr: ${line}`),
+    ...stdoutLines.map((line) => `stdout: ${line}`)
+  ];
+  if (tagged.length === 0)
+    return "Vision ML script failed";
+  const exceptionRe = /(?:^|\s)(?:[A-Za-z_][\w.]*Error|[A-Za-z_][\w.]*Exception|AssertionError|KeyboardInterrupt|SystemExit):\s+.+$/;
+  const tracebackIdx = tagged.findIndex((line) => /Traceback \(most recent call last\):/.test(line));
+  const exceptionLine = [...stderrLines, ...stdoutLines].slice().reverse().find((line) => exceptionRe.test(line) && !/\bwarning:/i.test(line));
+  const parts = [];
+  if (exceptionLine) {
+    parts.push(`Root cause: ${exceptionLine}`);
+  }
+  if (tracebackIdx >= 0) {
+    parts.push("Traceback:");
+    parts.push(...tagged.slice(tracebackIdx).slice(0, 18));
+  }
+  const tail = tagged.slice(-24);
+  for (const line of tail) {
+    if (!parts.includes(line))
+      parts.push(line);
+  }
+  return parts.join("\n").slice(0, 2200);
+}
+var VMEM_DIR, VENV_DIR2, VENV_PY, VENV_PIP2, VISUAL_MEMORY_ACTIONS, VisualMemoryTool;
 var init_visual_memory = __esm({
   "packages/execution/dist/tools/visual-memory.js"() {
     "use strict";
     init_cuda_device_filter();
+    init_clip_feature_python();
     VMEM_DIR = join80(homedir20(), ".omnius", "visual-memory");
     VENV_DIR2 = join80(homedir20(), ".omnius", "vision-ml-venv");
     VENV_PY = join80(VENV_DIR2, "bin", "python3");
     VENV_PIP2 = join80(VENV_DIR2, "bin", "pip");
+    VISUAL_MEMORY_ACTIONS = /* @__PURE__ */ new Set(["detect", "enroll", "identify", "teach", "recognize", "describe", "list", "forget"]);
     VisualMemoryTool = class {
       name = "visual_memory";
-      description = "Persistent visual memory — recognize faces and objects across sessions. FACE actions: 'detect' faces in image, 'enroll' a person (name + photo), 'identify' known faces. OBJECT actions: 'teach' an object (label + photo), 'recognize' taught objects. MEMORY actions: 'list' all enrolled faces/objects, 'forget' a person/object. Use this to remember people, learn to recognize tools/items, and build persistent visual knowledge about the physical environment. Works with camera_capture output.";
+      description = "Persistent visual memory — automatically associate names/labels with images and recognize familiar faces/objects across sessions. When a user, filename, manifest, or surrounding text provides a name or label for a new image, call teach/enroll immediately to store that association. If an image is unlabeled, call vision first for a Moondream caption, then recognize/identify against this memory; ask the user for a label only when the identity is still unknown. FACE actions: 'detect' faces in image, 'enroll' a person (name + photo), 'identify' known faces. OBJECT actions: 'teach' an object (label + photo), 'recognize' taught objects, 'describe' CLIP scores for candidate labels. MEMORY actions: 'list' all enrolled faces/objects, 'forget' a person/object. Use this to remember people, learn to recognize tools/items, and build persistent visual knowledge about the physical environment. Works with camera_capture output.";
       parameters = {
         type: "object",
         properties: {
           action: {
             type: "string",
-            enum: ["detect", "enroll", "identify", "teach", "recognize", "list", "forget"],
-            description: "Action: detect/enroll/identify faces, teach/recognize objects, list/forget memory"
+            enum: ["detect", "enroll", "identify", "teach", "recognize", "describe", "list", "forget"],
+            description: "Action: detect/enroll/identify faces, teach/recognize/describe objects, list/forget memory. If omitted with image+label/name, teach is inferred; with image only, recognize is inferred."
           },
           image: {
             type: "string",
-            description: "Path to image file (JPEG/PNG). Required for detect/enroll/identify/teach/recognize."
+            description: "Path to image file (JPEG/PNG). Required for detect/enroll/identify/teach/recognize/describe."
+          },
+          path: {
+            type: "string",
+            description: "Alias for image path."
+          },
+          file: {
+            type: "string",
+            description: "Alias for image path."
+          },
+          media: {
+            type: "string",
+            description: "Alias for image path."
           },
           name: {
             type: "string",
-            description: "Person name (for 'enroll') or object label (for 'teach'). Required for enrollment."
+            description: "Person name (for 'enroll') or object label (for 'teach')."
+          },
+          label: {
+            type: "string",
+            description: "Alias for name when teaching an object or enrolling a person from an associated label."
+          },
+          title: {
+            type: "string",
+            description: "Alias for name/label when a manifest or metadata title identifies the visual subject."
           },
           id: {
             type: "string",
@@ -546630,15 +546764,23 @@ var init_visual_memory = __esm({
           },
           labels: {
             type: "array",
-            description: "Text labels to score against image (for CLIP 'recognize' or 'describe').",
+            description: "Candidate text labels to score against image for CLIP recognize/describe. For teach, labels[0] is accepted as the object label when name/label is omitted.",
+            items: { type: "string" }
+          },
+          aliases: {
+            type: "array",
+            description: "Additional label aliases. aliases[0] is accepted as the primary label when name/label/labels are omitted.",
             items: { type: "string" }
           }
         },
-        required: ["action"]
+        required: []
       };
       async execute(args) {
-        const action = args["action"];
+        const action = normalizeVisualMemoryAction(args);
         const start2 = performance.now();
+        if (!VISUAL_MEMORY_ACTIONS.has(action)) {
+          return { success: false, output: "", error: `Unknown action: ${action || "(none)"}. Use teach with image+name/label to remember, recognize with image to recall, or vision first for unlabeled semantic captioning.`, durationMs: performance.now() - start2 };
+        }
         if (!await this.ensureVenv()) {
           return { success: false, output: "", error: "Could not set up vision ML environment. Needs Python 3.10+.", durationMs: performance.now() - start2 };
         }
@@ -546656,6 +546798,11 @@ var init_visual_memory = __esm({
               return await this.teachObject(args, start2);
             case "recognize":
               return await this.recognizeObjects(args, start2);
+            case "describe":
+              return await this.recognizeObjects({
+                ...args,
+                threshold: typeof args["threshold"] === "number" ? args["threshold"] : -1
+              }, start2);
             case "list":
               return await this.listMemory(start2);
             case "forget":
@@ -546671,7 +546818,7 @@ var init_visual_memory = __esm({
       // Face Detection
       // =========================================================================
       async detectFaces(args, start2) {
-        const image = args["image"];
+        const image = imagePathArg(args);
         if (!image || !existsSync66(image)) {
           return { success: false, output: "", error: "Provide a valid image path.", durationMs: performance.now() - start2 };
         }
@@ -546684,7 +546831,7 @@ app = FaceAnalysis(name='buffalo_s', providers=['CUDAExecutionProvider', 'CPUExe
 app.prepare(ctx_id=0, det_size=(640, 640))
 
 import cv2
-img = cv2.imread("${image}")
+img = cv2.imread(${pyLiteral(image)})
 if img is None:
     print(json.dumps({"success": False, "error": "Could not read image"}))
     sys.exit(0)
@@ -546716,8 +546863,8 @@ ${JSON.stringify(result.faces, null, 2)}`, durationMs: performance.now() - start
       // Face Enrollment
       // =========================================================================
       async enrollFace(args, start2) {
-        const image = args["image"];
-        const name10 = args["name"];
+        const image = imagePathArg(args);
+        const name10 = associationLabelArg(args);
         if (!image || !existsSync66(image))
           return { success: false, output: "", error: "Provide a valid image path.", durationMs: performance.now() - start2 };
         if (!name10)
@@ -546730,7 +546877,7 @@ app = FaceAnalysis(name='buffalo_s', providers=['CUDAExecutionProvider', 'CPUExe
 app.prepare(ctx_id=0, det_size=(640, 640))
 
 import cv2
-img = cv2.imread("${image}")
+img = cv2.imread(${pyLiteral(image)})
 if img is None:
     print(json.dumps({"success": False, "error": "Could not read image"}))
     sys.exit(0)
@@ -546751,9 +546898,9 @@ if os.path.exists(db_path):
     with open(db_path) as f:
         db = json.load(f)
 
-person_id = "${name10}".lower().replace(" ", "_").replace("'", "")
+person_id = ${pyLiteral(name10)}.lower().replace(" ", "_").replace("'", "")
 if person_id not in db:
-    db[person_id] = {"name": "${name10}", "embeddings": [], "created_at": time.time()}
+    db[person_id] = {"name": ${pyLiteral(name10)}, "embeddings": [], "created_at": time.time()}
 
 db[person_id]["embeddings"].append(embedding)
 db[person_id]["updated_at"] = time.time()
@@ -546765,7 +546912,7 @@ with open(db_path, "w") as f:
 print(json.dumps({
     "success": True,
     "person_id": person_id,
-    "name": "${name10}",
+    "name": ${pyLiteral(name10)},
     "samples": sample_count,
     "total_people": len(db),
     "confidence": float(face.det_score),
@@ -546786,7 +546933,7 @@ print(json.dumps({
       // Face Identification
       // =========================================================================
       async identifyFaces(args, start2) {
-        const image = args["image"];
+        const image = imagePathArg(args);
         if (!image || !existsSync66(image))
           return { success: false, output: "", error: "Provide a valid image path.", durationMs: performance.now() - start2 };
         const threshold = args["threshold"] || 0.5;
@@ -546799,7 +546946,7 @@ app = FaceAnalysis(name='buffalo_s', providers=['CUDAExecutionProvider', 'CPUExe
 app.prepare(ctx_id=0, det_size=(640, 640))
 
 import cv2
-img = cv2.imread("${image}")
+img = cv2.imread(${pyLiteral(image)})
 if img is None:
     print(json.dumps({"success": False, "error": "Could not read image"}))
     sys.exit(0)
@@ -546883,37 +547030,51 @@ ${lines.join("\n")}`,
       // Object Teaching (CLIP/SigLIP)
       // =========================================================================
       async teachObject(args, start2) {
-        const image = args["image"];
-        const label = args["name"];
+        const image = imagePathArg(args);
+        const label = associationLabelArg(args);
         if (!image || !existsSync66(image))
           return { success: false, output: "", error: "Provide a valid image path.", durationMs: performance.now() - start2 };
         if (!label)
           return { success: false, output: "", error: "Provide a label for the object.", durationMs: performance.now() - start2 };
+        const aliases = [...new Set([
+          label,
+          ...stringListArg(args["labels"]),
+          ...stringListArg(args["aliases"])
+        ].map((item) => item.trim()).filter(Boolean))];
         const result = await this.runVisionPython(`
-import json, sys, os, time
+import json, sys, os, time, hashlib
 import torch
 from PIL import Image
 from transformers import CLIPProcessor, CLIPModel
 
+${CLIP_FEATURE_HELPERS_PY}
+
+image_path = ${pyLiteral(image)}
+label = ${pyLiteral(label)}
+aliases = ${JSON.stringify(aliases)}
+with open(image_path, "rb") as f:
+    image_hash = hashlib.sha256(f.read()).hexdigest()
+
 # Use CLIP ViT-B/32 — good balance of speed and quality
 model = CLIPModel.from_pretrained("openai/clip-vit-base-patch32")
 processor = CLIPProcessor.from_pretrained("openai/clip-vit-base-patch32")
 
-img = Image.open("${image}").convert("RGB")
+img = Image.open(image_path).convert("RGB")
 inputs = processor(images=img, return_tensors="pt")
 with torch.no_grad():
-    image_features = model.get_image_features(**inputs)
-    image_features = image_features / image_features.norm(dim=-1, keepdim=True)
+    image_features = _omnius_normalized_features(model.get_image_features(**inputs))
 
 embedding = image_features[0].cpu().numpy().tolist()
 
-# Also embed the text label for cross-modal retrieval
-text_inputs = processor(text=["${label}"], return_tensors="pt", padding=True)
+# Also embed the text label and aliases for cross-modal retrieval
+text_inputs = processor(text=aliases, return_tensors="pt", padding=True)
 with torch.no_grad():
-    text_features = model.get_text_features(**text_inputs)
-    text_features = text_features / text_features.norm(dim=-1, keepdim=True)
+    text_features = _omnius_normalized_features(model.get_text_features(**text_inputs))
 
-text_embedding = text_features[0].cpu().numpy().tolist()
+text_embeddings = {}
+for i, alias in enumerate(aliases):
+    text_embeddings[alias] = text_features[i].cpu().numpy().tolist()
+text_embedding = text_embeddings[aliases[0]]
 
 # Store in object database
 db_path = "${VMEM_DIR}/objects.json"
@@ -546922,12 +547083,19 @@ if os.path.exists(db_path):
     with open(db_path) as f:
         db = json.load(f)
 
-obj_id = "${label}".lower().replace(" ", "_").replace("'", "")
+obj_id = label.lower().replace(" ", "_").replace("'", "")
 if obj_id not in db:
-    db[obj_id] = {"label": "${label}", "image_embeddings": [], "text_embedding": text_embedding, "created_at": time.time()}
+    db[obj_id] = {"label": label, "aliases": [], "image_embeddings": [], "image_hashes": [], "text_embeddings": {}, "text_embedding": text_embedding, "created_at": time.time()}
 
-db[obj_id]["image_embeddings"].append(embedding)
+existing_hashes = set(db[obj_id].get("image_hashes", []))
+duplicate_sample = image_hash in existing_hashes
+if not duplicate_sample:
+    db[obj_id].setdefault("image_embeddings", []).append(embedding)
+    db[obj_id].setdefault("image_hashes", []).append(image_hash)
 db[obj_id]["text_embedding"] = text_embedding  # update with latest
+db[obj_id].setdefault("text_embeddings", {}).update(text_embeddings)
+merged_aliases = list(dict.fromkeys([db[obj_id].get("label", label)] + db[obj_id].get("aliases", []) + aliases))
+db[obj_id]["aliases"] = merged_aliases
 db[obj_id]["updated_at"] = time.time()
 sample_count = len(db[obj_id]["image_embeddings"])
 
@@ -546937,10 +547105,12 @@ with open(db_path, "w") as f:
 print(json.dumps({
     "success": True,
     "object_id": obj_id,
-    "label": "${label}",
+    "label": label,
+    "aliases": merged_aliases,
     "samples": sample_count,
     "total_objects": len(db),
     "embedding_dim": len(embedding),
+    "duplicate_sample": duplicate_sample,
 }))
 `, 12e4);
         if (!result.success)
@@ -546949,7 +547119,9 @@ print(json.dumps({
           success: true,
           output: `Taught object "${result.label}" (ID: ${result.object_id})
   Samples: ${result.samples}
-  Embedding: ${result.embedding_dim}d CLIP vector
+  Aliases: ${(result.aliases || []).join(", ") || result.label}
+` + (result.duplicate_sample ? `  Duplicate sample skipped for same image hash
+` : "") + `  Embedding: ${result.embedding_dim}d CLIP vector
   Total objects in memory: ${result.total_objects}`,
           durationMs: performance.now() - start2
         };
@@ -546958,11 +547130,11 @@ print(json.dumps({
       // Object Recognition
       // =========================================================================
       async recognizeObjects(args, start2) {
-        const image = args["image"];
+        const image = imagePathArg(args);
         if (!image || !existsSync66(image))
           return { success: false, output: "", error: "Provide a valid image path.", durationMs: performance.now() - start2 };
-        const threshold = args["threshold"] || 0.3;
-        const extraLabels = args["labels"] || [];
+        const threshold = typeof args["threshold"] === "number" ? args["threshold"] : 0.3;
+        const extraLabels = stringListArg(args["labels"]);
         const wantsJson = args["format"] === "json" || args["json"] === true;
         const result = await this.runVisionPython(`
 import json, sys, os, numpy as np
@@ -546970,16 +547142,17 @@ import torch
 from PIL import Image
 from transformers import CLIPProcessor, CLIPModel
 
+${CLIP_FEATURE_HELPERS_PY}
+
 model = CLIPModel.from_pretrained("openai/clip-vit-base-patch32")
 processor = CLIPProcessor.from_pretrained("openai/clip-vit-base-patch32")
 
-img = Image.open("${image}").convert("RGB")
+img = Image.open(${pyLiteral(image)}).convert("RGB")
 
 # Get image embedding
 inputs = processor(images=img, return_tensors="pt")
 with torch.no_grad():
-    image_features = model.get_image_features(**inputs)
-    image_features = image_features / image_features.norm(dim=-1, keepdim=True)
+    image_features = _omnius_normalized_features(model.get_image_features(**inputs))
 
 query = image_features[0].cpu().numpy()
 
@@ -546994,13 +547167,30 @@ if os.path.exists(db_path):
 matches = []
 for obj_id, data in db.items():
     best_sim = -1
-    for emb in data["image_embeddings"]:
+    for emb in data.get("image_embeddings", []):
         sim = float(np.dot(query, np.array(emb, dtype=np.float32)))
         if sim > best_sim:
             best_sim = sim
 
-    # Also score against text label embedding
-    text_sim = float(np.dot(query, np.array(data["text_embedding"], dtype=np.float32)))
+    # Also score against all stored text label/alias embeddings
+    text_sim = -1
+    best_text_label = data.get("label", obj_id)
+    text_embeddings = data.get("text_embeddings")
+    if isinstance(text_embeddings, dict) and text_embeddings:
+        iterable = text_embeddings.items()
+    elif data.get("text_embedding") is not None:
+        iterable = [(data.get("label", obj_id), data["text_embedding"])]
+    else:
+        iterable = []
+    for alias, emb in iterable:
+        sim = float(np.dot(query, np.array(emb, dtype=np.float32)))
+        if sim > text_sim:
+            text_sim = sim
+            best_text_label = alias
+    if text_sim < 0:
+        text_sim = 0
+    if best_sim < 0:
+        best_sim = 0
 
     # Blend: 60% image similarity, 40% text similarity
     blended = 0.6 * best_sim + 0.4 * text_sim
@@ -547008,6 +547198,8 @@ for obj_id, data in db.items():
     matches.append({
         "object_id": obj_id,
         "label": data["label"],
+        "matched_alias": best_text_label,
+        "aliases": data.get("aliases", []),
         "image_similarity": round(best_sim, 3),
         "text_similarity": round(text_sim, 3),
         "blended_score": round(blended, 3),
@@ -547022,8 +547214,7 @@ extra_labels = ${JSON.stringify(extraLabels)}
 if extra_labels:
     text_inputs = processor(text=extra_labels, return_tensors="pt", padding=True)
     with torch.no_grad():
-        text_features = model.get_text_features(**text_inputs)
-        text_features = text_features / text_features.norm(dim=-1, keepdim=True)
+        text_features = _omnius_normalized_features(model.get_text_features(**text_inputs))
 
     for i, label in enumerate(extra_labels):
         sim = float(np.dot(query, text_features[i].cpu().numpy()))
@@ -547089,7 +547280,7 @@ ${objects.join("\n") || "  (none taught)"}`,
         };
       }
       async forgetEntry(args, start2) {
-        const id = (args["id"] || args["name"] || "").toLowerCase().replace(/\s/g, "_");
+        const id = stringArg2(args, "id", "name", "label").toLowerCase().replace(/\s/g, "_");
         if (!id)
           return { success: false, output: "", error: "Provide the ID or name of the person/object to forget.", durationMs: performance.now() - start2 };
         let removed = false;
@@ -547165,7 +547356,7 @@ ${objects.join("\n") || "  (none taught)"}`,
               }
             }
           }
-          throw new Error(stderr.slice(0, 300) || stdout.slice(0, 300) || "Vision ML script failed");
+          throw new Error(summarizeProcessFailure(stdout, stderr));
         }
       }
     };
@@ -547182,6 +547373,7 @@ var MM_DIR, MM_INDEX, MultimodalMemoryTool;
 var init_multimodal_memory = __esm({
   "packages/execution/dist/tools/multimodal-memory.js"() {
     "use strict";
+    init_clip_feature_python();
     MM_DIR = join81(homedir21(), ".omnius", "multimodal-episodes");
     MM_INDEX = join81(MM_DIR, "index.json");
     MultimodalMemoryTool = class {
@@ -547275,13 +547467,13 @@ var init_multimodal_memory = __esm({
 import json, torch
 from PIL import Image
 from transformers import CLIPProcessor, CLIPModel
+${CLIP_FEATURE_HELPERS_PY}
 model = CLIPModel.from_pretrained("openai/clip-vit-base-patch32")
 processor = CLIPProcessor.from_pretrained("openai/clip-vit-base-patch32")
 img = Image.open("${imagePath}").convert("RGB")
 inputs = processor(images=img, return_tensors="pt")
 with torch.no_grad():
-    features = model.get_image_features(**inputs)
-    features = features / features.norm(dim=-1, keepdim=True)
+    features = _omnius_normalized_features(model.get_image_features(**inputs))
 print(json.dumps(features[0].cpu().numpy().tolist()))
 `;
                 const scriptFile = join81(tmpdir17(), `mm-clip-${Date.now()}.py`);
@@ -547501,12 +547693,12 @@ Recall later: multimodal_memory action=recall query="${personName}"`,
             const clipTextScript = `
 import json, torch
 from transformers import CLIPProcessor, CLIPModel
+${CLIP_FEATURE_HELPERS_PY}
 model = CLIPModel.from_pretrained("openai/clip-vit-base-patch32")
 processor = CLIPProcessor.from_pretrained("openai/clip-vit-base-patch32")
 inputs = processor(text=["${query.replace(/"/g, '\\"').replace(/\n/g, " ")}"], return_tensors="pt", padding=True)
 with torch.no_grad():
-    features = model.get_text_features(**inputs)
-    features = features / features.norm(dim=-1, keepdim=True)
+    features = _omnius_normalized_features(model.get_text_features(**inputs))
 print(json.dumps(features[0].cpu().numpy().tolist()))
 `;
             const scriptFile = join81(tmpdir17(), `mm-clipq-${Date.now()}.py`);
@@ -558355,6 +558547,15 @@ function nowIso2(now2 = /* @__PURE__ */ new Date()) {
 function cleanText(value2, max = 600) {
   return String(value2 ?? "").replace(/\s+/g, " ").trim().slice(0, max);
 }
+function normalizeEvidencePath(value2) {
+  return String(value2 ?? "").trim().replace(/^file:\/\//i, "").replace(/\\/g, "/").replace(/\/+/g, "/").replace(/^\.\//, "");
+}
+function cleanTargetPaths(paths) {
+  if (!Array.isArray(paths))
+    return [];
+  const cleaned = paths.map(normalizeEvidencePath).filter((path12) => path12.length > 0).slice(0, 20);
+  return [...new Set(cleaned)];
+}
 function convertPipesToUnicode(text2) {
   return text2.replace(/\|/g, "│");
 }
@@ -558430,6 +558631,7 @@ function deriveClaimsFromProposedText(input) {
   });
 }
 function recordCompletionEvidence(ledger, evidence) {
+  const targetPaths = cleanTargetPaths(evidence.targetPaths);
   const entry = {
     id: evidence.id ?? nextId2("ev", ledger.evidence.length),
     kind: evidence.kind,
@@ -558437,7 +558639,8 @@ function recordCompletionEvidence(ledger, evidence) {
     summary: cleanText(evidence.summary, 1200),
     toolName: evidence.toolName,
     success: evidence.success,
-    rawRef: evidence.rawRef
+    rawRef: evidence.rawRef,
+    ...targetPaths.length > 0 ? { targetPaths } : {}
   };
   return {
     ...ledger,
@@ -558457,7 +558660,8 @@ function recordToolEvidence(ledger, input) {
     toolName: input.name,
     success: input.success,
     summary,
-    rawRef: input.rawRef
+    rawRef: input.rawRef,
+    targetPaths: input.targetPaths
   });
 }
 function addCompletionClaims(ledger, claims) {
@@ -558596,6 +558800,55 @@ function isMutationEvidence(entry) {
     return true;
   return entry.success === true && /^(file_write|file_edit|file_patch|batch_edit)$/.test(entry.toolName ?? "");
 }
+function evidenceTargetPaths(entry) {
+  const explicit = cleanTargetPaths(entry.targetPaths);
+  if (explicit.length > 0)
+    return explicit;
+  const paths = [];
+  if (entry.rawRef?.startsWith("file://")) {
+    paths.push(entry.rawRef.slice("file://".length));
+  }
+  const fileChange = entry.summary.match(/\bfile change:\s*([^\s,;]+)/i);
+  if (fileChange?.[1])
+    paths.push(fileChange[1]);
+  const quotedPathRe = /"(?:path|file_path|file|filename|filepath|filePath)"\s*:\s*"([^"]+)"/g;
+  for (const match of entry.summary.matchAll(quotedPathRe)) {
+    if (match[1])
+      paths.push(match[1]);
+  }
+  const loosePathRe = /\b(?:path|file_path|file|filename|filepath|filePath)=([^,\s}\]]+)/g;
+  for (const match of entry.summary.matchAll(loosePathRe)) {
+    if (match[1])
+      paths.push(match[1].replace(/^["']|["']$/g, ""));
+  }
+  return cleanTargetPaths(paths);
+}
+function pathsEquivalent(a2, b) {
+  const left = normalizeEvidencePath(a2);
+  const right = normalizeEvidencePath(b);
+  if (!left || !right)
+    return false;
+  return left === right || left.endsWith(`/${right}`) || right.endsWith(`/${left}`);
+}
+function isVerificationNeutralPath(path12) {
+  const normalized = normalizeEvidencePath(path12).toLowerCase();
+  const base3 = normalized.split("/").pop() ?? normalized;
+  if (/\.(md|mdx|markdown|txt|rst|adoc)$/.test(base3))
+    return true;
+  if (/^(readme|changelog|changes|license|licence|notice|implementation_notes)(?:\.[^.]+)?$/.test(base3))
+    return true;
+  if (normalized.includes("/docs/") || normalized.startsWith("docs/"))
+    return true;
+  return false;
+}
+function isVerificationInvalidatingMutation(entry) {
+  if (!isMutationEvidence(entry))
+    return false;
+  const paths = evidenceTargetPaths(entry);
+  if (paths.length === 0)
+    return true;
+  return paths.some((path12) => !isVerificationNeutralPath(path12));
+}
 function isSuccessfulVerificationEvidence(entry) {
   if (entry.success !== true)
     return false;
@@ -558627,14 +558880,72 @@ function isStaleEditEvidence(entry) {
   const text2 = entry.summary.toLowerCase();
   return /stale edit loop blocked|old[_ -]?string|old text|expected[_ -]?hash|context mismatch|no occurrences|could not find/.test(text2);
 }
+function staleEditResolvedByLaterMutation(evidence, failedEntry, failedIndex) {
+  const failedPaths = evidenceTargetPaths(failedEntry);
+  if (failedPaths.length === 0)
+    return false;
+  for (const later of evidence.slice(failedIndex + 1)) {
+    if (!isMutationEvidence(later) || later.success !== true)
+      continue;
+    const laterPaths = evidenceTargetPaths(later);
+    if (laterPaths.some((laterPath) => failedPaths.some((failedPath) => pathsEquivalent(laterPath, failedPath)))) {
+      return true;
+    }
+  }
+  return false;
+}
+function extractClaimedAllTestsPassedCount(text2) {
+  const match = text2.match(/\ball\s+(\d{1,6})\s+tests?\s+(?:pass|passed|passing)\b/i);
+  return match?.[1] ? Number(match[1]) : null;
+}
+function extractObservedSuccessfulTestCount(text2) {
+  const normalized = text2.replace(/\s+/g, " ");
+  const testsPassed = normalized.match(/\btests?\s+(\d{1,6})\s+passed\b/i);
+  if (testsPassed?.[1])
+    return Number(testsPassed[1]);
+  const testsLine = normalized.match(/\btests?\s*:?\s*(\d{1,6})\b/i);
+  const passLine = normalized.match(/\bpass(?:ed)?\s*:?\s*(\d{1,6})\b/i);
+  if (testsLine?.[1])
+    return Number(testsLine[1]);
+  if (passLine?.[1])
+    return Number(passLine[1]);
+  const passedTests = normalized.match(/\b(\d{1,6})\s+tests?\s+passed\b/i);
+  if (passedTests?.[1])
+    return Number(passedTests[1]);
+  return null;
+}
+function latestObservedSuccessfulTestCount(evidence) {
+  for (let index = evidence.length - 1; index >= 0; index--) {
+    const entry = evidence[index];
+    if (entry.success !== true || verificationFamily(entry) !== "test")
+      continue;
+    const count = extractObservedSuccessfulTestCount(entry.summary);
+    if (count !== null && Number.isFinite(count))
+      return count;
+  }
+  return null;
+}
+function appendTestCountOverclaims(ledger, unresolved) {
+  const observed = latestObservedSuccessfulTestCount(ledger.evidence);
+  if (observed === null)
+    return unresolved;
+  let next = unresolved;
+  for (const claim of ledger.proposedClaims) {
+    const claimed = extractClaimedAllTestsPassedCount(claim.text);
+    if (claimed === null || claimed === observed)
+      continue;
+    next = appendUnresolved(next, `Completion claim overstates verification: claimed all ${claimed} tests pass, but latest successful test evidence reported ${observed}.`, claim.id);
+  }
+  return next;
+}
 function finalizeCompletionLedgerTruth(ledger) {
   let unresolved = [...ledger.unresolved];
-  let lastMutation = -1;
+  let lastVerificationInvalidatingMutation = -1;
   let lastVerification = -1;
   const lastSuccessfulVerificationByFamily = /* @__PURE__ */ new Map();
   ledger.evidence.forEach((entry, index) => {
-    if (isMutationEvidence(entry))
-      lastMutation = index;
+    if (isVerificationInvalidatingMutation(entry))
+      lastVerificationInvalidatingMutation = index;
     if (isSuccessfulVerificationEvidence(entry)) {
       lastVerification = index;
       const family = verificationFamily(entry);
@@ -558650,13 +558961,14 @@ function finalizeCompletionLedgerTruth(ledger) {
         unresolved = appendUnresolved(unresolved, `Verification failed or did not prove success: ${entry.summary}`, entry.id);
       }
     }
-    if (isStaleEditEvidence(entry)) {
+    if (isStaleEditEvidence(entry) && !staleEditResolvedByLaterMutation(ledger.evidence, entry, index)) {
       unresolved = appendUnresolved(unresolved, `Stale edit failure remains unresolved: ${entry.summary}`, entry.id);
     }
   });
-  if (lastVerification >= 0 && lastMutation > lastVerification) {
+  if (lastVerification >= 0 && lastVerificationInvalidatingMutation > lastVerification) {
     unresolved = appendUnresolved(unresolved, "File changes occurred after the last successful verification; final verification is stale.", "verification_freshness");
   }
+  unresolved = appendTestCountOverclaims(ledger, unresolved);
   const status = ledger.status === "blocked" || ledger.status === "request_changes" ? ledger.status : unresolved.length > 0 ? "incomplete_verification" : ledger.status;
   return {
     ...ledger,
@@ -564299,12 +564611,12 @@ var init_reflectionBuffer = __esm({
         if (!this.persistPath)
           return;
         try {
-          const { writeFileSync: writeFileSync91, mkdirSync: mkdirSync106, existsSync: existsSync164 } = __require("node:fs");
+          const { writeFileSync: writeFileSync90, mkdirSync: mkdirSync106, existsSync: existsSync164 } = __require("node:fs");
           const { join: join179 } = __require("node:path");
           const dir = join179(this.persistPath, "..");
           if (!existsSync164(dir))
             mkdirSync106(dir, { recursive: true });
-          writeFileSync91(this.persistPath, JSON.stringify(this.state, null, 2));
+          writeFileSync90(this.persistPath, JSON.stringify(this.state, null, 2));
         } catch {
         }
       }
@@ -566961,7 +567273,6 @@ function normalizeFailurePatterns(patterns) {
   });
 }
 function buildFailureModeHandoff(input) {
-  const patterns = normalizeFailurePatterns(input.errorPatterns).slice(0, input.maxPatterns ?? 10);
   const toolCalls = input.toolCallLog ?? [];
   const maxRecentCalls = input.maxRecentCalls ?? 8;
   const recentCalls = maxRecentCalls > 0 ? toolCalls.slice(-maxRecentCalls) : [];
@@ -566973,6 +567284,7 @@ function buildFailureModeHandoff(input) {
   const currentStep = cleanInline(input.taskState?.currentStep, 180);
   const nextAction = cleanInline(input.taskState?.nextAction, 180);
   const goal = cleanInline(input.taskGoal || input.taskState?.goal || input.taskState?.originalGoal || "", 260);
+  const patterns = normalizeFailurePatterns(input.errorPatterns).slice(0, input.maxPatterns ?? 10);
   if (patterns.length === 0 && recentCalls.length === 0 && modified.length === 0 && failedApproaches.length === 0 && !goal) {
     return null;
   }
@@ -567915,12 +568227,12 @@ var init_adversaryStream = __esm({
         if (!this.persistPath)
           return;
         try {
-          const { writeFileSync: writeFileSync91, mkdirSync: mkdirSync106, existsSync: existsSync164 } = __require("node:fs");
+          const { writeFileSync: writeFileSync90, mkdirSync: mkdirSync106, existsSync: existsSync164 } = __require("node:fs");
           const { dirname: dirname54 } = __require("node:path");
           const dir = dirname54(this.persistPath);
           if (!existsSync164(dir))
             mkdirSync106(dir, { recursive: true });
-          writeFileSync91(this.persistPath, JSON.stringify({ ledger: this.ledger }, null, 2));
+          writeFileSync90(this.persistPath, JSON.stringify({ ledger: this.ledger }, null, 2));
         } catch {
         }
       }
@@ -567942,6 +568254,10 @@ function resolutionSystemPrompt() {
     "  - exit code 0 on an unrelated command does not resolve the request.",
     "  - Doing PART of the request, or adjacent work, is NOT resolution.",
     "  - If the request had multiple parts, EVERY part must be addressed.",
+    "  - If the original request explicitly allows a degraded fallback such as",
+    "    documenting/reporting a tool failure, that fallback can resolve the task",
+    "    only when the failure is clearly disclosed and the requested fallback",
+    "    artifact/report/verifier is evidenced.",
     "",
     "Respond with ONLY a JSON object, no prose, no code fences:",
     '{"resolved": true|false,',
@@ -567953,6 +568269,25 @@ function resolutionSystemPrompt() {
     "original request. When in doubt, resolved=false and name what is missing."
   ].join("\n");
 }
+function detectExplicitDegradedCompletion(i2) {
+  const original = i2.originalGoal.toLowerCase();
+  const summary = i2.proposedSummary.toLowerCase();
+  const evidence = `${i2.actionsDigest}
+${i2.evidenceDigest}`.toLowerCase();
+  const permitsFallback = /\bif\b[\s\S]{0,160}\b(?:fails?|failed|failure|blocked|unavailable|cannot|can't|unable)\b[\s\S]{0,180}\b(?:document|report|note|record|summari[sz]e|explain)\b/.test(original) || /\b(?:document|report|note|record|summari[sz]e|explain)\b[\s\S]{0,180}\b(?:fails?|failed|failure|blocked|unavailable|cannot|can't|unable)\b/.test(original) || /\b(?:fallback|degraded|best effort|best-effort|honestly document|document honestly)\b/.test(original);
+  if (!permitsFallback)
+    return null;
+  const disclosesFailure = /\b(?:fail(?:ed|ure)?|blocked|unable|could not|couldn't|cannot|can't|degraded|partial|not available|unavailable)\b/.test(summary);
+  if (!disclosesFailure)
+    return null;
+  const hasFallbackEvidence = /\b(?:passed|success|succeeded|verified|wrote|created|saved|report|artifact|file changed|files changed|last test outcome: passed|exit code 0)\b/.test(evidence) || /\b(?:verifier|verification|report)\b/.test(summary);
+  if (!hasFallbackEvidence)
+    return null;
+  return {
+    accepted: true,
+    reason: "original request explicitly allowed a degraded/failure-report fallback and the completion disclosed the failure with fallback evidence"
+  };
+}
 function buildResolutionPrompt(i2) {
   return [
     "ORIGINAL REQUEST (what the user actually asked for):",
@@ -568003,6 +568338,134 @@ var init_completion_resolution_verifier = __esm({
   }
 });
 
+// packages/orchestrator/dist/todoTruth.js
+function normalizeText2(value2) {
+  return value2.toLowerCase().replace(/[_-]+/g, " ").replace(/[^a-z0-9./ ]+/g, " ").replace(/\s+/g, " ").trim();
+}
+function extractArg(argsKey, key) {
+  if (!argsKey)
+    return "";
+  const re = new RegExp(`(?:^|,)${key}=([^,]+)`);
+  return argsKey.match(re)?.[1]?.trim() ?? "";
+}
+function toolAliases(toolName) {
+  const normalized = normalizeText2(toolName);
+  const spaceAlias = normalizeText2(toolName.replace(/_/g, " "));
+  const compactAlias = toolName.toLowerCase().replace(/[^a-z0-9]+/g, "");
+  return [...new Set([normalized, spaceAlias, compactAlias].filter(Boolean))];
+}
+function todoMentionsFailedCall(todo, call) {
+  if (NON_WORK_TOOLS.has(call.name))
+    return false;
+  const content = normalizeText2(todo.content);
+  const compactContent2 = todo.content.toLowerCase().replace(/[^a-z0-9]+/g, "");
+  const mentionsTool = toolAliases(call.name).some((alias) => {
+    if (alias.length <= 2)
+      return false;
+    if (/^[a-z0-9]+$/.test(alias) && alias === call.name.toLowerCase().replace(/[^a-z0-9]+/g, "")) {
+      return compactContent2.includes(alias);
+    }
+    return content.includes(alias);
+  });
+  if (!mentionsTool)
+    return false;
+  const action = normalizeText2(extractArg(call.argsKey, "action"));
+  if (!action)
+    return true;
+  return content.includes(action) || action.length <= 2;
+}
+function evidenceLine(call) {
+  const preview = String(call.outputPreview ?? "").split("\n").map((line) => line.trim()).find(Boolean);
+  const action = extractArg(call.argsKey, "action");
+  const detail = preview || "tool returned failure";
+  return `${call.name}${action ? ` ${action}` : ""}: ${detail}`.slice(0, 260);
+}
+function hasLaterSuccessForSameFamily(calls, failedIndex) {
+  const failed = calls[failedIndex];
+  if (!failed)
+    return false;
+  const failedAction = normalizeText2(extractArg(failed.argsKey, "action"));
+  for (let i2 = failedIndex + 1; i2 < calls.length; i2++) {
+    const next = calls[i2];
+    if (!next || next.success !== true || next.name !== failed.name)
+      continue;
+    const nextAction = normalizeText2(extractArg(next.argsKey, "action"));
+    if (!failedAction || !nextAction || failedAction === nextAction)
+      return true;
+  }
+  return false;
+}
+function firstUnresolvedChild(todo, childrenByParent) {
+  const id = todo.id;
+  if (!id)
+    return null;
+  const children2 = childrenByParent.get(id) ?? [];
+  return children2.find((child) => child.status === "blocked") ?? children2.find((child) => child.status === "in_progress") ?? children2.find((child) => child.status === "pending") ?? null;
+}
+function reconcileCompletedTodosWithEvidence(input) {
+  const nextTodos = input.todos.map((todo) => ({ ...todo }));
+  const downgrades = [];
+  const childrenByParent = /* @__PURE__ */ new Map();
+  for (const todo of nextTodos) {
+    if (!todo.parentId)
+      continue;
+    const arr = childrenByParent.get(todo.parentId) ?? [];
+    arr.push(todo);
+    childrenByParent.set(todo.parentId, arr);
+  }
+  for (const todo of nextTodos) {
+    if (todo.status !== "completed")
+      continue;
+    const unresolvedChild = firstUnresolvedChild(todo, childrenByParent);
+    if (unresolvedChild) {
+      const childStatus = unresolvedChild.status;
+      const targetStatus = childStatus === "blocked" ? "blocked" : "in_progress";
+      const blocker2 = childStatus === "blocked" ? `Child todo blocked: ${unresolvedChild.content}${unresolvedChild.blocker ? ` (${unresolvedChild.blocker})` : ""}` : `Child todo not complete: [${childStatus}] ${unresolvedChild.content}`;
+      downgrades.push({
+        id: todo.id,
+        content: todo.content,
+        from: "completed",
+        to: targetStatus,
+        blocker: blocker2,
+        evidence: blocker2
+      });
+      todo.status = targetStatus;
+      todo.blocker = blocker2;
+      continue;
+    }
+    const startTurn = todo.id && input.todoStartTurnById?.has(todo.id) ? input.todoStartTurnById.get(todo.id) : 0;
+    const relevantCalls = input.toolCallLog.filter((call) => (call.turn ?? 0) >= startTurn);
+    const failedIndex = relevantCalls.findIndex((call) => call.success === false && todoMentionsFailedCall(todo, call) && !hasLaterSuccessForSameFamily(relevantCalls, relevantCalls.indexOf(call)));
+    if (failedIndex < 0)
+      continue;
+    const failed = relevantCalls[failedIndex];
+    const evidence = evidenceLine(failed);
+    const blocker = `Completion claim contradicted by failed ${failed.name} evidence. Reconfigure this subtask: verify whether the goal is already satisfied, choose a different target/tool, or leave the todo blocked with the root cause.`;
+    downgrades.push({
+      id: todo.id,
+      content: todo.content,
+      from: "completed",
+      to: "blocked",
+      blocker,
+      evidence
+    });
+    todo.status = "blocked";
+    todo.blocker = `${blocker} Evidence: ${evidence}`;
+  }
+  return {
+    todos: nextTodos,
+    changed: downgrades.length > 0,
+    downgrades
+  };
+}
+var NON_WORK_TOOLS;
+var init_todoTruth = __esm({
+  "packages/orchestrator/dist/todoTruth.js"() {
+    "use strict";
+    NON_WORK_TOOLS = /* @__PURE__ */ new Set(["todo_write", "todo_read", "task_complete"]);
+  }
+});
+
 // packages/orchestrator/dist/evidenceBranch.js
 function buildStructuralPreview2(lines, path12, query) {
   const n2 = lines.length;
@@ -570209,6 +570672,7 @@ var init_agenticRunner = __esm({
     init_evidenceLedger();
     init_adversaryStream();
     init_completion_resolution_verifier();
+    init_todoTruth();
     init_evidenceBranch();
     init_resolution_memory();
     init_contextEngine();
@@ -570384,6 +570848,7 @@ var init_agenticRunner = __esm({
       // Research: Kumaran et al. (2016) — complementary learning systems
       //           Fast learning from errors → immediate behavioral change
       _errorPatterns = /* @__PURE__ */ new Map();
+      _taskRelevantErrorPatterns = /* @__PURE__ */ new Map();
       _errorGuidanceInjected = /* @__PURE__ */ new Set();
       // prevent duplicate injection per turn
       // REG-26 (Patch C): Reflexion-style structured failure memory. Indexed by
@@ -570961,6 +571426,145 @@ ${parts.join("\n")}
       writesUserTaskArtifacts() {
         return this.options.artifactMode === "user-task" && !this.options.subAgent;
       }
+      _backendModelLabel(backend = this.backend) {
+        const b = backend;
+        const direct = b["model"] ?? b["resolvedModel"] ?? b["modelName"];
+        if (typeof direct === "string" && direct.trim())
+          return direct.trim();
+        const nested = b["config"];
+        if (nested && typeof nested === "object") {
+          const model = nested["model"];
+          if (typeof model === "string" && model.trim())
+            return model.trim();
+        }
+        return "unknown";
+      }
+      _emitModelResolutionTelemetry(purpose, turn) {
+        try {
+          const backendName = this.backend.constructor?.name ?? "unknown";
+          const resolved = this._backendModelLabel(this.backend);
+          this.emit({
+            type: "status",
+            content: `Model resolution: purpose=${purpose} resolved=${resolved} backend=${backendName}`,
+            turn,
+            timestamp: (/* @__PURE__ */ new Date()).toISOString()
+          });
+        } catch {
+        }
+      }
+      _cosineSimilarity(a2, b) {
+        if (!a2 || !b || a2.length !== b.length || a2.length === 0)
+          return 0;
+        let dot = 0;
+        let na = 0;
+        let nb = 0;
+        for (let i2 = 0; i2 < a2.length; i2++) {
+          const av = a2[i2] ?? 0;
+          const bv = b[i2] ?? 0;
+          dot += av * bv;
+          na += av * av;
+          nb += bv * bv;
+        }
+        const denom = Math.sqrt(na) * Math.sqrt(nb);
+        return denom > 0 ? dot / denom : 0;
+      }
+      _embeddingBaseUrl() {
+        const raw = this.backend["baseUrl"] || "http://localhost:11434";
+        return raw.replace(/\/v1\/?$/, "");
+      }
+      _failurePatternText(pattern) {
+        return [
+          `signature: ${pattern.signature}`,
+          pattern.tool ? `tool: ${pattern.tool}` : "",
+          pattern.errorType ? `errorType: ${pattern.errorType}` : "",
+          pattern.guidance ? `guidance: ${pattern.guidance}` : ""
+        ].filter(Boolean).join("\n");
+      }
+      async _inferRelevantFailurePatternSignatures(taskGoal, candidates, maxPatterns) {
+        if (candidates.length === 0)
+          return /* @__PURE__ */ new Set();
+        try {
+          this._emitModelResolutionTelemetry("failure_pattern_relevance");
+          const backend = this._auxInferenceBackend();
+          const resp = await backend.chatCompletion({
+            messages: [
+              {
+                role: "system",
+                content: "You select prior failure patterns that are semantically relevant to the active task. Return only JSON."
+              },
+              {
+                role: "user",
+                content: JSON.stringify({
+                  taskGoal,
+                  max: maxPatterns,
+                  candidates: candidates.slice(0, 30).map((pattern) => ({
+                    signature: pattern.signature,
+                    tool: pattern.tool,
+                    errorType: pattern.errorType,
+                    guidance: pattern.guidance
+                  })),
+                  outputSchema: { relevant: ["signature"] }
+                })
+              }
+            ],
+            tools: [],
+            temperature: 0,
+            maxTokens: 500,
+            timeoutMs: 2e4
+          });
+          const raw = resp.choices?.[0]?.message?.content ?? "";
+          const start2 = raw.indexOf("{");
+          const end = raw.lastIndexOf("}");
+          if (start2 < 0 || end <= start2)
+            return /* @__PURE__ */ new Set();
+          const parsed = JSON.parse(raw.slice(start2, end + 1));
+          return new Set((parsed.relevant ?? []).map((item) => String(item)).filter((signature) => candidates.some((pattern) => pattern.signature === signature)).slice(0, maxPatterns));
+        } catch {
+          return /* @__PURE__ */ new Set();
+        }
+      }
+      async _selectTaskRelevantErrorPatterns(taskGoal, maxPatterns) {
+        const candidates = normalizeFailurePatterns(this._errorPatterns).slice(0, 40);
+        if (!taskGoal.trim() || candidates.length === 0)
+          return /* @__PURE__ */ new Map();
+        const selected = /* @__PURE__ */ new Map();
+        let selectedBy = "none";
+        try {
+          const embeddings = await generateEmbeddingBatch([taskGoal, ...candidates.map((pattern) => this._failurePatternText(pattern))], { baseUrl: this._embeddingBaseUrl(), timeoutMs: 12e3 });
+          const query = embeddings[0]?.vector;
+          const minScore = Number.parseFloat(process.env["OMNIUS_FAILURE_PATTERN_SIM_MIN"] ?? "0.58");
+          if (query) {
+            const scored = candidates.map((pattern, index) => ({
+              pattern,
+              score: embeddings[index + 1]?.vector ? this._cosineSimilarity(query, embeddings[index + 1].vector) : 0
+            })).filter((item) => item.score >= minScore).sort((a2, b) => b.score - a2.score).slice(0, maxPatterns);
+            for (const item of scored) {
+              const raw = this._errorPatterns.get(item.pattern.signature);
+              if (raw)
+                selected.set(item.pattern.signature, raw);
+            }
+            if (selected.size > 0)
+              selectedBy = "vector";
+          }
+        } catch {
+        }
+        if (selected.size === 0) {
+          const relevant = await this._inferRelevantFailurePatternSignatures(taskGoal, candidates, maxPatterns);
+          for (const signature of relevant) {
+            const raw = this._errorPatterns.get(signature);
+            if (raw)
+              selected.set(signature, raw);
+          }
+          if (selected.size > 0)
+            selectedBy = "inference";
+        }
+        this.emit({
+          type: "status",
+          content: `Failure handoff semantic selection: ${selected.size}/${candidates.length} persisted pattern(s) selected by ${selectedBy}`,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        });
+        return selected;
+      }
       _persistCompletionContract(contract) {
         if (!this.writesUserTaskArtifacts())
           return;
@@ -571961,12 +572565,14 @@ ${modelVisible}` : modelVisible || result.error || displayOutput || "";
         if (!this._completionLedger || input.toolName === "task_complete")
           return;
         const realFileMutation = input.realFileMutation ?? this._isRealProjectMutation(input.toolName, input.result);
-        const realMutationPaths = input.realMutationPaths ?? (realFileMutation ? this._extractToolTargetPaths(input.toolName, input.args, input.result) : []);
+        const attemptedTargetPaths = this._extractToolTargetPaths(input.toolName, input.args, input.result);
+        const realMutationPaths = input.realMutationPaths ?? (realFileMutation ? attemptedTargetPaths : []);
         this._completionLedger = recordToolEvidence(this._completionLedger, {
           name: input.toolName,
           success: input.result.success,
           outputPreview: (input.outputPreview ?? this._toolEvidencePreview(input.result)).toString().slice(0, 500),
-          argsKey: input.argsKey.slice(0, 300)
+          argsKey: input.argsKey.slice(0, 300),
+          targetPaths: attemptedTargetPaths
         });
         if (realFileMutation && realMutationPaths.length > 0) {
           for (const filePath of realMutationPaths) {
@@ -571975,7 +572581,8 @@ ${modelVisible}` : modelVisible || result.error || displayOutput || "";
               toolName: input.toolName,
               success: true,
               summary: `file change: ${filePath}`,
-              rawRef: `file://${filePath}`
+              rawRef: `file://${filePath}`,
+              targetPaths: [filePath]
             });
           }
         }
@@ -572323,7 +572930,7 @@ ${context2 ?? ""}`;
           `Task affect: uncertainty=${affect.uncertainty.toFixed(2)} frustration=${affect.frustration.toFixed(2)} confidence=${affect.confidence.toFixed(2)} momentum=${affect.momentum.toFixed(2)}`
         ].join("\n");
       }
-      _buildPreflightTaskMemoryRecall(taskGoal) {
+      async _buildPreflightTaskMemoryRecall(taskGoal) {
         if (process.env["OMNIUS_DISABLE_PREFLIGHT_MEMORY_RECALL"] === "1")
           return "";
         if (this.options.stateDir || this.options.subAgent)
@@ -572332,17 +572939,31 @@ ${context2 ?? ""}`;
           return "";
         try {
           const query = taskGoal.slice(0, 1e3);
-          const results = this._episodeStore.search({ query, limit: 6 });
-          const useful = results.filter((entry) => typeof entry.content === "string" && entry.content.trim().length >= 30).slice(0, 4);
+          const embedding = await generateEmbedding(query, {
+            baseUrl: this._embeddingBaseUrl(),
+            timeoutMs: 1e4
+          });
+          if (!embedding?.vector)
+            return "";
+          const results = this._episodeStore.search({ query, limit: 12 }, {
+            queryEmbedding: embedding.vector,
+            lexicalWeight: 0,
+            embeddingWeight: 1
+          });
+          const minScore = Number.parseFloat(process.env["OMNIUS_PREFLIGHT_MEMORY_SIM_MIN"] ?? "0.58");
+          const useful = results.map((entry) => ({
+            entry,
+            score: entry.embedding ? this._cosineSimilarity(embedding.vector, entry.embedding) : 0
+          })).filter(({ entry, score }) => typeof entry.content === "string" && entry.content.trim().length >= 30 && score >= minScore).sort((a2, b) => b.score - a2.score).slice(0, 3);
           if (useful.length === 0)
             return "";
-          const lines = useful.map((entry, index) => {
-            const tool = typeof entry.metadata?.["toolName"] === "string" ? ` tool=${entry.metadata["toolName"]}` : "";
-            return `${index + 1}. ${entry.content.replace(/\s+/g, " ").slice(0, 260)}${tool}`;
+          const lines = useful.map(({ entry, score }, index) => {
+            const tool = typeof entry.toolName === "string" && entry.toolName ? ` tool=${entry.toolName}` : "";
+            return `${index + 1}. sim=${score.toFixed(3)} ${entry.content.replace(/\s+/g, " ").slice(0, 260)}${tool}`;
           });
           return [
             `[PREFLIGHT MEMORY RECALL]`,
-            `Retrieved task-relevant prior episodes before the first action. Use these as hypotheses, not truth; verify against current files/UI.`,
+            `Retrieved vector-similar prior episodes before the first action. Use these as hypotheses, not truth; verify against current files/UI.`,
             ...lines,
             `If the current task resembles one of these, prefer the remembered working verification path and avoid the remembered failure pattern.`
           ].join("\n");
@@ -572455,9 +573076,26 @@ ${shellLines.join("\n")}` : "Commands run: none"
         const failCount = toolCallLog.filter((e2) => e2.success === false).length;
         evidenceParts.push(`Failed tool calls this run: ${failCount}`);
         const evidenceDigest = evidenceParts.join("\n");
+        const degraded = detectExplicitDegradedCompletion({
+          originalGoal,
+          actionsDigest,
+          evidenceDigest,
+          proposedSummary
+        });
+        if (degraded) {
+          this._resolutionGateRejections = 0;
+          this.emit({
+            type: "status",
+            content: `Resolution gate accepted explicit degraded completion: ${degraded.reason}`,
+            turn,
+            timestamp: (/* @__PURE__ */ new Date()).toISOString()
+          });
+          return { proceed: true };
+        }
         let verdict = null;
         try {
           const backend = this._auxInferenceBackend();
+          this._emitModelResolutionTelemetry("completion_resolution", turn);
           for (let attempt = 0; attempt < 2 && !verdict; attempt++) {
             const resp = await backend.chatCompletion({
               messages: [
@@ -575393,7 +576031,8 @@ Rewrite it now for ${ctx3.model}.`;
           run_in_background: ["background", "background_run", "async"],
           max_turns: ["maxTurns", "turns"],
           timeout_ms: ["timeoutMs", "timeout"],
-          path: ["file", "filepath", "file_path", "filename"],
+          path: ["file", "image", "media", "filepath", "file_path", "filename"],
+          image: ["path", "file", "media", "filepath", "file_path", "filename"],
           command: ["cmd", "shell_command"],
           query: ["prompt", "task", "message", "input", "text"]
         };
@@ -575889,6 +576528,7 @@ Respond with your assessment, then take action.`;
         this.pendingUserMessages.length = 0;
         const persistentTaskGoal = cleanForStorage(actualUserGoal || "") || cleanedTask;
         const userGoal = persistentTaskGoal.slice(0, 500);
+        this._taskRelevantErrorPatterns = process.env["OMNIUS_DISABLE_FAILURE_HANDOFF"] === "1" ? /* @__PURE__ */ new Map() : await this._selectTaskRelevantErrorPatterns(persistentTaskGoal, 10);
         this._taskState = {
           goal: userGoal,
           originalGoal: userGoal,
@@ -575933,6 +576573,7 @@ Respond with your assessment, then take action.`;
           contextWindowSize: this.options.contextWindowSize ?? 0,
           verbose: false
         });
+        this._emitModelResolutionTelemetry("main");
         this._hookManager.runSessionHook("session_start", this._sessionId);
         if (this.writesUserTaskArtifacts()) {
           this._initializeCompletionContract(task, context2, actualUserGoal);
@@ -576163,7 +576804,7 @@ TASK: ${scrubbedTask}` : scrubbedTask;
           ...missionCompletionContract ? [{ role: "system", content: missionCompletionContract }] : [],
           { role: "user", content: userContent }
         ];
-        const preflightMemoryRecall = this._buildPreflightTaskMemoryRecall(persistentTaskGoal);
+        const preflightMemoryRecall = await this._buildPreflightTaskMemoryRecall(persistentTaskGoal);
         if (preflightMemoryRecall) {
           messages2.splice(messages2.length - 1, 0, {
             role: "system",
@@ -576283,7 +576924,7 @@ TASK: ${scrubbedTask}` : scrubbedTask;
           try {
             const failureHandoff = buildFailureModeHandoff({
               taskGoal: persistentTaskGoal,
-              errorPatterns: this._errorPatterns,
+              errorPatterns: this._taskRelevantErrorPatterns,
               toolCallLog,
               taskState: this._taskState,
               maxPatterns: 10,
@@ -579760,13 +580401,15 @@ Respond with EXACTLY this structure before your next tool call:
                   default:
                     guidance = `This tool failed previously with a similar error. Review the error message carefully and adjust your approach before retrying.`;
                 }
-                this._errorPatterns.set(sig, {
+                const learnedPattern = {
                   count,
                   guidance,
                   lastSeen: Date.now(),
                   tool: tc.name,
                   errorType
-                });
+                };
+                this._errorPatterns.set(sig, learnedPattern);
+                this._taskRelevantErrorPatterns.set(sig, learnedPattern);
                 if (this._failureStore) {
                   try {
                     this._failureStore.insert({
@@ -579816,13 +580459,48 @@ Respond with EXACTLY this structure before your next tool call:
                 }
                 if (tc.name === "todo_write") {
                   try {
-                    const _todosNow = this.readSessionTodos() || [];
+                    let _todosNow = this.readSessionTodos() || [];
                     for (const _tp of _todosNow) {
                       const _tpId = _tp.id;
                       if (_tp.status === "in_progress" && _tpId && !this._todoInProgressTurn.has(_tpId)) {
                         this._todoInProgressTurn.set(_tpId, turn);
                       }
                     }
+                    const truth = reconcileCompletedTodosWithEvidence({
+                      todos: _todosNow,
+                      toolCallLog,
+                      todoStartTurnById: this._todoInProgressTurn
+                    });
+                    if (truth.changed) {
+                      const sid = this._sessionId || process.env["OMNIUS_SESSION_ID"] || "default";
+                      writeTodos(sid, truth.todos.map((t2) => ({
+                        id: t2.id,
+                        content: t2.content,
+                        status: t2.status,
+                        parentId: t2.parentId,
+                        blocker: t2.blocker,
+                        verifyCommand: t2.verifyCommand,
+                        declaredArtifacts: t2.declaredArtifacts
+                      })));
+                      _todosNow = this.readSessionTodos() || truth.todos;
+                      const downgradeLines = truth.downgrades.slice(0, 6).map((d2) => `- ${d2.content}: ${d2.from} -> ${d2.to}; ${d2.evidence}`).join("\n");
+                      messages2.push({
+                        role: "system",
+                        content: [
+                          `[TODO TRUTH RECONCILIATION]`,
+                          `One or more completed todo claims contradicted the evidence or nested child status and were rewritten in the active todo list.`,
+                          downgradeLines,
+                          ``,
+                          `Reconfigure the affected subtask tree now: read/verify the current state, choose a different tool or target if the prior route failed, or leave the child todo blocked with the root cause. Do not mark a parent completed until every child is completed with evidence.`
+                        ].join("\n")
+                      });
+                      this.emit({
+                        type: "status",
+                        content: `Todo truth reconciled ${truth.downgrades.length} completed claim(s) from evidence/nested child state`,
+                        turn,
+                        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+                      });
+                    }
                     if (!this._newFieldNudgeFired) {
                       this._todoWritesObservedForNudge++;
                       const _anyFieldUsed = _todosNow.some((t2) => typeof t2.verifyCommand === "string" || Array.isArray(t2.declaredArtifacts));
@@ -580562,7 +581240,7 @@ Then use file_read on individual FILES inside it.`);
               if (process.env["OMNIUS_DISABLE_FAILURE_HANDOFF"] !== "1" && !result.success && turn - lastFailureHandoffTurn >= 4) {
                 const runtimeHandoff = buildFailureModeHandoff({
                   taskGoal: persistentTaskGoal,
-                  errorPatterns: this._errorPatterns,
+                  errorPatterns: this._taskRelevantErrorPatterns,
                   toolCallLog,
                   taskState: this._taskState,
                   maxPatterns: 5,
@@ -582419,7 +583097,7 @@ ${caveat}` : caveat;
                   timestamp: (/* @__PURE__ */ new Date()).toISOString()
                 });
                 try {
-                  const { mkdirSync: mkdirSync106, readdirSync: readdirSync59, statSync: statSync59, unlinkSync: unlinkSync36, writeFileSync: writeFileSync91 } = __require("node:fs");
+                  const { mkdirSync: mkdirSync106, readdirSync: readdirSync59, statSync: statSync59, unlinkSync: unlinkSync36, writeFileSync: writeFileSync90 } = __require("node:fs");
                   const { join: join179 } = __require("node:path");
                   const contextDir = join179(this._workingDirectory || process.cwd(), ".omnius", "context");
                   mkdirSync106(contextDir, { recursive: true });
@@ -582466,14 +583144,14 @@ ${caveat}` : caveat;
                   mkdirSync106(kgSummaryDir, { recursive: true });
                   const summaryFilename = `kg-summary-${this._sessionId}.md`;
                   const outPath = join179(kgSummaryDir, summaryFilename);
-                  writeFileSync91(outPath, lines.join("\n"), "utf-8");
-                  writeFileSync91(join179(kgSummaryDir, "latest.md"), lines.join("\n"), "utf-8");
-                  writeFileSync91(join179(contextDir, `kg-summary-latest.md`), [
+                  writeFileSync90(outPath, lines.join("\n"), "utf-8");
+                  writeFileSync90(join179(kgSummaryDir, "latest.md"), lines.join("\n"), "utf-8");
+                  writeFileSync90(join179(contextDir, `kg-summary-latest.md`), [
                     "Latest KG summary moved to `.omnius/context/kg-summary/latest.md`.",
                     "",
                     lines.join("\n")
                   ].join("\n"), "utf-8");
-                  writeFileSync91(join179(kgSummaryDir, "index.json"), JSON.stringify({
+                  writeFileSync90(join179(kgSummaryDir, "index.json"), JSON.stringify({
                     schema: "omnius.kg-summary-index.v1",
                     latest: "latest.md",
                     latestSessionFile: summaryFilename,
@@ -583310,7 +583988,7 @@ Actions: (1) list_directory on the parent directory to see what's there, (2) Che
         if (!this._workingDirectory)
           return;
         try {
-          const { mkdirSync: mkdirSync106, writeFileSync: writeFileSync91 } = __require("node:fs");
+          const { mkdirSync: mkdirSync106, writeFileSync: writeFileSync90 } = __require("node:fs");
           const { join: join179 } = __require("node:path");
           const sessionDir2 = this.options.stateDir ? join179(this.omniusStateDir(), "session", this._sessionId) : join179(this._workingDirectory, ".omnius", "session", this._sessionId);
           mkdirSync106(sessionDir2, { recursive: true });
@@ -583325,7 +584003,7 @@ Actions: (1) list_directory on the parent directory to see what's there, (2) Che
             memexEntryCount: this._memexArchive.size,
             fileRegistrySize: this._fileRegistry.size
           };
-          writeFileSync91(join179(sessionDir2, "checkpoint.json"), JSON.stringify(checkpoint, null, 2));
+          writeFileSync90(join179(sessionDir2, "checkpoint.json"), JSON.stringify(checkpoint, null, 2));
         } catch {
         }
       }
@@ -583462,7 +584140,7 @@ ${tail}`;
         const analysis = await this.analyzeImageDataForContext(image.mime, image.base64, image.textWithoutImage.slice(0, 2e3));
         const imageNote = analysis.contextBlock ? `${analysis.contextBlock}
 
-Use this image analysis. Do not repeat ${toolName} with the same arguments unless the scene has changed.` : `[Embedded image data omitted from model context; ${analysis.errorReason || "vision and OCR returned no text"}. Use any saved image path above with vision/image_read if further inspection is needed.]`;
+Use this image analysis. Do not repeat ${toolName} with the same arguments unless the scene has changed.` : `[Embedded image data omitted from model context; ${analysis.errorReason || "vision and OCR returned no text"}. If further inspection is needed, call vision first with the saved image path (Moondream caption/query), then use image_read only for metadata/OCR/raw image ingress.]`;
         return {
           ...result,
           llmContent: `${image.textWithoutImage.trim()}
@@ -583498,7 +584176,7 @@ ${imageNote}`.trim()
         const imageUrl = `data:${mime};base64,${base642}`;
         const tmpImgPath = this.writeTempImageForOcr(mime, base642);
         const [visionOutcome, ocrOutcome] = await Promise.allSettled([
-          this.describeImageViaVisionSubagent(imageUrl, textContent),
+          tmpImgPath ? this.describeImageViaPrimaryVision(tmpImgPath, imageUrl, textContent) : this.describeImageViaVisionSubagent(imageUrl, textContent),
           tmpImgPath ? this.extractImageOcrText(tmpImgPath) : Promise.resolve("")
         ]);
         const visionDesc = visionOutcome.status === "fulfilled" ? visionOutcome.value.trim() : "";
@@ -583513,6 +584191,26 @@ ${imageNote}`.trim()
         const errorReason = visionOutcome.status === "rejected" ? String(visionOutcome.reason?.message ?? visionOutcome.reason) : void 0;
         return { contextBlock: "", errorReason };
       }
+      async describeImageViaPrimaryVision(imagePath, imageUrl, textContent) {
+        try {
+          const vision = new VisionTool(this._workingDirectory || process.cwd());
+          const prompt = textContent ? `User context: ${textContent}
+
+Describe the image in detail. Identify people, objects, text, UI elements, diagrams, errors, and any task-relevant visual metadata.` : "Describe the image in detail. Identify people, objects, text, UI elements, diagrams, errors, and any task-relevant visual metadata.";
+          const result = await vision.execute({
+            image: imagePath,
+            action: "query",
+            prompt,
+            length: "long"
+          });
+          const output = String(result.llmContent || result.output || "").trim();
+          if (result.success && output.length > 20)
+            return output;
+          throw new Error(result.error || "vision tool returned no description");
+        } catch {
+          return await this.describeImageViaVisionSubagent(imageUrl, textContent);
+        }
+      }
       async describeImageViaVisionSubagent(imageUrl, textContent) {
         const visionMessages = [
           {
@@ -584066,7 +584764,7 @@ ${content.slice(0, 8e3)}
           try {
             const compactFailureHandoff = buildFailureModeHandoff({
               taskGoal: this._taskState.goal,
-              errorPatterns: this._errorPatterns,
+              errorPatterns: this._taskRelevantErrorPatterns,
               taskState: this._taskState,
               maxPatterns: 6,
               maxRecentCalls: 0
@@ -585985,12 +586683,12 @@ ${result}`
             let resizedBase64 = null;
             try {
               const { execSync: execSync63 } = await import("node:child_process");
-              const { writeFileSync: writeFileSync91, readFileSync: readFileSync133, unlinkSync: unlinkSync36 } = await import("node:fs");
+              const { writeFileSync: writeFileSync90, readFileSync: readFileSync133, unlinkSync: unlinkSync36 } = await import("node:fs");
               const { join: join179 } = await import("node:path");
               const { tmpdir: tmpdir24 } = await import("node:os");
               const tmpIn = join179(tmpdir24(), `omnius_img_in_${Date.now()}.png`);
               const tmpOut = join179(tmpdir24(), `omnius_img_out_${Date.now()}.jpg`);
-              writeFileSync91(tmpIn, buffer2);
+              writeFileSync90(tmpIn, buffer2);
               const pyBin = process.platform === "win32" ? "python" : "python3";
               const escapedIn = tmpIn.replace(/\\/g, "\\\\");
               const escapedOut = tmpOut.replace(/\\/g, "\\\\");
@@ -594971,10 +595669,10 @@ transcribe-cli error: ${transcribeCliError}` : "";
               wordTimestamps: false
             });
             if (outputDir2) {
-              const { basename: basename39 } = await import("node:path");
+              const { basename: basename40 } = await import("node:path");
               const transcriptDir = join120(outputDir2, ".omnius", "transcripts");
               mkdirSync63(transcriptDir, { recursive: true });
-              const outFile = join120(transcriptDir, `${basename39(filePath)}.txt`);
+              const outFile = join120(transcriptDir, `${basename40(filePath)}.txt`);
               writeFileSync53(outFile, result.text, "utf-8");
             }
             return {
@@ -594990,10 +595688,10 @@ transcribe-cli error: ${transcribeCliError}` : "";
         const fb = await transcribeFileViaWhisper(filePath, this.config.model);
         if (fb) {
           if (outputDir2) {
-            const { basename: basename39 } = await import("node:path");
+            const { basename: basename40 } = await import("node:path");
             const transcriptDir = join120(outputDir2, ".omnius", "transcripts");
             mkdirSync63(transcriptDir, { recursive: true });
-            const outFile = join120(transcriptDir, `${basename39(filePath)}.txt`);
+            const outFile = join120(transcriptDir, `${basename40(filePath)}.txt`);
             writeFileSync53(outFile, fb.text, "utf-8");
           }
           return fb;
@@ -612842,6 +613540,33 @@ function buildTodoProgressBar(todos, maxWidth) {
   if (truncated && maxWidth > 0) out += `${DIM_LABEL}…${RESET3}`;
   return out;
 }
+function orderTodosForDisplay(todos) {
+  const byParent = /* @__PURE__ */ new Map();
+  const byId = new Set(todos.map((t2) => t2.id));
+  const roots = [];
+  for (const todo of todos) {
+    if (todo.parentId && byId.has(todo.parentId)) {
+      const arr = byParent.get(todo.parentId) ?? [];
+      arr.push(todo);
+      byParent.set(todo.parentId, arr);
+    } else {
+      roots.push(todo);
+    }
+  }
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  const visit = (todo, depth) => {
+    if (seen.has(todo.id)) return;
+    seen.add(todo.id);
+    out.push({ ...todo, depth: Math.min(depth, 4) });
+    for (const child of byParent.get(todo.id) ?? []) {
+      visit(child, depth + 1);
+    }
+  };
+  for (const root of roots) visit(root, 0);
+  for (const todo of todos) visit(todo, 0);
+  return out;
+}
 function render() {
   if (!_enabled) return;
   if (!panelEffectivelyVisible()) {
@@ -612867,16 +613592,18 @@ function render() {
   const progressBar = buildTodoProgressBar(_lastTodos, maxBarWidth);
   const headerText = `${headerPrefix}${progressBar}`;
   lines.push(headerText);
-  const visible = _lastTodos.slice(0, MAX_VISIBLE_ROWS - 1);
+  const displayTodos = orderTodosForDisplay(_lastTodos);
+  const visible = displayTodos.slice(0, MAX_VISIBLE_ROWS - 1);
   for (const t2 of visible) {
     const { mark, color } = statusToAnsi(t2.status);
     const contentWidth = Math.max(4, cols - 8);
-    const contentText = t2.content + (t2.blocker ? ` (blocked: ${t2.blocker})` : "");
+    const indent2 = t2.depth > 0 ? `${"  ".repeat(t2.depth - 1)}- ` : "";
+    const contentText = indent2 + t2.content + (t2.blocker ? ` (blocked: ${t2.blocker})` : "");
     const truncated = truncate2(contentText, contentWidth);
     lines.push(`${color}${mark}${RESET3} ${color}${truncated}${RESET3}`);
   }
-  if (_lastTodos.length > visible.length) {
-    const more = _lastTodos.length - visible.length;
+  if (displayTodos.length > visible.length) {
+    const more = displayTodos.length - visible.length;
     lines[lines.length - 1] = `${DIM_LABEL}… +${more} more${RESET3}`;
   }
   let out = HIDE + SAVE;
@@ -635942,13 +636669,13 @@ async function handleSlashCommand(input, ctx3) {
           try {
             const { randomBytes: randomBytes30 } = await import("node:crypto");
             const { homedir: homedir62 } = await import("node:os");
-            const { mkdirSync: mkdirSync106, writeFileSync: writeFileSync91 } = await import("node:fs");
+            const { mkdirSync: mkdirSync106, writeFileSync: writeFileSync90 } = await import("node:fs");
             const { join: join179 } = await import("node:path");
             const newKey = randomBytes30(16).toString("hex");
             process.env["OMNIUS_API_KEY"] = newKey;
             const dir = join179(homedir62(), ".omnius");
             mkdirSync106(dir, { recursive: true });
-            writeFileSync91(join179(dir, "api.key"), newKey + "\n", "utf8");
+            writeFileSync90(join179(dir, "api.key"), newKey + "\n", "utf8");
             renderInfo(`New API key: ${c3.bold(c3.yellow(newKey))}`);
             renderInfo(
               "Restart the daemon to apply if needed. Use /access any to restart quickly."
@@ -636219,11 +636946,11 @@ async function handleSlashCommand(input, ctx3) {
             );
             try {
               const { homedir: homedir63 } = await import("node:os");
-              const { mkdirSync: mkdirSync107, writeFileSync: writeFileSync92 } = await import("node:fs");
+              const { mkdirSync: mkdirSync107, writeFileSync: writeFileSync91 } = await import("node:fs");
               const { join: join180 } = await import("node:path");
               const dir = join180(homedir63(), ".omnius");
               mkdirSync107(dir, { recursive: true });
-              writeFileSync92(join180(dir, "api.key"), apiKey + "\n", "utf8");
+              writeFileSync91(join180(dir, "api.key"), apiKey + "\n", "utf8");
             } catch {
             }
           }
@@ -636235,11 +636962,11 @@ async function handleSlashCommand(input, ctx3) {
           const port2 = parseInt(process.env["OMNIUS_PORT"] || "11435", 10);
           try {
             const { homedir: homedir63 } = await import("node:os");
-            const { mkdirSync: mkdirSync107, writeFileSync: writeFileSync92 } = await import("node:fs");
+            const { mkdirSync: mkdirSync107, writeFileSync: writeFileSync91 } = await import("node:fs");
             const { join: join180 } = await import("node:path");
             const dir = join180(homedir63(), ".omnius");
             mkdirSync107(dir, { recursive: true });
-            writeFileSync92(join180(dir, "access"), `${val2}
+            writeFileSync91(join180(dir, "access"), `${val2}
 `, "utf8");
           } catch {
           }
@@ -636339,11 +637066,11 @@ async function handleSlashCommand(input, ctx3) {
         );
         try {
           const { homedir: homedir63 } = await import("node:os");
-          const { mkdirSync: mkdirSync107, writeFileSync: writeFileSync92 } = await import("node:fs");
+          const { mkdirSync: mkdirSync107, writeFileSync: writeFileSync91 } = await import("node:fs");
           const { join: join180 } = await import("node:path");
           const dir = join180(homedir63(), ".omnius");
           mkdirSync107(dir, { recursive: true });
-          writeFileSync92(join180(dir, "api.key"), apiKey + "\n", "utf8");
+          writeFileSync91(join180(dir, "api.key"), apiKey + "\n", "utf8");
         } catch {
         }
       }
@@ -636354,12 +637081,12 @@ async function handleSlashCommand(input, ctx3) {
       }
       const port = parseInt(process.env["OMNIUS_PORT"] || "11435", 10);
       const { homedir: homedir62 } = await import("node:os");
-      const { mkdirSync: mkdirSync106, writeFileSync: writeFileSync91 } = await import("node:fs");
+      const { mkdirSync: mkdirSync106, writeFileSync: writeFileSync90 } = await import("node:fs");
       const { join: join179 } = await import("node:path");
       try {
         const dir = join179(homedir62(), ".omnius");
         mkdirSync106(dir, { recursive: true });
-        writeFileSync91(join179(dir, "access"), `${val}
+        writeFileSync90(join179(dir, "access"), `${val}
 `, "utf8");
       } catch (e2) {
         renderWarning(
@@ -645195,14 +645922,14 @@ async function handleVoiceMenu(ctx3, save3, hasLocal) {
             if (!jsonDrop.confirmed || !jsonDrop.path) {
               continue;
             }
-            const { basename: basename39, join: pathJoin } = await import("node:path");
+            const { basename: basename40, join: pathJoin } = await import("node:path");
             const {
               copyFileSync: copyFileSync8,
               mkdirSync: mkdirSync106,
               existsSync: exists2
             } = await import("node:fs");
             const { homedir: homedir62 } = await import("node:os");
-            const modelName = basename39(onnxDrop.path, ".onnx").replace(
+            const modelName = basename40(onnxDrop.path, ".onnx").replace(
               /[^a-zA-Z0-9_-]/g,
               "-"
             );
@@ -645722,7 +646449,7 @@ async function handleVoiceList(ctx3, focusFilename) {
                 copyFileSync: cpf,
                 mkdirSync: mkd
               } = __require("node:fs");
-              const { basename: basename39, join: pjoin } = __require("node:path");
+              const { basename: basename40, join: pjoin } = __require("node:path");
               if (!fe(src2)) {
                 renderError(`File not found: ${src2}`);
                 helpers.render();
@@ -645735,7 +646462,7 @@ async function handleVoiceList(ctx3, focusFilename) {
                 "clone-refs"
               );
               mkd(refsDir, { recursive: true });
-              const destName = basename39(src2);
+              const destName = basename40(src2);
               const dest = pjoin(refsDir, destName);
               cpf(src2, dest);
               renderInfo(`Imported "${destName}" → ${dest}`);
@@ -646992,13 +647719,13 @@ async function handleSponsoredEndpoint(ctx3, local) {
     sponsors.push(...verified);
     if (verified.length > 0) {
       try {
-        const { mkdirSync: mkdirSync106, writeFileSync: writeFileSync91 } = __require("node:fs");
+        const { mkdirSync: mkdirSync106, writeFileSync: writeFileSync90 } = __require("node:fs");
         mkdirSync106(sponsorDir2, { recursive: true });
         const cached = verified.map((s2) => ({
           ...s2,
           lastVerified: Date.now()
         }));
-        writeFileSync91(knownFile, JSON.stringify(cached, null, 2));
+        writeFileSync90(knownFile, JSON.stringify(cached, null, 2));
       } catch {
       }
     }
@@ -647202,7 +647929,7 @@ async function handlePeerEndpoint(peerId, authKey, ctx3, local, advertisedModels
     }
     if (models.length > 0) {
       try {
-        const { writeFileSync: writeFileSync91, mkdirSync: mkdirSync106 } = await import("node:fs");
+        const { writeFileSync: writeFileSync90, mkdirSync: mkdirSync106 } = await import("node:fs");
         const { join: join179, dirname: dirname54 } = await import("node:path");
         const cachePath2 = join179(
           ctx3.repoRoot || process.cwd(),
@@ -647211,7 +647938,7 @@ async function handlePeerEndpoint(peerId, authKey, ctx3, local, advertisedModels
           "peer-models-cache.json"
         );
         mkdirSync106(dirname54(cachePath2), { recursive: true });
-        writeFileSync91(
+        writeFileSync90(
           cachePath2,
           JSON.stringify(
             {
@@ -647285,7 +648012,7 @@ async function handlePeerEndpoint(peerId, authKey, ctx3, local, advertisedModels
         "Live model probe failed; using sponsor directory model advertisement."
       );
       try {
-        const { writeFileSync: writeFileSync91, mkdirSync: mkdirSync106 } = await import("node:fs");
+        const { writeFileSync: writeFileSync90, mkdirSync: mkdirSync106 } = await import("node:fs");
         const { join: join179, dirname: dirname54 } = await import("node:path");
         const cachePath2 = join179(
           ctx3.repoRoot || process.cwd(),
@@ -647294,7 +648021,7 @@ async function handlePeerEndpoint(peerId, authKey, ctx3, local, advertisedModels
           "peer-models-cache.json"
         );
         mkdirSync106(dirname54(cachePath2), { recursive: true });
-        writeFileSync91(
+        writeFileSync90(
           cachePath2,
           JSON.stringify(
             {
@@ -649992,13 +650719,13 @@ var init_commands = __esm({
             try {
               const { randomBytes: randomBytes30 } = await import("node:crypto");
               const { homedir: homedir62 } = await import("node:os");
-              const { mkdirSync: mkdirSync106, writeFileSync: writeFileSync91 } = await import("node:fs");
+              const { mkdirSync: mkdirSync106, writeFileSync: writeFileSync90 } = await import("node:fs");
               const { join: join179 } = await import("node:path");
               const apiKey = randomBytes30(16).toString("hex");
               process.env["OMNIUS_API_KEY"] = apiKey;
               const dir = join179(homedir62(), ".omnius");
               mkdirSync106(dir, { recursive: true });
-              writeFileSync91(join179(dir, "api.key"), apiKey + "\n", "utf8");
+              writeFileSync90(join179(dir, "api.key"), apiKey + "\n", "utf8");
               renderInfo(`Generated API key: ${c3.bold(c3.yellow(apiKey))}`);
               renderInfo(
                 "Use Authorization: Bearer <key> or click 'key' in the Web UI header to paste it."
@@ -650017,11 +650744,11 @@ var init_commands = __esm({
           const port = parseInt(process.env["OMNIUS_PORT"] || "11435", 10);
           try {
             const { homedir: homedir62 } = await import("node:os");
-            const { mkdirSync: mkdirSync106, writeFileSync: writeFileSync91 } = await import("node:fs");
+            const { mkdirSync: mkdirSync106, writeFileSync: writeFileSync90 } = await import("node:fs");
             const { join: join179 } = await import("node:path");
             const dir = join179(homedir62(), ".omnius");
             mkdirSync106(dir, { recursive: true });
-            writeFileSync91(join179(dir, "access"), `${val}
+            writeFileSync90(join179(dir, "access"), `${val}
 `, "utf8");
           } catch {
           }
@@ -661171,6 +661898,175 @@ var init_soul_observations = __esm({
   }
 });
 
+// packages/cli/src/tui/visual-object-association.ts
+var visual_object_association_exports = {};
+__export(visual_object_association_exports, {
+  associateVisualObjectFromImage: () => associateVisualObjectFromImage,
+  extractExplicitVisualObjectLabels: () => extractExplicitVisualObjectLabels,
+  formatVisualObjectMemoryContext: () => formatVisualObjectMemoryContext
+});
+import { basename as basename35 } from "node:path";
+function stringValue2(value2) {
+  return typeof value2 === "string" ? value2.trim() : "";
+}
+function stringList(value2) {
+  if (Array.isArray(value2)) {
+    return value2.filter((item) => typeof item === "string" && item.trim().length > 0).map((item) => item.trim());
+  }
+  const single = stringValue2(value2);
+  return single ? [single] : [];
+}
+function splitLabels(value2) {
+  return value2.split(/[;,]/).map((part) => part.trim()).filter(Boolean).slice(0, 12);
+}
+function normalizeLabel(value2) {
+  return value2.replace(/\s+/g, " ").replace(/^["'`]+|["'`]+$/g, "").trim();
+}
+function uniqueLabels(values) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const raw of values) {
+    const label = normalizeLabel(raw);
+    const key = label.toLowerCase();
+    if (!label || seen.has(key)) continue;
+    seen.add(key);
+    out.push(label);
+  }
+  return out;
+}
+function explicitCaptionLabels(caption) {
+  const text2 = stringValue2(caption);
+  if (!text2) return [];
+  const match = text2.match(/^\s*(?:object[_ -]?label|object|label|labels)\s*:\s*(.+)$/i);
+  return match?.[1] ? splitLabels(match[1]) : [];
+}
+function identityNames(payload) {
+  const names = /* @__PURE__ */ new Set();
+  const add3 = (value2) => {
+    const name10 = normalizeLabel(String(value2 ?? ""));
+    if (name10) names.add(name10.toLowerCase());
+  };
+  for (const key of ["person", "person_name", "personName", "face_name", "faceName"]) {
+    add3(payload[key]);
+  }
+  for (const person of stringList(payload["people"])) add3(person);
+  const assertions = Array.isArray(payload["identityAssertions"]) ? payload["identityAssertions"] : Array.isArray(payload["identity_assertions"]) ? payload["identity_assertions"] : [];
+  for (const item of assertions) {
+    if (item && typeof item === "object") add3(item["name"]);
+  }
+  return names;
+}
+function isRejectedObjectLabel(label, payload) {
+  const key = normalizeLabel(label).toLowerCase();
+  if (!key) return true;
+  if (/^(visual_identity|pending_visual_identity|person|face|speaker)(?:[_:\s-]|$)/i.test(label)) return true;
+  if (identityNames(payload).has(key)) return true;
+  return false;
+}
+function extractExplicitVisualObjectLabels(payload) {
+  const media = payload["media"] && typeof payload["media"] === "object" ? payload["media"] : {};
+  const candidates = uniqueLabels([
+    ...stringList(payload["object_label"]),
+    ...stringList(payload["objectLabel"]),
+    ...stringList(payload["object_labels"]),
+    ...stringList(payload["objectLabels"]),
+    ...stringList(payload["visualObjectLabel"]),
+    ...stringList(payload["visual_object_label"]),
+    ...stringList(payload["visualObjectLabels"]),
+    ...stringList(payload["visual_object_labels"]),
+    ...stringList(payload["label"]),
+    ...stringList(payload["labels"]),
+    ...stringList(media["objectLabel"]),
+    ...stringList(media["object_label"]),
+    ...stringList(media["objectLabels"]),
+    ...stringList(media["object_labels"]),
+    ...stringList(media["label"]),
+    ...stringList(media["labels"]),
+    ...explicitCaptionLabels(payload["caption"]),
+    ...explicitCaptionLabels(media["caption"])
+  ]).filter((label) => !isRejectedObjectLabel(label, payload));
+  const aliases = uniqueLabels([
+    ...stringList(payload["aliases"]),
+    ...stringList(payload["object_aliases"]),
+    ...stringList(payload["objectAliases"]),
+    ...stringList(payload["visualObjectAliases"]),
+    ...stringList(payload["visual_object_aliases"]),
+    ...stringList(media["aliases"]),
+    ...stringList(media["objectAliases"]),
+    ...stringList(media["object_aliases"]),
+    ...candidates.slice(1)
+  ]).filter((label) => !isRejectedObjectLabel(label, payload));
+  return {
+    label: candidates[0],
+    aliases,
+    source: candidates.length > 0 ? "explicit_visual_object_label" : void 0
+  };
+}
+function formatVisualObjectMemoryContext(result) {
+  if (!result.taught || !result.label) return "";
+  const lines = [
+    "Visual Object Memory",
+    `- Learned object label: ${result.label}`
+  ];
+  if (result.aliases.length > 0) lines.push(`- Aliases: ${result.aliases.join(", ")}`);
+  return lines.join("\n");
+}
+async function associateVisualObjectFromImage(options2) {
+  const payload = options2.payload ?? {};
+  const extraction = extractExplicitVisualObjectLabels({
+    ...payload,
+    media: options2.media ?? payload["media"]
+  });
+  if (!extraction.label) {
+    return {
+      attempted: false,
+      taught: false,
+      aliases: [],
+      contextBlock: ""
+    };
+  }
+  const visual = options2.visualMemoryTool ?? new VisualMemoryTool();
+  const aliases = uniqueLabels(extraction.aliases.filter((alias) => alias.toLowerCase() !== extraction.label.toLowerCase()));
+  const labels = uniqueLabels([extraction.label, ...aliases]);
+  const teach = await visual.execute({
+    action: "teach",
+    image: options2.imagePath,
+    label: extraction.label,
+    aliases,
+    labels,
+    sourceSurface: options2.sourceSurface,
+    sessionId: options2.sessionId,
+    fileUniqueId: options2.media?.fileUniqueId
+  });
+  if (!teach.success) {
+    return {
+      attempted: true,
+      taught: false,
+      label: extraction.label,
+      aliases,
+      contextBlock: "",
+      output: teach.output,
+      degradedReason: teach.error || teach.output || `visual_memory teach failed for ${basename35(options2.imagePath)}`
+    };
+  }
+  const result = {
+    attempted: true,
+    taught: true,
+    label: extraction.label,
+    aliases,
+    contextBlock: "",
+    output: teach.output
+  };
+  result.contextBlock = formatVisualObjectMemoryContext(result);
+  return result;
+}
+var init_visual_object_association = __esm({
+  "packages/cli/src/tui/visual-object-association.ts"() {
+    "use strict";
+    init_dist5();
+  }
+});
+
 // packages/cli/src/tui/telegram-channel-dmn.ts
 import {
   existsSync as existsSync144,
@@ -663671,55 +664567,16 @@ function advancedOcr(imagePath) {
 async function queryVisionModel(modelName, imagePath, prompt = "Describe what you see in this image in detail. Include any text, UI elements, code, diagrams, or visual content.") {
   if (!isVisionModel(modelName)) return "";
   if (!existsSync145(imagePath)) return "";
-  const imageBuffer = readFileSync118(imagePath);
-  const base64Image = imageBuffer.toString("base64");
-  const broker = getModelBroker();
-  const decision2 = await broker.ensureModelLoadable({
-    name: modelName,
-    domain: "vision",
-    host: "ollama",
-    owner: "vision-ingress",
-    requestedNumCtx: 2048
-  });
-  let effectiveModel = modelName;
-  let numCtx;
-  if (decision2.kind === "reject") {
-    return "";
-  } else if (decision2.kind === "degrade") {
-    effectiveModel = decision2.fallback.name;
-  } else if (decision2.kind === "evict") {
-    for (const target of decision2.evictTargets) {
-      await broker.evict(target.host, target.name, "make-room-for-vision");
-    }
-    numCtx = decision2.effectiveNumCtx;
-  } else if (decision2.kind === "ok") {
-    numCtx = decision2.effectiveNumCtx;
-  } else if (decision2.kind === "wait-for-inflight") {
-    const inner = await decision2.promise;
-    if (inner.kind === "ok") numCtx = inner.effectiveNumCtx;
-    else if (inner.kind === "degrade") effectiveModel = inner.fallback.name;
-    else if (inner.kind === "reject") return "";
-  }
-  if (numCtx === void 0) {
-    const trainCtx = await broker.getNctxTrain(effectiveModel);
-    numCtx = trainCtx && trainCtx > 0 ? Math.min(trainCtx, 4096) : 2048;
-  }
   try {
-    const response = await fetch("http://localhost:11434/api/generate", {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        model: effectiveModel,
-        prompt,
-        images: [base64Image],
-        stream: false,
-        options: { temperature: 0.3, num_predict: 1024, num_ctx: numCtx }
-      })
+    const tool = new VisionTool(process.cwd());
+    const result = await tool.execute({
+      image: imagePath,
+      action: "query",
+      prompt,
+      model: modelName
     });
-    if (!response.ok) return "";
-    broker.touch("ollama", effectiveModel);
-    const data = await response.json();
-    return (data.response || "").trim();
+    if (!result.success) return "";
+    return String(result.llmContent || result.output || "").trim();
   } catch {
     return "";
   }
@@ -663790,13 +664647,13 @@ import {
   statSync as statSync50,
   statfsSync as statfsSync7,
   readFileSync as readFileSync119,
-  writeFileSync as writeFileSync78,
+  writeFileSync as writeFileSync77,
   appendFileSync as appendFileSync15
 } from "node:fs";
 import {
   join as join158,
   resolve as resolve62,
-  basename as basename35,
+  basename as basename36,
   relative as relative16,
   isAbsolute as isAbsolute11,
   extname as extname21
@@ -666265,6 +667122,7 @@ var init_telegram_bridge = __esm({
     init_soul_observations();
     init_identity_memory_tool();
     init_visual_identity_association();
+    init_visual_object_association();
     init_telegram_channel_dmn();
     init_telegram_reflection_corpus();
     init_memory_paths();
@@ -669265,6 +670123,14 @@ ${mediaContext}` : ""
         const messageText = isReplyMedia ? msg.replyContext?.text || msg.replyContext?.caption || msg.replyToText || media.caption : msg.text || media.caption;
         const sender = isReplyMedia ? this.telegramMemorySenderFromReply(msg) : this.telegramMemorySenderFromMessage(msg);
         const modality = media.type === "audio" || media.type === "voice" ? "audio" : telegramMediaIsImage(media) ? "visual" : "text";
+        const objectLabels = extractExplicitVisualObjectLabels({
+          caption: media.caption,
+          media: { caption: media.caption }
+        });
+        const structuredObjectLabels = [
+          objectLabels.label,
+          ...objectLabels.aliases
+        ].filter((label) => typeof label === "string" && label.trim().length > 0);
         const payload = {
           sourceSurface: "telegram",
           sessionId: this.sessionKeyForMessage(msg),
@@ -669300,8 +670166,12 @@ ${mediaContext}` : ""
           sender_id: sender?.id,
           username: sender?.username,
           display_name: sender?.displayName,
-          labels: [media.caption].filter(Boolean)
+          labels: structuredObjectLabels
         };
+        if (objectLabels.label) {
+          payload.object_label = objectLabels.label;
+          payload.aliases = objectLabels.aliases;
+        }
         if (extractedContent) {
           if (modality === "audio") payload.transcript = extractedContent;
           else payload.extractedContent = extractedContent;
@@ -670202,7 +671072,7 @@ ${mediaContext}` : ""
               autoFollowup: false
             }
           };
-          writeFileSync78(
+          writeFileSync77(
             this.telegramConversationPath(sessionKey),
             JSON.stringify(payload, null, 2) + "\n",
             "utf8"
@@ -671031,7 +671901,7 @@ ${mediaContext}` : ""
         }
         const matchingEntry = mediaEntries.find((entry) => {
           if (resolve62(entry.localPath) === resolve62(raw)) return true;
-          if (basename35(entry.localPath) === raw) return true;
+          if (basename36(entry.localPath) === raw) return true;
           if (entry.fileUniqueId === raw || entry.fileId === raw) return true;
           if (entry.messageId && String(entry.messageId) === raw) return true;
           if (entry.messageId && `message_id:${entry.messageId}` === raw.toLowerCase())
@@ -671072,7 +671942,7 @@ ${mediaContext}` : ""
             sourceMessageId,
             chatKey,
             mediaKind,
-            safeAlias: basename35(result.path)
+            safeAlias: basename36(result.path)
           }
         };
       }
@@ -671113,7 +671983,7 @@ ${mediaContext}` : ""
           }
           return entries.find((entry2) => {
             if (resolve62(entry2.localPath) === resolve62(ref)) return true;
-            if (basename35(entry2.localPath) === ref) return true;
+            if (basename36(entry2.localPath) === ref) return true;
             if (entry2.fileUniqueId === ref || entry2.fileId === ref) return true;
             if (entry2.messageId && String(entry2.messageId) === ref) return true;
             return false;
@@ -671141,7 +672011,7 @@ ${mediaContext}` : ""
             caption: entry.caption
           },
           modality,
-          label: `Telegram message_id ${entry.messageId || "unknown"} ${basename35(entry.localPath)}`,
+          label: `Telegram message_id ${entry.messageId || "unknown"} ${basename36(entry.localPath)}`,
           extractedContent: entry.extractedContent
         };
       }
@@ -672307,8 +673177,8 @@ ${cardLines.join("\n")}`
             const caption = entry.caption ? ` caption=${telegramContextJsonString(entry.caption, 120)}` : "";
             const extracted = entry.extractedContent ? `
     extracted=${telegramContextJsonString(entry.extractedContent.replace(/\s+/g, " "), 220)}` : "";
-            const alias = entry.messageId ? `message_id:${entry.messageId}` : basename35(entry.localPath);
-            return `- ${alias}${replyMark}: ${kind}; file ${basename35(entry.localPath)}${caption}${extracted}`;
+            const alias = entry.messageId ? `message_id:${entry.messageId}` : basename36(entry.localPath);
+            return `- ${alias}${replyMark}: ${kind}; file ${basename36(entry.localPath)}${caption}${extracted}`;
           });
           sections.push(
             [
@@ -674805,7 +675675,7 @@ ${TELEGRAM_PUBLIC_ORCHESTRATOR_CONTRACT}`
               throw e2;
           }
         }
-        writeFileSync78(
+        writeFileSync77(
           lockFile,
           JSON.stringify(
             {
@@ -679758,7 +680628,7 @@ Scoped workspace: ${scopedRoot}`,
       }
       writeTelegramToolButtonState(state) {
         mkdirSync89(this.telegramToolButtonDir, { recursive: true });
-        writeFileSync78(
+        writeFileSync77(
           this.telegramToolButtonPath(state.nonce),
           JSON.stringify(state, null, 2) + "\n",
           "utf-8"
@@ -680661,12 +681531,12 @@ Advanced text extraction signal: chars=${advancedSignal.chars}, lines=${advanced
               };
             }
             const lines = entries.map((entry, index) => {
-              const pathAlias = entry.messageId ? `message_id:${entry.messageId}` : basename35(entry.localPath);
+              const pathAlias = entry.messageId ? `message_id:${entry.messageId}` : basename36(entry.localPath);
               const parts = [
                 `${index + 1}. message_id ${entry.messageId || "unknown"}`,
                 currentMsg?.replyToMessageId === entry.messageId ? "replied-to" : "",
                 telegramCachedMediaIsImage(entry) ? "image" : telegramCachedMediaIsPdf(entry) ? "pdf" : telegramCachedMediaIsAudio(entry) ? "audio" : telegramCachedMediaIsVideo(entry) ? "video" : entry.mediaType,
-                `file=${basename35(entry.localPath)}`,
+                `file=${basename36(entry.localPath)}`,
                 `path_alias=${pathAlias}`,
                 entry.caption ? `caption=${telegramContextJsonString(entry.caption, 140)}` : ""
               ].filter(Boolean);
@@ -680849,8 +681719,8 @@ Advanced text extraction signal: chars=${advancedSignal.chars}, lines=${advanced
             )) {
               return {
                 success: true,
-                output: `Telegram file already sent in this turn: ${basename35(file.path)} as ${kind} to ${String(target.chatId)}`,
-                llmContent: `Already sent ${basename35(file.path)} to Telegram as ${kind}; do not send it again.`,
+                output: `Telegram file already sent in this turn: ${basename36(file.path)} as ${kind} to ${String(target.chatId)}`,
+                llmContent: `Already sent ${basename36(file.path)} to Telegram as ${kind}; do not send it again.`,
                 durationMs: performance.now() - start2,
                 mutated: false,
                 mutatedFiles: []
@@ -680877,8 +681747,8 @@ Advanced text extraction signal: chars=${advancedSignal.chars}, lines=${advanced
               );
               return {
                 success: true,
-                output: `Sent Telegram file: ${basename35(file.path)} as ${kind} to ${String(target.chatId)}${messageId ? ` (message_id ${messageId})` : ""}`,
-                llmContent: `Sent ${basename35(file.path)} to Telegram as ${kind}.`,
+                output: `Sent Telegram file: ${basename36(file.path)} as ${kind} to ${String(target.chatId)}${messageId ? ` (message_id ${messageId})` : ""}`,
+                llmContent: `Sent ${basename36(file.path)} to Telegram as ${kind}.`,
                 durationMs: performance.now() - start2,
                 mutated: false,
                 mutatedFiles: []
@@ -681164,6 +682034,7 @@ ${visionContext}]`;
             cacheEntry.extractedContent
           );
           let visualIdentityContext = "";
+          let visualObjectContext = "";
           let ingestReachedDaemon = false;
           try {
             const ingestResponse = await fetch(
@@ -681181,6 +682052,9 @@ ${visionContext}]`;
               const block = ingested?.visualIdentity?.contextBlock;
               if (typeof block === "string" && block.trim())
                 visualIdentityContext = block.trim();
+              const objectBlock = ingested?.visualObjectMemory?.contextBlock;
+              if (typeof objectBlock === "string" && objectBlock.trim())
+                visualObjectContext = objectBlock.trim();
             }
           } catch {
           }
@@ -681202,8 +682076,29 @@ ${visionContext}]`;
                 visualIdentityContext = association.contextBlock;
             } catch {
             }
+            try {
+              const objectMemory = await associateVisualObjectFromImage({
+                repoRoot: this.repoRoot,
+                imagePath: localPath,
+                sourceSurface: "telegram",
+                scope: ingestPayload["scope"],
+                sender: ingestPayload["sender"],
+                message: ingestPayload["message"],
+                replyTo: ingestPayload["replyTo"],
+                sessionId: typeof ingestPayload["sessionId"] === "string" ? ingestPayload["sessionId"] : this.sessionKeyForMessage(msg),
+                media: ingestPayload["media"],
+                extractedContent: cacheEntry.extractedContent,
+                payload: ingestPayload
+              });
+              if (objectMemory.contextBlock)
+                visualObjectContext = objectMemory.contextBlock;
+            } catch {
+            }
           }
-          description = appendMediaContextBlock(description, visualIdentityContext);
+          description = appendMediaContextBlock(
+            description,
+            [visualIdentityContext, visualObjectContext].filter(Boolean).join("\n\n")
+          );
         } else if (isImageMedia) {
           description = `[${sourceLabel}image received: path_alias=${mediaAlias}${safeCaption}. Full visual comprehension pending; use image='${source === "reply" ? "reply" : "latest"}' or image='${mediaAlias}' with telegram_image_analyze detail='full'.]`;
           cacheEntry.analysisComplete = false;
@@ -681512,7 +682407,7 @@ ${text2}`.trim()
           throw new Error(`File does not exist: ${media.value}`);
         const buffer2 = readFileSync119(media.value);
         const boundary = `----omnius-media-${Date.now()}-${Math.random().toString(36).slice(2)}`;
-        const filename = basename35(media.value);
+        const filename = basename36(media.value);
         const contentType = mimeForPath(media.value, media.kind);
         const parts = [];
         const addField = (name10, value2) => {
@@ -681750,7 +682645,7 @@ Content-Type: ${contentType}\r
               audioAsVoice: false
             },
             {
-              caption: `Vision action loop screenshot: ${basename35(abs)}`
+              caption: `Vision action loop screenshot: ${basename36(abs)}`
             }
           ).catch(() => null);
         }
@@ -681830,7 +682725,7 @@ Content-Type: ${contentType}\r
             continue;
           }
           const buffer2 = readFileSync119(pathOrFileId);
-          const filename = basename35(pathOrFileId);
+          const filename = basename36(pathOrFileId);
           parts.push(Buffer.from(`--${boundary}\r
 `));
           parts.push(
@@ -683607,9 +684502,9 @@ __export(projects_exports, {
   setCurrentProject: () => setCurrentProject,
   unregisterProject: () => unregisterProject
 });
-import { readFileSync as readFileSync120, writeFileSync as writeFileSync79, mkdirSync as mkdirSync90, existsSync as existsSync147, statSync as statSync51, renameSync as renameSync12 } from "node:fs";
+import { readFileSync as readFileSync120, writeFileSync as writeFileSync78, mkdirSync as mkdirSync90, existsSync as existsSync147, statSync as statSync51, renameSync as renameSync12 } from "node:fs";
 import { homedir as homedir52 } from "node:os";
-import { basename as basename36, join as join159, resolve as resolve63 } from "node:path";
+import { basename as basename37, join as join159, resolve as resolve63 } from "node:path";
 import { randomUUID as randomUUID19 } from "node:crypto";
 function readAll2() {
   try {
@@ -683625,7 +684520,7 @@ function readAll2() {
 function writeAll(file) {
   mkdirSync90(OMNIUS_DIR3, { recursive: true });
   const tmp = `${PROJECTS_FILE}.${randomUUID19().slice(0, 8)}.tmp`;
-  writeFileSync79(tmp, JSON.stringify(file, null, 2), "utf8");
+  writeFileSync78(tmp, JSON.stringify(file, null, 2), "utf8");
   renameSync12(tmp, PROJECTS_FILE);
 }
 function listProjects() {
@@ -683657,7 +684552,7 @@ function registerProject(root, pid) {
   } else {
     entry = {
       root: canonical,
-      name: basename36(canonical) || canonical,
+      name: basename37(canonical) || canonical,
       firstSeen: now2,
       lastSeen: now2,
       pid: pid ?? null,
@@ -683708,7 +684603,7 @@ function setCurrentProject(root) {
   currentRoot = canonical;
   try {
     mkdirSync90(OMNIUS_DIR3, { recursive: true });
-    writeFileSync79(CURRENT_FILE, `${canonical}
+    writeFileSync78(CURRENT_FILE, `${canonical}
 `, "utf8");
   } catch {
   }
@@ -684605,7 +685500,7 @@ var init_access_policy = __esm({
 
 // packages/cli/src/api/project-preferences.ts
 import { createHash as createHash42 } from "node:crypto";
-import { existsSync as existsSync148, mkdirSync as mkdirSync91, readFileSync as readFileSync121, renameSync as renameSync13, writeFileSync as writeFileSync80, unlinkSync as unlinkSync34 } from "node:fs";
+import { existsSync as existsSync148, mkdirSync as mkdirSync91, readFileSync as readFileSync121, renameSync as renameSync13, writeFileSync as writeFileSync79, unlinkSync as unlinkSync34 } from "node:fs";
 import { homedir as homedir53 } from "node:os";
 import { join as join160, resolve as resolve64 } from "node:path";
 import { randomUUID as randomUUID20 } from "node:crypto";
@@ -684628,7 +685523,7 @@ function ensureDir(root) {
   const sentinel = rootSentinelPath(root);
   try {
     if (!existsSync148(sentinel)) {
-      writeFileSync80(sentinel, `${resolve64(root)}
+      writeFileSync79(sentinel, `${resolve64(root)}
 `, "utf8");
     }
   } catch {
@@ -684657,12 +685552,12 @@ function writeProjectPreferences(root, partial) {
   };
   const file = prefsPath(root);
   const tmp = `${file}.${randomUUID20().slice(0, 8)}.tmp`;
-  writeFileSync80(tmp, JSON.stringify(merged, null, 2), "utf8");
+  writeFileSync79(tmp, JSON.stringify(merged, null, 2), "utf8");
   try {
     renameSync13(tmp, file);
   } catch (err) {
     try {
-      writeFileSync80(file, JSON.stringify(merged, null, 2), "utf8");
+      writeFileSync79(file, JSON.stringify(merged, null, 2), "utf8");
     } catch {
     }
     try {
@@ -685067,7 +685962,7 @@ data: ${JSON.stringify(ev)}
 
 // packages/cli/src/api/routes-media.ts
 import { existsSync as existsSync151, mkdirSync as mkdirSync94, statSync as statSync53, copyFileSync as copyFileSync7, createReadStream } from "node:fs";
-import { basename as basename37, join as join162, resolve as pathResolve2 } from "node:path";
+import { basename as basename38, join as join162, resolve as pathResolve2 } from "node:path";
 function mediaWorkDir() {
   return join162(omniusHomeDir(), "media", "_work");
 }
@@ -685089,7 +685984,7 @@ function extractGeneratedPath(output) {
 function publishToGallery(srcPath, kind) {
   ensureGlobalMediaDirs();
   const dir = globalMediaDir(kind);
-  const name10 = basename37(srcPath);
+  const name10 = basename38(srcPath);
   const dest = join162(dir, name10);
   try {
     if (pathResolve2(srcPath) !== pathResolve2(dest)) {
@@ -685290,7 +686185,7 @@ async function handleAvAnalyze(ctx3) {
       adapterStatus[role] = a2 && !a2.meta.isMock ? "live" : "mock";
       if (adapterStatus[role] === "live") anyLive = true;
     }
-    const episodeId = `rest-${basename37(filePath)}-${Date.now().toString(36)}`;
+    const episodeId = `rest-${basename38(filePath)}-${Date.now().toString(36)}`;
     const ingest = await ingestMedia(episodeId, `file://${filePath}`);
     const store2 = await analyzeEpisode({ episodeId, mediaUri: `file://${filePath}`, durationSec: ingest.source.durationSec, registry: registry4, windows: ingest.shots, roles: AV_ROLES });
     const world = store2.snapshot();
@@ -685460,7 +686355,7 @@ function handleFile(ctx3) {
     return true;
   }
   const dir = globalMediaDir(kind);
-  const full = pathResolve2(dir, basename37(name10));
+  const full = pathResolve2(dir, basename38(name10));
   if (!full.startsWith(pathResolve2(dir)) || !existsSync151(full)) {
     sendProblem(ctx3.res, problemDetails({
       type: P.notFound,
@@ -685705,7 +686600,7 @@ var init_direct_tool_registry = __esm({
 });
 
 // packages/cli/src/api/external-tool-registry.ts
-import { existsSync as existsSync152, mkdirSync as mkdirSync95, readFileSync as readFileSync123, writeFileSync as writeFileSync81, renameSync as renameSync14 } from "node:fs";
+import { existsSync as existsSync152, mkdirSync as mkdirSync95, readFileSync as readFileSync123, writeFileSync as writeFileSync80, renameSync as renameSync14 } from "node:fs";
 import { join as join163 } from "node:path";
 function externalToolStorePath(workingDir) {
   return join163(workingDir, ".omnius", "external-tools.json");
@@ -685728,7 +686623,7 @@ function persist3(workingDir, tools) {
   mkdirSync95(join163(workingDir, ".omnius"), { recursive: true });
   const file = { version: STORE_VERSION, tools };
   const tmp = `${path12}.tmp`;
-  writeFileSync81(tmp, JSON.stringify(file, null, 2), { mode: 384 });
+  writeFileSync80(tmp, JSON.stringify(file, null, 2), { mode: 384 });
   renameSync14(tmp, path12);
 }
 function validateManifest2(input, existing) {
@@ -686840,7 +687735,7 @@ __export(runtime_keys_exports, {
   mintKey: () => mintKey,
   revokeByPrefix: () => revokeByPrefix
 });
-import { existsSync as existsSync154, readFileSync as readFileSync125, writeFileSync as writeFileSync82, mkdirSync as mkdirSync96, chmodSync as chmodSync4 } from "node:fs";
+import { existsSync as existsSync154, readFileSync as readFileSync125, writeFileSync as writeFileSync81, mkdirSync as mkdirSync96, chmodSync as chmodSync4 } from "node:fs";
 import { join as join165 } from "node:path";
 import { homedir as homedir55 } from "node:os";
 import { randomBytes as randomBytes27 } from "node:crypto";
@@ -686861,7 +687756,7 @@ function loadAll() {
 }
 function persistAll(records) {
   ensureDir2();
-  writeFileSync82(KEYS_FILE, JSON.stringify(records, null, 2), "utf-8");
+  writeFileSync81(KEYS_FILE, JSON.stringify(records, null, 2), "utf-8");
   try {
     chmodSync4(KEYS_FILE, 384);
   } catch {
@@ -687095,7 +687990,7 @@ __export(graphical_sudo_exports, {
   runGraphicalSudo: () => runGraphicalSudo
 });
 import { spawn as spawn31 } from "node:child_process";
-import { existsSync as existsSync156, mkdirSync as mkdirSync97, writeFileSync as writeFileSync83, chmodSync as chmodSync5 } from "node:fs";
+import { existsSync as existsSync156, mkdirSync as mkdirSync97, writeFileSync as writeFileSync82, chmodSync as chmodSync5 } from "node:fs";
 import { join as join167 } from "node:path";
 import { tmpdir as tmpdir22 } from "node:os";
 function detectSudoHelper() {
@@ -687131,7 +688026,7 @@ exec zenity --password --title="Omnius needs sudo" --text="${description.replace
 exec kdialog --password "${description.replace(/"/g, '\\"')}" 2>/dev/null
 `;
   }
-  writeFileSync83(shim, body, "utf-8");
+  writeFileSync82(shim, body, "utf-8");
   chmodSync5(shim, 493);
   return shim;
 }
@@ -702167,7 +703062,7 @@ var init_auth_oidc = __esm({
 });
 
 // packages/cli/src/api/usage-tracker.ts
-import { mkdirSync as mkdirSync99, readFileSync as readFileSync128, writeFileSync as writeFileSync84, existsSync as existsSync158 } from "node:fs";
+import { mkdirSync as mkdirSync99, readFileSync as readFileSync128, writeFileSync as writeFileSync83, existsSync as existsSync158 } from "node:fs";
 import { join as join169 } from "node:path";
 function initUsageTracker(omniusDir) {
   const dir = join169(omniusDir, "usage");
@@ -702211,7 +703106,7 @@ function flush2() {
   if (!initialized2 || !dirty) return;
   try {
     store.lastSaved = (/* @__PURE__ */ new Date()).toISOString();
-    writeFileSync84(usageFile, JSON.stringify(store, null, 2), "utf-8");
+    writeFileSync83(usageFile, JSON.stringify(store, null, 2), "utf-8");
     dirty = false;
   } catch {
   }
@@ -702386,7 +703281,7 @@ var init_chat_followup = __esm({
 
 // packages/cli/src/docker.ts
 import { execSync as execSync59, spawn as spawn32 } from "node:child_process";
-import { existsSync as existsSync159, mkdirSync as mkdirSync100, writeFileSync as writeFileSync85 } from "node:fs";
+import { existsSync as existsSync159, mkdirSync as mkdirSync100, writeFileSync as writeFileSync84 } from "node:fs";
 import { join as join170, resolve as resolve65, dirname as dirname50 } from "node:path";
 import { homedir as homedir58 } from "node:os";
 import { fileURLToPath as fileURLToPath19 } from "node:url";
@@ -702611,8 +703506,8 @@ chown -R node:node /workspace /home/node/.omnius 2>/dev/null || true
 if [ "$1" = "omnius" ]; then shift; exec su - node -c "cd /workspace && omnius $*"; fi
 exec "$@"
 `;
-  writeFileSync85(join170(dir, "Dockerfile"), dockerfile);
-  writeFileSync85(join170(dir, "docker-entrypoint.sh"), entrypoint, { mode: 493 });
+  writeFileSync84(join170(dir, "Dockerfile"), dockerfile);
+  writeFileSync84(join170(dir, "docker-entrypoint.sh"), entrypoint, { mode: 493 });
 }
 function hasNvidiaGpu() {
   try {
@@ -702685,7 +703580,7 @@ __export(embedding_workers_exports, {
   startEmbeddingWorkers: () => startEmbeddingWorkers,
   stopEmbeddingWorkers: () => stopEmbeddingWorkers
 });
-import { basename as basename38, join as join171 } from "node:path";
+import { basename as basename39, join as join171 } from "node:path";
 function startEmbeddingWorkers(opts) {
   if (_running) return;
   _running = true;
@@ -702751,7 +703646,7 @@ async function runEmbeddingTask(modality, episodeId, taskId, opts) {
     try {
       if (!_aligner) {
         const stateRoot = process.env.OMNIUS_DIR || process.cwd();
-        const omniusDir = basename38(stateRoot) === ".omnius" ? stateRoot : join171(stateRoot, ".omnius");
+        const omniusDir = basename39(stateRoot) === ".omnius" ? stateRoot : join171(stateRoot, ".omnius");
         const memDir = join171(omniusDir, "memory");
         _aligner = new EmbeddingAligner(
           `${modality}-${emb.length}`,
@@ -702873,7 +703768,7 @@ import { spawn as spawn33, execSync as execSync60 } from "node:child_process";
 import {
   createReadStream as createReadStream2,
   mkdirSync as mkdirSync101,
-  writeFileSync as writeFileSync86,
+  writeFileSync as writeFileSync85,
   readFileSync as readFileSync129,
   readdirSync as readdirSync56,
   existsSync as existsSync160,
@@ -704534,11 +705429,11 @@ function atomicJobWrite(dir, id, job) {
   const finalPath = join172(dir, `${id}.json`);
   const tmpPath = `${finalPath}.tmp.${process.pid}.${Date.now()}`;
   try {
-    writeFileSync86(tmpPath, JSON.stringify(job, null, 2), "utf-8");
+    writeFileSync85(tmpPath, JSON.stringify(job, null, 2), "utf-8");
     renameSync15(tmpPath, finalPath);
   } catch {
     try {
-      writeFileSync86(finalPath, JSON.stringify(job, null, 2), "utf-8");
+      writeFileSync85(finalPath, JSON.stringify(job, null, 2), "utf-8");
     } catch {
     }
     try {
@@ -706370,7 +707265,7 @@ function writeUpdateState(state) {
     mkdirSync101(dir, { recursive: true });
     const finalPath = updateStateFile();
     const tmpPath = `${finalPath}.tmp.${process.pid}`;
-    writeFileSync86(tmpPath, JSON.stringify(state, null, 2), "utf-8");
+    writeFileSync85(tmpPath, JSON.stringify(state, null, 2), "utf-8");
     renameSync15(tmpPath, finalPath);
   } catch {
   }
@@ -708720,13 +709615,13 @@ async function handleRequest(req3, res, ollamaUrl, verbose, runtimeDefaults = {}
           return;
         }
         const { tmpdir: tmpdir24 } = await import("node:os");
-        const { writeFileSync: writeFileSync91, unlinkSync: unlinkSync36 } = await import("node:fs");
+        const { writeFileSync: writeFileSync90, unlinkSync: unlinkSync36 } = await import("node:fs");
         const { join: pjoin } = await import("node:path");
         const tmpPath = pjoin(
           tmpdir24(),
           `omnius-clone-upload-${Date.now()}-${safeName3}`
         );
-        writeFileSync91(tmpPath, buf);
+        writeFileSync90(tmpPath, buf);
         try {
           const ve = getVoiceEngine();
           const msg = await ve.setCloneVoice(tmpPath);
@@ -709450,7 +710345,7 @@ data: ${JSON.stringify(data)}
         }
         for (const f2 of seenFiles) {
           try {
-            writeFileSync86(f2, JSON.stringify({ tasks: [] }, null, 2));
+            writeFileSync85(f2, JSON.stringify({ tasks: [] }, null, 2));
             deleted++;
           } catch {
           }
@@ -711249,11 +712144,11 @@ function setScheduledEnabled(id, enabled2) {
     arr[target.index].enabled = enabled2;
     if (Array.isArray(json?.tasks)) {
       json.tasks = arr;
-      writeFileSync86(target.file, JSON.stringify(json, null, 2));
+      writeFileSync85(target.file, JSON.stringify(json, null, 2));
     } else if (Array.isArray(json)) {
-      writeFileSync86(target.file, JSON.stringify(arr, null, 2));
+      writeFileSync85(target.file, JSON.stringify(arr, null, 2));
     } else {
-      writeFileSync86(target.file, JSON.stringify({ tasks: arr }, null, 2));
+      writeFileSync85(target.file, JSON.stringify({ tasks: arr }, null, 2));
     }
     if (!enabled2) {
       try {
@@ -711283,11 +712178,11 @@ function deleteScheduledById(id) {
     arr.splice(target.index, 1);
     if (Array.isArray(json?.tasks)) {
       json.tasks = arr;
-      writeFileSync86(target.file, JSON.stringify(json, null, 2));
+      writeFileSync85(target.file, JSON.stringify(json, null, 2));
     } else if (Array.isArray(json)) {
-      writeFileSync86(target.file, JSON.stringify(arr, null, 2));
+      writeFileSync85(target.file, JSON.stringify(arr, null, 2));
     } else {
-      writeFileSync86(target.file, JSON.stringify({ tasks: arr }, null, 2));
+      writeFileSync85(target.file, JSON.stringify({ tasks: arr }, null, 2));
     }
     const candidates = [];
     if (id) candidates.push(id);
@@ -711521,7 +712416,7 @@ function reconcileScheduledTasks(apply) {
           mkdirSync101(join172(wdir, ".omnius", "scheduled", "logs"), {
             recursive: true
           });
-          writeFileSync86(file, JSON.stringify(toWrite, null, 2));
+          writeFileSync85(file, JSON.stringify(toWrite, null, 2));
           adopted.push({ file, index: arr.length - 1 });
         }
       } else {
@@ -711699,8 +712594,8 @@ WantedBy=timers.target
 `;
         if (!dryRun) {
           mkdirSync101(unitDir, { recursive: true });
-          writeFileSync86(svc, svcText);
-          writeFileSync86(tim, timText);
+          writeFileSync85(svc, svcText);
+          writeFileSync85(tim, timText);
           try {
             const { execSync: es } = require4("node:child_process");
             es("systemctl --user daemon-reload", { stdio: "pipe" });
@@ -712084,7 +712979,7 @@ function startApiServer(options2 = {}) {
             try {
               const dir = join172(homedir59(), ".omnius");
               mkdirSync101(dir, { recursive: true });
-              writeFileSync86(
+              writeFileSync85(
                 join172(dir, "access"),
                 `${runtimeAccessMode}
 `,
@@ -712497,7 +713392,7 @@ function startApiServer(options2 = {}) {
     }
     try {
       const {
-        writeFileSync: writeFileSync91,
+        writeFileSync: writeFileSync90,
         mkdirSync: mkdirSync106,
         existsSync: _exists,
         readFileSync: _rfs
@@ -712536,7 +713431,7 @@ function startApiServer(options2 = {}) {
       for (const dir of dirSet) {
         try {
           if (!_exists(dir)) mkdirSync106(dir, { recursive: true });
-          writeFileSync91(_join(dir, "api-port.json"), apiHint);
+          writeFileSync90(_join(dir, "api-port.json"), apiHint);
           written++;
         } catch {
         }
@@ -712905,7 +713800,7 @@ async function handleChatAttachmentUpload(req3, res) {
       dir,
       `${Date.now()}-${randomUUID21().slice(0, 8)}-${safeName3}`
     );
-    writeFileSync86(localPath, Buffer.from(base642, "base64"));
+    writeFileSync85(localPath, Buffer.from(base642, "base64"));
     const mimeType = typeof b.mimeType === "string" ? b.mimeType : typeof b.mime_type === "string" ? b.mime_type : "";
     const isImage = mimeType.toLowerCase().startsWith("image/") || /\.(png|jpe?g|gif|webp|bmp|tiff?)$/i.test(safeName3);
     const sessionId = typeof b.sessionId === "string" ? b.sessionId : typeof b.session_id === "string" ? b.session_id : void 0;
@@ -712962,6 +713857,7 @@ async function handleChatAttachmentUpload(req3, res) {
       graph.close();
     }
     let visualIdentity = void 0;
+    let visualObjectMemory = void 0;
     let contextBlock = [
       `GUI attachment saved: ${safeName3}`,
       `path: ${localPath}`,
@@ -713000,6 +713896,40 @@ ${association.contextBlock}`;
           degradedReason: err instanceof Error ? err.message : String(err)
         };
       }
+      try {
+        const { associateVisualObjectFromImage: associateVisualObjectFromImage2 } = await Promise.resolve().then(() => (init_visual_object_association(), visual_object_association_exports));
+        const objectMemory = await associateVisualObjectFromImage2({
+          repoRoot: process.cwd(),
+          imagePath: localPath,
+          sourceSurface: "gui",
+          scope,
+          sender,
+          message: message2,
+          sessionId,
+          media,
+          payload: b
+        });
+        visualObjectMemory = {
+          attempted: objectMemory.attempted,
+          taught: objectMemory.taught,
+          label: objectMemory.label,
+          aliases: objectMemory.aliases,
+          contextBlock: objectMemory.contextBlock,
+          degradedReason: objectMemory.degradedReason
+        };
+        if (objectMemory.contextBlock)
+          contextBlock += `
+
+${objectMemory.contextBlock}`;
+      } catch (err) {
+        visualObjectMemory = {
+          attempted: true,
+          taught: false,
+          aliases: [],
+          contextBlock: "",
+          degradedReason: err instanceof Error ? err.message : String(err)
+        };
+      }
     }
     jsonResponse(res, 200, {
       id: ingestId,
@@ -713008,7 +713938,8 @@ ${association.contextBlock}`;
       mimeType,
       modality,
       contextBlock,
-      visualIdentity
+      visualIdentity,
+      visualObjectMemory
     });
   } catch (err) {
     jsonResponse(res, 400, {
@@ -713141,6 +714072,7 @@ async function handleMemoryIngest2(req3, res, ollamaUrl) {
       embeddings
     });
     let visualIdentity = void 0;
+    let visualObjectMemory = void 0;
     if (modality === "visual" && mediaPath) {
       try {
         const { associateVisualIdentityFromImage: associateVisualIdentityFromImage2 } = await Promise.resolve().then(() => (init_visual_identity_association(), visual_identity_association_exports));
@@ -713174,8 +714106,40 @@ async function handleMemoryIngest2(req3, res, ollamaUrl) {
           degradedReason: err instanceof Error ? err.message : String(err)
         };
       }
+      try {
+        const { associateVisualObjectFromImage: associateVisualObjectFromImage2 } = await Promise.resolve().then(() => (init_visual_object_association(), visual_object_association_exports));
+        const objectMemory = await associateVisualObjectFromImage2({
+          repoRoot: process.cwd(),
+          imagePath: mediaPath,
+          sourceSurface,
+          scope,
+          sender,
+          message: message2,
+          replyTo,
+          sessionId,
+          media,
+          extractedContent: b.extracted_content || b.extractedContent,
+          payload: b
+        });
+        visualObjectMemory = {
+          attempted: objectMemory.attempted,
+          taught: objectMemory.taught,
+          label: objectMemory.label,
+          aliases: objectMemory.aliases,
+          contextBlock: objectMemory.contextBlock,
+          degradedReason: objectMemory.degradedReason
+        };
+      } catch (err) {
+        visualObjectMemory = {
+          attempted: true,
+          taught: false,
+          aliases: [],
+          contextBlock: "",
+          degradedReason: err instanceof Error ? err.message : String(err)
+        };
+      }
     }
-    jsonResponse(res, 200, { id: result.episodeId, ...result, visualIdentity });
+    jsonResponse(res, 200, { id: result.episodeId, ...result, visualIdentity, visualObjectMemory });
   } catch (err) {
     jsonResponse(res, 400, {
       error: "bad_request",
@@ -713391,7 +714355,7 @@ __export(clipboard_media_exports, {
   pasteClipboardImageToFile: () => pasteClipboardImageToFile
 });
 import { execFileSync as execFileSync11, execSync as execSync61 } from "node:child_process";
-import { mkdirSync as mkdirSync102, readFileSync as readFileSync130, rmSync as rmSync13, writeFileSync as writeFileSync87 } from "node:fs";
+import { mkdirSync as mkdirSync102, readFileSync as readFileSync130, rmSync as rmSync13, writeFileSync as writeFileSync86 } from "node:fs";
 import { join as join173 } from "node:path";
 function pasteClipboardImageToFile(repoRoot) {
   const image = readClipboardImage();
@@ -713399,7 +714363,7 @@ function pasteClipboardImageToFile(repoRoot) {
   const dir = join173(repoRoot, ".omnius", "clipboard");
   mkdirSync102(dir, { recursive: true });
   const path12 = join173(dir, `clipboard-${Date.now()}${image.ext}`);
-  writeFileSync87(path12, image.buffer);
+  writeFileSync86(path12, image.buffer);
   return { path: path12, buffer: image.buffer, mime: image.mime };
 }
 function readClipboardImage() {
@@ -713468,7 +714432,7 @@ import { createRequire as createRequire9 } from "node:module";
 import { fileURLToPath as fileURLToPath21 } from "node:url";
 import {
   readFileSync as readFileSync131,
-  writeFileSync as writeFileSync88,
+  writeFileSync as writeFileSync87,
   appendFileSync as appendFileSync17,
   rmSync as rmSync14,
   readdirSync as readdirSync57,
@@ -714595,7 +715559,7 @@ function createFanoutExploreTool(config, repoRoot, ctxWindowSize) {
       );
       if (debug) {
         try {
-          writeFileSync88(
+          writeFileSync87(
             join174(repoRoot, ".omnius", "fanout-debug.json"),
             JSON.stringify({ objective, regions, rawReturns, digests }, null, 2)
           );
@@ -715381,7 +716345,7 @@ ${skillPack}`;
 You have vision capabilities. Choose the RIGHT tool for each situation:
 
 FOR IMAGE FILES (photos, screenshots, diagrams):
-  image_read(image="path")  — Read an image file (base64 + OCR)
+  image_read(path="path")  — Read image metadata/base64/OCR; use vision(image="path") for semantic Moondream analysis
   vision(image="path", action="caption")  — Describe image contents via Moondream
   vision(image="path", action="query", prompt="question")  — Ask questions about an image
   vision(image="path", action="detect", prompt="object")  — Find objects (bounding boxes)
@@ -716951,6 +717915,7 @@ When done, either call task_complete with your answer, or use FINAL_VAR(variable
       },
       async () => {
         const result = await runner.run(effectiveTask, systemContext);
+        _apiCallbacks?.onRunResult?.(result);
         const tokens = {
           total: result.totalTokens,
           estimated: result.estimatedTokens
@@ -718910,7 +719875,7 @@ This is an independent background session started from /background.`
       if (Math.random() < 0.02) {
         const all2 = readFileSync131(HISTORY_FILE, "utf8").trim().split("\n");
         if (all2.length > MAX_HISTORY_LINES) {
-          writeFileSync88(
+          writeFileSync87(
             HISTORY_FILE,
             all2.slice(-MAX_HISTORY_LINES).join("\n") + "\n",
             "utf8"
@@ -719851,7 +720816,7 @@ Log: ${nexusLogPath}`
       sessionTitle = title.trim() || null;
       try {
         mkdirSync103(join174(repoRoot, ".omnius"), { recursive: true });
-        writeFileSync88(
+        writeFileSync87(
           join174(repoRoot, ".omnius", "session-title"),
           `${sessionTitle ?? ""}
 `,
@@ -719945,7 +720910,7 @@ Log: ${nexusLogPath}`
         queuePrompt(
           imageContext ? `${imageContext}
 
-The user pasted a clipboard image saved at ${relPath}. Use the OCR, vision analysis, and ASCII preview above to understand and respond to the image content.` : `The user pasted a clipboard image saved at ${relPath}. Read it with image_read or vision and respond to what is shown.`,
+The user pasted a clipboard image saved at ${relPath}. Use the OCR, vision analysis, and ASCII preview above to understand and respond to the image content.` : `The user pasted a clipboard image saved at ${relPath}. Use vision(image="${relPath}") for semantic Moondream analysis, and image_read(path="${relPath}") only if metadata/OCR/raw ingress is needed.`,
           "clipboard"
         );
         return {
@@ -722575,7 +723540,7 @@ ${result.text}`;
 
 ${imageContext}
 
-Read it with image_read or vision if more detail is needed. Describe what you see and extract any text with OCR if relevant.` : `The user has provided an image file: ${cleanPath}. Read it with image_read and describe what you see. Extract any text with OCR if relevant.`;
+Use vision(image="${cleanPath}") for additional semantic detail, and image_read(path="${cleanPath}") only if metadata/OCR/raw ingress is needed.` : `The user has provided an image file: ${cleanPath}. Use vision(image="${cleanPath}") for semantic Moondream analysis. Use image_read(path="${cleanPath}") only if metadata/OCR/raw ingress is needed.`;
     }
     if (isMedia && fullInput === input && (voiceEngine.isLuxtts || voiceEngine.isMisotts)) {
       const cloneExts = [".wav", ".mp3", ".ogg", ".flac", ".m4a"];
@@ -723233,6 +724198,7 @@ async function runWithTUI(task, config, repoPath2, callbacks) {
     }
   }
   _apiCallbacks = callbacks ?? null;
+  const headlessMode = Boolean(callbacks);
   await bootstrapMcpAndPlugins(repoRoot);
   renderCompactHeader(config.model);
   renderUserMessage(task);
@@ -723243,6 +724209,10 @@ async function runWithTUI(task, config, repoPath2, callbacks) {
   try {
     const handle2 = startTask(task, config, repoRoot);
     await handle2.promise;
+    if (headlessMode) {
+      _apiCallbacks = null;
+      return;
+    }
     try {
       const ikDir = join174(repoRoot, ".omnius", "identity");
       const ikFile = join174(ikDir, "self-state.json");
@@ -723303,7 +724273,7 @@ async function runWithTUI(task, config, repoPath2, callbacks) {
       );
       ikState.session_count = (ikState.session_count || 0) + 1;
       ikState.updated_at = (/* @__PURE__ */ new Date()).toISOString();
-      writeFileSync88(ikFile, JSON.stringify(ikState, null, 2));
+      writeFileSync87(ikFile, JSON.stringify(ikState, null, 2));
     } catch (ikErr) {
     }
     try {
@@ -723336,7 +724306,7 @@ async function runWithTUI(task, config, repoPath2, callbacks) {
         });
         if (variants.length > 50) variants = variants.slice(-50);
         mkdirSync103(archeDir, { recursive: true });
-        writeFileSync88(archeFile, JSON.stringify(variants, null, 2));
+        writeFileSync87(archeFile, JSON.stringify(variants, null, 2));
       } catch {
       }
     }
@@ -723367,7 +724337,7 @@ async function runWithTUI(task, config, repoPath2, callbacks) {
           updated = true;
         }
         if (updated) {
-          writeFileSync88(metaFile2, JSON.stringify(store2, null, 2));
+          writeFileSync87(metaFile2, JSON.stringify(store2, null, 2));
         }
       }
     } catch {
@@ -723476,7 +724446,7 @@ Rules:
           });
           if (store2.length > 100) store2 = store2.slice(-100);
           mkdirSync103(metaDir, { recursive: true });
-          writeFileSync88(storeFile, JSON.stringify(store2, null, 2));
+          writeFileSync87(storeFile, JSON.stringify(store2, null, 2));
         }
       }
     } catch {
@@ -723526,6 +724496,10 @@ Rules:
     } catch {
     }
   } catch (err) {
+    if (headlessMode) {
+      _apiCallbacks = null;
+      throw err;
+    }
     try {
       const ikFile = join174(repoRoot, ".omnius", "identity", "self-state.json");
       if (existsSync161(ikFile)) {
@@ -723540,7 +724514,7 @@ Rules:
         );
         ikState.session_count = (ikState.session_count || 0) + 1;
         ikState.updated_at = (/* @__PURE__ */ new Date()).toISOString();
-        writeFileSync88(ikFile, JSON.stringify(ikState, null, 2));
+        writeFileSync87(ikFile, JSON.stringify(ikState, null, 2));
       }
       const metaFile2 = join174(
         repoRoot,
@@ -723568,7 +724542,7 @@ Rules:
             (item.scores.confidence || 0.5) - 0.02
           );
         }
-        writeFileSync88(metaFile2, JSON.stringify(store2, null, 2));
+        writeFileSync87(metaFile2, JSON.stringify(store2, null, 2));
       }
       try {
         const archeDir = join174(repoRoot, ".omnius", "arche");
@@ -723591,7 +724565,7 @@ Rules:
         });
         if (variants.length > 50) variants = variants.slice(-50);
         mkdirSync103(archeDir, { recursive: true });
-        writeFileSync88(archeFile, JSON.stringify(variants, null, 2));
+        writeFileSync87(archeFile, JSON.stringify(variants, null, 2));
       } catch {
       }
     } catch {
@@ -723704,7 +724678,7 @@ import { resolve as resolve68 } from "node:path";
 import { spawn as spawn34 } from "node:child_process";
 import {
   mkdirSync as mkdirSync104,
-  writeFileSync as writeFileSync89,
+  writeFileSync as writeFileSync88,
   readFileSync as readFileSync132,
   readdirSync as readdirSync58,
   existsSync as existsSync162
@@ -723752,6 +724726,7 @@ async function runJson(task, config, repoPath2) {
   let result;
   const assistantTexts = [];
   const toolCallLog = [];
+  let runnerResult = null;
   try {
     await runWithTUI(task, config, repoPath2, {
       onAssistantText: (text2) => {
@@ -723775,13 +724750,29 @@ async function runJson(task, config, repoPath2) {
       },
       onStatus: (content) => {
         origWrite(JSON.stringify({ type: "status", content }) + "\n");
+      },
+      onRunResult: (runResult) => {
+        runnerResult = {
+          status: runResult.status,
+          completed: runResult.completed,
+          summary: runResult.summary,
+          turns: runResult.turns,
+          toolCalls: runResult.toolCalls,
+          filesEdited: runResult.filesEdited,
+          testsRun: runResult.testsRun
+        };
       }
     });
+    const rr = runnerResult;
     result = {
-      status: "completed",
-      summary: extractSummary(captured),
+      status: rr?.completed ? "completed" : rr?.status ?? "completed",
+      summary: rr?.summary || extractSummary(captured),
+      turns: rr?.turns,
+      toolCalls: rr?.toolCalls,
+      filesModified: rr?.filesEdited,
+      testsRun: rr?.testsRun,
       durationMs: Date.now() - startTime,
-      exitCode: 0
+      exitCode: rr && !rr.completed ? 2 : 0
     };
   } catch (err) {
     result = {
@@ -723805,7 +724796,14 @@ async function runJson(task, config, repoPath2) {
     result.tool_calls = toolCallLog;
   }
   process.stdout.write(JSON.stringify(result, null, 2) + "\n");
-  if (result.exitCode !== 0) process.exit(1);
+  if (result.exitCode !== 0) process.exit(result.exitCode);
+  if (shouldForceJsonExit()) process.exit(0);
+}
+function shouldForceJsonExit() {
+  if (process.env["OMNIUS_JSON_NO_FORCE_EXIT"] === "1") return false;
+  if (process.env["VITEST"] === "true" || process.env["NODE_ENV"] === "test")
+    return false;
+  return true;
 }
 function extractSummary(captured) {
   const all2 = captured.join("");
@@ -723844,7 +724842,7 @@ async function runBackground(task, config, opts) {
     }
   });
   job.pid = child.pid ?? 0;
-  writeFileSync89(join175(dir, `${id}.json`), JSON.stringify(job, null, 2));
+  writeFileSync88(join175(dir, `${id}.json`), JSON.stringify(job, null, 2));
   let output = "";
   child.stdout?.on("data", (chunk) => {
     output += chunk.toString();
@@ -723860,7 +724858,7 @@ async function runBackground(task, config, opts) {
       job.summary = result.summary;
       job.durationMs = result.durationMs;
       job.error = result.error;
-      writeFileSync89(join175(dir, `${id}.json`), JSON.stringify(job, null, 2));
+      writeFileSync88(join175(dir, `${id}.json`), JSON.stringify(job, null, 2));
     } catch {
     }
   });
@@ -724499,7 +725497,7 @@ __export(eval_exports, {
   evalCommand: () => evalCommand
 });
 import { tmpdir as tmpdir23 } from "node:os";
-import { mkdirSync as mkdirSync105, writeFileSync as writeFileSync90 } from "node:fs";
+import { mkdirSync as mkdirSync105, writeFileSync as writeFileSync89 } from "node:fs";
 import { join as join177 } from "node:path";
 async function evalCommand(opts, config) {
   const suiteName = opts.suite ?? "basic";
@@ -724631,7 +725629,7 @@ async function evalCommand(opts, config) {
 function createTempEvalRepo() {
   const dir = join177(tmpdir23(), `omnius-eval-${Date.now()}`);
   mkdirSync105(dir, { recursive: true });
-  writeFileSync90(
+  writeFileSync89(
     join177(dir, "package.json"),
     JSON.stringify({ name: "eval-repo", version: "0.0.0" }, null, 2) + "\n",
     "utf8"
@@ -724868,8 +725866,16 @@ function routeCommand(command) {
 }
 function parseCliArgs(argv) {
   const args = argv.slice(2);
+  const parseInput = [...args];
+  const selfTestFlagIndex = parseInput.indexOf("--self-test");
+  if (selfTestFlagIndex >= 0) {
+    const next = parseInput[selfTestFlagIndex + 1];
+    if (!next || next.startsWith("-")) {
+      parseInput.splice(selfTestFlagIndex, 1, "--self-test=crossmodal");
+    }
+  }
   const { values, positionals } = nodeParseArgs2({
-    args,
+    args: parseInput,
     options: {
       "dry-run": { type: "boolean" },
       verbose: { type: "boolean", short: "v" },
@@ -724886,6 +725892,7 @@ function parseCliArgs(argv) {
       live: { type: "boolean" },
       json: { type: "boolean", short: "j" },
       background: { type: "boolean" },
+      "self-test": { type: "string" },
       help: { type: "boolean", short: "h" },
       version: { type: "boolean", short: "V" }
     },
@@ -724908,6 +725915,7 @@ function parseCliArgs(argv) {
     local: values.local === true,
     json: values.json === true,
     background: values.background === true,
+    selfTest: typeof values["self-test"] === "string" ? values["self-test"] : void 0,
     help: values.help === true,
     version: values.version === true
   };
@@ -725013,6 +726021,23 @@ Examples:
 `.trim();
   process.stdout.write(text2 + "\n");
 }
+async function runSelfTest(mode) {
+  if (mode !== "crossmodal") {
+    throw new Error(`Unknown self-test mode: ${mode}`);
+  }
+  process.stdout.write("Running crossmodal smoke tests...\n");
+  const { spawn: spawn35 } = await import("node:child_process");
+  const run2 = (file) => new Promise((resolve71, reject) => {
+    const p2 = spawn35(process.execPath, [file], { stdio: ["ignore", "pipe", "pipe"] });
+    p2.stdout.on("data", (d2) => process.stdout.write(d2));
+    p2.stderr.on("data", (d2) => process.stdout.write(d2));
+    onChildExit(p2, (code8) => code8 === 0 ? resolve71() : reject(new Error(`${file} exited ${code8}`)));
+  });
+  const base3 = process.cwd();
+  await run2(`${base3}/eval/test-crossmodal.mjs`);
+  await run2(`${base3}/eval/test-memory-search.mjs`);
+  process.stdout.write("Self-test complete.\n");
+}
 async function main() {
   const version4 = getVersion5();
   const parsed = parseCliArgs(process.argv);
@@ -725026,6 +726051,10 @@ async function main() {
     printHelp2(version4);
     return;
   }
+  if (parsed.selfTest) {
+    await runSelfTest(parsed.selfTest);
+    return;
+  }
   if (!parsed.json) {
     const updateInfo = await checkForUpdate(version4);
     if (updateInfo) {
@@ -725044,27 +726073,6 @@ async function main() {
   });
   try {
     switch (parsed.command) {
-      case void 0: {
-        if (process.argv.includes("--self-test")) {
-          const mode = process.argv[process.argv.indexOf("--self-test") + 1] || "crossmodal";
-          if (mode === "crossmodal") {
-            process.stdout.write("Running crossmodal smoke tests...\n");
-            const { spawn: spawn35 } = await import("node:child_process");
-            const run2 = (file) => new Promise((resolve71, reject) => {
-              const p2 = spawn35(process.execPath, [file], { stdio: ["ignore", "pipe", "pipe"] });
-              p2.stdout.on("data", (d2) => process.stdout.write(d2));
-              p2.stderr.on("data", (d2) => process.stdout.write(d2));
-              onChildExit(p2, (code8) => code8 === 0 ? resolve71() : reject(new Error(`${file} exited ${code8}`)));
-            });
-            const base3 = process.cwd();
-            await run2(`${base3}/eval/test-crossmodal.mjs`);
-            await run2(`${base3}/eval/test-memory-search.mjs`);
-            process.stdout.write("Self-test complete.\n");
-            return;
-          }
-        }
-        break;
-      }
       case "run": {
         const { runCommand: runCommand3 } = await Promise.resolve().then(() => (init_run(), run_exports));
         await runCommand3(