@alisio/plugin-swarm 0.0.0-stage → 0.1.0

package/dist/dashboard/api.js

@@ -0,0 +1,178 @@
+import { rejectActions } from "../app/operator.js";
+import { validateProjectName, validateRole, validateTaskName } from "../domain/identifiers.js";
+/** A failure with an HTTP status; the message is safe to show the operator. */
+export class ApiError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+const MAX_TEXT = 8000;
+/** Map a service error to an HTTP status from its message: our own messages are the contract. */
+export function statusFor(error) {
+    if (error instanceof ApiError)
+        return error.status;
+    const message = error instanceof Error ? error.message : "";
+    if (/^Unknown /i.test(message))
+        return 404;
+    if (/already exists/i.test(message))
+        return 409;
+    return 400;
+}
+const isRecord = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
+function bodyOf(request) {
+    if (!isRecord(request.body))
+        throw new ApiError(400, "Expected a JSON object body");
+    return request.body;
+}
+function text(source, key, options = {}) {
+    const value = source[key];
+    if (value === undefined && options.optional)
+        return "";
+    if (typeof value !== "string")
+        throw new ApiError(400, `"${key}" must be a string`);
+    if (value.length > (options.max ?? MAX_TEXT))
+        throw new ApiError(400, `"${key}" is too long`);
+    return value;
+}
+const project = (source) => {
+    const value = source instanceof URLSearchParams ? source.get("project") : source.project;
+    if (typeof value !== "string")
+        throw new ApiError(400, "A project is required");
+    return validateProjectName(value);
+};
+const task = (source) => {
+    const value = source instanceof URLSearchParams ? source.get("task") : source.task;
+    if (typeof value !== "string")
+        throw new ApiError(400, "A task is required");
+    return validateTaskName(value);
+};
+function itemId(id, kind) {
+    const parts = id.split(":");
+    if (parts.length !== 3 || parts[0] !== kind) {
+        throw new ApiError(400, `Expected an id like ${kind}:<project>:<task>`);
+    }
+    return {
+        project: validateProjectName(parts[1]),
+        task: validateTaskName(parts[2]),
+    };
+}
+const ok = (body = { ok: true }) => ({ status: 200, body });
+const routes = [
+    {
+        method: "GET",
+        pattern: ["state"],
+        handler: async ({ services, workspace }) => ok(await services.state(workspace)),
+    },
+    {
+        method: "GET",
+        pattern: ["mission"],
+        handler: async ({ services, workspace }, request) => {
+            const name = project(request.query);
+            return ok({ project: name, mission: await services.mission(workspace, name) });
+        },
+    },
+    {
+        method: "GET",
+        pattern: ["doc"],
+        handler: async ({ services, workspace }, request) => ok(await services.documents(workspace, project(request.query), task(request.query))),
+    },
+    {
+        method: "GET",
+        pattern: ["agents", ":role", "tail"],
+        handler: async ({ services, workspace }, request, [role]) => {
+            validateRole(role);
+            return ok(await services.agentTail(workspace, project(request.query), role));
+        },
+    },
+    ...["delete", "retry"].map((action) => ({
+        method: "POST",
+        pattern: ["tasks", action],
+        handler: async ({ services, workspace }, request) => {
+            const body = bodyOf(request);
+            const args = [workspace, project(body), task(body)];
+            if (action === "delete")
+                await services.deleteTask(...args);
+            else
+                await services.retryTask(...args);
+            return ok();
+        },
+    })),
+    {
+        method: "POST",
+        pattern: ["approvals", ":id", ":action"],
+        handler: async ({ services, workspace }, request, [id, action]) => {
+            if (action !== "approve" && action !== "comments" && action !== "reject") {
+                throw new ApiError(404, "Unknown approval action");
+            }
+            const ref = itemId(id, "approval");
+            const body = bodyOf(request);
+            if (action === "approve") {
+                await services.approve(workspace, ref.project, ref.task);
+            }
+            else if (action === "comments") {
+                if (body.clear === true) {
+                    await services.clearComments(workspace, ref.project, ref.task);
+                }
+                else {
+                    await services.addComment(workspace, ref.project, ref.task, text(body, "doc", { max: 300 }), text(body, "text"));
+                }
+            }
+            else {
+                const chosen = text(body, "action", { max: 20 });
+                if (!rejectActions.includes(chosen)) {
+                    throw new ApiError(400, "Reject needs one of: retry, delete, accept");
+                }
+                const comments = body.comments === undefined ? undefined : text(body, "comments");
+                await services.reject(workspace, ref.project, ref.task, chosen, comments);
+            }
+            return ok();
+        },
+    },
+    {
+        method: "POST",
+        pattern: ["clarifications", ":id", "answer"],
+        handler: async ({ services, workspace }, request, [id]) => {
+            const ref = itemId(id, "clarification");
+            const answer = text(bodyOf(request), "text");
+            if (!answer.trim())
+                throw new ApiError(400, "An answer needs text");
+            await services.answer(workspace, ref.project, ref.task, answer);
+            return ok();
+        },
+    },
+];
+/** The mutating routes, for the "complementary only" test: gate decisions and nothing else. */
+export const mutatingRoutes = () => routes
+    .filter((route) => route.method === "POST")
+    .map((route) => `POST /api/${route.pattern.join("/")}`)
+    .sort();
+function match(pattern, segments) {
+    if (pattern.length !== segments.length)
+        return undefined;
+    const params = [];
+    for (const [index, part] of pattern.entries()) {
+        if (part.startsWith(":"))
+            params.push(segments[index]);
+        else if (part !== segments[index])
+            return undefined;
+    }
+    return params;
+}
+/** Dispatch one API request. Every failure is an `ApiError` or a service `Error`; the caller maps it. */
+export async function handleApi(deps, request) {
+    let pathMatched = false;
+    for (const route of routes) {
+        const params = match(route.pattern, request.segments);
+        if (!params)
+            continue;
+        pathMatched = true;
+        if (route.method === request.method)
+            return route.handler(deps, request, params);
+    }
+    if (pathMatched)
+        throw new ApiError(405, "Method not allowed");
+    throw new ApiError(404, "Unknown route");
+}
+//# sourceMappingURL=api.js.map

package/dist/dashboard/api.js.map

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

package/dist/dashboard/auth.d.ts

@@ -0,0 +1,13 @@
+export declare const TOKEN_COOKIE = "swarm_token";
+export declare const TOKEN_HEADER = "x-swarm-token";
+/** A random 256-bit token, hex encoded. One per dashboard run (AD-9). */
+export declare const generateToken: () => string;
+/** Constant-time comparison; a missing or differently sized value never matches. */
+export declare function tokenMatches(expected: string, provided: string | undefined): boolean;
+export declare function parseCookies(header: string | undefined): Record<string, string>;
+/** The only `Host` values accepted: the loopback names with the bound port (DNS rebinding guard). */
+export declare const allowedHosts: (port: number) => Set<string>;
+export declare const hostAllowed: (host: string | undefined, port: number) => boolean;
+/** A missing `Origin` is fine (same-origin navigation, scripts); a present one must be ours. */
+export declare function originAllowed(origin: string | undefined, port: number): boolean;
+//# sourceMappingURL=auth.d.ts.map

package/dist/dashboard/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/dashboard/auth.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,gBAAgB,CAAC;AAC1C,eAAO,MAAM,YAAY,kBAAkB,CAAC;AAE5C,yEAAyE;AACzE,eAAO,MAAM,aAAa,QAAO,MAAyC,CAAC;AAE3E,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAKpF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAU/E;AAED,qGAAqG;AACrG,eAAO,MAAM,YAAY,SAAU,MAAM,KAAG,GAAG,CAAC,MAAM,CACD,CAAC;AAEtD,eAAO,MAAM,WAAW,SAAU,MAAM,GAAG,SAAS,QAAQ,MAAM,KAAG,OACH,CAAC;AAEnE,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAG/E"}

package/dist/dashboard/auth.js

@@ -0,0 +1,36 @@
+import { randomBytes, timingSafeEqual } from "node:crypto";
+export const TOKEN_COOKIE = "swarm_token";
+export const TOKEN_HEADER = "x-swarm-token";
+/** A random 256-bit token, hex encoded. One per dashboard run (AD-9). */
+export const generateToken = () => randomBytes(32).toString("hex");
+/** Constant-time comparison; a missing or differently sized value never matches. */
+export function tokenMatches(expected, provided) {
+    if (!provided)
+        return false;
+    const a = Buffer.from(expected);
+    const b = Buffer.from(provided);
+    return a.length === b.length && timingSafeEqual(a, b);
+}
+export function parseCookies(header) {
+    const out = {};
+    if (!header)
+        return out;
+    for (const part of header.split(";")) {
+        const cookie = part.trim();
+        const index = cookie.indexOf("=");
+        if (index <= 0)
+            continue;
+        out[cookie.slice(0, index)] = cookie.slice(index + 1).trim();
+    }
+    return out;
+}
+/** The only `Host` values accepted: the loopback names with the bound port (DNS rebinding guard). */
+export const allowedHosts = (port) => new Set([`127.0.0.1:${port}`, `localhost:${port}`]);
+export const hostAllowed = (host, port) => host !== undefined && allowedHosts(port).has(host.toLowerCase());
+/** A missing `Origin` is fine (same-origin navigation, scripts); a present one must be ours. */
+export function originAllowed(origin, port) {
+    if (origin === undefined)
+        return true;
+    return [...allowedHosts(port)].some((host) => origin === `http://${host}`);
+}
+//# sourceMappingURL=auth.js.map

package/dist/dashboard/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/dashboard/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CAAC;AAE5C,yEAAyE;AACzE,MAAM,CAAC,MAAM,aAAa,GAAG,GAAW,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAE3E,oFAAoF;AACpF,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,QAA4B;IACzE,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,CAAC;IACxB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,IAAI,CAAC;YAAE,SAAS;QACzB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,qGAAqG;AACrG,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAe,EAAE,CACxD,IAAI,GAAG,CAAC,CAAC,aAAa,IAAI,EAAE,EAAE,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAwB,EAAE,IAAY,EAAW,EAAE,CAC7E,IAAI,KAAK,SAAS,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAEnE,gGAAgG;AAChG,MAAM,UAAU,aAAa,CAAC,MAA0B,EAAE,IAAY;IACpE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,KAAK,UAAU,IAAI,EAAE,CAAC,CAAC;AAC7E,CAAC"}

package/dist/dashboard/open.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Open a URL in the default browser, best effort. The URL is built by the plugin (loopback host,
+ * numeric port, hex token), the command is an argument array and every failure is swallowed:
+ * the operator can always open the printed link by hand.
+ */
+export declare function openInBrowser(url: string): void;
+//# sourceMappingURL=open.d.ts.map

package/dist/dashboard/open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../src/dashboard/open.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAU/C"}

package/dist/dashboard/open.js

@@ -0,0 +1,17 @@
+import { spawn } from "node:child_process";
+/**
+ * Open a URL in the default browser, best effort. The URL is built by the plugin (loopback host,
+ * numeric port, hex token), the command is an argument array and every failure is swallowed:
+ * the operator can always open the printed link by hand.
+ */
+export function openInBrowser(url) {
+    const [command, args] = process.platform === "darwin"
+        ? ["open", [url]]
+        : process.platform === "win32"
+            ? ["rundll32", ["url.dll,FileProtocolHandler", url]]
+            : ["xdg-open", [url]];
+    const child = spawn(command, args, { stdio: "ignore", detached: true });
+    child.on("error", () => undefined);
+    child.unref();
+}
+//# sourceMappingURL=open.js.map

package/dist/dashboard/open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../src/dashboard/open.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GACnB,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAC3B,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO;YAC5B,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;YACpD,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACnC,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/dashboard/server.d.ts

@@ -0,0 +1,28 @@
+import type { SwarmServices } from "../app/services.js";
+import { type DashboardAsset } from "../resources.js";
+export declare const MAX_BODY_BYTES: number;
+export interface DashboardOptions {
+    services: SwarmServices;
+    workspace: string;
+    /** Test seam: a fixed token. Production generates a random 256-bit one. */
+    token?: string;
+    /** Test seam: where the static files come from. */
+    assets?: (name: DashboardAsset) => Promise<string>;
+    /** Called once when the server stops, however that happens. */
+    onClosed?: () => void;
+}
+export interface DashboardHandle {
+    /** The URL to open: it carries the token once, exchanged for a cookie and then dropped. */
+    url: string;
+    baseUrl: string;
+    port: number;
+    token: string;
+    close(): Promise<void>;
+}
+/**
+ * The dashboard server: static page plus JSON API on `127.0.0.1` (AD-9). Every request needs the
+ * per-run token, a loopback `Host` and (when present) a local `Origin`; there is no CORS and the
+ * CSP forbids anything but the page's own origin. Mutations call the same services as the commands.
+ */
+export declare function startDashboard(options: DashboardOptions): Promise<DashboardHandle>;
+//# sourceMappingURL=server.d.ts.map

package/dist/dashboard/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/dashboard/server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,KAAK,cAAc,EAAsB,MAAM,iBAAiB,CAAC;AAY1E,eAAO,MAAM,cAAc,QAAa,CAAC;AAezC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,aAAa,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAyDD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAgHxF"}

package/dist/dashboard/server.js

@@ -0,0 +1,176 @@
+import { createServer } from "node:http";
+import { loadDashboardAsset } from "../resources.js";
+import { ApiError, handleApi, statusFor } from "./api.js";
+import { generateToken, hostAllowed, originAllowed, parseCookies, TOKEN_COOKIE, TOKEN_HEADER, tokenMatches, } from "./auth.js";
+export const MAX_BODY_BYTES = 256 * 1024;
+const CSP = [
+    "default-src 'self'",
+    "script-src 'self'",
+    "style-src 'self'",
+    "img-src 'self' data:",
+    "connect-src 'self'",
+    "base-uri 'none'",
+    "form-action 'none'",
+    "frame-ancestors 'none'",
+].join("; ");
+const TOKEN_PLACEHOLDER = "__SWARM_TOKEN__";
+const STATIC = {
+    "/": { asset: "dashboard.html", type: "text/html; charset=utf-8" },
+    "/dashboard.css": { asset: "dashboard.css", type: "text/css; charset=utf-8" },
+    "/dashboard.js": { asset: "dashboard.js", type: "text/javascript; charset=utf-8" },
+};
+function send(res, status, body, type, extra = {}) {
+    res.writeHead(status, {
+        "content-type": type,
+        "content-length": Buffer.byteLength(body),
+        "content-security-policy": CSP,
+        "x-content-type-options": "nosniff",
+        "referrer-policy": "no-referrer",
+        "cache-control": "no-store",
+        "cross-origin-resource-policy": "same-origin",
+        ...extra,
+    });
+    res.end(body);
+}
+const sendJson = (res, status, value, extra = {}) => send(res, status, JSON.stringify(value), "application/json; charset=utf-8", extra);
+const fail = (res, status, message, extra = {}) => sendJson(res, status, { error: message }, extra);
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        let tooLarge = false;
+        req.on("data", (chunk) => {
+            if (tooLarge)
+                return;
+            size += chunk.length;
+            if (size > MAX_BODY_BYTES) {
+                tooLarge = true;
+                chunks.length = 0;
+                reject(new ApiError(413, "The request body is too large (limit 256 KiB)"));
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on("end", () => {
+            if (!tooLarge)
+                resolve(Buffer.concat(chunks).toString("utf8"));
+        });
+        req.on("error", reject);
+    });
+}
+/**
+ * The dashboard server: static page plus JSON API on `127.0.0.1` (AD-9). Every request needs the
+ * per-run token, a loopback `Host` and (when present) a local `Origin`; there is no CORS and the
+ * CSP forbids anything but the page's own origin. Mutations call the same services as the commands.
+ */
+export async function startDashboard(options) {
+    const token = options.token ?? generateToken();
+    const loadAsset = options.assets ?? loadDashboardAsset;
+    const deps = { services: options.services, workspace: options.workspace };
+    let port = 0;
+    const authorised = (req, mutating) => {
+        const header = req.headers[TOKEN_HEADER];
+        if (tokenMatches(token, Array.isArray(header) ? header[0] : header))
+            return true;
+        if (mutating)
+            return false;
+        return tokenMatches(token, parseCookies(req.headers.cookie)[TOKEN_COOKIE]);
+    };
+    const handle = async (req, res) => {
+        if (!hostAllowed(req.headers.host, port))
+            return fail(res, 403, "Unexpected Host header");
+        const origin = req.headers.origin;
+        if (!originAllowed(Array.isArray(origin) ? origin[0] : origin, port)) {
+            return fail(res, 403, "Unexpected Origin header");
+        }
+        const method = req.method ?? "GET";
+        if (method !== "GET" && method !== "POST") {
+            return fail(res, 405, "Method not allowed", { allow: "GET, POST" });
+        }
+        const url = new URL(req.url ?? "/", `http://127.0.0.1:${port}`);
+        if (method === "GET" && url.pathname === "/" && url.searchParams.has("token")) {
+            if (!tokenMatches(token, url.searchParams.get("token") ?? undefined)) {
+                return fail(res, 401, "Invalid token");
+            }
+            return send(res, 302, "", "text/plain; charset=utf-8", {
+                location: "/",
+                "set-cookie": `${TOKEN_COOKIE}=${token}; Path=/; HttpOnly; SameSite=Strict`,
+            });
+        }
+        if (!authorised(req, method === "POST"))
+            return fail(res, 401, "A valid token is required");
+        const fixed = method === "GET" ? STATIC[url.pathname] : undefined;
+        if (fixed) {
+            const content = await loadAsset(fixed.asset);
+            return send(res, 200, content.replaceAll(TOKEN_PLACEHOLDER, token), fixed.type);
+        }
+        if (!url.pathname.startsWith("/api/"))
+            return fail(res, 404, "Not found");
+        let segments;
+        try {
+            segments = url.pathname
+                .slice("/api/".length)
+                .split("/")
+                .map((part) => decodeURIComponent(part));
+        }
+        catch {
+            return fail(res, 400, "Malformed path");
+        }
+        let body;
+        if (method === "POST") {
+            if (!String(req.headers["content-type"] ?? "")
+                .toLowerCase()
+                .startsWith("application/json")) {
+                return fail(res, 415, "Send application/json");
+            }
+            const raw = await readBody(req);
+            try {
+                body = raw ? JSON.parse(raw) : {};
+            }
+            catch {
+                return fail(res, 400, "The body is not valid JSON");
+            }
+        }
+        const result = await handleApi(deps, { method, segments, query: url.searchParams, body });
+        sendJson(res, result.status, result.body);
+    };
+    const server = createServer((req, res) => {
+        handle(req, res).catch((error) => {
+            if (res.headersSent) {
+                res.destroy();
+                return;
+            }
+            // Our own validation messages are safe to show; system errors (paths, codes) are not.
+            const system = error instanceof Error && typeof error.code === "string";
+            const status = system || !(error instanceof Error) ? 500 : statusFor(error);
+            const message = status === 500 ? "Internal error" : error.message;
+            if (error instanceof ApiError && error.status === 413) {
+                fail(res, 413, message, { connection: "close" });
+                res.once("finish", () => req.destroy());
+                return;
+            }
+            fail(res, status, message);
+        });
+    });
+    server.keepAliveTimeout = 5000;
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(0, "127.0.0.1", () => resolve());
+    });
+    port = server.address().port;
+    const baseUrl = `http://127.0.0.1:${port}`;
+    let closing;
+    let forget = () => undefined;
+    const close = () => {
+        closing ??= new Promise((resolve) => {
+            forget();
+            options.onClosed?.();
+            server.close(() => resolve());
+            server.closeAllConnections();
+        });
+        return closing;
+    };
+    forget = options.services.onTeardown(close);
+    return { url: `${baseUrl}/?token=${token}`, baseUrl, port, token, close };
+}
+//# sourceMappingURL=server.js.map

package/dist/dashboard/server.js.map

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

package/dist/doctor.d.ts

@@ -0,0 +1,28 @@
+import type { Toolchain } from "./toolchains/profile.js";
+export interface DoctorItem {
+    id: string;
+    label: string;
+    status: "ok" | "warn" | "missing";
+    detail: string;
+}
+export interface DoctorReport {
+    items: DoctorItem[];
+    /** False when something the swarm cannot run without is missing. */
+    ok: boolean;
+}
+export interface DoctorDeps {
+    nodeVersion: string;
+    workspace: string;
+    toolchain: Toolchain;
+    initialised: boolean;
+    exec(command: string, args: string[]): Promise<string>;
+    writable(path: string): Promise<boolean>;
+}
+export declare const defaultDoctorDeps: {
+    exec(command: string, args: string[]): Promise<string>;
+    writable(path: string): Promise<boolean>;
+};
+export declare function parseGitVersion(text: string): [number, number, number] | undefined;
+export declare function runDoctor(deps: DoctorDeps): Promise<DoctorReport>;
+export declare function formatDoctor(report: DoctorReport): string;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAIzD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,oEAAoE;IACpE,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C;AAMD,eAAO,MAAM,iBAAiB;IACtB,IAAI,UAAU,MAAM,QAAQ,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAItD,QAAQ,OAAO,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAQ/C,CAAC;AAEF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAGlF;AAMD,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAwEvE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAKzD"}