anyclaw-sdk-runtime 0.1.0

SDK for building anyclaw runtime extensions (container + proxy + network)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

//! Runtime SDK for anyclaw.
//!
//! Provides the [`Runtime`] trait for building runtime extensions that manage
//! agent sandbox environments (containers, VMs, etc.) and the
//! [`RuntimeHarness`] for JSON-RPC stdio framing.
//!
//! A runtime extension is responsible for:
//! - Creating and managing the execution environment (container, network, proxy)
//! - Providing process execution capability via [`Runtime::exec`]
//! - Health reporting and graceful shutdown
//!
//! The supervisor uses `exec()` to spawn agent worker processes inside the
//! runtime environment. All internal infrastructure (proxy, networking, auth)
//! is the runtime's concern — the supervisor only sees the trait interface.
//!
//! # Stability
//!
//! This crate is **unstable** — APIs may change between releases.
#![warn(missing_docs)]

/// Error types for runtime SDK operations.
pub mod error;
/// The [`Runtime`] trait that runtime authors implement.
pub mod trait_def;
/// Types for the runtime initialize handshake, exec, and health reporting.
// D-03 boundary: options values are runtime-defined, no fixed schema.
#[allow(clippy::disallowed_types)]
pub mod types;

pub use error::RuntimeSdkError;
pub use trait_def::Runtime;
pub use types::*;