@f2a/network 0.1.2

package/dist/core/review-committee.d.ts

@@ -0,0 +1,130 @@
+/**
+ * F2A 评审系统
+ * Phase 2: 评审机制
+ */
+import { ReputationManager } from './reputation.js';
+/**
+ * 评审维度
+ */
+export interface ReviewDimensions {
+    /** 工作量评估 (0-100) */
+    workload: number;
+    /** 价值分 (-100 ~ 100) */
+    value: number;
+}
+/**
+ * 风险标记
+ */
+export type RiskFlag = 'dangerous' | 'malicious' | 'spam' | 'invalid';
+/**
+ * 任务评审
+ */
+export interface TaskReview {
+    taskId: string;
+    reviewerId: string;
+    dimensions: ReviewDimensions;
+    riskFlags?: RiskFlag[];
+    comment?: string;
+    timestamp: number;
+}
+/**
+ * 评审结果
+ */
+export interface ReviewResult {
+    taskId: string;
+    requesterId: string;
+    executorId?: string;
+    finalWorkload: number;
+    finalValue: number;
+    reviews: TaskReview[];
+    outliers: TaskReview[];
+    timestamp: number;
+}
+/**
+ * 评审委员会配置
+ */
+export interface ReviewCommitteeConfig {
+    /** 最小评审人数 */
+    minReviewers: number;
+    /** 最大评审人数 */
+    maxReviewers: number;
+    /** 评审资格最低信誉分 */
+    minReputation: number;
+    /** 评审超时（毫秒） */
+    reviewTimeout: number;
+    /** 偏离检测阈值（标准差倍数） */
+    outlierThreshold: number;
+}
+/**
+ * 待评审任务
+ */
+export interface PendingReview {
+    taskId: string;
+    requesterId: string;
+    executorId?: string;
+    taskDescription: string;
+    taskParameters?: Record<string, unknown>;
+    createdAt: number;
+    reviews: TaskReview[];
+    requiredReviewers: number;
+}
+export declare class ReviewCommittee {
+    private config;
+    private reputationManager;
+    private pendingReviews;
+    private logger;
+    constructor(reputationManager: ReputationManager, config?: Partial<ReviewCommitteeConfig>);
+    /**
+     * 根据网络规模计算需要的评审人数
+     */
+    getRequiredReviewers(networkSize: number): number;
+    /**
+     * 获取可用的评审者
+     */
+    getAvailableReviewers(excludeIds?: string[]): string[];
+    /**
+     * 提交任务进行评审
+     */
+    submitForReview(taskId: string, requesterId: string, taskDescription: string, taskParameters?: Record<string, unknown>, executorId?: string): PendingReview;
+    /**
+     * 提交评审
+     */
+    submitReview(review: TaskReview): {
+        success: boolean;
+        message: string;
+    };
+    /**
+     * 检查评审是否完成
+     */
+    isReviewComplete(taskId: string): boolean;
+    /**
+     * 结算评审
+     */
+    finalizeReview(taskId: string): ReviewResult | null;
+    /**
+     * 聚合评审结果
+     */
+    aggregateReviews(reviews: TaskReview[]): {
+        finalWorkload: number;
+        finalValue: number;
+        outliers: TaskReview[];
+    };
+    /**
+     * 获取待评审任务列表
+     */
+    getPendingReviews(): PendingReview[];
+    /**
+     * 获取特定任务的评审状态
+     */
+    getReviewStatus(taskId: string): PendingReview | null;
+    /**
+     * 清理超时的待评审任务
+     */
+    cleanupExpiredReviews(): string[];
+    private validateReviewDimensions;
+    private updateReviewerReputations;
+    private average;
+    private stdDev;
+}
+export default ReviewCommittee;
+//# sourceMappingURL=review-committee.d.ts.map

package/dist/core/review-committee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-committee.d.ts","sourceRoot":"","sources":["../../src/core/review-committee.ts"],"names":[],"mappings":"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"}

package/dist/core/review-committee.js

@@ -0,0 +1,251 @@
+/**
+ * F2A 评审系统
+ * Phase 2: 评审机制
+ */
+import { Logger } from '../utils/logger.js';
+// ============================================================================
+// 默认配置
+// ============================================================================
+const DEFAULT_COMMITTEE_CONFIG = {
+    minReviewers: 1,
+    maxReviewers: 7,
+    minReputation: 50,
+    reviewTimeout: 5 * 60 * 1000, // 5 分钟
+    outlierThreshold: 2, // 2 个标准差
+};
+// ============================================================================
+// 评审委员会
+// ============================================================================
+export class ReviewCommittee {
+    config;
+    reputationManager;
+    pendingReviews = new Map();
+    logger;
+    constructor(reputationManager, config = {}) {
+        this.reputationManager = reputationManager;
+        this.config = { ...DEFAULT_COMMITTEE_CONFIG, ...config };
+        this.logger = new Logger({ component: 'ReviewCommittee' });
+    }
+    /**
+     * 根据网络规模计算需要的评审人数
+     */
+    getRequiredReviewers(networkSize) {
+        if (networkSize < 10)
+            return 1;
+        if (networkSize < 50)
+            return 3;
+        return 5;
+    }
+    /**
+     * 获取可用的评审者
+     */
+    getAvailableReviewers(excludeIds = []) {
+        const highRepNodes = this.reputationManager.getHighReputationNodes(this.config.minReputation);
+        return highRepNodes
+            .map(e => e.peerId)
+            .filter(id => !excludeIds.includes(id));
+    }
+    /**
+     * 提交任务进行评审
+     */
+    submitForReview(taskId, requesterId, taskDescription, taskParameters, executorId) {
+        const networkSize = this.reputationManager.getAllReputations().length;
+        const requiredReviewers = Math.min(this.config.maxReviewers, Math.max(this.config.minReviewers, this.getRequiredReviewers(networkSize)));
+        const pending = {
+            taskId,
+            requesterId,
+            executorId,
+            taskDescription,
+            taskParameters,
+            createdAt: Date.now(),
+            reviews: [],
+            requiredReviewers,
+        };
+        this.pendingReviews.set(taskId, pending);
+        this.logger.info('Task submitted for review', {
+            taskId,
+            requesterId: requesterId.slice(0, 16),
+            requiredReviewers,
+        });
+        return pending;
+    }
+    /**
+     * 提交评审
+     */
+    submitReview(review) {
+        const pending = this.pendingReviews.get(review.taskId);
+        if (!pending) {
+            return { success: false, message: 'Task not found or already completed' };
+        }
+        // 验证评审者资格
+        if (!this.reputationManager.hasPermission(review.reviewerId, 'review')) {
+            return { success: false, message: 'Reviewer does not have permission' };
+        }
+        // 验证评审者不是请求者或执行者
+        if (review.reviewerId === pending.requesterId ||
+            review.reviewerId === pending.executorId) {
+            return { success: false, message: 'Cannot review own task' };
+        }
+        // 检查是否已经评审过
+        if (pending.reviews.some(r => r.reviewerId === review.reviewerId)) {
+            return { success: false, message: 'Already reviewed this task' };
+        }
+        // 验证评审维度
+        if (!this.validateReviewDimensions(review.dimensions)) {
+            return { success: false, message: 'Invalid review dimensions' };
+        }
+        pending.reviews.push(review);
+        this.logger.info('Review submitted', {
+            taskId: review.taskId,
+            reviewerId: review.reviewerId.slice(0, 16),
+            workload: review.dimensions.workload,
+            value: review.dimensions.value,
+        });
+        return { success: true, message: 'Review submitted' };
+    }
+    /**
+     * 检查评审是否完成
+     */
+    isReviewComplete(taskId) {
+        const pending = this.pendingReviews.get(taskId);
+        if (!pending)
+            return false;
+        return pending.reviews.length >= pending.requiredReviewers;
+    }
+    /**
+     * 结算评审
+     */
+    finalizeReview(taskId) {
+        const pending = this.pendingReviews.get(taskId);
+        if (!pending)
+            return null;
+        if (pending.reviews.length < pending.requiredReviewers) {
+            this.logger.warn('Not enough reviews', {
+                taskId,
+                current: pending.reviews.length,
+                required: pending.requiredReviewers,
+            });
+            return null;
+        }
+        const { finalWorkload, finalValue, outliers } = this.aggregateReviews(pending.reviews);
+        const result = {
+            taskId,
+            requesterId: pending.requesterId,
+            executorId: pending.executorId,
+            finalWorkload,
+            finalValue,
+            reviews: pending.reviews,
+            outliers,
+            timestamp: Date.now(),
+        };
+        // 移除待评审任务
+        this.pendingReviews.delete(taskId);
+        // 更新评审者信誉
+        this.updateReviewerReputations(pending.reviews, outliers);
+        this.logger.info('Review finalized', {
+            taskId,
+            finalWorkload,
+            finalValue,
+            outliers: outliers.length,
+        });
+        return result;
+    }
+    /**
+     * 聚合评审结果
+     */
+    aggregateReviews(reviews) {
+        if (reviews.length === 1) {
+            return {
+                finalWorkload: reviews[0].dimensions.workload,
+                finalValue: reviews[0].dimensions.value,
+                outliers: [],
+            };
+        }
+        // 计算平均值和标准差
+        const workloads = reviews.map(r => r.dimensions.workload);
+        const values = reviews.map(r => r.dimensions.value);
+        const avgWorkload = this.average(workloads);
+        const avgValue = this.average(values);
+        const stdDevWorkload = this.stdDev(workloads, avgWorkload);
+        const stdDevValue = this.stdDev(values, avgValue);
+        // 去掉最高和最低
+        const sortedWorkloads = [...workloads].sort((a, b) => a - b);
+        const sortedValues = [...values].sort((a, b) => a - b);
+        const trimmedWorkloads = sortedWorkloads.slice(1, -1);
+        const trimmedValues = sortedValues.slice(1, -1);
+        const finalWorkload = this.average(trimmedWorkloads);
+        const finalValue = this.average(trimmedValues);
+        // 识别偏离者
+        const outliers = reviews.filter(r => Math.abs(r.dimensions.workload - avgWorkload) > this.config.outlierThreshold * stdDevWorkload ||
+            Math.abs(r.dimensions.value - avgValue) > this.config.outlierThreshold * stdDevValue);
+        return { finalWorkload, finalValue, outliers };
+    }
+    /**
+     * 获取待评审任务列表
+     */
+    getPendingReviews() {
+        return Array.from(this.pendingReviews.values());
+    }
+    /**
+     * 获取特定任务的评审状态
+     */
+    getReviewStatus(taskId) {
+        return this.pendingReviews.get(taskId) || null;
+    }
+    /**
+     * 清理超时的待评审任务
+     */
+    cleanupExpiredReviews() {
+        const now = Date.now();
+        const expired = [];
+        for (const [taskId, pending] of this.pendingReviews) {
+            if (now - pending.createdAt > this.config.reviewTimeout) {
+                expired.push(taskId);
+                this.pendingReviews.delete(taskId);
+            }
+        }
+        if (expired.length > 0) {
+            this.logger.info('Cleaned up expired reviews', { count: expired.length });
+        }
+        return expired;
+    }
+    // ============================================================================
+    // 私有方法
+    // ============================================================================
+    validateReviewDimensions(dimensions) {
+        const { workload, value } = dimensions;
+        // 工作量范围检查
+        if (workload < 0 || workload > 100)
+            return false;
+        // 价值分范围检查
+        if (value < -100 || value > 100)
+            return false;
+        return true;
+    }
+    updateReviewerReputations(reviews, outliers) {
+        for (const review of reviews) {
+            if (outliers.includes(review)) {
+                // 偏离评审 → 惩罚
+                this.reputationManager.recordReviewPenalty(review.reviewerId, -5, 'Outlier review');
+            }
+            else {
+                // 正常评审 → 奖励
+                this.reputationManager.recordReviewReward(review.reviewerId, 3);
+            }
+        }
+    }
+    average(values) {
+        if (values.length === 0)
+            return 0;
+        return values.reduce((a, b) => a + b, 0) / values.length;
+    }
+    stdDev(values, mean) {
+        if (values.length === 0)
+            return 0;
+        const squaredDiffs = values.map(v => Math.pow(v - mean, 2));
+        return Math.sqrt(this.average(squaredDiffs));
+    }
+}
+// 默认导出
+export default ReviewCommittee;
+//# sourceMappingURL=review-committee.js.map

package/dist/core/review-committee.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-committee.js","sourceRoot":"","sources":["../../src/core/review-committee.ts"],"names":[],"mappings":"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"}

package/dist/core/serverless.d.ts

@@ -0,0 +1,155 @@
+/**
+ * P2P Serverless 模块
+ * 处理 TCP 连接、UDP 发现、身份验证
+ */
+import { EventEmitter } from 'eventemitter3';
+import { Socket } from 'net';
+import { ConnectionConfig, AgentIdentity, DiscoveredAgent, Result, F2AMessage } from '../types';
+import { ConnectionManager } from './connection-manager';
+export interface ServerlessP2POptions {
+    identity: AgentIdentity;
+    config: ConnectionConfig;
+    connectionManager: ConnectionManager;
+}
+export interface PeerInfo {
+    socket: Socket;
+    address: string;
+    port: number;
+    publicKey: string;
+    verified: boolean;
+    connectedAt: number;
+}
+export declare class ServerlessP2P extends EventEmitter<{
+    'agent_discovered': (agent: DiscoveredAgent) => void;
+    'peer_connected': (info: {
+        peerId: string;
+        publicKey: string;
+    }) => void;
+    'peer_disconnected': (info: {
+        peerId: string;
+    }) => void;
+    'message': (info: {
+        peerId: string;
+        message: F2AMessage;
+    }) => void;
+    'started': (info: {
+        port: number;
+    }) => void;
+    'stopped': () => void;
+    'error': (error: Error) => void;
+}> {
+    private identity;
+    private config;
+    private connectionManager;
+    private tcpServer?;
+    private udpSocket?;
+    private peers;
+    private discoveredAgents;
+    private pendingChallenges;
+    private rateLimiter;
+    private discoveryInterval?;
+    private broadcastInterval?;
+    private cleanupInterval?;
+    constructor(options: ServerlessP2POptions);
+    /**
+     * 启动 P2P 服务
+     */
+    start(): Promise<Result<void>>;
+    /**
+     * 停止 P2P 服务
+     */
+    stop(): void;
+    /**
+     * 连接到指定 Agent
+     */
+    connectToAgent(agentId: string, address: string, port: number): Promise<Result<void>>;
+    /**
+     * 发送消息给 Peer
+     */
+    sendToPeer(peerId: string, message: F2AMessage): Result<void>;
+    /**
+     * 获取已连接的 Peers
+     */
+    getConnectedPeers(): string[];
+    /**
+     * 获取发现的 Agents
+     */
+    getDiscoveredAgents(): DiscoveredAgent[];
+    /**
+     * 启动 TCP 监听器
+     */
+    private startTCPListener;
+    /**
+     * 启动 UDP 发现
+     */
+    private startUDPDiscovery;
+    /**
+     * 开始发现广播
+     */
+    private startDiscoveryBroadcast;
+    /**
+     * 处理发现消息
+     */
+    private handleDiscoveryMessage;
+    /**
+     * 处理传入连接
+     */
+    private handleIncomingConnection;
+    /**
+     * 设置 Socket 处理器
+     */
+    private setupSocketHandlers;
+    /**
+     * 处理 Socket 消息
+     */
+    private handleSocketMessage;
+    /**
+     * 发送身份挑战
+     */
+    private sendIdentityChallenge;
+    /**
+     * 处理身份挑战
+     */
+    private handleIdentityChallenge;
+    /**
+     * 处理身份响应
+     */
+    private handleIdentityResponse;
+    /**
+     * 请求确认
+     */
+    private requestConfirmation;
+    /**
+     * 处理确认结果
+     */
+    private handleConfirmationResult;
+    /**
+     * 验证 Peer
+     */
+    private verifyPeer;
+    /**
+     * 处理 Socket 关闭
+     */
+    private handleSocketClose;
+    /**
+     * 获取 Socket 对应的 Peer ID
+     */
+    private getPeerIdBySocket;
+    /**
+     * 速率限制检查
+     */
+    private checkRateLimit;
+    /**
+     * 获取广播地址列表
+     */
+    private getBroadcastAddresses;
+    /**
+     * 启动清理定时器
+     */
+    private startCleanup;
+    /**
+     * 安全关闭 Socket
+     */
+    private closeSocket;
+}
+//# sourceMappingURL=serverless.d.ts.map

package/dist/core/serverless.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverless.d.ts","sourceRoot":"","sources":["../../src/core/serverless.ts"],"names":[],"mappings":"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"}