All tools
ToolWrite
Record research checkpoint
record_research_checkpointThe user explicitly asks Prism to retain, correct, or forget durable workspace context.
When to use it
The user explicitly asks Prism to retain, correct, or forget durable workspace context.
Typical workflow
Read context, list durable memory when stable ids are needed, then remember only explicit durable facts or preferences; correct or forget by stable memory id.
What it returns
Bounded memory records with stable ids, or the created, superseded, review-gated, suppressed, or purged workspace-memory result.
Avoid using it when
The information is transient, inferred without confirmation, or belongs in a source document instead of memory.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View JSON Schema
{
"type": "object",
"properties": {
"folderId": {
"type": "string",
"format": "uuid"
},
"sessionId": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"checkpointSequence": {
"type": "integer",
"minimum": 0
},
"visibility": {
"type": "string",
"enum": [
"project_memory",
"client_private"
]
},
"expectedPreviousEventId": {
"type": "string",
"format": "uuid"
},
"contextRunId": {
"type": "string",
"format": "uuid"
},
"objective": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"summary": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"conclusionRefs": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object"
}
},
"proposedMemories": {
"type": "array",
"maxItems": 10,
"items": {
"type": "object"
}
},
"openQuestions": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object"
}
},
"nextSteps": {
"type": "array",
"maxItems": 10,
"items": {
"type": "string",
"maxLength": 500
}
},
"evidenceRefs": {
"type": "array",
"maxItems": 30,
"items": {
"type": "object"
}
},
"status": {
"type": "string",
"enum": [
"in_progress",
"completed",
"interrupted"
]
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"additionalProperties": false
}