@wrongstack/tools 0.68.0 → 0.73.1

package/dist/tool-search.js

@@ -64,10 +64,14 @@ var toolSearchTool = {
       permission: t.permission,
       mutating: t.mutating
     }));
+    const totalAvailable = tools.length;
+    const hint = results.length === 0 && query ? `No tools matched "${input.query}". Use tool-help (without arguments) to see all ${totalAvailable} available tools.` : void 0;
     return {
       tools: results,
       total: filtered.length,
-      truncated: filtered.length > limit
+      truncated: filtered.length > limit,
+      ...hint ? { hint } : {},
+      _available: totalAvailable
     };
   }
 };

package/dist/tool-search.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/tool-search.ts"],"names":[],"mappings":"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","file":"tool-search.js","sourcesContent":["import type { Tool } from '@wrongstack/core';\n\ninterface ToolSearchInput {\n  query?: string;\n  tags?: string[];\n  permission?: 'auto' | 'confirm' | 'deny';\n  mutating?: boolean;\n  limit?: number;\n}\n\ninterface ToolSearchOutput {\n  tools: {\n    name: string;\n    description: string;\n    permission: string;\n    mutating: boolean;\n  }[];\n  total: number;\n  truncated: boolean;\n}\n\nexport const toolSearchTool: Tool<ToolSearchInput, ToolSearchOutput> = {\n  name: 'tool_search',\n  category: 'Meta',\n  description:\n    'Search the catalog of available tools. Very useful when you are unsure which tool to use for a task.',\n  usageHint:\n    'SELF-DISCOVERY TOOL:\\n\\n' +\n    '- Use when you need to find the right tool for a job.\\n' +\n    '- `query` searches names and descriptions.\\n' +\n    '- You can filter by `tags` (category), `permission`, or `mutating`.\\n' +\n    'Call this before guessing tool names. It helps you discover the best tool for the current situation.',\n  permission: 'auto',\n  mutating: false,\n  timeoutMs: 1_000,\n  inputSchema: {\n    type: 'object',\n    properties: {\n      query: {\n        type: 'string',\n        description: 'Search query for tool name or description',\n      },\n      tags: {\n        type: 'array',\n        items: { type: 'string' },\n        description: 'Filter by tags (e.g. \"filesystem\", \"network\", \"dev\")',\n      },\n      permission: {\n        type: 'string',\n        enum: ['auto', 'confirm', 'deny'],\n        description: 'Filter by required permission level',\n      },\n      mutating: {\n        type: 'boolean',\n        description: 'Filter by mutating flag (true=filters that modify, false=read-only)',\n      },\n      limit: {\n        type: 'integer',\n        description: 'Maximum results to return (default: 20)',\n        minimum: 1,\n        maximum: 100,\n      },\n    },\n  },\n  async execute(input, ctx) {\n    const limit = Math.min(input.limit ?? 20, 100);\n    const tools = ctx.tools;\n    const query = input.query?.toLowerCase() ?? '';\n\n    const filtered = tools.filter((t: Tool) => {\n      if (\n        query &&\n        !t.name.toLowerCase().includes(query) &&\n        !t.description.toLowerCase().includes(query)\n      ) {\n        return false;\n      }\n      if (input.tags && input.tags.length > 0) {\n        const toolCat = (t.category ?? '').toLowerCase();\n        if (!input.tags.some((tag: string) => toolCat.includes(tag.toLowerCase()))) {\n          return false;\n        }\n      }\n      if (input.permission && t.permission !== input.permission) {\n        return false;\n      }\n      if (typeof input.mutating === 'boolean' && t.mutating !== input.mutating) {\n        return false;\n      }\n      return true;\n    });\n\n    const results = filtered.slice(0, limit).map((t: Tool) => ({\n      name: t.name,\n      description: t.description,\n      permission: t.permission,\n      mutating: t.mutating,\n    }));\n\n    return {\n      tools: results,\n      total: filtered.length,\n      truncated: filtered.length > limit,\n    };\n  },\n};"]}
+{"version":3,"sources":["../src/tool-search.ts"],"names":[],"mappings":"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","file":"tool-search.js","sourcesContent":["import type { Tool } from '@wrongstack/core';\n\ninterface ToolSearchInput {\n  query?: string;\n  tags?: string[];\n  permission?: 'auto' | 'confirm' | 'deny';\n  mutating?: boolean;\n  limit?: number;\n}\n\ninterface ToolSearchOutput {\n  tools: {\n    name: string;\n    description: string;\n    permission: string;\n    mutating: boolean;\n  }[];\n  total: number;\n  truncated: boolean;\n}\n\nexport const toolSearchTool: Tool<ToolSearchInput, ToolSearchOutput> = {\n  name: 'tool_search',\n  category: 'Meta',\n  description:\n    'Search the catalog of available tools. Very useful when you are unsure which tool to use for a task.',\n  usageHint:\n    'SELF-DISCOVERY TOOL:\\n\\n' +\n    '- Use when you need to find the right tool for a job.\\n' +\n    '- `query` searches names and descriptions.\\n' +\n    '- You can filter by `tags` (category), `permission`, or `mutating`.\\n' +\n    'Call this before guessing tool names. It helps you discover the best tool for the current situation.',\n  permission: 'auto',\n  mutating: false,\n  timeoutMs: 1_000,\n  inputSchema: {\n    type: 'object',\n    properties: {\n      query: {\n        type: 'string',\n        description: 'Search query for tool name or description',\n      },\n      tags: {\n        type: 'array',\n        items: { type: 'string' },\n        description: 'Filter by tags (e.g. \"filesystem\", \"network\", \"dev\")',\n      },\n      permission: {\n        type: 'string',\n        enum: ['auto', 'confirm', 'deny'],\n        description: 'Filter by required permission level',\n      },\n      mutating: {\n        type: 'boolean',\n        description: 'Filter by mutating flag (true=filters that modify, false=read-only)',\n      },\n      limit: {\n        type: 'integer',\n        description: 'Maximum results to return (default: 20)',\n        minimum: 1,\n        maximum: 100,\n      },\n    },\n  },\n  async execute(input, ctx) {\n    const limit = Math.min(input.limit ?? 20, 100);\n    const tools = ctx.tools;\n    const query = input.query?.toLowerCase() ?? '';\n\n    const filtered = tools.filter((t: Tool) => {\n      if (\n        query &&\n        !t.name.toLowerCase().includes(query) &&\n        !t.description.toLowerCase().includes(query)\n      ) {\n        return false;\n      }\n      if (input.tags && input.tags.length > 0) {\n        const toolCat = (t.category ?? '').toLowerCase();\n        if (!input.tags.some((tag: string) => toolCat.includes(tag.toLowerCase()))) {\n          return false;\n        }\n      }\n      if (input.permission && t.permission !== input.permission) {\n        return false;\n      }\n      if (typeof input.mutating === 'boolean' && t.mutating !== input.mutating) {\n        return false;\n      }\n      return true;\n    });\n\n    const results = filtered.slice(0, limit).map((t: Tool) => ({\n      name: t.name,\n      description: t.description,\n      permission: t.permission,\n      mutating: t.mutating,\n    }));\n\n    // When no tools match, give the model actionable guidance so it\n    // doesn't spiral through random queries. Point it at tool-help\n    // which lists every available tool with descriptions.\n    const totalAvailable = tools.length;\n    const hint =\n      results.length === 0 && query\n        ? `No tools matched \"${input.query}\". Use tool-help (without arguments) to see all ${totalAvailable} available tools.`\n        : undefined;\n\n    return {\n      tools: results,\n      total: filtered.length,\n      truncated: filtered.length > limit,\n      ...(hint ? { hint } : {}),\n      _available: totalAvailable,\n    };\n  },\n};"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrongstack/tools",
-  "version": "0.68.0",
+  "version": "0.73.1",
   "license": "MIT",
   "description": "WrongStack built-in tools: read/write/edit, bash/exec, grep/glob, git, fetch, test, lint, and more.",
   "repository": {
@@ -175,7 +175,7 @@
   "dependencies": {
     "typescript": "^5.9.3",
     "undici": "^7.25.0",
-    "@wrongstack/core": "0.68.0"
+    "@wrongstack/core": "0.73.1"
   },
   "devDependencies": {
     "@types/node": "^22.19.19",