Skip to main content

Universal Agent Runtime

Universal Agent Runtime (UAR) is a Rust/Axum runtime for governed agent execution, typed streaming, model routing, tools, retrieval, and declarative agent UI. The first-party interface is React 19 + TypeScript.

The Rust product is 1.4.0-rc.5, a release candidate. SDK/package/schema versions are independent; private root tooling/frontend/SDK packages currently retain 1.0.0, the documentation package 0.0.0 and desktop shell 0.1.0. The distributed server/sidecar product is server-full; the dependency-light minimal profile is separate. The support matrix is the public contract. The first selected lane is Linux amd64 container APIs behind a trusted host or gateway, with owned-volume embedded SurrealDB 4.0.0 on SurrealKV by default and a restricted PostgreSQL 18 lane. Use the RC4 user guide for setup, verification and recovery. The signed RC4 prerelease qualifies the selected UAR API lane. RC4 release evidence.

Core contracts​

AreaContract
RuntimeAxum REST and SSE APIs listen on configurable port 1906 by default.
FrontendReact components call hooks, hooks expose stores, stores call typed services.
StreamingRC5 targets final AG-UI 1.0 through the dedicated agent API.
ArtifactsRC5 targets final A2UI 1.0 surfaces and governed actions. Existing v0.9 and v0.9.1 history remains readable.
PersistenceSurrealDB is the Stable server authority; PGlite is a local cache reconciled through versioned events.
ProvidersThe pinned Liter provider map is discovery metadata; derive counts from that map. Historical named capability evidence and current qualification are separate.
ToolsMCP-discovered and native tools share schema, Cedar policy, approval, hard-deny, and audit controls. WASM tools are opt-in Preview.

Catalog filtering describes discovery. The runtime applies capability, policy and budget checks to actual dispatch. The RC4 user guide links the controlled dispatch evidence and its scope. Adaptive learned routing is Experimental. Historical Web maturity does not qualify current browser workflows; desktop/native WASM, mobile and other architectures are not selected for this first API promotion. Browser arbitrary WASM execution is unsupported.

Use the canonical interface recovery table and finite final checklist. Full harness remains process_ephemeral, unsupported_after_restart, steer_supported:false. Independent memory selection and team reconciliation have their own owner, relevance and uncertainty limits; no global exactly-once effects or automatic cross-version recovery is claimed. The selected synthetic baseline uses a zero-error threshold. Capacity, latency targets and runtime comparisons remain outside that evidence.

Architecture​

React -> hooks -> stores/entity graph -> services -> Axum REST/SSE
|
SurrealDB <- runtime/orchestrator -> providers/tools
^ |
`-- versioned events -> PGlite cache

Next steps​

Licensing​

All code — the runtime server and the SDKs under sdks/ — is MIT; documentation is CC-BY-4.0. There is no commercial license to buy. See the repository's LICENSE and LICENSE-CC-BY-4.0.md.