@ouro.bot/cli 0.1.0-alpha.83 → 0.1.0-alpha.831

package/dist/heart/mailbox/mailbox-http-routes.js

@@ -0,0 +1,398 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMailboxHttpRequestHandler = createMailboxHttpRequestHandler;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const mailbox_http_hooks_1 = require("./mailbox-http-hooks");
+const mailbox_http_response_1 = require("./mailbox-http-response");
+const mailbox_http_static_1 = require("./mailbox-http-static");
+function decodePathSegment(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return null;
+    }
+}
+function rawRequestTargetsUnsafeAgent(urlValue = "/") {
+    const rawTarget = urlValue.split(/[?#]/, 1)[0];
+    const rawPath = rawTarget.replace(/\/+$/, "") || "/";
+    const pathname = (0, mailbox_http_static_1.normalizeLegacyMailboxApiPath)(rawPath);
+    const rawAgentMatch = /^\/api\/agents\/([^/]+)(?:\/|$)/.exec(pathname);
+    if (!rawAgentMatch)
+        return false;
+    const agent = decodePathSegment(rawAgentMatch[1]);
+    return !agent || !(0, mailbox_http_hooks_1.isSafeMailboxAgentName)(agent);
+}
+function parseHabitRunLimit(urlValue) {
+    const rawLimit = new URL(urlValue, "http://127.0.0.1").searchParams.get("limit");
+    if (rawLimit === null)
+        return undefined;
+    if (!/^[1-9][0-9]*$/.test(rawLimit))
+        return null;
+    const limit = Number.parseInt(rawLimit, 10);
+    return limit >= 1 && limit <= 100 ? limit : null;
+}
+const VALID_HABIT_SUMMARY_WHICH = new Set(["latest", "previous", "latest-success", "latest-failure"]);
+function firstQueryValue(params, names) {
+    for (const name of names) {
+        const value = params.get(name);
+        if (value !== null && value.trim().length > 0)
+            return value;
+    }
+    return undefined;
+}
+function parseHabitSummarySelector(urlValue) {
+    const params = new URL(urlValue, "http://127.0.0.1").searchParams;
+    const runId = firstQueryValue(params, ["runId", "run-id"]);
+    const habitName = firstQueryValue(params, ["habitName", "habit"]);
+    const operationId = firstQueryValue(params, ["operationId", "operation-id"]);
+    const which = firstQueryValue(params, ["which"]);
+    if (runId !== undefined && (habitName !== undefined || operationId !== undefined || which !== undefined)) {
+        return { ok: false, error: "--run-id cannot be combined with --habit, --operation-id, or --which" };
+    }
+    if (runId === undefined && habitName === undefined && operationId === undefined) {
+        return { ok: false, error: "provide runId, habitName, or operationId" };
+    }
+    if (which !== undefined && !VALID_HABIT_SUMMARY_WHICH.has(which)) {
+        return { ok: false, error: "which must be latest, previous, latest-success, or latest-failure" };
+    }
+    return {
+        ok: true,
+        selector: {
+            ...(runId ? { runId } : {}),
+            ...(habitName ? { habitName } : {}),
+            ...(operationId ? { operationId } : {}),
+            ...(which ? { which } : {}),
+        },
+    };
+}
+function createMailboxHttpRequestHandler(options) {
+    const staticFiles = options.staticFiles ?? { resolveSpaDistDir: mailbox_http_static_1.resolveSpaDistDir, serveStaticFile: mailbox_http_static_1.serveStaticFile };
+    return (request, response) => {
+        if (rawRequestTargetsUnsafeAgent(request.url)) {
+            (0, mailbox_http_response_1.writeJson)(response, 400, { ok: false, error: "agent name must be a safe bundle name" });
+            return;
+        }
+        let pathname = (0, mailbox_http_static_1.normalizeMailboxRequestPath)(request.url);
+        const origin = `http://${options.host}:${options.getPort()}`;
+        if (pathname.startsWith("/assets/")) {
+            const spaDir = staticFiles.resolveSpaDistDir();
+            if (spaDir) {
+                const assetPath = path.join(spaDir, pathname);
+                if (staticFiles.serveStaticFile(response, assetPath))
+                    return;
+            }
+            (0, mailbox_http_response_1.writeJson)(response, 404, { ok: false, error: "asset not found" });
+            return;
+        }
+        if (pathname === "/mailbox" || pathname === "/outlook") {
+            response.writeHead(301, { location: "/" });
+            response.end();
+            return;
+        }
+        pathname = (0, mailbox_http_static_1.normalizeLegacyMailboxApiPath)(pathname);
+        if (pathname === "/api/events") {
+            response.writeHead(200, { "content-type": "text/event-stream", "cache-control": "no-cache", "connection": "keep-alive", "access-control-allow-origin": "*" });
+            response.write(":ok\n\n");
+            options.sse.add(response);
+            return;
+        }
+        if (pathname === "/api/machine") {
+            const machine = options.readMachineState();
+            const machineView = options.readMachineView?.({ origin, machine });
+            (0, mailbox_http_response_1.writeJson)(response, 200, machineView ?? machine);
+            return;
+        }
+        if (pathname === "/api/machine/health") {
+            const health = options.hooks.readDaemonHealth();
+            (0, mailbox_http_response_1.writeJson)(response, 200, health ?? { status: "unavailable" });
+            return;
+        }
+        if (pathname === "/api/machine/logs") {
+            (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readLogs());
+            return;
+        }
+        const agentMatch = /^\/api\/agents\/([^/]+)(?:\/(.+))?$/.exec(pathname);
+        if (agentMatch) {
+            const agent = decodePathSegment(agentMatch[1]);
+            /* v8 ignore next -- rawRequestTargetsUnsafeAgent rejects unsafe/malformed agent segments before normalization @preserve */
+            if (!agent || !(0, mailbox_http_hooks_1.isSafeMailboxAgentName)(agent)) {
+                (0, mailbox_http_response_1.writeJson)(response, 400, { ok: false, error: "agent name must be a safe bundle name" });
+                return;
+            }
+            void handleAgentRoute(request, response, {
+                agent,
+                surface: agentMatch[2] ?? null,
+                options,
+            }).catch((error) => {
+                (0, mailbox_http_response_1.writeJson)(response, 500, { ok: false, error: error instanceof Error ? error.message : String(error) });
+            });
+            return;
+        }
+        const spaDir = staticFiles.resolveSpaDistDir();
+        if (spaDir) {
+            if (staticFiles.serveStaticFile(response, path.join(spaDir, "index.html")))
+                return;
+        }
+        (0, mailbox_http_response_1.writeJson)(response, 404, { ok: false, error: `not found: ${pathname}` });
+    };
+}
+async function handleAgentRoute(request, response, context) {
+    const { agent, surface, options } = context;
+    if (!surface) {
+        const view = options.readAgentView?.(agent);
+        if (view) {
+            (0, mailbox_http_response_1.writeJson)(response, 200, view);
+            return;
+        }
+        const state = options.readAgentState(agent);
+        if (!state) {
+            (0, mailbox_http_response_1.writeJson)(response, 404, { ok: false, error: `unknown agent: ${agent}` });
+            return;
+        }
+        (0, mailbox_http_response_1.writeJson)(response, 200, state);
+        return;
+    }
+    if (surface === "sessions") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentSessions(agent));
+        return;
+    }
+    const transcriptMatch = /^sessions\/([^/]+)\/([^/]+)\/([^/]+)$/.exec(surface);
+    if (transcriptMatch) {
+        const friendId = decodeURIComponent(transcriptMatch[1]);
+        const channel = decodeURIComponent(transcriptMatch[2]);
+        const key = decodeURIComponent(transcriptMatch[3]);
+        const transcript = options.hooks.readAgentTranscript(agent, friendId, channel, key);
+        if (!transcript) {
+            (0, mailbox_http_response_1.writeJson)(response, 404, { ok: false, error: "session not found" });
+            return;
+        }
+        (0, mailbox_http_response_1.writeJson)(response, 200, transcript);
+        return;
+    }
+    if (surface === "coding") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentCoding(agent));
+        return;
+    }
+    if (surface === "attention") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentAttention(agent));
+        return;
+    }
+    if (surface === "bridges") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentBridges(agent));
+        return;
+    }
+    if (surface === "notes") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentNotes(agent));
+        return;
+    }
+    if (surface === "friends") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentFriends(agent));
+        return;
+    }
+    if (surface === "continuity") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentContinuity(agent));
+        return;
+    }
+    if (surface === "orientation") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentOrientation(agent));
+        return;
+    }
+    if (surface === "obligations") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentObligations(agent));
+        return;
+    }
+    if (surface === "changes") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentChanges(agent));
+        return;
+    }
+    if (surface === "self-fix") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentSelfFix(agent));
+        return;
+    }
+    if (surface === "context-loss-gauntlet") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentContextLossGauntlet(agent));
+        return;
+    }
+    if (surface === "sentinel") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentSentinel(agent));
+        return;
+    }
+    if (surface === "note-decisions") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentNoteDecisions(agent));
+        return;
+    }
+    if (surface === "dismiss-obligation" && request.method === "POST") {
+        handleDismissObligation(request, response, options.hooks.agentRoot(agent));
+        return;
+    }
+    if (surface === "desk-prefs") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readDeskPrefs(agent));
+        return;
+    }
+    if (surface === "needs-me") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readNeedsMe(agent));
+        return;
+    }
+    if (surface === "habits") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentHabits(agent));
+        return;
+    }
+    if (surface === "habit-runs") {
+        const limit = parseHabitRunLimit(request.url);
+        if (limit === null) {
+            (0, mailbox_http_response_1.writeJson)(response, 400, { ok: false, error: "limit must be an integer between 1 and 100" });
+            return;
+        }
+        const view = limit === undefined
+            ? options.hooks.readAgentHabitRuns(agent)
+            : options.hooks.readAgentHabitRuns(agent, { limit });
+        (0, mailbox_http_response_1.writeJson)(response, 200, view);
+        return;
+    }
+    if (surface === "habit-run-summaries") {
+        const limit = parseHabitRunLimit(request.url);
+        if (limit === null) {
+            (0, mailbox_http_response_1.writeJson)(response, 400, { ok: false, error: "limit must be an integer between 1 and 100" });
+            return;
+        }
+        const view = limit === undefined
+            ? options.hooks.readAgentHabitRunSummaries(agent)
+            : options.hooks.readAgentHabitRunSummaries(agent, { limit });
+        (0, mailbox_http_response_1.writeJson)(response, 200, view);
+        return;
+    }
+    if (surface === "habit-run-summary") {
+        const parsed = parseHabitSummarySelector(request.url);
+        if (!parsed.ok) {
+            (0, mailbox_http_response_1.writeJson)(response, 400, { ok: false, error: parsed.error });
+            return;
+        }
+        const summary = options.hooks.readAgentHabitRunSummary(agent, parsed.selector);
+        if (!summary) {
+            (0, mailbox_http_response_1.writeJson)(response, 404, { ok: false, error: "habit summary not found" });
+            return;
+        }
+        (0, mailbox_http_response_1.writeJson)(response, 200, summary);
+        return;
+    }
+    if (surface.startsWith("habit-runs/")) {
+        const rawRunId = surface.slice("habit-runs/".length);
+        const runId = decodePathSegment(rawRunId);
+        const view = runId ? options.hooks.readAgentHabitRun(agent, runId) : null;
+        if (!view) {
+            (0, mailbox_http_response_1.writeJson)(response, 404, { ok: false, error: `habit run '${rawRunId}' not found` });
+            return;
+        }
+        (0, mailbox_http_response_1.writeJson)(response, 200, view);
+        return;
+    }
+    if (surface === "context-packets") {
+        const limit = parseHabitRunLimit(request.url);
+        if (limit === null) {
+            (0, mailbox_http_response_1.writeJson)(response, 400, { ok: false, error: "limit must be an integer between 1 and 100" });
+            return;
+        }
+        const view = limit === undefined
+            ? options.hooks.readAgentContextPackets(agent)
+            : options.hooks.readAgentContextPackets(agent, { limit });
+        (0, mailbox_http_response_1.writeJson)(response, 200, view);
+        return;
+    }
+    if (surface.startsWith("context-packets/")) {
+        const rawPacketId = surface.slice("context-packets/".length);
+        const packetId = decodePathSegment(rawPacketId);
+        const view = packetId ? options.hooks.readAgentContextPacket(agent, packetId) : null;
+        if (!view) {
+            (0, mailbox_http_response_1.writeJson)(response, 404, { ok: false, error: `context packet '${rawPacketId}' not found` });
+            return;
+        }
+        (0, mailbox_http_response_1.writeJson)(response, 200, view);
+        return;
+    }
+    if (surface === "mail") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, await options.hooks.readAgentMail(agent));
+        return;
+    }
+    const mailMessageMatch = /^mail\/([^/]+)$/.exec(surface);
+    if (mailMessageMatch) {
+        const messageId = decodeURIComponent(mailMessageMatch[1]);
+        (0, mailbox_http_response_1.writeJson)(response, 200, await options.hooks.readAgentMailMessage(agent, messageId));
+        return;
+    }
+    if (surface === "inner-transcript") {
+        const transcript = options.hooks.readAgentTranscript(agent, "self", "inner", "dialog");
+        (0, mailbox_http_response_1.writeJson)(response, 200, transcript ?? { messageCount: 0, messages: [] });
+        return;
+    }
+    (0, mailbox_http_response_1.writeJson)(response, 404, { ok: false, error: `unknown agent surface: ${surface}` });
+}
+function handleDismissObligation(request, response, agentRoot) {
+    let body = "";
+    request.on("data", (chunk) => {
+        body += chunk;
+    });
+    request.on("end", () => {
+        try {
+            const { obligationId } = JSON.parse(body);
+            if (!obligationId) {
+                (0, mailbox_http_response_1.writeJson)(response, 400, { ok: false, error: "obligationId required" });
+                return;
+            }
+            const prefsPath = path.join(agentRoot, "state", "mailbox-prefs.json");
+            const legacyPrefsPath = path.join(agentRoot, "state", "outlook-prefs.json");
+            let prefs = {};
+            try {
+                const readPath = fs.existsSync(prefsPath) ? prefsPath : legacyPrefsPath;
+                prefs = JSON.parse(fs.readFileSync(readPath, "utf-8"));
+            }
+            catch {
+                // Missing or malformed prefs start from a clean preference object.
+            }
+            const dismissed = Array.isArray(prefs.dismissedObligations) ? prefs.dismissedObligations : [];
+            if (!dismissed.includes(obligationId))
+                dismissed.push(obligationId);
+            prefs.dismissedObligations = dismissed;
+            fs.mkdirSync(path.dirname(prefsPath), { recursive: true });
+            fs.writeFileSync(prefsPath, `${JSON.stringify(prefs, null, 2)}\n`, "utf-8");
+            (0, mailbox_http_response_1.writeJson)(response, 200, { ok: true, dismissed: dismissed.length });
+        }
+        catch (error) {
+            (0, mailbox_http_response_1.writeJson)(response, 500, { ok: false, error: String(error) });
+        }
+    });
+}

package/dist/heart/mailbox/mailbox-http-static.js

@@ -0,0 +1,103 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeMailboxRequestPath = normalizeMailboxRequestPath;
+exports.normalizeLegacyMailboxApiPath = normalizeLegacyMailboxApiPath;
+exports.resolveSpaDistDir = resolveSpaDistDir;
+exports.serveStaticFile = serveStaticFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const MIME_TYPES = {
+    ".html": "text/html",
+    ".js": "application/javascript",
+    ".css": "text/css",
+    ".json": "application/json",
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".ico": "image/x-icon",
+    ".woff2": "font/woff2",
+};
+function normalizeMailboxRequestPath(urlValue = "/") {
+    const parsed = new URL(urlValue, "http://127.0.0.1");
+    const normalizedPath = parsed.pathname.replace(/\/+$/, "");
+    if (normalizedPath.length === 0)
+        return "/";
+    return normalizedPath;
+}
+function normalizeLegacyMailboxApiPath(pathname) {
+    if (pathname.startsWith("/mailbox/api/"))
+        return pathname.slice("/mailbox".length);
+    if (pathname === "/mailbox/api")
+        return "/api";
+    if (pathname.startsWith("/outlook/api/"))
+        return pathname.slice("/outlook".length);
+    if (pathname === "/outlook/api")
+        return "/api";
+    return pathname;
+}
+function defaultSpaDistCandidates() {
+    return [
+        path.resolve(__dirname, "..", "..", "..", "packages", "mailbox-ui", "dist"),
+        path.resolve(__dirname, "..", "..", "packages", "mailbox-ui", "dist"),
+        path.resolve(__dirname, "..", "..", "..", "..", "packages", "mailbox-ui", "dist"),
+        path.resolve(__dirname, "..", "..", "mailbox-ui"),
+        path.resolve(__dirname, "..", "mailbox-ui"),
+    ];
+}
+function resolveSpaDistDir(candidates = defaultSpaDistCandidates()) {
+    for (const candidate of candidates) {
+        if (fs.existsSync(path.join(candidate, "index.html")))
+            return candidate;
+    }
+    return null;
+}
+function serveStaticFile(response, filePath) {
+    try {
+        if (!fs.existsSync(filePath))
+            return false;
+        const ext = path.extname(filePath);
+        const contentType = MIME_TYPES[ext] ?? "application/octet-stream";
+        const content = fs.readFileSync(filePath);
+        response.writeHead(200, {
+            "content-type": contentType,
+            "cache-control": ext === ".html" ? "no-cache" : "public, max-age=31536000, immutable",
+        });
+        response.end(content);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/heart/mailbox/mailbox-http-transport.js

@@ -0,0 +1,129 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSseBroadcaster = createSseBroadcaster;
+exports.createStateChangedBroadcast = createStateChangedBroadcast;
+exports.createBundleWatcher = createBundleWatcher;
+const fs = __importStar(require("fs"));
+const DEFAULT_BUNDLE_WATCHER_DEPS = {
+    existsSync: fs.existsSync,
+    watch: fs.watch,
+    setTimeout,
+    clearTimeout,
+};
+function createSseBroadcaster() {
+    let nextId = 1;
+    const clients = new Set();
+    function add(response) {
+        const client = { id: nextId++, response };
+        clients.add(client);
+        response.on("close", () => clients.delete(client));
+        return client;
+    }
+    function broadcast(event, data = {}) {
+        const payload = `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
+        for (const client of clients) {
+            try {
+                client.response.write(payload);
+            }
+            catch {
+                clients.delete(client);
+            }
+        }
+    }
+    function disconnectAll() {
+        for (const client of clients) {
+            try {
+                client.response.end();
+            }
+            catch {
+                // The client may already have closed between the loop snapshot and end.
+            }
+        }
+        clients.clear();
+    }
+    return { add, broadcast, disconnectAll };
+}
+function createStateChangedBroadcast(sse) {
+    return () => {
+        sse.broadcast("state-changed", { at: new Date().toISOString() });
+    };
+}
+function createBundleWatcher(bundlesRoot, onChange, deps = DEFAULT_BUNDLE_WATCHER_DEPS) {
+    const watchers = [];
+    let debounceTimer = null;
+    const debounceMs = 500;
+    function debouncedOnChange() {
+        if (debounceTimer)
+            deps.clearTimeout(debounceTimer);
+        debounceTimer = deps.setTimeout(onChange, debounceMs);
+    }
+    try {
+        if (deps.existsSync(bundlesRoot)) {
+            const watcher = deps.watch(bundlesRoot, { recursive: true }, debouncedOnChange);
+            watcher.on?.("error", () => {
+                try {
+                    watcher.close();
+                }
+                catch {
+                    // Already closed.
+                }
+                const index = watchers.indexOf(watcher);
+                if (index >= 0)
+                    watchers.splice(index, 1);
+                debouncedOnChange();
+            });
+            watchers.push(watcher);
+        }
+    }
+    catch {
+        // Watching is best-effort; manual broadcasts still keep Mailbox usable.
+    }
+    return {
+        stop() {
+            if (debounceTimer)
+                deps.clearTimeout(debounceTimer);
+            for (const watcher of watchers) {
+                try {
+                    watcher.close();
+                }
+                catch {
+                    // Already closed.
+                }
+            }
+            watchers.length = 0;
+        },
+    };
+}