Module event 

Structs

CachedToolCall

Caches the LLM-emitted tool-use blocks so a replay rebuilds the same tool_use_ids and the downstream ToolCallEnd lookups stay stable. Mirror of akribes_core::replay_cache::CachedToolCall — same wire shape; the type lives here so it can be embedded in EngineEvent::LLMResponse without an akribes-core dependency.

LoopSuspendContext

Mid-loop checkpoint context attached to EngineEvent::Suspended when a suspension fires inside a loop block’s per-turn dispatch (a skill task invoked as a loop tool whose on_validation_exhausted / on unable handler routes to a checkpoint).

SubScriptFrame

One ancestor frame on a flattened EngineEvent::SubScript payload.

TokenUsage

Token usage from a single LLM call.

ValidationErrorWire

Wire-format twin of [crate::validation::ValidationError]. Owned + serializable; the stage discriminator is a string ("parse", "schema", "custom:<rule>") so SDK consumers don’t need to round-trip through the internal enum.

WorkflowEndPayload

Payload of EngineEvent::WorkflowEnd. Pairs the workflow’s terminal output value with an aggregate WorkflowTotals rollup.

WorkflowTotals

Aggregate token + cost rollup emitted on EngineEvent::WorkflowEnd.

Enums

ChildOutcome

Outcome of a child execution observed by its parent at the call(...) boundary. Mirror of akribes_core::replay_cache::ChildOutcome — same wire shape.

EngineEvent

SuspendTrigger

Why the engine suspended execution at a checkpoint. This is the canonical wire-shape for the trigger discriminator on EngineEvent::Suspended; Stream 4 (#149 + #156 approach C) populates the AgentUnable variant, and Stream 6 (this stream, #156 approach B) populates ValidationExhausted.

TaskEndVariant

Discriminator for EngineEvent::TaskEnd that tells consumers how a task finished without having to introspect the value payload. Extracted in #206 (Stream 4 follow-up): before this, a caller had to inspect the value for a Value::Unable envelope to distinguish “the agent said I can’t” from a well-typed successful return. Serde-tagged on a "variant" field so new arms ship without wire-shape churn.

Constants

VALIDATION_FAILURE_RESPONSE_CAP_BYTES

Cap applied to EngineEvent::ValidationFailure::model_response on emit (issue #1139). Set to 64 KiB — enough to capture the validator’s view of any reasonable model output while keeping execution_events rows bounded. A 4 MB tool input on a three-retry validation loop used to bloat the persisted log by 12 MB per task; post-cap the same loop emits at most 192 KB.

Type Aliases

NodeId

Node-id type used by EngineEvent::NodeStart / NodeEnd / Breakpoint*. Mirror of akribes_core::compiler::NodeId — same underlying usize representation; the alias lives here so the SDK-facing EngineEvent doesn’t need to depend on the compiler module.