@bolloon/bolloon-agent 0.3.51 → 0.4.0

package/dist/web/task-breaker.js

@@ -0,0 +1,18 @@
+/**
+ * task-breaker.ts — 任务连续失败熔断器 (借鉴 Hermes kanban `consecutive_failures`:
+ *   失败递增, 成功清零, 超过 failure_limit 熔断 — 防无限重试循环)
+ *
+ * 纯函数, 可单测。
+ */
+/** 默认熔断阈值: 连续 3 次失败 (BOLLOON_FAILURE_LIMIT 可调) */
+export const DEFAULT_FAILURE_LIMIT = 3;
+/** 记录一次失败: 计数 +1, 判断是否熔断. 优先级: per-task failureLimit → env → DEFAULT. */
+export function recordTaskFailure(task, envLimit) {
+    const limit = task.failureLimit ?? (envLimit && envLimit > 0 ? envLimit : DEFAULT_FAILURE_LIMIT);
+    const next = (task.consecutiveFailures ?? 0) + 1;
+    return { consecutiveFailures: next, tripped: next >= limit };
+}
+/** 成功完成: 计数清零 */
+export function resetTaskFailures() {
+    return { consecutiveFailures: 0 };
+}

package/dist/web/task-cancel.js

@@ -0,0 +1,35 @@
+/**
+ * task-cancel.ts — 任务取消两段式状态机 (借鉴 Hermes `SubagentState`:
+ *   CANCEL_REQUESTED → CANCELLED, 区分"请求已受理"与"实际已停止")
+ *
+ * 纯函数, 无 express/io 依赖 — 路由和 executor 共用, 可单测。
+ */
+/**
+ * 应用一次取消请求 (第一段)。
+ * - pending: 从未开始 → 直接 cancelled (请求即完成, 不会卡在中间态)
+ * - running: → cancel-requested (请求受理, 等 executor 观测后落 cancelled)
+ * - cancel-requested: 幂等返回 already-requested
+ * - 其余终态: terminal, 不可取消
+ */
+export function applyCancelRequest(status) {
+    switch (status) {
+        case 'pending':
+            return { status: 'cancelled', phase: 'direct' };
+        case 'running':
+            return { status: 'cancel-requested', phase: 'requested' };
+        case 'cancel-requested':
+            return { status: 'cancel-requested', phase: 'already-requested' };
+        default:
+            return { status: 'cancelled', phase: 'terminal' };
+    }
+}
+/**
+ * executor 完成/异常时调用 (第二段): 若任务处于 cancel-requested, 应落 cancelled 而非正常终态。
+ */
+export function shouldFinalizeAsCancelled(status) {
+    return status === 'cancel-requested';
+}
+/** 取消请求是否已受理 (running 任务的第一段) */
+export function isCancelPending(status) {
+    return status === 'cancel-requested';
+}

package/dist/web/task-deps.js

@@ -0,0 +1,36 @@
+/**
+ * task-deps.ts — 任务父依赖校验 (借鉴 Hermes kanban 认领点父依赖不变式:
+ *   claim 时强制检查所有父任务 done/archived, 否则 demote 回 todo)
+ *
+ * 纯函数。bolloon 终态语义: completed/cancelled 视为父已结束 (依赖解除);
+ * failed 视为父未成功 (子任务不满足前提, 阻塞等人工决策)。
+ */
+const PARENT_DONE_STATUSES = new Set(['completed', 'cancelled']);
+/** 父依赖是否满足: 无父 / 父全部 completed|cancelled → true; 父 missing/failed/running/pending → false */
+export function parentsSatisfied(task, allTasks) {
+    const parentIds = task?.parentIds;
+    if (!parentIds || parentIds.length === 0)
+        return true;
+    for (const pid of parentIds) {
+        const parent = allTasks.find((t) => t.id === pid);
+        // 父不存在 → 保守阻塞 (依赖悬空, 等人工修复)
+        if (!parent)
+            return false;
+        if (!PARENT_DONE_STATUSES.has(parent.status))
+            return false;
+    }
+    return true;
+}
+/** 列出未满足的父任务 id (诊断用) */
+export function unsatisfiedParents(task, allTasks) {
+    const parentIds = task?.parentIds;
+    if (!parentIds || parentIds.length === 0)
+        return [];
+    const out = [];
+    for (const pid of parentIds) {
+        const parent = allTasks.find((t) => t.id === pid);
+        if (!parent || !PARENT_DONE_STATUSES.has(parent.status))
+            out.push(pid);
+    }
+    return out;
+}

package/dist/web/task-review.js

@@ -0,0 +1,27 @@
+/**
+ * task-review.ts — 任务 review 审批通道状态机 (借鉴 Hermes kanban 9 态:
+ *   request_review 把任务挂进 review 通道, complete_task 接受 review→done)
+ *
+ * 纯函数, 无 express/io 依赖 — 路由共用, 可单测。
+ */
+/** 请求审批: running/pending → review (挂起等人工/审查者放行) */
+export function applyReviewRequest(status) {
+    if (status === 'running' || status === 'pending') {
+        return { status: 'review', phase: 'requested' };
+    }
+    return { status, phase: 'not-reviewable' };
+}
+/** 审批通过: review → completed (放行) */
+export function applyReviewApprove(status) {
+    if (status === 'review') {
+        return { status: 'completed', phase: 'approved' };
+    }
+    return { status, phase: 'not-reviewable' };
+}
+/** 审批驳回: review → pending (退回队列, 可重新认领执行) */
+export function applyReviewReject(status) {
+    if (status === 'review') {
+        return { status: 'pending', phase: 'rejected' };
+    }
+    return { status, phase: 'not-reviewable' };
+}

package/dist/web/task-verify.js

@@ -0,0 +1,60 @@
+/**
+ * task-verify.ts — 任务完成防幻觉校验 (借鉴 Hermes complete_task:
+ *   created_cards 逐 id 验证 → 幽灵卡阻止完成; 散文引用不解析 → suspected_hallucinated_references 事件)
+ *
+ * Bolloon 版 (advisory 不阻塞): 完成时校验 result 里引用的任务 id 和本地文件路径,
+ *   不存在的 → warning 列表 (存 task.warnings + broadcast), 不阻止完成 (单次同步执行无法返工).
+ */
+import * as path from 'path';
+/** 提取 result 里的任务 id 引用 (task_xxx 模式) — 校验是否幽灵引用 */
+export function extractTaskReferences(text) {
+    const re = /\btask_[a-z0-9]+/gi;
+    const out = new Set();
+    for (const m of text.matchAll(re))
+        out.add(m[0].toLowerCase());
+    return [...out];
+}
+/** 提取 result 里的本地文件路径引用 (markdown 链接 + 反引号路径 + path:line), 不含 URL; cap 20 条 */
+export function extractFileReferences(text) {
+    const out = new Set();
+    for (const m of text.matchAll(/\[[^\]]*\]\(([^)\s]+)\)/g)) {
+        const p = m[1];
+        if (!/^[a-z]+:\/\//i.test(p))
+            out.add(p);
+    }
+    for (const m of text.matchAll(/`([^`]+)`/g)) {
+        const p = m[1].trim();
+        if (p.includes('/') || p.includes('\\') || /\.(md|ts|tsx|js|jsx|json|py|txt)$/i.test(p))
+            out.add(p);
+    }
+    return [...out].slice(0, 20);
+}
+/**
+ * 校验任务完成结果: 任务 id 引用必须在队列中存在; 文件路径引用必须存在 (相对 cwd 解析).
+ * 纯 IO 校验, 不修改任务状态 — 返回 warning 列表 (幽灵引用, advisory 不阻塞).
+ */
+export async function verifyTaskResult(result, opts) {
+    const warnings = [];
+    const known = new Set(opts.knownTaskIds);
+    const taskRefs = extractTaskReferences(result);
+    for (const ref of taskRefs) {
+        if (!known.has(ref)) {
+            warnings.push(`result 引用不存在的任务 ${ref} (疑似幻觉引用)`);
+        }
+    }
+    let checkedCount = taskRefs.length;
+    const fileRefs = extractFileReferences(result);
+    const fsMod = opts.fs ?? (await import('fs/promises'));
+    const base = opts.cwd ?? process.cwd();
+    for (const ref of fileRefs) {
+        checkedCount++;
+        const abs = ref.startsWith('/') || /^[a-zA-Z]:[\\/]/.test(ref) ? ref : path.resolve(base, ref);
+        try {
+            await fsMod.access(abs);
+        }
+        catch {
+            warnings.push(`result 引用不存在的文件 ${ref} (疑似幻觉引用)`);
+        }
+    }
+    return { warnings, checkedCount };
+}

package/package.json

@@ -1,193 +1,196 @@
-{
-  "name": "@bolloon/bolloon-agent",
-  "version": "0.3.51",
-  "type": "module",
-  "description": "P2P AI Document Agent - 全局安装后执行 `bolloon` 启动产品",
-  "main": "dist/cli-entry.js",
-  "author": "yuanjie liu",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/logos-42/bolloon.git"
-  },
-  "license": "MIT",
-  "files": [
-    "dist",
-    "bin/bolloon.cjs",
-    "bin/bolloon.js",
-    "bin/bolloon.cmd",
-    "bin/bolloon-cli.cjs",
-    "bin/bolloon-daemon.sh",
-    "scripts/postinstall.js",
-    "scripts/build-cli.js",
-    "scripts/build-web.ts"
-  ],
-  "bin": {
-    "bolloon": "./dist/cli-entry.js"
-  },
-  "scripts": {
-    "build": "npm run build --workspaces --if-present",
-    "build:main": "tsc && node scripts/copy-constraint-runtime.mjs",
-    "build:cli": "node scripts/build-cli.js",
-    "build:web": "npx tsx scripts/build-web.ts",
-    "build:electron": "tsc -p tsconfig.electron.json",
-    "build:all": "npm run build:main && npm run build:web && npm run build:electron && npm run build:cli",
-    "start": "node dist/index.js",
-    "dev": "tsx -r dotenv/config src/index.ts",
-    "dev:web": "npm run build:web && tsx -r dotenv/config src/index.ts --web",
-    "dev:electron": "npm run build:electron && npm run electron:start",
-    "electron:start": "NODE_ENV=development electron dist/electron-build/electron.js",
-    "electron:dev": "concurrently \"npm run dev:web\" \"npm run electron:start\"",
-    "electron:build": "npm run build:electron && electron-builder",
-    "electron:pack": "electron-builder --dir",
-    "app:bundle": "node scripts/build-app-bundle.cjs",
-    "app:bundle:open": "node scripts/build-app-bundle.cjs && open \"release/mac-arm64/Bolloon Agent.app\"",
-    "smoke:esm": "node scripts/smoke-esm.mjs",
-    "prepublishOnly": "npm run build:all && npm run smoke:esm",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:pi-sdk": "tsx src/test/pi-sdk.test.ts",
-    "postinstall": "node scripts/postinstall.js",
-    "verify:ipns": "tsx scripts/verify-ipns-pipeline.ts"
-  },
-  "workspaces": [
-    "src/constraint-runtime"
-  ],
-  "dependencies": {
-    "@bolloon/bolloon-agent": "^0.3.22",
-    "@bolloon/constraint-runtime": "0.1.0",
-    "@capacitor/core": "^8.4.1",
-    "@capacitor/ios": "^8.4.2",
-    "@chainsafe/libp2p-noise": "^17.0.0",
-    "@chainsafe/libp2p-yamux": "^8.0.1",
-    "@diap/sdk": "^0.2.4",
-    "@libp2p/autonat": "^3.0.25",
-    "@libp2p/circuit-relay-v2": "^4.2.9",
-    "@libp2p/dcutr": "^3.0.20",
-    "@libp2p/gossipsub": "^16.1.1",
-    "@libp2p/identify": "^4.1.6",
-    "@libp2p/kad-dht": "^16.2.6",
-    "@libp2p/tcp": "^11.0.20",
-    "@libp2p/upnp-nat": "^4.0.20",
-    "@multiformats/multiaddr": "^13.0.3",
-    "@noble/hashes": "^1.3.0",
-    "@orbitdb/core": "^4.0.0",
-    "@polymarket/client": "^0.2.0",
-    "@rayhanadev/iroh": "^0.1.1",
-    "@x402/aptos": "^2.20.0",
-    "@x402/avm": "^2.20.0",
-    "@x402/axios": "^2.20.0",
-    "@x402/core": "^2.20.0",
-    "@x402/evm": "^2.20.0",
-    "@x402/express": "^2.20.0",
-    "@x402/extensions": "^2.20.0",
-    "@x402/fastify": "^2.20.0",
-    "@x402/fetch": "^2.20.0",
-    "@x402/hedera": "^2.20.0",
-    "@x402/hono": "^2.20.0",
-    "@x402/keeta": "^2.20.0",
-    "@x402/mcp": "^2.20.0",
-    "@x402/next": "^2.20.0",
-    "@x402/paywall": "^2.20.0",
-    "@x402/stellar": "^2.20.0",
-    "@x402/svm": "^2.20.0",
-    "@x402/tvm": "^2.20.0",
-    "b4a": "^1.8.1",
-    "dotenv": "^17.4.2",
-    "esbuild": "^0.24.0",
-    "express": "^5.2.1",
-    "helia": "^7.1.3",
-    "ink": "^7.1.1",
-    "ink-text-input": "^6.0.0",
-    "libp2p": "^3.3.0",
-    "mammoth": "^1.6.0",
-    "pdf-parse": "^1.1.4",
-    "platform": "^1.3.6",
-    "react": "^19.2.8",
-    "react-dom": "^19.2.8",
-    "viem": "^2.52.0"
-  },
-  "devDependencies": {
-    "@capacitor/cli": "^8.4.1",
-    "@playwright/test": "^1.60.0",
-    "@types/express": "^5.0.6",
-    "@types/node": "^25.9.1",
-    "@types/pdf-parse": "^1.1.5",
-    "@types/react": "^19.2.18",
-    "@types/react-dom": "^19.2.4",
-    "concurrently": "^9.2.1",
-    "electron": "^42.3.0",
-    "electron-builder": "^26.15.5",
-    "lefthook": "^2.1.9",
-    "playwright": "^1.60.0",
-    "tsx": "^4.0.0",
-    "typescript": "^5.0.0",
-    "vitest": "^4.1.6"
-  },
-  "build": {
-    "appId": "com.bolloon.agent",
-    "productName": "Bolloon Agent",
-    "directories": {
-      "output": "release",
-      "buildResources": "build"
-    },
-    "files": [
-      "dist/**/*",
-      "bin/**/*",
-      "package.json",
-      "dist/electron-build/**/*"
-    ],
-    "npmRebuild": false,
-    "buildDependenciesFromSource": false,
-    "extraResources": [
-      {
-        "from": "build",
-        "to": "build",
-        "filter": [
-          "**/*"
-        ]
-      }
-    ],
-    "extraMetadata": {
-      "main": "dist/electron-build/electron.js",
-      "type": "commonjs"
-    },
-    "win": {
-      "target": [
-        {
-          "target": "nsis",
-          "arch": [
-            "x64"
-          ]
-        }
-      ],
-      "icon": "build/icon.ico"
-    },
-    "mac": {
-      "target": [
-        "dmg"
-      ],
-      "icon": "build/icon.icns"
-    },
-    "linux": {
-      "target": [
-        "AppImage"
-      ],
-      "icon": "build/icon.png"
-    },
-    "nsis": {
-      "oneClick": false,
-      "perMachine": false,
-      "allowToChangeInstallationDirectory": true,
-      "createDesktopShortcut": true,
-      "createStartMenuShortcut": true
-    },
-    "asar": true,
-    "asarUnpack": [
-      "node_modules/@diap/**/*",
-      "node_modules/@rayhanadev/**/*",
-      "node_modules/@x402/**/*",
-      "node_modules/libp2p/**/*",
-      "node_modules/@libp2p/**/*"
-    ]
-  }
-}
+{
+  "name": "@bolloon/bolloon-agent",
+  "version": "0.4.0",
+  "type": "module",
+  "description": "P2P AI Document Agent - 全局安装后执行 `bolloon` 启动产品",
+  "main": "dist/cli-entry.js",
+  "author": "yuanjie liu",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/logos-42/bolloon.git"
+  },
+  "license": "MIT",
+  "files": [
+    "dist",
+    "bin/bolloon.cjs",
+    "bin/bolloon.js",
+    "bin/bolloon.cmd",
+    "bin/bolloon-cli.cjs",
+    "bin/bolloon-daemon.sh",
+    "scripts/postinstall.js",
+    "scripts/build-cli.js",
+    "scripts/build-web.ts"
+  ],
+  "bin": {
+    "bolloon": "./dist/cli-entry.js"
+  },
+  "scripts": {
+    "build": "npm run build --workspaces --if-present",
+    "build:main": "tsc && node scripts/copy-constraint-runtime.mjs",
+    "build:cli": "node scripts/build-cli.js",
+    "build:web": "npx tsx scripts/build-web.ts",
+    "build:rokid-sdk": "npm --prefix ../rokid run build",
+    "test:rokid-sdk": "npm --prefix ../rokid test",
+    "build:electron": "tsc -p tsconfig.electron.json",
+    "build:all": "npm run build:main && npm run build:web && npm run build:electron && npm run build:cli",
+    "start": "node dist/index.js",
+    "dev": "tsx -r dotenv/config src/index.ts",
+    "dev:web": "npm run build:web && tsx -r dotenv/config src/index.ts --web",
+    "dev:electron": "npm run build:electron && npm run electron:start",
+    "electron:start": "NODE_ENV=development electron dist/electron-build/electron.js",
+    "electron:dev": "concurrently \"npm run dev:web\" \"npm run electron:start\"",
+    "electron:build": "npm run build:electron && electron-builder",
+    "electron:pack": "electron-builder --dir",
+    "app:bundle": "node scripts/build-app-bundle.cjs",
+    "app:bundle:open": "node scripts/build-app-bundle.cjs && open \"release/mac-arm64/Bolloon Agent.app\"",
+    "smoke:esm": "node scripts/smoke-esm.mjs",
+    "prepublishOnly": "npm run build:all && npm run smoke:esm",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:pi-sdk": "tsx src/test/pi-sdk.test.ts",
+    "postinstall": "node scripts/postinstall.js",
+    "verify:ipns": "tsx scripts/verify-ipns-pipeline.ts"
+  },
+  "workspaces": [
+    "src/constraint-runtime"
+  ],
+  "dependencies": {
+    "@bolloon/bolloon-agent": "^0.3.22",
+    "@bolloon/constraint-runtime": "0.1.0",
+    "@capacitor/android": "^8.4.1",
+    "@capacitor/core": "^8.4.1",
+    "@capacitor/ios": "^8.4.2",
+    "@chainsafe/libp2p-noise": "^17.0.0",
+    "@chainsafe/libp2p-yamux": "^8.0.1",
+    "@diap/sdk": "^0.2.4",
+    "@libp2p/autonat": "^3.0.25",
+    "@libp2p/circuit-relay-v2": "^4.2.9",
+    "@libp2p/dcutr": "^3.0.20",
+    "@libp2p/gossipsub": "^16.1.1",
+    "@libp2p/identify": "^4.1.6",
+    "@libp2p/kad-dht": "^16.2.6",
+    "@libp2p/tcp": "^11.0.20",
+    "@libp2p/upnp-nat": "^4.0.20",
+    "@multiformats/multiaddr": "^13.0.3",
+    "@noble/hashes": "^1.3.0",
+    "@orbitdb/core": "^4.0.0",
+    "@polymarket/client": "^0.2.0",
+    "@rayhanadev/iroh": "^0.1.1",
+    "@x402/aptos": "^2.20.0",
+    "@x402/avm": "^2.20.0",
+    "@x402/axios": "^2.20.0",
+    "@x402/core": "^2.20.0",
+    "@x402/evm": "^2.20.0",
+    "@x402/express": "^2.20.0",
+    "@x402/extensions": "^2.20.0",
+    "@x402/fastify": "^2.20.0",
+    "@x402/fetch": "^2.20.0",
+    "@x402/hedera": "^2.20.0",
+    "@x402/hono": "^2.20.0",
+    "@x402/keeta": "^2.20.0",
+    "@x402/mcp": "^2.20.0",
+    "@x402/next": "^2.20.0",
+    "@x402/paywall": "^2.20.0",
+    "@x402/stellar": "^2.20.0",
+    "@x402/svm": "^2.20.0",
+    "@x402/tvm": "^2.20.0",
+    "b4a": "^1.8.1",
+    "dotenv": "^17.4.2",
+    "esbuild": "^0.24.0",
+    "express": "^5.2.1",
+    "helia": "^7.1.3",
+    "ink": "^7.1.1",
+    "ink-text-input": "^6.0.0",
+    "libp2p": "^3.3.0",
+    "mammoth": "^1.6.0",
+    "pdf-parse": "^1.1.4",
+    "platform": "^1.3.6",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "viem": "^2.52.0"
+  },
+  "devDependencies": {
+    "@capacitor/cli": "^8.4.1",
+    "@playwright/test": "^1.60.0",
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.9.1",
+    "@types/pdf-parse": "^1.1.5",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.4",
+    "concurrently": "^9.2.1",
+    "electron": "^42.3.0",
+    "electron-builder": "^26.15.5",
+    "lefthook": "^2.1.9",
+    "playwright": "^1.60.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.1.6"
+  },
+  "build": {
+    "appId": "com.bolloon.agent",
+    "productName": "Bolloon Agent",
+    "directories": {
+      "output": "release",
+      "buildResources": "build"
+    },
+    "files": [
+      "dist/**/*",
+      "bin/**/*",
+      "package.json",
+      "dist/electron-build/**/*"
+    ],
+    "npmRebuild": false,
+    "buildDependenciesFromSource": false,
+    "extraResources": [
+      {
+        "from": "build",
+        "to": "build",
+        "filter": [
+          "**/*"
+        ]
+      }
+    ],
+    "extraMetadata": {
+      "main": "dist/electron-build/electron.js",
+      "type": "commonjs"
+    },
+    "win": {
+      "target": [
+        {
+          "target": "nsis",
+          "arch": [
+            "x64"
+          ]
+        }
+      ],
+      "icon": "build/icon.ico"
+    },
+    "mac": {
+      "target": [
+        "dmg"
+      ],
+      "icon": "build/icon.icns"
+    },
+    "linux": {
+      "target": [
+        "AppImage"
+      ],
+      "icon": "build/icon.png"
+    },
+    "nsis": {
+      "oneClick": false,
+      "perMachine": false,
+      "allowToChangeInstallationDirectory": true,
+      "createDesktopShortcut": true,
+      "createStartMenuShortcut": true
+    },
+    "asar": true,
+    "asarUnpack": [
+      "node_modules/@diap/**/*",
+      "node_modules/@rayhanadev/**/*",
+      "node_modules/@x402/**/*",
+      "node_modules/libp2p/**/*",
+      "node_modules/@libp2p/**/*"
+    ]
+  }
+}