fractal-engine.session

Liking cljdoc? Tell your friends :D

Clojure only.

fork-session!
latest-complete-snapshot
resume-session!
run-turn!
run-turn-async!
session-handle
start-session!
stop-session!

fork-session!^clj

(fork-session! cfg old-dir new-dir)

(fork-session! cfg old-dir new-dir opts)

source

latest-complete-snapshot^clj

(latest-complete-snapshot state)

source

resume-session!^clj

(resume-session! cfg source-dir)

(resume-session! cfg source-dir opts)

source

run-turn!^clj

(run-turn! session user-message)

source

run-turn-async!^clj

(run-turn-async! session user-message)

Run one turn on a background daemon thread. Returns a promise that delivers the turn result map. A turn that throws delivers {:status :error :error ...} instead of escaping, so a deref or poll never surprises the caller. The session journal updates live throughout — poll projection/progress (or load-node) on the session dir to watch the turn settle, then deref the promise for the result. Refuses to start (throws :fractal/turn-in-flight) if a turn is already running on this handle.

Run one turn on a background daemon thread. Returns a promise that delivers the
turn result map. A turn that throws delivers {:status :error :error ...} instead
of escaping, so a deref or poll never surprises the caller. The session journal
updates live throughout — poll `projection/progress` (or `load-node`) on the
session dir to watch the turn settle, then deref the promise for the result.
Refuses to start (throws :fractal/turn-in-flight) if a turn is already running on
this handle.

source raw docstring

session-handle^clj

(session-handle state cfg ns-sym ops)

source

start-session!^clj

(start-session! cfg)

(start-session! cfg {:keys [dir id kind parent cache-id overlay]})

Start a fresh session. Opts may carry an :overlay — an extra, session-level system instruction appended to the base behavior in the single system message. It is a standing specialization for the whole session (e.g. codebrain's brain role), stated once at birth and carried across every turn and resume via the message history; it is NOT the per-turn task. Kept to one combined system message so it is provider-agnostic (some adapters honor only the first system).

Start a fresh session. Opts may carry an `:overlay` — an extra, session-level
system instruction appended to the base behavior in the single system message.
It is a standing specialization for the whole session (e.g. codebrain's brain
role), stated once at birth and carried across every turn and resume via the
message history; it is NOT the per-turn task. Kept to one combined system
message so it is provider-agnostic (some adapters honor only the first system).

source raw docstring