@tamsensedev/runner 0.10.0 → 0.13.0

package/dist/recorder.cjs

@@ -34,6 +34,7 @@ __export(recorder_exports, {
   DEFAULT_TITLE_ENV: () => DEFAULT_TITLE_ENV,
   DEFAULT_TRACKER_ORIGINS: () => DEFAULT_TRACKER_ORIGINS,
   MARK_TAG: () => MARK_TAG,
+  MAX_NOTES_LENGTH: () => MAX_NOTES_LENGTH,
   MAX_PURPOSE_LENGTH: () => MAX_PURPOSE_LENGTH,
   MAX_TITLE_LENGTH: () => MAX_TITLE_LENGTH,
   META_SUFFIX: () => META_SUFFIX,
@@ -43,6 +44,8 @@ __export(recorder_exports, {
   SERVER_ENV: () => SERVER_ENV,
   automaticCaption: () => automaticCaption,
   checkCaption: () => checkCaption,
+  checkNotes: () => checkNotes,
+  clip: () => clip,
   closeRecorded: () => closeRecorded,
   installAutoRecording: () => installAutoRecording,
   isExternalWrite: () => isExternalWrite,
@@ -74,6 +77,7 @@ var REPLAY_SUFFIX = ".rrweb.ndjson";
 var META_SUFFIX = ".json";
 var MAX_TITLE_LENGTH = 60;
 var MAX_PURPOSE_LENGTH = 160;
+var MAX_NOTES_LENGTH = 600;
 var DEFAULT_TRACKER_ORIGINS = ["https://my.tamsense.com"];
 var READ_METHODS = ["GET", "HEAD", "OPTIONS"];
 var BINDING = "__tamsenseRecord";
@@ -82,7 +86,10 @@ var FLUSH_MS = 100;
 var MAX_SESSION_BYTES = 300 * 1024 * 1024;
 var GAP_CHECK_MS = 1500;
 var MAX_LABEL_LENGTH = 120;
+var RRWEB_INCREMENTAL = 3;
 var RRWEB_META = 4;
+var RRWEB_SOURCE_MOUSE_INTERACTION = 2;
+var RRWEB_SOURCE_INPUT = 5;
 function state() {
   const holder = globalThis;
   holder[STATE_KEY] ??= { contexts: /* @__PURE__ */ new WeakMap(), pages: /* @__PURE__ */ new WeakMap(), instrumented: /* @__PURE__ */ new WeakSet(), script: null, hooked: false };
@@ -133,6 +140,13 @@ function checkCaption(caption) {
   }
   return { title, purpose };
 }
+function checkNotes(notes) {
+  const text = typeof notes === "string" ? notes.trim() : "";
+  if (text.length > MAX_NOTES_LENGTH) {
+    throw new Error(`Keep the notes within ${MAX_NOTES_LENGTH} characters: what you opened, clicked and expected, and whether it passed.`);
+  }
+  return text;
+}
 function clip(text, max) {
   return text.length > max ? `${text.slice(0, max - 1).trimEnd()}\u2026` : text;
 }
@@ -163,11 +177,22 @@ const send = (extra) => {
     buffer = [];
     return window.${BINDING}(JSON.stringify({ events, ...extra })).catch(() => {});
 };
+const urgent = (event) => event.type === ${RRWEB_INCREMENTAL} && (event.data.source === ${RRWEB_SOURCE_MOUSE_INTERACTION} || event.data.source === ${RRWEB_SOURCE_INPUT});
+const placeAtTarget = (interaction) => {
+    if (interaction.x !== 0 || interaction.y !== 0) return;
+    const node = rrweb.record.mirror.getNode(interaction.id);
+    if (!node || typeof node.getBoundingClientRect !== 'function') return;
+    const box = node.getBoundingClientRect();
+    interaction.x = Math.round(box.left + box.width / 2);
+    interaction.y = Math.round(box.top + box.height / 2);
+};
 rrweb.record({
     emit(event) {
         buffer.push(event);
-        if (!timer) timer = setTimeout(send, ${FLUSH_MS});
+        if (urgent(event)) send();
+        else if (!timer) timer = setTimeout(send, ${FLUSH_MS});
     },
+    hooks: { mouseInteraction: placeAtTarget },
     maskInputOptions: { password: true },
 });
 const crossOrigin = (frame) => { try { return new URL(frame.src, location.href).origin !== location.origin; } catch { return false; } };
@@ -180,6 +205,7 @@ const checkGaps = () => {
 };
 window.__tamsenseFlush = () => send();
 window.__tamsenseMark = (label) => { rrweb.record.addCustomEvent('${MARK_TAG}', { label }); return send(); };
+addEventListener('beforeunload', () => { send(); });
 addEventListener('pagehide', () => { send(); });
 addEventListener('load', () => setTimeout(checkGaps, ${GAP_CHECK_MS}));
 })();`;
@@ -198,7 +224,7 @@ var Session = class {
     const id = `${Date.now().toString(36)}-${Math.random().toString(16).slice(2, 8)}`;
     this.file = (0, import_node_path.join)(dir, `${id}${REPLAY_SUFFIX}`);
     this.metaFile = (0, import_node_path.join)(dir, `${id}${META_SUFFIX}`);
-    this.meta = { version: 1, id, ...recording.caption, startedAt: Date.now(), endedAt: null, url, marks: [], video: null, gaps: [], blockedTrackerRequests: 0, blockedExternalWrites: 0, truncated: false, automatic: recording.automatic };
+    this.meta = { version: 1, id, ...recording.caption, startedAt: Date.now(), endedAt: null, url, marks: [], video: null, gaps: [], blockedTrackerRequests: 0, blockedExternalWrites: 0, truncated: false, automatic: recording.automatic, notes: "" };
     (0, import_node_fs.writeFileSync)(this.file, "");
     this.save();
   }
@@ -242,8 +268,8 @@ var Session = class {
     }
   }
   summary() {
-    const { title, purpose, video, marks, gaps, blockedTrackerRequests, blockedExternalWrites } = this.meta;
-    return { title, purpose, replay: this.file, video, marks: marks.length, gaps, blockedTrackerRequests, blockedExternalWrites };
+    const { title, purpose, notes, video, marks, gaps, blockedTrackerRequests, blockedExternalWrites } = this.meta;
+    return { title, purpose, notes, replay: this.file, video, marks: marks.length, gaps, blockedTrackerRequests, blockedExternalWrites };
   }
 };
 function countBlocked(route, counter) {
@@ -344,9 +370,16 @@ async function mark(page, label) {
   await page.evaluate((value) => window.__tamsenseMark?.(value), text).catch(() => {
   });
 }
-async function closeRecorded(context) {
-  await context.close();
+async function closeRecorded(context, options = {}) {
   const sessions = state().contexts.get(context)?.sessions ?? [];
+  const notes = clip(String(options.notes ?? "").trim(), MAX_NOTES_LENGTH);
+  if (notes) {
+    for (const session of sessions) {
+      session.meta.notes = notes;
+      session.save();
+    }
+  }
+  await context.close();
   const summaries = sessions.map((session) => session.summary());
   for (const summary of summaries) {
     if (summary.gaps.length > 0 && !summary.video) {
@@ -401,6 +434,7 @@ if (import_node_process.default.env[RECORDINGS_DIR_ENV]) {
   DEFAULT_TITLE_ENV,
   DEFAULT_TRACKER_ORIGINS,
   MARK_TAG,
+  MAX_NOTES_LENGTH,
   MAX_PURPOSE_LENGTH,
   MAX_TITLE_LENGTH,
   META_SUFFIX,
@@ -410,6 +444,8 @@ if (import_node_process.default.env[RECORDINGS_DIR_ENV]) {
   SERVER_ENV,
   automaticCaption,
   checkCaption,
+  checkNotes,
+  clip,
   closeRecorded,
   installAutoRecording,
   isExternalWrite,

package/dist/recorder.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/recorder.ts","../../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.15_tsx@4.21.0_typescript@5.9.3_yaml@2.8.2/node_modules/tsup/assets/cjs_shims.js"],"sourcesContent":["import { appendFileSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'\r\nimport Module, { createRequire } from 'node:module'\r\nimport { basename, dirname, join } from 'node:path'\r\nimport process from 'node:process'\r\n\r\n// Запись браузера агента: rrweb пишет каждую страницу в свой файл NDJSON в папке запуска, по желанию ещё и видео.\r\n// Модуль самодостаточный: программа подключает его ко всем процессам Node агента через NODE_OPTIONS --require,\r\n// и тогда любой браузер Playwright записывается сам; скрипты агента импортируют его же, чтобы дать записи название и отметки\r\n\r\nexport const RECORDINGS_DIR_ENV = 'TAMSENSE_RECORDINGS_DIR'\r\nexport const SERVER_ENV = 'TAMSENSE_SERVER'\r\nexport const DEFAULT_TITLE_ENV = 'TAMSENSE_RECORDING_TITLE'\r\nexport const DEFAULT_PURPOSE_ENV = 'TAMSENSE_RECORDING_PURPOSE'\r\nexport const MARK_TAG = 'tamsense.mark'\r\nexport const REPLAY_SUFFIX = '.rrweb.ndjson'\r\nexport const META_SUFFIX = '.json'\r\nexport const MAX_TITLE_LENGTH = 60\r\nexport const MAX_PURPOSE_LENGTH = 160\r\n// трекер TAMsense по умолчанию шлёт сюда; адрес сервера из настроек программы добавляется к нему\r\nexport const DEFAULT_TRACKER_ORIGINS = ['https://my.tamsense.com']\r\n\r\n// эти методы только читают; остальные к адресам вне компьютера отменяются\r\nexport const READ_METHODS = ['GET', 'HEAD', 'OPTIONS']\r\n\r\nconst BINDING = '__tamsenseRecord'\r\nconst STATE_KEY = Symbol.for('tamsense.recorder')\r\nconst FLUSH_MS = 100\r\nconst MAX_SESSION_BYTES = 300 * 1024 * 1024\r\nconst GAP_CHECK_MS = 1500\r\nconst MAX_LABEL_LENGTH = 120\r\nconst RRWEB_META = 4\r\n\r\nexport interface RecordingCaption {\r\n    title: string\r\n    purpose: string\r\n}\r\n\r\nexport interface RecordedContextOptions extends RecordingCaption {\r\n    // видео в придачу к записи: для canvas, карт, видео на странице, чужих iframe или когда его попросили\r\n    video?: boolean\r\n    // обычные настройки browser.newContext: viewport, storageState и другие\r\n    context?: Record<string, unknown>\r\n}\r\n\r\nexport interface SessionMark {\r\n    ts: number\r\n    label: string\r\n}\r\n\r\n// Что знает программа о записи одной страницы; лежит рядом с файлом записи\r\nexport interface SessionMeta {\r\n    version: 1\r\n    id: string\r\n    title: string\r\n    purpose: string\r\n    startedAt: number\r\n    endedAt: number | null\r\n    url: string\r\n    marks: SessionMark[]\r\n    video: string | null\r\n    gaps: string[]\r\n    blockedTrackerRequests: number\r\n    blockedExternalWrites: number\r\n    truncated: boolean\r\n    // записано само, без названия от агента\r\n    automatic: boolean\r\n}\r\n\r\nexport interface RecordingSummary {\r\n    title: string\r\n    purpose: string\r\n    replay: string\r\n    video: string | null\r\n    marks: number\r\n    gaps: string[]\r\n    blockedTrackerRequests: number\r\n    blockedExternalWrites: number\r\n}\r\n\r\ninterface PlaywrightVideo {\r\n    path: () => Promise<string>\r\n}\r\n\r\ninterface PlaywrightPage {\r\n    url: () => string\r\n    isClosed: () => boolean\r\n    on: (event: 'close', listener: () => void) => unknown\r\n    evaluate: (fn: string | ((arg: never) => unknown), arg?: unknown) => Promise<unknown>\r\n    video: () => PlaywrightVideo | null\r\n}\r\n\r\ninterface PlaywrightRoute {\r\n    fulfill: (response: { status: number, contentType: string, body: string }) => Promise<void>\r\n    abort: (errorCode?: string) => Promise<void>\r\n    continue: () => Promise<void>\r\n    request: () => { method: () => string, url: () => string, frame: () => { page: () => PlaywrightPage } }\r\n}\r\n\r\nexport interface PlaywrightContext {\r\n    pages: () => PlaywrightPage[]\r\n    on: (event: 'page' | 'close', listener: (page: PlaywrightPage) => void) => unknown\r\n    exposeBinding: (name: string, callback: (source: { page: PlaywrightPage }, payload: string) => unknown) => Promise<void>\r\n    addInitScript: (script: { content: string }) => Promise<void>\r\n    route: (url: (url: URL) => boolean, handler: (route: PlaywrightRoute) => Promise<void>) => Promise<void>\r\n    close: (options?: unknown) => Promise<void>\r\n}\r\n\r\nexport interface PlaywrightBrowser {\r\n    newContext: (options?: Record<string, unknown>) => Promise<PlaywrightContext>\r\n}\r\n\r\ninterface Instrumentation {\r\n    addListener: (listener: { runAfterCreateBrowserContext: (context: PlaywrightContext) => Promise<void> }) => void\r\n}\r\n\r\ninterface ContextRecording {\r\n    caption: RecordingCaption\r\n    automatic: boolean\r\n    sessions: Session[]\r\n}\r\n\r\ninterface RecorderState {\r\n    contexts: WeakMap<PlaywrightContext, ContextRecording>\r\n    pages: WeakMap<PlaywrightPage, Session>\r\n    instrumented: WeakSet<object>\r\n    script: string | null\r\n    hooked: boolean\r\n}\r\n\r\nfunction state(): RecorderState {\r\n    const holder = globalThis as { [STATE_KEY]?: RecorderState }\r\n    holder[STATE_KEY] ??= { contexts: new WeakMap(), pages: new WeakMap(), instrumented: new WeakSet(), script: null, hooked: false }\r\n    return holder[STATE_KEY]\r\n}\r\n\r\nfunction recordingsDir(): string {\r\n    const dir = process.env[RECORDINGS_DIR_ENV]\r\n    if (!dir) {\r\n        throw new Error(`${RECORDINGS_DIR_ENV} is not set: recordings work only inside a TAMsense run`)\r\n    }\r\n    return dir\r\n}\r\n\r\nfunction warn(text: string): void {\r\n    process.stderr.write(`[tamsense recorder] ${text}\\n`)\r\n}\r\n\r\n// Правило блокировки трекера TAMsense: запрос на адрес, который кончается на /api/events, с ключом проекта в ?key=\r\n// или к серверу TAMsense. Так записи агента не попадают в аналитику и недельный разбор\r\nexport function isTrackerIngest(url: URL, tamsenseOrigins: readonly string[]): boolean {\r\n    if (!/\\/api\\/events\\/?$/.test(url.pathname)) {\r\n        return false\r\n    }\r\n    return url.searchParams.has('key') || tamsenseOrigins.includes(url.origin)\r\n}\r\n\r\n// Своим считается только сам компьютер: localhost, *.localhost, адреса loopback и 0.0.0.0. Имена контейнеров браузер\r\n// на компьютере не видит, поэтому имя без точки тоже чужое\r\nexport function isLocalHost(hostname: string): boolean {\r\n    const host = hostname.toLowerCase().replace(/^\\[|\\]$/g, '').replace(/\\.$/, '')\r\n    return host === 'localhost' || host.endsWith('.localhost') || host === '::1' || host === '0.0.0.0' || /^127(?:\\.\\d{1,3}){3}$/.test(host)\r\n}\r\n\r\n// Запрос, который может что-то изменить у чужого сервиса: метод не только читает, а адрес вне этого компьютера\r\nexport function isExternalWrite(method: string, url: URL): boolean {\r\n    return !READ_METHODS.includes(method.toUpperCase()) && !isLocalHost(url.hostname)\r\n}\r\n\r\nexport function trackerOrigins(env: Record<string, string | undefined> = process.env): string[] {\r\n    const origins = new Set(DEFAULT_TRACKER_ORIGINS)\r\n    try {\r\n        if (env[SERVER_ENV]) {\r\n            origins.add(new URL(env[SERVER_ENV]).origin)\r\n        }\r\n    }\r\n    catch {}\r\n    return [...origins]\r\n}\r\n\r\nexport function checkCaption(caption: Partial<RecordingCaption> | undefined): RecordingCaption {\r\n    const title = typeof caption?.title === 'string' ? caption.title.trim() : ''\r\n    const purpose = typeof caption?.purpose === 'string' ? caption.purpose.trim() : ''\r\n    if (!title || !purpose) {\r\n        throw new Error('Give it a title (what it shows, for example \"Design option 1\" or \"Feature testing, attempt 2\") and a purpose (one line on why it was made).')\r\n    }\r\n    if (title.length > MAX_TITLE_LENGTH || purpose.length > MAX_PURPOSE_LENGTH) {\r\n        throw new Error(`Keep the title within ${MAX_TITLE_LENGTH} characters and the purpose within ${MAX_PURPOSE_LENGTH}.`)\r\n    }\r\n    return { title, purpose }\r\n}\r\n\r\nfunction clip(text: string, max: number): string {\r\n    return text.length > max ? `${text.slice(0, max - 1).trimEnd()}…` : text\r\n}\r\n\r\n// Название записи, которую никто не назвал: из настроек запуска и имени скрипта, который открыл браузер\r\nexport function automaticCaption(env: Record<string, string | undefined> = process.env, script: string | undefined = process.argv[1]): RecordingCaption {\r\n    const from = script ? `, opened by ${basename(script)}` : ''\r\n    return {\r\n        title: clip(env[DEFAULT_TITLE_ENV]?.trim() || 'Browser session', MAX_TITLE_LENGTH),\r\n        purpose: clip(`${env[DEFAULT_PURPOSE_ENV]?.trim() || 'Recorded automatically while the agent used a browser'}${from}`, MAX_PURPOSE_LENGTH),\r\n    }\r\n}\r\n\r\n// Сборка rrweb без модулей: UMD кладёт её в локальный module.exports, страница своего rrweb не видит и не теряет\r\nfunction rrwebSource(): string {\r\n    const entry = createRequire(import.meta.url).resolve('rrweb')\r\n    return readFileSync(join(dirname(entry), 'rrweb.umd.min.cjs'), 'utf8')\r\n}\r\n\r\n// Скрипт для каждой страницы: пишет только верхний документ, iframe того же сайта rrweb снимает сам.\r\n// События уходят в программу пачками через exposeBinding, пароли скрыты, как в rrweb по умолчанию\r\nexport function pageScript(rrweb: string): string {\r\n    return `(() => {\r\nif (window.top !== window || window.__tamsenseRecording) return;\r\nwindow.__tamsenseRecording = true;\r\nconst rrweb = (() => { const module = { exports: {} }; const exports = module.exports; ${rrweb}\r\n; return module.exports; })();\r\nlet buffer = [];\r\nlet timer = null;\r\nconst send = (extra) => {\r\n    clearTimeout(timer);\r\n    timer = null;\r\n    if (!buffer.length && !extra) return Promise.resolve();\r\n    const events = buffer;\r\n    buffer = [];\r\n    return window.${BINDING}(JSON.stringify({ events, ...extra })).catch(() => {});\r\n};\r\nrrweb.record({\r\n    emit(event) {\r\n        buffer.push(event);\r\n        if (!timer) timer = setTimeout(send, ${FLUSH_MS});\r\n    },\r\n    maskInputOptions: { password: true },\r\n});\r\nconst crossOrigin = (frame) => { try { return new URL(frame.src, location.href).origin !== location.origin; } catch { return false; } };\r\nconst checkGaps = () => {\r\n    const gaps = [];\r\n    if (document.querySelector('canvas')) gaps.push('canvas');\r\n    if (document.querySelector('video')) gaps.push('video');\r\n    if ([...document.querySelectorAll('iframe')].some(crossOrigin)) gaps.push('cross-origin iframe');\r\n    if (gaps.length) send({ gaps });\r\n};\r\nwindow.__tamsenseFlush = () => send();\r\nwindow.__tamsenseMark = (label) => { rrweb.record.addCustomEvent('${MARK_TAG}', { label }); return send(); };\r\naddEventListener('pagehide', () => { send(); });\r\naddEventListener('load', () => setTimeout(checkGaps, ${GAP_CHECK_MS}));\r\n})();`\r\n}\r\n\r\nfunction script(): string {\r\n    const current = state()\r\n    current.script ??= pageScript(rrwebSource())\r\n    return current.script\r\n}\r\n\r\nclass Session {\r\n    readonly file: string\r\n    readonly metaFile: string\r\n    readonly meta: SessionMeta\r\n    private bytes = 0\r\n\r\n    constructor(dir: string, recording: ContextRecording, url: string) {\r\n        const id = `${Date.now().toString(36)}-${Math.random().toString(16).slice(2, 8)}`\r\n        this.file = join(dir, `${id}${REPLAY_SUFFIX}`)\r\n        this.metaFile = join(dir, `${id}${META_SUFFIX}`)\r\n        this.meta = { version: 1, id, ...recording.caption, startedAt: Date.now(), endedAt: null, url, marks: [], video: null, gaps: [], blockedTrackerRequests: 0, blockedExternalWrites: 0, truncated: false, automatic: recording.automatic }\r\n        writeFileSync(this.file, '')\r\n        this.save()\r\n    }\r\n\r\n    save(): void {\r\n        writeFileSync(this.metaFile, `${JSON.stringify(this.meta, null, 2)}\\n`)\r\n    }\r\n\r\n    receive(payload: string): void {\r\n        let batch: { events?: unknown[], gaps?: string[] }\r\n        try {\r\n            batch = JSON.parse(payload) as typeof batch\r\n        }\r\n        catch {\r\n            return\r\n        }\r\n        if (batch.gaps?.length) {\r\n            this.meta.gaps = [...new Set([...this.meta.gaps, ...batch.gaps])]\r\n            this.save()\r\n        }\r\n        const page = (batch.events as Array<{ type?: unknown, data?: { href?: unknown } }> | undefined)?.find(event => event.type === RRWEB_META && typeof event.data?.href === 'string' && event.data.href !== 'about:blank')\r\n        if (page && this.meta.url === 'about:blank') {\r\n            this.meta.url = String(page.data!.href)\r\n            this.save()\r\n        }\r\n        const lines = (batch.events ?? []).map(event => JSON.stringify(event)).join('\\n')\r\n        if (!lines || this.meta.truncated) {\r\n            return\r\n        }\r\n        if (this.bytes + lines.length > MAX_SESSION_BYTES) {\r\n            this.meta.truncated = true\r\n            this.save()\r\n            return\r\n        }\r\n        this.bytes += lines.length + 1\r\n        appendFileSync(this.file, `${lines}\\n`)\r\n    }\r\n\r\n    end(): void {\r\n        if (this.meta.endedAt === null) {\r\n            this.meta.endedAt = Date.now()\r\n            this.save()\r\n        }\r\n    }\r\n\r\n    summary(): RecordingSummary {\r\n        const { title, purpose, video, marks, gaps, blockedTrackerRequests, blockedExternalWrites } = this.meta\r\n        return { title, purpose, replay: this.file, video, marks: marks.length, gaps, blockedTrackerRequests, blockedExternalWrites }\r\n    }\r\n}\r\n\r\nfunction countBlocked(route: PlaywrightRoute, counter: 'blockedTrackerRequests' | 'blockedExternalWrites'): void {\r\n    try {\r\n        const session = state().pages.get(route.request().frame().page())\r\n        if (session) {\r\n            session.meta[counter] += 1\r\n            session.save()\r\n        }\r\n    }\r\n    catch {}\r\n}\r\n\r\nasync function startSession(recording: ContextRecording, page: PlaywrightPage, injectNow: boolean): Promise<void> {\r\n    const current = state()\r\n    if (current.pages.has(page)) {\r\n        return\r\n    }\r\n    const session = new Session(recordingsDir(), recording, page.url())\r\n    current.pages.set(page, session)\r\n    recording.sessions.push(session)\r\n    page.on('close', () => session.end())\r\n    const video = page.video()\r\n    if (video) {\r\n        session.meta.video = await video.path().catch(() => null)\r\n        session.save()\r\n    }\r\n    // страница уже была открыта до записи: скрипт для будущих страниц её не коснётся\r\n    if (injectNow) {\r\n        await page.evaluate(script()).catch(() => {})\r\n    }\r\n}\r\n\r\nasync function flush(context: PlaywrightContext): Promise<void> {\r\n    await Promise.all(context.pages().filter(page => !page.isClosed()).map(page =>\r\n        page.evaluate(() => (window as unknown as { __tamsenseFlush?: () => Promise<void> }).__tamsenseFlush?.(), undefined).catch(() => {}),\r\n    ))\r\n}\r\n\r\n// Записывает контекст Playwright; второй вызов для того же контекста только меняет название и назначение записи.\r\n// automatic: контекст записан сам, название придумала программа\r\nexport async function recordContext(context: PlaywrightContext, caption: RecordingCaption, automatic = false): Promise<void> {\r\n    const checked = checkCaption(caption)\r\n    const current = state()\r\n    const known = current.contexts.get(context)\r\n    if (known) {\r\n        Object.assign(known, { caption: checked, automatic })\r\n        for (const session of known.sessions) {\r\n            Object.assign(session.meta, checked, { automatic })\r\n            session.save()\r\n        }\r\n        return\r\n    }\r\n    mkdirSync(recordingsDir(), { recursive: true })\r\n    const recording: ContextRecording = { caption: checked, automatic, sessions: [] }\r\n    current.contexts.set(context, recording)\r\n    const origins = trackerOrigins()\r\n    // маршруты Playwright идут от последнего к первому: трекер отвечает раньше, запись наружу отменяется после\r\n    await context.route(url => !isLocalHost(url.hostname), async (route) => {\r\n        const request = route.request()\r\n        if (!isExternalWrite(request.method(), new URL(request.url()))) {\r\n            // страница могла закрыться, пока запрос шёл\r\n            await route.continue().catch(() => {})\r\n            return\r\n        }\r\n        countBlocked(route, 'blockedExternalWrites')\r\n        await route.abort('blockedbyclient').catch(() => {})\r\n    })\r\n    await context.route(url => isTrackerIngest(url, origins), async (route) => {\r\n        countBlocked(route, 'blockedTrackerRequests')\r\n        await route.fulfill({ status: 200, contentType: 'application/json', body: '{\"ok\":true}' })\r\n    })\r\n    await context.exposeBinding(BINDING, ({ page }, payload) => current.pages.get(page)?.receive(payload))\r\n    await context.addInitScript({ content: script() })\r\n    context.on('page', page => void startSession(recording, page, false))\r\n    context.on('close', () => recording.sessions.forEach(session => session.end()))\r\n    for (const page of context.pages()) {\r\n        await startSession(recording, page, true)\r\n    }\r\n    const close = context.close.bind(context)\r\n    context.close = async (options?: unknown) => {\r\n        await flush(context)\r\n        return close(options)\r\n    }\r\n}\r\n\r\n// Новый записанный контекст: название и назначение обязательны, video: true добавляет видео Playwright\r\nexport async function newRecordedContext(browser: PlaywrightBrowser, options: RecordedContextOptions): Promise<PlaywrightContext> {\r\n    const caption = checkCaption(options)\r\n    const extra = options.video ? { recordVideo: { dir: join(recordingsDir(), 'video') } } : {}\r\n    const context = await browser.newContext({ ...options.context, ...extra })\r\n    await recordContext(context, caption)\r\n    return context\r\n}\r\n\r\n// Отметка шага: видна на шкале плеера и в списке отметок, клик по ней перематывает запись к этому месту\r\nexport async function mark(page: PlaywrightPage, label: string): Promise<void> {\r\n    const text = clip(String(label ?? '').trim(), MAX_LABEL_LENGTH)\r\n    const session = state().pages.get(page)\r\n    if (!text || !session) {\r\n        warn(text ? 'mark() was called for a page that is not recorded' : 'mark() needs a label')\r\n        return\r\n    }\r\n    session.meta.marks.push({ ts: Date.now(), label: text })\r\n    session.save()\r\n    await page.evaluate(value => (window as unknown as { __tamsenseMark?: (label: string) => Promise<void> }).__tamsenseMark?.(value), text).catch(() => {})\r\n}\r\n\r\n// Закрывает записанный контекст и говорит, что записано; подсказывает видео, если записи не хватит\r\nexport async function closeRecorded(context: PlaywrightContext): Promise<RecordingSummary[]> {\r\n    await context.close()\r\n    const sessions = state().contexts.get(context)?.sessions ?? []\r\n    const summaries = sessions.map(session => session.summary())\r\n    for (const summary of summaries) {\r\n        if (summary.gaps.length > 0 && !summary.video) {\r\n            warn(`\"${summary.title}\" has ${summary.gaps.join(', ')}: the replay may not show it. Record it again with video: true.`)\r\n        }\r\n    }\r\n    return summaries\r\n}\r\n\r\nfunction instrument(exports: unknown): void {\r\n    const chromium = (exports as { chromium?: { launch?: unknown, _instrumentation?: Instrumentation } } | null)?.chromium\r\n    const instrumentation = (exports as { _instrumentation?: Instrumentation } | null)?._instrumentation ?? chromium?._instrumentation\r\n    const current = state()\r\n    if (typeof chromium?.launch !== 'function' || typeof instrumentation?.addListener !== 'function' || current.instrumented.has(instrumentation)) {\r\n        return\r\n    }\r\n    current.instrumented.add(instrumentation)\r\n    instrumentation.addListener({\r\n        runAfterCreateBrowserContext: async (context) => {\r\n            try {\r\n                if (!current.contexts.has(context)) {\r\n                    await recordContext(context, automaticCaption(), true)\r\n                }\r\n            }\r\n            catch (error) {\r\n                warn(`could not record this browser: ${error instanceof Error ? error.message : String(error)}`)\r\n            }\r\n        },\r\n    })\r\n}\r\n\r\n// Сам цепляется к Playwright, как только его загрузят: агент не может забыть включить запись\r\nexport function installAutoRecording(): void {\r\n    const current = state()\r\n    if (current.hooked) {\r\n        return\r\n    }\r\n    current.hooked = true\r\n    const loader = Module as unknown as { _load: (request: string, parent: unknown, isMain: boolean) => unknown }\r\n    const load = loader._load\r\n    loader._load = function (this: unknown, ...args: [string, unknown, boolean]) {\r\n        const exports = load.apply(this, args)\r\n        try {\r\n            instrument(exports)\r\n        }\r\n        catch {}\r\n        return exports\r\n    }\r\n}\r\n\r\nif (process.env[RECORDINGS_DIR_ENV]) {\r\n    installAutoRecording()\r\n}\r\n","// Shim globals in cjs bundle\n// There's a weird bug that esbuild will always inject importMetaUrl\n// if we export it as `const importMetaUrl = ... __filename ...`\n// But using a function will not cause this issue\n\nconst getImportMetaUrl = () => \n  typeof document === \"undefined\" \n    ? new URL(`file:${__filename}`).href \n    : (document.currentScript && document.currentScript.tagName.toUpperCase() === 'SCRIPT') \n      ? document.currentScript.src \n      : new URL(\"main.js\", document.baseURI).href;\n\nexport const importMetaUrl = /* @__PURE__ */ getImportMetaUrl()\n"],"mappings":"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","names":["process","script","exports","Module"]}
+{"version":3,"sources":["../src/recorder.ts","../../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.15_tsx@4.21.0_typescript@5.9.3_yaml@2.8.2/node_modules/tsup/assets/cjs_shims.js"],"sourcesContent":["import { appendFileSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'\r\nimport Module, { createRequire } from 'node:module'\r\nimport { basename, dirname, join } from 'node:path'\r\nimport process from 'node:process'\r\n\r\n// Запись браузера агента: rrweb пишет каждую страницу в свой файл NDJSON в папке запуска, по желанию ещё и видео.\r\n// Модуль самодостаточный: программа подключает его ко всем процессам Node агента через NODE_OPTIONS --require,\r\n// и тогда любой браузер Playwright записывается сам; скрипты агента импортируют его же, чтобы дать записи название и отметки\r\n\r\nexport const RECORDINGS_DIR_ENV = 'TAMSENSE_RECORDINGS_DIR'\r\nexport const SERVER_ENV = 'TAMSENSE_SERVER'\r\nexport const DEFAULT_TITLE_ENV = 'TAMSENSE_RECORDING_TITLE'\r\nexport const DEFAULT_PURPOSE_ENV = 'TAMSENSE_RECORDING_PURPOSE'\r\nexport const MARK_TAG = 'tamsense.mark'\r\nexport const REPLAY_SUFFIX = '.rrweb.ndjson'\r\nexport const META_SUFFIX = '.json'\r\nexport const MAX_TITLE_LENGTH = 60\r\nexport const MAX_PURPOSE_LENGTH = 160\r\nexport const MAX_NOTES_LENGTH = 600\r\n// трекер TAMsense по умолчанию шлёт сюда; адрес сервера из настроек программы добавляется к нему\r\nexport const DEFAULT_TRACKER_ORIGINS = ['https://my.tamsense.com']\r\n\r\n// эти методы только читают; остальные к адресам вне компьютера отменяются\r\nexport const READ_METHODS = ['GET', 'HEAD', 'OPTIONS']\r\n\r\nconst BINDING = '__tamsenseRecord'\r\nconst STATE_KEY = Symbol.for('tamsense.recorder')\r\nconst FLUSH_MS = 100\r\nconst MAX_SESSION_BYTES = 300 * 1024 * 1024\r\nconst GAP_CHECK_MS = 1500\r\nconst MAX_LABEL_LENGTH = 120\r\nconst RRWEB_INCREMENTAL = 3\r\nconst RRWEB_META = 4\r\nconst RRWEB_SOURCE_MOUSE_INTERACTION = 2\r\nconst RRWEB_SOURCE_INPUT = 5\r\n\r\nexport interface RecordingCaption {\r\n    title: string\r\n    purpose: string\r\n}\r\n\r\nexport interface RecordedContextOptions extends RecordingCaption {\r\n    // видео в придачу к записи: для canvas, карт, видео на странице, чужих iframe или когда его попросили\r\n    video?: boolean\r\n    // обычные настройки browser.newContext: viewport, storageState и другие\r\n    context?: Record<string, unknown>\r\n}\r\n\r\nexport interface RecordingNotes {\r\n    notes?: string\r\n}\r\n\r\nexport interface SessionMark {\r\n    ts: number\r\n    label: string\r\n}\r\n\r\n// Что знает программа о записи одной страницы; лежит рядом с файлом записи\r\nexport interface SessionMeta {\r\n    version: 1\r\n    id: string\r\n    title: string\r\n    purpose: string\r\n    startedAt: number\r\n    endedAt: number | null\r\n    url: string\r\n    marks: SessionMark[]\r\n    video: string | null\r\n    gaps: string[]\r\n    blockedTrackerRequests: number\r\n    blockedExternalWrites: number\r\n    truncated: boolean\r\n    // записано само, без названия от агента\r\n    automatic: boolean\r\n    // что агент проверял и чем кончилось, его словами; пусто, пока он не закрыл запись с заметкой\r\n    notes: string\r\n}\r\n\r\nexport interface RecordingSummary {\r\n    title: string\r\n    purpose: string\r\n    notes: string\r\n    replay: string\r\n    video: string | null\r\n    marks: number\r\n    gaps: string[]\r\n    blockedTrackerRequests: number\r\n    blockedExternalWrites: number\r\n}\r\n\r\ninterface PlaywrightVideo {\r\n    path: () => Promise<string>\r\n}\r\n\r\ninterface PlaywrightPage {\r\n    url: () => string\r\n    isClosed: () => boolean\r\n    on: (event: 'close', listener: () => void) => unknown\r\n    evaluate: (fn: string | ((arg: never) => unknown), arg?: unknown) => Promise<unknown>\r\n    video: () => PlaywrightVideo | null\r\n}\r\n\r\ninterface PlaywrightRoute {\r\n    fulfill: (response: { status: number, contentType: string, body: string }) => Promise<void>\r\n    abort: (errorCode?: string) => Promise<void>\r\n    continue: () => Promise<void>\r\n    request: () => { method: () => string, url: () => string, frame: () => { page: () => PlaywrightPage } }\r\n}\r\n\r\nexport interface PlaywrightContext {\r\n    pages: () => PlaywrightPage[]\r\n    on: (event: 'page' | 'close', listener: (page: PlaywrightPage) => void) => unknown\r\n    exposeBinding: (name: string, callback: (source: { page: PlaywrightPage }, payload: string) => unknown) => Promise<void>\r\n    addInitScript: (script: { content: string }) => Promise<void>\r\n    route: (url: (url: URL) => boolean, handler: (route: PlaywrightRoute) => Promise<void>) => Promise<void>\r\n    close: (options?: unknown) => Promise<void>\r\n}\r\n\r\nexport interface PlaywrightBrowser {\r\n    newContext: (options?: Record<string, unknown>) => Promise<PlaywrightContext>\r\n}\r\n\r\ninterface Instrumentation {\r\n    addListener: (listener: { runAfterCreateBrowserContext: (context: PlaywrightContext) => Promise<void> }) => void\r\n}\r\n\r\ninterface ContextRecording {\r\n    caption: RecordingCaption\r\n    automatic: boolean\r\n    sessions: Session[]\r\n}\r\n\r\ninterface RecorderState {\r\n    contexts: WeakMap<PlaywrightContext, ContextRecording>\r\n    pages: WeakMap<PlaywrightPage, Session>\r\n    instrumented: WeakSet<object>\r\n    script: string | null\r\n    hooked: boolean\r\n}\r\n\r\nfunction state(): RecorderState {\r\n    const holder = globalThis as { [STATE_KEY]?: RecorderState }\r\n    holder[STATE_KEY] ??= { contexts: new WeakMap(), pages: new WeakMap(), instrumented: new WeakSet(), script: null, hooked: false }\r\n    return holder[STATE_KEY]\r\n}\r\n\r\nfunction recordingsDir(): string {\r\n    const dir = process.env[RECORDINGS_DIR_ENV]\r\n    if (!dir) {\r\n        throw new Error(`${RECORDINGS_DIR_ENV} is not set: recordings work only inside a TAMsense run`)\r\n    }\r\n    return dir\r\n}\r\n\r\nfunction warn(text: string): void {\r\n    process.stderr.write(`[tamsense recorder] ${text}\\n`)\r\n}\r\n\r\n// Правило блокировки трекера TAMsense: запрос на адрес, который кончается на /api/events, с ключом проекта в ?key=\r\n// или к серверу TAMsense. Так записи агента не попадают в аналитику и недельный разбор\r\nexport function isTrackerIngest(url: URL, tamsenseOrigins: readonly string[]): boolean {\r\n    if (!/\\/api\\/events\\/?$/.test(url.pathname)) {\r\n        return false\r\n    }\r\n    return url.searchParams.has('key') || tamsenseOrigins.includes(url.origin)\r\n}\r\n\r\n// Своим считается только сам компьютер: localhost, *.localhost, адреса loopback и 0.0.0.0. Имена контейнеров браузер\r\n// на компьютере не видит, поэтому имя без точки тоже чужое\r\nexport function isLocalHost(hostname: string): boolean {\r\n    const host = hostname.toLowerCase().replace(/^\\[|\\]$/g, '').replace(/\\.$/, '')\r\n    return host === 'localhost' || host.endsWith('.localhost') || host === '::1' || host === '0.0.0.0' || /^127(?:\\.\\d{1,3}){3}$/.test(host)\r\n}\r\n\r\n// Запрос, который может что-то изменить у чужого сервиса: метод не только читает, а адрес вне этого компьютера\r\nexport function isExternalWrite(method: string, url: URL): boolean {\r\n    return !READ_METHODS.includes(method.toUpperCase()) && !isLocalHost(url.hostname)\r\n}\r\n\r\nexport function trackerOrigins(env: Record<string, string | undefined> = process.env): string[] {\r\n    const origins = new Set(DEFAULT_TRACKER_ORIGINS)\r\n    try {\r\n        if (env[SERVER_ENV]) {\r\n            origins.add(new URL(env[SERVER_ENV]).origin)\r\n        }\r\n    }\r\n    catch {}\r\n    return [...origins]\r\n}\r\n\r\nexport function checkCaption(caption: Partial<RecordingCaption> | undefined): RecordingCaption {\r\n    const title = typeof caption?.title === 'string' ? caption.title.trim() : ''\r\n    const purpose = typeof caption?.purpose === 'string' ? caption.purpose.trim() : ''\r\n    if (!title || !purpose) {\r\n        throw new Error('Give it a title (what it shows, for example \"Design option 1\" or \"Feature testing, attempt 2\") and a purpose (one line on why it was made).')\r\n    }\r\n    if (title.length > MAX_TITLE_LENGTH || purpose.length > MAX_PURPOSE_LENGTH) {\r\n        throw new Error(`Keep the title within ${MAX_TITLE_LENGTH} characters and the purpose within ${MAX_PURPOSE_LENGTH}.`)\r\n    }\r\n    return { title, purpose }\r\n}\r\n\r\n// Заметка к записи от инструментов attach_replay и attach_video: длиннее предела не принимается, агент её сократит\r\nexport function checkNotes(notes: unknown): string {\r\n    const text = typeof notes === 'string' ? notes.trim() : ''\r\n    if (text.length > MAX_NOTES_LENGTH) {\r\n        throw new Error(`Keep the notes within ${MAX_NOTES_LENGTH} characters: what you opened, clicked and expected, and whether it passed.`)\r\n    }\r\n    return text\r\n}\r\n\r\nexport function clip(text: string, max: number): string {\r\n    return text.length > max ? `${text.slice(0, max - 1).trimEnd()}…` : text\r\n}\r\n\r\n// Название записи, которую никто не назвал: из настроек запуска и имени скрипта, который открыл браузер\r\nexport function automaticCaption(env: Record<string, string | undefined> = process.env, script: string | undefined = process.argv[1]): RecordingCaption {\r\n    const from = script ? `, opened by ${basename(script)}` : ''\r\n    return {\r\n        title: clip(env[DEFAULT_TITLE_ENV]?.trim() || 'Browser session', MAX_TITLE_LENGTH),\r\n        purpose: clip(`${env[DEFAULT_PURPOSE_ENV]?.trim() || 'Recorded automatically while the agent used a browser'}${from}`, MAX_PURPOSE_LENGTH),\r\n    }\r\n}\r\n\r\n// Сборка rrweb без модулей: UMD кладёт её в локальный module.exports, страница своего rrweb не видит и не теряет\r\nfunction rrwebSource(): string {\r\n    const entry = createRequire(import.meta.url).resolve('rrweb')\r\n    return readFileSync(join(dirname(entry), 'rrweb.umd.min.cjs'), 'utf8')\r\n}\r\n\r\n// Скрипт для каждой страницы: пишет только верхний документ, iframe того же сайта rrweb снимает сам.\r\n// События уходят в программу пачками через exposeBinding, пароли скрыты, как в rrweb по умолчанию.\r\n// Клики и ввод уходят сразу: клик по ссылке уводит страницу раньше, чем сработает таймер, и Playwright выбрасывает\r\n// пачку, пришедшую от уже закрытой страницы. Клик без координат (element.click() из скрипта) ставится в центр элемента\r\nexport function pageScript(rrweb: string): string {\r\n    return `(() => {\r\nif (window.top !== window || window.__tamsenseRecording) return;\r\nwindow.__tamsenseRecording = true;\r\nconst rrweb = (() => { const module = { exports: {} }; const exports = module.exports; ${rrweb}\r\n; return module.exports; })();\r\nlet buffer = [];\r\nlet timer = null;\r\nconst send = (extra) => {\r\n    clearTimeout(timer);\r\n    timer = null;\r\n    if (!buffer.length && !extra) return Promise.resolve();\r\n    const events = buffer;\r\n    buffer = [];\r\n    return window.${BINDING}(JSON.stringify({ events, ...extra })).catch(() => {});\r\n};\r\nconst urgent = (event) => event.type === ${RRWEB_INCREMENTAL} && (event.data.source === ${RRWEB_SOURCE_MOUSE_INTERACTION} || event.data.source === ${RRWEB_SOURCE_INPUT});\r\nconst placeAtTarget = (interaction) => {\r\n    if (interaction.x !== 0 || interaction.y !== 0) return;\r\n    const node = rrweb.record.mirror.getNode(interaction.id);\r\n    if (!node || typeof node.getBoundingClientRect !== 'function') return;\r\n    const box = node.getBoundingClientRect();\r\n    interaction.x = Math.round(box.left + box.width / 2);\r\n    interaction.y = Math.round(box.top + box.height / 2);\r\n};\r\nrrweb.record({\r\n    emit(event) {\r\n        buffer.push(event);\r\n        if (urgent(event)) send();\r\n        else if (!timer) timer = setTimeout(send, ${FLUSH_MS});\r\n    },\r\n    hooks: { mouseInteraction: placeAtTarget },\r\n    maskInputOptions: { password: true },\r\n});\r\nconst crossOrigin = (frame) => { try { return new URL(frame.src, location.href).origin !== location.origin; } catch { return false; } };\r\nconst checkGaps = () => {\r\n    const gaps = [];\r\n    if (document.querySelector('canvas')) gaps.push('canvas');\r\n    if (document.querySelector('video')) gaps.push('video');\r\n    if ([...document.querySelectorAll('iframe')].some(crossOrigin)) gaps.push('cross-origin iframe');\r\n    if (gaps.length) send({ gaps });\r\n};\r\nwindow.__tamsenseFlush = () => send();\r\nwindow.__tamsenseMark = (label) => { rrweb.record.addCustomEvent('${MARK_TAG}', { label }); return send(); };\r\naddEventListener('beforeunload', () => { send(); });\r\naddEventListener('pagehide', () => { send(); });\r\naddEventListener('load', () => setTimeout(checkGaps, ${GAP_CHECK_MS}));\r\n})();`\r\n}\r\n\r\nfunction script(): string {\r\n    const current = state()\r\n    current.script ??= pageScript(rrwebSource())\r\n    return current.script\r\n}\r\n\r\nclass Session {\r\n    readonly file: string\r\n    readonly metaFile: string\r\n    readonly meta: SessionMeta\r\n    private bytes = 0\r\n\r\n    constructor(dir: string, recording: ContextRecording, url: string) {\r\n        const id = `${Date.now().toString(36)}-${Math.random().toString(16).slice(2, 8)}`\r\n        this.file = join(dir, `${id}${REPLAY_SUFFIX}`)\r\n        this.metaFile = join(dir, `${id}${META_SUFFIX}`)\r\n        this.meta = { version: 1, id, ...recording.caption, startedAt: Date.now(), endedAt: null, url, marks: [], video: null, gaps: [], blockedTrackerRequests: 0, blockedExternalWrites: 0, truncated: false, automatic: recording.automatic, notes: '' }\r\n        writeFileSync(this.file, '')\r\n        this.save()\r\n    }\r\n\r\n    save(): void {\r\n        writeFileSync(this.metaFile, `${JSON.stringify(this.meta, null, 2)}\\n`)\r\n    }\r\n\r\n    receive(payload: string): void {\r\n        let batch: { events?: unknown[], gaps?: string[] }\r\n        try {\r\n            batch = JSON.parse(payload) as typeof batch\r\n        }\r\n        catch {\r\n            return\r\n        }\r\n        if (batch.gaps?.length) {\r\n            this.meta.gaps = [...new Set([...this.meta.gaps, ...batch.gaps])]\r\n            this.save()\r\n        }\r\n        const page = (batch.events as Array<{ type?: unknown, data?: { href?: unknown } }> | undefined)?.find(event => event.type === RRWEB_META && typeof event.data?.href === 'string' && event.data.href !== 'about:blank')\r\n        if (page && this.meta.url === 'about:blank') {\r\n            this.meta.url = String(page.data!.href)\r\n            this.save()\r\n        }\r\n        const lines = (batch.events ?? []).map(event => JSON.stringify(event)).join('\\n')\r\n        if (!lines || this.meta.truncated) {\r\n            return\r\n        }\r\n        if (this.bytes + lines.length > MAX_SESSION_BYTES) {\r\n            this.meta.truncated = true\r\n            this.save()\r\n            return\r\n        }\r\n        this.bytes += lines.length + 1\r\n        appendFileSync(this.file, `${lines}\\n`)\r\n    }\r\n\r\n    end(): void {\r\n        if (this.meta.endedAt === null) {\r\n            this.meta.endedAt = Date.now()\r\n            this.save()\r\n        }\r\n    }\r\n\r\n    summary(): RecordingSummary {\r\n        const { title, purpose, notes, video, marks, gaps, blockedTrackerRequests, blockedExternalWrites } = this.meta\r\n        return { title, purpose, notes, replay: this.file, video, marks: marks.length, gaps, blockedTrackerRequests, blockedExternalWrites }\r\n    }\r\n}\r\n\r\nfunction countBlocked(route: PlaywrightRoute, counter: 'blockedTrackerRequests' | 'blockedExternalWrites'): void {\r\n    try {\r\n        const session = state().pages.get(route.request().frame().page())\r\n        if (session) {\r\n            session.meta[counter] += 1\r\n            session.save()\r\n        }\r\n    }\r\n    catch {}\r\n}\r\n\r\nasync function startSession(recording: ContextRecording, page: PlaywrightPage, injectNow: boolean): Promise<void> {\r\n    const current = state()\r\n    if (current.pages.has(page)) {\r\n        return\r\n    }\r\n    const session = new Session(recordingsDir(), recording, page.url())\r\n    current.pages.set(page, session)\r\n    recording.sessions.push(session)\r\n    page.on('close', () => session.end())\r\n    const video = page.video()\r\n    if (video) {\r\n        session.meta.video = await video.path().catch(() => null)\r\n        session.save()\r\n    }\r\n    // страница уже была открыта до записи: скрипт для будущих страниц её не коснётся\r\n    if (injectNow) {\r\n        await page.evaluate(script()).catch(() => {})\r\n    }\r\n}\r\n\r\nasync function flush(context: PlaywrightContext): Promise<void> {\r\n    await Promise.all(context.pages().filter(page => !page.isClosed()).map(page =>\r\n        page.evaluate(() => (window as unknown as { __tamsenseFlush?: () => Promise<void> }).__tamsenseFlush?.(), undefined).catch(() => {}),\r\n    ))\r\n}\r\n\r\n// Записывает контекст Playwright; второй вызов для того же контекста только меняет название и назначение записи.\r\n// automatic: контекст записан сам, название придумала программа\r\nexport async function recordContext(context: PlaywrightContext, caption: RecordingCaption, automatic = false): Promise<void> {\r\n    const checked = checkCaption(caption)\r\n    const current = state()\r\n    const known = current.contexts.get(context)\r\n    if (known) {\r\n        Object.assign(known, { caption: checked, automatic })\r\n        for (const session of known.sessions) {\r\n            Object.assign(session.meta, checked, { automatic })\r\n            session.save()\r\n        }\r\n        return\r\n    }\r\n    mkdirSync(recordingsDir(), { recursive: true })\r\n    const recording: ContextRecording = { caption: checked, automatic, sessions: [] }\r\n    current.contexts.set(context, recording)\r\n    const origins = trackerOrigins()\r\n    // маршруты Playwright идут от последнего к первому: трекер отвечает раньше, запись наружу отменяется после\r\n    await context.route(url => !isLocalHost(url.hostname), async (route) => {\r\n        const request = route.request()\r\n        if (!isExternalWrite(request.method(), new URL(request.url()))) {\r\n            // страница могла закрыться, пока запрос шёл\r\n            await route.continue().catch(() => {})\r\n            return\r\n        }\r\n        countBlocked(route, 'blockedExternalWrites')\r\n        await route.abort('blockedbyclient').catch(() => {})\r\n    })\r\n    await context.route(url => isTrackerIngest(url, origins), async (route) => {\r\n        countBlocked(route, 'blockedTrackerRequests')\r\n        await route.fulfill({ status: 200, contentType: 'application/json', body: '{\"ok\":true}' })\r\n    })\r\n    await context.exposeBinding(BINDING, ({ page }, payload) => current.pages.get(page)?.receive(payload))\r\n    await context.addInitScript({ content: script() })\r\n    context.on('page', page => void startSession(recording, page, false))\r\n    context.on('close', () => recording.sessions.forEach(session => session.end()))\r\n    for (const page of context.pages()) {\r\n        await startSession(recording, page, true)\r\n    }\r\n    const close = context.close.bind(context)\r\n    context.close = async (options?: unknown) => {\r\n        await flush(context)\r\n        return close(options)\r\n    }\r\n}\r\n\r\n// Новый записанный контекст: название и назначение обязательны, video: true добавляет видео Playwright\r\nexport async function newRecordedContext(browser: PlaywrightBrowser, options: RecordedContextOptions): Promise<PlaywrightContext> {\r\n    const caption = checkCaption(options)\r\n    const extra = options.video ? { recordVideo: { dir: join(recordingsDir(), 'video') } } : {}\r\n    const context = await browser.newContext({ ...options.context, ...extra })\r\n    await recordContext(context, caption)\r\n    return context\r\n}\r\n\r\n// Отметка шага: видна на шкале плеера и в списке отметок, клик по ней перематывает запись к этому месту\r\nexport async function mark(page: PlaywrightPage, label: string): Promise<void> {\r\n    const text = clip(String(label ?? '').trim(), MAX_LABEL_LENGTH)\r\n    const session = state().pages.get(page)\r\n    if (!text || !session) {\r\n        warn(text ? 'mark() was called for a page that is not recorded' : 'mark() needs a label')\r\n        return\r\n    }\r\n    session.meta.marks.push({ ts: Date.now(), label: text })\r\n    session.save()\r\n    await page.evaluate(value => (window as unknown as { __tamsenseMark?: (label: string) => Promise<void> }).__tamsenseMark?.(value), text).catch(() => {})\r\n}\r\n\r\n// Закрывает записанный контекст и говорит, что записано; подсказывает видео, если записи не хватит.\r\n// notes: что агент проверял в этой записи и чем кончилось, его словами; длинная заметка обрезается, а не теряется\r\nexport async function closeRecorded(context: PlaywrightContext, options: RecordingNotes = {}): Promise<RecordingSummary[]> {\r\n    const sessions = state().contexts.get(context)?.sessions ?? []\r\n    const notes = clip(String(options.notes ?? '').trim(), MAX_NOTES_LENGTH)\r\n    if (notes) {\r\n        for (const session of sessions) {\r\n            session.meta.notes = notes\r\n            session.save()\r\n        }\r\n    }\r\n    await context.close()\r\n    const summaries = sessions.map(session => session.summary())\r\n    for (const summary of summaries) {\r\n        if (summary.gaps.length > 0 && !summary.video) {\r\n            warn(`\"${summary.title}\" has ${summary.gaps.join(', ')}: the replay may not show it. Record it again with video: true.`)\r\n        }\r\n    }\r\n    return summaries\r\n}\r\n\r\nfunction instrument(exports: unknown): void {\r\n    const chromium = (exports as { chromium?: { launch?: unknown, _instrumentation?: Instrumentation } } | null)?.chromium\r\n    const instrumentation = (exports as { _instrumentation?: Instrumentation } | null)?._instrumentation ?? chromium?._instrumentation\r\n    const current = state()\r\n    if (typeof chromium?.launch !== 'function' || typeof instrumentation?.addListener !== 'function' || current.instrumented.has(instrumentation)) {\r\n        return\r\n    }\r\n    current.instrumented.add(instrumentation)\r\n    instrumentation.addListener({\r\n        runAfterCreateBrowserContext: async (context) => {\r\n            try {\r\n                if (!current.contexts.has(context)) {\r\n                    await recordContext(context, automaticCaption(), true)\r\n                }\r\n            }\r\n            catch (error) {\r\n                warn(`could not record this browser: ${error instanceof Error ? error.message : String(error)}`)\r\n            }\r\n        },\r\n    })\r\n}\r\n\r\n// Сам цепляется к Playwright, как только его загрузят: агент не может забыть включить запись\r\nexport function installAutoRecording(): void {\r\n    const current = state()\r\n    if (current.hooked) {\r\n        return\r\n    }\r\n    current.hooked = true\r\n    const loader = Module as unknown as { _load: (request: string, parent: unknown, isMain: boolean) => unknown }\r\n    const load = loader._load\r\n    loader._load = function (this: unknown, ...args: [string, unknown, boolean]) {\r\n        const exports = load.apply(this, args)\r\n        try {\r\n            instrument(exports)\r\n        }\r\n        catch {}\r\n        return exports\r\n    }\r\n}\r\n\r\nif (process.env[RECORDINGS_DIR_ENV]) {\r\n    installAutoRecording()\r\n}\r\n","// Shim globals in cjs bundle\n// There's a weird bug that esbuild will always inject importMetaUrl\n// if we export it as `const importMetaUrl = ... __filename ...`\n// But using a function will not cause this issue\n\nconst getImportMetaUrl = () => \n  typeof document === \"undefined\" \n    ? new URL(`file:${__filename}`).href \n    : (document.currentScript && document.currentScript.tagName.toUpperCase() === 'SCRIPT') \n      ? document.currentScript.src \n      : new URL(\"main.js\", document.baseURI).href;\n\nexport const importMetaUrl = /* @__PURE__ */ getImportMetaUrl()\n"],"mappings":"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","names":["process","script","exports","Module"]}

package/library/agents/ui-tester.md

@@ -17,7 +17,7 @@ The caller should give you the task or acceptance criteria, the repository folde
 3. Find the project's E2E setup and how the app starts (scripts, CI workflow, `.env.example`). Check required environment variables by name only.
    Start only a local copy from the task folder, as the `ui-testing` skill's `references/local-stand.md` says; if Docker is not running, there is no local setup or the settings point outside this computer, start nothing and return `UI check: could not run` with the exact reason and what a person should do.
 4. Run the related E2E specs headless if a suite exists; check what it does not cover with the headless check script written to a new folder in the OS temp directory.
-5. Every browser you open is recorded for the task. In your own scripts, open contexts through the recorder in `TAMSENSE_RECORDER` with a title named after the goal and attempt ("Feature testing", "Second attempt at feature testing") and a one-line purpose, call `mark` at each step of a scenario, and add `video: true` for canvas, maps, video players or iframes from another site, or when the caller asks for a video (the `ui-testing` skill's `references/recording.md`).
+5. Every browser you open is recorded for the task. In your own scripts, open contexts through the recorder in `TAMSENSE_RECORDER` with a title named after the goal and attempt ("Feature testing", "Second attempt at feature testing") and a one-line purpose, call `mark` at each step of a scenario, close it with notes on what you tested and what happened (what you opened, clicked and expected, passed or failed), and add `video: true` for canvas, maps, video players or iframes from another site, or when the caller asks for a video (the `ui-testing` skill's `references/recording.md`).
 6. Open every screenshot with Read and describe what it shows.
 7. Stop every server you started, by its process id only (never `taskkill /IM`, `pkill` or `killall`: other programs on this computer may run on the same runtime), delete your temp folders, and confirm with `git status` that the repository is unchanged.
 

package/library/skills/ui-testing/SKILL.md

@@ -19,7 +19,7 @@ The project's own setup wins: its E2E framework, config, fixtures, page objects,
 5. **Never fake it.** If the app cannot start (missing environment variables, secrets, a database or service you may not use), report exactly what is missing. Do not mock the whole backend and call the result a pass, and do not invent screenshots or results.
 6. **Do not write to shared systems.** If the settings point at a shared, staging or production backend or database, do not start the app: the check could not run (local-stand.md, rule 7). Recorded browsers also abort requests that change data on other computers.
 7. **Never hide failures.** Do not skip, `fixme`, delete or loosen a failing test to get a green run. In a check step, a failing test is a finding.
-9. **Every browser is recorded for the task.** In a TAMsense run each Playwright context becomes a replay people watch on the task, and the tested site's TAMsense tracker is blocked. Open contexts through the recorder with a title and a purpose, mark the meaningful steps, and add a video for canvas, maps, video players or iframes from another site: see [references/recording.md](references/recording.md).
+9. **Every browser is recorded for the task.** In a TAMsense run each Playwright context becomes a replay people watch on the task, and the tested site's TAMsense tracker is blocked. Open contexts through the recorder with a title and a purpose, mark the meaningful steps, close each with notes on what you tested and what happened, and add a video for canvas, maps, video players or iframes from another site: see [references/recording.md](references/recording.md).
 
 ## Process
 

package/library/skills/ui-testing/references/headless-check.md

@@ -175,6 +175,21 @@ async function openContext(browser, path, width) {
     return recorder.newRecordedContext(browser, { title, purpose: CONFIG.purpose, video: CONFIG.video, context: options })
 }
 
+// Notes for the replay: what this page check did and what it found, read on the task before anyone presses play
+function pageNotes(result) {
+    const failedRequests = result.failedRequests.length + result.badResponses.length
+    const found = [
+        result.error && `the check stopped: ${result.error}`,
+        result.status >= 400 && `the page answered ${result.status}`,
+        result.pageErrors.length > 0 && `${result.pageErrors.length} page errors`,
+        result.consoleErrors.length > 0 && `${result.consoleErrors.length} console errors`,
+        failedRequests > 0 && `${failedRequests} failed requests`,
+        result.horizontalOverflowPx > 0 && `the page scrolls sideways by ${result.horizontalOverflowPx}px`,
+    ].filter(Boolean)
+    const outcome = found.length > 0 ? `Found ${found.join(', ')}.` : 'No errors, failed requests or sideways scroll.'
+    return `Opened ${result.path} at ${result.width}px and ran the steps. ${outcome}`.slice(0, 600)
+}
+
 async function checkPage(browser, url, path, width, axeSource) {
     const context = await openContext(browser, path, width)
     const page = await context.newPage()
@@ -201,7 +216,7 @@ async function checkPage(browser, url, path, width, axeSource) {
     } catch (error) {
         result.error = String(error.message).split('\n')[0]
     } finally {
-        result.recording = recorder ? await recorder.closeRecorded(context) : await context.close()
+        result.recording = recorder ? await recorder.closeRecorded(context, { notes: pageNotes(result) }) : await context.close()
     }
     return result
 }
@@ -270,7 +285,7 @@ Steps that write data only touch the local app and whatever local database it us
 ## Reading the summary
 
 - `server`: should be `stopped`. Anything else names a process you must stop yourself before finishing.
-- `recording`: where each page's replay (and video) is. They are attached to the task when the run ends; `attach_replay` and `attach_video` attach one sooner.
+- `recording`: where each page's replay (and video) is, with the notes the script wrote from this summary. They are attached to the task when the run ends. When you know what a replay proves (the expected state showed, or exactly what broke), attach it sooner with `attach_replay` and your own notes: what you opened, clicked and expected, and whether it passed.
 - `setupError`: the app or the browser did not start. Report it with the last lines of `serverOutputTail` (strip anything that looks like a secret). Do not retry with a different command unless the first one was clearly wrong, and never invent results.
 - `status` 4xx or 5xx, `pageErrors`, `consoleErrors`: real findings when they come from the changed code; noise from browser extensions does not exist here, but third-party scripts and dev-server warnings do. Say which is which.
 - `badResponses` and `failedRequests`: API calls the page needed that failed. A 401 or a redirect to a login page means the page needs a signed-in user (see the auth section of [playwright-patterns.md](playwright-patterns.md)).

package/library/skills/ui-testing/references/recording.md

@@ -9,6 +9,7 @@ Read this before any script that opens a browser during a TAMsense run. People o
 - Requests other than GET, HEAD and OPTIONS to an address outside this computer (anything but `localhost`, `*.localhost` and loopback addresses) are aborted, so a test run never writes to an outside service. The summary from `closeRecorded` counts them in `blockedExternalWrites`. If a flow you check needs such a write, it was set up against an outside service: say so instead of working around it.
 - Password fields are masked in the replay.
 - Recordings you did not attach yourself are attached when the run ends. Unnamed ones get the step name as their title, so name yours.
+- The task shows who made each recording: your role, the step, the round and the computer. You do not write that yourself.
 
 ## What you add in every browser script
 
@@ -33,14 +34,16 @@ await recorder?.mark(page, 'Opened checkout')
 await page.getByRole('button', { name: 'Pay' }).click()
 await recorder?.mark(page, 'Paid, the receipt is shown')
 
-const recorded = recorder ? await recorder.closeRecorded(context) : await context.close()
+const notes = 'Opened checkout with a saved card and clicked Pay. Expected the receipt with the corrected total of $42: it showed $42. Passed.'
+const recorded = recorder ? await recorder.closeRecorded(context, { notes }) : await context.close()
 console.log(JSON.stringify(recorded, null, 2))
 ```
 
 - `title`: what it shows, at most 60 characters. Number design variants ("Design option 1", "Design option 2") and name test runs by their goal and attempt ("Feature testing", "Second attempt at feature testing"). Never generic names like "screenshot1" or "test".
 - `purpose`: one line, at most 160 characters, on why it was made ("Comparing two layouts for the empty orders state").
 - `mark(page, label)`: call it at each meaningful step (opened a screen, submitted a form, saw the error). Marks show on the replay's timeline, and a click on one jumps there.
-- `closeRecorded(context)`: closes the context, finishes the files and returns where they are. Close every context this way, or at least with `context.close()`, before the script ends.
+- `closeRecorded(context, { notes })`: closes the context, finishes the files and returns where they are. Close every context this way, or at least with `context.close()`, before the script ends.
+- `notes`: what you tested in this browser and what happened, in your own words, at most 600 characters: what you opened, what you clicked or typed, what you expected, and whether it passed or failed. People see them on the replay card and above the player before they press play, so write them for someone who did not read your report. Write them after the steps ran, from what you actually saw. A recording without notes shows the marks you set instead, and without marks, "No notes from the agent".
 - Without `TAMSENSE_RECORDER` (not a TAMsense run) the script works as before.
 
 ## When to add a video
@@ -55,4 +58,4 @@ A replay rebuilds the page from its DOM, so it cannot show pixels drawn by the p
 
 ## Attaching earlier
 
-Everything is attached at the end of the run. To attach a recording sooner, or with a better title, call `attach_replay` (the `.rrweb.ndjson` file) or `attach_video` (the `.webm` file) with the path from `closeRecorded`, a title and a purpose. A run attaches at most 20 replays and 5 videos; the ones you named come first.
+Everything is attached at the end of the run. To attach a recording sooner, or with a better title, call `attach_replay` (the `.rrweb.ndjson` file) or `attach_video` (the `.webm` file) with the path from `closeRecorded`, a title, a purpose and notes (the notes you gave `closeRecorded` are used when you leave them out). A run attaches at most 20 replays and 5 videos; the ones you named come first.

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@tamsensedev/runner",
     "type": "module",
-    "version": "0.10.0",
+    "version": "0.13.0",
     "description": "Connects your computer to TAMsense so it can work on your tasks",
     "author": "TAMsense",
     "license": "UNLICENSED",