Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Python agentaianthropicclaude-codecompressioncontext-engineeringcontext-windowcursorfastapilangchainllmmcpopenaiprompt-engineeringproxypythonragtoken-optimizationtokenstypescript
fix: schema compaction must not drop property names that match DROP_KEYS (#785)
Ashishae2122fda8ff
diff --git a/headroom/proxy/handlers/openai.py b/headroom/proxy/handlers/openai.pyindex 116d3c12c..b401aed4b 100644--- a/headroom/proxy/handlers/openai.py+++ b/headroom/proxy/handlers/openai.py@@ -215,23 +215,27 @@ def _json_byte_len(value: Any) -> int:def _compact_openai_tool_schema_value(value: Any,+ _parent_key: str | None = None,) -> Any:if isinstance(value, list):- return [_compact_openai_tool_schema_value(item) for item in value]+ return [_compact_openai_tool_schema_value(item, _parent_key) for item in value]if not isinstance(value, dict):return valuecompacted: dict[str, Any] = {}for key, child in value.items():- if key in _OPENAI_TOOL_SCHEMA_DROP_KEYS:+ # Don't drop keys that are property *names* inside a JSON Schema+ # `properties` object — only drop them when they are schema annotations.+ # e.g. a tool with a field literally named "title" must not be stripped.+ if _parent_key != "properties" and key in _OPENAI_TOOL_SCHEMA_DROP_KEYS:continueif key == "description" and isinstance(child, str):compacted[key] = " ".join(child.split())continue- compacted[key] = _compact_openai_tool_schema_value(child)+ compacted[key] = _compact_openai_tool_schema_value(child, key)return compacteddiff --git a/tests/test_openai_responses_context_compaction.py b/tests/test_openai_responses_context_compaction.pyindex f501f642a..264d693a3 100644--- a/tests/test_openai_responses_context_compaction.py+++ b/tests/test_openai_responses_context_compaction.py@@ -99,6 +99,66 @@ def test_openai_tool_schema_compaction_preserves_invocation_shape() -> None:assert tool["parameters"]["properties"]["path"]["description"] == " ".join(verbose.split())+def test_openai_tool_schema_compaction_preserves_property_named_title() -> None:+ """Issue #759: drop-key list must not strip property *names* under `properties`.++ Schema annotations like ``title: "ReadFileParameters"`` on a schema object+ are safe to drop. But a tool that has a field literally called ``title``+ (or ``readOnly``, ``deprecated``, etc.) must survive compaction; removing+ it while leaving ``required: ["title"]`` produces an invalid strict schema+ that upstream (OpenAI / Codex) rejects.+ """+ payload = {+ "tools": [+ {+ "type": "function",+ "name": "eval",+ "description": "Evaluate cells.",+ "parameters": {+ "$schema": "https://json-schema.org/draft/2020-12/schema",+ "title": "EvalParameters",+ "type": "object",+ "properties": {+ "cells": {+ "type": "array",+ "items": {+ "type": "object",+ "title": "CellItem",+ "properties": {+ "language": {"type": "string"},+ "code": {"type": "string"},+ "title": {"type": "string"},+ },+ "required": ["language", "code", "title"],+ },+ }+ },+ "required": ["cells"],+ },+ }+ ]+ }++ compacted, modified, before, after = _compact_openai_responses_tools(payload)++ assert modified is True+ assert after < before++ params = compacted["tools"][0]["parameters"]+ # Schema-level annotations are still dropped.+ assert "title" not in params+ assert "$schema" not in params++ items = params["properties"]["cells"]["items"]+ # "title" as a JSON Schema annotation on the items object is dropped.+ assert "title" not in items+ # "title" as a *property name* inside properties must be preserved.+ assert "title" in items["properties"], (+ "property named 'title' was incorrectly stripped by compaction"+ )+ assert items["required"] == ["language", "code", "title"]++def test_openai_tool_schema_compaction_is_deterministic() -> None:payload = {"tools": [