lifeloop-cli 0.3.0

Provider-neutral lifecycle abstraction and normalizer for AI harnesses
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

//! Provider-neutral lifecycle contracts for AI harnesses.
//!
//! `docs/specs/lifecycle-contract/body.md` is the normative target. This module
//! implements the `lifeloop.v0.2` slice of that contract: the wire enums,
//! lifecycle receipt, payload envelope, and the callback request/response
//! envelopes that clients implement.

pub mod host_assets;
pub mod protocol;
pub mod router;
pub mod telemetry;

mod callback_contract;
mod manifest_contract;
mod receipt_contract;
mod wire;

pub const SCHEMA_VERSION: &str = "lifeloop.v0.2";

pub use callback_contract::{CallbackRequest, CallbackResponse, DispatchEnvelope};
pub use manifest_contract::*;
pub use receipt_contract::LifecycleReceipt;
pub use wire::*;

pub(crate) use wire::require_non_empty;

// ============================================================================
// Domain module aliases (added 0.1.1)
//
// These submodules are pure re-exports of the canonical top-level surface
// they exist so consumers can write `use lifeloop::event::LifecycleEventKind`
// instead of `use lifeloop::LifecycleEventKind`. The canonical paths remain
// authoritative; aliases must stay in lockstep. See
// `tests/domain_modules.rs` for the alias-identity contract.
// ============================================================================

/// Lifecycle event vocabulary. Re-exports of canonical crate-root items.
pub mod event {
    pub use crate::{LifecycleEventKind, lifecycle_event_kinds};
}

/// Adapter manifest types and registry. Re-exports of canonical crate-root items.
pub mod manifest {
    pub use crate::{
        AdapterManifest, ConformanceLevel, ManifestApprovalSurface, ManifestContextPressure,
        ManifestKnownDegradation, ManifestLifecycleEventSupport, ManifestPlacementClass,
        ManifestPlacementSupport, ManifestReceipts, ManifestRenewal, ManifestRenewalContinuation,
        ManifestRenewalReset, ManifestSessionIdentity, ManifestSessionRename,
        ManifestTelemetrySource, RegisteredAdapter, lookup_manifest, manifest_registry,
    };
}

/// Built-in adapter registry and per-harness manifest constructors.
/// Re-exports of canonical crate-root items.
pub mod adapters {
    pub use crate::{
        claude_manifest, codex_manifest, gemini_manifest, hermes_manifest, lookup_manifest,
        manifest_registry, openclaw_manifest, opencode_manifest,
    };
}

/// Capability vocabulary and negotiation entry point. Re-exports the canonical
/// router items so consumers can use `lifeloop::capability::*` without taking
/// a dependency on the `router` module path. The `CapabilityKind` /
/// `CapabilityRequest` split is preserved deliberately — `CapabilityKind` is
/// the identity used as a manifest lookup key, and `CapabilityRequest` adds
/// policy (`desired`, `level`).
pub mod capability {
    pub use crate::router::{
        CapabilityKind, CapabilityRequest, CapabilityRequirement, DefaultNegotiationStrategy,
        NegotiatedPlan, PayloadPlacementDecision, PlacementRejection, negotiate,
    };
}