lbb_inspect
Read graph context and exact facts: inspect entities, edges, state, history, and validate ontology conformance.
Instructions
Read graph context and exact graph facts. Actions: guide, ontology, ontology_conformance, schema, schema_preview, schema_audit, rules, ontology_search, metadata, entity, edges, state, history, transitions, why, traverse. entity returns one node's metadata, scalar attributes, current state, edges, history, and observations — its edge/history arrays are a display sample capped at the detail limit (counts holds the true totals), so on a high-degree node the response carries an edge_sample block with the capped totals and ready-to-run paged reads; follow those (or call edges/history directly, paged by row_limit/offset with direction/relation filters and an as_of/as_of_commit_seq pin) to read the full set — total_count tells you when to stop. transitions returns the ordered state-transition log of an entity's relation with dwell time at each value (cycle-time/process analysis). metadata includes temporal_coverage — check it before attempting as-of/daily views: as_of_valid_time_degenerate or single_commit_time means every point-in-time query returns the same snapshot. Use ontology_conformance to check the live data against the ontology's own capped-cardinality rules (derived SHACL sh:maxCount, whole-snapshot, never blocks a write) — distinct from schema_audit, which runs the separately-published SHACL shape bundle.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| as_of | No | Valid-time snapshot pin (RFC3339): reproduce the node as of this instant. | |
| graph | No | Graph to target; defaults to the connection's graph | |
| query | No | Ontology concept, term, or relation to search | |
| top_k | No | ||
| action | Yes | Selects the variant (one of: guide, ontology, ontology_conformance, schema, schema_audit, rules, schema_preview, ontology_search, metadata, entity, edges, state, history, why, traverse, transitions). | |
| branch | No | Branch to target; defaults to the connection's branch | |
| cursor | No | Opaque cursor from the previous page's `next_cursor`. The response is the unified list envelope { object:'list', data, has_more, next_cursor, total_count }; page a high-degree node (entity detail hard-caps its edge sample) by feeding next_cursor back here until has_more is false. Each row carries valid_time for a per-edge timeline. | |
| detail | No | Response detail level. Defaults to compact. | |
| offset | No | Legacy alias for `cursor` (still accepted); prefer paging with `cursor`. | |
| shapes | No | ||
| max_hops | No | ||
| ontology | No | ||
| relation | No | Filter to a single relation name. | |
| direction | No | Edges out of / into / touching the entity (default both). | |
| entity_id | No | Entity id (hex); alternative to entity_type+name | |
| relations | No | ||
| row_limit | No | Max edges returned this page (server caps at 1000; default 150). | |
| entity_type | No | ||
| source_name | No | ||
| source_type | No | ||
| target_name | No | ||
| target_type | No | ||
| desired_mode | No | ||
| as_of_commit_seq | No | Snapshot pin: reproduce the node (state, edges, history) as of this commit_seq. | |
| base_shapes_version | No | ||
| base_ontology_version | No |