@fluxa-pay/fluxa-connect-mcp 0.1.4 → 0.1.6

package/dist/server/credential-cache.js

@@ -0,0 +1,163 @@
+/**
+ * Credential cache management
+ * Stores agent credentials in ~/.fluxa-ai-wallet-mcp/.agent-config.json
+ */
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync, unlinkSync, renameSync } from 'node:fs';
+import { logger } from '../utils/logger.js';
+import { parseJWT } from '../utils/jwt-utils.js';
+const CACHE_DIR = join(homedir(), '.fluxa-ai-wallet-mcp');
+const CACHE_FILE = join(CACHE_DIR, '.agent-config.json');
+const CACHE_VERSION = '1.0';
+/**
+ * Ensure cache directory exists with proper permissions
+ */
+function ensureCacheDir() {
+    if (!existsSync(CACHE_DIR)) {
+        logger.info('credential-cache', 'Creating cache directory', {
+            path: CACHE_DIR
+        });
+        mkdirSync(CACHE_DIR, { recursive: true, mode: 0o700 });
+    }
+}
+/**
+ * Load cache from disk
+ * Returns empty cache structure if file doesn't exist or is invalid
+ */
+export function loadCache() {
+    ensureCacheDir();
+    if (!existsSync(CACHE_FILE)) {
+        logger.debug('credential-cache', 'Cache file does not exist, creating new cache');
+        return {
+            version: CACHE_VERSION,
+            agents: {}
+        };
+    }
+    try {
+        const data = readFileSync(CACHE_FILE, 'utf-8');
+        const cache = JSON.parse(data);
+        // Validate cache structure
+        if (!cache.version || !cache.agents) {
+            logger.warn('credential-cache', 'Invalid cache structure, creating new cache');
+            return {
+                version: CACHE_VERSION,
+                agents: {}
+            };
+        }
+        logger.debug('credential-cache', 'Cache loaded', {
+            emailCount: Object.keys(cache.agents).length,
+            totalAgents: Object.values(cache.agents).reduce((sum, agents) => sum + Object.keys(agents).length, 0)
+        });
+        return cache;
+    }
+    catch (error) {
+        logger.warn('credential-cache', 'Failed to load cache, creating new cache', {
+            error: error.message
+        });
+        return {
+            version: CACHE_VERSION,
+            agents: {}
+        };
+    }
+}
+/**
+ * Save cache to disk with atomic write
+ */
+export function saveCache(cache) {
+    ensureCacheDir();
+    try {
+        const data = JSON.stringify(cache, null, 2);
+        // Atomic write: write to temp file, then rename
+        const tempFile = `${CACHE_FILE}.tmp`;
+        writeFileSync(tempFile, data, { mode: 0o600 });
+        // Rename is atomic on most systems
+        if (existsSync(CACHE_FILE)) {
+            // On some systems, need to remove destination first
+            // This is a small race condition window, but acceptable for our use case
+            const backupFile = `${CACHE_FILE}.bak`;
+            if (existsSync(backupFile)) {
+                // Remove old backup
+                unlinkSync(backupFile);
+            }
+            renameSync(CACHE_FILE, backupFile);
+        }
+        renameSync(tempFile, CACHE_FILE);
+        // Ensure permissions
+        chmodSync(CACHE_FILE, 0o600);
+        logger.debug('credential-cache', 'Cache saved', {
+            path: CACHE_FILE
+        });
+    }
+    catch (error) {
+        logger.error('credential-cache', 'Failed to save cache', {
+            error: error.message,
+            path: CACHE_FILE
+        });
+        throw new Error(`Failed to save credential cache: ${error.message}`);
+    }
+}
+/**
+ * Lookup credentials by email and agent name
+ */
+export function getCredentials(email, agentName) {
+    const cache = loadCache();
+    const emailAgents = cache.agents[email];
+    if (!emailAgents) {
+        logger.debug('credential-cache', 'No credentials for email', { email });
+        return null;
+    }
+    const credentials = emailAgents[agentName];
+    if (!credentials) {
+        logger.debug('credential-cache', 'No credentials for agent name', {
+            email,
+            agentName
+        });
+        return null;
+    }
+    logger.debug('credential-cache', 'Credentials found in cache', {
+        email,
+        agentName,
+        agentId: credentials.agent_id
+    });
+    return credentials;
+}
+/**
+ * Store credentials in cache
+ * Creates email/agent_name structure if it doesn't exist
+ */
+export function storeCredentials(creds) {
+    const cache = loadCache();
+    // Ensure email entry exists
+    if (!cache.agents[creds.email]) {
+        cache.agents[creds.email] = {};
+    }
+    // Store credentials under email -> agent_name
+    cache.agents[creds.email][creds.agent_name] = creds;
+    saveCache(cache);
+    logger.info('credential-cache', 'Credentials stored in cache', {
+        email: creds.email,
+        agentName: creds.agent_name,
+        agentId: creds.agent_id,
+        expiresAt: creds.jwt_expires_at
+    });
+}
+/**
+ * Helper to create CachedCredentials from registration response
+ */
+export function createCachedCredentials(agentId, token, jwt, email, agentName, clientInfo) {
+    // Parse JWT to get expiry
+    const payload = parseJWT(jwt);
+    const expiresAt = new Date(payload.exp * 1000).toISOString();
+    return {
+        agent_id: agentId,
+        token,
+        jwt,
+        email,
+        agent_name: agentName,
+        client_info: clientInfo,
+        registered_at: new Date().toISOString(),
+        jwt_expires_at: expiresAt
+    };
+}
+//# sourceMappingURL=credential-cache.js.map

package/dist/server/credential-cache.js.map

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

package/dist/server/stdio-server.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * MCP Stdio Server - Main entry point
+ * Minimal orchestrator that coordinates all components
+ */
+export {};
+//# sourceMappingURL=stdio-server.d.ts.map

package/dist/server/stdio-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-server.d.ts","sourceRoot":"","sources":["../../src/server/stdio-server.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/server/stdio-server.js

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+/**
+ * MCP Stdio Server - Main entry point
+ * Minimal orchestrator that coordinates all components
+ */
+import { webcrypto } from 'node:crypto';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { config as loadEnv } from 'dotenv';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { loadConfig, ConfigError } from './config.js';
+import { registerAgent, AgentRegistrationError } from './agent-registry.js';
+import { createPaymentClient } from '../payment/payment-client.js';
+import { logger } from '../utils/logger.js';
+// Polyfill crypto for Node.js environment
+if (!globalThis.crypto) {
+    globalThis.crypto = webcrypto;
+}
+loadEnv();
+async function main() {
+    try {
+        // Load and validate configuration
+        const config = loadConfig();
+        logger.info('stdio-server', 'Configuration loaded', {
+            upstreamUrl: config.upstream.url,
+            network: config.fluxa.network,
+            agentName: config.agent.name
+        });
+        // Register agent with FluxA
+        const credentials = await registerAgent(config.fluxa.agentRegistryUrl, config.agent.email, config.agent.name, config.agent.clientInfo);
+        // Connect to upstream MCP server
+        logger.info('stdio-server', 'Connecting to upstream MCP server', {
+            url: config.upstream.url
+        });
+        const upstreamUrl = new URL(config.upstream.url);
+        // Build custom headers for the transport (email for free credits)
+        const transport = new StreamableHTTPClientTransport(upstreamUrl, {
+            requestInit: {
+                headers: {
+                    'X-Consumer-Email': config.agent.email
+                }
+            }
+        });
+        logger.debug('stdio-server', 'Adding X-Consumer-Email header for free credits', {
+            email: config.agent.email
+        });
+        const client = new Client({ name: 'fluxa-connect-mcp-client', version: '1.0.0' }, { capabilities: {} });
+        await client.connect(transport);
+        logger.info('stdio-server', 'Connected to upstream server');
+        // Wrap client with payment capabilities
+        const paymentClient = createPaymentClient(client, {
+            walletServiceUrl: config.fluxa.walletServiceUrl,
+            agentJwt: credentials.jwt,
+            agentName: config.agent.name,
+            network: config.fluxa.network,
+            confirmationCallback: async (paymentOptions) => {
+                logger.info('stdio-server', 'Payment requested', {
+                    networks: paymentOptions.map(p => ({
+                        network: p.network,
+                        amount: p.maxAmountRequired,
+                        description: p.description
+                    }))
+                });
+                return true; // Auto-approve (user approves via FluxA UI)
+            }
+        });
+        // List available tools from upstream
+        logger.debug('stdio-server', 'Listing tools from upstream server');
+        let upstreamTools;
+        try {
+            upstreamTools = await paymentClient.listTools();
+        }
+        catch (error) {
+            logger.error('stdio-server', 'Failed to list tools from upstream server', {
+                error: error.message,
+                upstreamUrl: config.upstream.url
+            });
+            throw new Error(`Failed to connect to upstream MCP server: ${error.message}\n\n` +
+                `Please check:\n` +
+                `  - The upstream server URL is correct: ${config.upstream.url}\n` +
+                `  - The upstream server is running and healthy\n` +
+                `  - You have network connectivity to the server`);
+        }
+        logger.info('stdio-server', 'Upstream tools loaded', {
+            toolCount: upstreamTools.tools.length,
+            tools: upstreamTools.tools.map(t => t.name)
+        });
+        // Verify tool schemas
+        upstreamTools.tools.forEach(tool => {
+            if (!tool.inputSchema) {
+                logger.warn('stdio-server', 'Tool missing inputSchema', {
+                    toolName: tool.name
+                });
+            }
+        });
+        // Create MCP stdio server
+        const server = new Server({
+            name: 'fluxa-connect-mcp',
+            version: '1.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        // Register tool list handler
+        server.setRequestHandler(ListToolsRequestSchema, async () => {
+            logger.debug('stdio-server', 'ListTools request');
+            return upstreamTools;
+        });
+        // Register tool call handler
+        server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            logger.info('stdio-server', 'Tool call received', {
+                toolName: name,
+                hasArguments: !!args
+            });
+            try {
+                const result = await paymentClient.callTool({ name, arguments: args });
+                logger.info('stdio-server', 'Tool call completed', { toolName: name });
+                return result;
+            }
+            catch (error) {
+                logger.error('stdio-server', 'Tool call failed', {
+                    toolName: name,
+                    error: error.message
+                });
+                throw error;
+            }
+        });
+        // Connect server to stdio
+        const stdioTransport = new StdioServerTransport();
+        await server.connect(stdioTransport);
+        logger.info('stdio-server', 'FluxA Connect MCP Server running on stdio');
+    }
+    catch (error) {
+        if (error instanceof ConfigError || error instanceof AgentRegistrationError) {
+            logger.error('stdio-server', error.message);
+            process.exit(1);
+        }
+        logger.error('stdio-server', 'Fatal error', {
+            error: error.message,
+            stack: error.stack
+        });
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=stdio-server.js.map

package/dist/server/stdio-server.js.map

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

package/dist/utils/api.d.ts

@@ -0,0 +1,43 @@
+/**
+ * FluxA API client
+ * All API calls to FluxA services centralized here
+ */
+export declare class APIError extends Error {
+    readonly statusCode?: number | undefined;
+    readonly responseData?: any | undefined;
+    constructor(message: string, statusCode?: number | undefined, responseData?: any | undefined);
+}
+/**
+ * Register agent with FluxA Agent Registry
+ */
+export declare function registerAgent(registryUrl: string, email: string, agentName: string, clientInfo: string): Promise<{
+    agent_id: string;
+    token: string;
+    jwt: string;
+}>;
+/**
+ * Refresh JWT token
+ */
+export declare function refreshJWT(registryUrl: string, agentId: string, token: string): Promise<string>;
+/**
+ * Create X402 payment via FluxA Wallet Service
+ */
+export declare function createX402Payment(walletServiceUrl: string, agentJwt: string, paymentRequest: {
+    scheme: string;
+    network: string;
+    amount: string;
+    currency: string;
+    assetAddress: string;
+    payTo: string;
+    host: string;
+    resource: string;
+    description: string;
+    tokenName: string;
+    tokenVersion: string;
+    validityWindowSeconds: number;
+}): Promise<{
+    status: string;
+    xPayment?: any;
+    approvalUrl?: string;
+}>;
+//# sourceMappingURL=api.d.ts.map

package/dist/utils/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/utils/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,qBAAa,QAAS,SAAQ,KAAK;aAGf,UAAU,CAAC,EAAE,MAAM;aACnB,YAAY,CAAC,EAAE,GAAG;gBAFlC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,YAAY,CAAC,EAAE,GAAG,YAAA;CAKrC;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb,CAAC,CAmED;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAuDjB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,GACA,OAAO,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC,CA8DD"}

package/dist/utils/api.js

@@ -0,0 +1,164 @@
+/**
+ * FluxA API client
+ * All API calls to FluxA services centralized here
+ */
+import axios from 'axios';
+import { logger } from './logger.js';
+export class APIError extends Error {
+    statusCode;
+    responseData;
+    constructor(message, statusCode, responseData) {
+        super(message);
+        this.statusCode = statusCode;
+        this.responseData = responseData;
+        this.name = 'APIError';
+    }
+}
+/**
+ * Register agent with FluxA Agent Registry
+ */
+export async function registerAgent(registryUrl, email, agentName, clientInfo) {
+    const url = `${registryUrl}/register`;
+    logger.debug('api', 'POST /register', {
+        registryUrl,
+        email,
+        agentName
+    });
+    try {
+        const response = await axios.post(url, {
+            email,
+            agent_name: agentName,
+            client_info: clientInfo
+        }, {
+            headers: {
+                'Content-Type': 'application/json'
+            }
+        });
+        const data = response.data;
+        if (!data.jwt || !data.agent_id || !data.token) {
+            throw new APIError('Invalid response from registry: missing jwt, agent_id, or token', response.status, data);
+        }
+        logger.debug('api', 'POST /register - success', {
+            agentId: data.agent_id
+        });
+        return {
+            agent_id: data.agent_id,
+            token: data.token,
+            jwt: data.jwt
+        };
+    }
+    catch (error) {
+        if (error instanceof APIError) {
+            throw error;
+        }
+        if (error.response) {
+            const statusCode = error.response.status;
+            const responseData = error.response.data;
+            logger.error('api', 'POST /register failed', {
+                statusCode,
+                message: responseData?.message || error.message
+            });
+            throw new APIError(responseData?.message || `Registration failed with status ${statusCode}`, statusCode, responseData);
+        }
+        // Network or other errors
+        logger.error('api', 'POST /register network error', {
+            error: error.message
+        });
+        throw new APIError(`Network error: ${error.message}`);
+    }
+}
+/**
+ * Refresh JWT token
+ */
+export async function refreshJWT(registryUrl, agentId, token) {
+    const url = `${registryUrl}/refresh`;
+    logger.debug('api', 'POST /refresh', { agentId });
+    try {
+        const response = await axios.post(url, {
+            agent_id: agentId,
+            token
+        }, {
+            headers: {
+                'Content-Type': 'application/json'
+            }
+        });
+        const data = response.data;
+        if (!data.jwt) {
+            throw new APIError('Invalid refresh response: missing jwt', response.status, data);
+        }
+        logger.debug('api', 'POST /refresh - success');
+        return data.jwt;
+    }
+    catch (error) {
+        if (error instanceof APIError) {
+            throw error;
+        }
+        if (error.response) {
+            const statusCode = error.response.status;
+            const responseData = error.response.data;
+            logger.error('api', 'POST /refresh failed', {
+                statusCode,
+                message: responseData?.message || error.message
+            });
+            throw new APIError(responseData?.message || `JWT refresh failed with status ${statusCode}`, statusCode, responseData);
+        }
+        logger.error('api', 'POST /refresh network error', {
+            error: error.message
+        });
+        throw new APIError(`Network error: ${error.message}`);
+    }
+}
+/**
+ * Create X402 payment via FluxA Wallet Service
+ */
+export async function createX402Payment(walletServiceUrl, agentJwt, paymentRequest) {
+    // Sanitize URL - ensure no double slashes
+    const baseUrl = walletServiceUrl.endsWith('/')
+        ? walletServiceUrl.slice(0, -1)
+        : walletServiceUrl;
+    const url = `${baseUrl}/api/payment/x402V1Payment`;
+    logger.debug('api', 'POST /api/payment/x402V1Payment', {
+        network: paymentRequest.network,
+        amount: paymentRequest.amount,
+        resource: paymentRequest.resource
+    });
+    try {
+        const response = await axios.post(url, paymentRequest, {
+            headers: {
+                'Authorization': `Bearer ${agentJwt}`,
+                'Content-Type': 'application/json'
+            }
+        });
+        const data = response.data;
+        logger.debug('api', 'POST /api/payment/x402V1Payment - success', {
+            status: data.status,
+            hasApprovalUrl: !!data.approvalUrl
+        });
+        return {
+            status: data.status,
+            xPayment: data.xPayment,
+            approvalUrl: data.approvalUrl
+        };
+    }
+    catch (error) {
+        if (error instanceof APIError) {
+            throw error;
+        }
+        if (error.response) {
+            const statusCode = error.response.status;
+            const responseData = error.response.data;
+            logger.error('api', 'POST /api/payment/x402V1Payment failed', {
+                statusCode,
+                code: responseData?.code,
+                message: responseData?.message || error.message
+            });
+            // Return error data for specialized handling by payment-service
+            throw new APIError(responseData?.message || `Payment creation failed with status ${statusCode}`, statusCode, responseData);
+        }
+        logger.error('api', 'POST /api/payment/x402V1Payment network error', {
+            error: error.message
+        });
+        throw new APIError(`Network error: ${error.message}`);
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/utils/api.js.map

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

package/dist/utils/error-messages.d.ts

@@ -0,0 +1,21 @@
+/**
+ * User-friendly error message formatting
+ * Centralizes error message construction for consistency
+ */
+/**
+ * Build agent authorization URL
+ */
+export declare function buildAuthorizationUrl(agentId: string, agentName: string): string;
+/**
+ * Format agent authorization error message
+ */
+export declare function formatAgentNotFoundError(agentId: string, agentName: string, instructions?: string): string;
+/**
+ * Format payment approval required error message
+ */
+export declare function formatApprovalRequiredError(approvalUrl: string): string;
+/**
+ * Extract agent ID from FluxA error instructions
+ */
+export declare function extractAgentIdFromInstructions(instructions: string): string | null;
+//# sourceMappingURL=error-messages.d.ts.map

package/dist/utils/error-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-messages.d.ts","sourceRoot":"","sources":["../../src/utils/error-messages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGhF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlF"}

package/dist/utils/error-messages.js

@@ -0,0 +1,46 @@
+/**
+ * User-friendly error message formatting
+ * Centralizes error message construction for consistency
+ */
+/**
+ * Build agent authorization URL
+ */
+export function buildAuthorizationUrl(agentId, agentName) {
+    const encodedName = encodeURIComponent(agentName);
+    return `https://agentwallet.fluxapay.xyz/add-agent?agentId=${agentId}&name=${encodedName}`;
+}
+/**
+ * Format agent authorization error message
+ */
+export function formatAgentNotFoundError(agentId, agentName, instructions) {
+    let message = 'Payment failed: Agent not authorized\n\n';
+    if (agentId) {
+        const authUrl = buildAuthorizationUrl(agentId, agentName);
+        message += 'Your agent needs to be authorized in FluxA wallet.\n\n';
+        message += `Please open this link to authorize:\n${authUrl}\n\n`;
+        message += 'After authorization, please retry this request.';
+    }
+    else if (instructions) {
+        message += instructions;
+    }
+    else {
+        message += 'Please contact support for assistance with agent authorization.';
+    }
+    return message;
+}
+/**
+ * Format payment approval required error message
+ */
+export function formatApprovalRequiredError(approvalUrl) {
+    return (`Payment requires approval.\n\n` +
+        `Please visit: ${approvalUrl}\n\n` +
+        `Then retry this operation.`);
+}
+/**
+ * Extract agent ID from FluxA error instructions
+ */
+export function extractAgentIdFromInstructions(instructions) {
+    const agentIdMatch = instructions.match(/ID:\s*([a-f0-9-]+)/i);
+    return agentIdMatch ? agentIdMatch[1] : null;
+}
+//# sourceMappingURL=error-messages.js.map

package/dist/utils/error-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-messages.js","sourceRoot":"","sources":["../../src/utils/error-messages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,SAAiB;IACtE,MAAM,WAAW,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAClD,OAAO,sDAAsD,OAAO,SAAS,WAAW,EAAE,CAAC;AAC7F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAe,EACf,SAAiB,EACjB,YAAqB;IAErB,IAAI,OAAO,GAAG,0CAA0C,CAAC;IAEzD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC1D,OAAO,IAAI,wDAAwD,CAAC;QACpE,OAAO,IAAI,wCAAwC,OAAO,MAAM,CAAC;QACjE,OAAO,IAAI,iDAAiD,CAAC;IAC/D,CAAC;SAAM,IAAI,YAAY,EAAE,CAAC;QACxB,OAAO,IAAI,YAAY,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,iEAAiE,CAAC;IAC/E,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,WAAmB;IAC7D,OAAO,CACL,gCAAgC;QAChC,iBAAiB,WAAW,MAAM;QAClC,4BAA4B,CAC7B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAAC,YAAoB;IACjE,MAAM,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC/D,OAAO,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC"}