cleanweb-eliza-plugin 1.0.0 → 1.0.2

package/README.md

@@ -1,28 +1,83 @@
-# 🌐 cleanweb-eliza-plugin
-
-> **Official CleanWeb Studio & A.GRID Intelligence Plugin for ElizaOS**  
-> *87% LLM Token Reduction, Fresh Ground-Truth Discovery, and Solana Mainnet x402 Micropayments*
-
----
-
-## ⚡ Features
-- 🚀 **87% Token Compression**: Strips ads, navigation, and boilerplate from any HTML page.
-- ☀️ **Solana Native x402 Micropayments**: Instant $0.001 USDC settlement with 0.4s finality.
-- 🛡️ **Zero-Injection Cleansing**: Neutralizes hidden CSS and prompt injection before LLM ingestion.
-- 🧠 **Eliza Brain Priority 0 Dispatch**: Syncs high-impact signals directly to A.GRID HQ.
-
-## 📦 Installation
-```bash
-npm install cleanweb-eliza-plugin
-```
-
-## 💻 Quick Start
-```typescript
-import { cleanWebPlugin } from "cleanweb-eliza-plugin";
-
-export default {
-  name: "MyAutonomousAgent",
-  plugins: [cleanWebPlugin],
-  ...
-};
-```
+# 🌐 cleanweb-eliza-plugin
+
+> **Official CleanWeb Studio & A.GRID Intelligence Plugin for ElizaOS (v2)**  
+> *87% LLM Token Reduction, Fresh Ground-Truth Discovery, Dual-Core Security Gate Attestations, and Solana/Multi-Chain x402 Autonomous Micropayments*
+
+[![npm version](https://img.shields.io/npm/v/cleanweb-eliza-plugin.svg)](https://www.npmjs.com/package/cleanweb-eliza-plugin)
+[![PyPI Core](https://img.shields.io/pypi/v/x402-cleanweb-agent?label=PyPI%20Core%20%28x402-cleanweb-agent%29&color=blue)](https://pypi.org/project/x402-cleanweb-agent/)
+[![Coinbase AgentKit](https://img.shields.io/npm/v/agentkit-cleanweb?label=agentkit-cleanweb&color=cb3837)](https://www.npmjs.com/package/agentkit-cleanweb)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## 🔗 Official CleanWeb Multi-Registry Suite (npm ↔ PyPI Companion Packages)
+
+`cleanweb-eliza-plugin` is part of the multi-registry CleanWeb Autonomous Intelligence Suite. Combine the **ElizaOS Plugin (`npm`)** with the **Python Core / MCP Server (`PyPI`)** and **Coinbase AgentKit Provider (`npm`)**:
+
+| Registry | Package | Role in Your Agent Stack | Install Command |
+| :---: | :--- | :--- | :--- |
+| **npm** | [**`cleanweb-eliza-plugin`**](https://www.npmjs.com/package/cleanweb-eliza-plugin) | **ElizaOS v2 Plugin** (Solana x402 Micropayments & A.GRID Priority 0 Dispatch) | `npm install cleanweb-eliza-plugin` |
+| **PyPI** | [**`x402-cleanweb-agent`**](https://pypi.org/project/x402-cleanweb-agent/) | **Python Core Engine, Claude/Cursor MCP Server & Dual-Core Eliza Brain** | `pip install x402-cleanweb-agent` *(or `uvx x402-cleanweb-agent`)* |
+| **npm** | [**`agentkit-cleanweb`**](https://www.npmjs.com/package/agentkit-cleanweb) | **Coinbase AgentKit Action Provider** (Base Mainnet EIP-712 & x402 Vaults) | `npm install agentkit-cleanweb @coinbase/agentkit` |
+
+---
+
+## ⚡ Key Capabilities
+- 🚀 **87% Token Compression**: Strips ads, navigation, scripts, and HTML boilerplate—saving 85%+ in LLM input token costs on every web query.
+- ☀️ **Solana & Multi-Chain x402 Micropayments**: Instant `$0.001 USDC` settlement on Solana (`0.4s` finality), Base, Polygon, and Arbitrum.
+- 🛡️ **Zero-Injection Cleansing (Security Gate)**: Neutralizes hidden CSS, Unicode steganography, and indirect prompt injection before LLM ingestion.
+- 🧠 **ElizaOS Brain Causality & Priority 0 Dispatch**: Evaluates signal actionability (`Brier Score < 0.038`), predicts 0.5–4h market lead times, and dispatches Priority 0 alerts to A.GRID HQ.
+- 🔐 **Double Cryptographic Seal**: Every extracted payload is verifiable via Keccak-256 Merkle Root + EIP-712 Oracle Signature.
+
+---
+
+## 📦 Installation
+
+```bash
+# 1. Install the ElizaOS v2 Plugin (TypeScript / Node.js)
+npm install cleanweb-eliza-plugin
+
+# 2. (Recommended) Install the Companion Python Core & MCP Server
+pip install x402-cleanweb-agent
+```
+
+---
+
+## 💻 Quick Start (ElizaOS Character Configuration)
+
+```typescript
+import { cleanWebPlugin } from "cleanweb-eliza-plugin";
+
+export default {
+  name: "AutonomousAlphaAgent",
+  plugins: [cleanWebPlugin],
+  settings: {
+    secrets: {
+      CLEANWEB_VAULT_KEY: process.env.CLEANWEB_VAULT_KEY,
+    },
+  },
+};
+```
+
+---
+
+## 🖥️ Companion MCP Server Setup (Claude Desktop, Cursor, Windsurf)
+
+Pair your ElizaOS agent with the Python MCP Server from [`x402-cleanweb-agent` (PyPI)](https://pypi.org/project/x402-cleanweb-agent/):
+
+```json
+{
+  "mcpServers": {
+    "x402-cleanweb": {
+      "command": "uvx",
+      "args": ["x402-cleanweb-agent"]
+    }
+  }
+}
+```
+
+---
+
+## 📄 License
+
+MIT © [CleanWeb & A.GRID Protocol](https://github.com/nohosa001-pixel/x402-cleanweb-agent)

package/package.json

@@ -1,47 +1,47 @@
-{
-  "name": "cleanweb-eliza-plugin",
-  "version": "1.0.0",
-  "description": "CleanWeb 87% token-compressed ad-free web intelligence, fresh ground truth discovery, and Solana x402 autonomous micropayments for ElizaOS",
-  "main": "dist/index.js",
-  "module": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "type": "module",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/nohosa001-pixel/x402-cleanweb-agent.git",
-    "directory": "packages/plugin-cleanweb"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "node --test"
-  },
-  "keywords": [
-    "elizaos",
-    "eliza",
-    "cleanweb",
-    "solana",
-    "x402",
-    "web-scraping",
-    "ground-truth",
-    "token-reduction",
-    "ai-agent"
-  ],
-  "author": "CleanWeb & A.GRID Team",
-  "license": "MIT",
-  "peerDependencies": {
-    "@elizaos/core": ">=2.0.0-0"
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "typescript": "^5.8.2",
-    "@types/node": "^22.13.0"
-  },
-  "files": [
-    "dist",
-    "src",
-    "README.md"
-  ]
+{
+  "name": "cleanweb-eliza-plugin",
+  "version": "1.0.2",
+  "description": "CleanWeb 87% token-compressed ad-free web intelligence, fresh ground truth discovery, and Solana x402 autonomous micropayments for ElizaOS",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nohosa001-pixel/x402-cleanweb-agent.git",
+    "directory": "packages/plugin-cleanweb"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --test"
+  },
+  "keywords": [
+    "elizaos",
+    "eliza",
+    "cleanweb",
+    "solana",
+    "x402",
+    "web-scraping",
+    "ground-truth",
+    "token-reduction",
+    "ai-agent"
+  ],
+  "author": "CleanWeb & A.GRID Team",
+  "license": "MIT",
+  "peerDependencies": {
+    "@elizaos/core": ">=2.0.0-0"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.8.2",
+    "@types/node": "^22.13.0"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ]
 }

package/src/actions/scrape.ts

@@ -1,52 +1,52 @@
-export const scrapeWebAction = {
-  name: "CLEANWEB_SCRAPE",
-  similes: ["FETCH_CLEAN_URL", "BROWSE_PAGE_NOISE_FREE", "READ_ARTICLE_CLEAN"],
-  description: "Scrapes any webpage URL and returns pure, LLM-optimized Markdown with 87% token reduction and zero HTML boilerplate.",
-  validate: async (runtime: any, message: any) => {
-    const text = message.content?.text || "";
-    return /https?:\/\/[^\s]+/i.test(text);
-  },
-  handler: async (runtime: any, message: any, state: any, options: any, callback: any) => {
-    const text = message.content?.text || "";
-    const urlMatch = text.match(/https?:\/\/[^\s]+/i);
-    if (!urlMatch) {
-      if (callback) callback({ text: "URL을 찾을 수 없습니다." });
-      return false;
-    }
-    const targetUrl = urlMatch[0];
-    const gateway = process.env.CLEANWEB_GATEWAY_URL || "https://x402-cleanweb-agent-212942243360.asia-northeast3.run.app";
-    const endpoint = `${gateway}/r/${encodeURIComponent(targetUrl)}`;
-
-    try {
-      const resp = await fetch(endpoint, {
-        headers: {
-          "User-Agent": "ElizaOS-CleanWebPlugin/1.0",
-          "X-Agent-Nonce": runtime.character?.name || "eliza_agent",
-          "Accept": "text/markdown, application/json"
-        }
-      });
-
-      if (resp.status === 402) {
-        const solanaNotice = "⚡ HTTP 402 Payment Required: Solana Agent Payment Vault (7oZ16Ya...) or 0.001 USDC required.";
-        if (callback) callback({ text: solanaNotice });
-        return true;
-      }
-
-      const cleanText = await resp.text();
-      const compression = resp.headers.get("x-token-compression") || "87%";
-      const resultMsg = `[CleanWeb Studio | ${compression} Token Compression]\n\n${cleanText.slice(0, 3000)}`;
-
-      if (callback) callback({ text: resultMsg });
-      return true;
-    } catch (err: any) {
-      if (callback) callback({ text: `CleanWeb fetch failed: ${err.message}` });
-      return false;
-    }
-  },
-  examples: [
-    [
-      { user: "{{user1}}", content: { text: "이 뉴스 기사 내용 정리해줘 https://example.com/news" } },
-      { user: "{{agentName}}", content: { text: "CleanWeb으로 87% 압축된 고순도 마크다운을 분석합니다...", action: "CLEANWEB_SCRAPE" } }
-    ]
-  ]
-};
+export const scrapeWebAction = {
+  name: "CLEANWEB_SCRAPE",
+  similes: ["FETCH_CLEAN_URL", "BROWSE_PAGE_NOISE_FREE", "READ_ARTICLE_CLEAN"],
+  description: "Scrapes any webpage URL and returns pure, LLM-optimized Markdown with 87% token reduction and zero HTML boilerplate.",
+  validate: async (runtime: any, message: any) => {
+    const text = message.content?.text || "";
+    return /https?:\/\/[^\s]+/i.test(text);
+  },
+  handler: async (runtime: any, message: any, state: any, options: any, callback: any) => {
+    const text = message.content?.text || "";
+    const urlMatch = text.match(/https?:\/\/[^\s]+/i);
+    if (!urlMatch) {
+      if (callback) callback({ text: "URL을 찾을 수 없습니다." });
+      return false;
+    }
+    const targetUrl = urlMatch[0];
+    const gateway = process.env.CLEANWEB_GATEWAY_URL || "https://x402-cleanweb-agent-212942243360.asia-northeast3.run.app";
+    const endpoint = `${gateway}/r/${encodeURIComponent(targetUrl)}`;
+
+    try {
+      const resp = await fetch(endpoint, {
+        headers: {
+          "User-Agent": "ElizaOS-CleanWebPlugin/1.0",
+          "X-Agent-Nonce": runtime.character?.name || "eliza_agent",
+          "Accept": "text/markdown, application/json"
+        }
+      });
+
+      if (resp.status === 402) {
+        const solanaNotice = "⚡ HTTP 402 Payment Required: Solana Agent Payment Vault (7oZ16Ya...) or 0.001 USDC required.";
+        if (callback) callback({ text: solanaNotice });
+        return true;
+      }
+
+      const cleanText = await resp.text();
+      const compression = resp.headers.get("x-token-compression") || "87%";
+      const resultMsg = `[CleanWeb Studio | ${compression} Token Compression]\n\n${cleanText.slice(0, 3000)}`;
+
+      if (callback) callback({ text: resultMsg });
+      return true;
+    } catch (err: any) {
+      if (callback) callback({ text: `CleanWeb fetch failed: ${err.message}` });
+      return false;
+    }
+  },
+  examples: [
+    [
+      { user: "{{user1}}", content: { text: "이 뉴스 기사 내용 정리해줘 https://example.com/news" } },
+      { user: "{{agentName}}", content: { text: "CleanWeb으로 87% 압축된 고순도 마크다운을 분석합니다...", action: "CLEANWEB_SCRAPE" } }
+    ]
+  ]
+};

package/src/evaluators/signal.ts

@@ -1,17 +1,17 @@
-export const groundTruthSignalEvaluator = {
-  name: "GROUND_TRUTH_EVALUATOR",
-  similes: ["EVALUATE_WORLD_SIGNAL", "ASSESS_CAUSALITY_IMPACT"],
-  description: "Evaluates incoming conversations and intelligence streams for critical policy shifts, trade disruptions, and economic invariants.",
-  validate: async (runtime: any, message: any) => {
-    const text = (message.content?.text || "").toLowerCase();
-    return ["eudr", "mineral", "deforestation", "port congestion", "export ban", "strike", "power grid"].some(k => text.includes(k));
-  },
-  handler: async (runtime: any, message: any) => {
-    return {
-      evaluated: true,
-      priority: "HIGH_GROUND_TRUTH",
-      syncToAGrid: true,
-      timestamp: new Date().toISOString()
-    };
-  }
-};
+export const groundTruthSignalEvaluator = {
+  name: "GROUND_TRUTH_EVALUATOR",
+  similes: ["EVALUATE_WORLD_SIGNAL", "ASSESS_CAUSALITY_IMPACT"],
+  description: "Evaluates incoming conversations and intelligence streams for critical policy shifts, trade disruptions, and economic invariants.",
+  validate: async (runtime: any, message: any) => {
+    const text = (message.content?.text || "").toLowerCase();
+    return ["eudr", "mineral", "deforestation", "port congestion", "export ban", "strike", "power grid"].some(k => text.includes(k));
+  },
+  handler: async (runtime: any, message: any) => {
+    return {
+      evaluated: true,
+      priority: "HIGH_GROUND_TRUTH",
+      syncToAGrid: true,
+      timestamp: new Date().toISOString()
+    };
+  }
+};

package/src/index.ts

@@ -1,17 +1,17 @@
-import { scrapeWebAction } from "./actions/scrape.js";
-import { cleanWebIntelligenceProvider } from "./providers/intelligence.js";
-import { groundTruthSignalEvaluator } from "./evaluators/signal.js";
-
-export const cleanWebPlugin = {
-  name: "cleanweb",
-  description: "CleanWeb Studio 87% Token Reduction, Fresh Ground Truth Discovery, and Solana x402 Autonomous Micropayment Rail for ElizaOS",
-  actions: [scrapeWebAction],
-  providers: [cleanWebIntelligenceProvider],
-  evaluators: [groundTruthSignalEvaluator],
-  services: []
-};
-
-export default cleanWebPlugin;
-export * from "./actions/scrape.js";
-export * from "./providers/intelligence.js";
-export * from "./evaluators/signal.js";
+import { scrapeWebAction } from "./actions/scrape.js";
+import { cleanWebIntelligenceProvider } from "./providers/intelligence.js";
+import { groundTruthSignalEvaluator } from "./evaluators/signal.js";
+
+export const cleanWebPlugin = {
+  name: "cleanweb",
+  description: "CleanWeb Studio 87% Token Reduction, Fresh Ground Truth Discovery, and Solana x402 Autonomous Micropayment Rail for ElizaOS",
+  actions: [scrapeWebAction],
+  providers: [cleanWebIntelligenceProvider],
+  evaluators: [groundTruthSignalEvaluator],
+  services: []
+};
+
+export default cleanWebPlugin;
+export * from "./actions/scrape.js";
+export * from "./providers/intelligence.js";
+export * from "./evaluators/signal.js";

package/src/providers/intelligence.ts

@@ -1,17 +1,17 @@
-export const cleanWebIntelligenceProvider = {
-  get: async (runtime: any, message: any, state: any) => {
-    const gateway = process.env.CLEANWEB_GATEWAY_URL || "https://x402-cleanweb-agent-212942243360.asia-northeast3.run.app";
-    return {
-      provider: "CleanWeb & A.GRID Global Intelligence",
-      capabilities: [
-        "87% Token Reduced Web Scraping",
-        "EUDR & Critical Mineral Ground-Truth Invariants",
-        "Solana Mainnet 0.4s x402 Micropayments",
-        "Merkle Proof Cryptographic Verification"
-      ],
-      gatewayUrl: gateway,
-      treasuryRecipient: "411ksMz9RHYVtVMe6RUUErzZYtrU9zzvkgzswKbqx9qp",
-      tokenMint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
-    };
-  }
-};
+export const cleanWebIntelligenceProvider = {
+  get: async (runtime: any, message: any, state: any) => {
+    const gateway = process.env.CLEANWEB_GATEWAY_URL || "https://x402-cleanweb-agent-212942243360.asia-northeast3.run.app";
+    return {
+      provider: "CleanWeb & A.GRID Global Intelligence",
+      capabilities: [
+        "87% Token Reduced Web Scraping",
+        "EUDR & Critical Mineral Ground-Truth Invariants",
+        "Solana Mainnet 0.4s x402 Micropayments",
+        "Merkle Proof Cryptographic Verification"
+      ],
+      gatewayUrl: gateway,
+      treasuryRecipient: "411ksMz9RHYVtVMe6RUUErzZYtrU9zzvkgzswKbqx9qp",
+      tokenMint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
+    };
+  }
+};