codex-agent-framework 0.1.32__tar.gz → 0.1.33__tar.gz

{codex_agent_framework-0.1.32 → codex_agent_framework-0.1.33}/CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to this project will be documented in this file.
 
 This project loosely follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and uses semantic versioning where practical.
 
+## [0.1.33] - 2026-05-16
+### Changed
+- Simplify plugin decorated-method accessors by sharing the handler pair construction path.
+- Deduplicate queued Agent state-command dispatch for scheduler and hook registration operations.
+- Tighten Agent tool-facing docstrings for audio transcription and workfolder uploads without changing runtime behavior.
+
+### Tests
+- Validate the cleanup pass with targeted plugin, Agent, scheduler, hook, tool, audio, and image tests plus the 553-test offline CI suite.
+
 ## [0.1.32] - 2026-05-16
 ### Changed
 - Split the former `tests/test_agent.py` monolith into focused agent test modules for audio hooks, commands, context, desktop, environment, image generation, observe, plugins, providers/config, realtime, response handling, sessions, subagents, tools, and turns.

{codex_agent_framework-0.1.32/codex_agent_framework.egg-info → codex_agent_framework-0.1.33}/PKG-INFO

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

{codex_agent_framework-0.1.32 → codex_agent_framework-0.1.33}/codex_agent/agent.py

@@ -137,6 +137,11 @@ class Agent:
     def submit(self, command, **payload):
         return self.mainloop_manager.submit(command, **payload)
 
+    def _run_or_queue_state_command(self, command, action, **payload):
+        if hasattr(self, "mainloop_manager") and self.mainloop_manager.should_queue_state_command():
+            return self.submit(command, **payload).wait().result
+        return action()
+
     def start_turn(self):
         return self.mainloop_manager.start_turn()
 
@@ -157,19 +162,25 @@ class Agent:
         return self.scheduler.list(include_done=include_done)
 
     def schedule_wakeup(self, **kwargs):
-        if self.mainloop_manager.should_queue_state_command():
-            return self.submit("schedule_wakeup", **kwargs).wait().result
-        return self.scheduler.schedule(**kwargs)
+        return self._run_or_queue_state_command(
+            "schedule_wakeup",
+            lambda: self.scheduler.schedule(**kwargs),
+            **kwargs,
+        )
 
     def cancel_wakeup(self, job_id):
-        if self.mainloop_manager.should_queue_state_command():
-            return self.submit("cancel_wakeup", job_id=job_id).wait().result
-        return self.scheduler.cancel(job_id)
+        return self._run_or_queue_state_command(
+            "cancel_wakeup",
+            lambda: self.scheduler.cancel(job_id),
+            job_id=job_id,
+        )
 
     def delete_wakeup(self, job_id):
-        if self.mainloop_manager.should_queue_state_command():
-            return self.submit("delete_wakeup", job_id=job_id).wait().result
-        return self.scheduler.delete(job_id)
+        return self._run_or_queue_state_command(
+            "delete_wakeup",
+            lambda: self.scheduler.delete(job_id),
+            job_id=job_id,
+        )
 
     def interrupt(self, reason="user"):
         abort_error = None
@@ -373,10 +384,13 @@ class Agent:
                 return self.add_hook(key, f, owner=owner)
             return decorator
 
-        if hasattr(self, "mainloop_manager") and self.mainloop_manager.should_queue_state_command():
-            return self.submit("add_hook", key=key, func=func, owner=owner).wait().result
-
-        return self.hooks.add(key, func, owner=owner)
+        return self._run_or_queue_state_command(
+            "add_hook",
+            lambda: self.hooks.add(key, func, owner=owner),
+            key=key,
+            func=func,
+            owner=owner,
+        )
 
     def has_hook(self, key):
         return self.hooks.has(key)
@@ -434,34 +448,29 @@ class Agent:
     def listen(self, source, language=None, **kwargs):
         """
         description: |
-            Listen to audio input and transcribe it to text, then process it as a user message.
-            Accepts either audio data (BytesIO/bytes) or a file path.
+            Transcribe audio from bytes, BytesIO, or a file path, then add the text as a user message.
         parameters:
             source:
-                description: Audio data as file_path string, BytesIO object or bytes
+                description: Audio source as a path string, BytesIO object, or bytes.
             language:
-                description: ISO-639-1 language code (e.g., "en", "fr")
+                description: Optional ISO-639-1 language code, such as "en" or "fr".
             kwargs:
-                description: Additional parameters for the transcription (model, prompt, temperature, etc.)
+                description: Extra transcription options forwarded to the backend.
         """
 
         transcribed_text = self.transcribe(source, language, **kwargs)
-
-        # Add transcribed text as a user message
         self.add_message(UserMessage(content=transcribed_text))
 
     def transcribe(self, source, language=None, **kwargs):
         """
-        description: |
-            Transcribe audio to text.
-            Accepts either audio data (BytesIO/bytes) or a file path.
+        description: Transcribe audio from bytes, BytesIO, or a file path.
         parameters:
             source:
-                description: Audio data as file_path string, BytesIO object or bytes
+                description: Audio source as a path string, BytesIO object, or bytes.
             language:
-                description: ISO-639-1 language code (e.g., "en", "fr")
+                description: Optional ISO-639-1 language code, such as "en" or "fr".
             kwargs:
-                description: Additional parameters for the transcription (model, prompt, temperature, etc.)
+                description: Extra transcription options forwarded to the backend.
         """
         if source is None:
             raise ValueError("An audio source must be provided")
@@ -477,17 +486,14 @@ class Agent:
 
     def upload_file(self, source, name=None):
         """
-        description: |
-            Upload a file to the agent's workfolder and inform the agent via system message.
-            Supports file paths (str), BytesIO objects, or raw bytes.
+        description: Upload a file into the workfolder and notify the agent.
         parameters:
             source:
-                description: File source - can be a file path (str), BytesIO object, or bytes
+                description: File path, BytesIO object, or bytes to upload.
             name:
-                description: Optional name for the file. Required when source is bytes without a name attribute.
-                             Can include extension to override detection.
+                description: Optional destination name; required for unnamed bytes and may include an extension.
         returns:
-            description: Absolute path to the uploaded file
+            description: Absolute path to the uploaded file.
         """
         dest_path = upload_file_to_folder(source, self.config.workfolder, name=name)
         dest_filename = os.path.basename(dest_path)

{codex_agent_framework-0.1.32 → codex_agent_framework-0.1.33}/codex_agent/plugin.py

@@ -101,24 +101,15 @@ class Plugin:
 
     def get_event_handlers(self):
         """Return ``(event, method)`` pairs declared by this plugin."""
-        return [
-            (event_handler_options(method), method)
-            for method in self._decorated_methods(event_handler_options)
-        ]
+        return self._decorated_method_pairs(event_handler_options)
 
     def get_hook_handlers(self):
         """Return ``(hook_name, method)`` pairs declared by this plugin."""
-        return [
-            (hook_handler_options(method), method)
-            for method in self._decorated_methods(hook_handler_options)
-        ]
+        return self._decorated_method_pairs(hook_handler_options)
 
     def get_stream_processors(self):
         """Return ``(chunk_key, method)`` pairs declared by this plugin."""
-        return [
-            (stream_processor_options(method), method)
-            for method in self._decorated_methods(stream_processor_options)
-        ]
+        return self._decorated_method_pairs(stream_processor_options)
 
     def get_system_prompt_sections(self):
         """Return system prompt sections contributed by this plugin."""
@@ -190,6 +181,9 @@ class Plugin:
                 methods.append(member)
         return methods
 
+    def _decorated_method_pairs(self, options_for):
+        return [(options_for(method), method) for method in self._decorated_methods(options_for)]
+
 
 class PluginsManager:
     def __init__(self, agent):

codex_agent_framework-0.1.33/codex_agent/version.py

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

{codex_agent_framework-0.1.32 → codex_agent_framework-0.1.33/codex_agent_framework.egg-info}/PKG-INFO

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

{codex_agent_framework-0.1.32 → codex_agent_framework-0.1.33}/pyproject.toml

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

codex_agent_framework-0.1.32/codex_agent/version.py

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