screencli 0.1.0

package/dist/src/export/exporter.js

@@ -0,0 +1,66 @@
+import { join } from 'node:path';
+import { getPreset } from './presets.js';
+import { computeSmartCrop, buildCropFilter } from './smart-crop.js';
+import { exportGif } from './gif.js';
+import { runFFmpeg } from '../video/ffmpeg.js';
+import { buildBackgroundFilterComplex, computeFitLayout } from '../video/background.js';
+import { logger } from '../utils/logger.js';
+export async function runExport(options) {
+    const preset = getPreset(options.presetName);
+    const ext = preset.format === 'gif' ? 'gif' : 'mp4';
+    const outputPath = options.outputPath ?? join(options.outputDir, `${preset.name}.${ext}`);
+    logger.info(`Exporting with preset: ${preset.name} (${preset.width}x${preset.height})`);
+    // Compute smart crop for aspect ratio conversion
+    const crop = computeSmartCrop(options.events, options.metadata.viewport, preset);
+    const cropFilter = buildCropFilter(crop, preset);
+    if (preset.format === 'gif') {
+        await exportGif(options.sourceVideo, outputPath, preset, cropFilter);
+        return outputPath;
+    }
+    // MP4 export
+    if (options.background) {
+        // With background: fit video inside gradient at preset dimensions
+        const outputVP = { width: preset.width, height: preset.height };
+        const layout = computeFitLayout(options.metadata.viewport, outputVP, options.background.padding);
+        const fc = buildBackgroundFilterComplex([], outputVP, options.background, layout);
+        logger.info(`Applying ${options.background.gradient} background at ${preset.width}x${preset.height}`);
+        const args = [
+            '-map', '[out]',
+            '-c:v', preset.codec,
+            '-preset', 'fast',
+            '-crf', '23',
+            '-pix_fmt', 'yuv420p',
+            '-r', String(preset.fps),
+        ];
+        if (preset.max_duration_s) {
+            args.push('-t', String(preset.max_duration_s));
+        }
+        await runFFmpeg({
+            input: options.sourceVideo,
+            output: outputPath,
+            filterComplex: fc,
+            outputArgs: args,
+        });
+    }
+    else {
+        const filters = [cropFilter];
+        const args = [
+            '-vf', filters.join(','),
+            '-c:v', preset.codec,
+            '-preset', 'fast',
+            '-crf', '23',
+            '-pix_fmt', 'yuv420p',
+            '-r', String(preset.fps),
+        ];
+        if (preset.max_duration_s) {
+            args.push('-t', String(preset.max_duration_s));
+        }
+        await runFFmpeg({
+            input: options.sourceVideo,
+            output: outputPath,
+            outputArgs: args,
+        });
+    }
+    return outputPath;
+}
+//# sourceMappingURL=exporter.js.map

package/dist/src/export/exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.js","sourceRoot":"","sources":["../../../src/export/exporter.ts"],"names":[],"mappings":"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"}

package/dist/src/export/gif.d.ts

@@ -0,0 +1,3 @@
+import type { ExportPreset } from '../recording/types.js';
+export declare function exportGif(inputPath: string, outputPath: string, preset: ExportPreset, cropFilter?: string): Promise<void>;
+//# sourceMappingURL=gif.d.ts.map

package/dist/src/export/gif.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gif.d.ts","sourceRoot":"","sources":["../../../src/export/gif.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,EACpB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/dist/src/export/gif.js

@@ -0,0 +1,36 @@
+import { runFFmpeg } from '../video/ffmpeg.js';
+import { join, dirname } from 'node:path';
+export async function exportGif(inputPath, outputPath, preset, cropFilter) {
+    const palettePath = join(dirname(outputPath), '_palette.png');
+    const baseFilter = cropFilter
+        ? `${cropFilter},fps=${preset.fps}`
+        : `scale=${preset.width}:${preset.height},fps=${preset.fps}`;
+    // Pass 1: Generate palette
+    await runFFmpeg({
+        input: inputPath,
+        output: palettePath,
+        outputArgs: [
+            '-vf', `${baseFilter},palettegen=stats_mode=diff`,
+            ...(preset.max_duration_s ? ['-t', String(preset.max_duration_s)] : []),
+        ],
+    });
+    // Pass 2: Use palette to create GIF
+    await runFFmpeg({
+        input: inputPath,
+        output: outputPath,
+        outputArgs: [
+            '-i', palettePath,
+            '-lavfi', `${baseFilter}[x];[x][1:v]paletteuse=dither=bayer:bayer_scale=3`,
+            ...(preset.max_duration_s ? ['-t', String(preset.max_duration_s)] : []),
+        ],
+    });
+    // Clean up palette
+    try {
+        const { unlinkSync } = await import('node:fs');
+        unlinkSync(palettePath);
+    }
+    catch {
+        // ignore
+    }
+}
+//# sourceMappingURL=gif.js.map

package/dist/src/export/gif.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gif.js","sourceRoot":"","sources":["../../../src/export/gif.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,SAAiB,EACjB,UAAkB,EAClB,MAAoB,EACpB,UAAmB;IAEnB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,CAAC;IAE9D,MAAM,UAAU,GAAG,UAAU;QAC3B,CAAC,CAAC,GAAG,UAAU,QAAQ,MAAM,CAAC,GAAG,EAAE;QACnC,CAAC,CAAC,SAAS,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,QAAQ,MAAM,CAAC,GAAG,EAAE,CAAC;IAE/D,2BAA2B;IAC3B,MAAM,SAAS,CAAC;QACd,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,WAAW;QACnB,UAAU,EAAE;YACV,KAAK,EAAE,GAAG,UAAU,6BAA6B;YACjD,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACxE;KACF,CAAC,CAAC;IAEH,oCAAoC;IACpC,MAAM,SAAS,CAAC;QACd,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,UAAU;QAClB,UAAU,EAAE;YACV,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,GAAG,UAAU,mDAAmD;YAC1E,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACxE;KACF,CAAC,CAAC;IAEH,mBAAmB;IACnB,IAAI,CAAC;QACH,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/C,UAAU,CAAC,WAAW,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;AACH,CAAC"}

package/dist/src/export/presets.d.ts

@@ -0,0 +1,4 @@
+import type { ExportPreset } from '../recording/types.js';
+export declare const presets: Record<string, ExportPreset>;
+export declare function getPreset(name: string): ExportPreset;
+//# sourceMappingURL=presets.d.ts.map

package/dist/src/export/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/export/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA2DhD,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAMpD"}

package/dist/src/export/presets.js

@@ -0,0 +1,68 @@
+export const presets = {
+    youtube: {
+        name: 'youtube',
+        aspect_ratio: [16, 9],
+        width: 1920,
+        height: 1080,
+        format: 'mp4',
+        codec: 'libx264',
+        fps: 30,
+    },
+    twitter: {
+        name: 'twitter',
+        aspect_ratio: [16, 9],
+        width: 1280,
+        height: 720,
+        format: 'mp4',
+        codec: 'libx264',
+        fps: 30,
+        max_duration_s: 140,
+    },
+    instagram: {
+        name: 'instagram',
+        aspect_ratio: [9, 16],
+        width: 1080,
+        height: 1920,
+        format: 'mp4',
+        codec: 'libx264',
+        fps: 30,
+        max_duration_s: 90,
+    },
+    tiktok: {
+        name: 'tiktok',
+        aspect_ratio: [9, 16],
+        width: 1080,
+        height: 1920,
+        format: 'mp4',
+        codec: 'libx264',
+        fps: 30,
+    },
+    linkedin: {
+        name: 'linkedin',
+        aspect_ratio: [1, 1],
+        width: 1080,
+        height: 1080,
+        format: 'mp4',
+        codec: 'libx264',
+        fps: 30,
+    },
+    'github-gif': {
+        name: 'github-gif',
+        aspect_ratio: [16, 9],
+        width: 800,
+        height: 450,
+        format: 'gif',
+        codec: 'gif',
+        fps: 15,
+        max_duration_s: 12,
+        max_file_size_bytes: 8 * 1024 * 1024,
+    },
+};
+export function getPreset(name) {
+    const preset = presets[name];
+    if (!preset) {
+        throw new Error(`Unknown preset: ${name}. Available: ${Object.keys(presets).join(', ')}`);
+    }
+    return preset;
+}
+//# sourceMappingURL=presets.js.map

package/dist/src/export/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../src/export/presets.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAiC;IACnD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACrB,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,EAAE;KACR;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACrB,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,EAAE;QACP,cAAc,EAAE,GAAG;KACpB;IACD,SAAS,EAAE;QACT,IAAI,EAAE,WAAW;QACjB,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QACrB,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,EAAE;QACP,cAAc,EAAE,EAAE;KACnB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QACrB,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,EAAE;KACR;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACpB,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,EAAE;KACR;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACrB,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,KAAK;QACZ,GAAG,EAAE,EAAE;QACP,cAAc,EAAE,EAAE;QAClB,mBAAmB,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;KACrC;CACF,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,gBAAgB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/export/smart-crop.d.ts

@@ -0,0 +1,10 @@
+import type { RecordingEvent, Viewport, ExportPreset } from '../recording/types.js';
+export interface CropWindow {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export declare function computeSmartCrop(events: RecordingEvent[], sourceViewport: Viewport, preset: ExportPreset): CropWindow;
+export declare function buildCropFilter(crop: CropWindow, preset: ExportPreset): string;
+//# sourceMappingURL=smart-crop.d.ts.map

package/dist/src/export/smart-crop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-crop.d.ts","sourceRoot":"","sources":["../../../src/export/smart-crop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEpF,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,cAAc,EAAE,EACxB,cAAc,EAAE,QAAQ,EACxB,MAAM,EAAE,YAAY,GACnB,UAAU,CAqDZ;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAE9E"}

package/dist/src/export/smart-crop.js

@@ -0,0 +1,50 @@
+export function computeSmartCrop(events, sourceViewport, preset) {
+    const targetAspect = preset.aspect_ratio[0] / preset.aspect_ratio[1];
+    const sourceAspect = sourceViewport.width / sourceViewport.height;
+    // If same aspect ratio, no crop needed
+    if (Math.abs(targetAspect - sourceAspect) < 0.01) {
+        return { x: 0, y: 0, width: sourceViewport.width, height: sourceViewport.height };
+    }
+    // Calculate crop dimensions maintaining target aspect ratio
+    let cropW;
+    let cropH;
+    if (targetAspect < sourceAspect) {
+        // Target is taller (e.g. 9:16) — crop width
+        cropH = sourceViewport.height;
+        cropW = Math.round(cropH * targetAspect);
+    }
+    else {
+        // Target is wider — crop height
+        cropW = sourceViewport.width;
+        cropH = Math.round(cropW / targetAspect);
+    }
+    // Find average focus point from events with bounding boxes
+    const eventsWithBoxes = events.filter((e) => e.bounding_box);
+    let focusX = sourceViewport.width / 2;
+    let focusY = sourceViewport.height / 2;
+    if (eventsWithBoxes.length > 0) {
+        let totalWeight = 0;
+        let weightedX = 0;
+        let weightedY = 0;
+        for (let i = 0; i < eventsWithBoxes.length; i++) {
+            const box = eventsWithBoxes[i].bounding_box;
+            // Weight recent events more heavily
+            const weight = (i + 1) / eventsWithBoxes.length;
+            weightedX += (box.x + box.width / 2) * weight;
+            weightedY += (box.y + box.height / 2) * weight;
+            totalWeight += weight;
+        }
+        focusX = weightedX / totalWeight;
+        focusY = weightedY / totalWeight;
+    }
+    // Center crop on focus point, clamped to viewport
+    let cropX = Math.round(focusX - cropW / 2);
+    let cropY = Math.round(focusY - cropH / 2);
+    cropX = Math.max(0, Math.min(cropX, sourceViewport.width - cropW));
+    cropY = Math.max(0, Math.min(cropY, sourceViewport.height - cropH));
+    return { x: cropX, y: cropY, width: cropW, height: cropH };
+}
+export function buildCropFilter(crop, preset) {
+    return `crop=${crop.width}:${crop.height}:${crop.x}:${crop.y},scale=${preset.width}:${preset.height}`;
+}
+//# sourceMappingURL=smart-crop.js.map

package/dist/src/export/smart-crop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-crop.js","sourceRoot":"","sources":["../../../src/export/smart-crop.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -0,0 +1,10 @@
+export { runAgentLoop, type AgentLoopOptions, type AgentLoopResult } from './agent/loop.js';
+export { launchSession, type BrowserSession } from './browser/session.js';
+export { EventLog } from './recording/event-log.js';
+export { writeMetadata, readMetadata } from './recording/metadata.js';
+export { deriveChapters } from './recording/chapters.js';
+export { composeVideo, type ComposeOptions } from './video/compose.js';
+export { runExport, type ExportRunOptions } from './export/exporter.js';
+export { getPreset, presets } from './export/presets.js';
+export type { RecordingEvent, RecordingMetadata, ExportPreset, RecordOptions, ExportOptions, Viewport, BoundingBox, Chapter, AgentStats, } from './recording/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,QAAQ,EACR,WAAW,EACX,OAAO,EACP,UAAU,GACX,MAAM,sBAAsB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,9 @@
+export { runAgentLoop } from './agent/loop.js';
+export { launchSession } from './browser/session.js';
+export { EventLog } from './recording/event-log.js';
+export { writeMetadata, readMetadata } from './recording/metadata.js';
+export { deriveChapters } from './recording/chapters.js';
+export { composeVideo } from './video/compose.js';
+export { runExport } from './export/exporter.js';
+export { getPreset, presets } from './export/presets.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA+C,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAuB,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAuB,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAyB,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/recording/chapters.d.ts

@@ -0,0 +1,3 @@
+import type { RecordingEvent, Chapter } from './types.js';
+export declare function deriveChapters(events: RecordingEvent[]): Chapter[];
+//# sourceMappingURL=chapters.d.ts.map

package/dist/src/recording/chapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chapters.d.ts","sourceRoot":"","sources":["../../../src/recording/chapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1D,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,EAAE,CAyClE"}

package/dist/src/recording/chapters.js

@@ -0,0 +1,37 @@
+export function deriveChapters(events) {
+    if (events.length === 0)
+        return [];
+    const chapters = [];
+    const narrations = events.filter((e) => e.type === 'narrate');
+    if (narrations.length === 0) {
+        // No narrations — create one chapter per navigation event, or a single chapter
+        const navigations = events.filter((e) => e.type === 'navigate');
+        if (navigations.length <= 1) {
+            return [
+                {
+                    start_ms: 0,
+                    end_ms: events[events.length - 1].timestamp_ms,
+                    title: events[0]?.description ?? 'Recording',
+                },
+            ];
+        }
+        for (let i = 0; i < navigations.length; i++) {
+            const start = navigations[i].timestamp_ms;
+            const end = i < navigations.length - 1
+                ? navigations[i + 1].timestamp_ms
+                : events[events.length - 1].timestamp_ms;
+            chapters.push({ start_ms: start, end_ms: end, title: navigations[i].description });
+        }
+        return chapters;
+    }
+    // Use narration events as chapter boundaries
+    for (let i = 0; i < narrations.length; i++) {
+        const start = narrations[i].timestamp_ms;
+        const end = i < narrations.length - 1
+            ? narrations[i + 1].timestamp_ms
+            : events[events.length - 1].timestamp_ms;
+        chapters.push({ start_ms: start, end_ms: end, title: narrations[i].value ?? narrations[i].description });
+    }
+    return chapters;
+}
+//# sourceMappingURL=chapters.js.map

package/dist/src/recording/chapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chapters.js","sourceRoot":"","sources":["../../../src/recording/chapters.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,MAAwB;IACrD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAE9D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,+EAA+E;QAC/E,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QAChE,IAAI,WAAW,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC5B,OAAO;gBACL;oBACE,QAAQ,EAAE,CAAC;oBACX,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,YAAY;oBAC/C,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,IAAI,WAAW;iBAC7C;aACF,CAAC;QACJ,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAE,CAAC,YAAY,CAAC;YAC3C,MAAM,GAAG,GACP,CAAC,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC;gBACxB,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,YAAY;gBAClC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,YAAY,CAAC;YAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,6CAA6C;IAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC,YAAY,CAAC;QAC1C,MAAM,GAAG,GACP,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC;YACvB,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,YAAY;YACjC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,YAAY,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAE,CAAC,KAAK,IAAI,UAAU,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7G,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/recording/event-log.d.ts

@@ -0,0 +1,20 @@
+import type { RecordingEvent, EventType, BoundingBox, Viewport } from './types.js';
+export declare class EventLog {
+    private filePath;
+    private events;
+    private startTime;
+    private nextId;
+    constructor(filePath: string);
+    append(params: {
+        type: EventType;
+        description: string;
+        bounding_box?: BoundingBox;
+        viewport: Viewport;
+        value?: string;
+        url?: string;
+    }): RecordingEvent;
+    getEvents(): RecordingEvent[];
+    getDurationMs(): number;
+    flush(): void;
+}
+//# sourceMappingURL=event-log.d.ts.map

package/dist/src/recording/event-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-log.d.ts","sourceRoot":"","sources":["../../../src/recording/event-log.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEnF,qBAAa,QAAQ;IAKP,OAAO,CAAC,QAAQ;IAJ5B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAK;gBAEC,QAAQ,EAAE,MAAM;IAIpC,MAAM,CAAC,MAAM,EAAE;QACb,IAAI,EAAE,SAAS,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,WAAW,CAAC;QAC3B,QAAQ,EAAE,QAAQ,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,GAAG,cAAc;IAelB,SAAS,IAAI,cAAc,EAAE;IAI7B,aAAa,IAAI,MAAM;IAKvB,KAAK,IAAI,IAAI;CAGd"}

package/dist/src/recording/event-log.js

@@ -0,0 +1,37 @@
+import { writeFileSync } from 'node:fs';
+export class EventLog {
+    filePath;
+    events = [];
+    startTime;
+    nextId = 1;
+    constructor(filePath) {
+        this.filePath = filePath;
+        this.startTime = Date.now();
+    }
+    append(params) {
+        const event = {
+            id: this.nextId++,
+            timestamp_ms: Date.now() - this.startTime,
+            type: params.type,
+            description: params.description,
+            viewport: params.viewport,
+            bounding_box: params.bounding_box,
+            value: params.value,
+            url: params.url,
+        };
+        this.events.push(event);
+        return event;
+    }
+    getEvents() {
+        return [...this.events];
+    }
+    getDurationMs() {
+        if (this.events.length === 0)
+            return 0;
+        return this.events[this.events.length - 1].timestamp_ms;
+    }
+    flush() {
+        writeFileSync(this.filePath, JSON.stringify(this.events, null, 2));
+    }
+}
+//# sourceMappingURL=event-log.js.map

package/dist/src/recording/event-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-log.js","sourceRoot":"","sources":["../../../src/recording/event-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,MAAM,OAAO,QAAQ;IAKC;IAJZ,MAAM,GAAqB,EAAE,CAAC;IAC9B,SAAS,CAAS;IAClB,MAAM,GAAG,CAAC,CAAC;IAEnB,YAAoB,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;QAClC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,MAON;QACC,MAAM,KAAK,GAAmB;YAC5B,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE;YACjB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;YACzC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,GAAG,EAAE,MAAM,CAAC,GAAG;SAChB,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,aAAa;QACX,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,YAAY,CAAC;IAC3D,CAAC;IAED,KAAK;QACH,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;CACF"}

package/dist/src/recording/metadata.d.ts

@@ -0,0 +1,4 @@
+import type { RecordingMetadata } from './types.js';
+export declare function writeMetadata(path: string, metadata: RecordingMetadata): void;
+export declare function readMetadata(path: string): RecordingMetadata;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/src/recording/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/recording/metadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAE7E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAE5D"}

package/dist/src/recording/metadata.js

@@ -0,0 +1,8 @@
+import { writeFileSync, readFileSync } from 'node:fs';
+export function writeMetadata(path, metadata) {
+    writeFileSync(path, JSON.stringify(metadata, null, 2));
+}
+export function readMetadata(path) {
+    return JSON.parse(readFileSync(path, 'utf-8'));
+}
+//# sourceMappingURL=metadata.js.map

package/dist/src/recording/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/recording/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGtD,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,QAA2B;IACrE,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/src/recording/types.d.ts

@@ -0,0 +1,81 @@
+export interface BoundingBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface Viewport {
+    width: number;
+    height: number;
+}
+export type EventType = 'click' | 'type' | 'scroll' | 'hover' | 'navigate' | 'wait' | 'press_key' | 'select_option' | 'narrate' | 'done';
+export interface RecordingEvent {
+    id: number;
+    timestamp_ms: number;
+    type: EventType;
+    bounding_box?: BoundingBox;
+    viewport: Viewport;
+    description: string;
+    value?: string;
+    url?: string;
+}
+export interface Chapter {
+    start_ms: number;
+    end_ms: number;
+    title: string;
+}
+export interface AgentStats {
+    total_actions: number;
+    input_tokens: number;
+    output_tokens: number;
+}
+export interface RecordingMetadata {
+    id: string;
+    created_at: string;
+    url: string;
+    prompt: string;
+    model: string;
+    viewport: Viewport;
+    duration_ms: number;
+    raw_video_path: string;
+    event_log_path: string;
+    chapters: Chapter[];
+    agent_stats: AgentStats;
+}
+export interface ExportPreset {
+    name: string;
+    aspect_ratio: [number, number];
+    width: number;
+    height: number;
+    format: 'mp4' | 'webm' | 'gif';
+    codec: string;
+    fps: number;
+    max_duration_s?: number;
+    max_file_size_bytes?: number;
+}
+export interface RecordOptions {
+    url: string;
+    prompt: string;
+    output: string;
+    viewport: Viewport;
+    model: string;
+    headless: boolean;
+    slowMo: number;
+    maxSteps: number;
+}
+export interface BackgroundConfig {
+    gradient: string;
+    padding: number;
+    cornerRadius: number;
+    shadow: boolean;
+}
+export interface ExportOptions {
+    recordingDir: string;
+    preset: string;
+    zoom: boolean;
+    highlight: boolean;
+    cursor: boolean;
+    output?: string;
+    background?: BackgroundConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/recording/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/recording/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,MAAM,GACN,QAAQ,GACR,OAAO,GACP,UAAU,GACV,MAAM,GACN,WAAW,GACX,eAAe,GACf,SAAS,GACT,MAAM,CAAC;AAEX,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B"}

package/dist/src/recording/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/recording/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/recording/types.ts"],"names":[],"mappings":""}

package/dist/src/utils/config.d.ts

@@ -0,0 +1,13 @@
+export interface AppConfig {
+    anthropicApiKey: string;
+    defaultModel: string;
+    defaultViewport: {
+        width: number;
+        height: number;
+    };
+    actionDelayMs: number;
+}
+/** Returns true when a valid API key is available. */
+export declare function isConfigured(): boolean;
+export declare function loadConfig(): AppConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/utils/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,aAAa,EAAE,MAAM,CAAC;CACvB;AAcD,sDAAsD;AACtD,wBAAgB,YAAY,IAAI,OAAO,CAItC;AAED,wBAAgB,UAAU,IAAI,SAAS,CAetC"}

package/dist/src/utils/config.js

@@ -0,0 +1,37 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { ConfigError } from './errors.js';
+const CONFIG_DIR = join(homedir(), '.screencli');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+function loadFileConfig() {
+    if (!existsSync(CONFIG_FILE))
+        return {};
+    try {
+        return JSON.parse(readFileSync(CONFIG_FILE, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+/** Returns true when a valid API key is available. */
+export function isConfigured() {
+    if (process.env['ANTHROPIC_API_KEY'])
+        return true;
+    const file = loadFileConfig();
+    return !!file.anthropicApiKey;
+}
+export function loadConfig() {
+    const file = loadFileConfig();
+    const apiKey = process.env['ANTHROPIC_API_KEY'] ?? file.anthropicApiKey;
+    if (!apiKey) {
+        throw new ConfigError('Missing ANTHROPIC_API_KEY. Run `screencli init` to configure, or set it as an environment variable.');
+    }
+    return {
+        anthropicApiKey: apiKey,
+        defaultModel: file.defaultModel ?? 'claude-sonnet-4-20250514',
+        defaultViewport: file.defaultViewport ?? { width: 1920, height: 1080 },
+        actionDelayMs: file.actionDelayMs ?? 400,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/src/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAS1C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AACjD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEpD,SAAS,cAAc;IACrB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,YAAY;IAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,OAAO,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC;IACxE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,WAAW,CACnB,qGAAqG,CACtG,CAAC;IACJ,CAAC;IAED,OAAO;QACL,eAAe,EAAE,MAAM;QACvB,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,0BAA0B;QAC7D,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;QACtE,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,GAAG;KACzC,CAAC;AACJ,CAAC"}

package/dist/src/utils/errors.d.ts

@@ -0,0 +1,20 @@
+export declare class ScreencliError extends Error {
+    code: string;
+    constructor(message: string, code: string);
+}
+export declare class BrowserError extends ScreencliError {
+    constructor(message: string);
+}
+export declare class AgentError extends ScreencliError {
+    constructor(message: string);
+}
+export declare class FFmpegError extends ScreencliError {
+    constructor(message: string);
+}
+export declare class ExportError extends ScreencliError {
+    constructor(message: string);
+}
+export declare class ConfigError extends ScreencliError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map