@kadoa/mcp 0.4.3-rc.1 → 0.4.3-rc.3

package/dist/index.js

@@ -44032,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) {
@@ -44194,7 +44228,6 @@ function createClientDomains(params) {
   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);
@@ -44202,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,
@@ -47371,12 +47404,19 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
       yield page;
     }
   }
-}, _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;
@@ -47412,20 +47452,23 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
     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 }
@@ -47530,88 +47573,10 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
       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 }
-      });
-    }
-  }
-}, debug3, 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;
@@ -47646,7 +47611,9 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
   }
   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(...).", {
@@ -47657,35 +47624,23 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
       });
     }
     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;
@@ -47770,10 +47725,9 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
   isExtractionSuccessful(runState) {
     return runState ? SUCCESSFUL_RUN_STATES.has(runState.toUpperCase()) : false;
   }
-}, debug4, 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;
   }
@@ -47799,7 +47753,6 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
     urls,
     name,
     description,
-    navigationMode,
     extraction,
     additionalData,
     bypassPreview,
@@ -47809,23 +47762,22 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
     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,
@@ -47872,41 +47824,27 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
   }
   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 },
@@ -47952,7 +47890,10 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
         }
       });
     }
-    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");
     debug4("Job started: %O", startedJob);
     this._jobId = startedJob.jobId;
@@ -47972,7 +47913,10 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
         }
       });
     }
-    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");
     debug4("Job submitted: %O", submittedJob);
     this._jobId = submittedJob.jobId;
@@ -48001,6 +47945,60 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
       ...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;
@@ -48327,7 +48325,7 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
     }));
     return channels;
   }
-}, PUBLIC_API_URI, WSS_API_URI, REALTIME_API_URI, SDK_VERSION = "0.27.0", SDK_NAME = "kadoa-node-sdk", SDK_LANGUAGE = "node", debug6, isDrainControlMessage = (message) => message.type === "control.draining", isRealtimeEvent = (message) => message.type !== "heartbeat" && message.type !== "control.draining", _Realtime = class _Realtime2 {
+}, 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();
@@ -48737,37 +48735,6 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
     });
     return response.data.data ?? [];
   }
-  async listWorkflows(templateId) {
-    debug7("Listing workflows for template: %s", templateId);
-    const response = await this.templatesApi.v4TemplatesTemplateIdWorkflowsGet({
-      templateId
-    });
-    return response.data.data ?? [];
-  }
-  async linkWorkflows(templateId, body) {
-    debug7("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) {
-    debug7("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) {
-    debug7("Applying version %d to %d workflows for template: %s", body.targetVersion, body.workflowIds.length, templateId);
-    const response = await this.templatesApi.v4TemplatesTemplateIdApplyPost({
-      templateId,
-      applyTemplateUpdateBody: body
-    });
-    return response.data;
-  }
   async createFromWorkflow(body) {
     debug7("Creating template from workflow: %s", body.workflowId);
     const response = await this.templatesApi.v4TemplatesFromWorkflowPost({
@@ -49086,7 +49053,7 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
       variableId
     });
   }
-}, JobStateEnum, TERMINAL_JOB_STATES, TERMINAL_RUN_STATES, debug9, WorkflowsCoreService = class {
+}, JobStateEnum, TERMINAL_JOB_STATES, TERMINAL_RUN_STATES2, debug9, WorkflowsCoreService = class {
   constructor(workflowsApi) {
     this.workflowsApi = workflowsApi;
   }
@@ -49208,7 +49175,7 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
       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;
@@ -49963,6 +49930,25 @@ var init_dist2 = __esm(() => {
     Text: DataFieldDataTypeEnum.String,
     Url: DataFieldDataTypeEnum.Link
   };
+  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"
+    }
+  };
   _SchemaBuilder.FIELD_NAME_PATTERN = /^[A-Za-z0-9]+$/;
   _SchemaBuilder.TYPES_REQUIRING_EXAMPLE = [
     "STRING",
@@ -49979,12 +49965,19 @@ var init_dist2 = __esm(() => {
     mode: "run",
     pollingInterval: 5000,
     maxWaitTime: 300000,
-    navigationMode: "single-page",
     location: { type: "auto" },
     bypassPreview: true,
     autoStart: true
   };
   debug4 = logger.extraction;
+  TERMINAL_RUN_STATES = /* @__PURE__ */ new Set([
+    "FINISHED",
+    "SUCCESS",
+    "FAILED",
+    "ERROR",
+    "STOPPED",
+    "CANCELLED"
+  ]);
   NotificationChannelType = {
     EMAIL: "EMAIL",
     SLACK: "SLACK",
@@ -50028,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",
@@ -50233,6 +50226,9 @@ function coerceBoolean() {
     return val;
   };
 }
+function coerceNull() {
+  return (val) => val === "null" ? undefined : val;
+}
 function coerceJson() {
   return (val) => {
     if (typeof val === "string") {
@@ -50264,17 +50260,42 @@ 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) {
+      msg = msg ? `${msg} — Details: ${details}` : `Validation failed — Details: ${details}`;
+    }
+  }
+  if (!msg && Array.isArray(body.issues)) {
+    const details = body.issues.map((issue2) => {
+      const path = Array.isArray(issue2.path) ? issue2.path.join(".") : "";
+      const message = typeof issue2.message === "string" ? issue2.message : String(issue2.code ?? "invalid");
+      return path ? `${path}: "${message}"` : `"${message}"`;
+    }).join(", ");
     if (details)
-      return `${msg} — Details: ${details}`;
+      msg = `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)) {
@@ -50286,8 +50307,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":
@@ -50304,8 +50327,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":
@@ -50348,7 +50373,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;
@@ -50536,7 +50561,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,
@@ -51251,7 +51275,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 () => {
@@ -51269,7 +51293,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)")
@@ -51290,8 +51314,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) => {
@@ -51304,7 +51328,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.")
@@ -51321,7 +51345,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);
@@ -51364,98 +51388,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) => {
@@ -51463,7 +51403,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,
@@ -51503,7 +51444,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kadoa/mcp",
-    version: "0.4.3-rc.1",
+    version: "0.4.3-rc.3",
     description: "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
     type: "module",
     main: "dist/index.js",
@@ -51527,7 +51468,7 @@ var init_package = __esm(() => {
       prepublishOnly: "bun run check-types && bun run test:unit && bun run build"
     },
     dependencies: {
-      "@kadoa/node-sdk": "^0.27.0",
+      "@kadoa/node-sdk": "^0.28.0",
       "@modelcontextprotocol/sdk": "^1.26.0",
       express: "^5.2.1",
       ioredis: "^5.6.1",

package/package.json

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