@mcpc-tech/cli 0.1.33 → 0.1.34

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)
@@ -8878,19 +9000,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 +9030,8 @@ var createAgenticModePlugin = () => ({
       name: context2.name,
       allToolNames: context2.allToolNames,
       depGroups: context2.depGroups,
-      toolNameToDetailList: context2.toolNameToDetailList
+      toolNameToDetailList: context2.toolNameToDetailList,
+      manual: context2.manual
     });
   }
 });
@@ -11013,9 +11135,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 +11289,7 @@ var ComposableMCPServer = class extends Server {
       server: this,
       name,
       description,
+      manual,
       mode,
       allToolNames,
       toolNameToDetailList,
@@ -11244,7 +11368,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)
@@ -8886,19 +9008,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 +9038,8 @@ var createAgenticModePlugin = () => ({
       name: context2.name,
       allToolNames: context2.allToolNames,
       depGroups: context2.depGroups,
-      toolNameToDetailList: context2.toolNameToDetailList
+      toolNameToDetailList: context2.toolNameToDetailList,
+      manual: context2.manual
     });
   }
 });
@@ -11020,9 +11142,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 +11296,7 @@ var ComposableMCPServer = class extends Server {
       server: this,
       name,
       description,
+      manual,
       mode,
       allToolNames,
       toolNameToDetailList,
@@ -11251,7 +11375,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.34",
   "homepage": "https://jsr.io/@mcpc/cli",
   "dependencies": {
     "@hono/zod-openapi": "^0.19.2",