@kadoa/mcp 0.4.2 → 0.4.3-rc.2

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;
@@ -43948,6 +44032,40 @@ function createCrawlerDomain(client) {
     session: new CrawlerSessionService(client)
   };
 }
+function getFieldName(field) {
+  return "name" in field && typeof field.name === "string" ? field.name : undefined;
+}
+function buildAgenticPrompt(params) {
+  if (params.userPrompt) {
+    return params.userPrompt;
+  }
+  const fieldNames = params.fields.map((field) => getFieldName(field)).filter((name) => Boolean(name));
+  if (fieldNames.length === 0) {
+    return DEFAULT_AGENTIC_PROMPT;
+  }
+  const fieldList = fieldNames.join(", ");
+  if (params.entity) {
+    return `extract all ${params.entity} entities from this page and return these fields: ${fieldList}`;
+  }
+  return `extract all records from this page and return these fields: ${fieldList}`;
+}
+function getFieldName2(field) {
+  return "name" in field && typeof field.name === "string" ? field.name : undefined;
+}
+function buildAgenticPrompt2(params) {
+  if (params.userPrompt) {
+    return params.userPrompt;
+  }
+  const fieldNames = params.fields.map((field) => getFieldName2(field)).filter((name) => Boolean(name));
+  if (fieldNames.length === 0) {
+    return DEFAULT_AGENTIC_PROMPT2;
+  }
+  const fieldList = fieldNames.join(", ");
+  if (params.entity) {
+    return `extract all ${params.entity} entities from this page and return these fields: ${fieldList}`;
+  }
+  return `extract all records from this page and return these fields: ${fieldList}`;
+}
 function validateEmailChannelConfig(config2) {
   const issues = [];
   if (!config2.recipients?.length) {
@@ -44105,11 +44223,11 @@ 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);
   const settingsService = new NotificationSettingsService(client.apis.notifications);
-  const entityResolverService = new EntityResolverService(client);
   const workflowsCoreService = new WorkflowsCoreService(client.apis.workflows);
   const schemasService = new SchemasService(client);
   const templatesService = new TemplatesService(client);
@@ -44117,8 +44235,8 @@ function createClientDomains(params) {
   const channelSetupService = new NotificationSetupService(channelsService, settingsService);
   const coreService = new ValidationCoreService(client);
   const rulesService = new ValidationRulesService(client);
-  const extractionService = new ExtractionService(workflowsCoreService, dataFetcherService, entityResolverService, channelSetupService, channelsService, settingsService);
-  const extractionBuilderService = new ExtractionBuilderService(workflowsCoreService, entityResolverService, dataFetcherService, channelSetupService);
+  const extractionService = new ExtractionService(workflowsCoreService, dataFetcherService, channelSetupService, channelsService, settingsService);
+  const extractionBuilderService = new ExtractionBuilderService(workflowsCoreService, dataFetcherService, channelSetupService);
   const notification = createNotificationDomain({
     notificationsApi: client.apis.notifications,
     channelsService,
@@ -44128,6 +44246,7 @@ function createClientDomains(params) {
   const validation = createValidationDomain(coreService, rulesService);
   const crawler = createCrawlerDomain(client);
   return {
+    changes: changesService,
     extractionBuilderService,
     extraction: extractionService,
     workflow: workflowsCoreService,
@@ -44177,7 +44296,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,12 +47404,19 @@ 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 {
+}, RAW_HELPER_FIELD_CONFIG, _SchemaBuilder = class _SchemaBuilder2 {
   constructor() {
     this.fields = [];
   }
-  hasSchemaFields() {
-    return this.fields.some((field) => field.fieldType === "SCHEMA");
+  isRawHelperField(field) {
+    return field.fieldType === "SCHEMA" && field.name in {
+      rawHtml: true,
+      rawMarkdown: true,
+      rawPageUrl: true
+    };
+  }
+  hasEntityRequiringSchemaFields() {
+    return this.fields.some((field) => field.fieldType === "SCHEMA" && !this.isRawHelperField(field));
   }
   entity(entityName) {
     this.entityName = entityName;
@@ -47302,20 +47452,23 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     const names = Array.isArray(name) ? name : [name];
     for (const name2 of names) {
       const fieldName = `raw${upperFirst(camelCase(name2))}`;
+      const rawKey = name2.toUpperCase();
+      const config2 = RAW_HELPER_FIELD_CONFIG[rawKey];
       if (this.fields.some((field) => field.name === fieldName)) {
         continue;
       }
       this.fields.push({
         name: fieldName,
-        description: `Raw page content in ${name2.toUpperCase()} format`,
-        fieldType: "METADATA",
-        metadataKey: name2
+        description: config2.description,
+        fieldType: "SCHEMA",
+        dataType: config2.dataType,
+        example: config2.example
       });
     }
     return this;
   }
   build() {
-    if (this.hasSchemaFields() && !this.entityName) {
+    if (this.hasEntityRequiringSchemaFields() && !this.entityName) {
       throw new KadoaSdkException("Entity name is required when schema fields are present", {
         code: "VALIDATION_ERROR",
         details: { entityName: this.entityName }
@@ -47341,7 +47494,7 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
       });
     }
   }
-}, SchemaBuilder, debug, SchemasService = class {
+}, SchemaBuilder, debug2, SchemasService = class {
   constructor(client) {
     this.client = client;
   }
@@ -47376,7 +47529,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 +47547,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 +47560,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,93 +47568,15 @@ 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
     });
   }
-}, ENTITY_API_ENDPOINT = "/v4/entity", EntityResolverService = class {
-  constructor(client) {
-    this.client = client;
-    this.schemasService = new SchemasService(client);
-  }
-  async resolveEntity(entityConfig, options) {
-    if (entityConfig === "ai-detection") {
-      if (!options?.link) {
-        throw new KadoaSdkException(ERROR_MESSAGES.LINK_REQUIRED, {
-          code: "VALIDATION_ERROR",
-          details: { entityConfig, options }
-        });
-      }
-      const entityPrediction = await this.fetchEntityFields({
-        link: options.link,
-        location: options.location,
-        navigationMode: options.navigationMode,
-        selectorMode: options.selectorMode ?? false
-      });
-      const entity = entityPrediction.entity;
-      return {
-        entity,
-        fields: entityPrediction.fields
-      };
-    } else if (entityConfig) {
-      if ("schemaId" in entityConfig) {
-        const schema = await this.schemasService.getSchema(entityConfig.schemaId);
-        return {
-          entity: schema.entity ?? undefined,
-          fields: schema.schema
-        };
-      } else if ("fields" in entityConfig) {
-        return {
-          entity: entityConfig.name,
-          fields: entityConfig.fields
-        };
-      }
-    }
-    throw new KadoaSdkException(ERROR_MESSAGES.ENTITY_INVARIANT_VIOLATION, {
-      details: {
-        entity: entityConfig
-      }
-    });
-  }
-  async fetchEntityFields(options) {
-    this.validateEntityOptions(options);
-    const url3 = `${this.client.baseUrl}${ENTITY_API_ENDPOINT}`;
-    const requestBody = options;
-    const response = await this.client.axiosInstance.post(url3, requestBody, {
-      headers: {
-        "Content-Type": "application/json",
-        Accept: "application/json",
-        "x-api-key": this.client.apiKey
-      }
-    });
-    const data = response.data;
-    if (!data.success || !data.entityPrediction || data.entityPrediction.length === 0) {
-      throw new KadoaSdkException(ERROR_MESSAGES.NO_PREDICTIONS, {
-        code: "NOT_FOUND",
-        details: {
-          success: data.success,
-          hasPredictions: !!data.entityPrediction,
-          predictionCount: data.entityPrediction?.length || 0,
-          link: options.link
-        }
-      });
-    }
-    return data.entityPrediction[0];
-  }
-  validateEntityOptions(options) {
-    if (!options.link) {
-      throw new KadoaSdkException(ERROR_MESSAGES.LINK_REQUIRED, {
-        code: "VALIDATION_ERROR",
-        details: { options }
-      });
-    }
-  }
-}, debug2, SUCCESSFUL_RUN_STATES, DEFAULT_OPTIONS, ExtractionService = class {
-  constructor(workflowsCoreService, dataFetcherService, entityResolverService, notificationSetupService, notificationChannelsService, notificationSettingsService) {
+}, debug3, SUCCESSFUL_RUN_STATES, DEFAULT_AGENTIC_PROMPT = "extract all the data for the main entity of this page", DEFAULT_OPTIONS, ExtractionService = class {
+  constructor(workflowsCoreService, dataFetcherService, notificationSetupService, notificationChannelsService, notificationSettingsService) {
     this.workflowsCoreService = workflowsCoreService;
     this.dataFetcherService = dataFetcherService;
-    this.entityResolverService = entityResolverService;
     this.notificationSetupService = notificationSetupService;
     this.notificationChannelsService = notificationChannelsService;
     this.notificationSettingsService = notificationSettingsService;
@@ -47536,7 +47611,9 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
   }
   async executeExtraction(options) {
     this.validateOptions(options);
-    const config2 = merge3(DEFAULT_OPTIONS, options);
+    const config2 = {
+      ...merge3(DEFAULT_OPTIONS, options)
+    };
     const isRealTime = config2.interval === "REAL_TIME";
     if (isRealTime) {
       throw new KadoaSdkException("extraction.run()/submit() are not supported for real-time workflows. Use the builder API, call waitForReady(), and subscribe via client.realtime.onEvent(...).", {
@@ -47547,35 +47624,23 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
       });
     }
     let workflowId;
-    const isAgenticNavigation = config2.navigationMode === "agentic-navigation";
-    if (isAgenticNavigation) {
-      if (!config2.userPrompt) {
-        throw new KadoaSdkException("userPrompt is required when navigationMode is 'agentic-navigation'", {
-          code: "VALIDATION_ERROR",
-          details: { navigationMode: config2.navigationMode }
-        });
-      }
-    }
-    let resolvedEntity;
-    if (isAgenticNavigation) {
-      const entityConfig = options.entity || "ai-detection";
-      resolvedEntity = {
-        entity: typeof entityConfig === "object" && "name" in entityConfig ? entityConfig.name : undefined,
-        fields: typeof entityConfig === "object" && "fields" in entityConfig ? entityConfig.fields : []
-      };
-    } else {
-      resolvedEntity = await this.entityResolverService.resolveEntity(options.entity || "ai-detection", {
-        link: config2.urls[0],
-        location: config2.location,
-        navigationMode: config2.navigationMode
-      });
-    }
+    const entityConfig = options.entity;
+    const resolvedEntity = {
+      entity: typeof entityConfig === "object" && "name" in entityConfig ? entityConfig.name : undefined,
+      fields: typeof entityConfig === "object" && "fields" in entityConfig ? entityConfig.fields : []
+    };
     const hasNotifications = !!config2.notifications;
+    const userPrompt = buildAgenticPrompt({
+      entity: resolvedEntity.entity,
+      fields: resolvedEntity.fields,
+      userPrompt: config2.userPrompt
+    });
     const workflowRequest = {
       ...config2,
+      navigationMode: "agentic-navigation",
       fields: resolvedEntity.fields,
       ...resolvedEntity.entity !== undefined ? { entity: resolvedEntity.entity } : {},
-      ...config2.userPrompt ? { userPrompt: config2.userPrompt } : {}
+      userPrompt
     };
     const result = await this.workflowsCoreService.create(workflowRequest);
     workflowId = result.id;
@@ -47585,7 +47650,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,10 +47725,9 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
   isExtractionSuccessful(runState) {
     return runState ? SUCCESSFUL_RUN_STATES.has(runState.toUpperCase()) : false;
   }
-}, debug3, ExtractionBuilderService = class {
-  constructor(workflowsCoreService, entityResolverService, dataFetcherService, notificationSetupService) {
+}, debug4, DEFAULT_AGENTIC_PROMPT2 = "extract all the data for the main entity of this page", BUILD_NOT_READY_ERROR = "No completed build. Build the project first.", TERMINAL_RUN_STATES, ExtractionBuilderService = class {
+  constructor(workflowsCoreService, dataFetcherService, notificationSetupService) {
     this.workflowsCoreService = workflowsCoreService;
-    this.entityResolverService = entityResolverService;
     this.dataFetcherService = dataFetcherService;
     this.notificationSetupService = notificationSetupService;
   }
@@ -47689,7 +47753,6 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     urls,
     name,
     description,
-    navigationMode,
     extraction,
     additionalData,
     bypassPreview,
@@ -47699,23 +47762,22 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
     location
   }) {
     let entity = "ai-detection";
+    let builtFields = [];
     if (extraction) {
       const result = extraction(new SchemaBuilder);
       if ("schemaId" in result) {
         entity = { schemaId: result.schemaId };
       } else {
         const builtSchema = result.build();
-        entity = builtSchema.entityName ? { name: builtSchema.entityName, fields: builtSchema.fields } : { fields: builtSchema.fields };
+        builtFields = builtSchema.fields;
+        entity = builtSchema.entityName ? { name: builtSchema.entityName, fields: builtFields } : { fields: builtFields };
       }
     }
-    if (userPrompt) {
-      this._userPrompt = userPrompt;
-    }
+    this._userPrompt = userPrompt;
     this._options = {
       urls,
       name,
       description,
-      navigationMode: navigationMode || "single-page",
       entity,
       bypassPreview: bypassPreview ?? false,
       additionalData,
@@ -47762,41 +47824,27 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
   }
   async create() {
     assert2(this._options, "Options are not set");
-    const { urls, name, description, navigationMode, entity } = this.options;
-    const isAgenticNavigation = navigationMode === "agentic-navigation";
-    if (isAgenticNavigation) {
-      if (!this._userPrompt) {
-        throw new KadoaSdkException("userPrompt is required when navigationMode is 'agentic-navigation'", {
-          code: "VALIDATION_ERROR",
-          details: { navigationMode }
-        });
-      }
-    }
-    const isRealTime = this._options.interval === "REAL_TIME";
-    const useSelectorMode = isRealTime && entity === "ai-detection";
-    let resolvedEntity;
-    if (isAgenticNavigation) {
-      resolvedEntity = {
-        entity: typeof entity === "object" && "name" in entity ? entity.name : undefined,
-        fields: typeof entity === "object" && "fields" in entity ? entity.fields : []
-      };
-    } else {
-      resolvedEntity = await this.entityResolverService.resolveEntity(entity, {
-        link: urls[0],
-        location: this._options.location,
-        navigationMode,
-        selectorMode: useSelectorMode
-      });
-    }
-    const hasSchemaId = typeof entity === "object" && "schemaId" in entity && entity.schemaId;
+    const { urls, name, description, entity } = this.options;
+    const resolvedEntity = {
+      entity: typeof entity === "object" && "name" in entity ? entity.name : undefined,
+      fields: typeof entity === "object" && "fields" in entity ? entity.fields : []
+    };
+    this._userPrompt = buildAgenticPrompt2({
+      entity: resolvedEntity.entity,
+      fields: resolvedEntity.fields,
+      userPrompt: this._userPrompt
+    });
+    this._options.userPrompt = this._userPrompt;
+    const schemaId = typeof entity === "object" && "schemaId" in entity ? entity.schemaId : undefined;
+    const hasSchemaId = Boolean(schemaId);
     const workflow = await this.workflowsCoreService.create({
       urls,
       name,
       description,
-      navigationMode,
+      navigationMode: "agentic-navigation",
       monitoring: this._monitoringOptions,
       ...hasSchemaId ? {
-        schemaId: entity.schemaId,
+        schemaId,
         entity: resolvedEntity.entity,
         fields: resolvedEntity.fields
       } : { entity: resolvedEntity.entity, fields: resolvedEntity.fields },
@@ -47842,12 +47890,15 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
         }
       });
     }
-    const startedJob = await this.workflowsCoreService.runWorkflow(this._workflowId, { variables: options?.variables, limit: options?.limit });
+    const startedJob = await this.startOrReuseWorkflowRun(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) {
@@ -47862,9 +47913,12 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
         }
       });
     }
-    const submittedJob = await this.workflowsCoreService.runWorkflow(this._workflowId, { variables: options?.variables, limit: options?.limit });
+    const submittedJob = await this.startOrReuseWorkflowRun(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,
@@ -47891,6 +47945,60 @@ var import_debug, __require2, BASE_PATH, BaseAPI = class {
       ...options
     });
   }
+  async startOrReuseWorkflowRun(workflowId, input) {
+    const currentJob = await this.findActiveWorkflowJob(workflowId);
+    if (currentJob) {
+      debug4("Reusing active workflow job: %O", currentJob);
+      return currentJob;
+    }
+    try {
+      return await this.workflowsCoreService.runWorkflow(workflowId, input);
+    } catch (error48) {
+      if (!this.isBuildNotReadyError(error48)) {
+        throw error48;
+      }
+      const recoveredJob = await this.waitForWorkflowJob(workflowId);
+      if (recoveredJob) {
+        debug4("Recovered active workflow job after run rejection: %O", recoveredJob);
+        return recoveredJob;
+      }
+      throw error48;
+    }
+  }
+  async findActiveWorkflowJob(workflowId) {
+    const workflow = await this.workflowsCoreService.get(workflowId);
+    if (!workflow.jobId || !workflow.runState) {
+      return;
+    }
+    if (TERMINAL_RUN_STATES.has(workflow.runState.toUpperCase())) {
+      return;
+    }
+    return {
+      jobId: workflow.jobId,
+      status: workflow.runState,
+      message: "Workflow already has an active run"
+    };
+  }
+  async waitForWorkflowJob(workflowId) {
+    for (let attempt2 = 0;attempt2 < 5; attempt2 += 1) {
+      const currentJob = await this.findActiveWorkflowJob(workflowId);
+      if (currentJob) {
+        return currentJob;
+      }
+      await new Promise((resolve) => setTimeout(resolve, 1000));
+    }
+    return;
+  }
+  isBuildNotReadyError(error48) {
+    if (!(error48 instanceof KadoaHttpException)) {
+      return false;
+    }
+    const responseBody = error48.responseBody;
+    if (responseBody && typeof responseBody === "object" && "error" in responseBody && typeof responseBody.error === "string") {
+      return responseBody.error.includes(BUILD_NOT_READY_ERROR);
+    }
+    return typeof error48.message === "string" ? error48.message.includes(BUILD_NOT_READY_ERROR) : false;
+  }
 }, NotificationChannelType, EMAIL_REGEX, _NotificationChannelsService = class _NotificationChannelsService2 {
   constructor(notificationsApi, userService) {
     this.api = notificationsApi;
@@ -48048,7 +48156,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 +48181,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 +48189,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 +48216,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 +48273,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 +48281,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 +48302,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 +48315,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 +48325,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.28.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 +48353,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 +48390,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 +48455,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 +48463,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 +48486,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 +48510,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 +48535,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 +48566,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 +48574,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 +48583,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 +48592,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 +48600,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 +48653,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 +48661,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 +48680,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 +48693,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 +48708,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,45 +48729,14 @@ 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);
-    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);
-    const response = await this.templatesApi.v4TemplatesTemplateIdLinkPost({
-      templateId,
-      linkWorkflowsBody: body
-    });
-    return response.data;
-  }
-  async unlinkWorkflows(templateId, body) {
-    debug6("Unlinking %d workflows from template: %s", body.workflowIds.length, templateId);
-    const response = await this.templatesApi.v4TemplatesTemplateIdUnlinkPost({
-      templateId,
-      unlinkWorkflowsBody: body
-    });
-    return response.data;
-  }
-  async applyUpdate(templateId, body) {
-    debug6("Applying version %d to %d workflows for template: %s", body.targetVersion, body.workflowIds.length, templateId);
-    const response = await this.templatesApi.v4TemplatesTemplateIdApplyPost({
-      templateId,
-      applyTemplateUpdateBody: body
-    });
-    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 +48994,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 +49006,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 +49020,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 +49033,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 +49048,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_STATES2, debug9, WorkflowsCoreService = class {
   constructor(workflowsApi) {
     this.workflowsApi = workflowsApi;
   }
@@ -49092,13 +49169,13 @@ 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) {
         return true;
       }
-      if (current.runState && TERMINAL_RUN_STATES.has(current.runState.toUpperCase()) && current.state !== "QUEUED") {
+      if (current.runState && TERMINAL_RUN_STATES2.has(current.runState.toUpperCase()) && current.state !== "QUEUED") {
         return true;
       }
       return false;
@@ -49138,7 +49215,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 +49288,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,69 +49378,285 @@ var init_dist2 = __esm(() => {
       return __require.apply(this, arguments);
     throw Error('Dynamic require of "' + x + '" is not supported');
   });
-  BASE_PATH = "https://api.kadoa.com".replace(/\/+$/, "");
-  RequiredError = class extends Error {
-    constructor(field, msg) {
-      super(msg);
-      this.field = field;
-      this.name = "RequiredError";
-    }
+  ChangeDifferenceType = {
+    Added: "added",
+    Removed: "removed",
+    Changed: "changed"
   };
-  operationServerMap = {};
-  CrawlerApi = class extends BaseAPI {
-    v4CrawlBucketDataFilenameb64Get(requestParameters, options) {
-      return CrawlerApiFp(this.configuration).v4CrawlBucketDataFilenameb64Get(requestParameters.filenameb64, requestParameters.contentType, requestParameters.cacheControl, options).then((request) => request(this.axios, this.basePath));
-    }
-    v4CrawlConfigConfigIdGet(requestParameters, options) {
-      return CrawlerApiFp(this.configuration).v4CrawlConfigConfigIdGet(requestParameters.configId, options).then((request) => request(this.axios, this.basePath));
-    }
-    v4CrawlConfigDelete(requestParameters = {}, options) {
-      return CrawlerApiFp(this.configuration).v4CrawlConfigDelete(requestParameters.deleteCrawlerConfigRequest, options).then((request) => request(this.axios, this.basePath));
-    }
-    v4CrawlConfigPost(requestParameters = {}, options) {
-      return CrawlerApiFp(this.configuration).v4CrawlConfigPost(requestParameters.createCrawlerConfigRequest, options).then((request) => request(this.axios, this.basePath));
-    }
-    v4CrawlPausePost(requestParameters = {}, options) {
-      return CrawlerApiFp(this.configuration).v4CrawlPausePost(requestParameters.pauseCrawlerSessionRequest, options).then((request) => request(this.axios, this.basePath));
-    }
-    v4CrawlPost(requestParameters = {}, options) {
-      return CrawlerApiFp(this.configuration).v4CrawlPost(requestParameters.startCrawlerSessionRequest, options).then((request) => request(this.axios, this.basePath));
-    }
-    v4CrawlResumePost(requestParameters = {}, options) {
-      return CrawlerApiFp(this.configuration).v4CrawlResumePost(requestParameters.resumeCrawlerSessionRequest, options).then((request) => request(this.axios, this.basePath));
+  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);
     }
-    v4CrawlSessionIdListGet(requestParameters, options) {
-      return CrawlerApiFp(this.configuration).v4CrawlSessionIdListGet(requestParameters.sessionId, requestParameters.includeAll, options).then((request) => request(this.axios, this.basePath));
+    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
+      });
     }
-    v4CrawlSessionIdPagesGet(requestParameters, options) {
-      return CrawlerApiFp(this.configuration).v4CrawlSessionIdPagesGet(requestParameters.sessionId, requestParameters.currentPage, requestParameters.pageSize, options).then((request) => request(this.axios, this.basePath));
+    toJSON() {
+      return {
+        name: this.name,
+        message: this.message,
+        code: this.code,
+        details: this.details
+      };
     }
-    v4CrawlSessionIdPagesPageIdGet(requestParameters, options) {
-      return CrawlerApiFp(this.configuration).v4CrawlSessionIdPagesPageIdGet(requestParameters.sessionId, requestParameters.pageId, requestParameters.format, options).then((request) => request(this.axios, this.basePath));
+    toString() {
+      return [this.name, this.code, this.message].filter(Boolean).join(": ");
     }
-    v4CrawlSessionIdStatusGet(requestParameters, options) {
-      return CrawlerApiFp(this.configuration).v4CrawlSessionIdStatusGet(requestParameters.sessionId, options).then((request) => request(this.axios, this.basePath));
+    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(`
+`);
     }
-    v4CrawlSessionsGet(requestParameters = {}, options) {
-      return CrawlerApiFp(this.configuration).v4CrawlSessionsGet(requestParameters.page, requestParameters.pageSize, requestParameters.userId, options).then((request) => request(this.axios, this.basePath));
+    static isInstance(error48) {
+      return error48 instanceof _KadoaSdkException2;
     }
-    v4CrawlStartPost(requestParameters = {}, options) {
-      return CrawlerApiFp(this.configuration).v4CrawlStartPost(requestParameters.startSessionWithConfigRequest, options).then((request) => request(this.axios, this.basePath));
+    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
+      });
     }
   };
-  DataValidationApi = class extends BaseAPI {
-    v4DataValidationRulesActionsBulkApprovePost(requestParameters = {}, options) {
-      return DataValidationApiFp(this.configuration).v4DataValidationRulesActionsBulkApprovePost(requestParameters.bulkApproveRules, options).then((request) => request(this.axios, this.basePath));
-    }
-    v4DataValidationRulesActionsBulkDeletePost(requestParameters = {}, options) {
-      return DataValidationApiFp(this.configuration).v4DataValidationRulesActionsBulkDeletePost(requestParameters.bulkDeleteRules, options).then((request) => request(this.axios, this.basePath));
-    }
-    v4DataValidationRulesActionsDeleteAllDelete(requestParameters = {}, options) {
-      return DataValidationApiFp(this.configuration).v4DataValidationRulesActionsDeleteAllDelete(requestParameters.deleteRuleWithReason, options).then((request) => request(this.axios, this.basePath));
-    }
-    v4DataValidationRulesActionsGeneratePost(requestParameters = {}, options) {
-      return DataValidationApiFp(this.configuration).v4DataValidationRulesActionsGeneratePost(requestParameters.generateRule, options).then((request) => request(this.axios, this.basePath));
-    }
+  _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) {
+      super(msg);
+      this.field = field;
+      this.name = "RequiredError";
+    }
+  };
+  operationServerMap = {};
+  CrawlerApi = class extends BaseAPI {
+    v4CrawlBucketDataFilenameb64Get(requestParameters, options) {
+      return CrawlerApiFp(this.configuration).v4CrawlBucketDataFilenameb64Get(requestParameters.filenameb64, requestParameters.contentType, requestParameters.cacheControl, options).then((request) => request(this.axios, this.basePath));
+    }
+    v4CrawlConfigConfigIdGet(requestParameters, options) {
+      return CrawlerApiFp(this.configuration).v4CrawlConfigConfigIdGet(requestParameters.configId, options).then((request) => request(this.axios, this.basePath));
+    }
+    v4CrawlConfigDelete(requestParameters = {}, options) {
+      return CrawlerApiFp(this.configuration).v4CrawlConfigDelete(requestParameters.deleteCrawlerConfigRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+    v4CrawlConfigPost(requestParameters = {}, options) {
+      return CrawlerApiFp(this.configuration).v4CrawlConfigPost(requestParameters.createCrawlerConfigRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+    v4CrawlPausePost(requestParameters = {}, options) {
+      return CrawlerApiFp(this.configuration).v4CrawlPausePost(requestParameters.pauseCrawlerSessionRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+    v4CrawlPost(requestParameters = {}, options) {
+      return CrawlerApiFp(this.configuration).v4CrawlPost(requestParameters.startCrawlerSessionRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+    v4CrawlResumePost(requestParameters = {}, options) {
+      return CrawlerApiFp(this.configuration).v4CrawlResumePost(requestParameters.resumeCrawlerSessionRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+    v4CrawlSessionIdListGet(requestParameters, options) {
+      return CrawlerApiFp(this.configuration).v4CrawlSessionIdListGet(requestParameters.sessionId, requestParameters.includeAll, options).then((request) => request(this.axios, this.basePath));
+    }
+    v4CrawlSessionIdPagesGet(requestParameters, options) {
+      return CrawlerApiFp(this.configuration).v4CrawlSessionIdPagesGet(requestParameters.sessionId, requestParameters.currentPage, requestParameters.pageSize, options).then((request) => request(this.axios, this.basePath));
+    }
+    v4CrawlSessionIdPagesPageIdGet(requestParameters, options) {
+      return CrawlerApiFp(this.configuration).v4CrawlSessionIdPagesPageIdGet(requestParameters.sessionId, requestParameters.pageId, requestParameters.format, options).then((request) => request(this.axios, this.basePath));
+    }
+    v4CrawlSessionIdStatusGet(requestParameters, options) {
+      return CrawlerApiFp(this.configuration).v4CrawlSessionIdStatusGet(requestParameters.sessionId, options).then((request) => request(this.axios, this.basePath));
+    }
+    v4CrawlSessionsGet(requestParameters = {}, options) {
+      return CrawlerApiFp(this.configuration).v4CrawlSessionsGet(requestParameters.page, requestParameters.pageSize, requestParameters.userId, options).then((request) => request(this.axios, this.basePath));
+    }
+    v4CrawlStartPost(requestParameters = {}, options) {
+      return CrawlerApiFp(this.configuration).v4CrawlStartPost(requestParameters.startSessionWithConfigRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+  };
+  DataValidationApi = class extends BaseAPI {
+    v4DataValidationRulesActionsBulkApprovePost(requestParameters = {}, options) {
+      return DataValidationApiFp(this.configuration).v4DataValidationRulesActionsBulkApprovePost(requestParameters.bulkApproveRules, options).then((request) => request(this.axios, this.basePath));
+    }
+    v4DataValidationRulesActionsBulkDeletePost(requestParameters = {}, options) {
+      return DataValidationApiFp(this.configuration).v4DataValidationRulesActionsBulkDeletePost(requestParameters.bulkDeleteRules, options).then((request) => request(this.axios, this.basePath));
+    }
+    v4DataValidationRulesActionsDeleteAllDelete(requestParameters = {}, options) {
+      return DataValidationApiFp(this.configuration).v4DataValidationRulesActionsDeleteAllDelete(requestParameters.deleteRuleWithReason, options).then((request) => request(this.axios, this.basePath));
+    }
+    v4DataValidationRulesActionsGeneratePost(requestParameters = {}, options) {
+      return DataValidationApiFp(this.configuration).v4DataValidationRulesActionsGeneratePost(requestParameters.generateRule, options).then((request) => request(this.axios, this.basePath));
+    }
     v4DataValidationRulesActionsGenerateRulesPost(requestParameters = {}, options) {
       return DataValidationApiFp(this.configuration).v4DataValidationRulesActionsGenerateRulesPost(requestParameters.generateRules, options).then((request) => request(this.axios, this.basePath));
     }
@@ -49636,215 +49930,25 @@ 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";
+  RAW_HELPER_FIELD_CONFIG = {
+    HTML: {
+      dataType: "STRING",
+      description: "Full page HTML as a string. Return the raw HTML content.",
+      example: "<html><body><h1>Example page</h1></body></html>"
+    },
+    MARKDOWN: {
+      dataType: "STRING",
+      description: "Main page content rendered as markdown. Return the markdown as a string.",
+      example: `# Example page
+
+This is the main page content.`
+    },
+    PAGE_URL: {
+      dataType: "LINK",
+      description: "Canonical page URL for the extracted page. Return the resolved page URL.",
+      example: "https://example.com/page"
     }
   };
-  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,19 +49958,26 @@ 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",
     pollingInterval: 5000,
     maxWaitTime: 300000,
-    navigationMode: "single-page",
     location: { type: "auto" },
     bypassPreview: true,
     autoStart: true
   };
-  debug3 = logger.extraction;
+  debug4 = logger.extraction;
+  TERMINAL_RUN_STATES = /* @__PURE__ */ new Set([
+    "FINISHED",
+    "SUCCESS",
+    "FAILED",
+    "ERROR",
+    "STOPPED",
+    "CANCELLED"
+  ]);
   NotificationChannelType = {
     EMAIL: "EMAIL",
     SLACK: "SLACK",
@@ -49876,19 +49987,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 +50008,7 @@ var init_dist2 = __esm(() => {
     ABORTED: "ABORTED",
     TIMEOUT: "TIMEOUT"
   };
-  debug7 = logger.variables;
+  debug8 = logger.variables;
   JobStateEnum = {
     Finished: "FINISHED",
     Failed: "FAILED",
@@ -49910,7 +50021,7 @@ var init_dist2 = __esm(() => {
     JobStateEnum.NotSupported,
     JobStateEnum.FailedInsufficientFunds
   ]);
-  TERMINAL_RUN_STATES = /* @__PURE__ */ new Set([
+  TERMINAL_RUN_STATES2 = /* @__PURE__ */ new Set([
     "FINISHED",
     "SUCCESS",
     "FAILED",
@@ -49918,7 +50029,7 @@ var init_dist2 = __esm(() => {
     "STOPPED",
     "CANCELLED"
   ]);
-  debug8 = logger.workflow;
+  debug9 = logger.workflow;
 });
 
 // src/client.ts
@@ -50115,6 +50226,9 @@ function coerceBoolean() {
     return val;
   };
 }
+function coerceNull() {
+  return (val) => val === "null" ? undefined : val;
+}
 function coerceJson() {
   return (val) => {
     if (typeof val === "string") {
@@ -50146,17 +50260,33 @@ function extractApiMessage(responseBody) {
   const body = responseBody;
   if (!body || typeof body !== "object")
     return;
-  const msg = typeof body.error === "string" && body.error || typeof body.message === "string" && body.message || undefined;
-  if (!msg)
-    return;
+  let msg = typeof body.error === "string" && body.error || typeof body.message === "string" && body.message || undefined;
   if (body.validationErrors && typeof body.validationErrors === "object" && body.validationErrors !== null) {
     const details = Object.entries(body.validationErrors).map(([field, err]) => `${field}: "${err}"`).join(", ");
-    if (details)
-      return `${msg} — Details: ${details}`;
+    if (details) {
+      msg = msg ? `${msg} — Details: ${details}` : `Validation failed — Details: ${details}`;
+    }
   }
   return msg;
 }
-function classifyError(error48) {
+function inferResourceType(toolName) {
+  if (!toolName)
+    return "resource";
+  if (toolName.includes("template") || toolName.includes("version"))
+    return "template";
+  if (toolName.includes("variable"))
+    return "variable";
+  if (toolName.includes("workflow") || toolName.includes("monitor"))
+    return "workflow";
+  if (toolName.includes("channel") || toolName.includes("notification"))
+    return "notification channel";
+  if (toolName.includes("schema"))
+    return "schema";
+  if (toolName.includes("change"))
+    return "change record";
+  return "resource";
+}
+function classifyError(error48, toolName) {
   if (KadoaSdkException.isInstance(error48)) {
     const code = error48.code;
     if (KadoaHttpException.isInstance(error48)) {
@@ -50168,8 +50298,10 @@ function classifyError(error48) {
             return `Access denied${status}. Your current team role may not have permission for this action. Use the whoami tool to check your role, or contact your team admin to request elevated access.`;
           }
           return `Authentication failed${status}. Please re-authenticate via OAuth.`;
-        case "NOT_FOUND":
-          return `Not found${status}. The workflow may have been deleted or the ID is incorrect.`;
+        case "NOT_FOUND": {
+          const resource = inferResourceType(toolName);
+          return `Not found${status}. The ${resource} may have been deleted or the ID is incorrect.`;
+        }
         case "RATE_LIMITED":
           return `Rate limit exceeded${status}. Please wait a moment and try again.`;
         case "NETWORK_ERROR":
@@ -50186,8 +50318,10 @@ function classifyError(error48) {
     switch (code) {
       case "AUTH_ERROR":
         return "Authentication failed. Please re-authenticate via OAuth.";
-      case "NOT_FOUND":
-        return "Not found. The workflow may have been deleted or the ID is incorrect.";
+      case "NOT_FOUND": {
+        const resource = inferResourceType(toolName);
+        return `Not found. The ${resource} may have been deleted or the ID is incorrect.`;
+      }
       case "RATE_LIMITED":
         return "Rate limit exceeded. Please wait a moment and try again.";
       case "NETWORK_ERROR":
@@ -50230,7 +50364,7 @@ function registerTools(server, ctx) {
           console.error(`[Tool Error] ${name}: session expired, user must re-authenticate`);
           return errorResult("Your session has expired. Please reconnect the MCP server to re-authenticate.");
         }
-        let message = classifyError(error48);
+        let message = classifyError(error48, name);
         if (KadoaHttpException.isInstance(error48) && error48.httpStatus === 403) {
           try {
             const jwt2 = ctx.supabaseJwt;
@@ -50418,7 +50552,6 @@ function registerTools(server, ctx) {
     let builder = ctx.client.extract({
       urls,
       name: args.name || "Untitled Workflow",
-      navigationMode: "agentic-navigation",
       userPrompt: args.prompt,
       extraction: buildExtraction(args),
       interval: args.updateInterval,
@@ -50608,6 +50741,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: {
@@ -51083,7 +51266,7 @@ function registerTools(server, ctx) {
     });
   }));
   server.registerTool("list_templates", {
-    description: "List all templates in the current team. Templates define reusable configurations (prompt, schema, notifications) that can be linked to multiple workflows.",
+    description: "List all templates in the current team. Templates define reusable configurations (prompt, schema, notifications).",
     inputSchema: strictSchema({}),
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true }
   }, withErrorHandling("list_templates", async () => {
@@ -51101,7 +51284,7 @@ function registerTools(server, ctx) {
     return jsonResult({ template });
   }));
   server.registerTool("create_template", {
-    description: "Create a new template. Templates define reusable configurations that can be linked to workflows. After creation, use create_template_version to publish a version with prompt, schema, and notifications.",
+    description: "Create a new template. After creation, use create_template_version to publish a version with prompt, schema, and notifications.",
     inputSchema: strictSchema({
       name: exports_external.string().describe("Template name (1-255 chars)"),
       description: exports_external.string().optional().describe("Template description (max 2000 chars)")
@@ -51122,8 +51305,8 @@ function registerTools(server, ctx) {
     description: "Update a template's name or description. At least one field must be provided.",
     inputSchema: strictSchema({
       templateId: exports_external.string().describe("The template ID to update"),
-      name: exports_external.string().optional().describe("New template name"),
-      description: exports_external.string().optional().describe("New template description")
+      name: exports_external.preprocess(coerceNull(), exports_external.string().optional()).describe("New template name"),
+      description: exports_external.preprocess(coerceNull(), exports_external.string().optional()).describe("New template description")
     }),
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true }
   }, withErrorHandling("update_template", async (args) => {
@@ -51136,7 +51319,7 @@ function registerTools(server, ctx) {
     });
   }));
   server.registerTool("delete_template", {
-    description: "Delete (archive) a template. Existing linked workflows keep their current config but are unlinked. " + "You MUST first call this tool without confirmed=true to preview what will be deleted, " + "then show the user the template name and ask for confirmation, " + "then call again with confirmed=true only after the user explicitly agrees.",
+    description: "Delete (archive) a template. " + "You MUST first call this tool without confirmed=true to preview what will be deleted, " + "then show the user the template name and ask for confirmation, " + "then call again with confirmed=true only after the user explicitly agrees.",
     inputSchema: strictSchema({
       templateId: exports_external.string().describe("The template ID to delete"),
       confirmed: exports_external.preprocess(coerceBoolean(), exports_external.boolean()).optional().describe("Set to true only after the user has explicitly confirmed deletion. Omit or set to false for the initial preview call.")
@@ -51153,7 +51336,7 @@ function registerTools(server, ctx) {
         pending: true,
         templateId: args.templateId,
         templateName,
-        message: `⚠️ You are about to delete template "${templateName}". Linked workflows will keep their current config but will be unlinked. Ask the user to confirm, then call delete_template again with confirmed=true.`
+        message: `⚠️ You are about to delete template "${templateName}". Ask the user to confirm, then call delete_template again with confirmed=true.`
       });
     }
     await ctx.client.template.delete(args.templateId);
@@ -51196,98 +51379,14 @@ function registerTools(server, ctx) {
       message: `Version ${version2.version} published for template ${templateId}.`
     });
   }));
-  server.registerTool("list_template_workflows", {
-    description: "List all workflows linked to a template.",
-    inputSchema: strictSchema({
-      templateId: exports_external.string().describe("The template ID")
-    }),
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true }
-  }, withErrorHandling("list_template_workflows", async (args) => {
-    const workflows = await ctx.client.template.listWorkflows(args.templateId);
-    return jsonResult({ workflows, count: workflows.length });
-  }));
-  server.registerTool("link_workflows_to_template", {
-    description: "Link workflows to a template. Linking applies the template's latest version config to the workflows. " + "Without force, fails if any workflow is already linked to a different template. With force=true, relinks them. " + "You MUST first call without confirmed=true to preview, then ask the user for confirmation, " + "then call again with confirmed=true.",
-    inputSchema: strictSchema({
-      templateId: exports_external.string().describe("The template ID to link workflows to"),
-      workflowIds: exports_external.preprocess(coerceArray(), exports_external.array(exports_external.string())).describe("Array of workflow IDs to link"),
-      force: exports_external.preprocess(coerceBoolean(), exports_external.boolean()).optional().describe("If true, relink workflows already linked to another template"),
-      confirmed: exports_external.preprocess(coerceBoolean(), exports_external.boolean()).optional().describe("Set to true only after user confirms. Omit for preview.")
-    }),
-    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false }
-  }, withErrorHandling("link_workflows_to_template", async (args) => {
-    if (!args.confirmed) {
-      const forceNote = args.force ? " Workflows already linked to other templates will be relinked (force=true)." : " Will fail if any workflow is already linked to a different template.";
-      return jsonResult({
-        pending: true,
-        templateId: args.templateId,
-        workflowIds: args.workflowIds,
-        force: !!args.force,
-        message: `⚠️ You are about to link ${args.workflowIds.length} workflow(s) to template ${args.templateId}. This will apply the template's latest version config to these workflows.${forceNote} Ask the user to confirm, then call again with confirmed=true.`
-      });
-    }
-    const result = await ctx.client.template.linkWorkflows(args.templateId, {
-      workflowIds: args.workflowIds,
-      ...args.force != null && { force: args.force }
-    });
-    return jsonResult({
-      success: true,
-      result,
-      message: `Linked ${args.workflowIds.length} workflow(s) to template ${args.templateId}.`
-    });
-  }));
-  server.registerTool("unlink_workflows_from_template", {
-    description: "Unlink workflows from a template. Workflows keep their current config but are no longer associated with the template. " + "You MUST first call without confirmed=true to preview, then ask the user for confirmation, " + "then call again with confirmed=true.",
-    inputSchema: strictSchema({
-      templateId: exports_external.string().describe("The template ID to unlink workflows from"),
-      workflowIds: exports_external.preprocess(coerceArray(), exports_external.array(exports_external.string())).describe("Array of workflow IDs to unlink"),
-      confirmed: exports_external.preprocess(coerceBoolean(), exports_external.boolean()).optional().describe("Set to true only after user confirms. Omit for preview.")
-    }),
-    annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false }
-  }, withErrorHandling("unlink_workflows_from_template", async (args) => {
-    if (!args.confirmed) {
-      return jsonResult({
-        pending: true,
-        templateId: args.templateId,
-        workflowIds: args.workflowIds,
-        message: `⚠️ You are about to unlink ${args.workflowIds.length} workflow(s) from template ${args.templateId}. Workflows will keep their current config. Ask the user to confirm, then call again with confirmed=true.`
-      });
-    }
-    const result = await ctx.client.template.unlinkWorkflows(args.templateId, {
-      workflowIds: args.workflowIds
-    });
-    return jsonResult({
-      success: true,
-      result,
-      message: `Unlinked ${args.workflowIds.length} workflow(s) from template ${args.templateId}.`
-    });
-  }));
-  server.registerTool("apply_template_update", {
-    description: "Apply a specific template version to workflows. Updates the workflows' config (prompt, schema, notifications) to match the specified version.",
-    inputSchema: strictSchema({
-      templateId: exports_external.string().describe("The template ID"),
-      targetVersion: exports_external.preprocess(coerceNumber(), exports_external.number().int().min(1)).describe("Version number to apply"),
-      workflowIds: exports_external.preprocess(coerceArray(), exports_external.array(exports_external.string())).describe("Array of workflow IDs to update (max 100)")
-    }),
-    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false }
-  }, withErrorHandling("apply_template_update", async (args) => {
-    const result = await ctx.client.template.applyUpdate(args.templateId, {
-      targetVersion: args.targetVersion,
-      workflowIds: args.workflowIds
-    });
-    return jsonResult({
-      success: true,
-      result,
-      message: `Applied version ${args.targetVersion} to ${args.workflowIds.length} workflow(s).`
-    });
-  }));
   server.registerTool("save_workflow_as_template", {
-    description: "Create a template from an existing workflow's configuration (prompt, schema, notifications). " + "Provide 'name' to create a new template, or 'templateId' to add a new version to an existing template.",
+    description: "Create a template from an existing workflow's configuration (prompt, schema, notifications). " + "Provide 'name' to create a new template, or 'templateId' to add a new version to an existing template. " + "Use 'includeParts' to save only specific parts of the configuration.",
     inputSchema: strictSchema({
       workflowId: exports_external.string().describe("Source workflow ID to extract config from"),
       name: exports_external.string().optional().describe("Name for the new template (required if templateId is not set)"),
       description: exports_external.string().optional().describe("Description for the new template"),
-      templateId: exports_external.string().optional().describe("Existing template ID to add a new version to (mutually exclusive with name)")
+      templateId: exports_external.string().optional().describe("Existing template ID to add a new version to (mutually exclusive with name)"),
+      includeParts: exports_external.preprocess(coerceArray(), exports_external.array(exports_external.enum(["prompt", "schema", "notifications"])).optional()).describe("Which parts of the workflow config to include. Omit to include all. At least 1 required if provided.")
     }),
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false }
   }, withErrorHandling("save_workflow_as_template", async (args) => {
@@ -51295,7 +51394,8 @@ function registerTools(server, ctx) {
       workflowId: args.workflowId,
       ...args.name != null && { name: args.name },
       ...args.description != null && { description: args.description },
-      ...args.templateId != null && { templateId: args.templateId }
+      ...args.templateId != null && { templateId: args.templateId },
+      ...args.includeParts != null && { includeParts: args.includeParts }
     });
     return jsonResult({
       success: true,
@@ -51335,7 +51435,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kadoa/mcp",
-    version: "0.4.2",
+    version: "0.4.3-rc.2",
     description: "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
     type: "module",
     main: "dist/index.js",
@@ -51359,7 +51459,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.28.0",
       "@modelcontextprotocol/sdk": "^1.26.0",
       express: "^5.2.1",
       ioredis: "^5.6.1",
@@ -56586,6 +56686,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."