@cotestdev/mcp_playwright 0.0.14 → 0.0.16

package/lib/mcp/test/plannerTools.js

@@ -0,0 +1,144 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var plannerTools_exports = {};
+__export(plannerTools_exports, {
+  saveTestPlan: () => saveTestPlan,
+  setupPage: () => setupPage,
+  submitTestPlan: () => submitTestPlan
+});
+module.exports = __toCommonJS(plannerTools_exports);
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_mcpBundle = require("../../mcpBundleImpl");
+var import_testTool = require("./testTool");
+const setupPage = (0, import_testTool.defineTestTool)({
+  schema: {
+    name: "planner_setup_page",
+    title: "Setup planner page",
+    description: "Setup the page for test planning",
+    inputSchema: import_mcpBundle.z.object({
+      project: import_mcpBundle.z.string().optional().describe('Project to use for setup. For example: "chromium", if no project is provided uses the first project in the config.'),
+      seedFile: import_mcpBundle.z.string().optional().describe('A seed file contains a single test that is used to setup the page for testing, for example: "tests/seed.spec.ts". If no seed file is provided, a default seed file is created.')
+    }),
+    type: "readOnly"
+  },
+  handle: async (context, params) => {
+    const seed = await context.getOrCreateSeedFile(params.seedFile, params.project);
+    const { output, status } = await context.runSeedTest(seed.file, seed.projectName);
+    return { content: [{ type: "text", text: output }], isError: status !== "paused" };
+  }
+});
+const planSchema = import_mcpBundle.z.object({
+  overview: import_mcpBundle.z.string().describe("A brief overview of the application to be tested"),
+  suites: import_mcpBundle.z.array(import_mcpBundle.z.object({
+    name: import_mcpBundle.z.string().describe("The name of the suite"),
+    seedFile: import_mcpBundle.z.string().describe("A seed file that was used to setup the page for testing."),
+    tests: import_mcpBundle.z.array(import_mcpBundle.z.object({
+      name: import_mcpBundle.z.string().describe("The name of the test"),
+      file: import_mcpBundle.z.string().describe('The file the test should be saved to, for example: "tests/<suite-name>/<test-name>.spec.ts".'),
+      steps: import_mcpBundle.z.array(import_mcpBundle.z.string().describe(`The steps to be executed to perform the test. For example: 'Click on the "Submit" button'`)),
+      expectedResults: import_mcpBundle.z.array(import_mcpBundle.z.string().describe("The expected results of the steps for test to verify."))
+    }))
+  }))
+});
+const submitTestPlan = (0, import_testTool.defineTestTool)({
+  schema: {
+    name: "planner_submit_plan",
+    title: "Submit test plan",
+    description: "Submit the test plan to the test planner",
+    inputSchema: planSchema,
+    type: "readOnly"
+  },
+  handle: async (context, params) => {
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(params, null, 2)
+      }]
+    };
+  }
+});
+const saveTestPlan = (0, import_testTool.defineTestTool)({
+  schema: {
+    name: "planner_save_plan",
+    title: "Save test plan as markdown file",
+    description: "Save the test plan as a markdown file",
+    inputSchema: planSchema.extend({
+      name: import_mcpBundle.z.string().describe('The name of the test plan, for example: "Test Plan".'),
+      fileName: import_mcpBundle.z.string().describe('The file to save the test plan to, for example: "spec/test.plan.md". Relative to the workspace root.')
+    }),
+    type: "readOnly"
+  },
+  handle: async (context, params) => {
+    const lines = [];
+    lines.push(`# ${params.name}`);
+    lines.push(``);
+    lines.push(`## Application Overview`);
+    lines.push(``);
+    lines.push(params.overview);
+    lines.push(``);
+    lines.push(`## Test Scenarios`);
+    for (let i = 0; i < params.suites.length; i++) {
+      lines.push(``);
+      const suite = params.suites[i];
+      lines.push(`### ${i + 1}. ${suite.name}`);
+      lines.push(``);
+      lines.push(`**Seed:** \`${suite.seedFile}\``);
+      for (let j = 0; j < suite.tests.length; j++) {
+        lines.push(``);
+        const test = suite.tests[j];
+        lines.push(`#### ${i + 1}.${j + 1}. ${test.name}`);
+        lines.push(``);
+        lines.push(`**File:** \`${test.file}\``);
+        lines.push(``);
+        lines.push(`**Steps:**`);
+        for (let k = 0; k < test.steps.length; k++)
+          lines.push(`  ${k + 1}. ${test.steps[k]}`);
+        lines.push(``);
+        lines.push(`**Expected Results:**`);
+        for (const result of test.expectedResults)
+          lines.push(`  - ${result}`);
+      }
+    }
+    lines.push(``);
+    await import_fs.default.promises.writeFile(import_path.default.resolve(context.rootPath, params.fileName), lines.join("\n"));
+    return {
+      content: [{
+        type: "text",
+        text: `Test plan saved to ${params.fileName}`
+      }]
+    };
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  saveTestPlan,
+  setupPage,
+  submitTestPlan
+});

package/lib/mcp/test/seed.js

@@ -0,0 +1,82 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var seed_exports = {};
+__export(seed_exports, {
+  defaultSeedFile: () => defaultSeedFile,
+  ensureSeedFile: () => ensureSeedFile,
+  findSeedFile: () => findSeedFile,
+  seedFileContent: () => seedFileContent,
+  seedProject: () => seedProject
+});
+module.exports = __toCommonJS(seed_exports);
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_utils = require("playwright-core/lib/utils");
+var import_projectUtils = require("../../runner/projectUtils");
+function seedProject(config, projectName) {
+  if (!projectName)
+    return (0, import_projectUtils.findTopLevelProjects)(config)[0];
+  const project = config.projects.find((p) => p.project.name === projectName);
+  if (!project)
+    throw new Error(`Project ${projectName} not found`);
+  return project;
+}
+async function findSeedFile(project) {
+  const files = await (0, import_projectUtils.collectFilesForProject)(project);
+  return files.find((file) => import_path.default.basename(file).includes("seed"));
+}
+function defaultSeedFile(project) {
+  const testDir = project.project.testDir;
+  return import_path.default.resolve(testDir, "seed.spec.ts");
+}
+async function ensureSeedFile(project) {
+  const seedFile = await findSeedFile(project);
+  if (seedFile)
+    return seedFile;
+  const seedFilePath = defaultSeedFile(project);
+  await (0, import_utils.mkdirIfNeeded)(seedFilePath);
+  await import_fs.default.promises.writeFile(seedFilePath, seedFileContent);
+  return seedFilePath;
+}
+const seedFileContent = `import { test, expect } from '@playwright/test';
+
+test.describe('Test group', () => {
+  test('seed', async ({ page }) => {
+    // generate code here.
+  });
+});
+`;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defaultSeedFile,
+  ensureSeedFile,
+  findSeedFile,
+  seedFileContent,
+  seedProject
+});

package/lib/mcp/test/streams.js

@@ -22,18 +22,21 @@ __export(streams_exports, {
 });
 module.exports = __toCommonJS(streams_exports);
 var import_stream = require("stream");
+var import_util = require("../../util");
 class StringWriteStream extends import_stream.Writable {
-  constructor() {
-    super(...arguments);
-    this._chunks = [];
+  constructor(output, stdio) {
+    super();
+    this._output = output;
+    this._prefix = stdio === "stdout" ? "" : "[err] ";
   }
   _write(chunk, encoding, callback) {
-    this._chunks.push(chunk.toString());
+    let text = (0, import_util.stripAnsiEscapes)(chunk.toString());
+    if (text.endsWith("\n"))
+      text = text.slice(0, -1);
+    if (text)
+      this._output.push(this._prefix + text);
     callback();
   }
-  content() {
-    return this._chunks.join("");
-  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/lib/mcp/test/testBackend.js

@@ -31,48 +31,68 @@ __export(testBackend_exports, {
   TestServerBackend: () => TestServerBackend
 });
 module.exports = __toCommonJS(testBackend_exports);
+var import_mcpBundle = require("../../mcpBundleImpl");
 var mcp = __toESM(require("../sdk/exports"));
 var import_testContext = require("./testContext");
-var import_testTools = require("./testTools.js");
+var testTools = __toESM(require("./testTools.js"));
+var generatorTools = __toESM(require("./generatorTools.js"));
+var plannerTools = __toESM(require("./plannerTools.js"));
 var import_tools = require("../browser/tools");
-var import_configLoader = require("../../common/configLoader");
 class TestServerBackend {
-  constructor(configOption, options) {
+  constructor(configPath, options) {
     this.name = "Playwright";
     this.version = "0.0.1";
-    this._tools = [import_testTools.listTests, import_testTools.runTests, import_testTools.debugTest, import_testTools.setupPage];
-    this._context = new import_testContext.TestContext(options);
-    this._configOption = configOption;
+    this._tools = [
+      plannerTools.saveTestPlan,
+      plannerTools.setupPage,
+      plannerTools.submitTestPlan,
+      generatorTools.setupPage,
+      generatorTools.generatorReadLog,
+      generatorTools.generatorWriteTest,
+      testTools.listTests,
+      testTools.runTests,
+      testTools.debugTest,
+      ...import_tools.browserTools.map((tool) => wrapBrowserTool(tool))
+    ];
+    this._options = options || {};
+    this._configPath = configPath;
   }
-  async initialize(server, clientInfo) {
-    if (this._configOption) {
-      this._context.setConfigLocation((0, import_configLoader.resolveConfigLocation)(this._configOption));
-      return;
-    }
-    const rootPath = mcp.firstRootPath(clientInfo);
-    if (rootPath) {
-      this._context.setConfigLocation((0, import_configLoader.resolveConfigLocation)(rootPath));
-      return;
-    }
-    throw new Error("No config option or MCP root path provided");
+  async initialize(clientInfo) {
+    this._context = new import_testContext.TestContext(clientInfo, this._configPath, this._options);
   }
   async listTools() {
-    return [
-      ...this._tools.map((tool) => mcp.toMcpTool(tool.schema)),
-      ...import_tools.browserTools.map((tool) => mcp.toMcpTool(tool.schema))
-    ];
+    return this._tools.map((tool) => mcp.toMcpTool(tool.schema));
   }
   async callTool(name, args) {
     const tool = this._tools.find((tool2) => tool2.schema.name === name);
     if (!tool)
       throw new Error(`Tool not found: ${name}. Available tools: ${this._tools.map((tool2) => tool2.schema.name).join(", ")}`);
-    const parsedArguments = tool.schema.inputSchema.parse(args || {});
-    return await tool.handle(this._context, parsedArguments);
+    try {
+      return await tool.handle(this._context, tool.schema.inputSchema.parse(args || {}));
+    } catch (e) {
+      return { content: [{ type: "text", text: String(e) }], isError: true };
+    }
   }
   serverClosed() {
-    void this._context.close();
+    void this._context?.close();
   }
 }
+const typesWithIntent = ["action", "assertion", "input"];
+function wrapBrowserTool(tool) {
+  const inputSchema = typesWithIntent.includes(tool.schema.type) ? tool.schema.inputSchema.extend({
+    intent: import_mcpBundle.z.string().describe("The intent of the call, for example the test step description plan idea")
+  }) : tool.schema.inputSchema;
+  return {
+    schema: {
+      ...tool.schema,
+      inputSchema
+    },
+    handle: async (context, params) => {
+      const response = await context.sendMessageToPausedTest({ callTool: { name: tool.schema.name, arguments: params } });
+      return response.callTool;
+    }
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   TestServerBackend

package/lib/mcp/test/testContext.js

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,36 +17,263 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var testContext_exports = {};
 __export(testContext_exports, {
-  TestContext: () => TestContext
+  GeneratorJournal: () => GeneratorJournal,
+  TestContext: () => TestContext,
+  createScreen: () => createScreen
 });
 module.exports = __toCommonJS(testContext_exports);
+var import_fs = __toESM(require("fs"));
+var import_os = __toESM(require("os"));
+var import_path = __toESM(require("path"));
+var import_utils = require("playwright-core/lib/utils");
+var import_base = require("../../reporters/base");
+var import_list = __toESM(require("../../reporters/list"));
+var import_streams = require("./streams");
+var import_util = require("../../util");
 var import_testRunner = require("../../runner/testRunner");
+var import_seed = require("./seed");
+var import_exports = require("../sdk/exports");
+var import_configLoader = require("../../common/configLoader");
+var import_response = require("../browser/response");
+var import_log = require("../log");
+class GeneratorJournal {
+  constructor(rootPath, plan, seed) {
+    this._rootPath = rootPath;
+    this._plan = plan;
+    this._seed = seed;
+    this._steps = [];
+  }
+  logStep(title, code) {
+    if (title)
+      this._steps.push({ title, code });
+  }
+  journal() {
+    const result = [];
+    result.push(`# Plan`);
+    result.push(this._plan);
+    result.push(`# Seed file: ${(0, import_utils.toPosixPath)(import_path.default.relative(this._rootPath, this._seed.file))}`);
+    result.push("```ts");
+    result.push(this._seed.content);
+    result.push("```");
+    result.push(`# Steps`);
+    result.push(this._steps.map((step) => `### ${step.title}
+\`\`\`ts
+${step.code}
+\`\`\``).join("\n\n"));
+    result.push(bestPracticesMarkdown);
+    return result.join("\n\n");
+  }
+}
 class TestContext {
-  constructor(options) {
-    this.options = options;
+  constructor(clientInfo, configPath, options) {
+    this._clientInfo = clientInfo;
+    const rootPath = (0, import_exports.firstRootPath)(clientInfo);
+    this._configLocation = (0, import_configLoader.resolveConfigLocation)(configPath || rootPath);
+    this.rootPath = rootPath || this._configLocation.configDir;
+    if (options?.headless !== void 0)
+      this.computedHeaded = !options.headless;
+    else
+      this.computedHeaded = !process.env.CI && !(import_os.default.platform() === "linux" && !process.env.DISPLAY);
+  }
+  existingTestRunner() {
+    return this._testRunnerAndScreen?.testRunner;
   }
-  setConfigLocation(configLocation) {
-    this.configLocation = configLocation;
+  async _cleanupTestRunner() {
+    if (!this._testRunnerAndScreen)
+      return;
+    await this._testRunnerAndScreen.testRunner.stopTests();
+    this._testRunnerAndScreen.claimStdio();
+    try {
+      await this._testRunnerAndScreen.testRunner.runGlobalTeardown();
+    } finally {
+      this._testRunnerAndScreen.releaseStdio();
+      this._testRunnerAndScreen = void 0;
+    }
   }
   async createTestRunner() {
-    if (this._testRunner)
-      await this._testRunner.stopTests();
-    const testRunner = new import_testRunner.TestRunner(this.configLocation, {});
+    await this._cleanupTestRunner();
+    const testRunner = new import_testRunner.TestRunner(this._configLocation, {});
     await testRunner.initialize({});
-    this._testRunner = testRunner;
-    testRunner.on(import_testRunner.TestRunnerEvent.TestFilesChanged, (testFiles) => {
-      this._testRunner?.emit(import_testRunner.TestRunnerEvent.TestFilesChanged, testFiles);
+    const testPaused = new import_utils.ManualPromise();
+    const testRunnerAndScreen = {
+      ...createScreen(),
+      testRunner,
+      waitForTestPaused: () => testPaused
+    };
+    this._testRunnerAndScreen = testRunnerAndScreen;
+    testRunner.on(import_testRunner.TestRunnerEvent.TestPaused, (params) => {
+      testRunnerAndScreen.sendMessageToPausedTest = params.sendMessage;
+      testPaused.resolve();
     });
-    this._testRunner = testRunner;
-    return testRunner;
+    return testRunnerAndScreen;
+  }
+  async getOrCreateSeedFile(seedFile, projectName) {
+    const configDir = this._configLocation.configDir;
+    const { testRunner } = await this.createTestRunner();
+    const config = await testRunner.loadConfig();
+    const project = (0, import_seed.seedProject)(config, projectName);
+    if (!seedFile) {
+      seedFile = await (0, import_seed.ensureSeedFile)(project);
+    } else {
+      const candidateFiles = [];
+      const testDir = project.project.testDir;
+      candidateFiles.push(import_path.default.resolve(testDir, seedFile));
+      candidateFiles.push(import_path.default.resolve(configDir, seedFile));
+      candidateFiles.push(import_path.default.resolve(this.rootPath, seedFile));
+      let resolvedSeedFile;
+      for (const candidateFile of candidateFiles) {
+        if (await (0, import_util.fileExistsAsync)(candidateFile)) {
+          resolvedSeedFile = candidateFile;
+          break;
+        }
+      }
+      if (!resolvedSeedFile)
+        throw new Error("seed test not found.");
+      seedFile = resolvedSeedFile;
+    }
+    const seedFileContent = await import_fs.default.promises.readFile(seedFile, "utf8");
+    return {
+      file: seedFile,
+      content: seedFileContent,
+      projectName: project.project.name
+    };
+  }
+  async runSeedTest(seedFile, projectName) {
+    const result = await this.runTestsWithGlobalSetupAndPossiblePause({
+      headed: this.computedHeaded,
+      locations: ["/" + (0, import_utils.escapeRegExp)(seedFile) + "/"],
+      projects: [projectName],
+      timeout: 0,
+      workers: 1,
+      pauseAtEnd: true,
+      disableConfigReporters: true,
+      failOnLoadErrors: true
+    });
+    if (result.status === "passed")
+      result.output += "\nError: seed test not found.";
+    else if (result.status !== "paused")
+      result.output += "\nError while running the seed test.";
+    return result;
+  }
+  async runTestsWithGlobalSetupAndPossiblePause(params) {
+    const configDir = this._configLocation.configDir;
+    const testRunnerAndScreen = await this.createTestRunner();
+    const { testRunner, screen, claimStdio, releaseStdio } = testRunnerAndScreen;
+    claimStdio();
+    try {
+      const setupReporter = new import_list.default({ configDir, screen, includeTestId: true });
+      const { status: status2 } = await testRunner.runGlobalSetup([setupReporter]);
+      if (status2 !== "passed")
+        return { output: testRunnerAndScreen.output.join("\n"), status: status2 };
+    } finally {
+      releaseStdio();
+    }
+    let status = "passed";
+    const cleanup = async () => {
+      claimStdio();
+      try {
+        const result = await testRunner.runGlobalTeardown();
+        if (status === "passed")
+          status = result.status;
+      } finally {
+        releaseStdio();
+      }
+    };
+    try {
+      const reporter = new import_list.default({ configDir, screen, includeTestId: true });
+      status = await Promise.race([
+        testRunner.runTests(reporter, params).then((result) => result.status),
+        testRunnerAndScreen.waitForTestPaused().then(() => "paused")
+      ]);
+      if (status === "paused") {
+        const response = await testRunnerAndScreen.sendMessageToPausedTest({ request: { initialize: { clientInfo: this._clientInfo } } });
+        if (response.error)
+          throw new Error(response.error.message);
+        testRunnerAndScreen.output.push(response.response.initialize.pausedMessage);
+        return { output: testRunnerAndScreen.output.join("\n"), status };
+      }
+    } catch (e) {
+      status = "failed";
+      testRunnerAndScreen.output.push(String(e));
+      await cleanup();
+      return { output: testRunnerAndScreen.output.join("\n"), status };
+    }
+    await cleanup();
+    return { output: testRunnerAndScreen.output.join("\n"), status };
   }
   async close() {
+    await this._cleanupTestRunner().catch(import_log.logUnhandledError);
   }
+  async sendMessageToPausedTest(request) {
+    const sendMessage = this._testRunnerAndScreen?.sendMessageToPausedTest;
+    if (!sendMessage)
+      throw new Error("Must setup test before interacting with the page");
+    const result = await sendMessage({ request });
+    if (result.error)
+      throw new Error(result.error.message);
+    if (typeof request?.callTool?.arguments?.["intent"] === "string") {
+      const response = (0, import_response.parseResponse)(result.response.callTool);
+      if (response && !response.isError && response.code)
+        this.generatorJournal?.logStep(request.callTool.arguments["intent"], response.code);
+    }
+    return result.response;
+  }
+}
+function createScreen() {
+  const output = [];
+  const stdout = new import_streams.StringWriteStream(output, "stdout");
+  const stderr = new import_streams.StringWriteStream(output, "stderr");
+  const screen = {
+    ...import_base.terminalScreen,
+    isTTY: false,
+    colors: import_utils.noColors,
+    stdout,
+    stderr
+  };
+  const originalStdoutWrite = process.stdout.write;
+  const originalStderrWrite = process.stderr.write;
+  const claimStdio = () => {
+    process.stdout.write = (chunk) => {
+      stdout.write(chunk);
+      return true;
+    };
+    process.stderr.write = (chunk) => {
+      stderr.write(chunk);
+      return true;
+    };
+  };
+  const releaseStdio = () => {
+    process.stdout.write = originalStdoutWrite;
+    process.stderr.write = originalStderrWrite;
+  };
+  return { screen, claimStdio, releaseStdio, output };
 }
+const bestPracticesMarkdown = `
+# Best practices
+- Do not improvise, do not add directives that were not asked for
+- Use clear, descriptive assertions to validate the expected behavior
+- Use reliable locators from this log
+- Use local variables for locators that are used multiple times
+- Use Playwright waiting assertions and best practices from this log
+- NEVER! use page.waitForLoadState()
+- NEVER! use page.waitForNavigation()
+- NEVER! use page.waitForTimeout()
+- NEVER! use page.evaluate()
+`;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  TestContext
+  GeneratorJournal,
+  TestContext,
+  createScreen
 });