codex-agent-framework 0.1.71__tar.gz → 0.1.73__tar.gz

{codex_agent_framework-0.1.71/codex_agent_framework.egg-info → codex_agent_framework-0.1.73}/PKG-INFO

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

{codex_agent_framework-0.1.71 → codex_agent_framework-0.1.73}/codex_agent/cli/main.py

@@ -13,6 +13,7 @@ PACKAGE_DIR = Path(__file__).resolve().parents[1]
 
 
 def default_agent_kwargs(host=None, port=None):
+    """Build default Agent constructor kwargs used by CLI entrypoints."""
     kwargs = dict(
         system=str(PACKAGE_DIR / 'prompts' / 'system_prompt.txt'),
         username="Baptiste",
@@ -24,15 +25,18 @@ def default_agent_kwargs(host=None, port=None):
 
 
 def default_agent():
+    """Create the default CLI Agent instance."""
     return Agent(**default_agent_kwargs())
 
 
 def configure_server_url(agent, host, port):
+    """Point an Agent at the CLI-managed local server URL."""
     agent.config_manager.update(server_url=f"http://{host}:{port}", save=False)
     return agent
 
 
 def run_server(host="127.0.0.1", port=8765):
+    """Run the local HTTP server in the foreground."""
     import uvicorn
 
     app = create_app(process_agent=True, **default_agent_kwargs(host, port))
@@ -42,10 +46,12 @@ def run_server(host="127.0.0.1", port=8765):
 
 
 def run_chat(base_url="http://127.0.0.1:8765"):
+    """Run the Textual chat interface against a server URL."""
     Chat(base_url=base_url).run()
 
 
 def server_is_available(base_url, timeout=0.5):
+    """Return whether the local agent server responds to health checks."""
     try:
         from codex_agent.client import AgentClient
         AgentClient(base_url, timeout=timeout).health()
@@ -55,10 +61,12 @@ def server_is_available(base_url, timeout=0.5):
 
 
 def run_tray_mode(base_url="http://127.0.0.1:8765"):
+    """Run the desktop tray integration against a server URL."""
     run_tray(base_url=base_url)
 
 
 def run_system_deps_installer(extra_args=None):
+    """Run the packaged system dependency installer script."""
     script = PACKAGE_DIR / "scripts" / "install-system-dependencies.sh"
     if not script.is_file():
         raise RuntimeError(f"System dependency installer not found: {script}")
@@ -74,6 +82,7 @@ def run_bootstrap(
     install_service=True,
     start_service=True,
 ):
+    """Install optional system dependencies and user service components."""
     if install_system_deps:
         code = run_system_deps_installer(system_deps_args or [])
         if code:
@@ -86,6 +95,7 @@ def run_bootstrap(
 
 
 def run_local(host="127.0.0.1", port=8765):
+    """Open chat on an existing server or a temporary local server."""
     import threading
     import time
 
@@ -112,6 +122,7 @@ def run_local(host="127.0.0.1", port=8765):
 
 
 def build_parser():
+    """Build the legacy single-command CLI argument parser."""
     import argparse
 
     parser = argparse.ArgumentParser(prog="codex-agent")
@@ -138,6 +149,7 @@ def build_parser():
 
 
 def run_agent_cli(argv=None):
+    """Dispatch legacy CLI modes and headless API subcommands."""
     parser = build_parser()
     args, extra_args = parser.parse_known_args(argv)
     headless_modes = {"run", "prompt", "status", "tools", "sessions", "config", "interrupt"}
@@ -186,6 +198,7 @@ def run_agent_cli(argv=None):
 
 
 def main(argv=None):
+    """Run the public codex-agent command-line entrypoint."""
     load_runtime_env()
     from .root import dispatch
     dispatch(argv, fallback=run_agent_cli)

{codex_agent_framework-0.1.71 → codex_agent_framework-0.1.73}/codex_agent/runtime.py

@@ -4,6 +4,8 @@ from modict import modict
 
 
 class RuntimeManager:
+    """Small HTTP bridge for runtime actions handled by the local server."""
+
     def __init__(self, agent):
         self.agent = agent
 

{codex_agent_framework-0.1.71 → codex_agent_framework-0.1.73}/codex_agent/scheduler.py

@@ -13,6 +13,8 @@ from .utils import atomic_write_json, runtime_join
 
 
 class WakeupJob(modict):
+    """Persisted scheduled wakeup state stored in the agent runtime file."""
+
     _config = modict.config(enforce_json=True, require_all="never")
 
     id = modict.factory(lambda: str(uuid.uuid4()))
@@ -37,14 +39,17 @@ class WakeupJob(modict):
 
 
 def utc_now():
+    """Return the current timezone-aware UTC datetime."""
     return datetime.now(timezone.utc)
 
 
 def utc_now_iso():
+    """Return the current UTC datetime as an ISO-8601 string."""
     return utc_now().isoformat()
 
 
 def parse_datetime(value):
+    """Parse a datetime or ISO string and normalize it to UTC."""
     if isinstance(value, datetime):
         dt = value
     elif isinstance(value, str):
@@ -60,6 +65,7 @@ def parse_datetime(value):
 
 
 def next_run_at(run_at=None, delay_seconds=None):
+    """Resolve an absolute or delayed wakeup time to an ISO UTC string."""
     if run_at:
         return parse_datetime(run_at).isoformat()
     if delay_seconds is None:

codex_agent_framework-0.1.73/codex_agent/version.py

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

{codex_agent_framework-0.1.71 → codex_agent_framework-0.1.73/codex_agent_framework.egg-info}/PKG-INFO

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

{codex_agent_framework-0.1.71 → codex_agent_framework-0.1.73}/pyproject.toml

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

codex_agent_framework-0.1.71/codex_agent/version.py

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