@pcamarajr/scout 0.1.0

package/dist/runner/browser.js

@@ -0,0 +1,307 @@
+import path from "node:path";
+import { chromium } from "playwright";
+const STEP_TIMEOUT = 10_000;
+/**
+ * Thin Playwright wrapper shared by the AI runner and the replay runner.
+ * Owns ref→element resolution, tracing and screenshots.
+ */
+export class BrowserSession {
+    browser;
+    context;
+    page;
+    opts;
+    refs;
+    screenshotCount = 0;
+    screenshots = [];
+    constructor(browser, context, page, opts, refs = new Map()) {
+        this.browser = browser;
+        this.context = context;
+        this.page = page;
+        this.opts = opts;
+        this.refs = refs;
+    }
+    static async launch(opts) {
+        const browser = await chromium.launch({ headless: opts.headless });
+        const context = await browser.newContext({
+            locale: opts.locale ?? "pt-BR",
+            viewport: { width: 390, height: 844 }, // mobile-first; vertical video product
+            storageState: opts.storageState,
+        });
+        await context.tracing.start({ screenshots: true, snapshots: true, sources: false });
+        const page = await context.newPage();
+        page.setDefaultTimeout(STEP_TIMEOUT);
+        return new BrowserSession(browser, context, page, opts);
+    }
+    resolveUrl(url) {
+        return new URL(url, this.opts.baseUrl).toString();
+    }
+    async navigate(url) {
+        await this.page.goto(this.resolveUrl(url), { waitUntil: "domcontentloaded" });
+    }
+    /**
+     * Builds a numbered map of visible interactive elements (role + accessible
+     * name + CSS path) plus a text excerpt. Refs are valid until the next snapshot.
+     */
+    async snapshot() {
+        await this.page.waitForLoadState("domcontentloaded").catch(() => { });
+        const raw = (await this.page.evaluate(snapshotScript));
+        this.refs.clear();
+        for (const el of raw.elements)
+            this.refs.set(el.ref, el);
+        return { url: this.page.url(), title: await this.page.title(), ...raw };
+    }
+    formatSnapshot(snap) {
+        const lines = snap.elements.map((e) => {
+            const extra = [e.value ? `value="${e.value}"` : "", e.href ? `href="${e.href}"` : ""]
+                .filter(Boolean)
+                .join(" ");
+            return `[${e.ref}] ${e.role} "${e.name}"${extra ? " " + extra : ""}`;
+        });
+        return [
+            `URL: ${snap.url}`,
+            `Title: ${snap.title}`,
+            ``,
+            `Interactive elements:`,
+            ...lines,
+            ``,
+            `Visible text (excerpt):`,
+            snap.text,
+        ].join("\n");
+    }
+    /**
+     * Resolves a snapshot ref to a locator AND the durable Target recorded for
+     * replay: role+name when unique on the page, CSS path otherwise.
+     */
+    async resolveRef(ref) {
+        const info = this.refs.get(ref);
+        if (!info) {
+            throw new Error(`Ref [${ref}] desconhecido — tire um novo browser_snapshot, a página mudou.`);
+        }
+        const description = `${info.role} "${info.name}"`;
+        if (info.role && info.name) {
+            const byRole = this.page.getByRole(info.role, {
+                name: info.name,
+                exact: true,
+            });
+            if ((await byRole.count()) === 1) {
+                return { locator: byRole, target: { role: info.role, name: info.name, description } };
+            }
+        }
+        return { locator: this.page.locator(info.css), target: { css: info.css, description } };
+    }
+    async click(ref) {
+        const { locator, target } = await this.resolveRef(ref);
+        await locator.click();
+        return target;
+    }
+    async fill(ref, value) {
+        const { locator, target } = await this.resolveRef(ref);
+        await locator.fill(value);
+        return target;
+    }
+    async select(ref, value) {
+        const { locator, target } = await this.resolveRef(ref);
+        await locator.selectOption(value);
+        return target;
+    }
+    async press(key) {
+        await this.page.keyboard.press(key);
+    }
+    async waitForText(text) {
+        await this.page.getByText(text).first().waitFor({ state: "visible", timeout: STEP_TIMEOUT });
+    }
+    async waitForUrl(pattern) {
+        await this.page.waitForURL((u) => u.toString().includes(pattern), { timeout: STEP_TIMEOUT });
+    }
+    async assertVisible(text) {
+        await this.page.getByText(text).first().waitFor({ state: "visible", timeout: STEP_TIMEOUT });
+    }
+    async assertNotVisible(text) {
+        // give the page a beat to render, then require absence
+        await this.page.waitForTimeout(1000);
+        const visible = await this.page
+            .getByText(text)
+            .first()
+            .isVisible()
+            .catch(() => false);
+        if (visible)
+            throw new Error(`Texto "${text}" está visível, mas não deveria estar.`);
+    }
+    async assertUrl(pattern) {
+        const url = this.page.url();
+        if (!url.includes(pattern)) {
+            throw new Error(`URL atual "${url}" não contém "${pattern}".`);
+        }
+    }
+    async screenshot(label) {
+        this.screenshotCount += 1;
+        const safe = label.toLowerCase().replace(/[^a-z0-9]+/g, "-").slice(0, 40);
+        const file = path.join(this.opts.runDir, `${String(this.screenshotCount).padStart(2, "0")}-${safe}.png`);
+        await this.page.screenshot({ path: file, fullPage: false });
+        this.screenshots.push(file);
+        return file;
+    }
+    /** Replays one recorded step (used by the deterministic runner). */
+    async executeStep(step) {
+        switch (step.kind) {
+            case "navigate":
+                return this.navigate(step.url);
+            case "click":
+                return void (await this.targetLocator(step.target).click());
+            case "fill":
+                return void (await this.targetLocator(step.target).fill(resolveEnvValue(step.value)));
+            case "select":
+                return void (await this.targetLocator(step.target).selectOption(resolveEnvValue(step.value)));
+            case "press":
+                return this.press(step.key);
+            case "waitForText":
+                return this.waitForText(step.text);
+            case "waitForUrl":
+                return this.waitForUrl(step.pattern);
+            case "assertVisible":
+                return this.assertVisible(step.text);
+            case "assertNotVisible":
+                return this.assertNotVisible(step.text);
+            case "assertUrl":
+                return this.assertUrl(step.pattern);
+            case "screenshot":
+                return void (await this.screenshot(step.label));
+        }
+    }
+    targetLocator(target) {
+        if (target.role && target.name) {
+            return this.page
+                .getByRole(target.role, {
+                name: target.name,
+                exact: true,
+            })
+                .first();
+        }
+        if (target.css)
+            return this.page.locator(target.css);
+        throw new Error(`Target sem estratégia de localização: ${target.description}`);
+    }
+    async close() {
+        let tracePath;
+        try {
+            tracePath = path.join(this.opts.runDir, "trace.zip");
+            await this.context.tracing.stop({ path: tracePath });
+        }
+        catch {
+            tracePath = undefined;
+        }
+        await this.context.close().catch(() => { });
+        await this.browser.close().catch(() => { });
+        return tracePath;
+    }
+}
+/** Replaces $ENV:VAR_NAME placeholders so secrets never live in committed scripts. */
+export function resolveEnvValue(value) {
+    return value.replace(/\$ENV:([A-Z0-9_]+)/g, (_, name) => {
+        const v = process.env[name];
+        if (v === undefined)
+            throw new Error(`Env var ${name} (referenciada como $ENV:${name}) não definida.`);
+        return v;
+    });
+}
+/** Runs inside the page: collects visible interactive elements + text excerpt. */
+const snapshotScript = `(() => {
+  const ROLE_BY_TAG = {
+    a: "link", button: "button", select: "combobox", textarea: "textbox",
+    summary: "button", option: "option",
+  };
+  const INPUT_ROLES = {
+    button: "button", submit: "button", reset: "button", checkbox: "checkbox",
+    radio: "radio", range: "slider", search: "searchbox",
+  };
+
+  function isVisible(el) {
+    const rect = el.getBoundingClientRect();
+    if (rect.width === 0 || rect.height === 0) return false;
+    const style = getComputedStyle(el);
+    return style.visibility !== "hidden" && style.display !== "none";
+  }
+
+  function roleOf(el) {
+    const explicit = el.getAttribute("role");
+    if (explicit) return explicit;
+    const tag = el.tagName.toLowerCase();
+    if (tag === "input") {
+      const type = (el.getAttribute("type") || "text").toLowerCase();
+      return INPUT_ROLES[type] || "textbox";
+    }
+    if (tag === "a" && !el.hasAttribute("href")) return "";
+    return ROLE_BY_TAG[tag] || "";
+  }
+
+  function nameOf(el) {
+    const aria = el.getAttribute("aria-label");
+    if (aria) return aria.trim();
+    const labelledBy = el.getAttribute("aria-labelledby");
+    if (labelledBy) {
+      const ref = document.getElementById(labelledBy.split(/\\s+/)[0]);
+      if (ref) return (ref.textContent || "").trim().slice(0, 80);
+    }
+    if (el.tagName === "INPUT" || el.tagName === "TEXTAREA" || el.tagName === "SELECT") {
+      if (el.id) {
+        const label = document.querySelector('label[for="' + CSS.escape(el.id) + '"]');
+        if (label) return (label.textContent || "").trim().slice(0, 80);
+      }
+      const placeholder = el.getAttribute("placeholder");
+      if (placeholder) return placeholder.trim();
+      if (el.tagName === "INPUT" && (el.type === "submit" || el.type === "button") && el.value) {
+        return el.value.trim();
+      }
+      return el.getAttribute("name") || "";
+    }
+    const img = el.querySelector("img[alt]");
+    const text = (el.textContent || "").replace(/\\s+/g, " ").trim();
+    return (text || (img ? img.getAttribute("alt") : "") || el.getAttribute("title") || "").slice(0, 80);
+  }
+
+  function cssPath(el) {
+    const parts = [];
+    let node = el;
+    while (node && node.nodeType === 1 && node.tagName !== "HTML") {
+      const tag = node.tagName.toLowerCase();
+      if (node.id) {
+        parts.unshift(tag + "#" + CSS.escape(node.id));
+        break;
+      }
+      let index = 1;
+      let sibling = node.previousElementSibling;
+      while (sibling) {
+        if (sibling.tagName === node.tagName) index += 1;
+        sibling = sibling.previousElementSibling;
+      }
+      parts.unshift(tag + ":nth-of-type(" + index + ")");
+      node = node.parentElement;
+    }
+    return parts.join(" > ");
+  }
+
+  const selector = 'a[href], button, input, select, textarea, summary, [role="button"], [role="link"], [role="tab"], [role="menuitem"], [role="checkbox"], [role="switch"], [role="option"], [onclick], [tabindex]:not([tabindex="-1"])';
+  const nodes = Array.from(document.querySelectorAll(selector)).filter(isVisible);
+  const seen = new Set();
+  const elements = [];
+  let ref = 1;
+  for (const el of nodes) {
+    if (seen.has(el)) continue;
+    seen.add(el);
+    const role = roleOf(el);
+    const name = nameOf(el);
+    if (!role && !name) continue;
+    const info = { ref: ref++, role: role || el.tagName.toLowerCase(), name, css: cssPath(el), tag: el.tagName.toLowerCase() };
+    if (el.tagName === "INPUT" && el.type !== "password" && el.value) info.value = String(el.value).slice(0, 40);
+    if (el.tagName === "A") {
+      const href = el.getAttribute("href");
+      if (href && !href.startsWith("javascript:")) info.href = href.slice(0, 80);
+    }
+    elements.push(info);
+    if (elements.length >= 120) break;
+  }
+
+  const text = (document.body.innerText || "").replace(/\\n{3,}/g, "\\n\\n").slice(0, 2500);
+  return { elements, text };
+})()`;
+//# sourceMappingURL=browser.js.map

package/dist/runner/browser.js.map

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

package/dist/runner/script-runner.d.ts

@@ -0,0 +1,15 @@
+import type { Step } from "../types.js";
+import type { BrowserSession } from "./browser.js";
+export interface ReplayOutcome {
+    passed: boolean;
+    failedStep?: string;
+    failedIndex?: number;
+    error?: string;
+}
+/** Describes a step for reports/errors. */
+export declare function describeStep(step: Step): string;
+/**
+ * Deterministic replay of a cached script. No LLM involved — this is the
+ * cheap path that runs on every CI push.
+ */
+export declare function replaySteps(session: BrowserSession, steps: Step[]): Promise<ReplayOutcome>;

package/dist/runner/script-runner.js

@@ -0,0 +1,51 @@
+/** Describes a step for reports/errors. */
+export function describeStep(step) {
+    switch (step.kind) {
+        case "navigate":
+            return `navegar para ${step.url}`;
+        case "click":
+            return `clicar em ${step.target.description}`;
+        case "fill":
+            return `preencher ${step.target.description}`;
+        case "select":
+            return `selecionar "${step.value}" em ${step.target.description}`;
+        case "press":
+            return `pressionar ${step.key}`;
+        case "waitForText":
+            return `esperar texto "${step.text}"`;
+        case "waitForUrl":
+            return `esperar URL conter "${step.pattern}"`;
+        case "assertVisible":
+            return `verificar texto visível "${step.text}"`;
+        case "assertNotVisible":
+            return `verificar texto AUSENTE "${step.text}"`;
+        case "assertUrl":
+            return `verificar URL contém "${step.pattern}"`;
+        case "screenshot":
+            return `screenshot "${step.label}"`;
+    }
+}
+/**
+ * Deterministic replay of a cached script. No LLM involved — this is the
+ * cheap path that runs on every CI push.
+ */
+export async function replaySteps(session, steps) {
+    for (let i = 0; i < steps.length; i++) {
+        const step = steps[i];
+        try {
+            await session.executeStep(step);
+        }
+        catch (error) {
+            await session.screenshot(`replay-falhou-step-${i + 1}`).catch(() => { });
+            return {
+                passed: false,
+                failedIndex: i,
+                failedStep: describeStep(step),
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    await session.screenshot("estado-final").catch(() => { });
+    return { passed: true };
+}
+//# sourceMappingURL=script-runner.js.map

package/dist/runner/script-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-runner.js","sourceRoot":"","sources":["../../src/runner/script-runner.ts"],"names":[],"mappings":"AAUA,2CAA2C;AAC3C,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,UAAU;YACb,OAAO,gBAAgB,IAAI,CAAC,GAAG,EAAE,CAAC;QACpC,KAAK,OAAO;YACV,OAAO,aAAa,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAChD,KAAK,MAAM;YACT,OAAO,aAAa,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAChD,KAAK,QAAQ;YACX,OAAO,eAAe,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACpE,KAAK,OAAO;YACV,OAAO,cAAc,IAAI,CAAC,GAAG,EAAE,CAAC;QAClC,KAAK,aAAa;YAChB,OAAO,kBAAkB,IAAI,CAAC,IAAI,GAAG,CAAC;QACxC,KAAK,YAAY;YACf,OAAO,uBAAuB,IAAI,CAAC,OAAO,GAAG,CAAC;QAChD,KAAK,eAAe;YAClB,OAAO,4BAA4B,IAAI,CAAC,IAAI,GAAG,CAAC;QAClD,KAAK,kBAAkB;YACrB,OAAO,4BAA4B,IAAI,CAAC,IAAI,GAAG,CAAC;QAClD,KAAK,WAAW;YACd,OAAO,yBAAyB,IAAI,CAAC,OAAO,GAAG,CAAC;QAClD,KAAK,YAAY;YACf,OAAO,eAAe,IAAI,CAAC,KAAK,GAAG,CAAC;IACxC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAuB,EAAE,KAAa;IACtE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,CAAC,UAAU,CAAC,sBAAsB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACxE,OAAO;gBACL,MAAM,EAAE,KAAK;gBACb,WAAW,EAAE,CAAC;gBACd,UAAU,EAAE,YAAY,CAAC,IAAI,CAAC;gBAC9B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACzD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}

package/dist/store.d.ts

@@ -0,0 +1,33 @@
+import type { RunResult, Scenario, Step } from "./types.js";
+/**
+ * Filesystem store inside the target project:
+ *   .scout/scenarios.json        — committed (the suite definition)
+ *   .scout/scripts/<slug>.json   — committed (cached deterministic steps)
+ *   .scout/runs/<runId>/         — gitignored (artifacts per run)
+ *   .scout/state/<profile>.json  — gitignored (auth storageState)
+ */
+export declare class Store {
+    readonly root: string;
+    constructor(cwd?: string);
+    init(): void;
+    get scenariosFile(): string;
+    exists(): boolean;
+    listScenarios(): Scenario[];
+    saveScenarios(scenarios: Scenario[]): void;
+    addScenario(input: {
+        name: string;
+        scenario: string;
+        profile?: string;
+        notes?: string;
+    }): Scenario;
+    getScenario(idOrSlug: number | string): Scenario | undefined;
+    updateScenario(id: number, patch: Partial<Scenario>): void;
+    scriptPath(slug: string): string;
+    loadSteps(slug: string): Step[] | undefined;
+    saveSteps(slug: string, steps: Step[]): void;
+    newRunDir(slug: string): string;
+    saveRunResult(result: RunResult): void;
+    /** Latest run result per scenario slug (for `scout report`) */
+    latestRuns(): Map<string, RunResult>;
+}
+export declare function slugify(name: string): string;

package/dist/store.js

@@ -0,0 +1,119 @@
+import fs from "node:fs";
+import path from "node:path";
+import { SCOUT_DIR } from "./config.js";
+/**
+ * Filesystem store inside the target project:
+ *   .scout/scenarios.json        — committed (the suite definition)
+ *   .scout/scripts/<slug>.json   — committed (cached deterministic steps)
+ *   .scout/runs/<runId>/         — gitignored (artifacts per run)
+ *   .scout/state/<profile>.json  — gitignored (auth storageState)
+ */
+export class Store {
+    root;
+    constructor(cwd = process.cwd()) {
+        this.root = path.join(cwd, SCOUT_DIR);
+    }
+    init() {
+        fs.mkdirSync(path.join(this.root, "scripts"), { recursive: true });
+        fs.mkdirSync(path.join(this.root, "runs"), { recursive: true });
+        fs.mkdirSync(path.join(this.root, "state"), { recursive: true });
+        const gitignore = path.join(this.root, ".gitignore");
+        if (!fs.existsSync(gitignore)) {
+            fs.writeFileSync(gitignore, "runs/\nstate/\n");
+        }
+        if (!fs.existsSync(this.scenariosFile)) {
+            fs.writeFileSync(this.scenariosFile, "[]\n");
+        }
+    }
+    get scenariosFile() {
+        return path.join(this.root, "scenarios.json");
+    }
+    exists() {
+        return fs.existsSync(this.scenariosFile);
+    }
+    listScenarios() {
+        if (!this.exists())
+            return [];
+        return JSON.parse(fs.readFileSync(this.scenariosFile, "utf8"));
+    }
+    saveScenarios(scenarios) {
+        fs.writeFileSync(this.scenariosFile, JSON.stringify(scenarios, null, 2) + "\n");
+    }
+    addScenario(input) {
+        const scenarios = this.listScenarios();
+        const id = scenarios.length ? Math.max(...scenarios.map((s) => s.id)) + 1 : 1;
+        const scenario = {
+            id,
+            slug: slugify(input.name),
+            name: input.name,
+            scenario: input.scenario,
+            profile: input.profile,
+            notes: input.notes,
+            status: "pending",
+            createdAt: new Date().toISOString(),
+        };
+        scenarios.push(scenario);
+        this.saveScenarios(scenarios);
+        return scenario;
+    }
+    getScenario(idOrSlug) {
+        return this.listScenarios().find((s) => s.id === Number(idOrSlug) || s.slug === idOrSlug);
+    }
+    updateScenario(id, patch) {
+        const scenarios = this.listScenarios();
+        const idx = scenarios.findIndex((s) => s.id === id);
+        if (idx === -1)
+            throw new Error(`Scenario ${id} not found`);
+        scenarios[idx] = { ...scenarios[idx], ...patch };
+        this.saveScenarios(scenarios);
+    }
+    // ---- cached deterministic scripts ----
+    scriptPath(slug) {
+        return path.join(this.root, "scripts", `${slug}.json`);
+    }
+    loadSteps(slug) {
+        const file = this.scriptPath(slug);
+        if (!fs.existsSync(file))
+            return undefined;
+        return JSON.parse(fs.readFileSync(file, "utf8"));
+    }
+    saveSteps(slug, steps) {
+        fs.writeFileSync(this.scriptPath(slug), JSON.stringify(steps, null, 2) + "\n");
+    }
+    // ---- runs ----
+    newRunDir(slug) {
+        const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+        const dir = path.join(this.root, "runs", `${stamp}-${slug}`);
+        fs.mkdirSync(dir, { recursive: true });
+        return dir;
+    }
+    saveRunResult(result) {
+        fs.writeFileSync(path.join(result.runDir, "result.json"), JSON.stringify(result, null, 2) + "\n");
+    }
+    /** Latest run result per scenario slug (for `scout report`) */
+    latestRuns() {
+        const runsDir = path.join(this.root, "runs");
+        const map = new Map();
+        if (!fs.existsSync(runsDir))
+            return map;
+        const dirs = fs.readdirSync(runsDir).sort(); // timestamp prefix → chronological
+        for (const dir of dirs) {
+            const file = path.join(runsDir, dir, "result.json");
+            if (!fs.existsSync(file))
+                continue;
+            const result = JSON.parse(fs.readFileSync(file, "utf8"));
+            map.set(result.slug, result); // later overwrites earlier
+        }
+        return map;
+    }
+}
+export function slugify(name) {
+    return name
+        .toLowerCase()
+        .normalize("NFD")
+        .replace(/[̀-ͯ]/g, "")
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "")
+        .slice(0, 60);
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,78 @@
+/** How a recorded step finds its element on replay. */
+export interface Target {
+    /** ARIA role + accessible name — preferred, resilient to DOM refactors */
+    role?: string;
+    name?: string;
+    /** CSS path fallback when role+name is not unique */
+    css?: string;
+    /** Human-readable label for reports */
+    description: string;
+}
+export type Step = {
+    kind: "navigate";
+    url: string;
+} | {
+    kind: "click";
+    target: Target;
+} | {
+    kind: "fill";
+    target: Target;
+    value: string;
+} | {
+    kind: "select";
+    target: Target;
+    value: string;
+} | {
+    kind: "press";
+    key: string;
+} | {
+    kind: "waitForText";
+    text: string;
+} | {
+    kind: "waitForUrl";
+    pattern: string;
+} | {
+    kind: "assertVisible";
+    text: string;
+} | {
+    kind: "assertNotVisible";
+    text: string;
+} | {
+    kind: "assertUrl";
+    pattern: string;
+} | {
+    kind: "screenshot";
+    label: string;
+};
+export type Verdict = "verified" | "failed" | "partial" | "blocked";
+export type ScenarioStatus = Verdict | "pending";
+export interface Scenario {
+    id: number;
+    slug: string;
+    name: string;
+    /** Natural-language description of the flow + expected behavior */
+    scenario: string;
+    /** Auth profile name from scout.config.json (omit = anonymous) */
+    profile?: string;
+    status: ScenarioStatus;
+    createdAt: string;
+    lastRun?: string;
+    notes?: string;
+}
+export interface RunResult {
+    scenarioId: number;
+    slug: string;
+    /** replay = cached deterministic steps; ai = agent-driven run */
+    mode: "replay" | "ai";
+    verdict: Verdict;
+    reason: string;
+    stepCount?: number;
+    failedStep?: string;
+    runDir: string;
+    startedAt: string;
+    durationMs: number;
+    screenshots: string[];
+    trace?: string;
+    /** true when this AI run replaced a broken cached script */
+    healed?: boolean;
+}

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":""}