recall
Search durable memory and coordination signals by namespace, metadata, or full-text query. Poll for new signals using a cursor for incremental retrieval.
Instructions
Recall matching entries or poll for new signals from the bridge.
Use this tool to search durable memory, filter by metadata, or poll for fresh
coordination signals. For issue-like work, prefer project and domain recall before
external search. For workflow polling, pass since and usually kind="signal".
Returns matching items plus a next_since cursor that can be reused for the next
polling cycle.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Optional type filter. Use `memory` for durable knowledge recall and `signal` for coordination or polling flows. | |
| actor | No | Optional actor filter for entries written by a specific agent or user. | |
| limit | No | Maximum number of entries to return. Smaller values keep context tighter. | |
| query | No | Optional text query for full-text recall. Leave empty to use filter-only retrieval or polling. | |
| since | No | Optional cursor for polling only entries newer than a previously seen entry id. Most useful with `kind="signal"`. | |
| tags_any | No | Optional OR-style tag filter. Any matching tag is enough for an entry to qualify. | |
| namespace | Yes | Namespace to search or poll, such as `project:<workspace>`, `domain:<name>`, or `global`. | |
| session_id | No | Optional session filter to narrow results to one conversation or run. | |
| signal_status | No | Optional status filter for signals. Useful when you want only pending handoffs, currently claimed work, or already-acked coordination events. | |
| correlation_id | No | Optional correlation filter to recall entries linked to the same workflow, handoff, or task. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||