@f2a/network 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@f2a/network",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Friend-to-Agent P2P networking protocol for OpenClaw Agents",
   "type": "module",
   "main": "dist/index.js",
@@ -8,11 +8,18 @@
   "bin": {
     "f2a": "./dist/cli/index.js"
   },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
   "workspaces": [
     "packages/*"
   ],
   "scripts": {
     "build": "tsc",
+    "lint": "tsc --noEmit",
     "build:watch": "tsc --watch",
     "build:all": "npm run build && npm run build --workspaces",
     "clean": "rm -rf dist",

package/.github/workflows/ci.yml

@@ -1,113 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main, develop]
-  pull_request:
-    branches: [main, develop]
-
-jobs:
-  # Lint 检查
-  lint:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-      
-      - name: Install dependencies
-        run: npm install
-      
-      - name: Run lint
-        run: npm run lint || npm run build -- --noEmit
-
-  # 单元测试（Node 20 & 22）
-  unit-tests:
-    runs-on: ubuntu-latest
-    needs: lint
-    strategy:
-      matrix:
-        node-version: [20, 22]
-    steps:
-      - uses: actions/checkout@v4
-      
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-      
-      - name: Install dependencies
-        run: npm install
-      
-      - name: Build
-        run: npm run build
-      
-      - name: Run unit tests
-        run: npm run test:unit
-      
-      - name: Upload coverage
-        uses: codecov/codecov-action@v4
-        if: matrix.node-version == 20
-        with:
-          files: ./coverage/lcov.info
-          flags: unittests
-
-  # 集成测试（仅 push 触发）
-  integration-tests:
-    runs-on: ubuntu-latest
-    needs: unit-tests
-    if: github.event_name == 'push'
-    steps:
-      - uses: actions/checkout@v4
-      
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-      
-      - name: Install dependencies
-        run: npm install
-      
-      - name: Build
-        run: npm run build
-      
-      - name: Run Docker integration tests
-        run: npm run test:docker
-      
-      - name: Export logs on failure
-        if: failure()
-        run: docker compose -f tests/docker/docker-compose.test.yml logs > test-logs.txt
-      
-      - name: Upload logs on failure
-        if: failure()
-        uses: actions/upload-artifact@v4
-        with:
-          name: integration-test-logs
-          path: test-logs.txt
-      
-      - name: Upload coverage
-        uses: codecov/codecov-action@v4
-        with:
-          files: ./coverage/lcov.info
-          flags: integration
-
-  # 多节点测试（仅 main 分支）
-  multi-node-tests:
-    runs-on: ubuntu-latest
-    needs: integration-tests
-    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
-    steps:
-      - uses: actions/checkout@v4
-      
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-      
-      - name: Install dependencies
-        run: npm install
-      
-      - name: Build
-        run: npm run build
-      
-      - name: Run 10-node test
-        run: npm run test:docker:10

package/.github/workflows/publish.yml

@@ -1,60 +0,0 @@
-name: Publish to NPM
-
-on:
-  push:
-    tags:
-      - 'v*'
-  workflow_dispatch:
-
-jobs:
-  publish-core:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
-      
-      - name: Install dependencies
-        run: npm install
-      
-      - name: Build
-        run: npm run build
-      
-      - name: Publish core package
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-  publish-adapter:
-    runs-on: ubuntu-latest
-    needs: publish-core
-    steps:
-      - uses: actions/checkout@v4
-      
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
-      
-      - name: Wait for package to be available
-        run: sleep 30
-      
-      - name: Install dependencies
-        working-directory: packages/openclaw-adapter
-        run: |
-          # Replace file: reference with npm package reference
-          npm install @f2a/network@latest --save
-          npm install
-      
-      - name: Build adapter
-        working-directory: packages/openclaw-adapter
-        run: npm run build
-      
-      - name: Publish adapter package
-        working-directory: packages/openclaw-adapter
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/MONOREPO.md

@@ -1,58 +0,0 @@
-# F2A Monorepo
-
-F2A (Friend-to-Agent) 是一个用于 OpenClaw Agents 的 P2P 网络协议。
-
-## 仓库结构
-
-```
-F2A/
-├── packages/                     # 子包目录
-│   └── openclaw-adapter/         # OpenClaw 插件
-│       ├── package.json
-│       ├── tsconfig.json
-│       ├── README.md
-│       └── src/
-├── src/                          # F2A 核心代码
-│   ├── core/                     # 核心 P2P 网络
-│   ├── daemon/                   # Daemon 服务
-│   ├── cli/                      # CLI 工具
-│   └── types/                    # 类型定义
-├── docs/                         # 文档
-├── package.json                  # 根 package.json (workspaces)
-└── tsconfig.json
-```
-
-## 包说明
-
-| 包 | 路径 | 说明 |
-|----|------|------|
-| `f2a-network` | `./` | F2A P2P 网络核心 |
-| `@f2a/openclaw-adapter` | `./packages/openclaw-adapter` | OpenClaw 插件 |
-
-## 开发
-
-```bash
-# 安装所有依赖
-npm install
-
-# 构建所有包
-npm run build:all
-
-# 测试所有包
-npm run test:all
-
-# 构建特定包
-cd packages/openclaw-adapter
-npm run build
-```
-
-## 发布
-
-```bash
-# 发布核心包
-npm publish
-
-# 发布子包
-cd packages/openclaw-adapter
-npm publish --access public
-```

package/SKILL.md

@@ -1,137 +0,0 @@
----
-name: f2a-network
-description: Activate when the user wants to discover, connect, or communicate with other OpenClaw Agents in the local network. Use for P2P networking, messaging between agents, invoking skills on remote agents, file sharing, or group chat.
----
-
-# F2A - Friend-to-Agent P2P Network
-
-## 概述
-
-F2A 是一个 P2P 协作网络，让 OpenClaw Agent 能够：
-- 发现局域网内的其他 Agent
-- 与其他 Agent 建立加密通信
-- 委托任务给其他 Agent
-- 共享文件和能力
-
-## 安装
-
-```bash
-cd /path/to/f2a
-npm install
-npm run build
-```
-
-## 命令参考
-
-### 启动/停止
-
-```bash
-# 启动 Daemon（后台服务）
-node dist/daemon/index.js
-
-# 或使用 PM2
-pm2 start dist/daemon/index.js --name f2a
-
-# 停止
-pm2 stop f2a
-```
-
-### CLI 命令
-
-| 命令 | 说明 |
-|------|------|
-| `status` | 查看节点状态 |
-| `peers` | 查看已连接的 Peers |
-| `discover [--capability <name>]` | 发现网络中的 Agents |
-| `pending` | 查看待确认连接 |
-| `confirm <id|index>` | 确认连接请求 |
-| `reject <id|index>` | 拒绝连接请求 |
-
-### 使用示例
-
-#### 场景一：发现其他 Agent
-
-```bash
-# 发现所有 Agent
-node dist/cli/index.js discover
-
-# 按能力过滤
-node dist/cli/index.js discover --capability code-generation
-```
-
-#### 场景二：查看连接状态
-
-```bash
-node dist/cli/index.js status
-node dist/cli/index.js peers
-```
-
-#### 场景三：管理连接请求
-
-```bash
-# 查看待确认连接
-node dist/cli/index.js pending
-
-# 确认连接
-node dist/cli/index.js confirm 1
-
-# 拒绝连接
-node dist/cli/index.js reject 2 --reason "unknown agent"
-```
-
-## 环境变量
-
-| 变量 | 默认值 | 说明 |
-|------|--------|------|
-| `F2A_CONTROL_PORT` | 9001 | HTTP 控制端口 |
-| `F2A_CONTROL_TOKEN` | f2a-default-token | 认证 Token（生产环境务必修改） |
-
-## 安全注意事项
-
-⚠️ **默认 Token 不安全！** 生产环境请设置：
-
-```bash
-export F2A_CONTROL_TOKEN=$(openssl rand -hex 32)
-```
-
-## 故障排除
-
-### 问题：无法发现其他 Agent
-
-检查：
-1. 是否在同一局域网？
-2. 防火墙是否阻止了 UDP 8768 端口？
-3. MDNS 是否被路由器禁用？
-
-### 问题：连接被拒绝
-
-检查：
-1. 对方是否已启动 F2A？
-2. Token 是否正确？
-3. 是否在对方的黑名单中？
-
-### 问题：端口被占用
-
-```bash
-# 检查端口占用
-lsof -i :9001
-
-# 使用其他端口
-F2A_CONTROL_PORT=9002 node dist/daemon/index.js
-```
-
-## 更多文档
-
-- 详细文档：`docs/`
-- 协议规范：`skill/references/protocol.md`
-- 完整 README：`README.md`
-
-## 日志查看
-
-```bash
-# 使用 PM2 查看日志
-pm2 logs f2a
-
-# 或查看日志文件
-tail -f ~/.f2a/f2a.log
-```

package/dist/adapters/openclaw.d.ts

@@ -1,103 +0,0 @@
-/**
- * OpenClaw F2A 适配器
- * 将 F2A P2P 网络集成到 OpenClaw
- *
- * 使用方式:
- * ```typescript
- * const adapter = await OpenClawF2AAdapter.create(openclawSession);
- * await adapter.start();
- *
- * // 委托任务给网络
- * const result = await adapter.delegateTask({
- *   capability: 'code-generation',
- *   description: 'Generate a Python function to calculate fibonacci'
- * });
- * ```
- */
-import { AgentCapability, TaskDelegateOptions, TaskDelegateResult, AgentInfo } from '../index';
-import type { Result } from '../types';
-export interface OpenClawSession {
-    execute: (task: string, options?: unknown) => Promise<unknown>;
-    on: (event: string, handler: (...args: unknown[]) => void) => void;
-}
-export interface OpenClawF2AAdapterOptions {
-    /** 节点显示名称 */
-    displayName?: string;
-    /** 监听端口（0表示随机） */
-    listenPort?: number;
-    /** 引导节点列表 */
-    bootstrapPeers?: string[];
-    /** 是否启用本地 MDNS 发现 */
-    enableMDNS?: boolean;
-    /** 能力处理器映射 */
-    capabilityHandlers?: Record<string, (params: Record<string, unknown>) => Promise<unknown>>;
-}
-export declare class OpenClawF2AAdapter {
-    private f2a;
-    private openclaw;
-    private options;
-    private running;
-    private constructor();
-    /**
-     * 创建适配器实例
-     */
-    static create(openclaw: OpenClawSession, options?: OpenClawF2AAdapterOptions): Promise<OpenClawF2AAdapter>;
-    /**
-     * 注册默认能力
-     */
-    private static registerDefaultCapabilities;
-    /**
-     * 检测 OpenClaw 的能力
-     */
-    private static detectOpenClawCapabilities;
-    /**
-     * 创建默认能力处理器
-     */
-    private static createDefaultHandler;
-    /**
-     * 构建任务描述
-     */
-    private static buildTaskDescription;
-    /**
-     * 启动适配器
-     */
-    start(): Promise<Result<void>>;
-    /**
-     * 停止适配器
-     */
-    stop(): Promise<void>;
-    /**
-     * 处理收到的任务请求
-     */
-    private handleTaskRequest;
-    /**
-     * 委托任务给网络中的其他 Agent
-     */
-    delegateTask(options: TaskDelegateOptions): Promise<Result<TaskDelegateResult>>;
-    /**
-     * 发现网络中的 Agents
-     */
-    discoverAgents(capability?: string): Promise<AgentInfo[]>;
-    /**
-     * 直接发送任务给特定 Peer
-     */
-    sendTaskTo(peerId: string, taskType: string, description: string, parameters?: Record<string, unknown>): Promise<Result<unknown>>;
-    /**
-     * 获取本节点信息
-     */
-    getAgentInfo(): AgentInfo;
-    /**
-     * 获取已连接的 Peers
-     */
-    getConnectedPeers(): AgentInfo[];
-    /**
-     * 注册新能力
-     */
-    registerCapability(capability: AgentCapability, handler: (params: Record<string, unknown>) => Promise<unknown>): void;
-    /**
-     * 获取 PeerID
-     */
-    get peerId(): string;
-}
-export default OpenClawF2AAdapter;
-//# sourceMappingURL=openclaw.d.ts.map

package/dist/adapters/openclaw.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"openclaw.d.ts","sourceRoot":"","sources":["../../src/adapters/openclaw.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAO,eAAe,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACpG,OAAO,KAAK,EAAc,MAAM,EAAoB,MAAM,UAAU,CAAC;AAGrE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;CACpE;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa;IACb,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,qBAAqB;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;CAC5F;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,OAAO,CAAkB;IAEjC,OAAO;IAMP;;OAEG;WACU,MAAM,CACjB,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,kBAAkB,CAAC;IA4B9B;;OAEG;mBACkB,2BAA2B;IAchD;;OAEG;mBACkB,0BAA0B;IAyG/C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAkBnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAQnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAsBpC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B;;OAEG;YACW,iBAAiB;IAqC/B;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAIrF;;OAEG;IACG,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAI/D;;OAEG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAI3B;;OAEG;IACH,YAAY,IAAI,SAAS;IAIzB;;OAEG;IACH,iBAAiB,IAAI,SAAS,EAAE;IAIhC;;OAEG;IACH,kBAAkB,CAChB,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAC7D,IAAI;IAIP;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF;AAGD,eAAe,kBAAkB,CAAC"}