@amitdeshmukh/ax-crew 8.0.3 → 8.2.0

package/examples/graphjin-README.md

@@ -1,167 +0,0 @@
-# GraphJin Database Agent Example
-
-This example demonstrates how to integrate GraphJin MCP server with AxCrew to give AI agents direct database access.
-
-## What is GraphJin?
-
-GraphJin is a compiler that connects AI assistants to databases. It auto-discovers your database schema, understands relationships, and compiles queries to optimized SQL. Works with PostgreSQL, MySQL, MongoDB, SQLite, Oracle, and MSSQL.
-
-## Setup
-
-### 1. Install GraphJin
-
-```bash
-npm install -g graphjin
-```
-
-Or on macOS with Homebrew:
-```bash
-brew install dosco/graphjin/graphjin
-```
-
-### 2. Start GraphJin Demo Server
-
-```bash
-# Clone GraphJin repo to get example databases
-git clone https://github.com/dosco/graphjin
-cd graphjin
-
-# Start the demo webshop database
-graphjin serve --demo --path examples/webshop
-```
-
-This starts GraphJin on `http://localhost:8080` with:
-- Web UI: http://localhost:8080/
-- GraphQL API: http://localhost:8080/api/v1/graphql
-- MCP endpoint: http://localhost:8080/api/v1/mcp
-
-### 3. Run the Example
-
-```bash
-cd /path/to/AxCrew/ax-crew
-GEMINI_API_KEY=your-key npm run examples/graphjin-database-agent.ts
-```
-
-## How It Works
-
-The example creates two agents:
-
-1. **DatabaseAgent**: Connects to GraphJin MCP server and has access to database tools
-2. **ManagerAgent**: Orchestrates queries and delegates to DatabaseAgent
-
-The GraphJin MCP server provides tools like:
-- `get_tables` - List database tables
-- `get_table_schema` - Get table structure
-- `execute_graphql` - Query the database
-- `search_schema` - Search for tables/columns
-- And many more...
-
-## MCP Server Configuration
-
-### Proxy Mode (Recommended for Development)
-
-Connects to a running GraphJin HTTP server:
-
-```typescript
-mcpServers: {
-  "graphjin": {
-    "command": "graphjin",
-    "args": ["mcp", "--server", "http://localhost:8080"]
-  }
-}
-```
-
-### Direct Mode
-
-Runs GraphJin MCP server directly via stdio:
-
-```typescript
-mcpServers: {
-  "graphjin": {
-    "command": "graphjin",
-    "args": ["mcp", "--demo", "--path", "/path/to/config"]
-  }
-}
-```
-
-## Known Issue: Schema Validation Error
-
-⚠️ **Current Status**: There's a schema validation incompatibility between GraphJin and Ax.
-
-### The Problem
-
-GraphJin's MCP server uses `mcp.WithArray()` from the `mcp-go` library, which generates JSON schemas without the required `items` property. This violates the JSON Schema specification and causes Ax to reject the schemas with:
-
-```
-Error: Function 'update_current_config' parameters schema is invalid.
-Array schema is missing an "items" definition (required by JSON Schema and all LLM providers for function tools)
-```
-
-### Why Other MCP Clients Work
-
-Some MCP clients are lenient and accept incomplete schemas, but Ax correctly enforces JSON Schema spec compliance.
-
-### The Fix (Required in GraphJin)
-
-The issue is in [graphjin/serv/mcp_config.go](graphjin/serv/mcp_config.go) where arrays are defined without item schemas:
-
-```go
-// Current (broken):
-mcp.WithArray("tables",
-    mcp.Description("Array of table configs to add/update..."),
-)
-
-// Should be (fixed):
-mcp.WithArray("tables",
-    mcp.Description("Array of table configs to add/update..."),
-    mcp.Items(mcp.Object(
-        // Define the structure of each table config item
-    )),
-)
-```
-
-All array parameters in `update_current_config` need proper `items` schemas:
-- `tables` (line 36)
-- `roles` (line 39)
-- `blocklist` (line 42)
-- `functions` (line 45)
-- `remove_databases` (line 48)
-- `remove_tables` (line 51)
-- `remove_roles` (line 54)
-- `remove_blocklist_items` (line 57)
-- `remove_functions` (line 60)
-
-### Workaround
-
-Until GraphJin is fixed, you can:
-1. Use GraphJin with other MCP clients that are more lenient
-2. Only use read-only tools (like `get_tables`, `execute_graphql`) which don't have this issue
-3. Wait for the GraphJin team to fix the schema definitions
-
-## Example Queries
-
-Once the schema issue is fixed, you can try queries like:
-
-```typescript
-const queries = [
-  "What tables are available in the database?",
-  "Show me the schema for the products table",
-  "How many products are in the database?",
-  "List the top 5 most expensive products",
-  "What customers have placed orders in the last 30 days?",
-  "Update the products table to add a new column called 'featured'",
-];
-```
-
-## Next Steps
-
-1. **For GraphJin Maintainers**: Fix the array item schemas in `mcp_config.go`
-2. **For Users**: Use read-only GraphJin tools until the fix is merged
-3. **For Ax Users**: The validation is correct and should not be changed
-
-## Resources
-
-- [GraphJin Documentation](https://graphjin.com)
-- [GraphJin GitHub](https://github.com/dosco/graphjin)
-- [MCP Protocol Spec](https://modelcontextprotocol.io)
-- [JSON Schema Specification](https://json-schema.org)

package/examples/planner.ts

@@ -1,107 +0,0 @@
-// LLA: Latitude, Longitude, Altitude (and optional Heading)
-export interface LLA {
-  lat: number;
-  lon: number;
-  alt: number;
-  heading?: number;
-}
-
-/**
- * Summary of the calculated mission.
- */
-interface MissionSummary {
-    totalDistanceKm: number;
-    totalTimeSeconds: number;
-    etaFormatted: string;
-}
-
-/**
- * FlightConstantSpeedPlanner
- * Simple waypoint-to-waypoint path generation at constant speed.
- */
-export class FlightConstantSpeedPlanner {
-    private readonly EARTH_RADIUS = 6378137.0;
-
-    constructor(
-        private speed: number, // m/s
-        private hz: number = 0.0333 // Default: ~1 point per 30 seconds
-    ) {}
-
-    public getMissionDetails(waypoints: LLA[]): { path: LLA[], summary: MissionSummary } {
-        const path = this.planRoute(waypoints);
-
-        const totalTimeSeconds = path.length > 1 ? (path.length - 1) / this.hz : 0;
-        const totalDistanceKm = (totalTimeSeconds * this.speed) / 1000;
-
-        return {
-            path,
-            summary: {
-                totalDistanceKm: Number(totalDistanceKm.toFixed(3)),
-                totalTimeSeconds: Math.round(totalTimeSeconds),
-                etaFormatted: this.formatTime(totalTimeSeconds)
-            }
-        };
-    }
-
-    private planRoute(waypoints: LLA[]): LLA[] {
-        if (waypoints.length < 2) return waypoints;
-
-        let fullPath: LLA[] = [];
-
-        // Simple: just generate straight segments between consecutive waypoints
-        for (let i = 0; i < waypoints.length - 1; i++) {
-            const segment = this.generateStraight(waypoints[i], waypoints[i + 1]);
-            fullPath = [...fullPath, ...segment];
-        }
-
-        // Add final waypoint
-        fullPath.push(waypoints[waypoints.length - 1]);
-
-        return fullPath;
-    }
-
-    private generateStraight(start: LLA, end: LLA): LLA[] {
-        const dist = this.getDistance(start, end);
-        if (dist < 0.01) return [];
-
-        const steps = Math.max(1, Math.floor((dist / this.speed) * this.hz));
-        const heading = this.getBearing(start, end);
-        const points: LLA[] = [];
-
-        for (let i = 0; i < steps; i++) {
-            const r = i / steps;
-            points.push({
-                lat: start.lat + (end.lat - start.lat) * r,
-                lon: start.lon + (end.lon - start.lon) * r,
-                alt: start.alt + (end.alt - start.alt) * r,
-                heading: Number(heading.toFixed(2))
-            });
-        }
-        return points;
-    }
-
-    private getBearing(p1: LLA, p2: LLA): number {
-        const dLon = (p2.lon - p1.lon) * (Math.PI / 180);
-        const lat1 = p1.lat * (Math.PI / 180);
-        const lat2 = p2.lat * (Math.PI / 180);
-        const y = Math.sin(dLon) * Math.cos(lat2);
-        const x = Math.cos(lat1) * Math.sin(lat2) - Math.sin(lat1) * Math.cos(lat2) * Math.cos(dLon);
-        return (Math.atan2(y, x) * 180 / Math.PI + 360) % 360;
-    }
-
-    private getDistance(p1: LLA, p2: LLA): number {
-        const dLat = (p2.lat - p1.lat) * (Math.PI / 180);
-        const dLon = (p2.lon - p1.lon) * (Math.PI / 180);
-        const a = Math.sin(dLat/2)**2 + Math.cos(p1.lat*Math.PI/180) * Math.cos(p2.lat*Math.PI/180) * Math.sin(dLon/2)**2;
-        return 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1-a)) * this.EARTH_RADIUS;
-    }
-
-    private formatTime(seconds: number): string {
-        const h = Math.floor(seconds / 3600);
-        const m = Math.floor((seconds % 3600) / 60);
-        const s = Math.floor(seconds % 60);
-        const parts = [m, s].map(v => v.toString().padStart(2, '0'));
-        if (h > 0) parts.unshift(h.toString().padStart(2, '0'));
-        return parts.join(':');
-    }
-}