Skip to content

Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors

Rust

docs: clarify manual handoff attribution (#284)

AkitaOnRails0cbd94aec783
diff --git a/CHANGELOG.md b/CHANGELOG.md
index a0e94d1f..a95ab08c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,9 +14,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
event ends one execution loop rather than the conversation, so it remains a
normal observation; the explicit command closes the latest scoped session
through the canonical SessionEnd path, producing its summary and automatic
- handoff and queueing opt-in consolidation. The docs also clarify why a
- manual MCP handoff over Antigravity's static HTTP connection has no dynamic
- session attribution. (#284)
+ handoff and queueing opt-in consolidation. The docs also clarify that
+ `memory_handoff_begin` deliberately creates a session-neutral, project-wide
+ manual handoff for every MCP client; attributed handoffs come from canonical
+ SessionEnd processing. (#284)
## [1.19.1] - 2026-07-27
diff --git a/docs/mcp-install.md b/docs/mcp-install.md
index f8425d81..ba3ae60e 100644
--- a/docs/mcp-install.md
+++ b/docs/mcp-install.md
@@ -490,13 +490,12 @@ The rendered hooks config looks like:
the conversation. After the final turn, run
`ai-memory finalize-session --agent antigravity-cli` to create the final
summary and automatic handoff and to queue opt-in SessionEnd consolidation.
-- A manual `memory_handoff_begin` call over Antigravity's static HTTP MCP
- connection cannot carry the hook's dynamic `conversationId`. The resulting
- project-wide handoff therefore has no `from_session_id` and uses
- `from_agent = other`; this is expected. The explicit finalizer selects the
- latest scoped Antigravity session instead. ai-memory does not guess session
- attribution for arbitrary MCP calls because concurrent conversations could
- be assigned to one another.
+- `memory_handoff_begin` always creates an explicit, project-wide manual
+ handoff with no `from_session_id` and `from_agent = other`; that
+ session-neutral shape is the same for every MCP client. Handoffs carrying a
+ Codex or Claude session id came from canonical SessionEnd processing, not
+ from the manual tool. Use the explicit Antigravity finalizer when the
+ session itself must end and produce an attributed automatic handoff.
- The built-in `/web` route displays compiled wiki pages, not raw session or
observation rows. To verify hook capture, compare the `sessions` and
`observations` counts from `ai-memory status` before and after a prompt.