@farmslot/adapter-web 0.7.1 → 0.8.0

package/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to `@farmslot/adapter-web` are tracked here.
 
 ## Unreleased
 
+- Active-development baseline; add user-facing changes here before release or package publication.
+
+## 0.8.0 - 2026-10-13
+
+- Honor HUD top/bottom placement through automatic progress and capture the painted final outcome.
+
+## 0.7.2 - 2026-10-12
+
+- Record web-dapp recipes through the shared recorder, selecting only the owned browser on the requested CDP port.
+
 ## 0.7.1 - 2026-10-12
 
 - Update shared runtime dependencies for corrected keyboard events and bounded log observations.

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

@@ -1,4 +1,5 @@
 export function nextHudState(prior: any, node?: {}, nodeId?: string): {
+    position?: any;
     seq: any;
     title: any;
     current: any;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farmslot/adapter-web",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "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.9.1",
-    "@farmslot/protocol": "0.40.0",
-    "@farmslot/recipe-runner": "0.31.0",
+    "@farmslot/adapter-sdk": "0.10.0",
+    "@farmslot/protocol": "0.41.0",
+    "@farmslot/recipe-runner": "0.32.0",
     "ws": "^8.18.0"
   },
   "devDependencies": {

package/src/web-dapp/index.mjs

@@ -17,7 +17,9 @@ import { fileURLToPath } from 'node:url';
 
 import { recipeRuntimePath, shellQuote } from './lib/paths.mjs';
 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 { defaultSigner, loadSigners, SIGNER_MODULE_ENV } from './lib/signers.mjs';
 import { resolveBrowser } from './launch.mjs';
 
@@ -324,6 +326,26 @@ export function createWebDappAdapter(factoryOptions = {}) {
     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 };
+      },
+    },
+
     resolveSlotPorts() {
       // Ports come from the slot (Farmslot {{port}} / {{cdp_port}}) through
       // --watcher-port / --cdp-port or the runtime context; nothing is claimed here.

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

@@ -13,7 +13,13 @@
 import { readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 
-import { HUD_PANEL_BOUNDS, hudIntentDisplay, hudSecondaryText } from '@farmslot/protocol/recipe';
+import {
+  HUD_PANEL_BOUNDS,
+  hudIntentDisplay,
+  hudPlacement,
+  hudSecondaryText,
+  waitForHudPaint,
+} from '@farmslot/protocol/recipe';
 
 export const HUD_ELEMENT = 'mm-harness-hud';
 export const HUD_FILE = 'hud.json';
@@ -37,12 +43,14 @@ export function nextHudState(prior, node = {}, nodeId = '') {
   const intent =
     hudIntentDisplay(node.intent ?? node.text ?? node.detail).text || hudIntentDisplay(nodeId).text;
   const id = hudSecondaryText(node.node_id ?? node.nodeId ?? nodeId, 80);
+  const position = hudPlacement(node.display) ?? previous?.position;
   const state = {
     seq: (previous?.seq ?? 0) + 1,
     title: hudSecondaryText(node.title, 80) || previous?.title || 'Recipe run',
     current: previous?.current ?? null,
     last: previous?.last ?? null,
     finished: null,
+    ...(position ? { position } : {}),
   };
   if (status === 'running') {
     state.current = {
@@ -117,7 +125,7 @@ export function hudRenderExpression(state, appOrigin) {
     if (location.origin !== ${JSON.stringify(String(appOrigin).replace(/\/$/u, ''))}) return { hud: false, reason: 'not-app-origin' };
     const existing = document.documentElement.querySelector(':scope > ${HUD_ELEMENT}');
     if (!state) { existing?.remove(); return { hud: false, cleared: true }; }
-    if (existing && existing.dataset.seq === String(state.seq)) return { hud: true, seq: state.seq, unchanged: true };
+    if (existing && existing.dataset.seq === String(state.seq)) return (${waitForHudPaint.toString()})(requestAnimationFrame).then(() => ({ hud: true, seq: state.seq, unchanged: true }));
     existing?.remove();
     const host = document.createElement('${HUD_ELEMENT}');
     host.dataset.seq = String(state.seq);
@@ -129,6 +137,10 @@ export function hudRenderExpression(state, appOrigin) {
     const el = (tag, cls, value) => { const node = document.createElement(tag); if (cls) node.className = cls; if (value != null) node.textContent = value; return node; };
     const style = el('style', null, ${JSON.stringify(STYLE)});
     const box = el('div', 'hud');
+    if (state.position) {
+      box.style.top = state.position === 'top' ? '12px' : 'auto';
+      box.style.bottom = state.position === 'bottom' ? '12px' : 'auto';
+    }
     const intentStyle = ${JSON.stringify(hudIntentDisplay('').webStyle)};
     const head = el('div', 'row');
     head.append(el('span', 'title', state.title));
@@ -153,6 +165,6 @@ export function hudRenderExpression(state, appOrigin) {
     if (state.last && state.last.error) box.append(el('div', 'last error', state.last.error));
     root.append(style, box);
     document.documentElement.append(host);
-    return { hud: true, seq: state.seq };
+    return (${waitForHudPaint.toString()})(requestAnimationFrame).then(() => ({ hud: true, seq: state.seq }));
   })()`;
 }