Pure read-side substrate shared by every rendering of a run. It loads canonical SQLite facts plus BlobStore payloads into an addressable node tree.
Addresses are the whole point of the recursive read: every node has a path like
root, root/child-0001, root/child-0001/child-0004. A renderer shows a node
plus the addresses of its children, and the caller drills by re-issuing with the
child's address. Same scheme on the CLI and (later) in the TUI.
Pure read-side substrate shared by every rendering of a run. It loads canonical SQLite facts plus BlobStore payloads into an addressable node tree. Addresses are the whole point of the recursive read: every node has a path like `root`, `root/child-0001`, `root/child-0001/child-0004`. A renderer shows a node plus the addresses of its children, and the caller drills by re-issuing with the child's address. Same scheme on the CLI and (later) in the TUI.
(child-calls {:keys [calls]})Calls that spawned a child session, in spawn order.
Calls that spawned a child session, in spawn order.
(child-locator parent-locator call)Canonical locator for a child call.
Canonical locator for a child call.
(event-chain locator event-id)Causal ancestors plus the requested event, in causal order.
Causal ancestors plus the requested event, in causal order.
(event-stream locator)Canonical event stream for a session locator, in append order.
Canonical event stream for a session locator, in append order.
(event-trace locator)Operator-facing audit trace for a session locator.
This derives summaries and causal refs from compact canonical event rows plus typed row metadata. It never reads raw payload blobs and is not used for restore.
Operator-facing audit trace for a session locator. This derives summaries and causal refs from compact canonical event rows plus typed row metadata. It never reads raw payload blobs and is not used for restore.
(history-view locator)Audit view for all facts/events ever recorded for the session.
Audit view for all facts/events ever recorded for the session.
(leaves locator {:keys [calls]})Leaf calls with their input and result resolved from refs. Ordered by batch index then call id.
Leaf calls with their input and result resolved from refs. Ordered by batch index then call id.
(load-at root-locator address)Load the full node at address within the run rooted at root-locator. nil if
the address doesn't resolve.
Load the full node at `address` within the run rooted at `root-locator`. nil if the address doesn't resolve.
(load-node locator)(load-node locator address)Build ONE node at address from a session locator. Heavy fields (steps, leaves,
resolved final) are realized; children are returned as lightweight refs
(address + label + locator) so a node load is one head-state read, not a whole subtree.
Drill into a child by calling load-at with the child address.
Build ONE node at `address` from a session locator. Heavy fields (steps, leaves, resolved final) are realized; children are returned as lightweight *refs* (address + label + locator) so a node load is one head-state read, not a whole subtree. Drill into a child by calling `load-at` with the child address.
(node-locator root-locator address)Resolve a node address ("root", "root/child-0001", "root/child-0001/child-0004") to its canonical locator, starting from the root session locator. Returns nil if any segment doesn't resolve. The first segment ("root") names the root session.
Resolve a node address ("root", "root/child-0001", "root/child-0001/child-0004")
to its canonical locator, starting from the root session locator. Returns nil if
any segment doesn't resolve. The first segment ("root") names the root session.(progress locator)A lightweight, ref-free live snapshot of a session locator, folded straight
from canonical DB events — correct mid-turn and cheap enough to poll while a turn is in flight (no
blob reads, no child recursion). Pairs with an async turn: poll this to watch a
turn settle. For full step/leaf/final detail, use load-node instead.
A lightweight, ref-free live snapshot of a session locator, folded straight from canonical DB events — correct mid-turn and cheap enough to poll while a turn is in flight (no blob reads, no child recursion). Pairs with an async turn: poll this to watch a turn settle. For full step/leaf/final detail, use `load-node` instead.
(resolve-ref locator ref)Resolve a payload blob ref against its session locator. Returns ::missing for an unreadable blob, nil for a nil ref.
Resolve a payload blob ref against its session locator. Returns ::missing for an unreadable blob, nil for a nil ref.
(steps {:keys [messages]})Pair each assistant message with the observation the host returned for it. One step = one ▷wrote / ◁observed exchange. Numbered from 1.
Pair each assistant message with the observation the host returned for it. One step = one ▷wrote / ◁observed exchange. Numbered from 1.
(strip-fence s)Drop the ```clojure fences so the bare code shows; the kernel evaluated exactly this text.
Drop the ```clojure fences so the bare code shows; the kernel evaluated exactly this text.
(tree locator)(tree locator address label)Recursively fold the whole run into a summary tree: each node carries its
address, label, status, model and counts, plus expanded child nodes. Cheaper per
node than load-node (no step/leaf/final text), so it scales to the whole tree.
Recursively fold the whole run into a summary tree: each node carries its address, label, status, model and counts, plus expanded child nodes. Cheaper per node than `load-node` (no step/leaf/final text), so it scales to the whole tree.
(view locator)Dereference the current head state for a session locator. Pure; zero provider calls. Pass a locator with :head/id to inspect a specific immutable head.
Dereference the current head state for a session locator. Pure; zero provider calls. Pass a locator with :head/id to inspect a specific immutable head.
cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |