@rehearsal-labs/retest 0.1.0 → 0.2.0

package/dist/runner/inbox-links.js

@@ -0,0 +1,63 @@
+import { isTokenSegment } from "../diagnostics/sanitize.js";
+// A parameter whose name is one of these words, or a longer word ending in one, as `access_token` or `oobCode` read,
+// carries a credential, whatever its value looks like.
+const credentialWords = ['token', 'code', 'key', 'secret', 'signature', 'sig', 'auth', 'otp', 'nonce', 'ticket', 'session', 'hash', 'password'];
+/**
+ * Reads a link from a message, or undefined when its address is not an http or https URL. A password in the address is
+ * a token. A part reads as a token when it is one of the message's codes; when it is a query parameter, or a parameter of a fragment written as a query,
+ * whose name speaks of a credential; or when it reads as one as diagnostics read a path segment: 16 letters and digits
+ * or more, 12 digits or more, or a JSON Web Token's shape, and not a file name, a version or a date. That rule applies
+ * to each path segment, each query value and the fragment.
+ *
+ * @example readLink('https://app.test/verify/9f8e7d6c5b4a39281706f5e4?utm=mail', [])?.tokens // ['9f8e7d6c5b4a39281706f5e4']
+ */
+export function readLink(address, codes) {
+    const url = URL.parse(address.trim());
+    if (url === null || (url.protocol !== 'http:' && url.protocol !== 'https:'))
+        return undefined;
+    const isCode = (value) => codes.includes(value);
+    // A password written into the address is a credential, whatever it looks like.
+    const found = url.password === '' ? [] : [url.password, decoded(url.password)];
+    for (const segment of url.pathname.split('/')) {
+        if (segment !== '' && (isCode(decoded(segment)) || isTokenSegment(segment)))
+            found.push(segment, decoded(segment));
+    }
+    found.push(...parameterTokens(url.search.slice(1), isCode));
+    // A fragment written as a query, as a sign-in that hands its token to the page writes it, is read as one.
+    const fragment = url.hash.slice(1);
+    if (fragment.includes('='))
+        found.push(...parameterTokens(fragment, isCode));
+    else if (fragment !== '' && (isCode(decoded(fragment)) || isTokenSegment(fragment)))
+        found.push(fragment, decoded(fragment));
+    return { url, tokens: [...new Set(found.filter((part) => part !== ''))] };
+}
+// Each parameter's value, raw and decoded, when its name speaks of a credential or its value reads as a token.
+function parameterTokens(query, isCode) {
+    const found = [];
+    for (const pair of query.split('&')) {
+        const separator = pair.indexOf('=');
+        if (separator === -1)
+            continue;
+        const name = decoded(pair.slice(0, separator).replaceAll('+', ' '));
+        const raw = pair.slice(separator + 1);
+        const value = decoded(raw.replaceAll('+', ' '));
+        if (value !== '' && (namesCredential(name) || isCode(value) || isTokenSegment(raw)))
+            found.push(raw, value);
+    }
+    return found;
+}
+function namesCredential(name) {
+    const words = name
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .toLowerCase()
+        .split(/[^a-z0-9]+/);
+    return words.some((word) => credentialWords.some((credential) => word.endsWith(credential)));
+}
+function decoded(text) {
+    try {
+        return decodeURIComponent(text);
+    }
+    catch {
+        return text;
+    }
+}

package/dist/runner/inbox.d.ts

@@ -0,0 +1,87 @@
+import type { LoadedInbox } from '../config/loaded.ts';
+import type { Failure } from '../protocol/failures.ts';
+import type { InboxAnswer, InboxCodeRef, InboxLinkRef, InboxRequest } from '../protocol/inbox.ts';
+import type { LocatorRecipe } from '../protocol/locator.ts';
+import type { Redactor } from './redactor.ts';
+import type { FillContext, FillResolution } from './secrets.ts';
+/** How long a read may look, and the signal that stops it, as when its test is stopped. */
+export type InboxReadBudget = {
+    readonly timeoutMs: number;
+    readonly signal: AbortSignal;
+};
+/**
+ * How a read ended, as its event records it: the answer for the test, how many messages the mailbox held on the last
+ * look, how many times Retest asked it, and how long the read took.
+ */
+export type InboxRead = {
+    readonly answer: InboxAnswer;
+    readonly messages: number;
+    readonly looks: number;
+    readonly waitedMs: number;
+};
+/** A code fill as the test file's process sends it: the code by its message and number, never its value. */
+export type InboxCodeFill = {
+    kind: 'fill';
+    locator: LocatorRecipe;
+    value: InboxCodeRef;
+};
+/** Where a link from an inbox may open: the origins of the base URLs of the test's apps. */
+export type LinkContext = {
+    readonly appOrigins: readonly string[];
+};
+/** A link resolved to its address, or why it may not open. */
+export type LinkResolution = {
+    ok: true;
+    url: string;
+} | {
+    ok: false;
+    failure: Failure;
+};
+export type AttemptInboxOptions = {
+    readonly inboxes: ReadonlyMap<string, LoadedInbox>;
+    readonly redactor: Redactor;
+    /** When the attempt started, in milliseconds since 1970. A message received before then is not the test's. */
+    readonly startedAt: number;
+};
+/** A message as the source gave it, once its shape is checked, with when it arrived in milliseconds since 1970. */
+type SourceMessage = {
+    readonly subject: string;
+    readonly from: string;
+    readonly text: string;
+    readonly codes: readonly string[];
+    readonly links: readonly {
+        readonly url: string;
+        readonly text: string;
+    }[];
+    readonly receivedAt: number;
+};
+/**
+ * One attempt's reads of the run's inboxes. Each read asks the mailbox again until a message arrives that was received
+ * since the attempt started, and since the last message the attempt was given from that inbox, and that has the
+ * subject the test asked for, or until its time runs out. Every code and every token in a link that a mailbox gives is
+ * taught to the redactor as it arrives, whether or not the test is given that message. The test's process receives the
+ * message with its codes and those links replaced by placeholders, and names a code or a link by its message and number;
+ * only this process reads the values, and binds them to origins as it binds a secret.
+ */
+export declare class AttemptInbox {
+    #private;
+    constructor({ inboxes, redactor, startedAt }: AttemptInboxOptions);
+    /** Reads an inbox for the test, looking again until a message arrives or the read's time runs out. */
+    read(request: InboxRequest, { timeoutMs, signal }: InboxReadBudget): Promise<InboxRead>;
+    /**
+     * Turns a fill of a code into the text the page types, bound to the origins the code may be typed on: those of the
+     * test's apps' base URLs and the inbox's own, or on an Electron app's window only the inbox's. A native app takes none.
+     */
+    resolveCode(command: InboxCodeFill, context: FillContext): Promise<FillResolution>;
+    /** Turns a link into the address the page opens, when its origin is one of the test's apps' or the inbox's own. */
+    resolveLink(reference: InboxLinkRef, { appOrigins }: LinkContext): LinkResolution;
+}
+/**
+ * Checks what an inbox's function gave: a list of messages, each with a subject, a sender and text, a list of codes, a
+ * list of links of `{ url, text }`, and when it arrived. A problem names the message and the field, never a value.
+ *
+ * @example checkMessages([{ subject: 'Hi' }]) // 'message 1 has no from'
+ */
+export declare function checkMessages(value: unknown): SourceMessage[] | string;
+export {};
+//# sourceMappingURL=inbox.d.ts.map

package/dist/runner/inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.d.ts","sourceRoot":"","sources":["../../src/runner/inbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAA6C,MAAM,sBAAsB,CAAA;AAC5I,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,wBAAwB,CAAA;AAEtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAW,MAAM,cAAc,CAAA;AAaxE,2FAA2F;AAC3F,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAA;AAE1F;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtI,4GAA4G;AAC5G,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAAA;AAEzF,4FAA4F;AAC5F,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAA;AAEpE,8DAA8D;AAC9D,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAA;AAExF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IAClD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,8GAA8G;IAC9G,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED,mHAAmH;AACnH,KAAK,aAAa,GAAG;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC1E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B,CAAA;AA6BD;;;;;;;GAOG;AACH,qBAAa,YAAY;;gBAOX,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,mBAAmB;IAMjE,sGAAsG;IAChG,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAmC7F;;;OAGG;IACG,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAmBxF,mHAAmH;IACnH,WAAW,CAAC,SAAS,EAAE,YAAY,EAAE,EAAE,UAAU,EAAE,EAAE,WAAW,GAAG,cAAc;CAuIlF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,EAAE,GAAG,MAAM,CAsBtE"}

package/dist/runner/inbox.js

@@ -0,0 +1,340 @@
+import { waitBeforeRead } from "../assertions/wait-before-read.js";
+import { matchesText } from "../browser/text-match.js";
+import { Deadline, elapsedMs, monotonicClock } from "../protocol/deadline.js";
+import { errorMessage, failure, failureSchema } from "../protocol/failures.js";
+import { codePlaceholderName, describeInboxReference, linkName, linkPlaceholder } from "../protocol/inbox.js";
+import { describeTextMatch, patternProblem } from "../protocol/locator.js";
+import { isArray, isPlainObject, parse } from "../protocol/schema.js";
+import { originOf } from "../protocol/url.js";
+import { bounded } from "./bounded.js";
+import { readLink } from "./inbox-links.js";
+import { locateFill } from "./secrets.js";
+/** The shortest code Retest hides safely, as for a secret. */
+const minCodeLength = 4;
+// How long a read waits between looks: a mailbox is a service of its own, asked more gently than a page.
+const pauses = [100, 250, 500, 1000];
+/**
+ * One attempt's reads of the run's inboxes. Each read asks the mailbox again until a message arrives that was received
+ * since the attempt started, and since the last message the attempt was given from that inbox, and that has the
+ * subject the test asked for, or until its time runs out. Every code and every token in a link that a mailbox gives is
+ * taught to the redactor as it arrives, whether or not the test is given that message. The test's process receives the
+ * message with its codes and those links replaced by placeholders, and names a code or a link by its message and number;
+ * only this process reads the values, and binds them to origins as it binds a secret.
+ */
+export class AttemptInbox {
+    #inboxes;
+    #redactor;
+    #startedAt;
+    #given = new Map();
+    #histories = new Map();
+    constructor({ inboxes, redactor, startedAt }) {
+        this.#inboxes = inboxes;
+        this.#redactor = redactor;
+        this.#startedAt = startedAt;
+    }
+    /** Reads an inbox for the test, looking again until a message arrives or the read's time runs out. */
+    async read(request, { timeoutMs, signal }) {
+        const startedAt = monotonicClock();
+        const ended = (answer, messages, looks) => ({ answer, messages, looks, waitedMs: elapsedMs(startedAt) });
+        const inbox = this.#inboxes.get(request.inbox);
+        if (inbox === undefined)
+            return ended({ ok: false, failure: unknownInbox(request.inbox, [...this.#inboxes.keys()]) }, 0, 0);
+        const problem = subjectProblem(request.subject);
+        if (problem !== undefined)
+            return ended({ ok: false, failure: problem }, 0, 0);
+        const deadline = new Deadline(timeoutMs, { signal });
+        const history = this.#history(request.inbox);
+        let looks = 0;
+        let held = [];
+        let fresh = [];
+        let answered = false;
+        for (;;) {
+            looks += 1;
+            const look = await this.#look(request.inbox, inbox, deadline, signal);
+            if (look.kind === 'failed')
+                return ended({ ok: false, failure: look.failure }, held.length, looks);
+            if (look.kind === 'messages') {
+                answered = true;
+                held = look.messages;
+                fresh = this.#fresh(held, history);
+                const chosen = fresh.find((message) => request.subject === undefined || matchesText(this.#hidden(message, message.subject), request.subject, false));
+                if (chosen !== undefined)
+                    return ended(this.#give(request.inbox, chosen, history), held.length, looks);
+            }
+            const last = look.kind === 'timed_out' ? (answered ? 'unanswered' : 'silent') : 'answered';
+            if (deadline.reached)
+                return ended({ ok: false, failure: this.#nothingArrived({ request, looks, held, fresh, timeoutMs, last }) }, held.length, looks);
+            try {
+                await waitBeforeRead(deadline, pauses[Math.min(looks, pauses.length) - 1] ?? 1000);
+            }
+            catch (error) {
+                if (!signal.aborted)
+                    throw error;
+                return ended({ ok: false, failure: stopped(request.inbox, signal.reason) }, held.length, looks);
+            }
+        }
+    }
+    /**
+     * Turns a fill of a code into the text the page types, bound to the origins the code may be typed on: those of the
+     * test's apps' base URLs and the inbox's own, or on an Electron app's window only the inbox's. A native app takes none.
+     */
+    async resolveCode(command, context) {
+        const reference = command.value;
+        const given = this.#given.get(reference.message);
+        const inbox = this.#inboxes.get(reference.inbox);
+        if (given === undefined || given.inbox !== reference.inbox || inbox === undefined)
+            return refused('usage', notGiven('code', reference.inbox));
+        const code = given.codes[reference.code - 1];
+        if (code === undefined)
+            return refused('usage', `The message ${JSON.stringify(given.subject)} from the inbox ${JSON.stringify(reference.inbox)} holds no code, so Retest typed nothing.`);
+        if (context.bundleId !== undefined)
+            return refused('unsupported', `Retest types a code from an inbox only into a web page, and typed nothing into ${context.bundleId}.`, { bundleId: context.bundleId });
+        const electron = context.target === 'electron';
+        const allowedOrigins = electron ? [...inbox.origins] : [...new Set([...context.appOrigins, ...inbox.origins])];
+        const located = await locateFill(context);
+        if (located.kind === 'stopped')
+            return { ok: false, failure: stoppedFill(reference.inbox, context.signal.reason) };
+        const web = originOf(located.pageUrl);
+        if (web === undefined || !allowedOrigins.includes(web)) {
+            return refused('not_actionable', wrongCodeOrigin({ inbox: reference.inbox, origin: web, allowed: allowedOrigins, electron }), { origin: web ?? null });
+        }
+        return { ok: true, command: { kind: 'fill', locator: command.locator, value: code, secret: codePlaceholderName, allowedOrigins } };
+    }
+    /** Turns a link into the address the page opens, when its origin is one of the test's apps' or the inbox's own. */
+    resolveLink(reference, { appOrigins }) {
+        const given = this.#given.get(reference.message);
+        const inbox = this.#inboxes.get(reference.inbox);
+        if (given === undefined || given.inbox !== reference.inbox || inbox === undefined)
+            return refusedLink('usage', notGiven('link', reference.inbox));
+        const shown = describeInboxReference(reference);
+        if (reference.link > given.links.length) {
+            return refusedLink('usage', `The message ${JSON.stringify(given.subject)} from the inbox ${JSON.stringify(reference.inbox)} holds no link ${reference.link}, so Retest opened nothing.`);
+        }
+        const link = given.links[reference.link - 1];
+        if (link === undefined)
+            return refusedLink('unsupported', `${shown} from the inbox ${JSON.stringify(reference.inbox)} is not an http or https address, so Retest opened nothing.`);
+        const allowed = [...new Set([...appOrigins, ...inbox.origins])];
+        const { origin } = link.url;
+        if (!allowed.includes(origin)) {
+            const permitted = allowed.length === 0 ? 'no origin, since no app the test uses has a base URL and the inbox lists no origins' : allowed.join(', ');
+            const message = `Retest did not open ${shown} from the inbox ${JSON.stringify(reference.inbox)}: it goes to ${origin}, and a link from this inbox may open only on ${permitted}. Add the origin to the inbox's origins if it belongs there.`;
+            return { ok: false, failure: { ...failure('not_actionable', message), details: { origin } } };
+        }
+        return { ok: true, url: link.url.href };
+    }
+    #history(inbox) {
+        const known = this.#histories.get(inbox);
+        if (known !== undefined)
+            return known;
+        const history = { receivedAt: this.#startedAt, given: new Set() };
+        this.#histories.set(inbox, history);
+        return history;
+    }
+    // One look at the mailbox, within the read's time. The function is told through its signal when Retest stops waiting.
+    // Whatever it gives is taught to the redactor as it arrives, even after the read stopped waiting for it, since the app
+    // may show it next.
+    async #look(name, inbox, deadline, signal) {
+        const waiting = new AbortController();
+        const stop = Promise.withResolvers();
+        const onAbort = () => stop.resolve();
+        signal.addEventListener('abort', onAbort, { once: true });
+        if (signal.aborted)
+            onAbort();
+        const reading = inbox.read({ signal: waiting.signal });
+        void reading.then((value) => this.#learn(value), () => undefined);
+        const read = await bounded(reading, deadline.commandTimeoutMs, stop.promise);
+        signal.removeEventListener('abort', onAbort);
+        if (read.status === 'stopped') {
+            waiting.abort(new DOMException(`Retest stopped reading the inbox ${JSON.stringify(name)}: its read was stopped.`, 'AbortError'));
+            return { kind: 'failed', failure: stopped(name, signal.reason) };
+        }
+        if (read.status === 'timed_out') {
+            waiting.abort(new DOMException(`Retest stopped reading the inbox ${JSON.stringify(name)}: it took longer than ${deadline.budgetMs} ms.`, 'TimeoutError'));
+            return { kind: 'timed_out' };
+        }
+        if (read.status === 'failed')
+            return { kind: 'failed', failure: failure('setup_failed', `Retest could not read the inbox ${JSON.stringify(name)}: ${this.#redactor.redact(errorMessage(read.error))}`) };
+        const checked = checkMessages(read.value);
+        if (typeof checked === 'string')
+            return { kind: 'failed', failure: failure('setup_failed', `The inbox ${JSON.stringify(name)} gave messages Retest cannot read: ${checked}.`) };
+        return { kind: 'messages', messages: checked };
+    }
+    // Each token of each link is hidden as its link's placeholder, and each code as `{{code}}`, which is learned last so a
+    // code a link carries reads as the code. Only text long enough to hide safely is learned.
+    #learn(value) {
+        if (!isArray(value))
+            return;
+        for (const message of value) {
+            if (!isPlainObject(message))
+                continue;
+            const codes = isArray(message['codes']) ? message['codes'].filter((code) => typeof code === 'string') : [];
+            const links = isArray(message['links']) ? message['links'] : [];
+            for (const [index, link] of links.entries()) {
+                const url = isPlainObject(link) ? link['url'] : undefined;
+                const read = typeof url === 'string' ? readLink(url, codes) : undefined;
+                for (const token of read?.tokens ?? [])
+                    if (token.length >= minCodeLength)
+                        this.#redactor.learn(linkName(index + 1), token);
+            }
+            for (const code of codes)
+                if (code.length >= minCodeLength)
+                    this.#redactor.learn(codePlaceholderName, code);
+        }
+    }
+    // The messages received since the attempt started, and since the last one it was given from this inbox, that it was
+    // not given already, newest first. Two messages received at the same moment keep the mailbox's order.
+    #fresh(messages, history) {
+        const fresh = messages.filter((message) => message.receivedAt >= history.receivedAt && !history.given.has(fingerprint(message)));
+        return fresh.toSorted((first, second) => second.receivedAt - first.receivedAt);
+    }
+    #give(inbox, message, history) {
+        const short = message.codes.find((code) => code.length < minCodeLength);
+        if (short !== undefined) {
+            return { ok: false, failure: failure('setup_failed', `The inbox ${JSON.stringify(inbox)} gave a message with a code shorter than ${minCodeLength} characters, too short to redact safely, so Retest gave the test nothing.`) };
+        }
+        history.given.add(fingerprint(message));
+        history.receivedAt = Math.max(history.receivedAt, message.receivedAt);
+        const id = `m${this.#given.size + 1}`;
+        const reads = message.links.map((link) => readLink(link.url, message.codes));
+        const subject = this.#hidden(message, message.subject);
+        this.#given.set(id, { inbox, subject, codes: message.codes, links: reads });
+        const links = message.links.map((link, index) => {
+            const read = reads[index];
+            const text = this.#hidden(message, link.text);
+            if (read === undefined)
+                return { text, origin: '', path: '', token: false };
+            return { text, origin: read.url.origin, path: this.#redactor.redact(read.url.pathname), token: read.tokens.length > 0 };
+        });
+        const record = {
+            id,
+            inbox,
+            subject,
+            from: this.#hidden(message, message.from),
+            text: this.#hidden(message, message.text),
+            codes: message.codes.length,
+            links,
+            receivedAt: new Date(message.receivedAt).toISOString(),
+        };
+        return { ok: true, message: record };
+    }
+    // Text of a message as the test reads it: each link that carries a token, written whole, replaced by its placeholder,
+    // and then every value the run hides, the message's codes and the tokens of its links among them.
+    #hidden(message, text) {
+        const whole = message.links.flatMap((link, index) => {
+            const read = readLink(link.url, message.codes);
+            if (read === undefined || read.tokens.length === 0)
+                return [];
+            return [...new Set([link.url.trim(), read.url.href])].map((written) => ({ written, placeholder: linkPlaceholder(index + 1) }));
+        });
+        whole.sort((first, second) => second.written.length - first.written.length);
+        let replaced = text;
+        for (const { written, placeholder } of whole)
+            replaced = replaced.replaceAll(written, placeholder);
+        return this.#redactor.redact(replaced);
+    }
+    #nothingArrived({ request, looks, held, fresh, timeoutMs, last }) {
+        const history = this.#histories.get(request.inbox);
+        const since = history !== undefined && history.given.size > 0 ? 'since the last message this test was given' : 'since the test started';
+        const wanted = request.subject === undefined ? '' : `, and none of them has a subject matching ${describeTextMatch(request.subject)}`;
+        const holding = held.length === 0 ? 'the inbox held no message' : `the inbox held ${count(held.length, 'message')}, ${fresh.length === 0 ? 'none' : String(fresh.length)} received ${since}${fresh.length === 0 ? '' : wanted}`;
+        const seen = last === 'answered' ? `On the last look, ${holding}.`
+            : last === 'silent' ? 'The inbox gave no answer in that time.'
+                : `The last look got no answer in the time left. On the last look that answered, ${holding}.`;
+        const message = `No message arrived in the inbox ${JSON.stringify(request.inbox)} within ${timeoutMs} ms. Retest looked ${count(looks, 'time')}. ${seen}`;
+        return { ...failure('timeout', message), details: { inbox: request.inbox, looks, messages: held.length, fresh: fresh.length, timeoutMs } };
+    }
+}
+/**
+ * Checks what an inbox's function gave: a list of messages, each with a subject, a sender and text, a list of codes, a
+ * list of links of `{ url, text }`, and when it arrived. A problem names the message and the field, never a value.
+ *
+ * @example checkMessages([{ subject: 'Hi' }]) // 'message 1 has no from'
+ */
+export function checkMessages(value) {
+    if (!isArray(value))
+        return `expected a list of messages, received ${kindOf(value)}`;
+    const messages = [];
+    for (const [index, message] of value.entries()) {
+        const which = `message ${index + 1}`;
+        if (!isPlainObject(message))
+            return `${which} is ${kindOf(message)}, not an object`;
+        const { subject, from, text, codes, links, receivedAt } = message;
+        if (typeof subject !== 'string')
+            return fieldProblem(which, 'subject', subject);
+        if (typeof from !== 'string')
+            return fieldProblem(which, 'from', from);
+        if (typeof text !== 'string')
+            return fieldProblem(which, 'text', text);
+        if (!isArray(codes) || codes.some((code) => typeof code !== 'string' || code === ''))
+            return `${which} has codes that are not a list of text`;
+        const checkedLinks = [];
+        if (!isArray(links))
+            return `${which} has links that are not a list`;
+        for (const [place, link] of links.entries()) {
+            if (!isPlainObject(link) || typeof link['url'] !== 'string' || typeof link['text'] !== 'string')
+                return `link ${place + 1} of ${which} is not { url, text }`;
+            checkedLinks.push({ url: link['url'], text: link['text'] });
+        }
+        const time = timeOf(receivedAt);
+        if (time === undefined)
+            return `${which} has no receivedAt that reads as a time`;
+        messages.push({ subject, from, text, codes: codes.filter((code) => typeof code === 'string'), links: checkedLinks, receivedAt: time });
+    }
+    return messages;
+}
+function fieldProblem(which, key, field) {
+    return field === undefined ? `${which} has no ${key}` : `${which} has a ${key} that is ${kindOf(field)}, not text`;
+}
+function timeOf(value) {
+    const time = value instanceof Date ? value.getTime() : typeof value === 'number' ? value : typeof value === 'string' ? Date.parse(value) : Number.NaN;
+    return Number.isFinite(time) ? time : undefined;
+}
+// What a message holds, as the attempt tells two messages apart: two alike in every field are one message.
+function fingerprint(message) {
+    return JSON.stringify([message.receivedAt, message.subject, message.from, message.text, message.codes, message.links]);
+}
+function unknownInbox(name, declared) {
+    const known = declared.length === 0 ? 'This run has no inboxes.' : `The config's inboxes are ${declared.map((each) => JSON.stringify(each)).join(', ')}.`;
+    return failure('usage', `inbox(${JSON.stringify(name)}) is not one of the config's inboxes. ${known}`);
+}
+function subjectProblem(subject) {
+    if (subject === undefined || typeof subject === 'string')
+        return undefined;
+    const problem = patternProblem(subject);
+    return problem === undefined ? undefined : failure('usage', `latest() received a subject RegExp Retest cannot read: ${problem}.`);
+}
+function notGiven(what, inbox) {
+    return `This ${what} belongs to no message the inbox ${JSON.stringify(inbox)} gave this test, so Retest ${what === 'code' ? 'typed' : 'opened'} nothing.`;
+}
+// A read stopped while it waited ends as the reason it was stopped says.
+function stopped(inbox, reason) {
+    const parsed = parse(failureSchema, reason);
+    const cause = parsed.ok ? parsed.value : failure('interrupted', 'The read was stopped.');
+    return { ...cause, message: `${cause.message} Retest stopped reading the inbox ${JSON.stringify(inbox)}.` };
+}
+function stoppedFill(inbox, reason) {
+    const parsed = parse(failureSchema, reason);
+    const cause = parsed.ok ? parsed.value : failure('interrupted', 'The fill was stopped.');
+    const message = `${cause.message} Retest stopped waiting for the page to open an address for the code from the inbox ${JSON.stringify(inbox)}, and typed nothing.`;
+    return { class: cause.class, message, details: { ...cause.details, inputSent: false } };
+}
+function wrongCodeOrigin({ inbox, origin, allowed, electron }) {
+    const where = origin === undefined ? 'the page has not opened a web address yet' : `the page is on ${origin}`;
+    const none = electron ? 'no origin, since in an Electron app only the inbox\'s origins count and it lists none' : 'no origin, since no app the test uses has a base URL and the inbox lists no origins';
+    const permitted = allowed.length === 0 ? none : allowed.join(', ');
+    return `Retest did not type the code from the inbox ${JSON.stringify(inbox)}: ${where}, and it may be typed only on ${permitted}. Add the origin to the inbox's origins if it belongs there.`;
+}
+function refused(kind, message, details) {
+    return { ok: false, failure: { ...failure(kind, message), ...(details === undefined ? {} : { details }) } };
+}
+function refusedLink(kind, message) {
+    return { ok: false, failure: failure(kind, message) };
+}
+function count(amount, noun) {
+    return `${amount} ${noun}${amount === 1 ? '' : 's'}`;
+}
+function kindOf(value) {
+    if (value === null)
+        return 'null';
+    return Array.isArray(value) ? 'an array' : typeof value;
+}

package/dist/runner/index.d.ts

@@ -1,6 +1,7 @@
 export { LaunchError } from '../browser/contract.ts';
 export type { BrowserCommand, ContextCapability, DispatchedCommand, DriverName, InputDispatch, LaunchOptions, NativeKind, NavigationCapability, NewPageOptions, ObservationScope, OwnedBrowser, OwnedPage, PageNavigation, PageReading, ProxyOptions, ResolvedFill, RuntimeIdentity, Session, SessionIdentity, SessionOwner, SessionRuntime, StorageStateCapability, TargetKind, TextQuery, WebEngine, WebRuntime, WebRuntimeIdentity, WebSession, } from '../browser/contract.ts';
-export type { LoadedConfig } from '../config/loaded.ts';
+export type { LoadedConfig, LoadedInbox } from '../config/loaded.ts';
+export type { InboxContext, InboxMessage, InboxMessageLink, InboxReader, InboxSource } from '../config/types.ts';
 export { defaultTimeouts, mergeTimeouts } from '../protocol/timeouts.ts';
 export type { Timeouts } from '../protocol/timeouts.ts';
 export { validateConfig } from '../config/validate.ts';

package/dist/runner/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,aAAa,EACb,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,OAAO,EACP,eAAe,EACf,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,SAAS,EACT,UAAU,EACV,kBAAkB,EAClB,UAAU,GACX,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACxE,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,YAAY,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,YAAY,EACV,cAAc,EACd,WAAW,EACX,cAAc,EACd,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,cAAc,EACd,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,cAAc,EACd,OAAO,EACP,UAAU,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,SAAS,EACT,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,aAAa,GACd,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AACjE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAC/E,YAAY,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,aAAa,EACb,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,OAAO,EACP,eAAe,EACf,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,UAAU,EACV,SAAS,EACT,SAAS,EACT,UAAU,EACV,kBAAkB,EAClB,UAAU,GACX,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACpE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACxE,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,YAAY,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,YAAY,EACV,cAAc,EACd,WAAW,EACX,cAAc,EACd,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,cAAc,EACd,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,cAAc,EACd,OAAO,EACP,UAAU,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,SAAS,EACT,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,aAAa,GACd,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AACjE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAC/E,YAAY,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/runner/native-pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native-pool.d.ts","sourceRoot":"","sources":["../../src/runner/native-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,qBAAqB,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACzN,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,wBAAwB,CAAA;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAA;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACvG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAgB,gBAAgB,EAAE,aAAa,EAAkB,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC/H,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAiB,MAAM,+BAA+B,CAAA;AACnG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAU5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAA;AAE3E,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AASrD;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,GAAG;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAA;IAC3C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B,WAAW,CAAC,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAA;KAAE,GAAG;QAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CACnR,CAAA;AACD,MAAM,MAAM,oBAAoB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,CAAA;AACnM,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC,CAAA;AACzU,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG;QAAE,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAA;KAAE,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAA;AACzN,mHAAmH;AACnH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;AAChG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAA;IAC9E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3C,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACzC,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAA;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC,CAAA;IACxL,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;CACzC,CAAA;AAED,qGAAqG;AACrG,qBAAa,UAAU;;gBAWT,OAAO,EAAE,iBAAiB;IAEtC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IA8C9H,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAW5D,IAAI,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO;IAE5C;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAS7F,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IACnC,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;CAWlC;AAED,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAA;IAC7D,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;CACxC,CAAA;AAID,+GAA+G;AAC/G,qBAAa,oBAAqB,YAAW,YAAY;;gBAW3C,OAAO,EAAE,oBAAoB;IACzC,IAAI,IAAI,IAAI,iBAAiB,GAAG,SAAS,CAAsB;IAC/D,IAAI,MAAM,IAAI,kBAAkB,CAAgC;IAChE,IAAI,KAAK,IAAI,YAAY,CAA+B;IACxD,IAAI,QAAQ,IAAI,qBAAqB,GAAG;QAAE,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAA;KAAE,CAA6F;IACpL,IAAI,OAAO,IAAI,MAAM,CAAoI;IACzJ,IAAI,OAAO,IAAI,MAAM,CAAsD;IAC3E,IAAI,cAAc,IAAI,MAAM,CAAgD;IAC5E,IAAI,GAAG,IAAI,MAAM,CAA4C;IAC7D,IAAI,SAAS,IAAI,MAAM,CAAc;IACrC,IAAI,SAAS,IAAI,OAAO,CAA0E;IAClG,IAAI,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAA+B;IACzD,IAAI,aAAa,IAAI,mBAAmB,CAGvC;IACD,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAC5D,mHAAmH;IACnH,IAAI,WAAW,IAAI,OAAO,CAAoE;IAC9F;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAIjC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzC,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAerF,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAgExC;AAED,6HAA6H;AAC7H,qBAAa,iBAAkB,YAAW,SAAS;;IACjD,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAA;gBAE7B,MAAM,EAAE,wBAAwB;IAC5C,IAAI,gBAAgB,IAAI,mBAAmB,EAAE,CAK5C;IACD,qFAAqF;IACrF,IAAI,QAAQ,IAAI,MAAM,CAAsD;IAC5E,IAAI,GAAG,IAAI,SAAS,CAAqB;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAClF,IAAI,YAAY,IAAI,SAAS,CAAqB;IAClD,YAAY,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI;IACzE,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IACvD,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IACpD,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IACvB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE;QAAE,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,aAAa,CAAA;KAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IAkCpL,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;KAAE,GAAG;QAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/I,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,WAAW;IAClD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAC5C,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAChD;AAED,iHAAiH;AACjH,qBAAa,6BAA8B,SAAQ,wBAAwB;;gBAG7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,EAAE,UAAU;IAKxD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKxF,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;CAI3F;AAwCD,gHAAgH;AAChH,MAAM,MAAM,qBAAqB,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,mBAAmB,CAAC,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,YAAY,CAAC,KAAK,CAAA;CAAE,CAAA;AAIjI;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,GAAE,qBAAuC,GAAG,UAAU,CAAC,WAAW,CAAC,CAY5L"}
+{"version":3,"file":"native-pool.d.ts","sourceRoot":"","sources":["../../src/runner/native-pool.ts"],"names":[],"mappings":"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"}

package/dist/runner/native-pool.js

@@ -336,6 +336,8 @@ export class NativePageAdapter {
                 return unsupported(`Retest typed no secret into ${this.bundleId}: a secret reaches a native app only after Retest has checked that secretOrigins names its bundle id.`);
             return (await this.native.dispatch(command, timeoutMs, signal)).result;
         }
+        if (command.kind === 'observeLayout')
+            return unsupported('Layout matchers measure a web page, and a native app has no page layout to measure, so Retest measured nothing.');
         return unsupported(`${command.kind} is a web capability and is not available on a native app.`);
     }
     capture(timeoutMs) { return this.native.capture(timeoutMs); }

package/dist/runner/observations.d.ts

@@ -1,8 +1,11 @@
 import type { Observation, PageObservation } from '../protocol/commands.ts';
 import type { ChildEvent, EventBody } from '../protocol/events.ts';
 import type { Failure } from '../protocol/failures.ts';
+import type { LayoutLook } from '../protocol/layout.ts';
+import type { LayoutRequest } from '../protocol/layout-checks.ts';
 import type { CheckRecord, PageLook } from '../protocol/locator-checks.ts';
 import type { LocatorRecipe } from '../protocol/locator.ts';
+import type { ScreenshotLook, ScreenshotRequest } from '../protocol/screenshot.ts';
 import type { Redactor } from './redactor.ts';
 /** A page as an event records it: its origin and path, and its title when it has one. */
 export type PageFields = {
@@ -12,7 +15,7 @@ export type PageFields = {
 /**
  * A look the parent served: the app and locator it read, the session that served it, the observation as sent,
  * redacted and whole, and the page it read, as the look itself read it. A look at the page itself holds what it saw
- * of the page, as sent, and the app's base URL.
+ * of the page, as sent, and the app's base URL. A layout look holds what it was asked to measure and what it measured.
  */
 export type ServedObservation = (PageFields & {
     app: string;
@@ -23,7 +26,17 @@ export type ServedObservation = (PageFields & {
     app: string;
     sessionId: string;
     page: PageLook;
-};
+} | (PageFields & {
+    app: string;
+    sessionId: string;
+    request: LayoutRequest;
+    layout: LayoutLook;
+}) | (PageFields & {
+    app: string;
+    sessionId: string;
+    picture: ScreenshotRequest;
+    screenshot: ScreenshotLook;
+});
 /**
  * Where an assertion looked, as the parent knows it: its app, the session of that app's page in this attempt, and the
  * document the parent last saw that page commit, with its title when it has one.

package/dist/runner/observations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observations.d.ts","sourceRoot":"","sources":["../../src/runner/observations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAClE,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,yBAAyB,CAAA;AACrE,OAAO,KAAK,EAAE,WAAW,EAAuC,QAAQ,EAAE,MAAM,+BAA+B,CAAA;AAC/G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAS7C,yFAAyF;AACzF,MAAM,MAAM,UAAU,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjE;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GACzB,CAAC,UAAU,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;IAAC,WAAW,EAAE,WAAW,CAAA;CAAE,CAAC,GACnG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAA;AAEtD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG;IAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAExF,KAAK,aAAa,GAAG,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,CAAA;CAAE,CAAC,CAAA;AAC3F,KAAK,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,CAAA;CAAE,CAAC,CAAA;AAE1F,iHAAiH;AACjH,MAAM,MAAM,MAAM,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAExF;;;;;;;;;;GAUG;AACH,qBAAa,kBAAkB;;gBAIjB,QAAQ,CAAC,EAAE,QAAQ;IAI/B,2FAA2F;IAC3F,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;IAMxC;;;;;;;;;;OAUG;IACH,KAAK,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM;IA+E5D;;;;;;;;OAQG;IACH,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS;CA8B5E;AAeD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe,CAElE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAEzF"}
+{"version":3,"file":"observations.d.ts","sourceRoot":"","sources":["../../src/runner/observations.ts"],"names":[],"mappings":"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"}