@f2a/network 0.1.2 → 0.1.3

package/packages/openclaw-adapter/README.md

@@ -1,510 +0,0 @@
-# @f2a/openclaw-adapter
-
-OpenClaw 插件，用于集成 F2A P2P 网络。
-
-## 功能
-
-- 🔍 **发现 Agents** - 发现局域网或公网中的其他 Agents
-- 📤 **委托任务** - 将任务委托给其他 Agent 执行
-- 📢 **广播任务** - 并行委托给多个 Agents
-- 🔐 **信誉系统** - 基于行为的 Peer 信誉评分
-- 🛡️ **安全控制** - 白名单、黑名单、手动确认
-
-## 安装
-
-```bash
-npm install @f2a/openclaw-adapter
-```
-
-## 配置
-
-在 OpenClaw 配置文件中添加：
-
-```json
-{
-  "plugins": {
-    "@f2a/openclaw-adapter": {
-      "enabled": true,
-      "config": {
-        "agentName": "My OpenClaw Agent",
-        "f2aPath": "~/projects/F2A",
-        "autoStart": true,
-        "webhookPort": 9002,
-        "controlPort": 9001,
-        "p2pPort": 9000,
-        "enableMDNS": true,
-        "webhookPush": {
-          "url": "https://your-openclaw-instance.com/webhook/f2a",
-          "token": "your-webhook-token",
-          "timeout": 5000,
-          "enabled": true
-        },
-        "processingTimeoutMs": 300000,
-        "maxQueuedTasks": 100,
-        "pollInterval": 60000,
-        "dataDir": "./f2a-data",
-        "reputation": {
-          "enabled": true,
-          "initialScore": 50,
-          "minScoreForService": 20
-        },
-        "security": {
-          "requireConfirmation": false,
-          "whitelist": [],
-          "blacklist": []
-        }
-      }
-    }
-  }
-}
-```
-
-### 配置项说明
-
-| 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| `agentName` | string | "OpenClaw Agent" | Agent 显示名称 |
-| `f2aPath` | string | "./F2A" | F2A Node 路径 |
-| `autoStart` | boolean | true | 是否自动启动 F2A Node |
-| `webhookPort` | number | 9002 | Webhook 服务端口 |
-| `controlPort` | number | 9001 | F2A 控制端口 |
-| `p2pPort` | number | 9000 | P2P 网络端口 |
-| `enableMDNS` | boolean | true | 是否启用 mDNS 发现 |
-| `webhookPush` | object | - | Webhook 推送配置，用于主动推送任务通知到 OpenClaw |
-| `webhookPush.url` | string | - | OpenClaw webhook URL |
-| `webhookPush.token` | string | - | 认证 token |
-| `webhookPush.timeout` | number | 5000 | 推送超时（毫秒） |
-| `webhookPush.enabled` | boolean | true | 是否启用 |
-| `processingTimeoutMs` | number | 300000 | processing 任务超时时间（毫秒），超过此时间将被重置为 pending，防止僵尸任务 |
-| `maxQueuedTasks` | number | 100 | 任务队列最大容量 |
-| `pollInterval` | number | 60000 | 兜底轮询间隔（毫秒） |
-| `dataDir` | string | "./f2a-data" | 数据持久化目录 |
-
-## 使用
-
-### 发现 Agents
-
-```
-用户: 帮我找一下网络里能写代码的 Agents
-
-OpenClaw: [调用 f2a_discover capability=code-generation]
-
-🔍 发现 2 个 Agents:
-
-1. MacBook-Pro (信誉: 85)
-   ID: f2a-a1b2-c3d4-e5f6...
-   能力: code-generation, file-operation
-
-2. RaspberryPi-4 (信誉: 72)
-   ID: f2a-e5f6-g7h8-i9j0...
-   能力: code-generation, data-analysis
-```
-
-### 委托任务
-
-```
-用户: 让 MacBook-Pro 帮我写一个斐波那契函数
-
-OpenClaw: [调用 f2a_delegate agent="MacBook-Pro" task="写斐波那契函数"]
-
-✅ MacBook-Pro 已完成任务:
-
-def fibonacci(n):
-    if n <= 1:
-        return n
-    return fibonacci(n-1) + fibonacci(n-2)
-```
-
-### 广播任务
-
-```
-用户: 让所有人帮我检查这段代码的 bug
-
-OpenClaw: [调用 f2a_broadcast capability=code-generation task="检查代码bug"]
-
-✅ 收到 2/2 个成功响应:
-
-✅ MacBook-Pro (245ms)
-   完成
-
-✅ RaspberryPi-4 (312ms)
-   完成
-```
-
-## 工具列表
-
-### 发现与委托工具
-
-#### f2a_discover - 发现 Agents
-
-发现 F2A 网络中的 Agents，可按能力或信誉过滤。
-
-**参数：**
-- `capability` (可选): 按能力过滤，如 `code-generation`, `file-operation`
-- `min_reputation` (可选): 最低信誉分数 (0-100)
-
-```
-用户: 帮我找一下网络里能写代码的 Agents
-
-OpenClaw: [调用 f2a_discover capability=code-generation]
-
-🔍 发现 2 个 Agents:
-
-1. MacBook-Pro (信誉: 85)
-   ID: f2a-a1b2-c3d4-e5f6...
-   能力: code-generation, file-operation
-
-2. RaspberryPi-4 (信誉: 72)
-   ID: f2a-e5f6-g7h8-i9j0...
-   能力: code-generation, data-analysis
-```
-
-#### f2a_delegate - 委托任务
-
-将任务委托给网络中的特定 Agent 执行。
-
-**参数：**
-- `agent` (必填): 目标 Agent ID、名称或索引（如 `#1`）
-- `task` (必填): 任务描述
-- `context` (可选): 任务上下文或附件
-- `timeout` (可选): 超时时间（毫秒）
-
-```
-用户: 让 MacBook-Pro 帮我写一个斐波那契函数
-
-OpenClaw: [调用 f2a_delegate agent="MacBook-Pro" task="写斐波那契函数"]
-
-✅ MacBook-Pro 已完成任务:
-
-def fibonacci(n):
-    if n <= 1:
-        return n
-    return fibonacci(n-1) + fibonacci(n-2)
-```
-
-#### f2a_broadcast - 广播任务
-
-广播任务给所有具备某能力的 Agents，实现并行执行。
-
-**参数：**
-- `capability` (必填): 所需能力
-- `task` (必填): 任务描述
-- `min_responses` (可选): 最少响应数
-
-```
-用户: 让所有人帮我检查这段代码的 bug
-
-OpenClaw: [调用 f2a_broadcast capability=code-generation task="检查代码bug"]
-
-✅ 收到 2/2 个成功响应:
-
-✅ MacBook-Pro (245ms)
-   完成
-
-✅ RaspberryPi-4 (312ms)
-   完成
-```
-
-#### f2a_status - 查看网络状态
-
-查看 F2A 网络状态和已连接的 Peers。
-
-**参数：** 无
-
-```
-用户: 查看 F2A 网络状态
-
-OpenClaw: [调用 f2a_status]
-
-📊 F2A 网络状态:
-- 节点 ID: f2a-a1b2-c3d4-e5f6...
-- 状态: 在线
-- 已连接 Peers: 3
-- 本地任务队列: 2 待处理, 1 执行中
-```
-
-#### f2a_reputation - 管理信誉
-
-查看或管理 Peer 的信誉分数。
-
-**参数：**
-- `action` (必填): 操作类型
-  - `list`: 列出所有信誉记录
-  - `view`: 查看指定 Peer 的信誉详情
-  - `block`: 封锁指定 Peer
-  - `unblock`: 解封指定 Peer
-- `peer_id` (可选): Peer ID（view/block/unblock 时需要）
-
-```
-用户: 查看所有信誉记录
-
-OpenClaw: [调用 f2a_reputation action=list]
-
-📋 信誉记录:
-
-| Peer ID | 名称 | 信誉分 | 状态 |
-|---------|------|-------|------|
-| f2a-abc... | MacBook-Pro | 85 | 正常 |
-| f2a-def... | RaspberryPi-4 | 72 | 正常 |
-| f2a-xyz... | Unknown | 15 | 受限 |
-
-用户: 封锁那个信誉太低的节点
-
-OpenClaw: [调用 f2a_reputation action=block peer_id="f2a-xyz..."]
-
-✅ 已封锁节点 f2a-xyz...
-```
-
-### 任务队列工具
-
-#### f2a_poll_tasks - 查询任务队列
-
-查询待处理的任务队列，获取需要执行的任务列表。
-
-```
-用户: 查看我的任务队列
-
-OpenClaw: [调用 f2a_poll_tasks]
-
-📋 任务队列:
-- task-001: 代码审查 (待处理)
-- task-002: 文档生成 (待处理)
-```
-
-#### f2a_submit_result - 提交任务结果
-
-执行完任务后，提交执行结果。
-
-```
-用户: 提交任务结果，代码审查已完成
-
-OpenClaw: [调用 f2a_submit_result taskId="task-001" result="审查完成，发现3个问题"]
-
-✅ 任务结果已提交:
-- 任务ID: task-001
-- 状态: 成功
-- 结果: 审查完成，发现3个问题
-```
-
-#### f2a_task_stats - 查看队列统计
-
-查看任务队列的统计信息，包括待处理、执行中、已完成等状态。
-
-```
-用户: 查看任务队列统计
-
-OpenClaw: [调用 f2a_task_stats]
-
-📊 队列统计:
-- 待处理: 5
-- 执行中: 2
-- 已完成: 128
-- 失败: 3
-- 总计: 138
-```
-
-### 广播与认领工具
-
-#### f2a_announce - 广播任务
-
-创建任务广播，让其他 Agent 可以认领执行。适用于需要并行处理或寻找合适执行者的场景。
-
-```
-用户: 广播一个数据分析任务
-
-OpenClaw: [调用 f2a_announce taskType="data-analysis" description="分析销售数据，生成月度报告"]
-
-📢 任务已广播:
-- 广播ID: ann-abc123
-- 任务类型: data-analysis
-- 状态: 开放认领
-- 超时: 30分钟
-```
-
-#### f2a_list_announcements - 查看开放广播
-
-查看当前所有开放的、可以被认领的任务广播。
-
-```
-用户: 查看有哪些开放的任务
-
-OpenClaw: [调用 f2a_list_announcements]
-
-📋 开放广播列表:
-1. [ann-abc123] 数据分析任务
-   - 类型: data-analysis
-   - 发布者: MacBook-Pro
-   - 剩余时间: 25分钟
-   
-2. [ann-def456] 翻译任务
-   - 类型: translation
-   - 发布者: iPhone-14
-   - 剩余时间: 10分钟
-```
-
-#### f2a_claim - 认领任务
-
-认领一个开放的任务广播，表示愿意执行该任务。
-
-```
-用户: 认领数据分析任务
-
-OpenClaw: [调用 f2a_claim announcementId="ann-abc123"]
-
-✅ 认领成功:
-- 广播ID: ann-abc123
-- 认领ID: claim-xyz789
-- 状态: 等待确认
-- 预计时间: 10分钟
-```
-
-#### f2a_manage_claims - 管理认领
-
-管理你发布的任务广播收到的认领请求，可以接受或拒绝认领。
-
-```
-用户: 查看我的广播收到的认领请求
-
-OpenClaw: [调用 f2a_manage_claims action="list"]
-
-📋 认领请求列表:
-- claim-xyz789 (来自: MacBook-Pro)
-  广播: ann-abc123
-  状态: 待处理
-  预计时间: 10分钟
-
-用户: 接受 MacBook-Pro 的认领
-
-OpenClaw: [调用 f2a_manage_claims action="accept" claimId="claim-xyz789"]
-
-✅ 已接受认领:
-- 认领ID: claim-xyz789
-- 认领者: MacBook-Pro
-- 任务已正式委托
-```
-
-#### f2a_my_claims - 查看我的认领
-
-查看自己提交的所有认领请求及其状态。
-
-```
-用户: 查看我认领的任务
-
-OpenClaw: [调用 f2a_my_claims]
-
-📋 我的认领:
-1. [claim-xyz789] 数据分析任务
-   - 状态: 已接受
-   - 发布者: MacBook-Pro
-   - 时间: 2024-01-15 10:30
-
-2. [claim-mno456] 翻译任务
-   - 状态: 待处理
-   - 发布者: iPhone-14
-   - 时间: 2024-01-15 11:00
-```
-
-#### f2a_announcement_stats - 广播统计
-
-查看任务广播的统计信息，包括开放、已认领、已委托、已过期等状态数量。
-
-```
-用户: 查看广播统计
-
-OpenClaw: [调用 f2a_announcement_stats]
-
-📊 广播统计:
-- 开放中: 5
-- 已认领: 3
-- 已委托: 12
-- 已过期: 2
-- 总计: 22
-```
-
-## 架构
-
-```
-┌─────────────────────────────────────────────────────────┐
-│                    OpenClaw Agent                        │
-│                                                          │
-│  ┌─────────────────────────────────────────────────┐    │
-│  │     @f2a/openclaw-adapter 插件                    │    │
-│  │                                                  │    │
-│  │  • 检测 OpenClaw 能力                            │    │
-│  │  • 提供 f2a_* Tools                             │    │
-│  │  • 通过 Webhook 接收任务                         │    │
-│  │  • 调用 OpenClaw.execute() 执行远程任务          │    │
-│  └─────────────────────────────────────────────────┘    │
-│                              │                          │
-│                              │ HTTP / WebSocket         │
-│                              ▼                          │
-│  ┌─────────────────────────────────────────────────┐    │
-│  │              F2A Node (同机部署)                 │    │
-│  │                                                  │    │
-│  │  • P2P 网络连接 (libp2p)                        │    │
-│  │  • mDNS 节点发现                                │    │
-│  │  • 消息路由转发                                 │    │
-│  └─────────────────────────────────────────────────┘    │
-└─────────────────────────────────────────────────────────┘
-                              │
-                              │ P2P 网络
-                              ▼
-                    ┌─────────────────┐
-                    │   其他 F2A 节点   │
-                    └─────────────────┘
-```
-
-### Webhook 推送机制
-
-当配置了 `webhookPush` 时，F2A 会主动推送任务通知到 OpenClaw：
-
-1. **新任务到达时**，立即通过 webhook 推送
-2. **如果推送失败**，进入冷却期（指数退避，最大 5 分钟）
-3. **冷却期间**，任务可通过轮询机制获取
-4. **连续失败 3 次后**进入降级模式
-
-推送流程：
-```
-任务到达 → 尝试 Webhook 推送
-              ↓
-         成功? → 标记已推送，等待处理
-              ↓
-         失败 → 进入冷却期，等待轮询兜底
-```
-
-### 僵尸任务处理
-
-系统会定期检查 `processing` 状态的任务，防止因异常导致的任务丢失：
-
-**检测条件**（满足任一即触发）：
-- 任务在 `processing` 状态停留超过 `processingTimeoutMs`（默认 5 分钟）
-- 或超过任务自身超时时间的 2 倍
-
-**处理方式**：
-- 自动将任务重置为 `pending` 状态
-- 记录警告日志，便于问题追踪
-
-```
-定期检查 → processing 任务超时?
-              ↓
-         是 → 重置为 pending，重新入队
-              ↓
-         否 → 继续等待
-```
-
-## 开发
-
-```bash
-# 安装依赖
-npm install
-
-# 构建
-npm run build
-
-# 测试
-npm test
-```
-
-## License
-
-MIT

package/packages/openclaw-adapter/openclaw.plugin.json

@@ -1,106 +0,0 @@
-{
-  "id": "f2a-openclaw-adapter",
-  "name": "F2A OpenClaw Adapter",
-  "description": "OpenClaw adapter for F2A P2P Agent network",
-  "version": "0.2.0",
-  "configSchema": {
-    "type": "object",
-    "additionalProperties": false,
-    "properties": {
-      "f2aPath": {
-        "type": "string",
-        "description": "Path to F2A installation",
-        "default": "~/projects/F2A"
-      },
-      "autoStart": {
-        "type": "boolean",
-        "description": "Automatically start F2A node",
-        "default": true
-      },
-      "webhookPort": {
-        "type": "number",
-        "description": "Port for webhook server",
-        "default": 9002
-      },
-      "controlPort": {
-        "type": "number",
-        "description": "Port for F2A control API",
-        "default": 9001
-      },
-      "controlToken": {
-        "type": "string",
-        "description": "Auth token for F2A control API (auto-generated if not provided)",
-        "sensitive": true
-      },
-      "p2pPort": {
-        "type": "number",
-        "description": "Port for P2P network",
-        "default": 9000
-      },
-      "enableMDNS": {
-        "type": "boolean",
-        "description": "Enable mDNS discovery",
-        "default": true
-      },
-      "bootstrapPeers": {
-        "type": "array",
-        "items": { "type": "string" },
-        "description": "Bootstrap peer addresses",
-        "default": []
-      },
-      "agentName": {
-        "type": "string",
-        "description": "Display name for this agent",
-        "default": "OpenClaw Agent"
-      },
-      "capabilities": {
-        "type": "array",
-        "items": { "type": "string" },
-        "description": "Custom capabilities to advertise",
-        "default": []
-      },
-      "dataDir": {
-        "type": "string",
-        "description": "Directory for plugin data",
-        "default": "./f2a-data"
-      },
-      "maxQueuedTasks": {
-        "type": "number",
-        "description": "Maximum number of tasks to queue",
-        "default": 100
-      },
-      "reputation": {
-        "type": "object",
-        "properties": {
-          "enabled": { "type": "boolean", "default": true },
-          "initialScore": { "type": "number", "default": 50 },
-          "minScoreForService": { "type": "number", "default": 20 },
-          "decayRate": { "type": "number", "default": 0.01 }
-        }
-      },
-      "security": {
-        "type": "object",
-        "properties": {
-          "requireConfirmation": { "type": "boolean", "default": false },
-          "whitelist": { "type": "array", "items": { "type": "string" }, "default": [] },
-          "blacklist": { "type": "array", "items": { "type": "string" }, "default": [] },
-          "maxTasksPerMinute": { "type": "number", "default": 10 }
-        }
-      }
-    }
-  },
-  "uiHints": {
-    "f2aPath": { "label": "F2A Path", "placeholder": "~/projects/F2A" },
-    "autoStart": { "label": "Auto Start F2A Node" },
-    "webhookPort": { "label": "Webhook Port" },
-    "controlPort": { "label": "Control Port" },
-    "controlToken": { "label": "Control Token", "sensitive": true },
-    "p2pPort": { "label": "P2P Port" },
-    "enableMDNS": { "label": "Enable mDNS Discovery" },
-    "bootstrapPeers": { "label": "Bootstrap Peers", "placeholder": ["/ip4/..."] },
-    "agentName": { "label": "Agent Display Name" },
-    "capabilities": { "label": "Custom Capabilities" },
-    "dataDir": { "label": "Data Directory" },
-    "maxQueuedTasks": { "label": "Max Queued Tasks" }
-  }
-}

package/packages/openclaw-adapter/package.json

@@ -1,40 +0,0 @@
-{
-  "name": "@f2a/openclaw-adapter",
-  "version": "0.1.0",
-  "description": "OpenClaw adapter for F2A P2P Agent network",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist",
-    "openclaw.plugin.json",
-    "README.md"
-  ],
-  "openclaw": {
-    "extensions": ["./dist/plugin.js"]
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest",
-    "lint": "eslint src/**/*.ts"
-  },
-  "keywords": ["openclaw", "f2a", "p2p", "agent", "plugin"],
-  "author": "F2A Team",
-  "license": "MIT",
-  "dependencies": {
-    "@f2a/network": "file:../..",
-    "ws": "^8.16.0",
-    "node-fetch": "^3.3.2",
-    "zod": "^3.22.4",
-    "better-sqlite3": "^11.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.10.0",
-    "@types/ws": "^8.5.10",
-    "typescript": "^5.3.0",
-    "vitest": "^1.0.0"
-  },
-  "peerDependencies": {
-    "openclaw": ">=1.0.0"
-  }
-}