@firefunc-agent/runner 0.5.0

package/dist/viewer.js

@@ -0,0 +1,172 @@
+import { createServer } from 'node:http';
+import { makeStreamJsonParser } from './session-stream.js';
+const MAX_EVENTS = 5_000;
+const MAX_SESSIONS = 50;
+function sse(res, event, data) {
+    res.write(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`);
+}
+export function createSessionViewer(opts) {
+    const sessions = new Map();
+    const order = [];
+    const port = opts.port ?? 8787;
+    let url = null;
+    const server = createServer((req, res) => {
+        const path = new URL(req.url ?? '/', 'http://127.0.0.1').pathname;
+        if (path === '/healthz')
+            return void res.writeHead(200).end('ok');
+        if (path === '/')
+            return void res
+                .writeHead(200, { 'content-type': 'text/html' })
+                .end(indexHtml(listSessions()));
+        const m = /^\/s\/([^/]+?)(\/events)?$/.exec(path);
+        if (m) {
+            const runId = decodeURIComponent(m[1]);
+            const s = sessions.get(runId);
+            if (m[2] === '/events') {
+                res.writeHead(200, {
+                    'content-type': 'text/event-stream',
+                    'cache-control': 'no-cache',
+                    connection: 'keep-alive',
+                });
+                if (!s)
+                    return void sse(res, 'meta', { missing: true });
+                sse(res, 'meta', { title: s.title, repo: s.repo, status: s.status });
+                for (const ev of s.events)
+                    sse(res, 'event', ev);
+                if (s.status !== 'running')
+                    return void res.end();
+                s.clients.add(res);
+                req.on('close', () => s.clients.delete(res));
+                return;
+            }
+            return void res
+                .writeHead(200, { 'content-type': 'text/html' })
+                .end(sessionHtml(runId, s?.title ?? runId));
+        }
+        res.writeHead(404).end('not found');
+    });
+    server.on('error', (err) => {
+        url = null;
+        opts.onError?.(`session viewer could not start on :${port} (${err.message})`);
+    });
+    server.listen(port, '127.0.0.1', () => {
+        url = `http://127.0.0.1:${port}`;
+        opts.onListen?.(url);
+    });
+    function listSessions() {
+        return [...order]
+            .reverse()
+            .map((id) => sessions.get(id))
+            .filter((s) => !!s)
+            .map((s) => ({ runId: s.runId, title: s.title, status: s.status }));
+    }
+    function broadcast(s, event, data) {
+        for (const res of s.clients)
+            sse(res, event, data);
+    }
+    return {
+        get url() {
+            return url;
+        },
+        begin(runId, meta) {
+            if (sessions.has(runId))
+                return;
+            const s = {
+                runId,
+                title: meta.title ?? runId,
+                repo: meta.repo,
+                startedAt: Date.now(),
+                status: 'running',
+                events: [],
+                clients: new Set(),
+                feed: () => { },
+            };
+            s.feed = makeStreamJsonParser((ev) => {
+                s.events.push(ev);
+                if (s.events.length > MAX_EVENTS)
+                    s.events.shift();
+                broadcast(s, 'event', ev);
+            });
+            sessions.set(runId, s);
+            order.push(runId);
+            while (order.length > MAX_SESSIONS) {
+                const old = order.shift();
+                sessions.get(old)?.clients.forEach((c) => c.end());
+                sessions.delete(old);
+            }
+        },
+        push(runId, chunk) {
+            sessions.get(runId)?.feed(chunk);
+        },
+        end(runId, status) {
+            const s = sessions.get(runId);
+            if (!s || s.status !== 'running')
+                return;
+            s.status = status;
+            broadcast(s, 'status', { status });
+            s.clients.forEach((c) => c.end());
+            s.clients.clear();
+        },
+        close() {
+            server.close();
+        },
+    };
+}
+const SHELL_CSS = `
+  :root{--bg:#0c0d10;--bar:#1c1e24;--ink:#e6e7ea;--dim:#8a8f99;--accent:#ff7a45;--ok:#34d399;--red:#ef4444}
+  *{box-sizing:border-box} body{margin:0;background:#06070a;color:var(--ink);
+    font:13px/1.55 ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}
+  .win{max-width:980px;margin:24px auto;border-radius:12px;overflow:hidden;
+    box-shadow:0 24px 60px rgba(0,0,0,.5);border:1px solid #20222a}
+  .bar{display:flex;align-items:center;gap:8px;padding:10px 14px;background:var(--bar)}
+  .dot{width:12px;height:12px;border-radius:50%}.r{background:#ff5f57}.y{background:#febc2e}.g{background:#28c840}
+  .title{margin-left:8px;color:var(--dim);font-size:12px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+  .pill{margin-left:auto;font-size:11px;padding:2px 9px;border-radius:999px;background:#2a2d36;color:var(--dim)}
+  .pill.live{color:#fff;background:var(--accent)}.pill.live::before{content:"● "}
+  .pill.done{color:#06281c;background:var(--ok)}.pill.failed{color:#fff;background:var(--red)}
+  .body{background:var(--bg);padding:14px 16px;height:72vh;overflow:auto}
+  .ln{white-space:pre-wrap;word-break:break-word;padding:1px 0}
+  .ln.tool{color:var(--accent)} .ln.result{color:var(--ok);margin-top:6px;border-top:1px solid #20222a;padding-top:8px}
+  .ln.sys{color:var(--dim)} .cur{display:inline-block;width:8px;height:15px;background:var(--accent);
+    animation:b 1s steps(2) infinite;vertical-align:-2px}@keyframes b{50%{opacity:0}}
+  a{color:var(--accent)}`;
+function page(title, inner, script = '') {
+    return `<!doctype html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>${esc(title)}</title><style>${SHELL_CSS}</style></head><body>${inner}<script>${script}</script></body></html>`;
+}
+function sessionHtml(runId, title) {
+    const inner = `<div class="win"><div class="bar"><span class="dot r"></span><span class="dot y"></span><span class="dot g"></span>
+    <span class="title">firefunc · ${esc(title)}</span><span id="pill" class="pill">connecting…</span></div>
+    <div class="body" id="body"></div></div>`;
+    const script = `(function(){
+    var body=document.getElementById('body'),pill=document.getElementById('pill');
+    function add(cls,txt){var d=document.createElement('div');d.className='ln '+cls;d.textContent=txt;body.appendChild(d);
+      body.scrollTop=body.scrollHeight;}
+    function setPill(t,c){pill.textContent=t;pill.className='pill '+(c||'');}
+    var es=new EventSource(${JSON.stringify('/s/' + encodeURIComponent(runId) + '/events')});
+    es.addEventListener('meta',function(e){var m=JSON.parse(e.data);
+      if(m.missing){setPill('no session','failed');add('sys','No live session for this run on this machine.');es.close();return;}
+      setPill(m.status==='running'?'live':m.status,m.status==='running'?'live':m.status);});
+    es.addEventListener('event',function(e){var v=JSON.parse(e.data);
+      if(v.kind==='tool'){add('tool','\\u2692 '+v.name+(v.arg?' '+v.arg:''));}
+      else if(v.kind==='result'){add('result',v.text);}
+      else{add('',v.text);}});
+    es.addEventListener('status',function(e){var s=JSON.parse(e.data).status;setPill(s,s);es.close();});
+    es.onerror=function(){setPill('disconnected','failed');};
+  })();`;
+    return page(title, inner, script);
+}
+function indexHtml(list) {
+    const rows = list.length
+        ? list
+            .map((s) => `<div class="ln"><a href="/s/${encodeURIComponent(s.runId)}">${esc(s.title)}</a> <span class="ln sys">— ${s.status}</span></div>`)
+            .join('')
+        : '<div class="ln sys">No sessions yet. They appear here when FireFunc routes work to this runner.</div>';
+    const inner = `<div class="win"><div class="bar"><span class="dot r"></span><span class="dot y"></span><span class="dot g"></span>
+    <span class="title">firefunc · local sessions</span></div><div class="body">${rows}</div></div>`;
+    return page('firefunc · sessions', inner);
+}
+function esc(s) {
+    return s.replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' })[c]);
+}
+//# sourceMappingURL=viewer.js.map

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@firefunc-agent/runner",
+  "version": "0.5.0",
+  "private": false,
+  "type": "module",
+  "description": "FireFunc self-hosted runner — an always-on daemon that runs YOUR local coding agent (Claude Code, Codex, Gemini CLI, Cursor CLI) on work FireFunc routes to it, opens pull requests, and reports back. Your machine, your subscriptions.",
+  "keywords": [
+    "firefunc",
+    "runner",
+    "daemon",
+    "claude-code",
+    "codex",
+    "gemini-cli",
+    "cursor",
+    "ai-agent",
+    "automation"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "bin": {
+    "firefunc-runner": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "start": "tsx src/cli.ts start",
+    "build": "npm run clean && tsc -p .",
+    "prepack": "npm run build && node -e \"const{existsSync}=require('fs');if(!existsSync('dist/cli.js')){console.error('dist/cli.js is missing — refusing to pack a package with no code in it');process.exit(1)}\"",
+    "lint": "echo '[runner] lint TBD'",
+    "typecheck": "tsc -p . --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "clean": "node -e \"const{rmSync}=require('fs');rmSync('dist',{recursive:true,force:true});rmSync('tsconfig.tsbuildinfo',{force:true})\""
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.22.2",
+    "typescript": "^5.6.0",
+    "vitest": "^4.1.6"
+  }
+}