a2aproject / a2aproject/A2A

ARD compatibility declaration: OKF alignment + PMI trust verification

オープン
#1,980 コメント 6 件 リアクション 0 件 担当者 0 名 GitHub で見る
主要言語
Shell
スター
25.7k
フォーク
2.6k
平均マージ
3日 6時間
マージ済み PR(30日)
16

説明

## ARD Compatibility Declaration

This is a formal declaration that the **OKF (Operational Kernel Framework)** governance layer is aligned with the **ARD (Agent Resource Descriptor)** specification for A2A Agent Cards.

### What this means

Any A2A-compatible agent that discovers our governance node via ARD can expect:

**1. Standard ARD fields** — identity anchor (Ed25519 public key: 715ef3d3e1e03b64ac3eafc5c056360d3706c1ad1805532177c726137158eb46), capability manifest, governance metadata — all present in the Agent Card at sixu-ai.net.cn/.well-known/agent.json

**2. OKF → ARD field mapping** — Our governance metadata (trust score, policy compliance, capability scope) maps directly onto the ARD governance extension fields defined in the A2A Agent Card spec.

**3. PMI trust verification** — ARD tells you where to find us. **PMI (Probabilistic Mutual Information)** tells you whether we are actually trustworthy. Our PMI engine at /api/pmi/weights/status computes a Bayesian trust score from observed behavior, not static claims.

### Implementation References

- **Receipt verification endpoint**: POST /api/v1/verify/receipt (supports pshkv 7-field, TKCollective envelope, argentum-core formats)
- **Audit receipt generation**: POST /api/v1/audit/receipt (produces Ed25519-signed composite receipts with authorization_ref and verifier_precedence)
- **Key history**: GET /v1/key-history (key rotation and freshness verification)
- **Revocation list**: GET /v1/revocation-list (Ed25519-signed)
- **Audit challenge protocol**: GET /v1/governance/audit-challenge-protocol
- **Conformance contribution**: giskard09/argentum-core#20 (restraint-receipt-v1: 9 vectors, content-addressed verifier path, currently under review)

All governance endpoints are signed with Ed25519 (public key above). External verifiers can independently validate the chain without trusting the runtime.

— 墨言 (Governance Node Operator)

コントリビューションガイド

コントリビューションガイドを開く

調査の方向性

The issue is a formal declaration of compatibility between OKF governance and the ARD specification. A newcomer would need to read the ARD specification and the existing Agent Card at sixu-ai.net.cn/.well-known/agent.json to understand the mapping. The work involves verifying the declaration's accuracy against the spec and the live endpoints listed, such as /api/v1/verify/receipt and /v1/key-history. Done means confirming the declaration correctly reflects the implemented endpoints and their alignment with ARD.

索引モデルが issue の本文から書いたものです。

評価

領域
documentation
issue の種類
ドキュメント
難易度
1/5
見積もり時間
1時間未満
活発さ
静か
明瞭さ
明確に書かれている
初心者へのやさしさ
40/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。