overai 1.4.10 → 1.4.13

package/README.md

@@ -46,6 +46,30 @@ While tools like **n8n** and **Zapier** are excellent for linear automation (e.g
 npm install overai
 ```
 
+## ✨ Auto-Coder CLI (Magic Project Generator)
+
+Want to build a project instantly? OverAI includes a powerful CLI that can scaffold entire projects (React, Node, Python, etc.) from a single prompt.
+
+**Usage:**
+
+```bash
+# 1. Set your API Key (OpenAI, Gemini, or Anthropic)
+export OPENAI_API_KEY=sk-... 
+# OR
+export GOOGLE_API_KEY=AIza...
+
+# 2. Run the magic command
+npx overai-create "A personal portfolio website with HTML/CSS"
+```
+
+**Options:**
+
+*   **Auto-Detection**: The CLI automatically picks the best model based on your environment variables.
+*   **Force Model**: You can specify a model manually:
+    ```bash
+    npx overai-create "A snake game in Python" --model google/gemini-2.0-flash-exp
+    ```
+
 ---
 
 ## ⚡ Quick Start: Gemini Example

package/dist/cli/create.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/create.js

@@ -0,0 +1,219 @@
+#!/usr/bin/env node
+"use strict";
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("../index");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const readline = __importStar(require("readline"));
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+// 1. Define Tools for the Agent
+const fileTools = [
+    {
+        name: "write_file",
+        description: "Write content to a file. Use this to create code files.",
+        parameters: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "File path (relative to current directory)" },
+                content: { type: "string", description: "Content to write to the file" }
+            },
+            required: ["path", "content"]
+        },
+        execute: async ({ path: filePath, content }) => {
+            try {
+                const fullPath = path.resolve(process.cwd(), filePath);
+                // Ensure directory exists
+                const dir = path.dirname(fullPath);
+                if (!fs.existsSync(dir)) {
+                    fs.mkdirSync(dir, { recursive: true });
+                }
+                fs.writeFileSync(fullPath, content);
+                return `✅ File created: ${filePath}`;
+            }
+            catch (error) {
+                return `❌ Error writing file: ${error.message}`;
+            }
+        }
+    },
+    {
+        name: "run_command",
+        description: "Run a shell command. Use this to install dependencies, run tests, etc.",
+        parameters: {
+            type: "object",
+            properties: {
+                command: { type: "string", description: "Shell command to execute" }
+            },
+            required: ["command"]
+        },
+        execute: async ({ command }) => {
+            try {
+                console.log(`💻 Executing: ${command}`);
+                const { stdout, stderr } = await execAsync(command);
+                return `STDOUT:\n${stdout}\n\nSTDERR:\n${stderr}`;
+            }
+            catch (error) {
+                return `❌ Command failed: ${error.message}`;
+            }
+        }
+    },
+    {
+        name: "read_file",
+        description: "Read a file's content.",
+        parameters: {
+            type: "object",
+            properties: {
+                path: { type: "string", description: "File path to read" }
+            },
+            required: ["path"]
+        },
+        execute: async ({ path: filePath }) => {
+            try {
+                const content = fs.readFileSync(path.resolve(process.cwd(), filePath), 'utf-8');
+                return content;
+            }
+            catch (error) {
+                return `❌ Error reading file: ${error.message}`;
+            }
+        }
+    }
+];
+const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+});
+async function main() {
+    // Model Selection Logic
+    let model = "gpt-4o";
+    const args = process.argv.slice(2);
+    const modelArgIndex = args.indexOf('--model');
+    // Handle --model flag
+    if (modelArgIndex !== -1 && args[modelArgIndex + 1]) {
+        model = args[modelArgIndex + 1];
+        args.splice(modelArgIndex, 2); // Remove flag from args so it doesn't become part of the prompt
+    }
+    else {
+        // Auto-detect best available model based on env vars
+        if (process.env.OPENAI_API_KEY) {
+            model = "gpt-4o";
+        }
+        else if (process.env.GOOGLE_API_KEY) {
+            model = "google/gemini-2.0-flash-exp";
+        }
+        else if (process.env.ANTHROPIC_API_KEY) {
+            model = "anthropic/claude-3-5-sonnet-20240620";
+        }
+        else {
+            console.error("❌ Error: No API Key found.");
+            console.error("Please set ONE of the following environment variables:");
+            console.error("  export OPENAI_API_KEY=sk-...");
+            console.error("  export GOOGLE_API_KEY=AIza...");
+            console.error("  export ANTHROPIC_API_KEY=sk-ant-...");
+            process.exit(1);
+        }
+    }
+    console.log(`🧠 Using AI Model: \x1b[36m${model}\x1b[0m`);
+    // 2. Create the "AutoCoder" Agent
+    const coder = new index_1.Agent({
+        name: "AutoCoder",
+        instructions: `You are an Elite FullStack Software Architect and Engineer.
+    Your goal is to scaffold and build fully functional projects based on user requirements.
+    
+    CAPABILITIES:
+    - You can create files and directories (write_file).
+    - You can run system commands (run_command) like npm, pip, git, etc.
+    - You can read files to check content (read_file).
+
+    PROCESS:
+    1. ANALYZE: Understand the user's request and technology stack (Node, Python, React, etc.).
+    2. PLAN: Decide on the directory structure and necessary files.
+    3. SCAFFOLD: Create the project directory and initialize it (npm init, etc.).
+    4. IMPLEMENT: Create the core files (index.js, main.py, App.tsx, etc.) with working code.
+    5. DEPENDENCIES: Install necessary packages.
+    6. VERIFY: Run a command to prove the project works or builds successfully.
+    
+    RULES:
+    - ALWAYS start by creating a new directory for the project to avoid cluttering the root.
+    - Be comprehensive: Include README.md, .gitignore, and config files.
+    - If something fails, try to fix it or report the specific error.
+    - Do not ask for permission for each step, proceed autonomously until completion.`,
+        llm: model,
+        tools: fileTools
+    });
+    // 3. Get User Input
+    const question = (query) => {
+        return new Promise((resolve) => rl.question(query, resolve));
+    };
+    console.log("\n🚀 **OverAI Auto-Coder** initialized.");
+    console.log("I can build any project for you (Node.js, Python, simple websites, scripts...).");
+    // If argument provided via CLI, use it. Otherwise ask.
+    let userRequest = args.join(" ");
+    if (!userRequest.trim()) {
+        userRequest = await question("\n🛠️  What project should I build for you? (e.g., 'A weather CLI in Python', 'A React Todo app'): ");
+    }
+    else {
+        console.log(`\n🛠️  Request received: "${userRequest}"`);
+    }
+    rl.close();
+    if (!userRequest.trim()) {
+        console.log("❌ No request provided. Exiting.");
+        return;
+    }
+    const task = `
+    BUILD REQUEST: "${userRequest}"
+    
+    Execute this request from start to finish.
+    1. Create a suitable folder name based on the request.
+    2. Implement the full solution.
+    3. Verify it runs.
+  `;
+    // 4. Start OverAI
+    const overai = new index_1.OverAI({
+        agents: [coder],
+        tasks: [task],
+        verbose: true
+    });
+    console.log(`\n🤖 AutoCoder starting task...\n`);
+    try {
+        await overai.start();
+        console.log("\n✅ Mission Complete! Check the created folder.");
+    }
+    catch (error) {
+        console.error("❌ Mission Failed:", error);
+    }
+}
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "overai",
-  "version": "1.4.10",
+  "version": "1.4.13",
   "description": "OverAI TypeScript AI Agents Framework - Build, Deploy, and Monetize AI Agents in Minutes",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,7 +10,8 @@
     "LICENSE"
   ],
   "bin": {
-    "overai": "./dist/cli/index.js"
+    "overai": "./dist/cli/index.js",
+    "overai-create": "./dist/cli/create.js"
   },
   "scripts": {
     "build": "tsc",