G-Pilot Tool Architect

Every tool in G-Pilot must follow the Action-Ledger-Result pattern.

1. Structure of a Tool

A G-Pilot tool is an asynchronous function exported from src/tools/ or src/agents/.

export async function executeMissionTask(userId: string, payload: any) {
    // 1. Validation (Zod)
    // 2. Billing Verification (billingGate)
    // 3. Execution (API Call / SDK)
    // 4. Persistence (Save result to DB if needed)
    // 5. Result Return (URL, File, or Data)
}