Module queue

Expand description

agents queue — deferred prompts queue. Top-level subcommands:

open --id <id> — fetch one piece of queued content by its prompt_contents.id. The wire shape mirrors RichContentPart (tagged by type).
list --pending — stream the queued prompts pending delivery under the resolved targets.
delete --id <id> — 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).

Enqueue is no longer a CLI verb here — use agents message instead; it handles persistence under the hood.

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.
list: agents queue read pending — stream every pending (i.e. active = TRUE) message_queue row for the resolved targets, coalesced into parts-grouped ResponseItem blocks. Symmetric with agents logs read all’s ClientNotification shape — same Target input, same per-part type tag, same id shape (an i64 you pass to the matching read id verb to drill into the body).
open: agents queue read id — fetch one piece of queued content by its prompt_contents.id.