@h-rig/browser-plugin 0.0.6-alpha.156

package/README.md

@@ -0,0 +1 @@
+# @h-rig/browser-plugin

package/dist/src/browser-contract.d.ts

@@ -0,0 +1,16 @@
+import type { RuntimeBrowserContext, TaskBrowserConfig } from "@rig/contracts";
+export declare const DEFAULT_BROWSER_ATTACH_URL = "http://127.0.0.1:9333";
+export declare const DEFAULT_BROWSER_MODE = "persistent";
+export declare const RUNTIME_BROWSER_HELPERS: {
+    readonly launch: "rig-browser-launch";
+    readonly check: "rig-browser-check";
+    readonly attachInfo: "rig-browser-attach-info";
+    readonly e2e: "rig-browser-e2e";
+    readonly resetProfile: "rig-browser-reset-profile";
+};
+export declare function resolveBrowserStateDir(projectRoot: string | undefined, configuredStateDir: string | undefined): string;
+export declare function resolveTaskBrowserContext(browser: TaskBrowserConfig | undefined, options?: {
+    hostProjectRoot?: string;
+    runtimeId?: string;
+}): RuntimeBrowserContext | undefined;
+export declare function buildBrowserGuidanceLines(browser: RuntimeBrowserContext): string[];

package/dist/src/browser-contract.js

@@ -0,0 +1,101 @@
+// @bun
+// packages/browser-plugin/src/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 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(),
+    ...browser.dev_command?.trim() ? { devCommand: browser.dev_command.trim() } : {},
+    ...browser.launch_command?.trim() ? { launchCommand: browser.launch_command.trim() } : {},
+    ...browser.check_command?.trim() ? { checkCommand: browser.check_command.trim() } : {},
+    ...browser.e2e_command?.trim() ? { e2eCommand: browser.e2e_command.trim() } : {},
+    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,
+  RUNTIME_BROWSER_HELPERS,
+  DEFAULT_BROWSER_MODE,
+  DEFAULT_BROWSER_ATTACH_URL
+};

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./browser-contract";
+export { BROWSER_PLUGIN_NAME, browserPlugin, createBrowserPlugin, } from "./plugin";
+export { browserContractService, svc } from "./service";
+export { default } from "./plugin";

package/dist/src/index.js

@@ -0,0 +1,167 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
+// packages/browser-plugin/src/browser-contract.ts
+import { resolve } from "path";
+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(),
+    ...browser.dev_command?.trim() ? { devCommand: browser.dev_command.trim() } : {},
+    ...browser.launch_command?.trim() ? { launchCommand: browser.launch_command.trim() } : {},
+    ...browser.check_command?.trim() ? { checkCommand: browser.check_command.trim() } : {},
+    ...browser.e2e_command?.trim() ? { e2eCommand: browser.e2e_command.trim() } : {},
+    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;
+}
+var DEFAULT_BROWSER_ATTACH_URL = "http://127.0.0.1:9333", DEFAULT_BROWSER_MODE = "persistent", RUNTIME_BROWSER_HELPERS, BASE_REMOTE_DEBUGGING_PORT = 9222, REMOTE_DEBUGGING_PORT_SPREAD = 4000;
+var init_browser_contract = __esm(() => {
+  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"
+  };
+});
+
+// packages/browser-plugin/src/service.ts
+var exports_service = {};
+__export(exports_service, {
+  svc: () => svc,
+  browserContractService: () => browserContractService
+});
+var svc, browserContractService;
+var init_service = __esm(() => {
+  init_browser_contract();
+  svc = {
+    resolveTaskBrowserContext,
+    buildBrowserGuidanceLines
+  };
+  browserContractService = svc;
+});
+
+// packages/browser-plugin/src/index.ts
+init_browser_contract();
+
+// packages/browser-plugin/src/plugin.ts
+import { definePlugin } from "@rig/core/config";
+import { BROWSER_CONTRACT_SERVICE_CAPABILITY_ID } from "@rig/contracts";
+var BROWSER_PLUGIN_NAME = "@rig/browser-plugin";
+var browserPlugin = definePlugin({
+  name: BROWSER_PLUGIN_NAME,
+  version: "0.0.0-alpha.1",
+  contributes: {
+    capabilities: [
+      {
+        id: BROWSER_CONTRACT_SERVICE_CAPABILITY_ID,
+        title: "Browser-required task contract",
+        description: "Resolve a task's browser config into the runtime-effective browser context and render task-info browser guidance.",
+        run: async () => (await Promise.resolve().then(() => (init_service(), exports_service))).svc
+      }
+    ]
+  }
+});
+function createBrowserPlugin() {
+  return browserPlugin;
+}
+var plugin_default = browserPlugin;
+
+// packages/browser-plugin/src/index.ts
+init_service();
+export {
+  svc,
+  resolveTaskBrowserContext,
+  resolveBrowserStateDir,
+  plugin_default as default,
+  createBrowserPlugin,
+  buildBrowserGuidanceLines,
+  browserPlugin,
+  browserContractService,
+  RUNTIME_BROWSER_HELPERS,
+  DEFAULT_BROWSER_MODE,
+  DEFAULT_BROWSER_ATTACH_URL,
+  BROWSER_PLUGIN_NAME
+};

package/dist/src/plugin.d.ts

@@ -0,0 +1,4 @@
+export declare const BROWSER_PLUGIN_NAME = "@rig/browser-plugin";
+export declare const browserPlugin: import("@rig/core").RigPlugin;
+export declare function createBrowserPlugin(): import("@rig/core").RigPlugin;
+export default browserPlugin;

package/dist/src/plugin.js

@@ -0,0 +1,153 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
+// packages/browser-plugin/src/browser-contract.ts
+import { resolve } from "path";
+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(),
+    ...browser.dev_command?.trim() ? { devCommand: browser.dev_command.trim() } : {},
+    ...browser.launch_command?.trim() ? { launchCommand: browser.launch_command.trim() } : {},
+    ...browser.check_command?.trim() ? { checkCommand: browser.check_command.trim() } : {},
+    ...browser.e2e_command?.trim() ? { e2eCommand: browser.e2e_command.trim() } : {},
+    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;
+}
+var DEFAULT_BROWSER_ATTACH_URL = "http://127.0.0.1:9333", DEFAULT_BROWSER_MODE = "persistent", RUNTIME_BROWSER_HELPERS, BASE_REMOTE_DEBUGGING_PORT = 9222, REMOTE_DEBUGGING_PORT_SPREAD = 4000;
+var init_browser_contract = __esm(() => {
+  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"
+  };
+});
+
+// packages/browser-plugin/src/service.ts
+var exports_service = {};
+__export(exports_service, {
+  svc: () => svc,
+  browserContractService: () => browserContractService
+});
+var svc, browserContractService;
+var init_service = __esm(() => {
+  init_browser_contract();
+  svc = {
+    resolveTaskBrowserContext,
+    buildBrowserGuidanceLines
+  };
+  browserContractService = svc;
+});
+
+// packages/browser-plugin/src/plugin.ts
+import { definePlugin } from "@rig/core/config";
+import { BROWSER_CONTRACT_SERVICE_CAPABILITY_ID } from "@rig/contracts";
+var BROWSER_PLUGIN_NAME = "@rig/browser-plugin";
+var browserPlugin = definePlugin({
+  name: BROWSER_PLUGIN_NAME,
+  version: "0.0.0-alpha.1",
+  contributes: {
+    capabilities: [
+      {
+        id: BROWSER_CONTRACT_SERVICE_CAPABILITY_ID,
+        title: "Browser-required task contract",
+        description: "Resolve a task's browser config into the runtime-effective browser context and render task-info browser guidance.",
+        run: async () => (await Promise.resolve().then(() => (init_service(), exports_service))).svc
+      }
+    ]
+  }
+});
+function createBrowserPlugin() {
+  return browserPlugin;
+}
+var plugin_default = browserPlugin;
+export {
+  plugin_default as default,
+  createBrowserPlugin,
+  browserPlugin,
+  BROWSER_PLUGIN_NAME
+};

package/dist/src/service.d.ts

@@ -0,0 +1,14 @@
+/**
+ * service.ts — the concrete browser-contract service the runtime port resolves
+ * and consumes.
+ *
+ * CONFIG-LIGHT: this module top-level-imports the browser-contract impl. It is
+ * loaded LAZILY by the capability `run()` in plugin.ts
+ * (`(await import("./service")).svc`), so merely evaluating rig.config.ts never
+ * drags the browser-contract impl into scope.
+ */
+import type { BrowserContractService } from "@rig/runtime/control-plane/browser-contract-port";
+/** The concrete browser-contract service the runtime port resolves and consumes. */
+export declare const svc: BrowserContractService;
+/** Back-compat alias. */
+export declare const browserContractService: BrowserContractService;

package/dist/src/service.js

@@ -0,0 +1,104 @@
+// @bun
+// packages/browser-plugin/src/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 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(),
+    ...browser.dev_command?.trim() ? { devCommand: browser.dev_command.trim() } : {},
+    ...browser.launch_command?.trim() ? { launchCommand: browser.launch_command.trim() } : {},
+    ...browser.check_command?.trim() ? { checkCommand: browser.check_command.trim() } : {},
+    ...browser.e2e_command?.trim() ? { e2eCommand: browser.e2e_command.trim() } : {},
+    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;
+}
+
+// packages/browser-plugin/src/service.ts
+var svc = {
+  resolveTaskBrowserContext,
+  buildBrowserGuidanceLines
+};
+var browserContractService = svc;
+export {
+  svc,
+  browserContractService
+};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@h-rig/browser-plugin",
+  "version": "0.0.6-alpha.156",
+  "type": "module",
+  "description": "First-party browser-required task contract capability plugin for Rig.",
+  "license": "UNLICENSED",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/plugin.d.ts",
+      "import": "./dist/src/plugin.js"
+    },
+    "./plugin": {
+      "types": "./dist/src/plugin.d.ts",
+      "import": "./dist/src/plugin.js"
+    },
+    "./index": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "engines": {
+    "bun": ">=1.3.11"
+  },
+  "main": "./dist/src/index.js",
+  "module": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "dependencies": {
+    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.156",
+    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.156",
+    "@rig/runtime": "npm:@h-rig/runtime@0.0.6-alpha.156"
+  }
+}