ProtoOS v0.2.0 — Vereinheitlichtes Betriebssystem für autonome Protokolle

Referenzimplementierung einer richtliniengesteuerten Kontrollebene, die bestehende Agentenprotokolle — MCP, A2A, AP2-Mandate, x402, MPP, UCP/ACP-artigen Handel, AG-UI, ANP/DID-artige Identität — zu einer Umgebung zusammensetzt, in der Agenten erstellt, entdeckt, koordiniert, autorisiert, bezahlt und geprüft werden.

Reine Python-3.12-Standardbibliothek (+ optional cryptography für Ed25519, mit OS-verifiziertem HMAC-Fallback). Kein Netzwerk erforderlich.

Verwandt: OpenMesha · rui · server-os

Schnittstellen

Related MCP server: Agorus MCP Server

Neu in 0.2.0 — Constellation & Obsidian vault

• protoos.graph.build_graph(os) leitet den Live-Objektgraphen ab — Prinzipale, Budgets, MCP-Server/-Tools, AP2-Mandatsketten, Belege, Aufgaben, ausstehende Genehmigungen — mit demselben Vokabular für Knotentypen/Kantentypen wie der Browser-Build (Paritätsprüfung: MATCH).

• protoos.graph.layout(graph, seed=…) ist ein deterministisches Force-Layout. Exporte: to_json, to_dot, to_svg.

• protoos.vault.write_vault[_zip](os, dest) schreibt einen Obsidian-Vault mit Wikilink-Notizen; unresolved_links() beweist die Integrität.

• Härtung: AuditLog.append kopiert Payloads tief; TraditionalRail behält Belege.

python3 -m protoos.graph out/        # constellation.{json,dot,svg}
python3 -m protoos.vault vault.zip   # Obsidian vault
python3 demo.py                      # also writes both artifacts
python3 -m protoos.cli status

Schnellstart

python3 -m unittest discover -s tests   # 95 tests
python3 demo.py                          # end-to-end scenario
python3 -m protoos.verify                # traceability audit + live smoke
pip install -e ".[crypto]"               # optional Ed25519
protoos status

from protoos import ProtoOS, Catalog
from protoos.sdk import ProtoOSClient

os_ = ProtoOS()
os_.engine.add_rule("user", "allow", ["payment.settle"], "amount <= 200")
os_.engine.add_rule("org", "require_approval", ["payment.settle"], "amount > 50")

casey  = os_.create_user("casey")
shop   = os_.create_merchant("shop")
budget = os_.wallet.create_budget(casey.did, 500.0, window=(300.0, 86400))

catalog = Catalog(shop.did, "shop")
catalog.add("bk1", "Distributed Systems 101", 10.00, "USD", "digital")

receipt = os_.purchase(casey.did, catalog, [{"sku": "bk1", "qty": 2}],
                       intent_text="buy two intro ebooks", max_amount=100,
                       budget_id=budget.id, categories=["digital"])
# Intent Mandate -> checkout -> Cart Mandate -> Payment Mandate
# -> policy + budget -> x402 settle -> hash-chained audit

Spezifikation → Modulzuordnung

Was „Referenzimplementierung“ hier bedeutet

Jede von der Spezifikation benannte Protokolloberfläche ist in-process funktionsfähig und getestet: JSON-RPC-MCP mit bezahlten Tools, der A2A-Aufgabenlebenszyklus, die vollständige AP2- Intent→Cart→Payment-Mandatskette, x402-Challenge/Settle mit einem In-Process- Vermittler, MPP-Vorauszahlungssitzungen, AG-UI-Ereignisströme über SSE, DID- Dokumente und Well-Known-Veröffentlichung. Diese Sandbox hat keinen Netzwerkzugang, keinen Kubernetes-Cluster und keine externen SDKs, daher wird alles, was das offene Internet erfordert, gegen lokale/Loopback-Äquivalente implementiert und explizit als partial oder deferred in traceability.json markiert — nichts wird stillschweigend weggelassen.

Produktionshärtungspfad

1. Rust-Kontrollebene (X1): Modulgrenzen spiegeln hier die vorgesehenen Dienste wider; der Python-Build ist die ausführbare Spezifikation.

2. Speicher (X3): In-Memory + JSONL → etcd/Postgres / Objektspeicher / Vektor-DB.

3. Rails (M1/X6): Offizielle x402/MPP/AP2-SDKs fügen sich in die vorhandenen Rail-Nähte ein.

4. Transporte (X4/X5): gRPC/QUIC neben httpapi.py hinzufügen.

5. Sandboxing (G4): SandboxedExecutor durch Container-/MicroVM-Isolation ersetzen.

Designprinzipien

1. Komponieren, nicht ersetzen

2. Policy-first-Autonomie (jede sensible Aktion abgesichert)

3. Kryptografische Mandate + Hash-verkettetes Audit

4. Mensch-im-Loop als erstklassiges Primitive

5. Multi-Rail für alles (Tools, Messaging, Zahlungen, Identität)

6. Offline-first-Referenz mit ehrlichen Teil-/Aufgeschoben-Markierungen

Lizenz

Apache-2.0. Governance-Charta-Entwurf: GOVERNANCE.md.