@ahpd/web 0.0.0-stage → 0.1.0

package/dist/cli/serve.js

@@ -0,0 +1,207 @@
+import { spawn } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { ArgumentError, ConfigurationError } from '@cofold/commands';
+import { resolveConfig } from '@cofold/config';
+import { createWebServer } from './server.js';
+/** The port the page is served on unless one is named. */
+export const DEFAULT_PORT = 5190;
+/** The address bound unless one is named. */
+export const DEFAULT_HOST = '127.0.0.1';
+/**
+ * `serve`'s flags. Each is also a key in `~/.config/ahpw/config.json`, spelled
+ * the same without the dashes. None has a `default`, so a flag can be told
+ * apart from the file; the defaults are in `settingsOf`.
+ */
+export const serveFields = {
+    connect: {
+        type: 'string',
+        description: 'The AHP server\'s socket, as ws://HOST:PORT or wss://HOST:PORT. A tkn in it is the token. Default AHPD_URL, then AHPD_HOST.',
+        cli: { value: 'URL' },
+    },
+    token: {
+        type: 'string',
+        description: 'Add this token to the socket, so the page asks for none. Default the tkn in the socket, then AHPD_TOKEN.',
+        cli: { value: 'SECRET' },
+    },
+    tokenFile: {
+        type: 'string',
+        description: 'Read the token to add from this file.',
+        cli: { value: 'PATH' },
+    },
+    host: {
+        type: 'string',
+        description: `Bind here. Default ${DEFAULT_HOST}.`,
+        cli: { value: 'ADDR' },
+    },
+    port: {
+        type: 'integer',
+        description: `Listen here. Default ${DEFAULT_PORT}; 0 picks a free one.`,
+        cli: { value: 'N' },
+    },
+    open: {
+        type: 'boolean',
+        description: 'Open the page in a browser once it is served.',
+    },
+};
+const KINDS = {
+    connect: 'string', token: 'string', tokenFile: 'string', host: 'string', port: 'number', open: 'boolean',
+};
+/** `~` at the start of a path, as a shell would read it. A config file has no shell. */
+const expand = (path) => (path === '~' || path.startsWith('~/') ? homedir() + path.slice(1) : path);
+/** The variables `serve` reads, below the file. */
+export const ENVIRONMENT = { url: 'AHPD_URL', host: 'AHPD_HOST', token: 'AHPD_TOKEN' };
+/**
+ * A daemon's socket from what a person wrote. `http` and `https` name the same
+ * port as `ws` and `wss`, and a bare `HOST:PORT` is taken as `ws://HOST:PORT`.
+ */
+function socketOf(text, from) {
+    let url;
+    try {
+        url = new URL(/^[a-z][a-z0-9+.-]*:\/\//i.test(text) ? text : `ws://${text}`);
+    }
+    catch {
+        throw new ArgumentError(`${from} is not a URL: ${text}.`);
+    }
+    if (url.protocol === 'http:')
+        url.protocol = 'ws:';
+    else if (url.protocol === 'https:')
+        url.protocol = 'wss:';
+    if (url.protocol !== 'ws:' && url.protocol !== 'wss:')
+        throw new ArgumentError(`${from} takes ws://, wss://, http:// or https://, not ${url.protocol}//.`);
+    return url;
+}
+/** A layer with its socket read, and the socket's `tkn` taken out as the layer's token. */
+function lifted(layer, from) {
+    if (typeof layer.connect !== 'string')
+        return layer;
+    const url = socketOf(layer.connect, from);
+    const tkn = url.searchParams.get('tkn');
+    if (tkn === null)
+        return { ...layer, connect: url };
+    if (layer.token !== undefined || layer.tokenFile !== undefined)
+        throw new ArgumentError(`${from} has a tkn, and a token is also given. Pass one.`);
+    url.searchParams.delete('tkn');
+    return { ...layer, connect: url, token: tkn };
+}
+/** `AHPD_URL` or else `AHPD_HOST`, with the token in its `tkn` or else `AHPD_TOKEN`. */
+function environmentLayer(env) {
+    const named = [ENVIRONMENT.url, ENVIRONMENT.host].find((name) => (env[name] ?? '') !== '');
+    const layer = named === undefined ? {} : lifted({ connect: env[named] }, named);
+    const token = env[ENVIRONMENT.token] ?? '';
+    return layer.token === undefined && token !== '' ? { ...layer, token } : layer;
+}
+const holdsSecret = (layer) => layer.token !== undefined || layer.tokenFile !== undefined;
+/**
+ * The flags over the file over the environment, checked, with the defaults filled in.
+ *
+ * A flag beats the file, and the file beats the environment. `token`,
+ * `tokenFile` and a `tkn` in the socket are one secret: two from the same place
+ * are refused, and the highest place that gives one replaces the others.
+ */
+export function settingsOf(flags, file, env, read = (path) => readFileSync(path, 'utf8')) {
+    for (const [key, value] of Object.entries(file)) {
+        const kind = KINDS[key];
+        if (kind === undefined)
+            throw new ConfigurationError(`The configuration has a key serve does not take: ${key}.`);
+        if (typeof value !== kind || (key === 'port' && !Number.isInteger(value)))
+            throw new ConfigurationError(`The configuration's ${key} is not a${kind === 'number' ? 'n integer' : ` ${kind}`}.`);
+    }
+    if (flags['token'] !== undefined && flags['tokenFile'] !== undefined)
+        throw new ArgumentError('Pass --token or --token-file, not both.');
+    if (file['token'] !== undefined && file['tokenFile'] !== undefined)
+        throw new ConfigurationError('The configuration has token and tokenFile. Keep one.');
+    const layers = [environmentLayer(env), lifted(file, 'The configuration\'s connect'), lifted(flags, '--connect')];
+    const secretFrom = layers.findLast(holdsSecret) ?? {};
+    const merged = { ...layers[1], ...layers[2], connect: layers.findLast((layer) => layer.connect !== undefined)?.connect, token: secretFrom.token, tokenFile: secretFrom.tokenFile };
+    const connect = merged.connect;
+    if (!(connect instanceof URL))
+        throw new ArgumentError(`Pass --connect with the AHP server's socket, as ws://127.0.0.1:PORT, or set ${ENVIRONMENT.url}.`);
+    let held;
+    if (typeof merged.tokenFile === 'string') {
+        try {
+            held = read(expand(merged.tokenFile));
+        }
+        catch {
+            throw new ArgumentError(`No token file at ${merged.tokenFile}.`);
+        }
+    }
+    else if (typeof merged.token === 'string')
+        held = merged.token;
+    const token = held?.trim();
+    if (token === '')
+        throw new ArgumentError('The token is empty.');
+    const port = merged.port ?? DEFAULT_PORT;
+    if (port < 0 || port > 65_535)
+        throw new ArgumentError(`--port is not a port: ${port}.`);
+    return {
+        connect,
+        ...(token === undefined ? {} : { token }),
+        host: merged.host ?? DEFAULT_HOST,
+        port,
+        open: merged.open === true,
+    };
+}
+/** Whether an address is this machine only. */
+const loopback = (host) => host === 'localhost' || host === '::1' || host.startsWith('127.');
+/** What to say before serving, when something is reachable that a person may not expect. */
+export function warningsOf(settings) {
+    const said = [];
+    if (!loopback(settings.host)) {
+        said.push(`ahpw: ${settings.host} is reached over plain http and ws.${settings.token === undefined ? '' : ' Anyone who reaches it uses the AHP server with the token ahpw adds.'}`);
+    }
+    if (settings.token !== undefined && settings.connect.protocol === 'ws:' && !loopback(settings.connect.hostname.replace(/^\[|\]$/g, ''))) {
+        said.push(`ahpw: the token travels in cleartext to ${settings.connect.host}.`);
+    }
+    return said;
+}
+/** The page's address as a browser would type it. */
+const pageUrl = (host, port) => {
+    const shown = host === '0.0.0.0' || host === '::' ? '127.0.0.1' : host;
+    return `http://${shown.includes(':') ? `[${shown}]` : shown}:${port}/`;
+};
+/** Opens `url` in the desktop's browser, and says nothing when there is none. */
+function openBrowser(url) {
+    const [command, ...args] = process.platform === 'darwin' ? ['open', url] : process.platform === 'win32' ? ['cmd', '/c', 'start', '', url] : ['xdg-open', url];
+    try {
+        const child = spawn(command, args, { detached: true, stdio: 'ignore' });
+        child.on('error', () => undefined);
+        child.unref();
+    }
+    catch {
+        // No browser to open: the address is printed either way.
+    }
+}
+/** `ahpw serve`: the page, and its socket carried to a daemon. Runs until stopped. */
+export const declareServe = (registry, app) => registry.action({
+    id: 'serve',
+    summary: 'Serve the page, connected to an AHP server',
+    description: 'Serves the web UI and carries its socket to the AHP server --connect names. With a token, the page asks for none.',
+    surfaces: { cli: { pattern: ['serve'] } },
+    input: serveFields,
+    run: async (context) => {
+        const named = context.globals['config'];
+        const file = resolveConfig(typeof named === 'string'
+            ? { name: 'ahpw', path: named, user: false, environment: false }
+            : { name: 'ahpw' });
+        const settings = settingsOf(context.input, file.values, process.env);
+        for (const line of warningsOf(settings))
+            process.stderr.write(`${line}\n`);
+        const { server, stop } = createWebServer({ app, upstream: settings.connect, token: settings.token });
+        await new Promise((resolve, reject) => {
+            server.once('error', reject);
+            server.listen(settings.port, settings.host, () => resolve());
+        });
+        const bound = server.address();
+        const url = pageUrl(settings.host, typeof bound === 'object' && bound !== null ? bound.port : settings.port);
+        process.stderr.write(`ahpw: serving ${url}, connected to ${settings.connect.origin}${settings.connect.pathname === '/' ? '' : settings.connect.pathname}.\n`);
+        if (settings.open)
+            openBrowser(url);
+        await new Promise((resolve) => {
+            const end = () => void stop().then(resolve);
+            process.once('SIGINT', end);
+            process.once('SIGTERM', end);
+        });
+    },
+});
+//# sourceMappingURL=serve.js.map

package/dist/cli/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../cli/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAA2C,MAAM,kBAAkB,CAAC;AAC9G,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,0DAA0D;AAC1D,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AAEjC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE;QACP,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,6HAA6H;QAC1I,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;KACtB;IACD,KAAK,EAAE;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,0GAA0G;QACvH,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;KACzB;IACD,SAAS,EAAE;QACT,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,uCAAuC;QACpD,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;KACvB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,sBAAsB,YAAY,GAAG;QAClD,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;KACvB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,wBAAwB,YAAY,uBAAuB;QACxE,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;KACpB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,+CAA+C;KAC7D;CAC8B,CAAC;AAalC,MAAM,KAAK,GAAuD;IAChE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS;CACzG,CAAC;AAEF,wFAAwF;AACxF,MAAM,MAAM,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAEpH,mDAAmD;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAW,CAAC;AAKhG;;;GAGG;AACH,SAAS,QAAQ,CAAC,IAAY,EAAE,IAAY;IAC1C,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC/E,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,aAAa,CAAC,GAAG,IAAI,kBAAkB,IAAI,GAAG,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO;QAAE,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC;SAC9C,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ;QAAE,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC;IAC1D,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,IAAI,GAAG,CAAC,QAAQ,KAAK,MAAM;QAAE,MAAM,IAAI,aAAa,CAAC,GAAG,IAAI,kDAAkD,GAAG,CAAC,QAAQ,KAAK,CAAC,CAAC;IAC3J,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2FAA2F;AAC3F,SAAS,MAAM,CAAC,KAAY,EAAE,IAAY;IACxC,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpD,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IACpD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;QAAE,MAAM,IAAI,aAAa,CAAC,GAAG,IAAI,kDAAkD,CAAC,CAAC;IACnJ,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAChD,CAAC;AAED,wFAAwF;AACxF,SAAS,gBAAgB,CAAC,GAAiD;IACzE,MAAM,KAAK,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3F,MAAM,KAAK,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3C,OAAO,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACjF,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,KAAY,EAAW,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC;AAE1G;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,KAAwC,EAAE,IAAuC,EAAE,GAAiD,EAAE,OAAiC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC;IACpO,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAyB,CAAC,CAAC;QAC9C,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,kBAAkB,CAAC,oDAAoD,GAAG,GAAG,CAAC,CAAC;QACjH,IAAI,OAAO,KAAK,KAAK,IAAI,IAAI,CAAC,GAAG,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAAE,MAAM,IAAI,kBAAkB,CAAC,uBAAuB,GAAG,YAAY,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,GAAG,CAAC,CAAC;IACjM,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,CAAC,KAAK,SAAS;QAAE,MAAM,IAAI,aAAa,CAAC,yCAAyC,CAAC,CAAC;IACzI,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,SAAS;QAAE,MAAM,IAAI,kBAAkB,CAAC,sDAAsD,CAAC,CAAC;IACzJ,MAAM,MAAM,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,8BAA8B,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;IACjH,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,MAAM,GAAU,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,SAAS,EAAE,CAAC;IAE1L,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,CAAC,CAAC,OAAO,YAAY,GAAG,CAAC;QAAE,MAAM,IAAI,aAAa,CAAC,+EAA+E,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC;IAE1J,IAAI,IAAwB,CAAC;IAC7B,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,aAAa,CAAC,oBAAoB,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;QAAE,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;IACjE,MAAM,KAAK,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC;IAC3B,IAAI,KAAK,KAAK,EAAE;QAAE,MAAM,IAAI,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAEjE,MAAM,IAAI,GAAI,MAAM,CAAC,IAA2B,IAAI,YAAY,CAAC;IACjE,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,MAAM;QAAE,MAAM,IAAI,aAAa,CAAC,yBAAyB,IAAI,GAAG,CAAC,CAAC;IACzF,OAAO;QACL,OAAO;QACP,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QACzC,IAAI,EAAG,MAAM,CAAC,IAA2B,IAAI,YAAY;QACzD,IAAI;QACJ,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI;KAC3B,CAAC;AACJ,CAAC;AAED,+CAA+C;AAC/C,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAE9G,4FAA4F;AAC5F,MAAM,UAAU,UAAU,CAAC,QAAkB;IAC3C,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,IAAI,sCAAsC,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,sEAAsE,EAAE,CAAC,CAAC;IACtL,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,KAAK,KAAK,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;QACxI,IAAI,CAAC,IAAI,CAAC,2CAA2C,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qDAAqD;AACrD,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,IAAY,EAAU,EAAE;IACrD,MAAM,KAAK,GAAG,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,OAAO,UAAU,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC;AACzE,CAAC,CAAC;AAEF,iFAAiF;AACjF,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC9J,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,OAAiB,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACnC,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAA0B,EAAE,GAAW,EAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;IAChG,EAAE,EAAE,OAAO;IACX,OAAO,EAAE,4CAA4C;IACrD,WAAW,EAAE,mHAAmH;IAChI,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE;IACzC,KAAK,EAAE,WAAW;IAClB,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACrB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,KAAK,KAAK,QAAQ;YAClD,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE;YAChE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACtB,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,MAAiC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QAChG,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QAE3E,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;QACrG,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7G,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,GAAG,kBAAkB,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,KAAK,CAAC,CAAC;QAC9J,IAAI,QAAQ,CAAC,IAAI;YAAE,WAAW,CAAC,GAAG,CAAC,CAAC;QAEpC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,GAAG,GAAG,GAAS,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/cli/server.js

@@ -0,0 +1,32 @@
+import { createServer } from 'node:http';
+import { toNodeListener } from '@cofold/remote';
+import { staticRoute } from '../plugin/static.js';
+import { socketProxy } from './proxy.js';
+/** What the page reads to learn that this server adds the token, so it asks for none. */
+export const SERVER_FILE = '/ahpw.json';
+/** The page at `/`, and its socket carried to the daemon. Not listening yet. */
+export function createWebServer(options) {
+    const files = staticRoute(options.app, '/');
+    const about = JSON.stringify({ tokenHeld: options.token !== undefined });
+    const route = async (request) => {
+        if (new URL(request.url).pathname !== SERVER_FILE)
+            return await files(request);
+        return new Response(about, { headers: { 'content-type': 'application/json', 'cache-control': 'no-store', 'x-content-type-options': 'nosniff' } });
+    };
+    const server = createServer(toNodeListener(route));
+    const proxy = socketProxy(options.upstream, options.token);
+    const carried = new Set();
+    server.on('upgrade', (request, socket, head) => {
+        carried.add(socket);
+        socket.on('close', () => carried.delete(socket));
+        proxy(request, socket, head);
+    });
+    const stop = () => new Promise((resolve) => {
+        server.close(() => resolve());
+        server.closeAllConnections();
+        for (const socket of carried)
+            socket.destroy();
+    });
+    return { server, stop };
+}
+//# sourceMappingURL=server.js.map

package/dist/cli/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../cli/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAqC,MAAM,WAAW,CAAC;AAE5E,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,yFAAyF;AACzF,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC;AAmBxC,gFAAgF;AAChF,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,KAAK,EAAE,OAAgB,EAAqB,EAAE;QAC1D,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,WAAW;YAAE,OAAO,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/E,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,UAAU,EAAE,wBAAwB,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IACpJ,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAwB,EAAE,MAAc,EAAE,IAAY,EAAE,EAAE;QAC9E,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,GAAkB,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QACxD,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC7B,KAAK,MAAM,MAAM,IAAI,OAAO;YAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}

package/dist/plugin/index.d.ts

@@ -0,0 +1,6 @@
+import type { Plugin } from '@ahpd/sdk';
+/** The plugin's id, and the path it is served under: `/plugins/ahpd-web/`. */
+export declare const name = "ahpd-web";
+/** What a listing prints. */
+export declare const title = "Web";
+export declare const apply: Plugin['apply'];

package/dist/plugin/index.js

@@ -0,0 +1,12 @@
+import { fileURLToPath } from 'node:url';
+import { staticRoute } from './static.js';
+/** The plugin's id, and the path it is served under: `/plugins/ahpd-web/`. */
+export const name = 'ahpd-web';
+/** What a listing prints. */
+export const title = 'Web';
+/** The built page, beside this file in the package. */
+const APP = fileURLToPath(new URL('../app/', import.meta.url));
+export const apply = (host) => {
+    host.registerRoute(staticRoute(APP, `/plugins/${name}/`));
+};
+//# sourceMappingURL=index.js.map

package/dist/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,IAAI,GAAG,UAAU,CAAC;AAE/B,6BAA6B;AAC7B,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC;AAE3B,uDAAuD;AACvD,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,KAAK,GAAoB,CAAC,IAAI,EAAE,EAAE;IAC7C,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,GAAG,EAAE,YAAY,IAAI,GAAG,CAAC,CAAC,CAAC;AAC5D,CAAC,CAAC"}

package/dist/plugin/static.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A route that serves the files under `root`, mounted at `prefix`.
+ *
+ * `prefix` is the path the daemon serves the route at, ending in `/`. The bare
+ * prefix without its slash is redirected to it, because the page loads its
+ * assets relative to its own address. A path that leaves `root`, by `..` or an
+ * encoded separator, is answered 404 like a missing file.
+ */
+export declare function staticRoute(root: string, prefix: string): (request: Request) => Promise<Response>;

package/dist/plugin/static.js

@@ -0,0 +1,77 @@
+import { readFile, stat } from 'node:fs/promises';
+import { extname, resolve, sep } from 'node:path';
+/** What a file is served as, by extension. */
+const TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.ico': 'image/x-icon',
+    '.woff2': 'font/woff2',
+    '.map': 'application/json',
+    '.txt': 'text/plain; charset=utf-8',
+};
+/**
+ * Headers on every answer.
+ *
+ * The token sits in this origin's localStorage, so the page loads nothing from
+ * anywhere else and cannot be framed. Inline styles stay allowed because the
+ * theme sets custom properties on elements.
+ */
+const SECURITY = {
+    'content-security-policy': "default-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; connect-src 'self'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'",
+    'x-content-type-options': 'nosniff',
+    'referrer-policy': 'no-referrer',
+};
+const answer = (status, body, headers = {}) => new Response(body, { status, headers: { ...SECURITY, 'content-type': 'text/plain; charset=utf-8', ...headers } });
+/**
+ * A route that serves the files under `root`, mounted at `prefix`.
+ *
+ * `prefix` is the path the daemon serves the route at, ending in `/`. The bare
+ * prefix without its slash is redirected to it, because the page loads its
+ * assets relative to its own address. A path that leaves `root`, by `..` or an
+ * encoded separator, is answered 404 like a missing file.
+ */
+export function staticRoute(root, prefix) {
+    const base = resolve(root);
+    return async (request) => {
+        if (request.method !== 'GET' && request.method !== 'HEAD')
+            return answer(405, 'Method not allowed', { allow: 'GET, HEAD' });
+        const url = new URL(request.url);
+        if (url.pathname === prefix.slice(0, -1))
+            return answer(308, '', { location: prefix });
+        if (!url.pathname.startsWith(prefix))
+            return answer(404, 'Not found');
+        let parts;
+        try {
+            parts = url.pathname.slice(prefix.length).split('/').filter((part) => part !== '').map(decodeURIComponent);
+        }
+        catch {
+            return answer(400, 'Bad path');
+        }
+        if (parts.some((part) => part === '.' || part === '..' || part.includes('/') || part.includes('\\') || part.includes('\0'))) {
+            return answer(404, 'Not found');
+        }
+        let file = resolve(base, ...parts);
+        if (file !== base && !file.startsWith(base + sep))
+            return answer(404, 'Not found');
+        try {
+            if ((await stat(file)).isDirectory())
+                file = resolve(file, 'index.html');
+            const body = await readFile(file);
+            const type = TYPES[extname(file).toLowerCase()] ?? 'application/octet-stream';
+            // Built assets carry a content hash in their name; the page itself does not.
+            const cache = parts[0] === 'assets' ? 'public, max-age=31536000, immutable' : 'no-cache';
+            return new Response(request.method === 'HEAD' ? null : body, {
+                status: 200,
+                headers: { ...SECURITY, 'content-type': type, 'cache-control': cache, 'content-length': String(body.byteLength) },
+            });
+        }
+        catch {
+            return answer(404, 'Not found');
+        }
+    };
+}
+//# sourceMappingURL=static.js.map

package/dist/plugin/static.js.map

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

package/package.json

@@ -1,6 +1,87 @@
 {
   "name": "@ahpd/web",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "type": "module",
+  "packageManager": "pnpm@11.21.0",
+  "description": "A web UI for an AHP server, as an ahpd plugin or on its own with ahpw serve",
+  "keywords": [
+    "ahp",
+    "agent-host-protocol",
+    "ahpd",
+    "plugin",
+    "web",
+    "admin"
+  ],
+  "author": "Luiz Fernando Softov <lfs@softov.dev>",
+  "license": "MIT",
+  "homepage": "https://github.com/softov/ahpw#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/softov/ahpw.git"
+  },
+  "bugs": {
+    "url": "https://github.com/softov/ahpw/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "bin": {
+    "ahpw": "./dist/cli/main.js"
+  },
+  "main": "./dist/plugin/index.js",
+  "types": "./dist/plugin/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/plugin/index.d.ts",
+      "default": "./dist/plugin/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build && tsc -p tsconfig.plugin.json && tsc -p tsconfig.cli.json && chmod +x dist/cli/main.js",
+    "typecheck": "tsc -b",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "@ahpd/sdk": ">=0.9"
+  },
+  "peerDependenciesMeta": {
+    "@ahpd/sdk": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@ahpd/sdk": "^0.9.0",
+    "@microsoft/agent-host-protocol": "^1.0.0",
+    "@softov/scena": "^0.5.0",
+    "@types/node": "^22.10.2",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.5",
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/addon-web-links": "^0.12.0",
+    "@xterm/xterm": "^6.0.0",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "typescript": "^5.9.3",
+    "vite": "^8.2.1",
+    "vitest": "^4.1.0"
+  },
+  "ahpd": {
+    "entry": "./dist/plugin/index.js",
+    "title": "Web"
+  },
+  "dependencies": {
+    "@cofold/commands": "^0.3.0",
+    "@cofold/config": "^0.3.1",
+    "@cofold/remote": "^0.5.0",
+    "@cofold/terminal": "^0.3.0"
+  }
+}