Crate everruns_host 

Shared effectful host orchestration for Everruns execution adapters.

everruns-host sits between the pure everruns-engine planner and the application, worker, and local adapters that apply its effects. It is a transitive implementation boundary, not the ordinary application entrypoint; applications in the Everruns ecosystem should normally depend on everruns.

The deprecated everruns-runtime package re-exports this implementation so its 0.17 public paths continue to use the same canonical code. Existing users should follow the runtime migration guide.

Example

use everruns_host::{RuntimeHostAdapter, RuntimeHostTurnContext};

fn accepts_host<A: RuntimeHostAdapter>() {}
fn accepts_context(_: RuntimeHostTurnContext) {}

Re-exports

pub use events::DEFAULT_EVENT_READ_LIMIT;

pub use events::EventCursor;

pub use events::EventDeliveryStats;

pub use events::EventDurability;

pub use events::EventHistory;

pub use events::EventHistoryPage;

pub use events::EventHistoryReadLimit;

pub use events::EventHistoryReadRequest;

pub use events::EventLog;

pub use events::EventLogError;

pub use events::EventPage;

pub use events::EventReadLimit;

pub use events::EventReadRequest;

pub use events::EventReader;

pub use events::EventSink;

pub use events::EventSinkError;

pub use events::HostEventEmitter;

pub use events::InMemoryEventLog;

pub use events::JsonlEventLog;

pub use events::MAX_EVENT_HISTORY_PAGE_SIZE;

pub use events::MAX_EVENT_HISTORY_REPLAY;

pub use events::MAX_EVENT_PAGE_SIZE;

pub use events::NoopEventSink;

Modules

events

Canonical host event persistence, bounded replay, and message projection.

Structs

AgentBuilder

Builds an Agent with runtime-friendly defaults.

ApprovalGatingFileStore

Gate destructive operations through an embedder-supplied FileApprovalGate. Reads pass through.

AssembledTurnContext

Public snapshot of the assembled turn context used by reason-phase hosts.

CapabilityDelta

Result of changing the session-scoped capability set of a live runtime.

HarnessBuilder

Builds a Harness with runtime-friendly defaults.

HostBackends

Non-filesystem backend bundle supplied to an execution host.

InMemorySessionFileStore

In-memory implementation of the session virtual filesystem.

InMemorySessionFileSystemFactory

Factory for the runtime’s in-memory session filesystem.

InMemorySessionStorageStore

In-memory implementation of session key/value and secret storage.

InMemorySessionStore

In-memory SessionStore + SessionMutator for embedded runtimes.

InProcessRuntime

Public in-process runtime backed by either in-memory or custom stores.

InProcessRuntimeBuilder

Builder for the public in-process runtime.

PolicyFileStore

Apply a backend-independent WorkspacePolicy to a session filesystem.

RealDiskFileStore

A SessionFileSystem rooted at a real host directory.

RealDiskSessionFileSystemFactory

Factory for real-disk session files rooted at a fixed host directory.

RuntimeActPlan

Engine-owned act scheduling payload.

RuntimeHostTurnContext

Turn context loaded in one batched call for runtime host execution.

RuntimeSessionLifecycle

Shared lifecycle helper for runtime-backed hosts.

RuntimeTurnState

Host-owned state carried across turn phases.

SessionBuilder

Builds a Session with runtime-friendly defaults.

SingleSessionBuilder

High-level builder for seeding one harness, one agent, and one session.

TurnResult

WriteBlocklistFileStore

Reject writes into vendored / build directories at any depth.

Enums

RuntimeTurnPlan

Generic next-step decision for a host turn.

TaskTransition

A task lifecycle transition an observer can be notified of.

TurnStopReason

Stable reason a turn stopped, independent of provider-specific strings.

Constants

DEFAULT_WRITE_BLOCKLISTDeprecated

Legacy default for WriteBlocklistFileStore.

Traits

FileApprovalGate

Embedder-supplied approval callback used by ApprovalGatingFileStore.

RuntimeAgentStore

Agent store contract for runtime seeding and lookup.

RuntimeHarnessStore

Harness store contract for runtime seeding and lookup.

RuntimeHostAdapter

Public adapter contract for server-backed or durable runtime hosts.

RuntimeProviderStore

Provider store contract for runtime lookup and default-model configuration.

RuntimeSessionStore

Session store contract for runtime seeding, lookup, and mutation.

TaskTransitionObserver

Receive task-transition notifications in process.

Functions

detect_dependency_blocker

execute_act_activity

execute_input_activity

execute_reason_activity

execute_reason_activity_with_prompt_messages

Execute a reason activity while applying user_prompt_submit hooks to the supplied messages. Hosts that inject synthetic user messages between reason iterations must include their ids here so they cross the same policy boundary as the turn’s original input.

in_process_internal_org_id

Derive an internal i64 org id from the public org_<32hex> form on a Session.

multi_root_file_system

plan_next_host_turn

Determine the next host step after an activity finishes.

Type Aliases

PlatformStoreFactory

Factory producing a per-(org, session) PlatformStore. The session id is supplied because platform stores are scoped to the calling session for subagent spawning and platform-management tools.

ScheduleStoreFactory

Factory producing a per-org SessionScheduleStore. Embedders that have a single global store can ignore the org_id argument and return the same Arc every time.