@detergent-software/conductor 0.0.0-stage → 1.0.0-dev.10

package/build/daemon.js

@@ -0,0 +1,182 @@
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { claudeCli } from "./claude.js";
+import { ping } from "./client.js";
+import { loadConfig } from "./config.js";
+import { ConductorError } from "./errors.js";
+import { inboxService } from "./inbox.js";
+import { acquirePidLock, processAlive } from "./lock.js";
+import { rotatingLog } from "./log.js";
+import { sessionManager } from "./manager.js";
+import { linearNotes, noteService } from "./notes.js";
+import { notifierService } from "./notify.js";
+import { pushoverSender } from "./pushover.js";
+import { registerProject } from "./registry.js";
+import { rulesService } from "./rules-service.js";
+import { createApi } from "./server.js";
+import { claudeProjectsDir } from "./spend.js";
+import { openStore } from "./store.js";
+import { windowsTerminalTab } from "./tab.js";
+import { ensureToken } from "./token.js";
+import { startWatchers } from "./watchers/index.js";
+import {} from "./watchers/source.js";
+import { gitWorktrees } from "./worktrees.js";
+// A pid file younger than this belongs to a daemon that may still be starting (it writes the pid
+// file before the port file), so a second start refuses even though nothing answers yet.
+const STARTUP_GRACE_MS = 30_000;
+// The pid file's process runs and either is still starting or answers the API. Checking the API too
+// matters after a reboot, when a stale pid file can name a pid some other process now has.
+export function daemonRunning(paths) {
+    return async ({ ageMs, pid }) => processAlive(pid) && (ageMs < STARTUP_GRACE_MS || (await ping(paths, pid)));
+}
+export async function startDaemon(paths, { keepaliveMs, ports = {}, version }) {
+    mkdirSync(paths.logs, { recursive: true });
+    const config = loadConfig(paths.config);
+    const lock = await acquirePidLock(paths.pid, daemonRunning(paths));
+    if (!lock.acquired)
+        throw new ConductorError(`already running (pid ${lock.pid})`);
+    const log = rotatingLog(paths.log, config.log);
+    let store;
+    let port = null;
+    try {
+        const token = ensureToken(paths.token);
+        const opened = openStore(paths.db);
+        store = opened;
+        let stopping;
+        let resolveClosed = () => { };
+        const closed = new Promise((resolve) => (resolveClosed = resolve));
+        const manager = sessionManager({
+            claude: ports.claude ?? claudeCli(),
+            config: config.sessions,
+            log,
+            openTab: ports.openTab ?? windowsTerminalTab(),
+            processAlive: ports.processAlive,
+            projectsDir: ports.projectsDir ?? claudeProjectsDir(),
+            runawayTokens: config.inbox.runawayTokens,
+            store: opened,
+            worktrees: ports.worktrees ?? gitWorktrees(),
+        });
+        // Before anything acts: its first load logs which rules are in force, and any file it refuses.
+        const rules = rulesService({
+            config,
+            emit: (event) => void opened.appendEvent(event),
+            listProjects: () => opened.listProjects(),
+            log,
+            paths,
+            updateProject: (project) => void opened.upsertProject(project),
+        });
+        const tracker = ports.noteTracker ?? linearNotes();
+        const inbox = inboxService({ onWaitResolved: () => void manager.sweep(), store: opened, tracker });
+        const notifier = notifierService({
+            config,
+            log,
+            pushover: ports.pushover ?? pushoverSender({ credential: config.notify.pushover.credential }),
+            store: opened,
+        });
+        // After the event that caused it, so an item's own events follow it on /events.
+        const stopObserving = opened.onEvent((event) => queueMicrotask(() => {
+            if (stopping)
+                return;
+            if (event.kind === 'project.added' || event.kind === 'project.updated') {
+                try {
+                    rules.reload();
+                }
+                catch (error) {
+                    log.log('error', 'the rules failed to reload', { error: String(error), event: event.id });
+                }
+            }
+            try {
+                inbox.observe(event);
+            }
+            catch (error) {
+                log.log('error', 'inbox failed on an event', { error: String(error), event: event.id, kind: event.kind });
+            }
+            notifier.observe(event).catch((error) => {
+                log.log('error', 'the notifier failed on an event', { error: String(error), event: event.id, kind: event.kind });
+            });
+        }));
+        const watchers = startWatchers({
+            config: config.watchers,
+            log,
+            // A resolved wait wakes its worker on the next sweep; run that sweep now.
+            onResolved: () => void manager.sweep(),
+            sources: ports.sources,
+            store: opened,
+        });
+        const api = createApi({
+            inbox,
+            keepaliveMs,
+            log,
+            manager,
+            notes: noteService({ store: opened, tracker }),
+            notifier,
+            registerProject: (path) => registerProject(opened, path, rules.checkProfile),
+            requestShutdown: () => void stop('api'),
+            rules,
+            store: opened,
+            token,
+        });
+        const stop = (reason) => {
+            stopping ??= (async () => {
+                opened.appendEvent({ data: { pid: process.pid, reason }, kind: 'daemon.stopped' });
+                log.log('info', 'stopping', { reason });
+                // Launches in flight carry on as processes of their own; a restart marks them failed.
+                rules.stop();
+                await watchers.stop();
+                await manager.stop();
+                stopObserving();
+                await notifier.stop();
+                api.endStreams();
+                await new Promise((resolve) => {
+                    api.server.close(() => resolve());
+                    api.server.closeAllConnections();
+                });
+                if (port !== null)
+                    removePortFile(paths, port);
+                opened.close();
+                lock.release();
+                resolveClosed();
+            })();
+            return stopping;
+        };
+        await new Promise((resolve, reject) => {
+            api.server.once('error', reject);
+            api.server.listen(config.port, '127.0.0.1', () => resolve());
+        });
+        port = addressOf(api.server.address()).port;
+        writeFileSync(paths.port, `${port}\n`);
+        opened.appendEvent({ data: { pid: process.pid, port, version }, kind: 'daemon.started' });
+        inbox.start();
+        rules.start();
+        notifier.start();
+        manager.start();
+        watchers.start();
+        log.log('info', 'started', { home: paths.home, pid: process.pid, port, version });
+        return { closed, log, port, stop };
+    }
+    catch (error) {
+        store?.close();
+        if (port !== null)
+            removePortFile(paths, port);
+        lock.release();
+        log.log('error', 'start failed', { error: String(error) });
+        throw error;
+    }
+}
+function addressOf(address) {
+    if (address === null || typeof address === 'string')
+        throw new Error('the API is not listening on TCP');
+    return address;
+}
+// Only the daemon that wrote the port file removes it, so a stopping daemon never deletes the file
+// of one that replaced it.
+function removePortFile(paths, port) {
+    try {
+        if (readFileSync(paths.port, 'utf8').trim() !== String(port))
+            return;
+    }
+    catch {
+        return;
+    }
+    rmSync(paths.port, { force: true });
+}
+//# sourceMappingURL=daemon.js.map

package/build/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAIzE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAkB,YAAY,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAe,WAAW,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAoB,cAAc,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAoB,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAqB,cAAc,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAc,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAe,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,iGAAiG;AACjG,yFAAyF;AACzF,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAiBhC,oGAAoG;AACpG,2FAA2F;AAC3F,MAAM,UAAU,aAAa,CAAC,KAAqB;IACjD,OAAO,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,gBAAgB,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AAC/G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAqB,EACrB,EAAE,WAAW,EAAE,KAAK,GAAG,EAAE,EAAE,OAAO,EAAmE;IAErG,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,cAAc,CAAC,wBAAwB,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;IAElF,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,KAAwB,CAAC;IAC7B,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnC,KAAK,GAAG,MAAM,CAAC;QACf,IAAI,QAAmC,CAAC;QACxC,IAAI,aAAa,GAAG,GAAS,EAAE,GAAE,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;QAEzE,MAAM,OAAO,GAAG,cAAc,CAAC;YAC7B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,SAAS,EAAE;YACnC,MAAM,EAAE,MAAM,CAAC,QAAQ;YACvB,GAAG;YACH,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,kBAAkB,EAAE;YAC9C,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,iBAAiB,EAAE;YACrD,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,aAAa;YACzC,KAAK,EAAE,MAAM;YACb,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,YAAY,EAAE;SAC7C,CAAC,CAAC;QAEH,+FAA+F;QAC/F,MAAM,KAAK,GAAG,YAAY,CAAC;YACzB,MAAM;YACN,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC;YAC/C,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE;YACzC,GAAG;YACH,KAAK;YACL,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC;SAC/D,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,IAAI,WAAW,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QACnG,MAAM,QAAQ,GAAG,eAAe,CAAC;YAC/B,MAAM;YACN,GAAG;YACH,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,cAAc,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC7F,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QACH,gFAAgF;QAChF,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAC7C,cAAc,CAAC,GAAG,EAAE;YAClB,IAAI,QAAQ;gBAAE,OAAO;YACrB,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACvE,IAAI,CAAC;oBACH,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,4BAA4B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC5F,CAAC;YACH,CAAC;YACD,IAAI,CAAC;gBACH,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,0BAA0B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5G,CAAC;YACD,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAC/C,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,iCAAiC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACnH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,QAAQ,GAAG,aAAa,CAAC;YAC7B,MAAM,EAAE,MAAM,CAAC,QAAQ;YACvB,GAAG;YACH,0EAA0E;YAC1E,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,KAAK,EAAE;YACtC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,SAAS,CAAC;YACpB,KAAK;YACL,WAAW;YACX,GAAG;YACH,OAAO;YACP,KAAK,EAAE,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YAC9C,QAAQ;YACR,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC;YAC5E,eAAe,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC;YACvC,KAAK;YACL,KAAK,EAAE,MAAM;YACb,KAAK;SACN,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,CAAC,MAAc,EAAiB,EAAE;YAC7C,QAAQ,KAAK,CAAC,KAAK,IAAI,EAAE;gBACvB,MAAM,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;gBACnF,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;gBACxC,sFAAsF;gBACtF,KAAK,CAAC,IAAI,EAAE,CAAC;gBACb,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACtB,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;gBACrB,aAAa,EAAE,CAAC;gBAChB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACtB,GAAG,CAAC,UAAU,EAAE,CAAC;gBACjB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;oBAClC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;oBAClC,GAAG,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;gBACnC,CAAC,CAAC,CAAC;gBACH,IAAI,IAAI,KAAK,IAAI;oBAAE,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBAC/C,MAAM,CAAC,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,aAAa,EAAE,CAAC;YAClB,CAAC,CAAC,EAAE,CAAC;YACL,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC;QAEF,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACjC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QACH,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC;QAC5C,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC;QACvC,MAAM,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC1F,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAClF,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,EAAE,KAAK,EAAE,CAAC;QACf,IAAI,IAAI,KAAK,IAAI;YAAE,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3D,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,OAAoC;IACrD,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACxG,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,mGAAmG;AACnG,2BAA2B;AAC3B,SAAS,cAAc,CAAC,KAAqB,EAAE,IAAY;IACzD,IAAI,CAAC;QACH,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC,IAAI,CAAC;YAAE,OAAO;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/build/errors.js

@@ -0,0 +1,17 @@
+// An error the user can act on: the CLI prints its message and exits 1, without a stack.
+export class ConductorError extends Error {
+    details;
+    constructor(message, details = []) {
+        super(message);
+        this.name = 'ConductorError';
+        this.details = details;
+    }
+}
+// A Node system error with the given code, such as ENOENT or EEXIST.
+export function hasCode(error, code) {
+    return error instanceof Error && 'code' in error && error.code === code;
+}
+export function isMissing(error) {
+    return hasCode(error, 'ENOENT');
+}
+//# sourceMappingURL=errors.js.map

package/build/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,OAAO,CAAoB;IAEpC,YAAY,OAAe,EAAE,UAA6B,EAAE;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,UAAU,OAAO,CAAC,KAAc,EAAE,IAAY;IAClD,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC"}

package/build/events.js

@@ -0,0 +1,106 @@
+import { NotRunningError, readEndpoint } from "./client.js";
+import { ConductorError } from "./errors.js";
+// The daemon writes this comment once a stream's replay is out and live events follow.
+const CONNECTED = ': connected';
+const RETRY_MS = [1000, 2000, 5000];
+// `conduct events [--since <id>] [--follow]`: the event log, one JSON event per line. Without
+// --follow it prints the events after --since (all of them without it) and exits. With --follow it
+// starts after --since (live without it), keeps the stream open, and reconnects with Last-Event-ID
+// when the daemon goes away, so a restart loses nothing. --follow also prints the stream's state
+// as lines without an id, `{"kind":"conduct.connected"}` and `{"kind":"conduct.disconnected",
+// "error":…}`, which the conductor mod reads to refetch or clear what it shows.
+export async function eventsCommand(paths, options, io) {
+    // Ends early on the signal, so Ctrl+C doesn't wait out a retry while the daemon is down.
+    const sleep = io.sleep ??
+        ((ms) => new Promise((done) => {
+            const timer = setTimeout(done, ms);
+            io.signal?.addEventListener('abort', () => (clearTimeout(timer), done()), { once: true });
+        }));
+    let last = options.since ?? null;
+    if (!options.follow) {
+        await readStream(paths, last ?? 0, { onEvent: (line) => io.out(line), signal: io.signal, untilConnected: true });
+        return;
+    }
+    let failures = 0;
+    let connected = false;
+    while (!io.signal?.aborted) {
+        let error;
+        try {
+            await readStream(paths, last, {
+                onConnected: () => {
+                    connected = true;
+                    failures = 0;
+                    io.out(JSON.stringify({ kind: 'conduct.connected' }));
+                },
+                onEvent: (line, id) => {
+                    last = id;
+                    io.out(line);
+                },
+                signal: io.signal,
+                untilConnected: false,
+            });
+            error = 'the conductor closed the stream';
+        }
+        catch (caught) {
+            if (io.signal?.aborted)
+                break;
+            error = caught instanceof Error ? caught.message : String(caught);
+        }
+        if (io.signal?.aborted)
+            break;
+        // Said once per outage, not on every retry while the daemon stays down.
+        if (connected || failures === 0)
+            io.out(JSON.stringify({ error, kind: 'conduct.disconnected' }));
+        connected = false;
+        await sleep(RETRY_MS[Math.min(failures, RETRY_MS.length - 1)] ?? 5000);
+        failures++;
+    }
+}
+// Reads one connection of GET /events: from `since` (Last-Event-ID), or live when it is null.
+async function readStream(paths, since, handlers) {
+    const endpoint = readEndpoint(paths);
+    if (!endpoint)
+        throw new NotRunningError();
+    let response;
+    try {
+        response = await fetch(`http://127.0.0.1:${endpoint.port}/events`, {
+            headers: { authorization: `Bearer ${endpoint.token}`, ...(since === null ? {} : { 'last-event-id': String(since) }) },
+            signal: handlers.signal,
+        });
+    }
+    catch (error) {
+        throw new ConductorError(`the conductor on port ${endpoint.port} did not answer GET /events`, [String(error)]);
+    }
+    if (response.status === 404)
+        throw new ConductorError('the running conductor has no event stream: it is older than this conduct');
+    if (response.status !== 200 || !response.body)
+        throw new ConductorError(`GET /events answered ${response.status}`);
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                return;
+            buffer += decoder.decode(value, { stream: true }).replaceAll('\r\n', '\n');
+            for (let end = buffer.indexOf('\n\n'); end >= 0; end = buffer.indexOf('\n\n')) {
+                const frame = buffer.slice(0, end).split('\n');
+                buffer = buffer.slice(end + 2);
+                if (frame.includes(CONNECTED)) {
+                    handlers.onConnected?.();
+                    if (handlers.untilConnected)
+                        return;
+                }
+                const id = frame.find((l) => l.startsWith('id: '))?.slice('id: '.length);
+                const data = frame.find((l) => l.startsWith('data: '))?.slice('data: '.length);
+                if (id !== undefined && data !== undefined)
+                    handlers.onEvent(data, Number(id));
+            }
+        }
+    }
+    finally {
+        await reader.cancel().catch(() => { });
+    }
+}
+//# sourceMappingURL=events.js.map

package/build/events.js.map

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