codex-agent-framework 0.1.52__tar.gz → 0.1.53__tar.gz

{codex_agent_framework-0.1.52 → codex_agent_framework-0.1.53}/CHANGELOG.md

@@ -4,6 +4,17 @@ 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.53] - 2026-05-16
+### Changed
+- Default new agents to a smaller built-in plugin surface: `files`, `environment`, `memory`, `planner`, `scheduler`, and `context`.
+- Create `~/.codex-agent/agent.config.json` automatically on agent initialization instead of waiting for an explicit config update.
+- Make `web_search` and `image_generation` plugin-first server tools: loading the plugin now controls whether the corresponding Responses API tool is exposed.
+- Remove the redundant `web_search_enabled` and `image_generation_enabled` config flags from the public agent config surface.
+- Update docs and tests to reflect the minimal default plugin set and plugin-driven server tool activation.
+
+### Tests
+- Validate with targeted agent/plugin/image-generation coverage and a package build.
+
 ## [0.1.52] - 2026-05-16
 ### Changed
 - Document current synchronous Bash tool behavior and the planned direction for pollable, cancellable long-running shell jobs with durable logs and clear UI/API status.

{codex_agent_framework-0.1.52/codex_agent_framework.egg-info → codex_agent_framework-0.1.53}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.52
+Version: 0.1.53
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT
@@ -188,7 +188,8 @@ agent = Agent(
 )
 ```
 
-`None` loads all built-ins, `[]` loads none, and an explicit list selects plugin module names.
+By default, the agent starts with a minimal built-in surface: `files`, `environment`, `memory`, `planner`, `scheduler`, and `context`.
+Pass `builtin_plugins=None` to load all built-ins, `[]` to load none, or an explicit list to select plugin module names.
 
 ## Project health
 

{codex_agent_framework-0.1.52 → codex_agent_framework-0.1.53}/README.md

@@ -139,7 +139,8 @@ agent = Agent(
 )
 ```
 
-`None` loads all built-ins, `[]` loads none, and an explicit list selects plugin module names.
+By default, the agent starts with a minimal built-in surface: `files`, `environment`, `memory`, `planner`, `scheduler`, and `context`.
+Pass `builtin_plugins=None` to load all built-ins, `[]` to load none, or an explicit list to select plugin module names.
 
 ## Project health
 

{codex_agent_framework-0.1.52 → codex_agent_framework-0.1.53}/codex_agent/agent.py

@@ -54,6 +54,7 @@ class Agent:
         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.config_manager.save()
         self.events = EventBus()
         self.tools_manager = ToolsManager(self)
         self.providers_manager = ProvidersManager(self)

codex_agent_framework-0.1.53/codex_agent/builtin_plugins/web_search/__init__.py

@@ -0,0 +1,11 @@
+from ...plugin import Plugin
+from ...tool import WebSearchTool
+
+
+class WebSearchPlugin(Plugin):
+    name = "web_search"
+    description = "OpenAI Responses API web search server tool."
+
+    def __init__(self, agent):
+        super().__init__(agent)
+        self.agent.tools_manager.add_server_tool(WebSearchTool())

{codex_agent_framework-0.1.52 → codex_agent_framework-0.1.53}/codex_agent/config.py

@@ -35,14 +35,12 @@ class AgentConfig(modict):
     vision_enabled = True
     max_images = 10
     prune_orphaned_tool_outputs_on_context_build = True
-    web_search_enabled = False
-    image_generation_enabled = False
     image_generation_output_format = "png"
     image_generation_size = None
     image_generation_quality = None
     image_generation_background = None
     image_generation_moderation = None
-    builtin_plugins = None
+    builtin_plugins = ["files", "environment", "memory", "planner", "scheduler", "context"]
     custom_plugins = None
     exclude_tools = modict.factory(list)
     server_url = "http://127.0.0.1:8765"

{codex_agent_framework-0.1.52 → codex_agent_framework-0.1.53}/codex_agent/tool.py

@@ -265,7 +265,7 @@ class ToolsManager:
         self.owners = modict()
 
     def init_server_tools(self):
-        self.add_server_tool(WebSearchTool())
+        return None
 
     def add_from_module(self, module, filter=None, owner=None):
         for name, obj in module.__dict__.items():
@@ -440,4 +440,3 @@ class ToolsManager:
 
     def get_response_tools(self):
         return [tool.to_response_tool() for tool in self.get_tools()]
-

codex_agent_framework-0.1.53/codex_agent/version.py

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

{codex_agent_framework-0.1.52 → codex_agent_framework-0.1.53/codex_agent_framework.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.52
+Version: 0.1.53
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT
@@ -188,7 +188,8 @@ agent = Agent(
 )
 ```
 
-`None` loads all built-ins, `[]` loads none, and an explicit list selects plugin module names.
+By default, the agent starts with a minimal built-in surface: `files`, `environment`, `memory`, `planner`, `scheduler`, and `context`.
+Pass `builtin_plugins=None` to load all built-ins, `[]` to load none, or an explicit list to select plugin module names.
 
 ## Project health
 

{codex_agent_framework-0.1.52 → codex_agent_framework-0.1.53}/codex_agent_framework.egg-info/SOURCES.txt

@@ -77,6 +77,7 @@ codex_agent/builtin_plugins/subagents/requirements.txt
 codex_agent/builtin_plugins/subagents/profiles/explorer.json
 codex_agent/builtin_plugins/tts/__init__.py
 codex_agent/builtin_plugins/tts/requirements.txt
+codex_agent/builtin_plugins/web_search/__init__.py
 codex_agent/cli/__init__.py
 codex_agent/cli/headless.py
 codex_agent/cli/main.py

{codex_agent_framework-0.1.52 → codex_agent_framework-0.1.53}/pyproject.toml

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

{codex_agent_framework-0.1.52 → codex_agent_framework-0.1.53}/tests/test_agent.py

@@ -121,40 +121,32 @@ def test_agent_initializes_new_session(isolated_runtime_dir):
     assert "auto_archive_memory" not in agent.config
     assert agent.plugins.memory.config.auto_archive is False
     assert "token_limit" not in agent.config
-    assert {tool.type for tool in agent.tools_manager.get_server_tools()} == {"web_search", "image_generation"}
-    assert set(agent.plugins) >= {"browser", "desktop", "image_generation", "memory", "planner", "scheduler"}
-    assert "browser_open" in agent.tools
+    assert agent.tools_manager.get_server_tools() == []
+    assert set(agent.plugins) == {"context", "environment", "files", "memory", "planner", "scheduler"}
+    assert "read" in agent.tools
+    assert "write" in agent.tools
+    assert "edit" in agent.tools
+    assert "environment_list_plugins" in agent.tools
+    assert "browser_open" not in agent.tools
     assert "browser_snapshot" not in agent.tools
     assert "browser_screenshot" not in agent.tools
-    assert {method.__name__ for method in agent.plugins.browser.get_tools()} == {
-        "open",
-        "close",
-        "select_tab",
-        "previous_page",
-        "goto",
-        "click",
-        "fill",
-        "select",
-        "press",
-    }
-    assert "desktop_start_session" in agent.tools
-    assert "desktop_stop_session" in agent.tools
-    assert "desktop_run_commands" in agent.tools
+    assert "desktop_start_session" not in agent.tools
+    assert "desktop_stop_session" not in agent.tools
+    assert "desktop_run_commands" not in agent.tools
     assert "desktop" not in agent.tools
-    assert [method.__name__ for method in agent.plugins.desktop.get_tools()] == ["run_commands", "start_session", "stop_session"]
     assert "memory_add" in agent.tools
     assert "planner_create" in agent.tools
     assert "planner_add" in agent.tools
     assert "planner_check" in agent.tools
     assert "scheduler_schedule" in agent.tools
-    assert "subagents_run" in agent.tools
+    assert "context_status" in agent.tools
+    assert "subagents_run" not in agent.tools
     assert "subagents_set_result" not in agent.tools
-    assert "browser_state" in agent.providers
-    assert "desktop_state" in agent.providers
+    assert "browser_state" not in agent.providers
+    assert "desktop_state" not in agent.providers
     assert "retrieved_memory" in agent.providers
     assert "current_todos" in agent.providers
-    assert "python" in agent.plugins
-    assert agent.plugins.python.shell.silent is True
+    assert "python" not in agent.plugins
     assert not hasattr(agent, "shell")
 
 def test_agent_keeps_memory_available_without_openai_api_key(monkeypatch):
@@ -162,7 +154,7 @@ def test_agent_keeps_memory_available_without_openai_api_key(monkeypatch):
 
     agent = Agent(session="new")
 
-    assert agent.plugins.tts.config.enabled is False
+    assert "tts" not in agent.plugins
     assert "memory" in agent.plugins
     assert "memory_add" in agent.tools
     assert "retrieved_memory" in agent.providers

{codex_agent_framework-0.1.52 → codex_agent_framework-0.1.53}/tests/test_agent_image_generation.py

@@ -74,6 +74,7 @@ class FakeImageAI:
 def test_agent_applies_image_generation_tool_config():
     agent = Agent(
         session="new",
+        builtin_plugins=["image_generation"],
         image_generation_size="1024x1024",
         image_generation_quality="low",
         image_generation_background="opaque",
@@ -95,7 +96,7 @@ def test_agent_applies_image_generation_tool_config():
 
 def test_agent_create_image_generates_without_touching_session(tmp_path, monkeypatch):
     monkeypatch.setattr(utils, "RUNTIME_DIR", str(tmp_path))
-    agent = Agent(session="new")
+    agent = Agent(session="new", builtin_plugins=["image_generation"])
     agent.ai = FakeImageAI(agent)
     before = len(agent.session.messages)
 
@@ -119,7 +120,7 @@ def test_agent_create_image_generates_without_touching_session(tmp_path, monkeyp
 
 def test_agent_create_image_accepts_input_images(tmp_path, monkeypatch):
     monkeypatch.setattr(utils, "RUNTIME_DIR", str(tmp_path))
-    agent = Agent(session="new")
+    agent = Agent(session="new", builtin_plugins=["image_generation"])
     agent.ai = FakeImageAI(agent)
     source = b"source image bytes"
 
@@ -133,7 +134,7 @@ def test_agent_create_image_accepts_input_images(tmp_path, monkeypatch):
 
 def test_agent_create_image_allows_llm_parameter_overrides(tmp_path, monkeypatch):
     monkeypatch.setattr(utils, "RUNTIME_DIR", str(tmp_path))
-    agent = Agent(session="new")
+    agent = Agent(session="new", builtin_plugins=["image_generation"])
     agent.ai = FakeImageAI(agent)
 
     agent.plugins.image_generation.create_image(
@@ -152,6 +153,7 @@ def test_agent_create_image_uses_explicit_generation_parameters(tmp_path, monkey
     monkeypatch.setattr(utils, "RUNTIME_DIR", str(tmp_path))
     agent = Agent(
         session="new",
+        builtin_plugins=["image_generation"],
         image_generation_size="should-not-leak",
         image_generation_quality="should-not-leak",
     )
@@ -178,7 +180,7 @@ def test_agent_create_image_uses_explicit_generation_parameters(tmp_path, monkey
 
 def test_agent_persists_generated_images_as_observable_files(tmp_path, monkeypatch):
     monkeypatch.setattr(utils, "RUNTIME_DIR", str(tmp_path))
-    agent = Agent(session="new")
+    agent = Agent(session="new", builtin_plugins=["image_generation"])
     item = {
         "type": "image_generation_call",
         "id": "ig_123",

{codex_agent_framework-0.1.52 → codex_agent_framework-0.1.53}/tests/test_agent_plugins.py

@@ -22,35 +22,29 @@ def test_runtime_state_change_events_exported():
 def test_agent_loads_memory_plugin_with_configured_openai_key(monkeypatch):
     monkeypatch.delenv("OPENAI_API_KEY", raising=False)
 
-    agent = Agent(session="new", openai_api_key="sk-test")
-    agent.plugins.tts.config.enabled = True
+    agent = Agent(session="new", openai_api_key="sk-test", builtin_plugins=["memory"])
 
-    assert agent.plugins.tts.config.enabled is True
     assert "memory" in agent.plugins
     assert "memory_add" in agent.tools
     assert "retrieved_memory" in agent.providers
 
 
-def test_agent_loads_all_available_builtin_plugins_by_default():
+def test_agent_loads_minimal_builtin_plugins_by_default():
     agent = Agent(session="new", openai_api_key="sk-test")
 
-    assert {
-        "bash",
-        "browser",
-        "content",
-        "desktop",
-        "environment",
-        "files",
-        "image_generation",
-        "interface",
-        "memory",
-        "planner",
-        "python",
-        "scheduler",
-        "subagents",
-        "tts",
-    }.issubset(agent.plugins.keys())
-    assert agent.plugins.tts.process_content_stream in agent.get_stream_processors("content")
+    assert set(agent.plugins.keys()) == {"context", "environment", "files", "memory", "planner", "scheduler"}
+    assert "read" in agent.tools
+    assert "write" in agent.tools
+    assert "edit" in agent.tools
+    assert "environment_list_plugins" in agent.tools
+    assert "memory_add" in agent.tools
+    assert "planner_create" in agent.tools
+    assert "scheduler_schedule" in agent.tools
+    assert "context_status" in agent.tools
+    assert "bash" not in agent.tools
+    assert "python" not in agent.tools
+    assert "view" not in agent.tools
+    assert "browser_open" not in agent.tools
 
 
 def test_agent_config_can_exclude_tools_by_canonical_plugin_name():

{codex_agent_framework-0.1.52 → codex_agent_framework-0.1.53}/tests/test_agent_providers_config.py

@@ -66,6 +66,18 @@ def test_agent_config_exposes_stable_system_prompt_infos():
     assert "Python" in agent.config.platform
 
 
+def test_agent_config_file_is_created_on_agent_init(tmp_path, monkeypatch):
+    monkeypatch.setattr(utils, "RUNTIME_DIR", str(tmp_path))
+
+    agent = Agent(session="new")
+
+    config_file = tmp_path / "agent.config.json"
+    assert config_file.is_file()
+    saved = json.loads(config_file.read_text())
+    assert saved["name"] == agent.config.name
+    assert saved["model"] == agent.config.model
+
+
 def test_agent_config_helpers_persist_in_runtime_dir(tmp_path, monkeypatch):
     monkeypatch.setattr(utils, "RUNTIME_DIR", str(tmp_path))
 

{codex_agent_framework-0.1.52 → codex_agent_framework-0.1.53}/tests/test_agent_response.py

@@ -93,12 +93,13 @@ def test_agent_get_response_emits_events_and_persists_assistant_message():
     assert agent.ai.params["reasoning"] == agent.config.reasoning
     assert agent.ai.params["parallel_tool_calls"] is True
     assert agent.ai.params["prompt_cache_key"] == agent.current_session_id
-    assert any(tool["type"] == "custom" and tool["name"] == "python" for tool in agent.ai.params["tools"])
-    assert any(tool["type"] == "custom" and tool["name"] == "bash" for tool in agent.ai.params["tools"])
     assert any(tool["type"] == "function" and tool["name"] == "read" for tool in agent.ai.params["tools"])
-    assert any(tool["type"] == "function" and tool["name"] == "show" for tool in agent.ai.params["tools"])
-    assert {"type": "web_search"} in agent.ai.params["tools"]
-    assert {"type": "image_generation", "output_format": "png"} in agent.ai.params["tools"]
+    assert any(tool["type"] == "function" and tool["name"] == "edit" for tool in agent.ai.params["tools"])
+    assert not any(tool["type"] == "custom" and tool["name"] == "python" for tool in agent.ai.params["tools"])
+    assert not any(tool["type"] == "custom" and tool["name"] == "bash" for tool in agent.ai.params["tools"])
+    assert not any(tool["type"] == "function" and tool["name"] == "show" for tool in agent.ai.params["tools"])
+    assert {"type": "web_search"} not in agent.ai.params["tools"]
+    assert {"type": "image_generation", "output_format": "png"} not in agent.ai.params["tools"]
 
 
 def test_agent_get_response_does_not_write_api_success_session_backup(tmp_path, monkeypatch):
@@ -209,7 +210,10 @@ def test_agent_get_response_auto_compacts_before_backend_call(monkeypatch):
 
 
 def test_agent_combines_local_and_server_tools_for_response():
-    agent = Agent(session="new")
+    agent = Agent(
+        session="new",
+        builtin_plugins=["files", "python", "bash", "content"],
+    )
     agent.ai = FakeAI(agent)
     agent.tools_manager.add_server_tool(WebSearchTool())
     agent.tools_manager.add_server_tool(ImageGenerationTool())
@@ -227,7 +231,7 @@ def test_agent_combines_local_and_server_tools_for_response():
 
 
 def test_agent_emits_server_tool_call_event_from_output_items():
-    agent = Agent(session="new")
+    agent = Agent(session="new", builtin_plugins=["files", "web_search"])
     item = {
         "type": "web_search_call",
         "id": "ws_123",
@@ -263,7 +267,7 @@ def test_agent_caches_status_from_completed_response():
 
 
 def test_agent_persists_server_tool_output_items_as_messages():
-    agent = Agent(session="new")
+    agent = Agent(session="new", builtin_plugins=["web_search"])
     item = {
         "type": "web_search_call",
         "id": "ws_123",
@@ -355,11 +359,10 @@ def test_agent_keeps_tool_outputs_contiguous_and_wrappers_pending():
     assert [wrapper.turns_left for wrapper in agent.mainloop_manager.pending[-2:]] == [3, 3]
 
 
-def test_agent_can_enable_builtin_server_tools_from_config():
+def test_agent_can_enable_builtin_server_tools_from_plugins():
     agent = Agent(
         session="new",
-        web_search_enabled=True,
-        image_generation_enabled=True,
+        builtin_plugins=["web_search", "image_generation"],
     )
 
     assert {tool.type for tool in agent.tools_manager.get_server_tools()} == {"web_search", "image_generation"}

codex_agent_framework-0.1.52/codex_agent/version.py

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