codex-agent-framework 0.1.11__tar.gz → 0.1.13__tar.gz

{codex_agent_framework-0.1.11 → codex_agent_framework-0.1.13}/CHANGELOG.md

@@ -3,6 +3,28 @@
 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.13] - 2026-05-07
+### Changed
+- Reorganize built-in tools into a `codex_agent.builtin_tools` package with separate modules for file, shell, vision, system, and server-tool responsibilities.
+- Keep the public `codex_agent.builtin_tools` import surface compatible by re-exporting the existing built-in tools and helpers from the package initializer.
+
+### Tests
+- Update built-in tool regression coverage for the package layout and validate the full suite at 376 passing tests.
+
+## [0.1.12] - 2026-05-05
+### Added
+- Add a persistent Playwright/Chromium browser controller with tools to open/close the browser, select tabs, navigate, click, fill, select options, press keys, inspect action snapshots, and capture screenshots.
+- Add `browser_goto(url)` to navigate the active tab without opening or switching tabs.
+- Add screenshot-backed visual fallback for pages where DOM snapshots are insufficient, including PDF viewers and image-heavy pages.
+
+### Changed
+- Replace the Selenium/Gecko rendered extraction path with Playwright-managed Chromium.
+- Update web extraction dependencies and documentation to install Chromium with Playwright.
+
+### Tests
+- Add browser controller and rendered extraction regression coverage.
+
 ## [0.1.11] - 2026-05-05
 ### Added
 - Add a separate `view` tool for folders, URLs, rich document extraction, and Python object inspection.

{codex_agent_framework-0.1.11/codex_agent_framework.egg-info → codex_agent_framework-0.1.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.11
+Version: 0.1.13
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT
@@ -20,23 +20,24 @@ Requires-Dist: beautifulsoup4
 Requires-Dist: codex-backend-sdk
 Requires-Dist: fastapi
 Requires-Dist: filetype
-Requires-Dist: get-gecko-driver
 Requires-Dist: modict
+Requires-Dist: mss
 Requires-Dist: numpy
 Requires-Dist: odfpy
 Requires-Dist: openai
 Requires-Dist: openpyxl
 Requires-Dist: pathspec
 Requires-Dist: pillow
+Requires-Dist: playwright
 Requires-Dist: pydub
 Requires-Dist: pypdf
 Requires-Dist: pynteract
+Requires-Dist: pywinctl
 Requires-Dist: python-docx
 Requires-Dist: PyYAML
 Requires-Dist: regex
 Requires-Dist: requests
 Requires-Dist: rich
-Requires-Dist: selenium
 Requires-Dist: textual
 Requires-Dist: tiktoken
 Requires-Dist: trafilatura
@@ -73,7 +74,7 @@ It provides a reusable `Agent` abstraction with persistent sessions, local tools
 - Python 3.10 or newer.
 - A working model backend configuration compatible with `codex-backend-sdk` / OpenAI usage.
 - GTK 3 plus Ayatana AppIndicator or AppIndicator bindings are needed for the tray controller on Linux.
-- Firefox / GeckoDriver may be needed for Selenium-backed web extraction paths.
+- Playwright's managed Chromium browser is used for rendered web extraction when static fetching is insufficient. Install it with `python -m playwright install chromium` if needed.
 
 ## Installation
 
@@ -362,9 +363,11 @@ Configuration is persisted to `agent_config.json` in the runtime directory when
 ```text
 codex_agent/                    Python package
 codex_agent/agent.py            Agent, AgentConfig, AgentSession
-codex_agent/builtin_tools.py    Built-in local tools
+codex_agent/plugin.py           Stateful plugin base class
+codex_agent/builtin_tools/     Built-in local tools package
 codex_agent/builtin_commands.py Built-in slash commands
 codex_agent/builtin_providers.py Built-in context providers
+codex_agent/builtin_plugins/    Auto-loaded stateful plugin packages
 codex_agent/prompts/            Packaged prompt templates
 codex_agent/get_text/           Document extraction helpers
 tests/                          Test suite
@@ -385,7 +388,7 @@ The tests isolate `AGENT_RUNTIME_DIR` automatically, so they should not create o
 Current baseline:
 
 ```text
-293 passed
+376 passed
 ```
 
 ## Packaging
@@ -400,6 +403,8 @@ python -m build
 The distribution includes prompt text files and `codex_agent/get_text/default_gitignore` through package data and `MANIFEST.in`.
 
 ## Recent changes
+- `0.1.13`: reorganize built-in tools into a `codex_agent.builtin_tools` package, keeping the public import surface compatible while separating file, shell, vision, system, and server-tool modules.
+- `0.1.12`: add a persistent Playwright/Chromium browser controller with tab navigation, DOM/action snapshots, screenshots, form/click/key tools, and `browser_goto(url)` for active-tab navigation.
 - `0.1.11`: split strict line-numbered UTF-8 `read` from unnumbered extracted `view`, preserve blank lines in read snippets, and show persistent+temporary message counts in the TUI status bar.
 - `0.1.10`: persist only backend compaction summaries, drop bulky compacted conversation payloads, and refresh context status after compaction.
 - `0.1.9`: maintenance packaging release after validating the local execution environment and deploy workflow.

{codex_agent_framework-0.1.11 → codex_agent_framework-0.1.13}/README.md

@@ -25,7 +25,7 @@ It provides a reusable `Agent` abstraction with persistent sessions, local tools
 - Python 3.10 or newer.
 - A working model backend configuration compatible with `codex-backend-sdk` / OpenAI usage.
 - GTK 3 plus Ayatana AppIndicator or AppIndicator bindings are needed for the tray controller on Linux.
-- Firefox / GeckoDriver may be needed for Selenium-backed web extraction paths.
+- Playwright's managed Chromium browser is used for rendered web extraction when static fetching is insufficient. Install it with `python -m playwright install chromium` if needed.
 
 ## Installation
 
@@ -314,9 +314,11 @@ Configuration is persisted to `agent_config.json` in the runtime directory when
 ```text
 codex_agent/                    Python package
 codex_agent/agent.py            Agent, AgentConfig, AgentSession
-codex_agent/builtin_tools.py    Built-in local tools
+codex_agent/plugin.py           Stateful plugin base class
+codex_agent/builtin_tools/     Built-in local tools package
 codex_agent/builtin_commands.py Built-in slash commands
 codex_agent/builtin_providers.py Built-in context providers
+codex_agent/builtin_plugins/    Auto-loaded stateful plugin packages
 codex_agent/prompts/            Packaged prompt templates
 codex_agent/get_text/           Document extraction helpers
 tests/                          Test suite
@@ -337,7 +339,7 @@ The tests isolate `AGENT_RUNTIME_DIR` automatically, so they should not create o
 Current baseline:
 
 ```text
-293 passed
+376 passed
 ```
 
 ## Packaging
@@ -352,6 +354,8 @@ python -m build
 The distribution includes prompt text files and `codex_agent/get_text/default_gitignore` through package data and `MANIFEST.in`.
 
 ## Recent changes
+- `0.1.13`: reorganize built-in tools into a `codex_agent.builtin_tools` package, keeping the public import surface compatible while separating file, shell, vision, system, and server-tool modules.
+- `0.1.12`: add a persistent Playwright/Chromium browser controller with tab navigation, DOM/action snapshots, screenshots, form/click/key tools, and `browser_goto(url)` for active-tab navigation.
 - `0.1.11`: split strict line-numbered UTF-8 `read` from unnumbered extracted `view`, preserve blank lines in read snippets, and show persistent+temporary message counts in the TUI status bar.
 - `0.1.10`: persist only backend compaction summaries, drop bulky compacted conversation payloads, and refresh context status after compaction.
 - `0.1.9`: maintenance packaging release after validating the local execution environment and deploy workflow.

codex_agent_framework-0.1.13/codex_agent/__init__.py

@@ -0,0 +1,136 @@
+from .agent import Agent
+from .client import AgentClient
+from .config import AgentConfig, ConfigManager, DEFAULT_SYSTEM_PROMPT
+from .context import ContextManager
+from .event import (
+    AgentInterruptRequestedEvent,
+    AgentInterrupted,
+    AgentInterruptedEvent,
+    AgentTurnEndEvent,
+    AgentTurnErrorEvent,
+    AgentTurnStartEvent,
+    AssistantStepEndEvent,
+    AssistantStepStartEvent,
+    AssistantTurnEndEvent,
+    AssistantTurnStartEvent,
+    AudioPlaybackEvent,
+    CompactionCompletedEvent,
+    CompactionRequestedEvent,
+    Event,
+    EventBus,
+    MessageAddedEvent,
+    MessageSubmittedEvent,
+    ResponseContentDeltaEvent,
+    ResponseDoneEvent,
+    ResponseMessageDeltaEvent,
+    ResponseOutputItemEvent,
+    ResponseReasoningDeltaEvent,
+    ResponseStartEvent,
+    ResponseToolCallsDeltaEvent,
+    ServerToolCallEvent,
+    SessionDeletedEvent,
+    SessionLoadedEvent,
+    ToolCallDoneEvent,
+    ToolCallStartEvent,
+)
+from .message import (
+    AssistantMessage,
+    CompactionMessage,
+    DeveloperMessage,
+    Message,
+    MessageChunk,
+    ProviderMessage,
+    ServerToolResponseMessage,
+    SystemMessage,
+    ToolResultMessage,
+    ToolResultWrapper,
+    UserMessage,
+)
+from .image import ImageMessage
+from .mainloop import MainLoopManager
+from .memory import MemoryEntry, RAGMemory, RAGMemoryConfig
+from .plugin import Plugin, PluginsManager
+from .registry import RegistryManager
+from .command import AgentCommand, AgentFuture, CommandManager, command
+from .provider import provider
+from .runtime import RuntimeManager
+from .sessions import AgentSession, SessionsManager
+from .status import StatusManager
+from .tool import ImageGenerationTool, ServerTool, Tool, WebSearchTool, get_agent, get_current_call_id, tool
+from .worker import SummarizerWorker, TurnSummaryWorker, Worker
+
+__all__ = [
+    "Agent",
+    "AgentClient",
+    "AgentConfig",
+    "ConfigManager",
+    "DEFAULT_SYSTEM_PROMPT",
+    "ContextManager",
+    "AgentInterruptRequestedEvent",
+    "AgentInterrupted",
+    "AgentInterruptedEvent",
+    "AgentTurnEndEvent",
+    "AgentTurnErrorEvent",
+    "AgentTurnStartEvent",
+    "AssistantStepEndEvent",
+    "AssistantStepStartEvent",
+    "AssistantTurnEndEvent",
+    "AssistantTurnStartEvent",
+    "AudioPlaybackEvent",
+    "CompactionCompletedEvent",
+    "CompactionRequestedEvent",
+    "Event",
+    "EventBus",
+    "MessageAddedEvent",
+    "MessageSubmittedEvent",
+    "ResponseContentDeltaEvent",
+    "ResponseDoneEvent",
+    "ResponseMessageDeltaEvent",
+    "ResponseOutputItemEvent",
+    "ResponseReasoningDeltaEvent",
+    "ResponseStartEvent",
+    "ResponseToolCallsDeltaEvent",
+    "ServerToolCallEvent",
+    "SessionDeletedEvent",
+    "SessionLoadedEvent",
+    "ToolCallDoneEvent",
+    "ToolCallStartEvent",
+    "AssistantMessage",
+    "CompactionMessage",
+    "DeveloperMessage",
+    "Message",
+    "MessageChunk",
+    "ProviderMessage",
+    "ServerToolResponseMessage",
+    "SystemMessage",
+    "ToolResultMessage",
+    "ToolResultWrapper",
+    "UserMessage",
+    "ImageMessage",
+    "MainLoopManager",
+    "MemoryEntry",
+    "RAGMemory",
+    "RAGMemoryConfig",
+    "Plugin",
+    "PluginsManager",
+    "RegistryManager",
+    "AgentCommand",
+    "AgentFuture",
+    "CommandManager",
+    "command",
+    "provider",
+    "RuntimeManager",
+    "AgentSession",
+    "SessionsManager",
+    "StatusManager",
+    "ImageGenerationTool",
+    "ServerTool",
+    "Tool",
+    "WebSearchTool",
+    "get_agent",
+    "get_current_call_id",
+    "tool",
+    "SummarizerWorker",
+    "TurnSummaryWorker",
+    "Worker",
+]

{codex_agent_framework-0.1.11 → codex_agent_framework-0.1.13}/codex_agent/__main__.py

@@ -26,8 +26,7 @@ def default_agent():
 
 
 def configure_server_url(agent, host, port):
-    if hasattr(agent, "update_config"):
-        agent.update_config(server_url=f"http://{host}:{port}", save=False)
+    agent.config_manager.update(server_url=f"http://{host}:{port}", save=False)
     return agent