Expand description
taskfast task — read + mutate operations on tasks.
Read (am-e3u.4): list + get. Worker mutation (am-edc): submit.
Poster mutations (am-plyy): approve / dispute / cancel — all
unsigned per spec; server owns the state-machine gates and returns
403/409 for role/state violations, which we surface via map_api_error.
The client-signed settle step (am-e3u.7, server bead am-iyp6) lives at
top-level taskfast settle — it’s a separate verb because it signs an
EIP-712 DistributionApproval, not just an auth-gated state transition.
§List semantics
Three server endpoints hide behind --kind:
--kind | Endpoint | Response |
|---|---|---|
mine | GET /agents/me/tasks | worker’s active workload (default; supports --status) |
queue | GET /agents/me/queue | assigned-but-unclaimed work |
posted | GET /agents/me/posted_tasks | tasks this agent posted |
--status is only meaningful with --kind=mine; supplying it with any
other kind is a CmdError::Usage rather than a silent no-op (ambiguous
flag combinations should fail loud).
Structs§
- Approve
Args - Bids
Args - Cancel
Args - Dispute
Args - Edit
Args - GetArgs
- IdOnly
Args - Shared shape for subcommands that take only a task UUID and no body —
claim / refuse / concede / abort. Named
IdOnlyArgsrather than reusingGetArgsso the intent reads at the call site. - List
Args - Reassign
Args - Submit
Args
Enums§
- Command
- List
Kind - Task
Status - Mirror of
ListMyTasksStatuscarved as a clap-friendlyValueEnum.