@sapiom/agent-runtime

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).

Source

npm

Version: 0.7.0

Version published: last week

Weekly downloads: 630

Maintainers: 4

Weekly downloads

Created: 2 months ago

Source

@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.