@elastic.io/mcp 1.0.0-beta

package/dist/setup.js

@@ -0,0 +1,338 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import readline from 'node:readline';
+const home = os.homedir();
+// Resolve the full path to npx at setup time so clients that don't inherit
+// the user's shell PATH (NVM, fnm, Homebrew, etc.) can still find it.
+import { execSync } from 'node:child_process';
+function resolveNpxPath() {
+    const cmd = process.platform === 'win32' ? 'where npx' : 'which npx';
+    try {
+        const result = execSync(cmd, { encoding: 'utf-8' }).trim();
+        // 'where' on Windows may return multiple lines; take the first
+        return result.split('\n')[0].trim();
+    }
+    catch {
+        return 'npx';
+    }
+}
+const npxPath = resolveNpxPath();
+const npxDir = path.dirname(npxPath);
+// Build a PATH that includes the directory where npx/node live,
+// so clients that don't inherit the user's shell can find node.
+const systemPaths = process.platform === 'win32'
+    ? [npxDir, path.join(process.env.SystemRoot || 'C:\\Windows', 'System32')]
+    : [npxDir, '/usr/local/bin', '/usr/bin', '/bin', '/usr/sbin', '/sbin'];
+const nodePath = systemPaths.join(path.delimiter);
+function mcpEntry(env) {
+    return {
+        command: npxPath,
+        args: ['-y', '--prefer-online', '@elastic.io/mcp@beta'],
+        env: { PATH: nodePath, ...env },
+    };
+}
+function writeTomlMcpServer(configPath, env) {
+    let content = '';
+    try {
+        content = fs.readFileSync(configPath, 'utf-8');
+    }
+    catch { /* file doesn't exist yet */ }
+    // Remove all existing elasticio sections (main + sub-tables like .env, .tools.*)
+    content = content.replace(/\n?\[mcp_servers\.elasticio\b[^\]]*\]\n((?!\[)[^\n]*\n?)*/g, '');
+    // Build TOML section
+    // In TOML basic strings (double-quoted), backslashes must be escaped.
+    const esc = (s) => s.replace(/\\/g, '\\\\');
+    const allEnv = { PATH: nodePath, ...env };
+    const envLines = Object.entries(allEnv)
+        .map(([k, v]) => `${k} = "${esc(v)}"`)
+        .join('\n');
+    const section = `
+[mcp_servers.elasticio]
+command = "${esc(npxPath)}"
+args = ["-y", "--prefer-online", "@elastic.io/mcp@beta"]
+startup_timeout_sec = 120
+
+[mcp_servers.elasticio.env]
+${envLines}
+`;
+    fs.mkdirSync(path.dirname(configPath), { recursive: true });
+    fs.writeFileSync(configPath, content.trimEnd() + '\n' + section, 'utf-8');
+}
+function platformPath(mac, win, linux) {
+    if (process.platform === 'darwin')
+        return mac;
+    if (process.platform === 'win32')
+        return win;
+    return linux;
+}
+const clients = [
+    {
+        name: 'Claude Desktop',
+        configPath: platformPath(path.join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json'), path.join(home, 'AppData', 'Roaming', 'Claude', 'claude_desktop_config.json'), path.join(home, '.config', 'Claude', 'claude_desktop_config.json')),
+        writeConfig(configPath, env) {
+            const existing = readJson(configPath);
+            existing.mcpServers = existing.mcpServers || {};
+            existing.mcpServers['elasticio'] = mcpEntry(env);
+            writeJson(configPath, existing);
+        },
+    },
+    {
+        name: 'Claude Code',
+        configPath: path.join(home, '.claude.json'),
+        writeConfig(configPath, env) {
+            const existing = readJson(configPath);
+            existing.mcpServers = existing.mcpServers || {};
+            existing.mcpServers['elasticio'] = mcpEntry(env);
+            writeJson(configPath, existing);
+        },
+    },
+    {
+        name: 'ChatGPT / Codex',
+        configPath: path.join(home, '.codex', 'config.toml'),
+        writeConfig(configPath, env) {
+            writeTomlMcpServer(configPath, env);
+        },
+    },
+    {
+        name: 'Cursor',
+        configPath: path.join(home, '.cursor', 'mcp.json'),
+        writeConfig(configPath, env) {
+            const existing = readJson(configPath);
+            existing.mcpServers = existing.mcpServers || {};
+            existing.mcpServers['elasticio'] = mcpEntry(env);
+            writeJson(configPath, existing);
+        },
+    },
+    {
+        name: 'Windsurf',
+        configPath: path.join(home, '.codeium', 'windsurf', 'mcp_config.json'),
+        writeConfig(configPath, env) {
+            const existing = readJson(configPath);
+            existing.mcpServers = existing.mcpServers || {};
+            existing.mcpServers['elasticio'] = mcpEntry(env);
+            writeJson(configPath, existing);
+        },
+    },
+    {
+        name: 'Gemini CLI / Gemini IDE (Antigravity)',
+        configPath: path.join(home, '.gemini', 'config', 'mcp_config.json'),
+        writeConfig(configPath, env) {
+            const existing = readJson(configPath);
+            existing.mcpServers = existing.mcpServers || {};
+            existing.mcpServers['elasticio'] = mcpEntry(env);
+            writeJson(configPath, existing);
+        },
+    },
+    {
+        name: 'Trae (ByteDance)',
+        configPath: path.join(home, '.trae', 'mcp.json'),
+        writeConfig(configPath, env) {
+            const existing = readJson(configPath);
+            existing.mcpServers = existing.mcpServers || {};
+            existing.mcpServers['elasticio'] = mcpEntry(env);
+            writeJson(configPath, existing);
+        },
+    },
+    {
+        name: 'VS Code (Copilot)',
+        configPath: platformPath(path.join(home, 'Library', 'Application Support', 'Code', 'User', 'mcp.json'), path.join(home, 'AppData', 'Roaming', 'Code', 'User', 'mcp.json'), path.join(home, '.config', 'Code', 'User', 'mcp.json')),
+        writeConfig(configPath, env) {
+            const existing = readJson(configPath);
+            existing.servers = existing.servers || {};
+            existing.servers['elasticio'] = mcpEntry(env);
+            writeJson(configPath, existing);
+        },
+    },
+    {
+        name: 'Zed',
+        configPath: path.join(home, '.config', 'zed', 'settings.json'),
+        writeConfig(configPath, env) {
+            const existing = readJson(configPath);
+            existing.context_servers = existing.context_servers || {};
+            existing.context_servers['elasticio'] = {
+                command: { path: 'npx', args: ['-y', '--prefer-online', '@elastic.io/mcp@beta'] },
+                settings: env,
+            };
+            writeJson(configPath, existing);
+        },
+    },
+    {
+        name: 'Cline (VS Code)',
+        configPath: platformPath(path.join(home, 'Library', 'Application Support', 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json'), path.join(home, 'AppData', 'Roaming', 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json'), path.join(home, '.config', 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json')),
+        writeConfig(configPath, env) {
+            const existing = readJson(configPath);
+            existing.mcpServers = existing.mcpServers || {};
+            existing.mcpServers['elasticio'] = mcpEntry(env);
+            writeJson(configPath, existing);
+        },
+    },
+    {
+        name: 'Qwen Code',
+        configPath: path.join(home, '.qwen', 'settings.json'),
+        writeConfig(configPath, env) {
+            const existing = readJson(configPath);
+            existing.mcpServers = existing.mcpServers || {};
+            existing.mcpServers['elasticio'] = mcpEntry(env);
+            writeJson(configPath, existing);
+        },
+    },
+    {
+        name: 'Kimi Code',
+        configPath: path.join(home, '.kimi-code', 'mcp.json'),
+        writeConfig(configPath, env) {
+            const existing = readJson(configPath);
+            existing.mcpServers = existing.mcpServers || {};
+            existing.mcpServers['elasticio'] = mcpEntry(env);
+            writeJson(configPath, existing);
+        },
+    },
+    {
+        name: 'DeepSeek',
+        configPath: path.join(home, '.deepseek', 'mcp.json'),
+        writeConfig(configPath, env) {
+            const existing = readJson(configPath);
+            existing.mcpServers = existing.mcpServers || {};
+            existing.mcpServers['elasticio'] = mcpEntry(env);
+            writeJson(configPath, existing);
+        },
+    },
+];
+function readJson(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+function writeJson(filePath, data) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+}
+function detectClients() {
+    return clients.filter((c) => {
+        // Check if config file or its parent directory exists
+        const dir = path.dirname(c.configPath);
+        return fs.existsSync(c.configPath) || fs.existsSync(dir);
+    });
+}
+function ask(rl, question) {
+    return new Promise((resolve) => rl.question(question, resolve));
+}
+const MIN_NODE_MAJOR = 22;
+function checkNodeVersion() {
+    const major = parseInt(process.versions.node.split('.')[0], 10);
+    if (major < MIN_NODE_MAJOR) {
+        console.error(`\n❌ Node.js ${process.versions.node} detected. Minimum required: v${MIN_NODE_MAJOR}.`);
+        console.error(`   Download the latest LTS from https://nodejs.org/\n`);
+        process.exit(1);
+    }
+}
+function ensureV2Suffix(url) {
+    return url.endsWith('/v2') ? url : `${url.replace(/\/+$/, '')}/v2`;
+}
+/**
+ * Parse a curl command string like:
+ *   curl https://api-sparrow.elastic.io/v2/users/me -u email:apikey
+ * Returns { email, apiKey, baseUrl } or null if the string is not a valid curl command.
+ */
+function parseCurlString(input) {
+    const trimmed = input.trim();
+    if (!trimmed.startsWith('curl '))
+        return null;
+    // Extract URL
+    const urlMatch = trimmed.match(/curl\s+(https?:\/\/\S+)/);
+    if (!urlMatch)
+        return null;
+    // Extract -u credentials
+    const authMatch = trimmed.match(/-u\s+(\S+)/);
+    if (!authMatch)
+        return null;
+    const url = urlMatch[1];
+    const auth = authMatch[1];
+    const colonIdx = auth.indexOf(':');
+    if (colonIdx === -1)
+        return null;
+    const email = auth.substring(0, colonIdx);
+    const apiKey = auth.substring(colonIdx + 1);
+    if (!email || !apiKey)
+        return null;
+    // Derive base URL: extract origin and ensure /v2 suffix
+    const v2Idx = url.indexOf('/v2');
+    const baseUrl = v2Idx !== -1 ? url.substring(0, v2Idx + 3) : url;
+    return { email, apiKey, baseUrl };
+}
+export async function runSetup() {
+    checkNodeVersion();
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    console.log('\n🔧 elastic.io MCP Server Setup\n');
+    console.log(`   Node.js: ${process.versions.node} (${npxPath})\n`);
+    // 1. Collect credentials — accept a curl command or manual entry
+    console.log('Paste the curl command from your elastic.io profile page, or press Enter to type credentials manually:');
+    const curlOrEmail = await ask(rl, '> ');
+    let env;
+    const parsed = parseCurlString(curlOrEmail);
+    if (parsed) {
+        console.log(`\n   ✓ Parsed: email=${parsed.email}, base=${parsed.baseUrl}\n`);
+        env = {
+            ELASTICIO_API_EMAIL: parsed.email,
+            ELASTICIO_API_KEY: parsed.apiKey,
+            ELASTICIO_API_BASE_URL: parsed.baseUrl,
+        };
+    }
+    else {
+        // Manual entry — treat first input as email if it wasn't a curl command
+        const email = curlOrEmail.trim() || await ask(rl, 'elastic.io email: ');
+        const apiKey = await ask(rl, 'elastic.io API key: ');
+        const baseUrl = await ask(rl, 'API base URL (press Enter for https://api.elastic.io): ');
+        env = {
+            ELASTICIO_API_EMAIL: email.trim(),
+            ELASTICIO_API_KEY: apiKey.trim(),
+            ELASTICIO_API_BASE_URL: ensureV2Suffix(baseUrl.trim() || 'https://api.elastic.io'),
+        };
+    }
+    // 2. Detect clients
+    const detected = detectClients();
+    if (detected.length === 0) {
+        console.log('\nNo supported AI clients detected. Supported clients:');
+        clients.forEach((c) => console.log(`  - ${c.name}`));
+        console.log('\nInstall one of the above clients and run setup again.');
+        rl.close();
+        return;
+    }
+    console.log('\nDetected AI clients:');
+    detected.forEach((c, i) => console.log(`  ${i + 1}. ${c.name}`));
+    const selection = await ask(rl, `\nInstall to (comma-separated numbers, or "all"): `);
+    rl.close();
+    let selected;
+    if (selection.trim().toLowerCase() === 'all') {
+        selected = detected;
+    }
+    else {
+        const indices = selection.split(',').map((s) => parseInt(s.trim(), 10) - 1);
+        selected = indices.filter((i) => i >= 0 && i < detected.length).map((i) => detected[i]);
+    }
+    if (selected.length === 0) {
+        console.log('No clients selected. Exiting.');
+        return;
+    }
+    // 3. Write configs
+    for (const client of selected) {
+        try {
+            client.writeConfig(client.configPath, env);
+            console.log(`✅ ${client.name} — configured (${client.configPath})`);
+        }
+        catch (err) {
+            console.error(`❌ ${client.name} — failed: ${err.message}`);
+        }
+    }
+    console.log('\nDone! Restart your AI client to pick up the new MCP server.\n');
+}
+// Self-execute when run directly
+runSetup().then(() => process.exit(0)).catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"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"}

package/dist/tools/confirmation.d.ts

@@ -0,0 +1,37 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const DESTRUCTIVE_TOOL_NAMES: {
+    readonly CREATE_FLOW: "create_flow";
+    readonly UPDATE_FLOW: "update_flow";
+    readonly UPDATE_FLOW_DRAFT: "update_flow_draft";
+    readonly START_FLOW: "start_flow";
+    readonly STOP_FLOW: "stop_flow";
+    readonly RUN_FLOW_NOW: "run_flow_now";
+    readonly CREATE_CREDENTIALS: "create_credentials";
+    readonly CREATE_AUTH_CLIENT: "create_auth_client";
+    readonly CREATE_SECRET: "create_secret";
+    readonly EXECUTE_RAW_API_REQUEST: "execute_raw_api_request";
+    readonly CREATE_DATA_SAMPLE: "create_data_sample";
+    readonly UPDATE_DATA_SAMPLE: "update_data_sample";
+    readonly DEBUG_FLOW_STEP: "debug_flow_step";
+};
+/**
+ * Check whether a tool call requires confirmation.
+ * For execute_raw_api_request, only mutating HTTP methods need it.
+ */
+export declare function requiresConfirmation(toolName: string, args: any): boolean;
+/**
+ * Return the confirmation prompt as a tool result the LLM will see.
+ */
+export declare function confirmationResult(toolName: string, args: any): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError: boolean;
+};
+/**
+ * Returns a new tools array with the `confirmed` property injected into
+ * every destructive tool's input schema.
+ */
+export declare function withConfirmationSchemas(tools: Tool[]): Tool[];
+//# sourceMappingURL=confirmation.d.ts.map

package/dist/tools/confirmation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation.d.ts","sourceRoot":"","sources":["../../src/tools/confirmation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;CAczB,CAAC;AAMX;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAMzE;AAuDD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG;IAC/D,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,OAAO,CAAC;CAClB,CAYA;AAQD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAgB7D"}

package/dist/tools/confirmation.js

@@ -0,0 +1,120 @@
+export const DESTRUCTIVE_TOOL_NAMES = {
+    CREATE_FLOW: 'create_flow',
+    UPDATE_FLOW: 'update_flow',
+    UPDATE_FLOW_DRAFT: 'update_flow_draft',
+    START_FLOW: 'start_flow',
+    STOP_FLOW: 'stop_flow',
+    RUN_FLOW_NOW: 'run_flow_now',
+    CREATE_CREDENTIALS: 'create_credentials',
+    CREATE_AUTH_CLIENT: 'create_auth_client',
+    CREATE_SECRET: 'create_secret',
+    EXECUTE_RAW_API_REQUEST: 'execute_raw_api_request',
+    CREATE_DATA_SAMPLE: 'create_data_sample',
+    UPDATE_DATA_SAMPLE: 'update_data_sample',
+    DEBUG_FLOW_STEP: 'debug_flow_step'
+};
+const DESTRUCTIVE_TOOLS = Object.values(DESTRUCTIVE_TOOL_NAMES);
+const MUTATING_HTTP_METHODS = ['POST', 'PUT', 'PATCH', 'DELETE'];
+/**
+ * Check whether a tool call requires confirmation.
+ * For execute_raw_api_request, only mutating HTTP methods need it.
+ */
+export function requiresConfirmation(toolName, args) {
+    if (!DESTRUCTIVE_TOOLS.includes(toolName))
+        return false;
+    if (toolName === DESTRUCTIVE_TOOL_NAMES.EXECUTE_RAW_API_REQUEST) {
+        return MUTATING_HTTP_METHODS.includes((args?.method || '').toUpperCase());
+    }
+    return true;
+}
+/**
+ * Build a human-readable preview of the action the tool will perform.
+ */
+function buildConfirmationPreview(toolName, args) {
+    const previews = {
+        [DESTRUCTIVE_TOOL_NAMES.CREATE_FLOW]: (a) => {
+            const name = a.body?.data?.attributes?.name || '(unnamed)';
+            return `Create a new integration flow "${name}".`;
+        },
+        [DESTRUCTIVE_TOOL_NAMES.UPDATE_FLOW]: (a) => {
+            return `Update integration flow ${a.flowId || ''} with the provided patch payload.`;
+        },
+        [DESTRUCTIVE_TOOL_NAMES.UPDATE_FLOW_DRAFT]: (a) => {
+            return `Update the draft of flow ${a.flowId || ''} with the provided payload.`;
+        },
+        [DESTRUCTIVE_TOOL_NAMES.START_FLOW]: (a) => {
+            return `Start (activate) flow ${a.flowId || ''}.`;
+        },
+        [DESTRUCTIVE_TOOL_NAMES.STOP_FLOW]: (a) => {
+            return `Stop (deactivate) flow ${a.flowId || ''}.`;
+        },
+        [DESTRUCTIVE_TOOL_NAMES.RUN_FLOW_NOW]: (a) => {
+            return `Trigger a one-off execution of flow ${a.flowId || ''}.`;
+        },
+        [DESTRUCTIVE_TOOL_NAMES.CREATE_CREDENTIALS]: (a) => {
+            return `Create credentials for component ${a.componentId || '(unknown)'} in workspace ${a.workspaceId || ''}.`;
+        },
+        [DESTRUCTIVE_TOOL_NAMES.CREATE_AUTH_CLIENT]: (a) => {
+            const name = a.name || '(unnamed)';
+            return `Create auth client "${name}" (type: ${a.type || '(unknown)'}) for component ${a.componentId || ''}.`;
+        },
+        [DESTRUCTIVE_TOOL_NAMES.CREATE_SECRET]: (a) => {
+            const name = a.name || '(unnamed)';
+            return `Create auth secret "${name}" (type: ${a.type || '(unknown)'}) in workspace ${a.workspaceId || ''}.`;
+        },
+        [DESTRUCTIVE_TOOL_NAMES.EXECUTE_RAW_API_REQUEST]: (a) => {
+            return `Execute raw ${a.method || '(unknown)'} request to ${a.path || ''}.`;
+        },
+        [DESTRUCTIVE_TOOL_NAMES.CREATE_DATA_SAMPLE]: (a) => {
+            return `Create a data sample for component ${a.componentId || '(unknown)'} (method: ${a.method || '(unknown)'}) in workspace ${a.workspaceId || ''}.`;
+        },
+        [DESTRUCTIVE_TOOL_NAMES.UPDATE_DATA_SAMPLE]: (a) => {
+            return `Update data sample ${a.dataSampleId || '(unknown)'} with new body data.`;
+        },
+        [DESTRUCTIVE_TOOL_NAMES.DEBUG_FLOW_STEP]: (a) => {
+            return `Execute a debug run of component step with command "${a.command || '(unknown)'}" in workspace ${a.workspaceId || ''}.`;
+        }
+    };
+    const fn = previews[toolName];
+    return fn ? fn(args) : `Execute destructive tool "${toolName}".`;
+}
+/**
+ * Return the confirmation prompt as a tool result the LLM will see.
+ */
+export function confirmationResult(toolName, args) {
+    const preview = buildConfirmationPreview(toolName, args);
+    const message = `⚠️ Confirmation required.\n\n` +
+        `Action: ${preview}\n\n` +
+        `This is a destructive operation that will mutate platform state. ` +
+        `To proceed, call this tool again with the same parameters and set confirmed: true.`;
+    return {
+        isError: true,
+        content: [{ type: 'text', text: message }]
+    };
+}
+const CONFIRMED_PROPERTY = {
+    type: 'boolean',
+    description: 'Set to true to confirm this destructive operation. If omitted or false, the tool returns a preview of the action instead of executing it.'
+};
+/**
+ * Returns a new tools array with the `confirmed` property injected into
+ * every destructive tool's input schema.
+ */
+export function withConfirmationSchemas(tools) {
+    return tools.map((tool) => {
+        if (!DESTRUCTIVE_TOOLS.includes(tool.name))
+            return tool;
+        const schema = tool.inputSchema;
+        return {
+            ...tool,
+            inputSchema: {
+                ...schema,
+                properties: {
+                    ...schema.properties,
+                    confirmed: CONFIRMED_PROPERTY
+                }
+            }
+        };
+    });
+}
+//# sourceMappingURL=confirmation.js.map

package/dist/tools/confirmation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation.js","sourceRoot":"","sources":["../../src/tools/confirmation.ts"],"names":[],"mappings":"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"}

package/dist/tools/constants.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Centralized constants for the MCP tools layer.
+ * Keeps magic numbers, validation lists, and component metadata out of business logic.
+ */
+export declare const PAGE_SIZE: {
+    readonly CONTRACTS: 20;
+    readonly WORKSPACES: 20;
+    readonly FLOWS_DEFAULT: 50;
+    readonly FLOWS_MAX: 100;
+    readonly LOGS_DEFAULT: 50;
+};
+export declare const SEARCH_RESULTS_DEFAULT_LIMIT = 5;
+export declare const MAX_RESPONSE_LENGTH = 200000;
+export declare const ENUM_PRUNE_THRESHOLD = 5;
+export declare const ENUM_PRUNE_KEEP = 3;
+export declare const BARE_FIELD_NAMES: string[];
+export declare const UNSUPPORTED_ROUTER_JSONATA_FUNCTIONS: string[];
+export declare const DEPRECATED_COMPONENTS: Record<string, string>;
+export declare const DEPRECATED_COMPONENT_ACTIONS: Record<string, Record<string, string>>;
+/**
+ * Helper to look up replacement for a deprecated action/trigger within a component.
+ * Checks both full prefix (e.g. "core/rest-api-v2") and base repo name (e.g. "rest-api-v2").
+ */
+export declare function getDeprecatedActionReplacement(commandPrefix: string, actionId: string): string | undefined;
+export declare const DEPRECATED_ACTIONS: Record<string, string>;
+export declare const REST_API_READER_FIELDS: string[];
+export declare const PLACEHOLDER_FIELD_VALUES: string[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/tools/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/tools/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,SAAS;;;;;;CAMZ,CAAC;AAEX,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAI9C,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAI3C,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,eAAe,IAAI,CAAC;AAIjC,eAAO,MAAM,gBAAgB,UAA8C,CAAC;AAI5E,eAAO,MAAM,oCAAoC,UAIhD,CAAC;AAIF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAExD,CAAC;AAMF,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA+B/E,CAAC;AAEF;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ1G;AAGD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKrD,CAAC;AAKF,eAAO,MAAM,sBAAsB,UAAuC,CAAC;AAK3E,eAAO,MAAM,wBAAwB,UAAwF,CAAC"}

package/dist/tools/constants.js

@@ -0,0 +1,92 @@
+/**
+ * Centralized constants for the MCP tools layer.
+ * Keeps magic numbers, validation lists, and component metadata out of business logic.
+ */
+// --- Pagination defaults ---
+export const PAGE_SIZE = {
+    CONTRACTS: 20,
+    WORKSPACES: 20,
+    FLOWS_DEFAULT: 50,
+    FLOWS_MAX: 100,
+    LOGS_DEFAULT: 50,
+};
+export const SEARCH_RESULTS_DEFAULT_LIMIT = 5;
+// --- Response limits ---
+export const MAX_RESPONSE_LENGTH = 200_000;
+// --- Enum pruning thresholds (pruneMetadataResult) ---
+export const ENUM_PRUNE_THRESHOLD = 5;
+export const ENUM_PRUNE_KEEP = 3;
+// --- Validation: known bare field names that LLMs commonly use without $getPassthrough() ---
+export const BARE_FIELD_NAMES = ['Id', 'Name', 'Phone', 'Website', 'Email'];
+// --- Validation: JSONata functions unsupported in router conditions ---
+export const UNSUPPORTED_ROUTER_JSONATA_FUNCTIONS = [
+    '$now', '$millis', '$hour', '$minute', '$second',
+    '$year', '$month', '$day', '$toMillis', '$fromMillis',
+    '$formatTimestamp', '$parseTimestamp',
+];
+// --- Deprecated components ---
+export const DEPRECATED_COMPONENTS = {
+    'elasticio/REST-API': 'elasticio/rest-api-client-credentials-auth or elasticio/REST-API-AUTH-SECRETS',
+};
+// --- Deprecated actions/triggers scoped by component ---
+// Maps component command prefix or repository name to its deprecated actions/triggers and their replacements.
+// Checked during flow graph validation to prevent selecting deprecated functions.
+export const DEPRECATED_COMPONENT_ACTIONS = {
+    'core/rest-api-v2': {
+        'httpRequestAction': 'httpRequestAxios',
+        'httpRequestTrigger': 'httpRequestAxiosTrigger',
+    },
+    'elasticio/rest-api-v2': {
+        'httpRequestAction': 'httpRequestAxios',
+        'httpRequestTrigger': 'httpRequestAxiosTrigger',
+    },
+    'rest-api-v2': {
+        'httpRequestAction': 'httpRequestAxios',
+        'httpRequestTrigger': 'httpRequestAxiosTrigger',
+    },
+    'elasticio/slack': {
+        'postMessage': 'makeRawRequest or upsertObject',
+    },
+    'core/slack': {
+        'postMessage': 'makeRawRequest or upsertObject',
+    },
+    'slack': {
+        'postMessage': 'makeRawRequest or upsertObject',
+    },
+    'elasticio/splitter': {
+        'split': 'splitOnJsonataExpression',
+    },
+    'core/splitter': {
+        'split': 'splitOnJsonataExpression',
+    },
+    'splitter': {
+        'split': 'splitOnJsonataExpression',
+    },
+};
+/**
+ * Helper to look up replacement for a deprecated action/trigger within a component.
+ * Checks both full prefix (e.g. "core/rest-api-v2") and base repo name (e.g. "rest-api-v2").
+ */
+export function getDeprecatedActionReplacement(commandPrefix, actionId) {
+    if (!commandPrefix || !actionId)
+        return undefined;
+    const direct = DEPRECATED_COMPONENT_ACTIONS[commandPrefix]?.[actionId];
+    if (direct)
+        return direct;
+    const repoName = commandPrefix.includes('/') ? commandPrefix.split('/')[1] : commandPrefix;
+    return DEPRECATED_COMPONENT_ACTIONS[repoName]?.[actionId];
+}
+// Deprecated global map kept for backward compatibility
+export const DEPRECATED_ACTIONS = {
+    'httpRequestAction': 'httpRequestAxios',
+    'httpRequestTrigger': 'httpRequestAxiosTrigger',
+    'postMessage': 'makeRawRequest or upsertObject',
+    'split': 'splitOnJsonataExpression',
+};
+// --- Validation: REST API reader field names that must NOT appear in edge mappers ---
+// These belong in node.fields.reader, not in edge.config.mapper.
+export const REST_API_READER_FIELDS = ['url', 'method', 'headers', 'body'];
+// --- Validation: placeholder/dummy values for dynamic select model fields ---
+// If a field that uses a dynamic select model has one of these values, it was never properly configured.
+export const PLACEHOLDER_FIELD_VALUES = ['default', 'DEFAULT', 'select', 'Select', 'choose', 'Choose', 'none', 'placeholder'];
+//# sourceMappingURL=constants.js.map