Module instances 

instances tier — aggregate enumeration backing agents instances {list, get}.

Reports per-agent stats joined across three tiers: objectiveai.messages (spawn/active timestamps + total logged), message_queue (active queued count, resolving tag-targeted rows through tags), and tags (the tag names bound to each agent).

Two entry points share one aggregate, differing only in which agents they scope to:

• list_under_parent — the DIRECT children of a parent AIH.
• get_exact — one exact agent AIH.

Functions

get_exact

Aggregate stats for one EXACT agent AIH. Always returns an item: when the agent has no logs/queue activity it is zero-filled (its AIH + bound tags + zero counts + null timestamps), so an explicitly-named target always yields a row.

list_all

Aggregate stats for EVERY agent seen in the logs or queue tiers — the --all form of agents instances list, no target filtering.

list_under_parent

List the DIRECT children of parent (AIH LIKE '{parent}/%' with no further / — parent itself and deeper descendants excluded), with per-agent aggregates. Sorted by AIH ascending.