@vfarcic/dot-ai 0.185.0 → 0.187.0

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

@@ -1 +1 @@
-{"version":3,"file":"ai-provider-factory.d.ts","sourceRoot":"","sources":["../../src/core/ai-provider-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,UAAU,EACV,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AA6BjC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU;IA2BnD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,aAAa,IAAI,UAAU;IAoFlC;;;;;OAKG;IACH,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAWrD;;;;OAIG;IACH,MAAM,CAAC,qBAAqB,IAAI,MAAM,EAAE;IAMxC;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAGxD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAE7C"}
+{"version":3,"file":"ai-provider-factory.d.ts","sourceRoot":"","sources":["../../src/core/ai-provider-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,UAAU,EACV,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AA8BjC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU;IA2BnD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,aAAa,IAAI,UAAU;IAoFlC;;;;;OAKG;IACH,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAWrD;;;;OAIG;IACH,MAAM,CAAC,qBAAqB,IAAI,MAAM,EAAE;IAMxC;;;;;OAKG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAGxD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAE7C"}

package/dist/core/ai-provider-factory.js

@@ -14,6 +14,7 @@ exports.createAIProvider = createAIProvider;
 const vercel_provider_1 = require("./providers/vercel-provider");
 const host_provider_1 = require("./providers/host-provider");
 const noop_provider_1 = require("./providers/noop-provider");
+const constants_1 = require("./constants");
 const model_config_1 = require("./model-config");
 /**
  * Provider environment variable mappings
@@ -60,7 +61,7 @@ class AIProviderFactory {
         }
         // Validate configuration
         if (!config.apiKey) {
-            throw new Error(`API key is required for ${config.provider} provider`);
+            throw new Error(constants_1.AI_SERVICE_ERROR_TEMPLATES.API_KEY_REQUIRED(config.provider));
         }
         if (!config.provider) {
             throw new Error('Provider type must be specified');

package/dist/core/capability-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capability-operations.d.ts","sourceRoot":"","sources":["../../src/core/capability-operations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAStE;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAahG;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,uBAAuB,GACzC,OAAO,CAAC,GAAG,CAAC,CA8Dd;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,uBAAuB,GACzC,OAAO,CAAC,GAAG,CAAC,CA+Ed;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,uBAAuB,GACzC,OAAO,CAAC,GAAG,CAAC,CAuEd;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,uBAAuB,GACzC,OAAO,CAAC,GAAG,CAAC,CA2Dd;AAoCD;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,CA4Nd;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,uBAAuB,GACzC,OAAO,CAAC,GAAG,CAAC,CAwFd;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,CAmDd"}
+{"version":3,"file":"capability-operations.d.ts","sourceRoot":"","sources":["../../src/core/capability-operations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAUtE;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAahG;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,uBAAuB,GACzC,OAAO,CAAC,GAAG,CAAC,CA8Dd;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,uBAAuB,GACzC,OAAO,CAAC,GAAG,CAAC,CA+Ed;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,uBAAuB,GACzC,OAAO,CAAC,GAAG,CAAC,CAuEd;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,uBAAuB,GACzC,OAAO,CAAC,GAAG,CAAC,CA2Dd;AAoCD;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,CA4Nd;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,uBAAuB,GACzC,OAAO,CAAC,GAAG,CAAC,CAwFd;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,CAmDd"}

package/dist/core/capability-operations.js

@@ -50,6 +50,7 @@ exports.handleCapabilityCRUD = handleCapabilityCRUD;
 const capability_vector_service_1 = require("./capability-vector-service");
 const capabilities_1 = require("./capabilities");
 const session_utils_1 = require("./session-utils");
+const validation_1 = require("./constants/validation");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 // Note: validateVectorDBConnection and validateEmbeddingService are shared utilities
@@ -147,7 +148,7 @@ async function handleCapabilityGet(args, logger, requestId, capabilityService) {
                 operation: 'get',
                 dataType: 'capabilities',
                 error: {
-                    message: 'Missing required parameter: id',
+                    message: validation_1.VALIDATION_MESSAGES.MISSING_PARAMETER('id'),
                     details: 'Specify id to retrieve capability data',
                     example: { id: 'capability-id-example' }
                 }
@@ -225,7 +226,7 @@ async function handleCapabilityDelete(args, logger, requestId, capabilityService
                 operation: 'delete',
                 dataType: 'capabilities',
                 error: {
-                    message: 'Missing required parameter: id',
+                    message: validation_1.VALIDATION_MESSAGES.MISSING_PARAMETER('id'),
                     details: 'Specify id to delete capability data',
                     example: { id: 'capability-id-example' }
                 }

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

@@ -1 +1 @@
-{"version":3,"file":"capability-tools.d.ts","sourceRoot":"","sources":["../../src/core/capability-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGjD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAwBtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAkCrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,EAGpC,CAAC;AAsBF;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAwFvF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}
+{"version":3,"file":"capability-tools.d.ts","sourceRoot":"","sources":["../../src/core/capability-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAIjD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAwBtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAkCrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,EAGpC,CAAC;AAsBF;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAwFvF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/core/capability-tools.js

@@ -12,6 +12,7 @@ exports.CAPABILITY_TOOLS = exports.QUERY_CAPABILITIES_TOOL = exports.SEARCH_CAPA
 exports.executeCapabilityTools = executeCapabilityTools;
 exports.resetCapabilityService = resetCapabilityService;
 const capability_vector_service_1 = require("./capability-vector-service");
+const validation_1 = require("./constants/validation");
 /**
  * Tool: search_capabilities
  * Semantic search for cluster capabilities by intent/concept
@@ -122,7 +123,7 @@ async function executeCapabilityTools(toolName, input) {
                 if (!query) {
                     return {
                         success: false,
-                        error: 'Missing required parameter: query',
+                        error: validation_1.VALIDATION_MESSAGES.MISSING_PARAMETER('query'),
                         message: 'search_capabilities requires a query parameter'
                     };
                 }
@@ -153,7 +154,7 @@ async function executeCapabilityTools(toolName, input) {
                 if (!filter) {
                     return {
                         success: false,
-                        error: 'Missing required parameter: filter',
+                        error: validation_1.VALIDATION_MESSAGES.MISSING_PARAMETER('filter'),
                         message: 'query_capabilities requires a filter parameter with Qdrant filter syntax'
                     };
                 }

package/dist/core/constants/errors.d.ts

@@ -0,0 +1,202 @@
+/**
+ * Error messages and templates
+ *
+ * Centralized error messages, categories, and templates for
+ * comprehensive error handling across the application.
+ */
+/**
+ * Network and connectivity error messages
+ */
+export declare const NETWORK_ERRORS: {
+    readonly CONNECTION_FAILED: "Failed to establish connection";
+    readonly TIMEOUT: "Request timeout";
+    readonly UNREACHABLE: "Service unreachable";
+    readonly DNS_RESOLUTION_FAILED: "DNS resolution failed";
+    readonly NETWORK_UNAVAILABLE: "Network unavailable";
+};
+/**
+ * Authentication and authorization error messages
+ */
+export declare const AUTH_ERRORS: {
+    readonly AUTHENTICATION_FAILED: "Authentication failed. Please verify your credentials.";
+    readonly UNAUTHORIZED: "Unauthorized access";
+    readonly INVALID_TOKEN: "Invalid or expired token";
+    readonly MISSING_CREDENTIALS: "Authentication credentials missing";
+    readonly INVALID_API_KEY: "Invalid API key provided";
+};
+/**
+ * Kubernetes-specific error messages
+ */
+export declare const KUBERNETES_ERRORS: {
+    readonly CLUSTER_UNREACHABLE: "Unable to connect to Kubernetes cluster. Please check your kubeconfig and cluster connectivity.";
+    readonly KUBECONFIG_NOT_FOUND: "Kubeconfig file not found";
+    readonly INVALID_CONTEXT: "Invalid Kubernetes context";
+    readonly RESOURCE_NOT_FOUND: "Kubernetes resource not found";
+    readonly INSUFFICIENT_PERMISSIONS: "Insufficient permissions to access Kubernetes resources";
+};
+/**
+ * Kubernetes error templates with detailed troubleshooting
+ */
+export declare const KUBERNETES_ERROR_TEMPLATES: {
+    /**
+     * Authentication error templates
+     */
+    readonly AUTHENTICATION: {
+        /**
+         * Bearer token authentication failed
+         * @param originalError - The original error message
+         */
+        readonly INVALID_TOKEN: (originalError: string) => string;
+        /**
+         * Certificate authentication failed
+         * @param originalError - The original error message
+         */
+        readonly CERTIFICATE_FAILED: (originalError: string) => string;
+        /**
+         * Authentication provider not available
+         * @param originalError - The original error message
+         */
+        readonly PROVIDER_MISSING: (originalError: string) => string;
+        /**
+         * Generic authentication failure
+         * @param originalError - The original error message
+         */
+        readonly GENERIC_FAILED: (originalError: string) => string;
+    };
+    /**
+     * Authorization/RBAC error templates
+     */
+    readonly AUTHORIZATION: {
+        /**
+         * CRD discovery permission error
+         * @param originalError - The original error message
+         */
+        readonly CRD_PERMISSIONS: (originalError: string) => string;
+        /**
+         * Forbidden access error
+         * @param originalError - The original error message
+         */
+        readonly FORBIDDEN: (originalError: string) => string;
+        /**
+         * Generic permission denied error
+         * @param originalError - The original error message
+         */
+        readonly PERMISSION_DENIED: (originalError: string) => string;
+    };
+    /**
+     * API availability error templates
+     */
+    readonly API: {
+        /**
+         * API version not supported
+         * @param originalError - The original error message
+         */
+        readonly VERSION_UNSUPPORTED: (originalError: string) => string;
+        /**
+         * API resource not available
+         * @param originalError - The original error message
+         */
+        readonly RESOURCE_UNAVAILABLE: (originalError: string) => string;
+    };
+    /**
+     * Kubeconfig error templates
+     */
+    readonly KUBECONFIG: {
+        /**
+         * Context not found error
+         * @param originalError - The original error message
+         */
+        readonly CONTEXT_NOT_FOUND: (originalError: string) => string;
+        /**
+         * Kubeconfig file not found
+         * @param originalError - The original error message
+         */
+        readonly FILE_NOT_FOUND: (originalError: string) => string;
+        /**
+         * Invalid kubeconfig format
+         * @param originalError - The original error message
+         */
+        readonly INVALID_FORMAT: (originalError: string) => string;
+    };
+    /**
+     * Version compatibility error template
+     * @param originalError - The original error message
+     */
+    readonly VERSION_COMPATIBILITY: (originalError: string) => string;
+};
+/**
+ * AI service error messages
+ */
+export declare const AI_SERVICE_ERRORS: {
+    readonly SERVICE_UNAVAILABLE: "AI service is temporarily unavailable. Please try again later.";
+    readonly RATE_LIMIT_EXCEEDED: "Rate limit exceeded. Please wait before retrying.";
+    readonly INVALID_MODEL: "Invalid AI model specified";
+    readonly API_KEY_INVALID: "AI provider API key is invalid";
+    readonly QUOTA_EXCEEDED: "AI service quota exceeded";
+};
+/**
+ * AI service error templates with dynamic content
+ */
+export declare const AI_SERVICE_ERROR_TEMPLATES: {
+    /**
+     * API key required error template
+     * @param providerType - The AI provider type requiring the API key
+     */
+    readonly API_KEY_REQUIRED: (providerType: string) => string;
+    /**
+     * OpenAI API key required for specific service
+     * @param service - The service requiring OpenAI API key
+     */
+    readonly OPENAI_KEY_REQUIRED: (service: string) => string;
+    /**
+     * AI provider not available error
+     */
+    readonly PROVIDER_NOT_AVAILABLE: "AI provider is not available. No API keys configured. Please set ANTHROPIC_API_KEY, OPENAI_API_KEY, or another supported provider key.";
+    /**
+     * Embedding service unavailable error
+     */
+    readonly EMBEDDING_SERVICE_UNAVAILABLE: "embedding service unavailable";
+    /**
+     * AI provider not initialized for specific functionality
+     * @param functionality - The functionality requiring AI provider
+     */
+    readonly PROVIDER_NOT_INITIALIZED: (functionality: string) => string;
+    /**
+     * Unsupported provider error
+     * @param providerType - The unsupported provider type
+     * @param supportedProviders - List of supported providers
+     */
+    readonly UNSUPPORTED_PROVIDER: (providerType: string, supportedProviders: string[]) => string;
+    /**
+     * ResourceRanker not available error
+     * @param functionality - The specific functionality needing ResourceRanker
+     */
+    readonly RESOURCE_RANKER_UNAVAILABLE: (functionality: string) => string;
+};
+/**
+ * Generic error templates
+ */
+export declare const ERROR_TEMPLATES: {
+    /**
+     * Generic error with context
+     * @param operation - The operation that failed
+     * @param reason - The reason for failure
+     */
+    readonly OPERATION_FAILED: (operation: string, reason?: string) => string;
+    /**
+     * Unexpected error template
+     * @param context - Context where the error occurred
+     */
+    readonly UNEXPECTED_ERROR: (context?: string) => string;
+    /**
+     * Feature not implemented template
+     * @param feature - The feature that is not implemented
+     */
+    readonly NOT_IMPLEMENTED: (feature: string) => string;
+    /**
+     * Dependency missing template
+     * @param dependency - The missing dependency
+     */
+    readonly DEPENDENCY_MISSING: (dependency: string) => string;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/constants/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/constants/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;CAOd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;CAQpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,0BAA0B;IACrC;;OAEG;;QAED;;;WAGG;gDAC4B,MAAM;QAGrC;;;WAGG;qDACiC,MAAM;QAG1C;;;WAGG;mDAC+B,MAAM;QAGxC;;;WAGG;iDAC6B,MAAM;;IAIxC;;OAEG;;QAED;;;WAGG;kDAC8B,MAAM;QAGvC;;;WAGG;4CACwB,MAAM;QAGjC;;;WAGG;oDACgC,MAAM;;IAI3C;;OAEG;;QAED;;;WAGG;sDACkC,MAAM;QAG3C;;;WAGG;uDACmC,MAAM;;IAI9C;;OAEG;;QAED;;;WAGG;oDACgC,MAAM;QAGzC;;;WAGG;iDAC6B,MAAM;QAGtC;;;WAGG;iDAC6B,MAAM;;IAIxC;;;OAGG;oDACoC,MAAM;CAErC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;CAOpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,0BAA0B;IACrC;;;OAGG;8CAC8B,MAAM;IAGvC;;;OAGG;4CAC4B,MAAM;IAGrC;;OAEG;;IAIH;;OAEG;;IAGH;;;OAGG;uDACuC,MAAM;IAGhD;;;;OAIG;kDACkC,MAAM,sBAAsB,MAAM,EAAE;IAGzE;;;OAGG;0DAC0C,MAAM;CAE3C,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B;;;;OAIG;2CAC2B,MAAM,WAAW,MAAM;IAGrD;;;OAGG;0CAC0B,MAAM;IAKnC;;;OAGG;wCACwB,MAAM;IAEjC;;;OAGG;8CAC8B,MAAM;CAE/B,CAAC"}

package/dist/core/constants/errors.js

@@ -0,0 +1,206 @@
+"use strict";
+/**
+ * Error messages and templates
+ *
+ * Centralized error messages, categories, and templates for
+ * comprehensive error handling across the application.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERROR_TEMPLATES = exports.AI_SERVICE_ERROR_TEMPLATES = exports.AI_SERVICE_ERRORS = exports.KUBERNETES_ERROR_TEMPLATES = exports.KUBERNETES_ERRORS = exports.AUTH_ERRORS = exports.NETWORK_ERRORS = void 0;
+/**
+ * Network and connectivity error messages
+ */
+exports.NETWORK_ERRORS = {
+    CONNECTION_FAILED: 'Failed to establish connection',
+    TIMEOUT: 'Request timeout',
+    UNREACHABLE: 'Service unreachable',
+    DNS_RESOLUTION_FAILED: 'DNS resolution failed',
+    NETWORK_UNAVAILABLE: 'Network unavailable',
+};
+/**
+ * Authentication and authorization error messages
+ */
+exports.AUTH_ERRORS = {
+    AUTHENTICATION_FAILED: 'Authentication failed. Please verify your credentials.',
+    UNAUTHORIZED: 'Unauthorized access',
+    INVALID_TOKEN: 'Invalid or expired token',
+    MISSING_CREDENTIALS: 'Authentication credentials missing',
+    INVALID_API_KEY: 'Invalid API key provided',
+};
+/**
+ * Kubernetes-specific error messages
+ */
+exports.KUBERNETES_ERRORS = {
+    CLUSTER_UNREACHABLE: 'Unable to connect to Kubernetes cluster. Please check your kubeconfig and cluster connectivity.',
+    KUBECONFIG_NOT_FOUND: 'Kubeconfig file not found',
+    INVALID_CONTEXT: 'Invalid Kubernetes context',
+    RESOURCE_NOT_FOUND: 'Kubernetes resource not found',
+    INSUFFICIENT_PERMISSIONS: 'Insufficient permissions to access Kubernetes resources',
+};
+/**
+ * Kubernetes error templates with detailed troubleshooting
+ */
+exports.KUBERNETES_ERROR_TEMPLATES = {
+    /**
+     * Authentication error templates
+     */
+    AUTHENTICATION: {
+        /**
+         * Bearer token authentication failed
+         * @param originalError - The original error message
+         */
+        INVALID_TOKEN: (originalError) => `Token may be expired: Bearer token authentication failed.\n\nTroubleshooting steps:\n- Token may be expired - refresh credentials\n- Check token format in kubeconfig\n- Re-authenticate with cluster: kubectl auth login\n- Verify service account token if applicable\n\nOriginal error: ${originalError}`,
+        /**
+         * Certificate authentication failed
+         * @param originalError - The original error message
+         */
+        CERTIFICATE_FAILED: (originalError) => `Certificate authentication failed: Client certificate validation error.\n\nTroubleshooting steps:\n- Verify certificate path in kubeconfig\n- Check certificate expiration date\n- Ensure certificate authority (CA) bundle is correct\n- Re-generate client certificates if needed\n\nOriginal error: ${originalError}`,
+        /**
+         * Authentication provider not available
+         * @param originalError - The original error message
+         */
+        PROVIDER_MISSING: (originalError) => `Authentication provider not available: Required auth plugin missing.\n\nTroubleshooting steps:\n- Install required authentication plugin (e.g., OIDC)\n- Check kubectl config for auth provider configuration\n- Verify authentication method compatibility\n- Consult cluster administrator for auth setup\n\nOriginal error: ${originalError}`,
+        /**
+         * Generic authentication failure
+         * @param originalError - The original error message
+         */
+        GENERIC_FAILED: (originalError) => `Authentication failed: Invalid or missing credentials.\n\nTroubleshooting steps:\n- Verify credentials in kubeconfig\n- Re-authenticate with cluster\n- Check authentication method configuration\n- Contact cluster administrator if needed\n\nOriginal error: ${originalError}`,
+    },
+    /**
+     * Authorization/RBAC error templates
+     */
+    AUTHORIZATION: {
+        /**
+         * CRD discovery permission error
+         * @param originalError - The original error message
+         */
+        CRD_PERMISSIONS: (originalError) => `CRD discovery requires cluster-level permissions: Insufficient RBAC permissions.\n\nTroubleshooting steps:\n- CRD discovery requires admin privileges\n- Request cluster-admin role or CRD read permissions\n- Contact cluster administrator for permission escalation\n- Use 'kubectl auth can-i list customresourcedefinitions' to check permissions\n\nOriginal error: ${originalError}`,
+        /**
+         * Forbidden access error
+         * @param originalError - The original error message
+         */
+        FORBIDDEN: (originalError) => `Insufficient permissions: RBAC restrictions prevent this operation.\n\nTroubleshooting steps:\n- RBAC role required for resource access\n- Request appropriate permissions from cluster administrator\n- Check current permissions: kubectl auth can-i list <resource>\n- Consider using cluster-admin role for discovery operations\n\nOriginal error: ${originalError}`,
+        /**
+         * Generic permission denied error
+         * @param originalError - The original error message
+         */
+        PERMISSION_DENIED: (originalError) => `Permission denied: Insufficient RBAC permissions for cluster access.\n\nTroubleshooting steps:\n- Request appropriate RBAC permissions\n- Check current access: kubectl auth can-i list <resource>\n- Contact cluster administrator for role assignment\n- Verify service account permissions if applicable\n\nOriginal error: ${originalError}`,
+    },
+    /**
+     * API availability error templates
+     */
+    API: {
+        /**
+         * API version not supported
+         * @param originalError - The original error message
+         */
+        VERSION_UNSUPPORTED: (originalError) => `API version not supported: Cluster doesn't support requested API version.\n\nTroubleshooting steps:\n- Try different API version (e.g., apps/v1 instead of apps/v1beta1)\n- Check available API versions: kubectl api-versions\n- Verify Kubernetes cluster version compatibility\n- Consult API migration guides for version changes\n\nOriginal error: ${originalError}`,
+        /**
+         * API resource not available
+         * @param originalError - The original error message
+         */
+        RESOURCE_UNAVAILABLE: (originalError) => `API resource not available: Requested resource type not found in cluster.\n\nTroubleshooting steps:\n- Check available resources: kubectl api-resources\n- Verify cluster supports required resource types\n- Check Kubernetes version compatibility\n- Confirm cluster configuration and enabled APIs\n\nOriginal error: ${originalError}`,
+    },
+    /**
+     * Kubeconfig error templates
+     */
+    KUBECONFIG: {
+        /**
+         * Context not found error
+         * @param originalError - The original error message
+         */
+        CONTEXT_NOT_FOUND: (originalError) => `Context not found: Specified context doesn't exist in kubeconfig.\n\nTroubleshooting steps:\n- List available contexts: kubectl config get-contexts\n- Set correct context: kubectl config use-context <context-name>\n- Verify kubeconfig file contains required context\n- Check context name spelling and case sensitivity\n\nOriginal error: ${originalError}`,
+        /**
+         * Kubeconfig file not found
+         * @param originalError - The original error message
+         */
+        FILE_NOT_FOUND: (originalError) => `Kubeconfig file not found: Cannot locate configuration file.\n\nTroubleshooting steps:\n- Check file path exists and is accessible\n- Verify kubeconfig file permissions\n- Set KUBECONFIG environment variable if needed\n- Create kubeconfig file or copy from cluster administrator\n\nOriginal error: ${originalError}`,
+        /**
+         * Invalid kubeconfig format
+         * @param originalError - The original error message
+         */
+        INVALID_FORMAT: (originalError) => `Invalid kubeconfig format: Configuration file has syntax or format errors.\n\nTroubleshooting steps:\n- Validate YAML syntax in kubeconfig file\n- Check file structure: kubectl config view\n- Restore from backup or re-download from cluster\n- Verify all required sections (clusters, contexts, users)\n\nOriginal error: ${originalError}`,
+    },
+    /**
+     * Version compatibility error template
+     * @param originalError - The original error message
+     */
+    VERSION_COMPATIBILITY: (originalError) => `Kubernetes version compatibility issue: Version mismatch detected.\n\nTroubleshooting steps:\n- Check cluster and client versions: kubectl version\n- Verify supported Kubernetes versions for this tool\n- Update kubectl client if needed\n- Consult compatibility matrix for version support\n\nOriginal error: ${originalError}`,
+};
+/**
+ * AI service error messages
+ */
+exports.AI_SERVICE_ERRORS = {
+    SERVICE_UNAVAILABLE: 'AI service is temporarily unavailable. Please try again later.',
+    RATE_LIMIT_EXCEEDED: 'Rate limit exceeded. Please wait before retrying.',
+    INVALID_MODEL: 'Invalid AI model specified',
+    API_KEY_INVALID: 'AI provider API key is invalid',
+    QUOTA_EXCEEDED: 'AI service quota exceeded',
+};
+/**
+ * AI service error templates with dynamic content
+ */
+exports.AI_SERVICE_ERROR_TEMPLATES = {
+    /**
+     * API key required error template
+     * @param providerType - The AI provider type requiring the API key
+     */
+    API_KEY_REQUIRED: (providerType) => `API key is required for ${providerType} provider`,
+    /**
+     * OpenAI API key required for specific service
+     * @param service - The service requiring OpenAI API key
+     */
+    OPENAI_KEY_REQUIRED: (service) => `OpenAI API key required for ${service}`,
+    /**
+     * AI provider not available error
+     */
+    PROVIDER_NOT_AVAILABLE: 'AI provider is not available. No API keys configured. Please set ANTHROPIC_API_KEY, OPENAI_API_KEY, or another supported provider key.',
+    /**
+     * Embedding service unavailable error
+     */
+    EMBEDDING_SERVICE_UNAVAILABLE: 'embedding service unavailable',
+    /**
+     * AI provider not initialized for specific functionality
+     * @param functionality - The functionality requiring AI provider
+     */
+    PROVIDER_NOT_INITIALIZED: (functionality) => `AI provider not initialized. API key required for ${functionality}.`,
+    /**
+     * Unsupported provider error
+     * @param providerType - The unsupported provider type
+     * @param supportedProviders - List of supported providers
+     */
+    UNSUPPORTED_PROVIDER: (providerType, supportedProviders) => `Unsupported provider: ${providerType}. Must be one of: ${supportedProviders.join(', ')}`,
+    /**
+     * ResourceRanker not available error
+     * @param functionality - The specific functionality needing ResourceRanker
+     */
+    RESOURCE_RANKER_UNAVAILABLE: (functionality) => `ResourceRanker not available. AI provider API key is required for ${functionality}.`,
+};
+/**
+ * Generic error templates
+ */
+exports.ERROR_TEMPLATES = {
+    /**
+     * Generic error with context
+     * @param operation - The operation that failed
+     * @param reason - The reason for failure
+     */
+    OPERATION_FAILED: (operation, reason) => reason ? `${operation} failed: ${reason}` : `${operation} failed`,
+    /**
+     * Unexpected error template
+     * @param context - Context where the error occurred
+     */
+    UNEXPECTED_ERROR: (context) => context
+        ? `An unexpected error occurred in ${context}`
+        : 'An unexpected error occurred. Please try again or contact support.',
+    /**
+     * Feature not implemented template
+     * @param feature - The feature that is not implemented
+     */
+    NOT_IMPLEMENTED: (feature) => `Feature not implemented: ${feature}`,
+    /**
+     * Dependency missing template
+     * @param dependency - The missing dependency
+     */
+    DEPENDENCY_MISSING: (dependency) => `Required dependency missing: ${dependency}`,
+};

package/dist/core/constants/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Centralized constants and messages
+ *
+ * Single entry point for all constants, messages, and templates
+ * used throughout the dot-ai application.
+ */
+export * from './investigation.js';
+export * from './validation.js';
+export * from './errors.js';
+export * from './stages.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/constants/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/core/constants/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Centralized constants and messages
+ *
+ * Single entry point for all constants, messages, and templates
+ * used throughout the dot-ai application.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./investigation.js"), exports);
+__exportStar(require("./validation.js"), exports);
+__exportStar(require("./errors.js"), exports);
+__exportStar(require("./stages.js"), exports);

package/dist/core/constants/investigation.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Investigation and AI provider constants
+ *
+ * Centralized messages for AI investigation workflows, tool loops,
+ * and provider-specific interactions.
+ */
+/**
+ * Investigation workflow messages
+ */
+export declare const INVESTIGATION_MESSAGES: {
+    /**
+     * Message sent to AI when maximum investigation steps are reached
+     * Used by both host-provider and vercel-provider to force final summary
+     */
+    readonly WRAP_UP: "You have reached the maximum number of investigation steps. Please provide your final summary NOW in the required JSON format based on all findings gathered so far. Do not request any more tool calls.";
+    /**
+     * Messages for investigation lifecycle
+     */
+    readonly INVESTIGATION_START: "Starting AI investigation with toolLoop";
+    readonly INVESTIGATION_COMPLETED: "Investigation completed by toolLoop";
+    readonly INVESTIGATION_FAILED: "Investigation failed";
+    /**
+     * Tool loop status messages
+     */
+    readonly MAX_ITERATIONS_REACHED: "Maximum investigation iterations reached";
+    readonly STARTING_TOOL_LOOP: "Starting toolLoop with kubectl investigation tools";
+    readonly INVESTIGATION_AND_ANALYSIS_COMPLETED: "Investigation and analysis completed";
+};
+/**
+ * Provider-specific messages
+ */
+export declare const PROVIDER_MESSAGES: {
+    /**
+     * Session management
+     */
+    readonly SESSION_LOADED: "Loaded session for choice execution";
+    readonly SESSION_NOT_FOUND: "Session not found or expired";
+    /**
+     * Processing status
+     */
+    readonly PROCESSING_REQUEST: "Processing version tool request with system diagnostics";
+    readonly RUNNING_DIAGNOSTICS: "Running system diagnostics...";
+    readonly DIAGNOSTICS_COMPLETED: "System diagnostics completed";
+};
+//# sourceMappingURL=investigation.d.ts.map

package/dist/core/constants/investigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"investigation.d.ts","sourceRoot":"","sources":["../../../src/core/constants/investigation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC;;;OAGG;;IAGH;;OAEG;;;;IAKH;;OAEG;;;;CAIK,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;OAEG;;;IAIH;;OAEG;;;;CAIK,CAAC"}

package/dist/core/constants/investigation.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Investigation and AI provider constants
+ *
+ * Centralized messages for AI investigation workflows, tool loops,
+ * and provider-specific interactions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROVIDER_MESSAGES = exports.INVESTIGATION_MESSAGES = void 0;
+/**
+ * Investigation workflow messages
+ */
+exports.INVESTIGATION_MESSAGES = {
+    /**
+     * Message sent to AI when maximum investigation steps are reached
+     * Used by both host-provider and vercel-provider to force final summary
+     */
+    WRAP_UP: 'You have reached the maximum number of investigation steps. Please provide your final summary NOW in the required JSON format based on all findings gathered so far. Do not request any more tool calls.',
+    /**
+     * Messages for investigation lifecycle
+     */
+    INVESTIGATION_START: 'Starting AI investigation with toolLoop',
+    INVESTIGATION_COMPLETED: 'Investigation completed by toolLoop',
+    INVESTIGATION_FAILED: 'Investigation failed',
+    /**
+     * Tool loop status messages
+     */
+    MAX_ITERATIONS_REACHED: 'Maximum investigation iterations reached',
+    STARTING_TOOL_LOOP: 'Starting toolLoop with kubectl investigation tools',
+    INVESTIGATION_AND_ANALYSIS_COMPLETED: 'Investigation and analysis completed'
+};
+/**
+ * Provider-specific messages
+ */
+exports.PROVIDER_MESSAGES = {
+    /**
+     * Session management
+     */
+    SESSION_LOADED: 'Loaded session for choice execution',
+    SESSION_NOT_FOUND: 'Session not found or expired',
+    /**
+     * Processing status
+     */
+    PROCESSING_REQUEST: 'Processing version tool request with system diagnostics',
+    RUNNING_DIAGNOSTICS: 'Running system diagnostics...',
+    DIAGNOSTICS_COMPLETED: 'System diagnostics completed'
+};