@pencere/cli 0.0.0-stage → 0.1.0

package/dist/connector.js

@@ -0,0 +1,90 @@
+/**
+ * The program's MCP server, stood in for by a process.
+ *
+ * `serve` of the SDK takes anything that can `connect` a transport and `close`
+ * the session, and does everything else of a pencere program: the question to the
+ * terminal, the token, the bundle, ⌃C and `bye`, the host starting the view again
+ * (§10.7) and the program reopening it (§10.8). It connects once for each view it
+ * opens. This is that server for a program that has none of its own: it starts the
+ * command for each connection and carries the JSON-RPC messages between the
+ * terminal's stream and the command's stdio, line by line, untouched. A server
+ * that has been connected to a view once has done its `initialize`; the next view
+ * is a new session, and so a new process, which is also what a stdio server
+ * expects: one `initialize` for the life of the process.
+ */
+import { CLOSE_TIMING, ServerProcess } from "./server-process.js";
+export class ProcessConnector {
+    #spec;
+    #options;
+    #current;
+    #ending = new Set();
+    #starts = 0;
+    constructor(spec, options) {
+        this.#spec = spec;
+        this.#options = options;
+    }
+    /** How many processes this connector has started: one for each view that was opened. */
+    get starts() {
+        return this.#starts;
+    }
+    /** @throws {StartError} when the command cannot be started. */
+    async connect(transport) {
+        // One process for one session: the last is gone before the next begins.
+        await this.close();
+        const { tail, unexpectedExit, timing } = this.#options;
+        const server = new ServerProcess(this.#spec, tail, timing ?? CLOSE_TIMING);
+        server.onmessage = (message) => {
+            // A view that is gone has no use for the answer, and says so by failing here.
+            transport.send(message).catch(() => { });
+        };
+        server.onerror = (error) => tail.push(`pencere: ${error.message}\n`);
+        server.onexit = (exit) => {
+            if (!exit.expected)
+                unexpectedExit(exit);
+        };
+        transport.onmessage = (message) => {
+            // A server that is gone cannot be written to, and says so by ending (`unexpectedExit`).
+            server.send(message).catch(() => { });
+        };
+        transport.onclose = () => {
+            void server.close();
+        };
+        try {
+            await transport.start();
+            await server.start();
+            this.#starts += 1;
+        }
+        catch (error) {
+            transport.onmessage = undefined;
+            transport.onclose = undefined;
+            throw error;
+        }
+        this.#current = { server, transport };
+    }
+    /** Ends the process of the session that is connected, if there is one, and resolves when it is gone. */
+    async close() {
+        const current = this.#current;
+        this.#current = undefined;
+        if (current === undefined)
+            return;
+        const ending = current.server.close().then(() => current.transport.close());
+        this.#ending.add(ending);
+        try {
+            await ending;
+        }
+        finally {
+            this.#ending.delete(ending);
+        }
+    }
+    /**
+     * Resolves when every process this connector started has ended. `serve` lets go of
+     * a session without waiting for it (a signal must not wait for a stubborn server),
+     * and a program that is about to leave has to.
+     */
+    async drain() {
+        await this.close();
+        while (this.#ending.size > 0)
+            await Promise.all([...this.#ending]);
+    }
+}
+//# sourceMappingURL=connector.js.map

package/dist/connector.js.map

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

package/dist/dev.d.ts

@@ -0,0 +1,86 @@
+/**
+ * `pencere dev`: what a change to the files comes to.
+ *
+ * `pencere run` shows a view once. `pencere dev` watches the files of the view and
+ * the files the server reads, and when they change it has the SDK close the view
+ * and open it again (`ViewControl.reopen`, specification §10.8): the old view and
+ * the server of its session are gone, the server is started again as for any view,
+ * and the new view's files are checked against what the terminal already holds,
+ * so only the files that changed cross the stream. Nothing of that is this file's:
+ * what is, is deciding *when*.
+ *
+ * - **A burst is one reopening.** A build writes many files; the change is acted
+ *   on once the files have been quiet for a moment (`settle`), and a change that
+ *   comes while a reopening is under way is acted on after it, again after a
+ *   moment of quiet.
+ * - **Only what changed.** A change to the view's directory is a reopening when
+ *   the files it holds are different from what the view shows (a file saved as it
+ *   was, or one that is not part of a view, changes nothing). A change to
+ *   `--watch`'s paths is a reopening when what the paths hold has moved (their
+ *   size or modification time): the events of one write that arrive late are not
+ *   a second write.
+ * - **A half-built view waits.** A build that has emptied its output directory
+ *   leaves something that is not a view; that is not shown, and the next change,
+ *   which is the build writing more, is looked at in its turn.
+ * - **A view that is not there yet waits too.** A change that comes before the
+ *   first view is up is asked again a few times, a moment apart.
+ *
+ * What the person gets to know is said after the view has closed (`notes`): the
+ * screen is the view's while it is up. A `serve` that ended because the program ended it
+ * (its server fell) is not the end of the reloading: the program starts `serve` again, and
+ * the next change is what it waits for.
+ */
+import type { Bundle, ReopenOptions, ReopenResult } from "@pencere/sdk";
+/** How long `Reloader` waits, and how often it asks again. */
+export interface ReloadTiming {
+    /** The quiet, in milliseconds, after which the changes so far are acted on. */
+    readonly settle: number;
+    /** How long to wait, in milliseconds, before asking again for a view that is not up yet. */
+    readonly retry: number;
+    /** How many times to ask again before leaving the change for the next one to carry. */
+    readonly tries: number;
+}
+/** What `Reloader` needs of the program's hand on its view: `ViewControl`'s `reopen`. */
+export interface Reopener {
+    reopen(next: ReopenOptions): Promise<ReopenResult>;
+}
+export interface ReloaderOptions {
+    readonly control: Reopener;
+    /** The directory the view's files are in (`--view`), absent when the terminal reads the server's own resource. */
+    readonly view?: string;
+    /** What the view was first opened with. */
+    readonly bundle?: Bundle;
+    /** What the server's own files (`--watch`) hold, in a form that changes when they do. Without it every change to them counts. */
+    readonly fingerprint?: () => Promise<string>;
+    readonly timing: ReloadTiming;
+    /** Reads the view's files. `bundleFromDirectory`, unless a test lends another. */
+    readonly load?: (directory: string) => Promise<Bundle>;
+}
+/** Closes the view and opens it again when what it is made of, or the server, changed. */
+export declare class Reloader {
+    #private;
+    constructor(options: ReloaderOptions);
+    /**
+     * Notes what the view's files and the server's own hold now, as the view that is about to open
+     * sees them, and says which view's files those are. Call once the files are being watched: what
+     * was saved before is in what is read, and what is saved after tells of itself, but a save in
+     * between, with the files read first and the watching begun after, would be neither. A view
+     * directory that cannot be read just then (a build that is half done) leaves what the reloader
+     * was given, and the change that made it unreadable is looked at in its turn.
+     */
+    start(): Promise<Bundle | undefined>;
+    /** How many times the view has been reopened. */
+    get reopened(): number;
+    /** What to tell the person once the view has closed. */
+    get notes(): readonly string[];
+    /** Something under the view's directory changed. */
+    viewChanged(): void;
+    /** Something of the server's own files changed. */
+    serverChanged(): void;
+    /** Something to tell the person afterwards that is not a change: a watcher that failed. */
+    warn(text: string): void;
+    /** No more reopenings: the view has ended, or cannot be reopened. */
+    stop(): void;
+    /** Resolves when nothing is waiting to be acted on and nothing is being acted on. */
+    settled(): Promise<void>;
+}

package/dist/dev.js

@@ -0,0 +1,254 @@
+/**
+ * `pencere dev`: what a change to the files comes to.
+ *
+ * `pencere run` shows a view once. `pencere dev` watches the files of the view and
+ * the files the server reads, and when they change it has the SDK close the view
+ * and open it again (`ViewControl.reopen`, specification §10.8): the old view and
+ * the server of its session are gone, the server is started again as for any view,
+ * and the new view's files are checked against what the terminal already holds,
+ * so only the files that changed cross the stream. Nothing of that is this file's:
+ * what is, is deciding *when*.
+ *
+ * - **A burst is one reopening.** A build writes many files; the change is acted
+ *   on once the files have been quiet for a moment (`settle`), and a change that
+ *   comes while a reopening is under way is acted on after it, again after a
+ *   moment of quiet.
+ * - **Only what changed.** A change to the view's directory is a reopening when
+ *   the files it holds are different from what the view shows (a file saved as it
+ *   was, or one that is not part of a view, changes nothing). A change to
+ *   `--watch`'s paths is a reopening when what the paths hold has moved (their
+ *   size or modification time): the events of one write that arrive late are not
+ *   a second write.
+ * - **A half-built view waits.** A build that has emptied its output directory
+ *   leaves something that is not a view; that is not shown, and the next change,
+ *   which is the build writing more, is looked at in its turn.
+ * - **A view that is not there yet waits too.** A change that comes before the
+ *   first view is up is asked again a few times, a moment apart.
+ *
+ * What the person gets to know is said after the view has closed (`notes`): the
+ * screen is the view's while it is up. A `serve` that ended because the program ended it
+ * (its server fell) is not the end of the reloading: the program starts `serve` again, and
+ * the next change is what it waits for.
+ */
+import { BundleError, bundleFromDirectory } from "@pencere/sdk";
+function merged(a, b) {
+    return a === undefined ? b : { view: a.view || b.view, server: a.server || b.server };
+}
+/** Whether `bundle` holds the files `shown` does, byte for byte, under the same entry. */
+function sameFiles(bundle, shown) {
+    return shown !== undefined && JSON.stringify(bundle.manifest) === JSON.stringify(shown.manifest);
+}
+function why(error) {
+    if (error instanceof BundleError)
+        return error.message;
+    const code = error?.code;
+    if (code === "ENOENT")
+        return "a file went away while it was read";
+    return error instanceof Error ? error.message : String(error);
+}
+/** Closes the view and opens it again when what it is made of, or the server, changed. */
+export class Reloader {
+    #options;
+    #notes = [];
+    #waiting = [];
+    /** The files the view shows now. */
+    #shown;
+    /** What the server's files held when the view was last opened. */
+    #serverPrint;
+    /** Changes to act on once the files are quiet. */
+    #pending;
+    /** Changes that could not be acted on, which the next change carries along. */
+    #held;
+    #timer;
+    #running;
+    #stopped = false;
+    #tries = 0;
+    /** Why the view's files could not be read at the last change, while that is so. */
+    #problem;
+    #reopened = 0;
+    constructor(options) {
+        this.#options = options;
+        this.#shown = options.bundle;
+    }
+    /**
+     * Notes what the view's files and the server's own hold now, as the view that is about to open
+     * sees them, and says which view's files those are. Call once the files are being watched: what
+     * was saved before is in what is read, and what is saved after tells of itself, but a save in
+     * between, with the files read first and the watching begun after, would be neither. A view
+     * directory that cannot be read just then (a build that is half done) leaves what the reloader
+     * was given, and the change that made it unreadable is looked at in its turn.
+     */
+    async start() {
+        this.#serverPrint = await this.#options.fingerprint?.();
+        const { view } = this.#options;
+        if (view !== undefined) {
+            try {
+                this.#shown = await (this.#options.load ?? bundleFromDirectory)(view);
+            }
+            catch {
+                // What it was given stays, and the next change looks again.
+            }
+        }
+        return this.#shown;
+    }
+    /** How many times the view has been reopened. */
+    get reopened() {
+        return this.#reopened;
+    }
+    /** What to tell the person once the view has closed. */
+    get notes() {
+        const notes = [...this.#notes];
+        if (this.#problem !== undefined)
+            notes.push(`the last change to the view's files could not be shown (${this.#problem}); the view is as the change before it left it`);
+        else if (this.#held !== undefined)
+            notes.push("the last change was not shown, because there was no view to show it in");
+        return notes;
+    }
+    /** Something under the view's directory changed. */
+    viewChanged() {
+        this.#note({ view: true, server: false });
+    }
+    /** Something of the server's own files changed. */
+    serverChanged() {
+        this.#note({ view: false, server: true });
+    }
+    /** Something to tell the person afterwards that is not a change: a watcher that failed. */
+    warn(text) {
+        this.#notes.push(text);
+    }
+    /** No more reopenings: the view has ended, or cannot be reopened. */
+    stop() {
+        this.#stopped = true;
+        this.#disarm();
+        this.#pending = undefined;
+        this.#release();
+    }
+    /** Resolves when nothing is waiting to be acted on and nothing is being acted on. */
+    settled() {
+        if (this.#idle())
+            return Promise.resolve();
+        return new Promise((resolve) => this.#waiting.push(resolve));
+    }
+    #idle() {
+        return this.#timer === undefined && this.#running === undefined && this.#pending === undefined;
+    }
+    #release() {
+        if (!this.#idle())
+            return;
+        for (const resolve of this.#waiting.splice(0))
+            resolve();
+    }
+    #note(change) {
+        if (this.#stopped)
+            return;
+        // What could not be acted on before is carried along with this one.
+        const carried = merged(this.#pending, change);
+        this.#pending = this.#held === undefined ? carried : merged(carried, this.#held);
+        this.#held = undefined;
+        this.#tries = 0;
+        this.#arm(this.#options.timing.settle);
+    }
+    #arm(delay) {
+        this.#disarm();
+        this.#timer = setTimeout(() => {
+            this.#timer = undefined;
+            this.#kick();
+        }, delay);
+    }
+    #disarm() {
+        if (this.#timer !== undefined)
+            clearTimeout(this.#timer);
+        this.#timer = undefined;
+    }
+    #kick() {
+        if (this.#running !== undefined || this.#stopped)
+            return;
+        this.#running = this.#pass().finally(() => {
+            this.#running = undefined;
+            // What came while this ran has had its moment of quiet only if nothing came since.
+            if (!this.#stopped && this.#pending !== undefined && this.#timer === undefined)
+                this.#arm(this.#options.timing.settle);
+            this.#release();
+        });
+    }
+    async #pass() {
+        const change = this.#pending;
+        this.#pending = undefined;
+        if (change === undefined)
+            return;
+        try {
+            await this.#act(change);
+        }
+        catch (error) {
+            // Looking at the files must not end the view the person is looking at.
+            this.#notes.push(`could not look at the files: ${why(error)}`);
+        }
+    }
+    async #act(change) {
+        const { view, fingerprint } = this.#options;
+        let serverPrint;
+        let serverMoved = false;
+        if (change.server) {
+            serverPrint = await fingerprint?.();
+            serverMoved = serverPrint === undefined || serverPrint !== this.#serverPrint;
+        }
+        let bundle;
+        let viewMoved = false;
+        if (change.view && view !== undefined) {
+            try {
+                bundle = await (this.#options.load ?? bundleFromDirectory)(view);
+            }
+            catch (error) {
+                // A build that is half done: the next change is the rest of it.
+                this.#problem = why(error);
+                this.#held = merged(this.#held, change);
+                return;
+            }
+            this.#problem = undefined;
+            viewMoved = !sameFiles(bundle, this.#shown);
+        }
+        if (!viewMoved && !serverMoved)
+            return;
+        const result = await this.#options.control.reopen(viewMoved && bundle !== undefined ? { bundle } : {});
+        switch (result.kind) {
+            case "reopened":
+                this.#reopened += 1;
+                if (viewMoved)
+                    this.#shown = bundle;
+                if (serverMoved)
+                    this.#serverPrint = serverPrint;
+                return;
+            case "unsupported":
+                this.#notes.push("this terminal does not reopen a view when asked, so `pencere dev` ran the view as `pencere run` does and the changes were not shown: close it and run it again to see them");
+                this.stop();
+                return;
+            case "no-view":
+                if (result.reason === "aborted") {
+                    // `serve` was ended by the program's own hand, which is not the terminal refusing:
+                    // the server fell, and what comes next is the program's to decide. The files that
+                    // were asked for are what came of it, and the same files are not tried again.
+                    if (viewMoved)
+                        this.#shown = bundle;
+                    if (serverMoved)
+                        this.#serverPrint = serverPrint;
+                    return;
+                }
+                // The new view was refused or could not start: `serve` says why as it ends.
+                this.stop();
+                return;
+            case "unavailable": {
+                const { retry, tries } = this.#options.timing;
+                if (this.#tries < tries) {
+                    this.#tries += 1;
+                    this.#pending = merged(this.#pending, change);
+                    this.#arm(retry);
+                }
+                else {
+                    this.#held = merged(this.#held, change);
+                }
+                return;
+            }
+        }
+    }
+}
+//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

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

package/dist/discover.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Which tool's view to show, when the person did not say.
+ *
+ * The server is started once, for as long as it takes to ask it: `initialize` and
+ * `tools/list`, as any MCP client does. The tool that names a view is the one
+ * whose `_meta.ui.resourceUri` does (MCP Apps, Resource Discovery; the flat
+ * `_meta["ui/resourceUri"]` of the first drafts, which the extension's own
+ * libraries still read, counts too). One such tool is the answer. None, or several,
+ * is for the person to settle, and the answer says which tools there were. The list is read page
+ * by page, as far as the terminal reads it ({@link MAX_TOOL_PAGES}).
+ */
+import type { CloseTiming, ServerCommand } from "./server-process.js";
+import type { Tail } from "./tail.js";
+/**
+ * The most pages of tools that are read: what the terminal reads of the same server, so that a
+ * tool the terminal would not find is not the tool this finds, and a server that never stops
+ * listing does not keep this asking.
+ */
+export declare const MAX_TOOL_PAGES = 16;
+/** What the server has with it. */
+export type Discovery = {
+    readonly kind: "found";
+    readonly tool: string;
+}
+/** No tool names a view. `tools` is every tool the server has. */
+ | {
+    readonly kind: "none";
+    readonly tools: readonly string[];
+}
+/** Several do: their names. */
+ | {
+    readonly kind: "many";
+    readonly tools: readonly string[];
+};
+export interface DiscoverOptions {
+    /** The version `pencere` calls itself, in the handshake. */
+    readonly version: string;
+    /** How long the server has to answer each question, in milliseconds. */
+    readonly timeout: number;
+    /** The person interrupted: the server is let go and the question ends. */
+    readonly signal?: AbortSignal;
+    readonly timing?: CloseTiming;
+}
+/** The server was started and did not answer as an MCP server does. */
+export declare class DiscoveryError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** The person interrupted while the server was being asked. */
+export declare class Interrupted extends Error {
+    constructor();
+}
+/**
+ * The `ui://` resource a tool names, in either of the two places MCP Apps has had it. An address
+ * of another scheme is no view: the terminal reads `ui://` resources only, and a tool it would
+ * refuse is not a tool to show.
+ */
+export declare function viewOf(tool: {
+    readonly _meta?: unknown;
+}): string | undefined;
+/**
+ * @throws {StartError} when the command cannot be started
+ * @throws {DiscoveryError} when it started and did not answer as an MCP server
+ * @throws {Interrupted} when `signal` aborted
+ */
+export declare function discoverTool(spec: ServerCommand, tail: Tail, options: DiscoverOptions): Promise<Discovery>;

package/dist/discover.js

@@ -0,0 +1,110 @@
+/**
+ * Which tool's view to show, when the person did not say.
+ *
+ * The server is started once, for as long as it takes to ask it: `initialize` and
+ * `tools/list`, as any MCP client does. The tool that names a view is the one
+ * whose `_meta.ui.resourceUri` does (MCP Apps, Resource Discovery; the flat
+ * `_meta["ui/resourceUri"]` of the first drafts, which the extension's own
+ * libraries still read, counts too). One such tool is the answer. None, or several,
+ * is for the person to settle, and the answer says which tools there were. The list is read page
+ * by page, as far as the terminal reads it ({@link MAX_TOOL_PAGES}).
+ */
+import { Client } from "@modelcontextprotocol/client";
+import { ServerProcess, StartError } from "./server-process.js";
+import { plain } from "./tail.js";
+/**
+ * The most pages of tools that are read: what the terminal reads of the same server, so that a
+ * tool the terminal would not find is not the tool this finds, and a server that never stops
+ * listing does not keep this asking.
+ */
+export const MAX_TOOL_PAGES = 16;
+/** The server was started and did not answer as an MCP server does. */
+export class DiscoveryError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "DiscoveryError";
+    }
+}
+/** The person interrupted while the server was being asked. */
+export class Interrupted extends Error {
+    constructor() {
+        super("interrupted");
+        this.name = "Interrupted";
+    }
+}
+/**
+ * The `ui://` resource a tool names, in either of the two places MCP Apps has had it. An address
+ * of another scheme is no view: the terminal reads `ui://` resources only, and a tool it would
+ * refuse is not a tool to show.
+ */
+export function viewOf(tool) {
+    const meta = tool._meta;
+    if (typeof meta !== "object" || meta === null)
+        return undefined;
+    const record = meta;
+    const ui = record.ui;
+    if (typeof ui === "object" && ui !== null) {
+        const uri = ui.resourceUri;
+        if (typeof uri === "string" && uri.startsWith("ui://"))
+            return uri;
+    }
+    const flat = record["ui/resourceUri"];
+    return typeof flat === "string" && flat.startsWith("ui://") ? flat : undefined;
+}
+/**
+ * @throws {StartError} when the command cannot be started
+ * @throws {DiscoveryError} when it started and did not answer as an MCP server
+ * @throws {Interrupted} when `signal` aborted
+ */
+export async function discoverTool(spec, tail, options) {
+    const { signal, timeout } = options;
+    if (signal?.aborted)
+        throw new Interrupted();
+    const server = new ServerProcess(spec, tail, options.timing);
+    const client = new Client({ name: "pencere", version: options.version });
+    // Closing the process fails whatever the client is waiting for.
+    const abort = () => void server.close();
+    signal?.addEventListener("abort", abort, { once: true });
+    try {
+        await client.connect(server, { timeout });
+        const tools = [];
+        let cursor;
+        // A server that says it has no tools is asked for none, as `listTools` would not ask it.
+        const asking = client.getServerCapabilities()?.tools !== undefined;
+        for (let pages = 1; asking; pages += 1) {
+            // A page at a time, as the terminal reads them: `listTools` without a cursor reads
+            // them all, to a limit of its own, which is not the terminal's.
+            const page = await client.request({ method: "tools/list", params: cursor === undefined ? {} : { cursor } }, { timeout });
+            tools.push(...page.tools);
+            cursor = page.nextCursor;
+            if (cursor === undefined)
+                break;
+            if (pages >= MAX_TOOL_PAGES)
+                throw new DiscoveryError(`the server has more than ${MAX_TOOL_PAGES} pages of tools`);
+        }
+        const withView = tools.filter((tool) => viewOf(tool) !== undefined).map((tool) => tool.name);
+        const [first, ...others] = withView;
+        if (first === undefined)
+            return { kind: "none", tools: tools.map((tool) => tool.name) };
+        return others.length === 0 ? { kind: "found", tool: first } : { kind: "many", tools: withView };
+    }
+    catch (error) {
+        if (signal?.aborted)
+            throw new Interrupted();
+        // A process that could not be started says so itself, wherever the client put it.
+        if (error instanceof StartError)
+            throw error;
+        if (error instanceof Error && error.cause instanceof StartError)
+            throw error.cause;
+        if (error instanceof DiscoveryError)
+            throw error;
+        // What the server said is shown as text: an error message is its to write.
+        throw new DiscoveryError(`"${spec.command}" did not answer as an MCP server that speaks stdio does: ${plain(error instanceof Error ? error.message : String(error))}`, { cause: error });
+    }
+    finally {
+        signal?.removeEventListener("abort", abort);
+        await client.close().catch(() => { });
+        await server.close();
+    }
+}
+//# sourceMappingURL=discover.js.map

package/dist/discover.js.map

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

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+/** The `pencere` command. */
+export {};

package/dist/main.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/** The `pencere` command. */
+import { run, systemEnvironment } from "./run.js";
+// A terminal that is gone (ssh dropped, a window closed) fails what is written to it and read
+// from it, as an `error` of the stream. Nothing listens for it by default, and an `error` nobody
+// listens for ends the process in the middle of letting go of the server, which is then left running.
+for (const stream of [process.stdin, process.stdout, process.stderr])
+    stream.on("error", () => { });
+const finish = await run(process.argv.slice(2), systemEnvironment());
+if ("signal" in finish) {
+    // What the person sent (or the terminal, going away) ended the view and the server, and now
+    // ends this process as it would have ended any other: the shell reads the signal in the
+    // status (130, 143, 129).
+    process.kill(process.pid, finish.signal);
+    // The signal is delivered at once; this is for a platform where it is not.
+    await new Promise((resolve) => setTimeout(resolve, 1000));
+    process.exit({ SIGINT: 130, SIGTERM: 143, SIGHUP: 129 }[finish.signal]);
+}
+// A server's pipes or a stream the terminal left open must not keep the process.
+process.exit(finish.code);
+//# sourceMappingURL=main.js.map