codex-agent-framework 0.1.15__tar.gz → 0.1.16__tar.gz

{codex_agent_framework-0.1.15 → codex_agent_framework-0.1.16}/CHANGELOG.md

@@ -4,6 +4,14 @@ 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.16] - 2026-05-08
+### Fixed
+- Allow agent startup without an OpenAI API key by disabling OpenAI-dependent capabilities such as voice defaults and the built-in memory plugin instead of failing during initialization.
+- Skip automatic memory archiving when the memory plugin is unavailable.
+
+### Tests
+- Add regression coverage for agent initialization with and without an OpenAI API key.
+
 ## [0.1.15] - 2026-05-08
 ### Added
 - Add `AgentRuntime` as the canonical external runtime contract for HTTP server, headless CLI, in-process, and process-backed integrations.

{codex_agent_framework-0.1.15/codex_agent_framework.egg-info → codex_agent_framework-0.1.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.15
+Version: 0.1.16
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT
@@ -393,6 +393,8 @@ agent = Agent(
 
 Configuration is persisted to `agent_config.json` in the runtime directory when updated through agent helpers, slash commands, the HTTP API, or `codex-agent config set`.
 
+If no OpenAI API key is configured through `openai_api_key` or `OPENAI_API_KEY`, the agent can still start, but OpenAI-dependent capabilities such as voice defaults and the built-in memory plugin are disabled.
+
 ## Project layout
 
 ```text
@@ -440,6 +442,7 @@ python -m build
 The distribution includes prompt text files, `codex_agent/get_text/default_gitignore`, and the packaged Linux system dependency installer through package data and `MANIFEST.in`.
 
 ## Recent changes
+- `0.1.16`: tolerate missing OpenAI API keys at startup by disabling OpenAI-dependent voice and memory features, and skip memory archiving when the memory plugin is unavailable.
 - `0.1.15`: add the `AgentRuntime` interface for server/CLI/process adapters, split the CLI into a package with headless runtime commands, add `codex-agent config set` plus `PATCH /config`, and make built-in tools/providers/plugins configurable.
 - `0.1.14`: add HookManager infrastructure, planner/scheduler robustness fixes, documented system dependencies, `codex-agent install-system-deps`, `codex-agent bootstrap`, and improved TUI SSE reconnect/replay handling.
 - `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.

{codex_agent_framework-0.1.15 → codex_agent_framework-0.1.16}/README.md

@@ -344,6 +344,8 @@ agent = Agent(
 
 Configuration is persisted to `agent_config.json` in the runtime directory when updated through agent helpers, slash commands, the HTTP API, or `codex-agent config set`.
 
+If no OpenAI API key is configured through `openai_api_key` or `OPENAI_API_KEY`, the agent can still start, but OpenAI-dependent capabilities such as voice defaults and the built-in memory plugin are disabled.
+
 ## Project layout
 
 ```text
@@ -391,6 +393,7 @@ python -m build
 The distribution includes prompt text files, `codex_agent/get_text/default_gitignore`, and the packaged Linux system dependency installer through package data and `MANIFEST.in`.
 
 ## Recent changes
+- `0.1.16`: tolerate missing OpenAI API keys at startup by disabling OpenAI-dependent voice and memory features, and skip memory archiving when the memory plugin is unavailable.
 - `0.1.15`: add the `AgentRuntime` interface for server/CLI/process adapters, split the CLI into a package with headless runtime commands, add `codex-agent config set` plus `PATCH /config`, and make built-in tools/providers/plugins configurable.
 - `0.1.14`: add HookManager infrastructure, planner/scheduler robustness fixes, documented system dependencies, `codex-agent install-system-deps`, `codex-agent bootstrap`, and improved TUI SSE reconnect/replay handling.
 - `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.

{codex_agent_framework-0.1.15 → codex_agent_framework-0.1.16}/codex_agent/agent.py

@@ -1,4 +1,4 @@
-from .utils import text_content, ensure_runtime_dir, upload_file_to_folder, project_python_env
+from .utils import text_content, ensure_runtime_dir, upload_file_to_folder, project_python_env, runtime_join
 from modict import modict
 import os
 import sys
@@ -17,6 +17,7 @@ from .status import StatusManager
 from .tool import ImageGenerationTool, reset_current_agent, set_current_agent
 from .ai import AIBadRequestError, AIClient
 from .voice import VoiceProcessor
+from .memory import RAGMemory
 from .latex import LaTeXProcessor
 from .event import AgentInterruptRequestedEvent, AgentInterrupted, AgentInterruptedEvent, AudioPlaybackEvent, EventBus
 from pynteract import Shell
@@ -39,6 +40,7 @@ class Agent:
         self.config=self.config_manager.config
         self.config_manager.load()
         self.config_manager.update(kwargs, save=False)
+        self.config_manager.apply_openai_capability_defaults()
         self.events=EventBus()
         self.registry=RegistryManager(self)
         self.tools=self.registry.tools
@@ -65,6 +67,7 @@ class Agent:
         self.registry.init_providers_folder()
         self.command_manager.init_folder()
         self.ai=AIClient(self)
+        self.memory=RAGMemory(file=runtime_join("memory.json"))
         self.voice=VoiceProcessor(self)
         self.latex=LaTeXProcessor()
         self.content_processors=[self.voice]

{codex_agent_framework-0.1.15 → codex_agent_framework-0.1.16}/codex_agent/config.py

@@ -121,6 +121,14 @@ class ConfigManager:
                 self.save()
         return self.config
 
+    def has_openai_api_key(self):
+        return bool(self.config.get("openai_api_key") or os.getenv("OPENAI_API_KEY"))
+
+    def apply_openai_capability_defaults(self):
+        if not self.has_openai_api_key():
+            self.config.voice_enabled = False
+        return self.config
+
     def system_message(self):
         return SystemMessage(content=self.system_prompt())
 

{codex_agent_framework-0.1.15 → codex_agent_framework-0.1.16}/codex_agent/mainloop.py

@@ -265,7 +265,7 @@ class MainLoopManager:
 
                 if self.require_next_step and not self.stop_agentic_loop:
                     continue
-                if self.agent.config.get("auto_archive_memory", True):
+                if self.agent.config.get("auto_archive_memory", True) and self.agent.plugins.get("memory"):
                     self.agent.plugins.memory.archive_last_turn_async()
                 return True
         except AgentInterrupted:

{codex_agent_framework-0.1.15 → codex_agent_framework-0.1.16}/codex_agent/plugin.py

@@ -62,6 +62,8 @@ class PluginsManager:
                 continue
             if not self.agent.config_manager.builtin_enabled("plugins", module_info.name):
                 continue
+            if module_info.name == "memory" and not self.agent.config_manager.has_openai_api_key():
+                continue
             module = importlib.import_module(f"{builtin_plugins.__name__}.{module_info.name}")
             self.add_builtin_from_module(module)
 

{codex_agent_framework-0.1.15 → codex_agent_framework-0.1.16/codex_agent_framework.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.15
+Version: 0.1.16
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT
@@ -393,6 +393,8 @@ agent = Agent(
 
 Configuration is persisted to `agent_config.json` in the runtime directory when updated through agent helpers, slash commands, the HTTP API, or `codex-agent config set`.
 
+If no OpenAI API key is configured through `openai_api_key` or `OPENAI_API_KEY`, the agent can still start, but OpenAI-dependent capabilities such as voice defaults and the built-in memory plugin are disabled.
+
 ## Project layout
 
 ```text
@@ -440,6 +442,7 @@ python -m build
 The distribution includes prompt text files, `codex_agent/get_text/default_gitignore`, and the packaged Linux system dependency installer through package data and `MANIFEST.in`.
 
 ## Recent changes
+- `0.1.16`: tolerate missing OpenAI API keys at startup by disabling OpenAI-dependent voice and memory features, and skip memory archiving when the memory plugin is unavailable.
 - `0.1.15`: add the `AgentRuntime` interface for server/CLI/process adapters, split the CLI into a package with headless runtime commands, add `codex-agent config set` plus `PATCH /config`, and make built-in tools/providers/plugins configurable.
 - `0.1.14`: add HookManager infrastructure, planner/scheduler robustness fixes, documented system dependencies, `codex-agent install-system-deps`, `codex-agent bootstrap`, and improved TUI SSE reconnect/replay handling.
 - `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.

{codex_agent_framework-0.1.15 → codex_agent_framework-0.1.16}/pyproject.toml

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

{codex_agent_framework-0.1.15 → codex_agent_framework-0.1.16}/tests/test_agent.py

@@ -693,6 +693,29 @@ def test_agent_initializes_new_session(isolated_runtime_dir):
     assert agent.shell.silent is True
 
 
+def test_agent_disables_openai_dependent_features_without_api_key(monkeypatch):
+    monkeypatch.delenv("OPENAI_API_KEY", raising=False)
+
+    agent = Agent(session="new", voice_enabled=True)
+
+    assert agent.config.voice_enabled is False
+    assert "memory" not in agent.plugins
+    assert "memory_add" not in agent.tools
+    assert "retrieved_memory" not in agent.providers
+    assert agent.memory.messages == []
+
+
+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", voice_enabled=True)
+
+    assert agent.config.voice_enabled is True
+    assert "memory" in agent.plugins
+    assert "memory_add" in agent.tools
+    assert "retrieved_memory" in agent.providers
+
+
 def test_agent_instantiates_stateful_builtin_plugin_classes():
     import types
     from codex_agent import Plugin, command, provider, tool