heurchain 2.0.2 → 2.0.3
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/AGENT_CONFIG.json +3 -2
- package/AGENT_ONBOARDING.md +17 -4
- package/package.json +1 -1
package/AGENT_CONFIG.json
CHANGED
|
@@ -170,7 +170,7 @@
|
|
|
170
170
|
"heurchain_store": "Store a fact, decision or concise summary. Store secret references, never passwords, tokens or private reasoning. Supply a stable ID for retries; use memory_update with expected_revision for corrections.",
|
|
171
171
|
"heurchain_search": "Hybrid BM25 + dense vector search. Best for keyword lookups — project names, credential labels, specific identifiers.",
|
|
172
172
|
"heurchain_query": "Semantic similarity search. Best for natural-language retrieval ('what did I decide about authentication?').",
|
|
173
|
-
"heurchain_promote": "
|
|
173
|
+
"heurchain_promote": "Conditionally archive an active memory below the activation threshold, removing it from active retrieval. This is not a retrieval boost or fact confirmation.",
|
|
174
174
|
"heurchain_manifest": "Get a memory summary: total count, per-tag counts, per-agent counts, 10 most-recent items. Call at task start before asking for things already stored.",
|
|
175
175
|
"heurchain_session_start": "Open a session to correlate all store calls in this conversation. Returns a session_id — pass it in metadata.session_id on every store call.",
|
|
176
176
|
"heurchain_session_end": "Close a session. Call at conversation end, then store a session summary tagged 'conversation'.",
|
|
@@ -180,7 +180,8 @@
|
|
|
180
180
|
"heurchain_embed": "Embed text into a dense vector using the server's active embedding model. Use to pre-compute an embedding for query, or to inspect dimensionality.",
|
|
181
181
|
"heurchain_agents": "List agent_ids active in this tenant over the last 7 days, with last-seen time and event counts. Use to discover which agents have been writing memory.",
|
|
182
182
|
"heurchain_vault_stats": "Storage stats for this tenant: vector count, total bytes, size in MB, estimated token count.",
|
|
183
|
-
"heurchain_vault_flush": "
|
|
183
|
+
"heurchain_vault_flush": "Run the tenant consolidation policy to archive eligible active memories. Respects consolidation dry-run; not required to persist writes.",
|
|
184
|
+
"heurchain_vault_rehydrate": "Restore one archived memory by doc_id within the authenticated tenant. Available in tools/list only when the operator enables features.mcp_vault_rehydrate. The HTTP restore route remains admin-only.",
|
|
184
185
|
"heurchain_vault_export": "Export this tenant's stored memories as a zip archive of human-readable Markdown files (embeddings excluded). Use for backup or audit.",
|
|
185
186
|
"heurchain_cache_set": "Store a short-lived key-value pair in the tenant cache (Redis, TTL-backed). For ephemeral state: current session_id, active model, in-progress task ID.",
|
|
186
187
|
"heurchain_cache_get": "Retrieve a value from the tenant cache. Returns {found: false} if absent or expired.",
|
package/AGENT_ONBOARDING.md
CHANGED
|
@@ -250,10 +250,17 @@ other agents have contributed to this tenant's memory.
|
|
|
250
250
|
|
|
251
251
|
Vector count, byte estimate, oldest/newest item timestamps for this tenant.
|
|
252
252
|
|
|
253
|
+
### `POST /promote` (MCP: `heurchain_promote`)
|
|
254
|
+
|
|
255
|
+
Conditionally archives one active memory if its activation is below the configured
|
|
256
|
+
threshold. It is not a retrieval boost: archived memories are not returned by active
|
|
257
|
+
search or query. Use this only to explicitly archive a memory, not to confirm a fact.
|
|
258
|
+
The explicit single-memory operation is not subject to the consolidation dry-run setting.
|
|
259
|
+
|
|
253
260
|
### `POST /vault/flush-working-memory`
|
|
254
261
|
|
|
255
|
-
|
|
256
|
-
|
|
262
|
+
Runs the configured consolidation policy across the tenant's active memories. It is
|
|
263
|
+
not a tag-based delete. It respects consolidation dry-run and is not needed to persist writes.
|
|
257
264
|
|
|
258
265
|
### `GET /vault/export`
|
|
259
266
|
|
|
@@ -269,6 +276,14 @@ Admin-only recovery of one vaulted document. Send a JSON body with a `doc_id` fi
|
|
|
269
276
|
broker restores Redis, BM25, and Qdrant from the preserved embedding and
|
|
270
277
|
returns `duration_ms`. A newer active record returns `409 Conflict`.
|
|
271
278
|
|
|
279
|
+
### `heurchain_vault_rehydrate` (opt-in MCP tool)
|
|
280
|
+
|
|
281
|
+
Restore one archived memory to active retrieval by passing its `doc_id`. The tool
|
|
282
|
+
appears in `tools/list` only when the operator enables `features.mcp_vault_rehydrate`.
|
|
283
|
+
It uses your authenticated tenant and takes no tenant ID or admin credentials. Use
|
|
284
|
+
exact memory inspection first if you only need to read an archived memory. If the tool
|
|
285
|
+
is unavailable, ask the operator to restore the memory using the admin endpoint.
|
|
286
|
+
|
|
272
287
|
---
|
|
273
288
|
|
|
274
289
|
## What to store and when
|
|
@@ -350,8 +365,6 @@ All error responses are JSON: `{ "error": "description" }`.
|
|
|
350
365
|
- If the HeurChain MCP server is configured, prefer MCP tools
|
|
351
366
|
(`mcp__heurchain__heurchain_search`, `mcp__heurchain__heurchain_export`).
|
|
352
367
|
Fall back to direct HTTP if MCP is unavailable.
|
|
353
|
-
- `POST /promote` — increments a memory item's retrieval weight. Call after a
|
|
354
|
-
human confirms a stored fact is correct.
|
|
355
368
|
|
|
356
369
|
---
|
|
357
370
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "heurchain",
|
|
3
|
-
"version": "2.0.
|
|
3
|
+
"version": "2.0.3",
|
|
4
4
|
"description": "Setup guide and agent configuration for the self-hosted HeurChain memory broker (0.6.1-oss.1): persistent, hybrid-search memory shared by every AI agent over MCP or HTTP",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"mcp",
|