everruns-contracts

Shared contracts for the Everruns framework and hosts.

Part of the Everruns ecosystem.

What It Provides

This crate owns provider and driver boundaries, capability identity and code-defined capability authoring, model profiles, typed IDs, and shared runtime contracts. It replaces everruns-provider, everruns-capability, and everruns-model-profiles.

The default build includes capability definition authoring and omits HTTP transport. Enable http for shared protocol drivers and clients, responses-websocket for Responses WebSocket transport, openapi for schema derives, and sqlx for typed ID encoding. sqlx supplies value encoding only; this crate never opens a connection. The session-sandbox feature enables inventory registration for sandbox providers; sandbox types and the neutral context interface remain available without it.

use everruns_contracts::{CapabilityRef, ModelSpec};

let model = ModelSpec::on("company-gateway", "assistant-v2");
let capability = CapabilityRef::new("vendor.search");
assert_eq!(model.provider.as_str(), "company-gateway");
assert_eq!(capability.id(), "vendor.search");

Provider APIs retain their existing root and module paths. Capability APIs live in capability and are also exported from the root. model_profile_data exposes the offline profile registry keyed by provider wire ID; model_profiles keeps the typed DriverId adapters.

Documentation

• API reference (docs.rs)
• Everruns Framework
• Everruns documentation

License

Licensed under the MIT License.