memorix 1.9.3 → 1.9.4

package/CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [1.9.4] - 2026-09-18
+
+### Added
+- **MiniMax first-frame video input** -- image-to-video generation now accepts
+  a public HTTPS first-frame image URL through the CLI and MCP surfaces,
+  preserves it in durable media jobs, and submits it with the provider's
+  `first_frame` image role.
+
+### Fixed
+- **First-frame URL safety** -- rejects non-HTTPS URLs and embedded credentials
+  before a media request is submitted or persisted.
+
+### Changed
+- **Grok Build documentation** -- the README comparison now uses the official
+  Grok Build logo assets.
+
 ## [1.9.3] - 2026-09-14
 
 ### Fixed

package/README.md

@@ -187,7 +187,7 @@ Memorix connects through the interfaces each agent already supports: plugin pack
 <sub>stdio or HTTP MCP</sub>
 </td>
 <td align="center" width="12.5%">
-<a href="https://github.com/xai-org/grok-build"><img src="https://github.com/xai-org.png?size=120" alt="Grok Build" width="48" height="48"></a><br>
+<a href="https://github.com/xai-org/grok-build"><picture><source media="(prefers-color-scheme: dark)" srcset="https://media.x.ai/v1/website/spacexai-symbol-white-transparent-0c31957f.png"><img src="https://media.x.ai/v1/website/spacexai-symbol-black-transparent-6435cf42.png" alt="Grok Build" width="48" height="48"></picture></a><br>
 <strong>Grok Build</strong><br>
 <sub>native hooks + AGENTS.md</sub>
 </td>

package/README.zh-CN.md

@@ -182,7 +182,7 @@ Memorix 通过目标 Agent 已有的接口接入：插件包、MCP、项目规
 <sub>stdio or HTTP MCP</sub>
 </td>
 <td align="center" width="12.5%">
-<a href="https://github.com/xai-org/grok-build"><img src="https://github.com/xai-org.png?size=120" alt="Grok Build" width="48" height="48"></a><br>
+<a href="https://github.com/xai-org/grok-build"><picture><source media="(prefers-color-scheme: dark)" srcset="https://media.x.ai/v1/website/spacexai-symbol-white-transparent-0c31957f.png"><img src="https://media.x.ai/v1/website/spacexai-symbol-black-transparent-6435cf42.png" alt="Grok Build" width="48" height="48"></picture></a><br>
 <strong>Grok Build</strong><br>
 <sub>原生 hooks + AGENTS.md</sub>
 </td>

package/dist/cli/index.js

@@ -3232,7 +3232,7 @@ ${import_picocolors.default.gray(m3)}  ${s4}
 
 // src/cli/version.ts
 function getCliVersion() {
-  return true ? "1.9.3" : pkg.version;
+  return true ? "1.9.4" : pkg.version;
 }
 var init_version = __esm({
   "src/cli/version.ts"() {
@@ -177667,7 +177667,20 @@ function normalizeMiniMaxVideoRequest(input) {
   if (ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1") {
     throw new Error("MiniMax video ratio must be adaptive, 16:9, 9:16, or 1:1");
   }
-  return { region, model, prompt: prompt2, resolution, duration: duration3, ratio };
+  let firstFrameImageUrl;
+  if (input.firstFrameImageUrl !== void 0) {
+    firstFrameImageUrl = input.firstFrameImageUrl.trim();
+    let parsed;
+    try {
+      parsed = new URL(firstFrameImageUrl);
+    } catch {
+      throw new Error("MiniMax first-frame image must be a public HTTPS URL");
+    }
+    if (parsed.protocol !== "https:" || parsed.username || parsed.password || sanitizeCredentials(firstFrameImageUrl) !== firstFrameImageUrl) {
+      throw new Error("MiniMax first-frame image must be an HTTPS URL without credentials");
+    }
+  }
+  return { region, model, prompt: prompt2, resolution, duration: duration3, ratio, ...firstFrameImageUrl ? { firstFrameImageUrl } : {} };
 }
 function videoRequestConfig(input) {
   const normalized = normalizeMiniMaxVideoRequest(input);
@@ -177744,7 +177757,14 @@ async function createMiniMaxVideoTask(input, dependencies = {}) {
       headers: videoHeaders(config2.apiKey),
       body: JSON.stringify({
         model: config2.model,
-        content: [{ type: "text", text: config2.prompt }],
+        content: [
+          { type: "text", text: config2.prompt },
+          ...config2.firstFrameImageUrl ? [{
+            type: "image_url",
+            image_url: { url: config2.firstFrameImageUrl },
+            role: "first_frame"
+          }] : []
+        ],
         resolution: config2.resolution,
         duration: config2.duration,
         ratio: config2.ratio
@@ -177992,10 +178012,19 @@ function parseStoredRequest(value) {
   const duration3 = value.duration;
   const ratio = value.ratio;
   const maxBytes = value.maxBytes;
-  if (provider2 !== "minimax" && provider2 !== "minimax-cn" || region !== "global" && region !== "cn" || model !== "MiniMax-H3" || typeof prompt2 !== "string" || resolution !== "2K" || duration3 !== 5 && duration3 !== 10 || ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1" || typeof maxBytes !== "number" || !Number.isSafeInteger(maxBytes) || maxBytes < 1) {
+  if (provider2 !== "minimax" && provider2 !== "minimax-cn" || region !== "global" && region !== "cn" || model !== "MiniMax-H3" || typeof prompt2 !== "string" || value.firstFrameImageUrl !== void 0 && typeof value.firstFrameImageUrl !== "string" || resolution !== "2K" || duration3 !== 5 && duration3 !== 10 || ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1" || typeof maxBytes !== "number" || !Number.isSafeInteger(maxBytes) || maxBytes < 1) {
     throw new Error("Media video job has an invalid request payload");
   }
-  return { provider: provider2, region, model, prompt: prompt2, resolution, duration: duration3, ratio, maxBytes };
+  const normalized = normalizeMiniMaxVideoRequest({
+    region,
+    model,
+    prompt: prompt2,
+    resolution,
+    duration: duration3,
+    ratio,
+    firstFrameImageUrl: value.firstFrameImageUrl
+  });
+  return { provider: provider2, ...normalized, maxBytes };
 }
 function mediaJobIdFromMaintenance(job) {
   const mediaJobId = job.payload.mediaJobId;
@@ -178007,6 +178036,7 @@ function mediaJobIdFromMaintenance(job) {
 function toVideoRequest(request) {
   return {
     prompt: request.prompt,
+    firstFrameImageUrl: request.firstFrameImageUrl,
     model: request.model,
     region: request.region,
     resolution: request.resolution,
@@ -178098,6 +178128,7 @@ function queueMiniMaxVideoGeneration(input) {
     region: normalized.region,
     model: normalized.model,
     prompt: normalized.prompt,
+    ...normalized.firstFrameImageUrl ? { firstFrameImageUrl: normalized.firstFrameImageUrl } : {},
     resolution: normalized.resolution,
     duration: normalized.duration,
     ratio: normalized.ratio,
@@ -207958,7 +207989,7 @@ var init_tool_profile = __esm({
 function getMcpServerInfo() {
   return {
     name: "memorix",
-    version: true ? "1.9.3" : "1.0.1"
+    version: true ? "1.9.4" : "1.0.1"
   };
 }
 function createMcpDiscoverResult(capabilities, serverInfo) {
@@ -268636,6 +268667,7 @@ ${lines.join("\n")}` }] };
         } : {},
         ...mediaGenerationEnabled ? {
           image: external_exports2.string().optional().describe("Base64-encoded reference image for image-to-image generation."),
+          firstFrameImageUrl: external_exports2.string().optional().describe("Public HTTPS first-frame image URL for MiniMax video generation; stored with the queued job."),
           region: external_exports2.enum(["global", "cn"]).optional().describe("MiniMax deployment region."),
           n: external_exports2.number().int().min(1).max(4).optional().describe("Image output count."),
           ratio: external_exports2.enum(["adaptive", "1:1", "16:9", "4:3", "3:2", "2:3", "3:4", "9:16", "21:9"]).optional().describe("Image or video aspect ratio."),
@@ -268645,7 +268677,7 @@ ${lines.join("\n")}` }] };
         } : {}
       }
     },
-    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 }) => {
+    async ({ action, path: assetPath, assetId, jobId, kind, limit: limit2, title, narrative, prompt: prompt2, image, firstFrameImageUrl, 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(
@@ -268815,6 +268847,7 @@ ${lines.join("\n")}` }] };
             dataDir: projectDir2,
             projectId: project.id,
             prompt: prompt2,
+            firstFrameImageUrl,
             ...model === "MiniMax-H3" ? { model } : {},
             ...region ? { region } : {},
             ...videoRatio ? { ratio: videoRatio } : {},
@@ -279290,6 +279323,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" },
+        "first-frame-image-url": { type: "string", description: "Public HTTPS first-frame image URL for MiniMax video generation; stored with the queued job" },
         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" },
@@ -279340,6 +279374,7 @@ var init_media = __esm({
                   dataDir,
                   projectId: project.id,
                   prompt: prompt2,
+                  firstFrameImageUrl: args["first-frame-image-url"],
                   model: parseMiniMaxVideoModel(args.model),
                   region: parseMiniMaxRegion(args.region),
                   duration: parseMiniMaxVideoDuration(args.duration),

package/dist/index.js

@@ -145188,7 +145188,20 @@ function normalizeMiniMaxVideoRequest(input) {
   if (ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1") {
     throw new Error("MiniMax video ratio must be adaptive, 16:9, 9:16, or 1:1");
   }
-  return { region, model, prompt, resolution, duration, ratio };
+  let firstFrameImageUrl;
+  if (input.firstFrameImageUrl !== void 0) {
+    firstFrameImageUrl = input.firstFrameImageUrl.trim();
+    let parsed;
+    try {
+      parsed = new URL(firstFrameImageUrl);
+    } catch {
+      throw new Error("MiniMax first-frame image must be a public HTTPS URL");
+    }
+    if (parsed.protocol !== "https:" || parsed.username || parsed.password || sanitizeCredentials(firstFrameImageUrl) !== firstFrameImageUrl) {
+      throw new Error("MiniMax first-frame image must be an HTTPS URL without credentials");
+    }
+  }
+  return { region, model, prompt, resolution, duration, ratio, ...firstFrameImageUrl ? { firstFrameImageUrl } : {} };
 }
 function videoRequestConfig(input) {
   const normalized = normalizeMiniMaxVideoRequest(input);
@@ -145265,7 +145278,14 @@ async function createMiniMaxVideoTask(input, dependencies = {}) {
       headers: videoHeaders(config.apiKey),
       body: JSON.stringify({
         model: config.model,
-        content: [{ type: "text", text: config.prompt }],
+        content: [
+          { type: "text", text: config.prompt },
+          ...config.firstFrameImageUrl ? [{
+            type: "image_url",
+            image_url: { url: config.firstFrameImageUrl },
+            role: "first_frame"
+          }] : []
+        ],
         resolution: config.resolution,
         duration: config.duration,
         ratio: config.ratio
@@ -145513,10 +145533,19 @@ function parseStoredRequest(value) {
   const duration = value.duration;
   const ratio = value.ratio;
   const maxBytes = value.maxBytes;
-  if (provider2 !== "minimax" && provider2 !== "minimax-cn" || region !== "global" && region !== "cn" || model !== "MiniMax-H3" || typeof prompt !== "string" || resolution !== "2K" || duration !== 5 && duration !== 10 || ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1" || typeof maxBytes !== "number" || !Number.isSafeInteger(maxBytes) || maxBytes < 1) {
+  if (provider2 !== "minimax" && provider2 !== "minimax-cn" || region !== "global" && region !== "cn" || model !== "MiniMax-H3" || typeof prompt !== "string" || value.firstFrameImageUrl !== void 0 && typeof value.firstFrameImageUrl !== "string" || resolution !== "2K" || duration !== 5 && duration !== 10 || ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1" || typeof maxBytes !== "number" || !Number.isSafeInteger(maxBytes) || maxBytes < 1) {
     throw new Error("Media video job has an invalid request payload");
   }
-  return { provider: provider2, region, model, prompt, resolution, duration, ratio, maxBytes };
+  const normalized = normalizeMiniMaxVideoRequest({
+    region,
+    model,
+    prompt,
+    resolution,
+    duration,
+    ratio,
+    firstFrameImageUrl: value.firstFrameImageUrl
+  });
+  return { provider: provider2, ...normalized, maxBytes };
 }
 function mediaJobIdFromMaintenance(job) {
   const mediaJobId = job.payload.mediaJobId;
@@ -145528,6 +145557,7 @@ function mediaJobIdFromMaintenance(job) {
 function toVideoRequest(request) {
   return {
     prompt: request.prompt,
+    firstFrameImageUrl: request.firstFrameImageUrl,
     model: request.model,
     region: request.region,
     resolution: request.resolution,
@@ -145619,6 +145649,7 @@ function queueMiniMaxVideoGeneration(input) {
     region: normalized.region,
     model: normalized.model,
     prompt: normalized.prompt,
+    ...normalized.firstFrameImageUrl ? { firstFrameImageUrl: normalized.firstFrameImageUrl } : {},
     resolution: normalized.resolution,
     duration: normalized.duration,
     ratio: normalized.ratio,
@@ -159771,7 +159802,7 @@ var init_request_context = __esm({
 function getMcpServerInfo() {
   return {
     name: "memorix",
-    version: true ? "1.9.3" : "1.0.1"
+    version: true ? "1.9.4" : "1.0.1"
   };
 }
 function createMcpDiscoverResult(capabilities, serverInfo) {
@@ -174485,6 +174516,7 @@ ${lines.join("\n")}` }] };
         } : {},
         ...mediaGenerationEnabled ? {
           image: z627.string().optional().describe("Base64-encoded reference image for image-to-image generation."),
+          firstFrameImageUrl: z627.string().optional().describe("Public HTTPS first-frame image URL for MiniMax video generation; stored with the queued job."),
           region: z627.enum(["global", "cn"]).optional().describe("MiniMax deployment region."),
           n: z627.number().int().min(1).max(4).optional().describe("Image output count."),
           ratio: z627.enum(["adaptive", "1:1", "16:9", "4:3", "3:2", "2:3", "3:4", "9:16", "21:9"]).optional().describe("Image or video aspect ratio."),
@@ -174494,7 +174526,7 @@ ${lines.join("\n")}` }] };
         } : {}
       }
     },
-    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 }) => {
+    async ({ action, path: assetPath, assetId, jobId, kind, limit: limit2, title, narrative, prompt, image, firstFrameImageUrl, 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(
@@ -174664,6 +174696,7 @@ ${lines.join("\n")}` }] };
             dataDir: projectDir2,
             projectId: project.id,
             prompt,
+            firstFrameImageUrl,
             ...model === "MiniMax-H3" ? { model } : {},
             ...region ? { region } : {},
             ...videoRatio ? { ratio: videoRatio } : {},
@@ -175480,7 +175513,7 @@ var init_serve_shared = __esm({
 
 // src/cli/version.ts
 function getCliVersion() {
-  return true ? "1.9.3" : pkg.version;
+  return true ? "1.9.4" : pkg.version;
 }
 var init_version3 = __esm({
   "src/cli/version.ts"() {

package/dist/maintenance-runner.js

@@ -143484,7 +143484,20 @@ function normalizeMiniMaxVideoRequest(input) {
   if (ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1") {
     throw new Error("MiniMax video ratio must be adaptive, 16:9, 9:16, or 1:1");
   }
-  return { region, model, prompt, resolution, duration, ratio };
+  let firstFrameImageUrl;
+  if (input.firstFrameImageUrl !== void 0) {
+    firstFrameImageUrl = input.firstFrameImageUrl.trim();
+    let parsed;
+    try {
+      parsed = new URL(firstFrameImageUrl);
+    } catch {
+      throw new Error("MiniMax first-frame image must be a public HTTPS URL");
+    }
+    if (parsed.protocol !== "https:" || parsed.username || parsed.password || sanitizeCredentials(firstFrameImageUrl) !== firstFrameImageUrl) {
+      throw new Error("MiniMax first-frame image must be an HTTPS URL without credentials");
+    }
+  }
+  return { region, model, prompt, resolution, duration, ratio, ...firstFrameImageUrl ? { firstFrameImageUrl } : {} };
 }
 function videoRequestConfig(input) {
   const normalized = normalizeMiniMaxVideoRequest(input);
@@ -143561,7 +143574,14 @@ async function createMiniMaxVideoTask(input, dependencies = {}) {
       headers: videoHeaders(config.apiKey),
       body: JSON.stringify({
         model: config.model,
-        content: [{ type: "text", text: config.prompt }],
+        content: [
+          { type: "text", text: config.prompt },
+          ...config.firstFrameImageUrl ? [{
+            type: "image_url",
+            image_url: { url: config.firstFrameImageUrl },
+            role: "first_frame"
+          }] : []
+        ],
         resolution: config.resolution,
         duration: config.duration,
         ratio: config.ratio
@@ -143722,10 +143742,19 @@ function parseStoredRequest(value) {
   const duration = value.duration;
   const ratio = value.ratio;
   const maxBytes = value.maxBytes;
-  if (provider2 !== "minimax" && provider2 !== "minimax-cn" || region !== "global" && region !== "cn" || model !== "MiniMax-H3" || typeof prompt !== "string" || resolution !== "2K" || duration !== 5 && duration !== 10 || ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1" || typeof maxBytes !== "number" || !Number.isSafeInteger(maxBytes) || maxBytes < 1) {
+  if (provider2 !== "minimax" && provider2 !== "minimax-cn" || region !== "global" && region !== "cn" || model !== "MiniMax-H3" || typeof prompt !== "string" || value.firstFrameImageUrl !== void 0 && typeof value.firstFrameImageUrl !== "string" || resolution !== "2K" || duration !== 5 && duration !== 10 || ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1" || typeof maxBytes !== "number" || !Number.isSafeInteger(maxBytes) || maxBytes < 1) {
     throw new Error("Media video job has an invalid request payload");
   }
-  return { provider: provider2, region, model, prompt, resolution, duration, ratio, maxBytes };
+  const normalized = normalizeMiniMaxVideoRequest({
+    region,
+    model,
+    prompt,
+    resolution,
+    duration,
+    ratio,
+    firstFrameImageUrl: value.firstFrameImageUrl
+  });
+  return { provider: provider2, ...normalized, maxBytes };
 }
 function mediaJobIdFromMaintenance(job) {
   const mediaJobId = job.payload.mediaJobId;
@@ -143737,6 +143766,7 @@ function mediaJobIdFromMaintenance(job) {
 function toVideoRequest(request) {
   return {
     prompt: request.prompt,
+    firstFrameImageUrl: request.firstFrameImageUrl,
     model: request.model,
     region: request.region,
     resolution: request.resolution,
@@ -143828,6 +143858,7 @@ function queueMiniMaxVideoGeneration(input) {
     region: normalized.region,
     model: normalized.model,
     prompt: normalized.prompt,
+    ...normalized.firstFrameImageUrl ? { firstFrameImageUrl: normalized.firstFrameImageUrl } : {},
     resolution: normalized.resolution,
     duration: normalized.duration,
     ratio: normalized.ratio,

package/dist/media-audio-runner.js

@@ -143409,7 +143409,20 @@ function normalizeMiniMaxVideoRequest(input) {
   if (ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1") {
     throw new Error("MiniMax video ratio must be adaptive, 16:9, 9:16, or 1:1");
   }
-  return { region, model, prompt, resolution, duration, ratio };
+  let firstFrameImageUrl;
+  if (input.firstFrameImageUrl !== void 0) {
+    firstFrameImageUrl = input.firstFrameImageUrl.trim();
+    let parsed;
+    try {
+      parsed = new URL(firstFrameImageUrl);
+    } catch {
+      throw new Error("MiniMax first-frame image must be a public HTTPS URL");
+    }
+    if (parsed.protocol !== "https:" || parsed.username || parsed.password || sanitizeCredentials(firstFrameImageUrl) !== firstFrameImageUrl) {
+      throw new Error("MiniMax first-frame image must be an HTTPS URL without credentials");
+    }
+  }
+  return { region, model, prompt, resolution, duration, ratio, ...firstFrameImageUrl ? { firstFrameImageUrl } : {} };
 }
 function videoRequestConfig(input) {
   const normalized = normalizeMiniMaxVideoRequest(input);
@@ -143486,7 +143499,14 @@ async function createMiniMaxVideoTask(input, dependencies = {}) {
       headers: videoHeaders(config.apiKey),
       body: JSON.stringify({
         model: config.model,
-        content: [{ type: "text", text: config.prompt }],
+        content: [
+          { type: "text", text: config.prompt },
+          ...config.firstFrameImageUrl ? [{
+            type: "image_url",
+            image_url: { url: config.firstFrameImageUrl },
+            role: "first_frame"
+          }] : []
+        ],
         resolution: config.resolution,
         duration: config.duration,
         ratio: config.ratio
@@ -143647,10 +143667,19 @@ function parseStoredRequest(value) {
   const duration = value.duration;
   const ratio = value.ratio;
   const maxBytes = value.maxBytes;
-  if (provider2 !== "minimax" && provider2 !== "minimax-cn" || region !== "global" && region !== "cn" || model !== "MiniMax-H3" || typeof prompt !== "string" || resolution !== "2K" || duration !== 5 && duration !== 10 || ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1" || typeof maxBytes !== "number" || !Number.isSafeInteger(maxBytes) || maxBytes < 1) {
+  if (provider2 !== "minimax" && provider2 !== "minimax-cn" || region !== "global" && region !== "cn" || model !== "MiniMax-H3" || typeof prompt !== "string" || value.firstFrameImageUrl !== void 0 && typeof value.firstFrameImageUrl !== "string" || resolution !== "2K" || duration !== 5 && duration !== 10 || ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1" || typeof maxBytes !== "number" || !Number.isSafeInteger(maxBytes) || maxBytes < 1) {
     throw new Error("Media video job has an invalid request payload");
   }
-  return { provider: provider2, region, model, prompt, resolution, duration, ratio, maxBytes };
+  const normalized = normalizeMiniMaxVideoRequest({
+    region,
+    model,
+    prompt,
+    resolution,
+    duration,
+    ratio,
+    firstFrameImageUrl: value.firstFrameImageUrl
+  });
+  return { provider: provider2, ...normalized, maxBytes };
 }
 function mediaJobIdFromMaintenance(job) {
   const mediaJobId = job.payload.mediaJobId;
@@ -143662,6 +143691,7 @@ function mediaJobIdFromMaintenance(job) {
 function toVideoRequest(request) {
   return {
     prompt: request.prompt,
+    firstFrameImageUrl: request.firstFrameImageUrl,
     model: request.model,
     region: request.region,
     resolution: request.resolution,
@@ -143753,6 +143783,7 @@ function queueMiniMaxVideoGeneration(input) {
     region: normalized.region,
     model: normalized.model,
     prompt: normalized.prompt,
+    ...normalized.firstFrameImageUrl ? { firstFrameImageUrl: normalized.firstFrameImageUrl } : {},
     resolution: normalized.resolution,
     duration: normalized.duration,
     ratio: normalized.ratio,

package/dist/media-video-runner.js

@@ -143454,7 +143454,20 @@ function normalizeMiniMaxVideoRequest(input) {
   if (ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1") {
     throw new Error("MiniMax video ratio must be adaptive, 16:9, 9:16, or 1:1");
   }
-  return { region, model, prompt, resolution, duration, ratio };
+  let firstFrameImageUrl;
+  if (input.firstFrameImageUrl !== void 0) {
+    firstFrameImageUrl = input.firstFrameImageUrl.trim();
+    let parsed;
+    try {
+      parsed = new URL(firstFrameImageUrl);
+    } catch {
+      throw new Error("MiniMax first-frame image must be a public HTTPS URL");
+    }
+    if (parsed.protocol !== "https:" || parsed.username || parsed.password || sanitizeCredentials(firstFrameImageUrl) !== firstFrameImageUrl) {
+      throw new Error("MiniMax first-frame image must be an HTTPS URL without credentials");
+    }
+  }
+  return { region, model, prompt, resolution, duration, ratio, ...firstFrameImageUrl ? { firstFrameImageUrl } : {} };
 }
 function videoRequestConfig(input) {
   const normalized = normalizeMiniMaxVideoRequest(input);
@@ -143531,7 +143544,14 @@ async function createMiniMaxVideoTask(input, dependencies = {}) {
       headers: videoHeaders(config.apiKey),
       body: JSON.stringify({
         model: config.model,
-        content: [{ type: "text", text: config.prompt }],
+        content: [
+          { type: "text", text: config.prompt },
+          ...config.firstFrameImageUrl ? [{
+            type: "image_url",
+            image_url: { url: config.firstFrameImageUrl },
+            role: "first_frame"
+          }] : []
+        ],
         resolution: config.resolution,
         duration: config.duration,
         ratio: config.ratio
@@ -143692,10 +143712,19 @@ function parseStoredRequest(value) {
   const duration = value.duration;
   const ratio = value.ratio;
   const maxBytes = value.maxBytes;
-  if (provider2 !== "minimax" && provider2 !== "minimax-cn" || region !== "global" && region !== "cn" || model !== "MiniMax-H3" || typeof prompt !== "string" || resolution !== "2K" || duration !== 5 && duration !== 10 || ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1" || typeof maxBytes !== "number" || !Number.isSafeInteger(maxBytes) || maxBytes < 1) {
+  if (provider2 !== "minimax" && provider2 !== "minimax-cn" || region !== "global" && region !== "cn" || model !== "MiniMax-H3" || typeof prompt !== "string" || value.firstFrameImageUrl !== void 0 && typeof value.firstFrameImageUrl !== "string" || resolution !== "2K" || duration !== 5 && duration !== 10 || ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1" || typeof maxBytes !== "number" || !Number.isSafeInteger(maxBytes) || maxBytes < 1) {
     throw new Error("Media video job has an invalid request payload");
   }
-  return { provider: provider2, region, model, prompt, resolution, duration, ratio, maxBytes };
+  const normalized = normalizeMiniMaxVideoRequest({
+    region,
+    model,
+    prompt,
+    resolution,
+    duration,
+    ratio,
+    firstFrameImageUrl: value.firstFrameImageUrl
+  });
+  return { provider: provider2, ...normalized, maxBytes };
 }
 function mediaJobIdFromMaintenance(job) {
   const mediaJobId = job.payload.mediaJobId;
@@ -143707,6 +143736,7 @@ function mediaJobIdFromMaintenance(job) {
 function toVideoRequest(request) {
   return {
     prompt: request.prompt,
+    firstFrameImageUrl: request.firstFrameImageUrl,
     model: request.model,
     region: request.region,
     resolution: request.resolution,
@@ -143798,6 +143828,7 @@ function queueMiniMaxVideoGeneration(input) {
     region: normalized.region,
     model: normalized.model,
     prompt: normalized.prompt,
+    ...normalized.firstFrameImageUrl ? { firstFrameImageUrl: normalized.firstFrameImageUrl } : {},
     resolution: normalized.resolution,
     duration: normalized.duration,
     ratio: normalized.ratio,

package/dist/memcode-runtime/CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [1.9.4] - 2026-09-18
+
+### Added
+- **MiniMax first-frame video input** -- image-to-video generation now accepts
+  a public HTTPS first-frame image URL through the CLI and MCP surfaces,
+  preserves it in durable media jobs, and submits it with the provider's
+  `first_frame` image role.
+
+### Fixed
+- **First-frame URL safety** -- rejects non-HTTPS URLs and embedded credentials
+  before a media request is submitted or persisted.
+
+### Changed
+- **Grok Build documentation** -- the README comparison now uses the official
+  Grok Build logo assets.
+
 ## [1.9.3] - 2026-09-14
 
 ### Fixed

package/dist/sdk.js

@@ -145234,7 +145234,20 @@ function normalizeMiniMaxVideoRequest(input) {
   if (ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1") {
     throw new Error("MiniMax video ratio must be adaptive, 16:9, 9:16, or 1:1");
   }
-  return { region, model, prompt, resolution, duration, ratio };
+  let firstFrameImageUrl;
+  if (input.firstFrameImageUrl !== void 0) {
+    firstFrameImageUrl = input.firstFrameImageUrl.trim();
+    let parsed;
+    try {
+      parsed = new URL(firstFrameImageUrl);
+    } catch {
+      throw new Error("MiniMax first-frame image must be a public HTTPS URL");
+    }
+    if (parsed.protocol !== "https:" || parsed.username || parsed.password || sanitizeCredentials(firstFrameImageUrl) !== firstFrameImageUrl) {
+      throw new Error("MiniMax first-frame image must be an HTTPS URL without credentials");
+    }
+  }
+  return { region, model, prompt, resolution, duration, ratio, ...firstFrameImageUrl ? { firstFrameImageUrl } : {} };
 }
 function videoRequestConfig(input) {
   const normalized = normalizeMiniMaxVideoRequest(input);
@@ -145311,7 +145324,14 @@ async function createMiniMaxVideoTask(input, dependencies = {}) {
       headers: videoHeaders(config.apiKey),
       body: JSON.stringify({
         model: config.model,
-        content: [{ type: "text", text: config.prompt }],
+        content: [
+          { type: "text", text: config.prompt },
+          ...config.firstFrameImageUrl ? [{
+            type: "image_url",
+            image_url: { url: config.firstFrameImageUrl },
+            role: "first_frame"
+          }] : []
+        ],
         resolution: config.resolution,
         duration: config.duration,
         ratio: config.ratio
@@ -145559,10 +145579,19 @@ function parseStoredRequest(value) {
   const duration = value.duration;
   const ratio = value.ratio;
   const maxBytes = value.maxBytes;
-  if (provider2 !== "minimax" && provider2 !== "minimax-cn" || region !== "global" && region !== "cn" || model !== "MiniMax-H3" || typeof prompt !== "string" || resolution !== "2K" || duration !== 5 && duration !== 10 || ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1" || typeof maxBytes !== "number" || !Number.isSafeInteger(maxBytes) || maxBytes < 1) {
+  if (provider2 !== "minimax" && provider2 !== "minimax-cn" || region !== "global" && region !== "cn" || model !== "MiniMax-H3" || typeof prompt !== "string" || value.firstFrameImageUrl !== void 0 && typeof value.firstFrameImageUrl !== "string" || resolution !== "2K" || duration !== 5 && duration !== 10 || ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1" || typeof maxBytes !== "number" || !Number.isSafeInteger(maxBytes) || maxBytes < 1) {
     throw new Error("Media video job has an invalid request payload");
   }
-  return { provider: provider2, region, model, prompt, resolution, duration, ratio, maxBytes };
+  const normalized = normalizeMiniMaxVideoRequest({
+    region,
+    model,
+    prompt,
+    resolution,
+    duration,
+    ratio,
+    firstFrameImageUrl: value.firstFrameImageUrl
+  });
+  return { provider: provider2, ...normalized, maxBytes };
 }
 function mediaJobIdFromMaintenance(job) {
   const mediaJobId = job.payload.mediaJobId;
@@ -145574,6 +145603,7 @@ function mediaJobIdFromMaintenance(job) {
 function toVideoRequest(request) {
   return {
     prompt: request.prompt,
+    firstFrameImageUrl: request.firstFrameImageUrl,
     model: request.model,
     region: request.region,
     resolution: request.resolution,
@@ -145665,6 +145695,7 @@ function queueMiniMaxVideoGeneration(input) {
     region: normalized.region,
     model: normalized.model,
     prompt: normalized.prompt,
+    ...normalized.firstFrameImageUrl ? { firstFrameImageUrl: normalized.firstFrameImageUrl } : {},
     resolution: normalized.resolution,
     duration: normalized.duration,
     ratio: normalized.ratio,
@@ -170019,7 +170050,7 @@ var MCP_SERVER_INFO_META_KEY = "io.modelcontextprotocol/serverInfo";
 function getMcpServerInfo() {
   return {
     name: "memorix",
-    version: true ? "1.9.3" : "1.0.1"
+    version: true ? "1.9.4" : "1.0.1"
   };
 }
 function createMcpDiscoverResult(capabilities, serverInfo) {
@@ -174325,6 +174356,7 @@ ${lines.join("\n")}` }] };
         } : {},
         ...mediaGenerationEnabled ? {
           image: z627.string().optional().describe("Base64-encoded reference image for image-to-image generation."),
+          firstFrameImageUrl: z627.string().optional().describe("Public HTTPS first-frame image URL for MiniMax video generation; stored with the queued job."),
           region: z627.enum(["global", "cn"]).optional().describe("MiniMax deployment region."),
           n: z627.number().int().min(1).max(4).optional().describe("Image output count."),
           ratio: z627.enum(["adaptive", "1:1", "16:9", "4:3", "3:2", "2:3", "3:4", "9:16", "21:9"]).optional().describe("Image or video aspect ratio."),
@@ -174334,7 +174366,7 @@ ${lines.join("\n")}` }] };
         } : {}
       }
     },
-    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 }) => {
+    async ({ action, path: assetPath, assetId, jobId, kind, limit: limit2, title, narrative, prompt, image, firstFrameImageUrl, 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(
@@ -174504,6 +174536,7 @@ ${lines.join("\n")}` }] };
             dataDir: projectDir2,
             projectId: project.id,
             prompt,
+            firstFrameImageUrl,
             ...model === "MiniMax-H3" ? { model } : {},
             ...region ? { region } : {},
             ...videoRatio ? { ratio: videoRatio } : {},

package/dist/vector-backfill-runner.js

@@ -145782,7 +145782,20 @@ function normalizeMiniMaxVideoRequest(input) {
   if (ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1") {
     throw new Error("MiniMax video ratio must be adaptive, 16:9, 9:16, or 1:1");
   }
-  return { region, model, prompt, resolution, duration, ratio };
+  let firstFrameImageUrl;
+  if (input.firstFrameImageUrl !== void 0) {
+    firstFrameImageUrl = input.firstFrameImageUrl.trim();
+    let parsed;
+    try {
+      parsed = new URL(firstFrameImageUrl);
+    } catch {
+      throw new Error("MiniMax first-frame image must be a public HTTPS URL");
+    }
+    if (parsed.protocol !== "https:" || parsed.username || parsed.password || sanitizeCredentials(firstFrameImageUrl) !== firstFrameImageUrl) {
+      throw new Error("MiniMax first-frame image must be an HTTPS URL without credentials");
+    }
+  }
+  return { region, model, prompt, resolution, duration, ratio, ...firstFrameImageUrl ? { firstFrameImageUrl } : {} };
 }
 function videoRequestConfig(input) {
   const normalized = normalizeMiniMaxVideoRequest(input);
@@ -145859,7 +145872,14 @@ async function createMiniMaxVideoTask(input, dependencies = {}) {
       headers: videoHeaders(config.apiKey),
       body: JSON.stringify({
         model: config.model,
-        content: [{ type: "text", text: config.prompt }],
+        content: [
+          { type: "text", text: config.prompt },
+          ...config.firstFrameImageUrl ? [{
+            type: "image_url",
+            image_url: { url: config.firstFrameImageUrl },
+            role: "first_frame"
+          }] : []
+        ],
         resolution: config.resolution,
         duration: config.duration,
         ratio: config.ratio
@@ -146020,10 +146040,19 @@ function parseStoredRequest(value) {
   const duration = value.duration;
   const ratio = value.ratio;
   const maxBytes = value.maxBytes;
-  if (provider2 !== "minimax" && provider2 !== "minimax-cn" || region !== "global" && region !== "cn" || model !== "MiniMax-H3" || typeof prompt !== "string" || resolution !== "2K" || duration !== 5 && duration !== 10 || ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1" || typeof maxBytes !== "number" || !Number.isSafeInteger(maxBytes) || maxBytes < 1) {
+  if (provider2 !== "minimax" && provider2 !== "minimax-cn" || region !== "global" && region !== "cn" || model !== "MiniMax-H3" || typeof prompt !== "string" || value.firstFrameImageUrl !== void 0 && typeof value.firstFrameImageUrl !== "string" || resolution !== "2K" || duration !== 5 && duration !== 10 || ratio !== "adaptive" && ratio !== "16:9" && ratio !== "9:16" && ratio !== "1:1" || typeof maxBytes !== "number" || !Number.isSafeInteger(maxBytes) || maxBytes < 1) {
     throw new Error("Media video job has an invalid request payload");
   }
-  return { provider: provider2, region, model, prompt, resolution, duration, ratio, maxBytes };
+  const normalized = normalizeMiniMaxVideoRequest({
+    region,
+    model,
+    prompt,
+    resolution,
+    duration,
+    ratio,
+    firstFrameImageUrl: value.firstFrameImageUrl
+  });
+  return { provider: provider2, ...normalized, maxBytes };
 }
 function mediaJobIdFromMaintenance(job) {
   const mediaJobId = job.payload.mediaJobId;
@@ -146035,6 +146064,7 @@ function mediaJobIdFromMaintenance(job) {
 function toVideoRequest(request) {
   return {
     prompt: request.prompt,
+    firstFrameImageUrl: request.firstFrameImageUrl,
     model: request.model,
     region: request.region,
     resolution: request.resolution,
@@ -146126,6 +146156,7 @@ function queueMiniMaxVideoGeneration(input) {
     region: normalized.region,
     model: normalized.model,
     prompt: normalized.prompt,
+    ...normalized.firstFrameImageUrl ? { firstFrameImageUrl: normalized.firstFrameImageUrl } : {},
     resolution: normalized.resolution,
     duration: normalized.duration,
     ratio: normalized.ratio,

package/docs/DEVELOPMENT.md

@@ -13,7 +13,7 @@ Memorix is a TypeScript project built around:
 
 ## Current Development Baseline
 
-The current release line is **1.9.3** and package metadata is kept synchronized
+The current release line is **1.9.4** and package metadata is kept synchronized
 with the root package and MCP Registry manifest.
 
 Contributors should assume the following areas are part of the current release line:

package/docs/README.md

@@ -125,7 +125,7 @@ Historical/deep-reference documents may describe older designs. If they conflict
 
 ## Current Product Line
 
-The current product line is **1.9.3**. Multi-device store sync is opt-in and
+The current product line is **1.9.4**. Multi-device store sync is opt-in and
 keeps local SQLite canonical; existing users do not upload anything until they
 configure a relay provider explicitly.
 The authoritative acceptance contract for the current implementation is

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "memorix",
   "mcpName": "io.github.AVIDS2/memorix",
-  "version": "1.9.3",
+  "version": "1.9.4",
   "description": "Local-first shared memory layer for AI coding agents across MCP clients, Git history, reasoning context, and project sessions.",
   "type": "module",
   "sideEffects": false,

package/plugins/antigravity/memorix/plugin.json

@@ -1,4 +1,4 @@
 {
   "name": "memorix",
-  "version": "1.9.3"
+  "version": "1.9.4"
 }

package/plugins/claude/memorix/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "memorix",
-  "version": "1.9.3",
+  "version": "1.9.4",
   "description": "Shared workspace memory for Claude Code and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.9.3",
+  "version": "1.9.4",
   "description": "Local-first project memory for CodeBuddy Code and other coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/codex/memorix/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.9.3",
+  "version": "1.9.4",
   "description": "Shared workspace memory for Codex and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/copilot/memorix/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.9.3",
+  "version": "1.9.4",
   "description": "Shared local workspace memory for GitHub Copilot CLI and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/gemini/memorix/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.9.3",
+  "version": "1.9.4",
   "mcpServers": {
     "memorix": {
       "command": "memorix",

package/plugins/hermes/memorix/plugin.yaml

@@ -1,5 +1,5 @@
 name: memorix
-version: "1.9.3"
+version: "1.9.4"
 description: Shared workspace memory bridge for Hermes Agent.
 author: AVIDS2
 license: Apache-2.0

package/plugins/omp/memorix/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix-omp-package",
-  "version": "1.9.3",
+  "version": "1.9.4",
   "description": "Memorix shared workspace memory package for Oh-my-Pi.",
   "license": "Apache-2.0",
   "keywords": [

package/plugins/openclaw/memorix/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.9.3",
+  "version": "1.9.4",
   "description": "Shared workspace memory for OpenClaw and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

package/plugins/pi/memorix/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix-pi-package",
-  "version": "1.9.3",
+  "version": "1.9.4",
   "description": "Memorix shared workspace memory package for Pi coding agent.",
   "license": "Apache-2.0",
   "keywords": [

package/server.json

@@ -7,7 +7,7 @@
     "url": "https://github.com/AVIDS2/memorix",
     "source": "github"
   },
-  "version": "1.9.3",
+  "version": "1.9.4",
   "websiteUrl": "https://mem.rglens.com",
   "icons": [
     {
@@ -22,7 +22,7 @@
     {
       "registryType": "npm",
       "identifier": "memorix",
-      "version": "1.9.3",
+      "version": "1.9.4",
       "runtimeHint": "npx",
       "packageArguments": [
         {

package/src/cli/commands/media.ts

@@ -146,6 +146,7 @@ export default defineCommand({
     concepts: { type: 'string', description: 'Comma-separated concepts when attaching' },
     visibility: { type: 'string', description: 'Observation visibility when attaching' },
     prompt: { type: 'string', description: 'Generation prompt' },
+    'first-frame-image-url': { type: 'string', description: 'Public HTTPS first-frame image URL for MiniMax video generation; stored with the queued job' },
     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' },
@@ -201,6 +202,7 @@ export default defineCommand({
               dataDir,
               projectId: project.id,
               prompt,
+              firstFrameImageUrl: args['first-frame-image-url'] as string | undefined,
               model: parseMiniMaxVideoModel(args.model),
               region: parseMiniMaxRegion(args.region),
               duration: parseMiniMaxVideoDuration(args.duration),

package/src/media/minimax.ts

@@ -47,6 +47,7 @@ export interface GeneratedMiniMaxImages {
 
 export interface MiniMaxVideoGenerationRequest {
   prompt: string;
+  firstFrameImageUrl?: string;
   model?: MiniMaxVideoModel;
   region?: MiniMaxRegion;
   apiKey?: string;
@@ -162,6 +163,7 @@ export function normalizeMiniMaxVideoRequest(input: MiniMaxVideoGenerationReques
   region: MiniMaxRegion;
   model: MiniMaxVideoModel;
   prompt: string;
+  firstFrameImageUrl?: string;
   resolution: MiniMaxVideoResolution;
   duration: 5 | 10;
   ratio: MiniMaxVideoRatio;
@@ -178,7 +180,21 @@ export function normalizeMiniMaxVideoRequest(input: MiniMaxVideoGenerationReques
   if (ratio !== 'adaptive' && ratio !== '16:9' && ratio !== '9:16' && ratio !== '1:1') {
     throw new Error('MiniMax video ratio must be adaptive, 16:9, 9:16, or 1:1');
   }
-  return { region, model, prompt, resolution, duration, ratio };
+  let firstFrameImageUrl: string | undefined;
+  if (input.firstFrameImageUrl !== undefined) {
+    firstFrameImageUrl = input.firstFrameImageUrl.trim();
+    let parsed: URL;
+    try {
+      parsed = new URL(firstFrameImageUrl);
+    } catch {
+      throw new Error('MiniMax first-frame image must be a public HTTPS URL');
+    }
+    if (parsed.protocol !== 'https:' || parsed.username || parsed.password
+      || sanitizeCredentials(firstFrameImageUrl) !== firstFrameImageUrl) {
+      throw new Error('MiniMax first-frame image must be an HTTPS URL without credentials');
+    }
+  }
+  return { region, model, prompt, resolution, duration, ratio, ...(firstFrameImageUrl ? { firstFrameImageUrl } : {}) };
 }
 
 function videoRequestConfig(input: MiniMaxVideoGenerationRequest): {
@@ -187,6 +203,7 @@ function videoRequestConfig(input: MiniMaxVideoGenerationRequest): {
   baseUrl: string;
   model: MiniMaxVideoModel;
   prompt: string;
+  firstFrameImageUrl?: string;
   resolution: MiniMaxVideoResolution;
   duration: 5 | 10;
   ratio: MiniMaxVideoRatio;
@@ -284,7 +301,14 @@ export async function createMiniMaxVideoTask(
       headers: videoHeaders(config.apiKey),
       body: JSON.stringify({
         model: config.model,
-        content: [{ type: 'text', text: config.prompt }],
+        content: [
+          { type: 'text', text: config.prompt },
+          ...(config.firstFrameImageUrl ? [{
+            type: 'image_url',
+            image_url: { url: config.firstFrameImageUrl },
+            role: 'first_frame',
+          }] : []),
+        ],
         resolution: config.resolution,
         duration: config.duration,
         ratio: config.ratio,

package/src/media/video-jobs.ts

@@ -32,6 +32,7 @@ interface StoredMiniMaxVideoRequest {
   region: 'global' | 'cn';
   model: 'MiniMax-H3';
   prompt: string;
+  firstFrameImageUrl?: string;
   resolution: '2K';
   duration: 5 | 10;
   ratio: 'adaptive' | '16:9' | '9:16' | '1:1';
@@ -93,13 +94,18 @@ function parseStoredRequest(value: Record<string, unknown>): StoredMiniMaxVideoR
     || (region !== 'global' && region !== 'cn')
     || model !== 'MiniMax-H3'
     || typeof prompt !== 'string'
+    || (value.firstFrameImageUrl !== undefined && typeof value.firstFrameImageUrl !== 'string')
     || resolution !== '2K'
     || (duration !== 5 && duration !== 10)
     || (ratio !== 'adaptive' && ratio !== '16:9' && ratio !== '9:16' && ratio !== '1:1')
     || typeof maxBytes !== 'number' || !Number.isSafeInteger(maxBytes) || maxBytes < 1) {
     throw new Error('Media video job has an invalid request payload');
   }
-  return { provider, region, model, prompt, resolution, duration, ratio, maxBytes };
+  const normalized = normalizeMiniMaxVideoRequest({
+    region, model, prompt, resolution, duration, ratio,
+    firstFrameImageUrl: value.firstFrameImageUrl as string | undefined,
+  });
+  return { provider, ...normalized, maxBytes };
 }
 
 function mediaJobIdFromMaintenance(job: MaintenanceJob): string {
@@ -113,6 +119,7 @@ function mediaJobIdFromMaintenance(job: MaintenanceJob): string {
 function toVideoRequest(request: StoredMiniMaxVideoRequest): MiniMaxVideoGenerationRequest {
   return {
     prompt: request.prompt,
+    firstFrameImageUrl: request.firstFrameImageUrl,
     model: request.model,
     region: request.region,
     resolution: request.resolution,
@@ -233,6 +240,7 @@ export function queueMiniMaxVideoGeneration(input: QueueMiniMaxVideoInput): Queu
     region: normalized.region,
     model: normalized.model,
     prompt: normalized.prompt,
+    ...(normalized.firstFrameImageUrl ? { firstFrameImageUrl: normalized.firstFrameImageUrl } : {}),
     resolution: normalized.resolution,
     duration: normalized.duration,
     ratio: normalized.ratio,

package/src/server.ts

@@ -5208,6 +5208,7 @@ export async function createMemorixServer(
         } : {}),
         ...(mediaGenerationEnabled ? {
           image: z.string().optional().describe('Base64-encoded reference image for image-to-image generation.'),
+          firstFrameImageUrl: z.string().optional().describe('Public HTTPS first-frame image URL for MiniMax video generation; stored with the queued job.'),
           region: z.enum(['global', 'cn']).optional().describe('MiniMax deployment region.'),
           n: z.number().int().min(1).max(4).optional().describe('Image output count.'),
           ratio: z.enum(['adaptive', '1:1', '16:9', '4:3', '3:2', '2:3', '3:4', '9:16', '21:9']).optional().describe('Image or video aspect ratio.'),
@@ -5217,7 +5218,7 @@ export async function createMemorixServer(
         } : {}),
       },
     },
-    async ({ action, path: assetPath, assetId, jobId, kind, limit, title, narrative, prompt, image, model, provider, language, region, n, ratio, width, height, duration, maxPages, maxChars, attach }) => {
+    async ({ action, path: assetPath, assetId, jobId, kind, limit, title, narrative, prompt, image, firstFrameImageUrl, model, provider, language, region, n, ratio, width, height, duration, maxPages, maxChars, attach }) => {
       const unresolved = requireResolvedProject('manage controlled media');
       if (unresolved) return unresolved;
       const safeError = (error: unknown) => sanitizeCredentials(
@@ -5402,6 +5403,7 @@ export async function createMemorixServer(
             dataDir: projectDir,
             projectId: project.id,
             prompt,
+            firstFrameImageUrl,
             ...(model === 'MiniMax-H3' ? { model } : {}),
             ...(region ? { region } : {}),
             ...(videoRatio ? { ratio: videoRatio } : {}),