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.
- package/README.md +111 -53
- package/dist/index.js +1 -1
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +5 -2
- package/dist/server.js.map +1 -1
- package/dist/tools/check.d.ts.map +1 -1
- package/dist/tools/check.js +4 -3
- package/dist/tools/check.js.map +1 -1
- package/package.json +4 -4
- package/dist/tools/bootstrap.d.ts +0 -3
- package/dist/tools/bootstrap.d.ts.map +0 -1
- package/dist/tools/bootstrap.js +0 -148
- package/dist/tools/bootstrap.js.map +0 -1
- package/dist/tools/brief.d.ts +0 -18
- package/dist/tools/brief.d.ts.map +0 -1
- package/dist/tools/brief.js +0 -78
- package/dist/tools/brief.js.map +0 -1
- package/dist/tools/dashboard-export.d.ts +0 -3
- package/dist/tools/dashboard-export.d.ts.map +0 -1
- package/dist/tools/dashboard-export.js +0 -19
- package/dist/tools/dashboard-export.js.map +0 -1
- package/dist/tools/memory-query.d.ts +0 -3
- package/dist/tools/memory-query.d.ts.map +0 -1
- package/dist/tools/memory-query.js +0 -66
- package/dist/tools/memory-query.js.map +0 -1
- package/dist/tools/project-board.d.ts +0 -3
- package/dist/tools/project-board.d.ts.map +0 -1
- package/dist/tools/project-board.js +0 -22
- package/dist/tools/project-board.js.map +0 -1
- package/dist/tools/project-status.d.ts +0 -3
- package/dist/tools/project-status.d.ts.map +0 -1
- package/dist/tools/project-status.js +0 -15
- package/dist/tools/project-status.js.map +0 -1
- package/dist/tools/session-end-reflect.d.ts +0 -3
- package/dist/tools/session-end-reflect.d.ts.map +0 -1
- package/dist/tools/session-end-reflect.js +0 -25
- package/dist/tools/session-end-reflect.js.map +0 -1
- package/dist/tools/skill-list.d.ts +0 -3
- package/dist/tools/skill-list.d.ts.map +0 -1
- package/dist/tools/skill-list.js +0 -16
- package/dist/tools/skill-list.js.map +0 -1
- package/dist/tools/skill-recall.d.ts +0 -3
- package/dist/tools/skill-recall.d.ts.map +0 -1
- package/dist/tools/skill-recall.js +0 -20
- package/dist/tools/skill-recall.js.map +0 -1
- package/dist/tools/skill-write.d.ts +0 -3
- package/dist/tools/skill-write.d.ts.map +0 -1
- package/dist/tools/skill-write.js +0 -31
- 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>
|
|
6
|
-
|
|
7
|
-
<p align="center">
|
|
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/
|
|
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/%
|
|
25
|
-
<a href="#the-session-loop"><img src="https://img.shields.io/badge/%
|
|
26
|
-
<a href="#the-session-loop"><img src="https://img.shields.io/badge/%
|
|
27
|
-
<a href="#the-session-loop"><img src="https://img.shields.io/badge/%
|
|
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
|
|
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
|
|
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
|
-
|
|
69
|
+
Most agent memory tools claim "never repeats the same mistake." None of them publish a number for it.
|
|
61
70
|
|
|
62
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
92
|
+
## Why this is different from every other memory tool
|
|
75
93
|
|
|
76
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
-
|
|
|
163
|
-
| `/
|
|
164
|
-
|
|
|
165
|
-
| `/
|
|
166
|
-
|
|
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
|
-
|
|
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
|
-
##
|
|
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
|
-
##
|
|
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
|
-
|
|
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
|
|
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 |
|
|
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
|
|
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 —
|
|
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):
|
package/dist/server.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,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
|
-
|
|
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
|
package/dist/server.js.map
CHANGED
|
@@ -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;
|
|
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,
|
|
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"}
|
package/dist/tools/check.js
CHANGED
|
@@ -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) {
|
package/dist/tools/check.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/tools/check.ts"],"names":[],"mappings":"AACA,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,qBAAqB;QAC5B,WAAW,EAAE,
|
|
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.
|
|
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.
|
|
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-
|
|
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-
|
|
66
|
+
"homepage": "https://github.com/Goldentrii/AgentRecall-X#readme"
|
|
67
67
|
}
|
|
@@ -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"}
|
package/dist/tools/bootstrap.js
DELETED
|
@@ -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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"}
|
package/dist/tools/brief.d.ts
DELETED
|
@@ -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"}
|
package/dist/tools/brief.js
DELETED
|
@@ -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
|
package/dist/tools/brief.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"brief.js","sourceRoot":"","sources":["../../src/tools/brief.ts"],"names":[],"mappings":"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"}
|
|
@@ -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 +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 +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 +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 +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 +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"}
|
package/dist/tools/skill-list.js
DELETED
|
@@ -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 +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 +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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"}
|