@e2edev/e2e 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TesterArmy, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,104 @@
+# e2e
+
+The `e2e` SDK, runner, and CLI for agentic end-to-end testing. Full
+documentation: [e2e.docs.buildwithfern.com](https://e2e.docs.buildwithfern.com).
+
+```bash
+pnpm add -D e2e@beta @e2edev/playwright@beta
+```
+
+## Usage
+
+```bash
+e2e init
+APP_URL=http://localhost:3000 e2e run
+```
+
+```ts title="e2e.config.ts"
+import { defineConfig } from '@e2edev/e2e';
+import { playwright } from '@e2edev/playwright';
+
+export default defineConfig({
+  app: { url: process.env.APP_URL ?? 'http://localhost:3000' },
+  targets: [{ name: 'web', platform: 'web', backend: playwright() }],
+});
+```
+
+```ts
+import { test } from '@e2edev/playwright';
+import { expect } from '@e2edev/e2e';
+
+test('user signs in', async ({ app, screen, web }) => {
+  await app.open('/login');
+  await screen.getByLabel('Email').fill('user@example.test');
+  await screen.getByRole('button', { name: 'Sign in' }).tap();
+  await expect(web).toHaveURL('/dashboard');
+});
+```
+
+The runner itself knows no platform: every target names the backend that
+drives it, and `@e2edev/playwright` is the browser one. Missing Playwright
+browsers are downloaded on first run. To provision them ahead of time (for
+example in a CI image), run `npx playwright install chromium`.
+
+Run files in parallel with `--workers`, or set `workers` in the config.
+
+## Agent steps
+
+Deterministic tests need no model. Agent steps — `agent.act`, `assert`,
+`waitFor`, and `extract` — require one:
+
+```ts
+export default defineConfig({
+  agent: { model: 'anthropic/claude-sonnet-4.5' },
+});
+```
+
+```bash
+E2E_MODEL=openai/gpt-5.4-mini E2E_MODEL_API_KEY=... e2e run
+```
+
+A `provider/model-id` string goes through the
+[Vercel AI Gateway](https://vercel.com/docs/ai-gateway). To use a provider
+directly, pass any AI SDK model instance instead:
+
+```ts
+import { openai } from '@ai-sdk/openai';
+
+export default defineConfig({
+  agent: { model: openai('gpt-5.4-mini') },
+});
+```
+
+Screenshots, raw HTML, cookies, headers, and registered secret values are never
+sent to the model.
+
+The adaptive trace cache (`trace-1`) replays a passing `agent.act()` step's
+recorded actions zero-turn on the next run, diverging to the live agent
+mid-step whenever the app no longer matches the recording, or whenever the
+recorded actions ran but the recorded end state is not on screen again. An
+entry is written only after a later assertion confirms the step's outcome. It
+is on by default (`read-write`; CI forces the file store to `read-only`, while
+a host-supplied store keeps its configured mode) — opt out with
+`cache: 'off'` or per run with `--no-cache`. Entries live under
+`.e2e/cache/` or in any custom `TraceCacheStore`. Judgments (`assert`,
+`waitFor`, `extract`) are never cached — every judgment is made fresh, per
+run, from a fresh observation.
+
+`e2e run --ai-trace` records every model call of the run — prompt, tool
+definitions, response, usage, cost — to `.e2e/ai-trace.json`, one run per
+agent step, in the AI SDK devtools database shape. Open it with
+[unbox-ai](https://github.com/tester-army/unbox-ai):
+`npx unbox-ai .e2e/ai-trace.json`.
+
+## Current limitations
+
+- `agent.act` structured output (`options.schema`) and vision evidence
+  (`options.vision`) reject with `UNSUPPORTED_CAPABILITY`.
+- The HTML reporter and video artifacts are not available.
+- Reported steps carry no source locations.
+- iOS and Android need a backend package; none ships in this repo yet.
+
+## Contributing
+
+See [CONTRIBUTING.md](https://github.com/tester-army/e2e/blob/main/CONTRIBUTING.md).

package/dist/agent/act-validation.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Input and verdict validation for the act dispatch (spec 02, 16). Pure
+ * functions with no dispatch state: everything a step's arguments and an
+ * executor's verdict must satisfy before the harness trusts them.
+ */
+import type { AgentOptions, AgentParams, JsonValue, Secret } from '../types.ts';
+import { type StepVerdict } from './executor.ts';
+/** Normalizes and bounds the instruction per spec 02. */
+export declare function validateInstruction(instruction: string, api: string): string;
+/** Options the socket does not support yet fail loudly, like `schema` does. */
+export declare function rejectUnsupportedActOptions(options: AgentOptions | undefined): void;
+/**
+ * Validates parameters and returns an inert, secret-free snapshot plus the
+ * declared secrets. A `Secret` value is projected to
+ * `{ kind: 'secret', name, purpose }` — its plaintext never enters the
+ * snapshot, the prompt, or any log — and is fillable only through
+ * `actions.typeSecret`. The JSON round-trip is deliberate: it bounds the
+ * canonical size (spec 02) and freezes what the executor sees, so a getter
+ * or proxy cannot change values — or run code — during later serialization.
+ */
+export declare function validateParams(params: AgentParams | undefined): {
+    projected: Readonly<Record<string, JsonValue>> | undefined;
+    secrets: ReadonlyMap<string, Secret>;
+};
+/** Closes the verdict grammar: the executor cannot invent statuses or codes. */
+export declare function validateVerdict(verdict: unknown, executorName: string): StepVerdict;
+//# sourceMappingURL=act-validation.d.ts.map

package/dist/agent/act-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"act-validation.d.ts","sourceRoot":"","sources":["../../src/agent/act-validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAkB,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEhG,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAWlE,yDAAyD;AACzD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAa5E;AAED,+EAA+E;AAC/E,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,CAUnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG;IAC/D,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC;IAC3D,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,CAoBA;AAqBD,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,WAAW,CAqCnF"}

package/dist/agent/act-validation.js

@@ -0,0 +1,121 @@
+/**
+ * Input and verdict validation for the act dispatch (spec 02, 16). Pure
+ * functions with no dispatch state: everything a step's arguments and an
+ * executor's verdict must satisfy before the harness trusts them.
+ */
+import { ConfigurationError, TestError } from '../internal/errors.js';
+import { validateJsonValue } from '../internal/json-value.js';
+import { isSecret } from '../locator/screen.js';
+import { AgentError, CATEGORY_BY_CODE } from './error.js';
+import { BLOCKABLE_CODES } from './executor.js';
+const MAX_SUMMARY_CHARS = 2_000;
+/** Spec 02: instructions are 1 through 8 KiB UTF-8 after NFC. */
+const MAX_INSTRUCTION_BYTES = 8_192;
+/** Spec 02: canonical non-secret parameters are capped at 64 KiB, 32 levels. */
+const MAX_PARAMS_BYTES = 65_536;
+const MAX_PARAMS_DEPTH = 32;
+/** Normalizes and bounds the instruction per spec 02. */
+export function validateInstruction(instruction, api) {
+    if (typeof instruction !== 'string' || instruction.trim() === '') {
+        throw new TestError('INVALID_ARGUMENT', `${api} requires a non-empty instruction`);
+    }
+    const normalized = instruction.normalize('NFC');
+    const bytes = new TextEncoder().encode(normalized).byteLength;
+    if (bytes > MAX_INSTRUCTION_BYTES) {
+        throw new TestError('INVALID_ARGUMENT', `${api} instruction is ${bytes} bytes; the maximum is ${MAX_INSTRUCTION_BYTES}`);
+    }
+    return normalized;
+}
+/** Options the socket does not support yet fail loudly, like `schema` does. */
+export function rejectUnsupportedActOptions(options) {
+    if (options === undefined)
+        return;
+    const unsupported = (name) => {
+        throw new ConfigurationError('UNSUPPORTED_CAPABILITY', `agent.act ${name} is not part of this milestone`);
+    };
+    if ('schema' in options && options.schema !== undefined)
+        unsupported('structured output (options.schema)');
+    if (options.vision !== undefined)
+        unsupported('vision evidence (options.vision)');
+}
+/**
+ * Validates parameters and returns an inert, secret-free snapshot plus the
+ * declared secrets. A `Secret` value is projected to
+ * `{ kind: 'secret', name, purpose }` — its plaintext never enters the
+ * snapshot, the prompt, or any log — and is fillable only through
+ * `actions.typeSecret`. The JSON round-trip is deliberate: it bounds the
+ * canonical size (spec 02) and freezes what the executor sees, so a getter
+ * or proxy cannot change values — or run code — during later serialization.
+ */
+export function validateParams(params) {
+    if (params === undefined)
+        return { projected: undefined, secrets: new Map() };
+    if (typeof params !== 'object' || params === null || Array.isArray(params)) {
+        throw new TestError('INVALID_ARGUMENT', 'agent.act params must be a plain object');
+    }
+    const secrets = new Map();
+    const projectedRaw = projectSecrets(params, secrets, new Set());
+    validateJsonValue(projectedRaw, 'agent.act params', { maxDepth: MAX_PARAMS_DEPTH });
+    const canonical = JSON.stringify(projectedRaw);
+    const bytes = new TextEncoder().encode(canonical).byteLength;
+    if (bytes > MAX_PARAMS_BYTES) {
+        throw new TestError('INVALID_ARGUMENT', `agent.act params are ${bytes} canonical bytes; the maximum is ${MAX_PARAMS_BYTES}`);
+    }
+    return {
+        projected: JSON.parse(canonical),
+        secrets,
+    };
+}
+/** Replaces every Secret leaf with its placeholder, collecting the originals. */
+function projectSecrets(value, secrets, seen) {
+    if (isSecret(value)) {
+        secrets.set(value.name, value);
+        return { kind: 'secret', name: value.name, purpose: value.purpose };
+    }
+    if (typeof value !== 'object' || value === null)
+        return value;
+    if (seen.has(value)) {
+        throw new TestError('INVALID_ARGUMENT', 'agent.act params contains a cycle');
+    }
+    seen.add(value);
+    if (Array.isArray(value)) {
+        return value.map((entry) => projectSecrets(entry, secrets, seen));
+    }
+    return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, projectSecrets(entry, secrets, seen)]));
+}
+/** Closes the verdict grammar: the executor cannot invent statuses or codes. */
+export function validateVerdict(verdict, executorName) {
+    const invalid = (issue) => {
+        throw new AgentError('MODEL_OUTPUT_INVALID', `executor "${executorName}" returned an invalid verdict: ${issue}`);
+    };
+    if (typeof verdict !== 'object' || verdict === null)
+        return invalid('not an object');
+    const candidate = verdict;
+    const status = candidate['status'];
+    if (status !== 'passed' && status !== 'failed' && status !== 'blocked') {
+        return invalid(`status must be passed, failed, or blocked, got ${JSON.stringify(status)}`);
+    }
+    const summary = candidate['summary'];
+    if (typeof summary !== 'string' || summary.trim() === '') {
+        return invalid('summary must be a non-empty string');
+    }
+    const errorCode = candidate['errorCode'];
+    if (errorCode !== undefined) {
+        if (typeof errorCode !== 'string' || !(errorCode in CATEGORY_BY_CODE)) {
+            return invalid(`unknown errorCode ${JSON.stringify(errorCode)}`);
+        }
+    }
+    const code = errorCode;
+    if (status === 'passed' && code !== undefined) {
+        return invalid('a passed verdict cannot carry an errorCode');
+    }
+    if (status === 'blocked' && (code === undefined || !BLOCKABLE_CODES.has(code))) {
+        return invalid(`blocked requires a blockable errorCode (one of ${[...BLOCKABLE_CODES].join(', ')})`);
+    }
+    return {
+        status,
+        summary: summary.trim().slice(0, MAX_SUMMARY_CHARS),
+        ...(code === undefined ? {} : { errorCode: code }),
+    };
+}
+//# sourceMappingURL=act-validation.js.map

package/dist/agent/act-validation.js.map

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

package/dist/agent/act.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Harness-owned dispatch of one `agent.act()` step (RFC0001, layer 3).
+ *
+ * The harness opens the step, owns the deadline, the action budget, origin
+ * policy, observation redaction, and recording — then hands the step to the
+ * configured executor and maps its verdict back onto the runner's error
+ * taxonomy. The executor never touches the backend: everything bottoms out in
+ * the context built here, on the same accounting core (phases.ts) the
+ * locate/judgment tier runs on. Trace-cache participation — replay, live
+ * recording, staging — lives beside the dispatch in `StepTraceSession`.
+ */
+import type { AgentOptions, AgentParams, AgentResult } from '../types.ts';
+import type { AgentContext } from './invocation.ts';
+/** Runs one `agent.act()` call as a harness-dispatched executor step. */
+export declare function runActStep(runtime: AgentContext, instruction: string, params: AgentParams | undefined, options: AgentOptions | undefined): Promise<AgentResult>;
+/**
+ * Runs one `agent.assert()` call through the executor socket. Used when a
+ * custom executor is configured: the brain that plans flows also judges
+ * assertions, so swapping brains swaps all the thinking. The built-in
+ * single-judgment tier remains the default-path implementation.
+ */
+export declare function runAssertStep(runtime: AgentContext, assertion: string, options: {
+    timeout?: number;
+    vision?: unknown;
+    screenshot?: boolean;
+} | undefined): Promise<void>;
+//# sourceMappingURL=act.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"act.d.ts","sourceRoot":"","sources":["../../src/agent/act.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,OAAO,KAAK,EAEV,YAAY,EACZ,WAAW,EACX,WAAW,EAKZ,MAAM,aAAa,CAAC;AAkBrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA6BpD,yEAAyE;AACzE,wBAAsB,UAAU,CAC9B,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,OAAO,EAAE,YAAY,GAAG,SAAS,GAChC,OAAO,CAAC,WAAW,CAAC,CAgBtB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,GAChF,OAAO,CAAC,IAAI,CAAC,CAqBf"}