@kadoa/mcp 0.5.25 → 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 {
@@ -55146,7 +55171,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kadoa/mcp",
-    version: "0.5.25",
+    version: "0.5.26",
     description: "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
     type: "module",
     main: "dist/index.js",
@@ -55164,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.25",
+  "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"