personal-agent-benchmark 0.0.0-stage → 0.2.0

package/dist/src/replay/engine.js

@@ -0,0 +1,280 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReplayEngine = exports.CONTROL_HOST = void 0;
+exports.classify = classify;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const bundle_1 = require("../core/bundle");
+const lookup_1 = require("../core/lookup");
+const normalize_1 = require("../core/normalize");
+const rules_1 = require("../core/rules");
+const store_1 = require("../core/store");
+const util_1 = require("../core/util");
+const clock_1 = require("./clock");
+exports.CONTROL_HOST = 'rr.control';
+const STATIC_DESTS = new Set(['image', 'font', 'style', 'script', 'audio', 'video', 'track', 'manifest', 'object', 'embed', 'worker', 'sharedworker', 'serviceworker', 'paintworklet', 'audioworklet']);
+const DROP_RESPONSE_HEADERS = ['content-encoding', 'transfer-encoding', 'content-length', 'alt-svc', 'connection', 'keep-alive'];
+/**
+ * Answers every request from a recording bundle. It never opens a network connection:
+ * misses are answered locally and logged.
+ */
+class ReplayEngine {
+    bundle;
+    rules;
+    store;
+    manifest;
+    stats = emptyStats();
+    logFile;
+    clockMs;
+    constructor(bundleDir, opts = {}) {
+        this.bundle = new bundle_1.Bundle(path.resolve(bundleDir));
+        if (!this.bundle.isPacked())
+            throw new Error(`not a recording bundle: ${bundleDir}`);
+        this.manifest = this.bundle.manifest();
+        this.rules = rules_1.RuleSet.load([this.bundle.rulesDir, ...(opts.rulesDirs ?? [])]);
+        this.store = new store_1.RecordStore(this.bundle, this.rules);
+        this.logFile = opts.logFile;
+        if ((opts.clock ?? 'recorded') === 'recorded')
+            this.clockMs = Date.parse(this.manifest.captured_from);
+        if (this.logFile)
+            fs.mkdirSync(path.dirname(this.logFile), { recursive: true });
+    }
+    getStats() {
+        return JSON.parse(JSON.stringify(this.stats));
+    }
+    reset() {
+        this.stats = emptyStats();
+    }
+    async handle(req) {
+        const started = Date.now();
+        const url = new URL(req.url);
+        if (url.hostname === exports.CONTROL_HOST)
+            return this.control(url);
+        const method = req.method.toUpperCase();
+        const input = {
+            method: method === 'HEAD' ? 'GET' : method,
+            url: req.url,
+            contentType: (0, util_1.headerFromRecord)(req.headers, 'content-type'),
+            body: req.body,
+        };
+        const norm = (0, normalize_1.normalizeRequest)(input, this.rules);
+        const resourceClass = classify(req, norm);
+        let result;
+        try {
+            result = await this.resolve(req, input, norm, resourceClass);
+        }
+        catch (err) {
+            result = { resp: this.missResponse(resourceClass, norm, req), source: 'miss', detail: `error: ${err.message}` };
+        }
+        let resp = result.resp;
+        if (this.clockMs !== undefined && resourceClass === 'document' && (0, util_1.mimeOf)(resp.headers) === 'text/html' && method !== 'HEAD') {
+            const shifted = (0, clock_1.injectClock)(resp.body.toString('utf8'), resp.headers, this.clockMs);
+            resp = { ...resp, headers: shifted.headers, body: Buffer.from(shifted.html, 'utf8') };
+        }
+        const body = method === 'HEAD' ? Buffer.alloc(0) : resp.body;
+        const headers = (0, util_1.setHeader)((0, util_1.withoutHeaders)(resp.headers, DROP_RESPONSE_HEADERS), 'Content-Length', String(resp.body.length));
+        const out = {
+            status: resp.status,
+            statusText: resp.statusText,
+            headers,
+            body,
+            source: result.source,
+            key: norm.key,
+            kind: norm.kind,
+            resourceClass,
+            entryId: result.entryId,
+            detail: result.detail,
+        };
+        this.record(req, out, Date.now() - started);
+        return out;
+    }
+    async resolve(req, input, norm, resourceClass) {
+        if (norm.kind === 'block')
+            return { resp: empty(204), source: 'blocked' };
+        const found = (0, lookup_1.lookup)(this.store, norm);
+        if (found)
+            return { resp: await this.store.response(found.ix), source: found.source, entryId: found.ix.entry.id, detail: found.detail };
+        if (input.method === 'OPTIONS')
+            return { resp: preflight(req), source: 'preflight' };
+        return { resp: this.missResponse(resourceClass, norm, req), source: 'miss' };
+    }
+    missResponse(resourceClass, norm, req) {
+        if (resourceClass === 'tracker')
+            return empty(204);
+        if (resourceClass === 'static')
+            return { status: 404, statusText: 'Not Found', headers: [['Content-Type', 'text/plain']], body: Buffer.alloc(0) };
+        if (resourceClass === 'document') {
+            const notFound = this.notFoundPage(norm);
+            if (notFound)
+                return notFound;
+            const html = '<!doctype html><html><head><title>Page Not Found</title></head><body><h1>Page Not Found</h1></body></html>';
+            return { status: 404, statusText: 'Not Found', headers: [['Content-Type', 'text/html; charset=utf-8']], body: Buffer.from(html) };
+        }
+        const custom = norm.site?.xhr_not_found;
+        if (custom)
+            return { status: 404, statusText: 'Not Found', headers: [['Content-Type', custom.content_type]], body: Buffer.from(custom.body) };
+        const wantsJson = ((0, util_1.headerFromRecord)(req.headers, 'accept') ?? '').includes('json');
+        return wantsJson ? jsonResponse(404, {}) : { status: 404, statusText: 'Not Found', headers: [['Content-Type', 'text/plain']], body: Buffer.alloc(0) };
+    }
+    cachedNotFound = new Map();
+    notFoundPage(norm) {
+        const site = norm.site?.site;
+        if (!site)
+            return undefined;
+        const cached = this.cachedNotFound.get(site);
+        if (cached !== undefined)
+            return cached ?? undefined;
+        return undefined;
+    }
+    /** Loads each site's recorded 404 page once; call before serving. */
+    async warmUp() {
+        for (const [site, url] of Object.entries(this.manifest.not_found ?? {})) {
+            const ix = this.store.findByUrl(url);
+            if (!ix) {
+                this.cachedNotFound.set(site, null);
+                continue;
+            }
+            const resp = await this.store.response(ix);
+            this.cachedNotFound.set(site, { ...resp, status: 404, statusText: 'Not Found' });
+        }
+    }
+    control(url) {
+        let body;
+        switch (url.pathname) {
+            case '/health':
+                body = { ok: true, task: this.manifest.task_id, entries: this.store.all.length, captured_from: this.manifest.captured_from };
+                break;
+            case '/stats':
+                body = this.getStats();
+                break;
+            case '/reset':
+                this.reset();
+                body = { ok: true };
+                break;
+            default:
+                body = { error: 'unknown control path' };
+        }
+        const resp = jsonResponse(200, body);
+        return { ...resp, source: 'control', key: url.href, kind: 'browse', resourceClass: 'xhr' };
+    }
+    record(req, out, ms) {
+        const s = this.stats;
+        s.requests++;
+        s.bySource[out.source] = (s.bySource[out.source] ?? 0) + 1;
+        const c = s.byClass[out.resourceClass];
+        c.total++;
+        if (out.source === 'miss') {
+            c.miss++;
+            const m = (s.misses[out.key] ??= { count: 0, resourceClass: out.resourceClass, url: req.url });
+            m.count++;
+        }
+        else {
+            c.hit++;
+        }
+        if (this.logFile) {
+            const line = {
+                t: new Date().toISOString(),
+                method: req.method,
+                url: req.url,
+                key: out.key,
+                kind: out.kind,
+                class: out.resourceClass,
+                // what the browser loads it as: "document" is a page in a tab, "iframe" a frame inside one
+                dest: (0, util_1.headerFromRecord)(req.headers, 'sec-fetch-dest')?.toLowerCase(),
+                source: out.source,
+                status: out.status,
+                entry: out.entryId,
+                detail: out.detail,
+                ms,
+                // a missed request in full, so a rule fix can be worked out from the log
+                ...(out.source === 'miss' && req.body?.length ? { contentType: (0, util_1.headerFromRecord)(req.headers, 'content-type'), body: req.body.toString('base64') } : {}),
+            };
+            fs.appendFileSync(this.logFile, JSON.stringify(line) + '\n');
+        }
+    }
+}
+exports.ReplayEngine = ReplayEngine;
+function classify(req, norm) {
+    if (norm.kind === 'block')
+        return 'tracker';
+    const dest = ((0, util_1.headerFromRecord)(req.headers, 'sec-fetch-dest') ?? '').toLowerCase();
+    if (dest === 'document' || dest === 'iframe' || dest === 'frame')
+        return 'document';
+    if (STATIC_DESTS.has(dest))
+        return 'static';
+    if (dest === 'empty')
+        return 'xhr';
+    if (norm.kind === 'static')
+        return 'static';
+    const accept = (0, util_1.headerFromRecord)(req.headers, 'accept') ?? '';
+    if (req.method.toUpperCase() === 'GET' && accept.includes('text/html'))
+        return 'document';
+    return 'xhr';
+}
+function emptyStats() {
+    return {
+        requests: 0,
+        bySource: {},
+        byClass: {
+            document: { total: 0, hit: 0, miss: 0 },
+            xhr: { total: 0, hit: 0, miss: 0 },
+            static: { total: 0, hit: 0, miss: 0 },
+            tracker: { total: 0, hit: 0, miss: 0 },
+        },
+        misses: {},
+    };
+}
+function empty(status) {
+    return { status, statusText: '', headers: [], body: Buffer.alloc(0) };
+}
+function jsonResponse(status, value) {
+    return { status, statusText: '', headers: [['Content-Type', 'application/json; charset=utf-8'], ['Cache-Control', 'no-store']], body: Buffer.from(JSON.stringify(value)) };
+}
+function preflight(req) {
+    const origin = (0, util_1.headerFromRecord)(req.headers, 'origin') ?? '*';
+    const headers = [
+        ['Access-Control-Allow-Origin', origin],
+        ['Access-Control-Allow-Credentials', 'true'],
+        ['Access-Control-Allow-Methods', (0, util_1.headerFromRecord)(req.headers, 'access-control-request-method') ?? 'GET, POST, PUT, DELETE, OPTIONS'],
+        ['Access-Control-Max-Age', '600'],
+        ['Vary', 'Origin'],
+    ];
+    const reqHeaders = (0, util_1.headerFromRecord)(req.headers, 'access-control-request-headers');
+    if (reqHeaders)
+        headers.push(['Access-Control-Allow-Headers', reqHeaders]);
+    return { status: 204, statusText: 'No Content', headers, body: Buffer.alloc(0) };
+}
+//# sourceMappingURL=engine.js.map

package/dist/src/replay/engine.js.map

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

package/dist/src/replay/launcher.d.ts

@@ -0,0 +1,36 @@
+import { type ChildProcess } from 'node:child_process';
+import * as http from 'node:http';
+export interface ReplayServerOptions {
+    bundleDir: string;
+    port: number;
+    host?: string;
+    logFile?: string;
+    /** Rule directories layered over the bundle's own rules/ (later wins). */
+    rulesDirs?: string[];
+    /** whistle's data directory parent; defaults to a directory under the system temp dir. */
+    stateDir?: string;
+}
+export interface ReplayServer {
+    port: number;
+    proxy: string;
+    logFile?: string;
+    whistleLog: string;
+    child: ChildProcess;
+    control<T = unknown>(pathname: string): Promise<T>;
+    stop(): Promise<void>;
+}
+/** The single whistle rule: decrypt HTTPS and hand every request to the replay plugin. */
+export declare const REPLAY_RULES = "/./ enable://capture bench-replay://\n";
+/**
+ * Starts an isolated whistle instance (own data dir, no global plugins) with the replay plugin.
+ * Its DNS points at a dead address and proxy variables are removed, so a request that somehow
+ * bypassed the plugin could not reach the internet either.
+ */
+export declare function startReplayServer(o: ReplayServerOptions): Promise<ReplayServer>;
+/** GET a URL through the proxy and parse JSON. */
+export declare function proxiedJson<T>(port: number, url: string): Promise<T>;
+export declare function proxiedRequest(port: number, url: string, headers?: Record<string, string>): Promise<{
+    status: number;
+    headers: http.IncomingHttpHeaders;
+    body: Buffer;
+}>;

package/dist/src/replay/launcher.js

@@ -0,0 +1,163 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPLAY_RULES = void 0;
+exports.startReplayServer = startReplayServer;
+exports.proxiedJson = proxiedJson;
+exports.proxiedRequest = proxiedRequest;
+const node_child_process_1 = require("node:child_process");
+const node_crypto_1 = require("node:crypto");
+const fs = __importStar(require("node:fs"));
+const http = __importStar(require("node:http"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const paths_1 = require("../paths");
+const engine_1 = require("./engine");
+/** The single whistle rule: decrypt HTTPS and hand every request to the replay plugin. */
+exports.REPLAY_RULES = '/./ enable://capture bench-replay://\n';
+/**
+ * Starts an isolated whistle instance (own data dir, no global plugins) with the replay plugin.
+ * Its DNS points at a dead address and proxy variables are removed, so a request that somehow
+ * bypassed the plugin could not reach the internet either.
+ */
+async function startReplayServer(o) {
+    const baseDir = path.join(o.stateDir ?? path.join(os.tmpdir(), 'pab'), 'whistle', String(o.port));
+    fs.rmSync(baseDir, { recursive: true, force: true });
+    fs.mkdirSync(baseDir, { recursive: true });
+    const rulesFile = path.join(baseDir, 'replay.rules');
+    fs.writeFileSync(rulesFile, exports.REPLAY_RULES);
+    const whistleLog = path.join(baseDir, 'whistle.log');
+    const out = fs.openSync(whistleLog, 'a');
+    const env = { ...process.env, RR_BUNDLE: path.resolve(o.bundleDir), RR_LOG: o.logFile ? path.resolve(o.logFile) : '', RR_RULES: (o.rulesDirs ?? []).map((d) => path.resolve(d)).join(':'),
+        // inside an Electron app process.execPath is the app itself; this makes it behave as Node
+        ELECTRON_RUN_AS_NODE: '1',
+        // `whistle run` starts its server (STARTING_) and its plugins (PFORK_) with these binaries;
+        // unset, it spawns whatever "node" is on PATH, and an app opened from Finder has none
+        STARTING_EXEC_PATH: nodeBinary(),
+        PFORK_EXEC_PATH: nodeBinary(),
+    };
+    for (const k of ['HTTP_PROXY', 'HTTPS_PROXY', 'ALL_PROXY', 'http_proxy', 'https_proxy', 'all_proxy'])
+        delete env[k];
+    if (o.logFile) {
+        fs.mkdirSync(path.dirname(o.logFile), { recursive: true });
+        fs.rmSync(o.logFile, { force: true });
+    }
+    const whistleBin = require.resolve('whistle/bin/whistle.js');
+    const args = [
+        whistleBin,
+        'run',
+        '-p', String(o.port),
+        '-H', o.host ?? '127.0.0.1',
+        '-D', baseDir,
+        '-A', path.join(paths_1.PACKAGE_ROOT, 'plugins'),
+        '--no-global-plugins',
+        '--no-prev-options',
+        '-r', rulesFile,
+        '-n', 'rr',
+        '-w', (0, node_crypto_1.randomBytes)(12).toString('hex'),
+        '--dnsServer', '127.0.0.1:9',
+    ];
+    // whistle's `run` forks its real server; a separate process group lets stop() take both down.
+    const child = (0, node_child_process_1.spawn)(nodeBinary(), args, { env, stdio: ['ignore', out, out], detached: true });
+    const killGroup = (signal) => {
+        try {
+            if (child.pid)
+                process.kill(-child.pid, signal);
+        }
+        catch {
+            // already gone
+        }
+    };
+    const control = (pathname) => proxiedJson(o.port, `http://${engine_1.CONTROL_HOST}${pathname}`);
+    const deadline = Date.now() + 60_000;
+    for (;;) {
+        if (child.exitCode !== null)
+            throw new Error(`whistle exited (${child.exitCode}); see ${whistleLog}`);
+        try {
+            const health = await control('/health');
+            if (health.ok)
+                break;
+        }
+        catch {
+            // not up yet
+        }
+        if (Date.now() > deadline) {
+            killGroup('SIGTERM');
+            throw new Error(`replay server did not become healthy; see ${whistleLog}`);
+        }
+        await new Promise((r) => setTimeout(r, 500));
+    }
+    return {
+        port: o.port,
+        proxy: `http://127.0.0.1:${o.port}`,
+        logFile: o.logFile,
+        whistleLog,
+        child,
+        control,
+        stop: () => new Promise((resolve) => {
+            const done = () => {
+                killGroup('SIGTERM');
+                resolve();
+            };
+            if (child.exitCode !== null)
+                return done();
+            child.once('exit', done);
+            killGroup('SIGTERM');
+            setTimeout(() => killGroup('SIGKILL'), 5000).unref();
+        }),
+    };
+}
+/** The Node binary for whistle: RR_NODE when this process is not one (an Electron helper), else this one. */
+function nodeBinary() {
+    return process.env.RR_NODE || process.execPath;
+}
+/** GET a URL through the proxy and parse JSON. */
+function proxiedJson(port, url) {
+    return proxiedRequest(port, url).then((r) => JSON.parse(r.body.toString('utf8')));
+}
+function proxiedRequest(port, url, headers = {}) {
+    return new Promise((resolve, reject) => {
+        const u = new URL(url);
+        const req = http.request({ host: '127.0.0.1', port, method: 'GET', path: url, headers: { Host: u.host, ...headers }, timeout: 5000 }, (res) => {
+            const chunks = [];
+            res.on('data', (c) => chunks.push(c));
+            res.on('end', () => resolve({ status: res.statusCode ?? 0, headers: res.headers, body: Buffer.concat(chunks) }));
+        });
+        req.on('timeout', () => req.destroy(new Error('timeout')));
+        req.on('error', reject);
+        req.end();
+    });
+}
+//# sourceMappingURL=launcher.js.map

package/dist/src/replay/launcher.js.map

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

package/dist/src/replay/whistle-plugin.d.ts

@@ -0,0 +1,24 @@
+import { type IncomingMessage, type Server, type ServerResponse } from 'node:http';
+/**
+ * whistle plugin entry (whistle.bench-replay). The only whistle rule is
+ * `/./ enable://capture bench-replay://`, so every request arrives here and is
+ * answered from the bundle; nothing is forwarded upstream.
+ *
+ * Configuration comes from the environment of the whistle process:
+ *   RR_BUNDLE   bundle directory (required)
+ *   RR_LOG      JSONL request log (optional)
+ *   RR_RULES    extra rule directories, separated by ":" (optional)
+ *   RR_CLOCK    "off" to leave page clocks alone (default: shift them to the recording time)
+ */
+interface WhistleRequest extends IncomingMessage {
+    originalReq?: {
+        fullUrl?: string;
+        url?: string;
+        method?: string;
+        headers?: Record<string, string | string[]>;
+    };
+    fullUrl?: string;
+}
+export declare function handleWhistleRequest(req: WhistleRequest, res: ServerResponse): Promise<void>;
+export declare function server(srv: Server): void;
+export {};

package/dist/src/replay/whistle-plugin.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleWhistleRequest = handleWhistleRequest;
+exports.server = server;
+const node_http_1 = require("node:http");
+const engine_1 = require("./engine");
+let enginePromise;
+function engine() {
+    if (!enginePromise) {
+        enginePromise = (async () => {
+            const bundle = process.env.RR_BUNDLE;
+            if (!bundle)
+                throw new Error('RR_BUNDLE is not set for the whistle process');
+            const e = new engine_1.ReplayEngine(bundle, {
+                logFile: process.env.RR_LOG || undefined,
+                rulesDirs: (process.env.RR_RULES ?? '').split(':').filter(Boolean),
+                clock: process.env.RR_CLOCK === 'off' ? 'off' : 'recorded',
+            });
+            await e.warmUp();
+            return e;
+        })();
+    }
+    return enginePromise;
+}
+function cleanHeaders(headers) {
+    const out = {};
+    for (const [k, v] of Object.entries(headers)) {
+        const lower = k.toLowerCase();
+        if (lower.startsWith('x-whistle') || lower.startsWith('x-forwarded-') || lower === 'proxy-connection')
+            continue;
+        out[k] = v;
+    }
+    return out;
+}
+/** Framing of the recorded connection; replay frames its own responses (Content-Length, no trailers). */
+const FRAMING_HEADERS = new Set(['connection', 'keep-alive', 'proxy-connection', 'te', 'trailer', 'transfer-encoding', 'upgrade']);
+/**
+ * Headers as Node sends them. Node refuses a whole response for one header it cannot send (a bad
+ * name, control characters, characters beyond Latin-1, a Trailer on a response with a length), so
+ * such a header is left out instead.
+ */
+function toNodeHeaders(list) {
+    const out = {};
+    for (const [k, v] of list) {
+        if (FRAMING_HEADERS.has(k.toLowerCase()))
+            continue;
+        try {
+            (0, node_http_1.validateHeaderName)(k);
+            (0, node_http_1.validateHeaderValue)(k, v);
+        }
+        catch {
+            continue;
+        }
+        const prev = out[k];
+        out[k] = prev === undefined ? v : Array.isArray(prev) ? [...prev, v] : [prev, v];
+    }
+    return out;
+}
+async function handleWhistleRequest(req, res) {
+    const chunks = [];
+    for await (const chunk of req)
+        chunks.push(chunk);
+    const url = req.originalReq?.fullUrl ?? req.fullUrl ?? req.url ?? '';
+    const method = req.originalReq?.method ?? req.method ?? 'GET';
+    try {
+        const e = await engine();
+        const out = await e.handle({ method, url, headers: cleanHeaders(req.headers), body: chunks.length ? Buffer.concat(chunks) : undefined });
+        res.writeHead(out.status, out.statusText || undefined, toNodeHeaders(out.headers));
+        res.end(out.body);
+    }
+    catch (err) {
+        res.writeHead(502, { 'Content-Type': 'text/plain' });
+        res.end(`replay error: ${err.message}`);
+    }
+}
+function server(srv) {
+    void engine().catch((err) => console.error('[bench-replay]', err));
+    srv.on('request', (req, res) => {
+        void handleWhistleRequest(req, res);
+    });
+}
+//# sourceMappingURL=whistle-plugin.js.map

package/dist/src/replay/whistle-plugin.js.map

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

package/dist/src/report.d.ts

@@ -0,0 +1,3 @@
+import type { RunResult } from './scoring';
+/** report.html: a self-contained page rendered from result.json. */
+export declare function renderReport(r: RunResult): string;