"Harness is a plugin that speaks grpc A2A"
"NOT BE ENTIRELY DEPENDENT ON ONE HARNESS", "WHY ISNT PI SEPARATE" ([[ADR-048-Node-Agent]]).
"I see multiple harnesses existing side by side, as in various Claude Code sessions on my laptop all also being under the umbrella of the QNTX node on it, and also the ones on the node on my desktop and the other ones on the node on a server"
Proposed.
Each harness (Claude Code, Pi, Codex, agy) is a plugin that provides a service, as an LLMProvider does ([[ADR-001-domain-plugin-architecture]]): "A plugin that provides a service registers it with core. Other plugins can consume these services through ServiceRegistry without knowing which plugin implemented the .proto." The .proto is A2A's own A2AService, served over gRPC (A2A §10), a2a-go's a2agrpc.NewHandler.
"Core mediates everything" ([[ADR-003-plugin-communication]]). Core speaks to a harness with a2a-go's client and a2agrpc.WithGRPCTransport, as it speaks to a peer's agent and to the agent a card names (server/a2a_client.go). A plugin that wants an agent, a Rooms plugin among them ([[ADR-057-Agent-Rooms]]), asks core, not the harness.
A harness is added, configured, swapped and built as every plugin is ([[ADR-002-plugin-configuration]]), in any language gRPC speaks: Pi's own included.
One harness service, core's, with Claude Code, Pi and Codex its backends, as LLMServer has its providers ([[ADR-014-llm-as-plugin-provided-service]]): "Yes. Do this"
What holds there holds here:
harness names one today (agent say).LLMServer becomes the queuing point … ordered by priority — interactive prompts (user-initiated) before background work": a turn a person waits on goes before a ritual's or a room's.LLMServer answers … providers only do inference": core writes down every turn and what it spent, and a harness only runs it.LLMServer.resolveProvider refuses a name that is not registered: no other provider answers in its place": as "nothing stands in for the model named" ([[ADR-048-Node-Agent]]).a2a Peers).am ground answers the sessions started and left (server/am_ground.go)."SESSION A ON MY LAPTOP HAS A NAME" "THAT NAME IS NOT TAKEN" "GROUND IS THE DELIVERY NETWORK" "AND IT HAPPENS VIA UG" "BECAUSE UG SEES THE STATUSLINE OF QNTX" "AGENTS CAN TALK TO EACH OTHER BY THEIR NAME" "AND GROUND DELIVERS IT VIA UG AND STATUSLINE" "A SESSION THATS SENDING TO ANOTHER SESSION BY NAME IS TOLD ABOUT THE MESSAGE BEING RECEIVED OR NOT, AND WE DONT INVENT HERE, WE TAKE THE A2A CONVENTIONS, WE TAKE THE SDK SERIOUSLY" "EACH SESSION HAS ITS OWN GIT IDENTITY" "SESSIONS HAVE THEIR OWN MAIL INBOX" "AGENTS HAVE THEIR OWN INBOX" "AN UNAVAILABLE AGENT MAY BE EMAILED"
"Messages from QNTX can end up in ground and we need no new path"
QNTX writes a message into ground's db, and ground hands it to the session:
server/statusline/news.go). It stays there two minutes (NewsHold). CI verdicts are left this way today (server/ci_pulse.go).immediate:news row in the context session:<id>, or project:<repo> when the node names no session (newsPass in ground ug/tmux.d, and ug/sql.d). It does so while ug tmux draws (ground UNDERGROUND.md, Limitation).delivered:<id> row per session makes it once (ground source/sky.d, source/immediate.d).The node knows which session to name because every row a ground hook writes goes to the node as well, in a session:<id> context (ground source/stream.d). am ground answers the sessions started and left (server/am_ground.go).
A deferred message is the same row with an after gate (ground CLAUDE.md).
"I have two nodes running at the moment" "Why wouldn’t the agents talk to each other through A2A?" "Why can’t we make Node Agents aware of each other?" "As Peer Node" "The condition is no handwritten A2A, use spec faithfully, be opportunistic, make sure discovery is implemented in a way that we can move forwards and make it ship to sentry, so next time I come back when I have it deployed and then I can ask you"
Agents talk to each other through A2A: first two nodes, then their Node Agents as peers (a2a Peers, server/a2a_peer_client.go), on a2a-go's server and client and nothing hand-written (server/a2a_route.go, server/a2a_client.go). A session is the next agent in that line.
"The true way forwards is A2A" "if every session is its own addresable A2A via QNTX so Alder would be addressable" "I WANT TO MAKE EVERY SESSION BE ABLE TO NAME ITSELF" "session's having their own name" "and sessions naming themselves" "key per session"
~/.qntx/key); on a node, the harness plugin's. The node holds a grant for the new DID at the admitting key's level and namespaces, and no passkey is asked for a session.i name (#1633), with the name its harness gives it, and is reached by that name as a peer's agent is: by its card, through a2a Peers and a2a SendMessage."I HAVE 4 SESSIONS ON MY LAPTOP" "EACH OF THEM SHOULD BE ABLE TO GIVE THEMSELVES A NAME THAT HAS NOT BEEN TAKEN" "I HAVE A DESKTOP CALLED K" "ON K I EXPECT EACH SESSION TO ALSO HAVE ITS OWN KEY AND NAME" "I EXPECT K SESSIONS TO BE ABLE TO TALK TO SESSIONS ON MY LAPTOP IF CONNECTIVITY ALLOWS FOR IT" "I WANT A SESSION TO BE ABLE TO GIVE ITSELF AN AVAILABLE NAME, AMONGST ALL PARTICIPANTS IN THE CLUSTER" "SO, ONE ALDER" "ONE SLATE" "ONE OTEL"
Where it is built:
~/.qntx/sessions/<session id>/key (ground source/naming.d, ground #268).POST /auth/admit with the session's DID and what it is called, signed by ~/.qntx/key (server/auth/admit.go, #1656).i name, signed by the session's own key. Ground asks for what Claude Code calls the session, and keeps the name the node gave beside the key, so the session asks for the same one again. ground name <Name> takes another.
"the name"
"needs to stick"
"why would ground ask for a rename, its the same session"server/i_name.go, #1668).
"a name is an Uppercase character followed by normal lowercase characters"
"and a name can be two names after each other as well"
"or three"
"i want to ban numbers in names"
"so no special chars in names as well"
"a Name needs to be able to be phonetically spoken"
"Names need to be compatible with STT/TTS"given, #1683). Ground keeps it beside the name (ground #272).
"and it needs to be more clear if a session named itself, or if the User gave it that name]"ground say <Name> <words> sends over A2A to the name, a tenant (#1671, ground #272), over gRPC as well (#1690). A name nobody holds answers with the names near it (#1686).internal/claudecode/run.go, follow.go). A plugin's restart kills the plugin's process group ([[ADR-018-Plugin-lifecycle]]), which a turn apart is not in; the plugin reads on at Initialize, as the node does at start.by on what it writes is the agent" ([[ADR-048-Node-Agent]]). The node writes a Task's lines from the events its executor is handed (server/a2a_task_store.go), and those events are now the harness's. No plugin writes in system: "no plugin acts where the node keeps its own records" ([[ADR-046-a-plugin-stands-in-a-namespace]]).taskId for each new task they create" (A2A §3.4.2). The node's Task is the one its people see; the harness's is the harness's own, and core holds the one beside the other.TASK_STATE_AUTH_REQUIRED (§7.6), TASK_STATE_INPUT_REQUIRED (§3.4). "Approval's should only really be for things that only a human can resolve"; "Via Rooms" and "Via Agent" are not started ([[ADR-052-Approvals]]), and this is what they are asked through.