Skip to main content

Module task

Module task 

Source
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:

--kindEndpointResponse
mineGET /agents/me/tasksworker’s active workload (default; supports --status)
queueGET /agents/me/queueassigned-but-unclaimed work
postedGET /agents/me/posted_taskstasks 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§

ApproveArgs
BidsArgs
CancelArgs
DisputeArgs
EditArgs
GetArgs
IdOnlyArgs
Shared shape for subcommands that take only a task UUID and no body — claim / refuse / concede / abort. Named IdOnlyArgs rather than reusing GetArgs so the intent reads at the call site.
ListArgs
ReassignArgs
SubmitArgs

Enums§

Command
ListKind
TaskStatus
Mirror of ListMyTasksStatus carved as a clap-friendly ValueEnum.

Functions§

run