mirror of
https://github.com/zap-proto/dev.git
synced 2026-10-30 15:05:18 +00:00
zeekay
4738ffea2f
Red-team review (this session) caught half the protocol pages were AI
slop — describing Go APIs that don't exist in repos that contain only
schemas, plus performance tables contradicted by the only real bench
harness in tree. This is the surgery:
post-quantum:
- Drop the Z-Wing brand from public docs (user feedback: confusing).
- Reframe PQ as ZAP's stack: IETF X-Wing KEM (transport) + hybrid
Ed25519+ML-DSA-65 (identity) + PQ-RNS (name service). One canonical
story; layers are independent.
- Per-language status matrix shows realistic state (X-Wing KAT shipped
in 4 SDKs, sigs in all, resolver in progress).
protocols/{a2a,acp,fix,ws}:
- Marked "Status — spec-only, January 2026". Schema exists; runtime
doesn't. Removed every Go code snippet that called a non-existent
function. Replaced with a roadmap section.
protocols/rns:
- Rewrote against the actual schema at zap-proto/rns/schema/zap_rns.zap
(Record / Query / Response / signed-by-registry).
- Added the PQ-RNS end-to-end flow diagram and the DID definition
(base32(SHA3-256(kemPk || sigPk))).
- Documents the cross-language KAT fixture published at
zap-proto/rns/testdata/pqrns_kat.json.
protocols/mcp:
- Rewrote against the actual bridge.go API: NewBridge(*zap.Node),
AddServer, GetTools, CallTool, CallToolByName. Bridges existing
stdio MCP servers (it's a bridge, not a from-scratch impl).
- Dropped the invented zmcp.NewServer / Connect / ListTools API.
protocols/http:
- Killed the 6× req/s / 19× p99 / 6.2× RSS table — contradicted by
bench-results.txt which shows ZAP-HTTP currently ~10% slower.
- Replaced with honest current numbers + the value-prop statement.
protocols/native:
- Killed the 18× / 38× / 6.7× / 9.2× gRPC table — the bench harness
has no gRPC comparator, the numbers were fabricated.
- Replaced with the actual concurrency=32 numbers from bench-results
+ an explanation that the win is semantic, not currently latency.
transports:
- Killed the @zap-proto/wasm and Cloudflare-Worker code snippets that
referenced a non-existent npm package.
- Replaced with the honest pattern: browser→TLS→Worker→ZAP-over-X-Wing
to origin. Points readers at the SDK status table.
app/page.tsx:
- Dropped Z-Wing from the home page cards.
40 lines
1.9 KiB
Plaintext
40 lines
1.9 KiB
Plaintext
---
|
|
title: ACP over ZAP
|
|
description: Agent Communication Protocol — FIPA-style speech acts. Schema published, runtime in progress.
|
|
---
|
|
|
|
# ACP over ZAP
|
|
|
|
> **Status — spec-only, January 2026.** The wire schema is published; the Go runtime hasn't shipped. Generate types from the schema via any [SDK](/docs/sdks) — the encoded bytes are stable.
|
|
|
|
`zap-proto/acp` is a modern take on **FIPA ACL** (Agent Communication Language): performative-typed messages between agents (`inform`, `request`, `query`, `propose`, `accept-proposal`, `refuse`, …), each signed under the sender's [PQ identity](/docs/post-quantum). The receiver gets a non-repudiable record of what was said.
|
|
|
|
## Why FIPA performatives
|
|
|
|
RPC says "call this method." ACP says "this is the kind of speech act I'm performing" — receivers can reason about intent and disposition. A `refuse` is a different signal than a 500 error; for multi-agent coordination (negotiation, consensus, voting) the type system maps better than method dispatch.
|
|
|
|
## Schema
|
|
|
|
Published at [zap-proto/acp/schema/zap_acp.zap](https://github.com/zap-proto/acp/blob/main/schema/zap_acp.zap). Covers:
|
|
|
|
- `Message` — performative, sender, receiver, content, ontology, signature
|
|
- Performative enum: `inform`, `request`, `query`, `propose`, `accept-proposal`, `refuse`, `agree`, `cancel`, `failure`, `confirm`, `disconfirm`, …
|
|
- `Conversation` — message thread with parent references for `reply-to`
|
|
|
|
## Roadmap
|
|
|
|
| Milestone | Target |
|
|
|---|---|
|
|
| Wire schema published | ✅ |
|
|
| Go reference runtime | in progress |
|
|
| Per-performative dispatch helpers | in progress |
|
|
| Cross-language interop tests | once Go reference stabilizes |
|
|
|
|
Track progress on [zap-proto/acp](https://github.com/zap-proto/acp).
|
|
|
|
## Related
|
|
|
|
- [A2A over ZAP](/docs/protocols/a2a) — task-oriented alternative
|
|
- [MCP over ZAP](/docs/protocols/mcp) — for agent ↔ tool calls
|
|
- [Native ZAP RPC](/docs/protocols/native)
|