@netnodeag/kraftwerk 0.38.1 → 0.39.1

package/dist/inspector/vibeables.js

@@ -0,0 +1,628 @@
+import { spawn } from "node:child_process";
+import { createReadStream, promises as fs, watch } from "node:fs";
+import http from "node:http";
+import net from "node:net";
+import path from "node:path";
+import { parse } from "yaml";
+import { resolveProject, vibeablesRootFor } from "../config.js";
+import { getProjectRoot } from "./context.js";
+import { newestMtime } from "./mtime.js";
+export const VIBEABLE_CONFIG_FILE = "vibeable.yml";
+const SLUG_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
+export function safeVibeableSlug(slug) {
+    if (!SLUG_RE.test(slug) || slug === "." || slug === "..")
+        throw new Error(`invalid vibeable name "${slug}"`);
+    return slug;
+}
+/* ---------- starter ---------- */
+/** The files a fresh vibeable starts with: a page that renders, and the config template. */
+export function vibeableStarter(name) {
+    const title = name.trim() || "vibeable";
+    return {
+        "index.html": `<!doctype html>\n<html lang="en">\n<head>\n  <meta charset="utf-8">\n  <meta name="viewport" content="width=device-width, initial-scale=1">\n` +
+            `  <title>${escapeHtml(title)}</title>\n  <link rel="stylesheet" href="./style.css">\n</head>\n<body>\n  <main>\n    <h1>${escapeHtml(title)}</h1>\n` +
+            `    <p>This vibeable is live. Tell the agent what to build and watch it change here.</p>\n  </main>\n  <script type="module" src="./app.js"></script>\n</body>\n</html>\n`,
+        "style.css": 
+        // Explicit colours: the pane is white, and a `light dark` scheme would paint light text on it in dark mode.
+        `:root { color-scheme: light; font-family: system-ui, sans-serif; background: #fff; color: #1b1b1f; }\n` +
+            `body { margin: 0; min-height: 100vh; display: grid; place-items: center; }\n` +
+            `main { padding: 32px; max-width: 60ch; }\nh1 { font-weight: 500; }\np { color: #46464f; }\n`,
+        "app.js": `// Plain ES module; relative imports and CDN imports (https://esm.sh/...) work.\nconsole.log("${title.replace(/["\\]/g, "")} ready");\n`,
+        [VIBEABLE_CONFIG_FILE]: `# vibeable.yml — how kraftwerk previews this app. Everything is optional.\n` +
+            `# Without a dev command the folder is served as-is (index.html, no build step).\n#\n` +
+            `# dev: npm run dev        # command that starts a dev server; it gets PORT in its environment\n` +
+            `# port: 5173              # the port that command listens on, when it ignores PORT\n` +
+            `# dir: dist               # folder to serve in static mode (default: this folder)\n`,
+        // Nested .gitignore: an npm install inside the app must not flood the workspace git.
+        ".gitignore": "node_modules/\n.env\n",
+        "README.md": `# ${title}\n\nBuilt live as a kraftwerk vibeable. Open it from a chat in the inspector; \`index.html\` is the entry.\n`,
+    };
+}
+const escapeHtml = (s) => s.replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c]);
+/* ---------- root + listing ---------- */
+/** Resolve the project and its vibeables block. `off` when the feature is not on. */
+export async function openVibeables() {
+    let project;
+    try {
+        project = await resolveProject(getProjectRoot());
+    }
+    catch (err) {
+        return { error: err.message };
+    }
+    const root = vibeablesRootFor(project);
+    if (!root)
+        return { off: true, error: "vibeables are off (enable them in settings or add `vibeables:` to kraftwerk.yml)" };
+    return { project, root };
+}
+/** Make sure the root exists; runs when the feature is switched on. */
+export async function ensureVibeablesRoot() {
+    const opened = await openVibeables();
+    if (opened.root)
+        await fs.mkdir(opened.root, { recursive: true });
+}
+/** Read vibeable.yml; a missing file is an empty config, a broken one is reported and ignored. */
+async function readConfig(dir) {
+    let raw;
+    try {
+        raw = await fs.readFile(path.join(dir, VIBEABLE_CONFIG_FILE), "utf8");
+    }
+    catch {
+        return { config: {} };
+    }
+    try {
+        const data = (parse(raw) ?? {});
+        if (typeof data !== "object" || Array.isArray(data))
+            throw new Error("must be a mapping");
+        const config = {};
+        if (data.dev !== undefined) {
+            if (typeof data.dev !== "string" || !data.dev.trim())
+                throw new Error("dev must be a command string");
+            config.dev = data.dev.trim();
+        }
+        if (data.port !== undefined) {
+            if (!Number.isInteger(data.port) || data.port < 1 || data.port > 65535)
+                throw new Error("port must be 1–65535");
+            config.port = data.port;
+        }
+        if (data.dir !== undefined) {
+            if (typeof data.dir !== "string" || !data.dir.trim())
+                throw new Error("dir must be a folder path");
+            const abs = path.resolve(dir, data.dir);
+            if (abs !== dir && !abs.startsWith(dir + path.sep))
+                throw new Error("dir must be inside the vibeable");
+            config.dir = data.dir.trim();
+        }
+        return { config };
+    }
+    catch (err) {
+        return { config: {}, error: `${VIBEABLE_CONFIG_FILE}: ${err.message}` };
+    }
+}
+/** The folder behind a slug, or throw `no vibeable "<slug>"`. */
+export async function resolveVibeable(slug) {
+    safeVibeableSlug(slug);
+    const opened = await openVibeables();
+    if (!opened.root)
+        throw new Error(opened.error ?? "vibeables are off");
+    const dir = path.join(opened.root, slug);
+    const st = await fs.stat(dir).catch(() => null);
+    if (!st?.isDirectory())
+        throw new Error(`no vibeable "${slug}"`);
+    const { config, error } = await readConfig(dir);
+    return { slug, dir, servedDir: path.resolve(dir, config.dir ?? "."), config, configError: error };
+}
+async function describe(root, slug) {
+    const dir = path.join(root, slug);
+    const { config, error } = await readConfig(dir);
+    const served = path.resolve(dir, config.dir ?? ".");
+    const [index, st, newest] = await Promise.all([
+        fs.stat(path.join(served, "index.html")).catch(() => null),
+        fs.stat(dir).catch(() => null),
+        newestMtime(dir),
+    ]);
+    const updated = Math.max(newest, st?.mtimeMs ?? 0);
+    return {
+        slug,
+        path: dir,
+        hasIndex: !!index?.isFile(),
+        ...(config.dev ? { dev: config.dev } : {}),
+        ...(error ? { configError: error } : {}),
+        ...(updated ? { updatedAt: new Date(updated).toISOString() } : {}),
+    };
+}
+/** Every folder under the root, alphabetically. Dot folders and odd names are skipped. */
+export async function listVibeables() {
+    const opened = await openVibeables();
+    if (!opened.root)
+        return { enabled: false, vibeables: [], error: opened.error };
+    const root = opened.root;
+    const entries = await fs.readdir(root, { withFileTypes: true }).catch(() => []);
+    const slugs = entries
+        .filter((e) => e.isDirectory() && SLUG_RE.test(e.name))
+        .map((e) => e.name)
+        .sort((a, b) => a.localeCompare(b));
+    return { enabled: true, root, vibeables: await Promise.all(slugs.map((s) => describe(root, s))) };
+}
+/**
+ * Create <root>/<name> with the starter files. The folder is claimed with a
+ * plain mkdir first: it fails when anything is there already, so two
+ * creates of the same name cannot both win.
+ */
+export async function createVibeable(name) {
+    const opened = await openVibeables();
+    if (!opened.root)
+        throw new Error(opened.error ?? "vibeables are off");
+    const slug = safeVibeableSlug(name.trim());
+    const dir = path.join(opened.root, slug);
+    await fs.mkdir(opened.root, { recursive: true });
+    try {
+        await fs.mkdir(dir);
+    }
+    catch (err) {
+        if (err.code === "EEXIST")
+            throw new Error(`"${slug}" already exists under ${opened.root}`);
+        throw err;
+    }
+    for (const [rel, content] of Object.entries(vibeableStarter(slug)))
+        await fs.writeFile(path.join(dir, rel), content);
+    return describe(opened.root, slug);
+}
+/** Delete a vibeable folder. Its history stays in the workspace git. */
+export async function deleteVibeable(slug) {
+    const r = await resolveVibeable(slug);
+    await stopDev(slug).catch(() => { });
+    dropChannel(slug);
+    await fs.rm(r.dir, { recursive: true, force: true });
+}
+export async function vibeableStatus(slug) {
+    const r = await resolveVibeable(slug);
+    const dev = devView(slug);
+    return {
+        slug,
+        path: r.dir,
+        dir: r.servedDir,
+        mode: dev?.running ? "dev" : "static",
+        url: `/vibeables/${encodeURIComponent(slug)}/`,
+        config: r.config,
+        ...(r.configError ? { configError: r.configError } : {}),
+        ...(dev ? { dev } : {}),
+    };
+}
+/* ---------- static serving ---------- */
+const MIME = {
+    ".html": "text/html; charset=utf-8",
+    ".htm": "text/html; charset=utf-8",
+    ".js": "text/javascript; charset=utf-8",
+    ".mjs": "text/javascript; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".map": "application/json; charset=utf-8",
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".avif": "image/avif",
+    ".ico": "image/x-icon",
+    ".pdf": "application/pdf",
+    ".txt": "text/plain; charset=utf-8",
+    ".md": "text/markdown; charset=utf-8",
+    ".csv": "text/csv; charset=utf-8",
+    ".xml": "application/xml; charset=utf-8",
+    ".wasm": "application/wasm",
+    ".woff": "font/woff",
+    ".woff2": "font/woff2",
+    ".ttf": "font/ttf",
+    ".otf": "font/otf",
+    ".mp3": "audio/mpeg",
+    ".wav": "audio/wav",
+    ".mp4": "video/mp4",
+    ".webm": "video/webm",
+};
+/**
+ * The document is sandboxed by header, so it also holds when opened in its
+ * own tab: scripts and forms work, but the origin is opaque — no cookies,
+ * no storage, and no same-origin calls into the inspector API.
+ */
+const VIBEABLE_CSP = "sandbox allow-scripts allow-forms allow-popups allow-modals allow-downloads";
+/**
+ * Headers every preview response carries. The sandbox makes the document's
+ * origin opaque, and an opaque origin fetches module scripts, imports and
+ * fetch() in CORS mode — without this allow header the app's own app.js
+ * never runs. Allowing any origin is safe: the files are the app's public
+ * sources, and the sandbox (not the origin) is what keeps them away from
+ * the inspector API.
+ */
+const PREVIEW_HEADERS = {
+    "cache-control": "no-store",
+    "content-security-policy": VIBEABLE_CSP,
+    "access-control-allow-origin": "*",
+};
+/**
+ * GET /vibeables/<slug>/<file>. Dot segments (.env, .git) are never served;
+ * a directory answers with its index.html, and a directory url without the
+ * trailing slash redirects so the page's relative links resolve.
+ */
+export async function serveVibeable(req, res, url) {
+    const fail = (status, error) => {
+        res.writeHead(status, { "content-type": "application/json; charset=utf-8", "cache-control": "no-store" });
+        res.end(JSON.stringify({ error }));
+    };
+    if (req.method !== "GET" && req.method !== "HEAD")
+        return fail(405, "method not allowed");
+    const seg = url.pathname.split("/").slice(2); // ["", "vibeables", slug, ...rest] → [slug, ...rest]
+    let slug;
+    try {
+        slug = safeVibeableSlug(decodeURIComponent(seg[0] ?? ""));
+    }
+    catch {
+        return fail(404, "not found");
+    }
+    let r;
+    try {
+        r = await resolveVibeable(slug);
+    }
+    catch (err) {
+        return fail(404, err.message);
+    }
+    // A running dev server owns the whole prefix: the pane and a new tab reach
+    // it through the inspector's origin, which is what a container or reverse
+    // proxy exposes — a random port on the host is not.
+    const dev = devs.get(slug);
+    if (dev && dev.exitCode === undefined && dev.child)
+        return proxyToDev(req, res, url, slug, dev.port);
+    const rest = seg.slice(1).map((s) => {
+        try {
+            return decodeURIComponent(s);
+        }
+        catch {
+            return "\0";
+        }
+    });
+    if (rest.some((s) => s.startsWith(".") || s.includes("\0") || s.includes("/") || s.includes("\\")))
+        return fail(404, "not found");
+    let abs = path.resolve(r.servedDir, ...rest);
+    if (abs !== r.servedDir && !abs.startsWith(r.servedDir + path.sep))
+        return fail(404, "not found");
+    let st = await fs.stat(abs).catch(() => null);
+    if (st?.isDirectory()) {
+        if (!url.pathname.endsWith("/")) {
+            res.writeHead(302, { location: `${url.pathname}/${url.search}`, "cache-control": "no-store" });
+            return void res.end();
+        }
+        abs = path.join(abs, "index.html");
+        st = await fs.stat(abs).catch(() => null);
+    }
+    if (!st?.isFile()) {
+        // A missing index is the normal state while the agent rewrites the app:
+        // the pane gets a quiet page, not a JSON error, and reloads on the next change.
+        if (rest.length === 0 || rest[rest.length - 1] === "")
+            return placeholder(res, slug);
+        return fail(404, "not found");
+    }
+    const ext = path.extname(abs).toLowerCase();
+    res.writeHead(200, {
+        "content-type": MIME[ext] ?? "application/octet-stream",
+        "content-length": st.size,
+        ...PREVIEW_HEADERS,
+    });
+    if (req.method === "HEAD")
+        return void res.end();
+    const stream = createReadStream(abs);
+    stream.on("error", () => res.destroy());
+    stream.pipe(res);
+}
+function placeholder(res, slug) {
+    const html = `<!doctype html><html lang="en"><head><meta charset="utf-8"><title>${escapeHtml(slug)}</title>` +
+        `<style>:root{color-scheme:light;background:#fff;color:#46464f;font:14px/1.5 system-ui,sans-serif}` +
+        `body{margin:0;min-height:100vh;display:grid;place-items:center}main{text-align:center;padding:32px}` +
+        `b{display:block;color:#1b1b1f;font-size:16px;font-weight:500;margin-bottom:4px}</style></head>` +
+        `<body><main><b>${escapeHtml(slug)}</b>no index.html yet — the preview appears as soon as the agent writes one.</main></body></html>`;
+    res.writeHead(404, { "content-type": "text/html; charset=utf-8", ...PREVIEW_HEADERS });
+    res.end(html);
+}
+/* ---------- dev proxy ---------- */
+/** "/vibeables/<slug>/x/y?q" → "/x/y?q" for the dev server. */
+function devPath(url, slug) {
+    const prefix = `/vibeables/${encodeURIComponent(slug)}`;
+    const rest = url.pathname.startsWith(prefix) ? url.pathname.slice(prefix.length) : url.pathname;
+    return `${rest || "/"}${url.search}`;
+}
+/** Hop-by-hop headers must not be forwarded either way. */
+const HOP = new Set(["connection", "keep-alive", "transfer-encoding", "te", "trailer", "upgrade", "proxy-connection"]);
+function proxyToDev(req, res, url, slug, port) {
+    const headers = {};
+    for (const [k, v] of Object.entries(req.headers))
+        if (!HOP.has(k) && v !== undefined)
+            headers[k] = v;
+    headers.host = `127.0.0.1:${port}`;
+    const up = http.request({ host: "127.0.0.1", port, method: req.method, path: devPath(url, slug), headers }, (r) => {
+        const out = {};
+        for (const [k, v] of Object.entries(r.headers))
+            if (!HOP.has(k) && v !== undefined)
+                out[k] = v;
+        // The sandbox applies to the dev server's pages like to static files,
+        // and the inspector's rule wins over whatever the dev server sent.
+        Object.assign(out, PREVIEW_HEADERS);
+        if (r.statusCode && r.statusCode >= 300 && r.statusCode < 400 && typeof out.location === "string" && out.location.startsWith("/")) {
+            out.location = `/vibeables/${encodeURIComponent(slug)}${out.location}`;
+        }
+        res.writeHead(r.statusCode ?? 502, out);
+        r.pipe(res);
+    });
+    up.on("error", (err) => {
+        if (!res.headersSent) {
+            res.writeHead(502, { "content-type": "text/html; charset=utf-8", ...PREVIEW_HEADERS });
+        }
+        res.end(`<!doctype html><meta charset="utf-8"><p style="font:14px system-ui;color:#46464f;padding:24px">dev server not answering: ${escapeHtml(err.message)}</p>`);
+    });
+    req.pipe(up);
+}
+/**
+ * WebSocket upgrades under /vibeables/<slug>/ go to the dev server too — that
+ * is how Vite-style HMR reaches the pane. Anything else is closed: the
+ * inspector has no sockets of its own.
+ */
+export function proxyUpgrade(req, socket, head) {
+    const url = new URL(req.url ?? "/", "http://localhost");
+    const seg = url.pathname.split("/");
+    const slug = seg[1] === "vibeables" ? decodeURIComponent(seg[2] ?? "") : "";
+    const dev = slug ? devs.get(slug) : undefined;
+    if (!dev || dev.exitCode !== undefined || !dev.child)
+        return void socket.destroy();
+    const upstream = net.connect(dev.port, "127.0.0.1", () => {
+        const lines = [`${req.method} ${devPath(url, slug)} HTTP/1.1`];
+        for (const [k, v] of Object.entries(req.headers)) {
+            if (v === undefined)
+                continue;
+            lines.push(`${k}: ${k === "host" ? `127.0.0.1:${dev.port}` : Array.isArray(v) ? v.join(", ") : v}`);
+        }
+        upstream.write(lines.join("\r\n") + "\r\n\r\n");
+        if (head.length)
+            upstream.write(head);
+        socket.pipe(upstream).pipe(socket);
+    });
+    const drop = () => {
+        socket.destroy();
+        upstream.destroy();
+    };
+    upstream.on("error", drop);
+    socket.on("error", drop);
+}
+const channels = new Map();
+const IGNORED = /(^|[\\/])(\.git|node_modules|\.cache|\.vite|\.next)([\\/]|$)/;
+/**
+ * Stream a vibeable's events: file changes (debounced, node_modules and
+ * the like excluded) and dev-server state. The watcher exists while
+ * someone listens. `fs.watch` recursive covers macOS and Linux on Node 20+;
+ * where it cannot watch, the pane still has its manual reload.
+ */
+export function subscribeVibeable(slug, dir, fn) {
+    let ch = channels.get(slug);
+    if (!ch) {
+        ch = { watcher: null, subs: new Set(), pending: new Set(), timer: null };
+        channels.set(slug, ch);
+        const c = ch;
+        try {
+            c.watcher = watch(dir, { recursive: true, persistent: false }, (_event, filename) => {
+                const rel = filename == null ? "" : String(filename);
+                if (IGNORED.test(rel))
+                    return;
+                c.pending.add(rel);
+                if (c.timer)
+                    clearTimeout(c.timer);
+                c.timer = setTimeout(() => {
+                    c.timer = null;
+                    const files = [...c.pending].filter(Boolean).sort();
+                    c.pending.clear();
+                    for (const s of c.subs)
+                        s({ type: "change", files });
+                }, 200);
+            });
+            c.watcher.on("error", (err) => {
+                for (const s of c.subs)
+                    s({ type: "error", message: `file watcher stopped: ${err.message}` });
+                // Drop the channel: the next subscriber gets a fresh watch() attempt
+                // instead of joining a dead one that never reports anything.
+                dropChannel(slug);
+            });
+        }
+        catch (err) {
+            dropChannel(slug);
+            queueMicrotask(() => fn({ type: "error", message: `cannot watch ${dir}: ${err.message}` }));
+            return () => { };
+        }
+    }
+    ch.subs.add(fn);
+    return () => {
+        const c = channels.get(slug);
+        if (!c)
+            return;
+        c.subs.delete(fn);
+        if (c.subs.size === 0) {
+            if (c.timer)
+                clearTimeout(c.timer);
+            c.watcher?.close();
+            channels.delete(slug);
+        }
+    };
+}
+/** Close a channel's watcher and forget it; subscribers are left to reconnect. */
+function dropChannel(slug) {
+    const c = channels.get(slug);
+    if (!c)
+        return;
+    if (c.timer)
+        clearTimeout(c.timer);
+    c.watcher?.close();
+    channels.delete(slug);
+}
+function broadcast(slug, ev) {
+    const c = channels.get(slug);
+    if (!c)
+        return;
+    for (const s of c.subs)
+        s(ev);
+}
+const devs = new Map();
+const LOG_LINES = 200;
+const READY_TIMEOUT = 90_000;
+function devView(slug) {
+    const d = devs.get(slug);
+    if (!d)
+        return undefined;
+    return {
+        command: d.command,
+        port: d.port,
+        running: d.exitCode === undefined && d.child !== null,
+        ready: d.ready && d.exitCode === undefined,
+        ...(d.child?.pid ? { pid: d.child.pid } : {}),
+        startedAt: d.startedAt,
+        ...(d.exitCode !== undefined ? { exitCode: d.exitCode } : {}),
+        log: d.log,
+    };
+}
+function freePort() {
+    return new Promise((resolve, reject) => {
+        const srv = net.createServer();
+        srv.once("error", reject);
+        srv.listen(0, "127.0.0.1", () => {
+            const port = srv.address().port;
+            srv.close(() => resolve(port));
+        });
+    });
+}
+/** Any HTTP answer on the port counts as ready — a 404 from a dev server is still a server. */
+function probe(port) {
+    return new Promise((resolve) => {
+        const req = http.get({ host: "127.0.0.1", port, path: "/", timeout: 1_000 }, (res) => {
+            res.resume();
+            resolve(true);
+        });
+        req.on("timeout", () => req.destroy());
+        req.on("error", () => resolve(false));
+    });
+}
+function pushLog(d, chunk) {
+    for (const line of chunk.toString("utf8").split(/\r?\n/)) {
+        if (!line)
+            continue;
+        // Strip ANSI colour codes; the pane is not a terminal.
+        d.log.push(line.replace(/\x1b\[[0-9;]*[A-Za-z]/g, ""));
+    }
+    if (d.log.length > LOG_LINES)
+        d.log.splice(0, d.log.length - LOG_LINES);
+}
+/**
+ * Start the vibeable's dev command. Idempotent while it runs. The child
+ * leads its own process group so stopping it also stops what it spawned
+ * (npm → vite → esbuild).
+ */
+/** Starts in flight per slug: two clicks (or two tabs) share one spawn instead of leaking a process. */
+const starting = new Map();
+export function startDev(slug) {
+    const inFlight = starting.get(slug);
+    if (inFlight)
+        return inFlight;
+    const p = startDevNow(slug).finally(() => starting.delete(slug));
+    starting.set(slug, p);
+    return p;
+}
+async function startDevNow(slug) {
+    const r = await resolveVibeable(slug);
+    if (r.configError)
+        throw new Error(r.configError);
+    if (!r.config.dev)
+        throw new Error(`no dev command — add \`dev: <command>\` to ${VIBEABLE_CONFIG_FILE}`);
+    const existing = devs.get(slug);
+    if (existing && existing.exitCode === undefined && existing.child)
+        return vibeableStatus(slug);
+    const port = r.config.port ?? (await freePort());
+    // The pane reaches the server through /vibeables/<slug>/ on the inspector,
+    // so a dev server that emits absolute URLs needs that as its base.
+    const basePath = `/vibeables/${encodeURIComponent(slug)}/`;
+    const child = spawn(r.config.dev, [], {
+        cwd: r.dir,
+        shell: true,
+        detached: process.platform !== "win32",
+        stdio: ["ignore", "pipe", "pipe"],
+        env: {
+            ...process.env,
+            PORT: String(port),
+            BASE_PATH: basePath,
+            PUBLIC_URL: basePath,
+            BROWSER: "none",
+            FORCE_COLOR: "0",
+            NO_COLOR: "1",
+            CI: process.env.CI ?? "1",
+        },
+    });
+    const d = { child, command: r.config.dev, port, ready: false, startedAt: new Date().toISOString(), log: [] };
+    devs.set(slug, d);
+    child.stdout?.on("data", (c) => pushLog(d, c));
+    child.stderr?.on("data", (c) => pushLog(d, c));
+    child.on("error", (err) => {
+        pushLog(d, Buffer.from(`spawn failed: ${err.message}\n`));
+        d.exitCode = null;
+        d.ready = false;
+        broadcast(slug, { type: "dev", dev: devView(slug) });
+    });
+    child.on("exit", (code) => {
+        d.exitCode = code;
+        d.ready = false;
+        pushLog(d, Buffer.from(`[exited with ${code ?? "signal"}]\n`));
+        broadcast(slug, { type: "dev", dev: devView(slug) });
+    });
+    broadcast(slug, { type: "dev", dev: devView(slug) });
+    // Readiness runs in the background; the pane follows the dev events.
+    void (async () => {
+        const until = Date.now() + READY_TIMEOUT;
+        while (Date.now() < until && d.exitCode === undefined && devs.get(slug) === d) {
+            if (await probe(port)) {
+                d.ready = true;
+                broadcast(slug, { type: "dev", dev: devView(slug) });
+                return;
+            }
+            await new Promise((res) => setTimeout(res, 500));
+        }
+    })();
+    return vibeableStatus(slug);
+}
+function killGroup(d, signal) {
+    const pid = d.child?.pid;
+    if (!pid)
+        return;
+    try {
+        if (process.platform !== "win32")
+            process.kill(-pid, signal);
+        else
+            d.child?.kill(signal);
+    }
+    catch {
+        try {
+            d.child?.kill(signal);
+        }
+        catch { }
+    }
+}
+/** SIGTERM the dev process group, SIGKILL what is still there after 3 s. */
+export async function stopDev(slug) {
+    // Kill before resolving: a folder that vanished or a feature switched off
+    // must not leave the process running.
+    const d = devs.get(slug);
+    if (d && d.exitCode === undefined && d.child) {
+        const exited = new Promise((resolve) => d.child.once("exit", () => resolve()));
+        killGroup(d, "SIGTERM");
+        const timer = setTimeout(() => killGroup(d, "SIGKILL"), 3_000);
+        await exited;
+        clearTimeout(timer);
+    }
+    return vibeableStatus(slug);
+}
+/** Server shutdown: no dev server may outlive the inspector. */
+export function disposeAllDevs() {
+    for (const d of devs.values())
+        if (d.exitCode === undefined)
+            killGroup(d, "SIGTERM");
+}

package/inspector/dist/assets/apl-gfMMiTNf.js

@@ -0,0 +1 @@
+var e={"+":[`conjugate`,`add`],"−":[`negate`,`subtract`],"×":[`signOf`,`multiply`],"÷":[`reciprocal`,`divide`],"⌈":[`ceiling`,`greaterOf`],"⌊":[`floor`,`lesserOf`],"∣":[`absolute`,`residue`],"⍳":[`indexGenerate`,`indexOf`],"?":[`roll`,`deal`],"⋆":[`exponentiate`,`toThePowerOf`],"⍟":[`naturalLog`,`logToTheBase`],"○":[`piTimes`,`circularFuncs`],"!":[`factorial`,`binomial`],"⌹":[`matrixInverse`,`matrixDivide`],"<":[null,`lessThan`],"≤":[null,`lessThanOrEqual`],"=":[null,`equals`],">":[null,`greaterThan`],"≥":[null,`greaterThanOrEqual`],"≠":[null,`notEqual`],"≡":[`depth`,`match`],"≢":[null,`notMatch`],"∈":[`enlist`,`membership`],"⍷":[null,`find`],"∪":[`unique`,`union`],"∩":[null,`intersection`],"∼":[`not`,`without`],"∨":[null,`or`],"∧":[null,`and`],"⍱":[null,`nor`],"⍲":[null,`nand`],"⍴":[`shapeOf`,`reshape`],",":[`ravel`,`catenate`],"⍪":[null,`firstAxisCatenate`],"⌽":[`reverse`,`rotate`],"⊖":[`axis1Reverse`,`axis1Rotate`],"⍉":[`transpose`,null],"↑":[`first`,`take`],"↓":[null,`drop`],"⊂":[`enclose`,`partitionWithAxis`],"⊃":[`diclose`,`pick`],"⌷":[null,`index`],"⍋":[`gradeUp`,null],"⍒":[`gradeDown`,null],"⊤":[`encode`,null],"⊥":[`decode`,null],"⍕":[`format`,`formatByExample`],"⍎":[`execute`,null],"⊣":[`stop`,`left`],"⊢":[`pass`,`right`]},t=/[\.\/⌿⍀¨⍣]/,n=/⍬/,r=/[\+−×÷⌈⌊∣⍳\?⋆⍟○!⌹<≤=>≥≠≡≢∈⍷∪∩∼∨∧⍱⍲⍴,⍪⌽⊖⍉↑↓⊂⊃⌷⍋⍒⊤⊥⍕⍎⊣⊢]/,i=/←/,a=/[⍝#].*$/,o=function(e){var t=!1;return function(n){return t=n,n!==e||t===`\\`}},s={name:`apl`,startState:function(){return{prev:!1,func:!1,op:!1,string:!1,escape:!1}},token:function(s,c){var l;return s.eatSpace()?null:(l=s.next(),l===`"`||l===`'`?(s.eatWhile(o(l)),s.next(),c.prev=!0,`string`):/[\[{\(]/.test(l)?(c.prev=!1,null):/[\]}\)]/.test(l)?(c.prev=!0,null):n.test(l)?(c.prev=!1,`atom`):/[¯\d]/.test(l)?(c.func?(c.func=!1,c.prev=!1):c.prev=!0,s.eatWhile(/[\w\.]/),`number`):t.test(l)||i.test(l)?`operator`:r.test(l)?(c.func=!0,c.prev=!1,e[l]?`variableName.function.standard`:`variableName.function`):a.test(l)?(s.skipToEnd(),`comment`):l===`∘`&&s.peek()===`.`?(s.next(),`variableName.function`):(s.eatWhile(/[\w\$_]/),c.prev=!0,`keyword`))}};export{s as apl};

package/inspector/dist/assets/asciiarmor-C_eisQCp.js

@@ -0,0 +1 @@
+function e(e){var t=e.match(/^\s*\S/);return e.skipToEnd(),t?`error`:null}var t={name:`asciiarmor`,token:function(t,n){var r;if(n.state==`top`)return t.sol()&&(r=t.match(/^-----BEGIN (.*)?-----\s*$/))?(n.state=`headers`,n.type=r[1],`tag`):e(t);if(n.state==`headers`){if(t.sol()&&t.match(/^\w+:/))return n.state=`header`,`atom`;var i=e(t);return i&&(n.state=`body`),i}if(n.state==`header`)return t.skipToEnd(),n.state=`headers`,`string`;if(n.state==`body`)return t.sol()&&(r=t.match(/^-----END (.*)?-----\s*$/))?r[1]==n.type?(n.state=`end`,`tag`):`error`:t.eatWhile(/[A-Za-z0-9+\/=]/)?null:(t.next(),`error`);if(n.state==`end`)return e(t)},blankLine:function(e){e.state==`headers`&&(e.state=`body`)},startState:function(){return{state:`top`,type:null}}};export{t as asciiArmor};

package/inspector/dist/assets/asn1-DCl_8MCW.js

@@ -0,0 +1 @@
+function e(e){for(var t={},n=e.split(` `),r=0;r<n.length;++r)t[n[r]]=!0;return t}var t={keywords:e(`DEFINITIONS OBJECTS IF DERIVED INFORMATION ACTION REPLY ANY NAMED CHARACTERIZED BEHAVIOUR REGISTERED WITH AS IDENTIFIED CONSTRAINED BY PRESENT BEGIN IMPORTS FROM UNITS SYNTAX MIN-ACCESS MAX-ACCESS MINACCESS MAXACCESS REVISION STATUS DESCRIPTION SEQUENCE SET COMPONENTS OF CHOICE DistinguishedName ENUMERATED SIZE MODULE END INDEX AUGMENTS EXTENSIBILITY IMPLIED EXPORTS`),cmipVerbs:e(`ACTIONS ADD GET NOTIFICATIONS REPLACE REMOVE`),compareTypes:e(`OPTIONAL DEFAULT MANAGED MODULE-TYPE MODULE_IDENTITY MODULE-COMPLIANCE OBJECT-TYPE OBJECT-IDENTITY OBJECT-COMPLIANCE MODE CONFIRMED CONDITIONAL SUBORDINATE SUPERIOR CLASS TRUE FALSE NULL TEXTUAL-CONVENTION`),status:e(`current deprecated mandatory obsolete`),tags:e(`APPLICATION AUTOMATIC EXPLICIT IMPLICIT PRIVATE TAGS UNIVERSAL`),storage:e(`BOOLEAN INTEGER OBJECT IDENTIFIER BIT OCTET STRING UTCTime InterfaceIndex IANAifType CMIP-Attribute REAL PACKAGE PACKAGES IpAddress PhysAddress NetworkAddress BITS BMPString TimeStamp TimeTicks TruthValue RowStatus DisplayString GeneralString GraphicString IA5String NumericString PrintableString SnmpAdminString TeletexString UTF8String VideotexString VisibleString StringStore ISO646String T61String UniversalString Unsigned32 Integer32 Gauge Gauge32 Counter Counter32 Counter64`),modifier:e(`ATTRIBUTE ATTRIBUTES MANDATORY-GROUP MANDATORY-GROUPS GROUP GROUPS ELEMENTS EQUALITY ORDERING SUBSTRINGS DEFINED`),accessTypes:e(`not-accessible accessible-for-notify read-only read-create read-write`),multiLineStrings:!0};function n(e){var n=e.keywords||t.keywords,r=e.cmipVerbs||t.cmipVerbs,i=e.compareTypes||t.compareTypes,a=e.status||t.status,o=e.tags||t.tags,s=e.storage||t.storage,c=e.modifier||t.modifier,l=e.accessTypes||t.accessTypes,u=e.multiLineStrings||t.multiLineStrings,d=e.indentStatements!==!1,f=/[\|\^]/,p;function m(e,t){var u=e.next();if(u==`"`||u==`'`)return t.tokenize=h(u),t.tokenize(e,t);if(/[\[\]\(\){}:=,;]/.test(u))return p=u,`punctuation`;if(u==`-`&&e.eat(`-`))return e.skipToEnd(),`comment`;if(/\d/.test(u))return e.eatWhile(/[\w\.]/),`number`;if(f.test(u))return e.eatWhile(f),`operator`;e.eatWhile(/[\w\-]/);var d=e.current();return n.propertyIsEnumerable(d)?`keyword`:r.propertyIsEnumerable(d)?`variableName`:i.propertyIsEnumerable(d)?`atom`:a.propertyIsEnumerable(d)?`comment`:o.propertyIsEnumerable(d)?`typeName`:s.propertyIsEnumerable(d)||c.propertyIsEnumerable(d)||l.propertyIsEnumerable(d)?`modifier`:`variableName`}function h(e){return function(t,n){for(var r=!1,i,a=!1;(i=t.next())!=null;){if(i==e&&!r){var o=t.peek();o&&(o=o.toLowerCase(),(o==`b`||o==`h`||o==`o`)&&t.next()),a=!0;break}r=!r&&i==`\\`}return(a||!(r||u))&&(n.tokenize=null),`string`}}function g(e,t,n,r,i){this.indented=e,this.column=t,this.type=n,this.align=r,this.prev=i}function _(e,t,n){var r=e.indented;return e.context&&e.context.type==`statement`&&(r=e.context.indented),e.context=new g(r,t,n,null,e.context)}function v(e){var t=e.context.type;return(t==`)`||t==`]`||t==`}`)&&(e.indented=e.context.indented),e.context=e.context.prev}return{name:`asn1`,startState:function(){return{tokenize:null,context:new g(-2,0,`top`,!1),indented:0,startOfLine:!0}},token:function(e,t){var n=t.context;if(e.sol()&&(n.align??(n.align=!1),t.indented=e.indentation(),t.startOfLine=!0),e.eatSpace())return null;p=null;var r=(t.tokenize||m)(e,t);if(r==`comment`)return r;if(n.align??(n.align=!0),(p==`;`||p==`:`||p==`,`)&&n.type==`statement`)v(t);else if(p==`{`)_(t,e.column(),`}`);else if(p==`[`)_(t,e.column(),`]`);else if(p==`(`)_(t,e.column(),`)`);else if(p==`}`){for(;n.type==`statement`;)n=v(t);for(n.type==`}`&&(n=v(t));n.type==`statement`;)n=v(t)}else p==n.type?v(t):d&&((n.type==`}`||n.type==`top`)&&p!=`;`||n.type==`statement`&&p==`newstatement`)&&_(t,e.column(),`statement`);return t.startOfLine=!1,r},languageData:{indentOnInput:/^\s*[{}]$/,commentTokens:{line:`--`}}}}export{n as asn1};

package/inspector/dist/assets/asterisk-BEn0Cwpx.js

@@ -0,0 +1 @@
+var e=[`exten`,`same`,`include`,`ignorepat`,`switch`],t=[`#include`,`#exec`],n=`addqueuemember.adsiprog.aelsub.agentlogin.agentmonitoroutgoing.agi.alarmreceiver.amd.answer.authenticate.background.backgrounddetect.bridge.busy.callcompletioncancel.callcompletionrequest.celgenuserevent.changemonitor.chanisavail.channelredirect.chanspy.clearhash.confbridge.congestion.continuewhile.controlplayback.dahdiacceptr2call.dahdibarge.dahdiras.dahdiscan.dahdisendcallreroutingfacility.dahdisendkeypadfacility.datetime.dbdel.dbdeltree.deadagi.dial.dictate.directory.disa.dumpchan.eagi.echo.endwhile.exec.execif.execiftime.exitwhile.extenspy.externalivr.festival.flash.followme.forkcdr.getcpeid.gosub.gosubif.goto.gotoif.gotoiftime.hangup.iax2provision.ices.importvar.incomplete.ivrdemo.jabberjoin.jabberleave.jabbersend.jabbersendgroup.jabberstatus.jack.log.macro.macroexclusive.macroexit.macroif.mailboxexists.meetme.meetmeadmin.meetmechanneladmin.meetmecount.milliwatt.minivmaccmess.minivmdelete.minivmgreet.minivmmwi.minivmnotify.minivmrecord.mixmonitor.monitor.morsecode.mp3player.mset.musiconhold.nbscat.nocdr.noop.odbc.odbc.odbcfinish.originate.ospauth.ospfinish.osplookup.ospnext.page.park.parkandannounce.parkedcall.pausemonitor.pausequeuemember.pickup.pickupchan.playback.playtones.privacymanager.proceeding.progress.queue.queuelog.raiseexception.read.readexten.readfile.receivefax.receivefax.receivefax.record.removequeuemember.resetcdr.retrydial.return.ringing.sayalpha.saycountedadj.saycountednoun.saycountpl.saydigits.saynumber.sayphonetic.sayunixtime.senddtmf.sendfax.sendfax.sendfax.sendimage.sendtext.sendurl.set.setamaflags.setcallerpres.setmusiconhold.sipaddheader.sipdtmfmode.sipremoveheader.skel.slastation.slatrunk.sms.softhangup.speechactivategrammar.speechbackground.speechcreate.speechdeactivategrammar.speechdestroy.speechloadgrammar.speechprocessingsound.speechstart.speechunloadgrammar.stackpop.startmusiconhold.stopmixmonitor.stopmonitor.stopmusiconhold.stopplaytones.system.testclient.testserver.transfer.tryexec.trysystem.unpausemonitor.unpausequeuemember.userevent.verbose.vmauthenticate.vmsayname.voicemail.voicemailmain.wait.waitexten.waitfornoise.waitforring.waitforsilence.waitmusiconhold.waituntil.while.zapateller`.split(`.`);function r(n,r){var i=``,a=n.next();if(r.blockComment)return a==`-`&&n.match(`-;`,!0)?r.blockComment=!1:n.skipTo(`--;`)?(n.next(),n.next(),n.next(),r.blockComment=!1):n.skipToEnd(),`comment`;if(a==`;`)return n.match(`--`,!0)&&!n.match(`-`,!1)?(r.blockComment=!0,`comment`):(n.skipToEnd(),`comment`);if(a==`[`)return n.skipTo(`]`),n.eat(`]`),`header`;if(a==`"`)return n.skipTo(`"`),`string`;if(a==`'`)return n.skipTo(`'`),`string.special`;if(a==`#`&&(n.eatWhile(/\w/),i=n.current(),t.indexOf(i)!==-1))return n.skipToEnd(),`strong`;if(a==`$`&&n.peek()==`{`)return n.skipTo(`}`),n.eat(`}`),`variableName.special`;if(n.eatWhile(/\w/),i=n.current(),e.indexOf(i)!==-1){switch(r.extenStart=!0,i){case`same`:r.extenSame=!0;break;case`include`:case`switch`:case`ignorepat`:r.extenInclude=!0}return`atom`}}var i={name:`asterisk`,startState:function(){return{blockComment:!1,extenStart:!1,extenSame:!1,extenInclude:!1,extenExten:!1,extenPriority:!1,extenApplication:!1}},token:function(e,t){var i=``;if(e.eatSpace())return null;if(t.extenStart)return e.eatWhile(/[^\s]/),i=e.current(),/^=>?$/.test(i)?(t.extenExten=!0,t.extenStart=!1,`strong`):(t.extenStart=!1,e.skipToEnd(),`error`);if(t.extenExten)return t.extenExten=!1,t.extenPriority=!0,e.eatWhile(/[^,]/),t.extenInclude&&=(e.skipToEnd(),t.extenPriority=!1,!1),t.extenSame&&(t.extenPriority=!1,t.extenSame=!1,t.extenApplication=!0),`tag`;if(t.extenPriority)return t.extenPriority=!1,t.extenApplication=!0,e.next(),t.extenSame?null:(e.eatWhile(/[^,]/),`number`);if(t.extenApplication){if(e.eatWhile(/,/),i=e.current(),i===`,`)return null;if(e.eatWhile(/\w/),i=e.current().toLowerCase(),t.extenApplication=!1,n.indexOf(i)!==-1)return`def`}else return r(e,t);return null},languageData:{commentTokens:{line:`;`,block:{open:`;--`,close:`--;`}}}};export{i as asterisk};

package/inspector/dist/assets/brainfuck-D5EjA2JK.js

@@ -0,0 +1 @@
+var e=`><+-.,[]`.split(``),t={name:`brainfuck`,startState:function(){return{commentLine:!1,left:0,right:0,commentLoop:!1}},token:function(t,n){if(t.eatSpace())return null;t.sol()&&(n.commentLine=!1);var r=t.next().toString();if(e.indexOf(r)!==-1){if(n.commentLine===!0)return t.eol()&&(n.commentLine=!1),`comment`;if(r===`]`||r===`[`)return r===`[`?n.left++:n.right++,`bracket`;if(r===`+`||r===`-`)return`keyword`;if(r===`<`||r===`>`)return`atom`;if(r===`.`||r===`,`)return`def`}else return n.commentLine=!0,t.eol()&&(n.commentLine=!1),`comment`;t.eol()&&(n.commentLine=!1)}};export{t as brainfuck};