@kdonev/termscape 0.1.9 → 0.2.0

package/dist/supervisor.d.ts

@@ -0,0 +1,44 @@
+import { type ChildProcess } from 'node:child_process';
+import { type RestartPlan } from './update/restart.js';
+/**
+ * The process a terminal actually holds, when the hub can update itself.
+ *
+ * An update replaces the hub, and the hub cannot restart itself: the new one
+ * needs the old one's port, so the old one has to be gone first. Something
+ * has to outlive it, and this is that thing. It does nothing but run the hub
+ * as a child with the terminal passed straight through, and start whatever
+ * the hub left in its restart plan when it exits with EXIT_RESTART - so the
+ * terminal stays attached, logs keep printing, and Ctrl+C still stops it.
+ *
+ * It must stay this small. It never loads the hub, and so never loads a
+ * native module: on Windows a loaded .node cannot be replaced, and a global
+ * update has to replace exactly those files while this is still running.
+ */
+type Values = {
+    headless?: boolean;
+    join?: string;
+    version?: boolean;
+    help?: boolean;
+};
+/**
+ * Only an installed copy of the published package is supervised: that is the
+ * only kind that can update itself. A checkout, a joined machine (updated
+ * from its canvas, by an installer that expects to find the hub in hub.pid)
+ * and a headless hub all run exactly as before.
+ */
+export declare function shouldSupervise(values: Values, cliPath: string, env?: NodeJS.ProcessEnv): boolean;
+/** Tell the supervisor, if there is one, that this hub is exiting and how. */
+export declare function announceExit(code: number): Promise<void>;
+/** Run the hub, and every hub an update asks for after it, until one exits for good. */
+export declare function supervise(cliPath: string): Promise<never>;
+/**
+ * The loop itself: start a hub, and when it exits asking to be restarted,
+ * start what it left in its restart plan. Resolves with the exit code of the
+ * first hub that exits for any other reason.
+ */
+export declare function runHubs(first: RestartPlan, opts?: {
+    stdio?: Array<'ignore' | 'inherit' | 'pipe'>;
+    onChild?: (child: ChildProcess | null) => void;
+}): Promise<number>;
+export {};
+//# sourceMappingURL=supervisor.d.ts.map

package/dist/supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../src/supervisor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAiC,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGtF;;;;;;;;;;;;;GAaG;AAEH,KAAK,MAAM,GAAG;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAIT;AAuBD,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWxD;AAED,wFAAwF;AACxF,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAiB/D;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAC3B,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAA;CAAO,GAC1G,OAAO,CAAC,MAAM,CAAC,CAmDjB"}

package/dist/supervisor.js

@@ -0,0 +1,125 @@
+import { spawn } from 'node:child_process';
+import { EXIT_RESTART, takeRestartPlan } from './update/restart.js';
+import { isInstalledPackage } from './update/install.js';
+/**
+ * Only an installed copy of the published package is supervised: that is the
+ * only kind that can update itself. A checkout, a joined machine (updated
+ * from its canvas, by an installer that expects to find the hub in hub.pid)
+ * and a headless hub all run exactly as before.
+ */
+export function shouldSupervise(values, cliPath, env = process.env) {
+    if (env.TERMSCAPE_SUPERVISED === '1' || env.TERMSCAPE_NO_SUPERVISOR === '1')
+        return false;
+    if (values.version || values.help || values.headless || values.join)
+        return false;
+    return isInstalledPackage(cliPath);
+}
+/** How long a hub that said it is exiting gets to actually be gone. */
+const EXIT_GRACE_MS = 5_000;
+/**
+ * Stop a hub that is stuck on its way out, and anything it still holds. On
+ * Windows only taskkill reaches the whole tree; its agents' terminals were
+ * closed already, but a straggler would keep the new hub's files busy.
+ */
+function killTree(child) {
+    if (child.pid === undefined || child.exitCode !== null)
+        return;
+    console.error('[termscape] the hub did not exit; stopping it');
+    if (process.platform === 'win32') {
+        spawn('taskkill', ['/pid', String(child.pid), '/t', '/f'], {
+            stdio: 'ignore',
+            windowsHide: true,
+        });
+    }
+    else {
+        child.kill('SIGKILL');
+    }
+}
+/** Tell the supervisor, if there is one, that this hub is exiting and how. */
+export function announceExit(code) {
+    const send = process.send?.bind(process);
+    if (!send || !process.connected)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        // A supervisor that went away must not hold this exit up.
+        const timer = setTimeout(resolve, 500);
+        send({ t: 'exiting', code }, undefined, {}, () => {
+            clearTimeout(timer);
+            resolve();
+        });
+    });
+}
+/** Run the hub, and every hub an update asks for after it, until one exits for good. */
+export async function supervise(cliPath) {
+    let child = null;
+    // Ctrl+C reaches every process on the terminal, the hub included, and the
+    // hub is the one that decides what stopping means. This only waits for it.
+    process.on('SIGINT', () => { });
+    for (const sig of ['SIGTERM', 'SIGHUP']) {
+        process.on(sig, () => {
+            if (child)
+                child.kill(sig);
+            else
+                process.exit(1);
+        });
+    }
+    const code = await runHubs({ command: process.execPath, args: [...process.execArgv, cliPath, ...process.argv.slice(2)] }, { onChild: (c) => (child = c) });
+    process.exit(code);
+}
+/**
+ * The loop itself: start a hub, and when it exits asking to be restarted,
+ * start what it left in its restart plan. Resolves with the exit code of the
+ * first hub that exits for any other reason.
+ */
+export async function runHubs(first, opts = {}) {
+    // Anything left over from a restart that never happened is not ours to run.
+    takeRestartPlan();
+    const [stdin, stdout, stderr] = opts.stdio ?? ['inherit', 'inherit', 'inherit'];
+    let plan = first;
+    for (;;) {
+        const started = spawn(plan.command, plan.args, {
+            // The extra channel is how a hub says it is on its way out; see below.
+            stdio: [stdin, stdout, stderr, 'ipc'],
+            env: { ...process.env, ...plan.env, TERMSCAPE_SUPERVISED: '1' },
+        });
+        opts.onChild?.(started);
+        const code = await new Promise((resolve) => {
+            /*
+             * A hub announces its exit, and its code, before calling process.exit -
+             * because on Windows that call has been seen to never return once an
+             * agent's terminal had been open, leaving a process with its state
+             * saved and its port closed that nothing would ever restart. Past the
+             * grace period it is killed here, and its announced code stands.
+             */
+            let announced = null;
+            let watchdog = null;
+            started.on('message', (msg) => {
+                const m = msg;
+                if (m?.t !== 'exiting' || typeof m.code !== 'number' || watchdog)
+                    return;
+                announced = m.code;
+                watchdog = setTimeout(() => killTree(started), EXIT_GRACE_MS);
+            });
+            started.on('error', (err) => {
+                console.error(`[termscape] could not start the hub: ${err.message}`);
+                resolve(1);
+            });
+            started.on('exit', (c, signal) => {
+                if (watchdog)
+                    clearTimeout(watchdog);
+                resolve(announced ?? c ?? (signal ? 1 : 0));
+            });
+        });
+        opts.onChild?.(null);
+        if (code !== EXIT_RESTART)
+            return code;
+        const next = takeRestartPlan();
+        if (!next) {
+            console.error('[termscape] the hub asked to be restarted but left no plan; stopping');
+            return 1;
+        }
+        console.log('\n[termscape] restarting\n');
+        plan = next;
+    }
+}
+//# sourceMappingURL=supervisor.js.map

package/dist/supervisor.js.map

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

package/dist/update/host.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Update a machine joined to a canvas, to the build that canvas runs.
+ *
+ * It runs the canvas's own join installer again, which already knows how to
+ * do every part of this - stop the hub that is running (this one), swap the
+ * install while keeping the dependency tree where it can, start the new hub
+ * and wait for it to rejoin. The installer carries a fresh join key, but the
+ * host token already on disk is tried first, so this machine comes back as
+ * itself rather than as a second machine.
+ *
+ * The installer is started detached, because it outlives this process by
+ * design: the first thing it does is stop it. Its output goes to
+ * update.log beside the hub's own, which is the one place to look when a
+ * machine was told to update and never came back.
+ *
+ * Resolves once the installer is fetched and running.
+ */
+export declare function runHostUpdate(hubUrl: string, platform?: NodeJS.Platform): Promise<void>;
+//# sourceMappingURL=host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/update/host.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/dist/update/host.js

@@ -0,0 +1,56 @@
+import { spawn } from 'node:child_process';
+import { closeSync, openSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { paths } from '../paths.js';
+/**
+ * Update a machine joined to a canvas, to the build that canvas runs.
+ *
+ * It runs the canvas's own join installer again, which already knows how to
+ * do every part of this - stop the hub that is running (this one), swap the
+ * install while keeping the dependency tree where it can, start the new hub
+ * and wait for it to rejoin. The installer carries a fresh join key, but the
+ * host token already on disk is tried first, so this machine comes back as
+ * itself rather than as a second machine.
+ *
+ * The installer is started detached, because it outlives this process by
+ * design: the first thing it does is stop it. Its output goes to
+ * update.log beside the hub's own, which is the one place to look when a
+ * machine was told to update and never came back.
+ *
+ * Resolves once the installer is fetched and running.
+ */
+export async function runHostUpdate(hubUrl, platform = process.platform) {
+    const windows = platform === 'win32';
+    const origin = new URL(hubUrl).origin;
+    const res = await fetch(`${origin}/${windows ? 'join.ps1' : 'join.sh'}`, {
+        signal: AbortSignal.timeout(30_000),
+    });
+    if (!res.ok)
+        throw new Error(`the canvas answered ${res.status} for its installer`);
+    const script = await res.text();
+    const home = paths.home();
+    const file = join(home, windows ? 'update.ps1' : 'update.sh');
+    writeFileSync(file, script, { mode: 0o700 });
+    const log = openSync(join(home, 'update.log'), 'w');
+    try {
+        const [command, args] = windows
+            ? ['powershell.exe', ['-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-File', file]]
+            : ['sh', [file]];
+        const child = spawn(command, args, {
+            detached: true,
+            windowsHide: true,
+            stdio: ['ignore', log, log],
+            // The installer reads TERMSCAPE_HOME to find the install it replaces.
+            env: { ...process.env, TERMSCAPE_HOME: home },
+        });
+        await new Promise((resolve, reject) => {
+            child.once('spawn', () => resolve());
+            child.once('error', reject);
+        });
+        child.unref();
+    }
+    finally {
+        closeSync(log);
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/update/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/update/host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,WAA4B,OAAO,CAAC,QAAQ;IAE5C,MAAM,OAAO,GAAG,QAAQ,KAAK,OAAO,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IACtC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE;QACvE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;KACpC,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,MAAM,oBAAoB,CAAC,CAAC;IACpF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAEhC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAC9D,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAE7C,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,OAAO;YAC7B,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YACpG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QACnB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACjC,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC;YAC3B,sEAAsE;YACtE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE;SAC9C,CAAC,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/update/install.d.ts

@@ -0,0 +1,38 @@
+import type { InstallKind } from '../protocol/index.js';
+/** What the package is called on the registry. */
+export declare const PACKAGE_NAME = "@kdonev/termscape";
+/**
+ * Whether this file sits inside an installed copy of the published package,
+ * as opposed to a checkout. The one thing the supervisor needs to know, and it
+ * is decided from the path alone because the supervisor must not spend a
+ * second asking npm before the hub has even started.
+ */
+export declare function isInstalledPackage(cliPath: string): boolean;
+/**
+ * How this hub came to be running, which is how it can replace itself.
+ *
+ * A global install is told apart from a copy inside somebody's project by
+ * the shim npm puts beside it: `<prefix>/termscape.cmd` on Windows,
+ * `<prefix>/bin/termscape` beside `<prefix>/lib/node_modules` elsewhere. The
+ * project copy cannot be updated by `npm install -g`, which would install a
+ * second copy nothing runs.
+ *
+ * Read off the disk rather than asked of `npm root -g`, whose answer npm
+ * redacts: a path segment that looks like a token, a UUID say, comes back as
+ * `***` and then matches nothing.
+ */
+export declare function installKind(cliPath: string, opts: {
+    joined: boolean;
+    exists?: (p: string) => boolean;
+    platform?: NodeJS.Platform;
+}): InstallKind;
+/**
+ * npm's own entry point, run with this Node rather than through `npm` on the
+ * PATH: on Windows that is npm.cmd, which cannot be spawned without a shell,
+ * and a shell drags its quoting rules into every argument. Null when npm is
+ * not where Node's own distribution puts it.
+ */
+export declare function npmCliPath(nodeExe?: string): string | null;
+/** Run npm and collect its stdout. Rejects with its output on a non-zero exit. */
+export declare function runNpm(args: string[], timeoutMs?: number): Promise<string>;
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/update/install.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,kDAAkD;AAClD,eAAO,MAAM,YAAY,sBAAsB,CAAC;AAQhD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;CAAE,GACrF,WAAW,CAeb;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,SAAmB,GAAG,MAAM,GAAG,IAAI,CAOpE;AAED,kFAAkF;AAClF,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,SAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAoB9E"}

package/dist/update/install.js

@@ -0,0 +1,81 @@
+import { execFile } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { dirname, join, posix } from 'node:path';
+/** What the package is called on the registry. */
+export const PACKAGE_NAME = '@kdonev/termscape';
+/** A path compared the same way on every platform. */
+function norm(p) {
+    const slashed = p.replace(/\\/g, '/');
+    return process.platform === 'win32' ? slashed.toLowerCase() : slashed;
+}
+/**
+ * Whether this file sits inside an installed copy of the published package,
+ * as opposed to a checkout. The one thing the supervisor needs to know, and it
+ * is decided from the path alone because the supervisor must not spend a
+ * second asking npm before the hub has even started.
+ */
+export function isInstalledPackage(cliPath) {
+    return norm(cliPath).includes(`/node_modules/${PACKAGE_NAME}/`);
+}
+/**
+ * How this hub came to be running, which is how it can replace itself.
+ *
+ * A global install is told apart from a copy inside somebody's project by
+ * the shim npm puts beside it: `<prefix>/termscape.cmd` on Windows,
+ * `<prefix>/bin/termscape` beside `<prefix>/lib/node_modules` elsewhere. The
+ * project copy cannot be updated by `npm install -g`, which would install a
+ * second copy nothing runs.
+ *
+ * Read off the disk rather than asked of `npm root -g`, whose answer npm
+ * redacts: a path segment that looks like a token, a UUID say, comes back as
+ * `***` and then matches nothing.
+ */
+export function installKind(cliPath, opts) {
+    if (opts.joined)
+        return 'host';
+    if (!isInstalledPackage(cliPath))
+        return 'source';
+    if (norm(cliPath).includes('/_npx/'))
+        return 'npx';
+    const exists = opts.exists ?? existsSync;
+    const slashed = cliPath.replace(/\\/g, '/');
+    const at = slashed.toLowerCase().lastIndexOf(`/node_modules/${PACKAGE_NAME}/`);
+    const modules = slashed.slice(0, at + '/node_modules'.length);
+    const prefix = posix.dirname(modules);
+    const global = (opts.platform ?? process.platform) === 'win32'
+        ? exists(`${prefix}/termscape.cmd`)
+        : posix.basename(prefix) === 'lib' && exists(`${posix.dirname(prefix)}/bin/termscape`);
+    return global ? 'global' : 'source';
+}
+/**
+ * npm's own entry point, run with this Node rather than through `npm` on the
+ * PATH: on Windows that is npm.cmd, which cannot be spawned without a shell,
+ * and a shell drags its quoting rules into every argument. Null when npm is
+ * not where Node's own distribution puts it.
+ */
+export function npmCliPath(nodeExe = process.execPath) {
+    const dir = dirname(nodeExe);
+    const candidates = [
+        join(dir, 'node_modules', 'npm', 'bin', 'npm-cli.js'), // Windows layout
+        join(dir, '..', 'lib', 'node_modules', 'npm', 'bin', 'npm-cli.js'), // POSIX layout
+    ];
+    return candidates.find((p) => existsSync(p)) ?? null;
+}
+/** Run npm and collect its stdout. Rejects with its output on a non-zero exit. */
+export function runNpm(args, timeoutMs = 5 * 60_000) {
+    const cli = npmCliPath();
+    const [cmd, argv, shell] = cli
+        ? [process.execPath, [cli, ...args], false]
+        : ['npm', args, process.platform === 'win32'];
+    return new Promise((resolve, reject) => {
+        execFile(cmd, argv, { timeout: timeoutMs, shell, windowsHide: true, maxBuffer: 16 * 1024 * 1024 }, (err, stdout, stderr) => {
+            if (err) {
+                const detail = `${stderr}`.trim().split('\n').slice(-5).join('\n');
+                reject(new Error(`npm ${args[0]} failed: ${detail || err.message}`));
+                return;
+            }
+            resolve(`${stdout}`);
+        });
+    });
+}
+//# sourceMappingURL=install.js.map

package/dist/update/install.js.map

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

package/dist/update/post-install.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=post-install.d.ts.map

package/dist/update/post-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-install.d.ts","sourceRoot":"","sources":["../../src/update/post-install.ts"],"names":[],"mappings":""}

package/dist/update/post-install.js

@@ -0,0 +1,39 @@
+/**
+ * The step between a hub and its update, for a global install.
+ *
+ * Started by the supervisor once the old hub has exited - by then nothing
+ * holds the package's native modules open, which is what lets Windows replace
+ * them. It installs the release, then exits with EXIT_RESTART and a plan to
+ * start the hub from the same place it always ran from. If the install fails,
+ * the plan starts the old hub again instead, carrying the error so the canvas
+ * can say what happened rather than simply not having updated.
+ *
+ *   node post-install.js <version> <cli.js> [hub args...]
+ */
+import { spawnSync } from 'node:child_process';
+import { EXIT_RESTART, writeRestartPlan } from './restart.js';
+import { PACKAGE_NAME, npmCliPath } from './install.js';
+const [version, cliPath, ...args] = process.argv.slice(2);
+if (!version || !cliPath) {
+    console.error('usage: post-install.js <version> <cli.js> [hub args...]');
+    process.exit(1);
+}
+const spec = `${PACKAGE_NAME}@${version}`;
+console.log(`[termscape] installing ${spec}`);
+const npm = npmCliPath();
+const npmArgs = ['install', '-g', '--no-audit', '--no-fund', spec];
+const result = npm
+    ? spawnSync(process.execPath, [npm, ...npmArgs], { stdio: 'inherit' })
+    : spawnSync('npm', npmArgs, { stdio: 'inherit', shell: process.platform === 'win32' });
+const failed = result.error?.message ??
+    (result.status === 0 ? null : `npm install -g exited with ${result.status}`);
+if (failed) {
+    console.error(`[termscape] update failed: ${failed}; starting the version already installed`);
+}
+writeRestartPlan({
+    command: process.execPath,
+    args: [cliPath, ...args],
+    ...(failed ? { env: { TERMSCAPE_UPDATE_ERROR: `could not install ${spec}: ${failed}` } } : {}),
+});
+process.exit(EXIT_RESTART);
+//# sourceMappingURL=post-install.js.map

package/dist/update/post-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-install.js","sourceRoot":"","sources":["../../src/update/post-install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC1D,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACzB,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,IAAI,GAAG,GAAG,YAAY,IAAI,OAAO,EAAE,CAAC;AAC1C,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;AAC9C,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;AACzB,MAAM,OAAO,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;AACnE,MAAM,MAAM,GAAG,GAAG;IAChB,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACtE,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;AAEzF,MAAM,MAAM,GACV,MAAM,CAAC,KAAK,EAAE,OAAO;IACrB,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,8BAA8B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAC/E,IAAI,MAAM,EAAE,CAAC;IACX,OAAO,CAAC,KAAK,CAAC,8BAA8B,MAAM,0CAA0C,CAAC,CAAC;AAChG,CAAC;AAED,gBAAgB,CAAC;IACf,OAAO,EAAE,OAAO,CAAC,QAAQ;IACzB,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,sBAAsB,EAAE,qBAAqB,IAAI,KAAK,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CAC/F,CAAC,CAAC;AACH,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC"}

package/dist/update/restart.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The exit code a supervised hub uses to say "start me again, as the restart
+ * plan says". 75 is EX_TEMPFAIL: nothing else in the hub exits with it.
+ */
+export declare const EXIT_RESTART = 75;
+/** What the supervisor runs next, written by the hub on its way out. */
+export interface RestartPlan {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+}
+export declare function restartFile(): string;
+export declare function writeRestartPlan(plan: RestartPlan): void;
+/** Read and remove the plan, so a stale one can never start anything twice. */
+export declare function takeRestartPlan(): RestartPlan | null;
+/**
+ * The command line the updated hub starts with: the one this hub was given,
+ * pinned to the port and token it actually ended up with.
+ *
+ * Pinned because a canvas already open - in the app window about to be
+ * replaced, in a browser tab, on a phone - holds a URL with both in it, and
+ * reconnects to that URL on its own if the new hub is where the old one was.
+ * A browser tab needs no second tab opened beside it, so `--browser` becomes
+ * `--no-open` too; the app window closes with the hub that owned it and the
+ * new hub opens its own.
+ */
+export declare function restartArgs(argv: readonly string[], pin: {
+    port: number;
+    token: string;
+}): string[];
+//# sourceMappingURL=restart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restart.d.ts","sourceRoot":"","sources":["../../src/update/restart.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAExD;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,IAAI,WAAW,GAAG,IAAI,CAgBpD;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,CAcnG"}

package/dist/update/restart.js

@@ -0,0 +1,65 @@
+import { readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { paths } from '../paths.js';
+/**
+ * The exit code a supervised hub uses to say "start me again, as the restart
+ * plan says". 75 is EX_TEMPFAIL: nothing else in the hub exits with it.
+ */
+export const EXIT_RESTART = 75;
+export function restartFile() {
+    return join(paths.home(), 'restart.json');
+}
+export function writeRestartPlan(plan) {
+    writeFileSync(restartFile(), JSON.stringify(plan));
+}
+/** Read and remove the plan, so a stale one can never start anything twice. */
+export function takeRestartPlan() {
+    const file = restartFile();
+    let raw;
+    try {
+        raw = readFileSync(file, 'utf8');
+    }
+    catch {
+        return null;
+    }
+    rmSync(file, { force: true });
+    try {
+        const plan = JSON.parse(raw);
+        if (typeof plan.command !== 'string' || !Array.isArray(plan.args))
+            return null;
+        return plan;
+    }
+    catch {
+        return null;
+    }
+}
+const PINNED = ['--port', '--token'];
+/**
+ * The command line the updated hub starts with: the one this hub was given,
+ * pinned to the port and token it actually ended up with.
+ *
+ * Pinned because a canvas already open - in the app window about to be
+ * replaced, in a browser tab, on a phone - holds a URL with both in it, and
+ * reconnects to that URL on its own if the new hub is where the old one was.
+ * A browser tab needs no second tab opened beside it, so `--browser` becomes
+ * `--no-open` too; the app window closes with the hub that owned it and the
+ * new hub opens its own.
+ */
+export function restartArgs(argv, pin) {
+    const out = [];
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        const name = arg.split('=')[0];
+        if (PINNED.includes(name)) {
+            if (!arg.includes('='))
+                i++; // `--port 7777`: skip the value too
+            continue;
+        }
+        out.push(arg);
+    }
+    if (out.includes('--browser') && !out.includes('--no-open'))
+        out.push('--no-open');
+    out.push(`--port=${pin.port}`, `--token=${pin.token}`);
+    return out;
+}
+//# sourceMappingURL=restart.js.map

package/dist/update/restart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.js","sourceRoot":"","sources":["../../src/update/restart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAS/B,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,cAAc,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAiB;IAChD,aAAa,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;QAC5C,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/E,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,MAAM,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAErC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,IAAuB,EAAE,GAAoC;IACvF,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACrB,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QAChC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,CAAC,EAAE,CAAC,CAAC,oCAAoC;YACjE,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnF,GAAG,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,IAAI,EAAE,EAAE,WAAW,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IACvD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/update/resume.d.ts

@@ -0,0 +1,5 @@
+export declare function resumeFile(): string;
+export declare function saveResumeList(sessionIds: string[], now?: number): void;
+/** Read and remove the list, so it is acted on once. Empty when stale or absent. */
+export declare function takeResumeList(now?: number): string[];
+//# sourceMappingURL=resume.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../src/update/resume.ts"],"names":[],"mappings":"AAwBA,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,SAAa,GAAG,IAAI,CAG3E;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,GAAG,SAAa,GAAG,MAAM,EAAE,CAkBzD"}

package/dist/update/resume.js

@@ -0,0 +1,47 @@
+import { readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { paths } from '../paths.js';
+/**
+ * Which agents were running when a hub went down to be updated, so the hub
+ * that replaces it can bring exactly those back.
+ *
+ * Only an update writes this. Stopping a hub by hand is a decision about the
+ * agents too, and those come back stopped, as they always have.
+ */
+/**
+ * An update that never finished - an installer that failed, a machine that
+ * went to sleep halfway - must not resume agents at some unrelated start
+ * days later.
+ */
+const MAX_AGE_MS = 30 * 60_000;
+export function resumeFile() {
+    return join(paths.home(), 'resume.json');
+}
+export function saveResumeList(sessionIds, now = Date.now()) {
+    const list = { at: now, sessionIds };
+    writeFileSync(resumeFile(), JSON.stringify(list));
+}
+/** Read and remove the list, so it is acted on once. Empty when stale or absent. */
+export function takeResumeList(now = Date.now()) {
+    const file = resumeFile();
+    let raw;
+    try {
+        raw = readFileSync(file, 'utf8');
+    }
+    catch {
+        return [];
+    }
+    rmSync(file, { force: true });
+    try {
+        const list = JSON.parse(raw);
+        if (typeof list.at !== 'number' || now - list.at > MAX_AGE_MS)
+            return [];
+        return Array.isArray(list.sessionIds)
+            ? list.sessionIds.filter((id) => typeof id === 'string')
+            : [];
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=resume.js.map

package/dist/update/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../src/update/resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,UAAU,GAAG,EAAE,GAAG,MAAM,CAAC;AAO/B,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,aAAa,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,UAAoB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IACnE,MAAM,IAAI,GAAe,EAAE,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;IACjD,aAAa,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,cAAc,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAC7C,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwB,CAAC;QACpD,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,GAAG,GAAG,IAAI,CAAC,EAAE,GAAG,UAAU;YAAE,OAAO,EAAE,CAAC;QACzE,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;YACnC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC;YACtE,CAAC,CAAC,EAAE,CAAC;IACT,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}