@ema.co/mcp-toolkit 2026.1.25 → 2026.1.26-4

package/dist/mcp/prompts.js

@@ -338,15 +338,19 @@ Environment: ${args.env || "demo"}
 
 Follow this review workflow using the consolidated tools:
 
-### Step 1: Fetch Persona + Workflow
-Call \`persona(id="${args.persona_id}", include_workflow=true, env="${args.env || "demo"}")\` to fetch the full workflow_def.
+### Step 1: Fetch Workflow Data
+Call \`workflow(mode="get", persona_id="${args.persona_id}", env="${args.env || "demo"}")\` to get the workflow_def, schema, and examples.
 
-### Step 2: Analyze (Issues + Connections + Fixes + Metrics)
-Call \`workflow(mode="analyze", persona_id="${args.persona_id}", env="${args.env || "demo"}")\`.
+### Step 2: Analyze (YOU do this)
+Review the workflow_def for:
+- Missing WORKFLOW_OUTPUT (required for activation)
+- Missing Fallback category in categorizers
+- Type mismatches between connected nodes
+- Orphan nodes not connected to output
 
-### Step 3: (Optional) Preview Auto-Fixes
-If issues are found and you want a one-click preview of fixes:
-Call \`workflow(mode="optimize", persona_id="${args.persona_id}", preview=true, env="${args.env || "demo"}")\`.
+### Step 3: Propose Fixes
+If issues are found, generate a corrected workflow_def and deploy:
+Call \`workflow(mode="deploy", persona_id="${args.persona_id}", workflow_def={...}, env="${args.env || "demo"}")\`.
 
 ## Output Format
 
@@ -456,9 +460,9 @@ ${args.symptoms.toLowerCase().includes("hitl") || args.symptoms.toLowerCase().in
 ` : ""}
 ${args.symptoms.toLowerCase().includes("type") || args.symptoms.toLowerCase().includes("mismatch") ? `
 **Type Compatibility Issues:**
-- Call \`workflow(mode="analyze", persona_id="${args.persona_id}", env="${args.env || "demo"}", include=["connections"])\` for an edge-by-edge type check
+- Call \`workflow(mode="get", persona_id="${args.persona_id}", env="${args.env || "demo"}")\` and analyze the workflow_def
+- Check wellKnownType compatibility between connected nodes
 - Common issues: chat_conversation → search (should be user_query)
-- Check wellKnownType compatibility
 ` : ""}
 ${args.symptoms.toLowerCase().includes("loop") || args.symptoms.toLowerCase().includes("infinite") || args.symptoms.toLowerCase().includes("hang") ? `
 **Loop/Hang Issues:**
@@ -467,8 +471,8 @@ ${args.symptoms.toLowerCase().includes("loop") || args.symptoms.toLowerCase().in
 - Verify workflow has proper termination paths
 ` : ""}
 
-### Step 4: Run Issue Detection
-Call \`workflow(mode="analyze", persona_id="${args.persona_id}", env="${args.env || "demo"}")\` to find issues, connections, suggested fixes, and metrics.
+### Step 4: Review Workflow
+Call \`workflow(mode="get", persona_id="${args.persona_id}", env="${args.env || "demo"}")\` and analyze the workflow_def for issues.
 
 ### Step 5: Propose Fix
 Based on findings, provide specific fix with before/after configuration.
@@ -642,13 +646,15 @@ Call in parallel:
 - \`persona(id="${args.persona_id_1}", include_workflow=true, env="${args.env_1 || "demo"}")\`
 - \`persona(id="${args.persona_id_2}", include_workflow=true, env="${args.env_2 || args.env_1 || "demo"}")\`
 
-### Step 2: Compare
-Call \`persona(id="${args.persona_id_1}", mode="compare", compare_to="${args.persona_id_2}", env="${args.env_1 || "demo"}", compare_env="${args.env_2 || args.env_1 || "demo"}")\`.
+### Step 2: Get Both Personas
+Call \`persona(method="get", id="${args.persona_id_1}", include_workflow=true, env="${args.env_1 || "demo"}")\`
+Call \`persona(method="get", id="${args.persona_id_2}", include_workflow=true, env="${args.env_2 || args.env_1 || "demo"}")\`
 
-### Step 3: Compare Workflows (if both have workflows)
-If both personas are in the same environment, call:
-\`workflow(mode="compare", persona_id="${args.persona_id_1}", compare_to="${args.persona_id_2}", env="${args.env_1 || "demo"}")\`
-to see structural differences.
+### Step 3: Compare (YOU do this)
+Compare the two workflow_def structures:
+- Node differences (added/removed/renamed)
+- Connection differences
+- Configuration differences
 
 ## Output Format
 
@@ -754,8 +760,9 @@ ${args.action === "snapshot" ? `
 1. List versions first to see available:
    \`persona(id="${args.persona_id}", mode="version_list", env="${args.env || "demo"}")\`
 
-2. Compare two versions:
-   \`persona(id="${args.persona_id}", mode="version_compare", v1="${args.version || "v1"}", v2="latest", env="${args.env || "demo"}")\`
+2. Get two versions and compare (YOU compare the results):
+   \`persona(id="${args.persona_id}", mode="version_get", version="${args.version || "v1"}", env="${args.env || "demo"}")\`
+   \`persona(id="${args.persona_id}", mode="version_get", version="latest", env="${args.env || "demo"}")\`
 
 3. Present changes:
    - Fields that changed
@@ -937,7 +944,7 @@ Provide examples of common tasks:
 2. **Search for specific persona**: \`persona(query="support", status="active", env="demo")\`
 3. **Get full persona details**: \`persona(id="xxx", include_workflow=true, env="demo")\`
 4. **Sync a persona**: \`sync(id="my-bot", source="demo", target="dev")\`
-5. **Analyze workflow**: \`workflow(mode="analyze", persona_id="xxx", env="demo")\`
+5. **Get workflow data**: \`workflow(mode="get", persona_id="xxx", env="demo")\` (you analyze the result)
 
 ## Output Format
 
@@ -1027,11 +1034,19 @@ ${args.intents ? `**Intents**: ${args.intents}` : ""}
 
 ## Instructions
 
-### Step 1: Read Templates (Resources)
-Read these resources to get templates and reference data:
-- \`ema://templates/voice-ai/config\` - Voice AI persona configuration template
-- \`ema://templates/voice-ai/workflow-prompt\` - Auto Builder prompt template with safeguards
-- \`ema://templates/voice-ai/readme\` - Deployment guide template
+### Step 0: Check Deprecated Actions (DO THIS FIRST)
+Fetch \`ema://rules/deprecated-actions-summary\` to know which actions to AVOID.
+
+**Key deprecated actions to avoid:**
+- search/v0 → use search/v2 (requires datastore_configs)
+- respond_with_sources → use respond_for_external_actions
+- call_llm/v0 → use call_llm/v2
+- web_search/v0 → use live_web_search or ai_web_search
+
+### Step 1: Get Templates
+Get templates from API or use generated fallbacks:
+- \`template(config="voice")\` - Voice AI persona configuration (API-first with fallback)
+- \`ema://catalog/persona-templates\` - Live API templates
 - \`ema://catalog/agents-summary\` - Available agents for workflow composition
 
 ### Step 2: Read Validation Rules (Resources)
@@ -1056,16 +1071,18 @@ Using the templates from Step 1 and guidance from Steps 3-4, generate:
 **Folder structure:**
 \`\`\`
 ${args.name.toLowerCase().replace(/\s+/g, "-")}/
-├── README.md              # Deployment guide (based on ema://templates/voice-ai/readme)
-├── workflow-prompt.md     # Auto Builder prompt (based on ema://templates/voice-ai/workflow-prompt)
-├── persona-config.json    # Voice settings (based on ema://templates/voice-ai/config)
+├── README.md              # Deployment guide
+├── workflow-prompt.md     # Auto Builder prompt
+├── persona-config.json    # Voice settings (from template(config="voice"))
 └── proto-config.json      # Full API config
 \`\`\`
 
+**IMPORTANT**: Only use non-deprecated actions from Step 0.
+
 ### Step 6: Validate
 Call \`reference(validate_prompt=<generated_prompt>)\` to verify the prompt.
 
-Now begin by reading the resources, then proceed with generation.`,
+Now begin by reading the deprecated actions, then proceed with generation.`,
                 },
             },
         ],
@@ -1108,10 +1125,19 @@ ${args.data_sources ? `**Data Sources**: ${args.data_sources}` : ""}
 
 ## Instructions
 
-### Step 1: Read Templates (Resources)
-Read these resources to get templates and reference data:
-- \`ema://templates/chat-ai/config\` - Chat AI persona configuration template
-- \`ema://templates/chat-ai/readme\` - Deployment guide template
+### Step 0: Check Deprecated Actions (DO THIS FIRST)
+Fetch \`ema://rules/deprecated-actions-summary\` to know which actions to AVOID.
+
+**Key deprecated actions to avoid:**
+- search/v0 → use search/v2 (requires datastore_configs)
+- respond_with_sources → use respond_for_external_actions
+- call_llm/v0 → use call_llm/v2
+- web_search/v0 → use live_web_search or ai_web_search
+
+### Step 1: Get Templates
+Get templates from API or use generated fallbacks:
+- \`template(config="chat")\` - Chat AI persona configuration (API-first with fallback)
+- \`ema://catalog/persona-templates\` - Live API templates
 - \`ema://catalog/agents-summary\` - Available agents for workflow composition
 - \`ema://catalog/patterns\` - Common workflow patterns
 
@@ -1131,12 +1157,14 @@ Call \`reference(guidance="conversation-vs-query")\` to understand:
 ### Step 5: Generate Output
 Using the templates from Step 1 and guidance from Steps 3-4, generate:
 
+**IMPORTANT**: Only use non-deprecated actions from Step 0.
+
 **Folder structure:**
 \`\`\`
 ${args.name.toLowerCase().replace(/\s+/g, "-")}/
-├── README.md              # Deployment guide (based on ema://templates/chat-ai/readme)
+├── README.md              # Deployment guide
 ├── workflow-prompt.md     # Auto Builder prompt
-├── persona-config.json    # Chat settings (based on ema://templates/chat-ai/config)
+├── persona-config.json    # Chat settings (from template(config="chat"))
 └── docs/                  # Knowledge base documents
     └── _metadata.json
 \`\`\`
@@ -1184,6 +1212,16 @@ Now begin by reading the resources, then proceed with generation.`,
 **Type**: ${args.type}
 **Description**: ${args.description}
 
+## Step 0: Check Deprecated Actions (DO THIS FIRST)
+
+Fetch \`ema://rules/deprecated-actions-summary\` to see which actions to AVOID.
+
+Common deprecated actions:
+- search/v0 → use search/v2 (requires datastore_configs)
+- respond_with_sources → use respond_for_external_actions
+- call_llm/v0 → use call_llm/v2
+- web_search/v0 → use live_web_search or ai_web_search
+
 ## Step 1: Preview the workflow
 
 \`\`\`
@@ -1194,6 +1232,7 @@ workflow(
 \`\`\`
 
 This returns workflow_def and proto_config. Review them before deploying.
+**Check for any deprecated actions in the generated workflow.**
 
 ## Step 2: Deploy when ready
 
@@ -1350,8 +1389,7 @@ ${args.workflow_def ? `**Workflow Definition**: Provided inline` : ""}
 ${args.persona_id ? `First, fetch the workflow:
 \`persona(id="${args.persona_id}", include_workflow=true, env="${args.env || "demo"}")\`
 
-Then analyze it using:
-\`workflow(persona_id="${args.persona_id}", mode="analyze", env="${args.env || "demo"}")\`
+Then review the workflow_def for issues (missing WORKFLOW_OUTPUT, type mismatches, etc.).
 ` : ""}
 
 ## Required Analysis Sections
@@ -1507,10 +1545,11 @@ Proceed to Phase 1.
 
 ### Step 1.1: Fetch and Analyze
 \`\`\`
-persona(id="${args.persona_id}", include_workflow=true, env="${args.env || "demo"}")
-workflow(persona_id="${args.persona_id}", mode="analyze", env="${args.env || "demo"}")
+workflow(mode="get", persona_id="${args.persona_id}", env="${args.env || "demo"}")
 \`\`\`
 
+Review the workflow_def for issues (missing WORKFLOW_OUTPUT, type mismatches, orphan nodes).
+
 ### Step 1.2: Document Existing Logic
 Before making changes, document:
 - **Current intents**: List all categories and their handlers
@@ -1612,8 +1651,8 @@ workflow(
 
 ## Phase 4: Validate & Deploy
 
-### Step 4.1: Analyze Changes
-\`workflow(persona_id="${args.persona_id}", mode="analyze")\`
+### Step 4.1: Review Changes
+\`workflow(mode="get", persona_id="${args.persona_id}")\` and verify the workflow_def is correct.
 
 Verify:
 - [ ] No type mismatches
@@ -1710,10 +1749,11 @@ Provide:
 ## Step 1: Fetch Workflow Data
 
 \`\`\`
-persona(id="${args.persona_id}", include_workflow=true, env="${args.env || "demo"}")
-workflow(persona_id="${args.persona_id}", mode="analyze", env="${args.env || "demo"}")
+workflow(mode="get", persona_id="${args.persona_id}", env="${args.env || "demo"}")
 \`\`\`
 
+Review the workflow_def for issues (missing WORKFLOW_OUTPUT, type mismatches, orphan nodes).
+
 ## Step 2: Intent Analysis Framework
 
 ### Business Intent Layer