aptos-x402 1.0.1 → 2.0.0

package/README.md

@@ -18,7 +18,14 @@
 
 **Aptos x402** is a TypeScript SDK implementing the [x402 payment protocol](https://github.com/coinbase/x402) for the Aptos blockchain. Enable your APIs to require cryptocurrency payments before serving responses using the standardized HTTP 402 status code.
 
-Built for **machine-to-machine micropayments**, this SDK provides zero-friction payment integration for Next.js applications with automatic payment handling, cryptographic verification, and sub-3-second settlement times.
+Built for **machine-to-machine micropayments**, this SDK provides zero-friction payment integration for Next.js applications with automatic payment handling, cryptographic verification, and **sub-second settlement times** (optimized from 2-3s to 200-500ms).
+
+### What’s new in 2.0.0
+- 🛡️ **ARC-8004 Agent Trust Layer** (Aptos-native, inspired by ERC-8004): agent identities, reputation, and task validation.
+- ✅ Frontend badges for Verified + Trust, with a verify API.
+- 📚 Docs and API routes for ARC-8004 (identity, reputation, validation).
+
+> ⚡ **Performance:** Latest optimizations deliver **5-10x faster** payments with verification caching, async confirmation, and smart deduplication. See [PERFORMANCE_OPTIMIZATIONS.md](./PERFORMANCE_OPTIMIZATIONS.md) for details.
 
 <!-- ## Key Features
 
@@ -58,6 +65,24 @@ npm install aptos-x402
 
 ---
 
+## 🤖 AI-Powered Setup (Cursor IDE)
+
+Get started in seconds with AI-assisted integration:
+
+```bash
+mkdir -p .cursor/rules
+curl -o .cursor/rules/aptos-x402.mdc https://raw.githubusercontent.com/adipundir/aptos-x402/main/integration/aptos-x402.mdc
+```
+
+**Restart Cursor IDE**, then ask:
+> "Set up Aptos x402 in my Next.js app with payment middleware and a test client component"
+
+The MDC context file provides Cursor with complete API documentation, types, and examples for accurate code generation.
+
+**Learn more:** [Cursor Integration Guide](./docs/guides/cursor-integration.md)
+
+---
+
 ## 🛒 Client Integration (Consuming Paid APIs)
 
 Access x402-protected APIs with zero configuration. The `x402axios` client automatically detects payment requirements, builds transactions, and handles the entire payment flow.
@@ -621,12 +646,48 @@ No human intervention required.
 
 ---
 
+## Performance Monitoring
+
+Track payment performance with built-in timing headers:
+
+```typescript
+const response = await x402axios.get(url, { privateKey });
+
+// Check performance metrics
+const verifyTime = response.headers['x-verification-time'];
+const settleTime = response.headers['x-settlement-time'];
+const cached = response.headers['x-cached'] === 'true';
+
+console.log(`Verification: ${verifyTime}ms`);
+console.log(`Settlement: ${settleTime}ms`);
+console.log(`Cached: ${cached}`);
+```
+
+### Performance Benchmarks
+
+Run the included benchmark to measure your setup:
+
+```bash
+APTOS_PRIVATE_KEY=0x... npx tsx scripts/benchmark-payment-flow.ts
+```
+
+**Expected Performance:**
+- First request (uncached): ~800-1000ms
+- Cached requests: ~650-800ms
+- Settlement alone: ~200-300ms
+- Legacy (pre-optimization): ~2000-3000ms
+
+**Optimization Details:** See [PERFORMANCE_OPTIMIZATIONS.md](./PERFORMANCE_OPTIMIZATIONS.md) for complete breakdown of the **5-10x performance improvements**.
+
+---
+
 ## Resources
 
 ### Documentation
 - [Full Documentation](https://aptos-x402.vercel.app/docs)
 - [API Reference](./docs/api-reference/server-api.md)
 - [Protocol Specification](https://github.com/coinbase/x402)
+- [Performance Guide](./PERFORMANCE_OPTIMIZATIONS.md)
 
 ### Links
 - [GitHub Repository](https://github.com/adipundir/aptos-x402)
@@ -642,10 +703,6 @@ No human intervention required.
 
 Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests.
 
-## License
-
-MIT © Aditya Pundir
-
 ---
 
 <div align="center">

package/dist/agent/data-extractor.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Data Extractor
+ * Uses LLM (Gemini or GitHub Models) to extract and format specific data from API responses
+ */
+export interface ExtractedData {
+    formattedResponse: string;
+    extractedData?: any;
+}
+/**
+ * Use LLM to extract specific data from API response based on user query
+ */
+export declare function extractDataWithLLM(userQuery: string, apiData: any, apiName: string, modelName?: string): Promise<ExtractedData>;
+//# sourceMappingURL=data-extractor.d.ts.map

package/dist/agent/data-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-extractor.d.ts","sourceRoot":"","sources":["../../lib/agent/data-extractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,MAAM,WAAW,aAAa;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,GAAG,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAA+B,GACzC,OAAO,CAAC,aAAa,CAAC,CAyDxB"}

package/dist/agent/data-extractor.js

@@ -0,0 +1,191 @@
+/**
+ * Data Extractor
+ * Uses LLM (Gemini or GitHub Models) to extract and format specific data from API responses
+ */
+import { ChatGoogleGenerativeAI } from '@langchain/google-genai';
+import { invokeGitHubModel, isGitHubModel } from './github-models';
+const GEMINI_API_KEY = process.env.GEMINI_API_KEY;
+// Cache model instances to avoid re-initialization overhead
+const modelCache = new Map();
+function getModel(modelName) {
+    if (!modelCache.has(modelName)) {
+        modelCache.set(modelName, new ChatGoogleGenerativeAI({
+            modelName: modelName,
+            temperature: 0.1,
+            apiKey: GEMINI_API_KEY,
+        }));
+    }
+    return modelCache.get(modelName);
+}
+/**
+ * Use LLM to extract specific data from API response based on user query
+ */
+export async function extractDataWithLLM(userQuery, apiData, apiName, modelName = 'gemini-2.0-flash-exp') {
+    // Check if this is a GitHub Model
+    if (isGitHubModel(modelName)) {
+        return extractDataWithGitHubModel(userQuery, apiData, apiName, modelName);
+    }
+    // If no Gemini API key, return raw data
+    if (!GEMINI_API_KEY || modelName === 'keyword') {
+        return {
+            formattedResponse: formatDataFallback(userQuery, apiData, apiName),
+            extractedData: apiData,
+        };
+    }
+    try {
+        const model = getModel(modelName);
+        // Optimize prompt - shorter and more direct for faster processing
+        // Truncate large API data to avoid token bloat
+        const dataStr = JSON.stringify(apiData);
+        const maxDataLength = 2000; // Limit data size to avoid huge prompts
+        const truncatedData = dataStr.length > maxDataLength
+            ? dataStr.substring(0, maxDataLength) + '...[truncated]'
+            : dataStr;
+        const prompt = `Query: "${userQuery}"
+API: ${apiName}
+Data: ${truncatedData}
+
+Rules: Direct answer only, no intros. Extract what user asked. Brief.`;
+        const response = await model.invoke(prompt);
+        const formattedResponse = response.content?.toString().trim();
+        // Try to extract structured data if possible
+        let extractedData = apiData;
+        try {
+            // Look for JSON in the response (in case LLM provides structured data)
+            const jsonMatch = formattedResponse?.match(/\{[\s\S]*\}/);
+            if (jsonMatch) {
+                extractedData = JSON.parse(jsonMatch[0]);
+            }
+        }
+        catch {
+            // If no JSON, use original data
+        }
+        return {
+            formattedResponse: formattedResponse || formatDataFallback(userQuery, apiData, apiName),
+            extractedData,
+        };
+    }
+    catch (error) {
+        console.error('Error extracting data with LLM:', error);
+        return {
+            formattedResponse: formatDataFallback(userQuery, apiData, apiName),
+            extractedData: apiData,
+        };
+    }
+}
+/**
+ * Extract data with GitHub Models
+ */
+async function extractDataWithGitHubModel(userQuery, apiData, apiName, modelName) {
+    try {
+        // Optimize prompt - shorter and more direct for faster processing
+        // Truncate large API data to avoid token bloat
+        const dataStr = JSON.stringify(apiData);
+        const maxDataLength = 2000; // Limit data size to avoid huge prompts
+        const truncatedData = dataStr.length > maxDataLength
+            ? dataStr.substring(0, maxDataLength) + '...[truncated]'
+            : dataStr;
+        // Use a safer prompt that's less likely to trigger content filters
+        const prompt = `User asked: ${userQuery}
+API response from ${apiName}:
+${truncatedData}
+
+Provide a concise summary answering the user's question. Be factual and direct.`;
+        const formattedResponse = await invokeGitHubModel(prompt, modelName);
+        // Try to extract structured data if possible
+        let extractedData = apiData;
+        try {
+            // Look for JSON in the response (in case LLM provides structured data)
+            const jsonMatch = formattedResponse.match(/\{[\s\S]*\}/);
+            if (jsonMatch) {
+                extractedData = JSON.parse(jsonMatch[0]);
+            }
+        }
+        catch {
+            // If no JSON, use original data
+        }
+        return {
+            formattedResponse: formattedResponse || formatDataFallback(userQuery, apiData, apiName),
+            extractedData,
+        };
+    }
+    catch (error) {
+        console.error('Error extracting data with GitHub Model:', error);
+        // If content filter error, try falling back to Gemini if available
+        if (error.message?.includes('content filter') || error.message?.includes('content management')) {
+            console.log('[Data Extractor] GitHub Model content filter triggered, falling back to Gemini...');
+            if (GEMINI_API_KEY) {
+                try {
+                    return await extractDataWithLLM(userQuery, apiData, apiName, 'gemini-2.0-flash-exp');
+                }
+                catch (geminiError) {
+                    console.error('Gemini fallback also failed:', geminiError);
+                }
+            }
+        }
+        // Fallback to smart formatter instead of raw JSON
+        return {
+            formattedResponse: formatDataSmart(userQuery, apiData, apiName),
+            extractedData: apiData,
+        };
+    }
+}
+/**
+ * Fallback formatter when LLM is not available
+ * Returns raw JSON - no API-specific logic. LLM should handle all extraction.
+ */
+function formatDataFallback(userQuery, apiData, apiName) {
+    // Just return the raw data as JSON - no hardcoded API-specific logic
+    // The LLM handles all extraction and formatting when available
+    return JSON.stringify(apiData, null, 2);
+}
+/**
+ * Smart formatter that extracts relevant data based on API type and query
+ * Used when LLM extraction fails but we still want specific output
+ */
+function formatDataSmart(userQuery, apiData, apiName) {
+    const lowerQuery = userQuery.toLowerCase();
+    // News API specific formatting
+    if (apiName.toLowerCase().includes('news') && apiData.headlines) {
+        const headlines = Array.isArray(apiData.headlines) ? apiData.headlines : [];
+        if (headlines.length > 0) {
+            return headlines.map((item, idx) => `${idx + 1}. ${item.title || item.headline || 'Untitled'}\n   Source: ${item.source || 'Unknown'}\n   ${item.publishedAt ? `Published: ${new Date(item.publishedAt).toLocaleDateString()}` : ''}`).join('\n\n');
+        }
+    }
+    // Weather API specific formatting
+    if (apiName.toLowerCase().includes('weather') && apiData.temperature) {
+        return `Temperature: ${apiData.temperature}°${apiData.unit || 'F'}\nCondition: ${apiData.condition || 'Unknown'}\nLocation: ${apiData.location || 'Unknown'}`;
+    }
+    // Stocks API specific formatting
+    if (apiName.toLowerCase().includes('stock') && apiData.price) {
+        return `Stock: ${apiData.symbol || 'Unknown'}\nPrice: $${apiData.price}\nChange: ${apiData.change || '0'}%`;
+    }
+    // If it's an array, show first few items
+    if (Array.isArray(apiData)) {
+        const items = apiData.slice(0, 5);
+        return items.map((item, idx) => {
+            if (typeof item === 'string')
+                return `${idx + 1}. ${item}`;
+            if (typeof item === 'object') {
+                const keys = Object.keys(item).slice(0, 3);
+                return `${idx + 1}. ${keys.map(k => `${k}: ${item[k]}`).join(', ')}`;
+            }
+            return `${idx + 1}. ${String(item)}`;
+        }).join('\n') + (apiData.length > 5 ? `\n\n... and ${apiData.length - 5} more items` : '');
+    }
+    // If it's an object, show key fields
+    if (typeof apiData === 'object' && apiData !== null) {
+        const keys = Object.keys(apiData).slice(0, 5);
+        const relevant = keys.filter(k => {
+            const val = apiData[k];
+            return val !== null && val !== undefined &&
+                (typeof val === 'string' || typeof val === 'number' || typeof val === 'boolean');
+        });
+        if (relevant.length > 0) {
+            return relevant.map(k => `${k}: ${apiData[k]}`).join('\n');
+        }
+    }
+    // Final fallback to JSON
+    return JSON.stringify(apiData, null, 2);
+}
+//# sourceMappingURL=data-extractor.js.map

package/dist/agent/data-extractor.js.map

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

package/dist/agent/executor.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Agent Executor
+ * Agent logic to parse queries and call APIs using Gemini AI for interpretation
+ */
+import { Agent } from '../storage/agents';
+export interface AgentResponse {
+    success: boolean;
+    message: string;
+    data?: any;
+    apiCalled?: string;
+    paymentHash?: string;
+    paymentAmount?: string;
+    error?: string;
+    llmUsed?: string;
+}
+/**
+ * Execute agent query by calling appropriate API
+ * @param agent - The agent configuration
+ * @param userQuery - The user's query/message
+ * @param options - Execution options including LLM and API selection
+ * @param userPrivateKey - Optional user's private key for payment (required for public agents)
+ */
+export declare function executeAgentQuery(agent: Agent, userQuery: string, options?: {
+    llm?: string;
+    apiId?: string | null;
+}, userPrivateKey?: string): Promise<AgentResponse>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/agent/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../lib/agent/executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI1C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IACR,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,EACD,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,aAAa,CAAC,CAyPxB"}

package/dist/agent/executor.js

@@ -0,0 +1,245 @@
+/**
+ * Agent Executor
+ * Agent logic to parse queries and call APIs using Gemini AI for interpretation
+ */
+import { x402axios } from '../x402-axios';
+import { getAllApis } from '../storage/apis';
+import { processQueryWithLLM } from './llm-chat';
+import { extractDataWithLLM } from './data-extractor';
+/**
+ * Execute agent query by calling appropriate API
+ * @param agent - The agent configuration
+ * @param userQuery - The user's query/message
+ * @param options - Execution options including LLM and API selection
+ * @param userPrivateKey - Optional user's private key for payment (required for public agents)
+ */
+export async function executeAgentQuery(agent, userQuery, options, userPrivateKey) {
+    try {
+        // Get available APIs for this agent
+        // Use relative URLs or detect from environment - will be resolved by x402axios
+        const allApis = getAllApis();
+        const availableApis = allApis.filter(api => agent.apiIds.includes(api.id));
+        if (availableApis.length === 0) {
+            return {
+                success: false,
+                message: 'This agent has no APIs configured. Please add APIs to the agent.',
+                error: 'NO_APIS_CONFIGURED',
+            };
+        }
+        // Process query with LLM or fallback
+        let llmResponse;
+        let llmUsed = 'keyword';
+        let selectedApi = null;
+        // Determine which model to use for LLM processing
+        let modelName = 'keyword';
+        if (options?.llm && options.llm !== 'keyword') {
+            // Check for GitHub Models
+            if (options.llm.startsWith('gpt-5') || options.llm.startsWith('grok-3') ||
+                options.llm.startsWith('gpt-4.1') || options.llm.startsWith('phi-4') ||
+                options.llm.startsWith('o4-mini')) {
+                modelName = options.llm;
+                llmUsed = options.llm === 'gpt-5-mini' ? 'GPT-5 Mini' :
+                    options.llm === 'gpt-5-nano' ? 'GPT-5 Nano' :
+                        options.llm === 'grok-3-mini' ? 'Grok 3 Mini' :
+                            options.llm === 'gpt-4.1-mini' ? 'GPT-4.1 Mini' :
+                                options.llm === 'gpt-4.1-nano' ? 'GPT-4.1 Nano' :
+                                    options.llm === 'phi-4-mini-reasoning' ? 'Phi-4 Mini Reasoning' :
+                                        options.llm === 'o4-mini' ? 'O4 Mini' :
+                                            options.llm;
+            }
+            else if (options.llm.startsWith('gemini')) {
+                const modelMap = {
+                    'gemini-2.5-flash': 'gemini-2.0-flash-exp',
+                };
+                modelName = modelMap[options.llm] || 'gemini-2.0-flash-exp';
+                llmUsed = 'Gemini 2.5 Flash';
+            }
+            else if (options.llm === 'claude-sonnet-4') {
+                return {
+                    success: false,
+                    message: 'This LLM is not yet available. Please select an enabled LLM.',
+                    error: 'LLM_NOT_AVAILABLE',
+                };
+            }
+        }
+        // Process query with LLM (unless specific API is manually selected)
+        if (!options?.apiId) {
+            llmResponse = await processQueryWithLLM(userQuery, availableApis, agent.name || 'Agent', modelName);
+            // Update llmUsed if fallback occurred
+            if (llmResponse?.actualModelUsed) {
+                if (llmResponse.actualModelUsed === 'gemini-2.5-flash') {
+                    llmUsed = 'Gemini 2.5 Flash';
+                }
+            }
+            // If LLM says no API call needed (greeting/casual), return conversational response
+            if (llmResponse && !llmResponse.shouldCallAPI) {
+                return {
+                    success: true,
+                    message: llmResponse.conversationalResponse || `Hello! I'm ${agent.name || 'your agent'}. How can I help you today?`,
+                    llmUsed: options?.llm === 'keyword' ? undefined : llmUsed,
+                };
+            }
+            // Find the API if LLM suggested one
+            if (llmResponse?.apiId) {
+                selectedApi = availableApis.find(api => api.id === llmResponse.apiId) || null;
+            }
+            // If no API found, return error
+            if (!selectedApi) {
+                return {
+                    success: false,
+                    message: llmResponse?.conversationalResponse || 'I couldn\'t determine which API to use for your query. Please try rephrasing or select a specific API.',
+                    error: 'NO_MATCHING_API',
+                    llmUsed: options?.llm === 'keyword' ? undefined : llmUsed,
+                };
+            }
+        }
+        else {
+            // Specific API manually selected - use fast keyword check for greetings (skip LLM call)
+            // We should never call APIs for greetings, even if manually selected
+            const lowerQuery = userQuery.toLowerCase().trim();
+            const greetings = ['hello', 'hi', 'hey', 'howdy', 'greetings', 'good morning', 'good afternoon', 'good evening'];
+            const casual = ['thanks', 'thank you', 'ok', 'okay', 'yes', 'no', 'sure', 'alright', 'cool', 'nice', 'how are you', 'what\'s up'];
+            if (greetings.some(g => lowerQuery === g || lowerQuery.startsWith(g + ' ')) ||
+                casual.some(c => lowerQuery === c || lowerQuery.startsWith(c + ' '))) {
+                return {
+                    success: true,
+                    message: `Hello! I'm ${agent.name || 'your agent'}. How can I help you today?`,
+                    llmUsed: undefined, // No LLM used for greeting check
+                };
+            }
+            selectedApi = availableApis.find(api => api.id === options.apiId) || null;
+            if (!selectedApi) {
+                return {
+                    success: false,
+                    message: `The requested API "${options.apiId}" is not available for this agent.`,
+                    error: 'API_NOT_AVAILABLE',
+                };
+            }
+        }
+        // Determine which wallet to use for payment:
+        // - If userPrivateKey is provided: user is chatting with someone else's public agent -> use user's wallet
+        // - Otherwise: user owns the agent -> use agent's wallet
+        let paymentPrivateKey;
+        if (userPrivateKey) {
+            // User chatting with public agent owned by someone else - use user's wallet
+            paymentPrivateKey = userPrivateKey;
+        }
+        else {
+            // User owns the agent (or it's private) - use agent's wallet
+            paymentPrivateKey = agent.privateKey;
+        }
+        // Call the API using x402axios with appropriate private key
+        try {
+            const config = {
+                privateKey: paymentPrivateKey,
+            };
+            let response;
+            if (selectedApi.method === 'GET') {
+                response = await x402axios.get(selectedApi.url, config);
+            }
+            else if (selectedApi.method === 'POST') {
+                // For POST, you might want to extract data from query
+                // For now, just send empty body or query params
+                response = await x402axios.post(selectedApi.url, {}, config);
+            }
+            else {
+                response = await x402axios.get(selectedApi.url, config);
+            }
+            // Extract payment info if available
+            const paymentHash = response.paymentInfo?.transactionHash;
+            const paymentAmount = response.paymentInfo?.amount; // Amount in Octas
+            console.log('[Agent Executor] Payment info:', {
+                hasPaymentInfo: !!response.paymentInfo,
+                paymentHash,
+                paymentAmount,
+                fullPaymentInfo: response.paymentInfo
+            });
+            // Use LLM to extract and format specific data from API response
+            let finalMessage;
+            let extractedData = response.data;
+            if (options?.llm && options.llm !== 'keyword') {
+                // Determine the model name for data extraction
+                let extractionModelName = 'keyword';
+                if (options.llm.startsWith('gemini')) {
+                    // Map LLM names for data extraction
+                    const modelMap = {
+                        'gemini-2.5-flash': 'gemini-2.0-flash-exp',
+                    };
+                    extractionModelName = modelMap[options.llm] || 'gemini-2.0-flash-exp';
+                }
+                else if (options.llm.startsWith('gpt-5') || options.llm.startsWith('grok-3') ||
+                    options.llm.startsWith('gpt-4.1') || options.llm.startsWith('phi-4') ||
+                    options.llm.startsWith('o4-mini')) {
+                    // Use GitHub Models directly
+                    extractionModelName = options.llm;
+                }
+                // Extract specific data based on user query
+                const extraction = await extractDataWithLLM(userQuery, response.data, selectedApi.name, extractionModelName);
+                finalMessage = extraction.formattedResponse;
+                extractedData = extraction.extractedData;
+            }
+            else {
+                // Fallback: use conversational response or format data
+                finalMessage = llmResponse?.conversationalResponse ||
+                    `Successfully retrieved data from ${selectedApi.name}`;
+            }
+            return {
+                success: true,
+                message: finalMessage,
+                data: extractedData,
+                apiCalled: selectedApi.name,
+                paymentHash,
+                paymentAmount, // Amount in Octas
+                llmUsed: options?.llm === 'keyword' ? undefined : llmUsed,
+            };
+        }
+        catch (apiError) {
+            // Handle x402 payment errors
+            if (apiError.response?.status === 402) {
+                return {
+                    success: false,
+                    message: 'Payment required but could not be processed. Please ensure the agent has sufficient funds.',
+                    error: 'PAYMENT_REQUIRED',
+                    apiCalled: selectedApi.name,
+                };
+            }
+            if (apiError.message?.includes('funds') || apiError.message?.includes('balance')) {
+                return {
+                    success: false,
+                    message: 'Insufficient funds. Please add more APT to this agent\'s wallet.',
+                    error: 'INSUFFICIENT_FUNDS',
+                    apiCalled: selectedApi.name,
+                };
+            }
+            // Handle network/fetch errors
+            const errorMessage = apiError.message || apiError.toString() || 'Unknown error';
+            const isNetworkError = errorMessage.includes('fetch failed') ||
+                errorMessage.includes('network') ||
+                errorMessage.includes('Failed to fetch');
+            if (isNetworkError) {
+                return {
+                    success: false,
+                    message: `Unable to reach ${selectedApi.name}. The API may be unavailable or the URL is incorrect.`,
+                    error: 'NETWORK_ERROR',
+                    apiCalled: selectedApi.name,
+                    llmUsed: options?.llm === 'keyword' ? undefined : llmUsed,
+                };
+            }
+            return {
+                success: false,
+                message: `Error calling ${selectedApi.name}: ${errorMessage}`,
+                error: 'API_ERROR',
+                apiCalled: selectedApi.name,
+                llmUsed: options?.llm === 'keyword' ? undefined : llmUsed,
+            };
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: `An error occurred: ${error.message || 'Unknown error'}`,
+            error: 'EXECUTION_ERROR',
+        };
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/agent/executor.js.map

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

package/dist/agent/gemini-interpreter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * LLM Query Interpreter
+ * Uses Google Gemini or GitHub Models to understand user queries and determine which API to call
+ */
+import { ApiMetadata } from '../storage/apis';
+/**
+ * Use LLM (Gemini or GitHub Models) to determine which API to call based on user query
+ */
+export declare function interpretQueryWithGemini(userQuery: string, availableApis: ApiMetadata[], modelName?: string): Promise<ApiMetadata | null>;
+//# sourceMappingURL=gemini-interpreter.d.ts.map

package/dist/agent/gemini-interpreter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-interpreter.d.ts","sourceRoot":"","sources":["../../lib/agent/gemini-interpreter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAc,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAS1D;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,WAAW,EAAE,EAC5B,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA8D7B"}