Scoria.Runtime (scoria v0.1.0)

Copy Markdown View Source

Advanced runtime lifecycle and inspection APIs behind the Scoria facade.

Most host apps should call Scoria directly. This module exists for the deeper lifecycle layer once you already have canonical identity and want the underlying start, resume, and inspection primitives spelled out explicitly.

The same identity contract still applies here: session_id groups continuity across related turns, while run_id identifies one exact durable run for inspection or resume.

Summary

Functions

Returns the stable public summary for a run.

Returns the stable public summary for a run or raises.

Returns the curated detailed public view for a run.

Returns the curated detailed public view for a run or raises.

Lists compacted memories for a given run, ordered by sequence.

Lists runs that share the same host-owned session_id.

Marks a runtime instance as offline with a reason.

Registers or updates a durable runtime instance presence.

Resumes an existing run by exact durable run_id.

Starts a bounded delegated run with one explicit handoff and queued child step.

Starts a new run from canonical identity plus explicit runtime options.

Functions

get_run(run_id)

Returns the stable public summary for a run.

get_run!(run_id)

Returns the stable public summary for a run or raises.

get_run_detail(run_id)

Returns the curated detailed public view for a run.

get_run_detail!(run_id)

Returns the curated detailed public view for a run or raises.

list_compacted_memories_for_run(run_id)

Lists compacted memories for a given run, ordered by sequence.

list_runs_for_session(session_id)

Lists runs that share the same host-owned session_id.

mark_offline(instance_id, reason)

Marks a runtime instance as offline with a reason.

register_instance(attrs)

Registers or updates a durable runtime instance presence.

resume_run(run_id, opts \\ [])

Resumes an existing run by exact durable run_id.

start_handoff_run(identity, delegated_role_id, opts \\ [])

Starts a bounded delegated run with one explicit handoff and queued child step.

start_run(identity, opts \\ [])

Starts a new run from canonical identity plus explicit runtime options.