memorix 1.4.3 → 1.4.4

package/dist/cli/index.js

@@ -3221,7 +3221,7 @@ ${import_picocolors.default.gray(m3)}  ${s4}
 
 // src/cli/version.ts
 function getCliVersion() {
-  return true ? "1.4.3" : pkg.version;
+  return true ? "1.4.4" : pkg.version;
 }
 var init_version = __esm({
   "src/cli/version.ts"() {
@@ -10246,8 +10246,8 @@ async function acquireLock(lockPath) {
       const code = err instanceof Error && "code" in err ? err.code : void 0;
       if (code === "EEXIST" || code === "EPERM") {
         try {
-          const stat4 = await fs2.stat(lockPath);
-          if (Date.now() - stat4.mtimeMs > LOCK_STALE_MS) {
+          const stat5 = await fs2.stat(lockPath);
+          if (Date.now() - stat5.mtimeMs > LOCK_STALE_MS) {
             await fs2.unlink(lockPath).catch(() => {
             });
             continue;
@@ -27247,11 +27247,11 @@ async function importKnownMedia(input) {
 async function importMediaFile(input) {
   const maxBytes = input.maxBytes ?? DEFAULT_MAX_MEDIA_BYTES;
   const source = path12.resolve(input.filePath);
-  const stat4 = await lstat(source);
-  if (stat4.isSymbolicLink()) throw new Error("Media import does not follow symbolic links");
-  if (!stat4.isFile()) throw new Error("Media import accepts regular files only");
-  if (stat4.size <= 0) throw new Error("Media import rejects empty files");
-  if (stat4.size > maxBytes) throw new Error(`Media file is too large (${stat4.size} bytes; limit ${maxBytes})`);
+  const stat5 = await lstat(source);
+  if (stat5.isSymbolicLink()) throw new Error("Media import does not follow symbolic links");
+  if (!stat5.isFile()) throw new Error("Media import accepts regular files only");
+  if (stat5.size <= 0) throw new Error("Media import rejects empty files");
+  if (stat5.size > maxBytes) throw new Error(`Media file is too large (${stat5.size} bytes; limit ${maxBytes})`);
   const header = await readHeader(source);
   const detected = detectMedia(header);
   const sha2562 = await sha256File(source);
@@ -27259,7 +27259,7 @@ async function importMediaFile(input) {
     dataDir: input.dataDir,
     projectId: input.projectId,
     sha256: sha2562,
-    bytes: stat4.size,
+    bytes: stat5.size,
     detected,
     persist: (destination) => persistFile(source, destination),
     sourceKind: input.sourceKind ?? "import",
@@ -35222,7 +35222,7 @@ var init_image_models_generated = __esm({
           api: "minimax-images",
           provider: "minimax",
           baseUrl: "https://api.minimax.io/v1/image_generation",
-          input: ["text"],
+          input: ["text", "image"],
           output: ["image"],
           cost: {
             "input": 0,
@@ -35237,7 +35237,7 @@ var init_image_models_generated = __esm({
           api: "minimax-images",
           provider: "minimax",
           baseUrl: "https://api.minimax.io/v1/image_generation",
-          input: ["text"],
+          input: ["text", "image"],
           output: ["image"],
           cost: {
             "input": 0,
@@ -35254,7 +35254,7 @@ var init_image_models_generated = __esm({
           api: "minimax-images",
           provider: "minimax-cn",
           baseUrl: "https://api.minimaxi.com/v1/image_generation",
-          input: ["text"],
+          input: ["text", "image"],
           output: ["image"],
           cost: {
             "input": 0,
@@ -35269,7 +35269,7 @@ var init_image_models_generated = __esm({
           api: "minimax-images",
           provider: "minimax-cn",
           baseUrl: "https://api.minimaxi.com/v1/image_generation",
-          input: ["text"],
+          input: ["text", "image"],
           output: ["image"],
           cost: {
             "input": 0,
@@ -35368,9 +35368,10 @@ __export(minimax_exports, {
 });
 import { isIP as isIP2 } from "net";
 function buildPayload(model, context, options) {
-  if (context.input.some((item) => item.type === "image")) {
-    throw new Error(`Model ${model.id} does not support image input`);
-  }
+  const subjectReference = context.input.filter((item) => item.type === "image").map((item) => ({
+    type: "character",
+    image_file: `data:${item.mimeType};base64,${item.data}`
+  }));
   const prompt2 = context.input.filter((item) => item.type === "text").map((item) => sanitizeSurrogates(item.text).trim()).filter(Boolean).join("\n");
   if (!prompt2) {
     throw new Error("MiniMax image generation requires a text prompt");
@@ -35381,6 +35382,7 @@ function buildPayload(model, context, options) {
   return {
     model: model.id,
     prompt: prompt2,
+    ...subjectReference.length > 0 ? { subject_reference: subjectReference } : {},
     ...options?.aspectRatio !== void 0 ? { aspect_ratio: options.aspectRatio } : {},
     ...options?.width !== void 0 ? { width: options.width } : {},
     ...options?.height !== void 0 ? { height: options.height } : {},
@@ -78440,21 +78442,21 @@ var init_from = __esm({
     init_fetch_blob();
     ({ stat: stat2 } = fs9);
     blobFromSync = (path47, type) => fromBlob(statSync3(path47), path47, type);
-    blobFrom = (path47, type) => stat2(path47).then((stat4) => fromBlob(stat4, path47, type));
-    fileFrom = (path47, type) => stat2(path47).then((stat4) => fromFile(stat4, path47, type));
+    blobFrom = (path47, type) => stat2(path47).then((stat5) => fromBlob(stat5, path47, type));
+    fileFrom = (path47, type) => stat2(path47).then((stat5) => fromFile(stat5, path47, type));
     fileFromSync = (path47, type) => fromFile(statSync3(path47), path47, type);
-    fromBlob = (stat4, path47, type = "") => new fetch_blob_default([new BlobDataItem({
+    fromBlob = (stat5, path47, type = "") => new fetch_blob_default([new BlobDataItem({
       path: path47,
-      size: stat4.size,
-      lastModified: stat4.mtimeMs,
+      size: stat5.size,
+      lastModified: stat5.mtimeMs,
       start: 0
     })], { type });
-    fromFile = (stat4, path47, type = "") => new file_default([new BlobDataItem({
+    fromFile = (stat5, path47, type = "") => new file_default([new BlobDataItem({
       path: path47,
-      size: stat4.size,
-      lastModified: stat4.mtimeMs,
+      size: stat5.size,
+      lastModified: stat5.mtimeMs,
       start: 0
-    })], basename(path47), { type, lastModified: stat4.mtimeMs });
+    })], basename(path47), { type, lastModified: stat5.mtimeMs });
     BlobDataItem = class _BlobDataItem {
       #path;
       #start;
@@ -85748,7 +85750,7 @@ var require_getCredentials = __commonJS({
     var fs31 = __require("fs");
     var util_1 = __require("util");
     var errorWithCode_1 = require_errorWithCode();
-    var readFile9 = fs31.readFile ? (0, util_1.promisify)(fs31.readFile) : async () => {
+    var readFile10 = fs31.readFile ? (0, util_1.promisify)(fs31.readFile) : async () => {
       throw new errorWithCode_1.ErrorWithCode("use key rather than keyFile.", "MISSING_CREDENTIALS");
     };
     var ExtensionFiles;
@@ -85770,7 +85772,7 @@ var require_getCredentials = __commonJS({
        * @returns A promise that resolves with the credentials.
        */
       async getCredentials() {
-        const key = await readFile9(this.keyFilePath, "utf8");
+        const key = await readFile10(this.keyFilePath, "utf8");
         let body;
         try {
           body = JSON.parse(key);
@@ -85796,7 +85798,7 @@ var require_getCredentials = __commonJS({
        * @returns A promise that resolves with the private key.
        */
       async getCredentials() {
-        const privateKey = await readFile9(this.keyFilePath, "utf8");
+        const privateKey = await readFile10(this.keyFilePath, "utf8");
         return { privateKey };
       }
     };
@@ -87437,7 +87439,7 @@ var require_filesubjecttokensupplier = __commonJS({
     exports.FileSubjectTokenSupplier = void 0;
     var util_1 = __require("util");
     var fs31 = __require("fs");
-    var readFile9 = (0, util_1.promisify)(fs31.readFile ?? (() => {
+    var readFile10 = (0, util_1.promisify)(fs31.readFile ?? (() => {
     }));
     var realpath = (0, util_1.promisify)(fs31.realpath ?? (() => {
     }));
@@ -87477,7 +87479,7 @@ var require_filesubjecttokensupplier = __commonJS({
           throw err;
         }
         let subjectToken;
-        const rawText = await readFile9(parsedFilePath, { encoding: "utf8" });
+        const rawText = await readFile10(parsedFilePath, { encoding: "utf8" });
         if (this.formatType === "text") {
           subjectToken = rawText;
         } else if (this.formatType === "json" && this.subjectTokenFieldName) {
@@ -176394,6 +176396,7 @@ async function generateMiniMaxImages(input, dependencies = {}) {
       ...input.height !== void 0 ? { height: input.height } : {},
       ...input.seed !== void 0 ? { seed: input.seed } : {},
       ...input.promptOptimizer !== void 0 ? { promptOptimizer: input.promptOptimizer } : {},
+      ...input.subjectImages !== void 0 && input.subjectImages.length > 0 ? { subjectImages: input.subjectImages } : {},
       timeoutMs
     });
   } catch (error40) {
@@ -176433,9 +176436,13 @@ var init_minimax2 = __esm({
       const model = getImageModel(input.provider, input.model);
       if (!model) throw new Error(`MiniMax image model is not registered: ${input.model}`);
       const configuredModel = input.baseUrl ? { ...model, baseUrl: input.baseUrl } : model;
+      const content = [
+        ...(input.subjectImages ?? []).map((image) => ({ type: "image", data: image.data, mimeType: image.mimeType })),
+        { type: "text", text: input.prompt }
+      ];
       const response = await generateImages(
         configuredModel,
-        { input: [{ type: "text", text: input.prompt }] },
+        { input: content },
         {
           apiKey: input.apiKey,
           timeoutMs: input.timeoutMs,
@@ -178523,7 +178530,7 @@ function indexFileLite(projectId, projectRoot, abs, indexedAt, fileStat) {
   const rel = normalizeCodePath(relative(projectRoot, abs));
   try {
     const text2 = readFileSync7(abs, "utf-8");
-    const stat4 = fileStat ?? statSync4(abs);
+    const stat5 = fileStat ?? statSync4(abs);
     const file2 = {
       id: makeCodeFileId(projectId, rel),
       projectId,
@@ -178532,8 +178539,8 @@ function indexFileLite(projectId, projectRoot, abs, indexedAt, fileStat) {
       contentHash: hashText(text2),
       // Preserve filesystem precision. Rounding here made same-size edits in
       // a short Windows timestamp window indistinguishable to refresh.
-      mtimeMs: Number(stat4.mtimeMs),
-      sizeBytes: Number(stat4.size),
+      mtimeMs: Number(stat5.mtimeMs),
+      sizeBytes: Number(stat5.size),
       indexedAt
     };
     return {
@@ -178560,18 +178567,18 @@ async function indexProjectLite(options) {
   let skippedOversizedFiles = 0;
   let unreadableFiles = 0;
   for (const abs of paths) {
-    let stat4;
+    let stat5;
     try {
-      stat4 = statSync4(abs);
+      stat5 = statSync4(abs);
     } catch {
       unreadableFiles++;
       continue;
     }
-    if (Number(stat4.size) > maxFileBytes) {
+    if (Number(stat5.size) > maxFileBytes) {
       skippedOversizedFiles++;
       continue;
     }
-    const attempt = indexFileLite(options.projectId, options.projectRoot, abs, indexedAt, stat4);
+    const attempt = indexFileLite(options.projectId, options.projectRoot, abs, indexedAt, stat5);
     if (!attempt.delta) {
       if (attempt.unreadable) unreadableFiles++;
       continue;
@@ -178599,16 +178606,16 @@ async function refreshProjectLite(store2, options) {
   for (const abs of paths) {
     const rel = normalizeCodePath(relative(options.projectRoot, abs));
     seenPaths.add(rel);
-    let stat4;
+    let stat5;
     try {
-      stat4 = statSync4(abs);
+      stat5 = statSync4(abs);
     } catch {
       unreadableFiles++;
       continue;
     }
     const existing = existingByPath.get(rel);
-    const mtimeMs = Number(stat4.mtimeMs);
-    const sizeBytes = Number(stat4.size);
+    const mtimeMs = Number(stat5.mtimeMs);
+    const sizeBytes = Number(stat5.size);
     if (sizeBytes > maxFileBytes) {
       skippedOversizedFiles++;
       if (existing) oversizedExistingFileIds.add(existing.id);
@@ -178618,7 +178625,7 @@ async function refreshProjectLite(store2, options) {
       unchangedFiles++;
       continue;
     }
-    const attempt = indexFileLite(options.projectId, options.projectRoot, abs, indexedAt, stat4);
+    const attempt = indexFileLite(options.projectId, options.projectRoot, abs, indexedAt, stat5);
     if (!attempt.delta) {
       if (attempt.unreadable) unreadableFiles++;
       continue;
@@ -187607,9 +187614,30 @@ function emitError(message, asJson) {
   console.error(asJson ? JSON.stringify({ error: message }, null, 2) : `Error: ${message}`);
   process.exitCode = 1;
 }
+function asStringArg(value) {
+  if (value == null) return void 0;
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : void 0;
+  }
+  if (Array.isArray(value)) {
+    const joined = value.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean).join(" ");
+    return joined.length > 0 ? joined : void 0;
+  }
+  return void 0;
+}
+function lastStringArg(value) {
+  if (typeof value === "string") return value;
+  if (Array.isArray(value)) {
+    const strings = value.filter((item) => typeof item === "string");
+    return strings[strings.length - 1];
+  }
+  return void 0;
+}
 function parseCsvList(input) {
   if (!input) return [];
-  return input.split(",").map((item) => item.trim()).filter(Boolean);
+  const source = Array.isArray(input) ? input.filter((item) => typeof item === "string").join(",") : input;
+  return source.split(",").map((item) => item.trim()).filter(Boolean);
 }
 function parseOptionalJsonObject(input, field = "value") {
   if (!input) return void 0;
@@ -187629,43 +187657,44 @@ function shortId(id) {
   return id ? `${id.slice(0, 8)}\u2026` : "-";
 }
 function parsePositiveInt(input, fallback) {
-  if (input == null || input.trim() === "") return fallback;
-  if (!/^\d+$/.test(input.trim())) {
-    throw new Error(`Expected a positive integer, received "${input}".`);
+  const value = lastStringArg(input);
+  if (value == null || value.trim() === "") return fallback;
+  if (!/^\d+$/.test(value.trim())) {
+    throw new Error(`Expected a positive integer, received "${value}".`);
   }
-  const parsed = Number(input);
+  const parsed = Number(value);
   if (!Number.isSafeInteger(parsed) || parsed <= 0) {
-    throw new Error(`Expected a positive integer, received "${input}".`);
+    throw new Error(`Expected a positive integer, received "${value}".`);
   }
   return parsed;
 }
 function coerceObservationType(input) {
-  const normalized = input ?? "discovery";
+  const normalized = lastStringArg(input) ?? "discovery";
   if (!OBSERVATION_TYPES.includes(normalized)) {
     throw new Error(
-      `Unknown observation type "${input}". Valid types: ${OBSERVATION_TYPES.join(", ")}`
+      `Unknown observation type "${String(input ?? "")}". Valid types: ${OBSERVATION_TYPES.join(", ")}`
     );
   }
   return normalized;
 }
 function coerceObservationStatus(input) {
-  const normalized = input ?? "resolved";
+  const normalized = lastStringArg(input) ?? "resolved";
   if (!OBSERVATION_STATUSES.includes(normalized)) {
     throw new Error(
-      `Unknown observation status "${input}". Valid statuses: ${OBSERVATION_STATUSES.join(", ")}`
+      `Unknown observation status "${String(input ?? "")}". Valid statuses: ${OBSERVATION_STATUSES.join(", ")}`
     );
   }
   return normalized;
 }
 function coerceRetrievalQuality(input) {
-  const normalized = (input ?? "balanced").trim().toLowerCase();
+  const normalized = (lastStringArg(input) ?? "balanced").trim().toLowerCase();
   if (!RETRIEVAL_QUALITIES.includes(normalized)) {
     throw new Error("quality must be fast, balanced, or thorough");
   }
   return normalized;
 }
 function coerceObservationVisibility(input) {
-  const normalized = (input ?? "project").trim().toLowerCase();
+  const normalized = (lastStringArg(input) ?? "project").trim().toLowerCase();
   if (normalized === "personal" || normalized === "project" || normalized === "team") {
     return normalized;
   }
@@ -188551,23 +188580,23 @@ __export(memory_exports2, {
   default: () => memory_default
 });
 function getStringArg(named, positional) {
-  const value = named?.trim() || positional.join(" ").trim();
+  const value = asStringArg(named) || positional.join(" ").trim();
   return value || void 0;
 }
 function getIdArg(args, positional) {
-  return args.ids || args.id || positional.join(",");
+  return lastStringArg(args.ids) || lastStringArg(args.id) || positional.join(",");
 }
 function parseObservationId(value) {
-  const normalized = value.trim();
+  const normalized = (asStringArg(value) ?? "").trim();
   if (!/^[1-9]\d*$/.test(normalized)) {
-    throw new Error(`Invalid observation ID: ${value}`);
+    throw new Error(`Invalid observation ID: ${String(value ?? "")}`);
   }
   const id = Number(normalized);
-  if (!Number.isSafeInteger(id)) throw new Error(`Invalid observation ID: ${value}`);
+  if (!Number.isSafeInteger(id)) throw new Error(`Invalid observation ID: ${String(value ?? "")}`);
   return id;
 }
 function parseObservationIds(value) {
-  const values = parseCsvList(value);
+  const values = parseCsvList(typeof value === "string" || Array.isArray(value) ? value : void 0);
   if (values.length === 0) return [];
   return values.map(parseObservationId);
 }
@@ -188595,22 +188624,22 @@ function printMemoryUsage() {
   console.log('  memorix memory long-term supersede --id <old-id> --superseded-by <qualified-id> --reason "replaced"');
 }
 function longTermKind(value) {
-  const normalized = (value ?? "semantic").trim().toLowerCase();
+  const normalized = (asStringArg(value) ?? "semantic").toLowerCase();
   if (normalized === "episodic" || normalized === "semantic" || normalized === "procedural") return normalized;
   throw new Error("long-term kind must be episodic, semantic, or procedural.");
 }
 function longTermScope(value) {
-  const normalized = (value ?? "project").trim().toLowerCase();
+  const normalized = (asStringArg(value) ?? "project").toLowerCase();
   if (normalized === "project" || normalized === "user" || normalized === "team") return normalized;
   throw new Error("long-term scope must be project, user, or team.");
 }
 function longTermPortability(value) {
-  const normalized = (value ?? "project-bound").trim().toLowerCase();
+  const normalized = (asStringArg(value) ?? "project-bound").toLowerCase();
   if (normalized === "project-bound" || normalized === "portable") return normalized;
   throw new Error("long-term portability must be project-bound or portable.");
 }
 function requiredLongTermReason(value) {
-  const reason = value?.trim();
+  const reason = asStringArg(value);
   if (!reason) throw new Error("reason is required for this long-term memory transition.");
   return reason;
 }
@@ -188674,7 +188703,7 @@ var init_memory3 = __esm({
       run: async ({ args }) => {
         const action = args._?.[0] || "";
         const positional = (args._ ?? []).slice(1);
-        const longTermAction = action === "long-term" ? (positional[0] || args.action || "list").trim().toLowerCase() : void 0;
+        const longTermAction = action === "long-term" ? (positional[0] || asStringArg(args.action) || "list").trim().toLowerCase() : void 0;
         const asJson = !!args.json;
         try {
           const readOnlyActions = /* @__PURE__ */ new Set(["", "search", "graph-context", "recent", "suggest-topic-key", "detail", "timeline"]);
@@ -188707,7 +188736,7 @@ var init_memory3 = __esm({
                 query,
                 limit: parsePositiveInt(args.graphLimit, 5)
               });
-              const format = args.format?.trim().toLowerCase();
+              const format = asStringArg(args.format)?.toLowerCase();
               const formatted = format === "prompt" ? formatGraphContextPrompt(packet) : [
                 `Graph context packet for ${project.name}`,
                 `- ${packet.summary}`,
@@ -188737,15 +188766,15 @@ var init_memory3 = __esm({
                 emitError('text is required for "memorix memory store"', asJson);
                 return;
               }
-              const title = args.title?.trim() || narrative.slice(0, 80);
+              const title = asStringArg(args.title) || narrative.slice(0, 80);
               const type = coerceObservationType(args.type);
-              const topicKey = args.topicKey?.trim() || suggestTopicKey(type, title) || void 0;
+              const topicKey = asStringArg(args.topicKey) || suggestTopicKey(type, title) || void 0;
               const writeScope = resolveCliWriteScope(
                 { reader, identity },
                 args.visibility
               );
               const result = await storeObservation({
-                entityName: args.entity?.trim() || "general",
+                entityName: asStringArg(args.entity) || "general",
                 type,
                 title,
                 narrative,
@@ -188766,7 +188795,7 @@ var init_memory3 = __esm({
             }
             case "suggest-topic-key": {
               const type = coerceObservationType(args.type);
-              const title = args.title?.trim();
+              const title = asStringArg(args.title);
               if (!title) {
                 emitError('title is required for "memorix memory suggest-topic-key"', asJson);
                 return;
@@ -188855,7 +188884,7 @@ var init_memory3 = __esm({
               return;
             }
             case "deduplicate": {
-              const query = args.query?.trim();
+              const query = asStringArg(args.query);
               const dryRun = !!args.dryRun || !!args["dry-run"];
               const { isLLMEnabled: isLLMEnabled2 } = await Promise.resolve().then(() => (init_provider2(), provider_exports2));
               if (!isLLMEnabled2()) {
@@ -189036,7 +189065,7 @@ var init_memory3 = __esm({
                 ...reader.isTeamMember ? { isTeamMember: true } : {}
               };
               const memoryId = () => {
-                const id = args.id?.trim() || args.fromObservation?.trim() || longTermPositional[0]?.trim();
+                const id = asStringArg(args.id) || asStringArg(args.fromObservation) || longTermPositional[0]?.trim();
                 if (!id) throw new Error("long-term memory id is required.");
                 return id;
               };
@@ -189085,11 +189114,11 @@ var init_memory3 = __esm({
                     projectId: project.id,
                     scope: scope(),
                     kind: kind(),
-                    title: args.title?.trim() || content.slice(0, 100),
+                    title: asStringArg(args.title) || content.slice(0, 100),
                     content,
                     facts: parseCsvList(args.facts),
                     tags: parseCsvList(args.tags),
-                    applicability: args.applicability?.trim(),
+                    applicability: asStringArg(args.applicability),
                     portability: portability(),
                     reader: longTermReader
                   });
@@ -189101,7 +189130,7 @@ var init_memory3 = __esm({
                   return;
                 }
                 case "promote": {
-                  const rawId = args.fromObservation?.trim() || args.id?.trim() || longTermPositional[0]?.trim();
+                  const rawId = asStringArg(args.fromObservation) || asStringArg(args.id) || longTermPositional[0]?.trim();
                   const observationId2 = Number.parseInt(rawId || "", 10);
                   if (!Number.isFinite(observationId2)) {
                     emitError('fromObservation or id must be an observation ID for "memorix memory long-term promote"', asJson);
@@ -189118,7 +189147,7 @@ var init_memory3 = __esm({
                     scope: scope(),
                     kind: kind(),
                     tags: parseCsvList(args.tags),
-                    applicability: args.applicability?.trim(),
+                    applicability: asStringArg(args.applicability),
                     reader: longTermReader
                   });
                   emitResult(
@@ -189147,7 +189176,7 @@ var init_memory3 = __esm({
                   return;
                 }
                 case "supersede": {
-                  const supersededBy = args.supersededBy?.trim() || args["superseded-by"]?.trim();
+                  const supersededBy = asStringArg(args.supersededBy) || asStringArg(args["superseded-by"]);
                   if (!supersededBy) {
                     emitError('supersededBy is required for "memorix memory long-term supersede"', asJson);
                     return;
@@ -196908,9 +196937,9 @@ function existingLensCandidates(rootPath, lens) {
     const absolute = path33.join(rootPath, candidate2);
     try {
       if (!existsSync17(absolute)) continue;
-      const stat4 = statSync5(absolute);
-      if (stat4.isFile()) out.push(candidate2);
-      if (stat4.isDirectory()) out.push(candidate2.replace(/\\/g, "/"));
+      const stat5 = statSync5(absolute);
+      if (stat5.isFile()) out.push(candidate2);
+      if (stat5.isDirectory()) out.push(candidate2.replace(/\\/g, "/"));
     } catch {
     }
   }
@@ -215641,8 +215670,8 @@ var init_syncer = __esm({
         const dir = path37.dirname(pattern);
         const fileGlob = path37.basename(pattern);
         try {
-          const stat4 = await fs22.stat(dir);
-          if (!stat4.isDirectory()) {
+          const stat5 = await fs22.stat(dir);
+          if (!stat5.isDirectory()) {
             try {
               await fs22.access(pattern);
               return [pattern];
@@ -257832,11 +257861,11 @@ import path40 from "path";
 function resolveGitDir(projectRoot) {
   const dotGit = path40.join(projectRoot, ".git");
   if (!existsSync24(dotGit)) return null;
-  const stat4 = statSync6(dotGit);
-  if (stat4.isDirectory()) {
+  const stat5 = statSync6(dotGit);
+  if (stat5.isDirectory()) {
     return dotGit;
   }
-  if (stat4.isFile()) {
+  if (stat5.isFile()) {
     try {
       const content = readFileSync15(dotGit, "utf-8").trim();
       const match2 = content.match(/^gitdir:\s*(.+)$/);
@@ -258239,7 +258268,7 @@ The path should point to a directory containing a .git folder.`
   };
   const server = existingServer ?? new McpServer({
     name: "memorix",
-    version: true ? "1.4.3" : "1.0.1"
+    version: true ? "1.4.4" : "1.0.1"
   });
   const originalRegisterTool = server.registerTool.bind(server);
   server.registerTool = ((name, ...args) => {
@@ -260243,8 +260272,8 @@ ${Math.max(0, managedIds.size - result.resolved.length)} visible writable observ
   try {
     const { homedir: homedir35 } = await import("os");
     const { join: join33 } = await import("path");
-    const { readFile: readFile9 } = await import("fs/promises");
-    const raw = await readFile9(join33(homedir35(), ".memorix", "settings.json"), "utf-8");
+    const { readFile: readFile10 } = await import("fs/promises");
+    const raw = await readFile10(join33(homedir35(), ".memorix", "settings.json"), "utf-8");
     const s4 = JSON.parse(raw);
     if (s4.knowledgeGraph === true) enableKG = true;
   } catch {
@@ -261922,6 +261951,16 @@ ${lines.join("\n")}` }] };
       return { content: [{ type: "text", text: lines.filter(Boolean).join("\n") }] };
     }
   );
+  function matchesImagePrefix2(bytes, prefix) {
+    return prefix.every((byte, index) => bytes[index] === byte);
+  }
+  function detectReferenceImageMimeType2(bytes) {
+    if (bytes.length >= 8 && matchesImagePrefix2(bytes, [137, 80, 78, 71, 13, 10, 26, 10])) return "image/png";
+    if (bytes.length >= 3 && matchesImagePrefix2(bytes, [255, 216, 255])) return "image/jpeg";
+    if (bytes.length >= 6 && (Buffer.from(bytes.subarray(0, 6)).toString("ascii") === "GIF87a" || Buffer.from(bytes.subarray(0, 6)).toString("ascii") === "GIF89a")) return "image/gif";
+    if (bytes.length >= 12 && Buffer.from(bytes.subarray(0, 4)).toString("ascii") === "RIFF" && Buffer.from(bytes.subarray(8, 12)).toString("ascii") === "WEBP") return "image/webp";
+    return void 0;
+  }
   server.registerTool(
     "memorix_media",
     {
@@ -261937,6 +261976,7 @@ ${lines.join("\n")}` }] };
         title: external_exports2.string().optional().describe("Observation title when attaching generated/imported output."),
         narrative: external_exports2.string().optional().describe("Short retrieval text when attaching an asset."),
         prompt: external_exports2.string().optional().describe("Explicit MiniMax generation prompt."),
+        image: external_exports2.string().optional().describe("Base64-encoded reference image for image-to-image generation."),
         model: external_exports2.string().max(160).optional().describe("Provider model for the selected media action."),
         provider: external_exports2.enum(["openai", "groq"]).optional().describe("Explicit audio transcription provider."),
         language: external_exports2.string().max(32).optional().describe("Optional ISO-639-1 hint for audio transcription."),
@@ -261951,7 +261991,7 @@ ${lines.join("\n")}` }] };
         attach: external_exports2.boolean().optional().describe("Attach generated/imported output to normal project memory explicitly.")
       }
     },
-    async ({ action, path: assetPath, assetId, jobId, kind, limit: limit2, title, narrative, prompt: prompt2, model, provider: provider2, language, region, n: n3, ratio, width, height, duration: duration3, maxPages, maxChars, attach }) => {
+    async ({ action, path: assetPath, assetId, jobId, kind, limit: limit2, title, narrative, prompt: prompt2, image, model, provider: provider2, language, region, n: n3, ratio, width, height, duration: duration3, maxPages, maxChars, attach }) => {
       const unresolved = requireResolvedProject("manage controlled media");
       if (unresolved) return unresolved;
       const safeError4 = (error40) => sanitizeCredentials(
@@ -262080,6 +262120,14 @@ ${lines.join("\n")}` }] };
           if (model && !imageModel) throw new Error("generate-image accepts image-01 or image-01-live");
           const imageRatio = ratio === "1:1" || ratio === "16:9" || ratio === "4:3" || ratio === "3:2" || ratio === "2:3" || ratio === "3:4" || ratio === "9:16" || ratio === "21:9" ? ratio : void 0;
           if (ratio && !imageRatio) throw new Error("generate-image received an unsupported aspect ratio");
+          let subjectImages;
+          if (image?.trim()) {
+            const { decodeBase64ImagePayload: decodeBase64ImagePayload2 } = await Promise.resolve().then(() => (init_image_payload(), image_payload_exports));
+            const bytes = decodeBase64ImagePayload2(image);
+            const mimeType = detectReferenceImageMimeType2(bytes);
+            if (!mimeType) throw new Error("Reference image must be a PNG, JPEG, GIF, or WebP image");
+            subjectImages = [{ data: bytes.toString("base64"), mimeType }];
+          }
           const { generateMiniMaxImages: generateMiniMaxImages2 } = await Promise.resolve().then(() => (init_minimax2(), minimax_exports2));
           const generated = await generateMiniMaxImages2({
             dataDir: projectDir2,
@@ -262090,7 +262138,8 @@ ${lines.join("\n")}` }] };
             n: n3,
             aspectRatio: imageRatio,
             width,
-            height
+            height,
+            subjectImages
           });
           const observations2 = attach === true ? await Promise.all(generated.assets.map(({ asset }) => attachAsset(
             asset,
@@ -269025,11 +269074,11 @@ function getCommitInfo(cwd, ref = "HEAD") {
   const date5 = lines[3];
   const subject = lines[4];
   const body = lines.slice(5).join("\n").trim();
-  const stat4 = runGit3(cwd, ["diff-tree", "--no-commit-id", "--numstat", hash4]).trim();
+  const stat5 = runGit3(cwd, ["diff-tree", "--no-commit-id", "--numstat", hash4]).trim();
   let insertions = 0;
   let deletions = 0;
   const filesChanged = [];
-  for (const line of stat4.split("\n").filter(Boolean)) {
+  for (const line of stat5.split("\n").filter(Boolean)) {
     const parts = line.split("	");
     if (parts.length >= 3) {
       const ins = parseInt(parts[0], 10) || 0;
@@ -269869,6 +269918,37 @@ var init_embedding = __esm({
   }
 });
 
+// src/cli/commands/media-image.ts
+import { readFile as readFile8, stat as stat4 } from "fs/promises";
+function matchesImagePrefix(bytes, prefix) {
+  return prefix.every((byte, index) => bytes[index] === byte);
+}
+function detectReferenceImageMimeType(bytes) {
+  if (bytes.length >= 8 && matchesImagePrefix(bytes, [137, 80, 78, 71, 13, 10, 26, 10])) return "image/png";
+  if (bytes.length >= 3 && matchesImagePrefix(bytes, [255, 216, 255])) return "image/jpeg";
+  if (bytes.length >= 6 && (bytes.subarray(0, 6).toString("ascii") === "GIF87a" || bytes.subarray(0, 6).toString("ascii") === "GIF89a")) return "image/gif";
+  if (bytes.length >= 12 && bytes.subarray(0, 4).toString("ascii") === "RIFF" && bytes.subarray(8, 12).toString("ascii") === "WEBP") return "image/webp";
+  return void 0;
+}
+async function readSubjectImage(filePath) {
+  const fileStats = await stat4(filePath);
+  if (fileStats.size > MAX_VISION_IMAGE_BYTES) {
+    throw new Error(`Reference image exceeds the ${MAX_VISION_IMAGE_BYTES}-byte visual analysis limit`);
+  }
+  const bytes = await readFile8(filePath);
+  if (bytes.length === 0) throw new Error(`Reference image is empty: ${filePath}`);
+  const mimeType = detectReferenceImageMimeType(bytes);
+  if (!mimeType) throw new Error("Reference image must be a PNG, JPEG, GIF, or WebP file");
+  return { data: bytes.toString("base64"), mimeType };
+}
+var init_media_image = __esm({
+  "src/cli/commands/media-image.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_image_payload();
+  }
+});
+
 // src/cli/commands/media.ts
 var media_exports = {};
 __export(media_exports, {
@@ -269954,7 +270034,7 @@ function help() {
     '  memorix media attach --asset <asset-id> [--title "Architecture"] [--text "..."]',
     "  memorix media embed --asset <asset-id>",
     "  memorix media similar --asset <asset-id> [--limit 10]",
-    '  memorix media generate image --prompt "..." [--model image-01] [--attach]',
+    '  memorix media generate image --prompt "..." [--model image-01] [--image ./reference.png] [--attach]',
     '  memorix media generate video --prompt "..." [--model MiniMax-H3] [--duration 5] [--ratio 16:9] [--attach]',
     "  memorix media status --job <media-job-id>",
     "  memorix media cancel --job <media-job-id>",
@@ -269979,6 +270059,7 @@ var init_media = __esm({
     init_minimax2();
     init_video_jobs();
     init_audio_jobs();
+    init_media_image();
     init_operator_shared();
     media_default = defineCommand({
       meta: {
@@ -269996,6 +270077,7 @@ var init_media = __esm({
         concepts: { type: "string", description: "Comma-separated concepts when attaching" },
         visibility: { type: "string", description: "Observation visibility when attaching" },
         prompt: { type: "string", description: "Generation prompt" },
+        image: { type: "string", description: "Path to a reference image for image-to-image generation" },
         model: { type: "string", description: "Provider model" },
         provider: { type: "string", description: "Audio transcription provider: openai or groq" },
         language: { type: "string", description: "Optional ISO-639-1 hint for audio transcription" },
@@ -270067,6 +270149,8 @@ var init_media = __esm({
                 );
                 return;
               }
+              const referenceImagePath = getValue(args.image);
+              const subjectImages = referenceImagePath ? [await readSubjectImage(referenceImagePath)] : void 0;
               const generated = await generateMiniMaxImages({
                 dataDir,
                 projectId: project.id,
@@ -270079,6 +270163,7 @@ var init_media = __esm({
                 height: parseOptionalInteger(args.height, "height", 1, 8192),
                 seed: parseOptionalInteger(args.seed, "seed", 0, 2147483647),
                 promptOptimizer: args.promptOptimizer === true || args["prompt-optimizer"] === true,
+                subjectImages,
                 maxBytes: parseByteLimit(args.maxBytes ?? args["max-bytes"], 100 * 1024 * 1024)
               });
               const observations2 = args.attach === true ? await Promise.all(generated.assets.map(({ asset }) => attachMediaAssetToObservation({
@@ -271045,14 +271130,14 @@ function doLogs(follow, lines) {
     let position = fs26.statSync(logFile).size;
     const watcher = fs26.watch(logFile, () => {
       try {
-        const stat4 = fs26.statSync(logFile);
-        if (stat4.size > position) {
+        const stat5 = fs26.statSync(logFile);
+        if (stat5.size > position) {
           const fd = fs26.openSync(logFile, "r");
-          const buf = Buffer.alloc(stat4.size - position);
+          const buf = Buffer.alloc(stat5.size - position);
           fs26.readSync(fd, buf, 0, buf.length, position);
           fs26.closeSync(fd);
           process.stdout.write(buf.toString("utf-8"));
-          position = stat4.size;
+          position = stat5.size;
         }
       } catch {
       }
@@ -271169,7 +271254,7 @@ __export(agent_integrations_exports, {
 });
 import { spawnSync as spawnSync2 } from "child_process";
 import { existsSync as existsSync28 } from "fs";
-import { mkdir as mkdir8, readFile as readFile8, writeFile as writeFile9 } from "fs/promises";
+import { mkdir as mkdir8, readFile as readFile9, writeFile as writeFile9 } from "fs/promises";
 import { basename as basename5, dirname as dirname8, resolve as resolve4 } from "path";
 import { homedir as homedir33 } from "os";
 function requestedAgents(agent) {
@@ -271312,7 +271397,7 @@ async function inspectCodexPluginBundle() {
   }
   let manifest = null;
   try {
-    manifest = asRecord3(JSON.parse(await readFile8(manifestPath, "utf-8")));
+    manifest = asRecord3(JSON.parse(await readFile9(manifestPath, "utf-8")));
   } catch {
     return {
       scope: "global",
@@ -271341,7 +271426,7 @@ async function inspectCodexPluginBundle() {
     issues.push("codex-plugin-mcp-manifest-missing");
   } else {
     try {
-      const mcpConfig = asRecord3(JSON.parse(await readFile8(mcpPath, "utf-8")));
+      const mcpConfig = asRecord3(JSON.parse(await readFile9(mcpPath, "utf-8")));
       const server = coerceMcpServer("memorix", asRecord3(mcpConfig?.mcpServers)?.memorix);
       if (!server || !isRecommendedStdioServer(server)) {
         issues.push("codex-plugin-mcp-manifest-invalid");
@@ -271355,7 +271440,7 @@ async function inspectCodexPluginBundle() {
     issues.push("codex-hook-manifest-missing");
   } else {
     try {
-      const hooksConfig = asRecord3(JSON.parse(await readFile8(hooksPath, "utf-8")));
+      const hooksConfig = asRecord3(JSON.parse(await readFile9(hooksPath, "utf-8")));
       const hooks = asRecord3(hooksConfig?.hooks);
       declared = hooks ? Object.keys(hooks) : [];
       if (CODEX_HOOK_EVENTS.some((event) => !declared.includes(event))) {
@@ -271390,7 +271475,7 @@ async function inspectCodexMarketplace() {
   }
   let catalog = null;
   try {
-    catalog = asRecord3(JSON.parse(await readFile8(marketplacePath, "utf-8")));
+    catalog = asRecord3(JSON.parse(await readFile9(marketplacePath, "utf-8")));
   } catch {
     return {
       scope: "global",
@@ -271480,7 +271565,7 @@ async function inspectCodexHookTrust() {
   }
   let config2 = "";
   try {
-    config2 = await readFile8(configPath, "utf-8");
+    config2 = await readFile9(configPath, "utf-8");
   } catch {
     return {
       scope: "global",
@@ -271607,7 +271692,7 @@ async function inspectClaudeLocalMcp(projectRoot) {
   }
   let config2 = {};
   try {
-    config2 = JSON.parse(await readFile8(configPath, "utf-8"));
+    config2 = JSON.parse(await readFile9(configPath, "utf-8"));
   } catch {
     return {
       scope: "local",
@@ -271656,7 +271741,7 @@ async function installClaudeLocalMcpConfig(projectRoot) {
   const configPath = getClaudeLocalConfigPath();
   let config2 = {};
   try {
-    config2 = JSON.parse(await readFile8(configPath, "utf-8"));
+    config2 = JSON.parse(await readFile9(configPath, "utf-8"));
   } catch {
     config2 = {};
   }
@@ -271695,7 +271780,7 @@ async function inspectCodexPluginMcp() {
     };
   }
   try {
-    const config2 = asRecord3(JSON.parse(await readFile8(mcpPath, "utf-8")));
+    const config2 = asRecord3(JSON.parse(await readFile9(mcpPath, "utf-8")));
     const server = coerceMcpServer("memorix", asRecord3(config2?.mcpServers)?.memorix);
     if (!server) {
       return {
@@ -271760,7 +271845,7 @@ async function inspectMcp(agent, projectRoot, scope) {
       });
       continue;
     }
-    const content = await readFile8(configPath, "utf-8");
+    const content = await readFile9(configPath, "utf-8");
     if (agent === "claude" && targetScope === "global") {
       try {
         const parsed = JSON.parse(content);
@@ -271837,7 +271922,7 @@ async function inspectGuidance(agent, projectRoot, scope) {
       });
       continue;
     }
-    const content = await readFile8(rulesPath, "utf-8");
+    const content = await readFile9(rulesPath, "utf-8");
     const issues = isCurrentGuidance(content) ? [] : ["guidance-outdated"];
     checks.push({
       scope: targetScope,