@elastic.io/mcp 1.0.0

package/dist/tools/handlers.js

@@ -0,0 +1,197 @@
+import { logger } from '../api/logger.js';
+import { TOOLS } from './definitions.js';
+import { sanitizeInput, formatResult, structuredError, validateIdParams, maskSensitiveData } from './helpers.js';
+import { requiresConfirmation, confirmationResult } from './confirmation.js';
+import { flowHandlers } from './handlers/flow.js';
+import { authHandlers } from './handlers/auth.js';
+import { dynamicHandlers } from './handlers/dynamic.js';
+import { componentHandlers } from './handlers/component.js';
+import { searchHandlers } from './handlers/search.js';
+import { rawHandlers } from './handlers/raw.js';
+import { organizationHandlers } from './handlers/organization.js';
+import { logHandlers } from './handlers/log.js';
+import { sessionHandlers } from './handlers/session.js';
+import { dataSampleHandlers } from './handlers/data-sample.js';
+let sessionLlmTokens = 0;
+let sessionEmbeddingTokens = 0;
+export function getDiscoveryState(client) {
+    const customClient = client;
+    if (!customClient.discoveryState) {
+        customClient.discoveryState = {
+            components: new Set(),
+            credentials: new Set(),
+            secrets: new Map(),
+            componentsRequiringAuth: new Set(),
+            componentVersions: new Map(),
+            inspectedFlows: new Set(),
+            credentialVerifications: new Map(),
+            flowBuildingGuideRead: false
+        };
+    }
+    return customClient.discoveryState;
+}
+function estimateTokens(text) {
+    if (!text)
+        return 0;
+    return Math.ceil(text.length / 4);
+}
+const TOOL_HANDLERS = {
+    ...flowHandlers,
+    ...authHandlers,
+    ...dynamicHandlers,
+    ...componentHandlers,
+    ...searchHandlers,
+    ...rawHandlers,
+    ...organizationHandlers,
+    ...logHandlers,
+    ...sessionHandlers,
+    ...dataSampleHandlers
+};
+async function executeTool(name, args, client) {
+    // update_flow and update_flow_draft handle their own confirmation with impact analysis
+    if (requiresConfirmation(name, args) && args?.confirmed !== true && name !== 'update_flow_draft' && name !== 'update_flow') {
+        logger.info(`[Confirmation] Tool "${name}" requires confirmation — returning preview`);
+        return confirmationResult(name, args);
+    }
+    const discoveryState = getDiscoveryState(client);
+    const handler = TOOL_HANDLERS[name];
+    if (!handler) {
+        throw new Error(`Unknown tool name: ${name}`);
+    }
+    return await handler(args, { client, discoveryState });
+}
+export async function handleToolCall(name, args, client) {
+    args = sanitizeInput(args);
+    validateIdParams(args);
+    logger.info(`[Tool Call] Name: ${name} - Arguments: ${JSON.stringify(maskSensitiveData(args))}`);
+    if (args && typeof args === 'object') {
+        // Auto-parse stringified JSON in 'body' parameter (LLMs sometimes send objects as strings)
+        if (typeof args.body === 'string') {
+            try {
+                args.body = JSON.parse(args.body);
+            }
+            catch (err) {
+                logger.warn(`Failed to auto-parse stringified 'body' parameter: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        for (const key of Object.keys(args)) {
+            if (key.endsWith('CustomObjectJSON')) {
+                const targetKey = key.substring(0, key.length - 'CustomObjectJSON'.length);
+                try {
+                    if (typeof args[key] === 'string') {
+                        args[targetKey] = JSON.parse(args[key]);
+                    }
+                    else {
+                        args[targetKey] = args[key];
+                    }
+                }
+                catch (err) {
+                    logger.warn(`Failed to parse ${key}: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+        }
+    }
+    const inputStr = JSON.stringify(args);
+    const inputTokens = estimateTokens(inputStr);
+    try {
+        const tool = TOOLS.find((t) => t.name === name);
+        if (tool && tool.inputSchema && tool.inputSchema.required) {
+            for (const req of tool.inputSchema.required) {
+                if (args[req] === undefined || args[req] === null || args[req] === '') {
+                    throw new Error(`Missing required parameter: '${req}' for tool '${name}'`);
+                }
+            }
+        }
+        const result = await executeTool(name, args, client);
+        const outputStr = JSON.stringify(result.content);
+        const outputTokens = estimateTokens(outputStr);
+        let embeddingTokens = 0;
+        if (name === 'search_documentation' && args.query) {
+            embeddingTokens = estimateTokens(args.query);
+        }
+        sessionLlmTokens += inputTokens + outputTokens;
+        sessionEmbeddingTokens += embeddingTokens;
+        logger.info(`[Token Usage] Interaction: LLM (Input: ${inputTokens}, Output: ${outputTokens})${embeddingTokens > 0 ? `, Embedding: ${embeddingTokens}` : ''} | ` +
+            `Session Total: LLM: ${sessionLlmTokens}, Embedding: ${sessionEmbeddingTokens}`);
+        return result;
+    }
+    catch (error) {
+        logger.error(`[Tool Exception] Name: ${name} - Error: ${error.message || String(error)}`);
+        sessionLlmTokens += inputTokens;
+        logger.info(`[Token Usage] Interaction: LLM (Input: ${inputTokens}, Output: 0) | Session Total: LLM: ${sessionLlmTokens}, Embedding: ${sessionEmbeddingTokens}`);
+        const errorMsg = error.message || String(error);
+        const hint = resolveErrorHint(name, errorMsg);
+        if (hint) {
+            return structuredError(errorMsg, hint.hint, hint.requiredTool);
+        }
+        return {
+            isError: true,
+            content: [{ type: 'text', text: formatResult(errorMsg) }]
+        };
+    }
+}
+function resolveErrorHint(toolName, errorMsg) {
+    const lower = errorMsg.toLowerCase();
+    if (lower.includes('playbook state machine check failed')) {
+        if (lower.includes('flow-building-guide')) {
+            return {
+                hint: 'Read the resource elasticio://docs/flow-building-guide before creating or updating flows.',
+                requiredTool: 'ReadResource(elasticio://docs/flow-building-guide)'
+            };
+        }
+        if (lower.includes('get_component')) {
+            return {
+                hint: 'Call get_component for each component used in the flow before creating or updating it.',
+                requiredTool: 'get_component'
+            };
+        }
+        if (lower.includes('list_credentials')) {
+            return {
+                hint: 'Call list_credentials to discover credentials for the component before using them in a flow.',
+                requiredTool: 'list_credentials'
+            };
+        }
+        if (lower.includes('list_secrets')) {
+            return {
+                hint: 'Call list_secrets to discover secrets for the component before using them in a flow.',
+                requiredTool: 'list_secrets'
+            };
+        }
+    }
+    if (lower.includes('flow lifecycle check failed')) {
+        if (lower.includes('not inspected')) {
+            return {
+                hint: 'Call get_flow first to inspect the current flow configuration before modifying it (Playbook B).',
+                requiredTool: 'get_flow'
+            };
+        }
+        if (lower.includes('active')) {
+            return {
+                hint: 'Call stop_flow first and wait until the flow is inactive before modifying it (Playbook B).',
+                requiredTool: 'stop_flow'
+            };
+        }
+    }
+    if (lower.includes('flow graph validation failed')) {
+        if (lower.includes('command format')) {
+            return {
+                hint: 'The node command must be formatted as "team/repo:action@versionId". Call get_component to retrieve the correct commandPrefix and latestVersionId.',
+                requiredTool: 'get_component'
+            };
+        }
+        if (lower.includes('mapper') || lower.includes('passthrough')) {
+            return {
+                hint: 'JSONata mappers must use $getPassthrough().step_id.body.field format. Read elasticio://docs/flow-building-guide for correct syntax.',
+                requiredTool: 'ReadResource(elasticio://docs/flow-building-guide)'
+            };
+        }
+    }
+    if (lower.includes('missing required parameter')) {
+        return {
+            hint: `The tool "${toolName}" is missing a required parameter. Check the tool\'s inputSchema for required fields.`,
+            requiredTool: toolName
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=handlers.js.map

package/dist/tools/handlers.js.map

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

package/dist/tools/helpers.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Extract the plain ID string from a credential/secret reference,
+ * which may be a plain string or an object like { secretId: "..." } / { credentialId: "..." }.
+ */
+export declare function resolveCredentialId(value: any): string | null;
+export declare function maskSensitiveData(obj: any): any;
+export declare function assertSafeId(value: string, name: string): void;
+export declare function validateIdParams(args: any): void;
+export declare function sanitizeInput(args: any): any;
+export declare function formatResult(data: any): string;
+export declare function textResult(data: any): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export declare function structuredError(error: string, hint: string, requiredTool?: string): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError: boolean;
+};
+export declare function listResult(data: any): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export declare function paginatedResult(data: any, meta?: {
+    page: number;
+    perPage: number;
+    totalPages: number;
+    total: number;
+}, pageSize?: number): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export declare function pruneMetadataResult(data: any): any;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/tools/helpers.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAO7D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAiB/C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAI9D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAOhD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAe5C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,CAuC9C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG;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,CAE3G;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,GACpB;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAMtE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG;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,CAI3G;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG;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,CAahN;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAyDlD"}

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\uFEFF\u0300-\u036F\u0489\u1AB0-\u1AFF\u1DC0-\u1DFF\u20D0-\u20FF\uFE00-\uFE0F\uFE20-\uFE2F]|\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;
+}
+export 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":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE5F,MAAM,kBAAkB,GAAG,kPAAkP,CAAC;AAE9Q,MAAM,UAAU,GAAG,wBAAwB,CAAC;AAE5C,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;AAE7J;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAU;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC;IACtD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAQ;IACxC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAChF,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,IAAY;IACtD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,uEAAuE,CAAC,CAAC;IAC1G,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAS;IACxC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO;IAC9C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;YACxD,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAS;IACrC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAQ,EAAE,CAAC;QACxB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAS;IACpC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,IAAY,CAAC;IACjB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,GAAG,IAAI,CAAC;IACd,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,6DAA6D;YAC7D,MAAM,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;gBAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAChD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;wBAAE,OAAO,YAAY,CAAC;oBACzC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAClB,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAE5C,IAAI,IAAI,CAAC,MAAM,GAAG,mBAAmB,EAAE,CAAC;QACtC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,GAAG,uCAAuC,mBAAmB,4DAA4D,CAAC;IACrK,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,wBAAwB,KAAK,GAAG,CAAC;IACrD,MAAM,SAAS,GAAG,sBAAsB,KAAK,GAAG,CAAC;IAEjD,IAAI,GAAG,IAAI;SACR,OAAO,CAAC,wBAAwB,EAAE,gCAAgC,CAAC;SACnE,OAAO,CAAC,sBAAsB,EAAE,8BAA8B,CAAC,CAAC;IAEnE,OAAO,GAAG,WAAW,KAAK,IAAI,KAAK,SAAS,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAS;IAClC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAAa,EACb,IAAY,EACZ,YAAqB;IAErB,MAAM,OAAO,GAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACrC,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CAAC,aAAa,GAAG,YAAY,CAAC;IACvC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAS;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAChV,MAAM,MAAM,GAAG,WAAW,KAAK,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,0FAA0F,CAAC;IAC1J,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAS,EAAE,IAA2E,EAAE,QAAiB;IACvI,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,IAAI,IAAI,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,gBAAgB,GAAG,QAAQ,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,UAAU,aAAa,KAAK,OAAO,IAAI,CAAC,KAAK,0DAA0D,CAAC;QAC9J,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACtG,CAAC;IACD,4EAA4E;IAC5E,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,QAAQ,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;QACzD,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC;QAC7B,MAAM,gBAAgB,GAAG,QAAQ,IAAI,aAAa,KAAK,sFAAsF,CAAC;QAC9I,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACtG,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAS;IAC3C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,MAAW,EAAO,EAAE;QACvC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,MAAM,GAAQ,EAAE,CAAC;QACvB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,GAAG,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzC,IAAI,GAAG,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;oBACtC,MAAM,CAAC,GAAG,CAAC,GAAG;wBACZ,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC;wBAChC,WAAW,GAAG,CAAC,MAAM,GAAG,eAAe,aAAa;qBACrD,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;gBACpB,CAAC;YACH,CAAC;iBAAM,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBACnD,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;SAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;SAAM,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/tools/types.d.ts

@@ -0,0 +1,32 @@
+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;
+}
+export interface ToolContext {
+    client: AxiosInstance;
+    discoveryState: DiscoveryState;
+}
+export type ToolHandler = (args: any, context: ToolContext) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# 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;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,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,24 @@
+import { AxiosInstance } from 'axios';
+import { DiscoveryState } from './types.js';
+export { DEPRECATED_COMPONENTS, DEPRECATED_ACTIONS } from './constants.js';
+export interface HealthCheckResult {
+    errors: string[];
+    warnings: string[];
+}
+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 stripStringLiterals(str: string): string;
+export declare function validateFlowGraph(body: any): {
+    errors: string[];
+    warnings: string[];
+};
+export declare function checkDiscoveryState(body: any, discoveryState: DiscoveryState, existingFlow?: any): 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): 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":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAY5C,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAE3E,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,GAAG,GAAG,IAAI,EACxB,SAAS,EAAE,aAAa,GAAG,mBAAmB,GAC7C,MAAM,EAAE,CAuBV;AAED,wBAAgB,0BAA0B,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM,EAAE,CASnF;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA6BvD;AA+VD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAiBrF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,GAAG,GAAG,MAAM,EAAE,CAgH3G;AAgFD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAkP5B;AAWD,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CA0BnE"}