Skip to main content

Crate layover_core

Crate layover_core 

Source
Expand description

Domain types for Layover.

This crate holds the parts of the design that can be reasoned about and tested without spawning anything. It reads configuration and prompt files from disk; it does not run processes, serve HTTP or call an LLM.

  • agent — who an agent is: name, description, purpose, access
  • route — edges in the route map
  • pipeline — named entry points, their triggers and their flags
  • prompt — composing an agent’s instructions from files, conditional on flags
  • config — parsing a factory definition from layover.toml
  • graph — the route map as a directed graph
  • validate — load-time checks that fail before a human stops watching
  • flight — the message envelope
  • cost — the ledger, rate cards and the factory-wide Fuel Reserve
  • itinerary — Hops, Fuel and the deterministic run cap
  • barrier — rendezvous joins, including reset and reachability-based abandonment

See docs/architecture.md and docs/routing.md in the repository for the design these types implement.

Re-exports§

pub use agent::Access;
pub use agent::Agent;
pub use agent::AgentName;
pub use agent::PromptSpec;
pub use agent::PromptSpecError;
pub use autostart::Autostart;
pub use autostart::Platform;
pub use barrier::Barrier;
pub use barrier::BarrierKey;
pub use barrier::Delivery;
pub use brief::brief;
pub use config::Config;
pub use config::ConfigError;
pub use config::Defaults;
pub use config::McpWiring;
pub use config::Paths;
pub use config::ReserveConfig;
pub use config::Runner;
pub use cost::CostSource;
pub use cost::Ledger;
pub use cost::ModelRates;
pub use cost::RateCard;
pub use cost::Reserve;
pub use cost::ReserveState;
pub use cost::RunCost;
pub use cost::Summary;
pub use cost::TokenUsage;
pub use diagram::Activity;
pub use diagram::Layout;
pub use diagram::Live;
pub use diagram::render_svg;
pub use diagram::route_map;
pub use flight::Flight;
pub use flight::FlightId;
pub use flight::ItineraryId;
pub use flight::Origin;
pub use flight::RunId;
pub use graph::RouteGraph;
pub use handover::Cause;
pub use handover::ChildState;
pub use handover::Handover;
pub use handover::Interruption;
pub use handover::Recovery;
pub use handover::RecoveryDenied;
pub use handover::RecoveryPolicy;
pub use handover::Steer;
pub use help::Blocker;
pub use help::HelpRequest;
pub use itinerary::Denial;
pub use itinerary::Itinerary;
pub use layover::Layover;
pub use layover::LayoverId;
pub use learning::Impact;
pub use learning::Learning;
pub use learning::LearningId;
pub use learning::Learnings;
pub use learning::Proposal;
pub use learning::Uptake;
pub use mcp::McpServer;
pub use mcp::McpTransport;
pub use pipeline::FlagError;
pub use pipeline::FlagSpec;
pub use pipeline::Flags;
pub use pipeline::Pipeline;
pub use pipeline::PipelineName;
pub use pipeline::Schedule;
pub use pipeline::Trigger;
pub use pipeline::TriggerError;
pub use pipeline::Workspace;
pub use prompt::PromptDir;
pub use prompt::PromptError;
pub use prompt::PromptMap;
pub use prompt::PromptSource;
pub use report::Report;
pub use route::Join;
pub use route::Mode;
pub use route::Route;
pub use run::Outcome;
pub use run::RunRecord;
pub use slots::Admission;
pub use slots::Slots;
pub use stall::Stall;
pub use validate::Diagnostic;
pub use validate::Severity;
pub use validate::validate;
pub use validate::validate_prompts;

Modules§

agent
Agent identity and configuration.
autostart
Starting Layover when the computer starts.
barrier
Rendezvous joins.
brief
The block of text a run is given beyond its own instructions.
config
Parsing of the single layover.toml factory definition.
cost
What a run actually cost, and where that figure came from.
diagram
Drawing a factory.
flight
The Flight envelope, and the identifiers that track work through the Tower.
graph
The route map as a directed graph.
handover
Starting a run that carries what an earlier one knew.
help
Agents asking for help.
itinerary
Hops, Fuel and the deterministic run cap.
layover
A Layover: work set down now and picked up later.
learning
Agents proposing how to do better next time.
mcp
MCP servers an agent may reach.
payload
What a run is told, and in what order.
pipeline
Pipelines: named, triggerable entry points that carry flags.
prompt
Dynamic prompt composition.
queue
Work that has been asked for and not yet dispatched.
report
What an agent writes about its own run.
route
Edges in the route map.
run
What a run was, once it is over.
slots
Slots: how many runs may be in the air at once.
stall
A chain that stopped and will not start again on its own.
tools
The tools an agent may call, named once.
validate
Load-time validation of a factory definition.