kubeview-mcp 1.0.0

package/dist/src/index.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+/**
+ * Kubernetes MCP Server
+ * Main entry point for the Model Context Protocol server
+ */
+import { MCPServer } from './server/MCPServer.js';
+import { KubernetesToolsPlugin } from './plugins/KubernetesToolsPlugin.js';
+import { HelmToolsPlugin } from './plugins/HelmToolsPlugin.js';
+import { ArgoToolsPlugin } from './plugins/ArgoToolsPlugin.js';
+import { ArgoCDToolsPlugin } from './plugins/ArgoCDToolsPlugin.js';
+export const VERSION = '0.1.0';
+export async function main() {
+    console.error(`Kubernetes MCP Server v${VERSION} - Starting...`);
+    try {
+        // Create and start the MCP server
+        const server = new MCPServer();
+        // Load the Kubernetes tools plugin
+        const kubernetesPlugin = new KubernetesToolsPlugin();
+        await server.loadPlugin(kubernetesPlugin);
+        // Load the Helm tools plugin
+        const helmPlugin = new HelmToolsPlugin();
+        await server.loadPlugin(helmPlugin);
+        // Load the Argo tools plugin
+        const argoPlugin = new ArgoToolsPlugin();
+        await server.loadPlugin(argoPlugin);
+        // Load the ArgoCD tools plugin
+        const argoCDPlugin = new ArgoCDToolsPlugin();
+        await server.loadPlugin(argoCDPlugin);
+        // Start the server
+        await server.start();
+        console.error('MCP Server is running. Waiting for connections...');
+    }
+    catch (error) {
+        console.error('Failed to start MCP server:', error);
+        process.exit(1);
+    }
+}
+// If this file is being run directly (not imported), start the server
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch((error) => {
+        console.error('Failed to start server:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,OAAO,CAAC,KAAK,CAAC,0BAA0B,OAAO,gBAAgB,CAAC,CAAC;IAEjE,IAAI,CAAC;QACH,kCAAkC;QAClC,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAE/B,mCAAmC;QACnC,MAAM,gBAAgB,GAAG,IAAI,qBAAqB,EAAE,CAAC;QACrD,MAAM,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;QAE1C,6BAA6B;QAC7B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAEpC,6BAA6B;QAC7B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAEpC,+BAA+B;QAC/B,MAAM,YAAY,GAAG,IAAI,iBAAiB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QAEtC,mBAAmB;QACnB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QAErB,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACrB,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/kubernetes/BaseResourceOperations.d.ts

@@ -0,0 +1,155 @@
+import * as k8s from '@kubernetes/client-node';
+import { Logger } from 'winston';
+import { KubernetesClient } from './KubernetesClient.js';
+import { RetryableOperationFactory, RetryableOperation } from './RetryableOperation.js';
+import { ErrorMonitor } from './ErrorHandling.js';
+/**
+ * Common options for resource operations
+ */
+export interface ResourceOperationOptions {
+    /**
+     * Namespace for the operation (required for namespaced resources)
+     */
+    namespace?: string;
+    /**
+     * Label selector for filtering resources
+     */
+    labelSelector?: string;
+    /**
+     * Field selector for filtering resources
+     */
+    fieldSelector?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Continue token for pagination
+     */
+    continueToken?: string;
+    /**
+     * Resource version for optimistic concurrency control
+     */
+    resourceVersion?: string;
+    /**
+     * Timeout in seconds for the operation
+     */
+    timeoutSeconds?: number;
+    /**
+     * Whether to propagate deletion to dependents
+     */
+    propagationPolicy?: 'Foreground' | 'Background' | 'Orphan';
+    /**
+     * Grace period seconds for deletion
+     */
+    gracePeriodSeconds?: number;
+    /**
+     * Whether to sanitize sensitive data in ConfigMaps and Secrets
+     */
+    skipSanitize?: boolean;
+}
+/**
+ * Watch event types
+ */
+export declare enum WatchEventType {
+    ADDED = "ADDED",
+    MODIFIED = "MODIFIED",
+    DELETED = "DELETED",
+    ERROR = "ERROR"
+}
+/**
+ * Watch event interface
+ */
+export interface WatchEvent<T> {
+    type: WatchEventType;
+    object: T;
+}
+/**
+ * Watch callback function
+ */
+export type WatchCallback<T> = (event: WatchEvent<T>) => void;
+/**
+ * Generic interface for resource operations
+ */
+export interface IResourceOperations<T extends k8s.KubernetesObject> {
+    /**
+     * Create a new resource
+     */
+    create(resource: T, options?: ResourceOperationOptions): Promise<T>;
+    /**
+     * Get a resource by name
+     */
+    get(name: string, options?: ResourceOperationOptions): Promise<T>;
+    /**
+     * Update an existing resource
+     */
+    update(resource: T, options?: ResourceOperationOptions): Promise<T>;
+    /**
+     * Patch a resource
+     */
+    patch(name: string, patch: any, options?: ResourceOperationOptions): Promise<T>;
+    /**
+     * Delete a resource
+     */
+    delete(name: string, options?: ResourceOperationOptions): Promise<void>;
+    /**
+     * List resources
+     */
+    list(options?: ResourceOperationOptions): Promise<k8s.KubernetesListObject<T>>;
+    /**
+     * Watch resources for changes
+     */
+    watch(callback: WatchCallback<T>, options?: ResourceOperationOptions): () => void;
+}
+/**
+ * Error class for Kubernetes operations
+ */
+export declare class KubernetesOperationError extends Error {
+    readonly statusCode?: number | undefined;
+    readonly resource?: string | undefined;
+    readonly operation?: string | undefined;
+    constructor(message: string, statusCode?: number | undefined, resource?: string | undefined, operation?: string | undefined);
+}
+/**
+ * Base class for resource operations with integrated retry and error handling
+ */
+export declare abstract class BaseResourceOperations<T extends k8s.KubernetesObject> implements IResourceOperations<T> {
+    protected client: KubernetesClient;
+    protected resourceType: string;
+    protected logger?: Logger;
+    protected retryFactory: RetryableOperationFactory;
+    protected errorMonitor: ErrorMonitor;
+    constructor(client: KubernetesClient, resourceType: string);
+    /**
+     * Get or create a retryable operation for a specific action
+     */
+    protected getRetryableOperation<R>(operationName: string): RetryableOperation<R>;
+    /**
+     * Handle API errors and convert to KubernetesOperationError
+     */
+    protected handleApiError(error: any, operation: string, resourceName?: string): never;
+    /**
+     * Build list options from ResourceOperationOptions
+     */
+    protected buildListOptions(options?: ResourceOperationOptions): any;
+    /**
+     * Build delete options from ResourceOperationOptions
+     */
+    protected buildDeleteOptions(options?: ResourceOperationOptions): k8s.V1DeleteOptions;
+    /**
+     * Get error statistics for this resource type
+     */
+    getErrorStats(): import("./ErrorHandling.js").ErrorStats;
+    /**
+     * Reset circuit breakers for all operations
+     */
+    resetCircuits(): void;
+    abstract create(resource: T, options?: ResourceOperationOptions): Promise<T>;
+    abstract get(name: string, options?: ResourceOperationOptions): Promise<T>;
+    abstract update(resource: T, options?: ResourceOperationOptions): Promise<T>;
+    abstract patch(name: string, patch: any, options?: ResourceOperationOptions): Promise<T>;
+    abstract delete(name: string, options?: ResourceOperationOptions): Promise<void>;
+    abstract list(options?: ResourceOperationOptions): Promise<k8s.KubernetesListObject<T>>;
+    abstract watch(callback: WatchCallback<T>, options?: ResourceOperationOptions): () => void;
+}
+//# sourceMappingURL=BaseResourceOperations.d.ts.map

package/dist/src/kubernetes/BaseResourceOperations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseResourceOperations.d.ts","sourceRoot":"","sources":["../../../src/kubernetes/BaseResourceOperations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,EAAE,YAAY,EAAoC,MAAM,oBAAoB,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,iBAAiB,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAC;IAE3D;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,oBAAY,cAAc;IACxB,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC;CACX;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,GAAG,CAAC,gBAAgB;IACjE;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEpE;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAElE;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEpE;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEhF;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/E;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,MAAM,IAAI,CAAC;CACnF;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;aAG/B,UAAU,CAAC,EAAE,MAAM;aACnB,QAAQ,CAAC,EAAE,MAAM;aACjB,SAAS,CAAC,EAAE,MAAM;gBAHlC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,SAAS,CAAC,EAAE,MAAM,YAAA;CAKrC;AAED;;GAEG;AACH,8BAAsB,sBAAsB,CAAC,CAAC,SAAS,GAAG,CAAC,gBAAgB,CACzE,YAAW,mBAAmB,CAAC,CAAC,CAAC;IAO/B,SAAS,CAAC,MAAM,EAAE,gBAAgB;IAClC,SAAS,CAAC,YAAY,EAAE,MAAM;IANhC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,YAAY,EAAE,yBAAyB,CAAC;IAClD,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC;gBAGzB,MAAM,EAAE,gBAAgB,EACxB,YAAY,EAAE,MAAM;IA4BhC;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC;IAIhF;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK;IAwBrF;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,GAAG;IA8BnE;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,GAAG,CAAC,eAAe;IAcrF;;OAEG;IACI,aAAa;IAIpB;;OAEG;IACI,aAAa;IAKpB,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,CAAC,CAAC;IAC5E,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,CAAC,CAAC;IAC1E,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,CAAC,CAAC;IAC5E,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,CAAC,CAAC;IACxF,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAChF,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACvF,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,MAAM,IAAI;CAC3F"}

package/dist/src/kubernetes/BaseResourceOperations.js

@@ -0,0 +1,136 @@
+import { RetryableOperationFactory } from './RetryableOperation.js';
+import { ErrorMonitor, KubernetesError, convertApiError } from './ErrorHandling.js';
+/**
+ * Watch event types
+ */
+export var WatchEventType;
+(function (WatchEventType) {
+    WatchEventType["ADDED"] = "ADDED";
+    WatchEventType["MODIFIED"] = "MODIFIED";
+    WatchEventType["DELETED"] = "DELETED";
+    WatchEventType["ERROR"] = "ERROR";
+})(WatchEventType || (WatchEventType = {}));
+/**
+ * Error class for Kubernetes operations
+ */
+export class KubernetesOperationError extends Error {
+    statusCode;
+    resource;
+    operation;
+    constructor(message, statusCode, resource, operation) {
+        super(message);
+        this.statusCode = statusCode;
+        this.resource = resource;
+        this.operation = operation;
+        this.name = 'KubernetesOperationError';
+    }
+}
+/**
+ * Base class for resource operations with integrated retry and error handling
+ */
+export class BaseResourceOperations {
+    client;
+    resourceType;
+    logger;
+    retryFactory;
+    errorMonitor;
+    constructor(client, resourceType) {
+        this.client = client;
+        this.resourceType = resourceType;
+        this.logger = client['config'].logger;
+        this.errorMonitor = new ErrorMonitor(this.logger);
+        // Initialize retry factory with default configuration
+        this.retryFactory = new RetryableOperationFactory({
+            retry: {
+                maxAttempts: 3,
+                initialDelayMs: 100,
+                maxDelayMs: 5000,
+                backoffMultiplier: 2,
+                jitterFactor: 0.1,
+            },
+            circuitBreaker: {
+                failureThreshold: 5,
+                successThreshold: 2,
+                resetTimeout: 30000,
+                failureCountWindow: 10000,
+            },
+            errorMonitor: this.errorMonitor,
+            logger: this.logger,
+        }, this.logger);
+    }
+    /**
+     * Get or create a retryable operation for a specific action
+     */
+    getRetryableOperation(operationName) {
+        return this.retryFactory.create(`${this.resourceType}.${operationName}`);
+    }
+    /**
+     * Handle API errors and convert to KubernetesOperationError
+     */
+    handleApiError(error, operation, resourceName) {
+        // Convert to typed error
+        let typedError = error instanceof KubernetesError ? error : convertApiError(error);
+        // Add resource context by creating a new error with additional details
+        if (resourceName && typedError instanceof KubernetesError) {
+            const newError = new KubernetesError(typedError.message, typedError.code, typedError.statusCode, typedError.retryable, {
+                ...typedError.details,
+                resource: this.resourceType,
+                resourceName,
+                operation,
+            });
+            typedError = newError;
+        }
+        throw typedError;
+    }
+    /**
+     * Build list options from ResourceOperationOptions
+     */
+    buildListOptions(options) {
+        const listOptions = {};
+        if (options?.labelSelector) {
+            listOptions.labelSelector = options.labelSelector;
+        }
+        if (options?.fieldSelector) {
+            listOptions.fieldSelector = options.fieldSelector;
+        }
+        if (options?.limit) {
+            listOptions.limit = options.limit;
+        }
+        if (options?.continueToken) {
+            listOptions.continue = options.continueToken;
+        }
+        if (options?.resourceVersion) {
+            listOptions.resourceVersion = options.resourceVersion;
+        }
+        if (options?.timeoutSeconds) {
+            listOptions.timeoutSeconds = options.timeoutSeconds;
+        }
+        return listOptions;
+    }
+    /**
+     * Build delete options from ResourceOperationOptions
+     */
+    buildDeleteOptions(options) {
+        const deleteOptions = {};
+        if (options?.propagationPolicy) {
+            deleteOptions.propagationPolicy = options.propagationPolicy;
+        }
+        if (options?.gracePeriodSeconds !== undefined) {
+            deleteOptions.gracePeriodSeconds = options.gracePeriodSeconds;
+        }
+        return deleteOptions;
+    }
+    /**
+     * Get error statistics for this resource type
+     */
+    getErrorStats() {
+        return this.errorMonitor.getStats();
+    }
+    /**
+     * Reset circuit breakers for all operations
+     */
+    resetCircuits() {
+        this.retryFactory.resetAllCircuits();
+    }
+}
+//# sourceMappingURL=BaseResourceOperations.js.map

package/dist/src/kubernetes/BaseResourceOperations.js.map

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

package/dist/src/kubernetes/CircuitBreaker.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Circuit Breaker Module
+ *
+ * Implements the circuit breaker pattern for fault tolerance in distributed systems.
+ * Prevents cascading failures by temporarily blocking requests to failing services.
+ */
+import { Logger } from 'winston';
+import { EventEmitter } from 'events';
+/**
+ * Circuit breaker states
+ */
+export declare enum CircuitState {
+    CLOSED = "CLOSED",// Normal operation, requests pass through
+    OPEN = "OPEN",// Circuit broken, requests blocked
+    HALF_OPEN = "HALF_OPEN"
+}
+/**
+ * Circuit breaker configuration
+ */
+export interface CircuitBreakerConfig {
+    /** Name of the circuit for identification */
+    name: string;
+    /** Number of failures before opening circuit */
+    failureThreshold: number;
+    /** Success threshold to close circuit from half-open */
+    successThreshold: number;
+    /** Time window for counting failures (ms) */
+    failureCountWindow: number;
+    /** Time to wait before attempting recovery (ms) */
+    resetTimeout: number;
+    /** Percentage of requests to fail before opening (0-100) */
+    failureRateThreshold?: number;
+    /** Minimum number of requests before applying rate threshold */
+    volumeThreshold?: number;
+    /** Optional timeout for operations (ms) */
+    operationTimeout?: number;
+    /** Function to determine if an error counts as failure */
+    isFailure?: (error: any) => boolean;
+    /** Fallback function when circuit is open */
+    fallback?: <T>() => T | Promise<T>;
+}
+/**
+ * Default circuit breaker configuration
+ */
+export declare const DEFAULT_CIRCUIT_CONFIG: Omit<CircuitBreakerConfig, 'name'>;
+/**
+ * Circuit breaker statistics
+ */
+export interface CircuitStats {
+    state: CircuitState;
+    failures: number;
+    successes: number;
+    totalCalls: number;
+    lastFailureTime?: Date;
+    lastSuccessTime?: Date;
+    lastStateChange: Date;
+    consecutiveSuccesses: number;
+    consecutiveFailures: number;
+    failureRate: number;
+}
+/**
+ * Circuit breaker implementation
+ */
+export declare class CircuitBreaker extends EventEmitter {
+    private state;
+    private readonly config;
+    private readonly logger?;
+    private stats;
+    private resetTimer?;
+    private readonly requestHistory;
+    private lastStateChangeTime;
+    constructor(config: CircuitBreakerConfig, logger?: Logger);
+    /**
+     * Execute an operation through the circuit breaker
+     */
+    execute<T>(operation: () => Promise<T>): Promise<T>;
+    /**
+     * Get current circuit statistics
+     */
+    getStats(): CircuitStats;
+    /**
+     * Get current state
+     */
+    getState(): CircuitState;
+    /**
+     * Manually reset the circuit breaker
+     */
+    reset(): void;
+    /**
+     * Force open the circuit
+     */
+    open(): void;
+    /**
+     * Initialize statistics
+     */
+    private initializeStats;
+    /**
+     * Execute operation with timeout
+     */
+    private executeWithTimeout;
+    /**
+     * Record successful operation
+     */
+    private recordSuccess;
+    /**
+     * Record failed operation
+     */
+    private recordFailure;
+    /**
+     * Check if circuit should open based on failure conditions
+     */
+    private shouldOpenCircuit;
+    /**
+     * Add request to history
+     */
+    private addToHistory;
+    /**
+     * Get recent requests within the time window
+     */
+    private getRecentRequests;
+    /**
+     * Calculate current failure rate
+     */
+    private calculateFailureRate;
+    /**
+     * Determine if error should count as failure
+     */
+    private shouldCountAsFailure;
+    /**
+     * Transition to new state
+     */
+    private transition;
+    /**
+     * Schedule circuit reset attempt
+     */
+    private scheduleReset;
+    /**
+     * Clear reset timer
+     */
+    private clearResetTimer;
+    /**
+     * Cleanup resources
+     */
+    dispose(): void;
+}
+/**
+ * Circuit breaker factory for managing multiple circuits
+ */
+export declare class CircuitBreakerFactory {
+    private readonly circuits;
+    private readonly logger?;
+    constructor(logger?: Logger);
+    /**
+     * Get or create a circuit breaker
+     */
+    getOrCreate(config: CircuitBreakerConfig): CircuitBreaker;
+    /**
+     * Get existing circuit breaker
+     */
+    get(name: string): CircuitBreaker | undefined;
+    /**
+     * Get all circuit breakers
+     */
+    getAll(): Map<string, CircuitBreaker>;
+    /**
+     * Get statistics for all circuits
+     */
+    getAllStats(): Record<string, CircuitStats>;
+    /**
+     * Reset all circuits
+     */
+    resetAll(): void;
+    /**
+     * Dispose all circuits
+     */
+    dispose(): void;
+}
+/**
+ * Decorator for adding circuit breaker to methods
+ */
+export declare function WithCircuitBreaker(config: Omit<CircuitBreakerConfig, 'name'>): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=CircuitBreaker.d.ts.map

package/dist/src/kubernetes/CircuitBreaker.d.ts.map

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