autokap 1.0.2 → 1.0.4

package/dist/video-agent.d.ts

@@ -1,143 +0,0 @@
-import { Browser } from './browser.js';
-import type { VideoAgentConfig, VideoAgentResult, VideoPhase, InteractiveElement, VideoStep, VideoPlan, StepUsage, VideoStepAttemptTrace, VideoStepArtifact, VideoSelectorMemoryUpdate, VideoPageSignals, VideoObservationSnapshot, BrowserSessionStorageState, BrowserStorageState } from './types.js';
-export type VideoLogCallback = (entry: {
-    level: 'info' | 'success' | 'error' | 'ai';
-    message: string;
-    timestamp: number;
-}) => void;
-export type VideoPhaseCallback = (phase: VideoPhase) => void;
-export type VideoStepCallback = (stepIndex: number, total: number, description: string, phase: 'dry_run' | 'recording') => void;
-export type VideoStepResultCallback = (stepIndex: number, ok: boolean, reason?: string) => void;
-export type VideoVariantPhase = 'preflight' | 'planning' | 'dry_run' | 'recording' | 'done' | 'failed';
-export interface VideoPreflightResult {
-    ok: boolean;
-    reason?: string;
-    code?: string;
-    detectedLang?: string | null;
-    detectedTheme?: 'light' | 'dark' | null;
-    finalUrl?: string;
-    storageState?: BrowserStorageState;
-    sessionStorage?: BrowserSessionStorageState;
-    pageSignals?: VideoPageSignals;
-    observationSummary?: string;
-    observationSnapshot?: VideoObservationSnapshot;
-    usage?: StepUsage[];
-}
-export type VideoPreflightCallback = (result: VideoPreflightResult) => void;
-export type VideoVariantPhaseCallback = (phase: VideoVariantPhase) => void;
-export type VideoStepAttemptCallback = (attempt: VideoStepAttemptTrace) => void;
-export type VideoStepArtifactCallback = (artifact: VideoStepArtifact) => void;
-export interface VideoRunCallbacks {
-    onLog?: VideoLogCallback;
-    onPhaseChange?: VideoPhaseCallback;
-    onVariantPhase?: VideoVariantPhaseCallback;
-    onStep?: VideoStepCallback;
-    onStepResult?: VideoStepResultCallback;
-    onStepAttempt?: VideoStepAttemptCallback;
-    onStepArtifact?: VideoStepArtifactCallback;
-    onPreflightResult?: VideoPreflightCallback;
-    /** Emit a live Playwright screenshot (base64 JPEG) for real-time preview in the UI. */
-    onScreenshot?: (base64: string) => void;
-}
-type VideoDryRunFailureSubphase = 'prepared_variant' | 'deterministic_exec' | 'verification_snapshot' | 'verification_llm' | 'repair_lane' | 'llm_fixer' | 'checkpoint_restore' | 'budget';
-export interface VideoDryRunFailure {
-    stepIndex: number;
-    subphase: VideoDryRunFailureSubphase;
-    reason: string;
-    resolvedTargetSummary?: string;
-}
-interface VideoStepCheckpoint {
-    url: string;
-    scrollX: number;
-    scrollY: number;
-}
-interface ViewportRectSnapshot {
-    top: number;
-    bottom: number;
-    left: number;
-    right: number;
-    width: number;
-    height: number;
-}
-export declare function restoreVideoStepCheckpoint(browser: Browser, checkpoint: VideoStepCheckpoint): Promise<void>;
-export declare function isRectMeaningfullyVisibleInViewport(params: {
-    rect: ViewportRectSnapshot;
-    viewportWidth: number;
-    viewportHeight: number;
-    topInset?: number;
-    bottomInset?: number;
-}): boolean;
-export declare function sanitizeVariantPrefixSteps(steps: VideoStep[], requestedLang?: string, requestedTheme?: 'light' | 'dark'): VideoStep[];
-export declare function evaluateVideoStepSafety(step: VideoStep, config: VideoAgentConfig, page: import('playwright').Page, currentUrl: string, interactiveElements: InteractiveElement[]): Promise<{
-    allowed: boolean;
-    reason?: string;
-}>;
-export declare function extractNamedScrollTarget(description?: string): string | null;
-export declare function inspectVideoTarget(page: import('playwright').Page, selector?: string, coordinates?: {
-    x: number;
-    y: number;
-}): Promise<InteractiveElement | null>;
-interface VerifyStepResult {
-    ok: boolean;
-    reason?: string;
-    suggestion?: string;
-    giveUp?: boolean;
-    usage: Partial<StepUsage>;
-}
-export declare function verifyVideoStepDeterministically(browser: Browser, step: VideoStep): Promise<VerifyStepResult | null>;
-export declare function runVariantPreflight(config: VideoAgentConfig, prefixPlan: VideoPlan | null, callbacks?: VideoRunCallbacks): Promise<VideoPreflightResult>;
-export declare function composeHybridPlan(basePlan: VideoPlan, variantPrefixPlan: VideoPlan | null): VideoPlan;
-export declare function createBasePlan(config: VideoAgentConfig): Promise<{
-    plan: VideoPlan;
-    usage: StepUsage;
-}>;
-export declare function createVariantPrefixPlan(config: VideoAgentConfig): Promise<{
-    plan: VideoPlan;
-    usage: StepUsage;
-}>;
-export declare function verifyAndPatchPlan(plan: VideoPlan, config: VideoAgentConfig, callbacks?: VideoRunCallbacks): Promise<{
-    success: true;
-    plan: VideoPlan;
-    usage: StepUsage[];
-    memoryUpdates: VideoSelectorMemoryUpdate[];
-} | {
-    success: false;
-    error: string;
-    usage: StepUsage[];
-    memoryUpdates: VideoSelectorMemoryUpdate[];
-    failedStepIndex?: number;
-    failedSubphase?: VideoDryRunFailureSubphase;
-}>;
-/**
- * Backward-compatible helper: full planning + verify in one call.
- */
-export declare function planAndVerify(config: VideoAgentConfig, callbacks?: VideoRunCallbacks): Promise<{
-    success: true;
-    plan: VideoPlan;
-    usage: StepUsage[];
-    memoryUpdates: VideoSelectorMemoryUpdate[];
-} | {
-    success: false;
-    error: string;
-    usage: StepUsage[];
-    memoryUpdates: VideoSelectorMemoryUpdate[];
-}>;
-/**
- * Run phase 3 (recording only) using a pre-verified plan.
- * Call after `planAndVerify()` to record across multiple lang/theme combinations.
- */
-export declare function recordPlan(plan: VideoPlan, config: VideoAgentConfig, callbacks?: VideoRunCallbacks): Promise<{
-    videoPath: string | null;
-    durationMs: number;
-    stepsExecuted: number;
-    setupDurationSec: number;
-    usage: StepUsage[];
-}>;
-/**
- * Run the full 3-phase video capture pipeline:
- * 1. Planning: script → structured plan (LLM)
- * 2. Dry-run: verify all steps work
- * 3. Recording: execute with Bezier mouse + cursor overlay
- */
-export declare function runVideoAgent(config: VideoAgentConfig, callbacks?: VideoRunCallbacks): Promise<VideoAgentResult>;
-export {};