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

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

@@ -4,6 +4,20 @@ 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.81] - 2026-05-18
+### Changed
+- Document the remaining built-in slash commands and make `/help` show concise command summaries from their docstrings.
+
+### Tests
+- Validate the command help pass with targeted command tests plus the full offline CI suite (618 passed).
+
+## [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.81}/PKG-INFO

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

{codex_agent_framework-0.1.79 → codex_agent_framework-0.1.81}/codex_agent/builtin_commands.py

@@ -27,16 +27,25 @@ def format_config_output(value, prefix=""):
     return "\n".join(_format_lines(value, prefix=prefix)) if isinstance(value, dict) else repr(value)
 
 
+def _command_summary(func):
+    doc = (getattr(func, "__doc__", None) or "").strip()
+    return doc.splitlines()[0].strip() if doc else ""
+
+
 @command
 def help():
     """List slash commands currently registered on the active agent."""
     agent = get_agent()
-    names = ", ".join(f"/{name}" for name in sorted(agent.commands))
-    return f"Available commands: {names}"
+    lines = ["Available commands:"]
+    for name in sorted(agent.commands):
+        summary = _command_summary(agent.commands[name])
+        lines.append(f"/{name} - {summary}" if summary else f"/{name}")
+    return "\n".join(lines)
 
 
 @command
 def compact(max_compacted_turns=None):
+    """Compact the current session history, optionally limiting compacted turns."""
     agent = get_agent()
     max_compacted_turns = None if max_compacted_turns in (None, "", "all") else int(max_compacted_turns)
     message = agent.compact_session(
@@ -83,6 +92,7 @@ def _format_session_list(agent):
 
 @command
 def session(action=None, *parts):
+    """List, create, rename, or switch persisted chat sessions."""
     agent = get_agent()
     if action is None:
         return _format_session_list(agent)
@@ -120,6 +130,7 @@ def session(action=None, *parts):
 
 @command
 def config(path=None, value=None, *extra, **values):
+    """Show, update, or save runtime configuration values."""
     agent = get_agent()
     manager = agent.config_manager
 
@@ -193,6 +204,7 @@ def verbosity(value=None):
 
 @command
 def voice(value=None):
+    """Show or update TTS voice settings through the TTS plugin."""
     agent = get_agent()
     if "tts" not in agent.plugins:
         agent.load_builtin_plugin("tts")

{codex_agent_framework-0.1.79 → codex_agent_framework-0.1.81}/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.81/codex_agent/version.py

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

{codex_agent_framework-0.1.79 → codex_agent_framework-0.1.81/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.81
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT

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

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

{codex_agent_framework-0.1.79 → codex_agent_framework-0.1.81}/tests/test_agent_commands.py

@@ -126,8 +126,10 @@ def test_agent_loads_builtin_commands():
     agent = Agent(session="new")
 
     assert {"help", "compact", "config", "model", "reasoning", "verbosity", "voice"}.issubset(agent.commands)
-    assert "/help" in agent_result(agent, "/help")
-    assert "/compact" in agent_result(agent, "/help")
+    output = agent_result(agent, "/help")
+    assert "/help - List slash commands" in output
+    assert "/compact - Compact the current session history" in output
+    assert "/voice - Show or update TTS voice settings" in output
 
 
 def test_builtin_model_config_commands_update_and_persist(tmp_path, monkeypatch):

codex_agent_framework-0.1.79/codex_agent/version.py

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