#type #boundary #workflow #flowspec

worldinterface-core

Core domain types for WorldInterface: FlowSpec, IDs, Descriptor, Receipt

2 releases

new 0.1.2 Mar 19, 2026
0.1.0 Mar 13, 2026

#1345 in Data structures


Used in 8 crates

Apache-2.0

71KB
1.5K SLoC

Core domain types for WorldInterface.

This crate defines the foundational types shared across all WI crates:

worldinterface-core has no dependency on ActionQueue. It is a pure domain model crate.


worldinterface-core

Core domain types for WorldInterface: FlowSpec, IDs, Descriptor, Receipt.

Overview

This crate defines the foundational types used throughout WorldInterface with no ActionQueue dependency and no I/O:

  • id -- Strongly-typed UUID identifiers (FlowId, FlowRunId, NodeId, StepRunId)
  • flowspec -- Declarative workflow graph model (FlowSpec, Node, NodeType, Edge)
  • descriptor -- Connector self-description with input/output schemas
  • receipt -- Immutable content-addressed evidence of boundary crossings
  • metrics -- MetricsRecorder trait for cross-crate instrumentation

Node Types

ConnectorNode  -- External boundary crossing (HTTP, filesystem, etc.)
TransformNode  -- Pure data transformation (identity, field mapping)
BranchNode     -- Conditional routing (equals, extensible)

Part of the WorldInterface workspace

See the workspace root for full documentation.

License

Apache-2.0

Dependencies

~2.7–4MB
~78K SLoC