Search Documentation
Search across all documentation pages
context_checkpoint
End-of-session checkpoint. Provide a sessionSummary describing what happened, decisions made, and open threads. Optionally include memories to bulk-save. The summary is stored as an episodic memory for future sessions.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| sessionSummary | string | required | Narrative summary of what happened this session — what was discussed, decided, and accomplished. Saved as an episodic memory. Do NOT write tool call stats — describe the work in human terms. |
| memories | array | required | Array of memories to save (0-50). Can be empty when only sessionSummary is provided. Each memory object supports: content (string, required), memoryType (enum, optional), summary (string, optional), importance (int 1-5, optional), confidence (int 1-5, optional), entities (string[], optional), writeReason (string, optional), relatedMemoryIds (array, optional), sourceNoteIds (uuid[], optional), supersededById (uuid, optional). |
| vaultId | string (UUID) | optional | Vault/project scope for all memories. Required unless defaultVaultId is configured. |
| agentId | string | optional | Agent identifier |
| modelId | string | optional | Model used |
| agentRunId | string | optional | Run ID for checkpoint idempotency |
| dedup | boolean | optional | Run semantic dedup per memory (default true) |
Returns#
Confirmation of the checkpoint with the number of memories saved and the episodic memory ID for the session summary.
Example#
json
{
"tool": "context_checkpoint",
"arguments": {
"sessionSummary": "Refactored the authentication module to support OAuth2. Decided to use PKCE flow for public clients. Next step: implement token refresh logic.",
"memories": [
{
"content": "Authentication module now supports OAuth2 with PKCE flow for public clients.",
"memoryType": "fact",
"importance": 4,
"entities": ["auth-module", "OAuth2", "PKCE"]
}
],
"dedup": true
}
}