@godot-mcp/control-plane 0.0.0 → 0.1.0

package/dist/runtime/runtimeProcess.js

@@ -0,0 +1,180 @@
+import { spawn } from "node:child_process";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { GodotMcpException } from "../errors.js";
+const execFileAsync = promisify(execFile);
+const ENVIRONMENT_ALLOWLIST = ["HOME", "LANG", "LC_ALL", "LC_CTYPE", "PATH", "TMPDIR", "XDG_RUNTIME_DIR"];
+export function godotRuntimeArguments(input) {
+    return [
+        "--path",
+        input.projectRoot,
+        ...(input.pins ? [
+            "--resolution", `${input.pins.width}x${input.pins.height}`,
+            "--rendering-method", input.pins.renderer,
+            "--language", input.pins.locale,
+            "--fixed-fps", String(input.pins.fixedFps),
+        ] : []),
+        "--scene",
+        "res://addons/godot_mcp/runtime/runtime_harness.tscn",
+        "--remote-debug",
+        `tcp://127.0.0.1:${input.debugPort}`,
+        "--",
+        `--godot-mcp-runtime-descriptor=${input.descriptorPath}`,
+    ];
+}
+export function scrubRuntimeEnvironment(environment) {
+    return Object.fromEntries(ENVIRONMENT_ALLOWLIST.flatMap((name) => {
+        const value = environment[name];
+        return value === undefined ? [] : [[name, value]];
+    }));
+}
+export function lsofShowsLoopbackListener(output, pid, port) {
+    const lines = output.split(/\r?\n/);
+    const ownsProcess = lines.includes(`p${pid}`);
+    const endpoints = [`n127.0.0.1:${port}`, `n[::1]:${port}`, `nlocalhost:${port}`];
+    return ownsProcess && endpoints.some((endpoint) => lines.includes(endpoint));
+}
+export function listenerPortsAreDistinct(ports) {
+    return ports.length === new Set(ports).size;
+}
+export async function assertLoopbackListenerOwnedByProcess(pid, port) {
+    let output = "";
+    try {
+        const result = await execFileAsync(process.platform === "darwin" ? "/usr/sbin/lsof" : "lsof", [
+            "-nP", "-a", "-p", String(pid), `-iTCP:${port}`, "-sTCP:LISTEN", "-Fpn",
+        ]);
+        output = result.stdout;
+    }
+    catch {
+        // lsof exits nonzero when the requested process does not own that listener.
+    }
+    if (lsofShowsLoopbackListener(output, pid, port))
+        return;
+    throw new GodotMcpException({
+        code: "CONFLICT",
+        message: "The configured Godot debugger port is not the editor's loopback listener; relaunch the editor with an explicit available debug-server port",
+        retryable: false,
+        correlationId: `${pid}:${port}`,
+        partialEffects: false,
+        rollback: "not_needed",
+    });
+}
+export async function assertLoopbackListenersOwnedByProcess(pid, ports, verify = assertLoopbackListenerOwnedByProcess) {
+    for (const port of new Set(ports))
+        await verify(pid, port);
+}
+async function processFingerprint(pid) {
+    const { stdout } = await execFileAsync("ps", ["-o", "lstart=", "-p", String(pid)]);
+    const started = stdout.trim();
+    if (!started)
+        throw new Error("Owned process start time is unavailable");
+    return `${pid}:${started}`;
+}
+export function childHasExited(child) {
+    return child.exitCode !== null || child.signalCode !== null;
+}
+export function shouldRefuseProcessSignal(child, currentFingerprint, ownedFingerprint) {
+    return currentFingerprint !== ownedFingerprint && !childHasExited(child);
+}
+function waitForExit(child) {
+    if (childHasExited(child))
+        return Promise.resolve(child.exitCode ?? 1);
+    return new Promise((resolve, reject) => {
+        child.once("error", reject);
+        child.once("close", (code) => resolve(code ?? 1));
+    });
+}
+export class OwnedGodotProcess {
+    child;
+    pid;
+    fingerprint;
+    stopPromise;
+    output = "";
+    constructor(child, pid, fingerprint) {
+        this.child = child;
+        this.pid = pid;
+        this.fingerprint = fingerprint;
+    }
+    static async launch(input) {
+        const child = spawn(input.godotBin, godotRuntimeArguments(input), {
+            env: scrubRuntimeEnvironment(input.environment ?? process.env),
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        await new Promise((resolve, reject) => {
+            child.once("spawn", resolve);
+            child.once("error", reject);
+        });
+        const pid = child.pid;
+        if (!pid)
+            throw new Error("Godot runtime did not report a PID");
+        let fingerprint;
+        try {
+            fingerprint = await processFingerprint(pid);
+        }
+        catch (error) {
+            if (!childHasExited(child))
+                child.kill("SIGKILL");
+            await waitForExit(child).catch(() => undefined);
+            throw error;
+        }
+        const owned = new OwnedGodotProcess(child, pid, fingerprint);
+        const append = (chunk) => {
+            owned.output = `${owned.output}${chunk.toString()}`.slice(-64 * 1024);
+        };
+        child.stdout?.on("data", append);
+        child.stderr?.on("data", append);
+        child.once("exit", (code, signal) => {
+            append(`\n[godot runtime exited: ${signal ?? `code ${code ?? "unknown"}`}]\n`);
+        });
+        return owned;
+    }
+    diagnostics() {
+        return this.output;
+    }
+    wait() {
+        return waitForExit(this.child);
+    }
+    stop(graceMs = 2_000) {
+        if (!this.stopPromise) {
+            const activeStop = (async () => {
+                if (childHasExited(this.child))
+                    return;
+                const current = await processFingerprint(this.pid).catch(() => "");
+                if (shouldRefuseProcessSignal(this.child, current, this.fingerprint)) {
+                    throw new GodotMcpException({
+                        code: "CONFLICT",
+                        message: "Owned runtime process fingerprint changed; refusing to signal",
+                        retryable: false,
+                        correlationId: this.fingerprint,
+                        partialEffects: false,
+                        rollback: "not_attempted",
+                    });
+                }
+                if (childHasExited(this.child))
+                    return;
+                this.child.kill("SIGTERM");
+                const stopped = await Promise.race([
+                    waitForExit(this.child).then(() => true),
+                    new Promise((resolve) => setTimeout(() => resolve(false), graceMs)),
+                ]);
+                if (!stopped && !childHasExited(this.child)) {
+                    const beforeKill = await processFingerprint(this.pid).catch(() => "");
+                    if (shouldRefuseProcessSignal(this.child, beforeKill, this.fingerprint)) {
+                        throw new Error("Owned runtime fingerprint changed before escalation");
+                    }
+                    if (childHasExited(this.child))
+                        return;
+                    this.child.kill("SIGKILL");
+                    await waitForExit(this.child);
+                }
+            })();
+            this.stopPromise = activeStop;
+            void activeStop.catch(() => {
+                if (this.stopPromise === activeStop)
+                    this.stopPromise = undefined;
+            });
+        }
+        return this.stopPromise;
+    }
+}
+//# sourceMappingURL=runtimeProcess.js.map

package/dist/runtime/runtimeProcess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeProcess.js","sourceRoot":"","sources":["../../src/runtime/runtimeProcess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAItC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC1C,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,CAAU,CAAC;AASnH,MAAM,UAAU,qBAAqB,CAAC,KAA4B;IAChE,OAAO;QACL,QAAQ;QACR,KAAK,CAAC,WAAW;QACjB,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACf,cAAc,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE;YAC1D,oBAAoB,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;YACzC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM;YAC/B,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;SAC3C,CAAC,CAAC,CAAC,EAAE,CAAC;QACP,SAAS;QACT,qDAAqD;QACrD,gBAAgB;QAChB,mBAAmB,KAAK,CAAC,SAAS,EAAE;QACpC,IAAI;QACJ,kCAAkC,KAAK,CAAC,cAAc,EAAE;KACzD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAA8B;IACpE,OAAO,MAAM,CAAC,WAAW,CACvB,qBAAqB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAc,EAAE,GAAW,EAAE,IAAY;IACjF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,CAAC,cAAc,IAAI,EAAE,EAAE,UAAU,IAAI,EAAE,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC;IACjF,OAAO,WAAW,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAwB;IAC/D,OAAO,KAAK,CAAC,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oCAAoC,CAAC,GAAW,EAAE,IAAY;IAClF,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,EAAE;YAC5F,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,IAAI,EAAE,EAAE,cAAc,EAAE,MAAM;SACxE,CAAC,CAAC;QACH,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,4EAA4E;IAC9E,CAAC;IACD,IAAI,yBAAyB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;QAAE,OAAO;IACzD,MAAM,IAAI,iBAAiB,CAAC;QAC1B,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,4IAA4I;QACrJ,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE;QAC/B,cAAc,EAAE,KAAK;QACrB,QAAQ,EAAE,YAAY;KACvB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qCAAqC,CACzD,GAAW,EACX,KAAwB,EACxB,SAAuD,oCAAoC;IAE3F,KAAK,MAAM,IAAI,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC;QAAE,MAAM,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,GAAW;IAC3C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACzE,OAAO,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAoD;IACjF,OAAO,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAoD,EACpD,kBAA0B,EAC1B,gBAAwB;IAExB,OAAO,kBAAkB,KAAK,gBAAgB,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,WAAW,CAAC,KAAmB;IACtC,IAAI,cAAc,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;IACvE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC;AAUD,MAAM,OAAO,iBAAiB;IAKT;IACR;IACA;IANH,WAAW,CAA4B;IACvC,MAAM,GAAG,EAAE,CAAC;IAEpB,YACmB,KAAmB,EAC3B,GAAW,EACX,WAAmB;QAFX,UAAK,GAAL,KAAK,CAAc;QAC3B,QAAG,GAAH,GAAG,CAAQ;QACX,gBAAW,GAAX,WAAW,CAAQ;IAC3B,CAAC;IAEJ,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAoF;QACtG,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,qBAAqB,CAAC,KAAK,CAAC,EAAE;YAChE,GAAG,EAAE,uBAAuB,CAAC,KAAK,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC;YAC9D,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAChE,IAAI,WAAmB,CAAC;QACxB,IAAI,CAAC;YACH,WAAW,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAClD,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAChD,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,CAAC,KAAsB,EAAQ,EAAE;YAC9C,KAAK,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACxE,CAAC,CAAC;QACF,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAClC,MAAM,CAAC,4BAA4B,MAAM,IAAI,QAAQ,IAAI,IAAI,SAAS,EAAE,KAAK,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;QACH,OAAO,KAAK,CAAC;IACf,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI;QACF,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,CAAC,OAAO,GAAG,KAAK;QAClB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG,CAAC,KAAK,IAAI,EAAE;gBAC7B,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;oBAAE,OAAO;gBACvC,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBACnE,IAAI,yBAAyB,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;oBACrE,MAAM,IAAI,iBAAiB,CAAC;wBAC1B,IAAI,EAAE,UAAU;wBAChB,OAAO,EAAE,+DAA+D;wBACxE,SAAS,EAAE,KAAK;wBAChB,aAAa,EAAE,IAAI,CAAC,WAAW;wBAC/B,cAAc,EAAE,KAAK;wBACrB,QAAQ,EAAE,eAAe;qBAC1B,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;oBAAE,OAAO;gBACvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC3B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;oBACjC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;oBACxC,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;iBAC7E,CAAC,CAAC;gBACH,IAAI,CAAC,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC5C,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;oBACtE,IAAI,yBAAyB,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;wBACxE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;oBACzE,CAAC;oBACD,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;wBAAE,OAAO;oBACvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBAC3B,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;YACL,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;YAC9B,KAAK,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE;gBACzB,IAAI,IAAI,CAAC,WAAW,KAAK,UAAU;oBAAE,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;YACpE,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF"}

package/dist/runtime/runtimeService.d.ts

@@ -0,0 +1,130 @@
+import type { InputOperationInput, InputOperationResult, ProjectIdentity, RuntimeCaptureFrameMetadata, RuntimeCaptureInput, RuntimeHandle, RuntimeLaunchPins, RuntimeOperationInput } from "@godot-mcp/protocol";
+import { type DebuggerCommand, type DebuggerStopEvent } from "./debuggerClient.js";
+import { type RuntimeDescriptorInput, type RuntimeDescriptorMaterial } from "./runtimeDescriptor.js";
+import { type OwnedRuntimeProcess } from "./runtimeProcess.js";
+export type RuntimeState = "idle" | "preparing" | "launching" | "authenticating" | "running" | "paused" | "stopping" | "stopped" | "failed";
+interface RuntimeProcessLaunchInput {
+    godotBin: string;
+    projectRoot: string;
+    debugPort: number;
+    descriptorPath: string;
+    pins?: RuntimeLaunchPins;
+}
+export interface RuntimeServiceDependencies {
+    project: ProjectIdentity;
+    sessionId(): string | null;
+    godotBin?: string;
+    requireAuthenticatedDebuggerMetadata?: boolean;
+    createDescriptor?(input: RuntimeDescriptorInput): Promise<RuntimeDescriptorMaterial>;
+    prepare(input: {
+        descriptor: RuntimeDescriptorMaterial["descriptor"];
+    }): Promise<{
+        debugPort: number;
+        editorPid?: number;
+        debugTransport?: string;
+    }>;
+    verifyDebuggerListener?(pid: number, port: number): Promise<void>;
+    verifyEditorListener?(pid: number, port: number): Promise<void>;
+    launchProcess?(input: RuntimeProcessLaunchInput): Promise<OwnedRuntimeProcess>;
+    command(operation: string, input: Record<string, unknown>, timeoutMs?: number): Promise<unknown>;
+    capture?(input: Record<string, unknown>, timeoutMs?: number): Promise<{
+        data: RuntimeCaptureFrameMetadata;
+        binary?: Uint8Array;
+        binarySha256?: string;
+    }>;
+    cleanup?(): Promise<void>;
+}
+export interface RuntimeDebuggerClient {
+    request(command: DebuggerCommand, argumentsValue: Record<string, unknown>, timeoutMs?: number): Promise<Record<string, unknown>>;
+    nextStop(afterSequence: number, timeoutMs: number): Promise<DebuggerStopEvent>;
+    snapshot(): {
+        connected: boolean;
+        stopped: boolean;
+        stopSequence: number;
+    };
+    markRunning(afterSequence?: number): void;
+    refresh?(): Promise<void>;
+    close(): Promise<void>;
+}
+export interface RuntimeSnapshot {
+    state: RuntimeState;
+    handle: RuntimeHandle | null;
+    scenePath: string | null;
+    process: {
+        pid: number;
+        fingerprint: string;
+    } | null;
+}
+type LaunchInput = Extract<RuntimeOperationInput, {
+    operation: "launch";
+}>;
+export declare class RuntimeService {
+    private readonly dependencies;
+    private state;
+    private generation;
+    private handle;
+    private scenePath;
+    private process;
+    private processStopped;
+    private descriptor;
+    private closePromise;
+    private disconnectPromise;
+    private launchPromise;
+    private cleanupPromise;
+    private debuggerCleaned;
+    private lifecycleEpoch;
+    private closed;
+    private operationTail;
+    private debuggerClient;
+    private debuggerGeneration;
+    private debuggerSessionId;
+    private readonly debugTokens;
+    private readonly breakpointSources;
+    private opaqueProfileId;
+    constructor(dependencies: RuntimeServiceDependencies);
+    snapshot(): RuntimeSnapshot;
+    launch(input: Omit<LaunchInput, "operation">): Promise<{
+        handle: RuntimeHandle;
+        root: unknown;
+    }>;
+    private launchGeneration;
+    execute(input: Exclude<RuntimeOperationInput, LaunchInput>): Promise<unknown>;
+    private executeExclusive;
+    private executePerformance;
+    private attachAuthenticatedDebugger;
+    private executeDebug;
+    private requireDebuggerClient;
+    private assertDebuggerBinding;
+    private bindDebugStop;
+    private stepDebugger;
+    private setDebugBreakpoints;
+    private debugStack;
+    private scopeReference;
+    private readVariables;
+    private formatVariable;
+    private resolveWatch;
+    private requestVariables;
+    private projectSourcePath;
+    capture(input: RuntimeCaptureInput): Promise<{
+        frames: Array<{
+            data: Uint8Array;
+            metadata: RuntimeCaptureFrameMetadata;
+        }>;
+    }>;
+    input(input: InputOperationInput): Promise<InputOperationResult>;
+    private inputExclusive;
+    private captureExclusive;
+    close(): Promise<void>;
+    disconnect(): Promise<void>;
+    private assertHandle;
+    private assertHandleIdentity;
+    private runExclusive;
+    private assertLaunchCurrent;
+    private stopProcess;
+    private cleanup;
+    private cleanupDebuggerClient;
+    private cleanupDebugger;
+    private onProcessExit;
+}
+export {};
+//# sourceMappingURL=runtimeService.d.ts.map

package/dist/runtime/runtimeService.d.ts.map

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