@f2a/network 0.1.2

package/dist/core/identity.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * 身份管理器
+ * 负责生成、加载和保存 Agent 身份
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdentityManager = void 0;
+const crypto_1 = require("crypto");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+class IdentityManager {
+    configDir;
+    identityFile;
+    constructor(options = {}) {
+        this.configDir = options.configDir ?? (0, path_1.join)((0, os_1.homedir)(), '.f2a');
+        this.identityFile = (0, path_1.join)(this.configDir, 'identity.json');
+        this.ensureConfigDir();
+    }
+    /**
+     * 获取或创建身份
+     */
+    getOrCreateIdentity(displayName) {
+        const existing = this.loadIdentity();
+        if (existing) {
+            return { ...existing, isNew: false };
+        }
+        return this.createIdentity(displayName);
+    }
+    /**
+     * 创建新身份
+     */
+    createIdentity(displayName) {
+        const keyPair = (0, crypto_1.generateKeyPairSync)('ed25519', {
+            publicKeyEncoding: { type: 'spki', format: 'pem' },
+            privateKeyEncoding: { type: 'pkcs8', format: 'pem' }
+        });
+        const agentId = this.generateAgentId(keyPair.publicKey);
+        const identity = {
+            agentId,
+            publicKey: keyPair.publicKey,
+            privateKey: keyPair.privateKey,
+            displayName
+        };
+        this.saveIdentity(identity);
+        return {
+            ...identity,
+            isNew: true,
+            createdAt: Date.now()
+        };
+    }
+    /**
+     * 加载已有身份
+     */
+    loadIdentity() {
+        try {
+            if (!(0, fs_1.existsSync)(this.identityFile)) {
+                return null;
+            }
+            const data = (0, fs_1.readFileSync)(this.identityFile, 'utf-8');
+            const identity = JSON.parse(data);
+            // 验证必要字段
+            if (!identity.agentId || !identity.publicKey || !identity.privateKey) {
+                console.error('[IdentityManager] 身份文件格式错误');
+                return null;
+            }
+            return identity;
+        }
+        catch (error) {
+            console.error('[IdentityManager] 加载身份失败:', error);
+            return null;
+        }
+    }
+    /**
+     * 保存身份
+     */
+    saveIdentity(identity) {
+        try {
+            const data = JSON.stringify(identity, null, 2);
+            (0, fs_1.writeFileSync)(this.identityFile, data, { mode: 0o600 }); // 只有所有者可读写
+            return { success: true, data: undefined };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return { success: false, error: `保存身份失败: ${message}` };
+        }
+    }
+    /**
+     * 获取身份文件路径
+     */
+    getConfigPath() {
+        return this.identityFile;
+    }
+    /**
+     * 获取身份信息（只读）
+     */
+    getIdentityInfo() {
+        const identity = this.loadIdentity();
+        if (!identity)
+            return null;
+        return {
+            agentId: identity.agentId,
+            displayName: identity.displayName
+        };
+    }
+    /**
+     * 生成 Agent ID
+     * 基于公钥派生
+     */
+    generateAgentId(publicKey) {
+        // 使用公钥的前 16 位作为基础
+        const base = publicKey
+            .replace(/-----BEGIN PUBLIC KEY-----/, '')
+            .replace(/-----END PUBLIC KEY-----/, '')
+            .replace(/\s/g, '')
+            .slice(0, 16);
+        // 格式: f2a-xxxx-xxxx
+        return `f2a-${base.slice(0, 4)}-${base.slice(4, 8)}-${base.slice(8, 12)}`;
+    }
+    /**
+     * 确保配置目录存在
+     */
+    ensureConfigDir() {
+        if (!(0, fs_1.existsSync)(this.configDir)) {
+            (0, fs_1.mkdirSync)(this.configDir, { recursive: true, mode: 0o700 });
+        }
+    }
+}
+exports.IdentityManager = IdentityManager;
+//# sourceMappingURL=identity.js.map

package/dist/core/identity.js.map

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

package/dist/core/identity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=identity.test.d.ts.map

package/dist/core/identity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.test.d.ts","sourceRoot":"","sources":["../../src/core/identity.test.ts"],"names":[],"mappings":""}

package/dist/core/identity.test.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const identity_1 = require("./identity");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+(0, vitest_1.describe)('IdentityManager', () => {
+    let testDir;
+    let im;
+    (0, vitest_1.beforeEach)(() => {
+        testDir = (0, path_1.join)((0, os_1.tmpdir)(), `f2a-test-${Date.now()}`);
+        im = new identity_1.IdentityManager({ configDir: testDir });
+    });
+    (0, vitest_1.afterEach)(() => {
+        if ((0, fs_1.existsSync)(testDir)) {
+            (0, fs_1.rmSync)(testDir, { recursive: true });
+        }
+    });
+    (0, vitest_1.it)('should create new identity', () => {
+        const identity = im.getOrCreateIdentity('TestAgent');
+        (0, vitest_1.expect)(identity.isNew).toBe(true);
+        (0, vitest_1.expect)(identity.agentId).toBeDefined();
+        (0, vitest_1.expect)(identity.publicKey).toBeDefined();
+        (0, vitest_1.expect)(identity.privateKey).toBeDefined();
+        (0, vitest_1.expect)(identity.displayName).toBe('TestAgent');
+    });
+    (0, vitest_1.it)('should load existing identity', () => {
+        const identity1 = im.getOrCreateIdentity();
+        const identity2 = im.getOrCreateIdentity();
+        (0, vitest_1.expect)(identity1.isNew).toBe(true);
+        (0, vitest_1.expect)(identity2.isNew).toBe(false);
+        (0, vitest_1.expect)(identity1.agentId).toBe(identity2.agentId);
+    });
+    (0, vitest_1.it)('should return identity info', () => {
+        im.getOrCreateIdentity('TestAgent');
+        const info = im.getIdentityInfo();
+        (0, vitest_1.expect)(info).toBeDefined();
+        (0, vitest_1.expect)(info?.agentId).toBeDefined();
+        (0, vitest_1.expect)(info?.displayName).toBe('TestAgent');
+    });
+});
+//# sourceMappingURL=identity.test.js.map

package/dist/core/identity.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.test.js","sourceRoot":"","sources":["../../src/core/identity.test.ts"],"names":[],"mappings":";;AAAA,mCAAqE;AACrE,yCAA6C;AAC7C,2BAAwC;AACxC,+BAA4B;AAC5B,2BAA4B;AAE5B,IAAA,iBAAQ,EAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,OAAe,CAAC;IACpB,IAAI,EAAmB,CAAC;IAExB,IAAA,mBAAU,EAAC,GAAG,EAAE;QACd,OAAO,GAAG,IAAA,WAAI,EAAC,IAAA,WAAM,GAAE,EAAE,YAAY,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACnD,EAAE,GAAG,IAAI,0BAAe,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,IAAA,kBAAS,EAAC,GAAG,EAAE;QACb,IAAI,IAAA,eAAU,EAAC,OAAO,CAAC,EAAE,CAAC;YACxB,IAAA,WAAM,EAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,QAAQ,GAAG,EAAE,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAErD,IAAA,eAAM,EAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAA,eAAM,EAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,IAAA,eAAM,EAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QACzC,IAAA,eAAM,EAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAA,eAAM,EAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,SAAS,GAAG,EAAE,CAAC,mBAAmB,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,EAAE,CAAC,mBAAmB,EAAE,CAAC;QAE3C,IAAA,eAAM,EAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAA,eAAM,EAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,IAAA,eAAM,EAAC,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,EAAE,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC;QAElC,IAAA,eAAM,EAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3B,IAAA,eAAM,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACpC,IAAA,eAAM,EAAC,IAAI,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/p2p-network.d.ts

@@ -0,0 +1,242 @@
+/**
+ * P2P 网络管理器
+ * 基于 libp2p 实现 Agent 发现与通信
+ */
+import { EventEmitter } from 'eventemitter3';
+import { P2PNetworkConfig, AgentInfo, F2AMessage, PeerInfo, PeerDiscoveredEvent, PeerConnectedEvent, PeerDisconnectedEvent, Result } from '../types/index.js';
+import { Middleware } from '../utils/middleware.js';
+export interface P2PNetworkEvents {
+    'peer:discovered': (event: PeerDiscoveredEvent) => void;
+    'peer:connected': (event: PeerConnectedEvent) => void;
+    'peer:disconnected': (event: PeerDisconnectedEvent) => void;
+    'message:received': (message: F2AMessage, peerId: string) => void;
+    'error': (error: Error) => void;
+}
+/** 发现选项 */
+export interface DiscoverOptions {
+    /** 发现超时毫秒（默认 2000） */
+    timeoutMs?: number;
+    /** 是否等待首个响应即返回（默认 false） */
+    waitForFirstResponse?: boolean;
+}
+export declare class P2PNetwork extends EventEmitter<P2PNetworkEvents> {
+    private node;
+    private config;
+    private peerTable;
+    /** 用于保护 peerTable 并发访问的锁 */
+    private peerTableLock;
+    private agentInfo;
+    private pendingTasks;
+    private cleanupInterval?;
+    private discoveryInterval?;
+    private e2eeCrypto;
+    private enableE2EE;
+    private logger;
+    private middlewareManager;
+    constructor(agentInfo: AgentInfo, config?: P2PNetworkConfig);
+    /**
+     * 启动 P2P 网络
+     */
+    start(): Promise<Result<{
+        peerId: string;
+        addresses: string[];
+    }>>;
+    /**
+     * 停止 P2P 网络
+     */
+    stop(): Promise<void>;
+    /**
+     * 发现网络中的 Agent（按能力过滤）
+     * @param capability 可选的能力过滤
+     * @param options 发现选项
+     */
+    discoverAgents(capability?: string, options?: DiscoverOptions): Promise<AgentInfo[]>;
+    /**
+     * 向特定 Peer 发送任务请求
+     */
+    sendTaskRequest(peerId: string, taskType: string, description: string, parameters?: Record<string, unknown>, timeout?: number): Promise<Result<unknown>>;
+    /**
+     * 发送任务响应
+     */
+    sendTaskResponse(peerId: string, taskId: string, status: 'success' | 'error' | 'rejected' | 'delegated', result?: unknown, error?: string): Promise<Result<void>>;
+    /**
+     * 广播发现消息
+     */
+    private broadcastDiscovery;
+    /**
+     * 广播消息到全网
+     */
+    private broadcast;
+    /**
+     * 向特定 Peer 发送消息
+     * @param peerId 目标 Peer ID
+     * @param message 消息内容
+     * @param encrypt 是否启用 E2EE 加密（默认 false，发现类消息不需要加密）
+     */
+    private sendMessage;
+    /**
+     * 设置 libp2p 事件处理
+     */
+    private setupEventHandlers;
+    /**
+     * 处理收到的消息
+     */
+    private handleMessage;
+    /**
+     * 处理加密消息
+     * @returns 处理结果，包含是否继续处理和解密后的消息
+     */
+    private handleEncryptedMessage;
+    /**
+     * 验证发送方身份
+     */
+    private verifySenderIdentity;
+    /**
+     * 发送解密失败响应
+     */
+    private sendDecryptFailureResponse;
+    /**
+     * 根据消息类型分发处理
+     */
+    private dispatchMessage;
+    /**
+     * 处理发现消息
+     */
+    private handleDiscoverMessage;
+    /**
+     * 处理能力响应消息
+     */
+    private handleCapabilityResponseMessage;
+    /**
+     * 处理能力查询消息
+     */
+    private handleCapabilityQueryMessage;
+    /**
+     * 处理任务响应消息
+     */
+    private handleTaskResponseMessage;
+    /**
+     * 处理解密失败通知消息
+     */
+    private handleDecryptFailedMessage;
+    /**
+     * 处理发现消息
+     */
+    /**
+       * 处理发现消息
+       */
+    private handleDiscover;
+    /**
+     * 将发现到的 Agent 信息更新到 Peer 表
+     */
+    private upsertPeerFromAgentInfo;
+    /**
+     * 处理能力查询
+     */
+    private handleCapabilityQuery;
+    /**
+     * 处理任务响应
+     */
+    private handleTaskResponse;
+    /**
+     * 连接引导节点
+     */
+    private connectToBootstrapPeers;
+    /**
+     * 启动定期发现广播
+     */
+    private startDiscoveryBroadcast;
+    /**
+     * 启动定期清理任务
+     */
+    private startCleanupTask;
+    /**
+     * 清理过期的 Peer 记录（带锁保护）
+     * @param aggressive 是否使用激进清理策略（清理更多条目）
+     */
+    private cleanupStalePeers;
+    /**
+     * 清理过期的 Peer 记录（内部方法，调用前必须持有锁）
+     * @param aggressive 是否使用激进清理策略（清理更多条目）
+     */
+    private cleanupStalePeersLocked;
+    /**
+     * 原子操作：获取 peer 信息
+     */
+    private getPeer;
+    /**
+     * 原子操作：设置 peer 信息
+     */
+    private setPeer;
+    /**
+     * 原子操作：更新 peer 信息（线程安全）
+     * @param peerId Peer ID
+     * @param updater 更新函数，接收当前值，返回新值
+     * @returns 更新后的 peer 信息，如果 peer 不存在则返回 undefined
+     */
+    private updatePeer;
+    /**
+     * 原子操作：安全地更新或创建 peer
+     * @param peerId Peer ID
+     * @param creator 创建新 peer 的函数（如果不存在）
+     * @param updater 更新函数（如果存在）
+     */
+    private upsertPeer;
+    /**
+     * 原子操作：删除 peer
+     */
+    private deletePeer;
+    /**
+     * 检查 Agent 是否有特定能力
+     */
+    private hasCapability;
+    /**
+     * 获取已连接的 Peers
+     */
+    getConnectedPeers(): PeerInfo[];
+    /**
+     * 获取所有已知的 Peers
+     */
+    getAllPeers(): PeerInfo[];
+    /**
+     * 获取节点 ID
+     */
+    getPeerId(): string | null;
+    /**
+     * 获取 E2EE 加密公钥
+     */
+    getEncryptionPublicKey(): string | null;
+    /**
+     * 获取已注册的加密对等方数量
+     */
+    getEncryptedPeerCount(): number;
+    /**
+     * 通过 DHT 查找节点 (全局发现)
+     */
+    findPeerViaDHT(peerId: string): Promise<Result<string[]>>;
+    /**
+     * 获取 DHT 路由表大小
+     */
+    getDHTPeerCount(): number;
+    /**
+     * 检查 DHT 是否启用
+     */
+    isDHTEnabled(): boolean;
+    /**
+     * 注册中间件
+     * @param middleware 中间件实例
+     */
+    useMiddleware(middleware: Middleware): void;
+    /**
+     * 移除中间件
+     * @param name 中间件名称
+     * @returns 是否成功移除
+     */
+    removeMiddleware(name: string): boolean;
+    /**
+     * 获取已注册的中间件列表
+     * @returns 中间件名称列表
+     */
+    listMiddlewares(): string[];
+}
+//# sourceMappingURL=p2p-network.d.ts.map

package/dist/core/p2p-network.d.ts.map

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