benthic_playbook
Read-onlyIdempotent
Call once per dataset to get access conventions, authoritative columns, signed join paths, and RPC operations; omit dataset for a routing index. Pass relations to get the signed route hop by hop.
Instructions
Dataset-specific access conventions built from signed metadata and prior sessions.
Call once per dataset before answering a question that depends on domain conventions: which
source to use, which columns are authoritative, which mistakes to avoid, and which signed join
paths and RPC operations exist. Join recipes come from the signed catalog and are never
invented here. Omit dataset for a routing index of every dataset.
To move data between two relations, pass from_relation and to_relation as 'dataset.relation'
instead of a dataset. That returns the signed route hop by hop, shortest first, with the exact
arguments for each benthic_join call, and nothing else. Do this rather than searching
benthic_discover for a join path: a search can be rephrased, so a request for a path that does
not exist comes back looking like a request that was worded wrongly.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dataset | No | ||
| max_hops | No | ||
| to_relation | No | ||
| from_relation | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| core | No | ||
| path | No | ||
| status | Yes | ||
| datasets | No | ||
| warnings | No | ||
| generator | No | ||
| collection | Yes | ||
| generated_at | No | ||
| collection_notes | No | ||
| catalog_fingerprint | No |