@itachisol/plugin-x402-swarms 0.1.0

package/dist/server/x402ServerService.d.ts

@@ -0,0 +1,30 @@
+import { Service, type IAgentRuntime } from "@elizaos/core";
+import { type X402Server } from "@dexterai/x402/server";
+import type { X402RevenueRecord } from "../types.js";
+/**
+ * Server-side x402 service for SELLING agent capabilities.
+ * Manages payment verification and settlement for incoming requests.
+ */
+export declare class X402ServerService extends Service {
+    static serviceType: string;
+    capabilityDescription: string;
+    private x402Server;
+    private revenueHistory;
+    private receiveAddress;
+    private network;
+    static start(runtime: IAgentRuntime): Promise<X402ServerService>;
+    stop(): Promise<void>;
+    initialize(runtime: IAgentRuntime): Promise<void>;
+    isAvailable(): boolean;
+    getServer(): X402Server;
+    getReceiveAddress(): string;
+    getNetwork(): string;
+    /**
+     * Record a successful incoming payment.
+     */
+    recordRevenue(record: X402RevenueRecord): void;
+    getRevenueHistory(): X402RevenueRecord[];
+    getTotalRevenueUsd(): number;
+    getSettlementCount(): number;
+}
+//# sourceMappingURL=x402ServerService.d.ts.map

package/dist/server/x402ServerService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402ServerService.d.ts","sourceRoot":"","sources":["../../src/server/x402ServerService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAuB,MAAM,aAAa,CAAC;AAE1E;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,OAAO;IAC5C,MAAM,CAAC,WAAW,SAAiB;IACnC,qBAAqB,SACsE;IAE3F,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,OAAO,CAAc;WAEhB,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAMhE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCvD,WAAW,IAAI,OAAO;IAItB,SAAS,IAAI,UAAU;IAOvB,iBAAiB,IAAI,MAAM;IAI3B,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAI9C,iBAAiB,IAAI,iBAAiB,EAAE;IAIxC,kBAAkB,IAAI,MAAM;IAI5B,kBAAkB,IAAI,MAAM;CAG7B"}

package/dist/server/x402ServerService.js

@@ -0,0 +1,79 @@
+import { Service } from "@elizaos/core";
+import { createX402Server } from "@dexterai/x402/server";
+/**
+ * Server-side x402 service for SELLING agent capabilities.
+ * Manages payment verification and settlement for incoming requests.
+ */
+export class X402ServerService extends Service {
+    static serviceType = "X402_SERVER";
+    capabilityDescription = "Accepts x402 payments for agent services — verifies and settles incoming USDC payments";
+    x402Server = null;
+    revenueHistory = [];
+    receiveAddress = "";
+    network = "";
+    static async start(runtime) {
+        const instance = new X402ServerService(runtime);
+        await instance.initialize(runtime);
+        return instance;
+    }
+    async stop() {
+        this.x402Server = null;
+    }
+    async initialize(runtime) {
+        const receiveAddr = runtime.getSetting("X402_RECEIVE_ADDRESS");
+        if (!receiveAddr) {
+            runtime.logger.info("[X402ServerService] X402_RECEIVE_ADDRESS not set. Sell-side features disabled.");
+            return;
+        }
+        this.receiveAddress = String(receiveAddr);
+        const networkRaw = runtime.getSetting("X402_NETWORK_ID");
+        const facilitatorRaw = runtime.getSetting("X402_FACILITATOR_URL");
+        // Map friendly network ID to CAIP-2
+        const networkMap = {
+            "base-mainnet": "eip155:8453",
+            "base-sepolia": "eip155:84532",
+            "ethereum-mainnet": "eip155:1",
+            "solana-mainnet": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+            "polygon-mainnet": "eip155:137",
+            "arbitrum-mainnet": "eip155:42161",
+        };
+        this.network = networkMap[String(networkRaw ?? "base-mainnet")] ?? "eip155:8453";
+        this.x402Server = createX402Server({
+            payTo: this.receiveAddress,
+            network: this.network,
+            facilitatorUrl: facilitatorRaw ? String(facilitatorRaw) : undefined,
+        });
+        runtime.logger.info({ receiveAddress: this.receiveAddress, network: this.network }, "[X402ServerService] Initialized — accepting x402 payments");
+    }
+    isAvailable() {
+        return this.x402Server !== null;
+    }
+    getServer() {
+        if (!this.x402Server) {
+            throw new Error("X402 server not initialized — set X402_RECEIVE_ADDRESS");
+        }
+        return this.x402Server;
+    }
+    getReceiveAddress() {
+        return this.receiveAddress;
+    }
+    getNetwork() {
+        return this.network;
+    }
+    /**
+     * Record a successful incoming payment.
+     */
+    recordRevenue(record) {
+        this.revenueHistory.push(record);
+    }
+    getRevenueHistory() {
+        return [...this.revenueHistory];
+    }
+    getTotalRevenueUsd() {
+        return this.revenueHistory.reduce((sum, r) => sum + r.amountUsd, 0);
+    }
+    getSettlementCount() {
+        return this.revenueHistory.length;
+    }
+}
+//# sourceMappingURL=x402ServerService.js.map

package/dist/server/x402ServerService.js.map

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

package/dist/services/paymentMemoryService.d.ts

@@ -0,0 +1,73 @@
+import { Service, type IAgentRuntime } from "@elizaos/core";
+import type { PaymentHistoryRecord } from "../types.js";
+/**
+ * Unscored payment awaiting quality evaluation.
+ */
+export interface UnscoredPayment {
+    recordId: string;
+    endpoint: string;
+    domain: string;
+    responseStatus: number;
+    responseTimeMs: number;
+    responsePreview: string;
+}
+/**
+ * Spending stats for a time period.
+ */
+export interface SpendingStats {
+    totalSpent: number;
+    totalCalls: number;
+    period: string;
+}
+/**
+ * Records payment history, maintains an unscored buffer for the evaluator,
+ * and provides spending analytics. Gracefully degrades to in-memory only
+ * when no database is available.
+ */
+export declare class PaymentMemoryService extends Service {
+    static serviceType: string;
+    capabilityDescription: string;
+    private agentRuntime;
+    private history;
+    private unscoredBuffer;
+    private hasDb;
+    static start(runtime: IAgentRuntime): Promise<PaymentMemoryService>;
+    stop(): Promise<void>;
+    initialize(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Record a completed payment.
+     * Flow: sanitize → store in memory → add to unscored buffer → persist to DB (fire-and-forget)
+     */
+    recordPayment(record: PaymentHistoryRecord): Promise<void>;
+    /**
+     * Get unscored payments for the evaluator to process.
+     */
+    getUnscoredPayments(limit?: number): UnscoredPayment[];
+    /**
+     * Mark a payment as scored (update quality in memory and DB).
+     */
+    scorePayment(recordId: string, qualityScore: number, qualityReason: string): Promise<void>;
+    /**
+     * Upsert endpoint aggregate scores.
+     */
+    updateEndpointScore(agentId: string, domain: string, amountUsd: number, responseTimeMs: number, qualityScore: number, isError: boolean): Promise<void>;
+    /**
+     * Get spending stats for a time period.
+     */
+    getSpendingStats(period: "24h" | "7d" | "30d"): SpendingStats;
+    /**
+     * Get payments by domain for quality lookup.
+     */
+    getPaymentsByDomain(domain: string): PaymentHistoryRecord[];
+    /**
+     * Get all endpoint scores from memory (for provider context).
+     */
+    getEndpointScoreSummary(): Array<{
+        domain: string;
+        avgQuality: number;
+        avgCostPerCall: number;
+        totalCalls: number;
+    }>;
+    getHistory(): PaymentHistoryRecord[];
+}
+//# sourceMappingURL=paymentMemoryService.d.ts.map

package/dist/services/paymentMemoryService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paymentMemoryService.d.ts","sourceRoot":"","sources":["../../src/services/paymentMemoryService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,OAAO;IAC/C,MAAM,CAAC,WAAW,SAAoB;IACtC,qBAAqB,SACuE;IAE5F,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,KAAK,CAAS;WAET,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAMnE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBvD;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiEhE;;OAEG;IACH,mBAAmB,CAAC,KAAK,SAAI,GAAG,eAAe,EAAE;IAIjD;;OAEG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;IA0BhB;;OAEG;IACG,mBAAmB,CACvB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;IA6DhB;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,aAAa;IAa7D;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAI3D;;OAEG;IACH,uBAAuB,IAAI,KAAK,CAAC;QAC/B,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAuCF,UAAU,IAAI,oBAAoB,EAAE;CAGrC"}

package/dist/services/paymentMemoryService.js

@@ -0,0 +1,247 @@
+import { Service } from "@elizaos/core";
+/**
+ * Records payment history, maintains an unscored buffer for the evaluator,
+ * and provides spending analytics. Gracefully degrades to in-memory only
+ * when no database is available.
+ */
+export class PaymentMemoryService extends Service {
+    static serviceType = "PAYMENT_MEMORY";
+    capabilityDescription = "Persists payment history across sessions, enables quality scoring and cost optimization";
+    agentRuntime = null;
+    history = [];
+    unscoredBuffer = [];
+    hasDb = false;
+    static async start(runtime) {
+        const instance = new PaymentMemoryService(runtime);
+        await instance.initialize(runtime);
+        return instance;
+    }
+    async stop() {
+        this.agentRuntime = null;
+    }
+    async initialize(runtime) {
+        this.agentRuntime = runtime;
+        // Check if DB is available
+        try {
+            const db = runtime.databaseAdapter?.db;
+            this.hasDb = !!db;
+        }
+        catch {
+            this.hasDb = false;
+        }
+        runtime.logger.info({ hasDb: this.hasDb }, "[PaymentMemoryService] Initialized");
+    }
+    /**
+     * Record a completed payment.
+     * Flow: sanitize → store in memory → add to unscored buffer → persist to DB (fire-and-forget)
+     */
+    async recordPayment(record) {
+        // Step 1: Sanitize on a shallow copy so we never mutate the caller's object
+        const sanitized = { ...record };
+        if (!Number.isFinite(sanitized.amountUsd)) {
+            sanitized.amountUsd = 0;
+        }
+        if (sanitized.endpoint && sanitized.endpoint.length > 2048) {
+            sanitized.endpoint = sanitized.endpoint.slice(0, 2048);
+        }
+        if (sanitized.responsePreview && sanitized.responsePreview.length > 2048) {
+            sanitized.responsePreview = sanitized.responsePreview.slice(0, 2048);
+        }
+        // Always store in memory (the sanitized copy)
+        this.history.push(sanitized);
+        // Prune old records to prevent unbounded memory growth
+        if (this.history.length > 10000) {
+            this.history = this.history.slice(-10000);
+        }
+        // Add to unscored buffer if we have response data
+        if (sanitized.responsePreview) {
+            this.unscoredBuffer.push({
+                recordId: sanitized.id,
+                endpoint: sanitized.endpoint,
+                domain: sanitized.domain,
+                responseStatus: sanitized.responseStatus ?? 200,
+                responseTimeMs: sanitized.responseTimeMs ?? 0,
+                responsePreview: sanitized.responsePreview,
+            });
+        }
+        // Try to persist to DB
+        if (this.hasDb && this.agentRuntime) {
+            try {
+                const db = this.agentRuntime.databaseAdapter?.db;
+                if (db) {
+                    const { x402PaymentHistory } = await import("../schemas/paymentHistory.js");
+                    await db.insert(x402PaymentHistory).values({
+                        id: sanitized.id,
+                        agentId: sanitized.agentId,
+                        endpoint: sanitized.endpoint,
+                        domain: sanitized.domain,
+                        method: sanitized.method,
+                        amountUsd: sanitized.amountUsd,
+                        txHash: sanitized.txHash,
+                        network: sanitized.network ?? null,
+                        payer: sanitized.payer ?? null,
+                        status: sanitized.status,
+                        responseStatus: sanitized.responseStatus ?? null,
+                        responseTimeMs: sanitized.responseTimeMs ?? null,
+                        responsePreview: sanitized.responsePreview ?? null,
+                    });
+                }
+            }
+            catch (err) {
+                // DB write failed — data is still in memory
+                this.agentRuntime?.logger.debug({ error: err instanceof Error ? err.message : String(err) }, "[PaymentMemoryService] DB write failed, using in-memory only");
+            }
+        }
+    }
+    /**
+     * Get unscored payments for the evaluator to process.
+     */
+    getUnscoredPayments(limit = 3) {
+        return this.unscoredBuffer.splice(0, limit);
+    }
+    /**
+     * Mark a payment as scored (update quality in memory and DB).
+     */
+    async scorePayment(recordId, qualityScore, qualityReason) {
+        // Update in-memory record
+        const record = this.history.find((r) => r.id === recordId);
+        if (record) {
+            record.qualityScore = qualityScore;
+            record.qualityReason = qualityReason;
+        }
+        // Try to update DB
+        if (this.hasDb && this.agentRuntime) {
+            try {
+                const db = this.agentRuntime.databaseAdapter?.db;
+                if (db) {
+                    const { x402PaymentHistory } = await import("../schemas/paymentHistory.js");
+                    const { eq } = await import("drizzle-orm");
+                    await db
+                        .update(x402PaymentHistory)
+                        .set({ qualityScore, qualityReason })
+                        .where(eq(x402PaymentHistory.id, recordId));
+                }
+            }
+            catch {
+                // DB update failed — in-memory is updated
+            }
+        }
+    }
+    /**
+     * Upsert endpoint aggregate scores.
+     */
+    async updateEndpointScore(agentId, domain, amountUsd, responseTimeMs, qualityScore, isError) {
+        if (!this.hasDb || !this.agentRuntime)
+            return;
+        try {
+            const db = this.agentRuntime.databaseAdapter?.db;
+            if (!db)
+                return;
+            const { x402EndpointScores } = await import("../schemas/endpointScores.js");
+            const { eq, and, sql } = await import("drizzle-orm");
+            // Try to find existing record
+            const existing = await db
+                .select()
+                .from(x402EndpointScores)
+                .where(and(eq(x402EndpointScores.agentId, agentId), eq(x402EndpointScores.domain, domain)))
+                .limit(1);
+            if (existing.length > 0) {
+                const row = existing[0];
+                const newCount = (row.totalCalls ?? 0) + 1;
+                const oldAvg = row.avgQualityScore ?? qualityScore;
+                const newAvg = ((oldAvg * (row.totalCalls ?? 0)) + qualityScore) / newCount;
+                const oldTimeAvg = row.avgResponseTimeMs ?? responseTimeMs;
+                const newTimeAvg = ((oldTimeAvg * (row.totalCalls ?? 0)) + responseTimeMs) / newCount;
+                await db
+                    .update(x402EndpointScores)
+                    .set({
+                    totalCalls: newCount,
+                    totalSpentUsd: (row.totalSpentUsd ?? 0) + amountUsd,
+                    avgQualityScore: newAvg,
+                    avgResponseTimeMs: newTimeAvg,
+                    errorCount: (row.errorCount ?? 0) + (isError ? 1 : 0),
+                    lastCallAt: new Date(),
+                    updatedAt: new Date(),
+                })
+                    .where(eq(x402EndpointScores.id, row.id));
+            }
+            else {
+                await db.insert(x402EndpointScores).values({
+                    id: crypto.randomUUID(),
+                    agentId,
+                    domain,
+                    totalCalls: 1,
+                    totalSpentUsd: amountUsd,
+                    avgQualityScore: qualityScore,
+                    avgResponseTimeMs: responseTimeMs,
+                    errorCount: isError ? 1 : 0,
+                    lastCallAt: new Date(),
+                    updatedAt: new Date(),
+                });
+            }
+        }
+        catch {
+            // Aggregation failed — not critical
+        }
+    }
+    /**
+     * Get spending stats for a time period.
+     */
+    getSpendingStats(period) {
+        const now = Date.now();
+        const msMap = { "24h": 86400000, "7d": 604800000, "30d": 2592000000 };
+        const cutoff = now - msMap[period];
+        const inRange = this.history.filter((r) => r.createdAt >= cutoff);
+        return {
+            totalSpent: inRange.reduce((sum, r) => sum + r.amountUsd, 0),
+            totalCalls: inRange.length,
+            period,
+        };
+    }
+    /**
+     * Get payments by domain for quality lookup.
+     */
+    getPaymentsByDomain(domain) {
+        return this.history.filter((r) => r.domain === domain);
+    }
+    /**
+     * Get all endpoint scores from memory (for provider context).
+     */
+    getEndpointScoreSummary() {
+        const byDomain = new Map();
+        for (const record of this.history) {
+            const existing = byDomain.get(record.domain) ?? {
+                totalQuality: 0,
+                totalCost: 0,
+                count: 0,
+                scoredCount: 0,
+            };
+            existing.totalCost += record.amountUsd;
+            existing.count += 1;
+            if (record.qualityScore != null) {
+                existing.totalQuality += record.qualityScore;
+                existing.scoredCount += 1;
+            }
+            byDomain.set(record.domain, existing);
+        }
+        return Array.from(byDomain.entries())
+            .map(([domain, stats]) => ({
+            domain,
+            avgQuality: stats.scoredCount > 0
+                ? stats.totalQuality / stats.scoredCount
+                : 0,
+            avgCostPerCall: stats.totalCost / stats.count,
+            totalCalls: stats.count,
+        }))
+            .sort((a, b) => {
+            // Sort by quality/cost ratio (best value first)
+            const aRatio = a.avgQuality / Math.max(a.avgCostPerCall, 0.001);
+            const bRatio = b.avgQuality / Math.max(b.avgCostPerCall, 0.001);
+            return bRatio - aRatio;
+        });
+    }
+    getHistory() {
+        return [...this.history];
+    }
+}
+//# sourceMappingURL=paymentMemoryService.js.map

package/dist/services/paymentMemoryService.js.map

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

package/dist/services/swarmsService.d.ts

@@ -0,0 +1,66 @@
+import { Service, type IAgentRuntime } from "@elizaos/core";
+import type { AgentSpec, SwarmRunParams } from "swarms-ts/resources";
+export type SwarmType = NonNullable<SwarmRunParams["swarm_type"]>;
+/**
+ * Response from /v1/agent/completions
+ */
+export interface AgentRunResponse {
+    job_id?: string;
+    success?: boolean;
+    name?: string;
+    outputs?: Array<{
+        role?: string;
+        content?: string;
+    }>;
+    output?: string;
+    usage?: {
+        total_tokens?: number;
+        total_cost?: number;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Response from /v1/swarm/completions
+ */
+export interface SwarmRunResponse {
+    job_id?: string;
+    status?: string;
+    swarm_name?: string;
+    swarm_type?: string;
+    output?: unknown;
+    number_of_agents?: number;
+    execution_time?: number;
+    usage?: {
+        total_cost?: number;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Wraps the Swarms API for multi-agent orchestration.
+ * Uses direct fetch to api.swarms.world/v1/* endpoints.
+ */
+export declare class SwarmsService extends Service {
+    static serviceType: string;
+    capabilityDescription: string;
+    private apiKey;
+    static start(runtime: IAgentRuntime): Promise<SwarmsService>;
+    stop(): Promise<void>;
+    initialize(runtime: IAgentRuntime): Promise<void>;
+    isAvailable(): boolean;
+    private apiCall;
+    /**
+     * Run a single agent with the Swarms API.
+     * Endpoint: POST /v1/agent/completions
+     */
+    runAgent(config: AgentSpec, task: string): Promise<AgentRunResponse>;
+    /**
+     * Run a multi-agent swarm.
+     * Endpoint: POST /v1/swarm/completions
+     */
+    runSwarm(params: SwarmRunParams): Promise<SwarmRunResponse>;
+    /**
+     * List available swarm types from the API.
+     */
+    getAvailableSwarmTypes(): Promise<string[]>;
+}
+//# sourceMappingURL=swarmsService.d.ts.map

package/dist/services/swarmsService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarmsService.d.ts","sourceRoot":"","sources":["../../src/services/swarmsService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACf,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;AAKlE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACxC,MAAM,CAAC,WAAW,SAAY;IAC9B,qBAAqB,SAC+G;IAEpI,OAAO,CAAC,MAAM,CAAuB;WAExB,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAM5D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvD,WAAW,IAAI,OAAO;YAIR,OAAO;IAuBrB;;;OAGG;IACG,QAAQ,CACZ,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,CAAC;IAa5B;;;OAGG;IACG,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAWjE;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAclD"}

package/dist/services/swarmsService.js

@@ -0,0 +1,102 @@
+import { Service } from "@elizaos/core";
+// The swarms-ts SDK has outdated endpoints. We call the API directly.
+const SWARMS_API_BASE = "https://api.swarms.world";
+/**
+ * Wraps the Swarms API for multi-agent orchestration.
+ * Uses direct fetch to api.swarms.world/v1/* endpoints.
+ */
+export class SwarmsService extends Service {
+    static serviceType = "SWARMS";
+    capabilityDescription = "Multi-agent orchestration via Swarms API — sequential, concurrent, hierarchical, mixture-of-agents, and 15+ swarm architectures";
+    apiKey = null;
+    static async start(runtime) {
+        const instance = new SwarmsService(runtime);
+        await instance.initialize(runtime);
+        return instance;
+    }
+    async stop() {
+        this.apiKey = null;
+    }
+    async initialize(runtime) {
+        const apiKey = runtime.getSetting("SWARMS_API_KEY");
+        if (!apiKey) {
+            runtime.logger.warn("[SwarmsService] SWARMS_API_KEY not set. Swarm features disabled.");
+            return;
+        }
+        this.apiKey = String(apiKey);
+        runtime.logger.info("[SwarmsService] Initialized with Swarms API (direct)");
+    }
+    isAvailable() {
+        return this.apiKey !== null;
+    }
+    async apiCall(path, body) {
+        if (!this.apiKey) {
+            throw new Error("Swarms client not initialized — set SWARMS_API_KEY");
+        }
+        const res = await fetch(`${SWARMS_API_BASE}${path}`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-key": this.apiKey,
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(120_000),
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            throw new Error(`Swarms API ${path} returned ${res.status}: ${text.slice(0, 200)}`);
+        }
+        return res.json();
+    }
+    /**
+     * Run a single agent with the Swarms API.
+     * Endpoint: POST /v1/agent/completions
+     */
+    async runAgent(config, task) {
+        const startTime = Date.now();
+        const result = await this.apiCall("/v1/agent/completions", {
+            agent_config: config,
+            task,
+        });
+        const elapsed = Date.now() - startTime;
+        if (elapsed > 30000) {
+            console.warn(`[SwarmsService] runAgent slow: ${elapsed}ms for "${config.agent_name}"`);
+        }
+        return result;
+    }
+    /**
+     * Run a multi-agent swarm.
+     * Endpoint: POST /v1/swarm/completions
+     */
+    async runSwarm(params) {
+        const agentCount = params.agents?.length ?? 0;
+        const startTime = Date.now();
+        const result = await this.apiCall("/v1/swarm/completions", params);
+        const elapsed = Date.now() - startTime;
+        if (elapsed > 60000) {
+            console.warn(`[SwarmsService] runSwarm slow: ${elapsed}ms, ${agentCount} agents, type=${params.swarm_type}`);
+        }
+        return result;
+    }
+    /**
+     * List available swarm types from the API.
+     */
+    async getAvailableSwarmTypes() {
+        if (!this.apiKey)
+            return [];
+        try {
+            const res = await fetch(`${SWARMS_API_BASE}/v1/swarms/available`, {
+                headers: { "x-api-key": this.apiKey },
+                signal: AbortSignal.timeout(10_000),
+            });
+            if (!res.ok)
+                return [];
+            const data = await res.json();
+            return Array.isArray(data.swarm_types) ? data.swarm_types : [];
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=swarmsService.js.map

package/dist/services/swarmsService.js.map

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