@mcpc-tech/core 0.3.19 → 0.3.21

package/index.cjs

@@ -17784,7 +17784,7 @@ You must follow the <manual/>, obey the <rules/>, and use the <format/>.
 
 <parameters>
 \`tool\` - Which tool to execute: "man" to get schemas, or a tool name to execute
-\`args\` - For "man": array of tool names. For other tools: object with parameters.
+\`args\` - For "man": { tools: ["tool1", "tool2"] }. For other tools: tool parameters that strictly adhere to the tool's JSON schema.
 </parameters>
 
 <rules>
@@ -17799,7 +17799,7 @@ Get tool schemas:
 \`\`\`json
 {
   "tool": "man",
-  "args": ["tool1", "tool2"]
+  "args": { "tools": ["tool1", "tool2"] }
 }
 \`\`\`
 
@@ -17898,6 +17898,106 @@ var CompiledPrompts = {
   completionMessage: () => ResponseTemplates.COMPLETION_MESSAGE
 };
 
+// __mcpc__core_latest/node_modules/@mcpc/core/src/factories/args-def-factory.js
+function createArgsDefFactory(_name, _allToolNames, _depGroups, _predefinedSteps, _ensureStepActions) {
+  return {
+    forSampling: function() {
+      return {
+        type: "object",
+        description: "Provide prompt for autonomous tool execution",
+        properties: {
+          prompt: {
+            type: "string",
+            description: "The task to be completed autonomously by the agentic system using available tools"
+          },
+          context: {
+            type: "object",
+            description: "Execution context, e.g., { cwd: '/path/to/dir' }. Any relevant fields allowed.",
+            additionalProperties: true
+          }
+        },
+        required: [
+          "prompt",
+          "context"
+        ],
+        errorMessage: {
+          required: {
+            prompt: "Missing required field 'prompt'. Please provide a clear task description.",
+            context: "Missing required field 'context'. Please provide relevant context (e.g., { cwd: '...' })."
+          }
+        }
+      };
+    },
+    /**
+     * Agentic schema - simplified Unix-style interface
+     *
+     * Only two fields:
+     * - `tool`: which tool to execute (enum includes "man" + all tool names)
+     * - `args`: object with parameters. For "man": { tools: ["a", "b"] }. For others: tool parameters.
+     */
+    forAgentic: function(allToolNames) {
+      const toolEnum = [
+        "man",
+        ...allToolNames
+      ];
+      return {
+        type: "object",
+        properties: {
+          tool: {
+            type: "string",
+            enum: toolEnum,
+            description: 'Which tool to execute. Use "man" to get tool schemas, or a tool name to execute.',
+            errorMessage: {
+              enum: `Invalid tool. Available: ${toolEnum.join(", ")}`
+            }
+          },
+          args: {
+            type: "object",
+            description: `For "man": { tools: ["tool1", "tool2"] }. For other tools: tool parameters that strictly adhere to the tool's JSON schema.`
+          }
+        },
+        required: [
+          "tool"
+        ],
+        additionalProperties: false
+      };
+    },
+    /**
+     * Schema for "man" command args validation
+     * Expected format: { tools: ["tool1", "tool2"] }
+     */
+    forMan: function(allToolNames) {
+      return {
+        type: "object",
+        properties: {
+          tools: {
+            type: "array",
+            items: {
+              type: "string",
+              enum: allToolNames,
+              errorMessage: {
+                enum: `Invalid tool name. Available: ${allToolNames.join(", ")}`
+              }
+            },
+            minItems: 1,
+            errorMessage: {
+              minItems: "At least one tool name is required"
+            }
+          }
+        },
+        required: [
+          "tools"
+        ],
+        errorMessage: {
+          required: {
+            tools: 'Missing "tools" field. Expected: { tools: ["tool1", "tool2"] }'
+          }
+        }
+      };
+    }
+  };
+}
+
 // __mcpc__core_latest/node_modules/@mcpc/core/src/utils/schema-validator.js
 var import_ajv2 = require("ajv");
 var import_ajv_formats2 = __toESM(require("ajv-formats"), 1);
@@ -18069,22 +18169,9 @@ var AgenticExecutor = class {
       }
       const tool2 = args.tool;
       if (tool2 === "man") {
-        const manSchema = {
-          type: "array",
-          items: {
-            type: "string",
-            enum: this.allToolNames,
-            errorMessage: {
-              enum: `Invalid tool name. Available: ${this.allToolNames.join(", ")}`
-            }
-          },
-          minItems: 1,
-          errorMessage: {
-            type: 'Expected an array of tool names, e.g. ["tool1", "tool2"]',
-            minItems: "At least one tool name is required"
-          }
-        };
-        const manValidation = validateSchema(args.args ?? [], manSchema);
+        const createArgsDef = createArgsDefFactory(this.name, this.allToolNames, {});
+        const manSchema = createArgsDef.forMan(this.allToolNames);
+        const manValidation = validateSchema(args.args ?? {}, manSchema);
         if (!manValidation.valid) {
           return {
             content: [
@@ -18096,7 +18183,8 @@ var AgenticExecutor = class {
             isError: true
           };
         }
-        return this.handleManCommand(args.args, executeSpan);
+        const argsObj = args.args;
+        return this.handleManCommand(argsObj.tools, executeSpan);
       }
       const toolArgs = args.args || {};
       return await this.executeTool(tool2, toolArgs, executeSpan);
@@ -18273,72 +18361,6 @@ ${JSON.stringify(cleanedSchema, null, 2)}
   }
 };
 
-// __mcpc__core_latest/node_modules/@mcpc/core/src/factories/args-def-factory.js
-function createArgsDefFactory(_name, _allToolNames, _depGroups, _predefinedSteps, _ensureStepActions) {
-  return {
-    forSampling: function() {
-      return {
-        type: "object",
-        description: "Provide prompt for autonomous tool execution",
-        properties: {
-          prompt: {
-            type: "string",
-            description: "The task to be completed autonomously by the agentic system using available tools"
-          },
-          context: {
-            type: "object",
-            description: "Execution context, e.g., { cwd: '/path/to/dir' }. Any relevant fields allowed.",
-            additionalProperties: true
-          }
-        },
-        required: [
-          "prompt",
-          "context"
-        ],
-        errorMessage: {
-          required: {
-            prompt: "Missing required field 'prompt'. Please provide a clear task description.",
-            context: "Missing required field 'context'. Please provide relevant context (e.g., { cwd: '...' })."
-          }
-        }
-      };
-    },
-    /**
-     * Agentic schema - simplified Unix-style interface
-     *
-     * Only two fields:
-     * - `tool`: which tool to execute (enum includes "man" + all tool names)
-     * - `args`: parameters for the tool (array for "man", object for others)
-     */
-    forAgentic: function(allToolNames) {
-      const toolEnum = [
-        "man",
-        ...allToolNames
-      ];
-      return {
-        type: "object",
-        properties: {
-          tool: {
-            type: "string",
-            enum: toolEnum,
-            description: 'Which tool to execute. Use "man" to get tool schemas, or a tool name to execute.',
-            errorMessage: {
-              enum: `Invalid tool. Available: ${toolEnum.join(", ")}`
-            }
-          },
-          args: {
-            description: 'For "man": array of tool names ["tool1", "tool2"]. For other tools: object with parameters.'
-          }
-        },
-        required: [
-          "tool"
-        ],
-        additionalProperties: false
-      };
-    }
-  };
-}
-
 // __mcpc__core_latest/node_modules/@mcpc/core/src/executors/agentic/agentic-tool-registrar.js
 function registerAgenticTool(server, { description, name, allToolNames, depGroups, toolNameToDetailList }) {
   const createArgsDef = createArgsDefFactory(name, allToolNames, depGroups, void 0, void 0);
@@ -19665,7 +19687,7 @@ var ToolManager = class {
       description,
       schema
     });
-    if (options.internal) {
+    if (options.hidden) {
       this.toolConfigs.set(name, {
         visibility: {
           hidden: true
@@ -19685,6 +19707,11 @@ var ToolManager = class {
         inputSchema: schema
       });
     }
+    this.toolConfigs.set(name, {
+      visibility: {
+        public: true
+      }
+    });
   }
   /**
    * Check if a tool is public (exposed to MCP clients)
@@ -20293,11 +20320,11 @@ var ComposableMCPServer = class extends Server {
     const toolNameToDetailList = Object.entries(allTools);
     const publicToolNames = this.getPublicToolNames();
     const hiddenToolNames = this.getHiddenToolNames();
-    const contextToolNames = toolNameToDetailList.map(([name2]) => name2).filter((n) => !hiddenToolNames.includes(n));
+    const contextToolNames = toolNameToDetailList.map(([name2]) => name2).filter((n) => !hiddenToolNames.includes(n) && !publicToolNames.includes(n));
     publicToolNames.forEach((toolId) => {
       const tool2 = allTools[toolId];
       if (!tool2) {
-        throw new Error(`Public tool ${toolId} not found in registry, available: ${Object.keys(allTools).join(", ")}`);
+        return;
       }
       this.tool(toolId, tool2.description || "", jsonSchema(tool2.inputSchema), tool2.execute, {
         internal: false

package/index.mjs

@@ -17772,7 +17772,7 @@ You must follow the <manual/>, obey the <rules/>, and use the <format/>.
 
 <parameters>
 \`tool\` - Which tool to execute: "man" to get schemas, or a tool name to execute
-\`args\` - For "man": array of tool names. For other tools: object with parameters.
+\`args\` - For "man": { tools: ["tool1", "tool2"] }. For other tools: tool parameters that strictly adhere to the tool's JSON schema.
 </parameters>
 
 <rules>
@@ -17787,7 +17787,7 @@ Get tool schemas:
 \`\`\`json
 {
   "tool": "man",
-  "args": ["tool1", "tool2"]
+  "args": { "tools": ["tool1", "tool2"] }
 }
 \`\`\`
 
@@ -17886,6 +17886,106 @@ var CompiledPrompts = {
   completionMessage: () => ResponseTemplates.COMPLETION_MESSAGE
 };
 
+// __mcpc__core_latest/node_modules/@mcpc/core/src/factories/args-def-factory.js
+function createArgsDefFactory(_name, _allToolNames, _depGroups, _predefinedSteps, _ensureStepActions) {
+  return {
+    forSampling: function() {
+      return {
+        type: "object",
+        description: "Provide prompt for autonomous tool execution",
+        properties: {
+          prompt: {
+            type: "string",
+            description: "The task to be completed autonomously by the agentic system using available tools"
+          },
+          context: {
+            type: "object",
+            description: "Execution context, e.g., { cwd: '/path/to/dir' }. Any relevant fields allowed.",
+            additionalProperties: true
+          }
+        },
+        required: [
+          "prompt",
+          "context"
+        ],
+        errorMessage: {
+          required: {
+            prompt: "Missing required field 'prompt'. Please provide a clear task description.",
+            context: "Missing required field 'context'. Please provide relevant context (e.g., { cwd: '...' })."
+          }
+        }
+      };
+    },
+    /**
+     * Agentic schema - simplified Unix-style interface
+     *
+     * Only two fields:
+     * - `tool`: which tool to execute (enum includes "man" + all tool names)
+     * - `args`: object with parameters. For "man": { tools: ["a", "b"] }. For others: tool parameters.
+     */
+    forAgentic: function(allToolNames) {
+      const toolEnum = [
+        "man",
+        ...allToolNames
+      ];
+      return {
+        type: "object",
+        properties: {
+          tool: {
+            type: "string",
+            enum: toolEnum,
+            description: 'Which tool to execute. Use "man" to get tool schemas, or a tool name to execute.',
+            errorMessage: {
+              enum: `Invalid tool. Available: ${toolEnum.join(", ")}`
+            }
+          },
+          args: {
+            type: "object",
+            description: `For "man": { tools: ["tool1", "tool2"] }. For other tools: tool parameters that strictly adhere to the tool's JSON schema.`
+          }
+        },
+        required: [
+          "tool"
+        ],
+        additionalProperties: false
+      };
+    },
+    /**
+     * Schema for "man" command args validation
+     * Expected format: { tools: ["tool1", "tool2"] }
+     */
+    forMan: function(allToolNames) {
+      return {
+        type: "object",
+        properties: {
+          tools: {
+            type: "array",
+            items: {
+              type: "string",
+              enum: allToolNames,
+              errorMessage: {
+                enum: `Invalid tool name. Available: ${allToolNames.join(", ")}`
+              }
+            },
+            minItems: 1,
+            errorMessage: {
+              minItems: "At least one tool name is required"
+            }
+          }
+        },
+        required: [
+          "tools"
+        ],
+        errorMessage: {
+          required: {
+            tools: 'Missing "tools" field. Expected: { tools: ["tool1", "tool2"] }'
+          }
+        }
+      };
+    }
+  };
+}
+
 // __mcpc__core_latest/node_modules/@mcpc/core/src/utils/schema-validator.js
 import { Ajv as Ajv2 } from "ajv";
 import addFormats from "ajv-formats";
@@ -18057,22 +18157,9 @@ var AgenticExecutor = class {
       }
       const tool2 = args.tool;
       if (tool2 === "man") {
-        const manSchema = {
-          type: "array",
-          items: {
-            type: "string",
-            enum: this.allToolNames,
-            errorMessage: {
-              enum: `Invalid tool name. Available: ${this.allToolNames.join(", ")}`
-            }
-          },
-          minItems: 1,
-          errorMessage: {
-            type: 'Expected an array of tool names, e.g. ["tool1", "tool2"]',
-            minItems: "At least one tool name is required"
-          }
-        };
-        const manValidation = validateSchema(args.args ?? [], manSchema);
+        const createArgsDef = createArgsDefFactory(this.name, this.allToolNames, {});
+        const manSchema = createArgsDef.forMan(this.allToolNames);
+        const manValidation = validateSchema(args.args ?? {}, manSchema);
         if (!manValidation.valid) {
           return {
             content: [
@@ -18084,7 +18171,8 @@ var AgenticExecutor = class {
             isError: true
           };
         }
-        return this.handleManCommand(args.args, executeSpan);
+        const argsObj = args.args;
+        return this.handleManCommand(argsObj.tools, executeSpan);
       }
       const toolArgs = args.args || {};
       return await this.executeTool(tool2, toolArgs, executeSpan);
@@ -18261,72 +18349,6 @@ ${JSON.stringify(cleanedSchema, null, 2)}
   }
 };
 
-// __mcpc__core_latest/node_modules/@mcpc/core/src/factories/args-def-factory.js
-function createArgsDefFactory(_name, _allToolNames, _depGroups, _predefinedSteps, _ensureStepActions) {
-  return {
-    forSampling: function() {
-      return {
-        type: "object",
-        description: "Provide prompt for autonomous tool execution",
-        properties: {
-          prompt: {
-            type: "string",
-            description: "The task to be completed autonomously by the agentic system using available tools"
-          },
-          context: {
-            type: "object",
-            description: "Execution context, e.g., { cwd: '/path/to/dir' }. Any relevant fields allowed.",
-            additionalProperties: true
-          }
-        },
-        required: [
-          "prompt",
-          "context"
-        ],
-        errorMessage: {
-          required: {
-            prompt: "Missing required field 'prompt'. Please provide a clear task description.",
-            context: "Missing required field 'context'. Please provide relevant context (e.g., { cwd: '...' })."
-          }
-        }
-      };
-    },
-    /**
-     * Agentic schema - simplified Unix-style interface
-     *
-     * Only two fields:
-     * - `tool`: which tool to execute (enum includes "man" + all tool names)
-     * - `args`: parameters for the tool (array for "man", object for others)
-     */
-    forAgentic: function(allToolNames) {
-      const toolEnum = [
-        "man",
-        ...allToolNames
-      ];
-      return {
-        type: "object",
-        properties: {
-          tool: {
-            type: "string",
-            enum: toolEnum,
-            description: 'Which tool to execute. Use "man" to get tool schemas, or a tool name to execute.',
-            errorMessage: {
-              enum: `Invalid tool. Available: ${toolEnum.join(", ")}`
-            }
-          },
-          args: {
-            description: 'For "man": array of tool names ["tool1", "tool2"]. For other tools: object with parameters.'
-          }
-        },
-        required: [
-          "tool"
-        ],
-        additionalProperties: false
-      };
-    }
-  };
-}
-
 // __mcpc__core_latest/node_modules/@mcpc/core/src/executors/agentic/agentic-tool-registrar.js
 function registerAgenticTool(server, { description, name, allToolNames, depGroups, toolNameToDetailList }) {
   const createArgsDef = createArgsDefFactory(name, allToolNames, depGroups, void 0, void 0);
@@ -19652,7 +19674,7 @@ var ToolManager = class {
       description,
       schema
     });
-    if (options.internal) {
+    if (options.hidden) {
       this.toolConfigs.set(name, {
         visibility: {
           hidden: true
@@ -19672,6 +19694,11 @@ var ToolManager = class {
         inputSchema: schema
       });
     }
+    this.toolConfigs.set(name, {
+      visibility: {
+        public: true
+      }
+    });
   }
   /**
    * Check if a tool is public (exposed to MCP clients)
@@ -20280,11 +20307,11 @@ var ComposableMCPServer = class extends Server {
     const toolNameToDetailList = Object.entries(allTools);
     const publicToolNames = this.getPublicToolNames();
     const hiddenToolNames = this.getHiddenToolNames();
-    const contextToolNames = toolNameToDetailList.map(([name2]) => name2).filter((n) => !hiddenToolNames.includes(n));
+    const contextToolNames = toolNameToDetailList.map(([name2]) => name2).filter((n) => !hiddenToolNames.includes(n) && !publicToolNames.includes(n));
     publicToolNames.forEach((toolId) => {
       const tool2 = allTools[toolId];
       if (!tool2) {
-        throw new Error(`Public tool ${toolId} not found in registry, available: ${Object.keys(allTools).join(", ")}`);
+        return;
       }
       this.tool(toolId, tool2.description || "", jsonSchema(tool2.inputSchema), tool2.execute, {
         internal: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcpc-tech/core",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "homepage": "https://jsr.io/@mcpc/core",
   "dependencies": {
     "@ai-sdk/provider": "^2.0.0",

package/plugins/large-result.cjs

@@ -73,15 +73,13 @@ function createSearchPlugin(options = {}) {
   const timeoutMs = options.timeoutMs || 3e4;
   const global = options.global ?? true;
   const agentName = options.agentName;
-  const toolName = agentName ? `${agentName}__search-tool-result` : "search-tool-result";
+  const toolName = agentName ? `${agentName}__grep` : "mcpc__grep";
   const activeTimeouts = /* @__PURE__ */ new Set();
   return {
     name: "plugin-search",
     version: "1.0.0",
     configureServer: (server) => {
-      const defaultDescription = agentName ? `Search for text patterns in files for the "${agentName}" agent. Use this to find specific content within large tool results. Provide a simple literal string or a regular expression.
-Only search within the allowed directory: ${allowedSearchDir}` : `Search for text patterns in files and directories. Use this to find specific content, code, or information within files. Provide a simple literal string or a regular expression. If your pattern is a regex, ensure it's valid; otherwise use quotes or escape special characters to treat it as a literal string.
-Only search within the allowed directory: ${allowedSearchDir}`;
+      const defaultDescription = agentName ? `Grep/search for text patterns within large tool result files for the "${agentName}" agent. **IMPORTANT**: You MUST execute the actual tool first and get a "Result too large, saved to file" response before using this grep tool. This tool searches within previously saved large results only. Provide a simple literal string or a regular expression. Only search within the allowed directory: ${allowedSearchDir}` : `Grep/search for text patterns within large tool result files. **IMPORTANT**: You MUST execute the actual tool first and get a "Result too large, saved to file" response before using this grep tool. This tool searches within previously saved large results only. Provide a simple literal string or a regular expression. If your pattern is a regex, ensure it's valid. Only search within the allowed directory: ${allowedSearchDir}`;
       const toolDescription = options.toolDescription || defaultDescription;
       server.tool(toolName, toolDescription, jsonSchema({
         type: "object",
@@ -300,7 +298,7 @@ function createLargeResultPlugin(options = {}) {
   let tempDir = options.tempDir || null;
   let serverRef = null;
   let agentName = null;
-  const defaultSearchDescription = `Search within large tool result files that were saved due to size limits. Use when: a tool result was saved to file because it exceeded the context limit. Do NOT use this tool before calling the actual tool first. Provide specific keywords or patterns related to the content you're looking for.`;
+  const defaultSearchDescription = `Grep/search within large tool result files that were saved due to size limits. **IMPORTANT**: You MUST execute the actual tool first and get a "Result too large, saved to file" response before using this grep tool. This tool is ONLY for searching within previously saved large results, not for general file search. Provide specific keywords or regex patterns related to the content you're looking for.`;
   return {
     name: "plugin-large-result-handler",
     version: "1.0.0",
@@ -316,7 +314,8 @@ function createLargeResultPlugin(options = {}) {
           maxResults: options.search?.maxResults || 15,
           maxOutputSize: options.search?.maxOutputSize || 4e3,
           toolDescription: options.search?.toolDescription || defaultSearchDescription,
-          global: true,
+          global: false,
+          // Internal tool only - not exposed externally
           agentName
         };
         const searchPlugin = createSearchPlugin(searchConfig);
@@ -325,7 +324,7 @@ function createLargeResultPlugin(options = {}) {
     },
     transformTool: (tool, context) => {
       const originalExecute = tool.execute;
-      const searchToolName = agentName ? `${agentName}__search-tool-result` : "search-tool-result";
+      const searchToolName = agentName ? `${agentName}__grep` : "mcpc__grep";
       tool.execute = async (args) => {
         try {
           const result = await originalExecute(args);

package/plugins/large-result.mjs

@@ -41,15 +41,13 @@ function createSearchPlugin(options = {}) {
   const timeoutMs = options.timeoutMs || 3e4;
   const global = options.global ?? true;
   const agentName = options.agentName;
-  const toolName = agentName ? `${agentName}__search-tool-result` : "search-tool-result";
+  const toolName = agentName ? `${agentName}__grep` : "mcpc__grep";
   const activeTimeouts = /* @__PURE__ */ new Set();
   return {
     name: "plugin-search",
     version: "1.0.0",
     configureServer: (server) => {
-      const defaultDescription = agentName ? `Search for text patterns in files for the "${agentName}" agent. Use this to find specific content within large tool results. Provide a simple literal string or a regular expression.
-Only search within the allowed directory: ${allowedSearchDir}` : `Search for text patterns in files and directories. Use this to find specific content, code, or information within files. Provide a simple literal string or a regular expression. If your pattern is a regex, ensure it's valid; otherwise use quotes or escape special characters to treat it as a literal string.
-Only search within the allowed directory: ${allowedSearchDir}`;
+      const defaultDescription = agentName ? `Grep/search for text patterns within large tool result files for the "${agentName}" agent. **IMPORTANT**: You MUST execute the actual tool first and get a "Result too large, saved to file" response before using this grep tool. This tool searches within previously saved large results only. Provide a simple literal string or a regular expression. Only search within the allowed directory: ${allowedSearchDir}` : `Grep/search for text patterns within large tool result files. **IMPORTANT**: You MUST execute the actual tool first and get a "Result too large, saved to file" response before using this grep tool. This tool searches within previously saved large results only. Provide a simple literal string or a regular expression. If your pattern is a regex, ensure it's valid. Only search within the allowed directory: ${allowedSearchDir}`;
       const toolDescription = options.toolDescription || defaultDescription;
       server.tool(toolName, toolDescription, jsonSchema({
         type: "object",
@@ -268,7 +266,7 @@ function createLargeResultPlugin(options = {}) {
   let tempDir = options.tempDir || null;
   let serverRef = null;
   let agentName = null;
-  const defaultSearchDescription = `Search within large tool result files that were saved due to size limits. Use when: a tool result was saved to file because it exceeded the context limit. Do NOT use this tool before calling the actual tool first. Provide specific keywords or patterns related to the content you're looking for.`;
+  const defaultSearchDescription = `Grep/search within large tool result files that were saved due to size limits. **IMPORTANT**: You MUST execute the actual tool first and get a "Result too large, saved to file" response before using this grep tool. This tool is ONLY for searching within previously saved large results, not for general file search. Provide specific keywords or regex patterns related to the content you're looking for.`;
   return {
     name: "plugin-large-result-handler",
     version: "1.0.0",
@@ -284,7 +282,8 @@ function createLargeResultPlugin(options = {}) {
           maxResults: options.search?.maxResults || 15,
           maxOutputSize: options.search?.maxOutputSize || 4e3,
           toolDescription: options.search?.toolDescription || defaultSearchDescription,
-          global: true,
+          global: false,
+          // Internal tool only - not exposed externally
           agentName
         };
         const searchPlugin = createSearchPlugin(searchConfig);
@@ -293,7 +292,7 @@ function createLargeResultPlugin(options = {}) {
     },
     transformTool: (tool, context) => {
       const originalExecute = tool.execute;
-      const searchToolName = agentName ? `${agentName}__search-tool-result` : "search-tool-result";
+      const searchToolName = agentName ? `${agentName}__grep` : "mcpc__grep";
       tool.execute = async (args) => {
         try {
           const result = await originalExecute(args);

package/plugins/search.cjs

@@ -68,15 +68,13 @@ function createSearchPlugin(options = {}) {
   const timeoutMs = options.timeoutMs || 3e4;
   const global = options.global ?? true;
   const agentName = options.agentName;
-  const toolName = agentName ? `${agentName}__search-tool-result` : "search-tool-result";
+  const toolName = agentName ? `${agentName}__grep` : "mcpc__grep";
   const activeTimeouts = /* @__PURE__ */ new Set();
   return {
     name: "plugin-search",
     version: "1.0.0",
     configureServer: (server) => {
-      const defaultDescription = agentName ? `Search for text patterns in files for the "${agentName}" agent. Use this to find specific content within large tool results. Provide a simple literal string or a regular expression.
-Only search within the allowed directory: ${allowedSearchDir}` : `Search for text patterns in files and directories. Use this to find specific content, code, or information within files. Provide a simple literal string or a regular expression. If your pattern is a regex, ensure it's valid; otherwise use quotes or escape special characters to treat it as a literal string.
-Only search within the allowed directory: ${allowedSearchDir}`;
+      const defaultDescription = agentName ? `Grep/search for text patterns within large tool result files for the "${agentName}" agent. **IMPORTANT**: You MUST execute the actual tool first and get a "Result too large, saved to file" response before using this grep tool. This tool searches within previously saved large results only. Provide a simple literal string or a regular expression. Only search within the allowed directory: ${allowedSearchDir}` : `Grep/search for text patterns within large tool result files. **IMPORTANT**: You MUST execute the actual tool first and get a "Result too large, saved to file" response before using this grep tool. This tool searches within previously saved large results only. Provide a simple literal string or a regular expression. If your pattern is a regex, ensure it's valid. Only search within the allowed directory: ${allowedSearchDir}`;
       const toolDescription = options.toolDescription || defaultDescription;
       server.tool(
         toolName,

package/plugins/search.mjs

@@ -36,15 +36,13 @@ function createSearchPlugin(options = {}) {
   const timeoutMs = options.timeoutMs || 3e4;
   const global = options.global ?? true;
   const agentName = options.agentName;
-  const toolName = agentName ? `${agentName}__search-tool-result` : "search-tool-result";
+  const toolName = agentName ? `${agentName}__grep` : "mcpc__grep";
   const activeTimeouts = /* @__PURE__ */ new Set();
   return {
     name: "plugin-search",
     version: "1.0.0",
     configureServer: (server) => {
-      const defaultDescription = agentName ? `Search for text patterns in files for the "${agentName}" agent. Use this to find specific content within large tool results. Provide a simple literal string or a regular expression.
-Only search within the allowed directory: ${allowedSearchDir}` : `Search for text patterns in files and directories. Use this to find specific content, code, or information within files. Provide a simple literal string or a regular expression. If your pattern is a regex, ensure it's valid; otherwise use quotes or escape special characters to treat it as a literal string.
-Only search within the allowed directory: ${allowedSearchDir}`;
+      const defaultDescription = agentName ? `Grep/search for text patterns within large tool result files for the "${agentName}" agent. **IMPORTANT**: You MUST execute the actual tool first and get a "Result too large, saved to file" response before using this grep tool. This tool searches within previously saved large results only. Provide a simple literal string or a regular expression. Only search within the allowed directory: ${allowedSearchDir}` : `Grep/search for text patterns within large tool result files. **IMPORTANT**: You MUST execute the actual tool first and get a "Result too large, saved to file" response before using this grep tool. This tool searches within previously saved large results only. Provide a simple literal string or a regular expression. If your pattern is a regex, ensure it's valid. Only search within the allowed directory: ${allowedSearchDir}`;
       const toolDescription = options.toolDescription || defaultDescription;
       server.tool(
         toolName,

package/plugins.cjs

@@ -72,15 +72,13 @@ function createSearchPlugin(options = {}) {
   const timeoutMs = options.timeoutMs || 3e4;
   const global = options.global ?? true;
   const agentName = options.agentName;
-  const toolName = agentName ? `${agentName}__search-tool-result` : "search-tool-result";
+  const toolName = agentName ? `${agentName}__grep` : "mcpc__grep";
   const activeTimeouts = /* @__PURE__ */ new Set();
   return {
     name: "plugin-search",
     version: "1.0.0",
     configureServer: (server) => {
-      const defaultDescription = agentName ? `Search for text patterns in files for the "${agentName}" agent. Use this to find specific content within large tool results. Provide a simple literal string or a regular expression.
-Only search within the allowed directory: ${allowedSearchDir}` : `Search for text patterns in files and directories. Use this to find specific content, code, or information within files. Provide a simple literal string or a regular expression. If your pattern is a regex, ensure it's valid; otherwise use quotes or escape special characters to treat it as a literal string.
-Only search within the allowed directory: ${allowedSearchDir}`;
+      const defaultDescription = agentName ? `Grep/search for text patterns within large tool result files for the "${agentName}" agent. **IMPORTANT**: You MUST execute the actual tool first and get a "Result too large, saved to file" response before using this grep tool. This tool searches within previously saved large results only. Provide a simple literal string or a regular expression. Only search within the allowed directory: ${allowedSearchDir}` : `Grep/search for text patterns within large tool result files. **IMPORTANT**: You MUST execute the actual tool first and get a "Result too large, saved to file" response before using this grep tool. This tool searches within previously saved large results only. Provide a simple literal string or a regular expression. If your pattern is a regex, ensure it's valid. Only search within the allowed directory: ${allowedSearchDir}`;
       const toolDescription = options.toolDescription || defaultDescription;
       server.tool(toolName, toolDescription, jsonSchema({
         type: "object",
@@ -303,7 +301,7 @@ function createLargeResultPlugin(options = {}) {
   let tempDir = options.tempDir || null;
   let serverRef = null;
   let agentName = null;
-  const defaultSearchDescription = `Search within large tool result files that were saved due to size limits. Use when: a tool result was saved to file because it exceeded the context limit. Do NOT use this tool before calling the actual tool first. Provide specific keywords or patterns related to the content you're looking for.`;
+  const defaultSearchDescription = `Grep/search within large tool result files that were saved due to size limits. **IMPORTANT**: You MUST execute the actual tool first and get a "Result too large, saved to file" response before using this grep tool. This tool is ONLY for searching within previously saved large results, not for general file search. Provide specific keywords or regex patterns related to the content you're looking for.`;
   return {
     name: "plugin-large-result-handler",
     version: "1.0.0",
@@ -318,7 +316,7 @@ function createLargeResultPlugin(options = {}) {
           maxResults: options.search?.maxResults || 15,
           maxOutputSize: options.search?.maxOutputSize || 4e3,
           toolDescription: options.search?.toolDescription || defaultSearchDescription,
-          global: true,
+          global: false,
           agentName
         };
         const searchPlugin = createSearchPlugin(searchConfig);
@@ -327,7 +325,7 @@ function createLargeResultPlugin(options = {}) {
     },
     transformTool: (tool, context) => {
       const originalExecute = tool.execute;
-      const searchToolName = agentName ? `${agentName}__search-tool-result` : "search-tool-result";
+      const searchToolName = agentName ? `${agentName}__grep` : "mcpc__grep";
       tool.execute = async (args) => {
         try {
           const result = await originalExecute(args);

package/plugins.mjs

@@ -36,15 +36,13 @@ function createSearchPlugin(options = {}) {
   const timeoutMs = options.timeoutMs || 3e4;
   const global = options.global ?? true;
   const agentName = options.agentName;
-  const toolName = agentName ? `${agentName}__search-tool-result` : "search-tool-result";
+  const toolName = agentName ? `${agentName}__grep` : "mcpc__grep";
   const activeTimeouts = /* @__PURE__ */ new Set();
   return {
     name: "plugin-search",
     version: "1.0.0",
     configureServer: (server) => {
-      const defaultDescription = agentName ? `Search for text patterns in files for the "${agentName}" agent. Use this to find specific content within large tool results. Provide a simple literal string or a regular expression.
-Only search within the allowed directory: ${allowedSearchDir}` : `Search for text patterns in files and directories. Use this to find specific content, code, or information within files. Provide a simple literal string or a regular expression. If your pattern is a regex, ensure it's valid; otherwise use quotes or escape special characters to treat it as a literal string.
-Only search within the allowed directory: ${allowedSearchDir}`;
+      const defaultDescription = agentName ? `Grep/search for text patterns within large tool result files for the "${agentName}" agent. **IMPORTANT**: You MUST execute the actual tool first and get a "Result too large, saved to file" response before using this grep tool. This tool searches within previously saved large results only. Provide a simple literal string or a regular expression. Only search within the allowed directory: ${allowedSearchDir}` : `Grep/search for text patterns within large tool result files. **IMPORTANT**: You MUST execute the actual tool first and get a "Result too large, saved to file" response before using this grep tool. This tool searches within previously saved large results only. Provide a simple literal string or a regular expression. If your pattern is a regex, ensure it's valid. Only search within the allowed directory: ${allowedSearchDir}`;
       const toolDescription = options.toolDescription || defaultDescription;
       server.tool(toolName, toolDescription, jsonSchema({
         type: "object",
@@ -267,7 +265,7 @@ function createLargeResultPlugin(options = {}) {
   let tempDir = options.tempDir || null;
   let serverRef = null;
   let agentName = null;
-  const defaultSearchDescription = `Search within large tool result files that were saved due to size limits. Use when: a tool result was saved to file because it exceeded the context limit. Do NOT use this tool before calling the actual tool first. Provide specific keywords or patterns related to the content you're looking for.`;
+  const defaultSearchDescription = `Grep/search within large tool result files that were saved due to size limits. **IMPORTANT**: You MUST execute the actual tool first and get a "Result too large, saved to file" response before using this grep tool. This tool is ONLY for searching within previously saved large results, not for general file search. Provide specific keywords or regex patterns related to the content you're looking for.`;
   return {
     name: "plugin-large-result-handler",
     version: "1.0.0",
@@ -282,7 +280,7 @@ function createLargeResultPlugin(options = {}) {
           maxResults: options.search?.maxResults || 15,
           maxOutputSize: options.search?.maxOutputSize || 4e3,
           toolDescription: options.search?.toolDescription || defaultSearchDescription,
-          global: true,
+          global: false,
           agentName
         };
         const searchPlugin = createSearchPlugin(searchConfig);
@@ -291,7 +289,7 @@ function createLargeResultPlugin(options = {}) {
     },
     transformTool: (tool, context) => {
       const originalExecute = tool.execute;
-      const searchToolName = agentName ? `${agentName}__search-tool-result` : "search-tool-result";
+      const searchToolName = agentName ? `${agentName}__grep` : "mcpc__grep";
       tool.execute = async (args) => {
         try {
           const result = await originalExecute(args);

package/types/src/compose.d.ts

@@ -18,6 +18,7 @@ export declare class ComposableMCPServer extends Server {
   private resolveToolName: any;
   tool<T>(name: string, description: string, paramsSchema: Schema<T> | JSONSchema, cb: (args: T, extra?: unknown) => unknown, options?: {
     internal?: boolean;
+    hidden?: boolean;
     plugins?: ToolPlugin[];
   }): void;
   /**

package/types/src/compose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compose.d.ts","sources":["../../src/compose.ts"],"names":[],"mappings":"AAAA,SAGE,KAAK,cAAc,EAGnB,KAAK,IAAI,6CAC8C;AACzD,SAAwC,KAAK,MAAM,4BAA4B;AAC/E,cAAc,UAAU,6BAA6B;AACrD,SACE,MAAM,EACN,KAAK,aAAa,oDAC4C;AAGhE,cAAc,iBAAiB,kCAAkC;AACjE,cAAc,UAAU,EAAE,YAAY,qBAAqB;AAM3D,cAA4B,UAAU,EAAE,UAAU,4BAA4B;AAe9E,OAAO,cAAM,4BAA4B;EACvC,QAAQ,mBAA6B;EACrC,QAAQ,iBAAyB;EACjC,QAAQ,YAAsC;EAG9C,IAAI,mBAAmB,IAAI,MAAM,EAAE,MAAM;EAIzC,YAAY,aAAa,cAAc,EAAE,SAAS,aAAa;EAiB/D;;GAEC,GACD,AAAM,sBAAsB,QAAQ,IAAI;UAqB1B;UAsDN;EAIR,KAAK,GACH,MAAM,MAAM,EACZ,aAAa,MAAM,EACnB,cAAc,OAAO,KAAK,UAAU,EACpC,KAAK,MAAM,GAAG,QAAQ,OAAO,KAAK,OAAO,EACzC;IAAW,WAAW,OAAO;IAAE,UAAU;GAAmB;EA+D9D;;GAEC,GACD,gBAAgB,MAAM,MAAM,GAAG,eAAe,SAAS;EAIvD;;GAEC,GACD,eAAe,QAAQ,MAAM,GAAG,aAAa,SAAS;EAItD;;GAEC,GACD,AAAM,SAAS,MAAM,MAAM,EAAE,MAAM,OAAO,GAAG,QAAQ,OAAO;EAyB5D;;GAEC,GACD,sBAAsB,MAAM;EAI5B;;GAEC,GACD,kBAAkB;EAIlB;;GAEC,GACD,sBAAsB,MAAM;EAI5B;;GAEC,GACD,wBAAwB,MAAM;EAM9B;;GAEC,GACD,oBACE,MAAM,MAAM;IACT,aAAa,MAAM;IAAE,QAAQ;MAAe,SAAS;EAI1D;;GAEC,GACD,aAAa,MAAM,MAAM,GAAG,OAAO;EAInC;;GAEC,GACD,WAAW,UAAU,MAAM,EAAE,QAAQ,UAAU,GAAG,IAAI;EAItD;;GAEC,GACD,cAAc,UAAU,MAAM,GAAG,aAAa,SAAS;EAIvD;;GAEC,GACD,iBAAiB,UAAU,MAAM,GAAG,OAAO;EAI3C;;GAEC,GACD,AAAM,UAAU,QAAQ,UAAU,GAAG,QAAQ,IAAI;EAIjD;;GAEC,GACD,AAAM,mBACJ,YAAY,MAAM,EAClB;IAAW,QAAQ,OAAO;GAAoB,GAC7C,QAAQ,IAAI;UAOD;EAOd;;GAEC,GACD,AAAM,kBAAkB,QAAQ,IAAI;EAIpC;;GAEC,GACD,SAAe,SAAS,QAAQ,IAAI;EAK9B,QACJ,MAAM,MAAM,GAAG,IAAI,EACnB,aAAa,MAAM,EACnB,aAAY,UAA+B,EAC3C,UAAS,kBAAkB,UAAgC;AA+Q/D"}
+{"version":3,"file":"compose.d.ts","sources":["../../src/compose.ts"],"names":[],"mappings":"AAAA,SAGE,KAAK,cAAc,EAGnB,KAAK,IAAI,6CAC8C;AACzD,SAAwC,KAAK,MAAM,4BAA4B;AAC/E,cAAc,UAAU,6BAA6B;AACrD,SACE,MAAM,EACN,KAAK,aAAa,oDAC4C;AAGhE,cAAc,iBAAiB,kCAAkC;AACjE,cAAc,UAAU,EAAE,YAAY,qBAAqB;AAM3D,cAA4B,UAAU,EAAE,UAAU,4BAA4B;AAe9E,OAAO,cAAM,4BAA4B;EACvC,QAAQ,mBAA6B;EACrC,QAAQ,iBAAyB;EACjC,QAAQ,YAAsC;EAG9C,IAAI,mBAAmB,IAAI,MAAM,EAAE,MAAM;EAIzC,YAAY,aAAa,cAAc,EAAE,SAAS,aAAa;EAiB/D;;GAEC,GACD,AAAM,sBAAsB,QAAQ,IAAI;UAqB1B;UAsDN;EAIR,KAAK,GACH,MAAM,MAAM,EACZ,aAAa,MAAM,EACnB,cAAc,OAAO,KAAK,UAAU,EACpC,KAAK,MAAM,GAAG,QAAQ,OAAO,KAAK,OAAO,EACzC;IAAW,WAAW,OAAO;IAAE,SAAS,OAAO;IAAE,UAAU;GACvD;EA+DN;;GAEC,GACD,gBAAgB,MAAM,MAAM,GAAG,eAAe,SAAS;EAIvD;;GAEC,GACD,eAAe,QAAQ,MAAM,GAAG,aAAa,SAAS;EAItD;;GAEC,GACD,AAAM,SAAS,MAAM,MAAM,EAAE,MAAM,OAAO,GAAG,QAAQ,OAAO;EAyB5D;;GAEC,GACD,sBAAsB,MAAM;EAI5B;;GAEC,GACD,kBAAkB;EAIlB;;GAEC,GACD,sBAAsB,MAAM;EAI5B;;GAEC,GACD,wBAAwB,MAAM;EAM9B;;GAEC,GACD,oBACE,MAAM,MAAM;IACT,aAAa,MAAM;IAAE,QAAQ;MAAe,SAAS;EAI1D;;GAEC,GACD,aAAa,MAAM,MAAM,GAAG,OAAO;EAInC;;GAEC,GACD,WAAW,UAAU,MAAM,EAAE,QAAQ,UAAU,GAAG,IAAI;EAItD;;GAEC,GACD,cAAc,UAAU,MAAM,GAAG,aAAa,SAAS;EAIvD;;GAEC,GACD,iBAAiB,UAAU,MAAM,GAAG,OAAO;EAI3C;;GAEC,GACD,AAAM,UAAU,QAAQ,UAAU,GAAG,QAAQ,IAAI;EAIjD;;GAEC,GACD,AAAM,mBACJ,YAAY,MAAM,EAClB;IAAW,QAAQ,OAAO;GAAoB,GAC7C,QAAQ,IAAI;UAOD;EAOd;;GAEC,GACD,AAAM,kBAAkB,QAAQ,IAAI;EAIpC;;GAEC,GACD,SAAe,SAAS,QAAQ,IAAI;EAK9B,QACJ,MAAM,MAAM,GAAG,IAAI,EACnB,aAAa,MAAM,EACnB,aAAY,UAA+B,EAC3C,UAAS,kBAAkB,UAAgC;AAiR/D"}

package/types/src/plugins/large-result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"large-result.d.ts","sources":["../../../src/plugins/large-result.ts"],"names":[],"mappings":"AAQA,SAA6B,KAAK,aAAa,2BAA2B;AAC1E,cAAmC,UAAU,6BAA6B;UAGhE;EACR,UAAU,MAAM;EAChB,cAAc,MAAM;EACpB,UAAU,MAAM;EAChB,SAAS;;AAGX;;;CAGC,GACD,OAAO,iBAAS,wBACd,UAAS,aAAkB,GAC1B;AAsHH;;CAEC,GACD,cAAM,0BAA0B;AAMhC,OAAO,cAAM,kBAAuC;AAEpD,eAAe,yBAAyB"}
+{"version":3,"file":"large-result.d.ts","sources":["../../../src/plugins/large-result.ts"],"names":[],"mappings":"AAQA,SAA6B,KAAK,aAAa,2BAA2B;AAC1E,cAAmC,UAAU,6BAA6B;UAGhE;EACR,UAAU,MAAM;EAChB,cAAc,MAAM;EACpB,UAAU,MAAM;EAChB,SAAS;;AAGX;;;CAGC,GACD,OAAO,iBAAS,wBACd,UAAS,aAAkB,GAC1B;AAoHH;;CAEC,GACD,cAAM,0BAA0B;AAMhC,OAAO,cAAM,kBAAuC;AAEpD,eAAe,yBAAyB"}

package/types/src/plugins/search-tool.d.ts

@@ -9,7 +9,7 @@ import type { ToolPlugin } from "../plugin-types.js";
   /** Whether search should be case sensitive (default: false) */ caseSensitive?: boolean;
   /** Search timeout in milliseconds (default: 30000) */ timeoutMs?: number;
   /** Custom description for the search tool (overrides default) */ toolDescription?: string;
-  /** Agent name prefix for tool naming (e.g., "my-agent" -> "my-agent__search-tool-result") */ agentName?: string;
+  /** Agent name prefix for tool naming (e.g., "my-agent" -> "my-agent__grep") */ agentName?: string;
 }
 /**
  * Create a search plugin that adds file search capability with size limits

package/types/src/plugins/search-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-tool.d.ts","sources":["../../../src/plugins/search-tool.ts"],"names":[],"mappings":"AASA,cAAc,UAAU,6BAA6B;AAIrD;;CAEC,GACD,iBAAiB;EACf,sDAAsD,GACtD,SAAS,OAAO;EAChB,6DAA6D,GAC7D,aAAa,MAAM;EACnB,sDAAsD,GACtD,gBAAgB,MAAM;EACtB,mHAAmH,GACnH,aAAa,MAAM;EACnB,6DAA6D,GAC7D,gBAAgB,OAAO;EACvB,oDAAoD,GACpD,YAAY,MAAM;EAClB,+DAA+D,GAC/D,kBAAkB,MAAM;EACxB,2FAA2F,GAC3F,YAAY,MAAM;;AAGpB;;CAEC,GACD,OAAO,iBAAS,mBAAmB,UAAS,aAAkB,GAAG;AAsQjE;;CAEC,GACD,cAAM,qBAAqB;AAS3B,OAAO,cAAM,kBAAkC;AAE/C,eAAe,oBAAoB"}
+{"version":3,"file":"search-tool.d.ts","sources":["../../../src/plugins/search-tool.ts"],"names":[],"mappings":"AASA,cAAc,UAAU,6BAA6B;AAIrD;;CAEC,GACD,iBAAiB;EACf,sDAAsD,GACtD,SAAS,OAAO;EAChB,6DAA6D,GAC7D,aAAa,MAAM;EACnB,sDAAsD,GACtD,gBAAgB,MAAM;EACtB,mHAAmH,GACnH,aAAa,MAAM;EACnB,6DAA6D,GAC7D,gBAAgB,OAAO;EACvB,oDAAoD,GACpD,YAAY,MAAM;EAClB,+DAA+D,GAC/D,kBAAkB,MAAM;EACxB,6EAA6E,GAC7E,YAAY,MAAM;;AAGpB;;CAEC,GACD,OAAO,iBAAS,mBAAmB,UAAS,aAAkB,GAAG;AA0QjE;;CAEC,GACD,cAAM,qBAAqB;AAS3B,OAAO,cAAM,kBAAkC;AAE/C,eAAe,oBAAoB"}