Crate everruns_runtime

Expand description

§Warning: 0.17.x compatibility only

everruns-runtime is a transitional compatibility API for existing Everruns 0.17.x applications. It will be removed in Everruns 0.18. It remains usable and source-compatible throughout 0.17.x; no execution implementation lives here.

New ordinary applications use the everruns Framework crate, beginning with use everruns::{Agent, Model};. Advanced system integrators use everruns plus everruns-host and focused sibling crates, beginning with use everruns_host::{HostBackends, InProcessRuntimeBuilder};.

See the authoritative runtime migration guide for exact old-to-new mappings. All crates are part of the Everruns ecosystem.

§0.17 compatibility example

use everruns_runtime::{InProcessRuntimeBuilder, RuntimeBackends};

let builder = InProcessRuntimeBuilder::new().backends(RuntimeBackends::in_memory());

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.
EventCursor: Snapshot-bound continuation cursor for canonical event replay.
EventDeliveryStats: Counts observational failures without making them execution failures.
EventHistory: Read-only message/history projection rebuilt from canonical events.
EventHistoryPage: Bounded message projection and its stable event snapshot continuation.
EventHistoryReadLimit: Validated projected-message bound for EventHistory::read_page.
EventHistoryReadRequest: One bounded projected-history read.
EventPage: A page of full canonical event envelopes in persisted sequence order.
EventReadLimit: Validated bound for one EventReader::read_page call.
EventReadRequest: One bounded canonical event read.
HarnessBuilder: Builds a Harness with runtime-friendly defaults.
HostBackends: Non-filesystem backend bundle supplied to an execution host.
HostEventEmitter: Canonical event router shared by in-process, worker, and facade hosts.
InMemoryEventLog: Volatile coherent event log used by default in-process hosts.
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.
JsonlEventLog: Crash-durable JSONL log containing complete canonical Event envelopes.
NoopEventSink: Sink used when a host has no live observers.
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.
RuntimeBackends: 0.17 name for the canonical host backend bundle. Non-filesystem backend bundle supplied to an execution host.
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§

EventDurability: Persistence guarantee provided by an EventLog implementation.
EventLogError: Errors from canonical event append or bounded replay.
EventSinkError: Observational delivery failures. They never change append or turn success.
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_EVENT_READ_LIMIT: Default number of canonical envelopes returned by a host event read.
DEFAULT_WRITE_BLOCKLISTDeprecated: Legacy default for WriteBlocklistFileStore.
MAX_EVENT_HISTORY_PAGE_SIZE: Maximum projected messages returned by one bounded history page.
MAX_EVENT_HISTORY_REPLAY: Maximum envelopes one EventHistory projection may examine in one call.
MAX_EVENT_PAGE_SIZE: Hard upper bound for one host event read.

Traits§

EventBusDeprecated: Legacy observation trait retained only so 0.17 implementations still name the path. It is outside maintained execution; use EventSink for live post-commit observation and EventReader for replay.
EventLog: A coherent canonical event log.
EventReader: Bounded, ordered reader for canonical session events.
EventSink: Non-blocking destination for already-finalized canonical envelopes.
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.
RuntimeMessageStoreDeprecated: Legacy writable message-store contract retained only for 0.17 source paths.
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.