synapse-cli-agent 0.1.39__tar.gz → 0.1.41__tar.gz

{synapse_cli_agent-0.1.39 → synapse_cli_agent-0.1.41}/CHANGELOG.md

@@ -8,6 +8,40 @@ All entries are written in English.
 
 ---
 
+## v0.1.41
+
+### New Features
+
+- MCP clients now declare the project workspace as an MCP workspace root, so file-writing tools (e.g. CDP screenshots) can write inside the project workspace instead of being restricted to the OS temp directory when no roots are configured.
+
+---
+
+## 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

{synapse_cli_agent-0.1.39 → synapse_cli_agent-0.1.41}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: synapse-cli-agent
-Version: 0.1.39
+Version: 0.1.41
 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.39 → synapse_cli_agent-0.1.41}/docs/skills.md

@@ -8,7 +8,9 @@ Skills 是 Synapse 的可扩展插件系统，位于项目 `skills/` 目录下
 skills/
 ├── session-cache-analysis/
 │   └── SKILL.md
-└── session-crash-repair/
+├── session-crash-repair/
+│   └── SKILL.md
+└── project-session-reader/
     └── SKILL.md
 ```
 
@@ -43,12 +45,13 @@ allowed_tools: execute, read_file, write_file, search_files, find_files, search_
 
 ## 内置 Skills
 
-Synapse 自带两个 Skills：
+Synapse 自带三个 Skills：
 
 | Skill | 说明 |
 |---|---|
 | `session-crash-repair` | 检测并修复异常退出后 checkpoint 不一致的会话（悬挂工具调用、挂起图任务、过期转录投影） |
 | `session-cache-analysis` | 分析会话的 prompt 缓存命中率，区分增量 miss 与全量逐出并定位根因 |
+| `project-session-reader` | 读取或搜索指定项目（workspace 目录）`.synapse/` 下的会话：列出、全文搜索、按 thread_id 读取并分页 |
 
 ## 如何编写自定义 Skill
 

{synapse_cli_agent-0.1.39 → synapse_cli_agent-0.1.41}/pyproject.toml

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

synapse_cli_agent-0.1.41/release_body.md

@@ -0,0 +1,7 @@
+## v0.1.41
+
+### New Features
+
+- MCP clients now declare the project workspace as an MCP workspace root, so file-writing tools (e.g. CDP screenshots) can write inside the project workspace instead of being restricted to the OS temp directory when no roots are configured.
+
+---

{synapse_cli_agent-0.1.39 → synapse_cli_agent-0.1.41}/rust/synapse-core-tool/Cargo.lock

@@ -48,8 +48,7 @@ checksum = "d3fb67a6e08acf24fdeccbac2cb6ac4305825bd1f117462e0e6f2f193345ad56"
 [[package]]
 name = "async-openai"
 version = "0.41.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d72db2750faea2ca5edbf6d0c50277a89dc8f75f5e6ddd695ef30f75e335019b"
+source = "git+https://github.com/alex8224/async-openai.git?rev=c56301b#c56301bd68dfe4381cc965ebb40a26fb8d9aefc1"
 dependencies = [
  "async-openai-macros",
  "base64",
@@ -59,14 +58,16 @@ dependencies = [
  "futures",
  "getrandom 0.3.4",
  "rand 0.9.5",
- "reqwest 0.13.4",
+ "reqwest",
  "secrecy",
  "serde",
  "serde_json",
  "serde_urlencoded",
  "thiserror 2.0.20",
  "tokio",
+ "tokio-socks",
  "tokio-stream",
+ "tokio-tungstenite",
  "tokio-util",
  "tower",
  "tracing",
@@ -76,8 +77,7 @@ dependencies = [
 [[package]]
 name = "async-openai-macros"
 version = "0.3.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "492a944774207eed3acf425214eadbd6ce84a2b89331164ff1c11bae92b26302"
+source = "git+https://github.com/alex8224/async-openai.git?rev=c56301b#c56301bd68dfe4381cc965ebb40a26fb8d9aefc1"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -152,6 +152,15 @@ version = "2.13.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "b588b76d00fde79687d7646a9b5bdf3cc0f655e0bbd080335a95d7e96f3587da"
 
+[[package]]
+name = "block-buffer"
+version = "0.10.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3078c7629b62d3f0439517fa394996acacc5cbc91c5a20d8c658e77abd503a71"
+dependencies = [
+ "generic-array",
+]
+
 [[package]]
 name = "block-buffer"
 version = "0.12.1"
@@ -221,7 +230,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "d524456ba66e72eb8b115ff89e01e497f8e6d11d78b70b1aa13c0fbd97540a81"
 dependencies = [
  "cfg-if",
- "cpufeatures",
+ "cpufeatures 0.3.0",
  "rand_core 0.10.1",
 ]
 
@@ -286,6 +295,15 @@ dependencies = [
  "libm",
 ]
 
+[[package]]
+name = "cpufeatures"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "59ed5838eebb26a2bb2e58f6d5b5316989ae9d08bab10e0e6d103e656d1b0280"
+dependencies = [
+ "libc",
+]
+
 [[package]]
 name = "cpufeatures"
 version = "0.3.0"
@@ -329,6 +347,16 @@ version = "0.8.22"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "61803da095bee82a81bb1a452ecc25d3b2f1416d1897eb86430c6159ef717c17"
 
+[[package]]
+name = "crypto-common"
+version = "0.1.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "78c8292055d1c1df0cce5d180393dc8cce0abec0a7102adb6c7b1eef6016d60a"
+dependencies = [
+ "generic-array",
+ "typenum",
+]
+
 [[package]]
 name = "crypto-common"
 version = "0.2.2"
@@ -373,6 +401,12 @@ dependencies = [
  "syn 2.0.119",
 ]
 
+[[package]]
+name = "data-encoding"
+version = "2.11.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4583a4551df46e2792f82ceeac45e850d2e2d5debba0b91f102385cda5b11f06"
+
 [[package]]
 name = "derive_builder"
 version = "0.20.2"
@@ -404,15 +438,25 @@ dependencies = [
  "syn 2.0.119",
 ]
 
+[[package]]
+name = "digest"
+version = "0.10.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292"
+dependencies = [
+ "block-buffer 0.10.4",
+ "crypto-common 0.1.7",
+]
+
 [[package]]
 name = "digest"
 version = "0.11.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f1dd6dbb5841937940781866fa1281a1ff7bd3bf827091440879f9994983d5c2"
 dependencies = [
- "block-buffer",
+ "block-buffer 0.12.1",
  "const-oid",
- "crypto-common",
+ "crypto-common 0.2.2",
 ]
 
 [[package]]
@@ -432,6 +476,12 @@ version = "1.0.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "92773504d58c093f6de2459af4af33faa518c13451eb8f2b5698ed3d36e7c813"
 
+[[package]]
+name = "either"
+version = "1.18.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "252afb9ae5eaa683babdc6a068b3f5726eb19e05070c731f9b2a23a7c3e8ed34"
+
 [[package]]
 name = "encoding_rs"
 version = "0.8.35"
@@ -629,6 +679,16 @@ dependencies = [
  "slab",
 ]
 
+[[package]]
+name = "generic-array"
+version = "0.14.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85649ca51fd72272d7821adaf274ad91c288277713d9c18820d8499a7ff69e9a"
+dependencies = [
+ "typenum",
+ "version_check",
+]
+
 [[package]]
 name = "getrandom"
 version = "0.2.17"
@@ -807,7 +867,6 @@ dependencies = [
  "tokio",
  "tokio-rustls",
  "tower-service",
- "webpki-roots",
 ]
 
 [[package]]
@@ -1643,47 +1702,6 @@ version = "0.8.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "d6f6ff9a378485b298a5286656da665ba74413d36db0979633275d2e708145d4"
 
-[[package]]
-name = "reqwest"
-version = "0.12.28"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "eddd3ca559203180a307f12d114c268abf583f59b03cb906fd0b3ff8646c1147"
-dependencies = [
- "base64",
- "bytes",
- "futures-core",
- "futures-util",
- "http",
- "http-body",
- "http-body-util",
- "hyper",
- "hyper-rustls",
- "hyper-util",
- "js-sys",
- "log",
- "percent-encoding",
- "pin-project-lite",
- "quinn",
- "rustls",
- "rustls-pki-types",
- "serde",
- "serde_json",
- "serde_urlencoded",
- "sync_wrapper",
- "tokio",
- "tokio-rustls",
- "tokio-util",
- "tower",
- "tower-http",
- "tower-service",
- "url",
- "wasm-bindgen",
- "wasm-bindgen-futures",
- "wasm-streams 0.4.2",
- "web-sys",
- "webpki-roots",
-]
-
 [[package]]
 name = "reqwest"
 version = "0.13.4"
@@ -1722,7 +1740,7 @@ dependencies = [
  "url",
  "wasm-bindgen",
  "wasm-bindgen-futures",
- "wasm-streams 0.5.0",
+ "wasm-streams",
  "web-sys",
 ]
 
@@ -1804,7 +1822,6 @@ checksum = "0283386ce02abc0151e1761d08802dfe86c173b0b494af5cbc086574e453da06"
 dependencies = [
  "aws-lc-rs",
  "once_cell",
- "ring",
  "rustls-pki-types",
  "rustls-webpki",
  "subtle",
@@ -1996,6 +2013,17 @@ dependencies = [
  "serde",
 ]
 
+[[package]]
+name = "sha1"
+version = "0.10.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a978451301f4db1d02937a4ab3ccce137717b81826e79b7d49ffe3244a13c3b8"
+dependencies = [
+ "cfg-if",
+ "cpufeatures 0.2.17",
+ "digest 0.10.7",
+]
+
 [[package]]
 name = "sha2"
 version = "0.11.0"
@@ -2003,8 +2031,8 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "446ba717509524cb3f22f17ecc096f10f4822d76ab5c0b9822c5f9c284e825f4"
 dependencies = [
  "cfg-if",
- "cpufeatures",
- "digest",
+ "cpufeatures 0.3.0",
+ "digest 0.11.3",
 ]
 
 [[package]]
@@ -2120,9 +2148,10 @@ dependencies = [
 
 [[package]]
 name = "synapse-core-tool"
-version = "0.1.4"
+version = "0.1.5"
 dependencies = [
  "async-openai",
+ "base64",
  "chardetng",
  "encoding_rs",
  "futures-util",
@@ -2135,7 +2164,7 @@ dependencies = [
  "ratex-parser",
  "ratex-render",
  "ratex-types",
- "reqwest 0.12.28",
+ "reqwest",
  "serde",
  "serde_json",
  "thiserror 2.0.20",
@@ -2315,6 +2344,18 @@ dependencies = [
  "tokio",
 ]
 
+[[package]]
+name = "tokio-socks"
+version = "0.5.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a7e2948f60dbe26b35f2c7fb74ac2854c1fddded0fe9d7548fcc674a246f7615"
+dependencies = [
+ "either",
+ "futures-util",
+ "thiserror 1.0.69",
+ "tokio",
+]
+
 [[package]]
 name = "tokio-stream"
 version = "0.1.19"
@@ -2326,6 +2367,22 @@ dependencies = [
  "tokio",
 ]
 
+[[package]]
+name = "tokio-tungstenite"
+version = "0.28.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d25a406cddcc431a75d3d9afc6a7c0f7428d4891dd973e4d54c56b46127bf857"
+dependencies = [
+ "futures-util",
+ "log",
+ "rustls",
+ "rustls-pki-types",
+ "tokio",
+ "tokio-rustls",
+ "tungstenite",
+ "webpki-roots 0.26.11",
+]
+
 [[package]]
 name = "tokio-util"
 version = "0.7.19"
@@ -2433,6 +2490,25 @@ dependencies = [
  "core_maths",
 ]
 
+[[package]]
+name = "tungstenite"
+version = "0.28.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8628dcc84e5a09eb3d8423d6cb682965dea9133204e8fb3efee74c2a0c259442"
+dependencies = [
+ "bytes",
+ "data-encoding",
+ "http",
+ "httparse",
+ "log",
+ "rand 0.9.5",
+ "rustls",
+ "rustls-pki-types",
+ "sha1",
+ "thiserror 2.0.20",
+ "utf-8",
+]
+
 [[package]]
 name = "typenum"
 version = "1.20.1"
@@ -2484,6 +2560,12 @@ dependencies = [
  "serde",
 ]
 
+[[package]]
+name = "utf-8"
+version = "0.7.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "09cc8ee72d2a9becf2f2febe0205bbed8fc6615b7cb429ad062dc7b7ddd036a9"
+
 [[package]]
 name = "utf8_iter"
 version = "1.0.4"
@@ -2585,19 +2667,6 @@ dependencies = [
  "unicode-ident",
 ]
 
-[[package]]
-name = "wasm-streams"
-version = "0.4.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "15053d8d85c7eccdbefef60f06769760a563c7f0a9d6902a13d35c7800b0ad65"
-dependencies = [
- "futures-util",
- "js-sys",
- "wasm-bindgen",
- "wasm-bindgen-futures",
- "web-sys",
-]
-
 [[package]]
 name = "wasm-streams"
 version = "0.5.0"
@@ -2640,6 +2709,15 @@ dependencies = [
  "rustls-pki-types",
 ]
 
+[[package]]
+name = "webpki-roots"
+version = "0.26.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "521bc38abb08001b01866da9f51eb7c5d647a19260e00054a8c7fd5f9e57f7a9"
+dependencies = [
+ "webpki-roots 1.0.9",
+]
+
 [[package]]
 name = "webpki-roots"
 version = "1.0.9"

{synapse_cli_agent-0.1.39 → synapse_cli_agent-0.1.41}/rust/synapse-core-tool/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "synapse-core-tool"
-version = "0.1.4"
+version = "0.1.5"
 edition = "2021"
 rust-version = "1.80"
 license = "Apache-2.0"
@@ -12,7 +12,8 @@ name = "synapse_core_tool"
 crate-type = ["cdylib", "rlib"]
 
 [dependencies]
-async-openai = { version = "0.41", features = ["chat-completion", "byot"] }
+async-openai = { git = "https://github.com/alex8224/async-openai.git", rev = "c56301b", features = ["chat-completion", "responses", "byot", "responses-ws"] }
+base64 = "0.22"
 chardetng = "0.1"
 encoding_rs = "0.8"
 futures-util = "0.3"
@@ -25,7 +26,7 @@ ratex-layout = "=0.1.14"
 ratex-parser = "=0.1.14"
 ratex-render = { version = "=0.1.14", features = ["embed-fonts"] }
 ratex-types = "=0.1.14"
-reqwest = { version = "0.12", default-features = false, features = ["json", "stream", "rustls-tls"] }
+reqwest = { version = "0.13", default-features = false, features = ["json", "stream", "rustls", "socks"] }
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 thiserror = "2.0"

{synapse_cli_agent-0.1.39 → synapse_cli_agent-0.1.41}/rust/synapse-core-tool/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "synapse-core-tool"
-version = "0.1.4"
+version = "0.1.5"
 description = "Native filesystem tools for Synapse"
 requires-python = ">=3.12"
 license = { text = "Apache-2.0" }

{synapse_cli_agent-0.1.39 → synapse_cli_agent-0.1.41}/rust/synapse-core-tool/src/file_tools.rs

@@ -1,6 +1,8 @@
-use std::fs;
+use std::fs::{self, File};
+use std::io::Read;
 use std::path::{Path, PathBuf};
 
+use base64::Engine;
 use pyo3::exceptions::{PyOSError, PyValueError};
 use pyo3::prelude::*;
 use pyo3::types::PyDict;
@@ -10,6 +12,17 @@ use crate::file_access::{read_text_detect, write_text_as};
 const MAX_READ_LIMIT: usize = 10_000;
 const MAX_READ_LINE_CHARS: usize = 1_200;
 const MAX_READ_OUTPUT_CHARS: usize = 12_000;
+const MAX_BINARY_READ_BYTES: u64 = 10 * 1024 * 1024;
+
+fn binary_file_type(path: &Path) -> Option<&'static str> {
+    match path.extension()?.to_str()?.to_ascii_lowercase().as_str() {
+        "png" | "jpeg" | "jpg" | "webp" | "gif" | "heic" | "heif" => Some("image"),
+        "mp4" | "mpeg" | "mov" | "avi" | "flv" | "mpg" | "webm" | "wmv" | "3gpp" => Some("video"),
+        "wav" | "mp3" | "aiff" | "aac" | "ogg" | "flac" => Some("audio"),
+        "pdf" | "ppt" | "pptx" => Some("file"),
+        _ => None,
+    }
+}
 
 #[derive(Debug, thiserror::Error)]
 enum ExactEditError {
@@ -124,6 +137,44 @@ pub(crate) fn read(
         return Ok(result.unbind());
     }
 
+    if let Some(file_type) = binary_file_type(&path) {
+        let mut file = File::open(&path).map_err(|error| io_error("open file", &path, error))?;
+        let size = file
+            .metadata()
+            .map_err(|error| io_error("inspect file", &path, error))?
+            .len();
+        if size > MAX_BINARY_READ_BYTES {
+            return Err(PyValueError::new_err(format!(
+                "binary file exceeds the {} byte read limit: {}",
+                MAX_BINARY_READ_BYTES,
+                path.display()
+            )));
+        }
+        let mut bytes = Vec::new();
+        file.by_ref()
+            .take(MAX_BINARY_READ_BYTES + 1)
+            .read_to_end(&mut bytes)
+            .map_err(|error| io_error("read file", &path, error))?;
+        if bytes.len() as u64 > MAX_BINARY_READ_BYTES {
+            return Err(PyValueError::new_err(format!(
+                "binary file grew beyond the {} byte read limit: {}",
+                MAX_BINARY_READ_BYTES,
+                path.display()
+            )));
+        }
+        let content = base64::engine::general_purpose::STANDARD.encode(bytes);
+        result.set_item("kind", file_type)?;
+        result.set_item("output", py.None())?;
+        result.set_item("content", content)?;
+        result.set_item("encoding", "base64")?;
+        result.set_item("truncated", false)?;
+        result.set_item("start_line", py.None())?;
+        result.set_item("end_line", py.None())?;
+        result.set_item("total_lines", py.None())?;
+        result.set_item("total_entries", py.None())?;
+        return Ok(result.unbind());
+    }
+
     let (content, _) =
         read_text_detect(&path).map_err(|error| io_error("read file", &path, error))?;
     let lines = content.split_inclusive('\n').collect::<Vec<_>>();
@@ -147,6 +198,7 @@ pub(crate) fn read(
     result.set_item("kind", "file")?;
     result.set_item("output", output)?;
     result.set_item("content", selected)?;
+    result.set_item("encoding", "utf-8")?;
     result.set_item(
         "truncated",
         end < total_lines || output_truncated || line_truncated,
@@ -354,6 +406,14 @@ pub(crate) fn patch(py: Python<'_>, file_path: &str, patch: &str) -> PyResult<Py
 mod tests {
     use super::*;
 
+    #[test]
+    fn binary_file_type_is_case_insensitive() {
+        assert_eq!(binary_file_type(Path::new("shot.PNG")), Some("image"));
+        assert_eq!(binary_file_type(Path::new("clip.MP4")), Some("video"));
+        assert_eq!(binary_file_type(Path::new("notes.txt")), None);
+        assert_eq!(MAX_BINARY_READ_BYTES, 10 * 1024 * 1024);
+    }
+
     #[test]
     fn exact_edit_accepts_crlf_candidates() {
         let (edited, count) =