synapse-cli-agent 0.1.38__tar.gz → 0.1.40__tar.gz

{synapse_cli_agent-0.1.38 → synapse_cli_agent-0.1.40}/.github/workflows/release.yml

@@ -102,6 +102,7 @@ jobs:
             --collect-all termaid `
             --collect-all texicode `
             --collect-all synapse_tool_compress_core `
+            --collect-data synapse `
             src/synapse/entry.py
 
       - name: Rename executable for artifact

{synapse_cli_agent-0.1.38 → synapse_cli_agent-0.1.40}/AGENTS.md

@@ -4,7 +4,8 @@
 
 | Path | Responsibility |
 | --- | --- |
-| `src/synapse/app/` | Agent assembly and `AGENTS.md` injection |
+| `src/synapse/app/` | Agent assembly (composition root in `agent.py`, contracts in `agent_assembly.py`) and `AGENTS.md` injection |
+| `src/synapse/acp/` | Official Agent Client Protocol (ACP) adapter: run Synapse as an ACP agent over stdio; session registry, permission coordinator, event bridge |
 | `src/synapse/commands/` | Slash command parsing, completion, and results |
 | `src/synapse/content/` | Prompts, skills, input history, multimodal content |
 | `src/synapse/goals/` | Goal accounting, steering, and persistence |
@@ -29,7 +30,7 @@
 
 ## Architecture & compatibility
 
-- `src/synapse/app/agent.py` is the assembly layer; keep domain algorithms in their own packages.
+- `src/synapse/app/agent.py` is the assembly composition root; the reusable assembly contracts (middleware build, typed resource wiring) live in `src/synapse/app/agent_assembly.py`. Keep domain algorithms in their own packages.
 - New features belong in the matching domain package; cross-domain wiring goes in `app/` or an explicit runtime middleware.
 - `src/synapse/config.py` is a compatibility re-export layer. Import from `synapse.settings` in new code; keep legacy import paths working.
 - `__init__.py` exports are public API. Keep necessary re-exports when moving implementations.

{synapse_cli_agent-0.1.38 → synapse_cli_agent-0.1.40}/CHANGELOG.md

@@ -8,6 +8,54 @@ All entries are written in English.
 
 ---
 
+## v0.1.40
+
+### New Features
+
+- Native file tools read images, video, audio, and PDF files as base64 (10 MB cap); Python adapters convert framework image blocks to Chat Completions and Responses `input_image` blocks (including data URLs and detail).
+- Native Rust OpenAI client supports proxy routing (HTTP/HTTPS/SOCKS4/SOCKS5) by building a proxied reqwest client when a proxy URL is configured; OAuth (Codex) profiles can use the native Responses transport; reqwest error source chains are flattened so connect/TLS/DNS causes are visible.
+- Added an OpenAI Codex Responses OAuth transport.
+- Added a `project-session-reader` skill for listing, searching, and reading a project's `.synapse` session database.
+- Added a `stream_usage` control for Responses usage metadata.
+
+### Bug Fixes
+
+- Reused native websocket connections across requests instead of opening new ones.
+- Handled Codex websocket extension events.
+- Reconciled transcript projection against the checkpoint watermark so projected history stays consistent with persisted state.
+- Corrected Responses usage metadata.
+- Prevented inflated tool-call token rates by excluding tool-call framing from rate accounting.
+
+### Engineering
+
+- Switched the `async-openai` dependency to a local git fork for the Responses-over-WebSocket feature.
+- Added a Rust OpenAI build check script.
+- Stabilized agent startup coverage tests.
+
+---
+
+## v0.1.39
+
+### New Features
+
+- Stamped session-affinity headers on model requests in both the Python runtime and the native Rust OpenAI client, for consistent session binding at upstream gateways.
+- Added a `session-cache-analysis` skill for computing per-session prompt cache hit rates and diagnosing cache eviction.
+
+### Bug Fixes
+
+- Hashed tools by their OpenAI wire form instead of the raw `StructuredTool` dump, keeping `tools_hash`/`schema_hash` stable across agent rebuilds (previously embedded the function object's memory address).
+- Inserted pasted text at the cursor position in the TUI prompt instead of appending.
+- Persisted the model binding before agent rebuild and on exit.
+- Loaded the debug inspector HTML via `importlib.resources` for frozen (PyInstaller) builds.
+
+### Engineering
+
+- Removed the tool-response truncation middleware and its settings.
+- Deprecated the reversible compression middleware and reader.
+- Kept the AGENTS.md repository-layout table in sync with the current tree.
+
+---
+
 ## v0.1.38
 
 ### New Features

{synapse_cli_agent-0.1.38 → synapse_cli_agent-0.1.40}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: synapse-cli-agent
-Version: 0.1.38
+Version: 0.1.40
 Summary: Local coding agent built on LangChain Deep Agents (LocalShell, no sandbox)
 Project-URL: Homepage, https://github.com/alex8224/synapse-agent
 Project-URL: Repository, https://github.com/alex8224/synapse-agent

{synapse_cli_agent-0.1.38 → synapse_cli_agent-0.1.40}/README.zh-CN.md

@@ -415,7 +415,6 @@ uv run synapse run "修复 calculator.sub 的 bug，使 tests 全部通过" -w t
 | `AGENT_MCP_CONFIG` | - | MCP servers JSON |
 | `CHECKPOINT_BACKEND` | `sqlite` | `sqlite` 或 `memory` |
 | `AGENT_SESSION_PREWARM_ENABLED` | `false` | 恢复大上下文会话后在后台预热 provider 缓存（首次请求仍按输入 token 计费；详见 `docs/config.md`） |
-| `AGENT_ENABLE_TOOL_RESPONSE_TRUNCATE` | `false` | 启用工具响应折叠（keep 窗口外的大工具输出压成摘要+引用，大上下文会话可省 20-30%；详见 `docs/config.md`） |
 | `INHERIT_ENV` | `true` | shell 继承主机环境 |
 | `VIRTUAL_MODE` | `true` | 文件路径虚拟根 |
 | `AGENT_SHOW_REASONING_PLACEHOLDERS` | `true` | 是否显示网关未暴露推理文本时的占位思考节点；Codex 加密推理可设为 `false` 隐藏 |

{synapse_cli_agent-0.1.38 → synapse_cli_agent-0.1.40}/docs/architecture-flow.md

@@ -467,7 +467,7 @@ load_settings(**overrides):
 | 工作区 | workspace, shell_timeout(120s), max_output_bytes(100KB) | Path.cwd() |
 | 安全 | require_approval(False), safety_profile("dev-autopass") | -- |
 | 检查点 | checkpoint_backend("sqlite") | project/.synapse/ |
-| 工具输出 | enable_tool_output_transform(True), threshold_bytes(512) | -- |
+| 工具输出 | enable_tool_output_transform(False), threshold_bytes(512) | -- |
 | 子代理 | enable_subagents(True) | -- |
 | MCP | enable_mcp(True), mcp_eager(False) | -- |
 | UI | theme("cursor-dark"), history_tail_turns(20) | -- |

{synapse_cli_agent-0.1.38 → synapse_cli_agent-0.1.40}/docs/config.md

@@ -77,13 +77,6 @@ Synapse 使用 **Pydantic Settings** 实现分层配置系统。
 | `SESSION_SUMMARY_MAX_CHARS` | `600` | 本地会话摘要的最大字符数（含多轮条目，超出时从最旧条目开始裁剪） |
 | `AGENT_HISTORY_TAIL_TURNS` | `20` | TUI 从轻量 transcript 投影初始读取/渲染的最近可见会话轮数；滚动到顶部后按 turn 游标加载更早历史，最多挂载 5 页 |
 | `AGENT_SESSION_PREWARM_ENABLED` | `false` | 恢复大上下文会话后，在后台对该会话历史发起一次最小模型请求，让 provider 预填充并缓存历史前缀，用户第一条消息可命中缓存、大幅缩短首 token 等待。注意：预热本身会按输入 token 计费一次，仅在需要时开启 |
-| `AGENT_ENABLE_TOOL_RESPONSE_TRUNCATE` | `false` | 启用工具响应裁剪：keep 窗口（默认最近 40K tokens）外的 `execute`/`read_file`/`search_files` 输出折叠为摘要，减小每轮请求体积（大上下文会话可省 20-30%）。请求层变换，不修改历史 |
-| `AGENT_TOOL_RESPONSE_TRUNCATE_KEEP_TOKENS` | `40000` | 工具响应裁剪的 keep 窗口（token），窗口内消息不裁剪 |
-| `AGENT_TOOL_RESPONSE_TRUNCATE_MAX_HEAD_CHARS` | `2000` | 关闭 fold 模式时，超长输出保留的头部字符数 |
-| `AGENT_TOOL_RESPONSE_TRUNCATE_MAX_TAIL_CHARS` | `0` | 关闭 fold 模式时，超长输出额外保留的尾部字符数（>0 表示 head+tail） |
-| `AGENT_TOOL_RESPONSE_TRUNCATE_FOLD_ENABLED` | `true` | fold 模式：窗口外输出一律折叠（有 `tool-output://` 引用的可经 `read_tool_result` 找回原文，无引用的保留头部锚点） |
-| `AGENT_TOOL_RESPONSE_TRUNCATE_FOLD_HEAD_CHARS` | `300` | fold 模式下无引用输出保留的头部锚点字符数 |
-| `AGENT_TOOL_RESPONSE_TRUNCATE_TOOLS` | `["execute","read_file","search_files"]` | 参与折叠/裁剪的工具名单（JSON 数组） |
 
 ### 长程目标（Goals）
 

{synapse_cli_agent-0.1.38 → synapse_cli_agent-0.1.40}/docs/design.md

@@ -250,7 +250,9 @@ py-agent/
 │   └── design.md                 # 本方案
 ├── AGENTS.md                     # 项目级记忆/约定（给 agent 读）
 ├── skills/                       # 可选 skills（渐进披露）
-│   └── python-testing/
+│   ├── session-crash-repair/
+│   │   └── SKILL.md
+│   └── session-cache-analysis/
 │       └── SKILL.md
 ├── src/
 │   └── coding_agent/

{synapse_cli_agent-0.1.38 → synapse_cli_agent-0.1.40}/docs/skills.md

@@ -6,9 +6,11 @@ Skills 是 Synapse 的可扩展插件系统，位于项目 `skills/` 目录下
 
 ```
 skills/
-├── python-testing/
+├── session-cache-analysis/
 │   └── SKILL.md
-└── python-memory-diagnostics/
+├── session-crash-repair/
+│   └── SKILL.md
+└── project-session-reader/
     └── SKILL.md
 ```
 
@@ -18,16 +20,16 @@ skills/
 
 ```markdown
 ---
-name: python-testing
-description: How to run and write Python tests in this project with uv and pytest.
-license: MIT
-compatibility: Requires uv and pytest in a Python 3.12+ project.
-allowed_tools: execute, run_tests, read_file, write_file, edit_file
+name: session-cache-analysis
+description: Analyze the prompt cache hit rate of a Synapse session (thread).
+license: Apache-2.0
+compatibility: Requires a synapse source checkout with uv and Python 3.12+.
+allowed_tools: execute, read_file, write_file, search_files, find_files, search_session, read_session
 ---
 
-# Python Testing Skill
+# Session Cache Hit-Rate Analysis
 
-## Running Tests
+## 数据来源
 ...
 ```
 
@@ -43,12 +45,13 @@ allowed_tools: execute, run_tests, read_file, write_file, edit_file
 
 ## 内置 Skills
 
-Synapse 自带两个 Skills：
+Synapse 自带三个 Skills：
 
 | Skill | 说明 |
 |---|---|
-| `python-testing` | 使用 uv + pytest 运行和编写测试 |
-| `python-memory-diagnostics` | 诊断 Python 进程内存问题 |
+| `session-crash-repair` | 检测并修复异常退出后 checkpoint 不一致的会话（悬挂工具调用、挂起图任务、过期转录投影） |
+| `session-cache-analysis` | 分析会话的 prompt 缓存命中率，区分增量 miss 与全量逐出并定位根因 |
+| `project-session-reader` | 读取或搜索指定项目（workspace 目录）`.synapse/` 下的会话：列出、全文搜索、按 thread_id 读取并分页 |
 
 ## 如何编写自定义 Skill
 

{synapse_cli_agent-0.1.38 → synapse_cli_agent-0.1.40}/docs/tool-output-transform.md

@@ -18,7 +18,7 @@ All transforms are deterministic. Synapse uses a low-cost `512` byte prefilter,
 
 ```json
 {
-  "enable_tool_output_transform": true,
+  "enable_tool_output_transform": false,
   "tool_output_transform_threshold_bytes": 512,
   "tool_output_disabled_types": ["code"],
   "tool_output_transform_plugins": ["my_package.transforms:my_transformer"],
@@ -26,10 +26,12 @@ All transforms are deterministic. Synapse uses a low-cost `512` byte prefilter,
 }
 ```
 
+Tool-output transformation is **off by default** (`enable_tool_output_transform: false`); set it to `true` to enable.
+
 Environment equivalents:
 
 ```text
-AGENT_ENABLE_TOOL_OUTPUT_TRANSFORM=true
+AGENT_ENABLE_TOOL_OUTPUT_TRANSFORM=false
 AGENT_TOOL_OUTPUT_TRANSFORM_THRESHOLD_BYTES=512
 AGENT_TOOL_OUTPUT_DISABLED_TYPES=["code"]
 AGENT_TOOL_OUTPUT_TRANSFORM_PLUGINS=["my_package.transforms:my_transformer"]

{synapse_cli_agent-0.1.38 → synapse_cli_agent-0.1.40}/docs/tutorial.md

@@ -328,9 +328,9 @@ synapse-agent/                       # 项目根目录
 │   └── fixtures/                    # 测试 fixtures
 │
 ├── skills/                          # Agent Skills
-│   ├── python-testing/              # Python 测试技能
+│   ├── session-crash-repair/        # 会话崩溃修复技能
 │   │   └── SKILL.md                 # 技能定义文件
-│   └── python-memory-diagnostics/   # 内存诊断技能
+│   └── session-cache-analysis/      # 会话缓存命中率分析技能
 │       └── SKILL.md
 │
 ├── docs/                            # 文档
@@ -1073,20 +1073,20 @@ Skills 是给 Agent 的可加载"专业说明手册"。
 ### 10.1 Skill 文件格式
 
 ```markdown
-<!-- skills/python-testing/SKILL.md -->
+<!-- skills/session-cache-analysis/SKILL.md -->
 
 ---
-name: python-testing
-description: How to run and write Python tests in this project with uv and pytest.
-license: MIT
-allowed-tools: execute run_tests read_file write_file edit_file
+name: session-cache-analysis
+description: Analyze the prompt cache hit rate of a Synapse session (thread).
+license: Apache-2.0
+allowed-tools: execute read_file write_file search_files find_files
 ---
 
-# Python testing skill
+# Session cache hit-rate analysis
 
-## Run tests
+## Data source
 Prefer:
-`uv run pytest`
+`load_messages_from_sqlite_file(checkpoints.sqlite, thread_id)`
 
 ...
 ```
@@ -1114,8 +1114,8 @@ Agent 启动时会扫描 `skills/` 目录，将所有 Skill 的描述注入系
 
 ### 10.3 现有 Skills
 
-- **python-testing**: 告诉 Agent 如何正确地运行和编写 Python 测试
-- **python-memory-diagnostics**: 告诉 Agent 如何诊断 Python 进程的内存问题
+- **session-crash-repair**: 告诉 Agent 如何检测并修复异常退出后 checkpoint 不一致的会话
+- **session-cache-analysis**: 告诉 Agent 如何分析会话的 prompt 缓存命中率并定位逐出根因
 
 ### 10.4 如何创建新 Skill
 

{synapse_cli_agent-0.1.38 → synapse_cli_agent-0.1.40}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "synapse-cli-agent"
-version = "0.1.38"
+version = "0.1.40"
 description = "Local coding agent built on LangChain Deep Agents (LocalShell, no sandbox)"
 readme = "README.md"
 license = { file = "LICENSE" }

synapse_cli_agent-0.1.40/release_body.md

@@ -0,0 +1,25 @@
+## v0.1.40
+
+### New Features
+
+- Native file tools read images, video, audio, and PDF files as base64 (10 MB cap); Python adapters convert framework image blocks to Chat Completions and Responses `input_image` blocks (including data URLs and detail).
+- Native Rust OpenAI client supports proxy routing (HTTP/HTTPS/SOCKS4/SOCKS5) by building a proxied reqwest client when a proxy URL is configured; OAuth (Codex) profiles can use the native Responses transport; reqwest error source chains are flattened so connect/TLS/DNS causes are visible.
+- Added an OpenAI Codex Responses OAuth transport.
+- Added a `project-session-reader` skill for listing, searching, and reading a project's `.synapse` session database.
+- Added a `stream_usage` control for Responses usage metadata.
+
+### Bug Fixes
+
+- Reused native websocket connections across requests instead of opening new ones.
+- Handled Codex websocket extension events.
+- Reconciled transcript projection against the checkpoint watermark so projected history stays consistent with persisted state.
+- Corrected Responses usage metadata.
+- Prevented inflated tool-call token rates by excluding tool-call framing from rate accounting.
+
+### Engineering
+
+- Switched the `async-openai` dependency to a local git fork for the Responses-over-WebSocket feature.
+- Added a Rust OpenAI build check script.
+- Stabilized agent startup coverage tests.
+
+---