Skip to main content

lilo_rm_core/
lib.rs

1//! Runtime Matters core protocol types and JSON line transport helpers.
2//!
3//! This crate is the stable contract shared by `rtm` clients and rtmd. The
4//! daemon, CLI, platform, launcher, and store crates remain private
5//! implementation details.
6//!
7//! ## Events contract
8//!
9//! v0.4 events use [`RuntimeRpc::Events`] and
10//! [`RuntimeResponse::Events`].
11//! The daemon appends lifecycle observations to a durable JSONL log in global
12//! order. Clients pass the returned cursor as `since` to resume without
13//! duplicate delivery after client or daemon restarts.
14//!
15//! If a cursor is older than the retained log floor, rtmd returns
16//! [`RuntimeResponse::CursorExpired`].
17
18pub mod admin;
19pub mod capture;
20mod cli_output;
21pub mod error;
22pub mod isolation;
23pub mod launcher;
24pub mod mcp;
25pub mod path_shaped_envs;
26pub mod proto;
27pub mod spawn_context;
28pub mod tool_contracts;
29pub mod types;
30mod version;
31
32pub use admin::{
33    DockerIsolationStatus, DockerReadiness, DockerStatus, DoctorResponse, KillByPidRequest,
34    KillByPidResponse, KillOutcome, LauncherStatus, LifecycleCounts, LifecycleLogAvailability,
35    MigrationState, RecentLostEvent, StatusFilter, StatusResponse, TmuxStatus, WatcherCounts,
36};
37pub use capture::{
38    CaptureError, CaptureRequest, CaptureResponse, LogAvailability, LogsUnavailableReason,
39    PaneSnapshot,
40};
41pub use cli_output::{Ack, CliOutput};
42pub use error::{ErrorCode, ProtocolError, RuntimeKindParseError};
43pub use isolation::{IsolationPolicy, IsolationPolicyParseError, IsolationProfile};
44pub use launcher::{
45    LaunchEnv, LaunchSpec, LauncherError, RuntimeLauncher, ShellResume, upsert_launch_env,
46};
47pub use mcp::{
48    JsonRpcError, JsonRpcRequest, JsonRpcResponse, MCP_PROTOCOL_VERSION, McpBridgeRequest,
49    McpBridgeResponse, json_rpc_error, json_rpc_failure, json_rpc_result, tool_error, tool_success,
50};
51pub use path_shaped_envs::{
52    CLAUDE_PATH_SHAPED_ENVS, PathShapedEnv, PathValueShape, claude_path_shaped_env,
53};
54pub use proto::{
55    CapturePayload, CursorExpiredPayload, DoctorPayload, EVENT_LOG_RETENTION_MIN_AGE_SECS,
56    EVENT_LOG_RETENTION_MIN_EVENTS, EVENT_WAIT_MAX_MS, ErrorPayload, EventBatch, EventCursor,
57    EventsPayload, EventsRequest, KillByPidPayload, KilledPayload, McpBridgePayload, NudgePayload,
58    RuntimeResponse, RuntimeRpc, ShimLaunchPayload, SpawnConflictKind, SpawnConflictPayload,
59    SpawnedPayload, StatusPayload, StatusRequest, ValidateTargetPayload, VersionPayload,
60    WatchersPayload, clamped_event_wait_ms, read_json_line, read_json_line_blocking,
61    write_json_line, write_json_line_blocking,
62};
63pub use spawn_context::{
64    CALLER_ENV_DENYLIST, CALLER_ENV_DENYLIST_PREFIXES, capture_caller_cwd, capture_caller_env,
65    capture_env_from, capture_env_from_os, capture_shell_resume, capture_shell_resume_env,
66    launcher_probe_cwd,
67};
68pub use types::{
69    HeadlessSpawnTarget, KillRequest, Lifecycle, LifecycleState, LostEvidence, MountSpec,
70    MountSpecParseError, NudgeFailureReason, NudgeOutcome, NudgeRequest, NudgeResponse,
71    RuntimeEvent, RuntimeExit, RuntimeKind, RuntimeSignal, RuntimeSignalParseError, ShimExit,
72    ShimLaunchRequest, ShimReady, SpawnRequest, SpawnTarget, SpawnTargetParseError,
73    TerminationEvidence, TmuxAddress, TmuxAddressParseError, TmuxSpawnTarget,
74    ValidateTargetOutcome, ValidateTargetRequest, ValidateTargetResponse, expand_mount_source,
75};
76pub use version::{
77    RUNTIME_PROTOCOL_CAPABILITIES, RUNTIME_PROTOCOL_VERSION, RuntimeCapability, VersionInfo,
78    version_info,
79};