@bolloon/bolloon-agent 0.1.35 → 0.1.37

package/README.md

@@ -274,7 +274,7 @@ Gate 8: Test & Integration (测试集成) → 完成
 | src/network/ | truth-source-hierarchy, protocol-consumers |
 | src/constraints/ | truth-source-hierarchy, fixed-three-layers |
 | docs/ | truth-source-hierarchy, two-language |
-| CLAUDE.md | truth-source-hierarchy, bridge-constitution |
+| Bolloon.md | truth-source-hierarchy, bridge-constitution |
 
 #### 4.2.5 Session Archive (操作历史归档)
 

package/dist/agents/p2p-chat-tools.js

@@ -1,7 +1,7 @@
 /**
  * p2p-chat-tools — 异步 chat 通道 + 持久化 inbox + 判断力外包 (draft)
  *
- * 解决痛点: 两个节点的智能体代替各自人类主人做异步判断
+ * 解决痛点: 两个节点的智能体代替各自人类用户做异步判断
  *
  * 流程:
  *   1. A 节点 (人类在线) 通过 sendChat(peerDID, text) 发消息 → iroh 'agent_chat'
@@ -9,7 +9,7 @@
  *        - onMessage('agent_chat') → 落 ~/.bolloon/inbox/<peerDID>.jsonl
  *        - 状态 = 'received' (未处理)
  *   3. B 节点 wake-up (processPendingInbox) → 扫描 status='received' 的消息
- *        - 调 LLM 生成 draft (注入主人历史判断 + ValueProfile)
+ *        - 调 LLM 生成 draft (注入用户历史判断 + ValueProfile)
  *        - 写 status='drafted', draft 落盘
  *        - 通过 'agent_chat' 消息类型回送 draft (前缀 [DRAFT] 表明是代回)
  *   4. A 节点收到 draft → 写到 A 的 outbox (inbox 中 from=B 的那条)
@@ -203,7 +203,7 @@ async function buildValueHint(text) {
             .slice(-10)
             .flatMap((j) => j.reasons || [])
             .slice(0, 20);
-        return `\n[主人历史判断 (style 参考, 不可外泄)]\n关注维度: ${profileHint}\n关键理由示例: ${reasons.join(' | ').slice(0, 400) || '(无)'}\n`;
+        return `\n[用户历史判断 (style 参考, 不可外泄)]\n关注维度: ${profileHint}\n关键理由示例: ${reasons.join(' | ').slice(0, 400) || '(无)'}\n`;
     }
     catch (e) {
         return '';
@@ -217,7 +217,7 @@ export async function generateDraft(messageId, peerDID, transport = defaultIrohT
     if (entry.status !== 'received')
         return entry;
     const valueHint = await buildValueHint(entry.text);
-    const promptForDraft = `你是主人的代理. 对方发来这条消息: "${entry.text.slice(0, 1500)}"\n${valueHint}\n请基于主人的历史判断, 用 1-2 句话代主人拟一个回复草案. 草案要保留主人的语气和立场, 开头标注 [DRAFT]. 直接给草案文本, 不要解释.`;
+    const promptForDraft = `你是用户的代理. 对方发来这条消息: "${entry.text.slice(0, 1500)}"\n${valueHint}\n请基于用户的历史判断, 用 1-2 句话代用户拟一个回复草案. 草案要保留用户的语气和立场, 开头标注 [DRAFT]. 直接给草案文本, 不要解释.`;
     let draftText = '';
     let confidence = 0.5;
     try {
@@ -232,7 +232,7 @@ export async function generateDraft(messageId, peerDID, transport = defaultIrohT
             body: JSON.stringify({
                 model: openaiModel,
                 messages: [
-                    { role: 'system', content: '你是主人的代理. 你的输出会被主人审阅后才发出. 请谨慎.' },
+                    { role: 'system', content: '你是用户的代理. 你的输出会被用户审阅后才发出. 请谨慎.' },
                     { role: 'user', content: promptForDraft },
                 ],
                 temperature: 0.4,
@@ -253,7 +253,7 @@ export async function generateDraft(messageId, peerDID, transport = defaultIrohT
         console.warn(`[DraftEngine] LLM call failed: ${e.message}`);
     }
     if (!draftText) {
-        draftText = `[DRAFT] 已收到. (本地 draft 引擎未配置 LLM, 主人上线后请手写回复)`;
+        draftText = `[DRAFT] 已收到. (本地 draft 引擎未配置 LLM, 用户上线后请手写回复)`;
         confidence = 0.1;
     }
     const updated = await updateInboxEntry(peerDID, messageId, {

package/dist/agents/permission-mode.js

@@ -0,0 +1,115 @@
+/**
+ * Permission Mode — 3 种模式枚举 + 解析
+ *
+ * 设计: 严格对齐 Claude Code 论文 3 种 mode (default / acceptEdits / bypassPermissions)
+ * 论文第 7 种 (plan/dontAsk/bubble) bolloon 暂不引入, 减少 API surface.
+ *
+ * 关键设计: shell-guard **不受** mode 影响
+ *   - 路径黑名单 (.bolloon/, pi-sdk.ts, shell-guard.ts, .env, .git/ 等) 永远生效
+ *   - 命令 allowlist 默认: git/node/npm/npx/tsx/tsc/vitest/cat/head/tail/wc/ls/echo/pwd/date/mkdir/touch 永远生效
+ *   - 即使用户设 bypassPermissions, shell 类工具仍走 shell-guard
+ *
+ * 失败静默: 任何异常 → 返回 'default' (向后兼容)
+ */
+export const ALL_PERMISSION_MODES = [
+    'default',
+    'acceptEdits',
+    'bypassPermissions',
+];
+/**
+ * 解析当前 permission mode.
+ * 优先级 (由高到低):
+ *   1. opts.permissionMode          (BootstrapOptions 显式传入)
+ *   2. runtime override             (~/.bolloon/sessions/permission-mode.json, UI 设置)
+ *   3. env BOLLOON_PERM_MODE        (环境变量)
+ *   4. 'default'                    (兜底)
+ *
+ * 非法值 → fallback 'default', console.warn
+ * 失败静默: 任何异常 → 'default' (不阻塞主对话)
+ */
+export function resolvePermissionMode(opts) {
+    try {
+        if (opts?.permissionMode && ALL_PERMISSION_MODES.includes(opts.permissionMode)) {
+            return opts.permissionMode;
+        }
+        // runtime override (UI 设置, 存 ~/.bolloon/sessions/permission-mode.json)
+        const override = readRuntimeOverride();
+        if (override) {
+            return override;
+        }
+        const env = process.env.BOLLOON_PERM_MODE;
+        if (env === 'default' || env === 'acceptEdits' || env === 'bypassPermissions') {
+            return env;
+        }
+        if (env && env.length > 0) {
+            console.warn(`[permission-mode] unknown BOLLOON_PERM_MODE="${env}", fallback to "default"`);
+        }
+        return 'default';
+    }
+    catch (err) {
+        console.warn('[permission-mode] resolvePermissionMode failed (silent, using default):', err);
+        return 'default';
+    }
+}
+/**
+ * 读 runtime override 文件 (UI 设的 mode).
+ * 失败静默: 任何异常 → null (回到 env/default)
+ */
+function readRuntimeOverride() {
+    try {
+        const fs = require('fs');
+        const os = require('os');
+        const path = require('path');
+        const file = path.join(process.env.HOME || os.homedir() || '/tmp', '.bolloon', 'sessions', 'permission-mode.json');
+        if (!fs.existsSync(file))
+            return null;
+        const raw = fs.readFileSync(file, 'utf-8');
+        const obj = JSON.parse(raw);
+        if (obj && typeof obj.mode === 'string' && ALL_PERMISSION_MODES.includes(obj.mode)) {
+            return obj.mode;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 工具名分类: 是不是"编辑"类 (受 acceptEdits 模式影响)
+ * 简单按前缀, 不做完整注册表
+ */
+export function isEditTool(toolName) {
+    const lc = toolName.toLowerCase();
+    return lc.startsWith('edit_') || lc.startsWith('write_') || lc === 'str_replace' || lc === 'create_file' || lc === 'present_files';
+}
+/**
+ * 工具名分类: 是不是"shell"类 (永远走 shell-guard, 不受 mode 影响)
+ */
+export function isShellTool(toolName) {
+    const lc = toolName.toLowerCase();
+    return lc === 'shell' || lc === 'shell_exec' || lc === 'bash';
+}
+/**
+ * 判断当前 mode + tool 的最终是否需要走 blacklist
+ *
+ * 逻辑表:
+ *   - shell 工具: 永远走 blacklist (shell-guard 接管)
+ *   - bypassPermissions 模式: 非 shell 全部放行
+ *   - acceptEdits 模式: edit_* / write_* 类跳过 blacklist
+ *   - default 模式: 全部走 blacklist
+ */
+export function shouldRunBlacklist(toolName, mode) {
+    if (isShellTool(toolName))
+        return true; // shell-guard 永远跑
+    if (mode === 'bypassPermissions')
+        return false;
+    if (mode === 'acceptEdits' && isEditTool(toolName))
+        return false;
+    return true; // default
+}
+// ============================================================
+// 测试钩子
+// ============================================================
+export function _resetPermissionModeForTest() {
+    // 解析只读 env, 无内部状态, 保留 API 一致
+}