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

package/resources/templates/document-gen-ai/README.md

@@ -1,132 +0,0 @@
-# Document Generation AI - Resume Analysis Report Generator
-
-This template provides a document generation persona for creating comprehensive resume analysis reports.
-
-## Overview
-
-The Resume Analysis Report Generator helps HR teams and hiring managers quickly evaluate candidates through AI-powered resume analysis. It extracts structured data from resumes, validates candidates against configurable criteria, and generates detailed assessment reports.
-
-## Report Types
-
-### 1. Candidate Assessment Report
-Comprehensive analysis of a single candidate including:
-- Executive summary with overall recommendation
-- Skills assessment (technical and soft skills)
-- Experience analysis and career trajectory
-- Education and credentials review
-- Fit scoring (technical, cultural, overall on 1-10 scale)
-- Concerns, red flags, and recommendations
-
-### 2. Skills Gap Analysis
-Compare candidate qualifications against job requirements:
-- Required skills inventory from job description
-- Candidate skills inventory from resume
-- Gap identification matrix
-- Severity assessment (critical, moderate, minor)
-- Training and development recommendations
-- Time-to-proficiency estimates
-
-### 3. Candidate Comparison Report
-Side-by-side comparison of multiple candidates:
-- Summary comparison table
-- Individual candidate profiles
-- Skills matrix comparison
-- Experience level comparison
-- Ranked recommendations
-- Interview priority order
-
-## Key Features
-
-### Entity Extraction
-Automatically extracts structured data from resumes:
-- Candidate name and contact information
-- Total years of experience
-- Current/most recent role
-- Education history (degrees, institutions, fields)
-- Technical skills inventory
-- Professional certifications
-- Complete work history with achievements
-
-### Rule Validation
-Validates candidates against configurable hiring criteria:
-- Minimum experience requirements
-- Education standards
-- Communication skills evidence
-- Career progression patterns
-- Employment gap analysis
-
-### Fit Scoring
-Provides quantified assessment across dimensions:
-- Technical Fit (40% weight) - Skills match to requirements
-- Experience Fit (35% weight) - Relevance and depth
-- Cultural Fit (25% weight) - Values and team alignment
-- Overall Recommendation: Strong Yes / Yes / Maybe / No
-
-## Configuration
-
-### Required Inputs
-- Resume documents (PDF, DOCX)
-
-### Optional Inputs
-- Job description for comparison analysis
-- Analysis instructions (focus areas, scoring criteria)
-- Candidate tags for categorization
-
-### Data Protection
-By default, the following are redacted from LLM processing:
-- Phone numbers
-- Email addresses
-- Physical addresses
-- Social security numbers
-
-## Usage with MCP
-
-```typescript
-// Create persona from template
-persona(input="Create a Resume Analysis Report Generator for our Engineering team", type="dashboard")
-
-// Upload resume for analysis
-data(persona_id="...", action="upload", file="candidate_resume.pdf")
-
-// Generate assessment report
-// (Done through Ema dashboard UI)
-```
-
-## Customization
-
-### Adding Extraction Fields
-Modify the `extraction_columns` in the workflow definition to extract additional data points:
-- Languages spoken
-- Salary expectations
-- Notice period
-- Remote work preferences
-- Portfolio/GitHub links
-
-### Custom Validation Rules
-Add rules to the `all_rulesets` configuration:
-- Industry-specific requirements
-- Skill-based criteria
-- Certification requirements
-- Location preferences
-
-### Report Sections
-Configure `sectionConfigWidget` to customize report structure:
-- Add/remove sections
-- Reorder sections
-- Add custom section types
-
-## File Support
-
-Supported resume formats:
-- PDF
-- DOCX
-- DOC
-- TXT
-
-## Best Practices
-
-1. **Upload job descriptions** - Enables more accurate fit scoring and gap analysis
-2. **Customize validation rules** - Tailor criteria to your specific role requirements
-3. **Use tags** - Categorize candidates by role type, experience level, location
-4. **Review extraction accuracy** - Validate extracted data on first few resumes
-5. **Iterate on prompts** - Refine analysis instructions based on report quality

package/resources/templates/document-gen-ai/persona-config.json

@@ -1,316 +0,0 @@
-{
-  "$schema": "https://ema.co/schemas/persona-config-document-gen.json",
-  "$comment": "Document Generation AI Persona Configuration - Resume Analysis Report Generator",
-  
-  "personaType": "document_generation",
-  "projectType": 7,
-  "name": "Resume Analysis Report Generator",
-  "description": "Generates comprehensive analysis reports from uploaded resumes/CVs, including skills assessment, experience evaluation, and fit scoring for specified roles.",
-  
-  "category": "EMPLOYEE_EXPERIENCE",
-  "triggerType": "DASHBOARD",
-  
-  "documentTypes": [
-    {
-      "type": 1,
-      "name": "Candidate Assessment Report",
-      "description": "Comprehensive analysis of a single candidate's resume with scoring and recommendations",
-      "sections": [
-        {
-          "name": "executive_summary",
-          "title": "Executive Summary",
-          "description": "High-level overview and recommendation"
-        },
-        {
-          "name": "candidate_profile",
-          "title": "Candidate Profile",
-          "description": "Contact info, current role, key highlights"
-        },
-        {
-          "name": "skills_assessment",
-          "title": "Skills Assessment",
-          "description": "Technical and soft skills evaluation"
-        },
-        {
-          "name": "experience_analysis",
-          "title": "Experience Analysis",
-          "description": "Work history and career progression"
-        },
-        {
-          "name": "education_credentials",
-          "title": "Education & Credentials",
-          "description": "Degrees, certifications, and training"
-        },
-        {
-          "name": "fit_scoring",
-          "title": "Fit Scoring",
-          "description": "Quantified assessment (technical fit, cultural fit, overall)"
-        },
-        {
-          "name": "recommendations",
-          "title": "Recommendations",
-          "description": "Hiring recommendation and next steps"
-        }
-      ]
-    },
-    {
-      "type": 2,
-      "name": "Skills Gap Analysis",
-      "description": "Compare candidate skills against job requirements and identify gaps",
-      "sections": [
-        {
-          "name": "overview",
-          "title": "Analysis Overview",
-          "description": "Summary of gap analysis findings"
-        },
-        {
-          "name": "required_skills",
-          "title": "Required Skills Inventory",
-          "description": "Skills needed for the role"
-        },
-        {
-          "name": "candidate_skills",
-          "title": "Candidate Skills Inventory",
-          "description": "Skills the candidate possesses"
-        },
-        {
-          "name": "gap_matrix",
-          "title": "Gap Identification Matrix",
-          "description": "Detailed skill-by-skill gap analysis"
-        },
-        {
-          "name": "severity_assessment",
-          "title": "Gap Severity Assessment",
-          "description": "Critical, moderate, minor gap classification"
-        },
-        {
-          "name": "development_plan",
-          "title": "Development Recommendations",
-          "description": "Training and development suggestions"
-        }
-      ]
-    },
-    {
-      "type": 3,
-      "name": "Candidate Comparison Report",
-      "description": "Side-by-side comparison of multiple candidates for a role",
-      "sections": [
-        {
-          "name": "comparison_summary",
-          "title": "Comparison Summary",
-          "description": "Quick comparison table and rankings"
-        },
-        {
-          "name": "candidate_profiles",
-          "title": "Individual Candidate Profiles",
-          "description": "Brief profile of each candidate"
-        },
-        {
-          "name": "skills_matrix",
-          "title": "Skills Comparison Matrix",
-          "description": "Side-by-side skills comparison"
-        },
-        {
-          "name": "experience_comparison",
-          "title": "Experience Comparison",
-          "description": "Years, industries, and role levels"
-        },
-        {
-          "name": "rankings",
-          "title": "Overall Rankings",
-          "description": "Ranked list with rationale"
-        },
-        {
-          "name": "interview_recommendations",
-          "title": "Interview Recommendations",
-          "description": "Priority order and focus areas per candidate"
-        }
-      ]
-    }
-  ],
-  
-  "entityExtraction": {
-    "columns": [
-      {
-        "id": "candidate_name",
-        "name": "Candidate Name",
-        "type": "string",
-        "description": "Full name of the candidate"
-      },
-      {
-        "id": "contact_info",
-        "name": "Contact Information",
-        "type": "object",
-        "description": "Email and phone number",
-        "fields": [
-          {"name": "email", "type": "string"},
-          {"name": "phone", "type": "string"}
-        ]
-      },
-      {
-        "id": "years_experience",
-        "name": "Total Years of Experience",
-        "type": "number",
-        "description": "Total professional work experience in years"
-      },
-      {
-        "id": "current_role",
-        "name": "Current/Most Recent Role",
-        "type": "string",
-        "description": "Current or most recent job title and company"
-      },
-      {
-        "id": "education",
-        "name": "Education",
-        "type": "array",
-        "description": "Educational background",
-        "itemType": "object",
-        "itemFields": [
-          {"name": "degree", "type": "string", "description": "Degree type"},
-          {"name": "institution", "type": "string", "description": "School/university name"},
-          {"name": "field", "type": "string", "description": "Field of study"},
-          {"name": "year", "type": "number", "description": "Graduation year"}
-        ]
-      },
-      {
-        "id": "technical_skills",
-        "name": "Technical Skills",
-        "type": "array",
-        "description": "List of technical skills, tools, and technologies"
-      },
-      {
-        "id": "certifications",
-        "name": "Certifications",
-        "type": "array",
-        "description": "Professional certifications and licenses"
-      },
-      {
-        "id": "work_history",
-        "name": "Work History",
-        "type": "array",
-        "description": "Employment history",
-        "itemType": "object",
-        "itemFields": [
-          {"name": "company", "type": "string"},
-          {"name": "title", "type": "string"},
-          {"name": "duration", "type": "string"},
-          {"name": "highlights", "type": "string"}
-        ]
-      }
-    ]
-  },
-  
-  "ruleValidation": {
-    "rulesets": [
-      {
-        "id": "basic_requirements",
-        "name": "Basic Requirements",
-        "description": "Standard hiring criteria",
-        "rules": [
-          {
-            "id": "min_experience",
-            "name": "Minimum Experience",
-            "description": "Candidate must have at least 2 years of professional work experience",
-            "severity": "required"
-          },
-          {
-            "id": "education",
-            "name": "Education Requirement",
-            "description": "Candidate should have at least a Bachelor's degree or equivalent experience",
-            "severity": "preferred"
-          },
-          {
-            "id": "communication",
-            "name": "Communication Skills",
-            "description": "Resume demonstrates strong written communication skills",
-            "severity": "preferred"
-          },
-          {
-            "id": "career_progression",
-            "name": "Career Progression",
-            "description": "Career shows logical progression with increasing responsibilities",
-            "severity": "preferred"
-          },
-          {
-            "id": "employment_continuity",
-            "name": "Employment Continuity",
-            "description": "No unexplained employment gaps longer than 12 months",
-            "severity": "warning"
-          }
-        ],
-        "aggregation": "(min_experience AND education) OR (communication AND career_progression)"
-      }
-    ]
-  },
-  
-  "fileUpload": {
-    "acceptedTypes": [
-      "application/pdf",
-      "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-      "application/msword",
-      "text/plain"
-    ],
-    "tags": {
-      "default": ["resume_documents"],
-      "jobDescription": ["job_description"],
-      "comparison": ["comparison_resumes"],
-      "gapAnalysis": ["gap_analysis_resume", "gap_requirements"]
-    }
-  },
-  
-  "dataProtection": {
-    "protectedClasses": [
-      "phone_number",
-      "email",
-      "address",
-      "social_security_number"
-    ],
-    "$comment": "Sensitive data to redact from LLM processing"
-  },
-  
-  "fusionModel": {
-    "allModels": true,
-    "selectedModels": [],
-    "$comment": "Use all available LLMs for optimal analysis accuracy"
-  },
-  
-  "scoringCriteria": {
-    "scales": [
-      {
-        "name": "fit_score",
-        "min": 1,
-        "max": 10,
-        "description": "How well candidate matches requirements"
-      }
-    ],
-    "recommendations": [
-      "Strong Yes",
-      "Yes",
-      "Maybe",
-      "No"
-    ],
-    "dimensions": [
-      {
-        "name": "technical_fit",
-        "weight": 0.4,
-        "description": "Match of technical skills to requirements"
-      },
-      {
-        "name": "experience_fit",
-        "weight": 0.35,
-        "description": "Relevance and depth of experience"
-      },
-      {
-        "name": "cultural_fit",
-        "weight": 0.25,
-        "description": "Alignment with company values and team dynamics"
-      }
-    ]
-  },
-  
-  "samplePrompts": {
-    "candidateAssessment": "Generate a comprehensive candidate assessment report for this resume. Analyze skills, experience, education, and provide a fit score (1-10) for each dimension: technical fit, experience fit, and cultural fit. Include a final recommendation (Strong Yes/Yes/Maybe/No) with rationale.",
-    "skillsGap": "Compare this candidate's skills against the job requirements. Identify all gaps, categorize them by severity (critical, moderate, minor), and provide specific training or development recommendations for each gap.",
-    "candidateComparison": "Compare these candidates for the specified role. Create a comparison matrix, rank the candidates, and provide a recommended interview order with specific focus areas for each candidate."
-  }
-}

package/resources/templates/voice-ai/README.md

@@ -1,123 +0,0 @@
-# {Persona Name}
-
-**Type**: Voice AI
-**Created**: {Date}
-**Version**: 1.0
-
-## Overview
-
-{Brief description of what this Voice AI Employee does}
-
-## Deployment Steps
-
-### Step 1: Create Workflow in Auto Builder
-
-1. Go to [Ema Auto Builder](https://builder.ema.co/)
-2. Create new AI Employee → Select **Voice AI**
-3. Copy contents of `workflow-prompt.md` into the prompt field
-4. Click "Generate Workflow"
-5. Review generated nodes and verify:
-   - All categorizers have edges for every category
-   - Search nodes connect to respond nodes correctly
-   - Fallback paths are present
-
-### Step 2: Configure Conversational Behavior
-
-1. Navigate to "Conversational Behavior" section
-2. Apply settings from `persona-config.json`:
-
-| Field | Source |
-|-------|--------|
-| Welcome Message | `conversationSettings.welcomeMessage` |
-| Identity & Purpose | `conversationSettings.identityAndPurpose` |
-| Take Action Instructions | `conversationSettings.takeActionInstructions` |
-| Hangup Instructions | `conversationSettings.hangupInstructions` |
-| Transfer Call Instructions | `conversationSettings.transferCallInstructions` |
-| Speech Characteristics | `conversationSettings.speechCharacteristics` |
-| System Prompt | `conversationSettings.systemPrompt` |
-| Wait Message | `conversationSettings.waitMessage` |
-
-### Step 3: Configure Voice Settings
-
-1. Navigate to "Voice Settings" section
-2. Apply settings:
-   - Language: From `voiceSettings.languageHints`
-   - Voice Model: From `voiceSettings.voiceModel`
-
-### Step 4: Configure VAD & Data Storage
-
-1. **VAD Settings** (Voice Activity Detection):
-   - Turn Timeout: `vadSettings.turnTimeout` seconds
-   - Silence End Call: `vadSettings.silenceEndCallTimeout` seconds
-   - Max Duration: `vadSettings.maxConversationDuration` seconds
-
-2. **Data Storage**:
-   - Store Audio: `dataStorageSettings.storeAudioRecording`
-   - Store Transcripts: `dataStorageSettings.storeTranscripts`
-
-### Step 5: Upload Knowledge Base (if applicable)
-
-1. Navigate to "Knowledge Base" section
-2. Upload documents from `docs/` folder
-3. Apply tags as specified in `docs/_metadata.json`
-
-### Step 6: Test
-
-1. **Simulator Test**: Use the built-in call simulator
-2. **Test Calls**:
-   - Test happy path (main use case)
-   - Test each category branch
-   - Test fallback handling
-   - Test verification flows (if applicable)
-3. **Edge Cases**:
-   - Test with unexpected inputs
-   - Test silence handling
-   - Test interruption handling
-
-## Files
-
-| File | Description |
-|------|-------------|
-| `workflow-prompt.md` | Auto Builder prompt with safeguards |
-| `persona-config.json` | Voice AI configuration |
-| `proto-config.json` | Full API-deployable config |
-| `docs/` | Knowledge base documents |
-
-## Testing Checklist
-
-- [ ] Workflow generates without validation errors
-- [ ] All category paths work correctly
-- [ ] Fallback provides helpful response
-- [ ] Voice sounds natural and appropriate
-- [ ] Actions/tools execute correctly
-- [ ] Handoff to human works (if applicable)
-- [ ] Call ends appropriately
-
-## Maintenance
-
-| Change Type | Action |
-|-------------|--------|
-| Workflow logic | Update `workflow-prompt.md`, re-generate |
-| Persona behavior | Update `persona-config.json`, apply in UI |
-| Knowledge content | Update docs in `docs/`, re-upload |
-| Voice settings | Update `persona-config.json`, apply in UI |
-
-## Troubleshooting
-
-### "Validation failed" in Auto Builder
-
-- Check that all categorizers have Fallback category
-- Verify edge format: `category_<Name>` not `category::<Name>`
-- Ensure all nodes have required inputs
-
-### Voice sounds unnatural
-
-- Review `speechCharacteristics` for TTS rules
-- Add pronunciation guides for technical terms
-- Adjust pauses and pacing instructions
-
-### Actions not triggering
-
-- Check `takeActionInstructions` uses correct `</Case N>` format
-- Verify tool names match exactly
-- Review `systemPrompt` for tool calling rules

package/resources/templates/voice-ai/persona-config.json

@@ -1,74 +0,0 @@
-{
-  "$schema": "https://ema.co/schemas/persona-config-voice.json",
-  "$comment": "Voice AI Persona Configuration - Fill in all {placeholder} values",
-  
-  "personaType": "voice",
-  "projectType": 5,
-  "name": "{Persona Name}",
-  "description": "{Brief description of what this Voice AI does}",
-  
-  "conversationSettings": {
-    "name": "{AI Name - e.g., 'Sofia', 'Alex', 'Service Agent'}",
-    
-    "welcomeMessage": "{Opening greeting when call connects}\n\nExample:\nHello, thank you for calling {Company}. This is {AI Name}. How can I help you today?",
-    
-    "identityAndPurpose": "You are {AI Name}, a Voice AI assistant for {Company}.\n\nPrimary responsibility: {Main purpose}\n\nYour responsibilities:\n1. {Responsibility 1}\n2. {Responsibility 2}\n3. {Responsibility 3}\n\nRules:\n- {Rule 1}\n- {Rule 2}",
-    
-    "takeActionInstructions": "</Case 1>\n{Action 1 Name}\n\nTrigger When:\n{Condition that triggers this action}\n\nIntent for tool call: \"{Tool Intent Name}\"\n\nRequired parameters:\n{ \"{param1}\": \"\", \"{param2}\": \"\" }\n</Case 1>\n\n</Case 2>\n{Action 2 Name}\n\nTrigger When:\n{Condition that triggers this action}\n\nIntent for tool call: \"{Tool Intent Name}\"\n\nRequired parameters:\n{ \"{param1}\": \"\" }\n</Case 2>",
-    
-    "hangupInstructions": "End the call when:\n- The caller explicitly says goodbye or asks to hang up\n- The caller confirms they have no more questions\n- {Additional hangup conditions}\n\nBefore ending:\n- Confirm all issues are resolved\n- Offer any follow-up information\n- Thank the caller",
-    
-    "transferCallInstructions": "Transfer the call when:\n- The caller explicitly requests a human agent\n- {Condition requiring human}\n- {Complex scenario}\n\nBefore transferring:\n- Inform the caller you're transferring them\n- Provide brief context to the human agent\n- {Additional transfer instructions}",
-    
-    "speechCharacteristics": "**Conversational Style:**\n- Keep responses brief (2-3 sentences per turn)\n- Use warm, professional tone\n- Speak clearly at moderate pace\n\n**Natural Speech:**\n- Use brief pauses between sentences\n- Acknowledge with 'I understand', 'Of course', 'Certainly'\n- Avoid robotic language\n\n**TTS Pronunciation Rules:**\n- Spell out IDs: 'A-B-C-1-2-3'\n- Pause between numbers: 'Your code is... 1... 2... 3... 4'\n- {Domain-specific pronunciation rules}",
-    
-    "systemPrompt": "Tool Calling Instructions:\n\n1. Always collect required parameters before calling tools\n2. Confirm parameter values with the caller\n3. Handle tool errors gracefully\n4. {Additional tool calling rules}\n\nParameter Collection:\n- {Param 1}: {How to collect}\n- {Param 2}: {How to collect}",
-    
-    "formFillingInstructions": "{Instructions for collecting form data, if applicable}\n\nExample:\nWhen collecting booking information:\n1. Ask for name first\n2. Then ask for date preference\n3. Confirm all details before proceeding",
-    
-    "waitMessage": "One moment while I look that up for you..."
-  },
-  
-  "voiceSettings": {
-    "languageHints": ["en-US"],
-    "voiceModel": "default",
-    "$comment_voiceModel": "Options: default, professional-male, professional-female, casual"
-  },
-  
-  "vadSettings": {
-    "turnTimeout": 3,
-    "$comment_turnTimeout": "Seconds to wait for caller to finish speaking",
-    "silenceEndCallTimeout": 30,
-    "$comment_silenceEndCallTimeout": "Seconds of silence before ending call",
-    "maxConversationDuration": 600,
-    "$comment_maxConversationDuration": "Maximum call length in seconds (600 = 10 minutes)"
-  },
-  
-  "dataStorageSettings": {
-    "storeAudioRecording": true,
-    "storeTranscripts": true,
-    "storeAgentTranscript": true
-  },
-  
-  "callSettings": {
-    "enableCallForwarding": false,
-    "callForwardingNumber": "",
-    "enableSpamCallPrevention": true,
-    "enableDisconnectCall": false
-  },
-  
-  "dataProtection": {
-    "protectedClasses": [
-      "ssn",
-      "credit_card",
-      "phone_number"
-    ],
-    "$comment_protectedClasses": "PII classes to redact. Options: ssn, credit_card, phone_number, email, address, dob, account_number"
-  },
-  
-  "fusionModel": {
-    "allModels": true,
-    "selectedModels": [],
-    "$comment": "Leave allModels: true for best results, or specify models: ['gpt-4', 'claude-3']"
-  }
-}