codex-agent-framework 0.1.9__tar.gz → 0.1.10__tar.gz

{codex_agent_framework-0.1.9 → codex_agent_framework-0.1.10}/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.10] - 2026-05-05
+### Fixed
+- Persist only backend `compaction_summary` items in compaction messages, avoiding bulky compacted conversation payloads while preserving summary replay.
+- Sanitize encrypted compaction summaries in local token estimates and refresh cached context status after compaction/message updates.
+
+### Tests
+- Add regression coverage for compaction payload filtering, legacy `output_items` migration, context status cache invalidation, and runtime status updates after compaction.
+
 ## [0.1.9] - 2026-05-05
 ### Changed
 - Maintenance release for the packaged distribution after validating the updated local execution environment and deploy workflow.

{codex_agent_framework-0.1.9/codex_agent_framework.egg-info → codex_agent_framework-0.1.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.9
+Version: 0.1.10
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT
@@ -400,6 +400,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.10`: persist only backend compaction summaries, drop bulky compacted conversation payloads, and refresh context status after compaction.
 - `0.1.9`: maintenance packaging release after validating the local execution environment and deploy workflow.
 - `0.1.8`: scope TUI replay/SSE catch-up to the active session and make bash/python subprocesses inherit the project Python environment, including service-launched agents.
 - `0.1.7`: add durable RAG memory, scheduled wakeups, process-isolated server runtime, tray/service controls, robust SSE replay/reconnect, richer TUI status, and improved token estimates.

{codex_agent_framework-0.1.9 → codex_agent_framework-0.1.10}/README.md

@@ -352,6 +352,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.10`: persist only backend compaction summaries, drop bulky compacted conversation payloads, and refresh context status after compaction.
 - `0.1.9`: maintenance packaging release after validating the local execution environment and deploy workflow.
 - `0.1.8`: scope TUI replay/SSE catch-up to the active session and make bash/python subprocesses inherit the project Python environment, including service-launched agents.
 - `0.1.7`: add durable RAG memory, scheduled wakeups, process-isolated server runtime, tray/service controls, robust SSE replay/reconnect, richer TUI status, and improved token estimates.

{codex_agent_framework-0.1.9 → codex_agent_framework-0.1.10}/codex_agent/agent.py

@@ -192,7 +192,7 @@ class AgentSession(modict):
         result = client.compact(history, model=model, instructions=instructions)
         message = CompactionMessage(
             response_id=result.response_id,
-            output_items=result.output_items,
+            summaries=CompactionMessage.summary_items(result.output_items),
             compacted_message_count=len(compacted_messages),
         )
 
@@ -825,10 +825,11 @@ class Agent:
             compact_kwargs.client = client
         message = self.session.compact(**compact_kwargs)
         self._context_status_cache = None
-        self.refresh_estimated_status_cache()
+        status = self.refresh_estimated_status_cache()
         self.emit(
             CompactionCompletedEvent,
             message=message,
+            status=status,
             compacted_message_count=plan.compacted_message_count,
             compacted_token_count=plan.compacted_token_count,
             post_compaction_message_count=len(self.session.context_messages()),
@@ -872,6 +873,7 @@ class Agent:
             if not msg.session_id:
                 msg.session_id=self.current_session_id
             self.session.messages.append(msg)
+            self._context_status_cache = None
             self.save_session()
             self.emit(MessageAddedEvent, message=msg)
         return msg
@@ -1496,6 +1498,10 @@ class Agent:
                     item = item.copy()
                     item["image_url"] = "<image>"
                     return item
+                if item.get("type") == "compaction_summary" and item.get("encrypted_content"):
+                    item = item.copy()
+                    item["encrypted_content"] = "<encrypted_compaction_summary>"
+                    return {key: sanitize(child) for key, child in item.items()}
                 return {key: sanitize(child) for key, child in item.items()}
             return value
 

{codex_agent_framework-0.1.9 → codex_agent_framework-0.1.10}/codex_agent/agent_runtime.py

@@ -247,6 +247,12 @@ class ProcessAgentRuntime:
         elif event_type == "session_loaded_event":
             self.cache.current_session_id = event.get("session_id")
             self.cache.session = event.get("session") or self.cache.session
+        elif event_type == "compaction_completed_event" and event.get("status"):
+            status = modict(event.status)
+            self.cache.status = status
+            self.cache.busy = bool(status.get("busy", self.cache.busy))
+            self.cache.current_turn_id = status.get("current_turn_id", self.cache.current_turn_id)
+            self.cache.current_session_id = status.get("session_id", self.cache.current_session_id)
         for handler in list(self.event_handlers):
             handler(event)
 

{codex_agent_framework-0.1.9 → codex_agent_framework-0.1.10}/codex_agent/message.py

@@ -185,11 +185,26 @@ class CompactionMessage(DeveloperMessage):
     name = "compaction"
     content = "Previous conversation context was compacted by the backend."
     response_id = ""
-    output_items = None
+    summaries = modict.factory(list)
     compacted_message_count = 0
 
+    def __init__(self, *args, **kwargs):
+        output_items = kwargs.pop("output_items", None)
+        super().__init__(*args, **kwargs)
+        if output_items is None:
+            output_items = self.pop("output_items", None)
+        if output_items is not None and not self.get("summaries"):
+            self.summaries = self.summary_items(output_items)
+
+    @staticmethod
+    def summary_items(items):
+        return [
+            item for item in items or []
+            if item.get("type") == "compaction_summary"
+        ]
+
     def to_response_format(self):
-        return list(self.get("output_items") or [])
+        return list(self.get("summaries") or [])
 
     def as_string_attrs(self):
         attrs = self.extract('name', 'type', 'timestamp')
@@ -199,7 +214,7 @@ class CompactionMessage(DeveloperMessage):
 
     def as_string_body(self):
         summary = next(
-            (item for item in self.get("output_items") or [] if item.get("type") == "compaction_summary"),
+            iter(self.get("summaries") or []),
             None,
         )
         if not summary:

{codex_agent_framework-0.1.9 → codex_agent_framework-0.1.10/codex_agent_framework.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-agent-framework
-Version: 0.1.9
+Version: 0.1.10
 Summary: A lightweight event-driven Codex agent runtime.
 Author: Baptiste
 License-Expression: MIT
@@ -400,6 +400,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.10`: persist only backend compaction summaries, drop bulky compacted conversation payloads, and refresh context status after compaction.
 - `0.1.9`: maintenance packaging release after validating the local execution environment and deploy workflow.
 - `0.1.8`: scope TUI replay/SSE catch-up to the active session and make bash/python subprocesses inherit the project Python environment, including service-launched agents.
 - `0.1.7`: add durable RAG memory, scheduled wakeups, process-isolated server runtime, tray/service controls, robust SSE replay/reconnect, richer TUI status, and improved token estimates.

{codex_agent_framework-0.1.9 → codex_agent_framework-0.1.10}/pyproject.toml

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

{codex_agent_framework-0.1.9 → codex_agent_framework-0.1.10}/tests/test_agent.py

@@ -120,7 +120,10 @@ class AbortableAI:
 
 class FakeCompactionResult:
     response_id = "resp_123"
-    output_items = [{"type": "compaction_summary", "id": "cs_123", "encrypted_content": "opaque"}]
+    output_items = [
+        {"type": "message", "role": "user", "content": [{"type": "input_text", "text": "old"}]},
+        {"type": "compaction_summary", "id": "cs_123", "encrypted_content": "opaque"},
+    ]
 
 
 class FakeCompactionClient:
@@ -271,7 +274,8 @@ def test_agent_session_compact_inserts_compaction_before_remainder(tmp_path, mon
 
     assert isinstance(message, CompactionMessage)
     assert session.messages == [user, done, message, current]
-    assert message.output_items == FakeCompactionResult.output_items
+    assert "output_items" not in message
+    assert message.summaries == [FakeCompactionResult.output_items[1]]
     assert message.compacted_message_count == 2
     assert client.history == [
         {
@@ -338,6 +342,8 @@ def test_agent_compact_session_emits_volume_events(tmp_path, monkeypatch):
     assert seen[0].total_session_messages == 3
     assert seen[0].compacted_token_count > 0
     assert seen[1].message is message
+    assert seen[1].status.source == "local_estimate"
+    assert seen[1].status.context_current_tokens != 5000
     assert seen[1].compacted_message_count == 2
     assert seen[1].post_compaction_message_count == 2
     assert seen[1].total_session_messages == 4
@@ -350,6 +356,17 @@ def test_agent_compact_session_emits_volume_events(tmp_path, monkeypatch):
     assert status.quota_7d_percent == 34
 
 
+def test_agent_add_message_invalidates_context_status_cache():
+    agent = Agent(session="new", voice_enabled=False)
+    first = agent.context_status()
+
+    agent.add_message(DeveloperMessage(content="new visible context"))
+    second = agent.context_status()
+
+    assert second.total_session_messages == first.total_session_messages + 1
+    assert second.used_tokens != first.used_tokens
+
+
 def test_agent_get_context_starts_at_latest_compaction():
     agent = Agent(session="new", voice_enabled=False)
     old = DeveloperMessage(content="old hidden context")
@@ -367,6 +384,26 @@ def test_agent_get_context_starts_at_latest_compaction():
     assert "old hidden context" not in context_text
 
 
+def test_agent_local_context_estimate_does_not_count_encrypted_compaction_payload():
+    agent = Agent(session="new", voice_enabled=False)
+    encrypted_content = "x" * 100_000
+    agent.session.messages = [
+        CompactionMessage(output_items=[{
+            "type": "compaction_summary",
+            "id": "cs_123",
+            "encrypted_content": encrypted_content,
+        }]),
+        DeveloperMessage(content="small current context"),
+    ]
+
+    status = agent.context_status()
+
+    assert status.used_tokens < 10_000
+    assert encrypted_content not in str(agent.local_token_count_payload(
+        agent.response_input_token_payload(agent.session.context_messages(), response_tools=[])
+    ))
+
+
 def test_agent_get_context_filters_expired_messages():
     agent = Agent(session="new", voice_enabled=False)
     expired = DeveloperMessage(content="expired hidden context", turns_left=0)

{codex_agent_framework-0.1.9 → codex_agent_framework-0.1.10}/tests/test_messages.py

@@ -189,15 +189,18 @@ def test_server_tool_response_message_as_string_includes_item_metadata():
     assert '"type": "web_search_call"' in text
 
 
-def test_compaction_message_replays_backend_output_items():
-    output_items = [{"type": "compaction_summary", "id": "cs_123", "encrypted_content": "opaque"}]
+def test_compaction_message_replays_only_backend_summary_items():
+    output_items = [
+        {"type": "message", "role": "user", "content": [{"type": "input_text", "text": "old"}]},
+        {"type": "compaction_summary", "id": "cs_123", "encrypted_content": "opaque"},
+    ]
     message = CompactionMessage(
         response_id="resp_123",
         output_items=output_items,
         compacted_message_count=4,
     )
 
-    assert message.to_response_format() == output_items
+    assert message.to_response_format() == [output_items[1]]
     text = message.as_string()
     assert text.startswith("<CompactionMessage ")
     assert "response_id='resp_123'" in text
@@ -207,6 +210,19 @@ def test_compaction_message_replays_backend_output_items():
     assert "encrypted_content" not in text
 
 
+def test_compaction_message_migrates_legacy_output_items_without_persisting_them():
+    output_items = [
+        {"type": "message", "role": "user", "content": [{"type": "input_text", "text": "old"}]},
+        {"type": "compaction_summary", "id": "cs_123", "encrypted_content": "opaque"},
+    ]
+
+    message = CompactionMessage({"output_items": output_items})
+
+    assert "output_items" not in message
+    assert message.summaries == [output_items[1]]
+    assert message.to_response_format() == [output_items[1]]
+
+
 def test_image_generation_response_message_persists_result_as_file(tmp_path, monkeypatch):
     monkeypatch.setattr(utils, "RUNTIME_DIR", str(tmp_path))
     result = "Zm9v"

{codex_agent_framework-0.1.9 → codex_agent_framework-0.1.10}/tests/test_server.py

@@ -605,6 +605,28 @@ def test_process_agent_runtime_discards_timed_out_commands():
     assert runtime.pending == {}
 
 
+def test_process_agent_runtime_updates_cached_status_from_compaction_event():
+    runtime = ProcessAgentRuntime()
+
+    runtime._handle_event(modict(
+        type="compaction_completed_event",
+        status=modict(
+            context_current_tokens=123,
+            context_limit_tokens=1000,
+            context_percent=12.3,
+            sent_session_messages=1,
+            total_session_messages=52,
+            session_id="session_1",
+            busy=False,
+            source="local_estimate",
+        ),
+    ))
+
+    assert runtime.cache.status.context_current_tokens == 123
+    assert runtime.cache.current_session_id == "session_1"
+    assert runtime.cache.busy is False
+
+
 def test_agent_server_subscribe_replays_missed_events_after_sequence():
     agent = Agent(session="new", voice_enabled=False)
     service = AgentServer(agent)