memento-mcp 0.3.0 → 0.3.1

package/package.json

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

package/scripts/hook-toast.sh

@@ -0,0 +1,140 @@
+#!/bin/bash
+# hook-toast.sh — tmux popup notifications for agent hooks.
+#
+# Usage:
+#   hook-toast.sh <system> <message>          # one-shot toast (auto-closes after 2s)
+#   hook-toast.sh <system> --status <id>      # start a multi-stage toast (poll mode)
+#   hook-toast.sh --update <id> <message>     # update a running toast
+#   hook-toast.sh --close <id>                # close a running toast (after delay)
+#
+# Built-in systems: fathom, memento
+#   fathom  → 📝 purple (colour141)
+#   memento → 🧠 teal (colour37)
+#
+# Any other system name works too — gets a default icon and grey border.
+#
+# Multi-stage example (PreCompact):
+#   hook-toast.sh memento --status precompact
+#   hook-toast.sh --update precompact "⏳ Getting context..."
+#   hook-toast.sh --update precompact "⏳ Extracting memories..."
+#   hook-toast.sh --update precompact "✓ Stored 7 memories"
+#   hook-toast.sh --close precompact
+
+TOAST_DIR="/tmp/hook-toast"
+mkdir -p "$TOAST_DIR"
+
+# Bail silently if not in tmux
+if ! tmux info &>/dev/null; then
+    exit 0
+fi
+
+get_style() {
+    case "$1" in
+        memento) echo "colour37" ;;
+        fathom)  echo "colour141" ;;
+        *)       echo "colour245" ;;
+    esac
+}
+
+get_icon() {
+    case "$1" in
+        memento) echo "🧠" ;;
+        fathom)  echo "📝" ;;
+        *)       echo "📌" ;;
+    esac
+}
+
+get_title() {
+    case "$1" in
+        memento) echo "Memento" ;;
+        fathom)  echo "Fathom" ;;
+        *)       echo "$1" ;;
+    esac
+}
+
+# One-shot toast
+toast_oneshot() {
+    local system="$1"
+    local message="$2"
+    local colour icon title
+    colour=$(get_style "$system")
+    icon=$(get_icon "$system")
+    title=$(get_title "$system")
+
+    (tmux display-popup -x R -y 0 -w 42 -h 3 \
+        -s "fg=$colour" -T " $icon $title " -E \
+        "echo '  $message'; sleep 2" &>/dev/null &)
+}
+
+# Start a multi-stage toast (polling status file)
+toast_start() {
+    local system="$1"
+    local id="$2"
+    local status_file="$TOAST_DIR/$id"
+    local colour icon title
+    colour=$(get_style "$system")
+    icon=$(get_icon "$system")
+    title=$(get_title "$system")
+
+    echo "⏳ Starting..." > "$status_file"
+
+    (tmux display-popup -x R -y 0 -w 42 -h 3 \
+        -s "fg=$colour" -T " $icon $title " -E "
+        LAST=''
+        while [ -f '$status_file' ]; do
+            MSG=\$(cat '$status_file' 2>/dev/null)
+            if [ \"\$MSG\" != \"\$LAST\" ]; then
+                clear
+                echo \"  \$MSG\"
+                LAST=\"\$MSG\"
+            fi
+            case \"\$MSG\" in ✓*|✗*) sleep 2; break ;; esac
+            sleep 0.2
+        done
+    " &>/dev/null &)
+}
+
+# Update a running toast
+toast_update() {
+    local id="$1"
+    local message="$2"
+    echo "$message" > "$TOAST_DIR/$id"
+}
+
+# Close a running toast (remove status file — popup exits on next poll)
+toast_close() {
+    local id="$1"
+    # Give the popup time to display the final message
+    sleep 2
+    rm -f "$TOAST_DIR/$id"
+}
+
+# --- Argument parsing ---
+case "${1:-}" in
+    --update)
+        toast_update "$2" "$3"
+        ;;
+    --close)
+        toast_close "$2"
+        ;;
+    --*)
+        echo "Unknown option: $1" >&2
+        exit 1
+        ;;
+    "")
+        echo "Usage: hook-toast.sh <system> <message>" >&2
+        echo "       hook-toast.sh <system> --status <id>" >&2
+        echo "       hook-toast.sh --update <id> <message>" >&2
+        echo "       hook-toast.sh --close <id>" >&2
+        exit 1
+        ;;
+    *)
+        SYSTEM="$1"
+        shift
+        if [ "${1:-}" = "--status" ]; then
+            toast_start "$SYSTEM" "$2"
+        else
+            toast_oneshot "$SYSTEM" "$*"
+        fi
+        ;;
+esac

package/scripts/memento-precompact-distill.sh

@@ -8,17 +8,27 @@
 set -o pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+TOAST="$SCRIPT_DIR/hook-toast.sh"
+
+# Toast: start multi-stage
+"$TOAST" memento --status distill &>/dev/null
+"$TOAST" --update distill "⏳ Getting context..." &>/dev/null
+
 INPUT=$(cat)
 
 TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path' | sed "s|~|$HOME|")
 
 # Only distill if transcript exists and has content
 if [ ! -f "$TRANSCRIPT_PATH" ]; then
+    "$TOAST" --update distill "✗ No transcript found" &>/dev/null
+    ("$TOAST" --close distill &>/dev/null &)
     exit 0
 fi
 
 LINE_COUNT=$(wc -l < "$TRANSCRIPT_PATH")
 if [ "$LINE_COUNT" -lt 2 ]; then
+    "$TOAST" --update distill "✓ Skipped (tiny conversation)" &>/dev/null
+    ("$TOAST" --close distill &>/dev/null &)
     exit 0
 fi
 
@@ -79,9 +89,14 @@ else
 fi
 
 if [ ${#TRANSCRIPT_TEXT} -lt 200 ]; then
+    "$TOAST" --update distill "✓ Skipped (too short)" &>/dev/null
+    ("$TOAST" --close distill &>/dev/null &)
     exit 0  # Too short to distill anything useful
 fi
 
+# Toast: extracting
+"$TOAST" --update distill "⏳ Extracting memories..." &>/dev/null
+
 DISTILL_MODEL="${DISTILL_MODEL:-llama}"
 
 # claude-code path: run extraction locally via claude -p, push to /v1/memories/ingest
@@ -166,9 +181,15 @@ print(json.dumps({'memories': parsed, 'source': 'distill:claude-code'}))
             -d "$INGEST_PAYLOAD" \
             "$MEMENTO_API/v1/memories/ingest" > /dev/null 2>&1
 
+        "$TOAST" --update distill "✓ Stored ${MEMORY_COUNT} memories" &>/dev/null
+        ("$TOAST" --close distill &>/dev/null &)
+
         python3 -c "import json,sys; print(json.dumps({'systemMessage': sys.argv[1]}))" \
             "Memento Distill (claude-code): ${MEMORY_COUNT} memories — ${TYPE_BREAKDOWN}"
     else
+        "$TOAST" --update distill "✓ No memories extracted" &>/dev/null
+        ("$TOAST" --close distill &>/dev/null &)
+
         python3 -c "import json,sys; print(json.dumps({'systemMessage': sys.argv[1]}))" \
             "Memento Distill (claude-code): no memories extracted"
     fi
@@ -206,9 +227,15 @@ MEMORY_COUNT=$(echo "$DISTILL_SUMMARY" | cut -d'|' -f1)
 TYPE_BREAKDOWN=$(echo "$DISTILL_SUMMARY" | cut -d'|' -f2)
 
 if [ "${MEMORY_COUNT:-0}" -gt 0 ] 2>/dev/null; then
+    "$TOAST" --update distill "✓ Stored ${MEMORY_COUNT} memories" &>/dev/null
+    ("$TOAST" --close distill &>/dev/null &)
+
     python3 -c "import json,sys; print(json.dumps({'systemMessage': sys.argv[1]}))" \
         "Memento Distill: ${MEMORY_COUNT} memories — ${TYPE_BREAKDOWN}"
 else
+    "$TOAST" --update distill "✓ No memories extracted" &>/dev/null
+    ("$TOAST" --close distill &>/dev/null &)
+
     python3 -c "import json,sys; print(json.dumps({'systemMessage': sys.argv[1]}))" \
         "Memento Distill: no memories extracted"
 fi

package/scripts/memento-sessionstart-identity.sh

@@ -10,6 +10,7 @@
 set -o pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+TOAST="$SCRIPT_DIR/hook-toast.sh"
 
 # --- Config from .memento.json (if present) ---
 CONFIG_JSON=$(python3 -c "
@@ -80,6 +81,9 @@ ACTIVE_TMP=$(mktemp)
 SKIP_TMP=$(mktemp)
 trap 'rm -f "$IDENTITY_TMP" "$ACTIVE_TMP" "$SKIP_TMP"' EXIT
 
+# Toast: loading identity
+"$TOAST" memento "⏳ Loading identity..." &>/dev/null
+
 # Fetch all three endpoints in parallel
 curl -s --max-time 3 -H "$AUTH_HEADER" -H "$WS_HEADER" \
     "$MEMENTO_API/v1/identity" > "$IDENTITY_TMP" 2>/dev/null &
@@ -159,4 +163,7 @@ print(json.dumps({
 }))
 " "$IDENTITY_TMP" "$ACTIVE_TMP" "$SKIP_TMP" 2>/dev/null
 
+# Toast: done
+"$TOAST" memento "✓ Identity loaded" &>/dev/null
+
 exit 0

package/scripts/memento-stop-recall.sh

@@ -6,6 +6,7 @@
 set -o pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+TOAST="$SCRIPT_DIR/hook-toast.sh"
 
 # --- Config from .memento.json (if present) ---
 CONFIG_JSON=$(python3 -c "
@@ -74,6 +75,9 @@ fi
 # Truncate to first 500 chars for the query
 QUERY="${ASSISTANT_MSG:0:500}"
 
+# Toast: start retrieving
+"$TOAST" memento "⏳ Autonomous recall..." &>/dev/null
+
 # Call Memento /v1/context
 RESULT=$(curl -s --max-time 3 \
     -X POST \
@@ -122,9 +126,13 @@ if [ -n "$REMAINING" ]; then
 fi
 
 if [ -z "$SAAS_COUNT" ] || [ "$SAAS_COUNT" = "0" ]; then
+    "$TOAST" memento "✓ No memories matched" &>/dev/null
     exit 0
 fi
 
+# Toast: result
+"$TOAST" memento "✓ ${SAAS_COUNT} memories recalled" &>/dev/null
+
 # Block the Stop so Claude continues — the reason becomes Claude's next instruction.
 REASON="Autonomous Recall: ${SAAS_COUNT} memories surfaced from your last response.
 ${SAAS_DETAIL}

package/scripts/memento-userprompt-recall.sh

@@ -7,6 +7,7 @@
 set -o pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+TOAST="$SCRIPT_DIR/hook-toast.sh"
 
 # --- Config from .memento.json (if present) ---
 CONFIG_JSON=$(python3 -c "
@@ -66,6 +67,9 @@ fi
 
 QUERY="${USER_MESSAGE:0:500}"
 
+# Toast: start retrieving
+"$TOAST" memento "⏳ Retrieving memories..." &>/dev/null
+
 # Call Memento SaaS /v1/context
 SAAS_OUTPUT=$(curl -s --max-time 3 \
     -X POST \
@@ -118,9 +122,13 @@ if [ -n "$REMAINING" ]; then
 fi
 
 if [ -z "$SAAS_COUNT" ] || [ "$SAAS_COUNT" = "0" ]; then
+    "$TOAST" memento "✓ No memories matched" &>/dev/null
     exit 0
 fi
 
+# Toast: result
+"$TOAST" memento "✓ ${SAAS_COUNT} memories recalled" &>/dev/null
+
 DETAIL_TEXT="Memento Recall: ${SAAS_COUNT} memories"
 DETAIL_TEXT="$DETAIL_TEXT"$'\n'"$SAAS_DETAIL"
 DETAIL_TEXT="$DETAIL_TEXT"$'\n'$'\n'"REMINDER: If Memento MCP tools are not loaded, run: ToolSearch query=\"+memento\" max_results=20"

package/src/cli.js

@@ -403,6 +403,7 @@ async function runInit() {
       fs.mkdirSync(localScriptsDir, { recursive: true });
 
     const scriptFiles = [
+      "hook-toast.sh",
       enableUserPrompt && "memento-userprompt-recall.sh",
       enableStop && "memento-stop-recall.sh",
       enablePreCompact && "memento-precompact-distill.sh",