codex-agent-framework 0.1.1__tar.gz → 0.1.3__tar.gz

{codex_agent_framework-0.1.1 → codex_agent_framework-0.1.3}/CHANGELOG.md

@@ -3,6 +3,22 @@
 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.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.
+
+### Tests
+- Add regression coverage ensuring terminal screen clearing does not append session messages.
+
+
 ## [0.1.1] - 2026-05-03
 ### Fixed
 - Validate `ImageMessage` content before adding it to session state.

{codex_agent_framework-0.1.1/codex_agent_framework.egg-info → codex_agent_framework-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.1
+Version: 0.1.3
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT
@@ -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.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.
 
 ## Safety notes

{codex_agent_framework-0.1.1 → codex_agent_framework-0.1.3}/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.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.
 
 ## Safety notes

{codex_agent_framework-0.1.1 → codex_agent_framework-0.1.3}/codex_agent/agent.py

@@ -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)

{codex_agent_framework-0.1.1 → codex_agent_framework-0.1.3}/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.1 → codex_agent_framework-0.1.3}/codex_agent/chat.py

@@ -38,9 +38,13 @@ class TerminalChat:
                     [("class:prompt", "You > ")],
                     prompt_continuation="...   ",
                 )
-                if prompt.strip().lower() in ["exit", "quit", "/exit", "/quit"]:
+                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:
@@ -93,6 +97,9 @@ class TerminalChat:
             )
         )
 
+    def clear_screen(self):
+        self.console.clear()
+
     @staticmethod
     def _format_int(value):
         try:

{codex_agent_framework-0.1.1 → codex_agent_framework-0.1.3/codex_agent_framework.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.1
+Version: 0.1.3
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT
@@ -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.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.
 
 ## Safety notes

{codex_agent_framework-0.1.1 → codex_agent_framework-0.1.3}/pyproject.toml

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

{codex_agent_framework-0.1.1 → codex_agent_framework-0.1.3}/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():

{codex_agent_framework-0.1.1 → codex_agent_framework-0.1.3}/tests/test_chat.py

@@ -8,6 +8,11 @@ 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():
@@ -45,3 +50,14 @@ def test_terminal_chat_status_bar_renders_context_summary():
     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