@defai.digital/automatosx 12.8.7 → 13.1.2

package/examples/providers/codex/usage-examples.ts

@@ -1,421 +0,0 @@
-/**
- * Codex CLI CLI Integration - Usage Examples
- *
- * This file demonstrates various ways to use the Codex CLI integration
- * with AutomatosX, including basic execution, MCP server management, and
- * advanced patterns.
- *
- * @see docs/integrations/openai-codex.md for complete documentation
- */
-
-import {
-  CodexBridge,
-  CodexCLI,
-  CodexMCPManager,
-  CodexError,
-  CodexErrorType,
-  getDefaultBridge,
-  getDefaultCLI,
-  getDefaultMCPManager,
-} from '../../src/integrations/openai-codex/index.js';
-
-// ========================================
-// Example 1: Basic CLI Execution
-// ========================================
-
-async function example1_basicExecution() {
-  console.log('\n=== Example 1: Basic CLI Execution ===\n');
-
-  const cli = new CodexCLI({
-    command: 'codex',
-    sandboxMode: 'workspace-write',
-    timeout: 60000,
-  });
-
-  try {
-    // Check if codex CLI is available
-    const available = await cli.isAvailable();
-    if (!available) {
-      console.error('Codex CLI not found. Install with: npm i -g @openai/codex');
-      return;
-    }
-
-    // Get CLI version
-    const version = await cli.getVersion();
-    console.log(`Using Codex CLI version: ${version}`);
-
-    // Execute a simple prompt
-    const result = await cli.execute({
-      prompt: 'Explain the benefits of TypeScript in 3 sentences',
-      temperature: 0.7,
-      maxTokens: 200,
-    });
-
-    console.log('\nResponse:');
-    console.log(result.content);
-    console.log(`\nDuration: ${result.duration}ms`);
-    console.log(`Token count: ${result.tokenCount ?? 'N/A'}`);
-  } catch (error) {
-    if (error instanceof CodexError) {
-      console.error(`Codex error [${error.type}]:`, error.message);
-      if (error.context) {
-        console.error('Context:', error.context);
-      }
-    } else {
-      console.error('Unexpected error:', error);
-    }
-  } finally {
-    await cli.cleanup();
-  }
-}
-
-// ========================================
-// Example 2: Streaming Execution
-// ========================================
-
-async function example2_streamingExecution() {
-  console.log('\n=== Example 2: Streaming Execution ===\n');
-
-  const cli = new CodexCLI({
-    command: 'codex',
-    sandboxMode: 'workspace-write',
-  });
-
-  try {
-    const result = await cli.execute({
-      prompt: 'Write a short poem about programming',
-      streaming: true,
-      temperature: 0.9,
-    });
-
-    console.log('Streamed response:');
-    console.log(result.content);
-  } catch (error) {
-    console.error('Error:', error instanceof CodexError ? error.message : error);
-  } finally {
-    await cli.cleanup();
-  }
-}
-
-// ========================================
-// Example 3: MCP Server Management
-// ========================================
-
-async function example3_mcpServer() {
-  console.log('\n=== Example 3: MCP Server Management ===\n');
-
-  const mcpManager = new CodexMCPManager({
-    enabled: true,
-    command: 'codex',
-    transport: 'stdio',
-  });
-
-  try {
-    // Start MCP server
-    console.log('Starting MCP server...');
-    const startStatus = await mcpManager.startServer();
-    console.log(`MCP server started (PID: ${startStatus.pid})`);
-
-    // Check server status
-    const status = await mcpManager.getStatus();
-    console.log('\nServer Status:');
-    console.log(`  Running: ${status.running}`);
-    console.log(`  PID: ${status.pid}`);
-    console.log(`  Uptime: ${status.uptime ? `${status.uptime}ms` : 'N/A'}`);
-
-    // Health check
-    const healthy = await mcpManager.isHealthy();
-    console.log(`  Healthy: ${healthy}`);
-
-    // Wait a bit
-    await new Promise((resolve) => setTimeout(resolve, 2000));
-
-    // Stop server
-    console.log('\nStopping MCP server...');
-    await mcpManager.stopServer();
-    console.log('MCP server stopped');
-  } catch (error) {
-    if (error instanceof CodexError) {
-      console.error(`MCP error [${error.type}]:`, error.message);
-    } else {
-      console.error('Error:', error);
-    }
-  } finally {
-    await mcpManager.cleanup();
-  }
-}
-
-// ========================================
-// Example 4: Full Integration with Bridge
-// ========================================
-
-async function example4_fullIntegration() {
-  console.log('\n=== Example 4: Full Integration with Bridge ===\n');
-
-  const bridge = new CodexBridge(
-    {
-      command: 'codex',
-      sandboxMode: 'workspace-write',
-      timeout: 120000,
-      temperature: 0.7,
-    },
-    {
-      enabled: true,
-      command: 'codex',
-      transport: 'stdio',
-      autoStart: false, // Manual start for this example
-    }
-  );
-
-  try {
-    // Initialize bridge (checks CLI availability)
-    console.log('Initializing Codex bridge...');
-    const initStatus = await bridge.initialize();
-
-    console.log('\nIntegration Status:');
-    console.log(`  CLI Available: ${initStatus.cliAvailable}`);
-    console.log(`  CLI Version: ${initStatus.version}`);
-    console.log(`  Initialized: ${initStatus.initialized}`);
-
-    // Execute a prompt
-    console.log('\nExecuting prompt via bridge...');
-    const result = await bridge.execute({
-      prompt: 'What are the key principles of clean code?',
-      maxTokens: 300,
-    });
-
-    console.log('\nResponse:');
-    console.log(result.content.substring(0, 200) + '...');
-    console.log(`Duration: ${result.duration}ms`);
-
-    // Start MCP server if needed
-    console.log('\nStarting MCP server...');
-    await bridge.startMCPServer();
-
-    const mcpHealthy = await bridge.isMCPServerHealthy();
-    console.log(`MCP Server healthy: ${mcpHealthy}`);
-
-    // Execute another prompt (with MCP server running)
-    const result2 = await bridge.execute({
-      prompt: 'List 5 design patterns',
-      maxTokens: 200,
-    });
-
-    console.log('\nSecond response:');
-    console.log(result2.content);
-
-    // Stop MCP server
-    await bridge.stopMCPServer();
-    console.log('\nMCP server stopped');
-  } catch (error) {
-    if (error instanceof CodexError) {
-      console.error(`\nError [${error.type}]:`, error.message);
-    } else {
-      console.error('\nError:', error);
-    }
-  } finally {
-    await bridge.cleanup();
-  }
-}
-
-// ========================================
-// Example 5: Error Handling Patterns
-// ========================================
-
-async function example5_errorHandling() {
-  console.log('\n=== Example 5: Error Handling Patterns ===\n');
-
-  const cli = new CodexCLI({ command: 'codex' });
-
-  // Pattern 1: Type-specific error handling
-  try {
-    await cli.execute({ prompt: 'test' });
-  } catch (error) {
-    if (error instanceof CodexError) {
-      switch (error.type) {
-        case CodexErrorType.CLI_NOT_FOUND:
-          console.error('Install codex: npm i -g @openai/codex');
-          break;
-        case CodexErrorType.TIMEOUT:
-          console.error('Request timed out, try increasing timeout');
-          break;
-        case CodexErrorType.EXECUTION_FAILED:
-          console.error('Execution failed:', error.context);
-          break;
-        default:
-          console.error('Codex error:', error.message);
-      }
-    }
-  } finally {
-    await cli.cleanup();
-  }
-
-  // Pattern 2: Retry with backoff
-  async function executeWithRetry(prompt: string, maxRetries = 3) {
-    let attempt = 0;
-    while (attempt < maxRetries) {
-      try {
-        return await cli.execute({ prompt });
-      } catch (error) {
-        attempt++;
-        if (attempt >= maxRetries) throw error;
-
-        const delay = 1000 * Math.pow(2, attempt);
-        console.log(`Retry ${attempt}/${maxRetries} after ${delay}ms...`);
-        await new Promise((resolve) => setTimeout(resolve, delay));
-      }
-    }
-  }
-
-  try {
-    const result = await executeWithRetry('Generate a haiku');
-    console.log('Success after retries:', result.content);
-  } catch (error) {
-    console.error('All retries failed');
-  }
-}
-
-// ========================================
-// Example 6: Using Default Instances
-// ========================================
-
-async function example6_defaultInstances() {
-  console.log('\n=== Example 6: Using Default Instances ===\n');
-
-  // Get default CLI instance (shared across calls)
-  const cli = getDefaultCLI();
-
-  try {
-    const result = await cli.execute({
-      prompt: 'What is dependency injection?',
-      maxTokens: 150,
-    });
-
-    console.log('Response:', result.content);
-  } finally {
-    await cli.cleanup();
-  }
-
-  // Get default bridge instance
-  const bridge = getDefaultBridge(
-    { command: 'codex', sandboxMode: 'workspace-write' },
-    { enabled: false } // MCP disabled
-  );
-
-  try {
-    await bridge.initialize();
-    const result = await bridge.execute({
-      prompt: 'Explain SOLID principles in one sentence each',
-    });
-    console.log('\nSOLID principles:', result.content);
-  } finally {
-    await bridge.cleanup();
-  }
-}
-
-// ========================================
-// Example 7: Advanced Configuration
-// ========================================
-
-async function example7_advancedConfiguration() {
-  console.log('\n=== Example 7: Advanced Configuration ===\n');
-
-  // Different sandbox modes
-  const modes = ['workspace-write', 'full', 'none'] as const;
-
-  for (const mode of modes) {
-    const cli = new CodexCLI({
-      command: 'codex',
-      sandboxMode: mode,
-      timeout: 30000,
-    });
-
-    try {
-      console.log(`\nTesting sandbox mode: ${mode}`);
-      const result = await cli.execute({
-        prompt: 'Describe file system access in sandbox mode',
-        maxTokens: 100,
-      });
-      console.log(`Response: ${result.content.substring(0, 100)}...`);
-    } catch (error) {
-      console.error(`Error in ${mode} mode:`, error);
-    } finally {
-      await cli.cleanup();
-    }
-  }
-
-  // MCP with config overrides
-  const mcpManager = new CodexMCPManager({
-    enabled: true,
-    command: 'codex',
-    transport: 'stdio',
-    configOverrides: {
-      timeout: 60000,
-      retries: 3,
-    },
-  });
-
-  try {
-    console.log('\nStarting MCP with custom config...');
-    await mcpManager.startServer();
-    console.log('MCP server started with custom configuration');
-    await mcpManager.stopServer();
-  } catch (error) {
-    console.error('MCP error:', error);
-  } finally {
-    await mcpManager.cleanup();
-  }
-}
-
-// ========================================
-// Main Entry Point
-// ========================================
-
-async function main() {
-  console.log('Codex CLI Integration - Usage Examples');
-  console.log('==========================================\n');
-
-  const examples = [
-    { name: 'Basic Execution', fn: example1_basicExecution },
-    { name: 'Streaming Execution', fn: example2_streamingExecution },
-    { name: 'MCP Server Management', fn: example3_mcpServer },
-    { name: 'Full Integration', fn: example4_fullIntegration },
-    { name: 'Error Handling', fn: example5_errorHandling },
-    { name: 'Default Instances', fn: example6_defaultInstances },
-    { name: 'Advanced Configuration', fn: example7_advancedConfiguration },
-  ];
-
-  // Run examples (comment out ones you don't want to run)
-  for (const { name, fn } of examples) {
-    console.log(`\n${'='.repeat(60)}`);
-    console.log(`Running: ${name}`);
-    console.log('='.repeat(60));
-
-    try {
-      await fn();
-    } catch (error) {
-      console.error(`\nExample failed: ${error}`);
-    }
-
-    // Wait between examples
-    await new Promise((resolve) => setTimeout(resolve, 1000));
-  }
-
-  console.log('\n\nAll examples completed!');
-}
-
-// Run if executed directly
-if (import.meta.url === `file://${process.argv[1]}`) {
-  main().catch(console.error);
-}
-
-// Export examples for use in other files
-export {
-  example1_basicExecution,
-  example2_streamingExecution,
-  example3_mcpServer,
-  example4_fullIntegration,
-  example5_errorHandling,
-  example6_defaultInstances,
-  example7_advancedConfiguration,
-};

package/examples/providers/gemini/GEMINI_INTEGRATION.md

@@ -1,236 +0,0 @@
-# AutomatosX Integration for Gemini CLI
-
-**IMPORTANT**: For the complete AutomatosX integration guide, **please read [AX-Integration.md](../AX-Integration.md)**.
-
-This file provides Gemini CLI-specific tips and quick reference. For comprehensive documentation including all agents, commands, memory features, workflows, and troubleshooting, see [AX-Integration.md](../AX-Integration.md).
-
----
-
-## Quick Start for Gemini CLI Users
-
-### Natural Language Integration
-
-Gemini CLI can invoke AutomatosX agents using natural language:
-
-```
-"Please use the ax backend agent to implement user authentication"
-"Ask the ax security agent to audit this code for vulnerabilities"
-"Have the ax quality agent write tests for this feature"
-"Work with ax agent product to design this new feature"
-"Use ax agent devops to set up the deployment pipeline"
-```
-
-Gemini CLI will understand your intent and invoke the appropriate AutomatosX agent for you. Just describe what you need in natural language - no special commands required!
-
-### Essential Commands
-
-```bash
-# List all available agents
-ax list agents
-
-# Run an agent with a task
-ax run backend "create a REST API for user management"
-
-# Search memory for past conversations
-ax memory search "authentication"
-
-# View system status
-ax status
-```
-
----
-
-## Gemini CLI-Specific Tips
-
-### 1. Natural Language is Best
-
-Custom slash commands have been removed. Instead, talk naturally to Gemini CLI:
-
-**Natural Language Examples**:
-```
-"Use ax agent backend to create a REST API for authentication"
-"Ask ax agent frontend to build a responsive navbar"
-"Have ax agent security audit this code for vulnerabilities"
-"Work with ax agent quality to write unit tests"
-```
-
-### 2. Direct CLI Access
-
-For direct terminal usage:
-
-```bash
-# Run agents directly
-ax run backend "task"
-
-# Search memory
-ax memory search "keyword"
-
-# Check status
-ax status
-```
-
-### 3. Workspace Conventions
-
-AutomatosX uses specific directories:
-
-- **`automatosx/PRD/`** - Design specs and planning documents
-- **`automatosx/tmp/`** - Temporary files and scratch work
-
-**Usage in Gemini CLI** (natural language):
-```
-"Use ax product agent to save the design to automatosx/PRD/auth-design.md"
-"Have ax backend agent put the draft in automatosx/tmp/auth-draft.ts"
-```
-
-### 4. Provider Configuration
-
-Gemini is typically configured with high priority for Gemini CLI users:
-
-```json
-{
-  "providers": {
-    "gemini-cli": {
-      "enabled": true,
-      "priority": 1,
-      "command": "gemini"
-    }
-  }
-}
-```
-
-Edit `ax.config.json` to customize.
-
----
-
-## Available Agents
-
-Quick reference (for full list, see [AX-Integration.md](../AX-Integration.md)):
-
-- **backend** (Bob) - Backend development
-- **frontend** (Frank) - Frontend development
-- **fullstack** (Felix) - Full-stack development
-- **mobile** (Maya) - Mobile development
-- **devops** (Oliver) - DevOps and infrastructure
-- **security** (Steve) - Security auditing
-- **quality** (Queenie) - QA and testing
-- **architecture** (Avery) - System architecture
-- **data** (Daisy) - Data engineering
-- **design** (Debbee) - UX/UI design
-- **product** (Paris) - Product management
-- **writer** (Wendy) - Technical writing
-
-**Full list**: `ax list agents --format json`
-
----
-
-## Memory System
-
-AutomatosX automatically saves all agent conversations:
-
-```bash
-# Search memory
-ax memory search "authentication"
-
-# List recent memories
-ax memory list --limit 10
-
-# Export for backup
-ax memory export > backup.json
-```
-
-**In Gemini CLI** (natural language):
-```
-"Search AutomatosX memory for authentication"
-```
-
-**Details**: Fast SQLite FTS5 search (< 1ms), 100% local, $0 API costs.
-
----
-
-## Multi-Agent Collaboration
-
-Agents can delegate tasks automatically:
-
-```bash
-ax run product "Build a complete user authentication feature"
-# → Product designs system
-# → Delegates to backend for implementation
-# → Delegates to security for audit
-```
-
-**Gemini CLI Example**:
-```
-"Use ax product agent to build a complete user authentication feature"
-```
-
----
-
-## Troubleshooting
-
-### Common Issues
-
-**"Agent not found"**
-```bash
-ax list agents  # Case-sensitive names
-```
-
-**"Provider not available"**
-```bash
-ax status
-ax doctor
-```
-
-**"Gemini CLI not found"**
-```bash
-npm install -g @google/gemini-cli
-gemini --version
-```
-
-### Getting Help
-
-```bash
-# Command help
-ax --help
-ax run --help
-
-# Debug mode
-ax --debug run backend "task"
-```
-
-**In Gemini CLI** (natural language):
-```
-"Check AutomatosX system status"
-"List all available agents"
-```
-
----
-
-## Advanced Features
-
-For advanced usage, see [AX-Integration.md](../AX-Integration.md):
-
-- **Spec-Driven Workflows** - YAML-based task definitions
-- **Parallel Execution** - Run multiple agents concurrently
-- **Resumable Runs** - Checkpoint and resume long tasks
-- **Streaming Output** - Real-time AI responses
-- **Provider Routing** - Intelligent multi-provider selection
-- **Cost Optimization** - Free-tier prioritization
-- **Custom Agents** - Create your own specialized agents
-
----
-
-## Documentation
-
-- **Complete Guide**: [AX-Integration.md](../AX-Integration.md) ← **Read this!**
-- **GitHub**: https://github.com/defai-digital/automatosx
-- **Agent Profiles**: `.automatosx/agents/`
-- **Configuration**: `ax.config.json`
-
-## Support
-
-- **Issues**: https://github.com/defai-digital/automatosx/issues
-- **NPM**: https://www.npmjs.com/package/@defai.digital/automatosx
-
----
-
-**For complete AutomatosX documentation**, see [AX-Integration.md](../AX-Integration.md).