@ema.co/mcp-toolkit 2026.1.24 → 2026.1.26-3

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']"
-  }
-}

package/resources/templates/voice-ai/workflow-prompt.md

@@ -1,121 +0,0 @@
-# Workflow Prompt: {Persona Name}
-
-> **IMPORTANT**: Copy the content in the "Auto Builder Prompt" section below into Ema Auto Builder.
-> The safeguards and validation sections help ensure correct interpretation.
-
----
-
-## Auto Builder Prompt
-
-```text
-Title: {Persona Name}
-
-Summary: {One sentence describing what this Voice AI does}
-
-Trigger: voice_call (inbound phone call)
-
----
-## EXPLICIT NODE DEFINITIONS
----
-
-Agents/Nodes:
-1. trigger (chat_trigger)
-   - outputs: chat_conversation, user_query
-
-2. intent_classifier (chat_categorizer)
-   - input: trigger.chat_conversation
-   - categories: [{Category1}, {Category2}, {Category3}, Fallback]
-   - output: category
-   - description: "Classifies caller intent"
-
-{For each category, define the processing nodes:}
-
-3. {category1_processor} ({action_type})
-   - runIf: intent_classifier.category == {Category1}
-   - inputs: {specify inputs}
-   - outputs: {specify outputs}
-   - description: "{What this node does}"
-
-4. {category1_response} (call_llm)
-   - runIf: intent_classifier.category == {Category1}
-   - inputs: 
-     - query: trigger.user_query
-     - named_inputs_{Category1}_Data: {category1_processor}.{output}
-   - instructions: "{Specific response instructions}"
-
-{Repeat for each category...}
-
-N. fallback_response (call_llm)
-   - runIf: intent_classifier.category == Fallback
-   - inputs: query: trigger.user_query
-   - instructions: "Ask a clarifying question. Provide examples: 
-     1. {Example query 1}
-     2. {Example query 2}
-     3. {Example query 3}"
-
----
-## EXPLICIT CONNECTIONS
----
-
-Connections:
-trigger.chat_conversation → intent_classifier.conversation
-trigger.user_query → intent_classifier.query
-
-# Category routing via runIf (NOT edges):
-# {category1_processor} has runIf: intent_classifier.category == {Category1}
-# {category2_processor} has runIf: intent_classifier.category == {Category2}
-# {category3_processor} has runIf: intent_classifier.category == {Category3}
-# fallback_response has runIf: intent_classifier.category == Fallback
-
-{category1_processor}.{output} → {category1_response}.named_inputs_{Category1}_Data
-trigger.user_query → {category1_response}.query
-
-{Repeat for all connections...}
-
----
-## RESULTS MAPPING
----
-
-Results:
-- {category1_response}.response_with_sources → WORKFLOW_OUTPUT
-- {category2_response}.response_with_sources → WORKFLOW_OUTPUT
-- {category3_response}.response_with_sources → WORKFLOW_OUTPUT
-- fallback_response.response_with_sources → WORKFLOW_OUTPUT
-
----
-## VALIDATION ASSERTIONS
----
-
-Assertions:
-- [ ] intent_classifier has edges for ALL categories: {Category1}, {Category2}, {Category3}, Fallback
-- [ ] Each category has exactly one routing path to a response node
-- [ ] All search/data nodes receive TEXT_WITH_SOURCES input from trigger.user_query
-- [ ] All call_llm nodes have explicit instructions
-- [ ] Fallback provides examples of valid queries
-- [ ] All response nodes map to WORKFLOW_OUTPUT
-```
-
----
-
-## Safeguard Checklist (Verify Before Pasting)
-
-### Structure Safeguards
-
-- [ ] **Trigger specified**: `voice_call` or `chat_trigger`
-- [ ] **All categories listed**: Including `Fallback`
-- [ ] **Explicit node definitions**: Each node has name, type, inputs, outputs
-- [ ] **Explicit connections**: Using `source.output → target.input` format
-- [ ] **Results mapping**: All outputs map to `WORKFLOW_OUTPUT`
-
-### Type Compatibility Safeguards
-
-- [ ] `chat_trigger.chat_conversation` → `chat_categorizer.conversation` ✓
-- [ ] `chat_trigger.user_query` → `call_llm.query` ✓
-- [ ] `search.search_results` → `respond_with_sources.search_results` ✓
-- [ ] `external_action_caller.tool_execution_result` → `call_llm.named_inputs_*` ✓
-
-### Category Routing Safeguards
-
-- [ ] Every category has a handler node with `runIf` condition
-- [ ] runIf format: `output: "category"` compared to `enumValue: "<CategoryName>"`
-- [ ] **DO NOT** use `category_<Name>` - use `output: "category"` with `enumValue`