inhuman 0.1.0 → 0.3.0

package/dist/cli/remote-commands.js

@@ -0,0 +1,184 @@
+/**
+ * `inhuman login | logout | remote status`: remote access through the relay.
+ * The daemon does the work (`remote/login`, `remote/logout`, `remote/status`); this renders the parked
+ * open-url form and the status. The daemon reads HARNESS_REMOTE_URL (and the optional
+ * HARNESS_REMOTE_WORKOS_CLIENT_ID override) from its own environment, inherited from the process that spawned it.
+ */
+import { isUiForm } from "@inhuman.tools/harness-contract";
+import { openExternalUrl } from "@inhuman.tools/harness-sdk";
+import { Command, Option } from "clipanion";
+import { KernelCommand } from "./context.js";
+import { openKernelRpc } from "./kernel-client.js";
+import { ensureServing, parsePort, realServeDeps, serveOutput, webShellInstalled } from "./web-commands.js";
+const ENV_HELP = `
+      The daemon reads two optional variables from its own environment, so set them before it starts (run
+      \`inhuman daemon restart\` if it is already running):
+
+        HARNESS_REMOTE_URL               relay origin (default https://harness.inhuman.tools)
+        HARNESS_REMOTE_WORKOS_CLIENT_ID  WorkOS client id (default: the one the relay publishes)
+`;
+export class LoginCommand extends KernelCommand {
+    static paths = [["login"]];
+    static usage = Command.Usage({
+        category: "Remote",
+        description: "start the daemon and web server if needed, then sign this machine in for remote access",
+        details: `
+      Runs \`inhuman start\` first, so the daemon and the web server are up. Starts a WorkOS device login. Open the printed address, check the code, and approve. The daemon then keeps
+      a connection to the relay open and this machine shows up on the remote picker.
+      ${ENV_HELP}`,
+        examples: [["Name the machine", "$0 login --name laptop"]],
+    });
+    name = Option.String("--name", { description: "machine name on the remote picker (default: hostname)" });
+    browser = Option.Boolean("--browser", true, { description: "open the approval page in a browser" });
+    port = Option.String("--port", "8787", { description: "preferred loopback port for the web server" });
+    async execute() {
+        const blocked = this.rejectUnsupportedAgentFlags("inhuman login");
+        if (blocked !== undefined)
+            return blocked;
+        const port = parsePort(this.port);
+        if (port === undefined) {
+            this.context.writeErr("login: --port must be a whole number");
+            return 1;
+        }
+        if (!(await webShellInstalled(this.context)))
+            return 1;
+        const kernel = this.kernelPath();
+        return (await runRemote({ verb: "login", kernel, name: this.name, browser: this.browser }, this.context, {
+            prepare: async () => {
+                const door = await ensureServing(realServeDeps, { kernel, port }, serveOutput(this.context));
+                this.context.stderr.write(`web: ${door.url}\n`);
+            },
+        })).code;
+    }
+}
+export class LogoutCommand extends KernelCommand {
+    static paths = [["logout"]];
+    static usage = Command.Usage({
+        category: "Remote",
+        description: "drop this machine's remote access login",
+    });
+    async execute() {
+        const blocked = this.rejectUnsupportedAgentFlags("inhuman logout");
+        if (blocked !== undefined)
+            return blocked;
+        return (await runRemote({ verb: "logout", kernel: this.kernelPath() }, this.context)).code;
+    }
+}
+export class RemoteCommand extends KernelCommand {
+    static paths = [["remote"]];
+    static usage = Command.Usage({
+        category: "Remote",
+        description: "remote access",
+    });
+    async execute() {
+        const blocked = this.rejectUnsupportedAgentFlags("inhuman remote");
+        if (blocked !== undefined)
+            return blocked;
+        this.context.stderr.write("Specify a remote command: status\n");
+        return 2;
+    }
+}
+export class RemoteStatusCommand extends KernelCommand {
+    static paths = [["remote", "status"]];
+    static usage = Command.Usage({
+        category: "Remote",
+        description: "show remote access state",
+        details: ENV_HELP,
+    });
+    json = Option.Boolean("--json", false, { description: "print JSON" });
+    async execute() {
+        const blocked = this.rejectUnsupportedAgentFlags("inhuman remote status");
+        if (blocked !== undefined)
+            return blocked;
+        return (await runRemote({ verb: "status", kernel: this.kernelPath(), json: this.json }, this.context)).code;
+    }
+}
+export async function runRemote(args, streams, deps = {}) {
+    const owned = deps.rpc === undefined;
+    try {
+        if (args.verb === "login")
+            await deps.prepare?.();
+        const rpc = deps.rpc ?? (await openKernelRpc(args.kernel));
+        try {
+            switch (args.verb) {
+                case "login":
+                    return await runLogin(rpc, streams, args, deps);
+                case "logout":
+                    return await runLogout(rpc, streams);
+                case "status":
+                    return await runStatus(rpc, streams, args.json === true);
+            }
+            // Unreachable: the verbs above are exhaustive.
+            return { code: 2 };
+        }
+        finally {
+            if (owned)
+                await rpc[Symbol.asyncDispose]();
+        }
+    }
+    catch (error) {
+        streams.writeErr(error);
+        return { code: 1 };
+    }
+}
+async function runLogin(rpc, streams, args, deps) {
+    const open = deps.openBrowser ?? openExternalUrl;
+    let result = await rpc.request("remote/login", args.name === undefined ? {} : { name: args.name });
+    while (isUiForm(result)) {
+        const url = result.body.match(/https?:\/\/[^\s"'<>\\]+/i)?.[0];
+        if (url === undefined)
+            throw new Error("remote/login: the daemon parked a form with no address");
+        const code = userCode(url);
+        streams.stderr.write(`Approve this machine for remote access:\n  ${url}\n`);
+        if (code !== undefined)
+            streams.stderr.write(`Check that the page shows the code ${code}.\n`);
+        streams.stderr.write("Waiting for approval...\n");
+        if (args.browser !== false)
+            open(url);
+        result = await rpc.request("ui/resolve", { pending: result.pending, kind: "opened", url });
+    }
+    const reply = result;
+    if (reply.ok !== true) {
+        streams.writeErr("login cancelled");
+        return { code: 1 };
+    }
+    const who = reply.email === "" ? "signed in" : `signed in as ${reply.email}`;
+    streams.stdout.write(`${who}; machine ${reply.machineId}\n`);
+    return { code: 0 };
+}
+function userCode(url) {
+    try {
+        return new URL(url).searchParams.get("user_code") ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function runLogout(rpc, streams) {
+    const reply = (await rpc.request("remote/logout", {}));
+    streams.stdout.write(reply.wasLoggedIn === true ? "signed out of remote access\n" : "was not signed in\n");
+    return { code: 0 };
+}
+async function runStatus(rpc, streams, json) {
+    const status = (await rpc.request("remote/status", {}));
+    if (json) {
+        streams.stdout.write(`${JSON.stringify(status)}\n`);
+        return { code: 0 };
+    }
+    const rows = [
+        [
+            "remote access",
+            status.loggedIn ? `signed in${status.email === undefined ? "" : ` as ${status.email}`}` : "signed out",
+        ],
+        ["machine", `${status.machineName} (${status.machineId})`],
+        ["relay", status.relayUrl],
+        ["connection", status.connected ? "connected" : status.loggedIn ? "not connected (retrying)" : "off"],
+        ...(status.lastError === undefined ? [] : [["last error", status.lastError]]),
+    ];
+    const width = Math.max(...rows.map(([label]) => label.length));
+    streams.stdout.write(`${rows.map(([label, value]) => `${label.padEnd(width)}  ${value}`).join("\n")}\n`);
+    if (!status.loggedIn)
+        streams.stdout.write("run `inhuman login` to sign in\n");
+    return { code: 0 };
+}
+//# sourceMappingURL=remote-commands.js.map

package/dist/cli/remote-commands.js.map

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

package/dist/cli/resume-complete.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Glance `scope !== ""` and `oneShot` are not conversation resume targets —
+ * listing them attaches workers.
+ */
+export type ResumeOverview = {
+    readonly title?: string;
+    readonly lastMessageAt?: number;
+    readonly recipeScope?: string;
+    readonly oneShot?: boolean;
+};
+export type ResumeCompletion = {
+    readonly id: string;
+    readonly title: string;
+    readonly lastMessageAt: number;
+    readonly occupied: boolean;
+};
+export declare function listResumeCompletions(args: {
+    readonly sessions: Record<string, ResumeOverview | undefined>;
+    readonly occupied: ReadonlySet<string>;
+    readonly prefix?: string;
+}): ResumeCompletion[];
+/** `id<TAB>title · used|orphaned`. Description has no tab/colon (zsh `_describe`). */
+export declare function formatResumeCompletion(row: ResumeCompletion): string;
+//# sourceMappingURL=resume-complete.d.ts.map

package/dist/cli/resume-complete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-complete.d.ts","sourceRoot":"","sources":["../../src/cli/resume-complete.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC,CAAC;IAC9D,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,gBAAgB,EAAE,CAmBrB;AAED,sFAAsF;AACtF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAIpE"}

package/dist/cli/resume-complete.js

@@ -0,0 +1,35 @@
+export function listResumeCompletions(args) {
+    const needle = (args.prefix ?? "").trim().toLowerCase();
+    const rows = [];
+    for (const [id, glance] of Object.entries(args.sessions)) {
+        if (glance == null || id.trim() === "")
+            continue;
+        if ((glance.recipeScope ?? "") !== "" || glance.oneShot === true)
+            continue;
+        const title = glance.title?.trim() ?? "";
+        if (needle !== "" && !id.toLowerCase().includes(needle) && !title.toLowerCase().includes(needle)) {
+            continue;
+        }
+        rows.push({
+            id,
+            title,
+            lastMessageAt: glance.lastMessageAt ?? 0,
+            occupied: args.occupied.has(id),
+        });
+    }
+    rows.sort((a, b) => b.lastMessageAt - a.lastMessageAt || a.id.localeCompare(b.id));
+    return rows;
+}
+/** `id<TAB>title · used|orphaned`. Description has no tab/colon (zsh `_describe`). */
+export function formatResumeCompletion(row) {
+    const label = sanitize(row.title === "" ? row.id : row.title);
+    const scent = row.occupied ? "used" : "orphaned";
+    return `${row.id}\t${label} · ${scent}`;
+}
+function sanitize(text) {
+    return text
+        .replaceAll(/[\t\n\r]/g, " ")
+        .replaceAll(":", " ")
+        .trim();
+}
+//# sourceMappingURL=resume-complete.js.map

package/dist/cli/resume-complete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-complete.js","sourceRoot":"","sources":["../../src/cli/resume-complete.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,qBAAqB,CAAC,IAIrC;IACC,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxD,MAAM,IAAI,GAAuB,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzD,IAAI,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAS;QACjD,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI;YAAE,SAAS;QAC3E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACzC,IAAI,MAAM,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACjG,SAAS;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC;YACR,EAAE;YACF,KAAK;YACL,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,CAAC;YACxC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;SAChC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,sBAAsB,CAAC,GAAqB;IAC1D,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;IACjD,OAAO,GAAG,GAAG,CAAC,EAAE,KAAK,KAAK,MAAM,KAAK,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI;SACR,UAAU,CAAC,WAAW,EAAE,GAAG,CAAC;SAC5B,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/cli/shell-import.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The TUI and the web app are dependencies loaded on demand. A command loads its shell when it runs,
+ * so `inhuman daemon stop` and `inhuman mcp list` never pay for either. A shell that is not installed
+ * becomes an install hint; any other failure to load, a dependency of an installed shell included,
+ * keeps its stack: that is a broken install, not a missing shell.
+ */
+import type { ShellContext } from "./context.js";
+export type ShellPackage = {
+    /** What the user calls it in the hint: "TUI shell". */
+    readonly label: string;
+    /** The module handed to `import()`, subpath included. */
+    readonly specifier: string;
+};
+/**
+ * Node names the package, not the subpath, when it finds none: importing `@scope/web/server` fails with
+ * "Cannot find package '@scope/web' imported from ...". A message that names any other module, such as a
+ * file inside an installed shell or a package the shell itself needs, is not a missing shell.
+ */
+export declare function isShellMissing(error: unknown, specifier: string): boolean;
+/** The loaded shell, or `undefined` after one stderr line when the shell is not installed. */
+export declare function importShell<T>(context: Pick<ShellContext, "writeErr">, shell: ShellPackage, load: () => Promise<T>): Promise<T | undefined>;
+//# sourceMappingURL=shell-import.d.ts.map

package/dist/cli/shell-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-import.d.ts","sourceRoot":"","sources":["../../src/cli/shell-import.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,MAAM,YAAY,GAAG;IACzB,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAQF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAMzE;AAED,8FAA8F;AAC9F,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,EACvC,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAQxB"}

package/dist/cli/shell-import.js

@@ -0,0 +1,32 @@
+/** `@scope/name/sub` is `@scope/name`; `name/sub` is `name`. */
+function packageNameOf(specifier) {
+    const parts = specifier.split("/");
+    return parts.slice(0, specifier.startsWith("@") ? 2 : 1).join("/");
+}
+/**
+ * Node names the package, not the subpath, when it finds none: importing `@scope/web/server` fails with
+ * "Cannot find package '@scope/web' imported from ...". A message that names any other module, such as a
+ * file inside an installed shell or a package the shell itself needs, is not a missing shell.
+ */
+export function isShellMissing(error, specifier) {
+    if (!(error instanceof Error))
+        return false;
+    const { code } = error;
+    if (code !== "ERR_MODULE_NOT_FOUND" && code !== "MODULE_NOT_FOUND")
+        return false;
+    const named = /^Cannot find (?:package|module) '([^']+)'/.exec(error.message)?.[1];
+    return named === specifier || named === packageNameOf(specifier);
+}
+/** The loaded shell, or `undefined` after one stderr line when the shell is not installed. */
+export async function importShell(context, shell, load) {
+    try {
+        return await load();
+    }
+    catch (error) {
+        if (!isShellMissing(error, shell.specifier))
+            throw error;
+        context.writeErr(`inhuman: the ${shell.label} is not installed — add ${packageNameOf(shell.specifier)}`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=shell-import.js.map

package/dist/cli/shell-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-import.js","sourceRoot":"","sources":["../../src/cli/shell-import.ts"],"names":[],"mappings":"AAeA,gEAAgE;AAChE,SAAS,aAAa,CAAC,SAAiB;IACtC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,SAAiB;IAC9D,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,EAAE,IAAI,EAAE,GAAG,KAA8B,CAAC;IAChD,IAAI,IAAI,KAAK,sBAAsB,IAAI,IAAI,KAAK,kBAAkB;QAAE,OAAO,KAAK,CAAC;IACjF,MAAM,KAAK,GAAG,2CAA2C,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACnF,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,aAAa,CAAC,SAAS,CAAC,CAAC;AACnE,CAAC;AAED,8FAA8F;AAC9F,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAuC,EACvC,KAAmB,EACnB,IAAsB;IAEtB,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;YAAE,MAAM,KAAK,CAAC;QACzD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,KAAK,CAAC,KAAK,2BAA2B,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACzG,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/cli/tui-command.d.ts

@@ -0,0 +1,11 @@
+import { KernelCommand } from "./context.js";
+export declare class TuiCommand extends KernelCommand {
+    static paths: never[][];
+    static usage: import("clipanion").Usage;
+    session: string | undefined;
+    resume: string | undefined;
+    continueLast: boolean;
+    restartDaemon: boolean;
+    execute(): Promise<number>;
+}
+//# sourceMappingURL=tui-command.d.ts.map

package/dist/cli/tui-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-command.d.ts","sourceRoot":"","sources":["../../src/cli/tui-command.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,qBAAa,UAAW,SAAQ,aAAa;IAC3C,MAAM,CAAC,KAAK,YAAqB;IACjC,MAAM,CAAC,KAAK,4BAET;IAEH,OAAO,qBAA6D;IACpE,MAAM,qBAA2E;IACjF,YAAY,UAET;IACH,aAAa,UAEV;IAEG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CAqBjC"}

package/dist/cli/tui-command.js

@@ -0,0 +1,41 @@
+/**
+ * `--session` / `--resume` / `--continue` and `--restart-daemon` live only here —
+ * daemon/mcp must not see them.
+ */
+import { ensure } from "@inhuman.tools/harness";
+import { Command, Option } from "clipanion";
+import { KernelCommand } from "./context.js";
+import { importShell } from "./shell-import.js";
+export class TuiCommand extends KernelCommand {
+    static paths = [Command.Default];
+    static usage = Command.Usage({
+        description: "attach the TUI to the daemon",
+    });
+    session = Option.String("--session", { description: "session id" });
+    resume = Option.String("--resume", { description: "session id (tab-complete)" });
+    continueLast = Option.Boolean("--continue,-c", false, {
+        description: "restore this tab's last session",
+    });
+    restartDaemon = Option.Boolean("--restart-daemon", false, {
+        description: "stop a live daemon before attach",
+    });
+    async execute() {
+        if (this.continueLast && (this.session != null || this.resume != null)) {
+            this.context.writeErr("cannot combine --continue with --resume or --session");
+            return 2;
+        }
+        const tui = await importShell(this.context, { label: "TUI shell", specifier: "@inhuman.tools/harness-tui" }, () => import("@inhuman.tools/harness-tui"));
+        if (tui === undefined)
+            return 1;
+        return tui.attachTui({
+            kernel: this.kernelPath(),
+            session: this.session ?? this.resume,
+            continueLast: this.continueLast,
+            restartDaemon: this.restartDaemon,
+            agent: this.cliAgentFlags(),
+            streams: this.context,
+            ensure,
+        });
+    }
+}
+//# sourceMappingURL=tui-command.js.map

package/dist/cli/tui-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-command.js","sourceRoot":"","sources":["../../src/cli/tui-command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,UAAW,SAAQ,aAAa;IAC3C,MAAM,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,WAAW,EAAE,8BAA8B;KAC5C,CAAC,CAAC;IAEH,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC;IACpE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC,CAAC;IACjF,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,KAAK,EAAE;QACpD,WAAW,EAAE,iCAAiC;KAC/C,CAAC,CAAC;IACH,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,KAAK,EAAE;QACxD,WAAW,EAAE,kCAAkC;KAChD,CAAC,CAAC;IAEH,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC;YACvE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,sDAAsD,CAAC,CAAC;YAC9E,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,WAAW,CAC3B,IAAI,CAAC,OAAO,EACZ,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,4BAA4B,EAAE,EAC/D,GAAG,EAAE,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAC3C,CAAC;QACF,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC;QAChC,OAAO,GAAG,CAAC,SAAS,CAAC;YACnB,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM;YACpC,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM;SACP,CAAC,CAAC;IACL,CAAC"}

package/dist/cli/web-commands.d.ts

@@ -0,0 +1,54 @@
+import { KernelCommand, type ShellContext } from "./context.js";
+import { type DoorRecord } from "./web-door.js";
+export type ServeDeps = {
+    readonly daemonRunning: (kernel: string) => Promise<boolean>;
+    readonly ensure: (kernel: string) => Promise<void>;
+    readonly findDoor: (kernel: string) => Promise<DoorRecord | undefined>;
+    readonly startDoor: (kernel: string, port: number) => Promise<DoorRecord>;
+    readonly openBrowser: (url: string) => void;
+};
+export type ServeOptions = {
+    readonly kernel: string;
+    readonly port: number;
+};
+export type WebOptions = ServeOptions & {
+    readonly browser: boolean;
+};
+export type ServeOutput = {
+    readonly out: (line: string) => void;
+    readonly err: (line: string) => void;
+};
+/**
+ * Daemon up and web door up, both left running in the background. Progress goes to `err`; the caller
+ * decides what to print and whether to open a browser. Shared by `start`, `web` and `login`.
+ */
+export declare function ensureServing(deps: ServeDeps, options: ServeOptions, output: ServeOutput): Promise<DoorRecord>;
+/** `inhuman start`: serve in the background, print the URL, never open a browser. */
+export declare function runStart(deps: ServeDeps, options: ServeOptions, output: ServeOutput): Promise<number>;
+/** `inhuman web`: serve in the background, print the URL, open the browser unless told not to. */
+export declare function runWeb(deps: ServeDeps, options: WebOptions, output: ServeOutput): Promise<number>;
+export declare const realServeDeps: ServeDeps;
+export declare function serveOutput(context: ShellContext): ServeOutput;
+export declare function parsePort(value: string): number | undefined;
+/** Fails with the install hint before the daemon starts, not after. */
+export declare function webShellInstalled(context: ShellContext): Promise<boolean>;
+declare abstract class ServeCommand extends KernelCommand {
+    abstract readonly verb: string;
+    port: string;
+    protected serve(run: (kernel: string, port: number) => Promise<number>): Promise<number>;
+}
+export declare class StartCommand extends ServeCommand {
+    static paths: string[][];
+    static usage: import("clipanion").Usage;
+    readonly verb = "start";
+    execute(): Promise<number>;
+}
+export declare class WebCommand extends ServeCommand {
+    static paths: string[][];
+    static usage: import("clipanion").Usage;
+    readonly verb = "web";
+    noBrowser: boolean;
+    execute(): Promise<number>;
+}
+export {};
+//# sourceMappingURL=web-commands.d.ts.map

package/dist/cli/web-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-commands.d.ts","sourceRoot":"","sources":["../../src/cli/web-commands.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAErE,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IACvE,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1E,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAUpH;AAED,qFAAqF;AACrF,wBAAsB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAI3G;AAED,kGAAkG;AAClG,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAKvG;AAED,eAAO,MAAM,aAAa,EAAE,SAM3B,CAAC;AAEF,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAK9D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG3D;AAED,uEAAuE;AACvE,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/E;AAED,uBAAe,YAAa,SAAQ,aAAa;IAC/C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,IAAI,SAA+G;cAEnG,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAgB/F;AAED,qBAAa,YAAa,SAAQ,YAAY;IAC5C,MAAM,CAAC,KAAK,aAAe;IAC3B,MAAM,CAAC,KAAK,4BAMT;IACH,QAAQ,CAAC,IAAI,WAAW;IAExB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CAG3B;AAED,qBAAa,UAAW,SAAQ,YAAY;IAC1C,MAAM,CAAC,KAAK,aAAa;IACzB,MAAM,CAAC,KAAK,4BAGT;IACH,QAAQ,CAAC,IAAI,SAAS;IAEtB,SAAS,UAAqG;IAE9G,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CAK3B"}

package/dist/cli/web-commands.js

@@ -0,0 +1,106 @@
+import { daemonRunning, ensure } from "@inhuman.tools/harness";
+import { Command, Option } from "clipanion";
+import { openBrowser } from "./browser.js";
+import { KernelCommand } from "./context.js";
+import { importShell } from "./shell-import.js";
+import { liveDoor, startDoor } from "./web-door.js";
+/**
+ * Daemon up and web door up, both left running in the background. Progress goes to `err`; the caller
+ * decides what to print and whether to open a browser. Shared by `start`, `web` and `login`.
+ */
+export async function ensureServing(deps, options, output) {
+    const wasRunning = await deps.daemonRunning(options.kernel);
+    await deps.ensure(options.kernel);
+    output.err(wasRunning ? "daemon: already running" : "daemon: started");
+    const live = await deps.findDoor(options.kernel);
+    if (live !== undefined) {
+        output.err("web: reusing running door");
+        return live;
+    }
+    return deps.startDoor(options.kernel, options.port);
+}
+/** `inhuman start`: serve in the background, print the URL, never open a browser. */
+export async function runStart(deps, options, output) {
+    const door = await ensureServing(deps, options, output);
+    output.out(door.url);
+    return 0;
+}
+/** `inhuman web`: serve in the background, print the URL, open the browser unless told not to. */
+export async function runWeb(deps, options, output) {
+    const door = await ensureServing(deps, options, output);
+    output.out(door.url);
+    if (options.browser)
+        deps.openBrowser(door.url);
+    return 0;
+}
+export const realServeDeps = {
+    daemonRunning: (kernel) => daemonRunning(kernel),
+    ensure: (kernel) => ensure(kernel),
+    findDoor: (kernel) => liveDoor(kernel),
+    startDoor,
+    openBrowser,
+};
+export function serveOutput(context) {
+    return {
+        out: (line) => context.stdout.write(`${line}\n`),
+        err: (line) => context.stderr.write(`${line}\n`),
+    };
+}
+export function parsePort(value) {
+    const port = Number(value);
+    return Number.isInteger(port) && port >= 0 ? port : undefined;
+}
+/** Fails with the install hint before the daemon starts, not after. */
+export async function webShellInstalled(context) {
+    const web = await importShell(context, { label: "web shell", specifier: "@inhuman.tools/harness-web-app/server" }, () => import("@inhuman.tools/harness-web-app/server"));
+    return web !== undefined;
+}
+class ServeCommand extends KernelCommand {
+    port = Option.String("--port", "8787", { description: "preferred loopback port; a free one is picked when busy" });
+    async serve(run) {
+        const blocked = this.rejectUnsupportedAgentFlags(`inhuman ${this.verb}`);
+        if (blocked !== undefined)
+            return blocked;
+        const port = parsePort(this.port);
+        if (port === undefined) {
+            this.context.writeErr(`${this.verb}: --port must be a whole number`);
+            return 1;
+        }
+        if (!(await webShellInstalled(this.context)))
+            return 1;
+        try {
+            return await run(this.kernelPath(), port);
+        }
+        catch (error) {
+            this.context.writeErr(error);
+            return 1;
+        }
+    }
+}
+export class StartCommand extends ServeCommand {
+    static paths = [["start"]];
+    static usage = Command.Usage({
+        category: "Client",
+        description: "start the daemon and its web server in the background, print the URL, and return",
+        details: `
+      Leaves the daemon and a loopback web server running. Does not open a browser; use \`inhuman web\` for that.
+    `,
+    });
+    verb = "start";
+    execute() {
+        return this.serve((kernel, port) => runStart(realServeDeps, { kernel, port }, serveOutput(this.context)));
+    }
+}
+export class WebCommand extends ServeCommand {
+    static paths = [["web"]];
+    static usage = Command.Usage({
+        category: "Client",
+        description: "start the daemon and web server if needed, then open the web client in the browser",
+    });
+    verb = "web";
+    noBrowser = Option.Boolean("--no-browser", false, { description: "print the URL without opening a browser" });
+    execute() {
+        return this.serve((kernel, port) => runWeb(realServeDeps, { kernel, port, browser: !this.noBrowser }, serveOutput(this.context)));
+    }
+}
+//# sourceMappingURL=web-commands.js.map

package/dist/cli/web-commands.js.map

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

package/dist/cli/web-door-command.d.ts

@@ -0,0 +1,11 @@
+import { KernelCommand } from "./context.js";
+/**
+ * Internal: the detached process `inhuman start` and `inhuman web` start. Serves the built client until the daemon is gone.
+ * It has no `usage`, so help does not list it.
+ */
+export declare class WebDoorCommand extends KernelCommand {
+    static paths: string[][];
+    port: string;
+    execute(): Promise<number>;
+}
+//# sourceMappingURL=web-door-command.d.ts.map

package/dist/cli/web-door-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-door-command.d.ts","sourceRoot":"","sources":["../../src/cli/web-door-command.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAI7C;;;GAGG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C,MAAM,CAAC,KAAK,aAAkB;IAE9B,IAAI,SAAmC;IAEjC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CAmEjC"}