Skip to content

API standards and contract sources

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

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.