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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-analysis-client
-Version: 1.6.260
+Version: 1.6.261
 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.261}/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.261}/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.261/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.261/code_analysis_client/version.txt

@@ -0,0 +1 @@
+1.6.261

{code_analysis_client-1.6.260 → code_analysis_client-1.6.261}/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.261
 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.261}/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