Skip to main content

Module run

git_internal::internal::object

Module run 

Source
Expand description

AI Run snapshot.

Run stores one immutable execution attempt for a Task.

§How to use this object

  • Create a Run when Libra starts a new execution attempt.
  • Set the selected Plan, optional ContextSnapshot, and runtime Environment before persistence.
  • Create a fresh Run for retries instead of mutating a prior run.

§How it works with other objects

  • Provenance records model/provider configuration for the run.
  • ToolInvocation, RunEvent, PlanStepEvent, Evidence, PatchSet, Decision, and RunUsage all attach to Run.
  • Decision is the terminal verdict for a run.

§How Libra should call it

Libra should treat Run as the execution envelope and keep “active run”, retries, and scheduling state in Libra. Execution progress, metrics, and failures must be appended as event objects rather than written back onto the run snapshot.

Structs§

Environment
Best-effort runtime environment capture for one Run.
Run
Immutable execution-attempt envelope.