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

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

@@ -8,6 +8,14 @@ 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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: synapse-cli-agent
-Version: 0.1.40
+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.40 → synapse_cli_agent-0.1.41}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "synapse-cli-agent"
-version = "0.1.40"
+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.40 → synapse_cli_agent-0.1.41}/src/synapse/app/agent.py

@@ -483,10 +483,17 @@ def build_coding_agent(
                     from synapse.integrations.mcp_client import get_mcp_pool_registry
 
                     _pool, mcp_result = get_mcp_pool_registry().acquire(
-                        mcp_pool_key, servers=servers, enabled=True
+                        mcp_pool_key,
+                        servers=servers,
+                        enabled=True,
+                        workspace_root=settings.workspace,
                     )
                 else:
-                    mcp_result = load_mcp_tools(servers, enabled=True)
+                    mcp_result = load_mcp_tools(
+                        servers,
+                        enabled=True,
+                        workspace_root=settings.workspace,
+                    )
             tools.extend(mcp_result.tools)
             build_coding_agent.last_mcp_warnings = list(mcp_result.warnings)  # type: ignore[attr-defined]
             build_coding_agent.last_mcp_servers = list(mcp_result.servers)  # type: ignore[attr-defined]

{synapse_cli_agent-0.1.40 → synapse_cli_agent-0.1.41}/src/synapse/integrations/mcp_client.py

@@ -375,9 +375,14 @@ class _LiveServer:
 class McpSessionPool:
     """Process-local pool of live MCP ClientSessions."""
 
-    def __init__(self) -> None:
+    def __init__(self, *, workspace_root: Path | None = None) -> None:
         self._loop = _LoopThread()
         self._servers: dict[str, _LiveServer] = {}
+        # MCP workspace-roots capability: when set, the client declares this
+        # directory as a root to each server so file-writing tools (e.g. CDP
+        # screenshots) may write inside the project workspace instead of being
+        # restricted to the OS temp directory when no roots are configured.
+        self._workspace_root = Path(workspace_root).resolve() if workspace_root else None
         self._closed = False
         self._follow_active_pool = False
         self.warnings: list[str] = []
@@ -386,6 +391,21 @@ class McpSessionPool:
         # server_name → list of raw tool names (before prefix / filtering)
         self.discovered_tools: dict[str, list[str]] = {}
 
+    async def _list_roots(self, context: Any) -> Any:
+        """Return the project workspace as an MCP root (workspace-roots capability)."""
+        from mcp import types as _mcp_types
+
+        if self._workspace_root is None:
+            return _mcp_types.ListRootsResult(roots=[])
+        return _mcp_types.ListRootsResult(
+            roots=[
+                _mcp_types.Root(
+                    uri=self._workspace_root.as_uri(),
+                    name="workspace",
+                )
+            ]
+        )
+
     @property
     def server_names(self) -> list[str]:
         return sorted(self._servers)
@@ -443,7 +463,13 @@ class McpSessionPool:
         try:
             read, write = await transport_cm.__aenter__()
             transport_entered = True
-            session_cm = ClientSession(read, write)
+            session_cm = ClientSession(
+                read,
+                write,
+                list_roots_callback=self._list_roots
+                if self._workspace_root is not None
+                else None,
+            )
             session = await session_cm.__aenter__()
             session_entered = True
             await session.initialize()
@@ -489,7 +515,13 @@ class McpSessionPool:
         read, write = streams[0], streams[1]
         from mcp import ClientSession
 
-        session_cm = ClientSession(read, write)
+        session_cm = ClientSession(
+            read,
+            write,
+            list_roots_callback=self._list_roots
+            if self._workspace_root is not None
+            else None,
+        )
         session = await session_cm.__aenter__()
         await session.initialize()
         return _LiveServer(
@@ -672,6 +704,7 @@ class McpPoolRegistry:
         *,
         servers: list[Any],
         enabled: bool = True,
+        workspace_root: Path | None = None,
     ) -> tuple[McpSessionPool, McpLoadResult]:
         """Return an existing pool for ``key`` or open a new one."""
         with self._lock:
@@ -684,7 +717,7 @@ class McpPoolRegistry:
                     tool_names=list(existing.tool_names),
                     pool=existing,
                 )
-        pool = McpSessionPool()
+        pool = McpSessionPool(workspace_root=workspace_root)
         result = pool.load(servers) if enabled and servers else McpLoadResult(
             tools=[], warnings=[], servers=[], tool_names=[], pool=pool
         )
@@ -751,6 +784,7 @@ def load_mcp_tools(
     *,
     enabled: bool = True,
     reuse_pool: bool = True,
+    workspace_root: Path | None = None,
 ) -> McpLoadResult:
     """Synchronously load tools from configured MCP servers.
 
@@ -775,7 +809,7 @@ def load_mcp_tools(
         except Exception:  # noqa: BLE001
             pass
 
-    pool = McpSessionPool()
+    pool = McpSessionPool(workspace_root=workspace_root)
     pool._follow_active_pool = True  # noqa: SLF001 - legacy active-pool proxy contract
     try:
         result = pool.load(servers)

{synapse_cli_agent-0.1.40 → synapse_cli_agent-0.1.41}/tests/test_slash_and_mcp.py

@@ -533,7 +533,7 @@ def test_mcp_stdio_uses_devnull_when_stderr_descriptor_is_invalid(monkeypatch):
 
     monkeypatch.setattr(sys, "stderr", InvalidStderr())
     monkeypatch.setattr(mcp.client.stdio, "stdio_client", fake_stdio_client)
-    monkeypatch.setattr(mcp, "ClientSession", lambda read, write: Session())
+    monkeypatch.setattr(mcp, "ClientSession", lambda read, write, **kwargs: Session())
     pool = McpSessionPool()
     try:
         live = pool._loop.run(
@@ -548,6 +548,72 @@ def test_mcp_stdio_uses_devnull_when_stderr_descriptor_is_invalid(monkeypatch):
     assert captured["errlog"].closed is True
 
 
+def test_mcp_pool_declares_workspace_roots(monkeypatch):
+    from pathlib import Path
+
+    import mcp
+    import mcp.client.stdio
+
+    from synapse.integrations.mcp_client import McpServerConfig, McpSessionPool
+
+    class TransportContext:
+        async def __aenter__(self):
+            return object(), object()
+
+        async def __aexit__(self, *args):
+            return None
+
+    class Session:
+        async def __aenter__(self):
+            return self
+
+        async def __aexit__(self, *args):
+            return None
+
+        async def initialize(self):
+            return None
+
+    captured: dict[str, object] = {}
+
+    def fake_stdio_client(params, errlog):
+        return TransportContext()
+
+    def fake_client_session(read, write, **kwargs):
+        captured["list_roots_callback"] = kwargs.get("list_roots_callback")
+        return Session()
+
+    monkeypatch.setattr(mcp.client.stdio, "stdio_client", fake_stdio_client)
+    monkeypatch.setattr(mcp, "ClientSession", fake_client_session)
+
+    ws = Path.cwd().resolve() / "mcp_roots_ws"
+    pool = McpSessionPool(workspace_root=ws)
+    try:
+        pool._loop.run(
+            pool._open_stdio(McpServerConfig(name="demo", command="demo-server"))
+        )
+        callback = captured.get("list_roots_callback")
+        assert callback is not None, (
+            "roots callback should be passed when workspace_root is set"
+        )
+        result = pool._loop.run(callback(None))
+        assert result.roots[0].name == "workspace"
+        assert str(result.roots[0].uri) == ws.as_uri()
+    finally:
+        pool.close()
+
+    # Without a workspace root, no roots callback is passed (SDK keeps default,
+    # so the roots capability is not advertised).
+    captured.clear()
+    pool2 = McpSessionPool()
+    try:
+        pool2._loop.run(
+            pool2._open_stdio(McpServerConfig(name="demo", command="demo-server"))
+        )
+    finally:
+        pool2.close()
+    assert captured.get("list_roots_callback") is None
+
+
 def test_mcp_open_http_and_stdio_branches_selected():
     from synapse.integrations.mcp_client import McpServerConfig, McpSessionPool
 

{synapse_cli_agent-0.1.40 → synapse_cli_agent-0.1.41}/uv.lock

@@ -2428,7 +2428,7 @@ dev = [
 
 [[package]]
 name = "synapse-core-tool"
-version = "0.1.4"
+version = "0.1.5"
 source = { directory = "rust/synapse-core-tool" }
 
 [[package]]

synapse_cli_agent-0.1.40/release_body.md

@@ -1,25 +0,0 @@
-## 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.
-
----