API standards and contract sources
Current standards
Section titled “Current standards”The formats the stack follows, with the live version read on the date of the research.
| Layer | Standard | Live version |
|---|---|---|
| HTTP APIs | OpenAPI (OAI/OpenAPI-Specification) | 3.2.1, 2026-09-10 |
| Query APIs | GraphQL (graphql/graphql-spec) | September2026, 2026-11-12 |
| Query APIs | GraphQL over HTTP (graphql/graphql-over-http) | September2026, 2026-11-13 |
| Events and queues | AsyncAPI | v3.1.0, 2026-01-31 |
| Data shapes | JSON Schema 2020-12 (json-schema-org/json-schema-spec, no GitHub release; head 2026-11-19) | 2020-12 |
| RPC | Protocol Buffers | v36.2, 2026-09-17 |
| RPC | Connect: connectrpc crate |
0.9.1 |
| RPC | gRPC: tonic crate |
0.14.9 |
| Agent tools | MCP | 2026-07-28 |
| Agent to agent | A2A | v1.0.1, 2026-05-28 |
| Service models (AWS-style IDL) | Smithy | 1.75.0, 2026-11-12 |
| Link previews | Open Graph protocol, ogp.me | og:title, og:type, og:image (with :url, :secure_url, :type, :width, :height, :alt), og:url, og:description, og:audio, og:determiner |
| Wasm components | Component Model WIT (WebAssembly/component-model, no release; head 2026-11-19) | wit-bindgen 0.63.0 |
What exists today
Section titled “What exists today”The contracts present in each repository today.
| Repo | Contracts present |
|---|---|
| fw | crates/fw-a2a/proto/a2a.proto and the google.api protos; crates/fw-edge/data/openapi_{paths,description}.json; the MCP engine crates/fw-proto/src/mcp.rs (152/152 on the suite at 2026-07-28); 17 C headers; schemars in fw-proto, fw-toolcall, fw-m3 and fw-a2a |
| aphrody | Zed’s collaboration RPC in crates/proto/proto/*.proto (11 files); 2 C headers; JSON Schema through schemars in settings_content, agent, gpui and others |
| ay | docs/auto/openapi.json; the WebAssembly component interface corelib/wit/ay-corelib.wit with WASI io and cli deps; 8 C headers |
Missing everywhere:
- No single source. Each product has no one source of truth for its contracts; the OpenAPI files are written by hand or generated in one place.
- Missing formats:
- no GraphQL schema;
- no AsyncAPI for events and queues;
- no Open Graph metadata contract for the sites;
- no generated TypeScript, Kotlin, Python or C# types.
- Unchecked bindings: no ABI check on the C headers, and no AST or IR contract.