@humanjs/playwright 0.6.0 → 0.7.0

package/dist/index.d.cts

@@ -163,6 +163,28 @@ interface CaptureResult {
     cleanup(): Promise<void>;
 }
 
+/** Options for {@link generatePlaywrightTest} / `Recording.toPlaywright`. */
+interface PlaywrightTestOptions {
+    /**
+     * Keep recorded `sleep()` pauses. Default `false` — a test shouldn't carry
+     * human-timing waits (slow + flaky in CI; Playwright auto-waits instead).
+     */
+    readonly keepSleeps?: boolean;
+    /** Test title. Defaults to the recording's name, else `'recorded session'`. */
+    readonly title?: string;
+    /**
+     * Wrap actions in `test.step(...)` groups — a new step per navigation — so
+     * they show as collapsible sections in the HTML report / trace. Default false.
+     */
+    readonly steps?: boolean;
+    /**
+     * When all `goto`s share one origin, emit them as relative paths and add a
+     * note to set `use.baseURL` in the Playwright config (portable across
+     * environments). Default false — absolute URLs that run without any config.
+     */
+    readonly baseUrl?: boolean;
+}
+
 /**
  * Encoding quality preset. Picks the per-frame capture quality + the
  * ffmpeg encode settings used to assemble them into a video.
@@ -212,10 +234,18 @@ interface TimelineEvent {
     readonly durationMs: number;
     /** Error message, present only if the action threw. */
     readonly error?: string;
+    /**
+     * For `type` / `paste`: the actual text written, captured when
+     * `captureInputs` is on (the default). Omitted when capture is off or the
+     * target is a password field (always masked). Flows into exported code.
+     */
+    readonly inputValue?: string;
 }
 /** Structured action timeline of a recording. */
 interface Timeline {
     readonly version: 1;
+    /** Optional label for the recording (used as the generated test's title). */
+    readonly name?: string;
     readonly personality: string;
     readonly seed: string | null;
     readonly speed: string;
@@ -224,6 +254,7 @@ interface Timeline {
 }
 /** Metadata passed from `human.record()` into the Recording constructor. */
 interface RecordingTimelineSource {
+    readonly name?: string;
     readonly personality: string;
     readonly seed: string | null;
     readonly speed: string;
@@ -288,6 +319,30 @@ declare class Recording {
      * @returns the resolved output path.
      */
     toTimeline(outputPath: string): Promise<string>;
+    /**
+     * Generates a standalone, runnable HumanJS script from the timeline and
+     * writes it to `outputPath`. String selectors round-trip verbatim; typed
+     * values are included when `captureInputs` was on (passwords masked).
+     *
+     * Independent of frame capture — works on timeline-only recordings and is
+     * unaffected by `dispose()`.
+     *
+     * @returns the resolved output path.
+     */
+    toHumanJS(outputPath: string): Promise<string>;
+    /**
+     * Generates a `@playwright/test` spec from the timeline — a humanized test
+     * (uses `createHuman` + `human.*`), not raw Playwright — and writes it to
+     * `outputPath`. Runs instant in CI / recorded speed locally, drops timing
+     * `sleep()`s (pass `{ keepSleeps: true }` to keep them), and derives the
+     * assertions it safely can.
+     *
+     * Independent of frame capture — works on timeline-only recordings and is
+     * unaffected by `dispose()`.
+     *
+     * @returns the resolved output path.
+     */
+    toPlaywright(outputPath: string, options?: PlaywrightTestOptions): Promise<string>;
     /**
      * Releases the captured-frames temp directory. After this call, `toVideo()`
      * and `toGif()` throw — but `toTimeline()` and the in-memory `timeline`
@@ -777,6 +832,11 @@ interface Human {
 }
 /** Options for {@link Human.record}. */
 interface HumanRecordOptions {
+    /**
+     * Optional label for the recording. Stored on the timeline and used as the
+     * title of a generated `toPlaywright()` test.
+     */
+    readonly name?: string;
     /**
      * Whether to capture frames for video output. Defaults to `true`.
      * Set to `false` for timeline-only recordings (no capture loop, no
@@ -789,6 +849,21 @@ interface HumanRecordOptions {
      * Defaults to `'high'`. Ignored when `video: false`.
      */
     readonly quality?: RecordingQuality;
+    /**
+     * Capture the actual typed/pasted text into the timeline (and therefore
+     * into code generated by `toHumanJS()` / `toPlaywright()`). Defaults to
+     * `true`.
+     *
+     * Values typed/pasted into `input[type="password"]` are always masked
+     * (omitted) regardless of this flag — the video already renders them as
+     * dots, and freezing a cleartext secret into an artifact would leak more
+     * than the recording itself. Set `false` to record no input values at all;
+     * exporters then emit empty-string placeholders.
+     *
+     * Captured values land in the timeline JSON and any exported test, so treat
+     * those artifacts with the same care as the values themselves.
+     */
+    readonly captureInputs?: boolean;
 }
 /**
  * Creates a humanized session bound to a Playwright `Page`.
@@ -811,4 +886,4 @@ interface HumanRecordOptions {
  */
 declare function createHuman(page: Page, options?: CreateHumanOptions): Promise<Human>;
 
-export { type CreateHumanOptions, type FfmpegPreset, type FfmpegTune, type Human, type HumanRecordOptions, type InstallMouseHelperOptions, type KeyModifier, type KeyName, type KeyOrChord, type MouseTarget, type PressResult, type ReadOptions, type ReadResult, type ReadTarget, Recording, type RecordingQuality, type ScrollOptions, type ScrollResult, type ScrollTarget, type Speed, type Timeline, type TimelineEvent, type ToGifOptions, type ToVideoOptions, createHuman, installMouseHelper };
+export { type CreateHumanOptions, type FfmpegPreset, type FfmpegTune, type Human, type HumanRecordOptions, type InstallMouseHelperOptions, type KeyModifier, type KeyName, type KeyOrChord, type MouseTarget, type PlaywrightTestOptions, type PressResult, type ReadOptions, type ReadResult, type ReadTarget, Recording, type RecordingQuality, type ScrollOptions, type ScrollResult, type ScrollTarget, type Speed, type Timeline, type TimelineEvent, type ToGifOptions, type ToVideoOptions, createHuman, installMouseHelper };

package/dist/index.d.ts

@@ -163,6 +163,28 @@ interface CaptureResult {
     cleanup(): Promise<void>;
 }
 
+/** Options for {@link generatePlaywrightTest} / `Recording.toPlaywright`. */
+interface PlaywrightTestOptions {
+    /**
+     * Keep recorded `sleep()` pauses. Default `false` — a test shouldn't carry
+     * human-timing waits (slow + flaky in CI; Playwright auto-waits instead).
+     */
+    readonly keepSleeps?: boolean;
+    /** Test title. Defaults to the recording's name, else `'recorded session'`. */
+    readonly title?: string;
+    /**
+     * Wrap actions in `test.step(...)` groups — a new step per navigation — so
+     * they show as collapsible sections in the HTML report / trace. Default false.
+     */
+    readonly steps?: boolean;
+    /**
+     * When all `goto`s share one origin, emit them as relative paths and add a
+     * note to set `use.baseURL` in the Playwright config (portable across
+     * environments). Default false — absolute URLs that run without any config.
+     */
+    readonly baseUrl?: boolean;
+}
+
 /**
  * Encoding quality preset. Picks the per-frame capture quality + the
  * ffmpeg encode settings used to assemble them into a video.
@@ -212,10 +234,18 @@ interface TimelineEvent {
     readonly durationMs: number;
     /** Error message, present only if the action threw. */
     readonly error?: string;
+    /**
+     * For `type` / `paste`: the actual text written, captured when
+     * `captureInputs` is on (the default). Omitted when capture is off or the
+     * target is a password field (always masked). Flows into exported code.
+     */
+    readonly inputValue?: string;
 }
 /** Structured action timeline of a recording. */
 interface Timeline {
     readonly version: 1;
+    /** Optional label for the recording (used as the generated test's title). */
+    readonly name?: string;
     readonly personality: string;
     readonly seed: string | null;
     readonly speed: string;
@@ -224,6 +254,7 @@ interface Timeline {
 }
 /** Metadata passed from `human.record()` into the Recording constructor. */
 interface RecordingTimelineSource {
+    readonly name?: string;
     readonly personality: string;
     readonly seed: string | null;
     readonly speed: string;
@@ -288,6 +319,30 @@ declare class Recording {
      * @returns the resolved output path.
      */
     toTimeline(outputPath: string): Promise<string>;
+    /**
+     * Generates a standalone, runnable HumanJS script from the timeline and
+     * writes it to `outputPath`. String selectors round-trip verbatim; typed
+     * values are included when `captureInputs` was on (passwords masked).
+     *
+     * Independent of frame capture — works on timeline-only recordings and is
+     * unaffected by `dispose()`.
+     *
+     * @returns the resolved output path.
+     */
+    toHumanJS(outputPath: string): Promise<string>;
+    /**
+     * Generates a `@playwright/test` spec from the timeline — a humanized test
+     * (uses `createHuman` + `human.*`), not raw Playwright — and writes it to
+     * `outputPath`. Runs instant in CI / recorded speed locally, drops timing
+     * `sleep()`s (pass `{ keepSleeps: true }` to keep them), and derives the
+     * assertions it safely can.
+     *
+     * Independent of frame capture — works on timeline-only recordings and is
+     * unaffected by `dispose()`.
+     *
+     * @returns the resolved output path.
+     */
+    toPlaywright(outputPath: string, options?: PlaywrightTestOptions): Promise<string>;
     /**
      * Releases the captured-frames temp directory. After this call, `toVideo()`
      * and `toGif()` throw — but `toTimeline()` and the in-memory `timeline`
@@ -777,6 +832,11 @@ interface Human {
 }
 /** Options for {@link Human.record}. */
 interface HumanRecordOptions {
+    /**
+     * Optional label for the recording. Stored on the timeline and used as the
+     * title of a generated `toPlaywright()` test.
+     */
+    readonly name?: string;
     /**
      * Whether to capture frames for video output. Defaults to `true`.
      * Set to `false` for timeline-only recordings (no capture loop, no
@@ -789,6 +849,21 @@ interface HumanRecordOptions {
      * Defaults to `'high'`. Ignored when `video: false`.
      */
     readonly quality?: RecordingQuality;
+    /**
+     * Capture the actual typed/pasted text into the timeline (and therefore
+     * into code generated by `toHumanJS()` / `toPlaywright()`). Defaults to
+     * `true`.
+     *
+     * Values typed/pasted into `input[type="password"]` are always masked
+     * (omitted) regardless of this flag — the video already renders them as
+     * dots, and freezing a cleartext secret into an artifact would leak more
+     * than the recording itself. Set `false` to record no input values at all;
+     * exporters then emit empty-string placeholders.
+     *
+     * Captured values land in the timeline JSON and any exported test, so treat
+     * those artifacts with the same care as the values themselves.
+     */
+    readonly captureInputs?: boolean;
 }
 /**
  * Creates a humanized session bound to a Playwright `Page`.
@@ -811,4 +886,4 @@ interface HumanRecordOptions {
  */
 declare function createHuman(page: Page, options?: CreateHumanOptions): Promise<Human>;
 
-export { type CreateHumanOptions, type FfmpegPreset, type FfmpegTune, type Human, type HumanRecordOptions, type InstallMouseHelperOptions, type KeyModifier, type KeyName, type KeyOrChord, type MouseTarget, type PressResult, type ReadOptions, type ReadResult, type ReadTarget, Recording, type RecordingQuality, type ScrollOptions, type ScrollResult, type ScrollTarget, type Speed, type Timeline, type TimelineEvent, type ToGifOptions, type ToVideoOptions, createHuman, installMouseHelper };
+export { type CreateHumanOptions, type FfmpegPreset, type FfmpegTune, type Human, type HumanRecordOptions, type InstallMouseHelperOptions, type KeyModifier, type KeyName, type KeyOrChord, type MouseTarget, type PlaywrightTestOptions, type PressResult, type ReadOptions, type ReadResult, type ReadTarget, Recording, type RecordingQuality, type ScrollOptions, type ScrollResult, type ScrollTarget, type Speed, type Timeline, type TimelineEvent, type ToGifOptions, type ToVideoOptions, createHuman, installMouseHelper };

package/dist/index.js

@@ -712,6 +712,205 @@ async function detectKindFromTag(locator) {
   if (tag === "pre" || tag === "code") return "code";
   return void 0;
 }
+
+// src/recording/codegen.ts
+var POINT_RE = /^point\((-?\d+(?:\.\d+)?),\s*(-?\d+(?:\.\d+)?)\)$/;
+var POINT_COMMENT = " // raw coordinate \u2014 replace with a locator for a stable selector";
+var UNCAPTURED_COMMENT = " // input not captured (masked or captureInputs disabled) \u2014 fill in (e.g. process.env.X)";
+function q(value) {
+  return `'${String(value ?? "").replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/\n/g, "\\n").replace(/\r/g, "\\r")}'`;
+}
+function targetArg(desc) {
+  const s = String(desc ?? "");
+  const m = s.match(POINT_RE);
+  if (m) return { code: `{ x: ${m[1]}, y: ${m[2]} }`, isPoint: true };
+  return { code: q(s), isPoint: false };
+}
+function createHumanOptions(timeline, ciSpeed = false) {
+  const parts = [`    personality: ${q(timeline.personality)},`];
+  if (timeline.seed !== null) parts.push(`    seed: ${q(timeline.seed)},`);
+  parts.push(
+    ciSpeed ? `    speed: process.env.CI ? 'instant' : ${q(timeline.speed)},` : `    speed: ${q(timeline.speed)},`
+  );
+  return `{
+${parts.join("\n")}
+  }`;
+}
+function emitScroll(target) {
+  const s = String(target ?? "natural");
+  if (s === "natural") return "  await human.scroll('natural');";
+  const by = s.match(/^by:(-?\d+(?:\.\d+)?)$/);
+  if (by) return `  await human.scroll({ by: ${by[1]} });`;
+  const to = s.match(/^to:(-?\d+(?:\.\d+)?)$/);
+  if (to) return `  await human.scroll({ to: ${to[1]} });`;
+  return `  await human.scroll(${q(s)});`;
+}
+function emitAction(e, opts = {}) {
+  const p = e.params;
+  switch (e.type) {
+    case "goto": {
+      const url = String(p.url ?? "");
+      if (opts.baseOrigin && url.startsWith(opts.baseOrigin)) {
+        return `  await human.goto(${q(url.slice(opts.baseOrigin.length) || "/")});`;
+      }
+      return `  await human.goto(${q(url)});`;
+    }
+    case "click":
+    case "rightClick":
+    case "hover":
+    case "move": {
+      const { code, isPoint: isPoint2 } = targetArg(p.target);
+      return `  await human.${e.type}(${code});${isPoint2 ? POINT_COMMENT : ""}`;
+    }
+    case "drag": {
+      const from = targetArg(p.from);
+      const to = targetArg(p.to);
+      const comment = from.isPoint || to.isPoint ? POINT_COMMENT : "";
+      return `  await human.drag(${from.code}, ${to.code});${comment}`;
+    }
+    case "type":
+    case "paste": {
+      const { code, isPoint: isPoint2 } = targetArg(p.target);
+      if (e.inputValue === void 0) {
+        return `  await human.${e.type}(${code}, '');${UNCAPTURED_COMMENT}`;
+      }
+      const call = `  await human.${e.type}(${code}, ${q(e.inputValue)});`;
+      if (opts.asserts && !isPoint2) {
+        return `${call}
+  await expect(page.locator(${code})).toHaveValue(${q(e.inputValue)});`;
+      }
+      return call;
+    }
+    case "press":
+      return `  await human.press(${q(p.key)});`;
+    case "scroll":
+      return emitScroll(p.target);
+    case "read": {
+      const desc = String(p.target ?? "");
+      if (/^\d+ words$/.test(desc) || /^text:\d+ chars$/.test(desc)) {
+        return `  // human.read(...) \u2014 ${desc}; original target not captured`;
+      }
+      const call = `  await human.read(${q(desc)});`;
+      if (opts.asserts) return `${call}
+  await expect(page.locator(${q(desc)})).toBeVisible();`;
+      return call;
+    }
+    case "sleep":
+      return `  await sleep(${Number(p.ms) || 0});`;
+    case "reload":
+      return "  await human.reload();";
+    case "goBack":
+      return "  await human.goBack();";
+    case "goForward":
+      return "  await human.goForward();";
+    default:
+      return `  // unsupported action: ${e.type}`;
+  }
+}
+function needsSleepImport(timeline) {
+  return timeline.events.some((e) => e.type === "sleep");
+}
+function generateHumanJS(timeline) {
+  const imports = needsSleepImport(timeline) ? "import { chromium, createHuman, sleep } from '@humanjs/playwright';" : "import { chromium, createHuman } from '@humanjs/playwright';";
+  const body = timeline.events.map((e) => emitAction(e)).join("\n");
+  return `${imports}
+
+async function main() {
+  const browser = await chromium.launch({ headless: false });
+  const page = await browser.newPage();
+  const human = await createHuman(page, ${createHumanOptions(timeline)});
+
+${body}
+
+  await browser.close();
+}
+
+main();
+`;
+}
+var NAV_TYPES = /* @__PURE__ */ new Set(["goto", "reload", "goBack", "goForward"]);
+function sharedGotoOrigin(events) {
+  let origin;
+  for (const e of events) {
+    if (e.type !== "goto") continue;
+    try {
+      const o = new URL(String(e.params.url ?? "")).origin;
+      if (origin === void 0) origin = o;
+      else if (origin !== o) return void 0;
+    } catch {
+      return void 0;
+    }
+  }
+  return origin;
+}
+function indentLines(block, pad) {
+  return block.split("\n").map((line) => line.length > 0 ? pad + line : line).join("\n");
+}
+function stepLabel(event, index, baseOrigin) {
+  switch (event.type) {
+    case "goto": {
+      const url = String(event.params.url ?? "");
+      const path = baseOrigin && url.startsWith(baseOrigin) ? url.slice(baseOrigin.length) || "/" : url;
+      return `go to ${path}`;
+    }
+    case "reload":
+      return "reload";
+    case "goBack":
+      return "go back";
+    case "goForward":
+      return "go forward";
+    default:
+      return `step ${index + 1}`;
+  }
+}
+function emitSteps(events, opts) {
+  const groups = [];
+  for (const e of events) {
+    const last = groups[groups.length - 1];
+    if (last === void 0 || NAV_TYPES.has(e.type)) groups.push([e]);
+    else last.push(e);
+  }
+  return groups.map((group, i) => {
+    const [first] = group;
+    const label = first ? stepLabel(first, i, opts.baseOrigin) : `step ${i + 1}`;
+    const inner = group.map((e) => indentLines(emitAction(e, opts), "  ")).join("\n");
+    return `  await test.step(${q(label)}, async () => {
+${inner}
+  });`;
+  }).join("\n\n");
+}
+function generatePlaywrightTest(timeline, options = {}) {
+  const events = options.keepSleeps ? timeline.events : timeline.events.filter((e) => e.type !== "sleep");
+  const baseOrigin = options.baseUrl ? sharedGotoOrigin(events) : void 0;
+  const emitOpts = { asserts: true, baseOrigin };
+  const body = options.steps ? emitSteps(events, emitOpts) : events.map((e) => emitAction(e, emitOpts)).join("\n");
+  const needsSleep = events.some((e) => e.type === "sleep");
+  const hasAsserts = body.includes("await expect(");
+  const testImport = hasAsserts ? "import { expect, test } from '@playwright/test';" : "import { test } from '@playwright/test';";
+  const humanImport = needsSleep ? "import { createHuman, sleep } from '@humanjs/playwright';" : "import { createHuman } from '@humanjs/playwright';";
+  const title = options.title ?? timeline.name ?? "recorded session";
+  const baseUrlNote = baseOrigin ? `  // Set use.baseURL = ${q(baseOrigin)} in playwright.config.ts for these relative paths.
+
+` : "";
+  const todo = [
+    hasAsserts ? "  // TODO: add assertions for the outcome of this flow, e.g.:" : "  // TODO: assert the outcome \u2014 import { expect } from '@playwright/test', e.g.:",
+    "  //   await expect(page).toHaveURL(/dashboard/);",
+    "  //   await expect(page.getByText('Welcome back')).toBeVisible();"
+  ].join("\n");
+  return `${testImport}
+${humanImport}
+
+test(${q(title)}, async ({ page }) => {
+  const human = await createHuman(page, ${createHumanOptions(timeline, true)});
+
+${baseUrlNote}${body}
+
+${todo}
+});
+`;
+}
+
+// src/recording/index.ts
 var pendingFrameCleanups = /* @__PURE__ */ new Set();
 var exitHandlerInstalled = false;
 function ensureExitHandler() {
@@ -807,6 +1006,7 @@ var Recording = class {
   get timeline() {
     return {
       version: 1,
+      ...this.#timelineSource.name !== void 0 ? { name: this.#timelineSource.name } : {},
       personality: this.#timelineSource.personality,
       seed: this.#timelineSource.seed,
       speed: this.#timelineSource.speed,
@@ -957,6 +1157,38 @@ var Recording = class {
 `, "utf8");
     return outputPath;
   }
+  /**
+   * Generates a standalone, runnable HumanJS script from the timeline and
+   * writes it to `outputPath`. String selectors round-trip verbatim; typed
+   * values are included when `captureInputs` was on (passwords masked).
+   *
+   * Independent of frame capture — works on timeline-only recordings and is
+   * unaffected by `dispose()`.
+   *
+   * @returns the resolved output path.
+   */
+  async toHumanJS(outputPath) {
+    await mkdir(dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, generateHumanJS(this.timeline), "utf8");
+    return outputPath;
+  }
+  /**
+   * Generates a `@playwright/test` spec from the timeline — a humanized test
+   * (uses `createHuman` + `human.*`), not raw Playwright — and writes it to
+   * `outputPath`. Runs instant in CI / recorded speed locally, drops timing
+   * `sleep()`s (pass `{ keepSleeps: true }` to keep them), and derives the
+   * assertions it safely can.
+   *
+   * Independent of frame capture — works on timeline-only recordings and is
+   * unaffected by `dispose()`.
+   *
+   * @returns the resolved output path.
+   */
+  async toPlaywright(outputPath, options) {
+    await mkdir(dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, generatePlaywrightTest(this.timeline, options), "utf8");
+    return outputPath;
+  }
   /**
    * Releases the captured-frames temp directory. After this call, `toVideo()`
    * and `toGif()` throw — but `toTimeline()` and the in-memory `timeline`
@@ -1228,7 +1460,8 @@ async function createHuman(page, options = {}) {
   let hasRecorded = false;
   let activeRecordingEvents = null;
   let activeRecordingStartMs = 0;
-  async function performAction(action, actionFn) {
+  let activeRecordingCaptureInputs = false;
+  async function performAction(action, actionFn, recordMeta) {
     for (const plugin of plugins) {
       await plugin.beforeAction?.(action);
     }
@@ -1242,7 +1475,8 @@ async function createHuman(page, options = {}) {
           type: action.type,
           params: action.params ?? {},
           tMs: startedAt - activeRecordingStartMs,
-          durationMs
+          durationMs,
+          ...recordMeta?.inputValue !== void 0 ? { inputValue: recordMeta.inputValue } : {}
         });
       }
       for (const plugin of plugins) {
@@ -1256,7 +1490,8 @@ async function createHuman(page, options = {}) {
           params: action.params ?? {},
           tMs: startedAt - activeRecordingStartMs,
           durationMs: Date.now() - startedAt,
-          error: error instanceof Error ? error.message : String(error)
+          error: error instanceof Error ? error.message : String(error),
+          ...recordMeta?.inputValue !== void 0 ? { inputValue: recordMeta.inputValue } : {}
         });
       }
       for (const plugin of plugins) {
@@ -1283,6 +1518,21 @@ async function createHuman(page, options = {}) {
     }
     return target.toString?.() ?? "locator";
   };
+  const isPointTarget = (target) => typeof target !== "string" && "x" in target && "y" in target && typeof target.x === "number";
+  const captureInputValue = async (target, value) => {
+    if (activeRecordingEvents === null || !activeRecordingCaptureInputs) return void 0;
+    const locator = typeof target === "string" ? page.locator(target) : isPointTarget(target) ? null : target;
+    if (locator !== null) {
+      try {
+        const fieldType = await locator.first().getAttribute("type", { timeout: 1e3 });
+        if (fieldType?.toLowerCase() === "password") {
+          return void 0;
+        }
+      } catch {
+      }
+    }
+    return value;
+  };
   return {
     personality,
     speed,
@@ -1324,6 +1574,7 @@ async function createHuman(page, options = {}) {
     },
     async type(target, value) {
       const description = describeMouseTarget(target);
+      const inputValue = await captureInputValue(target, value);
       await performAction(
         { type: "type", params: { target: description, length: value.length } },
         async () => {
@@ -1331,11 +1582,13 @@ async function createHuman(page, options = {}) {
             await executeClick(target, mouseCtx());
           }
           await executeType(target, value, { page, personality, rng, speed });
-        }
+        },
+        inputValue !== void 0 ? { inputValue } : void 0
       );
     },
     async paste(target, value) {
       const description = describeMouseTarget(target);
+      const inputValue = await captureInputValue(target, value);
       await performAction(
         { type: "paste", params: { target: description, length: value.length } },
         async () => {
@@ -1343,7 +1596,8 @@ async function createHuman(page, options = {}) {
             await executeClick(target, mouseCtx());
           }
           await executePaste(target, value, { page, personality, rng, speed });
-        }
+        },
+        inputValue !== void 0 ? { inputValue } : void 0
       );
     },
     async press(key) {
@@ -1412,6 +1666,7 @@ async function createHuman(page, options = {}) {
       const windowStartMs = Date.now();
       activeRecordingEvents = events;
       activeRecordingStartMs = windowStartMs;
+      activeRecordingCaptureInputs = recordOptions.captureInputs !== false;
       let windowEndMs = windowStartMs;
       try {
         await performAction({ type: "record", params: {} }, async () => {
@@ -1426,9 +1681,11 @@ async function createHuman(page, options = {}) {
         throw error;
       } finally {
         activeRecordingEvents = null;
+        activeRecordingCaptureInputs = false;
       }
       const captureResult = captureSession ? await captureSession.stop() : null;
       return new Recording(captureResult, windowStartMs, windowEndMs, {
+        name: recordOptions.name,
         personality: personality.name,
         seed: options.seed === void 0 ? null : String(options.seed),
         speed,