@xerktech/claude-hud 0.1.0

package/dist/_broker/server.js

@@ -0,0 +1,325 @@
+import http from 'node:http';
+import https from 'node:https';
+import express from 'express';
+import { WebSocketServer } from 'ws';
+import { Store } from "./store.js";
+import { createBearerAuth, constantTimeEqual } from "./auth.js";
+import { corsMiddleware } from "./cors.js";
+import { ensureCert } from "./cert.js";
+import { EventBus } from "./bus.js";
+import { registerRoutes } from "./routes.js";
+import { SessionManager } from "./sessions.js";
+import { ProjectsStore } from "./projects.js";
+import { SessionsSnapshotStore } from "./sessions-store.js";
+import { AudioSession } from "./audio-session.js";
+import { IntentDispatcher } from "./intent-dispatcher.js";
+import { HttpWhisperClient, NullWhisperClient } from "./stt.js";
+import { HookManager } from "./hooks.js";
+import { AttachedSessionHub } from "./attached.js";
+export async function startServer(opts = {}) {
+    const store = opts.store ?? new Store();
+    const state = store.load();
+    const projects = opts.projects ?? new ProjectsStore(store.dir);
+    const sessionsStore = opts.sessionsStore ?? new SessionsSnapshotStore(store.dir);
+    const bus = new EventBus();
+    // Forward-declared so the two managers can call into each other without a
+    // construction-time circular reference. Hook env is also resolved lazily —
+    // the URL isn't known until `server.listen()` binds a port (port 0 in tests).
+    let hooks;
+    let hookEnv;
+    const attached = new AttachedSessionHub();
+    const sessions = new SessionManager({
+        bus,
+        spawn: opts.spawnClaude,
+        defaultCwd: opts.defaultCwd,
+        idleArchiveMs: state.settings.idleArchiveMinutes * 60_000,
+        onTerminate: (sessionId, reason) => {
+            hooks?.cancelSession(sessionId, `session_${reason}`);
+        },
+        getHookEnv: () => hookEnv,
+        attachedHub: attached,
+    });
+    hooks = new HookManager({
+        bus,
+        onPendingChange: (sessionId, kind) => {
+            sessions.setHookStatus(sessionId, kind);
+        },
+    });
+    // Load — but do NOT yet hydrate. Hydration spawns `claude --resume` for every
+    // persisted active session, and each spawn needs the `BROKER_HOOKS_*` env vars
+    // baked in. Those vars depend on the bound URL, which isn't known until
+    // `server.listen()` returns. We defer the hydrate to after listen below.
+    const previousSnapshot = sessionsStore.load();
+    const persist = () => sessionsStore.save(sessions.snapshot());
+    const app = express();
+    app.use(express.json({ limit: '1mb' }));
+    app.use(corsMiddleware({ allowedOrigins: opts.allowedOrigins }));
+    // Public endpoint, registered before auth so it bypasses the bearer check.
+    app.get('/api/health', (_req, res) => {
+        res.json({ ok: true, version: '0.1.0' });
+    });
+    app.use(createBearerAuth(state.token));
+    registerRoutes(app, { bus, sessions, projects, hooks, persist });
+    const useHttp = opts.http ?? process.env.BROKER_HTTP === '1';
+    let server;
+    let protocol;
+    if (useHttp) {
+        server = http.createServer(app);
+        protocol = 'http';
+    }
+    else {
+        const cert = ensureCert(store.certDir(), state.settings.hostname);
+        server = https.createServer({ cert: cert.cert, key: cert.key }, app);
+        protocol = 'https';
+        if (cert.source !== 'reused') {
+            console.log(`[cert] generated ${cert.source} cert for ${state.settings.hostname}`);
+            console.log(`[cert]   cert: ${cert.certPath}`);
+            console.log(`[cert]   key : ${cert.keyPath}`);
+        }
+    }
+    const whisper = opts.whisper ??
+        (state.settings.whisper.url
+            ? new HttpWhisperClient({
+                url: state.settings.whisper.url,
+                model: state.settings.whisper.model,
+                language: state.settings.whisper.language,
+            })
+            : new NullWhisperClient());
+    const dispatcher = new IntentDispatcher({
+        sessions: {
+            create: o => {
+                const s = sessions.create(o);
+                return { id: s.id };
+            },
+            focus: id => sessions.focus(id),
+            writeInput: (id, text) => sessions.writeInput(id, text),
+            getFocusedId: () => sessions.getFocusedId(),
+            findActiveByProject: id => {
+                const s = sessions.findActiveByProject(id);
+                return s ? { id: s.id } : undefined;
+            },
+        },
+        onChange: persist,
+    });
+    const wss = new WebSocketServer({ noServer: true });
+    attachWsRouter(server, wss, state.token, bus, whisper, projects, dispatcher, sessions, attached);
+    const port = opts.port ?? Number(process.env.BROKER_PORT ?? state.settings.port);
+    const host = opts.host ?? process.env.BROKER_HOST ?? '0.0.0.0';
+    await new Promise((resolve, reject) => {
+        const onError = (err) => reject(err);
+        server.once('error', onError);
+        server.listen(port, host, () => {
+            server.off('error', onError);
+            resolve();
+        });
+    });
+    const addr = server.address();
+    const boundPort = typeof addr === 'object' && addr ? addr.port : port;
+    const url = `${protocol}://${state.settings.hostname}:${boundPort}`;
+    // Now that the listener is bound and the URL is known, plug the hook env
+    // into the SessionManager so every subsequent `claude` spawn has the
+    // BROKER_HOOKS_* vars the bundled helper script needs. For HTTPS we tell
+    // the helper to skip TLS verification — the broker's cert is mkcert- or
+    // selfsigned-issued and won't validate against Node's default CA bundle
+    // inside the helper script. This is scoped to the helper only.
+    hookEnv = {
+        url,
+        token: state.token,
+        insecure: protocol === 'https',
+    };
+    // Hydrate AFTER hookEnv is set so every resumed `claude` process inherits the
+    // BROKER_HOOKS_* env vars. Hydrating earlier (before listen) would respawn
+    // with no env vars, and the bundled `claude-hook.mjs` would then trip its
+    // safe-default deny path on every PreToolUse. Pinned by
+    // `broker/test/lifecycle.test.ts > hydrate runs after the URL is known`.
+    if (previousSnapshot.sessions.length > 0) {
+        sessions.hydrate(previousSnapshot);
+    }
+    if (!opts.noIdleArchiver) {
+        sessions.startIdleArchiver();
+    }
+    return {
+        app,
+        server,
+        bus,
+        sessions,
+        projects,
+        hooks,
+        attached,
+        url,
+        port: boundPort,
+        token: state.token,
+        protocol,
+        close: () => new Promise(resolve => {
+            wss.clients.forEach(c => {
+                try {
+                    c.close();
+                }
+                catch {
+                    // ignore
+                }
+            });
+            attached.closeAll('broker_shutdown');
+            hooks.cancelAll('broker_shutdown');
+            sessions.stopIdleArchiver();
+            void sessions.closeAll();
+            try {
+                persist();
+            }
+            catch {
+                // ignore — best-effort on shutdown
+            }
+            bus.closeAll();
+            server.close(() => resolve());
+        }),
+    };
+}
+function attachWsRouter(server, wss, token, bus, whisper, projects, dispatcher, sessions, attached) {
+    server.on('upgrade', (req, socket, head) => {
+        const url = new URL(req.url ?? '/', 'http://localhost');
+        const audioMatch = /^\/api\/sessions\/([^/]+)\/audio$/.exec(url.pathname);
+        const injectMatch = /^\/api\/sessions\/([^/]+)\/inject$/.exec(url.pathname);
+        if (!audioMatch && !injectMatch) {
+            socket.write('HTTP/1.1 404 Not Found\r\n\r\n');
+            socket.destroy();
+            return;
+        }
+        const presented = url.searchParams.get('token') ?? '';
+        if (!presented || !constantTimeEqual(presented, token)) {
+            socket.write('HTTP/1.1 401 Unauthorized\r\n\r\n');
+            socket.destroy();
+            return;
+        }
+        if (injectMatch) {
+            const sessionId = injectMatch[1];
+            // We don't require the session to exist *yet* — the wrapper may open the
+            // WS before the POST /api/sessions/attached round-trip completes in some
+            // races. We still gate on having a project though, to avoid an open WS
+            // from a stale token spamming the hub.
+            void sessions;
+            wss.handleUpgrade(req, socket, head, (ws) => {
+                attached.register(sessionId, ws);
+                ws.on('message', () => {
+                    // The wrapper currently only listens; if it ever sends an ack,
+                    // drop it silently rather than crash.
+                });
+                ws.send(JSON.stringify({ type: 'hello', sessionId, role: 'inject' }));
+            });
+            return;
+        }
+        const sessionId = audioMatch[1];
+        wss.handleUpgrade(req, socket, head, (ws) => {
+            let finalised = false;
+            const audio = new AudioSession(sessionId, {
+                stt: whisper,
+                listProjects: () => projects.list(),
+                onResult: result => {
+                    const outcome = handleAudioResult(result, dispatcher);
+                    // Best-effort send: the client may have already closed the WS.
+                    if (ws.readyState === ws.OPEN) {
+                        try {
+                            ws.send(JSON.stringify(outcome));
+                        }
+                        catch (err) {
+                            console.warn(`[audio] send result failed: ${err.message}`);
+                        }
+                    }
+                    publishVoiceEvents(bus, sessionId, result, outcome);
+                    // Close after the result has been queued so the client sees it before
+                    // the close event lands.
+                    if (ws.readyState === ws.OPEN) {
+                        try {
+                            ws.close(1000, 'audio_result sent');
+                        }
+                        catch {
+                            // ignore
+                        }
+                    }
+                },
+                onError: err => console.warn(`[audio] session=${sessionId} error: ${err.message}`),
+            });
+            const finalise = async () => {
+                if (finalised)
+                    return;
+                finalised = true;
+                try {
+                    await audio.close();
+                }
+                catch (err) {
+                    console.warn(`[audio] session=${sessionId} close failed: ${err.message}`);
+                }
+            };
+            ws.on('message', (data, isBinary) => {
+                // Text messages are control frames — currently only `{"type":"finalize"}`.
+                if (!isBinary) {
+                    const text = data.toString();
+                    try {
+                        const parsed = JSON.parse(text);
+                        if (parsed.type === 'finalize') {
+                            void finalise();
+                            return;
+                        }
+                    }
+                    catch {
+                        // ignore — unknown text frames are dropped.
+                    }
+                    return;
+                }
+                if (Array.isArray(data)) {
+                    for (const chunk of data)
+                        audio.pushFrame(chunk);
+                }
+                else if (Buffer.isBuffer(data)) {
+                    audio.pushFrame(data);
+                }
+                else {
+                    audio.pushFrame(Buffer.from(data));
+                }
+            });
+            ws.on('close', () => {
+                void finalise();
+            });
+            ws.on('error', () => {
+                void finalise();
+            });
+            ws.send(JSON.stringify({ type: 'hello', sessionId, milestone: 'M6' }));
+        });
+    });
+}
+function handleAudioResult(result, dispatcher) {
+    const outcome = dispatcher.dispatch(result.intent);
+    const msg = {
+        type: 'audio_result',
+        sessionId: result.sessionId,
+        transcript: result.transcript.text,
+        durationMs: result.durationMs,
+        bytes: result.bytes,
+        outcome,
+    };
+    if (result.transcript.language)
+        msg.language = result.transcript.language;
+    if (result.transcript.unavailable)
+        msg.unavailable = true;
+    if (result.transcript.reason)
+        msg.reason = result.transcript.reason;
+    return msg;
+}
+/**
+ * Mirror the audio result onto the session's SSE channel so a plugin that's
+ * subscribed to /events sees the voice command even when the WS isn't the
+ * primary control channel. Lets multiple clients (e.g. a future web admin UI)
+ * stay in sync without polling the WS.
+ */
+function publishVoiceEvents(bus, sessionId, result, outcome) {
+    bus.publish(`session:${sessionId}`, 'voice_transcript', {
+        text: result.transcript.text,
+        language: result.transcript.language,
+        unavailable: result.transcript.unavailable ?? false,
+        durationMs: result.durationMs,
+    });
+    bus.publish(`session:${sessionId}`, 'voice_intent', {
+        intent: result.intent,
+        outcome: outcome.outcome,
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/_broker/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/_broker/sessions-store.js

@@ -0,0 +1,50 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const DEFAULT_DIR = process.env.CLAUDE_HUD_DIR ?? path.join(os.homedir(), '.claude-hud');
+/**
+ * Atomic on-disk snapshot of the session registry.
+ *
+ * Kept separate from `Store` (which owns the broker bearer token + settings) so
+ * that high-frequency session-state writes don't churn the file that also holds
+ * the bearer token.
+ */
+export class SessionsSnapshotStore {
+    dir;
+    file;
+    constructor(dir = DEFAULT_DIR) {
+        this.dir = dir;
+        this.file = path.join(dir, 'sessions.json');
+    }
+    load() {
+        if (!fs.existsSync(this.file)) {
+            return { version: 1, sessions: [] };
+        }
+        try {
+            const parsed = JSON.parse(fs.readFileSync(this.file, 'utf8'));
+            return {
+                version: 1,
+                sessions: Array.isArray(parsed.sessions) ? parsed.sessions : [],
+                focusedId: typeof parsed.focusedId === 'string' ? parsed.focusedId : undefined,
+            };
+        }
+        catch (err) {
+            const backup = `${this.file}.corrupt-${Date.now()}`;
+            try {
+                fs.renameSync(this.file, backup);
+            }
+            catch {
+                // ignore — disk may be read-only in tests
+            }
+            console.warn(`[sessions-store] sessions.json was unreadable (${err.message}); moved to ${backup}`);
+            return { version: 1, sessions: [] };
+        }
+    }
+    save(snapshot) {
+        fs.mkdirSync(this.dir, { recursive: true });
+        const tmp = `${this.file}.tmp`;
+        fs.writeFileSync(tmp, `${JSON.stringify(snapshot, null, 2)}\n`, { mode: 0o600 });
+        fs.renameSync(tmp, this.file);
+    }
+}
+//# sourceMappingURL=sessions-store.js.map

package/dist/_broker/sessions-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions-store.js","sourceRoot":"","sources":["../src/sessions-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,MAAM,SAAS,CAAA;AAGxB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAA;AAExF;;;;;;GAMG;AACH,MAAM,OAAO,qBAAqB;IACvB,GAAG,CAAQ;IACX,IAAI,CAAQ;IAErB,YAAY,MAAc,WAAW;QACnC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAA;IAC7C,CAAC;IAED,IAAI;QACF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;QACrC,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAA0B,CAAA;YACtF,OAAO;gBACL,OAAO,EAAE,CAAC;gBACV,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;gBAC/D,SAAS,EAAE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;aAC/E,CAAA;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;YACnD,IAAI,CAAC;gBACH,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YAClC,CAAC;YAAC,MAAM,CAAC;gBACP,0CAA0C;YAC5C,CAAC;YACD,OAAO,CAAC,IAAI,CACV,kDAAmD,GAAa,CAAC,OAAO,eAAe,MAAM,EAAE,CAChG,CAAA;YACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;QACrC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,QAAsB;QACzB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC3C,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,MAAM,CAAA;QAC9B,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAChF,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;CACF"}