ProtoOS v0.2.0 — 통합 자율 프로토콜 운영 체제

참조 구현 — 정책 기반 제어 평면으로, 기존 에이전트 프로토콜(MCP, A2A, AP2 명령, x402, MPP, UCP/ACP 스타일 커머스, AG-UI, ANP/DID 스타일 신원)을 구성하여 에이전트가 구축, 발견, 조정, 인가, 결제, 감사되는 하나의 환경으로 통합합니다.

순수 Python 3.12 표준 라이브러리(+ Ed25519용 선택적 cryptography, OS 검증 HMAC 폴백). 네트워크 불필요.

관련: OpenMesha · rui · server-os

표면

Related MCP server: Agorus MCP Server

0.2.0의 새로운 기능 — Constellation 및 Obsidian vault

이제 세계는 일급 그래프이며, 웹 콘솔의 Constellation 탭과 동등합니다.

• protoos.graph.build_graph(os)는 라이브 객체 그래프(주체, 예산, MCP 서버/도구, AP2 명령 체인, 영수증, 작업, 대기 중인 승인)를 브라우저 빌드와 동일한 노드 유형/엣지 종류 어휘로 파생합니다(패리티 검사: MATCH).

• protoos.graph.layout(graph, seed=…)는 결정적 힘 기반 레이아웃입니다. 내보내기: to_json, to_dot, to_svg.

• protoos.vault.write_vault[_zip](os, dest)는 위키링크 노트로 구성된 Obsidian vault를 작성합니다. unresolved_links()는 무결성을 증명합니다.

• 강화: AuditLog.append는 페이로드를 깊은 복사합니다. TraditionalRail은 영수증을 보존합니다.

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

빠른 시작

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

사양 → 모듈 매핑

여기서 "참조 구현"의 의미

사양에 명명된 모든 프로토콜 표면은 프로세스 내에서 작동하고 테스트됩니다: 유료 도구가 있는 JSON-RPC MCP, A2A 작업 수명 주기, 전체 AP2 의도→장바구니→결제 명령 체인, 프로세스 내 파실리테이터를 사용한 x402 챌린지/정산, MPP 선불 세션, SSE를 통한 AG-UI 이벤트 스트림, DID 문서 및 well-known 게시. 이 샌드박스는 네트워크 이그레스, Kubernetes 클러스터, 외부 SDK가 없으므로 공개 인터넷이 필요한 모든 것은 로컬/루프백 등가물로 구현되고 traceability.json에 명시적으로 partial 또는 deferred로 표시됩니다. — 아무것도 조용히 생략되지 않습니다.

프로덕션 강화 경로

1. Rust 제어 평면 (X1): 여기의 모듈 경계는 의도된 서비스를 반영합니다. Python 빌드는 실행 가능한 사양입니다.

2. 스토리지 (X3): 인메모리 + JSONL → etcd/Postgres / 객체 스토리지 / 벡터 DB.

3. 레일 (M1/X6): 공식 x402/MPP/AP2 SDK가 기존 레일 이음새에 맞춰집니다.

4. 전송 (X4/X5): httpapi.py 옆에 gRPC/QUIC 추가.

5. 샌드박싱 (G4): SandboxedExecutor를 컨테이너/마이크로VM 격리로 교체.

설계 원칙

1. 대체하지 말고 구성하라

2. 정책 우선 자율성 (모든 민감한 작업은 게이트됨)

3. 암호화 명령 + 해시 체인 감사

4. 인간 개입을 일급 프리미티브로

5. 모든 것에 다중 레일 (도구, 메시징, 결제, 신원)

6. 정직한 partial/deferred 마커가 있는 오프라인 우선 참조

라이선스

Apache-2.0. 거버넌스 헌장 초안: GOVERNANCE.md.