codex-agent-framework 0.1.34__tar.gz → 0.1.36__tar.gz

{codex_agent_framework-0.1.34 → codex_agent_framework-0.1.36}/CHANGELOG.md

@@ -4,6 +4,22 @@ 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.36] - 2026-05-16
+### Changed
+- Clean up residual `Agent` facade style around response dispatch and transcription helpers.
+- Deduplicate plugin name resolution for add, remove, unload, and reload flows.
+
+### Tests
+- Validate with targeted Agent response/audio/tool coverage, plugin coverage, and the 553-test offline CI suite.
+
+## [0.1.35] - 2026-05-16
+### Changed
+- Normalize formatting in the `Agent` facade around initialization, message helpers, image helpers, and tool registration.
+- Wrap long `Agent` facade lines for imports, interrupt events, working-directory resolution, and upload notifications.
+
+### Tests
+- Validate with targeted Agent/session/tool/environment/response coverage and the 553-test offline CI suite.
+
 ## [0.1.34] - 2026-05-16
 ### Changed
 - Share the broken-session backup path used by session repair and truncation flows.

{codex_agent_framework-0.1.34/codex_agent_framework.egg-info → codex_agent_framework-0.1.36}/PKG-INFO

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

{codex_agent_framework-0.1.34 → codex_agent_framework-0.1.36}/codex_agent/agent.py

@@ -1,7 +1,20 @@
-from .utils import text_content, ensure_runtime_dir, upload_file_to_folder, project_python_env, runtime_join, root_join
+from .utils import (
+    ensure_runtime_dir,
+    project_python_env,
+    root_join,
+    runtime_join,
+    text_content,
+    upload_file_to_folder,
+)
 import os
 from modict import modict
-from .message import DeveloperMessage, ServerToolResponseMessage, ToolResultMessage, UserMessage, message_from_data
+from .message import (
+    DeveloperMessage,
+    ServerToolResponseMessage,
+    ToolResultMessage,
+    UserMessage,
+    message_from_data,
+)
 from .image import ImageMessage
 from .command import CommandManager
 from .config import ConfigManager
@@ -22,7 +35,7 @@ from threading import Event as ThreadEvent
 
 class Agent:
 
-    def __init__(self,session="latest",**kwargs):
+    def __init__(self, session="latest", **kwargs):
         """Initializes the Agent instance with configuration, events, tools, and message history.
 
         Args:
@@ -36,33 +49,33 @@ class Agent:
         explicit_root_dir = kwargs.pop("root_dir", None)
         explicit_cwd = kwargs.pop("cwd", None)
         self.init_execution_environment()
-        self.config_manager=ConfigManager(self)
+        self.config_manager = ConfigManager(self)
         self.config_manager.load()
         self.config_manager.update(kwargs, save=False)
         self.init_working_directories(root_dir=explicit_root_dir or launch_cwd, cwd=explicit_cwd)
         self.config_manager.apply_openai_capability_defaults()
-        self.events=EventBus()
-        self.tools_manager=ToolsManager(self)
-        self.providers_manager=ProvidersManager(self)
-        self.command_manager=CommandManager(self)
-        self.context_manager=ContextManager(self)
-        self.plugins_manager=PluginsManager(self)
-        self.sessions_manager=SessionsManager(self)
-        self.runtime=RuntimeManager(self)
-        self.scheduler=AgentScheduler(self)
-        self.hooks=HookManager(self)
-        self.stream_manager=StreamManager(self)
-        self.mainloop_manager=MainLoopManager(self)
-        self._interrupt_requested=ThreadEvent()
-        self.current_session_id=None
-        self.session=None
-        self.status_manager=StatusManager(self)
-        self.context_namespace=self.create_context_namespace()
+        self.events = EventBus()
+        self.tools_manager = ToolsManager(self)
+        self.providers_manager = ProvidersManager(self)
+        self.command_manager = CommandManager(self)
+        self.context_manager = ContextManager(self)
+        self.plugins_manager = PluginsManager(self)
+        self.sessions_manager = SessionsManager(self)
+        self.runtime = RuntimeManager(self)
+        self.scheduler = AgentScheduler(self)
+        self.hooks = HookManager(self)
+        self.stream_manager = StreamManager(self)
+        self.mainloop_manager = MainLoopManager(self)
+        self._interrupt_requested = ThreadEvent()
+        self.current_session_id = None
+        self.session = None
+        self.status_manager = StatusManager(self)
+        self.context_namespace = self.create_context_namespace()
         self.init_workfolder()
         self.sessions_manager.init_folder()
         self.command_manager.init_folder()
         self.plugins_manager.init_folder()
-        self.ai=AIClient(self)
+        self.ai = AIClient(self)
         self.command_manager.init_builtin()
         self.plugins_manager.init_builtin()
         self.plugins_manager.init_runtime()
@@ -192,7 +205,12 @@ class Agent:
                 except Exception as exc:
                     abort_error = exc
             self.emit(AssistantInterruptedEvent, reason=reason)
-        self.emit(AssistantInterruptRequestedEvent, reason=reason, interrupted=True, error=str(abort_error) if abort_error else "")
+        self.emit(
+            AssistantInterruptRequestedEvent,
+            reason=reason,
+            interrupted=True,
+            error=str(abort_error) if abort_error else "",
+        )
         return True
 
     def clear_interrupt(self):
@@ -233,7 +251,9 @@ class Agent:
         return self.sync_working_cwd_from_process(save_session=save_session)
 
     def init_working_directories(self, root_dir=None, cwd=None):
-        root_dir = self.normalize_directory(root_dir or getattr(self, "process_launch_cwd", None) or self.config.root_dir)
+        root_dir = self.normalize_directory(
+            root_dir or getattr(self, "process_launch_cwd", None) or self.config.root_dir
+        )
         cwd = self.normalize_directory(cwd or root_dir)
         self.config.root_dir = root_dir
         self.set_process_cwd(cwd)
@@ -242,7 +262,11 @@ class Agent:
     def apply_session_working_directories(self):
         if not self.session:
             return self.config.cwd
-        root_dir = getattr(self.session, "root_dir", None) or self.config.root_dir or getattr(self, "process_launch_cwd", None)
+        root_dir = (
+            getattr(self.session, "root_dir", None)
+            or self.config.root_dir
+            or getattr(self, "process_launch_cwd", None)
+        )
         cwd = getattr(self.session, "cwd", None) or root_dir
         self.config.root_dir = self.normalize_directory(root_dir)
         self.session.root_dir = self.config.root_dir
@@ -261,7 +285,7 @@ class Agent:
 
     def init_workfolder(self):
         if not os.path.isdir(self.config.workfolder):
-            os.makedirs(self.config.workfolder,exist_ok=True)
+            os.makedirs(self.config.workfolder, exist_ok=True)
 
     def init_execution_environment(self):
         os.environ.update(project_python_env())
@@ -298,7 +322,7 @@ class Agent:
             max_compacted_turns=max_compacted_turns,
         )
 
-    def add_message(self,msg,pending=False):
+    def add_message(self, msg, pending=False):
         """Queue a message for the next pending flush, except tool results."""
         if isinstance(msg, ToolResultMessage):
             return self.sessions_manager.append_message(msg)
@@ -306,7 +330,7 @@ class Agent:
             return self.sessions_manager.append_message(msg)
         return self.mainloop_manager.add_pending_message(msg)
 
-    def new_message(self,pending=False,**kwargs):
+    def new_message(self, pending=False, **kwargs):
         """Helper to create and add a message based on provided keyword arguments.
 
         Args:
@@ -316,21 +340,31 @@ class Agent:
         Returns:
             The created message object.
         """
-        msg=message_from_data(kwargs)
-        return self.add_message(msg,pending=pending)
+        msg = message_from_data(kwargs)
+        return self.add_message(msg, pending=pending)
 
-    def add_image(self,source,pending=False,**kwargs):
+    def add_image(self, source, pending=False, **kwargs):
         if source:
-            img=ImageMessage(
+            img = ImageMessage(
                 content=source,
-                **kwargs
+                **kwargs,
             )
             if not img.is_valid():
                 raise ValueError(f"Invalid or inaccessible image source: {source!r}")
-            self.add_message(img,pending=pending)
+            self.add_message(img, pending=pending)
             return img
 
-    def add_tool(self,func=None,name=None,description=None,parameters=None,required=None,tool_type=None,format=None,owner=None):
+    def add_tool(
+        self,
+        func=None,
+        name=None,
+        description=None,
+        parameters=None,
+        required=None,
+        tool_type=None,
+        format=None,
+        owner=None,
+    ):
         return self.tools_manager.add(
             func=func,
             name=name,
@@ -409,7 +443,7 @@ class Agent:
         finally:
             reset_current_agent(agent_context)
 
-    def get_messages(self,filter=None):
+    def get_messages(self, filter=None):
         return self.sessions_manager.messages(filter=filter)
 
     def get_status(self):
@@ -433,11 +467,11 @@ class Agent:
             )
             messages = self.context_manager.get_context()
 
-        message=self.ai.run(
+        message = self.ai.run(
             messages=messages,
             tools=self.tools_manager.get_response_tools(),
             prompt_cache_key=self.current_session_id,
-            **self.config.extract('model','reasoning','text','parallel_tool_calls')
+            **self.config.extract("model", "reasoning", "text", "parallel_tool_calls"),
         )
         self.sessions_manager.append_message(message)
         for item in message.output_items:
@@ -475,11 +509,10 @@ class Agent:
         if source is None:
             raise ValueError("An audio source must be provided")
 
-        # Transcribe audio to text
         transcribed_text = self.ai.audio_to_text(
             source=source,
             language=language,
-            **kwargs
+            **kwargs,
         )
 
         return transcribed_text
@@ -498,7 +531,11 @@ class Agent:
         dest_path = upload_file_to_folder(source, self.config.workfolder, name=name)
         dest_filename = os.path.basename(dest_path)
 
-        self.add_message(DeveloperMessage(content=f"File '{dest_filename}' has been uploaded to the workfolder at: {dest_path}"))
+        self.add_message(
+            DeveloperMessage(
+                content=f"File '{dest_filename}' has been uploaded to the workfolder at: {dest_path}"
+            )
+        )
 
         return dest_path
 

{codex_agent_framework-0.1.34 → codex_agent_framework-0.1.36}/codex_agent/plugin.py

@@ -461,8 +461,13 @@ class PluginsManager:
             raise RuntimeError(f"Runtime plugin {name_or_path!r} requires an OpenAI API key")
         return self.add_from_module(module)
 
+    def _plugin_name(self, plugin_or_name):
+        if isinstance(plugin_or_name, str):
+            return plugin_or_name
+        return getattr(plugin_or_name, "name", None) or type(plugin_or_name).__name__
+
     def add_plugin(self, plugin):
-        plugin_name = getattr(plugin, "name", None) or type(plugin).__name__
+        plugin_name = self._plugin_name(plugin)
         if plugin_name in self.plugins:
             self.unload_plugin(plugin_name)
         self.plugins[plugin_name] = plugin
@@ -472,7 +477,7 @@ class PluginsManager:
         return plugin
 
     def remove_plugin_members(self, plugin_or_name):
-        plugin_name = plugin_or_name if isinstance(plugin_or_name, str) else getattr(plugin_or_name, "name", None) or type(plugin_or_name).__name__
+        plugin_name = self._plugin_name(plugin_or_name)
         return modict(
             tools=self.agent.tools_manager.remove_by_owner(plugin_name),
             providers=self.agent.providers_manager.remove_by_owner(plugin_name),
@@ -483,7 +488,7 @@ class PluginsManager:
         )
 
     def unload_plugin(self, plugin_or_name, timeout=None):
-        plugin_name = plugin_or_name if isinstance(plugin_or_name, str) else getattr(plugin_or_name, "name", None) or type(plugin_or_name).__name__
+        plugin_name = self._plugin_name(plugin_or_name)
         plugin = self.plugins.get(plugin_name)
         if plugin is None:
             return None
@@ -494,7 +499,7 @@ class PluginsManager:
         return modict(plugin=plugin, removed=removed)
 
     def reload_plugin(self, plugin_or_name, timeout=None):
-        plugin_name = plugin_or_name if isinstance(plugin_or_name, str) else getattr(plugin_or_name, "name", None) or type(plugin_or_name).__name__
+        plugin_name = self._plugin_name(plugin_or_name)
         plugin = self.plugins.get(plugin_name)
         if plugin is None:
             raise KeyError(f"Unknown plugin: {plugin_name}")

codex_agent_framework-0.1.36/codex_agent/version.py

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

{codex_agent_framework-0.1.34 → codex_agent_framework-0.1.36/codex_agent_framework.egg-info}/PKG-INFO

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

{codex_agent_framework-0.1.34 → codex_agent_framework-0.1.36}/pyproject.toml

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

codex_agent_framework-0.1.34/codex_agent/version.py

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