@itachisol/plugin-x402-swarms 0.1.0

package/dist/actions/runSwarmAgent.js

@@ -0,0 +1,131 @@
+import { ModelType, } from "@elizaos/core";
+import { z } from "zod";
+const AgentSchema = z.object({
+    task: z.string().min(1),
+    agentName: z.string().optional().default("GeneralAgent"),
+    systemPrompt: z.string().optional(),
+    modelName: z.string().optional().default("gpt-4o-mini"),
+    maxTokens: z.number().optional().default(4096),
+    temperature: z.number().optional().default(0.5),
+});
+/**
+ * Run a single specialized agent via the Swarms API.
+ * For quick single-agent tasks that don't need multi-agent orchestration.
+ */
+export const runSwarmAgent = {
+    name: "RUN_SWARM_AGENT",
+    description: "Run a single specialized AI agent via the Swarms cloud API. Use for focused tasks that need a specific agent role or model. For multi-agent tasks, use DELEGATE_TO_SWARM instead.",
+    similes: [
+        "CALL_SWARM_AGENT",
+        "USE_SINGLE_AGENT",
+        "SWARM_AGENT_RUN",
+        "ASK_SWARM_AGENT",
+    ],
+    validate: async (runtime, _message, _state) => {
+        return !!runtime.getSetting("SWARMS_API_KEY");
+    },
+    handler: async (runtime, message, _state, _options, callback) => {
+        const swarmsService = runtime.getService("SWARMS");
+        if (!swarmsService || !swarmsService.isAvailable()) {
+            await callback?.({
+                text: "Swarms service not initialized. Set SWARMS_API_KEY in your environment.",
+                error: true,
+            });
+            return { success: false, error: "Swarms service not initialized" };
+        }
+        // Extract agent config from message
+        const extraction = await runtime.useModel(ModelType.TEXT_SMALL, {
+            prompt: `Extract agent task details from the user message. Return JSON with:
+- task: string (what the agent should do)
+- agentName: string (a descriptive name like "CodeReviewer", "DataAnalyst", "Writer")
+- systemPrompt: optional string (specific instructions for the agent)
+- modelName: optional string (e.g. "gpt-4o", "gpt-4o-mini", "claude-3-sonnet-20240229")
+- maxTokens: optional number (default 4096)
+- temperature: optional number (0.0-1.0, default 0.5)
+
+User message: "${message.content.text ?? ""}"
+
+Return only valid JSON, no markdown.`,
+        });
+        let params;
+        try {
+            params = AgentSchema.parse(JSON.parse(String(extraction)));
+        }
+        catch {
+            params = {
+                task: message.content.text ?? "unspecified task",
+                agentName: "GeneralAgent",
+                modelName: "gpt-4o-mini",
+                maxTokens: 4096,
+                temperature: 0.5,
+            };
+        }
+        await callback?.({
+            text: `Running agent "${params.agentName}" (${params.modelName})...`,
+        });
+        try {
+            const result = await swarmsService.runAgent({
+                agent_name: params.agentName,
+                system_prompt: params.systemPrompt ?? null,
+                model_name: params.modelName,
+                max_tokens: params.maxTokens,
+                temperature: params.temperature,
+                max_loops: 1,
+            }, params.task);
+            // Extract output
+            let output;
+            if (typeof result.outputs === "string") {
+                output = result.outputs;
+            }
+            else if (result.outputs != null &&
+                typeof result.outputs === "object" &&
+                "content" in result.outputs) {
+                output = result.outputs.content;
+            }
+            else if (result.outputs != null) {
+                output = JSON.stringify(result.outputs, null, 2);
+            }
+            else {
+                output = "(no output)";
+            }
+            const text = `Agent "${params.agentName}" completed.
+
+${output.slice(0, 1500)}`;
+            await callback?.({
+                text,
+                content: {
+                    agentId: String(result.job_id ?? ""),
+                    agentName: params.agentName,
+                    success: String(result.success ?? true),
+                },
+            });
+            return { success: true, text };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            await callback?.({
+                text: `Agent run failed: ${msg}`,
+                error: true,
+            });
+            return { success: false, error: msg };
+        }
+    },
+    examples: [
+        [
+            {
+                name: "user",
+                content: {
+                    text: "Use a code review agent to review this smart contract for vulnerabilities",
+                },
+            },
+            {
+                name: "agent",
+                content: {
+                    text: 'Agent "CodeReviewer" completed.\n\n[detailed review]...',
+                    actions: ["RUN_SWARM_AGENT"],
+                },
+            },
+        ],
+    ],
+};
+//# sourceMappingURL=runSwarmAgent.js.map

package/dist/actions/runSwarmAgent.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,512 @@
+/**
+ * x402-swarms Client SDK
+ *
+ * Dead-simple one-liner access to all x402-swarms platform endpoints.
+ * Handles x402 micropayments automatically — no protocol knowledge required.
+ *
+ * @example
+ * ```ts
+ * import { createClient } from "@elizaos/plugin-x402-swarms/client";
+ *
+ * const client = createClient({
+ *   walletPrivateKey: process.env.SOLANA_PRIVATE_KEY,
+ * });
+ *
+ * const report = await client.research("State of Solana DeFi in 2026");
+ * const analysis = await client.analyze("Bitcoin ETF impact on altcoins");
+ * const wallet = await client.analyzeWallet("So11...address");
+ * ```
+ *
+ * @module
+ */
+/** Configuration for the x402-swarms client. */
+export interface X402SwarmsClientConfig {
+    /** Solana private key (base58) for automatic USDC payments. */
+    walletPrivateKey?: string;
+    /** EVM private key (hex) for automatic USDC payments on Base/Polygon/Arbitrum. */
+    evmPrivateKey?: string;
+    /** Base URL of the x402-swarms platform. Defaults to production. */
+    baseUrl?: string;
+    /** Maximum payment per request in atomic units (USDC has 6 decimals). Defaults to "100000" ($0.10). */
+    maxAmountAtomic?: string;
+    /** Preferred network in CAIP-2 format (e.g. "eip155:8453" for Base mainnet). */
+    preferredNetwork?: string;
+}
+/** Payment metadata included in every paid response. */
+export interface PaymentInfo {
+    amount: string;
+    transaction: string;
+    network: string;
+}
+/** Response from POST /x402/research */
+export interface ResearchResponse {
+    result: string;
+    template: string;
+    payment: PaymentInfo;
+}
+/** Response from POST /x402/analyze */
+export interface AnalyzeResponse {
+    result: string;
+    template: string;
+    payment: PaymentInfo;
+}
+/** Response from POST /x402/agent */
+export interface AgentResponse {
+    result: string;
+    payment: PaymentInfo;
+}
+/** A single token holding returned by the wallet analyzer. */
+export interface TokenHolding {
+    mint: string;
+    amount: number;
+    decimals: number;
+    uiAmount: number;
+    symbol: string;
+}
+/** Response from POST /x402/wallet-analyzer */
+export interface WalletAnalysisResponse {
+    address: string;
+    solBalance: number;
+    tokens: TokenHolding[];
+    tokenCount: number;
+    analyzedAt: string;
+    payment: PaymentInfo;
+}
+/** A single entry in the service catalog. */
+export interface CatalogEntry {
+    name: string;
+    description: string;
+    path: string;
+    method: "GET" | "POST";
+    priceUsd: string;
+    free?: boolean;
+}
+/** Response from GET /x402/health */
+export interface HealthResponse {
+    status: string;
+    receiveAddress: string;
+    network: string;
+    totalRevenue: number;
+    settlements: number;
+}
+/** Response from GET /x402/wallet-analyzer/health */
+export interface WalletAnalyzerHealthResponse {
+    status: string;
+    heliusConfigured: boolean;
+    receiveAddress: string;
+    network: string;
+    price: string;
+}
+/** Response from POST /x402/summarize */
+export interface SummarizeResponse {
+    summary: string;
+    wordCount: number;
+    payment: PaymentInfo;
+}
+/** Response from POST /x402/translate */
+export interface TranslateResponse {
+    translation: string;
+    sourceLanguage: string;
+    targetLanguage: string;
+    payment: PaymentInfo;
+}
+/** Response from POST /x402/code-review */
+export interface CodeReviewResponse {
+    security: string;
+    performance: string;
+    style: string;
+    overallScore: string;
+    rawOutput: string;
+    template: string;
+    payment: PaymentInfo;
+}
+/** Response from POST /x402/write */
+export interface WriteResponse {
+    content: string;
+    wordCount: number;
+    template: string;
+    payment: PaymentInfo;
+}
+/** Response from POST /x402/debate */
+export interface DebateResponse {
+    proArgument: string;
+    conArgument: string;
+    verdict: string;
+    confidence: string;
+    rawOutput: string;
+    template: string;
+    payment: PaymentInfo;
+}
+/** Response from POST /x402/extract */
+export interface ExtractResponse {
+    extracted: Record<string, string>;
+    payment: PaymentInfo;
+}
+/** Response from POST /x402/sentiment */
+export interface SentimentResponse {
+    sentiment: "positive" | "negative" | "neutral";
+    confidence: number;
+    reasoning: string;
+    payment: PaymentInfo;
+}
+/** Response from POST /x402/contract-audit */
+export interface ContractAuditResponse {
+    riskScore: number | null;
+    findings: {
+        security: string[];
+        economic: string[];
+        gas: string[];
+    };
+    summary: string;
+    payment?: PaymentInfo;
+}
+/** Response from POST /x402/token-risk */
+export interface TokenRiskResponse {
+    riskScore: number | null;
+    verdict: string | null;
+    findings: {
+        contract: string[];
+        tokenomics: string[];
+    };
+    summary: string;
+    payment?: PaymentInfo;
+}
+/** Response from POST /x402/dao-analyze */
+export interface DaoAnalyzeResponse {
+    recommendation: string | null;
+    confidence: number | null;
+    analysis: {
+        economic: string;
+        technical: string;
+        risk: string;
+    };
+    summary: string;
+    payment?: PaymentInfo;
+}
+/** Error thrown when an x402-swarms API call fails. */
+export declare class X402SwarmsError extends Error {
+    /** HTTP status code from the server. */
+    readonly status: number;
+    /** Raw response body (may contain `error` field). */
+    readonly body: unknown;
+    constructor(message: string, status: number, body: unknown);
+}
+/**
+ * x402-swarms client SDK.
+ *
+ * Wraps every HTTP call with Dexter's `wrapFetch` so x402 payments
+ * are handled automatically. Each method maps 1:1 to a platform endpoint.
+ */
+export declare class X402SwarmsClient {
+    private readonly x402Fetch;
+    private readonly baseUrl;
+    constructor(config: X402SwarmsClientConfig);
+    /** POST JSON and return parsed response. */
+    private post;
+    /** GET and return parsed response. */
+    private get;
+    /**
+     * Multi-agent research pipeline ($0.05).
+     *
+     * Spawns Researcher, FactChecker, and Writer agents to produce
+     * a verified report on any topic.
+     *
+     * @param query - The topic to research.
+     * @param depth - Research depth: "quick" | "standard" | "deep". Defaults to "standard".
+     * @returns Verified research report with payment receipt.
+     *
+     * @example
+     * ```ts
+     * const report = await client.research("Solana validator economics in 2026");
+     * console.log(report.result);
+     * ```
+     */
+    research(query: string, depth?: "quick" | "standard" | "deep"): Promise<ResearchResponse>;
+    /**
+     * Multi-perspective analysis panel ($0.03).
+     *
+     * Technical, Economic, and Risk experts synthesize an assessment
+     * of the provided text.
+     *
+     * @param text - The text or topic to analyze.
+     * @param type - Analysis type: "comprehensive" | "technical" | "economic" | "risk". Defaults to "comprehensive".
+     * @returns Multi-perspective analysis with payment receipt.
+     *
+     * @example
+     * ```ts
+     * const analysis = await client.analyze("Impact of spot Bitcoin ETFs on altcoin markets");
+     * console.log(analysis.result);
+     * ```
+     */
+    analyze(text: string, type?: "comprehensive" | "technical" | "economic" | "risk"): Promise<AnalyzeResponse>;
+    /**
+     * Single AI agent execution ($0.02).
+     *
+     * Run a single agent with a custom task, model, and system prompt.
+     *
+     * @param task - The task for the agent to complete.
+     * @param options - Optional agent configuration.
+     * @param options.model - LLM model name (e.g. "gpt-4o-mini", "gpt-4o"). Defaults to "gpt-4o-mini".
+     * @param options.systemPrompt - Custom system prompt for the agent.
+     * @param options.agentName - Custom agent name. Defaults to "x402-agent".
+     * @returns Agent output with payment receipt.
+     *
+     * @example
+     * ```ts
+     * const result = await client.runAgent("Summarize the top 5 DeFi protocols by TVL");
+     * console.log(result.result);
+     * ```
+     */
+    runAgent(task: string, options?: {
+        model?: string;
+        systemPrompt?: string;
+        agentName?: string;
+    }): Promise<AgentResponse>;
+    /**
+     * Solana wallet analyzer ($0.01).
+     *
+     * Returns SOL balance, token holdings with USD values, and recent activity
+     * for any Solana wallet.
+     *
+     * @param address - Solana wallet address (base58, 32-44 chars).
+     * @returns Wallet analysis with payment receipt.
+     *
+     * @example
+     * ```ts
+     * const wallet = await client.analyzeWallet("So11111111111111111111111111111112");
+     * console.log(`SOL balance: ${wallet.solBalance}`);
+     * console.log(`Tokens held: ${wallet.tokenCount}`);
+     * ```
+     */
+    analyzeWallet(address: string): Promise<WalletAnalysisResponse>;
+    /**
+     * AI text summarization ($0.01).
+     *
+     * @param text - The text to summarize.
+     * @param maxLength - Maximum summary length in words. Defaults to 200.
+     * @returns Summary with word count and payment receipt.
+     *
+     * @example
+     * ```ts
+     * const result = await client.summarize("Long article text here...", 100);
+     * console.log(result.summary);
+     * ```
+     */
+    summarize(text: string, maxLength?: number): Promise<SummarizeResponse>;
+    /**
+     * AI text translation ($0.02).
+     *
+     * Auto-detects source language and translates to the target language.
+     *
+     * @param text - The text to translate.
+     * @param targetLanguage - Target language name (e.g. "Spanish", "Japanese", "French").
+     * @returns Translation with detected source language and payment receipt.
+     *
+     * @example
+     * ```ts
+     * const result = await client.translate("Hello, world!", "Spanish");
+     * console.log(result.translation); // "Hola, mundo!"
+     * ```
+     */
+    translate(text: string, targetLanguage: string): Promise<TranslateResponse>;
+    /**
+     * Multi-agent code review ($0.03).
+     *
+     * Runs SecurityAuditor, PerformanceReviewer, and StyleChecker agents
+     * in parallel on the provided code.
+     *
+     * @param code - The code to review.
+     * @param language - Programming language hint (e.g. "TypeScript", "Solidity"). Auto-detected if omitted.
+     * @returns Security, performance, and style findings with payment receipt.
+     *
+     * @example
+     * ```ts
+     * const review = await client.codeReview("function add(a, b) { return a + b; }", "JavaScript");
+     * console.log(review.rawOutput);
+     * ```
+     */
+    codeReview(code: string, language?: string): Promise<CodeReviewResponse>;
+    /**
+     * Multi-agent content writing ($0.03).
+     *
+     * Runs a ResearchPipeline (Researcher + FactChecker + Writer) to produce
+     * well-researched content on any topic.
+     *
+     * @param topic - The topic to write about.
+     * @param options - Optional style and length settings.
+     * @param options.style - Writing style (e.g. "professional", "casual", "academic"). Defaults to "professional".
+     * @param options.length - Content length: "short" | "medium" | "long". Defaults to "medium".
+     * @returns Written content with word count and payment receipt.
+     *
+     * @example
+     * ```ts
+     * const article = await client.write("Zero-knowledge proofs explained", { style: "casual", length: "short" });
+     * console.log(article.content);
+     * ```
+     */
+    write(topic: string, options?: {
+        style?: string;
+        length?: string;
+    }): Promise<WriteResponse>;
+    /**
+     * Multi-agent debate ($0.03).
+     *
+     * Runs Proponent, Opponent, and Judge agents to debate a proposition
+     * and deliver a verdict with confidence.
+     *
+     * @param proposition - The statement or question to debate.
+     * @returns Pro/con arguments, verdict, and confidence with payment receipt.
+     *
+     * @example
+     * ```ts
+     * const result = await client.debate("Should companies adopt a 4-day work week?");
+     * console.log(result.rawOutput);
+     * ```
+     */
+    debate(proposition: string): Promise<DebateResponse>;
+    /**
+     * Structured data extraction ($0.01).
+     *
+     * Extracts specified fields from unstructured text using AI.
+     *
+     * @param text - The unstructured text to extract data from.
+     * @param fields - Array of field names to extract (e.g. ["name", "email", "company"]).
+     * @returns Extracted key-value pairs and payment receipt.
+     *
+     * @example
+     * ```ts
+     * const result = await client.extract(
+     *   "Contact John Smith at john@example.com, he works at Acme Corp.",
+     *   ["name", "email", "company"]
+     * );
+     * console.log(result.extracted); // { name: "John Smith", email: "john@example.com", company: "Acme Corp." }
+     * ```
+     */
+    extract(text: string, fields: string[]): Promise<ExtractResponse>;
+    /**
+     * AI sentiment analysis ($0.01).
+     *
+     * Analyzes the sentiment of the given text and returns a classification
+     * with confidence score and reasoning.
+     *
+     * @param text - The text to analyze sentiment for.
+     * @returns Sentiment classification, confidence (0-1), reasoning, and payment receipt.
+     *
+     * @example
+     * ```ts
+     * const result = await client.sentiment("I absolutely love this product!");
+     * console.log(result.sentiment);   // "positive"
+     * console.log(result.confidence);  // 0.95
+     * ```
+     */
+    sentiment(text: string): Promise<SentimentResponse>;
+    /**
+     * Multi-agent smart contract pre-audit ($0.50).
+     *
+     * Runs SecurityAuditor, EconomicAttacker, GasOptimizer, and AuditReporter agents
+     * concurrently to produce a structured risk report.
+     *
+     * @param code - The smart contract source code to audit.
+     * @param language - Contract language: "solidity" | "rust" | "anchor". Defaults to "solidity".
+     * @returns Audit report with risk score, categorized findings, and payment receipt.
+     *
+     * @example
+     * ```ts
+     * const audit = await client.contractAudit("pragma solidity ^0.8.0; ...", "solidity");
+     * console.log(`Risk score: ${audit.riskScore}/100`);
+     * ```
+     */
+    contractAudit(code: string, language?: string): Promise<ContractAuditResponse>;
+    /**
+     * Multi-agent token risk assessment ($0.05).
+     *
+     * Runs ContractScanner, TokenomicsAnalyzer, and RiskVerdict agents
+     * sequentially to score a token as SAFE/CAUTION/DANGER.
+     *
+     * @param mint - Token mint/contract address.
+     * @param chain - Blockchain: "solana" | "evm". Defaults to "solana".
+     * @returns Risk verdict with score, findings, and payment receipt.
+     *
+     * @example
+     * ```ts
+     * const risk = await client.tokenRisk("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
+     * console.log(`Verdict: ${risk.verdict}`);
+     * ```
+     */
+    tokenRisk(mint: string, chain?: string): Promise<TokenRiskResponse>;
+    /**
+     * Multi-agent DAO proposal analysis ($0.10).
+     *
+     * Runs EconomicAnalyst, TechnicalReviewer, RiskAssessor, and VoteSummarizer
+     * agents via MixtureOfAgents to produce a voting recommendation.
+     *
+     * @param proposal - The DAO proposal text to analyze.
+     * @param daoName - Optional DAO name for context.
+     * @returns Voting recommendation with confidence, analysis breakdown, and payment receipt.
+     *
+     * @example
+     * ```ts
+     * const dao = await client.daoAnalyze("Increase staking rewards by 5%", "Jito");
+     * console.log(`Recommendation: ${dao.recommendation} (${dao.confidence}% confidence)`);
+     * ```
+     */
+    daoAnalyze(proposal: string, daoName?: string): Promise<DaoAnalyzeResponse>;
+    /**
+     * List all available endpoints with pricing (free).
+     *
+     * @returns Array of service catalog entries.
+     *
+     * @example
+     * ```ts
+     * const services = await client.getCatalog();
+     * services.forEach(s => console.log(`${s.name}: $${s.priceUsd}`));
+     * ```
+     */
+    getCatalog(): Promise<CatalogEntry[]>;
+    /**
+     * Platform health check with revenue stats (free).
+     *
+     * @returns Health status, receive address, network, and revenue info.
+     *
+     * @example
+     * ```ts
+     * const health = await client.getHealth();
+     * console.log(`Status: ${health.status}, Revenue: $${health.totalRevenue}`);
+     * ```
+     */
+    getHealth(): Promise<HealthResponse>;
+    /**
+     * Wallet analyzer health check (free).
+     *
+     * @returns Wallet analyzer status and configuration.
+     *
+     * @example
+     * ```ts
+     * const health = await client.getWalletAnalyzerHealth();
+     * console.log(`Helius configured: ${health.heliusConfigured}`);
+     * ```
+     */
+    getWalletAnalyzerHealth(): Promise<WalletAnalyzerHealthResponse>;
+}
+/**
+ * Create an x402-swarms client.
+ *
+ * Convenience factory — identical to `new X402SwarmsClient(config)`.
+ *
+ * @param config - Client configuration (wallet key + optional base URL).
+ * @returns Configured client instance.
+ *
+ * @example
+ * ```ts
+ * import { createClient } from "@elizaos/plugin-x402-swarms/client";
+ *
+ * const client = createClient({
+ *   walletPrivateKey: process.env.SOLANA_PRIVATE_KEY,
+ * });
+ *
+ * // One-liner research
+ * const report = await client.research("Zero-knowledge rollups comparison");
+ * ```
+ */
+export declare function createClient(config: X402SwarmsClientConfig): X402SwarmsClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

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