skydeckai-code 0.1.35__py3-none-any.whl → 0.1.37__py3-none-any.whl

{skydeckai_code-0.1.35.dist-info → skydeckai_code-0.1.37.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skydeckai-code
-Version: 0.1.35
+Version: 0.1.37
 Summary: This MCP server provides a comprehensive set of tools for AI-driven Development workflows including file operations, code analysis, multi-language execution, web content fetching with HTML-to-markdown conversion, multi-engine web search, code content searching, and system information retrieval.
 Project-URL: Homepage, https://github.com/skydeckai/skydeckai-code
 Project-URL: Repository, https://github.com/skydeckai/skydeckai-code
@@ -16,8 +16,6 @@ Requires-Dist: mcp>=1.6.0
 Requires-Dist: mss>=10.0.0
 Requires-Dist: pillow>=11.1.0
 Requires-Dist: psutil>=7.0.0
-Requires-Dist: pygetwindow>=0.0.9
-Requires-Dist: pyobjc-framework-quartz>=11.0
 Requires-Dist: requests>=2.32.3
 Requires-Dist: tree-sitter-c-sharp>=0.23.1
 Requires-Dist: tree-sitter-cpp>=0.23.4
@@ -31,6 +29,10 @@ Requires-Dist: tree-sitter-ruby>=0.23.1
 Requires-Dist: tree-sitter-rust==0.23.2
 Requires-Dist: tree-sitter-typescript>=0.23.2
 Requires-Dist: tree-sitter>=0.24.0
+Provides-Extra: macos
+Requires-Dist: pyobjc-framework-quartz>=11.0; extra == 'macos'
+Provides-Extra: windows
+Requires-Dist: pygetwindow>=0.0.9; extra == 'windows'
 Description-Content-Type: text/markdown
 
 # SkyDeckAI Code
@@ -76,7 +78,6 @@ If you're using SkyDeck AI Helper app, you can search for "SkyDeckAI Code" and i
 -   File system operations (read, write, edit, move, copy, delete)
 -   Directory management and traversal
 -   Multi-language code analysis using tree-sitter
--   Code linting and issue detection for Python and JavaScript/TypeScript
 -   Code content searching with regex pattern matching
 -   Multi-language code execution with safety measures
 -   Web content fetching from APIs and websites with HTML-to-markdown conversion
@@ -86,31 +87,67 @@ If you're using SkyDeck AI Helper app, you can search for "SkyDeckAI Code" and i
 -   Screenshot and screen context tools
 -   Image handling tools
 
-## Available Tools
+## Available Tools (26)
+
+| Category         | Tool Name                  | Description                                  |
+| ---------------- | -------------------------- | -------------------------------------------- |
+| **File System**  | `get_allowed_directory`    | Get the current working directory path       |
+|                  | `update_allowed_directory` | Change the working directory                 |
+|                  | `create_directory`         | Create a new directory or nested directories |
+|                  | `write_file`               | Create or overwrite a file with new content  |
+|                  | `edit_file`                | Make line-based edits to a text file         |
+|                  | `read_file`                | Read the contents of one or more files       |
+|                  | `list_directory`           | Get listing of files and directories         |
+|                  | `move_file`                | Move or rename a file or directory           |
+|                  | `copy_file`                | Copy a file or directory to a new location   |
+|                  | `search_files`             | Search for files matching a name pattern     |
+|                  | `delete_file`              | Delete a file or empty directory             |
+|                  | `get_file_info`            | Get detailed file metadata                   |
+|                  | `directory_tree`           | Get a recursive tree view of directories     |
+|                  | `read_image_file`          | Read an image file as base64 data            |
+| **Code Tools**   | `codebase_mapper`          | Analyze code structure across files          |
+|                  | `search_code`              | Find text patterns in code files             |
+|                  | `execute_code`             | Run code in various languages                |
+|                  | `execute_shell_script`     | Run shell/bash scripts                       |
+| **Web Tools**    | `web_fetch`                | Get content from a URL                       |
+|                  | `web_search`               | Perform a web search                         |
+| **Screen Tools** | `capture_screenshot`       | Take a screenshot of screen or window        |
+|                  | `get_active_apps`          | List running applications                    |
+|                  | `get_available_windows`    | List all open windows                        |
+| **System**       | `get_system_info`          | Get detailed system information              |
+| **Utility**      | `batch_tools`              | Run multiple tool operations together        |
+|                  | `think`                    | Document reasoning without making changes    |
+
+## Detailed Tool Documentation
 
 ### Basic File Operations
 
-| Tool                | Parameters                                               | Returns                                       |
-| ------------------- | -------------------------------------------------------- | --------------------------------------------- |
-| read_file           | path: string, offset?: integer, limit?: integer          | File content (whole or partial)               |
-| read_multiple_files | paths: string[]                                          | Multiple file contents with headers           |
-| write_file          | path: string, content: string                            | Success confirmation                          |
-| move_file           | source: string, destination: string                      | Success confirmation                          |
-| copy_file           | source: string, destination: string, recursive?: boolean | Success confirmation                          |
-| delete_file         | path: string                                             | Success confirmation                          |
-| get_file_info       | path: string                                             | File metadata (size, timestamps, permissions) |
+| Tool          | Parameters                                                 | Returns                                       |
+| ------------- | ---------------------------------------------------------- | --------------------------------------------- |
+| read_file     | files: [{path: string, offset?: integer, limit?: integer}] | File content (single or multiple files)       |
+| write_file    | path: string, content: string                              | Success confirmation                          |
+| move_file     | source: string, destination: string                        | Success confirmation                          |
+| copy_file     | source: string, destination: string, recursive?: boolean   | Success confirmation                          |
+| delete_file   | path: string                                               | Success confirmation                          |
+| get_file_info | path: string                                               | File metadata (size, timestamps, permissions) |
 
-Common usage:
+**CLI Usage:**
 
 ```bash
 # Read entire file
-skydeckai-code-cli --tool read_file --args '{"path": "src/main.py"}'
+skydeckai-code-cli --tool read_file --args '{"files": [{"path": "src/main.py"}]}'
 
 # Read 10 lines starting from line 20
-skydeckai-code-cli --tool read_file --args '{"path": "src/main.py", "offset": 20, "limit": 10}'
+skydeckai-code-cli --tool read_file --args '{"files": [{"path": "src/main.py", "offset": 20, "limit": 10}]}'
 
 # Read from line 50 to the end of the file
-skydeckai-code-cli --tool read_file --args '{"path": "src/main.py", "offset": 50}'
+skydeckai-code-cli --tool read_file --args '{"files": [{"path": "src/main.py", "offset": 50}]}'
+
+# Read multiple files with different line ranges
+skydeckai-code-cli --tool read_file --args '{"files": [
+  {"path": "src/main.py", "offset": 1, "limit": 10},
+  {"path": "README.md"}
+]}'
 
 # Write file
 skydeckai-code-cli --tool write_file --args '{"path": "output.txt", "content": "Hello World"}'
@@ -171,7 +208,7 @@ Generates complete directory structure:
 
 Returns: JSON tree structure of directory contents.
 
-Common usage:
+**CLI Usage:**
 
 ```bash
 # List directory
@@ -215,7 +252,7 @@ Supported Languages:
 -   C# (.cs)
 -   Kotlin (.kt, .kts)
 
-**Example Usage:**
+**CLI Usage:**
 
 ```bash
 # Map the entire codebase structure
@@ -258,7 +295,7 @@ Matching lines grouped by file with line numbers, sorted by file modification ti
 
 This tool uses ripgrep when available for optimal performance, with a Python fallback implementation. It's ideal for finding specific code patterns like function declarations, imports, variable usages, or error handling.
 
-**Example Usage:**
+**CLI Usage:**
 
 ```bash
 # Find function and class declarations in JavaScript files
@@ -311,6 +348,8 @@ Returns:
 
 Provides essential system information in a clean, readable format.
 
+**CLI Usage:**
+
 ```bash
 # Get system information
 skydeckai-code-cli --tool get_system_info
@@ -479,7 +518,7 @@ Response content as text with HTTP status code and size information. For binary
 
 This tool can be used to access web APIs, fetch documentation, or download content from the web while respecting size limits (10MB max) and security constraints.
 
-**Example Usage:**
+**CLI Usage:**
 
 ```bash
 # Fetch JSON from an API
@@ -527,7 +566,7 @@ A list of search results formatted in markdown, including titles, URLs, and snip
 
 This tool uses a multi-engine approach that tries different search engines with various parsing strategies to ensure reliable results. You can specify a preferred engine, but some engines may block automated access, in which case the tool will fall back to alternative engines when "auto" is selected.
 
-**Example Usage:**
+**CLI Usage:**
 
 ```bash
 # Search with default settings (auto engine selection)
@@ -601,7 +640,7 @@ This tool provides efficient execution of multiple operations in a single reques
 1. Use paths relative to the current working directory (e.g., "project/src" rather than just "src"), or
 2. Include an explicit tool invocation to change directories using `update_allowed_directory`
 
-**Example Usage:**
+**CLI Usage:**
 
 ```bash
 # Setup a new project with multiple steps in sequential order (using proper paths)
@@ -662,7 +701,7 @@ Your thoughts formatted as markdown, with a note indicating this was a thinking
 
 This tool is useful for thinking through complex problems, brainstorming solutions, or laying out implementation plans without making any actual changes. It's a great way to document your reasoning process, evaluate different approaches, or plan out a multi-step strategy before taking action.
 
-**Example Usage:**
+**CLI Usage:**
 
 ```bash
 # Analyze a bug and plan a fix
@@ -706,7 +745,7 @@ Executes code in various programming languages with safety measures and restrict
 | code | string | Yes | Code to execute |
 | timeout | integer | No | Maximum execution time (default: 5s) |
 
-**Example Usage:**
+**CLI Usage:**
 
 ```bash
 # Python example
@@ -766,7 +805,7 @@ Executes shell scripts (bash/sh) with safety measures and restrictions.
 | script | string | Yes | Shell script to execute |
 | timeout | integer | No | Maximum execution time (default: 300s, max: 600s) |
 
-**Example Usage:**
+**CLI Usage:**
 
 ```bash
 # List directory contents with details

{skydeckai_code-0.1.35.dist-info → skydeckai_code-0.1.37.dist-info}/RECORD

@@ -2,13 +2,13 @@ src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/aidd/__init__.py,sha256=c9HBWxWruCxoAqLCJqltylAwz_7xmaK3g8DKViJZs0Q,222
 src/aidd/cli.py,sha256=cLtaQJmMBfr7fHkd0dyJqpDrVTIwybL48PotniWGrFM,5031
 src/aidd/server.py,sha256=kPRyWeWkMCZjabelC65XTmzZG7yw8htMJKSfnUcKnb0,1575
-src/aidd/tools/__init__.py,sha256=MN4QEu4pvU8v45EtR63y0q5iIgt-kW0OW9soOxzjR88,3880
+src/aidd/tools/__init__.py,sha256=j1uL7WVH3xS8JTGnpSIhaz7qkc3gcxuDyvZIYP9UztI,3731
 src/aidd/tools/base.py,sha256=wHSAaGGYWM8ECmoYd7KEcmjsZRWesNQFf3zMjCKGMcc,380
 src/aidd/tools/code_analysis.py,sha256=fDpm2o_If5PsngXzHN2-ezSkPVT0ZxivLuzmHrOAmVU,33188
 src/aidd/tools/code_execution.py,sha256=HRLUR1-q1PiCXKZV5QmTknDJKsfvPvFSWZbTpYFcv7I,13703
 src/aidd/tools/code_tools.py,sha256=DQ6N34Wbz5DwUPzt6RG7jk9HF2SsWFCFn99mencHK1c,14263
 src/aidd/tools/directory_tools.py,sha256=Hxzge_ziYw_FsjYb5yF0R0dHEdvuWRsg7WsdYDG0AUg,12971
-src/aidd/tools/file_tools.py,sha256=hcqQgkIIisjpcx1sL2rgxar9AFrKLmSATT9F50Y35RE,44276
+src/aidd/tools/file_tools.py,sha256=GYzP6WxGbV1V42FlWNSuGIyiCtRp09kwF6lOZrFtq_U,43112
 src/aidd/tools/get_active_apps_tool.py,sha256=BjLF7iXSDgyAmm_gfFgAul2Gn3iX-CNVYHM7Sh4jTAI,19427
 src/aidd/tools/get_available_windows_tool.py,sha256=OVIYhItTn9u_DftOr3vPCT-R0DOFvMEEJXA6tD6gqWQ,15952
 src/aidd/tools/image_tools.py,sha256=wT3EcJAfZWcM0IsXdDfbTNjgFhKZM9nu2wHN6Mk_TTQ,5970
@@ -18,8 +18,8 @@ src/aidd/tools/screenshot_tool.py,sha256=NMO5B4UG8qfMEOMRd2YoOjtwz_oQ2y1UAGU22jV
 src/aidd/tools/state.py,sha256=RWSw0Jfsui8FqC0xsI7Ik07tAg35hRwLHa5xGBVbiI4,1493
 src/aidd/tools/system_tools.py,sha256=H4_qveKC2HA7SIbi-j4vxA0W4jYh2wfu9A6ni5wkZyA,7249
 src/aidd/tools/web_tools.py,sha256=gdsj2DEVYb_oYChItK5I1ugt2w25U7IAa5kEw9q6MVg,35534
-skydeckai_code-0.1.35.dist-info/METADATA,sha256=phlTiNYpNPCAX8oSmjaI6iuLYM_gjQbDSxQllwnayZI,29047
-skydeckai_code-0.1.35.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-skydeckai_code-0.1.35.dist-info/entry_points.txt,sha256=ZkU1spOhLEnz5MpUn4dDihVcE0DMUC6ejzbsF-eNth4,88
-skydeckai_code-0.1.35.dist-info/licenses/LICENSE,sha256=uHse04vmI6ZjW7TblegFl30X-sDyyF0-QvH8ItPca3c,10865
-skydeckai_code-0.1.35.dist-info/RECORD,,
+skydeckai_code-0.1.37.dist-info/METADATA,sha256=1YGhMWLG0ftxoyHwRaO64oi5mlSpRsXW5wh0quhcHdA,31860
+skydeckai_code-0.1.37.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+skydeckai_code-0.1.37.dist-info/entry_points.txt,sha256=ZkU1spOhLEnz5MpUn4dDihVcE0DMUC6ejzbsF-eNth4,88
+skydeckai_code-0.1.37.dist-info/licenses/LICENSE,sha256=uHse04vmI6ZjW7TblegFl30X-sDyyF0-QvH8ItPca3c,10865
+skydeckai_code-0.1.37.dist-info/RECORD,,

src/aidd/tools/__init__.py

@@ -25,12 +25,10 @@ from .file_tools import (
     handle_get_file_info,
     handle_move_file,
     handle_read_file,
-    handle_read_multiple_files,
     handle_search_files,
     handle_write_file,
     move_file_tool,
     read_file_tool,
-    read_multiple_files_tool,
     search_files_tool,
     write_file_tool,
 )
@@ -60,7 +58,6 @@ TOOL_DEFINITIONS = [
     edit_file_tool(),
     list_directory_tool(),
     read_file_tool(),
-    read_multiple_files_tool(),
     move_file_tool(),
     copy_file_tool(),
     search_files_tool(),
@@ -96,7 +93,6 @@ TOOL_HANDLERS = {
     "read_file": handle_read_file,
     "write_file": handle_write_file,
     "edit_file": handle_edit_file,
-    "read_multiple_files": handle_read_multiple_files,
     "move_file": handle_move_file,
     "copy_file": handle_copy_file,
     "search_files": handle_search_files,

src/aidd/tools/file_tools.py

@@ -17,32 +17,43 @@ from .state import state
 def read_file_tool():
     return {
         "name": "read_file",
-        "description": "Read the contents of a file from the file system. "
-                    "WHEN TO USE: When you need to examine the actual content of a single file, view source code, check configuration files, or analyze text data. "
+        "description": "Read the contents of one or more files from the file system. "
+                    "WHEN TO USE: When you need to examine the actual content of one or more files, view source code, check configuration files, or analyze text data. "
                     "This is the primary tool for accessing file contents directly. "
                     "WHEN NOT TO USE: When you only need file metadata like size or modification date (use get_file_info instead), when you need to list directory contents "
-                    "(use directory_listing instead), or when you need to read multiple files at once (use read_multiple_files instead). "
-                    "RETURNS: The complete text content of the specified file or the requested portion if offset/limit are specified. Binary files or files with unknown encodings will return an error message. "
-                    "Handles various text encodings and provides detailed error messages if the file cannot be read. Only works within the allowed directory. "
-                    "Example: Enter 'src/main.py' to read a Python file, or add offset/limit to read specific line ranges. "
-                    "TIP: When analyzing a codebase, it's more efficient to use read_multiple_files instead of reading files one by one.",
+                    "(use directory_listing instead). "
+                    "RETURNS: The complete text content of the specified file(s) or the requested portion if offset/limit are specified. Binary files or files with unknown encodings will return an error message. "
+                    "Each file's content is preceded by a header showing the file path (==> path/to/file <==). "
+                    "Handles various text encodings and provides detailed error messages if a file cannot be read. Only works within the allowed directory. "
+                    "Example: Use 'files: [{\"path\": \"src/main.py\"}]' to read a Python file, or add offset/limit to read specific line ranges. "
+                    "For multiple files, use 'files: [{\"path\": \"file1.txt\"}, {\"path\": \"file2.txt\"}]' with optional offset/limit for each file.",
         "inputSchema": {
             "type": "object",
             "properties": {
-                "path": {
-                    "type": "string",
-                    "description": "Path to the file to read. This must be a path to a file, not a directory. Examples: 'README.md', 'src/main.py', 'config.json'. Both absolute and relative paths are supported, but must be within the allowed workspace."
-                },
-                "offset": {
-                    "type": "integer",
-                    "description": "Line number to start reading from (1-indexed). If specified, the file will be read starting from this line. Default is to start from the beginning of the file.",
-                },
-                "limit": {
-                    "type": "integer",
-                    "description": "Maximum number of lines to read after the offset. If specified along with offset, only this many lines will be read. Default is to read to the end of the file.",
+                "files": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "path": {
+                                "type": "string",
+                                "description": "Path to the file to read. This must be a path to a file, not a directory. Examples: 'README.md', 'src/main.py', 'config.json'. Both absolute and relative paths are supported, but must be within the allowed workspace."
+                            },
+                            "offset": {
+                                "type": "integer",
+                                "description": "Line number to start reading from (1-indexed). If specified, the file will be read starting from this line. Default is to start from the beginning of the file."
+                            },
+                            "limit": {
+                                "type": "integer",
+                                "description": "Maximum number of lines to read after the offset. If specified along with offset, only this many lines will be read. Default is to read to the end of the file."
+                            }
+                        },
+                        "required": ["path"]
+                    },
+                    "description": "List of files to read with optional offset and limit for each file."
                 }
             },
-            "required": ["path"]
+            "required": ["files"]
         },
     }
 
@@ -215,31 +226,6 @@ def delete_file_tool():
         },
     }
 
-def read_multiple_files_tool():
-    return {
-        "name": "read_multiple_files",
-        "description": "Read the contents of multiple files simultaneously. "
-                    "WHEN TO USE: When you need to examine or compare multiple files at once, analyze related files together, or gather content from several files efficiently. "
-                    "Useful for understanding code across multiple files, comparing configuration files, or collecting information from related documents. "
-                    "WHEN NOT TO USE: When you only need to read a single file (use read_file instead), when you need to read binary files or images (use read_image_file instead), "
-                    "or when you need metadata about files rather than their contents (use get_file_info instead). "
-                    "RETURNS: The contents of all specified files, with each file's content preceded by a header showing its path (==> path/to/file <==). "
-                    "If an individual file cannot be read, an error message is included in its place, but the operation continues for other files. "
-                    "Failed reads for individual files won't stop the entire operation. Only works within the allowed directory. "
-                    "Example: Enter ['src/main.py', 'README.md'] to read both files.",
-        "inputSchema": {
-            "type": "object",
-            "properties": {
-                "paths": {
-                    "type": "array",
-                    "items": {"type": "string"},
-                    "description": "List of file paths to read. Must contain at least one path. Each path should point to a text file. Examples: ['README.md', 'package.json'], ['src/main.py', 'src/utils.py', 'config.ini']. Both absolute and relative paths are supported, but must be within the allowed workspace.",
-                }
-            },
-            "required": ["paths"]
-        },
-    }
-
 def edit_file_tool():
     return {
         "name": "edit_file",
@@ -396,41 +382,43 @@ async def handle_write_file(arguments: dict):
         raise ValueError(f"Error writing file: {str(e)}")
 
 async def handle_read_file(arguments: dict):
-    path = arguments.get("path")
-    if not path:
-        raise ValueError("path must be provided")
-
-    # Get the line range parameters
-    offset = arguments.get("offset")
-    limit = arguments.get("limit")
-
-    return await _read_single_file(path, offset, limit)
-
-async def handle_read_multiple_files(arguments: dict):
-    paths = arguments.get("paths", [])
-    if not isinstance(paths, list):
-        raise ValueError("paths must be a list of strings")
-    if not all(isinstance(p, str) for p in paths):
-        raise ValueError("all paths must be strings")
-    if not paths:
-        raise ValueError("paths list cannot be empty")
-
+    files = arguments.get("files")
+    if not files:
+        raise ValueError("files must be provided")
+    if not isinstance(files, list):
+        raise ValueError("files must be an array")
+    if not files:
+        raise ValueError("files array cannot be empty")
+
+    # Validate each file entry
+    for file_entry in files:
+        if not isinstance(file_entry, dict):
+            raise ValueError("each file entry must be an object")
+        if "path" not in file_entry:
+            raise ValueError("each file entry must have a path property")
+
+    # Read each file with its own offset/limit
     results = []
-    for path in paths:
+    for file_entry in files:
+        path = file_entry.get("path")
+        offset = file_entry.get("offset")
+        limit = file_entry.get("limit")
+
         try:
             # Add file path header first
             results.append(TextContent(
                 type="text",
                 text=f"\n==> {path} <==\n"
             ))
-            # Then add file contents
-            file_contents = await _read_single_file(path)
+            # Then add file contents with specific offset/limit
+            file_contents = await _read_single_file(path, offset, limit)
             results.extend(file_contents)
         except Exception as e:
             results.append(TextContent(
                 type="text",
                 text=f"Error: {str(e)}\n"
             ))
+
     return results
 
 async def handle_move_file(arguments: dict):