"tools": [
{
"functionDeclarations": [
{
"name": "browser_subagent",
"description": "Start a browser subagent to perform actions in the browser with the given task description. The subagent has access to tools for both interacting with web page content (clicking, typing, navigating, etc) and controlling the browser window itself (resizing, etc). Please make sure to define a clear condition to return on. After the subagent returns, you should read the DOM or capture a screenshot to see what it did. Note: All browser interactions are automatically recorded and saved as WebP videos to the artifacts directory. This is the ONLY way you can record a browser session video/animation. IMPORTANT: if the subagent returns that the open_browser_url tool failed, there is a browser issue that is out of your control. You MUST ask the user how to proceed and use the suggested_responses tool.",
"parameters": {
"type": "OBJECT",
"properties": {
"RecordingName": {
"type": "STRING",
"description": "Name of the browser recording that is created with the actions of the subagent. Should be all lowercase with underscores, describing what the recording contains. Maximum 3 words. Example: 'login_flow_demo'"
},
"Task": {
"type": "STRING",
"description": "A clear, actionable task description for the browser subagent. The subagent is an agent similar to you, with a different set of tools, limited to tools to understand the state of and control the browser. The task you define is the prompt sent to this subagent. Avoid vague instructions, be specific about what to do and when to stop. This should be the second argument."
},
"TaskName": {
"type": "STRING",
"description": "Name of the task that the browser subagent is performing. This is the identifier that groups the subagent steps together, but should still be a human readable name. This should read like a title, should be properly capitalized and human readable, example: 'Navigating to Example Page'. Replace URLs or non-human-readable expressions like CSS selectors or long text with human-readable terms like 'URL' or 'Page' or 'Submit Button'. Be very sure this task name represents a reasonable chunk of work. It should almost never be the entire user request. This should be the very first argument."
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"TaskName",
"Task",
"RecordingName"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "codebase_search",
"description": "Find snippets of code from the codebase most relevant to the search query. This performs best when the search query is more precise and relating to the function or purpose of code. Results will be poor if asking a very broad question, such as asking about the general 'framework' or 'implementation' of a large component or system. This tool is useful to find code snippets that are fuzzily / semantically related to the search query but shouldn't be relied on for high recall queries (e.g. finding all occurrences of some variable or some pattern). Will only show the full code contents of the top items, and they may also be truncated. For other items it will only show the docstring and signature. Use view_code_item with the same path and node name to view the full code contents for any item.",
"parameters": {
"type": "OBJECT",
"properties": {
"Query": {
"type": "STRING",
"description": "Search query"
},
"TargetDirectories": {
"type": "ARRAY",
"description": "List of absolute paths to directories to search over",
"items": {
"type": "STRING"
}
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"Query",
"TargetDirectories"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "command_status",
"description": "Get the status of a previously executed terminal command by its ID. Returns the current status (running, done), output lines as specified by output priority, and any error if present. Do not try to check the status of any IDs other than Background command IDs.",
"parameters": {
"type": "OBJECT",
"properties": {
"CommandId": {
"type": "STRING",
"description": "ID of the command to get status for"
},
"OutputCharacterCount": {
"type": "INTEGER",
"description": "Number of characters to view. Make this as small as possible to avoid excessive memory usage."
},
"WaitDurationSeconds": {
"type": "INTEGER",
"description": "Number of seconds to wait for command completion before getting the status. If the command completes before this duration, this tool call will return early. Set to 0 to get the status of the command immediately. If you are only interested in waiting for command completion, set to 60."
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"CommandId",
"WaitDurationSeconds"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "find_by_name",
"description": "Search for files and subdirectories within a specified directory using fd.\nSearch uses smart case and will ignore gitignored files by default.\nPattern and Excludes both use the glob format. If you are searching for Extensions, there is no need to specify both Pattern AND Extensions.\nTo avoid overwhelming output, the results are capped at 50 matches. Use the various arguments to filter the search scope as needed.\nResults will include the type, size, modification time, and relative path.",
"parameters": {
"type": "OBJECT",
"properties": {
"Excludes": {
"type": "ARRAY",
"description": "Optional, exclude files/directories that match the given glob patterns",
"items": {
"type": "STRING"
}
},
"Extensions": {
"type": "ARRAY",
"description": "Optional, file extensions to include (without leading .), matching paths must match at least one of the included extensions",
"items": {
"type": "STRING"
}
},
"FullPath": {
"type": "BOOLEAN",
"description": "Optional, whether the full absolute path must match the glob pattern, default: only filename needs to match. Take care when specifying glob patterns with this flag on, e.g when FullPath is on, pattern '*.py' will not match to the file '/foo/bar.py', but pattern '**/*.py' will match."
},
"MaxDepth": {
"type": "INTEGER",
"description": "Optional, maximum depth to search"
},
"Pattern": {
"type": "STRING",
"description": "Optional, Pattern to search for, supports glob format"
},
"SearchDirectory": {
"type": "STRING",
"description": "The directory to search within"
},
"Type": {
"type": "STRING",
"description": "Optional, type filter, enum=file,directory,any"
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"SearchDirectory",
"Pattern"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "generate_image",
"description": "Generate an image or edit existing images based on a text prompt. The resulting image will be saved as an artifact for use. You can use this tool to generate user interfaces and iterate on a design with the USER for an application or website that you are building. When creating UI designs, generate only the interface itself without surrounding device frames (laptops, phones, tablets, etc.) unless the user explicitly requests them. You can also use this tool to generate assets for use in an application or website.",
"parameters": {
"type": "OBJECT",
"properties": {
"ImageName": {
"type": "STRING",
"description": "Name of the generated image to save. Should be all lowercase with underscores, describing what the image contains. Maximum 3 words. Example: 'login_page_mockup'"
},
"ImagePaths": {
"type": "ARRAY",
"description": "Optional absolute paths to the images to use in generation. You can pass in images here if you would like to edit or combine images. You can pass in artifact images and any images in the file system. Note: you cannot pass in more than three images.",
"items": {
"type": "STRING"
}
},
"Prompt": {
"type": "STRING",
"description": "The text prompt to generate an image for."
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"Prompt",
"ImageName"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "grep_search",
"description": "Use ripgrep to find exact pattern matches within files or directories.\nResults are returned in JSON format and for each match you will receive the:\n- Filename\n- LineNumber\n- LineContent: the content of the matching line\nTotal results are capped at 50 matches. Use the Includes option to filter by file type or specific paths to refine your search.",
"parameters": {
"type": "OBJECT",
"properties": {
"CaseInsensitive": {
"type": "BOOLEAN",
"description": "If true, performs a case-insensitive search."
},
"Includes": {
"type": "ARRAY",
"description": "Glob patterns to filter files found within the 'SearchPath', if 'SearchPath' is a directory. For example, '*.go' to only include Go files, or '!**/vendor/*' to exclude vendor directories. This is NOT for specifying the primary search directory; use 'SearchPath' for that. Leave empty if no glob filtering is needed or if 'SearchPath' is a single file.",
"items": {
"type": "STRING"
}
},
"IsRegex": {
"type": "BOOLEAN",
"description": "If true, treats Query as a regular expression pattern with special characters like *, +, (, etc. having regex meaning. If false, treats Query as a literal string where all characters are matched exactly. Use false for normal text searches and true only when you specifically need regex functionality."
},
"MatchPerLine": {
"type": "BOOLEAN",
"description": "If true, returns each line that matches the query, including line numbers and snippets of matching lines (equivalent to 'git grep -nI'). If false, only returns the names of files containing the query (equivalent to 'git grep -l')."
},
"Query": {
"type": "STRING",
"description": "The search term or pattern to look for within files."
},
"SearchPath": {
"type": "STRING",
"description": "The path to search. This can be a directory or a file. This is a required parameter."
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"SearchPath",
"Query"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "list_dir",
"description": "List the contents of a directory, i.e. all files and subdirectories that are children of the directory. Directory path must be an absolute path to a directory that exists. For each child in the directory, output will have: relative path to the directory, whether it is a directory or file, size in bytes if file, and number of children (recursive) if directory. Number of children may be missing if the workspace is too large, since we are not able to track the entire workspace.",
"parameters": {
"type": "OBJECT",
"properties": {
"DirectoryPath": {
"type": "STRING",
"description": "Path to list contents of, should be absolute path to a directory"
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"DirectoryPath"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "list_resources",
"description": "Lists the available resources from an MCP server.",
"parameters": {
"type": "OBJECT",
"properties": {
"ServerName": {
"type": "STRING",
"description": "Name of the server to list available resources from."
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
}
}
}
]
},
{
"functionDeclarations": [
{
"name": "multi_replace_file_content",
"description": "Use this tool to edit an existing file. Follow these rules:\n1. Use this tool ONLY when you are making MULTIPLE, NON-CONTIGUOUS edits to the same file (i.e., you are changing more than one separate block of text). If you are making a single contiguous block of edits, use the replace_file_content tool instead.\n2. Do NOT use this tool if you are only editing a single contiguous block of lines.\n3. Do NOT make multiple parallel calls to this tool or the replace_file_content tool for the same file.\n4. To edit multiple, non-adjacent lines of code in the same file, make a single call to this tool. Specify each edit as a separate ReplacementChunk.\n5. For each ReplacementChunk, specify StartLine, EndLine, TargetContent and ReplacementContent. StartLine and EndLine should specify a range of lines containing precisely the instances of TargetContent that you wish to edit. To edit a single instance of the TargetContent, the range should be such that it contains that specific instance of the TargetContent and no other instances. When applicable, provide a range that matches the range viewed in a previous view_file call. In TargetContent, specify the precise lines of code to edit. These lines MUST EXACTLY MATCH text in the existing file content. In ReplacementContent, specify the replacement content for the specified target content. This must be a complete drop-in replacement of the TargetContent, with necessary modifications made.\n6. If you are making multiple edits across a single file, specify multiple separate ReplacementChunks. DO NOT try to replace the entire existing content with the new content, this is very expensive.\n7. You may not edit file extensions: [.ipynb]\nIMPORTANT: You must generate the following arguments first, before any others: [TargetFile]",
"parameters": {
"type": "OBJECT",
"properties": {
"ArtifactMetadata": {
"type": "OBJECT",
"description": "Metadata updates if updating an artifact file, leave blank if not updating an artifact. Should be updated if the content is changing meaningfully.",
"properties": {
"ArtifactType": {
"type": "STRING",
"description": "Type of artifact: 'implementation_plan', 'walkthrough', 'task', or 'other'.",
"enum": [
"implementation_plan",
"walkthrough",
"task",
"other"
]
},
"Summary": {
"type": "STRING",
"description": "Detailed multi-line summary of the artifact file, after edits have been made. Summary does not need to mention the artifact name and should focus on the contents and purpose of the artifact."
}
},
"required": [
"Summary",
"ArtifactType"
]
},
"CodeMarkdownLanguage": {
"type": "STRING",
"description": "Markdown language for the code block, e.g 'python' or 'javascript'"
},
"Complexity": {
"type": "INTEGER",
"description": "A 1-10 rating of how important it is for the user to review this change. Rate based on: 1-3 (routine/obvious), 4-6 (worth noting), 7-10 (critical or subtle and warrants explanation)."
},
"Description": {
"type": "STRING",
"description": "Brief, user-facing explanation of what this change did. Focus on non-obvious rationale, design decisions, or important context. Don't just restate what the code does."
},
"Instruction": {
"type": "STRING",
"description": "A description of the changes that you are making to the file."
},
"ReplacementChunks": {
"type": "ARRAY",
"description": "A list of chunks to replace. It is best to provide multiple chunks for non-contiguous edits if possible. This must be a JSON array, not a string.",
"items": {
"type": "OBJECT",
"properties": {
"AllowMultiple": {
"type": "BOOLEAN",
"description": "If true, multiple occurrences of 'targetContent' will be replaced by 'replacementContent' if they are found. Otherwise if multiple occurences are found, an error will be returned."
},
"EndLine": {
"type": "INTEGER",
"description": "The ending line number of the chunk (1-indexed). Should be at or after the last line containing the target content. Must satisfy StartLine <= EndLine <= number of lines in the file. The target content is searched for within the [StartLine, EndLine] range."
},
"ReplacementContent": {
"type": "STRING",
"description": "The content to replace the target content with."
},
"StartLine": {
"type": "INTEGER",
"description": "The starting line number of the chunk (1-indexed). Should be at or before the first line containing the target content. Must satisfy 1 <= StartLine <= EndLine. The target content is searched for within the [StartLine, EndLine] range."
},
"TargetContent": {
"type": "STRING",
"description": "The exact string to be replaced. This must be the exact character-sequence to be replaced, including whitespace. Be very careful to include any leading whitespace otherwise this will not work at all. This must be a unique substring within the file, or else it will error."
}
},
"required": [
"AllowMultiple",
"TargetContent",
"ReplacementContent",
"StartLine",
"EndLine"
]
}
},
"TargetFile": {
"type": "STRING",
"description": "The target file to modify. Always specify the target file as the very first argument."
},
"TargetLintErrorIds": {
"type": "ARRAY",
"description": "If applicable, IDs of lint errors this edit aims to fix (they'll have been given in recent IDE feedback). If you believe the edit could fix lints, do specify lint IDs; if the edit is wholly unrelated, do not. A rule of thumb is, if your edit was influenced by lint feedback, include lint IDs. Exercise honest judgement here.",
"items": {
"type": "STRING"
}
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"TargetFile",
"CodeMarkdownLanguage",
"Instruction",
"Description",
"Complexity",
"ReplacementChunks"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "read_resource",
"description": "Retrieves a specified resource's contents.",
"parameters": {
"type": "OBJECT",
"properties": {
"ServerName": {
"type": "STRING",
"description": "Name of the server to read the resource from."
},
"Uri": {
"type": "STRING",
"description": "Unique identifier for the resource."
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
}
}
}
]
},
{
"functionDeclarations": [
{
"name": "read_terminal",
"description": "Reads the contents of a terminal given its process ID.",
"parameters": {
"type": "OBJECT",
"properties": {
"Name": {
"type": "STRING",
"description": "Name of the terminal to read."
},
"ProcessID": {
"type": "STRING",
"description": "Process ID of the terminal to read."
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"ProcessID",
"Name"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "read_url_content",
"description": "Fetch content from a URL via HTTP request (invisible to USER). Use when: (1) extracting text from public pages, (2) reading static content/documentation, (3) batch processing multiple URLs, (4) speed is important, or (5) no visual interaction needed. Converts HTML to markdown. No JavaScript execution, no authentication. For pages requiring login, JavaScript, or USER visibility, use read_browser_page instead.",
"parameters": {
"type": "OBJECT",
"properties": {
"Url": {
"type": "STRING",
"description": "URL to read content from"
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"Url"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "replace_file_content",
"description": "Use this tool to edit an existing file. Follow these rules:\n1. Use this tool ONLY when you are making a SINGLE CONTIGUOUS block of edits to the same file (i.e. replacing a single contiguous block of text). If you are making edits to multiple non-adjacent lines, use the multi_replace_file_content tool instead.\n2. Do NOT make multiple parallel calls to this tool or the multi_replace_file_content tool for the same file.\n3. To edit multiple, non-adjacent lines of code in the same file, make a single call to the multi_replace_file_content \t\"toolName\": shared.MultiReplaceFileContentToolName,.\n4. For the ReplacementChunk, specify StartLine, EndLine, TargetContent and ReplacementContent. StartLine and EndLine should specify a range of lines containing precisely the instances of TargetContent that you wish to edit. To edit a single instance of the TargetContent, the range should be such that it contains that specific instance of the TargetContent and no other instances. When applicable, provide a range that matches the range viewed in a previous view_file call. In TargetContent, specify the precise lines of code to edit. These lines MUST EXACTLY MATCH text in the existing file content. In ReplacementContent, specify the replacement content for the specified target content. This must be a complete drop-in replacement of the TargetContent, with necessary modifications made.\n5. If you are making multiple edits across a single file, use the multi_replace_file_content tool instead.. DO NOT try to replace the entire existing content with the new content, this is very expensive.\n6. You may not edit file extensions: [.ipynb]\nIMPORTANT: You must generate the following arguments first, before any others: [TargetFile]",
"parameters": {
"type": "OBJECT",
"properties": {
"AllowMultiple": {
"type": "BOOLEAN",
"description": "If true, multiple occurrences of 'targetContent' will be replaced by 'replacementContent' if they are found. Otherwise if multiple occurences are found, an error will be returned."
},
"CodeMarkdownLanguage": {
"type": "STRING",
"description": "Markdown language for the code block, e.g 'python' or 'javascript'"
},
"Complexity": {
"type": "INTEGER",
"description": "A 1-10 rating of how important it is for the user to review this change. Rate based on: 1-3 (routine/obvious), 4-6 (worth noting), 7-10 (critical or subtle and warrants explanation)."
},
"Description": {
"type": "STRING",
"description": "Brief, user-facing explanation of what this change did. Focus on non-obvious rationale, design decisions, or important context. Don't just restate what the code does."
},
"EndLine": {
"type": "INTEGER",
"description": "The ending line number of the chunk (1-indexed). Should be at or after the last line containing the target content. Must satisfy StartLine <= EndLine <= number of lines in the file. The target content is searched for within the [StartLine, EndLine] range."
},
"Instruction": {
"type": "STRING",
"description": "A description of the changes that you are making to the file."
},
"ReplacementContent": {
"type": "STRING",
"description": "The content to replace the target content with."
},
"StartLine": {
"type": "INTEGER",
"description": "The starting line number of the chunk (1-indexed). Should be at or before the first line containing the target content. Must satisfy 1 <= StartLine <= EndLine. The target content is searched for within the [StartLine, EndLine] range."
},
"TargetContent": {
"type": "STRING",
"description": "The exact string to be replaced. This must be the exact character-sequence to be replaced, including whitespace. Be very careful to include any leading whitespace otherwise this will not work at all. This must be a unique substring within the file, or else it will error."
},
"TargetFile": {
"type": "STRING",
"description": "The target file to modify. Always specify the target file as the very first argument."
},
"TargetLintErrorIds": {
"type": "ARRAY",
"description": "If applicable, IDs of lint errors this edit aims to fix (they'll have been given in recent IDE feedback). If you believe the edit could fix lints, do specify lint IDs; if the edit is wholly unrelated, do not. A rule of thumb is, if your edit was influenced by lint feedback, include lint IDs. Exercise honest judgement here.",
"items": {
"type": "STRING"
}
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"TargetFile",
"CodeMarkdownLanguage",
"Instruction",
"Description",
"Complexity",
"AllowMultiple",
"TargetContent",
"ReplacementContent",
"StartLine",
"EndLine"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "run_command",
"description": "PROPOSE a command to run on behalf of the user. Operating System: windows. Shell: pwsh.\n**NEVER PROPOSE A cd COMMAND**.\nIf you have this tool, note that you DO have the ability to run commands directly on the USER's system.\nMake sure to specify CommandLine exactly as it should be run in the shell.\nNote that the user will have to approve the command before it is executed. The user may reject it if it is not to their liking.\nThe actual command will NOT execute until the user approves it. The user may not approve it immediately.\nIf the step is WAITING for user approval, it has NOT started running.\nIf the step returns a command id, it means that the command was sent to the background. You should use the command_status tool to monitor the output and status of the command.\nCommands will be run with PAGER=cat. You may want to limit the length of output for commands that usually rely on paging and may contain very long output (e.g. git log, use git log -n <N>).",
"parameters": {
"type": "OBJECT",
"properties": {
"CommandLine": {
"type": "STRING",
"description": "The exact command line string to execute."
},
"Cwd": {
"type": "STRING",
"description": "The current working directory for the command"
},
"SafeToAutoRun": {
"type": "BOOLEAN",
"description": "Set to true if you believe that this command is safe to run WITHOUT user approval. A command is unsafe if it may have some destructive side-effects. Example unsafe side-effects include: deleting files, mutating state, installing system dependencies, making external requests, etc. Set to true only if you are extremely confident it is safe. If you feel the command could be unsafe, never set this to true, EVEN if the USER asks you to. It is imperative that you never auto-run a potentially unsafe command."
},
"WaitMsBeforeAsync": {
"type": "INTEGER",
"description": "This specifies the number of milliseconds to wait after starting the command before sending it to the background. If you want the command to complete execution synchronously, set this to a large enough value that you expect the command to complete in that time under ordinary circumstances. If you're starting an interactive or long-running command, set it to a large enough value that it would cause possible failure cases to execute synchronously (e.g. 500ms). Keep the value as small as possible, with a maximum of 10000ms."
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"Cwd",
"WaitMsBeforeAsync",
"SafeToAutoRun",
"CommandLine"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "search_in_file",
"description": "Returns code snippets in the specified file that are most relevant to the search query. Shows entire code for top items, but only a docstring and signature for others.",
"parameters": {
"type": "OBJECT",
"properties": {
"AbsolutePath": {
"type": "STRING",
"description": "Absolute path to the file to search in"
},
"Query": {
"type": "STRING",
"description": "Search query"
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"Query",
"AbsolutePath"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "search_web",
"description": "Performs a web search for a given query. Returns a summary of relevant information along with URL citations.",
"parameters": {
"type": "OBJECT",
"properties": {
"query": {
"type": "STRING"
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
}
}
}
]
},
{
"functionDeclarations": [
{
"name": "send_command_input",
"description": "Send standard input to a running command or to terminate a command. Use this to interact with REPLs, interactive commands, and long-running processes. The command must have been created by a previous run_command call. Use the command_status tool to check the status and output of the command after sending input.",
"parameters": {
"type": "OBJECT",
"properties": {
"CommandId": {
"type": "STRING",
"description": "The command ID from a previous run_command call. This is returned in the run_command output."
},
"Input": {
"type": "STRING",
"description": "The input to send to the command's stdin. Include newline characters (the literal character, not the escape sequence) if needed to submit commands. Exactly one of input and terminate must be specified."
},
"Terminate": {
"type": "BOOLEAN",
"description": "Whether to terminate the command. Exactly one of input and terminate must be specified."
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"CommandId"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "view_code_item",
"description": "View the content of up to 5 code item nodes in a file, each as a class or a function. You must use fully qualified code item names, such as those return by the grep_search or other tools. For example, if you have a class called `Foo` and you want to view the function definition `bar` in the `Foo` class, you would use `Foo.bar` as the NodeName. Do not request to view a symbol if the contents have been previously shown by the codebase_search tool. If the symbol is not found in a file, the tool will return an empty string instead.",
"parameters": {
"type": "OBJECT",
"properties": {
"File": {
"type": "STRING",
"description": "Absolute path to the node to view, e.g /path/to/file"
},
"NodePaths": {
"type": "ARRAY",
"description": "Path of the nodes within the file, e.g package.class.FunctionName",
"items": {
"type": "STRING"
}
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"File",
"NodePaths"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "view_content_chunk",
"description": "View a specific chunk of document content using its DocumentId and chunk position. The DocumentId must have already been read by the read_url_content tool before this can be used on that particular DocumentId.",
"parameters": {
"type": "OBJECT",
"properties": {
"document_id": {
"type": "STRING",
"description": "The ID of the document that the chunk belongs to"
},
"position": {
"type": "INTEGER",
"description": "The position of the chunk to view"
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"document_id",
"position"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "view_file",
"description": "View the contents of a file from the local filesystem. This tool supports some binary files such as images and videos.\nText file usage:\n- The lines of the file are 1-indexed\n- The first time you read a new file the tool will enforce reading 800 lines to understand as much about the file as possible\n- The output of this tool call will be the file contents from StartLine to EndLine (inclusive)\n- You can view at most 800 lines at a time\n- To view the whole file do not pass StartLine or EndLine arguments\nBinary file usage:\n- Do not provide StartLine or EndLine arguments, this tool always returns the entire file",
"parameters": {
"type": "OBJECT",
"properties": {
"AbsolutePath": {
"type": "STRING",
"description": "Path to file to view. Must be an absolute path."
},
"EndLine": {
"type": "INTEGER",
"description": "Optional. Endline to view, 1-indexed as usual, inclusive. This value must be greater than or equal to StartLine."
},
"StartLine": {
"type": "INTEGER",
"description": "Optional. Startline to view, 1-indexed as usual, inclusive. This value must be less than or equal to EndLine."
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"AbsolutePath"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "view_file_outline",
"description": "View the outline of the input file. This is the preferred first-step tool for exploring the contents of files. IMPORTANT: This tool ONLY works on files, never directories. Always verify the path is a file before using this tool. The outline will contain a breakdown of functions and classes in the file. For each, it will show the node path, signature, and current line range. There may be lines of code in the file not covered by the outline if they do not belong to a class or function directly, for example imports or top-level constants.\n\nThe tool result will also contain the total number of lines in the file and the total number of outline items. When viewing a file for the first time with offset 0, we will also attempt to show the contents of the file, which may be truncated if the file is too large. If there are too many items, only a subset of them will be shown. They are shown in order of appearance in the file.",
"parameters": {
"type": "OBJECT",
"properties": {
"AbsolutePath": {
"type": "STRING",
"description": "Path to file to view. Must be an absolute path."
},
"ItemOffset": {
"type": "INTEGER",
"description": "Offset of items to show. This is used for pagination. The first request to a file should have an offset of 0."
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"AbsolutePath"
]
}
}
]
},
{
"functionDeclarations": [
{
"name": "write_to_file",
"description": "Use this tool to create new files. The file and any parent directories will be created for you if they do not already exist.\n\t\tFollow these instructions:\n\t\t1. By default this tool will error if TargetFile already exists. To overwrite an existing file, set Overwrite to true.\n\t\t2. You MUST specify TargetFile as the FIRST argument. Please specify the full TargetFile before any of the code contents.\nIMPORTANT: You must generate the following arguments first, before any others: [TargetFile, Overwrite]",
"parameters": {
"type": "OBJECT",
"properties": {
"CodeContent": {
"type": "STRING",
"description": "The code contents to write to the file."
},
"Complexity": {
"type": "INTEGER",
"description": "A 1-10 rating of how important it is for the user to review this change. Rate based on: 1-3 (routine/obvious), 4-6 (worth noting), 7-10 (critical or subtle and warrants explanation)."
},
"Description": {
"type": "STRING",
"description": "Brief, user-facing explanation of what this change did. Focus on non-obvious rationale, design decisions, or important context. Don't just restate what the code does."
},
"EmptyFile": {
"type": "BOOLEAN",
"description": "Set this to true to create an empty file."
},
"Overwrite": {
"type": "BOOLEAN",
"description": "Set this to true to overwrite an existing file. WARNING: This will replace the entire file contents. Only use when you explicitly intend to overwrite. Otherwise, use a code edit tool to modify existing files."
},
"TargetFile": {
"type": "STRING",
"description": "The target file to create and write code to."
},
"waitForPreviousTools": {
"type": "BOOLEAN",
"description": "If true, wait for all previous tool calls from this turn to complete before executing (sequential). If false or omitted, execute this tool immediately (parallel with other tools)."
}
},
"required": [
"TargetFile",
"Overwrite",
"CodeContent",
"EmptyFile",
"Description",
"Complexity"
]
}
}
]
}
],