leapfrog-mcp 0.6.2 → 0.6.3

package/dist/recording.d.ts

@@ -0,0 +1,72 @@
+import type { Session } from "./types.js";
+import type { Page } from "playwright-core";
+export interface RecordingParam {
+    default: string;
+    description?: string;
+    sensitive?: boolean;
+}
+export interface RecordingStep {
+    tool: string;
+    args: Record<string, unknown>;
+}
+export interface Recording {
+    version: 1;
+    name: string;
+    createdAt: number;
+    sourceUrl: string;
+    params: Record<string, RecordingParam>;
+    steps: RecordingStep[];
+}
+export interface ReplayStepResult {
+    step: number;
+    tool: string;
+    status: "ok" | "error";
+    error?: string;
+    duration: number;
+}
+export interface ReplayResult {
+    status: "ok" | "error";
+    stepsCompleted: number;
+    stepsTotal: number;
+    totalDuration: number;
+    results: ReplayStepResult[];
+}
+export interface ExportOptions {
+    name?: string;
+    /** When true, keep extract steps in the recording */
+    keepExtracts?: boolean;
+    /** Output format: json (default) or playwright */
+    format?: "json" | "playwright";
+}
+export interface ReplayOptions {
+    onError?: "stop" | "skip";
+}
+/**
+ * Export session action history as a replayable Recording.
+ *
+ * 1. Gets action history from HarnessIntelligence
+ * 2. Filters to mutating actions only
+ * 3. Resolves @eN refs to stable selectors via session.refMap
+ * 4. Auto-detects parameters for emails, URLs, passwords
+ * 5. Returns Recording JSON
+ */
+export declare function exportSession(sessionId: string, session: Session, options?: ExportOptions): Recording | string;
+/**
+ * Convert a Recording to a Playwright-compatible JS function body.
+ * Output is suitable for the `execute` tool.
+ */
+export declare function toPlaywrightScript(recording: Recording): string;
+/**
+ * Replay a Recording against a live browser session.
+ *
+ * Each step is dispatched directly to Playwright page methods — no MCP
+ * round-trip. The overall replay is recorded as a single summary entry
+ * in harness intelligence (individual steps are NOT recorded).
+ */
+export declare function replayRecording(recording: Recording, session: Session, page: Page, params?: Record<string, string>, options?: ReplayOptions): Promise<ReplayResult>;
+declare const _default: {
+    exportSession: typeof exportSession;
+    replayRecording: typeof replayRecording;
+    toPlaywrightScript: typeof toPlaywrightScript;
+};
+export default _default;