@mcpc-tech/core 0.3.27 → 0.3.29

package/index.cjs

@@ -17814,6 +17814,23 @@ Execute a tool:
   "args": { /* tool parameters */ }
 }
 \`\`\`
+</format>`,
+  /**
+   * Compact system prompt for autonomous MCP execution (when manual is provided)
+   *
+   * Uses simplified description with progressive disclosure:
+   * - Short description shown by default
+   * - Use `man` command with args `{ manual: true }` to get full manual
+   */
+  AUTONOMOUS_EXECUTION_COMPACT: `Agentic tool \`{toolName}\`: {description}
+
+Use \`man\` command with args \`{ tools: [], manual: true }\` to get the full manual, or \`{ tools: ["tool1"] }\` to get tool schemas.
+
+<format>
+Get full manual: \`{ "tool": "man", "args": { "tools": [], "manual": true } }\`
+Get tool schemas: \`{ "tool": "man", "args": { "tools": ["tool1", "tool2"] } }\`
+Get both: \`{ "tool": "man", "args": { "tools": ["tool1"], "manual": true } }\`
+Execute a tool: \`{ "tool": "tool_name", "args": { /* parameters */ } }\`
 </format>`,
   /**
    * Tool description for sampling tools (shown in MCP tools list)
@@ -17891,6 +17908,7 @@ Adjust parameters and retry.`,
 };
 var CompiledPrompts = {
   autonomousExecution: p(SystemPrompts.AUTONOMOUS_EXECUTION),
+  autonomousExecutionCompact: p(SystemPrompts.AUTONOMOUS_EXECUTION_COMPACT),
   samplingToolDescription: p(SystemPrompts.SAMPLING_TOOL_DESCRIPTION),
   aiLoopSystem: p(SystemPrompts.AI_LOOP_SYSTEM),
   actionSuccess: p(ResponseTemplates.ACTION_SUCCESS),
@@ -17957,7 +17975,7 @@ function createArgsDefFactory(_name, _allToolNames, _depGroups, _predefinedSteps
           },
           args: {
             type: "object",
-            description: `For "man": { tools: ["tool1", "tool2"] }. For other tools: tool parameters that strictly adhere to the tool's JSON schema.`
+            description: `For "man": { tools: ["tool1", "tool2"], manual?: true }. For other tools: tool parameters that strictly adhere to the tool's JSON schema.`
           }
         },
         required: [
@@ -17968,7 +17986,10 @@ function createArgsDefFactory(_name, _allToolNames, _depGroups, _predefinedSteps
     },
     /**
      * Schema for "man" command args validation
-     * Expected format: { tools: ["tool1", "tool2"] }
+     * Expected format: { tools: ["tool1", "tool2"], manual?: true }
+     *
+     * - Always require `tools`
+     * - Allow empty tools only when `manual: true`
      */
     forMan: function(allToolNames) {
       return {
@@ -17982,16 +18003,50 @@ function createArgsDefFactory(_name, _allToolNames, _depGroups, _predefinedSteps
               errorMessage: {
                 enum: `Invalid tool name. Available: ${allToolNames.join(", ")}`
               }
-            },
-            minItems: 1,
-            errorMessage: {
-              minItems: "At least one tool name is required"
             }
+          },
+          manual: {
+            type: "boolean",
+            description: "Set to true to get the full manual for this agent (progressive disclosure)."
           }
         },
         required: [
           "tools"
         ],
+        additionalProperties: false,
+        anyOf: [
+          // manual-only (tools can be empty)
+          {
+            properties: {
+              manual: {
+                enum: [
+                  true
+                ]
+              },
+              tools: {
+                minItems: 0
+              }
+            },
+            required: [
+              "tools",
+              "manual"
+            ]
+          },
+          // tool schemas (require at least one tool)
+          {
+            properties: {
+              tools: {
+                minItems: 1,
+                errorMessage: {
+                  minItems: "At least one tool name is required"
+                }
+              }
+            },
+            required: [
+              "tools"
+            ]
+          }
+        ],
         errorMessage: {
           required: {
             tools: 'Missing "tools" field. Expected: { tools: ["tool1", "tool2"] }'
@@ -18113,14 +18168,16 @@ var AgenticExecutor = class {
   allToolNames;
   toolNameToDetailList;
   server;
+  manual;
   logger;
   tracingEnabled;
   toolSchemaMap;
-  constructor(name, allToolNames, toolNameToDetailList, server) {
+  constructor(name, allToolNames, toolNameToDetailList, server, manual) {
     this.name = name;
     this.allToolNames = allToolNames;
     this.toolNameToDetailList = toolNameToDetailList;
     this.server = server;
+    this.manual = manual;
     this.tracingEnabled = false;
     this.logger = createLogger(`mcpc.agentic.${name}`, server);
     this.toolSchemaMap = new Map(toolNameToDetailList);
@@ -18188,7 +18245,34 @@ var AgenticExecutor = class {
           };
         }
         const argsObj = args.args;
-        return this.handleManCommand(argsObj.tools, executeSpan);
+        const tools = argsObj.tools ?? [];
+        const wantManual = argsObj.manual === true;
+        const wantTools = tools.length > 0;
+        if (wantTools && wantManual) {
+          const toolSchemas = this.handleManCommand(tools, null);
+          const manualResult = this.handleManualRequest(null);
+          if (executeSpan) {
+            executeSpan.setAttributes({
+              toolType: "man",
+              requestType: "tools+manual"
+            });
+            endSpan(executeSpan);
+          }
+          return {
+            content: [
+              ...toolSchemas.content,
+              {
+                type: "text",
+                text: "\n---\n"
+              },
+              ...manualResult.content
+            ]
+          };
+        }
+        if (wantManual) {
+          return this.handleManualRequest(executeSpan);
+        }
+        return this.handleManCommand(tools, executeSpan);
       }
       const toolArgs = args.args || {};
       return await this.executeTool(tool2, toolArgs, executeSpan);
@@ -18211,6 +18295,44 @@ var AgenticExecutor = class {
       };
     }
   }
+  /**
+   * Handle `man { manual: true }` - return full manual for progressive disclosure
+   */
+  handleManualRequest(executeSpan) {
+    if (executeSpan) {
+      executeSpan.setAttributes({
+        toolType: "man",
+        requestType: "manual"
+      });
+    }
+    if (!this.manual) {
+      if (executeSpan) {
+        endSpan(executeSpan);
+      }
+      return {
+        content: [
+          {
+            type: "text",
+            text: "No manual available for this agent."
+          }
+        ]
+      };
+    }
+    if (executeSpan) {
+      executeSpan.setAttributes({
+        success: true
+      });
+      endSpan(executeSpan);
+    }
+    return {
+      content: [
+        {
+          type: "text",
+          text: this.manual
+        }
+      ]
+    };
+  }
   /**
    * Handle `man` command - return schemas for requested tools
    * @param requestedTools - Array of tool names (already validated via JSON Schema)
@@ -18252,15 +18374,29 @@ ${JSON.stringify(cleanedSchema, null, 2)}
    * Execute a tool with runtime validation
    */
   async executeTool(tool2, toolArgs, executeSpan) {
-    const externalTool = this.toolNameToDetailList.find(([name]) => name === tool2);
-    if (externalTool) {
-      const [, toolDetail] = externalTool;
+    const isExternalTool = this.toolNameToDetailList.some(([name]) => name === tool2);
+    const isInternalTool = this.allToolNames.includes(tool2);
+    if (!isExternalTool && !isInternalTool) {
       if (executeSpan) {
         executeSpan.setAttributes({
-          toolType: "external",
-          selectedTool: tool2
+          toolType: "not_found",
+          tool: tool2
         });
+        endSpan(executeSpan);
       }
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Tool "${tool2}" not found. Available tools: ${this.allToolNames.join(", ")}`
+          }
+        ],
+        isError: true
+      };
+    }
+    if (isExternalTool) {
+      const externalTool = this.toolNameToDetailList.find(([name]) => name === tool2);
+      const [, toolDetail] = externalTool;
       if (toolDetail.inputSchema) {
         const rawSchema = extractJsonSchema(toolDetail.inputSchema);
         const validation = validateSchema(toolArgs, rawSchema);
@@ -18283,84 +18419,53 @@ ${JSON.stringify(cleanedSchema, null, 2)}
           };
         }
       }
-      this.logger.debug({
-        message: "Executing external tool",
-        tool: tool2
+    }
+    const toolType = isExternalTool ? "external" : "internal";
+    if (executeSpan) {
+      executeSpan.setAttributes({
+        toolType,
+        selectedTool: tool2
       });
-      const result = await toolDetail.execute(toolArgs);
+    }
+    this.logger.debug({
+      message: `Executing ${toolType} tool`,
+      tool: tool2
+    });
+    try {
+      const result = await this.server.callTool(tool2, toolArgs, {
+        agentName: this.name
+      });
+      const callToolResult = result ?? {
+        content: []
+      };
       if (executeSpan) {
         executeSpan.setAttributes({
           success: true,
-          isError: !!result.isError,
-          resultContentLength: result.content?.length || 0
+          isError: !!callToolResult.isError,
+          resultContentLength: callToolResult.content?.length || 0
         });
         endSpan(executeSpan);
       }
-      return result;
-    }
-    if (this.allToolNames.includes(tool2)) {
+      return callToolResult;
+    } catch (error2) {
       if (executeSpan) {
-        executeSpan.setAttributes({
-          toolType: "internal",
-          selectedTool: tool2
-        });
-      }
-      this.logger.debug({
-        message: "Executing internal tool",
-        tool: tool2
-      });
-      try {
-        const result = await this.server.callTool(tool2, toolArgs, {
-          agentName: this.name
-        });
-        const callToolResult = result ?? {
-          content: []
-        };
-        if (executeSpan) {
-          executeSpan.setAttributes({
-            success: true,
-            isError: !!callToolResult.isError,
-            resultContentLength: callToolResult.content?.length || 0
-          });
-          endSpan(executeSpan);
-        }
-        return callToolResult;
-      } catch (error2) {
-        if (executeSpan) {
-          endSpan(executeSpan, error2);
-        }
-        this.logger.error({
-          message: "Error executing internal tool",
-          tool: tool2,
-          error: String(error2)
-        });
-        return {
-          content: [
-            {
-              type: "text",
-              text: `Error executing tool "${tool2}": ${error2 instanceof Error ? error2.message : String(error2)}`
-            }
-          ],
-          isError: true
-        };
+        endSpan(executeSpan, error2);
       }
-    }
-    if (executeSpan) {
-      executeSpan.setAttributes({
-        toolType: "not_found",
-        tool: tool2
+      this.logger.error({
+        message: `Error executing ${toolType} tool`,
+        tool: tool2,
+        error: String(error2)
       });
-      endSpan(executeSpan);
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Error executing tool "${tool2}": ${error2 instanceof Error ? error2.message : String(error2)}`
+          }
+        ],
+        isError: true
+      };
     }
-    return {
-      content: [
-        {
-          type: "text",
-          text: `Tool "${tool2}" not found. Available tools: ${this.allToolNames.join(", ")}`
-        }
-      ],
-      isError: true
-    };
   }
   validate(args, schema) {
     return validateSchema(args, schema);
@@ -18368,19 +18473,18 @@ ${JSON.stringify(cleanedSchema, null, 2)}
 };
 
 // __mcpc__core_latest/node_modules/@mcpc/core/src/executors/agentic/agentic-tool-registrar.js
-function registerAgenticTool(server, { description, name, allToolNames, depGroups, toolNameToDetailList }) {
+function registerAgenticTool(server, { description, name, allToolNames, depGroups, toolNameToDetailList, manual }) {
   const createArgsDef = createArgsDefFactory(name, allToolNames, depGroups, void 0, void 0);
-  const agenticExecutor = new AgenticExecutor(name, allToolNames, toolNameToDetailList, server);
-  description = CompiledPrompts.autonomousExecution({
+  const agenticExecutor = new AgenticExecutor(name, allToolNames, toolNameToDetailList, server, manual);
+  description = manual ? CompiledPrompts.autonomousExecutionCompact({
+    toolName: name,
+    description
+  }) : CompiledPrompts.autonomousExecution({
     toolName: name,
     description
   });
   const agenticArgsDef = createArgsDef.forAgentic(allToolNames);
-  const argsDef = agenticArgsDef;
-  const schema = allToolNames.length > 0 ? argsDef : {
-    type: "object",
-    properties: {}
-  };
+  const schema = agenticArgsDef;
   server.tool(name, description, jsonSchema(createModelCompatibleJSONSchema(schema)), async (args) => {
     return await agenticExecutor.execute(args, schema);
   });
@@ -18399,7 +18503,8 @@ var createAgenticModePlugin = () => ({
       name: context2.name,
       allToolNames: context2.allToolNames,
       depGroups: context2.depGroups,
-      toolNameToDetailList: context2.toolNameToDetailList
+      toolNameToDetailList: context2.toolNameToDetailList,
+      manual: context2.manual
     });
   }
 });
@@ -20503,9 +20608,10 @@ var ComposableMCPServer = class extends Server {
     mcpServers: {}
   }, options = {
     mode: "agentic"
-  }) {
+  }, manual) {
     const refDesc = options.refs?.join("") ?? "";
-    const { tagToResults } = parseTags(description + refDesc, [
+    const combinedSource = description + refDesc + (manual ?? "");
+    const { tagToResults } = parseTags(combinedSource, [
       "tool",
       "fn"
     ]);
@@ -20656,6 +20762,7 @@ var ComposableMCPServer = class extends Server {
       server: this,
       name,
       description,
+      manual,
       mode,
       allToolNames,
       toolNameToDetailList,
@@ -20754,7 +20861,7 @@ async function mcpc(serverConf, composeConf, optionsOrSetup) {
     await options.setup(server);
   }
   for (const mcpcConfig of parsed) {
-    await server.compose(mcpcConfig.name, mcpcConfig.description ?? "", mcpcConfig.deps, mcpcConfig.options);
+    await server.compose(mcpcConfig.name, mcpcConfig.description ?? "", mcpcConfig.deps, mcpcConfig.options, mcpcConfig.manual);
   }
   return server;
 }

package/index.mjs

@@ -17800,6 +17800,23 @@ Execute a tool:
   "args": { /* tool parameters */ }
 }
 \`\`\`
+</format>`,
+  /**
+   * Compact system prompt for autonomous MCP execution (when manual is provided)
+   *
+   * Uses simplified description with progressive disclosure:
+   * - Short description shown by default
+   * - Use `man` command with args `{ manual: true }` to get full manual
+   */
+  AUTONOMOUS_EXECUTION_COMPACT: `Agentic tool \`{toolName}\`: {description}
+
+Use \`man\` command with args \`{ tools: [], manual: true }\` to get the full manual, or \`{ tools: ["tool1"] }\` to get tool schemas.
+
+<format>
+Get full manual: \`{ "tool": "man", "args": { "tools": [], "manual": true } }\`
+Get tool schemas: \`{ "tool": "man", "args": { "tools": ["tool1", "tool2"] } }\`
+Get both: \`{ "tool": "man", "args": { "tools": ["tool1"], "manual": true } }\`
+Execute a tool: \`{ "tool": "tool_name", "args": { /* parameters */ } }\`
 </format>`,
   /**
    * Tool description for sampling tools (shown in MCP tools list)
@@ -17877,6 +17894,7 @@ Adjust parameters and retry.`,
 };
 var CompiledPrompts = {
   autonomousExecution: p(SystemPrompts.AUTONOMOUS_EXECUTION),
+  autonomousExecutionCompact: p(SystemPrompts.AUTONOMOUS_EXECUTION_COMPACT),
   samplingToolDescription: p(SystemPrompts.SAMPLING_TOOL_DESCRIPTION),
   aiLoopSystem: p(SystemPrompts.AI_LOOP_SYSTEM),
   actionSuccess: p(ResponseTemplates.ACTION_SUCCESS),
@@ -17943,7 +17961,7 @@ function createArgsDefFactory(_name, _allToolNames, _depGroups, _predefinedSteps
           },
           args: {
             type: "object",
-            description: `For "man": { tools: ["tool1", "tool2"] }. For other tools: tool parameters that strictly adhere to the tool's JSON schema.`
+            description: `For "man": { tools: ["tool1", "tool2"], manual?: true }. For other tools: tool parameters that strictly adhere to the tool's JSON schema.`
           }
         },
         required: [
@@ -17954,7 +17972,10 @@ function createArgsDefFactory(_name, _allToolNames, _depGroups, _predefinedSteps
     },
     /**
      * Schema for "man" command args validation
-     * Expected format: { tools: ["tool1", "tool2"] }
+     * Expected format: { tools: ["tool1", "tool2"], manual?: true }
+     *
+     * - Always require `tools`
+     * - Allow empty tools only when `manual: true`
      */
     forMan: function(allToolNames) {
       return {
@@ -17968,16 +17989,50 @@ function createArgsDefFactory(_name, _allToolNames, _depGroups, _predefinedSteps
               errorMessage: {
                 enum: `Invalid tool name. Available: ${allToolNames.join(", ")}`
               }
-            },
-            minItems: 1,
-            errorMessage: {
-              minItems: "At least one tool name is required"
             }
+          },
+          manual: {
+            type: "boolean",
+            description: "Set to true to get the full manual for this agent (progressive disclosure)."
           }
         },
         required: [
           "tools"
         ],
+        additionalProperties: false,
+        anyOf: [
+          // manual-only (tools can be empty)
+          {
+            properties: {
+              manual: {
+                enum: [
+                  true
+                ]
+              },
+              tools: {
+                minItems: 0
+              }
+            },
+            required: [
+              "tools",
+              "manual"
+            ]
+          },
+          // tool schemas (require at least one tool)
+          {
+            properties: {
+              tools: {
+                minItems: 1,
+                errorMessage: {
+                  minItems: "At least one tool name is required"
+                }
+              }
+            },
+            required: [
+              "tools"
+            ]
+          }
+        ],
         errorMessage: {
           required: {
             tools: 'Missing "tools" field. Expected: { tools: ["tool1", "tool2"] }'
@@ -18099,14 +18154,16 @@ var AgenticExecutor = class {
   allToolNames;
   toolNameToDetailList;
   server;
+  manual;
   logger;
   tracingEnabled;
   toolSchemaMap;
-  constructor(name, allToolNames, toolNameToDetailList, server) {
+  constructor(name, allToolNames, toolNameToDetailList, server, manual) {
     this.name = name;
     this.allToolNames = allToolNames;
     this.toolNameToDetailList = toolNameToDetailList;
     this.server = server;
+    this.manual = manual;
     this.tracingEnabled = false;
     this.logger = createLogger(`mcpc.agentic.${name}`, server);
     this.toolSchemaMap = new Map(toolNameToDetailList);
@@ -18174,7 +18231,34 @@ var AgenticExecutor = class {
           };
         }
         const argsObj = args.args;
-        return this.handleManCommand(argsObj.tools, executeSpan);
+        const tools = argsObj.tools ?? [];
+        const wantManual = argsObj.manual === true;
+        const wantTools = tools.length > 0;
+        if (wantTools && wantManual) {
+          const toolSchemas = this.handleManCommand(tools, null);
+          const manualResult = this.handleManualRequest(null);
+          if (executeSpan) {
+            executeSpan.setAttributes({
+              toolType: "man",
+              requestType: "tools+manual"
+            });
+            endSpan(executeSpan);
+          }
+          return {
+            content: [
+              ...toolSchemas.content,
+              {
+                type: "text",
+                text: "\n---\n"
+              },
+              ...manualResult.content
+            ]
+          };
+        }
+        if (wantManual) {
+          return this.handleManualRequest(executeSpan);
+        }
+        return this.handleManCommand(tools, executeSpan);
       }
       const toolArgs = args.args || {};
       return await this.executeTool(tool2, toolArgs, executeSpan);
@@ -18197,6 +18281,44 @@ var AgenticExecutor = class {
       };
     }
   }
+  /**
+   * Handle `man { manual: true }` - return full manual for progressive disclosure
+   */
+  handleManualRequest(executeSpan) {
+    if (executeSpan) {
+      executeSpan.setAttributes({
+        toolType: "man",
+        requestType: "manual"
+      });
+    }
+    if (!this.manual) {
+      if (executeSpan) {
+        endSpan(executeSpan);
+      }
+      return {
+        content: [
+          {
+            type: "text",
+            text: "No manual available for this agent."
+          }
+        ]
+      };
+    }
+    if (executeSpan) {
+      executeSpan.setAttributes({
+        success: true
+      });
+      endSpan(executeSpan);
+    }
+    return {
+      content: [
+        {
+          type: "text",
+          text: this.manual
+        }
+      ]
+    };
+  }
   /**
    * Handle `man` command - return schemas for requested tools
    * @param requestedTools - Array of tool names (already validated via JSON Schema)
@@ -18238,15 +18360,29 @@ ${JSON.stringify(cleanedSchema, null, 2)}
    * Execute a tool with runtime validation
    */
   async executeTool(tool2, toolArgs, executeSpan) {
-    const externalTool = this.toolNameToDetailList.find(([name]) => name === tool2);
-    if (externalTool) {
-      const [, toolDetail] = externalTool;
+    const isExternalTool = this.toolNameToDetailList.some(([name]) => name === tool2);
+    const isInternalTool = this.allToolNames.includes(tool2);
+    if (!isExternalTool && !isInternalTool) {
       if (executeSpan) {
         executeSpan.setAttributes({
-          toolType: "external",
-          selectedTool: tool2
+          toolType: "not_found",
+          tool: tool2
         });
+        endSpan(executeSpan);
       }
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Tool "${tool2}" not found. Available tools: ${this.allToolNames.join(", ")}`
+          }
+        ],
+        isError: true
+      };
+    }
+    if (isExternalTool) {
+      const externalTool = this.toolNameToDetailList.find(([name]) => name === tool2);
+      const [, toolDetail] = externalTool;
       if (toolDetail.inputSchema) {
         const rawSchema = extractJsonSchema(toolDetail.inputSchema);
         const validation = validateSchema(toolArgs, rawSchema);
@@ -18269,84 +18405,53 @@ ${JSON.stringify(cleanedSchema, null, 2)}
           };
         }
       }
-      this.logger.debug({
-        message: "Executing external tool",
-        tool: tool2
+    }
+    const toolType = isExternalTool ? "external" : "internal";
+    if (executeSpan) {
+      executeSpan.setAttributes({
+        toolType,
+        selectedTool: tool2
       });
-      const result = await toolDetail.execute(toolArgs);
+    }
+    this.logger.debug({
+      message: `Executing ${toolType} tool`,
+      tool: tool2
+    });
+    try {
+      const result = await this.server.callTool(tool2, toolArgs, {
+        agentName: this.name
+      });
+      const callToolResult = result ?? {
+        content: []
+      };
       if (executeSpan) {
         executeSpan.setAttributes({
           success: true,
-          isError: !!result.isError,
-          resultContentLength: result.content?.length || 0
+          isError: !!callToolResult.isError,
+          resultContentLength: callToolResult.content?.length || 0
         });
         endSpan(executeSpan);
       }
-      return result;
-    }
-    if (this.allToolNames.includes(tool2)) {
+      return callToolResult;
+    } catch (error2) {
       if (executeSpan) {
-        executeSpan.setAttributes({
-          toolType: "internal",
-          selectedTool: tool2
-        });
-      }
-      this.logger.debug({
-        message: "Executing internal tool",
-        tool: tool2
-      });
-      try {
-        const result = await this.server.callTool(tool2, toolArgs, {
-          agentName: this.name
-        });
-        const callToolResult = result ?? {
-          content: []
-        };
-        if (executeSpan) {
-          executeSpan.setAttributes({
-            success: true,
-            isError: !!callToolResult.isError,
-            resultContentLength: callToolResult.content?.length || 0
-          });
-          endSpan(executeSpan);
-        }
-        return callToolResult;
-      } catch (error2) {
-        if (executeSpan) {
-          endSpan(executeSpan, error2);
-        }
-        this.logger.error({
-          message: "Error executing internal tool",
-          tool: tool2,
-          error: String(error2)
-        });
-        return {
-          content: [
-            {
-              type: "text",
-              text: `Error executing tool "${tool2}": ${error2 instanceof Error ? error2.message : String(error2)}`
-            }
-          ],
-          isError: true
-        };
+        endSpan(executeSpan, error2);
       }
-    }
-    if (executeSpan) {
-      executeSpan.setAttributes({
-        toolType: "not_found",
-        tool: tool2
+      this.logger.error({
+        message: `Error executing ${toolType} tool`,
+        tool: tool2,
+        error: String(error2)
       });
-      endSpan(executeSpan);
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Error executing tool "${tool2}": ${error2 instanceof Error ? error2.message : String(error2)}`
+          }
+        ],
+        isError: true
+      };
     }
-    return {
-      content: [
-        {
-          type: "text",
-          text: `Tool "${tool2}" not found. Available tools: ${this.allToolNames.join(", ")}`
-        }
-      ],
-      isError: true
-    };
   }
   validate(args, schema) {
     return validateSchema(args, schema);
@@ -18354,19 +18459,18 @@ ${JSON.stringify(cleanedSchema, null, 2)}
 };
 
 // __mcpc__core_latest/node_modules/@mcpc/core/src/executors/agentic/agentic-tool-registrar.js
-function registerAgenticTool(server, { description, name, allToolNames, depGroups, toolNameToDetailList }) {
+function registerAgenticTool(server, { description, name, allToolNames, depGroups, toolNameToDetailList, manual }) {
   const createArgsDef = createArgsDefFactory(name, allToolNames, depGroups, void 0, void 0);
-  const agenticExecutor = new AgenticExecutor(name, allToolNames, toolNameToDetailList, server);
-  description = CompiledPrompts.autonomousExecution({
+  const agenticExecutor = new AgenticExecutor(name, allToolNames, toolNameToDetailList, server, manual);
+  description = manual ? CompiledPrompts.autonomousExecutionCompact({
+    toolName: name,
+    description
+  }) : CompiledPrompts.autonomousExecution({
     toolName: name,
     description
   });
   const agenticArgsDef = createArgsDef.forAgentic(allToolNames);
-  const argsDef = agenticArgsDef;
-  const schema = allToolNames.length > 0 ? argsDef : {
-    type: "object",
-    properties: {}
-  };
+  const schema = agenticArgsDef;
   server.tool(name, description, jsonSchema(createModelCompatibleJSONSchema(schema)), async (args) => {
     return await agenticExecutor.execute(args, schema);
   });
@@ -18385,7 +18489,8 @@ var createAgenticModePlugin = () => ({
       name: context2.name,
       allToolNames: context2.allToolNames,
       depGroups: context2.depGroups,
-      toolNameToDetailList: context2.toolNameToDetailList
+      toolNameToDetailList: context2.toolNameToDetailList,
+      manual: context2.manual
     });
   }
 });
@@ -20488,9 +20593,10 @@ var ComposableMCPServer = class extends Server {
     mcpServers: {}
   }, options = {
     mode: "agentic"
-  }) {
+  }, manual) {
     const refDesc = options.refs?.join("") ?? "";
-    const { tagToResults } = parseTags(description + refDesc, [
+    const combinedSource = description + refDesc + (manual ?? "");
+    const { tagToResults } = parseTags(combinedSource, [
       "tool",
       "fn"
     ]);
@@ -20641,6 +20747,7 @@ var ComposableMCPServer = class extends Server {
       server: this,
       name,
       description,
+      manual,
       mode,
       allToolNames,
       toolNameToDetailList,
@@ -20739,7 +20846,7 @@ async function mcpc(serverConf, composeConf, optionsOrSetup) {
     await options.setup(server);
   }
   for (const mcpcConfig of parsed) {
-    await server.compose(mcpcConfig.name, mcpcConfig.description ?? "", mcpcConfig.deps, mcpcConfig.options);
+    await server.compose(mcpcConfig.name, mcpcConfig.description ?? "", mcpcConfig.deps, mcpcConfig.options, mcpcConfig.manual);
   }
   return server;
 }

package/package.json

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

package/types/src/compose.d.ts

@@ -79,6 +79,6 @@ export declare class ComposableMCPServer extends Server {
   /**
    * Close the server and ensure all plugins are disposed
    */ override close(): Promise<void>;
-  compose(name: string | null, description: string, depsConfig?: MCPSetting, options?: ComposeDefinition["options"]): Promise<void>;
+  compose(name: string | null, description: string, depsConfig?: MCPSetting, options?: ComposeDefinition["options"], manual?: string): Promise<void>;
 }
 //# sourceMappingURL=compose.d.ts.map

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,SAAS,OAAO;IAAE,UAAU;GACvD;EA+JN;;GAEC,GACD,gBAAgB,MAAM,MAAM,GAAG,eAAe,SAAS;EAIvD;;GAEC,GACD,eAAe,QAAQ,MAAM,GAAG,aAAa,SAAS;EAItD;;;GAGC,GACD,AAAM,SACJ,MAAM,MAAM,EACZ,MAAM,OAAO,EACb;IAAW,YAAY,MAAM;IAAE,iBAAiB,MAAM;GAAS,GAC9D,QAAQ,OAAO;EA4JlB;;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"}
+{"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+JN;;GAEC,GACD,gBAAgB,MAAM,MAAM,GAAG,eAAe,SAAS;EAIvD;;GAEC,GACD,eAAe,QAAQ,MAAM,GAAG,aAAa,SAAS;EAItD;;;GAGC,GACD,AAAM,SACJ,MAAM,MAAM,EACZ,MAAM,OAAO,EACb;IAAW,YAAY,MAAM;IAAE,iBAAiB,MAAM;GAAS,GAC9D,QAAQ,OAAO;EA4JlB;;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,EAC3D,SAAS,MAAM;AAoRnB"}

package/types/src/plugin-types.d.ts

@@ -65,6 +65,7 @@ export interface ToolPlugin {
   server: ComposableMCPServer;
   name: string;
   description: string;
+  /** Optional manual for progressive disclosure */ manual?: string;
   mode: ExecutionMode | string;
   allToolNames: string[];
   toolNameToDetailList: [string, ComposedTool][];

package/types/src/plugin-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-types.d.ts","sources":["../../src/plugin-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin-types.d.ts","sources":["../../src/plugin-types.ts"],"names":[],"mappings":"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"}

package/types/src/set-up-mcp-compose.d.ts

@@ -12,6 +12,10 @@ export interface ComposeDefinition {
   /**
    * Description of the composed agent's purpose and capabilities.
    */ description?: string;
+  /**
+   * Optional manual for progressive disclosure.
+   * If provided, description will be short and manual fetched via `man { tools: [], manual: true }`.
+   */ manual?: string;
   deps?: MCPSetting;
   /**
    * Global plugins to load and apply to all tools

package/types/src/set-up-mcp-compose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set-up-mcp-compose.d.ts","sources":["../../src/set-up-mcp-compose.ts"],"names":[],"mappings":"AAAA,SAAS,mBAAmB,oBAAoB;AAChD,cAAc,UAAU,6BAA6B;AACrD,cAAc,cAAc,qBAAqB;AACjD,cAAc,UAAU,4BAA4B;AACpD,cAAc,UAAU,qBAAqB;AAC7C,cAAc,aAAa,6BAA6B;AAExD,iBAAiB;EACf;;;GAGC,GACD,MAAM,MAAM,GAAG,IAAI;EACnB;;GAEC,GACD,cAAc,MAAM;EACpB,OAAO;EAEP;;;;;;;;;;;GAWC,GACD,WAAW,aAAa,MAAM;EAE9B;IACE;;;;;;KAMC,GACD,OAAO;IAEP;;KAEC,GACD,iBAAiB;IAEjB;;;;KAIC,GACD;MACE;QACE,QAAQ;UAAQ,OAAO,MAAM;;QAC7B,eAAe,MAAM;QACrB,gBAAgB,MAAM;QACtB,uBAAuB,MAAM;;;IAIjC;;;;KAIC,GACD;MACE,SAAS,MAAM;MACf,OAAO,MAAM;MACb,MAAM,OAAO,MAAM,EAAE,MAAM;MAC3B;QACE,MAAM,MAAM;QACZ,aAAa;UACX,MAAM,MAAM;UACZ,SAAS,MAAM;UACf,OAAO,MAAM;UACb,MAAM,OAAO,MAAM,EAAE,MAAM;;;MAG/B,iBAAiB,OAAO;;IAG1B;;;;KAIC,GACD,WAAW,MAAM;IAEjB;;;;KAIC,GACD,YAAY,MAAM;IAElB;;;;KAIC,GACD,iBAAiB,OAAO;IAExB;;;;;KAKC,GACD;;;KAGC,GACD,OAAO,MAAM;;;AAIjB;;;;;;;;;;;;;CAaC,GACD,YAAY,eAAe,oBAAoB,MAAM;AAIrD,iBAAiB;GACd,KAAK,MAAM,GAAG;;AAGjB;;;CAGC,GACD,YAAY,uBACV,UAAU,MAAM,KACb,QAAQ;AAKb;;CAEC,GACD,OAAO,iBAAS,uBAAuB,QAAQ,mBAAmB,GAAG,IAAI;AAIzE;;CAEC,GACD,OAAO,iBAAS,eAAe,MAAM,MAAM,GAAG,OAAO;AAgCrD,OAAO,iBAAS,iBACd,OAAO,mBAAmB,GACzB;AAIH;;CAEC,GACD,iBAAiB;EACf;;;;;;;;;GASC,GACD,WAAW,aAAa,MAAM;EAE9B;;;GAGC,GACD,SAAS,QAAQ,wBAAwB,IAAI,GAAG,QAAQ,IAAI;;AAG9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsEC,GACD,OAAO,iBAAe,KACpB,YAAY,6BAA6B,oBAAoB,EAC7D,cAAc,cAAc,EAC5B,iBACI,gBACE,QAAQ,wBAAwB,IAAI,GAAG,QAAQ,IAAI,EAAE,GAC1D,QAAQ,oBAAoB"}
+{"version":3,"file":"set-up-mcp-compose.d.ts","sources":["../../src/set-up-mcp-compose.ts"],"names":[],"mappings":"AAAA,SAAS,mBAAmB,oBAAoB;AAChD,cAAc,UAAU,6BAA6B;AACrD,cAAc,cAAc,qBAAqB;AACjD,cAAc,UAAU,4BAA4B;AACpD,cAAc,UAAU,qBAAqB;AAC7C,cAAc,aAAa,6BAA6B;AAExD,iBAAiB;EACf;;;GAGC,GACD,MAAM,MAAM,GAAG,IAAI;EACnB;;GAEC,GACD,cAAc,MAAM;EACpB;;;GAGC,GACD,SAAS,MAAM;EACf,OAAO;EAEP;;;;;;;;;;;GAWC,GACD,WAAW,aAAa,MAAM;EAE9B;IACE;;;;;;KAMC,GACD,OAAO;IAEP;;KAEC,GACD,iBAAiB;IAEjB;;;;KAIC,GACD;MACE;QACE,QAAQ;UAAQ,OAAO,MAAM;;QAC7B,eAAe,MAAM;QACrB,gBAAgB,MAAM;QACtB,uBAAuB,MAAM;;;IAIjC;;;;KAIC,GACD;MACE,SAAS,MAAM;MACf,OAAO,MAAM;MACb,MAAM,OAAO,MAAM,EAAE,MAAM;MAC3B;QACE,MAAM,MAAM;QACZ,aAAa;UACX,MAAM,MAAM;UACZ,SAAS,MAAM;UACf,OAAO,MAAM;UACb,MAAM,OAAO,MAAM,EAAE,MAAM;;;MAG/B,iBAAiB,OAAO;;IAG1B;;;;KAIC,GACD,WAAW,MAAM;IAEjB;;;;KAIC,GACD,YAAY,MAAM;IAElB;;;;KAIC,GACD,iBAAiB,OAAO;IAExB;;;;;KAKC,GACD;;;KAGC,GACD,OAAO,MAAM;;;AAIjB;;;;;;;;;;;;;CAaC,GACD,YAAY,eAAe,oBAAoB,MAAM;AAIrD,iBAAiB;GACd,KAAK,MAAM,GAAG;;AAGjB;;;CAGC,GACD,YAAY,uBACV,UAAU,MAAM,KACb,QAAQ;AAKb;;CAEC,GACD,OAAO,iBAAS,uBAAuB,QAAQ,mBAAmB,GAAG,IAAI;AAIzE;;CAEC,GACD,OAAO,iBAAS,eAAe,MAAM,MAAM,GAAG,OAAO;AAgCrD,OAAO,iBAAS,iBACd,OAAO,mBAAmB,GACzB;AAIH;;CAEC,GACD,iBAAiB;EACf;;;;;;;;;GASC,GACD,WAAW,aAAa,MAAM;EAE9B;;;GAGC,GACD,SAAS,QAAQ,wBAAwB,IAAI,GAAG,QAAQ,IAAI;;AAG9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsEC,GACD,OAAO,iBAAe,KACpB,YAAY,6BAA6B,oBAAoB,EAC7D,cAAc,cAAc,EAC5B,iBACI,gBACE,QAAQ,wBAAwB,IAAI,GAAG,QAAQ,IAAI,EAAE,GAC1D,QAAQ,oBAAoB"}

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,aAAa,OAAO,MAAM,EAAE,OAAO;AAE/C,YAAY,gBAAgB,MAAM,OAAO,EAAE,QAAQ,OAAO,KAAK,OAAO;AAEtE,iBAAiB;EACf,gBAAgB,MAAM;EACtB;;;GAGC,GACD,YAAY,OAAO;;AAWrB;;;;;;;;CAQC,GACD,YAAY,WAAW,MAAM,cAAc,EAAE,MAAM,CAAC,CAAC;AACrD,YAAY,YACR,KACA,UACA,YACA,iBACA;AACJ,YAAY,UAAU,OAAO;AAE7B,YAAY,cACP,YAAY,EAAE,MAAM,CAAC,CAAC,EAAE,WAAW,YAAY,aAC/C,YAAY,EAAE,MAAM,CAAC,CAAC,EAAE,YAAY,WAAW"}
+{"version":3,"file":"types.d.ts","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,aAAa,OAAO,MAAM,EAAE,OAAO;AAE/C,YAAY,gBAAgB,MAAM,OAAO,EAAE,QAAQ,OAAO,KAAK,OAAO;AAEtE,iBAAiB;EACf,gBAAgB,MAAM;EACtB;;;GAGC,GACD,YAAY,OAAO;;AAarB;;;;;;;;CAQC,GACD,YAAY,WAAW,MAAM,cAAc,EAAE,MAAM,CAAC,CAAC;AACrD,YAAY,YACR,KACA,UACA,YACA,iBACA;AACJ,YAAY,UAAU,OAAO;AAE7B,YAAY,cACP,YAAY,EAAE,MAAM,CAAC,CAAC,EAAE,WAAW,YAAY,aAC/C,YAAY,EAAE,MAAM,CAAC,CAAC,EAAE,YAAY,WAAW"}