@mlola/browser-daemon 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MLola
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# @mlola/browser-daemon
+
+`mlola-browserd`: the local daemon of the
+[MLola Browser Runtime](https://mlola.com/browser-runtime). Owns detached runs,
+the run/event registry, approvals, human help and artifacts behind a
+token-protected HTTP API bound to 127.0.0.1.
+
+```bash
+npx mlola-browserd --port 7717
+curl -s localhost:7717/v1/health
+```

package/dist/bin.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * mlola-browserd — the local browser runtime daemon.
+ */
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;GAEG"}

package/dist/bin.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+/**
+ * mlola-browserd — the local browser runtime daemon.
+ */
+import { parseArgs } from "./cli-args.js";
+import { BrowserDaemon } from "./server.js";
+import { DEFAULT_DAEMON_PORT } from "./state.js";
+import { resolveHome } from "@mlola/browser-trace";
+const main = async () => {
+    const { flags } = parseArgs(process.argv.slice(2));
+    const portFlag = flags["port"];
+    const port = typeof portFlag === "string" ? Number(portFlag) : DEFAULT_DAEMON_PORT;
+    const home = typeof flags["home"] === "string" ? flags["home"] : resolveHome();
+    const daemon = new BrowserDaemon({ port: Number.isFinite(port) ? port : DEFAULT_DAEMON_PORT, home });
+    const { url } = await daemon.start();
+    process.stdout.write(`mlola-browserd listening on ${url} (home ${home})\n`);
+    const shutdown = async (signal) => {
+        process.stdout.write(`mlola-browserd: ${signal}, stopping\n`);
+        await daemon.stop();
+        process.exit(0);
+    };
+    process.on("SIGTERM", () => void shutdown("SIGTERM"));
+    process.on("SIGINT", () => void shutdown("SIGINT"));
+};
+main().catch((error) => {
+    process.stderr.write(`mlola-browserd failed: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;IACrC,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC;IACnF,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAE/E,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC;IACrG,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAErC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,GAAG,UAAU,IAAI,KAAK,CAAC,CAAC;IAE5E,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAiB,EAAE;QACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,MAAM,cAAc,CAAC,CAAC;QAC9D,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACtD,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli-args.d.ts

@@ -0,0 +1,7 @@
+/** Argument parsing for the daemon process (no CLI dependency). */
+export interface DaemonArgs {
+    flags: Record<string, string | boolean>;
+    positional: string[];
+}
+export declare const parseArgs: (argv: string[]) => DaemonArgs;
+//# sourceMappingURL=cli-args.d.ts.map

package/dist/cli-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../src/cli-args.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,KAAG,UAwB1C,CAAC"}

package/dist/cli-args.js

@@ -0,0 +1,28 @@
+/** Argument parsing for the daemon process (no CLI dependency). */
+export const parseArgs = (argv) => {
+    const flags = {};
+    const positional = [];
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg.startsWith("--")) {
+            const eq = arg.indexOf("=");
+            if (eq > 0) {
+                flags[arg.slice(2, eq)] = arg.slice(eq + 1);
+                continue;
+            }
+            const key = arg.slice(2);
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith("-")) {
+                flags[key] = next;
+                i += 1;
+            }
+            else {
+                flags[key] = true;
+            }
+            continue;
+        }
+        positional.push(arg);
+    }
+    return { flags, positional };
+};
+//# sourceMappingURL=cli-args.js.map

package/dist/cli-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-args.js","sourceRoot":"","sources":["../src/cli-args.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAOnE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAc,EAAc,EAAE;IACtD,MAAM,KAAK,GAAqC,EAAE,CAAC;IACnD,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACrB,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;gBACX,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBAC5C,SAAS;YACX,CAAC;YACD,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzB,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChD,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;gBAClB,CAAC,IAAI,CAAC,CAAC;YACT,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACpB,CAAC;YACD,SAAS;QACX,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAC/B,CAAC,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Daemon client: lifecycle helpers and the typed local API client.
+ */
+import type { RunEvent, RunResult, TaskSpec } from "@mlola/browser-protocol";
+import { type DaemonState } from "./state.ts";
+export interface DaemonStatusResult {
+    running: boolean;
+    version?: string;
+    protocol?: string;
+    sessions?: number;
+    port?: number;
+}
+export declare const daemonStatus: (home?: string) => Promise<DaemonStatusResult>;
+export declare const startDaemon: (options?: {
+    port?: number;
+    foreground?: boolean;
+    home?: string;
+}) => Promise<{
+    started: boolean;
+    url: string;
+    pid: number;
+    tokenPath: string;
+}>;
+export declare const stopDaemon: (home?: string) => Promise<{
+    stopped: boolean;
+    forced?: boolean;
+}>;
+export declare const daemonFetch: <T>(state: DaemonState, method: "GET" | "POST", path: string, body?: unknown, home?: string) => Promise<T>;
+export interface DaemonRunClient {
+    runId: string;
+    status: string;
+    result?: RunResult;
+    pendingHelp: string[];
+    error?: string;
+}
+export declare const createRunViaDaemon: (task: TaskSpec, home?: string) => Promise<DaemonRunClient>;
+export declare const getRunViaDaemon: (runId: string, home?: string) => Promise<DaemonRunClient>;
+export declare const listRunEventsViaDaemon: (runId: string, since?: number, home?: string) => Promise<{
+    events: RunEvent[];
+    lastSeq: number;
+}>;
+export declare const cancelRunViaDaemon: (runId: string, home?: string) => Promise<void>;
+export declare const resolveHelpViaDaemon: (runId: string, helpId: string, resolution: "completed" | "cancelled" | "takeover", home?: string) => Promise<void>;
+export declare const resolveApprovalViaDaemon: (runId: string, approvalId: string, resolution: "approved" | "denied" | "takeover", home?: string) => Promise<void>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE7E,OAAO,EAOL,KAAK,WAAW,EACjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,YAAY,GAAU,aAAoB,KAAG,OAAO,CAAC,kBAAkB,CAmBnF,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,UAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,KACnE,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAwC3E,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,aAAoB,KAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CA4CrG,CAAC;AAIF,eAAO,MAAM,WAAW,GAAU,CAAC,EACjC,OAAO,WAAW,EAClB,QAAQ,KAAK,GAAG,MAAM,EACtB,MAAM,MAAM,EACZ,OAAO,OAAO,EACd,aAAoB,KACnB,OAAO,CAAC,CAAC,CAgBX,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,kBAAkB,GAAU,MAAM,QAAQ,EAAE,aAAoB,KAAG,OAAO,CAAC,eAAe,CAGtG,CAAC;AAEF,eAAO,MAAM,eAAe,GAAU,OAAO,MAAM,EAAE,aAAoB,KAAG,OAAO,CAAC,eAAe,CAGlG,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,OAAO,MAAM,EACb,cAAS,EACT,aAAoB,KACnB,OAAO,CAAC;IAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CASjD,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,OAAO,MAAM,EAAE,aAAoB,KAAG,OAAO,CAAC,IAAI,CAG1F,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,MAAM,EACb,QAAQ,MAAM,EACd,YAAY,WAAW,GAAG,WAAW,GAAG,UAAU,EAClD,aAAoB,KACnB,OAAO,CAAC,IAAI,CAGd,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,OAAO,MAAM,EACb,YAAY,MAAM,EAClB,YAAY,UAAU,GAAG,QAAQ,GAAG,UAAU,EAC9C,aAAoB,KACnB,OAAO,CAAC,IAAI,CAGd,CAAC"}

package/dist/client.js

@@ -0,0 +1,158 @@
+/**
+ * Daemon client: lifecycle helpers and the typed local API client.
+ */
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { resolveHome } from "@mlola/browser-trace";
+import { DEFAULT_DAEMON_PORT, clearDaemonState, daemonStatePath, isProcessAlive, readDaemonState, readToken, } from "./state.js";
+export const daemonStatus = async (home = resolveHome()) => {
+    const state = readDaemonState(home);
+    if (!state || !isProcessAlive(state.pid))
+        return { running: false };
+    try {
+        const health = await daemonFetch(state, "GET", "/v1/health");
+        return {
+            running: health.status === "ok",
+            version: health.version,
+            protocol: health.protocol,
+            sessions: health.sessions,
+            port: state.port,
+        };
+    }
+    catch {
+        return { running: false, port: state.port };
+    }
+};
+export const startDaemon = async (options = {}) => {
+    const home = options.home ?? resolveHome();
+    const existing = await daemonStatus(home);
+    if (existing.running) {
+        const state = readDaemonState(home);
+        return { started: false, url: state.url, pid: state.pid, tokenPath: state.tokenPath };
+    }
+    const port = options.port ?? DEFAULT_DAEMON_PORT;
+    const here = fileURLToPath(import.meta.url);
+    const extension = here.endsWith(".ts") ? ".ts" : ".js";
+    const binPath = join(dirname(here), `bin${extension}`);
+    const child = spawn(process.execPath, [binPath, "--port", String(port), ...(options.foreground ? ["--foreground"] : [])], {
+        detached: !options.foreground,
+        stdio: options.foreground ? "inherit" : "ignore",
+        env: { ...process.env, MLOLA_HOME: home },
+    });
+    if (!options.foreground)
+        child.unref();
+    // Wait for the daemon to answer on its health endpoint.
+    const deadline = Date.now() + 15_000;
+    while (Date.now() < deadline) {
+        await new Promise((resolve) => setTimeout(resolve, 150));
+        const state = readDaemonState(home);
+        if (!state)
+            continue;
+        try {
+            const health = await daemonFetch(state, "GET", "/v1/health");
+            if (health.status === "ok") {
+                return { started: true, url: state.url, pid: state.pid, tokenPath: state.tokenPath };
+            }
+        }
+        catch {
+            /* keep waiting */
+        }
+    }
+    throw new Error(`daemon did not become healthy within 15s (bin: ${binPath})`);
+};
+export const stopDaemon = async (home = resolveHome()) => {
+    const state = readDaemonState(home);
+    if (!state)
+        return { stopped: false };
+    if (!isProcessAlive(state.pid)) {
+        clearDaemonState(home);
+        return { stopped: false };
+    }
+    try {
+        await daemonFetch(state, "POST", "/v1/shutdown");
+    }
+    catch {
+        /* fall through to signals */
+    }
+    const gracefulDeadline = Date.now() + 5000;
+    while (Date.now() < gracefulDeadline) {
+        if (!isProcessAlive(state.pid)) {
+            clearDaemonState(home);
+            return { stopped: true };
+        }
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    try {
+        process.kill(state.pid, "SIGTERM");
+    }
+    catch {
+        /* already gone */
+    }
+    const killDeadline = Date.now() + 3000;
+    while (Date.now() < killDeadline) {
+        if (!isProcessAlive(state.pid)) {
+            clearDaemonState(home);
+            return { stopped: true };
+        }
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    try {
+        process.kill(state.pid, "SIGKILL");
+    }
+    catch {
+        /* already gone */
+    }
+    clearDaemonState(home);
+    return { stopped: true, forced: true };
+};
+/* ─────────────────────────────── typed API ───────────────────────────────── */
+export const daemonFetch = async (state, method, path, body, home = resolveHome()) => {
+    const token = readToken(home);
+    if (!token)
+        throw new Error(`daemon token not found at ${state.tokenPath}`);
+    const response = await fetch(`${state.url}${path}`, {
+        method,
+        headers: {
+            authorization: `Bearer ${token}`,
+            ...(body !== undefined ? { "content-type": "application/json" } : {}),
+        },
+        ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+    });
+    const text = await response.text();
+    if (!response.ok) {
+        throw new Error(`daemon ${method} ${path} failed (${response.status}): ${text.slice(0, 300)}`);
+    }
+    return (text.length > 0 ? JSON.parse(text) : {});
+};
+export const createRunViaDaemon = async (task, home = resolveHome()) => {
+    const state = requireState(home);
+    return daemonFetch(state, "POST", "/v1/runs", task, home);
+};
+export const getRunViaDaemon = async (runId, home = resolveHome()) => {
+    const state = requireState(home);
+    return daemonFetch(state, "GET", `/v1/runs/${runId}`, undefined, home);
+};
+export const listRunEventsViaDaemon = async (runId, since = 0, home = resolveHome()) => {
+    const state = requireState(home);
+    return daemonFetch(state, "GET", `/v1/runs/${runId}/events?since=${since}`, undefined, home);
+};
+export const cancelRunViaDaemon = async (runId, home = resolveHome()) => {
+    const state = requireState(home);
+    await daemonFetch(state, "POST", `/v1/runs/${runId}/cancel`, {}, home);
+};
+export const resolveHelpViaDaemon = async (runId, helpId, resolution, home = resolveHome()) => {
+    const state = requireState(home);
+    await daemonFetch(state, "POST", `/v1/runs/${runId}/help/${helpId}`, { resolution }, home);
+};
+export const resolveApprovalViaDaemon = async (runId, approvalId, resolution, home = resolveHome()) => {
+    const state = requireState(home);
+    await daemonFetch(state, "POST", `/v1/runs/${runId}/approvals/${approvalId}`, { resolution }, home);
+};
+const requireState = (home) => {
+    const state = readDaemonState(home);
+    if (!state)
+        throw new Error(`daemon is not running (no state file at ${daemonStatePath(home)})`);
+    return state;
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/human.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Remote human loop (PRD §19, §59).
+ *
+ * In daemon mode the person is reached over the local HTTP API: help requests
+ * and approvals are queued with their ids and resolved by a client.
+ */
+import type { ApprovalRequest, HumanHelpRequest, HumanHelpResolution } from "@mlola/browser-protocol";
+import { ApprovalBroker } from "@mlola/browser-policy";
+import type { HumanHelpHost } from "@mlola/browser-takeover";
+export declare class RemoteHumanHelpHost implements HumanHelpHost {
+    #private;
+    constructor(onRequest?: (request: HumanHelpRequest) => void);
+    ask(request: HumanHelpRequest): Promise<HumanHelpResolution>;
+    resolve(id: string, resolution: HumanHelpResolution): boolean;
+    pending(): string[];
+    cancelAll(): void;
+}
+export declare class RemoteApprovalBroker extends ApprovalBroker {
+    constructor();
+}
+export interface PendingApproval {
+    request: ApprovalRequest;
+    at: number;
+}
+//# sourceMappingURL=human.d.ts.map

package/dist/human.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"human.d.ts","sourceRoot":"","sources":["../src/human.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACtG,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,qBAAa,mBAAoB,YAAW,aAAa;;gBAI3C,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI;IAIrD,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAOlE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,mBAAmB,GAAG,OAAO;IAQ7D,OAAO,IAAI,MAAM,EAAE;IAInB,SAAS,IAAI,IAAI;CAMlB;AAED,qBAAa,oBAAqB,SAAQ,cAAc;;CAIvD;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,eAAe,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;CACZ"}

package/dist/human.js

@@ -0,0 +1,43 @@
+/**
+ * Remote human loop (PRD §19, §59).
+ *
+ * In daemon mode the person is reached over the local HTTP API: help requests
+ * and approvals are queued with their ids and resolved by a client.
+ */
+import { ApprovalBroker } from "@mlola/browser-policy";
+export class RemoteHumanHelpHost {
+    #pending = new Map();
+    #onRequest;
+    constructor(onRequest) {
+        this.#onRequest = onRequest;
+    }
+    async ask(request) {
+        this.#onRequest?.(request);
+        return new Promise((resolve) => {
+            this.#pending.set(request.id, resolve);
+        });
+    }
+    resolve(id, resolution) {
+        const resolve = this.#pending.get(id);
+        if (!resolve)
+            return false;
+        this.#pending.delete(id);
+        resolve(resolution);
+        return true;
+    }
+    pending() {
+        return [...this.#pending.keys()];
+    }
+    cancelAll() {
+        for (const [id, resolve] of this.#pending) {
+            this.#pending.delete(id);
+            resolve("cancelled");
+        }
+    }
+}
+export class RemoteApprovalBroker extends ApprovalBroker {
+    constructor() {
+        super({ timeoutMs: 10 * 60 * 1000 });
+    }
+}
+//# sourceMappingURL=human.js.map

package/dist/human.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"human.js","sourceRoot":"","sources":["../src/human.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,MAAM,OAAO,mBAAmB;IAC9B,QAAQ,GAAG,IAAI,GAAG,EAAqD,CAAC;IACxE,UAAU,CAAoD;IAE9D,YAAY,SAA+C;QACzD,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAAyB;QACjC,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC;QAC3B,OAAO,IAAI,OAAO,CAAsB,CAAC,OAAO,EAAE,EAAE;YAClD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,EAAU,EAAE,UAA+B;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzB,OAAO,CAAC,UAAU,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,SAAS;QACP,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACzB,OAAO,CAAC,WAAW,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,cAAc;IACtD;QACE,KAAK,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { parseArgs } from "./cli-args.ts";
+export * from "./state.ts";
+export * from "./human.ts";
+export * from "./server.ts";
+export * from "./client.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { parseArgs } from "./cli-args.js";
+export * from "./state.js";
+export * from "./human.js";
+export * from "./server.js";
+export * from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,29 @@
+/**
+ * mlola-browserd HTTP server (PRD §47, §59).
+ *
+ * Local-only JSON API: runs, sessions, events, approvals, human help and
+ * artifacts. Bound to 127.0.0.1 and protected by a token file so that other
+ * local processes cannot drive a browser session by accident.
+ */
+export interface DaemonOptions {
+    port?: number;
+    home?: string;
+    /** When true, do not write a pid/state file (useful for tests). */
+    ephemeral?: boolean;
+}
+export declare class BrowserDaemon {
+    #private;
+    readonly home: string;
+    constructor(options?: DaemonOptions);
+    get port(): number;
+    get url(): string;
+    start(): Promise<{
+        port: number;
+        url: string;
+    }>;
+    stop(): Promise<void>;
+    get sessions(): number;
+}
+export declare const createDaemon: (options?: DaemonOptions) => BrowserDaemon;
+export declare const ensureDaemonDirs: (home?: string) => void;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0CH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,aAAa;;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAQV,OAAO,GAAE,aAAkB;IAOvC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAEK,KAAK,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IA8B/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,IAAI,QAAQ,IAAI,MAAM,CAErB;CA0OF;AAkBD,eAAO,MAAM,YAAY,GAAI,UAAS,aAAkB,KAAG,aAA2C,CAAC;AAEvG,eAAO,MAAM,gBAAgB,GAAI,aAAoB,KAAG,IAEvD,CAAC"}

package/dist/server.js

@@ -0,0 +1,320 @@
+/**
+ * mlola-browserd HTTP server (PRD §47, §59).
+ *
+ * Local-only JSON API: runs, sessions, events, approvals, human help and
+ * artifacts. Bound to 127.0.0.1 and protected by a token file so that other
+ * local processes cannot drive a browser session by accident.
+ */
+import { createServer } from "node:http";
+import { mkdirSync } from "node:fs";
+import { PROTOCOL_VERSION, RUNTIME_CAPABILITIES, createRunRequestSchema, formatZodError, approvalResolutionSchema, helpResolutionSchema, } from "@mlola/browser-protocol";
+import { ApprovalBroker } from "@mlola/browser-policy";
+import { BrowserAgent } from "@mlola/browser-runtime";
+import { readRunEvents, readRunSummary, resolveHome } from "@mlola/browser-trace";
+import { DEFAULT_DAEMON_PORT, clearDaemonState, ensureToken, readDaemonState, writeDaemonState, } from "./state.js";
+import { RemoteApprovalBroker, RemoteHumanHelpHost } from "./human.js";
+const VERSION = "0.1.0";
+export class BrowserDaemon {
+    home;
+    #port;
+    #ephemeral;
+    #server;
+    #token;
+    #runs = new Map();
+    #startedAt = Date.now();
+    constructor(options = {}) {
+        this.home = options.home ?? resolveHome();
+        this.#port = options.port ?? DEFAULT_DAEMON_PORT;
+        this.#ephemeral = options.ephemeral ?? false;
+        this.#token = ensureToken(this.home);
+    }
+    get port() {
+        return this.#port;
+    }
+    get url() {
+        return `http://127.0.0.1:${this.#port}`;
+    }
+    async start() {
+        const server = createServer((req, res) => {
+            void this.#handle(req, res);
+        });
+        this.#server = server;
+        await new Promise((resolve, reject) => {
+            server.once("error", reject);
+            server.listen(this.#port, "127.0.0.1", () => resolve());
+        });
+        const address = server.address();
+        if (address && typeof address === "object")
+            this.#port = address.port;
+        if (!this.#ephemeral) {
+            writeDaemonState({
+                pid: process.pid,
+                port: this.#port,
+                url: this.url,
+                startedAt: this.#startedAt,
+                tokenPath: ensureTokenPath(this.home),
+                version: VERSION,
+            }, this.home);
+        }
+        return { port: this.#port, url: this.url };
+    }
+    async stop() {
+        for (const run of this.#runs.values()) {
+            run.agent.stop("daemon shutdown");
+            run.human.cancelAll();
+            run.approvals.cancelAll("denied");
+        }
+        if (this.#server) {
+            await new Promise((resolve) => this.#server.close(() => resolve()));
+            this.#server = undefined;
+        }
+        if (!this.#ephemeral)
+            clearDaemonState(this.home);
+    }
+    get sessions() {
+        return [...this.#runs.values()].filter((run) => run.status === "running").length;
+    }
+    /* ─────────────────────────────── routing ─────────────────────────────── */
+    async #handle(req, res) {
+        const url = new URL(req.url ?? "/", this.url);
+        const path = url.pathname;
+        try {
+            // Health is unauthenticated so `doctor` and `status` can probe safely.
+            if (req.method === "GET" && path === "/v1/health") {
+                return this.#json(res, 200, {
+                    status: "ok",
+                    version: VERSION,
+                    protocol: PROTOCOL_VERSION,
+                    sessions: this.sessions,
+                    uptimeMs: Date.now() - this.#startedAt,
+                });
+            }
+            if (!this.#authorized(req)) {
+                return this.#json(res, 401, { error: "unauthorized", detail: "missing or invalid bearer token" });
+            }
+            if (req.method === "GET" && path === "/v1/meta") {
+                const { readDaemonState: _read } = await import("./state.js");
+                void _read;
+                return this.#json(res, 200, {
+                    protocol: PROTOCOL_VERSION,
+                    runtime: RUNTIME_CAPABILITIES,
+                    version: VERSION,
+                    port: this.#port,
+                    home: this.home,
+                });
+            }
+            if (req.method === "POST" && path === "/v1/runs") {
+                const body = await readJson(req);
+                const parsed = createRunRequestSchema.safeParse(body);
+                if (!parsed.success)
+                    return this.#json(res, 400, { error: formatZodError(parsed.error, "run request") });
+                const created = await this.#createRun(parsed.data);
+                return this.#json(res, 202, created);
+            }
+            if (req.method === "GET" && path === "/v1/runs") {
+                return this.#json(res, 200, { runs: this.#listRuns() });
+            }
+            const runMatch = /^\/v1\/runs\/([^/]+)$/.exec(path);
+            if (req.method === "GET" && runMatch) {
+                const runId = runMatch[1];
+                const active = this.#runs.get(runId);
+                const summary = readRunSummary(runId, this.home);
+                if (!active && !summary)
+                    return this.#json(res, 404, { error: `unknown run ${runId}` });
+                return this.#json(res, 200, {
+                    runId,
+                    status: active?.status ?? summary?.status ?? "unknown",
+                    goal: active?.goal ?? summary?.reason,
+                    result: active?.result ?? summary,
+                    ...(active?.error ? { error: active.error } : {}),
+                    pendingHelp: active?.human.pending() ?? [],
+                });
+            }
+            const eventsMatch = /^\/v1\/runs\/([^/]+)\/events$/.exec(path);
+            if (req.method === "GET" && eventsMatch) {
+                const runId = eventsMatch[1];
+                const since = Number(url.searchParams.get("since") ?? 0);
+                const events = readRunEvents(runId, this.home).filter((event) => event.seq > since);
+                if (url.searchParams.get("stream") === "1") {
+                    return this.#stream(res, runId, since);
+                }
+                return this.#json(res, 200, { events, lastSeq: events[events.length - 1]?.seq ?? since });
+            }
+            const cancelMatch = /^\/v1\/runs\/([^/]+)\/cancel$/.exec(path);
+            if (req.method === "POST" && cancelMatch) {
+                const run = this.#runs.get(cancelMatch[1]);
+                if (!run)
+                    return this.#json(res, 404, { error: "unknown or finished run" });
+                run.agent.stop("cancelled via daemon API");
+                return this.#json(res, 200, { ok: true });
+            }
+            const helpMatch = /^\/v1\/runs\/([^/]+)\/help\/([^/]+)$/.exec(path);
+            if (req.method === "POST" && helpMatch) {
+                const run = this.#runs.get(helpMatch[1]);
+                if (!run)
+                    return this.#json(res, 404, { error: "unknown run" });
+                const body = await readJson(req);
+                const parsed = helpResolutionSchema.safeParse(body);
+                if (!parsed.success)
+                    return this.#json(res, 400, { error: formatZodError(parsed.error, "help resolution") });
+                const resolution = parsed.data.resolution === "takeover" ? "takeover" : parsed.data.resolution;
+                const ok = run.human.resolve(helpMatch[2], resolution);
+                return this.#json(res, ok ? 200 : 404, { ok });
+            }
+            const approvalMatch = /^\/v1\/runs\/([^/]+)\/approvals\/([^/]+)$/.exec(path);
+            if (req.method === "POST" && approvalMatch) {
+                const run = this.#runs.get(approvalMatch[1]);
+                if (!run)
+                    return this.#json(res, 404, { error: "unknown run" });
+                const body = await readJson(req);
+                const parsed = approvalResolutionSchema.safeParse(body);
+                if (!parsed.success)
+                    return this.#json(res, 400, { error: formatZodError(parsed.error, "approval resolution") });
+                const ok = run.approvals.resolve(approvalMatch[2], parsed.data.resolution);
+                return this.#json(res, ok ? 200 : 404, { ok });
+            }
+            const artifactsMatch = /^\/v1\/runs\/([^/]+)\/artifacts$/.exec(path);
+            if (req.method === "GET" && artifactsMatch) {
+                const summary = readRunSummary(artifactsMatch[1], this.home);
+                return this.#json(res, 200, { artifacts: summary?.artifacts ?? [] });
+            }
+            if (req.method === "POST" && path === "/v1/shutdown") {
+                this.#json(res, 200, { ok: true });
+                setTimeout(() => {
+                    void this.stop().then(() => process.exit(0));
+                }, 50);
+                return;
+            }
+            return this.#json(res, 404, { error: `no route for ${req.method} ${path}` });
+        }
+        catch (error) {
+            return this.#json(res, 500, {
+                error: "internal error",
+                detail: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    #authorized(req) {
+        const header = req.headers["authorization"];
+        if (typeof header !== "string")
+            return false;
+        const token = header.replace(/^Bearer\s+/i, "").trim();
+        return token.length > 0 && token === this.#token;
+    }
+    #json(res, status, payload) {
+        const body = JSON.stringify(payload);
+        res.writeHead(status, { "content-type": "application/json", "content-length": Buffer.byteLength(body) });
+        res.end(body);
+    }
+    /* ─────────────────────────────── runs ─────────────────────────────────── */
+    async #createRun(request) {
+        const human = new RemoteHumanHelpHost();
+        const approvals = new RemoteApprovalBroker();
+        const agent = new BrowserAgent({
+            decision: request.providers?.decision ?? "typesafe",
+            humanHelp: human,
+            approvals,
+            screenshot: request.screenshot ?? "on-failure",
+            home: this.home,
+            // The run's real id arrives with its first event; re-key the registry then.
+            onEvent: (event) => {
+                if (run.runId === placeholder && event.runId && event.runId !== placeholder) {
+                    run.runId = event.runId;
+                    this.#runs.delete(placeholder);
+                    this.#runs.set(event.runId, run);
+                }
+                for (const subscriber of run.subscribers)
+                    subscriber(event);
+            },
+        });
+        // A placeholder id is replaced once the run starts; the daemon maps by it.
+        const placeholder = `pending-${Date.now()}-${Math.random().toString(16).slice(2, 8)}`;
+        const run = {
+            runId: placeholder,
+            goal: request.goal,
+            startedAt: Date.now(),
+            agent,
+            human,
+            approvals,
+            status: "running",
+            subscribers: new Set(),
+        };
+        this.#runs.set(placeholder, run);
+        void agent
+            .run(request)
+            .then((result) => {
+            run.status =
+                result.status === "completed" ? "completed" : result.status === "cancelled" ? "cancelled" : "failed";
+            run.result = result;
+            if (this.#runs.get(run.runId) === undefined)
+                this.#runs.set(run.runId, run);
+            this.#runs.delete(placeholder);
+        })
+            .catch((error) => {
+            run.status = "failed";
+            run.error = error instanceof Error ? error.message : String(error);
+            this.#runs.delete(placeholder);
+        });
+        // Give the run a moment to obtain its real id (the first event carries it).
+        for (let i = 0; i < 120; i += 1) {
+            if (run.runId !== placeholder)
+                break;
+            await new Promise((resolve) => setTimeout(resolve, 50));
+        }
+        return { runId: run.runId, status: run.status };
+    }
+    #listRuns() {
+        return [...this.#runs.values()].map((run) => ({
+            runId: run.runId,
+            goal: run.goal,
+            status: run.status,
+            startedAt: run.startedAt,
+            ...(run.result ? { steps: run.result.steps } : {}),
+        }));
+    }
+    #stream(res, runId, since) {
+        res.writeHead(200, {
+            "content-type": "text/event-stream",
+            "cache-control": "no-cache",
+            connection: "keep-alive",
+        });
+        let lastSeq = since;
+        const timer = setInterval(() => {
+            const events = readRunEvents(runId, this.home).filter((event) => event.seq > lastSeq);
+            for (const event of events) {
+                lastSeq = event.seq;
+                res.write(`id: ${event.seq}\ndata: ${JSON.stringify(event)}\n\n`);
+            }
+            const active = this.#runs.get(runId);
+            if (!active && events.length === 0 && !readRunSummary(runId, this.home)) {
+                res.write(`event: end\ndata: {}\n\n`);
+                clearInterval(timer);
+                res.end();
+            }
+        }, 500);
+        timer.unref?.();
+        res.on("close", () => clearInterval(timer));
+    }
+}
+const readJson = async (req) => {
+    const chunks = [];
+    for await (const chunk of req)
+        chunks.push(chunk);
+    if (chunks.length === 0)
+        return {};
+    try {
+        return JSON.parse(Buffer.concat(chunks).toString("utf8"));
+    }
+    catch {
+        throw new Error("request body is not valid JSON");
+    }
+};
+const ensureTokenPath = (home) => {
+    const state = readDaemonState(home);
+    return state?.tokenPath ?? `${home}/daemon/token`;
+};
+export const createDaemon = (options = {}) => new BrowserDaemon(options);
+export const ensureDaemonDirs = (home = resolveHome()) => {
+    mkdirSync(`${home}/daemon`, { recursive: true });
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/state.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Daemon state and lifecycle helpers (PRD §59).
+ *
+ * The daemon is a local process that owns sessions, runs, events, approvals and
+ * artifacts so the browser keeps working after a CLI command exits.
+ */
+export declare const DEFAULT_DAEMON_PORT = 7717;
+export interface DaemonState {
+    pid: number;
+    port: number;
+    url: string;
+    startedAt: number;
+    tokenPath: string;
+    version: string;
+}
+export declare const daemonStatePath: (home?: string) => string;
+export declare const readDaemonState: (home?: string) => DaemonState | undefined;
+export declare const writeDaemonState: (state: DaemonState, home?: string) => void;
+export declare const clearDaemonState: (home?: string) => void;
+export declare const ensureToken: (home?: string) => string;
+export declare const readToken: (home?: string) => string | undefined;
+export declare const isProcessAlive: (pid: number) => boolean;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,eAAe,GAAI,aAAoB,KAAG,MAAqC,CAAC;AAE7F,eAAO,MAAM,eAAe,GAAI,aAAoB,KAAG,WAAW,GAAG,SAUpE,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,OAAO,WAAW,EAAE,aAAoB,KAAG,IAK3E,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,aAAoB,KAAG,IASvD,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,aAAoB,KAAG,MAYlD,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,aAAoB,KAAG,MAAM,GAAG,SAQzD,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,OAO5C,CAAC"}

package/dist/state.js

@@ -0,0 +1,77 @@
+/**
+ * Daemon state and lifecycle helpers (PRD §59).
+ *
+ * The daemon is a local process that owns sessions, runs, events, approvals and
+ * artifacts so the browser keeps working after a CLI command exits.
+ */
+import { existsSync, readFileSync, writeFileSync, rmSync, mkdirSync, chmodSync } from "node:fs";
+import { randomBytes } from "node:crypto";
+import { daemonPaths, resolveHome } from "@mlola/browser-trace";
+export const DEFAULT_DAEMON_PORT = 7717;
+export const daemonStatePath = (home = resolveHome()) => daemonPaths(home).statePath;
+export const readDaemonState = (home = resolveHome()) => {
+    const path = daemonStatePath(home);
+    if (!existsSync(path))
+        return undefined;
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        if (typeof parsed.pid !== "number" || typeof parsed.port !== "number")
+            return undefined;
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+};
+export const writeDaemonState = (state, home = resolveHome()) => {
+    const paths = daemonPaths(home);
+    mkdirSync(paths.dir, { recursive: true });
+    writeFileSync(paths.statePath, `${JSON.stringify(state, null, 2)}\n`);
+    writeFileSync(paths.pidPath, String(state.pid));
+};
+export const clearDaemonState = (home = resolveHome()) => {
+    const paths = daemonPaths(home);
+    for (const path of [paths.statePath, paths.pidPath]) {
+        try {
+            rmSync(path, { force: true });
+        }
+        catch {
+            /* best effort */
+        }
+    }
+};
+export const ensureToken = (home = resolveHome()) => {
+    const paths = daemonPaths(home);
+    mkdirSync(paths.dir, { recursive: true });
+    if (!existsSync(paths.tokenPath)) {
+        writeFileSync(paths.tokenPath, randomBytes(24).toString("hex"));
+        try {
+            chmodSync(paths.tokenPath, 0o600);
+        }
+        catch {
+            /* platform dependent */
+        }
+    }
+    return readFileSync(paths.tokenPath, "utf8").trim();
+};
+export const readToken = (home = resolveHome()) => {
+    const paths = daemonPaths(home);
+    if (!existsSync(paths.tokenPath))
+        return undefined;
+    try {
+        return readFileSync(paths.tokenPath, "utf8").trim();
+    }
+    catch {
+        return undefined;
+    }
+};
+export const isProcessAlive = (pid) => {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@mlola/browser-daemon",
+  "version": "0.1.0",
+  "description": "mlola-browserd: local daemon owning sessions, runs, events, takeover and artifacts.",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "mlola-browserd": "./dist/bin.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "development": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mlolahq/browser-runtime.git"
+  },
+  "homepage": "https://mlola.com/browser-runtime",
+  "bugs": {
+    "url": "https://github.com/mlolahq/browser-runtime.git/issues"
+  },
+  "keywords": [
+    "browser-automation",
+    "browser-agent",
+    "runtime",
+    "playwright",
+    "agent",
+    "jev",
+    "llm",
+    "automation"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@mlola/browser-protocol": "0.1.0",
+    "@mlola/browser-core": "0.1.0",
+    "@mlola/browser-runtime": "0.1.0",
+    "@mlola/browser-trace": "0.1.0"
+  }
+}