gcf-python 2.7.0__tar.gz → 2.7.1__tar.gz

{gcf_python-2.7.0 → gcf_python-2.7.1}/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## v2.7.1 (2026-08-16)
+
+- gcf.fastmcp: the response middleware now uses GCF only when the wire is smaller than the JSON it replaces (never-grow), so a small tool result is never enlarged.
+
 ## v2.7.0 (2026-08-15)
 
 - Decode: quoted-key/array-value round-trip (SPEC 4.2).

{gcf_python-2.7.0 → gcf_python-2.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: gcf-python
-Version: 2.7.0
+Version: 2.7.1
 Summary: The AI-native wire format for structured data. 50-92% fewer tokens than JSON, with multi-turn delta encoding for agent loops. 100% comprehension on every frontier model. Zero dependencies.
 Project-URL: Homepage, https://github.com/blackwell-systems/gcf-python
 Project-URL: Documentation, https://gcformat.com/
@@ -322,7 +322,7 @@ GCF wins 15/16 datasets on the expanded [token efficiency benchmark](https://git
 
 **Zero runtime dependencies. Permanently.** All six implementations depend only on their language's standard library. No transitive dependencies. No supply chain risk. This is a permanent commitment: GCF will never take on external runtime dependencies. MIT licensed. All implementations support both generic profile (`encodeGeneric`) and graph profile (`encode`). CLI included in all 6 languages.
 
-**Specification:** [SPEC v3.5.3 Stable](https://github.com/blackwell-systems/gcf/blob/main/SPEC.md) with 279 conformance fixtures, 43,000,000,000+ lossless round-trips verified across 5 formats and 6 languages. Current versions: Go v1.7.0, TypeScript v2.6.0, Python v2.6.0, Rust v3.0.0, Swift v2.7.0, Kotlin v2.6.0, .NET v0.2.0. Cross-language conformance verified across all seven SDKs.
+**Specification:** [SPEC v3.5.3 Stable](https://github.com/blackwell-systems/gcf/blob/main/SPEC.md) with 281 conformance fixtures, 43,000,000,000+ lossless round-trips verified across 5 formats and 6 languages. Current versions: Go v1.7.1, TypeScript v2.6.1, Python v2.7.0, Rust v3.0.1, Swift v2.7.1, Kotlin v2.6.1, .NET v0.2.1. Cross-language conformance verified across all seven SDKs.
 
 ## Adopted by
 

{gcf_python-2.7.0 → gcf_python-2.7.1}/README.md

@@ -295,7 +295,7 @@ GCF wins 15/16 datasets on the expanded [token efficiency benchmark](https://git
 
 **Zero runtime dependencies. Permanently.** All six implementations depend only on their language's standard library. No transitive dependencies. No supply chain risk. This is a permanent commitment: GCF will never take on external runtime dependencies. MIT licensed. All implementations support both generic profile (`encodeGeneric`) and graph profile (`encode`). CLI included in all 6 languages.
 
-**Specification:** [SPEC v3.5.3 Stable](https://github.com/blackwell-systems/gcf/blob/main/SPEC.md) with 279 conformance fixtures, 43,000,000,000+ lossless round-trips verified across 5 formats and 6 languages. Current versions: Go v1.7.0, TypeScript v2.6.0, Python v2.6.0, Rust v3.0.0, Swift v2.7.0, Kotlin v2.6.0, .NET v0.2.0. Cross-language conformance verified across all seven SDKs.
+**Specification:** [SPEC v3.5.3 Stable](https://github.com/blackwell-systems/gcf/blob/main/SPEC.md) with 281 conformance fixtures, 43,000,000,000+ lossless round-trips verified across 5 formats and 6 languages. Current versions: Go v1.7.1, TypeScript v2.6.1, Python v2.7.0, Rust v3.0.1, Swift v2.7.1, Kotlin v2.6.1, .NET v0.2.1. Cross-language conformance verified across all seven SDKs.
 
 ## Adopted by
 

{gcf_python-2.7.0 → gcf_python-2.7.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "gcf-python"
-version = "2.7.0"
+version = "2.7.1"
 description = "The AI-native wire format for structured data. 50-92% fewer tokens than JSON, with multi-turn delta encoding for agent loops. 100% comprehension on every frontier model. Zero dependencies."
 readme = "README.md"
 license = {text = "MIT"}

{gcf_python-2.7.0 → gcf_python-2.7.1}/src/gcf/__init__.py

@@ -102,4 +102,4 @@ __all__ = [
     "DEFAULT_REANCHOR_N",
 ]
 
-__version__ = "2.7.0"
+__version__ = "2.7.1"

{gcf_python-2.7.0 → gcf_python-2.7.1}/src/gcf/fastmcp.py

@@ -18,8 +18,11 @@ wire, so the response uses fewer tokens when it crosses the LLM boundary. It is:
 
 - **Opt-in** — nothing changes unless ``RESPONSE_FORMAT=gcf`` is set (or
   ``enabled=True`` is passed).
-- **Lossless and fail-safe** — on any encoding error the original result is
-  returned, so a tool call is never dropped over formatting.
+- **Never-grow** — GCF is used only when the wire is actually smaller than the
+  JSON it would replace; a small result is never enlarged.
+- **Lossless and fail-safe** — the wire must decode back to the same value, and
+  on any encoding error the original result is returned, so a tool call is never
+  grown, dropped, or garbled over formatting.
 - **Non-destructive** — only a lone JSON text block is re-encoded; a result
   carrying an image or any second block is left untouched, and the tool's
   ``structuredContent`` (if any) is preserved so output-schema validation and
@@ -94,8 +97,16 @@ class GcfResponseMiddleware(Middleware):
         if payload is None:
             return result
 
+        # _json_payload guarantees exactly one text block, so this is the JSON text
+        # the client would otherwise receive.
+        original = result.content[0].text
+
         try:
             wire = encode_generic(payload)
+            # Never-grow: only replace the JSON when GCF is actually smaller, so a
+            # small result is never enlarged.
+            if len(wire) >= len(original):
+                return result
             # Verify the wire decodes back to the same value before shipping it, so a
             # result is never replaced with an unparseable or lossy encoding.
             if decode_generic(wire) != payload:

{gcf_python-2.7.0 → gcf_python-2.7.1}/tests/test_fastmcp.py

@@ -120,6 +120,19 @@ def test_encode_error_falls_back_to_json():
     assert _text(out) == text
 
 
+def test_never_grow_keeps_json_when_gcf_larger():
+    # A tiny single-field object: GCF's header overhead exceeds the JSON, so the
+    # never-grow guard keeps the JSON rather than emit a larger wire.
+    data = {"ok": True}
+    text = json.dumps(data)
+    result = _result(TextContent(type="text", text=text), structured_content=data)
+
+    out = _run(GcfResponseMiddleware(enabled=True), result)
+
+    assert _text(out) == text
+    assert not _text(out).startswith("GCF ")
+
+
 # --- fuzz: the safety invariant on arbitrary JSON ---
 
 # Characters that stress GCF's delimiter/quoting rules and unicode handling.
@@ -176,6 +189,8 @@ def test_fuzz_middleware_never_grows_corrupts_or_crashes():
         if got == text:
             continue  # declined -> original JSON kept (always safe)
 
-        # Otherwise it MUST be a GCF wire that round-trips to the exact payload.
+        # Otherwise it MUST be a GCF wire that is smaller than the JSON (never-grow)
+        # and round-trips to the exact payload.
         assert got.startswith("GCF profile=generic")
+        assert len(got) < len(text)
         assert decode_generic(got) == payload