@elastic.io/mcp 1.0.0-beta

package/dist/tools/helpers.js

@@ -0,0 +1,195 @@
+import { randomBytes } from 'crypto';
+import { MAX_RESPONSE_LENGTH, ENUM_PRUNE_THRESHOLD, ENUM_PRUNE_KEEP } from './constants.js';
+const INVISIBLE_CHARS_RE = /[\u200B-\u200F\u2028-\u202F\u2060-\u206F\u0489\u1AB0-\u1AFF\u1DC0-\u1DFF\u20D0-\u20FF\uFE00-\uFE0F\uFE20-\uFE2F]|[\u0300-\u036F]|\uFEFF|\uDB40[\uDC01-\uDC7F]|\uD834[\uDD67-\uDD69\uDD6D-\uDD72\uDD7B-\uDD82\uDD85-\uDD8B\uDD90\uDD91\uDDA0-\uDDA6]/g;
+const SAFE_ID_RE = /^[a-zA-Z0-9_-]{1,128}$/;
+const SENSITIVE_KEYS = ['password', 'apikey', 'api_key', 'accesskey', 'privatekey', 'token', 'secret', 'auth', 'credentials', 'passphrase', 'authorization'];
+/**
+ * Extract the plain ID string from a credential/secret reference,
+ * which may be a plain string or an object like { secretId: "..." } / { credentialId: "..." }.
+ */
+export function resolveCredentialId(value) {
+    if (!value)
+        return null;
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'object') {
+        return value.secretId || value.credentialId || null;
+    }
+    return null;
+}
+export function maskSensitiveData(obj) {
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(item => maskSensitiveData(item));
+    }
+    const masked = {};
+    for (const k of Object.keys(obj)) {
+        const isSensitive = SENSITIVE_KEYS.some(sKey => k.toLowerCase().includes(sKey));
+        if (isSensitive) {
+            masked[k] = '*** REDACTED ***';
+        }
+        else {
+            masked[k] = maskSensitiveData(obj[k]);
+        }
+    }
+    return masked;
+}
+function assertSafeId(value, name) {
+    if (!SAFE_ID_RE.test(value)) {
+        throw new Error(`Invalid ${name}: must contain only alphanumeric characters, hyphens, or underscores.`);
+    }
+}
+export function validateIdParams(args) {
+    if (!args || typeof args !== 'object')
+        return;
+    for (const key of Object.keys(args)) {
+        if (key.endsWith('Id') && typeof args[key] === 'string') {
+            assertSafeId(args[key], key);
+        }
+    }
+}
+export function sanitizeInput(args) {
+    if (typeof args === 'string') {
+        return args.replace(INVISIBLE_CHARS_RE, '');
+    }
+    if (Array.isArray(args)) {
+        return args.map(sanitizeInput);
+    }
+    if (args !== null && typeof args === 'object') {
+        const cleaned = {};
+        for (const key of Object.keys(args)) {
+            cleaned[key] = sanitizeInput(args[key]);
+        }
+        return cleaned;
+    }
+    return args;
+}
+export function formatResult(data) {
+    if (data === undefined || data === null) {
+        return '';
+    }
+    let text;
+    if (typeof data === 'string') {
+        text = data;
+    }
+    else {
+        try {
+            text = JSON.stringify(data);
+        }
+        catch {
+            // Handle circular references from kitsu-core deserialization
+            const seen = new WeakSet();
+            text = JSON.stringify(data, (_key, value) => {
+                if (typeof value === 'object' && value !== null) {
+                    if (seen.has(value))
+                        return '[Circular]';
+                    seen.add(value);
+                }
+                return value;
+            });
+        }
+    }
+    text = text.replace(INVISIBLE_CHARS_RE, '');
+    if (text.length > MAX_RESPONSE_LENGTH) {
+        text = text.slice(0, MAX_RESPONSE_LENGTH) + `\n... [TRUNCATED: response exceeded ${MAX_RESPONSE_LENGTH} characters. Use filters or pagination to narrow results.]`;
+    }
+    const nonce = randomBytes(8).toString('hex');
+    const beginMarker = `[BEGIN EXTERNAL DATA ${nonce}]`;
+    const endMarker = `[END EXTERNAL DATA ${nonce}]`;
+    text = text
+        .replace(/\[BEGIN EXTERNAL DATA/g, '[BEGIN EXTERNAL DATA (escaped)')
+        .replace(/\[END EXTERNAL DATA/g, '[END EXTERNAL DATA (escaped)');
+    return `${beginMarker}\n${text}\n${endMarker}`;
+}
+export function textResult(data) {
+    return { content: [{ type: 'text', text: formatResult(data) }] };
+}
+export function structuredError(error, hint, requiredTool) {
+    const payload = { error, hint };
+    if (requiredTool) {
+        payload.required_tool = requiredTool;
+    }
+    return { isError: true, content: [{ type: 'text', text: formatResult(payload) }] };
+}
+export function listResult(data) {
+    const count = Array.isArray(data) ? data.length : (data && typeof data === 'object' && Array.isArray(data.credentials)) ? data.credentials.length : (data && typeof data === 'object' && Array.isArray(data.secrets)) ? data.secrets.length : (data && typeof data === 'object' && Array.isArray(data.components)) ? data.components.length : 0;
+    const header = `Showing ${count} result${count !== 1 ? 's' : ''}. Note: this endpoint does not support pagination — all available results are shown.\n\n`;
+    return { content: [{ type: 'text', text: formatResult(header + JSON.stringify(data)) }] };
+}
+export function paginatedResult(data, meta, pageSize) {
+    const count = Array.isArray(data) ? data.length : 0;
+    if (meta && meta.totalPages > 1) {
+        const paginationHeader = `Page ${meta.page} of ${meta.totalPages} (showing ${count} of ${meta.total} total results). Use pageNumber to load other pages.\n\n`;
+        return { content: [{ type: 'text', text: formatResult(paginationHeader + JSON.stringify(data)) }] };
+    }
+    // Fallback: if returned exactly pageSize items, there are likely more pages
+    if (Array.isArray(data) && pageSize && count >= pageSize) {
+        const page = meta?.page || 1;
+        const paginationHeader = `Page ${page} (showing ${count} results — there may be more pages available, use pageNumber to load next pages)\n\n`;
+        return { content: [{ type: 'text', text: formatResult(paginationHeader + JSON.stringify(data)) }] };
+    }
+    return textResult(data);
+}
+export function pruneMetadataResult(data) {
+    if (!data || typeof data !== 'object') {
+        return data;
+    }
+    const pruneSchema = (schema) => {
+        if (!schema || typeof schema !== 'object') {
+            return schema;
+        }
+        if (Array.isArray(schema)) {
+            return schema.map(pruneSchema);
+        }
+        const pruned = {};
+        for (const key of Object.keys(schema)) {
+            const val = schema[key];
+            if (key === 'enum' && Array.isArray(val)) {
+                if (val.length > ENUM_PRUNE_THRESHOLD) {
+                    pruned[key] = [
+                        ...val.slice(0, ENUM_PRUNE_KEEP),
+                        `... and ${val.length - ENUM_PRUNE_KEEP} more items`
+                    ];
+                }
+                else {
+                    pruned[key] = val;
+                }
+            }
+            else if (typeof val === 'object' && val !== null) {
+                pruned[key] = pruneSchema(val);
+            }
+            else {
+                pruned[key] = val;
+            }
+        }
+        return pruned;
+    };
+    if (data.result && data.result.data) {
+        if (data.result.data.in) {
+            data.result.data.in = pruneSchema(data.result.data.in);
+        }
+        if (data.result.data.out) {
+            data.result.data.out = pruneSchema(data.result.data.out);
+        }
+    }
+    else if (data.result) {
+        if (data.result.in) {
+            data.result.in = pruneSchema(data.result.in);
+        }
+        if (data.result.out) {
+            data.result.out = pruneSchema(data.result.out);
+        }
+    }
+    else if (data.in || data.out) {
+        if (data.in) {
+            data.in = pruneSchema(data.in);
+        }
+        if (data.out) {
+            data.out = pruneSchema(data.out);
+        }
+    }
+    return data;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/tools/helpers.js.map

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

package/dist/tools/types.d.ts

@@ -0,0 +1,39 @@
+import { AxiosInstance } from 'axios';
+export interface DiscoveryState {
+    components: Set<string>;
+    credentials: Set<string>;
+    /** Maps secret ID to its state (e.g. 'ready', 'error') */
+    secrets: Map<string, string>;
+    /** Component IDs that require credentials/secrets (have non-empty credentials.fields) */
+    componentsRequiringAuth: Set<string>;
+    /** Maps component ID to its latestVersionId for data sample creation */
+    componentVersions: Map<string, string>;
+    /** Flow IDs that have been inspected via get_flow (Playbook B: inspect before update) */
+    inspectedFlows: Set<string>;
+    /** Tracks credential/secret verification results: id → { ok, error? } */
+    credentialVerifications: Map<string, {
+        ok: boolean;
+        error?: string;
+    }>;
+    /** Whether the flow-building-guide resource has been read this session */
+    flowBuildingGuideRead: boolean;
+    /** Tracks dynamic metadata retrievals: "componentId:actionOrTriggerName" combos */
+    dynamicMetadataRetrieved: Set<string>;
+    /** Tracks which component actions/triggers have dynamicMetadata: true (from get_component) */
+    dynamicMetadataComponents: Set<string>;
+    /** Tracks component:action pairs with static metadata.in/metadata.out (from get_component) */
+    staticMetadataAvailable: Set<string>;
+}
+interface ToolContext {
+    client: AxiosInstance;
+    discoveryState: DiscoveryState;
+}
+export type ToolHandler = (args: any, context: ToolContext) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,0DAA0D;IAC1D,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,yFAAyF;IACzF,uBAAuB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,wEAAwE;IACxE,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,yFAAyF;IACzF,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,yEAAyE;IACzE,uBAAuB,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,0EAA0E;IAC1E,qBAAqB,EAAE,OAAO,CAAC;IAC/B,mFAAmF;IACnF,wBAAwB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,8FAA8F;IAC9F,yBAAyB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,8FAA8F;IAC9F,uBAAuB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,UAAU,WAAW;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,cAAc,CAAC;CAChC;AAED,MAAM,MAAM,WAAW,GAAG,CACxB,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC"}

package/dist/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":""}

package/dist/tools/validation.d.ts

@@ -0,0 +1,35 @@
+import { AxiosInstance } from 'axios';
+import { DiscoveryState } from './types.js';
+export { DEPRECATED_COMPONENTS, DEPRECATED_ACTIONS, DEPRECATED_COMPONENT_ACTIONS, getDeprecatedActionReplacement } from './constants.js';
+interface StepStatus {
+    stepId: string;
+    name: string;
+    component: string;
+    status: 'OK' | 'ERROR' | 'WARNING';
+    issues: string[];
+}
+export interface HealthCheckResult {
+    errors: string[];
+    warnings: string[];
+    stepStatuses?: StepStatus[];
+}
+export declare function checkFlowLifecycle(flowId: string, discoveryState: DiscoveryState, existingFlow: any | null, _operation: 'update_flow' | 'update_flow_draft'): string[];
+export declare function checkFlowBuildingGuideRead(discoveryState: DiscoveryState): string[];
+export declare function validateFlowGraph(body: any): {
+    errors: string[];
+    warnings: string[];
+};
+export declare function checkDiscoveryState(body: any, discoveryState: DiscoveryState, existingFlow?: any): {
+    errors: string[];
+    warnings: string[];
+};
+export declare function checkMapperMetadataRetrieved(body: any, discoveryState: DiscoveryState, workspaceId?: string): string[];
+/**
+ * Runtime health check for a flow — validates credentials, required fields, URLs, and field values.
+ * Runs after create_flow/update_flow and before start_flow to catch config issues
+ * that would show as red indicators in the UI.
+ */
+export declare function healthCheckFlow(flow: any, client: AxiosInstance, discoveryState?: DiscoveryState): Promise<HealthCheckResult>;
+/** Format health check results as a readable string to append to tool response */
+export declare function formatHealthCheck(result: HealthCheckResult): string;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/tools/validation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAe5C,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAEzI,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;CAC7B;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,GAAG,GAAG,IAAI,EACxB,UAAU,EAAE,aAAa,GAAG,mBAAmB,GAC9C,MAAM,EAAE,CAuBV;AAED,wBAAgB,0BAA0B,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM,EAAE,CASnF;AA2dD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAmBrF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,GAAG,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA4H3I;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,SAAK,GAAG,MAAM,EAAE,CAmBlH;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,aAAa,EACrB,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,iBAAiB,CAAC,CAmN5B;AAWD,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAoCnE"}