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)

Feature Flags

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