@elastic.io/mcp 1.0.0-beta

package/dist/tools/handlers/raw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/raw.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAmC1C,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAyDnD,CAAC"}

package/dist/tools/handlers/raw.js

@@ -0,0 +1,80 @@
+import { deserializeJsonApi } from '../../api/jsonapi.js';
+import { textResult } from '../helpers.js';
+const BLOCKED_PATH_PREFIXES = [
+    '/sidedoor',
+    '/v1',
+    '/sailor-support'
+];
+const BLOCKED_V2_PREFIXES = [
+    '/users',
+    '/tenants'
+];
+function isBlockedPath(normalizedPath) {
+    if (BLOCKED_PATH_PREFIXES.some(p => normalizedPath.startsWith(p))) {
+        return true;
+    }
+    const v2Path = normalizedPath.startsWith('/v2/')
+        ? normalizedPath.slice(3) // '/v2/users' → '/users'
+        : normalizedPath.startsWith('/') ? null : `/${normalizedPath}`;
+    if (v2Path && BLOCKED_V2_PREFIXES.some(p => v2Path.startsWith(p))) {
+        return true;
+    }
+    if (!normalizedPath.startsWith('/')) {
+        const asAbsolute = `/${normalizedPath}`;
+        if (BLOCKED_V2_PREFIXES.some(p => asAbsolute.startsWith(p))) {
+            return true;
+        }
+    }
+    return false;
+}
+export const rawHandlers = {
+    execute_raw_api_request: async (args, { client }) => {
+        const { method, path, body } = args;
+        const decoded = decodeURIComponent(path);
+        if (/^[a-z][a-z0-9+.-]*:\/\//i.test(decoded) || decoded.startsWith('//')) {
+            throw new Error('Absolute URLs are not allowed. Use a relative path (e.g. /v2/flows).');
+        }
+        if (/^(data|javascript|vbscript):/i.test(decoded)) {
+            throw new Error('This URL scheme is not allowed.');
+        }
+        if (/\.\./.test(decoded) || /\\/.test(decoded)) {
+            throw new Error('Path traversal is not allowed.');
+        }
+        const normalized = decoded.replace(/\/+/g, '/').toLowerCase();
+        if (isBlockedPath(normalized)) {
+            throw new Error('This API path is restricted and cannot be accessed via the raw request tool. ' +
+                'Use dedicated tools or the platform UI instead.');
+        }
+        if (/[?&](api_key|apiKey|access_token|password|authorization)=/i.test(decoded)) {
+            throw new Error('Passing credentials in query parameters is not allowed.');
+        }
+        // Strip leading /v2 prefix — the client's baseURL already includes /v2,
+        // so passing /v2/flows would result in /v2/v2/flows
+        const sanitizedPath = decoded.replace(/^\/v2\//, '/');
+        if (!['GET', 'HEAD', 'OPTIONS'].includes(String(method).toUpperCase()) && /^\/(flows|data-samples)(?:[/?]|$)/i.test(sanitizedPath.startsWith('/') ? sanitizedPath : `/${sanitizedPath}`)) {
+            throw new Error('Flow and sample mutations must use dedicated tools so revision, readiness and sample checks cannot be bypassed.');
+        }
+        const response = await client.request({
+            method,
+            url: sanitizedPath,
+            data: body
+        });
+        let data;
+        if (typeof response.data === 'object') {
+            try {
+                data = deserializeJsonApi(response.data);
+                if ((data === undefined || data === null) && response.data !== null) {
+                    data = response.data;
+                }
+            }
+            catch {
+                data = response.data;
+            }
+        }
+        else {
+            data = response.data;
+        }
+        return textResult(data);
+    }
+};
+//# sourceMappingURL=raw.js.map

package/dist/tools/handlers/raw.js.map

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

package/dist/tools/handlers/search.d.ts

@@ -0,0 +1,3 @@
+import { ToolHandler } from '../types.js';
+export declare const searchHandlers: Record<string, ToolHandler>;
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/handlers/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/search.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAc1C,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAyFtD,CAAC"}

package/dist/tools/handlers/search.js

@@ -0,0 +1,105 @@
+import { getEmbeddingProvider } from '../../embeddings/factory.js';
+import { getVectorStore } from '../../vectorstore/factory.js';
+import { textResult } from '../helpers.js';
+import { logger } from '../../api/logger.js';
+import { SEARCH_RESULTS_DEFAULT_LIMIT } from '../constants.js';
+const useLocalSearch = !!process.env.ELASTICIO_MCP_LOCAL_SEARCH;
+function isCollectionNotFoundError(err) {
+    const status = err?.response?.status || err?.statusCode;
+    const errStr = String(err);
+    return status === 404
+        || errStr.toLowerCase().includes('not found')
+        || errStr.toLowerCase().includes('collection');
+}
+export const searchHandlers = {
+    search_documentation: async (args, { client }) => {
+        const { query } = args;
+        try {
+            if (useLocalSearch) {
+                const provider = getEmbeddingProvider();
+                const vectorStore = getVectorStore();
+                const queryVector = await provider.embedText(query);
+                const searchResults = await vectorStore.search(queryVector, SEARCH_RESULTS_DEFAULT_LIMIT);
+                return textResult(searchResults);
+            }
+            const response = await client.post('/mcp/search', {
+                query,
+                collection: 'documentation',
+                limit: SEARCH_RESULTS_DEFAULT_LIMIT,
+            });
+            return textResult(response.data.data);
+        }
+        catch (err) {
+            if (isCollectionNotFoundError(err)) {
+                logger.warn(`[search_documentation] Collection 'documentation' does not exist yet. Returning empty search results.`);
+                return textResult([]);
+            }
+            throw err;
+        }
+    },
+    search_flow_samples: async (args, { client }) => {
+        const { query, limit = SEARCH_RESULTS_DEFAULT_LIMIT } = args;
+        try {
+            if (useLocalSearch) {
+                const provider = getEmbeddingProvider();
+                const vectorStore = getVectorStore();
+                const queryVector = await provider.embedText(query);
+                const filter = { must: [{ key: 'type', match: { value: 'flow_sample' } }] };
+                const searchResults = await vectorStore.search(queryVector, limit, filter, 'flow_samples');
+                return textResult(searchResults);
+            }
+            const response = await client.post('/mcp/search', {
+                query,
+                collection: 'flow_samples',
+                limit,
+                filter: { must: [{ key: 'type', match: { value: 'flow_sample' } }] },
+            });
+            return textResult(response.data.data);
+        }
+        catch (err) {
+            if (isCollectionNotFoundError(err)) {
+                logger.warn(`[search_flow_samples] Collection 'flow_samples' does not exist yet. Returning empty search results.`);
+                return textResult([]);
+            }
+            throw err;
+        }
+    },
+    search_flow_steps: async (args, { client }) => {
+        const { query, limit = SEARCH_RESULTS_DEFAULT_LIMIT } = args;
+        try {
+            if (useLocalSearch) {
+                const provider = getEmbeddingProvider();
+                const vectorStore = getVectorStore();
+                const queryVector = await provider.embedText(query);
+                const filter = {
+                    should: [
+                        { key: 'type', match: { value: 'flow_step' } },
+                        { key: 'type', match: { value: 'flow_edge' } },
+                    ],
+                };
+                const searchResults = await vectorStore.search(queryVector, limit, filter, 'flow_samples');
+                return textResult(searchResults);
+            }
+            const response = await client.post('/mcp/search', {
+                query,
+                collection: 'flow_samples',
+                limit,
+                filter: {
+                    should: [
+                        { key: 'type', match: { value: 'flow_step' } },
+                        { key: 'type', match: { value: 'flow_edge' } },
+                    ],
+                },
+            });
+            return textResult(response.data.data);
+        }
+        catch (err) {
+            if (isCollectionNotFoundError(err)) {
+                logger.warn(`[search_flow_steps] Collection 'flow_samples' does not exist yet. Returning empty search results.`);
+                return textResult([]);
+            }
+            throw err;
+        }
+    },
+};
+//# sourceMappingURL=search.js.map

package/dist/tools/handlers/search.js.map

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

package/dist/tools/handlers/session.d.ts

@@ -0,0 +1,3 @@
+import { ToolHandler } from '../types.js';
+export declare const sessionHandlers: Record<string, ToolHandler>;
+//# sourceMappingURL=session.d.ts.map

package/dist/tools/handlers/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/session.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAkBvD,CAAC"}

package/dist/tools/handlers/session.js

@@ -0,0 +1,22 @@
+import { textResult } from '../helpers.js';
+import { getFlowStatesReport } from '../flow-state-machine.js';
+export const sessionHandlers = {
+    // eslint-disable-next-line @typescript-eslint/require-await
+    get_session_state: async (_args, { discoveryState }) => {
+        const stateReport = getFlowStatesReport(discoveryState);
+        return textResult({
+            discoveredComponents: Array.from(discoveryState.components),
+            discoveredCredentials: Array.from(discoveryState.credentials),
+            discoveredSecrets: Array.from(discoveryState.secrets),
+            componentsRequiringAuth: Array.from(discoveryState.componentsRequiringAuth),
+            componentVersions: Object.fromEntries(discoveryState.componentVersions),
+            inspectedFlows: Array.from(discoveryState.inspectedFlows),
+            flowBuildingGuideRead: discoveryState.flowBuildingGuideRead,
+            staticMetadataAvailable: Array.from(discoveryState.staticMetadataAvailable),
+            dynamicMetadataComponents: Array.from(discoveryState.dynamicMetadataComponents),
+            dynamicMetadataRetrieved: Array.from(discoveryState.dynamicMetadataRetrieved),
+            flowStateMachine: stateReport
+        });
+    }
+};
+//# sourceMappingURL=session.js.map

package/dist/tools/handlers/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/tools/handlers/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,CAAC,MAAM,eAAe,GAAgC;IAC1D,4DAA4D;IAC5D,iBAAiB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE;QACrD,MAAM,WAAW,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;QACxD,OAAO,UAAU,CAAC;YAChB,oBAAoB,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC;YAC3D,qBAAqB,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC;YAC7D,iBAAiB,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;YACrD,uBAAuB,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,uBAAuB,CAAC;YAC3E,iBAAiB,EAAE,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,iBAAiB,CAAC;YACvE,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC;YACzD,qBAAqB,EAAE,cAAc,CAAC,qBAAqB;YAC3D,uBAAuB,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,uBAAuB,CAAC;YAC3E,yBAAyB,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,yBAAyB,CAAC;YAC/E,wBAAwB,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,wBAAwB,CAAC;YAC7E,gBAAgB,EAAE,WAAW;SAC9B,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/tools/handlers.d.ts

@@ -0,0 +1,12 @@
+import { AxiosInstance } from 'axios';
+import { DiscoveryState } from './types.js';
+export { DiscoveryState } from './types.js';
+export declare function getDiscoveryState(client: AxiosInstance): DiscoveryState;
+export declare function handleToolCall(name: string, args: any, client: AxiosInstance): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/tools/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAKtC,OAAO,EAAE,cAAc,EAAe,MAAM,YAAY,CAAC;AAgBzD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAkBvE;AAwCD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,aAAa,GACpB,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,CAiFhF"}

package/dist/tools/handlers.js

@@ -0,0 +1,202 @@
+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';
+import { withFlowLock } from './flow-build.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,
+            dynamicMetadataRetrieved: new Set(),
+            dynamicMetadataComponents: new Set(),
+            staticMetadataAvailable: new Set()
+        };
+    }
+    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}`);
+    }
+    const execute = () => handler(args, { client, discoveryState });
+    return args.flowId ? await withFlowLock(client, args.flowId, execute) : await execute();
+}
+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,44 @@
+/**
+ * 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 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;AAQD,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"}