Skip to content

v2.3.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 12 Jul 16:12
· 49 commits to main since this release
v2.3.0
843d693

Generic-profile delta + re-anchor session helper (SPEC §10a)

Delta encoding comes to the generic profile — the multi-turn compression that JSON and TOON structurally lack — plus a producer-side re-anchor helper. Byte-for-byte interoperable across all six GCF SDKs (Go, Python, TypeScript, Rust, Swift, Kotlin) against a shared conformance suite.

Generic-profile delta (§10a)

Keyed row diffs: send only what changed (## added / ## changed / ## removed) instead of re-sending the whole table each turn.

  • GenericSet + GenericDeltaPayload; generic_pack_root (content-addressed gcf-pack-root-v1)
  • diff_generic_sets (producer) · encode_generic_full / encode_generic_delta · decode_generic_full / decode_generic_delta · verify_generic_delta (atomic apply + new_root verification)
  • Opt-in and bilateral; the existing encode path is unchanged.

Re-anchor session helper (§10a.8)

GenericDeltaSession — a thin stateful producer that manages the re-anchor cadence for you. Each next() returns either a compact delta or, on its cadence, a full re-anchor, updating its held base.

  • fixed_n(n) (default N=15) or size_guard() (size-adaptive, production-recommended)
  • No new wire syntax; cadence knobs are never wire fields, so the decoder stays cadence-agnostic. A schema change forces a full.

Why it matters

Across a 50-turn comprehension study, six of seven cleanly-measured models comprehend delta as well as full-resend at a fraction of the tokens; the one model that drifts at depth is closed by the re-anchor.

Correctness

Byte-for-byte identical wire and pack roots across all six SDKs, verified by shared conformance fixtures (generic-pack-root, generic-delta, generic-delta-session). MIT, zero runtime dependencies. Ships with GCF SPEC v3.3.0.

Install: pip install gcf-python

Adopted by

Headlined by Chrome DevTools MCP — the #1 most-starred MCP server on GitHub (46K★), built by the Google Chrome DevTools team, which merged GCF as an experimental data format (--experimentalDataFormat=gcf) after a 4-round review.

Also running in production across the ecosystem:

  • OmniRoute (15.6K★) — AI gateway/proxy; GCF vendored into its compression engine
  • Raycast (7.5K★) — JSON→GCF converter extension in the Store
  • Speakeasy — oq --format gcf for OpenAPI query output
  • NetClaw (556★) — network automation; switched from TOON to GCF
  • ctx (510★) — Claude Code tool-recommender; pip install "claude-ctx[gcf]"
  • bb — Bitbucket Cloud CLI/TUI; --format gcf
  • NeuroNest — agent-first IDE
  • Open Data Products SDK — Linux Foundation data-product toolkit
  • knowing · agent-lsp — code-intelligence + LSP-orchestration MCP servers

Using GCF in production? Open an issue to be listed.

Assets 2
Loading