Skip to content

Commit 6df2e23

Browse files
committed
feat(agentic-kit): add trust-layer Kit dach + index new dirs
agentic-kit/README.md names the scattered trust components (Lean proofs, signed mandates, audit trail, agent identity) as one honest, open-core Kit: separates what is public+reproducible today from reference-impl and roadmap. Contents table now also lists amdp-spec, agentic-kit, lean-verification.
1 parent 06f84bf commit 6df2e23

2 files changed

Lines changed: 67 additions & 0 deletions

File tree

README.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,9 @@ Protocol Commerce is an open initiative to create standardized, auditable, and i
1212
| [`adcp-spec/`](adcp-spec/) | **AdCP v0.1.0** — Agentic Discovery Commerce Protocol specification, JSON schemas, and examples |
1313
| [`adcp-sdk-typescript/`](adcp-sdk-typescript/) | TypeScript SDK: types, validators, client, and scoring reference implementation |
1414
| [`webmcp-reference/`](webmcp-reference/) | WebMCP browser integration: expose commerce tools to in-browser AI agents via `navigator.modelContext` |
15+
| [`amdp-spec/`](amdp-spec/) | **AMDP v0.1.0** — Agent Mandate Discovery Protocol: cross-vertical authorization spec, JSON schemas, and example mandates |
16+
| [`agentic-kit/`](agentic-kit/) | **Agentic Kit** — the trust layer: building blocks for verifiable + auditable AI agents |
17+
| [`lean-verification/`](lean-verification/) | **Lean 4 formal verification** — 47 theorems proving auction/budget/wallet/policy correctness, `lake build`-checkable |
1518

1619
## Quick Start
1720

agentic-kit/README.md

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
# Agentic Kit
2+
3+
> The trust layer of Protocol Commerce — building blocks for **verifiable and auditable** AI agents.
4+
5+
As AI agents start to act autonomously on people's behalf, one question becomes
6+
central: *who authorized this agent to do this, and can anyone check what it did?*
7+
The Agentic Kit is the open answer — the components that let anyone run agents whose
8+
decision **rules** are mathematically verified and whose **actions** leave an
9+
auditable trail.
10+
11+
## Read this first — the honest scope
12+
13+
You **cannot** formally verify an LLM. Its output is non-deterministic; that is open
14+
research. What you *can* verify is the **deterministic shell** the agent operates in:
15+
budget arithmetic, category membership, spend floors, mandate limits, revenue splits.
16+
17+
- ✅ "We prove an agent **cannot break the rules** — and every decision leaves an auditable trail."
18+
- ❌ "We guarantee the agent decides **correctly** or wisely." (impossible — don't claim it)
19+
20+
This distinction is the whole point. The Kit makes agent behaviour *accountable*, not *clairvoyant*.
21+
22+
## The trust triad
23+
24+
| Pillar | What it guarantees | Where it lives today |
25+
|--------|--------------------|----------------------|
26+
| **Verify** | Decision rules are mathematically proven (auction scoring, budget safety, payment bounds, policy) | **Public in this repo**[`../lean-verification`](../lean-verification) — 47 Lean 4 theorems, zero `sorry`, `lake build`-checkable |
27+
| **Mandate** | Authorization is portable and cryptographically signed (Ed25519, post-quantum-ready) | Reference implementation (Nexbid) — format generalizes a per-vertical signed-mandate pattern |
28+
| **Audit** | Every action is appended to a tamper-evident trail | Reference implementation (Nexbid) — append-only logs + signed compliance manifests |
29+
| **Identity** | Agents are registered and verifiable, not anonymous | Reference implementation (Nexbid) — agent registration + verifiable delivery badge |
30+
31+
> **Open-core:** the protocol, the formal proofs, and (over time) the SDK are open
32+
> (MIT). The hosted operational-audit infrastructure is the reference
33+
> implementation's concern. The *math* is public — verify it yourself.
34+
35+
## What is real today
36+
37+
- **Formal verification is public and reproducible.** Clone this repo, install Lean 4
38+
(`elan`), run `cd lean-verification && lake build`. If it compiles, all 47 theorems
39+
hold — the compiler is the verifier. No trust in us required.
40+
- The mandate / audit / identity pillars run in the **Nexbid reference
41+
implementation** ([nexbid.dev](https://nexbid.dev)) and are being lifted into open,
42+
reusable form here.
43+
44+
## Roadmap (honest — not promises)
45+
46+
The Kit is being packaged from working parts, in stages of increasing openness:
47+
48+
1. **Verified-Agent Badge** — a public "this agent's delivery is verified + auditable" signal. *(reference implementation live)*
49+
2. **SDK** — bring your own policy, get a Lean-checked proof + a signed mandate + an audit hook. *(in design)*
50+
3. **Open standard** — a portable *Verifiable Agent Mandate* governed in the open, with this Lean reference implementation as the differentiator. *(early — see AMDP track)*
51+
52+
Stages are scoped openly; this README will only ever claim what is actually shipped.
53+
54+
## Why formal verification (and why it's rare)
55+
56+
In a world where AI increasingly *writes* and *runs* code, "is this correct?" becomes
57+
the core question. Tests check finitely many cases. Proofs cover **all possible
58+
inputs**. To our knowledge this is the first commerce-agent stack whose core
59+
mechanics are formally verified — inspired by
60+
[Leanstral](https://mistral.ai/news/leanstral) (Mistral AI).
61+
62+
## License
63+
64+
MIT — use it, fork it, build on it. The proofs are there to be checked, not believed.

0 commit comments

Comments
 (0)