prose-qa 0.1.0

package/dist/recorder/bridge-worker.js

@@ -0,0 +1,76 @@
+/**
+ * Detached bridge process: stays alive after `pqa record start` exits so the
+ * browser can POST events until `pqa record stop`.
+ *
+ * Usage: tsx bridge-worker.ts --dir <recordingDir> --port <port> --cwd <projectRoot> [--config <path>]
+ */
+import { loadConfig, resolveSensitiveEnvVars } from "../config/load.js";
+import { enqueueEnrichedAppend } from "./enrich-event.js";
+import { startRecordingBridge } from "./bridge.js";
+function parseArgs(argv) {
+    let dir = "";
+    let port = 17_321;
+    let cwd = process.cwd();
+    let configPath;
+    for (let i = 2; i < argv.length; i++) {
+        const arg = argv[i];
+        const next = argv[i + 1];
+        if (arg === "--dir" && next) {
+            dir = next;
+            i++;
+            continue;
+        }
+        if (arg === "--port" && next) {
+            port = Number(next);
+            i++;
+            continue;
+        }
+        if (arg === "--cwd" && next) {
+            cwd = next;
+            i++;
+            continue;
+        }
+        if ((arg === "--config" || arg === "--config-path") && next) {
+            configPath = next;
+            i++;
+        }
+    }
+    if (!dir) {
+        console.error("bridge-worker: missing --dir");
+        process.exit(2);
+    }
+    return { dir, port, cwd, configPath };
+}
+async function main() {
+    const { dir, port, cwd, configPath } = parseArgs(process.argv);
+    const config = await loadConfig(configPath, cwd);
+    const sensitive = resolveSensitiveEnvVars(config);
+    const bridge = await startRecordingBridge({
+        port,
+        onEvent: (event) => {
+            enqueueEnrichedAppend({
+                cwd,
+                recordingDir: dir,
+                config,
+                event,
+                sensitiveEnvVars: sensitive,
+            });
+        },
+    });
+    process.stdout.write(`${bridge.url}\n`);
+    const shutdown = async () => {
+        await bridge.close();
+        process.exit(0);
+    };
+    process.on("SIGTERM", () => void shutdown());
+    process.on("SIGINT", () => void shutdown());
+}
+const isMain = process.argv[1]?.endsWith("bridge-worker.ts") ||
+    process.argv[1]?.endsWith("bridge-worker.js");
+if (isMain) {
+    main().catch((err) => {
+        console.error(err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=bridge-worker.js.map

package/dist/recorder/bridge-worker.js.map

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

package/dist/recorder/bridge.d.ts

@@ -0,0 +1,12 @@
+import type { RecordEvent } from "../types/recorder.js";
+export interface RecordingBridge {
+    port: number;
+    url: string;
+    append: (event: RecordEvent) => void;
+    close: () => Promise<void>;
+}
+export declare function startRecordingBridge(options: {
+    port: number;
+    onEvent: (event: RecordEvent) => void;
+}): Promise<RecordingBridge>;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/recorder/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/recorder/bridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACrC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CACvC,GAAG,OAAO,CAAC,eAAe,CAAC,CAoE3B"}

package/dist/recorder/bridge.js

@@ -0,0 +1,61 @@
+import http from "node:http";
+export function startRecordingBridge(options) {
+    const append = (event) => {
+        options.onEvent({ ...event, ts: event.ts || Date.now() });
+    };
+    return new Promise((resolve, reject) => {
+        const server = http.createServer((req, res) => {
+            const cors = {
+                "Access-Control-Allow-Origin": "*",
+                "Access-Control-Allow-Methods": "POST, OPTIONS",
+                "Access-Control-Allow-Headers": "Content-Type",
+            };
+            if (req.method === "OPTIONS") {
+                res.writeHead(204, cors);
+                res.end();
+                return;
+            }
+            if (req.method === "POST" && req.url === "/event") {
+                const chunks = [];
+                req.on("data", (chunk) => chunks.push(chunk));
+                req.on("end", () => {
+                    try {
+                        const body = JSON.parse(Buffer.concat(chunks).toString("utf-8"));
+                        append(body);
+                        res.writeHead(204, cors);
+                        res.end();
+                    }
+                    catch {
+                        res.writeHead(400, { ...cors, "Content-Type": "text/plain" });
+                        res.end("Invalid JSON");
+                    }
+                });
+                return;
+            }
+            if (req.method === "GET" && req.url === "/health") {
+                res.writeHead(200, { ...cors, "Content-Type": "application/json" });
+                res.end(JSON.stringify({ ok: true }));
+                return;
+            }
+            res.writeHead(404, cors);
+            res.end();
+        });
+        server.on("error", reject);
+        server.listen(options.port, "127.0.0.1", () => {
+            const address = server.address();
+            const boundPort = typeof address === "object" && address && "port" in address
+                ? address.port
+                : options.port;
+            const url = `http://127.0.0.1:${boundPort}`;
+            resolve({
+                port: boundPort,
+                url,
+                append,
+                close: () => new Promise((closeResolve, closeReject) => {
+                    server.close((err) => (err ? closeReject(err) : closeResolve()));
+                }),
+            });
+        });
+    });
+}
+//# sourceMappingURL=bridge.js.map

package/dist/recorder/bridge.js.map

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

package/dist/recorder/bridge.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bridge.test.d.ts.map

package/dist/recorder/bridge.test.d.ts.map

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

package/dist/recorder/bridge.test.js

@@ -0,0 +1,21 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { startRecordingBridge } from "./bridge.js";
+describe("recording bridge", () => {
+    it("accepts POST /event", async () => {
+        const events = [];
+        const bridge = await startRecordingBridge({
+            port: 0,
+            onEvent: (e) => events.push(e),
+        });
+        const res = await fetch(`${bridge.url}/event`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ type: "comment", text: "test", ts: 1 }),
+        });
+        assert.equal(res.status, 204);
+        assert.equal(events.length, 1);
+        await bridge.close();
+    });
+});
+//# sourceMappingURL=bridge.test.js.map

package/dist/recorder/bridge.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.test.js","sourceRoot":"","sources":["../../src/recorder/bridge.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;QACnC,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC;YACxC,IAAI,EAAE,CAAC;YACP,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;SAC/B,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,GAAG,QAAQ,EAAE;YAC7C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;SAC/D,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC/B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/recorder/enrich-event.d.ts

@@ -0,0 +1,31 @@
+import type { PqaConfig } from "../types/config.js";
+import type { RecordEvent } from "../types/recorder.js";
+import { parseSnapshotJson, type SnapshotTarget } from "./snapshot-match.js";
+export declare function captureInteractiveSnapshot(options: {
+    cwd: string;
+    recordingDir: string;
+    sessionName: string;
+    headed: boolean;
+    engine: PqaConfig["browser"]["engine"];
+    lightpanda?: PqaConfig["browser"]["lightpanda"];
+    timeoutMs: number;
+    eventTs: number;
+}): Promise<{
+    parsed: ReturnType<typeof parseSnapshotJson>;
+    path?: string;
+}>;
+export declare function applySnapshotTarget<T extends RecordEvent>(event: T, target: SnapshotTarget | undefined): T;
+export declare function enrichRecordEvent(options: {
+    cwd: string;
+    recordingDir: string;
+    config: PqaConfig;
+    event: RecordEvent;
+}): Promise<RecordEvent>;
+export declare function enqueueEnrichedAppend(options: {
+    cwd: string;
+    recordingDir: string;
+    config: PqaConfig;
+    event: RecordEvent;
+    sensitiveEnvVars: string[];
+}): void;
+//# sourceMappingURL=enrich-event.d.ts.map

package/dist/recorder/enrich-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich-event.d.ts","sourceRoot":"","sources":["../../src/recorder/enrich-event.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAEL,iBAAiB,EACjB,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAgB7B,wBAAsB,0BAA0B,CAAC,OAAO,EAAE;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA6B3E;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,WAAW,EACvD,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,cAAc,GAAG,SAAS,GACjC,CAAC,CAWH;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;CACpB,GAAG,OAAO,CAAC,WAAW,CAAC,CAwBvB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B,GAAG,IAAI,CAcP"}

package/dist/recorder/enrich-event.js

@@ -0,0 +1,91 @@
+import { writeFileSync } from "node:fs";
+import path from "node:path";
+import { buildBrowserEnv, runBash } from "../agent/bash.js";
+import { appendEvent, readMeta } from "./events.js";
+import { matchEventToSnapshotTarget, parseSnapshotJson, } from "./snapshot-match.js";
+const SNAPSHOT_EVENT_TYPES = new Set([
+    "click",
+    "fill",
+    "select",
+    "submit",
+    "navigate",
+]);
+let enrichChain = Promise.resolve();
+function needsSnapshot(event) {
+    return SNAPSHOT_EVENT_TYPES.has(event.type);
+}
+export async function captureInteractiveSnapshot(options) {
+    const env = buildBrowserEnv({
+        cwd: options.cwd,
+        headed: options.headed,
+        sessionName: options.sessionName,
+        engine: options.engine,
+        lightpanda: options.lightpanda,
+        artifactDir: options.recordingDir,
+    });
+    const entry = await runBash("agent-browser snapshot --json", {
+        cwd: options.cwd,
+        timeoutMs: options.timeoutMs,
+        env,
+    });
+    const combined = `${entry.stdout}\n${entry.stderr}`.trim();
+    const parsed = parseSnapshotJson(combined);
+    if (!parsed)
+        return { parsed: null };
+    const snapDir = path.join(options.recordingDir, "snapshots");
+    const snapPath = path.join(snapDir, `${options.eventTs}.json`);
+    writeFileSync(snapPath, `${JSON.stringify({ capturedAt: new Date().toISOString(), ...parsed }, null, 2)}\n`, "utf-8");
+    return { parsed, path: snapPath };
+}
+export function applySnapshotTarget(event, target) {
+    if (!target)
+        return event;
+    return {
+        ...event,
+        snapshot: target,
+        role: target.role ?? ("role" in event ? event.role : undefined),
+        name: target.name ?? ("name" in event ? event.name : undefined),
+        ...("label" in event && target.name
+            ? { label: target.name }
+            : {}),
+    };
+}
+export async function enrichRecordEvent(options) {
+    if (!needsSnapshot(options.event))
+        return options.event;
+    const meta = readMeta(options.recordingDir);
+    const { parsed } = await captureInteractiveSnapshot({
+        cwd: options.cwd,
+        recordingDir: options.recordingDir,
+        sessionName: meta.sessionName,
+        headed: true,
+        engine: options.config.browser.engine,
+        lightpanda: options.config.browser.lightpanda,
+        timeoutMs: options.config.agent.bashTimeoutMs,
+        eventTs: options.event.ts,
+    });
+    if (!parsed)
+        return options.event;
+    const event = options.event;
+    if (event.type !== "click" && event.type !== "fill" && event.type !== "select") {
+        return options.event;
+    }
+    const target = matchEventToSnapshotTarget(event, parsed);
+    return applySnapshotTarget(event, target);
+}
+export function enqueueEnrichedAppend(options) {
+    enrichChain = enrichChain
+        .then(async () => {
+        const enriched = await enrichRecordEvent({
+            cwd: options.cwd,
+            recordingDir: options.recordingDir,
+            config: options.config,
+            event: options.event,
+        });
+        appendEvent(options.recordingDir, enriched, options.sensitiveEnvVars);
+    })
+        .catch(() => {
+        appendEvent(options.recordingDir, options.event, options.sensitiveEnvVars);
+    });
+}
+//# sourceMappingURL=enrich-event.js.map

package/dist/recorder/enrich-event.js.map

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

package/dist/recorder/events.d.ts

@@ -0,0 +1,11 @@
+import type { RecordingMeta, RecordEvent } from "../types/recorder.js";
+export declare function recordingDir(cwd: string, outputDir: string, id: string): string;
+export declare function eventsPath(dir: string): string;
+export declare function metaPath(dir: string): string;
+export declare function appendEvent(dir: string, event: RecordEvent, sensitiveEnvVars?: string[]): void;
+export declare function readEvents(dir: string): RecordEvent[];
+export declare function writeMeta(dir: string, meta: RecordingMeta): void;
+export declare function readMeta(dir: string): RecordingMeta;
+export declare function ensureRecordingDir(dir: string): void;
+export declare function newRecordingId(): string;
+//# sourceMappingURL=events.d.ts.map

package/dist/recorder/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/recorder/events.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGvE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,WAAW,EAClB,gBAAgB,GAAE,MAAM,EAAO,GAC9B,IAAI,CAGN;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CAOrD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAEhE;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAEnD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAMpD;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/recorder/events.js

@@ -0,0 +1,42 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
+import path from "node:path";
+import { sanitizeRecordEvent } from "./redact.js";
+export function recordingDir(cwd, outputDir, id) {
+    return path.join(cwd, outputDir, id);
+}
+export function eventsPath(dir) {
+    return path.join(dir, "events.jsonl");
+}
+export function metaPath(dir) {
+    return path.join(dir, "meta.json");
+}
+export function appendEvent(dir, event, sensitiveEnvVars = []) {
+    const line = `${JSON.stringify(sanitizeRecordEvent(event, sensitiveEnvVars))}\n`;
+    appendFileSync(eventsPath(dir), line, "utf-8");
+}
+export function readEvents(dir) {
+    const file = eventsPath(dir);
+    if (!existsSync(file))
+        return [];
+    return readFileSync(file, "utf-8")
+        .split("\n")
+        .filter((line) => line.trim())
+        .map((line) => JSON.parse(line));
+}
+export function writeMeta(dir, meta) {
+    writeFileSync(metaPath(dir), `${JSON.stringify(meta, null, 2)}\n`, "utf-8");
+}
+export function readMeta(dir) {
+    return JSON.parse(readFileSync(metaPath(dir), "utf-8"));
+}
+export function ensureRecordingDir(dir) {
+    mkdirSync(dir, { recursive: true });
+    mkdirSync(path.join(dir, "snapshots"), { recursive: true });
+    if (!existsSync(eventsPath(dir))) {
+        writeFileSync(eventsPath(dir), "", "utf-8");
+    }
+}
+export function newRecordingId() {
+    return new Date().toISOString().replace(/[:.]/g, "-");
+}
+//# sourceMappingURL=events.js.map

package/dist/recorder/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/recorder/events.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,UAAU,EACV,SAAS,EACT,YAAY,EACZ,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,SAAiB,EAAE,EAAU;IACrE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,GAAW,EACX,KAAkB,EAClB,mBAA6B,EAAE;IAE/B,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,IAAI,CAAC;IACjF,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC;SAC/B,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC7B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAgB,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,IAAmB;IACxD,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAkB,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QACjC,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACxD,CAAC"}

package/dist/recorder/events.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.test.d.ts.map

package/dist/recorder/events.test.d.ts.map

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

package/dist/recorder/events.test.js

@@ -0,0 +1,40 @@
+import assert from "node:assert/strict";
+import { mkdtempSync, rmSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { describe, it } from "node:test";
+import { appendEvent, readEvents, ensureRecordingDir, writeMeta, readMeta, } from "./events.js";
+describe("recorder events", () => {
+    it("appends and reads jsonl events", () => {
+        const tmp = mkdtempSync(path.join(os.tmpdir(), "pqa-rec-"));
+        try {
+            ensureRecordingDir(tmp);
+            appendEvent(tmp, { type: "comment", text: "hi", ts: 100 });
+            appendEvent(tmp, { type: "navigate", url: "https://x.test/", ts: 101 });
+            const events = readEvents(tmp);
+            assert.equal(events.length, 2);
+            assert.equal(events[0].type, "comment");
+        }
+        finally {
+            rmSync(tmp, { recursive: true, force: true });
+        }
+    });
+    it("writes and reads meta", () => {
+        const tmp = mkdtempSync(path.join(os.tmpdir(), "pqa-meta-"));
+        try {
+            ensureRecordingDir(tmp);
+            writeMeta(tmp, {
+                id: "test-id",
+                startedAt: "2026-01-01T00:00:00.000Z",
+                sessionName: "pqa-record",
+                bridgePort: 17321,
+            });
+            const meta = readMeta(tmp);
+            assert.equal(meta.id, "test-id");
+        }
+        finally {
+            rmSync(tmp, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=events.test.js.map

package/dist/recorder/events.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.test.js","sourceRoot":"","sources":["../../src/recorder/events.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EACL,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC;YACH,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACxB,WAAW,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YAC3D,WAAW,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,iBAAiB,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YACxE,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YAC/B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC;YACH,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACxB,SAAS,CAAC,GAAG,EAAE;gBACb,EAAE,EAAE,SAAS;gBACb,SAAS,EAAE,0BAA0B;gBACrC,WAAW,EAAE,YAAY;gBACzB,UAAU,EAAE,KAAK;aAClB,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC3B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QACnC,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/recorder/generate-scenario.d.ts

@@ -0,0 +1,16 @@
+import type { PqaConfig } from "../types/config.js";
+export interface GenerateScenarioOptions {
+    config: PqaConfig;
+    recordingDir: string;
+    cwd: string;
+    scenarioName: string;
+    outputPath: string;
+}
+export interface GenerateScenarioResult {
+    markdown: string;
+    outputPath: string;
+    parseError?: string;
+}
+export declare function generateScenarioFromRecording(options: GenerateScenarioOptions): Promise<GenerateScenarioResult>;
+export declare function defaultOutputPath(cwd: string, scenarioName: string): string;
+//# sourceMappingURL=generate-scenario.d.ts.map

package/dist/recorder/generate-scenario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-scenario.d.ts","sourceRoot":"","sources":["../../src/recorder/generate-scenario.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAapD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAkEjC;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,GACnB,MAAM,CAER"}

package/dist/recorder/generate-scenario.js

@@ -0,0 +1,78 @@
+import { readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { generateText } from "ai";
+import { createLlmModel } from "../agent/llm-model.js";
+import { resolveBundledPath } from "../paths.js";
+import { parseScenarioFile, stripScenarioComments } from "../scenarios/parser.js";
+import { unlinkSync } from "node:fs";
+import { readEvents, readMeta } from "./events.js";
+import { resolveRecorderConfig } from "./session.js";
+function extractMarkdown(text) {
+    const fenced = /```(?:markdown|md)?\s*([\s\S]*?)```/i.exec(text);
+    if (fenced)
+        return fenced[1].trim();
+    return text.trim();
+}
+export async function generateScenarioFromRecording(options) {
+    const meta = readMeta(options.recordingDir);
+    const events = readEvents(options.recordingDir);
+    const recorder = resolveRecorderConfig(options.config.recorder);
+    const systemPath = resolveBundledPath(options.cwd, "prompt/RECORD.md");
+    const formatPath = resolveBundledPath(options.cwd, "prompt/references/scenario-format.md");
+    const system = readFileSync(systemPath, "utf-8");
+    const formatRef = readFileSync(formatPath, "utf-8");
+    const userPayload = {
+        scenarioName: options.scenarioName,
+        defaultTags: recorder.defaultTags,
+        meta,
+        events,
+    };
+    const { text } = await generateText({
+        model: createLlmModel(options.config),
+        system: `${system}\n\n---\n\n## Reference: scenario format\n\n${formatRef}`,
+        prompt: `Generate a Prose-QA scenario markdown file from this recording.\n\n\`\`\`json\n${JSON.stringify(userPayload, null, 2)}\n\`\`\`\n\nReply with ONLY the complete scenario markdown file.`,
+        maxOutputTokens: 8192,
+    });
+    let markdown = extractMarkdown(text);
+    let parseError;
+    const validate = (md) => {
+        const draft = path.join(options.recordingDir, ".draft-scenario.md");
+        writeFileSync(draft, `${stripScenarioComments(md).trim()}\n`, "utf-8");
+        try {
+            parseScenarioFile(draft);
+        }
+        finally {
+            try {
+                unlinkSync(draft);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    };
+    try {
+        validate(markdown);
+    }
+    catch (err) {
+        parseError = String(err);
+        const retry = await generateText({
+            model: createLlmModel(options.config),
+            system: `${system}\n\n---\n\n## Reference: scenario format\n\n${formatRef}`,
+            prompt: `The previous scenario failed to parse: ${parseError}\n\nFix and return ONLY valid markdown.\n\nPrevious:\n\`\`\`markdown\n${markdown}\n\`\`\``,
+            maxOutputTokens: 8192,
+        });
+        markdown = extractMarkdown(retry.text);
+        validate(markdown);
+        parseError = undefined;
+    }
+    writeFileSync(options.outputPath, `${markdown.trim()}\n`, "utf-8");
+    return {
+        markdown,
+        outputPath: options.outputPath,
+        parseError,
+    };
+}
+export function defaultOutputPath(cwd, scenarioName) {
+    return path.join(cwd, "scenarios", "recorded", `${scenarioName}.md`);
+}
+//# sourceMappingURL=generate-scenario.js.map

package/dist/recorder/generate-scenario.js.map

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

package/dist/recorder/in-page-helpers.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Browser-side helpers embedded in the page recorder and Chrome extension.
+ * Keep this file free of Node imports — it is inlined into injected scripts.
+ */
+export declare function buildInPageRecorderHelpers(): string;
+//# sourceMappingURL=in-page-helpers.d.ts.map

package/dist/recorder/in-page-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-page-helpers.d.ts","sourceRoot":"","sources":["../../src/recorder/in-page-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAwOnD"}