仕組み
カーネルを内側から見ます。誰が関わるのか、タスクがどう進むのか、カーネルが何を保持するのか、そしてよく出る用語がここでどういう意味かを説明します。カーネルはRustで書かれていて、モデルは呼び出しません。どのモデルのエージェントも、MCPのクライアントとして参加します。
誰が関わるか
読み取りエージェント
ロール:swarm
どのモデルでも、MCPクライアントとして参加できます。各エージェントは自分のトークンを持ち、自分のロールのツールだけを利用できます:audit_acquire、audit_submit、audit_renew、audit_release。リースされた一つのタスクに取り組み、タスクの間には何も保持しません。渡されるのは指示だけです。
オーナー
ロール:owner
コーパスを運用する人です。オーナーのトークンでは、次のようなツールを使えます:audit_status、audit_record、audit_fallen、audit_coverage、audit_revoke、audit_withdraw_text、audit_terminal_receipt、audit_close。撤回、記録の読み取り、実行の終了ができるのは、オーナーだけです。
カーネル
sbgk audit-serve
作業をタスクに分け、リースし、エージェントが提出するすべての行を確認し、ジャーナルを保持し、撤回が何に及ぶかを見つけます。モデルは呼び出しません。モデルはエージェント側にあります。
コードには、実験的で既定では無効な機能として、専用のロール(builder)を持つグラフビルダーもあります。既定のv0.1プロファイルには含まれず、このページもそれに頼っていません。
タスクの一生
一つのエージェントから見た流れです。
カーネルが作業をタスクに分ける
コーパスはタスクに分けられます。たとえば「この文書のこのバイト範囲を読む」です。タスクには指示が付きます。何を読むか、問い、すでに何が記録されているか、です。
一つのエージェントがタスクをリースする
エージェントが
audit_acquireを呼ぶと、タスクはそのエージェントだけにリースされ、リースの間は他のエージェントには渡りません。リースが切れると、カーネルはタスクを取り戻し、別のエージェントに渡します。エージェントは、リースを更新したり手放したりすることもできます(audit_renew、audit_release)。エージェントが記録で答える
渡された範囲を読み、JSON行で答えます:
observe(正確な引用)、claim(based_on付き)、relation、hypothesis、question、done。送るのは引用のテキストであり、オフセットではありません。カーネルがすべての行を確認する
audit_submitでは、すべての行が記録される前に確認されます。引用は、そのエージェントにリースされた範囲の中にバイト単位で一致する形で存在しなければならず、そうでなければ拒否され、何も保存されません。主張は有効な記録だけを根拠にでき、IDとサイズには上限があります。通ったものが書き留められる
受け入れられた各トランザクションは、ジャーナルの1つのフレームになり、記録ごとに受領証が付きます。同じ提出IDで再送しても、二重にコミットされることはなく、元の受領証が返ります。実行が完了すると、オーナーがそれを閉じ(
audit_close)、仕事を求めてくるエージェントにはDONEが返ります。
カーネルの内部
監査レイヤー
タスクとリース、記録の確認、根拠、そして撤回の連鎖です。TCP上でMCP形式のJSON-RPC 2.0(initialize、tools/list、tools/call)に応答し、トークンのロールが、エージェントに見えるツールを決めます。監査サーバーは既定ではループバックで待ち受け、TLSはありません。他のマシンからは、安全なトンネルかTLSプロキシを使い、エージェントのトークンは秘密にしてください。sbgk mcp-bridgeによって、Claude Codeのように、サーバーをstdioの子プロセスとして起動するクライアントも参加でき、トークンはモデルのプロンプトの外に置かれます。
その下のエンジン
エンジンは、内容に応じたチャンクに分けられた文書の版の、正確なバイト範囲に証拠を結び付け、事実とルールによる導出を保持し、証拠が撤回された結論を取り下げ、有効な別の導出がある結論は導き直します。状態は、ハッシュチェーンのログとマークルルートを備えた.sbgkコンテナとして保存されます。その上にある監査サーバーでは、主張が別の主張を根拠にすることはできず、主張のbased_onの引用はすべて必須です。引用のうち一つでも撤回されると、その主張の記録は根拠を失い、他の引用を根拠とする別の記録は成立したままです。
ジャーナル
受け入れられたものはすべて、追記専用の一つのジャーナルに入ります。フレームは、バージョン、通し番号、直前のフレームのハッシュ、正規形JSONのペイロードを持ちます。最初のフレームには、開始時の状態のスナップショットが、文書のテキストとともに入っています。以下の用語で、これらの言葉をそれぞれ定義します。
用語を一つずつ
決定的誰でも確認をやり直して同じ答えを得られるように。モデルを信用する必要がないように。
ここでの「決定的」とは、カーネルの答えが入力から決まり、ジャーナルが同じルートにリプレイされることを意味します。チームの2回の実行は、タイムスタンプと、モデルが書く内容において、やはり異なります。
正確な引用結論が、出典に本当にある言葉にしか拠れないように。
エージェントにリースされた文書の範囲の中に、バイト単位でそのまま存在するテキストです。エージェントはテキストを送り、カーネルがバイトを見つけます。正規化は一切行われません。直線の引用符の代わりの曲がった引用符、ノーブレークスペース、変更されたバイトは、どれも同じように失敗します。
文書のピン
出典文書の同一性です。リポジトリ、コミット、パス、生のバイトのSHA-256。お手元のファイルの場合は、フォルダ内のパスと、そのバイトのSHA-256です。--docsでの実行は、開始時にファイルを固定します。ファイルが変わった場合は、新しい実行になります。
チャンク
固定サイズではなく、内容に応じて切り出された文書の版の断片です(内容定義チャンキング)。エンジンは、そのような版の中の正確なバイト範囲に証拠を結び付けます。
スナップショット
ある時点のエンジンの状態を、.sbgkコンテナとして保存したものです。チャンクに分けられた文書、事実、導出、ハッシュチェーンのログ、マークルルートが入ります。三つのものは区別されます。ピンは一つの文書の同一性、正確な引用は文書内のバイトについての記述、スナップショットはある時点の状態です。実行のジャーナルの最初のフレームには、開始時の状態のスナップショットが、文書のテキストとともに保存されます。
根拠(based_on)各結論が何に基づいているか、出典が撤回されたときに何が根拠を失うかが見えるように。
主張が挙げる引用です。そのすべてが必須で、主張が根拠を持つのは、それらがすべて成立している間だけです。
ジャーナル履歴への変更が、確認したときに表に出るように。そして誰でもリプレイできるように。
実行の追記専用の記録です。受け入れられた各トランザクションが1つのフレームになります。正規形JSON(RFC 8785)で書かれ、直前のフレームとSHA-256で連結され、新しい状態が公開される前に書き込まれて同期されます。ハッシュチェーンのログは古くからよく知られた構造です(Gitの履歴やCertificate Transparencyログでも使われています)。ここでは、それをAIエージェントチームの証拠に適用しています。
正規形
同じデータを書くための、合意された一つの書き方です。同じデータが同じバイトになります(JSONではRFC 8785)。ジャーナルの読み手はその形だけを受け入れます。余分な空白、別のキーの順序、重複したフィールドは、正規化されるのではなく、拒否されます。
ルート
audit_rootとengine_root。ジャーナルのある時点の状態全体を表すハッシュです。前者は記録、出典、オントロジー、リンク、受領証、チェックポイントについてのもの、後者はエンジンについてのものです。ルートは状態の指紋であり、状態のスナップショットではありません。wal_headは最後のフレームのハッシュで、ジャーナル全体の順序を確定します。
受領証後から、別の場所に保管した値と照らしてジャーナルを確認できるように。
受け入れられた各提出に対する受領証と、実行の最後に出る、終了した実行のルートとチェーンの先頭を示す最終受領証です。ジャーナルの書き手が変更できない場所に保管してください。
署名付きチェックポイントジャーナルを、その外に保管されたものと照らして確認できるように。
サーバーは、ときどきジャーナルのチェックポイントを書き出します。そこまでのフレーム数、状態のルート、そして何が成立していて何が何に拠っているかのハッシュです。署名鍵を指定して起動したサーバーは、これに署名します(C2SP signed note、Ed25519)。sbgk audit-verify --checkpointは、署名と、そのチェックポイントがこのジャーナルのフレームを指していることを確認します。署名が証明するのは、鍵の持ち主がそう述べたことだけです。ジャーナルの隣に置いた鍵ファイルは、運用者自身に対する防御にはなりません。
証憑一つの結論を、ジャーナルなしで単独で確認できるように。
sbgk audit-proofがジャーナルから切り出す一つのファイルです。一つの記録と、その根拠のすべて(引用まで)が、署名付きチェックポイントの下に入っています。sbgk audit-proof-verifyは、ジャーナルもモデルもなしに、これを単独で検証します。示すのは、その記録と根拠が、そのチェックポイントの時点でジャーナルにあったことであり、今も成立していることではありません。
リプレイ
ジャーナルを再び開くと、そのフレームがもう一度実行され、結果が同じルートになることが確認されます。停止した実行は、リプレイすると同じルートになります。
リースと指示
リースは、一つのエージェントが一定時間、一つのタスクに取り組む権利です。切れたリースは回収されます。指示は、タスクに付随して渡されるものです。
連鎖を伴う撤回出典が撤回されたとき、すべてではなく、どの結論を再確認すればよいかが分かるように。
オーナーが文書のバイトを閉じます(audit_revoke、audit_withdraw_text)。それを必須としていたすべての記録は根拠を失い、他の記録は残り、履歴は書き換えられません。0.1.6以降、撤回はバイトを閉じるので、それに重なる引用は、あとからでも拒否されます。0.1.7以降は、カーネルによる修復の依頼が、何が根拠を失ったかを示します。インスペクターのページで、ステップごとに確認できます。
あなたがカーネル
これはルールの模型であり、カーネルそのものではありません。カーネルはブラウザの中では動いていません。実際の確認は、本物のカーネルで記録された実行とsbgk audit-verifyにあります。
同じ場面を一覧で
JavaScriptがない場合、ゲームは一覧として表示されます。場面ごとに、提出された部品、正しい判断、本物のカーネルの答えを示します。
レベル1
バイトが1つ変えられた引用
reader-1が引用を提出します。文書の中に、バイト単位で一致する箇所はありますか。
- 引用:The initialization phase **MUST** be the forst interaction between client and server.
正しい判断: 拒否する
本物の答え:
REPAIR_REQUIRED · QUOTE_NOT_FOUND_IN_BYTES: quote has no byte-exact occurrence · Records stored: 02つの正確な引用と、それぞれに対する主張
読み取りエージェントが部品を一つずつ持ってきます。記録された実行と同じように、スナップショットを組み立ててください。引用を受け入れ、そのあと各主張が挙げる根拠を登録してください。
引用1:文書とバイト単位で比べてから、受け入れるか拒否してください。
- 引用1:The initialization phase **MUST** be the first interaction between client and server.
正しい判断: 受け入れる
本物の答え:
COMMITTED · t1_o1 → @2100c44776db5bb2引用2:文書と比べてから、受け入れるか拒否してください。
- 引用2:The client **MUST** initiate this phase by sending an `initialize` request containing:
正しい判断: 受け入れる
本物の答え:
COMMITTED · t1_o2 → @c8c8ccea139fff44主張1は根拠を挙げています:based_onは引用1です。主張を押し、次にキューブの中でその主張が挙げる引用を押してください。
- 主張1:Initialization must be the first client-server interaction. · 根拠(based_on):引用1
正しい判断: 根拠 引用1
本物の答え:
COMMITTED · t1_c1 → @22308d5ced9c0afc · based_on: @2100c44776db5bb2主張2は根拠を挙げています:based_onは引用2です。主張を押し、次にキューブの中でその主張が挙げる引用を押してください。
- 主張2:The client starts initialization with an initialize request. · 根拠(based_on):引用2
正しい判断: 根拠 引用2
本物の答え:
COMMITTED · t1_c2 → @0c5f4921318d1e9c · based_on: @c8c8ccea139fff44
オーナーが最初の引用を撤回する
記録された実行の引用と主張はジャーナルに入っています。ここでオーナーが引用1を撤回します。
- 引用1:The initialization phase **MUST** be the first interaction between client and server.
- 主張1:Initialization must be the first client-server interaction.
- 引用2:The client **MUST** initiate this phase by sending an `initialize` request containing:
- 主張2:The client starts initialization with an initialize request.
正しい判断: 引用1(撤回済み)、主張1(根拠を失う)
本物の答え:
REVOKED · claim 1: grounded false · claim 2: grounded true1文字を変えたジャーナルのコピー
誰かが、ジャーナルのコピーの中で主張の1文字を変えました。「must」が「Must」になっています。有効なJSONのままです。これを開きますか。
- Initialization must be the first client-server interaction. → Initialization Must be the first client-server interaction.
正しい判断: 開かずに拒否する
本物の答え:
BAD_FIELD: audit WAL frame 5: hash mismatch · sbgk audit-verify: REFUSED, exit 1
これが、エージェントが送ってくる部品のすべてに対して、カーネルが行っていることです。引用を文書とバイト単位で比べ、そこにないものは拒否します。正確な引用でなければ何も受け付けません。主張は、根拠として挙げた引用がすべて成立している間だけ成立します。そのため、出典を撤回すると、それを根拠とする主張は成立しなくなり、他の主張は残ります。また、1文字変えられたジャーナルは拒否されます。ジャーナルの各フレームは、自分の内容と直前のフレームのハッシュを持っているからです。これがハッシュチェーンです。本物のカーネルは、これらをすべてルールで行い、モデルには尋ねません。
レベル2
割り当て範囲外からの引用
reader-1に渡されたのは、ページ全体ではなく、その一部の範囲です。次の引用は、そのページにある実在の文です。範囲内でしょうか。
- 引用:Implementations **SHOULD** be prepared to handle these error cases:
- エージェントに割り当てられた範囲:0〜5932バイト目
- 引用は6663バイトのうち6098バイト目から始まります
正しい判断: 拒否する
本物の答え:
REPAIR_REQUIRED · BAD_FIELD: quote is outside the issued byte ranges · Records stored: 0一度も保存されなかった引用を根拠とする主張
先ほど、reader-1の、バイトが1つ変えられた引用は拒否されたため、t1_o1という名前で保存された記録はありません。いま、読み取りエージェントが、根拠にt1_o1を挙げる主張を提出します。
- 主張:Initialization must be the first client-server interaction.
- 根拠(based_on):t1_o1
- この記録は保存されませんでした。その行は拒否されました。
正しい判断: 拒否する
本物の答え:
REPAIR_REQUIRED · UNKNOWN_LOCAL_ID: expected an issued local id or @hash · Records stored: 0サーバーを止めて、もう一度起動する
サーバーを止め、同じジャーナルでもう一度起動します。受領証は停止の前に保存されています。再起動後の値を、受領証の値と比べてください。
- 受領証の値(audit_root):30aff21361ebed46be969841d43d42063b58789fec8525d93f5fd9509b9d7a2a
- 再起動後の値(audit_root):30aff21361ebed46be969841d43d42063b58789fec8525d93f5fd9509b9d7a2a
正しい判断: 同じ状態
本物の答え:
resumed: true · audit_root: 30aff213…9b9d7a2a = 30aff213…9b9d7a2a末尾が切り取られたジャーナル
ジャーナルのコピーは、最後のフレームを失っています。sbgk audit-verifyで2回確認します。最初は受領証なしで、次はジャーナルの外に保管した受領証ありで確認します。
受領証なし:確認は何と答えますか。
- ジャーナルのコピー:12フレーム、最後の1つが切り取られています
- 確認:sbgk audit-verify --wal <journal>
正しい判断: 「完全」と表示される
本物の答え:
status: VERIFIED · exit 0 · entries: 12ジャーナルの外に保管した受領証あり:確認は何と答えますか。
- ジャーナルのコピー:12フレーム、最後の1つが切り取られています
- ジャーナルの外に保管された受領証:wal_head 6db85444…88d6c627
- 受領証は、13件のエントリのあとの状態を保持しています
- 確認:sbgk audit-verify --wal <journal> --expect <receipt> --at-end
正しい判断: 切り取りが示される
本物の答え:
status: MISMATCH · exit 1 · found_after_entries: null
ジャーナルが保証しないこと
改ざんを検知できますが、防止するものではありません。ジャーナル全体を書き換えられる者は、そのハッシュチェーンも書き換えられるので、受領証は、ジャーナルの書き手が変更できない場所に保管してください。sbgk audit-verify --expect receipt.json --at-endは、切り取られた末尾を見つけます。署名鍵を指定して起動したサーバーはチェックポイントに署名しますが、署名が証明するのは、鍵の持ち主がそう述べたことだけです。ジャーナルの隣の鍵ファイルや、運用者自身のリポジトリに置いたチェックポイントは、運用者自身に対する防御にはなりません。書き手の手が届かない場所のアンカーがあれば防げますが、このバージョンには、第三者の証人サービスはありません。
使い方は3通り
単独で
お手元のコーパス(テキストファイルのフォルダ、またはコミットとSHA-256でピン留めされた出典のマニフェスト)に対してsbgk audit-serveを実行し、エージェントが、それぞれ自分のトークンで、どの言語からでも、またはPythonクライアントを通して、そのMCPツールを呼び出せるようにします。
自分で運用するチームと
ベンチマークランナー(benchmarks/run_pilot_ac.py)は、読み取りエージェントのチームと確認役を、カーネルを通して動かし、比較のために、同じチームをカーネルなしでも動かします。
すでに使っているツールの隣で
MCPクライアントは、ブリッジを通して一つのエージェントとして参加します。フォルダ上のエージェント1つなら、yuce mcpはクライアントの設定の1項目です。Pythonクライアントはコードから同じツールを呼び出し、オーケストレーターは自分のステップから同じMCPツールを呼び出します。まだないのは、TemporalやLangGraphのようなオーケストレーター向けの専用アダプターです。
