@bolloon/bolloon-agent 0.1.0 → 0.1.2

package/dist/social/channels/channel-heartbeat-agent.js

@@ -0,0 +1,494 @@
+/**
+ * Channel Heartbeat Agent - 集成 Harness 判断力的自动心跳智能体
+ *
+ * 功能：
+ * 1. 自动心跳广播 persona 到 IPFS
+ * 2. 自动发现外部智能体并解析 DiapDoc
+ * 3. 基于判断力引擎自动调用 Harness
+ * 4. 与外部智能体自动多轮对话
+ */
+import { createChannelAgent } from './channel-agent-session.js';
+import { createDiapDocParser } from './diap-doc-parser.js';
+import { createChannelJudgmentEngine } from '../../bollharness-integration/channel-judgment-engine.js';
+/**
+ * Channel Heartbeat Agent - 自动心跳 + 判断力驱动的多轮对话
+ */
+export class ChannelHeartbeatAgent {
+    config;
+    channelAgent;
+    docParser = createDiapDocParser();
+    judgmentEngine = createChannelJudgmentEngine();
+    discoveredPeers = new Map();
+    peerDialogueHistory = new Map();
+    heartbeatInterval = null;
+    dialogueInterval = null;
+    isRunning = false;
+    ipfsEndpoint;
+    ipnsName = null;
+    ownCid = null;
+    constructor(config) {
+        this.config = {
+            autoDiscovery: true,
+            autoDialogue: false,
+            dialogueInterval: 60 * 1000, // 1 分钟
+            ...config
+        };
+        this.ipfsEndpoint = config.ipfsEndpoint || 'http://127.0.0.1:5001';
+        this.ipnsName = config.ipnsName || null;
+        // 创建 Channel Agent
+        const agentConfig = {
+            name: config.name,
+            port: config.port,
+            domain: '通用',
+            capabilities: config.capabilities || ['对话', '分析', '协作']
+        };
+        this.channelAgent = createChannelAgent(agentConfig);
+    }
+    /**
+     * 启动 Agent
+     */
+    async start() {
+        await this.channelAgent.start();
+        // 发布初始 persona 到 IPFS
+        await this.publishPersona();
+        // 启动心跳循环
+        this.startHeartbeat();
+        // 启动自动对话循环
+        if (this.config.autoDialogue) {
+            this.startAutoDialogue();
+        }
+        this.isRunning = true;
+        console.log(`[HeartbeatAgent] ${this.config.name} started`);
+    }
+    /**
+     * 停止 Agent
+     */
+    stop() {
+        this.isRunning = false;
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+            this.heartbeatInterval = null;
+        }
+        if (this.dialogueInterval) {
+            clearInterval(this.dialogueInterval);
+            this.dialogueInterval = null;
+        }
+        this.channelAgent.shutdown();
+        console.log(`[HeartbeatAgent] ${this.config.name} stopped`);
+    }
+    /**
+     * 发布 persona 到 IPFS
+     */
+    async publishPersona() {
+        try {
+            const persona = this.channelAgent.getPersona();
+            if (!persona) {
+                console.log('[HeartbeatAgent] No persona to publish');
+                return;
+            }
+            const doc = {
+                id: this.channelAgent.getDid(),
+                name: persona.name,
+                description: persona.description,
+                capabilities: persona.capabilities,
+                interests: persona.interests,
+                personality: persona.personality,
+                greeting: persona.greeting,
+                version: '1.0',
+                updatedAt: new Date().toISOString()
+            };
+            const content = JSON.stringify(doc);
+            const { IpfsClient } = await import('@diap/sdk');
+            const ipfs = new IpfsClient(this.ipfsEndpoint, null);
+            const result = await ipfs.upload(content);
+            this.ownCid = typeof result === 'string' ? result : result?.cid;
+            if (this.ownCid) {
+                console.log(`[HeartbeatAgent] Published to IPFS: ${this.ownCid}`);
+                // 发布到 IPNS
+                if (this.ipnsName) {
+                    try {
+                        await ipfs.publishIpns(this.ipnsName, this.ownCid);
+                        console.log(`[HeartbeatAgent] Published to IPNS: ${this.ipnsName}`);
+                    }
+                    catch (e) {
+                        console.warn(`[HeartbeatAgent] IPNS publish failed:`, e);
+                    }
+                }
+            }
+        }
+        catch (e) {
+            console.warn('[HeartbeatAgent] IPFS publish failed:', e);
+        }
+    }
+    /**
+     * 启动心跳循环
+     */
+    startHeartbeat() {
+        this.heartbeatInterval = setInterval(async () => {
+            await this.heartbeat();
+        }, 30000); // 30 秒
+    }
+    /**
+     * 心跳处理
+     */
+    async heartbeat() {
+        if (!this.isRunning)
+            return;
+        try {
+            // 1. 发布/更新 persona
+            await this.publishPersona();
+            // 2. 自动发现智能体
+            if (this.config.autoDiscovery) {
+                await this.discoverPeers();
+            }
+            // 3. 解析已发现但未解析的智能体
+            await this.resolveUnresolvedPeers();
+            console.log(`[HeartbeatAgent] Beat: ${this.discoveredPeers.size} peers discovered`);
+        }
+        catch (e) {
+            console.error('[HeartbeatAgent] Heartbeat error:', e);
+        }
+    }
+    /**
+     * 发现对等节点
+     */
+    async discoverPeers() {
+        try {
+            const { p2pNetwork } = await import('../../network/p2p.js');
+            // 广播发现请求
+            const request = {
+                type: 'discovery_request',
+                requesterDid: this.channelAgent.getDid(),
+                requesterName: this.config.name,
+                capabilities: this.config.capabilities || [],
+                timestamp: Date.now()
+            };
+            await p2pNetwork.broadcast('agent_discovery', JSON.stringify(request));
+            // 处理已有的连接
+            const connectedPeers = p2pNetwork.getConnectedPeers();
+            for (const peer of connectedPeers) {
+                const did = peer.peerId ? `did:key:${peer.peerId.substring(0, 16)}` : peer.peerId;
+                if (!this.discoveredPeers.has(did)) {
+                    this.discoveredPeers.set(did, {
+                        did,
+                        name: `Peer-${did.substring(8, 16)}`,
+                        peerId: peer.peerId,
+                        capabilities: [],
+                        lastSeen: Date.now()
+                    });
+                    console.log(`[HeartbeatAgent] Discovered peer: ${did}`);
+                }
+            }
+        }
+        catch (e) {
+            console.warn('[HeartbeatAgent] Peer discovery failed:', e);
+        }
+    }
+    /**
+     * 解析未解析的智能体 DiapDoc
+     */
+    async resolveUnresolvedPeers() {
+        for (const [did, peer] of this.discoveredPeers) {
+            if (peer.doc)
+                continue; // 已解析
+            try {
+                // 如果有 IPNSName，尝试解析
+                // 这里简化处理，实际应该从发现响应中获取 IPNSName
+                // 或者通过 peerId 查询对方的 DiapDoc
+                // 标记为已处理，避免重复解析
+                peer.lastSeen = Date.now();
+            }
+            catch (e) {
+                console.warn(`[HeartbeatAgent] Failed to resolve ${did}:`, e);
+            }
+        }
+    }
+    /**
+     * 处理发现的智能体公告
+     */
+    handleChannelAnnouncement(announcement) {
+        const did = announcement.leaderDid;
+        // 检查是否已发现
+        if (this.discoveredPeers.has(did)) {
+            const peer = this.discoveredPeers.get(did);
+            peer.lastSeen = Date.now();
+            if (announcement.capabilities) {
+                peer.capabilities = announcement.capabilities;
+            }
+            return;
+        }
+        // 新发现
+        const peer = {
+            did,
+            name: announcement.channelName,
+            channelId: announcement.channelId,
+            capabilities: announcement.capabilities || [],
+            lastSeen: Date.now()
+        };
+        this.discoveredPeers.set(did, peer);
+        console.log(`[HeartbeatAgent] New peer from announcement: ${announcement.channelName} (${did})`);
+        // 如果有 CID，尝试解析 DiapDoc
+        if (announcement.cid) {
+            this.resolvePeerFromCID(did, announcement.cid);
+        }
+        else if (announcement.ipnsName) {
+            this.resolvePeerFromIPNS(did, announcement.ipnsName);
+        }
+    }
+    /**
+     * 从 CID 解析对等节点 DiapDoc
+     */
+    async resolvePeerFromCID(did, cid) {
+        try {
+            const result = await this.docParser.parseFromCID(cid, this.ipfsEndpoint);
+            if (result.success && result.doc) {
+                const peer = this.discoveredPeers.get(did);
+                if (peer) {
+                    peer.doc = result.doc;
+                    peer.name = result.doc.name;
+                    peer.capabilities = result.doc.capabilities;
+                    console.log(`[HeartbeatAgent] Resolved DiapDoc for ${result.doc.name}: ${result.doc.capabilities.join(', ')}`);
+                }
+            }
+        }
+        catch (e) {
+            console.warn(`[HeartbeatAgent] Failed to resolve CID ${cid}:`, e);
+        }
+    }
+    /**
+     * 从 IPNS 解析对等节点 DiapDoc
+     */
+    async resolvePeerFromIPNS(did, ipnsName) {
+        try {
+            const result = await this.docParser.parseFromIPNS(ipnsName, this.ipfsEndpoint);
+            if (result.success && result.doc) {
+                const peer = this.discoveredPeers.get(did);
+                if (peer) {
+                    peer.doc = result.doc;
+                    peer.name = result.doc.name;
+                    peer.capabilities = result.doc.capabilities;
+                    console.log(`[HeartbeatAgent] Resolved DiapDoc via IPNS for ${result.doc.name}`);
+                }
+            }
+        }
+        catch (e) {
+            console.warn(`[HeartbeatAgent] Failed to resolve IPNS ${ipnsName}:`, e);
+        }
+    }
+    /**
+     * 启动自动对话循环
+     */
+    startAutoDialogue() {
+        this.dialogueInterval = setInterval(async () => {
+            await this.processAutoDialogue();
+        }, this.config.dialogueInterval);
+    }
+    /**
+     * 处理自动对话
+     */
+    async processAutoDialogue() {
+        if (!this.isRunning)
+            return;
+        for (const [did, peer] of this.discoveredPeers) {
+            // 检查是否应该触发对话
+            if (!this.shouldTriggerDialogue(peer))
+                continue;
+            // 生成自动消息
+            const message = this.generateAutoMessage(peer);
+            if (!message)
+                continue;
+            // 获取对话历史
+            const history = this.peerDialogueHistory.get(did) || [];
+            const historyMessages = history.map(e => e.message);
+            // 判断是否需要调用 Harness
+            const context = {
+                conversationHistory: historyMessages,
+                currentMessage: message,
+                senderName: peer.name
+            };
+            const decision = this.judgmentEngine.decide(context);
+            if (decision.shouldCall) {
+                console.log(`[HeartbeatAgent] Auto-triggering Harness: Gate ${decision.gate} for ${peer.name}`);
+                // 这里可以发送消息触发对方响应
+                // 或者直接记录到历史
+            }
+            peer.lastDialogue = Date.now();
+        }
+    }
+    /**
+     * 判断是否应该触发对话
+     */
+    shouldTriggerDialogue(peer) {
+        // 刚发现的智能体不立即对话
+        if (Date.now() - peer.lastSeen < 60000)
+            return false;
+        // 频繁对话的智能体减少频率
+        if (peer.lastDialogue && Date.now() - peer.lastDialogue < 300000)
+            return false;
+        return true;
+    }
+    /**
+     * 生成自动消息
+     */
+    generateAutoMessage(peer) {
+        const greetings = [
+            `你好 ${peer.name}，我是 ${this.config.name}。`,
+            `你好！我注意到你也有 ${peer.capabilities[0] || '协作'} 能力。`,
+            `你好！我们有共同的兴趣领域。`
+        ];
+        const topicMessages = [
+            '你最近在做什么项目？',
+            '你对哪些话题感兴趣？',
+            '有什么我可以帮忙的吗？'
+        ];
+        // 首次对话使用问候
+        if (!peer.lastDialogue) {
+            return greetings[Math.floor(Math.random() * greetings.length)];
+        }
+        // 后续对话使用主题
+        return topicMessages[Math.floor(Math.random() * topicMessages.length)];
+    }
+    /**
+     * 向指定对等节点发送消息
+     */
+    async sendMessage(targetDid, content) {
+        const peer = this.discoveredPeers.get(targetDid);
+        if (!peer) {
+            return { success: false };
+        }
+        try {
+            // 如果有 P2P 连接，通过 P2P 发送
+            if (peer.peerId) {
+                const { p2pNetwork } = await import('../../network/p2p.js');
+                const payload = JSON.stringify({
+                    from: this.channelAgent.getDid(),
+                    fromName: this.config.name,
+                    content,
+                    timestamp: Date.now()
+                });
+                await p2pNetwork.sendMessage(peer.peerId, 'agent_message', payload);
+            }
+            // 记录到历史
+            const history = this.peerDialogueHistory.get(targetDid) || [];
+            history.push({
+                id: `msg_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`,
+                speaker: this.config.name,
+                message: content,
+                timestamp: Date.now(),
+                harnessCalled: false
+            });
+            this.peerDialogueHistory.set(targetDid, history);
+            return { success: true };
+        }
+        catch (e) {
+            console.warn(`[HeartbeatAgent] Failed to send message to ${targetDid}:`, e);
+            return { success: false };
+        }
+    }
+    /**
+     * 处理收到的消息
+     */
+    async handleMessage(fromDid, fromName, content) {
+        // 获取对话历史
+        const history = this.peerDialogueHistory.get(fromDid) || [];
+        const historyMessages = history.map(e => e.message);
+        // 通过 Channel Agent 处理
+        const result = await this.channelAgent.receiveMessage(fromName, content);
+        // 记录到历史
+        history.push({
+            id: `msg_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`,
+            speaker: fromName,
+            message: content,
+            timestamp: Date.now(),
+            harnessCalled: result.harnessCalled,
+            gate: result.gate
+        });
+        history.push({
+            id: `msg_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`,
+            speaker: this.config.name,
+            message: result.response,
+            timestamp: Date.now(),
+            harnessCalled: result.harnessCalled,
+            gate: result.gate
+        });
+        this.peerDialogueHistory.set(fromDid, history.slice(-50)); // 保留最近 50 条
+        // 更新对等节点活跃时间
+        const peer = this.discoveredPeers.get(fromDid);
+        if (peer) {
+            peer.lastSeen = Date.now();
+            peer.lastDialogue = Date.now();
+        }
+        return result;
+    }
+    // ==================== Getters ====================
+    getName() {
+        return this.config.name;
+    }
+    getDid() {
+        return this.channelAgent.getDid();
+    }
+    getDiscoveredPeers() {
+        return Array.from(this.discoveredPeers.values());
+    }
+    getPeerDialogueHistory(did) {
+        return this.peerDialogueHistory.get(did) || [];
+    }
+    isActive() {
+        return this.isRunning;
+    }
+    getOwnCID() {
+        return this.ownCid;
+    }
+    getOwnIPNS() {
+        return this.ipnsName;
+    }
+}
+// 工厂函数
+export function createHeartbeatAgent(config) {
+    return new ChannelHeartbeatAgent(config);
+}
+// 全局注册表
+export class HeartbeatAgentRegistry {
+    agents = new Map();
+    register(agent) {
+        this.agents.set(agent.getDid(), agent);
+    }
+    unregister(did) {
+        const agent = this.agents.get(did);
+        if (agent) {
+            agent.stop();
+            this.agents.delete(did);
+        }
+    }
+    get(did) {
+        return this.agents.get(did);
+    }
+    getByName(name) {
+        for (const agent of this.agents.values()) {
+            if (agent.getName() === name) {
+                return agent;
+            }
+        }
+        return undefined;
+    }
+    list() {
+        return Array.from(this.agents.values());
+    }
+    broadcastToAll(type, payload) {
+        let count = 0;
+        for (const agent of this.agents.values()) {
+            const peers = agent.getDiscoveredPeers();
+            for (const peer of peers) {
+                agent.sendMessage(peer.did, payload);
+                count++;
+            }
+        }
+        return count;
+    }
+    clear() {
+        for (const agent of this.agents.values()) {
+            agent.stop();
+        }
+        this.agents.clear();
+    }
+}

package/dist/social/channels/diap-doc-parser.js

@@ -0,0 +1,204 @@
+/**
+ * DiapDoc Parser - 解析 Diap 去中心化身份协议文档
+ *
+ * 负责解析 Diap 智能体发布的 IPFS/IPNS 文档，提取：
+ * - DID (去中心化身份标识)
+ * - 频道信息
+ * - 能力列表
+ * - 网络地址
+ */
+/**
+ * DiapDoc Parser 类
+ */
+export class DiapDocParser {
+    /**
+     * 解析 Diap 文档 (从 IPFS CID 或 IPNS 获取的内容)
+     */
+    parse(content) {
+        try {
+            const data = JSON.parse(content);
+            // 验证必需字段
+            if (!data.id && !data.did) {
+                return {
+                    success: false,
+                    error: 'Missing required field: id or did'
+                };
+            }
+            const doc = {
+                id: data.id || data.did,
+                name: data.name || 'Unknown Agent',
+                version: data.version || '1.0',
+                // 能力信息
+                capabilities: this.normalizeArray(data.capabilities || data.capability || []),
+                interests: this.normalizeArray(data.interests || data.interest || []),
+                // 网络信息
+                peerId: data.peerId || data.peer_id || data.peer,
+                multiaddrs: this.normalizeArray(data.multiaddrs || data.addresses || []),
+                relayAddr: data.relayAddr || data.relay_addr || data.relay,
+                // 频道信息
+                channels: this.parseChannels(data.channels || data.channel || []),
+                // 身份信息
+                publicKey: data.publicKey || data.public_key,
+                signature: data.signature,
+                // 时间戳
+                createdAt: data.createdAt || data.created_at,
+                updatedAt: data.updatedAt || data.updated_at,
+                timestamp: data.timestamp || data.createdAt ? Date.now() : undefined
+            };
+            return { success: true, doc };
+        }
+        catch (e) {
+            return {
+                success: false,
+                error: `Failed to parse DiapDoc: ${e}`
+            };
+        }
+    }
+    /**
+     * 解析频道数组
+     */
+    parseChannels(channels) {
+        if (!Array.isArray(channels))
+            return [];
+        return channels.map(ch => {
+            if (typeof ch === 'string') {
+                return {
+                    id: ch,
+                    name: ch
+                };
+            }
+            return {
+                id: ch.id || ch.channelId || ch.channel_id || String(Date.now()),
+                name: ch.name || ch.channelName || ch.channel_name || 'Unnamed Channel',
+                topic: ch.topic,
+                type: ch.type,
+                isPublic: ch.isPublic ?? ch.is_public ?? true,
+                memberCount: ch.memberCount || ch.member_count
+            };
+        });
+    }
+    /**
+     * 规范化数组
+     */
+    normalizeArray(value) {
+        if (Array.isArray(value)) {
+            return value.map(v => String(v));
+        }
+        if (typeof value === 'string') {
+            return [value];
+        }
+        return [];
+    }
+    /**
+     * 从 CID 解析文档
+     */
+    async parseFromCID(cid, ipfsEndpoint = 'http://127.0.0.1:5001') {
+        try {
+            const { IpfsClient } = await import('@diap/sdk');
+            const ipfs = new IpfsClient(ipfsEndpoint, null);
+            const content = await ipfs.get(cid);
+            return this.parse(content);
+        }
+        catch (e) {
+            return {
+                success: false,
+                error: `Failed to fetch from IPFS: ${e}`
+            };
+        }
+    }
+    /**
+     * 从 IPNS 解析文档
+     */
+    async parseFromIPNS(ipnsName, ipfsEndpoint = 'http://127.0.0.1:5001') {
+        try {
+            const { IpfsClient } = await import('@diap/sdk');
+            const ipfs = new IpfsClient(ipfsEndpoint, null);
+            const cid = await ipfs.resolveIpns(ipnsName);
+            if (!cid) {
+                return {
+                    success: false,
+                    error: 'IPNS resolve returned no CID'
+                };
+            }
+            return this.parseFromCID(cid, ipfsEndpoint);
+        }
+        catch (e) {
+            return {
+                success: false,
+                error: `Failed to resolve IPNS: ${e}`
+            };
+        }
+    }
+    /**
+     * 从 URL 解析 (用于解析网关返回的内容)
+     */
+    parseFromUrl(url) {
+        return fetch(url)
+            .then(resp => resp.text())
+            .then(content => this.parse(content))
+            .catch(e => ({
+            success: false,
+            error: `Failed to fetch URL: ${e}`
+        }));
+    }
+    /**
+     * 提取 DID
+     */
+    extractDID(doc) {
+        return doc.id;
+    }
+    /**
+     * 提取用于连接的信息
+     */
+    extractConnectionInfo(doc) {
+        return {
+            peerId: doc.peerId,
+            multiaddrs: doc.multiaddrs || [],
+            relayAddr: doc.relayAddr
+        };
+    }
+    /**
+     * 提取频道列表
+     */
+    extractChannels(doc) {
+        return doc.channels || [];
+    }
+    /**
+     * 验证文档签名 (如果实现)
+     */
+    async verifySignature(doc) {
+        if (!doc.publicKey || !doc.signature) {
+            return true; // 无签名时默认通过
+        }
+        // TODO: 实现签名验证
+        return true;
+    }
+}
+// 全局解析器实例
+let parserInstance = null;
+export function createDiapDocParser() {
+    return new DiapDocParser();
+}
+export function getDiapDocParser() {
+    if (!parserInstance) {
+        parserInstance = new DiapDocParser();
+    }
+    return parserInstance;
+}
+/**
+ * 从 DiapAnnouncement 提取 DiapDoc 信息
+ */
+export function extractDocFromAnnouncement(announcement) {
+    return {
+        id: announcement.leaderDid,
+        name: announcement.channelName,
+        version: '1.0',
+        capabilities: announcement.capabilities || [],
+        interests: announcement.interests || [],
+        channels: announcement.channelId ? [{
+                id: announcement.channelId,
+                name: announcement.channelName,
+                topic: announcement.topic
+            }] : []
+    };
+}