Sovereign Agent Logbook

Sovereign Agent Logbook

すべてのAIエージェントにはログブックが必要です。あなたのログブックはヨーロッパに置きましょう。

AIエージェント向けの、オープンソースで改ざんを検知できるログブックです。エージェントが記録する各アクション、ツール呼び出し、人間による承認を、独自のサーバー上の追記専用のハッシュチェーン形式のファイルに記録します。各エントリーには、誰が、何を、なぜ行い、誰の承認を得て、どのような結果になったかが記されます。オープンなModel Context Protocolに対応しているため、あらゆるモデル（Mistral、GPT-NL、Llama、Claude、GPT…）で動作します。

v0.1は動作する基本骨格であり、完成品ではありません。 ログの記録、チェーン化、シークレットのマスキング、検証、エクスポートに対応しており、このページに記載されているすべての主張にはテストがあります。現時点で対応していない機能については、ROADMAP.mdに正直に記載しています。

理由

EU AI Actは、高リスクAIシステムのプロバイダーとデプロイヤーに対し、ログを保持し、人間が介入できる状態を保つことを義務付けています（第12条、第14条、第26条第6項）。これらの義務の適用日は2026年8月2日、または規制対象製品に組み込まれたAIについては2027年8月2日でした。この日程は、Digital Omnibus on AI（Regulation (EU) 2026/1744、2026年7月27日発効）によって変更されました。ほとんどの高リスクシステムでは2027年12月2日に、規制対象製品に組み込まれたAIでは2028年8月2日に延期されました。期限は延びましたが、義務がなくなったわけではありません。重大なインシデントの報告（第73条）は同法の別章にあり、この延期の対象外です。ご利用のシステムにおける適用時期を確認してください。このログブックは、報告に使える、エージェントが記録したアクションの検証済みタイムラインを提供します。

自律型エージェントでは、こうした義務への対応がさらに難しくなります。1つのタスクで10回のツール呼び出しが行われることもあり、問題が起きたとき、誰の承認を得て、どの呼び出しで何が行われたのかを再構成できないことがあります。

この用途のツールの多くは米国のクラウドプラットフォーム上で動作するか、特定のモデルベンダー向けに作られています。独自ハードウェア上でオープンウェイトモデルを動かすような主権性を重視した環境に、手軽に導入できる中立的なツールはありません。そこで、このツールを作りました。

得られるもの

• 改ざんを検知できるログ。 各イベントには直前のイベントのハッシュが含まれます。行を変更、挿入、削除、並べ替えすると、logbook verifyが問題の正確な場所を示します。(約80行のファイル1つでの仕組み)
• あらゆるモデル、あらゆるホスト、またはクラウドなしで利用できます。 4つのMCPツール：log_event、verify_logbook、recent_events、export_logbook。
• 書き込み前にシークレットをマスキングします。 パスワード、トークン、APIキー、IBAN、BSNらしき値は、ハッシュ化する前に***masked***に置き換えられます。
• 公開テストで確認された、外部ネットワーク通信がない設計。 テストではPythonランタイムの外向きソケット接続を遮断しながら、書き込み、検証、エクスポートの一連の処理を最後まで実行します。別のテストでは、ログブックのコアがHTTPクライアントをインポートしないことを検証します。 (tests/test_no_network.py)
• 監査対応のエクスポート。 DPOや監査担当者が、このツールなしで読めるJSONとCSVを出力します。
• オープンなフォーマット。 SPEC.mdにはコードとは独立したログ形式が定義されており、Apacheライセンスのもと、ほかのツールからも書き込めます。
• スキルパック。 いつログを記録するか、何を書くか、いつ処理を止めて人間に確認するかを、あらゆるエージェントに教えます。(skills/sovereign-agent-logbook/SKILL.md)

5分でインストール

pip install sovereign-agent-logbook

MCP対応のエージェントホストから、stdio経由でサーバーに接続してください。Claude Desktop／Claude Code、Cursor、Continue、またはmcpServersブロックに対応するホストの場合：

{
  "mcpServers": {
    "logbook": {
      "command": "sovereign-agent-logbook",
      "env": { "LOGBOOK_PATH": "/var/lib/logbook/agent.jsonl" }
    }
  }
}

または、Dockerを使って自分のマシン上でサービスとして実行します：

docker build -t sovereign-agent-logbook .
docker run -d --name logbook \
  -p 127.0.0.1:8765:8765 \
  -v logbook-data:/data \
  sovereign-agent-logbook
# MCP endpoint: http://127.0.0.1:8765/mcp   (put TLS in front for anything beyond localhost)

その後、人間がいつでも次のコマンドを実行できます：

logbook --path /var/lib/logbook/agent.jsonl verify
logbook --path /var/lib/logbook/agent.jsonl export --format csv > audit.csv
logbook --path /var/lib/logbook/agent.jsonl tail --limit 10

イベントの例

{"spec":"0.1","seq":42,"id":"…","ts":"2026-11-05T20:41:03.123456+00:00",
 "prev_hash":"9f2c…","hash":"3a1b…",
 "agent_id":"invoice-bot","model":"mistral-small-4",
 "action":"pay_invoice","arguments":{"amount":1250,"iban":"***masked***"},
 "reason":"Invoice 2026-118 matches PO 4471 and is under the auto-approval limit",
 "approval":"auto","approved_by":null,"approval_rule":"pay-under-2000-matched-po",
 "outcome":"success","result_summary":"Paid via bank API, ref 88213",
 "run_id":"task-7f3e","tags":["finance"]}

フィールドの意味は、SPEC.mdで規範的に定義されています。

信頼性：ブラックボックスではありません

お約束すること	ご自身で確認する方法
改ざんを検知できます	ログブックファイルの任意の行を編集し、logbook verify を実行します
外部ネットワークへの通信はありません	tests/test_no_network.py。Dockerfile にネットワークツールは追加されていません
テストは公開され、変更のたびに実行されます	上記の CI バッジからすべての実行結果を確認できます
保護できない対象を明示しています	THREAT-MODEL.md
対応する AI Act の条項と、対応しない条項を明示しています	docs/ai-act-mapping.md
ソフトウェアよりも長く使える形式です	SPEC.md、Apache-2.0
セキュリティ問題への対応プロセスがあります	SECURITY.md
意思決定を記録しています	ROADMAP.md、CHANGELOG.md

特定のプラットフォームに依存しません

多くの開発者が GitHub を利用しているため、ここを作業用リポジトリとしています。 コードが単一のプラットフォームに依存しないよう、EU 内のインフラストラクチャ上に同一のミラーを作成する予定です。移行先は選定中で、決定後に ROADMAP.md に記録します。それまでは、git clone で完全なコピーを取得できます。それが git の利点です。

ホステッド版

サーバーを運用したくない場合に備え、EU 内限定のインフラストラクチャ（Hetzner、ドイツ／Scaleway、フランス）上にホステッド版を提供する予定です。保存期間ポリシー、チェーンの日次署名付きアンカリング、月次監査エクスポートが含まれます。delfen.ai/logbook に記載の利用条件は、付加価値税別で月額 €29、30 日間の無料トライアル、いつでも解約可能です。トライアル終了までにホステッド版が稼働していない場合、料金は請求されず、トライアルは取り消されます。

ライセンス

Apache License 2.0。オランダで Delfen が開発しています。貢献を歓迎します。CONTRIBUTING.md をご覧ください。