codex-agent-framework 0.1.76__tar.gz → 0.1.78__tar.gz

{codex_agent_framework-0.1.76/codex_agent_framework.egg-info → codex_agent_framework-0.1.78}/PKG-INFO

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

{codex_agent_framework-0.1.76 → codex_agent_framework-0.1.78}/codex_agent/builtin_plugins/content/system.py

@@ -55,6 +55,7 @@ def close_tui():
 
 
 def open_silently(target: str) -> bool:
+    """Open a target best-effort while detaching noisy desktop output."""
     if os.name == "posix":
         opener = "open" if sys.platform == "darwin" else "xdg-open"
         try:

{codex_agent_framework-0.1.76 → codex_agent_framework-0.1.78}/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.76 → codex_agent_framework-0.1.78}/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.78/codex_agent/version.py

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

{codex_agent_framework-0.1.76 → codex_agent_framework-0.1.78/codex_agent_framework.egg-info}/PKG-INFO

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

{codex_agent_framework-0.1.76 → codex_agent_framework-0.1.78}/pyproject.toml

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

{codex_agent_framework-0.1.76 → codex_agent_framework-0.1.78}/tests/test_agent_response.py

@@ -1,5 +1,6 @@
 import json
 import os
+import subprocess
 from types import SimpleNamespace
 
 import codex_agent.utils as utils
@@ -284,6 +285,51 @@ def test_agent_persists_server_tool_output_items_as_messages():
     assert server_message.to_response_format() == item
 
 
+def test_open_silently_uses_detached_posix_opener(monkeypatch):
+    import codex_agent.builtin_plugins.content.system as system_tools
+
+    calls = []
+
+    def fake_popen(command, **kwargs):
+        calls.append((command, kwargs))
+
+    monkeypatch.setattr(system_tools.os, "name", "posix")
+    monkeypatch.setattr(system_tools.sys, "platform", "linux")
+    monkeypatch.setattr(system_tools.subprocess, "Popen", fake_popen)
+    monkeypatch.setattr(system_tools.webbrowser, "open", lambda target: False)
+
+    assert system_tools.open_silently("/tmp/file.txt") is True
+    assert calls == [([
+        "xdg-open",
+        "/tmp/file.txt",
+    ], {
+        "stdout": subprocess.DEVNULL,
+        "stderr": subprocess.DEVNULL,
+        "stdin": subprocess.DEVNULL,
+        "start_new_session": True,
+    })]
+
+
+def test_open_silently_falls_back_to_webbrowser_when_posix_opener_missing(monkeypatch):
+    import codex_agent.builtin_plugins.content.system as system_tools
+
+    calls = []
+
+    def missing_opener(*args, **kwargs):
+        raise FileNotFoundError
+
+    def fake_web_open(target):
+        calls.append(target)
+        return True
+
+    monkeypatch.setattr(system_tools.os, "name", "posix")
+    monkeypatch.setattr(system_tools.subprocess, "Popen", missing_opener)
+    monkeypatch.setattr(system_tools.webbrowser, "open", fake_web_open)
+
+    assert system_tools.open_silently("https://example.com") is True
+    assert calls == ["https://example.com"]
+
+
 def test_open_tui_tool_bridges_to_agent_server():
     import codex_agent.builtin_plugins.content.system as system_tools
     from codex_agent.tool import reset_current_agent, set_current_agent

codex_agent_framework-0.1.76/codex_agent/version.py

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