memory_capture
Capture verbatim conversational turns into long-term memory, auto-deduplicating near-duplicates. Use it to save corrections, decisions, and observations, with optional role, tier, and agent tracking.
Instructions
Capture a verbatim turn (auto-dedups near-duplicates). Use for corrections, not for minting standing-order directives.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cue | No | Short natural-language cue used for embedding + dedup lookup. If empty, `text` itself is embedded. | |
| role | No | Who produced this turn — tags the record for filtering. | user |
| text | Yes | Verbatim text to capture (user utterance, Claude decision, or observation). Min 12 chars, max 8000 (longer is truncated). | |
| tier | No | Memory tier. Default 'episodic' (verbatim user utterances). Use 'semantic' for induced summaries, 'procedural' for learned behaviour notes. | episodic |
| focus | No | Optional current point of attention for the live session task. Folded verbatim onto this session's own working-tier entry after the capture completes, alongside next_action. | |
| agent_id | No | Optional id of a background agent this capture is spawning or completing. Combine with agent_role and agent_expected_artifact to register a pending agent; combine with agent_complete_id on a later call to mark it done. | |
| agent_role | No | Optional role of the spawned background agent (for example 'research' or 'implement'). Required alongside agent_id and agent_expected_artifact to register a spawn; omitted otherwise. | |
| session_id | No | Current session id for provenance. | |
| agent_model | No | Optional model label for the spawned background agent, recorded on the registry entry when agent_id/agent_role/agent_expected_artifact register a spawn. | |
| next_action | No | Optional immediate next step for the current live session task. Folded verbatim onto this session's own working-tier entry after the capture completes; surfaces at the next session start and on every subsequent turn until updated again. | |
| salience_level | No | Caller-declared salience level for a decision, correction, or load-bearing preference marked in-turn. Additive rank-fusion boost only -- never a merge/drop lock. Omit for 'unflagged' (default, no behavior change). A value outside the enum is coerced to 'unflagged' server-side, never rejected. | unflagged |
| epistemic_status | No | Caller-declared epistemic status. Omit for 'unknown' (default, no behavior change). A value outside the enum is coerced to 'unknown' server-side, never rejected. | unknown |
| agent_complete_id | No | Optional id of a previously spawned background agent to mark complete on this call. | |
| agent_expected_artifact | No | Optional artifact the spawned background agent is expected to produce. Required alongside agent_id and agent_role to register a spawn; omitted otherwise. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | No | ||
| status | No | ||
| record_id | No |