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

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

@@ -4,6 +4,18 @@ 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.17] - 2026-05-08
+### Changed
+- Reorganize the Textual TUI into the `codex_agent.tui` package, splitting chat UI code from TUI lifecycle helpers.
+- Reorganize the FastAPI bridge into the `codex_agent.server` package, separating server core/service logic from app and route creation.
+- Remove the obsolete `Message.lasting` field now that message visibility is controlled by `turns_left`, reducing serialized payload noise.
+
+### Removed
+- Remove the old flat `codex_agent.chat` and `codex_agent.tui` modules in favor of the new package layout.
+
+### Tests
+- Validate the full suite at 442 passing tests.
+
 ## [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.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.16
+Version: 0.1.17
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT
@@ -442,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.17`: reorganize the TUI and FastAPI server into dedicated `codex_agent.tui` and `codex_agent.server` packages, remove obsolete message payload fields, and clean unused imports.
 - `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.

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

@@ -393,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.17`: reorganize the TUI and FastAPI server into dedicated `codex_agent.tui` and `codex_agent.server` packages, remove obsolete message payload fields, and clean unused imports.
 - `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.

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

@@ -1,5 +1,4 @@
 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
 from .message import DeveloperMessage, ServerToolResponseMessage, SystemMessage, ToolResultMessage, UserMessage, message_from_data
@@ -432,5 +431,5 @@ class Agent:
         import os
         if os.environ.get('AGENT_ROOT_PATH') is None:
             set_root_path(file=__file__)
-        from .chat import Chat
+        from .tui import Chat
         Chat(self).run()

{codex_agent_framework-0.1.16 → codex_agent_framework-0.1.17}/codex_agent/cli/main.py

@@ -2,7 +2,7 @@ from pathlib import Path
 import subprocess
 
 from codex_agent import Agent
-from codex_agent.chat import Chat
+from codex_agent.tui import Chat
 from codex_agent.server import create_app
 from codex_agent.service import install_user_service, uninstall_user_service
 from codex_agent.tray import run_tray

{codex_agent_framework-0.1.16 → codex_agent_framework-0.1.17}/codex_agent/message.py

@@ -32,7 +32,6 @@ class Message(modict):
     id = modict.factory(lambda: short_id())
     session_id = None
     timestamp = modict.factory(lambda: timestamp())
-    lasting = 0
     turns_left = -1
     embedding = None
     estimated_token_count = modict.factory(dict)

codex_agent_framework-0.1.17/codex_agent/server/__init__.py

@@ -0,0 +1,29 @@
+"""FastAPI server package for codex-agent."""
+
+from .app import app, create_app, main
+from .core import (
+    AgentServer,
+    SERVER_CONFIG_FILE,
+    SERVER_EVENTS_FILE,
+    create_server_agent,
+    load_server_config,
+    remembered_server_session,
+    save_server_config,
+    server_config_file,
+    server_events_file,
+)
+
+__all__ = [
+    "AgentServer",
+    "SERVER_CONFIG_FILE",
+    "SERVER_EVENTS_FILE",
+    "app",
+    "create_app",
+    "create_server_agent",
+    "load_server_config",
+    "main",
+    "remembered_server_session",
+    "save_server_config",
+    "server_config_file",
+    "server_events_file",
+]

codex_agent_framework-0.1.17/codex_agent/server/app.py

@@ -0,0 +1,201 @@
+import json
+
+from ..agent import Agent
+from ..agent_runtime import InProcessAgentRuntime, ProcessAgentRuntime
+from .core import AgentServer, create_server_agent, remembered_server_session
+
+def create_app(agent: Agent | None = None, start_agent=False, process_agent=False, **agent_kwargs):
+    from contextlib import asynccontextmanager
+
+    from fastapi import FastAPI, HTTPException, Request
+    from fastapi.responses import StreamingResponse
+    from pydantic import BaseModel
+
+    if process_agent and agent is None:
+        if "session" not in agent_kwargs:
+            agent_kwargs["session"] = remembered_server_session() or "latest"
+        runtime = ProcessAgentRuntime(agent_kwargs=agent_kwargs)
+    else:
+        runtime = InProcessAgentRuntime(agent or create_server_agent(**agent_kwargs))
+    service = AgentServer(runtime=runtime)
+    if start_agent:
+        service.start()
+
+    @asynccontextmanager
+    async def lifespan(app):
+        try:
+            yield
+        finally:
+            service.stop(timeout=1.0)
+
+    app = FastAPI(title="Codex Agent", version="0.1.17", lifespan=lifespan)
+    app.state.agent_service = service
+
+    class TurnRequest(BaseModel):
+        prompt: str
+
+    class InterruptRequest(BaseModel):
+        reason: str = "api"
+
+    class ConfigUpdateRequest(BaseModel):
+        values: dict = {}
+        save: bool = True
+
+    class WakeupRequest(BaseModel):
+        prompt: str
+        run_at: str | None = None
+        delay_seconds: float | None = None
+        interval_seconds: float | None = None
+        title: str = ""
+
+    class RestartRequest(BaseModel):
+        prompt: str | None = None
+        title: str = "post-restart wakeup"
+
+    def jsonable(value):
+        return json.loads(json.dumps(value, ensure_ascii=False, default=str))
+
+    def busy_guard(call):
+        try:
+            return call()
+        except RuntimeError as exc:
+            raise HTTPException(status_code=409, detail=str(exc)) from exc
+        except ValueError as exc:
+            raise HTTPException(status_code=400, detail=str(exc)) from exc
+
+    @app.get("/health")
+    def health():
+        return {"ok": True, "busy": service.busy, "session_id": service.current_session_id}
+
+    @app.get("/status")
+    def status():
+        return jsonable(service.status())
+
+    @app.get("/config")
+    def config():
+        return jsonable(service.config())
+
+    @app.patch("/config")
+    def update_config(request: ConfigUpdateRequest):
+        return jsonable(busy_guard(lambda: service.update_config(request.values, save=request.save)))
+
+    @app.get("/session")
+    def session():
+        return jsonable(service.session())
+
+    @app.get("/sessions")
+    def sessions():
+        return jsonable(service.sessions())
+
+    @app.post("/sessions/new")
+    def start_new_session():
+        return jsonable(busy_guard(service.start_new_session))
+
+    @app.post("/sessions/{session_id}/load")
+    def load_session(session_id: str):
+        return jsonable(busy_guard(lambda: service.load_session(session_id)))
+
+    @app.delete("/sessions/{session_id}")
+    def delete_session(session_id: str):
+        return jsonable(busy_guard(lambda: service.delete_session(session_id)))
+
+    @app.post("/sessions/navigate/{direction}")
+    def navigate_session(direction: str):
+        return jsonable(busy_guard(lambda: service.navigate_session(direction)))
+
+    @app.get("/messages")
+    def messages():
+        return jsonable(service.messages())
+
+    @app.get("/memory")
+    def memory():
+        return jsonable(service.memory())
+
+    @app.get("/tools")
+    def tools():
+        return jsonable(service.tools())
+
+    @app.get("/tui")
+    def tui():
+        return jsonable(service.tui())
+
+    @app.post("/tui/open")
+    def open_tui(request: Request):
+        base_url = str(request.base_url).rstrip("/")
+        return jsonable(busy_guard(lambda: service.open_tui(base_url=base_url)))
+
+    @app.post("/tui/close")
+    def close_tui():
+        return jsonable(service.close_tui())
+
+    @app.post("/restart")
+    @app.post("/restart/")
+    def restart(request: RestartRequest):
+        return jsonable(busy_guard(lambda: service.restart(**request.model_dump())))
+
+    @app.get("/wakeups")
+    def wakeups(include_done: bool = True):
+        return jsonable(service.wakeups(include_done=include_done))
+
+    @app.post("/wakeups", status_code=201)
+    def schedule_wakeup(request: WakeupRequest):
+        return jsonable(busy_guard(lambda: service.schedule_wakeup(**request.model_dump())))
+
+    @app.post("/wakeups/{job_id}/cancel")
+    def cancel_wakeup(job_id: str):
+        return jsonable(busy_guard(lambda: service.cancel_wakeup(job_id)))
+
+    @app.delete("/wakeups/{job_id}")
+    def delete_wakeup(job_id: str):
+        return jsonable(busy_guard(lambda: service.delete_wakeup(job_id)))
+
+    @app.post("/turns", status_code=202)
+    def turns(request: TurnRequest):
+        result = busy_guard(lambda: service.submit_prompt(request.prompt))
+        return {"accepted": True, **jsonable(result)}
+
+    @app.post("/interrupt")
+    def interrupt(request: InterruptRequest):
+        return jsonable(service.interrupt(request.reason))
+
+    @app.get("/events")
+    def events(limit: int | None = None, after_sequence: int | None = None, client_pid: int | None = None):
+        try:
+            subscription = service.subscribe(after_sequence=after_sequence, client_pid=client_pid)
+        except RuntimeError as exc:
+            raise HTTPException(status_code=409, detail=str(exc)) from exc
+
+        def stream():
+            count = 0
+            for payload in subscription:
+                lines = []
+                if payload.get("id"):
+                    lines.append(f"id: {payload.id}")
+                lines.append(f"event: {payload.get('type', 'message')}")
+                lines.append(f"data: {json.dumps(payload, ensure_ascii=False, default=str)}")
+                yield "\n".join(lines) + "\n\n"
+                count += 1
+                if limit is not None and count >= limit:
+                    break
+        return StreamingResponse(stream(), media_type="text/event-stream")
+
+    @app.get("/events/replay")
+    def replay_events(before_sequence: int | None = None, session_id: str | None = None):
+        return jsonable(service.replay_events(before_sequence=before_sequence, session_id=session_id))
+
+    return app
+
+
+app = None
+
+
+def main():
+    import uvicorn
+
+    global app
+    app = create_app(start_agent=True, process_agent=True)
+    uvicorn.run(app, host="127.0.0.1", port=8765, timeout_graceful_shutdown=2)
+
+
+if __name__ == "__main__":
+    main()

codex_agent_framework-0.1.16/codex_agent/server.py → codex_agent_framework-0.1.17/codex_agent/server/core.py

@@ -8,14 +8,14 @@ from collections import deque
 
 from modict import modict
 
-from .agent import Agent
-from .agent_runtime import AgentRuntime, InProcessAgentRuntime, ProcessAgentRuntime
-from .event import Event
-from .message import UserMessage
-from .sessions import AgentSession
-from .service import pop_restart_wakeup, restart_server_service, write_restart_wakeup
-from .utils import ensure_runtime_dir, runtime_join
-from .tui import clear_tui, current_tui, open_tui_terminal, terminate_tui
+from ..agent import Agent
+from ..agent_runtime import AgentRuntime
+from ..event import Event
+from ..message import UserMessage
+from ..sessions import AgentSession
+from ..service import pop_restart_wakeup, restart_server_service, write_restart_wakeup
+from ..utils import ensure_runtime_dir, runtime_join
+from ..tui import clear_tui, current_tui, open_tui_terminal, terminate_tui
 
 
 
@@ -266,6 +266,16 @@ class AgentServer:
         for subscriber, state in list(self.subscribers.items()):
             if not state.thread.is_alive():
                 self.subscribers.pop(subscriber, None)
+        return len(self.subscribers)
+
+    def subscriber_count(self):
+        if not self.subscriber_lock.acquire(timeout=0.05):
+            return len(self.subscribers)
+        try:
+            self.prune_subscribers()
+            return len(self.subscribers)
+        finally:
+            self.subscriber_lock.release()
 
     def close_subscribers(self, reason="server shutdown"):
         self.shutdown_requested.set()
@@ -277,7 +287,9 @@ class AgentServer:
     def subscribe(self, after_sequence=None, client_pid=None):
         after_sequence = int(after_sequence) if after_sequence is not None else None
         client_pid = int(client_pid) if client_pid is not None else None
-        with self.subscriber_lock:
+        if not self.subscriber_lock.acquire(timeout=1.0):
+            raise RuntimeError("event subscription manager is busy")
+        try:
             self.shutdown_requested.clear()
             self.prune_subscribers()
             tui = current_tui()
@@ -297,6 +309,8 @@ class AgentServer:
                     and int(event.get("sequence") or 0) <= replay_before_sequence
                     and self.event_belongs_to_session(event, session_id)
                 ]
+        finally:
+            self.subscriber_lock.release()
         def stream():
             try:
                 yield modict(
@@ -321,18 +335,20 @@ class AgentServer:
                     if payload.get("type") == "server_shutdown":
                         break
             finally:
-                with self.subscriber_lock:
+                if not self.subscriber_lock.acquire(timeout=1.0):
+                    return
+                try:
                     self.subscribers.pop(subscriber, None)
+                finally:
+                    self.subscriber_lock.release()
         return stream()
 
     def status(self):
-        with self.subscriber_lock:
-            self.prune_subscribers()
         status = self.runtime.get_status()
         status.update(
             busy=self.busy,
             current_turn_id=self.current_turn_id,
-            subscribers=len(self.subscribers),
+            subscribers=self.subscriber_count(),
             event_backlog=len(self.events),
         )
         self.persist_current_session()
@@ -483,198 +499,3 @@ class AgentServer:
             raise RuntimeError("agent is busy")
 
 
-def create_app(agent: Agent | None = None, start_agent=False, process_agent=False, **agent_kwargs):
-    from contextlib import asynccontextmanager
-
-    from fastapi import FastAPI, HTTPException, Request
-    from fastapi.responses import StreamingResponse
-    from pydantic import BaseModel
-
-    if process_agent and agent is None:
-        if "session" not in agent_kwargs:
-            agent_kwargs["session"] = remembered_server_session() or "latest"
-        runtime = ProcessAgentRuntime(agent_kwargs=agent_kwargs)
-    else:
-        runtime = InProcessAgentRuntime(agent or create_server_agent(**agent_kwargs))
-    service = AgentServer(runtime=runtime)
-    if start_agent:
-        service.start()
-
-    @asynccontextmanager
-    async def lifespan(app):
-        try:
-            yield
-        finally:
-            service.stop(timeout=1.0)
-
-    app = FastAPI(title="Codex Agent", version="0.1.0", lifespan=lifespan)
-    app.state.agent_service = service
-
-    class TurnRequest(BaseModel):
-        prompt: str
-
-    class InterruptRequest(BaseModel):
-        reason: str = "api"
-
-    class ConfigUpdateRequest(BaseModel):
-        values: dict = {}
-        save: bool = True
-
-    class WakeupRequest(BaseModel):
-        prompt: str
-        run_at: str | None = None
-        delay_seconds: float | None = None
-        interval_seconds: float | None = None
-        title: str = ""
-
-    class RestartRequest(BaseModel):
-        prompt: str | None = None
-        title: str = "post-restart wakeup"
-
-    def jsonable(value):
-        return json.loads(json.dumps(value, ensure_ascii=False, default=str))
-
-    def busy_guard(call):
-        try:
-            return call()
-        except RuntimeError as exc:
-            raise HTTPException(status_code=409, detail=str(exc)) from exc
-        except ValueError as exc:
-            raise HTTPException(status_code=400, detail=str(exc)) from exc
-
-    @app.get("/health")
-    def health():
-        return {"ok": True, "busy": service.busy, "session_id": service.current_session_id}
-
-    @app.get("/status")
-    def status():
-        return jsonable(service.status())
-
-    @app.get("/config")
-    def config():
-        return jsonable(service.config())
-
-    @app.patch("/config")
-    def update_config(request: ConfigUpdateRequest):
-        return jsonable(busy_guard(lambda: service.update_config(request.values, save=request.save)))
-
-    @app.get("/session")
-    def session():
-        return jsonable(service.session())
-
-    @app.get("/sessions")
-    def sessions():
-        return jsonable(service.sessions())
-
-    @app.post("/sessions/new")
-    def start_new_session():
-        return jsonable(busy_guard(service.start_new_session))
-
-    @app.post("/sessions/{session_id}/load")
-    def load_session(session_id: str):
-        return jsonable(busy_guard(lambda: service.load_session(session_id)))
-
-    @app.delete("/sessions/{session_id}")
-    def delete_session(session_id: str):
-        return jsonable(busy_guard(lambda: service.delete_session(session_id)))
-
-    @app.post("/sessions/navigate/{direction}")
-    def navigate_session(direction: str):
-        return jsonable(busy_guard(lambda: service.navigate_session(direction)))
-
-    @app.get("/messages")
-    def messages():
-        return jsonable(service.messages())
-
-    @app.get("/memory")
-    def memory():
-        return jsonable(service.memory())
-
-    @app.get("/tools")
-    def tools():
-        return jsonable(service.tools())
-
-    @app.get("/tui")
-    def tui():
-        return jsonable(service.tui())
-
-    @app.post("/tui/open")
-    def open_tui(request: Request):
-        base_url = str(request.base_url).rstrip("/")
-        return jsonable(busy_guard(lambda: service.open_tui(base_url=base_url)))
-
-    @app.post("/tui/close")
-    def close_tui():
-        return jsonable(service.close_tui())
-
-    @app.post("/restart")
-    @app.post("/restart/")
-    def restart(request: RestartRequest):
-        return jsonable(busy_guard(lambda: service.restart(**request.model_dump())))
-
-    @app.get("/wakeups")
-    def wakeups(include_done: bool = True):
-        return jsonable(service.wakeups(include_done=include_done))
-
-    @app.post("/wakeups", status_code=201)
-    def schedule_wakeup(request: WakeupRequest):
-        return jsonable(busy_guard(lambda: service.schedule_wakeup(**request.model_dump())))
-
-    @app.post("/wakeups/{job_id}/cancel")
-    def cancel_wakeup(job_id: str):
-        return jsonable(busy_guard(lambda: service.cancel_wakeup(job_id)))
-
-    @app.delete("/wakeups/{job_id}")
-    def delete_wakeup(job_id: str):
-        return jsonable(busy_guard(lambda: service.delete_wakeup(job_id)))
-
-    @app.post("/turns", status_code=202)
-    def turns(request: TurnRequest):
-        result = busy_guard(lambda: service.submit_prompt(request.prompt))
-        return {"accepted": True, **jsonable(result)}
-
-    @app.post("/interrupt")
-    def interrupt(request: InterruptRequest):
-        return jsonable(service.interrupt(request.reason))
-
-    @app.get("/events")
-    def events(limit: int | None = None, after_sequence: int | None = None, client_pid: int | None = None):
-        try:
-            subscription = service.subscribe(after_sequence=after_sequence, client_pid=client_pid)
-        except RuntimeError as exc:
-            raise HTTPException(status_code=409, detail=str(exc)) from exc
-
-        def stream():
-            count = 0
-            for payload in subscription:
-                lines = []
-                if payload.get("id"):
-                    lines.append(f"id: {payload.id}")
-                lines.append(f"event: {payload.get('type', 'message')}")
-                lines.append(f"data: {json.dumps(payload, ensure_ascii=False, default=str)}")
-                yield "\n".join(lines) + "\n\n"
-                count += 1
-                if limit is not None and count >= limit:
-                    break
-        return StreamingResponse(stream(), media_type="text/event-stream")
-
-    @app.get("/events/replay")
-    def replay_events(before_sequence: int | None = None, session_id: str | None = None):
-        return jsonable(service.replay_events(before_sequence=before_sequence, session_id=session_id))
-
-    return app
-
-
-app = None
-
-
-def main():
-    import uvicorn
-
-    global app
-    app = create_app(start_agent=True, process_agent=True)
-    uvicorn.run(app, host="127.0.0.1", port=8765, timeout_graceful_shutdown=2)
-
-
-if __name__ == "__main__":
-    main()

codex_agent_framework-0.1.17/codex_agent/tui/__init__.py

@@ -0,0 +1,25 @@
+"""Textual TUI client package."""
+
+from .chat import Chat
+from .lifecycle import (
+    clear_tui,
+    current_tui,
+    install_tui_cleanup_handlers,
+    open_tui_terminal,
+    register_tui,
+    terminal_command_candidates,
+    terminal_process_kwargs,
+    terminate_tui,
+)
+
+__all__ = [
+    "Chat",
+    "clear_tui",
+    "current_tui",
+    "install_tui_cleanup_handlers",
+    "open_tui_terminal",
+    "register_tui",
+    "terminal_command_candidates",
+    "terminal_process_kwargs",
+    "terminate_tui",
+]

{codex_agent_framework-0.1.16/codex_agent → codex_agent_framework-0.1.17/codex_agent/tui}/chat.py

@@ -3,8 +3,8 @@ import sys
 
 from rich.text import Text
 
-from .client import AgentClient
-from .event import (
+from ..client import AgentClient
+from ..event import (
     AgentTurnStartEvent,
     AgentTurnEndEvent,
     AgentTurnErrorEvent,
@@ -18,7 +18,7 @@ from .event import (
     ServerToolCallEvent,
     ToolCallStartEvent,
 )
-from .tui import clear_tui, install_tui_cleanup_handlers, register_tui
+from .lifecycle import clear_tui, install_tui_cleanup_handlers, register_tui
 
 
 class Chat:

codex_agent_framework-0.1.16/codex_agent/tui.py → codex_agent_framework-0.1.17/codex_agent/tui/lifecycle.py

@@ -8,7 +8,7 @@ import threading
 
 from modict import modict
 
-from .utils import runtime_join, timestamp
+from ..utils import runtime_join, timestamp
 
 
 def tui_file():

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.16
+Version: 0.1.17
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT
@@ -442,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.17`: reorganize the TUI and FastAPI server into dedicated `codex_agent.tui` and `codex_agent.server` packages, remove obsolete message payload fields, and clean unused imports.
 - `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.

{codex_agent_framework-0.1.16 → codex_agent_framework-0.1.17}/codex_agent_framework.egg-info/SOURCES.txt

@@ -11,7 +11,6 @@ codex_agent/agent_runtime.py
 codex_agent/ai.py
 codex_agent/builtin_commands.py
 codex_agent/builtin_providers.py
-codex_agent/chat.py
 codex_agent/client.py
 codex_agent/command.py
 codex_agent/config.py
@@ -28,14 +27,12 @@ codex_agent/provider.py
 codex_agent/registry.py
 codex_agent/runtime.py
 codex_agent/scheduler.py
-codex_agent/server.py
 codex_agent/service.py
 codex_agent/sessions.py
 codex_agent/status.py
 codex_agent/stream_utils.py
 codex_agent/tool.py
 codex_agent/tray.py
-codex_agent/tui.py
 codex_agent/utils.py
 codex_agent/voice.py
 codex_agent/worker.py
@@ -67,6 +64,12 @@ codex_agent/get_text/simpler_get_text.py
 codex_agent/prompts/image_generation_system_prompt.txt
 codex_agent/prompts/system_prompt.txt
 codex_agent/scripts/install-system-dependencies.sh
+codex_agent/server/__init__.py
+codex_agent/server/app.py
+codex_agent/server/core.py
+codex_agent/tui/__init__.py
+codex_agent/tui/chat.py
+codex_agent/tui/lifecycle.py
 codex_agent_framework.egg-info/PKG-INFO
 codex_agent_framework.egg-info/SOURCES.txt
 codex_agent_framework.egg-info/dependency_links.txt

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

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

{codex_agent_framework-0.1.16 → codex_agent_framework-0.1.17}/tests/test_chat.py

@@ -1,7 +1,7 @@
 from modict import modict
 
 from codex_agent import Agent
-from codex_agent.chat import Chat
+from codex_agent.tui.chat import Chat
 from codex_agent.message import CompactionMessage, DeveloperMessage, UserMessage
 
 
@@ -308,7 +308,7 @@ def test_chat_replays_startup_events_after_subscription(monkeypatch):
 
     chat.app = App()
     chat.attach()
-    monkeypatch.setattr("codex_agent.chat.register_tui", lambda base_url: None)
+    monkeypatch.setattr("codex_agent.tui.chat.register_tui", lambda base_url: None)
     monkeypatch.setattr(
         chat.client,
         "replay_events",

{codex_agent_framework-0.1.16 → codex_agent_framework-0.1.17}/tests/test_server.py

@@ -49,7 +49,7 @@ def test_agent_server_keeps_slow_subscribers_attached():
 def test_agent_server_refuses_second_event_subscriber(monkeypatch):
     agent = Agent(session="new", voice_enabled=False)
     service = AgentServer(InProcessAgentRuntime(agent))
-    monkeypatch.setattr("codex_agent.server.current_tui", lambda: modict(pid=1234))
+    monkeypatch.setattr("codex_agent.server.core.current_tui", lambda: modict(pid=1234))
     stream = service.subscribe()
 
     next(stream)
@@ -318,9 +318,9 @@ def test_agent_server_open_tui_returns_registered_client(monkeypatch):
     service = AgentServer(InProcessAgentRuntime(agent))
     tui = modict(pid=4321, base_url="http://agent.local")
 
-    monkeypatch.setattr("codex_agent.server.current_tui", lambda: tui)
+    monkeypatch.setattr("codex_agent.server.core.current_tui", lambda: tui)
     monkeypatch.setattr(
-        "codex_agent.server.open_tui_terminal",
+        "codex_agent.server.core.open_tui_terminal",
         lambda **kwargs: (_ for _ in ()).throw(AssertionError("terminal should not be opened")),
     )
 
@@ -337,8 +337,8 @@ def test_agent_server_open_tui_launches_terminal_when_no_client(monkeypatch):
     class Process:
         pid = 9876
 
-    monkeypatch.setattr("codex_agent.server.current_tui", lambda: None)
-    monkeypatch.setattr("codex_agent.server.open_tui_terminal", lambda base_url: Process())
+    monkeypatch.setattr("codex_agent.server.core.current_tui", lambda: None)
+    monkeypatch.setattr("codex_agent.server.core.open_tui_terminal", lambda base_url: Process())
 
     result = service.open_tui(base_url="http://agent.local")
 
@@ -352,9 +352,9 @@ def test_agent_server_close_tui_terminates_registered_pid(monkeypatch):
     service = AgentServer(InProcessAgentRuntime(agent))
     calls = []
 
-    monkeypatch.setattr("codex_agent.server.current_tui", lambda: modict(pid=2468))
-    monkeypatch.setattr("codex_agent.server.terminate_tui", lambda pid: calls.append(("terminate", pid)))
-    monkeypatch.setattr("codex_agent.server.clear_tui", lambda pid=None: calls.append(("clear", pid)))
+    monkeypatch.setattr("codex_agent.server.core.current_tui", lambda: modict(pid=2468))
+    monkeypatch.setattr("codex_agent.server.core.terminate_tui", lambda pid: calls.append(("terminate", pid)))
+    monkeypatch.setattr("codex_agent.server.core.clear_tui", lambda pid=None: calls.append(("clear", pid)))
 
     result = service.close_tui()
 
@@ -417,7 +417,7 @@ def test_agent_server_refuses_second_subscriber_when_tui_is_registered(monkeypat
     agent = Agent(session="new", voice_enabled=False)
     service = AgentServer(InProcessAgentRuntime(agent))
     service.subscribers[queue.Queue()] = modict(thread=threading.current_thread())
-    monkeypatch.setattr("codex_agent.server.current_tui", lambda: modict(pid=1234))
+    monkeypatch.setattr("codex_agent.server.core.current_tui", lambda: modict(pid=1234))
 
     try:
         try:
@@ -434,7 +434,7 @@ def test_agent_server_replaces_stale_subscriber_for_same_tui_pid(monkeypatch):
     agent = Agent(session="new", voice_enabled=False)
     service = AgentServer(InProcessAgentRuntime(agent))
     service.subscribers[queue.Queue()] = modict(thread=threading.current_thread(), client_pid=1234)
-    monkeypatch.setattr("codex_agent.server.current_tui", lambda: modict(pid=1234))
+    monkeypatch.setattr("codex_agent.server.core.current_tui", lambda: modict(pid=1234))
 
     stream = service.subscribe(client_pid=1234)
     try:
@@ -449,7 +449,7 @@ def test_agent_server_replaces_stale_subscriber_when_no_tui_is_registered(monkey
     agent = Agent(session="new", voice_enabled=False)
     service = AgentServer(InProcessAgentRuntime(agent))
     service.subscribers[queue.Queue()] = modict(thread=threading.current_thread())
-    monkeypatch.setattr("codex_agent.server.current_tui", lambda: None)
+    monkeypatch.setattr("codex_agent.server.core.current_tui", lambda: None)
 
     stream = service.subscribe()
     try:
@@ -465,7 +465,7 @@ def test_create_app_refuses_second_sse_client(monkeypatch):
     client = TestClient(app)
     service = app.state.agent_service
     service.subscribers[queue.Queue()] = modict(thread=threading.current_thread())
-    monkeypatch.setattr("codex_agent.server.current_tui", lambda: modict(pid=1234))
+    monkeypatch.setattr("codex_agent.server.core.current_tui", lambda: modict(pid=1234))
 
     try:
         second = client.get("/events?limit=1")
@@ -531,7 +531,7 @@ def test_agent_server_consumes_restart_wakeup(monkeypatch):
     agent = Agent(session="new", voice_enabled=False)
     service = AgentServer(InProcessAgentRuntime(agent))
     monkeypatch.setattr(
-        "codex_agent.server.pop_restart_wakeup",
+        "codex_agent.server.core.pop_restart_wakeup",
         lambda: {"prompt": "continue work", "title": "resume"},
     )
     calls = []
@@ -550,15 +550,15 @@ def test_agent_server_restart_persists_wakeup_and_restarts_service(monkeypatch):
     agent = Agent(session="new", voice_enabled=False)
     service = AgentServer(InProcessAgentRuntime(agent))
     calls = []
-    monkeypatch.setattr("codex_agent.server.write_restart_wakeup", lambda **kwargs: calls.append(("wakeup", kwargs)))
-    monkeypatch.setattr("codex_agent.server.time.sleep", lambda delay: calls.append(("sleep", delay)))
-    monkeypatch.setattr("codex_agent.server.restart_server_service", lambda: calls.append(("restart",)))
+    monkeypatch.setattr("codex_agent.server.core.write_restart_wakeup", lambda **kwargs: calls.append(("wakeup", kwargs)))
+    monkeypatch.setattr("codex_agent.server.core.time.sleep", lambda delay: calls.append(("sleep", delay)))
+    monkeypatch.setattr("codex_agent.server.core.restart_server_service", lambda: calls.append(("restart",)))
     class ImmediateThread:
         def __init__(self, target, **kwargs):
             self.target = target
         def start(self):
             self.target()
-    monkeypatch.setattr("codex_agent.server.threading.Thread", ImmediateThread)
+    monkeypatch.setattr("codex_agent.server.core.threading.Thread", ImmediateThread)
     result = service.restart(prompt="resume please", title="resume", delay_seconds=0)
     assert result.restarting is True
     assert result.wakeup_persisted is True
@@ -584,15 +584,15 @@ def test_agent_server_restart_waits_for_turn_end_when_busy(monkeypatch):
     service = AgentServer(InProcessAgentRuntime(agent))
     agent.mainloop_manager.futures["running"] = modict(command="turn", status="running")
     calls = []
-    monkeypatch.setattr("codex_agent.server.write_restart_wakeup", lambda **kwargs: calls.append(("wakeup", kwargs)))
-    monkeypatch.setattr("codex_agent.server.time.sleep", lambda delay: calls.append(("sleep", delay)))
-    monkeypatch.setattr("codex_agent.server.restart_server_service", lambda: calls.append(("restart",)))
+    monkeypatch.setattr("codex_agent.server.core.write_restart_wakeup", lambda **kwargs: calls.append(("wakeup", kwargs)))
+    monkeypatch.setattr("codex_agent.server.core.time.sleep", lambda delay: calls.append(("sleep", delay)))
+    monkeypatch.setattr("codex_agent.server.core.restart_server_service", lambda: calls.append(("restart",)))
     class ImmediateThread:
         def __init__(self, target, **kwargs):
             self.target = target
         def start(self):
             self.target()
-    monkeypatch.setattr("codex_agent.server.threading.Thread", ImmediateThread)
+    monkeypatch.setattr("codex_agent.server.core.threading.Thread", ImmediateThread)
 
     result = service.restart(prompt="resume please", title="resume", delay_seconds=0)
 

{codex_agent_framework-0.1.16 → codex_agent_framework-0.1.17}/tests/test_tui.py

@@ -1,5 +1,5 @@
 import signal
-from codex_agent import tui
+from codex_agent.tui import lifecycle as tui
 
 
 def test_install_tui_cleanup_handlers_clears_registered_pid_on_signal(monkeypatch):