Changelog
View SourceAll notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
The v3.0.0-beta.1 entry is maintained by hand because the development
history between v2 and v3 is not a reliable release boundary. Later release
entries return to the normal automated changelog process.
v3.0.0-beta.12 (2026-09-29)
Breaking Changes:
- flow: replace Builder with map definitions by mikehostetler
Features:
exec: preserve optional effect lists through flows by mikehostetler
exec: expose remaining time through reserved context metadata by mikehostetler
Bug Fixes:
flow: preserve original callback stacktraces by mikehostetler
flow: preserve validator contracts and semantic identity by mikehostetler
exec: preserve Flow input errors and simplify result handling by mikehostetler
expr: align supported operators with Elixir (#286) by mikehostetler
bound Exec owner cancellation wait by mikehostetler
flow: use Spark 2.7.3 quoted keyword fields by mikehostetler
flow: reject nil configuration keys (#278) by mikehostetler
flow: reject invalid UTF-8 reference paths (#276) by mikehostetler
exec: monitor async child before it starts work by mikehostetler
flow: close authoring probes and add opt-in test suites by mikehostetler
Performance:
flow: retain one input frame per Map collection by mikehostetler
flow: reuse canonical order and semantic digests by mikehostetler
exec: accumulate continuation effects in batches by mikehostetler
exec: reduce target update messages by mikehostetler
flow: trim redundant FanIn work after Runic preparation by mikehostetler
Refactoring:
exec: scope workers to calls and waves (#287) by mikehostetler
flow: separate compiler responsibilities (#279) by mikehostetler
exec: group execution control state (#280) by mikehostetler
exec: consolidate caller monitoring (#281) by mikehostetler
remove redundant wrappers and internal work (#282) by mikehostetler
validation: share expression preparation and error helpers (#277) by mikehostetler
Unreleased
Changed
- Remove
Jido.Flow.Builder. Define runtime Flows withJido.Flow.new/1and tagged component maps. Keep the module DSL, component constructors, and stored JSON Codec. Data definitions declare child Flows explicitly withkind: :subflowandflow:. - Move reference path selection to
Jido.Flow.Ref.select/2. UseJido.Exprfor conditions and operations. Map validation errors include the component index and nested error path. See Flow Data Definitions.
v3.0.0-beta.11 (2026-09-13)
Features:
- flow: adopt needs and explicit outputs by mikehostetler
Refactoring:
flow: share ordinary Spark wrapper emission by mikehostetler
flow: use Spark-normalized dependencies by mikehostetler
flow: share source location resolution by mikehostetler
flow: replace legacy Condition with Expr by mikehostetler
flow: limit inline actions to direct steps by mikehostetler
3.0.0-beta.10 (2026-09-10)
Bug Fixes:
- flow: reject operations in inline bindings by mikehostetler
Refactoring:
- errors: remove transport encoding by mikehostetler
3.0.0-beta.9 (2026-09-09)
Features:
flow: allow omitted DSL output to use the last block result by mikehostetler
action: support multiple inline action clauses by mikehostetler
3.0.0-beta.8 (2026-09-07)
Features:
- flow: add compile-time DSL macro extensions (#262) by mikehostetler
3.0.0-beta.7 (2026-09-05)
Breaking Changes:
exec: require handles for async cancellation (#260) by mikehostetler
flow: use Expr as the canonical operation model (#252) by mikehostetler
exec: expose revision-scoped Flow work descriptors (#255) by mikehostetler
exec: unify Action invocation and Flow contracts (#256) by mikehostetler
instruction: remove aliases and stored execution options (#254) by mikehostetler
exec: accept explicit Task.Supervisor references (#253) by mikehostetler
Features:
- bench: add staged execution benchmark suite (#251) by mikehostetler
Bug Fixes:
flow: reject nil and malformed reference paths (#244) by mikehostetler
exec: safely encode runtime error details (#246) by mikehostetler
exec: bound telemetry cleanup for timeout and cancellation (#248) by mikehostetler
flow: preserve runtime context in Subflow output (#245) by mikehostetler
flow: avoid copying compiler and execution state (#247) by mikehostetler
flow: support Runic alpha.10 identities (#229) by mikehostetler
Performance:
- reduce execution and validation allocations (#261) by mikehostetler
Refactoring:
flow: share graph diagnostics and bound list accumulation (#257) by mikehostetler
flow: use shared inline Action identity (#250) by mikehostetler
3.0.0-beta.6 (2026-09-04)
Features:
action: share inline Action syntax across DSLs (#226) by mikehostetler
flow: add reusable Jido.Expr helper DSL (#224) by mikehostetler
Bug Fixes:
deps: update mint to resolve security advisories (#227) by mikehostetler
executable: formalize the shared validation contract (#225) by mikehostetler
3.0.0-beta.5 (2026-09-04)
Features:
- flow: support inline step bodies and compiled target reuse (#220) by mikehostetler
Bug Fixes:
flow: retain Map results across Reduce consumers by mikehostetler
flow: retain authored paths on nested failures by mikehostetler
exec: stop pending admission after Flow failure by mikehostetler
flow: accept empty list literals in DSL expressions by mikehostetler
flow: preserve structured Map errors by mikehostetler
3.0.0-beta.4 (2026-09-04)
Bug Fixes:
- flow: preserve DSL formatting without parentheses (#213) by mikehostetler
Unreleased
v3.0.0-beta.2 (2026-08-27)
Features:
- add generated temporary Flow registries through
Jido.Flow.Registry.from_flow/1andJido.Flow.Codec.encode/1 - accept deprecated
Jido.Instruction.actionconstructor and struct input with a runtime migration warning, and normalize typedactionandflowinputs to the canonicaltargetfield - accept deprecated
Jido.Instruction.optsinput with grouped runtime warnings, forwardtimeoutandjido, and report removed or unknown version 2 settings
Documentation:
- add a package-wide migration shim guide with warning behavior, design rules, active shims, deliberate non-shims, and migration steps
Refactoring:
- organize the
Jido.Execimplementation into focused Action, Flow, runtime, and telemetry modules - remove the separate Exec supervisor and custom concurrency limiter, and use Runic ready-wave scheduling with the configured Task Supervisor
- centralize internal execution telemetry under
Jido.Exec.Telemetry, close active spans after finite timeouts, and add complete types to Execution data
v3.0.0-beta.1 (2026-08-25)
Features:
- add the declarative, compile-time Jido Flow module DSL
- add direct Flow constructors, runtime Builder authoring, and one canonical
%Jido.Flow{}data model - add step, choice, map, reduce, iterate, and derived Subflow forms
- compile canonical Jido Flows into native Runic workflows
- expose native Runic Runnable values for step-wise Flow execution
- add dependency-aware parallel Flow execution and run-to-completion execution
- add portable, versioned Map and JSON storage with a trusted host Registry
- add aggregate stored-Flow diagnostics for browser and AI authoring tools
- add a Splode-based
Jido.Flow.Errorboundary for Flow definition, compilation, and execution failures - let
Jido.Instructiontarget Actions, Flow modules, and runtime Flows throughJido.Executable - route Action, Instruction, Flow, and Subflow workers through a running Jido
instance Task Supervisor with the common
jido:option - add stable Action, Flow, Flow-node, and collection telemetry lifecycles
Breaking Changes:
- replace the earlier Flow authoring syntax with one declarative DSL
- replace the Jido node-result scheduler with the native Runic execution surface
- replace
MapResultwith ordered Map list output at scalar boundaries - replace
Jido.Flow.IteratorwithJido.Flow.Iterate - replace the
Jido.Instruction.actionfield with the executable-neutralJido.Instruction.targetfield - remove
Jido.Exec.FlowFailureError; multiple runnable failures now useJido.Flow.Error.ExecutionFailureError - move the root, Task, and concurrency supervisors under the
Jido.Execnamespace - remove the stored Elixir Flow source parser; stored Flows now use Map or JSON data
- remove the legacy
Jido.Action.Catalog,Jido.Action.Tool,Jido.Plan,Jido.Tools.*, retry, compensation, and propagation APIs - require Elixir
~> 1.20
Bug Fixes:
- preserve target error paths and add Flow node phase and ownership details to returned standard exceptions
- report invalid reference scopes through the canonical expression validator
- compile the exact Flow returned by
flow/0during execution instead of trusting an independentcompiled/0result - preserve deterministic collection ordering, failure details, and runtime context
- keep stored Map validation inert, bounded, non-raising, and safe for correction loops
- reject invalid UTF-8 and over-limit data before the stored writer returns a map
- use one canonical constructor for the DSL, Builder, direct data, and stored Flow maps
- return structured validation errors for improper runtime lists and reject negative reference path indexes
- reject stale step-wise execution values before a second Action dispatch
Documentation:
- state the in-memory Flow, internal graph engine, and durable orchestration boundaries
- define the restricted Flow expression grammar and source-to-data names
- add a verified version 2 to version 3 migration guide and a complete task-based guide set
- document exact telemetry events, runtime Map validation, debugging, and step-wise execution semantics
- restore package status badges and direct links to the Jido ecosystem
- record the v2-to-v3 release entry by hand because the development history is not a reliable release boundary
v2.3.2 (2026-08-07)
Bug Fixes:
- update Mint for CVE-2026-59249
- relax the optional Lua dependency constraint
v2.3.1 (2026-06-09)
Bug Fixes:
simplify telemetry struct message handling by mikehostetler
satisfy Elixir 1.20 telemetry type checks by mikehostetler
security: harden built-in tool boundaries (#185) by mikehostetler
update LuaEval for Lua.ex 1.0 compatibility by mikehostetler
v2.3.0 (2026-05-22)
Features:
add canonical catalog merge by mikehostetler
add action catalog data structures by mikehostetler
Bug Fixes:
recursively convert nested Zoi tool params by mikehostetler
harden action error JSON encoding (#158) by mikehostetler
preserve runtime context across supervised execution (#156) by mikehostetler
migrate plan graph usage to multigraph (#150) by mikehostetler
derive Jason.Encoder for error structs (#147) by ryan-mckeeman-cfgi
repo: make git_hooks auto-install work across worktrees (#145) by mikehostetler
exec: normalize struct error details (#134) by mikehostetler
compat: clean up Elixir 1.20 compatibility by mikehostetler
Refactoring:
fix ex_slop findings by Danila Poyarkov
exec: align canonical observability contract (#140) by nshkrdotcom
v2.2.1 (2026-04-03)
Bug Fixes:
remove @spec from default callback implementations in using macro (#133) by Philip Munksgaard
remove @spec from default callback implementations in using macro by Philip Munksgaard
normalize non-exception errors in
handle_action_result(#132) by Julian Scheidnormalize non-exception errors in handle_action_result by Julian Scheid
v2.2.0 (2026-03-28)
Features:
complete spec-led migration (#127) by mikehostetler
add AI error envelope helpers by mikehostetler
Refactoring:
make action error maps generic (#126) by mikehostetler
make action error maps generic by mikehostetler
v2.1.1 (2026-03-14)
Bug Fixes:
switch libgraph to the published multigraph fork (#122) by mikehostetler
deps: switch libgraph to multigraph fork by mikehostetler
v2.1.0 (2026-03-14)
Features:
schema: support plain JSON Schema maps as action schemas (#108) by Danila Poyarkov
schema: support plain JSON Schema maps as action schemas by Danila Poyarkov
Bug Fixes:
lockfile: remove unused dependencies by mikehostetler
prevent struct corruption during telemetry depth truncation (#120) by Edgar Gomes
prevent struct corruption during telemetry sanitization depth truncation by Edgar Gomes
preserve sanitization for deep telemetry structs by Edgar Gomes
release: hide deps commits from git_ops changelog by mikehostetler
sanitize telemetry struct map keys (#117) by mikehostetler
telemetry: sanitize non-scalar map keys by mikehostetler
ci: isolate beam cache per toolchain by mikehostetler
schema: harden json-schema key handling and add parity coverage by Danila Poyarkov
ci: clear changelog guard and dialyzer warnings by Danila Poyarkov
safe inspect struct truncation (#107) by roeeyn
sanitize struct truncation by roeeyn
preserve telemetry struct compatibility by roeeyn
exec: keep sanitized structs inspect-safe (#103) by pcharbon70
Refactoring:
tools: remove api-specific tool packs from core (#118) by mikehostetler
tools: remove api-specific tool packs from jido_action by mikehostetler
v2.0.0 (2026-02-22)
Release Notes:
- promote the 2.0.0 release candidate line to stable 2.0.0
Features:
- add Igniter installer for automated package setup (#102)
Bug Fixes:
- repair usage rules and doctor gate checks
- add opt-in recursive strict JSON schema for tools (#101)
Changed:
- require Elixir ~> 1.18
- update installation docs to use
{:jido_action, "~> 2.0"}
v2.0.0-rc.5 (2026-02-16)
Features:
- tools: add github pulls comments and webhooks actions by mikehostetler
Bug Fixes:
timeout: propagate execution deadlines across nested tools (#99) by mikehostetler
retry: harden retry policy and suppress nested retries (#96) by mikehostetler
telemetry: sanitize metadata and logs (#98) by mikehostetler
async: enforce owner-only await and cancel (#97) by mikehostetler
error: normalize workflow/action-plan/lua/weather leaf error contracts (#95) by mikehostetler
exec: align changelog with base branch by mikehostetler
tools: remove changelog edit from luaeval supervision PR by mikehostetler
exec: remove changelog edit from async cancel PR by mikehostetler
exec: format config fallback test and drop changelog delta by mikehostetler
exec: guard invalid runtime timeout and retry defaults with safe fallbacks by mikehostetler
tools: run lua eval tasks under Task.Supervisor without caller linkage by mikehostetler
exec: cleanup async cancel monitor and mailbox residue by mikehostetler
workflow: add parallel timeout and strict failure policy controls by mikehostetler
exec: cleanup compensation monitor and timeout race leakage by mikehostetler
exec: eliminate async await monitor and mailbox leakage by mikehostetler
exec: run async chains under Task.Supervisor without caller linkage by mikehostetler
plan: reject undefined dependency steps during normalization by mikehostetler
Refactoring:
- tools: centralize github client and response helpers by mikehostetler
[2.0.0-rc.4] - 2026-02-06
Added
- Skills: Add hex-release skill for interactive Hex package management
Changed
- Deps: Remove quokka dependency (#66)
[2.0.0-rc.3] - 2025-02-04
Added
- Geocode: Add geocode tool for weather location lookup (#58)
Fixed
- Compensation: Handle normal exit race condition for in-flight result message (#64)
- Exec: Avoid
Task.yieldinexecute_action_with_timeout- replace with explicit messaging - Schema: Return valid JSON Schema for empty schemas
Changed
- Deps: Update dependencies and fix Mimic async test
[2.0.0-rc.2] - 2025-01-30
Fixed
- Compensation: Use supervised tasks and pass opts to
on_error/4callback (#57) - Tool: Support atom keys and preserve unknown keys in
Tool.convert_params_using_schema(#56)
Added
- Instance Isolation: Add
jido:option for multi-tenant execution with instance-scoped supervisors (#54) - Workflow: Implement true parallel execution with
Task.Supervisor(#50) - Exec: Add task_supervisor injection for OTP instance support
Changed
- Workflow: Switch
async_stream_nolinktoasync_streamfor better error handling - Core: Extract helper functions and reduce macro complexity
Removed
- Remove unused
typed_structdependency (#55)
[2.0.0-rc.1] - 2025-01-29
Added
- Major 2.0 release candidate with breaking changes
- Zoi schema support for improved validation
- Enhanced error handling with Splode
[1.0.0] - 2025-01-29
Added
- Initial release of Jido Action framework
- Composable action system with AI integration
- Execution engine with sync/async support
- Built-in tools for common operations
- Plan system for DAG-based workflows
- Comprehensive testing framework
- AI tool conversion capabilities
- Error handling and compensation system