monty-autonomous-fullstack-dev-multillm 1.0.0

package/dist/providers/cursor-provider.js

@@ -0,0 +1,321 @@
+/**
+ * Cursor Provider (Cloud Agents API)
+ * Wrapper around Cursor's Cloud Agents REST API for multi-provider orchestration.
+ * Supports IDE-integrated workflows and rapid prototyping.
+ *
+ * Copyright (c) 2025 Dobeu Tech Solutions LLC
+ * Licensed under CC BY-NC 4.0
+ */
+import { BaseProvider, } from './base-provider.js';
+import { PROVIDER_CONFIGS, } from '../config/provider-config.js';
+/**
+ * Cursor Provider Implementation
+ * Wraps the Cursor Cloud Agents API for use in multi-provider orchestration
+ */
+export class CursorProvider extends BaseProvider {
+    name = 'cursor';
+    displayName = 'Cursor Cloud Agents';
+    packageName = null; // REST API only
+    config = PROVIDER_CONFIGS.cursor;
+    apiKey = null;
+    baseUrl = 'https://api.cursor.com/v0';
+    currentTaskId = null;
+    constructor(apiKey) {
+        super();
+        this.apiKey = apiKey ?? process.env.CURSOR_API_KEY ?? null;
+        this.status.authenticated = !!this.apiKey;
+        this.status.available = this.status.authenticated;
+    }
+    /**
+     * Execute a query using the Cursor Cloud Agents API
+     */
+    async *query(prompt, options) {
+        const startTime = Date.now();
+        if (!this.apiKey) {
+            yield {
+                type: 'error',
+                content: [{
+                        type: 'text',
+                        text: 'Cursor API key not configured. Set CURSOR_API_KEY environment variable.',
+                    }],
+                metadata: {
+                    provider: this.name,
+                    latency_ms: Date.now() - startTime,
+                },
+            };
+            return;
+        }
+        try {
+            // Map standard tools to Cursor tools
+            const cursorTools = options.tools
+                ? this.mapToolNames(options.tools)
+                : undefined;
+            // Build request body
+            const requestBody = {
+                prompt,
+                tools: cursorTools,
+                model: options.model,
+                workspace_context: {
+                    cwd: process.cwd(),
+                },
+            };
+            // Submit task
+            const submitResponse = await fetch(`${this.baseUrl}/agents`, {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${this.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(requestBody),
+            });
+            if (!submitResponse.ok) {
+                const errorText = await submitResponse.text();
+                throw new Error(`Cursor API error (${submitResponse.status}): ${errorText}`);
+            }
+            const task = await submitResponse.json();
+            this.currentTaskId = task.id;
+            // Poll for completion (Cursor API is async)
+            const result = await this.pollForCompletion(task.id, options.timeout_ms ?? 120000);
+            // Normalize and yield result
+            const message = this.normalizeMessage(result);
+            message.metadata = {
+                ...message.metadata,
+                provider: this.name,
+                latency_ms: Date.now() - startTime,
+            };
+            yield message;
+            // Yield final result message
+            yield {
+                type: 'result',
+                subtype: result.status === 'completed' ? 'success' : 'error',
+                content: [],
+                metadata: {
+                    provider: this.name,
+                    latency_ms: Date.now() - startTime,
+                },
+            };
+            this.updateStatus(result.status === 'completed');
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.updateStatus(false, errorMessage);
+            yield {
+                type: 'error',
+                content: [{
+                        type: 'text',
+                        text: `Cursor provider error: ${errorMessage}`,
+                    }],
+                metadata: {
+                    provider: this.name,
+                    latency_ms: Date.now() - startTime,
+                },
+            };
+        }
+    }
+    /**
+     * Poll for task completion
+     */
+    async pollForCompletion(taskId, timeout) {
+        const startTime = Date.now();
+        const pollInterval = 1000; // 1 second
+        while (Date.now() - startTime < timeout) {
+            const response = await fetch(`${this.baseUrl}/agents/${taskId}`, {
+                method: 'GET',
+                headers: {
+                    'Authorization': `Bearer ${this.apiKey}`,
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to get task status: ${response.status}`);
+            }
+            const task = await response.json();
+            if (task.status === 'completed' || task.status === 'failed') {
+                return task;
+            }
+            // Wait before polling again
+            await new Promise(resolve => setTimeout(resolve, pollInterval));
+        }
+        throw new Error(`Task timed out after ${timeout}ms`);
+    }
+    /**
+     * Validate Cursor API credentials
+     */
+    async validateCredentials() {
+        const key = this.apiKey ?? process.env.CURSOR_API_KEY;
+        if (!key) {
+            this.status.authenticated = false;
+            return false;
+        }
+        try {
+            // Make a health check request
+            const response = await fetch(`${this.baseUrl}/health`, {
+                method: 'GET',
+                headers: {
+                    'Authorization': `Bearer ${key}`,
+                },
+            });
+            const isValid = response.status === 200;
+            this.status.authenticated = isValid;
+            this.status.available = isValid;
+            return isValid;
+        }
+        catch (error) {
+            console.warn('Could not validate Cursor API key online');
+            // Assume valid if we can't check (network error)
+            return true;
+        }
+    }
+    /**
+     * List available Cursor models
+     */
+    async listModels() {
+        return this.config.models.map(model => ({
+            id: model.id,
+            name: model.name,
+            contextWindow: model.contextWindow,
+            costPerMToken: model.costPerMToken,
+            capabilities: model.capabilities,
+        }));
+    }
+    /**
+     * Get Cursor provider capabilities
+     */
+    getCapabilities() {
+        return { ...this.config.capabilities };
+    }
+    /**
+     * Get list of supported standard tools
+     */
+    getSupportedTools() {
+        return Object.entries(this.config.toolMapping)
+            .filter(([_, mapped]) => mapped !== null)
+            .map(([standard]) => standard);
+    }
+    /**
+     * Map standard tool name to Cursor tool name
+     */
+    mapToolName(standardTool) {
+        const mapped = this.config.toolMapping[standardTool];
+        return mapped ?? null;
+    }
+    /**
+     * Get current task ID
+     */
+    getCurrentTaskId() {
+        return this.currentTaskId;
+    }
+    /**
+     * Cancel current task (if running)
+     */
+    async cancelCurrentTask() {
+        if (!this.currentTaskId || !this.apiKey) {
+            return false;
+        }
+        try {
+            const response = await fetch(`${this.baseUrl}/agents/${this.currentTaskId}/cancel`, {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${this.apiKey}`,
+                },
+            });
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Normalize Cursor response to standard format
+     */
+    normalizeMessage(rawMessage) {
+        const response = rawMessage;
+        const content = [];
+        // Handle errors
+        if (response.status === 'failed') {
+            content.push({
+                type: 'text',
+                text: response.error ?? 'Task failed without error message',
+            });
+            return {
+                type: 'error',
+                content,
+                metadata: {
+                    provider: this.name,
+                },
+            };
+        }
+        // Add main content
+        if (response.result?.content) {
+            content.push({
+                type: 'text',
+                text: response.result.content,
+            });
+        }
+        // Add tool calls if present
+        if (response.result?.tool_calls) {
+            for (const toolCall of response.result.tool_calls) {
+                content.push({
+                    type: 'tool_use',
+                    id: `tool_${Date.now()}_${Math.random().toString(36).slice(2)}`,
+                    name: toolCall.tool,
+                    input: toolCall.input,
+                });
+                if (toolCall.output) {
+                    content.push({
+                        type: 'tool_result',
+                        tool_use_id: `tool_${Date.now()}`,
+                        content: toolCall.output,
+                    });
+                }
+            }
+        }
+        // Add files modified info
+        if (response.result?.files_modified && response.result.files_modified.length > 0) {
+            content.push({
+                type: 'text',
+                text: `\n\nFiles modified:\n${response.result.files_modified.map(f => `  - ${f}`).join('\n')}`,
+            });
+        }
+        return {
+            type: 'assistant',
+            content,
+            metadata: {
+                provider: this.name,
+                usage: response.usage ? {
+                    input_tokens: response.usage.tokens_used,
+                    output_tokens: 0, // Cursor doesn't separate input/output
+                } : undefined,
+            },
+        };
+    }
+    /**
+     * Set API key at runtime
+     */
+    setApiKey(key) {
+        this.apiKey = key;
+        this.status.authenticated = true;
+        this.status.available = true;
+    }
+    /**
+     * Get the current API key (masked for display)
+     */
+    getApiKeyPreview() {
+        if (!this.apiKey)
+            return null;
+        return `${this.apiKey.slice(0, 8)}...${this.apiKey.slice(-4)}`;
+    }
+    /**
+     * Set custom API endpoint (for self-hosted instances)
+     */
+    setBaseUrl(url) {
+        this.baseUrl = url;
+    }
+}
+/**
+ * Create a new Cursor provider instance
+ */
+export function createCursorProvider(apiKey) {
+    return new CursorProvider(apiKey);
+}
+export default CursorProvider;
+//# sourceMappingURL=cursor-provider.js.map

package/dist/providers/cursor-provider.js.map

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

package/dist/providers/google-provider.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Google Provider (Gemini ADK)
+ * Wrapper around Google's Agent Development Kit for multi-provider orchestration.
+ * Supports multi-agent workflows and large context windows.
+ *
+ * Copyright (c) 2025 Dobeu Tech Solutions LLC
+ * Licensed under CC BY-NC 4.0
+ */
+import { BaseProvider, type AgentMessage, type QueryOptions, type ProviderCapabilities, type ModelInfo } from './base-provider.js';
+import { type ProviderName } from '../config/provider-config.js';
+/**
+ * Google Provider Implementation
+ * Wraps the Google ADK for use in multi-provider orchestration
+ */
+export declare class GoogleProvider extends BaseProvider {
+    readonly name: ProviderName;
+    readonly displayName = "Gemini (Google ADK)";
+    readonly packageName = "@google/adk";
+    private config;
+    private apiKey;
+    private agent;
+    private LlmAgentClass;
+    private FunctionToolClass;
+    constructor(apiKey?: string);
+    /**
+     * Initialize the Google ADK client
+     */
+    private initializeClient;
+    /**
+     * Create an agent instance with the given configuration
+     */
+    private createAgent;
+    /**
+     * Execute a query using the Google ADK
+     */
+    query(prompt: string, options: QueryOptions): AsyncGenerator<AgentMessage, void, unknown>;
+    /**
+     * Validate Google API credentials
+     */
+    validateCredentials(): Promise<boolean>;
+    /**
+     * List available Gemini models
+     */
+    listModels(): Promise<ModelInfo[]>;
+    /**
+     * Get Google provider capabilities
+     */
+    getCapabilities(): ProviderCapabilities;
+    /**
+     * Get list of supported standard tools
+     */
+    getSupportedTools(): string[];
+    /**
+     * Map standard tool name to Google tool name
+     */
+    mapToolName(standardTool: string): string | null;
+    /**
+     * Normalize ADK result to standard format
+     */
+    protected normalizeMessage(rawMessage: unknown): AgentMessage;
+    /**
+     * Set API key at runtime
+     */
+    setApiKey(key: string): void;
+    /**
+     * Get the current API key (masked for display)
+     */
+    getApiKeyPreview(): string | null;
+}
+/**
+ * Create a new Google provider instance
+ */
+export declare function createGoogleProvider(apiKey?: string): GoogleProvider;
+export default GoogleProvider;
+//# sourceMappingURL=google-provider.d.ts.map

package/dist/providers/google-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-provider.d.ts","sourceRoot":"","sources":["../../src/providers/google-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,YAAY,EAGlB,MAAM,8BAA8B,CAAC;AAwBtC;;;GAGG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAY;IACvC,QAAQ,CAAC,WAAW,yBAAyB;IAC7C,QAAQ,CAAC,WAAW,iBAAiB;IAErC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,MAAM,CAAuB;IAErC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,iBAAiB,CAAwC;gBAErD,MAAM,CAAC,EAAE,MAAM;IAO3B;;OAEG;YACW,gBAAgB;IAuC9B;;OAEG;IAEH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACI,KAAK,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,GACpB,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC;IAsE9C;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAuB7C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAUxC;;OAEG;IACH,eAAe,IAAI,oBAAoB;IAIvC;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAM7B;;OAEG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKhD;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,UAAU,EAAE,OAAO,GAAG,YAAY;IA2C7D;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAS5B;;OAEG;IACH,gBAAgB,IAAI,MAAM,GAAG,IAAI;CAIlC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc,CAEpE;AAED,eAAe,cAAc,CAAC"}

package/dist/providers/google-provider.js

@@ -0,0 +1,274 @@
+/**
+ * Google Provider (Gemini ADK)
+ * Wrapper around Google's Agent Development Kit for multi-provider orchestration.
+ * Supports multi-agent workflows and large context windows.
+ *
+ * Copyright (c) 2025 Dobeu Tech Solutions LLC
+ * Licensed under CC BY-NC 4.0
+ */
+import { BaseProvider, } from './base-provider.js';
+import { PROVIDER_CONFIGS, } from '../config/provider-config.js';
+/* eslint-enable @typescript-eslint/no-explicit-any */
+/**
+ * Google Provider Implementation
+ * Wraps the Google ADK for use in multi-provider orchestration
+ */
+export class GoogleProvider extends BaseProvider {
+    name = 'google';
+    displayName = 'Gemini (Google ADK)';
+    packageName = '@google/adk';
+    config = PROVIDER_CONFIGS.google;
+    apiKey = null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    agent = null;
+    LlmAgentClass = null;
+    FunctionToolClass = null;
+    constructor(apiKey) {
+        super();
+        this.apiKey = apiKey ?? process.env.GOOGLE_API_KEY ?? null;
+        this.status.authenticated = !!this.apiKey;
+        this.status.available = false; // Will be set after SDK initialization
+    }
+    /**
+     * Initialize the Google ADK client
+     */
+    async initializeClient() {
+        if (this.LlmAgentClass)
+            return true;
+        try {
+            // Dynamic import of Google ADK (optional dependency)
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            let ADKModule;
+            try {
+                ADKModule = await import('@google/adk');
+            }
+            catch {
+                console.error('Google ADK not found. Install with: npm install @google/adk');
+                this.status.available = false;
+                return false;
+            }
+            this.LlmAgentClass = ADKModule.LlmAgent;
+            this.FunctionToolClass = ADKModule.FunctionTool;
+            if (!this.LlmAgentClass) {
+                console.error('Google ADK not found. Install with: npm install @google/adk');
+                return false;
+            }
+            // Set API key in environment for ADK
+            if (this.apiKey) {
+                process.env.GOOGLE_API_KEY = this.apiKey;
+            }
+            this.status.available = true;
+            return true;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn(`Could not initialize Google ADK: ${message}`);
+            console.warn('Install with: npm install @google/adk');
+            this.status.available = false;
+            return false;
+        }
+    }
+    /**
+     * Create an agent instance with the given configuration
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    createAgent(model) {
+        if (!this.LlmAgentClass)
+            return null;
+        const selectedModel = model ?? this.config.defaultModel;
+        return new this.LlmAgentClass({
+            name: 'monty_gemini_agent',
+            model: selectedModel,
+            description: 'Full-stack development assistant powered by Gemini',
+            instruction: `You are a helpful full-stack development assistant.
+You help with coding tasks, research, documentation, and architectural decisions.
+Always provide clear, accurate, and well-structured responses.`,
+        });
+    }
+    /**
+     * Execute a query using the Google ADK
+     */
+    async *query(prompt, options) {
+        const startTime = Date.now();
+        try {
+            // Initialize client if needed
+            if (!await this.initializeClient()) {
+                yield {
+                    type: 'error',
+                    content: [{
+                            type: 'text',
+                            text: 'Google ADK not available. Install with: npm install @google/adk',
+                        }],
+                    metadata: {
+                        provider: this.name,
+                        latency_ms: Date.now() - startTime,
+                    },
+                };
+                return;
+            }
+            // Create agent for this query
+            this.agent = this.createAgent(options.model);
+            if (!this.agent) {
+                throw new Error('Failed to create Gemini agent');
+            }
+            // Execute query
+            const result = await this.agent.run(prompt);
+            // Normalize and yield result
+            const message = this.normalizeMessage(result);
+            message.metadata = {
+                ...message.metadata,
+                provider: this.name,
+                model: options.model ?? this.config.defaultModel,
+                latency_ms: Date.now() - startTime,
+            };
+            yield message;
+            // Yield final result message
+            yield {
+                type: 'result',
+                subtype: 'success',
+                content: [],
+                metadata: {
+                    provider: this.name,
+                    latency_ms: Date.now() - startTime,
+                },
+            };
+            this.updateStatus(true);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.updateStatus(false, errorMessage);
+            yield {
+                type: 'error',
+                content: [{
+                        type: 'text',
+                        text: `Google provider error: ${errorMessage}`,
+                    }],
+                metadata: {
+                    provider: this.name,
+                    latency_ms: Date.now() - startTime,
+                },
+            };
+        }
+    }
+    /**
+     * Validate Google API credentials
+     */
+    async validateCredentials() {
+        const key = this.apiKey ?? process.env.GOOGLE_API_KEY;
+        if (!key) {
+            this.status.authenticated = false;
+            return false;
+        }
+        try {
+            // Make a minimal API request to validate the key
+            const response = await fetch(`https://generativelanguage.googleapis.com/v1beta/models?key=${key}`, { method: 'GET' });
+            const isValid = response.status === 200;
+            this.status.authenticated = isValid;
+            return isValid;
+        }
+        catch (error) {
+            console.warn('Could not validate Google API key online');
+            return true;
+        }
+    }
+    /**
+     * List available Gemini models
+     */
+    async listModels() {
+        return this.config.models.map(model => ({
+            id: model.id,
+            name: model.name,
+            contextWindow: model.contextWindow,
+            costPerMToken: model.costPerMToken,
+            capabilities: model.capabilities,
+        }));
+    }
+    /**
+     * Get Google provider capabilities
+     */
+    getCapabilities() {
+        return { ...this.config.capabilities };
+    }
+    /**
+     * Get list of supported standard tools
+     */
+    getSupportedTools() {
+        return Object.entries(this.config.toolMapping)
+            .filter(([_, mapped]) => mapped !== null)
+            .map(([standard]) => standard);
+    }
+    /**
+     * Map standard tool name to Google tool name
+     */
+    mapToolName(standardTool) {
+        const mapped = this.config.toolMapping[standardTool];
+        return mapped ?? null;
+    }
+    /**
+     * Normalize ADK result to standard format
+     */
+    normalizeMessage(rawMessage) {
+        const result = rawMessage;
+        const content = [];
+        // Add main content
+        if (result.content) {
+            content.push({
+                type: 'text',
+                text: result.content,
+            });
+        }
+        // Add tool calls if present
+        if (result.tool_calls) {
+            for (const toolCall of result.tool_calls) {
+                content.push({
+                    type: 'tool_use',
+                    id: `tool_${Date.now()}_${Math.random().toString(36).slice(2)}`,
+                    name: toolCall.name,
+                    input: toolCall.arguments,
+                });
+                if (toolCall.result) {
+                    content.push({
+                        type: 'tool_result',
+                        tool_use_id: `tool_${Date.now()}`,
+                        content: toolCall.result,
+                    });
+                }
+            }
+        }
+        return {
+            type: 'assistant',
+            content,
+            metadata: {
+                provider: this.name,
+                usage: result.usage,
+            },
+        };
+    }
+    /**
+     * Set API key at runtime
+     */
+    setApiKey(key) {
+        this.apiKey = key;
+        this.status.authenticated = true;
+        // Update environment for ADK
+        process.env.GOOGLE_API_KEY = key;
+        // Reset agent to use new key
+        this.agent = null;
+    }
+    /**
+     * Get the current API key (masked for display)
+     */
+    getApiKeyPreview() {
+        if (!this.apiKey)
+            return null;
+        return `${this.apiKey.slice(0, 8)}...${this.apiKey.slice(-4)}`;
+    }
+}
+/**
+ * Create a new Google provider instance
+ */
+export function createGoogleProvider(apiKey) {
+    return new GoogleProvider(apiKey);
+}
+export default GoogleProvider;
+//# sourceMappingURL=google-provider.js.map