@bolloon/bolloon-agent 0.2.9 → 0.2.10

package/dist/network/peer-fs.js

@@ -1,420 +0,0 @@
-/**
- * peer-fs.ts — peer 目录读写 + agents 索引 + manifest 落盘
- *
- * 设计目的 (2026-07-05):
- *   把"远程 P2P 节点"在本地物化成一份文件夹, 让本地所有 agent 都能"知道对方有什么":
- *   ~/.bolloon/peers/<publicKey>/
- *     peer.json               ← 对方基础信息 (name / publicKey / lastSeen / lastManifestTs)
- *     user.md                 ← 对方用户画像 (本地维护)
- *     _index.json             ← 对方 agent 列表 (轻量, 懒加载时优先读)
- *     capability-index.md     ← ≤500 字摘要, 拼进 prompt
- *     agents/<agentId>.md     ← 每个 agent 详细描述
- *     groups/<groupId>.md     ← 群组
- *     function/<cap>.md       ← 视频/音乐/图片
- *     exportment/<game>.md    ← 游戏
- *     science/<exp>.md        ← 实验记录
- *     chat-<YYYY-MM>.md       ← 月度聊天记录归档
- *     outbox.jsonl            ← 离线发送队列 (对方不在线时缓存)
- *
- * 写盘策略:
- *   - 纯文本 md 文件, 人类可读, 便于调试
- *   - JSON 仅用于 peer.json / _index.json / outbox.jsonl
- *   - 全部操作 atomic (write tmp + rename), 避免半截文件
- */
-import * as fs from 'fs/promises';
-import * as path from 'path';
-import * as os from 'os';
-import * as crypto from 'crypto';
-// ============== 路径常量 ==============
-const HOME = process.env.BOLLOON_HOME || path.join(os.homedir(), '.bolloon');
-const PEERS_ROOT = path.join(HOME, 'peers');
-/** publicKey hex → 短哈希, 用于目录名防超长 */
-export function peerDirName(publicKey) {
-    // 用 sha256 前 16 位 hex, 防 publicKey 改名冲突 + 文件名长度可控
-    const h = crypto.createHash('sha256').update(publicKey).digest('hex').slice(0, 16);
-    return `${h}__${publicKey.slice(0, 8)}`;
-}
-export function getPeerDir(publicKey) {
-    return path.join(PEERS_ROOT, peerDirName(publicKey));
-}
-export function getPeerIndexPath(publicKey) {
-    return path.join(getPeerDir(publicKey), '_index.json');
-}
-export function getPeerJsonPath(publicKey) {
-    return path.join(getPeerDir(publicKey), 'peer.json');
-}
-export function getPeerCapabilityIndexPath(publicKey) {
-    return path.join(getPeerDir(publicKey), 'capability-index.md');
-}
-export function getPeerChatPath(publicKey, yearMonth) {
-    const ym = yearMonth || currentYearMonth();
-    return path.join(getPeerDir(publicKey), `chat-${ym}.md`);
-}
-export function getPeerOutboxPath(publicKey) {
-    return path.join(getPeerDir(publicKey), 'outbox.jsonl');
-}
-export function getPeerUserMdPath(publicKey) {
-    return path.join(getPeerDir(publicKey), 'user.md');
-}
-export function getPeerAgentMdPath(publicKey, agentId) {
-    return path.join(getPeerDir(publicKey), 'agents', `${safeName(agentId)}.md`);
-}
-export function getPeerGroupMdPath(publicKey, groupId) {
-    return path.join(getPeerDir(publicKey), 'groups', `${safeName(groupId)}.md`);
-}
-export function getPeerFunctionMdPath(publicKey, capability) {
-    return path.join(getPeerDir(publicKey), 'function', `${safeName(capability)}.md`);
-}
-export function getPeerExportmentMdPath(publicKey, game) {
-    return path.join(getPeerDir(publicKey), 'exportment', `${safeName(game)}.md`);
-}
-export function getPeerScienceMdPath(publicKey, expId) {
-    return path.join(getPeerDir(publicKey), 'science', `${safeName(expId)}.md`);
-}
-export function currentYearMonth() {
-    const d = new Date();
-    return `${d.getUTCFullYear()}-${String(d.getUTCMonth() + 1).padStart(2, '0')}`;
-}
-/** 文件名安全化: 去掉 / \ : * ? " < > | 控制符 */
-function safeName(s) {
-    return s.replace(/[\/\\:\*\?"<>\|\x00-\x1f]/g, '_').slice(0, 64);
-}
-// ============== Atomic write helper ==============
-async function atomicWrite(filePath, content) {
-    await fs.mkdir(path.dirname(filePath), { recursive: true });
-    const tmp = filePath + '.tmp.' + Math.random().toString(36).slice(2, 8);
-    await fs.writeFile(tmp, content);
-    await fs.rename(tmp, filePath);
-}
-async function atomicWriteJson(filePath, obj) {
-    await atomicWrite(filePath, JSON.stringify(obj, null, 2) + '\n');
-}
-async function readJsonSafe(filePath) {
-    try {
-        const raw = await fs.readFile(filePath, 'utf-8');
-        return JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-}
-// ============== peer.json ==============
-export async function upsertPeer(rec) {
-    const file = getPeerJsonPath(rec.publicKey);
-    const existing = await readJsonSafe(file);
-    const merged = {
-        publicKey: rec.publicKey,
-        name: rec.name ?? existing?.name,
-        addedAt: existing?.addedAt || rec.addedAt || new Date().toISOString(),
-        lastSeenAt: rec.lastSeenAt ?? existing?.lastSeenAt,
-        lastManifestTs: rec.lastManifestTs ?? existing?.lastManifestTs,
-        manifestCount: rec.manifestCount ?? existing?.manifestCount,
-        notes: rec.notes ?? existing?.notes,
-    };
-    await atomicWriteJson(file, merged);
-    return merged;
-}
-export async function getPeer(publicKey) {
-    return readJsonSafe(getPeerJsonPath(publicKey));
-}
-export async function listPeersFromDisk() {
-    try {
-        const entries = await fs.readdir(PEERS_ROOT);
-        const out = [];
-        for (const e of entries) {
-            const peerFile = path.join(PEERS_ROOT, e, 'peer.json');
-            const rec = await readJsonSafe(peerFile);
-            if (rec)
-                out.push(rec);
-        }
-        return out;
-    }
-    catch {
-        return [];
-    }
-}
-// ============== _index.json (agent 清单) ==============
-export async function writePeerIndex(publicKey, idx) {
-    await atomicWriteJson(getPeerIndexPath(publicKey), idx);
-}
-export async function readPeerIndex(publicKey) {
-    return readJsonSafe(getPeerIndexPath(publicKey));
-}
-// ============== 单个 agent 详细描述 (markdown) ==============
-export async function writeAgentDescription(publicKey, agent, ownerDescription) {
-    const lines = [];
-    lines.push(`# ${agent.name || agent.id}`);
-    lines.push('');
-    lines.push(`- **ID**: ${agent.id}`);
-    lines.push(`- **状态**: ${agent.status}`);
-    if (agent.capabilities.length) {
-        lines.push(`- **能力**: ${agent.capabilities.join(', ')}`);
-    }
-    if (agent.description) {
-        lines.push('');
-        lines.push('## 描述');
-        lines.push('');
-        lines.push(agent.description);
-    }
-    if (ownerDescription) {
-        lines.push('');
-        lines.push('## Owner 备注');
-        lines.push('');
-        lines.push(ownerDescription);
-    }
-    if (agent.peerId || agent.irohNodeId || agent.sessionId) {
-        lines.push('');
-        lines.push('## 寻址');
-        if (agent.peerId)
-            lines.push(`- peerId: ${agent.peerId}`);
-        if (agent.irohNodeId)
-            lines.push(`- irohNodeId: ${agent.irohNodeId}`);
-        if (agent.sessionId)
-            lines.push(`- sessionId: ${agent.sessionId}`);
-    }
-    lines.push('');
-    lines.push(`> 自动生成于 ${new Date().toISOString()} (peer=${publicKey.slice(0, 12)}...)`);
-    lines.push('');
-    await atomicWrite(getPeerAgentMdPath(publicKey, agent.id), lines.join('\n'));
-}
-// ============== capability-index.md (≤500 字摘要, 进 prompt) ==============
-export function buildCapabilityIndex(idx) {
-    const lines = [];
-    lines.push(`# 远端节点能力索引 — ${idx.ownerName || idx.publicKey.slice(0, 12)}`);
-    lines.push('');
-    if (idx.ownerDescription) {
-        lines.push(idx.ownerDescription.slice(0, 200));
-        lines.push('');
-    }
-    lines.push(`## Agent (${idx.agents.length} 个)`);
-    for (const a of idx.agents.slice(0, 20)) {
-        const caps = a.capabilities.length ? ` [${a.capabilities.join('/')}]` : '';
-        const desc = a.description ? ` — ${a.description.slice(0, 60)}` : '';
-        lines.push(`- ${a.name}${caps}${desc}`);
-    }
-    if (idx.agents.length > 20)
-        lines.push(`- … 还有 ${idx.agents.length - 20} 个`);
-    if (idx.groups?.length) {
-        lines.push('');
-        lines.push(`## 群组 (${idx.groups.length})`);
-        for (const g of idx.groups.slice(0, 10))
-            lines.push(`- ${g.name}${g.description ? ' — ' + g.description.slice(0, 50) : ''}`);
-    }
-    if (idx.functions?.length) {
-        lines.push('');
-        lines.push(`## 可用功能 (${idx.functions.length})`);
-        for (const f of idx.functions.slice(0, 10))
-            lines.push(`- ${f.capability}${f.description ? ' — ' + f.description.slice(0, 50) : ''}`);
-    }
-    if (idx.exportments?.length) {
-        lines.push('');
-        lines.push(`## 娱乐 (${idx.exportments.length})`);
-        for (const e of idx.exportments.slice(0, 10))
-            lines.push(`- ${e.name}${e.description ? ' — ' + e.description.slice(0, 50) : ''}`);
-    }
-    const text = lines.join('\n');
-    // 截到 500 字
-    return text.length > 500 ? text.slice(0, 497) + '…' : text;
-}
-export async function writeCapabilityIndex(publicKey, idx) {
-    const text = buildCapabilityIndex(idx);
-    await atomicWrite(getPeerCapabilityIndexPath(publicKey), text);
-}
-export async function readCapabilityIndex(publicKey) {
-    try {
-        return await fs.readFile(getPeerCapabilityIndexPath(publicKey), 'utf-8');
-    }
-    catch {
-        return null;
-    }
-}
-// ============== chat-<YYYY-MM>.md 月度归档 ==============
-function formatChatEntry(e) {
-    const ts = e.ts.replace('T', ' ').replace(/\.\d+Z$/, ' UTC');
-    const src = e.source;
-    const chan = e.channelName ? ` [${e.channelName}]` : '';
-    const from = e.fromPublicKey ? ` (${e.fromPublicKey.slice(0, 12)}…)` : '';
-    return `### ${ts}${chan} — ${src}${from}\n\n${e.text}\n`;
-}
-export async function appendChat(publicKey, entry) {
-    const file = getPeerChatPath(publicKey);
-    // 如果文件不存在, 先写头
-    try {
-        await fs.access(file);
-    }
-    catch {
-        await atomicWrite(file, `# 与 ${publicKey.slice(0, 12)}… 的聊天记录\n\n> 自动归档; 详细消息存于 sessions/cache/, 这里按月滚动.\n\n`);
-    }
-    // append
-    await fs.appendFile(file, '\n---\n\n' + formatChatEntry(entry), 'utf-8');
-}
-export async function readChatArchive(publicKey, yearMonth) {
-    try {
-        return await fs.readFile(getPeerChatPath(publicKey, yearMonth), 'utf-8');
-    }
-    catch {
-        return null;
-    }
-}
-export async function listChatMonths(publicKey) {
-    try {
-        const dir = getPeerDir(publicKey);
-        const entries = await fs.readdir(dir);
-        return entries
-            .filter(e => /^chat-\d{4}-\d{2}\.md$/.test(e))
-            .map(e => e.replace(/^chat-/, '').replace(/\.md$/, ''))
-            .sort();
-    }
-    catch {
-        return [];
-    }
-}
-// ============== outbox.jsonl 离线队列 ==============
-export async function enqueueOutbox(publicKey, entry) {
-    const file = getPeerOutboxPath(publicKey);
-    await fs.mkdir(path.dirname(file), { recursive: true });
-    await fs.appendFile(file, JSON.stringify(entry) + '\n', 'utf-8');
-}
-export async function readOutbox(publicKey) {
-    try {
-        const raw = await fs.readFile(getPeerOutboxPath(publicKey), 'utf-8');
-        return raw.split('\n').filter(Boolean).map(line => JSON.parse(line));
-    }
-    catch {
-        return [];
-    }
-}
-export async function clearOutbox(publicKey) {
-    try {
-        await fs.unlink(getPeerOutboxPath(publicKey));
-    }
-    catch { }
-}
-export async function countOutbox(publicKey) {
-    return (await readOutbox(publicKey)).length;
-}
-// ============== user.md 本地维护的对方用户画像 ==============
-export async function readUserPortrait(publicKey) {
-    try {
-        return await fs.readFile(getPeerUserMdPath(publicKey), 'utf-8');
-    }
-    catch {
-        return null;
-    }
-}
-export async function writeUserPortrait(publicKey, markdown) {
-    await atomicWrite(getPeerUserMdPath(publicKey), markdown);
-}
-// ============== 单个 group/function/exportment/science writer ==============
-// (peer-fs.ts 之前只有 reader — 现在补齐 4 类资源的 writer, 让 manifest.exchange.reply
-//  能落盘对方的群组/功能/娱乐/实验清单, 跟 agents/*.md 一样被本地 agent 看见.)
-function formatFrontmatter(fields) {
-    const lines = ['---'];
-    for (const [k, v] of Object.entries(fields)) {
-        if (v === undefined || v === null)
-            continue;
-        if (Array.isArray(v)) {
-            lines.push(`${k}: [${v.map((x) => JSON.stringify(x)).join(', ')}]`);
-        }
-        else if (typeof v === 'string') {
-            lines.push(`${k}: ${JSON.stringify(v)}`);
-        }
-        else {
-            lines.push(`${k}: ${JSON.stringify(v)}`);
-        }
-    }
-    lines.push('---');
-    return lines.join('\n');
-}
-function mdBody(title, fields, description, extra) {
-    const parts = [];
-    parts.push(`# ${title}`);
-    parts.push('');
-    parts.push(formatFrontmatter(fields));
-    parts.push('');
-    if (description) {
-        parts.push(description.trim());
-        parts.push('');
-    }
-    if (extra?.length) {
-        parts.push(...extra);
-        parts.push('');
-    }
-    parts.push(`> 自动写入于 ${new Date().toISOString()} (peer 来源)`);
-    parts.push('');
-    return parts.join('\n');
-}
-export async function writeGroup(publicKey, g) {
-    const body = mdBody(g.name, {
-        id: g.id,
-        name: g.name,
-        visibility: g.visibility || 'invite',
-        memberCount: g.memberCount,
-    }, g.description);
-    await atomicWrite(getPeerGroupMdPath(publicKey, g.id), body);
-}
-export async function writeFunction(publicKey, f) {
-    const body = mdBody(f.capability, {
-        capability: f.capability,
-        mediaType: f.mediaType || 'text',
-        endpoint: f.endpoint,
-    }, f.description, f.examples?.length ? ['## 示例', '', ...f.examples.map((e) => `- ${e}`)] : undefined);
-    await atomicWrite(getPeerFunctionMdPath(publicKey, f.capability), body);
-}
-export async function writeExportment(publicKey, e) {
-    const body = mdBody(e.name, {
-        name: e.name,
-        genre: e.genre,
-        minPlayers: e.minPlayers,
-        maxPlayers: e.maxPlayers,
-    }, e.description);
-    await atomicWrite(getPeerExportmentMdPath(publicKey, e.name), body);
-}
-export async function writeScience(publicKey, s) {
-    const recordsBlock = s.records?.length
-        ? ['## 记录', '', ...s.records.map((r) => `- **${r.ts}**: ${r.note}`)]
-        : undefined;
-    const body = mdBody(s.title, {
-        id: s.id,
-        title: s.title,
-        status: s.status || 'planned',
-        tags: s.tags,
-    }, s.description, recordsBlock);
-    await atomicWrite(getPeerScienceMdPath(publicKey, s.id), body);
-}
-export async function listPeerResources(publicKey) {
-    const dir = getPeerDir(publicKey);
-    const out = { groups: [], functions: [], exportments: [], sciences: [] };
-    for (const [subdir, key] of [
-        ['groups', 'groups'],
-        ['function', 'functions'],
-        ['exportment', 'exportments'],
-        ['science', 'sciences'],
-    ]) {
-        try {
-            const entries = await fs.readdir(path.join(dir, subdir));
-            for (const e of entries) {
-                if (!e.endsWith('.md'))
-                    continue;
-                const content = await fs.readFile(path.join(dir, subdir, e), 'utf-8');
-                const id = e.replace(/\.md$/, '');
-                if (key === 'groups')
-                    out.groups.push({ id, content });
-                else if (key === 'functions')
-                    out.functions.push({ capability: id, content });
-                else if (key === 'exportments')
-                    out.exportments.push({ name: id, content });
-                else
-                    out.sciences.push({ id, content });
-            }
-        }
-        catch { }
-    }
-    return out;
-}
-// ============== 测试 / 调试 helper ==============
-export const _debug = {
-    PEERS_ROOT,
-    peerDirName,
-    getPeerDir,
-};

package/dist/network/peer-resource-bridge.js

@@ -1,216 +0,0 @@
-/**
- * peer-resource-bridge.ts — 4 类资源 (groups/function/exportment/science) 的
- *   本地读 + 远端落盘的统一封装.
- *
- * 设计目的 (2026-07-05):
- *   peer-fs.ts 已经有完整路径 helpers (writeGroup/writeFunction/...) + reader (listPeerResources).
- *   server.ts 三处要调 (两个 manifest.exchange.reply 落盘 + 一个 manifest.exchange 发送),
- *   每处手写 4 个 await 又啰嗦又容易漏. 这里抽出来.
- *
- *   本地读: ~/.bolloon/local-resources/<category>/<id>.md frontmatter
- *   远端落: peerFs.writeGroup/Function/Exportment/Science (atomic, 人类可读 md)
- *
- *   frontmatter 字段就是类型本身的字段 (id/name/description/...),
- *   description 从 frontmatter 后面的第一个段落拿.
- */
-import * as fs from 'fs/promises';
-import * as path from 'path';
-import * as os from 'os';
-import * as peerFs from '../network/peer-fs.js';
-const HOME = process.env.BOLLOON_HOME || path.join(os.homedir(), '.bolloon');
-export const LOCAL_RESOURCES_ROOT = path.join(HOME, 'local-resources');
-const EMPTY = { groups: [], functions: [], exportments: [], sciences: [] };
-/**
- * 简单 frontmatter 解析: 只支持 key: value / key: [..] (本文件自产自销, 不引第三方).
- */
-function parseFrontmatter(text) {
-    const m = text.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
-    if (!m)
-        return { fields: {}, body: text };
-    const fields = {};
-    for (const line of m[1].split('\n')) {
-        const kv = line.match(/^([A-Za-z_][A-Za-z0-9_]*):\s*(.*)$/);
-        if (!kv)
-            continue;
-        const key = kv[1];
-        let raw = kv[2].trim();
-        if (raw.startsWith('[') && raw.endsWith(']')) {
-            try {
-                fields[key] = JSON.parse(raw);
-                continue;
-            }
-            catch { }
-        }
-        if ((raw.startsWith('"') && raw.endsWith('"')) || (raw.startsWith("'") && raw.endsWith("'"))) {
-            try {
-                fields[key] = JSON.parse(raw);
-                continue;
-            }
-            catch { }
-        }
-        fields[key] = raw;
-    }
-    return { fields, body: m[2].trim() };
-}
-/**
- * 从 ~/.bolloon/local-resources/<category>/<id>.md 读所有本地资源.
- * 文件不存在 / 目录不存在 → 返回空数组 (不报错, 跟 peer-fs 风格一致).
- */
-async function readCategoryDir(category) {
-    try {
-        const dir = path.join(LOCAL_RESOURCES_ROOT, category);
-        const entries = await fs.readdir(dir);
-        return entries.filter((e) => e.endsWith('.md')).map((e) => path.join(dir, e));
-    }
-    catch {
-        return [];
-    }
-}
-async function readGroupFile(p) {
-    try {
-        const raw = await fs.readFile(p, 'utf-8');
-        const { fields, body } = parseFrontmatter(raw);
-        if (!fields.id)
-            return null;
-        return {
-            id: String(fields.id),
-            name: String(fields.name || fields.id),
-            description: body || undefined,
-            visibility: fields.visibility,
-            memberCount: typeof fields.memberCount === 'number' ? fields.memberCount : undefined,
-        };
-    }
-    catch {
-        return null;
-    }
-}
-async function readFunctionFile(p) {
-    try {
-        const raw = await fs.readFile(p, 'utf-8');
-        const { fields, body } = parseFrontmatter(raw);
-        if (!fields.capability)
-            return null;
-        return {
-            capability: String(fields.capability),
-            description: body || undefined,
-            mediaType: fields.mediaType,
-            endpoint: fields.endpoint ? String(fields.endpoint) : undefined,
-        };
-    }
-    catch {
-        return null;
-    }
-}
-async function readExportmentFile(p) {
-    try {
-        const raw = await fs.readFile(p, 'utf-8');
-        const { fields, body } = parseFrontmatter(raw);
-        if (!fields.name)
-            return null;
-        return {
-            name: String(fields.name),
-            description: body || undefined,
-            genre: fields.genre ? String(fields.genre) : undefined,
-            minPlayers: typeof fields.minPlayers === 'number' ? fields.minPlayers : undefined,
-            maxPlayers: typeof fields.maxPlayers === 'number' ? fields.maxPlayers : undefined,
-        };
-    }
-    catch {
-        return null;
-    }
-}
-async function readScienceFile(p) {
-    try {
-        const raw = await fs.readFile(p, 'utf-8');
-        const { fields, body } = parseFrontmatter(raw);
-        if (!fields.id)
-            return null;
-        return {
-            id: String(fields.id),
-            title: String(fields.title || fields.id),
-            description: body || undefined,
-            status: fields.status,
-            tags: Array.isArray(fields.tags) ? fields.tags.map(String) : undefined,
-        };
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * 读本机所有 4 类资源. 任何失败 → 该类别返回空 (不阻塞其他类别).
- */
-export async function loadLocalResources() {
-    const out = { ...EMPTY };
-    const [gFiles, fFiles, eFiles, sFiles] = await Promise.all([
-        readCategoryDir('groups'),
-        readCategoryDir('functions'),
-        readCategoryDir('exportments'),
-        readCategoryDir('sciences'),
-    ]);
-    for (const f of gFiles) {
-        const v = await readGroupFile(f);
-        if (v)
-            out.groups.push(v);
-    }
-    for (const f of fFiles) {
-        const v = await readFunctionFile(f);
-        if (v)
-            out.functions.push(v);
-    }
-    for (const f of eFiles) {
-        const v = await readExportmentFile(f);
-        if (v)
-            out.exportments.push(v);
-    }
-    for (const f of sFiles) {
-        const v = await readScienceFile(f);
-        if (v)
-            out.sciences.push(v);
-    }
-    return out;
-}
-/**
- * 把 manifest 里的 4 类资源落盘到 peerFs 对应目录.
- * 静默容错: 单条失败不影响其他.
- */
-export async function writeRemoteResources(publicKey, m) {
-    let groups = 0, functions = 0, exportments = 0, sciences = 0;
-    if (Array.isArray(m.groups)) {
-        for (const g of m.groups) {
-            try {
-                await peerFs.writeGroup(publicKey, g);
-                groups++;
-            }
-            catch { }
-        }
-    }
-    if (Array.isArray(m.functions)) {
-        for (const f of m.functions) {
-            try {
-                await peerFs.writeFunction(publicKey, f);
-                functions++;
-            }
-            catch { }
-        }
-    }
-    if (Array.isArray(m.exportments)) {
-        for (const e of m.exportments) {
-            try {
-                await peerFs.writeExportment(publicKey, e);
-                exportments++;
-            }
-            catch { }
-        }
-    }
-    if (Array.isArray(m.sciences)) {
-        for (const s of m.sciences) {
-            try {
-                await peerFs.writeScience(publicKey, s);
-                sciences++;
-            }
-            catch { }
-        }
-    }
-    return { groups, functions, exportments, sciences };
-}