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

{codex_agent_framework-0.1.73/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.73
+Version: 0.1.74
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT

{codex_agent_framework-0.1.73 → 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.73 → 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.73
+Version: 0.1.74
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT

{codex_agent_framework-0.1.73 → 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.73"
+version = "0.1.74"
 description = "A lightweight event-driven Codex agent runtime."
 readme = "README.md"
 requires-python = ">=3.11"

codex_agent_framework-0.1.73/codex_agent/version.py

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