chore(conductor): Archive track 'Add support for the deepseek api as a provider.'

mcp_client.py

@@ -229,6 +229,74 @@ def get_file_summary(path: str) -> str:
         return f"ERROR summarising '{path}': {e}"
 
 
+def get_python_skeleton(path: str) -> str:
+    """
+    Returns a skeleton of a Python file (preserving docstrings, stripping function bodies).
+    """
+    p, err = _resolve_and_check(path)
+    if err:
+        return err
+    if not p.exists():
+        return f"ERROR: file not found: {path}"
+    if not p.is_file() or p.suffix != ".py":
+        return f"ERROR: not a python file: {path}"
+    
+    try:
+        # Use mma_exec's generator if possible, or a local simplified version
+        # For now, we will use a dedicated script or just inline logic here.
+        # Given we have tree-sitter already installed in the env...
+        import tree_sitter
+        import tree_sitter_python
+        
+        code = p.read_text(encoding="utf-8")
+        PY_LANGUAGE = tree_sitter.Language(tree_sitter_python.language())
+        parser = tree_sitter.Parser(PY_LANGUAGE)
+        tree = parser.parse(bytes(code, "utf8"))
+
+        edits = []
+
+        def is_docstring(node):
+            if node.type == "expression_statement" and node.child_count > 0:
+                if node.children[0].type == "string":
+                    return True
+            return False
+
+        def walk(node):
+            if node.type == "function_definition":
+                body = node.child_by_field_name("body")
+                if body and body.type == "block":
+                    indent = " " * body.start_point.column
+                    first_stmt = None
+                    for child in body.children:
+                        if child.type != "comment":
+                            first_stmt = child
+                            break
+
+                    if first_stmt and is_docstring(first_stmt):
+                        start_byte = first_stmt.end_byte
+                        end_byte = body.end_byte
+                        if end_byte > start_byte:
+                            edits.append((start_byte, end_byte, f"\\n{indent}..."))
+                    else:
+                        start_byte = body.start_byte
+                        end_byte = body.end_byte
+                        edits.append((start_byte, end_byte, "..."))
+
+            for child in node.children:
+                walk(child)
+
+        walk(tree.root_node)
+
+        edits.sort(key=lambda x: x[0], reverse=True)
+        code_bytes = bytearray(code, "utf8")
+        for start, end, replacement in edits:
+            code_bytes[start:end] = bytes(replacement, "utf8")
+
+        return code_bytes.decode("utf8")
+    except Exception as e:
+        return f"ERROR generating skeleton for '{path}': {e}"
+
+
 
 # ------------------------------------------------------------------ web tools
 
@@ -355,7 +423,7 @@ def get_ui_performance() -> str:
 # ------------------------------------------------------------------ tool dispatch
 
 
-TOOL_NAMES = {"read_file", "list_directory", "search_files", "get_file_summary", "web_search", "fetch_url", "get_ui_performance"}
+TOOL_NAMES = {"read_file", "list_directory", "search_files", "get_file_summary", "get_python_skeleton", "web_search", "fetch_url", "get_ui_performance"}
 
 
 def dispatch(tool_name: str, tool_input: dict) -> str:
@@ -370,6 +438,8 @@ def dispatch(tool_name: str, tool_input: dict) -> str:
         return search_files(tool_input.get("path", ""), tool_input.get("pattern", "*"))
     if tool_name == "get_file_summary":
         return get_file_summary(tool_input.get("path", ""))
+    if tool_name == "get_python_skeleton":
+        return get_python_skeleton(tool_input.get("path", ""))
     if tool_name == "web_search":
         return web_search(tool_input.get("query", ""))
     if tool_name == "fetch_url":
@@ -458,6 +528,25 @@ MCP_TOOL_SPECS = [
             "required": ["path"],
         },
     },
+    {
+        "name": "get_python_skeleton",
+        "description": (
+            "Get a skeleton view of a Python file. "
+            "This returns all classes and function signatures with their docstrings, "
+            "but replaces function bodies with '...'. "
+            "Use this to understand module interfaces without reading the full implementation."
+        ),
+        "parameters": {
+            "type": "object",
+            "properties": {
+                "path": {
+                    "type": "string",
+                    "description": "Path to the .py file.",
+                }
+            },
+            "required": ["path"],
+        },
+    },
     {
         "name": "web_search",
         "description": "Search the web using DuckDuckGo. Returns the top 5 search results with titles, URLs, and snippets. Chain this with fetch_url to read specific pages.",
@@ -472,6 +561,20 @@ MCP_TOOL_SPECS = [
             "required": ["query"]
         }
     },
+    {
+        "name": "fetch_url",
+        "description": "Fetch the full text content of a URL (stripped of HTML tags). Use this after web_search to read relevant information from the web.",
+        "parameters": {
+            "type": "object",
+            "properties": {
+                "url": {
+                    "type": "string",
+                    "description": "The full URL to fetch."
+                }
+            },
+            "required": ["url"]
+        }
+    },
     {
         "name": "get_ui_performance",
         "description": "Get a snapshot of the current UI performance metrics, including FPS, Frame Time (ms), CPU usage (%), and Input Lag (ms). Use this to diagnose UI slowness or verify that your changes haven't degraded the user experience.",