@kadoa/mcp 0.5.15 → 0.5.17

package/dist/index.js

@@ -52171,7 +52171,8 @@ function mapRunStatus(state) {
     case "NOT_SUPPORTED":
       return "failed";
     default:
-      return "failed";
+      console.error(`[list_workflow_runs] unmapped run state, passing through verbatim: ${state}`);
+      return state ?? "unknown";
   }
 }
 function workflowDashboardUrl(workflowId) {
@@ -52397,7 +52398,7 @@ function registerTools(server, ctx, capabilities) {
     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))).optional().describe("Extraction schema fields. If omitted, the AI agent auto-detects the schema.")
+    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.")
   };
   const webhookAuthShape = exports_external.object({
     type: exports_external.enum(["bearer", "basic", "header"]).describe("Authentication type"),
@@ -52434,7 +52435,10 @@ function registerTools(server, ctx, capabilities) {
     return (builder) => {
       const entity = builder.entity(args.entity || "Data");
       for (const field of args.schema) {
-        entity.field(field.name, field.description || field.name, field.dataType || "STRING", { example: field.example });
+        entity.field(field.name, field.description || field.name, field.dataType || "STRING", {
+          example: field.example,
+          isKey: field.isKey
+        });
       }
       return entity;
     };
@@ -52769,7 +52773,7 @@ function registerTools(server, ctx, capabilities) {
     });
   }));
   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.",
+    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. `status` is normally " + "success | failed | in_progress; a run whose backend state this server does not " + "recognize reports that raw state verbatim, so treat any other value as unknown " + "rather than as a failure.",
     inputSchema: {
       workflowId: exports_external.string().describe("The workflow ID"),
       status: exports_external.enum(["success", "failed", "in_progress"]).optional().describe("Filter runs by outcome"),
@@ -52998,13 +53002,15 @@ function registerTools(server, ctx, capabilities) {
   server.registerTool("update_workflow", {
     description: `Update a workflow's configuration. All fields are optional — only provided fields will be updated. Use this to change the name, URLs, extraction schema, entity, prompt, schedule, or other metadata.
 
-` + "IMPORTANT: You cannot change a workflow's interval to or from REAL_TIME. Real-time workflows are architecturally different (Observer service vs Scraper) and must be created as real-time from the start using create_workflow with interval='REAL_TIME'. To switch a workflow between real-time and regular, delete it and create a new one with the correct interval.",
+` + `IMPORTANT: You cannot change a workflow's interval to or from REAL_TIME. Real-time workflows are architecturally different (Observer service vs Scraper) and must be created as real-time from the start using create_workflow with interval='REAL_TIME'. To switch a workflow between real-time and regular, delete it and create a new one with the correct interval.
+
+` + "PROMPT EDITS: `userPrompt` works on most workflows and re-derives the extraction intent. Some agent-built (Shelly) scheduled workflows reject it with `SHELLY_INTENT_REQUIRES_EXTRACTION_SPEC` because their intent is owned elsewhere. " + "If that happens, tell the user to change the extraction intent in Lighthouse chat in the Kadoa dashboard. NEVER delete and recreate the workflow to work around it — that mints a new workflowId, breaking anything downstream keyed to the old one (warehouse tables, connectors) and discarding the workflow's history.",
     inputSchema: strictSchema({
       workflowId: exports_external.string().describe("The workflow ID to update"),
       name: exports_external.string().optional().describe("New name for the workflow"),
       urls: exports_external.preprocess(coerceArray(true), exports_external.array(exports_external.string()).min(1)).optional().describe("New target URLs for the workflow (array of strings). Also accepts a single URL string."),
       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))).optional().describe("New extraction schema fields"),
+      schema: exports_external.preprocess(coerceArray(), exports_external.array(exports_external.object(SchemaFieldShape).strict())).optional().describe("New extraction schema fields. This REPLACES the whole schema — list every field you want to keep, each with its isKey flag, or the omitted ones and their flags are lost. Call get_workflow first and edit the schema it returns."),
       description: exports_external.string().max(500).optional().describe("Workflow description (max 500 characters)"),
       tags: exports_external.preprocess(coerceArray(true), 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)"),
@@ -53471,11 +53477,13 @@ function registerTools(server, ctx, capabilities) {
     });
   }));
   server.registerTool("update_template", {
-    description: "Update a template's name or description. At least one field must be provided.",
+    description: `Update a template's name or description ONLY. At least one of the two must be provided.
+
+` + "This tool CANNOT change what linked workflows inherit — prompt, schema, validation rules, notifications and frequency all live in template *versions*, which are immutable snapshots. " + "To change any of those, publish a new version with `create_template_version` (the version IS the edit), then roll it out to linked workflows with `apply_template_version`. " + "There is no in-place edit of a published version, and never report a prompt or schema change as impossible — versioning is the supported path.",
     inputSchema: strictSchema({
       templateId: exports_external.string().describe("The template ID to update"),
-      name: exports_external.preprocess(coerceNull(), exports_external.string().optional()).describe("New template name"),
-      description: exports_external.preprocess(coerceNull(), exports_external.string().optional()).describe("New template description")
+      name: exports_external.preprocess(coerceNull(), exports_external.string().optional()).optional().describe("New template name"),
+      description: exports_external.preprocess(coerceNull(), exports_external.string().optional()).optional().describe("New template description")
     }),
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true }
   }, withErrorHandling("update_template", async (args) => {
@@ -53527,12 +53535,14 @@ function registerTools(server, ctx, capabilities) {
     }))).optional().describe("Predefined categories for a CLASSIFICATION field ({title, definition}[]). Required for fieldType=CLASSIFICATION; omitted otherwise.")
   };
   server.registerTool("create_template_version", {
-    description: "Publish a new version of a template. Versions capture the full workflow config: prompt, schema, and notifications. All fields are optional — include only what this version should set.",
+    description: `Publish a new version of a template. Versions capture the full workflow config: prompt, schema, and notifications. All fields are optional — include only what this version should set.
+
+` + "THIS IS HOW YOU EDIT A TEMPLATE'S PROMPT OR SCHEMA. Published versions are immutable, so 'changing the template prompt' means publishing a new version here and then calling `apply_template_version` to push it onto linked workflows. " + "`update_template` only renames a template; it cannot touch prompt or schema.",
     inputSchema: strictSchema({
       templateId: exports_external.string().describe("The template ID to publish a version for"),
       prompt: exports_external.string().optional().describe("User prompt to copy into workflow config"),
       schemaId: exports_external.string().optional().describe("Existing schema ID to reference (mutually exclusive with schemaFields)"),
-      schemaFields: exports_external.preprocess(coerceArray(), exports_external.array(exports_external.object(TemplateSchemaFieldShape))).optional().describe("Inline schema fields to create a new schema (mutually exclusive with schemaId)"),
+      schemaFields: exports_external.preprocess(coerceArray(), exports_external.array(exports_external.object(TemplateSchemaFieldShape).strict())).optional().describe("Inline schema fields to create a new schema (mutually exclusive with schemaId)"),
       schemaEntity: exports_external.string().optional().describe("Entity name for the inline schema"),
       schemaValidationRules: exports_external.preprocess(coerceJson(), exports_external.record(exports_external.string(), exports_external.record(exports_external.string(), exports_external.unknown()))).optional().describe("Per-field schema validation rules, keyed by field name. Not inherited from prior versions — omitting this on a new version drops any rules the previous version had."),
       notifications: exports_external.preprocess(coerceArray(), exports_external.array(exports_external.object({
@@ -53702,9 +53712,7 @@ var init_tools = __esm(() => {
     description: exports_external.string().optional().describe("What this field contains"),
     example: exports_external.string().describe("Example value"),
     dataType: exports_external.enum(["STRING", "NUMBER", "BOOLEAN", "DATE", "DATETIME", "MONEY", "IMAGE", "LINK", "OBJECT", "ARRAY"]).optional().describe("Data type for the field"),
-    isPrimaryKey: exports_external.boolean().optional(),
-    isRequired: exports_external.boolean().optional(),
-    isUnique: exports_external.boolean().optional()
+    isKey: exports_external.preprocess(coerceBoolean(), exports_external.boolean()).optional().describe("Marks this field as a key field — the stable identity used to match records across runs. Change detection diffs records by their key fields, so a monitored or real-time workflow without one cannot tell an updated record from a new one. Set it on whatever uniquely identifies a row (a detail URL, an ID, a ticker).")
   };
   WORKFLOW_AUDIT_WATCHED_KEYS = [
     "name",
@@ -53724,7 +53732,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kadoa/mcp",
-    version: "0.5.15",
+    version: "0.5.17",
     description: "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
     type: "module",
     main: "dist/index.js",

package/package.json

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