@ait-co/devtools 0.1.131 → 0.1.133

package/dist/test-runner/config.d.ts

@@ -1,4 +1,4 @@
-import { i as createRelayPool, n as RelayConnectionFactory, t as RELAY_POOL_NAME } from "../pool-BaSCZALv.js";
+import { i as createRelayPool, n as RelayConnectionFactory, t as RELAY_POOL_NAME } from "../pool-x28Wv1ty.js";
 
 //#region src/test-runner/relay-factory.d.ts
 /** Options for {@link createRelayConnectionFactory}. */

package/dist/test-runner/config.js

@@ -1,5 +1,5 @@
 import { RELAY_POOL_NAME, createRelayPool } from "./pool.js";
-import { t as createRelayConnectionFactory } from "../relay-factory-Cloog1jb.js";
+import { t as createRelayConnectionFactory } from "../relay-factory-BQfmK7RP.js";
 //#region src/test-runner/config.ts
 const DEFAULT_CONFIG = {
 	include: ["**/*.ait.test.ts"],

package/dist/test-runner/pool.d.ts

@@ -1,2 +1,2 @@
-import { i as createRelayPool, n as RelayConnectionFactory, r as RelayPoolOptions, t as RELAY_POOL_NAME } from "../pool-BaSCZALv.js";
+import { i as createRelayPool, n as RelayConnectionFactory, r as RelayPoolOptions, t as RELAY_POOL_NAME } from "../pool-x28Wv1ty.js";
 export { RELAY_POOL_NAME, RelayConnectionFactory, RelayPoolOptions, createRelayPool };

package/dist/test-runner/pool.js

@@ -1,4 +1,4 @@
-import { r as runTestFilesOverRelay } from "../relay-worker-CCAHLC4a.js";
+import { i as runTestFilesOverRelay } from "../relay-worker-MZq4fLv8.js";
 import { synthesizeFileTask, toTaskEventPacks, toTaskResultPacks } from "./task-graph.js";
 //#region src/test-runner/pool.ts
 /** The pool name Vitest matches against `getFilePoolName(project)`. */

package/dist/test-runner/pool.js.map

@@ -1 +1 @@
-{"version":3,"file":"pool.js","names":[],"sources":["../../src/test-runner/pool.ts"],"sourcesContent":["/**\n * Vitest 4.x custom pool: runs mini-app tests on a real device WebView over a\n * CDP relay instead of in a Node child process.\n *\n * Vitest's pool abstraction lets a `PoolRunnerInitializer` create a `PoolWorker`\n * that the core drives via a `WorkerRequest`/`WorkerResponse` message protocol.\n * Built-in pools (`forks`/`threads`) fork a child process; the `typecheck` pool\n * runs in-process and handles messages synchronously. We follow the in-process\n * `TypecheckPoolWorker` shape: a single long-lived \"worker\" that, on a `run`\n * request, bundles + injects + collects each file over the relay (#644's\n * `runTestFilesOverRelay`), synthesises a Vitest task graph (`task-graph.ts`),\n * and reports it through `vitest.state` so reporters/watch/UI/snapshot all work.\n *\n * Single-attach constraint: the relay supports one active page, so we keep one\n * worker for the whole run (`isolate: false`) rather than starting/stopping per\n * file — per-file start/stop would re-attach the relay on every file.\n *\n * SECRET-HANDLING: the relay connection (wss/TOTP) is supplied by the caller's\n * factory and never logged here; bundle code and result values are not logged.\n */\n\nimport type { PoolOptions, PoolWorker, TestProject, WorkerRequest } from 'vitest/node';\nimport type { CdpConnection } from '../mcp/cdp-connection.js';\nimport type { RelayRunOptions } from './relay-worker.js';\nimport { runTestFilesOverRelay } from './relay-worker.js';\nimport { synthesizeFileTask, toTaskEventPacks, toTaskResultPacks } from './task-graph.js';\n\n/** The pool name Vitest matches against `getFilePoolName(project)`. */\nexport const RELAY_POOL_NAME = 'ait-relay';\n\n/**\n * Factory the caller provides to open (and later close) the CDP relay\n * connection. Called once per worker lifecycle (`start`). The returned\n * `close` runs on `stop`.\n *\n * Kept as a factory (not a live connection) so the pool can be constructed in\n * config before any device is attached, and so `start`/`stop` own the lifecycle.\n */\nexport interface RelayConnectionFactory {\n  /** Opens the relay connection. Resolves once the page is attached & ready. */\n  open(): Promise<CdpConnection>;\n  /** Closes the relay connection opened by {@link open}. */\n  close(connection: CdpConnection): Promise<void>;\n  /**\n   * CLI-only session-phase hook (#730) — drives the QR dashboard's `phase`\n   * field (`'running'` on run start, `'complete'` on run end) so the\n   * dashboard can push an immediate SSE update instead of waiting for a\n   * poll/watchdog. The pool (this file) has no equivalent lifecycle and\n   * omits it; only `createRelayConnectionFactory` (relay-factory.ts) sets it.\n   */\n  onSessionPhase?(phase: 'running' | 'complete'): void;\n}\n\n/** Options for {@link createRelayPool}. */\nexport interface RelayPoolOptions {\n  /** Opens/closes the relay connection. */\n  connection: RelayConnectionFactory;\n  /** Forwarded to `runTestFilesOverRelay` (bundle options, per-file timeout). */\n  run?: RelayRunOptions;\n}\n\n/* -------------------------------------------------------------------------- */\n/* WorkerResponse helpers                                                       */\n/* -------------------------------------------------------------------------- */\n\n/** Minimal `WorkerResponse` shape we emit. Matches vitest/node's union. */\ntype EmittedResponse =\n  | { __vitest_worker_response__: true; type: 'started'; error?: unknown }\n  | { __vitest_worker_response__: true; type: 'stopped'; error?: unknown }\n  | { __vitest_worker_response__: true; type: 'testfileFinished'; error?: unknown };\n\n/* -------------------------------------------------------------------------- */\n/* The in-process relay PoolWorker                                              */\n/* -------------------------------------------------------------------------- */\n\n/**\n * In-process `PoolWorker` backed by a CDP relay. Mirrors `TypecheckPoolWorker`:\n * `send` handles the message in-process and emits a `WorkerResponse` via the\n * `'message'` listener registered by the core's pool driver.\n */\nclass RelayPoolWorker implements PoolWorker {\n  readonly name = RELAY_POOL_NAME;\n  readonly cacheFs = false;\n\n  private readonly project: TestProject;\n  private readonly factory: RelayConnectionFactory;\n  private readonly runOpts: RelayRunOptions | undefined;\n  private readonly listeners = new Map<string, Set<(arg: unknown) => void>>();\n  private connection: CdpConnection | undefined;\n\n  constructor(project: TestProject, opts: RelayPoolOptions) {\n    this.project = project;\n    this.factory = opts.connection;\n    this.runOpts = opts.run;\n  }\n\n  on(event: string, callback: (arg: unknown) => void): void {\n    let set = this.listeners.get(event);\n    if (!set) {\n      set = new Set();\n      this.listeners.set(event, set);\n    }\n    set.add(callback);\n  }\n\n  off(event: string, callback: (arg: unknown) => void): void {\n    this.listeners.get(event)?.delete(callback);\n  }\n\n  private emit(event: string, arg: unknown): void {\n    const set = this.listeners.get(event);\n    if (!set) return;\n    for (const cb of set) cb(arg);\n  }\n\n  deserialize(data: unknown): unknown {\n    // Relay results arrive as plain JSON objects already — identity is correct.\n    return data;\n  }\n\n  async start(): Promise<void> {\n    // Lifecycle ownership lives here, but the connection is opened lazily on the\n    // first `run`/`collect` so a never-run worker never touches the device.\n  }\n\n  async stop(): Promise<void> {\n    if (this.connection) {\n      const conn = this.connection;\n      this.connection = undefined;\n      await this.factory.close(conn);\n    }\n  }\n\n  send(message: WorkerRequest): void {\n    // Fire-and-forget like TypecheckPoolWorker: handle async, emit on settle.\n    void this.handle(message).then((response) => {\n      if (response) this.emit('message', response);\n    });\n  }\n\n  private async handle(message: WorkerRequest): Promise<EmittedResponse | undefined> {\n    switch (message.type) {\n      case 'start':\n        return { __vitest_worker_response__: true, type: 'started' };\n      case 'run':\n      case 'collect': {\n        const files = message.context.files.map((s) => s.filepath);\n        const error = await this.runFiles(files).catch((e) => e);\n        return { __vitest_worker_response__: true, type: 'testfileFinished', error };\n      }\n      case 'stop':\n        return { __vitest_worker_response__: true, type: 'stopped' };\n      case 'cancel':\n        return undefined;\n    }\n  }\n\n  /**\n   * Bundles + injects + collects the given files over the relay, synthesises a\n   * Vitest task graph per file, and reports it through `vitest.state` so the\n   * reporter/watch/UI ecosystem sees real results.\n   *\n   * Returns nothing on success; a thrown error is surfaced as the\n   * `testfileFinished` error (a whole-pool failure, e.g. relay unreachable).\n   */\n  private async runFiles(files: string[]): Promise<void> {\n    const conn = await this.ensureConnection();\n    const report = await runTestFilesOverRelay(conn, files, this.runOpts);\n\n    const root = this.project.config.root;\n    const projectName = this.project.name || undefined;\n    const state = this.project.vitest.state;\n\n    for (const fileResult of report.files) {\n      const perFile =\n        'error' in fileResult.result\n          ? // Whole-file bundle/inject error → synthesise a failed file with no tests.\n            {\n              startedAt: report.startedAt,\n              duration: 0,\n              passed: 0,\n              failed: 1,\n              skipped: 0,\n              tests: [],\n            }\n          : fileResult.result;\n\n      const fileTask = synthesizeFileTask(\n        fileResult.file,\n        root,\n        projectName,\n        RELAY_POOL_NAME,\n        perFile,\n      );\n\n      state.collectFiles(this.project, [fileTask]);\n      state.updateTasks(toTaskResultPacks(fileTask));\n      // Event packs drive reporter progress; updateTasks already recorded\n      // results, so events are advisory but keep watch/UI output coherent.\n      void toTaskEventPacks(fileTask);\n    }\n  }\n\n  private async ensureConnection(): Promise<CdpConnection> {\n    if (!this.connection) {\n      this.connection = await this.factory.open();\n    }\n    return this.connection;\n  }\n}\n\n/* -------------------------------------------------------------------------- */\n/* PoolRunnerInitializer factory                                               */\n/* -------------------------------------------------------------------------- */\n\n/**\n * Creates the Vitest `PoolRunnerInitializer` for the relay pool.\n *\n * Wire it into a Vitest config as `pool: createRelayPool({ connection })`.\n * Vitest moves an object `pool` into `config.poolRunner` and dispatches files\n * whose pool name equals `RELAY_POOL_NAME` to our `createPoolWorker`.\n *\n * @example\n *   // vitest.config.ts\n *   import { createRelayPool } from '@ait-co/devtools/test-runner';\n *   export default defineConfig({\n *     test: { pool: createRelayPool({ connection: myFactory }) },\n *   });\n */\nexport function createRelayPool(opts: RelayPoolOptions): {\n  readonly name: string;\n  createPoolWorker: (options: PoolOptions) => PoolWorker;\n} {\n  return {\n    name: RELAY_POOL_NAME,\n    createPoolWorker(options: PoolOptions): PoolWorker {\n      return new RelayPoolWorker(options.project, opts);\n    },\n  };\n}\n"],"mappings":";;;;AA4BA,MAAa,kBAAkB;;;;;;AAoD/B,IAAM,kBAAN,MAA4C;CAC1C,OAAgB;CAChB,UAAmB;CAEnB;CACA;CACA;CACA,4BAA6B,IAAI,KAA0C;CAC3E;CAEA,YAAY,SAAsB,MAAwB;AACxD,OAAK,UAAU;AACf,OAAK,UAAU,KAAK;AACpB,OAAK,UAAU,KAAK;;CAGtB,GAAG,OAAe,UAAwC;EACxD,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM;AACnC,MAAI,CAAC,KAAK;AACR,yBAAM,IAAI,KAAK;AACf,QAAK,UAAU,IAAI,OAAO,IAAI;;AAEhC,MAAI,IAAI,SAAS;;CAGnB,IAAI,OAAe,UAAwC;AACzD,OAAK,UAAU,IAAI,MAAM,EAAE,OAAO,SAAS;;CAG7C,KAAa,OAAe,KAAoB;EAC9C,MAAM,MAAM,KAAK,UAAU,IAAI,MAAM;AACrC,MAAI,CAAC,IAAK;AACV,OAAK,MAAM,MAAM,IAAK,IAAG,IAAI;;CAG/B,YAAY,MAAwB;AAElC,SAAO;;CAGT,MAAM,QAAuB;CAK7B,MAAM,OAAsB;AAC1B,MAAI,KAAK,YAAY;GACnB,MAAM,OAAO,KAAK;AAClB,QAAK,aAAa,KAAA;AAClB,SAAM,KAAK,QAAQ,MAAM,KAAK;;;CAIlC,KAAK,SAA8B;AAE5B,OAAK,OAAO,QAAQ,CAAC,MAAM,aAAa;AAC3C,OAAI,SAAU,MAAK,KAAK,WAAW,SAAS;IAC5C;;CAGJ,MAAc,OAAO,SAA8D;AACjF,UAAQ,QAAQ,MAAhB;GACE,KAAK,QACH,QAAO;IAAE,4BAA4B;IAAM,MAAM;IAAW;GAC9D,KAAK;GACL,KAAK,WAAW;IACd,MAAM,QAAQ,QAAQ,QAAQ,MAAM,KAAK,MAAM,EAAE,SAAS;AAE1D,WAAO;KAAE,4BAA4B;KAAM,MAAM;KAAoB,OADvD,MAAM,KAAK,SAAS,MAAM,CAAC,OAAO,MAAM,EAAE;KACoB;;GAE9E,KAAK,OACH,QAAO;IAAE,4BAA4B;IAAM,MAAM;IAAW;GAC9D,KAAK,SACH;;;;;;;;;;;CAYN,MAAc,SAAS,OAAgC;EAErD,MAAM,SAAS,MAAM,sBADR,MAAM,KAAK,kBAAkB,EACO,OAAO,KAAK,QAAQ;EAErE,MAAM,OAAO,KAAK,QAAQ,OAAO;EACjC,MAAM,cAAc,KAAK,QAAQ,QAAQ,KAAA;EACzC,MAAM,QAAQ,KAAK,QAAQ,OAAO;AAElC,OAAK,MAAM,cAAc,OAAO,OAAO;GACrC,MAAM,UACJ,WAAW,WAAW,SAElB;IACE,WAAW,OAAO;IAClB,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,OAAO,EAAE;IACV,GACD,WAAW;GAEjB,MAAM,WAAW,mBACf,WAAW,MACX,MACA,aACA,iBACA,QACD;AAED,SAAM,aAAa,KAAK,SAAS,CAAC,SAAS,CAAC;AAC5C,SAAM,YAAY,kBAAkB,SAAS,CAAC;AAGzC,oBAAiB,SAAS;;;CAInC,MAAc,mBAA2C;AACvD,MAAI,CAAC,KAAK,WACR,MAAK,aAAa,MAAM,KAAK,QAAQ,MAAM;AAE7C,SAAO,KAAK;;;;;;;;;;;;;;;;;AAsBhB,SAAgB,gBAAgB,MAG9B;AACA,QAAO;EACL,MAAM;EACN,iBAAiB,SAAkC;AACjD,UAAO,IAAI,gBAAgB,QAAQ,SAAS,KAAK;;EAEpD"}
+{"version":3,"file":"pool.js","names":[],"sources":["../../src/test-runner/pool.ts"],"sourcesContent":["/**\n * Vitest 4.x custom pool: runs mini-app tests on a real device WebView over a\n * CDP relay instead of in a Node child process.\n *\n * Vitest's pool abstraction lets a `PoolRunnerInitializer` create a `PoolWorker`\n * that the core drives via a `WorkerRequest`/`WorkerResponse` message protocol.\n * Built-in pools (`forks`/`threads`) fork a child process; the `typecheck` pool\n * runs in-process and handles messages synchronously. We follow the in-process\n * `TypecheckPoolWorker` shape: a single long-lived \"worker\" that, on a `run`\n * request, bundles + injects + collects each file over the relay (#644's\n * `runTestFilesOverRelay`), synthesises a Vitest task graph (`task-graph.ts`),\n * and reports it through `vitest.state` so reporters/watch/UI/snapshot all work.\n *\n * Single-attach constraint: the relay supports one active page, so we keep one\n * worker for the whole run (`isolate: false`) rather than starting/stopping per\n * file — per-file start/stop would re-attach the relay on every file.\n *\n * SECRET-HANDLING: the relay connection (wss/TOTP) is supplied by the caller's\n * factory and never logged here; bundle code and result values are not logged.\n */\n\nimport type { PoolOptions, PoolWorker, TestProject, WorkerRequest } from 'vitest/node';\nimport type { CdpConnection } from '../mcp/cdp-connection.js';\nimport type { RelayRunOptions } from './relay-worker.js';\nimport { runTestFilesOverRelay } from './relay-worker.js';\nimport { synthesizeFileTask, toTaskEventPacks, toTaskResultPacks } from './task-graph.js';\n\n/** The pool name Vitest matches against `getFilePoolName(project)`. */\nexport const RELAY_POOL_NAME = 'ait-relay';\n\n/**\n * Factory the caller provides to open (and later close) the CDP relay\n * connection. Called once per worker lifecycle (`start`). The returned\n * `close` runs on `stop`.\n *\n * Kept as a factory (not a live connection) so the pool can be constructed in\n * config before any device is attached, and so `start`/`stop` own the lifecycle.\n */\nexport interface RelayConnectionFactory {\n  /** Opens the relay connection. Resolves once the page is attached & ready. */\n  open(): Promise<CdpConnection>;\n  /** Closes the relay connection opened by {@link open}. */\n  close(connection: CdpConnection): Promise<void>;\n  /**\n   * CLI-only session-phase hook (#730) — drives the QR dashboard's `phase`\n   * field (`'running'` on run start, `'complete'` on run end) so the\n   * dashboard can push an immediate SSE update instead of waiting for a\n   * poll/watchdog. The pool (this file) has no equivalent lifecycle and\n   * omits it; only `createRelayConnectionFactory` (relay-factory.ts) sets it.\n   */\n  onSessionPhase?(phase: 'running' | 'complete'): void;\n  /**\n   * CLI-only manual-blocking prompt hook (devtools#741) — pushes the QR\n   * dashboard's `manualPrompt` field before each manual-tagged file is\n   * injected, so a human watching the dashboard sees which file is next and\n   * how far along the manual queue is. Pass `null` to clear the prompt (the\n   * CLI does this once all manual files have run). The pool has no\n   * equivalent lifecycle and omits it; only `createRelayConnectionFactory`\n   * sets it.\n   */\n  onManualPrompt?(prompt: { file: string; index: number; total: number } | null): void;\n}\n\n/** Options for {@link createRelayPool}. */\nexport interface RelayPoolOptions {\n  /** Opens/closes the relay connection. */\n  connection: RelayConnectionFactory;\n  /** Forwarded to `runTestFilesOverRelay` (bundle options, per-file timeout). */\n  run?: RelayRunOptions;\n}\n\n/* -------------------------------------------------------------------------- */\n/* WorkerResponse helpers                                                       */\n/* -------------------------------------------------------------------------- */\n\n/** Minimal `WorkerResponse` shape we emit. Matches vitest/node's union. */\ntype EmittedResponse =\n  | { __vitest_worker_response__: true; type: 'started'; error?: unknown }\n  | { __vitest_worker_response__: true; type: 'stopped'; error?: unknown }\n  | { __vitest_worker_response__: true; type: 'testfileFinished'; error?: unknown };\n\n/* -------------------------------------------------------------------------- */\n/* The in-process relay PoolWorker                                              */\n/* -------------------------------------------------------------------------- */\n\n/**\n * In-process `PoolWorker` backed by a CDP relay. Mirrors `TypecheckPoolWorker`:\n * `send` handles the message in-process and emits a `WorkerResponse` via the\n * `'message'` listener registered by the core's pool driver.\n */\nclass RelayPoolWorker implements PoolWorker {\n  readonly name = RELAY_POOL_NAME;\n  readonly cacheFs = false;\n\n  private readonly project: TestProject;\n  private readonly factory: RelayConnectionFactory;\n  private readonly runOpts: RelayRunOptions | undefined;\n  private readonly listeners = new Map<string, Set<(arg: unknown) => void>>();\n  private connection: CdpConnection | undefined;\n\n  constructor(project: TestProject, opts: RelayPoolOptions) {\n    this.project = project;\n    this.factory = opts.connection;\n    this.runOpts = opts.run;\n  }\n\n  on(event: string, callback: (arg: unknown) => void): void {\n    let set = this.listeners.get(event);\n    if (!set) {\n      set = new Set();\n      this.listeners.set(event, set);\n    }\n    set.add(callback);\n  }\n\n  off(event: string, callback: (arg: unknown) => void): void {\n    this.listeners.get(event)?.delete(callback);\n  }\n\n  private emit(event: string, arg: unknown): void {\n    const set = this.listeners.get(event);\n    if (!set) return;\n    for (const cb of set) cb(arg);\n  }\n\n  deserialize(data: unknown): unknown {\n    // Relay results arrive as plain JSON objects already — identity is correct.\n    return data;\n  }\n\n  async start(): Promise<void> {\n    // Lifecycle ownership lives here, but the connection is opened lazily on the\n    // first `run`/`collect` so a never-run worker never touches the device.\n  }\n\n  async stop(): Promise<void> {\n    if (this.connection) {\n      const conn = this.connection;\n      this.connection = undefined;\n      await this.factory.close(conn);\n    }\n  }\n\n  send(message: WorkerRequest): void {\n    // Fire-and-forget like TypecheckPoolWorker: handle async, emit on settle.\n    void this.handle(message).then((response) => {\n      if (response) this.emit('message', response);\n    });\n  }\n\n  private async handle(message: WorkerRequest): Promise<EmittedResponse | undefined> {\n    switch (message.type) {\n      case 'start':\n        return { __vitest_worker_response__: true, type: 'started' };\n      case 'run':\n      case 'collect': {\n        const files = message.context.files.map((s) => s.filepath);\n        const error = await this.runFiles(files).catch((e) => e);\n        return { __vitest_worker_response__: true, type: 'testfileFinished', error };\n      }\n      case 'stop':\n        return { __vitest_worker_response__: true, type: 'stopped' };\n      case 'cancel':\n        return undefined;\n    }\n  }\n\n  /**\n   * Bundles + injects + collects the given files over the relay, synthesises a\n   * Vitest task graph per file, and reports it through `vitest.state` so the\n   * reporter/watch/UI ecosystem sees real results.\n   *\n   * Returns nothing on success; a thrown error is surfaced as the\n   * `testfileFinished` error (a whole-pool failure, e.g. relay unreachable).\n   */\n  private async runFiles(files: string[]): Promise<void> {\n    const conn = await this.ensureConnection();\n    const report = await runTestFilesOverRelay(conn, files, this.runOpts);\n\n    const root = this.project.config.root;\n    const projectName = this.project.name || undefined;\n    const state = this.project.vitest.state;\n\n    for (const fileResult of report.files) {\n      const perFile =\n        'error' in fileResult.result\n          ? // Whole-file bundle/inject error → synthesise a failed file with no tests.\n            {\n              startedAt: report.startedAt,\n              duration: 0,\n              passed: 0,\n              failed: 1,\n              skipped: 0,\n              tests: [],\n            }\n          : fileResult.result;\n\n      const fileTask = synthesizeFileTask(\n        fileResult.file,\n        root,\n        projectName,\n        RELAY_POOL_NAME,\n        perFile,\n      );\n\n      state.collectFiles(this.project, [fileTask]);\n      state.updateTasks(toTaskResultPacks(fileTask));\n      // Event packs drive reporter progress; updateTasks already recorded\n      // results, so events are advisory but keep watch/UI output coherent.\n      void toTaskEventPacks(fileTask);\n    }\n  }\n\n  private async ensureConnection(): Promise<CdpConnection> {\n    if (!this.connection) {\n      this.connection = await this.factory.open();\n    }\n    return this.connection;\n  }\n}\n\n/* -------------------------------------------------------------------------- */\n/* PoolRunnerInitializer factory                                               */\n/* -------------------------------------------------------------------------- */\n\n/**\n * Creates the Vitest `PoolRunnerInitializer` for the relay pool.\n *\n * Wire it into a Vitest config as `pool: createRelayPool({ connection })`.\n * Vitest moves an object `pool` into `config.poolRunner` and dispatches files\n * whose pool name equals `RELAY_POOL_NAME` to our `createPoolWorker`.\n *\n * @example\n *   // vitest.config.ts\n *   import { createRelayPool } from '@ait-co/devtools/test-runner';\n *   export default defineConfig({\n *     test: { pool: createRelayPool({ connection: myFactory }) },\n *   });\n */\nexport function createRelayPool(opts: RelayPoolOptions): {\n  readonly name: string;\n  createPoolWorker: (options: PoolOptions) => PoolWorker;\n} {\n  return {\n    name: RELAY_POOL_NAME,\n    createPoolWorker(options: PoolOptions): PoolWorker {\n      return new RelayPoolWorker(options.project, opts);\n    },\n  };\n}\n"],"mappings":";;;;AA4BA,MAAa,kBAAkB;;;;;;AA8D/B,IAAM,kBAAN,MAA4C;CAC1C,OAAgB;CAChB,UAAmB;CAEnB;CACA;CACA;CACA,4BAA6B,IAAI,KAA0C;CAC3E;CAEA,YAAY,SAAsB,MAAwB;AACxD,OAAK,UAAU;AACf,OAAK,UAAU,KAAK;AACpB,OAAK,UAAU,KAAK;;CAGtB,GAAG,OAAe,UAAwC;EACxD,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM;AACnC,MAAI,CAAC,KAAK;AACR,yBAAM,IAAI,KAAK;AACf,QAAK,UAAU,IAAI,OAAO,IAAI;;AAEhC,MAAI,IAAI,SAAS;;CAGnB,IAAI,OAAe,UAAwC;AACzD,OAAK,UAAU,IAAI,MAAM,EAAE,OAAO,SAAS;;CAG7C,KAAa,OAAe,KAAoB;EAC9C,MAAM,MAAM,KAAK,UAAU,IAAI,MAAM;AACrC,MAAI,CAAC,IAAK;AACV,OAAK,MAAM,MAAM,IAAK,IAAG,IAAI;;CAG/B,YAAY,MAAwB;AAElC,SAAO;;CAGT,MAAM,QAAuB;CAK7B,MAAM,OAAsB;AAC1B,MAAI,KAAK,YAAY;GACnB,MAAM,OAAO,KAAK;AAClB,QAAK,aAAa,KAAA;AAClB,SAAM,KAAK,QAAQ,MAAM,KAAK;;;CAIlC,KAAK,SAA8B;AAE5B,OAAK,OAAO,QAAQ,CAAC,MAAM,aAAa;AAC3C,OAAI,SAAU,MAAK,KAAK,WAAW,SAAS;IAC5C;;CAGJ,MAAc,OAAO,SAA8D;AACjF,UAAQ,QAAQ,MAAhB;GACE,KAAK,QACH,QAAO;IAAE,4BAA4B;IAAM,MAAM;IAAW;GAC9D,KAAK;GACL,KAAK,WAAW;IACd,MAAM,QAAQ,QAAQ,QAAQ,MAAM,KAAK,MAAM,EAAE,SAAS;AAE1D,WAAO;KAAE,4BAA4B;KAAM,MAAM;KAAoB,OADvD,MAAM,KAAK,SAAS,MAAM,CAAC,OAAO,MAAM,EAAE;KACoB;;GAE9E,KAAK,OACH,QAAO;IAAE,4BAA4B;IAAM,MAAM;IAAW;GAC9D,KAAK,SACH;;;;;;;;;;;CAYN,MAAc,SAAS,OAAgC;EAErD,MAAM,SAAS,MAAM,sBADR,MAAM,KAAK,kBAAkB,EACO,OAAO,KAAK,QAAQ;EAErE,MAAM,OAAO,KAAK,QAAQ,OAAO;EACjC,MAAM,cAAc,KAAK,QAAQ,QAAQ,KAAA;EACzC,MAAM,QAAQ,KAAK,QAAQ,OAAO;AAElC,OAAK,MAAM,cAAc,OAAO,OAAO;GACrC,MAAM,UACJ,WAAW,WAAW,SAElB;IACE,WAAW,OAAO;IAClB,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,OAAO,EAAE;IACV,GACD,WAAW;GAEjB,MAAM,WAAW,mBACf,WAAW,MACX,MACA,aACA,iBACA,QACD;AAED,SAAM,aAAa,KAAK,SAAS,CAAC,SAAS,CAAC;AAC5C,SAAM,YAAY,kBAAkB,SAAS,CAAC;AAGzC,oBAAiB,SAAS;;;CAInC,MAAc,mBAA2C;AACvD,MAAI,CAAC,KAAK,WACR,MAAK,aAAa,MAAM,KAAK,QAAQ,MAAM;AAE7C,SAAO,KAAK;;;;;;;;;;;;;;;;;AAsBhB,SAAgB,gBAAgB,MAG9B;AACA,QAAO;EACL,MAAM;EACN,iBAAiB,SAAkC;AACjD,UAAO,IAAI,gBAAgB,QAAQ,SAAS,KAAK;;EAEpD"}

package/dist/test-runner/relay-factory.d.ts

@@ -11072,6 +11072,20 @@ interface RelayConnectionFactory {
    * omits it; only `createRelayConnectionFactory` (relay-factory.ts) sets it.
    */
   onSessionPhase?(phase: 'running' | 'complete'): void;
+  /**
+   * CLI-only manual-blocking prompt hook (devtools#741) — pushes the QR
+   * dashboard's `manualPrompt` field before each manual-tagged file is
+   * injected, so a human watching the dashboard sees which file is next and
+   * how far along the manual queue is. Pass `null` to clear the prompt (the
+   * CLI does this once all manual files have run). The pool has no
+   * equivalent lifecycle and omits it; only `createRelayConnectionFactory`
+   * sets it.
+   */
+  onManualPrompt?(prompt: {
+    file: string;
+    index: number;
+    total: number;
+  } | null): void;
 }
 //#endregion
 //#region src/test-runner/relay-factory.d.ts