Release v1.0.0 major refactor

Author: HaShiShark

.github/workflows/build-macos.yml

@@ -118,10 +118,14 @@ jobs:
         with:
           tag_name: ${{ github.event_name == 'workflow_dispatch' && inputs.release_tag || github.ref_name }}
           body: |
+            大重构更新。
+
             Updates:
-            - Fix compact summary duplication.
-            - Improve manual and automatic compact prompts.
-            - Improve auto compact detection during running assistant turns.
+            - Refactor the backend proxy architecture around the FastAPI proxy entry.
+            - Unify frontend and backend transcript/context contracts.
+            - Split proxy storage, SSE, session id, and item registry responsibilities into dedicated modules.
+            - Expand frontend contract and backend proxy core tests for the rebuilt protocol paths.
+            - Update packaging so shared modules are included in release installers.
           files: |
             release-artifacts/*.dmg
             release-artifacts/*.zip

CODEX_PROXY_NOTES.md

@@ -24,7 +24,7 @@ codex `
 
 ## Local Services
 
-- `backend/proxy_server.py`: Codex-compatible Responses proxy, port `8787`.
+- `backend/proxy_fastapi.py`: Codex-compatible Responses proxy, port `8787`.
 - `backend/web_server.py`: HashCode backend, port `8765`.
 - Vite dev server: React frontend, port `5174`.
 - `electron/context-window.cjs`: Electron shell and local service supervisor.

GITHUB_RELEASE.md

@@ -1,4 +1,4 @@
-# Codex Context Proxy v0.3.0
+# Codex Context Proxy v1.0.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.
 
@@ -23,7 +23,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.3.0.exe
+Codex Context Proxy Setup 1.0.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.3.0.exe
+Codex Context Proxy Setup 1.0.0.exe
 ```
 
 After installation, open a new terminal and enable the proxy:
@@ -188,7 +188,7 @@ npm run dist:win
 The installer is generated at:
 
 ```text
-release/Codex Context Proxy Setup 0.3.0.exe
+release/Codex Context Proxy Setup 1.0.0.exe
 ```
 
 ## Notes

README.zh-CN.md

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

RELEASE.md

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

agent_runtime/core/canonical_types.py

@@ -13,6 +13,8 @@
 JsonObject: TypeAlias = dict[str, JsonValue]
 
 PromptBlockKind: TypeAlias = Literal["system", "developer", "memory", "summary"]
+# agent_runtime is a lightweight agent adapter layer. Its transcript role is not
+# the lossless proxy TranscriptNode.role contract from backend/transcript_codec.py.
 TranscriptRole: TypeAlias = Literal["user", "assistant"]
 CanonicalItemType: TypeAlias = Literal["message", "tool_call", "tool_result"]
 CanonicalStatus: TypeAlias = Literal[

agent_runtime/core/transcript_contract.py

@@ -1,5 +1,14 @@
 from __future__ import annotations
 
+"""Lightweight agent_runtime transcript contract.
+
+This module is intentionally scoped to adapter-friendly chat history for
+agent_runtime/simple_agent. It is not the proxy core transcript contract; the
+lossless proxy transcript lives in backend/transcript_codec.py as TranscriptNode
+and preserves provider roles/items such as system, developer, context,
+subagent, and compaction.
+"""
+
 from dataclasses import dataclass, field
 from typing import Literal, TypeAlias
 
@@ -39,7 +48,7 @@ class TranscriptBlock:
 
 @dataclass(slots=True)
 class TranscriptRecord:
-    """Product transcript record. Roles are intentionally limited."""
+    """agent_runtime chat record. Roles are intentionally limited."""
 
     role: TranscriptRole
     text: str

backend/codex_input_cursor.py

@@ -15,6 +15,35 @@
 
 
 DYNAMIC_FINGERPRINT_KEYS = frozenset({"id"})
+_DYNAMIC_ID_ITEM_TYPES = frozenset(
+    {
+        "message",
+        "agent_message",
+        "reasoning",
+        "function_call",
+        "function_call_output",
+        "custom_tool_call",
+        "custom_tool_call_output",
+        "local_shell_call",
+        "local_shell_call_output",
+        "tool_search_call",
+        "tool_search_output",
+        "web_search_call",
+        "image_generation_call",
+        "compaction",
+        "context_compaction",
+    }
+)
+_DYNAMIC_ID_CONTENT_PART_TYPES = frozenset(
+    {
+        "input_text",
+        "output_text",
+        "text",
+        "input_image",
+        "reasoning_text",
+        "summary_text",
+    }
+)
 
 
 def canonical_provider_item_for_request(item: Any) -> Any:
@@ -149,18 +178,19 @@ def __iter__(self):
 
 
 def normalize_provider_item(value: Any) -> Any:
-    """Return a stable semantic projection used for provider item hashing.
+    """Return a request-safe deep normalization of provider values.
 
-    Only exact ``id`` keys are removed.  Semantic identifiers such as
-    ``call_id`` or ``file_id`` are preserved, as are opaque reasoning fields
-    such as ``encrypted_content``.
+    This function deliberately preserves nested ``id`` keys. Tool schemas can
+    contain semantic fields named ``id`` (for example
+    ``parameters.properties.id``), and deleting them corrupts the request body.
+    Dynamic response item ids are ignored only by ``_pick`` at known item
+    boundaries and by the fingerprint-only normalization below.
     """
 
     if isinstance(value, Mapping):
         return {
             key: normalize_provider_item(child)
             for key, child in value.items()
-            if key not in DYNAMIC_FINGERPRINT_KEYS
         }
     if isinstance(value, list):
         return [normalize_provider_item(child) for child in value]
@@ -183,20 +213,26 @@ def fingerprint_provider_item(item: Any) -> str:
 
 
 def semantic_provider_item_for_fingerprint(value: Any) -> Any:
+    return _semantic_provider_item_for_fingerprint(value, depth=0)
+
+
+def _semantic_provider_item_for_fingerprint(value: Any, *, depth: int) -> Any:
     if isinstance(value, Mapping):
         item_type = str(value.get("type") or "").strip()
-        ignored_keys = {"id"}
+        ignored_keys: set[str] = set()
+        if depth == 0 or item_type in _DYNAMIC_ID_ITEM_TYPES | _DYNAMIC_ID_CONTENT_PART_TYPES:
+            ignored_keys.add("id")
         if item_type == "message":
             ignored_keys.add("phase")
         return {
-            key: semantic_provider_item_for_fingerprint(child)
+            key: _semantic_provider_item_for_fingerprint(child, depth=depth + 1)
             for key, child in value.items()
             if key not in ignored_keys
         }
     if isinstance(value, list):
-        return [semantic_provider_item_for_fingerprint(child) for child in value]
+        return [_semantic_provider_item_for_fingerprint(child, depth=depth + 1) for child in value]
     if isinstance(value, tuple):
-        return [semantic_provider_item_for_fingerprint(child) for child in value]
+        return [_semantic_provider_item_for_fingerprint(child, depth=depth + 1) for child in value]
     return value