@kadoa/mcp 0.3.0 → 0.3.1-rc.0

package/dist/index.js

@@ -49226,14 +49226,54 @@ function withErrorHandling(name, handler) {
   };
 }
 function registerTools(server, ctx) {
+  server.registerTool("whoami", {
+    description: "Show current user details: email, authentication method, and team memberships",
+    inputSchema: {},
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true }
+  }, withErrorHandling("whoami", async () => {
+    const jwt2 = await getValidJwt(ctx);
+    const user = await ctx.client.user.getCurrentUser();
+    const authMethod = jwt2 ? "OAuth (JWT)" : "API Key";
+    const teams = await ctx.client.listTeams(jwt2 ? { bearerToken: jwt2 } : undefined);
+    const config2 = loadConfig2();
+    const activeTeamId = ctx.teamId ?? config2.teamId ?? teams[0]?.id;
+    return jsonResult({
+      email: user.email,
+      authMethod,
+      teams: teams.map((t) => ({
+        name: t.name,
+        role: t.role,
+        ...t.id === activeTeamId ? { active: true } : {}
+      }))
+    });
+  }));
   server.registerTool("create_workflow", {
-    description: "Create a new agentic navigation workflow. If entity and schema are provided, they guide the extraction. Otherwise, the AI agent auto-detects the schema from the page based on the prompt. The workflow runs asynchronously and may take several minutes. Do NOT poll or sleep-wait for completion. Instead, return the workflow ID to the user and let them check back later with get_workflow or fetch_data.",
+    description: "Create a new workflow that extracts data using agentic navigation. Supports one-time, scheduled, and real-time (continuous monitoring) modes via the interval parameter. If entity and schema are provided, they guide the extraction. Otherwise, the AI agent auto-detects the schema from the page based on the prompt. The workflow runs asynchronously and may take several minutes. Do NOT poll or sleep-wait for completion. Instead, return the workflow ID to the user and let them check back later with get_workflow or fetch_data.",
     inputSchema: {
       prompt: exports_external.string().describe('Natural language description of what to extract (e.g., "Extract product prices and names")'),
       urls: exports_external.array(exports_external.string()).min(1).describe("Starting URLs for the workflow"),
       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.array(exports_external.object(SchemaFieldShape)).optional().describe("Extraction schema fields. If omitted, the AI agent auto-detects the schema.")
+      schema: exports_external.array(exports_external.object(SchemaFieldShape)).optional().describe("Extraction schema fields. If omitted, the AI agent auto-detects the schema."),
+      interval: exports_external.enum([
+        "ONLY_ONCE",
+        "EVERY_10_MINUTES",
+        "HALF_HOURLY",
+        "HOURLY",
+        "THREE_HOURLY",
+        "SIX_HOURLY",
+        "TWELVE_HOURLY",
+        "EIGHTEEN_HOURLY",
+        "DAILY",
+        "TWO_DAY",
+        "THREE_DAY",
+        "WEEKLY",
+        "BIWEEKLY",
+        "TRIWEEKLY",
+        "FOUR_WEEKS",
+        "MONTHLY",
+        "REAL_TIME"
+      ]).optional().describe("How often the workflow runs. Defaults to ONLY_ONCE. Use REAL_TIME for continuous monitoring.")
     },
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false }
   }, withErrorHandling("create_workflow", async (args) => {
@@ -49249,12 +49289,14 @@ function registerTools(server, ctx) {
       name: args.name || "Untitled Workflow",
       navigationMode: "agentic-navigation",
       userPrompt: args.prompt,
-      extraction
+      extraction,
+      interval: args.interval
     }).create();
+    const message = args.interval === "REAL_TIME" ? "Workflow created successfully. This real-time workflow monitors continuously — no manual runs needed. Use fetch_data to retrieve the latest extracted results." : "Workflow created successfully. The AI agent will start extracting data automatically.";
     return jsonResult({
       success: true,
       workflowId: workflow.workflowId,
-      message: "Workflow created successfully. The AI agent will start extracting data automatically."
+      message
     });
   }));
   server.registerTool("list_workflows", {
@@ -49298,6 +49340,7 @@ function registerTools(server, ctx) {
       urls: workflow.urls,
       schema: workflow.schema,
       navigationMode: workflow.navigationMode,
+      updateInterval: workflow.updateInterval,
       totalRecords: workflow.totalRecords,
       startedAt: workflow.startedAt,
       finishedAt: workflow.finishedAt,
@@ -49313,6 +49356,10 @@ function registerTools(server, ctx) {
     },
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false }
   }, withErrorHandling("run_workflow", async (args) => {
+    const workflow = await ctx.client.workflow.get(args.workflowId);
+    if (workflow.updateInterval === "REAL_TIME") {
+      return errorResult("Real-time workflows run continuously and cannot be triggered manually. " + "Use fetch_data to retrieve the latest extracted results.");
+    }
     const result = await ctx.client.workflow.runWorkflow(args.workflowId, {
       limit: args.limit || 1000
     });
@@ -49380,7 +49427,26 @@ function registerTools(server, ctx) {
       description: exports_external.string().optional().describe("Workflow description"),
       tags: exports_external.array(exports_external.string()).optional().describe("Tags for organizing workflows"),
       userPrompt: exports_external.string().optional().describe("Navigation prompt for agentic-navigation mode (10-5000 characters)"),
-      updateInterval: exports_external.enum(["ONLY_ONCE", "HOURLY", "DAILY", "WEEKLY", "MONTHLY", "CUSTOM"]).optional().describe("How often the workflow should run"),
+      updateInterval: exports_external.enum([
+        "ONLY_ONCE",
+        "EVERY_10_MINUTES",
+        "HALF_HOURLY",
+        "HOURLY",
+        "THREE_HOURLY",
+        "SIX_HOURLY",
+        "TWELVE_HOURLY",
+        "EIGHTEEN_HOURLY",
+        "DAILY",
+        "TWO_DAY",
+        "THREE_DAY",
+        "WEEKLY",
+        "BIWEEKLY",
+        "TRIWEEKLY",
+        "FOUR_WEEKS",
+        "MONTHLY",
+        "REAL_TIME",
+        "CUSTOM"
+      ]).optional().describe("How often the workflow should run. Use REAL_TIME for continuous monitoring, CUSTOM with schedules for cron-based."),
       schedules: exports_external.array(exports_external.string()).optional().describe("Cron expressions for CUSTOM update interval"),
       limit: exports_external.number().optional().describe("Maximum number of records to extract per run")
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kadoa/mcp",
-  "version": "0.3.0",
+  "version": "0.3.1-rc.0",
   "description": "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
   "type": "module",
   "main": "dist/index.js",