@elastic.io/mcp 1.0.0-beta

package/dist/api/client.js

@@ -0,0 +1,129 @@
+import axios from 'axios';
+import { logger } from './logger.js';
+import { maskSensitiveData } from '../tools/helpers.js';
+const DEFAULT_BASE_URL = 'https://api.elastic.io/v2';
+function formatPayloadForLog(data) {
+    if (!data)
+        return '';
+    try {
+        let parsedData = data;
+        let wasString = false;
+        if (typeof data === 'string') {
+            try {
+                parsedData = JSON.parse(data);
+                wasString = true;
+            }
+            catch {
+                // Raw string
+            }
+        }
+        const masked = maskSensitiveData(parsedData);
+        const str = wasString && typeof masked !== 'string' ? JSON.stringify(masked) : (typeof masked === 'object' ? JSON.stringify(masked) : String(masked));
+        if (str.length > 2000) {
+            return ` - Payload (truncated): ${str.substring(0, 2000)}... [truncated ${str.length - 2000} chars]`;
+        }
+        return ` - Payload: ${str}`;
+    }
+    catch {
+        return ' - Payload: [Error formatting payload]';
+    }
+}
+export class ElasticioApiError extends Error {
+    statusCode;
+    statusText;
+    errors;
+    constructor(statusCode, statusText, errors, message) {
+        super(message);
+        this.name = 'ElasticioApiError';
+        this.statusCode = statusCode;
+        this.statusText = statusText;
+        this.errors = errors;
+        Object.setPrototypeOf(this, ElasticioApiError.prototype);
+    }
+}
+export class ElasticioNetworkError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ElasticioNetworkError';
+        Object.setPrototypeOf(this, ElasticioNetworkError.prototype);
+    }
+}
+function ensureV2Suffix(url) {
+    return url.endsWith('/v2') ? url : `${url.replace(/\/+$/, '')}/v2`;
+}
+export function createElasticioClient(authHeader, apiBaseUrl) {
+    const baseURL = ensureV2Suffix(apiBaseUrl || process.env.ELASTICIO_API_BASE_URL || DEFAULT_BASE_URL);
+    const client = axios.create({
+        baseURL,
+        timeout: 30000,
+        maxRedirects: 0,
+        headers: {
+            'Authorization': authHeader,
+            'Content-Type': 'application/json',
+            'Accept': 'application/json'
+        }
+    });
+    client.interceptors.request.use((config) => {
+        const dataStr = formatPayloadForLog(config.data);
+        logger.info(`[HTTP Request] ${config.method?.toUpperCase()} ${baseURL}${config.url || ''}${dataStr}`);
+        return config;
+    });
+    client.interceptors.response.use((response) => {
+        const dataStr = formatPayloadForLog(response.data);
+        logger.info(`[HTTP Response] ${response.status} ${response.statusText}${dataStr}`);
+        return response;
+    }, async (error) => {
+        const config = error.config;
+        if (config) {
+            const status = error.response ? error.response.status : null;
+            const isRateLimit = status === 429;
+            const isTransientError = status && status >= 500 && status <= 599;
+            const isNetworkOrTimeout = !error.response || error.code === 'ECONNABORTED' || error.code === 'ETIMEDOUT' || error.message?.includes('timeout') || error.message?.includes('Network Error');
+            const configWithRetry = config;
+            configWithRetry.__retryCount = configWithRetry.__retryCount || 0;
+            const maxRetries = 3;
+            // A timeout on a write is ambiguous: replaying POST/PATCH can duplicate effects.
+            const safeToRetry = ['get', 'head', 'options'].includes(String(config.method || 'get').toLowerCase());
+            if (safeToRetry && (isRateLimit || isTransientError || isNetworkOrTimeout) && configWithRetry.__retryCount < maxRetries) {
+                configWithRetry.__retryCount += 1;
+                const delay = Math.pow(2, configWithRetry.__retryCount) * 1000;
+                logger.warn(`[HTTP Retry] ${isNetworkOrTimeout ? 'Network/Timeout Error' : `Status ${status}`} on ${config.method?.toUpperCase()} ${config.url}. Retrying in ${delay / 1000}s (Attempt ${configWithRetry.__retryCount}/${maxRetries})...`);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                return client(config);
+            }
+        }
+        if (error.config && error.config.headers) {
+            for (const key of Object.keys(error.config.headers)) {
+                if (key.toLowerCase() === 'authorization') {
+                    error.config.headers[key] = '*** REDACTED ***';
+                }
+            }
+        }
+        const status = error.response ? `${error.response.status} ${error.response.statusText}` : 'NETWORK_ERROR';
+        const errorDataStr = error.response?.data ? ` - Response: ${JSON.stringify(error.response.data)}` : '';
+        logger.error(`[HTTP Failure] Status: ${status} - URL: ${error.config?.url}${errorDataStr}`);
+        if (error.response && error.response.data && Array.isArray(error.response.data.errors)) {
+            const errors = error.response.data.errors;
+            const errorDetails = errors
+                .map((err) => {
+                const title = err.title ? `[${err.title}]` : '';
+                const detail = err.detail || '';
+                const pointer = err.source && err.source.pointer ? ` at ${err.source.pointer}` : '';
+                return `${title} ${detail}${pointer}`.trim();
+            })
+                .join('; ');
+            const msg = `elastic.io API Error (${error.response.status} ${error.response.statusText}): ${errorDetails}`;
+            logger.error(`[Unpacked API Error] ${msg}`);
+            throw new ElasticioApiError(error.response.status, error.response.statusText, errors, msg);
+        }
+        if (error.response) {
+            const fallbackMsg = `elastic.io API Request failed (${error.response.status} ${error.response.statusText})`;
+            logger.error(`[Unpacked HTTP Error] ${fallbackMsg}`);
+            throw new ElasticioApiError(error.response.status, error.response.statusText, [], fallbackMsg);
+        }
+        logger.error(`[Network Error] ${error.message}`);
+        throw new ElasticioNetworkError(error.message);
+    });
+    return client;
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/api/jsonapi.d.ts

@@ -0,0 +1,21 @@
+interface PaginationMeta {
+    page: number;
+    perPage: number;
+    totalPages: number;
+    total: number;
+}
+export interface DeserializedResult<T = any> {
+    data: T;
+    meta?: PaginationMeta;
+}
+/**
+ * Deserializes a JSON API response payload (with data, attributes, relationships, etc.)
+ * into a clean JavaScript object or array of objects.
+ */
+export declare function deserializeJsonApi<T = any>(payload: any): T;
+/**
+ * Deserializes a JSON API response and preserves pagination metadata.
+ */
+export declare function deserializeWithMeta<T = any>(payload: any): DeserializedResult<T>;
+export {};
+//# sourceMappingURL=jsonapi.d.ts.map

package/dist/api/jsonapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonapi.d.ts","sourceRoot":"","sources":["../../src/api/jsonapi.ts"],"names":[],"mappings":"AAEA,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,GAAG;IACzC,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,CAM3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAehF"}

package/dist/api/jsonapi.js

@@ -0,0 +1,32 @@
+import { deserialise } from 'kitsu-core';
+/**
+ * Deserializes a JSON API response payload (with data, attributes, relationships, etc.)
+ * into a clean JavaScript object or array of objects.
+ */
+export function deserializeJsonApi(payload) {
+    if (!payload || (typeof payload !== 'object')) {
+        return payload;
+    }
+    const result = deserialise(payload);
+    return result.data;
+}
+/**
+ * Deserializes a JSON API response and preserves pagination metadata.
+ */
+export function deserializeWithMeta(payload) {
+    if (!payload || (typeof payload !== 'object')) {
+        return { data: payload };
+    }
+    const result = deserialise(payload);
+    const pageMeta = payload.meta?.page;
+    return {
+        data: result.data,
+        meta: pageMeta ? {
+            page: pageMeta.number || 1,
+            perPage: pageMeta.size || pageMeta.count || 0,
+            totalPages: Math.ceil((pageMeta.total_count || 0) / (pageMeta.size || 1)),
+            total: pageMeta.total_count || 0
+        } : undefined
+    };
+}
+//# sourceMappingURL=jsonapi.js.map

package/dist/api/jsonapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonapi.js","sourceRoot":"","sources":["../../src/api/jsonapi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAczC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAU,OAAY;IACtD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC9C,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,IAAS,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAU,OAAY;IACvD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;IACpC,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAS;QACtB,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;YACf,IAAI,EAAE,QAAQ,CAAC,MAAM,IAAI,CAAC;YAC1B,OAAO,EAAE,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,IAAI,CAAC;YAC7C,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;YACzE,KAAK,EAAE,QAAQ,CAAC,WAAW,IAAI,CAAC;SACjC,CAAC,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC"}

package/dist/api/logger.d.ts

@@ -0,0 +1,8 @@
+export type LogLevel = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
+export declare const logger: {
+    debug: (message: string, ...args: any[]) => void;
+    info: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+    error: (message: string, ...args: any[]) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/api/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/api/logger.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AA2C3D,eAAO,MAAM,MAAM;qBACA,MAAM,WAAW,GAAG,EAAE;oBACvB,MAAM,WAAW,GAAG,EAAE;oBACtB,MAAM,WAAW,GAAG,EAAE;qBACrB,MAAM,WAAW,GAAG,EAAE;CACxC,CAAC"}

package/dist/api/logger.js

@@ -0,0 +1,43 @@
+import fs from 'node:fs';
+import process from 'node:process';
+// Write to file only when LOG_FILE env var is set (for local development)
+const LOG_FILE = process.env.LOG_FILE;
+const LogLevels = {
+    DEBUG: 0,
+    INFO: 1,
+    WARN: 2,
+    ERROR: 3,
+};
+// Default log level is INFO, or can be overridden by LOG_LEVEL env var
+const currentLevelName = process.env.LOG_LEVEL?.toUpperCase() || 'INFO';
+const currentLevel = LogLevels[currentLevelName] !== undefined ? LogLevels[currentLevelName] : 1;
+function writeLog(level, message, ...args) {
+    if (LogLevels[level] < currentLevel) {
+        return;
+    }
+    const timestamp = new Date().toISOString();
+    // Format message with optional args
+    let formattedMessage = message;
+    if (args.length > 0) {
+        formattedMessage += ' ' + args.map(arg => typeof arg === 'object' ? JSON.stringify(arg) : String(arg)).join(' ');
+    }
+    const formattedLine = `[${level}] ${formattedMessage}\n`;
+    if (LOG_FILE) {
+        try {
+            fs.appendFileSync(LOG_FILE, `[${timestamp}] ${formattedLine}`);
+        }
+        catch (err) {
+            process.stderr.write(`Failed to write to log file: ${String(err)}\n`);
+        }
+    }
+    // Stdio MCP transport uses stdout for protocol,
+    // so diagnostics always go to stderr.
+    process.stderr.write(formattedLine);
+}
+export const logger = {
+    debug: (message, ...args) => writeLog('DEBUG', message, ...args),
+    info: (message, ...args) => writeLog('INFO', message, ...args),
+    warn: (message, ...args) => writeLog('WARN', message, ...args),
+    error: (message, ...args) => writeLog('ERROR', message, ...args),
+};
+//# sourceMappingURL=logger.js.map

package/dist/api/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/api/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,0EAA0E;AAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;AAItC,MAAM,SAAS,GAA6B;IAC1C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,uEAAuE;AACvE,MAAM,gBAAgB,GAAc,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,EAAe,IAAI,MAAM,CAAC;AAChG,MAAM,YAAY,GAAG,SAAS,CAAC,gBAAgB,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjG,SAAS,QAAQ,CAAC,KAAe,EAAE,OAAe,EAAE,GAAG,IAAW;IAChE,IAAI,SAAS,CAAC,KAAK,CAAC,GAAG,YAAY,EAAE,CAAC;QACpC,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,oCAAoC;IACpC,IAAI,gBAAgB,GAAG,OAAO,CAAC;IAC/B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,gBAAgB,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CACvC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAC5D,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,KAAK,KAAK,gBAAgB,IAAI,CAAC;IAEzD,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC;YACH,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,sCAAsC;IACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/E,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC7E,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC7E,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAChF,CAAC"}

package/dist/api/samples.d.ts

@@ -0,0 +1,15 @@
+export declare function formatFlowToMarkdown(flow: any): string;
+/**
+ * Formats a single flow step configuration into Markdown.
+ */
+export declare function formatStepToMarkdown(flow: any, stepId: string, config: any): string;
+declare class IngestionQueue {
+    private queue;
+    private processing;
+    private purgedInCurrentSession;
+    enqueue(flows: any[], purge: boolean): Promise<void>;
+    private processNext;
+}
+export declare const ingestionQueue: IngestionQueue;
+export {};
+//# sourceMappingURL=samples.d.ts.map

package/dist/api/samples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"samples.d.ts","sourceRoot":"","sources":["../../src/api/samples.ts"],"names":[],"mappings":"AA8EA,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,CA2ItD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,MAAM,CAyHnF;AAsID,cAAM,cAAc;IAClB,OAAO,CAAC,KAAK,CAAgG;IAC7G,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,sBAAsB,CAAS;IAEjC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YAU5C,WAAW;CA6B1B;AAED,eAAO,MAAM,cAAc,gBAAuB,CAAC"}