npm - @jhinresh/elizaos-plugin - Versions diffs - 0.1.2 → 0.2.0 - Mend

@jhinresh/elizaos-plugin 0.1.2 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/index.d.ts CHANGED Viewed

@@ -3,10 +3,13 @@
  *
  * Maiat Trust Score plugin for ElizaOS (ai16z agent framework).
  *
- * Adds trust checking capabilities to any ElizaOS agent:
- * - "Is this address safe?" → trust score lookup
- * - Auto-gate transactions before execution
- * - Report transaction outcomes back to Maiat
+ * V0.2.0 — Cold-start update:
+ * - CHECK_TRUST: Trust score lookup (existing)
+ * - SUBMIT_REVIEW: Submit reviews with Scarab staking
+ * - GET_INTERACTIONS: Discover wallet contract interactions
+ * - GET_PASSPORT: Reputation passport
+ * - DEFI_INFO: Query DeFi protocols
+ * - AGENT_INFO: Query AI agents
  *
  * @example
  * ```typescript
@@ -23,21 +26,13 @@ export interface MaiatElizaConfig {
     chain?: string;
     minScore?: number;
 }
-interface TrustResult {
-    address: string;
-    score: number;
-    risk: string;
-    type: string;
-    flags: string[];
-    safe: boolean;
-}
 /**
  * ElizaOS plugin definition following the standard plugin interface.
  *
  * Registers:
- * - Action: CHECK_TRUST — responds to "is 0x... safe?" type queries
- * - Evaluator: TRUST_GATE — evaluates if an address should be interacted with
- * - Provider: TRUST_DATA — provides trust context for agent reasoning
+ * - Actions: CHECK_TRUST, SUBMIT_REVIEW, GET_INTERACTIONS, GET_PASSPORT, DEFI_INFO, AGENT_INFO
+ * - Evaluator: TRUST_GATE
+ * - Provider: TRUST_DATA
  */
 export declare function maiatPlugin(config?: MaiatElizaConfig): {
     name: string;
@@ -52,7 +47,7 @@ export declare function maiatPlugin(config?: MaiatElizaConfig): {
             data?: undefined;
         } | {
             text: string;
-            data: TrustResult;
+            data: any;
         }>;
     }[];
     evaluators: {

package/dist/index.js CHANGED Viewed

@@ -3,10 +3,13 @@
  *
  * Maiat Trust Score plugin for ElizaOS (ai16z agent framework).
  *
- * Adds trust checking capabilities to any ElizaOS agent:
- * - "Is this address safe?" → trust score lookup
- * - Auto-gate transactions before execution
- * - Report transaction outcomes back to Maiat
+ * V0.2.0 — Cold-start update:
+ * - CHECK_TRUST: Trust score lookup (existing)
+ * - SUBMIT_REVIEW: Submit reviews with Scarab staking
+ * - GET_INTERACTIONS: Discover wallet contract interactions
+ * - GET_PASSPORT: Reputation passport
+ * - DEFI_INFO: Query DeFi protocols
+ * - AGENT_INFO: Query AI agents
  *
  * @example
  * ```typescript
@@ -20,16 +23,25 @@
 // ═══════════════════════════════════════════
 //  API Client (lightweight)
 // ═══════════════════════════════════════════
+function getHeaders(config) {
+    const h = {
+        "Content-Type": "application/json",
+        "User-Agent": "maiat-elizaos-plugin/0.2.0",
+    };
+    if (config.apiKey)
+        h["Authorization"] = `Bearer ${config.apiKey}`;
+    return h;
+}
+function getApiUrl(config) {
+    return config.apiUrl || "https://maiat-protocol.vercel.app";
+}
 async function queryMaiat(address, config) {
-    const apiUrl = config.apiUrl || "https://maiat-protocol.vercel.app";
+    const apiUrl = getApiUrl(config);
     const chain = config.chain || "base";
     const minScore = config.minScore ?? 3.0;
-    const headers = {
-        "User-Agent": "maiat-elizaos-plugin/0.1.0",
-    };
-    if (config.apiKey)
-        headers["Authorization"] = `Bearer ${config.apiKey}`;
-    const res = await fetch(`${apiUrl}/api/v1/score/${address}?chain=${chain}`, { headers });
+    const res = await fetch(`${apiUrl}/api/v1/score/${address}?chain=${chain}`, {
+        headers: getHeaders(config),
+    });
     if (!res.ok) {
         throw new Error(`Maiat API error: ${res.status}`);
     }
@@ -50,15 +62,18 @@ async function queryMaiat(address, config) {
  * ElizaOS plugin definition following the standard plugin interface.
  *
  * Registers:
- * - Action: CHECK_TRUST — responds to "is 0x... safe?" type queries
- * - Evaluator: TRUST_GATE — evaluates if an address should be interacted with
- * - Provider: TRUST_DATA — provides trust context for agent reasoning
+ * - Actions: CHECK_TRUST, SUBMIT_REVIEW, GET_INTERACTIONS, GET_PASSPORT, DEFI_INFO, AGENT_INFO
+ * - Evaluator: TRUST_GATE
+ * - Provider: TRUST_DATA
  */
 export function maiatPlugin(config = {}) {
+    const apiUrl = getApiUrl(config);
+    const headers = getHeaders(config);
     return {
         name: "maiat-trust",
         description: "Trust scoring for on-chain addresses via Maiat Protocol",
         actions: [
+            // --- Existing: CHECK_TRUST ---
             {
                 name: "CHECK_TRUST",
                 description: "Check the trust score of an on-chain address",
@@ -89,6 +104,167 @@ export function maiatPlugin(config = {}) {
                     }
                 },
             },
+            // --- NEW: SUBMIT_REVIEW ---
+            {
+                name: "SUBMIT_REVIEW",
+                description: "Submit a trust review for a contract. Costs 2 Scarab, earn 3-10 for quality.",
+                examples: [
+                    "Review 0x833589... — rating 8, great stablecoin",
+                    "Submit review: address 0xabc, rating 3, seems risky",
+                ],
+                validate: async (message) => /0x[a-fA-F0-9]{40}/.test(message) && /\d/.test(message),
+                handler: async (message) => {
+                    const addrMatch = message.match(/0x[a-fA-F0-9]{40}/);
+                    const ratingMatch = message.match(/rating\s*:?\s*(\d+)/i) || message.match(/(\d+)\s*\/\s*10/);
+                    if (!addrMatch)
+                        return { text: "Please provide a contract address (0x...)" };
+                    const rating = ratingMatch ? Math.min(10, Math.max(1, parseInt(ratingMatch[1]))) : 5;
+                    try {
+                        const res = await fetch(`${apiUrl}/api/v1/review`, {
+                            method: "POST",
+                            headers,
+                            body: JSON.stringify({
+                                address: addrMatch[0],
+                                rating,
+                                comment: message,
+                                reviewer: "eliza-agent",
+                            }),
+                        });
+                        const data = await res.json();
+                        if (!res.ok)
+                            throw new Error(data.error || `HTTP ${res.status}`);
+                        return {
+                            text: `✅ Review submitted!\n\n- Address: \`${addrMatch[0]}\`\n- Rating: ${rating}/10\n- Scarab earned: ${data.meta?.scarabReward || 0} 🪲`,
+                            data,
+                        };
+                    }
+                    catch (error) {
+                        return { text: `❌ Review failed: ${error instanceof Error ? error.message : "Unknown error"}` };
+                    }
+                },
+            },
+            // --- NEW: GET_INTERACTIONS ---
+            {
+                name: "GET_INTERACTIONS",
+                description: "Discover which contracts a wallet has interacted with",
+                examples: [
+                    "What contracts has 0x1234... interacted with?",
+                    "Show interactions for 0xabcd...",
+                ],
+                validate: async (message) => /0x[a-fA-F0-9]{40}/.test(message),
+                handler: async (message) => {
+                    const match = message.match(/0x[a-fA-F0-9]{40}/);
+                    if (!match)
+                        return { text: "Please provide a wallet address." };
+                    try {
+                        const res = await fetch(`${apiUrl}/api/v1/wallet/${match[0]}/interactions`, { headers });
+                        if (!res.ok)
+                            throw new Error(`HTTP ${res.status}`);
+                        const data = await res.json();
+                        const list = data.interacted?.map((c) => `  • ${c.name} (${c.category}) — ${c.txCount} txs`).join("\n") || "None found";
+                        return {
+                            text: `📋 Wallet Interactions (${data.interactedCount} contracts):\n\n${list}`,
+                            data,
+                        };
+                    }
+                    catch (error) {
+                        return { text: `❌ Error: ${error instanceof Error ? error.message : "Unknown error"}` };
+                    }
+                },
+            },
+            // --- NEW: GET_PASSPORT ---
+            {
+                name: "GET_PASSPORT",
+                description: "Get a wallet's reputation passport",
+                examples: [
+                    "Show passport for 0x1234...",
+                    "What's my reputation level?",
+                ],
+                validate: async (message) => /0x[a-fA-F0-9]{40}/.test(message),
+                handler: async (message) => {
+                    const match = message.match(/0x[a-fA-F0-9]{40}/);
+                    if (!match)
+                        return { text: "Please provide a wallet address." };
+                    try {
+                        const res = await fetch(`${apiUrl}/api/v1/wallet/${match[0]}/passport`, { headers });
+                        if (!res.ok)
+                            throw new Error(`HTTP ${res.status}`);
+                        const data = await res.json();
+                        const p = data.passport;
+                        return {
+                            text: `🛡️ Reputation Passport\n\n- Trust Level: ${p.trustLevel.toUpperCase()}\n- Reputation: ${p.reputationScore}\n- Reviews: ${p.totalReviews}\n- Scarab: ${data.scarab?.balance || 0} 🪲\n- Fee Tier: ${p.feeTier.discount}`,
+                            data,
+                        };
+                    }
+                    catch (error) {
+                        return { text: `❌ Error: ${error instanceof Error ? error.message : "Unknown error"}` };
+                    }
+                },
+            },
+            // --- NEW: DEFI_INFO ---
+            {
+                name: "DEFI_INFO",
+                description: "Look up a DeFi protocol by name or address",
+                examples: [
+                    "Tell me about USDC",
+                    "What's the trust score for Aerodrome?",
+                    "Look up 0x833589...",
+                ],
+                validate: async (message) => true,
+                handler: async (message) => {
+                    const addrMatch = message.match(/0x[a-fA-F0-9]{40}/);
+                    const slugMatch = message.match(/\b(usdc|weth|dai|aerodrome|aave|compound|morpho|uniswap|chainlink|stargate)\b/i);
+                    const query = addrMatch?.[0] || slugMatch?.[0]?.toLowerCase();
+                    if (!query)
+                        return { text: "Please specify a DeFi protocol name (e.g. USDC, Aave) or address." };
+                    try {
+                        const res = await fetch(`${apiUrl}/api/v1/defi/${query}`, { headers });
+                        if (!res.ok)
+                            throw new Error(res.status === 404 ? `"${query}" not found` : `HTTP ${res.status}`);
+                        const data = await res.json();
+                        const e = data.entity;
+                        return {
+                            text: `📊 ${e.name}\n\n- Address: \`${e.address}\`\n- Category: ${e.category}\n- Trust: ${data.trust?.score ?? "N/A"}/10\n- Reviews: ${data.reviews?.total || 0}`,
+                            data,
+                        };
+                    }
+                    catch (error) {
+                        return { text: `❌ Error: ${error instanceof Error ? error.message : "Unknown error"}` };
+                    }
+                },
+            },
+            // --- NEW: AGENT_INFO ---
+            {
+                name: "AGENT_INFO",
+                description: "Look up an AI agent by name or address",
+                examples: [
+                    "Tell me about AIXBT",
+                    "What's Virtuals trust score?",
+                    "Look up agent 0x4f9fd6...",
+                ],
+                validate: async (message) => true,
+                handler: async (message) => {
+                    const addrMatch = message.match(/0x[a-fA-F0-9]{40}/);
+                    const slugMatch = message.match(/\b(aixbt|virtuals|luna|vaderai|freysa|sekoia)\b/i);
+                    const query = addrMatch?.[0] || slugMatch?.[0]?.toLowerCase();
+                    if (!query)
+                        return { text: "Please specify an agent name (e.g. AIXBT, Virtuals) or address." };
+                    try {
+                        const res = await fetch(`${apiUrl}/api/v1/agent/${query}`, { headers });
+                        if (!res.ok)
+                            throw new Error(res.status === 404 ? `"${query}" not found` : `HTTP ${res.status}`);
+                        const data = await res.json();
+                        const e = data.entity;
+                        return {
+                            text: `🤖 ${e.name}\n\n- Address: \`${e.address}\`\n- Category: ${e.category}\n- Trust: ${data.trust?.score ?? "N/A"}/10\n- Reviews: ${data.reviews?.total || 0}`,
+                            data,
+                        };
+                    }
+                    catch (error) {
+                        return { text: `❌ Error: ${error instanceof Error ? error.message : "Unknown error"}` };
+                    }
+                },
+            },
         ],
         evaluators: [
             {
@@ -120,7 +296,7 @@ export function maiatPlugin(config = {}) {
                 description: "Provides trust scoring context for agent reasoning",
                 handler: async () => {
                     return {
-                        text: "You have access to Maiat trust scoring. Before interacting with any unknown on-chain address, use CHECK_TRUST to verify it's safe. Addresses scoring below 3.0/10 should be avoided.",
+                        text: "You have Maiat trust scoring. Use CHECK_TRUST for address safety, SUBMIT_REVIEW to review contracts, GET_INTERACTIONS to discover wallet activity, GET_PASSPORT for reputation, DEFI_INFO/AGENT_INFO to look up protocols and agents.",
                     };
                 },
             },

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@jhinresh/elizaos-plugin",
-  "version": "0.1.2",
-  "description": "Maiat Trust Score plugin for ElizaOS — verify trust before your agent swaps or transacts",
+  "version": "0.2.0",
+  "description": "Maiat Trust Score plugin for ElizaOS — trust-gated agent interactions",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
@@ -10,23 +10,14 @@
     "build": "tsc",
     "dev": "tsc --watch"
   },
+  "devDependencies": {
+    "typescript": "^5.5.0"
+  },
   "keywords": [
     "maiat",
     "elizaos",
-    "eliza",
     "ai16z",
     "trust-score",
-    "ai-agent",
-    "web3",
-    "defi",
-    "base"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/JhiNResH/elizaos-plugin-maiat.git"
-  },
-  "homepage": "https://maiat-protocol.vercel.app",
-  "devDependencies": {
-    "typescript": "^5.5.0"
-  }
+    "ai-agent"
+  ]
 }

package/src/index.ts CHANGED Viewed

@@ -3,10 +3,13 @@
  *
  * Maiat Trust Score plugin for ElizaOS (ai16z agent framework).
  *
- * Adds trust checking capabilities to any ElizaOS agent:
- * - "Is this address safe?" → trust score lookup
- * - Auto-gate transactions before execution
- * - Report transaction outcomes back to Maiat
+ * V0.2.0 — Cold-start update:
+ * - CHECK_TRUST: Trust score lookup (existing)
+ * - SUBMIT_REVIEW: Submit reviews with Scarab staking
+ * - GET_INTERACTIONS: Discover wallet contract interactions
+ * - GET_PASSPORT: Reputation passport
+ * - DEFI_INFO: Query DeFi protocols
+ * - AGENT_INFO: Query AI agents
  *
  * @example
  * ```typescript
@@ -42,20 +45,30 @@ interface TrustResult {
 //  API Client (lightweight)
 // ═══════════════════════════════════════════
+function getHeaders(config: MaiatElizaConfig): Record<string, string> {
+  const h: Record<string, string> = {
+    "Content-Type": "application/json",
+    "User-Agent": "maiat-elizaos-plugin/0.2.0",
+  };
+  if (config.apiKey) h["Authorization"] = `Bearer ${config.apiKey}`;
+  return h;
+}
+function getApiUrl(config: MaiatElizaConfig): string {
+  return config.apiUrl || "https://maiat-protocol.vercel.app";
+}
 async function queryMaiat(
   address: string,
   config: MaiatElizaConfig
 ): Promise<TrustResult> {
-  const apiUrl = config.apiUrl || "https://maiat-protocol.vercel.app";
+  const apiUrl = getApiUrl(config);
   const chain = config.chain || "base";
   const minScore = config.minScore ?? 3.0;
-  const headers: Record<string, string> = {
-    "User-Agent": "maiat-elizaos-plugin/0.1.0",
-  };
-  if (config.apiKey) headers["Authorization"] = `Bearer ${config.apiKey}`;
-  const res = await fetch(`${apiUrl}/api/v1/score/${address}?chain=${chain}`, { headers });
+  const res = await fetch(`${apiUrl}/api/v1/score/${address}?chain=${chain}`, {
+    headers: getHeaders(config),
+  });
   if (!res.ok) {
     throw new Error(`Maiat API error: ${res.status}`);
@@ -80,16 +93,20 @@ async function queryMaiat(
  * ElizaOS plugin definition following the standard plugin interface.
  *
  * Registers:
- * - Action: CHECK_TRUST — responds to "is 0x... safe?" type queries
- * - Evaluator: TRUST_GATE — evaluates if an address should be interacted with
- * - Provider: TRUST_DATA — provides trust context for agent reasoning
+ * - Actions: CHECK_TRUST, SUBMIT_REVIEW, GET_INTERACTIONS, GET_PASSPORT, DEFI_INFO, AGENT_INFO
+ * - Evaluator: TRUST_GATE
+ * - Provider: TRUST_DATA
  */
 export function maiatPlugin(config: MaiatElizaConfig = {}) {
+  const apiUrl = getApiUrl(config);
+  const headers = getHeaders(config);
   return {
     name: "maiat-trust",
     description: "Trust scoring for on-chain addresses via Maiat Protocol",
     actions: [
+      // --- Existing: CHECK_TRUST ---
       {
         name: "CHECK_TRUST",
         description: "Check the trust score of an on-chain address",
@@ -120,6 +137,165 @@ export function maiatPlugin(config: MaiatElizaConfig = {}) {
           }
         },
       },
+      // --- NEW: SUBMIT_REVIEW ---
+      {
+        name: "SUBMIT_REVIEW",
+        description: "Submit a trust review for a contract. Costs 2 Scarab, earn 3-10 for quality.",
+        examples: [
+          "Review 0x833589... — rating 8, great stablecoin",
+          "Submit review: address 0xabc, rating 3, seems risky",
+        ],
+        validate: async (message: string) => /0x[a-fA-F0-9]{40}/.test(message) && /\d/.test(message),
+        handler: async (message: string) => {
+          const addrMatch = message.match(/0x[a-fA-F0-9]{40}/);
+          const ratingMatch = message.match(/rating\s*:?\s*(\d+)/i) || message.match(/(\d+)\s*\/\s*10/);
+          if (!addrMatch) return { text: "Please provide a contract address (0x...)" };
+          const rating = ratingMatch ? Math.min(10, Math.max(1, parseInt(ratingMatch[1]))) : 5;
+          try {
+            const res = await fetch(`${apiUrl}/api/v1/review`, {
+              method: "POST",
+              headers,
+              body: JSON.stringify({
+                address: addrMatch[0],
+                rating,
+                comment: message,
+                reviewer: "eliza-agent",
+              }),
+            });
+            const data = await res.json();
+            if (!res.ok) throw new Error(data.error || `HTTP ${res.status}`);
+            return {
+              text: `✅ Review submitted!\n\n- Address: \`${addrMatch[0]}\`\n- Rating: ${rating}/10\n- Scarab earned: ${data.meta?.scarabReward || 0} 🪲`,
+              data,
+            };
+          } catch (error) {
+            return { text: `❌ Review failed: ${error instanceof Error ? error.message : "Unknown error"}` };
+          }
+        },
+      },
+      // --- NEW: GET_INTERACTIONS ---
+      {
+        name: "GET_INTERACTIONS",
+        description: "Discover which contracts a wallet has interacted with",
+        examples: [
+          "What contracts has 0x1234... interacted with?",
+          "Show interactions for 0xabcd...",
+        ],
+        validate: async (message: string) => /0x[a-fA-F0-9]{40}/.test(message),
+        handler: async (message: string) => {
+          const match = message.match(/0x[a-fA-F0-9]{40}/);
+          if (!match) return { text: "Please provide a wallet address." };
+          try {
+            const res = await fetch(`${apiUrl}/api/v1/wallet/${match[0]}/interactions`, { headers });
+            if (!res.ok) throw new Error(`HTTP ${res.status}`);
+            const data = await res.json();
+            const list = data.interacted?.map((c: { name: string; category: string; txCount: number }) =>
+              `  • ${c.name} (${c.category}) — ${c.txCount} txs`
+            ).join("\n") || "None found";
+            return {
+              text: `📋 Wallet Interactions (${data.interactedCount} contracts):\n\n${list}`,
+              data,
+            };
+          } catch (error) {
+            return { text: `❌ Error: ${error instanceof Error ? error.message : "Unknown error"}` };
+          }
+        },
+      },
+      // --- NEW: GET_PASSPORT ---
+      {
+        name: "GET_PASSPORT",
+        description: "Get a wallet's reputation passport",
+        examples: [
+          "Show passport for 0x1234...",
+          "What's my reputation level?",
+        ],
+        validate: async (message: string) => /0x[a-fA-F0-9]{40}/.test(message),
+        handler: async (message: string) => {
+          const match = message.match(/0x[a-fA-F0-9]{40}/);
+          if (!match) return { text: "Please provide a wallet address." };
+          try {
+            const res = await fetch(`${apiUrl}/api/v1/wallet/${match[0]}/passport`, { headers });
+            if (!res.ok) throw new Error(`HTTP ${res.status}`);
+            const data = await res.json();
+            const p = data.passport;
+            return {
+              text: `🛡️ Reputation Passport\n\n- Trust Level: ${p.trustLevel.toUpperCase()}\n- Reputation: ${p.reputationScore}\n- Reviews: ${p.totalReviews}\n- Scarab: ${data.scarab?.balance || 0} 🪲\n- Fee Tier: ${p.feeTier.discount}`,
+              data,
+            };
+          } catch (error) {
+            return { text: `❌ Error: ${error instanceof Error ? error.message : "Unknown error"}` };
+          }
+        },
+      },
+      // --- NEW: DEFI_INFO ---
+      {
+        name: "DEFI_INFO",
+        description: "Look up a DeFi protocol by name or address",
+        examples: [
+          "Tell me about USDC",
+          "What's the trust score for Aerodrome?",
+          "Look up 0x833589...",
+        ],
+        validate: async (message: string) => true,
+        handler: async (message: string) => {
+          const addrMatch = message.match(/0x[a-fA-F0-9]{40}/);
+          const slugMatch = message.match(/\b(usdc|weth|dai|aerodrome|aave|compound|morpho|uniswap|chainlink|stargate)\b/i);
+          const query = addrMatch?.[0] || slugMatch?.[0]?.toLowerCase();
+          if (!query) return { text: "Please specify a DeFi protocol name (e.g. USDC, Aave) or address." };
+          try {
+            const res = await fetch(`${apiUrl}/api/v1/defi/${query}`, { headers });
+            if (!res.ok) throw new Error(res.status === 404 ? `"${query}" not found` : `HTTP ${res.status}`);
+            const data = await res.json();
+            const e = data.entity;
+            return {
+              text: `📊 ${e.name}\n\n- Address: \`${e.address}\`\n- Category: ${e.category}\n- Trust: ${data.trust?.score ?? "N/A"}/10\n- Reviews: ${data.reviews?.total || 0}`,
+              data,
+            };
+          } catch (error) {
+            return { text: `❌ Error: ${error instanceof Error ? error.message : "Unknown error"}` };
+          }
+        },
+      },
+      // --- NEW: AGENT_INFO ---
+      {
+        name: "AGENT_INFO",
+        description: "Look up an AI agent by name or address",
+        examples: [
+          "Tell me about AIXBT",
+          "What's Virtuals trust score?",
+          "Look up agent 0x4f9fd6...",
+        ],
+        validate: async (message: string) => true,
+        handler: async (message: string) => {
+          const addrMatch = message.match(/0x[a-fA-F0-9]{40}/);
+          const slugMatch = message.match(/\b(aixbt|virtuals|luna|vaderai|freysa|sekoia)\b/i);
+          const query = addrMatch?.[0] || slugMatch?.[0]?.toLowerCase();
+          if (!query) return { text: "Please specify an agent name (e.g. AIXBT, Virtuals) or address." };
+          try {
+            const res = await fetch(`${apiUrl}/api/v1/agent/${query}`, { headers });
+            if (!res.ok) throw new Error(res.status === 404 ? `"${query}" not found` : `HTTP ${res.status}`);
+            const data = await res.json();
+            const e = data.entity;
+            return {
+              text: `🤖 ${e.name}\n\n- Address: \`${e.address}\`\n- Category: ${e.category}\n- Trust: ${data.trust?.score ?? "N/A"}/10\n- Reviews: ${data.reviews?.total || 0}`,
+              data,
+            };
+          } catch (error) {
+            return { text: `❌ Error: ${error instanceof Error ? error.message : "Unknown error"}` };
+          }
+        },
+      },
     ],
     evaluators: [
@@ -152,7 +328,7 @@ export function maiatPlugin(config: MaiatElizaConfig = {}) {
         description: "Provides trust scoring context for agent reasoning",
         handler: async () => {
           return {
-            text: "You have access to Maiat trust scoring. Before interacting with any unknown on-chain address, use CHECK_TRUST to verify it's safe. Addresses scoring below 3.0/10 should be avoided.",
+            text: "You have Maiat trust scoring. Use CHECK_TRUST for address safety, SUBMIT_REVIEW to review contracts, GET_INTERACTIONS to discover wallet activity, GET_PASSPORT for reputation, DEFI_INFO/AGENT_INFO to look up protocols and agents.",
           };
         },
       },

package/README.md DELETED Viewed

@@ -1,66 +0,0 @@
-# @jhinresh/elizaos-plugin
-> Maiat Trust Score plugin for ElizaOS — verify trust before your agent swaps or transacts.
-Adds trust-checking actions and evaluators to any ElizaOS agent so it can **refuse to interact with low-trust addresses** before executing swaps, transfers, or on-chain actions.
-Powered by [Maiat Protocol](https://maiat-protocol.vercel.app) — on-chain verified trust scores for tokens, DeFi protocols, and AI agents on Base.
-## Install
-```bash
-npm install @jhinresh/elizaos-plugin
-```
-## Usage
-```typescript
-import { maiatPlugin } from "@jhinresh/elizaos-plugin";
-const agent = new ElizaAgent({
-  plugins: [
-    maiatPlugin({
-      minScore: 3.0,   // reject addresses with score < 3.0/10
-      chain: "base",
-    }),
-  ],
-});
-```
-## What it does
-| Component | Type | Behaviour |
-|-----------|------|-----------|
-| `CHECK_TRUST` | Action | Agent can ask "is 0x... safe?" and get a trust score |
-| `TRUST_GATE` | Evaluator | Runs before any swap/transfer — rejects low-trust addresses |
-| `TRUST_DATA` | Provider | Injects trust context into agent's world state |
-## Trust Score Scale
-| Score | Risk | Action |
-|-------|------|--------|
-| 7–10 | 🟢 Low | Allow |
-| 4–6.9 | 🟡 Medium | Warn |
-| 0–3.9 | 🔴 High | **Block** |
-## Config
-```typescript
-maiatPlugin({
-  apiUrl: "https://maiat-protocol.vercel.app",  // default
-  apiKey: "your-key",   // optional — free tier: 100 req/day
-  minScore: 3.0,        // 0–10 scale
-  chain: "base",        // base | bnb | solana
-})
-```
-## Links
-- 🌐 [Live app](https://maiat-protocol.vercel.app)
-- 📖 [API docs](https://maiat-protocol.vercel.app/docs)
-- 🔗 [GitHub](https://github.com/JhiNResH/maiat-protocol)
-- 📦 [npm](https://www.npmjs.com/package/@jhinresh/elizaos-plugin)
-## License
-MIT