Xerrameca

独立したエージェント間オーケストレーションサービス。

Xerrameca は、自律エージェント間の構造化された会話を調整します: ターン、リース、ラウンド、遅延、完了コンセンサス、監視、パッシブモニタリング。REST および MCP インターフェースを公開し、アイデンティティ、権限、およびオプションの長期的な Brain サマリーのために、公開 HTTP アダプターを通じて Pluribus と統合します。

設計ルール

Xerrameca は独立したサービスです。Pluribus の内部をインポートしたり、Pluribus SQLite データベースを開いたり、Brain テーブルに直接書き込んだりしません。

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

Xerrameca が停止または壊れている場合でも、Pluribus は正常である必要があります。

Related MCP server: MachineHearts

現在の機能

• 独立した SQLite 永続化

• 2エージェント交互対話プロトコル

• クレーム/リース保護とタイムアウトチェック

• ラウンドと設定可能な遅延

• 完了提案 + 2番目のエージェントによる確認

• スーパーバイザーモード

• イニシエーター/管理者によるキャンセル

• REST コマンド/インボックス/クレーム/リプライサーフェス

• 正確に7つのスタンドアロン MCP ツール

• 公開 /v1/identity/* API を使用した Pluribus アイデンティティアダプター

• 公開 /v1/memory/write を使用したオプションの Brain サマリーアダプター

• 終了した会話をロールバックできない再試行可能なサマリーアウトボックス

• 管理者専用パッシブモニター

• 非ルート Docker イメージと強化された systemd ベースライン

• 実際の2エージェント X3 認定スモークスクリプト

レガシー Pluribus webhook プッシュ Runner は、意図的に必須コアの一部ではありません。オプションのプッシュ配信は別途追跡され、Pluribus 内部ではなく将来の配信ポートを使用する必要があります。

ローカルでの実行

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

次に:

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

Pluribus ベースのアイデンティティを使用するには、XERRAMECA_IDENTITY_PROVIDER=pluribus と到達可能な PLURIBUS_BASE_URL を設定します。

エージェント互換性契約

REST:

• POST /v1/xerrameca/command

• GET /v1/xerrameca/inbox

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

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

• conversation list/get/messages エンドポイント

MCP:

• xerrameca_command

• xerrameca_inbox

• xerrameca_claim

• xerrameca_reply

• xerrameca_list

• xerrameca_get

• xerrameca_messages

エージェント向け呼び出しは X-API-Key を使用します。X-Agent-ID はオプションであり、資格情報によって解決されたアイデンティティを上書きできません。

完全なクライアント契約については、docs/AGENT_INTEGRATION.md を参照してください。

ロードマップ

• ✅ X0 — ブートストラップ & 抽出契約

• ✅ X1 — 独立したプルモードコア、REST/MCP、パッシブモニター

• ◐ X2 — Pluribus HTTP アダプター: 実装はマージ済み、実プロバイダー認定は保留中

• ◐ X3 — 独立したデプロイメント: パッケージング/ランブックはマージ済み、実デプロイ/E2E 認定は保留中

• ⏳ X4 — Pluribus クリーンアップ: X3 認定後のみ

オプションのプッシュ/webhook 配信は別途追跡され、プルモードのスタンドアロンサービスをブロックしません。

ドキュメント

• docs/ARCHITECTURE.md

• docs/PLURIBUS_INTEGRATION.md

• docs/AGENT_INTEGRATION.md

• docs/DEPLOYMENT.md

ライセンス

Apache-2.0。