aion-rs 0.25.1

//! Transport-agnostic Aion workflow engine with durability, replay, timers, and supervision.
//!
//! The engine embeds beamr, loads `.aion` packages, owns workflow lifecycle and
//! process residency, records and replays durable history, and exposes seams for
//! activities, events, signals, queries, and server transports.
//!
//! # Example
//!
//! ```no_run
//! # async fn example() -> Result<(), Box<dyn std::error::Error>> {
//! use std::sync::Arc;
//!
//! use aion::EngineBuilder;
//! use aion_store::{EventStore, InMemoryStore};
//!
//! let store: Arc<dyn EventStore> = Arc::new(InMemoryStore::default());
//! let engine = EngineBuilder::new()
//!     .store_arc(store)
//!     .in_memory_visibility()
//!     .build()
//!     .await?;
//! # let _ = engine;
//! # Ok(())
//! # }
//! ```
//!
//! # Cargo features
//!
//! - `beamr_query_reentry_fixed` (off by default): compiles the
//!   batch-orchestrator example e2e tests (`tests/example_query_reentry.rs`)
//!   that drive live queries through the Gleam SDK's query pump while a
//!   parent is parked in `child.await`. The engine-side query protocol is
//!   fully functional, but the example's child-result decode path hit
//!   beamr 0.4.9 VM gaps in `gleam_json`/`gleam_stdlib`; enable the feature
//!   once the upstream beamr fixes land and the pin is bumped.
//!
//!   NOTE: the crate is now pinned to beamr 0.6.4. The gap this gate guards
//!   against was identified on 0.4.9 and may have been fixed upstream, so the
//!   gate needs re-validation against 0.6.4 and may now be stale.

#![deny(unsafe_code)]

/// Activity dispatch bridge and error propagation helpers.
pub mod activity;
/// Child-workflow spawn support.
pub mod child;
/// Durable command recording, replay, and recovery support.
pub mod durability;
/// Engine builder, runtime APIs, and delegated seams.
pub mod engine;
/// Handle type exposed by embedded engine seams.
pub mod engine_seam;
/// Engine and routing error types.
pub mod error;
/// Workflow lifecycle start, transition, visibility, and termination helpers.
pub mod lifecycle;
/// `.aion` package loading into runtime modules.
pub mod loader;
/// Live event publication: publish-after-commit store wrapper and publisher.
pub mod publish;
/// Query dispatch services and mailbox support.
pub mod query;
/// Active workflow registry and handle residency tracking.
pub mod registry;
/// BEAM runtime configuration, handles, NIFs, and workflow process support.
pub mod runtime;
/// Schedule evaluation and cron parsing support.
pub mod schedule;
/// Signal routing and resume handoff support.
pub mod signal;
/// Supervision tree models for engines, workflow types, and workflow instances.
pub mod supervision;

/// Thread-scoped tracing capture shared by the crate's operator-visibility
/// proofs.
#[cfg(test)]
pub(crate) mod log_capture;
/// Fault-injecting stores shared by the crate's durable-refusal proofs — not
/// all of their consumers are retry paths, and the module's own doc says why.
#[cfg(test)]
pub(crate) mod store_faults;
/// Timer creation, recovery, and wake-up services.
pub mod time;
/// Workloop engine services: cadence dead-man, tolerance sweep, iteration
/// boundary, hatch (workloop design brief, Leg 2).
pub mod workloop;

pub use activity::{
    ActivityDispatch, ActivityDispatcher, dispatch_activity, propagate_activity_outcome,
    surface_activity_error,
};
pub use durability::ActiveWorkflowRecoverySeamImpl;
pub use engine::{
    AdmissionReason, DeferredEventPublisher, DeferredQueryService, DeferredSignalRouter,
    DelegatedSeams, Engine, EngineBuilder, EventFamily, EventFilter, EventPublisher,
    EventStreamLagged, QueryService, QueueAdmission, ReasonCensus, RequiredContract, SignalRouter,
    UnreachableContract, schedule_coordinator_workflow_id,
};
pub use engine_seam::EngineHandle;
// Both appear in the public signature of `EngineError` — `ContentHash` in the
// `version` field of `StartInputRefused`, `SignalRefused` and
// `NoQueueDeclaration`, and `ContractIdentityError` as the `source` of
// `ContractIdentity` — so a consumer of this crate cannot construct,
// destructure, or exhaustively match those variants without them. Re-exported
// here rather than leaving every downstream to take its own `aion-package`
// dependency to reach types this crate's own API already hands them.
//
// Not speculative surface: `aion-client` declares no `aion-package` dependency
// at all and its `transport::embedded` error-mapping tests construct
// `aion::ContentHash` and `aion::ContractIdentityError` directly. Without these
// two lines that crate cannot build the very `EngineError` values it exists to
// translate — the hole is older than this change, and this is where it surfaced.
pub use aion_package::{ContentHash, ContractIdentityError};
pub use error::{EngineError, PinHolder, SignalRouterError};
pub use loader::{
    ActivityServing, DeployedWorkerContract, LoadOutcome, LoadedWorkflow, SignalRefusalReason,
    WorkflowCatalog, WorkflowVersionInfo,
};
pub use publish::{BroadcastEventPublisher, PublishError, PublishingEventStore};
pub use query::{ConcreteQueryService, QueryError};
pub use registry::{
    CompletionNotifier, HandleResidency, Registry, Residency, TerminalOutcome, WorkflowHandle,
    WorkflowHandleParts,
};
pub use runtime::{
    CompletionRetryConfig, InvalidCompletionRetryLadder, PARKED_ACTIVITY_REASON, Pid,
    RuntimeConfig, RuntimeHandle, RuntimeInput, SignalDeliveryConfig, activity_timeout_from_config,
    activity_timeout_reason, is_parked_reason,
};
pub use schedule::{ScheduleError, next_fire_time, parse_cron_expression};
pub use supervision::{
    EngineSupervisorId, SupervisionTree, TypeSupervisorId, TypeSupervisorNode, WorkflowNode,
};