ema-mcp-toolkit 0.2.0

package/dist/mcp/tools-legacy.js

@@ -0,0 +1,736 @@
+/**
+ * Legacy MCP Tools (DEPRECATED - DISABLED BY DEFAULT)
+ *
+ * ⚠️  These tools are DISABLED by default to prevent LLM confusion.
+ * ⚠️  Only enable for migration period: EMA_ENABLE_LEGACY_TOOLS=true
+ *
+ * New integrations MUST use the consolidated tools from tools-consolidated.ts.
+ *
+ * Migration guide:
+ * - get_persona, find_personas → persona
+ * - get_workflow_action, find_workflow_actions → action
+ * - analyze_workflow, detect_workflow_issues, validate_workflow_connections, suggest_workflow_fixes → workflow(mode="analyze")
+ * - deploy_workflow, optimize_workflow → workflow(mode="deploy") or workflow(mode="optimize")
+ * - list_auto_builder_agents, get_auto_builder_agent, suggest_agents_for_use_case → action
+ * - get_workflow_pattern, list_workflow_patterns → template
+ * - check_type_compatibility, get_widget_reference, get_qualifying_questions → template
+ * - get_voice_persona_template → template(config="voice")
+ * - validate_workflow_prompt, get_auto_builder_guidance → reference
+ * - get_platform_concept, list_platform_concepts → reference
+ * - get_common_mistakes, get_debug_checklist, get_workflow_execution_model → reference
+ * - compare_workflow_versions, get_workflow_metrics → workflow(mode="analyze")
+ * - compile_workflow → workflow(mode="compile")
+ * - upload_data_source, delete_data_source, list_data_sources → knowledge
+ * - get_embedding_status, toggle_embedding → knowledge
+ * - sync, sync_info → sync
+ */
+/**
+ * Generate legacy tool definitions
+ * @param envNames Available environment names
+ * @param defaultEnv Default environment name
+ */
+export function generateLegacyTools(envNames, defaultEnv) {
+    const envDesc = `Target environment. Available: ${envNames.join(", ") || "demo, staging, dev"}. Default: ${defaultEnv}`;
+    return [
+        // ═══════════════════════════════════════════════════════════════════════════
+        // ENVIRONMENT
+        // ═══════════════════════════════════════════════════════════════════════════
+        {
+            name: "list_environments",
+            description: "⚠️ DEPRECATED: Use `env` instead.\n\nList all available Ema environments that can be targeted. Shows which environment is the default.",
+            inputSchema: { type: "object", properties: {}, required: [] },
+        },
+        // ═══════════════════════════════════════════════════════════════════════════
+        // PERSONAS (AI Employees)
+        // ═══════════════════════════════════════════════════════════════════════════
+        {
+            name: "get_persona",
+            description: `⚠️ DEPRECATED: Use \`persona(id)\` instead.
+
+🎯 UNIFIED persona retrieval. Replaces: get_ai_employee, get_ai_employee_by_name, get_ai_employee_full, get_ai_employee_fingerprint.
+
+**Options**:
+- include_workflow: Get full workflow_def (slower, needed for analysis/editing)
+- include_fingerprint: Get config hash for sync detection
+
+**Examples**:
+- get_persona(identifier="abc-123") - Basic info by ID
+- get_persona(identifier="IT Support Bot") - Basic info by name  
+- get_persona(identifier="abc-123", include_workflow=true) - Full workflow
+- get_persona(identifier="abc-123", include_fingerprint=true) - With hash`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    identifier: { type: "string", description: "Persona ID (UUID) or exact name" },
+                    include_workflow: { type: "boolean", description: "Include full workflow_def (default: false)" },
+                    include_fingerprint: { type: "boolean", description: "Include config hash (default: false)" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: ["identifier"],
+            },
+        },
+        {
+            name: "find_personas",
+            description: `⚠️ DEPRECATED: Use \`persona(all=true)\` instead.
+
+🔍 UNIFIED persona search. Replaces: list_ai_employees, search_ai_employees.
+
+**Examples**:
+- find_personas() - List all with basic info
+- find_personas(query="support") - Search by name
+- find_personas(status="active") - Filter by status
+- find_personas(limit=10) - Limit results`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: { type: "string", description: "Search term (name 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)" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: [],
+            },
+        },
+        {
+            name: "create_ai_employee",
+            description: `⚠️ DEPRECATED: Use \`persona(mode="create")\` instead.
+
+Create a new AI Employee (persona). REQUIRES either template_id, source_persona_id, OR persona_type.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    name: { type: "string", description: "Name for the new AI Employee" },
+                    description: { type: "string", description: "Description" },
+                    template_id: { type: "string", description: "Template ID to use" },
+                    source_persona_id: { type: "string", description: "Clone from existing persona" },
+                    persona_type: { type: "string", enum: ["voice", "chat", "dashboard"], description: "Create from default template" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: ["name"],
+            },
+        },
+        {
+            name: "update_ai_employee",
+            description: `⚠️ DEPRECATED: Use \`persona(mode="update")\` instead.
+
+Update AI Employee METADATA (name, description, settings). For workflow changes, use deploy_workflow instead.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    persona_id: { type: "string", description: "The AI Employee ID to update" },
+                    name: { type: "string", description: "New name" },
+                    description: { type: "string", description: "New description" },
+                    proto_config: { type: "object", description: "Persona configuration (voice settings, etc.)" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: ["persona_id"],
+            },
+        },
+        {
+            name: "compare_ai_employees",
+            description: `⚠️ DEPRECATED: Use \`persona(mode="compare")\` instead.
+
+Compare two AI Employees to see their differences. Can compare across environments.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    id1: { type: "string", description: "First persona ID" },
+                    id2: { type: "string", description: "Second persona ID" },
+                    env1: { type: "string", description: "Environment for first persona" },
+                    env2: { type: "string", description: "Environment for second persona" },
+                },
+                required: ["id1", "id2"],
+            },
+        },
+        {
+            name: "list_ai_employee_templates",
+            description: `⚠️ DEPRECATED: Use \`persona(templates=true)\` instead.
+
+List all unique AI Employee templates used by existing AI Employees.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    env: { type: "string", description: envDesc },
+                },
+                required: [],
+            },
+        },
+        // ═══════════════════════════════════════════════════════════════════════════
+        // WORKFLOW OPERATIONS
+        // ═══════════════════════════════════════════════════════════════════════════
+        {
+            name: "deploy_workflow",
+            description: `⚠️ DEPRECATED: Use \`workflow(mode="deploy")\` instead.
+
+Deploy a WORKFLOW to an AI Employee. Validates and can auto-fix issues.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    persona_id: { type: "string", description: "Target AI Employee ID" },
+                    workflow_def: { type: "object", description: "The workflow JSON" },
+                    proto_config: { type: "object", description: "Persona config to merge" },
+                    validate_first: { type: "boolean", description: "Validate before deploy (default: true)" },
+                    auto_fix: { type: "boolean", description: "Auto-fix issues (default: false)" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: ["persona_id"],
+            },
+        },
+        {
+            name: "optimize_workflow",
+            description: `⚠️ DEPRECATED: Use \`workflow(mode="optimize")\` instead.
+
+🔧 ONE-CLICK workflow analyzer & fixer.
+
+**Fix existing workflow** (recommended):
+- optimize_workflow("Advisor Communications Assistant")
+- optimize_workflow(persona_id="abc-123", preview=true)
+
+Automatically: fetches workflow → analyzes → applies fixes → deploys.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    identifier: { type: "string", description: "Persona name or ID" },
+                    persona_id: { type: "string", description: "Target persona ID (for generate mode)" },
+                    prompt: { type: "string", description: "For generating new workflows" },
+                    type: { type: "string", enum: ["voice", "chat"], description: "Persona type (default: chat)" },
+                    preview: { type: "boolean", description: "Preview changes without deploying" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: [],
+            },
+        },
+        // ═══════════════════════════════════════════════════════════════════════════
+        // ACTIONS (Workflow Nodes/Agents)
+        // ═══════════════════════════════════════════════════════════════════════════
+        {
+            name: "get_workflow_action",
+            description: `⚠️ DEPRECATED: Use \`action(id)\` instead.
+
+🎯 UNIFIED action retrieval. Replaces: get_action, get_action_by_name.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    identifier: { type: "string", description: "Action ID or name (e.g., 'chat_categorizer')" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: ["identifier"],
+            },
+        },
+        {
+            name: "find_workflow_actions",
+            description: `⚠️ DEPRECATED: Use \`action(all=true)\` instead.
+
+🔍 UNIFIED action search. Replaces: list_actions, search_actions, list_action_categories.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: { type: "string", description: "Search term" },
+                    category: { type: "string", description: "Filter by category" },
+                    persona_id: { type: "string", description: "List actions in this workflow" },
+                    enabled: { type: "boolean", description: "Filter by enabled (default: true)" },
+                    limit: { type: "number", description: "Max results (default: 50)" },
+                    categories: { type: "boolean", description: "Just list categories" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: [],
+            },
+        },
+        // ═══════════════════════════════════════════════════════════════════════════
+        // SYNC
+        // ═══════════════════════════════════════════════════════════════════════════
+        {
+            name: "sync_info",
+            description: `📊 UNIFIED sync info. Replaces: sync_status, sync_config, sync_options, get_sync_tag, is_persona_synced, list_synced_personas.
+
+**Examples**:
+- sync_info(mode="status") - Current sync status
+- sync_info(mode="config") - View sync configuration
+- sync_info(persona_id="abc-123") - Check if persona is synced`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    mode: { type: "string", enum: ["status", "config", "options", "tag"], description: "Info type" },
+                    persona_id: { type: "string", description: "Check specific persona" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: [],
+            },
+        },
+        // ═══════════════════════════════════════════════════════════════════════════
+        // AUTO BUILDER REFERENCE (Static Knowledge)
+        // ═══════════════════════════════════════════════════════════════════════════
+        {
+            name: "list_auto_builder_agents",
+            description: `⚠️ DEPRECATED: Use \`action(all=true, include_docs=true)\` instead.
+
+📚 REFERENCE: Get Auto Builder agent DOCUMENTATION by category.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    category: { type: "string", description: "Filter by category" },
+                },
+                required: [],
+            },
+        },
+        {
+            name: "get_auto_builder_agent",
+            description: `⚠️ DEPRECATED: Use \`action(id, include_docs=true)\` instead.
+
+📚 REFERENCE: Get documentation for a specific Auto Builder agent.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    name: { type: "string", description: "Agent name (e.g., 'chat_categorizer')" },
+                },
+                required: ["name"],
+            },
+        },
+        {
+            name: "suggest_agents_for_use_case",
+            description: `⚠️ DEPRECATED: Use \`action(suggest="use case")\` instead.
+
+Get agent recommendations for a use case.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    use_case: { type: "string", description: "Description of the use case" },
+                },
+                required: ["use_case"],
+            },
+        },
+        // ═══════════════════════════════════════════════════════════════════════════
+        // WORKFLOW PATTERNS & TEMPLATES
+        // ═══════════════════════════════════════════════════════════════════════════
+        {
+            name: "get_workflow_pattern",
+            description: `⚠️ DEPRECATED: Use \`template(pattern="name")\` instead.
+
+Get a specific workflow pattern.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    pattern_name: { type: "string", description: "Pattern name" },
+                },
+                required: ["pattern_name"],
+            },
+        },
+        {
+            name: "list_workflow_patterns",
+            description: `⚠️ DEPRECATED: Use \`template(patterns=true)\` instead.
+
+List all workflow patterns.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    type: { type: "string", enum: ["voice", "chat", "dashboard"], description: "Filter by type" },
+                },
+                required: [],
+            },
+        },
+        {
+            name: "check_type_compatibility",
+            description: `⚠️ DEPRECATED: Use \`template(type_check={source, target})\` instead.
+
+Check if two workflow types are compatible.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    source_type: { type: "string", description: "Source type name" },
+                    target_type: { type: "string", description: "Target type name" },
+                },
+                required: ["source_type", "target_type"],
+            },
+        },
+        {
+            name: "get_widget_reference",
+            description: `⚠️ DEPRECATED: Use \`template(widgets="type")\` instead.
+
+Get widget reference for a persona type.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    persona_type: { type: "string", enum: ["voice", "chat", "dashboard"] },
+                },
+                required: ["persona_type"],
+            },
+        },
+        {
+            name: "get_qualifying_questions",
+            description: `⚠️ DEPRECATED: Use \`template(questions=true)\` instead.
+
+Get qualifying questions for requirements gathering.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    category: { type: "string", description: "Filter by category" },
+                    required_only: { type: "boolean", description: "Only required questions" },
+                },
+                required: [],
+            },
+        },
+        {
+            name: "get_voice_persona_template",
+            description: `⚠️ DEPRECATED: Use \`template(config="voice")\` instead.
+
+Get complete Voice AI persona template.`,
+            inputSchema: { type: "object", properties: {}, required: [] },
+        },
+        {
+            name: "validate_workflow_prompt",
+            description: `⚠️ DEPRECATED: Use \`reference(validate_prompt="...")\` instead.
+
+Validate a workflow generation prompt.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    prompt: { type: "string", description: "The prompt to validate" },
+                },
+                required: ["prompt"],
+            },
+        },
+        {
+            name: "get_auto_builder_guidance",
+            description: `⚠️ DEPRECATED: Use \`reference(topic="...")\` instead.
+
+Get guidance on Auto Builder topics.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    topic: { type: "string", description: "Topic name" },
+                },
+                required: [],
+            },
+        },
+        // ═══════════════════════════════════════════════════════════════════════════
+        // PLATFORM CONCEPTS
+        // ═══════════════════════════════════════════════════════════════════════════
+        {
+            name: "get_platform_concept",
+            description: `⚠️ DEPRECATED: Use \`reference(concept="term")\` instead.
+
+Get explanation of a platform concept.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    term: { type: "string", description: "Concept term to look up" },
+                },
+                required: ["term"],
+            },
+        },
+        {
+            name: "list_platform_concepts",
+            description: `⚠️ DEPRECATED: Use \`reference(concepts=true)\` instead.
+
+List all platform concepts.`,
+            inputSchema: { type: "object", properties: {}, required: [] },
+        },
+        {
+            name: "get_common_mistakes",
+            description: `⚠️ DEPRECATED: Use \`reference(mistakes=true)\` instead.
+
+Get common workflow mistakes and how to avoid them.`,
+            inputSchema: { type: "object", properties: {}, required: [] },
+        },
+        {
+            name: "get_debug_checklist",
+            description: `⚠️ DEPRECATED: Use \`reference(debug=true)\` instead.
+
+Get workflow debugging checklist.`,
+            inputSchema: { type: "object", properties: {}, required: [] },
+        },
+        {
+            name: "get_workflow_execution_model",
+            description: `⚠️ DEPRECATED: Use \`reference(execution_model=true)\` instead.
+
+Get workflow execution model documentation.`,
+            inputSchema: { type: "object", properties: {}, required: [] },
+        },
+        // ═══════════════════════════════════════════════════════════════════════════
+        // WORKFLOW ANALYSIS (Individual tools - now unified in workflow)
+        // ═══════════════════════════════════════════════════════════════════════════
+        {
+            name: "analyze_workflow",
+            description: `⚠️ DEPRECATED: Use \`workflow(persona_id, mode="analyze")\` instead.
+
+Full workflow analysis with issues, connections, fixes, and metrics.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    persona_id: { type: "string", description: "Persona ID to analyze" },
+                    workflow_def: { type: "object", description: "Or provide workflow JSON directly" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: [],
+            },
+        },
+        {
+            name: "detect_workflow_issues",
+            description: `⚠️ DEPRECATED: Use \`workflow(mode="analyze", include=["issues"])\` instead.
+
+Detect issues in a workflow.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    persona_id: { type: "string", description: "Persona ID" },
+                    workflow_def: { type: "object", description: "Workflow JSON" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: [],
+            },
+        },
+        {
+            name: "validate_workflow_connections",
+            description: `⚠️ DEPRECATED: Use \`workflow(mode="analyze", include=["connections"])\` instead.
+
+Validate edge connections for type compatibility.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    persona_id: { type: "string", description: "Persona ID" },
+                    workflow_def: { type: "object", description: "Workflow JSON" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: [],
+            },
+        },
+        {
+            name: "suggest_workflow_fixes",
+            description: `⚠️ DEPRECATED: Use \`workflow(mode="analyze", include=["fixes"])\` instead.
+
+Get fix suggestions for workflow issues.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    persona_id: { type: "string", description: "Persona ID" },
+                    workflow_def: { type: "object", description: "Workflow JSON" },
+                    issues: { type: "array", description: "Issues to fix" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: [],
+            },
+        },
+        {
+            name: "compare_workflow_versions",
+            description: `⚠️ DEPRECATED: Use \`workflow(mode="compare")\` instead.
+
+Compare two workflow versions.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    id_before: { type: "string", description: "Before persona ID" },
+                    id_after: { type: "string", description: "After persona ID" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: ["id_before", "id_after"],
+            },
+        },
+        {
+            name: "get_workflow_metrics",
+            description: `⚠️ DEPRECATED: Use \`workflow(mode="analyze", include=["metrics"])\` instead.
+
+Get workflow metrics (complexity, depth, etc.).`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    persona_id: { type: "string", description: "Persona ID" },
+                    workflow_def: { type: "object", description: "Workflow JSON" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: [],
+            },
+        },
+        {
+            name: "compile_workflow",
+            description: `⚠️ DEPRECATED: Use \`workflow(mode="compile")\` instead.
+
+Compile a workflow spec into deployable workflow_def.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    name: { type: "string", description: "Workflow name" },
+                    description: { type: "string", description: "Workflow description" },
+                    persona_type: { type: "string", enum: ["voice", "chat"] },
+                    nodes: { type: "array", description: "Node definitions" },
+                    result_mappings: { type: "array", description: "Output mappings" },
+                },
+                required: ["name", "description", "persona_type", "nodes", "result_mappings"],
+            },
+        },
+        // ═══════════════════════════════════════════════════════════════════════════
+        // DATA SOURCES (Knowledge)
+        // ═══════════════════════════════════════════════════════════════════════════
+        {
+            name: "upload_data_source",
+            description: `⚠️ DEPRECATED: Use \`knowledge(mode="upload")\` instead.
+
+Upload a file to an AI Employee's knowledge base.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    persona_id: { type: "string", description: "AI Employee ID" },
+                    file_path: { type: "string", description: "Local file path" },
+                    tags: { type: "string", description: "Tags for categorizing" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: ["persona_id", "file_path"],
+            },
+        },
+        {
+            name: "delete_data_source",
+            description: `⚠️ DEPRECATED: Use \`knowledge(mode="delete")\` instead.
+
+Delete a file from an AI Employee's knowledge base.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    persona_id: { type: "string", description: "AI Employee ID" },
+                    file_id: { type: "string", description: "File ID to delete" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: ["persona_id", "file_id"],
+            },
+        },
+        {
+            name: "list_data_sources",
+            description: `⚠️ DEPRECATED: Use \`knowledge(persona_id)\` instead.
+
+List data sources for an AI Employee.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    persona_id: { type: "string", description: "AI Employee ID" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: ["persona_id"],
+            },
+        },
+        {
+            name: "get_embedding_status",
+            description: `⚠️ DEPRECATED: Use \`knowledge(persona_id, status=true)\` instead.
+
+Get embedding/indexing status for a persona's data sources.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    persona_id: { type: "string", description: "AI Employee ID" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: ["persona_id"],
+            },
+        },
+        {
+            name: "toggle_embedding",
+            description: `⚠️ DEPRECATED: Use \`knowledge(mode="embedding")\` instead.
+
+Enable or disable embedding for a persona.`,
+            inputSchema: {
+                type: "object",
+                properties: {
+                    persona_id: { type: "string", description: "AI Employee ID" },
+                    enabled: { type: "boolean", description: "Enable or disable" },
+                    env: { type: "string", description: envDesc },
+                },
+                required: ["persona_id", "enabled"],
+            },
+        },
+    ];
+}
+/**
+ * Get list of legacy tool names that have been deprecated
+ */
+export function getDeprecatedToolNames() {
+    return [
+        "list_environments",
+        "get_persona",
+        "find_personas",
+        "create_ai_employee",
+        "update_ai_employee",
+        "compare_ai_employees",
+        "list_ai_employee_templates",
+        "deploy_workflow",
+        "optimize_workflow",
+        "get_workflow_action",
+        "find_workflow_actions",
+        "list_auto_builder_agents",
+        "get_auto_builder_agent",
+        "suggest_agents_for_use_case",
+        "get_workflow_pattern",
+        "list_workflow_patterns",
+        "check_type_compatibility",
+        "get_widget_reference",
+        "get_qualifying_questions",
+        "get_voice_persona_template",
+        "validate_workflow_prompt",
+        "get_auto_builder_guidance",
+        "get_platform_concept",
+        "list_platform_concepts",
+        "get_common_mistakes",
+        "get_debug_checklist",
+        "get_workflow_execution_model",
+        "analyze_workflow",
+        "detect_workflow_issues",
+        "validate_workflow_connections",
+        "suggest_workflow_fixes",
+        "compare_workflow_versions",
+        "get_workflow_metrics",
+        "compile_workflow",
+        "upload_data_source",
+        "delete_data_source",
+        "list_data_sources",
+        "get_embedding_status",
+        "toggle_embedding",
+    ];
+}
+/**
+ * Mapping from legacy tool names to consolidated equivalents
+ */
+export const LEGACY_TO_CONSOLIDATED = {
+    // Environment
+    "list_environments": "env",
+    // Personas
+    "get_persona": "persona(id)",
+    "find_personas": "persona(all=true)",
+    "create_ai_employee": "persona(mode='create')",
+    "update_ai_employee": "persona(mode='update')",
+    "compare_ai_employees": "persona(mode='compare')",
+    "list_ai_employee_templates": "persona(templates=true)",
+    // Workflow operations
+    "deploy_workflow": "workflow(mode='deploy')",
+    "optimize_workflow": "workflow(mode='optimize')",
+    "analyze_workflow": "workflow(mode='analyze')",
+    "detect_workflow_issues": "workflow(mode='analyze', include=['issues'])",
+    "validate_workflow_connections": "workflow(mode='analyze', include=['connections'])",
+    "suggest_workflow_fixes": "workflow(mode='analyze', include=['fixes'])",
+    "compare_workflow_versions": "workflow(mode='compare')",
+    "get_workflow_metrics": "workflow(mode='analyze', include=['metrics'])",
+    "compile_workflow": "workflow(mode='compile')",
+    // Actions
+    "get_workflow_action": "action(id)",
+    "find_workflow_actions": "action(all=true)",
+    "list_auto_builder_agents": "action(all=true, include_docs=true)",
+    "get_auto_builder_agent": "action(id, include_docs=true)",
+    "suggest_agents_for_use_case": "action(suggest='...')",
+    // Templates
+    "get_workflow_pattern": "template(pattern='...')",
+    "list_workflow_patterns": "template(patterns=true)",
+    "check_type_compatibility": "template(type_check={...})",
+    "get_widget_reference": "template(widgets='...')",
+    "get_qualifying_questions": "template(questions=true)",
+    "get_voice_persona_template": "template(config='voice')",
+    // Reference
+    "validate_workflow_prompt": "reference(validate_prompt='...')",
+    "get_auto_builder_guidance": "reference(topic='...')",
+    "get_platform_concept": "reference(concept='...')",
+    "list_platform_concepts": "reference(concepts=true)",
+    "get_common_mistakes": "reference(mistakes=true)",
+    "get_debug_checklist": "reference(debug=true)",
+    "get_workflow_execution_model": "reference(execution_model=true)",
+    // Knowledge
+    "upload_data_source": "knowledge(mode='upload')",
+    "delete_data_source": "knowledge(mode='delete')",
+    "list_data_sources": "knowledge(persona_id)",
+    "get_embedding_status": "knowledge(status=true)",
+    "toggle_embedding": "knowledge(mode='embedding')",
+};