@skillcap/gdh 0.18.1 → 0.19.0

package/node_modules/@gdh/runtime/dist/index.js

@@ -5,11 +5,12 @@ import net from "node:net";
 import os from "node:os";
 import path from "node:path";
 import { promisify } from "node:util";
+import { definePackageBoundary, detectFatalGodotStderr, GDH_RECIPE_SCHEMA_VERSION, GDH_RUNTIME_RECIPE_RUN_VERSION, presentPublicRuntimeTerms, resolveConfiguredGodotEditorBin, } from "@gdh/core";
 import WebSocket, {} from "ws";
-import { GDH_RECIPE_SCHEMA_VERSION, GDH_RUNTIME_RECIPE_RUN_VERSION, detectFatalGodotStderr, definePackageBoundary, presentPublicRuntimeTerms, resolveConfiguredGodotEditorBin, } from "@gdh/core";
 import { parse } from "yaml";
 import { inspectRuntimeBridgeSurface } from "./bridge-surface.js";
 import { buildDockerRuntimeLaunchPreview, ensureDockerRuntimeImagePlan, inspectDockerRuntimeProvider, toDockerContainerPath, } from "./docker-provider.js";
+export { BROKER_DEFAULT_HEARTBEAT_STALE_AFTER_MS, BROKER_LOOPBACK_HOST, BROKER_PROTOCOL_VERSION, normalizeBrokerTargetIdentity, validateBrokerHandshake, } from "./bridge-broker-contract.js";
 export { inspectRuntimeBridgeSurface, installRuntimeBridgeSurface, removeRuntimeBridgeSurface, repairRuntimeBridgeSurface, resolveRuntimeBridgeConfig, } from "./bridge-surface.js";
 export { inspectRuntimeKnowledgeSurface } from "./knowledge-surface.js";
 export const runtimePackage = definePackageBoundary({
@@ -199,9 +200,7 @@ export async function runRuntimeRecipe(input) {
                     : execution.errorMessage !== null
                         ? `Runtime recipe "${input.recipeId}" failed before the process exited: ${execution.errorMessage}.`
                         : `Runtime recipe "${input.recipeId}" exited with code ${execution.exitCode}.`),
-            reasons: execution.errorMessage !== null
-                ? ["launch_process_error"]
-                : execution.reasons,
+            reasons: execution.errorMessage !== null ? ["launch_process_error"] : execution.reasons,
             recipe: executionCheck.recipe,
             check: executionCheck,
             session,
@@ -530,9 +529,7 @@ function resolveRuntimeValues(recipe, input) {
     }
     const featureEnv = new Map();
     for (const featureFlag of featureFlags) {
-        if (featureFlag.enabled &&
-            featureFlag.envVarName !== null &&
-            featureFlag.envValue !== null) {
+        if (featureFlag.enabled && featureFlag.envVarName !== null && featureFlag.envValue !== null) {
             featureEnv.set(featureFlag.envVarName, featureFlag.envValue);
         }
     }
@@ -753,9 +750,7 @@ async function resolvePrechecks(input) {
         }
         const envValue = definition.envVarName === null
             ? null
-            : environmentMap.get(definition.envVarName) ??
-                process.env[definition.envVarName] ??
-                null;
+            : (environmentMap.get(definition.envVarName) ?? process.env[definition.envVarName] ?? null);
         results.push({
             ...definition,
             status: envValue === null ? "failed" : "passed",
@@ -776,9 +771,7 @@ async function buildLaunchPreview(input) {
         }
     }
     for (const featureFlag of input.values.featureFlags) {
-        if (featureFlag.enabled &&
-            featureFlag.envVarName !== null &&
-            featureFlag.envValue !== null) {
+        if (featureFlag.enabled && featureFlag.envVarName !== null && featureFlag.envValue !== null) {
             environmentMap.set(featureFlag.envVarName, featureFlag.envValue);
         }
     }
@@ -825,7 +818,7 @@ async function buildLaunchPreview(input) {
         return buildDockerRuntimeLaunchPreview({
             evaluationRootPath: input.evaluationRootPath,
             containerWorkingDirectory: toDockerContainerPath(input.evaluationRootPath, path.join(input.evaluationRootPath, input.recipe.launch.kind === "project_launch_adapter"
-                ? input.recipe.launch.workingDirectory ?? input.recipe.projectPath
+                ? (input.recipe.launch.workingDirectory ?? input.recipe.projectPath)
                 : input.recipe.projectPath)),
             command: dockerCommand,
             environment: environmentEntries,
@@ -863,12 +856,7 @@ async function buildLaunchPreview(input) {
     }
     const scriptPath = path.join(input.evaluationRootPath, input.recipe.launch.scriptPath);
     const command = input.recipe.launch.interpreter === null
-        ? [
-            scriptPath,
-            ...input.recipe.launch.arguments,
-            ...parameterArguments,
-            ...featureArguments,
-        ]
+        ? [scriptPath, ...input.recipe.launch.arguments, ...parameterArguments, ...featureArguments]
         : [
             input.recipe.launch.interpreter,
             scriptPath,
@@ -909,9 +897,7 @@ async function prepareDockerGodotProjectLaunch(input) {
     const sanitizedProjectGodot = projectGodotContent === null
         ? null
         : sanitizeProjectGodotAutoloadUids(projectGodotContent, uidLookup);
-    const sanitizedExtensionList = extensionListContent === null
-        ? null
-        : sanitizeDockerExtensionList(extensionListContent);
+    const sanitizedExtensionList = extensionListContent === null ? null : sanitizeDockerExtensionList(extensionListContent);
     const needsProjectGodotOverlay = projectGodotContent !== null && sanitizedProjectGodot !== projectGodotContent;
     const needsExtensionListOverlay = extensionListContent !== null && sanitizedExtensionList !== extensionListContent;
     if (!needsProjectGodotOverlay && !needsExtensionListOverlay) {
@@ -1001,9 +987,7 @@ function sanitizeProjectGodotAutoloadUids(content, uidLookup) {
     return `${nextLines.join("\n").replace(/\n+$/, "\n")}`;
 }
 function sanitizeDockerExtensionList(content) {
-    const nextLines = content
-        .split(/\r?\n/)
-        .filter((line) => !line.startsWith("res://temp/"));
+    const nextLines = content.split(/\r?\n/).filter((line) => !line.startsWith("res://temp/"));
     return `${nextLines.join("\n").replace(/\n+$/, "\n")}`;
 }
 function findProjectSettingSection(lines, name) {
@@ -1124,9 +1108,7 @@ function isDockerLaunchPreview(preview) {
 }
 function attachDockerScreenshotCapture(preview, artifactDirectory) {
     const prepareHint = (preview.prepareHints ?? []).find((hint) => hint.kind === "docker_runtime_image") ?? null;
-    if (prepareHint === null ||
-        preview.command === null ||
-        preview.command[0] !== "docker") {
+    if (prepareHint === null || preview.command === null || preview.command[0] !== "docker") {
         return preview;
     }
     const imageIndex = preview.command.lastIndexOf(prepareHint.imageTag);
@@ -1208,20 +1190,14 @@ async function ensureExplicitScreenshotCaptureDirectories(capture) {
 }
 function attachDockerExplicitScreenshotCapture(preview, capture) {
     const prepareHint = (preview.prepareHints ?? []).find((hint) => hint.kind === "docker_runtime_image") ?? null;
-    if (prepareHint === null ||
-        preview.command === null ||
-        preview.command[0] !== "docker") {
+    if (prepareHint === null || preview.command === null || preview.command[0] !== "docker") {
         return preview;
     }
     const imageIndex = preview.command.lastIndexOf(prepareHint.imageTag);
     if (imageIndex <= 0) {
         return preview;
     }
-    const beforeImage = stripDockerEnvArguments(preview.command.slice(1, imageIndex), new Set([
-        ENV_SCREENSHOT_CAPTURE,
-        ENV_SCREENSHOT_PATH,
-        ENV_SCREENSHOT_METADATA_PATH,
-    ]));
+    const beforeImage = stripDockerEnvArguments(preview.command.slice(1, imageIndex), new Set([ENV_SCREENSHOT_CAPTURE, ENV_SCREENSHOT_PATH, ENV_SCREENSHOT_METADATA_PATH]));
     const afterImage = preview.command.slice(imageIndex);
     const mountMappings = new Map();
     const mapHostFileToContainer = (hostFilePath) => {
@@ -1264,7 +1240,7 @@ function stripDockerEnvArguments(dockerArgs, environmentNames) {
             continue;
         }
         const next = dockerArgs[index + 1];
-        const environmentName = typeof next === "string" ? next.split("=")[0] ?? "" : "";
+        const environmentName = typeof next === "string" ? (next.split("=")[0] ?? "") : "";
         if (next !== undefined && environmentNames.has(environmentName)) {
             index += 1;
             continue;
@@ -1306,9 +1282,7 @@ async function finalizeRuntimeScreenshotCapture(provisional) {
             reason: "screenshot_metadata_invalid",
         };
     }
-    const state = parsed?.state === "captured" ||
-        parsed?.state === "unavailable" ||
-        parsed?.state === "failed"
+    const state = parsed?.state === "captured" || parsed?.state === "unavailable" || parsed?.state === "failed"
         ? parsed.state
         : "failed";
     const reason = typeof parsed?.reason === "string" ? parsed.reason : null;
@@ -1320,8 +1294,7 @@ async function finalizeRuntimeScreenshotCapture(provisional) {
                 ? "Rendered screenshot capture was unavailable for this run."
                 : "Rendered screenshot capture failed.";
     if (state === "captured") {
-        const imagePresent = provisional.imagePath !== null &&
-            (await pathExists(provisional.imagePath));
+        const imagePresent = provisional.imagePath !== null && (await pathExists(provisional.imagePath));
         if (!imagePresent) {
             return {
                 ...provisional,
@@ -1586,7 +1559,9 @@ export function createRuntimeBridgeManager() {
     return {
         async startSession(input) {
             const liveCheck = await checkRuntimeRecipe(input);
-            if (liveCheck.state !== "runnable" || liveCheck.recipe === null || liveCheck.launchPreview === null) {
+            if (liveCheck.state !== "runnable" ||
+                liveCheck.recipe === null ||
+                liveCheck.launchPreview === null) {
                 return {
                     targetPath: input.targetPath,
                     recipeId: input.recipeId,
@@ -1609,10 +1584,7 @@ export function createRuntimeBridgeManager() {
                         recipeId: input.recipeId,
                         state: "blocked",
                         summary: "Runtime bridge session start is blocked until the project-side GDH bridge is installed and healthy for direct Godot launches.",
-                        reasons: [
-                            "runtime_bridge_surface_not_ready",
-                            ...bridgeStatus.reasons,
-                        ],
+                        reasons: ["runtime_bridge_surface_not_ready", ...bridgeStatus.reasons],
                         bridge: bridgeMissing(bridgeStatus.summary),
                         launchCommand: liveCheck.launchPreview.command,
                         session: null,
@@ -1970,10 +1942,7 @@ async function stopBridgeSessionHandle(session) {
     }
     if (session.exitCode.value === null) {
         session.child.kill("SIGTERM");
-        const exited = await Promise.race([
-            session.exitPromise,
-            waitMs(2000).then(() => null),
-        ]);
+        const exited = await Promise.race([session.exitPromise, waitMs(2000).then(() => null)]);
         if (exited === null) {
             session.child.kill("SIGKILL");
             await session.exitPromise;
@@ -2144,7 +2113,7 @@ async function invokeInputSequenceRunEntry(session, inputValue) {
             }
             continue;
         }
-        if (Object.prototype.hasOwnProperty.call(step, "delayMs")) {
+        if (Object.hasOwn(step, "delayMs")) {
             const delayMs = clampNumber(step["delayMs"], 1, 1, 5000);
             recordBridgeEvent(session, "sequence_step_started", {
                 index,
@@ -2262,7 +2231,7 @@ async function invokeNodePropertyAwaitEntry(session, inputValue) {
     const input = toJsonRecord(inputValue);
     const nodePath = typeof input["nodePath"] === "string" ? input["nodePath"] : "";
     const property = typeof input["property"] === "string" ? input["property"] : "";
-    const hasExpected = Object.prototype.hasOwnProperty.call(input, "expected");
+    const hasExpected = Object.hasOwn(input, "expected");
     const expected = hasExpected ? input["expected"] : null;
     const timeoutMs = clampNumber(input["timeoutMs"], 1500, 100, 5000);
     const pollIntervalMs = clampNumber(input["pollIntervalMs"], 50, 25, 250);
@@ -2800,8 +2769,7 @@ async function connectBridgeSocket(input) {
             await waitMs(100);
         }
     }
-    throw new Error(lastError?.message ??
-        "Timed out waiting for the runtime bridge WebSocket handshake.");
+    throw new Error(lastError?.message ?? "Timed out waiting for the runtime bridge WebSocket handshake.");
 }
 async function attemptBridgeSocketConnection(input) {
     return new Promise((resolve, reject) => {
@@ -2827,8 +2795,7 @@ async function attemptBridgeSocketConnection(input) {
                 if (parsed.kind === "hello_ok") {
                     clearTimeout(timeout);
                     socket.removeAllListeners("message");
-                    socket.gdhEntries =
-                        parsed.entries ?? [];
+                    socket.gdhEntries = parsed.entries ?? [];
                     resolve(socket);
                     return;
                 }
@@ -2857,7 +2824,8 @@ async function listBridgeEntriesFromSocket(socket, sessionId) {
         request_id: `${sessionId}-list-${randomBytes(8).toString("hex")}`,
     });
     const entries = response.result ?? [];
-    socket.gdhEntries = entries;
+    socket.gdhEntries =
+        entries;
     return entries;
 }
 async function invokeBridgeEntryOverSocket(socket, sessionId, entryId, input) {
@@ -3032,9 +3000,7 @@ function readStringArray(value, fallback = []) {
     if (!Array.isArray(value)) {
         return fallback;
     }
-    return value
-        .filter((entry) => typeof entry === "string")
-        .map((entry) => entry);
+    return value.filter((entry) => typeof entry === "string").map((entry) => entry);
 }
 function readObjectArray(value) {
     if (!Array.isArray(value)) {