@ema.co/mcp-toolkit 1.5.1 → 1.6.0

package/dist/sdk/demo-generator.js

@@ -0,0 +1,978 @@
+/**
+ * Demo Kit Generator
+ *
+ * Generates comprehensive demo data packages for AI Employees that ensure
+ * reliable demos through:
+ * - Guaranteed RAG search hits with pre-loaded KB documents
+ * - Complete mock datasets tailored to the persona's workflow
+ * - Fixed response fallbacks for critical demo questions
+ * - Validation queries to verify demo readiness
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// Built-in Scenarios
+// ─────────────────────────────────────────────────────────────────────────────
+export const DEMO_SCENARIOS = {
+    "sales-sdr": {
+        id: "sales-sdr",
+        name: "Sales Development Representative",
+        description: "SDR demo for qualifying leads, booking meetings, handling objections",
+        persona_types: ["voice", "chat"],
+        tags: ["sales", "sdr", "lead-qualification", "booking"],
+        intents: [
+            {
+                name: "company_info",
+                description: "Questions about the company/product being sold",
+                example_questions: ["What does your company do?", "Tell me about your product"],
+            },
+            {
+                name: "pricing",
+                description: "Pricing and package questions",
+                example_questions: ["How much does it cost?", "What are your pricing plans?"],
+            },
+            {
+                name: "book_meeting",
+                description: "Request to schedule a demo or meeting",
+                example_questions: ["Can I schedule a demo?", "I'd like to talk to sales"],
+            },
+            {
+                name: "objection_handling",
+                description: "Common sales objections",
+                example_questions: ["We're happy with our current solution", "It's too expensive"],
+            },
+            {
+                name: "qualification",
+                description: "Qualifying questions about the prospect",
+                example_questions: ["What's your current setup?", "How many users do you have?"],
+            },
+        ],
+        entities: [
+            {
+                type: "company",
+                count: 3,
+                template: {
+                    name: "{{company_name}}",
+                    industry: "{{industry}}",
+                    size: "{{size}}",
+                    pain_points: ["{{pain_point_1}}", "{{pain_point_2}}"],
+                },
+            },
+            {
+                type: "product",
+                count: 2,
+                template: {
+                    name: "{{product_name}}",
+                    description: "{{description}}",
+                    pricing: { starter: 99, pro: 299, enterprise: "custom" },
+                    features: ["{{feature_1}}", "{{feature_2}}", "{{feature_3}}"],
+                },
+            },
+        ],
+        qa_pairs: [
+            {
+                phase: "intro",
+                question: "Hi, I saw your website and I'm curious about what you do.",
+                answer_template: "Thanks for reaching out! We help companies like yours {{value_prop}}. I'd love to learn more about your needs - what challenges are you currently facing with {{pain_area}}?",
+                intent: "company_info",
+            },
+            {
+                phase: "main",
+                question: "How much does it cost?",
+                answer_template: "Great question! Our pricing starts at $99/month for our Starter plan, which includes {{starter_features}}. Most companies like yours go with our Pro plan at $299/month. Would you like me to walk you through what's included?",
+                intent: "pricing",
+            },
+            {
+                phase: "main",
+                question: "Can I see a demo?",
+                answer_template: "Absolutely! I'd be happy to set that up. Our product specialists can give you a personalized walkthrough. What day works best for you this week - would Tuesday or Thursday afternoon work?",
+                intent: "book_meeting",
+            },
+            {
+                phase: "advanced",
+                question: "We're already using a competitor product.",
+                answer_template: "I hear that a lot, and it's actually why many of our best customers switched to us. What they found was {{differentiator}}. Out of curiosity, what do you wish was better about your current solution?",
+                intent: "objection_handling",
+            },
+            {
+                phase: "closing",
+                question: "Send me some information.",
+                answer_template: "Of course! I'll send over a summary of what we discussed along with a link to schedule that demo whenever you're ready. What email should I send that to?",
+                intent: "book_meeting",
+            },
+        ],
+    },
+    "support-tier1": {
+        id: "support-tier1",
+        name: "Tier 1 Support Agent",
+        description: "Customer support demo handling tickets, FAQs, and escalations",
+        persona_types: ["voice", "chat"],
+        tags: ["support", "customer-service", "helpdesk", "tickets"],
+        intents: [
+            {
+                name: "account_lookup",
+                description: "Look up customer account information",
+                example_questions: ["What's my account status?", "Can you pull up my account?"],
+            },
+            {
+                name: "troubleshooting",
+                description: "Technical troubleshooting",
+                example_questions: ["It's not working", "I'm getting an error"],
+            },
+            {
+                name: "billing",
+                description: "Billing and payment questions",
+                example_questions: ["Why was I charged?", "Can I get a refund?"],
+            },
+            {
+                name: "escalation",
+                description: "Request for manager or escalation",
+                example_questions: ["I want to speak to a manager", "This needs to be escalated"],
+            },
+            {
+                name: "how_to",
+                description: "How-to questions",
+                example_questions: ["How do I reset my password?", "How do I change my plan?"],
+            },
+        ],
+        entities: [
+            {
+                type: "customer",
+                count: 3,
+                template: {
+                    id: "CUST-{{id}}",
+                    name: "{{name}}",
+                    email: "{{email}}",
+                    plan: "{{plan}}",
+                    status: "active",
+                    since: "{{date}}",
+                },
+            },
+            {
+                type: "faq",
+                count: 5,
+                template: {
+                    question: "{{question}}",
+                    answer: "{{answer}}",
+                    category: "{{category}}",
+                },
+            },
+            {
+                type: "ticket",
+                count: 2,
+                template: {
+                    id: "TKT-{{id}}",
+                    subject: "{{subject}}",
+                    status: "{{status}}",
+                    priority: "{{priority}}",
+                },
+            },
+        ],
+        qa_pairs: [
+            {
+                phase: "intro",
+                question: "Hi, I need help with my account.",
+                answer_template: "Of course, I'd be happy to help! To pull up your account, could you please provide your email address or account number?",
+                intent: "account_lookup",
+            },
+            {
+                phase: "main",
+                question: "How do I reset my password?",
+                answer_template: "I can help you with that! Here's how to reset your password:\n1. Go to the login page\n2. Click 'Forgot Password'\n3. Enter your email address\n4. Check your inbox for the reset link\n\nThe link expires in 24 hours. Would you like me to send you a reset email right now?",
+                intent: "how_to",
+                required_entity_type: "faq",
+            },
+            {
+                phase: "main",
+                question: "I'm getting an error when I try to login.",
+                answer_template: "I'm sorry you're experiencing that! Let me help you troubleshoot. First, could you tell me:\n1. What error message are you seeing?\n2. Are you using the web app or mobile app?\n\nIn the meantime, try clearing your browser cache and cookies, which often resolves login issues.",
+                intent: "troubleshooting",
+            },
+            {
+                phase: "advanced",
+                question: "I want a refund, this product doesn't work.",
+                answer_template: "I understand your frustration, and I'm sorry the product isn't meeting your expectations. Let me look into your account to see what options we have. Before we discuss a refund, would you mind if I tried to resolve the issue you're experiencing? Often we can fix things quickly.",
+                intent: "billing",
+            },
+            {
+                phase: "closing",
+                question: "Thanks, that's all I needed.",
+                answer_template: "You're welcome! I'm glad I could help. Is there anything else I can assist you with today? If you have any other questions later, don't hesitate to reach out. Have a great day!",
+            },
+        ],
+    },
+    "hr-assistant": {
+        id: "hr-assistant",
+        name: "HR Assistant",
+        description: "HR demo for policies, benefits, time-off requests",
+        persona_types: ["chat", "voice"],
+        tags: ["hr", "human-resources", "benefits", "policies"],
+        intents: [
+            {
+                name: "time_off",
+                description: "PTO and time-off requests",
+                example_questions: ["How do I request time off?", "What's my PTO balance?"],
+            },
+            {
+                name: "benefits",
+                description: "Benefits and insurance questions",
+                example_questions: ["What benefits do we have?", "How do I add a dependent?"],
+            },
+            {
+                name: "policies",
+                description: "Company policy questions",
+                example_questions: ["What's the remote work policy?", "What's the dress code?"],
+            },
+            {
+                name: "payroll",
+                description: "Payroll and compensation",
+                example_questions: ["When is payday?", "How do I update my direct deposit?"],
+            },
+            {
+                name: "onboarding",
+                description: "New employee questions",
+                example_questions: ["What do I need to complete for onboarding?", "Where do I get my badge?"],
+            },
+        ],
+        entities: [
+            {
+                type: "policy",
+                count: 5,
+                template: {
+                    name: "{{policy_name}}",
+                    category: "{{category}}",
+                    summary: "{{summary}}",
+                    details: "{{details}}",
+                    last_updated: "{{date}}",
+                },
+            },
+            {
+                type: "benefit",
+                count: 3,
+                template: {
+                    name: "{{benefit_name}}",
+                    description: "{{description}}",
+                    eligibility: "{{eligibility}}",
+                    enrollment: "{{enrollment_info}}",
+                },
+            },
+            {
+                type: "employee",
+                count: 2,
+                template: {
+                    id: "EMP-{{id}}",
+                    name: "{{name}}",
+                    department: "{{department}}",
+                    pto_balance: "{{pto_days}} days",
+                    start_date: "{{date}}",
+                },
+            },
+        ],
+        qa_pairs: [
+            {
+                phase: "intro",
+                question: "Hi, I have a question about my benefits.",
+                answer_template: "Hi! I'd be happy to help with your benefits questions. We offer comprehensive health, dental, and vision insurance, plus a 401(k) with company match. What specific benefit would you like to know more about?",
+                intent: "benefits",
+            },
+            {
+                phase: "main",
+                question: "How do I request time off?",
+                answer_template: "To request time off:\n1. Log into the HR portal\n2. Click 'Time Off' in the menu\n3. Select your dates and type (PTO, sick, etc.)\n4. Add a note if needed and submit\n\nYour manager will receive an automatic notification. You currently have {{pto_balance}} PTO days available. Would you like me to help you check your balance?",
+                intent: "time_off",
+                required_entity_type: "employee",
+            },
+            {
+                phase: "main",
+                question: "What's the work from home policy?",
+                answer_template: "Our hybrid work policy allows employees to work remotely up to 3 days per week, with at least 2 days in the office for collaboration. You'll need to coordinate with your manager on which days. All remote work requires a stable internet connection and appropriate workspace. Is there a specific aspect of the policy you'd like more details on?",
+                intent: "policies",
+                required_entity_type: "policy",
+            },
+            {
+                phase: "advanced",
+                question: "How do I add my spouse to my health insurance?",
+                answer_template: "Great question! You can add your spouse during open enrollment (November 1-15) or within 30 days of a qualifying life event like marriage. To add them:\n1. Go to the Benefits portal\n2. Click 'Life Events'\n3. Select 'Marriage' and upload your marriage certificate\n4. Choose the plan that covers your spouse\n\nWould you like me to send you the direct link to get started?",
+                intent: "benefits",
+            },
+            {
+                phase: "closing",
+                question: "Where can I find all the HR forms?",
+                answer_template: "All HR forms are available in the HR portal under 'Resources > Forms'. The most commonly used ones include:\n- Direct deposit change form\n- W-4 updates\n- Benefits enrollment\n- Time off requests\n\nIs there a specific form you're looking for? I can send you a direct link.",
+                intent: "policies",
+            },
+        ],
+    },
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Sample Entity Data
+// ─────────────────────────────────────────────────────────────────────────────
+export const SAMPLE_ENTITIES = {
+    company: [
+        {
+            name: "Acme Corporation",
+            industry: "Manufacturing",
+            size: "500-1000 employees",
+            annual_revenue: "$50M",
+            headquarters: "Chicago, IL",
+            pain_points: ["Manual processes", "Scaling challenges", "Data silos"],
+            current_solution: "Spreadsheets and legacy software",
+        },
+        {
+            name: "TechStart Inc",
+            industry: "Technology",
+            size: "50-100 employees",
+            annual_revenue: "$5M",
+            headquarters: "San Francisco, CA",
+            pain_points: ["Fast growth", "Hiring challenges", "Process automation"],
+            current_solution: "Multiple point solutions",
+        },
+        {
+            name: "Global Retail Co",
+            industry: "Retail",
+            size: "5000+ employees",
+            annual_revenue: "$500M",
+            headquarters: "New York, NY",
+            pain_points: ["Inventory management", "Customer experience", "Omnichannel"],
+            current_solution: "Enterprise legacy system",
+        },
+    ],
+    product: [
+        {
+            name: "Enterprise Suite Pro",
+            sku: "ESP-001",
+            description: "All-in-one enterprise solution for growing businesses",
+            pricing: {
+                starter: { price: 99, features: ["5 users", "Basic support", "Core features"] },
+                pro: { price: 299, features: ["25 users", "Priority support", "Advanced features", "API access"] },
+                enterprise: { price: "Custom", features: ["Unlimited users", "24/7 support", "Custom integrations", "Dedicated CSM"] },
+            },
+            differentiators: ["AI-powered automation", "Single platform", "60% faster implementation"],
+        },
+        {
+            name: "Quick Start Bundle",
+            sku: "QSB-001",
+            description: "Perfect for small teams getting started",
+            pricing: {
+                monthly: 49,
+                annual: 470,
+            },
+            features: ["3 users", "Email support", "Essential features"],
+        },
+    ],
+    customer: [
+        {
+            id: "CUST-001",
+            name: "John Smith",
+            email: "john.smith@example.com",
+            plan: "Pro",
+            status: "active",
+            since: "2023-06-15",
+            lifetime_value: "$3,500",
+            tickets_opened: 2,
+            last_contact: "2024-01-10",
+        },
+        {
+            id: "CUST-002",
+            name: "Sarah Johnson",
+            email: "sarah.j@company.com",
+            plan: "Enterprise",
+            status: "active",
+            since: "2022-03-01",
+            lifetime_value: "$45,000",
+            tickets_opened: 5,
+            last_contact: "2024-01-15",
+        },
+        {
+            id: "CUST-003",
+            name: "Demo User",
+            email: "demo@example.com",
+            plan: "Starter",
+            status: "active",
+            since: "2024-01-01",
+            lifetime_value: "$297",
+            tickets_opened: 0,
+            last_contact: "2024-01-20",
+        },
+    ],
+    faq: [
+        {
+            id: "FAQ-001",
+            question: "How do I reset my password?",
+            answer: "To reset your password: 1) Go to the login page, 2) Click 'Forgot Password', 3) Enter your email, 4) Check your inbox for the reset link (expires in 24 hours), 5) Click the link and create a new password.",
+            category: "Account",
+        },
+        {
+            id: "FAQ-002",
+            question: "What payment methods do you accept?",
+            answer: "We accept all major credit cards (Visa, MasterCard, American Express), PayPal, and bank transfers for annual Enterprise plans. All payments are processed securely through Stripe.",
+            category: "Billing",
+        },
+        {
+            id: "FAQ-003",
+            question: "How do I cancel my subscription?",
+            answer: "You can cancel anytime from Settings > Subscription > Cancel Plan. Your access continues until the end of your billing period. We also offer a pause option if you need a temporary break.",
+            category: "Billing",
+        },
+        {
+            id: "FAQ-004",
+            question: "Is my data secure?",
+            answer: "Yes! We use bank-level encryption (AES-256), are SOC 2 Type II certified, GDPR compliant, and never share your data with third parties. Your data is backed up daily across multiple secure locations.",
+            category: "Security",
+        },
+        {
+            id: "FAQ-005",
+            question: "Do you offer a free trial?",
+            answer: "Yes! We offer a 14-day free trial with full access to all Pro features. No credit card required to start. You can upgrade, downgrade, or cancel anytime during or after the trial.",
+            category: "Pricing",
+        },
+    ],
+    policy: [
+        {
+            id: "POL-001",
+            name: "Remote Work Policy",
+            category: "Workplace",
+            summary: "Hybrid work with up to 3 remote days per week",
+            details: "Employees may work remotely up to 3 days per week with manager approval. Core collaboration hours are 10am-3pm in your local timezone. Equipment and internet stipend available.",
+            last_updated: "2024-01-01",
+        },
+        {
+            id: "POL-002",
+            name: "PTO Policy",
+            category: "Time Off",
+            summary: "Unlimited PTO with 2-week notice for extended leave",
+            details: "We offer unlimited PTO. For time off over 5 consecutive days, please provide 2 weeks notice. All PTO must be approved by your manager. Company holidays do not count against PTO.",
+            last_updated: "2024-01-01",
+        },
+        {
+            id: "POL-003",
+            name: "Expense Reimbursement",
+            category: "Finance",
+            summary: "Submit expenses within 30 days for reimbursement",
+            details: "Business expenses must be pre-approved for amounts over $100. Submit receipts via the expense portal within 30 days. Reimbursements are processed bi-weekly.",
+            last_updated: "2023-11-15",
+        },
+    ],
+    employee: [
+        {
+            id: "EMP-001",
+            name: "Alex Demo",
+            email: "alex.demo@company.com",
+            department: "Engineering",
+            title: "Software Engineer",
+            start_date: "2023-01-15",
+            pto_balance: 15,
+            manager: "Jane Manager",
+        },
+        {
+            id: "EMP-002",
+            name: "Sam Sample",
+            email: "sam.sample@company.com",
+            department: "Sales",
+            title: "Account Executive",
+            start_date: "2022-06-01",
+            pto_balance: 12,
+            manager: "Bob Director",
+        },
+    ],
+    benefit: [
+        {
+            id: "BEN-001",
+            name: "Health Insurance",
+            description: "Comprehensive medical, dental, and vision coverage",
+            eligibility: "Full-time employees from day 1",
+            provider: "Blue Cross Blue Shield",
+            employee_cost: "$150/month for individual, $400/month for family",
+            company_contribution: "80% of premium",
+        },
+        {
+            id: "BEN-002",
+            name: "401(k) Retirement",
+            description: "401(k) plan with company match",
+            eligibility: "After 90 days of employment",
+            match: "100% match up to 4% of salary",
+            vesting: "Immediate vesting on all contributions",
+        },
+        {
+            id: "BEN-003",
+            name: "Professional Development",
+            description: "Annual learning and development budget",
+            eligibility: "All full-time employees",
+            amount: "$1,500/year",
+            covers: "Courses, conferences, certifications, books",
+        },
+    ],
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Generator Functions
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Analyze a workflow to detect demo requirements
+ */
+export function analyzeWorkflowForDemo(workflowDef) {
+    const actions = (workflowDef.actions || []);
+    const intents = [];
+    const entityTypes = new Set();
+    let hasSearch = false;
+    let hasEmail = false;
+    let hasHitl = false;
+    let triggerType = "chat";
+    for (const action of actions) {
+        const actionDef = action.action;
+        const name = actionDef?.name?.name || "";
+        // Detect trigger type
+        if (name.includes("voice_trigger"))
+            triggerType = "voice";
+        if (name.includes("document_trigger"))
+            triggerType = "document";
+        // Detect search nodes
+        if (name === "search" || name.includes("search"))
+            hasSearch = true;
+        // Detect email nodes
+        if (name === "send_email_agent" || name.includes("email"))
+            hasEmail = true;
+        // Detect HITL nodes
+        if (name === "general_hitl" || name.includes("hitl"))
+            hasHitl = true;
+        // Extract intents from categorizer
+        if (name.includes("categorizer")) {
+            const typeArgs = action.typeArguments;
+            const enumType = typeArgs?.categories;
+            // Try to find enum definition
+            const enumTypes = (workflowDef.enumTypes || []);
+            for (const et of enumTypes) {
+                const options = (et.options || []);
+                for (const opt of options) {
+                    if (opt.name && opt.name !== "Fallback") {
+                        intents.push(opt.name);
+                    }
+                }
+            }
+        }
+        // Detect entity extraction
+        if (name.includes("entity_extraction")) {
+            entityTypes.add("customer"); // Common entity type
+        }
+    }
+    // Default entity types based on workflow characteristics
+    if (hasSearch) {
+        entityTypes.add("faq");
+    }
+    return {
+        intents,
+        required_entity_types: Array.from(entityTypes),
+        has_search: hasSearch,
+        has_email: hasEmail,
+        has_hitl: hasHitl,
+        trigger_type: triggerType,
+    };
+}
+/**
+ * Generate a demo document for a specific entity
+ */
+export function generateDemoDocument(entityType, entityData, supportedQuestions = []) {
+    const id = (entityData.id || entityData.name || "unknown");
+    const name = (entityData.name || entityData.question || id);
+    let content = "";
+    const tags = [entityType];
+    switch (entityType) {
+        case "customer":
+            content = generateCustomerDocument(entityData);
+            if (entityData.plan)
+                tags.push(String(entityData.plan));
+            if (entityData.status)
+                tags.push(String(entityData.status));
+            break;
+        case "product":
+            content = generateProductDocument(entityData);
+            if (entityData.sku)
+                tags.push(String(entityData.sku));
+            break;
+        case "faq":
+            content = generateFaqDocument(entityData);
+            if (entityData.category)
+                tags.push(String(entityData.category));
+            break;
+        case "policy":
+            content = generatePolicyDocument(entityData);
+            if (entityData.category)
+                tags.push(String(entityData.category));
+            break;
+        case "employee":
+            content = generateEmployeeDocument(entityData);
+            if (entityData.department)
+                tags.push(String(entityData.department));
+            break;
+        case "benefit":
+            content = generateBenefitDocument(entityData);
+            break;
+        case "company":
+            content = generateCompanyDocument(entityData);
+            if (entityData.industry)
+                tags.push(String(entityData.industry));
+            break;
+        default:
+            content = generateGenericDocument(entityType, entityData);
+    }
+    return {
+        filename: `${entityType}-${id.toLowerCase().replace(/[^a-z0-9]/g, "-")}.md`,
+        title: name,
+        entity_type: entityType,
+        content,
+        tags,
+        supports_questions: supportedQuestions,
+    };
+}
+function generateCustomerDocument(data) {
+    return `# Customer: ${data.name}
+
+## Metadata
+<!-- ema_entity: customer -->
+<!-- ema_id: ${data.id} -->
+<!-- ema_tags: ${data.plan || "standard"}, ${data.status || "active"} -->
+
+## Account Overview
+| Field | Value |
+|-------|-------|
+| Customer ID | ${data.id} |
+| Name | ${data.name} |
+| Email | ${data.email} |
+| Plan | ${data.plan} |
+| Status | ${data.status} |
+| Customer Since | ${data.since} |
+
+## Account Details
+- **Lifetime Value**: ${data.lifetime_value || "N/A"}
+- **Support Tickets**: ${data.tickets_opened || 0} opened
+- **Last Contact**: ${data.last_contact || "N/A"}
+
+## Notes
+This customer has been with us since ${data.since}. ${data.plan === "Enterprise" ? "Enterprise customer with dedicated support." : ""}
+`;
+}
+function generateProductDocument(data) {
+    const pricing = data.pricing;
+    let pricingSection = "";
+    if (pricing) {
+        pricingSection = "## Pricing\n";
+        for (const [tier, details] of Object.entries(pricing)) {
+            if (typeof details === "object" && details !== null) {
+                const d = details;
+                pricingSection += `### ${tier.charAt(0).toUpperCase() + tier.slice(1)}\n`;
+                pricingSection += `- **Price**: ${d.price || "Custom"}\n`;
+                if (d.features) {
+                    pricingSection += `- **Features**: ${d.features.join(", ")}\n`;
+                }
+                pricingSection += "\n";
+            }
+        }
+    }
+    return `# Product: ${data.name}
+
+## Metadata
+<!-- ema_entity: product -->
+<!-- ema_id: ${data.sku || data.name} -->
+
+## Overview
+| Field | Value |
+|-------|-------|
+| Name | ${data.name} |
+| SKU | ${data.sku || "N/A"} |
+
+## Description
+${data.description || "No description available."}
+
+${pricingSection}
+
+## Key Differentiators
+${(data.differentiators || []).map((d) => `- ${d}`).join("\n") || "- See product documentation"}
+`;
+}
+function generateFaqDocument(data) {
+    return `# FAQ: ${data.question}
+
+## Metadata
+<!-- ema_entity: faq -->
+<!-- ema_id: ${data.id} -->
+<!-- ema_tags: ${data.category || "general"} -->
+
+## Question
+${data.question}
+
+## Answer
+${data.answer}
+
+## Category
+${data.category || "General"}
+`;
+}
+function generatePolicyDocument(data) {
+    return `# Policy: ${data.name}
+
+## Metadata
+<!-- ema_entity: policy -->
+<!-- ema_id: ${data.id} -->
+<!-- ema_tags: ${data.category || "general"}, policy -->
+
+## Summary
+${data.summary}
+
+## Full Policy
+${data.details}
+
+## Additional Information
+- **Category**: ${data.category}
+- **Last Updated**: ${data.last_updated}
+`;
+}
+function generateEmployeeDocument(data) {
+    return `# Employee: ${data.name}
+
+## Metadata
+<!-- ema_entity: employee -->
+<!-- ema_id: ${data.id} -->
+<!-- ema_tags: ${data.department || "general"} -->
+
+## Profile
+| Field | Value |
+|-------|-------|
+| Employee ID | ${data.id} |
+| Name | ${data.name} |
+| Email | ${data.email} |
+| Department | ${data.department} |
+| Title | ${data.title} |
+| Start Date | ${data.start_date} |
+| Manager | ${data.manager} |
+
+## Time Off
+- **PTO Balance**: ${data.pto_balance} days
+`;
+}
+function generateBenefitDocument(data) {
+    return `# Benefit: ${data.name}
+
+## Metadata
+<!-- ema_entity: benefit -->
+<!-- ema_id: ${data.id} -->
+<!-- ema_tags: benefits, hr -->
+
+## Overview
+${data.description}
+
+## Details
+| Field | Value |
+|-------|-------|
+| Eligibility | ${data.eligibility} |
+${data.provider ? `| Provider | ${data.provider} |` : ""}
+${data.employee_cost ? `| Employee Cost | ${data.employee_cost} |` : ""}
+${data.company_contribution ? `| Company Contribution | ${data.company_contribution} |` : ""}
+${data.match ? `| Company Match | ${data.match} |` : ""}
+${data.amount ? `| Amount | ${data.amount} |` : ""}
+`;
+}
+function generateCompanyDocument(data) {
+    return `# Company: ${data.name}
+
+## Metadata
+<!-- ema_entity: company -->
+<!-- ema_id: ${data.name} -->
+<!-- ema_tags: ${data.industry || "general"}, prospect -->
+
+## Company Overview
+| Field | Value |
+|-------|-------|
+| Company Name | ${data.name} |
+| Industry | ${data.industry} |
+| Size | ${data.size} |
+| Annual Revenue | ${data.annual_revenue || "N/A"} |
+| Headquarters | ${data.headquarters || "N/A"} |
+
+## Pain Points
+${(data.pain_points || []).map((p) => `- ${p}`).join("\n") || "- To be discovered"}
+
+## Current Solution
+${data.current_solution || "Unknown"}
+
+## Notes
+This is a prospective customer in the ${data.industry} industry.
+`;
+}
+function generateGenericDocument(entityType, data) {
+    const fields = Object.entries(data)
+        .filter(([_, v]) => v !== null && v !== undefined && typeof v !== "object")
+        .map(([k, v]) => `| ${k} | ${v} |`)
+        .join("\n");
+    return `# ${entityType}: ${data.name || data.id || "Unknown"}
+
+## Metadata
+<!-- ema_entity: ${entityType} -->
+
+## Details
+| Field | Value |
+|-------|-------|
+${fields}
+`;
+}
+/**
+ * Generate a complete demo kit for a persona
+ */
+export function generateDemoKit(personaId, personaName, workflowDef, scenario, customQA) {
+    const analysis = analyzeWorkflowForDemo(workflowDef);
+    // Generate KB documents
+    const kbDocuments = [];
+    const entityTypesNeeded = new Set([
+        ...analysis.required_entity_types,
+        ...scenario.entities.map((e) => e.type),
+    ]);
+    for (const entityType of entityTypesNeeded) {
+        const samples = SAMPLE_ENTITIES[entityType] || [];
+        for (const sample of samples) {
+            kbDocuments.push(generateDemoDocument(entityType, sample));
+        }
+    }
+    // Generate demo script from scenario Q&A
+    const demoScript = scenario.qa_pairs.map((qa, idx) => ({
+        id: `qa-${idx + 1}`,
+        question: qa.question,
+        expected_answer: qa.answer_template,
+        intent: qa.intent,
+        required_entities: qa.required_entity_type ? [qa.required_entity_type] : undefined,
+        phase: qa.phase,
+        presenter_notes: `Triggers ${qa.intent || "general"} intent`,
+    }));
+    // Add custom Q&A if provided
+    if (customQA) {
+        for (const [idx, qa] of customQA.entries()) {
+            demoScript.push({
+                id: `custom-${idx + 1}`,
+                question: qa.question,
+                expected_answer: qa.answer,
+                phase: "main",
+                presenter_notes: "Custom Q&A pair",
+            });
+        }
+    }
+    // Generate fixed response fallbacks for critical questions
+    const fixedResponses = demoScript
+        .filter((qa) => qa.phase === "intro" || qa.phase === "closing")
+        .map((qa) => ({
+        id: `fallback_${qa.id}`,
+        displayName: `Demo Fallback: ${qa.id}`,
+        template: qa.expected_answer,
+        fallback_for: qa.id,
+    }));
+    // Generate validation queries
+    const validationQueries = demoScript.map((qa) => ({
+        query: qa.question,
+        expect: {
+            intent: qa.intent,
+            contains: extractKeyPhrases(qa.expected_answer),
+        },
+    }));
+    return {
+        persona_id: personaId,
+        persona_name: personaName,
+        scenario: scenario.id,
+        kb_documents: kbDocuments,
+        demo_script: demoScript,
+        fixed_responses: fixedResponses,
+        validation_queries: validationQueries,
+        generated_at: new Date().toISOString(),
+        version: "1.0.0",
+    };
+}
+/**
+ * Extract key phrases from an answer for validation
+ */
+function extractKeyPhrases(answer) {
+    // Extract first 2-3 significant words/phrases
+    const words = answer
+        .replace(/[^\w\s]/g, "")
+        .split(/\s+/)
+        .filter((w) => w.length > 4);
+    return words.slice(0, 3);
+}
+/**
+ * Generate demo script markdown
+ */
+export function generateDemoScriptMarkdown(kit) {
+    const byPhase = {
+        intro: [],
+        main: [],
+        advanced: [],
+        closing: [],
+    };
+    for (const qa of kit.demo_script) {
+        byPhase[qa.phase].push(qa);
+    }
+    let md = `# Demo Script: ${kit.persona_name}
+
+> Generated ${kit.generated_at}
+> Scenario: ${kit.scenario}
+
+## Overview
+- **Total Questions**: ${kit.demo_script.length}
+- **KB Documents**: ${kit.kb_documents.length}
+- **Fallback Responses**: ${kit.fixed_responses.length}
+
+---
+
+`;
+    for (const [phase, questions] of Object.entries(byPhase)) {
+        if (questions.length === 0)
+            continue;
+        md += `## ${phase.charAt(0).toUpperCase() + phase.slice(1)} Phase\n\n`;
+        for (const qa of questions) {
+            md += `### Q: "${qa.question}"\n\n`;
+            md += `**Expected Answer:**\n${qa.expected_answer}\n\n`;
+            if (qa.intent)
+                md += `- Intent: \`${qa.intent}\`\n`;
+            if (qa.presenter_notes)
+                md += `- Notes: ${qa.presenter_notes}\n`;
+            md += "\n---\n\n";
+        }
+    }
+    return md;
+}
+/**
+ * Validate a demo kit is ready for use
+ */
+export function validateDemoKit(kit) {
+    const issues = [];
+    // Check KB documents
+    if (kit.kb_documents.length === 0) {
+        issues.push("No KB documents generated - RAG search will return no results");
+    }
+    // Check demo script
+    if (kit.demo_script.length === 0) {
+        issues.push("No demo questions defined");
+    }
+    // Check intro and closing have fallbacks
+    const introQuestions = kit.demo_script.filter((q) => q.phase === "intro");
+    const introFallbacks = kit.fixed_responses.filter((f) => introQuestions.some((q) => f.fallback_for === q.id));
+    if (introQuestions.length > 0 && introFallbacks.length === 0) {
+        issues.push("No fallback responses for intro questions - high risk");
+    }
+    // Check entity coverage
+    const neededEntities = new Set();
+    for (const qa of kit.demo_script) {
+        if (qa.required_entities) {
+            for (const e of qa.required_entities) {
+                neededEntities.add(e);
+            }
+        }
+    }
+    const coveredEntities = new Set(kit.kb_documents.map((d) => d.entity_type));
+    for (const needed of neededEntities) {
+        if (!coveredEntities.has(needed)) {
+            issues.push(`Missing KB documents for entity type: ${needed}`);
+        }
+    }
+    return {
+        ready: issues.length === 0,
+        issues,
+        coverage: {
+            total_questions: kit.demo_script.length,
+            questions_with_fallback: kit.fixed_responses.length,
+            entity_types_covered: coveredEntities.size,
+        },
+    };
+}