Jido. Exec. Work
(Jido Action v3.0.0-beta.12)
View Source
A small description of one step-wise Flow work unit.
Jido.Exec.ready/1 returns ready work. Pass its token to Jido.Exec.step/2.
A token selects one native unit in one execution revision. Each mutation
invalidates all prior tokens, including tokens for work that remains ready.
Tokens can move with the current Execution to another local process. They
are opaque in-memory values, not native identities or storage data.
component_path contains authored names without splitting names on /.
It is nil for support work without one authored owner. kind is the
component kind, or :support when there is no single owner. role identifies
component execution, input/output work, or a support operation. A Map item
has a zero-based item_index; all other work has nil.
Step and wave results keep the input token and report the native unit's
status. A failed unit is an applied transition, so it can be returned in an
:ok tuple. Read the Flow result or error with Jido.Exec.result/1.
Work contains no application payload, native graph, callback, or exception.
Use Jido.Exec.native/1 for advanced native inspection.
Summary
Types
Authored component kind, or support without one authored owner.
The operation of this unit. Execute keeps the component's native granularity.
The status of this work unit, not the complete Flow.
A payload-free description of one native work unit.
Opaque selection of one ready unit in one execution revision.
Types
@type kind() ::
:step | :subflow | :choice | :map | :reduce | :iterate | :dispatch | :support
Authored component kind, or support without one authored owner.
@type role() ::
:execute
| :input
| :output
| :join
| :input_binding
| :fan_out
| :fan_in
| :map_item
| :map_empty
The operation of this unit. Execute keeps the component's native granularity.
@type status() :: :ready | :completed | :failed | :skipped
The status of this work unit, not the complete Flow.
@type t() :: %Jido.Exec.Work{ component_path: [String.t()] | nil, item_index: non_neg_integer() | nil, kind: kind(), role: role(), status: status(), token: token() }
A payload-free description of one native work unit.
@opaque token()
Opaque selection of one ready unit in one execution revision.