@guenbankhai/tools 0.0.0-stage → 0.1.0

package/agentmoni/lib/web.js

@@ -0,0 +1,75 @@
+// Web server: GET / (page), GET /events (SSE of the presenter view model), GET /timeline?key= (transcript timeline).
+// Listens on 127.0.0.1 only and refuses any other Host header (DNS rebinding).
+const http = require('node:http');
+const fs = require('node:fs');
+const path = require('node:path');
+const { readTimeline } = require('./timeline.js');
+
+const PORT = 4777, HOST = '127.0.0.1';
+const MAX_BUFFER = 1024 * 1024;   // a tab that stops reading is dropped instead of buffering forever
+
+function renderPage() {
+  const read = f => fs.readFileSync(path.join(__dirname, f), 'utf8');
+  // The page is one self-contained file: the layout module and the number formats are inlined (no CDN, no extra requests).
+  return read('page.html').replace('/*GRAPH*/', () => read('graph.js')).replace('/*HISTORY*/', () => read('history.js')).replace('/*FORMAT*/', () => read('format.js')).replace('/*COLORS*/', () => 'globalThis.AgentRegistry = ' + JSON.stringify(require('./agents/index.js').map(({ id, name, hue, models, windows, modelPrefix, efforts }) => ({ id, name, hue, models, windows, modelPrefix, efforts }))) + ';' + read('colors.js'));
+}
+
+// Port busy -> any free port.
+function listen(server, port, host) {
+  return new Promise((resolve, reject) => {
+    const failed = e => {
+      if (e.code === 'EADDRINUSE' && port !== 0) { port = 0; server.once('error', failed); server.listen(0, host); } else reject(e);
+    };
+    server.once('error', failed);
+    server.once('listening', () => { server.removeListener('error', failed); resolve(server.address()); });
+    server.listen(port, host);
+  });
+}
+
+// -> { url, close, publish(view, files, treeFor) }. files: Map "provider:id" -> transcript path; only these paths can ever be read.
+async function startWeb({ port = PORT, host = HOST, readTimeline: read = readTimeline } = {}) {
+  const page = renderPage(), clients = new Set();
+  let treeFor = null;
+  let packet = null, files = new Map();
+  const server = http.createServer((req, res) => {
+    const { port: p } = server.address();
+    if (![`${host}:${p}`, `localhost:${p}`].includes(req.headers.host)) { res.writeHead(403); res.end(); return; }
+    const url = new URL(req.url, 'http://x');   // query params (e.g. VS Code Simple Browser's) are ignored on /
+    if (req.method !== 'GET') { res.writeHead(405); res.end(); return; }
+    if (url.pathname === '/') {
+      res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8', 'Cache-Control': 'no-store', 'X-Content-Type-Options': 'nosniff',
+        'Content-Security-Policy': "default-src 'none'; base-uri 'none'; form-action 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; connect-src 'self'" });
+      res.end(page);
+    } else if (url.pathname === '/events') {
+      res.writeHead(200, { 'Content-Type': 'text/event-stream; charset=utf-8', 'Cache-Control': 'no-cache', Connection: 'keep-alive' });
+      res.write('retry: 2000\n\n');
+      if (packet) res.write(packet);
+      clients.add(res);
+      res.on('close', () => clients.delete(res));
+    } else if (url.pathname === '/tree') {
+      const keys = url.searchParams.getAll('key'), k = keys[0];
+      const valid = keys.length === 1 && [...url.searchParams.keys()].every(x => x === 'key') && /^[a-zA-Z0-9_-]+:[a-zA-Z0-9_-]+$/.test(k ?? '');
+      const tree = valid && treeFor?.(k);
+      res.writeHead(valid ? (tree ? 200 : 404) : 400, { 'Content-Type': 'application/json; charset=utf-8', 'Cache-Control': 'no-store' });
+      res.end(JSON.stringify(tree || { error: valid ? 'unknown session' : 'invalid key' }));
+    } else if (url.pathname === '/timeline') {
+      const file = files.get(url.searchParams.get('key'));
+      if (!file) { res.writeHead(404, { 'Content-Type': 'application/json' }); res.end('{"error":"no transcript for this session"}'); return; }
+      res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8', 'Cache-Control': 'no-store' });
+      res.end(JSON.stringify(read(file, url.searchParams.get('key').split(':')[0])));
+    } else { res.writeHead(404); res.end(); }
+  });
+  const publish = (view, fileMap, tree) => {
+    treeFor = tree;
+    if (fileMap) files = fileMap;
+    packet = `data: ${JSON.stringify(view)}\n\n`;
+    for (const c of clients) { if (c.writableLength > MAX_BUFFER) c.destroy(); else c.write(packet); }
+  };
+  const close = () => { for (const c of clients) c.destroy(); server.close(); };
+  try {
+    const a = await listen(server, port, host);
+    return { server, close, publish, url: `http://${a.address}:${a.port}` };
+  } catch (e) { close(); throw e; }
+}
+
+module.exports = { startWeb, renderPage };

package/agentmoni/monitor.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+// Monitor entry: agentmoni [--project <path>] [--quota | --token] [--once] | agentmoni --list [...]
+// Default run = terminal + web (HTTP/SSE on 127.0.0.1:4777). --once prints one frame and exits, no web.
+const path = require('node:path');
+const { createMonitor } = require('./lib/monitor.js');
+const { present, treeOf } = require('./lib/present.js');
+const { renderFrame } = require('./lib/terminal.js');
+const { repoKey } = require('./lib/repokey.js');
+const { createLimits } = require('./lib/limits.js');
+const { startWeb } = require('./lib/web.js');
+
+const REFRESH_MS = 1500;
+// COLUMNS is only a fallback when stdout is not a terminal: a finite integer of at least 20, else the default 120.
+const columnsOf = v => { const n = Number(v); return Number.isInteger(n) && n >= 20 ? n : 120; };
+const colorOn = () => !process.env.NO_COLOR && (!!process.stdout.isTTY || !!process.env.FORCE_COLOR);   // https://no-color.org
+
+async function main(argv) {
+  if (argv.includes('--list')) return require('./lib/list.js').main(argv);
+  const arg = name => { const i = argv.indexOf(name); return i < 0 ? null : argv[i + 1]; };
+  const once = argv.includes('--once'), modeFlag = argv.includes('--token') ? 'token' : argv.includes('--quota') ? 'quota' : null, mode = modeFlag ?? 'quota';
+  const project = arg('--project'), repo = project ? repoKey(path.resolve(project)) : null;
+  const monitor = createMonitor(), limits = createLimits();
+  monitor.start();
+  if (!once && !monitor.log.owner) {
+    // Allow a concurrent starter to finish binding its web port.
+    let url = monitor.log.readWeb();
+    for (let i = 0; !url && i < 20; i++) {
+      await new Promise(resolve => setTimeout(resolve, 100));
+      url = monitor.log.readWeb();
+    }
+    if (url) console.log('web: ' + url);
+    else {
+      const owner = monitor.log.warnings.find(w => /^another monitor \(pid /.test(w)) ?? 'another monitor is running (pid unknown)';
+      console.error(owner + '; no web URL yet');
+      process.exitCode = 1;
+    }
+    monitor.stop();
+    return;
+  }
+  const frame = async (waitQuota) => {
+    const now = Date.now();
+    const state = await monitor.refresh({ now, waitQuota });
+    const view = present(state, { mode, repo, now, catalog: monitor.catalog, limits });
+    // The web gets every repo (its filter starts at `repo`) and the transcript paths its timeline endpoint may read.
+    const web = () => ({ view: { ...present(state, { mode, repo: null, now, catalog: monitor.catalog, limits }), defaultRepo: repo, modeFlag },
+      files: new Map(state.sessions.map(s => [`${s.provider}:${s.id}`, s.source?.file]).filter(([, f]) => f)),
+      treeFor: k => treeOf(state, k, { mode, repo: null, now, catalog: monitor.catalog, limits }) });
+    return { view, web, text: renderFrame(view, { cols: process.stdout.columns || columnsOf(process.env.COLUMNS), rows: once ? Infinity : process.stdout.rows || Infinity, color: colorOn() }) };
+  };
+
+  const tty = !!process.stdout.isTTY;
+  if (once) {
+    const { view, text } = await frame(true);
+    console.log(text);
+    for (const w of view.warnings) console.error('warning:', w);
+    monitor.stop();
+    return;
+  }
+
+  let web = null, webError = null;
+  try { web = await startWeb(); monitor.log.publishWeb(web.url); } catch (e) { webError = e.message; }
+  let view = null, timer = null, stopped = false;
+  // Without a TTY there is no terminal view: only the web runs (URL printed once), until SIGINT/SIGTERM.
+  if (!tty) console.log(web ? `web: ${web.url}` : `web: off (${webError})`);
+  const draw = () => {
+    if (!view || !tty) return;
+    const text = renderFrame(view, { cols: process.stdout.columns, rows: process.stdout.rows - 2, color: colorOn() });
+    const foot = web ? `web: ${web.url}` : `web: off (${webError})`;
+    process.stdout.write('\x1b[H' + [...text.split('\n'), foot].map(l => l + '\x1b[K').join('\n') + '\n\x1b[J');
+  };
+  const quit = () => {
+    if (stopped) return;
+    stopped = true; clearTimeout(timer);
+    web?.close(); monitor.stop();
+    if (tty) { process.stdin.setRawMode(false); process.stdout.write('\x1b[?25h\x1b[?1049l'); }
+    process.exit(0);
+  };
+  if (tty) {
+    process.stdout.write('\x1b[?1049h\x1b[?25l');
+    process.stdout.on('resize', draw);
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.on('data', d => { const s = String(d); if (s === 'q' || s === 'Q' || s === '\x03') quit(); });
+  }
+  process.on('SIGTERM', quit);
+  process.on('SIGINT', quit);
+  const tick = async () => {
+    try {
+      const f = await frame(false), w = f.web();
+      view = f.view; web?.publish(w.view, w.files, w.treeFor); draw();
+    } catch (e) { if (tty) process.stdout.write(`\x1b[H\x1b[Kmonitor error: ${e.message}`); else console.error('monitor error:', e.message); }
+    if (!stopped) timer = setTimeout(tick, REFRESH_MS);
+  };
+  tick();
+}
+
+if (require.main === module) main(process.argv.slice(2)).catch(e => { console.error(e.stack ?? e); process.exitCode = 1; });
+module.exports = { main, columnsOf };

package/package.json

@@ -1,6 +1,24 @@
 {
   "name": "@guenbankhai/tools",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/guenbankhai/tools.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "agentmoni": "agentmoni/monitor.js"
+  },
+  "files": [
+    "agentmoni/monitor.js",
+    "agentmoni/lib/"
+  ],
+  "scripts": {
+    "test": "node --test"
+  }
+}