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

package/dist/mcp/tools-consolidated.js

@@ -1,866 +0,0 @@
-/**
- * Consolidated MCP Tools for Ema
- *
- * Follows Unix CLI patterns:
- * - Single command with flags instead of separate get/list/create tools
- * - Consistent terminology: "persona" (not mixed "ai_employee")
- * - Mode flags for different operations on same resource
- *
- * ~45 tools → 9 commands:
- * 1. env       - Environment listing
- * 2. persona   - AI Employee management
- * 3. workflow  - Workflow generation, analysis, deploy, optimize
- * 4. action    - Actions/agents lookup
- * 5. template  - Patterns, widgets, templates
- * 6. knowledge - Data sources & embedding
- * 7. reference - Platform concepts & guidance
- * 8. sync      - Environment sync
- * 9. demo      - Demo data utilities (RAG document generation)
- */
-// Helper to add env parameter to schema
-function withEnvParam(props, required = [], envNames = [], defaultEnv = "demo") {
-    return {
-        type: "object",
-        properties: {
-            ...props,
-            env: {
-                type: "string",
-                description: `Target environment. Available: ${envNames.join(", ") || "demo, staging, dev"}. Default: ${defaultEnv}`,
-            },
-        },
-        required,
-    };
-}
-/**
- * Generate consolidated tool definitions
- */
-export function generateConsolidatedTools(envNames, defaultEnv) {
-    const withEnv = (props, required = []) => withEnvParam(props, required, envNames, defaultEnv);
-    return [
-        // ═══════════════════════════════════════════════════════════════════════
-        // 1. ENV - Environment listing (simplest tool)
-        // ═══════════════════════════════════════════════════════════════════════
-        {
-            name: "env",
-            description: "List available Ema environments and toolkit info. Returns environments (with default marker) and toolkit name/version.",
-            inputSchema: { type: "object", properties: {}, required: [] },
-        },
-        // ═══════════════════════════════════════════════════════════════════════
-        // 2. PERSONA - Unified AI Employee management (create, modify, analyze, list)
-        // ═══════════════════════════════════════════════════════════════════════
-        {
-            name: "persona",
-            description: `AI Employee management. Explicit mode required.
-
-## Modes (explicit \`mode\` parameter required)
-
-| Mode | Purpose | Required Params |
-|------|---------|-----------------|
-| \`list\` | List all personas | - |
-| \`get\` | Get specific persona | \`id\` |
-| \`create\` | Create new persona | \`name\`, \`type\` or \`from\` |
-| \`update\` | Update config | \`id\`, \`proto_config\` |
-| \`clone\` | Clone persona | \`from\`, \`name\` |
-| \`compare\` | Compare two | \`id\`, \`compare_to\` |
-| \`sanitize\` | Sanitize PII | \`id\` |
-| \`analyze\` | Analyze issues | \`id\`, optional: \`fix\`, \`include\` |
-| \`templates\` | List templates | - |
-
-## Examples
-
-\`\`\`
-// List & Get
-persona(mode="list")
-persona(mode="get", id="abc-123")
-persona(mode="get", id="abc-123", include_workflow=true)
-
-// Create from template
-persona(mode="create", from="Voice AI Starter", name="My SDR", input="qualifies leads", preview=false)
-
-// Create new (no template)
-persona(mode="create", name="My SDR", type="voice", input="qualifies leads", preview=false)
-
-// Update config (proto_config)
-persona(mode="update", id="abc-123", proto_config={widgets: [{name: "conversationSettings", conversationSettings: {...}}]})
-
-// Update workflow via LLM-native WorkflowSpec
-persona(mode="update", id="abc-123", workflow_spec={name: "...", nodes: [...], resultMappings: [...]})
-
-// Clone
-persona(mode="clone", from="source-id", name="My Copy", include_data=true)
-
-// Compare
-persona(mode="compare", id="abc-123", compare_to="def-456")
-
-// Analyze (returns workflow_spec + schema + issues)
-persona(mode="analyze", id="abc-123")
-persona(mode="analyze", id="abc-123", include=["workflow", "data"])
-
-// Workflow modification flow (Agent builds fixes, MCP deploys):
-// 1. Analyze to get workflow_spec + schema + issues
-//    persona(mode="analyze", id="abc-123") 
-//    → returns {workflow_spec: {...}, schema: "...", issues: [...]}
-// 2. Agent reviews issues, asks user which to fix
-// 3. Agent modifies the spec (add nodes, change inputs, etc.)
-// 4. Deploy the agent-built spec
-//    persona(mode="update", id="abc-123", workflow_spec=<agent_built_spec>)
-\`\`\`
-
-## ⚠️ ASK BEFORE CREATING
-
-**Before creating a new AI Employee, ASK THE USER:**
-1. What should it do? (purpose, intents, capabilities)
-2. What type? (voice, chat, dashboard)
-3. What name?
-
-## Key Rules
-
-1. **EXPLICIT MODE** - Always specify mode parameter
-2. **ONE CALL** - Put everything in one call
-3. **STOP after success** - Don't make follow-up "fix" calls
-4. **preview=false** - Required to actually deploy`,
-            inputSchema: withEnv({
-                // === MODE (explicit, required) ===
-                mode: {
-                    type: "string",
-                    enum: [
-                        "list", "get", "create", "update", "clone", "compare", "sanitize", "templates", "analyze", "intent",
-                        "version_create", "version_list", "version_get", "version_compare", "version_restore", "version_policy"
-                    ],
-                    description: "Operation mode. REQUIRED. If omitted, tool will ask for clarification.",
-                },
-                // === IDENTITY (for existing personas) ===
-                id: {
-                    type: "string",
-                    description: "Persona ID (UUID) or exact name. Required for get/update/compare/sanitize."
-                },
-                identifier: {
-                    type: "string",
-                    deprecated: true,
-                    description: "DEPRECATED: use id.",
-                },
-                // === CREATE FROM BASE (unified: template or persona) ===
-                from: {
-                    type: "string",
-                    description: "Base to create/clone from: template ID, persona ID, or name. Used with mode='create' or mode='clone'.",
-                },
-                include_data: {
-                    type: "boolean",
-                    description: "When cloning from persona: include knowledge files and dashboard rows. Default: true for persona, N/A for template.",
-                },
-                // === CREATE/MODIFY ===
-                input: {
-                    type: "string",
-                    description: "Natural language description. For new: 'Voice AI for sales...'. For modify: 'add HITL before email'.",
-                },
-                type: {
-                    type: "string",
-                    enum: ["voice", "chat", "dashboard"],
-                    description: "AI Employee type. Required when creating without 'from'."
-                },
-                name: { type: "string", description: "REQUIRED for new: The actual persona name shown in Ema platform." },
-                description: { type: "string", description: "Description of what it does." },
-                preview: {
-                    type: "boolean",
-                    description: "Default: true (safe). Set false to deploy changes."
-                },
-                sanitize: { type: "boolean", description: "Sanitize/obfuscate PII and sensitive data (for demo environments)" },
-                sanitize_examples: { type: "array", items: { type: "string" }, description: "Additional items to treat as sensitive (e.g., company names)" },
-                // === ANALYZE ===
-                fix: {
-                    type: "boolean",
-                    description: "DEPRECATED: Returns preview only. Agent should review issues and build workflow_spec fixes.",
-                },
-                include: {
-                    type: "array",
-                    items: { type: "string", enum: ["workflow", "config", "data", "issues", "connections", "fixes", "metrics"] },
-                    description: "What to include. For analyze: ['workflow','config','data']. For get: ['issues','connections','fixes','metrics'].",
-                },
-                include_workflow: { type: "boolean", description: "Include full workflow_def in response" },
-                include_fingerprint: { type: "boolean", description: "Include config hash" },
-                // === INTENT (qualification/refinement) ===
-                previous_answers: {
-                    type: "object",
-                    additionalProperties: { type: "string" },
-                    description: "For mode='intent': answers to previous qualification questions (iterative flow).",
-                },
-                iteration: {
-                    type: "integer",
-                    minimum: 1,
-                    description: "For mode='intent': iteration number (1 = first call, 2+ = after providing answers).",
-                },
-                max_complexity: {
-                    type: "string",
-                    enum: ["simple", "moderate", "complex"],
-                    description: "For mode='intent': cap complexity level for gradual rollout.",
-                },
-                // === LIST/SEARCH ===
-                all: { type: "boolean", description: "List all personas" },
-                query: { type: "string", description: "Search by name (partial match)" },
-                status: { type: "string", description: "Filter: 'active', 'inactive', 'draft'" },
-                trigger_type: { type: "string", description: "Filter: 'voice', 'chat', 'dashboard'" },
-                limit: { type: "number", description: "Max results (default: 50)" },
-                // === COMPARE ===
-                compare_to: { type: "string", description: "Second persona ID for comparison" },
-                compare_env: { type: "string", description: "Environment of compare_to persona" },
-                // === ADVANCED/OVERRIDE ===
-                proto_config: {
-                    type: "object",
-                    description: "Override voice/chat settings. Usually auto-generated from input."
-                },
-                workflow: {
-                    type: "object",
-                    description: "Direct workflow_def JSON (advanced). Usually auto-generated."
-                },
-                workflow_spec: {
-                    type: "object",
-                    description: "LLM-native WorkflowSpec. SDK compiles to workflow_def. Use with mode='update'. Get schema from mode='analyze'."
-                },
-                include_spec: {
-                    type: "boolean",
-                    description: "For mode='analyze': include decompiled workflow_spec + schema in response. Default: true."
-                },
-                workflow_def: {
-                    type: "object",
-                    description: "Alias for workflow (backwards compatibility)."
-                },
-                enabled: { type: "boolean", description: "Enable/disable persona" },
-                // === DEPRECATED (use 'from' instead) ===
-                template_id: { type: "string", description: "DEPRECATED: use from. Specific template ID." },
-                clone_from: { type: "string", description: "DEPRECATED: use from. Clone from existing persona ID." },
-                clone_data: { type: "boolean", description: "DEPRECATED: use include_data." },
-                // === TEMPLATES ===
-                templates: { type: "boolean", description: "List available templates" },
-                // === VERSION MANAGEMENT ===
-                // Note: mode enum is defined above, version_* modes are included there
-                version: { type: "string", description: "Version identifier (e.g., 'v3', 'latest')" },
-                v1: { type: "string", description: "First version for comparison" },
-                v2: { type: "string", description: "Second version for comparison" },
-                message: { type: "string", description: "Version message/description" },
-                auto_on_deploy: { type: "boolean", description: "Auto-create version on deploy" },
-                auto_on_sync: { type: "boolean", description: "Auto-create version on sync" },
-                max_versions: { type: "number", description: "Max versions to keep" },
-            }),
-        },
-        // ═══════════════════════════════════════════════════════════════════════
-        // 3. WORKFLOW - DEPRECATED: Use persona() instead
-        // ═══════════════════════════════════════════════════════════════════════
-        {
-            name: "workflow",
-            description: `⚠️ DEPRECATED: Use \`persona()\` instead. This tool routes to persona.
-
-## Migration Guide
-
-OLD (deprecated):
-  workflow(input="...", type="voice", name="Bot", preview=false)
-  workflow(persona_id="abc", input="add HITL")
-
-NEW (use this):
-  persona(input="...", type="voice", name="Bot", preview=false)
-  persona(id="abc", input="add HITL")
-
-The \`persona\` tool now handles everything: create, modify, analyze, list.
-This \`workflow\` tool still works but shows a deprecation warning.`,
-            inputSchema: withEnv({
-                // === REQUIRED for creating/modifying ===
-                input: {
-                    type: "string",
-                    description: "Natural language description of what you want. Examples: 'Voice AI for sales development' (new) or 'add HITL before emails' (modify existing)",
-                },
-                // === REQUIRED for modifying existing ===
-                persona_id: {
-                    type: "string",
-                    description: "ID of existing persona to modify or analyze. Omit for creating new personas."
-                },
-                // === REQUIRED for new Voice/Chat/Dashboard ===
-                type: {
-                    type: "string",
-                    enum: ["voice", "chat", "dashboard"],
-                    description: "REQUIRED for new personas. Type of AI Employee to create."
-                },
-                // === Control deployment ===
-                preview: {
-                    type: "boolean",
-                    description: "Default: true (safe). Set false to deploy changes to Ema platform."
-                },
-                // === For new personas (greenfield with preview=false) ===
-                name: {
-                    type: "string",
-                    description: "Name for the new persona. Required when creating with preview=false."
-                },
-                description: {
-                    type: "string",
-                    description: "Description of what the persona does."
-                },
-                // === Voice/Chat settings (auto-generated, but can override) ===
-                proto_config: {
-                    type: "object",
-                    description: "Voice/chat settings. Auto-generated from input. Override specific settings like welcomeMessage, identityAndPurpose."
-                },
-                // === For analysis/optimization ===
-                optimize: {
-                    type: "boolean",
-                    description: "DEPRECATED: Returns suggestions only. Agent should build workflow_spec fixes.",
-                },
-                include: {
-                    type: "array",
-                    items: { type: "string", enum: ["issues", "connections", "fixes", "metrics"] },
-                    description: "What to include in analysis output.",
-                },
-                // === Advanced/Legacy ===
-                workflow_def: {
-                    type: "object",
-                    description: "Direct workflow JSON (advanced). Usually auto-generated from input."
-                },
-                compare_to: { type: "string", description: "Second persona ID for comparison" },
-                mode: {
-                    type: "string",
-                    enum: ["generate", "extend", "optimize", "analyze", "compare", "compile"],
-                    description: "Usually auto-detected. Only specify for compile mode."
-                },
-                nodes: { type: "array", description: "For compile mode: node definitions" },
-                result_mappings: { type: "array", description: "For compile mode: output mappings" },
-            }),
-        },
-        // ═══════════════════════════════════════════════════════════════════════
-        // 4. ACTION - Actions/agents lookup (API + reference docs)
-        // ═══════════════════════════════════════════════════════════════════════
-        {
-            name: "action",
-            description: `Unified action/agent lookup. Gets live API data AND reference docs.
-
-**Get single**:
-  action(id="chat_categorizer")
-  action(id="abc-123-uuid")
-  action(id="search", include_docs=true)
-
-**List/Search**:
-  action(all=true)
-  action(category="routing")
-  action(query="search")
-  action(persona_id="abc")  # Actions in workflow
-
-**Suggest for use case**:
-  action(suggest="IT helpdesk with ticket creation")
-
-**Categories**:
-  action(categories=true)`,
-            inputSchema: withEnv({
-                // ID (or name)
-                id: {
-                    type: "string",
-                    description: "Action ID or name (e.g., 'chat_categorizer')"
-                },
-                // Deprecated alias (backwards compatibility)
-                identifier: {
-                    type: "string",
-                    deprecated: true,
-                    description: "DEPRECATED: use id. Action ID or name (e.g., 'chat_categorizer')",
-                },
-                // List/Search flags
-                all: { type: "boolean", description: "List all available actions" },
-                query: { type: "string", description: "Search by name" },
-                category: { type: "string", description: "Filter by category" },
-                persona_id: { type: "string", description: "List actions in this workflow" },
-                enabled: { type: "boolean", description: "Filter by enabled status" },
-                limit: { type: "number", description: "Max results" },
-                // Include flags
-                include_docs: { type: "boolean", description: "Include full documentation" },
-                // Suggest mode
-                suggest: { type: "string", description: "Get recommendations for use case" },
-                // List categories
-                categories: { type: "boolean", description: "List action categories" },
-            }),
-        },
-        // ═══════════════════════════════════════════════════════════════════════
-        // 5. TEMPLATE - Patterns, widgets, persona templates
-        // ═══════════════════════════════════════════════════════════════════════
-        {
-            name: "template",
-            description: `Get qualifying questions and reference patterns.
-
-## 🎯 PRIMARY USE: Get Questions to Ask User
-
-**Before creating an AI Employee, call this to get what to ask:**
-  template(questions=true)                    // All qualifying questions
-  template(questions=true, category="Voice")  // Voice-specific questions
-
-Returns structured questions about: type, intents, data sources, actions, approvals, etc.
-Ask the user these questions, then put answers into ONE workflow() call.
-
-## Reference (understand options, not for manual building)
-
-  template(pattern="intent-routing")  // See pattern structure
-  template(patterns=true)             // List available patterns
-  template(widgets="voice")           // Widget reference
-
-⚠️ Do NOT copy/paste configs from these - MCP generates them internally.`,
-            inputSchema: {
-                type: "object",
-                properties: {
-                    // Workflow patterns
-                    pattern: {
-                        type: "string",
-                        enum: ["simple-kb-search", "intent-routing", "multi-source-search", "tool-calling", "hitl-approval", "document-processing", "guardrails-pattern"],
-                        description: "Get specific workflow pattern"
-                    },
-                    patterns: { type: "boolean", description: "List all workflow patterns" },
-                    // Widget reference
-                    widgets: {
-                        type: "string",
-                        enum: ["voice", "chat", "dashboard"],
-                        description: "Get widget reference for persona type"
-                    },
-                    // Persona config template
-                    config: {
-                        type: "string",
-                        enum: ["voice", "chat", "dashboard"],
-                        description: "Get config template (voice settings, etc.)"
-                    },
-                    // Qualifying questions
-                    questions: { type: "boolean", description: "Get qualifying questions" },
-                    category: {
-                        type: "string",
-                        enum: ["AI Type", "Intent", "Data", "Actions", "Validation", "Output", "Voice", "Guardrails"],
-                        description: "Filter questions by category"
-                    },
-                    required_only: { type: "boolean", description: "Only required questions" },
-                    // Filter
-                    type: {
-                        type: "string",
-                        enum: ["voice", "chat", "dashboard"],
-                        description: "Filter patterns by persona type"
-                    },
-                },
-                required: [],
-            },
-        },
-        // ═══════════════════════════════════════════════════════════════════════
-        // 6. KNOWLEDGE - DEPRECATED: Use data() instead
-        // ═══════════════════════════════════════════════════════════════════════
-        {
-            name: "knowledge",
-            description: `DEPRECATED: Use \`data()\` instead. This tool routes to data internally.
-
-## Migration Guide
-
-| OLD (deprecated) | NEW |
-|------------------|-----|
-| knowledge(persona_id="abc", mode="list") | data(persona_id="abc", mode="list") |
-| knowledge(persona_id="abc", mode="upload", file="...") | data(persona_id="abc", mode="upload", file="...") |
-| knowledge(persona_id="abc", mode="delete", file_id="...") | data(persona_id="abc", mode="delete", file_id="...") |
-| knowledge(persona_id="abc", mode="status") | data(persona_id="abc", mode="embedding") |
-| knowledge(persona_id="abc", mode="toggle", enabled=true) | data(persona_id="abc", mode="embedding", enabled=true) |
-
-The \`data\` tool now also supports generation:
-  data(persona_id="abc", mode="generate", input="...")
-  data(persona_id="abc", mode="generate", from="customer", count=5)
-
-This tool still works but shows a deprecation warning.`,
-            inputSchema: withEnv({
-                persona_id: { type: "string", description: "AI Employee ID (required)" },
-                mode: {
-                    type: "string",
-                    enum: ["list", "aggregates", "upload", "delete", "status", "toggle", "attach", "dashboard_rows", "dashboard_clone"],
-                    description: "Operation. Default: 'list'"
-                },
-                // List flags
-                page: { type: "number", description: "Page number (default: 1)" },
-                limit: { type: "number", description: "Items per page (default: 50)" },
-                widget_name: { type: "string", description: "Widget name (default: 'fileUpload')" },
-                // Upload flags
-                file: { type: "string", description: "File path for upload" },
-                tags: { type: "string", description: "Tags for uploaded file" },
-                // Delete flags
-                file_id: { type: "string", description: "File ID to delete" },
-                // Toggle flags
-                enabled: { type: "boolean", description: "Enable/disable embedding" },
-                // Attach flags
-                node_name: { type: "string", description: "Workflow node name to attach data source to (e.g., 'knowledge_search_1')" },
-                // Dashboard clone flags
-                source_persona_id: { type: "string", description: "Source persona ID for dashboard clone" },
-                sanitize: { type: "boolean", description: "Sanitize/obfuscate data during clone" },
-                sanitize_examples: { type: "array", items: { type: "string" }, description: "Additional sensitive items to sanitize" },
-            }, ["persona_id"]),
-        },
-        // ═══════════════════════════════════════════════════════════════════════
-        // 7. REFERENCE - All reference info (envs, actions, templates, patterns, concepts, guidance)
-        // ═══════════════════════════════════════════════════════════════════════
-        {
-            name: "reference",
-            description: `All reference information: environments, actions, templates, patterns, concepts, guidance.
-
-**Environments**:
-  reference(type="envs")
-
-**Actions** (workflow building blocks):
-  reference(type="actions")                    # List all
-  reference(type="actions", query="email")     # Search
-  reference(type="actions", id="send_email")   # Get specific
-  reference(type="actions", suggest="IT helpdesk")  # Suggest for use case
-  reference(type="actions", categories=true)   # List categories
-
-**Templates & Patterns**:
-  reference(type="templates")                  # List persona templates
-  reference(type="patterns")                   # List workflow patterns
-  reference(type="patterns", pattern="intent-routing")  # Get specific
-
-**Widgets**:
-  reference(type="widgets", persona_type="voice")
-
-**Concepts & Guidance**:
-  reference(concept="HITL")
-  reference(guidance="categorizer-routing")
-  reference(questions=true)  # Qualifying questions
-
-**Debugging**:
-  reference(mistakes=true)
-  reference(checklist=true)
-  reference(execution=true)
-
-**Validation**:
-  reference(check_types={source: "CHAT_CONVERSATION", target: "TEXT"})`,
-            inputSchema: withEnv({
-                // Type selector (v2)
-                type: {
-                    type: "string",
-                    enum: ["envs", "actions", "templates", "patterns", "widgets", "concepts"],
-                    description: "What type of reference information"
-                },
-                // Actions
-                id: { type: "string", description: "Action ID for details" },
-                query: { type: "string", description: "Search actions by name" },
-                suggest: { type: "string", description: "Suggest actions for use case" },
-                categories: { type: "boolean", description: "List action categories" },
-                category: { type: "string", description: "Filter by category" },
-                include_docs: { type: "boolean", description: "Include full documentation" },
-                limit: { type: "number", description: "Max results" },
-                // Patterns
-                pattern: {
-                    type: "string",
-                    enum: ["simple-kb-search", "intent-routing", "multi-source-search", "tool-calling", "hitl-approval", "document-processing", "guardrails-pattern"],
-                    description: "Get specific pattern"
-                },
-                // Widgets
-                persona_type: { type: "string", enum: ["voice", "chat", "dashboard"], description: "Persona type for widgets" },
-                // Concepts
-                concept: { type: "string", description: "Get definition of platform term" },
-                concepts: { type: "boolean", description: "List all platform concepts" },
-                // Questions
-                questions: { type: "boolean", description: "Get qualifying questions" },
-                required_only: { type: "boolean", description: "Only required questions" },
-                // Guidance
-                guidance: {
-                    type: "string",
-                    enum: [
-                        "categorizer-routing", "type-compatibility", "named-inputs",
-                        "hitl-patterns", "hitl-policy", "multi-source-search", "voice-tool-calling",
-                        "guardrails", "output-mapping", "workflow-execution", "conversation-vs-query",
-                        "workflow-structure", "search-node-timing", "node-execution-conditions",
-                        "array-preservation", "search-filtering", "fallback-response-inputs",
-                        "separate-vs-merged-inputs", "folder-path-filtering", "automated-extraction-json"
-                    ],
-                    description: "Get guidance on topic"
-                },
-                // Debugging
-                mistakes: { type: "boolean", description: "Get common mistakes list" },
-                checklist: { type: "boolean", description: "Get debug checklist" },
-                execution: { type: "boolean", description: "Get workflow execution model" },
-                // Validation
-                check_types: {
-                    type: "object",
-                    properties: {
-                        source: { type: "string", description: "Source output type" },
-                        target: { type: "string", description: "Target input type" },
-                    },
-                    description: "Check type compatibility"
-                },
-                validate_prompt: { type: "string", description: "Validate workflow prompt" },
-            }),
-        },
-        // ═══════════════════════════════════════════════════════════════════════
-        // 7b. DATA - Manage persona data (files + generation)
-        // ═══════════════════════════════════════════════════════════════════════
-        {
-            name: "data",
-            description: `Manage AI Employee data: list, upload, generate, modify, sanitize, delete.
-
-## Mode is REQUIRED for clarity. If omitted, tool will clarify.
-
-**List files**:
-  data(persona_id="abc", mode="list")
-  data(persona_id="abc", mode="list", limit=50)
-
-**Get specific file**:
-  data(persona_id="abc", mode="get", file_id="file-123")
-
-**Upload file**:
-  data(persona_id="abc", mode="upload", file="/path/to/doc.pdf")
-
-**Generate new content** (via Document Generation API):
-  data(persona_id="abc", mode="generate", input="Generate 5 customer profiles for B2B SaaS")
-  data(persona_id="abc", mode="generate", from="demo-sales-sdr")
-  data(persona_id="abc", mode="generate", from="customer", count=10)
-
-**Modify existing document**:
-  data(persona_id="abc", mode="modify", file_id="file-123", input="Rewrite for legal compliance")
-
-**Sanitize data** (replace PII):
-  data(persona_id="abc", mode="sanitize")
-  data(persona_id="abc", mode="sanitize", include_workflow=true)
-
-**Delete file**:
-  data(persona_id="abc", mode="delete", file_id="file-123")
-
-**Embedding status/toggle**:
-  data(persona_id="abc", mode="embedding")
-  data(persona_id="abc", mode="embedding", enabled=true)
-
-**List available templates**:
-  data(mode="templates")
-  data(mode="templates", template="customer")`,
-            inputSchema: withEnv({
-                persona_id: { type: "string", description: "AI Employee ID (required for most operations)" },
-                mode: {
-                    type: "string",
-                    enum: ["list", "get", "upload", "generate", "modify", "sanitize", "delete", "embedding", "templates"],
-                    description: "Operation to perform. REQUIRED for clarity - tool will ask if omitted."
-                },
-                // === Identify existing resource ===
-                file_id: { type: "string", description: "File/document ID for get/modify/delete" },
-                // === Generation params ===
-                from: { type: "string", description: "Template name for generate mode (e.g., 'demo-sales-sdr', 'customer', 'faq')" },
-                input: { type: "string", description: "Natural language instructions for generate/modify" },
-                count: { type: "number", description: "Number of items to generate (default: 1)" },
-                format: {
-                    type: "string",
-                    enum: ["markdown", "json", "html"],
-                    description: "Output format for generation (default: markdown)"
-                },
-                data: { type: "object", description: "Additional data context for generation" },
-                // === Template info ===
-                template: { type: "string", description: "Get specific template details" },
-                // === List options ===
-                limit: { type: "number", description: "Max results (default: 50)" },
-                page: { type: "number", description: "Page number (default: 1)" },
-                // === Upload params ===
-                file: { type: "string", description: "File path for upload" },
-                tags: { type: "string", description: "Tags for uploaded file" },
-                // === Sanitize options ===
-                include_workflow: { type: "boolean", description: "Also sanitize workflow config" },
-                sanitize_examples: { type: "array", items: { type: "string" }, description: "Additional sensitive items to sanitize" },
-                // === Embedding toggle ===
-                enabled: { type: "boolean", description: "Enable/disable embedding" },
-            }),
-        },
-        // ═══════════════════════════════════════════════════════════════════════
-        // 8. SYNC - Environment synchronization
-        // ═══════════════════════════════════════════════════════════════════════
-        {
-            name: "sync",
-            description: `Sync AI Employees across environments.
-
-**Sync single**:
-  sync(id="IT Support", target="dev")
-  sync(id="abc-123", target="staging", dry_run=true)
-
-**Sync all tagged**:
-  sync(target="dev", scope="all")
-
-**Status**:
-  sync(mode="status", id="abc-123")
-  sync(mode="status", list_synced=true)
-
-**Config**:
-  sync(mode="config")`,
-            inputSchema: {
-                type: "object",
-                properties: {
-                    // What to sync
-                    id: { type: "string", description: "Persona ID or name" },
-                    // Deprecated alias (backwards compatibility)
-                    identifier: { type: "string", deprecated: true, description: "DEPRECATED: use id. Persona ID or name" },
-                    // Mode
-                    mode: {
-                        type: "string",
-                        enum: ["run", "status", "config"],
-                        description: "Operation. Default: 'run'"
-                    },
-                    // Sync flags
-                    source: { type: "string", description: "Source environment (default: current)" },
-                    target: { type: "string", description: "Target environment (required for run)" },
-                    scope: {
-                        type: "string",
-                        enum: ["one", "all"],
-                        description: "Sync one or all tagged"
-                    },
-                    dry_run: { type: "boolean", description: "Simulate without changes" },
-                    include_status: { type: "boolean", description: "Also sync enabled/disabled" },
-                    // Status flags
-                    list_synced: { type: "boolean", description: "List all synced personas" },
-                    master_env: { type: "string", description: "Filter by master environment" },
-                    env: { type: "string", description: "Target environment for status queries" },
-                },
-                required: [],
-            },
-        },
-        // ═══════════════════════════════════════════════════════════════════════
-        // 9. DEMO - DEPRECATED: Use data() and persona() instead
-        // ═══════════════════════════════════════════════════════════════════════
-        {
-            name: "demo",
-            description: `DEPRECATED: Use \`data()\` and \`persona()\` instead. This tool routes to them internally.
-
-## Migration Guide
-
-| OLD (deprecated) | NEW |
-|------------------|-----|
-| demo(mode="kit", persona_id="...", scenario="sales-sdr") | persona(from="demo-sales-sdr", include_data=true) |
-| demo(mode="generate", entity="customer", data={...}) | data(persona_id="...", mode="generate", from="customer", data={...}) |
-| demo(mode="scenarios") | data(mode="templates") |
-| demo(mode="template", entity="customer") | data(mode="templates", template="customer") |
-
-The \`data\` tool now supports document generation:
-  data(persona_id="abc", mode="generate", input="Generate 5 customer profiles")
-  data(persona_id="abc", mode="generate", from="demo-sales-sdr")
-
-The \`persona\` tool supports demo kit creation:
-  persona(from="demo-sales-sdr", name="My Demo", include_data=true)
-
-This tool still works but shows a deprecation warning.`,
-            inputSchema: {
-                type: "object",
-                properties: {
-                    mode: {
-                        type: "string",
-                        enum: ["kit", "validate_kit", "scenarios", "consolidate", "generate", "validate", "template"],
-                        description: "Operation"
-                    },
-                    // Kit generation flags
-                    persona_id: { type: "string", description: "Persona ID for kit generation" },
-                    scenario: {
-                        type: "string",
-                        enum: ["sales-sdr", "support-tier1", "hr-assistant"],
-                        description: "Demo scenario template"
-                    },
-                    custom_qa: {
-                        type: "array",
-                        description: "Custom Q&A pairs [{question, answer}]"
-                    },
-                    // Consolidate flags
-                    source: { type: "string", description: "Source directory" },
-                    output: { type: "string", description: "Output directory" },
-                    primary: { type: "string", description: "Primary JSON file" },
-                    joins: {
-                        type: "array",
-                        description: "Files to join [{file, on, as}]"
-                    },
-                    // Entity type
-                    entity: {
-                        type: "string",
-                        enum: ["customer", "product", "employee", "faq", "policy", "benefit", "company"],
-                        description: "Entity type"
-                    },
-                    // Generate flags
-                    data: { type: "object", description: "Entity data for generation" },
-                    related: { type: "object", description: "Related data to include" },
-                    // Validate flags
-                    file: { type: "string", description: "File path to validate" },
-                    content: { type: "string", description: "Content to validate" },
-                    // Common
-                    tags: { type: "string", description: "Tags for metadata" },
-                },
-                required: [],
-            },
-        },
-    ];
-}
-/**
- * Tool name mapping for backward compatibility
- * Maps old tool names to new consolidated tool + args
- */
-export const LEGACY_TOOL_MAPPING = {
-    // Environment
-    list_environments: { tool: "env", transform: () => ({}) },
-    // Persona tools → persona
-    get_persona: { tool: "persona", transform: (a) => ({ ...a, mode: "get" }) },
-    find_personas: { tool: "persona", transform: (a) => ({ ...a, all: true }) },
-    create_ai_employee: { tool: "persona", transform: (a) => ({ ...a, mode: "create" }) },
-    update_ai_employee: { tool: "persona", transform: (a) => ({ ...a, mode: "update", id: a.persona_id }) },
-    compare_ai_employees: { tool: "persona", transform: (a) => ({ id: a.persona_id_1, mode: "compare", compare_to: a.persona_id_2, compare_env: a.env_2 }) },
-    list_ai_employee_templates: { tool: "persona", transform: () => ({ templates: true }) },
-    // Workflow tools → workflow
-    deploy_workflow: { tool: "workflow", transform: (a) => ({ ...a, mode: "deploy" }) },
-    optimize_workflow: { tool: "workflow", transform: (a) => ({ ...a, mode: "optimize", id: a.identifier }) },
-    compile_workflow: { tool: "workflow", transform: (a) => ({ ...a, mode: "compile" }) },
-    analyze_workflow: { tool: "workflow", transform: (a) => ({ ...a, mode: "analyze" }) },
-    detect_workflow_issues: { tool: "workflow", transform: (a) => ({ ...a, mode: "analyze" }) },
-    validate_workflow_connections: { tool: "workflow", transform: (a) => ({ ...a, mode: "analyze", include: ["connections"] }) },
-    suggest_workflow_fixes: { tool: "workflow", transform: (a) => ({ ...a, mode: "analyze", include: ["fixes"] }) },
-    compare_workflow_versions: { tool: "workflow", transform: (a) => ({ persona_id: a.persona_id_before, mode: "compare", compare_to: a.persona_id_after }) },
-    get_workflow_metrics: { tool: "workflow", transform: (a) => ({ ...a, mode: "analyze", include: ["metrics"] }) },
-    // Action tools → action
-    get_workflow_action: { tool: "action", transform: (a) => a },
-    find_workflow_actions: { tool: "action", transform: (a) => ({ ...a, all: true }) },
-    list_auto_builder_agents: { tool: "action", transform: (a) => ({ ...a, all: true, include_docs: true }) },
-    get_auto_builder_agent: { tool: "action", transform: (a) => ({ id: a.action_name, include_docs: true }) },
-    suggest_agents_for_use_case: { tool: "action", transform: (a) => ({ suggest: a.use_case }) },
-    // Template tools → template
-    get_workflow_pattern: { tool: "template", transform: (a) => ({ pattern: a.pattern_name }) },
-    list_workflow_patterns: { tool: "template", transform: (a) => ({ patterns: true, type: a.persona_type }) },
-    get_widget_reference: { tool: "template", transform: (a) => ({ widgets: a.persona_type }) },
-    get_voice_persona_template: { tool: "template", transform: () => ({ config: "voice" }) },
-    get_qualifying_questions: { tool: "template", transform: (a) => ({ questions: true, ...a }) },
-    // Knowledge tools → data (knowledge is deprecated)
-    upload_data_source: { tool: "data", transform: (a) => ({ ...a, mode: "upload", file: a.file_path }) },
-    delete_data_source: { tool: "data", transform: (a) => ({ ...a, mode: "delete" }) },
-    list_data_sources: { tool: "data", transform: (a) => ({ ...a, mode: "list" }) },
-    get_embedding_status: { tool: "data", transform: (a) => ({ ...a, mode: "embedding" }) },
-    toggle_embedding: { tool: "data", transform: (a) => ({ ...a, mode: "embedding" }) },
-    // Reference tools → reference
-    get_platform_concept: { tool: "reference", transform: (a) => ({ concept: a.term }) },
-    list_platform_concepts: { tool: "reference", transform: () => ({ concepts: true }) },
-    get_common_mistakes: { tool: "reference", transform: () => ({ mistakes: true }) },
-    get_debug_checklist: { tool: "reference", transform: () => ({ checklist: true }) },
-    get_workflow_execution_model: { tool: "reference", transform: () => ({ execution: true }) },
-    get_auto_builder_guidance: { tool: "reference", transform: (a) => ({ guidance: a.topic }) },
-    validate_workflow_prompt: { tool: "reference", transform: (a) => ({ validate_prompt: a.prompt }) },
-    check_type_compatibility: { tool: "reference", transform: (a) => ({ check_types: { source: a.source_type, target: a.target_type } }) },
-    // Demo data tools → data (demo is deprecated)
-    consolidate_demo_data: { tool: "demo", transform: (a) => ({ mode: "consolidate", source: a.source_dir, output: a.output_dir, ...a }) },
-    generate_demo_document: { tool: "data", transform: (a) => ({ mode: "generate", from: a.entity_type, data: a.data }) },
-    validate_demo_document: { tool: "demo", transform: (a) => ({ mode: "validate", file: a.file_path, content: a.content }) },
-    get_demo_data_template: { tool: "data", transform: (a) => ({ mode: "templates", template: a.entity_type }) },
-};
-// Summary of consolidation
-export const CONSOLIDATION_SUMMARY = {
-    before: 45,
-    after: 7,
-    active_tools: [
-        { name: "env", replaces: ["list_environments"] },
-        { name: "persona", replaces: ["get_persona", "find_personas", "create_ai_employee", "update_ai_employee", "compare_ai_employees", "list_ai_employee_templates"] },
-        { name: "data", replaces: ["upload_data_source", "delete_data_source", "list_data_sources", "get_embedding_status", "toggle_embedding", "generate_demo_document", "get_demo_data_template"], note: "Also includes document generation" },
-        { name: "action", replaces: ["get_workflow_action", "find_workflow_actions", "list_auto_builder_agents", "get_auto_builder_agent", "suggest_agents_for_use_case"] },
-        { name: "template", replaces: ["get_workflow_pattern", "list_workflow_patterns", "get_widget_reference", "get_voice_persona_template", "get_qualifying_questions"] },
-        { name: "reference", replaces: ["get_platform_concept", "list_platform_concepts", "get_common_mistakes", "get_debug_checklist", "get_workflow_execution_model", "get_auto_builder_guidance", "validate_workflow_prompt", "check_type_compatibility"] },
-        { name: "sync", replaces: ["sync", "sync_info"] },
-    ],
-    deprecated_tools: [
-        { name: "workflow", status: "deprecated", use_instead: "persona" },
-        { name: "knowledge", status: "deprecated", use_instead: "data" },
-        { name: "demo", status: "deprecated", use_instead: "data + persona" },
-    ],
-    // Legacy mapping preserved for backwards compatibility
-    tools: [
-        { name: "env", replaces: ["list_environments"] },
-        { name: "persona", replaces: ["get_persona", "find_personas", "create_ai_employee", "update_ai_employee", "compare_ai_employees", "list_ai_employee_templates"] },
-        { name: "workflow", replaces: ["workflow", "deploy_workflow", "optimize_workflow", "compile_workflow", "analyze_workflow", "detect_workflow_issues", "validate_workflow_connections", "suggest_workflow_fixes", "compare_workflow_versions", "get_workflow_metrics"], deprecated: true },
-        { name: "action", replaces: ["get_workflow_action", "find_workflow_actions", "list_auto_builder_agents", "get_auto_builder_agent", "suggest_agents_for_use_case"] },
-        { name: "template", replaces: ["get_workflow_pattern", "list_workflow_patterns", "get_widget_reference", "get_voice_persona_template", "get_qualifying_questions"] },
-        { name: "knowledge", replaces: ["upload_data_source", "delete_data_source", "list_data_sources", "get_embedding_status", "toggle_embedding"], deprecated: true },
-        { name: "data", replaces: ["generate_demo_document", "get_demo_data_template"] },
-        { name: "reference", replaces: ["get_platform_concept", "list_platform_concepts", "get_common_mistakes", "get_debug_checklist", "get_workflow_execution_model", "get_auto_builder_guidance", "validate_workflow_prompt", "check_type_compatibility"] },
-        { name: "sync", replaces: ["sync", "sync_info"] },
-        { name: "demo", replaces: ["consolidate_demo_data", "validate_demo_document"], deprecated: true },
-    ],
-};