feedback
Record evaluations of recalled memory results by submitting vote, correction, or retraction with outcome and optional reason to improve retrieval quality.
Instructions
Record structured retrieval feedback for one recalled memory result.
Evidence is append-only/shadow-only. Provenance is caller-declared and not authenticated. This tool does not mutate memory records, recall results, or ranking behavior.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | No | Optional compact reason. Required for `misleading` and `outdated` outcomes. | |
| outcome | No | Declared retrieval outcome. Required for votes and corrections; optional for retractions. | |
| memory_id | Yes | Exact recalled memory id being evaluated. | |
| namespace | Yes | Namespace used by the recall receipt, such as `project:<workspace>` or `global`. | |
| provenance | No | Optional declared provenance fields such as source_app, source_client, source_model, client_session_id, client_workspace, client_transport, or actor. | |
| result_rank | Yes | One-based rank of the memory in the recalled result list. | |
| feedback_type | No | Append-only feedback event type. Defaults to a root vote. | vote |
| recall_receipt | Yes | Signed recall receipt token returned by a durable memory text `recall` response. | |
| supersedes_feedback_id | No | Current feedback head id. Required for corrections and retractions; omitted for root votes. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||