bom-pi 0.0.3 → 0.0.5

package/apps/web/pocket-adapter.mjs

@@ -137,7 +137,7 @@ export function makePocketAdapter({ rpc, checkToken, push }) {
         createdAt: updatedAt,
         updatedAt,
         createdBy: OWNER.id,
-        busy: false, // PORT(bom-pi): session.list chưa báo busy — làm mới qua events.update
+        busy: c.busy === true, // LiveDoc.run — push 'done' + UI "working" dùng chung nguồn này
         waiting: appr.some((a) => Number(a.conversationId) === Number(c.id)),
         model: c.model?.modelId ?? 'glm-5.3',
         title,
@@ -158,7 +158,7 @@ export function makePocketAdapter({ rpc, checkToken, push }) {
       conversation: { id: Number(convId), kind: 'session', title: conv?.title ?? `session ${convId}`, cwd: conv?.cwd ?? '', archived: false },
       entries,
       order: entries.map((e) => e.id),
-      live: { busy: conv?.busy === true || conv?.running === true },
+      live: { busy: conv?.busy === true },
       agent: { model: { provider: conv?.model?.provider ?? 'zai', modelId: conv?.model?.modelId ?? 'glm-5.3' }, thinkingLevel: 'high', cwd: conv?.cwd ?? '', available: true, modelName: conv?.model?.modelId ?? 'GLM-5.3', contextWindow: 1000000, reasoning: true, images: false, levels: ['low', 'high', 'max'] },
       stats: { cost: 0 },
       clients: 1, viewers: ['Owner'],
@@ -169,6 +169,17 @@ export function makePocketAdapter({ rpc, checkToken, push }) {
     };
   }
 
+  // title conversation = message user đầu (cùng logic sessionsPayload) — cho targetTitle webhook
+  async function convTitle(convId) {
+    try {
+      const raw = await rpc('transcript.raw', { conversationId: convId });
+      const first = (raw.entries ?? []).find((e) => e.kind === 'pi.user');
+      const m0 = first?.model?.[0];
+      const text = typeof m0?.content === 'string' ? m0.content : Array.isArray(m0?.content) ? m0.content.filter((p) => p?.type === 'text').map((p) => p.text).join(' ') : '';
+      return text ? text.split('\n')[0].slice(0, 60) : `session ${convId}`;
+    } catch { return `session ${convId}`; }
+  }
+
   const json = (res, code, obj) => { res.writeHead(code, { 'content-type': 'application/json', 'access-control-allow-origin': '*' }); res.end(JSON.stringify(obj)); };
   const readBody = (req) => new Promise((done) => { let b = ''; req.on('data', (c) => (b += c)); req.on('end', () => { try { done(JSON.parse(b || '{}')); } catch { done({}); } }); });
 
@@ -334,10 +345,28 @@ export function makePocketAdapter({ rpc, checkToken, push }) {
         return true;
       }
 
+      // ---- webhooks (vòng 9 — port pi-pocket): list/add/rotate/remove; dispatch ở route public /hook/<id>/<secret> ----
+      if (first === 'hooks') {
+        if (second === undefined && method === 'GET') {
+          const r = await rpc('hooks.list');
+          const out = [];
+          for (const h of r.hooks ?? []) out.push({ ...h, targetTitle: await convTitle(h.target) });
+          return json(res, 200, out), true;
+        }
+        if (second === undefined && isPost) {
+          const body = await readBody(req);
+          return json(res, 200, await rpc('hooks.add', {
+            target: body.target, name: body.name, instructions: body.instructions,
+            ...(body.signed === true ? { signed: true } : {}),
+          })), true;
+        }
+        if (second !== undefined && third === 'rotate' && isPost) { await readBody(req); return json(res, 200, await rpc('hooks.rotate', { id: second })), true; }
+        if (second !== undefined && third === 'remove' && isPost) { await readBody(req); return json(res, 200, await rpc('hooks.remove', { id: second })), true; }
+      }
+
       // ---- stub rỗng: tính năng pocket chưa có ở bom-pi ----
       if (first === 'users' && method === 'GET') return json(res, 200, [OWNER]), true;
       if (first === 'subagents' && method === 'GET') return json(res, 200, []), true;
-      if (first === 'hooks' && method === 'GET') return json(res, 200, []), true;
       if (first === 'folder-favorites' && method === 'GET') return json(res, 200, []), true;
       if (first === 'pi-sessions' && method === 'GET') return json(res, 200, []), true;
       if (first === 'fs') return json(res, 200, { entries: [] }), true; // PORT(bom-pi): file tree

package/apps/web/server.mjs

@@ -111,7 +111,7 @@ async function verifyDeviceToken(token) {
 }
 const authorized = async (req, url) => {
   if (url.pathname === '/api/pair/start') return true; // public — tự vệ bằng code + rate-limit daemon
-  if (!url.pathname.startsWith('/api/')) return true; // static UI/PWA — không dữ liệu
+  if (!url.pathname.startsWith('/api/') && url.pathname !== '/rpc') return true; // static UI/PWA — không dữ liệu
   const header = req.headers.authorization ?? '';
   const bearer = header.startsWith('Bearer ') ? header.slice(7) : null;
   const qToken = url.searchParams.get('token');
@@ -150,6 +150,7 @@ async function ensureEventsSocket(cid) {
         if (msg.method === 'events.update') {
           for (const fn of eventListeners) fn(msg.params);
           pushApprovalWatch(); // push "needs approval" — kể cả khi tab đóng
+          pushDoneWatch(); // push "bom finished" khi conv busy→idle
         }
       } catch { /* dòng chưa trọn */ }
     }
@@ -222,6 +223,63 @@ function pushApprovalWatch() {
 
 const pocketRoute = makePocketAdapter({ rpc, checkToken: async (t) => (TOKEN ? t === TOKEN : false) || (await verifyDeviceToken(t)), push: pushStore ? { store: pushStore, userId: PUSH_USER } : null });
 
+// ---- push 'done' (khuôn alerts.ts: runChanged + DONE_DELAY 3s): conv busy→idle và Ở YÊN
+// 3s (follow-up queued thường chạy ngay) ⇒ "bom finished · <title>". Abort không bắn —
+// người dùng tự dừng, không phải tin; error đổi tiêu đề. ----
+const DONE_DELAY_MS = 3000;
+let busyByConv = null; // null = chưa nạp mốc — không bắn trạng thái cũ lúc web mới lên
+const doneTimers = new Map(); // convId → timeout đợi-yên
+let doneWatchTimer = null;
+function pushDoneWatch() {
+  if (!pushStore || doneWatchTimer) return;
+  doneWatchTimer = setTimeout(() => {
+    doneWatchTimer = null;
+    void (async () => {
+      try {
+        if (pushStore.subscriptions(PUSH_USER).length === 0) { busyByConv = null; return; }
+        const convs = (await rpc('session.list')).conversations ?? [];
+        const now = new Map(convs.map((c) => [Number(c.id), c.busy === true]));
+        if (busyByConv === null) { busyByConv = now; return; }
+        for (const [id, busy] of now) {
+          const was = busyByConv.get(id);
+          if (was === undefined || was === busy) continue;
+          clearTimeout(doneTimers.get(id));
+          doneTimers.delete(id);
+          if (!busy) {
+            const t = setTimeout(() => { doneTimers.delete(id); void pushDone(id); }, DONE_DELAY_MS);
+            t.unref?.();
+            doneTimers.set(id, t);
+          }
+        }
+        busyByConv = now;
+      } catch { /* daemon bận — events.update kế tiếp */ }
+    })();
+  }, 500);
+}
+async function pushDone(convId) {
+  try {
+    if (!pushStore.prefs(PUSH_USER).done) return;
+    const conv = ((await rpc('session.list')).conversations ?? []).find((c) => Number(c.id) === Number(convId));
+    if (!conv || conv.busy === true) return; // đã chạy tiếp — không phải "xong"
+    const entries = (await rpc('transcript.raw', { conversationId: convId })).entries ?? [];
+    let title = `session ${convId}`;
+    const m0 = entries.find((e) => e.kind === 'pi.user')?.model?.[0];
+    const text0 = typeof m0?.content === 'string' ? m0.content : Array.isArray(m0?.content) ? m0.content.filter((p) => p?.type === 'text').map((p) => p.text).join(' ') : '';
+    if (text0) title = text0.split('\n')[0].slice(0, 60);
+    const ma = [...entries].reverse().find((e) => e.kind === 'pi.assistant')?.model?.[0];
+    if (ma?.stopReason === 'aborted') return;
+    const failed = ma?.stopReason === 'error' || Boolean(ma?.errorMessage);
+    const bodyText = ma ? (Array.isArray(ma.content) ? ma.content.filter((p) => p?.type === 'text').map((p) => p.text).join('\n') : String(ma.text ?? '')) : '';
+    const sent = await pushStore.notify(PUSH_USER, {
+      title: failed ? `bom stopped with an error · ${title}` : `bom finished · ${title}`,
+      body: String(failed ? ma.errorMessage ?? 'The model request failed.' : bodyText || 'Done.').slice(0, 400),
+      url: `/s/${Number(convId)}`,
+      tag: `done-${convId}`,
+    });
+    console.error(`push done ${convId}${failed ? ' (error)' : ''} → ${sent} thiết bị`);
+  } catch (e) { console.error(`push done ${convId} lỗi: ${e.message}`); }
+}
+
 // ---- HTML (mobile-first, không framework) ----
 const HTML = `<!doctype html>
 <html lang="en"><head>
@@ -668,6 +726,30 @@ const http = createHttpServer(async (req, res) => {
     try { return json2(res, 200, await rpc('pair.poll', { enrollId: p.enrollId })); }
     catch (e) { return json2(res, 404, { error: e.message.replace(/^\d+: /, '') }); }
   }
+  // ---- /hook/<id>[/<secret>]: webhook public (vòng 9 — port pi-pocket hooks, bản đơn).
+  // Dịch vụ ngoài (GitHub/CI/monitor/cron) POST ⇒ message vào conversation. KHÔNG token:
+  // secret nằm trong path (unsigned) hoặc chữ ký X-Hub-Signature-256 (signed) — daemon verify. ----
+  if (req.method === 'POST' && url.pathname.startsWith('/hook/')) {
+    const parts = url.pathname.slice('/hook/'.length).split('/').filter(Boolean);
+    if (parts.length < 1 || parts.length > 2 || parts.some((p) => p === '')) { res.writeHead(404, { 'content-type': 'application/json' }); return res.end('{"error":"Not found"}'); }
+    if (Number(req.headers['content-length'] ?? 0) > 5 * 1024 * 1024) { res.writeHead(413, { 'content-type': 'application/json' }); return res.end('{"error":"Request too large"}'); }
+    const body = await new Promise((done) => { let b = ''; req.on('data', (c) => (b += c)); req.on('end', () => done(b)); });
+    try {
+      const r = await rpc('hooks.dispatch', {
+        id: parts[0],
+        ...(parts[1] !== undefined ? { secret: parts[1] } : {}),
+        body,
+        signature: req.headers['x-hub-signature-256'],
+        delivery: req.headers['x-github-delivery'] ?? req.headers['idempotency-key'],
+      });
+      return json2(res, 200, r);
+    } catch (e) {
+      const msg = String(e?.message ?? e).replace(/^-?\d+: /, '');
+      if (/not found/.test(msg)) return json2(res, 404, { error: 'Not found' }); // không tiết lộ hook tồn tại与否
+      if (/rate-limited/.test(msg)) { res.writeHead(429, { 'content-type': 'application/json', 'retry-after': '60', ...CORS }); return res.end('{"error":"Too many posts this hour"}'); }
+      return json2(res, 502, { error: msg });
+    }
+  }
   // ---- UI pocket (public/): shell + module + vendor tĩnh, KHÔNG cần token ----
   // serveStatic phục vụ cả sw.js/manifest/icon của pocket (public/) — không còn hằng
   // SW cũ: sw.js pocket có push handler (notification từ push service).
@@ -689,6 +771,17 @@ const http = createHttpServer(async (req, res) => {
   }
   if (!(await authorized(req, url))) { res.writeHead(401, { 'content-type': 'application/json', ...CORS }); return res.end(JSON.stringify({ error: 'unauthorized — open /pair and enter the code from `bom-pi pair`' })); }
 
+  // ---- /rpc: JSON-RPC 2.0 qua HTTP cho CLI từ thiết bị khác (BOM_PI_URL + device token) ----
+  // Cùng cổng auth /api/* (master BOM_PI_TOKEN hoặc device token bom_…); web-devices pair
+  // trước rồi đặt env. Trả JSON-RPC error shape để CLI hiển thị như lỗi local.
+  if (req.method === 'POST' && url.pathname === '/rpc') {
+    const raw = await new Promise((done) => { let b = ''; req.on('data', (c) => (b += c)); req.on('end', () => done(b)); });
+    let p; try { p = JSON.parse(raw || '{}'); } catch { return json2(res, 400, { error: { code: -32700, message: 'invalid JSON' } }); }
+    if (typeof p.method !== 'string') return json2(res, 400, { error: { code: -32600, message: 'method (string) required' } });
+    try { return json2(res, 200, await rpc(p.method, p.params)); }
+    catch (e) { return json2(res, 502, { error: { code: -32000, message: String(e?.message ?? e).replace(/^\d+: /, '') } }); }
+  }
+
   if (req.method === 'GET' && url.pathname === '/') {
     res.writeHead(200, { 'content-type': 'text/html; charset=utf-8', ...CORS });
     return res.end(HTML);
@@ -805,4 +898,8 @@ http.listen(PORT, LISTEN, () => {
   console.error(`bom-web listening http://${LISTEN}:${PORT} — bom-core at ${socketPath}${TOKEN ? ' — token required' : ' — NO TOKEN (loopback only)'}${pushStore ? ` — push ${pushStore.publicKey.slice(0, 12)}…` : ' — push OFF'}`);
   // Socket events sống từ boot: push approval phải nổ khi không ai mở web
   ensureEventsSocket().catch(() => scheduleEventsReconnect());
+  // eventsSocket chỉ watch conv active — conv khác (factory) kết thúc turn không sinh
+  // event cho web ⇒ poll 5s mọi conv cho push done/approval (chỉ khi có subscription,
+  // hai watch đều debounce + early-return nên gần như miễn phí khi không ai đăng ký).
+  setInterval(() => { pushApprovalWatch(); pushDoneWatch(); }, 5000).unref?.();
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bom-pi",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "type": "module",
   "description": "bom × pi — hệ sinh thái durable cho pi trên nền pi-durable: core daemon + web UI pocket + CLI",
   "engines": {

package/packages/cli/src/bom-pi.mjs

@@ -27,6 +27,18 @@ const cid = arg('cid', null); // conversation id cho submit/transcript/reset/wat
 const cidParams = () => (cid ? { conversationId: Number(cid) } : {});
 const cmd = process.argv[2] ?? 'status';
 
+// Remote (thiết bị khác — Windows/phone đã pair): BOM_PI_URL=http://host:8791 (+ BOM_PI_TOKEN
+// device token bom_… copy sau khi pair qua browser). CLI nói chuyện web /rpc thay unix socket.
+const REMOTE_URL = arg('url', process.env.BOM_PI_URL || null);
+const REMOTE_TOKEN = arg('token', process.env.BOM_PI_TOKEN || null);
+
+// -v/--version trước mọi thứ — user kiểm bản nào đang chạy (bài học: máy Windows kẹt bản cũ)
+const VERSION = (await import('../../../package.json', { with: { type: 'json' } })).default.version;
+if (cmd === '-v' || cmd === '--version' || cmd === 'version') {
+  console.log(`bom-pi ${VERSION}${REMOTE_URL ? ` (remote ${REMOTE_URL})` : ''}`);
+  process.exit(0);
+}
+
 // Không thấy daemon: hướng dẫn theo nơi đang chạy — máy chủ (chưa start?) hay
 // thiết bị khác (Windows/phone: bom-core là daemon unix-socket systemd, chưa port).
 function unreachable(e) {
@@ -35,18 +47,23 @@ function unreachable(e) {
     return `${head}
 
   bom-core chạy trên máy chủ Linux (unix socket + systemd) — CLI chưa chạy được trên Windows.
-  Từ thiết bị khác, dùng WEB thay CLI: mở http://<ip-máy-chạy-daemon>:8791 (hoặc URL tunnel
-  https://… nếu có) rồi pair bằng code in ra từ lệnh 'bom-pi pair' chạy TRÊN MÁY CHỦ đó.`;
+  Hai đường từ máy khác:
+  · WEB (đầy đủ nhất):  mở http://<ip-máy-chạy-daemon>:8791 (hoặc tunnel https://…) rồi pair
+                         bằng code in ra từ lệnh 'bom-pi pair' chạy TRÊN MÁY CHỦ đó.
+  · CLI REMOTE:         pair qua browser trước, copy device token bom_…, rồi đặt:
+                         set BOM_PI_URL=http://<ip>:8791  &  set BOM_PI_TOKEN=bom_…
+                         (PowerShell: $env:BOM_PI_URL=…; $env:BOM_PI_TOKEN=…) rồi chạy bom-pi status`;
   }
   return `${head}
 
   daemon chưa chạy? thử:  systemctl --user start bom-core   (xem trạng thái: bom-pi status)
   chưa cài daemon?:      bom-pi setup
-  ở THIẾT BỊ KHÁC?:      CLI nói chuyện daemon trên MÁY NÀY — từ phone/laptop hãy mở
-                         http://<ip-máy-chạy-daemon>:8791 và pair bằng code từ 'bom-pi pair'.`;
+  ở THIẾT BỊ KHÁC?:      CLI có thể nói chuyện daemon từ xa — pair qua browser trước
+                         (http://<ip-máy-chạy-daemon>:8791), copy device token, rồi:
+                         BOM_PI_URL=http://<ip>:8791 BOM_PI_TOKEN=bom_… bom-pi status`;
 }
 
-function rpc(method, params) {
+function rpcSocket(method, params) {
   return new Promise((done, fail) => {
     const conn = connect(socketPath);
     let buf = '';
@@ -82,6 +99,19 @@ function rpc(method, params) {
 
 const pretty = (o) => console.log(JSON.stringify(o, null, 2));
 
+// Dispatcher: remote (/rpc qua HTTP) khi BOM_PI_URL đặt — thiết bị khác không có unix socket
+async function rpcRemote(method, params) {
+  const r = await fetch(`${REMOTE_URL.replace(/\/+$/, '')}/rpc`, {
+    method: 'POST',
+    headers: { 'content-type': 'application/json', ...(REMOTE_TOKEN ? { Authorization: `Bearer ${REMOTE_TOKEN}` } : {}) },
+    body: JSON.stringify({ jsonrpc: '2.0', id: 1, method, params: params ?? {} }),
+  });
+  const j = await r.json().catch(() => ({}));
+  if (!r.ok) throw new Error(`bom-web ${REMOTE_URL} ${r.status}: ${j?.error?.message ?? r.statusText}`);
+  return j;
+}
+const rpc = REMOTE_URL ? rpcRemote : rpcSocket;
+
 // Kiểm protocol sau hello — mọi lệnh đều chạy qua đây
 function checkProtocol(hello) {
   if (typeof hello?.protocol === 'number' && hello.protocol > CLIENT_PROTOCOL) {
@@ -93,6 +123,10 @@ function checkProtocol(hello) {
 
 // ---- watch: mở 1 connection, subscribe, in transcript live đến khi Ctrl+C ----
 function watch() {
+  if (REMOTE_URL) {
+    console.error('watch cần kết nối socket local — từ thiết bị khác hãy mở web (transcript live có sẵn trong UI)');
+    process.exit(64);
+  }
   const conn = connect(socketPath);
   let gotReply = false;
   conn.on('connect', () => {
@@ -461,7 +495,7 @@ WantedBy=default.target
   } else if (cmd === 'shutdown') {
     pretty(await rpc('shutdown'));
   } else {
-    console.error('usage: bom-pi <hello|status|models|agents|sessions|new|use|submit|reset|transcript|approvals|approve|deny|schedules|schedule|unschedule|factory|limits|abort|watch|shutdown> [--socket PATH] [--cid N]');
+    console.error('usage: bom-pi <hello|status|models|agents|sessions|new|use|submit|reset|transcript|approvals|approve|deny|schedules|schedule|unschedule|factory|limits|abort|watch|shutdown|version> [--socket PATH] [--cid N] [--url http://host:8791] [--token bom_…]\n       từ thiết bị khác: BOM_PI_URL + BOM_PI_TOKEN (xem bom-pi version)');
     process.exit(64);
   }
   if (cmd !== 'watch') process.exit(0);

package/packages/core/src/daemon.mjs

@@ -31,7 +31,7 @@ import { homedir, userInfo } from 'node:os';
 import process from 'node:process';
 import { execFile as execFileCb } from 'node:child_process';
 import { promisify } from 'node:util';
-import { createHash, createPrivateKey, createPublicKey, generateKeyPairSync, randomBytes } from 'node:crypto';
+import { createHash, createHmac, createPrivateKey, createPublicKey, generateKeyPairSync, randomBytes, timingSafeEqual } from 'node:crypto';
 import { createLimitGate } from './limit-gate.mjs';
 
 const VERSION = '0.0.4';
@@ -624,6 +624,10 @@ function clearWatchState(ownerKey) {
 async function agentStateOf(id) {
   try { return await harness.snapshot(AgentDoc, id, BACKGROUND_CONTEXT); } catch { return undefined; }
 }
+// Busy = LiveDoc.run đang chạy (khuôn pocket app.ts #busy) — turn đang stream / tool đang chạy
+async function busyOf(id) {
+  try { return (await harness.snapshot(LiveDoc, id, BACKGROUND_CONTEXT))?.run !== undefined; } catch { return false; }
+}
 // factory của conversation gọi (gốc hoặc con); null = orphan (K7 — vẫn chạy, không thuộc xưởng)
 function deriveFactory(cid) {
   return factories.find((f) => f.conversationId === cid || f.childConversationIds.includes(cid)) ?? null;
@@ -986,6 +990,37 @@ async function saveDevices() {
   await writeFile(tmp, JSON.stringify(webDevices, null, 2) + '\n');
   await rename(tmp, devicesPath);
 }
+
+// ---- Webhooks (vòng 9 — port pi-pocket hooks.ts, bản đơn có chủ ý): địa chỉ mà dịch vụ
+// ngoài (GitHub/CI/monitor/cron) POST đến ⇒ message vào conversation. Secret trong path
+// (unsigned) hoặc chữ ký X-Hub-Signature-256 (signed, khuôn GitHub). PORT(bom-pi): lọc
+// "người ngoài repo" của pocket (cần gh query writers) — vòng này post hợp lệ đều qua. ----
+const hooksPath = join(dataDir, 'hooks.json');
+let hooks = []; // [{id, secret, name, instructions, target, signed?, by, createdAt, count, lastAt?}]
+const hookSeen = new Map(); // idempotency: key → ts (delivery id / Idempotency-Key, 1h)
+const hookHits = new Map(); // rate-limit: hook id → [ts] (30 post/h, cửa sổ trượt)
+const HOOK_LIMITS = { max: 20, nameLen: 60, instructionsLen: 2000, perHour: 30, payloadChars: 8000 };
+const HOOK_DEFAULT_INSTRUCTIONS = 'Something happened that you were set up to hear about. Say in a line what it is, and whether anything needs doing.';
+async function loadHooks() {
+  try { hooks = JSON.parse(await readFile(hooksPath, 'utf8')); } catch { hooks = []; }
+}
+async function saveHooks() {
+  const tmp = hooksPath + '.tmp';
+  await writeFile(tmp, JSON.stringify(hooks, null, 2) + '\n');
+  await rename(tmp, hooksPath);
+}
+const hookLabel = (name) => String(name ?? '').replace(/[[\]]/g, '').replace(/\s+/g, ' ').trim();
+const sameSecret = (a, b) => {
+  const l = createHash('sha256').update(String(a)).digest();
+  const r = createHash('sha256').update(String(b)).digest();
+  return timingSafeEqual(l, r) && String(a).length === String(b).length;
+};
+function hookView(h) {
+  const { secret, ...rest } = h;
+  // unsigned: secret nằm trong path (địa chỉ tự chịu); signed: path không secret —
+  // secret hiển thị riêng để paste vào GitHub Webhook secret
+  return h.signed === true ? { ...rest, path: `/hook/${h.id}`, secret } : { ...rest, path: `/hook/${h.id}/${secret}` };
+}
 const sha256hex = (s) => createHash('sha256').update(s).digest('hex');
 // Daemon keypair Ed25519 — sinh tại lần boot đầu (khuôn ssh host key / spin daemon):
 // MÁY NÀO cài bom-pi cũng tự có cặp key riêng. fp = 8 hex đầu sha256(publicKey DER) —
@@ -1051,7 +1086,7 @@ let taskRegistry = null; // gán trong boot sau createRegistry (registry là loc
 // ---- Mở Harness (pin exact @earendil-works 1.4.0 — xem DECISIONS.md) ----
 const { Harness } = await import('@earendil-works/pi-durable');
 const { openNodeSqliteStorage } = await import('@earendil-works/pi-durable/storage/sqlite/node');
-const { createRegistry, AgentDoc, defineExtension, wrapTool } = await import('@earendil-works/pi-durable');
+const { createRegistry, AgentDoc, LiveDoc, defineExtension, wrapTool } = await import('@earendil-works/pi-durable');
 const { CodingTools } = await import('@earendil-works/pi-durable/tools');
 const { NodeExecutionEnv } = await import('@earendil-works/pi-durable/env/node');
 const { ModelRuntime } = await import('@earendil-works/pi-coding-agent');
@@ -1321,6 +1356,7 @@ try {
   await loadFactories();
   await loadMetrics(); // M6c: ledger số đo trust ladder
   await loadDevices(); // M8: thiết bị đã pair (web-devices.json)
+  await loadHooks(); // vòng 9: webhook ngoài → conversation (hooks.json)
   await loadDaemonKeys(); // offer pair: keypair danh tính — fp + pubkey cho device đối chiếu
   if (factories.length) log('factories nạp lại:', factories.length, '—', factories.map((f) => f.id).join(', '));
   await loadConfigWatches(); // M5b: đăng lại watch config (scan-timer là M5d)
@@ -1471,6 +1507,7 @@ const methods = {
         model: agentState?.model ?? null,
         cwd: agentState?.cwd ?? null,
         instructions: agentState?.instructions ?? null, // M5a: smoke kiểm instructions của factory conv
+        busy: await busyOf(id), // web/UI + push 'done' theo dõi busy→idle
       });
     }
     return { active: activeConvId, count: out.length, conversations: out };
@@ -1565,6 +1602,97 @@ const methods = {
     await conv.configure(change, BACKGROUND_CONTEXT);
     return { ok: true, conversationId: conv.id };
   },
+  // ---- Webhooks (vòng 9): quản lý qua CLI/web, dispatch từ route public /hook/<id>/<secret> ----
+  async hooksList() {
+    return { hooks: hooks.map(hookView) };
+  },
+  async hooksAdd(params) {
+    const name = hookLabel(params?.name);
+    const instructions = typeof params?.instructions === 'string' ? params.instructions.trim() : '';
+    if (!name || name.length > HOOK_LIMITS.nameLen) throw new Error(`name: 1–${HOOK_LIMITS.nameLen} ký tự, một dòng`);
+    if (instructions.length > HOOK_LIMITS.instructionsLen) throw new Error(`instructions ≤ ${HOOK_LIMITS.instructionsLen} ký tự`);
+    const target = Number(params?.target);
+    if (!Number.isSafeInteger(target)) throw new Error('target: conversation id (xem session.list)');
+    await convFor({ conversationId: target }); // phải là conversation thật
+    if (hooks.length >= HOOK_LIMITS.max) throw new Error(`tối đa ${HOOK_LIMITS.max} webhook — bỏ cái cũ trước (hooks.remove)`);
+    // PORT(bom-pi): 'anyone' của pocket (lọc người ngoài repo qua gh) chưa có — bỏ qua
+    const hook = {
+      id: randomBytes(6).toString('base64url'),
+      secret: randomBytes(24).toString('base64url'),
+      name, instructions, target,
+      ...(params?.signed === true ? { signed: true } : {}),
+      by: 'bom-owner', createdAt: Date.now(), count: 0,
+    };
+    hooks.push(hook);
+    await saveHooks();
+    log('webhook tạo:', hook.id, '→ conv', target, hook.signed ? '(GitHub signed)' : '');
+    return hookView(hook);
+  },
+  async hooksRemove({ id }) {
+    const before = hooks.length;
+    hooks = hooks.filter((h) => h.id !== String(id ?? ''));
+    if (hooks.length === before) throw new Error('không có webhook đó — hooks.list');
+    hookHits.delete(String(id));
+    await saveHooks();
+    return { ok: true };
+  },
+  async hooksRotate({ id }) {
+    const h = hooks.find((x) => x.id === String(id ?? ''));
+    if (!h) throw new Error('không có webhook đó — hooks.list');
+    h.secret = randomBytes(24).toString('base64url');
+    await saveHooks();
+    log('webhook xoay secret:', h.id);
+    return hookView(h);
+  },
+  async hooksDispatch({ id, secret, body, signature, delivery }) {
+    const h = hooks.find((x) => x.id === String(id ?? ''));
+    // Không tiết lộ hook có tồn tại hay không — 404 chung chung như pocket
+    if (!h) throw new Error('not found');
+    const text = String(body ?? '');
+    if (secret !== undefined) {
+      if (h.signed === true || !sameSecret(secret, h.secret)) throw new Error('not found');
+    } else {
+      // Khuôn GitHub: X-Hub-Signature-256 = sha256=HMAC_SHA256(secret, body)
+      const sig = String(signature ?? '');
+      const expect = `sha256=${createHmac('sha256', h.secret).update(text).digest('hex')}`;
+      if (h.signed !== true || !sameSecret(sig, expect)) throw new Error('not found');
+    }
+    // Idempotency (GitHub delivery id / Idempotency-Key): post lại không thành message thứ hai
+    const key = delivery !== undefined && delivery !== '' ? String(delivery) : null;
+    if (key) {
+      const seen = hookSeen.get(`${h.id}:${key}`);
+      if (seen && Date.now() - seen < 3_600_000) return { ok: true, duplicate: true, conversationId: h.target };
+      hookSeen.set(`${h.id}:${key}`, Date.now());
+      if (hookSeen.size > 500) { // prune — giữ map nhỏ
+        const cut = Date.now() - 3_600_000;
+        for (const [k, ts] of hookSeen) if (ts < cut) hookSeen.delete(k);
+      }
+    }
+    // Rate-limit 30 post/h mỗi hook (cửa sổ trượt)
+    const now = Date.now();
+    const hits = (hookHits.get(h.id) ?? []).filter((t) => now - t < 3_600_000);
+    if (hits.length >= HOOK_LIMITS.perHour) throw new Error('rate-limited: too many posts this hour');
+    hits.push(now);
+    hookHits.set(h.id, hits);
+    // Message khuôn pocket: nhãn + instructions + payload fence (đọc như DATA, không phải lệnh)
+    const payload = text.length > HOOK_LIMITS.payloadChars ? `${text.slice(0, HOOK_LIMITS.payloadChars)}\n… (clipped)` : text;
+    const message = `[via webhook ${h.name}]\n${h.instructions || HOOK_DEFAULT_INSTRUCTIONS}\n\n<webhook-payload>\n${payload}\n</webhook-payload>`;
+    try {
+      await methods.sessionSubmit({
+        conversationId: h.target,
+        text: message,
+        ...(key ? { requestId: `hook-${h.id}-${key}` } : {}), // durable idempotent khi có delivery id
+      });
+    } catch (e) {
+      hookSeen.delete(`${h.id}:${key}`); // không vào transcript ⇒ lần sau thử lại được
+      throw new Error(`không submit được: ${e.message}`);
+    }
+    h.count += 1;
+    h.lastAt = now;
+    await saveHooks();
+    return { ok: true, conversationId: h.target };
+  },
+
   async sessionSubmit(params) {
     const conv = await convFor(params);
     const text = typeof params.text === 'string' ? params.text.trim() : '';