token-runtime 0.1.0a2__tar.gz → 0.1.0a3__tar.gz

{token_runtime-0.1.0a2 → token_runtime-0.1.0a3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: token-runtime
-Version: 0.1.0a2
+Version: 0.1.0a3
 Summary: Quality-preserving local context optimization runtime for LLM clients
 Author: Tungvoc3199
 License: Apache-2.0
@@ -37,7 +37,7 @@ Local-first adaptive context optimization for Codex and OpenAI-compatible AI age
 ![License](https://img.shields.io/badge/license-Apache--2.0-22D3EE)
 ![Local First](https://img.shields.io/badge/privacy-local--first-238636)
 ![Codex](https://img.shields.io/badge/Codex-integration_verified-8957e5)
-[![Release](https://img.shields.io/badge/release-v0.1.0--alpha.2-0EA5E9)](https://github.com/Tungvoc3199/token-runtime/releases/tag/v0.1.0-alpha.2)
+[![Release](https://img.shields.io/badge/release-v0.1.0--alpha.3-0EA5E9)](https://github.com/Tungvoc3199/token-runtime/releases/tag/v0.1.0-alpha.3)
 
 [Quickstart](#quickstart) · [Proof](#proof) · [How it works](#how-it-works) · [Safety](#safety-first-by-design) · [Compatibility](#compatibility) · [Compatibility matrix](docs/COMPATIBILITY.md) · [Security](SECURITY.md)
 
@@ -118,8 +118,16 @@ The V1 planner protects the active turn, protocol state, hard constraints, exact
 
 Python 3.12+ is required.
 
+Install the Alpha.3 package from PyPI after publication:
+
+```bash
+pip install token-runtime==0.1.0a3
+```
+
+Or install it as an isolated CLI tool with `uv`:
+
 ```bash
-python3 -m pip install . --no-build-isolation
+uv tool install token-runtime==0.1.0a3
 ```
 
 Preview integration changes first:
@@ -174,6 +182,7 @@ For Codex, TOKEN transactionally manages only the selected OpenAI-compatible pro
 | Local OpenAI-compatible gateways/routers | ✅ Supported |
 | Anthropic Messages adapter/conformance | 🛡️ `PASSTHROUGH_ONLY`; offline conformance, not production gateway-wired |
 | Gemini GenerateContent adapter/conformance | 🛡️ `PASSTHROUGH_ONLY`; offline conformance, not production gateway-wired |
+| OpenAI Agents API managed-session conformance | 🛡️ `PASSTHROUGH_ONLY`; offline conformance only, not production routing |
 | Multimodal optimization | 🛡️ `PASSTHROUGH_ONLY` |
 
 `CERTIFIED` is always version- and boundary-specific. Canonical source can also contain adapters that are not deployed in the active gateway. See the [compatibility matrix](docs/COMPATIBILITY.md) for the exact evidence boundary.
@@ -230,7 +239,7 @@ The approved 24-call live campaign found a real regression class. The final poli
 - [Release process](docs/RELEASE-PROCESS.md)
 - [GitHub governance](docs/GITHUB-GOVERNANCE.md)
 - [Public benchmark](benchmarks/README.md)
-- [v0.1.0-alpha.2 release notes](docs/releases/v0.1.0-alpha.2.md)
+- [v0.1.0-alpha.3 release notes](docs/releases/v0.1.0-alpha.3.md)
 - [Apache-2.0 license](LICENSE)
 
 ---

{token_runtime-0.1.0a2 → token_runtime-0.1.0a3}/README.md

@@ -12,7 +12,7 @@ Local-first adaptive context optimization for Codex and OpenAI-compatible AI age
 ![License](https://img.shields.io/badge/license-Apache--2.0-22D3EE)
 ![Local First](https://img.shields.io/badge/privacy-local--first-238636)
 ![Codex](https://img.shields.io/badge/Codex-integration_verified-8957e5)
-[![Release](https://img.shields.io/badge/release-v0.1.0--alpha.2-0EA5E9)](https://github.com/Tungvoc3199/token-runtime/releases/tag/v0.1.0-alpha.2)
+[![Release](https://img.shields.io/badge/release-v0.1.0--alpha.3-0EA5E9)](https://github.com/Tungvoc3199/token-runtime/releases/tag/v0.1.0-alpha.3)
 
 [Quickstart](#quickstart) · [Proof](#proof) · [How it works](#how-it-works) · [Safety](#safety-first-by-design) · [Compatibility](#compatibility) · [Compatibility matrix](docs/COMPATIBILITY.md) · [Security](SECURITY.md)
 
@@ -93,8 +93,16 @@ The V1 planner protects the active turn, protocol state, hard constraints, exact
 
 Python 3.12+ is required.
 
+Install the Alpha.3 package from PyPI after publication:
+
+```bash
+pip install token-runtime==0.1.0a3
+```
+
+Or install it as an isolated CLI tool with `uv`:
+
 ```bash
-python3 -m pip install . --no-build-isolation
+uv tool install token-runtime==0.1.0a3
 ```
 
 Preview integration changes first:
@@ -149,6 +157,7 @@ For Codex, TOKEN transactionally manages only the selected OpenAI-compatible pro
 | Local OpenAI-compatible gateways/routers | ✅ Supported |
 | Anthropic Messages adapter/conformance | 🛡️ `PASSTHROUGH_ONLY`; offline conformance, not production gateway-wired |
 | Gemini GenerateContent adapter/conformance | 🛡️ `PASSTHROUGH_ONLY`; offline conformance, not production gateway-wired |
+| OpenAI Agents API managed-session conformance | 🛡️ `PASSTHROUGH_ONLY`; offline conformance only, not production routing |
 | Multimodal optimization | 🛡️ `PASSTHROUGH_ONLY` |
 
 `CERTIFIED` is always version- and boundary-specific. Canonical source can also contain adapters that are not deployed in the active gateway. See the [compatibility matrix](docs/COMPATIBILITY.md) for the exact evidence boundary.
@@ -205,7 +214,7 @@ The approved 24-call live campaign found a real regression class. The final poli
 - [Release process](docs/RELEASE-PROCESS.md)
 - [GitHub governance](docs/GITHUB-GOVERNANCE.md)
 - [Public benchmark](benchmarks/README.md)
-- [v0.1.0-alpha.2 release notes](docs/releases/v0.1.0-alpha.2.md)
+- [v0.1.0-alpha.3 release notes](docs/releases/v0.1.0-alpha.3.md)
 - [Apache-2.0 license](LICENSE)
 
 ---

{token_runtime-0.1.0a2 → token_runtime-0.1.0a3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "token-runtime"
-version = "0.1.0a2"
+version = "0.1.0a3"
 description = "Quality-preserving local context optimization runtime for LLM clients"
 readme = "README.md"
 license = { text = "Apache-2.0" }

{token_runtime-0.1.0a2 → token_runtime-0.1.0a3}/src/token_runtime/cli.py

@@ -101,7 +101,10 @@ def doctor_report(config_path: Path) -> dict[str, bool]:
         "gateway_reachable": False,
         "upstream_reachable": False,
     }
-    config = load_config(config_path)
+    try:
+        config = load_config(config_path)
+    except FileNotFoundError:
+        return report
     report["config_ok"] = True
 
     state = Path(config.state_dir)
@@ -236,6 +239,14 @@ def main(argv=None, *, stdin=None, stdout=None) -> int:
         })
         return 0
 
+    if args.command == "doctor":
+        report = doctor_report(path)
+        payload = dict(report)
+        if not report["config_ok"]:
+            payload["next_step"] = "token install --upstream <UPSTREAM_URL>"
+        _write_json(stdout, payload)
+        return 0 if all(report.values()) else 1
+
     config = load_config(path)
     if args.command == "serve":
         core, _ = _runtime(config)
@@ -245,10 +256,6 @@ def main(argv=None, *, stdin=None, stdout=None) -> int:
         _, metrics = _runtime(config)
         _write_json(stdout, metrics.summary())
         return 0
-    if args.command == "doctor":
-        report = doctor_report(path)
-        _write_json(stdout, report)
-        return 0 if all(report.values()) else 1
     if args.command == "optimize":
         core, _ = _runtime(config)
         prepared = core.prepare(args.endpoint, _read_input_bytes(stdin))

{token_runtime-0.1.0a2 → token_runtime-0.1.0a3}/src/token_runtime/compat_cert.py

@@ -10,6 +10,7 @@ from .capabilities import CapabilityKey
 from .codex_recertification import build_codex_01540_recertification
 from .compatibility import CompatibilityRecord, CompatibilityState
 from .gemini_conformance import build_gemini_conformance
+from .openai_agents_conformance import build_openai_agents_conformance
 from .openai_certification import build_openai_certification
 
 
@@ -395,6 +396,7 @@ def build_current_certification() -> CompatibilityCertificationBundle:
     codex = build_codex_01540_recertification()
     anthropic = build_anthropic_conformance()
     gemini = build_gemini_conformance()
+    agents = build_openai_agents_conformance()
 
     certified_evidence_ids = tuple(
         sorted(
@@ -443,7 +445,7 @@ def build_current_certification() -> CompatibilityCertificationBundle:
         )
     )
 
-    for bundle in (anthropic, gemini):
+    for bundle in (anthropic, gemini, agents):
         entries.append(
             CertificationEntry(
                 scope=_scope_for_key(

{token_runtime-0.1.0a2 → token_runtime-0.1.0a3}/src/token_runtime/gateway.py

@@ -9,8 +9,11 @@ from typing import Any
 from urllib.error import HTTPError
 from urllib.request import Request, urlopen
 
-from .adapters import ChatCompletionsAdapter, ResponsesAdapter
 from .metrics import MetricsStore
+from .protocol_registry import (
+    ProtocolAdapterRegistry,
+    default_protocol_adapter_registry,
+)
 from .model import OptimizationDecision
 
 
@@ -27,13 +30,22 @@ class PreparedRequest:
 
 
 class GatewayCore:
-    def __init__(self, *, engine, metrics: MetricsStore):
+    def __init__(
+        self,
+        *,
+        engine,
+        metrics: MetricsStore,
+        registry: ProtocolAdapterRegistry | None = None,
+    ):
         self.engine = engine
         self.metrics = metrics
+        self.registry = (
+            registry if registry is not None else default_protocol_adapter_registry()
+        )
 
     def prepare(self, path: str, raw_body: bytes) -> PreparedRequest:
         started = time.perf_counter()
-        adapter = self._adapter(path)
+        adapter = self.registry.resolve(path)
         if adapter is None:
             prepared = PreparedRequest(raw_body, False, ("unsupported_endpoint",), None)
             self._record(prepared, None, None, None, started)
@@ -68,15 +80,6 @@ class GatewayCore:
             self._record(prepared, None, payload, adapter.name, started)
             return prepared
 
-    @staticmethod
-    def _adapter(path: str):
-        clean_path = path.split("?", 1)[0]
-        if clean_path == "/v1/responses":
-            return ResponsesAdapter()
-        if clean_path == "/v1/chat/completions":
-            return ChatCompletionsAdapter()
-        return None
-
     def _record(self, prepared, result, payload, adapter_name, started) -> None:
         before = getattr(result, "before_estimated_tokens", None)
         after = getattr(result, "after_estimated_tokens", None)

token_runtime-0.1.0a3/src/token_runtime/openai_agents_conformance.py

@@ -0,0 +1,276 @@
+from __future__ import annotations
+
+from collections.abc import Callable, Mapping, Sequence
+from dataclasses import dataclass
+from hashlib import sha256
+import json
+
+from .capabilities import CapabilityDetector, CapabilityKey, CapabilityProfile, CapabilityRegistry
+from .compatibility import CompatibilityRecord, CompatibilityRegistry, CompatibilityState
+from .conformance import ConformanceResult, require_conformance, run_conformance
+
+OPENAI_AGENTS_API_KEY = CapabilityKey('generic-openai', 'openai_agents_api', 'openai')
+SNAPSHOT_DATE = '2026-09-13'
+CORPUS_VERSION = 'openai-agents-api-conformance-v1'
+API_STATUS = 'public_beta'
+OFFICIAL_SOURCE_REFS = (
+    'https://openai.com/index/introducing-the-agents-api/',
+    'https://openai.com/vi-VN/products/release-notes/',
+    'https://developers.openai.com/api/reference/python/resources/beta/subresources/agents/subresources/sessions/methods/create',
+    'https://developers.openai.com/api/reference/python/resources/beta/subresources/agents/subresources/sessions/subresources/events/methods/create',
+    'https://developers.openai.com/api/reference/python/resources/beta/subresources/agents/subresources/sessions/subresources/events/methods/stream',
+    'https://github.com/openai/openai-python/tree/e12b81d3bbf644ec7045e152d69bc4b68d69cd48/src/openai/types/beta',
+)
+
+TESTED_SHAPE_MANIFEST = {
+    'api_family': 'openai_agents_api',
+    'endpoint_families': (
+        'POST /agents/sessions',
+        'POST /agents/sessions/{session_id}/events',
+        'GET /agents/sessions/{session_id}/events',
+    ),
+    'session_fields': ('environment', 'agent', 'agent_id', 'input', 'metadata', 'stream', 'vault_ids'),
+    'agent_fields': ('tools', 'multi_agent'),
+    'documented_exact_input_event_types': ('agent.session.input.message',),
+    'documented_input_event_categories': ('message', 'cancellation', 'tool_result'),
+    'stream_events': (
+        'agent.session.created',
+        'agent.session.turn.created',
+        'agent.session.environment.ready',
+        'agent.session.subagent.created',
+        'agent.session.turn.item.added',
+        'agent.session.turn.content_part.added',
+        'agent.session.turn.output_text.delta',
+        'agent.session.turn.reasoning_summary_text.delta',
+        'agent.output.command_execution_output.delta',
+        'agent.session.requires_action',
+        'error',
+        'agent.session.idle',
+    ),
+    'synthetic_unknown_stream_events': ('agent.session.future.event',),
+    'identifier_fields': (
+        'event_id', 'session_id', 'item_id', 'turn_id', 'output_index',
+        'content_index', 'summary_index', 'session.id', 'subagent.session_id',
+    ),
+}
+
+ASSERTION_IDS = (
+    'certification_state_passthrough_only',
+    'corpus_digest_matches_raw_ordered_bytes',
+    'idempotency_key_frozen',
+    'mcp_and_vault_fixture_covered',
+    'native_context_management_claim_bounded',
+    'near_match_non_inheritance',
+    'official_sources_bound',
+    'stream_duplicate_and_order_frozen',
+    'stream_identifiers_frozen',
+    'unknown_event_frozen',
+)
+
+SESSION_CREATE_FIXTURE = b'''{
+  "environment" : {"type":"none"},
+  "agent_id" : "agent_fixture_saved",
+  "agent" : {"name":"fixture-agent","tools":[{"type":"mcp","server_label":"fixture-mcp","server_url":"https://example.invalid/mcp"}],"multi_agent":{"enabled":true,"max_concurrent_subagents":2}},
+  "input" : [{"role":"user","content":"fixture input"}],
+  "metadata" : {"fixture":"agents-conformance"},
+  "stream" : true,
+  "vault_ids" : ["vault_fixture"],
+  "future_field" : {"opaque":true}
+}'''
+
+INPUT_EVENT_FIXTURES = (
+    ('input-message', b'''{
+  "idempotency_key" : "idem_fixture_001",
+  "events" : [{"type":"agent.session.input.message","role":"user","content":"hello","future_nested":{"opaque":true}}]
+}'''),
+    ('input-cancellation', b'''{"fixture_category":"cancellation","payload":{"session_id":"sess_fixture","future_nested":{"opaque":true}}}'''),
+    ('input-tool-result', b'''{"fixture_category":"tool_result","payload":{"call_id":"call_fixture","output":"ok","future_nested":{"opaque":true}}}'''),
+)
+
+_DUPLICATE_FRAME = b'{"type":"agent.session.idle","event_id":"evt_dup","session":{"id":"sess_fixture"}}'
+STREAM_EVENT_FRAMES = (
+    ('session-created', b'{"type":"agent.session.created","event_id":"evt_001","session":{"id":"sess_fixture"}}'),
+    ('turn-created', b'{"type":"agent.session.turn.created","event_id":"evt_002","session_id":"sess_fixture","turn_id":"turn_fixture","turn":{"id":"turn_fixture","session_id":"sess_fixture"}}'),
+    ('environment-ready', b'{"type":"agent.session.environment.ready","event_id":"evt_003","session_id":"sess_fixture","turn_id":"turn_fixture","environment":{"type":"none"}}'),
+    ('subagent-created', b'{"type":"agent.session.subagent.created","event_id":"evt_004","subagent":{"id":"subagent_fixture","session_id":"sess_fixture"}}'),
+    ('item-added', b'{"type":"agent.session.turn.item.added","event_id":"evt_005","session_id":"sess_fixture","turn_id":"turn_fixture","output_index":0,"item":{"id":"item_fixture"}}'),
+    ('content-part-added', b'{"type":"agent.session.turn.content_part.added","event_id":"evt_006","session_id":"sess_fixture","turn_id":"turn_fixture","item_id":"item_fixture","output_index":0,"content_index":0,"part":{"type":"output_text","text":""}}'),
+    ('output-text-delta-a', b'{"type":"agent.session.turn.output_text.delta","event_id":"evt_007","session_id":"sess_fixture","turn_id":"turn_fixture","item_id":"item_fixture","output_index":0,"content_index":0,"delta":"A"}'),
+    ('output-text-delta-b', b'{"type":"agent.session.turn.output_text.delta","event_id":"evt_008","session_id":"sess_fixture","turn_id":"turn_fixture","item_id":"item_fixture","output_index":0,"content_index":0,"delta":"B"}'),
+    ('reasoning-summary-delta', b'{"type":"agent.session.turn.reasoning_summary_text.delta","event_id":"evt_009","session_id":"sess_fixture","turn_id":"turn_fixture","item_id":"reason_fixture","output_index":0,"summary_index":0,"delta":"reason"}'),
+    ('command-output-delta', b'{"type":"agent.output.command_execution_output.delta","event_id":"evt_010","session_id":"sess_fixture","turn_id":"turn_fixture","item_id":"command_fixture","output_index":0,"delta":"chunk"}'),
+    ('requires-action', b'{"type":"agent.session.requires_action","event_id":"evt_011","session":{"id":"sess_fixture","required_actions":[{"id":"action_fixture"}]}}'),
+    ('idle-error', b'{"type":"error","event_id":"evt_012","session_id":"sess_fixture","error":{"message":"fixture"}}'),
+    ('unknown-future-event', b'{"type":"agent.session.future.event","session_id":"sess_fixture","opaque":{"nested":[1,2,3]}}'),
+    ('duplicate-frame', _DUPLICATE_FRAME),
+    ('duplicate-frame-copy', _DUPLICATE_FRAME),
+)
+RAW_CORPUS = (('session-create', SESSION_CREATE_FIXTURE), *INPUT_EVENT_FIXTURES, *STREAM_EVENT_FRAMES)
+
+@dataclass(frozen=True, slots=True)
+class OpenAIAgentsConformanceEvidence:
+    api_family: str
+    api_status: str
+    snapshot_date: str
+    official_source_refs: tuple[str, ...]
+    sdk_client_version: str | None
+    corpus_version: str
+    tested_endpoint_families: tuple[str, ...]
+    protected_fields: tuple[str, ...]
+    tested_input_event_shapes: tuple[str, ...]
+    tested_stream_event_shapes: tuple[str, ...]
+    tested_identifier_fields: tuple[str, ...]
+    assertion_ids: tuple[str, ...]
+    tested_shape_fingerprint: str
+    corpus_digest: str
+    evidence_fingerprint: str
+    evidence_id: str
+
+@dataclass(frozen=True, slots=True)
+class OpenAIAgentsConformanceBundle:
+    evidence: OpenAIAgentsConformanceEvidence
+    profile: CapabilityProfile
+    record: CompatibilityRecord
+    detector: CapabilityDetector
+
+def _canonical_json_bytes(value: object) -> bytes:
+    return json.dumps(value, sort_keys=True, separators=(',', ':'), ensure_ascii=False).encode('utf-8')
+
+def tested_shape_fingerprint(manifest: Mapping[str, object]) -> str:
+    return sha256(_canonical_json_bytes(manifest)).hexdigest()
+
+def corpus_digest(records: Sequence[tuple[str, bytes]]) -> str:
+    digest = sha256()
+    for label, payload in records:
+        label_bytes = label.encode('utf-8')
+        digest.update(len(label_bytes).to_bytes(8, 'big'))
+        digest.update(label_bytes)
+        digest.update(len(payload).to_bytes(8, 'big'))
+        digest.update(payload)
+    return digest.hexdigest()
+
+def evidence_fingerprint(*, tested_shape_fingerprint: str, corpus_digest: str, assertion_ids: Sequence[str], snapshot_date: str, official_source_refs: Sequence[str], sdk_client_version: str | None) -> str:
+    payload = {
+        'api_family': 'openai_agents_api', 'api_status': API_STATUS,
+        'snapshot_date': snapshot_date, 'official_source_refs': sorted(official_source_refs),
+        'sdk_client_version': sdk_client_version, 'corpus_version': CORPUS_VERSION,
+        'tested_shape_fingerprint': tested_shape_fingerprint, 'corpus_digest': corpus_digest,
+        'assertion_ids': sorted(assertion_ids),
+    }
+    return sha256(_canonical_json_bytes(payload)).hexdigest()
+
+def _build_evidence() -> OpenAIAgentsConformanceEvidence:
+    shape_fp = tested_shape_fingerprint(TESTED_SHAPE_MANIFEST)
+    corpus_fp = corpus_digest(RAW_CORPUS)
+    evidence_fp = evidence_fingerprint(
+        tested_shape_fingerprint=shape_fp, corpus_digest=corpus_fp,
+        assertion_ids=ASSERTION_IDS, snapshot_date=SNAPSHOT_DATE,
+        official_source_refs=OFFICIAL_SOURCE_REFS, sdk_client_version=None,
+    )
+    return OpenAIAgentsConformanceEvidence(
+        api_family='openai_agents_api', api_status=API_STATUS, snapshot_date=SNAPSHOT_DATE,
+        official_source_refs=OFFICIAL_SOURCE_REFS, sdk_client_version=None,
+        corpus_version=CORPUS_VERSION,
+        tested_endpoint_families=tuple(TESTED_SHAPE_MANIFEST['endpoint_families']),
+        protected_fields=('session_state','agent_config','environment','metadata','native_compaction','native_recovery','tools','mcp','subagents','cancellation','usage_accounting','unknown_beta_fields'),
+        tested_input_event_shapes=(*TESTED_SHAPE_MANIFEST['documented_exact_input_event_types'], *TESTED_SHAPE_MANIFEST['documented_input_event_categories']),
+        tested_stream_event_shapes=tuple(TESTED_SHAPE_MANIFEST['stream_events']),
+        tested_identifier_fields=tuple(TESTED_SHAPE_MANIFEST['identifier_fields']),
+        assertion_ids=ASSERTION_IDS, tested_shape_fingerprint=shape_fp,
+        corpus_digest=corpus_fp, evidence_fingerprint=evidence_fp,
+        evidence_id=f'token-openai-agents-api-conformance-1:{SNAPSHOT_DATE}:{evidence_fp}',
+    )
+
+def build_openai_agents_conformance() -> OpenAIAgentsConformanceBundle:
+    evidence = _build_evidence()
+    profile = CapabilityProfile(key=OPENAI_AGENTS_API_KEY, stateful_sessions=True, native_context_management=True, evidence_id=evidence.evidence_id)
+    record = CompatibilityRecord(key=OPENAI_AGENTS_API_KEY, state=CompatibilityState.PASSTHROUGH_ONLY, evidence_id=evidence.evidence_id, reason='offline_conformance_only')
+    capabilities = CapabilityRegistry()
+    capabilities.register(profile)
+    compatibility = CompatibilityRegistry()
+    compatibility.register(record)
+    return OpenAIAgentsConformanceBundle(evidence, profile, record, CapabilityDetector(capabilities, compatibility))
+
+def _certification_state_passthrough_only() -> bool:
+    b = build_openai_agents_conformance()
+    return b.record.state is CompatibilityState.PASSTHROUGH_ONLY and b.record.reason == 'offline_conformance_only' and b.profile.evidence_id == b.record.evidence_id
+
+def _corpus_digest_matches_raw_ordered_bytes() -> bool:
+    return corpus_digest(RAW_CORPUS) == build_openai_agents_conformance().evidence.corpus_digest
+
+def _idempotency_key_frozen() -> bool:
+    p = json.loads(dict(INPUT_EVENT_FIXTURES)['input-message'].decode('utf-8'))
+    return p.get('idempotency_key') == 'idem_fixture_001'
+
+def _mcp_and_vault_fixture_covered() -> bool:
+    p = json.loads(SESSION_CREATE_FIXTURE.decode('utf-8'))
+    return p.get('vault_ids') == ['vault_fixture'] and any(t.get('type') == 'mcp' for t in p['agent']['tools']) and p.get('future_field') == {'opaque': True}
+
+def _native_context_management_claim_bounded() -> bool:
+    b = build_openai_agents_conformance()
+    p = b.profile
+    return p.stateful_sessions is True and p.native_context_management is True and p.streaming == 'unknown' and p.tool_calls == 'unknown' and p.reasoning_state == 'unknown' and p.exact_byte_preservation == 'unknown' and p.multimodal == 'unknown' and p.structured_output == 'unknown' and b.record.state is CompatibilityState.PASSTHROUGH_ONLY
+
+def _near_match_non_inheritance() -> bool:
+    b = build_openai_agents_conformance()
+    near = (
+        CapabilityKey('generic-openai','responses','openai'),
+        CapabilityKey('generic-openai','chat_completions','openai'),
+        CapabilityKey('generic-openai','openai_agents_api_v2','openai'),
+        CapabilityKey('generic-openai','openai_agents_api','openai-compatible'),
+        CapabilityKey('generic-openai','openai_agents_api','openai',model_family='gpt-future'),
+        CapabilityKey('generic-openai','openai_agents_api','openai',client_version='1'),
+        CapabilityKey('codex','openai_agents_api','openai'),
+    )
+    return all(b.detector.detect(k).profile is None and b.detector.detect(k).compatibility.state is CompatibilityState.PASSTHROUGH_ONLY and b.detector.detect(k).compatibility.reason == 'unknown_capability' for k in near)
+
+def _official_sources_bound() -> bool:
+    e = build_openai_agents_conformance().evidence
+    return e.snapshot_date == SNAPSHOT_DATE and e.sdk_client_version is None and e.official_source_refs == OFFICIAL_SOURCE_REFS
+
+def _stream_duplicate_and_order_frozen() -> bool:
+    labels = tuple(label for label, _ in STREAM_EVENT_FRAMES)
+    frames = tuple(payload for _, payload in STREAM_EVENT_FRAMES)
+    return labels[-2:] == ('duplicate-frame','duplicate-frame-copy') and frames[-2] == frames[-1] and frames.count(frames[-2]) == 2 and labels.index('output-text-delta-a') < labels.index('output-text-delta-b')
+
+def _stream_identifiers_frozen() -> bool:
+    parsed = {
+        label: json.loads(frame.decode('utf-8'))
+        for label, frame in STREAM_EVENT_FRAMES
+    }
+    known = {
+        label: event
+        for label, event in parsed.items()
+        if label != 'unknown-future-event'
+    }
+    if not all('event_id' in event for event in known.values()):
+        return False
+    for field in ('session_id', 'turn_id', 'item_id', 'output_index', 'content_index', 'summary_index'):
+        if not any(field in event for event in known.values()):
+            return False
+    return (
+        parsed['session-created']['session']['id'] == 'sess_fixture'
+        and parsed['subagent-created']['subagent']['session_id'] == 'sess_fixture'
+    )
+
+def _unknown_event_frozen() -> bool:
+    return any(json.loads(f.decode('utf-8')).get('type') == 'agent.session.future.event' and json.loads(f.decode('utf-8')).get('opaque') == {'nested':[1,2,3]} for _,f in STREAM_EVENT_FRAMES)
+
+def openai_agents_conformance_cases() -> Mapping[str, Callable[[], bool]]:
+    return {
+        'certification_state_passthrough_only': _certification_state_passthrough_only,
+        'corpus_digest_matches_raw_ordered_bytes': _corpus_digest_matches_raw_ordered_bytes,
+        'idempotency_key_frozen': _idempotency_key_frozen,
+        'mcp_and_vault_fixture_covered': _mcp_and_vault_fixture_covered,
+        'native_context_management_claim_bounded': _native_context_management_claim_bounded,
+        'near_match_non_inheritance': _near_match_non_inheritance,
+        'official_sources_bound': _official_sources_bound,
+        'stream_duplicate_and_order_frozen': _stream_duplicate_and_order_frozen,
+        'stream_identifiers_frozen': _stream_identifiers_frozen,
+        'unknown_event_frozen': _unknown_event_frozen,
+    }
+
+def run_openai_agents_conformance() -> tuple[ConformanceResult, ...]:
+    results = run_conformance(openai_agents_conformance_cases())
+    require_conformance(results)
+    return results

token_runtime-0.1.0a3/src/token_runtime/protocol_registry.py

@@ -0,0 +1,49 @@
+from __future__ import annotations
+
+from typing import Any, Callable, Mapping, Protocol
+
+from .adapters import ChatCompletionsAdapter, ResponsesAdapter
+from .model import RequestEnvelope
+
+
+class ProtocolAdapter(Protocol):
+    name: str
+
+    def parse(self, payload: Mapping[str, Any]) -> RequestEnvelope: ...
+
+    def serialize(self, envelope: RequestEnvelope) -> dict[str, Any]: ...
+
+
+AdapterFactory = Callable[[], ProtocolAdapter]
+
+
+class DuplicateProtocolAdapterError(ValueError):
+    pass
+
+
+class ProtocolAdapterRegistry:
+    def __init__(self) -> None:
+        self._factories: dict[str, AdapterFactory] = {}
+
+    @staticmethod
+    def _normalize(path: str) -> str:
+        return path.split("?", 1)[0]
+
+    def register(self, endpoint: str, factory: AdapterFactory) -> None:
+        endpoint = self._normalize(endpoint)
+        if endpoint in self._factories:
+            raise DuplicateProtocolAdapterError(
+                f"duplicate protocol endpoint: {endpoint}"
+            )
+        self._factories[endpoint] = factory
+
+    def resolve(self, path: str) -> ProtocolAdapter | None:
+        factory = self._factories.get(self._normalize(path))
+        return None if factory is None else factory()
+
+
+def default_protocol_adapter_registry() -> ProtocolAdapterRegistry:
+    registry = ProtocolAdapterRegistry()
+    registry.register("/v1/responses", ResponsesAdapter)
+    registry.register("/v1/chat/completions", ChatCompletionsAdapter)
+    return registry

{token_runtime-0.1.0a2 → token_runtime-0.1.0a3}/src/token_runtime.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: token-runtime
-Version: 0.1.0a2
+Version: 0.1.0a3
 Summary: Quality-preserving local context optimization runtime for LLM clients
 Author: Tungvoc3199
 License: Apache-2.0
@@ -37,7 +37,7 @@ Local-first adaptive context optimization for Codex and OpenAI-compatible AI age
 ![License](https://img.shields.io/badge/license-Apache--2.0-22D3EE)
 ![Local First](https://img.shields.io/badge/privacy-local--first-238636)
 ![Codex](https://img.shields.io/badge/Codex-integration_verified-8957e5)
-[![Release](https://img.shields.io/badge/release-v0.1.0--alpha.2-0EA5E9)](https://github.com/Tungvoc3199/token-runtime/releases/tag/v0.1.0-alpha.2)
+[![Release](https://img.shields.io/badge/release-v0.1.0--alpha.3-0EA5E9)](https://github.com/Tungvoc3199/token-runtime/releases/tag/v0.1.0-alpha.3)
 
 [Quickstart](#quickstart) · [Proof](#proof) · [How it works](#how-it-works) · [Safety](#safety-first-by-design) · [Compatibility](#compatibility) · [Compatibility matrix](docs/COMPATIBILITY.md) · [Security](SECURITY.md)
 
@@ -118,8 +118,16 @@ The V1 planner protects the active turn, protocol state, hard constraints, exact
 
 Python 3.12+ is required.
 
+Install the Alpha.3 package from PyPI after publication:
+
+```bash
+pip install token-runtime==0.1.0a3
+```
+
+Or install it as an isolated CLI tool with `uv`:
+
 ```bash
-python3 -m pip install . --no-build-isolation
+uv tool install token-runtime==0.1.0a3
 ```
 
 Preview integration changes first:
@@ -174,6 +182,7 @@ For Codex, TOKEN transactionally manages only the selected OpenAI-compatible pro
 | Local OpenAI-compatible gateways/routers | ✅ Supported |
 | Anthropic Messages adapter/conformance | 🛡️ `PASSTHROUGH_ONLY`; offline conformance, not production gateway-wired |
 | Gemini GenerateContent adapter/conformance | 🛡️ `PASSTHROUGH_ONLY`; offline conformance, not production gateway-wired |
+| OpenAI Agents API managed-session conformance | 🛡️ `PASSTHROUGH_ONLY`; offline conformance only, not production routing |
 | Multimodal optimization | 🛡️ `PASSTHROUGH_ONLY` |
 
 `CERTIFIED` is always version- and boundary-specific. Canonical source can also contain adapters that are not deployed in the active gateway. See the [compatibility matrix](docs/COMPATIBILITY.md) for the exact evidence boundary.
@@ -230,7 +239,7 @@ The approved 24-call live campaign found a real regression class. The final poli
 - [Release process](docs/RELEASE-PROCESS.md)
 - [GitHub governance](docs/GITHUB-GOVERNANCE.md)
 - [Public benchmark](benchmarks/README.md)
-- [v0.1.0-alpha.2 release notes](docs/releases/v0.1.0-alpha.2.md)
+- [v0.1.0-alpha.3 release notes](docs/releases/v0.1.0-alpha.3.md)
 - [Apache-2.0 license](LICENSE)
 
 ---

{token_runtime-0.1.0a2 → token_runtime-0.1.0a3}/src/token_runtime.egg-info/SOURCES.txt

@@ -24,8 +24,10 @@ src/token_runtime/gemini_conformance.py
 src/token_runtime/integrations.py
 src/token_runtime/metrics.py
 src/token_runtime/model.py
+src/token_runtime/openai_agents_conformance.py
 src/token_runtime/openai_certification.py
 src/token_runtime/planner.py
+src/token_runtime/protocol_registry.py
 src/token_runtime/reducers.py
 src/token_runtime/store.py
 src/token_runtime/strategies.py
@@ -40,6 +42,7 @@ tests/test_adapters.py
 tests/test_agent_integration_safety.py
 tests/test_agent_integrations.py
 tests/test_alpha2_release_candidate.py
+tests/test_alpha3_release_candidate.py
 tests/test_anthropic_adapter.py
 tests/test_anthropic_conformance.py
 tests/test_anthropic_preserved_thinking_benchmark.py
@@ -53,7 +56,9 @@ tests/test_compat_cert.py
 tests/test_compatibility.py
 tests/test_config.py
 tests/test_conformance.py
+tests/test_current_release_candidate.py
 tests/test_distribution.py
+tests/test_distribution_version_generalization.py
 tests/test_docs_growth.py
 tests/test_engine.py
 tests/test_evolution_contracts.py
@@ -64,11 +69,15 @@ tests/test_gemini_adapter.py
 tests/test_gemini_conformance.py
 tests/test_governance.py
 tests/test_integrations.py
+tests/test_llm_change_isolation.py
 tests/test_metrics.py
 tests/test_model.py
+tests/test_onboarding_ux.py
+tests/test_openai_agents_conformance.py
 tests/test_openai_certification.py
 tests/test_oss_surface.py
 tests/test_planner.py
+tests/test_protocol_registry.py
 tests/test_public_benchmark.py
 tests/test_public_classification.py
 tests/test_public_ready.py