autokap 1.1.8 → 1.3.1

package/dist/program-signing.d.ts

@@ -32,6 +32,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
         presetId: z.ZodString;
         programVersion: z.ZodNumber;
         mediaMode: z.ZodEnum<{
+            video: "video";
             clip: "clip";
             screenshot: "screenshot";
         }>;
@@ -170,6 +171,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"NAVIGATE">;
         }, z.core.$strict>, z.ZodObject<{
             description: z.ZodString;
@@ -199,6 +201,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"DISMISS_OVERLAYS">;
         }, z.core.$strict>, z.ZodObject<{
             urlPattern: z.ZodString;
@@ -229,6 +232,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"ASSERT_ROUTE">;
         }, z.core.$strict>, z.ZodObject<{
             selectors: z.ZodArray<z.ZodString>;
@@ -260,6 +264,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"ASSERT_SURFACE">;
         }, z.core.$strict>, z.ZodObject<{
             selector: z.ZodString;
@@ -304,6 +309,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"CLICK">;
         }, z.core.$strict>, z.ZodObject<{
             selector: z.ZodString;
@@ -347,6 +353,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"TYPE">;
         }, z.core.$strict>, z.ZodObject<{
             key: z.ZodString;
@@ -377,6 +384,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"PRESS_KEY">;
         }, z.core.$strict>, z.ZodObject<{
             selector: z.ZodOptional<z.ZodString>;
@@ -419,7 +427,41 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"WAIT_FOR">;
+        }, z.core.$strict>, z.ZodObject<{
+            durationMs: z.ZodNumber;
+            narrationText: z.ZodOptional<z.ZodString>;
+            narrationTextByLocale: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            description: z.ZodString;
+            postcondition: z.ZodObject<{
+                type: z.ZodEnum<{
+                    route_matches: "route_matches";
+                    element_visible: "element_visible";
+                    element_absent: "element_absent";
+                    text_contains: "text_contains";
+                    overlay_dismissed: "overlay_dismissed";
+                    screenshot_stable: "screenshot_stable";
+                    any_change: "any_change";
+                    always: "always";
+                }>;
+                pattern: z.ZodOptional<z.ZodString>;
+                selector: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+                threshold: z.ZodOptional<z.ZodNumber>;
+                waitMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>;
+            recovery: z.ZodObject<{
+                retries: z.ZodNumber;
+                useSelectorMemory: z.ZodBoolean;
+                useAltInteraction: z.ZodBoolean;
+                allowReload: z.ZodBoolean;
+                allowHealer: z.ZodBoolean;
+            }, z.core.$strict>;
+            timeoutMs: z.ZodNumber;
+            maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
+            kind: z.ZodLiteral<"SLEEP">;
         }, z.core.$strict>, z.ZodObject<{
             locale: z.ZodString;
             method: z.ZodEnum<{
@@ -464,6 +506,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"SET_LOCALE">;
         }, z.core.$strict>, z.ZodObject<{
             theme: z.ZodEnum<{
@@ -513,6 +556,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"SET_THEME">;
         }, z.core.$strict>, z.ZodObject<{
             direction: z.ZodEnum<{
@@ -558,6 +602,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"SCROLL">;
         }, z.core.$strict>, z.ZodObject<{
             captureId: z.ZodOptional<z.ZodString>;
@@ -590,6 +635,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"CAPTURE_SCREENSHOT">;
         }, z.core.$strict>, z.ZodObject<{
             clipId: z.ZodOptional<z.ZodString>;
@@ -621,6 +667,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"BEGIN_CLIP">;
         }, z.core.$strict>, z.ZodObject<{
             clipId: z.ZodOptional<z.ZodString>;
@@ -652,6 +699,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"END_CLIP">;
         }, z.core.$strict>, z.ZodObject<{
             selector: z.ZodString;
@@ -692,6 +740,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"HOVER">;
         }, z.core.$strict>, z.ZodObject<{
             selector: z.ZodString;
@@ -735,6 +784,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"SELECT_OPTION">;
         }, z.core.$strict>, z.ZodObject<{
             selector: z.ZodString;
@@ -776,6 +826,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"CHECK">;
         }, z.core.$strict>, z.ZodObject<{
             selector: z.ZodString;
@@ -816,6 +867,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"DOUBLE_CLICK">;
         }, z.core.$strict>, z.ZodObject<{
             selector: z.ZodString;
@@ -870,6 +922,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"DRAG">;
         }, z.core.$strict>, z.ZodObject<{
             sourceSelector: z.ZodString;
@@ -903,6 +956,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"CLONE_ELEMENT">;
         }, z.core.$strict>, z.ZodObject<{
             groupName: z.ZodString;
@@ -944,6 +998,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"INJECT_MOCK_DATA">;
         }, z.core.$strict>, z.ZodObject<{
             selector: z.ZodString;
@@ -974,6 +1029,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"REMOVE_ELEMENT">;
         }, z.core.$strict>, z.ZodObject<{
             selector: z.ZodString;
@@ -1006,10 +1062,12 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
             }, z.core.$strict>;
             timeoutMs: z.ZodNumber;
             maxFailures: z.ZodNumber;
+            stepId: z.ZodOptional<z.ZodString>;
             kind: z.ZodLiteral<"SET_ATTRIBUTE">;
         }, z.core.$strict>], "kind">>;
         artifactPlan: z.ZodObject<{
             mediaMode: z.ZodEnum<{
+                video: "video";
                 clip: "clip";
                 screenshot: "screenshot";
             }>;
@@ -1023,6 +1081,15 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
                     png: "png";
                     jpeg: "jpeg";
                 }>>;
+                captureResolution: z.ZodOptional<z.ZodObject<{
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strict>>;
+                captureFps: z.ZodOptional<z.ZodNumber>;
+                deliveryResolution: z.ZodOptional<z.ZodObject<{
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strict>>;
             }, z.core.$strict>>;
             cursorTheme: z.ZodOptional<z.ZodEnum<{
                 minimal: "minimal";

package/dist/recovery-chain.js

@@ -35,7 +35,7 @@ export class RecoveryChainImpl {
         const retryBudget = Math.max(0, Math.min(recovery.retries, options.maxDeterministicRetries ?? recovery.retries));
         if (retryBudget > 0) {
             logger.debug(`[recovery ${opcodeIndex}] strategy 1 (retry x${retryBudget})`);
-            const result = await retryOpcode(failedOpcode, adapter, retryBudget, options.remainingTimeMs, options.currentVariant, this.credentials);
+            const result = await retryOpcode(failedOpcode, adapter, retryBudget, options.remainingTimeMs, options.currentVariant, this.credentials, options.suppressPageReloads);
             logger.debug(`[recovery ${opcodeIndex}] strategy 1 → recovered=${result.recovered}, reason=${result.reason}`);
             if (result.recovered)
                 return result;
@@ -57,7 +57,12 @@ export class RecoveryChainImpl {
                 return result;
         }
         // Strategy 4: Targeted reload
-        if (recovery.allowReload) {
+        let skippedReloadReason;
+        if (recovery.allowReload && options.allowPageReload === false) {
+            skippedReloadReason = 'reload recovery skipped because page reloads are disabled during active recording';
+            logger.debug(`[recovery ${opcodeIndex}] strategy 4 skipped (${skippedReloadReason})`);
+        }
+        else if (recovery.allowReload) {
             logger.debug(`[recovery ${opcodeIndex}] strategy 4 (reload)`);
             const result = await tryReload(failedOpcode, adapter, options.currentVariant, this.credentials);
             logger.debug(`[recovery ${opcodeIndex}] strategy 4 → recovered=${result.recovered}, reason=${result.reason}`);
@@ -67,16 +72,21 @@ export class RecoveryChainImpl {
         // Strategy 5: LLM Healer
         if (recovery.allowHealer && this.healer && this.healer.remainingInvocations > 0) {
             logger.debug(`[recovery ${opcodeIndex}] strategy 5 (LLM healer)`);
-            const result = await tryHealer(failedOpcode, opcodeIndex, adapter, this.healer, this.programSteps, options.currentVariant, this.credentials);
+            const result = await tryHealer(failedOpcode, opcodeIndex, adapter, this.healer, this.programSteps, options.currentVariant, this.credentials, options.suppressPageReloads);
             logger.debug(`[recovery ${opcodeIndex}] strategy 5 → recovered=${result.recovered}, reason=${result.reason}`);
             return result;
         }
         logger.debug(`[recovery ${opcodeIndex}] all strategies exhausted`);
-        return { recovered: false, reason: 'all recovery strategies exhausted' };
+        return {
+            recovered: false,
+            reason: skippedReloadReason
+                ? `${skippedReloadReason}; all recovery strategies exhausted`
+                : 'all recovery strategies exhausted',
+        };
     }
 }
 // ── Strategy 1: Deterministic retry ─────────────────────────────────
-async function retryOpcode(opcode, adapter, maxRetries, remainingTimeMs, currentVariant, credentials) {
+async function retryOpcode(opcode, adapter, maxRetries, remainingTimeMs, currentVariant, credentials, suppressPageReloads = false) {
     const deadlineMs = typeof remainingTimeMs === 'number'
         ? Date.now() + remainingTimeMs
         : Number.POSITIVE_INFINITY;
@@ -86,7 +96,7 @@ async function retryOpcode(opcode, adapter, maxRetries, remainingTimeMs, current
         }
         await sleep(500 * (i + 1)); // backoff
         try {
-            await executeRawAction(opcode, adapter, currentVariant, credentials);
+            await executeRawAction(opcode, adapter, currentVariant, credentials, suppressPageReloads);
             const postcondition = await evaluatePostcondition(adapter, clampPostconditionWait(opcode.postcondition, deadlineMs));
             if (postcondition.passed) {
                 return { recovered: true, strategy: 'retry', reason: `retry ${i + 1}/${maxRetries} succeeded` };
@@ -210,7 +220,7 @@ async function tryReload(opcode, adapter, currentVariant, credentials) {
     return { recovered: false, reason: 'reload + retry failed' };
 }
 // ── Strategy 5: LLM Healer ─────────────────────────────────────────
-async function tryHealer(failedOpcode, opcodeIndex, adapter, healer, programSteps, currentVariant, credentials) {
+async function tryHealer(failedOpcode, opcodeIndex, adapter, healer, programSteps, currentVariant, credentials, suppressPageReloads = false) {
     try {
         const tree = await adapter.getAKTree();
         const akTreeSerialized = serializeAKTree(tree);
@@ -239,7 +249,7 @@ async function tryHealer(failedOpcode, opcodeIndex, adapter, healer, programStep
             // intermediate postcondition after each step.
             for (const replacementOp of result.patch.replacementOpcodes) {
                 try {
-                    await executeHealerPatchedAction(replacementOp, adapter, result.patch.interactionMode, currentVariant, credentials);
+                    await executeHealerPatchedAction(replacementOp, adapter, result.patch.interactionMode, currentVariant, credentials, suppressPageReloads);
                 }
                 catch (err) {
                     return {
@@ -278,13 +288,17 @@ async function tryHealer(failedOpcode, opcodeIndex, adapter, healer, programStep
 function hasSelector(opcode) {
     return 'selector' in opcode && typeof opcode.selector === 'string' && !!opcode.selector;
 }
-async function executeRawAction(opcode, adapter, currentVariant, credentials) {
-    const result = await executeOpcodeCoreAction(opcode, adapter, { currentVariant, credentials });
+async function executeRawAction(opcode, adapter, currentVariant, credentials, suppressPageReloads = false) {
+    const result = await executeOpcodeCoreAction(opcode, adapter, {
+        currentVariant,
+        credentials,
+        suppressPageReloads,
+    });
     if (!result.success) {
         throw new Error(result.error ?? `opcode ${opcode.kind} could not be replayed`);
     }
 }
-async function executeHealerPatchedAction(opcode, adapter, interactionMode, currentVariant, credentials) {
+async function executeHealerPatchedAction(opcode, adapter, interactionMode, currentVariant, credentials, suppressPageReloads = false) {
     if (opcode.kind === 'CLICK' && interactionMode && interactionMode !== 'default') {
         const options = interactionMode === 'keyboard'
             ? { useKeyboard: true }
@@ -296,7 +310,7 @@ async function executeHealerPatchedAction(opcode, adapter, interactionMode, curr
         await adapter.click(opcode.selector, options);
         return;
     }
-    await executeRawAction(opcode, adapter, currentVariant, credentials);
+    await executeRawAction(opcode, adapter, currentVariant, credentials, suppressPageReloads);
 }
 async function executeWithSelector(opcode, adapter, newSelector, credentials) {
     switch (opcode.kind) {

package/dist/server-credit-usage.d.ts

@@ -1,5 +1,5 @@
 import type { SupabaseClient } from '@supabase/supabase-js';
-export type CreditUsageType = 'screenshot' | 'clip' | 'preset_analysis' | 'ai_chat' | 'studio_creation' | 'studio_iteration';
+export type CreditUsageType = 'screenshot' | 'clip' | 'video' | 'preset_analysis' | 'ai_chat' | 'studio_creation' | 'studio_iteration';
 export declare function recordCreditUsage(supabase: SupabaseClient, params: {
     userId: string;
     projectId: string | null;