agentic_workflow 0.1.1
agentic_workflow: ^0.1.1 copied to clipboard
A typed graph engine for agent workflows: validation before execution, branching, parallelism, loops, budgets, human approval and resumable runs.
Changelog #
0.1.1 #
- Shortened the package description to the 60-180 character window pana scores against. Search engines truncate anything longer, so the ten points it withheld were pointing at a real defect: the useful half of the sentence was never being shown.
0.1.0 #
Initial release of the workflow engine.
Added #
- Graph —
WorkflowGraphvalidates on construction and refuses to exist in an invalid state, reporting every problem at once: missing inputs, unreachable nodes, undeclared cycles, ambiguous routes, concurrent writes to one key, and unknown edge or jump targets. Key availability is computed as an intersection over every path in, so a value written on only one branch is caught.WorkflowBuilderassembles chains and branches;toMermaidrenders a diagram from the real graph. - Nodes — start, end, custom, transform, condition, switch, LLM, structured
LLM, agent, tool, parallel, map, loop, delay, human approval and generic wait.
WorkflowNodeisbase, so domain-specific nodes are ordinary subclasses. - State —
WorkflowState, immutable, with declared access and a serialisability check that names the offending key. - Engine —
WorkflowEnginewith per-run budgets on steps, per-node visits and wall clock; write-schema checking; failures returned with the trail rather than thrown; cancellation propagated. - Suspension — a run pauses into a JSON
WorkflowSnapshotthat survives the process, andresumerestores it, keeping the original run identifier. Resume values are validated against the suspension's schema, and resuming into a changed graph is refused. - Events —
WorkflowStarted,WorkflowNodeStarted,WorkflowNodeCompleted,WorkflowSuspendedandWorkflowCompleted.