@farmslot/adapter-web 0.10.4 → 0.10.6

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.6 - 2026-10-15
+
+- Use the operator-wait runtime and protocol dependency set.
+
+## 0.10.5 - 2026-10-15
+
+- Consume the plain `ProjectRuntime` and `ActionCatalog` contracts.
+
 ## 0.10.4 - 2026-10-15
 
 - Align the published dependency set with protocol 0.47.0 initial resource proof modes.

package/README.md

@@ -29,7 +29,7 @@ Docs: https://farmslot.io/docs/reference/adapter-web
 | `slot-title`                   | prefix the extension home tab's title with the farm slot id, kept across the page's own title resets                      |
 | `validation-process-ownership` | find and stop the processes that own a slot profile                                                                       |
 | `validation-launch-supervisor` | supervised child for one validation launch: port lease, quarantine and cleanup                                            |
-| `web-dapp`                     | the generic web-dapp lifecycle as an adapter-sdk `PlatformAdapter` (ESM): slot browser, wallet host, readiness, stop      |
+| `web-dapp`                     | the generic web-dapp lifecycle as an adapter-sdk `ProjectRuntime` (ESM): slot browser, wallet host, readiness, stop       |
 
 Sources are CommonJS (`src/**/*.cjs`) and ship as is; `yarn build` emits `.d.cts` declarations. `web-dapp` is the exception: its sources are ESM (`src/web-dapp/**/*.mjs`, declarations `.d.mts`), because its leaf scripts run as their own node processes. Every library subpath can be `require`d or `import`ed with named imports, except `validation-launch-supervisor`: it is a child-process entry (it runs when loaded), so hosts `require.resolve` it and fork it.
 
@@ -110,7 +110,7 @@ const binding = createWalletRequestBinding({
 
 ## Web-dapp adapter
 
-`@farmslot/adapter-web/web-dapp` (ESM) is the lifecycle of a web app under test whose dev server the slot owns. `createWebDappAdapter({ id, signerModule, cli, hooks })` returns an `@farmslot/adapter-sdk` `PlatformAdapter`: launch, stop, runtime status, doctor checks, logs and the wallet request-log findings. It runs one slot browser per slot, and a wallet host attached to it over CDP that records the wallet requests (and, with `signer=injected`, answers them with the strict wallet from `dapp`).
+`@farmslot/adapter-web/web-dapp` (ESM) is the lifecycle of a web app under test whose dev server the slot owns. `createWebDappAdapter({ id, signerModule, cli, hooks })` returns an `@farmslot/adapter-sdk` `ProjectRuntime`: launch, stop, runtime status, doctor checks, logs and the wallet request-log findings. It runs one slot browser per slot, and a wallet host attached to it over CDP that records the wallet requests (and, with `signer=injected`, answers them with the strict wallet from `dapp`).
 
 - **Venue policy.** The app's venue (the hosts a testnet run blocks and serves, the typed data to refuse, the start page) comes from the adapter that `extends: 'web-dapp'`: its policy module goes to `RECIPE_WEB_DAPP_POLICY` through `bindWebDappPolicy(adapter)`. Bare web-dapp has no policy and refuses to launch. `fencePolicy` and `assertPolicyDigest` hold the module and what it imports to the files the plugin digest covers, and every process that loads the policy refuses, with a `module.registerHooks` resolve hook, any import resolved from one of those files (static, dynamic, or a `require` created for it) that lands outside them (Node.js 22.15 or later).
 - **Served network.** A policy that declares served hosts (`venueHosts().served`) has the wallet host wait for the app to request one of them, which proves the dev server serves testnet. A policy for an app whose page makes no venue request of its own (such as test-dapp-multichain, whose wallet traffic goes through the extension) opts out explicitly: `venueHosts()` returns `served: []` with `servedCheck: 'not-applicable'`. The check is then skipped, and `networkEnforcement.served` in `browser.json` and the `network-enforcement` entry of the wallet request log say `not-applicable`. An empty `served` without that opt-out keeps the check, which fails closed, so a policy that computes its served hosts can't lose the check by finding none. Listing served hosts and opting out together is refused. Mainnet blocking is enforced either way.

package/dist/web-dapp/index.d.mts

@@ -42,7 +42,7 @@ export function bindWebDappPolicy<T extends {
  */
 export function walletRequestFindings(lines: readonly string[]): import("@farmslot/adapter-sdk").AdapterLogFinding[];
 /**
- * @typedef {Partial<Omit<import('@farmslot/adapter-sdk').PlatformAdapter, 'id' | 'sdkVersion' | 'harness'>> & {
+ * @typedef {Partial<Omit<import('@farmslot/adapter-sdk').ProjectRuntime, 'id' | 'sdkVersion' | 'harness'>> & {
  *   harness?: Partial<Extract<import('@farmslot/adapter-sdk').AdapterHarness, { kind?: 'overlay' }>> |
  *     Extract<import('@farmslot/adapter-sdk').AdapterHarness, { kind: 'built-in' }>,
  * }} WebDappAdapterHooks
@@ -55,15 +55,15 @@ export function walletRequestFindings(lines: readonly string[]): import("@farmsl
  *   loads it in this process and launch, verify and the wallet host load it in theirs.
  * @property {string} [cli] The host's bin name, for `Next:` lines. farmslot-recipe by default.
  * @property {WebDappAdapterHooks} [hooks]
- *   Anything of the PlatformAdapter the host supplies or replaces. `actions` is
+ *   Anything of the ProjectRuntime the host supplies or replaces. `actions` is
  *   required in practice (web-dapp ships no action manifest); `diagnostics`,
  *   `readiness` and `harness` merge over the generic members, the rest replace.
  */
 /**
  * @param {WebDappAdapterOptions} [factoryOptions]
- * @returns {import('@farmslot/adapter-sdk').PlatformAdapter}
+ * @returns {import('@farmslot/adapter-sdk').ProjectRuntime}
  */
-export function createWebDappAdapter(factoryOptions?: WebDappAdapterOptions): import("@farmslot/adapter-sdk").PlatformAdapter;
+export function createWebDappAdapter(factoryOptions?: WebDappAdapterOptions): import("@farmslot/adapter-sdk").ProjectRuntime;
 export { cleanupWebDappRuntime } from "./cleanup.mjs";
 export { installWebDappRuntime } from "./inject.mjs";
 export const WEB_DAPP_CONSOLE_FILES: Readonly<{
@@ -82,7 +82,7 @@ export const WEB_DAPP_ONLY_LAUNCH_OPTIONS: Readonly<{
     network: "--network";
     mainnetConfirmation: "--mainnet-confirmation";
 }>;
-export type WebDappAdapterHooks = Partial<Omit<import("@farmslot/adapter-sdk").PlatformAdapter, "id" | "sdkVersion" | "harness">> & {
+export type WebDappAdapterHooks = Partial<Omit<import("@farmslot/adapter-sdk").ProjectRuntime, "id" | "sdkVersion" | "harness">> & {
     harness?: Partial<Extract<import("@farmslot/adapter-sdk").AdapterHarness, {
         kind?: "overlay";
     }>> | Extract<import("@farmslot/adapter-sdk").AdapterHarness, {
@@ -105,7 +105,7 @@ export type WebDappAdapterOptions = {
      */
     cli?: string | undefined;
     /**
-     * Anything of the PlatformAdapter the host supplies or replaces. `actions` is
+     * Anything of the ProjectRuntime the host supplies or replaces. `actions` is
      * required in practice (web-dapp ships no action manifest); `diagnostics`,
      * `readiness` and `harness` merge over the generic members, the rest replace.
      */

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farmslot/adapter-web",
-  "version": "0.10.4",
+  "version": "0.10.6",
   "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.14.2",
-    "@farmslot/protocol": "0.47.0",
-    "@farmslot/recipe-runner": "0.36.2",
+    "@farmslot/adapter-sdk": "0.15.1",
+    "@farmslot/protocol": "0.48.0",
+    "@farmslot/recipe-runner": "0.37.1",
     "ws": "^8.18.0"
   },
   "devDependencies": {

package/src/web-dapp/index.mjs

@@ -1,5 +1,5 @@
 // @ts-check
-// The generic web-dapp lifecycle as an adapter-sdk PlatformAdapter: a web app
+// The generic web-dapp lifecycle as an adapter-sdk ProjectRuntime: a web app
 // under test whose dev server the slot owns; the adapter owns the slot browser
 // (an extension signer or the injected strict wallet) and its wallet host. What
 // it knows about the app's venue comes from the venue policy of the adapter that
@@ -288,7 +288,7 @@ const str = (options, key) => (typeof options[key] === 'string' ? options[key] :
 const flag = (options, key) => options[key] === true;
 
 /**
- * @typedef {Partial<Omit<import('@farmslot/adapter-sdk').PlatformAdapter, 'id' | 'sdkVersion' | 'harness'>> & {
+ * @typedef {Partial<Omit<import('@farmslot/adapter-sdk').ProjectRuntime, 'id' | 'sdkVersion' | 'harness'>> & {
  *   harness?: Partial<Extract<import('@farmslot/adapter-sdk').AdapterHarness, { kind?: 'overlay' }>> |
  *     Extract<import('@farmslot/adapter-sdk').AdapterHarness, { kind: 'built-in' }>,
  * }} WebDappAdapterHooks
@@ -302,14 +302,14 @@ const flag = (options, key) => options[key] === true;
  *   loads it in this process and launch, verify and the wallet host load it in theirs.
  * @property {string} [cli] The host's bin name, for `Next:` lines. farmslot-recipe by default.
  * @property {WebDappAdapterHooks} [hooks]
- *   Anything of the PlatformAdapter the host supplies or replaces. `actions` is
+ *   Anything of the ProjectRuntime the host supplies or replaces. `actions` is
  *   required in practice (web-dapp ships no action manifest); `diagnostics`,
  *   `readiness` and `harness` merge over the generic members, the rest replace.
  */
 
 /**
  * @param {WebDappAdapterOptions} [factoryOptions]
- * @returns {import('@farmslot/adapter-sdk').PlatformAdapter}
+ * @returns {import('@farmslot/adapter-sdk').ProjectRuntime}
  */
 export function createWebDappAdapter(factoryOptions = {}) {
   if ('signers' in factoryOptions) {

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

@@ -2,9 +2,9 @@
 import { captureHelperSnapshot } from '@farmslot/recipe-runner';
 
 /**
- * @param {import('@farmslot/adapter-sdk').AdapterActions} actions
+ * @param {import('@farmslot/adapter-sdk').ActionCatalog} actions
  * @param {import('@farmslot/adapter-sdk').AdapterRecording} recording
- * @returns {import('@farmslot/adapter-sdk').AdapterActions}
+ * @returns {import('@farmslot/adapter-sdk').ActionCatalog}
  */
 export function browserWindowScreenshots(actions, recording) {
   const ui = actions.ui;