@itachisol/plugin-x402-swarms 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ItachiDevv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,323 @@
+# SwarmX (@elizaos/plugin-x402-swarms)
+
+ElizaOS v2 plugin that gives AI agents the ability to **pay for APIs** using the [x402 HTTP payment protocol](https://www.x402.org/) via the [Dexter SDK](https://dexter.cash/) and **orchestrate multi-agent tasks** using [Swarms](https://swarms.world/) — settled in USDC across 5 networks (Base, Ethereum, Solana, Polygon, Arbitrum).
+
+## What This Enables
+
+- **Hire AI agent teams** — code review (3 agents), research (3 agents), multi-angle analysis (4 agents), debate (3 agents) — one API call, one USDC payment
+- **Consume paid APIs autonomously** — agent detects HTTP 402, pays with USDC via Dexter SDK, retries automatically
+- **Discover x402 services** — browse the [OpenDexter marketplace](https://dexter.cash/opendexter) of pay-per-call AI/data APIs
+- **Delegate to Swarms** — route complex tasks to multi-agent systems (15+ architectures) via the Swarms cloud API
+- **Delegate with x402 data** — combine x402 data fetching with swarm analysis in a single action
+- **Run single agents** — execute focused tasks with a specific agent role via Swarms
+- **Sell agent services** — expose your agent's capabilities as x402-gated HTTP endpoints
+- **Budget controls** — per-request, per-hour, and total session spending limits with persistent DB state
+- **Access Passes** — time-limited unlimited access for frequently-used endpoints
+
+## Featured Endpoints
+
+| Endpoint | Team | Agents | Price | What You Get |
+|----------|------|--------|-------|--------------|
+| `POST /x402/code-review` | **Code Review** | Security Auditor + Performance Reviewer + Style Checker | $0.03 | Three specialists audit your code in parallel — security, performance, and style — merged into one report |
+| `POST /x402/research` | **Deep Research** | Researcher → Fact Checker → Writer | $0.05 | A pipeline that investigates any topic, verifies claims, and delivers a polished report |
+| `POST /x402/analyze` | **Multi-Angle Analysis** | Technical + Economic + Risk → Synthesizer | $0.03 | Four domain experts analyze your topic from every angle, then synthesize actionable intelligence |
+| `POST /x402/debate` | **Debate & Decide** | Proponent + Opponent + Judge | $0.03 | Two agents argue opposing sides while a neutral judge weighs evidence and delivers a verdict |
+
+All endpoints accept JSON via HTTP POST and settle payments in USDC via the x402 protocol. 3 free calls/day — no wallet needed to start.
+
+## Architecture
+
+See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for the full system diagram.
+
+See [docs/TOKENOMICS.md](docs/TOKENOMICS.md) for the economic model.
+
+## Quick Start
+
+### 1. Install
+
+```bash
+bun add @elizaos/plugin-x402-swarms
+```
+
+### 2. Configure
+
+```bash
+cp .env.example .env
+# Fill in: EVM_PRIVATE_KEY (or SOLANA_PRIVATE_KEY), OPENAI_API_KEY (or ANTHROPIC_API_KEY)
+# Optional: SWARMS_API_KEY for multi-agent features
+```
+
+### 3. Add to Your Agent (ElizaOS v2)
+
+```typescript
+import type { Project, ProjectAgent } from "@elizaos/core";
+import { x402SwarmsPlugin } from "@elizaos/plugin-x402-swarms";
+
+const character = {
+  name: "PayAgent",
+  bio: ["An AI agent that can pay for APIs and orchestrate multi-agent tasks."],
+  system: "You are PayAgent. Use DISCOVER_X402_SERVICES to find paid APIs, PAY_FOR_X402_SERVICE to access them, DELEGATE_TO_SWARM for multi-agent tasks, or RUN_SWARM_AGENT for single-agent tasks.",
+  plugins: [],
+  settings: {
+    EVM_PRIVATE_KEY: process.env.EVM_PRIVATE_KEY ?? "",
+    X402_NETWORK_ID: "base-sepolia",
+    X402_MAX_AUTO_PAY_USD: "0.10",
+    X402_BUDGET_USD: "10.00",
+    SWARMS_API_KEY: process.env.SWARMS_API_KEY ?? "",
+    OPENAI_API_KEY: process.env.OPENAI_API_KEY ?? "",
+  },
+};
+
+const agent: ProjectAgent = { character, plugins: [x402SwarmsPlugin] };
+export const project: Project = { agents: [agent] };
+export default project;
+```
+
+### 4. Run
+
+```bash
+# As an ElizaOS project:
+elizaos start
+
+# Or run the standalone demo:
+bun run example
+```
+
+### 5. Chat with Your Agent
+
+```
+You: What x402 services are available?
+Agent: Found 5 x402 service(s) on OpenDexter:
+  WETH On-Chain Price ($0.01/call), Solana Token Price ($0.01/call)...
+
+You: Access the x402 endpoint at https://pro-api.coingecko.com/api/v3/x402/onchain/simple/net
+Agent: Access successful.
+- Endpoint: GET https://pro-api.coingecko.com/...
+- Amount paid: $0.0100 USDC
+- Tx: 5abc...xyz (eip155:84532)
+- Remaining budget: $9.99
+
+You: Use the swarm to analyze top DeFi protocols and summarize risks
+Agent: Swarm completed (SequentialWorkflow)
+Agents: 2, Execution time: 12.3s
+Result: [detailed analysis]...
+
+You: Run a code review agent to check this smart contract
+Agent: Agent "CodeReviewer" completed.
+[detailed review]...
+```
+
+## Plugin Components
+
+| Component | Type | Name | Purpose |
+|-----------|------|------|---------|
+| Action | | `PAY_FOR_X402_SERVICE` | Access x402-protected APIs with automatic USDC payment |
+| Action | | `DISCOVER_X402_SERVICES` | Browse OpenDexter marketplace for paid APIs |
+| Action | | `DELEGATE_TO_SWARM` | Delegate to 15+ multi-agent swarm architectures |
+| Action | | `RUN_SWARM_AGENT` | Run a single specialized agent via Swarms |
+| Action | | `DELEGATE_TO_SWARM_WITH_PAYMENT` | Fetch x402 data then feed it into a swarm analysis |
+| Provider | | `X402_PAYMENT_CONTEXT` | Injects wallet/budget/spending into LLM prompt |
+| Provider | | `X402_SERVER_CONTEXT` | Injects sell-side revenue and endpoint catalog into LLM prompt |
+| Evaluator | | `PAYMENT_EVALUATOR` | Warns at >80% budget usage, logs summaries |
+| Service | | `X402WalletService` | Dexter SDK wallet with budget controls |
+| Service | | `SwarmsService` | swarms-ts SDK wrapper for agent/swarm runs |
+| Service | | `X402ServerService` | Server-side x402 gate for selling agent services |
+| Service | | `PaymentMemoryService` | Persistent payment history and endpoint scoring |
+
+## Routes
+
+The plugin registers 5 HTTP routes for selling agent capabilities via x402 micropayments:
+
+| Route | Method | Price | Description |
+|-------|--------|-------|-------------|
+| `/x402/research` | POST | $0.05 | Multi-agent research pipeline (Researcher + FactChecker + Writer) |
+| `/x402/analyze` | POST | $0.03 | Multi-perspective analysis panel (Technical + Economic + Risk experts) |
+| `/x402/agent` | POST | $0.02 | Run a single AI agent with custom task, model, and system prompt |
+| `/x402/catalog` | GET | FREE | List all available paid endpoints with pricing |
+| `/x402/health` | GET | FREE | Service health, revenue stats, and network info |
+
+Paid routes use `x402Gate` to require USDC payment before processing. Free routes are publicly accessible.
+
+## Templates
+
+4 pre-built swarm templates map user intent to specific architectures and agent configurations:
+
+| Template | Swarm Type | Agents | Trigger Examples |
+|----------|-----------|--------|------------------|
+| `ResearchPipeline` | SequentialWorkflow | Researcher, FactChecker, Writer | "research X", "write a report on X" |
+| `AnalysisPanel` | MixtureOfAgents | TechnicalExpert, EconomicExpert, RiskExpert, Synthesizer | "analyze X from multiple perspectives" |
+| `CodeReview` | ConcurrentWorkflow | SecurityAuditor, PerformanceReviewer, StyleChecker | "audit this smart contract", "review this code" |
+| `DebateAndDecide` | MajorityVoting | Proponent, Opponent, Judge | "should I do X?", "pros and cons of X" |
+
+Templates are matched via regex trigger patterns. Custom templates can be registered at runtime with `registerSwarmTemplate()`.
+
+## DB Schemas
+
+3 Drizzle ORM tables provide persistent storage for payment analytics and budget tracking:
+
+| Table | Purpose | Key Columns |
+|-------|---------|-------------|
+| `x402_payment_history` | Every payment the agent makes | endpoint, amountUsd, txHash, network, qualityScore, responseTimeMs |
+| `x402_endpoint_scores` | Aggregate quality scores per domain | totalCalls, totalSpentUsd, avgQualityScore, errorCount |
+| `x402_budget_state` | Cross-session budget state per agent | dailySpentUsd, weeklySpentUsd, monthlySpentUsd, lifetimeSpentUsd |
+
+Schemas are exported as `schema` on the plugin object and auto-migrated by ElizaOS v2.
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `EVM_PRIVATE_KEY` | One of EVM/Solana | — | EVM private key (hex) for Base/Polygon/Arbitrum |
+| `SOLANA_PRIVATE_KEY` | One of EVM/Solana | — | Solana private key (base58) |
+| `X402_NETWORK_ID` | No | `base-mainnet` | Network: `base-mainnet`, `base-sepolia`, `solana-mainnet`, `polygon-mainnet`, `arbitrum-mainnet`, `ethereum-mainnet` |
+| `X402_MAX_AUTO_PAY_USD` | No | `0.10` | Max USDC per auto-pay request |
+| `X402_BUDGET_USD` | No | `10.00` | Total session budget in USD |
+| `X402_RECEIVE_ADDRESS` | No | — | Your address for receiving payments |
+| `X402_ACCESS_PASS_TIER` | No | — | Access pass tier to offer/purchase: `24h` ($1), `7d` ($5), `30d` ($25) |
+| `X402_ACCESS_PASS_MAX_SPEND` | No | `25.00` | Max spend for access pass purchase |
+| `X402_FACILITATOR_URL` | No | Dexter default | Custom facilitator URL |
+| `SWARMS_API_KEY` | For swarms | — | Swarms API key from [swarms.world](https://swarms.world/platform/api-keys) |
+| `OPENAI_API_KEY` | One LLM key | — | OpenAI API key (used directly for single-agent tasks; falls back to Swarms if absent) |
+| `ANTHROPIC_API_KEY` | One LLM key | — | Anthropic API key |
+
+### Access Passes
+
+For data and trading endpoints called at high frequency (100-10K calls/day), per-call x402 pricing adds unacceptable latency (~200-500ms per request for the 402 negotiate/pay/retry cycle). Access passes solve this: buyers pay once for time-limited unlimited access, then all subsequent calls are served at native HTTP latency.
+
+| Tier | Price | Duration |
+|------|-------|----------|
+| Day Pass | $1 | 24 hours |
+| Week Pass | $5 | 7 days |
+| Month Pass | $25 | 30 days |
+
+**Selling passes (operators):** Set `X402_ACCESS_PASS_TIER` in your env to configure which tiers you offer. The Dexter SDK advertises available tiers in the 402 response and handles pass verification internally.
+
+**Buying passes (consumers):** When your agent or bot calls a data endpoint, the 402 response includes access pass options alongside per-call pricing. The Dexter SDK can automatically purchase a pass if `X402_ACCESS_PASS_TIER` is configured (e.g., `24h`, `7d`, `30d`). After purchase, all calls from that wallet are served instantly until expiry.
+
+Per-call pricing ($0.001-$0.10) remains the default for multi-agent AI tasks (research, analyze, debate) where the x402 latency is negligible relative to the task execution time.
+
+See [docs/TOKENOMICS.md](docs/TOKENOMICS.md) for the full access pass economic model.
+
+## How x402 Works
+
+```
+Agent --> GET /data --> 402 Payment Required
+                         |
+               { price: "$0.01", payTo: "0x...", network: "eip155:8453" }
+                         |
+               Dexter SDK: signs USDC transfer, checks budget
+                         |
+Agent --> GET /data (with payment proof) --> 200 OK + data
+```
+
+x402 is an open standard. No API keys, no subscriptions — just HTTP + stablecoins. The Dexter SDK handles the 402 -> sign -> retry flow automatically with budget controls and access pass support. Gas fees are sponsored by the Dexter facilitator.
+
+## Swarm Architectures
+
+The `DELEGATE_TO_SWARM` action supports these architectures (set via `swarmType`):
+
+| Type | Use Case |
+|------|----------|
+| `SequentialWorkflow` | Step-by-step pipelines (research -> write -> edit) |
+| `ConcurrentWorkflow` | Independent parallel tasks |
+| `MixtureOfAgents` | Multiple expert perspectives, synthesized |
+| `HiearchicalSwarm` | Director + workers for complex projects |
+| `GroupChat` | Brainstorming or collaborative discussion |
+| `HeavySwarm` | Deep research requiring thorough investigation |
+| `MajorityVoting` | Decisions needing consensus |
+| `DeepResearchSwarm` | Extended research pipelines |
+| `AgentRearrange` | Custom DAG-based agent topology |
+| `MultiAgentRouter` | Intelligent task routing to best agent |
+| `AutoSwarmBuilder` | API auto-generates the right swarm |
+| `auto` | Let the API pick (default) |
+
+## LLM Routing
+
+SwarmX uses a cost-optimized dual-backend strategy for LLM calls:
+
+| Endpoint Type | Endpoints | Backend | Why |
+|---------------|-----------|---------|-----|
+| **Single-agent** | `/x402/agent`, summarize, translate, extract, sentiment | Direct OpenAI API | No orchestration overhead. ~$0.001/call, ~95% margin. |
+| **Multi-agent** | `/x402/research`, `/x402/analyze`, code-review, write, debate | Swarms API | Requires multi-agent orchestration (2-4 agents). ~40-60% margin. |
+
+- Single-agent tasks use `src/utils/llm.ts` which calls OpenAI directly with `OPENAI_API_KEY`
+- Multi-agent tasks use `SwarmsService` which calls the Swarms cloud API with `SWARMS_API_KEY`
+- **Fallback**: if `OPENAI_API_KEY` is not set, all tasks route through Swarms (works but costs more)
+
+## Examples
+
+### Basic Agent (`examples/basic-agent.ts`)
+
+Minimal ElizaOS v2 project with x402 payments and swarm delegation. Run with `bun run example`.
+
+### SignalHawk (`examples/signalhawk/`)
+
+Full-featured autonomous trading intelligence agent that:
+- Buys on-chain and market data via x402 micropayments
+- Runs multi-analyst MajorityVoting swarms for consensus signals
+- Sells structured signal cards with confidence %, analyst agreement, and cost breakdown
+
+See `examples/signalhawk/` for the complete implementation.
+
+## GitHub Action
+
+Audit smart contracts on every PR with 4 AI agents. See [`github-action/`](github-action/) for full docs.
+
+```yaml
+name: Contract Audit
+on:
+  pull_request:
+    paths:
+      - 'contracts/**/*.sol'
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  audit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: ItachiDevv/swarmx-audit@v1
+        with:
+          files: 'contracts/**/*.sol'
+          fail-on-critical: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+
+The action posts a structured audit report as a PR comment (security findings, economic attack vectors, gas optimizations) and fails the check if critical issues are found. Free tier (10 calls/day) works without a wallet.
+
+## Development
+
+```bash
+bun install          # Install dependencies
+bun run build        # Compile TypeScript
+bun run test         # Run unit + integration tests (162 cases)
+bun run test:smoke   # Marketplace smoke tests (needs network)
+bun run dev          # Watch mode
+bun run example      # Run standalone demo
+```
+
+### Key Dependencies
+
+- `@elizaos/core@2.0.0-alpha.32` — ElizaOS v2 runtime
+- `@dexterai/x402@^2.0.0` — Dexter SDK for x402 payments
+- `swarms-ts@^0.1.0-alpha.10` — Swarms TypeScript SDK
+- `drizzle-orm@^0.45.1` — Database schemas for payment persistence
+- `zod@^3.22.0` — Runtime validation
+
+## Roadmap
+
+See [TODO-NEXT.md](TODO-NEXT.md) for post-MVP next steps:
+- CI/CD with GitHub Actions
+- npm publish to registry
+- Server-side x402 middleware (sell your agent's services)
+- Event hooks for payment analytics
+- Custom HTTP routes for wallet status
+
+## License
+
+MIT

package/dist/actions/delegateToSwarm.d.ts

@@ -0,0 +1,8 @@
+import { type Action } from "@elizaos/core";
+/**
+ * Delegate a task to a Swarms multi-agent system.
+ * Supports 15+ swarm architectures: sequential, concurrent, hierarchical, mixture-of-agents, etc.
+ * Uses pre-built templates for common patterns, with full LLM extraction as fallback.
+ */
+export declare const delegateToSwarm: Action;
+//# sourceMappingURL=delegateToSwarm.d.ts.map

package/dist/actions/delegateToSwarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegateToSwarm.d.ts","sourceRoot":"","sources":["../../src/actions/delegateToSwarm.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EAMZ,MAAM,eAAe,CAAC;AAmFvB;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,MAiQ7B,CAAC"}

package/dist/actions/delegateToSwarm.js

@@ -0,0 +1,296 @@
+import { ModelType, } from "@elizaos/core";
+import { z } from "zod";
+import { findMatchingTemplate, SWARM_TEMPLATES, buildClassificationPrompt, } from "../templates/index.js";
+const VALID_SWARM_TYPES = [
+    "SequentialWorkflow",
+    "ConcurrentWorkflow",
+    "MixtureOfAgents",
+    "AgentRearrange",
+    "HiearchicalSwarm",
+    "GroupChat",
+    "MultiAgentRouter",
+    "AutoSwarmBuilder",
+    "MajorityVoting",
+    "HeavySwarm",
+    "DeepResearchSwarm",
+    "auto",
+];
+const DelegateSchema = z.object({
+    task: z.string().min(1),
+    swarmType: z.enum(VALID_SWARM_TYPES).optional().default("auto"),
+    agents: z
+        .array(z.object({
+        agent_name: z.string(),
+        system_prompt: z.string().optional(),
+        model_name: z.string().optional(),
+        role: z.string().optional(),
+    }))
+        .optional(),
+    maxLoops: z.number().positive().optional(),
+});
+/** Schema for LLM classification when no keyword match */
+const ClassificationSchema = z.object({
+    templateId: z.string(),
+    task: z.string().min(1),
+});
+/** Schema for minimal task extraction when template is pre-matched */
+const TaskExtractionSchema = z.object({
+    task: z.string().min(1),
+});
+/**
+ * Build SwarmRunParams from a matched template and extracted task string.
+ */
+function buildParamsFromTemplate(template, task) {
+    return {
+        task,
+        swarmType: template.swarmType,
+        agents: template.agents.map((a) => ({
+            agent_name: a.agent_name,
+            system_prompt: a.system_prompt ?? null,
+            model_name: a.model_name ?? "gpt-4o-mini",
+            role: a.role ?? "worker",
+            max_loops: a.max_loops ?? 1,
+            max_tokens: a.max_tokens ?? 4096,
+            temperature: a.temperature ?? 0.5,
+        })),
+        maxLoops: template.maxLoops ?? 1,
+        rules: template.rules,
+    };
+}
+/**
+ * Delegate a task to a Swarms multi-agent system.
+ * Supports 15+ swarm architectures: sequential, concurrent, hierarchical, mixture-of-agents, etc.
+ * Uses pre-built templates for common patterns, with full LLM extraction as fallback.
+ */
+export const delegateToSwarm = {
+    name: "DELEGATE_TO_SWARM",
+    description: "Delegate a complex task to a Swarms multi-agent system. Supports sequential pipelines, concurrent processing, mixture-of-agents, hierarchical delegation, group chat, and more. Set swarm_type to control the architecture.",
+    similes: [
+        "RUN_SWARM_TASK",
+        "USE_SWARM_AGENT",
+        "MULTI_AGENT_TASK",
+        "SWARMS_PAY_AND_RUN",
+        "RUN_MULTI_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" };
+        }
+        const userText = message.content.text ?? "";
+        let task;
+        let swarmType;
+        let agents;
+        let maxLoops;
+        let templateName = null;
+        // --- Step 1: Try keyword pre-filter for fast template matching ---
+        let matchedTemplate = findMatchingTemplate(userText);
+        // --- Step 2: If no keyword match, use LLM classification ---
+        if (!matchedTemplate) {
+            const classificationPrompt = buildClassificationPrompt(userText);
+            const classificationResult = await runtime.useModel(ModelType.TEXT_SMALL, {
+                prompt: classificationPrompt,
+            });
+            try {
+                const parsed = ClassificationSchema.parse(JSON.parse(String(classificationResult)));
+                if (parsed.templateId !== "custom") {
+                    matchedTemplate =
+                        SWARM_TEMPLATES.find((t) => t.id === parsed.templateId) ?? null;
+                }
+                // Use the LLM-extracted task if we got one (useful for both template and custom paths)
+                if (parsed.task) {
+                    task = parsed.task;
+                }
+            }
+            catch {
+                // Classification failed — fall through to custom path
+            }
+        }
+        // --- Step 3: Build params from template or fall back to full custom extraction ---
+        if (matchedTemplate) {
+            // Template matched — only need to extract the task string if not already set
+            if (!task) {
+                const taskExtraction = await runtime.useModel(ModelType.TEXT_SMALL, {
+                    prompt: `Extract the specific task the user wants performed from their message. Return JSON: { "task": "<the task>" }
+
+User message: "${userText}"
+
+Return only valid JSON, no markdown.`,
+                });
+                try {
+                    const parsed = TaskExtractionSchema.parse(JSON.parse(String(taskExtraction)));
+                    task = parsed.task;
+                }
+                catch {
+                    task = userText;
+                }
+            }
+            const templateParams = buildParamsFromTemplate(matchedTemplate, task);
+            swarmType = templateParams.swarmType;
+            agents = templateParams.agents;
+            maxLoops = templateParams.maxLoops;
+            templateName = matchedTemplate.name;
+        }
+        else {
+            // Custom path — full LLM extraction with VALID_SWARM_TYPES and DelegateSchema
+            const extraction = await runtime.useModel(ModelType.TEXT_SMALL, {
+                prompt: `Extract swarm task details from the user message. Return JSON with:
+- task: string (the task description)
+- swarmType: one of ${VALID_SWARM_TYPES.join(", ")} (default "auto" if unclear)
+- agents: optional array of { agent_name, system_prompt?, model_name?, role? }
+  Only include agents if the user specifies specific agent roles.
+- maxLoops: optional number (default 1)
+
+Guidelines for swarmType selection:
+- "SequentialWorkflow" for step-by-step pipelines (research -> write -> edit)
+- "ConcurrentWorkflow" for independent parallel tasks
+- "MixtureOfAgents" for getting multiple expert perspectives synthesized
+- "HiearchicalSwarm" for complex projects needing a director + workers
+- "GroupChat" for brainstorming or collaborative discussion
+- "HeavySwarm" for deep research requiring thorough investigation
+- "MajorityVoting" for decisions needing consensus
+- "auto" when unsure — the API picks the best architecture
+
+User message: "${userText}"
+
+Return only valid JSON, no markdown.`,
+            });
+            let params;
+            try {
+                params = DelegateSchema.parse(JSON.parse(String(extraction)));
+            }
+            catch {
+                params = { task: userText || "unspecified task", swarmType: "auto" };
+            }
+            task = params.task;
+            swarmType = params.swarmType;
+            maxLoops = params.maxLoops ?? 1;
+            // Build agent specs — use extracted agents or sensible defaults
+            agents =
+                params.agents && params.agents.length > 0
+                    ? params.agents.map((a) => ({
+                        agent_name: a.agent_name,
+                        system_prompt: a.system_prompt ?? null,
+                        model_name: a.model_name ?? "gpt-4o-mini",
+                        role: a.role ?? "worker",
+                        max_loops: 1,
+                        max_tokens: 4096,
+                        temperature: 0.5,
+                    }))
+                    : [
+                        {
+                            agent_name: "Researcher",
+                            system_prompt: "You are a thorough researcher. Analyze the task, gather key information, and provide detailed findings.",
+                            model_name: "gpt-4o-mini",
+                            role: "worker",
+                            max_loops: 1,
+                            max_tokens: 4096,
+                            temperature: 0.5,
+                        },
+                        {
+                            agent_name: "Analyst",
+                            system_prompt: "You are an expert analyst. Take the research findings and produce actionable insights and recommendations.",
+                            model_name: "gpt-4o-mini",
+                            role: "worker",
+                            max_loops: 1,
+                            max_tokens: 4096,
+                            temperature: 0.3,
+                        },
+                    ];
+        }
+        const templateLabel = templateName
+            ? ` [${templateName}]`
+            : "";
+        await callback?.({
+            text: `Delegating to swarm (${swarmType})${templateLabel} with ${agents.length} agent(s)...\nAgents: ${agents.map((a) => a.agent_name).join(", ")}`,
+        });
+        try {
+            const result = await swarmsService.runSwarm({
+                name: `ElizaOS-x402-${Date.now()}`,
+                description: `Task delegated from ElizaOS agent`,
+                agents,
+                task,
+                swarm_type: swarmType,
+                max_loops: maxLoops,
+            });
+            // Extract output — can be string, object, or nested
+            let output;
+            if (typeof result.output === "string") {
+                output = result.output;
+            }
+            else if (result.output != null) {
+                output = JSON.stringify(result.output, null, 2);
+            }
+            else {
+                output = "(no output)";
+            }
+            const text = `Swarm completed (${result.swarm_type ?? swarmType})${templateLabel}
+
+Agents: ${result.number_of_agents ?? agents.length}
+Execution time: ${result.execution_time != null ? `${result.execution_time.toFixed(1)}s` : "unknown"}
+Job ID: ${result.job_id ?? "unknown"}
+
+Result:
+${output.slice(0, 1000)}`;
+            await callback?.({
+                text,
+                content: {
+                    jobId: result.job_id ?? "",
+                    swarmType: result.swarm_type ?? swarmType,
+                    templateName: templateName ?? undefined,
+                    executionTime: String(result.execution_time ?? 0),
+                    agentCount: String(result.number_of_agents ?? agents.length),
+                },
+            });
+            return { success: true, text };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            await callback?.({
+                text: `Swarm delegation failed: ${msg}`,
+                error: true,
+            });
+            return { success: false, error: msg };
+        }
+    },
+    examples: [
+        [
+            {
+                name: "user",
+                content: {
+                    text: "Use the swarm to analyze top DeFi protocols and summarize risks",
+                },
+            },
+            {
+                name: "agent",
+                content: {
+                    text: "Swarm completed (SequentialWorkflow)\n\nAgents: 2\nExecution time: 12.3s\n\nResult: [detailed analysis]...",
+                    actions: ["DELEGATE_TO_SWARM"],
+                },
+            },
+        ],
+        [
+            {
+                name: "user",
+                content: {
+                    text: "Run a concurrent swarm with 3 agents to research Bitcoin, Ethereum, and Solana simultaneously",
+                },
+            },
+            {
+                name: "agent",
+                content: {
+                    text: "Swarm completed (ConcurrentWorkflow)\n\nAgents: 3\nExecution time: 8.1s\n\nResult: [parallel research results]...",
+                    actions: ["DELEGATE_TO_SWARM"],
+                },
+            },
+        ],
+    ],
+};
+//# sourceMappingURL=delegateToSwarm.js.map

package/dist/actions/delegateToSwarm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegateToSwarm.js","sourceRoot":"","sources":["../../src/actions/delegateToSwarm.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,SAAS,GACV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,iBAAiB,GAAG;IACxB,oBAAoB;IACpB,oBAAoB;IACpB,iBAAiB;IACjB,gBAAgB;IAChB,kBAAkB;IAClB,WAAW;IACX,kBAAkB;IAClB,kBAAkB;IAClB,gBAAgB;IAChB,YAAY;IACZ,mBAAmB;IACnB,MAAM;CACE,CAAC;AAEX,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IAC/D,MAAM,EAAE,CAAC;SACN,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACpC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC5B,CAAC,CACH;SACA,QAAQ,EAAE;IACb,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAEH,0DAA0D;AAC1D,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACxB,CAAC,CAAC;AAEH,sEAAsE;AACtE,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACxB,CAAC,CAAC;AAEH;;GAEG;AACH,SAAS,uBAAuB,CAC9B,QAAuB,EACvB,IAAY;IAQZ,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAClC,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,aAAa,EAAE,CAAC,CAAC,aAAa,IAAI,IAAI;YACtC,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,aAAa;YACzC,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,QAAQ;YACxB,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC;YAC3B,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI;YAChC,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,GAAG;SAClC,CAAC,CAAC;QACH,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,CAAC;QAChC,KAAK,EAAE,QAAQ,CAAC,KAAK;KACtB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAW;IACrC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,6NAA6N;IAC/N,OAAO,EAAE;QACP,gBAAgB;QAChB,iBAAiB;QACjB,kBAAkB;QAClB,oBAAoB;QACpB,iBAAiB;KAClB;IAED,QAAQ,EAAE,KAAK,EACb,OAAsB,EACtB,QAAgB,EAChB,MAAc,EACI,EAAE;QACpB,OAAO,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,EAAE,KAAK,EACZ,OAAsB,EACtB,OAAe,EACf,MAAc,EACd,QAAkC,EAClC,QAA0B,EACgD,EAAE;QAC5E,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,CAAgB,QAAe,CAAC,CAAC;QACzE,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC;YACnD,MAAM,QAAQ,EAAE,CAAC;gBACf,IAAI,EAAE,yEAAyE;gBAC/E,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC;QACrE,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAwB,CAAC;QAC7B,IAAI,SAAiB,CAAC;QACtB,IAAI,MAAmB,CAAC;QACxB,IAAI,QAAgB,CAAC;QACrB,IAAI,YAAY,GAAkB,IAAI,CAAC;QAEvC,oEAAoE;QACpE,IAAI,eAAe,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAErD,8DAA8D;QAC9D,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,oBAAoB,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;YACjE,MAAM,oBAAoB,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE;gBACxE,MAAM,EAAE,oBAAoB;aAC7B,CAAC,CAAC;YAEH,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CACvC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CACzC,CAAC;gBACF,IAAI,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;oBACnC,eAAe;wBACb,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;gBACpE,CAAC;gBACD,uFAAuF;gBACvF,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;oBAChB,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;gBACrB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,sDAAsD;YACxD,CAAC;QACH,CAAC;QAED,oFAAoF;QACpF,IAAI,eAAe,EAAE,CAAC;YACpB,6EAA6E;YAC7E,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE;oBAClE,MAAM,EAAE;;iBAED,QAAQ;;qCAEY;iBAC5B,CAAC,CAAC;gBACH,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CACvC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CACnC,CAAC;oBACF,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;gBACrB,CAAC;gBAAC,MAAM,CAAC;oBACP,IAAI,GAAG,QAAQ,CAAC;gBAClB,CAAC;YACH,CAAC;YAED,MAAM,cAAc,GAAG,uBAAuB,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;YACtE,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC;YACrC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;YAC/B,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC;YACnC,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,8EAA8E;YAC9E,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE;gBAC9D,MAAM,EAAE;;sBAEM,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;iBAejC,QAAQ;;qCAEY;aAC9B,CAAC,CAAC;YAEH,IAAI,MAAsC,CAAC;YAC3C,IAAI,CAAC;gBACH,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAChE,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,GAAG,EAAE,IAAI,EAAE,QAAQ,IAAI,kBAAkB,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;YACvE,CAAC;YAED,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACnB,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;YAC7B,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;YAEhC,gEAAgE;YAChE,MAAM;gBACJ,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;oBACvC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBACxB,UAAU,EAAE,CAAC,CAAC,UAAU;wBACxB,aAAa,EAAE,CAAC,CAAC,aAAa,IAAI,IAAI;wBACtC,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,aAAa;wBACzC,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,QAAQ;wBACxB,SAAS,EAAE,CAAC;wBACZ,UAAU,EAAE,IAAI;wBAChB,WAAW,EAAE,GAAG;qBACjB,CAAC,CAAC;oBACL,CAAC,CAAC;wBACE;4BACE,UAAU,EAAE,YAAY;4BACxB,aAAa,EACX,yGAAyG;4BAC3G,UAAU,EAAE,aAAa;4BACzB,IAAI,EAAE,QAAQ;4BACd,SAAS,EAAE,CAAC;4BACZ,UAAU,EAAE,IAAI;4BAChB,WAAW,EAAE,GAAG;yBACjB;wBACD;4BACE,UAAU,EAAE,SAAS;4BACrB,aAAa,EACX,4GAA4G;4BAC9G,UAAU,EAAE,aAAa;4BACzB,IAAI,EAAE,QAAQ;4BACd,SAAS,EAAE,CAAC;4BACZ,UAAU,EAAE,IAAI;4BAChB,WAAW,EAAE,GAAG;yBACjB;qBACF,CAAC;QACV,CAAC;QAED,MAAM,aAAa,GAAG,YAAY;YAChC,CAAC,CAAC,KAAK,YAAY,GAAG;YACtB,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,QAAQ,EAAE,CAAC;YACf,IAAI,EAAE,wBAAwB,SAAS,IAAI,aAAa,SAAS,MAAM,CAAC,MAAM,yBAAyB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACpJ,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC;gBAC1C,IAAI,EAAE,gBAAgB,IAAI,CAAC,GAAG,EAAE,EAAE;gBAClC,WAAW,EAAE,mCAAmC;gBAChD,MAAM;gBACN,IAAI;gBACJ,UAAU,EAAE,SAAsB;gBAClC,SAAS,EAAE,QAAQ;aACpB,CAAC,CAAC;YAEH,oDAAoD;YACpD,IAAI,MAAc,CAAC;YACnB,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACtC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YACzB,CAAC;iBAAM,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;gBACjC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,aAAa,CAAC;YACzB,CAAC;YAED,MAAM,IAAI,GAAG,oBAAoB,MAAM,CAAC,UAAU,IAAI,SAAS,IAAI,aAAa;;UAE5E,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAAC,MAAM;kBAChC,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;UAC1F,MAAM,CAAC,MAAM,IAAI,SAAS;;;EAGlC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC;YAEpB,MAAM,QAAQ,EAAE,CAAC;gBACf,IAAI;gBACJ,OAAO,EAAE;oBACP,KAAK,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;oBAC1B,SAAS,EAAE,MAAM,CAAC,UAAU,IAAI,SAAS;oBACzC,YAAY,EAAE,YAAY,IAAI,SAAS;oBACvC,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC;oBACjD,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAAC,MAAM,CAAC;iBAC7D;aACF,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,QAAQ,EAAE,CAAC;gBACf,IAAI,EAAE,4BAA4B,GAAG,EAAE;gBACvC,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACxC,CAAC;IACH,CAAC;IAED,QAAQ,EAAE;QACR;YACE;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,iEAAiE;iBACxE;aACF;YACD;gBACE,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE;oBACP,IAAI,EAAE,4GAA4G;oBAClH,OAAO,EAAE,CAAC,mBAAmB,CAAC;iBAC/B;aACF;SACF;QACD;YACE;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,+FAA+F;iBACtG;aACF;YACD;gBACE,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE;oBACP,IAAI,EAAE,mHAAmH;oBACzH,OAAO,EAAE,CAAC,mBAAmB,CAAC;iBAC/B;aACF;SACF;KACF;CACF,CAAC"}