snipara_recall
Read-onlyIdempotent
Retrieve past decisions, learnings, and preferences from project memory. Ask a question to get ranked relevant memories within a specified owner boundary.
Instructions
Semantically recall durable Memory V2 decisions, learnings, preferences, and session carryover within the requested owner boundary. This is a read-only VIEWER operation and changes no memory authority. Use snipara_context_query for source documents and snipara_memories for lifecycle inventory. Returns ranked active memories, optional inactive warnings, authority metadata, and bounded retrieval diagnostics.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task | No | Optional task label recorded for retrieval/outcome correlation. | |
| type | No | Optional durable memory type filter applied before semantic ranking. | |
| limit | No | Maximum memories to return | |
| query | Yes | Memory question such as a past decision, preference, or validated learning | |
| scope | No | Owner boundary to search; scope=agent requires agent_id and scope=user may use external_user_id. | |
| agent_id | No | Required when scope=agent; limits recall to one agent namespace | |
| category | No | Filter by category | |
| min_relevance | No | Minimum relevance score (0-1) | |
| external_user_id | No | Integrator client keys only: stable end-user ID for scope=user recall. Snipara hashes and namespaces it per integrator client. | |
| include_inactive | No | Include inactive memories in the main result set | |
| warning_threshold | No | Minimum relevance score for inactive-memory warnings | |
| correlation_context | No | Optional retrieval-correlation context. Reuse session_id across retrieval and outcome calls so telemetry can be joined inside the authenticated project. These identifiers never change authorization or project scope; do not include secrets, tenant IDs, or user data. | |
| outcome_rerank_mode | No | Optional bounded memory-outcome rerank mode. Omission uses the server configuration; a request cannot escalate beyond it. |