recall_search
Read-onlyIdempotent
Search your own memory to retrieve past decisions and guidance before acting. Get actionable advice with trust verdicts, provenance, and abstention when memory has no valid answer.
Instructions
Search the agent's OWN memory before acting, and get actionable guidance.
Call this before proposing an idea, forming a hypothesis, or repeating past work:
if a closed decision or falsified hypothesis surfaces, do not re-litigate it. Every hit
carries a trust verdict (only `ok` hits should be relied on), a calibrated confidence,
provenance (indexed_at) and validity (superseded_by / valid_until). When `abstained` is
true, NO valid hit survived — say you don't know instead of answering from the hits.
`advice` states what to do.
Args:
query: what to recall (natural language).
source: optional source filter (only search one file/source).
k: max hits to return (default 5). Under a fast or quality process profile this is
clamped DOWN to the profile's returned count and is never raised: the cost
profile is chosen per process, not per request.
Returns:
JSON with abstention, calibration status and ID, tenant/generation/pipeline/corpus/
query-set identities, freshness, advice, and hits carrying provenance and verdicts,
plus per-stage timings, `total_ms`, `latency_budget_ms` (null when no budget is
enforced) and `budget_exceeded`.
Raises:
RetrievalOverloaded: the process has no capacity to begin this retrieval within its
latency budget. Retryable and free: nothing was embedded and no state changed.
Carries `reason` (`queue_full` | `budget_exhausted`) and `retry_after_seconds`.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| k | No | ||
| query | Yes | ||
| source | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |