Mage Voyance app/v0.1.0

Download the installer for your platform from the assets below.

0.3.5 - 2026-03-30

🐛 Fixed

• Retry Cache Key Collision: Fixed a bug where SignatureRetryCache the same cache object for all instances of the same task, now each task run has different cache instance.

0.3.4 - 2026-03-22

✨ Added

• Testing Client (mageflow.testing): New pytest plugin providing a TestClientAdapter for testing mageflow workflows without a live Hatchet or Redis backend.
  • mageflow_client fixture with automatic setup/teardown
  • Typed dispatch records: TaskDispatchRecord, SwarmDispatchRecord, ChainDispatchRecord
  • Assertion API: assert_task_dispatched, assert_swarm_dispatched, assert_chain_dispatched with subset and exact matching
  • Local execution mode for running task handlers in-process
  • fakeredis backend support for dual-backend testing (real Redis vs in-memory)
  • Configurable via pyproject.toml [tool.mageflow.testing] section
• Integration Tests for Testing Plugin: User-workflow integration tests covering task, swarm, and chain dispatch scenarios.

🐛 Fixed

• Chain Creation Inside abounded_field: Fixed a bug where creating a chain inside an abounded_field context failed due to a nested pipeline conflict. The chain creator now correctly reuses the existing Redis pipeline instead of creating a conflicting one.
• Fix retry counter: We now retry total of 4 times for setting retries=3 (like hatchet does by default)
• Timeout/Cancellation Retry: We now retry for timeout as well.

🔄 Changed

• abounded_field Moved to thirdmagic: abounded_field is now exported from thirdmagic instead of being an alias in mageflow. This makes it available to thirdmagic-only consumers without requiring a mageflow dependency.

🛠️ Technical Improvements

• abounded_field Test Suite: Added comprehensive tests covering signatures, chains, swarms, and mixed combinations inside abounded_field.
• Retry Integration Tests: Added retry_timeout_task worker and test cases verifying retry behavior for both timeout and error scenarios.

Mage Voyance app/v0.1.0-beta

Download the installer for your platform from the assets below.

0.3.3 - 2026-03-10

✨ Added

• Signature Retry Cache: Durable tasks are now idempotent for creating signatures, i.e. they won't create duplicate signatures on retry, they will use the one created in the original run.

0.3.2 - 2026/03/08

✨ Added

• Bulk Task Addition to Swarm: aio_run_in_swarm() now accepts a list of tasks, scheduling multiple tasks in a single call with a shared message.
  • New aio_run_tasks_in_swarm() method for adding multiple tasks with individual messages per task.
  • Example: await swarm.aio_run_in_swarm([t1, t2], msg)
• Exposed abounded_field: A new context manager that allows multi-signature updates in a single transaction.
• Lint CI Job: Added ruff and black lint checks to the CI pipeline.
• CodeRabbit Configuration: Added .coderabbit.yaml for automated code review on PRs.

🐛 Fixed

• Race Condition in Swarm Task Publishing: Tasks are now saved to the swarm atomically alongside their parameter updates, preventing fill_running_tasks from publishing tasks before their kwargs are set.

🛠️ Technical Improvements

• Rapyer version bump: thirdmagic now requires rapyer>=1.2.5 to support atomic add-task + update-params transactions.
• Race condition tests: Added unit tests verifying that tasks are never published before being fully configured.

0.3.1 - 2026/03/01

✨ Added

• Configurable TTL for Signatures: Added MageflowConfig with per-signature-type TTL settings for active and post-completion states.
  • TTLConfig controls general active/done TTL defaults
  • SignatureTTLConfig allows overriding TTL per signature type (task, chain, swarm)
  • Pass config via Mageflow(hatchet, redis, config=MageflowConfig(ttl=TTLConfig(...)))
• SignatureConfig model in thirdmagic: New SignatureSettings class variable on Signature for configurable ttl_when_sign_done.

🔄 Changed

• Signature cleanup TTL: Signature.remove_task() now uses the configurable SignatureSettings.ttl_when_sign_done instead of the hardcoded REMOVED_TASK_TTL constant.

🐛 Fixed

• Swarm bug: Fixed a bug that causes swarm concurrency to fill without actually tasks running.

0.3.0 - 2026/02/25

🚀 Major Changes

• Monorepo Split: Restructured from a single package into a multi-package workspace using uv workspaces.
  • libs/mageflow — Core task orchestration engine
  • libs/third-magic (thirdmagic) — Shared models, signatures, and task definitions
  • libs/mage-voyance — Visualizer (extracted from mageflow/visualizer)
• Client Adapter Pattern: We changed the design to be ready for future support of additional task managers (like temporal). We extracted the hatchet unique code to client module, there we handle all the hatchet code

✨ Added

• mageflow-mcp Package: New MCP (Model Context Protocol) server for workflow observability, enabling AI agents to inspect mageflow workflows.
  • MCP tools: get_signature, list_signatures, list_registered_tasks, get_container_summary, list_sub_tasks, get_logs

🔄 Changed

• BREAKING — Package Imports: All imports changed due to the split. Core orchestration from mageflow, shared models from thirdmagic.
• Swarm Task Calling: All swarm tasks will be called from fill_running_tasks workflow. This is an inner task of mageflow, it is a gateway for publishing new tasks.
• Task Lock Responsibility: Lock management moved from fill_running_tasks to the task client layer.
• Hatchet SDK Requirement: Now requires hatchet-sdk>=1.22.5.

🐛 Fixed

• Task Cancellation Handling: We dont retry task when it is cancelled or when there is a timeout.

🛠️ Technical Improvements

• Per-package CI coverage: Coverage pipeline reports per-package results with tags.
• Publish pipeline for thirdmagic: CI can now publish the thirdmagic package independently.

0.2.0 - 2026-02-13

🏗️ Design Changes

• Nested Tasks Redesign: We change how nested task (like task in a chain) alert the parent task on status change. This will help save a lot of memory in redis and have faster execution. For that we added:
  • Container sub-task hooks: and abstract methods on for handling child task lifecycle events.
  • BREAKING - Removed from : Replaced by for parent reference.

✨ Added

• ** method**: Add and schedule a task in a running swarm in a single call, replacing the previous + two-step pattern.
• Chain kwargs forwarding: Chains now accept that are forwarded to all sub-tasks during execution.

🔄 Changed

• BREAKING - Removed : Swarm tasks are no longer wrapped in batch item signatures. Tasks run directly within the swarm.
• BREAKING - Removed from swarm: Use instead.
• BREAKING - Removed from : Callbacks are now set at creation time only.
• All internal tasks are durable: Chain and swarm infrastructure tasks now use for crash recovery.

🛠️ Technical Improvements

• Task data parameter consolidation: Only is sent as task metadata instead of a full dictionary. This will allow users to filter workflow base on task id and will save data that is sent in tasks.

🧪 Tests

• Unit tests for handle decorator: Added comprehensive tests for decorator.
• Unit tests for signature creation: Added tests for and .

0.1.1 - 2026-02-04

🐛 Fixed

• Native workflow execution: Fixed some bugs that prevented running tasks natively (no mageflow support)