record_outcome
Record a task's success, failure, or partial outcome so past results inform future sessions; failures with a cause become lessons for similar tasks.
Instructions
Record the outcome of a task you just executed (episodic memory). Call this after finishing a task so past successes and failures can inform future sessions. Status must be 'success', 'failure', or 'partial'. Failures with a cause are reflected into lessons that get injected into similar future tasks. Repeated calls for the same session/outcome are deduped rather than creating a second episode. Use infer_outcome instead when the host supplies structured evidence rather than a transcript; use add_evidence to attach provenance to an existing memory. Returns status (recorded | duplicate), the episode id, and any distilled lesson. Requires agent auth when the agent has a registered key.
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": {
"task": "<task>",
"status": "<status>"
},
"name": "record_outcome"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Tags for categorization | |
| task | Yes | What task was executed (kept verbatim for retrieval) | |
| cause | No | Attribution of the outcome, when known | |
| status | Yes | Outcome status: success, failure, or partial | |
| api_key | No | API key for agent authentication (required if agent has a registered key) | |
| agent_id | No | ID of the agent reporting this outcome | unknown |
| skill_id | No | ID of the skill memory the agent followed, if any — attributes this outcome to the skill's success/failure statistics | |
| namespace | No | Namespace for the episode memory (default: global) | global |
| task_type | No | Coarse task category for lesson matching (e.g. deploy, debug, refactor) | |
| agent_type | No | Type of the agent (e.g., coding-assistant) | general-assistant |
| session_id | No | Session the task ran in, for traceability |