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

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

@@ -1,111 +0,0 @@
-{
-  "$schema": "https://ema.co/schemas/persona-config-chat.json",
-  "$comment": "Chat AI Persona Configuration - Fill in all {placeholder} values",
-  
-  "personaType": "chat",
-  "projectType": 4,
-  "name": "{Persona Name}",
-  "description": "{Brief description of what this Chat AI does}",
-  
-  "chatbotSdkConfig": {
-    "name": "{Display name shown in chat widget}",
-    "theme": {
-      "primaryColor": "#1f8844",
-      "$comment": "Hex color for chat widget theme"
-    },
-    "logo": "",
-    "$comment_logo": "URL to logo image (optional)",
-    "allowedDomains": ["*"],
-    "$comment_allowedDomains": "Domains where widget can be embedded. Use ['*'] for all, or specific domains",
-    "disableSources": false,
-    "$comment_disableSources": "Set true to hide source citations"
-  },
-  
-  "fileTagging": {
-    "tagTypes": [
-      {
-        "name": "Department",
-        "tags": [
-          { "tagValue": "Department:HR" },
-          { "tagValue": "Department:IT" },
-          { "tagValue": "Department:Finance" }
-        ]
-      },
-      {
-        "name": "DocType",
-        "tags": [
-          { "tagValue": "DocType:Policy" },
-          { "tagValue": "DocType:Procedure" },
-          { "tagValue": "DocType:FAQ" }
-        ]
-      }
-    ],
-    "$comment": "Define tag categories and values for knowledge base filtering"
-  },
-  
-  "fileUpload": {
-    "localFiles": [],
-    "mergeFiles": [],
-    "tags": ["{default-tag}"],
-    "$comment_tags": "Default tags applied to all uploads",
-    "transforms": [],
-    "useChunking": true,
-    "$comment_useChunking": "Enable for better search on long documents",
-    "fileTagMappings": [],
-    "acceptedMimeTypes": [
-      "application/pdf",
-      "text/plain",
-      "text/markdown",
-      "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-      "text/csv"
-    ]
-  },
-  
-  "feedbackMessage": {
-    "message": {
-      "question": "Was this answer helpful?",
-      "positiveLabel": "Yes, helpful",
-      "negativeLabel": "No, not helpful"
-    },
-    "feedbackFrequency": 1,
-    "$comment_feedbackFrequency": "1 = every response, 3 = every 3rd response"
-  },
-  
-  "dataProtection": {
-    "protectedClasses": [
-      "ssn",
-      "credit_card"
-    ],
-    "$comment": "PII classes to redact from responses"
-  },
-  
-  "fusionModel": {
-    "allModels": true,
-    "selectedModels": []
-  },
-  
-  "knowledgeBaseSettings": {
-    "$comment": "These settings guide how the knowledge base should be configured",
-    "sources": [
-      {
-        "name": "{Source 1 Name}",
-        "type": "documents",
-        "folder": "docs/{folder1}",
-        "tags": ["{tag1}", "{tag2}"],
-        "priority": "primary"
-      },
-      {
-        "name": "{Source 2 Name}",
-        "type": "documents",
-        "folder": "docs/{folder2}",
-        "tags": ["{tag3}"],
-        "priority": "secondary"
-      }
-    ],
-    "searchSettings": {
-      "useSemanticSearch": true,
-      "useKeywordSearch": true,
-      "maxResults": 5
-    }
-  }
-}

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

@@ -1,156 +0,0 @@
-# {Persona Name}
-
-**Type**: Dashboard AI
-**Created**: {Date}
-**Version**: 1.0
-
-## Overview
-
-{Brief description of what this Dashboard 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 **Dashboard AI**
-3. Copy contents of `workflow-prompt.md` into the prompt field
-4. Click "Generate Workflow"
-5. Review generated nodes and verify:
-   - Document trigger configured correctly
-   - Entity extraction columns defined
-   - Rule validation rules specified
-   - All processing paths complete
-
-### Step 2: Configure Input Schema
-
-1. Navigate to "Input Configuration" section
-2. Define input fields from `persona-config.json`:
-
-| Field | Type | Required |
-|-------|------|----------|
-| {field1} | {type} | {yes/no} |
-| {field2} | {type} | {yes/no} |
-
-### Step 3: Configure Processing Settings
-
-1. Navigate to "Processing" section
-2. Apply settings:
-   - Batch Size: `dashboardSettings.batchSettings.batchSize`
-   - Timeout: `dashboardSettings.batchSettings.timeout`
-   - Parallel: `dashboardSettings.batchSettings.parallelExecution`
-
-### Step 4: Upload Reference Documents (if applicable)
-
-1. Navigate to "Knowledge Base" section
-2. Upload documents from `docs/` folder
-3. Configure entity extraction mappings
-
-### Step 5: Configure Approvals (if applicable)
-
-1. Navigate to "Approval Routing" section
-2. Define approval rules:
-   - Thresholds for auto-approval
-   - Routing rules for human review
-   - Escalation paths
-
-### Step 6: Test
-
-1. **Single Item Test**: Process one document
-2. **Batch Test**: Process small batch (5-10 items)
-3. **Edge Cases**:
-   - Missing required fields
-   - Invalid data formats
-   - Processing failures
-
-## Files
-
-| File | Description |
-|------|-------------|
-| `workflow-prompt.md` | Auto Builder prompt with safeguards |
-| `persona-config.json` | Dashboard AI configuration |
-| `proto-config.json` | Full API-deployable config |
-| `docs/` | Reference documents |
-
-## Testing Checklist
-
-- [ ] Workflow generates without validation errors
-- [ ] Document upload works
-- [ ] Entity extraction accurate
-- [ ] Rule validation correct
-- [ ] Approval routing works
-- [ ] Batch processing completes
-- [ ] Error handling works
-
-## Input Schema
-
-```json
-{
-  "fields": [
-    {
-      "name": "{field1}",
-      "type": "{string|number|date|file}",
-      "required": true,
-      "description": "{Field description}"
-    }
-  ]
-}
-```
-
-## Processing Flow
-
-```
-Input Document
-     │
-     ▼
-┌─────────────┐
-│ Parse/OCR   │
-└─────────────┘
-     │
-     ▼
-┌─────────────┐
-│ Extract     │──→ {Field 1}
-│ Entities    │──→ {Field 2}
-└─────────────┘──→ {Field N}
-     │
-     ▼
-┌─────────────┐
-│ Validate    │──→ Errors?
-│ Rules       │
-└─────────────┘
-     │
-     ▼
-┌─────────────┐
-│ Route for   │──→ Auto-approve
-│ Approval    │──→ Human review
-└─────────────┘──→ Reject
-```
-
-## Maintenance
-
-| Change Type | Action |
-|-------------|--------|
-| Workflow logic | Update `workflow-prompt.md`, re-generate |
-| Processing settings | Update `persona-config.json`, apply in UI |
-| Extraction rules | Update entity extraction columns |
-| Validation rules | Update rule validation configuration |
-
-## Troubleshooting
-
-### Processing fails
-
-- Check document format is supported
-- Verify required fields are present
-- Review extraction column mappings
-
-### Entity extraction inaccurate
-
-- Add more training examples
-- Refine extraction column definitions
-- Check document quality
-
-### Batch processing slow
-
-- Reduce batch size
-- Increase timeout
-- Enable parallel execution

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

@@ -1,180 +0,0 @@
-{
-  "$schema": "https://ema.co/schemas/persona-config-dashboard.json",
-  "$comment": "Dashboard AI Persona Configuration - Fill in all {placeholder} values",
-  
-  "personaType": "dashboard",
-  "projectType": 2,
-  "name": "{Persona Name}",
-  "description": "{Brief description of what this Dashboard AI does}",
-  
-  "dashboardSettings": {
-    "name": "{Display name}",
-    "description": "{What this dashboard processes}",
-    
-    "inputSchema": {
-      "fields": [
-        {
-          "name": "{field1}",
-          "type": "file",
-          "required": true,
-          "description": "{Primary document to process}",
-          "acceptedTypes": ["application/pdf", "image/*"]
-        },
-        {
-          "name": "{field2}",
-          "type": "string",
-          "required": false,
-          "description": "{Optional text field}"
-        },
-        {
-          "name": "{field3}",
-          "type": "select",
-          "required": true,
-          "options": ["{option1}", "{option2}", "{option3}"],
-          "description": "{Category selection}"
-        }
-      ]
-    },
-    
-    "batchSettings": {
-      "batchSize": 50,
-      "$comment_batchSize": "Number of items per batch (1-100)",
-      "timeout": 60,
-      "$comment_timeout": "Seconds per item before timeout",
-      "parallelExecution": true,
-      "$comment_parallelExecution": "Process items in parallel"
-    },
-    
-    "outputSchema": {
-      "fields": [
-        {
-          "name": "status",
-          "type": "enum",
-          "values": ["approved", "pending_review", "rejected"]
-        },
-        {
-          "name": "extracted_data",
-          "type": "object",
-          "description": "Extracted entity values"
-        },
-        {
-          "name": "validation_errors",
-          "type": "array",
-          "description": "List of validation failures"
-        },
-        {
-          "name": "confidence_score",
-          "type": "number",
-          "description": "0-1 confidence in extraction"
-        }
-      ]
-    }
-  },
-  
-  "entityExtraction": {
-    "columns": [
-      {
-        "name": "{Entity 1}",
-        "type": "string",
-        "description": "{What to extract}",
-        "examples": ["{example1}", "{example2}"]
-      },
-      {
-        "name": "{Entity 2}",
-        "type": "number",
-        "description": "{Numeric value to extract}",
-        "examples": ["{example1}", "{example2}"]
-      },
-      {
-        "name": "{Entity 3}",
-        "type": "date",
-        "description": "{Date to extract}",
-        "format": "YYYY-MM-DD"
-      }
-    ],
-    "$comment": "Define columns for entity_extraction_with_documents action"
-  },
-  
-  "ruleValidation": {
-    "rules": [
-      {
-        "name": "{Rule 1}",
-        "description": "{What this rule checks}",
-        "condition": "{Entity 1} is not empty",
-        "severity": "error"
-      },
-      {
-        "name": "{Rule 2}",
-        "description": "{What this rule checks}",
-        "condition": "{Entity 2} > 0",
-        "severity": "warning"
-      }
-    ],
-    "$comment": "Define rules for rule_validation_with_documents action"
-  },
-  
-  "approvalRouting": {
-    "rules": [
-      {
-        "name": "Auto-approve",
-        "condition": "confidence_score >= 0.95 AND validation_errors.length == 0",
-        "action": "auto_approve"
-      },
-      {
-        "name": "Manager Review",
-        "condition": "{amount} > 10000",
-        "action": "route_to_manager",
-        "assignee": "{manager_email}"
-      },
-      {
-        "name": "Reject",
-        "condition": "validation_errors contains 'critical'",
-        "action": "reject"
-      }
-    ],
-    "sla": {
-      "standard": "24h",
-      "urgent": "4h",
-      "reminderAt": "50%",
-      "escalateAt": "100%"
-    }
-  },
-  
-  "fileUpload": {
-    "localFiles": [],
-    "tags": ["{default-tag}"],
-    "useChunking": true,
-    "acceptedMimeTypes": [
-      "application/pdf",
-      "image/png",
-      "image/jpeg",
-      "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
-    ]
-  },
-  
-  "dataProtection": {
-    "protectedClasses": [
-      "ssn",
-      "credit_card",
-      "account_number"
-    ]
-  },
-  
-  "fusionModel": {
-    "allModels": true,
-    "selectedModels": []
-  },
-  
-  "notifications": {
-    "onSuccess": {
-      "enabled": true,
-      "recipients": ["{email}"],
-      "template": "Processing complete: {count} items processed"
-    },
-    "onFailure": {
-      "enabled": true,
-      "recipients": ["{email}"],
-      "template": "Processing failed: {error}"
-    }
-  }
-}

package/resources/templates/demo-scenarios/README.md

@@ -1,63 +0,0 @@
-# Demo Scenarios
-
-Pre-built demo data scenarios for reliable AI Employee demonstrations.
-
-## Available Scenarios
-
-| Scenario | Use Case | Persona Types |
-|----------|----------|---------------|
-| `sales-sdr` | Sales Development Representative | Voice, Chat |
-| `support-tier1` | Customer Support Tier 1 | Voice, Chat |
-| `hr-assistant` | HR Policy & Benefits Assistant | Chat, Voice |
-
-## Usage
-
-Generate a demo kit:
-
-```
-demo(mode="kit", persona_id="...", scenario="sales-sdr")
-```
-
-Validate demo readiness:
-
-```
-demo(mode="validate_kit", persona_id="...")
-```
-
-## What's Generated
-
-Each demo kit includes:
-
-1. **KB Documents** - Markdown files for the knowledge base with demo-ready data
-2. **Demo Script** - Questions to ask with expected answers
-3. **Fixed Response Fallbacks** - Workflow nodes for guaranteed responses
-4. **Validation Queries** - Test queries to verify before the demo
-
-## Customization
-
-Add custom Q&A pairs:
-
-```
-demo(mode="kit", persona_id="...", scenario="sales-sdr", custom_qa=[
-  {"question": "Tell me about feature X", "answer": "Feature X does..."}
-])
-```
-
-## Creating Custom Scenarios
-
-Create a JSON file in this directory with the following structure:
-
-```json
-{
-  "id": "my-scenario",
-  "name": "My Custom Scenario",
-  "description": "Description",
-  "persona_types": ["voice", "chat"],
-  "tags": ["tag1", "tag2"],
-  "intents": [...],
-  "entities": [...],
-  "qa_pairs": [...]
-}
-```
-
-See existing scenarios for complete examples.

package/resources/templates/demo-scenarios/test-published-package.md

@@ -1,116 +0,0 @@
-# Test Published Package: @ema.co/mcp-toolkit
-
-Use this prompt to verify the published npm package works correctly.
-
-## Quick Test (Copy & Run)
-
-```bash
-# Create temp directory
-cd /tmp && rm -rf mcp-test && mkdir mcp-test && cd mcp-test
-
-# Initialize and install
-npm init -y && npm install @ema.co/mcp-toolkit@latest
-
-# Create test file
-cat > test.mjs << 'EOF'
-import * as sdk from '@ema.co/mcp-toolkit/sdk';
-
-console.log('=== @ema.co/mcp-toolkit Test Suite ===\n');
-
-// 1. Version check
-const pkg = await import('@ema.co/mcp-toolkit/sdk');
-console.log(`SDK exports: ${Object.keys(pkg).length} items\n`);
-
-// 2. Core classes
-console.log('Core Classes:');
-console.log(`  EmaClient: ${typeof sdk.EmaClient === 'function' ? '✅' : '❌'}`);
-console.log(`  APISchemaRegistry: ${typeof sdk.APISchemaRegistry === 'function' ? '✅' : '❌'}`);
-console.log(`  StateStore: ${typeof sdk.StateStore === 'function' ? '✅' : '❌'}`);
-
-// 3. Workflow generation
-console.log('\nWorkflow Generation:');
-console.log(`  parseNaturalLanguage: ${typeof sdk.parseNaturalLanguage === 'function' ? '✅' : '❌'}`);
-console.log(`  needsLLMGeneration: ${typeof sdk.needsLLMGeneration === 'function' ? '✅' : '❌'}`);
-console.log(`  generateWorkflow: ${typeof sdk.generateWorkflow === 'function' ? '✅' : '❌'}`);
-
-// 4. Validation
-console.log('\nValidation:');
-console.log(`  validateWorkflowSpec: ${typeof sdk.validateWorkflowSpec === 'function' ? '✅' : '❌'}`);
-
-// 5. Functional test
-console.log('\nFunctional Test:');
-const intent = sdk.parseNaturalLanguage('Customer support bot that searches knowledge base and sends emails');
-console.log(`  Parse intent: ${intent.intents?.length > 0 ? '✅' : '❌'}`);
-console.log(`  Intents found: ${JSON.stringify(intent.intents?.map(i => i.name))}`);
-
-const needsLLM = sdk.needsLLMGeneration(intent);
-console.log(`  Needs LLM generation: ${needsLLM}`);
-
-if (needsLLM) {
-  const result = sdk.generateWorkflow(intent, [], []);
-  console.log(`  LLM prompt generated: ${result.llm_prompt ? '✅' : '❌'}`);
-}
-
-console.log('\n=== Test Complete ===');
-EOF
-
-# Run test
-node test.mjs
-```
-
-## Expected Output
-
-```
-=== @ema.co/mcp-toolkit Test Suite ===
-
-SDK exports: 119+ items
-
-Core Classes:
-  EmaClient: ✅
-  APISchemaRegistry: ✅
-  StateStore: ✅
-
-Workflow Generation:
-  parseNaturalLanguage: ✅
-  needsLLMGeneration: ✅
-  generateWorkflow: ✅
-
-Validation:
-  validateWorkflowSpec: ✅
-
-Functional Test:
-  Parse intent: ✅
-  Intents found: ["Customer Support","Email Automation"]
-  Needs LLM generation: true
-  LLM prompt generated: ✅
-
-=== Test Complete ===
-```
-
-## Import Paths
-
-| Path | Contents |
-|------|----------|
-| `@ema.co/mcp-toolkit/sdk` | SDK classes and functions |
-| `@ema.co/mcp-toolkit/mcp` | MCP server components |
-| `@ema.co/mcp-toolkit` | CLI entry point (not for programmatic use) |
-
-## MCP Server Test
-
-To test the MCP server:
-
-```bash
-# Start MCP server (requires EMA_API_TOKEN)
-export EMA_API_TOKEN="your-token"
-export EMA_TENANT_ID="your-tenant"
-npx -y @ema.co/mcp-toolkit@latest
-
-# Or with npx directly
-EMA_API_TOKEN="..." EMA_TENANT_ID="..." npx -y @ema.co/mcp-toolkit@latest
-```
-
-## Version Check
-
-```bash
-npm view @ema.co/mcp-toolkit version
-```