ck_memory_record
Write governed memory records to persist knowledge across sessions. Supports structured records with types like decision, finding, proof, goal, and brief for future retrieval.
Instructions
Write a governed memory record so future agents can explicitly retrieve it via ck_memory_search. Write operation — persists to the database. Idempotent: re-submitting the same source_id updates the existing record rather than duplicating it. Pass memory as a plain string for quick notes, or as an object with body, title, summary, record_type, and tags for structured records. record_type controls retrieval filtering: use decision for architectural choices, finding for issues, proof for evidence, goal for intent, brief for task context. tags is a string or array of strings for categorization. source_id links the record to an external artifact (e.g., a review ID or commit SHA). Use ck_memory_record to persist knowledge that should survive session boundaries. Use ck_finding for policy violations with a ruling decision. Use ck_goal for durable multi-session intent.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | Full content body with detailed information. | |
| memory | Yes | ||
| metadata | No | ||
| project_root | No | Absolute path to the project root directory on the local filesystem. | |
| record_type | No | Record type classification. | |
| session_id | No | Unique session identifier for correlating findings, proofs, budget, and audit trail. | |
| source_id | No | Unique identifier of the source system or record. | |
| source_type | No | Origin category of the record (e.g., developer, tool_output, human_review). | |
| summary | No | Brief human-readable summary of the record. | |
| tags | No | ||
| task_id | No | Task identifier within the session for scoped operations. | |
| title | No | Human-readable title for display and search. |