@zshuangmu/agenthub 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 AgentHub
+
+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,176 @@
+<div align="center">
+
+# 🤖 AgentHub
+
+**The Open Source Marketplace for AI Agents**
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Node: >=18](https://img.shields.io/badge/Node.js->=18-green.svg)](https://nodejs.org/)
+[![GitHub Stars](https://img.shields.io/github/stars/agenthub/agenthub?style=social)](https://github.com/agenthub/agenthub)
+
+**Package and upload your Agent's full capabilities in one command.<br>Download and gain those powers with one click.**
+
+🌐 **Live Demo**: [https://agenthub.cyou](https://agenthub.cyou/)
+
+[English](README.md) | [中文](README_CN.md)
+
+</div>
+
+---
+
+## 🎯 What is AgentHub?
+
+AgentHub is an open-source platform for packaging and distributing AI Agents. It allows you to:
+
+- **📦 Package** your Agent's personality, memory, and skills into a single bundle
+- **🚀 Publish** to a local or remote registry with one command
+- **🔍 Discover** and search agents from the marketplace
+- **⚡ Install** agents to any workspace instantly
+
+Perfect for teams who want to share AI capabilities across projects, or individuals who want to backup and version their agent configurations.
+
+## ✨ Features
+
+| Feature | Description |
+|---------|-------------|
+| 📦 **One-Click Packaging** | Automatically scan workspace and package Agent capabilities |
+| 🚀 **Local-First** | No cloud required, runs entirely on your machine |
+| 🌐 **Web Interface** | Beautiful dark-themed UI with i18n support (EN/中文) |
+| 🔐 **Memory Layers** | Three-tier memory: public, portable, private |
+| 🔄 **Version Control** | Full version history with rollback support |
+| 📊 **Analytics** | Built-in download tracking and statistics |
+
+## 📸 Screenshots
+
+![alt text](./docs/image.png)
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/agenthub/agenthub.git
+cd agenthub
+
+# Install dependencies
+npm install
+
+# Link globally (optional)
+npm link
+```
+
+### Basic Usage
+
+```bash
+# 1. Pack your agent
+agenthub pack --workspace ./my-agent --config openclaw.json
+
+# 2. Publish to registry
+agenthub publish ./bundles/my-agent.agent --registry ./.registry
+
+# 3. Start web interface
+agenthub serve --registry ./.registry --port 3000
+```
+
+Visit http://localhost:3000 to see your agents!
+
+## 📖 Documentation
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `pack` | Pack workspace into Agent Bundle |
+| `publish` | Publish to local registry |
+| `publish-remote` | Publish to remote server |
+| `search` | Search agents in registry |
+| `info` | View agent details |
+| `install` | Install agent to workspace |
+| `serve` | Start web + API service |
+| `api` | Start API server only |
+| `web` | Start web frontend only |
+
+### HTTP API
+
+```bash
+# List all agents
+curl http://localhost:3001/api/agents
+
+# Search agents
+curl "http://localhost:3001/api/agents?q=react"
+
+# Get agent details
+curl http://localhost:3001/api/agents/my-agent
+
+# Get statistics
+curl http://localhost:3001/api/stats
+```
+
+### AI Auto-Discovery
+
+Let your AI assistant automatically discover available agents:
+
+```bash
+curl http://localhost:3001/api/skills/agenthub-discover
+```
+
+## 🏗️ Architecture
+
+```
+┌─────────────────┐     pack      ┌─────────────────┐    publish    ┌─────────────────┐
+│   OpenClaw      │  ──────────►  │    Bundle       │  ──────────►  │    Registry     │
+│   Workspace     │               │   (*.agent)     │               │   (.registry)   │
+└─────────────────┘               └─────────────────┘               └─────────────────┘
+                                                                          │
+                                          ┌───────────────────────────────┘
+                                          │
+                                          ▼
+                                  ┌─────────────────┐
+                                  │   AgentHub      │
+                                  │   Web + API     │
+                                  └─────────────────┘
+```
+
+## 🧪 Development
+
+```bash
+# Run tests
+npm test
+
+# Start development server
+node src/cli.js serve --registry ./.registry
+```
+
+## 🐳 Docker Deployment
+
+```bash
+# Production start (in container)
+NODE_ENV=production node src/cli.js serve --registry ./.registry --port 3000 --host 0.0.0.0
+```
+
+## 🤝 Contributing
+
+We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+- 🐛 [Report a Bug](https://github.com/agenthub/agenthub/issues/new?template=bug_report.md)
+- 💡 [Request a Feature](https://github.com/agenthub/agenthub/issues/new?template=feature_request.md)
+- 🔧 [Submit a Pull Request](https://github.com/agenthub/agenthub/pulls)
+
+## 📄 License
+
+[MIT License](LICENSE) © AgentHub Team
+
+## 🙏 Acknowledgments
+
+- Built for [OpenClaw](https://github.com/openclaw) ecosystem
+- Inspired by npm and Docker Hub
+
+---
+
+<div align="center">
+
+**[⬆ Back to Top](#agenthub)**
+
+Made with ❤️ by the AgentHub Team
+
+</div>

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@zshuangmu/agenthub",
+  "version": "0.1.0",
+  "description": "AI Agent 打包与分发平台 - 一句话打包上传，一键下载获得能力",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "agenthub": "src/cli.js"
+  },
+  "files": [
+    "src/"
+  ],
+  "scripts": {
+    "test": "NODE_OPTIONS='' node --test",
+    "start": "node src/cli.js serve --registry ./.registry --port 3000 --host 0.0.0.0"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "openclaw",
+    "package-manager",
+    "registry",
+    "cli"
+  ],
+  "author": "AgentHub Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/itshaungmu/AgentHub.git"
+  },
+  "bugs": {
+    "url": "https://github.com/itshaungmu/AgentHub/issues"
+  },
+  "homepage": "https://github.com/itshaungmu/AgentHub#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "sql.js": "^1.14.1"
+  }
+}

package/src/api-server.js

@@ -0,0 +1,195 @@
+import http from "node:http";
+import path from "node:path";
+import { readFile } from "node:fs/promises";
+import { infoCommand, installCommand, publishCommand, searchCommand } from "./index.js";
+import { publishUploadedBundle } from "./lib/bundle-transfer.js";
+import { notFound, readJsonBody, sendJson } from "./lib/http.js";
+import {
+  initDatabase,
+  incrementDownloads,
+  getAgentDownloads,
+  getAgentsDownloads,
+  getTotalDownloads,
+  getDownloadRanking,
+  getRecentDownloads,
+  getDatabaseStats
+} from "./lib/database.js";
+
+// 安全配置
+const ALLOWED_ORIGINS = process.env.ALLOWED_ORIGINS?.split(",") || ["*"];
+const MAX_UPLOAD_SIZE = parseInt(process.env.MAX_UPLOAD_SIZE || "10485760", 10); // 10MB default
+const RATE_LIMIT_WINDOW = 60000; // 1 minute
+const RATE_LIMIT_MAX = parseInt(process.env.RATE_LIMIT_MAX || "100", 10); // 100 requests per minute
+
+// 简单的速率限制器
+const rateLimiter = new Map();
+
+function checkRateLimit(ip) {
+  const now = Date.now();
+  const windowStart = now - RATE_LIMIT_WINDOW;
+  const requests = rateLimiter.get(ip) || [];
+  const recentRequests = requests.filter(t => t > windowStart);
+  if (recentRequests.length >= RATE_LIMIT_MAX) {
+    return false;
+  }
+  recentRequests.push(now);
+  rateLimiter.set(ip, recentRequests);
+  return true;
+}
+
+// slug 格式验证
+function isValidSlug(slug) {
+  return /^[a-z0-9-]+$/.test(slug) && slug.length <= 100;
+}
+
+export async function createApiServer({ registryDir, port = 3000 }) {
+  // 初始化数据库
+  await initDatabase(registryDir);
+
+  const server = http.createServer(async (request, response) => {
+    const origin = request.headers.origin || "*";
+    const allowedOrigin = ALLOWED_ORIGINS.includes("*") || ALLOWED_ORIGINS.includes(origin)
+      ? (ALLOWED_ORIGINS.includes("*") ? "*" : origin)
+      : ALLOWED_ORIGINS[0];
+
+    // CORS 头
+    const corsHeaders = {
+      "Access-Control-Allow-Origin": allowedOrigin,
+      "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+      "Access-Control-Allow-Headers": "Content-Type",
+      "X-Content-Type-Options": "nosniff",
+      "X-Frame-Options": "DENY"
+    };
+
+    // 速率限制检查
+    const clientIp = request.socket.remoteAddress;
+    if (!checkRateLimit(clientIp)) {
+      response.writeHead(429, { "Content-Type": "application/json", ...corsHeaders });
+      response.end(JSON.stringify({ error: "Too many requests" }));
+      return;
+    }
+
+    // 处理预检请求
+    if (request.method === "OPTIONS") {
+      response.writeHead(204, corsHeaders);
+      response.end();
+      return;
+    }
+
+    try {
+      const url = new URL(request.url, "http://127.0.0.1");
+
+      // API: 获取 AgentHub Discover Skill
+      if (url.pathname === "/api/skills/agenthub-discover") {
+        try {
+          const skillPath = path.join(process.cwd(), "skills", "agenthub-discover", "SKILL.md");
+          const content = await readFile(skillPath, "utf8");
+          response.writeHead(200, {
+            "Content-Type": "text/markdown; charset=utf-8",
+            ...corsHeaders
+          });
+          response.end(content);
+        } catch {
+          response.writeHead(404, { "Content-Type": "application/json", ...corsHeaders });
+          response.end(JSON.stringify({ error: "Skill not found" }));
+        }
+        return;
+      }
+
+      // API: 获取 Agent 列表
+      if (url.pathname === "/api/agents") {
+        const agents = await searchCommand(url.searchParams.get("q") ?? "", { registry: registryDir });
+        const slugs = agents.map(a => a.slug);
+        const downloads = await getAgentsDownloads(registryDir, slugs);
+        const agentsWithDownloads = agents.map(a => ({ ...a, downloads: downloads[a.slug] || 0 }));
+        sendJson(response, 200, { agents: agentsWithDownloads }, corsHeaders);
+        return;
+      }
+
+      // API: 获取单个 Agent 详情
+      if (url.pathname.startsWith("/api/agents/")) {
+        const slug = url.pathname.slice("/api/agents/".length);
+        // 安全检查：验证 slug 格式
+        if (!isValidSlug(slug)) {
+          sendJson(response, 400, { error: "Invalid slug format" }, corsHeaders);
+          return;
+        }
+        const manifest = await infoCommand(slug, { registry: registryDir });
+        const downloads = await getAgentDownloads(registryDir, slug);
+        sendJson(response, 200, { ...manifest, downloads }, corsHeaders);
+        return;
+      }
+
+      // API: 发布 Agent
+      if (url.pathname === "/api/publish" && request.method === "POST") {
+        const body = await readJsonBody(request);
+        const manifest = await publishCommand(body.bundleDir, { registry: registryDir });
+        sendJson(response, 200, manifest, corsHeaders);
+        return;
+      }
+
+      // API: 上传发布 Agent
+      if (url.pathname === "/api/publish-upload" && request.method === "POST") {
+        const body = await readJsonBody(request);
+        const manifest = await publishUploadedBundle({ payload: body, registryDir });
+        sendJson(response, 200, manifest, corsHeaders);
+        return;
+      }
+
+      // API: 安装 Agent（记录下载）
+      if (url.pathname === "/api/install" && request.method === "POST") {
+        const body = await readJsonBody(request);
+        const result = await installCommand(body.agent, {
+          registry: registryDir,
+          targetWorkspace: body.targetWorkspace,
+        });
+        const slug = body.agent.split(":")[0];
+        await incrementDownloads(registryDir, slug, {
+          targetWorkspace: body.targetWorkspace,
+          ip: request.socket.remoteAddress,
+          userAgent: request.headers['user-agent']
+        });
+        sendJson(response, 200, result, corsHeaders);
+        return;
+      }
+
+      // API: 获取下载统计
+      if (url.pathname === "/api/stats") {
+        const stats = await getDatabaseStats(registryDir);
+        const ranking = await getDownloadRanking(registryDir, 10);
+        const recent = await getRecentDownloads(registryDir, 20);
+        sendJson(response, 200, { stats, ranking, recent }, corsHeaders);
+        return;
+      }
+
+      // API: 获取下载排行
+      if (url.pathname === "/api/stats/ranking") {
+        const limit = parseInt(url.searchParams.get("limit") || "10", 10);
+        const ranking = await getDownloadRanking(registryDir, limit);
+        sendJson(response, 200, { ranking }, corsHeaders);
+        return;
+      }
+
+      // API: 健康检查
+      if (url.pathname === "/api/health") {
+        sendJson(response, 200, { status: "ok", timestamp: new Date().toISOString() }, corsHeaders);
+        return;
+      }
+
+      notFound(response, corsHeaders);
+    } catch (error) {
+      sendJson(response, 500, { error: error.message }, corsHeaders);
+    }
+  });
+
+  await new Promise((resolve) => server.listen(port, "0.0.0.0", resolve));
+  const address = server.address();
+  const actualPort = typeof address === "object" && address ? address.port : port;
+
+  return {
+    server,
+    port: actualPort,
+    baseUrl: `http://127.0.0.1:${actualPort}`,
+    close: () => new Promise((resolve, reject) => server.close((error) => (error ? reject(error) : resolve()))),
+  };
+}