@vfarcic/dot-ai 0.104.0 → 0.106.0

package/README.md

@@ -22,10 +22,13 @@ DevOps AI Toolkit is an AI-powered development productivity platform that enhanc
 - **SRE Teams**: Automate root cause analysis and generate executable remediation commands
 - **Support Teams**: Handle incident response with AI-guided investigation and repair workflows
 
+<!--
 ### Platform Building
+DEVELOPER NOTE: This tool is under active development with incomplete functionality. Not recommended for production use.
 - **Platform Engineers**: Install and configure platform tools conversationally without memorizing script paths and commands
 - **New Team Members**: Build platform infrastructure through zero-knowledge guided workflows
 - **DevOps Teams**: Create and manage Kubernetes clusters through natural language interactions
+-->
 
 ### Documentation Testing  
 - **Documentation Maintainers**: Automatically validate documentation accuracy and catch outdated content
@@ -84,7 +87,9 @@ Result: Finds sqls.devopstoolkit.live as perfect match ✨
 
 📖 [Learn more →](./docs/mcp-remediate-guide.md)
 
+<!--
 ### Platform Building
+DEVELOPER NOTE: This tool is under active development with incomplete functionality. Not recommended for production use.
 🗣️ **Natural Language Operations**: Install tools and create clusters through conversation without memorizing commands
 🔍 **Dynamic Discovery**: Automatically discovers 21+ available platform operations from infrastructure scripts
 🤖 **AI-Powered Intent Mapping**: Understands variations like "Install Argo CD", "Set up ArgoCD", "Deploy Argo CD"
@@ -92,6 +97,7 @@ Result: Finds sqls.devopstoolkit.live as perfect match ✨
 🎯 **Zero-Knowledge Onboarding**: New users successfully build platforms without documentation
 
 📖 [Learn more →](./docs/mcp-build-platform-guide.md)
+-->
 
 ### Documentation Testing & Validation
 📖 **Automated Testing**: Validates documentation by executing commands and testing examples  
@@ -181,4 +187,3 @@ MIT License - see [LICENSE](LICENSE) file for details.
 ---
 
 **DevOps AI Toolkit** - AI-powered development productivity platform for enhanced software development workflows.
-

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

@@ -0,0 +1,90 @@
+/**
+ * AI Provider Factory
+ *
+ * Creates AI provider instances based on configuration.
+ * Supports environment-based provider selection and extensible provider architecture.
+ *
+ * Phase 1 Implementation (PRD 73): anthropic, openai, google
+ * Architecture supports future expansion to 19+ Vercel AI SDK providers
+ */
+import { AIProvider, AIProviderConfig } from './ai-provider.interface';
+/**
+ * Factory for creating AI provider instances
+ *
+ * Usage:
+ * ```typescript
+ * // Explicit provider selection
+ * const provider = AIProviderFactory.create({
+ *   provider: 'anthropic',
+ *   apiKey: process.env.ANTHROPIC_API_KEY
+ * });
+ *
+ * // Auto-detect from environment
+ * const provider = AIProviderFactory.createFromEnv();
+ * ```
+ */
+export declare class AIProviderFactory {
+    /**
+     * Create an AI provider instance with explicit configuration
+     *
+     * @param config Provider configuration
+     * @returns Configured AI provider instance
+     * @throws Error if provider type is unsupported or configuration is invalid
+     */
+    static create(config: AIProviderConfig): AIProvider;
+    /**
+     * Create provider from environment variables
+     *
+     * Detects provider from AI_PROVIDER env var (defaults to 'anthropic')
+     * and loads corresponding API key from environment.
+     *
+     * Supports AI_PROVIDER_SDK env var to override SDK choice:
+     * - 'native' (default): Use native provider SDK
+     * - 'vercel': Use Vercel AI SDK for the provider
+     *
+     * @returns Configured AI provider instance
+     * @throws Error if required environment variables are missing
+     */
+    static createFromEnv(): AIProvider;
+    /**
+     * Create Anthropic provider instance
+     * @private
+     */
+    private static createAnthropicProvider;
+    /**
+     * Create OpenAI provider instance
+     * @private
+     */
+    private static createOpenAIProvider;
+    /**
+     * Create Google provider instance
+     * @private
+     */
+    private static createGoogleProvider;
+    /**
+     * Check if a provider is available (has API key configured)
+     *
+     * @param provider Provider type to check
+     * @returns true if provider has API key configured
+     */
+    static isProviderAvailable(provider: string): boolean;
+    /**
+     * Get list of available providers (implemented + have API keys configured)
+     *
+     * @returns Array of available provider types
+     */
+    static getAvailableProviders(): string[];
+    /**
+     * Check if a provider is implemented in current phase
+     *
+     * @param provider Provider type to check
+     * @returns true if provider is implemented
+     */
+    static isProviderImplemented(provider: string): boolean;
+}
+/**
+ * Convenience function to create AI provider from environment
+ * Maintains backward compatibility with existing code
+ */
+export declare function createAIProvider(): AIProvider;
+//# sourceMappingURL=ai-provider-factory.d.ts.map

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

@@ -0,0 +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;AAoBjC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU;IAoCnD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,aAAa,IAAI,UAAU;IA+ClC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAItC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAInC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAInC;;;;;OAKG;IACH,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAMrD;;;;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

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * AI Provider Factory
+ *
+ * Creates AI provider instances based on configuration.
+ * Supports environment-based provider selection and extensible provider architecture.
+ *
+ * Phase 1 Implementation (PRD 73): anthropic, openai, google
+ * Architecture supports future expansion to 19+ Vercel AI SDK providers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIProviderFactory = void 0;
+exports.createAIProvider = createAIProvider;
+const anthropic_provider_1 = require("./providers/anthropic-provider");
+const vercel_provider_1 = require("./providers/vercel-provider");
+/**
+ * Provider environment variable mappings
+ * Phase 1 (PRD 73): anthropic, openai, google
+ */
+const PROVIDER_ENV_KEYS = {
+    anthropic: 'ANTHROPIC_API_KEY',
+    openai: 'OPENAI_API_KEY',
+    google: 'GOOGLE_API_KEY',
+};
+/**
+ * Providers implemented in Phase 1
+ */
+const IMPLEMENTED_PROVIDERS = ['anthropic', 'openai', 'google'];
+/**
+ * Factory for creating AI provider instances
+ *
+ * Usage:
+ * ```typescript
+ * // Explicit provider selection
+ * const provider = AIProviderFactory.create({
+ *   provider: 'anthropic',
+ *   apiKey: process.env.ANTHROPIC_API_KEY
+ * });
+ *
+ * // Auto-detect from environment
+ * const provider = AIProviderFactory.createFromEnv();
+ * ```
+ */
+class AIProviderFactory {
+    /**
+     * Create an AI provider instance with explicit configuration
+     *
+     * @param config Provider configuration
+     * @returns Configured AI provider instance
+     * @throws Error if provider type is unsupported or configuration is invalid
+     */
+    static create(config) {
+        // Validate configuration
+        if (!config.apiKey) {
+            throw new Error(`API key is required for ${config.provider} provider`);
+        }
+        if (!config.provider) {
+            throw new Error('Provider type must be specified');
+        }
+        // Check if provider is implemented in Phase 1
+        if (!IMPLEMENTED_PROVIDERS.includes(config.provider)) {
+            throw new Error(`Provider '${config.provider}' is not yet implemented. ` +
+                `Phase 1 providers: ${IMPLEMENTED_PROVIDERS.join(', ')}. ` +
+                `Future phases will add support for additional Vercel AI SDK providers.`);
+        }
+        // Create provider based on type
+        switch (config.provider) {
+            case 'anthropic':
+                return this.createAnthropicProvider(config);
+            case 'openai':
+                return this.createOpenAIProvider(config);
+            case 'google':
+                return this.createGoogleProvider(config);
+            default:
+                // This should never happen due to IMPLEMENTED_PROVIDERS check above
+                throw new Error(`Unsupported provider: ${config.provider}`);
+        }
+    }
+    /**
+     * Create provider from environment variables
+     *
+     * Detects provider from AI_PROVIDER env var (defaults to 'anthropic')
+     * and loads corresponding API key from environment.
+     *
+     * Supports AI_PROVIDER_SDK env var to override SDK choice:
+     * - 'native' (default): Use native provider SDK
+     * - 'vercel': Use Vercel AI SDK for the provider
+     *
+     * @returns Configured AI provider instance
+     * @throws Error if required environment variables are missing
+     */
+    static createFromEnv() {
+        const providerType = process.env.AI_PROVIDER || 'anthropic';
+        const sdkPreference = process.env.AI_PROVIDER_SDK || 'native';
+        // Validate provider is implemented
+        if (!IMPLEMENTED_PROVIDERS.includes(providerType)) {
+            throw new Error(`Invalid AI_PROVIDER: ${providerType}. ` +
+                `Must be one of: ${IMPLEMENTED_PROVIDERS.join(', ')}`);
+        }
+        // Get API key for the provider
+        const apiKeyEnvVar = PROVIDER_ENV_KEYS[providerType];
+        if (!apiKeyEnvVar) {
+            throw new Error(`No API key environment variable defined for provider: ${providerType}`);
+        }
+        const apiKey = process.env[apiKeyEnvVar];
+        if (!apiKey) {
+            throw new Error(`${apiKeyEnvVar} environment variable must be set for ${providerType} provider`);
+        }
+        // Get optional model override
+        const model = process.env.AI_MODEL;
+        // Get debug mode setting
+        const debugMode = process.env.DEBUG_DOT_AI === 'true';
+        // If SDK override to 'vercel', use VercelProvider for all providers
+        if (sdkPreference === 'vercel') {
+            return new vercel_provider_1.VercelProvider({
+                provider: providerType,
+                apiKey,
+                model,
+                debugMode
+            });
+        }
+        return this.create({
+            provider: providerType,
+            apiKey,
+            model,
+            debugMode
+        });
+    }
+    /**
+     * Create Anthropic provider instance
+     * @private
+     */
+    static createAnthropicProvider(config) {
+        return new anthropic_provider_1.AnthropicProvider(config);
+    }
+    /**
+     * Create OpenAI provider instance
+     * @private
+     */
+    static createOpenAIProvider(config) {
+        return new vercel_provider_1.VercelProvider(config);
+    }
+    /**
+     * Create Google provider instance
+     * @private
+     */
+    static createGoogleProvider(config) {
+        return new vercel_provider_1.VercelProvider(config);
+    }
+    /**
+     * Check if a provider is available (has API key configured)
+     *
+     * @param provider Provider type to check
+     * @returns true if provider has API key configured
+     */
+    static isProviderAvailable(provider) {
+        const apiKeyEnvVar = PROVIDER_ENV_KEYS[provider];
+        if (!apiKeyEnvVar)
+            return false;
+        return !!process.env[apiKeyEnvVar];
+    }
+    /**
+     * Get list of available providers (implemented + have API keys configured)
+     *
+     * @returns Array of available provider types
+     */
+    static getAvailableProviders() {
+        return IMPLEMENTED_PROVIDERS.filter(provider => this.isProviderAvailable(provider));
+    }
+    /**
+     * Check if a provider is implemented in current phase
+     *
+     * @param provider Provider type to check
+     * @returns true if provider is implemented
+     */
+    static isProviderImplemented(provider) {
+        return IMPLEMENTED_PROVIDERS.includes(provider);
+    }
+}
+exports.AIProviderFactory = AIProviderFactory;
+/**
+ * Convenience function to create AI provider from environment
+ * Maintains backward compatibility with existing code
+ */
+function createAIProvider() {
+    return AIProviderFactory.createFromEnv();
+}

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

@@ -0,0 +1,208 @@
+/**
+ * AI Provider Interface
+ *
+ * Provider-agnostic abstraction for AI services supporting multiple providers
+ * through Vercel AI SDK (19+ providers supported).
+ *
+ * This interface is extracted from actual ClaudeIntegration usage patterns
+ * across the codebase, ensuring backward compatibility and minimal migration effort.
+ *
+ * Phase 1 Implementation (PRD 73): Anthropic, OpenAI, Google
+ * Future: AWS Bedrock, Mistral, Groq, Ollama, etc.
+ */
+/**
+ * Standard AI response structure
+ */
+export interface AIResponse {
+    content: string;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+}
+/**
+ * Impact level for clarification opportunities
+ */
+export type ImpactLevel = 'HIGH' | 'MEDIUM' | 'LOW';
+/**
+ * Clarification category types
+ */
+export type ClarificationCategory = 'TECHNICAL_SPECIFICATIONS' | 'ARCHITECTURAL_CONTEXT' | 'OPERATIONAL_REQUIREMENTS' | 'SECURITY_COMPLIANCE' | 'ORGANIZATIONAL_ALIGNMENT';
+/**
+ * Clarification opportunity structure
+ */
+export interface ClarificationOpportunity {
+    category: ClarificationCategory;
+    missingContext: string;
+    impactLevel: ImpactLevel;
+    reasoning: string;
+    suggestedQuestions?: string[];
+    patternAlignment?: string;
+}
+/**
+ * Intent analysis result structure
+ */
+export interface IntentAnalysisResult {
+    clarificationOpportunities: ClarificationOpportunity[];
+    overallAssessment: {
+        enhancementPotential: ImpactLevel;
+        primaryGaps: string[];
+        recommendedFocus: string;
+    };
+    intentQuality: {
+        currentSpecificity: string;
+        strengthAreas: string[];
+        improvementAreas: string[];
+    };
+}
+/**
+ * AI Provider configuration
+ */
+export interface AIProviderConfig {
+    /** API key for the provider */
+    apiKey: string;
+    /** Provider type (extensible string - supports any Vercel AI SDK provider) */
+    provider: string;
+    /** Optional model override (defaults to provider-specific default) */
+    model?: string;
+    /** Enable debug mode for logging AI interactions */
+    debugMode?: boolean;
+}
+/**
+ * Tool definition for AI providers
+ * Defines a tool that the AI can call during agentic loops
+ */
+export interface AITool {
+    /** Unique tool name (e.g., 'kubectl_get', 'search_capabilities') */
+    name: string;
+    /** Human-readable description of what the tool does and when to use it */
+    description: string;
+    /** JSON schema for tool input parameters */
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, any>;
+        required?: string[];
+    };
+}
+/**
+ * Tool executor function type
+ * Called by the provider when AI requests a tool execution
+ */
+export type ToolExecutor = (toolName: string, input: any) => Promise<any>;
+/**
+ * Configuration for agentic tool loop
+ */
+export interface ToolLoopConfig {
+    /** System prompt with context and strategic guidance */
+    systemPrompt: string;
+    /** User message/query to respond to */
+    userMessage: string;
+    /** Available tools for this workflow (scoped to workflow needs) */
+    tools: AITool[];
+    /** Function to execute tool calls */
+    toolExecutor: ToolExecutor;
+    /** Maximum number of AI iterations (default: 20) */
+    maxIterations?: number;
+    /** Optional callback invoked after each iteration */
+    onIteration?: (iteration: number, toolCalls: any[]) => void;
+    /** Optional operation identifier for metrics and debugging */
+    operation?: string;
+}
+/**
+ * Result from agentic tool loop
+ */
+export interface AgenticResult {
+    /** Final text response from AI after completing tool loop */
+    finalMessage: string;
+    /** Number of iterations executed */
+    iterations: number;
+    /** All tool calls executed during the loop */
+    toolCallsExecuted: Array<{
+        tool: string;
+        input: any;
+        output: any;
+    }>;
+    /** Token usage statistics */
+    totalTokens: {
+        input: number;
+        output: number;
+    };
+}
+/**
+ * AI Provider Interface
+ *
+ * Minimal interface based on actual usage across 10 dependent files.
+ * Only includes methods that are currently called in production code.
+ */
+export interface AIProvider {
+    /**
+     * Send a message to the AI service
+     *
+     * Primary method for all AI interactions. Supports streaming for long operations.
+     * Used in: recommend.ts, answer-question.ts, generate-manifests.ts, remediate.ts,
+     *          schema.ts, unified-creation-session.ts, platform-operations.ts
+     *
+     * @param message The message/prompt to send
+     * @param operation Optional operation identifier for debugging (e.g., 'deployment', 'intent-analysis')
+     * @returns AI response with content and usage statistics
+     */
+    sendMessage(message: string, operation?: string): Promise<AIResponse>;
+    /**
+     * Check if the provider is properly initialized
+     *
+     * Used in: schema.ts (pre-flight check before AI calls)
+     *
+     * @returns true if provider is ready to use, false otherwise
+     */
+    isInitialized(): boolean;
+    /**
+     * Get the default model for this provider
+     *
+     * NEW: Required to replace hardcoded model at claude.ts:181
+     * Each provider has different model naming conventions.
+     *
+     * @returns Model identifier (e.g., 'claude-sonnet-4-5', 'gpt-4o', 'gemini-1.5-pro')
+     */
+    getDefaultModel(): string;
+    /**
+     * Get the provider type
+     *
+     * NEW: Useful for debugging and logging
+     *
+     * @returns Provider identifier (e.g., 'anthropic', 'openai', 'google')
+     */
+    getProviderType(): string;
+    /**
+     * Execute agentic loop with tool calling (NEW - PRD #136)
+     *
+     * AI autonomously decides which tools to call and when to stop.
+     * Supports multi-turn conversations with tool execution.
+     *
+     * NOTE: Currently NOT USED in codebase. PRD #136 analysis showed JSON-based loops
+     * achieve same goals without SDK overhead. Kept for potential future use.
+     *
+     * IMPLEMENTATION STATUS:
+     * - AnthropicProvider: ✅ Implemented
+     * - VercelAIProvider: ❌ Not implemented (not needed for current workflows)
+     *
+     * @param config Tool loop configuration with system prompt, tools, and executor
+     * @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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-provider.interface.d.ts","sourceRoot":"","sources":["../../src/core/ai-provider.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,0BAA0B,GAC1B,uBAAuB,GACvB,0BAA0B,GAC1B,qBAAqB,GACrB,0BAA0B,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0BAA0B,EAAE,wBAAwB,EAAE,CAAC;IACvD,iBAAiB,EAAE;QACjB,oBAAoB,EAAE,WAAW,CAAC;QAClC,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,aAAa,EAAE;QACb,kBAAkB,EAAE,MAAM,CAAC;QAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IAEf,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IAEjB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IAEb,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IAEpB,4CAA4C;IAC5C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IAErB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IAEpB,mEAAmE;IACnE,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB,qCAAqC;IACrC,YAAY,EAAE,YAAY,CAAC;IAE3B,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,qDAAqD;IACrD,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAE5D,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IAErB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IAEnB,8CAA8C;IAC9C,iBAAiB,EAAE,KAAK,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,GAAG,CAAC;QACX,MAAM,EAAE,GAAG,CAAC;KACb,CAAC,CAAC;IAEH,6BAA6B;IAC7B,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;;;;;OAUG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEtE;;;;;;OAMG;IACH,aAAa,IAAI,OAAO,CAAC;IAEzB;;;;;;;OAOG;IACH,eAAe,IAAI,MAAM,CAAC;IAE1B;;;;;;OAMG;IACH,eAAe,IAAI,MAAM,CAAC;IAE1B;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEzD;;;;;;;;;;;OAWG;IACH,oBAAoB,CAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,EACf,YAAY,EAAE,YAAY,EAC1B,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,GAAG;QAAE,SAAS,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC,CAAC;CAChD"}

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

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * AI Provider Interface
+ *
+ * Provider-agnostic abstraction for AI services supporting multiple providers
+ * through Vercel AI SDK (19+ providers supported).
+ *
+ * This interface is extracted from actual ClaudeIntegration usage patterns
+ * across the codebase, ensuring backward compatibility and minimal migration effort.
+ *
+ * Phase 1 Implementation (PRD 73): Anthropic, OpenAI, Google
+ * Future: AWS Bedrock, Mistral, Groq, Ollama, etc.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/capabilities.d.ts

@@ -7,7 +7,7 @@
  * AI-powered analysis of schemas and metadata.
  */
 import { Logger } from './error-handling';
-import { ClaudeIntegration } from './claude';
+import { AIProvider } from './ai-provider.interface';
 /**
  * Complete resource capability data structure for Vector DB storage
  */
@@ -31,8 +31,8 @@ export interface ResourceCapability {
  */
 export declare class CapabilityInferenceEngine {
     private logger;
-    private claudeIntegration;
-    constructor(claudeIntegration: ClaudeIntegration, logger: Logger);
+    private aiProvider;
+    constructor(aiProvider: AIProvider, logger: Logger);
     /**
      * Main entry point: analyze resource to infer complete capabilities
      *

package/dist/core/capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/core/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAI7C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAEjC,YAAY,EAAE,MAAM,CAAC;IAGrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAGtC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAGhB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAGrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,iBAAiB,CAAoB;gBAEjC,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM;IAKhE;;;;;OAKG;IACG,iBAAiB,CACrB,YAAY,EAAE,MAAM,EACpB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,kBAAkB,CAAC;IA2B9B;;;;OAIG;YACW,WAAW;IA0BzB;;;;OAIG;YACW,oBAAoB;IAalC;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAwD/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAyB/B;;;OAGG;IACH,MAAM,CAAC,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;CAQ1D"}
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/core/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAIrD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAEjC,YAAY,EAAE,MAAM,CAAC;IAGrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAGtC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAGhB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAGrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAa;gBAEnB,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM;IAKlD;;;;;OAKG;IACG,iBAAiB,CACrB,YAAY,EAAE,MAAM,EACpB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,kBAAkB,CAAC;IA2B9B;;;;OAIG;YACW,WAAW;IA0BzB;;;;OAIG;YACW,oBAAoB;IAalC;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAwD/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAyB/B;;;OAGG;IACH,MAAM,CAAC,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;CAQ1D"}

package/dist/core/capabilities.js

@@ -18,9 +18,9 @@ const shared_prompt_loader_1 = require("./shared-prompt-loader");
  */
 class CapabilityInferenceEngine {
     logger;
-    claudeIntegration;
-    constructor(claudeIntegration, logger) {
-        this.claudeIntegration = claudeIntegration;
+    aiProvider;
+    constructor(aiProvider, logger) {
+        this.aiProvider = aiProvider;
         this.logger = logger;
     }
     /**
@@ -58,7 +58,7 @@ class CapabilityInferenceEngine {
     async inferWithAI(resourceName, resourceDefinition, requestId) {
         try {
             const prompt = await this.buildInferencePrompt(resourceName, resourceDefinition);
-            const response = await this.claudeIntegration.sendMessage(prompt);
+            const response = await this.aiProvider.sendMessage(prompt);
             return this.parseCapabilitiesFromAI(response.content);
         }
         catch (error) {

package/dist/core/capability-scan-workflow.d.ts.map

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

package/dist/core/capability-scan-workflow.js

@@ -12,7 +12,7 @@ exports.handleProcessingMode = handleProcessingMode;
 exports.handleScanning = handleScanning;
 const discovery_1 = require("./discovery");
 const capabilities_1 = require("./capabilities");
-const claude_1 = require("./claude");
+const ai_provider_factory_1 = require("./ai-provider-factory");
 /**
  * Create user-friendly error message for resource definition failures
  */
@@ -352,23 +352,38 @@ async function handleScanning(session, args, logger, requestId, capabilityServic
         }
         // Import capability engine
         // Already imported at top of file
-        // Validate Claude API key - skip in test environment
+        // Validate AI provider - skip in test environment
         const isTestEnvironment = process.env.NODE_ENV === 'test' || process.env.JEST_WORKER_ID;
-        const apiKey = process.env.ANTHROPIC_API_KEY;
-        if (!isTestEnvironment && !apiKey) {
-            return {
-                success: false,
-                operation: 'scan',
-                dataType: 'capabilities',
-                error: {
-                    message: 'ANTHROPIC_API_KEY required for capability inference',
-                    details: 'Set ANTHROPIC_API_KEY environment variable to enable AI-powered capability analysis'
+        if (!isTestEnvironment) {
+            try {
+                const aiProvider = (0, ai_provider_factory_1.createAIProvider)();
+                if (!aiProvider.isInitialized()) {
+                    return {
+                        success: false,
+                        operation: 'scan',
+                        dataType: 'capabilities',
+                        error: {
+                            message: 'AI provider API key required for capability inference',
+                            details: 'Configure AI provider credentials to enable AI-powered capability analysis'
+                        }
+                    };
                 }
-            };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    operation: 'scan',
+                    dataType: 'capabilities',
+                    error: {
+                        message: 'AI provider initialization failed',
+                        details: error instanceof Error ? error.message : 'Unknown error'
+                    }
+                };
+            }
         }
         // Initialize capability engine
-        const claudeIntegration = new claude_1.ClaudeIntegration(apiKey || 'test-api-key');
-        const engine = new capabilities_1.CapabilityInferenceEngine(claudeIntegration, logger);
+        const aiProvider = (0, ai_provider_factory_1.createAIProvider)();
+        const engine = new capabilities_1.CapabilityInferenceEngine(aiProvider, logger);
         // Get the resource to analyze
         let resourceName;
         let currentIndex;