Module queue 

agents queue — deferred prompts queue. Three top-level subcommands:

• delete — remove one queued prompt by id.
• deliver — wake every queue-pending strict descendant of the caller (try-lock each AIH; spawn the idle ones with empty messages so they drain their own queues).
• read (nested) — sub-tier whose only leaf today is id, which fetches one piece of queued content by its prompt_contents.id. The wire shape mirrors RichContentPart (tagged by type).

Enqueue is no longer a CLI verb here — use agents message instead; it handles persistence under the hood. Drain is also gone — the API consumes queue rows directly via the WS reverse- attach read_message_queue / clear_message_queue server requests once a matching hierarchy comes online.

Modules

delete

agents queue delete — manually drop one queued prompt by its prompts.id (the id surfaced by agents queue list). Returns the deleted row’s metadata + content so callers can confirm exactly which item was dropped.

deliver

agents queue deliver — wake every queue-pending descendant agent of the caller.

read

agents queue read sub-tier. Two leaves:

Structs

ReadCommand

Intermediate clap level for the read sub-tier. Splitting it into its own wrapper (rather than a fattened ReadId variant on Command) gives the CLI surface agents queue read id <num> to match the user’s invocation style and keeps the door open for additional read <…> leaves later.

Enums

Command

Request

ResponseItem

Functions

execute

execute_transform