@bolloon/bolloon-agent 0.3.51 → 0.4.0

package/dist/web/client-hearth.js

@@ -20,16 +20,16 @@ export async function renderMyHearth(root) {
     root.innerHTML = '<h1>My Hearth</h1><p>Loading…</p>';
     try {
         const data = await fetchHearth('/api/hearth');
-        root.innerHTML = `
-      <h1>My Hearth</h1>
-      <dl>
-        <dt>Service</dt><dd>${data.service} v${data.version}</dd>
-        <dt>Root</dt><dd><code>${data.rootPath}</code></dd>
-        <dt>Description count</dt><dd>${data.descriptionCount}</dd>
-        <dt>Visibility channels</dt><dd>${data.visibilityChannels}</dd>
-        <dt>Allowlist count</dt><dd>${data.allowlistCount}</dd>
-        <dt>Defense mode</dt><dd>${data.defenseMode ? 'ON (write APIs disabled)' : 'OFF (反攻期)'}</dd>
-      </dl>
+        root.innerHTML = `
+      <h1>My Hearth</h1>
+      <dl>
+        <dt>Service</dt><dd>${data.service} v${data.version}</dd>
+        <dt>Root</dt><dd><code>${data.rootPath}</code></dd>
+        <dt>Description count</dt><dd>${data.descriptionCount}</dd>
+        <dt>Visibility channels</dt><dd>${data.visibilityChannels}</dd>
+        <dt>Allowlist count</dt><dd>${data.allowlistCount}</dd>
+        <dt>Defense mode</dt><dd>${data.defenseMode ? 'ON (write APIs disabled)' : 'OFF (反攻期)'}</dd>
+      </dl>
       <p>视图: <a href="#/hearth/discover">Discover</a> · <a href="#/hearth/visit/__self__">Visit self</a></p>`;
     }
     catch (e) {

package/dist/web/client.js

@@ -1544,6 +1544,57 @@
   var newChannelBtn = document.getElementById("new-channel-btn");
   var newChannelInput = document.getElementById("new-channel-input");
   var channelNameEl = document.getElementById("channel-name");
+  var rokidBridge = null;
+  var rokidBridgeStatus = "unavailable";
+  function getRokidBridge() {
+    if (typeof window === "undefined") return null;
+    return window.Capacitor?.Plugins?.RokidBridge || null;
+  }
+  function publishRokidStatus(status, detail = {}) {
+    rokidBridgeStatus = status;
+    if (typeof window !== "undefined") {
+      window.__bolloonRokidStatus = { status, ...detail };
+      window.dispatchEvent(new CustomEvent("bolloon:rokid-status", { detail: window.__bolloonRokidStatus }));
+    }
+  }
+  async function initRokidBridge() {
+    const bridge = getRokidBridge();
+    if (!bridge) {
+      publishRokidStatus("unavailable");
+      return;
+    }
+    rokidBridge = bridge;
+    try {
+      await bridge.addListener?.("rokidEvent", (event) => {
+        if (event?.type === "connected") publishRokidStatus("connected", { device: event.device });
+        else if (event?.type === "disconnected") publishRokidStatus("disconnected", { reason: event.reason });
+        else if (event?.type === "error") publishRokidStatus("error", { error: event.error || event.message });
+        window.dispatchEvent(new CustomEvent("bolloon:rokid-event", { detail: event }));
+      });
+      const result = await bridge.connect?.();
+      publishRokidStatus("connected", { deviceId: result?.deviceId, mode: result?.mode });
+    } catch (error) {
+      publishRokidStatus("error", { error: error?.message || String(error) });
+      console.warn("[Rokid] bridge unavailable:", error);
+    }
+  }
+  function sendRokidText(text, metadata = {}) {
+    if (!rokidBridge || !text) return;
+    Promise.resolve(rokidBridge.sendMessage?.({
+      text,
+      channelId: currentChannelId || void 0,
+      metadata
+    })).catch((error) => {
+      publishRokidStatus("error", { error: error?.message || String(error) });
+    });
+  }
+  if (typeof window !== "undefined") {
+    window.BolloonRokid = {
+      connect: initRokidBridge,
+      sendMessage: sendRokidText,
+      getStatus: () => ({ status: rokidBridgeStatus })
+    };
+  }
   var eventSources = /* @__PURE__ */ new Map();
   var currentChannelId = null;
   var activeChannelId = null;
@@ -2823,6 +2874,7 @@ ${data.error || "channel not found"}`, "error");
             MR_replaceStreamingText?.(data.content || "");
             MR_finalizeTimelineAsMessage(getRendererCtx());
           }
+          sendRokidText(data.content || "", { source: "ai" });
         } else if (data.type === "reply-preview") {
           const previewContent = data.content || "";
           const oldPreviews = container.querySelectorAll(".message-ai.preview");
@@ -2896,6 +2948,7 @@ ${data.error || "channel not found"}`, "error");
     setSendMode("abort");
     const container = messagesContainers.get(currentChannelId) || messagesEl;
     addMessage2(text, "user", true, container);
+    sendRokidText(text, { source: "user" });
     if (container) container.scrollTop = container.scrollHeight;
     if (currentPreviewBubble) {
       currentPreviewBubble.remove();
@@ -3983,6 +4036,7 @@ ${data.error || "channel not found"}`, "error");
     }
   }
   async function init() {
+    void initRokidBridge();
     const themeData = await loadTheme();
     currentAgentId = themeData.agentId || `agent_${generateId().substring(0, 8)}`;
     if (!themeData.agentId) {

package/dist/web/components/wallet-viem.mjs

@@ -1,118 +1,118 @@
-// Real-wallet helpers (viem-backed), exposed as window.WalletViem for client.js.
-// 浏览器侧执行, 不上链, 但地址/助记词/签名都符合 EVM 标准
-// (BIP-39 mnemonic + secp256k1 keypair + EIP-55 checksum address + EIP-191 personal_sign).
-
-import {
-  generateMnemonic,
-  mnemonicToAccount,
-  privateKeyToAccount,
-  english,
-} from 'https://esm.sh/viem@2.52.0/accounts';
-
-/**
- * 生成一个全新的 EVM 钱包: 12 词助记词 + 派生账户 (BIP-44, m/44'/60'/0'/0/0)
- * 返回: { mnemonic, address, privateKey }
- *  - mnemonic: 12 词英文助记词
- *  - address:  EIP-55 checksum 后的 0x 开头地址
- *  - privateKey: 0x 开头的 32 字节私钥
- */
-export function generateEVMWallet() {
-  const mnemonic = generateMnemonic(english, 128); // 128 bits = 12 words
-  const account = mnemonicToAccount(mnemonic, { accountIndex: 0 });
-  return {
-    mnemonic,
-    address: account.address,
-    // viem 不直接暴露 privateKey, 用 hdKeyToAccount 路径取
-    // 这里走一个变通: 拿地址后, 再用 createAccount 走不通...
-    // 实际: account.source 包含 HDKey, 我们让它返回 privateKey 字段
-    // 简化: 直接调一个 helper
-  };
-}
-
-/**
- * 通过私钥恢复账户: 用于"导入已有钱包"流程
- */
-export function importEVMWallet(privateKeyHex) {
-  const normalized = privateKeyHex.startsWith('0x') ? privateKeyHex : `0x${privateKeyHex}`;
-  const account = privateKeyToAccount(normalized);
-  return {
-    address: account.address,
-    privateKey: normalized,
-  };
-}
-
-/**
- * 通过助记词恢复账户
- */
-export function importEVMMnemonic(mnemonic) {
-  const account = mnemonicToAccount(mnemonic.trim(), { accountIndex: 0 });
-  return {
-    mnemonic: mnemonic.trim(),
-    address: account.address,
-    privateKey: extractPrivateKey(account),
-  };
-}
-
-/**
- * 真实生成路径: 先生成助记词, 再恢复出账户, 顺带取出 privateKey
- */
-export function generateRealWallet() {
-  const mnemonic = generateMnemonic(english, 128);
-  const account = mnemonicToAccount(mnemonic, { accountIndex: 0 });
-  return {
-    mnemonic,
-    address: account.address,
-    privateKey: extractPrivateKey(account),
-  };
-}
-
-/**
- * 对 channel DID 进行 EIP-191 personal_sign 签名, 证明钱包所有权
- * 返回 { address, signature, message, did }
- *   - message:  实际签名的原文, 服务端需用 recoverMessage 校验
- *   - signature: 0x 开头 65 字节签名 (r||s||v)
- */
-export async function signDIDChallenge(privateKeyHex, did, channelId) {
-  const normalized = privateKeyHex.startsWith('0x') ? privateKeyHex : `0x${privateKeyHex}`;
-  const account = privateKeyToAccount(normalized);
-  const message = buildChallengeMessage(did, channelId);
-  const signature = await account.signMessage({ message });
-  return {
-    address: account.address,
-    signature,
-    message,
-    did,
-  };
-}
-
-export function buildChallengeMessage(did, channelId) {
-  return [
-    'Bolloon Agent Wallet Binding',
-    `Channel ID: ${channelId}`,
-    `Agent DID: ${did}`,
-    `Issued At: ${new Date().toISOString()}`,
-  ].join('\n');
-}
-
-// 从 viem HDKey 账户里取出 privateKey (Uint8Array) 转成 0x 开头 hex
-function extractPrivateKey(account) {
-  const hdKey = account.getHdKey ? account.getHdKey() : null;
-  if (!hdKey || !hdKey.privateKey) {
-    throw new Error('无法从助记词派生私钥');
-  }
-  return '0x' + Array.from(hdKey.privateKey, (b) => b.toString(16).padStart(2, '0')).join('');
-}
-
-const api = {
-  generateRealWallet,
-  importEVMWallet,
-  importEVMMnemonic,
-  signDIDChallenge,
-  buildChallengeMessage,
-};
-
-if (typeof window !== 'undefined') {
-  window.WalletViem = api;
-}
-
-export default api;
+// Real-wallet helpers (viem-backed), exposed as window.WalletViem for client.js.
+// 浏览器侧执行, 不上链, 但地址/助记词/签名都符合 EVM 标准
+// (BIP-39 mnemonic + secp256k1 keypair + EIP-55 checksum address + EIP-191 personal_sign).
+
+import {
+  generateMnemonic,
+  mnemonicToAccount,
+  privateKeyToAccount,
+  english,
+} from 'https://esm.sh/viem@2.52.0/accounts';
+
+/**
+ * 生成一个全新的 EVM 钱包: 12 词助记词 + 派生账户 (BIP-44, m/44'/60'/0'/0/0)
+ * 返回: { mnemonic, address, privateKey }
+ *  - mnemonic: 12 词英文助记词
+ *  - address:  EIP-55 checksum 后的 0x 开头地址
+ *  - privateKey: 0x 开头的 32 字节私钥
+ */
+export function generateEVMWallet() {
+  const mnemonic = generateMnemonic(english, 128); // 128 bits = 12 words
+  const account = mnemonicToAccount(mnemonic, { accountIndex: 0 });
+  return {
+    mnemonic,
+    address: account.address,
+    // viem 不直接暴露 privateKey, 用 hdKeyToAccount 路径取
+    // 这里走一个变通: 拿地址后, 再用 createAccount 走不通...
+    // 实际: account.source 包含 HDKey, 我们让它返回 privateKey 字段
+    // 简化: 直接调一个 helper
+  };
+}
+
+/**
+ * 通过私钥恢复账户: 用于"导入已有钱包"流程
+ */
+export function importEVMWallet(privateKeyHex) {
+  const normalized = privateKeyHex.startsWith('0x') ? privateKeyHex : `0x${privateKeyHex}`;
+  const account = privateKeyToAccount(normalized);
+  return {
+    address: account.address,
+    privateKey: normalized,
+  };
+}
+
+/**
+ * 通过助记词恢复账户
+ */
+export function importEVMMnemonic(mnemonic) {
+  const account = mnemonicToAccount(mnemonic.trim(), { accountIndex: 0 });
+  return {
+    mnemonic: mnemonic.trim(),
+    address: account.address,
+    privateKey: extractPrivateKey(account),
+  };
+}
+
+/**
+ * 真实生成路径: 先生成助记词, 再恢复出账户, 顺带取出 privateKey
+ */
+export function generateRealWallet() {
+  const mnemonic = generateMnemonic(english, 128);
+  const account = mnemonicToAccount(mnemonic, { accountIndex: 0 });
+  return {
+    mnemonic,
+    address: account.address,
+    privateKey: extractPrivateKey(account),
+  };
+}
+
+/**
+ * 对 channel DID 进行 EIP-191 personal_sign 签名, 证明钱包所有权
+ * 返回 { address, signature, message, did }
+ *   - message:  实际签名的原文, 服务端需用 recoverMessage 校验
+ *   - signature: 0x 开头 65 字节签名 (r||s||v)
+ */
+export async function signDIDChallenge(privateKeyHex, did, channelId) {
+  const normalized = privateKeyHex.startsWith('0x') ? privateKeyHex : `0x${privateKeyHex}`;
+  const account = privateKeyToAccount(normalized);
+  const message = buildChallengeMessage(did, channelId);
+  const signature = await account.signMessage({ message });
+  return {
+    address: account.address,
+    signature,
+    message,
+    did,
+  };
+}
+
+export function buildChallengeMessage(did, channelId) {
+  return [
+    'Bolloon Agent Wallet Binding',
+    `Channel ID: ${channelId}`,
+    `Agent DID: ${did}`,
+    `Issued At: ${new Date().toISOString()}`,
+  ].join('\n');
+}
+
+// 从 viem HDKey 账户里取出 privateKey (Uint8Array) 转成 0x 开头 hex
+function extractPrivateKey(account) {
+  const hdKey = account.getHdKey ? account.getHdKey() : null;
+  if (!hdKey || !hdKey.privateKey) {
+    throw new Error('无法从助记词派生私钥');
+  }
+  return '0x' + Array.from(hdKey.privateKey, (b) => b.toString(16).padStart(2, '0')).join('');
+}
+
+const api = {
+  generateRealWallet,
+  importEVMWallet,
+  importEVMMnemonic,
+  signDIDChallenge,
+  buildChallengeMessage,
+};
+
+if (typeof window !== 'undefined') {
+  window.WalletViem = api;
+}
+
+export default api;

package/dist/web/delivery-ledger.js

@@ -0,0 +1,103 @@
+/**
+ * delivery-ledger.ts — SSE 客户端投递账本 (借鉴 Hermes gateway/delivery_ledger.py)
+ *
+ * Hermes outbox 模式 (WAL + 三态 checkpoint + 崩溃语义):
+ *   pending    — 发送从未开始: 直接重发, 无重复风险
+ *   attempting — 发送中途崩溃: 平台可能已收到 → 带可见标记重发 (诚实的 at-least-once, 不静默重复)
+ *   delivered  — 仅 SendResult.success
+ *   failed     — 明确拒绝一次; 重启是天然重试边界
+ *
+ * Bolloon 版 (轻量, 内存): 追踪每个 SSE 客户端的投递状态 + 失败统计 + 同类错误节流
+ * (channel_directory 模式: 同一 (类别, 错误) 窗口内只 warn 一次, 防日志刷屏).
+ */
+/** 同类错误节流窗口 (ms): 窗口内同 (类别, 错误前缀) 只 warn 一次 */
+export const WARN_THROTTLE_WINDOW_MS = 5 * 60 * 1000;
+export class DeliveryLedger {
+    records = new Map();
+    lastWarn = new Map();
+    /** 注册客户端 (obligation) — 初始 pending (Hermes record_obligation) */
+    register(clientId) {
+        const existing = this.records.get(clientId);
+        if (existing)
+            return existing;
+        const rec = { clientId, state: 'pending', consecutiveFailures: 0, createdAt: Date.now() };
+        this.records.set(clientId, rec);
+        return rec;
+    }
+    /** 发送前标记 attempting (Hermes mark_attempting) */
+    markAttempting(clientId) {
+        const rec = this.register(clientId);
+        rec.state = 'attempting';
+    }
+    /** 发送成功 (Hermes mark_delivered) */
+    markDelivered(clientId) {
+        const rec = this.register(clientId);
+        rec.state = 'delivered';
+        rec.consecutiveFailures = 0;
+        rec.lastDeliveredAt = Date.now();
+    }
+    /**
+     * 发送失败 (Hermes mark_failed). 同类错误节流: 窗口内同 (state, errorPrefix) 返回 false 表示
+     * 该 warn 已被节流 — 调用方只对 true 输出日志.
+     * @returns 是否应输出警告 (true = 新教训, 值得 warn)
+     */
+    markFailed(clientId, error) {
+        const rec = this.register(clientId);
+        rec.state = 'failed';
+        rec.consecutiveFailures++;
+        rec.lastFailedAt = Date.now();
+        rec.lastError = String(error?.message || error || '').slice(0, 120);
+        return this.shouldWarn('delivery-fail', rec.lastError);
+    }
+    /** 同类错误节流 (Hermes channel_directory warn-once-per-window) */
+    shouldWarn(category, detail) {
+        const key = `${category}:${detail.slice(0, 60)}`;
+        const now = Date.now();
+        const last = this.lastWarn.get(key) ?? 0;
+        if (now - last < WARN_THROTTLE_WINDOW_MS)
+            return false;
+        this.lastWarn.set(key, now);
+        return true;
+    }
+    /** 客户端判定死亡 (最后一次活动超时) — 标记 dead, 可回收 (Hermes sweep_recoverable 语义) */
+    sweepDead(idleTimeoutMs) {
+        const now = Date.now();
+        const dead = [];
+        for (const [id, rec] of this.records) {
+            if (rec.state === 'dead')
+                continue;
+            const lastActivity = Math.max(rec.lastDeliveredAt ?? 0, rec.lastFailedAt ?? 0, rec.createdAt);
+            if (now - lastActivity > idleTimeoutMs) {
+                rec.state = 'dead';
+                rec.deadAt = now;
+                dead.push(id);
+            }
+        }
+        return dead;
+    }
+    /** 移除记录 (客户端断开) */
+    remove(clientId) {
+        this.records.delete(clientId);
+    }
+    stats() {
+        let delivered = 0, failed = 0, dead = 0, attempting = 0;
+        for (const r of this.records.values()) {
+            if (r.state === 'delivered')
+                delivered++;
+            else if (r.state === 'failed')
+                failed++;
+            else if (r.state === 'dead')
+                dead++;
+            else if (r.state === 'attempting')
+                attempting++;
+        }
+        return { total: this.records.size, delivered, failed, dead, attempting };
+    }
+    get(clientId) {
+        return this.records.get(clientId);
+    }
+    clear() {
+        this.records.clear();
+        this.lastWarn.clear();
+    }
+}

package/dist/web/i18n.js

@@ -0,0 +1,104 @@
+/**
+ * i18n.ts — 用户可见静态文案目录 (借鉴 Hermes agent/i18n.py + locales/*.yaml)
+ *
+ * Hermes 设计要点 (照搬):
+ *   1. 范围纪律: 只翻「用户可见静态消息」(审批提示/系统回复); agent 生成的输出、
+ *      日志、报错、工具输出一律不翻译 (agent/i18n.py scope rationale)。
+ *   2. 嵌套目录扁平化成 dotted keys (approval.choose_long)。
+ *   3. 值可含 {placeholder} 占位符 (str.format 语义)。
+ *   4. 语言解析: env (BOLLOON_LANGUAGE) > config > default (zh)。
+ *   5. 目录每语言缓存; 键缺失 → en 回退 (en 是 source of truth)。
+ *   6. parity 测试: 每个 locale 键集合 == en, 占位符集合 == en (tests 断言)。
+ *
+ * 载体用 TS 模块 (locales/*.ts) 而非 YAML 文件: 无运行时文件依赖/构建拷贝问题,
+ * 机制与 YAML 目录完全一致 (嵌套对象 + 扁平化)。
+ */
+import * as en from '../locales/en.js';
+import * as zh from '../locales/zh.js';
+export const DEFAULT_LANGUAGE = 'zh';
+export const SUPPORTED_LANGUAGES = ['en', 'zh'];
+/** 语言别名 + 区域标签归一化 (Hermes _normalize_lang) */
+export function normalizeLang(value) {
+    if (typeof value !== 'string')
+        return DEFAULT_LANGUAGE;
+    const key = value.trim().toLowerCase();
+    if (!key)
+        return DEFAULT_LANGUAGE;
+    if (SUPPORTED_LANGUAGES.includes(key))
+        return key;
+    const base = key.split('-', 1)[0];
+    if (SUPPORTED_LANGUAGES.includes(base))
+        return base;
+    return DEFAULT_LANGUAGE;
+}
+/** 嵌套目录扁平化成 dotted keys (Hermes _flatten_into) */
+export function flattenCatalog(node, prefix = '') {
+    const out = {};
+    if (node && typeof node === 'object' && !Array.isArray(node)) {
+        for (const [key, value] of Object.entries(node)) {
+            const childKey = prefix ? `${prefix}.${key}` : key;
+            Object.assign(out, flattenCatalog(value, childKey));
+        }
+    }
+    else if (typeof node === 'string') {
+        out[prefix] = node;
+    }
+    return out;
+}
+const catalogs = {
+    en: flattenCatalog(en.catalog),
+    zh: flattenCatalog(zh.catalog),
+};
+/** 语言缓存 (Hermes _catalog_cache) — 进程内一次加载 */
+const resolvedLanguage = { lang: DEFAULT_LANGUAGE };
+/** 解析活动语言: env BOLLOON_LANGUAGE > 默认 */
+export function getLanguage() {
+    const envLang = process.env.BOLLOON_LANGUAGE;
+    if (envLang) {
+        resolvedLanguage.lang = normalizeLang(envLang);
+    }
+    return resolvedLanguage.lang;
+}
+/**
+ * 翻译 dotted key (Hermes t()).
+ * 键缺失 → en 回退; en 也缺失 → 返回 key 本身 (不抛).
+ */
+export function t(key, lang, vars) {
+    const target = lang ?? getLanguage();
+    const catalog = catalogs[target] ?? catalogs.en;
+    let template = catalog[key];
+    if (template === undefined) {
+        template = catalogs.en[key] ?? key; // en 回退
+    }
+    if (vars && Object.keys(vars).length > 0) {
+        for (const [k, v] of Object.entries(vars)) {
+            template = template.replace(new RegExp(`\\{${k}\\}`, 'g'), String(v));
+        }
+    }
+    return template;
+}
+/** parity 检查 (Hermes test_i18n.py): 键集合 + 占位符集合 vs en */
+export function catalogParity() {
+    const enKeys = Object.keys(catalogs.en);
+    const placeholderRe = /\{([a-zA-Z0-9_]+)\}/g;
+    const enPlaceholders = new Map();
+    for (const [k, v] of Object.entries(catalogs.en)) {
+        enPlaceholders.set(k, new Set([...v.matchAll(placeholderRe)].map((m) => m[1])));
+    }
+    return SUPPORTED_LANGUAGES.filter((l) => l !== 'en').map((lang) => {
+        const langKeys = Object.keys(catalogs[lang]);
+        const missingKeys = enKeys.filter((k) => !catalogs[lang][k]);
+        const extraKeys = langKeys.filter((k) => !catalogs.en[k]);
+        const placeholderMismatch = [];
+        for (const [k, enPh] of enPlaceholders) {
+            const langV = catalogs[lang][k];
+            if (langV === undefined)
+                continue;
+            const langPh = new Set([...langV.matchAll(placeholderRe)].map((m) => m[1]));
+            const diff = new Set([...enPh].filter((p) => !langPh.has(p)));
+            if (diff.size > 0)
+                placeholderMismatch.push(`${k}: 缺占位符 ${[...diff].join(',')}`);
+        }
+        return { lang, missingKeys, extraKeys, placeholderMismatch };
+    });
+}