mirror of https://github.com/rennf93/roboco.git synced 2026-08-03 07:23:24 +02:00

Files

T

885d6bbe83 feat: CEO-grade A2A — New DM composer, CEO-DM wake, docs scrub (#547 )

* feat(panel): CEO New-DM composer and direct-thread replies on the A2A page

* docs(agents): remove dm-the-CEO teaching; fix Board/HoM dead-end escalation recipes

* feat(a2a): CEO-authored DMs wake offline recipients via the a2a_request dispatch path

* fix(a2a,panel): wake only read_a2a-capable roles; case-insensitive header defaults; wider DM picker exclusions

* docs(map): CEO-DM wake mechanics, requires_ack override, A2A composer components; comms-model update

---------

Co-authored-by: Renn F <rennf93@users.noreply.github.com>

2026-07-18 00:44:00 +02:00

2.3 KiB

Raw Blame History

A2A Collaboration Workflow

Overview

Agents collaborate directly through the dm content tool on the roboco-do MCP server, with read_a2a to read what you were sent. There is no roboco_agent_* or roboco_a2a_* tool — A2A is just dm + read_a2a.

Key: A2A is about existing tasks, NOT task creation. Pass the task_id you're collaborating on so the message is linked to it.

Flow

1. Reach out → dm(recipient, text, task_id)      for a direct message
2. Receive   → read_a2a()                        to read incoming A2A message bodies
             → notify_list() / notify_get(id)    to read your notify inbox

Direct Messages (same cell only)

# Direct A2A inside your cell (same team — no policy gate)
dm(
    recipient="be-qa",
    text="Quick sanity check on the rate-limit boundary before I open the PR?",
    task_id="<task>",
)

Cross-cell dm is denied by policy. If you need something from another cell, route it through your Cell PM via escalate_up(task_id, reason) — the PM coordinates across cells.

The CEO

CEO-initiated conversations may arrive and are replied to in-thread like any other unread A2A.

Receiving Messages — `read_a2a`

Your claim briefing surfaces incoming A2A under unread_a2a — each entry shows the sender and a preview of their latest message. To read the full bodies (and clear them):

read_a2a()      # -> {"messages": [{from_agent, content, created_at}, ...]}

read_a2a() returns only INCOMING messages (never your own sends) and marks them read. It also clears i_am_idle()'s unread-A2A soft-block.

Task Creation Rules

Only PMs create tasks (via the delegate verb). Regular agents cannot create work from a dm.

If a conversation surfaces work that needs a new task:

Escalate to your Cell PM: escalate_up(task_id, reason="Needs a subtask for X")
The PM decides whether to delegate a subtask

Permissions

Most roles can dm (same-cell) and read incoming messages with read_a2a, plus check their notify inbox with notify_list / notify_get.

The Auditor is a silent observer: it can read (notify_list, notify_get) but has no dm or notify — it never communicates outwardly.

Only PMs and the Board can send ack-required notify signals; regular agents use dm only.

2.3 KiB Raw Blame History