bom-pi 0.0.4 → 0.0.6

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.6",
   "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

@@ -5,7 +5,7 @@
 // Mọi lệnh conversation nhận --cid N (mặc định: conversation active của daemon).
 import { connect } from 'node:net';
 import { join, resolve } from 'node:path';
-import { userInfo } from 'node:os';
+import { userInfo, homedir, hostname } from 'node:os';
 import { readFile, writeFile, mkdir, stat } from 'node:fs/promises';
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
@@ -27,10 +27,25 @@ 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);
+// Remote (thiết bị khác — Windows/phone): pair MỘT lần bằng 'bom-pi pair <code> --url …'
+// ⇒ CLI tự lưu {url, token} vào ~/.bom-pi.json và dùng mãi (env BOM_PI_URL/BOM_PI_TOKEN
+// vẫn đè lên nếu đặt; --url/--token đè lên tất cả). CLI nói chuyện web /rpc thay unix socket.
+const CONFIG_PATH = join(homedir(), '.bom-pi.json');
+let cliConfig = {};
+try { cliConfig = JSON.parse(await readFile(CONFIG_PATH, 'utf8')); } catch { /* chưa pair bao giờ */ }
+async function saveCliConfig(next) {
+  cliConfig = next;
+  await writeFile(CONFIG_PATH, `${JSON.stringify(next, null, 2)}\n`, { mode: 0o600 });
+}
+const REMOTE_URL = arg('url', process.env.BOM_PI_URL || cliConfig.url || null);
+const REMOTE_TOKEN = arg('token', process.env.BOM_PI_TOKEN || cliConfig.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).
@@ -40,20 +55,17 @@ 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.
-  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`;
+  Từ máy khác, pair MỘT LẦN bằng CLI (cần code in từ lệnh 'bom-pi pair' chạy TRÊN MÁY CHỦ):
+    bom-pi pair <CODE> --url http://<ip-máy-chủ>:8791
+  xong CLI tự nhớ (lưu ~/.bom-pi.json) — mọi lệnh chạy remote: bom-pi status / sessions …
+  (hoặc dùng WEB đầy đủ: mở http://<ip-máy-chủ>:8791 — pair bằng cùng code đó)`;
   }
   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 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`;
+  ở THIẾT BỊ KHÁC?:      pair một lần rồi mọi lệnh chạy remote:
+                         bom-pi pair <CODE> --url http://<ip-máy-chạy-daemon>:8791`;
 }
 
 function rpcSocket(method, params) {
@@ -94,11 +106,16 @@ 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 ?? {} }),
-  });
+  let r;
+  try {
+    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 ?? {} }),
+    });
+  } catch (e) {
+    throw new Error(`không nối được ${REMOTE_URL}: ${e.message} — kiểm tra URL và web daemon (bom-web) đang chạy ở đó`);
+  }
   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;
@@ -310,7 +327,45 @@ try {
     // M8 + security: pairing 2 CHIỀU — thiết bị nhập code (chiều 1) ⇒ enrollment chờ;
     // token chỉ cấp khi duyệt tại máy (chiều 2): pair approve <mã ghép>
     const sub2 = process.argv[3];
-    if (!sub2) {
+    if (/^[A-Z2-7]{8}$/i.test(sub2 ?? '')) {
+      // THIẾT BỊ KHÁC pair từ CLI: code in ra từ máy chủ + URL web của máy chủ đó.
+      // /api/pair/start + /api/pair/poll công khai (code + operator duyệt tự vệ) —
+      // xong CLI TỰ LƯU {url, token} vào ~/.bom-pi.json, các lệnh sau chạy remote luôn.
+      const url = arg('url', REMOTE_URL || process.env.BOM_PI_URL || cliConfig.url || null);
+      if (!url) {
+        console.error('usage: bom-pi pair <code> --url http://<ip-máy-chủ>:8791 [--name tên-máy]\n  (URL là máy CHẠY DAEMON — in từ lệnh \'bom-pi pair\' trên máy đó, vd https://bom.example.io.vn hoặc http://192.168.1.4:8791)');
+        process.exit(64);
+      }
+      const base = url.replace(/\/+$/, '');
+      const name = arg('name', `${hostname() || 'device'} (cli)`);
+      const post = async (path, body) => {
+        const r = await fetch(`${base}${path}`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(body) });
+        const j = await r.json().catch(() => ({}));
+        if (!r.ok) throw new Error(`${path} ${r.status}: ${j?.error ?? r.statusText}`);
+        return j;
+      };
+      const st = await post('/api/pair/start', { code: sub2.toUpperCase(), name });
+      console.log(`đã gửi — chờ duyệt tại MÁY CHỦ. Ghép mã: ${st.displayId}`);
+      console.log(`(trên máy chủ: bom-pi pair approve ${st.displayId})`);
+      const t0 = Date.now();
+      for (;;) {
+        await new Promise((s) => setTimeout(s, st.pollAfterMs || 1500));
+        const p = await post('/api/pair/poll', { enrollId: st.enrollId });
+        if (p.status === 'approved') {
+          await saveCliConfig({ url: base, token: p.deviceToken, deviceId: p.deviceId, pairedAt: Date.now() });
+          console.log(`\nPAIRED ✓ — đã lưu ${CONFIG_PATH}`);
+          console.log(`mọi lệnh giờ tự chạy tới ${base}: bom-pi status / sessions / submit …`);
+          console.log(`(gỡ: bom-pi unpair)`);
+          process.exit(0);
+        }
+        if (p.status === 'rejected') { console.error('từ chối bởi operator tại máy chủ.'); process.exit(1); }
+        if (Date.now() - t0 > 5 * 60 * 1000) { console.error('hết thời gian chờ duyệt (5 phút) — chạy lại.'); process.exit(1); }
+        process.stdout.write('.');
+      }
+    } else if (!sub2 && REMOTE_URL) {
+      console.error(`máy này đã pair remote tới ${REMOTE_URL} (config ${CONFIG_PATH}).\n  'bom-pi pair' (in code/QR) là lệnh chạy TRÊN MÁY CHỦ — chạy đó, hoặc gỡ remote: bom-pi unpair.`);
+      process.exit(64);
+    } else if (!sub2) {
       const r = await rpc('pair.code');
       const nets = await import('node:os');
       const lan = Object.values(nets.networkInterfaces() ?? {}).flat()
@@ -354,6 +409,15 @@ try {
       console.log(`${d.revokedAtMs ? '○' : '●'} ${d.id}  ${(d.name ?? '?').padEnd(18)} ${d.revokedAtMs ? 'revoked ' + new Date(d.revokedAtMs).toLocaleString() : 'paired ' + when}  hash ${d.tokenHash8}`);
     }
     console.error(`# ${r.devices.filter((d) => !d.revokedAtMs).length} đang sống — thu hồi: bom-pi device rm <id>`);
+  } else if (cmd === 'unpair') {
+    // Gỡ remote khỏi máy này: thu hồi device TẠI MÁY CHỦ (best-effort) rồi xoá config local
+    if (!cliConfig.url || !cliConfig.token) { console.error('# máy này chưa pair remote (không có config)'); process.exit(0); }
+    try {
+      await rpcRemote('devices.remove', { id: cliConfig.deviceId });
+      console.log('đã thu hồi device tại máy chủ.');
+    } catch (e) { console.error(`# không thu hồi được tại máy chủ (${e.message}) — xoá config local thôi.`); }
+    await saveCliConfig({});
+    console.log(`đã xoá ${CONFIG_PATH} — CLI quay về local socket.`);
   } else if (cmd === 'setup') {
     // Sinh systemd user units đúng đường dẫn cài (npm global HOẶC working tree) + enable.
     // root = 3 cấp trên file CLI này: packages/cli/src → gốc package (cả hai kiểu cài đều đúng)
@@ -488,7 +552,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|unpair|version> [--socket PATH] [--cid N] [--url http://host:8791] [--token bom_…]\n       thiết bị khác: bom-pi pair <CODE> --url http://host:8791 — pair một lần, CLI tự nhớ (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() : '';