@tocharianou/mcp-server-kibana 0.6.1

package/dist/src/vl_create_tools.js

@@ -0,0 +1,264 @@
+import { z } from 'zod';
+/**
+ * Implementation function for creating a Kibana saved object.
+ *
+ * @param kibanaClient - The Kibana client instance
+ * @param type - The saved object type
+ * @param attributes - The object attributes
+ * @param id - Optional: specific ID for the object (if not provided, auto-generated)
+ * @param overwrite - Whether to overwrite existing object with same ID
+ * @param references - Array of references to other saved objects
+ * @param initialNamespaces - Array of initial namespaces for the object
+ * @param space - The Kibana space (optional)
+ * @returns Promise<ToolResponse> - The tool response containing the created object data
+ */
+async function vl_create_saved_object_impl(kibanaClient, type, attributes, id, overwrite, references, initialNamespaces, space) {
+    try {
+        // Validate required parameters
+        if (!type) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Error: 'type' parameter is required. Please specify the saved object type (e.g., 'dashboard', 'visualization', 'index-pattern')."
+                    }
+                ],
+                isError: true
+            };
+        }
+        if (!attributes || typeof attributes !== 'object') {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Error: 'attributes' parameter is required and must be an object containing the saved object properties."
+                    }
+                ],
+                isError: true
+            };
+        }
+        // Validate attributes based on type
+        const validationResult = validateAttributesByType(type, attributes);
+        if (!validationResult.valid) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: Invalid attributes for type '${type}': ${validationResult.error}`
+                    }
+                ],
+                isError: true
+            };
+        }
+        // Prepare request body
+        const requestBody = {
+            attributes
+        };
+        if (references && references.length > 0) {
+            requestBody.references = references;
+        }
+        if (initialNamespaces && initialNamespaces.length > 0) {
+            requestBody.initialNamespaces = initialNamespaces;
+        }
+        // Prepare URL and query parameters
+        const params = new URLSearchParams();
+        if (overwrite) {
+            params.append('overwrite', 'true');
+        }
+        // Choose API endpoint based on whether ID is specified
+        let url;
+        if (id) {
+            // Create with specific ID
+            url = `/api/saved_objects/${encodeURIComponent(type)}/${encodeURIComponent(id)}${params.toString() ? '?' + params.toString() : ''}`;
+        }
+        else {
+            // Create with auto-generated ID
+            url = `/api/saved_objects/${encodeURIComponent(type)}${params.toString() ? '?' + params.toString() : ''}`;
+        }
+        // Make the API call
+        const response = await kibanaClient.post(url, requestBody, { space });
+        // Format the response
+        const result = {
+            id: response.id,
+            type: response.type,
+            version: response.version,
+            updated_at: response.updated_at,
+            created_at: response.created_at,
+            namespaces: response.namespaces || [],
+        };
+        // Add attributes information
+        if (response.attributes) {
+            result.attributes = response.attributes;
+            // Add common fields for easier access
+            if (response.attributes.title) {
+                result.title = response.attributes.title;
+            }
+            if (response.attributes.description) {
+                result.description = response.attributes.description;
+            }
+        }
+        // Add references if present
+        if (response.references && response.references.length > 0) {
+            result.references = response.references;
+        }
+        // Add migration information if present
+        if (response.migrationVersion) {
+            result.migrationVersion = response.migrationVersion;
+        }
+        if (response.coreMigrationVersion) {
+            result.coreMigrationVersion = response.coreMigrationVersion;
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Successfully created ${type} saved object:\n\n${JSON.stringify(result, null, 2)}`
+                }
+            ]
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        // Handle common error cases
+        if (errorMessage.includes('409') || errorMessage.includes('conflict')) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Conflict error: A saved object with type '${type}' and id '${id}' already exists. Use 'overwrite: true' to replace it, or omit the 'id' parameter to create with auto-generated ID.`
+                    }
+                ],
+                isError: true
+            };
+        }
+        if (errorMessage.includes('400')) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Bad request error: ${errorMessage}\n\nPossible causes:\n- Invalid object type '${type}'\n- Invalid attributes structure\n- Missing required fields\n- Invalid references format`
+                    }
+                ],
+                isError: true
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Failed to create saved object: ${errorMessage}`
+                }
+            ],
+            isError: true
+        };
+    }
+}
+/**
+ * Validate attributes based on saved object type
+ */
+function validateAttributesByType(type, attributes) {
+    // Common validation: title is usually required
+    if (!attributes.title || typeof attributes.title !== 'string') {
+        return { valid: false, error: "Missing required field 'title' (must be a non-empty string)" };
+    }
+    // Type-specific validation
+    switch (type) {
+        case 'dashboard':
+            // Dashboard-specific validation
+            if (attributes.panelsJSON && typeof attributes.panelsJSON !== 'string') {
+                return { valid: false, error: "Field 'panelsJSON' must be a JSON string" };
+            }
+            if (attributes.optionsJSON && typeof attributes.optionsJSON !== 'string') {
+                return { valid: false, error: "Field 'optionsJSON' must be a JSON string" };
+            }
+            if (attributes.timeRestore !== undefined && typeof attributes.timeRestore !== 'boolean') {
+                return { valid: false, error: "Field 'timeRestore' must be a boolean" };
+            }
+            break;
+        case 'visualization':
+            // Visualization-specific validation
+            if (attributes.visState && typeof attributes.visState !== 'string') {
+                return { valid: false, error: "Field 'visState' must be a JSON string" };
+            }
+            if (attributes.uiStateJSON && typeof attributes.uiStateJSON !== 'string') {
+                return { valid: false, error: "Field 'uiStateJSON' must be a JSON string" };
+            }
+            break;
+        case 'index-pattern':
+            // Index pattern specific validation
+            if (!attributes.title) {
+                return { valid: false, error: "Index pattern requires 'title' field (index pattern string)" };
+            }
+            if (attributes.timeFieldName && typeof attributes.timeFieldName !== 'string') {
+                return { valid: false, error: "Field 'timeFieldName' must be a string" };
+            }
+            break;
+        case 'search':
+            // Saved search validation
+            if (attributes.columns && !Array.isArray(attributes.columns)) {
+                return { valid: false, error: "Field 'columns' must be an array" };
+            }
+            break;
+        case 'lens':
+            // Lens visualization validation
+            if (!attributes.state && !attributes.expression) {
+                return { valid: false, error: "Lens visualization requires either 'state' or 'expression' field" };
+            }
+            break;
+        case 'map':
+            // Map validation
+            if (attributes.layerListJSON && typeof attributes.layerListJSON !== 'string') {
+                return { valid: false, error: "Field 'layerListJSON' must be a JSON string" };
+            }
+            break;
+        case 'canvas-workpad':
+            // Canvas workpad validation
+            if (!attributes.name) {
+                return { valid: false, error: "Canvas workpad requires 'name' field" };
+            }
+            if (attributes.pages && !Array.isArray(attributes.pages)) {
+                return { valid: false, error: "Field 'pages' must be an array" };
+            }
+            break;
+        default:
+            // For unknown types, just check basic structure
+            break;
+    }
+    return { valid: true };
+}
+/**
+ * Register VL (Visualization Layer) create tools with the MCP server
+ */
+export function registerVLCreateTools(server, kibanaClient) {
+    // Tool: Create a Kibana saved object
+    server.tool("vl_create_saved_object", "Create a new Kibana saved object (dashboard, visualization, index-pattern, search, config, lens, map, tag, canvas-workpad, canvas-element, etc.). This is a universal tool that can create any type of saved object by specifying the type and attributes. Each object type has specific attribute requirements. IMPORTANT: The 'title' field is required for most object types. Complex fields like panelsJSON, visState should be JSON strings.", z.object({
+        type: z.union([z.string(), z.array(z.string())]).transform(val => {
+            if (Array.isArray(val))
+                return val[0]; // Take first type for single object creation
+            if (typeof val === 'string') {
+                try {
+                    const parsed = JSON.parse(val);
+                    return Array.isArray(parsed) ? parsed[0] : parsed;
+                }
+                catch {
+                    const types = val.split(',').map(s => s.trim()).filter(s => s);
+                    return types[0]; // Take first type
+                }
+            }
+            return val;
+        }).describe("REQUIRED: The saved object type. Common types: 'dashboard', 'visualization', 'index-pattern', 'search', 'config', 'lens', 'map', 'tag', 'canvas-workpad', 'canvas-element'. Supports multiple formats but will use first type for single object creation."),
+        attributes: z.record(z.any()).describe("REQUIRED: Object containing the saved object attributes. Structure varies by type. Common fields: 'title' (required for most types), 'description'. Dashboard: 'panelsJSON', 'timeRestore'. Visualization: 'visState', 'uiStateJSON'. Index-pattern: 'timeFieldName'. All JSON fields should be strings."),
+        id: z.string().optional().describe("OPTIONAL: Specific ID for the saved object. If not provided, Kibana will auto-generate a unique ID. Use this when you need a predictable ID or when recreating objects."),
+        overwrite: z.boolean().optional().describe("OPTIONAL: Whether to overwrite an existing object with the same ID. Only relevant when 'id' is specified. Default: false. Set to true to replace existing objects."),
+        references: z.array(z.object({
+            id: z.string().describe("ID of the referenced object"),
+            type: z.string().describe("Type of the referenced object"),
+            name: z.string().describe("Reference name used in the object")
+        })).optional().describe("OPTIONAL: Array of references to other saved objects. Used to link objects together (e.g., dashboard panels referencing visualizations). Each reference needs id, type, and name."),
+        initialNamespaces: z.array(z.string()).optional().describe("OPTIONAL: Array of initial namespaces for the object. Used for multi-tenant setups. If not specified, object will be created in the default namespace."),
+        space: z.string().optional().describe("Target Kibana space (optional, defaults to configured space)")
+    }), async (params) => {
+        return await vl_create_saved_object_impl(kibanaClient, params.type, params.attributes, params.id, params.overwrite, params.references, params.initialNamespaces, params.space);
+    });
+}
+//# sourceMappingURL=vl_create_tools.js.map

package/dist/src/vl_create_tools.js.map

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

package/dist/src/vl_delete_tools.d.ts

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

package/dist/src/vl_delete_tools.js

@@ -0,0 +1,158 @@
+import { z } from 'zod';
+/**
+ * Implementation function for bulk deleting Kibana saved objects.
+ *
+ * @param kibanaClient - The Kibana client instance
+ * @param objects - Array of objects to delete, each containing type and id
+ * @param force - Force deletion of objects that exist in multiple namespaces
+ * @param space - The Kibana space (optional)
+ * @returns Promise<ToolResponse> - The tool response containing the bulk delete results
+ */
+async function vl_bulk_delete_saved_objects_impl(kibanaClient, objects, force, space) {
+    try {
+        // Validate input
+        if (!objects || objects.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Error: No objects specified for deletion. Please provide at least one object with type and id."
+                    }
+                ],
+                isError: true
+            };
+        }
+        // Validate each object has required fields
+        for (let i = 0; i < objects.length; i++) {
+            const obj = objects[i];
+            if (!obj.type || !obj.id) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: Object at index ${i} is missing required 'type' or 'id' field. Each object must have both 'type' and 'id'.`
+                        }
+                    ],
+                    isError: true
+                };
+            }
+        }
+        // Prepare request body
+        const requestBody = objects.map(obj => ({
+            type: obj.type,
+            id: obj.id
+        }));
+        // Prepare URL with query parameters
+        const params = new URLSearchParams();
+        if (force) {
+            params.append('force', 'true');
+        }
+        const url = `/api/saved_objects/_bulk_delete${params.toString() ? '?' + params.toString() : ''}`;
+        // Make the API call
+        const response = await kibanaClient.post(url, requestBody, { space });
+        // Process the response
+        const statuses = response.statuses || [];
+        // Count results
+        const successCount = statuses.filter((status) => status.success).length;
+        const errorCount = statuses.filter((status) => !status.success).length;
+        // Format detailed results
+        const results = statuses.map((status) => {
+            const result = {
+                type: status.type,
+                id: status.id,
+                success: status.success
+            };
+            if (status.error) {
+                result.error = {
+                    statusCode: status.error.statusCode,
+                    error: status.error.error,
+                    message: status.error.message
+                };
+            }
+            return result;
+        });
+        // Create summary
+        const summary = `Bulk delete operation completed. ${successCount} objects deleted successfully, ${errorCount} errors occurred.`;
+        const responseText = [
+            summary,
+            '',
+            'Detailed Results:',
+            JSON.stringify(results, null, 2)
+        ].join('\n');
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: responseText
+                }
+            ],
+            isError: errorCount > 0
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        // Handle common error cases
+        if (errorMessage.includes('400')) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Bad request error during bulk delete: ${errorMessage}\n\nPossible causes:\n- Invalid object type or ID format\n- Objects exist in multiple namespaces (try using force=true)\n- Missing required parameters`
+                    }
+                ],
+                isError: true
+            };
+        }
+        if (errorMessage.includes('404')) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Some objects not found during bulk delete: ${errorMessage}\n\nThis may indicate that one or more objects have already been deleted or never existed.`
+                    }
+                ],
+                isError: true
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Failed to bulk delete saved objects: ${errorMessage}`
+                }
+            ],
+            isError: true
+        };
+    }
+}
+/**
+ * Register VL (Visualization Layer) delete tools with the MCP server
+ */
+export function registerVLDeleteTools(server, kibanaClient) {
+    // Tool: Bulk delete Kibana saved objects
+    server.tool("vl_bulk_delete_saved_objects", "Bulk delete multiple Kibana saved objects by type and ID. This is a destructive operation that permanently removes saved objects (dashboard, visualization, index-pattern, search, config, lens, map, tag, canvas-workpad, canvas-element, etc.). WARNING: Deleted objects cannot be recovered. Use with caution. IMPORTANT: Objects that exist in multiple namespaces require the 'force' parameter to be deleted.", z.object({
+        objects: z.array(z.object({
+            type: z.union([z.string(), z.array(z.string())]).transform(val => {
+                if (Array.isArray(val))
+                    return val[0]; // Take first type for single object deletion
+                if (typeof val === 'string') {
+                    try {
+                        const parsed = JSON.parse(val);
+                        return Array.isArray(parsed) ? parsed[0] : parsed;
+                    }
+                    catch {
+                        const types = val.split(',').map(s => s.trim()).filter(s => s);
+                        return types[0]; // Take first type
+                    }
+                }
+                return val;
+            }).describe("REQUIRED: The saved object type. Common types: 'dashboard', 'visualization', 'index-pattern', 'search', 'config', 'lens', 'map', 'tag', 'canvas-workpad', 'canvas-element'. Supports multiple formats: single string 'dashboard', array ['dashboard'], JSON string '[\"dashboard\"]', or comma-separated 'dashboard,visualization' (will use first type for single object deletion)."),
+            id: z.string().describe("REQUIRED: The saved object ID. This is the unique identifier for the specific object you want to delete.")
+        })).min(1).describe("REQUIRED: Array of objects to delete. Each object must have 'type' and 'id' fields. Minimum 1 object required."),
+        force: z.boolean().optional().describe("Force deletion of objects that exist in multiple namespaces. Set to true if you get an error about objects existing in multiple namespaces. WARNING: This also deletes legacy URL aliases and can place heavy load on Kibana. Default: false."),
+        space: z.string().optional().describe("Target Kibana space (optional, defaults to configured space)")
+    }), async (params) => {
+        return await vl_bulk_delete_saved_objects_impl(kibanaClient, params.objects, params.force, params.space);
+    });
+}
+//# sourceMappingURL=vl_delete_tools.js.map

package/dist/src/vl_delete_tools.js.map

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

package/dist/src/vl_get_tools.d.ts

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

package/dist/src/vl_get_tools.js

@@ -0,0 +1,201 @@
+import { z } from 'zod';
+/**
+ * Implementation function for getting a single Kibana saved object by type and ID.
+ *
+ * @param kibanaClient - The Kibana client instance
+ * @param type - The saved object type (e.g., 'dashboard', 'visualization', 'index-pattern')
+ * @param id - The saved object ID
+ * @param useResolve - Whether to use resolve API (handles legacy URL aliases)
+ * @param space - The Kibana space (optional)
+ * @returns Promise<ToolResponse> - The tool response containing the saved object data
+ */
+async function vl_get_saved_object_impl(kibanaClient, type, id, useResolve, space) {
+    try {
+        // Choose API endpoint based on useResolve flag
+        const endpoint = useResolve
+            ? `/api/saved_objects/resolve/${encodeURIComponent(type)}/${encodeURIComponent(id)}`
+            : `/api/saved_objects/${encodeURIComponent(type)}/${encodeURIComponent(id)}`;
+        const response = await kibanaClient.get(endpoint, { space });
+        // Format the response data
+        const savedObject = response;
+        if (!savedObject) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No saved object found with type '${type}' and id '${id}'`
+                    }
+                ],
+                isError: true
+            };
+        }
+        // Create formatted result with essential information
+        const result = {
+            id: savedObject.id,
+            type: savedObject.type,
+            updated_at: savedObject.updated_at,
+            created_at: savedObject.created_at,
+            version: savedObject.version,
+            managed: savedObject.managed || false,
+            namespaces: savedObject.namespaces || [],
+        };
+        // Add attributes if they exist
+        if (savedObject.attributes) {
+            if (savedObject.attributes.title !== undefined) {
+                result.title = savedObject.attributes.title;
+            }
+            if (savedObject.attributes.description !== undefined) {
+                result.description = savedObject.attributes.description;
+            }
+            // Type-specific attributes
+            if (savedObject.type === 'dashboard') {
+                if (savedObject.attributes.panelsJSON !== undefined) {
+                    try {
+                        const panels = JSON.parse(savedObject.attributes.panelsJSON);
+                        result.panelCount = panels.length;
+                        result.panels = panels.map((panel) => ({
+                            id: panel.panelIndex,
+                            type: panel.type,
+                            title: panel.title || 'Untitled Panel'
+                        }));
+                    }
+                    catch {
+                        // Ignore parsing errors
+                    }
+                }
+                if (savedObject.attributes.timeRestore !== undefined) {
+                    result.timeRestore = savedObject.attributes.timeRestore;
+                }
+                if (savedObject.attributes.timeTo !== undefined) {
+                    result.timeTo = savedObject.attributes.timeTo;
+                }
+                if (savedObject.attributes.timeFrom !== undefined) {
+                    result.timeFrom = savedObject.attributes.timeFrom;
+                }
+            }
+            if (savedObject.type === 'visualization') {
+                if (savedObject.attributes.visState !== undefined) {
+                    try {
+                        const visState = JSON.parse(savedObject.attributes.visState);
+                        result.visualizationType = visState.type;
+                        result.visualizationTitle = visState.title;
+                    }
+                    catch {
+                        // Ignore parsing errors
+                    }
+                }
+                if (savedObject.attributes.kibanaSavedObjectMeta !== undefined) {
+                    try {
+                        const meta = JSON.parse(savedObject.attributes.kibanaSavedObjectMeta.searchSourceJSON);
+                        if (meta.index) {
+                            result.indexPattern = meta.index;
+                        }
+                    }
+                    catch {
+                        // Ignore parsing errors
+                    }
+                }
+            }
+            if (savedObject.type === 'index-pattern') {
+                if (savedObject.attributes.title !== undefined) {
+                    result.indexPatternTitle = savedObject.attributes.title;
+                }
+                if (savedObject.attributes.timeFieldName !== undefined) {
+                    result.timeFieldName = savedObject.attributes.timeFieldName;
+                }
+                if (savedObject.attributes.fieldCount !== undefined) {
+                    result.fieldCount = savedObject.attributes.fieldCount;
+                }
+            }
+            if (savedObject.type === 'search') {
+                if (savedObject.attributes.columns !== undefined) {
+                    result.columns = savedObject.attributes.columns;
+                }
+                if (savedObject.attributes.sort !== undefined) {
+                    result.sort = savedObject.attributes.sort;
+                }
+            }
+            // Include full attributes for completeness (can be large)
+            result.attributes = savedObject.attributes;
+        }
+        // Add references if they exist
+        if (savedObject.references && savedObject.references.length > 0) {
+            result.references = savedObject.references.map((ref) => ({
+                id: ref.id,
+                type: ref.type,
+                name: ref.name
+            }));
+        }
+        // Add resolve-specific information if using resolve API
+        if (useResolve && savedObject.outcome) {
+            result.outcome = savedObject.outcome;
+            if (savedObject.alias_target_id) {
+                result.alias_target_id = savedObject.alias_target_id;
+            }
+            if (savedObject.alias_purpose) {
+                result.alias_purpose = savedObject.alias_purpose;
+            }
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Successfully retrieved saved object:\n\n${JSON.stringify(result, null, 2)}`
+                }
+            ]
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        // Handle common error cases
+        if (errorMessage.includes('404') || errorMessage.includes('Not Found')) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Saved object not found: type '${type}', id '${id}'. Please verify the type and ID are correct.`
+                    }
+                ],
+                isError: true
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Failed to retrieve saved object: ${errorMessage}`
+                }
+            ],
+            isError: true
+        };
+    }
+}
+/**
+ * Register VL (Visualization Layer) get tools with the MCP server
+ */
+export function registerVLGetTools(server, kibanaClient) {
+    // Tool: Get a single Kibana saved object by type and ID
+    server.tool("vl_get_saved_object", "Get a single Kibana saved object by type and ID. This is a universal tool that can retrieve any type of saved object (dashboard, visualization, index-pattern, search, config, lens, map, tag, canvas-workpad, canvas-element, etc.) by its exact type and ID. Use this when you know the specific object you want to retrieve. PERFORMANCE: This is much faster than searching when you have the exact type and ID.", z.object({
+        type: z.union([z.string(), z.array(z.string())]).transform(val => {
+            if (Array.isArray(val))
+                return val[0]; // Take first type for single object retrieval
+            if (typeof val === 'string') {
+                try {
+                    const parsed = JSON.parse(val);
+                    return Array.isArray(parsed) ? parsed[0] : parsed;
+                }
+                catch {
+                    const types = val.split(',').map(s => s.trim()).filter(s => s);
+                    return types[0]; // Take first type
+                }
+            }
+            return val;
+        }).describe("REQUIRED: The saved object type. Common types: 'dashboard', 'visualization', 'index-pattern', 'search', 'config', 'lens', 'map', 'tag', 'canvas-workpad', 'canvas-element'. Supports multiple formats: single string 'dashboard', array ['dashboard'], JSON string '[\"dashboard\"]', or comma-separated 'dashboard,visualization' (will use first type for single object retrieval)."),
+        id: z.string().describe("REQUIRED: The saved object ID. This is the unique identifier for the specific object you want to retrieve."),
+        useResolve: z.boolean().optional().describe("Use resolve API instead of get API. The resolve API can handle legacy URL aliases from object ID migrations. Use this if you're having trouble finding an object that may have had its ID changed during Kibana upgrades. Default: false."),
+        space: z.string().optional().describe("Target Kibana space (optional, defaults to configured space)")
+    }), async (params) => {
+        return await vl_get_saved_object_impl(kibanaClient, params.type, params.id, params.useResolve, params.space);
+    });
+}
+//# sourceMappingURL=vl_get_tools.js.map