Release v0.2.0

Author: HaShiShark

GITHUB_RELEASE.md

@@ -1,4 +1,4 @@
-# Codex Context Proxy v0.1.0
+# Codex Context Proxy v0.2.0
 
 A visual, editable context layer for Codex. Let AI edit AI's context with surgical precision, giving you more control and freedom over what Codex sees.
 
@@ -8,6 +8,8 @@ A visual, editable context layer for Codex. Let AI edit AI's context with surgic
 - Token overview for current context usage
 - Manual context inspection and editing panel
 - AI-assisted context compression for noisy tool output
+- More reliable compact/override handling after Codex `/compact`
+- Safer whole-node compression for tool-heavy assistant turns
 - Codex CLI support through `codex ctx proxy on/off/status`
 - Experimental Codex Desktop support through `codex ctx desktop on/off/status`
 - Windows installer with bundled Electron app and Python backend
@@ -17,7 +19,7 @@ A visual, editable context layer for Codex. Let AI edit AI's context with surgic
 Download and run:
 
 ```text
-Codex Context Proxy Setup 0.1.0.exe
+Codex Context Proxy Setup 0.2.0.exe
 ```
 
 After installation, open a new terminal and enable the proxy:

README.md

@@ -97,7 +97,7 @@ context window
 Download and run the Windows installer:
 
 ```text
-Codex Context Proxy Setup 0.1.0.exe
+Codex Context Proxy Setup 0.2.0.exe
 ```
 
 After installation, open a new terminal and enable the proxy:
@@ -187,7 +187,7 @@ npm run dist:win
 The installer is generated at:
 
 ```text
-release/Codex Context Proxy Setup 0.1.0.exe
+release/Codex Context Proxy Setup 0.2.0.exe
 ```
 
 ## Notes

README.zh-CN.md

@@ -97,7 +97,7 @@ context window
 下载并运行 Windows 安装包：
 
 ```text
-Codex Context Proxy Setup 0.1.0.exe
+Codex Context Proxy Setup 0.2.0.exe
 ```
 
 安装完成后，重新打开一个终端，然后启用代理：
@@ -187,7 +187,7 @@ npm run dist:win
 安装包会生成在：
 
 ```text
-release/Codex Context Proxy Setup 0.1.0.exe
+release/Codex Context Proxy Setup 0.2.0.exe
 ```
 
 ## 说明

RELEASE.md

@@ -17,14 +17,14 @@ npm run dist:win
 生成的安装包在：
 
 ```text
-release/Codex Context Proxy Setup 0.1.0.exe
+release/Codex Context Proxy Setup 0.2.0.exe
 ```
 
 安装包会带上 Electron 前端、React 构建产物、`web_server.py`、`proxy_server.py` 以及打包后的 Python exe。用户不需要自己安装 Node 或 Python。
 
 ## 用户怎么用
 
-用户安装 `Codex Context Proxy Setup 0.1.0.exe` 后，安装器会自动安装 `codex ctx proxy ...` 控制命令，但不会默认打开代理。
+用户安装 `Codex Context Proxy Setup 0.2.0.exe` 后，安装器会自动安装 `codex ctx proxy ...` 控制命令，但不会默认打开代理。
 
 安装完成后，重新打开一个终端，然后使用：
 
@@ -103,7 +103,7 @@ codex ctx desktop status
 把下面这个文件上传到 GitHub Releases、网盘或下载页即可：
 
 ```text
-release/Codex Context Proxy Setup 0.1.0.exe
+release/Codex Context Proxy Setup 0.2.0.exe
 ```
 
 旧的 `hashcode Setup ...exe` 是历史产物，不要发布。

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "hash-context-codex-lab",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "private": true,
   "description": "Local context proxy and workbench companion for Codex.",
   "author": "",

package.json

@@ -1511,6 +1511,54 @@ def test_context_workbench_compressed_nodes_stay_independent_after_cleaning() ->
     assert "assistant follow-up" not in json.dumps(cleaned, ensure_ascii=False)
 
 
+def test_context_workbench_compress_nodes_replaces_tool_heavy_node() -> None:
+    tool_output = "very long frontend scan output"
+    assistant_items = [
+        proxy_server.provider_message("assistant", "I will inspect the frontend."),
+        {
+            "type": "function_call",
+            "call_id": TOOL_CALL_ID,
+            "name": "shell_command",
+            "arguments": json.dumps({"command": "Get-ChildItem react_app -Force"}),
+        },
+        {
+            "type": "function_call_output",
+            "call_id": TOOL_CALL_ID,
+            "output": tool_output,
+        },
+        proxy_server.provider_message("assistant", "Frontend is React + Vite."),
+    ]
+    transcript = [
+        proxy_server.transcript_record(
+            "user",
+            "inspect frontend",
+            [proxy_server.provider_message("user", "inspect frontend")],
+        ),
+        proxy_server.transcript_record(
+            "assistant",
+            "I will inspect the frontend.\n\nFrontend is React + Vite.",
+            assistant_items,
+        ),
+    ]
+    draft = web_server.ContextWorkbenchDraft(web_server.normalize_transcript(transcript), [1])
+    nodes = draft._nodes_by_number([2])
+
+    draft.compress_nodes(
+        nodes,
+        summary_markdown="Frontend discussion compressed: React + Vite.",
+        style="tight summary",
+        title="",
+    )
+    committed = proxy_server.clean_transcript(draft.committed_transcript())
+    serialized = json.dumps(committed, ensure_ascii=False)
+
+    assert [record["role"] for record in committed] == ["user", "user"]
+    assert committed[1]["text"] == "Frontend discussion compressed: React + Vite."
+    assert "function_call" not in serialized
+    assert tool_output not in serialized
+    assert "I will inspect the frontend" not in serialized
+
+
 def test_context_workbench_hides_internal_prefix_nodes_from_editing() -> None:
     transcript = web_server.normalize_transcript(
         [
@@ -1598,6 +1646,7 @@ def main() -> None:
     test_compaction_visible_text_falls_back_to_encrypted_content()
     test_local_compact_response_replaces_transcript_with_readable_summary()
     test_context_workbench_compressed_nodes_stay_independent_after_cleaning()
+    test_context_workbench_compress_nodes_replaces_tool_heavy_node()
     test_context_workbench_hides_internal_prefix_nodes_from_editing()
 
     with tempfile.TemporaryDirectory() as temp_dir:

scripts/test_compact_proxy.py

@@ -4774,12 +4774,12 @@ def __init__(self, draft: ContextWorkbenchDraft) -> None:
                 self._build_preview_selection_tool(),
                 self._build_node_detail_tool(),
                 self._build_find_items_tool(),
+                self._build_compress_nodes_tool(),
+                self._build_delete_nodes_tool(),
                 self._build_edit_items_tool(),
                 self._build_delete_item_tool(),
                 self._build_replace_item_tool(),
                 self._build_compress_item_tool(),
-                self._build_compress_nodes_tool(),
-                self._build_delete_nodes_tool(),
                 self._build_set_revision_summary_tool(),
             ]
         }
@@ -4809,6 +4809,18 @@ def tool_catalog(cls) -> list[dict[str, str]]:
                 "description": "Search provider items using lightweight metadata and previews, without returning full node content.",
                 "status": "available",
             },
+            {
+                "id": "compress_context_nodes",
+                "label": "Compress Nodes",
+                "description": "Whole-node compression: replace nodes, discussions, topics, or assistant turns with summary nodes, removing text, reasoning, tool calls, and tool outputs.",
+                "status": "available",
+            },
+            {
+                "id": "delete_context_nodes",
+                "label": "Delete Nodes",
+                "description": "Delete one or more nodes from the current working snapshot.",
+                "status": "available",
+            },
             {
                 "id": "edit_context_items",
                 "label": "Edit Items",
@@ -4833,18 +4845,6 @@ def tool_catalog(cls) -> list[dict[str, str]]:
                 "description": "Replace one item with a shorter version while keeping the same item type.",
                 "status": "available",
             },
-            {
-                "id": "compress_context_nodes",
-                "label": "Compress Nodes",
-                "description": "Replace one or more nodes with a new summary node inside the current working snapshot.",
-                "status": "available",
-            },
-            {
-                "id": "delete_context_nodes",
-                "label": "Delete Nodes",
-                "description": "Delete one or more nodes from the current working snapshot.",
-                "status": "available",
-            },
         ]
 
     def execute(self, name: str, arguments: dict[str, Any]) -> ToolExecution:
@@ -5609,7 +5609,11 @@ def handler(arguments: dict[str, Any]) -> ToolExecution:
         return ContextWorkbenchToolDefinition(
             name="compress_context_nodes",
             label="Compress Nodes",
-            description="Replace one or more nodes with a new summary node inside the current working snapshot.",
+            description=(
+                "Whole-node compression. Replace one or more nodes with a new summary node inside the current working snapshot. "
+                "Use this when the user asks to compress a node, discussion, topic, or assistant turn; it removes the target nodes' "
+                "assistant text, reasoning, tool calls, and tool outputs from the snapshot."
+            ),
             parameters={
                 "type": "object",
                 "properties": {
@@ -5894,7 +5898,10 @@ def build_context_chat_runtime(
             "user 节点直接给全文；assistant 节点默认只给上下文地图折叠态同款首句预览，预览后面的内容你并不可见；需要协议层细节或完整内容时，再调用 get_context_node_details。",
             "Node Detail 里会给出 item #1 / item #2 / item #3 这样的当轮可编辑 item 视图。",
             "如果你要定位某类 item（例如所有 tool output、某类 tool call、某个文本片段），优先调用 find_context_items；它只返回预览和元数据，不会把大段内容塞进你的上下文。",
+            "用户说压缩某个节点、某段讨论、某个主题或某轮 assistant 内容时，默认是节点级压缩：优先调用 compress_context_nodes，用一个摘要节点替换整个目标节点，包含其中的 assistant 文本、reasoning、工具调用和工具输出。",
+            "不要把节点级压缩误做成只压缩 message item；如果目标节点里有工具输出，压缩整个节点通常就是为了移除这些大块工具输出。",
             "如果你要批量删除、改写、压缩 assistant text / tool call / tool output，优先调用 edit_context_items，用 selector 一次选中目标，再用 operation 一次完成；不要逐个 item 反复调用单项工具。",
+            "edit_context_items 只用于 item 级编辑：例如用户明确要求只压缩所有 tool output、只删除工具调用、或保留节点结构但缩短某类 item。",
             "edit_context_items 的 replace_content / compress_content 会保留原 item 的 type 和 call_id，只改可编辑内容；delete 会原子删除工具调用/输出配对，保证 Codex 输入仍然合法。",
             "delete_context_item / replace_context_item / compress_context_item 只用于少数精细单点修改，或者当用户明确要求按完整 provider item 改写时使用。",
             "选中只是强提示，不是门槛。显式 node_numbers 优先，其次是当前选中；如果都没有，可以用 target_hint 让系统帮你定位候选节点。",