@mcpc-tech/cli 0.1.33 → 0.1.35

package/bin/mcpc.cjs

@@ -8324,6 +8324,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)
@@ -8401,6 +8418,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),
@@ -8467,7 +8485,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: [
@@ -8478,7 +8496,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 {
@@ -8492,16 +8513,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"] }'
@@ -8623,14 +8678,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);
@@ -8698,7 +8755,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);
@@ -8721,6 +8805,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)
@@ -8762,15 +8884,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);
@@ -8793,84 +8929,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 (error) {
       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 (error) {
-        if (executeSpan) {
-          endSpan(executeSpan, error);
-        }
-        this.logger.error({
-          message: "Error executing internal tool",
-          tool: tool2,
-          error: String(error)
-        });
-        return {
-          content: [
-            {
-              type: "text",
-              text: `Error executing tool "${tool2}": ${error instanceof Error ? error.message : String(error)}`
-            }
-          ],
-          isError: true
-        };
+        endSpan(executeSpan, error);
       }
-    }
-    if (executeSpan) {
-      executeSpan.setAttributes({
-        toolType: "not_found",
-        tool: tool2
+      this.logger.error({
+        message: `Error executing ${toolType} tool`,
+        tool: tool2,
+        error: String(error)
       });
-      endSpan(executeSpan);
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Error executing tool "${tool2}": ${error instanceof Error ? error.message : String(error)}`
+          }
+        ],
+        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);
@@ -8878,19 +8983,18 @@ ${JSON.stringify(cleanedSchema, null, 2)}
 };
 
 // __mcpc__cli_latest/node_modules/@jsr/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);
   });
@@ -8909,7 +9013,8 @@ var createAgenticModePlugin = () => ({
       name: context2.name,
       allToolNames: context2.allToolNames,
       depGroups: context2.depGroups,
-      toolNameToDetailList: context2.toolNameToDetailList
+      toolNameToDetailList: context2.toolNameToDetailList,
+      manual: context2.manual
     });
   }
 });
@@ -11013,9 +11118,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"
     ]);
@@ -11166,6 +11272,7 @@ var ComposableMCPServer = class extends Server {
       server: this,
       name,
       description,
+      manual,
       mode,
       allToolNames,
       toolNameToDetailList,
@@ -11244,7 +11351,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/bin/mcpc.mjs

@@ -8332,6 +8332,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)
@@ -8409,6 +8426,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),
@@ -8475,7 +8493,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: [
@@ -8486,7 +8504,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 {
@@ -8500,16 +8521,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"] }'
@@ -8631,14 +8686,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);
@@ -8706,7 +8763,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);
@@ -8729,6 +8813,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)
@@ -8770,15 +8892,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);
@@ -8801,84 +8937,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 (error) {
       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 (error) {
-        if (executeSpan) {
-          endSpan(executeSpan, error);
-        }
-        this.logger.error({
-          message: "Error executing internal tool",
-          tool: tool2,
-          error: String(error)
-        });
-        return {
-          content: [
-            {
-              type: "text",
-              text: `Error executing tool "${tool2}": ${error instanceof Error ? error.message : String(error)}`
-            }
-          ],
-          isError: true
-        };
+        endSpan(executeSpan, error);
       }
-    }
-    if (executeSpan) {
-      executeSpan.setAttributes({
-        toolType: "not_found",
-        tool: tool2
+      this.logger.error({
+        message: `Error executing ${toolType} tool`,
+        tool: tool2,
+        error: String(error)
       });
-      endSpan(executeSpan);
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Error executing tool "${tool2}": ${error instanceof Error ? error.message : String(error)}`
+          }
+        ],
+        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);
@@ -8886,19 +8991,18 @@ ${JSON.stringify(cleanedSchema, null, 2)}
 };
 
 // __mcpc__cli_latest/node_modules/@jsr/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);
   });
@@ -8917,7 +9021,8 @@ var createAgenticModePlugin = () => ({
       name: context2.name,
       allToolNames: context2.allToolNames,
       depGroups: context2.depGroups,
-      toolNameToDetailList: context2.toolNameToDetailList
+      toolNameToDetailList: context2.toolNameToDetailList,
+      manual: context2.manual
     });
   }
 });
@@ -11020,9 +11125,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"
     ]);
@@ -11173,6 +11279,7 @@ var ComposableMCPServer = class extends Server {
       server: this,
       name,
       description,
+      manual,
       mode,
       allToolNames,
       toolNameToDetailList,
@@ -11251,7 +11358,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/cli",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "homepage": "https://jsr.io/@mcpc/cli",
   "dependencies": {
     "@hono/zod-openapi": "^0.19.2",