AgenticStream Playwright Reporter

A high-density, token-efficient Playwright reporter designed for autonomous AI coding agents.

Features

• Zero-Latency: Streams to stdout, no file I/O
• Token Efficiency: "Silence on Success" - passing tests emit nothing
• High-Signal: Captures stack traces, console logs, attachments
• Overflow Protection: Truncates after N failures to prevent context exhaustion
• Extensible: Custom hint patterns and output streams

Installation

npm install @looted/agentic-reporter

Usage

// playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
  reporter: process.env['AGENTIC_REPORTER']
    ? [['@looted/agentic-reporter', { maxFailures: 5 }]]
    : [['html', { open: 'never' }]],
});

Options

Option	Type	Default	Description
maxFailures	number/boolean	false	Max failures before stopping execution
maxStackFrames	number	8	Stack trace depth
maxLogLines	number	5	Console log lines
maxLogChars	number	500	Max log characters
includeAttachments	boolean	true	Include trace/screenshot paths
checkPreviousReports	boolean	false	Prompt to continue if previous failures exist
progressInterval	number/boolean	60000	Interval in ms to emit an XML progress update
outputStream	WritableStream	stdout	Custom output stream
getReproduceCommand	function	-	Custom callback to generate reproduce command

Custom Reproduce Command

You can customize the reproduce command output by providing a callback function. This is useful for wrapping the Playwright command in a shell script or custom runner.

import { defineConfig } from '@playwright/test';
import { agenticReporter } from '@looted/agentic-reporter';

export default defineConfig({
  reporter: [
    agenticReporter({
      getReproduceCommand: ({ file, line, project }) => {
        return `./run-e2e.sh ${file}:${line} --project=${project}`;
      },
    }),
  ],
});

Output Format

<test_run>
  <suite_info total="45" workers="4" project="chromium" />

  <failure id="auth_login" type="timeout" file="auth.spec.ts" line="24">
    <error_summary>TimeoutError: Timeout 5000ms exceeded.</error_summary>
    <context_markdown><![CDATA[
**Test:** should login successfully
**File:** `auth.spec.ts:24`

**Error Stack:**
\`\`\`text
at tests/auth.spec.ts:24:20
\`\`\`

**Hint:** Selector missing/hidden? Check element visibility.
    ]]></context_markdown>
    <reproduce_command>npx playwright test auth.spec.ts:24 --project=chromium</reproduce_command>
  </failure>

  <result_summary status="failed" passed="43" failed="2" skipped="0" duration="14520ms" />
</test_run>

License

MIT