trustrouter 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 TrustRouter Contributors
+
+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,151 @@
+# TrustRouter
+
+**ERC-8004 Reputation-Aware Service Router**
+
+Discover, rank, and route to the best services on-chain — agents, MCP tools, oracles, APIs, DeFi bots, and anything registered on [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004). TrustRouter queries the Identity and Reputation registries using free public RPCs to find the highest-trust provider for any given task.
+
+> *"Reputation-aware routing: Middleware that ingests ERC-8004 reputation data and dynamically routes requests to the best-performing service for a given task at a given moment."*
+> — [Vitto Rivabella](https://x.com/VittoStack), ERC-8004 co-creator
+
+## What It Does
+
+- **Discovers** all registered services from the ERC-8004 Identity Registry — agents, MCP servers, oracles, APIs, and more
+- **Scores** them using on-chain reputation feedback from the Reputation Registry
+- **Ranks** by a composite trust score (reputation + activity)
+- **Filters** by service type (A2A, MCP, OASF, x402) and keyword matching
+- **Routes** you to the best available provider for your task
+
+Works as a **CLI tool** for humans and an **OpenClaw skill** for agents. Zero config, no API keys needed.
+
+## Quick Start
+
+```bash
+# Run directly with npx (no install needed)
+npx trustrouter@latest list
+
+# Or install globally
+npm install -g trustrouter
+```
+
+TrustRouter works out of the box using free public RPCs — zero API keys required.
+
+```bash
+# Find the best service for a task
+trustrouter find --task "price feed oracle" --chain base
+
+# List all services ranked by reputation
+trustrouter list --chain ethereum --sort reputation
+
+# Inspect a specific service (by ID or name)
+trustrouter inspect 42 --chain arbitrum
+trustrouter inspect "PriceFeedOracle" --chain base
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `trustrouter find --task "..." [--type mcp\|a2a] [--chain ethereum]` | Find best service for a task |
+| `trustrouter list [--chain ethereum] [--sort reputation] [--limit 20]` | List all registered services |
+| `trustrouter inspect <id-or-name> [--chain ethereum]` | Full details of a service (by ID or name) |
+
+**Local Caching:**
+All RPC responses are automatically cached locally in `~/.trustrouter/cache.json` for 1 hour. This significantly speeds up subsequent commands (e.g. from 50s down to 0.7s) and prevents rate-limiting when using free public RPCs.
+
+All commands support the global `-o json` flag for machine-readable output:
+
+```bash
+# JSON output (for scripts and agents)
+trustrouter -o json list --limit 5
+trustrouter -o json find --task "oracle" --chain base
+trustrouter -o json inspect 42
+
+# Pipe to jq
+trustrouter -o json list --limit 100 | jq '.[].name'
+```
+
+Errors follow the same pattern — table mode prints `Error: ...` to stderr, JSON mode prints `{"error": "..."}` to stdout with a non-zero exit code.
+
+## Supported Chains
+
+Supports all EVM chains where the ERC-8004 registries are deployed (via CREATE2):
+
+- **Mainnets**: Ethereum, Base, Arbitrum, Polygon, Avalanche, BNB, Gnosis, Linea, Celo
+- **Testnets**: Sepolia, Base Sepolia
+
+Specify the chain using the `-c` or `--chain` flag (e.g., `--chain base`).
+
+## Trust Score Algorithm
+
+```
+trustScore = (0.6 × avg_reputation) + (0.4 × log(feedback_count))
+```
+
+- **Reputation** — Average on-chain feedback score from the Reputation Registry `getSummary()`
+- **Activity** — Log-scale bonus based on the total number of feedback events
+
+## What Can Be Discovered
+
+ERC-8004 is not just for agents — it's a universal service registry. TrustRouter discovers anything registered:
+
+| Type | Example |
+|------|---------|
+| AI Agents | A2A-compatible autonomous agents |
+| MCP Servers | Tool providers, code sandboxes, database connectors |
+| Oracles | Price feeds, data providers, block time trackers |
+| DeFi Services | Liquidation bots, keeper networks, MEV searchers |
+| APIs | Any HTTP service with an endpoint |
+
+## Agent Integration
+
+TrustRouter ships with a [SKILL.md](./SKILL.md) for OpenClaw agents. After installing, any agent can discover and route to ERC-8004 services autonomously:
+
+```
+"Find me the best MCP tool for price feeds on Ethereum"
+→ trustrouter find --task "price feed" --type mcp --chain ethereum --json
+```
+
+## Architecture
+
+```
+┌─────────────┐     ┌──────────────────┐
+│  CLI / Agent │ ──▸ │  Router (Scorer   │
+│   Commands   │     │  + Matcher)       │
+└──────┬──────┘     └────────┬─────────┘
+       │                     │
+       ▼                     ▼
+┌──────────────────────────────────────┐
+│  Registry Layer (Free Public RPCs)   │
+│  Parallel Batched Contract Queries   │
+└──────────────────┬───────────────────┘
+                   │
+          ┌────────▾─────────┐
+          │  ERC-8004        │
+          │  Identity +      │
+          │  Reputation      │
+          │  Registries      │
+          └──────────────────┘
+```
+
+## Advanced Usage (Custom RPCs)
+
+TrustRouter works out of the box, but for heavy usage you can set custom RPC endpoints:
+
+```bash
+export ETH_RPC_URL="https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY"
+export BASE_RPC_URL="https://mainnet.base.org"
+```
+
+## Development
+
+```bash
+git clone https://github.com/nice-bills/trustrouter
+cd trustrouter
+npm install
+npm run build
+node dist/cli.js list --chain ethereum
+```
+
+## License
+
+MIT

package/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: trustrouter
+description: Find the best ERC-8004 registered services — agents, MCP tools, oracles, APIs — by on-chain reputation. Routes to the highest-trust provider for any given task across 11 supported chains.
+---
+
+# TrustRouter — ERC-8004 Service & Agent Discovery
+
+Use this skill when you need to discover, evaluate, or route to any ERC-8004 registered service. TrustRouter queries on-chain Identity and Reputation registries via free public RPCs to find and rank the best available provider for a given task.
+
+## When to Use
+
+- You need to find a service, tool, or agent to delegate a task to
+- You want to evaluate the trustworthiness of a specific service using on-chain feedback
+- You need to discover available MCP servers, A2A agents, oracles, or x402-compatible services
+- You want to find services on specific chains like Ethereum, Base, Arbitrum, Polygon, etc.
+
+## Installation
+
+```bash
+npx trustrouter --help          # Run without installing
+npm install -g trustrouter      # Or install globally
+```
+
+TrustRouter is **zero-config**. It uses free public RPCs out of the box — no API keys needed.
+
+## Commands
+
+### Find the best service for a task
+
+```bash
+trustrouter -o json find --task "audit solidity contracts" --chain ethereum
+```
+
+Use `--type` to filter by service type: `a2a`, `mcp`, `web`, `oasf`, `x402`
+
+```bash
+trustrouter -o json find --task "price feed oracle" --type mcp --chain base
+```
+
+### List all registered services
+
+```bash
+trustrouter -o json list --chain arbitrum --sort reputation --limit 10
+```
+
+### Inspect a specific service (by ID or name)
+
+```bash
+trustrouter -o json inspect 42 --chain polygon
+trustrouter -o json inspect "ClawNews" --chain arbitrum
+```
+
+### Force fresh data (bypass cache)
+
+```bash
+trustrouter --refresh -o json list --chain ethereum --limit 5
+```
+
+## Output Format
+
+Always use `-o json` when calling from an agent context. The JSON output includes:
+
+```json
+[
+  {
+    "agentId": 0,
+    "name": "ClawNews",
+    "trustScore": 85.5,
+    "feedbackCount": 156,
+    "services": [
+      { "name": "web", "endpoint": "https://clawnews.io" },
+      { "name": "OASF", "endpoint": "https://github.com/agntcy/oasf/", "version": "0.8.0" },
+      { "name": "agentWallet", "endpoint": "eip155:42161:0x89E..." },
+      { "name": "email", "endpoint": "hello@clawnews.io" }
+    ],
+    "x402Support": false
+  }
+]
+```
+
+Errors in JSON mode return `{"error": "..."}` with a non-zero exit code.
+
+## Global Options
+
+| Flag | Description |
+|------|-------------|
+| `-o json` / `-o table` | Output format (default: `table`) |
+| `--refresh` | Bypass cache and fetch fresh data from chain |
+| `-c, --chain <name>` | Target chain (default: `ethereum`) |
+
+## Supported Chains
+
+Ethereum, Base, Arbitrum, Polygon, Avalanche, BNB, Gnosis, Linea, Celo, Sepolia, Base-Sepolia
+
+## Trust Score
+
+Services are scored using on-chain data from the ERC-8004 Reputation Registry:
+- **60%** Reputation (average feedback score, 0-100)
+- **40%** Activity (log-scale bonus based on total feedback count)
+
+Higher trust score = more reliable provider with a proven on-chain track record.
+
+## Caching
+
+Results are cached locally in `~/.trustrouter/cache.json` for 1 hour. Use `--refresh` to bypass.

package/dist/cache.d.ts

@@ -0,0 +1,19 @@
+import { AgentData } from "./registry.js";
+/** Call this to bypass cache reads for the current run */
+export declare function setRefresh(enabled: boolean): void;
+export interface CacheStore {
+    [chain: string]: {
+        timestamp: number;
+        totalAgents: number;
+        agents: Record<number, AgentData>;
+    };
+}
+export declare function loadCache(): CacheStore;
+export declare function saveCache(cache: CacheStore): void;
+/** Returns cached data for a chain, or null if expired/missing/refresh forced */
+export declare function getCachedChain(chain: string): {
+    timestamp: number;
+    totalAgents: number;
+    agents: Record<number, AgentData>;
+} | null;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAW1C,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,QAE1C;AAED,MAAM,WAAW,UAAU;IACvB,CAAC,KAAK,EAAE,MAAM,GAAG;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;KACrC,CAAA;CACJ;AAED,wBAAgB,SAAS,IAAI,UAAU,CAQtC;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,QAS1C;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM;eA5BzB,MAAM;iBACJ,MAAM;YACX,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;SAkCxC"}

package/dist/cache.js

@@ -0,0 +1,45 @@
+import fs from "fs";
+import path from "path";
+import os from "os";
+const CACHE_DIR = path.join(os.homedir(), ".trustrouter");
+const CACHE_FILE = path.join(CACHE_DIR, "cache.json");
+const TTL_MS = 60 * 60 * 1000; // 1 hour
+let forceRefresh = false;
+/** Call this to bypass cache reads for the current run */
+export function setRefresh(enabled) {
+    forceRefresh = enabled;
+}
+export function loadCache() {
+    try {
+        if (!fs.existsSync(CACHE_FILE))
+            return {};
+        const data = fs.readFileSync(CACHE_FILE, "utf-8");
+        return JSON.parse(data);
+    }
+    catch {
+        return {};
+    }
+}
+export function saveCache(cache) {
+    try {
+        if (!fs.existsSync(CACHE_DIR)) {
+            fs.mkdirSync(CACHE_DIR, { recursive: true });
+        }
+        fs.writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2), "utf-8");
+    }
+    catch {
+        // Silently ignore — cache is best-effort
+    }
+}
+/** Returns cached data for a chain, or null if expired/missing/refresh forced */
+export function getCachedChain(chain) {
+    if (forceRefresh)
+        return null;
+    const cache = loadCache();
+    const data = cache[chain];
+    if (data && Date.now() - data.timestamp < TTL_MS) {
+        return data;
+    }
+    return null;
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;AAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AACtD,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,SAAS;AAExC,IAAI,YAAY,GAAG,KAAK,CAAC;AAEzB,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAC,OAAgB;IACvC,YAAY,GAAG,OAAO,CAAC;AAC3B,CAAC;AAUD,MAAM,UAAU,SAAS;IACrB,IAAI,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAiB;IACvC,IAAI,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACL,yCAAyC;IAC7C,CAAC;AACL,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,KAAa;IACxC,IAAI,YAAY;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,GAAG,MAAM,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import chalk from "chalk";
+import { findCommand } from "./commands/find.js";
+import { listCommand } from "./commands/list.js";
+import { inspectCommand } from "./commands/inspect.js";
+import { getSupportedChains } from "./registry.js";
+import dotenv from "dotenv";
+dotenv.config();
+const chains = getSupportedChains().join(", ");
+const program = new Command();
+program
+    .name("trustrouter")
+    .description(chalk.bold("ERC-8004 Reputation-Aware Service Router") +
+    "\n  Discover, rank, and route to the best services & agents on-chain." +
+    "\n  Zero config — works out of the box with free public RPCs." +
+    "\n  Results are cached locally for 1 hour (~/.trustrouter/cache.json)." +
+    chalk.dim(`\n\n  Supported chains: ${chains}`))
+    .version("0.1.0")
+    .option("-o, --output <format>", "Output format: table or json", "table")
+    .option("--refresh", "Bypass cache and fetch fresh data from chain");
+// trustrouter find --task "audit solidity" --type mcp --chain base
+program
+    .command("find")
+    .description("Find the best service or agent for a given task")
+    .requiredOption("-t, --task <description>", "Task description to match against")
+    .option("--type <type>", "Filter by service type (a2a, mcp, web, oasf, x402)")
+    .option("-c, --chain <chain>", "Target chain", "ethereum")
+    .option("-n, --limit <number>", "Max results to return", "5")
+    .action((opts) => {
+    const { output, refresh } = program.opts();
+    findCommand({ ...opts, output, refresh });
+});
+// trustrouter list --chain base --sort reputation --limit 20
+program
+    .command("list")
+    .description("List all registered services ranked by trust")
+    .option("-c, --chain <chain>", "Target chain", "ethereum")
+    .option("-s, --sort <field>", "Sort by: reputation, name, recent", "reputation")
+    .option("-n, --limit <number>", "Max results", "20")
+    .option("--type <type>", "Filter by service type (a2a, mcp, web, oasf, x402)")
+    .action((opts) => {
+    const { output, refresh } = program.opts();
+    listCommand({ ...opts, output, refresh });
+});
+// trustrouter inspect 42 --chain base
+// trustrouter inspect "OracleName" --chain base
+program
+    .command("inspect")
+    .description("Show full details of a registered service (by ID or name)")
+    .argument("<id-or-name>", "The service's on-chain token ID or name")
+    .option("-c, --chain <chain>", "Target chain", "ethereum")
+    .action((idOrName, opts) => {
+    const { output, refresh } = program.opts();
+    inspectCommand(idOrName, { ...opts, output, refresh });
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/find.d.ts

@@ -0,0 +1,11 @@
+interface FindOptions {
+    task: string;
+    type?: string;
+    chain: string;
+    limit: string;
+    output: string;
+    refresh?: boolean;
+}
+export declare function findCommand(options: FindOptions): Promise<void>;
+export {};
+//# sourceMappingURL=find.d.ts.map

package/dist/commands/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/commands/find.ts"],"names":[],"mappings":"AAMA,UAAU,WAAW;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CrE"}

package/dist/commands/find.js

@@ -0,0 +1,100 @@
+import chalk from "chalk";
+import Table from "cli-table3";
+import { fetchAgents } from "../registry.js";
+import { rankAgents } from "../router/index.js";
+import { setRefresh } from "../cache.js";
+export async function findCommand(options) {
+    const isJson = options.output === "json";
+    if (options.refresh)
+        setRefresh(true);
+    try {
+        if (!isJson)
+            console.log(chalk.dim("\n  Querying ERC-8004 service registry via public RPC..."));
+        const agents = await fetchAgents({ chain: options.chain, first: 100 });
+        const results = rankAgents(agents, {
+            task: options.task,
+            type: options.type,
+            limit: parseInt(options.limit),
+        });
+        if (results.length === 0) {
+            if (isJson) {
+                console.log(JSON.stringify([]));
+            }
+            else {
+                console.log(chalk.yellow("\n  No services found matching your criteria.\n"));
+            }
+            return;
+        }
+        if (isJson) {
+            console.log(JSON.stringify(results.map(toJson), null, 2));
+            return;
+        }
+        console.log("\n" + chalk.bold.cyan("  🔍 Results for: ") + chalk.white(`"${options.task}"`));
+        if (options.type)
+            console.log(chalk.dim(`  Filtered by type: ${options.type}`));
+        console.log("");
+        printTable(results);
+        console.log(chalk.dim(`\n  ${results.length} result(s)\n`));
+    }
+    catch (err) {
+        if (isJson) {
+            console.log(JSON.stringify({ error: err.message }));
+            process.exit(1);
+        }
+        console.error(chalk.red(`\n  ✗ Error: ${err.message}\n`));
+        process.exit(1);
+    }
+}
+function toJson(s) {
+    return {
+        agentId: s.agent.agentId,
+        name: s.agent.registration.name,
+        description: s.agent.registration.description,
+        trustScore: s.trustScore,
+        feedbackCount: s.agent.feedbackCount,
+        avgScore: s.agent.avgScore,
+        validationCount: s.agent.validationCount,
+        validationAvg: s.agent.validationAvg,
+        services: s.agent.registration.services || [],
+        x402Support: s.agent.registration.x402Support || false,
+        x402Endpoint: s.agent.registration.services?.find(svc => svc.name.toLowerCase() === "x402")?.endpoint || null,
+        owner: s.agent.owner,
+    };
+}
+function printTable(results) {
+    const table = new Table({
+        head: ["#", "ID", "Name", "Trust", "Reviews", "Services"].map((h) => chalk.bold(h)),
+        colWidths: [5, 8, 30, 14, 9, 28],
+        style: { head: [], border: ["dim"] },
+    });
+    results.forEach((r, i) => {
+        const svcs = r.agent.registration.services?.map((s) => svcTag(s.name)).join(" ") || chalk.dim("-");
+        table.push([
+            chalk.dim(`${i + 1}`),
+            chalk.white(`${r.agent.agentId}`),
+            chalk.bold(trunc(r.agent.registration.name || "(unnamed)", 28)),
+            scoreBar(r.trustScore),
+            `${r.agent.feedbackCount}`,
+            svcs,
+        ]);
+    });
+    console.log(table.toString());
+}
+const SVC_ICONS = {
+    a2a: "🤖", mcp: "🔧", web: "🌐", oasf: "📦", x402: "💰",
+};
+function svcTag(name) {
+    const icon = SVC_ICONS[name.toLowerCase()] || "🔗";
+    return icon + chalk.dim(name.toUpperCase());
+}
+function trunc(s, n) {
+    return s.length > n ? s.slice(0, n - 1) + "…" : s;
+}
+function scoreBar(score) {
+    const n = Math.min(100, Math.max(0, score));
+    const filled = Math.round(n / 10);
+    const bar = "█".repeat(filled) + "░".repeat(10 - filled);
+    const color = n >= 70 ? chalk.green : n >= 40 ? chalk.yellow : chalk.red;
+    return color(bar) + chalk.dim(` ${n.toFixed(1)}`);
+}
+//# sourceMappingURL=find.js.map

package/dist/commands/find.js.map

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

package/dist/commands/inspect.d.ts

@@ -0,0 +1,8 @@
+interface InspectOptions {
+    chain: string;
+    output: string;
+    refresh?: boolean;
+}
+export declare function inspectCommand(idOrName: string, options: InspectOptions): Promise<void>;
+export {};
+//# sourceMappingURL=inspect.d.ts.map

package/dist/commands/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"AAoBA,UAAU,cAAc;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAiI7F"}