@opice/harness 0.0.3 → 0.1.0

package/dist/element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.js","sourceRoot":"","sources":["../src/element.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,aAAa,GAAG,GAAG,CAAA;AACzB,MAAM,YAAY,GAAG,MAAM,CAAA;AAE3B;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAU,EAAE,gBAAwB;IAC7D,IAAI,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACtC,CAAC;IACD,OAAO,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAA;AAC1C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,EAAE,CAAC,gBAAwB;IAC1C,OAAO,SAAS,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAA;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,MAAc;IACjC,OAAO,iBAAiB,MAAM,IAAI,CAAA;AACnC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC5B,SAA2C,EAC3C,EAAE,OAAO,GAAG,YAAY,EAAE,QAAQ,GAAG,aAAa,EAAE,OAAO,KAAgE,EAAE;IAE7H,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACxB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,OAAO,EAAE,CAAC;QACrC,IAAI,CAAC;YACJ,IAAI,MAAM,SAAS,EAAE;gBAAE,OAAM;QAC9B,CAAC;QAAC,MAAM,CAAC;YACR,2CAA2C;QAC5C,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;IAC9D,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,SAAS,EAAE,CAAC,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAA;QAClC,MAAM,IAAI,GAAG,OAAO,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;QAC1D,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,OAAO,IAAI,EAAE,CAAC,CAAA;IACjE,CAAC;AACF,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,EAAU;IACpC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAc,EAAU;IAC7C,OAAO,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAe,CAAA;AAC5C,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAa;IAC7C,MAAM,MAAM,GAAG,IAAI,IAAI,yBAAyB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAA;IAChE,MAAM,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IAC5C,OAAO,MAAM,CAAA;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { el, tid, waitFor, wait, evalJs, screenshot } from './element.js';
+export { byLabel, byRole, byText } from './accessible.js';
+export { back, currentPath, currentUrl, forward, open, reload } from './navigation.js';
+export { getPage, getContext } from './context.js';
+export { browserTest, step } from './scenario.js';
+export type { BrowserTestOptions } from './scenario.js';
+export { getReporter, setReporter, configureFromEnv } from './reporter.js';
+export type { Reporter, ReporterConfig, StepEvent, ScenarioStart, ScenarioFinish } from './reporter.js';
+export { parseOpiceDsn } from './dsn.js';
+export type { OpiceDsn } from './dsn.js';
+export { command, call, runCommand, makeCtx, loadUserCommands, findUserCommandsFile, z } from './command.js';
+export type { Command, CommandCtx } from './command.js';
+export { expect } from '@playwright/test';
+export type { Locator } from 'playwright';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAEzD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAEtF,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC1E,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEvG,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,CAAC,EAAE,MAAM,cAAc,CAAA;AAC5G,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAIvD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAGzC,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export { el, tid, waitFor, wait, evalJs, screenshot } from './element.js';
+export { byLabel, byRole, byText } from './accessible.js';
+export { back, currentPath, currentUrl, forward, open, reload } from './navigation.js';
+export { getPage, getContext } from './context.js';
+export { browserTest, step } from './scenario.js';
+export { getReporter, setReporter, configureFromEnv } from './reporter.js';
+export { parseOpiceDsn } from './dsn.js';
+export { command, call, runCommand, makeCtx, loadUserCommands, findUserCommandsFile, z } from './command.js';
+// Playwright's web-first `expect` (retrying locator matchers + generic matchers)
+// works under `bun:test`; re-export it so tests use a single `expect`.
+export { expect } from '@playwright/test';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAEzD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAEtF,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAGjD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAG1E,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAGxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,CAAC,EAAE,MAAM,cAAc,CAAA;AAG5G,iFAAiF;AACjF,uEAAuE;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/navigation.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Page navigation primitives. `browserTest` opens the scenario URL for you in
+ * `beforeAll`; these are for mid-scenario navigation — following a hard link,
+ * reloading after mutating storage/cookies, or going back/forward.
+ *
+ * Each navigating call waits for the `load` event (Playwright's default), so
+ * the old agent-browser reload caveat (a reload from inside `eval` getting
+ * dropped) no longer applies — `reload()` drives the page directly.
+ */
+/** Navigate to a URL in the current page. */
+export declare function open(url: string): Promise<void>;
+/** Reload the current page. */
+export declare function reload(): Promise<void>;
+/** Go back in history. */
+export declare function back(): Promise<void>;
+/** Go forward in history. */
+export declare function forward(): Promise<void>;
+/** The current full URL (`location.href`). */
+export declare function currentUrl(): string;
+/** The current path (`location.pathname`). */
+export declare function currentPath(): string;
+//# sourceMappingURL=navigation.d.ts.map

package/dist/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,6CAA6C;AAC7C,wBAAsB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErD;AAED,+BAA+B;AAC/B,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAE5C;AAED,0BAA0B;AAC1B,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1C;AAED,6BAA6B;AAC7B,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAE7C;AAED,8CAA8C;AAC9C,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,8CAA8C;AAC9C,wBAAgB,WAAW,IAAI,MAAM,CAEpC"}

package/dist/navigation.js

@@ -0,0 +1,35 @@
+import { getPage } from './context.js';
+/**
+ * Page navigation primitives. `browserTest` opens the scenario URL for you in
+ * `beforeAll`; these are for mid-scenario navigation — following a hard link,
+ * reloading after mutating storage/cookies, or going back/forward.
+ *
+ * Each navigating call waits for the `load` event (Playwright's default), so
+ * the old agent-browser reload caveat (a reload from inside `eval` getting
+ * dropped) no longer applies — `reload()` drives the page directly.
+ */
+/** Navigate to a URL in the current page. */
+export async function open(url) {
+    await getPage().goto(url);
+}
+/** Reload the current page. */
+export async function reload() {
+    await getPage().reload();
+}
+/** Go back in history. */
+export async function back() {
+    await getPage().goBack();
+}
+/** Go forward in history. */
+export async function forward() {
+    await getPage().goForward();
+}
+/** The current full URL (`location.href`). */
+export function currentUrl() {
+    return getPage().url();
+}
+/** The current path (`location.pathname`). */
+export function currentPath() {
+    return new URL(getPage().url()).pathname;
+}
+//# sourceMappingURL=navigation.js.map

package/dist/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC;;;;;;;;GAQG;AAEH,6CAA6C;AAC7C,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,GAAW;IACrC,MAAM,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC1B,CAAC;AAED,+BAA+B;AAC/B,MAAM,CAAC,KAAK,UAAU,MAAM;IAC3B,MAAM,OAAO,EAAE,CAAC,MAAM,EAAE,CAAA;AACzB,CAAC;AAED,0BAA0B;AAC1B,MAAM,CAAC,KAAK,UAAU,IAAI;IACzB,MAAM,OAAO,EAAE,CAAC,MAAM,EAAE,CAAA;AACzB,CAAC;AAED,6BAA6B;AAC7B,MAAM,CAAC,KAAK,UAAU,OAAO;IAC5B,MAAM,OAAO,EAAE,CAAC,SAAS,EAAE,CAAA;AAC5B,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,UAAU;IACzB,OAAO,OAAO,EAAE,CAAC,GAAG,EAAE,CAAA;AACvB,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,WAAW;IAC1B,OAAO,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAA;AACzC,CAAC"}

package/dist/reporter.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Reporter — streams scenario/step/screenshot events to the opice platform.
+ *
+ * Steps are fire-and-forget (tracked in a pending queue so flush awaits
+ * them). Scenario create + finish are awaited inline so the platform sees
+ * the right status when the test process exits.
+ *
+ * The CLI handles end-of-run finalization: the reporter writes a
+ * handoff file under $TMPDIR with the runId and credentials, the
+ * `opice test` wrapper picks it up after `bun test` exits and POSTs
+ * /api/v1/runs/<id>/finish so the dashboard sees the run as completed.
+ *
+ * When env vars aren't configured, the reporter falls back to a no-op so
+ * harness behavior matches the bindx prototype.
+ */
+export interface ReporterConfig {
+    endpoint: string;
+    projectId: string;
+    apiKey: string;
+    branch?: string;
+    commit?: string;
+    /** 'ci' for runs from automation, 'local' for opted-in dev runs. */
+    source?: 'ci' | 'local';
+}
+export interface StepEvent {
+    scenarioId: string;
+    /** Authoring order within the scenario, assigned at step() call time. */
+    sequence: number;
+    name: string;
+    status: 'passed' | 'failed';
+    durationMs: number;
+    error?: string;
+    screenshotPath?: string;
+}
+export interface ScenarioStart {
+    name: string;
+    hash?: string;
+    testFile?: string;
+    scenarioFile?: string;
+}
+export interface ScenarioFinish {
+    scenarioId: string;
+    status: 'passed' | 'failed';
+    durationMs: number;
+}
+export interface Reporter {
+    startScenario(input: ScenarioStart): Promise<string>;
+    recordStep(event: StepEvent): Promise<void>;
+    finishScenario(input: ScenarioFinish): Promise<void>;
+    flush(): Promise<void>;
+}
+export declare const HANDOFF_DIR: string;
+export interface RunHandoff {
+    endpoint: string;
+    apiKey: string;
+    runId: string;
+}
+export declare function getReporter(): Reporter;
+export declare function setReporter(reporter: Reporter): void;
+export declare function configureFromEnv(env?: NodeJS.ProcessEnv): Reporter;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oEAAoE;IACpE,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,SAAS;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAC3B,UAAU,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,QAAQ;IACxB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACpD,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAWD,eAAO,MAAM,WAAW,QAAwC,CAAA;AAMhE,MAAM,WAAW,UAAU;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACb;AAqJD,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAEpD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,QAAQ,CA8B/E"}

package/dist/reporter.js

@@ -0,0 +1,210 @@
+/**
+ * Reporter — streams scenario/step/screenshot events to the opice platform.
+ *
+ * Steps are fire-and-forget (tracked in a pending queue so flush awaits
+ * them). Scenario create + finish are awaited inline so the platform sees
+ * the right status when the test process exits.
+ *
+ * The CLI handles end-of-run finalization: the reporter writes a
+ * handoff file under $TMPDIR with the runId and credentials, the
+ * `opice test` wrapper picks it up after `bun test` exits and POSTs
+ * /api/v1/runs/<id>/finish so the dashboard sees the run as completed.
+ *
+ * When env vars aren't configured, the reporter falls back to a no-op so
+ * harness behavior matches the bindx prototype.
+ */
+import { promises as fs } from 'node:fs';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { parseOpiceDsn } from './dsn.js';
+class NoopReporter {
+    async startScenario(input) {
+        return `noop-${input.name}-${Date.now()}`;
+    }
+    async recordStep(_event) { }
+    async finishScenario(_input) { }
+    async flush() { }
+}
+export const HANDOFF_DIR = path.join(tmpdir(), 'opice-handoffs');
+function handoffPath(pid = process.pid) {
+    return path.join(HANDOFF_DIR, `${pid}.json`);
+}
+class HttpReporter {
+    config;
+    runIdPromise = null;
+    pending = new Set();
+    warnedUnreachable = false;
+    constructor(config) {
+        this.config = config;
+    }
+    async ensureRun() {
+        if (!this.runIdPromise) {
+            this.runIdPromise = this.startRun();
+        }
+        return this.runIdPromise;
+    }
+    async startRun() {
+        const response = await this.fetch('POST', '/api/v1/runs', {
+            branch: this.config.branch,
+            commit: this.config.commit,
+            source: this.config.source,
+        });
+        const runId = response['runId'];
+        // Synchronous write so the CLI can pick this up even if the test
+        // process exits abruptly (process.on('exit') runs sync).
+        try {
+            mkdirSync(HANDOFF_DIR, { recursive: true });
+            const handoff = { endpoint: this.config.endpoint, apiKey: this.config.apiKey, runId };
+            writeFileSync(handoffPath(), JSON.stringify(handoff), 'utf-8');
+        }
+        catch {
+            // best-effort
+        }
+        return runId;
+    }
+    async startScenario(input) {
+        const runId = await this.ensureRun();
+        const response = await this.fetch('POST', `/api/v1/runs/${runId}/scenarios`, {
+            name: input.name,
+            hash: input.hash,
+            testFile: input.testFile,
+            scenarioFile: input.scenarioFile,
+        });
+        return response['scenarioId'];
+    }
+    recordStep(event) {
+        // Track synchronously so flush() awaits the entire pipeline (including
+        // encodeScreenshot's fs.readFile and the upload), not just whatever
+        // fragment has run by the time afterAll fires.
+        const promise = this.recordStepInternal(event);
+        this.track(promise);
+        return promise;
+    }
+    async recordStepInternal(event) {
+        const runId = await this.ensureRun();
+        const screenshot = event.screenshotPath
+            ? await this.encodeScreenshot(event.screenshotPath)
+            : undefined;
+        await this.fetch('POST', `/api/v1/runs/${runId}/scenarios/${event.scenarioId}/steps`, {
+            sequence: event.sequence,
+            name: event.name,
+            status: event.status,
+            durationMs: event.durationMs,
+            error: event.error,
+            screenshot,
+        });
+    }
+    async finishScenario(input) {
+        const runId = await this.ensureRun();
+        // Awaited inline so the scenario status is committed before the
+        // bun:test afterAll returns.
+        await this.fetch('PATCH', `/api/v1/runs/${runId}/scenarios/${input.scenarioId}`, {
+            status: input.status,
+            durationMs: input.durationMs,
+        });
+    }
+    async flush() {
+        await Promise.allSettled([...this.pending]);
+        // finishRun is the CLI's responsibility — see handoff file.
+    }
+    track(promise) {
+        this.pending.add(promise);
+        promise.finally(() => this.pending.delete(promise));
+    }
+    async encodeScreenshot(path) {
+        try {
+            const buf = await fs.readFile(path);
+            return buf.toString('base64');
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async fetch(method, path, body) {
+        let response;
+        try {
+            response = await fetch(this.config.endpoint + path, {
+                method,
+                headers: {
+                    'authorization': `Bearer ${this.config.apiKey}`,
+                    'content-type': 'application/json',
+                },
+                body: body == null ? undefined : JSON.stringify(body),
+            });
+        }
+        catch (err) {
+            // Network error / blocked request (e.g. a test runner that installs a
+            // DOM and routes fetch through a same-origin policy). Callers swallow
+            // reporter errors so the test still runs, so this is the one place the
+            // failure is visible — make it loud and actionable.
+            this.warnUnreachable(`${method} ${path}`, err instanceof Error ? err.message : String(err));
+            throw err;
+        }
+        if (!response.ok) {
+            const detail = `${response.status} ${await response.text()}`.trim();
+            this.warnUnreachable(`${method} ${path}`, detail);
+            throw new Error(`opice reporter ${method} ${path} failed: ${detail}`);
+        }
+        return (await response.json());
+    }
+    /**
+     * A configured reporter that can't reach the platform means the run is
+     * silently NOT recorded — the most confusing failure mode in onboarding
+     * (the test passes, but nothing shows on the dashboard). Surface it once,
+     * with the usual culprits, instead of letting the swallowed throw vanish.
+     */
+    warnUnreachable(call, detail) {
+        if (this.warnedUnreachable)
+            return;
+        this.warnedUnreachable = true;
+        console.error(`[opice] reporter could not reach the platform (${call}: ${detail}). `
+            + `This run will NOT be recorded on the dashboard.\n`
+            + `[opice] Common causes:\n`
+            + `[opice]   - the test runner's global setup installs a DOM (happy-dom/jsdom) or mocks\n`
+            + `[opice]     fetch, so the cross-origin POST is blocked (look for "Cross-Origin Request\n`
+            + `[opice]     Blocked" / an OPTIONS … 401). Scope that setup so it skips the e2e dir.\n`
+            + `[opice]   - a missing / expired OPICE_DSN api key (401), or an unreachable endpoint.`);
+    }
+}
+let active = new NoopReporter();
+export function getReporter() {
+    return active;
+}
+export function setReporter(reporter) {
+    active = reporter;
+}
+export function configureFromEnv(env = process.env) {
+    // Individual vars win; OPICE_DSN fills any gaps (see dsn.ts).
+    const dsn = parseOpiceDsn(env['OPICE_DSN']);
+    const endpoint = env['OPICE_ENDPOINT'] ?? dsn?.endpoint;
+    const projectId = env['OPICE_PROJECT'] ?? dsn?.project;
+    const apiKey = env['OPICE_API_KEY'] ?? dsn?.apiKey;
+    if (!endpoint || !projectId || !apiKey) {
+        return new NoopReporter();
+    }
+    // Reporting is opt-in outside CI. A local `bun test` while authoring would
+    // otherwise stream half-finished runs onto the shared dashboard (they never
+    // get the CLI's POST /finish, so they'd sit there as "running" forever).
+    // CI reports automatically; OPICE_REPORT=always forces it locally, =never
+    // silences it everywhere.
+    const isCI = !!(env['CI'] || env['GITHUB_ACTIONS']);
+    const mode = (env['OPICE_REPORT'] ?? 'auto').toLowerCase();
+    const shouldReport = mode === 'never' ? false : mode === 'always' ? true : isCI;
+    if (!shouldReport) {
+        return new NoopReporter();
+    }
+    const reporter = new HttpReporter({
+        endpoint,
+        projectId,
+        apiKey,
+        branch: env['OPICE_BRANCH'] ?? env['GITHUB_REF_NAME'],
+        commit: env['OPICE_COMMIT'] ?? env['GITHUB_SHA'],
+        source: isCI ? 'ci' : 'local',
+    });
+    setReporter(reporter);
+    return reporter;
+}
+// Auto-configure when imported.
+configureFromEnv();
+//# sourceMappingURL=reporter.js.map

package/dist/reporter.js.map

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

package/dist/scenario.d.ts

@@ -0,0 +1,30 @@
+export interface BrowserTestOptions {
+    /** Hash fragment appended to PLAYGROUND_URL (e.g. 'datagrid'). */
+    hash?: string;
+    /** Override base URL (defaults to PLAYGROUND_URL env). */
+    url?: string;
+    /**
+     * Path to the human-readable `*.scenario.md` this test was authored from.
+     * Reported to the platform so the re-eval workflow can find the source.
+     * If omitted, defaults to the test file path with `.test.ts` → `.scenario.md`.
+     */
+    scenarioFile?: string;
+}
+/**
+ * Register a top-level browser test scenario.
+ *
+ * Each `browserTest(name, fn)` launches its own isolated Playwright browser +
+ * context + page, navigates to the playground URL, runs the given `fn` (which
+ * typically contains nested `describe`/`test` blocks), and tears the browser
+ * down in `afterAll`.
+ */
+export declare function browserTest(name: string, fn: () => void, options?: BrowserTestOptions | string): void;
+/**
+ * A reportable step inside a scenario. Captures duration + screenshot on
+ * finish, forwards to the active reporter (no-op unless configured via env).
+ *
+ * The body may be sync or async; `step` always returns a promise, so call it
+ * with `await step('…', async () => { … })`.
+ */
+export declare function step(name: string, fn: () => void | Promise<void>): Promise<void>;
+//# sourceMappingURL=scenario.d.ts.map

package/dist/scenario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario.d.ts","sourceRoot":"","sources":["../src/scenario.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,kBAAkB;IAClC,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB;AAuCD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,EAAE,OAAO,GAAE,kBAAkB,GAAG,MAAW,GAAG,IAAI,CAoDzG;AAED;;;;;;GAMG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCtF"}

package/dist/scenario.js

@@ -0,0 +1,162 @@
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { closePage, launchPage } from './context.js';
+import { screenshot } from './element.js';
+import { getReporter } from './reporter.js';
+/**
+ * `bun:test` is resolved lazily, at the moment `browserTest` registers a
+ * scenario — never at module load. That keeps `@opice/harness` importable
+ * under plain Node (the `opice-browser` authoring daemon imports the command
+ * registry from this package and runs on Node, where `bun:test` doesn't
+ * exist). Tests still register synchronously: `require` is sync under Bun.
+ */
+const require = createRequire(import.meta.url);
+function bunTest() {
+    return require('bun:test');
+}
+const PLAYGROUND_URL = process.env['PLAYGROUND_URL'] ?? 'http://localhost:15180';
+/**
+ * Best-effort capture of the `*.test.ts` path that called `browserTest`, by
+ * walking the stack for the first `.test.` frame. Reported so a failed
+ * scenario links back to its source file. Repo-relative when possible.
+ */
+function captureTestFile() {
+    const stack = new Error().stack;
+    if (!stack)
+        return undefined;
+    for (const line of stack.split('\n')) {
+        const match = line.match(/\(?((?:file:\/\/)?\/[^\s():]+\.test\.[tj]sx?)/);
+        if (match?.[1]) {
+            const abs = match[1].replace(/^file:\/\//, '');
+            try {
+                const rel = path.relative(process.cwd(), abs);
+                return rel.startsWith('..') ? abs : rel;
+            }
+            catch {
+                return abs;
+            }
+        }
+    }
+    return undefined;
+}
+function defaultScenarioFile(testFile) {
+    if (!testFile)
+        return undefined;
+    return testFile.replace(/\.test\.[tj]sx?$/, '.scenario.md');
+}
+let currentScenarioId = null;
+let currentScenarioStart = 0;
+let currentScenarioFailures = 0;
+// Monotonic per-scenario step counter. Assigned synchronously at each step()
+// call so order reflects authoring order — step records are POSTed
+// fire-and-forget and would otherwise be sequenced by arrival order at the
+// worker, which screenshot-encoding latency can reshuffle.
+let currentScenarioStepSeq = 0;
+/**
+ * Register a top-level browser test scenario.
+ *
+ * Each `browserTest(name, fn)` launches its own isolated Playwright browser +
+ * context + page, navigates to the playground URL, runs the given `fn` (which
+ * typically contains nested `describe`/`test` blocks), and tears the browser
+ * down in `afterAll`.
+ */
+export function browserTest(name, fn, options = {}) {
+    const opts = typeof options === 'string' ? { hash: options } : options;
+    const reporter = getReporter();
+    const testFile = captureTestFile();
+    const scenarioFile = opts.scenarioFile ?? defaultScenarioFile(testFile);
+    const { describe, beforeAll, afterAll } = bunTest();
+    describe(name, () => {
+        beforeAll(async () => {
+            currentScenarioStart = Date.now();
+            currentScenarioFailures = 0;
+            currentScenarioStepSeq = 0;
+            try {
+                currentScenarioId = await reporter.startScenario({ name, hash: opts.hash, testFile, scenarioFile });
+            }
+            catch {
+                currentScenarioId = null;
+            }
+            const page = await launchPage();
+            const base = opts.url ?? PLAYGROUND_URL;
+            const url = opts.hash ? `${base}#${opts.hash}` : base;
+            await page.goto(url);
+        }, 30_000);
+        afterAll(async () => {
+            try {
+                await closePage();
+            }
+            catch {
+                // ignore close errors
+            }
+            if (currentScenarioId) {
+                // Drain pending step records (incl. their screenshot uploads)
+                // before marking the scenario done. step() fires recordStep
+                // fire-and-forget; the test process would otherwise exit while
+                // those requests were still in flight.
+                try {
+                    await reporter.flush();
+                }
+                catch {
+                    // best-effort
+                }
+                const durationMs = Date.now() - currentScenarioStart;
+                const status = currentScenarioFailures > 0 ? 'failed' : 'passed';
+                try {
+                    await reporter.finishScenario({ scenarioId: currentScenarioId, status, durationMs });
+                }
+                catch {
+                    // best-effort
+                }
+            }
+            currentScenarioId = null;
+        }, 30_000);
+        fn();
+    });
+}
+/**
+ * A reportable step inside a scenario. Captures duration + screenshot on
+ * finish, forwards to the active reporter (no-op unless configured via env).
+ *
+ * The body may be sync or async; `step` always returns a promise, so call it
+ * with `await step('…', async () => { … })`.
+ */
+export async function step(name, fn) {
+    const reporter = getReporter();
+    // Capture order at call time, before the fire-and-forget record below.
+    const sequence = currentScenarioStepSeq++;
+    const start = Date.now();
+    let status = 'passed';
+    let error;
+    try {
+        await fn();
+    }
+    catch (e) {
+        status = 'failed';
+        error = e instanceof Error ? e.message : String(e);
+        currentScenarioFailures++;
+        throw e;
+    }
+    finally {
+        const durationMs = Date.now() - start;
+        let screenshotPath;
+        try {
+            screenshotPath = await screenshot();
+        }
+        catch {
+            // screenshot failure shouldn't fail the test
+        }
+        if (currentScenarioId) {
+            void reporter.recordStep({
+                scenarioId: currentScenarioId,
+                sequence,
+                name,
+                status,
+                durationMs,
+                error,
+                screenshotPath,
+            });
+        }
+    }
+}
+//# sourceMappingURL=scenario.js.map

package/dist/scenario.js.map

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

package/package.json

@@ -1,19 +1,21 @@
 {
 	"name": "@opice/harness",
-	"version": "0.0.3",
-	"description": "Runtime primitives for opice — AI-driven E2E browser tests on top of agent-browser",
+	"version": "0.1.0",
+	"description": "Runtime primitives for opice — AI-driven E2E browser tests on top of Playwright",
 	"type": "module",
 	"main": "./src/index.ts",
 	"types": "./src/index.ts",
 	"exports": {
 		".": {
 			"types": "./src/index.ts",
-			"import": "./src/index.ts",
-			"default": "./src/index.ts"
+			"bun": "./src/index.ts",
+			"import": "./dist/index.js",
+			"default": "./dist/index.js"
 		}
 	},
 	"files": [
 		"src",
+		"dist",
 		"README.md"
 	],
 	"scripts": {
@@ -31,5 +33,10 @@
 	},
 	"publishConfig": {
 		"access": "public"
+	},
+	"dependencies": {
+		"@playwright/test": "^1.60.0",
+		"playwright": "^1.60.0",
+		"zod": "^4.4.3"
 	}
 }