|
| 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