fractal-engine.session-db — net.clojars.deadmeme5441/fractal-engine 0.3.1

Canonical durable store for sessions.

SQLite stores hot operational rows, refs, and transaction batches. BlobStore stores payloads: message text, code, requests/responses, finals, snapshots, vars, and raw errors. Datahike is a rebuildable Datalog index derived from SQLite transaction batches plus blob identity facts.

The local filesystem is only the physical backend for SQLite, Datahike index files, and content-addressed blob bytes. Per-session filesystem homes are not part of the domain model.

advance-current-head! clj

(advance-current-head! root head expected-head)

alias-entity clj

(alias-entity alias session-id)

attached-from clj

(attached-from root source-session-id)

call-entity clj

(call-entity session-id call)

call-records clj

(call-records root session-id)

current-head-id clj

(current-head-id root session-id)

derivation-entity clj

(derivation-entity target-session-id source kind created-at)

direct-session-status clj

(direct-session-status root session-id)

eval-entity clj

(eval-entity root session-id row)

eval-records clj

(eval-records root session-id)

event-entity clj

(event-entity session-id ev payload-ref)

event-record clj

(event-record root session-id ev payload-ref)

event-session-id clj

(event-session-id fallback event)

event-view clj

(event-view root session-id)

Compact audit/history view from SQLite rows. This is not a replay source for current state; current reads dereference head-state roots.

handle-head-id clj

(handle-head-id handle opts)

handle-session-id clj

(handle-session-id handle)

head-entity clj

(head-entity head)

high-water-counters clj

(high-water-counters root session-id)

Session-local high-water counters from canonical facts. Restoring from an older head must continue above abandoned historical ids, not from that head's local counter value.

history-view clj

(history-view root session-id)

Audit/history view. Events are the complete event log; heads/invocations are read directly from SQLite rows so abandoned branches remain visible.

incoming-invocations clj

(incoming-invocations root session-id)

invocation-entity clj

(invocation-entity session-id inv)

list-alias-records clj

(list-alias-records root)

list-derivation-records clj

(list-derivation-records root)

list-head-records clj

(list-head-records root)

list-invocation-records clj

(list-invocation-records root)

list-session-records clj

(list-session-records root)

load-events clj

(load-events root session-id)

locator clj

(locator root session-id)

(locator root session-id head-id)

locator-session-id clj

(locator-session-id x)

locator-store-root clj

(locator-store-root x)

(locator-store-root x default-root)

locator? clj

(locator? x)

message-entity clj

(message-entity session-id message payload-ref)

message-records clj

(message-records root session-id)

(message-records root session-id {:keys [include-content?]})

metadata-event-types clj

outgoing-invocations clj

(outgoing-invocations root session-id)

put-payload-fact! clj

(put-payload-fact! root value fact-fn opts)

read-alias clj

(read-alias root alias)

read-head clj

(read-head root head-id)

(read-head root session-id head-id)

read-head-state clj

(read-head-state root head-id)

(read-head-state root session-id head-id)

read-ref clj

(read-ref root session-id)

read-session clj

(read-session root session-id)

record-event! clj

(record-event! root fallback-session-id ev)

register-session! clj

(register-session! root session)

resolve-handle clj

(resolve-handle root handle opts)

resolve-session-id clj

(resolve-session-id root token)

session-current-head-entity clj

(session-current-head-entity session-id head-id)

session-entity clj

(session-entity session)

snapshot-entity clj

(snapshot-entity session-id snapshot)

snapshot-records clj

(snapshot-records root session-id)

store-root clj

(store-root session)

store-version clj

transact-facts! clj

(transact-facts! root blob-refs facts)

transact-rows-and-facts! clj

(transact-rows-and-facts! root rows blob-refs facts)

turn-entity clj

(turn-entity session-id turn)

turn-records clj

(turn-records root session-id)

view clj

(view root session-id)

(view root session-id opts)

Current/head view for a session. If a head is selected, dereference that immutable head state. Otherwise dereference session/current-head. The event fold remains available through history-view/event-view.

write-alias! clj

(write-alias! root alias session-id)

(write-alias! root alias session-id _extra)

write-head! clj

(write-head! root head)

write-invocation! clj

(write-invocation! root invocation)