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

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

@@ -3,6 +3,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.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.3}/PKG-INFO

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

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

@@ -295,6 +295,7 @@ 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.
 

{codex_agent_framework-0.1.2 → 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.2 → 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.2 → 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.2
+Version: 0.1.3
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT
@@ -342,6 +342,7 @@ 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.
 

{codex_agent_framework-0.1.2 → 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.2"
+version = "0.1.3"
 description = "A lightweight event-driven Codex agent runtime."
 readme = "README.md"
 requires-python = ">=3.10"

{codex_agent_framework-0.1.2 → 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():