@kadoa/mcp 0.5.23 → 0.5.25

package/README.md

@@ -62,6 +62,8 @@ Point your client to `https://mcp.kadoa.com/mcp` with OAuth authentication.
 | Tool | Description |
 |------|-------------|
 | `scrape` | Immediately fetch one URL as markdown or raw HTML (shown only for enabled workspaces) |
+| `list_inbox` | List personal unread Inbox items across workflows, optionally including read history |
+| `mark_inbox_item_read` | Acknowledge one Inbox item without performing its underlying workflow action |
 | `create_workflow` | Create an agentic navigation workflow from a prompt |
 | `create_realtime_monitor` | Create an asynchronous realtime monitoring workflow after persisting notification channels; returns workflow/session/thread/job IDs |
 | `list_workflows` | List all workflows with status |
@@ -102,6 +104,17 @@ its own when a site blocks bots. Ask for HTML when you need the raw source.
 
 The `scrape` tool is available only to workspaces enabled for the Scrape API. Use a workflow instead for structured extraction, recurring runs, monitoring, or multi-page navigation.
 
+### Review work that needs attention
+
+```
+> You: What needs my attention in Kadoa?
+
+Claude calls list_inbox and shows unread questions and review items across
+workflows. For an Assistant question, it calls get_workflow_assistant to load
+the authoritative question before asking whether you want to answer it.
+Marking the Inbox item read only acknowledges it.
+```
+
 ### Create and run a workflow
 
 ```
@@ -126,12 +139,14 @@ to retrieve the extracted records and display them as a table.
 
 ```
 > You: Use my "Product Scraper" template to scrape https://example-shop.com.
+>      For this source, only include products that are in stock.
 
 Claude calls list_templates to find the matching template, then
-create_workflow with `templateId` and `urls` only - never copy the prompt,
-entity, or schema into standalone creation. Those values are inherited from
-the template version. Returns the workflow ID for follow-up with get_workflow
-or fetch_data.
+create_workflow with `templateId`, `urls`, and `prompt` containing only the
+source-specific instruction. The template's shared prompt, entity, and schema
+are inherited and must not be copied into the call. The optional workflow
+instruction remains workflow-owned when the template is updated. Returns the
+workflow ID for follow-up with get_workflow or fetch_data.
 ```
 
 ### Update a workflow and re-run

package/dist/index.js

@@ -45506,6 +45506,29 @@ function buildAgenticPrompt2(params) {
   }
   return `extract all records from this page and return these fields: ${fieldList}`;
 }
+function mapInboxItem(item) {
+  return {
+    id: item.id,
+    type: knownInboxItemTypes[item.type] ?? item.type,
+    subjectId: item.subjectId,
+    workflowId: item.workflowId,
+    title: item.title,
+    payload: item.payload,
+    isRead: item.isRead,
+    readAt: item.readAt,
+    createdAt: item.createdAt,
+    updatedAt: item.updatedAt
+  };
+}
+function mapInboxListResponse(response) {
+  return {
+    unreadCount: response.data.unreadCount,
+    items: response.data.items.map(mapInboxItem)
+  };
+}
+function mapInboxMarkReadResponse(response) {
+  return { readCount: response.data.readCount };
+}
 function validateEmailChannelConfig(config2) {
   const issues = [];
   if (!config2.recipients?.length) {
@@ -45668,6 +45691,7 @@ function createClientDomains(params) {
   const { client } = params;
   const assistantService = new AssistantService(client.apis.agent);
   const changesService = new ChangesService(client);
+  const inboxService = new InboxService(client.apis.inbox);
   const userService = new UserService(client);
   const dataFetcherService = new DataFetcherService(client.apis.workflows);
   const channelsService = new NotificationChannelsService(client.apis.notifications, userService);
@@ -45675,7 +45699,7 @@ function createClientDomains(params) {
   const schemasService = new SchemasService(client);
   const scrapeService = new ScrapeService(client);
   const templatesService = new TemplatesService(client);
-  const workflowsCoreService = new WorkflowsCoreService(client.apis.workflows, templatesService);
+  const workflowsCoreService = new WorkflowsCoreService(client.apis.workflows);
   const variablesService = new VariablesService(client);
   const channelSetupService = new NotificationSetupService(channelsService, settingsService);
   const coreService = new ValidationCoreService(client);
@@ -45697,6 +45721,7 @@ function createClientDomains(params) {
     extraction: extractionService,
     workflow: workflowsCoreService,
     notification,
+    inbox: inboxService,
     schema: schemasService,
     scrape: scrapeService,
     user: userService,
@@ -45885,8 +45910,8 @@ var import_debug, __require2, FREEFORM_ASSISTANT_ANSWER_KEY = "_freeform", Kadoa
   return needsSerialization ? JSON.stringify(value !== undefined ? value : {}, replaceWithSerializableTypeIfNeeded) : value || "";
 }, toPathString = function(url3) {
   return url3.pathname + url3.search + url3.hash;
-}, createRequestFunction = function(axiosArgs, globalAxios12, BASE_PATH2, configuration) {
-  return (axios2 = globalAxios12, basePath = BASE_PATH2) => {
+}, createRequestFunction = function(axiosArgs, globalAxios13, BASE_PATH2, configuration) {
+  return (axios2 = globalAxios13, basePath = BASE_PATH2) => {
     const axiosRequestArgs = { ...axiosArgs.options, url: (axios2.defaults.baseURL ? "" : configuration?.basePath ?? basePath) + axiosArgs.url };
     return axios2.request(axiosRequestArgs);
   };
@@ -47156,7 +47181,67 @@ var import_debug, __require2, FREEFORM_ASSISTANT_ANSWER_KEY = "_freeform", Kadoa
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, axios_default, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
     }
   };
-}, DataValidationApi, MeApiAxiosParamCreator = function(configuration) {
+}, DataValidationApi, InboxApiAxiosParamCreator = function(configuration) {
+  return {
+    v5InboxList: async (options = {}) => {
+      const localVarPath = `/v5/inbox`;
+      const localVarUrlObj = new URL$1(localVarPath, DUMMY_BASE_URL);
+      let baseOptions;
+      if (configuration) {
+        baseOptions = configuration.baseOptions;
+      }
+      const localVarRequestOptions = { method: "GET", ...baseOptions, ...options };
+      const localVarHeaderParameter = {};
+      const localVarQueryParameter = {};
+      await setApiKeyToObject(localVarHeaderParameter, "x-api-key", configuration);
+      localVarHeaderParameter["Accept"] = "application/json";
+      setSearchParams(localVarUrlObj, localVarQueryParameter);
+      let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+      localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
+      return {
+        url: toPathString(localVarUrlObj),
+        options: localVarRequestOptions
+      };
+    },
+    v5InboxMarkRead: async (itemId, options = {}) => {
+      assertParamExists("v5InboxMarkRead", "itemId", itemId);
+      const localVarPath = `/v5/inbox/{itemId}/mark-read`.replace(`{${"itemId"}}`, encodeURIComponent(String(itemId)));
+      const localVarUrlObj = new URL$1(localVarPath, DUMMY_BASE_URL);
+      let baseOptions;
+      if (configuration) {
+        baseOptions = configuration.baseOptions;
+      }
+      const localVarRequestOptions = { method: "POST", ...baseOptions, ...options };
+      const localVarHeaderParameter = {};
+      const localVarQueryParameter = {};
+      await setApiKeyToObject(localVarHeaderParameter, "x-api-key", configuration);
+      localVarHeaderParameter["Accept"] = "application/json";
+      setSearchParams(localVarUrlObj, localVarQueryParameter);
+      let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+      localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
+      return {
+        url: toPathString(localVarUrlObj),
+        options: localVarRequestOptions
+      };
+    }
+  };
+}, InboxApiFp = function(configuration) {
+  const localVarAxiosParamCreator = InboxApiAxiosParamCreator(configuration);
+  return {
+    async v5InboxList(options) {
+      const localVarAxiosArgs = await localVarAxiosParamCreator.v5InboxList(options);
+      const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+      const localVarOperationServerBasePath = operationServerMap["InboxApi.v5InboxList"]?.[localVarOperationServerIndex]?.url;
+      return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, axios_default, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
+    },
+    async v5InboxMarkRead(itemId, options) {
+      const localVarAxiosArgs = await localVarAxiosParamCreator.v5InboxMarkRead(itemId, options);
+      const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+      const localVarOperationServerBasePath = operationServerMap["InboxApi.v5InboxMarkRead"]?.[localVarOperationServerIndex]?.url;
+      return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, axios_default, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
+    }
+  };
+}, InboxApi, MeApiAxiosParamCreator = function(configuration) {
   return {
     v4MeFeaturesGet: async (options = {}) => {
       const localVarPath = `/v4/me/features`;
@@ -47971,6 +48056,29 @@ var import_debug, __require2, FREEFORM_ASSISTANT_ANSWER_KEY = "_freeform", Kadoa
         options: localVarRequestOptions
       };
     },
+    v4TemplatesTemplateIdPreviewSchemaChangePost: async (templateId, schemaChangePreviewBody, options = {}) => {
+      assertParamExists("v4TemplatesTemplateIdPreviewSchemaChangePost", "templateId", templateId);
+      const localVarPath = `/v4/templates/{templateId}/preview-schema-change`.replace(`{${"templateId"}}`, encodeURIComponent(String(templateId)));
+      const localVarUrlObj = new URL$1(localVarPath, DUMMY_BASE_URL);
+      let baseOptions;
+      if (configuration) {
+        baseOptions = configuration.baseOptions;
+      }
+      const localVarRequestOptions = { method: "POST", ...baseOptions, ...options };
+      const localVarHeaderParameter = {};
+      const localVarQueryParameter = {};
+      await setApiKeyToObject(localVarHeaderParameter, "x-api-key", configuration);
+      localVarHeaderParameter["Content-Type"] = "application/json";
+      localVarHeaderParameter["Accept"] = "application/json";
+      setSearchParams(localVarUrlObj, localVarQueryParameter);
+      let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+      localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
+      localVarRequestOptions.data = serializeDataIfNeeded(schemaChangePreviewBody, localVarRequestOptions, configuration);
+      return {
+        url: toPathString(localVarUrlObj),
+        options: localVarRequestOptions
+      };
+    },
     v4TemplatesTemplateIdPut: async (templateId, updateTemplateBody, options = {}) => {
       assertParamExists("v4TemplatesTemplateIdPut", "templateId", templateId);
       const localVarPath = `/v4/templates/{templateId}`.replace(`{${"templateId"}}`, encodeURIComponent(String(templateId)));
@@ -48158,6 +48266,12 @@ var import_debug, __require2, FREEFORM_ASSISTANT_ANSWER_KEY = "_freeform", Kadoa
       const localVarOperationServerBasePath = operationServerMap["TemplatesApi.v4TemplatesTemplateIdLinkPost"]?.[localVarOperationServerIndex]?.url;
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, axios_default, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
     },
+    async v4TemplatesTemplateIdPreviewSchemaChangePost(templateId, schemaChangePreviewBody, options) {
+      const localVarAxiosArgs = await localVarAxiosParamCreator.v4TemplatesTemplateIdPreviewSchemaChangePost(templateId, schemaChangePreviewBody, options);
+      const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+      const localVarOperationServerBasePath = operationServerMap["TemplatesApi.v4TemplatesTemplateIdPreviewSchemaChangePost"]?.[localVarOperationServerIndex]?.url;
+      return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, axios_default, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
+    },
     async v4TemplatesTemplateIdPut(templateId, updateTemplateBody, options) {
       const localVarAxiosArgs = await localVarAxiosParamCreator.v4TemplatesTemplateIdPut(templateId, updateTemplateBody, options);
       const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
@@ -48673,7 +48787,7 @@ var import_debug, __require2, FREEFORM_ASSISTANT_ANSWER_KEY = "_freeform", Kadoa
         options: localVarRequestOptions
       };
     },
-    v4WorkflowsPost: async (publicWorkflowCreateRequest, options = {}) => {
+    v4WorkflowsPost: async (createWorkflowBody, options = {}) => {
       const localVarPath = `/v4/workflows`;
       const localVarUrlObj = new URL$1(localVarPath, DUMMY_BASE_URL);
       let baseOptions;
@@ -48689,7 +48803,7 @@ var import_debug, __require2, FREEFORM_ASSISTANT_ANSWER_KEY = "_freeform", Kadoa
       setSearchParams(localVarUrlObj, localVarQueryParameter);
       let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
       localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
-      localVarRequestOptions.data = serializeDataIfNeeded(publicWorkflowCreateRequest, localVarRequestOptions, configuration);
+      localVarRequestOptions.data = serializeDataIfNeeded(createWorkflowBody, localVarRequestOptions, configuration);
       return {
         url: toPathString(localVarUrlObj),
         options: localVarRequestOptions
@@ -49350,8 +49464,8 @@ var import_debug, __require2, FREEFORM_ASSISTANT_ANSWER_KEY = "_freeform", Kadoa
       const localVarOperationServerBasePath = operationServerMap["WorkflowsApi.v4WorkflowsGet"]?.[localVarOperationServerIndex]?.url;
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, axios_default, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
     },
-    async v4WorkflowsPost(publicWorkflowCreateRequest, options) {
-      const localVarAxiosArgs = await localVarAxiosParamCreator.v4WorkflowsPost(publicWorkflowCreateRequest, options);
+    async v4WorkflowsPost(createWorkflowBody, options) {
+      const localVarAxiosArgs = await localVarAxiosParamCreator.v4WorkflowsPost(createWorkflowBody, options);
       const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
       const localVarOperationServerBasePath = operationServerMap["WorkflowsApi.v4WorkflowsPost"]?.[localVarOperationServerIndex]?.url;
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, axios_default, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
@@ -49510,7 +49624,7 @@ var import_debug, __require2, FREEFORM_ASSISTANT_ANSWER_KEY = "_freeform", Kadoa
     const jsonMime = new RegExp("^(application/json|[^;/ \t]+/[^;/ \t]+[+]json)[ \t]*(;.*)?$", "i");
     return mime !== null && (jsonMime.test(mime) || mime.toLowerCase() === "application/json-patch+json");
   }
-}, DataFieldDataTypeEnum, CrawlerConfigService = class {
+}, DataFieldDataTypeEnum, InboxItemTypeEnum, CrawlerConfigService = class {
   constructor(client) {
     this.client = client;
   }
@@ -50273,6 +50387,18 @@ var import_debug, __require2, FREEFORM_ASSISTANT_ANSWER_KEY = "_freeform", Kadoa
     }
     return typeof error48.message === "string" ? error48.message.includes(BUILD_NOT_READY_ERROR) : false;
   }
+}, InboxItemType, knownInboxItemTypes, InboxService = class {
+  constructor(inboxApi) {
+    this.inboxApi = inboxApi;
+  }
+  async list() {
+    const response = await this.inboxApi.v5InboxList();
+    return mapInboxListResponse(response.data);
+  }
+  async markRead(itemId) {
+    const response = await this.inboxApi.v5InboxMarkRead({ itemId });
+    return mapInboxMarkReadResponse(response.data);
+  }
 }, NotificationChannelType, EMAIL_REGEX, _NotificationChannelsService = class _NotificationChannelsService2 {
   constructor(notificationsApi, userService) {
     this.api = notificationsApi;
@@ -50599,7 +50725,7 @@ var import_debug, __require2, FREEFORM_ASSISTANT_ANSWER_KEY = "_freeform", Kadoa
     }));
     return channels;
   }
-}, PUBLIC_API_URI, WSS_API_URI, REALTIME_API_URI, SDK_VERSION = "0.39.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.40.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();
@@ -51393,17 +51519,14 @@ var import_debug, __require2, FREEFORM_ASSISTANT_ANSWER_KEY = "_freeform", Kadoa
     });
   }
 }, JobStateEnum, TERMINAL_JOB_STATES, TERMINAL_RUN_STATES2, debug9, WorkflowsCoreService = class {
-  constructor(workflowsApi, templatesService) {
+  constructor(workflowsApi) {
     this.workflowsApi = workflowsApi;
-    this.templatesService = templatesService;
   }
   async create(input) {
     validateAdditionalData(input.additionalData);
     const isFromTemplate = input.templateId != null;
     if (isFromTemplate) {
       const conflicting = [];
-      if (input.userPrompt != null)
-        conflicting.push("userPrompt");
       if (input.entity != null)
         conflicting.push("entity");
       if (input.fields != null)
@@ -51427,12 +51550,13 @@ var import_debug, __require2, FREEFORM_ASSISTANT_ANSWER_KEY = "_freeform", Kadoa
     const domainName = new URL(input.urls[0]).hostname;
     let request;
     if (isFromTemplate) {
-      const templateId = input.templateId;
-      const templateVersion = input.templateVersion ?? await this.resolveLatestVersion(templateId);
       request = {
         urls: input.urls,
-        templateId,
-        templateVersion,
+        templateId: input.templateId,
+        ...input.templateVersion != null && {
+          templateVersion: input.templateVersion
+        },
+        ...input.userPrompt != null && { userPrompt: input.userPrompt },
         ...input.name != null && { name: input.name },
         ...input.description != null && { description: input.description },
         ...input.tags != null && { tags: input.tags },
@@ -51467,7 +51591,7 @@ var import_debug, __require2, FREEFORM_ASSISTANT_ANSWER_KEY = "_freeform", Kadoa
       };
     }
     const response = await this.workflowsApi.v4WorkflowsPost({
-      publicWorkflowCreateRequest: request
+      createWorkflowBody: request
     });
     const workflowId = response.data?.workflowId;
     if (!workflowId) {
@@ -51480,23 +51604,6 @@ var import_debug, __require2, FREEFORM_ASSISTANT_ANSWER_KEY = "_freeform", Kadoa
     }
     return { id: workflowId };
   }
-  async resolveLatestVersion(templateId) {
-    if (!this.templatesService) {
-      throw new KadoaSdkException("TemplatesService is required to resolve a template's latest version. Pass `templateVersion` explicitly or construct WorkflowsCoreService with a TemplatesService.", {
-        code: "INTERNAL_ERROR",
-        details: { templateId }
-      });
-    }
-    const template = await this.templatesService.get(templateId);
-    const latest = template.latestVersion;
-    if (latest == null) {
-      throw new KadoaSdkException(`Template ${templateId} has no published versions; supply templateVersion explicitly or publish a version first.`, {
-        code: "VALIDATION_ERROR",
-        details: { templateId }
-      });
-    }
-    return latest;
-  }
   async get(id) {
     const response = await this.workflowsApi.v4WorkflowsWorkflowIdGet({
       workflowId: id
@@ -51666,6 +51773,9 @@ var import_debug, __require2, FREEFORM_ASSISTANT_ANSWER_KEY = "_freeform", Kadoa
   get notifications() {
     return this.get(NotificationsApi);
   }
+  get inbox() {
+    return this.get(InboxApi);
+  }
   get templates() {
     return this.get(TemplatesApi);
   }
@@ -51705,6 +51815,7 @@ var import_debug, __require2, FREEFORM_ASSISTANT_ANSWER_KEY = "_freeform", Kadoa
     this.schema = domains.schema;
     this.scrape = domains.scrape;
     this.notification = domains.notification;
+    this.inbox = domains.inbox;
     this.template = domains.template;
     this.validation = domains.validation;
     this.variable = domains.variable;
@@ -52148,6 +52259,14 @@ var init_dist2 = __esm(() => {
       return DataValidationApiFp(this.configuration).v4DataValidationWorkflowsWorkflowIdValidationsLatestGet(requestParameters.workflowId, requestParameters.includeDryRun, options).then((request) => request(this.axios, this.basePath));
     }
   };
+  InboxApi = class extends BaseAPI {
+    v5InboxList(options) {
+      return InboxApiFp(this.configuration).v5InboxList(options).then((request) => request(this.axios, this.basePath));
+    }
+    v5InboxMarkRead(requestParameters, options) {
+      return InboxApiFp(this.configuration).v5InboxMarkRead(requestParameters.itemId, options).then((request) => request(this.axios, this.basePath));
+    }
+  };
   MeApi = class extends BaseAPI {
     v4MeFeaturesGet(options) {
       return MeApiFp(this.configuration).v4MeFeaturesGet(options).then((request) => request(this.axios, this.basePath));
@@ -52255,6 +52374,9 @@ var init_dist2 = __esm(() => {
     v4TemplatesTemplateIdLinkPost(requestParameters, options) {
       return TemplatesApiFp(this.configuration).v4TemplatesTemplateIdLinkPost(requestParameters.templateId, requestParameters.linkWorkflowsBody, options).then((request) => request(this.axios, this.basePath));
     }
+    v4TemplatesTemplateIdPreviewSchemaChangePost(requestParameters, options) {
+      return TemplatesApiFp(this.configuration).v4TemplatesTemplateIdPreviewSchemaChangePost(requestParameters.templateId, requestParameters.schemaChangePreviewBody, options).then((request) => request(this.axios, this.basePath));
+    }
     v4TemplatesTemplateIdPut(requestParameters, options) {
       return TemplatesApiFp(this.configuration).v4TemplatesTemplateIdPut(requestParameters.templateId, requestParameters.updateTemplateBody, options).then((request) => request(this.axios, this.basePath));
     }
@@ -52323,7 +52445,7 @@ var init_dist2 = __esm(() => {
       return WorkflowsApiFp(this.configuration).v4WorkflowsGet(requestParameters.search, requestParameters.skip, requestParameters.limit, requestParameters.state, requestParameters.runState, requestParameters.displayState, requestParameters.inSupport, requestParameters.tags, requestParameters.statusFilters, requestParameters.userId, requestParameters.channelId, requestParameters.monitoring, requestParameters.updateInterval, requestParameters.scheduleType, requestParameters.templateId, requestParameters.includeDeleted, requestParameters.format, options).then((request) => request(this.axios, this.basePath));
     }
     v4WorkflowsPost(requestParameters = {}, options) {
-      return WorkflowsApiFp(this.configuration).v4WorkflowsPost(requestParameters.publicWorkflowCreateRequest, options).then((request) => request(this.axios, this.basePath));
+      return WorkflowsApiFp(this.configuration).v4WorkflowsPost(requestParameters.createWorkflowBody, options).then((request) => request(this.axios, this.basePath));
     }
     v4WorkflowsWorkflowIdAuditlogGet(requestParameters, options) {
       return WorkflowsApiFp(this.configuration).v4WorkflowsWorkflowIdAuditlogGet(requestParameters.workflowId, requestParameters.xApiKey, requestParameters.authorization, requestParameters.page, requestParameters.limit, options).then((request) => request(this.axios, this.basePath));
@@ -52404,6 +52526,11 @@ var init_dist2 = __esm(() => {
     Object: "OBJECT",
     Array: "ARRAY"
   };
+  InboxItemTypeEnum = {
+    ShellyQuestion: "shelly_question",
+    DataQualityIssues: "data_quality_issues",
+    SampleDataReady: "sample_data_ready"
+  };
   CanonicalSchemaFieldDataType = {
     String: DataFieldDataTypeEnum.String,
     Number: DataFieldDataTypeEnum.Number,
@@ -52462,6 +52589,16 @@ This is the main page content.`
   };
   debug4 = logger.extraction;
   TERMINAL_RUN_STATES = /* @__PURE__ */ new Set(["FINISHED", "SUCCESS", "FAILED", "ERROR", "STOPPED", "CANCELLED"]);
+  InboxItemType = {
+    AssistantQuestion: InboxItemTypeEnum.ShellyQuestion,
+    DataQualityIssues: InboxItemTypeEnum.DataQualityIssues,
+    PreviewDataReady: InboxItemTypeEnum.SampleDataReady
+  };
+  knownInboxItemTypes = {
+    [InboxItemTypeEnum.ShellyQuestion]: InboxItemType.AssistantQuestion,
+    [InboxItemTypeEnum.DataQualityIssues]: InboxItemType.DataQualityIssues,
+    [InboxItemTypeEnum.SampleDataReady]: InboxItemType.PreviewDataReady
+  };
   NotificationChannelType = {
     EMAIL: "EMAIL",
     SLACK: "SLACK",
@@ -53089,12 +53226,53 @@ function registerTools(server, ctx, capabilities) {
       }))
     });
   }));
+  server.registerTool("list_inbox", {
+    description: "List personal Kadoa Inbox items that need attention across workflows. " + "Returns unread items by default; set includeRead to true to include acknowledged history. " + "For an Assistant question, use get_workflow_assistant and answer_workflow_assistant_question. " + "For preview data, use workflow detail and data tools to inspect it. " + "This Inbox is separate from notification channel and notification setting tools.",
+    inputSchema: strictSchema({
+      includeRead: exports_external.preprocess(coerceBoolean(), exports_external.boolean()).optional().describe("Include read Inbox history; defaults to false")
+    }),
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true
+    }
+  }, withErrorHandling("list_inbox", async (args) => {
+    const inbox = await ctx.client.inbox.list();
+    const includeRead = args.includeRead ?? false;
+    const items = (includeRead ? inbox.items : inbox.items.filter((item) => !item.isRead)).map((item) => ({
+      ...item,
+      dashboardUrl: item.workflowId ? workflowDashboardUrl(item.workflowId) : null
+    }));
+    return jsonResult({
+      unreadCount: inbox.unreadCount,
+      includeRead,
+      returnedCount: items.length,
+      items
+    });
+  }));
+  server.registerTool("mark_inbox_item_read", {
+    description: "Acknowledge one personal Kadoa Inbox item as read. " + "This does not answer an Assistant question, resume the Assistant, approve preview data, or change workflow state.",
+    inputSchema: strictSchema({
+      itemId: exports_external.string().uuid().describe("Inbox item UUID returned by list_inbox")
+    }),
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true
+    }
+  }, withErrorHandling("mark_inbox_item_read", async (args) => {
+    const result = await ctx.client.inbox.markRead(args.itemId);
+    return jsonResult({
+      itemId: args.itemId,
+      changed: result.readCount === 1
+    });
+  }));
   const urlInputShape = {
     url: exports_external.string().optional().describe("Single URL - prefer using 'urls' instead. If both are provided, 'urls' takes precedence."),
     urls: exports_external.preprocess(coerceArray(true), exports_external.array(exports_external.string()).min(1)).optional().describe("Starting URLs for the workflow (array of strings). Also accepts a single URL string.")
   };
+  const extractionPromptInput = exports_external.string().optional();
   const extractionInputShape = {
-    prompt: exports_external.string().optional().describe('Natural language description of what to extract (e.g., "Extract product prices and names"). Required unless templateId is provided.'),
     name: exports_external.string().optional().describe("Optional name for the workflow"),
     entity: exports_external.string().optional().describe("Entity name for extraction (e.g., 'Product', 'Job Posting')"),
     schema: exports_external.preprocess(coerceArray(), exports_external.array(exports_external.object(SchemaFieldShape).strict())).optional().describe("Extraction schema fields. If omitted, the AI agent auto-detects the schema. When you do supply fields, mark the one that identifies a record with isKey - change detection needs it.")
@@ -53106,23 +53284,27 @@ function registerTools(server, ctx, capabilities) {
     password: exports_external.string().optional().describe("Password (required for 'basic' type)"),
     headers: exports_external.object({}).passthrough().optional().describe("Custom headers as key-value pairs (required for 'header' type)")
   }).optional().describe("Authentication configuration for the webhook endpoint");
+  const notificationChannelsSchema = exports_external.object({
+    email: exports_external.object({
+      recipients: exports_external.array(exports_external.string().email()).optional().describe("Email addresses to notify. Omit to use account default email.")
+    }).optional().describe("Send email notifications. Pass {} for account default email, or {recipients: [...]} for custom addresses."),
+    webhook: exports_external.object({
+      url: exports_external.string().url().describe("Webhook endpoint URL"),
+      httpMethod: exports_external.enum(["POST", "GET", "PUT", "PATCH"]).optional().describe("HTTP method (defaults to POST)"),
+      auth: webhookAuthShape
+    }).optional().describe("Send notifications via HTTP webhook"),
+    slack: exports_external.object({
+      webhookUrl: exports_external.string().url().optional().describe("Slack incoming webhook URL (legacy)"),
+      slackChannelId: exports_external.string().optional().describe("Slack channel ID from OAuth integration (e.g. C01ABCDEF)"),
+      slackChannelName: exports_external.string().optional().describe("Slack channel name (e.g. #alerts)")
+    }).optional().describe("Send notifications to a Slack channel. Use slackChannelId/slackChannelName for OAuth integration, or webhookUrl for legacy incoming webhooks."),
+    websocket: exports_external.boolean().optional().describe("Enable WebSocket notifications for programmatic real-time consumption")
+  });
   const notificationsInputShape = {
-    notifications: exports_external.preprocess(coerceJson(), exports_external.object({
-      email: exports_external.object({
-        recipients: exports_external.array(exports_external.string().email()).optional().describe("Email addresses to notify. Omit to use account default email.")
-      }).optional().describe("Send email notifications. Pass {} for account default email, or {recipients: [...]} for custom addresses."),
-      webhook: exports_external.object({
-        url: exports_external.string().url().describe("Webhook endpoint URL"),
-        httpMethod: exports_external.enum(["POST", "GET", "PUT", "PATCH"]).optional().describe("HTTP method (defaults to POST)"),
-        auth: webhookAuthShape
-      }).optional().describe("Send notifications via HTTP webhook"),
-      slack: exports_external.object({
-        webhookUrl: exports_external.string().url().optional().describe("Slack incoming webhook URL (legacy)"),
-        slackChannelId: exports_external.string().optional().describe("Slack channel ID from OAuth integration (e.g. C01ABCDEF)"),
-        slackChannelName: exports_external.string().optional().describe("Slack channel name (e.g. #alerts)")
-      }).optional().describe("Send notifications to a Slack channel. Use slackChannelId/slackChannelName for OAuth integration, or webhookUrl for legacy incoming webhooks."),
-      websocket: exports_external.boolean().optional().describe("Enable WebSocket notifications for programmatic real-time consumption")
-    }).optional().describe("Notification channels to alert when data changes."))
+    notifications: exports_external.preprocess(coerceJson(), notificationChannelsSchema.optional()).optional().describe("Optional notification channels to alert when data changes.")
+  };
+  const requiredNotificationsInputShape = {
+    notifications: exports_external.preprocess(coerceJson(), notificationChannelsSchema).describe("Notification channels to alert when data changes.")
   };
   function resolveUrls(args) {
     const urls = args.urls ?? (args.url ? [args.url] : []);
@@ -53229,11 +53411,12 @@ function registerTools(server, ctx, capabilities) {
 
 ` + "Create a data extraction workflow using agentic navigation. Supports one-time or scheduled runs. " + "If entity and schema are provided, they guide the extraction; otherwise the AI agent auto-detects the schema from the page. " + "The workflow runs asynchronously and may take several minutes. Do NOT poll or sleep-wait for completion. " + `Return the workflow ID to the user and let them check back later with get_workflow or fetch_data.
 
-` + "PREFER TEMPLATES: If the user's request matches an existing template, instantiate it via `templateId` instead of writing a fresh prompt/schema. " + "Use `list_templates` to discover available templates and `get_template` to inspect schemas before deciding. " + "When creating from a template, call this tool with the template's `templateId`, the source `urls`, and optional `templateVersion` only. Never copy the template prompt, entity, or schema into standalone creation, and never silently match or rewrite inline configuration.\n\n" + "NOTE: This tool is for one-time or scheduled extraction ONLY. " + "For continuous realtime monitoring that watches a page for data changes and sends alerts, use the create_realtime_monitor tool instead.",
+` + "PREFER TEMPLATES: If the user's request matches an existing template, instantiate it via `templateId` instead of writing a fresh prompt/schema. " + "Use `list_templates` to discover available templates and `get_template` to inspect schemas before deciding. " + "When creating from a template, call this tool with the template's `templateId`, the source `urls`, optional `templateVersion`, and optional `prompt` containing only workflow-specific additional instructions. Never copy the template prompt, entity, or schema into the call, and never silently match or rewrite inline configuration.\n\n" + "NOTE: This tool is for one-time or scheduled extraction ONLY. " + "For continuous realtime monitoring that watches a page for data changes and sends alerts, use the create_realtime_monitor tool instead.",
     inputSchema: strictSchema({
+      prompt: extractionPromptInput.describe('Natural language description of what to extract (e.g., "Extract product prices and names"). Required unless templateId is provided. With templateId, use it only for workflow-specific instructions to add to the template prompt.'),
       ...extractionInputShape,
       ...urlInputShape,
-      templateId: exports_external.string().optional().describe("Instantiate this workflow from a published template. Pass the templateId, source urls, and optional templateVersion. Do not copy prompt/entity/schema from the template into this call - they are inherited from the published template version, and the workflow's output conforms to its declared schema. Discover templates via list_templates and get_template."),
+      templateId: exports_external.string().optional().describe("Instantiate this workflow from a published template. Pass the templateId, source urls, optional templateVersion, and optional prompt with workflow-specific additional instructions. Do not copy the template's shared prompt, entity, or schema into this call - they are inherited from the published template version, and the workflow's output conforms to its declared schema. Discover templates via list_templates and get_template."),
       templateVersion: exports_external.preprocess(coerceNumber(), exports_external.number()).optional().describe("Specific published template version (integer) to instantiate. Defaults to the latest published version when templateId is set."),
       description: exports_external.string().max(500).optional().describe("Description of what this workflow does (max 500 characters)"),
       tags: exports_external.preprocess(coerceArray(true), exports_external.array(exports_external.string())).optional().describe("Tags for organizing workflows"),
@@ -53273,8 +53456,8 @@ function registerTools(server, ctx, capabilities) {
     const hasNotifications = !!(n && (n.email || n.webhook || n.slack || n.websocket));
     let workflowId;
     if (args.templateId) {
-      if (args.prompt || args.entity || args.schema) {
-        return errorResult("When 'templateId' is set, 'prompt', 'entity', and 'schema' must NOT be supplied - they are inherited from the template version.");
+      if (args.entity || args.schema) {
+        return errorResult("When 'templateId' is set, 'entity' and 'schema' must NOT be supplied - they are inherited from the template version. Use 'prompt' only for workflow-specific additional instructions.");
       }
       const { id } = await ctx.client.workflow.create({
         urls,
@@ -53285,7 +53468,8 @@ function registerTools(server, ctx, capabilities) {
         tags: args.tags && args.tags.length > 0 ? args.tags : undefined,
         limit: args.limit,
         templateId: args.templateId,
-        templateVersion: args.templateVersion
+        templateVersion: args.templateVersion,
+        userPrompt: args.prompt
       });
       workflowId = id;
       if (hasNotifications) {
@@ -53344,11 +53528,12 @@ function registerTools(server, ctx, capabilities) {
 
 ` + "If entity and schema are provided, they guide what the Assistant should monitor; otherwise the Assistant determines what to watch. " + "Creation is asynchronous and the response includes workflow, session, thread, and job IDs plus a dashboard URL. " + "Use generic workflow Assistant tools (get_workflow_assistant, answer_workflow_assistant_question, interrupt_workflow_assistant, resume_workflow_assistant, stop_workflow_assistant) for follow-up status, questions, and controls. " + "Do NOT poll or sleep-wait for completion.",
     inputSchema: strictSchema({
+      prompt: extractionPromptInput.describe("Optional natural language instructions describing what to monitor and which changes matter. If omitted, the Assistant determines what to watch."),
       ...extractionInputShape,
       ...urlInputShape,
       description: exports_external.string().max(500).optional().describe("Description of what this monitor watches (max 500 characters)"),
       tags: exports_external.preprocess(coerceArray(true), exports_external.array(exports_external.string())).optional().describe("Tags for organizing monitors"),
-      ...notificationsInputShape
+      ...requiredNotificationsInputShape
     }),
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false }
   }, withErrorHandling("create_realtime_monitor", async (args) => {
@@ -54496,7 +54681,7 @@ function registerTools(server, ctx, capabilities) {
     });
   }));
   server.registerTool("list_templates", {
-    description: "List all templates in the current team. Templates define reusable configurations (prompt, schema, validation rules, notifications, and frequency). Use this to find a matching template before creating a workflow. To instantiate a template, call create_workflow with its templateId, source URLs, and optional templateVersion - never copy the template prompt, entity, or schema into standalone creation.",
+    description: "List all templates in the current team. Templates define reusable configurations (prompt, schema, validation rules, notifications, and frequency). Use this to find a matching template before creating a workflow. To instantiate a template, call create_workflow with its templateId, source URLs, optional templateVersion, and optional prompt containing only workflow-specific additional instructions - never copy the template prompt, entity, or schema into the call.",
     inputSchema: strictSchema({}),
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true }
   }, withErrorHandling("list_templates", async () => {
@@ -54504,11 +54689,11 @@ function registerTools(server, ctx, capabilities) {
     return jsonResult({
       templates,
       count: templates.length,
-      instructions: "To instantiate a listed template, call create_workflow with the matching templateId, source URLs, and optional templateVersion. Do not copy the template prompt, entity, or schema into standalone creation."
+      instructions: "To instantiate a listed template, call create_workflow with the matching templateId, source URLs, optional templateVersion, and optional prompt containing only workflow-specific additional instructions. Do not copy the template prompt, entity, or schema into the call."
     });
   }));
   server.registerTool("get_template", {
-    description: "Get a template by ID, including all published versions and their schemas. After inspecting it, instantiate the template with create_workflow using templateId, source URLs, and optional templateVersion. Never copy the returned prompt, entity, or schema into standalone creation - those values are inherited when templateId is passed.",
+    description: "Get a template by ID, including all published versions and their schemas. After inspecting it, instantiate the template with create_workflow using templateId, source URLs, optional templateVersion, and optional prompt containing only workflow-specific additional instructions. Never copy the returned prompt, entity, or schema into the call - those shared values are inherited when templateId is passed.",
     inputSchema: strictSchema({
       templateId: exports_external.string().describe("The template ID")
     }),
@@ -54517,7 +54702,7 @@ function registerTools(server, ctx, capabilities) {
     const template = await ctx.client.template.get(args.templateId);
     return jsonResult({
       template,
-      instructions: `To instantiate this template, call create_workflow with templateId "${args.templateId}", source URLs, and optional templateVersion. Do not copy this template's prompt, entity, or schema into standalone creation.`
+      instructions: `To instantiate this template, call create_workflow with templateId "${args.templateId}", source URLs, optional templateVersion, and optional prompt containing only workflow-specific additional instructions. Do not copy this template's prompt, entity, or schema into the call.`
     });
   }));
   server.registerTool("create_template", {
@@ -54961,7 +55146,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kadoa/mcp",
-    version: "0.5.23",
+    version: "0.5.25",
     description: "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
     type: "module",
     main: "dist/index.js",
@@ -54985,7 +55170,7 @@ var init_package = __esm(() => {
       prepublishOnly: "bun run check-types && bun run test:unit && bun run build"
     },
     dependencies: {
-      "@kadoa/node-sdk": "^0.39.0",
+      "@kadoa/node-sdk": "^0.40.0",
       "@modelcontextprotocol/sdk": "^1.26.0",
       express: "^5.2.1",
       "express-rate-limit": "^8.2.1",
@@ -60575,6 +60760,7 @@ async function createServer(auth, options) {
       "For one-time or scheduled extraction, use create_workflow. Use scrape for an immediate raw HTML or markdown fetch from one URL. Use create_workflow for structured extraction, recurring runs, monitoring, or navigation-heavy jobs.",
       "If a one-time or scheduled workflow fails, retry it with run_workflow using the existing workflow ID. Do NOT delete and recreate the workflow just to retry it - preserve its workflow ID and configuration. Realtime workflows cannot be manually run.",
       "Use list_changes and get_change to retrieve detected diffs from realtime monitoring workflows.",
+      "Use list_inbox when the user asks what needs attention across workflows. Inbox questions are discovered there, then inspected and answered through the workflow Assistant tools; marking an Inbox item read only acknowledges it.",
       "",
       "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 - a detailed prompt with a comprehensive schema produces better results than multiple simple workflows.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kadoa/mcp",
-  "version": "0.5.23",
+  "version": "0.5.25",
   "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.39.0",
+    "@kadoa/node-sdk": "^0.40.0",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "express": "^5.2.1",
     "express-rate-limit": "^8.2.1",