@vfarcic/dot-ai 0.109.0 → 0.111.0

package/dist/core/ai-provider.interface.d.ts

@@ -18,6 +18,8 @@ export interface AIResponse {
     usage: {
         input_tokens: number;
         output_tokens: number;
+        cache_creation_input_tokens?: number;
+        cache_read_input_tokens?: number;
     };
 }
 /**
@@ -122,11 +124,19 @@ export interface AgenticResult {
         input: any;
         output: any;
     }>;
-    /** Token usage statistics */
+    /** Token usage statistics including cache metrics */
     totalTokens: {
         input: number;
         output: number;
+        cacheCreation?: number;
+        cacheRead?: number;
     };
+    /** Execution status (PRD #143 Decision 5) */
+    status?: 'success' | 'failed' | 'timeout' | 'parse_error';
+    /** Reason for loop completion (PRD #143 Decision 5) */
+    completionReason?: 'investigation_complete' | 'max_iterations' | 'parse_failure' | 'model_stopped' | 'error';
+    /** Specific model version used (PRD #143 Decision 5) */
+    modelVersion?: string;
 }
 /**
  * AI Provider Interface
@@ -189,20 +199,5 @@ export interface AIProvider {
      * @returns Agentic result with final message, iterations, tool calls, and token usage
      */
     toolLoop(config: ToolLoopConfig): Promise<AgenticResult>;
-    /**
-     * Single-shot message with tool calling enabled (NEW - PRD #136)
-     *
-     * AI can call tools, but only processes one round.
-     * Useful for simple tool use cases that don't require iteration.
-     *
-     * @param message The message/prompt to send
-     * @param tools Available tools for this request
-     * @param toolExecutor Function to execute tool calls
-     * @param operation Optional operation identifier for debugging
-     * @returns AI response with content, usage, and any tool calls made
-     */
-    sendMessageWithTools(message: string, tools: AITool[], toolExecutor: ToolExecutor, operation?: string): Promise<AIResponse & {
-        toolCalls?: any[];
-    }>;
 }
 //# sourceMappingURL=ai-provider.interface.d.ts.map

package/dist/core/ai-provider.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-provider.interface.d.ts","sourceRoot":"","sources":["../../src/core/ai-provider.interface.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ai-provider.interface.d.ts","sourceRoot":"","sources":["../../src/core/ai-provider.interface.ts"],"names":[],"mappings":"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"}

package/dist/core/kubectl-tools.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Kubectl Tools for AI-Powered Investigation
+ *
+ * Shared tool definitions and executor for kubectl operations.
+ * Used by remediation, diagnostics, and other investigation workflows.
+ *
+ * PRD #143: Tool-Based Remediation with Observability Data Sources
+ */
+import { AITool } from './ai-provider.interface';
+/**
+ * Tool: kubectl_api_resources
+ * Get list of all available Kubernetes API resources in the cluster
+ */
+export declare const KUBECTL_API_RESOURCES_TOOL: AITool;
+/**
+ * Tool: kubectl_get
+ * Get Kubernetes resources with their current state
+ */
+export declare const KUBECTL_GET_TOOL: AITool;
+/**
+ * Tool: kubectl_describe
+ * Get detailed information about Kubernetes resources
+ */
+export declare const KUBECTL_DESCRIBE_TOOL: AITool;
+/**
+ * Tool: kubectl_logs
+ * Get container logs from pods
+ */
+export declare const KUBECTL_LOGS_TOOL: AITool;
+/**
+ * Tool: kubectl_events
+ * Get Kubernetes events for troubleshooting
+ */
+export declare const KUBECTL_EVENTS_TOOL: AITool;
+/**
+ * Tool: kubectl_patch_dryrun
+ * Validate patch commands with dry-run before execution
+ */
+export declare const KUBECTL_PATCH_DRYRUN_TOOL: AITool;
+/**
+ * Tool: kubectl_apply_dryrun
+ * Validate apply commands with dry-run before execution
+ */
+export declare const KUBECTL_APPLY_DRYRUN_TOOL: AITool;
+/**
+ * Tool: kubectl_delete_dryrun
+ * Validate delete commands with dry-run before execution
+ */
+export declare const KUBECTL_DELETE_DRYRUN_TOOL: AITool;
+/**
+ * Tool: kubectl_get_crd_schema
+ * Get the OpenAPI v3 schema for a Custom Resource Definition
+ */
+export declare const KUBECTL_GET_CRD_SCHEMA_TOOL: AITool;
+/**
+ * Tool executor for kubectl-based tools
+ * Handles execution and error handling for all kubectl tool calls
+ */
+export declare function executeKubectlTools(toolName: string, input: any): Promise<any>;
+/**
+ * All kubectl investigation tools (read-only operations + dry-run validation)
+ * Used during investigation phase for gathering cluster state information and validating solutions
+ * Convenient array for passing to toolLoop()
+ */
+export declare const KUBECTL_INVESTIGATION_TOOLS: AITool[];
+//# sourceMappingURL=kubectl-tools.d.ts.map

package/dist/core/kubectl-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kubectl-tools.d.ts","sourceRoot":"","sources":["../../src/core/kubectl-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGjD;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAQxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAsB9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAiBnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAsB/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAkBjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAyBvC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAiBvC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAiBxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAazC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAsRpF;AAED;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,EAU/C,CAAC"}

package/dist/core/kubectl-tools.js

@@ -0,0 +1,473 @@
+"use strict";
+/**
+ * Kubectl Tools for AI-Powered Investigation
+ *
+ * Shared tool definitions and executor for kubectl operations.
+ * Used by remediation, diagnostics, and other investigation workflows.
+ *
+ * PRD #143: Tool-Based Remediation with Observability Data Sources
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KUBECTL_INVESTIGATION_TOOLS = exports.KUBECTL_GET_CRD_SCHEMA_TOOL = exports.KUBECTL_DELETE_DRYRUN_TOOL = exports.KUBECTL_APPLY_DRYRUN_TOOL = exports.KUBECTL_PATCH_DRYRUN_TOOL = exports.KUBECTL_EVENTS_TOOL = exports.KUBECTL_LOGS_TOOL = exports.KUBECTL_DESCRIBE_TOOL = exports.KUBECTL_GET_TOOL = exports.KUBECTL_API_RESOURCES_TOOL = void 0;
+exports.executeKubectlTools = executeKubectlTools;
+const kubernetes_utils_1 = require("./kubernetes-utils");
+/**
+ * Tool: kubectl_api_resources
+ * Get list of all available Kubernetes API resources in the cluster
+ */
+exports.KUBECTL_API_RESOURCES_TOOL = {
+    name: 'kubectl_api_resources',
+    description: 'Get list of all available Kubernetes API resources in the cluster (resource types, API groups, namespaced vs cluster-scoped). Use this to discover what resources are available before querying specific resources. Essential for understanding what can be investigated in this cluster.',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: []
+    }
+};
+/**
+ * Tool: kubectl_get
+ * Get Kubernetes resources with their current state
+ */
+exports.KUBECTL_GET_TOOL = {
+    name: 'kubectl_get',
+    description: 'Get Kubernetes resources and their current state in TABLE FORMAT (most efficient). Returns compact table with NAME, STATUS, READY, AGE columns. Use this to list resources and check basic status. For detailed information, use kubectl_describe instead. IMPORTANT: Always returns table format - output format flags like -o=yaml or -o=json are automatically stripped.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            resource: {
+                type: 'string',
+                description: 'Resource type to get (e.g., "pods", "deployments", "services", "pod/my-pod", "clusters.postgresql.cnpg.io"). Can be plural (pods) or singular with name (pod/name). Can include API group for custom resources.'
+            },
+            namespace: {
+                type: 'string',
+                description: 'Kubernetes namespace to query. Omit for cluster-scoped resources or to query all namespaces.'
+            },
+            args: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Filtering arguments only (e.g., ["--selector=app=myapp"], ["--field-selector=status.phase=Running"], ["--all-namespaces"], ["--show-labels"]). Output format flags (-o=yaml, -o=json, etc.) are NOT allowed and will be automatically stripped.'
+            }
+        },
+        required: ['resource']
+    }
+};
+/**
+ * Tool: kubectl_describe
+ * Get detailed information about Kubernetes resources
+ */
+exports.KUBECTL_DESCRIBE_TOOL = {
+    name: 'kubectl_describe',
+    description: 'Get detailed information about specific Kubernetes resources including configuration, status, events, and relationships. Use this when you need comprehensive details about a specific resource, especially to understand configuration issues or see recent events related to that resource.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            resource: {
+                type: 'string',
+                description: 'Resource to describe (e.g., "pod/my-pod", "deployment/my-app", "cluster/postgres-db"). Should include the resource name.'
+            },
+            namespace: {
+                type: 'string',
+                description: 'Kubernetes namespace. Required for namespaced resources.'
+            }
+        },
+        required: ['resource']
+    }
+};
+/**
+ * Tool: kubectl_logs
+ * Get container logs from pods
+ */
+exports.KUBECTL_LOGS_TOOL = {
+    name: 'kubectl_logs',
+    description: 'Get container logs from pods. Essential for debugging application crashes, errors, and understanding runtime behavior. Use --previous flag to get logs from crashed/restarted containers.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            resource: {
+                type: 'string',
+                description: 'Pod name to get logs from (e.g., "my-pod" or "pod/my-pod").'
+            },
+            namespace: {
+                type: 'string',
+                description: 'Kubernetes namespace where the pod is running.'
+            },
+            args: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Additional log arguments (e.g., ["--previous"] for crashed container logs, ["--tail=50"] to limit output, ["--since=5m"] for recent logs, ["-c", "container-name"] for specific container).'
+            }
+        },
+        required: ['resource', 'namespace']
+    }
+};
+/**
+ * Tool: kubectl_events
+ * Get Kubernetes events for troubleshooting
+ */
+exports.KUBECTL_EVENTS_TOOL = {
+    name: 'kubectl_events',
+    description: 'Get Kubernetes events which record important state changes, errors, warnings, and informational messages from the cluster. Essential for understanding scheduling issues, resource problems, configuration errors, and system-level events affecting resources.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            namespace: {
+                type: 'string',
+                description: 'Kubernetes namespace to get events from. Omit for cluster-wide events.'
+            },
+            args: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Additional event arguments (e.g., ["--sort-by=.lastTimestamp"] to sort by time, ["--field-selector=involvedObject.name=my-pod"] to filter by resource, ["--since=10m"] for recent events).'
+            }
+        },
+        required: []
+    }
+};
+/**
+ * Tool: kubectl_patch_dryrun
+ * Validate patch commands with dry-run before execution
+ */
+exports.KUBECTL_PATCH_DRYRUN_TOOL = {
+    name: 'kubectl_patch_dryrun',
+    description: 'Validate that a kubectl patch command will be accepted by the cluster without actually applying it. Use this to test your proposed remediation patches before completing investigation. Essential for confirming command syntax and cluster acceptance.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            resource: {
+                type: 'string',
+                description: 'Resource to patch (e.g., "deployment/my-app", "cluster/postgres-db"). Must include resource type and name.'
+            },
+            namespace: {
+                type: 'string',
+                description: 'Kubernetes namespace. Required for namespaced resources.'
+            },
+            patch: {
+                type: 'string',
+                description: 'The patch content in JSON format (e.g., \'{"spec":{"replicas":3}}\')'
+            },
+            patchType: {
+                type: 'string',
+                description: 'Type of patch: "strategic" (default), "merge", or "json". Use "json" for JSON Patch operations.'
+            }
+        },
+        required: ['resource', 'patch']
+    }
+};
+/**
+ * Tool: kubectl_apply_dryrun
+ * Validate apply commands with dry-run before execution
+ */
+exports.KUBECTL_APPLY_DRYRUN_TOOL = {
+    name: 'kubectl_apply_dryrun',
+    description: 'Validate that a kubectl apply command will be accepted by the cluster without actually applying it. Use this to test applying YAML manifests or configuration changes before completing investigation.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            manifest: {
+                type: 'string',
+                description: 'The YAML manifest content to apply'
+            },
+            namespace: {
+                type: 'string',
+                description: 'Kubernetes namespace for the resource. Omit for cluster-scoped resources or if namespace is specified in manifest.'
+            }
+        },
+        required: ['manifest']
+    }
+};
+/**
+ * Tool: kubectl_delete_dryrun
+ * Validate delete commands with dry-run before execution
+ */
+exports.KUBECTL_DELETE_DRYRUN_TOOL = {
+    name: 'kubectl_delete_dryrun',
+    description: 'Validate that a kubectl delete command will be accepted by the cluster without actually deleting resources. Use this to test resource deletion before completing investigation.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            resource: {
+                type: 'string',
+                description: 'Resource to delete (e.g., "pod/my-pod", "deployment/my-app", "configmap/my-config")'
+            },
+            namespace: {
+                type: 'string',
+                description: 'Kubernetes namespace. Required for namespaced resources.'
+            }
+        },
+        required: ['resource']
+    }
+};
+/**
+ * Tool: kubectl_get_crd_schema
+ * Get the OpenAPI v3 schema for a Custom Resource Definition
+ */
+exports.KUBECTL_GET_CRD_SCHEMA_TOOL = {
+    name: 'kubectl_get_crd_schema',
+    description: 'Get the OpenAPI v3 schema for a Custom Resource Definition (CRD). Use this to understand the structure, required fields, validation rules, and available properties when crafting patches or configurations for custom resources like CNPG clusters, Crossplane resources, ArgoCD applications, etc.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            crdName: {
+                type: 'string',
+                description: 'Full CRD name including API group (e.g., "clusters.postgresql.cnpg.io", "compositions.apiextensions.crossplane.io", "applications.argoproj.io"). Use kubectl_api_resources to discover available CRDs.'
+            }
+        },
+        required: ['crdName']
+    }
+};
+/**
+ * Tool executor for kubectl-based tools
+ * Handles execution and error handling for all kubectl tool calls
+ */
+async function executeKubectlTools(toolName, input) {
+    try {
+        switch (toolName) {
+            case 'kubectl_api_resources': {
+                const output = await (0, kubernetes_utils_1.executeKubectl)(['api-resources']);
+                return {
+                    success: true,
+                    data: output,
+                    message: 'Successfully retrieved cluster API resources'
+                };
+            }
+            case 'kubectl_get': {
+                const { resource, namespace, args = [] } = input;
+                if (!resource) {
+                    return {
+                        success: false,
+                        error: 'Missing required parameter: resource',
+                        message: 'kubectl_get requires a resource parameter'
+                    };
+                }
+                // Build kubectl command
+                const cmdArgs = ['get', resource];
+                // Add namespace if provided
+                if (namespace) {
+                    cmdArgs.push('-n', namespace);
+                }
+                // Strip output format args - we always return table format for efficiency
+                // Allow filtering args like --selector, --field-selector, --all-namespaces, --show-labels
+                if (args && Array.isArray(args)) {
+                    const filteredArgs = args.filter(arg => {
+                        const argLower = arg.toLowerCase();
+                        // Block any output format flags
+                        return !argLower.startsWith('-o=') &&
+                            !argLower.startsWith('-o') &&
+                            !argLower.startsWith('--output') &&
+                            !argLower.includes('=json') &&
+                            !argLower.includes('=yaml');
+                    });
+                    cmdArgs.push(...filteredArgs);
+                }
+                const output = await (0, kubernetes_utils_1.executeKubectl)(cmdArgs);
+                return {
+                    success: true,
+                    data: output,
+                    message: `Successfully retrieved ${resource}${namespace ? ` in namespace ${namespace}` : ''}`
+                };
+            }
+            case 'kubectl_describe': {
+                const { resource, namespace } = input;
+                if (!resource) {
+                    return {
+                        success: false,
+                        error: 'Missing required parameter: resource',
+                        message: 'kubectl_describe requires a resource parameter'
+                    };
+                }
+                // Build kubectl command
+                const cmdArgs = ['describe', resource];
+                // Add namespace if provided
+                if (namespace) {
+                    cmdArgs.push('-n', namespace);
+                }
+                const output = await (0, kubernetes_utils_1.executeKubectl)(cmdArgs);
+                return {
+                    success: true,
+                    data: output,
+                    message: `Successfully described ${resource}${namespace ? ` in namespace ${namespace}` : ''}`
+                };
+            }
+            case 'kubectl_logs': {
+                const { resource, namespace, args = [] } = input;
+                if (!resource) {
+                    return {
+                        success: false,
+                        error: 'Missing required parameter: resource',
+                        message: 'kubectl_logs requires a resource parameter'
+                    };
+                }
+                if (!namespace) {
+                    return {
+                        success: false,
+                        error: 'Missing required parameter: namespace',
+                        message: 'kubectl_logs requires a namespace parameter'
+                    };
+                }
+                // Build kubectl command
+                const cmdArgs = ['logs', resource, '-n', namespace];
+                // Add additional arguments
+                if (args && Array.isArray(args)) {
+                    cmdArgs.push(...args);
+                }
+                const output = await (0, kubernetes_utils_1.executeKubectl)(cmdArgs);
+                return {
+                    success: true,
+                    data: output,
+                    message: `Successfully retrieved logs for ${resource} in namespace ${namespace}`
+                };
+            }
+            case 'kubectl_events': {
+                const { namespace, args = [] } = input;
+                // Build kubectl command
+                const cmdArgs = ['get', 'events'];
+                // Add namespace if provided
+                if (namespace) {
+                    cmdArgs.push('-n', namespace);
+                }
+                // Add additional arguments
+                if (args && Array.isArray(args)) {
+                    cmdArgs.push(...args);
+                }
+                const output = await (0, kubernetes_utils_1.executeKubectl)(cmdArgs);
+                return {
+                    success: true,
+                    data: output,
+                    message: `Successfully retrieved events${namespace ? ` in namespace ${namespace}` : ' (cluster-wide)'}`
+                };
+            }
+            case 'kubectl_patch_dryrun': {
+                const { resource, namespace, patch, patchType = 'strategic' } = input;
+                if (!resource) {
+                    return {
+                        success: false,
+                        error: 'Missing required parameter: resource',
+                        message: 'kubectl_patch_dryrun requires a resource parameter'
+                    };
+                }
+                if (!patch) {
+                    return {
+                        success: false,
+                        error: 'Missing required parameter: patch',
+                        message: 'kubectl_patch_dryrun requires a patch parameter'
+                    };
+                }
+                // Build kubectl command
+                const cmdArgs = ['patch', resource, '--dry-run=server'];
+                // Add namespace if provided
+                if (namespace) {
+                    cmdArgs.push('-n', namespace);
+                }
+                // Add patch type
+                if (patchType === 'json') {
+                    cmdArgs.push('--type=json');
+                }
+                else if (patchType === 'merge') {
+                    cmdArgs.push('--type=merge');
+                }
+                // strategic is default, no flag needed
+                // Add patch content
+                cmdArgs.push('-p', patch);
+                const output = await (0, kubernetes_utils_1.executeKubectl)(cmdArgs);
+                return {
+                    success: true,
+                    data: output,
+                    message: `Dry-run validation successful for patch on ${resource}${namespace ? ` in namespace ${namespace}` : ''}`
+                };
+            }
+            case 'kubectl_apply_dryrun': {
+                const { manifest, namespace } = input;
+                if (!manifest) {
+                    return {
+                        success: false,
+                        error: 'Missing required parameter: manifest',
+                        message: 'kubectl_apply_dryrun requires a manifest parameter'
+                    };
+                }
+                // Build kubectl command
+                const cmdArgs = ['apply', '--dry-run=server', '-f', '-'];
+                // Add namespace if provided
+                if (namespace) {
+                    cmdArgs.push('-n', namespace);
+                }
+                // Execute with manifest as stdin
+                const output = await (0, kubernetes_utils_1.executeKubectl)(cmdArgs, { stdin: manifest });
+                return {
+                    success: true,
+                    data: output,
+                    message: `Dry-run validation successful for apply${namespace ? ` in namespace ${namespace}` : ''}`
+                };
+            }
+            case 'kubectl_delete_dryrun': {
+                const { resource, namespace } = input;
+                if (!resource) {
+                    return {
+                        success: false,
+                        error: 'Missing required parameter: resource',
+                        message: 'kubectl_delete_dryrun requires a resource parameter'
+                    };
+                }
+                // Build kubectl command
+                const cmdArgs = ['delete', resource, '--dry-run=server'];
+                // Add namespace if provided
+                if (namespace) {
+                    cmdArgs.push('-n', namespace);
+                }
+                const output = await (0, kubernetes_utils_1.executeKubectl)(cmdArgs);
+                return {
+                    success: true,
+                    data: output,
+                    message: `Dry-run validation successful for delete on ${resource}${namespace ? ` in namespace ${namespace}` : ''}`
+                };
+            }
+            case 'kubectl_get_crd_schema': {
+                const { crdName } = input;
+                if (!crdName) {
+                    return {
+                        success: false,
+                        error: 'Missing required parameter: crdName',
+                        message: 'kubectl_get_crd_schema requires a crdName parameter (e.g., "clusters.postgresql.cnpg.io")'
+                    };
+                }
+                // Get CRD definition in JSON format - AI can parse what it needs
+                const cmdArgs = ['get', 'crd', crdName, '-o', 'json'];
+                const output = await (0, kubernetes_utils_1.executeKubectl)(cmdArgs);
+                return {
+                    success: true,
+                    data: output,
+                    message: `Successfully retrieved CRD schema for ${crdName}`
+                };
+            }
+            default:
+                return {
+                    success: false,
+                    error: `Unknown kubectl tool: ${toolName}`,
+                    message: `Tool '${toolName}' is not implemented`
+                };
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: errorMessage,
+            message: `Failed to execute ${toolName}: ${errorMessage}`
+        };
+    }
+}
+/**
+ * All kubectl investigation tools (read-only operations + dry-run validation)
+ * Used during investigation phase for gathering cluster state information and validating solutions
+ * Convenient array for passing to toolLoop()
+ */
+exports.KUBECTL_INVESTIGATION_TOOLS = [
+    exports.KUBECTL_API_RESOURCES_TOOL,
+    exports.KUBECTL_GET_TOOL,
+    exports.KUBECTL_DESCRIBE_TOOL,
+    exports.KUBECTL_LOGS_TOOL,
+    exports.KUBECTL_EVENTS_TOOL,
+    exports.KUBECTL_PATCH_DRYRUN_TOOL,
+    exports.KUBECTL_APPLY_DRYRUN_TOOL,
+    exports.KUBECTL_DELETE_DRYRUN_TOOL,
+    exports.KUBECTL_GET_CRD_SCHEMA_TOOL
+];

package/dist/core/kubernetes-utils.d.ts

@@ -8,6 +8,7 @@ export interface KubectlConfig {
     namespace?: string;
     kubeconfig?: string;
     timeout?: number;
+    stdin?: string;
 }
 /**
  * Execute kubectl command with proper configuration

package/dist/core/kubernetes-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kubernetes-utils.d.ts","sourceRoot":"","sources":["../../src/core/kubernetes-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB5F;AAsBD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAmBlF;AAGD,qBAAa,eAAe;IAC1B,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE;IA0D7E,OAAO,CAAC,MAAM,CAAC,cAAc;IAa7B,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAYpC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAInC,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAIrC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAMhC,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAI1C,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAYlC,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAgBzC,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAYxC,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAQ1C,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAYrC,OAAO,CAAC,MAAM,CAAC,gCAAgC;CAGhD"}
+{"version":3,"file":"kubernetes-utils.d.ts","sourceRoot":"","sources":["../../src/core/kubernetes-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAuD5F;AAsBD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAmBlF;AAGD,qBAAa,eAAe;IAC1B,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE;IA0D7E,OAAO,CAAC,MAAM,CAAC,cAAc;IAa7B,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAYpC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAInC,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAIrC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAMhC,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAI1C,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAYlC,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAgBzC,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAYxC,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAQ1C,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAYrC,OAAO,CAAC,MAAM,CAAC,gCAAgC;CAGhD"}

package/dist/core/kubernetes-utils.js

@@ -18,6 +18,36 @@ async function executeKubectl(args, config) {
     const command = buildKubectlCommand(args, config);
     const timeout = config?.timeout || 30000;
     try {
+        // If stdin is provided, use spawn for proper stdin piping
+        if (config?.stdin) {
+            const { spawn } = require('child_process');
+            return new Promise((resolve, reject) => {
+                let stdout = '';
+                let stderr = '';
+                const proc = spawn('sh', ['-c', command], {
+                    timeout,
+                    maxBuffer: 100 * 1024 * 1024
+                });
+                proc.stdout.on('data', (data) => { stdout += data.toString(); });
+                proc.stderr.on('data', (data) => { stderr += data.toString(); });
+                proc.on('error', (error) => reject(error));
+                proc.on('close', (code) => {
+                    if (code !== 0) {
+                        reject(new Error(`kubectl command failed: ${stderr || stdout}`));
+                    }
+                    else if (stderr && !stderr.includes('Warning')) {
+                        reject(new Error(`kubectl command failed: ${stderr}`));
+                    }
+                    else {
+                        resolve(stdout.trim());
+                    }
+                });
+                // Write stdin and close
+                proc.stdin.write(config.stdin);
+                proc.stdin.end();
+            });
+        }
+        // No stdin - use regular execAsync
         const { stdout, stderr } = await execAsync(command, {
             timeout,
             maxBuffer: 100 * 1024 * 1024 // 100MB buffer for large clusters with 1000+ CRDs