@ema.co/mcp-toolkit 1.4.3 → 1.5.0

package/dist/mcp/tools-consolidated.js

@@ -140,93 +140,110 @@ export function generateConsolidatedTools(envNames, defaultEnv) {
             }),
         },
         // ═══════════════════════════════════════════════════════════════════════
-        // 3. WORKFLOW - Generation, analysis, extension, optimization
+        // 3. WORKFLOW - Unified workflow operations (greenfield & brownfield)
         // ═══════════════════════════════════════════════════════════════════════
         {
             name: "workflow",
-            description: `Unified workflow operations. All modification modes default to preview=true for safety.
+            description: `Unified workflow operations. Automatically detects greenfield vs brownfield.
 
-**Greenfield** (NEW workflow from scratch):
+**Greenfield** (NEW workflow - no persona_id):
   workflow(input="IT helpdesk with KB search")
-  workflow(mode="generate", input="customer support bot")
-  workflow(mode="generate", input="...", preview=false)  # Generate AND deploy
+  workflow(input="customer support bot", preview=false)  # Generate AND deploy to new persona
 
-**Extend** (MODIFY existing workflow - brownfield):
-  workflow(mode="extend", persona_id="abc", input="add caller_type categorizer")
-  workflow(mode="extend", persona_id="abc", input="add HITL before email, add compliance intent")
-  workflow(mode="extend", persona_id="abc", input="...", preview=false)  # Extend AND deploy
+**Brownfield** (MODIFY existing - persona_id + input):
+  workflow(persona_id="abc", input="add HITL before email")
+  workflow(persona_id="abc", input="consolidate the 6 custom agents into one unified agent")
+  workflow(persona_id="abc", input="remove the orphan nodes")
+  workflow(persona_id="abc", input="replace the email LLM nodes with entity_extraction")
+  workflow(persona_id="abc", input="...", preview=false)  # Modify AND deploy
 
-**Optimize** (FIX issues in existing workflow):
-  workflow(mode="optimize", persona_id="abc")           # Preview fixes
-  workflow(mode="optimize", persona_id="abc", preview=false)  # Apply fixes
-
-**Analyze** (inspect existing - always read-only):
+**Analyze** (inspect - persona_id only, no input):
   workflow(persona_id="abc-123")
-  workflow(mode="analyze", persona_id="abc-123")
-  workflow(mode="analyze", workflow_def={...})
+  workflow(persona_id="abc-123", include=["issues", "fixes"])
+
+**Optimize** (auto-fix issues):
+  workflow(persona_id="abc", optimize=true)
+  workflow(persona_id="abc", optimize=true, preview=false)  # Fix AND deploy
 
-**Compare** (diff two workflows - always read-only):
-  workflow(mode="compare", persona_id="abc", compare_to="def")
+**Compare**:
+  workflow(persona_id="abc", compare_to="def")
 
-**Compile** (from explicit node spec - returns workflow_def):
-  workflow(mode="compile", name="...", description="...", nodes=[...])
+**Generate extraction schema from metadata**:
+  workflow(mode="extraction_schema", metadata_file="/path/to/metadata.json")
+  workflow(mode="extraction_schema", metadata_json={...})
 
 ## Key Concepts
 
 - **preview=true** (default): Returns result without deploying. Safe for exploration.
-- **preview=false**: Deploys the result. Server handles fetching proto_config, etc.
-- **Auto-builder is abstracted**: Server decides when to use it internally.`,
+- **preview=false**: Deploys the result.
+- **Mode is auto-detected**: No need to specify mode - just provide what you have.
+- **Complex changes supported**: Consolidate, remove, replace, rewire nodes.
+- **Dynamic schema generation**: Parse JSON metadata to generate extraction schemas automatically.`,
             inputSchema: withEnv({
-                // Mode - explicit operation
-                mode: {
-                    type: "string",
-                    enum: ["generate", "extend", "optimize", "analyze", "compare", "compile"],
-                    description: "Operation: 'generate' (new), 'extend' (modify existing), 'optimize' (fix issues), 'analyze' (inspect), 'compare' (diff), 'compile' (from nodes). Default: inferred from args."
-                },
-                // Input (for generate/extend)
+                // Input - natural language description of what you want
                 input: {
                     anyOf: [
                         { type: "string", description: "Natural language description" },
                         { type: "object", description: "Workflow intent/spec object" },
                     ],
-                    description: "Natural language requirements. Can include multiple changes: 'add X, add Y, add Z'",
+                    description: "What you want: 'IT helpdesk bot' (greenfield) or 'consolidate agents into one' (brownfield with persona_id)",
                 },
-                // Target persona (for extend/optimize/analyze/compare)
+                // Target persona (if provided = brownfield, if not = greenfield)
                 persona_id: {
                     type: "string",
-                    description: "Persona ID for existing workflow operations (extend/optimize/analyze/compare)"
+                    description: "Existing persona to modify. If provided with input = brownfield modification."
                 },
                 // Preview vs Deploy (default: preview=true for safety)
                 preview: {
                     type: "boolean",
                     description: "Preview changes without deploying. Default: true. Set false to deploy."
                 },
-                // Persona type (for generate)
-                type: {
-                    type: "string",
-                    enum: ["voice", "chat", "dashboard"],
-                    description: "Persona type for generate mode (default: chat)"
+                // Optimize flag - auto-fix detected issues
+                optimize: {
+                    type: "boolean",
+                    description: "Auto-fix detected issues in the workflow. Use with persona_id.",
                 },
                 // Compare target
-                compare_to: { type: "string", description: "Second persona ID for compare mode" },
+                compare_to: { type: "string", description: "Second persona ID for comparison" },
                 // Analyze options
                 include: {
                     type: "array",
                     items: { type: "string", enum: ["issues", "connections", "fixes", "metrics"] },
                     description: "What to include in analysis. Default: all.",
                 },
-                // Direct workflow input (for analyze without persona_id)
+                // Persona type (for greenfield)
+                type: {
+                    type: "string",
+                    enum: ["voice", "chat", "dashboard"],
+                    description: "Persona type for new workflows (default: chat)"
+                },
+                // Direct workflow input (for analysis)
                 workflow_def: {
                     type: "object",
                     description: "Workflow JSON for analysis (alternative to persona_id)"
                 },
-                // Compile mode inputs
+                // Proto config override
+                proto_config: { type: "object", description: "Persona config override (voice settings, etc.)" },
+                // Legacy mode support (for backwards compatibility)
+                mode: {
+                    type: "string",
+                    enum: ["generate", "extend", "optimize", "analyze", "compare", "compile", "extraction_schema"],
+                    description: "DEPRECATED: Mode is auto-detected. Use explicitly for compile or extraction_schema mode."
+                },
+                // Extraction schema generation (dynamic, no hardcoding)
+                metadata_file: {
+                    type: "string",
+                    description: "Path to JSON metadata file for extraction schema generation"
+                },
+                metadata_json: {
+                    type: "object",
+                    description: "JSON metadata object (alternative to metadata_file) - dynamically parsed to generate extraction fields"
+                },
+                // Compile mode inputs (explicit node spec)
                 name: { type: "string", description: "Workflow name (for compile mode)" },
                 description: { type: "string", description: "Workflow description (for compile mode)" },
                 nodes: { type: "array", description: "Node definitions (for compile mode)" },
                 result_mappings: { type: "array", description: "Output mappings (for compile mode)" },
-                // Proto config override
-                proto_config: { type: "object", description: "Persona config override (voice settings, etc.)" },
             }),
         },
         // ═══════════════════════════════════════════════════════════════════════
@@ -406,6 +423,20 @@ export function generateConsolidatedTools(envNames, defaultEnv) {
 **Guidance**:
   reference(guidance="categorizer-routing")
   reference(guidance="type-compatibility")
+  reference(guidance="workflow-structure")  # Summarizer → Extractor → JSON mapper pattern
+  reference(guidance="search-node-timing")  # When to use search nodes, early vs late
+  reference(guidance="node-execution-conditions")  # When nodes execute or are skipped
+  reference(guidance="array-preservation")  # How to preserve arrays through extraction → mapping → downstream
+  reference(guidance="search-filtering")  # Semantic query + structured filters best practices
+  reference(guidance="fallback-response-inputs")  # Fallback should use full conversation + context
+  reference(guidance="separate-vs-merged-inputs")  # Keep separate named_inputs for multi-source data
+  reference(guidance="folder-path-filtering")  # Folder path filtering with semantic query
+  reference(guidance="automated-extraction-json")  # Automating extraction → JSON mapper pattern
+  reference(guidance="when-filters-necessary")  # When filters are required vs optional
+  reference(guidance="filter-query-guidance")  # When to use filters vs queries vs both
+  reference(guidance="workflow-structure")
+  reference(guidance="search-node-timing")
+  reference(guidance="node-execution-conditions")
 
 **Debugging**:
   reference(mistakes=true)

package/dist/sdk/index.js

@@ -45,3 +45,7 @@ hashSnapshot, generateVersionId, generateVersionName, nowIso, createSnapshotFrom
 export { VersionStorage, createVersionStorage, } from "./version-storage.js";
 // Version Policy Engine (Automatic versioning decisions)
 export { VersionPolicyEngine, createVersionPolicyEngine, } from "./version-policy.js";
+// Workflow Execution Analyzer (Loop, multiple responder, redundant classifier detection)
+export { analyzeExecutionFlow, detectLoops, detectMultipleResponders, detectRedundantClassifiers, analyzeDataFlow, findDeadCodePaths, generateASCIIFlow, } from "./workflow-execution-analyzer.js";
+// Workflow Fixer (Auto-fix including multiple responder issues)
+export { autoFixWorkflow, suggestFixes, } from "./workflow-fixer.js";