@sapiom/agent-runtime
v0.7.1
Published
The Sapiom orchestration runtime: the host-agnostic graph-walker decision logic + the host interfaces (execution store, step dispatcher, observer) it runs against. One runtime, two hosts (server engine + local runner).
Readme
@sapiom/agent-runtime
The host-agnostic core of the Sapiom orchestration engine: the graph-walker's
decision logic and the host interfaces it runs against (ExecutionStore,
StepDispatcher, RuntimeObserver). The same runtime drives both the server
engine and a local in-process runner — "one runtime, two hosts" — so a local
pass is real evidence, not a reimplementation.
This package is pure: it depends only on @sapiom/agent (protocol),
ajv, and zod. No persistence, transport, or scheduling — those are supplied
by a host through the interfaces.
A host executor reporting an outcome: "threw" completion should serialize the
caught value with serializeStepCompletionError(error). This retains the
allowlisted fields that let the runner recognize terminal platform errors while
ordinary, author, and unknown errors keep the legacy retryable shape.
The closed terminal set includes step-input validation plus ctx.shared quota
and JSON-serialization failures. A bare retryable: false flag or unrecognized
code still follows the retry path.
