chp

Capability Host Protocol

CHPは、エージェント、ツール、システムが何をするのかを宣言し、統制し、証明するためのオープンプロトコルです。人間による承認、エージェントのアクション、システム呼び出しが、同じ統制された、改ざんを検知でき、再生可能なイベントとなる、単一の署名付きプレーンです。

基本はシンプルです。

エージェントやツールが実際に行ったことと、それを統制したものを確認できます。

2分で試す

コーディングエージェントはファイルを読み、コマンドを実行し、ツールを呼び出します。アプリケーションコードを変更せずに、アクションの発生地点に統制された境界を設けます。

pip install chp-core
chp hooks install                        # hooks Claude Code
chp hooks install --all-harnesses        # ...or Claude Code + Codex + Gemini CLI

通常どおりエージェントを使い、その後、実行内容を確認します。

chp session list
chp session tree <session_id>

すべてのツール呼び出しは、型付きの証拠イベントとしてハッシュチェーンで連結され、ローカルの ~/.chp/evidence.sqlite に保存されます。拒否は理由コードを伴う第一級のイベントであり、握りつぶされる例外ではありません。チェーンは改ざんを検知できるため、エージェントを実行していない人でも記録が完全な状態かどうかを確認できます。

プロトコルを直接操作したい場合は、chp serve-demo で統制されたホストを起動し、そのままコピーして使える最初の呼び出しが表示されます。

完全ガイド： docs/quickstart.md · 存在意義： docs/why-chp.md · ドキュメントサイト： docs.capabilityhostprotocol.com

得られるもの

相関 ID を使って再生でき、記録からは「何が起きたか」以上のことがわかります。詳細は examples/agent-operations-demo/ をご覧ください。

[
  {"sequence": 1,  "event_type": "execution_started",   "capability_id": "trace_execution", "outcome": null},
  {"sequence": 3,  "event_type": "execution_completed", "capability_id": "trace_execution", "outcome": "success"},
  {"sequence": 7,  "event_type": "execution_started",   "capability_id": "tool.add",        "outcome": null},
  {"sequence": 12, "event_type": "execution_started",   "capability_id": "tool.multiply",   "outcome": null},
  {"sequence": 13, "event_type": "execution_completed", "capability_id": "tool.multiply",   "outcome": "success"}
]

すでに実行された実行に対し、ポリシーを適用した場合にどうなっていたかを確認することもできます。

{
  "invariant": {"id": "deny_multiply_tool", "kind": "capability_id_matches"},
  "would_have_denied": true,
  "violating_events": [{"capability_id": "tool.multiply", "event_type": "execution_started"}]
}

ライブラリではなくプロトコルである理由

CHPは、別のエージェントフレームワーク、ツールプロトコル、ワークフローエンジンではありません。ケイパビリティ境界における統制された証拠プレーンです。実行された内容と、それを統制した内容（ポリシー、リスク階層、安全性チェック、人間による承認、自律性の予算、拒否）が、単一の署名付き相関レコードに記録されます。可観測性ツールでは、実行状況が個別で任意かつ署名のないシグナルに分断され、統制に関する情報もありません。CHPはその両方を統合し、証明します。

ステータス： CHPは1.0以前の**リリース候補（v0.9.3）**です。凍結された追加専用のワイヤーフォーマットを備え、適合性テストに合格した2つの独立実装（Python + TypeScript）によって支えられています。chp-core はPyPIで配布されています。

CHPが定義するもの

• ケイパビリティ記述子
• ホスト記述子
• 呼び出しエンベロープ
• 相関コンテキスト
• 構造化された実行証拠
• 結果、エラー、拒否のセマンティクス
• 再生クエリと結果
• 相関 ID による再生
• 最小限の適合性要件

インストール

pip install chp-core                 # zero runtime dependencies
pip install 'chp-core[schema]'       # enforce declared input_schema
pip install 'chp-core[signing]'      # ed25519 — signed hosts, bundles, mandates
npm install @capabilityhostprotocol/sdk   # TypeScript client + verifier (alpha)

chp host verify は1秒未満でインストールのスモークテストを実行し、入力スキーマの検証が強制されているかどうかを報告します。

このチェックアウトからインストールする場合：python -m pip install -e packages/python。

最小限のケイパビリティ

from chp_core import LocalCapabilityHost, capability

host = LocalCapabilityHost("example-host")

@capability(
    id="math.add",
    version="1.0.0",
    description="Add two numbers.",
)
def add(a: int, b: int):
    return {"sum": a + b}

host.register(add)

result = host.invoke(
    "math.add",
    {"a": 2, "b": 3},
    correlation_id="demo-correlation",
)

print(result.outcome)       # "success"
print(result.data)          # {"sum": 5}

for event in host.replay("demo-correlation"):
    print(event.event_type)  # execution_started, execution_completed

ホストは呼び出しに対して execution_started と execution_completed の証拠を出力します。実行に失敗した場合は execution_failed を出力します。ホストが呼び出しを拒否した場合は execution_denied を出力します。

リポジトリマップ

• spec/README.md：仕様の索引 — コア（v0.1）、ガバナンス用語集、呼び出しパイプライン、HTTP バインディング、証拠の完全性とアンカー（v0.2）、予約名、テストベクトル、変更履歴、提案プロセス
• schemas/：プロトコルオブジェクトの JSON Schema
• packages/python/chp_core/：リファレンスホスト（Python）
• packages/chp-sdk/ + packages/chp-host-ts/：2つ目の実装（TypeScript）
• examples/capability-host-endpoint-demo/：HTTP で提供するホストのデモ
• examples/agent-operations-demo/：エージェント／ツールのオブザーバビリティデモ
• examples/codex-self-observation-demo/：Codex のドッグフーディングデモ
• examples/mcp-bridge-demo/：実験的な MCP スタイルのブリッジプロトタイプ
• conformance/：適合性ランナー
• docs/quickstart.md：インストール、初回実行、サービング、メッシュ
• docs/why-chp.md：課題と主張
• docs/adapter-authoring.md：独自のケイパビリティアダプターの作成
• docs/production-runbook.md：運用、バックアップ／復元、鍵の侵害
• docs/comparisons/chp-vs-mcp.md：MCP との詳細な比較
• docs/comparisons/chp-and-opentelemetry.md：OpenTelemetry との連携に関する注記
• docs/comparisons/landscape.md：隣接するフレームワークとの比較
• docs/security/threat-model-v0.1.md：v0.1 脅威モデル

本番環境での運用

リファレンス実装は、本番環境での運用に耐えられるよう強化されています。ホットバックアップに対応した WAL のマルチライター安全性（chp store backup --verify）、SIGTERM によるドレイン（終了前に処理中の作業を完了）、認証を必須にするフラグ（CHP_HOST_REQUIRE_AUTH=1）、定期的な保持処理、運用者向けメトリクス（ストアサイズ、witness ループの稼働状況、失効件数、内部エラー）を備えています。運用、バックアップ／復元、ローリングアップグレード、鍵の侵害への対応手順については、docs/production-runbook.mdを参照してください。脆弱性の報告については、SECURITY.mdを参照してください。

CHP と MCP の比較

MCP は AI アプリケーションにツールとコンテキストを公開します。CHP はケイパビリティの実行を統制し、その証拠を記録します。

両者は連携できます。MCP はケイパビリティ呼び出しのソースとなり、CHP は実行境界で相関付け、リプレイ、証拠、拒否のセマンティクス、ガバナンスを追加します。

詳しくは、docs/comparisons/chp-vs-mcp.mdを参照してください。

貢献

まずCONTRIBUTING.mdをお読みください。プルリクエストを作成する前に知っておいていただきたいことがあります。このリポジトリは、非公開の開発リポジトリから生成されたミラーです。CI は、sync/*以外のブランチからpackages/、docs/、spec/、schemas/、examples/に変更を加えるプルリクエストを拒否します。そのため、これらのパスへのコードのプルリクエストは、どれほど優れた内容でも必ず失敗します。

これは門前払いではありません。これが公開方法であり、赤いチェックを見てから知ることになるより、先にお伝えしたいと考えています。現時点では、イシュー、仕様の提案、比較、ディスカッションが、参加するための最も有効な方法です。イシューを作成していただければ、貢献者名を明記したうえで、変更を内部のプロセスに回します。

オープンソースの境界

オープンソースには、ローカルでの可視性が含まれるべきです。

• 仕様とスキーマ
• ローカルホスト
• SDK の基本機能
• 適合性
• ローカルリプレイ
• エージェントのオブザーバビリティラッパー
• 実験的な MCP ブリッジプロトタイプ

商業的価値は、本番環境での信頼性に関わる領域に残すことができます。

• ホスト型ケイパビリティグラフ
• 複数ホスト間のトレース連結
• 保持
• チームのワークスペース
• 高度な説明
• 不変条件ライブラリ
• 保証の導出
• コンプライアンス向けエクスポート
• エンタープライズ向けの ID 管理と RBAC

指針：

ローカルでの可視性は無料であるべきです。本番環境での信頼性には対価が必要です。

ライセンス

CHP は資産ごとにデュアルライセンスで提供されています。

• コード（packages/、conformance/、examples/、scripts/）：Apache License 2.0 — LICENSE を参照してください。
• 仕様、スキーマ、ドキュメント（spec/、schemas/、docs/）：Creative Commons Attribution 4.0（CC BY 4.0）— LICENSE-DOCS を参照してください。仕様の実装には、ロイヤリティフリーの特許ライセンスも適用されます — PATENTS を参照してください。
• 商標：「CHP」および「CHP-Certified」— TRADEMARK.md を参照してください。

コントリビューションはコントリビューターライセンス契約に基づいて受け付けています。詳細はCONTRIBUTING.mdを参照してください。

著作権 © 2026 Project Auxo, Inc. NOTICE を参照してください。