memorix 1.3.4 → 1.4.1

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.4.1] - 2026-08-03
+
+### Added
+- **MiniMax M3 video input** -- The bundled `@memorix/ai` provider layer now advertises and routes MiniMax M3 video content through MiniMax's Anthropic-compatible API. Base64 video is covered by focused request-shape tests, and image-only models still receive a clear text fallback instead of an invalid video block. Contributed by [@octo-patch](https://github.com/octo-patch) in #153.
+
+### Changed
+- **Maintained product roadmap** -- Replaced the stale version-by-version roadmap with current product boundaries, operating constraints, and public directions. Release facts now live in this changelog and active maintainer work lives in `ACTIVE_WORK.md`. Contributed by [@FBISiri](https://github.com/FBISiri) in #140.
+
+### Fixed
+- **Deterministic provider tests** -- `@memorix/ai` unit tests no longer discover local API keys or Pi OAuth credentials and unexpectedly call paid, changing provider endpoints. Routine tests are offline by default; deliberate live validation requires `MEMORIX_AI_LIVE_TESTS=1` plus the required credentials.
+- **Stable model metadata assertion** -- Removed a test-only assumption that OpenRouter will permanently list `moonshotai/kimi-k2.6:free`; the bundled catalog snapshot no longer contains that route, while coverage remains for the supported Kimi K2.6 compatibility metadata.
+
+## [1.4.0] - 2026-08-02
+
+### Changed
+- **Stable multimodal release** -- Promoted the controlled media lifecycle, explicit MiniMax image/video generation, and honest multimodal embedding foundation introduced in 1.3.3 to the stable line after the 1.3.4 Windows, MCP binding, cancellation, cleanup, configuration-migration, and fresh-package hardening work.
+
+### Verified
+- **Release evidence** -- Full local regression, fresh npm-package MCP smoke, GitHub Actions on Windows and Ubuntu, Docker control-plane startup, native SQLite compatibility, npm provenance publication, and official MCP Registry publication all passed before this release.
+- **Release boundary** -- “Stable” means no known release blocker after those gates. It does not claim that any software is mathematically free of future defects.
+
 ## [1.3.4] - 2026-08-02
 
 ### Fixed

package/CLAUDE.md

@@ -77,12 +77,12 @@ Use `memorix_resolve` when a task is done or a bug is fixed. This keeps future s
 | `memorix_rules_sync` | Inspect or sync rules across agents |
 | `memorix_workspace_sync` | Inspect or migrate workspace integrations |
 
-## Dev Log
-
-- **Repository-wide current state**: `docs/dev-log/progress.txt`
-- Read that root progress file after the Memory Autopilot step for long-running
-  release/development work.
-- Package-specific historical notes may live under subdirectories such as
-  `docs/memcode/dev-log/`; treat them as historical unless the current task is
-  explicitly about that package.
-- Update the root progress file when completing substantial cross-session work.
+## Active Work
+
+- **Repository-wide current state**: `ACTIVE_WORK.md`
+- Read that file after the Memory Autopilot step for long-running release or
+  development work.
+- It is the only living work-status document. Update it after material
+  cross-session work; do not create parallel progress or dev-log files.
+- It must stay public-safe: no local absolute paths, account identifiers,
+  credentials, raw chat transcripts, or local tool state.

package/README.md

@@ -18,9 +18,9 @@
 </p>
 
 <p align="center">
-  <a href="https://registry.modelcontextprotocol.io/v0/servers?search=io.github.AVIDS2%2Fmemorix">Listed in the official MCP Registry</a>
+  <a href="https://registry.modelcontextprotocol.io/?q=io.github.AVIDS2%2Fmemorix">Listed in the official MCP Registry</a>
   <br>
-  <img src="https://mcptoplist.com/badge/io.github.AVIDS2%2Fmemorix.svg" alt="MCP Toplist ranking">
+  <a href="https://mcptoplist.com/server/io.github.AVIDS2%2Fmemorix"><img src="https://mcptoplist.com/badge/io.github.AVIDS2%2Fmemorix.svg" alt="View Memorix on MCP Toplist"></a>
 </p>
 
 <p align="center">
@@ -35,11 +35,16 @@
   <a href="#quick-start">Quick Start</a> |
   <a href="#memory-model">Memory Model</a> |
   <a href="#memcode-bundled-terminal-agent">memcode</a> |
+  <a href="ACTIVE_WORK.md">Active Work</a> |
   <a href="#docs">Docs</a>
 </p>
 
 ---
 
+> Maintainer status and the current public work boundary live in
+> [ACTIVE_WORK.md](ACTIVE_WORK.md). It is the repository's single living work
+> tracker.
+
 <h2 id="what-memorix-is"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/section-overview.svg"><img src="assets/tags/section-overview.svg" alt="Memorix" height="32" /></picture></h2>
 
 Memorix gives the AI coding agents you already use a shared, searchable project memory that survives new chats, IDE switches, terminal sessions, and handoffs. The memory lives under the Git project, not inside one chat window or one tool.

package/README.zh-CN.md

@@ -18,9 +18,9 @@
 </p>
 
 <p align="center">
-  <a href="https://registry.modelcontextprotocol.io/v0/servers?search=io.github.AVIDS2%2Fmemorix">已收录至官方 MCP Registry</a>
+  <a href="https://registry.modelcontextprotocol.io/?q=io.github.AVIDS2%2Fmemorix">已收录至官方 MCP Registry</a>
   <br>
-  <img src="https://mcptoplist.com/badge/io.github.AVIDS2%2Fmemorix.svg" alt="MCP Toplist ranking">
+  <a href="https://mcptoplist.com/server/io.github.AVIDS2%2Fmemorix"><img src="https://mcptoplist.com/badge/io.github.AVIDS2%2Fmemorix.svg" alt="在 MCP Toplist 查看 Memorix"></a>
 </p>
 
 <p align="center">
@@ -35,11 +35,15 @@
   <a href="#快速开始">快速开始</a> |
   <a href="#记忆模型">记忆模型</a> |
   <a href="#memcode内置终端-agent">memcode</a> |
+  <a href="ACTIVE_WORK.md">当前工作</a> |
   <a href="#文档">文档</a>
 </p>
 
 ---
 
+> 维护者当前工作状态和公开边界统一记录在
+> [ACTIVE_WORK.md](ACTIVE_WORK.md)，这是仓库唯一的活动工作文档。
+
 <h2 id="memorix-是什么"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/section-overview.svg"><img src="assets/tags/section-overview.svg" alt="Memorix" height="32" /></picture></h2>
 
 Memorix 给你已经在用的 AI 编程 Agent 加上一套共享、可检索的项目记忆，让它跨越新对话、切换 IDE、重开终端 session 和交接都不丢失。记忆归属于 Git 项目，不会只困在某个聊天窗口或工具里。

package/dist/cli/index.js

@@ -3221,7 +3221,7 @@ ${import_picocolors.default.gray(m3)}  ${s3}
 
 // src/cli/version.ts
 function getCliVersion() {
-  return true ? "1.3.4" : pkg.version;
+  return true ? "1.4.1" : pkg.version;
 }
 var init_version = __esm({
   "src/cli/version.ts"() {
@@ -42894,7 +42894,7 @@ var init_models_generated = __esm({
           provider: "minimax",
           baseUrl: "https://api.minimax.io/anthropic",
           reasoning: true,
-          input: ["text", "image"],
+          input: ["text", "image", "video"],
           cost: {
             input: 0.3,
             output: 1.2,
@@ -42947,7 +42947,7 @@ var init_models_generated = __esm({
           provider: "minimax-cn",
           baseUrl: "https://api.minimaxi.com/anthropic",
           reasoning: true,
-          input: ["text", "image"],
+          input: ["text", "image", "video"],
           cost: {
             input: 0.3,
             output: 1.2,
@@ -62222,11 +62222,11 @@ var init_simple_options = __esm({
 });
 
 // packages/ai/dist/providers/transform-messages.js
-function replaceImagesWithPlaceholder(content, placeholder) {
+function replaceMediaWithPlaceholder(content, dropType, placeholder) {
   const result = [];
   let previousWasPlaceholder = false;
   for (const block of content) {
-    if (block.type === "image") {
+    if (block.type === dropType) {
       if (!previousWasPlaceholder) {
         result.push({ type: "text", text: placeholder });
       }
@@ -62234,33 +62234,39 @@ function replaceImagesWithPlaceholder(content, placeholder) {
       continue;
     }
     result.push(block);
-    previousWasPlaceholder = block.text === placeholder;
+    previousWasPlaceholder = block.type === "text" && block.text === placeholder;
   }
   return result;
 }
-function downgradeUnsupportedImages(messages, model) {
-  if (model.input.includes("image")) {
+function downgradeUnsupportedMedia(messages, model) {
+  const supportsImage = model.input.includes("image");
+  const supportsVideo = model.input.includes("video");
+  if (supportsImage && supportsVideo) {
     return messages;
   }
   return messages.map((msg) => {
     if (msg.role === "user" && Array.isArray(msg.content)) {
-      return {
-        ...msg,
-        content: replaceImagesWithPlaceholder(msg.content, NON_VISION_USER_IMAGE_PLACEHOLDER)
-      };
+      let content = msg.content;
+      if (!supportsImage)
+        content = replaceMediaWithPlaceholder(content, "image", NON_VISION_USER_IMAGE_PLACEHOLDER);
+      if (!supportsVideo)
+        content = replaceMediaWithPlaceholder(content, "video", NON_VISION_USER_VIDEO_PLACEHOLDER);
+      return { ...msg, content };
     }
     if (msg.role === "toolResult") {
-      return {
-        ...msg,
-        content: replaceImagesWithPlaceholder(msg.content, NON_VISION_TOOL_IMAGE_PLACEHOLDER)
-      };
+      let content = msg.content;
+      if (!supportsImage)
+        content = replaceMediaWithPlaceholder(content, "image", NON_VISION_TOOL_IMAGE_PLACEHOLDER);
+      if (!supportsVideo)
+        content = replaceMediaWithPlaceholder(content, "video", NON_VISION_TOOL_VIDEO_PLACEHOLDER);
+      return { ...msg, content };
     }
     return msg;
   });
 }
 function transformMessages(messages, model, normalizeToolCallId2) {
   const toolCallIdMap = /* @__PURE__ */ new Map();
-  const imageAwareMessages = downgradeUnsupportedImages(messages, model);
+  const imageAwareMessages = downgradeUnsupportedMedia(messages, model);
   const transformed = imageAwareMessages.map((msg) => {
     if (msg.role === "user") {
       return msg;
@@ -62372,13 +62378,15 @@ function transformMessages(messages, model, normalizeToolCallId2) {
   insertSyntheticToolResults();
   return result;
 }
-var NON_VISION_USER_IMAGE_PLACEHOLDER, NON_VISION_TOOL_IMAGE_PLACEHOLDER;
+var NON_VISION_USER_IMAGE_PLACEHOLDER, NON_VISION_TOOL_IMAGE_PLACEHOLDER, NON_VISION_USER_VIDEO_PLACEHOLDER, NON_VISION_TOOL_VIDEO_PLACEHOLDER;
 var init_transform_messages = __esm({
   "packages/ai/dist/providers/transform-messages.js"() {
     "use strict";
     init_esm_shims();
     NON_VISION_USER_IMAGE_PLACEHOLDER = "(image omitted: model does not support images)";
     NON_VISION_TOOL_IMAGE_PLACEHOLDER = "(tool image omitted: model does not support images)";
+    NON_VISION_USER_VIDEO_PLACEHOLDER = "(video omitted: model does not support video)";
+    NON_VISION_TOOL_VIDEO_PLACEHOLDER = "(tool video omitted: model does not support video)";
   }
 });
 
@@ -62409,8 +62417,8 @@ function getCacheControl(model, cacheRetention) {
   };
 }
 function convertContentBlocks(content) {
-  const hasImages = content.some((c5) => c5.type === "image");
-  if (!hasImages) {
+  const hasMedia = content.some((c5) => c5.type === "image" || c5.type === "video");
+  if (!hasMedia) {
     return sanitizeSurrogates(content.map((c5) => c5.text).join("\n"));
   }
   const blocks = content.map((block) => {
@@ -62420,6 +62428,16 @@ function convertContentBlocks(content) {
         text: sanitizeSurrogates(block.text)
       };
     }
+    if (block.type === "video") {
+      return {
+        type: "video",
+        source: {
+          type: "base64",
+          media_type: block.mimeType,
+          data: block.data
+        }
+      };
+    }
     return {
       type: "image",
       source: {
@@ -62433,7 +62451,7 @@ function convertContentBlocks(content) {
   if (!hasText) {
     blocks.unshift({
       type: "text",
-      text: "(see attached image)"
+      text: "(see attached media)"
     });
   }
   return blocks;
@@ -62783,6 +62801,15 @@ function convertMessages(messages, model, isOAuthToken2, cacheControl, allowEmpt
               type: "text",
               text: sanitizeSurrogates(item.text)
             };
+          } else if (item.type === "video") {
+            return {
+              type: "video",
+              source: {
+                type: "base64",
+                media_type: item.mimeType,
+                data: item.data
+              }
+            };
           } else {
             return {
               type: "image",
@@ -62863,6 +62890,8 @@ function convertMessages(messages, model, isOAuthToken2, cacheControl, allowEmpt
       toolResults.push({
         type: "tool_result",
         tool_use_id: msg.toolCallId,
+        // MiniMax's Anthropic-compatible API accepts video in tool results;
+        // the SDK's ToolResultBlockParam.content type predates video support.
         content: convertContentBlocks(msg.content),
         is_error: msg.isError
       });
@@ -62889,7 +62918,7 @@ function convertMessages(messages, model, isOAuthToken2, cacheControl, allowEmpt
     if (lastMessage.role === "user") {
       if (Array.isArray(lastMessage.content)) {
         const lastBlock = lastMessage.content[lastMessage.content.length - 1];
-        if (lastBlock && (lastBlock.type === "text" || lastBlock.type === "image" || lastBlock.type === "tool_result")) {
+        if (lastBlock && (lastBlock.type === "text" || lastBlock.type === "image" || lastBlock.type === "video" || lastBlock.type === "tool_result")) {
           lastBlock.cache_control = cacheControl;
         }
       } else if (typeof lastMessage.content === "string") {
@@ -189639,6 +189668,7 @@ function compareDateStrings(a3, b3) {
 }
 function detectStaleProgressNotes(input) {
   const candidates = [
+    "ACTIVE_WORK.md",
     "progress.txt",
     "docs/dev-log/progress.txt",
     "docs/memcode/dev-log/progress.txt"
@@ -213306,7 +213336,7 @@ The path should point to a directory containing a .git folder.`
   };
   const server = existingServer ?? new McpServer({
     name: "memorix",
-    version: true ? "1.3.4" : "1.0.1"
+    version: true ? "1.4.1" : "1.0.1"
   });
   const originalRegisterTool = server.registerTool.bind(server);
   server.registerTool = ((name, ...args) => {

package/dist/index.js

@@ -32930,7 +32930,7 @@ var init_models_generated = __esm({
           provider: "minimax",
           baseUrl: "https://api.minimax.io/anthropic",
           reasoning: true,
-          input: ["text", "image"],
+          input: ["text", "image", "video"],
           cost: {
             input: 0.3,
             output: 1.2,
@@ -32983,7 +32983,7 @@ var init_models_generated = __esm({
           provider: "minimax-cn",
           baseUrl: "https://api.minimaxi.com/anthropic",
           reasoning: true,
-          input: ["text", "image"],
+          input: ["text", "image", "video"],
           cost: {
             input: 0.3,
             output: 1.2,
@@ -52258,11 +52258,11 @@ var init_simple_options = __esm({
 });
 
 // packages/ai/dist/providers/transform-messages.js
-function replaceImagesWithPlaceholder(content, placeholder) {
+function replaceMediaWithPlaceholder(content, dropType, placeholder) {
   const result = [];
   let previousWasPlaceholder = false;
   for (const block of content) {
-    if (block.type === "image") {
+    if (block.type === dropType) {
       if (!previousWasPlaceholder) {
         result.push({ type: "text", text: placeholder });
       }
@@ -52270,33 +52270,39 @@ function replaceImagesWithPlaceholder(content, placeholder) {
       continue;
     }
     result.push(block);
-    previousWasPlaceholder = block.text === placeholder;
+    previousWasPlaceholder = block.type === "text" && block.text === placeholder;
   }
   return result;
 }
-function downgradeUnsupportedImages(messages, model) {
-  if (model.input.includes("image")) {
+function downgradeUnsupportedMedia(messages, model) {
+  const supportsImage = model.input.includes("image");
+  const supportsVideo = model.input.includes("video");
+  if (supportsImage && supportsVideo) {
     return messages;
   }
   return messages.map((msg) => {
     if (msg.role === "user" && Array.isArray(msg.content)) {
-      return {
-        ...msg,
-        content: replaceImagesWithPlaceholder(msg.content, NON_VISION_USER_IMAGE_PLACEHOLDER)
-      };
+      let content = msg.content;
+      if (!supportsImage)
+        content = replaceMediaWithPlaceholder(content, "image", NON_VISION_USER_IMAGE_PLACEHOLDER);
+      if (!supportsVideo)
+        content = replaceMediaWithPlaceholder(content, "video", NON_VISION_USER_VIDEO_PLACEHOLDER);
+      return { ...msg, content };
     }
     if (msg.role === "toolResult") {
-      return {
-        ...msg,
-        content: replaceImagesWithPlaceholder(msg.content, NON_VISION_TOOL_IMAGE_PLACEHOLDER)
-      };
+      let content = msg.content;
+      if (!supportsImage)
+        content = replaceMediaWithPlaceholder(content, "image", NON_VISION_TOOL_IMAGE_PLACEHOLDER);
+      if (!supportsVideo)
+        content = replaceMediaWithPlaceholder(content, "video", NON_VISION_TOOL_VIDEO_PLACEHOLDER);
+      return { ...msg, content };
     }
     return msg;
   });
 }
 function transformMessages(messages, model, normalizeToolCallId2) {
   const toolCallIdMap = /* @__PURE__ */ new Map();
-  const imageAwareMessages = downgradeUnsupportedImages(messages, model);
+  const imageAwareMessages = downgradeUnsupportedMedia(messages, model);
   const transformed = imageAwareMessages.map((msg) => {
     if (msg.role === "user") {
       return msg;
@@ -52408,13 +52414,15 @@ function transformMessages(messages, model, normalizeToolCallId2) {
   insertSyntheticToolResults();
   return result;
 }
-var NON_VISION_USER_IMAGE_PLACEHOLDER, NON_VISION_TOOL_IMAGE_PLACEHOLDER;
+var NON_VISION_USER_IMAGE_PLACEHOLDER, NON_VISION_TOOL_IMAGE_PLACEHOLDER, NON_VISION_USER_VIDEO_PLACEHOLDER, NON_VISION_TOOL_VIDEO_PLACEHOLDER;
 var init_transform_messages = __esm({
   "packages/ai/dist/providers/transform-messages.js"() {
     "use strict";
     init_esm_shims();
     NON_VISION_USER_IMAGE_PLACEHOLDER = "(image omitted: model does not support images)";
     NON_VISION_TOOL_IMAGE_PLACEHOLDER = "(tool image omitted: model does not support images)";
+    NON_VISION_USER_VIDEO_PLACEHOLDER = "(video omitted: model does not support video)";
+    NON_VISION_TOOL_VIDEO_PLACEHOLDER = "(tool video omitted: model does not support video)";
   }
 });
 
@@ -52445,8 +52453,8 @@ function getCacheControl(model, cacheRetention) {
   };
 }
 function convertContentBlocks(content) {
-  const hasImages = content.some((c) => c.type === "image");
-  if (!hasImages) {
+  const hasMedia = content.some((c) => c.type === "image" || c.type === "video");
+  if (!hasMedia) {
     return sanitizeSurrogates(content.map((c) => c.text).join("\n"));
   }
   const blocks = content.map((block) => {
@@ -52456,6 +52464,16 @@ function convertContentBlocks(content) {
         text: sanitizeSurrogates(block.text)
       };
     }
+    if (block.type === "video") {
+      return {
+        type: "video",
+        source: {
+          type: "base64",
+          media_type: block.mimeType,
+          data: block.data
+        }
+      };
+    }
     return {
       type: "image",
       source: {
@@ -52469,7 +52487,7 @@ function convertContentBlocks(content) {
   if (!hasText) {
     blocks.unshift({
       type: "text",
-      text: "(see attached image)"
+      text: "(see attached media)"
     });
   }
   return blocks;
@@ -52819,6 +52837,15 @@ function convertMessages(messages, model, isOAuthToken2, cacheControl, allowEmpt
               type: "text",
               text: sanitizeSurrogates(item.text)
             };
+          } else if (item.type === "video") {
+            return {
+              type: "video",
+              source: {
+                type: "base64",
+                media_type: item.mimeType,
+                data: item.data
+              }
+            };
           } else {
             return {
               type: "image",
@@ -52899,6 +52926,8 @@ function convertMessages(messages, model, isOAuthToken2, cacheControl, allowEmpt
       toolResults.push({
         type: "tool_result",
         tool_use_id: msg.toolCallId,
+        // MiniMax's Anthropic-compatible API accepts video in tool results;
+        // the SDK's ToolResultBlockParam.content type predates video support.
         content: convertContentBlocks(msg.content),
         is_error: msg.isError
       });
@@ -52925,7 +52954,7 @@ function convertMessages(messages, model, isOAuthToken2, cacheControl, allowEmpt
     if (lastMessage.role === "user") {
       if (Array.isArray(lastMessage.content)) {
         const lastBlock = lastMessage.content[lastMessage.content.length - 1];
-        if (lastBlock && (lastBlock.type === "text" || lastBlock.type === "image" || lastBlock.type === "tool_result")) {
+        if (lastBlock && (lastBlock.type === "text" || lastBlock.type === "image" || lastBlock.type === "video" || lastBlock.type === "tool_result")) {
           lastBlock.cache_control = cacheControl;
         }
       } else if (typeof lastMessage.content === "string") {
@@ -156516,6 +156545,7 @@ function compareDateStrings(a, b) {
 }
 function detectStaleProgressNotes(input) {
   const candidates = [
+    "ACTIVE_WORK.md",
     "progress.txt",
     "docs/dev-log/progress.txt",
     "docs/memcode/dev-log/progress.txt"
@@ -164315,7 +164345,7 @@ The path should point to a directory containing a .git folder.`
   };
   const server = existingServer ?? new McpServer({
     name: "memorix",
-    version: true ? "1.3.4" : "1.0.1"
+    version: true ? "1.4.1" : "1.0.1"
   });
   const originalRegisterTool = server.registerTool.bind(server);
   server.registerTool = ((name, ...args) => {
@@ -168580,7 +168610,7 @@ var init_serve_shared = __esm({
 
 // src/cli/version.ts
 function getCliVersion() {
-  return true ? "1.3.4" : pkg.version;
+  return true ? "1.4.1" : pkg.version;
 }
 var init_version3 = __esm({
   "src/cli/version.ts"() {