@kadoa/mcp 0.4.2 → 0.4.3-rc.1

package/dist/index.js

@@ -43925,6 +43925,90 @@ var init_dist_node = __esm(() => {
 // node_modules/@kadoa/node-sdk/dist/index.mjs
 import { URL as URL$1, URLSearchParams } from "url";
 import assert2 from "assert";
+function mapChange(raw) {
+  return {
+    id: raw.id,
+    workflowId: raw.workflowId,
+    data: raw.data,
+    differences: coalesceDifferences(raw.differences),
+    url: raw.url,
+    summary: raw.summary,
+    screenshotUrl: raw.screenshotUrl,
+    createdAt: raw.createdAt
+  };
+}
+function coalesceDifferences(raw) {
+  if (!raw)
+    return;
+  const addedByRow = /* @__PURE__ */ new Map;
+  const removedByRow = /* @__PURE__ */ new Map;
+  const passthrough = [];
+  for (const diff of raw) {
+    if (diff.type === "added" && diff.rowRef?.currentRowId) {
+      addedByRow.set(diff.rowRef.currentRowId, diff);
+    } else if (diff.type === "removed" && diff.rowRef?.previousRowId) {
+      removedByRow.set(diff.rowRef.previousRowId, diff);
+    } else {
+      passthrough.push(diff);
+    }
+  }
+  const result = [];
+  for (const [rowId, added] of addedByRow) {
+    const removed = removedByRow.get(rowId);
+    if (removed) {
+      removedByRow.delete(rowId);
+      result.push(mergeAddedRemoved(added, removed));
+    } else {
+      result.push(mapDifference(added));
+    }
+  }
+  for (const removed of removedByRow.values()) {
+    result.push(mapDifference(removed));
+  }
+  for (const diff of passthrough) {
+    result.push(mapDifference(diff));
+  }
+  return result;
+}
+function mergeAddedRemoved(added, removed) {
+  const previousByKey = /* @__PURE__ */ new Map;
+  for (const f of removed.fields ?? []) {
+    if (f.key !== undefined)
+      previousByKey.set(f.key, f.value);
+  }
+  const fields = (added.fields ?? []).map((f) => ({
+    key: f.key,
+    value: f.value,
+    previousValue: f.key !== undefined ? previousByKey.get(f.key) : undefined
+  }));
+  const addedKeys = new Set((added.fields ?? []).map((f) => f.key));
+  for (const f of removed.fields ?? []) {
+    if (!addedKeys.has(f.key)) {
+      fields.push({ key: f.key, value: undefined, previousValue: f.value });
+    }
+  }
+  return { type: ChangeDifferenceType.Changed, fields };
+}
+function mapDifference(raw) {
+  return {
+    type: raw.type,
+    fields: raw.fields?.map(mapField)
+  };
+}
+function mapField(raw) {
+  return {
+    key: raw.key,
+    value: raw.value,
+    previousValue: raw.previousValue
+  };
+}
+function mapListChangesResponse(raw) {
+  return {
+    changes: (raw.changes ?? []).map(mapChange),
+    pagination: raw.pagination,
+    changesCount: raw.changesCount ?? 0
+  };
+}
 function setFlattenedQueryParams(urlSearchParams, parameter, key = "") {
   if (parameter == null)
     return;
@@ -44105,6 +44189,7 @@ function createAxiosInstance(params) {
 }
 function createClientDomains(params) {
   const { client } = params;
+  const changesService = new ChangesService(client);
   const userService = new UserService(client);
   const dataFetcherService = new DataFetcherService(client.apis.workflows);
   const channelsService = new NotificationChannelsService(client.apis.notifications, userService);
@@ -44128,6 +44213,7 @@ function createClientDomains(params) {
   const validation = createValidationDomain(coreService, rulesService);
   const crawler = createCrawlerDomain(client);
   return {
+    changes: changesService,
     extractionBuilderService,
     extraction: extractionService,
     workflow: workflowsCoreService,
@@ -44177,7 +44263,31 @@ function createNotificationDomain(params) {
     }
   };
 }
-var import_debug, __require2, BASE_PATH, BaseAPI = class {
+var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkException, KadoaSdkException, ERROR_MESSAGES, KadoaHttpException, createLogger = (namespace) => import_debug.default(`kadoa:${namespace}`), logger, debug, ChangesService = class {
+  constructor(client) {
+    this.client = client;
+  }
+  get workflowsApi() {
+    return this.client.apis.workflows;
+  }
+  async list(options) {
+    debug("list changes %o", options);
+    const response = await this.workflowsApi.v4ChangesGet(options ?? {});
+    return mapListChangesResponse(response.data);
+  }
+  async get(changeId) {
+    debug("get change %s", changeId);
+    const response = await this.workflowsApi.v4ChangesChangeIdGet({ changeId });
+    const change = response.data;
+    if (!change) {
+      throw new KadoaSdkException(`Change not found: ${changeId}`, {
+        code: KadoaErrorCode.NOT_FOUND,
+        details: { changeId }
+      });
+    }
+    return mapChange(change);
+  }
+}, BASE_PATH, BaseAPI = class {
   constructor(configuration, basePath = BASE_PATH, axios2 = axios_default) {
     this.basePath = basePath;
     this.axios = axios2;
@@ -47261,7 +47371,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
       yield page;
     }
   }
-}, KadoaErrorCode, _KadoaSdkException, KadoaSdkException, ERROR_MESSAGES, KadoaHttpException, createLogger = (namespace) => import_debug.default(`kadoa:${namespace}`), logger, _SchemaBuilder = class _SchemaBuilder2 {
+}, _SchemaBuilder = class _SchemaBuilder2 {
   constructor() {
     this.fields = [];
   }
@@ -47341,7 +47451,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
       });
     }
   }
-}, SchemaBuilder, debug, SchemasService = class {
+}, SchemaBuilder, debug2, SchemasService = class {
   constructor(client) {
     this.client = client;
   }
@@ -47376,7 +47486,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     };
   }
   async getSchema(schemaId) {
-    debug("Fetching schema with ID: %s", schemaId);
+    debug2("Fetching schema with ID: %s", schemaId);
     const response = await this.schemasApi.v4SchemasSchemaIdGet({
       schemaId
     });
@@ -47394,7 +47504,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     return response.data.data;
   }
   async createSchema(body) {
-    debug("Creating schema with name: %s", body.name);
+    debug2("Creating schema with name: %s", body.name);
     const response = await this.schemasApi.v4SchemasPost({
       createSchemaBody: body
     });
@@ -47407,7 +47517,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     return this.getSchema(schemaId);
   }
   async updateSchema(schemaId, body) {
-    debug("Updating schema with ID: %s", schemaId);
+    debug2("Updating schema with ID: %s", schemaId);
     await this.schemasApi.v4SchemasSchemaIdPut({
       schemaId,
       updateSchemaBody: body
@@ -47415,7 +47525,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     return this.getSchema(schemaId);
   }
   async deleteSchema(schemaId) {
-    debug("Deleting schema with ID: %s", schemaId);
+    debug2("Deleting schema with ID: %s", schemaId);
     await this.schemasApi.v4SchemasSchemaIdDelete({
       schemaId
     });
@@ -47497,7 +47607,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
       });
     }
   }
-}, debug2, SUCCESSFUL_RUN_STATES, DEFAULT_OPTIONS, ExtractionService = class {
+}, debug3, SUCCESSFUL_RUN_STATES, DEFAULT_OPTIONS, ExtractionService = class {
   constructor(workflowsCoreService, dataFetcherService, entityResolverService, notificationSetupService, notificationChannelsService, notificationSettingsService) {
     this.workflowsCoreService = workflowsCoreService;
     this.dataFetcherService = dataFetcherService;
@@ -47585,7 +47695,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
         events: config2.notifications?.events,
         channels: config2.notifications?.channels
       });
-      debug2("Notifications setup: %O", result2.map((r) => ({ id: r.id, eventType: r.eventType })));
+      debug3("Notifications setup: %O", result2.map((r) => ({ id: r.id, eventType: r.eventType })));
     }
     if (config2.mode === "submit") {
       return {
@@ -47660,7 +47770,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
   isExtractionSuccessful(runState) {
     return runState ? SUCCESSFUL_RUN_STATES.has(runState.toUpperCase()) : false;
   }
-}, debug3, ExtractionBuilderService = class {
+}, debug4, ExtractionBuilderService = class {
   constructor(workflowsCoreService, entityResolverService, dataFetcherService, notificationSetupService) {
     this.workflowsCoreService = workflowsCoreService;
     this.entityResolverService = entityResolverService;
@@ -47844,10 +47954,10 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     }
     const startedJob = await this.workflowsCoreService.runWorkflow(this._workflowId, { variables: options?.variables, limit: options?.limit });
     assert2(startedJob.jobId, "Job ID is not set");
-    debug3("Job started: %O", startedJob);
+    debug4("Job started: %O", startedJob);
     this._jobId = startedJob.jobId;
     const finishedJob = await this.workflowsCoreService.waitForJobCompletion(this._workflowId, startedJob.jobId);
-    debug3("Job finished: %O", finishedJob);
+    debug4("Job finished: %O", finishedJob);
     return this;
   }
   async submit(options) {
@@ -47864,7 +47974,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     }
     const submittedJob = await this.workflowsCoreService.runWorkflow(this._workflowId, { variables: options?.variables, limit: options?.limit });
     assert2(submittedJob.jobId, "Job ID is not set");
-    debug3("Job submitted: %O", submittedJob);
+    debug4("Job submitted: %O", submittedJob);
     this._jobId = submittedJob.jobId;
     return {
       workflowId: this._workflowId,
@@ -48048,7 +48158,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
       });
     }
   }
-}, debug4, NotificationSetupService = class {
+}, debug5, NotificationSetupService = class {
   constructor(channelsService, settingsService) {
     this.channelsService = channelsService;
     this.settingsService = settingsService;
@@ -48073,7 +48183,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     });
   }
   async setup(requestData) {
-    requestData.workflowId ? debug4("Setting up notifications for workflow %s", requestData.workflowId) : debug4("Setting up notifications for workspace");
+    requestData.workflowId ? debug5("Setting up notifications for workflow %s", requestData.workflowId) : debug5("Setting up notifications for workspace");
     const channels = await this.setupChannels({
       workflowId: requestData.workflowId,
       channels: requestData.channels || {}
@@ -48081,7 +48191,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     const events = requestData.events || "all";
     const eventTypes = events === "all" ? await this.settingsService.listAllEvents() : events;
     const channelIds = channels.map((channel) => channel.id).filter(Boolean);
-    debug4("Creating notification settings for workflow %s: %O", requestData.workflowId, {
+    debug5("Creating notification settings for workflow %s: %O", requestData.workflowId, {
       events: eventTypes,
       channels: channelIds
     });
@@ -48108,7 +48218,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
         eventConfiguration: {}
       });
     }));
-    debug4(requestData.workflowId ? "Successfully setup notifications for workflow %s" : "Successfully setup notifications for workspace", requestData.workflowId);
+    debug5(requestData.workflowId ? "Successfully setup notifications for workflow %s" : "Successfully setup notifications for workspace", requestData.workflowId);
     return newSettings;
   }
   async setupChannels(requestData) {
@@ -48165,7 +48275,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     const channels = await Promise.all(channelsByName.map(async ([channelType]) => {
       const existingChannel = channelType === NotificationChannelType.WEBSOCKET ? existingChannels.find((channel2) => channel2.channelType === channelType) : existingChannels.find((channel2) => channel2.channelType === channelType && channel2.name === NotificationChannelsService.DEFAULT_CHANNEL_NAME);
       if (existingChannel) {
-        debug4("Using existing default channel: %O", {
+        debug5("Using existing default channel: %O", {
           workflowId,
           channelType,
           channelId: existingChannel.id
@@ -48173,7 +48283,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
         return existingChannel;
       }
       const channel = await this.channelsService.createChannel(channelType);
-      debug4("Created default channel %O", {
+      debug5("Created default channel %O", {
         workflowId,
         channelType,
         channel
@@ -48194,7 +48304,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
       const channelName = config2.name || NotificationChannelsService.DEFAULT_CHANNEL_NAME;
       const existingChannel = existingChannels.find((channel2) => channel2.channelType === channelType && (channel2.name || NotificationChannelsService.DEFAULT_CHANNEL_NAME) === channelName);
       if (existingChannel) {
-        debug4("Using existing channel: %O", {
+        debug5("Using existing channel: %O", {
           workflowId,
           channelType,
           channelName,
@@ -48207,7 +48317,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
         name: channelName,
         config: channelConfig
       });
-      debug4("Created channel with custom config %O", {
+      debug5("Created channel with custom config %O", {
         workflowId,
         channelType,
         channelName,
@@ -48217,7 +48327,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     }));
     return channels;
   }
-}, PUBLIC_API_URI, WSS_API_URI, REALTIME_API_URI, SDK_VERSION = "0.26.0", SDK_NAME = "kadoa-node-sdk", SDK_LANGUAGE = "node", debug5, isDrainControlMessage = (message) => message.type === "control.draining", isRealtimeEvent = (message) => message.type !== "heartbeat" && message.type !== "control.draining", _Realtime = class _Realtime2 {
+}, PUBLIC_API_URI, WSS_API_URI, REALTIME_API_URI, SDK_VERSION = "0.27.0", SDK_NAME = "kadoa-node-sdk", SDK_LANGUAGE = "node", debug6, isDrainControlMessage = (message) => message.type === "control.draining", isRealtimeEvent = (message) => message.type !== "heartbeat" && message.type !== "control.draining", _Realtime = class _Realtime2 {
   constructor(config2) {
     this.drainingSockets = /* @__PURE__ */ new Set;
     this.lastHeartbeat = Date.now();
@@ -48245,7 +48355,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
       await this.openSocket(access_token, team_id, "active");
       this.hasConnectedOnce = true;
     } catch (err) {
-      debug5("Failed to connect: %O", err);
+      debug6("Failed to connect: %O", err);
       this.isConnecting = false;
       this.notifyErrorListeners(err);
       if (!this.hasConnectedOnce) {
@@ -48282,7 +48392,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
         this.isConnecting = false;
         this.lastHeartbeat = Date.now();
         this.startHeartbeatCheck();
-        debug5("Connected to WebSocket");
+        debug6("Connected to WebSocket");
         if (!settled) {
           settled = true;
           resolve();
@@ -48347,7 +48457,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify({ id: data.id })
         }).catch((error48) => {
-          debug5("Failed to acknowledge event %s: %O", data.id, error48);
+          debug6("Failed to acknowledge event %s: %O", data.id, error48);
         });
       }
       if (this.isDuplicateEvent(data.id)) {
@@ -48355,14 +48465,14 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
       }
       this.notifyEventListeners(data);
     } catch (err) {
-      debug5("Failed to parse incoming message: %O", err);
+      debug6("Failed to parse incoming message: %O", err);
     }
   }
   handleDrainSignal(socket, message) {
     if (socket !== this.activeSocket || this.isClosed) {
       return;
     }
-    debug5("Received drain signal, preparing replacement socket");
+    debug6("Received drain signal, preparing replacement socket");
     this.drainingSockets.add(socket);
     this.scheduleDrainReconnect(message.retryAfterMs);
   }
@@ -48378,7 +48488,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
       return;
     }
     if (this.drainingSockets.size > 0) {
-      debug5("Draining socket closed after replacement was scheduled");
+      debug6("Draining socket closed after replacement was scheduled");
       return;
     }
     this.handleUnexpectedDisconnect("Connection closed");
@@ -48402,7 +48512,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
         const { access_token, team_id } = await this.getOAuthToken();
         await this.openSocket(access_token, team_id, replacement ? "replacement" : "active");
       } catch (err) {
-        debug5("Reconnect failed: %O", err);
+        debug6("Reconnect failed: %O", err);
         this.isConnecting = false;
         this.notifyErrorListeners(err);
         this.scheduleReconnect(replacement);
@@ -48427,7 +48537,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
         const { access_token, team_id } = await this.getOAuthToken();
         await this.openSocket(access_token, team_id, "replacement");
       } catch (err) {
-        debug5("Reconnect failed: %O", err);
+        debug6("Reconnect failed: %O", err);
         this.isConnecting = false;
         this.notifyErrorListeners(err);
         this.scheduleReconnect(true);
@@ -48458,7 +48568,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     return false;
   }
   handleHeartbeat() {
-    debug5("Heartbeat received");
+    debug6("Heartbeat received");
     this.lastHeartbeat = Date.now();
   }
   notifyEventListeners(event) {
@@ -48466,7 +48576,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
       try {
         listener(event);
       } catch (error48) {
-        debug5("Error in event listener: %O", error48);
+        debug6("Error in event listener: %O", error48);
       }
     });
   }
@@ -48475,7 +48585,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
       try {
         listener(connected, reason);
       } catch (error48) {
-        debug5("Error in connection listener: %O", error48);
+        debug6("Error in connection listener: %O", error48);
       }
     });
   }
@@ -48484,7 +48594,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
       try {
         listener(error48);
       } catch (listenerError) {
-        debug5("Error in error listener: %O", listenerError);
+        debug6("Error in error listener: %O", listenerError);
       }
     });
   }
@@ -48492,7 +48602,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     this.stopHeartbeatCheck();
     this.missedHeartbeatCheckTimer = setInterval(() => {
       if (this.activeSocket && Date.now() - this.lastHeartbeat > this.missedHeartbeatsLimit) {
-        debug5("No heartbeat received in 30 seconds! Closing connection.");
+        debug6("No heartbeat received in 30 seconds! Closing connection.");
         this.activeSocket.close();
       }
     }, this.heartbeatInterval);
@@ -48545,7 +48655,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
   isConnected() {
     return this.activeSocket?.readyState === WebSocket.OPEN;
   }
-}, Realtime, debug6, TemplatesService = class {
+}, Realtime, debug7, TemplatesService = class {
   constructor(client) {
     this.client = client;
   }
@@ -48553,12 +48663,12 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     return this.client.apis.templates;
   }
   async list() {
-    debug6("Listing all templates");
+    debug7("Listing all templates");
     const response = await this.templatesApi.v4TemplatesGet();
     return response.data.data ?? [];
   }
   async get(templateId) {
-    debug6("Fetching template with ID: %s", templateId);
+    debug7("Fetching template with ID: %s", templateId);
     const response = await this.templatesApi.v4TemplatesTemplateIdGet({
       templateId
     });
@@ -48572,7 +48682,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     return template;
   }
   async create(body) {
-    debug6("Creating template with name: %s", body.name);
+    debug7("Creating template with name: %s", body.name);
     const response = await this.templatesApi.v4TemplatesPost({
       createTemplateBody: body
     });
@@ -48585,7 +48695,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     return template;
   }
   async update(templateId, body) {
-    debug6("Updating template with ID: %s", templateId);
+    debug7("Updating template with ID: %s", templateId);
     const response = await this.templatesApi.v4TemplatesTemplateIdPut({
       templateId,
       updateTemplateBody: body
@@ -48600,13 +48710,13 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     return template;
   }
   async delete(templateId) {
-    debug6("Deleting template with ID: %s", templateId);
+    debug7("Deleting template with ID: %s", templateId);
     await this.templatesApi.v4TemplatesTemplateIdDelete({
       templateId
     });
   }
   async createVersion(templateId, body) {
-    debug6("Creating version for template: %s", templateId);
+    debug7("Creating version for template: %s", templateId);
     const response = await this.templatesApi.v4TemplatesTemplateIdVersionsPost({
       templateId,
       createTemplateVersionBody: body
@@ -48621,21 +48731,21 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     return version2;
   }
   async listSchemas(templateId) {
-    debug6("Listing schemas for template: %s", templateId);
+    debug7("Listing schemas for template: %s", templateId);
     const response = await this.templatesApi.v4TemplatesTemplateIdSchemasGet({
       templateId
     });
     return response.data.data ?? [];
   }
   async listWorkflows(templateId) {
-    debug6("Listing workflows for template: %s", templateId);
+    debug7("Listing workflows for template: %s", templateId);
     const response = await this.templatesApi.v4TemplatesTemplateIdWorkflowsGet({
       templateId
     });
     return response.data.data ?? [];
   }
   async linkWorkflows(templateId, body) {
-    debug6("Linking %d workflows to template: %s", body.workflowIds.length, templateId);
+    debug7("Linking %d workflows to template: %s", body.workflowIds.length, templateId);
     const response = await this.templatesApi.v4TemplatesTemplateIdLinkPost({
       templateId,
       linkWorkflowsBody: body
@@ -48643,7 +48753,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     return response.data;
   }
   async unlinkWorkflows(templateId, body) {
-    debug6("Unlinking %d workflows from template: %s", body.workflowIds.length, templateId);
+    debug7("Unlinking %d workflows from template: %s", body.workflowIds.length, templateId);
     const response = await this.templatesApi.v4TemplatesTemplateIdUnlinkPost({
       templateId,
       unlinkWorkflowsBody: body
@@ -48651,7 +48761,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     return response.data;
   }
   async applyUpdate(templateId, body) {
-    debug6("Applying version %d to %d workflows for template: %s", body.targetVersion, body.workflowIds.length, templateId);
+    debug7("Applying version %d to %d workflows for template: %s", body.targetVersion, body.workflowIds.length, templateId);
     const response = await this.templatesApi.v4TemplatesTemplateIdApplyPost({
       templateId,
       applyTemplateUpdateBody: body
@@ -48659,7 +48769,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     return response.data;
   }
   async createFromWorkflow(body) {
-    debug6("Creating template from workflow: %s", body.workflowId);
+    debug7("Creating template from workflow: %s", body.workflowId);
     const response = await this.templatesApi.v4TemplatesFromWorkflowPost({
       saveFromWorkflowBody: body
     });
@@ -48917,7 +49027,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     }
     return response.data.data;
   }
-}, debug7, VariablesService = class {
+}, debug8, VariablesService = class {
   constructor(client) {
     this.client = client;
   }
@@ -48929,7 +49039,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     return response.data.variables ?? [];
   }
   async get(variableId) {
-    debug7("Fetching variable with ID: %s", variableId);
+    debug8("Fetching variable with ID: %s", variableId);
     const response = await this.variablesApi.v4VariablesVariableIdGet({
       variableId
     });
@@ -48943,7 +49053,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     return variable;
   }
   async create(body) {
-    debug7("Creating variable with key: %s", body.key);
+    debug8("Creating variable with key: %s", body.key);
     const response = await this.variablesApi.v4VariablesPost({
       createVariableBody: body
     });
@@ -48956,7 +49066,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     return variable;
   }
   async update(variableId, body) {
-    debug7("Updating variable with ID: %s", variableId);
+    debug8("Updating variable with ID: %s", variableId);
     const response = await this.variablesApi.v4VariablesVariableIdPatch({
       variableId,
       updateVariableBody: body
@@ -48971,12 +49081,12 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     return variable;
   }
   async delete(variableId) {
-    debug7("Deleting variable with ID: %s", variableId);
+    debug8("Deleting variable with ID: %s", variableId);
     await this.variablesApi.v4VariablesVariableIdDelete({
       variableId
     });
   }
-}, JobStateEnum, TERMINAL_JOB_STATES, TERMINAL_RUN_STATES, debug8, WorkflowsCoreService = class {
+}, JobStateEnum, TERMINAL_JOB_STATES, TERMINAL_RUN_STATES, debug9, WorkflowsCoreService = class {
   constructor(workflowsApi) {
     this.workflowsApi = workflowsApi;
   }
@@ -49092,7 +49202,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
   async wait(id, options) {
     const result = await pollUntil(async () => {
       const current = await this.get(id);
-      debug8("workflow %s state: %s", id, current.runState);
+      debug9("workflow %s state: %s", id, current.runState);
       return current;
     }, (current) => {
       if (options?.targetState && current.state === options.targetState) {
@@ -49138,7 +49248,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
   async waitForJobCompletion(workflowId, jobId, options) {
     const result = await pollUntil(async () => {
       const current = await this.getJobStatus(workflowId, jobId);
-      debug8("workflow run %s state: %s", jobId, current.state);
+      debug9("workflow run %s state: %s", jobId, current.state);
       return current;
     }, (current) => {
       if (options?.targetStatus && current.state === options.targetStatus) {
@@ -49211,6 +49321,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     });
     this.apis = new ApiRegistry(this._apiKey, this._baseUrl, this._axiosInstance, headers);
     const domains = createClientDomains({ client: this });
+    this.changes = domains.changes;
     this.user = domains.user;
     this.extraction = domains.extraction;
     this.workflow = domains.workflow;
@@ -49300,6 +49411,222 @@ var init_dist2 = __esm(() => {
       return __require.apply(this, arguments);
     throw Error('Dynamic require of "' + x + '" is not supported');
   });
+  ChangeDifferenceType = {
+    Added: "added",
+    Removed: "removed",
+    Changed: "changed"
+  };
+  KadoaErrorCode = {
+    VALIDATION_ERROR: "VALIDATION_ERROR",
+    BAD_REQUEST: "BAD_REQUEST",
+    NOT_FOUND: "NOT_FOUND",
+    INTERNAL_ERROR: "INTERNAL_ERROR"
+  };
+  _KadoaSdkException = class _KadoaSdkException2 extends Error {
+    constructor(message, options) {
+      super(message);
+      this.name = "KadoaSdkException";
+      this.code = options?.code ?? "UNKNOWN";
+      this.details = options?.details;
+      if (options && "cause" in options)
+        this.cause = options.cause;
+      Error.captureStackTrace?.(this, _KadoaSdkException2);
+    }
+    static from(error48, details) {
+      if (error48 instanceof _KadoaSdkException2)
+        return error48;
+      const message = error48 instanceof Error ? error48.message : typeof error48 === "string" ? error48 : "Unexpected error";
+      return new _KadoaSdkException2(message, {
+        code: "UNKNOWN",
+        details,
+        cause: error48
+      });
+    }
+    toJSON() {
+      return {
+        name: this.name,
+        message: this.message,
+        code: this.code,
+        details: this.details
+      };
+    }
+    toString() {
+      return [this.name, this.code, this.message].filter(Boolean).join(": ");
+    }
+    toDetailedString() {
+      const parts = [`${this.name}: ${this.message}`, `Code: ${this.code}`];
+      if (this.details && Object.keys(this.details).length > 0) {
+        parts.push(`Details: ${JSON.stringify(this.details, null, 2)}`);
+      }
+      if (this.cause) {
+        parts.push(`Cause: ${this.cause}`);
+      }
+      return parts.join(`
+`);
+    }
+    static isInstance(error48) {
+      return error48 instanceof _KadoaSdkException2;
+    }
+    static wrap(error48, extra) {
+      if (error48 instanceof _KadoaSdkException2)
+        return error48;
+      const message = extra?.message || (error48 instanceof Error ? error48.message : typeof error48 === "string" ? error48 : "Unexpected error");
+      return new _KadoaSdkException2(message, {
+        code: "UNKNOWN",
+        details: extra?.details,
+        cause: error48
+      });
+    }
+  };
+  _KadoaSdkException.ERROR_MESSAGES = {
+    CONFIG_ERROR: "Invalid configuration provided",
+    AUTH_FAILED: "Authentication failed. Please check your API key",
+    RATE_LIMITED: "Rate limit exceeded. Please try again later",
+    NETWORK_ERROR: "Network error occurred",
+    SERVER_ERROR: "Server error occurred",
+    PARSE_ERROR: "Failed to parse response",
+    BAD_REQUEST: "Bad request",
+    ABORTED: "Aborted",
+    NOT_FOUND: "Not found",
+    NO_WORKFLOW_ID: "Failed to start extraction process - no ID received",
+    WORKFLOW_CREATE_FAILED: "Failed to create workflow",
+    WORKFLOW_TIMEOUT: "Workflow processing timed out",
+    WORKFLOW_UNEXPECTED_STATUS: "Extraction completed with unexpected status",
+    PROGRESS_CHECK_FAILED: "Failed to check extraction progress",
+    DATA_FETCH_FAILED: "Failed to retrieve extracted data from workflow",
+    NO_URLS: "At least one URL is required for extraction",
+    NO_API_KEY: "API key is required for entity detection",
+    LINK_REQUIRED: "Link is required for entity field detection",
+    NO_PREDICTIONS: "No entity predictions returned from the API",
+    EXTRACTION_FAILED: "Data extraction failed for the provided URLs",
+    ENTITY_FETCH_FAILED: "Failed to fetch entity fields",
+    ENTITY_INVARIANT_VIOLATION: "No valid entity provided",
+    SCHEMA_NOT_FOUND: "Schema not found",
+    SCHEMA_FETCH_ERROR: "Failed to fetch schema",
+    SCHEMAS_FETCH_ERROR: "Failed to fetch schemas",
+    SCHEMA_CREATE_FAILED: "Failed to create schema",
+    SCHEMA_UPDATE_FAILED: "Failed to update schema",
+    SCHEMA_DELETE_FAILED: "Failed to delete schema",
+    VARIABLE_NOT_FOUND: "Variable not found",
+    VARIABLE_CREATE_FAILED: "Failed to create variable",
+    VARIABLE_UPDATE_FAILED: "Failed to update variable",
+    TEMPLATE_NOT_FOUND: "Template not found",
+    TEMPLATE_CREATE_FAILED: "Failed to create template",
+    TEMPLATE_UPDATE_FAILED: "Failed to update template",
+    TEMPLATE_VERSION_CREATE_FAILED: "Failed to create template version",
+    TEMPLATE_FROM_WORKFLOW_FAILED: "Failed to create template from workflow"
+  };
+  KadoaSdkException = _KadoaSdkException;
+  ERROR_MESSAGES = KadoaSdkException.ERROR_MESSAGES;
+  KadoaHttpException = class _KadoaHttpException extends KadoaSdkException {
+    constructor(message, options) {
+      super(message, {
+        code: options?.code,
+        details: options?.details,
+        cause: options?.cause
+      });
+      this.name = "KadoaHttpException";
+      this.httpStatus = options?.httpStatus;
+      this.requestId = options?.requestId;
+      this.endpoint = options?.endpoint;
+      this.method = options?.method;
+      this.responseBody = options?.responseBody;
+    }
+    static fromAxiosError(error48, extra) {
+      const status = error48.response?.status;
+      const requestId = error48.response?.headers?.["x-request-id"] || error48.response?.headers?.["x-amzn-requestid"];
+      const method = error48.config?.method?.toUpperCase();
+      const url3 = error48.config?.url;
+      return new _KadoaHttpException(extra?.message || error48.message, {
+        code: _KadoaHttpException.mapStatusToCode(error48),
+        httpStatus: status,
+        requestId,
+        endpoint: url3,
+        method,
+        responseBody: error48.response?.data,
+        details: extra?.details
+      });
+    }
+    toJSON() {
+      return {
+        ...super.toJSON(),
+        httpStatus: this.httpStatus,
+        requestId: this.requestId,
+        endpoint: this.endpoint,
+        method: this.method,
+        responseBody: this.responseBody
+      };
+    }
+    toDetailedString() {
+      const parts = [`${this.name}: ${this.message}`, `Code: ${this.code}`];
+      if (this.httpStatus) {
+        parts.push(`HTTP Status: ${this.httpStatus}`);
+      }
+      if (this.method && this.endpoint) {
+        parts.push(`Request: ${this.method} ${this.endpoint}`);
+      }
+      if (this.requestId) {
+        parts.push(`Request ID: ${this.requestId}`);
+      }
+      if (this.responseBody) {
+        parts.push(`Response Body: ${JSON.stringify(this.responseBody, null, 2)}`);
+      }
+      if (this.details && Object.keys(this.details).length > 0) {
+        parts.push(`Details: ${JSON.stringify(this.details, null, 2)}`);
+      }
+      if (this.cause) {
+        parts.push(`Cause: ${this.cause}`);
+      }
+      return parts.join(`
+`);
+    }
+    static wrap(error48, extra) {
+      if (error48 instanceof _KadoaHttpException)
+        return error48;
+      if (error48 instanceof KadoaSdkException)
+        return error48;
+      if (isAxiosError2(error48)) {
+        return _KadoaHttpException.fromAxiosError(error48, extra);
+      }
+      return KadoaSdkException.wrap(error48, extra);
+    }
+    static mapStatusToCode(errorOrStatus) {
+      const status = typeof errorOrStatus === "number" ? errorOrStatus : errorOrStatus.response?.status;
+      if (!status) {
+        if (typeof errorOrStatus === "number")
+          return "UNKNOWN";
+        return errorOrStatus.code === "ECONNABORTED" ? "TIMEOUT" : errorOrStatus.request ? "NETWORK_ERROR" : "UNKNOWN";
+      }
+      if (status === 401 || status === 403)
+        return "AUTH_ERROR";
+      if (status === 404)
+        return "NOT_FOUND";
+      if (status === 408)
+        return "TIMEOUT";
+      if (status === 429)
+        return "RATE_LIMITED";
+      if (status >= 400 && status < 500)
+        return "VALIDATION_ERROR";
+      if (status >= 500)
+        return "HTTP_ERROR";
+      return "UNKNOWN";
+    }
+  };
+  logger = {
+    changes: createLogger("changes"),
+    client: createLogger("client"),
+    wss: createLogger("wss"),
+    extraction: createLogger("extraction"),
+    http: createLogger("http"),
+    workflow: createLogger("workflow"),
+    crawl: createLogger("crawl"),
+    notifications: createLogger("notifications"),
+    schemas: createLogger("schemas"),
+    validation: createLogger("validation"),
+    templates: createLogger("templates"),
+    variables: createLogger("variables")
+  };
+  debug = logger.changes;
   BASE_PATH = "https://api.kadoa.com".replace(/\/+$/, "");
   RequiredError = class extends Error {
     constructor(field, msg) {
@@ -49636,215 +49963,6 @@ var init_dist2 = __esm(() => {
     Text: DataFieldDataTypeEnum.String,
     Url: DataFieldDataTypeEnum.Link
   };
-  KadoaErrorCode = {
-    VALIDATION_ERROR: "VALIDATION_ERROR",
-    BAD_REQUEST: "BAD_REQUEST",
-    NOT_FOUND: "NOT_FOUND",
-    INTERNAL_ERROR: "INTERNAL_ERROR"
-  };
-  _KadoaSdkException = class _KadoaSdkException2 extends Error {
-    constructor(message, options) {
-      super(message);
-      this.name = "KadoaSdkException";
-      this.code = options?.code ?? "UNKNOWN";
-      this.details = options?.details;
-      if (options && "cause" in options)
-        this.cause = options.cause;
-      Error.captureStackTrace?.(this, _KadoaSdkException2);
-    }
-    static from(error48, details) {
-      if (error48 instanceof _KadoaSdkException2)
-        return error48;
-      const message = error48 instanceof Error ? error48.message : typeof error48 === "string" ? error48 : "Unexpected error";
-      return new _KadoaSdkException2(message, {
-        code: "UNKNOWN",
-        details,
-        cause: error48
-      });
-    }
-    toJSON() {
-      return {
-        name: this.name,
-        message: this.message,
-        code: this.code,
-        details: this.details
-      };
-    }
-    toString() {
-      return [this.name, this.code, this.message].filter(Boolean).join(": ");
-    }
-    toDetailedString() {
-      const parts = [`${this.name}: ${this.message}`, `Code: ${this.code}`];
-      if (this.details && Object.keys(this.details).length > 0) {
-        parts.push(`Details: ${JSON.stringify(this.details, null, 2)}`);
-      }
-      if (this.cause) {
-        parts.push(`Cause: ${this.cause}`);
-      }
-      return parts.join(`
-`);
-    }
-    static isInstance(error48) {
-      return error48 instanceof _KadoaSdkException2;
-    }
-    static wrap(error48, extra) {
-      if (error48 instanceof _KadoaSdkException2)
-        return error48;
-      const message = extra?.message || (error48 instanceof Error ? error48.message : typeof error48 === "string" ? error48 : "Unexpected error");
-      return new _KadoaSdkException2(message, {
-        code: "UNKNOWN",
-        details: extra?.details,
-        cause: error48
-      });
-    }
-  };
-  _KadoaSdkException.ERROR_MESSAGES = {
-    CONFIG_ERROR: "Invalid configuration provided",
-    AUTH_FAILED: "Authentication failed. Please check your API key",
-    RATE_LIMITED: "Rate limit exceeded. Please try again later",
-    NETWORK_ERROR: "Network error occurred",
-    SERVER_ERROR: "Server error occurred",
-    PARSE_ERROR: "Failed to parse response",
-    BAD_REQUEST: "Bad request",
-    ABORTED: "Aborted",
-    NOT_FOUND: "Not found",
-    NO_WORKFLOW_ID: "Failed to start extraction process - no ID received",
-    WORKFLOW_CREATE_FAILED: "Failed to create workflow",
-    WORKFLOW_TIMEOUT: "Workflow processing timed out",
-    WORKFLOW_UNEXPECTED_STATUS: "Extraction completed with unexpected status",
-    PROGRESS_CHECK_FAILED: "Failed to check extraction progress",
-    DATA_FETCH_FAILED: "Failed to retrieve extracted data from workflow",
-    NO_URLS: "At least one URL is required for extraction",
-    NO_API_KEY: "API key is required for entity detection",
-    LINK_REQUIRED: "Link is required for entity field detection",
-    NO_PREDICTIONS: "No entity predictions returned from the API",
-    EXTRACTION_FAILED: "Data extraction failed for the provided URLs",
-    ENTITY_FETCH_FAILED: "Failed to fetch entity fields",
-    ENTITY_INVARIANT_VIOLATION: "No valid entity provided",
-    SCHEMA_NOT_FOUND: "Schema not found",
-    SCHEMA_FETCH_ERROR: "Failed to fetch schema",
-    SCHEMAS_FETCH_ERROR: "Failed to fetch schemas",
-    SCHEMA_CREATE_FAILED: "Failed to create schema",
-    SCHEMA_UPDATE_FAILED: "Failed to update schema",
-    SCHEMA_DELETE_FAILED: "Failed to delete schema",
-    VARIABLE_NOT_FOUND: "Variable not found",
-    VARIABLE_CREATE_FAILED: "Failed to create variable",
-    VARIABLE_UPDATE_FAILED: "Failed to update variable",
-    TEMPLATE_NOT_FOUND: "Template not found",
-    TEMPLATE_CREATE_FAILED: "Failed to create template",
-    TEMPLATE_UPDATE_FAILED: "Failed to update template",
-    TEMPLATE_VERSION_CREATE_FAILED: "Failed to create template version",
-    TEMPLATE_FROM_WORKFLOW_FAILED: "Failed to create template from workflow"
-  };
-  KadoaSdkException = _KadoaSdkException;
-  ERROR_MESSAGES = KadoaSdkException.ERROR_MESSAGES;
-  KadoaHttpException = class _KadoaHttpException extends KadoaSdkException {
-    constructor(message, options) {
-      super(message, {
-        code: options?.code,
-        details: options?.details,
-        cause: options?.cause
-      });
-      this.name = "KadoaHttpException";
-      this.httpStatus = options?.httpStatus;
-      this.requestId = options?.requestId;
-      this.endpoint = options?.endpoint;
-      this.method = options?.method;
-      this.responseBody = options?.responseBody;
-    }
-    static fromAxiosError(error48, extra) {
-      const status = error48.response?.status;
-      const requestId = error48.response?.headers?.["x-request-id"] || error48.response?.headers?.["x-amzn-requestid"];
-      const method = error48.config?.method?.toUpperCase();
-      const url3 = error48.config?.url;
-      return new _KadoaHttpException(extra?.message || error48.message, {
-        code: _KadoaHttpException.mapStatusToCode(error48),
-        httpStatus: status,
-        requestId,
-        endpoint: url3,
-        method,
-        responseBody: error48.response?.data,
-        details: extra?.details
-      });
-    }
-    toJSON() {
-      return {
-        ...super.toJSON(),
-        httpStatus: this.httpStatus,
-        requestId: this.requestId,
-        endpoint: this.endpoint,
-        method: this.method,
-        responseBody: this.responseBody
-      };
-    }
-    toDetailedString() {
-      const parts = [`${this.name}: ${this.message}`, `Code: ${this.code}`];
-      if (this.httpStatus) {
-        parts.push(`HTTP Status: ${this.httpStatus}`);
-      }
-      if (this.method && this.endpoint) {
-        parts.push(`Request: ${this.method} ${this.endpoint}`);
-      }
-      if (this.requestId) {
-        parts.push(`Request ID: ${this.requestId}`);
-      }
-      if (this.responseBody) {
-        parts.push(`Response Body: ${JSON.stringify(this.responseBody, null, 2)}`);
-      }
-      if (this.details && Object.keys(this.details).length > 0) {
-        parts.push(`Details: ${JSON.stringify(this.details, null, 2)}`);
-      }
-      if (this.cause) {
-        parts.push(`Cause: ${this.cause}`);
-      }
-      return parts.join(`
-`);
-    }
-    static wrap(error48, extra) {
-      if (error48 instanceof _KadoaHttpException)
-        return error48;
-      if (error48 instanceof KadoaSdkException)
-        return error48;
-      if (isAxiosError2(error48)) {
-        return _KadoaHttpException.fromAxiosError(error48, extra);
-      }
-      return KadoaSdkException.wrap(error48, extra);
-    }
-    static mapStatusToCode(errorOrStatus) {
-      const status = typeof errorOrStatus === "number" ? errorOrStatus : errorOrStatus.response?.status;
-      if (!status) {
-        if (typeof errorOrStatus === "number")
-          return "UNKNOWN";
-        return errorOrStatus.code === "ECONNABORTED" ? "TIMEOUT" : errorOrStatus.request ? "NETWORK_ERROR" : "UNKNOWN";
-      }
-      if (status === 401 || status === 403)
-        return "AUTH_ERROR";
-      if (status === 404)
-        return "NOT_FOUND";
-      if (status === 408)
-        return "TIMEOUT";
-      if (status === 429)
-        return "RATE_LIMITED";
-      if (status >= 400 && status < 500)
-        return "VALIDATION_ERROR";
-      if (status >= 500)
-        return "HTTP_ERROR";
-      return "UNKNOWN";
-    }
-  };
-  logger = {
-    client: createLogger("client"),
-    wss: createLogger("wss"),
-    extraction: createLogger("extraction"),
-    http: createLogger("http"),
-    workflow: createLogger("workflow"),
-    crawl: createLogger("crawl"),
-    notifications: createLogger("notifications"),
-    schemas: createLogger("schemas"),
-    validation: createLogger("validation"),
-    templates: createLogger("templates"),
-    variables: createLogger("variables")
-  };
   _SchemaBuilder.FIELD_NAME_PATTERN = /^[A-Za-z0-9]+$/;
   _SchemaBuilder.TYPES_REQUIRING_EXAMPLE = [
     "STRING",
@@ -49854,8 +49972,8 @@ var init_dist2 = __esm(() => {
     "ARRAY"
   ];
   SchemaBuilder = _SchemaBuilder;
-  debug = logger.schemas;
-  debug2 = logger.extraction;
+  debug2 = logger.schemas;
+  debug3 = logger.extraction;
   SUCCESSFUL_RUN_STATES = /* @__PURE__ */ new Set(["FINISHED", "SUCCESS"]);
   DEFAULT_OPTIONS = {
     mode: "run",
@@ -49866,7 +49984,7 @@ var init_dist2 = __esm(() => {
     bypassPreview: true,
     autoStart: true
   };
-  debug3 = logger.extraction;
+  debug4 = logger.extraction;
   NotificationChannelType = {
     EMAIL: "EMAIL",
     SLACK: "SLACK",
@@ -49876,19 +49994,19 @@ var init_dist2 = __esm(() => {
   EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
   _NotificationChannelsService.DEFAULT_CHANNEL_NAME = "default";
   NotificationChannelsService = _NotificationChannelsService;
-  debug4 = logger.notifications;
+  debug5 = logger.notifications;
   PUBLIC_API_URI = process.env.KADOA_PUBLIC_API_URI ?? "https://api.kadoa.com";
   WSS_API_URI = process.env.KADOA_WSS_API_URI ?? "wss://realtime.kadoa.com";
   process.env.KADOA_WSS_NEO_API_URI;
   REALTIME_API_URI = process.env.KADOA_REALTIME_API_URI ?? "https://realtime.kadoa.com";
-  debug5 = logger.wss;
+  debug6 = logger.wss;
   if (typeof WebSocket === "undefined") {
     global.WebSocket = __require2("ws");
   }
   _Realtime.DEFAULT_RECONNECT_DELAY_MS = 5000;
   _Realtime.MAX_RECONNECT_DELAY_MS = 60000;
   Realtime = _Realtime;
-  debug6 = logger.templates;
+  debug7 = logger.templates;
   DEFAULT_POLLING_OPTIONS = {
     pollIntervalMs: 1e4,
     timeoutMs: 5 * 60 * 1000
@@ -49897,7 +50015,7 @@ var init_dist2 = __esm(() => {
     ABORTED: "ABORTED",
     TIMEOUT: "TIMEOUT"
   };
-  debug7 = logger.variables;
+  debug8 = logger.variables;
   JobStateEnum = {
     Finished: "FINISHED",
     Failed: "FAILED",
@@ -49918,7 +50036,7 @@ var init_dist2 = __esm(() => {
     "STOPPED",
     "CANCELLED"
   ]);
-  debug8 = logger.workflow;
+  debug9 = logger.workflow;
 });
 
 // src/client.ts
@@ -50608,6 +50726,56 @@ function registerTools(server, ctx) {
       total: data.pagination?.totalCount || data.data.length
     });
   }));
+  server.registerTool("list_changes", {
+    description: "List detected data changes across one or more real-time monitoring workflows. " + "Returns structured diffs showing added, removed, and changed records. " + "Only works for workflows with real-time monitoring enabled.",
+    inputSchema: {
+      workflowIds: exports_external.preprocess(coerceArray(true), exports_external.array(exports_external.string())).optional().describe("Workflow IDs to filter by. If omitted, returns changes for all ACTIVE monitoring workflows."),
+      startDate: exports_external.string().optional().describe("Start date filter (ISO format, e.g. 2025-01-01)"),
+      endDate: exports_external.string().optional().describe("End date filter (ISO format, e.g. 2025-12-31)"),
+      skip: exports_external.preprocess(coerceNumber(), exports_external.number()).optional().describe("Number of records to skip for pagination"),
+      limit: exports_external.preprocess(coerceNumber(), exports_external.number()).optional().describe("Maximum number of changes to return")
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true }
+  }, withErrorHandling("list_changes", async (args) => {
+    const result = await ctx.client.changes.list({
+      workflowIds: args.workflowIds?.join(","),
+      startDate: args.startDate,
+      endDate: args.endDate,
+      skip: args.skip,
+      limit: args.limit ?? 25
+    });
+    return jsonResult({
+      changes: result.changes.map((c) => ({
+        id: c.id,
+        workflowId: c.workflowId,
+        url: c.url,
+        summary: c.summary,
+        differences: c.differences,
+        createdAt: c.createdAt
+      })),
+      pagination: result.pagination,
+      changesCount: result.changesCount
+    });
+  }));
+  server.registerTool("get_change", {
+    description: "Get detailed information about a specific detected change, including the full data snapshot and diff.",
+    inputSchema: {
+      changeId: exports_external.string().describe("The change ID")
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true }
+  }, withErrorHandling("get_change", async (args) => {
+    const change = await ctx.client.changes.get(args.changeId);
+    return jsonResult({
+      id: change.id,
+      workflowId: change.workflowId,
+      url: change.url,
+      summary: change.summary,
+      screenshotUrl: change.screenshotUrl,
+      data: change.data,
+      differences: change.differences,
+      createdAt: change.createdAt
+    });
+  }));
   server.registerTool("delete_workflow", {
     description: "Delete a workflow permanently. This is irreversible. " + "You MUST first call this tool without confirmed=true to preview what will be deleted, " + "then show the user the workflow name and ask for confirmation, " + "then call again with confirmed=true only after the user explicitly agrees.",
     inputSchema: {
@@ -51335,7 +51503,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kadoa/mcp",
-    version: "0.4.2",
+    version: "0.4.3-rc.1",
     description: "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
     type: "module",
     main: "dist/index.js",
@@ -51359,7 +51527,7 @@ var init_package = __esm(() => {
       prepublishOnly: "bun run check-types && bun run test:unit && bun run build"
     },
     dependencies: {
-      "@kadoa/node-sdk": "^0.26.0",
+      "@kadoa/node-sdk": "^0.27.0",
       "@modelcontextprotocol/sdk": "^1.26.0",
       express: "^5.2.1",
       ioredis: "^5.6.1",
@@ -56586,6 +56754,7 @@ function createServer(auth) {
       "Workflow lifecycle: create_workflow \u2192 get_workflow (check status) \u2192 fetch_data (get results). Workflows run asynchronously \u2014 never poll or sleep-wait.",
       "",
       "Use create_realtime_monitor only when the user wants continuous change detection with alerts. For one-time or scheduled extraction, use create_workflow.",
+      "Use list_changes and get_change to retrieve detected diffs from real-time monitoring workflows.",
       "",
       "Schema tips: Use descriptive field names and examples. Group related data under one entity.",
       "The AI agent uses the schema + prompt to understand what to extract \u2014 a detailed prompt with a comprehensive schema produces better results than multiple simple workflows."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kadoa/mcp",
-  "version": "0.4.2",
+  "version": "0.4.3-rc.1",
   "description": "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
   "type": "module",
   "main": "dist/index.js",
@@ -24,7 +24,7 @@
     "prepublishOnly": "bun run check-types && bun run test:unit && bun run build"
   },
   "dependencies": {
-    "@kadoa/node-sdk": "^0.26.0",
+    "@kadoa/node-sdk": "^0.27.0",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "express": "^5.2.1",
     "ioredis": "^5.6.1",