frinus-mcp 3.6.0 → 3.6.1

package/dist/index.js

@@ -64,7 +64,7 @@ async function main() {
     }
     const server = new Server({
         name: "frinus",
-        version: "3.6.0",
+        version: "3.6.1",
     }, {
         capabilities: {
             tools: {},

package/dist/tools/definitions.js

@@ -39,7 +39,19 @@ Scopes:
                 },
                 content: {
                     type: "string",
-                    description: "The memory content to store",
+                    // MIRRORS memory/src/config.py::MAX_MEMORY_CONTENT_CHARS, which is the
+                    // single source of truth and where the derivation is documented.
+                    // This is a cross-language copy — if the backend constant changes,
+                    // change it here too (and in the description below). The live value
+                    // is also served at GET / as limits.memory_content_max_chars.
+                    maxLength: 16000,
+                    description: "The memory content to store. HARD LIMIT: 16000 characters — " +
+                        "content above this is REJECTED (HTTP 422), nothing is saved. " +
+                        "Check the length before calling. If your text is longer, split " +
+                        "it into several smaller, self-contained memories (one fact, " +
+                        "decision or procedure each) and store them one by one; do not " +
+                        "truncate it into a single call. Smaller memories are also " +
+                        "retrieved more accurately by semantic search.",
                 },
                 memory_type: {
                     type: "string",

package/dist/tools/handlers.js

@@ -194,6 +194,30 @@ export function handleApiError(error) {
             isError: true,
         };
     }
+    if (status === 422) {
+        // Request validation failure. The backend's `detail` carries the ONLY
+        // actionable part (e.g. the memory-content size limit: what the ceiling
+        // is, what was received, and to split the text into smaller memories).
+        // Without this branch the raw axios error propagates as the useless
+        // "Request failed with status code 422" and that guidance never reaches
+        // the caller — which is the whole point of returning it.
+        const detail = error?.response?.data?.detail;
+        const text = Array.isArray(detail)
+            ? detail
+                .map((d) => {
+                const field = Array.isArray(d?.loc) ? d.loc.filter((p) => p !== "body").join(".") : null;
+                const msg = String(d?.msg ?? "invalid value").replace(/^Value error,\s*/, "");
+                return field ? `${field}: ${msg}` : msg;
+            })
+                .join("\n")
+            : typeof detail === "string"
+                ? detail
+                : "The request was rejected as invalid.";
+        return {
+            content: [{ type: "text", text: `Validation error (422). Nothing was saved.\n${text}` }],
+            isError: true,
+        };
+    }
     return null; // Not a known error, let it propagate
 }
 // ---------------------------------------------------------------------------

package/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.3",
   "name": "frinus",
   "display_name": "Frinus — Memória Cognitiva",
-  "version": "3.6.0",
+  "version": "3.6.1",
   "description": "Memória cognitiva de longo prazo para o Claude (φρήν + νοῦς). 83 ferramentas de memória, sessões, agentes e conhecimento.",
   "long_description": "O Frinus dá ao Claude memória de longo prazo, identidade e inteligência persistente entre conversas. Conecta o Claude Desktop à plataforma Frinus (Memory Engine, Control Plane e Agent Service) via MCP. Basta colar sua chave de API pessoal — nada para instalar ou compilar.",
   "author": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frinus-mcp",
-  "version": "3.6.0",
+  "version": "3.6.1",
   "description": "Frinus - MCP Server for Cognitive Memory (φρήν + νοῦς). Long-term memory, sessions, agents and knowledge for Claude and any MCP client.",
   "type": "module",
   "main": "dist/index.js",