bom-pi 0.0.4 → 0.0.5

package/apps/web/pocket-adapter.mjs

@@ -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

@@ -726,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).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bom-pi",
-  "version": "0.0.4",
+  "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

@@ -32,6 +32,13 @@ const cmd = process.argv[2] ?? 'status';
 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) {
@@ -488,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';
@@ -990,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) —
@@ -1325,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)
@@ -1570,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() : '';