@blazediff/agent 0.0.1 → 0.1.0

package/dist/index.d.mts

@@ -127,6 +127,7 @@ interface RunCapturesOptions {
     mode?: "baseline" | "actual";
     writeManifest?: boolean;
     cwd?: string;
+    concurrency?: number;
 }
 interface CaptureRouteResult {
     id: string;
@@ -146,6 +147,37 @@ interface RunCapturesReport {
 }
 declare function runCaptures(opts: RunCapturesOptions): Promise<RunCapturesReport>;
 
+declare function loadConfig(cwd?: string): Promise<AgentConfig | null>;
+declare function saveConfig(config: AgentConfig, cwd?: string): Promise<void>;
+declare function configHash(config: AgentConfig): string;
+declare function resolveBaseUrl(config: AgentConfig | null, override?: string): string;
+
+interface DiffOptions {
+    threshold?: number;
+    antialiasing?: boolean;
+    emitDiffPng?: boolean;
+}
+interface DiffOutcome {
+    id: string;
+    baselinePath: string;
+    actualPath: string;
+    diffPath?: string;
+    match: boolean;
+    reason?: "pixel-diff" | "layout-diff" | "file-not-exists";
+    diffCount?: number;
+    diffPercentage?: number;
+    interpretation?: InterpretResult;
+}
+declare function diffEntry(id: string, baselinePath: string, actualPath: string, opts?: DiffOptions, cwd?: string): Promise<DiffOutcome>;
+
+interface DiscoverOptions {
+    baseUrl: string;
+    cwd?: string;
+    maxRoutes?: number;
+    skipCrawl?: boolean;
+}
+declare function discover(opts: DiscoverOptions): Promise<DiscoveredRoute[]>;
+
 interface JudgeInput {
     entry: ManifestEntry;
     baselinePath: string;
@@ -178,7 +210,12 @@ interface ApplyJudgmentsResult {
     missing: string[];
     invalid: string[];
 }
-declare function applyJudgments(cwd?: string): Promise<ApplyJudgmentsResult>;
+interface ApplyJudgmentsOptions {
+    cwd?: string;
+    onEvent?: (event: RunEvent) => void;
+    junitPath?: string;
+}
+declare function applyJudgments(opts?: ApplyJudgmentsOptions | string): Promise<ApplyJudgmentsResult>;
 
 interface JudgmentRequest {
     id: string;
@@ -209,58 +246,50 @@ interface JudgmentRequest {
 
 declare function resolveJudge(backend: JudgeBackend): Judge;
 
-interface CheckOptions {
-    baseUrl: string;
-    cwd?: string;
-    threshold?: number;
-    concurrency?: number;
-    emitDiffPng?: boolean;
-    junitPath?: string;
-    judge?: JudgeBackend;
-}
-declare function runCheck(opts: CheckOptions): Promise<CheckReport>;
-
-declare function loadConfig(cwd?: string): Promise<AgentConfig | null>;
-declare function saveConfig(config: AgentConfig, cwd?: string): Promise<void>;
-declare function configHash(config: AgentConfig): string;
-declare function resolveBaseUrl(config: AgentConfig | null, override?: string): string;
-
-interface DiffOptions {
-    threshold?: number;
-    antialiasing?: boolean;
-    emitDiffPng?: boolean;
-}
-interface DiffOutcome {
-    id: string;
-    baselinePath: string;
-    actualPath: string;
-    diffPath?: string;
-    match: boolean;
-    reason?: "pixel-diff" | "layout-diff" | "file-not-exists";
-    diffCount?: number;
-    diffPercentage?: number;
-    interpretation?: InterpretResult;
-}
-declare function diffEntry(id: string, baselinePath: string, actualPath: string, opts?: DiffOptions, cwd?: string): Promise<DiffOutcome>;
-
-interface DiscoverOptions {
-    baseUrl: string;
-    cwd?: string;
-    maxRoutes?: number;
-    skipCrawl?: boolean;
+interface JudgmentInterrupt {
+    kind: "host-judgment-required";
+    entryId: string;
+    url: string;
+    requestPath: string;
+    signature: string;
+    pendingResult: CheckResult;
 }
-declare function discover(opts: DiscoverOptions): Promise<DiscoveredRoute[]>;
 
+type ResumeMap = Record<string, Verdict>;
+type RunEvent = {
+    type: "result";
+    result: CheckResult;
+} | {
+    type: "interrupt";
+    interrupt: JudgmentInterrupt;
+} | {
+    type: "report";
+    report: CheckReport;
+};
 interface RunOptions {
-    baseUrl: string;
+    baseUrl?: string;
     cwd?: string;
     threshold?: number;
     concurrency?: number;
     emitDiffPng?: boolean;
     junitPath?: string;
     judge?: JudgeBackend;
+    threadId?: string;
+    onEvent?: (event: RunEvent) => void;
+    resume?: ResumeMap;
 }
+type CheckOptions = RunOptions;
+declare function threadIdFor(cwd: string): string;
 declare function runGraph(opts: RunOptions): Promise<CheckReport>;
+interface ResumeOptions {
+    cwd?: string;
+    verdicts: ResumeMap;
+    threadId?: string;
+    onEvent?: (event: RunEvent) => void;
+    junitPath?: string;
+}
+declare function resumeGraph(opts: ResumeOptions): Promise<CheckReport>;
+declare function runCheck(opts: CheckOptions): Promise<CheckReport>;
 
 declare function loadManifest(cwd?: string): Promise<Manifest | null>;
 declare function saveManifest(manifest: Manifest, cwd?: string): Promise<void>;
@@ -272,10 +301,11 @@ declare const paths: (cwd?: string) => {
     baselines: string;
     actual: string;
     judgments: string;
+    checkpoints: string;
     summary: string;
     gitignore: string;
     serverLog: string;
     serverPid: string;
 };
 
-export { type AgentConfig, type ApplyJudgmentsResult, type BrowsersInstallOptions, type BrowsersInstallResult, type CaptureOptions, type CaptureRouteInput, type CaptureRouteResult, type CheckReport, type CheckResult, type DevServerConfig, type DiffOptions, type DiffOutcome, type DiscoveredRoute, type Judge, type JudgeBackend, type JudgeInput, type JudgeOutput, type JudgmentRequest, type JudgmentRequestRegion, type Manifest, type ManifestEntry, type RegionSummary, type RunCapturesOptions, type RunCapturesReport, type RunOptions, STABILITY_HOOKS_VERSION, type Verdict, type VerdictAction, type VerdictLabel, type Viewport, type WaitFor, type WaitForSelector, applyJudgments, captureScreenshot, configHash, diffEntry, discover, installBrowsers, loadConfig, loadManifest, paths, resolveBaseUrl, resolveJudge, runCaptures, runCheck, runGraph, saveConfig, saveManifest };
+export { type AgentConfig, type ApplyJudgmentsResult, type BrowsersInstallOptions, type BrowsersInstallResult, type CaptureOptions, type CaptureRouteInput, type CaptureRouteResult, type CheckOptions, type CheckReport, type CheckResult, type DevServerConfig, type DiffOptions, type DiffOutcome, type DiscoveredRoute, type Judge, type JudgeBackend, type JudgeInput, type JudgeOutput, type JudgmentRequest, type JudgmentRequestRegion, type Manifest, type ManifestEntry, type RegionSummary, type ResumeMap, type ResumeOptions, type RunCapturesOptions, type RunCapturesReport, type RunEvent, type RunOptions, STABILITY_HOOKS_VERSION, type Verdict, type VerdictAction, type VerdictLabel, type Viewport, type WaitFor, type WaitForSelector, applyJudgments, captureScreenshot, configHash, diffEntry, discover, installBrowsers, loadConfig, loadManifest, paths, resolveBaseUrl, resolveJudge, resumeGraph, runCaptures, runCheck, runGraph, saveConfig, saveManifest, threadIdFor };

package/dist/index.d.ts

@@ -127,6 +127,7 @@ interface RunCapturesOptions {
     mode?: "baseline" | "actual";
     writeManifest?: boolean;
     cwd?: string;
+    concurrency?: number;
 }
 interface CaptureRouteResult {
     id: string;
@@ -146,6 +147,37 @@ interface RunCapturesReport {
 }
 declare function runCaptures(opts: RunCapturesOptions): Promise<RunCapturesReport>;
 
+declare function loadConfig(cwd?: string): Promise<AgentConfig | null>;
+declare function saveConfig(config: AgentConfig, cwd?: string): Promise<void>;
+declare function configHash(config: AgentConfig): string;
+declare function resolveBaseUrl(config: AgentConfig | null, override?: string): string;
+
+interface DiffOptions {
+    threshold?: number;
+    antialiasing?: boolean;
+    emitDiffPng?: boolean;
+}
+interface DiffOutcome {
+    id: string;
+    baselinePath: string;
+    actualPath: string;
+    diffPath?: string;
+    match: boolean;
+    reason?: "pixel-diff" | "layout-diff" | "file-not-exists";
+    diffCount?: number;
+    diffPercentage?: number;
+    interpretation?: InterpretResult;
+}
+declare function diffEntry(id: string, baselinePath: string, actualPath: string, opts?: DiffOptions, cwd?: string): Promise<DiffOutcome>;
+
+interface DiscoverOptions {
+    baseUrl: string;
+    cwd?: string;
+    maxRoutes?: number;
+    skipCrawl?: boolean;
+}
+declare function discover(opts: DiscoverOptions): Promise<DiscoveredRoute[]>;
+
 interface JudgeInput {
     entry: ManifestEntry;
     baselinePath: string;
@@ -178,7 +210,12 @@ interface ApplyJudgmentsResult {
     missing: string[];
     invalid: string[];
 }
-declare function applyJudgments(cwd?: string): Promise<ApplyJudgmentsResult>;
+interface ApplyJudgmentsOptions {
+    cwd?: string;
+    onEvent?: (event: RunEvent) => void;
+    junitPath?: string;
+}
+declare function applyJudgments(opts?: ApplyJudgmentsOptions | string): Promise<ApplyJudgmentsResult>;
 
 interface JudgmentRequest {
     id: string;
@@ -209,58 +246,50 @@ interface JudgmentRequest {
 
 declare function resolveJudge(backend: JudgeBackend): Judge;
 
-interface CheckOptions {
-    baseUrl: string;
-    cwd?: string;
-    threshold?: number;
-    concurrency?: number;
-    emitDiffPng?: boolean;
-    junitPath?: string;
-    judge?: JudgeBackend;
-}
-declare function runCheck(opts: CheckOptions): Promise<CheckReport>;
-
-declare function loadConfig(cwd?: string): Promise<AgentConfig | null>;
-declare function saveConfig(config: AgentConfig, cwd?: string): Promise<void>;
-declare function configHash(config: AgentConfig): string;
-declare function resolveBaseUrl(config: AgentConfig | null, override?: string): string;
-
-interface DiffOptions {
-    threshold?: number;
-    antialiasing?: boolean;
-    emitDiffPng?: boolean;
-}
-interface DiffOutcome {
-    id: string;
-    baselinePath: string;
-    actualPath: string;
-    diffPath?: string;
-    match: boolean;
-    reason?: "pixel-diff" | "layout-diff" | "file-not-exists";
-    diffCount?: number;
-    diffPercentage?: number;
-    interpretation?: InterpretResult;
-}
-declare function diffEntry(id: string, baselinePath: string, actualPath: string, opts?: DiffOptions, cwd?: string): Promise<DiffOutcome>;
-
-interface DiscoverOptions {
-    baseUrl: string;
-    cwd?: string;
-    maxRoutes?: number;
-    skipCrawl?: boolean;
+interface JudgmentInterrupt {
+    kind: "host-judgment-required";
+    entryId: string;
+    url: string;
+    requestPath: string;
+    signature: string;
+    pendingResult: CheckResult;
 }
-declare function discover(opts: DiscoverOptions): Promise<DiscoveredRoute[]>;
 
+type ResumeMap = Record<string, Verdict>;
+type RunEvent = {
+    type: "result";
+    result: CheckResult;
+} | {
+    type: "interrupt";
+    interrupt: JudgmentInterrupt;
+} | {
+    type: "report";
+    report: CheckReport;
+};
 interface RunOptions {
-    baseUrl: string;
+    baseUrl?: string;
     cwd?: string;
     threshold?: number;
     concurrency?: number;
     emitDiffPng?: boolean;
     junitPath?: string;
     judge?: JudgeBackend;
+    threadId?: string;
+    onEvent?: (event: RunEvent) => void;
+    resume?: ResumeMap;
 }
+type CheckOptions = RunOptions;
+declare function threadIdFor(cwd: string): string;
 declare function runGraph(opts: RunOptions): Promise<CheckReport>;
+interface ResumeOptions {
+    cwd?: string;
+    verdicts: ResumeMap;
+    threadId?: string;
+    onEvent?: (event: RunEvent) => void;
+    junitPath?: string;
+}
+declare function resumeGraph(opts: ResumeOptions): Promise<CheckReport>;
+declare function runCheck(opts: CheckOptions): Promise<CheckReport>;
 
 declare function loadManifest(cwd?: string): Promise<Manifest | null>;
 declare function saveManifest(manifest: Manifest, cwd?: string): Promise<void>;
@@ -272,10 +301,11 @@ declare const paths: (cwd?: string) => {
     baselines: string;
     actual: string;
     judgments: string;
+    checkpoints: string;
     summary: string;
     gitignore: string;
     serverLog: string;
     serverPid: string;
 };
 
-export { type AgentConfig, type ApplyJudgmentsResult, type BrowsersInstallOptions, type BrowsersInstallResult, type CaptureOptions, type CaptureRouteInput, type CaptureRouteResult, type CheckReport, type CheckResult, type DevServerConfig, type DiffOptions, type DiffOutcome, type DiscoveredRoute, type Judge, type JudgeBackend, type JudgeInput, type JudgeOutput, type JudgmentRequest, type JudgmentRequestRegion, type Manifest, type ManifestEntry, type RegionSummary, type RunCapturesOptions, type RunCapturesReport, type RunOptions, STABILITY_HOOKS_VERSION, type Verdict, type VerdictAction, type VerdictLabel, type Viewport, type WaitFor, type WaitForSelector, applyJudgments, captureScreenshot, configHash, diffEntry, discover, installBrowsers, loadConfig, loadManifest, paths, resolveBaseUrl, resolveJudge, runCaptures, runCheck, runGraph, saveConfig, saveManifest };
+export { type AgentConfig, type ApplyJudgmentsResult, type BrowsersInstallOptions, type BrowsersInstallResult, type CaptureOptions, type CaptureRouteInput, type CaptureRouteResult, type CheckOptions, type CheckReport, type CheckResult, type DevServerConfig, type DiffOptions, type DiffOutcome, type DiscoveredRoute, type Judge, type JudgeBackend, type JudgeInput, type JudgeOutput, type JudgmentRequest, type JudgmentRequestRegion, type Manifest, type ManifestEntry, type RegionSummary, type ResumeMap, type ResumeOptions, type RunCapturesOptions, type RunCapturesReport, type RunEvent, type RunOptions, STABILITY_HOOKS_VERSION, type Verdict, type VerdictAction, type VerdictLabel, type Viewport, type WaitFor, type WaitForSelector, applyJudgments, captureScreenshot, configHash, diffEntry, discover, installBrowsers, loadConfig, loadManifest, paths, resolveBaseUrl, resolveJudge, resumeGraph, runCaptures, runCheck, runGraph, saveConfig, saveManifest, threadIdFor };