chore: import upstream snapshot with attribution

2026-07-13 13:01:18 +08:00
commit 979fb22d7c
613 changed files with 113494 additions and 0 deletions
@@ -0,0 +1,129 @@
+# agentmemory REST API reference
+
+Generated from `src/triggers/api.ts`. Do not edit the block below by hand; run `npm run skills:gen` after changing the registered endpoints.
+
+<!-- AUTOGEN:rest START - generated by scripts/skills/generate.ts, do not edit by hand -->
+The REST API is the primary surface. All paths are under `http://localhost:3111` (override with `--port`). When `AGENTMEMORY_SECRET` is set, send `Authorization: Bearer $AGENTMEMORY_SECRET`; localhost is otherwise open.
+
+117 registered endpoints:
+
+| Method | Path |
+| --- | --- |
+| POST | `/agentmemory/actions` |
+| POST | `/agentmemory/actions/edges` |
+| GET | `/agentmemory/actions/get` |
+| POST | `/agentmemory/actions/update` |
+| GET | `/agentmemory/audit` |
+| POST | `/agentmemory/auto-forget` |
+| GET | `/agentmemory/branch/detect` |
+| GET | `/agentmemory/branch/sessions` |
+| GET | `/agentmemory/branch/worktrees` |
+| POST | `/agentmemory/cascade-update` |
+| POST | `/agentmemory/checkpoints` |
+| POST | `/agentmemory/checkpoints/resolve` |
+| GET | `/agentmemory/claude-bridge/read` |
+| POST | `/agentmemory/claude-bridge/sync` |
+| GET | `/agentmemory/commits` |
+| POST | `/agentmemory/compress-file` |
+| GET | `/agentmemory/config/flags` |
+| POST | `/agentmemory/consolidate` |
+| POST | `/agentmemory/consolidate-pipeline` |
+| POST | `/agentmemory/context` |
+| GET | `/agentmemory/crystals` |
+| POST | `/agentmemory/crystals/auto` |
+| POST | `/agentmemory/crystals/create` |
+| POST | `/agentmemory/diagnostics` |
+| GET | `/agentmemory/diagnostics/followup` |
+| POST | `/agentmemory/diagnostics/heal` |
+| POST | `/agentmemory/enrich` |
+| POST | `/agentmemory/evict` |
+| POST | `/agentmemory/evolve` |
+| GET | `/agentmemory/export` |
+| POST | `/agentmemory/facets` |
+| POST | `/agentmemory/facets/query` |
+| POST | `/agentmemory/facets/remove` |
+| GET | `/agentmemory/facets/stats` |
+| POST | `/agentmemory/file-context` |
+| POST | `/agentmemory/flow/compress` |
+| POST | `/agentmemory/forget` |
+| GET | `/agentmemory/frontier` |
+| POST | `/agentmemory/generate-rules` |
+| POST | `/agentmemory/governance/bulk-delete` |
+| DELETE | `/agentmemory/governance/memories` |
+| POST | `/agentmemory/graph/build` |
+| POST | `/agentmemory/graph/extract` |
+| POST | `/agentmemory/graph/query` |
+| POST | `/agentmemory/graph/reset` |
+| POST | `/agentmemory/graph/snapshot-rebuild` |
+| GET | `/agentmemory/graph/stats` |
+| GET | `/agentmemory/health` |
+| POST | `/agentmemory/import` |
+| GET | `/agentmemory/insights` |
+| POST | `/agentmemory/insights/search` |
+| POST | `/agentmemory/leases/acquire` |
+| POST | `/agentmemory/leases/release` |
+| POST | `/agentmemory/leases/renew` |
+| POST | `/agentmemory/lessons` |
+| POST | `/agentmemory/lessons/search` |
+| POST | `/agentmemory/lessons/strengthen` |
+| GET | `/agentmemory/livez` |
+| GET | `/agentmemory/memories` |
+| GET | `/agentmemory/memories/:id` |
+| GET | `/agentmemory/mesh/export` |
+| POST | `/agentmemory/mesh/peers` |
+| POST | `/agentmemory/mesh/receive` |
+| POST | `/agentmemory/mesh/sync` |
+| POST | `/agentmemory/migrate` |
+| GET | `/agentmemory/next` |
+| GET | `/agentmemory/observations` |
+| POST | `/agentmemory/observe` |
+| POST | `/agentmemory/obsidian/export` |
+| POST | `/agentmemory/patterns` |
+| GET | `/agentmemory/procedural` |
+| GET | `/agentmemory/profile` |
+| POST | `/agentmemory/reflect` |
+| POST | `/agentmemory/relations` |
+| POST | `/agentmemory/remember` |
+| POST | `/agentmemory/replay/import-jsonl` |
+| GET | `/agentmemory/replay/load` |
+| GET | `/agentmemory/replay/sessions` |
+| POST | `/agentmemory/routines` |
+| POST | `/agentmemory/routines/run` |
+| GET | `/agentmemory/routines/status` |
+| POST | `/agentmemory/search` |
+| GET | `/agentmemory/semantic` |
+| POST | `/agentmemory/sentinels` |
+| POST | `/agentmemory/sentinels/cancel` |
+| POST | `/agentmemory/sentinels/check` |
+| POST | `/agentmemory/sentinels/trigger` |
+| GET | `/agentmemory/session/by-commit` |
+| POST | `/agentmemory/session/commit` |
+| POST | `/agentmemory/session/end` |
+| POST | `/agentmemory/session/start` |
+| GET | `/agentmemory/sessions` |
+| GET | `/agentmemory/signals` |
+| POST | `/agentmemory/signals/send` |
+| POST | `/agentmemory/sketches` |
+| POST | `/agentmemory/sketches/add` |
+| POST | `/agentmemory/sketches/discard` |
+| POST | `/agentmemory/sketches/gc` |
+| POST | `/agentmemory/sketches/promote` |
+| GET | `/agentmemory/slot` |
+| POST | `/agentmemory/slot/append` |
+| POST | `/agentmemory/slot/reflect` |
+| POST | `/agentmemory/slot/replace` |
+| GET | `/agentmemory/slots` |
+| POST | `/agentmemory/smart-search` |
+| POST | `/agentmemory/snapshot/create` |
+| POST | `/agentmemory/snapshot/restore` |
+| GET | `/agentmemory/snapshots` |
+| POST | `/agentmemory/summarize` |
+| GET | `/agentmemory/team/feed` |
+| GET | `/agentmemory/team/profile` |
+| POST | `/agentmemory/team/share` |
+| POST | `/agentmemory/timeline` |
+| POST | `/agentmemory/verify` |
+| GET | `/agentmemory/viewer` |
+| POST | `/agentmemory/vision-embed` |
+| POST | `/agentmemory/vision-search` |
+<!-- AUTOGEN:rest END -->
@@ -0,0 +1,43 @@
+---
+name: agentmemory-rest-api
+description: The agentmemory HTTP REST API surface, the primary protocol for talking to the memory server. Use when calling agentmemory over HTTP, when MCP is unavailable and you need a fallback, or when integrating a host that does not speak MCP.
+user-invocable: false
+---
+
+REST is agentmemory's primary surface. MCP is a bridge on top of it. Every memory operation has an HTTP endpoint under `http://localhost:3111/agentmemory/*`.
+
+## Quick start
+
+```bash
+# liveness
+curl -fsS http://localhost:3111/agentmemory/livez
+
+# save
+curl -X POST http://localhost:3111/agentmemory/remember \
+  -H "Content-Type: application/json" \
+  -d '{"content":"chose JWT refresh rotation","concepts":["jwt-refresh-rotation"]}'
+
+# recall
+curl -X POST http://localhost:3111/agentmemory/smart-search \
+  -H "Content-Type: application/json" \
+  -d '{"query":"auth token strategy","limit":5}'
+```
+
+## Auth
+
+By default localhost is open and no auth is needed. When `AGENTMEMORY_SECRET` is set, every request needs `Authorization: Bearer $AGENTMEMORY_SECRET`. See agentmemory-config.
+
+## Conventions
+
+- Save returns `201`, reads return `200`, validation errors return `400`.
+- Handlers whitelist body fields and drop unknown ones, so passing extra keys is safe but ignored.
+- The port is configurable with `--port` or `--instance`; streams, viewer, and engine derive from it.
+
+## See also
+
+- agentmemory-mcp-tools for the MCP equivalents.
+- agentmemory-config for the port quartet and the secret.
+
+## Reference
+
+The full endpoint list with methods lives in REFERENCE.md, generated from `src/triggers/api.ts`.