everruns-capability

Neutral capability contract for Everruns, capability identity, configuration, and code-defined capability authoring.

everruns-capability is the one open capability contract shared by the everruns Framework, the hosted Everruns product, and integration crates: validated CapabilityIds, the CapabilityRef reference/config representation that round-trips through application code, persisted attachments, and worker resolution, the non-sealed CapabilitySpec/IntoCapability conversion boundary, code-defined capability authoring (Definition, typed tool handlers, schema metadata, structured errors), and registry identity bookkeeping with duplicate/collision rejection.

It deliberately depends on neither engine nor host crates, no Tokio, HTTP, SQLx, OpenAPI, or platform records, so third-party capability packages can depend on this crate alone. Applications normally consume the same types re-exported from everruns.

Quick Example

use everruns_capability::{CapabilityRef, CapabilitySpec, IntoCapability};
use serde_json::json;

struct VendorSearch {
    index: String,
}

impl IntoCapability for VendorSearch {
    fn into_capability(self) -> CapabilitySpec {
        CapabilityRef::new("vendor.search")
            .config(json!({ "index": self.index }))
            .into()
    }
}

let spec = VendorSearch { index: "prod".into() }.into_capability();
assert_eq!(spec.capability_ref().id(), "vendor.search");

What It Provides

• CapabilityId, open, string-based capability identity with one shared validation rule set (character grammar, length, reserved namespaces)
• CapabilityRef, capability id plus per-agent JSON object configuration; serializes as {"ref", "config"} everywhere and redacts config from Debug
• CapabilitySpec and non-sealed IntoCapability, the open conversion contract for application capability values
• definition (default feature), code-defined capability authoring: typed Handler tools, generated input/output schemas, execution Context with progress and cancellation boundaries, structured user/internal errors
• CapabilityIdIndex / ActivationSet, canonical-id and alias bookkeeping with duplicate/collision rejection shared by registries

Documentation

• API reference (docs.rs)
• Core concepts and execution model
• Everruns documentation

Part of the Everruns ecosystem, the durable agentic harness engine for building unstoppable agents.

License

MIT, see LICENSE.