@kadoa/mcp 0.5.14 → 0.5.15

package/README.md

@@ -66,6 +66,7 @@ Point your client to `https://mcp.kadoa.com/mcp` with OAuth authentication.
 | `list_workflows` | List all workflows with status |
 | `get_workflow` | Get detailed workflow information |
 | `get_workflow_history` | Get the workflow's configuration revision history (audit log) — who changed it, when, from which channel, and a `changedFields` summary per revision |
+| `list_workflow_runs` | List a workflow's execution run history (status, start/finish, record count, errors); filter by outcome and paginate |
 | `run_workflow` | Execute a workflow |
 | `fetch_data` | Get extracted data from a workflow |
 | `delete_workflow` | Delete a workflow |

package/dist/index.js

@@ -48467,7 +48467,7 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
         options: localVarRequestOptions
       };
     },
-    v4WorkflowsWorkflowIdHistoryGet: async (workflowId, options = {}) => {
+    v4WorkflowsWorkflowIdHistoryGet: async (workflowId, page, limit, status, options = {}) => {
       assertParamExists("v4WorkflowsWorkflowIdHistoryGet", "workflowId", workflowId);
       const localVarPath = `/v4/workflows/{workflowId}/history`.replace(`{${"workflowId"}}`, encodeURIComponent(String(workflowId)));
       const localVarUrlObj = new URL$1(localVarPath, DUMMY_BASE_URL);
@@ -48479,6 +48479,15 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
       const localVarHeaderParameter = {};
       const localVarQueryParameter = {};
       await setApiKeyToObject(localVarHeaderParameter, "x-api-key", configuration);
+      if (page !== undefined) {
+        localVarQueryParameter["page"] = page;
+      }
+      if (limit !== undefined) {
+        localVarQueryParameter["limit"] = limit;
+      }
+      if (status !== undefined) {
+        localVarQueryParameter["status"] = status;
+      }
       localVarHeaderParameter["Accept"] = "application/json";
       setSearchParams(localVarUrlObj, localVarQueryParameter);
       let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
@@ -48842,8 +48851,8 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
       const localVarOperationServerBasePath = operationServerMap["WorkflowsApi.v4WorkflowsWorkflowIdGet"]?.[localVarOperationServerIndex]?.url;
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, axios_default, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
     },
-    async v4WorkflowsWorkflowIdHistoryGet(workflowId, options) {
-      const localVarAxiosArgs = await localVarAxiosParamCreator.v4WorkflowsWorkflowIdHistoryGet(workflowId, options);
+    async v4WorkflowsWorkflowIdHistoryGet(workflowId, page, limit, status, options) {
+      const localVarAxiosArgs = await localVarAxiosParamCreator.v4WorkflowsWorkflowIdHistoryGet(workflowId, page, limit, status, options);
       const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
       const localVarOperationServerBasePath = operationServerMap["WorkflowsApi.v4WorkflowsWorkflowIdHistoryGet"]?.[localVarOperationServerIndex]?.url;
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, axios_default, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
@@ -49308,7 +49317,7 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
   async executeExtraction(options) {
     this.validateOptions(options);
     const config2 = {
-      ...merge3(DEFAULT_OPTIONS, options)
+      ...merge3(merge3({}, DEFAULT_OPTIONS), options)
     };
     const isRealTime = config2.interval === "REAL_TIME";
     if (isRealTime) {
@@ -49591,7 +49600,7 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
     assert2(startedJob.jobId, "Job ID is not set");
     debug4("Job started: %O", startedJob);
     this._jobId = startedJob.jobId;
-    const finishedJob = await this.workflowsCoreService.waitForJobCompletion(this._workflowId, startedJob.jobId);
+    const finishedJob = await this.workflowsCoreService.waitForJobCompletion(this._workflowId, startedJob.jobId, { timeoutMs: 30 * 60 * 1000 });
     debug4("Job finished: %O", finishedJob);
     return this;
   }
@@ -50019,7 +50028,7 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
     }));
     return channels;
   }
-}, PUBLIC_API_URI, WSS_API_URI, REALTIME_API_URI, SDK_VERSION = "0.35.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.36.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();
@@ -50941,6 +50950,15 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
     });
     return response.data;
   }
+  async listWorkflowRuns(id, options) {
+    const response = await this.workflowsApi.v4WorkflowsWorkflowIdHistoryGet({
+      workflowId: id,
+      page: options?.page,
+      limit: options?.limit,
+      status: options?.status
+    });
+    return response.data;
+  }
   async delete(id) {
     await this.workflowsApi.v4WorkflowsWorkflowIdDelete({
       workflowId: id
@@ -51703,7 +51721,7 @@ var init_dist2 = __esm(() => {
       return WorkflowsApiFp(this.configuration).v4WorkflowsWorkflowIdGet(requestParameters.workflowId, options).then((request) => request(this.axios, this.basePath));
     }
     v4WorkflowsWorkflowIdHistoryGet(requestParameters, options) {
-      return WorkflowsApiFp(this.configuration).v4WorkflowsWorkflowIdHistoryGet(requestParameters.workflowId, options).then((request) => request(this.axios, this.basePath));
+      return WorkflowsApiFp(this.configuration).v4WorkflowsWorkflowIdHistoryGet(requestParameters.workflowId, requestParameters.page, requestParameters.limit, requestParameters.status, options).then((request) => request(this.axios, this.basePath));
     }
     v4WorkflowsWorkflowIdJobsJobIdGet(requestParameters, options) {
       return WorkflowsApiFp(this.configuration).v4WorkflowsWorkflowIdJobsJobIdGet(requestParameters.workflowId, requestParameters.jobId, options).then((request) => request(this.axios, this.basePath));
@@ -51799,7 +51817,7 @@ This is the main page content.`
   DEFAULT_OPTIONS = {
     mode: "run",
     pollingInterval: 5000,
-    maxWaitTime: 300000,
+    maxWaitTime: 30 * 60 * 1000,
     location: { type: "auto" },
     bypassPreview: true,
     autoStart: true
@@ -52141,6 +52159,21 @@ function deriveStatusLabel(workflow) {
       return ds ?? "Unknown";
   }
 }
+function mapRunStatus(state) {
+  switch (state) {
+    case "FINISHED":
+      return "success";
+    case "IN_PROGRESS":
+    case "VALIDATING":
+      return "in_progress";
+    case "FAILED":
+    case "FAILED_INSUFFICIENT_FUNDS":
+    case "NOT_SUPPORTED":
+      return "failed";
+    default:
+      return "failed";
+  }
+}
 function workflowDashboardUrl(workflowId) {
   return `${DASHBOARD_BASE_URL}/workflow/${workflowId}`;
 }
@@ -52735,6 +52768,35 @@ function registerTools(server, ctx, capabilities) {
       entries
     });
   }));
+  server.registerTool("list_workflow_runs", {
+    description: "List a workflow's execution run history — each run's status, start/finish time, " + "record count, and errors. Use to answer 'when did this last succeed?' " + "(status='success', limit=1) or 'recent success/failure pattern?'. Distinct from " + "get_workflow_history, which is the config audit log.",
+    inputSchema: {
+      workflowId: exports_external.string().describe("The workflow ID"),
+      status: exports_external.enum(["success", "failed", "in_progress"]).optional().describe("Filter runs by outcome"),
+      page: exports_external.preprocess(coerceNumber(), exports_external.number()).optional().describe("Page number, 1-based (default: 1)"),
+      limit: exports_external.preprocess(coerceNumber(), exports_external.number()).optional().describe("Runs per page (default: 25)")
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true }
+  }, withErrorHandling("list_workflow_runs", async (args) => {
+    const response = await ctx.client.workflow.listWorkflowRuns(args.workflowId, {
+      page: args.page,
+      limit: args.limit,
+      status: args.status
+    });
+    return jsonResult({
+      workflowId: response.workflowId,
+      runs: (response.workflowRuns ?? []).map((r) => ({
+        id: r.id,
+        status: mapRunStatus(r.state),
+        startedAt: r.startedAt,
+        finishedAt: r.finishedAt,
+        records: r.records,
+        errors: r.errors
+      })),
+      totalCount: response.totalCount,
+      pagination: response.pagination
+    });
+  }));
   server.registerTool("run_workflow", {
     description: "Run a workflow to extract fresh data. The run is asynchronous and may take several minutes. Do NOT poll or sleep-wait for completion. Return the workflow ID to the user and let them check status with get_workflow or fetch results later with fetch_data.",
     inputSchema: {
@@ -53662,7 +53724,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kadoa/mcp",
-    version: "0.5.14",
+    version: "0.5.15",
     description: "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
     type: "module",
     main: "dist/index.js",
@@ -53686,7 +53748,7 @@ var init_package = __esm(() => {
       prepublishOnly: "bun run check-types && bun run test:unit && bun run build"
     },
     dependencies: {
-      "@kadoa/node-sdk": "^0.35.0",
+      "@kadoa/node-sdk": "^0.36.0",
       "@modelcontextprotocol/sdk": "^1.26.0",
       express: "^5.2.1",
       "express-rate-limit": "^8.2.1",

package/package.json

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