Register a persistent sub-agent that owns the context of one task.

The agent keeps its conversation memory for the whole server session and logs every exchange to .autogen-swarm/agents/.jsonl in the project the session runs in.

Args: name: Unique identifier (must be a valid Python identifier, e.g. "auth_refactor"). model: ":" or alias "opus" / "heavy" / "cheap". role: The task this agent owns — becomes part of its system prompt and is what other agents will ask it about. system: Optional extra persona/instructions. tier: "heavy" (can initiate conversations via its converse tool) or "cheap" (must emit NEED_INFO lines for the manager to relay). Defaults to "cheap" for the cheap alias, "heavy" otherwise.

Send a message to a registered agent and return its reply (manager channel).

Context persists across calls — the agent remembers previous exchanges. Check info_requests in the result: any NEED_INFO(...) lines mean the agent is blocked on information owned by another agent. Fetch the answer from the responsible agent (another send_message) and relay it back to the requester with a follow-up send_message.

List all registered persistent sub-agents.

Return an agent's exchange history starting at entry since.

Unregister an agent and release its model client. Its log file remains.

Start an autonomous multi-agent conversation running in the background.

Args: topic: The task or question the agents discuss. agents: Optional participants, each {"name", "model", "system"}. "model" is ":" — e.g. "anthropic:claude-opus-4-8", "deepinfra:zai-org/GLM-5.2" — or an alias: "opus", "heavy", "cheap". Defaults to an opus + GLM-5.2 pair (proponent vs critic). max_rounds: Full round-robin rounds before the conversation ends.

Returns the conversation_id to use with get_transcript / inject_message / stop_conversation. Poll get_transcript to follow progress.

Return a conversation's status and its turns starting at since_turn.

Pass the previous total_turns as since_turn to get only new turns.

Queue a steering message for a running conversation.

Delivered to the agents at the next round boundary (after the current round-robin round completes).

Cancel a running conversation. The transcript so far is preserved.

List all conversations known to this server session.