codex-agent-framework 0.1.79__tar.gz → 0.1.80__tar.gz

{codex_agent_framework-0.1.79 → codex_agent_framework-0.1.80}/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project will be documented in this file.
 
 This project loosely follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and uses semantic versioning where practical.
 
+## [0.1.80] - 2026-05-18
+### Changed
+- Document `AgentClient` event-stream, SSE parsing, sequence resume, URL, and HTTP request helper contracts with concise docstrings.
+
+### Tests
+- Validate the client documentation pass with targeted client tests plus the full offline CI suite (618 passed).
+
 ## [0.1.60] - 2026-05-18
 ### Fixed
 - Count compacted summary messages with observed compaction `usage.output_tokens` instead of `usage.input_tokens`, so future context estimates reflect the size of the produced summary rather than the size of the compacted input.

{codex_agent_framework-0.1.79/codex_agent_framework.egg-info → codex_agent_framework-0.1.80}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.79
+Version: 0.1.80
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT

{codex_agent_framework-0.1.79 → codex_agent_framework-0.1.80}/codex_agent/client.py

@@ -276,6 +276,7 @@ class AgentClient:
                     self._event_stop.wait(0.1)
 
     def event_error_payload(self, exc):
+        """Build a local client error event from an event-stream exception."""
         payload = modict(type="client_event_error", error=str(exc), source="event_stream")
         if isinstance(exc, requests.HTTPError) and exc.response is not None:
             payload.status_code = exc.response.status_code
@@ -289,11 +290,13 @@ class AgentClient:
         return payload
 
     def is_event_idle_timeout(self, exc):
+        """Return whether an event-stream exception is an idle read timeout."""
         if isinstance(exc, (requests.exceptions.ReadTimeout, requests.exceptions.Timeout)):
             return True
         return "read timed out" in str(exc).lower()
 
     def iter_sse(self, lines):
+        """Yield parsed SSE payloads from decoded or byte line chunks."""
         event = None
         data_lines = []
         event_id = None
@@ -339,6 +342,7 @@ class AgentClient:
             yield payload
 
     def remember_event_sequence(self, event):
+        """Track the highest numeric event sequence seen for replay resume."""
         sequence = event.get("sequence") if isinstance(event, dict) else None
         if sequence is None:
             return
@@ -348,17 +352,22 @@ class AgentClient:
             return
         if self._last_event_sequence is None or sequence > self._last_event_sequence:
             self._last_event_sequence = sequence
+
     def events_url(self):
+        """Build the SSE endpoint URL with replay and compaction parameters."""
         params = {"client_pid": int(self.client_pid)}
         if self.compact_events:
             params["compact"] = 1
         if self._last_event_sequence is not None:
             params["after_sequence"] = int(self._last_event_sequence)
         return self.url(f"/events?{urlencode(params)}")
+
     def url(self, path):
+        """Return an absolute server URL for an API path."""
         return self.base_url + path
 
     def request(self, method, path, **kwargs):
+        """Send an HTTP request and decode its JSON response as a modict."""
         kwargs.setdefault("timeout", self.timeout)
         response = requests.request(method, self.url(path), **kwargs)
         response.raise_for_status()
@@ -367,12 +376,15 @@ class AgentClient:
         return modict(response.json())
 
     def get(self, path):
+        """Send a GET request to a server API path."""
         return self.request("GET", path)
 
     def post(self, path, payload=None):
+        """Send a JSON POST request to a server API path."""
         return self.request("POST", path, json=payload or {})
 
     def delete(self, path):
+        """Send a DELETE request to a server API path."""
         return self.request("DELETE", path)
 
     def health(self):

codex_agent_framework-0.1.80/codex_agent/version.py

@@ -0,0 +1 @@
+__version__ = "0.1.80"

{codex_agent_framework-0.1.79 → codex_agent_framework-0.1.80/codex_agent_framework.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.79
+Version: 0.1.80
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT

{codex_agent_framework-0.1.79 → codex_agent_framework-0.1.80}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codex-agent-framework"
-version = "0.1.79"
+version = "0.1.80"
 description = "A lightweight event-driven Codex agent runtime."
 readme = "README.md"
 requires-python = ">=3.11"

codex_agent_framework-0.1.79/codex_agent/version.py

@@ -1 +0,0 @@
-__version__ = "0.1.79"