monty-autonomous-fullstack-dev-multillm 1.0.0

package/dist/providers/openai-provider.js

@@ -0,0 +1,295 @@
+/**
+ * OpenAI Provider (Codex SDK)
+ * Wrapper around OpenAI's Codex SDK for multi-provider orchestration.
+ * Supports thread-based conversations and code execution.
+ *
+ * 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 */
+/**
+ * OpenAI Provider Implementation
+ * Wraps the Codex SDK for use in multi-provider orchestration
+ */
+export class OpenAIProvider extends BaseProvider {
+    name = 'openai';
+    displayName = 'Codex (OpenAI)';
+    packageName = '@openai/codex-sdk';
+    config = PROVIDER_CONFIGS.openai;
+    apiKey = null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    codexClient = null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    currentThread = null;
+    currentThreadId = null;
+    constructor(apiKey) {
+        super();
+        this.apiKey = apiKey ?? process.env.OPENAI_API_KEY ?? null;
+        this.status.authenticated = !!this.apiKey;
+        this.status.available = false; // Will be set after SDK initialization
+    }
+    /**
+     * Initialize the Codex SDK client
+     */
+    async initializeClient() {
+        if (this.codexClient)
+            return true;
+        try {
+            // Dynamic import of Codex SDK (optional dependency)
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            let CodexModule;
+            try {
+                CodexModule = await import('@openai/codex-sdk');
+            }
+            catch {
+                console.error('Codex SDK not found. Install with: npm install @openai/codex-sdk');
+                this.status.available = false;
+                return false;
+            }
+            const Codex = CodexModule.default || CodexModule.Codex;
+            if (!Codex) {
+                console.error('Codex SDK not found. Install with: npm install @openai/codex-sdk');
+                return false;
+            }
+            this.codexClient = new Codex({
+                apiKey: this.apiKey,
+            });
+            this.status.available = true;
+            return true;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn(`Could not initialize Codex SDK: ${message}`);
+            console.warn('Install with: npm install @openai/codex-sdk');
+            this.status.available = false;
+            return false;
+        }
+    }
+    /**
+     * Execute a query using the Codex SDK
+     */
+    async *query(prompt, options) {
+        const startTime = Date.now();
+        try {
+            // Initialize client if needed
+            if (!await this.initializeClient()) {
+                yield {
+                    type: 'error',
+                    content: [{
+                            type: 'text',
+                            text: 'Codex SDK not available. Install with: npm install @openai/codex-sdk',
+                        }],
+                    metadata: {
+                        provider: this.name,
+                        latency_ms: Date.now() - startTime,
+                    },
+                };
+                return;
+            }
+            // Start or resume thread
+            if (!this.currentThread) {
+                this.currentThread = this.codexClient.startThread();
+                this.currentThreadId = this.currentThread.id;
+            }
+            // Execute query
+            const result = await this.currentThread.run(prompt);
+            // Normalize and yield result
+            const message = this.normalizeMessage(result);
+            message.metadata = {
+                ...message.metadata,
+                provider: this.name,
+                thread_id: this.currentThreadId ?? undefined,
+                latency_ms: Date.now() - startTime,
+            };
+            yield message;
+            // Yield final result message
+            yield {
+                type: 'result',
+                subtype: 'success',
+                content: [],
+                metadata: {
+                    provider: this.name,
+                    thread_id: this.currentThreadId ?? undefined,
+                    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: `OpenAI provider error: ${errorMessage}`,
+                    }],
+                metadata: {
+                    provider: this.name,
+                    latency_ms: Date.now() - startTime,
+                },
+            };
+        }
+    }
+    /**
+     * Validate OpenAI API credentials
+     */
+    async validateCredentials() {
+        const key = this.apiKey ?? process.env.OPENAI_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://api.openai.com/v1/models', {
+                method: 'GET',
+                headers: {
+                    'Authorization': `Bearer ${key}`,
+                },
+            });
+            const isValid = response.status === 200;
+            this.status.authenticated = isValid;
+            return isValid;
+        }
+        catch (error) {
+            console.warn('Could not validate OpenAI key online');
+            return true;
+        }
+    }
+    /**
+     * List available OpenAI 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 OpenAI 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 OpenAI tool name
+     */
+    mapToolName(standardTool) {
+        const mapped = this.config.toolMapping[standardTool];
+        return mapped ?? null;
+    }
+    /**
+     * Resume a previous thread
+     */
+    async resumeThread(threadId) {
+        if (!await this.initializeClient()) {
+            return false;
+        }
+        try {
+            this.currentThread = this.codexClient.resumeThread(threadId);
+            this.currentThreadId = threadId;
+            return true;
+        }
+        catch (error) {
+            console.error('Failed to resume thread:', error);
+            return false;
+        }
+    }
+    /**
+     * Get current thread ID
+     */
+    getCurrentThreadId() {
+        return this.currentThreadId;
+    }
+    /**
+     * Clear current thread (start fresh on next query)
+     */
+    clearThread() {
+        this.currentThread = null;
+        this.currentThreadId = null;
+    }
+    /**
+     * Normalize Codex 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 ? {
+                    input_tokens: result.usage.prompt_tokens,
+                    output_tokens: result.usage.completion_tokens,
+                } : undefined,
+            },
+        };
+    }
+    /**
+     * Set API key at runtime
+     */
+    setApiKey(key) {
+        this.apiKey = key;
+        this.status.authenticated = true;
+        // Reset client to use new key
+        this.codexClient = null;
+        this.currentThread = null;
+        this.currentThreadId = 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 OpenAI provider instance
+ */
+export function createOpenAIProvider(apiKey) {
+    return new OpenAIProvider(apiKey);
+}
+export default OpenAIProvider;
+//# sourceMappingURL=openai-provider.js.map

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

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

package/dist/templates/feature_list.template.json

@@ -0,0 +1,66 @@
+{
+  "project": {
+    "name": "",
+    "description": "",
+    "created_at": "",
+    "stack": "fullstack-web"
+  },
+  "features": [
+    {
+      "id": "feat-001",
+      "category": "functional",
+      "priority": 1,
+      "description": "Example: New chat button creates a fresh conversation",
+      "steps": [
+        "Navigate to main interface",
+        "Click the 'New Chat' button",
+        "Verify a new conversation is created",
+        "Check that chat area shows welcome state",
+        "Verify conversation appears in sidebar"
+      ],
+      "passes": false,
+      "last_tested": null,
+      "tested_by": null,
+      "notes": ""
+    },
+    {
+      "id": "feat-002",
+      "category": "ui",
+      "priority": 2,
+      "description": "Example: Page is responsive on mobile viewport",
+      "steps": [
+        "Set viewport to 375x667 (iPhone SE)",
+        "Navigate to main page",
+        "Verify all elements are visible",
+        "Verify no horizontal scroll",
+        "Verify touch targets are adequate size"
+      ],
+      "passes": false,
+      "last_tested": null,
+      "tested_by": null,
+      "notes": ""
+    },
+    {
+      "id": "feat-003",
+      "category": "integration",
+      "priority": 3,
+      "description": "Example: API returns valid response for GET request",
+      "steps": [
+        "Start the development server",
+        "Send GET request to /api/health",
+        "Verify response status is 200",
+        "Verify response contains expected fields",
+        "Verify response time is under 500ms"
+      ],
+      "passes": false,
+      "last_tested": null,
+      "tested_by": null,
+      "notes": ""
+    }
+  ],
+  "metadata": {
+    "total_features": 3,
+    "passing_features": 0,
+    "last_updated": ""
+  }
+}

package/dist/templates/progress.template.txt

@@ -0,0 +1,51 @@
+================================================================================
+PROJECT: [Project Name]
+CREATED: [Date]
+LAST SESSION: [Date/Time]
+================================================================================
+
+## PROJECT OVERVIEW
+[Brief description of the project and its goals. This section should provide
+enough context for any agent to understand what is being built and why.]
+
+## CURRENT STATE
+- Total Features: X
+- Completed: Y
+- Remaining: Z
+- Last Feature Worked On: [feature-id]
+
+## SESSION LOG
+### [Date/Time]
+- Agent: [initializer/coding]
+- Actions taken:
+  * [Action 1]
+  * [Action 2]
+  * [Action 3]
+- Features completed: [feat-001, feat-002]
+- Issues encountered: [list any problems]
+- Next steps:
+  * [Recommended action 1]
+  * [Recommended action 2]
+
+## KNOWN ISSUES
+- [Issue 1: Description and any workarounds]
+- [Issue 2: Description and any workarounds]
+
+## NOTES FOR NEXT SESSION
+- [Important context that the next agent should know]
+- [Pending decisions that need to be made]
+- [Dependencies or blockers to be aware of]
+
+## ENVIRONMENT SETUP
+- Dev server command: npm run dev
+- Test command: npm test
+- Build command: npm run build
+- Default URL: http://localhost:3000
+
+## DEPENDENCIES
+- [List key dependencies and versions]
+- [Note any special configuration required]
+
+================================================================================
+END OF PROGRESS FILE
+================================================================================

package/dist/utils/auth-manager.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Authentication Manager
+ * Handles user authentication, credential storage, and subscription validation.
+ *
+ * Copyright (c) 2025 Dobeu Tech Solutions LLC
+ * Licensed under CC BY-NC 4.0
+ */
+import { type UserCredentials, type AuthMethod, type SubscriptionTier } from '../config/auth-config.js';
+/**
+ * AuthManager - Singleton for managing authentication state
+ */
+export declare class AuthManager {
+    private static instance;
+    private session;
+    private constructor();
+    /**
+     * Get the singleton instance
+     */
+    static getInstance(): AuthManager;
+    /**
+     * Ensure the config directory exists
+     */
+    private ensureConfigDir;
+    /**
+     * Load credentials from file
+     */
+    loadCredentials(): UserCredentials | null;
+    /**
+     * Save credentials to file
+     */
+    saveCredentials(credentials: UserCredentials): void;
+    /**
+     * Clear stored credentials (logout)
+     */
+    clearCredentials(): void;
+    /**
+     * Check if user is authenticated (from file or environment)
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Get the API key synchronously (without token refresh)
+     * Used for display and environment setting where refresh isn't needed
+     */
+    getApiKeySync(): string | null;
+    /**
+     * Get the API key to use (from stored credentials or environment)
+     * Automatically attempts to refresh expired tokens
+     */
+    getApiKey(): Promise<string | null>;
+    /**
+     * Get current auth method
+     */
+    getAuthMethod(): AuthMethod | null;
+    /**
+     * Get user info for display
+     */
+    getUserInfo(): {
+        authenticated: boolean;
+        method: AuthMethod | null;
+        email: string | null;
+        tier: SubscriptionTier | null;
+        keyPreview: string | null;
+    };
+    /**
+     * Attempt to auto-detect Claude Code subscription credentials
+     * Checks paths defined in authConfig.claudeCodePaths
+     */
+    autoDetectClaudeCode(): Promise<boolean>;
+    /**
+     * Interactive login flow
+     * Supports:
+     * 1. Auto-detection of Claude Code subscription credentials
+     * 2. OAuth login via claude.ai (for Pro/Max/Team/Enterprise subscribers)
+     * 3. Manual Anthropic API key entry
+     */
+    login(options?: {
+        method?: AuthMethod;
+        key?: string;
+        email?: string;
+    }): Promise<boolean>;
+    /**
+     * Validate an API key by making a test request
+     */
+    validateKey(key: string): Promise<boolean>;
+    /**
+     * Logout - clear credentials
+     */
+    logout(): void;
+    /**
+     * Display current auth status (whoami)
+     */
+    whoami(): void;
+    /**
+     * Set environment variable for child processes
+     */
+    setEnvForChildProcess(): void;
+    /**
+     * Check authentication and return status for CLI
+     */
+    checkAuth(): {
+        authenticated: boolean;
+        message: string;
+    };
+}
+export declare const authManager: AuthManager;
+export declare function isAuthenticated(): boolean;
+export declare function getApiKey(): string | null;
+export declare function login(options?: {
+    method?: AuthMethod;
+    key?: string;
+    email?: string;
+}): Promise<boolean>;
+export declare function logout(): void;
+export declare function whoami(): void;
+export declare function checkAuth(): {
+    authenticated: boolean;
+    message: string;
+};
+export declare function setEnvForChildProcess(): void;
+export default authManager;
+//# sourceMappingURL=auth-manager.d.ts.map

package/dist/utils/auth-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-manager.d.ts","sourceRoot":"","sources":["../../src/utils/auth-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAGL,KAAK,eAAe,EAEpB,KAAK,UAAU,EACf,KAAK,gBAAgB,EAEtB,MAAM,0BAA0B,CAAC;AAIlC;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;IACrC,OAAO,CAAC,OAAO,CAAc;IAE7B,OAAO;IAQP;;OAEG;WACW,WAAW,IAAI,WAAW;IAOxC;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACI,eAAe,IAAI,eAAe,GAAG,IAAI;IAYhD;;OAEG;IACI,eAAe,CAAC,WAAW,EAAE,eAAe,GAAG,IAAI;IAyB1D;;OAEG;IACI,gBAAgB,IAAI,IAAI;IAkB/B;;OAEG;IACI,eAAe,IAAI,OAAO;IAqBjC;;;OAGG;IACI,aAAa,IAAI,MAAM,GAAG,IAAI;IAmBrC;;;OAGG;IACU,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAyChD;;OAEG;IACI,aAAa,IAAI,UAAU,GAAG,IAAI;IAYzC;;OAEG;IACI,WAAW,IAAI;QACpB,aAAa,EAAE,OAAO,CAAC;QACvB,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;QAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B;IAaD;;;OAGG;IACU,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC;IA8CrD;;;;;;OAMG;IACU,KAAK,CAAC,OAAO,CAAC,EAAE;QAC3B,MAAM,CAAC,EAAE,UAAU,CAAC;QACpB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,OAAO,CAAC;IA+KpB;;OAEG;IACU,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA0BvD;;OAEG;IACI,MAAM,IAAI,IAAI;IAYrB;;OAEG;IACI,MAAM,IAAI,IAAI;IA4CrB;;OAEG;IACI,qBAAqB,IAAI,IAAI;IAkBpC;;OAEG;IACI,SAAS,IAAI;QAClB,aAAa,EAAE,OAAO,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;KACjB;CAaF;AAGD,eAAO,MAAM,WAAW,aAA4B,CAAC;AAGrD,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,KAAK,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,UAAU,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAEvG;AAED,wBAAgB,MAAM,IAAI,IAAI,CAE7B;AAED,wBAAgB,MAAM,IAAI,IAAI,CAE7B;AAED,wBAAgB,SAAS,IAAI;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAEvE;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,eAAe,WAAW,CAAC"}