seshat_get_next_action
Read-onlyIdempotent
Identify the single next permitted action in a governed BI pipeline and check if an intended action is allowed before starting.
Instructions
Return the one action readiness allows now, and refuse anything past it.
Use when: you need the single permitted next step, or want to check an intended action is allowed before starting it. Not for: the full stage picture (use seshat_get_status) or blocker detail (use seshat_explain_blockers). Returns: one allowed action plus forbidden scope, the stop point and the authority required to go further. Outcome is 'blocked' when requested_scope is forbidden or a named-human decision is outstanding. Read-only: names the action but never performs it, and grants no approval.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| table | No | Single table to scope the answer to, matching a table name or its mapping directory (for example 'retail_store_sales'). Omit to cover every onboarded table in the workspace. May not contain '/', '\' or '..'. | |
| workspace | Yes | Path to the local Seshat BI workspace to read. Must resolve to exactly the root this server was started with; a parent or subdirectory is refused. | |
| requested_scope | No | Plain-text action you intend to take, checked against what readiness currently forbids; words longer than three characters are matched, and a collision returns outcome 'blocked' instead of an allowed action. Omit to simply read the allowed action. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||