@volter/supercode-interchange 0.1.22 → 0.1.24

package/inspection-builtin-tools.json

@@ -0,0 +1,261 @@
+[
+  {
+    "name": "read_file",
+    "description": "Read the contents of a UTF-8 text file. Output may be line-numbered `cat -n` style (a right-aligned number and a tab before each line, numbered from `offset`); the numbers are the gutter, not file content. Large files are returned truncated from the start (with a notice stating the true size); pass `offset` (1-based start line) and/or `limit` (number of lines) to read further slices. PDFs come back as extracted text and Jupyter notebooks as their cells with outputs.",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string",
+          "description": "File path, absolute or relative to the working directory."
+        },
+        "offset": {
+          "type": "integer",
+          "description": "1-based line to start at."
+        },
+        "limit": {
+          "type": "integer",
+          "description": "Maximum number of lines to return."
+        }
+      },
+      "required": [
+        "path"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "write_file",
+    "description": "Create or overwrite a file with the given contents. Parent directories are created as needed.",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string",
+          "description": "File path to write."
+        },
+        "content": {
+          "type": "string",
+          "description": "Full file contents."
+        }
+      },
+      "required": [
+        "path",
+        "content"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "edit_file",
+    "description": "Replace an exact substring in a file. By default `old_string` must occur exactly once; set `replace_all` to replace every occurrence. When notebook-aware editing is enabled, pass `cell_index`/`cell_op` (`replace`|`insert`|`delete`) instead to edit a Jupyter `.ipynb` cell.",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string"
+        },
+        "old_string": {
+          "type": "string",
+          "description": "Exact text to replace."
+        },
+        "new_string": {
+          "type": "string",
+          "description": "Replacement text."
+        },
+        "replace_all": {
+          "type": "boolean",
+          "description": "Replace every occurrence instead of requiring uniqueness."
+        },
+        "cell_index": {
+          "type": "integer",
+          "description": "0-based Jupyter cell index (notebook-aware mode only)."
+        },
+        "cell_op": {
+          "type": "string",
+          "enum": [
+            "replace",
+            "insert",
+            "delete"
+          ],
+          "description": "Notebook cell operation (notebook-aware mode only)."
+        },
+        "cell_source": {
+          "type": "string",
+          "description": "New cell source text (notebook-aware `replace`/`insert`)."
+        },
+        "cell_type": {
+          "type": "string",
+          "enum": [
+            "code",
+            "markdown"
+          ],
+          "description": "Cell type for notebook-aware `insert` (default `code`)."
+        }
+      },
+      "required": [
+        "path"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "list_dir",
+    "description": "List the entries of a directory (defaults to the working directory). Directories are suffixed with `/`.",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string",
+          "description": "Directory to list. Defaults to the working directory."
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "glob",
+    "description": "Find files matching a glob pattern (e.g. `src/**/*.rs`), relative to the working directory.",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "pattern": {
+          "type": "string",
+          "description": "Glob pattern, e.g. **/*.rs"
+        }
+      },
+      "required": [
+        "pattern"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "search",
+    "description": "Search file contents with a regular expression, respecting .gitignore. Returns `path:line: text` matches.",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "pattern": {
+          "type": "string",
+          "description": "Regular expression to search for."
+        },
+        "path": {
+          "type": "string",
+          "description": "Directory or file to search. Defaults to the working directory."
+        },
+        "max_results": {
+          "type": "integer",
+          "description": "Cap on the number of matches (default 200)."
+        }
+      },
+      "required": [
+        "pattern"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "apply_patch",
+    "description": "Apply a patch in the apply_patch envelope format (*** Begin Patch / *** End Patch) with Add File, Delete File, and Update File operations. Update hunks use leading '+'/'-'/' ' on each line and may include '@@' context headers and an optional '*** Move to:' rename.",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "patch": {
+          "type": "string",
+          "description": "The full *** Begin Patch … *** End Patch text."
+        }
+      },
+      "required": [
+        "patch"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "bash",
+    "description": "Execute a shell command via `sh -c` in the working directory and return its combined stdout/stderr and exit code.",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "command": {
+          "type": "string",
+          "description": "Shell command to run."
+        },
+        "timeout_ms": {
+          "type": "integer",
+          "description": "Timeout in milliseconds (default 120000)."
+        },
+        "with_escalated_permissions": {
+          "type": "boolean",
+          "description": "Run this one command OUTSIDE the sandbox. Only use it after a sandboxed attempt failed for a sandbox reason; the user is asked first, and must supply a justification."
+        },
+        "justification": {
+          "type": "string",
+          "description": "Why this command needs to run outside the sandbox. Shown to the user with the approval request."
+        }
+      },
+      "required": [
+        "command"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "shell",
+    "description": "Run a command in a PERSISTENT shell whose working directory, environment, and shell functions survive across calls (unlike one-shot bash). Pass `command` to run to completion (returns exit code), or `write_stdin` to feed raw input to the shell (for interactive programs).",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "command": {
+          "type": "string",
+          "description": "Command to run in the persistent shell."
+        },
+        "write_stdin": {
+          "type": "string",
+          "description": "Raw text to write to the shell's stdin instead of running a command."
+        },
+        "timeout_ms": {
+          "type": "integer",
+          "description": "Timeout in milliseconds (default 120000)."
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "update_plan",
+    "description": "Record or update the task plan: a checklist of steps with statuses (pending/in_progress/completed). Replaces the current plan. Use it to track multi-step work.",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "plan": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "step": {
+                "type": "string"
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "pending",
+                  "in_progress",
+                  "completed"
+                ]
+              }
+            },
+            "required": [
+              "step"
+            ]
+          }
+        }
+      },
+      "required": [
+        "plan"
+      ],
+      "additionalProperties": false
+    }
+  }
+]