@ai-ecoverse/slicc-browsers 1.12.0 → 1.13.0

package/README.md

@@ -169,6 +169,8 @@ A same-site frame shares its parent's process and has no target of its own. Ever
 
 **Storage keys** (`Storage`, `IndexedDB`, `CacheStorage` and `FileSystem` in CDP): a key is protected when its origin (up to the first `^`) or its top-level site (a part after `^0`) is a protected URL.
 
+**Redirect secrets.** An allowed response can name a protected destination without becoming a protected document itself. Every protected URL in a nested delivered string or object key is redacted in place to its origin, including embedded `Location`, `Content-Location`, `Refresh` and `Link` values, raw `headersText` lines, `redirectResponse`, Page URL/history/error fields, console/exception text and Audits issues. Percent-encoded representations must not retain the tail. A separate `urlFragment` alongside a protected `url` is cleared too. The event remains delivered so Network ExtraInfo pairing survives; dropping an ExtraInfo event fails these vectors. A request whose response names a protected URL has its response body refused (`slicc: refused:`), through both Fetch and Network, even though the request started at an ordinary URL. Body reads, replay and URL overrides must not follow an ordinary redirect into protected content or send its cookies. Ordinary redirect headers and bodies stay readable.
+
 **Refusals** carry the text in `refusal`, `slicc: refused: target is on seven's origin`.
 
 **`protected.json`** (schema `schema/protected.schema.json`): `errorPage` (the committed-error previous-decision and origin-redaction rule), `unparseable` (`protected`) and `unparseableRefusal`, in step with the catalog; `origins`, the extra origins every vector runs with; `urls` (`url`, `protected`); `targets` (`url`, `documentURL?` and `unreachableURL?` for validated main-frame error-commit evidence, `navigating?` for a main-frame navigation in flight; `type?`, the target's `TargetInfo.type`; `previous?`, whether the target was protected before; `opener?`, `protected`, `unprotected` or `unknown`, and no `opener` for a target without one; `protected`); `cookieDomains` (`domain`, `protected`); `storageKeys` (`key`, `protected`). `npm run validate` runs every vector through `protected.mjs`, and no vector uses a port from 9222 to 9229.
@@ -186,6 +188,10 @@ The `C9` foreign extension isolated-world family requires `extensionWorld`: a br
 
 The integration launcher loads shared-web 1.25.2’s harness extension exactly once through `Extensions.loadUnpacked` (`ankmbodmgimjemnojmeddfcdlbocolob`), whose content script runs on HTTP(S) pages. shared-web 1.25.2 also loads it by default in its own harness. A transport unable to host a foreign content-script extension omits `extensionWorld` and reports `not-supported:extensionWorld`; an advertised capability with no observed world fails, rather than silently skipping.
 
+`C2.redirect-secret` probes ordinary fixture 302s to seven’s `/auth/callback?code=…&state=…` and vault’s `/oauth/mcp-callback?code=…`, plus `#access_token=…` variants of both. It navigates with Page and scripted `location.href`, fetches a subresource and sends an XHR. The 302 carries `Location`, `Content-Location`, `Refresh: 0;url=…` and `Link: <…>; rel=preconnect`. Page, Network (including ExtraInfo), Runtime, Log, Audits and both Fetch stages are enabled. Every received raw message is scanned, including replies, across an eight-second tail, for raw, percent-encoded, JSON-escaped and base64 marker representations. Both response-body APIs are attempted on each hop; guarded bodies need matched refusals. Page frame trees, resource trees and navigation history are read before recovery to catch error-page leftovers. A separate structural check requires every protected `Network.Request.urlFragment` and `Page.Frame.urlFragment` to be empty or absent, even if its value contains no marker; the ordinary `#access_token` control independently requires fragment evidence in request events, frame events, frame-tree replies and resource-tree replies. The ordinary session must survive. The unguarded ordinary redirect control preserves all four headers in `redirectResponse`, ExtraInfo’s headers and `headersText`, and Fetch’s response headers. `C2.redirect-secret-mix` repeats that matrix with 301/303/307/308. The protected leg requires in-place ExtraInfo delivery with origin-only header values, not merely the absence of a marker.
+
+`C2.redirect-body` calls `Network.loadNetworkResource` on an ordinary redirect with `includeCredentials: true`, reads any stream with `IO.read`, replays a redirected XHR, requests Page resource content, and captures Page/MHTML and DOM snapshots after a main-frame redirect. It also captures an ordinary parent containing an iframe redirected to vault, including its error document, and overrides a paused ordinary Fetch request to the allowed redirect URL. No protected marker may appear in any message or body, and no request from those operations may send the independently seeded seven cookie. The ordinary control must return the body, resource content and snapshots, and accept the URL override. Each probe cleans up its redirect registrations, observer session and cookie. The focused Chrome tests use HTTPS with SPKI-pinned fixture trust and default-port protected URLs; host resolver rules route seven and vault to the fixture rather than the public service.
+
 `C8.unparseable` probes both raw and canonical space/U+200D/invalid-punycode URLs through creation and navigation. Every guarded destination needs a matched refusal. Its unguarded controls record `document` or `native-rejection` outcomes, including Chrome builds that reject raw U+200D instead of committing it. Both raw and encoded-space forms must commit real fixture documents, because that is the proven cookie leak. An independent observer loads the encoded-space document and confirms it shares a uniquely seeded `.sliccy.ai` cookie; the guarded client must neither list nor attach to it, read its cookie, query that cookie by URL, nor cause a cookie-bearing destination request. The guard does not erase the observer’s private browser state. The row runs on both browser-session and page-session-only transports, uses the default context, and cleans up its own targets and cookie. Cookie seeding always uses the unguarded observer’s browser session, never the guarded client. Only guarded browser-session target listing requires `browserSession`; without it, `listed` records `not-supported` explicitly in probe and observation evidence, and the result lists that field in `notSupported`. Creation, navigation, attachment and `Network.getCookies` with `urls` still require matched refusals; filtering cookies without refusing fails `cookieRefused`. Fixture URLs omit the colon when the port is empty, and reported URLs are compared after canonicalisation, including Chrome’s WHATWG-unparseable encoded-space hosts. Launchers must resolve the raw/canonical space, U+200D/punycode and invalid-punycode `.sliccy.ai` fixture hosts to the fixture server, including for default-port HTTP or HTTPS origins. The HTTP fixture accepts Chrome’s encoded-space Host header without reparsing it as a WHATWG origin.
 
 `C8.chrome-search` requests `chrome-search://most-visited/` through `Page.navigate` and requires an explicit guard refusal. Its unguarded control requires a CDP response, not a successful document commit: Chrome can answer with `errorText` when that internal data source is unavailable outside an Instant process. Browser-side load failure is not a guard refusal, and merely hiding the target must fail this row.
@@ -255,6 +261,8 @@ Popups are observed by `Target.targetCreated` with the opener's `openerId`, or b
 
 `{ "errorPage": "recover", "secret"?: "all" | "query" | "fragment", "as": "errorPage" }` (also modes `restore` and `sticky`; `secret` defaults to `all`) runs the protected-error-page compound probe with independent commit evidence, discovery redaction and recovery or sticky-lock checks. The unguarded observer seeds the protected history and failed commit, so the rows run on page-session-only transports too. The guarded client uses only `Target.getTargetInfo` with a `targetId`, `Target.getTargets`, `Target.setDiscoverTargets`, `Target.attachToTarget`, `Target.detachFromTarget` and `Target.closeTarget` without a session, which page-session transports answer themselves, and everything else on its page session; the rows require no capability. The runner leaves this probe’s independent Fetch sessions to the probe rather than answering their pauses itself.
 
+`{ "redirectSecret": "headers" | "mix" | "body", "as": "redirect" }` runs a C2 compound probe and owns its Fetch pauses. The client must expose `messages`, an append-only array of every raw received CDP text frame, recorded before parsing; an events-only or reply-only tap fails `rawRecorded`. The fixture must implement `redirectSecret({ path, host?, search?, to?, code?, body, remove? })`: registering an allowed hop without putting the protected marker in the initiating URL, and registering the callback body on the protected host. `fixtureServer()` supplies it. Fixture logs must include headers for the cookie check. The guard’s events and raw messages must represent the same delivered stream.
+
 `{ "unparseable": true, "as": "unparseable" }` runs the C8 malformed-URL compound probe on the current ordinary page: independent browser ground truth, raw/canonical destination commands, discovery/attach and cookie checks. Boolean evidence is consumed by ordinary `result` checks, with native Chrome outcomes retained in its diagnostics.
 
 **The control rule.** Every vector has a control on an ordinary origin: the same setup and trigger against an unprotected origin must succeed. A missing or failing control fails the id. With `via: "guard"`, the control runs through the guard. With `via: "unguarded"`, the runner runs setup and trigger through its own CDP against the ordinary origin and against the protected stand-in, and both must show the effect. The runner reports the control's transport as `via`.
@@ -544,7 +552,7 @@ A six endpoint has tier `six`, whatever its seven tabs. **A program never choose
 
 ## Output schema 1
 
-`schema/browsers.schema.json` describes `slicc browsers --json`, which `playwright-cli list --json` also prints. [slicc-cli's README](https://github.com/ai-ecoverse/slicc-cli#slicc-browsers---json---cdp-url---no-bundle-scan) is the authoritative spec for it; this schema is a copy and follows it. Fields can be added; `source` is one of `devtools-active-port`, `flag`, `probe` and `process`. `tier` is 1 to 6, and `six: true` marks an endpoint in SLICC six's profile (tier 6). An endpoint may carry `tabs`: every page target except those on protected origins. Seven's own tabs are protected, so they are in `sevenTabs` only, never in `tabs`. `playwright-cli list --json` prints it, and a corpus case that checks it needs `tabs`.
+`schema/browsers.schema.json` describes `slicc browsers --json`, which `playwright-cli list --json` also prints. [slicc-cli's README](https://github.com/ai-ecoverse/slicc-cli#slicc-browsers---json---cdp-url---no-bundle-scan) is the authoritative spec for it; this schema is a copy and follows it. Fields can be added; `source` is one of `devtools-active-port`, `flag`, `probe` and `process`. `tier` is 1 to 6, and `six: true` marks an endpoint in SLICC six's profile (tier 6). An endpoint may carry `tabs`: every page target except those on protected origins. Seven's own tabs are protected, so they are in `sevenTabs` only, never in `tabs`. In `sevenTabs`, `url` and `title` are the origin only, never a path, query, fragment or document title, including configured extra seven origins and default-port normalization. `playwright-cli list --json` prints it, and a corpus case that checks it needs `tabs`.
 
 ## The corpus
 

package/corpus.json

@@ -761,8 +761,8 @@
               "sevenTabs": [
                 {
                   "id": "P1",
-                  "url": "https://lars.sliccy.ai/",
-                  "title": "seven"
+                  "url": "https://lars.sliccy.ai",
+                  "title": "https://lars.sliccy.ai"
                 }
               ],
               "tabs": [
@@ -854,13 +854,13 @@
               "sevenTabs": [
                 {
                   "id": "O1",
-                  "url": "https://dev.example.test/app",
-                  "title": "dev"
+                  "url": "https://dev.example.test",
+                  "title": "https://dev.example.test"
                 },
                 {
                   "id": "O3",
-                  "url": "https://dev.example.test:443/other",
-                  "title": "dev again"
+                  "url": "https://dev.example.test",
+                  "title": "https://dev.example.test"
                 }
               ]
             }
@@ -1298,8 +1298,8 @@
               "sevenTabs": [
                 {
                   "id": "P1",
-                  "url": "https://lars.sliccy.ai/",
-                  "title": "seven"
+                  "url": "https://lars.sliccy.ai",
+                  "title": "https://lars.sliccy.ai"
                 }
               ]
             }
@@ -1713,8 +1713,8 @@
               "sevenTabs": [
                 {
                   "id": "S1",
-                  "url": "https://b.sliccy.ai/",
-                  "title": "seven b"
+                  "url": "https://b.sliccy.ai",
+                  "title": "https://b.sliccy.ai"
                 }
               ]
             }
@@ -1737,8 +1737,8 @@
               "sevenTabs": [
                 {
                   "id": "S2",
-                  "url": "https://a.sliccy.ai/",
-                  "title": "seven a"
+                  "url": "https://a.sliccy.ai",
+                  "title": "https://a.sliccy.ai"
                 }
               ]
             }
@@ -2012,8 +2012,8 @@
               "sevenTabs": [
                 {
                   "id": "D1",
-                  "url": "https://seven.sliccy.ai:443/",
-                  "title": "seven"
+                  "url": "https://seven.sliccy.ai",
+                  "title": "https://seven.sliccy.ai"
                 }
               ]
             }
@@ -2039,6 +2039,69 @@
         ]
       }
     },
+    {
+      "name": "seven-tab-origin-redaction",
+      "case": {
+        "description": "sevenTabs URL and title reveal only the origin, never a secret path, query, fragment or document title",
+        "needs": [
+          "flag"
+        ],
+        "cdp": [
+          "127.0.0.1:9531"
+        ],
+        "http": {
+          "127.0.0.1:9531": {
+            "version": {
+              "Browser": "Chrome/154.0.8037.98",
+              "Protocol-Version": "1.3",
+              "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "V8-Version": "15.4.79.1",
+              "WebKit-Version": "537.36 (@a1b2c3)",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9531/devtools/browser/d1"
+            },
+            "list": [
+              {
+                "id": "D1",
+                "type": "page",
+                "url": "https://seven.sliccy.ai/auth/secret-path-marker?code=secret-query-marker#access_token=secret-fragment-marker",
+                "title": "secret-title-marker",
+                "webSocketDebuggerUrl": "ws://127.0.0.1/devtools/page/D1"
+              }
+            ]
+          }
+        }
+      },
+      "expected": {
+        "schema": 1,
+        "minChromium": 116,
+        "entries": [
+          {
+            "id": "cdp:127.0.0.1:9531",
+            "kind": "endpoint",
+            "tier": 1,
+            "name": "Chrome",
+            "version": "154.0.8037.98",
+            "endpoint": {
+              "cdp": "http://127.0.0.1:9531",
+              "webSocketDebuggerUrl": "ws://127.0.0.1:9531/devtools/browser/d1",
+              "name": "Chrome",
+              "version": "154.0.8037.98",
+              "product": "Chrome/154.0.8037.98",
+              "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/154.0.8037.98 Safari/537.36",
+              "source": "flag",
+              "sevenOpen": true,
+              "sevenTabs": [
+                {
+                  "id": "D1",
+                  "url": "https://seven.sliccy.ai",
+                  "title": "https://seven.sliccy.ai"
+                }
+              ]
+            }
+          }
+        ]
+      }
+    },
     {
       "name": "seven-tabs",
       "case": {
@@ -2189,13 +2252,13 @@
               "sevenTabs": [
                 {
                   "id": "T1",
-                  "url": "https://lars.sliccy.ai/",
-                  "title": "seven"
+                  "url": "https://lars.sliccy.ai",
+                  "title": "https://lars.sliccy.ai"
                 },
                 {
                   "id": "T6",
-                  "url": "https://seven.sliccy.ai/?x=1#top",
-                  "title": "seven too"
+                  "url": "https://seven.sliccy.ai",
+                  "title": "https://seven.sliccy.ai"
                 }
               ]
             }
@@ -2218,8 +2281,8 @@
               "sevenTabs": [
                 {
                   "id": "V1",
-                  "url": "https://team-7.sliccy.ai/workspace",
-                  "title": "seven"
+                  "url": "https://team-7.sliccy.ai",
+                  "title": "https://team-7.sliccy.ai"
                 }
               ]
             }
@@ -2400,8 +2463,8 @@
               "sevenTabs": [
                 {
                   "id": "S1",
-                  "url": "https://lars.sliccy.ai/",
-                  "title": "seven"
+                  "url": "https://lars.sliccy.ai",
+                  "title": "https://lars.sliccy.ai"
                 }
               ]
             }
@@ -2522,8 +2585,8 @@
               "sevenTabs": [
                 {
                   "id": "S1",
-                  "url": "https://lars.sliccy.ai/",
-                  "title": "seven"
+                  "url": "https://lars.sliccy.ai",
+                  "title": "https://lars.sliccy.ai"
                 }
               ]
             }
@@ -2674,8 +2737,8 @@
               "sevenTabs": [
                 {
                   "id": "S1",
-                  "url": "https://lars.sliccy.ai/",
-                  "title": "seven"
+                  "url": "https://lars.sliccy.ai",
+                  "title": "https://lars.sliccy.ai"
                 }
               ]
             }
@@ -2775,8 +2838,8 @@
               "sevenTabs": [
                 {
                   "id": "S1",
-                  "url": "https://lars.sliccy.ai/",
-                  "title": "seven"
+                  "url": "https://lars.sliccy.ai",
+                  "title": "https://lars.sliccy.ai"
                 }
               ]
             }

package/fixture-server.mjs

@@ -26,7 +26,20 @@ function trigger(p) {
   return `<p>trigger</p><button onclick="go()">Go</button>${frame}<script>const to=${JSON.stringify(to)};function go(){const k=${JSON.stringify(kind)};if(k==='href'||k==='deferred')location.href=to;if(k==='replace')location.replace(to);if(k==='popup')window.open(to);if(k==='form'){const u=new URL(to);const f=document.createElement('form');f.action=u.origin+u.pathname;for(const [name,value] of u.searchParams){const i=document.createElement('input');i.type='hidden';i.name=name;i.value=value;f.append(i);}document.body.append(f);f.submit();}return 'went';}${kind === 'deferred' ? `setTimeout(go,${Number(p.get('defer') ?? 3000)});` : ''}</script>`;
 }
 
-function route(req, url, send, html) {
+function route(req, url, send, html, redirects) {
+  const secret =
+    redirects.get(`${url.hostname}${url.pathname}${url.search ?? ''}`) ??
+    redirects.get(`${url.hostname}${url.pathname}`) ??
+    redirects.get(url.pathname);
+  if (secret) {
+    if (!secret.to) return send(200, secret.body, 'text/plain');
+    return send(secret.code ?? 302, secret.body, 'text/plain', {
+      location: secret.to,
+      'content-location': secret.to,
+      refresh: `0;url=${secret.to}`,
+      link: `<${secret.to}>; rel=preconnect`,
+    });
+  }
   const p = url.searchParams;
   const routes = {
     '/beacon': () => send(204, ''),
@@ -95,6 +108,7 @@ function requestURL(req, scheme) {
 
 export async function fixtureServer({ host = '127.0.0.1', port = 0, tls, latency } = {}) {
   let entries = [];
+  const redirects = new Map();
   const scheme = tls ? 'https' : 'http';
   const handler = (req, res) => {
     const url = requestURL(req, scheme);
@@ -123,8 +137,8 @@ export async function fixtureServer({ host = '127.0.0.1', port = 0, tls, latency
         headers
       );
     const wait = latency?.(url) ?? 0;
-    if (wait > 0) setTimeout(() => route(req, url, send, html), wait);
-    else route(req, url, send, html);
+    if (wait > 0) setTimeout(() => route(req, url, send, html, redirects), wait);
+    else route(req, url, send, html, redirects);
   };
   const server = tls ? createSecureServer(tls, handler) : createServer(handler);
   await new Promise((resolve, reject) => {
@@ -133,6 +147,12 @@ export async function fixtureServer({ host = '127.0.0.1', port = 0, tls, latency
   });
   const address = server.address();
   return {
+    redirects,
+    redirectSecret: async ({ path, host = '', search = '', remove, ...value }) => {
+      const key = `${host}${path}${search}`;
+      if (remove) redirects.delete(key);
+      else redirects.set(key, value);
+    },
     port: address.port,
     origin: `${scheme}://${host}:${address.port}`,
     log: () => structuredClone(entries),

package/guard-runner.mjs

@@ -14,6 +14,7 @@ import {
   steps,
 } from './guard-driver.mjs';
 import { protectedErrorPage } from './protected-error-page.mjs';
+import { redirectSecret } from './redirect-secret.mjs';
 import { canonicalURL, unparseableURLs } from './unparseable-url.mjs';
 
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
@@ -623,10 +624,10 @@ class Execution {
       );
     if (step.extensionWorld && out.result?.incomplete)
       this.errors.push(`extensionWorld ${step.extensionWorld}: ${out.result.incomplete}`);
-    if ((step.extensionWorld || step.unparseable || step.errorPage) && !out.ok)
-      this.errors.push(
-        `${step.unparseable ? 'unparseable' : step.errorPage ? 'errorPage' : 'extensionWorld'}: ${out.error?.message ?? 'probe failed'}`
-      );
+    const probe = ['redirectSecret', 'unparseable', 'errorPage', 'extensionWorld'].find(
+      (key) => step[key]
+    );
+    if (probe && !out.ok) this.errors.push(`${probe}: ${out.error?.message ?? 'probe failed'}`);
     if (step.as && !out.result?.pending) this.calls[step.as] = out;
     if (step.cdp) (this.calls.$cdp ??= []).push({ method: step.cdp, ...out });
   }
@@ -676,6 +677,26 @@ class Execution {
       await this.settle(step.settle);
       return;
     }
+    if (step.redirectSecret) {
+      this.internalSessions.add(session);
+      try {
+        return await outcome(
+          redirectSecret({
+            client: this.client,
+            reader: this.reader,
+            session,
+            targetId: this.pageTarget,
+            ordinary: this.vars.ordinary,
+            tag: this.vars.tag,
+            fixture: this.options.fixture,
+            mode: step.redirectSecret,
+            side: this.side,
+          })
+        );
+      } finally {
+        this.internalSessions.delete(session);
+      }
+    }
     if (step.errorPage)
       return outcome(
         protectedErrorPage({