Crate runtimo_core 

Runtimo Core — Agent-centric capability runtime for persistent machines.

Runtimo provides structured execution, resource limits, crash recovery, and two-layer telemetry (hardware + process tracking) for machines that cannot be factory-reset. Every capability execution captures before/after snapshots, enabling full audit trails and undo support.

Architecture

• Capabilities — Pluggable operations implementing the Capability trait
• Jobs — Lifecycle-tracked execution units (Job, JobState)
• Telemetry — Hardware awareness (Telemetry)
• Process Snapshot — Running process awareness (ProcessSnapshot)
• WAL — Append-only crash recovery log (WalWriter/WalReader)
• Backup — Undo support via pre-mutation file backups (BackupManager)
• Resource Guards — Circuit breaker via LlmoSafeGuard

Quick Start

use runtimo_core::{FileRead, Capability, Context};
use serde_json::json;

let cap = FileRead;
assert_eq!(cap.name(), "FileRead");

Execution with Full Telemetry

use runtimo_core::{FileRead, execute_with_telemetry};
use serde_json::json;
use std::path::Path;

let cap = FileRead;
let result = execute_with_telemetry(
    &cap,
    &json!({"path": "/tmp/test.txt"}),
    false,
    Path::new("/tmp/runtimo.wal"),
).unwrap();
assert!(result.success);

Performance (Measured on AMD EPYC 7B13)

Operation	Latency	Notes
Cold start	<1s	Binary load + init
FileRead	<10ms	Small files (<1KB)
FileWrite	<50ms	Includes backup copy
Telemetry capture	<100ms	15+ shell subprocesses
Process snapshot	<50ms	ps aux parse
Memory baseline	<50MB	RSS at idle

Feature Flags

No optional features currently. All functionality is included by default.

Re-exports

pub use backup::BackupManager;

pub use capabilities::FileRead;

pub use capabilities::FileWrite;

pub use capabilities::GitExec;

pub use capabilities::Kill;

pub use capabilities::ShellExec;

pub use capabilities::Undo;

pub use capability::Capability;

pub use capability::CapabilityRegistry;

pub use capability::Context;

pub use capability::Output;

pub use config::RuntimoConfig;

pub use executor::execute_with_telemetry;

pub use executor::execute_with_telemetry_and_session;

pub use executor::ExecutionResult;

pub use job::Job;

pub use job::JobId;

pub use job::JobState;

pub use llmosafe::LlmoSafeGuard;

pub use monitor::HealthAlert;

pub use monitor::HealthMonitor;

pub use monitor::HealthState;

pub use processes::ProcessSnapshot;

pub use schema::SchemaValidator;

pub use session::Session;

pub use session::SessionManager;

pub use telemetry::Telemetry;

pub use wal::WalEvent;

pub use wal::WalEventType;

pub use wal::WalReader;

pub use wal::WalWriter;

Modules

backup

Backup manager for undo/rollback functionality.

capabilities

Built-in capabilities.

capability

Capability trait and registry.

cmd

Shared command execution helper.

config

Persistent configuration for Runtimo.

executor

Execution engine — telemetry-wrapped capability execution.

job

Job lifecycle management.

llmosafe

LLMOSafe integration — Real resource limits via the llmosafe crate.

monitor

Health Monitoring Daemon — Background health checks with alerting.

processes

Process Execution Awareness — What’s running and consuming resources.

schema

JSON Schema validation for capability arguments.

session

Session tracking for reliable SSH.

telemetry

System Telemetry — Environment awareness for the capability runtime.

utils

Utility functions for path management.

validation

Unified path validation module.

wal

Write-Ahead Log (WAL) — Append-only, crash-resistant event log.

Enums

Error

Error types for runtimo-core.

Type Aliases

Result

Result alias for runtimo-core operations.