code-analysis-client 1.6.45__tar.gz → 1.6.53__tar.gz

{code_analysis_client-1.6.45 → code_analysis_client-1.6.53}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: code-analysis-client
-Version: 1.6.45
+Version: 1.6.53
 Summary: Async JSON-RPC client for the code-analysis MCP server (mcp-proxy-adapter JsonRpcClient)
 Author-email: Vasiliy Zdanovskiy <vasilyvz@gmail.com>
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: mcp-proxy-adapter>=8.10.15
+Requires-Dist: mcp-proxy-adapter>=8.10.19
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.25.0; extra == "dev"
@@ -84,13 +84,18 @@ from the server registry. Use the facades below or generic `call` / `commands.*`
 | Facade | Property | Server commands |
 |--------|----------|-----------------|
 | Client DB sessions + transfer | `client.file_sessions` | `session_*`, `subordinate_session_*`, `project_file_transfer_*`, `project_file_advisory_lock_batch` |
-| Universal edit sessions | `client.universal_files` | `universal_file_open`, `edit`, `write`, `close`, `preview` |
+| Universal file preview | `client.universal_files` | `universal_file_preview` (read-only) |
 | Any registered command | `client.call` / `client.commands.<name>` | schema from live `help()` |
 
 Canonical command lists: `code_analysis_client.server_api` — exported as
 `FILE_SESSION_COMMANDS`, `FILE_SESSION_FACADE_METHODS`, `CLIENT_FACADE_COMMANDS`,
 `REMOVED_COMMANDS`.
 
+**Scope boundary:** this client manipulates files only as whole units — transfer,
+locks, sessions, and structured read-only preview — and analyzes them. Content
+editing (open/edit/write/close draft sessions) is not served by this project's
+code-analysis server; use the ai-editor client for that.
+
 Sync checks (in-process registry):
 
 ```bash
@@ -110,7 +115,7 @@ documentation** is embedded in the **module docstrings** of those Python files
 |--------|---------|
 | `run_all_examples.py` | Full API tour + runs all live sibling scripts |
 | `ex_minimal_validated.py` | Smallest validated RPC example |
-| `ex_universal_files.py` | All `UniversalFileClient` methods (open/edit/write/close/preview) |
+| `ex_universal_files.py` | `UniversalFileClient.preview` (read-only structured preview) |
 | `ex_session_view_subordinates.py` | `session_view` and subordinate CRUD |
 | `ex_file_sessions.py` | Sessions, locks, transfer roundtrip |
 | `ex_config_only.py` | Parse `config.json` without TCP |

{code_analysis_client-1.6.45 → code_analysis_client-1.6.53}/README.md

@@ -72,13 +72,18 @@ from the server registry. Use the facades below or generic `call` / `commands.*`
 | Facade | Property | Server commands |
 |--------|----------|-----------------|
 | Client DB sessions + transfer | `client.file_sessions` | `session_*`, `subordinate_session_*`, `project_file_transfer_*`, `project_file_advisory_lock_batch` |
-| Universal edit sessions | `client.universal_files` | `universal_file_open`, `edit`, `write`, `close`, `preview` |
+| Universal file preview | `client.universal_files` | `universal_file_preview` (read-only) |
 | Any registered command | `client.call` / `client.commands.<name>` | schema from live `help()` |
 
 Canonical command lists: `code_analysis_client.server_api` — exported as
 `FILE_SESSION_COMMANDS`, `FILE_SESSION_FACADE_METHODS`, `CLIENT_FACADE_COMMANDS`,
 `REMOVED_COMMANDS`.
 
+**Scope boundary:** this client manipulates files only as whole units — transfer,
+locks, sessions, and structured read-only preview — and analyzes them. Content
+editing (open/edit/write/close draft sessions) is not served by this project's
+code-analysis server; use the ai-editor client for that.
+
 Sync checks (in-process registry):
 
 ```bash
@@ -98,7 +103,7 @@ documentation** is embedded in the **module docstrings** of those Python files
 |--------|---------|
 | `run_all_examples.py` | Full API tour + runs all live sibling scripts |
 | `ex_minimal_validated.py` | Smallest validated RPC example |
-| `ex_universal_files.py` | All `UniversalFileClient` methods (open/edit/write/close/preview) |
+| `ex_universal_files.py` | `UniversalFileClient.preview` (read-only structured preview) |
 | `ex_session_view_subordinates.py` | `session_view` and subordinate CRUD |
 | `ex_file_sessions.py` | Sessions, locks, transfer roundtrip |
 | `ex_config_only.py` | Parse `config.json` without TCP |

{code_analysis_client-1.6.45 → code_analysis_client-1.6.53}/code_analysis_client/client.py

@@ -128,7 +128,7 @@ class CodeAnalysisAsyncClient:
 
     @property
     def universal_files(self) -> UniversalFileClient:
-        """Universal edit-session workflow (``universal_file_*`` commands)."""
+        """Read-only structured preview (``universal_file_preview`` command)."""
         return UniversalFileClient(self)
 
     async def get_command_schema(

code_analysis_client-1.6.53/code_analysis_client/universal_file.py

@@ -0,0 +1,50 @@
+"""
+Read-only structured file preview on top of :class:`CodeAnalysisAsyncClient`.
+
+Wraps ``universal_file_preview`` only. Content editing (open/edit/write/close
+sessions) is not served by this project's code-analysis server; that workflow
+lives in the ai-editor client instead.
+
+Author: Vasiliy Zdanovskiy
+email: vasilyvz@gmail.com
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Dict
+
+from code_analysis_client.responses import unwrap_command_result
+
+if TYPE_CHECKING:
+    from code_analysis_client.client import CodeAnalysisAsyncClient
+
+
+class UniversalFileClient:
+    """Read-only structured preview for project files.
+
+    Wraps ``universal_file_preview`` (the only ``universal_file_*`` command
+    still registered on the code-analysis server). Content editing belongs to
+    the ai-editor client, not this package.
+    """
+
+    __slots__ = ("_client",)
+
+    def __init__(self, client: CodeAnalysisAsyncClient) -> None:
+        """Store the async client used for universal file preview commands."""
+        self._client = client
+
+    async def preview(
+        self,
+        project_id: str,
+        file_path: str,
+        **kwargs: Any,
+    ) -> Dict[str, Any]:
+        """Structured read-only preview (``universal_file_preview``)."""
+        params: Dict[str, Any] = {
+            "project_id": project_id,
+            "file_path": file_path,
+        }
+        params.update(kwargs)
+        return unwrap_command_result(
+            await self._client.call_validated("universal_file_preview", params)
+        )

code_analysis_client-1.6.53/code_analysis_client/version.txt

@@ -0,0 +1 @@
+1.6.53

{code_analysis_client-1.6.45 → code_analysis_client-1.6.53}/code_analysis_client.egg-info/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: code-analysis-client
-Version: 1.6.45
+Version: 1.6.53
 Summary: Async JSON-RPC client for the code-analysis MCP server (mcp-proxy-adapter JsonRpcClient)
 Author-email: Vasiliy Zdanovskiy <vasilyvz@gmail.com>
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: mcp-proxy-adapter>=8.10.15
+Requires-Dist: mcp-proxy-adapter>=8.10.19
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.25.0; extra == "dev"
@@ -84,13 +84,18 @@ from the server registry. Use the facades below or generic `call` / `commands.*`
 | Facade | Property | Server commands |
 |--------|----------|-----------------|
 | Client DB sessions + transfer | `client.file_sessions` | `session_*`, `subordinate_session_*`, `project_file_transfer_*`, `project_file_advisory_lock_batch` |
-| Universal edit sessions | `client.universal_files` | `universal_file_open`, `edit`, `write`, `close`, `preview` |
+| Universal file preview | `client.universal_files` | `universal_file_preview` (read-only) |
 | Any registered command | `client.call` / `client.commands.<name>` | schema from live `help()` |
 
 Canonical command lists: `code_analysis_client.server_api` — exported as
 `FILE_SESSION_COMMANDS`, `FILE_SESSION_FACADE_METHODS`, `CLIENT_FACADE_COMMANDS`,
 `REMOVED_COMMANDS`.
 
+**Scope boundary:** this client manipulates files only as whole units — transfer,
+locks, sessions, and structured read-only preview — and analyzes them. Content
+editing (open/edit/write/close draft sessions) is not served by this project's
+code-analysis server; use the ai-editor client for that.
+
 Sync checks (in-process registry):
 
 ```bash
@@ -110,7 +115,7 @@ documentation** is embedded in the **module docstrings** of those Python files
 |--------|---------|
 | `run_all_examples.py` | Full API tour + runs all live sibling scripts |
 | `ex_minimal_validated.py` | Smallest validated RPC example |
-| `ex_universal_files.py` | All `UniversalFileClient` methods (open/edit/write/close/preview) |
+| `ex_universal_files.py` | `UniversalFileClient.preview` (read-only structured preview) |
 | `ex_session_view_subordinates.py` | `session_view` and subordinate CRUD |
 | `ex_file_sessions.py` | Sessions, locks, transfer roundtrip |
 | `ex_config_only.py` | Parse `config.json` without TCP |

{code_analysis_client-1.6.45 → code_analysis_client-1.6.53}/code_analysis_client.egg-info/requires.txt

@@ -1,4 +1,4 @@
-mcp-proxy-adapter>=8.10.15
+mcp-proxy-adapter>=8.10.19
 
 [dev]
 pytest>=8.0

{code_analysis_client-1.6.45 → code_analysis_client-1.6.53}/pyproject.toml

@@ -12,7 +12,7 @@ authors = [
     { name = "Vasiliy Zdanovskiy", email = "vasilyvz@gmail.com" },
 ]
 dependencies = [
-    "mcp-proxy-adapter>=8.10.15",
+    "mcp-proxy-adapter>=8.10.19",
 ]
 
 [project.optional-dependencies]

code_analysis_client-1.6.45/code_analysis_client/universal_file.py

@@ -1,130 +0,0 @@
-"""
-Universal file edit-session workflow on top of :class:`CodeAnalysisAsyncClient`.
-
-Wraps ``universal_file_open`` / ``edit`` / ``write`` / ``close`` / ``preview`` only.
-Legacy ``universal_file_read`` / ``universal_file_save`` and CST commands are not
-part of this API (see :mod:`server_api`).
-
-Author: Vasiliy Zdanovskiy
-email: vasilyvz@gmail.com
-"""
-
-from __future__ import annotations
-
-from typing import TYPE_CHECKING, Any, Dict, List, Optional
-
-from code_analysis_client.responses import unwrap_command_result
-
-if TYPE_CHECKING:
-    from code_analysis_client.client import CodeAnalysisAsyncClient
-
-
-class UniversalFileClient:
-    """Edit-session workflow for project files (open → edit → write → close).
-
-    Uses ``session_id`` from ``universal_file_open`` only. Not related to
-    client ``session_*`` commands (``session_create``, ``session_open_file``, …).
-    """
-
-    __slots__ = ("_client",)
-
-    def __init__(self, client: CodeAnalysisAsyncClient) -> None:
-        """Store the async client used for universal file workflow commands."""
-        self._client = client
-
-    async def open(
-        self,
-        project_id: str,
-        file_path: str,
-        *,
-        create: bool = False,
-        initial_content: Optional[str] = None,
-    ) -> Dict[str, Any]:
-        """Start an edit session (``universal_file_open``).
-
-        Identifies the file by ``project_id`` + ``file_path`` (not ``file_id``).
-        """
-        params: Dict[str, Any] = {
-            "project_id": project_id,
-            "file_path": file_path,
-            "create": create,
-        }
-        if initial_content is not None:
-            params["initial_content"] = initial_content
-        return unwrap_command_result(
-            await self._client.call_validated("universal_file_open", params)
-        )
-
-    async def edit(
-        self,
-        project_id: str,
-        session_id: str,
-        operations: List[Dict[str, Any]],
-    ) -> Dict[str, Any]:
-        """Apply draft mutations (``universal_file_edit``)."""
-        return unwrap_command_result(
-            await self._client.call_validated(
-                "universal_file_edit",
-                {
-                    "project_id": project_id,
-                    "session_id": session_id,
-                    "operations": operations,
-                },
-            )
-        )
-
-    async def write(
-        self,
-        project_id: str,
-        session_id: str,
-        *,
-        write_mode: str = "commit",
-    ) -> Dict[str, Any]:
-        """Persist or preview draft (``universal_file_write``).
-
-        Default ``write_mode`` is ``commit`` in this client wrapper. The server
-        default when the parameter is omitted is ``preview``. Pass
-        ``write_mode='preview'`` first to inspect the diff, then ``commit``.
-        """
-        return unwrap_command_result(
-            await self._client.call_validated(
-                "universal_file_write",
-                {
-                    "project_id": project_id,
-                    "session_id": session_id,
-                    "write_mode": write_mode,
-                },
-            )
-        )
-
-    async def close(
-        self,
-        project_id: str,
-        session_id: str,
-    ) -> Dict[str, Any]:
-        """End edit session (``universal_file_open`` session_id, not client ``session_*``)."""
-        return unwrap_command_result(
-            await self._client.call_validated(
-                "universal_file_close",
-                {
-                    "project_id": project_id,
-                    "session_id": session_id,
-                },
-            )
-        )
-
-    async def preview(
-        self,
-        project_id: str,
-        file_path: str,
-        **kwargs: Any,
-    ) -> Dict[str, Any]:
-        """Structured read-only preview (``universal_file_preview``)."""
-        params: Dict[str, Any] = {
-            "project_id": project_id,
-            "file_path": file_path,
-        }
-        params.update(kwargs)
-        return unwrap_command_result(
-            await self._client.call_validated("universal_file_preview", params)
-        )

code_analysis_client-1.6.45/code_analysis_client/version.txt

@@ -1 +0,0 @@
-1.6.45