@farmslot/adapter-web 0.9.2 → 0.10.1

package/CHANGELOG.md

@@ -6,6 +6,14 @@ All notable changes to `@farmslot/adapter-web` are tracked here.
 
 - Active-development baseline; add user-facing changes here before release or package publication.
 
+## 0.10.1 - 2026-10-15
+
+- Align the installed dependency closure with protocol 0.45.0 and retained-run stack attachment.
+
+## 0.10.0 - 2026-10-15
+
+- Include browser chrome and extension side panels in unrecorded web-dapp screenshots through the owned browser's native capture, with CDP fallback.
+
 ## 0.9.2 - 2026-10-15
 
 - Align the installed worker dependency closure with protocol 0.44.0 and provenance-bound branch maintenance.

package/README.md

@@ -117,6 +117,7 @@ const binding = createWalletRequestBinding({
 - **Locked session.** A headful launch refuses while the macOS login session is locked (`SESSION_LOCKED`), before starting, reusing or stopping a browser: macOS stops painting visible windows, so screenshots, video and UI actions would stall. `macosSessionLocked()` reads `ioreg` (3 s bound; `null` off macOS or when unknown). A headless launch never probes.
 - **Signers.** `signer=injected` needs nothing. `signer=extension` belongs to the host: a signer module exports `signers.extension` with `prepareProfile` (load the extension, seed the profile; returns `{ browserArgs, secrets, state }` and may carry an `afterBrowserStart` step; both steps get `trackSecret` for key-material files), `confirm` (required with `prepareProfile`: without it the wallet host would close the wallet's own windows) and `readinessChecks`. `signers.injected.identity` sets the EIP-6963 identity the injected strict wallet presents. The module path (`signerModule`, `--signer-module` or `RECIPE_WEB_DAPP_SIGNER_MODULE`) is the one source: readiness, launch, verify and the wallet host all load it, and `createWebDappAdapter` throws if given an in-process `signers` object. With no signer requested, the signer is `extension` when a module is configured and `injected` otherwise, so a host whose module exports only `injected` sets the signer explicitly (`--signer injected` or `TERMINAL_SIGNER=injected`).
 - **Hooks.** The action set, console capture, and network and performance observation are the host's; pass them as `hooks`. `diagnostics`, `readiness` and `harness` merge over the generic members.
+- **Screenshots.** Unrecorded `ui.screenshot` captures the owned browser window through capture-helper, including browser chrome and extension side panels. The host's CDP transport remains the fallback, with `captureProvider`, `fallbackFrom` and `fallbackReason` in artifact metadata. Recorded screenshots use their recording session; full-page requests and `ui.capture_surface` use CDP. The native path reuses the recording target's browser identity checks and the runner's rooted artifact writer.
 - **Leaves.** `webDappLeafPath('launch' | 'wallet-host' | 'inject' | 'verify' | 'stop' | 'cleanup')` names the CLI scripts.
 - **Test fixture.** `test/fixtures/web-dapp-test-plugin` is a `test-dapp` adapter for MetaMask's test-dapp-multichain. That dapp needs `signer=extension` with a host signer module: it talks to the wallet through the Multichain API, which the injected EIP-1193 strict wallet cannot drive.
 - **Kept for compatibility.** These generic-code names still carry the host's old product name, because renaming them needs both sides to change together: the `TERMINAL_*` environment names (`TERMINAL_CHROME_BIN`, `TERMINAL_APP_PORT`, `TERMINAL_SIGNER`, `TERMINAL_ACCOUNT`, `TERMINAL_HEADLESS`, `TERMINAL_SLOW_MO`, `TERMINAL_WINDOW`, `TERMINAL_SCREEN`); `MM_HARNESS_SERVED_TIMEOUT_MS`, `MM_HARNESS_APP_COMMIT_TIMEOUT_MS` and `MM_HARNESS_FOCUS_SETTLE_MS`; the `--mm-harness-owner` process marker (process ownership is matched on argv); the `mm-harness-probe=1` probe marker; and the `mm-harness-hud` overlay element.

package/dist/web-dapp/lib/screenshots.d.mts

@@ -0,0 +1,6 @@
+/**
+ * @param {import('@farmslot/adapter-sdk').AdapterActions} actions
+ * @param {import('@farmslot/adapter-sdk').AdapterRecording} recording
+ * @returns {import('@farmslot/adapter-sdk').AdapterActions}
+ */
+export function browserWindowScreenshots(actions: import("@farmslot/adapter-sdk").AdapterActions, recording: import("@farmslot/adapter-sdk").AdapterRecording): import("@farmslot/adapter-sdk").AdapterActions;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farmslot/adapter-web",
-  "version": "0.9.2",
+  "version": "0.10.1",
   "description": "Web platform adapter for Farmslot recipes: resolve and launch an isolated Chromium, own its CDP port, load unpacked extensions, and keep macOS focus.",
   "type": "commonjs",
   "exports": {
@@ -83,9 +83,9 @@
     "prepublishOnly": "node ../../scripts/quality/check-farmslot-package-readiness.mjs --publish --packages @farmslot/adapter-web"
   },
   "dependencies": {
-    "@farmslot/adapter-sdk": "0.13.2",
-    "@farmslot/protocol": "0.44.0",
-    "@farmslot/recipe-runner": "0.34.3",
+    "@farmslot/adapter-sdk": "0.14.0",
+    "@farmslot/protocol": "0.45.0",
+    "@farmslot/recipe-runner": "0.36.0",
     "ws": "^8.18.0"
   },
   "devDependencies": {

package/src/web-dapp/index.mjs

@@ -20,6 +20,7 @@ import { POLICY_ENV, webDappAdapterId, webDappPolicy } from './lib/policy.mjs';
 import { cdpListenerPids, ownsProcess } from './lib/processes.mjs';
 import { check, webDappReadiness } from './lib/readiness.mjs';
 import { cdpPort, readBrowserState, webDappRuntimeDir } from './lib/runtime.mjs';
+import { browserWindowScreenshots } from './lib/screenshots.mjs';
 import { defaultSigner, loadSigners, SIGNER_MODULE_ENV } from './lib/signers.mjs';
 import { resolveBrowser } from './launch.mjs';
 
@@ -332,30 +333,33 @@ export function createWebDappAdapter(factoryOptions = {}) {
     restart: `${cli} launch`,
   };
 
+  /** @type {import('@farmslot/adapter-sdk').AdapterRecording} */
+  const recording = rest.recording ?? {
+    async target(context) {
+      const port = cdpPort(context, context.env);
+      const state = await readBrowserState(context.projectRoot);
+      const pid = state?.browserPid;
+      if (
+        !Number.isInteger(pid) ||
+        pid <= 0 ||
+        state.cdpPort !== port ||
+        !ownsProcess('browser', pid, webDappRuntimeDir(context.projectRoot)) ||
+        !cdpListenerPids(port).includes(pid)
+      ) {
+        throw new Error(
+          `Could not resolve the owned ${webDappAdapterId()} browser for recording on CDP ${port}. Next: launch and verify the selected slot browser.`,
+        );
+      }
+      return { kind: 'pid', pid };
+    },
+  };
+
   return {
     id,
     sdkVersion: 1,
     headless: false,
 
-    recording: {
-      async target(context) {
-        const port = cdpPort(context, context.env);
-        const state = await readBrowserState(context.projectRoot);
-        const pid = state?.browserPid;
-        if (
-          !Number.isInteger(pid) ||
-          pid <= 0 ||
-          state.cdpPort !== port ||
-          !ownsProcess('browser', pid, webDappRuntimeDir(context.projectRoot)) ||
-          !cdpListenerPids(port).includes(pid)
-        ) {
-          throw new Error(
-            `Could not resolve the owned ${webDappAdapterId()} browser for recording on CDP ${port}. Next: launch and verify the selected slot browser.`,
-          );
-        }
-        return { kind: 'pid', pid };
-      },
-    },
+    recording,
 
     resolveSlotPorts() {
       // Ports come from the slot (Farmslot {{port}} / {{cdp_port}}) through
@@ -535,15 +539,18 @@ export function createWebDappAdapter(factoryOptions = {}) {
 
     // The web-dapp ships no action manifest: the host supplies its action set
     // (`hooks.actions`).
-    actions: actions ?? {
-      manifestPath() {
-        throw new Error(
-          `${id} ships no action manifest: pass hooks.actions to createWebDappAdapter.`,
-        );
+    actions: browserWindowScreenshots(
+      actions ?? {
+        manifestPath() {
+          throw new Error(
+            `${id} ships no action manifest: pass hooks.actions to createWebDappAdapter.`,
+          );
+        },
+        semantic: [],
+        cdpTarget: { transport: 'chrome-cdp', probePath: 'json/version' },
       },
-      semantic: [],
-      cdpTarget: { transport: 'chrome-cdp', probePath: 'json/version' },
-    },
+      recording,
+    ),
 
     // Built-in bridges inherit verification, without overlay installer leaves.
     harness:
@@ -606,8 +613,8 @@ export function createWebDappAdapter(factoryOptions = {}) {
           message: item.detail,
         }));
       },
-      // Screenshots come from the slot browser over CDP.
-      captureProviders: ['cdp'],
+      // Native window capture includes browser chrome and extension side panels.
+      captureProviders: ['capture-helper', 'cdp'],
       ...readiness,
     },
 

package/src/web-dapp/lib/screenshots.mjs

@@ -0,0 +1,35 @@
+// Keep the host's page/action bindings while preferring the owned browser window.
+import { captureHelperSnapshot } from '@farmslot/recipe-runner';
+
+/**
+ * @param {import('@farmslot/adapter-sdk').AdapterActions} actions
+ * @param {import('@farmslot/adapter-sdk').AdapterRecording} recording
+ * @returns {import('@farmslot/adapter-sdk').AdapterActions}
+ */
+export function browserWindowScreenshots(actions, recording) {
+  const ui = actions.ui;
+  if (!ui) return actions;
+  return {
+    ...actions,
+    ui(harness, options) {
+      return ui.call(
+        actions,
+        {
+          ...harness,
+          createCdpWebUiTransport(config) {
+            return harness.createCdpWebUiTransport({
+              ...config,
+              screenshotProvider: {
+                name: 'capture-helper',
+                async capture({ context }) {
+                  return captureHelperSnapshot(await recording.target(context));
+                },
+              },
+            });
+          },
+        },
+        options,
+      );
+    },
+  };
+}