Summary
Add the ability to inspect how far along a container signature is (Swarm / Chain), and a client-level function to query several containers at once.
Deliverables
- Container progress — a
container_status() coroutine on ContainerTaskSignature, implemented for SwarmTaskSignature and ChainTaskSignature, returning a structured ContainerStatus model (not a bare number) with:
total, finished, failed, running, pendingpercentage, status, is_done
mageflow.astatus(*ids) — loads multiple signatures at once, verifies each is a container, and returns a ContainersStatus wrapper model (with an aggregate overall_percentage).
Decisions
- Function name:
astatus (matches asign / achain / aswarm).
- A missing id or a non-container signature (e.g. a plain
TaskSignature) raises a clear error (MissingSignatureError / new NotAContainerError).
- Percentage is terminal-state:
(finished + failed) / total.
Tasks
Summary
Add the ability to inspect how far along a container signature is (Swarm / Chain), and a client-level function to query several containers at once.
Deliverables
container_status()coroutine onContainerTaskSignature, implemented forSwarmTaskSignatureandChainTaskSignature, returning a structuredContainerStatusmodel (not a bare number) with:total,finished,failed,running,pendingpercentage,status,is_donemageflow.astatus(*ids)— loads multiple signatures at once, verifies each is a container, and returns aContainersStatuswrapper model (with an aggregateoverall_percentage).Decisions
astatus(matchesasign/achain/aswarm).TaskSignature) raises a clear error (MissingSignatureError/ newNotAContainerError).(finished + failed) / total.Tasks
ContainerStatus/ContainersStatusmodels +NotAContainerErrorcontainer_status()on Swarm and Chainastatus(*ids)aggregator +HatchetMageflow.astatus+ package exports