codex-agent-framework 0.1.2__tar.gz → 0.1.4__tar.gz

{codex_agent_framework-0.1.2 → codex_agent_framework-0.1.4}/CHANGELOG.md

@@ -3,6 +3,27 @@
 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.4] - 2026-05-03
+### Added
+- Make the Textual REPL UI the default chat interface, with multiline input, subdued colors, visual speaker separators, step-end markers, and cleaner tool-call rendering.
+- Add assistant turn and assistant step lifecycle events for UI and runtime integrations.
+- Add a `/voice` command to show, toggle, or select the configured voice mode.
+
+### Changed
+- Remove the legacy prompt-toolkit chat UI and the temporary `--textual` CLI flag.
+
+### Tests
+- Add CLI coverage for starting the default chat UI and update chat status formatting tests.
+
+
+## [0.1.3] - 2026-05-03
+### Added
+- Send the current session id as `prompt_cache_key` to the Codex backend, enabling server-side prompt cache reuse across calls from the same session.
+
+### Tests
+- Add regression coverage for prompt cache key propagation through agent response calls and Codex stream parameters.
+
+
 ## [0.1.2] - 2026-05-03
 ### Added
 - Add a `/clear` terminal chat command that clears the screen without touching session history.

{codex_agent_framework-0.1.2/codex_agent_framework.egg-info → codex_agent_framework-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.2
+Version: 0.1.4
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT
@@ -26,7 +26,6 @@ Requires-Dist: openai
 Requires-Dist: openpyxl
 Requires-Dist: pathspec
 Requires-Dist: pillow
-Requires-Dist: prompt_toolkit
 Requires-Dist: pydub
 Requires-Dist: PyPDF2
 Requires-Dist: pynteract
@@ -36,6 +35,7 @@ Requires-Dist: regex
 Requires-Dist: requests
 Requires-Dist: rich
 Requires-Dist: selenium
+Requires-Dist: textual
 Requires-Dist: tiktoken
 Requires-Dist: trafilatura
 Provides-Extra: dev
@@ -342,6 +342,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.4`: make the Textual REPL UI the default, add multiline input, assistant turn/step events, cleaner tool-call rendering, and `/voice` configuration.
+- `0.1.3`: pass the current session id as `prompt_cache_key` to the Codex backend for prompt cache reuse.
 - `0.1.2`: add `/clear` in the terminal chat to clear the screen without changing session history.
 - `0.1.1`: image observations are now validated before session persistence, preventing broken `ImageMessage` entries from poisoning later turns.
 

{codex_agent_framework-0.1.2 → codex_agent_framework-0.1.4}/README.md

@@ -295,6 +295,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.4`: make the Textual REPL UI the default, add multiline input, assistant turn/step events, cleaner tool-call rendering, and `/voice` configuration.
+- `0.1.3`: pass the current session id as `prompt_cache_key` to the Codex backend for prompt cache reuse.
 - `0.1.2`: add `/clear` in the terminal chat to clear the screen without changing session history.
 - `0.1.1`: image observations are now validated before session persistence, preventing broken `ImageMessage` entries from poisoning later turns.
 

{codex_agent_framework-0.1.2 → codex_agent_framework-0.1.4}/codex_agent/__init__.py

@@ -2,6 +2,10 @@ from .agent import Agent, AgentSession
 from .event import (
     AgentInterrupted,
     AgentInterruptedEvent,
+    AssistantStepEndEvent,
+    AssistantStepStartEvent,
+    AssistantTurnEndEvent,
+    AssistantTurnStartEvent,
     AudioPlaybackEvent,
     Event,
     EventBus,

{codex_agent_framework-0.1.2 → codex_agent_framework-0.1.4}/codex_agent/__main__.py

@@ -3,7 +3,7 @@ from pathlib import Path
 from . import Agent
 
 
-def main():
+def main(argv=None):
     package_dir = Path(__file__).parent
     agent = Agent(
         system=str(package_dir / 'prompts' / 'system_prompt.txt'),

{codex_agent_framework-0.1.2 → codex_agent_framework-0.1.4}/codex_agent/agent.py

@@ -19,7 +19,7 @@ from .ai import AIClient
 from .worker import TurnSummaryWorker
 from .voice import VoiceProcessor
 from .latex import LaTeXProcessor
-from .event import AgentInterrupted, AgentInterruptedEvent, AudioPlaybackEvent, EventBus, MessageAddedEvent, ToolCallDoneEvent, ToolCallStartEvent
+from .event import AgentInterrupted, AgentInterruptedEvent, AssistantStepEndEvent, AssistantStepStartEvent, AssistantTurnEndEvent, AssistantTurnStartEvent, AudioPlaybackEvent, EventBus, MessageAddedEvent, ToolCallDoneEvent, ToolCallStartEvent
 from pynteract import Shell
 from datetime import datetime
 from threading import Event as ThreadEvent, Thread as BackgroundThread
@@ -906,6 +906,7 @@ class Agent:
         message=self.ai.run(
             messages=messages,
             tools=self.get_response_tools(),
+            prompt_cache_key=self.current_session_id,
             **self.config.extract('model','reasoning_effort','verbosity')
         )
         self.add_message(message)
@@ -1055,15 +1056,24 @@ class Agent:
 
         self.clear_interrupt()
         self.age_context_messages()
+        turn_message = None
+        self.emit(AssistantTurnStartEvent)
         try:
             while True:
                 self.check_interrupt()
                 self.dump_pending()
-                message=self.get_response()
-                ThreadPool.join_all()
-                self.check_interrupt()
-                called_tools=self.call_tools(message)
-                self.dump_pending()
+                message = None
+                called_tools = False
+                self.emit(AssistantStepStartEvent)
+                try:
+                    message=self.get_response()
+                    turn_message = message
+                    ThreadPool.join_all()
+                    self.check_interrupt()
+                    called_tools=self.call_tools(message)
+                    self.dump_pending()
+                finally:
+                    self.emit(AssistantStepEndEvent, message=message, called_tools=called_tools)
 
                 if called_tools:
                     if self.config.get('auto_proceed',True):
@@ -1076,6 +1086,8 @@ class Agent:
             self.dump_pending()
             self.add_message(DeveloperMessage(content="The previous agent response was interrupted by the user."))
             return False
+        finally:
+            self.emit(AssistantTurnEndEvent, message=turn_message)
 
     def speak(self,text,**kwargs):
         from .voice import silent_play
@@ -1167,13 +1179,10 @@ class Agent:
         return self.process()
 
     def interact(self):
-        """Starts an interactive command-line loop for user prompts until 'exit' or 'quit' is typed.
-
-        Uses Alt+Enter for multi-line input submission.
-        """
+        """Starts the interactive Textual chat UI."""
         from .utils import set_root_path
         import os
         if os.environ.get('AGENT_ROOT_PATH') is None:
             set_root_path(file=__file__)
-        from .chat import TerminalChat
-        TerminalChat(self).run()
+        from .chat import Chat
+        Chat(self).run()

{codex_agent_framework-0.1.2 → codex_agent_framework-0.1.4}/codex_agent/ai.py

@@ -289,6 +289,7 @@ class AIClient:
             "reasoning": reasoning,
             "reasoning_summary": "auto" if reasoning else None,
             "include_reasoning": bool(reasoning),
+            "prompt_cache_key": params.get("prompt_cache_key"),
         }
 
     def _codex_event_to_message_chunk(self, event, tool_call_index=0):

{codex_agent_framework-0.1.2 → codex_agent_framework-0.1.4}/codex_agent/builtin_commands.py

@@ -134,3 +134,22 @@ def verbosity(value=None):
     if value is None:
         return f"verbosity: {get_agent().config.verbosity!r}"
     return update_model_config(verbosity=value)
+
+
+@command
+def voice(value=None):
+    agent = get_agent()
+    if value is None:
+        state = "on" if agent.config.get("voice_enabled", False) else "off"
+        return f"voice: {state}; voice={agent.config.get('voice')!r}"
+
+    lowered = str(value).lower()
+    if lowered in ("on", "true", "yes", "1"):
+        agent.update_config(voice_enabled=True)
+        return f"Updated config: voice_enabled={agent.config.voice_enabled!r}"
+    if lowered in ("off", "false", "no", "0"):
+        agent.update_config(voice_enabled=False)
+        return f"Updated config: voice_enabled={agent.config.voice_enabled!r}"
+
+    agent.update_config(voice=str(value), voice_enabled=True)
+    return f"Updated config: voice={agent.config.voice!r}, voice_enabled={agent.config.voice_enabled!r}"

codex_agent_framework-0.1.4/codex_agent/chat.py

@@ -0,0 +1,356 @@
+from rich.text import Text
+
+from .event import (
+    AssistantStepEndEvent,
+    AssistantStepStartEvent,
+    AssistantTurnEndEvent,
+    AssistantTurnStartEvent,
+    ResponseContentDeltaEvent,
+    ServerToolCallEvent,
+    ToolCallStartEvent,
+)
+
+class Chat:
+    """Textual-based chat UI styled as a quiet modern REPL."""
+
+    CSS = """
+    Screen {
+        background: #171a1f;
+        color: #c6c8c4;
+    }
+
+    #main {
+        height: 100%;
+        padding: 0 1;
+        background: #171a1f;
+    }
+
+    #conversation {
+        height: 1fr;
+        padding: 1 1;
+        background: #171a1f;
+    }
+
+    #status {
+        height: 1;
+        color: #7d8590;
+        background: #171a1f;
+    }
+
+    #input {
+        height: 5;
+        margin-top: 0;
+        padding: 0 1;
+        background: #1f242c;
+        color: #c6c8c4;
+        border: blank #1f242c;
+    }
+
+    TextArea > .text-area--cursor {
+        background: #6f98bd;
+        color: #0d1117;
+    }
+
+    Footer {
+        background: #171a1f;
+        color: #7d8590;
+    }
+    """
+
+    def __init__(self, agent):
+        self.agent = agent
+        self.app = None
+        self._seen_tool_calls = set()
+        self._agent_buffer = ""
+        self._pending_tools = []
+        self._transcript = []
+
+    def attach(self):
+        self.agent.on(AssistantTurnStartEvent, self._on_assistant_turn_start)
+        self.agent.on(AssistantStepStartEvent, self._on_assistant_step_start)
+        self.agent.on(AssistantStepEndEvent, self._on_assistant_step_end)
+        self.agent.on(AssistantTurnEndEvent, self._on_assistant_turn_end)
+        self.agent.on(ResponseContentDeltaEvent, self._on_content_delta)
+        self.agent.on(ToolCallStartEvent, self._on_tool_call_start)
+        self.agent.on(ServerToolCallEvent, self._on_server_tool_call)
+        return self
+
+    def run(self):
+        from textual.app import App, ComposeResult
+        from textual.containers import Vertical
+        from textual.widgets import Footer, RichLog, Static, TextArea
+
+        chat = self
+
+        class AgentTextualApp(App):
+            CSS = chat.CSS
+            TITLE = "Codex Agent"
+            BINDINGS = [
+                ("ctrl+c", "interrupt", "Interrupt"),
+                ("ctrl+l", "clear", "Clear"),
+                ("ctrl+q", "quit", "Quit"),
+                ("ctrl+s", "submit", "Submit"),
+                ("alt+enter", "submit", "Submit"),
+                ("ctrl+enter", "submit", "Submit"),
+                ("f2", "submit", "Submit"),
+            ]
+
+            def compose(self) -> ComposeResult:
+                with Vertical(id="main"):
+                    yield RichLog(id="conversation", wrap=True, highlight=False, markup=True)
+                    yield Static("", id="status")
+                    yield TextArea(
+                        "",
+                        placeholder="› message  ·  Entrée = newline  ·  Ctrl+S/F2 = envoyer  ·  Ctrl+Q = quitter",
+                        id="input",
+                        show_line_numbers=False,
+                        soft_wrap=True,
+                    )
+                yield Footer()
+
+            def on_mount(self):
+                chat.app = self
+                chat.attach()
+                self.refresh_status()
+                self.query_one("#input", TextArea).focus()
+                self.write_info("Codex Agent prêt.")
+
+            def action_quit(self):
+                self.exit()
+
+            def action_submit(self):
+                input_widget = self.query_one("#input", TextArea)
+                prompt = input_widget.text
+                input_widget.load_text("")
+                command = prompt.strip().lower()
+                if not command:
+                    return
+                if command in ["exit", "quit", "/exit", "/quit"]:
+                    self.exit()
+                    return
+                if command == "/clear":
+                    self.action_clear()
+                    return
+
+                self.write_user(prompt)
+                self.refresh_status()
+                self.run_worker(lambda: self._run_agent(prompt), thread=True)
+
+            def _run_agent(self, prompt):
+                try:
+                    result = chat.agent(prompt)
+                    if isinstance(result, str) and result:
+                        self.call_from_thread(self.write_info, result)
+                except Exception as exc:
+                    self.call_from_thread(self.write_error, str(exc))
+                finally:
+                    self.call_from_thread(self.refresh_status)
+
+            def action_clear(self):
+                chat._transcript.clear()
+                self.query_one("#conversation", RichLog).clear()
+                self.write_info("écran nettoyé · historique conservé")
+                self.refresh_status()
+
+            def action_interrupt(self):
+                chat.agent.interrupt("keyboard_interrupt")
+                self.write_error("interruption demandée")
+
+            def log_width(self):
+                # Keep visual separators a few columns narrower than the RichLog
+                # viewport: Textual reserves space for padding/scrollbar.
+                raw_width = self.query_one("#conversation", RichLog).size.width or 80
+                return max(32, raw_width - 6)
+
+            def speaker_rule(self, name, style):
+                width = self.log_width()
+                label = f" {name} "
+                available = max(2, width - len(label))
+                left = available // 2
+                right = available - left
+                line = "─" * left + label + "─" * right
+                return Text(line, style=style)
+
+            def qed_marker(self, style="#6f98bd"):
+                return Text(" " * max(0, self.log_width() - 1) + "▪", style=style)
+
+            def render_transcript(self):
+                log = self.query_one("#conversation", RichLog)
+                log.clear()
+                for entry in chat._transcript:
+                    kind = entry[0]
+                    if kind == "speaker":
+                        _, name, style = entry
+                        log.write(self.speaker_rule(name, style))
+                        log.write("")
+                    elif kind == "user":
+                        log.write(Text(entry[1], style="#c6c8c4"))
+                    elif kind == "agent":
+                        log.write(Text(entry[1], style="#c6c8c4"))
+                    elif kind == "tool":
+                        _, name, call_id, status = entry
+                        suffix = f" · {status}" if status else ""
+                        call = f" · {call_id}" if call_id else ""
+                        log.write(
+                            Text("tool › ", style="bold #6f98bd")
+                            + Text(name or "tool", style="#c6c8c4")
+                            + Text(f"{call}{suffix}", style="#7d8590")
+                        )
+                    elif kind == "step_end":
+                        log.write(self.qed_marker())
+                    elif kind == "user_end":
+                        log.write(self.qed_marker("#88b38a"))
+                    elif kind == "info":
+                        log.write(Text("info › ", style="bold #7d8590") + Text(str(entry[1]), style="#8b949e"))
+                    elif kind == "error":
+                        log.write(Text("error › ", style="bold #ff7b72") + Text(str(entry[1]), style="#ff7b72"))
+
+            def write_user(self, prompt):
+                username = chat.agent.config.get("username") or "Vous"
+                chat._transcript.append(("speaker", username, "#88b38a"))
+                chat._transcript.append(("user", prompt))
+                chat._transcript.append(("user_end",))
+                self.render_transcript()
+
+            def write_agent_start(self, name):
+                chat._agent_buffer = ""
+                chat._pending_tools.clear()
+                chat._seen_tool_calls.clear()
+                agent_name = name or chat.agent.config.get("name") or "Pandora"
+                chat._transcript.append(("speaker", agent_name, "#789fbe"))
+                self.render_transcript()
+
+            def start_agent_step(self):
+                self.render_transcript()
+
+            def write_agent_delta(self, delta):
+                chat._agent_buffer += delta
+                if chat._transcript and chat._transcript[-1][0] == "agent":
+                    chat._transcript[-1] = ("agent", chat._agent_buffer)
+                else:
+                    chat._transcript.append(("agent", chat._agent_buffer))
+                self.render_transcript()
+
+            def write_tool(self, name, call_id=None, status=None):
+                chat._pending_tools.append(("tool", name, call_id, status))
+
+            def end_agent_step(self):
+                had_content = bool(chat._agent_buffer or chat._pending_tools)
+                if chat._transcript and chat._transcript[-1][0] == "agent":
+                    if chat._agent_buffer:
+                        chat._transcript[-1] = ("agent", chat._agent_buffer)
+                    else:
+                        chat._transcript.pop()
+                if chat._pending_tools:
+                    chat._transcript.extend(chat._pending_tools)
+                    chat._pending_tools.clear()
+                if had_content and (not chat._transcript or chat._transcript[-1][0] != "step_end"):
+                    chat._transcript.append(("step_end",))
+                self.render_transcript()
+
+            def write_info(self, text):
+                chat._transcript.append(("info", str(text)))
+                self.render_transcript()
+
+            def write_error(self, text):
+                chat._transcript.append(("error", str(text)))
+                self.render_transcript()
+
+            def refresh_status(self):
+                try:
+                    status = chat.agent.context_status()
+                    text = chat.format_status(status).plain
+                except Exception as exc:
+                    text = f"status unavailable: {exc}"
+                self.query_one("#status", Static).update(text)
+
+        AgentTextualApp().run()
+
+
+    @classmethod
+    def format_status(cls, status):
+        percent = status.percent
+        style = "green"
+        if percent >= 90:
+            style = "bold red"
+        elif percent >= 75:
+            style = "yellow"
+        elif percent >= 50:
+            style = "cyan"
+
+        used = cls._format_int(status.used_tokens)
+        limit = cls._format_int(status.input_token_limit)
+        session = str(status.session_id or "-")[-15:]
+        compact_hint = " auto-compact:on" if status.auto_compact else " auto-compact:off"
+        if status.auto_compact and status.used_tokens >= status.auto_compact_threshold:
+            compact_hint = " auto-compact:due"
+
+        return Text.assemble(
+            ("ctx ", "dim"),
+            (f"{percent:.1f}%", style),
+            (f" {used}/{limit} tok", "dim"),
+            (f" · hist {status.visible_history_messages}/{status.total_history_messages}", "dim"),
+            (f" · msgs {status.total_session_messages}", "dim"),
+            (f" · img {status.image_messages}", "dim"),
+            (f" · mem {status.memory_entries}", "dim"),
+            (f" · pending {status.pending_messages}", "dim"),
+            (f" · {session}", "dim"),
+            (compact_hint, "dim"),
+        )
+
+    @staticmethod
+    def _format_int(value):
+        try:
+            return f"{int(value):,}".replace(",", " ")
+        except Exception:
+            return str(value)
+
+    def _call_app(self, method, *args):
+        if self.app is None:
+            return
+        callback = getattr(self.app, method)
+        try:
+            self.app.call_from_thread(callback, *args)
+        except RuntimeError:
+            callback(*args)
+
+    def _on_assistant_turn_start(self, event):
+        name = self.agent.config.get("name") or "Pandora"
+        self._call_app("write_agent_start", name)
+
+    def _on_assistant_step_start(self, event):
+        self._agent_buffer = ""
+        self._call_app("start_agent_step")
+
+    def _on_assistant_step_end(self, event):
+        self._call_app("end_agent_step")
+        self._call_app("refresh_status")
+
+    def _on_assistant_turn_end(self, event):
+        self._call_app("refresh_status")
+
+    def _on_content_delta(self, event):
+        self._call_app("write_agent_delta", event.delta)
+
+    def _on_tool_call_start(self, event):
+        tool_call = event.get("tool_call") or {}
+        name = tool_call.get("name") or "unknown"
+        call_id = tool_call.get("call_id") or name
+        self._print_tool_call(name, call_id)
+
+    def _on_server_tool_call(self, event):
+        name = event.get("name") or "unknown"
+        call_id = event.get("call_id") or name
+        status = event.get("status") or ""
+        self._print_tool_call(name, call_id, status=status)
+
+    def _print_tool_call(self, name, call_id, status=None):
+        if call_id in self._seen_tool_calls:
+            return
+        self._seen_tool_calls.add(call_id)
+        self._call_app("write_tool", name, call_id, status)
+
+    def _on_response_done(self, event):
+        # Tool call lines are flushed at assistant-turn end, not after each
+        # backend response, to keep agentic loops visually contiguous.
+        pass

{codex_agent_framework-0.1.2 → codex_agent_framework-0.1.4}/codex_agent/event.py

@@ -16,6 +16,23 @@ class Event(modict):
         self['type'] = snake_case_type(type(self))
 
 
+class AssistantTurnStartEvent(Event):
+    message = None
+
+
+class AssistantTurnEndEvent(Event):
+    message = None
+
+
+class AssistantStepStartEvent(Event):
+    message = None
+
+
+class AssistantStepEndEvent(Event):
+    message = None
+    called_tools = False
+
+
 class ResponseStartEvent(Event):
     message = None
 

{codex_agent_framework-0.1.2 → codex_agent_framework-0.1.4/codex_agent_framework.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.2
+Version: 0.1.4
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT
@@ -26,7 +26,6 @@ Requires-Dist: openai
 Requires-Dist: openpyxl
 Requires-Dist: pathspec
 Requires-Dist: pillow
-Requires-Dist: prompt_toolkit
 Requires-Dist: pydub
 Requires-Dist: PyPDF2
 Requires-Dist: pynteract
@@ -36,6 +35,7 @@ Requires-Dist: regex
 Requires-Dist: requests
 Requires-Dist: rich
 Requires-Dist: selenium
+Requires-Dist: textual
 Requires-Dist: tiktoken
 Requires-Dist: trafilatura
 Provides-Extra: dev
@@ -342,6 +342,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.4`: make the Textual REPL UI the default, add multiline input, assistant turn/step events, cleaner tool-call rendering, and `/voice` configuration.
+- `0.1.3`: pass the current session id as `prompt_cache_key` to the Codex backend for prompt cache reuse.
 - `0.1.2`: add `/clear` in the terminal chat to clear the screen without changing session history.
 - `0.1.1`: image observations are now validated before session persistence, preventing broken `ImageMessage` entries from poisoning later turns.
 

{codex_agent_framework-0.1.2 → codex_agent_framework-0.1.4}/codex_agent_framework.egg-info/SOURCES.txt

@@ -39,6 +39,7 @@ codex_agent_framework.egg-info/top_level.txt
 tests/test_agent.py
 tests/test_ai.py
 tests/test_chat.py
+tests/test_cli.py
 tests/test_events.py
 tests/test_image_message.py
 tests/test_memory.py

{codex_agent_framework-0.1.2 → codex_agent_framework-0.1.4}/codex_agent_framework.egg-info/requires.txt

@@ -9,7 +9,6 @@ openai
 openpyxl
 pathspec
 pillow
-prompt_toolkit
 pydub
 PyPDF2
 pynteract
@@ -19,6 +18,7 @@ regex
 requests
 rich
 selenium
+textual
 tiktoken
 trafilatura
 

{codex_agent_framework-0.1.2 → codex_agent_framework-0.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codex-agent-framework"
-version = "0.1.2"
+version = "0.1.4"
 description = "A lightweight event-driven Codex agent runtime."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -34,7 +34,6 @@ dependencies = [
   "openpyxl",
   "pathspec",
   "pillow",
-  "prompt_toolkit",
   "pydub",
   "PyPDF2",
   "pynteract",
@@ -44,6 +43,7 @@ dependencies = [
   "requests",
   "rich",
   "selenium",
+  "textual",
   "tiktoken",
   "trafilatura",
 ]

{codex_agent_framework-0.1.2 → codex_agent_framework-0.1.4}/tests/test_agent.py

@@ -60,8 +60,12 @@ class FakeImageAI:
 class FakeCodexClient:
     def __init__(self, events):
         self.events = events
+        self.args = None
+        self.kwargs = None
 
-    def stream(self, *_args, **_kwargs):
+    def stream(self, *args, **kwargs):
+        self.args = args
+        self.kwargs = kwargs
         return iter(self.events)
 
 
@@ -290,6 +294,7 @@ def test_agent_get_response_emits_events_and_persists_assistant_message():
     assert agent.session.messages[-1] is message
     assert json.loads(json.dumps(message))["type"] == "assistant_message"
     assert agent.ai.params["verbosity"] == agent.config.verbosity
+    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"])
@@ -525,6 +530,7 @@ def test_agent_emits_server_tool_call_event_from_output_items():
     )
 
     assert seen == [("web_search", "ws_123", "completed")]
+    assert agent.ai._codex_client.kwargs["prompt_cache_key"] is None
 
 
 def test_agent_persists_server_tool_output_items_as_messages():
@@ -1059,15 +1065,17 @@ def test_agent_can_enable_builtin_server_tools_from_config():
     assert set(agent.server_tools) == {"web_search", "image_generation"}
 
 
-def test_codex_stream_params_forward_verbosity():
+def test_codex_stream_params_forward_verbosity_and_prompt_cache_key():
     agent = Agent(session="new", voice_enabled=False, verbosity="low")
 
     params = agent.ai._to_codex_stream_params({
         "messages": agent.get_context(),
         "verbosity": agent.config.verbosity,
+        "prompt_cache_key": agent.current_session_id,
     })
 
     assert params["verbosity"] == "low"
+    assert params["prompt_cache_key"] == agent.current_session_id
 
 
 def test_agent_provider_messages_are_ephemeral():
@@ -1135,7 +1143,7 @@ def test_agent_command_supports_varargs_and_kwargs():
 def test_agent_loads_builtin_commands():
     agent = Agent(session="new", voice_enabled=False)
 
-    assert {"help", "compact", "config", "model", "reasoning", "verbosity"}.issubset(agent.commands)
+    assert {"help", "compact", "config", "model", "reasoning", "verbosity", "voice"}.issubset(agent.commands)
     assert "/help" in agent("/help")
     assert "/compact" in agent("/help")
 
@@ -1154,6 +1162,24 @@ def test_builtin_model_config_commands_update_and_persist(tmp_path, monkeypatch)
     assert agent.config.verbosity == "high"
 
 
+def test_builtin_voice_command_shows_toggles_and_selects_voice(tmp_path, monkeypatch):
+    monkeypatch.setattr(utils, "RUNTIME_DIR", str(tmp_path))
+    agent = Agent(session="new", voice_enabled=False, voice="nova")
+
+    assert agent("/voice") == "voice: off; voice='nova'"
+    assert agent("/voice on") == "Updated config: voice_enabled=True"
+    assert agent.config.voice_enabled is True
+    assert agent("/voice off") == "Updated config: voice_enabled=False"
+    assert agent.config.voice_enabled is False
+    assert agent("/voice shimmer") == "Updated config: voice='shimmer', voice_enabled=True"
+    assert agent.config.voice == "shimmer"
+    assert agent.config.voice_enabled is True
+
+    saved = json.loads((tmp_path / "agent_config.json").read_text())
+    assert saved["voice"] == "shimmer"
+    assert saved["voice_enabled"] is True
+
+
 def test_builtin_config_command_shows_and_updates_multiple_model_fields(tmp_path, monkeypatch):
     monkeypatch.setattr(utils, "RUNTIME_DIR", str(tmp_path))
     agent = Agent(session="new", voice_enabled=False)

{codex_agent_framework-0.1.2 → codex_agent_framework-0.1.4}/tests/test_chat.py

@@ -1,20 +1,8 @@
-from rich.console import Console
-
 from codex_agent import Agent
-from codex_agent.chat import TerminalChat
+from codex_agent.chat import Chat
 from codex_agent.message import DeveloperMessage
 
 
-class RecordingConsole(Console):
-    def __init__(self):
-        super().__init__(record=True, width=160)
-        self.clear_count = 0
-
-    def clear(self, *args, **kwargs):
-        self.clear_count += 1
-        return super().clear(*args, **kwargs)
-
-
 def test_agent_context_status_is_lightweight_and_does_not_call_providers():
     agent = Agent(session="new", voice_enabled=False, input_token_limit=10_000)
     agent.session.messages.append(DeveloperMessage(content="hello context"))
@@ -36,28 +24,15 @@ def test_agent_context_status_is_lightweight_and_does_not_call_providers():
     assert status.memory_entries == len(agent.memory.messages)
 
 
-def test_terminal_chat_status_bar_renders_context_summary():
+def test_chat_status_bar_formats_context_summary():
     agent = Agent(session="new", voice_enabled=False, input_token_limit=10_000)
-    console = RecordingConsole()
-    chat = TerminalChat(agent, console=console)
+    status = agent.context_status()
 
-    chat.print_status_bar()
+    output = Chat.format_status(status).plain
 
-    output = console.export_text()
     assert "ctx" in output
     assert "%" in output
     assert "tok" in output
     assert "hist" in output
     assert "msgs" in output
     assert "mem" in output
-
-def test_terminal_chat_clear_screen_does_not_touch_agent_session():
-    agent = Agent(session="new", voice_enabled=False)
-    initial_count = len(agent.session.messages)
-    console = RecordingConsole()
-    chat = TerminalChat(agent, console=console)
-
-    chat.clear_screen()
-
-    assert console.clear_count == 1
-    assert len(agent.session.messages) == initial_count

codex_agent_framework-0.1.4/tests/test_cli.py

@@ -0,0 +1,22 @@
+from codex_agent import __main__
+
+
+class FakeAgent:
+    instances = []
+
+    def __init__(self, **kwargs):
+        self.kwargs = kwargs
+        self.interacted = False
+        FakeAgent.instances.append(self)
+
+    def interact(self):
+        self.interacted = True
+
+
+def test_cli_starts_default_textual_chat(monkeypatch):
+    FakeAgent.instances.clear()
+    monkeypatch.setattr(__main__, "Agent", FakeAgent)
+
+    __main__.main([])
+
+    assert FakeAgent.instances[-1].interacted is True

codex_agent_framework-0.1.2/codex_agent/chat.py

@@ -1,146 +0,0 @@
-from prompt_toolkit import PromptSession
-from rich.console import Console
-from rich.panel import Panel
-from rich.rule import Rule
-from rich.text import Text
-from .event import ResponseContentDeltaEvent, ResponseDoneEvent, ResponseStartEvent, ServerToolCallEvent, ToolCallStartEvent
-
-
-class TerminalChat:
-    """Small terminal UI wired to agent events."""
-
-    def __init__(self, agent, console=None):
-        self.agent = agent
-        self.console = console or Console()
-        self.prompt_session = PromptSession(multiline=True)
-        self._in_response = False
-        self._has_content = False
-        self._seen_tool_calls = set()
-
-    def attach(self):
-        self.agent.on(ResponseStartEvent, self._on_response_start)
-        self.agent.on(ResponseContentDeltaEvent, self._on_content_delta)
-        self.agent.on(ToolCallStartEvent, self._on_tool_call_start)
-        self.agent.on(ServerToolCallEvent, self._on_server_tool_call)
-        self.agent.on(ResponseDoneEvent, self._on_response_done)
-        return self
-
-    def run(self):
-        self.attach()
-        self.console.print(Panel.fit(
-            "[bold]Codex Agent[/bold]\n[dim]Alt+Enter submits multiline input. Type exit or quit to stop.[/dim]",
-            border_style="cyan",
-        ))
-        while True:
-            try:
-                self.print_status_bar()
-                prompt = self.prompt_session.prompt(
-                    [("class:prompt", "You > ")],
-                    prompt_continuation="...   ",
-                )
-                command = prompt.strip().lower()
-                if command in ["exit", "quit", "/exit", "/quit"]:
-                    self.console.print("[dim]Bye.[/dim]")
-                    break
-                if command == "/clear":
-                    self.clear_screen()
-                    continue
-                if not prompt.strip():
-                    continue
-                try:
-                    result = self.agent(prompt)
-                    if isinstance(result, str) and result:
-                        self.console.print(result, style="dim")
-                except KeyboardInterrupt:
-                    self.agent.interrupt("keyboard_interrupt")
-                    self.console.print("\n[dim]Interrupted.[/dim]")
-                self.console.print()
-            except (KeyboardInterrupt, EOFError):
-                self.console.print("\n[dim]Bye.[/dim]")
-                break
-
-    def print_status_bar(self):
-        try:
-            status = self.agent.context_status()
-        except Exception as exc:
-            self.console.print(f"[dim red]status unavailable: {exc}[/dim red]")
-            return
-
-        percent = status.percent
-        style = "green"
-        if percent >= 90:
-            style = "bold red"
-        elif percent >= 75:
-            style = "yellow"
-        elif percent >= 50:
-            style = "cyan"
-
-        used = self._format_int(status.used_tokens)
-        limit = self._format_int(status.input_token_limit)
-        session = str(status.session_id or "-")[-15:]
-        compact_hint = " auto-compact:on" if status.auto_compact else " auto-compact:off"
-        if status.auto_compact and status.used_tokens >= status.auto_compact_threshold:
-            compact_hint = " auto-compact:due"
-
-        self.console.print(
-            Text.assemble(
-                ("ctx ", "dim"),
-                (f"{percent:.1f}%", style),
-                (f" {used}/{limit} tok", "dim"),
-                (f" · hist {status.visible_history_messages}/{status.total_history_messages}", "dim"),
-                (f" · msgs {status.total_session_messages}", "dim"),
-                (f" · img {status.image_messages}", "dim"),
-                (f" · mem {status.memory_entries}", "dim"),
-                (f" · pending {status.pending_messages}", "dim"),
-                (f" · {session}", "dim"),
-                (compact_hint, "dim"),
-            )
-        )
-
-    def clear_screen(self):
-        self.console.clear()
-
-    @staticmethod
-    def _format_int(value):
-        try:
-            return f"{int(value):,}".replace(",", " ")
-        except Exception:
-            return str(value)
-
-    def _on_response_start(self, event):
-        if self._in_response:
-            self.console.print()
-        self._in_response = True
-        self._has_content = False
-        self._seen_tool_calls.clear()
-        name = event.message.get("name") if event.get("message") else None
-        self.console.print(Rule(Text(name or "Agent", style="bold cyan"), style="cyan"))
-
-    def _on_content_delta(self, event):
-        self._has_content = True
-        self.console.print(event.delta, end="", markup=False, highlight=False, soft_wrap=True)
-
-    def _on_tool_call_start(self, event):
-        tool_call = event.get("tool_call") or {}
-        name = tool_call.get("name") or "unknown"
-        call_id = tool_call.get("call_id") or name
-        self._print_tool_call(name, call_id)
-
-    def _on_server_tool_call(self, event):
-        name = event.get("name") or "unknown"
-        call_id = event.get("call_id") or name
-        self._print_tool_call(name, call_id)
-
-    def _print_tool_call(self, name, call_id):
-        if call_id in self._seen_tool_calls:
-            return
-        self._seen_tool_calls.add(call_id)
-        if self._has_content:
-            self.console.print()
-        self.console.print(f"tool: {name}", style="dim cyan")
-        self._has_content = False
-
-    def _on_response_done(self, event):
-        if self._has_content:
-            self.console.print()
-        self._in_response = False