memento-mcp 0.3.10 → 0.3.12

package/CHANGELOG.md

@@ -15,6 +15,9 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Version
 ### Changed
 - `source:distill` tag renamed to `source:distill:llama-3.1-8b` to encode model provenance. The `claude-code` path tags memories `source:distill:claude-code`.
 
+### Removed
+- **Passive memory extraction (auto_extract)** — removed conversation buffer, auto-extraction from `/v1/context`, and buffer fallback from `/v1/extract`. Smart models know when to store via `memento_store`; passive extraction produced noisy, low-signal memories. The `memento_extract` tool and `/v1/extract` route still work with explicit transcripts. The `conversation_buffer` table is no longer created for new workspaces.
+
 ---
 
 ## [0.2.3] - 2026-02-24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memento-mcp",
-  "version": "0.3.10",
+  "version": "0.3.12",
   "mcpName": "io.github.myrakrusemark/memento-protocol",
   "description": "The Memento Protocol — persistent memory for AI agents",
   "type": "module",

package/scripts/memento-precompact-distill.sh

@@ -73,7 +73,7 @@ if [ -f "$SCRIPT_DIR/../.env" ]; then
 fi
 
 MEMENTO_API="${MEMENTO_API_URL:-https://memento-api.myrakrusemark.workers.dev}"
-MEMENTO_KEY="${MEMENTO_API_KEY:?MEMENTO_API_KEY not set — check memento-protocol/.env or .memento.json}"
+MEMENTO_KEY="${MEMENTO_API_KEY:?MEMENTO_API_KEY not set — check memento-mcp/.env or .memento.json}"
 MEMENTO_WS="${MEMENTO_WORKSPACE:-default}"
 
 # Parse transcript to readable text (use fathom's parser if available, else raw)

package/scripts/memento-sessionstart-identity.sh

@@ -69,7 +69,7 @@ if [ -f "$SCRIPT_DIR/../.env" ]; then
 fi
 
 MEMENTO_API="${MEMENTO_API_URL:-https://memento-api.myrakrusemark.workers.dev}"
-MEMENTO_KEY="${MEMENTO_API_KEY:?MEMENTO_API_KEY not set — check memento-protocol/.env or .memento.json}"
+MEMENTO_KEY="${MEMENTO_API_KEY:?MEMENTO_API_KEY not set — check memento-mcp/.env or .memento.json}"
 MEMENTO_WS="${MEMENTO_WORKSPACE:-default}"
 
 AUTH_HEADER="Authorization: Bearer $MEMENTO_KEY"

package/scripts/memento-stop-recall.sh

@@ -54,7 +54,7 @@ if [ -f "$SCRIPT_DIR/../.env" ]; then
 fi
 
 MEMENTO_API="${MEMENTO_API_URL:-https://memento-api.myrakrusemark.workers.dev}"
-MEMENTO_KEY="${MEMENTO_API_KEY:?MEMENTO_API_KEY not set — check memento-protocol/.env or .memento.json}"
+MEMENTO_KEY="${MEMENTO_API_KEY:?MEMENTO_API_KEY not set — check memento-mcp/.env or .memento.json}"
 MEMENTO_WS="${MEMENTO_WORKSPACE:-default}"
 
 INPUT=$(cat)
@@ -78,13 +78,13 @@ QUERY="${ASSISTANT_MSG:0:500}"
 # Toast: start retrieving
 "$TOAST" memento "⏳ Autonomous recall..." &>/dev/null
 
-# Call Memento /v1/context (with auto_extract for passive memory formation)
+# Call Memento /v1/context
 RESULT=$(curl -s --max-time 8 \
     -X POST \
     -H "Authorization: Bearer $MEMENTO_KEY" \
     -H "X-Memento-Workspace: $MEMENTO_WS" \
     -H "Content-Type: application/json" \
-    -d "{\"message\": $(echo "$QUERY" | python3 -c 'import json,sys; print(json.dumps(sys.stdin.read()))'), \"include\": [\"memories\", \"skip_list\"], \"auto_extract\": true, \"extract_role\": \"assistant\", \"extract_content\": $(echo "$ASSISTANT_MSG" | python3 -c 'import json,sys; print(json.dumps(sys.stdin.read()))')}" \
+    -d "{\"message\": $(echo "$QUERY" | python3 -c 'import json,sys; print(json.dumps(sys.stdin.read()))'), \"include\": [\"memories\", \"skip_list\"]}" \
     "$MEMENTO_API/v1/context" 2>/dev/null \
 | python3 -c "
 import json, sys
@@ -96,8 +96,8 @@ try:
 
     memories = data.get('memories', {}).get('matches', [])
     if memories:
-        for m in memories[:${RECALL_LIMIT:-5}]:
-            content = m['content'][:${RECALL_MAX_LENGTH:-120}]
+        for m in memories[:${RECALL_LIMIT:-7}]:
+            content = m['content']
             t = abbrev.get(m['type'], m['type'])
             lines.append(f'  🔹 {content} [{m[\"id\"]} {t}]')
             count += 1
@@ -107,55 +107,35 @@ try:
         for s in skip_matches:
             lines.append(f'  Skip: {s[\"item\"]} — {s[\"reason\"]} (expires {s[\"expires\"]})')
 
-    extracted = data.get('extracted', [])
-    if extracted:
-        lines.append(f'  Stored: {len(extracted)} new memories')
-
-    # Output: recall_count \t extracted_count \t detail
-    extracted_count = len(extracted)
     detail = '\n'.join(lines)
-    print(f'{count}\t{extracted_count}\t{detail}')
+    print(f'{count}\t{detail}')
 except Exception:
-    print('0\t0\t')
+    print('0\t')
 " 2>/dev/null)
 
-# Parse count, extracted count, and detail
+# Parse count and detail
 SAAS_COUNT=$(echo "$RESULT" | head -1 | cut -f1)
-EXTRACTED_COUNT=$(echo "$RESULT" | head -1 | cut -f2)
-SAAS_DETAIL=$(echo "$RESULT" | head -1 | cut -f3-)
+SAAS_DETAIL=$(echo "$RESULT" | head -1 | cut -f2-)
 REMAINING=$(echo "$RESULT" | tail -n +2)
 if [ -n "$REMAINING" ]; then
     SAAS_DETAIL="$SAAS_DETAIL"$'\n'"$REMAINING"
 fi
 
 if [ -z "$SAAS_COUNT" ] || [ "$SAAS_COUNT" = "0" ]; then
-    if [ -n "$EXTRACTED_COUNT" ] && [ "$EXTRACTED_COUNT" != "0" ]; then
-        "$TOAST" memento "✓ ${EXTRACTED_COUNT} memories stored" &>/dev/null
-    else
-        "$TOAST" memento "✓ No memories matched" &>/dev/null
-    fi
+    "$TOAST" memento "✓ No memories matched" &>/dev/null
     exit 0
 fi
 
-if [ "$SAAS_COUNT" != "0" ]; then
-    if [ -n "$EXTRACTED_COUNT" ] && [ "$EXTRACTED_COUNT" != "0" ]; then
-        "$TOAST" memento "✓ ${SAAS_COUNT} recalled, ${EXTRACTED_COUNT} stored" &>/dev/null
-    else
-        "$TOAST" memento "✓ ${SAAS_COUNT} memories recalled" &>/dev/null
-    fi
-fi
+"$TOAST" memento "✓ ${SAAS_COUNT} memories recalled" &>/dev/null
 
 # Build summary line
-SUMMARY="Recall (${SAAS_COUNT})"
-if [ -n "$EXTRACTED_COUNT" ] && [ "$EXTRACTED_COUNT" != "0" ]; then
-    SUMMARY="Recall (${SAAS_COUNT}), stored ${EXTRACTED_COUNT}"
-fi
+SUMMARY="Memento Recall (${SAAS_COUNT})"
 
 # Block the Stop so recalled memories are injected into context.
 # If no memories are relevant, respond with <...> to signal active silence.
 REASON="${SUMMARY}:
 ${SAAS_DETAIL}
-Stale or wrong? Update or consolidate. Otherwise <...>."
+Stale or wrong? memento_memory_delete · memento_consolidate · memento_store. Otherwise <...>."
 
 python3 -c "
 import json, sys

package/scripts/memento-userprompt-recall.sh

@@ -43,7 +43,7 @@ print('true' if hook.get('enabled', True) else 'false')
     MEMENTO_WORKSPACE="${MEMENTO_WORKSPACE:-$(echo "$CONFIG_JSON" | python3 -c "import json,sys; print(json.load(sys.stdin).get('workspace',''))" 2>/dev/null)}"
 
     RECALL_LIMIT=$(echo "$CONFIG_JSON" | python3 -c "import json,sys; print(json.load(sys.stdin).get('hooks',{}).get('$HOOK_NAME',{}).get('limit',5))" 2>/dev/null)
-    RECALL_MAX_LENGTH=$(echo "$CONFIG_JSON" | python3 -c "import json,sys; print(json.load(sys.stdin).get('hooks',{}).get('$HOOK_NAME',{}).get('maxLength',200))" 2>/dev/null)
+    RECALL_MAX_LENGTH=$(echo "$CONFIG_JSON" | python3 -c "import json,sys; print(json.load(sys.stdin).get('hooks',{}).get('$HOOK_NAME',{}).get('maxLength',120))" 2>/dev/null)
 fi
 # --- End config block ---
 
@@ -55,7 +55,7 @@ if [ -f "$SCRIPT_DIR/../.env" ]; then
 fi
 
 MEMENTO_API="${MEMENTO_API_URL:-https://memento-api.myrakrusemark.workers.dev}"
-MEMENTO_KEY="${MEMENTO_API_KEY:?MEMENTO_API_KEY not set — check memento-protocol/.env or .memento.json}"
+MEMENTO_KEY="${MEMENTO_API_KEY:?MEMENTO_API_KEY not set — check memento-mcp/.env or .memento.json}"
 MEMENTO_WS="${MEMENTO_WORKSPACE:-default}"
 
 INPUT=$(cat)
@@ -70,13 +70,13 @@ QUERY="${USER_MESSAGE:0:500}"
 # Toast: start retrieving
 "$TOAST" memento "⏳ Retrieving memories..." &>/dev/null
 
-# Call Memento SaaS /v1/context (with auto_extract for passive memory formation)
+# Call Memento SaaS /v1/context
 SAAS_OUTPUT=$(curl -s --max-time 8 \
     -X POST \
     -H "Authorization: Bearer $MEMENTO_KEY" \
     -H "X-Memento-Workspace: $MEMENTO_WS" \
     -H "Content-Type: application/json" \
-    -d "{\"message\": $(echo "$QUERY" | python3 -c 'import json,sys; print(json.dumps(sys.stdin.read()))'), \"include\": [\"memories\", \"skip_list\"], \"auto_extract\": true, \"extract_role\": \"user\", \"extract_content\": $(echo "$USER_MESSAGE" | python3 -c 'import json,sys; print(json.dumps(sys.stdin.read()))')}" \
+    -d "{\"message\": $(echo "$QUERY" | python3 -c 'import json,sys; print(json.dumps(sys.stdin.read()))'), \"include\": [\"memories\", \"skip_list\"]}" \
     "$MEMENTO_API/v1/context" 2>/dev/null \
 | python3 -c "
 import json, sys
@@ -84,75 +84,44 @@ try:
     data = json.load(sys.stdin)
     lines = []
     count = 0
+    abbrev = {'instruction':'instr','observation':'obs','decision':'dec','preference':'pref'}
 
-    # Memory matches
     memories = data.get('memories', {}).get('matches', [])
     if memories:
-        for m in memories[:${RECALL_LIMIT:-5}]:
-            tags = m.get('tags', [])
-            tag_str = f' [{\", \".join(tags)}]' if tags else ''
-            content = m['content'][:${RECALL_MAX_LENGTH:-200}]
-            score = m.get('score', '?')
-            date_str = f' {m[\"created_at\"][:10]}' if m.get('created_at') else ''
-            lines.append(f'  {m[\"id\"]} ({m[\"type\"]}, {score}{date_str}){tag_str} — {content}')
+        for m in memories[:${RECALL_LIMIT:-7}]:
+            content = m['content']
+            t = abbrev.get(m['type'], m['type'])
+            lines.append(f'  🔹 {content} [{m[\"id\"]} {t}]')
             count += 1
 
-    # Skip matches (WARNING format)
     skip_matches = data.get('skip_matches', [])
     if skip_matches:
-        lines.append('')
-        lines.append('SKIP LIST WARNINGS:')
         for s in skip_matches:
-            lines.append(f'  ⚠ SKIP: {s[\"item\"]} — {s[\"reason\"]} (expires: {s[\"expires\"]})')
-
-    # Auto-extracted memories
-    extracted = data.get('extracted', [])
-    if extracted:
-        lines.append('')
-        lines.append('MEMORIES STORED:')
-        for e in extracted:
-            etags = [t for t in e.get('tags', []) if t != 'source:auto-extract']
-            etag_str = f' [{\", \".join(etags)}]' if etags else ''
-            lines.append(f'  {e[\"id\"]} ({e.get(\"type\", \"observation\")}){etag_str} — {e[\"content\"]}')
-
-    # Output: recall_count \t extracted_count \t detail
-    extracted_count = len(extracted)
+            lines.append(f'  Skip: {s[\"item\"]} — {s[\"reason\"]} (expires {s[\"expires\"]})')
+
     detail = '\n'.join(lines)
-    print(f'{count}\t{extracted_count}\t{detail}')
+    print(f'{count}\t{detail}')
 except Exception:
-    print('0\t0\t')
+    print('0\t')
 " 2>/dev/null)
 
-# Parse count, extracted count, and detail
+# Parse count and detail
 SAAS_COUNT=$(echo "$SAAS_OUTPUT" | head -1 | cut -f1)
-EXTRACTED_COUNT=$(echo "$SAAS_OUTPUT" | head -1 | cut -f2)
-SAAS_DETAIL=$(echo "$SAAS_OUTPUT" | head -1 | cut -f3-)
-# Append any remaining lines (skip warnings etc.)
+SAAS_DETAIL=$(echo "$SAAS_OUTPUT" | head -1 | cut -f2-)
 REMAINING=$(echo "$SAAS_OUTPUT" | tail -n +2)
 if [ -n "$REMAINING" ]; then
     SAAS_DETAIL="$SAAS_DETAIL"$'\n'"$REMAINING"
 fi
 
 if [ -z "$SAAS_COUNT" ] || [ "$SAAS_COUNT" = "0" ]; then
-    if [ -n "$EXTRACTED_COUNT" ] && [ "$EXTRACTED_COUNT" != "0" ]; then
-        "$TOAST" memento "✓ ${EXTRACTED_COUNT} memories stored" &>/dev/null
-    else
-        "$TOAST" memento "✓ No memories matched" &>/dev/null
-        exit 0
-    fi
-else
-    if [ -n "$EXTRACTED_COUNT" ] && [ "$EXTRACTED_COUNT" != "0" ]; then
-        "$TOAST" memento "✓ ${SAAS_COUNT} recalled, ${EXTRACTED_COUNT} stored" &>/dev/null
-    else
-        "$TOAST" memento "✓ ${SAAS_COUNT} memories recalled" &>/dev/null
-    fi
+    "$TOAST" memento "✓ No memories matched" &>/dev/null
+    exit 0
 fi
 
+"$TOAST" memento "✓ ${SAAS_COUNT} memories recalled" &>/dev/null
+
 # Build summary line
-SUMMARY="Memento Recall: ${SAAS_COUNT} memories"
-if [ -n "$EXTRACTED_COUNT" ] && [ "$EXTRACTED_COUNT" != "0" ]; then
-    SUMMARY="${SUMMARY}, ${EXTRACTED_COUNT} memories stored"
-fi
+SUMMARY="Memento Recall (${SAAS_COUNT})"
 
 DETAIL_TEXT="$SUMMARY"
 DETAIL_TEXT="$DETAIL_TEXT"$'\n'"$SAAS_DETAIL"

package/src/index.js

@@ -439,25 +439,23 @@ This is reconsolidation — like how the brain rebuilds memories on recall. Freq
 
 server.tool(
   "memento_extract",
-  `Extract memories from a conversation transcript or the conversation buffer using LLM. Use this to manually trigger memory extraction — e.g., to flush the buffer before ending a session, or to extract from a pasted transcript.
+  `Extract memories from a conversation transcript using LLM. Use this to extract memories from a pasted transcript.
 
 Two modes:
 - "distill" (default): Full extraction — facts, decisions, instructions, observations. Up to 20 memories.
 - "seeds": Relational/experiential texture — preferences, emotions, sensory details. Up to 3 memories.
 
-If no transcript is provided, reads from the conversation buffer (auto-populated by the context hook). Buffer is cleared after extraction unless keep_buffer is true.`,
+A transcript is required.`,
   {
-    transcript: z.string().optional().describe("Raw conversation text. If omitted, reads from the conversation buffer."),
+    transcript: z.string().describe("Raw conversation text to extract memories from."),
     mode: z.enum(["distill", "seeds"]).optional().describe("Extraction mode (default: distill)"),
     max_memories: z.number().optional().describe("Override max memories to extract"),
-    keep_buffer: z.boolean().optional().describe("If true, don't clear the buffer after reading it"),
   },
-  async ({ transcript, mode, max_memories, keep_buffer }) => {
+  async ({ transcript, mode, max_memories }) => {
     const result = await storage.extractMemories(null, {
       transcript,
       mode,
       max_memories,
-      keep_buffer,
     });
 
     if (result.error && !result.stored) {

package/src/storage/hosted.js

@@ -261,13 +261,12 @@ export class HostedStorageAdapter extends StorageInterface {
     return res;
   }
 
-  async extractMemories(_wsPath, { transcript, mode, max_memories, source_tag, keep_buffer }) {
+  async extractMemories(_wsPath, { transcript, mode, max_memories, source_tag }) {
     const body = {};
     if (transcript) body.transcript = transcript;
     if (mode) body.mode = mode;
     if (max_memories) body.max_memories = max_memories;
     if (source_tag) body.source_tag = source_tag;
-    if (keep_buffer !== undefined) body.keep_buffer = keep_buffer;
 
     const res = await this._fetchJson("POST", "/v1/extract", body);
     if (res.error && !res.stored) return { error: res.error };