leviath_core/
lib.rs

1//! # Leviath Core
2//!
3//! Core types and traits for the Leviath agent framework.
4//!
5//! This crate provides the foundational types for building agents with structured,
6//! hardware-inspired context window management. It includes:
7//!
8//! - **Regions**: Typed memory regions with different lifecycle policies
9//! - **Layouts**: Complete memory maps defining how context is structured
10//! - **Blueprints**: Agent definitions including stages, models, and tools
11//! - **Lifecycle**: Policies for eviction, compaction, and context management
12
13pub mod blueprint;
14pub mod cache;
15pub mod config;
16pub mod credentials;
17pub mod duration;
18pub mod error;
19pub mod files;
20pub mod interaction;
21pub mod layout;
22pub mod lifecycle;
23pub mod manifest;
24pub mod mcp_names;
25pub mod mime;
26pub mod output;
27pub mod panic_payload;
28pub mod paths;
29pub mod policy;
30pub mod read_paths;
31pub mod region;
32pub mod run_archive;
33pub mod run_meta;
34pub mod sandbox;
35pub mod secrets;
36pub mod sync;
37pub mod taint;
38pub mod telemetry;
39pub mod text;
40pub mod write_limits;
41
42pub use blueprint::{
43    Blueprint, ContextTransform, EdgeTransform, FileTrackingConfig, NudgeConfig, ReadPathsConfig,
44    RepetitionDetectionConfig, ResolvedNudge, Stage, StuckConfig, ToolResultRouting,
45    TransitionCondition, TransitionEdge, resolve_nudge,
46};
47pub use cache::CacheHint;
48pub use credentials::{
49    CredentialStore, CredentialStoreKind, MemoryStore, mcp_account, provider_account,
50};
51pub use error::{Error, Result, ValidationError};
52pub use layout::{BudgetSpec, ContextLayout, RegionDefinition};
53pub use lifecycle::CompactionConfig;
54pub use output::{
55    FINAL_OUTPUT_FILE, FinalOutput, FinalOutputDescriptor, MAX_FINAL_OUTPUT_BYTES, OutputSpec,
56    describe_spec, resolve_output_spec,
57};
58pub use panic_payload::panic_message;
59pub use paths::{
60    agents_dir, canonicalize_for_match, data_dir, home_dir, is_safe_path_component, providers_dir,
61    resolves_within, tools_dir,
62};
63pub use policy::{AllowlistRule, McpToolOverride, PolicyConfig};
64pub use read_paths::{
65    ReadPathDecision, ReadPathEntry, ReadPathPolicy, ReadPathSet, validate_entry_syntax,
66};
67pub use region::{
68    ContentFormat, EntryKind, EvictionStrategy, Region, RegionEntry, RegionKind, RegionSchema,
69    SerializedToolCall, Volatility,
70};
71pub use sandbox::{OnUnavailable, SandboxKind, ToolSandboxConfig, resolve_sandbox};
72pub use secrets::{
73    ShellEnvMode, child_env_allowed, constant_time_eq, dotenv_var_allowed, is_secret_header,
74    is_sensitive_env_name, redact, script_env_allowed, withheld_child_vars,
75};
76pub use taint::{
77    GateDecision, GateDecisionSource, GateEvent, RegionTaint, SecurityConfig, TaintLevel,
78    ToolClassification, ToolDirection,
79};
80pub use text::{estimate_tokens, floor_char_boundary, truncate_at_boundary, truncate_chars};
81
82/// Serde default for a flag that is on unless a file turns it off.
83///
84/// `#[serde(default)]` on a `bool` is `false`, so every "on by default" field
85/// needs a named function, and eight modules across two crates had written
86/// this one. Name it as `default = "crate::default_true"` inside this crate and
87/// `"leviath_core::default_true"` outside it; serde pastes the path as written.
88pub fn default_true() -> bool {
89    true
90}
leviath_core/lib.rs

leviath_core/
lib.rs
