@h-rig/runtime 0.0.6-alpha.0

package/dist/src/control-plane/browser-contract.js

@@ -0,0 +1,135 @@
+// @bun
+// packages/runtime/src/control-plane/browser-contract.ts
+import { resolve } from "path";
+var DEFAULT_BROWSER_ATTACH_URL = "http://127.0.0.1:9333";
+var DEFAULT_BROWSER_MODE = "persistent";
+var RUNTIME_BROWSER_HELPERS = {
+  launch: "rig-browser-launch",
+  check: "rig-browser-check",
+  attachInfo: "rig-browser-attach-info",
+  e2e: "rig-browser-e2e",
+  resetProfile: "rig-browser-reset-profile"
+};
+var BASE_REMOTE_DEBUGGING_PORT = 9222;
+var REMOTE_DEBUGGING_PORT_SPREAD = 4000;
+function browserEnvFromContext(browser) {
+  if (!browser?.required) {
+    return {};
+  }
+  const env = {
+    RIG_BROWSER_REQUIRED: "1",
+    RIG_BROWSER_PRESET: browser.preset,
+    RIG_BROWSER_MODE: browser.mode,
+    RIG_BROWSER_STATE_DIR: browser.stateDir,
+    RIG_BROWSER_PROFILE: browser.effectiveProfile,
+    RIG_BROWSER_BASE_PROFILE: browser.defaultProfile,
+    RIG_BROWSER_ATTACH_URL: browser.effectiveAttachUrl,
+    RIG_BROWSER_DEFAULT_ATTACH_URL: browser.defaultAttachUrl,
+    RIG_BROWSER_LAUNCH_HELPER: browser.launchHelper,
+    RIG_BROWSER_CHECK_HELPER: browser.checkHelper,
+    RIG_BROWSER_ATTACH_INFO_HELPER: browser.attachInfoHelper,
+    RIG_BROWSER_E2E_HELPER: browser.e2eHelper,
+    RIG_BROWSER_RESET_HELPER: browser.resetProfileHelper
+  };
+  if (browser.devCommand) {
+    env.RIG_BROWSER_DEV_COMMAND = browser.devCommand;
+  }
+  if (browser.launchCommand) {
+    env.RIG_BROWSER_LAUNCH_COMMAND = browser.launchCommand;
+  }
+  if (browser.checkCommand) {
+    env.RIG_BROWSER_CHECK_COMMAND = browser.checkCommand;
+  }
+  if (browser.e2eCommand) {
+    env.RIG_BROWSER_E2E_COMMAND = browser.e2eCommand;
+  }
+  return env;
+}
+function hashString(input) {
+  let hash = 0;
+  for (let index = 0;index < input.length; index += 1) {
+    hash = (hash << 5) - hash + input.charCodeAt(index) | 0;
+  }
+  return Math.abs(hash);
+}
+function derivePortFromProfile(profileName) {
+  return BASE_REMOTE_DEBUGGING_PORT + hashString(profileName) % REMOTE_DEBUGGING_PORT_SPREAD;
+}
+function parseAttachUrl(attachUrl) {
+  try {
+    return new URL((attachUrl || DEFAULT_BROWSER_ATTACH_URL).trim() || DEFAULT_BROWSER_ATTACH_URL);
+  } catch {
+    return new URL(DEFAULT_BROWSER_ATTACH_URL);
+  }
+}
+function sanitizeRuntimeSuffix(runtimeId) {
+  return runtimeId.replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 16) || "runtime";
+}
+function resolveBrowserStateDir(projectRoot, configuredStateDir) {
+  const trimmed = configuredStateDir?.trim() || ".tmp/rig-browser";
+  if (trimmed.startsWith("/")) {
+    return resolve(trimmed);
+  }
+  return resolve(projectRoot || process.cwd(), trimmed);
+}
+function resolveTaskBrowserContext(browser, options = {}) {
+  if (!browser?.required) {
+    return;
+  }
+  const defaultProfile = browser.profile?.trim() || "default";
+  const mode = browser.mode?.trim() || DEFAULT_BROWSER_MODE;
+  const defaultAttach = parseAttachUrl(browser.attach_url);
+  const shouldDeriveRuntimeProfile = Boolean(options.runtimeId?.trim()) && mode !== "shared";
+  const effectiveProfile = shouldDeriveRuntimeProfile ? `${defaultProfile}-${sanitizeRuntimeSuffix(options.runtimeId.trim())}` : defaultProfile;
+  const effectivePort = shouldDeriveRuntimeProfile ? derivePortFromProfile(effectiveProfile) : Number(defaultAttach.port || "80");
+  const effectiveAttach = new URL(defaultAttach.toString());
+  effectiveAttach.port = String(effectivePort);
+  return {
+    required: true,
+    preset: browser.preset?.trim() || "default",
+    mode,
+    stateDir: resolveBrowserStateDir(options.hostProjectRoot, browser.state_dir),
+    defaultProfile,
+    effectiveProfile,
+    defaultAttachUrl: defaultAttach.toString(),
+    effectiveAttachUrl: effectiveAttach.toString(),
+    devCommand: browser.dev_command?.trim() || undefined,
+    launchCommand: browser.launch_command?.trim() || undefined,
+    checkCommand: browser.check_command?.trim() || undefined,
+    e2eCommand: browser.e2e_command?.trim() || undefined,
+    launchHelper: RUNTIME_BROWSER_HELPERS.launch,
+    checkHelper: RUNTIME_BROWSER_HELPERS.check,
+    attachInfoHelper: RUNTIME_BROWSER_HELPERS.attachInfo,
+    e2eHelper: RUNTIME_BROWSER_HELPERS.e2e,
+    resetProfileHelper: RUNTIME_BROWSER_HELPERS.resetProfile
+  };
+}
+function buildBrowserGuidanceLines(browser) {
+  const lines = [
+    "This task requires Rig Browser.",
+    `Launch the browser: \`${browser.launchHelper}\`${browser.devCommand ? " or `rig-browser-launch --dev`" : ""}.`,
+    `Check the browser contract: \`${browser.checkHelper}\`.`,
+    `Show attach details: \`${browser.attachInfoHelper}\`.`,
+    `Attach Chrome DevTools MCP to ${browser.effectiveAttachUrl}.`,
+    `Preset: ${browser.preset}.`,
+    `Profile: ${browser.effectiveProfile}.`,
+    `State dir: ${browser.stateDir}.`,
+    `Reset the active profile with \`${browser.resetProfileHelper}\`.`
+  ];
+  if (browser.e2eCommand) {
+    lines.push(`Run app-owned browser e2e with \`${browser.e2eHelper}\`.`);
+  }
+  if (browser.defaultProfile !== browser.effectiveProfile) {
+    lines.push(`Base profile: ${browser.defaultProfile}. Runtime launches derive an isolated effective profile.`);
+  }
+  return lines;
+}
+export {
+  resolveTaskBrowserContext,
+  resolveBrowserStateDir,
+  buildBrowserGuidanceLines,
+  browserEnvFromContext,
+  RUNTIME_BROWSER_HELPERS,
+  DEFAULT_BROWSER_MODE,
+  DEFAULT_BROWSER_ATTACH_URL
+};