memorix 1.4.3 → 1.4.4

package/dist/index.js

@@ -17859,7 +17859,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,
@@ -17874,7 +17874,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,
@@ -17891,7 +17891,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,
@@ -17906,7 +17906,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,
@@ -18005,9 +18005,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 prompt = context.input.filter((item) => item.type === "text").map((item) => sanitizeSurrogates(item.text).trim()).filter(Boolean).join("\n");
   if (!prompt) {
     throw new Error("MiniMax image generation requires a text prompt");
@@ -18018,6 +18019,7 @@ function buildPayload(model, context, options) {
   return {
     model: model.id,
     prompt,
+    ...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 } : {},
@@ -143168,6 +143170,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 (error) {
@@ -143207,9 +143210,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,
@@ -165553,7 +165560,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) => {
@@ -169236,6 +169243,16 @@ ${lines.join("\n")}` }] };
       return { content: [{ type: "text", text: lines.filter(Boolean).join("\n") }] };
     }
   );
+  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 && (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",
     {
@@ -169251,6 +169268,7 @@ ${lines.join("\n")}` }] };
         title: z626.string().optional().describe("Observation title when attaching generated/imported output."),
         narrative: z626.string().optional().describe("Short retrieval text when attaching an asset."),
         prompt: z626.string().optional().describe("Explicit MiniMax generation prompt."),
+        image: z626.string().optional().describe("Base64-encoded reference image for image-to-image generation."),
         model: z626.string().max(160).optional().describe("Provider model for the selected media action."),
         provider: z626.enum(["openai", "groq"]).optional().describe("Explicit audio transcription provider."),
         language: z626.string().max(32).optional().describe("Optional ISO-639-1 hint for audio transcription."),
@@ -169265,7 +169283,7 @@ ${lines.join("\n")}` }] };
         attach: z626.boolean().optional().describe("Attach generated/imported output to normal project memory explicitly.")
       }
     },
-    async ({ action, path: assetPath, assetId, jobId, kind, limit: limit2, title, narrative, prompt, model, provider: provider2, language, region, n, ratio, width, height, duration, maxPages, maxChars, attach }) => {
+    async ({ action, path: assetPath, assetId, jobId, kind, limit: limit2, title, narrative, prompt, image, model, provider: provider2, language, region, n, ratio, width, height, duration, maxPages, maxChars, attach }) => {
       const unresolved = requireResolvedProject("manage controlled media");
       if (unresolved) return unresolved;
       const safeError4 = (error) => sanitizeCredentials(
@@ -169394,6 +169412,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 = detectReferenceImageMimeType(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,
@@ -169404,7 +169430,8 @@ ${lines.join("\n")}` }] };
             n,
             aspectRatio: imageRatio,
             width,
-            height
+            height,
+            subjectImages
           });
           const observations2 = attach === true ? await Promise.all(generated.assets.map(({ asset }) => attachAsset(
             asset,
@@ -169866,7 +169893,7 @@ var init_serve_shared = __esm({
 
 // src/cli/version.ts
 function getCliVersion() {
-  return true ? "1.4.3" : pkg.version;
+  return true ? "1.4.4" : pkg.version;
 }
 var init_version3 = __esm({
   "src/cli/version.ts"() {

package/dist/maintenance-runner.js

@@ -16266,7 +16266,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,
@@ -16281,7 +16281,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,
@@ -16298,7 +16298,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,
@@ -16313,7 +16313,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,
@@ -16405,9 +16405,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 prompt = context.input.filter((item) => item.type === "text").map((item) => sanitizeSurrogates(item.text).trim()).filter(Boolean).join("\n");
   if (!prompt) {
     throw new Error("MiniMax image generation requires a text prompt");
@@ -16418,6 +16419,7 @@ function buildPayload(model, context, options) {
   return {
     model: model.id,
     prompt,
+    ...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 } : {},

package/dist/media-audio-runner.js

@@ -16193,7 +16193,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,
@@ -16208,7 +16208,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,
@@ -16225,7 +16225,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,
@@ -16240,7 +16240,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,
@@ -16332,9 +16332,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 prompt = context.input.filter((item) => item.type === "text").map((item) => sanitizeSurrogates(item.text).trim()).filter(Boolean).join("\n");
   if (!prompt) {
     throw new Error("MiniMax image generation requires a text prompt");
@@ -16345,6 +16346,7 @@ function buildPayload(model, context, options) {
   return {
     model: model.id,
     prompt,
+    ...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 } : {},

package/dist/media-video-runner.js

@@ -16238,7 +16238,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,
@@ -16253,7 +16253,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,
@@ -16270,7 +16270,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,
@@ -16285,7 +16285,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,
@@ -16377,9 +16377,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 prompt = context.input.filter((item) => item.type === "text").map((item) => sanitizeSurrogates(item.text).trim()).filter(Boolean).join("\n");
   if (!prompt) {
     throw new Error("MiniMax image generation requires a text prompt");
@@ -16390,6 +16391,7 @@ function buildPayload(model, context, options) {
   return {
     model: model.id,
     prompt,
+    ...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 } : {},

package/dist/memcode/index.js

@@ -33314,9 +33314,10 @@ __export(minimax_exports, {
 });
 import { isIP } from "net";
 function buildPayload(model, context, options2) {
-  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 prompt = context.input.filter((item) => item.type === "text").map((item) => sanitizeSurrogates(item.text).trim()).filter(Boolean).join("\n");
   if (!prompt) {
     throw new Error("MiniMax image generation requires a text prompt");
@@ -33327,6 +33328,7 @@ function buildPayload(model, context, options2) {
   return {
     model: model.id,
     prompt,
+    ...subjectReference.length > 0 ? { subject_reference: subjectReference } : {},
     ...options2?.aspectRatio !== void 0 ? { aspect_ratio: options2.aspectRatio } : {},
     ...options2?.width !== void 0 ? { width: options2.width } : {},
     ...options2?.height !== void 0 ? { height: options2.height } : {},
@@ -199689,7 +199691,7 @@ var IMAGE_MODELS = {
       api: "minimax-images",
       provider: "minimax",
       baseUrl: "https://api.minimax.io/v1/image_generation",
-      input: ["text"],
+      input: ["text", "image"],
       output: ["image"],
       cost: {
         "input": 0,
@@ -199704,7 +199706,7 @@ var IMAGE_MODELS = {
       api: "minimax-images",
       provider: "minimax",
       baseUrl: "https://api.minimax.io/v1/image_generation",
-      input: ["text"],
+      input: ["text", "image"],
       output: ["image"],
       cost: {
         "input": 0,
@@ -199721,7 +199723,7 @@ var IMAGE_MODELS = {
       api: "minimax-images",
       provider: "minimax-cn",
       baseUrl: "https://api.minimaxi.com/v1/image_generation",
-      input: ["text"],
+      input: ["text", "image"],
       output: ["image"],
       cost: {
         "input": 0,
@@ -199736,7 +199738,7 @@ var IMAGE_MODELS = {
       api: "minimax-images",
       provider: "minimax-cn",
       baseUrl: "https://api.minimaxi.com/v1/image_generation",
-      input: ["text"],
+      input: ["text", "image"],
       output: ["image"],
       cost: {
         "input": 0,

package/dist/memcode-runtime/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.4.4] - 2026-08-14
+
+### Added
+- **MiniMax image-to-image** -- `memorix media generate image --image
+  <path>` sends a reference image through MiniMax's documented
+  `subject_reference` API for the image-01/image-01-live models. The gated
+  `memorix_media` MCP tool accepts an optional base64 reference image with the
+  same 20 MiB visual limit and MIME validation. The existing MCP generation
+  billing gate is unchanged. Contributed by
+  [@octo-patch](https://github.com/octo-patch) in #178.
+
+### Fixed
+- **CLI argument crash on long text** -- `memorix memory store --text` could
+  fail with `Error: named?.trim is not a function` when a repeated flag or a
+  Windows PowerShell 5.1 argument split delivered the value as an array.
+  CLI argument coercion now joins repeated free-text arguments and takes the
+  last value for scalar and enum flags, with regression tests. Reported by
+  [@skywalker-35](https://github.com/skywalker-35) in #194.
+
 ## [1.4.3] - 2026-08-10
 
 ### Added

package/dist/sdk.js

@@ -17863,7 +17863,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,
@@ -17878,7 +17878,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,
@@ -17895,7 +17895,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,
@@ -17910,7 +17910,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,
@@ -18009,9 +18009,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 prompt = context.input.filter((item) => item.type === "text").map((item) => sanitizeSurrogates(item.text).trim()).filter(Boolean).join("\n");
   if (!prompt) {
     throw new Error("MiniMax image generation requires a text prompt");
@@ -18022,6 +18023,7 @@ function buildPayload(model, context, options) {
   return {
     model: model.id,
     prompt,
+    ...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 } : {},
@@ -143172,6 +143174,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 (error) {
@@ -143211,9 +143214,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,
@@ -165367,7 +165374,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) => {
@@ -169050,6 +169057,16 @@ ${lines.join("\n")}` }] };
       return { content: [{ type: "text", text: lines.filter(Boolean).join("\n") }] };
     }
   );
+  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 && (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",
     {
@@ -169065,6 +169082,7 @@ ${lines.join("\n")}` }] };
         title: z626.string().optional().describe("Observation title when attaching generated/imported output."),
         narrative: z626.string().optional().describe("Short retrieval text when attaching an asset."),
         prompt: z626.string().optional().describe("Explicit MiniMax generation prompt."),
+        image: z626.string().optional().describe("Base64-encoded reference image for image-to-image generation."),
         model: z626.string().max(160).optional().describe("Provider model for the selected media action."),
         provider: z626.enum(["openai", "groq"]).optional().describe("Explicit audio transcription provider."),
         language: z626.string().max(32).optional().describe("Optional ISO-639-1 hint for audio transcription."),
@@ -169079,7 +169097,7 @@ ${lines.join("\n")}` }] };
         attach: z626.boolean().optional().describe("Attach generated/imported output to normal project memory explicitly.")
       }
     },
-    async ({ action, path: assetPath, assetId, jobId, kind, limit: limit2, title, narrative, prompt, model, provider: provider2, language, region, n, ratio, width, height, duration, maxPages, maxChars, attach }) => {
+    async ({ action, path: assetPath, assetId, jobId, kind, limit: limit2, title, narrative, prompt, image, model, provider: provider2, language, region, n, ratio, width, height, duration, maxPages, maxChars, attach }) => {
       const unresolved = requireResolvedProject("manage controlled media");
       if (unresolved) return unresolved;
       const safeError4 = (error) => sanitizeCredentials(
@@ -169208,6 +169226,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 = detectReferenceImageMimeType(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,
@@ -169218,7 +169244,8 @@ ${lines.join("\n")}` }] };
             n,
             aspectRatio: imageRatio,
             width,
-            height
+            height,
+            subjectImages
           });
           const observations2 = attach === true ? await Promise.all(generated.assets.map(({ asset }) => attachAsset(
             asset,

package/dist/vector-backfill-runner.js

@@ -18216,7 +18216,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,
@@ -18231,7 +18231,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,
@@ -18248,7 +18248,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,
@@ -18263,7 +18263,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,
@@ -18355,9 +18355,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 prompt = context.input.filter((item) => item.type === "text").map((item) => sanitizeSurrogates(item.text).trim()).filter(Boolean).join("\n");
   if (!prompt) {
     throw new Error("MiniMax image generation requires a text prompt");
@@ -18368,6 +18369,7 @@ function buildPayload(model, context, options) {
   return {
     model: model.id,
     prompt,
+    ...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 } : {},

package/docs/AGENT_OPERATOR_PLAYBOOK.md

@@ -25,9 +25,9 @@ It supports:
 - local-first project-scoped memory
 - cross-agent recall across Cursor, Claude Code, Codex, CodeBuddy Code, Windsurf, Gemini CLI, GitHub Copilot, OpenCode, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, and Trae
 
-### Current 1.2 Baseline
+### Current 1.4 Baseline
 
-For the 1.2 release line, the visible product shape is:
+For the 1.4 release line, the visible product shape is:
 
 - `memorix setup --agent <agent> --global` is the default integration command for an existing coding agent or IDE
 - setup installs plugin packages where supported, MCP config, usage guidance, hooks, and skills according to agent capability
@@ -50,7 +50,7 @@ For the 1.2 release line, the visible product shape is:
 
 ### CLI is the direct command surface; MCP is the integration layer
 
-For direct use, prefer `memorix ...` commands first. In the 1.3 line, the CLI covers session, memory, reviewed long-term memory, Code State, knowledge workspaces, reasoning, retention, formation, audit, transfer, skills, orchestration coordination, sync, ingest workflows, and the bundled terminal agent.
+For direct use, prefer `memorix ...` commands first. In the 1.4 line, the CLI covers session, memory, reviewed long-term memory, Code State, knowledge workspaces, reasoning, retention, formation, audit, transfer, skills, orchestration coordination, sync, controlled media, ingest workflows, and the bundled terminal agent.
 
 Do not ask memory-only users to join coordination state. A lightweight session is enough for memory, retrieval, reasoning, and continuation. Use `joinTeam` / `team_manage(join)` only for explicit task/message/lock coordination or for CLI-agent work managed by `memorix orchestrate`.