List signals
list_signalsFind work and changes: the scoped queue of signals (typed events) with severity, state, objects and aggregate payloads. Use it for the work queue and for what changed since a timestamp (since); use list_findings for documented discrepancies. Follow a signal up with get_task_context; when ready, take it with take_signal before you work on it and report with record_action. Lease expiry and reopening keep created_at, so also poll states [open] without since for available work; next_cursor paginates. Rules are judged per group by every scan as it finishes: one rule_fired per matching group (by_rule rolls this page's open ones up per rule), rule_broken when unjudgeable; the first evaluation is a quiet baseline, and a live check may raise rule_cleared. Legacy notice kinds remain readable. unacted and the states distinguish open work, plans, holds and completed episodes. Details: maplith://docs/signals-and-rules.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kinds | No | Only these signal kinds, named as the enum lists them (the kinds this workspace can raise). Omit for every kind. | |
| limit | No | Signals per page. Default 100; up to 500 for a key that sees the whole map, up to 100 for a key limited to part of it. | |
| order | No | newest (default): newest first. urgency: urgent, then attention, then info, newest first within each; pass the same order with its cursor. | |
| since | No | ISO 8601 timestamp — only signals created after it. | |
| cursor | No | The next_cursor from the previous call. | |
| states | No | Only signals in these states, as your key sees them: open (not picked up), planned (open, planned by someone), in_progress (held by an agent or a person), done (settled). | |
| unacted | No | Only signals still to be dealt with: open, planned or in_progress (including ones another agent holds or that wait on a person). For only the work nobody has picked up, pass states: ["open"] instead. For a key limited to part of the map, a close counts only when that key may see the record behind it: one made without the signal's current version, or while the signal named objects outside the key, does not, so such a signal still comes back as open. | |
| exclude_kinds | No | Leave these kinds out, e.g. ['setup_gap'] when you review findings. |