@inhuman.tools/harness 0.0.0-stage → 0.1.0

package/dist/cli/tui.d.ts

@@ -0,0 +1,17 @@
+import { KernelCommand } from "./context.js";
+export declare function hostExitCode(args: {
+    failed: string | null;
+    workerCode: number | null;
+    shutdown: boolean;
+}): {
+    code: number;
+    reason: string;
+};
+export declare class TuiCommand extends KernelCommand {
+    static paths: never[][];
+    static usage: import("clipanion").Usage;
+    session: string | undefined;
+    restartDaemon: boolean;
+    execute(): Promise<number>;
+}
+//# sourceMappingURL=tui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../src/cli/tui.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAC,aAAa,EAAgC,MAAM,cAAc,CAAC;AAG1E,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CASjC;AAED,qBAAa,UAAW,SAAQ,aAAa;IAC3C,MAAM,CAAC,KAAK,YAAqB;IACjC,MAAM,CAAC,KAAK,4BAET;IAEH,OAAO,qBAA2D;IAClE,aAAa,UAEV;IAEG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAO/B;CACF"}

package/dist/cli/tui.js

@@ -0,0 +1,207 @@
+/**
+ * Default command: attach the TUI. `--session` and `--restart-daemon` live
+ * here only — daemon/mcp must not see them.
+ */
+import { fileURLToPath } from "node:url";
+import { Worker } from "node:worker_threads";
+import { startRender } from "@inhuman.tools/quickdraw";
+import { dumpSkipped, ensure, fail, installProcessLog, mute, note, openLog, step, } from "@inhuman.tools/harness-server";
+import { Command, Option } from "clipanion";
+import { KernelCommand, writeErr } from "./context.js";
+export function hostExitCode(args) {
+    if (args.failed !== null)
+        return { code: 1, reason: `failed ${args.failed}` };
+    if (args.shutdown) {
+        const clean = args.workerCode === 0 || args.workerCode === null;
+        return { code: clean ? 0 : 1, reason: "shutdown" };
+    }
+    if (args.workerCode === 0)
+        return { code: 1, reason: "worker 0 unexpected" };
+    if (args.workerCode === null)
+        return { code: 1, reason: "worker signal" };
+    return { code: 1, reason: `worker ${args.workerCode}` };
+}
+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" });
+    restartDaemon = Option.Boolean("--restart-daemon", false, {
+        description: "stop a live daemon before attach",
+    });
+    async execute() {
+        return attachTui({
+            kernel: this.kernelPath(),
+            session: this.session,
+            restartDaemon: this.restartDaemon,
+            streams: this.context,
+        });
+    }
+}
+async function attachTui(args) {
+    const { kernel, streams } = args;
+    const log = openLog(kernel);
+    installProcessLog("host");
+    note(`log ${log}`);
+    try {
+        step(`ensure ${kernel}`);
+        await ensure(kernel, { restart: args.restartDaemon });
+        step("ensure ready");
+    }
+    catch (error) {
+        fail("ensure", error);
+        writeErr(streams, error);
+        return 1;
+    }
+    const boot = {
+        kernel,
+        path: process.cwd(),
+        ...(args.session === undefined ? {} : { sessionId: args.session }),
+    };
+    const self = fileURLToPath(import.meta.url);
+    const workerFile = fileURLToPath(new URL(self.endsWith(".ts") ? "../tui/worker-entry.ts" : "../tui/worker-entry.js", import.meta.url));
+    step(`worker ${workerFile}`);
+    mute();
+    const worker = new Worker(workerFile, {
+        workerData: boot,
+    });
+    const paintHandlers = [];
+    const pendingPaint = [];
+    let attached = false;
+    let failed = null;
+    let shutdown = false;
+    let workerCode = null;
+    let resolveAttached = () => undefined;
+    let rejectAttached = () => undefined;
+    let resolveRunning = () => undefined;
+    const attachedWait = new Promise((resolve, reject) => {
+        resolveAttached = resolve;
+        rejectAttached = reject;
+    });
+    const runningWait = new Promise((resolve) => {
+        resolveRunning = resolve;
+    });
+    worker.on("message", (message) => {
+        if (message.lane === "paint") {
+            if (paintHandlers.length === 0) {
+                pendingPaint.push(message.batch);
+                return;
+            }
+            for (const handler of paintHandlers)
+                handler(message.batch);
+            return;
+        }
+        if (message.kind === "attached") {
+            step("worker attached");
+            attached = true;
+            resolveAttached();
+            return;
+        }
+        failed = message.reason ?? "worker failed";
+        fail(`worker failed ${failed}`);
+        rejectAttached(new Error(failed));
+    });
+    worker.on("error", (error) => {
+        failed = error instanceof Error ? error.message : String(error);
+        fail("host worker error", error);
+        if (!attached)
+            rejectAttached(error instanceof Error ? error : new Error(failed));
+    });
+    worker.once("exit", (code, signal) => {
+        workerCode = code;
+        note(`host worker exit code=${code} signal=${signal ?? ""}`);
+        if (!attached && failed === null) {
+            rejectAttached(new Error(`tui worker exited ${code}`));
+        }
+        resolveRunning();
+    });
+    step("render");
+    const session = await startRender({
+        stdin: streams.stdin,
+        stdout: streams.stdout,
+        input: {
+            onData: (handler) => {
+                streams.stdin.setEncoding("utf8");
+                streams.stdin.resume();
+                streams.stdin.on("data", (chunk) => handler(chunk));
+            },
+            setRawMode: (enabled) => {
+                if (streams.stdin.isTTY)
+                    streams.stdin.setRawMode(enabled);
+            },
+        },
+        output: {
+            write: (text) => {
+                streams.stdout.write(text);
+            },
+            get cols() {
+                return streams.stdout.columns ?? 80;
+            },
+            get rows() {
+                return streams.stdout.rows ?? 24;
+            },
+            onResize: (handler) => {
+                streams.stdout.on("resize", handler);
+            },
+        },
+        port: {
+            post: (message) => {
+                const down = { lane: "paint", message };
+                worker.postMessage(down);
+            },
+            onBatch: (handler) => {
+                paintHandlers.push(handler);
+                for (const batch of pendingPaint.splice(0))
+                    handler(batch);
+            },
+        },
+        onQuit: () => {
+            if (shutdown)
+                return;
+            shutdown = true;
+            note("host quit");
+            worker.postMessage({ lane: "host", kind: "shutdown" });
+        },
+    });
+    installProcessLog("host", () => {
+        try {
+            session.stop();
+            session.restore();
+        }
+        catch {
+            /* already tearing down */
+        }
+        dumpSkipped(streams.stderr);
+    });
+    const requestShutdown = (why) => {
+        if (shutdown)
+            return;
+        shutdown = true;
+        note(`host ${why}`);
+        worker.postMessage({ lane: "host", kind: "shutdown" });
+    };
+    process.once("SIGINT", () => requestShutdown("SIGINT"));
+    process.once("SIGTERM", () => requestShutdown("SIGTERM"));
+    try {
+        step("wait attached");
+        await attachedWait;
+        step("running");
+        await runningWait;
+        const ended = hostExitCode({ failed, workerCode, shutdown });
+        note(`host end ${ended.reason}`);
+        return ended.code;
+    }
+    catch (error) {
+        fail("host run", error);
+        writeErr(streams, error);
+        return 1;
+    }
+    finally {
+        session.stop();
+        session.restore();
+        await worker.terminate();
+        dumpSkipped(streams.stderr);
+    }
+}
+//# sourceMappingURL=tui.js.map

package/dist/cli/tui.js.map

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

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

@@ -0,0 +1,8 @@
+import { KernelCommand } from "./context.js";
+export declare class WebCommand extends KernelCommand {
+    static paths: string[][];
+    static usage: import("clipanion").Usage;
+    port: string;
+    execute(): Promise<number>;
+}
+//# sourceMappingURL=web-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web-command.d.ts","sourceRoot":"","sources":["../../src/cli/web-command.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAI7C,qBAAa,UAAW,SAAQ,aAAa;IAC3C,MAAM,CAAC,KAAK,aAAa;IACzB,MAAM,CAAC,KAAK,4BAGT;IAEH,IAAI,SAAqE;IAEnE,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CAsDjC"}

package/dist/cli/web-command.js

@@ -0,0 +1,151 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { realpath } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Client } from "@inhuman.tools/harness-sdk";
+import { daemonSocketPath } from "@inhuman.tools/harness-sdk/paths";
+import { listenWebApp } from "@inhuman.tools/harness-web-app/server";
+import { Command, Option } from "clipanion";
+import { ensure } from "../server/index.js";
+import { KernelCommand } from "./context.js";
+const webAppRoot = join(dirname(fileURLToPath(import.meta.url)), "../../../harness-web-app");
+export class WebCommand extends KernelCommand {
+    static paths = [["web"]];
+    static usage = Command.Usage({
+        category: "Client",
+        description: "open the browser client on the local daemon",
+    });
+    port = Option.String("--port", "8787", { description: "loopback port" });
+    async execute() {
+        const blocked = this.rejectUnsupportedAgentFlags("harness web");
+        if (blocked !== undefined)
+            return blocked;
+        const port = Number(this.port);
+        if (!Number.isInteger(port) || port < 0) {
+            this.context.writeErr("web: --port must be a whole number");
+            return 1;
+        }
+        try {
+            await ensure(this.kernelPath());
+        }
+        catch (error) {
+            this.context.writeErr(error);
+            return 1;
+        }
+        const sock = daemonSocketPath(await realpath(this.kernelPath()));
+        if (!existsSync(sock)) {
+            this.context.writeErr("web: daemon socket is missing");
+            return 1;
+        }
+        const fileRoots = new Set([process.cwd()]);
+        try {
+            const env_1 = { stack: [], error: void 0, hasError: false };
+            try {
+                const kernel = __addDisposableResource(env_1, await Client.kernel(this.kernelPath()), true);
+                for (const path of Object.keys(kernel.plexus.root.projects))
+                    fileRoots.add(path);
+            }
+            catch (e_1) {
+                env_1.error = e_1;
+                env_1.hasError = true;
+            }
+            finally {
+                const result_1 = __disposeResources(env_1);
+                if (result_1)
+                    await result_1;
+            }
+        }
+        catch {
+            // /file still serves the process cwd.
+        }
+        let app;
+        try {
+            app = await listenWebApp({
+                sockPath: sock,
+                port,
+                pages: "vite",
+                viteRoot: webAppRoot,
+                staticDir: join(webAppRoot, "dist/client"),
+                fileRoots: [...fileRoots],
+                extraOrigins: (process.env["HARNESS_WEB_ALLOWED_ORIGINS"] ?? "")
+                    .split(",")
+                    .map((origin) => origin.trim())
+                    .filter((origin) => origin !== ""),
+            });
+        }
+        catch (error) {
+            this.context.writeErr(error);
+            return 1;
+        }
+        const url = `http://127.0.0.1:${app.port}/`;
+        this.context.stdout.write(`${url}\n`);
+        openBrowser(url);
+        await new Promise((resolve) => {
+            process.once("SIGINT", () => resolve());
+            process.once("SIGTERM", () => resolve());
+        });
+        await app.close();
+        return 0;
+    }
+}
+function openBrowser(url) {
+    const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
+    const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
+    const child = spawn(command, args, { detached: true, stdio: "ignore" });
+    child.on("error", () => undefined);
+    child.unref();
+}
+//# sourceMappingURL=web-command.js.map

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

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

package/dist/client.d.ts

@@ -0,0 +1,34 @@
+import { type AttentionSource, type AttentionSubject } from "@inhuman.tools/plexus-expectations";
+import { WebsocketProvider } from "y-websocket";
+import { ProjectPlexus } from "./daemon/project/ProjectPlexus.js";
+import { KernelPlexus, type KernelRoot } from "./models/kernel/index.js";
+import { SessionPlexus, type SessionRoot } from "./models/session/index.js";
+export declare class Client implements AsyncDisposable {
+    #private;
+    readonly kernelPath: string;
+    readonly projectPath: string;
+    readonly sessionId: string;
+    readonly kernelPlexus: KernelPlexus;
+    readonly projectPlexus: ProjectPlexus;
+    readonly sessionPlexus: SessionPlexus;
+    readonly kernelProvider: WebsocketProvider | null;
+    readonly sessionProvider: WebsocketProvider | null;
+    static start(kernelPath: string, projectPath: string): Promise<Client>;
+    static connect(kernelPath: string, projectPath: string, sessionId: string): Promise<Client>;
+    constructor(kernelPath: string, projectPath: string, sessionId: string, kernelPlexus: KernelPlexus, projectPlexus: ProjectPlexus, sessionPlexus: SessionPlexus, kernelProvider?: WebsocketProvider | null, sessionProvider?: WebsocketProvider | null);
+    get kernelRoot(): KernelRoot;
+    get sessionRoot(): SessionRoot;
+    /**
+     * Ambient looking: specs currently in a list. Tracked as a MobX computed —
+     * occupancy retracts when the getter stops returning them.
+     */
+    setComputedAttention(fn: () => AttentionSource): void;
+    /**
+     * Focused looking: the one-of-a-kind spec in the UI. Tracked as a MobX
+     * computed — occupancy retracts when the getter returns null.
+     */
+    setComputedAttentionFocus(fn: () => AttentionSubject | null | undefined): void;
+    request(method: string, params?: unknown): Promise<unknown>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAItB,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAAC,iBAAiB,EAAC,MAAM,aAAa,CAAC;AAG9C,OAAO,EAAiB,aAAa,EAAC,MAAM,mCAAmC,CAAC;AAEhF,OAAO,EAAkB,YAAY,EAAE,KAAK,UAAU,EAAC,MAAM,0BAA0B,CAAC;AACxF,OAAO,EAAC,aAAa,EAAE,KAAK,WAAW,EAAC,MAAM,2BAA2B,CAAC;AAM1E,qBAAa,MAAO,YAAW,eAAe;;IAmI1C,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,YAAY,EAAE,YAAY;IACnC,QAAQ,CAAC,aAAa,EAAE,aAAa;IACrC,QAAQ,CAAC,aAAa,EAAE,aAAa;IACrC,QAAQ,CAAC,cAAc,EAAE,iBAAiB,GAAG,IAAI;IACjD,QAAQ,CAAC,eAAe,EAAE,iBAAiB,GAAG,IAAI;IAzIpD,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAErE;IAED,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1F;IA2HD,YACW,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,aAAa,EAC5B,cAAc,GAAE,iBAAiB,GAAG,IAAW,EAC/C,eAAe,GAAE,iBAAiB,GAAG,IAAW,EAG1D;IAED,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED,IAAI,WAAW,IAAI,WAAW,CAE7B;IAED;;;OAGG;IACH,oBAAoB,CAAC,EAAE,EAAE,MAAM,eAAe,GAAG,IAAI,CAOpD;IAED;;;OAGG;IACH,yBAAyB,CAAC,EAAE,EAAE,MAAM,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAU7E;IAED,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,OAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAU9D;IAgDK,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAiB3C;CACF"}