feat: update version to 0.1.8; enhance validation logic in AgenticExecutor and improve search tool plugin descriptions

Author: yaonyan

packages/core/deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcpc/core",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "tasks": {
     "server:compile": "echo \"no need to compile\"",
     "test": "deno test --allow-env --allow-read tests/",

packages/core/src/executors/agentic/agentic-executor.ts

@@ -143,10 +143,17 @@ export class AgenticExecutor {
   }
 
   // Validate arguments using JSON schema
-  validate(args: Record<string, unknown>, schema: Record<string, unknown>): {
+  validate(
+    args: Record<string, unknown>,
+    schema: Record<string, unknown>,
+  ): {
     valid: boolean;
     error?: string;
   } {
+    // Skip validation for complete decision
+    if (args.decision === "complete") {
+      return { valid: true };
+    }
     const validate = ajv.compile(schema);
     if (!validate(args)) {
       const errors = new AggregateAjvError(validate.errors!);

packages/core/src/factories/args-def-factory.ts

@@ -108,7 +108,7 @@ Workflow step definitions - provide ONLY on initial call.
       type: "string",
       enum: Object.values(DECISION_OPTIONS),
       description:
-        `**Step control: \`${DECISION_OPTIONS.PROCEED}\` = next step, \`${DECISION_OPTIONS.RETRY}\` = retry current, \`${DECISION_OPTIONS.COMPLETE}\` = finish workflow**`,
+        `**Step control: \`${DECISION_OPTIONS.PROCEED}\` = next step, \`${DECISION_OPTIONS.RETRY}\` = retry/repeat current, \`${DECISION_OPTIONS.COMPLETE}\` = finish workflow**`,
     }),
 
     action: (): JSONSchema => ({
@@ -180,7 +180,7 @@ Workflow step definitions - provide ONLY on initial call.
       );
 
       const actionDescription =
-        "Specifies the action to be performed from the enum. Based on the value chosen for 'action', the corresponding sibling property (which shares the same name as the action value and contains its specific parameters) **MUST** also be provided in this object. For example, if 'action' is 'get_weather', then the 'get_weather' parameter object is mandatory.";
+        `Specifies the action to be performed from the enum. **⚠️ When setting \`action: "example_action"\`, you MUST also provide \`"example_action": { ... }\`**`;
 
       const baseProperties = {
         [ACTION_KEY]: {
@@ -192,7 +192,7 @@ Workflow step definitions - provide ONLY on initial call.
           type: "string",
           enum: allToolNames,
           description:
-            "Specify the next action to execute only when the user's request requires additional steps. If no next action is needed, this property **MUST BE OMITTED** from the object.",
+            "Optional: Specify the next action to execute. Only include this when you know additional actions are needed after the current one completes.",
         },
         decision: this.decision(),
         ...depGroups,

packages/core/src/plugins/search-tool.ts

@@ -42,7 +42,7 @@ export function createSearchPlugin(options: SearchOptions = {}): ToolPlugin {
       // Register the search tool once during plugin initialization
       server.tool(
         "search-tool-result",
-        `Search files for text patterns. Allowed directory: ${allowedSearchDir}`,
+        `Search for text patterns in files and directories. Use this to find specific content, code, or information within files.`,
         jsonSchema<{ pattern: string; path?: string; maxResults?: number }>({
           type: "object",
           properties: {
@@ -84,7 +84,8 @@ export function createSearchPlugin(options: SearchOptions = {}): ToolPlugin {
                   content: [
                     {
                       type: "text",
-                      text: `❌ Path "${args.path}" not allowed. Must be within: ${allowedSearchDir}`,
+                      text:
+                        `❌ Path "${args.path}" not allowed. Must be within: ${allowedSearchDir}`,
                     },
                   ],
                 };
@@ -125,20 +126,23 @@ export function createSearchPlugin(options: SearchOptions = {}): ToolPlugin {
                 content: [
                   {
                     type: "text",
-                    text: `No matches found for: "${args.pattern}"\n\nTry:\n- **Simpler/ pattern** or \`*\`\n- Check if files exist in: ${searchPath}\n- Use specific file path`,
+                    text:
+                      `No matches found for: "${args.pattern}"\n\nTry:\n- **Simpler pattern** or \`*\`\n- Check if files exist in: ${searchPath}\n- Use specific file path`,
                   },
                 ],
               };
             }
 
             // Build output and check size
             const matches = result.matches.slice(0, limit);
-            let output = `Found ${result.matches.length} matches (showing up to ${matches.length}):\n\n`;
+            let output =
+              `Found ${result.matches.length} matches (showing up to ${matches.length}):\n\n`;
             let matchesIncluded = 0;
 
             for (const match of matches) {
               const baseMatchText = `**${match.path}:${match.lineNumber}**\n`;
-              const fullMatchText = `${baseMatchText}\`\`\`\n${match.line}\n\`\`\`\n\n`;
+              const fullMatchText =
+                `${baseMatchText}\`\`\`\n${match.line}\n\`\`\`\n\n`;
 
               // Check if adding this match would exceed size limit
               if ((output + fullMatchText).length > maxOutputSize) {
@@ -148,7 +152,8 @@ export function createSearchPlugin(options: SearchOptions = {}): ToolPlugin {
                   if (remainingSpace > 50) {
                     // Only truncate if we have reasonable space
                     const truncatedLine = match.line.slice(0, remainingSpace);
-                    output += `${baseMatchText}\`\`\`\n${truncatedLine}...\n\`\`\`\n\n`;
+                    output +=
+                      `${baseMatchText}\`\`\`\n${truncatedLine}...\n\`\`\`\n\n`;
                     output += `⚠️ Content truncated\n`;
                     matchesIncluded++;
                   } else {
@@ -164,10 +169,12 @@ export function createSearchPlugin(options: SearchOptions = {}): ToolPlugin {
 
             // Add size limit warning if needed
             if (matchesIncluded < matches.length) {
-              output += `\n⚠️ Showing ${matchesIncluded}/${matches.length} matches (size limit)\n`;
+              output +=
+                `\n⚠️ Showing ${matchesIncluded}/${matches.length} matches (size limit)\n`;
               output += `\nFor more results:\n`;
               output += `- Use specific pattern: "${args.pattern} keyword"\n`;
-              output += `- Search specific file: {"pattern": "${args.pattern}", "path": "/file.txt"}\n`;
+              output +=
+                `- Search specific file: {"pattern": "${args.pattern}", "path": "/file.txt"}\n`;
               output += `- Use fewer results: {"maxResults": 5}`;
             }
 
@@ -180,8 +187,9 @@ export function createSearchPlugin(options: SearchOptions = {}): ToolPlugin {
               ],
             };
           } catch (error) {
-            const errorMsg =
-              error instanceof Error ? error.message : String(error);
+            const errorMsg = error instanceof Error
+              ? error.message
+              : String(error);
             const isTimeout = errorMsg.includes("timeout");
 
             return {
@@ -198,7 +206,7 @@ export function createSearchPlugin(options: SearchOptions = {}): ToolPlugin {
             };
           }
         },
-        { internal: !global }
+        { internal: !global },
       );
     },
   };

packages/core/src/prompts/index.ts

@@ -12,35 +12,30 @@ export const SystemPrompts = {
    * Base system prompt for autonomous MCP execution
    */
   AUTONOMOUS_EXECUTION:
-    `Agentic MCP tool \`{toolName}\` that processes instructions through iterative self-invocation and autonomous decision-making.
+    `Autonomous AI Agent \`{toolName}\` that answers user questions through iterative self-invocation and collecting feedback.
 
 <instructions>{description}</instructions>
 
-## Autonomous Execution Protocol
-
-**🎯 FIRST CALL (Analysis & Planning):**
-1. **Understand Request:** Analyze the user's instruction and identify the end goal
-2. **Plan Approach:** Determine the sequence of actions needed
-3. **Execute First Action:** Start with the most logical first step
-
-**⚡ SUBSEQUENT CALLS (Iterative Execution):**
-1. **Evaluate Previous Action:** Analyze results from the last action
-2. **Assess Progress:** Determine completion status toward the final goal
-3. **Decision Making:**
-   - **Continue:** Execute next logical action if more work is needed
-   - **Complete:** Finish if the user request is fully satisfied
-
-**🔄 Key Execution Rules:**
-- Each call should execute exactly ONE action
-- Always evaluate results before planning the next action
-- Maintain context and progress toward the original goal
-- Use clear reasoning for action selection
-- Stop when the user request is fully satisfied
-
-**📋 Action Selection Criteria:**
-- Choose actions that directly advance toward the goal
-- Prioritize logical sequence and dependencies
-- Consider error handling and validation needs`,
+## Execution Rules
+1. **Follow instructions above** carefully
+2. **Answer user question** as primary goal
+3. **Execute** one action per call  
+4. **Collect feedback** from each action result
+5. **Decide** next step:
+   - **proceed**: More work needed
+   - **complete**: Question answered
+   - **retry**: Current action failed
+6. **Provide** parameter object matching action name
+7. **Continue** until complete
+
+## Call Format
+\`\`\`json
+{
+  "action": "tool_name",
+  "decision": "proceed|retry|complete", 
+  "tool_name": { /* tool parameters */ }
+}
+\`\`\``,
 
   /**
    * Workflow execution system prompt
@@ -66,40 +61,33 @@ export const SystemPrompts = {
 **⚠️ CRITICAL: When retrying failed steps, MUST use \`decision: "retry"\`**`,
 
   /**
-   * Sampling execution system prompt with JSON output constraints
+   * JSON-only execution system prompt
    */
   SAMPLING_EXECUTION:
-    `You are an autonomous AI Agent named \`{toolName}\` that processes instructions through iterative sampling execution and autonomous decision-making.
+    `Autonomous AI Agent \`{toolName}\` that answers user questions by iteratively collecting feedback and adapting your approach.
 
 <instructions>{description}</instructions>
 
-## Agentic Sampling Protocol
-
-**🧠 AGENTIC REASONING:**
-1. **Autonomous Analysis:** Independently analyze the user's instruction and identify the end goal
-2. **Self-Directed Planning:** Autonomously determine the sequence of tools needed
-3. **Iterative Execution:** Use available tools step by step with self-guided decision making
-4. **Goal-Oriented Adaptation:** Continuously evaluate progress and adapt strategy autonomously
-
-**⚡ AGENTIC EXECUTION RULES:**
-- Each response demonstrates autonomous reasoning and decision-making
-- Make self-directed choices about which tools to use and when
-- Adapt your approach based on previous results without external guidance
-- Use "decision: complete" when you autonomously determine the task is finished
-
-**🔄 JSON Response Format (Agentic Decision Output):**
-You MUST respond with a JSON object that demonstrates your autonomous decision:
-- action: Your self-selected tool name
-- decision: "proceed" (continue execution), "retry" (retry current step), or "complete" (finish task)
-- [tool parameters]: Tool-specific parameters you autonomously determine
-
-**📋 Available Tools:**
-{toolList}
-
-**🎯 AGENTIC CONSTRAINTS:**
-- Response must be pure JSON demonstrating autonomous decision-making
-- Invalid JSON indicates failure in agentic reasoning
-- Tool parameters must reflect your independent analysis and planning`,
+## Execution Rules
+- Respond with valid JSON only
+- **Follow instructions above** carefully
+- **Answer user question** as primary goal
+- **Collect feedback** from each action result
+- **Adapt approach** based on gathered information
+- action = "X" → provide parameter "X"
+- Continue until question answered
+
+## JSON Response Format
+\`\`\`json
+{
+  "action": "tool_name",
+  "decision": "proceed|retry|complete",
+  "tool_name": { /* tool parameters */ }
+}
+\`\`\`
+
+## Available Tools
+{toolList}`,
 
   /**
    * Sampling workflow execution system prompt combining sampling with workflow capabilities