@wrongstack/tools 0.2.0 → 0.3.2

package/dist/index.js

@@ -48,6 +48,7 @@ function isBinaryBuffer(buf) {
 var MAX_BYTES = 5 * 1024 * 1024;
 var readTool = {
   name: "read",
+  category: "Filesystem",
   description: "Read the contents of a file. Lines are 1-indexed and prefixed with line numbers.",
   usageHint: "Read a file before editing it. Returns lines numbered like `   1\u2192content`. Use `offset` and `limit` for large files (default reads up to 2000 lines).",
   permission: "auto",
@@ -99,6 +100,7 @@ var readTool = {
 };
 var writeTool = {
   name: "write",
+  category: "Filesystem",
   description: "Write or overwrite a file. For existing files, prefer `edit` over `write`.",
   usageHint: "Use `write` for new files or full replacements. For partial edits use `edit`. Existing files must have been `read` first in this session.",
   permission: "confirm",
@@ -149,6 +151,7 @@ var writeTool = {
 };
 var editTool = {
   name: "edit",
+  category: "Filesystem",
   description: "Make a surgical edit by replacing exact text. Fails if `old_string` is not unique unless `replace_all` is true.",
   usageHint: "Always `read` the file first. `old_string` must be an EXACT match (whitespace included). If multiple matches exist, either narrow `old_string` with more context or set `replace_all: true`.",
   permission: "confirm",
@@ -302,6 +305,7 @@ function capSubject(line) {
 var DEFAULT_IGNORE = ["node_modules", ".git", "dist", "build", ".next", "coverage"];
 var replaceTool = {
   name: "replace",
+  category: "Transform",
   description: "Batch replace a pattern across multiple files matched by glob. Returns diff for each modified file.",
   usageHint: 'Use `glob` for broad patterns (e.g. "**/*.ts"). Set `dry_run: true` to preview without modifying. `files` can be a single path, comma-separated list, or glob pattern.',
   permission: "confirm",
@@ -491,6 +495,7 @@ async function globNative(pattern, base, extraGlob) {
 var DEFAULT_IGNORE2 = ["node_modules", ".git", "dist", "build", ".next", "coverage", ".turbo"];
 var globTool = {
   name: "glob",
+  category: "Filesystem",
   description: "Find files matching a glob pattern. Returns paths sorted by mtime (newest first).",
   usageHint: "Examples: `**/*.ts`, `src/**/*.test.ts`, `*.json`. Common dirs (node_modules, .git, dist) are ignored by default. Returns up to 1000 paths.",
   permission: "auto",
@@ -565,6 +570,7 @@ async function readGitignore(dir) {
 var DEFAULT_IGNORE3 = ["node_modules", ".git", "dist", "build", ".next", "coverage"];
 var grepTool = {
   name: "grep",
+  category: "Search",
   description: "Search file contents with a regex. Uses ripgrep when available.",
   usageHint: 'Pattern is regex. Use `output_mode: "content"` for matched lines, `"files_with_matches"` for paths, `"count"` for tallies. `glob` filters files (e.g. `*.ts`).',
   permission: "auto",
@@ -597,6 +603,10 @@ var grepTool = {
     const base = input.path ? safeResolve(input.path, ctx) : ctx.cwd;
     const mode = input.output_mode ?? "content";
     const limit = Math.max(1, Math.min(input.limit ?? 200, 2e3));
+    const validation = compileUserRegex(input.pattern, input.case_insensitive ? "i" : "");
+    if (!validation.ok) {
+      throw new Error(`grep: ${validation.reason}`);
+    }
     const rgAvailable = await detectRg(opts.signal);
     if (rgAvailable) {
       try {
@@ -630,11 +640,15 @@ async function* runRgStream(input, base, mode, limit, signal) {
     args.push("-n");
     if (input.context_lines) args.push("-C", String(input.context_lines));
   }
+  for (const ignored of DEFAULT_IGNORE3) {
+    args.push("--glob", `!${ignored}/**`, "--glob", `!**/${ignored}/**`);
+  }
   if (input.glob) args.push("--glob", input.glob);
   args.push("--", input.pattern, base);
   const matches = [];
   let buf = "";
   let totalLines = 0;
+  let totalCount = 0;
   let batchSinceFlush = 0;
   const FLUSH_AT = 16;
   const MAX_BUF_BYTES = 1e6;
@@ -691,6 +705,7 @@ async function* runRgStream(input, base, mode, limit, signal) {
     for (const line of ready.split("\n")) {
       if (!line) continue;
       totalLines++;
+      if (mode === "count") totalCount += parseRgCountLine(line);
       if (matches.length < limit) {
         matches.push(line);
         pendingBatch.push(line);
@@ -711,6 +726,7 @@ async function* runRgStream(input, base, mode, limit, signal) {
     for (const line of buf.split("\n")) {
       if (!line) continue;
       totalLines++;
+      if (mode === "count") totalCount += parseRgCountLine(line);
       if (matches.length < limit) {
         matches.push(line);
         pendingBatch.push(line);
@@ -729,12 +745,18 @@ async function* runRgStream(input, base, mode, limit, signal) {
     type: "final",
     output: {
       matches,
-      count: totalLines,
+      count: mode === "count" ? totalCount : totalLines,
       truncated: totalLines > limit || bufOverflow,
       used: "rg"
     }
   };
 }
+function parseRgCountLine(line) {
+  const idx = line.lastIndexOf(":");
+  if (idx === -1) return 0;
+  const n = Number.parseInt(line.slice(idx + 1), 10);
+  return Number.isFinite(n) ? n : 0;
+}
 async function runNative(input, base, mode, limit, signal) {
   const flags = input.case_insensitive ? "i" : "";
   const compiled = compileUserRegex(input.pattern, flags);
@@ -815,6 +837,7 @@ var STREAM_FLUSH_INTERVAL_MS = 200;
 var STREAM_FLUSH_BYTES = 4 * 1024;
 var bashTool = {
   name: "bash",
+  category: "Shell",
   description: "Run a shell command. stdout and stderr are merged.",
   usageHint: "Runs via `bash -c` (or `cmd /c` on Windows). Cwd is the project root. Default timeout 30s. Output truncated from the middle if oversized. Use for git, npm, builds, tests.",
   permission: "confirm",
@@ -991,9 +1014,9 @@ var bashTool = {
   }
 };
 var ALLOWED_COMMANDS = {
-  node: ["--version", "-e", "-p", "-r", "--input-type=module"],
-  npm: ["--version", "init", "install", "test", "run", "list", "pkg", "doctor"],
-  pnpm: ["--version", "init", "install", "add", "remove", "exec", "list", "run", "dlx"],
+  node: ["--version", "-r", "--input-type=module"],
+  npm: ["--version", "init", "install", "test", "list", "pkg", "doctor"],
+  pnpm: ["--version", "init", "install", "add", "remove", "list"],
   npx: ["--version"],
   git: [
     "--version",
@@ -1021,7 +1044,7 @@ var ALLOWED_COMMANDS = {
   mv: [],
   rm: ["-rf"],
   touch: [],
-  bun: ["--version", "run", "add", "init"],
+  bun: ["--version", "add", "init"],
   tsc: ["--version", "--noEmit", "--project"],
   vitest: ["--version", "run", "--coverage"],
   biome: ["--version", "lint", "format", "check"],
@@ -1038,6 +1061,7 @@ var MAX_OUTPUT2 = 2e5;
 var TIMEOUT_MS = 3e4;
 var execTool = {
   name: "exec",
+  category: "Shell",
   description: "Restricted shell that only runs pre-approved commands with constrained arguments. Safer alternative to `bash`.",
   usageHint: "Set `command` (must be in allowlist). `args` passed through. For arbitrary shell access use the `bash` tool instead.",
   permission: "confirm",
@@ -1183,6 +1207,7 @@ async function fetchWithRedirectLimit(url, maxRedirects, signal) {
 }
 var fetchTool = {
   name: "fetch",
+  category: "Network",
   description: "Fetch the contents of a URL. HTML is converted to markdown by default.",
   usageHint: "HTTPS only by default. Localhost and RFC1918 ranges blocked unless WRONGSTACK_FETCH_ALLOW_PRIVATE=1. Max 5 redirects, 20s timeout, 128KB cap.",
   permission: "confirm",
@@ -1414,7 +1439,10 @@ function htmlToMarkdown(html) {
   });
   s = s.replace(/<(strong|b)[^>]*>([\s\S]*?)<\/\1>/gi, "**$2**");
   s = s.replace(/<(em|i)[^>]*>([\s\S]*?)<\/\1>/gi, "*$2*");
-  s = s.replace(/<a [^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a>/gi, "[$2]($1)");
+  s = s.replace(/<a [^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a>/gi, (_m, href, text) => {
+    const safe = /^(https?|ftps?):\/\//i.test(href);
+    return safe ? `[${text}](${href})` : text;
+  });
   s = s.replace(/<pre[^>]*>([\s\S]*?)<\/pre>/gi, (_m, c) => "\n```\n" + stripTags(c) + "\n```\n");
   s = s.replace(/<code[^>]*>([\s\S]*?)<\/code>/gi, "`$1`");
   s = s.replace(/<li[^>]*>([\s\S]*?)<\/li>/gi, "- $1\n");
@@ -1434,6 +1462,7 @@ var MAX_RESULTS = 50;
 var TIMEOUT_MS3 = 15e3;
 var searchTool = {
   name: "search",
+  category: "Search",
   description: "Search the web for information. Returns title, URL, and snippet for each result.",
   usageHint: "Set `num_results` (1-50, default 10). Use `source` to pick engine: duckduckgo (default), google, bing.",
   permission: "confirm",
@@ -1644,6 +1673,7 @@ function stripTags2(html) {
 // src/todo.ts
 var todoTool = {
   name: "todo",
+  category: "Session",
   description: "Replace the current todo list with a new set of items.",
   usageHint: "Use for multi-step tasks. Replace the full list on each call. At most ONE task may be in_progress at a time. Items have id, content, status (pending|in_progress|completed), and optional activeForm.",
   permission: "auto",
@@ -1692,6 +1722,7 @@ var todoTool = {
 };
 var planTool = {
   name: "plan",
+  category: "Session",
   description: "Inspect or edit the strategic plan board for this session. Plans persist across resume (unlike todos). Use this to lay out the multi-step approach before diving in, then mark steps in_progress/done as the work proceeds.",
   usageHint: "Set action to one of: show | add | start | done | remove | clear. Pass `title` for add. Pass `target` (item id, 1-based index, or title substring) for start/done/remove. Always returns the formatted plan plus open/total counts.",
   permission: "auto",
@@ -1791,6 +1822,7 @@ var TIMEOUT_MS4 = 3e4;
 var MAX_OUTPUT3 = 1e5;
 var gitTool = {
   name: "git",
+  category: "Git",
   description: "Run git commands. Wraps common operations: status, log, diff, commit, branch, checkout, stash, push, pull, fetch, reset.",
   usageHint: "Prefer built-in subcommands over raw args. `command` is required. `message` for commits. `branch` for checkout/branch. `files` for status/diff. `format` for log.",
   permission: "confirm",
@@ -1892,11 +1924,11 @@ function buildArgs(input) {
         ...files.length ? ["--", ...files] : []
       ];
     case "branch":
-      return input.branch ? ["branch", input.branch] : ["branch"];
+      return input.branch ? ["branch", ...input.branch.startsWith("-") ? [] : [input.branch]] : ["branch"];
     case "checkout":
       return [
         "checkout",
-        ...input.branch ? [input.branch] : [],
+        ...input.branch ? ["--", input.branch] : [],
         ...files.length ? ["--", ...files] : []
       ];
     case "stash":
@@ -1954,6 +1986,7 @@ function runGit(args, cwd, signal) {
 }
 var patchTool = {
   name: "patch",
+  category: "Filesystem",
   description: "Apply a unified diff patch to files. Writes .orig and .rej files on failure.",
   usageHint: "Set `patch` (the diff text). `directory` defaults to cwd. `strip` removes leading path components. `dry_run` previews.",
   permission: "confirm",
@@ -2062,6 +2095,7 @@ function extractPatchedFiles(output) {
 }
 var jsonTool = {
   name: "json",
+  category: "Data",
   description: "Parse, query, and validate JSON/JSON5/YAML. Use `query` with JMESPath-like paths to extract values.",
   usageHint: 'Provide `file` path or `data` string. `query` supports dot notation (e.g. "results[0].name"). `format` outputs in specified format.',
   permission: "auto",
@@ -2182,6 +2216,7 @@ function toYaml(data, indent = 0) {
 }
 var diffTool = {
   name: "diff",
+  category: "Filesystem",
   description: "Show differences between files, commits, or branches. Supports staged vs working tree.",
   usageHint: "Use `files` for file paths, `a`/`b` for commit refs, `staged` for git index. `mode`: unified (default), stat, side-by-side.",
   permission: "auto",
@@ -2307,6 +2342,7 @@ var DEFAULT_IGNORE4 = [
 ];
 var treeTool = {
   name: "tree",
+  category: "Filesystem",
   description: "Display directory structure as an ASCII tree. Shows files and folders with indentation.",
   usageHint: "Set `path` (default: cwd). `depth` limits nesting (default: 3). `glob` filters files. `exclude` ignores dirs. `show_files` toggles file listing (default: true).",
   permission: "auto",
@@ -2541,6 +2577,7 @@ async function* spawnStream(opts) {
 // src/lint.ts
 var lintTool = {
   name: "lint",
+  category: "Code Quality",
   description: "Run a linter on files. Auto-detects biome, eslint, or tslint. Use `fix` to auto-fix issues.",
   usageHint: "Set `files` (glob or comma-separated). `fix` applies corrections. `linter` forces specific tool.",
   permission: "confirm",
@@ -2632,6 +2669,7 @@ async function detectLinter(cwd) {
 // src/format.ts
 var formatTool = {
   name: "format",
+  category: "Code Quality",
   description: "Format files with biome or prettier. Use `check` to verify without modifying.",
   usageHint: "Set `files` (glob or comma-separated). `check` only validates. `fixer` forces tool.",
   permission: "confirm",
@@ -2728,6 +2766,7 @@ async function detectFixer(cwd) {
 }
 var typecheckTool = {
   name: "typecheck",
+  category: "Code Quality",
   description: "Run TypeScript type checking with `tsc --noEmit`. Checks for type errors without compiling.",
   usageHint: "Set `project` for tsconfig path (default: nearest). `strict` enables strictest flags. `all` checks all projects in workspace.",
   permission: "confirm",
@@ -2807,6 +2846,7 @@ async function findTsConfig(cwd) {
 }
 var testTool = {
   name: "test",
+  category: "Code Quality",
   description: "Run tests with vitest, jest, or mocha. Returns pass/fail counts and output.",
   usageHint: "Set `files` for specific tests. `watch` enables watch mode. `coverage` generates coverage report. `grep` filters by name.",
   permission: "confirm",
@@ -2954,6 +2994,7 @@ function parseResult(runner, result, duration) {
 // src/install.ts
 var installTool = {
   name: "install",
+  category: "Package Management",
   description: "Install npm packages. Detects pnpm/npm/yarn and uses the right package manager.",
   usageHint: "Set `packages` to install. `save` as dependency type. `global` for global install. `dry_run` to preview.",
   permission: "confirm",
@@ -3049,6 +3090,7 @@ async function detectPackageManager(cwd) {
 // src/audit.ts
 var auditTool = {
   name: "audit",
+  category: "Package Management",
   description: "Run npm/pnpm security audit. Returns vulnerabilities sorted by severity.",
   usageHint: "Set `level` to filter minimum severity. `fix` attempts auto-fix. `packages` checks specific packages.",
   permission: "confirm",
@@ -3156,6 +3198,7 @@ function parseAuditOutput(json, exitCode) {
 }
 var outdatedTool = {
   name: "outdated",
+  category: "Package Management",
   description: "Check for outdated npm packages. Shows current, wanted, and latest versions.",
   usageHint: "Set `check` to filter specific packages. `format` as list or table. `include_deprecated` shows deprecated packages.",
   permission: "auto",
@@ -3267,6 +3310,7 @@ function parseOutdatedOutput(json, exitCode) {
 }
 var logsTool = {
   name: "logs",
+  category: "Logs",
   description: "Stream or fetch logs from a service or file. Supports Docker, systemd, or plain log files.",
   usageHint: "Set `service` for Docker/systemd, `path` for file. `lines` limits output. `stream` for tail -f behavior. `filter` regex filters lines.",
   permission: "confirm",
@@ -3444,6 +3488,7 @@ function parseLine(line) {
 }
 var documentTool = {
   name: "document",
+  category: "Project",
   description: "Generate or update documentation comments for functions, classes, and types. Supports JSDoc, TSDoc, and block comments.",
   usageHint: "Set `target` for what to document. `files` for paths. `style` for comment format. `overwrite` replaces existing docs.",
   permission: "confirm",
@@ -3683,6 +3728,7 @@ describe('{{Name}}', () => {
 };
 var scaffoldTool = {
   name: "scaffold",
+  category: "Project",
   description: "Generate boilerplate code from built-in templates or paths. Creates package.json, source files, tests.",
   usageHint: "Set `template` (npm-package, cli-tool, react-component) and `name`. `vars` for template variables. `dry_run` preview.",
   permission: "confirm",
@@ -3768,6 +3814,7 @@ function substituteVars(content, name, vars) {
 // src/tool-search.ts
 var toolSearchTool = {
   name: "tool_search",
+  category: "Meta",
   description: "Search available tools by name, description, tags, permission level, or mutating flag.",
   usageHint: "Set `query` for keyword search. `tags` to filter by category. `permission` to filter by required permission. `mutating` to filter by mutating flag.",
   permission: "auto",
@@ -3835,6 +3882,7 @@ var toolSearchTool = {
 // src/tool-use.ts
 var toolUseTool = {
   name: "tool_use",
+  category: "Meta",
   description: "Execute a specific tool by name with given input. Useful when the agent knows exactly which tool to call.",
   usageHint: "Set `tool` with exact tool name and `input` with the tool parameters. Returns result or error.",
   permission: "confirm",
@@ -3903,6 +3951,7 @@ var toolUseTool = {
 // src/batch-tool-use.ts
 var batchToolUseTool = {
   name: "batch_tool_use",
+  category: "Meta",
   description: "Execute multiple tool calls in sequence or parallel. Returns all results.",
   usageHint: "Set `calls` array with tool names and inputs. `stop_on_error` halts on first failure. `parallel` runs concurrently (default: true).",
   permission: "confirm",
@@ -4006,6 +4055,7 @@ async function executeSingle(call, ctx, opts) {
 // src/tool-help.ts
 var toolHelpTool = {
   name: "tool_help",
+  category: "Meta",
   description: "Get help and usage information for a specific tool or list all available tools.",
   usageHint: "Set `tool` for specific help. Omit to list all tools. `format`: short (one-liner), full (schema), markdown (formatted).",
   permission: "auto",
@@ -4128,6 +4178,7 @@ function formatAllToolsMarkdown(tools) {
 function rememberTool(memory) {
   return {
     name: "remember",
+    category: "Session",
     description: "Persist a short note to project or user memory.",
     usageHint: "Use sparingly. Only for facts that should outlive the session (project conventions, user preferences). Transient state belongs in `todo`. Scope defaults to project-memory.",
     permission: "auto",
@@ -4152,6 +4203,7 @@ function rememberTool(memory) {
 function forgetTool(memory) {
   return {
     name: "forget",
+    category: "Session",
     description: "Remove memory entries matching a substring (case-insensitive).",
     usageHint: "Removes ALL matching bullet lines in the given scope. Use a unique substring.",
     permission: "confirm",
@@ -4178,6 +4230,7 @@ function forgetTool(memory) {
 function createModeTool(modeStore) {
   return {
     name: "mode",
+    category: "Session",
     description: "Get, list, or switch the agent mode. Modes inject role-specific prompts into the system prompt.",
     usageHint: "Set `action`: `get` (current mode), `list` (all modes), `set <modeId>` (switch), `clear` (reset to default).",
     permission: "confirm",
@@ -4291,6 +4344,13 @@ var builtinTools = [
   toolHelpTool
 ];
 
-export { auditTool, bashTool, batchToolUseTool, builtinTools, createModeTool, diffTool, documentTool, editTool, execTool, fetchTool, forgetTool, formatTool, gitTool, globTool, grepTool, installTool, jsonTool, lintTool, logsTool, outdatedTool, patchTool, planTool, readTool, rememberTool, replaceTool, scaffoldTool, searchTool, testTool, todoTool, toolHelpTool, toolSearchTool, toolUseTool, treeTool, typecheckTool, writeTool };
+// src/pack.ts
+var builtinToolsPack = {
+  name: "builtin-tools",
+  description: "WrongStack built-in filesystem, execution, network, lifecycle, and agent-control tools.",
+  tools: builtinTools
+};
+
+export { auditTool, bashTool, batchToolUseTool, builtinTools, builtinToolsPack, createModeTool, diffTool, documentTool, editTool, execTool, fetchTool, forgetTool, formatTool, gitTool, globTool, grepTool, installTool, jsonTool, lintTool, logsTool, outdatedTool, patchTool, planTool, readTool, rememberTool, replaceTool, scaffoldTool, searchTool, testTool, todoTool, toolHelpTool, toolSearchTool, toolUseTool, treeTool, typecheckTool, writeTool };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map