@ai-ecoverse/slicc-browsers 1.7.10 → 1.7.11

package/README.md

@@ -170,7 +170,7 @@ Any `cdp`, `page` or `children` step can take `requires`, the capabilities it ne
   - `eval`: evaluate `expression`.
   `hops` routes `url` through `/hop` on each `origin`, with its `code`.
 - `{ "answer": { "url", "stage"?, "cdp"?, "params"?, "hold"? } }`: answer each paused request or auth challenge for `url` with that call; `hold` leaves it paused. Every other paused request continues unchanged.
-- `{ "children": steps, "where"? }`: run these steps on each target auto-attached from then on, then resume it. `where` scopes them to the row's own target: `{ "openerId": "page" }` (opened by the row's page) or `{ "urlPrefix": url }`; other attached targets are resumed and otherwise left alone.
+- `{ "children": steps, "where"? }`: run these steps on each target auto-attached from then on, then resume it. `where` scopes them to the row's own target: `{ "openerId": "page" }` (opened by the row's page) or `{ "urlPrefix": url }`; other attached targets are resumed and otherwise left alone. When a vector has a `children` step with `where`, a target that attaches before that step runs waits until it does, and is then matched against `where`. A target is only resumed when it attached waiting for the debugger, and a `browser_ui` target (Chrome's own UI, such as `chrome://omnibox-popup.top-chrome/`) is never adopted or sent anything.
 - `{ "settle": { "beacon"?, "served"?, "title"?, "ms"?, "variant"?, "session"?, "dependsOn"?, "or"? } }`: wait for a beacon from `beacon`, for the fixture to log a request for the URL `served`, for the page `title`, or for the session to detach. When a refusal in `dependsOn` was recorded, the beacon can't come: a settle with `or` (a check) then waits until `or` holds, and one without it is skipped. Without such a refusal, `or` plays no part. Each beacon settle after an init script depends on that script's registration, and its `or` is what the row reads: the hops and the destination for the redirect chains, or the served page otherwise. It waits up to `ms` (10000 by default), then another 600 ms. `variant` waits the run's detach variant instead.
 - `{ "wait": ms }`.
 - `{ "paused": { "url", "ms" } }`: wait until the client has seen the pause that an `answer` rule for `url` matches (`Fetch.requestPaused` at the rule's stage, or `Fetch.authRequired` for a `Fetch.continueWithAuth` rule). It waits up to `ms`. On the control leg, a pause that never comes fails the row with `paused: no pause for <url> within <ms>ms`. On the guarded leg the guard may hide that pause, so the step waits the full `ms` and doesn't fail. The C5 guessed-id vectors and `C5.auth` use it before their second request, so the probe's interception id falls between the two ids the guess spans.

package/guard-runner.mjs

@@ -111,6 +111,10 @@ class Execution {
     this.answers = [];
     this.attachSettings = new Map();
     this.childSteps = [];
+    this.deferred = [];
+    this.expectWhere = [...(vector.setup ?? []), ...(vector.trigger ?? [])].some(
+      (step) => step.children && step.where
+    );
     this.childRuns = new Map();
     this.named = new Map();
     this.processed = new Set();
@@ -447,6 +451,11 @@ class Execution {
   adopt(event) {
     const info = event.params.targetInfo;
     const child = event.params.sessionId;
+    if (info?.type === 'browser_ui') return;
+    if (this.expectWhere && !this.childWhere) {
+      this.deferred.push(event);
+      return;
+    }
     if (info?.browserContextId && this.vars.context && info.browserContextId !== this.vars.context)
       return;
     if (this.childWhere && !this.childMatches(info)) {
@@ -462,7 +471,8 @@ class Execution {
       else {
         await this.execute(this.childSteps.slice(0, reload), child);
         const start = this.client.events.length;
-        await outcome(this.client.send('Runtime.runIfWaitingForDebugger', {}, child));
+        if (event.params.waitingForDebugger)
+          await outcome(this.client.send('Runtime.runIfWaitingForDebugger', {}, child));
         await this.poll(
           () =>
             this.client.events
@@ -473,7 +483,8 @@ class Execution {
         await this.execute(this.childSteps.slice(reload), child);
       }
       const resumed = this.client.events.length;
-      await outcome(this.client.send('Runtime.runIfWaitingForDebugger', {}, child));
+      if (event.params.waitingForDebugger)
+        await outcome(this.client.send('Runtime.runIfWaitingForDebugger', {}, child));
       if (this.childSteps.some((step) => step.cdp === 'Page.enable'))
         await this.poll(() => this.firstLoad(child, resumed), 5000);
     })().catch((error) => this.errors.push(String(error.message ?? error)));
@@ -604,6 +615,7 @@ class Execution {
     if (step.children) {
       this.childSteps = step.children;
       this.childWhere = step.where;
+      for (const event of this.deferred.splice(0)) this.adopt(event);
       return;
     }
     if (step.answer) {

package/guard-vectors.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "setVersion": "1.7.10",
+  "setVersion": "1.7.11",
   "sources": [
     {
       "repo": "ai-ecoverse/slicc-cli",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-browsers",
-  "version": "1.7.10",
+  "version": "1.7.11",
   "description": "SLICC's shared browser catalog, JSON schemas and discovery conformance corpus",
   "type": "module",
   "license": "Apache-2.0",