genieceo 0.1.0

package/dist/workspace/manager.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkspaceManager = void 0;
+exports.getWorkspaceManager = getWorkspaceManager;
+const promises_1 = require("fs/promises");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+/**
+ * Workspace Manager
+ * Handles initialization and management of the workspace directory
+ */
+class WorkspaceManager {
+    constructor(workspacePath) {
+        this.workspacePath = workspacePath || (0, path_1.join)((0, os_1.homedir)(), '.genieceo', 'workspace');
+    }
+    /**
+     * Initialize workspace with directory structure
+     */
+    async init() {
+        try {
+            // Create main workspace directory
+            if (!(0, fs_1.existsSync)(this.workspacePath)) {
+                await (0, promises_1.mkdir)(this.workspacePath, { recursive: true });
+            }
+            // Create subdirectories
+            const subdirs = [
+                'skills',
+                'files',
+            ];
+            for (const subdir of subdirs) {
+                const path = (0, path_1.join)(this.workspacePath, subdir);
+                if (!(0, fs_1.existsSync)(path)) {
+                    await (0, promises_1.mkdir)(path, { recursive: true });
+                }
+            }
+            // Create AGENTS.md if it doesn't exist
+            const agentsPath = (0, path_1.join)(this.workspacePath, 'AGENTS.md');
+            if (!(0, fs_1.existsSync)(agentsPath)) {
+                await (0, promises_1.writeFile)(agentsPath, this.getDefaultAgentsContent());
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to initialize workspace: ${error instanceof Error ? error.message : error}`);
+        }
+    }
+    /**
+     * Get workspace root path
+     */
+    getWorkspacePath() {
+        return this.workspacePath;
+    }
+    /**
+     * Get custom skills directory path
+     */
+    getSkillsPath() {
+        return (0, path_1.join)(this.workspacePath, 'skills');
+    }
+    /**
+     * Get working files directory path
+     */
+    getFilesPath() {
+        return (0, path_1.join)(this.workspacePath, 'files');
+    }
+    /**
+     * Get AGENTS.md path
+     */
+    getAgentsFilePath() {
+        return (0, path_1.join)(this.workspacePath, 'AGENTS.md');
+    }
+    /**
+     * Check if workspace is initialized
+     */
+    async isInitialized() {
+        try {
+            await (0, promises_1.access)(this.workspacePath);
+            await (0, promises_1.access)((0, path_1.join)(this.workspacePath, 'skills'));
+            await (0, promises_1.access)((0, path_1.join)(this.workspacePath, 'files'));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get default AGENTS.md content
+     */
+    getDefaultAgentsContent() {
+        return `# genieceo Agent Configuration
+
+## Identity
+
+You are **genieceo**, an AI agent CLI assistant designed to help users with various tasks including:
+
+- Reading and writing files
+- Executing shell commands safely
+- Searching the web for information
+- Breaking down complex tasks using subagents
+- Learning new skills through the skill system
+
+## Guidelines
+
+1. **Be helpful and efficient**: Focus on solving the user's problem directly
+2. **Use tools wisely**: Choose the right tool for each task
+3. **Safety first**: Never execute dangerous commands without user confirmation
+4. **Learn and adapt**: Use skills to handle specialized tasks effectively
+5. **Delegate complex tasks**: Use subagents for independent work that can run in parallel
+
+## Workspace
+
+Your workspace is located at: ${this.workspacePath}
+
+- \`files/\` - Your working directory for file operations
+- \`skills/\` - Custom skills you can learn
+
+## Capabilities
+
+You have access to the following core tools:
+
+- **readFile**: Read file contents
+- **writeFile**: Create or overwrite files
+- **listDir**: List directory contents
+- **executeCommand**: Run shell commands (with safety checks)
+- **webSearch**: Search the web using multiple providers (Tavily, Brave, or browser fallback)
+- **spawnSubagent**: Create background agents for complex subtasks
+
+Remember: You're here to assist and make the user's work easier. Be proactive, thorough, and clear in your communication.
+`;
+    }
+}
+exports.WorkspaceManager = WorkspaceManager;
+// Singleton instance
+let workspaceManagerInstance = null;
+function getWorkspaceManager(workspacePath) {
+    if (!workspaceManagerInstance) {
+        workspaceManagerInstance = new WorkspaceManager(workspacePath);
+    }
+    return workspaceManagerInstance;
+}
+//# sourceMappingURL=manager.js.map

package/dist/workspace/manager.js.map

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

package/docs/ONBOARDING.md

@@ -0,0 +1,229 @@
+# Onboarding Guide
+
+The `genieceo onboard` command provides an interactive setup wizard to help you configure your AI agent.
+
+## Quick Start
+
+```bash
+genieceo onboard
+```
+
+This will guide you through setting up:
+1. **LLM Provider** - Select and configure your language model provider
+2. **Health Check** - Verify your LLM setup with a real API call
+3. **Web Search** - Configure web search capabilities
+
+## Step-by-Step Walkthrough
+
+### Step 1: LLM Configuration
+
+The wizard will help you:
+
+1. **Select a Provider**
+   - Choose from available providers (OpenAI, Anthropic, Google, etc.)
+   - Default: OpenAI
+   - Providers are automatically discovered via `@mariozechner/pi-ai`
+
+2. **Enter API Key**
+   - Provide your API key for the selected provider
+   - If a key already exists, you can press Enter to keep it
+   - Keys are stored securely in `~/.genieceo/config.json`
+
+3. **Select a Model**
+   - The wizard automatically fetches available models for your provider
+   - You can select by number or enter the model ID directly
+   - Example models:
+     - OpenAI: `gpt-4o`, `gpt-4-turbo`, `gpt-3.5-turbo`
+     - Anthropic: `claude-3-5-sonnet-20241022`, `claude-3-opus-20240229`
+
+### Step 2: Health Check
+
+The wizard performs a health check to ensure your LLM is configured correctly:
+
+1. **Configuration Validation**
+   - Checks that the provider exists
+   - Verifies API key format
+   - Validates model availability
+
+2. **Test API Call**
+   - Makes a simple API request to verify connectivity
+   - Shows the response and token usage
+   - If the test fails, you'll see a detailed error message
+
+Example output:
+```
+✓ Configuration validated
+✓ LLM health check passed
+  Response: Hello! I am working correctly.
+  Tokens used: 23
+```
+
+### Step 3: Web Search Configuration
+
+Configure web search capabilities:
+
+1. **Select Provider**
+   - `auto` (recommended) - Tries providers in order: Tavily → Brave → Browser
+   - `tavily` - Use Tavily Search API only
+   - `brave` - Use Brave Search API only
+   - `browser` - Use free browser-based search (no API key needed)
+
+2. **Configure API Keys**
+   - For `auto` mode: Optionally configure Tavily and/or Brave
+   - For specific providers: Enter the required API key
+   - Browser mode requires no API key
+
+#### Getting API Keys
+
+**Tavily (Recommended)**
+- Website: https://tavily.com
+- Free tier: 1,000 searches/month
+- Best for: AI agent applications with high-quality results
+
+**Brave Search**
+- Website: https://brave.com/search/api
+- Note: Now requires payment
+- Best for: Privacy-focused search
+
+**Browser Mode**
+- No API key needed
+- Uses DuckDuckGo HTML search
+- Good enough for most use cases
+
+## Configuration File
+
+The onboard command saves your configuration to `~/.genieceo/config.json`:
+
+```json
+{
+  "workspace": "~/.genieceo/workspace",
+  "model": "openai:gpt-4o",
+  "maxIterations": 15,
+  "llm": {
+    "openai": {
+      "apiKey": "sk-proj-..."
+    },
+    "anthropic": {
+      "apiKey": "sk-ant-..."
+    }
+  },
+  "tools": {
+    "webSearch": {
+      "provider": "auto",
+      "tavily": {
+        "apiKey": "tvly-..."
+      },
+      "brave": {
+        "apiKey": "BSA..."
+      }
+    },
+    "shell": {
+      "timeout": 30000,
+      "allowDangerous": false
+    }
+  }
+}
+```
+
+## Common Issues
+
+### Issue: "Failed to get model"
+
+**Solution:** Check that your API key is correct and has access to the selected model.
+
+### Issue: "LLM health check failed"
+
+**Possible causes:**
+- Invalid API key
+- Network connectivity issues
+- Insufficient API credits
+- Rate limiting
+
+**Solution:** Verify your API key and check your provider's dashboard for account status.
+
+### Issue: "Could not fetch models for this provider"
+
+**Solution:** You can manually enter the model ID. Check your provider's documentation for available models.
+
+### Issue: Web search not working
+
+**Solution:** 
+- For `auto` mode: Configure at least one API provider (Tavily or Brave)
+- For specific providers: Verify your API key is correct
+- For `browser` mode: Check your internet connection
+
+## Re-running Onboard
+
+You can run `genieceo onboard` multiple times to:
+- Switch providers
+- Update API keys
+- Change models
+- Reconfigure web search
+
+Existing configuration values will be shown, and you can press Enter to keep them.
+
+## Manual Configuration
+
+If you prefer to edit the configuration manually:
+
+```bash
+# Open the config file
+vim ~/.genieceo/config.json
+
+# Or use your preferred editor
+code ~/.genieceo/config.json
+```
+
+After manual edits, verify your configuration:
+
+```bash
+genieceo status
+```
+
+## Next Steps
+
+After completing onboarding:
+
+```bash
+# Start a chat
+genieceo chat
+
+# Send a single message
+genieceo chat -m "What is 2+2?"
+
+# Check status
+genieceo status
+```
+
+## Security Notes
+
+- API keys are stored in plain text in `~/.genieceo/config.json`
+- Ensure proper file permissions: `chmod 600 ~/.genieceo/config.json`
+- Never commit your config file to version control
+- Keep your API keys secure and rotate them regularly
+
+## Troubleshooting
+
+### Enable Debug Mode
+
+Set environment variable for detailed logging:
+
+```bash
+DEBUG=genieceo:* genieceo onboard
+```
+
+### Reset Configuration
+
+To start fresh:
+
+```bash
+rm -rf ~/.genieceo
+genieceo init
+genieceo onboard
+```
+
+## Support
+
+For issues or questions:
+- GitHub Issues: https://github.com/yourusername/genieceo/issues
+- Documentation: https://github.com/yourusername/genieceo#readme