prose-qa 0.1.0

package/dist/agent/bash.js

@@ -0,0 +1,186 @@
+import { exec } from "node:child_process";
+import path from "node:path";
+import { promisify } from "node:util";
+import { lightpandaBrowserEnv } from "../config/lightpanda.js";
+import { resolveAgentBrowserBinDirs } from "../paths.js";
+const execAsync = promisify(exec);
+/** Prepend local agent-browser CLI dirs so bash works without a global install. */
+export function withAgentBrowserPath(cwd, env) {
+    const binDirs = resolveAgentBrowserBinDirs(cwd);
+    if (binDirs.length === 0)
+        return env;
+    const existing = env.PATH ?? env.Path ?? process.env.PATH ?? "";
+    const nextPath = existing
+        ? `${binDirs.join(path.delimiter)}${path.delimiter}${existing}`
+        : binDirs.join(path.delimiter);
+    return { ...env, PATH: nextPath, Path: nextPath };
+}
+export async function runBash(command, options) {
+    const start = Date.now();
+    try {
+        const { stdout, stderr } = await execAsync(command, {
+            cwd: options.cwd,
+            timeout: options.timeoutMs,
+            env: withAgentBrowserPath(options.cwd, {
+                ...process.env,
+                ...options.env,
+            }),
+            maxBuffer: 10 * 1024 * 1024,
+            shell: "/bin/bash",
+        });
+        return {
+            command,
+            stdout: stdout ?? "",
+            stderr: stderr ?? "",
+            exitCode: 0,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        const e = err;
+        return {
+            command,
+            stdout: e.stdout ?? "",
+            stderr: e.stderr ?? (e.killed ? "Command timed out" : String(err)),
+            exitCode: typeof e.code === "number" ? e.code : 1,
+            durationMs: Date.now() - start,
+        };
+    }
+}
+export async function closeBrowserSession(options) {
+    const env = buildBrowserEnv({
+        cwd: options.cwd,
+        headed: options.headed,
+        sessionName: options.sessionName,
+        engine: options.engine,
+        lightpanda: options.lightpanda,
+        artifactDir: options.cwd,
+    });
+    const entry = await runBash("agent-browser close 2>/dev/null || true", {
+        cwd: options.cwd,
+        timeoutMs: options.timeoutMs,
+        env,
+    });
+    if (options.verbose && (entry.stderr || entry.stdout)) {
+        console.error(entry.stderr || entry.stdout);
+    }
+}
+export async function closeAllBrowserSessions(options) {
+    const env = buildBrowserEnv({
+        cwd: options.cwd,
+        headed: options.headed,
+        sessionName: "pqa",
+        engine: options.engine,
+        lightpanda: options.lightpanda,
+        artifactDir: options.cwd,
+    });
+    const entry = await runBash("agent-browser close --all 2>/dev/null || true", {
+        cwd: options.cwd,
+        timeoutMs: options.timeoutMs,
+        env,
+    });
+    if (options.verbose && (entry.stderr || entry.stdout)) {
+        console.error(entry.stderr || entry.stdout);
+    }
+}
+function stateWasIgnored(entry) {
+    const msg = `${entry.stderr}\n${entry.stdout}`;
+    return (msg.includes("--state ignored") || msg.includes("daemon already running"));
+}
+function isAuthRedirectUrl(url) {
+    return (url.includes("accounts.google.com") || url.includes("iap.googleapis.com"));
+}
+export async function prepareBrowserSession(options) {
+    const env = buildBrowserEnv({
+        cwd: options.cwd,
+        headed: options.headed,
+        sessionName: options.sessionName,
+        engine: options.engine,
+        lightpanda: options.lightpanda,
+        profilePath: options.profilePath,
+        authStatePath: options.profilePath ? undefined : options.authStatePath,
+        artifactDir: options.cwd,
+    });
+    const startUrl = options.startUrl ?? "about:blank";
+    await runBash("agent-browser close 2>/dev/null || true", {
+        cwd: options.cwd,
+        timeoutMs: options.timeoutMs,
+        env,
+    });
+    let entry = await runBash(`agent-browser open "${startUrl}"`, {
+        cwd: options.cwd,
+        timeoutMs: options.timeoutMs,
+        env,
+    });
+    if (stateWasIgnored(entry)) {
+        await runBash("agent-browser close --all 2>/dev/null || true", {
+            cwd: options.cwd,
+            timeoutMs: options.timeoutMs,
+            env,
+        });
+        entry = await runBash(`agent-browser open "${startUrl}"`, {
+            cwd: options.cwd,
+            timeoutMs: options.timeoutMs,
+            env,
+        });
+    }
+    if (entry.exitCode !== 0 || stateWasIgnored(entry)) {
+        const label = options.profilePath ? "auth profile" : "browser session";
+        throw new Error(`Failed to start ${label}: ${entry.stderr || entry.stdout}`);
+    }
+    if (startUrl !== "about:blank") {
+        await runBash("agent-browser wait --load networkidle 2>/dev/null || true", {
+            cwd: options.cwd,
+            timeoutMs: options.timeoutMs,
+            env,
+        });
+    }
+    const urlEntry = await runBash("agent-browser get url", {
+        cwd: options.cwd,
+        timeoutMs: options.timeoutMs,
+        env,
+    });
+    const currentUrl = urlEntry.stdout.trim();
+    if (startUrl !== "about:blank") {
+        if (!currentUrl || currentUrl === "about:blank") {
+            const hint = options.profilePath
+                ? " Re-run with --auth-refresh."
+                : "";
+            throw new Error(`Browser is empty after opening ${startUrl} (url=${currentUrl || "(empty)"}).${hint}`);
+        }
+        if (options.profilePath && isAuthRedirectUrl(currentUrl)) {
+            throw new Error(`Auth profile is not signed in — browser redirected to ${currentUrl}. Re-run with --auth-refresh.`);
+        }
+    }
+    if (options.verbose) {
+        console.log(`Browser ready on ${currentUrl || startUrl} (session ${options.sessionName})`);
+    }
+    return { startUrl: currentUrl || startUrl };
+}
+export function buildBrowserEnv(config) {
+    const engine = config.engine ?? "chrome";
+    const env = {
+        PQA_ARTIFACT_DIR: config.artifactDir,
+        AGENT_BROWSER_SESSION_NAME: config.sessionName,
+        AGENT_BROWSER_SESSION: config.sessionName,
+        AGENT_BROWSER_ENGINE: engine,
+        ...lightpandaBrowserEnv(config.cwd ?? config.artifactDir, engine, config.lightpanda),
+    };
+    if (config.profilePath) {
+        env.AGENT_BROWSER_PROFILE = config.profilePath;
+    }
+    else if (config.authStatePath) {
+        env.AGENT_BROWSER_STATE = config.authStatePath;
+    }
+    if (config.authSavePath) {
+        env.PQA_AUTH_SAVE_PATH = config.authSavePath;
+    }
+    if (!config.headed) {
+        env.AGENT_BROWSER_HEADED = "false";
+    }
+    else {
+        env.AGENT_BROWSER_HEADED = "true";
+    }
+    return env;
+}
+//# sourceMappingURL=bash.js.map

package/dist/agent/bash.js.map

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

package/dist/agent/bash.test.d.ts

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

package/dist/agent/bash.test.d.ts.map

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

package/dist/agent/bash.test.js

@@ -0,0 +1,70 @@
+import assert from "node:assert/strict";
+import path from "node:path";
+import { describe, it } from "node:test";
+import { getPackageRoot } from "../paths.js";
+import { buildBrowserEnv, withAgentBrowserPath } from "./bash.js";
+describe("withAgentBrowserPath", () => {
+    it("prepends prose-qa node_modules/.bin when cwd has no local install", () => {
+        const pkgBin = path.join(getPackageRoot(), "node_modules/.bin");
+        const env = withAgentBrowserPath("/tmp/pqa-no-local-agent-browser", {
+            PATH: "/usr/bin",
+        });
+        assert.ok(env.PATH?.startsWith(`${pkgBin}:`));
+        assert.equal(env.PATH, env.Path);
+    });
+});
+describe("buildBrowserEnv", () => {
+    it("sets AGENT_BROWSER_ENGINE from config", () => {
+        const chrome = buildBrowserEnv({
+            headed: false,
+            sessionName: "pqa",
+            engine: "chrome",
+            artifactDir: "/tmp/artifacts",
+        });
+        assert.equal(chrome.AGENT_BROWSER_ENGINE, "chrome");
+        const lightpanda = buildBrowserEnv({
+            headed: false,
+            sessionName: "pqa",
+            engine: "lightpanda",
+            artifactDir: "/tmp/artifacts",
+        });
+        assert.equal(lightpanda.AGENT_BROWSER_ENGINE, "lightpanda");
+    });
+    it("defaults AGENT_BROWSER_ENGINE to chrome", () => {
+        const env = buildBrowserEnv({
+            headed: false,
+            sessionName: "pqa",
+            artifactDir: "/tmp/artifacts",
+        });
+        assert.equal(env.AGENT_BROWSER_ENGINE, "chrome");
+    });
+    it("applies lightpanda config when engine is lightpanda", () => {
+        const cwd = "/project";
+        const env = buildBrowserEnv({
+            cwd,
+            headed: false,
+            sessionName: "pqa",
+            engine: "lightpanda",
+            lightpanda: {
+                executablePath: "/opt/lightpanda",
+                telemetry: false,
+            },
+            artifactDir: "/tmp/artifacts",
+        });
+        assert.equal(env.AGENT_BROWSER_ENGINE, "lightpanda");
+        assert.equal(env.AGENT_BROWSER_EXECUTABLE_PATH, "/opt/lightpanda");
+        assert.equal(env.LIGHTPANDA_DISABLE_TELEMETRY, "true");
+    });
+    it("does not set lightpanda env for chrome engine", () => {
+        const env = buildBrowserEnv({
+            cwd: "/project",
+            headed: false,
+            sessionName: "pqa",
+            engine: "chrome",
+            lightpanda: { telemetry: false },
+            artifactDir: "/tmp/artifacts",
+        });
+        assert.equal(env.LIGHTPANDA_DISABLE_TELEMETRY, undefined);
+    });
+});
+//# sourceMappingURL=bash.test.js.map

package/dist/agent/bash.test.js.map

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

package/dist/agent/llm-model.d.ts

@@ -0,0 +1,5 @@
+import type { LanguageModel } from "ai";
+import type { PqaConfig } from "../types/config.js";
+/** Resolve the Vercel AI SDK language model for the configured LLM provider. */
+export declare function createLlmModel(config: PqaConfig): LanguageModel;
+//# sourceMappingURL=llm-model.d.ts.map

package/dist/agent/llm-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-model.d.ts","sourceRoot":"","sources":["../../src/agent/llm-model.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,CAoB/D"}

package/dist/agent/llm-model.js

@@ -0,0 +1,29 @@
+import { anthropic } from "@ai-sdk/anthropic";
+import { fireworks } from "@ai-sdk/fireworks";
+import { google } from "@ai-sdk/google";
+import { openai } from "@ai-sdk/openai";
+import { openrouter } from "@openrouter/ai-sdk-provider";
+import { ollama } from "ollama-ai-provider-v2";
+/** Resolve the Vercel AI SDK language model for the configured LLM provider. */
+export function createLlmModel(config) {
+    const { provider, model } = config.llm;
+    switch (provider) {
+        case "anthropic":
+            return anthropic(model);
+        case "openai":
+            return openai(model);
+        case "fireworks":
+            return fireworks(model);
+        case "ollama":
+            return ollama(model);
+        case "google":
+            return google(model);
+        case "openrouter":
+            return openrouter(model);
+        default: {
+            const unsupported = provider;
+            throw new Error(`Unsupported llm.provider: ${unsupported}`);
+        }
+    }
+}
+//# sourceMappingURL=llm-model.js.map

package/dist/agent/llm-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-model.js","sourceRoot":"","sources":["../../src/agent/llm-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAI/C,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,MAAiB;IAC9C,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC;IACvC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW;YACd,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1B,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,KAAK,WAAW;YACd,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1B,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,KAAK,YAAY;YACf,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,QAAQ,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,6BAA6B,WAAW,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/agent/llm-model.test.d.ts

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

package/dist/agent/llm-model.test.d.ts.map

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

package/dist/agent/llm-model.test.js

@@ -0,0 +1,28 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { createLlmModel } from "./llm-model.js";
+const base = {
+    browser: { headed: false, sessionName: "pqa", defaultTimeout: 25_000, engine: "chrome" },
+    skills: { dirs: [], preloads: [] },
+    agent: { maxTurns: 10, bashTimeoutMs: 60_000 },
+    auth: {},
+};
+describe("createLlmModel", () => {
+    it("returns a model for google provider", () => {
+        const model = createLlmModel({
+            ...base,
+            llm: { provider: "google", model: "gemini-2.5-flash" },
+        });
+        assert.ok(model);
+        assert.equal(typeof model, "object");
+    });
+    it("returns a model for openrouter provider", () => {
+        const model = createLlmModel({
+            ...base,
+            llm: { provider: "openrouter", model: "anthropic/claude-sonnet-4" },
+        });
+        assert.ok(model);
+        assert.equal(typeof model, "object");
+    });
+});
+//# sourceMappingURL=llm-model.test.js.map

package/dist/agent/llm-model.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-model.test.js","sourceRoot":"","sources":["../../src/agent/llm-model.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE;IACxF,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;IAClC,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE;IAC9C,IAAI,EAAE,EAAE;CACoB,CAAC;AAE/B,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,KAAK,GAAG,cAAc,CAAC;YAC3B,GAAG,IAAI;YACP,GAAG,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,kBAAkB,EAAE;SAC1C,CAAC,CAAC;QAChB,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,OAAO,KAAK,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,KAAK,GAAG,cAAc,CAAC;YAC3B,GAAG,IAAI;YACP,GAAG,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,2BAA2B,EAAE;SACvD,CAAC,CAAC;QAChB,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,OAAO,KAAK,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/agent/prompt.d.ts

@@ -0,0 +1,17 @@
+import type { PqaConfig, ArtifactsMode } from "../types/config.js";
+import type { Scenario } from "../types/scenario.js";
+import type { Skill } from "../types/skill.js";
+export declare function buildInitialPrompt(scenario: Scenario, preparedStartUrl?: string): string;
+export declare function buildSystemPrompt(config: PqaConfig, skills: Skill[], scenario: Scenario, runtime: {
+    cwd: string;
+    artifactDir: string;
+    authStatePath?: string;
+    authProfile?: string;
+    profilePath?: string;
+    headed: boolean;
+    sessionName: string;
+    artifacts: ArtifactsMode;
+    scenarioCacheHints?: string;
+    preparedStartUrl?: string;
+}): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/agent/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/agent/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAW/C,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,CAAC,EAAE,MAAM,GACxB,MAAM,CAuBR;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,KAAK,EAAE,EACf,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE;IACP,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,aAAa,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GACA,MAAM,CAwER"}

package/dist/agent/prompt.js

@@ -0,0 +1,97 @@
+import { formatArtifactsRuntimeHint } from "../artifacts/policy.js";
+import { resolveStatePath } from "../auth/store.js";
+import { formatDeclaredEnvVarHints } from "../config/env-vars.js";
+import { loadSystemPrompt } from "../prompt/load.js";
+import { buildSkillPrompt } from "../skills/loader.js";
+import { formatScenarioForPrompt } from "../scenarios/parser.js";
+const EXECUTION_HINT = "Use the Observe-Act-Verify loop from the system prompt. After all Steps, verify every Then checkpoint with CLI evidence before emitting the verdict JSON.";
+export function buildInitialPrompt(scenario, preparedStartUrl) {
+    const name = scenario.frontmatter.name;
+    if (preparedStartUrl && preparedStartUrl !== "about:blank") {
+        const authClause = scenario.frontmatter.auth
+            ? "with auth state loaded. "
+            : "The harness opened this page via agent-browser. ";
+        return (`Execute the scenario "${name}" now. The browser is already open on ${preparedStartUrl} ` +
+            `${authClause}Continue from Step 1 without running agent-browser close. ` +
+            EXECUTION_HINT);
+    }
+    if (preparedStartUrl === "about:blank") {
+        return (`Execute the scenario "${name}" now. Auth state is loaded in the browser session. ` +
+            `Follow the Steps without running agent-browser close first. ${EXECUTION_HINT}`);
+    }
+    const url = scenario.frontmatter.url;
+    if (url) {
+        return `Execute the scenario "${name}" now. Start by opening ${url} with agent-browser, then continue with the Steps. ${EXECUTION_HINT}`;
+    }
+    return `Execute the scenario "${name}" now. Follow the Steps, navigating to any URLs specified there with agent-browser. ${EXECUTION_HINT}`;
+}
+export function buildSystemPrompt(config, skills, scenario, runtime) {
+    const systemPrompt = loadSystemPrompt(runtime.cwd, config.systemPromptPath);
+    const skillBlock = buildSkillPrompt(skills);
+    const scenarioBlock = formatScenarioForPrompt(scenario);
+    const authSavePath = runtime.authProfile
+        ? resolveStatePath(runtime.cwd, runtime.authProfile, config)
+        : undefined;
+    const envHints = [
+        runtime.authProfile
+            ? [
+                `Auth scenario for profile "${runtime.authProfile}" — complete login Steps and Then checkpoints.`,
+                "The harness saves browser state and closes the session after you pass.",
+                "Do NOT run: agent-browser close, agent-browser close --all, or agent-browser state save.",
+                "Leave the browser on the signed-in page until your final verdict.",
+            ].join("\n")
+            : null,
+        scenario.frontmatter.url
+            ? runtime.preparedStartUrl && runtime.preparedStartUrl !== "about:blank"
+                ? `Scenario start URL: ${scenario.frontmatter.url} (harness already opened it — do not reload or agent-browser open this URL again)`
+                : `Scenario start URL: ${scenario.frontmatter.url} (open this before executing Steps)`
+            : "No start URL — navigate to URLs as specified in Steps",
+        `Artifact directory: ${runtime.artifactDir}`,
+        formatArtifactsRuntimeHint(runtime.artifacts),
+        `Browser session: ${runtime.sessionName}`,
+        `Headed mode: ${runtime.headed}`,
+        runtime.profilePath
+            ? `Auth browser profile: ${runtime.profilePath} (already signed in — do not run agent-browser close or reopen with --state)`
+            : runtime.authStatePath
+                ? `Auth state file: ${runtime.authStatePath}`
+                : "No auth state preloaded",
+        authSavePath ? `Auth state will be saved to: ${authSavePath}` : null,
+        `Then checkpoints to verify: ${scenario.then.length}`,
+        "",
+        "Harness environment variables available in bash:",
+        "- PQA_ARTIFACT_DIR",
+        "- AGENT_BROWSER_SESSION_NAME",
+        runtime.profilePath ? "- AGENT_BROWSER_PROFILE" : null,
+        runtime.authStatePath && !runtime.profilePath
+            ? "- AGENT_BROWSER_STATE"
+            : null,
+        authSavePath ? "- PQA_AUTH_SAVE_PATH" : null,
+        ...formatDeclaredEnvVarHints(config.envVars ?? []),
+    ]
+        .filter(Boolean)
+        .join("\n");
+    const cacheBlock = runtime.scenarioCacheHints?.trim()
+        ? `## Scenario replay hints (prior successful runs)
+
+${runtime.scenarioCacheHints.trim()}
+
+Treat these as accelerators, not strict scripts. Re-snapshot and adapt if the UI changed.
+
+---
+
+`
+        : "";
+    return `${systemPrompt}
+
+Runtime:
+${envHints}
+
+---
+
+${skillBlock}
+
+---
+
+${cacheBlock}${scenarioBlock}`;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/agent/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/agent/prompt.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,cAAc,GAClB,2JAA2J,CAAC;AAE9J,MAAM,UAAU,kBAAkB,CAChC,QAAkB,EAClB,gBAAyB;IAEzB,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC;IACvC,IAAI,gBAAgB,IAAI,gBAAgB,KAAK,aAAa,EAAE,CAAC;QAC3D,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI;YAC1C,CAAC,CAAC,0BAA0B;YAC5B,CAAC,CAAC,kDAAkD,CAAC;QACvD,OAAO,CACL,yBAAyB,IAAI,yCAAyC,gBAAgB,GAAG;YACzF,GAAG,UAAU,4DAA4D;YACzE,cAAc,CACf,CAAC;IACJ,CAAC;IACD,IAAI,gBAAgB,KAAK,aAAa,EAAE,CAAC;QACvC,OAAO,CACL,yBAAyB,IAAI,sDAAsD;YACnF,+DAA+D,cAAc,EAAE,CAChF,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC;IACrC,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,yBAAyB,IAAI,2BAA2B,GAAG,sDAAsD,cAAc,EAAE,CAAC;IAC3I,CAAC;IACD,OAAO,yBAAyB,IAAI,uFAAuF,cAAc,EAAE,CAAC;AAC9I,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAAiB,EACjB,MAAe,EACf,QAAkB,EAClB,OAWC;IAED,MAAM,YAAY,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC5E,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAExD,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW;QACtC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC;QAC5D,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,QAAQ,GAAG;QACf,OAAO,CAAC,WAAW;YACjB,CAAC,CAAC;gBACE,8BAA8B,OAAO,CAAC,WAAW,gDAAgD;gBACjG,wEAAwE;gBACxE,0FAA0F;gBAC1F,mEAAmE;aACpE,CAAC,IAAI,CAAC,IAAI,CAAC;YACd,CAAC,CAAC,IAAI;QACR,QAAQ,CAAC,WAAW,CAAC,GAAG;YACtB,CAAC,CAAC,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,KAAK,aAAa;gBACtE,CAAC,CAAC,uBAAuB,QAAQ,CAAC,WAAW,CAAC,GAAG,mFAAmF;gBACpI,CAAC,CAAC,uBAAuB,QAAQ,CAAC,WAAW,CAAC,GAAG,qCAAqC;YACxF,CAAC,CAAC,uDAAuD;QAC3D,uBAAuB,OAAO,CAAC,WAAW,EAAE;QAC5C,0BAA0B,CAAC,OAAO,CAAC,SAAS,CAAC;QAC7C,oBAAoB,OAAO,CAAC,WAAW,EAAE;QACzC,gBAAgB,OAAO,CAAC,MAAM,EAAE;QAChC,OAAO,CAAC,WAAW;YACjB,CAAC,CAAC,yBAAyB,OAAO,CAAC,WAAW,8EAA8E;YAC5H,CAAC,CAAC,OAAO,CAAC,aAAa;gBACrB,CAAC,CAAC,oBAAoB,OAAO,CAAC,aAAa,EAAE;gBAC7C,CAAC,CAAC,yBAAyB;QAC/B,YAAY,CAAC,CAAC,CAAC,gCAAgC,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI;QACpE,+BAA+B,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE;QACrD,EAAE;QACF,kDAAkD;QAClD,oBAAoB;QACpB,8BAA8B;QAC9B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,IAAI;QACtD,OAAO,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,WAAW;YAC3C,CAAC,CAAC,uBAAuB;YACzB,CAAC,CAAC,IAAI;QACR,YAAY,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,IAAI;QAC5C,GAAG,yBAAyB,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;KACnD;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,UAAU,GAAG,OAAO,CAAC,kBAAkB,EAAE,IAAI,EAAE;QACnD,CAAC,CAAC;;EAEJ,OAAO,CAAC,kBAAkB,CAAC,IAAI,EAAE;;;;;;CAMlC;QACG,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,GAAG,YAAY;;;EAGtB,QAAQ;;;;EAIR,UAAU;;;;EAIV,UAAU,GAAG,aAAa,EAAE,CAAC;AAC/B,CAAC"}

package/dist/agent/prompt.test.d.ts

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

package/dist/agent/prompt.test.d.ts.map

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

package/dist/agent/prompt.test.js

@@ -0,0 +1,124 @@
+import assert from "node:assert/strict";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, it } from "node:test";
+import { buildInitialPrompt, buildSystemPrompt } from "./prompt.js";
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+const baseConfig = {
+    llm: { provider: "anthropic", model: "claude-sonnet-4-20250514" },
+    browser: { headed: false, sessionName: "pqa", defaultTimeout: 25_000, engine: "chrome" },
+    systemPromptPath: path.join(repoRoot, "prompt/SYSTEM.md"),
+    skills: { dirs: [], preloads: [] },
+    agent: { maxTurns: 100, bashTimeoutMs: 120_000 },
+    auth: {},
+};
+function makeScenario(overrides = {}) {
+    return {
+        filePath: "/tmp/example.md",
+        frontmatter: { name: "example-smoke" },
+        skills: [],
+        goal: "Verify the dashboard loads.",
+        steps: "1. Open the app.",
+        then: ['url contains "/dashboard"', 'page shows "Welcome"'],
+        rawCheckpoints: [
+            'url contains "/dashboard"',
+            'page shows "Welcome"',
+        ],
+        checkpoints: [
+            { raw: 'url contains "/dashboard"', kind: "url_contains", value: "/dashboard" },
+            { raw: 'page shows "Welcome"', kind: "page_shows", value: "Welcome" },
+        ],
+        ...overrides,
+    };
+}
+describe("buildInitialPrompt", () => {
+    it("includes Observe-Act-Verify execution hint in all variants", () => {
+        const scenario = makeScenario();
+        const hint = "Observe-Act-Verify loop";
+        assert.match(buildInitialPrompt(scenario), new RegExp(hint));
+        assert.match(buildInitialPrompt(scenario, "http://localhost:3000/clients"), new RegExp(hint));
+        assert.match(buildInitialPrompt(scenario, "about:blank"), new RegExp(hint));
+        assert.match(buildInitialPrompt(makeScenario({
+            frontmatter: { name: "with-url", url: "http://localhost:3000" },
+        })), new RegExp(hint));
+    });
+    it("asks agent to open start URL when frontmatter url is set but harness did not preload", () => {
+        const prompt = buildInitialPrompt(makeScenario({
+            frontmatter: { name: "with-url", url: "http://localhost:3000/clients" },
+        }));
+        assert.match(prompt, /http:\/\/localhost:3000\/clients/);
+        assert.match(prompt, /agent-browser/);
+        assert.doesNotMatch(prompt, /already open/i);
+    });
+    it("tells agent not to reload when harness pre-opened frontmatter url", () => {
+        const prompt = buildInitialPrompt(makeScenario({
+            frontmatter: { name: "hello", url: "http://127.0.0.1:8080/" },
+        }), "http://127.0.0.1:8080/");
+        assert.match(prompt, /already open on http:\/\/127\.0\.0\.1:8080\//);
+        assert.match(prompt, /harness opened this page via agent-browser/i);
+        assert.match(prompt, /Continue from Step 1 without running agent-browser close/i);
+        assert.doesNotMatch(prompt, /auth state loaded/i);
+    });
+    it("mentions auth when harness pre-opened url with auth profile", () => {
+        const prompt = buildInitialPrompt(makeScenario({
+            frontmatter: {
+                name: "authed",
+                url: "http://127.0.0.1:8080/projects",
+                auth: "admin",
+            },
+        }), "http://127.0.0.1:8080/projects");
+        assert.match(prompt, /auth state loaded/i);
+        assert.match(prompt, /Continue from Step 1 without running agent-browser close/i);
+        assert.doesNotMatch(prompt, /harness opened this page via agent-browser/i);
+    });
+});
+describe("buildSystemPrompt", () => {
+    it("includes scenario block and Then checkpoint count in runtime hints", () => {
+        const scenario = makeScenario();
+        const skills = [];
+        const prompt = buildSystemPrompt(baseConfig, skills, scenario, {
+            cwd: repoRoot,
+            artifactDir: "/tmp/pqa-artifacts",
+            headed: false,
+            sessionName: "pqa",
+            artifacts: "on-failure",
+        });
+        assert.match(prompt, /# Scenario: example-smoke/);
+        assert.match(prompt, /Then checkpoints to verify: 2/);
+        assert.match(prompt, /Observe-Act-Verify loop/);
+        assert.match(prompt, /url contains "\/dashboard"/);
+    });
+    it("marks frontmatter url as harness-opened when preparedStartUrl is set", () => {
+        const scenario = makeScenario({
+            frontmatter: { name: "preloaded", url: "http://127.0.0.1:8080/" },
+        });
+        const prompt = buildSystemPrompt(baseConfig, [], scenario, {
+            cwd: repoRoot,
+            artifactDir: "/tmp/pqa-artifacts",
+            headed: false,
+            sessionName: "pqa",
+            artifacts: "on-failure",
+            preparedStartUrl: "http://127.0.0.1:8080/",
+        });
+        assert.match(prompt, /harness already opened it/);
+        assert.doesNotMatch(prompt, /open this before executing Steps/);
+    });
+    it("includes scenario replay hints block when provided", () => {
+        const scenario = makeScenario();
+        const prompt = buildSystemPrompt(baseConfig, [], scenario, {
+            cwd: repoRoot,
+            artifactDir: "/tmp/pqa-artifacts",
+            headed: false,
+            sessionName: "pqa",
+            artifacts: "on-failure",
+            scenarioCacheHints: "### Effective actions\n- Use snapshot -i first",
+        });
+        assert.match(prompt, /Scenario replay hints \(prior successful runs\)/);
+        assert.match(prompt, /Use snapshot -i first/);
+        assert.match(prompt, /Re-snapshot and adapt if the UI changed/);
+        const scenarioIndex = prompt.indexOf("# Scenario: example-smoke");
+        const hintsIndex = prompt.indexOf("Scenario replay hints");
+        assert.ok(hintsIndex > 0 && hintsIndex < scenarioIndex);
+    });
+});
+//# sourceMappingURL=prompt.test.js.map

package/dist/agent/prompt.test.js.map

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