monty-autonomous-fullstack-dev-multillm 1.0.0

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

@@ -0,0 +1,219 @@
+/**
+ * Base Provider Interface
+ * Abstract class defining the contract for all AI provider implementations.
+ * Enables multi-provider orchestration with consistent API.
+ *
+ * Copyright (c) 2025 Dobeu Tech Solutions LLC
+ * Licensed under CC BY-NC 4.0
+ */
+import type { ProviderName } from '../config/provider-config.js';
+/**
+ * Content block types for normalized messages
+ */
+export interface TextContentBlock {
+    type: 'text';
+    text: string;
+}
+export interface ToolUseContentBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface ToolResultContentBlock {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string;
+    is_error?: boolean;
+}
+export type ContentBlock = TextContentBlock | ToolUseContentBlock | ToolResultContentBlock;
+/**
+ * Normalized message format across all providers
+ */
+export interface AgentMessage {
+    type: 'assistant' | 'tool_use' | 'tool_result' | 'result' | 'error';
+    subtype?: 'success' | 'error' | 'interrupted' | 'error_during_execution';
+    content: ContentBlock[];
+    metadata?: {
+        provider: ProviderName;
+        model?: string;
+        usage?: {
+            input_tokens: number;
+            output_tokens: number;
+        };
+        latency_ms?: number;
+        thread_id?: string;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Query options for provider execution
+ */
+export interface QueryOptions {
+    /** Allowed tools for this query */
+    tools?: string[];
+    /** Permission mode for file operations */
+    permissionMode?: 'acceptEdits' | 'plan' | 'bypassPermissions' | 'default';
+    /** Timeout in milliseconds */
+    timeout_ms?: number;
+    /** Specific model to use (overrides provider default) */
+    model?: string;
+    /** Environment variables to pass to subprocess */
+    env?: Record<string, string | undefined>;
+    /** Maximum turns/iterations */
+    maxTurns?: number;
+    /** Additional provider-specific options */
+    providerOptions?: Record<string, unknown>;
+}
+/**
+ * Provider capabilities declaration
+ */
+export interface ProviderCapabilities {
+    /** Supports streaming responses */
+    streaming: boolean;
+    /** Supports resumable threads/conversations */
+    threads: boolean;
+    /** Supports browser automation tools */
+    browserAutomation: boolean;
+    /** Supports sandboxed code execution */
+    codeExecution: boolean;
+    /** Supports spawning sub-agents */
+    multiAgent: boolean;
+    /** Supports function/tool calling */
+    toolCalling: boolean;
+    /** Supports vision/image input */
+    vision: boolean;
+}
+/**
+ * Provider status for health checks
+ */
+export interface ProviderStatus {
+    available: boolean;
+    authenticated: boolean;
+    rateLimited: boolean;
+    lastError?: string;
+    lastSuccessfulQuery?: Date;
+}
+/**
+ * Model information
+ */
+export interface ModelInfo {
+    id: string;
+    name: string;
+    contextWindow: number;
+    costPerMToken: {
+        input: number;
+        output: number;
+    };
+    capabilities: string[];
+}
+/**
+ * Abstract base class for AI providers
+ * All provider implementations must extend this class
+ */
+export declare abstract class BaseProvider {
+    /** Unique provider identifier */
+    abstract readonly name: ProviderName;
+    /** Human-readable display name */
+    abstract readonly displayName: string;
+    /** NPM package name (null for REST-only providers) */
+    abstract readonly packageName: string | null;
+    /** Provider status */
+    protected status: ProviderStatus;
+    /**
+     * Execute a query against this provider
+     * Returns an async generator yielding normalized messages
+     */
+    abstract query(prompt: string, options: QueryOptions): AsyncGenerator<AgentMessage, void, unknown>;
+    /**
+     * Validate that credentials are configured and valid
+     */
+    abstract validateCredentials(): Promise<boolean>;
+    /**
+     * List available models for this provider
+     */
+    abstract listModels(): Promise<ModelInfo[]>;
+    /**
+     * Get provider capabilities
+     */
+    abstract getCapabilities(): ProviderCapabilities;
+    /**
+     * Get list of supported tool names (in standard format)
+     */
+    abstract getSupportedTools(): string[];
+    /**
+     * Map a standard tool name to provider-specific name
+     * Returns null if tool is not supported
+     */
+    abstract mapToolName(standardTool: string): string | null;
+    /**
+     * Get current provider status
+     */
+    getStatus(): ProviderStatus;
+    /**
+     * Check if provider supports threads (resumable conversations)
+     */
+    supportsThreads(): boolean;
+    /**
+     * Check if provider supports browser automation
+     */
+    supportsBrowserAutomation(): boolean;
+    /**
+     * Check if provider supports sandboxed code execution
+     */
+    supportsCodeExecution(): boolean;
+    /**
+     * Check if provider supports multi-agent workflows
+     */
+    supportsMultiAgent(): boolean;
+    /**
+     * Resume a previous thread/conversation (if supported)
+     * Override in providers that support threads
+     */
+    resumeThread(_threadId: string): Promise<boolean>;
+    /**
+     * Get the current thread ID (if in a threaded conversation)
+     * Override in providers that support threads
+     */
+    getCurrentThreadId(): string | null;
+    /**
+     * Normalize provider-specific message to standard format
+     * Subclasses should implement this based on their response format
+     */
+    protected abstract normalizeMessage(rawMessage: unknown): AgentMessage;
+    /**
+     * Filter tools based on provider capabilities
+     * Returns only tools that this provider supports
+     */
+    filterSupportedTools(requestedTools: string[]): string[];
+    /**
+     * Map multiple standard tool names to provider-specific names
+     */
+    mapToolNames(standardTools: string[]): string[];
+    /**
+     * Calculate cost for a query based on token usage
+     */
+    calculateCost(inputTokens: number, outputTokens: number): Promise<number>;
+    /**
+     * Update provider status after a query
+     */
+    protected updateStatus(success: boolean, error?: string): void;
+}
+/**
+ * Type guard for checking if an object is a valid AgentMessage
+ */
+export declare function isAgentMessage(obj: unknown): obj is AgentMessage;
+/**
+ * Type guard for text content block
+ */
+export declare function isTextContentBlock(block: ContentBlock): block is TextContentBlock;
+/**
+ * Type guard for tool use content block
+ */
+export declare function isToolUseContentBlock(block: ContentBlock): block is ToolUseContentBlock;
+/**
+ * Type guard for tool result content block
+ */
+export declare function isToolResultContentBlock(block: ContentBlock): block is ToolResultContentBlock;
+export default BaseProvider;
+//# sourceMappingURL=base-provider.d.ts.map

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

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

package/dist/providers/base-provider.js

@@ -0,0 +1,143 @@
+/**
+ * Base Provider Interface
+ * Abstract class defining the contract for all AI provider implementations.
+ * Enables multi-provider orchestration with consistent API.
+ *
+ * Copyright (c) 2025 Dobeu Tech Solutions LLC
+ * Licensed under CC BY-NC 4.0
+ */
+/**
+ * Abstract base class for AI providers
+ * All provider implementations must extend this class
+ */
+export class BaseProvider {
+    /** Provider status */
+    status = {
+        available: false,
+        authenticated: false,
+        rateLimited: false,
+    };
+    /**
+     * Get current provider status
+     */
+    getStatus() {
+        return { ...this.status };
+    }
+    /**
+     * Check if provider supports threads (resumable conversations)
+     */
+    supportsThreads() {
+        return this.getCapabilities().threads;
+    }
+    /**
+     * Check if provider supports browser automation
+     */
+    supportsBrowserAutomation() {
+        return this.getCapabilities().browserAutomation;
+    }
+    /**
+     * Check if provider supports sandboxed code execution
+     */
+    supportsCodeExecution() {
+        return this.getCapabilities().codeExecution;
+    }
+    /**
+     * Check if provider supports multi-agent workflows
+     */
+    supportsMultiAgent() {
+        return this.getCapabilities().multiAgent;
+    }
+    /**
+     * Resume a previous thread/conversation (if supported)
+     * Override in providers that support threads
+     */
+    async resumeThread(_threadId) {
+        if (!this.supportsThreads()) {
+            throw new Error(`Provider ${this.name} does not support threads`);
+        }
+        return false;
+    }
+    /**
+     * Get the current thread ID (if in a threaded conversation)
+     * Override in providers that support threads
+     */
+    getCurrentThreadId() {
+        return null;
+    }
+    /**
+     * Filter tools based on provider capabilities
+     * Returns only tools that this provider supports
+     */
+    filterSupportedTools(requestedTools) {
+        const supported = this.getSupportedTools();
+        return requestedTools.filter(tool => supported.includes(tool));
+    }
+    /**
+     * Map multiple standard tool names to provider-specific names
+     */
+    mapToolNames(standardTools) {
+        return standardTools
+            .map(tool => this.mapToolName(tool))
+            .filter((tool) => tool !== null);
+    }
+    /**
+     * Calculate cost for a query based on token usage
+     */
+    async calculateCost(inputTokens, outputTokens) {
+        const models = await this.listModels();
+        const defaultModel = models[0];
+        if (!defaultModel)
+            return 0;
+        const inputCost = (inputTokens / 1_000_000) * defaultModel.costPerMToken.input;
+        const outputCost = (outputTokens / 1_000_000) * defaultModel.costPerMToken.output;
+        return inputCost + outputCost;
+    }
+    /**
+     * Update provider status after a query
+     */
+    updateStatus(success, error) {
+        if (success) {
+            this.status.available = true;
+            this.status.lastSuccessfulQuery = new Date();
+            this.status.lastError = undefined;
+            this.status.rateLimited = false;
+        }
+        else {
+            this.status.lastError = error;
+            if (error?.includes('rate limit')) {
+                this.status.rateLimited = true;
+            }
+        }
+    }
+}
+/**
+ * Type guard for checking if an object is a valid AgentMessage
+ */
+export function isAgentMessage(obj) {
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    const msg = obj;
+    return (typeof msg.type === 'string' &&
+        ['assistant', 'tool_use', 'tool_result', 'result', 'error'].includes(msg.type) &&
+        Array.isArray(msg.content));
+}
+/**
+ * Type guard for text content block
+ */
+export function isTextContentBlock(block) {
+    return block.type === 'text';
+}
+/**
+ * Type guard for tool use content block
+ */
+export function isToolUseContentBlock(block) {
+    return block.type === 'tool_use';
+}
+/**
+ * Type guard for tool result content block
+ */
+export function isToolResultContentBlock(block) {
+    return block.type === 'tool_result';
+}
+export default BaseProvider;
+//# sourceMappingURL=base-provider.js.map

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

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

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

@@ -0,0 +1,82 @@
+/**
+ * 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, type AgentMessage, type QueryOptions, type ProviderCapabilities, type ModelInfo } from './base-provider.js';
+import { type ProviderName } from '../config/provider-config.js';
+/**
+ * Cursor Provider Implementation
+ * Wraps the Cursor Cloud Agents API for use in multi-provider orchestration
+ */
+export declare class CursorProvider extends BaseProvider {
+    readonly name: ProviderName;
+    readonly displayName = "Cursor Cloud Agents";
+    readonly packageName: null;
+    private config;
+    private apiKey;
+    private baseUrl;
+    private currentTaskId;
+    constructor(apiKey?: string);
+    /**
+     * Execute a query using the Cursor Cloud Agents API
+     */
+    query(prompt: string, options: QueryOptions): AsyncGenerator<AgentMessage, void, unknown>;
+    /**
+     * Poll for task completion
+     */
+    private pollForCompletion;
+    /**
+     * Validate Cursor API credentials
+     */
+    validateCredentials(): Promise<boolean>;
+    /**
+     * List available Cursor models
+     */
+    listModels(): Promise<ModelInfo[]>;
+    /**
+     * Get Cursor provider capabilities
+     */
+    getCapabilities(): ProviderCapabilities;
+    /**
+     * Get list of supported standard tools
+     */
+    getSupportedTools(): string[];
+    /**
+     * Map standard tool name to Cursor tool name
+     */
+    mapToolName(standardTool: string): string | null;
+    /**
+     * Get current task ID
+     */
+    getCurrentTaskId(): string | null;
+    /**
+     * Cancel current task (if running)
+     */
+    cancelCurrentTask(): Promise<boolean>;
+    /**
+     * Normalize Cursor response 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;
+    /**
+     * Set custom API endpoint (for self-hosted instances)
+     */
+    setBaseUrl(url: string): void;
+}
+/**
+ * Create a new Cursor provider instance
+ */
+export declare function createCursorProvider(apiKey?: string): CursorProvider;
+export default CursorProvider;
+//# sourceMappingURL=cursor-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-provider.d.ts","sourceRoot":"","sources":["../../src/providers/cursor-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;AAiCtC;;;GAGG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAY;IACvC,QAAQ,CAAC,WAAW,yBAAyB;IAC7C,QAAQ,CAAC,WAAW,OAAQ;IAE5B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,aAAa,CAAuB;gBAEhC,MAAM,CAAC,EAAE,MAAM;IAO3B;;OAEG;IACI,KAAK,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,GACpB,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC;IA+F9C;;OAEG;YACW,iBAAiB;IAgC/B;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IA2B7C;;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,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IAqB3C;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,UAAU,EAAE,OAAO,GAAG,YAAY;IAsE7D;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAM5B;;OAEG;IACH,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAKjC;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAG9B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc,CAEpE;AAED,eAAe,cAAc,CAAC"}