@openagt/servers 0.0.0-stage → 0.0.1

package/dist/dashboard/dashboard.js

@@ -0,0 +1,438 @@
+import { Button as e, Checkbox as t, Input as n, SettingsSection as r, defineModule as i, useModuleHost as a, usePolled as o } from "@openagt/dashboard/module";
+import { useEffect as s, useRef as c, useState as l } from "react";
+import { jsx as u, jsxs as d } from "react/jsx-runtime";
+//#region dashboard/servers.ts
+var f = (e) => typeof e == "string" && e ? e : void 0, p = [
+	"waiting",
+	"running",
+	"done",
+	"failed"
+];
+function m(e) {
+	let { there: t, working: n, asking: r, wanted: i, account: a, since: o, ends: s, said: c } = e && typeof e == "object" ? e : {}, [l, u, d, p] = [
+		f(a),
+		f(o),
+		f(s),
+		f(c)
+	];
+	return {
+		there: t === !0,
+		working: n === !0,
+		...r === !0 ? { asking: !0 } : {},
+		...i === !0 ? { wanted: !0 } : {},
+		...l ? { account: l } : {},
+		...u ? { since: u } : {},
+		...d ? { ends: d } : {},
+		...p ? { said: p } : {}
+	};
+}
+function h(e) {
+	if (!e || typeof e != "object") return;
+	let { servers: t } = e;
+	if (!Array.isArray(t)) return;
+	let n = [];
+	for (let e of t) {
+		if (!e || typeof e != "object") continue;
+		let { address: t, url: r, user: i, fingerprint: a, working: o, adding: s, steps: c, logins: l } = e, { github: u, claude: d } = l && typeof l == "object" ? l : {}, [h, g, _, v] = [
+			f(t),
+			f(r),
+			f(i),
+			f(a)
+		];
+		if (!h || !g || !_ || !Array.isArray(c)) continue;
+		let y = [];
+		for (let e of c) {
+			if (!e || typeof e != "object") continue;
+			let { id: t, label: n, state: r, said: i } = e, [a, o, s] = [
+				f(t),
+				f(n),
+				f(i)
+			];
+			a && o && p.includes(r) && y.push({
+				id: a,
+				label: o,
+				state: r,
+				...s ? { said: s } : {}
+			});
+		}
+		n.push({
+			address: h,
+			url: g,
+			user: _,
+			...v ? { fingerprint: v } : {},
+			working: o === !0,
+			adding: s === !0,
+			steps: y,
+			logins: {
+				github: m(u),
+				claude: m(d)
+			}
+		});
+	}
+	return n;
+}
+function g(e) {
+	if (!e || typeof e != "object") return;
+	let { url: t, expires: n } = e, [r, i] = [f(t), f(n)];
+	return r && i ? {
+		url: r,
+		expires: i
+	} : void 0;
+}
+async function _(e, t, n, r) {
+	let i = {
+		ok: !1,
+		error: "no project to run the command in"
+	};
+	for (let [a, o] of t.entries()) {
+		let t = await e.runCommand(o.id, n).catch((e) => ({
+			ok: !1,
+			error: e instanceof Error ? e.message : String(e)
+		}));
+		if (t.ok) {
+			let e = r(t.output);
+			return e === void 0 ? {
+				ok: !1,
+				error: "the command answered something else than expected"
+			} : {
+				ok: !0,
+				value: e
+			};
+		}
+		a === 0 && (i = t);
+	}
+	return i;
+}
+var v = (e, t) => _(e, t, ["status"], h), y = (e, t, n, r, i, a = !1) => _(e, t, [
+	"connect",
+	n,
+	r,
+	i,
+	...a ? ["github"] : []
+], h);
+function b(e) {
+	if (!e || typeof e != "object") return;
+	let { account: t, problem: n } = e, [r, i] = [f(t), f(n)];
+	return r ? { account: r } : i ? { problem: i } : void 0;
+}
+var ee = (e, t) => _(e, t, ["github"], b), x = (e, t, n, r) => _(e, t, [
+	"login",
+	n,
+	r
+], h), S = (e, t, n, r) => _(e, t, [
+	"logout",
+	n,
+	r
+], h), C = (e, t, n) => _(e, t, ["link", n], g), w = (e, t, n) => _(e, t, ["added", n], h), T = (e, t, n) => _(e, t, ["forget", n], h), E = void 0, te = void 0, ne = void 0, D = (e) => e === void 0 ? "" : new Date(e).toLocaleDateString(void 0, {
+	day: "numeric",
+	month: "short",
+	year: "numeric"
+});
+function O({ label: e, words: t, said: n, children: r }) {
+	return /* @__PURE__ */ d("li", {
+		"aria-label": e,
+		className: "space-y-1",
+		children: [/* @__PURE__ */ d("div", {
+			className: "flex flex-wrap items-center justify-between gap-2",
+			children: [/* @__PURE__ */ u("span", { children: t }), /* @__PURE__ */ u("div", {
+				className: "flex gap-2",
+				children: r
+			})]
+		}), n !== void 0 && /* @__PURE__ */ u("pre", {
+			role: "alert",
+			className: "overflow-x-auto whitespace-pre-wrap rounded-md border border-border bg-background p-2 font-mono text-foreground",
+			children: n
+		})]
+	});
+}
+var k = {
+	waiting: "○",
+	running: "…",
+	done: "✓",
+	failed: "✕"
+}, re = {
+	waiting: "not started",
+	running: "running",
+	done: "done",
+	failed: "failed"
+}, A = (e, t) => Object.fromEntries(Object.entries(e).filter(([e]) => e !== t));
+function j(e, t) {
+	let n = (e) => {
+		let t = /^(\d+)\.(\d+)\.(\d+)/.exec(e);
+		return t ? t.slice(1).map(Number) : void 0;
+	}, [r, i] = [n(e), n(t)];
+	if (!r || !i) return !1;
+	for (let e = 0; e < 3; e++) if (r[e] !== i[e]) return r[e] < i[e];
+	return !1;
+}
+function M({ projects: i, everyMs: f = 3e3 }) {
+	let p = a(), m = i.map((e) => e.id).join(","), { value: h, reload: g } = o(() => v(p, i), E, f, [m]), { value: _, reload: b } = o(() => p.machines(), te, Math.max(f, 1e4), []), { value: M } = o(() => ee(p, i), ne, Math.max(f, 5 * 6e4), [m]), N = M?.ok && "account" in M.value ? M.value.account : void 0, P = M === void 0 || N !== void 0 ? void 0 : M.ok ? "problem" in M.value ? M.value.problem : void 0 : M.error, [F, I] = l(""), [L, R] = l("root"), [z, B] = l(!1), [V, H] = l(!1), [U, W] = l(), [G, K] = l({}), q = c(/* @__PURE__ */ new Set()), J = h?.ok ? h.value : [], Y = (e, t = _) => t?.machines.find((t) => t.url === e.url), X = (e) => !e.working && e.steps.every((e) => e.state === "done"), Z = async (e) => {
+		H(!0), W(void 0);
+		let t = await e();
+		return t.ok || W(t.error), await g().catch(() => {}), H(!1), t.ok;
+	}, Q = async (e, t, n = !1) => !_ || _.version === "unknown" ? (W("This computer could not say which OpenAgent it runs."), !1) : (K((t) => A(t, e)), Z(() => y(p, i, e, t, _.version, n))), $ = async (e) => {
+		if (q.current.has(e.address)) return;
+		q.current.add(e.address), K((t) => A(t, e.address));
+		let t = (t) => K((n) => ({
+			...n,
+			[e.address]: t
+		}));
+		try {
+			if (Y(e, await p.machines())?.version === void 0) {
+				let n = await C(p, i, e.address), r = n.ok ? await p.addMachine(n.value.url, e.address) : n;
+				if (!r.ok) return t(r.error);
+			}
+			let n = await w(p, i, e.address);
+			if (!n.ok) return t(n.error);
+			await Promise.all([g(), b()]).catch(() => {});
+		} catch (e) {
+			t(e instanceof Error ? e.message : String(e));
+		} finally {
+			q.current.delete(e.address);
+		}
+	};
+	return s(() => {
+		if (_) for (let e of J) e.adding && X(e) && G[e.address] === void 0 && $(e);
+	}), i.length === 0 ? null : /* @__PURE__ */ d(r, {
+		title: "Servers",
+		description: "Connect your VPS: give its address and a user name, and OpenAgent installs itself there over SSH, with this computer's own SSH keys. The server then runs OpenAgent by itself, and is one of your machines.",
+		children: [
+			/* @__PURE__ */ d("form", {
+				onSubmit: (e) => {
+					e.preventDefault(), !(!F.trim() || !L.trim()) && Q(F.trim(), L.trim(), z && N !== void 0).then((e) => e && I(""));
+				},
+				className: "flex flex-wrap items-end gap-2 py-3",
+				children: [
+					/* @__PURE__ */ d("label", {
+						className: "min-w-40 flex-1 space-y-1 text-xs text-muted-foreground",
+						children: [/* @__PURE__ */ u("span", { children: "The server's address" }), /* @__PURE__ */ u(n, {
+							"aria-label": "The server's address",
+							placeholder: "203.0.113.5",
+							value: F,
+							onChange: (e) => I(e.target.value)
+						})]
+					}),
+					/* @__PURE__ */ d("label", {
+						className: "w-32 space-y-1 text-xs text-muted-foreground",
+						children: [/* @__PURE__ */ u("span", { children: "User name" }), /* @__PURE__ */ u(n, {
+							"aria-label": "User name",
+							value: L,
+							onChange: (e) => R(e.target.value)
+						})]
+					}),
+					/* @__PURE__ */ u(e, {
+						size: "sm",
+						type: "submit",
+						disabled: V || !_ || !F.trim() || !L.trim(),
+						children: "Connect"
+					})
+				]
+			}),
+			/* @__PURE__ */ d("div", {
+				className: "space-y-2 pb-3",
+				children: [/* @__PURE__ */ d("label", {
+					className: "flex items-start gap-2 text-xs",
+					children: [/* @__PURE__ */ u(t, {
+						checked: z && N !== void 0,
+						onCheckedChange: (e) => B(e === !0),
+						disabled: V || N === void 0,
+						className: "mt-0.5",
+						"aria-label": "Copy my GitHub login to the server"
+					}), /* @__PURE__ */ d("span", { children: [
+						N === void 0 ? "Copy my GitHub login to the server." : `Copy my GitHub login (${N}) to the server.`,
+						" ",
+						/* @__PURE__ */ u("span", {
+							className: "text-muted-foreground",
+							children: P ?? "It can do there all it can do here, and every agent that runs on the server works with it. It goes there at the install's end, to a server met for the first time too, whose key is taken as it is."
+						})
+					] })]
+				}), /* @__PURE__ */ u("p", {
+					className: "text-xs text-muted-foreground",
+					children: "The user is root, or one that becomes root without a password. It is only used to install, to update and to give the server its logins: what runs on the server afterwards runs as a user of its own, openagent."
+				})]
+			}),
+			J.length > 0 && /* @__PURE__ */ u("ul", {
+				"aria-label": "Servers",
+				className: "divide-y divide-border",
+				children: J.map((t) => {
+					let n = Y(t), r = !t.working && t.steps.some((e) => e.state === "failed"), a = n?.version !== void 0 && _ !== void 0 && j(n.version, _.version), o = G[t.address], { github: s, claude: c } = t.logins;
+					return /* @__PURE__ */ d("li", {
+						"aria-label": t.address,
+						className: "space-y-2 py-3",
+						children: [
+							/* @__PURE__ */ d("div", {
+								className: "flex flex-wrap items-center justify-between gap-2",
+								children: [/* @__PURE__ */ d("div", {
+									className: "min-w-0",
+									children: [/* @__PURE__ */ u("p", {
+										className: "truncate text-sm",
+										children: t.address
+									}), /* @__PURE__ */ u("p", {
+										className: "text-xs text-muted-foreground",
+										children: t.working ? "OpenAgent is being installed." : n?.version === void 0 ? n ? "Does not answer right now." : X(t) && !t.adding ? "Installed, and not among your machines." : `Logs in as ${t.user}.` : a ? `OpenAgent ${n.version}: behind this computer, which runs ${_.version}.` : `OpenAgent ${n.version}.`
+									})]
+								}), /* @__PURE__ */ d("div", {
+									className: "flex gap-2",
+									children: [
+										a && !t.working && !r && /* @__PURE__ */ u(e, {
+											size: "sm",
+											disabled: V,
+											"aria-label": `Update ${t.address}`,
+											onClick: () => void Q(t.address, t.user),
+											children: "Update"
+										}),
+										r && /* @__PURE__ */ u(e, {
+											size: "sm",
+											disabled: V,
+											"aria-label": `Try ${t.address} again`,
+											onClick: () => void Q(t.address, t.user, s.wanted === !0),
+											children: "Try again"
+										}),
+										X(t) && n?.version === void 0 && (o !== void 0 || !t.adding) && /* @__PURE__ */ u(e, {
+											size: "sm",
+											variant: "outline",
+											disabled: V,
+											"aria-label": `Add ${t.address} to Machines`,
+											onClick: () => void $(t),
+											children: n ? "Add again" : "Add to Machines"
+										}),
+										!t.working && /* @__PURE__ */ u(e, {
+											size: "sm",
+											variant: "outline",
+											disabled: V,
+											"aria-label": `Remove ${t.address}`,
+											title: "Takes the server off this list. Nothing is changed on the server: its logins stay there until you remove them.",
+											onClick: () => void Z(() => T(p, i, t.address)),
+											children: "Remove"
+										})
+									]
+								})]
+							}),
+							/* @__PURE__ */ d("ol", {
+								"aria-label": `The install on ${t.address}`,
+								className: "space-y-1 text-xs",
+								children: [
+									t.steps.map((e) => /* @__PURE__ */ d("li", {
+										"aria-label": `${e.label}: ${re[e.state]}`,
+										children: [
+											/* @__PURE__ */ d("span", {
+												className: e.state === "failed" ? "text-danger" : e.state === "waiting" ? "text-muted-foreground" : void 0,
+												children: [/* @__PURE__ */ u("span", {
+													"aria-hidden": !0,
+													className: "inline-block w-4",
+													children: k[e.state]
+												}), e.label]
+											}),
+											e.id === "login" && e.state === "done" && t.fingerprint !== void 0 && /* @__PURE__ */ u("span", {
+												className: "ml-2 font-mono text-muted-foreground",
+												children: `The server's key: ${t.fingerprint}`
+											}),
+											e.said !== void 0 && e.state === "failed" && /* @__PURE__ */ u("pre", {
+												role: "alert",
+												className: "mt-1 ml-4 overflow-x-auto whitespace-pre-wrap rounded-md border border-border bg-background p-2 font-mono text-foreground",
+												children: e.said
+											})
+										]
+									}, e.id)),
+									t.logins.github.working && /* @__PURE__ */ d("li", {
+										"aria-label": "Your GitHub login: not copied yet",
+										className: "text-muted-foreground",
+										children: [/* @__PURE__ */ u("span", {
+											"aria-hidden": !0,
+											className: "inline-block w-4",
+											children: k[t.steps.every((e) => e.state === "done") ? "running" : "waiting"]
+										}), "Your GitHub login"]
+									}),
+									X(t) && /* @__PURE__ */ d("li", {
+										"aria-label": `Among your machines: ${n ? "done" : o === void 0 ? t.adding ? "running" : "not started" : "failed"}`,
+										children: [/* @__PURE__ */ d("span", {
+											className: n ? void 0 : o === void 0 ? "text-muted-foreground" : "text-danger",
+											children: [/* @__PURE__ */ u("span", {
+												"aria-hidden": !0,
+												className: "inline-block w-4",
+												children: k[n ? "done" : o === void 0 ? t.adding ? "running" : "waiting" : "failed"]
+											}), "Among your machines"]
+										}), o !== void 0 && !n && /* @__PURE__ */ u("pre", {
+											role: "alert",
+											className: "mt-1 ml-4 overflow-x-auto whitespace-pre-wrap rounded-md border border-border bg-background p-2 font-mono text-foreground",
+											children: o
+										})]
+									})
+								]
+							}),
+							X(t) && /* @__PURE__ */ d("ul", {
+								"aria-label": `The logins on ${t.address}`,
+								className: "space-y-2 border-t border-border pt-2 text-xs",
+								children: [/* @__PURE__ */ d(O, {
+									label: "GitHub",
+									words: s.working ? "GitHub: one moment, the server is being told." : s.there ? `GitHub: logged in as ${s.account ?? "you"} since ${D(s.since)}.` : s.said === void 0 ? "GitHub: no login on the server." : "GitHub: the last try did not go through.",
+									said: s.working ? void 0 : s.said,
+									children: [/* @__PURE__ */ u(e, {
+										size: "sm",
+										variant: "outline",
+										disabled: V || s.working || N === void 0,
+										"aria-label": `Copy my GitHub login to ${t.address}`,
+										title: N === void 0 ? P : `Copies the login of ${N} from this computer to the server, over SSH.`,
+										onClick: () => void Z(() => x(p, i, t.address, "github")),
+										children: s.there ? "Copy again" : "Copy my login"
+									}), (s.there || s.said !== void 0) && !s.working && /* @__PURE__ */ u(e, {
+										size: "sm",
+										variant: "outline",
+										disabled: V,
+										"aria-label": `Remove the GitHub login from ${t.address}`,
+										title: "Deletes the login on the server. The login itself stays good: it is this computer's own. To end it everywhere, take it back on github.com and log this computer's gh in again.",
+										onClick: () => void Z(() => S(p, i, t.address, "github")),
+										children: "Remove"
+									})]
+								}), /* @__PURE__ */ d(O, {
+									label: "Claude",
+									words: c.asking ? "Claude: say yes in the page this computer's browser opened." : c.working ? "Claude: one moment, the server is being told." : c.there ? `Claude: logged in since ${D(c.since)}, good until about ${D(c.ends)}.` : c.said === void 0 ? "Claude: not logged in on the server." : "Claude: the last try did not go through.",
+									said: c.working ? void 0 : c.said,
+									children: [/* @__PURE__ */ u(e, {
+										size: "sm",
+										variant: c.there || c.working ? "outline" : "default",
+										disabled: V || c.working && c.asking !== !0,
+										"aria-label": `Log in to Claude for ${t.address}`,
+										title: "Opens this computer's browser, where you say yes once. The login is made for this server alone and lasts a year; this computer's own Claude login is not touched.",
+										onClick: () => void Z(() => x(p, i, t.address, "claude")),
+										children: c.asking ? "Start over" : c.there ? "Log in again" : "Log in to Claude"
+									}), (c.there || c.said !== void 0) && !c.working && /* @__PURE__ */ u(e, {
+										size: "sm",
+										variant: "outline",
+										disabled: V,
+										"aria-label": `Remove the Claude login from ${t.address}`,
+										title: "Deletes the login on the server and starts OpenAgent there again without it. An agent at work there keeps it until it ends. The login itself stays good until its year is over.",
+										onClick: () => void Z(() => S(p, i, t.address, "claude")),
+										children: "Remove"
+									})]
+								})]
+							})
+						]
+					}, t.address);
+				})
+			}),
+			h !== void 0 && !h.ok && /* @__PURE__ */ u("p", {
+				role: "alert",
+				className: "py-3 text-xs text-danger",
+				children: `The servers could not be read: ${h.error}`
+			}),
+			U !== void 0 && /* @__PURE__ */ u("p", {
+				role: "alert",
+				className: "py-3 text-xs text-danger",
+				children: U
+			})
+		]
+	});
+}
+//#endregion
+//#region dashboard/index.tsx
+var N = i({
+	settings: [{
+		id: "servers",
+		order: 20,
+		Section: M
+	}],
+	stylesheet: "dashboard.css"
+});
+//#endregion
+export { N as default };

package/dist/install.d.ts

@@ -0,0 +1,43 @@
+import { type Exec } from './ssh.js';
+import { type Server } from './store.js';
+/**
+ * The install itself: the steps, one after the other, on one server, each written to the file
+ * as it starts and as it ends, so the page shows where the install is. It stops at the first
+ * step that fails, with what the server said. Run as a process of its own: an install takes
+ * minutes, and a command a page runs has seconds.
+ *
+ * Once the steps are done, the GitHub login is copied when the person asked for that.
+ */
+export interface InstallOptions {
+    env: NodeJS.ProcessEnv;
+    address: string;
+    /** The OpenAgent the server gets. */
+    version: string;
+    exec?: Exec;
+    /** Stops the install where it is. */
+    signal?: AbortSignal;
+    /** How often the file is told the install still runs. */
+    beatMs?: number;
+}
+/** Refused: the server's install already runs, in another process. */
+export declare class AlreadyWorking extends Error {
+    constructor(address: string);
+}
+export declare function install(opts: InstallOptions): Promise<void>;
+export type Link = {
+    ok: true;
+    url: string;
+    expires: string;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Ask the server's door for a link a new machine gets in with: good once, for five minutes.
+ * Only a link to that very server is one: what a server answers is not trusted to say where
+ * this computer goes to be let in.
+ */
+export declare function askLink(server: Pick<Server, 'address' | 'user'>, opts?: {
+    exec?: Exec;
+}): Promise<Link>;
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AACA,OAAO,EAAsC,KAAK,IAAI,EAAgB,MAAM,UAAU,CAAA;AAEtF,OAAO,EAA2C,KAAK,MAAM,EAAkB,MAAM,YAAY,CAAA;AAEjG;;;;;;;GAOG;AAEH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,qCAAqC;IACrC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,sEAAsE;AACtE,qBAAa,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDjE;AAED,MAAM,MAAM,IAAI,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAK5F;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,EAAE,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,IAAI,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAejH"}

package/dist/install.js

@@ -0,0 +1,101 @@
+import { giveGithub, noteGithub } from './logins.js';
+import { lastLines, openSession, withAdvice } from './ssh.js';
+import { SERVER_USER, STEPS, linkScript } from './steps.js';
+import { BEAT_MS, changeServer, doorUrl, working } from './store.js';
+/** Refused: the server's install already runs, in another process. */
+export class AlreadyWorking extends Error {
+    constructor(address) {
+        super(`OpenAgent is being installed on ${address} right now`);
+    }
+}
+export async function install(opts) {
+    const { env, address, version } = opts;
+    const change = (apply) => changeServer(env, address, apply);
+    const mine = (kept) => kept.worker?.pid === process.pid;
+    const beat = () => change(kept => void (mine(kept) && (kept.worker = { pid: process.pid, seen: new Date().toISOString() })));
+    const set = (id, state, said) => change(kept => {
+        const step = kept.steps.find(candidate => candidate.id === id);
+        step.state = state;
+        if (said)
+            step.said = said;
+        else
+            delete step.said;
+    });
+    // The install is this process's from here on; the command that started it held it under its own name until now.
+    const server = await change(kept => {
+        if (working(kept) && !mine(kept) && kept.worker.pid !== process.ppid)
+            throw new AlreadyWorking(address);
+        kept.worker = { pid: process.pid, seen: new Date().toISOString() };
+        return { address: kept.address, user: kept.user };
+    });
+    if (!server)
+        throw new Error(`no server at ${address}`);
+    const beating = setInterval(() => void beat().catch(() => { }), opts.beatMs ?? BEAT_MS);
+    let session;
+    try {
+        session = await openSession(server, { ...(opts.exec ? { exec: opts.exec } : {}), ...(opts.signal ? { signal: opts.signal } : {}) });
+        for (const step of STEPS) {
+            await set(step.id, 'running');
+            const login = step.id === 'login';
+            if (login) {
+                const met = await session.meet();
+                if (!met.ok)
+                    return void (await set(step.id, 'failed', withAdvice(server, met.said || 'The server did not answer.')));
+                if (met.fingerprint)
+                    await change(kept => void (kept.fingerprint = met.fingerprint));
+            }
+            const said = await session.run(step.as, step.script({ address, version }), step.timeoutMs);
+            if (said.code !== 0) {
+                const words = lastLines(said) || 'The step ended without a word.';
+                return void (await set(step.id, 'failed', login ? withAdvice(server, words) : words));
+            }
+            await set(step.id, 'done');
+        }
+        // The person's tick. A copy that fails is told on the login's own line: the server is installed all the same.
+        if (await change(kept => kept.github?.wanted === true)) {
+            const given = await giveGithub(session, opts.exec);
+            await change(kept => noteGithub(kept, given));
+        }
+    }
+    finally {
+        clearInterval(beating);
+        await change(kept => {
+            if (!mine(kept))
+                return;
+            // A step still running here is one this process did not see the end of.
+            for (const step of kept.steps)
+                if (step.state === 'running')
+                    Object.assign(step, { state: 'failed', said: 'The install was stopped.' });
+            delete kept.worker;
+        }).catch(() => { });
+        await session?.close();
+    }
+}
+/** How long the server gets to answer with a link: less than a page's command has, so the line is always hung up. */
+const LINK_TIMEOUT_MS = 20_000;
+/**
+ * Ask the server's door for a link a new machine gets in with: good once, for five minutes.
+ * Only a link to that very server is one: what a server answers is not trusted to say where
+ * this computer goes to be let in.
+ */
+export async function askLink(server, opts = {}) {
+    const session = await openSession(server, opts);
+    try {
+        const said = await session.run(SERVER_USER, linkScript(), LINK_TIMEOUT_MS);
+        if (said.code !== 0)
+            return { ok: false, error: withAdvice(server, lastLines(said) || 'The server did not answer.') };
+        try {
+            const { url, expires } = JSON.parse(said.out.trim().split('\n').at(-1) ?? '');
+            if (typeof url === 'string' && typeof expires === 'string' && new URL(url).origin === doorUrl(server.address))
+                return { ok: true, url, expires };
+        }
+        catch {
+            // Told below, as any answer that is no link.
+        }
+        return { ok: false, error: `The server answered something else than a link to its own door at ${doorUrl(server.address)}.` };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

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