metalcraft-flows 0.4.0

Specification and reference types for Flows — a serializable DAG format for AI agent workflows
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

//! # metalcraft-flows
//!
//! Reference types and helpers for the **Flow** specification — a serializable,
//! human-authored DAG format for AI agent workflows.
//!
//! See [`SPEC.md`](https://github.com/rust4ai/metalcraft-flows/blob/main/SPEC.md)
//! for the formal wire-format specification.
//!
//! ## Modules
//!
//! - [`model`] — core types: [`FlowDefinition`], [`FlowNode`], [`FlowEdge`],
//!   [`SavedFlow`], [`FlowNodeType`], [`CoreNodeType`].
//! - [`nodes`] — typed views over each node type's `data` payload.
//! - [`requires`] — declared integration-pack / tool dependencies and their
//!   validation and satisfaction checks.
//! - [`walk`] — graph traversal: BFS reachability and handle-aware stepping.
//! - [`eval`] — deterministic predicate evaluation for `conditional` nodes.
//! - [`template`] — `{{path}}` interpolation for string fields.
//! - [`state`] — the running `variables` bag and dotted-path helpers.
//! - [`validate`](mod@validate) — spec conformance checks.
//! - [`store`] — directory-backed CRUD (enabled by the default `fs` feature).
//! - [`log`] — flow execution log entries (enabled by the `log` feature).

#![deny(missing_docs)]
#![cfg_attr(docsrs, feature(doc_cfg))]

pub mod eval;
pub mod model;
pub mod nodes;
pub mod requires;
pub mod state;
pub mod template;
pub mod validate;
pub mod walk;

#[cfg(feature = "fs")]
#[cfg_attr(docsrs, doc(cfg(feature = "fs")))]
pub mod store;

#[cfg(feature = "log")]
#[cfg_attr(docsrs, doc(cfg(feature = "log")))]
pub mod log;

pub use eval::{evaluate, Operator};
pub use model::{
    CoreNodeType, FlowDefinition, FlowEdge, FlowNode, FlowNodeType, FlowScheduleSpec, FlowSummary,
    SavedFlow, ScheduleTrigger, SPEC_VERSION, SUPPORTED_SPEC_VERSIONS,
};
pub use nodes::BRANCH_ERROR_HANDLE;
pub use requires::{
    check_requirements, check_tools, derive_requires, AvailablePack, PackRequirement, Requires,
    Unmet,
};
pub use state::Variables;
pub use template::resolve as resolve_template;
pub use validate::{validate, ValidationError};
pub use walk::{next_by_handle, walk_bfs};

#[cfg(feature = "fs")]
pub use store::{delete_flow, list_flows, load_flow, save_flow};

#[cfg(feature = "log")]
pub use log::{append_flow_log, load_flow_logs, FlowLogEntry};