Expand description
The agent layer (mirrored ontology C8, docs/architecture/orchestrator.md §2.10): declared
agents, conversations separate from sessions (G5, as amended by M3), transfers and handoffs
(G2), usage and budgets (G3). Bindings name their conversation and agent (G1); routes name an
agent. Agent identity itself (ids, sponsor, lineage) lives with Teams and the orchestrator’s
agent store; these records are the home’s intent and its conversations’ record.
Structs§
- Agent
Decl - One agent this home declares: who answers, and which profile is its template. A named profile implies its own agent of the same name; a declaration names others (several agents may share one profile) and the parent each is declared under.
- Budget
- A per-action gate on a profile’s agents: a start or resume over it is refused, with the reason, and the refusal is told to the manager and the sponsor. It never pauses or ends anything itself.
- Budget
Limit - What a budget bounds.
- Conversation
- A conversation, a Resource separate from the sessions bound to it (G5, amended by M3).
- Cost
- A cost, as the provider reported it or a rate table priced it.
- Handoff
- A session moving to another conversation (Hermes
/handoff, kept by the naming rule). - Participant
- A person or an agent in a conversation.
- Session
Usage - A session’s usage, kept on the session and summed upward (session → agent → sponsor → Org).
- Transfer
- One agent handing a conversation to another (OpenAI handoff, AutoGen Swarm, voice
hand_off). - Usage
- One measured use of a model, from the harness’s own records (G3).
Enums§
- Budget
Period - A budget’s window.
- Conversation
Kind thread: a root and its replies, wherever it is shown;private: a harness session’s own input.- Handoff
State - A handoff’s progress.
- History
Ref - Where a conversation’s record lives.
- Participant
Role - How a participant is addressed on a thread (amendment M3).
- Speaker
Policy - Which bound agents receive a line on a shared surface (G1).
- Transfer
History - How much of the conversation a transfer’s receiver is given.
- Transfer
State - A transfer’s progress.