@kdonev/termscape 0.1.8 → 0.2.0

package/dist/update/updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updater.d.ts","sourceRoot":"","sources":["../../src/update/updater.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,EAAW,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQhD,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,8DAA8D;IAC9D,UAAU,EAAE,OAAO,CAAC;IACpB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,WAAW,EAAE,MAAM,MAAM,EAAE,CAAC;IAC5B,mEAAmE;IACnE,OAAO,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IACrC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CACxE;AAED;;;;;;;GAOG;AACH,qBAAa,OAAQ,SAAQ,YAAY;IAM3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,KAAK,CAA+B;gBAEf,IAAI,EAAE,cAAc;IAMjD,IAAI,IAAI,UAAU;IAUlB,KAAK,IAAI,IAAI;IAWb,IAAI,IAAI,IAAI;IAKN,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAoCd,OAAO;IAgBrB,OAAO,CAAC,OAAO;CAGhB;AAED,0CAA0C;AAC1C,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAUnD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgB1E"}

package/dist/update/updater.js

@@ -0,0 +1,190 @@
+import { EventEmitter } from 'node:events';
+import { existsSync, readFileSync } from 'node:fs';
+import { delimiter, dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { isNewer } from '../protocol/index.js';
+import { debug } from '../debug.js';
+import { PACKAGE_NAME, runNpm } from './install.js';
+/** The first look waits for the hub to settle; the rest are far apart. */
+const FIRST_CHECK_MS = 10_000;
+const CHECK_EVERY_MS = 6 * 60 * 60_000;
+const DEFAULT_REGISTRY = 'https://registry.npmjs.org';
+/**
+ * Whether a newer termscape is out, and installing it on request.
+ *
+ * Checking is automatic and silent: a machine with no network, or a registry
+ * having a bad minute, costs nothing but a button that does not appear. What
+ * is never automatic is the restart. That takes every agent on this machine
+ * down with it, so it waits for someone to press the button.
+ */
+export class Updater extends EventEmitter {
+    opts;
+    latest = null;
+    state;
+    error;
+    timer = null;
+    constructor(opts) {
+        super();
+        this.opts = opts;
+        this.error = opts.initialError ?? null;
+        this.state = this.error ? 'failed' : 'idle';
+    }
+    info() {
+        return {
+            latest: this.latest,
+            kind: this.opts.kind,
+            canRestart: this.opts.canRestart,
+            state: this.state,
+            error: this.error,
+        };
+    }
+    start() {
+        if (this.timer)
+            return;
+        const tick = () => {
+            void this.check();
+            this.timer = setTimeout(tick, CHECK_EVERY_MS);
+            this.timer.unref();
+        };
+        this.timer = setTimeout(tick, FIRST_CHECK_MS);
+        this.timer.unref();
+    }
+    stop() {
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = null;
+    }
+    async check() {
+        try {
+            const latest = await (this.opts.fetchLatest ?? fetchLatest)();
+            if (latest === this.latest)
+                return;
+            this.latest = latest;
+            debug('update', `latest ${latest}, running ${this.opts.currentVersion}`);
+            this.changed();
+        }
+        catch (err) {
+            debug('update', `check failed: ${err.message}`);
+        }
+    }
+    /**
+     * Fetch the new release while this hub keeps running, then hand over.
+     * Throws - into the ack of whoever pressed the button - for anything that
+     * stops short of the restart.
+     */
+    async apply() {
+        const { kind, canRestart, currentVersion } = this.opts;
+        const target = this.latest;
+        if (target === null || !isNewer(target, currentVersion)) {
+            throw new Error('already up to date');
+        }
+        if (kind !== 'npx' && kind !== 'global') {
+            throw new Error('this hub was not installed from npm; update it the way it was installed');
+        }
+        if (!canRestart) {
+            throw new Error('this hub cannot restart itself; stop it and start termscape again once to enable updates');
+        }
+        if (this.state === 'downloading' || this.state === 'restarting') {
+            throw new Error('an update is already under way');
+        }
+        this.state = 'downloading';
+        this.error = null;
+        this.changed();
+        let plan;
+        try {
+            plan = await (this.opts.prepare ?? ((k, v) => this.prepare(k, v)))(kind, target);
+        }
+        catch (err) {
+            this.state = 'failed';
+            this.error = err.message;
+            this.changed();
+            throw err;
+        }
+        this.state = 'restarting';
+        this.changed();
+        // A moment for the ack and the broadcast to leave before the sockets go.
+        setTimeout(() => this.opts.restart(plan), 300);
+    }
+    async prepare(kind, version) {
+        const args = this.opts.restartArgs();
+        if (kind === 'npx') {
+            const cli = await fetchIntoNpxCache(version);
+            return { command: process.execPath, args: [cli, ...args] };
+        }
+        // A global install replaces files this hub holds open, which Windows
+        // refuses, so the install runs between this hub and the next one - from
+        // a script beside this file, started by the supervisor.
+        const script = join(dirname(fileURLToPath(import.meta.url)), 'post-install.js');
+        return {
+            command: process.execPath,
+            args: [script, version, this.opts.cliPath, ...args],
+        };
+    }
+    changed() {
+        this.emit('change', this.info());
+    }
+}
+/** The newest release on the registry. */
+export async function fetchLatest() {
+    const registry = (process.env.TERMSCAPE_UPDATE_REGISTRY ?? DEFAULT_REGISTRY).replace(/\/$/, '');
+    const res = await fetch(`${registry}/${PACKAGE_NAME}/latest`, {
+        headers: { accept: 'application/json' },
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!res.ok)
+        throw new Error(`registry answered ${res.status}`);
+    const body = (await res.json());
+    if (typeof body.version !== 'string')
+        throw new Error('registry sent no version');
+    return body.version;
+}
+/**
+ * Where a package fetched by `npm exec` lives, read off the PATH npm built
+ * for the command it ran: npm puts the package's own .bin on it, inside the
+ * npx cache. Null when no entry there holds this version.
+ */
+export function findNpxCli(pathVar, version) {
+    for (const entry of pathVar.split(delimiter)) {
+        if (!/[\\/]_npx[\\/]/.test(entry) || !/[\\/]\.bin[\\/]?$/.test(entry))
+            continue;
+        const pkgDir = join(entry, '..', ...PACKAGE_NAME.split('/'));
+        const cli = join(pkgDir, 'dist', 'cli.js');
+        if (!existsSync(cli))
+            continue;
+        try {
+            const manifest = JSON.parse(readFileSync(join(pkgDir, 'package.json'), 'utf8'));
+            if (manifest.version === version)
+                return cli;
+        }
+        catch {
+            // Not this one; keep looking.
+        }
+    }
+    return null;
+}
+/**
+ * Put a release into npx's cache and return the path of its cli.js.
+ *
+ * `npm exec` is what `npx` is, so this lands exactly where a fresh
+ * `npx @kdonev/termscape@<v>` would have. The new hub is then started with
+ * plain `node`, not through npm, which would otherwise sit between the
+ * supervisor and the hub for the rest of the session.
+ */
+async function fetchIntoNpxCache(version) {
+    const out = await runNpm([
+        'exec',
+        '--yes',
+        `--package=${PACKAGE_NAME}@${version}`,
+        '--',
+        'node',
+        '-p',
+        'process.env.PATH',
+    ]);
+    const lines = out.trim().split(/\r?\n/);
+    const cli = findNpxCli(lines[lines.length - 1] ?? '', version);
+    if (!cli) {
+        throw new Error(`npm fetched ${PACKAGE_NAME}@${version} but it is not in the npx cache`);
+    }
+    return cli;
+}
+//# sourceMappingURL=updater.js.map

package/dist/update/updater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updater.js","sourceRoot":"","sources":["../../src/update/updater.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAqC,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGpD,0EAA0E;AAC1E,MAAM,cAAc,GAAG,MAAM,CAAC;AAC9B,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;AAEvC,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;AAoBtD;;;;;;;GAOG;AACH,MAAM,OAAO,OAAQ,SAAQ,YAAY;IAMV;IALrB,MAAM,GAAkB,IAAI,CAAC;IAC7B,KAAK,CAAsB;IAC3B,KAAK,CAAgB;IACrB,KAAK,GAA0B,IAAI,CAAC;IAE5C,YAA6B,IAAoB;QAC/C,KAAK,EAAE,CAAC;QADmB,SAAI,GAAJ,IAAI,CAAgB;QAE/C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9C,CAAC;IAED,IAAI;QACF,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACpB,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;YAChC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,MAAM,IAAI,GAAG,GAAS,EAAE;YACtB,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YAC9C,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,KAAK;YAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,EAAE,CAAC;YAC9D,IAAI,MAAM,KAAK,IAAI,CAAC,MAAM;gBAAE,OAAO;YACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrB,KAAK,CAAC,QAAQ,EAAE,UAAU,MAAM,aAAa,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;YACzE,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,QAAQ,EAAE,iBAAkB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;QAC7F,CAAC;QACD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,aAAa,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,IAAiB,CAAC;QACtB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;YACtB,IAAI,CAAC,KAAK,GAAI,GAAa,CAAC,OAAO,CAAC;YACpC,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;QAC1B,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,yEAAyE;QACzE,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,IAAiB,EAAE,OAAe;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAC7C,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAC7D,CAAC;QACD,qEAAqE;QACrE,wEAAwE;QACxE,wDAAwD;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;QAChF,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,QAAQ;YACzB,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;SACpD,CAAC;IACJ,CAAC;IAEO,OAAO;QACb,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;CACF;AAED,0CAA0C;AAC1C,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChG,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,IAAI,YAAY,SAAS,EAAE;QAC5D,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;QACvC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;KACpC,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA0B,CAAC;IACzD,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAClF,OAAO,IAAI,CAAC,OAAO,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,OAAe;IACzD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,SAAS;QAChF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC/B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAE7E,CAAC;YACF,IAAI,QAAQ,CAAC,OAAO,KAAK,OAAO;gBAAE,OAAO,GAAG,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,iBAAiB,CAAC,OAAe;IAC9C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC;QACvB,MAAM;QACN,OAAO;QACP,aAAa,YAAY,IAAI,OAAO,EAAE;QACtC,IAAI;QACJ,MAAM;QACN,IAAI;QACJ,kBAAkB;KACnB,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,eAAe,YAAY,IAAI,OAAO,iCAAiC,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kdonev/termscape",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "Run a crew of AI coding agents on one infinite canvas, and let them talk to each other.",
   "license": "MIT",
   "author": "kdonev",