@f2a/network 0.1.2 → 0.2.0

package/packages/openclaw-adapter/src/types.ts

@@ -1,361 +0,0 @@
-/**
- * F2A OpenClaw Connector - Core Types
- * 
- * 统一类型定义入口文件
- * - 基础类型定义在此文件
- * - Result 类型从 src/types/result.ts 重新导出（统一错误处理模式）
- */
-
-// ============================================================================
-// 统一 Result 类型（从核心库 re-export）
-// ============================================================================
-
-// 重新导出核心 Result 类型，确保整个项目使用统一的错误处理模式
-export type { Result, F2AError, ErrorCode } from '../../../src/types/result.js';
-export { success, failure, failureFromError, createError } from '../../../src/types/result.js';
-
-// ============================================================================
-// OpenClaw 配置类型（扩展以支持插件配置访问）
-// ============================================================================
-
-/**
- * OpenClaw 完整配置结构
- * 
- * 注意：此接口定义了 OpenClaw 配置的已知结构。
- * 实际配置可能包含更多字段，插件应使用可选链访问。
- */
-export interface OpenClawConfig extends Record<string, unknown> {
-  /** 插件配置容器 */
-  plugins?: {
-    /** 插件条目映射 */
-    entries?: Record<string, { config?: Record<string, unknown> }>;
-  };
-  /** Agent 配置 */
-  agents?: {
-    /** 默认 Agent 配置 */
-    defaults?: {
-      /** 工作空间路径 */
-      workspace?: string;
-    };
-  };
-}
-
-// ============================================================================
-// OpenClaw Plugin SDK Types
-// ============================================================================
-export interface OpenClawPlugin {
-  name: string;
-  version: string;
-  initialize(config: Record<string, unknown>): Promise<void>;
-  getTools(): Tool[];
-  shutdown?(): Promise<void>;
-  onEvent?(event: string, payload: unknown): Promise<void>;
-}
-
-// OpenClaw Plugin API (外部插件可用接口)
-export interface OpenClawPluginApi {
-  id: string;
-  name: string;
-  version?: string;
-  description?: string;
-  source: string;
-  config: OpenClawConfig;
-  pluginConfig?: Record<string, unknown>;
-  runtime: {
-    version: string;
-    config: {
-      loadConfig: (path?: string) => Promise<Record<string, unknown>>;
-      writeConfigFile: (path: string, config: unknown) => Promise<void>;
-    };
-    system: {
-      enqueueSystemEvent: (event: string, payload?: unknown) => void;
-      requestHeartbeatNow: () => void;
-      runCommandWithTimeout: (command: string, timeoutMs: number) => Promise<{ stdout: string; stderr: string }>;
-    };
-    media: {
-      loadWebMedia: (url: string) => Promise<Buffer>;
-      detectMime: (data: Buffer) => string;
-    };
-    tts: {
-      textToSpeechTelephony: (options: { text: string; cfg: unknown }) => Promise<{ audio: Buffer; sampleRate: number }>;
-    };
-    stt: {
-      transcribeAudioFile: (options: { filePath: string; cfg: unknown; mime?: string }) => Promise<{ text?: string }>;
-    };
-    logging: {
-      shouldLogVerbose: () => boolean;
-      getChildLogger: (bindings?: Record<string, unknown>) => unknown;
-    };
-  };
-  logger: {
-    debug?: (message: string) => void;
-    info: (message: string) => void;
-    warn: (message: string) => void;
-    error: (message: string) => void;
-  };
-  registerTool?: (tool: unknown, opts?: { optional?: boolean }) => void;
-  registerService?: (service: { id: string; start: () => void | Promise<void>; stop?: () => void | Promise<void> }) => void;
-}
-
-export interface Tool {
-  name: string;
-  description: string;
-  parameters: Record<string, ParameterSchema>;
-  handler: (params: any, context: SessionContext) => Promise<ToolResult>;
-}
-
-export interface ParameterSchema {
-  type: string;
-  description: string;
-  required?: boolean;
-  enum?: string[];
-}
-
-export interface SessionContext {
-  sessionId: string;
-  workspace: string;
-  toJSON(): Record<string, unknown>;
-}
-
-export interface ToolResult {
-  content: string;
-  data?: unknown;
-}
-
-// F2A Network Types
-export interface F2ANodeConfig {
-  nodePath: string;
-  controlPort: number;
-  controlToken: string;
-  p2pPort: number;
-  enableMDNS: boolean;
-  bootstrapPeers: string[];
-  /** 请求超时（毫秒），默认 30000 */
-  timeoutMs?: number;
-  /** 最大重试次数，默认 3 */
-  maxRetries?: number;
-  /** 重试基础延迟（毫秒），默认 1000 */
-  retryDelayMs?: number;
-}
-
-// F2A Plugin Configuration
-export interface F2APluginConfig {
-  autoStart?: boolean;
-  webhookPort?: number;
-  webhookToken?: string;
-  agentName?: string;
-  capabilities?: string[];
-  f2aPath?: string;
-  controlPort?: number;
-  controlToken?: string;
-  p2pPort?: number;
-  enableMDNS?: boolean;
-  bootstrapPeers?: string[];
-  dataDir?: string;
-  maxQueuedTasks?: number;
-  /** 兜底轮询间隔（毫秒），默认 60 秒 */
-  pollInterval?: number;
-  /** P1 修复：processing 任务超时时间（毫秒），超过此时间将被重置为 pending，默认 5 分钟 */
-  processingTimeoutMs?: number;
-  /** Webhook 推送配置 */
-  webhookPush?: WebhookPushConfig;
-  reputation?: ReputationConfig;
-  security?: SecurityConfig;
-}
-
-export interface ReputationConfig {
-  enabled: boolean;
-  initialScore: number;
-  minScoreForService: number;
-  decayRate: number;
-}
-
-export interface SecurityConfig {
-  requireConfirmation: boolean;
-  whitelist: string[];
-  blacklist: string[];
-  maxTasksPerMinute: number;
-}
-
-export interface AgentInfo {
-  peerId: string;
-  displayName: string;
-  agentType: string;
-  version: string;
-  capabilities: AgentCapability[];
-  multiaddrs: string[];
-  lastSeen: number;
-  reputation?: number;
-}
-
-export interface AgentCapability {
-  name: string;
-  description: string;
-  tools?: string[];
-  parameters?: Record<string, ParameterSchema>;
-}
-
-export interface PeerInfo {
-  peerId: string;
-  agentInfo?: AgentInfo;
-  multiaddrs: string[];
-  connected: boolean;
-  reputation: number;
-  lastSeen: number;
-}
-
-// Task Types
-export interface TaskRequest {
-  taskId: string;
-  taskType: string;
-  description: string;
-  parameters?: Record<string, unknown>;
-  from: string;
-  timestamp: number;
-  timeout: number;
-}
-
-export interface TaskResponse {
-  taskId: string;
-  status: 'success' | 'error' | 'rejected' | 'timeout';
-  result?: unknown;
-  error?: string;
-  latency?: number;
-}
-
-export interface DelegateOptions {
-  peerId: string;
-  taskType: string;
-  description: string;
-  parameters?: Record<string, unknown>;
-  timeout?: number;
-}
-
-// Webhook Types
-export interface WebhookEvent {
-  type: 'discover' | 'delegate' | 'status' | 'reputation_update';
-  payload: unknown;
-  timestamp: number;
-  signature?: string;
-}
-
-export interface DiscoverWebhookPayload {
-  query: {
-    capability?: string;
-    minReputation?: number;
-  };
-  requester: string;
-}
-
-export interface DelegateWebhookPayload extends TaskRequest {
-  // TaskRequest 本身已包含所有字段
-}
-
-// Result 类型已从核心库 re-export，见文件顶部
-
-// Reputation Types
-export interface ReputationEntry {
-  peerId: string;
-  score: number;
-  successfulTasks: number;
-  failedTasks: number;
-  totalTasks: number;
-  avgResponseTime: number;
-  lastInteraction: number;
-  history: ReputationEvent[];
-}
-
-export interface ReputationEvent {
-  type: 'task_success' | 'task_failure' | 'task_rejected' | 'timeout' | 'malicious';
-  taskId?: string;
-  delta: number;
-  timestamp: number;
-  reason?: string;
-}
-
-// Claim Types - 认领模式
-export interface TaskAnnouncement {
-  announcementId: string;
-  taskType: string;
-  description: string;
-  requiredCapabilities?: string[];
-  estimatedComplexity?: number;
-  reward?: number;
-  timeout: number;
-  from: string;
-  timestamp: number;
-  status: 'open' | 'claimed' | 'delegated' | 'expired';
-  claims?: TaskClaim[];
-}
-
-export interface TaskClaim {
-  claimId: string;
-  announcementId: string;
-  claimant: string;
-  claimantName?: string;
-  estimatedTime?: number;
-  confidence?: number;
-  timestamp: number;
-  status: 'pending' | 'accepted' | 'rejected';
-}
-
-/**
- * Webhook 推送配置
- * 
- * 用于配置 F2A 向 OpenClaw 推送事件通知的参数。
- * 当任务状态变化、收到认领请求等事件发生时，会通过此配置推送通知。
- * 
- * @example
- * ```typescript
- * const config: WebhookPushConfig = {
- *   url: 'https://openclaw.example.com/webhook/f2a',
- *   token: 'secret-token-xxx',
- *   timeout: 5000,
- *   enabled: true
- * };
- * ```
- */
-export interface WebhookPushConfig {
-  /** OpenClaw webhook URL，用于接收推送通知 */
-  url: string;
-  /** Webhook 认证 token，用于验证推送请求的合法性 */
-  token: string;
-  /** 推送超时时间（毫秒），默认 30000ms */
-  timeout?: number;
-  /** 是否启用 webhook 推送，默认 false */
-  enabled?: boolean;
-}
-
-/**
- * 认领 Webhook 载荷
- * 
- * 当有 Agent 认领你发布的任务广播时，会通过 webhook 推送此载荷。
- * 包含认领者的信息和认领详情，可用于自动或手动审核认领请求。
- * 
- * @example
- * ```typescript
- * // Webhook 接收到的认领通知
- * const payload: ClaimWebhookPayload = {
- *   announcementId: 'ann-abc123',
- *   claimId: 'claim-xyz789',
- *   claimant: 'f2a-peer-id-xxx',
- *   claimantName: 'MacBook-Pro',
- *   estimatedTime: 600000, // 预计 10 分钟完成
- *   confidence: 0.85 // 85% 信心完成
- * };
- * ```
- */
-export interface ClaimWebhookPayload {
-  /** 任务广播 ID，对应 TaskAnnouncement.announcementId */
-  announcementId: string;
-  /** 认领 ID，唯一标识此次认领 */
-  claimId: string;
-  /** 认领者的 F2A Peer ID */
-  claimant: string;
-  /** 认领者的显示名称（可选） */
-  claimantName?: string;
-  /** 预估完成时间（毫秒，可选） */
-  estimatedTime?: number;
-  /** 完成任务的信心程度（0-1，可选） */
-  confidence?: number;
-}

package/packages/openclaw-adapter/src/webhook-pusher.test.ts

@@ -1,188 +0,0 @@
-/**
- * WebhookPusher 边界、竞态和幂等性测试
- */
-
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { WebhookPusher, WebhookPushConfig } from './webhook-pusher.js';
-import type { QueuedTask } from './task-queue.js';
-
-// Mock fetch
-const mockFetch = vi.fn();
-global.fetch = mockFetch;
-
-describe('WebhookPusher 边界问题', () => {
-  let pusher: WebhookPusher;
-  const defaultConfig: WebhookPushConfig = {
-    url: 'http://localhost:4200',
-    token: 'test-token',
-    timeout: 1000,
-    enabled: true
-  };
-
-  beforeEach(() => {
-    vi.clearAllMocks();
-    pusher = new WebhookPusher(defaultConfig);
-  });
-
-  describe('推送边界', () => {
-    it('应该在 disabled 时不推送', async () => {
-      const disabledPusher = new WebhookPusher({
-        ...defaultConfig,
-        enabled: false
-      });
-
-      const task: QueuedTask = {
-        taskId: 'task-1',
-        status: 'pending',
-        createdAt: Date.now()
-      };
-
-      const result = await disabledPusher.pushTask(task);
-
-      expect(result.success).toBe(false);
-      expect(result.error).toBe('Webhook push disabled');
-      expect(mockFetch).not.toHaveBeenCalled();
-    });
-
-    it('应该在 URL 无效时失败', async () => {
-      mockFetch.mockRejectedValue(new Error('Invalid URL'));
-
-      const task: QueuedTask = {
-        taskId: 'task-1',
-        status: 'pending',
-        createdAt: Date.now()
-      };
-
-      const result = await pusher.pushTask(task);
-
-      expect(result.success).toBe(false);
-      expect(result.error).toBe('Invalid URL');
-    });
-
-    it('应该在超时时失败', async () => {
-      mockFetch.mockImplementation(() => 
-        new Promise((_, reject) => 
-          setTimeout(() => reject(new Error('Timeout')), 2000)
-        )
-      );
-
-      const task: QueuedTask = {
-        taskId: 'task-1',
-        status: 'pending',
-        createdAt: Date.now()
-      };
-
-      const result = await pusher.pushTask(task);
-
-      expect(result.success).toBe(false);
-    }, 5000);
-  });
-
-  describe('冷却期边界', () => {
-    it('应该在连续失败 3 次后进入冷却期', async () => {
-      mockFetch.mockRejectedValue(new Error('Failed'));
-
-      const task: QueuedTask = {
-        taskId: 'task-1',
-        status: 'pending',
-        createdAt: Date.now()
-      };
-
-      // 连续失败 3 次
-      await pusher.pushTask(task);
-      await pusher.pushTask(task);
-      await pusher.pushTask(task);
-
-      const status = pusher.getStatus();
-      expect(status.consecutiveFailures).toBe(3);
-      expect(status.inCooldown).toBe(true);
-    });
-
-    it('应该在冷却期内拒绝推送', async () => {
-      mockFetch.mockRejectedValue(new Error('Failed'));
-
-      const task: QueuedTask = {
-        taskId: 'task-1',
-        status: 'pending',
-        createdAt: Date.now()
-      };
-
-      // 触发冷却期
-      await pusher.pushTask(task);
-      await pusher.pushTask(task);
-      await pusher.pushTask(task);
-
-      // 冷却期内的推送应该失败
-      const result = await pusher.pushTask(task);
-      expect(result.success).toBe(false);
-      // 更新错误消息格式：包含剩余秒数
-      expect(result.error).toMatch(/In cooldown \(\d+s remaining\)/);
-    });
-
-    it('应该在冷却期后恢复推送', async () => {
-      const quickPusher = new WebhookPusher({
-        ...defaultConfig
-      });
-      
-      // 模拟快速冷却期（通过修改内部状态）
-      mockFetch.mockRejectedValue(new Error('Failed'));
-
-      const task: QueuedTask = {
-        taskId: 'task-1',
-        status: 'pending',
-        createdAt: Date.now()
-      };
-
-      // 触发冷却期
-      await quickPusher.pushTask(task);
-      await quickPusher.pushTask(task);
-      await quickPusher.pushTask(task);
-
-      // 手动重置失败计数和时间，模拟冷却期结束
-      (quickPusher as any).consecutiveFailures = 0;
-      (quickPusher as any).lastFailureTime = 0;
-
-      // 恢复成功
-      mockFetch.mockResolvedValue({ ok: true, status: 200 });
-      const result = await quickPusher.pushTask(task);
-      
-      expect(result.success).toBe(true);
-    }, 3000);
-  });
-
-  describe('幂等性', () => {
-    it('应该支持同一任务多次推送', async () => {
-      mockFetch.mockResolvedValue({ ok: true, status: 200 });
-
-      const task: QueuedTask = {
-        taskId: 'task-1',
-        status: 'pending',
-        createdAt: Date.now()
-      };
-
-      const result1 = await pusher.pushTask(task);
-      const result2 = await pusher.pushTask(task);
-
-      expect(result1.success).toBe(true);
-      expect(result2.success).toBe(true);
-      expect(mockFetch).toHaveBeenCalledTimes(2);
-    });
-  });
-
-  describe('状态管理', () => {
-    it('应该正确返回状态', () => {
-      const status = pusher.getStatus();
-
-      expect(status.enabled).toBe(true);
-      expect(status.consecutiveFailures).toBe(0);
-      expect(status.inCooldown).toBe(false);
-    });
-
-    it('应该支持动态更新配置', () => {
-      pusher.updateConfig({ enabled: false });
-
-      const status = pusher.getStatus();
-      expect(status.enabled).toBe(false);
-    });
-  });
-});