agent-recall-mcp 3.4.37 → 3.4.39

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/README.md +111 -53
  2. package/dist/index.js +1 -1
  3. package/dist/server.d.ts.map +1 -1
  4. package/dist/server.js +5 -2
  5. package/dist/server.js.map +1 -1
  6. package/dist/tools/check.d.ts.map +1 -1
  7. package/dist/tools/check.js +4 -3
  8. package/dist/tools/check.js.map +1 -1
  9. package/package.json +4 -4
  10. package/dist/tools/bootstrap.d.ts +0 -3
  11. package/dist/tools/bootstrap.d.ts.map +0 -1
  12. package/dist/tools/bootstrap.js +0 -148
  13. package/dist/tools/bootstrap.js.map +0 -1
  14. package/dist/tools/brief.d.ts +0 -18
  15. package/dist/tools/brief.d.ts.map +0 -1
  16. package/dist/tools/brief.js +0 -78
  17. package/dist/tools/brief.js.map +0 -1
  18. package/dist/tools/dashboard-export.d.ts +0 -3
  19. package/dist/tools/dashboard-export.d.ts.map +0 -1
  20. package/dist/tools/dashboard-export.js +0 -19
  21. package/dist/tools/dashboard-export.js.map +0 -1
  22. package/dist/tools/memory-query.d.ts +0 -3
  23. package/dist/tools/memory-query.d.ts.map +0 -1
  24. package/dist/tools/memory-query.js +0 -66
  25. package/dist/tools/memory-query.js.map +0 -1
  26. package/dist/tools/project-board.d.ts +0 -3
  27. package/dist/tools/project-board.d.ts.map +0 -1
  28. package/dist/tools/project-board.js +0 -22
  29. package/dist/tools/project-board.js.map +0 -1
  30. package/dist/tools/project-status.d.ts +0 -3
  31. package/dist/tools/project-status.d.ts.map +0 -1
  32. package/dist/tools/project-status.js +0 -15
  33. package/dist/tools/project-status.js.map +0 -1
  34. package/dist/tools/session-end-reflect.d.ts +0 -3
  35. package/dist/tools/session-end-reflect.d.ts.map +0 -1
  36. package/dist/tools/session-end-reflect.js +0 -25
  37. package/dist/tools/session-end-reflect.js.map +0 -1
  38. package/dist/tools/skill-list.d.ts +0 -3
  39. package/dist/tools/skill-list.d.ts.map +0 -1
  40. package/dist/tools/skill-list.js +0 -16
  41. package/dist/tools/skill-list.js.map +0 -1
  42. package/dist/tools/skill-recall.d.ts +0 -3
  43. package/dist/tools/skill-recall.d.ts.map +0 -1
  44. package/dist/tools/skill-recall.js +0 -20
  45. package/dist/tools/skill-recall.js.map +0 -1
  46. package/dist/tools/skill-write.d.ts +0 -3
  47. package/dist/tools/skill-write.d.ts.map +0 -1
  48. package/dist/tools/skill-write.js +0 -31
  49. package/dist/tools/skill-write.js.map +0 -1
package/README.md CHANGED
@@ -2,34 +2,31 @@
2
2
 
3
3
  <h1 align="center">AgentRecall</h1>
4
4
 
5
- <p align="center"><strong>Your agent doesn't just remember. It learns how you think.</strong></p>
6
- <p align="center">Every correction saved is a mistake never repeated. Every insight compounded is tokens never wasted rebuilding context.</p>
7
- <p align="center">Persistent, compounding memory + automatic correction capture. MCP server + SDK + CLI.</p>
5
+ <p align="center"><strong>Claude Code memory that learns from corrections. The only learning loop that measures whether your agent actually stops repeating a mistake.</strong></p>
6
+
7
+ <p align="center">Corrections ledger + session lifecycle + honest measurement. MCP · SDK · CLI · Skill.</p>
8
8
 
9
9
  <p align="center">
10
10
  <a href="https://t.me/+ywZwoHrg3AM0NDVi"><img src="https://img.shields.io/badge/Telegram-Community-2CA5E0?style=flat-square&logo=telegram" alt="Telegram Community"></a>
11
11
  <a href="https://www.npmjs.com/package/agent-recall-mcp"><img src="https://img.shields.io/npm/v/agent-recall-mcp?style=flat-square&label=MCP&color=5D34F2" alt="MCP npm"></a>
12
12
  <a href="https://www.npmjs.com/package/agent-recall-sdk"><img src="https://img.shields.io/npm/v/agent-recall-sdk?style=flat-square&label=SDK&color=0EA5E9" alt="SDK npm"></a>
13
13
  <a href="https://www.npmjs.com/package/agent-recall-cli"><img src="https://img.shields.io/npm/v/agent-recall-cli?style=flat-square&label=CLI&color=10B981" alt="CLI npm"></a>
14
- <a href="https://github.com/Goldentrii/AgentRecall/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-brightgreen?style=flat-square" alt="License"></a>
15
- <img src="https://img.shields.io/badge/MCP-5_tools_default-orange?style=flat-square" alt="Tools">
14
+ <a href="https://github.com/Goldentrii/AgentRecall-X/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-brightgreen?style=flat-square" alt="License"></a>
15
+ <img src="https://img.shields.io/badge/tools-5_default-orange?style=flat-square" alt="Tools">
16
16
  <img src="https://img.shields.io/badge/memory_layers-5-7C3AED?style=flat-square" alt="5 layers">
17
17
  <img src="https://img.shields.io/badge/cloud-zero_by_default-blue?style=flat-square" alt="Zero cloud by default">
18
- <img src="https://img.shields.io/badge/decay-FSRS--lite-3B82F6?style=flat-square" alt="FSRS-lite decay">
19
18
  <img src="https://img.shields.io/badge/retrieval-keyword_%2B_RRF-8B5CF6?style=flat-square" alt="Keyword + RRF retrieval">
20
- <img src="https://img.shields.io/badge/feedback-precision_KPI-F59E0B?style=flat-square" alt="Precision KPI">
21
19
  </p>
22
20
 
23
21
  <p align="center">
24
- <a href="#the-session-loop"><img src="https://img.shields.io/badge/%2Farstatus-START_HERE-22C55E?style=for-the-badge" alt="/arstatus"></a>
25
- <a href="#the-session-loop"><img src="https://img.shields.io/badge/%2Farstart-Load_Context-4ECDC4?style=for-the-badge" alt="/arstart"></a>
26
- <a href="#the-session-loop"><img src="https://img.shields.io/badge/%2Farsave-Save_Session-FF6B6B?style=for-the-badge" alt="/arsave"></a>
27
- <a href="#the-session-loop"><img src="https://img.shields.io/badge/%2Farsaveall-Batch_Save-FFD93D?style=for-the-badge" alt="/arsaveall"></a>
28
- <a href="#the-session-loop"><img src="https://img.shields.io/badge/%2Farbootstrap-Transfer_Memory-8B5CF6?style=for-the-badge" alt="/arbootstrap"></a>
22
+ <a href="#the-session-loop"><img src="https://img.shields.io/badge/%2Farstart-OPEN·START_HERE-22C55E?style=for-the-badge" alt="/arstart"></a>
23
+ <a href="#the-session-loop"><img src="https://img.shields.io/badge/%2Farsave-SAVE-FF6B6B?style=for-the-badge" alt="/arsave"></a>
24
+ <a href="#the-session-loop"><img src="https://img.shields.io/badge/%2Farrecall-SEARCH-4ECDC4?style=for-the-badge" alt="/arrecall"></a>
25
+ <a href="#the-session-loop"><img src="https://img.shields.io/badge/%2Farreflect-CONSOLIDATE-8B5CF6?style=for-the-badge" alt="/arreflect"></a>
29
26
  </p>
30
27
 
31
28
  <details>
32
- <summary>🤖 <b>Agent found this repo?</b> Install AgentRecall for your human (click to expand)</summary>
29
+ <summary><b>Agent found this repo?</b> Install AgentRecall for your human (click to expand)</summary>
33
30
 
34
31
  **1. Install the MCP server** (Claude Code):
35
32
 
@@ -55,35 +52,55 @@ At the end of a session, call session_end to compound what you learned.
55
52
 
56
53
  ---
57
54
 
58
- ## What & Why
55
+ ## What it does
56
+
57
+ AgentRecall is two things:
58
+
59
+ 1. **A governed corrections ledger** — every time you correct your agent (*"no, not that version"*, *"put this section first"*, *"ask me before you assume"*), that correction is stored as a structured record with severity, evidence, and outcome tracking. It persists across sessions, projects, and agent restarts.
60
+
61
+ 2. **A measurement instrument** — the only open-source system that tracks whether a correction actually changed what the agent does in a later session. Every correction accumulates `retrieved_count`, and every time the agent encounters the same situation, the outcome is recorded (`heeded` or `recurred`).
62
+
63
+ No other agent memory tool measures that second step. Every benchmark in the field tests retrieval; none tests behavioral change across sessions. We built the measurement harness first — and we publish what we found, including the unflattering numbers.
64
+
65
+ ---
66
+
67
+ ## Measured, not promised
59
68
 
60
- **AgentRecall is not a memory tool. It's a learning loop.** Memory is the mechanism; understanding is the goal. Every time you correct your agent — *"no, not that version"*, *"put this section first"*, *"ask me before you assume"* — that correction is stored, weighted, and recalled next time. After 10 sessions your agent doesn't just remember your project; it understands how you think.
69
+ Most agent memory tools claim "never repeats the same mistake." None of them publish a number for it.
61
70
 
62
- - **Correction-first.** When you say "no, that's wrong", we log a `CorrectionRecord` with severity, holder, and evidence. After N confirmations across sessions it auto-promotes to a cross-project insight.
63
- - **Measurable learning loop.** Every correction tracks `retrieved_count`, `heeded_count`, `recurrence_count`, `precision`. The KPI that matters: *did the same bug recur after we warned about it?*
64
- - **Five memory types.** Episodic, semantic, procedural, narrative, correction — mapped to the canonical cognitive-psychology taxonomy (Squire 2004, Tulving 1972).
65
- - **Local markdown, local by default.** Everything lives in `~/.agent-recall/`. Open it in Obsidian, grep it in the terminal, version it in git. The default keyword + RRF retrieval is fully local — zero cloud, no API keys, no lock-in. Semantic vector search is **optional**: set `OPENAI_API_KEY` and query/content text is sent to OpenAI for embeddings. Leave it unset and nothing leaves your machine.
66
- - **Backed by published math.** FSRS-lite decay (Ebbinghaus → SuperMemo → FSRS-6), RRF fusion (Cormack 2009). A Modern Hopfield re-rank primitive (Ramsauer 2020) ships in the codebase but is **not** wired into the default retrieval path — what runs today is BM25/keyword + RRF, plus optional vector search.
71
+ Here is what our own instrument found on our own live corpus (2026-07-03):
67
72
 
68
- > **The Automaticity Law.** Memory only compounds if it's used *automatically*, not on demand. Measured on the live corpus: push channels (`session_start`, `session_end`, correction hooks) show repeated behavior-changing usage, while pull channels had **zero** organic calls across 44 projects over weeks of real use — including from the agent that built them. That's why only 5 tools ship by default; the two-verb model (inhale/exhale) carries all the compounding value, and everything else is opt-in via `--full`.
73
+ | Metric | Value | Artifact |
74
+ |---|---|---|
75
+ | Correction capture recall (dual-blind audit, n=59) | **35.3%** [17.3–58.7 CI] | `UPDATE-LOG.md` §M2 |
76
+ | Heed rate, pre-2026-07-03 (instrument-biased upper bound — do not cite) | 92.5% [Wilson 60.1–100] | `scripts/eval/baselines/rmr-baseline-2026-07-03.json` |
77
+ | Heed rate, evidence-grounded (post-reset) | **0/3** events | `scripts/eval/baselines/rmr-baseline-2026-07-03.json` |
78
+ | Correction transfer recall (offline bench, achievable) | **0/4** [Wilson 0–49%] | `scripts/eval/baselines/correction-transfer-real-2026-07-03.json` |
79
+ | Median session_start injection | **1,489 tokens** (was 2,010; Mem0 anchor ~7K) | `UPDATE-LOG.md` §C2 |
80
+ | p95 session_start latency (warm) | **363 ms** (was 1,132) | `UPDATE-LOG.md` §C2 |
81
+
82
+ *The heed instrument defaulted to "heeded" absent evidence before 2026-07-03; the reset default is "unknown" — the honest 0/3 is the correct starting point, not a regression. Transfer recall cannot support a point-estimate claim below 39 classes (claim-gate ledger, [benchmark spec](docs/proposals/2026-07-02-correction-transfer-benchmark-spec.md) §2.6).*
83
+
84
+ **Verify it yourself:** every number above regenerates from the committed artifacts — see [docs/eval/REPRODUCE.md](docs/eval/REPRODUCE.md).
85
+
86
+ **What this means:** we captured 35% of real corrections in our own live use. The heed instrument was biased and we reset it. The offline transfer benchmark scores 0 on our own corpus — which is a density problem (32 active corrections across 19 projects is too sparse to front-run mistakes), not a retrieval architecture problem (confirmed 5× by internal experiments).
69
87
 
70
- > **Injection Precision KPI.** Every correction tracks `precision = heeded / retrieved` — of the times we surfaced this warning, how often did the agent actually act on it? `precision < 0.3` → archive candidate (noise we should stop injecting). `precision ≥ 0.8` → promote faster (high-signal, compound it sooner). This is the measurability claim: a memory system you can prove is working.
88
+ The learning loop framing is correct — the system is designed to track whether corrections change behavior — but the data we have so far is insufficient to quantify the uplift. We are publishing the measurement harness and running the experiment.
71
89
 
72
90
  ---
73
91
 
74
- ## Why AgentRecall vs X?
92
+ ## Why this is different from every other memory tool
75
93
 
76
- | Feature | AgentRecall | Mem0 | Zep | Letta |
77
- |---|---|---|---|---|
78
- | Correction tracking + precision KPI | ✅ Core feature | ❌ | ❌ | ❌ |
79
- | Behavioral calibration across sessions | ✅ | ❌ | ❌ | Partial |
80
- | Local markdown, zero cloud by default | ✅ (vector search optional, opt-in) | ❌ cloud | ❌ cloud | ❌ cloud |
81
- | MCP native | ✅ | ✅ | ✅ | ✅ |
82
- | FSRS-lite decay + keyword/RRF retrieval | ✅ | ❌ | ❌ | ❌ |
83
- | Free / open source | ✅ MIT | Freemium | Freemium | Apache |
84
- | Works offline | ✅ (default; vector search needs network) | ❌ | ❌ | Partial |
94
+ In mid-2026, the agent-memory field is crowded (Mem0 ~60K stars, Graphiti/Zep ~28K, Supermemory ~28K, Letta ~24K). Most published benchmark numbers in this space are self-reported on the same 2–3 retrieval benchmarks and are hard to reproduce independently.
85
95
 
86
- The difference: AgentRecall is the only system that tracks whether the agent actually acted on a warning — not just that it stored one.
96
+ The confirmed gap (from our research report `docs/research/agent-memory-landscape-2026-07.md` §2): **no public benchmark measures whether a captured correction changes what a fresh agent does in a new session.** LongMemEval, LoCoMo, MemoryAgentBench, Letta Leaderboard — all test retrieval or within-session updates.
97
+
98
+ AgentRecall owns two pieces of the unclaimed ground:
99
+
100
+ - **The corrections ledger** — a governed data model (`corrections-export/v1`, scrubbed egress, retraction, severity, proof-confidence) that any engine can integrate against.
101
+ - **The measurement harness** — `predict-loo` (leave-one-out, anti-self-confirming, dual denominators) and the correction-transfer benchmark spec (`HeedBench v1` — provisional name), which implements the missing pipeline: capture → persist → fresh session → measure recurrence.
102
+
103
+ Benchmark numbers in agent memory are typically self-reported and hard to reproduce. Ours regenerate from a fixed, hash-locked corpus with one command (`npm run bench`) — including the scores that make us look bad.
87
104
 
88
105
  ---
89
106
 
@@ -119,7 +136,7 @@ codex mcp add agent-recall -- npx -y agent-recall-mcp
119
136
  ```bash
120
137
  mkdir -p ~/.claude/skills/agent-recall
121
138
  curl -o ~/.claude/skills/agent-recall/SKILL.md \
122
- https://raw.githubusercontent.com/Goldentrii/AgentRecall/main/SKILL.md
139
+ https://raw.githubusercontent.com/Goldentrii/AgentRecall-X/main/SKILL.md
123
140
  ```
124
141
 
125
142
  ### SDK & CLI
@@ -148,28 +165,45 @@ The canonical cognitive-psychology taxonomy mapped to your agent's filesystem:
148
165
  | 2 | **Semantic** | Topic-clustered facts with `[[wikilinks]]`: Architecture, Goals, Blockers. | `palace/rooms/` |
149
166
  | 3 | **Procedural** | IF-THEN production rules — reusable how-tos. | `palace/skills/` |
150
167
  | 4 | **Narrative** | Project phases: Goal → What was hard → How solved → Synthesis. | `palace/pipeline/` |
151
- | 5 | **Correction** | Behavioral calibration: rules the agent must follow, with precision KPIs. | `corrections/` |
168
+ | 5 | **Correction** | Behavioral calibration: rules the agent must follow, with severity and outcome tracking. | `corrections/` |
152
169
  | + | **Awareness** | Cross-project insights promoted from N-confirmed corrections — the compounding layer. | `palace/awareness` |
153
170
 
154
- All layers share one **canonical naming grammar** (`<scope>/<type>/[<topic>/]<temporal>--<slug>.md`) so any agent can compose retrieval paths from intent. Existing files keep working via a `legacy_path` view — no migration needed.
171
+ All layers share one canonical naming grammar so any agent can compose retrieval paths from intent. Existing files keep working via a `legacy_path` view — no migration needed.
155
172
 
156
173
  ---
157
174
 
158
175
  ## The Session Loop
159
176
 
177
+ ```mermaid
178
+ flowchart LR
179
+ A([session start]) --> B["/arstart — open<br/>board → pick → load context"]
180
+ B --> C{work}
181
+ C -->|need past knowledge| D["/arrecall — search"]
182
+ D --> C
183
+ C --> E["/arsave — save<br/>journal + compound"]
184
+ E --> F([session end])
185
+ F -. every K sessions .-> G["/arreflect — consolidate"]
186
+ G -.-> A
187
+ ```
188
+
160
189
  | Command | When | What it does |
161
190
  |---|---|---|
162
- | 🔴 `/arstatus` | **First — every session** | Status board across ALL projects: pending work, blockers, relevance scores. Pick by number. |
163
- | `/arstart` | After picking a project | Load deep context: palace rooms, corrections, task-specific recall. |
164
- | 🔴 `/arsave` | **Last — every session** | Write journal + palace consolidation + awareness compounding + semantic prefetch. |
165
- | `/arsaveall` | End of day (multi-session) | Batch save all parallel sessions — scan, merge, deduplicate, done. |
166
- | `/arbootstrap` | First install / migrating | Scan your machine for existing projects and import them. |
191
+ | `/arstart` | **First — every session** | OPEN. No args = status board across ALL projects (pending work, blockers) → pick by number → load that project's deep context (palace rooms, corrections, task recall). `/arstart <slug>` loads directly; `/arstart bootstrap` scans your machine and imports existing projects. |
192
+ | `/arsave` | **Last — every session** | SAVE. Write journal + palace consolidation + awareness compounding. `/arsave all` batch-saves every parallel session of the day (scan, merge, deduplicate). |
193
+ | `/arrecall` | Mid-session, on demand | SEARCH. Surface past knowledge for the current task — documented fixes, prior decisions, patterns. |
194
+ | `/arreflect` | Every K sessions | CONSOLIDATE. Periodic triage: confirm recurrence/phantom matches, cluster new error classes, propose rule re-abstractions (rule edits stay owner-gated). |
195
+
196
+ > **Without `/arstart`, a fresh agent has zero orientation. Without `/arsave`, nothing compounds. Those two are the spine; `/arrecall` and `/arreflect` compound it.**
197
+
198
+ ---
167
199
 
168
- > **Without `/arstatus`, a fresh agent has zero orientation. Without `/arsave`, nothing compounds. These two are the entire loop.**
200
+ ## The Automaticity Principle
201
+
202
+ Memory only compounds if it fires automatically, not on demand. Every pull-channel tool (`recall`, `memory_query`) saw zero organic calls across 44 projects over weeks of real use — including from the agent that built them. That is why only 5 tools ship by default; the two-verb model (session_start / session_end) carries all the compounding value, and everything else is opt-in via `--full`.
169
203
 
170
204
  ---
171
205
 
172
- ## 🌙 Dreaming — Nightly Consolidation (optional)
206
+ ## Dreaming — Nightly Consolidation (optional)
173
207
 
174
208
  An autonomous overnight agent that runs while you sleep and compounds everything your sessions wrote during the day.
175
209
 
@@ -192,15 +226,36 @@ Dream reports are saved locally to `~/.agent-recall/dreams/YYYY-MM-DD.md`.
192
226
 
193
227
  ---
194
228
 
195
- ## 🖥️ War Room Dashboard — Download & Deploy
229
+ ## Experimental: Recurrence & Reflection Harness Kit
230
+
231
+ **The question this answers: does a correction actually change behavior, or does the same mistake come back?** A logged correction whose error class recurs after the rule was encoded is a *phantom gradient step* — the write cost was paid, the behavior never changed.
196
232
 
197
- A **local-first visual dashboard** for your memory: an activity calendar, per-project status, corrections, and insights — all rendered from your local `~/.agent-recall/` data. Fully offline (vendored assets), no Node and no build step.
233
+ The kit in [`experimental/harness-kit/`](experimental/harness-kit/) is a Claude Code harness layer that closes this loop on top of AgentRecall:
234
+
235
+ | Piece | What it does |
236
+ |---|---|
237
+ | `ar-scoreboard.py` (SessionStart hook) | Health digest every session: correction flow, insight promotion rate, loop health, phantom counts, reflection cadence |
238
+ | `ar-recurrence-check.py` (+ your `~/.agent-recall/taxonomy.json`, schema in `TAXONOMY-SCHEMA.md`) | Error-class taxonomy over your corrections; mechanical phantom detection (violation dated after its rule) |
239
+ | `/arstart` · `/arsave` · `/arrecall` · `/arreflect` | The four memory verbs (open · save · search · consolidate) as slash commands |
240
+ | `/arreflect` (every K sessions) | Periodic triage: confirm provisional matches, cluster new error classes, propose rule re-abstractions — **rule edits stay owner-gated** |
241
+ | `ar-nudge.py` (UserPromptSubmit hook) | Surfaces overdue reflection mid-session — memory pushed to the moment of action, not left to be remembered |
242
+ | `dispatch-model-guard.py` (PreToolUse hook, optional) | Warn-only guard for an explicit-model dispatch policy — an example of mechanizing a rule that text alone failed to enforce |
243
+
244
+ North-star metric: **post-re-abstraction phantom rate → 0** for treated classes. First validation run (2026-07-14, one power-user harness): 8 error classes and 18 confirmed phantom gradient steps found in 109 corrections; 6 rules re-abstracted the same day.
245
+
246
+ **Status: experimental.** Validated on one harness; Python 3 stdlib only; install steps and caveats in the kit's [README](experimental/harness-kit/README.md). Since v3.4.37 the same phenomenon is also measured natively: `failure_class` + the cross-project recurrence join.
247
+
248
+ ---
249
+
250
+ ## War Room Dashboard — Download & Deploy
251
+
252
+ A local-first visual dashboard for your memory: an activity calendar, per-project status, corrections, and insights — all rendered from your local `~/.agent-recall/` data. Fully offline (vendored assets), no Node and no build step.
198
253
 
199
254
  <p align="center">
200
255
  <img src="warroom/static/preview.png" alt="AgentRecall War Room — Overview" width="900">
201
256
  </p>
202
257
 
203
- 1. Download **`ar-warroom-v3.4.32.zip`** from the [latest GitHub Release](https://github.com/Goldentrii/AgentRecall/releases/latest).
258
+ 1. Download **`ar-warroom-v3.4.32.zip`** from the [latest GitHub Release](https://github.com/Goldentrii/AgentRecall-X/releases/latest).
204
259
  2. Unzip it, then serve it locally:
205
260
 
206
261
  ```bash
@@ -210,7 +265,7 @@ python3 -m http.server 8080
210
265
 
211
266
  3. Open **http://localhost:8080/AgentRecall.html**
212
267
 
213
- This is the recommended onboarding for **Hermes / OpenClaw / OpenCode** users too — one offline page to see everything your agent has learned.
268
+ This is the recommended onboarding for Hermes / OpenClaw / OpenCode users too — one offline page to see everything your agent has learned.
214
269
 
215
270
  ---
216
271
 
@@ -218,14 +273,16 @@ This is the recommended onboarding for **Hermes / OpenClaw / OpenCode** users to
218
273
 
219
274
  TypeScript monorepo, 4 published packages: `core` (storage + tool logic), `mcp-server` (thin MCP wrappers), `sdk` (programmatic API), `cli` (the `ar` command). All memory is local markdown under `~/.agent-recall/projects/<slug>/` — `journal/`, `corrections/`, and `palace/` (rooms, skills, pipeline, awareness). An optional Supabase mirror adds pgvector semantic recall; all-local stays the default.
220
275
 
276
+ Retrieval: keyword + RRF (Cormack 2009). FSRS-lite decay (Ebbinghaus → SuperMemo → FSRS-6). A Modern Hopfield re-rank primitive (Ramsauer 2020) is in the codebase but not wired into the default path — what runs today is local keyword/substring matching (stemming + synonym expansion + lightweight IDF, per-source ranking) merged via RRF, plus optional vector search when `OPENAI_API_KEY` is set. No inverted index or BM25 k1/b tuning — a real BM25 index is a possible future upgrade, not what's running now.
277
+
221
278
  ## Platform Compatibility
222
279
 
223
280
  | Platform | Mechanism | Status |
224
281
  |---|---|---|
225
- | Claude Code | MCP server + skill + hooks | ✅ Primary |
226
- | Cursor · Windsurf · VS Code (Copilot) · Codex | MCP server | ✅ |
227
- | Any JS/TS app | SDK (`agent-recall-sdk`) | ✅ |
228
- | Terminal / CI | CLI (`ar`) | ✅ |
282
+ | Claude Code | MCP server + skill + hooks | Primary |
283
+ | Cursor · Windsurf · VS Code (Copilot) · Codex | MCP server | Supported |
284
+ | Any JS/TS app | SDK (`agent-recall-sdk`) | Supported |
285
+ | Terminal / CI | CLI (`ar`) | Supported |
229
286
 
230
287
  ---
231
288
 
@@ -234,9 +291,10 @@ TypeScript monorepo, 4 published packages: `core` (storage + tool logic), `mcp-s
234
291
  - **Full reference** → [README.full.md](README.full.md)
235
292
  - **Docs** → [docs/](docs/) — command reference, architecture deep-dives
236
293
  - **Changelog** → [UPDATE-LOG.md](UPDATE-LOG.md) — phase-by-phase evolution + design reasoning
237
- - **Benchmark report** → [REPORT-2026-05-30.html](REPORT-2026-05-30.html) — Phase 6 visual report
294
+ - **Benchmark spec** → [docs/proposals/2026-07-02-correction-transfer-benchmark-spec.md](docs/proposals/2026-07-02-correction-transfer-benchmark-spec.md)
295
+ - **Landscape research** → [docs/research/agent-memory-landscape-2026-07.md](docs/research/agent-memory-landscape-2026-07.md)
238
296
  - **Skill** → [SKILL.md](SKILL.md) — Claude Code skill definition
239
- - **Community** → [Telegram](https://t.me/+ywZwoHrg3AM0NDVi) · [GitHub Issues](https://github.com/Goldentrii/AgentRecall/issues)
297
+ - **Community** → [Telegram](https://t.me/+ywZwoHrg3AM0NDVi) · [GitHub Issues](https://github.com/Goldentrii/AgentRecall-X/issues)
240
298
 
241
299
  ## Contributing
242
300
 
package/dist/index.js CHANGED
@@ -88,7 +88,7 @@ Default tools (5):
88
88
  session_start [ENTRY — call FIRST, before acting] Load project context at session start — corrections, insights, warnings
89
89
  session_end [ON SAVE/EXIT — YOU must call this; nothing auto-saves] Save journal, insights, trajectory — compounds memory over time
90
90
  remember [MID-SESSION WRITE — single fact/decision; saying it is not saving it] Write a memory — auto-routes to the right store
91
- recall [RETRIEVE — use freely, any time] Search all memory — BM25/keyword + RRF fusion + optional vector (OpenAI key)
91
+ recall [RETRIEVE — use freely, any time] Search all memory — keyword/RRF fusion + optional vector (OpenAI key)
92
92
  check [MID-SESSION — safe any time; for alignment, before risky decisions] Record understanding; anticipates the likely correction before you make it
93
93
 
94
94
  Full-mode additions (--full):
@@ -1 +1 @@
1
- {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,eAAO,MAAM,MAAM,WAGlB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,OAAO,MAAM,CAAC"}
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,eAAO,MAAM,MAAM,WAGlB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,OAAO,MAAM,CAAC"}
package/dist/server.js CHANGED
@@ -1,4 +1,7 @@
1
1
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
- import { VERSION } from "agent-recall-core";
3
- export const server = new McpServer({ name: "agent-recall", version: VERSION, description: "AgentRecall — persistent memory for AI agents. Community & feedback: https://t.me/+ywZwoHrg3AM0NDVi" }, { instructions: "AgentRecall is your memory across sessions. YOU drive its lifecycle — no harness fires it for you; if you don't call these tools, nothing is saved. (1) ENTRY: when a session resumes prior work, call session_start FIRST, before acting. (2) DURABLE INTENT: the moment you or the user says save / remember / checkpoint / 记住 / 保存, call session_end (or remember for a single fact). Saying it is not saving it. (3) EXIT: before you stop, call session_end. recall and check are safe to call freely, any time. Hooks auto-fire only in Claude Code; in every other host (Codex, chatbox, raw API) you are the sole lifecycle driver." });
2
+ import { VERSION, resolveHostProfile, lifecycleInstructions } from "agent-recall-core";
3
+ // Lifecycle instructions are tier-specific (see agent-recall-core/host-profile.ts)
4
+ // but always derived from the single canonical source — never hardcoded here.
5
+ const { tier } = resolveHostProfile();
6
+ export const server = new McpServer({ name: "agent-recall", version: VERSION, description: "AgentRecall — persistent memory for AI agents. Community & feedback: https://t.me/+ywZwoHrg3AM0NDVi" }, { instructions: lifecycleInstructions(tier) });
4
7
  //# sourceMappingURL=server.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,SAAS,CACjC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,qGAAqG,EAAE,EAC9J,EAAE,YAAY,EAAE,6mBAA6mB,EAAE,CAChoB,CAAC"}
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAEvF,mFAAmF;AACnF,8EAA8E;AAC9E,MAAM,EAAE,IAAI,EAAE,GAAG,kBAAkB,EAAE,CAAC;AAEtC,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,SAAS,CACjC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,qGAAqG,EAAE,EAC9J,EAAE,YAAY,EAAE,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAC9C,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/tools/check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqChD"}
1
+ {"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/tools/check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsChD"}
@@ -3,7 +3,7 @@ import { check } from "agent-recall-core";
3
3
  export function register(server) {
4
4
  server.registerTool("check", {
5
5
  title: "Check Understanding",
6
- description: "[MID-SESSION — safe any time; for alignment, before risky decisions] Use when the user asks to validate understanding, verify alignment, or check if their interpretation matches the human's intent.",
6
+ description: "[MID-SESSION — safe any time; for alignment, before risky decisions] Use when the user asks to validate understanding, verify alignment, or check if their interpretation matches the human's intent. Also call BEFORE a high-risk action — publish, deploy, delete, credential exposure, external send/message, or any other irreversible write — passing `action_description` (one sentence, what you're about to do). Returns matching corrections/rules/insights plus a `verdict`: `blocked` means an authoritative correction OVERRIDES the plan — read it before proceeding.",
7
7
  inputSchema: {
8
8
  goal: z.string().optional().describe("The goal or decision question you're checking alignment on. Required for alignment checks; optional when recording a pure decision trail (prior/posterior/evidence)."),
9
9
  understanding: z.string().optional().describe("Alias for goal — use when saying 'check my understanding: X'. Provide either goal or understanding."),
@@ -21,14 +21,15 @@ export function register(server) {
21
21
  posterior: z.number().min(0).max(1).optional().describe("Updated probability after considering evidence (0-1)."),
22
22
  outcome: z.string().optional().describe("Final decision result: 'confirmed', 'rejected', 'partial', or free text. Triggers decision trail persistence."),
23
23
  decision_id: z.string().optional().describe("Link multiple check calls to the same decision. Auto-generated if not provided."),
24
+ action_description: z.string().max(500).optional().describe("What you're about to DO, one sentence — pass this before publish/deploy/delete/credential/external-send/irreversible-write actions. Returns matching corrections/rules/insights on the result's `action_check` field, with `verdict: \"blocked\"` when an authoritative correction overrides the plan."),
24
25
  },
25
- }, async ({ goal, understanding, confidence, assumptions, human_correction, delta, project, prior, evidence, posterior, outcome, decision_id }) => {
26
+ }, async ({ goal, understanding, confidence, assumptions, human_correction, delta, project, prior, evidence, posterior, outcome, decision_id, action_description }) => {
26
27
  const effectiveGoal = goal || understanding;
27
28
  if (!effectiveGoal && !prior) {
28
29
  return { content: [{ type: "text", text: JSON.stringify({ error: "Provide either goal/understanding (for alignment check) or prior+posterior+evidence (for decision trail)" }) }], isError: true };
29
30
  }
30
31
  try {
31
- const result = await check({ goal: effectiveGoal, confidence, assumptions, human_correction, delta, project, prior, evidence, posterior, outcome, decision_id });
32
+ const result = await check({ goal: effectiveGoal, confidence, assumptions, human_correction, delta, project, prior, evidence, posterior, outcome, decision_id, action_description });
32
33
  return { content: [{ type: "text", text: JSON.stringify(result) }] };
33
34
  }
34
35
  catch (err) {
@@ -1 +1 @@
1
- {"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/tools/check.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/tools/check.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-recall-mcp",
3
- "version": "3.4.37",
3
+ "version": "3.4.39",
4
4
  "mcpName": "io.github.Goldentrii/agent-recall",
5
5
  "description": "Memory Palace MCP server for AI agents",
6
6
  "type": "module",
@@ -17,7 +17,7 @@
17
17
  "test": "node --test test/*.test.mjs"
18
18
  },
19
19
  "dependencies": {
20
- "agent-recall-core": "3.4.37",
20
+ "agent-recall-core": "3.4.39",
21
21
  "@modelcontextprotocol/sdk": "^1.28.0",
22
22
  "zod": "^3.24.0"
23
23
  },
@@ -60,8 +60,8 @@
60
60
  "license": "MIT",
61
61
  "repository": {
62
62
  "type": "git",
63
- "url": "git+https://github.com/Goldentrii/AgentRecall-MCP.git",
63
+ "url": "git+https://github.com/Goldentrii/AgentRecall-X.git",
64
64
  "directory": "packages/mcp-server"
65
65
  },
66
- "homepage": "https://github.com/Goldentrii/AgentRecall-MCP#readme"
66
+ "homepage": "https://github.com/Goldentrii/AgentRecall-X#readme"
67
67
  }
@@ -1,3 +0,0 @@
1
- import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
- export declare function register(server: McpServer): void;
3
- //# sourceMappingURL=bootstrap.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/tools/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwDzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwGhD"}
@@ -1,148 +0,0 @@
1
- import * as z from "zod/v4";
2
- import { bootstrapScan, bootstrapImport, } from "agent-recall-core";
3
- // ---------------------------------------------------------------------------
4
- // GUARD 3 — strict scan_result schema for bootstrap_import
5
- //
6
- // inputSchema (line ~101) intentionally uses z.union([z.string(), z.record(...)]).
7
- // This is a loose outer shape (accepts string or object) so the MCP transport
8
- // can carry either form. The REAL structural validation happens at the handler
9
- // level (~line 121) via BootstrapScanResultSchema.safeParse() — that is where
10
- // the nonce + shape are enforced. The handler then calls bootstrapImport() which
11
- // validates the nonce cryptographically against the in-process VALID_NONCES
12
- // registry (core layer enforces security semantics; MCP layer handles transport).
13
- // ---------------------------------------------------------------------------
14
- const ImportableItemSchema = z.object({
15
- id: z.string(),
16
- type: z.enum(["identity", "memory", "architecture", "trajectory"]),
17
- source_path: z.string(),
18
- size_bytes: z.number(),
19
- preview: z.string(),
20
- });
21
- const DiscoveredProjectSchema = z.object({
22
- slug: z.string(),
23
- name: z.string(),
24
- path: z.string(),
25
- sources: z.array(z.object({
26
- type: z.enum(["git", "claude-memory", "claudemd", "package-json"]),
27
- path: z.string(),
28
- detail: z.string(),
29
- })),
30
- description: z.string().optional(),
31
- language: z.string().optional(),
32
- last_activity: z.string().optional(),
33
- already_in_ar: z.boolean(),
34
- importable_items: z.array(ImportableItemSchema),
35
- });
36
- const BootstrapScanResultSchema = z.object({
37
- projects: z.array(DiscoveredProjectSchema),
38
- global_items: z.array(ImportableItemSchema),
39
- stats: z.object({
40
- total_projects: z.number(),
41
- total_importable_items: z.number(),
42
- total_already_in_ar: z.number(),
43
- scan_duration_ms: z.number(),
44
- }),
45
- _session_nonce: z.string().min(1, "_session_nonce must be a non-empty string — call bootstrap_scan() first"),
46
- _scan_roots: z.array(z.string()),
47
- });
48
- export function register(server) {
49
- server.registerTool("bootstrap_scan", {
50
- title: "Bootstrap Scan",
51
- description: "Discover existing projects on this machine — git repos, Claude memory, CLAUDE.md files. Returns what CAN be imported into AgentRecall. Read-only, no writes. Run this first if AgentRecall is empty.",
52
- inputSchema: {
53
- scan_dirs: z.array(z.string()).optional().describe("Additional directories to scan (default: ~/Projects/, ~/work/, ~/code/, ~/dev/, ~/src/, ~/repos/, ~/github/)"),
54
- max_depth: z.number().int().min(1).max(5).optional().describe("Maximum directory depth to scan (default: 3, max: 5)"),
55
- },
56
- }, async ({ scan_dirs, max_depth }) => {
57
- const result = await bootstrapScan({
58
- scan_dirs: scan_dirs ?? undefined,
59
- max_depth: max_depth ?? undefined,
60
- });
61
- // Format as human-readable text + structured JSON
62
- const summary = [
63
- `Found ${result.stats.total_projects} projects (${result.stats.total_already_in_ar} already in AgentRecall, ${result.stats.total_projects - result.stats.total_already_in_ar} new)`,
64
- `${result.stats.total_importable_items} importable items`,
65
- `${result.global_items.length} global items (user profile)`,
66
- `Scan time: ${result.stats.scan_duration_ms}ms`,
67
- ``,
68
- `New projects:`,
69
- ...result.projects
70
- .filter(p => !p.already_in_ar)
71
- .slice(0, 15)
72
- .map(p => ` ${p.slug} — ${p.language ?? "unknown"} — ${p.sources.map(s => s.type).join("+")}`),
73
- ``,
74
- `To import: call bootstrap_import`,
75
- ].join("\n");
76
- return {
77
- content: [
78
- { type: "text", text: summary },
79
- { type: "text", text: JSON.stringify(result) },
80
- ],
81
- };
82
- });
83
- server.registerTool("bootstrap_import", {
84
- title: "Bootstrap Import",
85
- description: "Import discovered projects into AgentRecall. Call bootstrap_scan FIRST, then pass the EXACT scan_result object returned here — do NOT construct scan_result manually. Security: requires _session_nonce from the scan call; fabricated or replayed scan results are rejected.",
86
- inputSchema: {
87
- scan_result: z.union([z.string(), z.record(z.string(), z.unknown())]).describe("BootstrapScanResult from bootstrap_scan — pass the exact object returned by bootstrap_scan, including _session_nonce. Do NOT construct this manually."),
88
- project_slugs: z.array(z.string()).optional().describe("Import only these projects (default: all new)"),
89
- item_types: z.array(z.string()).optional().describe("Import only these item types: identity, memory, architecture, trajectory"),
90
- },
91
- }, async ({ scan_result, project_slugs, item_types }) => {
92
- let scan;
93
- try {
94
- // Parse JSON string if needed
95
- let rawScan;
96
- if (typeof scan_result === "string") {
97
- try {
98
- rawScan = JSON.parse(scan_result);
99
- }
100
- catch {
101
- return { content: [{ type: "text", text: "Error: scan_result string is not valid JSON. Pass the exact object from bootstrap_scan." }], isError: true };
102
- }
103
- }
104
- else {
105
- rawScan = scan_result;
106
- }
107
- // GUARD 3: Strict structural validation — rejects malformed / fabricated objects
108
- const parsed = BootstrapScanResultSchema.safeParse(rawScan);
109
- if (!parsed.success) {
110
- const firstError = parsed.error.issues[0];
111
- const msg = firstError
112
- ? `${firstError.path.join(".")}: ${firstError.message}`
113
- : "scan_result failed schema validation";
114
- return {
115
- content: [{ type: "text", text: `Security: scan_result rejected — ${msg}. Pass the exact object returned by bootstrap_scan().` }],
116
- isError: true,
117
- };
118
- }
119
- scan = parsed.data;
120
- }
121
- catch {
122
- return { content: [{ type: "text", text: "Error: scan_result must be valid JSON from bootstrap_scan" }], isError: true };
123
- }
124
- const result = await bootstrapImport(scan, {
125
- project_slugs: project_slugs ?? undefined,
126
- item_types: item_types ?? undefined,
127
- });
128
- if (result.errors.length > 0 && result.items_imported === 0) {
129
- return {
130
- content: [{ type: "text", text: `Bootstrap import failed — ${result.errors.length} errors, 0 items imported.\n${result.errors.slice(0, 3).map(e => ` ${e.project}/${e.item}: ${e.error}`).join("\n")}` }],
131
- isError: true,
132
- };
133
- }
134
- const summary = [
135
- `Bootstrap import complete:`,
136
- ` ${result.projects_created} projects created`,
137
- ` ${result.items_imported} items imported`,
138
- ` ${result.items_skipped} items skipped`,
139
- ` ${result.errors.length} errors`,
140
- ` Duration: ${result.duration_ms}ms`,
141
- result.errors.length > 0 ? `\nErrors:\n${result.errors.map(e => ` ${e.project}/${e.item}: ${e.error}`).join("\n")}` : "",
142
- ``,
143
- `Run session_start to load any imported project.`,
144
- ].join("\n");
145
- return { content: [{ type: "text", text: summary }] };
146
- });
147
- }
148
- //# sourceMappingURL=bootstrap.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/tools/bootstrap.ts"],"names":[],"mappings":"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"}
@@ -1,18 +0,0 @@
1
- /**
2
- * brief MCP tool — compact LLM-free re-orientation briefing (≤200 tokens).
3
- *
4
- * --full only: registered inside the `if (fullMode)` block in index.ts.
5
- * Read-only: no session_start side-effects, no writes, no LLM calls.
6
- *
7
- * Returns identity, active phase, top corrections/watch_for/rules, the
8
- * 3-rule lifecycle text verbatim, trigger vocab, and a host-honesty line.
9
- *
10
- * AGENT INSTRUCTION:
11
- * brief() is a MID-SESSION re-orientation aid for hook-less hosts, NOT a
12
- * replacement for session_start. Always call session_start() FIRST at
13
- * session entry. Use brief() when you need a quick lifecycle reminder
14
- * mid-session without paying the full session_start token cost.
15
- */
16
- import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
17
- export declare function register(server: McpServer): void;
18
- //# sourceMappingURL=brief.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"brief.d.ts","sourceRoot":"","sources":["../../src/tools/brief.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmEhD"}
@@ -1,78 +0,0 @@
1
- /**
2
- * brief MCP tool — compact LLM-free re-orientation briefing (≤200 tokens).
3
- *
4
- * --full only: registered inside the `if (fullMode)` block in index.ts.
5
- * Read-only: no session_start side-effects, no writes, no LLM calls.
6
- *
7
- * Returns identity, active phase, top corrections/watch_for/rules, the
8
- * 3-rule lifecycle text verbatim, trigger vocab, and a host-honesty line.
9
- *
10
- * AGENT INSTRUCTION:
11
- * brief() is a MID-SESSION re-orientation aid for hook-less hosts, NOT a
12
- * replacement for session_start. Always call session_start() FIRST at
13
- * session entry. Use brief() when you need a quick lifecycle reminder
14
- * mid-session without paying the full session_start token cost.
15
- */
16
- import * as z from "zod/v4";
17
- import { brief } from "agent-recall-core";
18
- export function register(server) {
19
- server.registerTool("brief", {
20
- title: "Brief",
21
- description: "READ-ONLY re-orientation briefing (≤200 tokens). " +
22
- "Returns: identity, active phase, top P0 corrections, watch_for patterns, behavior rules, " +
23
- "the 3-rule lifecycle text verbatim, save-trigger vocab, and a host-honesty hint. " +
24
- "LLM-free, deterministic, no side-effects. " +
25
- "--full only. " +
26
- "NOT a replacement for session_start — call session_start FIRST at session entry. " +
27
- "Use brief() mid-session when you need a lightweight lifecycle reminder.",
28
- inputSchema: {
29
- project: z.string().optional().describe("Project slug (default: auto-detected from cwd)"),
30
- },
31
- annotations: {
32
- readOnlyHint: true,
33
- },
34
- }, async ({ project }) => {
35
- const result = await brief({ project });
36
- // Render as compact human-readable text + structured JSON
37
- const lines = [
38
- `# Brief — ${result.project}`,
39
- `Identity: ${result.identity}`,
40
- result.active_phase ? `Phase: ${result.active_phase}` : "Phase: (none active)",
41
- "",
42
- "## Lifecycle (3 rules)",
43
- result.lifecycle_text,
44
- "",
45
- "## Save triggers",
46
- result.trigger_vocab.join(", "),
47
- ];
48
- if (result.corrections_top.length > 0) {
49
- lines.push("", "## Top P0 corrections");
50
- for (const c of result.corrections_top) {
51
- lines.push(` [${c.severity.toUpperCase()}] ${c.rule}`);
52
- }
53
- }
54
- if (result.watch_for_top.length > 0) {
55
- lines.push("", "## Watch for");
56
- for (const w of result.watch_for_top) {
57
- lines.push(` ${w.pattern} → ${w.suggestion}`);
58
- }
59
- }
60
- if (result.rules_top.length > 0) {
61
- lines.push("", "## Rules");
62
- for (const r of result.rules_top) {
63
- lines.push(` [${r.name}] WHEN ${r.when} → ${r.do}`);
64
- }
65
- }
66
- if (result.store_health) {
67
- lines.push("", `Store: ${result.store_health}`);
68
- }
69
- lines.push("", result.host_hint);
70
- return {
71
- content: [
72
- { type: "text", text: lines.join("\n") },
73
- { type: "text", text: JSON.stringify(result) },
74
- ],
75
- };
76
- });
77
- }
78
- //# sourceMappingURL=brief.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"brief.js","sourceRoot":"","sources":["../../src/tools/brief.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;QAC3B,KAAK,EAAE,OAAO;QACd,WAAW,EACT,mDAAmD;YACnD,2FAA2F;YAC3F,mFAAmF;YACnF,4CAA4C;YAC5C,eAAe;YACf,mFAAmF;YACnF,yEAAyE;QAC3E,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;SAC1F;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;SACnB;KACF,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAExC,0DAA0D;QAC1D,MAAM,KAAK,GAAa;YACtB,aAAa,MAAM,CAAC,OAAO,EAAE;YAC7B,aAAa,MAAM,CAAC,QAAQ,EAAE;YAC9B,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,sBAAsB;YAC9E,EAAE;YACF,wBAAwB;YACxB,MAAM,CAAC,cAAc;YACrB,EAAE;YACF,kBAAkB;YAClB,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;SAChC,CAAC;QAEF,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,uBAAuB,CAAC,CAAC;YACxC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;gBACvC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;YAC/B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;gBACrC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;YAC3B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACjC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QAClD,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAEjC,OAAO;YACL,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACjD,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;aACxD;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}
@@ -1,3 +0,0 @@
1
- import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
- export declare function register(server: McpServer): void;
3
- //# sourceMappingURL=dashboard-export.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"dashboard-export.d.ts","sourceRoot":"","sources":["../../src/tools/dashboard-export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoBhD"}
@@ -1,19 +0,0 @@
1
- import * as z from "zod/v4";
2
- import { dashboardExport } from "agent-recall-core";
3
- export function register(server) {
4
- server.registerTool("dashboard_export", {
5
- title: "Export Memory Dashboard (Agent-Readable + Human-Readable)",
6
- description: "Generate ~/.agent-recall/dashboard.json — a structured all-projects snapshot suitable for " +
7
- "agents to inspect their own memory state in ONE call. Includes per-project pipeline, " +
8
- "correction KPIs (precision / heeded / recurrence), top insights, room salience, skill " +
9
- "count, and a canonical naming index. Schema version 1, stable.",
10
- inputSchema: {
11
- format: z.enum(["json", "both"]).default("json"),
12
- inline_index_limit: z.number().int().min(0).max(2000).default(200),
13
- },
14
- }, async (args) => {
15
- const result = await dashboardExport(args);
16
- return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
17
- });
18
- }
19
- //# sourceMappingURL=dashboard-export.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"dashboard-export.js","sourceRoot":"","sources":["../../src/tools/dashboard-export.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,2DAA2D;QAClE,WAAW,EACT,4FAA4F;YAC5F,uFAAuF;YACvF,wFAAwF;YACxF,gEAAgE;QAClE,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;YAChD,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;SACnE;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1,3 +0,0 @@
1
- import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
- export declare function register(server: McpServer): void;
3
- //# sourceMappingURL=memory-query.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"memory-query.d.ts","sourceRoot":"","sources":["../../src/tools/memory-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgEhD"}
@@ -1,66 +0,0 @@
1
- import * as z from "zod/v4";
2
- import { memoryQuery } from "agent-recall-core";
3
- export function register(server) {
4
- server.registerTool("memory_query", {
5
- title: "Memory Query",
6
- description: "Use when the user asks to search across all memory stores with a natural language query.",
7
- inputSchema: {
8
- query: z.string().optional().describe("Natural language search query. Use this for free-text search like 'corrections.ts P0 regex' or 'what did we decide about auth'."),
9
- intent: z.string().optional().describe("What you are about to do or decide. Alias for query — use either one."),
10
- project: z.string().default("auto"),
11
- min_confidence: z.enum(["high", "medium", "low"]).default("medium").describe("Minimum confidence threshold. 'high' = very relevant only. 'low' = broader, more noise."),
12
- limit: z.number().int().min(1).max(10).default(5),
13
- },
14
- }, async ({ query, intent, project, min_confidence, limit }) => {
15
- const searchIntent = query || intent;
16
- if (!searchIntent) {
17
- return { content: [{ type: "text", text: "Provide either 'query' or 'intent' parameter." }], isError: true };
18
- }
19
- try {
20
- const result = await memoryQuery({ intent: searchIntent, project, min_confidence, limit });
21
- if (result.empty) {
22
- // Bridge (Wave 4): when the primary filter is empty but a low-confidence
23
- // match exists, surface the verbatim drill-down source instead of a bare
24
- // "nothing found" string.
25
- if (result.fallback && result.fallback.length > 0) {
26
- const lines = [
27
- result.guidance ?? "Low-confidence match — verbatim source attached; verify before relying.",
28
- "",
29
- "— Verbatim source (low-confidence drill-down):",
30
- ];
31
- for (const b of result.fallback) {
32
- const snippet = b.verbatim.replace(/\n/g, " ").slice(0, 300);
33
- lines.push(` [${b.source}] ${snippet}`);
34
- }
35
- return { content: [{ type: "text", text: lines.join("\n") }] };
36
- }
37
- return {
38
- content: [{
39
- type: "text",
40
- text: result.guidance ?? `No relevant memory found for: "${searchIntent}". Proceed normally.`,
41
- }],
42
- };
43
- }
44
- const lines = [];
45
- for (let i = 0; i < result.results.length; i++) {
46
- const r = result.results[i];
47
- const conf = r.confidence.toUpperCase().slice(0, 3);
48
- const room = r.room ? `/${r.room}` : "";
49
- const excerpt = r.excerpt ? ` — ${r.excerpt.replace(/\n/g, " ").slice(0, 80)}` : "";
50
- lines.push(`[${i + 1}][${r.source}${room}][${conf}] ${r.title}${excerpt}`);
51
- }
52
- // Feedback nudge
53
- lines.push("");
54
- lines.push("— Rate these on next recall() to improve future ranking:");
55
- lines.push(` IDs: ${result.results.map((r, i) => `${i + 1}=${r.id}`).join(" ")}`);
56
- return { content: [{ type: "text", text: lines.join("\n") }] };
57
- }
58
- catch (err) {
59
- return {
60
- content: [{ type: "text", text: `memory_query failed: ${err instanceof Error ? err.message : String(err)}` }],
61
- isError: true,
62
- };
63
- }
64
- });
65
- }
66
- //# sourceMappingURL=memory-query.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"memory-query.js","sourceRoot":"","sources":["../../src/tools/memory-query.ts"],"names":[],"mappings":"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"}
@@ -1,3 +0,0 @@
1
- import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
- export declare function register(server: McpServer): void;
3
- //# sourceMappingURL=project-board.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"project-board.d.ts","sourceRoot":"","sources":["../../src/tools/project-board.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkBhD"}
@@ -1,22 +0,0 @@
1
- import * as z from "zod/v4";
2
- import { projectBoard, renderBoard } from "agent-recall-core";
3
- export function register(server) {
4
- server.registerTool("project_board", {
5
- title: "Project Status Board",
6
- description: "Use when the user asks to show/list AgentRecall projects, /arstatus, project status board, or what work is active.",
7
- inputSchema: {
8
- format: z.enum(["json", "text"]).default("json"),
9
- },
10
- }, async (args) => {
11
- const result = await projectBoard();
12
- if (args.format === "text") {
13
- const boardWidth = process.stdout.columns
14
- ? Math.min(110, Math.max(80, process.stdout.columns))
15
- : 100;
16
- const text = renderBoard(result, { boardWidth });
17
- return { content: [{ type: "text", text }] };
18
- }
19
- return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
20
- });
21
- }
22
- //# sourceMappingURL=project-board.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"project-board.js","sourceRoot":"","sources":["../../src/tools/project-board.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE;QACnC,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,oHAAoH;QACjI,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;SACjD;KACF,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAChB,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC3B,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO;gBACvC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACrD,CAAC,CAAC,GAAG,CAAC;YACR,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YACjD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CAAC,CAAC;AACL,CAAC"}
@@ -1,3 +0,0 @@
1
- import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
- export declare function register(server: McpServer): void;
3
- //# sourceMappingURL=project-status.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"project-status.d.ts","sourceRoot":"","sources":["../../src/tools/project-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAWhD"}
@@ -1,15 +0,0 @@
1
- import * as z from "zod/v4";
2
- import { projectStatus } from "agent-recall-core";
3
- export function register(server) {
4
- server.registerTool("project_status", {
5
- title: "Project Status",
6
- description: "Optional deeper context for a specific project — call after session_start if you need full status details. Not a replacement for project_board. Returns last trajectory, active blockers, next steps, and palace room freshness.",
7
- inputSchema: {
8
- project: z.string().default("auto"),
9
- },
10
- }, async ({ project }) => {
11
- const result = await projectStatus({ project });
12
- return { content: [{ type: "text", text: JSON.stringify(result) }] };
13
- });
14
- }
15
- //# sourceMappingURL=project-status.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"project-status.js","sourceRoot":"","sources":["../../src/tools/project-status.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE;QACpC,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,kOAAkO;QAC/O,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC;KACF,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAChD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC,CAAC,CAAC;AACL,CAAC"}
@@ -1,3 +0,0 @@
1
- import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
- export declare function register(server: McpServer): void;
3
- //# sourceMappingURL=session-end-reflect.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"session-end-reflect.d.ts","sourceRoot":"","sources":["../../src/tools/session-end-reflect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0BhD"}
@@ -1,25 +0,0 @@
1
- import * as z from "zod/v4";
2
- import { sessionEndReflect } from "agent-recall-core";
3
- export function register(server) {
4
- server.registerTool("session_end_reflect", {
5
- title: "Reflect — Park-style aggregation pass",
6
- description: "Bundle recent journals + active corrections + recent phase syntheses into a " +
7
- "ready-to-use prompt the calling LLM can read to produce: (1) three high-level questions " +
8
- "this period raised, (2) procedural skills to crystallize via skill_write, (3) cross-session " +
9
- "patterns worth promoting, (4) low-precision corrections to archive. " +
10
- "Returns the structured bundle + prompt — does NOT call an LLM itself.",
11
- inputSchema: {
12
- lookback_days: z.number().int().min(1).max(60).default(7),
13
- project: z.string().max(100).default("auto"),
14
- },
15
- }, async (args) => {
16
- const result = await sessionEndReflect(args);
17
- return {
18
- content: [
19
- { type: "text", text: result.prompt },
20
- { type: "text", text: JSON.stringify({ success: result.success, project: result.project, next_actions: result.next_actions, bundle_size: { journals: result.bundle.recent_journals.length, corrections: result.bundle.active_corrections.length, phases: result.bundle.recent_phases.length } }, null, 2) },
21
- ],
22
- };
23
- });
24
- }
25
- //# sourceMappingURL=session-end-reflect.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"session-end-reflect.js","sourceRoot":"","sources":["../../src/tools/session-end-reflect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,uCAAuC;QAC9C,WAAW,EACT,8EAA8E;YAC9E,0FAA0F;YAC1F,8FAA8F;YAC9F,sEAAsE;YACtE,uEAAuE;QACzE,WAAW,EAAE;YACX,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;YACzD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;SAC7C;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC7C,OAAO;YACL,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE;gBAC9C,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;aACrT;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1,3 +0,0 @@
1
- import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
- export declare function register(server: McpServer): void;
3
- //# sourceMappingURL=skill-list.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"skill-list.d.ts","sourceRoot":"","sources":["../../src/tools/skill-list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiBhD"}
@@ -1,16 +0,0 @@
1
- import * as z from "zod/v4";
2
- import { skillList } from "agent-recall-core";
3
- export function register(server) {
4
- server.registerTool("skill_list", {
5
- title: "List All Procedural Skills",
6
- description: "List every procedural skill saved for the project. Returns slug/name/topic/triggers — " +
7
- "use to browse the available how-to library.",
8
- inputSchema: {
9
- project: z.string().max(100).default("auto"),
10
- },
11
- }, async (args) => {
12
- const result = await skillList(args);
13
- return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
14
- });
15
- }
16
- //# sourceMappingURL=skill-list.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"skill-list.js","sourceRoot":"","sources":["../../src/tools/skill-list.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,wFAAwF;YACxF,6CAA6C;QAC/C,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;SAC7C;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1,3 +0,0 @@
1
- import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
- export declare function register(server: McpServer): void;
3
- //# sourceMappingURL=skill-recall.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"skill-recall.d.ts","sourceRoot":"","sources":["../../src/tools/skill-recall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqBhD"}
@@ -1,20 +0,0 @@
1
- import * as z from "zod/v4";
2
- import { skillRecall } from "agent-recall-core";
3
- export function register(server) {
4
- server.registerTool("skill_recall", {
5
- title: "Recall Procedural Skill by Intent",
6
- description: "Find IF-THEN production rules matching your current intent. Call this before starting a " +
7
- "non-trivial task — if a past procedure matches, follow its steps instead of re-deriving. " +
8
- "Returns ranked skills with steps, postconditions, and pitfalls. Trigger-keyword + topic " +
9
- "match (no LLM call, deterministic ranking).",
10
- inputSchema: {
11
- intent: z.string().min(3).max(500).describe("What you're about to do (e.g. 'set up Cloudflare DNS for new domain')."),
12
- limit: z.number().int().min(1).max(20).default(5),
13
- project: z.string().max(100).default("auto"),
14
- },
15
- }, async (args) => {
16
- const result = await skillRecall(args);
17
- return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
18
- });
19
- }
20
- //# sourceMappingURL=skill-recall.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"skill-recall.js","sourceRoot":"","sources":["../../src/tools/skill-recall.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,mCAAmC;QAC1C,WAAW,EACT,0FAA0F;YAC1F,2FAA2F;YAC3F,0FAA0F;YAC1F,6CAA6C;QAC/C,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,wEAAwE,CAAC;YACrH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;YACjD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;SAC7C;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1,3 +0,0 @@
1
- import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
- export declare function register(server: McpServer): void;
3
- //# sourceMappingURL=skill-write.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"skill-write.d.ts","sourceRoot":"","sources":["../../src/tools/skill-write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoChD"}
@@ -1,31 +0,0 @@
1
- import * as z from "zod/v4";
2
- import { skillWrite } from "agent-recall-core";
3
- const SHORT = z.string().min(1).max(200);
4
- const TEXT = z.string().min(1).max(4096);
5
- export function register(server) {
6
- server.registerTool("skill_write", {
7
- title: "Write a Procedural Skill",
8
- description: "Save a reusable IF-THEN production rule (procedural memory). Use when you've solved a problem " +
9
- "via a multi-step procedure that's likely to recur (e.g. Cloudflare 4-step DNS+Proxy+OriginRule+SSL, " +
10
- "git rm --cached for untracked cleanup, OAuth refresh pre-check). Triggers should be intent keywords " +
11
- "another agent would use when asking 'how do I X'. Storage: palace/skills/NNNN-<slug>.md.",
12
- inputSchema: {
13
- name: SHORT.describe("Short human-readable name (e.g. 'Cloudflare 4-step routing')."),
14
- topic: z.string().min(1).max(30).regex(/^[a-z0-9-]+$/, "lowercase kebab-case").describe("Topic / category, kebab-case (e.g. 'deploy', 'git', 'auth')."),
15
- triggers: z.array(z.string().min(1).max(80)).min(1).max(20).describe("Intent keywords that should match this skill — used by skill_recall."),
16
- file_globs: z.array(z.string().max(120)).max(10).optional().describe("Optional file-path globs that boost relevance (e.g. ['**/Cloudflare/*.tf'])."),
17
- when: TEXT.describe("1-sentence trigger condition — when to use this skill."),
18
- preconditions: z.array(z.string().max(400)).max(20).optional().describe("Things that must be true before applying."),
19
- steps: z.array(z.string().min(1).max(400)).min(1).max(50).describe("Ordered steps to execute."),
20
- postconditions: z.array(z.string().max(400)).max(20).optional().describe("Falsifiable success criteria."),
21
- pitfalls: z.array(z.string().max(400)).max(20).optional().describe("Known failure modes."),
22
- evidence: z.array(z.string().max(200)).max(20).optional().describe("Journal dates / commit SHAs / correction ids that led to this."),
23
- source: z.enum(["manual", "promoted_from_correction", "promoted_from_pipeline", "auto_reflection"]).default("manual"),
24
- project: z.string().max(100).default("auto"),
25
- },
26
- }, async (args) => {
27
- const result = await skillWrite(args);
28
- return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
29
- });
30
- }
31
- //# sourceMappingURL=skill-write.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"skill-write.js","sourceRoot":"","sources":["../../src/tools/skill-write.ts"],"names":[],"mappings":"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"}