@siteverb/runner 0.1.0-rc.0

package/README.md

@@ -0,0 +1,34 @@
+# @siteverb/runner
+
+Deterministic real-browser execution for `siteverb.webmcp.json` contracts.
+
+```sh
+npx @siteverb/runner \
+  --contract siteverb.webmcp.json \
+  --url http://127.0.0.1:3000 \
+  --output .siteverb/report.json
+```
+
+The runner launches a named Chrome channel with WebMCP enabled, opens a fresh page for each journey,
+refreshes the native tool inventory before every step, executes through Puppeteer's official
+`page.webmcp` API, checks bounded result/URL/DOM postconditions, attempts cleanup, and writes a
+versioned evidence report.
+
+Targets must be absolute HTTP(S) URLs. Per-navigation, tool, and postcondition timeouts are bounded
+to 1-600,000 milliseconds and validated with journey/profile filters before browser acquisition.
+
+Journey steps fail fast. Cleanup is best-effort: every declared cleanup step is attempted even when
+an earlier one fails, and any cleanup failure still fails the journey.
+
+Add `--profile chatgpt-site-tools-2026-08-26` to include a dated documented compatibility
+assessment. This never upgrades documented behavior to real-client evidence.
+
+Mutating tools do not run unless `--allow-mutations` is present. A stable tool ID listed in a
+journey's `requireHumanBefore` policy also requires `--approve <stable-id>`. Use these flags only
+against an explicitly approved local, preview, or seeded test target.
+
+The default report excludes prompts, inputs, tool outputs, DOM snapshots, cookies, and credentials.
+It records browser provenance, step status, duration, and Siteverb-generated failure categories.
+The persisted target is reduced to its origin; path, query, fragment, and URL credentials are omitted.
+`--include-error-details` opts a local run into bounded page-provided error messages; do not use it
+for shared CI artifacts unless those messages are independently redacted.

package/dist/assertions.d.ts

@@ -0,0 +1,4 @@
+import type { StepExpectation } from '@siteverb/contracts';
+import type { BrowserPageAdapter } from './types.js';
+export declare function assertStepExpectation(page: BrowserPageAdapter, output: unknown, expectation: StepExpectation | undefined): Promise<string | undefined>;
+//# sourceMappingURL=assertions.d.ts.map

package/dist/assertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../src/assertions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAEhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAiFrD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,eAAe,GAAG,SAAS,GACvC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B"}

package/dist/assertions.js

@@ -0,0 +1,92 @@
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function deepEqual(actual, expected) {
+    if (Object.is(actual, expected))
+        return true;
+    if (Array.isArray(actual) && Array.isArray(expected)) {
+        return (actual.length === expected.length &&
+            actual.every((entry, index) => deepEqual(entry, expected[index])));
+    }
+    if (isRecord(actual) && isRecord(expected)) {
+        const actualKeys = Object.keys(actual).sort();
+        const expectedKeys = Object.keys(expected).sort();
+        return (deepEqual(actualKeys, expectedKeys) &&
+            expectedKeys.every((key) => deepEqual(actual[key], expected[key])));
+    }
+    return false;
+}
+function deepContains(actual, expected) {
+    if (isRecord(expected)) {
+        if (!isRecord(actual))
+            return false;
+        return Object.entries(expected).every(([key, value]) => deepContains(actual[key], value));
+    }
+    if (Array.isArray(expected)) {
+        if (!Array.isArray(actual) || actual.length < expected.length)
+            return false;
+        return expected.every((entry, index) => deepContains(actual[index], entry));
+    }
+    return Object.is(actual, expected);
+}
+function normalizeOutput(output) {
+    if (typeof output !== 'string')
+        return output;
+    try {
+        return JSON.parse(output);
+    }
+    catch {
+        return output;
+    }
+}
+function assertResult(output, expectation) {
+    const normalized = normalizeOutput(output);
+    if (expectation.equals !== undefined && !deepEqual(normalized, expectation.equals)) {
+        return 'Tool result did not exactly match the configured expectation.';
+    }
+    if (expectation.contains !== undefined && !deepContains(normalized, expectation.contains)) {
+        return 'Tool result did not contain the configured expectation.';
+    }
+    return undefined;
+}
+function assertUrl(actual, expectation) {
+    const url = new URL(actual);
+    if (expectation.pathname !== undefined && url.pathname !== expectation.pathname) {
+        return `Browser pathname did not match the configured value "${expectation.pathname}".`;
+    }
+    for (const [name, value] of Object.entries(expectation.searchParams ?? {})) {
+        if (url.searchParams.get(name) !== value) {
+            return `Browser URL parameter "${name}" did not match the configured value.`;
+        }
+    }
+    return undefined;
+}
+async function assertDom(page, expectations) {
+    for (const expectation of expectations) {
+        const failure = await page.inspectDom(expectation);
+        if (failure)
+            return failure;
+    }
+    return undefined;
+}
+export async function assertStepExpectation(page, output, expectation) {
+    if (!expectation)
+        return undefined;
+    if (expectation.result) {
+        const failure = assertResult(output, expectation.result);
+        if (failure)
+            return failure;
+    }
+    if (expectation.url) {
+        const failure = assertUrl(page.currentUrl(), expectation.url);
+        if (failure)
+            return failure;
+    }
+    if (expectation.dom) {
+        const failure = await assertDom(page, expectation.dom);
+        if (failure)
+            return failure;
+    }
+    return undefined;
+}
+//# sourceMappingURL=assertions.js.map

package/dist/assertions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.js","sourceRoot":"","sources":["../src/assertions.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+import { readFile, mkdir, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+import { parseProjectContract } from '@siteverb/contracts';
+import { runProject } from './run.js';
+const HELP = `Usage: siteverb-run --contract <path> --url <url> [options]
+
+Options:
+  --output <path>          Report path (default: .siteverb/report.json)
+  --journey <ids>         Comma-separated journey IDs
+  --profile <ids>         Comma-separated versioned client profile IDs
+  --chrome-channel <name> chrome, chrome-beta, chrome-canary, or chrome-dev
+  --executable-path <path> Explicit Chrome executable
+  --timeout <ms>           Navigation and tool timeout (default: 30000)
+  --allow-mutations        Permit reversible/state-changing tools on this target
+  --approve <tool-ids>     Comma-separated stable IDs approved for guarded steps
+  --include-error-details  Include page-provided error messages in the local report
+  --headed                 Show the browser window
+  --help                   Show this message
+`;
+function commaList(value) {
+    if (!value)
+        return undefined;
+    const entries = value
+        .split(',')
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+    return entries.length > 0 ? entries : undefined;
+}
+function positiveInteger(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed <= 0)
+        throw new TypeError('timeout must be positive.');
+    return parsed;
+}
+const { values } = parseArgs({
+    options: {
+        contract: { type: 'string', short: 'c' },
+        url: { type: 'string', short: 'u' },
+        output: { type: 'string', short: 'o', default: '.siteverb/report.json' },
+        journey: { type: 'string' },
+        profile: { type: 'string' },
+        'chrome-channel': { type: 'string', default: 'chrome' },
+        'executable-path': { type: 'string' },
+        timeout: { type: 'string', default: '30000' },
+        'allow-mutations': { type: 'boolean', default: false },
+        approve: { type: 'string' },
+        'include-error-details': { type: 'boolean', default: false },
+        headed: { type: 'boolean', default: false },
+        help: { type: 'boolean', short: 'h', default: false },
+    },
+    strict: true,
+    allowPositionals: false,
+});
+if (values.help) {
+    process.stdout.write(HELP);
+    process.exit(0);
+}
+if (!values.contract || !values.url) {
+    process.stderr.write(`${HELP}\nBoth --contract and --url are required.\n`);
+    process.exit(2);
+}
+try {
+    const contractPath = resolve(values.contract);
+    const outputPath = resolve(values.output);
+    const contract = parseProjectContract(JSON.parse(await readFile(contractPath, 'utf8')));
+    const journeyIds = commaList(values.journey);
+    const profileIds = commaList(values.profile);
+    const approvedTools = commaList(values.approve);
+    const report = await runProject({
+        contract,
+        targetUrl: values.url,
+        channel: values['chrome-channel'],
+        headless: !values.headed,
+        timeoutMs: positiveInteger(values.timeout, 30_000),
+        allowMutations: values['allow-mutations'],
+        includeErrorDetails: values['include-error-details'],
+        ...(values['executable-path'] === undefined
+            ? {}
+            : { executablePath: values['executable-path'] }),
+        ...(journeyIds === undefined ? {} : { journeyIds }),
+        ...(profileIds === undefined ? {} : { profileIds }),
+        ...(approvedTools === undefined ? {} : { approvedTools }),
+    });
+    await mkdir(dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, `${JSON.stringify(report, null, 2)}\n`);
+    process.stdout.write(`Siteverb: ${report.summary.passed} passed, ${report.summary.failed} failed, ${report.summary.skipped} skipped\nReport: ${outputPath}\n`);
+    process.exitCode = report.summary.failed > 0 ? 1 : 0;
+}
+catch (error) {
+    process.stderr.write(`Siteverb runner failed: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 2;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { assertStepExpectation } from './assertions.js';
+export { launchBrowser } from './puppeteer.js';
+export { runProject } from './run.js';
+export { RUNNER_VERSION } from './version.js';
+export type { BrowserAdapter, BrowserPageAdapter, BrowserTool, BrowserToolResult, LaunchBrowserOptions, RunProjectOptions, RunReport, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { assertStepExpectation } from './assertions.js';
+export { launchBrowser } from './puppeteer.js';
+export { runProject } from './run.js';
+export { RUNNER_VERSION } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/puppeteer.d.ts

@@ -0,0 +1,3 @@
+import type { BrowserAdapter, LaunchBrowserOptions } from './types.js';
+export declare function launchBrowser(options?: LaunchBrowserOptions): Promise<BrowserAdapter>;
+//# sourceMappingURL=puppeteer.d.ts.map

package/dist/puppeteer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer.d.ts","sourceRoot":"","sources":["../src/puppeteer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,cAAc,EAGd,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAsHpB,wBAAsB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC,CAE/F"}

package/dist/puppeteer.js

@@ -0,0 +1,101 @@
+import puppeteer, {} from 'puppeteer-core';
+function browserName(version) {
+    return version.split('/')[0] || 'Chrome';
+}
+function browserVersion(version) {
+    return version.split('/')[1] || version;
+}
+function executionError(result) {
+    if (result.errorText?.trim())
+        return result.errorText.trim();
+    if (result.exception?.description?.trim())
+        return result.exception.description.trim();
+    return 'The browser reported a WebMCP execution error without details.';
+}
+class PuppeteerPageAdapter {
+    #page;
+    constructor(page) {
+        this.#page = page;
+    }
+    async close() {
+        await this.#page.close();
+    }
+    currentUrl() {
+        return this.#page.url();
+    }
+    async executeTool(name, input, signal) {
+        const tool = this.#page.webmcp.tools().find((candidate) => candidate.name === name);
+        if (!tool)
+            return { status: 'error', error: `WebMCP tool "${name}" is unavailable.` };
+        const result = await tool.execute(input, signal ? { signal } : undefined);
+        if (result.status === 'Completed')
+            return { status: 'completed', output: result.output };
+        return { status: 'error', error: executionError(result) };
+    }
+    async goto(url, timeoutMs) {
+        await this.#page.goto(url, { timeout: timeoutMs, waitUntil: 'networkidle2' });
+    }
+    async inspectDom(expectation) {
+        const element = await this.#page.$(expectation.selector);
+        if (expectation.state === 'detached') {
+            return element ? `Expected "${expectation.selector}" to be detached.` : undefined;
+        }
+        if (!element)
+            return `Expected "${expectation.selector}" to be attached.`;
+        if (expectation.state === 'visible' && !(await element.isVisible())) {
+            return `Expected "${expectation.selector}" to be visible.`;
+        }
+        if (expectation.state === 'hidden' && !(await element.isHidden())) {
+            return `Expected "${expectation.selector}" to be hidden.`;
+        }
+        if (expectation.textContains !== undefined) {
+            const text = await element.evaluate((node) => node.textContent ?? '');
+            if (!text.includes(expectation.textContains)) {
+                return `Expected "${expectation.selector}" text to contain the configured value.`;
+            }
+        }
+        if (expectation.attribute) {
+            const actual = await element.evaluate((node, name) => node.getAttribute(name), expectation.attribute.name);
+            if (actual !== expectation.attribute.equals) {
+                return `Expected "${expectation.selector}" attribute "${expectation.attribute.name}" to equal the configured value.`;
+            }
+        }
+        return undefined;
+    }
+    async listTools() {
+        return this.#page.webmcp.tools().map((tool) => ({ name: tool.name }));
+    }
+}
+class PuppeteerBrowserAdapter {
+    #browser;
+    channel;
+    name;
+    version;
+    constructor(browser, channel, version) {
+        this.#browser = browser;
+        this.channel = channel;
+        this.name = browserName(version);
+        this.version = browserVersion(version);
+    }
+    static async launch(options = {}) {
+        const channel = options.channel ?? 'chrome';
+        const browser = await puppeteer.launch({
+            browser: 'chrome',
+            channel,
+            headless: options.headless ?? true,
+            ...(options.executablePath === undefined ? {} : { executablePath: options.executablePath }),
+            args: ['--enable-features=WebMCP'],
+        });
+        return new PuppeteerBrowserAdapter(browser, channel, await browser.version());
+    }
+    async close() {
+        await this.#browser.close();
+    }
+    async newPage() {
+        return new PuppeteerPageAdapter(await this.#browser.newPage());
+    }
+}
+export async function launchBrowser(options = {}) {
+    return PuppeteerBrowserAdapter.launch(options);
+}
+//# sourceMappingURL=puppeteer.js.map

package/dist/puppeteer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer.js","sourceRoot":"","sources":["../src/puppeteer.ts"],"names":[],"mappings":"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"}

package/dist/run.d.ts

@@ -0,0 +1,4 @@
+import type { RunReport } from '@siteverb/contracts';
+import type { RunProjectOptions } from './types.js';
+export declare function runProject(options: RunProjectOptions): Promise<RunReport>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAIV,SAAS,EAEV,MAAM,qBAAqB,CAAC;AAK7B,OAAO,KAAK,EAAyC,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA6Q3F,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,CAmD/E"}

package/dist/run.js

@@ -0,0 +1,287 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { parseRunReport } from '@siteverb/contracts';
+import { assessCompatibility, getClientProfile } from '@siteverb/profiles';
+import { assertStepExpectation } from './assertions.js';
+import { launchBrowser } from './puppeteer.js';
+import { RUNNER_VERSION } from './version.js';
+const DEFAULT_TIMEOUT_MS = 30_000;
+const MAX_TIMEOUT_MS = 600_000;
+class RunnerTimeoutError extends Error {
+    name = 'RunnerTimeoutError';
+}
+function reportError(error, includeDetails, fallback) {
+    if (error instanceof RunnerTimeoutError)
+        return error.message;
+    if (!includeDetails)
+        return fallback;
+    const message = error instanceof Error
+        ? error.message || error.name
+        : typeof error === 'string'
+            ? error
+            : fallback;
+    return message.replaceAll(/[\u0000-\u001f\u007f]+/g, ' ').slice(0, 4_000) || fallback;
+}
+async function withTimeout(label, timeoutMs, operation) {
+    const controller = new AbortController();
+    const timeoutError = new RunnerTimeoutError(`${label} timed out after ${timeoutMs} ms.`);
+    const timer = setTimeout(() => controller.abort(timeoutError), timeoutMs);
+    try {
+        return await Promise.race([
+            operation(controller.signal),
+            new Promise((_, reject) => {
+                controller.signal.addEventListener('abort', () => reject(controller.signal.reason), {
+                    once: true,
+                });
+            }),
+        ]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function stableJson(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(stableJson).join(',')}]`;
+    const record = value;
+    return `{${Object.keys(record)
+        .sort()
+        .map((key) => `${JSON.stringify(key)}:${stableJson(record[key])}`)
+        .join(',')}}`;
+}
+function contractHash(contract) {
+    return `sha256:${createHash('sha256').update(stableJson(contract)).digest('hex')}`;
+}
+function reportTargetUrl(targetUrl) {
+    const url = new URL(targetUrl);
+    return `${url.origin}/`;
+}
+function validateRunOptions(options) {
+    let target;
+    try {
+        target = new URL(options.targetUrl);
+    }
+    catch {
+        throw new TypeError('targetUrl must be an absolute HTTP or HTTPS URL.');
+    }
+    if (target.protocol !== 'http:' && target.protocol !== 'https:') {
+        throw new TypeError('targetUrl must be an absolute HTTP or HTTPS URL.');
+    }
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0 || timeoutMs > MAX_TIMEOUT_MS) {
+        throw new TypeError(`timeoutMs must be an integer from 1 to ${MAX_TIMEOUT_MS}.`);
+    }
+    if ((options.profileIds?.length ?? 0) > 20) {
+        throw new TypeError('At most 20 client profiles may be assessed in one run.');
+    }
+    if (options.profileIds && new Set(options.profileIds).size !== options.profileIds.length) {
+        throw new TypeError('Client profile IDs must be unique.');
+    }
+}
+async function waitForTool(page, name, timeoutMs) {
+    const startedAt = Date.now();
+    while (Date.now() - startedAt < Math.min(timeoutMs, 5_000)) {
+        if ((await page.listTools()).some((tool) => tool.name === name))
+            return true;
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    return false;
+}
+async function runStep(context, step, index) {
+    const startedAt = Date.now();
+    const tool = context.contract.tools.find((candidate) => candidate.id === step.tool);
+    if (!tool) {
+        return {
+            index,
+            toolId: step.tool,
+            toolName: 'unknown',
+            status: 'failed',
+            durationMs: Date.now() - startedAt,
+            error: `Contract tool "${step.tool}" is unavailable.`,
+        };
+    }
+    if (tool.risk !== 'read-only' && !context.allowMutations) {
+        return {
+            index,
+            toolId: tool.id,
+            toolName: tool.name,
+            status: 'failed',
+            durationMs: Date.now() - startedAt,
+            error: `Mutation denied for "${tool.id}". Enable mutations only for an approved test target.`,
+        };
+    }
+    if (context.journey.policy.requireHumanBefore.includes(tool.id) &&
+        !context.approvedTools.has(tool.id)) {
+        return {
+            index,
+            toolId: tool.id,
+            toolName: tool.name,
+            status: 'failed',
+            durationMs: Date.now() - startedAt,
+            error: `Explicit approval is required before invoking "${tool.id}".`,
+        };
+    }
+    if (!(await waitForTool(context.page, tool.name, context.timeoutMs))) {
+        return {
+            index,
+            toolId: tool.id,
+            toolName: tool.name,
+            status: 'failed',
+            durationMs: Date.now() - startedAt,
+            error: `WebMCP tool "${tool.name}" is not registered in the current page state.`,
+        };
+    }
+    try {
+        const result = await withTimeout(`Tool "${tool.name}"`, context.timeoutMs, (signal) => context.page.executeTool(tool.name, step.input, signal));
+        if (result.status === 'error') {
+            return {
+                index,
+                toolId: tool.id,
+                toolName: tool.name,
+                status: 'failed',
+                durationMs: Date.now() - startedAt,
+                error: reportError(result.error, context.includeErrorDetails, 'The browser reported a WebMCP execution failure.'),
+            };
+        }
+        const assertionFailure = await withTimeout(`Postconditions for "${tool.name}"`, context.timeoutMs, () => assertStepExpectation(context.page, result.output, step.expect));
+        return {
+            index,
+            toolId: tool.id,
+            toolName: tool.name,
+            status: assertionFailure ? 'failed' : 'passed',
+            durationMs: Date.now() - startedAt,
+            ...(assertionFailure ? { error: assertionFailure } : {}),
+        };
+    }
+    catch (error) {
+        return {
+            index,
+            toolId: tool.id,
+            toolName: tool.name,
+            status: 'failed',
+            durationMs: Date.now() - startedAt,
+            error: reportError(error, context.includeErrorDetails, 'WebMCP tool execution failed.'),
+        };
+    }
+}
+async function runSteps(context, steps, stopOnFailure = true) {
+    const reports = [];
+    for (const [offset, step] of steps.entries()) {
+        const report = await runStep(context, step, offset + 1);
+        reports.push(report);
+        if (stopOnFailure && report.status === 'failed')
+            break;
+    }
+    return reports;
+}
+async function runJourney(contract, journey, page, options) {
+    const startedAt = Date.now();
+    const context = {
+        allowMutations: options.allowMutations ?? false,
+        approvedTools: new Set(options.approvedTools ?? []),
+        contract,
+        journey,
+        page,
+        includeErrorDetails: options.includeErrorDetails ?? false,
+        targetUrl: options.targetUrl,
+        timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+    };
+    const steps = [];
+    const cleanup = [];
+    let setupError;
+    try {
+        await page.goto(new URL(journey.start, options.targetUrl).href, context.timeoutMs);
+        steps.push(...(await runSteps(context, journey.steps)));
+    }
+    catch (error) {
+        setupError = reportError(error, context.includeErrorDetails, 'Journey setup failed.');
+    }
+    finally {
+        if (journey.cleanup)
+            cleanup.push(...(await runSteps(context, journey.cleanup, false)));
+    }
+    const failed = Boolean(setupError ||
+        steps.some((step) => step.status === 'failed') ||
+        cleanup.some((step) => step.status === 'failed'));
+    return {
+        id: journey.id,
+        name: journey.name,
+        status: failed ? 'failed' : 'passed',
+        durationMs: Date.now() - startedAt,
+        steps,
+        cleanup,
+        ...(setupError ? { error: setupError } : {}),
+    };
+}
+function selectJourneys(contract, ids) {
+    if (!ids?.length)
+        return contract.journeys;
+    const requested = new Set(ids);
+    const unknown = ids.filter((id) => !contract.journeys.some((journey) => journey.id === id));
+    if (unknown.length > 0)
+        throw new TypeError(`Unknown journey ids: ${unknown.join(', ')}`);
+    return contract.journeys.filter((journey) => requested.has(journey.id));
+}
+function assessProfiles(contract, ids) {
+    if (!ids?.length)
+        return [];
+    return ids.map((id) => {
+        const profile = getClientProfile(id);
+        if (!profile)
+            throw new TypeError(`Unknown client profile id: ${id}`);
+        return assessCompatibility(contract, profile);
+    });
+}
+export async function runProject(options) {
+    const startedAt = new Date();
+    validateRunOptions(options);
+    const selectedJourneys = selectJourneys(options.contract, options.journeyIds);
+    const compatibility = assessProfiles(options.contract, options.profileIds);
+    const browser = options.browser ??
+        (await launchBrowser({
+            ...(options.channel === undefined ? {} : { channel: options.channel }),
+            ...(options.executablePath === undefined ? {} : { executablePath: options.executablePath }),
+            ...(options.headless === undefined ? {} : { headless: options.headless }),
+        }));
+    const journeys = [];
+    try {
+        for (const journey of selectedJourneys) {
+            const page = await browser.newPage();
+            try {
+                journeys.push(await runJourney(options.contract, journey, page, options));
+            }
+            finally {
+                await page.close();
+            }
+        }
+    }
+    finally {
+        await browser.close();
+    }
+    const report = {
+        version: 1,
+        runId: randomUUID(),
+        startedAt: startedAt.toISOString(),
+        finishedAt: new Date().toISOString(),
+        targetUrl: reportTargetUrl(options.targetUrl),
+        project: options.contract.project,
+        contractHash: contractHash(options.contract),
+        runner: { name: '@siteverb/runner', version: RUNNER_VERSION },
+        browser: {
+            name: browser.name,
+            version: browser.version,
+            channel: browser.channel,
+            evidence: 'real-browser',
+        },
+        summary: {
+            passed: journeys.filter((journey) => journey.status === 'passed').length,
+            failed: journeys.filter((journey) => journey.status === 'failed').length,
+            skipped: 0,
+        },
+        compatibility,
+        journeys,
+    };
+    return parseRunReport(report);
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,53 @@
+import type { DomExpectation, JourneyContract, ProjectContract, RunReport } from '@siteverb/contracts';
+import type { ChromeReleaseChannel } from 'puppeteer-core';
+export interface BrowserTool {
+    readonly name: string;
+}
+export interface BrowserToolResult {
+    readonly error?: string;
+    readonly output?: unknown;
+    readonly status: 'completed' | 'error';
+}
+export interface BrowserPageAdapter {
+    close(): Promise<void>;
+    currentUrl(): string;
+    executeTool(name: string, input: Record<string, unknown>, signal?: AbortSignal): Promise<BrowserToolResult>;
+    goto(url: string, timeoutMs: number): Promise<void>;
+    inspectDom(expectation: DomExpectation): Promise<string | undefined>;
+    listTools(): Promise<readonly BrowserTool[]>;
+}
+export interface BrowserAdapter {
+    readonly channel: string;
+    readonly name: string;
+    readonly version: string;
+    close(): Promise<void>;
+    newPage(): Promise<BrowserPageAdapter>;
+}
+export interface LaunchBrowserOptions {
+    readonly channel?: ChromeReleaseChannel;
+    readonly executablePath?: string;
+    readonly headless?: boolean;
+    readonly includeErrorDetails?: boolean;
+}
+export interface RunProjectOptions extends LaunchBrowserOptions {
+    readonly allowMutations?: boolean;
+    readonly approvedTools?: readonly string[];
+    readonly browser?: BrowserAdapter;
+    readonly contract: ProjectContract;
+    readonly journeyIds?: readonly string[];
+    readonly profileIds?: readonly string[];
+    readonly targetUrl: string;
+    readonly timeoutMs?: number;
+}
+export interface RunJourneyContext {
+    readonly allowMutations: boolean;
+    readonly approvedTools: ReadonlySet<string>;
+    readonly contract: ProjectContract;
+    readonly journey: JourneyContract;
+    readonly page: BrowserPageAdapter;
+    readonly includeErrorDetails: boolean;
+    readonly targetUrl: string;
+    readonly timeoutMs: number;
+}
+export type { RunReport };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,eAAe,EACf,SAAS,EACV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,UAAU,IAAI,MAAM,CAAC;IACrB,WAAW,CACT,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,UAAU,CAAC,WAAW,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACrE,SAAS,IAAI,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,YAAY,EAAE,SAAS,EAAE,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const RUNNER_VERSION = "0.1.0-rc.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,eAAe,CAAC"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const RUNNER_VERSION = '0.1.0-rc.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@siteverb/runner",
+  "version": "0.1.0-rc.0",
+  "description": "Deterministic real-browser runner for Siteverb WebMCP journey contracts.",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "bin": {
+    "siteverb-run": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "package:check": "publint && attw --pack . --profile esm-only",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "keywords": [
+    "webmcp",
+    "browser-testing",
+    "puppeteer",
+    "github-actions"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/siteverb/siteverb.git",
+    "directory": "packages/runner"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@siteverb/contracts": "^0.1.0-rc.0",
+    "@siteverb/profiles": "^0.1.0-rc.0",
+    "puppeteer-core": "25.9.0"
+  }
+}