code-analysis-client 1.6.260__tar.gz → 1.6.262__tar.gz

{code_analysis_client-1.6.260 → code_analysis_client-1.6.262}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-analysis-client
-Version: 1.6.260
+Version: 1.6.262
 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

{code_analysis_client-1.6.260 → code_analysis_client-1.6.262}/code_analysis_client/__init__.py

@@ -10,6 +10,7 @@ from __future__ import annotations
 from pathlib import Path
 
 from code_analysis_client.client import CodeAnalysisAsyncClient
+from code_analysis_client.symbol_tree import SymbolTreeNode
 from code_analysis_client.commands_proxy import ValidatedCommandsProxy
 from code_analysis_client.config import (
     DEFAULT_CLIENT_ADAPTER_CONFIG,
@@ -76,6 +77,7 @@ __all__ = [
     "CST_REMOVED_COMMANDS",
     "ClientValidationError",
     "CodeAnalysisAsyncClient",
+    "SymbolTreeNode",
     "CommandFailedError",
     "FILE_SESSION_COMMANDS",
     "FILE_SESSION_FACADE_METHODS",

{code_analysis_client-1.6.260 → code_analysis_client-1.6.262}/code_analysis_client/client.py

@@ -49,11 +49,14 @@ from code_analysis_client.schema_disk_cache import (
 )
 from code_analysis_client.server_schema import fetch_command_schema_from_server
 from code_analysis_client.exceptions import ClientValidationError
+from code_analysis_client.symbol_tree import SymbolTreeNode
 from code_analysis_client.validation import (
     prepare_params_for_schema,
     validate_params_against_schema,
 )
 
+_SYMBOL_TREE_OMITTED: Any = object()
+
 
 def _remote_invalid_params_as_client_validation(
     error: ClientRemoteResponseError,
@@ -182,6 +185,39 @@ class CodeAnalysisAsyncClient:
         self._command_schema_cache.clear()
         clear_cached_schemas(self._rpc.base_url)
 
+    async def symbol_tree(
+        self,
+        *,
+        project_id: str,
+        file_path: str | None = _SYMBOL_TREE_OMITTED,
+        source: str | None = _SYMBOL_TREE_OMITTED,
+        source_name: str | None = _SYMBOL_TREE_OMITTED,
+        worktree_name: str | None = _SYMBOL_TREE_OMITTED,
+        options: dict[str, object] | None = _SYMBOL_TREE_OMITTED,
+    ) -> list[SymbolTreeNode]:
+        """Read declarations without saving raw source or changing project state.
+
+        Select exactly one of ``file_path`` and ``source``. Raw source requires
+        ``source_name``; its extension selects the plugin. Domain failures retain
+        the normal ``CommandFailedError`` result; validation uses
+        ``ClientValidationError``.
+        """
+        params: dict[str, Any] = {"project_id": project_id}
+        for key, value in (
+            ("file_path", file_path),
+            ("source", source),
+            ("source_name", source_name),
+            ("worktree_name", worktree_name),
+            ("options", options),
+        ):
+            if value is not _SYMBOL_TREE_OMITTED:
+                params[key] = value
+        result = await self.call("symbol_tree", params)
+        data = result.get("data")
+        if not isinstance(data, list):
+            raise RuntimeError("symbol_tree returned a non-list result")
+        return data
+
     @property
     def file_sessions(self) -> FileSessionClient:
         """Session workflow: ``session_*``, ``subordinate_session_*``, transfer, advisory locks."""

{code_analysis_client-1.6.260 → code_analysis_client-1.6.262}/code_analysis_client/exceptions.py

@@ -20,7 +20,7 @@ class ClientValidationError(ValueError):
     ``SESSION_OPEN_IN_EDITOR``) and ``details`` is the server's error details object.
     """
 
-    code = "VALIDATION_ERROR"
+    code: str | int = "VALIDATION_ERROR"
 
     def __init__(
         self,
@@ -28,7 +28,7 @@ class ClientValidationError(ValueError):
         *,
         field: Optional[str] = None,
         details: Optional[Dict[str, Any]] = None,
-        code: Optional[str] = None,
+        code: str | int | None = None,
     ) -> None:
         """Initialize with optional field, details payload and the server error code."""
         super().__init__(message)

{code_analysis_client-1.6.260 → code_analysis_client-1.6.262}/code_analysis_client/queue_wait.py

@@ -97,7 +97,7 @@ def remote_error_text(message: Any, code: Any) -> str:
 
 
 def invalid_params_error(
-    message: str, data: Any, *, code: Optional[str] = None
+    message: str, data: Any, *, code: str | int = -32602
 ) -> ClientValidationError:
     """Build the :class:`ClientValidationError` for a server refusal of a command's parameters.
 
@@ -105,7 +105,7 @@ def invalid_params_error(
     failed job (``job_failure``) and a refused command-session open with the server's own error
     code (``map_adapter_error``), so ``code`` / ``field`` / ``details`` have one shape: ``details``
     is the server's error ``data`` object, ``field`` its ``field`` entry (else ``"command"``),
-    ``code`` ``VALIDATION_ERROR`` unless the server named its own code.
+    ``code`` retains JSON-RPC ``-32602`` unless the server named its own code.
     """
     payload = data if isinstance(data, dict) else {}
     field = payload.get("field")

code_analysis_client-1.6.262/code_analysis_client/symbol_tree.py

@@ -0,0 +1,13 @@
+"""The uniform recursive declaration-tree result."""
+
+from __future__ import annotations
+
+from typing import TypedDict
+
+
+class SymbolTreeNode(TypedDict):
+    """One declaration; kinds belong to language plugins."""
+
+    name: str
+    kind: str
+    children: list[SymbolTreeNode]

code_analysis_client-1.6.262/code_analysis_client/version.txt

@@ -0,0 +1 @@
+1.6.262

{code_analysis_client-1.6.260 → code_analysis_client-1.6.262}/code_analysis_client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-analysis-client
-Version: 1.6.260
+Version: 1.6.262
 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

{code_analysis_client-1.6.260 → code_analysis_client-1.6.262}/code_analysis_client.egg-info/SOURCES.txt

@@ -13,6 +13,7 @@ code_analysis_client/responses.py
 code_analysis_client/schema_disk_cache.py
 code_analysis_client/server_api.py
 code_analysis_client/server_schema.py
+code_analysis_client/symbol_tree.py
 code_analysis_client/universal_file.py
 code_analysis_client/validation.py
 code_analysis_client/vectorizer_state.py

code_analysis_client-1.6.260/code_analysis_client/version.txt

@@ -1 +0,0 @@
-1.6.260