Learn a lesson
memory_learnStore the lesson from a completed task together with its trace and feedback, so future searches return only the lesson and withdrawing supporting evidence stops it being served.
Instructions
After a task, store the lesson drawn from it, with the task trace and the feedback it got kept as its provenance. Only the lesson is returned by searches; withdrawing the trace or the feedback stops serving the lesson. For a fact the user states, use memory_remember.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"trace": "<trace>",
"feedback": "<feedback>",
"lesson": "<lesson>"
},
"name": "memory_learn"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | observation for a fact, document for a text, procedure for how to do something, task, feedback, or hypothesis for a guess nobody confirmed. | |
| trace | Yes | What was done: steps, commands or a summary of them. | |
| lesson | Yes | The rule to apply next time, self-contained. | |
| aliases | No | Short names to find it again. | |
| feedback | Yes | What the user or a check said about the result. | |
| lesson_id | No | Stable name you choose. Leave out to get one. | |
| confidence | No | Declared, not computed. Leave out unless the user gave one. | |
| valid_from | No | UTC time it starts to apply, e.g. 2026-01-31T00:00:00Z. Leave out unless the user gave one; by default it applies now. | |
| valid_until | No | UTC time after which it no longer applies. Leave out unless the user gave one. | |
| preconditions | No | Exact conditions a search must supply to see it. Leave out unless the user said it only holds under a condition: a search without these conditions will not return it. |