feat: add support for monitoring

src/builders/workflow-builder.ts

@@ -189,6 +189,12 @@ export abstract class WorkflowBuilder {
     return this;
   }
 
+  /** Enable or disable comparison with the previous successful run. */
+  monitorChanges(enabled: boolean = true): this {
+    this.meta.compareRuns = enabled;
+    return this;
+  }
+
   /**
    * Add a new step to the workflow
    */

src/client/maxun-client.ts

@@ -329,6 +329,7 @@ export class Client {
     llmApiKey?: string;
     llmBaseUrl?: string;
     robotName?: string;
+    compareRuns?: boolean;
   }): Promise<any> {
     const response = await this.axios.post<ApiResponse<any>>(
       '/extract/llm',
@@ -340,6 +341,7 @@ export class Client {
         ...(options.llmApiKey ? { llmApiKey: options.llmApiKey } : {}),
         ...(options.llmBaseUrl ? { llmBaseUrl: options.llmBaseUrl } : {}),
         robotName: options.robotName,
+        ...(options.compareRuns !== undefined ? { compareRuns: options.compareRuns } : {}),
       },
       {
         timeout: 300000,

src/extract.ts

@@ -99,6 +99,7 @@ export class Extract {
     llmApiKey?: string;
     llmBaseUrl?: string;
     robotName?: string;
+    compareRuns?: boolean;
   }): Promise<Robot> {
     const robotData = await this.client.extractWithLLM(options);
     const robot = await this.client.getRobot(robotData.robotId);

src/scrape.ts

@@ -27,6 +27,7 @@ export interface ScrapeOptions extends LlmOptions {
    * Adds 2 extra credits per run on top of the base 1 scrape credit.
    */
   smartQueries?: string;
+  compareRuns?: boolean;
 }
 
 export class Scrape {
@@ -55,6 +56,7 @@ export class Scrape {
         robotType: 'scrape',
         url,
         formats: options?.formats || ['markdown'],
+        ...(options?.compareRuns !== undefined ? { compareRuns: options.compareRuns } : {}),
         ...(options?.smartQueries ? { smartQueries: options.smartQueries } : {}),
         ...buildLlmPayload(options || {}),
       } as any,

src/types/index.ts

@@ -29,6 +29,7 @@ export interface RobotMeta extends LlmOptions {
   formats?: Format[];
   subscriptionLevel?: number;
   smartQueries?: string;
+  compareRuns?: boolean;
 }
 
 export interface Where {
@@ -99,6 +100,7 @@ export interface Run {
   runId: string;
   startedAt: string;
   finishedAt: string | null;
+  hasChanges?: boolean;
   serializableOutput?: {
     scrapeSchema?: Record<string, any>;
     scrapeList?: Record<string, any>[];
@@ -155,6 +157,8 @@ export interface RunResult {
   screenshots?: Array<string | { data: string; mimeType: string }>;
   status: RunStatus;
   runId: string;
+  hasChanges?: boolean;
+  changedFormats?: string[];
 }
 
 export interface ExecutionOptions {