@f2a/network 0.1.2 → 0.2.0

package/src/utils/validation.ts

@@ -1,186 +0,0 @@
-/**
- * F2A 输入验证 Schema
- * 使用 Zod 进行运行时类型验证
- */
-
-import { z } from 'zod';
-
-// ============================================================================
-// 基础类型 Schema
-// ============================================================================
-
-export const LogLevelSchema = z.enum(['DEBUG', 'INFO', 'WARN', 'ERROR']);
-
-export const SecurityLevelSchema = z.enum(['low', 'medium', 'high']);
-
-// ============================================================================
-// Agent 能力 Schema
-// ============================================================================
-
-export const ParameterSchemaSchema = z.object({
-  type: z.enum(['string', 'number', 'boolean', 'object', 'array']),
-  required: z.boolean().optional(),
-  default: z.unknown().optional(),
-  description: z.string().optional()
-});
-
-export const AgentCapabilitySchema = z.object({
-  name: z.string().min(1).max(64).regex(/^[a-z0-9-]+$/),
-  description: z.string().min(1).max(256),
-  tools: z.array(z.string()).max(32),
-  parameters: z.record(ParameterSchemaSchema).optional()
-});
-
-// ============================================================================
-// 网络配置 Schema
-// ============================================================================
-
-export const P2PNetworkConfigSchema = z.object({
-  listenPort: z.number().int().min(0).max(65535).optional(),
-  listenAddresses: z.array(z.string()).optional(),
-  bootstrapPeers: z.array(z.string()).optional(),
-  enableMDNS: z.boolean().optional(),
-  enableDHT: z.boolean().optional(),
-  dhtServerMode: z.boolean().optional()
-});
-
-export const SecurityConfigSchema = z.object({
-  level: SecurityLevelSchema,
-  requireConfirmation: z.boolean(),
-  verifySignatures: z.boolean(),
-  whitelist: z.set(z.string()).optional(),
-  blacklist: z.set(z.string()).optional(),
-  rateLimit: z.object({
-    maxRequests: z.number().int().positive(),
-    windowMs: z.number().int().positive()
-  }).optional()
-});
-
-export const F2AOptionsSchema = z.object({
-  displayName: z.string().min(1).max(64).optional(),
-  agentType: z.enum(['openclaw', 'claude-code', 'codex', 'custom']).optional(),
-  network: P2PNetworkConfigSchema.optional(),
-  security: SecurityConfigSchema.optional(),
-  logLevel: LogLevelSchema.optional(),
-  dataDir: z.string().optional()
-});
-
-// ============================================================================
-// 任务委托 Schema
-// ============================================================================
-
-export const TaskDelegateOptionsSchema = z.object({
-  capability: z.string().min(1).max(64),
-  description: z.string().min(1).max(1024),
-  parameters: z.record(z.unknown()).optional(),
-  timeout: z.number().int().min(1000).max(300000).optional(), // 1s - 5min
-  parallel: z.boolean().optional(),
-  minResponses: z.number().int().min(1).max(10).optional()
-});
-
-// ============================================================================
-// 消息协议 Schema
-// ============================================================================
-
-export const F2AMessageTypeSchema = z.enum([
-  'DISCOVER',
-  'DISCOVER_RESP',
-  'CAPABILITY_QUERY',
-  'CAPABILITY_RESPONSE',
-  'TASK_REQUEST',
-  'TASK_RESPONSE',
-  'TASK_DELEGATE',
-  'PING',
-  'PONG'
-]);
-
-export const F2AMessageSchema = z.object({
-  id: z.string().uuid(),
-  type: F2AMessageTypeSchema,
-  from: z.string().min(1),
-  to: z.string().optional(),
-  timestamp: z.number().int().positive(),
-  ttl: z.number().int().positive().optional(),
-  payload: z.unknown()
-});
-
-export const TaskRequestPayloadSchema = z.object({
-  taskId: z.string().uuid(),
-  taskType: z.string().min(1).max(64),
-  description: z.string().min(1).max(1024),
-  parameters: z.record(z.unknown()).optional(),
-  timeout: z.number().int().min(1).max(300).optional() // seconds
-});
-
-export const TaskResponsePayloadSchema = z.object({
-  taskId: z.string().uuid(),
-  status: z.enum(['success', 'error', 'rejected', 'delegated']),
-  result: z.unknown().optional(),
-  error: z.string().max(1024).optional(),
-  delegatedTo: z.string().optional()
-});
-
-// ============================================================================
-// Webhook Schema
-// ============================================================================
-
-export const WebhookConfigSchema = z.object({
-  url: z.string().url(),
-  token: z.string().min(1),
-  timeout: z.number().int().positive().optional(),
-  retries: z.number().int().min(0).max(10).optional(),
-  retryDelay: z.number().int().positive().optional()
-});
-
-// ============================================================================
-// 验证函数
-// ============================================================================
-
-/**
- * 验证 F2A 配置
- */
-export function validateF2AOptions(options: unknown) {
-  return F2AOptionsSchema.safeParse(options);
-}
-
-/**
- * 验证任务委托选项
- */
-export function validateTaskDelegateOptions(options: unknown) {
-  return TaskDelegateOptionsSchema.safeParse(options);
-}
-
-/**
- * 验证 Agent 能力
- */
-export function validateAgentCapability(capability: unknown) {
-  return AgentCapabilitySchema.safeParse(capability);
-}
-
-/**
- * 验证 F2A 消息
- */
-export function validateF2AMessage(message: unknown) {
-  return F2AMessageSchema.safeParse(message);
-}
-
-/**
- * 验证任务请求载荷
- */
-export function validateTaskRequestPayload(payload: unknown) {
-  return TaskRequestPayloadSchema.safeParse(payload);
-}
-
-/**
- * 验证任务响应载荷
- */
-export function validateTaskResponsePayload(payload: unknown) {
-  return TaskResponsePayloadSchema.safeParse(payload);
-}
-
-/**
- * 验证 Webhook 配置
- */
-export function validateWebhookConfig(config: unknown) {
-  return WebhookConfigSchema.safeParse(config);
-}

package/tests/docker/Dockerfile.node

@@ -1,23 +0,0 @@
-# F2A Node Docker Image
-# 用于在容器中运行 F2A 节点
-
-FROM node:22-alpine
-
-WORKDIR /app
-
-# 复制所有文件（包括 tsconfig.json）
-COPY . .
-
-# 安装所有依赖（libp2p 是 ESM 模块，需要完整依赖）
-RUN npm install --ignore-scripts
-
-# 环境变量
-ENV NODE_ENV=production
-ENV F2A_CONTROL_PORT=9001
-
-# 健康检查
-HEALTHCHECK --interval=5s --timeout=3s --retries=10 \
-  CMD wget -q --spider http://localhost:9001/health || exit 1
-
-# 启动命令
-CMD ["node", "dist/daemon/main.js"]

package/tests/docker/Dockerfile.runner

@@ -1,18 +0,0 @@
-# F2A Test Runner Docker Image
-# 用于运行集成测试
-
-FROM node:22-alpine
-
-WORKDIR /app
-
-# 先复制所有文件（包括 tsconfig.json）
-COPY . .
-
-# 安装所有依赖（包括 devDependencies），忽略 prepare 脚本
-RUN npm install --ignore-scripts
-
-# 构建项目
-RUN npm run build
-
-# 运行集成测试
-CMD ["npm", "run", "test:integration"]

package/tests/docker/docker-compose.test.yml

@@ -1,73 +0,0 @@
-# F2A Integration Test Environment
-# 使用方式：
-#   npm run test:docker           # 默认 3 个节点
-#   npm run test:docker:10        # 10 个节点
-
-services:
-  # 引导节点（稳定，其他节点连接它）
-  bootstrap:
-    build:
-      context: ../..
-      dockerfile: tests/docker/Dockerfile.node
-    networks:
-      f2a-test-net:
-        aliases:
-          - bootstrap.f2a.local
-    environment:
-      - F2A_CONTROL_PORT=9001
-      - F2A_P2P_PORT=9000
-      - F2A_CONTROL_TOKEN=${TEST_TOKEN:-test-token-integration}
-      - NODE_ENV=production
-    healthcheck:
-      test: ["CMD", "wget", "-q", "--spider", "http://localhost:9001/health"]
-      interval: 5s
-      timeout: 3s
-      retries: 10
-      start_period: 10s
-
-  # 动态生成的节点（使用 --scale 参数调整数量）
-  node:
-    build:
-      context: ../..
-      dockerfile: tests/docker/Dockerfile.node
-    networks:
-      - f2a-test-net
-    environment:
-      - F2A_CONTROL_PORT=9001
-      - F2A_CONTROL_TOKEN=${TEST_TOKEN:-test-token-integration}
-      - NODE_ENV=production
-      - BOOTSTRAP_PEERS=/dns4/bootstrap.f2a.local/tcp/9000
-    depends_on:
-      bootstrap:
-        condition: service_healthy
-    healthcheck:
-      test: ["CMD", "wget", "-q", "--spider", "http://localhost:9001/health"]
-      interval: 5s
-      timeout: 3s
-      retries: 10
-      start_period: 5s
-    # 注意：使用 docker compose up --scale node=N 来控制节点数量
-
-  # 测试运行器
-  test-runner:
-    build:
-      context: ../..
-      dockerfile: tests/docker/Dockerfile.runner
-    networks:
-      - f2a-test-net
-    environment:
-      - RUN_INTEGRATION_TESTS=true
-      - TEST_BOOTSTRAP_HTTP=http://bootstrap:9001
-      - TEST_NODE_COUNT=${NODE_COUNT:-3}
-      - TEST_TOKEN=${TEST_TOKEN:-test-token-integration}
-    depends_on:
-      bootstrap:
-        condition: service_healthy
-      node:
-        condition: service_healthy
-    volumes:
-      - ../../coverage:/app/coverage  # 导出覆盖率报告
-
-networks:
-  f2a-test-net:
-    driver: bridge

package/tests/integration/message-passing.test.ts

@@ -1,109 +0,0 @@
-/**
- * 消息传递集成测试
- * 测试节点之间的消息发送和接收
- */
-
-import { describe, it, expect, beforeAll } from 'vitest';
-import { getBootstrapHttp } from './test-config';
-
-const shouldRun = process.env.RUN_INTEGRATION_TESTS === 'true';
-
-describe.skipIf(!shouldRun)('消息传递集成测试', () => {
-  // 使用 HTTP URL 格式，而不是 libp2p 多地址
-  const bootstrapAddr = getBootstrapHttp();
-  const testToken = process.env.TEST_TOKEN || 'test-token-integration';
-
-  beforeAll(async () => {
-    // 等待所有节点就绪
-    await new Promise(resolve => setTimeout(resolve, 5000));
-  });
-
-  describe('任务请求和响应', () => {
-    it('应该能发送任务请求并收到响应', async () => {
-      // 1. 发送任务请求
-      const taskPayload = {
-        capability: 'echo',
-        description: 'Echo test message',
-        parameters: {
-          message: 'Hello from integration test'
-        }
-      };
-
-      const sendResponse = await fetch(`${bootstrapAddr}/task`, {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          'Authorization': `Bearer ${testToken}`
-        },
-        body: JSON.stringify(taskPayload)
-      });
-
-      // 如果节点没有注册 echo 能力，测试可能失败
-      // 这是预期的，因为这是基础测试
-      if (!sendResponse.ok) {
-        console.log('Task endpoint not available, skipping');
-        return;
-      }
-
-      const result = await sendResponse.json();
-      expect(result.taskId).toBeDefined();
-    });
-
-    it('应该能广播消息到所有节点', async () => {
-      const broadcastPayload = {
-        type: 'DISCOVER',
-        payload: {
-          test: true
-        }
-      };
-
-      const response = await fetch(`${bootstrapAddr}/broadcast`, {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          'Authorization': `Bearer ${testToken}`
-        },
-        body: JSON.stringify(broadcastPayload)
-      });
-
-      // 广播可能不可用，取决于实现
-      if (response.ok) {
-        const result = await response.json();
-        expect(result.delivered).toBeGreaterThanOrEqual(0);
-      }
-    });
-  });
-
-  describe('能力发现', () => {
-    it('应该能发现节点的注册能力', async () => {
-      const response = await fetch(`${bootstrapAddr}/capabilities`, {
-        headers: { 'Authorization': `Bearer ${testToken}` }
-      });
-
-      if (response.ok) {
-        const capabilities = await response.json();
-        expect(Array.isArray(capabilities)).toBe(true);
-      }
-    });
-  });
-
-  describe('错误处理', () => {
-    it('应该拒绝无效的认证令牌', async () => {
-      const response = await fetch(`${bootstrapAddr}/status`, {
-        headers: { 'Authorization': 'Bearer invalid-token' }
-      });
-
-      expect(response.status).toBe(401);
-    });
-
-    it('应该返回正确的错误信息', async () => {
-      const response = await fetch(`${bootstrapAddr}/invalid-endpoint`, {
-        headers: { 'Authorization': `Bearer ${testToken}` }
-      });
-
-      // 405 Method Not Allowed (GET not supported for unknown paths)
-      // or 404 Not Found - both are acceptable error responses
-      expect([404, 405]).toContain(response.status);
-    });
-  });
-});

package/tests/integration/multi-node.test.ts

@@ -1,92 +0,0 @@
-/**
- * 多节点压力测试
- * 测试多节点场景下的性能和稳定性
- */
-
-import { describe, it, expect, beforeAll } from 'vitest';
-import { getBootstrapHttp } from './test-config';
-
-const shouldRun = process.env.RUN_INTEGRATION_TESTS === 'true';
-
-describe.skipIf(!shouldRun)('多节点压力测试', () => {
-  // 使用 HTTP URL 格式，而不是 libp2p 多地址
-  const bootstrapAddr = getBootstrapHttp();
-  const nodeCount = parseInt(process.env.TEST_NODE_COUNT || '3');
-  const testToken = process.env.TEST_TOKEN || 'test-token-integration';
-
-  beforeAll(async () => {
-    // 等待所有节点就绪
-    await new Promise(resolve => setTimeout(resolve, 5000));
-  });
-
-  describe('并发请求', () => {
-    it('应该能同时处理多个请求', async () => {
-      const requestCount = 10;
-      const requests = [];
-
-      for (let i = 0; i < requestCount; i++) {
-        requests.push(
-          fetch(`${bootstrapAddr}/status`, {
-            headers: { 'Authorization': `Bearer ${testToken}` }
-          }).then(r => ({ ok: r.ok, index: i }))
-        );
-      }
-
-      const results = await Promise.all(requests);
-      const successCount = results.filter(r => r.ok).length;
-
-      expect(successCount).toBe(requestCount);
-    }, 30000); // 30 秒超时
-  });
-
-  describe('节点负载', () => {
-    it('节点连接数应该在合理范围内', async () => {
-      // 等待节点完成发现
-      await new Promise(resolve => setTimeout(resolve, 10000));
-      
-      const response = await fetch(`${bootstrapAddr}/peers`, {
-        headers: { 'Authorization': `Bearer ${testToken}` }
-      });
-
-      const peers = await response.json();
-      
-      // 打印诊断信息
-      console.log('Node count:', nodeCount, 'Connected peers:', peers.length);
-      
-      // 放宽条件：至少有一个节点连接就算成功
-      expect(peers.length).toBeGreaterThanOrEqual(1);
-    }, 15000);  // 增加测试超时到 15 秒
-  });
-
-  describe('稳定性', () => {
-    it('连续请求应该都能成功', async () => {
-      const requestCount = 5;
-      
-      for (let i = 0; i < requestCount; i++) {
-        const response = await fetch(`${bootstrapAddr}/health`, {
-          headers: { 'Authorization': `Bearer ${testToken}` }
-        });
-        
-        expect(response.ok).toBe(true);
-        
-        // 短暂延迟
-        await new Promise(resolve => setTimeout(resolve, 100));
-      }
-    });
-
-    it('节点状态应该一致', async () => {
-      // 多次获取状态，验证一致性
-      const responses = await Promise.all([
-        fetch(`${bootstrapAddr}/status`, {
-          headers: { 'Authorization': `Bearer ${testToken}` }
-        }).then(r => r.json()),
-        fetch(`${bootstrapAddr}/status`, {
-          headers: { 'Authorization': `Bearer ${testToken}` }
-        }).then(r => r.json())
-      ]);
-
-      // peerId 应该一致
-      expect(responses[0].peerId).toBe(responses[1].peerId);
-    });
-  });
-});

package/tests/integration/p2p-connection.test.ts

@@ -1,83 +0,0 @@
-/**
- * P2P 连接集成测试
- * 测试节点之间的连接建立和发现
- */
-
-import { describe, it, expect } from 'vitest';
-import { getBootstrapHttp } from './test-config';
-
-// 只在集成测试环境运行
-const shouldRun = process.env.RUN_INTEGRATION_TESTS === 'true';
-
-describe.skipIf(!shouldRun)('P2P 连接集成测试', () => {
-  // 使用 HTTP URL 格式，而不是 libp2p 多地址
-  const bootstrapAddr = getBootstrapHttp();
-  const nodeCount = parseInt(process.env.TEST_NODE_COUNT || '3');
-  const testToken = process.env.TEST_TOKEN || 'test-token-integration';
-
-  describe('节点启动和健康检查', () => {
-    it('引导节点应该健康运行', async () => {
-      const response = await fetch(`${bootstrapAddr}/health`, {
-        headers: { 'Authorization': `Bearer ${testToken}` }
-      });
-      
-      expect(response.ok).toBe(true);
-    });
-
-    it('引导节点应该有正确的 Peer ID', async () => {
-      const response = await fetch(`${bootstrapAddr}/status`, {
-        headers: { 'Authorization': `Bearer ${testToken}` }
-      });
-      
-      const status = await response.json();
-      expect(status.peerId).toBeDefined();
-      expect(status.peerId.length).toBeGreaterThan(10);
-    });
-  });
-
-  describe('节点发现', () => {
-    it('引导节点应该发现所有节点', async () => {
-      // 等待节点完成发现
-      await new Promise(resolve => setTimeout(resolve, 10000));  // 增加等待时间到 10 秒
-      
-      const response = await fetch(`${bootstrapAddr}/peers`, {
-        headers: { 'Authorization': `Bearer ${testToken}` }
-      });
-      
-      const peers = await response.json();
-      
-      // 打印诊断信息
-      console.log('Expected:', nodeCount, 'Got:', peers.length);
-      console.log('Peers:', peers.map((p: any) => p.peerId));
-      
-      expect(peers.length).toBeGreaterThanOrEqual(1);  // 至少有一个节点连接
-    }, 15000);  // 增加测试超时到 15 秒
-
-    it('节点应该知道引导节点的地址', async () => {
-      // 这个测试验证节点是否正确配置了引导节点
-      const response = await fetch(`${bootstrapAddr}/status`, {
-        headers: { 'Authorization': `Bearer ${testToken}` }
-      });
-      
-      const status = await response.json();
-      expect(status.multiaddrs).toBeDefined();
-      expect(status.multiaddrs.length).toBeGreaterThan(0);
-    });
-  });
-
-  describe('网络拓扑', () => {
-    it('所有节点应该在同一个网络中', async () => {
-      const response = await fetch(`${bootstrapAddr}/peers`, {
-        headers: { 'Authorization': `Bearer ${testToken}` }
-      });
-      
-      const peers = await response.json();
-      
-      // 验证所有节点都有有效的 Peer ID
-      for (const peer of peers) {
-        expect(peer.peerId).toBeDefined();
-        // connected 属性可能不在 AgentInfo 中，跳过检查
-      }
-    });
-  });
-});

package/tests/integration/test-config.ts

@@ -1,32 +0,0 @@
-const defaultBootstrapHttp = 'http://bootstrap:9001';
-
-function normalizeBootstrapUrl(raw: string): string {
-  if (raw.startsWith('http://') || raw.startsWith('https://')) {
-    return raw;
-  }
-
-  // 兼容 /dns4/bootstrap/tcp/9000 这样的多地址配置
-  const match = raw.match(/^\/dns4\/([^/]+)\/tcp\/(\d+)$/);
-  if (match) {
-    const [, host, port] = match;
-    const controlPort = port === '9000' ? '9001' : port;
-    return `http://${host}:${controlPort}`;
-  }
-
-  return raw;
-}
-
-export function getBootstrapHttp(): string {
-  const explicitHttp = process.env.TEST_BOOTSTRAP_HTTP;
-  if (explicitHttp) {
-    return normalizeBootstrapUrl(explicitHttp);
-  }
-
-  const bootstrapAddr = process.env.TEST_BOOTSTRAP_ADDR;
-  if (bootstrapAddr) {
-    return normalizeBootstrapUrl(bootstrapAddr);
-  }
-
-  return defaultBootstrapHttp;
-}
-

package/tsconfig.json

@@ -1,21 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "lib": ["ES2022"],
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "moduleResolution": "NodeNext",
-    "allowSyntheticDefaultImports": true
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["node_modules", "src/**/*.test.ts", "src/**/*.spec.ts"]
-}

package/vitest.config.ts

@@ -1,26 +0,0 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    coverage: {
-      reporter: ['text', 'json', 'html'],
-      exclude: [
-        'node_modules/',
-        'dist/',
-        'tests/',
-        '**/*.d.ts',
-        'src/utils/benchmark.ts',
-        'src/utils/middleware.ts',
-        'src/utils/signature.ts'
-      ],
-      thresholds: {
-        statements: 60,
-        branches: 75,
-        functions: 65,
-        lines: 60
-      }
-    }
-  }
-});