test: add model-specific snapshots for coreTools

packages/core/src/tools/definitions/__snapshots__/coreToolsModelSnapshots.test.ts.snap

@@ -0,0 +1,399 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`coreTools snapshots for specific models > Model: gemini-2.5-pro > snapshot for tool: glob 1`] = `
+{
+  "description": "Efficiently finds files matching specific glob patterns (e.g., \`src/**/*.ts\`, \`**/*.md\`), returning absolute paths sorted by modification time (newest first). Ideal for quickly locating files based on their name or path structure, especially in large codebases.",
+  "name": "glob",
+  "parametersJsonSchema": {
+    "properties": {
+      "case_sensitive": {
+        "description": "Optional: Whether the search should be case-sensitive. Defaults to false.",
+        "type": "boolean",
+      },
+      "dir_path": {
+        "description": "Optional: The absolute path to the directory to search within. If omitted, searches the root directory.",
+        "type": "string",
+      },
+      "pattern": {
+        "description": "The glob pattern to match against (e.g., '**/*.py', 'docs/*.md').",
+        "type": "string",
+      },
+      "respect_gemini_ignore": {
+        "description": "Optional: Whether to respect .geminiignore patterns when finding files. Defaults to true.",
+        "type": "boolean",
+      },
+      "respect_git_ignore": {
+        "description": "Optional: Whether to respect .gitignore patterns when finding files. Only available in git repositories. Defaults to true.",
+        "type": "boolean",
+      },
+    },
+    "required": [
+      "pattern",
+    ],
+    "type": "object",
+  },
+}
+`;
+
+exports[`coreTools snapshots for specific models > Model: gemini-2.5-pro > snapshot for tool: grep_search 1`] = `
+{
+  "description": "Searches for a regular expression pattern within file contents. Max 100 matches.",
+  "name": "grep_search",
+  "parametersJsonSchema": {
+    "properties": {
+      "dir_path": {
+        "description": "Optional: The absolute path to the directory to search within. If omitted, searches the current working directory.",
+        "type": "string",
+      },
+      "include": {
+        "description": "Optional: A glob pattern to filter which files are searched (e.g., '*.js', '*.{ts,tsx}', 'src/**'). If omitted, searches all files (respecting potential global ignores).",
+        "type": "string",
+      },
+      "pattern": {
+        "description": "The regular expression (regex) pattern to search for within file contents (e.g., 'function\\s+myFunction', 'import\\s+\\{.*\\}\\s+from\\s+.*').",
+        "type": "string",
+      },
+    },
+    "required": [
+      "pattern",
+    ],
+    "type": "object",
+  },
+}
+`;
+
+exports[`coreTools snapshots for specific models > Model: gemini-2.5-pro > snapshot for tool: list_directory 1`] = `
+{
+  "description": "Lists the names of files and subdirectories directly within a specified directory path. Can optionally ignore entries matching provided glob patterns.",
+  "name": "list_directory",
+  "parametersJsonSchema": {
+    "properties": {
+      "dir_path": {
+        "description": "The path to the directory to list",
+        "type": "string",
+      },
+      "file_filtering_options": {
+        "description": "Optional: Whether to respect ignore patterns from .gitignore or .geminiignore",
+        "properties": {
+          "respect_gemini_ignore": {
+            "description": "Optional: Whether to respect .geminiignore patterns when listing files. Defaults to true.",
+            "type": "boolean",
+          },
+          "respect_git_ignore": {
+            "description": "Optional: Whether to respect .gitignore patterns when listing files. Only available in git repositories. Defaults to true.",
+            "type": "boolean",
+          },
+        },
+        "type": "object",
+      },
+      "ignore": {
+        "description": "List of glob patterns to ignore",
+        "items": {
+          "type": "string",
+        },
+        "type": "array",
+      },
+    },
+    "required": [
+      "dir_path",
+    ],
+    "type": "object",
+  },
+}
+`;
+
+exports[`coreTools snapshots for specific models > Model: gemini-2.5-pro > snapshot for tool: read_file 1`] = `
+{
+  "description": "Reads and returns the content of a specified file. If the file is large, the content will be truncated. The tool's response will clearly indicate if truncation has occurred and will provide details on how to read more of the file using the 'offset' and 'limit' parameters. Handles text, images (PNG, JPG, GIF, WEBP, SVG, BMP), audio files (MP3, WAV, AIFF, AAC, OGG, FLAC), and PDF files. For text files, it can read specific line ranges.",
+  "name": "read_file",
+  "parametersJsonSchema": {
+    "properties": {
+      "file_path": {
+        "description": "The path to the file to read.",
+        "type": "string",
+      },
+      "limit": {
+        "description": "Optional: For text files, maximum number of lines to read. Use with 'offset' to paginate through large files. If omitted, reads the entire file (if feasible, up to a default limit).",
+        "type": "number",
+      },
+      "offset": {
+        "description": "Optional: For text files, the 0-based line number to start reading from. Requires 'limit' to be set. Use for paginating through large files.",
+        "type": "number",
+      },
+    },
+    "required": [
+      "file_path",
+    ],
+    "type": "object",
+  },
+}
+`;
+
+exports[`coreTools snapshots for specific models > Model: gemini-2.5-pro > snapshot for tool: run_shell_command 1`] = `
+{
+  "description": "This tool executes a given shell command as \`bash -c <command>\`. To run a command in the background, set the \`is_background\` parameter to true. Do NOT use \`&\` to background commands. Command is executed as a subprocess that leads its own process group. Command process group can be terminated as \`kill -- -PGID\` or signaled as \`kill -s SIGNAL -- -PGID\`.
+
+      Efficiency Guidelines:
+      - Quiet Flags: Always prefer silent or quiet flags (e.g., \`npm install --silent\`, \`git --no-pager\`) to reduce output volume while still capturing necessary information.
+      - Pagination: Always disable terminal pagination to ensure commands terminate (e.g., use \`git --no-pager\`, \`systemctl --no-pager\`, or set \`PAGER=cat\`).
+
+      The following information is returned:
+
+      Output: Combined stdout/stderr. Can be \`(empty)\` or partial on error and for any unwaited background processes.
+      Exit Code: Only included if non-zero (command failed).
+      Error: Only included if a process-level error occurred (e.g., spawn failure).
+      Signal: Only included if process was terminated by a signal.
+      Background PIDs: Only included if background processes were started.
+      Process Group PGID: Only included if available.",
+  "name": "run_shell_command",
+  "parametersJsonSchema": {
+    "properties": {
+      "command": {
+        "description": "Exact bash command to execute as \`bash -c <command>\`",
+        "type": "string",
+      },
+      "description": {
+        "description": "Brief description of the command for the user. Be specific and concise. Ideally a single sentence. Can be up to 3 sentences for clarity. No line breaks.",
+        "type": "string",
+      },
+      "dir_path": {
+        "description": "(OPTIONAL) The path of the directory to run the command in. If not provided, the project root directory is used. Must be a directory within the workspace and must already exist.",
+        "type": "string",
+      },
+      "is_background": {
+        "description": "Set to true if this command should be run in the background (e.g. for long-running servers or watchers). The command will be started, allowed to run for a brief moment to check for immediate errors, and then moved to the background.",
+        "type": "boolean",
+      },
+    },
+    "required": [
+      "command",
+    ],
+    "type": "object",
+  },
+}
+`;
+
+exports[`coreTools snapshots for specific models > Model: gemini-2.5-pro > snapshot for tool: write_file 1`] = `
+{
+  "description": "Writes content to a specified file in the local filesystem.
+
+      The user has the ability to modify \`content\`. If modified, this will be stated in the response.",
+  "name": "write_file",
+  "parametersJsonSchema": {
+    "properties": {
+      "content": {
+        "description": "The content to write to the file.",
+        "type": "string",
+      },
+      "file_path": {
+        "description": "The path to the file to write to.",
+        "type": "string",
+      },
+    },
+    "required": [
+      "file_path",
+      "content",
+    ],
+    "type": "object",
+  },
+}
+`;
+
+exports[`coreTools snapshots for specific models > Model: gemini-3-pro-preview > snapshot for tool: glob 1`] = `
+{
+  "description": "Efficiently finds files matching specific glob patterns (e.g., \`src/**/*.ts\`, \`**/*.md\`), returning absolute paths sorted by modification time (newest first). Ideal for quickly locating files based on their name or path structure, especially in large codebases.",
+  "name": "glob",
+  "parametersJsonSchema": {
+    "properties": {
+      "case_sensitive": {
+        "description": "Optional: Whether the search should be case-sensitive. Defaults to false.",
+        "type": "boolean",
+      },
+      "dir_path": {
+        "description": "Optional: The absolute path to the directory to search within. If omitted, searches the root directory.",
+        "type": "string",
+      },
+      "pattern": {
+        "description": "The glob pattern to match against (e.g., '**/*.py', 'docs/*.md').",
+        "type": "string",
+      },
+      "respect_gemini_ignore": {
+        "description": "Optional: Whether to respect .geminiignore patterns when finding files. Defaults to true.",
+        "type": "boolean",
+      },
+      "respect_git_ignore": {
+        "description": "Optional: Whether to respect .gitignore patterns when finding files. Only available in git repositories. Defaults to true.",
+        "type": "boolean",
+      },
+    },
+    "required": [
+      "pattern",
+    ],
+    "type": "object",
+  },
+}
+`;
+
+exports[`coreTools snapshots for specific models > Model: gemini-3-pro-preview > snapshot for tool: grep_search 1`] = `
+{
+  "description": "Searches for a regular expression pattern within file contents. Max 100 matches.",
+  "name": "grep_search",
+  "parametersJsonSchema": {
+    "properties": {
+      "dir_path": {
+        "description": "Optional: The absolute path to the directory to search within. If omitted, searches the current working directory.",
+        "type": "string",
+      },
+      "include": {
+        "description": "Optional: A glob pattern to filter which files are searched (e.g., '*.js', '*.{ts,tsx}', 'src/**'). If omitted, searches all files (respecting potential global ignores).",
+        "type": "string",
+      },
+      "pattern": {
+        "description": "The regular expression (regex) pattern to search for within file contents (e.g., 'function\\s+myFunction', 'import\\s+\\{.*\\}\\s+from\\s+.*').",
+        "type": "string",
+      },
+    },
+    "required": [
+      "pattern",
+    ],
+    "type": "object",
+  },
+}
+`;
+
+exports[`coreTools snapshots for specific models > Model: gemini-3-pro-preview > snapshot for tool: list_directory 1`] = `
+{
+  "description": "Lists the names of files and subdirectories directly within a specified directory path. Can optionally ignore entries matching provided glob patterns.",
+  "name": "list_directory",
+  "parametersJsonSchema": {
+    "properties": {
+      "dir_path": {
+        "description": "The path to the directory to list",
+        "type": "string",
+      },
+      "file_filtering_options": {
+        "description": "Optional: Whether to respect ignore patterns from .gitignore or .geminiignore",
+        "properties": {
+          "respect_gemini_ignore": {
+            "description": "Optional: Whether to respect .geminiignore patterns when listing files. Defaults to true.",
+            "type": "boolean",
+          },
+          "respect_git_ignore": {
+            "description": "Optional: Whether to respect .gitignore patterns when listing files. Only available in git repositories. Defaults to true.",
+            "type": "boolean",
+          },
+        },
+        "type": "object",
+      },
+      "ignore": {
+        "description": "List of glob patterns to ignore",
+        "items": {
+          "type": "string",
+        },
+        "type": "array",
+      },
+    },
+    "required": [
+      "dir_path",
+    ],
+    "type": "object",
+  },
+}
+`;
+
+exports[`coreTools snapshots for specific models > Model: gemini-3-pro-preview > snapshot for tool: read_file 1`] = `
+{
+  "description": "Reads and returns the content of a specified file. If the file is large, the content will be truncated. The tool's response will clearly indicate if truncation has occurred and will provide details on how to read more of the file using the 'offset' and 'limit' parameters. Handles text, images (PNG, JPG, GIF, WEBP, SVG, BMP), audio files (MP3, WAV, AIFF, AAC, OGG, FLAC), and PDF files. For text files, it can read specific line ranges.",
+  "name": "read_file",
+  "parametersJsonSchema": {
+    "properties": {
+      "file_path": {
+        "description": "The path to the file to read.",
+        "type": "string",
+      },
+      "limit": {
+        "description": "Optional: For text files, maximum number of lines to read. Use with 'offset' to paginate through large files. If omitted, reads the entire file (if feasible, up to a default limit).",
+        "type": "number",
+      },
+      "offset": {
+        "description": "Optional: For text files, the 0-based line number to start reading from. Requires 'limit' to be set. Use for paginating through large files.",
+        "type": "number",
+      },
+    },
+    "required": [
+      "file_path",
+    ],
+    "type": "object",
+  },
+}
+`;
+
+exports[`coreTools snapshots for specific models > Model: gemini-3-pro-preview > snapshot for tool: run_shell_command 1`] = `
+{
+  "description": "This tool executes a given shell command as \`bash -c <command>\`. To run a command in the background, set the \`is_background\` parameter to true. Do NOT use \`&\` to background commands. Command is executed as a subprocess that leads its own process group. Command process group can be terminated as \`kill -- -PGID\` or signaled as \`kill -s SIGNAL -- -PGID\`.
+
+      Efficiency Guidelines:
+      - Quiet Flags: Always prefer silent or quiet flags (e.g., \`npm install --silent\`, \`git --no-pager\`) to reduce output volume while still capturing necessary information.
+      - Pagination: Always disable terminal pagination to ensure commands terminate (e.g., use \`git --no-pager\`, \`systemctl --no-pager\`, or set \`PAGER=cat\`).
+
+      The following information is returned:
+
+      Output: Combined stdout/stderr. Can be \`(empty)\` or partial on error and for any unwaited background processes.
+      Exit Code: Only included if non-zero (command failed).
+      Error: Only included if a process-level error occurred (e.g., spawn failure).
+      Signal: Only included if process was terminated by a signal.
+      Background PIDs: Only included if background processes were started.
+      Process Group PGID: Only included if available.",
+  "name": "run_shell_command",
+  "parametersJsonSchema": {
+    "properties": {
+      "command": {
+        "description": "Exact bash command to execute as \`bash -c <command>\`",
+        "type": "string",
+      },
+      "description": {
+        "description": "Brief description of the command for the user. Be specific and concise. Ideally a single sentence. Can be up to 3 sentences for clarity. No line breaks.",
+        "type": "string",
+      },
+      "dir_path": {
+        "description": "(OPTIONAL) The path of the directory to run the command in. If not provided, the project root directory is used. Must be a directory within the workspace and must already exist.",
+        "type": "string",
+      },
+      "is_background": {
+        "description": "Set to true if this command should be run in the background (e.g. for long-running servers or watchers). The command will be started, allowed to run for a brief moment to check for immediate errors, and then moved to the background.",
+        "type": "boolean",
+      },
+    },
+    "required": [
+      "command",
+    ],
+    "type": "object",
+  },
+}
+`;
+
+exports[`coreTools snapshots for specific models > Model: gemini-3-pro-preview > snapshot for tool: write_file 1`] = `
+{
+  "description": "Writes content to a specified file in the local filesystem.
+
+      The user has the ability to modify \`content\`. If modified, this will be stated in the response.",
+  "name": "write_file",
+  "parametersJsonSchema": {
+    "properties": {
+      "content": {
+        "description": "The content to write to the file.",
+        "type": "string",
+      },
+      "file_path": {
+        "description": "The path to the file to write to.",
+        "type": "string",
+      },
+    },
+    "required": [
+      "file_path",
+      "content",
+    ],
+    "type": "object",
+  },
+}
+`;