@ema.co/mcp-toolkit 1.5.1 → 1.6.0

package/dist/mcp/prompts.js

@@ -1147,12 +1147,12 @@ Now begin by reading the resources, then proceed with generation.`,
         ],
     },
     // ─────────────────────────────────────────────────────────────────────────
-    // Direct Workflow Generation (Bypasses Auto Builder)
+    // Direct Workflow Generation
     // ─────────────────────────────────────────────────────────────────────────
     workflow_generate: {
         definition: {
             name: "workflow_generate",
-            description: "Generate a complete workflow_def and proto_config directly, bypassing Auto Builder. Produces ready-to-deploy JSON configurations.",
+            description: "Generate an AI Employee workflow. Preview first, then deploy when ready.",
             arguments: [
                 {
                     name: "name",
@@ -1161,29 +1161,14 @@ Now begin by reading the resources, then proceed with generation.`,
                 },
                 {
                     name: "description",
-                    description: "What the AI Employee does",
+                    description: "What the AI Employee does (be detailed about capabilities, intents, data sources)",
                     required: true,
                 },
                 {
-                    name: "persona_type",
+                    name: "type",
                     description: "Type: 'voice', 'chat', or 'dashboard'",
                     required: true,
                 },
-                {
-                    name: "pattern",
-                    description: "Workflow pattern: 'kb_search' (FAQ/docs), 'intent_routing' (multi-intent), 'tool_calling' (external actions)",
-                    required: true,
-                },
-                {
-                    name: "intents",
-                    description: "For intent_routing: comma-separated intent names with handler type, e.g., 'Search:search,Help:llm,Transfer:fixed'",
-                    required: false,
-                },
-                {
-                    name: "tools",
-                    description: "For tool_calling: comma-separated tool names with namespace, e.g., 'Create_Ticket:service_now,Send_Email:outlook'",
-                    required: false,
-                },
             ],
         },
         render: (args) => [
@@ -1191,59 +1176,45 @@ Now begin by reading the resources, then proceed with generation.`,
                 role: "user",
                 content: {
                     type: "text",
-                    text: `Generate a complete workflow configuration for: ${args.name}
+                    text: `Generate AI Employee: ${args.name}
 
+**Type**: ${args.type}
 **Description**: ${args.description}
-**Persona Type**: ${args.persona_type}
-**Pattern**: ${args.pattern}
-${args.intents ? `**Intents**: ${args.intents}` : ""}
-${args.tools ? `**Tools**: ${args.tools}` : ""}
-
-## Instructions
-
-Generate deployment-ready JSON using the consolidated \`workflow\` tool (local compiler):
 
-### Step 1: Generate workflow_def + proto_config (Direct / Deterministic)
-Call:
-\`workflow(input=<requirements>, type="${args.persona_type}", use_autobuilder=false)\`
+## Step 1: Preview the workflow
 
-Where \`<requirements>\` includes:
-- Name: ${args.name}
-- Description: ${args.description}
-- Pattern hint: ${args.pattern}
-${args.intents ? `- Intents: ${args.intents}` : ""}
-${args.tools ? `- Tools: ${args.tools}` : ""}
-
-**HITL Policy**: DEFAULT is no approval gates. Only add HITL if user explicitly requests approval/confirmation before external actions.
-
-If the tool returns \`status="needs_input"\`, ask the missing questions, then call \`workflow(...)\` again with the additional details.
-
-### Step 2: (Optional) Validate the generated workflow
-Call \`workflow(mode="analyze", workflow_def=<workflow_def>)\` and fix any critical issues before deploying.
+\`\`\`
+workflow(
+  input="${args.description}",
+  type="${args.type}"
+)
+\`\`\`
 
-### Step 3: Deploy (Optional)
-If you already have a persona, deploy directly:
-\`workflow(mode="deploy", persona_id="<persona_id>", workflow_def=<workflow_def>, proto_config=<proto_config>)\`
+This returns workflow_def and proto_config. Review them before deploying.
 
-If you need to create one first:
-\`persona(mode="create", name="${args.name}", type="${args.persona_type}")\`
-then deploy as above.
+## Step 2: Deploy when ready
 
-## Output Format
+\`\`\`
+workflow(
+  input="${args.description}",
+  name="${args.name}",
+  type="${args.type}",
+  preview=false
+)
+\`\`\`
 
-Provide the final configurations in this format:
+This creates the persona and deploys the workflow in one step.
 
-\`\`\`json
-// workflow_def.json
-{workflow_def}
-\`\`\`
+${args.type === "voice" ? `
+## Voice AI Notes
 
-\`\`\`json
-// proto_config.json
-{proto_config}
-\`\`\`
+The generated proto_config includes voice settings:
+- welcomeMessage: Generated greeting
+- identityAndPurpose: Generated from description
+- takeActionInstructions, hangupInstructions: Sensible defaults
 
-Now generate by calling \`workflow(input=<requirements>, type="${args.persona_type}", use_autobuilder=false)\`.`,
+These are set automatically but can be customized via proto_config override.
+` : ""}`,
                 },
             },
         ],
@@ -1251,7 +1222,7 @@ Now generate by calling \`workflow(input=<requirements>, type="${args.persona_ty
     workflow_deploy: {
         definition: {
             name: "workflow_deploy",
-            description: "Deploy a generated workflow to an Ema environment. Takes workflow_def and proto_config and creates/updates an AI Employee.",
+            description: "Create a new AI Employee from template with configured settings, or modify an existing one.",
             arguments: [
                 {
                     name: "name",
@@ -1259,13 +1230,18 @@ Now generate by calling \`workflow(input=<requirements>, type="${args.persona_ty
                     required: true,
                 },
                 {
-                    name: "env",
-                    description: "Target environment (default: demo)",
-                    required: false,
+                    name: "type",
+                    description: "Type: voice, chat, or dashboard",
+                    required: true,
+                },
+                {
+                    name: "description",
+                    description: "What this AI Employee does",
+                    required: true,
                 },
                 {
-                    name: "update_existing",
-                    description: "If 'true', update existing AI Employee with same name instead of creating new",
+                    name: "env",
+                    description: "Target environment (default: demo)",
                     required: false,
                 },
             ],
@@ -1275,70 +1251,51 @@ Now generate by calling \`workflow(input=<requirements>, type="${args.persona_ty
                 role: "user",
                 content: {
                     type: "text",
-                    text: `Deploy workflow configuration for: ${args.name}
-
-**Target Environment**: ${args.env || "demo"}
-**Update Existing**: ${args.update_existing === "true" ? "Yes" : "No (create new)"}
-
-## Instructions
-
-### Pre-Deploy Checklist
-
-Before deploying, ensure you have:
-1. ✅ Generated workflow_def using workflow_generate prompt
-2. ✅ Generated proto_config/persona settings
-3. ✅ Validated the workflow (no critical issues)
-
-### Step 1: Check for Existing
+                    text: `Create AI Employee: ${args.name}
 
-${args.update_existing === "true" ? `
-Call \`persona(id="${args.name}", env="${args.env || "demo"}")\`
-to find the existing AI Employee (and capture its persona ID).
-` : `
-Call \`persona(query="${args.name}", env="${args.env || "demo"}")\`
-to check whether an AI Employee with this name already exists (and capture the persona ID if present).
-`}
-
-### Step 2: Create or Update
-
-${args.update_existing === "true" ? `
-If not found, create it:
-\`persona(mode="create", name="${args.name}", type="chat", env="${args.env || "demo"}")\`
-` : `
-Create a new AI Employee:
-\`persona(mode="create", name="${args.name}", type="chat", env="${args.env || "demo"}")\`
-`}
-
-### Step 3: Configure Workflow
-
-Deploy the workflow via MCP:
-\`workflow(mode="deploy", persona_id="<persona_id>", workflow_def=<workflow_def>, proto_config=<proto_config>, env="${args.env || "demo"}")\`
+**Type**: ${args.type || "chat"}
+**Environment**: ${args.env || "demo"}
+**Description**: ${args.description}
 
-### Step 4: Test
+## How It Works
 
-After deployment:
-1. Open the AI Employee in simulator
-2. Test each intent/path
-3. Verify responses are correct
-4. Check HITL flows work (if applicable)
+**Greenfield** (new personas): Creates from template, configures settings.
+- Template provides valid workflow structure
+- We configure proto_config (voice settings, welcome message, etc.)
+- Customize workflow AFTER creation via modify mode
 
-### Step 5: Activate
+**Brownfield** (existing personas): Uses LLM-native transformation.
+- Fetches existing workflow
+- Decompiles to WorkflowSpec
+- Transforms based on your input
+- Compiles back and deploys
 
-Once tested:
-1. Call \`persona(id="<persona_id>", mode="update", enabled=true, env="${args.env || "demo"}")\`
-2. Monitor initial conversations
-3. Iterate based on feedback
+## Create New Persona
 
-## Deployment Summary
+\`\`\`
+workflow(
+  input="${args.description}",
+  name="${args.name}",
+  type="${args.type || "chat"}",
+  preview=false,
+  env="${args.env || "demo"}"
+)
+\`\`\`
 
-Provide a deployment summary including:
-- AI Employee ID (if created/updated)
-- Environment
-- Workflow configuration details
-- Test results
-- Next steps
+This creates the persona from template and configures settings.
+${args.type === "voice" ? `
+For Voice AI, this sets:
+- welcomeMessage (generated greeting)
+- identityAndPurpose (from your description)
+- hangupInstructions, speechCharacteristics (defaults)
+` : ""}
+## After Creation
 
-Now proceed with deployment.`,
+1. Get persona_id from response
+2. Verify: \`persona(id="<persona_id>", include_workflow=true)\`
+3. Customize workflow: \`workflow(persona_id="<id>", input="add search node")\`
+4. Test in Ema simulator
+5. Enable: \`persona(id="<id>", mode="update", enabled=true)\``,
                 },
             },
         ],