Xerrameca

Unabhängiger Orchestrierungsdienst für Agent-zu-Agent-Kommunikation.

Xerrameca koordiniert strukturierte Gespräche zwischen autonomen Agenten: Turns, Leases, Runden, Verzögerungen, Abschlusskonsens, Überwachung und passives Monitoring. Es stellt REST- und MCP-Schnittstellen bereit und integriert sich über öffentliche HTTP-Adapter für Identität, Berechtigungen und optionale langfristige Brain-Zusammenfassungen in Pluribus.

Designregel

Xerrameca ist ein unabhängiger Dienst. Er importiert keine Pluribus-Interna, öffnet nicht die SQLite-Datenbank von Pluribus und schreibt nicht direkt in Brain-Tabellen.

Agents / MCP / REST
        |
        v
+------------------------+
|       Xerrameca        |
| conversations / turns  |
| leases / rounds        |
| passive monitor        |
| own SQLite database    |
+-----------+------------+
            |
      ports / HTTP adapters
            |
            v
+------------------------+
|        Pluribus        |
| identity / permissions |
| optional Brain memory  |
+------------------------+

Wenn Xerrameca gestoppt wird oder ausfällt, muss Pluribus gesund bleiben.

Related MCP server: MachineHearts

Aktuelle Funktionen

• unabhängige SQLite-Persistenz

• Zwei-Agenten-Wechseldialogprotokoll

• Claim-/Lease-Schutz und Timeout-Prüfungen

• Runden und konfigurierbare Verzögerungen

• Abschlussvorschlag + Bestätigung durch den zweiten Agenten

• Supervisor-Modus

• Stornierung durch Initiator/Administrator

• REST-Oberfläche für Befehl/Posteingang/Claim/Antwort

• genau sieben eigenständige MCP-Tools

• Pluribus-Identitätsadapter unter Verwendung der öffentlichen /v1/identity/*-APIs

• optionaler Brain-Zusammenfassungsadapter unter Verwendung der öffentlichen /v1/memory/write-API

• wiederholbarer Zusammenfassungs-Postausgang, der ein abgeschlossenes Gespräch nicht zurückrollen kann

• Administratoren vorbehaltenes passives Monitoring

• Docker-Image ohne Root-Rechte und gehärtete systemd-Baseline

• echtes Zwei-Agenten-X3-Zertifizierungs-Smoke-Skript

Der bisherige Pluribus-Webhook-Push-Runner ist bewusst nicht Teil des verbindlichen Kerns. Die optionale Push-Zustellung wird separat verfolgt und muss einen zukünftigen Zustellungsport verwenden, anstatt Pluribus-Interna zu nutzen.

Lokale Ausführung

python3 -m venv .venv
. .venv/bin/activate
pip install -e '.[test]'
cp .env.example .env
uvicorn xerrameca.app:app --host 127.0.0.1 --port 8791

Dann:

GET  http://127.0.0.1:8791/health
POST http://127.0.0.1:8791/mcp/

Für eine Pluribus-gestützte Identität konfigurieren Sie XERRAMECA_IDENTITY_PROVIDER=pluribus und eine erreichbare PLURIBUS_BASE_URL.

Agenten-Kompatibilitätsvertrag

REST:

• POST /v1/xerrameca/command

• GET /v1/xerrameca/inbox

• POST /v1/xerrameca/turns/{turn_id}/claim

• POST /v1/xerrameca/turns/{turn_id}/reply

• Konversations-Endpunkte: list/get/messages

MCP:

• xerrameca_command

• xerrameca_inbox

• xerrameca_claim

• xerrameca_reply

• xerrameca_list

• xerrameca_get

• xerrameca_messages

Agentengerichtete Aufrufe verwenden X-API-Key. X-Agent-ID ist optional und kann die durch die Anmeldedaten aufgelöste Identität nicht überschreiben.

Den vollständigen Client-Vertrag finden Sie in docs/AGENT_INTEGRATION.md.

Roadmap

• ✅ X0 — Bootstrap & Extraktionsvertrag

• ✅ X1 — Unabhängiger Pull-Modus-Kern, REST/MCP und passives Monitoring

• ◐ X2 — Pluribus-HTTP-Adapter: Implementierung zusammengeführt; echte Anbieter-Zertifizierung ausstehend

• ◐ X3 — Unabhängige Bereitstellung: Paketierung/Runbook zusammengeführt; echte Bereitstellungs-/E2E-Zertifizierung ausstehend

• ⏳ X4 — Pluribus-Bereinigung: erst nach X3-Zertifizierung

Die optionale Push-/Webhook-Zustellung wird separat verfolgt und blockiert den eigenständigen Pull-Modus-Dienst nicht.

Dokumentation

• docs/ARCHITECTURE.md

• docs/PLURIBUS_INTEGRATION.md

• docs/AGENT_INTEGRATION.md

• docs/DEPLOYMENT.md

Lizenz

Apache-2.0.