@tocharianou/mcp-server-kibana 0.6.1

package/dist/src/openapi-simplifier.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Smart OpenAPI Simplifier
+ * Converts verbose OpenAPI Spec into compact format that LLM can easily understand
+ */
+interface SimplifiedParam {
+    name: string;
+    in: string;
+    required: boolean;
+    type: string;
+    description?: string;
+}
+interface SimplifiedEndpoint {
+    method: string;
+    path: string;
+    summary?: string;
+    description?: string;
+    params: SimplifiedParam[];
+    requestBody?: string;
+    responses: Record<string, string>;
+}
+/**
+ * Convert JSON Schema to TypeScript Interface style string
+ */
+export declare function schemaToTsType(schema: any, indentLevel?: number): string;
+/**
+ * Simplify API endpoint details
+ */
+export declare function simplifyEndpointDetail(endpoint: any): SimplifiedEndpoint;
+/**
+ * Format to Markdown for LLM readability
+ */
+export declare function formatEndpointToMarkdown(detail: SimplifiedEndpoint): string;
+export {};

package/dist/src/openapi-simplifier.js

@@ -0,0 +1,122 @@
+/**
+ * Convert JSON Schema to TypeScript Interface style string
+ */
+export function schemaToTsType(schema, indentLevel = 0) {
+    if (!schema)
+        return 'any';
+    const indent = '  '.repeat(indentLevel);
+    // Handle references (already resolved in base-tools, but for robustness)
+    if (schema.$ref) {
+        return schema.$ref.split('/').pop() || 'object';
+    }
+    // Handle basic types
+    switch (schema.type) {
+        case 'string':
+            if (schema.enum)
+                return `enum<${schema.enum.map((e) => `'${e}'`).join(' | ')}>`;
+            return 'string';
+        case 'number':
+        case 'integer':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'array':
+            const itemType = schemaToTsType(schema.items, indentLevel);
+            return `${itemType}[]`;
+    }
+    // Handle objects
+    if (schema.type === 'object' || schema.properties) {
+        if (!schema.properties && !schema.additionalProperties)
+            return 'object';
+        let lines = [];
+        lines.push('{');
+        if (schema.properties) {
+            for (const [key, prop] of Object.entries(schema.properties)) {
+                const isRequired = schema.required?.includes(key);
+                const propSchema = prop;
+                const propType = schemaToTsType(propSchema, indentLevel + 1);
+                const desc = propSchema.description ? ` // ${propSchema.description.slice(0, 50)}${propSchema.description.length > 50 ? '...' : ''}` : '';
+                lines.push(`${indent}  ${key}${isRequired ? '' : '?'}: ${propType};${desc}`);
+            }
+        }
+        if (schema.additionalProperties) {
+            lines.push(`${indent}  [key: string]: any;`);
+        }
+        lines.push(`${indent}}`);
+        return lines.join('\n');
+    }
+    // Handle union types (oneOf, anyOf, allOf)
+    if (schema.oneOf)
+        return schema.oneOf.map((s) => schemaToTsType(s, indentLevel)).join(' | ');
+    if (schema.anyOf)
+        return schema.anyOf.map((s) => schemaToTsType(s, indentLevel)).join(' | ');
+    if (schema.allOf)
+        return schema.allOf.map((s) => schemaToTsType(s, indentLevel)).join(' & ');
+    return 'any';
+}
+/**
+ * Simplify API endpoint details
+ */
+export function simplifyEndpointDetail(endpoint) {
+    // 1. Simplify parameters
+    const params = (endpoint.parameters || []).map((p) => ({
+        name: p.name,
+        in: p.in,
+        required: p.required || false,
+        type: p.schema?.type || 'string',
+        description: p.description
+    }));
+    // 2. Simplify Request Body
+    let requestBody = '';
+    if (endpoint.requestBody?.content?.['application/json']?.schema) {
+        requestBody = schemaToTsType(endpoint.requestBody.content['application/json'].schema);
+    }
+    // 3. Simplify Responses
+    const responses = {};
+    if (endpoint.responses) {
+        for (const [code, resp] of Object.entries(endpoint.responses)) {
+            const respObj = resp;
+            responses[code] = respObj.description || '';
+        }
+    }
+    return {
+        method: endpoint.method,
+        path: endpoint.path,
+        summary: endpoint.summary,
+        description: endpoint.description,
+        params,
+        requestBody: requestBody || undefined,
+        responses
+    };
+}
+/**
+ * Format to Markdown for LLM readability
+ */
+export function formatEndpointToMarkdown(detail) {
+    let md = `## ${detail.method} ${detail.path}\n\n`;
+    if (detail.summary)
+        md += `**Summary**: ${detail.summary}\n\n`;
+    if (detail.description)
+        md += `**Description**: ${detail.description}\n\n`;
+    if (detail.params.length > 0) {
+        md += `### Parameters\n`;
+        detail.params.forEach(p => {
+            md += `- \`${p.name}\` (${p.in}, ${p.required ? 'required' : 'optional'}): ${p.description || ''}\n`;
+        });
+        md += '\n';
+    }
+    if (detail.requestBody) {
+        md += `### Request Body (TypeScript Interface)\n`;
+        md += "```typescript\n";
+        md += detail.requestBody;
+        md += "\n```\n\n";
+    }
+    if (Object.keys(detail.responses).length > 0) {
+        md += `### Responses\n`;
+        for (const [code, desc] of Object.entries(detail.responses)) {
+            md += `- **${code}**: ${desc}\n`;
+        }
+    }
+    return md;
+}
+//# sourceMappingURL=openapi-simplifier.js.map

package/dist/src/openapi-simplifier.js.map

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

package/dist/src/prompts.d.ts

@@ -0,0 +1,2 @@
+import type { ServerBase } from "./types";
+export declare function registerPrompts(server: ServerBase, defaultSpace: string): void;

package/dist/src/prompts.js

@@ -0,0 +1,91 @@
+import { z } from "zod";
+export function registerPrompts(server, defaultSpace) {
+    // 1. Kibana Tool Expert - Tool-based Kibana expert using tools defined in base-tools.ts
+    const kibanaToolExpertSchema = z.object({
+        query: z
+            .string()
+            .describe("User's question or request about Kibana"),
+        context: z
+            .string()
+            .optional()
+            .describe("Optional context information to help understand the user's needs or Kibana environment"),
+    });
+    server.prompt("kibana-tool-expert", kibanaToolExpertSchema, async (input) => {
+        return {
+            description: `Multi-space Kibana expert assistant (default space: '${defaultSpace}')`,
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `[System Instruction] You are a Kibana expert with multi-space capabilities. 
+
+[Default Space] ${defaultSpace}
+
+Key capabilities:
+1. All tools now support an optional 'space' parameter - you can specify different spaces for different operations
+2. When no space is specified, operations use the default space: '${defaultSpace}'
+3. You can discover available spaces using the 'get_available_spaces' tool
+4. Always inform the user which space an operation will target
+
+Important: When creating dashboards, saved objects, or other Kibana resources, you can specify the target space in the tool parameters. For example:
+- execute_api({method: "POST", path: "/api/saved_objects/dashboard", space: "marketing-team", body: {...}})
+
+${input.context ? `\n[Context Information]\n${input.context}` : ''}
+
+[User Question] ${input.query}`
+                    }
+                }
+            ]
+        };
+    });
+    // 2. Kibana Resource Helper - Assistant designed for clients that only support resources
+    const kibanaResourceHelperSchema = z.object({
+        query: z
+            .string()
+            .describe("User's question about Kibana API or resources"),
+        specificResource: z
+            .string()
+            .optional()
+            .describe("Optional specific resource name, such as 'kibana-api-paths' or 'kibana-api-path-detail'"),
+    });
+    server.prompt("kibana-resource-helper", kibanaResourceHelperSchema, async (input) => {
+        return {
+            description: `Multi-space Kibana API resource assistant (default space: '${defaultSpace}')`,
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `[System Instruction] You are a professional Kibana API resource expert with multi-space support.
+
+[Default Space] ${defaultSpace}
+
+Guidelines:
+1. You can guide users to use space-aware resource URIs
+2. Resources can include space parameters for targeted operations
+3. Available resources:
+   - kibana-api://paths - Get a list of all API paths, can be filtered with the search parameter
+   - kibana-api://path/{method}/{encoded_path} - Get detailed information for a specific API endpoint
+
+4. Space-aware API patterns:
+   - Most Kibana APIs support space-specific endpoints: /s/{space-id}/api/...
+   - When no space is specified, operations target the default space
+   - Users can specify target spaces in API calls
+
+5. Interaction Guidelines:
+   - Provide clear resource URI examples
+   - Explain space parameter usage
+   - Show how to construct space-aware API calls
+   - Provide complete workflow examples including space targeting
+
+${input.specificResource ? `\n[Specified Resource] The user mentioned a specific resource: ${input.specificResource}` : ''}
+
+[User Question] ${input.query}`
+                    }
+                }
+            ]
+        };
+    });
+}
+//# sourceMappingURL=prompts.js.map

package/dist/src/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,eAAe,CAAC,MAAkB,EAAE,YAAoB;IACtE,wFAAwF;IACxF,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;QACtC,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,CAAC,yCAAyC,CAAC;QACtD,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,wFAAwF,CAAC;KACtG,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CACX,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,EAAE,KAAK,EAA2B,EAAE;QACvC,OAAO;YACL,WAAW,EAAE,wDAAwD,YAAY,IAAI;YACrF,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;kBAEF,YAAY;;;;oEAIsC,YAAY;;;;;;;EAO9E,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,4BAA4B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE;;kBAEhD,KAAK,CAAC,KAAK,EAAE;qBAClB;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,yFAAyF;IACzF,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;QAC1C,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,CAAC,+CAA+C,CAAC;QAC5D,gBAAgB,EAAE,CAAC;aAChB,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,yFAAyF,CAAC;KACvG,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CACX,wBAAwB,EACxB,0BAA0B,EAC1B,KAAK,EAAE,KAAK,EAA2B,EAAE;QACvC,OAAO;YACL,WAAW,EAAE,8DAA8D,YAAY,IAAI;YAC3F,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;kBAEF,YAAY;;;;;;;;;;;;;;;;;;;;EAoB5B,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,kEAAkE,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE;;kBAExG,KAAK,CAAC,KAAK,EAAE;qBAClB;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/src/resources.d.ts

@@ -0,0 +1,2 @@
+import type { ServerBase, KibanaClient } from "./types";
+export declare function registerResources(server: ServerBase, kibanaClient: KibanaClient, spaceName: string): void;

package/dist/src/resources.js

@@ -0,0 +1,125 @@
+import fs from 'fs';
+import path from 'path';
+import yaml from 'js-yaml';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+// ESM-compatible __dirname
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+let apiEndpointIndex = [];
+let isIndexBuilt = false;
+let YAML_FILE_PATH = '';
+// Build the API index from the OpenAPI YAML file
+async function buildApiIndex() {
+    if (isIndexBuilt)
+        return;
+    // Only search for YAML file in the main directory
+    const possiblePaths = [
+        path.join(process.cwd(), 'kibana-openapi-source.yaml')
+    ];
+    for (const p of possiblePaths) {
+        if (fs.existsSync(p)) {
+            YAML_FILE_PATH = p;
+            break;
+        }
+    }
+    if (!YAML_FILE_PATH) {
+        isIndexBuilt = true;
+        return;
+    }
+    const yamlContent = fs.readFileSync(YAML_FILE_PATH, 'utf8');
+    const openApiDoc = yaml.load(yamlContent);
+    if (!openApiDoc || !openApiDoc.paths) {
+        isIndexBuilt = true;
+        return;
+    }
+    for (const [pathStr, pathObj] of Object.entries(openApiDoc.paths)) {
+        for (const [method, methodObj] of Object.entries(pathObj)) {
+            if (["get", "post", "put", "delete", "patch"].includes(method)) {
+                apiEndpointIndex.push({
+                    path: pathStr,
+                    method: method.toUpperCase(),
+                    description: methodObj.description,
+                    summary: methodObj.summary,
+                    parameters: methodObj.parameters,
+                    requestBody: methodObj.requestBody,
+                    responses: methodObj.responses,
+                    deprecated: methodObj.deprecated,
+                    tags: methodObj.tags
+                });
+            }
+        }
+    }
+    isIndexBuilt = true;
+}
+function searchApiEndpoints(query) {
+    if (!isIndexBuilt)
+        throw new Error('API index not built yet');
+    const q = query.toLowerCase();
+    return apiEndpointIndex.filter(e => e.path.toLowerCase().includes(q) ||
+        (e.description && e.description.toLowerCase().includes(q)) ||
+        (e.summary && e.summary.toLowerCase().includes(q)) ||
+        (e.tags && e.tags.some(tag => tag.toLowerCase().includes(q))));
+}
+export function registerResources(server, kibanaClient, spaceName) {
+    // 1. API path list resource
+    server.resource("kibana-api-paths", "kibana-api://paths", async (uri, params) => {
+        await buildApiIndex();
+        const search = params.search || "";
+        const endpoints = search ? searchApiEndpoints(search) : apiEndpointIndex;
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        space: spaceName,
+                        total_endpoints: endpoints.length,
+                        search_query: search || "all",
+                        endpoints: endpoints.map(e => ({
+                            method: e.method,
+                            path: e.path,
+                            summary: e.summary,
+                            description: e.description
+                        }))
+                    }, null, 2)
+                }
+            ]
+        };
+    });
+    // 2. Single API endpoint detail resource
+    server.resource("kibana-api-path-detail", "kibana-api://path/{method}/{encoded_path}", async (uri, params) => {
+        await buildApiIndex();
+        const method = params.method?.toUpperCase();
+        const path = decodeURIComponent(params.encoded_path);
+        const endpoint = apiEndpointIndex.find(e => e.method === method && e.path === path);
+        if (!endpoint) {
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: "application/json",
+                        text: JSON.stringify({
+                            space: spaceName,
+                            error: "API endpoint not found",
+                            requested: { method, path }
+                        }, null, 2)
+                    }
+                ]
+            };
+        }
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        space: spaceName,
+                        endpoint: endpoint
+                    }, null, 2)
+                }
+            ]
+        };
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/src/resources.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,150 @@
+import { z } from "zod";
+export declare const BaseSearchSchema: z.ZodObject<{
+    search: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    per_page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    per_page: number;
+    search?: string | undefined;
+}, {
+    search?: string | undefined;
+    page?: number | undefined;
+    per_page?: number | undefined;
+}>;
+export declare const BaseIdSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export declare const BaseNameSchema: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+export declare const BaseDescriptionSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    description?: string | undefined;
+}, {
+    description?: string | undefined;
+}>;
+export declare const KibanaConfigSchema: z.ZodObject<{
+    url: z.ZodString;
+    username: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
+    cookies: z.ZodOptional<z.ZodString>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    caCert: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    maxRetries: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    defaultSpace: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    timeout: number;
+    maxRetries: number;
+    defaultSpace: string;
+    username?: string | undefined;
+    password?: string | undefined;
+    cookies?: string | undefined;
+    apiKey?: string | undefined;
+    caCert?: string | undefined;
+}, {
+    url: string;
+    username?: string | undefined;
+    password?: string | undefined;
+    cookies?: string | undefined;
+    apiKey?: string | undefined;
+    caCert?: string | undefined;
+    timeout?: number | undefined;
+    maxRetries?: number | undefined;
+    defaultSpace?: string | undefined;
+}>;
+export type KibanaConfig = z.infer<typeof KibanaConfigSchema>;
+export interface ToolResponse {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export interface ResourceResponse {
+    contents: Array<{
+        uri: string;
+        mimeType: string;
+        text?: string;
+        binary?: Uint8Array;
+        size?: number;
+    }>;
+}
+export interface PromptResponse {
+    description?: string;
+    messages: Array<{
+        role: "user" | "assistant" | "system";
+        content: {
+            type: "text";
+            text: string;
+        };
+    }>;
+}
+export interface KibanaClient {
+    get: (url: string, options?: {
+        params?: any;
+        headers?: any;
+        space?: string;
+    }) => Promise<any>;
+    post: (url: string, data?: any, options?: {
+        headers?: any;
+        space?: string;
+    }) => Promise<any>;
+    put: (url: string, data?: any, options?: {
+        headers?: any;
+        space?: string;
+    }) => Promise<any>;
+    delete: (url: string, options?: {
+        headers?: any;
+        space?: string;
+    }) => Promise<any>;
+    patch?: (url: string, data?: any, options?: {
+        headers?: any;
+        space?: string;
+    }) => Promise<any>;
+}
+export interface ServerBase {
+    tool: {
+        (name: string, cb: (extra: RequestHandlerExtra) => Promise<ToolResponse> | ToolResponse): void;
+        (name: string, description: string, schema: any, handler: (args: any, extra: RequestHandlerExtra) => Promise<ToolResponse> | ToolResponse): void;
+    };
+    prompt: {
+        (name: string, schema: any, handler: (args: any, extra?: RequestHandlerExtra) => Promise<PromptResponse> | PromptResponse): void;
+    };
+    resource: {
+        (name: string, uri: string, handler: (uri: URL, params: Record<string, string>, extra?: RequestHandlerExtra) => Promise<ResourceResponse> | ResourceResponse): void;
+        (name: string, template: any, handler: (uri: URL, params: Record<string, string>, extra?: RequestHandlerExtra) => Promise<ResourceResponse> | ResourceResponse): void;
+    };
+}
+export interface RequestHandlerExtra {
+    [key: string]: unknown;
+    signal: AbortSignal;
+}
+export declare class KibanaError extends Error {
+    statusCode?: number | undefined;
+    details?: any | undefined;
+    constructor(message: string, statusCode?: number | undefined, details?: any | undefined);
+}
+export interface ToolRegistrationResult {
+    name: string;
+    success: boolean;
+    error?: string;
+}
+export interface ServerCreationOptions {
+    name: string;
+    version: string;
+    transport?: any;
+    config: KibanaConfig;
+    description?: string;
+}

package/dist/src/types.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+// Base schema types
+export const BaseSearchSchema = z.object({
+    search: z.string().optional(),
+    page: z.number().optional().default(1),
+    per_page: z.number().optional().default(20)
+});
+export const BaseIdSchema = z.object({
+    id: z.string()
+});
+export const BaseNameSchema = z.object({
+    name: z.string()
+});
+export const BaseDescriptionSchema = z.object({
+    description: z.string().optional()
+});
+// Configuration schema
+export const KibanaConfigSchema = z.object({
+    url: z.string().trim().min(1, "Kibana URL cannot be empty").url("Invalid Kibana URL format"),
+    username: z.string().optional(),
+    password: z.string().optional(),
+    cookies: z.string().optional(),
+    apiKey: z.string().optional(),
+    caCert: z.string().optional(),
+    timeout: z.number().optional().default(30000),
+    maxRetries: z.number().optional().default(3),
+    defaultSpace: z.string().optional().default('default'),
+});
+// Error types
+export class KibanaError extends Error {
+    constructor(message, statusCode, details) {
+        super(message);
+        this.statusCode = statusCode;
+        this.details = details;
+        this.name = "KibanaError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,oBAAoB;AACpB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACtC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAC5C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;CACf,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,uBAAuB;AACvB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,4BAA4B,CAAC,CAAC,GAAG,CAAC,2BAA2B,CAAC;IAC5F,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC7C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;CACvD,CAAC,CAAC;AAoEH,cAAc;AACd,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YACE,OAAe,EACR,UAAmB,EACnB,OAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,eAAU,GAAV,UAAU,CAAS;QACnB,YAAO,GAAP,OAAO,CAAM;QAGpB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/src/vl_create_tools.d.ts

@@ -0,0 +1,5 @@
+import { ServerBase, KibanaClient } from './types.js';
+/**
+ * Register VL (Visualization Layer) create tools with the MCP server
+ */
+export declare function registerVLCreateTools(server: ServerBase, kibanaClient: KibanaClient): void;