@agent-os/runtime-protocol

Purpose

Serializable runtime vocabulary shared across runtime services, concrete backends, composers, and ops surfaces.

Public API Status

Runtime protocol package. It owns serializable runtime vocabulary consumed across runtime, backend, composer, and ops boundaries.

Invariant

Runtime protocol is vocabulary only. It owns submit DTOs, admission lease/projection DTOs, runtime ledger event schemas, runtime fact-owner identity, and ledger identity types. It does not own Effect services, runtime control flow, backend storage, transport wrapping, or provider implementations.

@agent-os/runtime consumes this package as an interpreter layer. Backends and composers import protocol-owned symbols directly from this package; runtime must not re-export them as a compatibility shim.

Minimal Usage

Use this package when a value crosses runtime/backend/composer/ops boundaries or is persisted in ledger-visible state.

import type { SubmitSpec, SubmitResult } from "@agent-os/runtime-protocol";
import { decodeRuntimeLedgerEvent } from "@agent-os/runtime-protocol";

Use @agent-os/runtime for Effect services and execution:

import { Ledger, submitAgentEffect } from "@agent-os/runtime";

Verification

Run the package and graph gates:

cd packages/runtime-protocol && bun run test
bun run typecheck