memento-mcp 0.3.14 → 0.3.16

package/CHANGELOG.md

@@ -6,6 +6,13 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Version
 
 ---
 
+## [0.3.15] - 2026-03-13
+
+### Changed
+- Renamed `memento_store` → `memento_remember` for cognitive language consistency — pairs with `memento_recall`.
+
+---
+
 ## [Unreleased]
 
 ### Added
@@ -16,7 +23,7 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Version
 - `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.
+- **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_remember`; 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.
 
 ---
 
@@ -85,7 +92,7 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Version
 
 ### Added
 - Initial release
-- MCP server with `memento_init`, `memento_read`, `memento_update`, `memento_store`, `memento_recall`, `memento_skip_add`, `memento_skip_check`, `memento_health`
+- MCP server with `memento_init`, `memento_read`, `memento_update`, `memento_remember`, `memento_recall`, `memento_skip_add`, `memento_skip_check`, `memento_health`
 - SaaS API on Cloudflare Workers + Turso edge database
 - Semantic search via `bge-small-en-v1.5` embeddings in Cloudflare Vectorize
 - Free tier: 100 memories, 20 items, 1 workspace

package/README.md

@@ -101,7 +101,7 @@ The MCP server connects at startup. Restart so it picks up the new config.
 
 ```text
 > memento_health()              # verify connection
-> memento_store(                # store your first memory
+> memento_remember(             # store your first memory
     content: "API uses /v2 endpoints. Auth is Bearer token in header.",
     type: "instruction",
     tags: ["api", "auth"]
@@ -126,7 +126,7 @@ On session start:
 3. `memento_recall` with current task context — find relevant past memories
 
 During work — actively manage your own memories:
-- `memento_store` when you learn something, make a decision, or discover a pattern
+- `memento_remember` when you learn something, make a decision, or discover a pattern
 - `memento_recall` before starting any subtask — someone may have already figured it out
 - `memento_item_update` as you make progress — don't wait until the end
 - `memento_item_create` when new work emerges

package/package.json

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

package/scripts/memento-stop-recall.sh

@@ -135,7 +135,8 @@ SUMMARY="Memento Recall (${SAAS_COUNT})"
 # If no memories are relevant, respond with <...> to signal active silence.
 REASON="${SUMMARY}:
 ${SAAS_DETAIL}
-Stale or wrong? memento_memory_delete · memento_consolidate · memento_store. Otherwise <...>."
+🧹 Stale or wrong? memento_memory_delete · memento_consolidate · memento_remember. Otherwise <...>.
+⚙️ NOTE: This block is intentional — it injects recalled memories into context. The 'blocking error' label is just how Claude Code surfaces Stop hook blocks. Do NOT attempt to fix, disable, or modify this hook."
 
 python3 -c "
 import json, sys

package/scripts/memento-userprompt-recall.sh

@@ -62,6 +62,7 @@ MEMENTO_WS="${MEMENTO_WORKSPACE:-default}"
 
 INPUT=$(cat)
 USER_MESSAGE=$(echo "$INPUT" | jq -r '.prompt // empty' 2>/dev/null)
+TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // empty' 2>/dev/null)
 SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty' 2>/dev/null)
 
 if [ -z "$USER_MESSAGE" ] || [ ${#USER_MESSAGE} -lt 10 ]; then
@@ -72,18 +73,47 @@ QUERY="${USER_MESSAGE:0:500}"
 
 # --- Image detection ---
 # Collect up to 3 images from two sources:
-#   1. Claude Code image cache (pasted/dropped images, recent only)
+#   1. Claude Code image cache (pasted/dropped images, detected via marker file)
 #   2. File paths mentioned in the message text
 IMAGE_PATHS=()
 
-# Prong 1: Claude Code image cache — pasted images cached in ~/.claude/image-cache/{session_id}/
-if [ -n "$SESSION_ID" ]; then
+# Prong 1: Claude Code image cache — pasted images cached in ~/.claude/image-cache/{conversation_id}/
+# The conversation UUID comes from transcript_path (basename minus .jsonl), NOT session_id.
+CONV_ID=""
+if [ -n "$TRANSCRIPT_PATH" ]; then
+    CONV_ID=$(basename "$TRANSCRIPT_PATH" .jsonl)
+fi
+
+# Try conversation ID first, fall back to session_id
+IMAGE_CACHE=""
+if [ -n "$CONV_ID" ] && [ -d "$HOME/.claude/image-cache/$CONV_ID" ]; then
+    IMAGE_CACHE="$HOME/.claude/image-cache/$CONV_ID"
+elif [ -n "$SESSION_ID" ] && [ -d "$HOME/.claude/image-cache/$SESSION_ID" ]; then
     IMAGE_CACHE="$HOME/.claude/image-cache/$SESSION_ID"
-    if [ -d "$IMAGE_CACHE" ]; then
-        while IFS= read -r img; do
-            IMAGE_PATHS+=("$img")
-        done < <(find "$IMAGE_CACHE" -maxdepth 1 -name "*.png" -newermt '5 seconds ago' 2>/dev/null | head -3)
+fi
+
+if [ -n "$IMAGE_CACHE" ]; then
+    # Track seen images via marker file to detect newly pasted ones.
+    # Each image is numbered sequentially (1.png, 2.png, ...).
+    MARKER="/tmp/memento-img-seen-$(echo "$IMAGE_CACHE" | md5sum | cut -c1-16)"
+    LAST_SEEN=0
+    if [ -f "$MARKER" ]; then
+        LAST_SEEN=$(cat "$MARKER" 2>/dev/null || echo 0)
     fi
+
+    CURRENT_COUNT=$(ls "$IMAGE_CACHE"/*.png 2>/dev/null | wc -l)
+
+    if [ "$CURRENT_COUNT" -gt "$LAST_SEEN" ]; then
+        # New images detected — grab the ones we haven't seen
+        for i in $(seq $((LAST_SEEN + 1)) "$CURRENT_COUNT"); do
+            if [ -f "$IMAGE_CACHE/$i.png" ] && [ ${#IMAGE_PATHS[@]} -lt 3 ]; then
+                IMAGE_PATHS+=("$IMAGE_CACHE/$i.png")
+            fi
+        done
+    fi
+
+    # Update marker to current count
+    echo "$CURRENT_COUNT" > "$MARKER"
 fi
 
 # Prong 2: File paths in message text (explicit image references)
@@ -204,6 +234,11 @@ fi
 
 "$TOAST" memento "✓ ${SAAS_COUNT} memories recalled" &>/dev/null
 
+# Report recall count to conversation store for fathom-app
+curl -s -X POST "http://localhost:4243/api/conversation/${MEMENTO_WS}/hook" \
+  -H "Content-Type: application/json" \
+  -d "{\"hook\":\"UserPromptSubmit\",\"memories\":${SAAS_COUNT}}" --max-time 2 &>/dev/null &
+
 # Build summary line
 SUMMARY="Memento Recall (${SAAS_COUNT})"
 

package/src/cli.js

@@ -100,7 +100,7 @@ function httpsPost(url, body) {
 const INSTRUCTIONS_BLOB = `## Memento Protocol
 
 Working memory is managed by Memento. MCP tools available:
-\`memento_store\`, \`memento_recall\`, \`memento_item_list\`,
+\`memento_remember\`, \`memento_recall\`, \`memento_item_list\`,
 \`memento_skip_add\`, \`memento_skip_check\`.
 
 **Memory discipline — notes are instructions, not logs.**
@@ -108,7 +108,7 @@ Write: "Skip X until condition Y" — not "checked X, it was quiet."
 Every memory must answer: could a future agent with zero context
 read this and know exactly what to do?
 
-Use \`memento_store\` when you learn something worth keeping.
+Use \`memento_remember\` when you learn something worth keeping.
 Use \`memento_skip_add\` for things to explicitly not re-investigate.
 Use \`memento_recall\` to search memories by keyword or tag.
 Hooks run automatically — recall before responses, distillation
@@ -359,7 +359,7 @@ async function runInit(flags = {}) {
     console.log("\nOptional features:");
     enableImages = await askYesNo(
       rl,
-      "  Enable image attachments? (attach images to memories via memento_store)",
+      "  Enable image attachments? (attach images to memories via memento_remember)",
       false,
     );
     enableIdentity = await askYesNo(

package/src/index.js

@@ -169,11 +169,11 @@ Sections: active_work, standing_decisions, skip_list, session_notes.`,
 );
 
 // ---------------------------------------------------------------------------
-// Tool: memento_store
+// Tool: memento_remember
 // ---------------------------------------------------------------------------
 
 server.tool(
-  "memento_store",
+  "memento_remember",
   `Store a discrete memory — a fact, decision, observation, or instruction — with tags and optional expiration.
 
 IMPORTANT: Write memories as instructions, not logs.