codex-agent-framework 0.1.75__tar.gz → 0.1.77__tar.gz

{codex_agent_framework-0.1.75/codex_agent_framework.egg-info → codex_agent_framework-0.1.77}/PKG-INFO

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

{codex_agent_framework-0.1.75 → codex_agent_framework-0.1.77}/codex_agent/builtin_commands.py

@@ -23,11 +23,13 @@ def _format_lines(value, prefix=""):
 
 
 def format_config_output(value, prefix=""):
+    """Render config values as readable slash-command output."""
     return "\n".join(_format_lines(value, prefix=prefix)) if isinstance(value, dict) else repr(value)
 
 
 @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}"
@@ -157,6 +159,7 @@ def config(path=None, value=None, *extra, **values):
 
 @command
 def model(value=None):
+    """Show or update the active model configuration value."""
     if value is None:
         return f"model: {get_agent().config.model!r}"
     get_agent().config_manager.set_path("agent.model", value, save=True)
@@ -165,6 +168,7 @@ def model(value=None):
 
 @command
 def reasoning(value=None):
+    """Show or update the reasoning effort config shortcut."""
     agent = get_agent()
     if value is None:
         return f"reasoning: {agent.config.get('reasoning')!r}"
@@ -177,6 +181,7 @@ def reasoning(value=None):
 
 @command
 def verbosity(value=None):
+    """Show or update the text verbosity config shortcut."""
     agent = get_agent()
     if value is None:
         return f"text: {agent.config.get('text')!r}"

{codex_agent_framework-0.1.75 → codex_agent_framework-0.1.77}/codex_agent/cli/headless.py

@@ -48,6 +48,7 @@ def read_prompt(args, extra_args):
 
 
 def with_runner(args, callback):
+    """Start the selected runner, invoke a callback, and stop it if needed."""
     runner = runner_from_args(args).start()
     try:
         return callback(runner)
@@ -57,12 +58,14 @@ def with_runner(args, callback):
 
 
 def run_status(args, extra_args=None):
+    """Fetch and print agent runtime status."""
     payload = with_runner(args, lambda runner: runner.get_status())
     output_payload(payload, fmt=output_format(args), text_formatter=key_value_text)
     return payload
 
 
 def run_tools(args, extra_args=None):
+    """Fetch and print registered tool names or metadata."""
     payload = with_runner(args, lambda runner: runner.tools())
 
     def format_tools(data):
@@ -94,6 +97,7 @@ def parse_config_set_args(extra_args):
 
 
 def run_config(args, extra_args=None):
+    """Run `config get` or `config set` through the selected runner."""
     extra_args = list(extra_args or [])
     command = extra_args[0] if extra_args else "get"
     if command == "get":
@@ -149,6 +153,7 @@ def run_sessions(args, extra_args=None):
 
 
 def run_interrupt(args, extra_args=None):
+    """Ask the active runtime to interrupt the current turn."""
     reason = " ".join(extra_args or []).strip() or "cli"
     payload = with_runner(args, lambda runner: runner.interrupt(reason=reason))
     output_payload(payload, fmt=output_format(args), text_formatter=key_value_text)

{codex_agent_framework-0.1.75 → codex_agent_framework-0.1.77}/codex_agent/cli/root.py

@@ -53,6 +53,7 @@ def build_root_parser():
 
 
 def print_root_help():
+    """Print help for the public root CLI parser."""
     build_root_parser().print_help()
 
 
@@ -97,6 +98,7 @@ def _detached_start(name, args):
 
 
 def start_service(name, args):
+    """Start a supported service in foreground or detached mode."""
     parsed, extra = _parse_connection_args(args)
     if extra:
         raise SystemExit(f"unrecognized arguments: {' '.join(extra)}")
@@ -120,18 +122,21 @@ def start_service(name, args):
 
 
 def stop_service(name, args=None):
+    """Stop a supported user service without requiring it to be active."""
     if name not in SERVICE_UNITS:
         raise SystemExit(f"usage: codex-agent stop {{{','.join(SERVICE_UNITS)}}}")
     service_controller().run("stop", SERVICE_UNITS[name], check=False)
 
 
 def restart_service(name, args=None):
+    """Restart a supported user service via the platform controller."""
     if name not in SERVICE_UNITS:
         raise SystemExit(f"usage: codex-agent restart {{{','.join(SERVICE_UNITS)}}}")
     service_controller().restart(SERVICE_UNITS[name], check=False)
 
 
 def open_interface(name, args):
+    """Ask the local server to open a supported interactive interface."""
     if name != "tui":
         raise SystemExit("usage: codex-agent open {tui}")
     parsed, extra = _parse_connection_args(args)
@@ -146,6 +151,7 @@ def open_interface(name, args):
 
 
 def close_interface(name, args):
+    """Ask the local server to close a supported interactive interface."""
     if name != "tui":
         raise SystemExit("usage: codex-agent close {tui}")
     parsed, extra = _parse_connection_args(args)

{codex_agent_framework-0.1.75 → codex_agent_framework-0.1.77}/codex_agent/stream.py

@@ -45,6 +45,8 @@ class StreamManager:
 
 
 class AgentStream:
+    """Iterator over live agent events for one submitted prompt or turn."""
+
     def __init__(self, agent, prompt=None):
         self.agent = agent
         self.prompt = prompt
@@ -58,6 +60,7 @@ class AgentStream:
         self._monitor_thread = None
 
     def start(self):
+        """Submit the stream turn and start forwarding emitted events."""
         self.mainloop_was_running = self.agent.mainloop_manager.thread is not None and self.agent.mainloop_manager.thread.is_alive()
         self._handler = self.agent.on("*", self._on_event)
         try:
@@ -105,6 +108,7 @@ class AgentStream:
 
     @property
     def turn(self):
+        """Return the completed turn once the stream future resolves."""
         return self.future.wait()
 
     def __iter__(self):

codex_agent_framework-0.1.77/codex_agent/version.py

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

{codex_agent_framework-0.1.75 → codex_agent_framework-0.1.77/codex_agent_framework.egg-info}/PKG-INFO

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

{codex_agent_framework-0.1.75 → codex_agent_framework-0.1.77}/pyproject.toml

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

codex_agent_framework-0.1.75/codex_agent/version.py

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