@kadoa/mcp 0.5.24 → 0.5.26

package/README.md

@@ -88,6 +88,16 @@ Point your client to `https://mcp.kadoa.com/mcp` with OAuth authentication.
 | `team_list` | List all teams you belong to and see which is active |
 | `team_switch` | Switch the active team by name or ID |
 
+## Workflow controls and behavior
+
+For detailed customer guidance, see the [Kadoa documentation](https://docs.kadoa.com/docs/introduction), including [workflows](https://docs.kadoa.com/docs/workflows/overview), [Workflow Assistant](https://docs.kadoa.com/docs/sdk/workflows/assistant), [Personal Inbox](https://docs.kadoa.com/docs/sdk/inbox), [notifications](https://docs.kadoa.com/docs/notifications), and [templates](https://docs.kadoa.com/docs/templates).
+
+- **Assistant work vs. schedule:** `interrupt_workflow_assistant`, `resume_workflow_assistant`, and `stop_workflow_assistant` control the Assistant session only; they do not pause scheduled workflow runs. Use `pause_workflow` to stop an active workflow's schedule and `approve_workflow` to activate it again.
+- **Inbox acknowledgement:** `mark_inbox_item_read` only acknowledges an item. For an Assistant question, inspect it with `get_workflow_assistant`, then use `answer_workflow_assistant_question` to answer and resume; use `resume_workflow_assistant` only for an idle or interrupted Assistant.
+- **Run history:** `list_workflow_runs` filters by `status` (`success`, `failed`, or `in_progress`) and supports 1-based `page` and `limit` pagination.
+- **Notifications:** `create_realtime_monitor` requires at least one email, webhook, Slack, or WebSocket notification channel. Notifications are optional when creating a standard one-time or scheduled workflow with `create_workflow`.
+- **Template changes:** `update_template` changes template name and description only. To change template-controlled configuration, create an immutable version with `create_template_version`, then roll it out to linked workflows with `apply_template_version`.
+
 ## Usage Examples
 
 Once the MCP server is configured, you can manage the full workflow lifecycle through natural conversation. Here are a few common operations shown as Claude Code sessions.

package/dist/index.js

@@ -52654,6 +52654,15 @@ This is the main page content.`
 });
 
 // src/client.ts
+function isScrapeRequest(url3) {
+  if (!url3)
+    return false;
+  try {
+    return new URL(url3, "https://api.kadoa.com").pathname === "/v4/scrape";
+  } catch {
+    return false;
+  }
+}
 function createKadoaClient(auth) {
   const { principal } = auth;
   const client = new KadoaClient({
@@ -52662,11 +52671,14 @@ function createKadoaClient(auth) {
   client.axiosInstance.interceptors.request.use((config2) => {
     config2.headers["x-kadoa-source"] = "mcp";
     config2.headers["x-team-id"] = principal.teamId;
+    if (isScrapeRequest(config2.url)) {
+      config2.timeout = MCP_SCRAPE_REQUEST_TIMEOUT_MS;
+    }
     return config2;
   });
   return client;
 }
-var refreshRawMutex, ctxRefreshMutex;
+var MCP_SCRAPE_REQUEST_TIMEOUT_MS = 310000, refreshRawMutex, ctxRefreshMutex;
 var init_client = __esm(() => {
   init_dist2();
   refreshRawMutex = new Map;
@@ -52698,9 +52710,19 @@ __export(exports_client, {
   decodeJwtClaims: () => decodeJwtClaims,
   createKadoaClient: () => createKadoaClient2,
   SessionExpiredError: () => SessionExpiredError,
+  MCP_SCRAPE_REQUEST_TIMEOUT_MS: () => MCP_SCRAPE_REQUEST_TIMEOUT_MS2,
   KadoaSdkException: () => KadoaSdkException,
   KadoaClient: () => KadoaClient
 });
+function isScrapeRequest2(url3) {
+  if (!url3)
+    return false;
+  try {
+    return new URL(url3, "https://api.kadoa.com").pathname === "/v4/scrape";
+  } catch {
+    return false;
+  }
+}
 function createKadoaClient2(auth) {
   const { principal } = auth;
   const client = new KadoaClient({
@@ -52709,6 +52731,9 @@ function createKadoaClient2(auth) {
   client.axiosInstance.interceptors.request.use((config2) => {
     config2.headers["x-kadoa-source"] = "mcp";
     config2.headers["x-team-id"] = principal.teamId;
+    if (isScrapeRequest2(config2.url)) {
+      config2.timeout = MCP_SCRAPE_REQUEST_TIMEOUT_MS2;
+    }
     return config2;
   });
   return client;
@@ -52819,7 +52844,7 @@ async function getValidJwt(ctx) {
   ctxRefreshMutex2.set(ctx, promise3);
   return promise3;
 }
-var SessionExpiredError, refreshRawMutex2, ctxRefreshMutex2;
+var MCP_SCRAPE_REQUEST_TIMEOUT_MS2 = 310000, SessionExpiredError, refreshRawMutex2, ctxRefreshMutex2;
 var init_client2 = __esm(() => {
   init_dist2();
   SessionExpiredError = class SessionExpiredError extends Error {
@@ -53284,23 +53309,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] : []);
@@ -53529,7 +53558,7 @@ function registerTools(server, ctx, capabilities) {
       ...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) => {
@@ -55142,7 +55171,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kadoa/mcp",
-    version: "0.5.24",
+    version: "0.5.26",
     description: "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
     type: "module",
     main: "dist/index.js",
@@ -55160,7 +55189,7 @@ var init_package = __esm(() => {
       build: "bun build src/index.ts --outdir=dist --target=node --external express --external ioredis",
       "check-types": "tsc --noEmit",
       test: "BUN_TEST=1 bun test",
-      "test:unit": "BUN_TEST=1 bun test tests/unit/server.test.ts --timeout=120000 && BUN_TEST=1 bun test $(find tests/unit -maxdepth 1 -name '*.test.ts' ! -name 'server.test.ts') --timeout=120000",
+      "test:unit": "BUN_TEST=1 bun test tests/unit/server.test.ts --timeout=120000 && BUN_TEST=1 bun test tests/unit/client.test.ts --timeout=120000 && BUN_TEST=1 bun test tests/unit/proactive-refresh.test.ts --timeout=120000 && BUN_TEST=1 bun test $(find tests/unit -maxdepth 1 -name '*.test.ts' ! -name 'server.test.ts' ! -name 'client.test.ts' ! -name 'proactive-refresh.test.ts') --timeout=120000",
       "test:e2e": "BUN_TEST=1 bun test tests/e2e --timeout=600000",
       "test:eval": "BUN_TEST=1 bun test tests/evals --timeout=300000",
       prepublishOnly: "bun run check-types && bun run test:unit && bun run build"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kadoa/mcp",
-  "version": "0.5.24",
+  "version": "0.5.26",
   "description": "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
   "type": "module",
   "main": "dist/index.js",
@@ -18,7 +18,7 @@
     "build": "bun build src/index.ts --outdir=dist --target=node --external express --external ioredis",
     "check-types": "tsc --noEmit",
     "test": "BUN_TEST=1 bun test",
-    "test:unit": "BUN_TEST=1 bun test tests/unit/server.test.ts --timeout=120000 && BUN_TEST=1 bun test $(find tests/unit -maxdepth 1 -name '*.test.ts' ! -name 'server.test.ts') --timeout=120000",
+    "test:unit": "BUN_TEST=1 bun test tests/unit/server.test.ts --timeout=120000 && BUN_TEST=1 bun test tests/unit/client.test.ts --timeout=120000 && BUN_TEST=1 bun test tests/unit/proactive-refresh.test.ts --timeout=120000 && BUN_TEST=1 bun test $(find tests/unit -maxdepth 1 -name '*.test.ts' ! -name 'server.test.ts' ! -name 'client.test.ts' ! -name 'proactive-refresh.test.ts') --timeout=120000",
     "test:e2e": "BUN_TEST=1 bun test tests/e2e --timeout=600000",
     "test:eval": "BUN_TEST=1 bun test tests/evals --timeout=300000",
     "prepublishOnly": "bun run check-types && bun run test:unit && bun run build"