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

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

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

{codex_agent_framework-0.1.78 → codex_agent_framework-0.1.79}/codex_agent/builtin_plugins/content/vision.py

@@ -96,6 +96,7 @@ def observe(sources):
 
 
 def normalize_observe_source(source):
+    """Normalize legacy string sources and mapping sources to observe objects."""
     if isinstance(source, str):
         target = "url" if source.startswith(("http://", "https://")) else "path"
         key = "url" if target == "url" else "path"
@@ -106,6 +107,7 @@ def normalize_observe_source(source):
 
 
 def observe_source(source):
+    """Dispatch one normalized observe source to the matching capture helper."""
     item = normalize_observe_source(source)
     if not item:
         return "failed: source must be an object."
@@ -123,6 +125,7 @@ def observe_source(source):
 
 
 def resolve_agent_path(path):
+    """Resolve paths relative to the active agent when one is available."""
     try:
         return get_agent().resolve_path(path)
     except RuntimeError:
@@ -130,6 +133,7 @@ def resolve_agent_path(path):
 
 
 def observe_path(item):
+    """Validate a local image path observe source."""
     path = item.get("path") or item.get("source")
     if not isinstance(path, str) or not path:
         return "failed: path target requires a non-empty 'path'."
@@ -138,6 +142,7 @@ def observe_path(item):
 
 
 def observe_url(item):
+    """Observe a URL as an image, falling back to a page screenshot."""
     url = item.get("url") or item.get("source")
     if not isinstance(url, str) or not url:
         return "failed: url target requires a non-empty 'url'."
@@ -161,6 +166,7 @@ def observe_url(item):
 
 
 def observe_screen(item):
+    """Capture and validate a screenshot of the local screen."""
     output_path = item.get("output_path")
     if output_path:
         output_path = resolve_agent_path(output_path)
@@ -172,6 +178,7 @@ def observe_screen(item):
 
 
 def observe_window(item):
+    """Capture and validate a screenshot of a local desktop window."""
     window_id = item.get("window_id") or item.get("id")
     output_path = item.get("output_path")
     if output_path:
@@ -184,6 +191,7 @@ def observe_window(item):
 
 
 def validated_image(path, image_name=None, original_source=None, url_fallback=False):
+    """Return an ImageMessage or a readable failure string for invalid input."""
     image = ImageMessage(content=path, image_name=image_name, turns_left=3)
     if not image.is_valid():
         label = "URL fallback screenshot" if url_fallback else "image source"
@@ -192,6 +200,7 @@ def validated_image(path, image_name=None, original_source=None, url_fallback=Fa
 
 
 def screenshot_page_url(url, item=None):
+    """Capture a webpage screenshot using caller options or a runtime path."""
     item = item or {}
     path = item.get("output_path")
     if path:

{codex_agent_framework-0.1.78 → codex_agent_framework-0.1.79}/codex_agent/cli/root.py

@@ -22,6 +22,7 @@ ROOT_COMMANDS = {
 
 
 def build_root_parser():
+    """Build the public root CLI parser and command dispatcher options."""
     import argparse
 
     parser = argparse.ArgumentParser(

codex_agent_framework-0.1.79/codex_agent/version.py

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

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

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

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

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

codex_agent_framework-0.1.78/codex_agent/version.py

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