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

{codex_agent_framework-0.1.80 → codex_agent_framework-0.1.82}/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.82] - 2026-05-18
+### Changed
+- Document process-backed runtime serialization, event payload, worker command dispatch, and worker loop helper contracts with concise docstrings.
+
+### Tests
+- Validate the runtime documentation pass with targeted runtime tests plus the full offline CI suite (618 passed).
+
+## [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.

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

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

{codex_agent_framework-0.1.80 → codex_agent_framework-0.1.82}/codex_agent/agent_runtime.py

@@ -16,6 +16,7 @@ from .utils import token_count, truncate
 
 
 def jsonable(value):
+    """Return a JSON-compatible copy of a runtime payload."""
     return json.loads(json.dumps(value, ensure_ascii=False, default=str))
 
 
@@ -707,6 +708,7 @@ class _RuntimeFuture:
 
 
 def agent_worker_main(command_queue, response_queue, event_queue, agent_kwargs):
+    """Run the child-process command loop for a process-backed Agent."""
     agent = Agent(**dict(agent_kwargs or {}))
     agent.config_manager.save()
 
@@ -731,6 +733,7 @@ def agent_worker_main(command_queue, response_queue, event_queue, agent_kwargs):
 
 
 def event_payload(event):
+    """Normalize runtime events into JSON-compatible payload dictionaries."""
     if isinstance(event, Event):
         payload = event.copy()
     elif isinstance(event, (dict, modict)):
@@ -742,6 +745,7 @@ def event_payload(event):
 
 
 def run_worker_command(agent, name, payload):
+    """Dispatch a process-worker runtime command to an Agent instance."""
     if name == "start":
         return agent.start()
     if name == "stop":

{codex_agent_framework-0.1.80 → codex_agent_framework-0.1.82}/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.82/codex_agent/version.py

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

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

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

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

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

{codex_agent_framework-0.1.80 → codex_agent_framework-0.1.82}/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.80/codex_agent/version.py

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