omnius 1.0.368 → 1.0.369

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");
@@ -321828,9 +321838,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 +321855,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 +435395,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 +499323,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 +503008,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 +511912,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;
@@ -546587,7 +546597,57 @@ 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 lines = [
+    ...normalize2(stderr).map((line) => `stderr: ${line}`),
+    ...normalize2(stdout).map((line) => `stdout: ${line}`)
+  ];
+  if (lines.length === 0)
+    return "Vision ML script failed";
+  return lines.slice(-24).join("\n").slice(-1800);
+}
+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";
@@ -546596,24 +546656,45 @@ var init_visual_memory = __esm({
     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 +546711,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 +546745,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 +546765,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 +546778,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 +546810,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 +546824,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 +546845,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 +546859,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 +546880,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 +546893,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,23 +546977,34 @@ ${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
 
+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)
@@ -546907,13 +547012,16 @@ with torch.no_grad():
 
 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_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 +547030,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 +547052,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 +547066,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 +547077,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
@@ -546973,7 +547092,7 @@ from transformers import CLIPProcessor, CLIPModel
 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")
@@ -546994,13 +547113,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 +547144,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),
@@ -547089,7 +547227,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 +547303,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));
         }
       }
     };
@@ -558355,6 +558493,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 +558577,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 +558585,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 +558606,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 +558746,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 +558826,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 +558907,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 +564557,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 {
         }
       }
@@ -567915,12 +568173,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 {
         }
       }
@@ -571961,12 +572219,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 +572235,8 @@ ${modelVisible}` : modelVisible || result.error || displayOutput || "";
               toolName: input.toolName,
               success: true,
               summary: `file change: ${filePath}`,
-              rawRef: `file://${filePath}`
+              rawRef: `file://${filePath}`,
+              targetPaths: [filePath]
             });
           }
         }
@@ -575393,7 +575654,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"]
         };
@@ -582419,7 +582681,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 +582728,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 +583572,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 +583587,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 +583724,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 +583760,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 +583775,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 = [
           {
@@ -585985,12 +586267,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 +595253,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 +595272,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;
@@ -635942,13 +636224,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 +636501,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 +636517,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 +636621,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 +636636,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 +645477,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 +646004,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 +646017,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 +647274,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 +647484,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 +647493,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 +647567,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 +647576,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 +650274,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 +650299,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 +661453,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 +664122,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 +664202,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 +666677,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 +669678,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 +669721,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 +670627,7 @@ ${mediaContext}` : ""
               autoFollowup: false
             }
           };
-          writeFileSync78(
+          writeFileSync77(
             this.telegramConversationPath(sessionKey),
             JSON.stringify(payload, null, 2) + "\n",
             "utf8"
@@ -671031,7 +671456,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 +671497,7 @@ ${mediaContext}` : ""
             sourceMessageId,
             chatKey,
             mediaKind,
-            safeAlias: basename35(result.path)
+            safeAlias: basename36(result.path)
           }
         };
       }
@@ -671113,7 +671538,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 +671566,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 +672732,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 +675230,7 @@ ${TELEGRAM_PUBLIC_ORCHESTRATOR_CONTRACT}`
               throw e2;
           }
         }
-        writeFileSync78(
+        writeFileSync77(
           lockFile,
           JSON.stringify(
             {
@@ -679758,7 +680183,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 +681086,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 +681274,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 +681302,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 +681589,7 @@ ${visionContext}]`;
             cacheEntry.extractedContent
           );
           let visualIdentityContext = "";
+          let visualObjectContext = "";
           let ingestReachedDaemon = false;
           try {
             const ingestResponse = await fetch(
@@ -681181,6 +681607,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 +681631,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 +681962,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 +682200,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 +682280,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 +684057,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 +684075,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 +684107,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 +684158,7 @@ function setCurrentProject(root) {
   currentRoot = canonical;
   try {
     mkdirSync90(OMNIUS_DIR3, { recursive: true });
-    writeFileSync79(CURRENT_FILE, `${canonical}
+    writeFileSync78(CURRENT_FILE, `${canonical}
 `, "utf8");
   } catch {
   }
@@ -684605,7 +685055,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 +685078,7 @@ function ensureDir(root) {
   const sentinel = rootSentinelPath(root);
   try {
     if (!existsSync148(sentinel)) {
-      writeFileSync80(sentinel, `${resolve64(root)}
+      writeFileSync79(sentinel, `${resolve64(root)}
 `, "utf8");
     }
   } catch {
@@ -684657,12 +685107,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 +685517,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 +685539,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 +685740,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 +685910,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 +686155,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 +686178,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 +687290,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 +687311,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 +687545,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 +687581,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 +702617,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 +702661,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 +702836,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 +703061,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 +703135,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 +703201,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 +703323,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 +704984,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 +706820,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 +709170,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 +709900,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 +711699,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 +711733,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 +711971,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 +712149,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 +712534,7 @@ function startApiServer(options2 = {}) {
             try {
               const dir = join172(homedir59(), ".omnius");
               mkdirSync101(dir, { recursive: true });
-              writeFileSync86(
+              writeFileSync85(
                 join172(dir, "access"),
                 `${runtimeAccessMode}
 `,
@@ -712497,7 +712947,7 @@ function startApiServer(options2 = {}) {
     }
     try {
       const {
-        writeFileSync: writeFileSync91,
+        writeFileSync: writeFileSync90,
         mkdirSync: mkdirSync106,
         existsSync: _exists,
         readFileSync: _rfs
@@ -712536,7 +712986,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 +713355,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 +713412,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 +713451,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 +713493,8 @@ ${association.contextBlock}`;
       mimeType,
       modality,
       contextBlock,
-      visualIdentity
+      visualIdentity,
+      visualObjectMemory
     });
   } catch (err) {
     jsonResponse(res, 400, {
@@ -713141,6 +713627,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 +713661,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 +713910,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 +713918,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 +713987,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 +715114,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 +715900,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)
@@ -718910,7 +719429,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 +720370,7 @@ Log: ${nexusLogPath}`
       sessionTitle = title.trim() || null;
       try {
         mkdirSync103(join174(repoRoot, ".omnius"), { recursive: true });
-        writeFileSync88(
+        writeFileSync87(
           join174(repoRoot, ".omnius", "session-title"),
           `${sessionTitle ?? ""}
 `,
@@ -719945,7 +720464,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 +723094,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"];
@@ -723303,7 +723822,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 +723855,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 +723886,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 +723995,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 {
@@ -723540,7 +724059,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 +724087,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 +724110,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 +724223,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
@@ -723844,7 +724363,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 +724379,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 +725018,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 +725150,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 +725387,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 +725413,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 +725436,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 +725542,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 +725572,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 +725594,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(