codex-agent-framework 0.1.72__tar.gz → 0.1.74__tar.gz

{codex_agent_framework-0.1.72/codex_agent_framework.egg-info → codex_agent_framework-0.1.74}/PKG-INFO

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

{codex_agent_framework-0.1.72 → codex_agent_framework-0.1.74}/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.72 → codex_agent_framework-0.1.74}/codex_agent/image.py

@@ -18,6 +18,7 @@ IMAGE_DIR = 'images'
 
 
 def ext_to_mime(ext):
+    """Return the MIME type matching a common image extension."""
     ext = ext.lower().lstrip('.')
     if ext in ('jpg', 'jpeg'):
         return 'image/jpeg'
@@ -36,6 +37,7 @@ def _data_url(data, mime_type):
 
 
 def data_url_from_file(path):
+    """Read a local image file and encode it as a data URL."""
     ext = os.path.splitext(path)[1]
     mime_type = ext_to_mime(ext) or 'image/jpeg'
     with open(path, 'rb') as f:
@@ -64,6 +66,7 @@ def image_request_headers(url):
 
 
 def image_mime_from_source(source, content_type=None):
+    """Infer an image MIME type from headers, paths, or bytes-like sources."""
     content_type = (content_type or '').split(';')[0].strip()
     if content_type.startswith('image/'):
         return content_type
@@ -74,6 +77,7 @@ def image_mime_from_source(source, content_type=None):
 
 
 def fetch_image_bytes(url, timeout=15):
+    """Download image bytes and validate or infer their MIME type."""
     response = requests.get(url, timeout=timeout, headers=image_request_headers(url))
     response.raise_for_status()
 
@@ -94,11 +98,13 @@ def fetch_image_bytes(url, timeout=15):
 
 
 def data_url_from_url(url):
+    """Fetch a remote image URL and encode it as a data URL."""
     data, mime_type = fetch_image_bytes(url)
     return _data_url(data, mime_type)
 
 
 def persist_image_url(url):
+    """Download a remote image and persist it in the runtime image cache."""
     data, mime_type = fetch_image_bytes(url)
     ext = os.path.splitext(url.split('?', 1)[0])[1] or None
     mime_ext = {
@@ -113,6 +119,7 @@ def persist_image_url(url):
 
 
 def get_data_url(source):
+    """Return a data URL for a supported local path or remote URL source."""
     if isinstance(source, str) and os.path.isfile(source):
         return data_url_from_file(source)
     if isinstance(source, str) and source.startswith(('http://', 'https://')):
@@ -121,6 +128,7 @@ def get_data_url(source):
 
 
 def persist_image_bytes(data, name=None):
+    """Persist raw image bytes under the runtime image cache directory."""
     _, ext = os.path.splitext(name) if isinstance(name, str) else ('', '')
     ext = ext or guess_extension_from_bytes(data) or '.png'
 
@@ -134,10 +142,12 @@ def persist_image_bytes(data, name=None):
 
 
 def persist_bytesio(source):
+    """Persist a BytesIO image source, preserving its filename extension."""
     return persist_image_bytes(source.getvalue(), name=getattr(source, 'name', None))
 
 
 def image_name_from_source(source):
+    """Return a human-friendly image name for paths, URLs, or byte streams."""
     if isinstance(source, BytesIO) and getattr(source, 'name', None):
         return os.path.basename(source.name)
     if isinstance(source, str) and os.path.isfile(source):
@@ -386,6 +396,7 @@ class ImageMessage(Message):
         return "\n".join(parts)
 
     def as_bytesio(self):
+        """Return the in-memory image payload as bytes, when available."""
         data_url = self.get_base64()
         if not data_url:
             return None
@@ -396,6 +407,7 @@ class ImageMessage(Message):
         return BytesIO(base64.b64decode(match.group(1)))
 
     def image_size(self):
+        """Return image dimensions, or None when the payload is unavailable."""
         img_bytes = self.as_bytesio()
         if not img_bytes:
             return None
@@ -406,6 +418,7 @@ class ImageMessage(Message):
             return None
 
     def api_token_fingerprint(self):
+        """Return a stable fingerprint for cached image token estimates."""
         import hashlib
         import json
 
@@ -421,6 +434,7 @@ class ImageMessage(Message):
         return hashlib.sha256(text.encode("utf-8")).hexdigest()
 
     def compute_api_token_count(self, model=None):
+        """Estimate text-structure and visual-token cost for the image message."""
         size = self.image_size()
         text = (
             "The following image has been made available in context for visual analysis:\n"

codex_agent_framework-0.1.74/codex_agent/version.py

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

{codex_agent_framework-0.1.72 → codex_agent_framework-0.1.74/codex_agent_framework.egg-info}/PKG-INFO

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

{codex_agent_framework-0.1.72 → codex_agent_framework-0.1.74}/pyproject.toml

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

codex_agent_framework-0.1.72/codex_agent/version.py

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