@ema.co/mcp-toolkit 2026.2.5 → 2026.2.19

package/dist/mcp/tools.js

@@ -229,7 +229,7 @@ persona(
                         properties: {
                             method: {
                                 type: "string",
-                                enum: ["list", "stats", "schema", "upload", "copy", "replicate", "delete", "embed", "search"],
+                                enum: ["list", "stats", "schema", "upload", "copy", "replicate", "delete", "embed", "search", "refresh", "regenerate", "replace"],
                                 description: "Data operation to perform (required)"
                             },
                             // copy/replicate params
@@ -314,7 +314,7 @@ persona(
                         description: envDescription
                     },
                 },
-                required: [],
+                required: ["method"],
             },
         },
         // ═══════════════════════════════════════════════════════════════════════════
@@ -407,6 +407,12 @@ persona(
 - \`workflow(mode="deploy", ..., strict_validation=true)\` - block deprecated actions
 - \`workflow(mode="deploy", ..., force=true)\` - bypass blocking validation (emergency only)
 
+## Optimize (structural graph optimization)
+- \`workflow(mode="optimize", persona_id="abc")\` - analyze and optimize existing workflow
+- \`workflow(mode="optimize", workflow_def={...})\` - optimize a workflow directly
+- Returns optimized workflow_def + report. Does NOT auto-deploy.
+- Use workflow(mode="deploy") to deploy the optimized result.
+
 **BLOCKING VALIDATIONS (deployment fails if not met):**
 - Nodes with empty inputs (unwired) → workflow will fail at runtime
 - Search nodes without uploaded data sources → searches return nothing
@@ -424,8 +430,8 @@ persona(
                 properties: {
                     mode: {
                         type: "string",
-                        enum: ["get", "deploy", "validate"],
-                        description: "get = return data for LLM, validate = static validation with path enumeration, deploy = execute LLM's workflow_def",
+                        enum: ["get", "deploy", "validate", "optimize"],
+                        description: "get = return data for LLM, validate = static validation with path enumeration, deploy = execute LLM's workflow_def, optimize = structural graph optimization",
                     },
                     persona_id: {
                         type: "string",
@@ -460,6 +466,14 @@ persona(
                         type: "number",
                         description: "Timeout in milliseconds (for mode=validate). Default: 100",
                     },
+                    auto_apply: {
+                        type: "boolean",
+                        description: "Apply safe auto-transforms (for mode=optimize). Default: true",
+                    },
+                    max_passes: {
+                        type: "number",
+                        description: "Maximum optimization passes (for mode=optimize). Default: 5",
+                    },
                     strict_validation: {
                         type: "boolean",
                         description: "If true, block deployment of deprecated actions (for mode=deploy). Default: false (warn only)",
@@ -538,6 +552,79 @@ persona(
                 required: []
             },
         },
+        // ═══════════════════════════════════════════════════════════════════════════
+        // 6. TOOLKIT_FEEDBACK - Agent feedback collection
+        // ═══════════════════════════════════════════════════════════════════════════
+        {
+            name: "toolkit_feedback",
+            description: `Submit feedback about the MCP toolkit to help improve documentation and guidance. Your feedback creates a self-improving loop.
+
+**IMPORTANT**: All operations require explicit \`method\` parameter.
+
+## Submit Feedback
+- \`toolkit_feedback(method="submit", category="gap", message="...")\` - report missing docs
+- \`toolkit_feedback(method="submit", category="confusion", message="...", tool="workflow")\` - report unclear guidance
+- \`toolkit_feedback(method="submit", category="success", message="...")\` - report what worked well
+- \`toolkit_feedback(method="submit", category="error_unclear", message="...", tool="persona")\` - report unhelpful errors
+- \`toolkit_feedback(method="submit", category="suggestion", message="...")\` - suggest improvements
+
+## Review Feedback
+- \`toolkit_feedback(method="list")\` - view recent feedback
+- \`toolkit_feedback(method="list", category="gap")\` - filter by category
+- \`toolkit_feedback(method="analyze")\` - aggregate insights and actionable items
+
+## When to Submit Feedback
+- You encountered an error message that didn't help you fix the issue
+- Documentation was missing for something you needed to do
+- Guidance was confusing or led you to the wrong approach
+- Something worked really well and the docs were helpful
+- You have an idea to make the toolkit better`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    method: {
+                        type: "string",
+                        enum: ["submit", "list", "analyze"],
+                        description: "Operation to perform (required)",
+                    },
+                    category: {
+                        type: "string",
+                        enum: ["gap", "confusion", "success", "error_unclear", "suggestion"],
+                        description: "Feedback category (required for submit): gap=missing docs, confusion=unclear guidance, success=worked well, error_unclear=unhelpful error, suggestion=improvement idea",
+                    },
+                    message: {
+                        type: "string",
+                        description: "What you encountered or want to report (required for submit)",
+                    },
+                    tool: {
+                        type: "string",
+                        description: "Which tool was involved (optional, e.g. 'persona', 'workflow', 'catalog')",
+                    },
+                    operation: {
+                        type: "string",
+                        description: "Which operation (optional, e.g. 'deploy', 'get', 'create')",
+                    },
+                    context: {
+                        type: "string",
+                        description: "What you were trying to accomplish (optional)",
+                    },
+                    severity: {
+                        type: "string",
+                        enum: ["low", "medium", "high"],
+                        description: "How impactful this issue was (optional, default: medium)",
+                    },
+                    limit: {
+                        type: "number",
+                        description: "Max entries to return (for method=list, default: 50)",
+                    },
+                    include_telemetry: {
+                        type: "boolean",
+                        description: "Include passive telemetry data (for method=list, default: false)",
+                    },
+                },
+                required: ["method"],
+            },
+        },
     ];
 }
 /**
@@ -545,7 +632,6 @@ persona(
  * These still work for backwards compat but aren't in the tool list
  */
 export const INTERNAL_TOOLS = [
-    "workflow", // Standalone tool for workflow get/deploy (not routed through persona)
     "knowledge", // → persona(id=..., data={method:...})
     "demo", // → persona(id=..., data={method:"upload", content:...})
     "action", // → catalog(method="list", type="actions")