@kadoa/mcp 0.7.3 → 0.7.4

package/dist/index.js

@@ -17,7 +17,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kadoa/mcp",
-    version: "0.7.3",
+    version: "0.7.4",
     description: "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
     type: "module",
     main: "dist/index.js",
@@ -492,7 +492,7 @@ function normalizeDataFilters(val, ctx) {
   }
   return v;
 }
-var UpdateIntervalSchema, NOTIFICATION_EVENT_TYPES, NotificationEventTypeSchema, SchemaFieldDataTypeSchema, SchemaFieldShape, SchemaValidationPresenceRule, SchemaValidationUniquenessRule, SchemaValidationBoundRule, SchemaValidationStringFormatRule, SchemaValidationFieldRulesSchema, SchemaValidationRulesSchema, SCHEMA_VALIDATION_ATTRIBUTION_KEYS, LocationSchema, MonitoringValueOperators, MonitoringValuelessOperators, MonitoringConditionOperatorSchema, MonitoringConditionSchema, MonitoringSchema, urlInputShape, extractionPromptInput, extractionInputShape, webhookAuthShape, notificationChannelsSchema, notificationsInputShape, requiredNotificationsInputShape, DATA_FILTER_OPERATORS, DATA_FILTER_VALUELESS_OPERATORS, DATA_FILTER_LIST_OPERATORS, DataFilterSchema, dataFiltersInput;
+var UpdateIntervalSchema, NOTIFICATION_EVENT_TYPES, NotificationEventTypeSchema, SchemaFieldDataTypeSchema, SchemaFieldShape, SchemaValidationPresenceRule, SchemaValidationUniquenessRule, SchemaValidationBoundRule, SchemaValidationStringFormatRule, SchemaValidationFieldRulesSchema, SchemaValidationRulesSchema, SCHEMA_VALIDATION_ATTRIBUTION_KEYS, LocationSchema, MonitoringValueOperators, MonitoringValuelessOperators, MonitoringConditionOperatorSchema, MonitoringConditionSchema, MonitoringSchema, urlInputShape, extractionPromptInput, templateInputShape, extractionInputShape, webhookAuthShape, notificationChannelsSchema, notificationsInputShape, requiredNotificationsInputShape, DATA_FILTER_OPERATORS, DATA_FILTER_VALUELESS_OPERATORS, DATA_FILTER_LIST_OPERATORS, DataFilterSchema, dataFiltersInput;
 var init_schemas = __esm(() => {
   init_portable_schema();
   UpdateIntervalSchema = z.enum([
@@ -712,6 +712,10 @@ var init_schemas = __esm(() => {
     urls: z.preprocess(coerceArray(true), z.array(z.string()).min(1)).optional().describe("Starting URLs for the workflow (array of strings). Also accepts a single URL string.")
   };
   extractionPromptInput = z.string().optional();
+  templateInputShape = {
+    templateId: z.string().optional().describe("Instantiate from a published template. Pass templateId, source urls, optional templateVersion, and optional prompt with workflow-specific additional instructions. Entity and schema are inherited; do not copy the template's shared prompt, entity, or schema. Discover templates via list_templates and get_template."),
+    templateVersion: z.preprocess(coerceNumber(), z.number()).optional().describe("Specific published template version (integer) to instantiate. Defaults to the latest published version when templateId is set.")
+  };
   extractionInputShape = {
     name: z.string().optional().describe("Optional name for the workflow"),
     entity: z.string().optional().describe("Entity name for extraction (e.g., 'Product', 'Job Posting')"),
@@ -1408,6 +1412,223 @@ var init_compliance = __esm(() => {
   init_schemas();
 });
 
+// src/tools/shared/budget.ts
+function jsonBytes(value) {
+  const text = JSON.stringify(value);
+  return text === undefined ? 0 : Buffer.byteLength(text, "utf8");
+}
+function truncateUtf8(text, maxBytes) {
+  if (Buffer.byteLength(text, "utf8") <= maxBytes)
+    return text;
+  const { read } = new TextEncoder().encodeInto(text, new Uint8Array(Math.max(0, maxBytes)));
+  return text.slice(0, read);
+}
+function previewValue(value, maxBytes = VALUE_PREVIEW_BYTES) {
+  if (value === undefined || value === null)
+    return null;
+  const bytes = Buffer.byteLength(JSON.stringify(value), "utf8");
+  if (bytes <= maxBytes)
+    return value;
+  if (typeof value === "string")
+    return `${truncateUtf8(value, maxBytes)}… [cut, ${bytes} bytes]`;
+  if (Array.isArray(value))
+    return `[array of ${value.length} items, ${bytes} bytes]`;
+  return `[${typeof value}, ${bytes} bytes]`;
+}
+function fitItems(options) {
+  const budget = options.budgetBytes ?? RESULT_BUDGET_BYTES;
+  const all = [...options.items];
+  if (jsonBytes(options.build(all)) <= budget)
+    return { kept: all, omitted: 0, truncated: false };
+  const limit = budget - TRUNCATION_RESERVE_BYTES - (options.reserveBytes ?? 0);
+  let lo = 0;
+  let hi = all.length - 1;
+  while (lo < hi) {
+    const mid = Math.ceil((lo + hi) / 2);
+    if (jsonBytes(options.build(all.slice(0, mid))) <= limit)
+      lo = mid;
+    else
+      hi = mid - 1;
+  }
+  return { kept: all.slice(0, lo), omitted: all.length - lo, truncated: true };
+}
+function truncationNotice(options) {
+  const budgetBytes = options.budgetBytes ?? RESULT_BUDGET_BYTES;
+  const total = options.kept + options.omitted;
+  return {
+    truncated: true,
+    truncation: { kept: options.kept, omitted: options.omitted, budgetBytes },
+    hint: `Result cut to ${options.kept} of ${total} ${options.noun} to stay under ${Math.round(budgetBytes / 1000)} KB. ${options.hint}`
+  };
+}
+function highlyDivisibleFloor(n) {
+  if (n <= 0)
+    return 0;
+  if (n >= 10)
+    return Math.floor(n / 10) * 10;
+  let p = 1;
+  while (p * 2 <= n)
+    p *= 2;
+  return p;
+}
+function alignedKeep(offset, fit) {
+  if (offset === 0)
+    return highlyDivisibleFloor(fit);
+  for (let keep = fit;keep >= 1; keep--) {
+    if (offset % keep === 0 && offset / keep + 2 <= MAX_PAGE)
+      return keep;
+  }
+  return 0;
+}
+function resumeNumberedPage(meta, options) {
+  const { next: _replaced, totalPages: _droppedTotalPages, ...rest } = meta;
+  if (options.kept === 0)
+    return { ...rest, hasMore: false };
+  const offset = (options.page - 1) * options.limit;
+  return {
+    ...rest,
+    hasMore: true,
+    next: nextArgs(options.args, { page: offset / options.kept + 2, limit: options.kept })
+  };
+}
+function budgetNumberedPage(options) {
+  const offset = (options.page - 1) * options.limit;
+  const fit = fitItems({
+    items: options.items,
+    build: (kept) => options.build(kept, options.pagination),
+    reserveBytes: jsonBytes({ pagination: { next: options.args } })
+  });
+  if (!fit.truncated)
+    return options.build([...options.items], options.pagination);
+  const buildCut = (fitCount) => {
+    const keep = alignedKeep(offset, fitCount);
+    const alignmentImpossible = keep === 0 && fitCount > 0;
+    const pagination = resumeNumberedPage(options.pagination, {
+      args: options.args,
+      page: options.page,
+      limit: options.limit,
+      kept: keep
+    });
+    const hint = keep > 0 ? options.resumeHint : alignmentImpossible ? options.alignmentImpossibleHint ?? DEFAULT_ALIGNMENT_IMPOSSIBLE_HINT : options.emptyHint;
+    const result = {
+      ...options.build(options.items.slice(0, keep), pagination),
+      ...truncationNotice({ kept: keep, omitted: options.items.length - keep, noun: options.noun, hint })
+    };
+    return { result, keep };
+  };
+  let fitCount = fit.kept.length;
+  let { result, keep } = buildCut(fitCount);
+  while (jsonBytes(result) > RESULT_BUDGET_BYTES && keep > 0) {
+    fitCount = keep - 1;
+    ({ result, keep } = buildCut(fitCount));
+  }
+  return result;
+}
+var RESULT_BUDGET_BYTES = 80000, TRUNCATION_RESERVE_BYTES = 1024, SCRAPE_CONTENT_BUDGET_BYTES = 70000, VALUE_PREVIEW_BYTES = 1000, DEFAULT_ALIGNMENT_IMPOSSIBLE_HINT = "Page offset too deep to resume inline at this limit; retry with a smaller limit or from an earlier page.";
+var init_budget = __esm(() => {
+  init_pagination();
+});
+
+// src/tools/docs.ts
+import { z as z5 } from "zod";
+function parseDocsIndex(text) {
+  const pages = [];
+  for (const line of text.split(`
+`)) {
+    const match = INDEX_LINE.exec(line.trim());
+    if (!match)
+      continue;
+    const [, title, url, description] = match;
+    const markdownUrl = docsPageMarkdownUrl(url);
+    if (!markdownUrl)
+      continue;
+    pages.push({
+      title,
+      url: markdownUrl.replace(/\.md$/, ""),
+      ...description && { description: description.trim() }
+    });
+  }
+  return pages;
+}
+function docsPageMarkdownUrl(page) {
+  let path = page.trim();
+  if (/^https?:\/\//i.test(path)) {
+    let url;
+    try {
+      url = new URL(path);
+    } catch {
+      return;
+    }
+    if (url.host !== DOCS_HOST)
+      return;
+    path = url.pathname;
+  }
+  path = `/${path.replace(/^\/+/, "").replace(/\.mdx?$/, "")}`;
+  if (path === "/" || !/^(\/[a-z0-9][a-z0-9._-]*)+$/i.test(path) || path.includes(".."))
+    return;
+  return `${DOCS_ORIGIN}${path}.md`;
+}
+async function fetchDocsText(url) {
+  const response = await fetch(url, { signal: AbortSignal.timeout(DOCS_FETCH_TIMEOUT_MS) });
+  return { status: response.status, ...response.ok && { text: await response.text() } };
+}
+function registerDocsTools(server, _ctx, helpers) {
+  const { withErrorHandling } = helpers;
+  server.registerTool("list_docs_pages", {
+    title: "List Kadoa Docs Pages",
+    description: "List every Kadoa documentation page with its title, URL, and one-line summary. Use this for questions " + "about how Kadoa works or where to find something in the dashboard (API keys, billing and invoices, " + "usage and slots, team settings, SSO, notifications, the SDK and API). Pick the relevant pages by meaning, " + "then read them with read_docs_page before answering.",
+    inputSchema: strictSchema({}),
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+  }, withErrorHandling("list_docs_pages", async () => {
+    const index = await fetchDocsText(`${DOCS_ORIGIN}/llms.txt`);
+    if (index.text === undefined) {
+      throw new Error(`The Kadoa docs index could not be loaded (HTTP ${index.status}).`);
+    }
+    const pages = parseDocsIndex(index.text);
+    return jsonResult({ pages, totalCount: pages.length });
+  }));
+  server.registerTool("read_docs_page", {
+    title: "Read Kadoa Docs Page",
+    description: "Read one Kadoa documentation page as markdown. Pass a page URL or path from list_docs_pages. " + "Cite the page URL when you answer from it.",
+    inputSchema: strictSchema({
+      page: z5.string().min(1).describe("Page URL or path from list_docs_pages, e.g. https://docs.kadoa.com/docs/api-keys.md or /docs/api-keys")
+    }),
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+  }, withErrorHandling("read_docs_page", async (args) => {
+    const url = docsPageMarkdownUrl(args.page);
+    if (!url) {
+      return jsonResult({
+        success: false,
+        message: `"${args.page}" is not a docs.kadoa.com page. Use a URL or path returned by list_docs_pages.`
+      });
+    }
+    const page = await fetchDocsText(url);
+    if (page.text === undefined) {
+      if (page.status === 404) {
+        return jsonResult({
+          success: false,
+          message: "That docs page does not exist. Find the right page with list_docs_pages."
+        });
+      }
+      throw new Error(`The Kadoa docs page could not be loaded (HTTP ${page.status}).`);
+    }
+    const content = truncateUtf8(page.text, SCRAPE_CONTENT_BUDGET_BYTES);
+    const truncated = content.length < page.text.length;
+    return jsonResult({
+      url: url.replace(/\.md$/, ""),
+      content,
+      ...truncated && { truncated: true, hint: "The page was cut to fit. The full page is at the URL above." }
+    });
+  }));
+}
+var DOCS_ORIGIN = "https://docs.kadoa.com", DOCS_HOST, DOCS_FETCH_TIMEOUT_MS = 1e4, INDEX_LINE;
+var init_docs = __esm(() => {
+  init_budget();
+  init_schemas();
+  DOCS_HOST = new URL(DOCS_ORIGIN).host;
+  INDEX_LINE = /^- \[(.+?)\]\((\S+?)\)(?::\s*(.*))?$/;
+});
+
 // src/notification-channels.ts
 import { createHash } from "node:crypto";
 function recipientKey(recipients) {
@@ -1494,14 +1715,14 @@ function redactChannelRefs(channels) {
 var init_notification_channels = () => {};
 
 // src/tools/notifications.ts
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 function registerNotificationChannelTools(server, ctx, helpers) {
   const { withErrorHandling } = helpers;
   server.registerTool("list_notification_channels", {
     title: "List Notification Channels",
     description: "List notification channels configured for a workflow or across the workspace. Channels are destinations (email, Slack, webhook, websocket) where notifications are sent.",
     inputSchema: strictSchema({
-      workflowId: z5.string().optional().describe("Filter channels linked to a specific workflow. Omit to list all workspace channels.")
+      workflowId: z6.string().optional().describe("Filter channels linked to a specific workflow. Omit to list all workspace channels.")
     }),
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("list_notification_channels", async (args) => {
@@ -1524,20 +1745,20 @@ function registerNotificationChannelTools(server, ctx, helpers) {
     title: "Create Notification Channel",
     description: "Create a notification channel (email, webhook, slack, or websocket). If a channel of the same type already delivers to that destination it is reused and returned with reused=true, rather than creating a duplicate. The channel can then be linked to notification settings for specific events. " + "For SLACK: use slackChannelId + slackChannelName for OAuth integration, or webhookUrl for legacy incoming webhooks. " + "For WEBHOOK: auth is optional and supports bearer, basic, or header authentication.",
     inputSchema: strictSchema({
-      channelType: z5.enum(["EMAIL", "WEBHOOK", "SLACK", "WEBSOCKET"]).describe("Type of notification channel"),
-      name: z5.string().optional().describe("Name for the channel (defaults to 'default')"),
-      config: z5.object({
-        recipients: z5.array(z5.string()).optional().describe("Email recipients (required for EMAIL channels)"),
-        webhookUrl: z5.string().optional().describe("Webhook/Slack endpoint URL (required for WEBHOOK, optional for SLACK)"),
-        httpMethod: z5.enum(["POST", "GET", "PUT", "PATCH"]).optional().describe("HTTP method for WEBHOOK channels (defaults to POST)"),
-        slackChannelId: z5.string().optional().describe("Slack channel ID from OAuth integration (for SLACK channels, e.g. C01ABCDEF)"),
-        slackChannelName: z5.string().optional().describe("Slack channel name (for SLACK channels, e.g. #alerts)"),
-        auth: z5.object({
-          type: z5.enum(["bearer", "basic", "header"]).describe("Authentication type"),
-          token: z5.string().optional().describe("Bearer token (for 'bearer' type)"),
-          username: z5.string().optional().describe("Username (for 'basic' type)"),
-          password: z5.string().optional().describe("Password (for 'basic' type)"),
-          headers: z5.object({}).passthrough().optional().describe("Custom headers as key-value pairs (for 'header' type)")
+      channelType: z6.enum(["EMAIL", "WEBHOOK", "SLACK", "WEBSOCKET"]).describe("Type of notification channel"),
+      name: z6.string().optional().describe("Name for the channel (defaults to 'default')"),
+      config: z6.object({
+        recipients: z6.array(z6.string()).optional().describe("Email recipients (required for EMAIL channels)"),
+        webhookUrl: z6.string().optional().describe("Webhook/Slack endpoint URL (required for WEBHOOK, optional for SLACK)"),
+        httpMethod: z6.enum(["POST", "GET", "PUT", "PATCH"]).optional().describe("HTTP method for WEBHOOK channels (defaults to POST)"),
+        slackChannelId: z6.string().optional().describe("Slack channel ID from OAuth integration (for SLACK channels, e.g. C01ABCDEF)"),
+        slackChannelName: z6.string().optional().describe("Slack channel name (for SLACK channels, e.g. #alerts)"),
+        auth: z6.object({
+          type: z6.enum(["bearer", "basic", "header"]).describe("Authentication type"),
+          token: z6.string().optional().describe("Bearer token (for 'bearer' type)"),
+          username: z6.string().optional().describe("Username (for 'basic' type)"),
+          password: z6.string().optional().describe("Password (for 'basic' type)"),
+          headers: z6.object({}).passthrough().optional().describe("Custom headers as key-value pairs (for 'header' type)")
         }).optional().describe("Authentication for WEBHOOK channels")
       }).optional().describe("Channel-specific configuration. " + "EMAIL: provide recipients. " + "WEBHOOK: provide webhookUrl, httpMethod, and optionally auth. " + "SLACK: provide slackChannelId + slackChannelName (OAuth) or webhookUrl (legacy). " + "WEBSOCKET: no config needed.")
     }),
@@ -1584,8 +1805,8 @@ function registerNotificationSettingsTools(server, ctx, helpers) {
     title: "Delete Notification Channel",
     description: "Delete a notification channel by ID. " + "Call first without confirmed=true to preview, then with confirmed=true after user agrees.",
     inputSchema: strictSchema({
-      channelId: z5.string().min(1).describe("The channel ID to delete"),
-      confirmed: z5.preprocess(coerceBoolean(), z5.boolean()).optional().describe("Set to true only after the user has explicitly confirmed deletion.")
+      channelId: z6.string().min(1).describe("The channel ID to delete"),
+      confirmed: z6.preprocess(coerceBoolean(), z6.boolean()).optional().describe("Set to true only after the user has explicitly confirmed deletion.")
     }),
     annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("delete_notification_channel", async (args) => {
@@ -1606,7 +1827,7 @@ function registerNotificationSettingsTools(server, ctx, helpers) {
     title: "List Notification Settings",
     description: "List notification settings (event-to-channel mappings) for a workflow or workspace. Shows which events trigger notifications and through which channels.",
     inputSchema: strictSchema({
-      workflowId: z5.string().optional().describe("Filter settings for a specific workflow. Omit to list workspace-level settings."),
+      workflowId: z6.string().optional().describe("Filter settings for a specific workflow. Omit to list workspace-level settings."),
       eventType: NotificationEventTypeSchema.optional().describe("Filter by event type")
     }),
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
@@ -1634,23 +1855,23 @@ function registerNotificationSettingsTools(server, ctx, helpers) {
     title: "Configure Notifications",
     description: "Set up notifications for a workflow or workspace. Creates channels and settings in one step. " + "Specify which events to listen for and which channels to deliver to (email, webhook, slack, websocket).",
     inputSchema: strictSchema({
-      workflowId: z5.string().optional().describe("Workflow ID to configure notifications for. Omit for workspace-level notifications."),
-      events: z5.preprocess(coerceList(), z5.array(z5.enum(["all", ...NOTIFICATION_EVENT_TYPES])).min(1)).describe('Event types to notify on. Pass ["all"] for every event type, or list specific event types.'),
-      channels: z5.object({
-        email: z5.object({
-          recipients: z5.array(z5.string().email()).optional().describe("Email addresses to notify. Omit to use the account default email.")
+      workflowId: z6.string().optional().describe("Workflow ID to configure notifications for. Omit for workspace-level notifications."),
+      events: z6.preprocess(coerceList(), z6.array(z6.enum(["all", ...NOTIFICATION_EVENT_TYPES])).min(1)).describe('Event types to notify on. Pass ["all"] for every event type, or list specific event types.'),
+      channels: z6.object({
+        email: z6.object({
+          recipients: z6.array(z6.string().email()).optional().describe("Email addresses to notify. Omit to use the account default email.")
         }).optional().describe("Send email notifications. Pass {} for default email or {recipients: [...]} for custom addresses."),
-        webhook: z5.object({
-          url: z5.string().url().describe("Webhook endpoint URL"),
-          httpMethod: z5.enum(["POST", "GET", "PUT", "PATCH"]).optional().describe("HTTP method (defaults to POST)"),
+        webhook: z6.object({
+          url: z6.string().url().describe("Webhook endpoint URL"),
+          httpMethod: z6.enum(["POST", "GET", "PUT", "PATCH"]).optional().describe("HTTP method (defaults to POST)"),
           auth: webhookAuthShape
         }).optional().describe("Send via HTTP webhook"),
-        slack: z5.object({
-          webhookUrl: z5.string().url().optional().describe("Slack incoming webhook URL (legacy)"),
-          slackChannelId: z5.string().optional().describe("Slack channel ID from OAuth integration (e.g. C01ABCDEF)"),
-          slackChannelName: z5.string().optional().describe("Slack channel name (e.g. #alerts)")
+        slack: z6.object({
+          webhookUrl: z6.string().url().optional().describe("Slack incoming webhook URL (legacy)"),
+          slackChannelId: z6.string().optional().describe("Slack channel ID from OAuth integration (e.g. C01ABCDEF)"),
+          slackChannelName: z6.string().optional().describe("Slack channel name (e.g. #alerts)")
         }).optional().describe("Send to Slack channel. Use slackChannelId/slackChannelName for OAuth integration, or webhookUrl for legacy incoming webhooks."),
-        websocket: z5.boolean().optional().describe("Enable WebSocket notifications")
+        websocket: z6.boolean().optional().describe("Enable WebSocket notifications")
       }).describe("At least one channel must be specified")
     }),
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
@@ -1712,8 +1933,8 @@ function registerNotificationSettingsTools(server, ctx, helpers) {
     title: "Delete Notification Setting",
     description: "Delete a notification setting by ID. This removes the event-to-channel mapping but does not delete the channels themselves. " + "Call first without confirmed=true to preview, then with confirmed=true after user agrees.",
     inputSchema: strictSchema({
-      settingId: z5.string().min(1).describe("The notification setting ID to delete (the id from list_notification_settings)"),
-      confirmed: z5.preprocess(coerceBoolean(), z5.boolean()).optional().describe("Set to true only after the user has explicitly confirmed deletion.")
+      settingId: z6.string().min(1).describe("The notification setting ID to delete (the id from list_notification_settings)"),
+      confirmed: z6.preprocess(coerceBoolean(), z6.boolean()).optional().describe("Set to true only after the user has explicitly confirmed deletion.")
     }),
     annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("delete_notification_setting", async (args) => {
@@ -1739,7 +1960,7 @@ var init_notifications = __esm(() => {
 
 // src/tools/observability.ts
 import { KadoaSdkException as KadoaSdkException2 } from "@kadoa/node-sdk";
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 function mapActivityEvent(event, includeDetails) {
   const details = event.details ?? {};
   const summary = details._changeSummary;
@@ -1812,10 +2033,10 @@ function registerObservabilityTools(server, ctx, helpers) {
     title: "Get Observability Metrics",
     description: "Workflow health for the active team over a window of days (default 30): overall uptime in percent, " + "successful and failed runs, mean time to recovery in minutes, records delivered, counts of healthy, " + "degraded, down, and idle workflows, the same numbers for the previous window, and an 'attention' list " + "of down and degraded workflows ranked worst first. This is the data behind the Observability page. " + "Use for 'how healthy are my workflows', 'what is my uptime', 'which workflows are down or failing', " + "'how fast do we recover', 'how did this month compare to last'. " + "Do NOT use it to explain why one workflow failed: call list_workflow_runs (errors per run) or " + "get_workflow for that. For what needs the user's action right now use list_workflows with " + "statusFilters group:attention. " + "Health comes from each workflow's last run in the window: healthy means the last run finished, down " + "means the last run failed, idle means no finished or failed run. uptimePercentage is null when no runs " + "happened. mttrMinutes is null when nothing failed and then recovered. openSupportRequests is a count " + "only. " + "Output is bounded: pass includeWorkflows for every workflow ranked by severity (up to limit, default " + "25, max 200) and includeDailySeries for the team-level daily uptime series; per-workflow daily series " + "are never returned. Quote workflows by name; ids are stripped from customer-facing text. Large teams " + "can take up to 90 seconds; prefer 30 or 90 days over 365.",
     inputSchema: strictSchema({
-      days: z6.preprocess(coerceNumber(), z6.number().int().min(1).max(365)).optional().describe("Window length in days, 1 to 365 (default 30). The dashboard offers 30, 90, and 365."),
-      includeWorkflows: z6.preprocess(coerceBoolean(), z6.boolean()).optional().describe("Also return every workflow ranked by severity, not only the down and degraded ones (default false)."),
-      includeDailySeries: z6.preprocess(coerceBoolean(), z6.boolean()).optional().describe("Also return the team-level daily series of successful runs, failed runs, and uptime (default false)."),
-      limit: z6.preprocess(coerceNumber(), z6.number().int().min(1).max(OBSERVABILITY_MAX_LIMIT)).optional().describe("Maximum workflows in the attention list and in workflows (default 25, max 200).")
+      days: z7.preprocess(coerceNumber(), z7.number().int().min(1).max(365)).optional().describe("Window length in days, 1 to 365 (default 30). The dashboard offers 30, 90, and 365."),
+      includeWorkflows: z7.preprocess(coerceBoolean(), z7.boolean()).optional().describe("Also return every workflow ranked by severity, not only the down and degraded ones (default false)."),
+      includeDailySeries: z7.preprocess(coerceBoolean(), z7.boolean()).optional().describe("Also return the team-level daily series of successful runs, failed runs, and uptime (default false)."),
+      limit: z7.preprocess(coerceNumber(), z7.number().int().min(1).max(OBSERVABILITY_MAX_LIMIT)).optional().describe("Maximum workflows in the attention list and in workflows (default 25, max 200).")
     }),
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("get_observability", async (args) => {
@@ -1873,15 +2094,15 @@ function registerObservabilityTools(server, ctx, helpers) {
     inputSchema: strictSchema({
       limit: limitInput({ noun: "Events", defaultLimit: ACTIVITY_DEFAULT_LIMIT, max: ACTIVITY_MAX_LIMIT }),
       offset: offsetInput("offset", "events"),
-      workflowId: z6.string().optional().describe("Only events about this workflow (runs, config changes, data changes, notifications)"),
-      userId: z6.string().optional().describe("Only events by this user id. Resolve an email to an id from a previous list_activity result."),
-      startDate: z6.string().optional().describe("ISO 8601 lower bound. Ignored when relativeTime is set."),
-      endDate: z6.string().optional().describe("ISO 8601 upper bound. Ignored when relativeTime is set."),
-      relativeTime: z6.string().regex(/^\d+(m|h|d|w)$/i, "Use <number><unit> with unit m, h, d or w, e.g. 6h or 2w").optional().describe("Window counted back from now, e.g. 30m, 6h, 1d, 2w. Preferred for 'last week' style questions."),
-      eventTypes: z6.preprocess(coerceList({ upperCase: true }), z6.array(z6.enum(ACTIVITY_EVENT_TYPES))).optional().describe("Actions to keep. Workflow run outcomes (FINISHED, FAILED, ...) count as actions."),
-      interfaces: z6.preprocess(coerceList({ upperCase: true }), z6.array(z6.enum(ACTIVITY_INTERFACES))).optional().describe("Interfaces the action came from"),
-      resourceTypes: z6.preprocess(coerceList({ upperCase: true }), z6.array(z6.enum(ACTIVITY_RESOURCE_TYPES))).optional().describe("Resource types to keep"),
-      includeDetails: z6.preprocess(coerceBoolean(), z6.boolean()).optional().describe("Include sanitized previousValue/newValue snapshots per event (default false; large)")
+      workflowId: z7.string().optional().describe("Only events about this workflow (runs, config changes, data changes, notifications)"),
+      userId: z7.string().optional().describe("Only events by this user id. Resolve an email to an id from a previous list_activity result."),
+      startDate: z7.string().optional().describe("ISO 8601 lower bound. Ignored when relativeTime is set."),
+      endDate: z7.string().optional().describe("ISO 8601 upper bound. Ignored when relativeTime is set."),
+      relativeTime: z7.string().regex(/^\d+(m|h|d|w)$/i, "Use <number><unit> with unit m, h, d or w, e.g. 6h or 2w").optional().describe("Window counted back from now, e.g. 30m, 6h, 1d, 2w. Preferred for 'last week' style questions."),
+      eventTypes: z7.preprocess(coerceList({ upperCase: true }), z7.array(z7.enum(ACTIVITY_EVENT_TYPES))).optional().describe("Actions to keep. Workflow run outcomes (FINISHED, FAILED, ...) count as actions."),
+      interfaces: z7.preprocess(coerceList({ upperCase: true }), z7.array(z7.enum(ACTIVITY_INTERFACES))).optional().describe("Interfaces the action came from"),
+      resourceTypes: z7.preprocess(coerceList({ upperCase: true }), z7.array(z7.enum(ACTIVITY_RESOURCE_TYPES))).optional().describe("Resource types to keep"),
+      includeDetails: z7.preprocess(coerceBoolean(), z7.boolean()).optional().describe("Include sanitized previousValue/newValue snapshots per event (default false; large)")
     }),
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("list_activity", async (args) => {
@@ -1959,125 +2180,8 @@ var init_observability = __esm(() => {
   HEALTH_SEVERITY = { down: 0, degraded: 1, idle: 2, healthy: 3 };
 });
 
-// src/tools/shared/budget.ts
-function jsonBytes(value) {
-  const text = JSON.stringify(value);
-  return text === undefined ? 0 : Buffer.byteLength(text, "utf8");
-}
-function truncateUtf8(text, maxBytes) {
-  if (Buffer.byteLength(text, "utf8") <= maxBytes)
-    return text;
-  const { read } = new TextEncoder().encodeInto(text, new Uint8Array(Math.max(0, maxBytes)));
-  return text.slice(0, read);
-}
-function previewValue(value, maxBytes = VALUE_PREVIEW_BYTES) {
-  if (value === undefined || value === null)
-    return null;
-  const bytes = Buffer.byteLength(JSON.stringify(value), "utf8");
-  if (bytes <= maxBytes)
-    return value;
-  if (typeof value === "string")
-    return `${truncateUtf8(value, maxBytes)}… [cut, ${bytes} bytes]`;
-  if (Array.isArray(value))
-    return `[array of ${value.length} items, ${bytes} bytes]`;
-  return `[${typeof value}, ${bytes} bytes]`;
-}
-function fitItems(options) {
-  const budget = options.budgetBytes ?? RESULT_BUDGET_BYTES;
-  const all = [...options.items];
-  if (jsonBytes(options.build(all)) <= budget)
-    return { kept: all, omitted: 0, truncated: false };
-  const limit = budget - TRUNCATION_RESERVE_BYTES - (options.reserveBytes ?? 0);
-  let lo = 0;
-  let hi = all.length - 1;
-  while (lo < hi) {
-    const mid = Math.ceil((lo + hi) / 2);
-    if (jsonBytes(options.build(all.slice(0, mid))) <= limit)
-      lo = mid;
-    else
-      hi = mid - 1;
-  }
-  return { kept: all.slice(0, lo), omitted: all.length - lo, truncated: true };
-}
-function truncationNotice(options) {
-  const budgetBytes = options.budgetBytes ?? RESULT_BUDGET_BYTES;
-  const total = options.kept + options.omitted;
-  return {
-    truncated: true,
-    truncation: { kept: options.kept, omitted: options.omitted, budgetBytes },
-    hint: `Result cut to ${options.kept} of ${total} ${options.noun} to stay under ${Math.round(budgetBytes / 1000)} KB. ${options.hint}`
-  };
-}
-function highlyDivisibleFloor(n) {
-  if (n <= 0)
-    return 0;
-  if (n >= 10)
-    return Math.floor(n / 10) * 10;
-  let p = 1;
-  while (p * 2 <= n)
-    p *= 2;
-  return p;
-}
-function alignedKeep(offset, fit) {
-  if (offset === 0)
-    return highlyDivisibleFloor(fit);
-  for (let keep = fit;keep >= 1; keep--) {
-    if (offset % keep === 0 && offset / keep + 2 <= MAX_PAGE)
-      return keep;
-  }
-  return 0;
-}
-function resumeNumberedPage(meta, options) {
-  const { next: _replaced, totalPages: _droppedTotalPages, ...rest } = meta;
-  if (options.kept === 0)
-    return { ...rest, hasMore: false };
-  const offset = (options.page - 1) * options.limit;
-  return {
-    ...rest,
-    hasMore: true,
-    next: nextArgs(options.args, { page: offset / options.kept + 2, limit: options.kept })
-  };
-}
-function budgetNumberedPage(options) {
-  const offset = (options.page - 1) * options.limit;
-  const fit = fitItems({
-    items: options.items,
-    build: (kept) => options.build(kept, options.pagination),
-    reserveBytes: jsonBytes({ pagination: { next: options.args } })
-  });
-  if (!fit.truncated)
-    return options.build([...options.items], options.pagination);
-  const buildCut = (fitCount) => {
-    const keep = alignedKeep(offset, fitCount);
-    const alignmentImpossible = keep === 0 && fitCount > 0;
-    const pagination = resumeNumberedPage(options.pagination, {
-      args: options.args,
-      page: options.page,
-      limit: options.limit,
-      kept: keep
-    });
-    const hint = keep > 0 ? options.resumeHint : alignmentImpossible ? options.alignmentImpossibleHint ?? DEFAULT_ALIGNMENT_IMPOSSIBLE_HINT : options.emptyHint;
-    const result = {
-      ...options.build(options.items.slice(0, keep), pagination),
-      ...truncationNotice({ kept: keep, omitted: options.items.length - keep, noun: options.noun, hint })
-    };
-    return { result, keep };
-  };
-  let fitCount = fit.kept.length;
-  let { result, keep } = buildCut(fitCount);
-  while (jsonBytes(result) > RESULT_BUDGET_BYTES && keep > 0) {
-    fitCount = keep - 1;
-    ({ result, keep } = buildCut(fitCount));
-  }
-  return result;
-}
-var RESULT_BUDGET_BYTES = 80000, TRUNCATION_RESERVE_BYTES = 1024, SCRAPE_CONTENT_BUDGET_BYTES = 70000, VALUE_PREVIEW_BYTES = 1000, DEFAULT_ALIGNMENT_IMPOSSIBLE_HINT = "Page offset too deep to resume inline at this limit; retry with a smaller limit or from an earlier page.";
-var init_budget = __esm(() => {
-  init_pagination();
-});
-
 // src/tools/scrape.ts
-import { z as z7 } from "zod";
+import { z as z8 } from "zod";
 function scrapeResult(response, format) {
   const { content, ...metadata } = response;
   if (typeof content !== "string" || content.length === 0)
@@ -2112,11 +2216,11 @@ function registerScrapeTools(server, ctx, helpers, defaultProductType) {
     title: "Scrape URL",
     description: "Immediately fetch one URL as LLM-friendly markdown or raw HTML without creating a workflow. " + "Markdown is the default. Routing is fully automatic: it starts cheap and escalates through stealth tiers on its own when a site blocks bots, and remembers the working method per host. " + (defaultProductType === "realtime" ? "Use create_realtime_monitor for monitoring, and create_workflow for one-time or scheduled structured extraction or navigation-heavy jobs. " : "Use create_workflow instead for structured extraction, recurring runs, monitoring, or navigation-heavy jobs. ") + "The result is a JSON metadata block followed by the page text as its own block, capped at 70 KB.",
     inputSchema: strictSchema({
-      url: z7.url().refine((value) => {
+      url: z8.url().refine((value) => {
         const protocol = new URL(value).protocol;
         return protocol === "http:" || protocol === "https:";
       }, "URL must use HTTP or HTTPS").describe("HTTP or HTTPS URL to fetch"),
-      format: z7.enum(["html", "markdown"]).optional().describe("Output format. Defaults to markdown for compact LLM consumption; use html for raw source.")
+      format: z8.enum(["html", "markdown"]).optional().describe("Output format. Defaults to markdown for compact LLM consumption; use html for raw source.")
     }),
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
   }, withErrorHandling("scrape", async (args) => {
@@ -2282,7 +2386,7 @@ var init_errors = () => {};
 
 // src/tools/support.ts
 import { KadoaHttpException as KadoaHttpException2 } from "@kadoa/node-sdk";
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 function supportTicketSkipMessage(reason) {
   return (reason && SUPPORT_TICKET_SKIP_MESSAGES[reason]) ?? "No support ticket was filed because this workflow isn't eligible for a support ticket right now.";
 }
@@ -2306,11 +2410,11 @@ function registerSupportTools(server, ctx, helpers) {
     title: "Create Support Ticket",
     description: "File a support ticket for one workflow so the Kadoa team investigates it. " + "Only file after the user has agreed. If the workflow already has an open ticket, that ticket is " + "returned instead of a duplicate. Filing never pauses the workflow.",
     inputSchema: strictSchema({
-      workflowId: z8.string().min(1).describe("The workflow the problem is about"),
-      title: z8.string().describe("One-line summary of the problem"),
-      description: z8.string().describe("What is wrong, what was observed, and what was already tried"),
-      category: z8.enum(["bug", "feature", "workflow_issue", "template_issue", "integration", "billing", "data_diff"]).optional().describe("Support category; defaults to a workflow issue"),
-      jobId: z8.string().optional().describe("The failing run's id (from list_workflow_runs). Required when filing from the Kadoa Assistant.")
+      workflowId: z9.string().min(1).describe("The workflow the problem is about"),
+      title: z9.string().describe("One-line summary of the problem"),
+      description: z9.string().describe("What is wrong, what was observed, and what was already tried"),
+      category: z9.enum(["bug", "feature", "workflow_issue", "template_issue", "integration", "billing", "data_diff"]).optional().describe("Support category; defaults to a workflow issue"),
+      jobId: z9.string().optional().describe("The failing run's id (from list_workflow_runs). Required when filing from the Kadoa Assistant.")
     }),
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
   }, withErrorHandling("create_support_ticket", async (args) => {
@@ -2374,7 +2478,7 @@ var init_support = __esm(() => {
 });
 
 // src/tools/team.ts
-import { z as z9 } from "zod";
+import { z as z10 } from "zod";
 function registerWhoamiTool(server, ctx, helpers) {
   const { withErrorHandling } = helpers;
   server.registerTool("whoami", {
@@ -2444,7 +2548,7 @@ function registerTeamTools(server, ctx, helpers) {
     title: "Switch Team",
     description: "Switch the active team by name or ID. After switching, all subsequent API calls will use the new team context.",
     inputSchema: strictSchema({
-      teamIdentifier: z9.string().min(1).describe("Team name or team ID to switch to")
+      teamIdentifier: z10.string().min(1).describe("Team name or team ID to switch to")
     }),
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("team_switch", async () => errorResult("team_switch is not available for this credential. Reconnect and choose the team at sign-in.")));
@@ -2455,7 +2559,7 @@ var init_team = __esm(() => {
 });
 
 // src/tools/templates.ts
-import { z as z10 } from "zod";
+import { z as z11 } from "zod";
 function normalizeTemplateSchemaField(val) {
   if (val === null || typeof val !== "object" || Array.isArray(val))
     return val;
@@ -2477,7 +2581,7 @@ function registerTemplateTools(server, ctx, helpers) {
   const { withErrorHandling } = helpers;
   server.registerTool("list_templates", {
     title: "List Templates",
-    description: "List all templates in the current team. Templates define reusable configurations (prompt, schema, validation rules, notifications, and frequency). Use this to find a matching template before creating a workflow. To instantiate a template, call create_workflow with its templateId, source URLs, optional templateVersion, and optional prompt containing only workflow-specific additional instructions - never copy the template prompt, entity, or schema into the call.",
+    description: "List all templates in the current team. Templates define reusable configurations (prompt, schema, validation rules, notifications, and frequency). Use this to find a matching template before creating a workflow. To instantiate a template, call create_workflow for one-time or scheduled extraction, or create_realtime_monitor for realtime monitoring, with its templateId, source URLs, optional templateVersion, and optional prompt containing only workflow-specific additional instructions - never copy the template prompt, entity, or schema into the call.",
     inputSchema: strictSchema({}),
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("list_templates", async () => {
@@ -2486,29 +2590,29 @@ function registerTemplateTools(server, ctx, helpers) {
       templates: templates.map(withTemplateDashboardUrl),
       count: templates.length,
       pagination: completeList(templates.length),
-      instructions: "To instantiate a listed template, call create_workflow with the matching templateId, source URLs, optional templateVersion, and optional prompt containing only workflow-specific additional instructions. Do not copy the template prompt, entity, or schema into the call."
+      instructions: "To instantiate a listed template, call create_workflow for one-time or scheduled extraction, or create_realtime_monitor for realtime monitoring, with the matching templateId, source URLs, optional templateVersion, and optional prompt containing only workflow-specific additional instructions. Do not copy the template prompt, entity, or schema into the call."
     });
   }));
   server.registerTool("get_template", {
     title: "Get Template",
-    description: "Get a template by ID, including all published versions and their schemas. After inspecting it, instantiate the template with create_workflow using templateId, source URLs, optional templateVersion, and optional prompt containing only workflow-specific additional instructions. Never copy the returned prompt, entity, or schema into the call - those shared values are inherited when templateId is passed.",
+    description: "Get a template by ID, including all published versions and their schemas. After inspecting it, instantiate the template with create_workflow for one-time or scheduled extraction, or create_realtime_monitor for realtime monitoring, using templateId, source URLs, optional templateVersion, and optional prompt containing only workflow-specific additional instructions. Never copy the returned prompt, entity, or schema into the call - those shared values are inherited when templateId is passed.",
     inputSchema: strictSchema({
-      templateId: z10.string().min(1).describe("The template ID")
+      templateId: z11.string().min(1).describe("The template ID")
     }),
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("get_template", async (args) => {
     const template = await ctx.client.template.get(args.templateId);
     return jsonResult({
       template: withTemplateDashboardUrl(template),
-      instructions: `To instantiate this template, call create_workflow with templateId "${args.templateId}", source URLs, optional templateVersion, and optional prompt containing only workflow-specific additional instructions. Do not copy this template's prompt, entity, or schema into the call.`
+      instructions: `To instantiate this template, call create_workflow for one-time or scheduled extraction, or create_realtime_monitor for realtime monitoring, with templateId "${args.templateId}", source URLs, optional templateVersion, and optional prompt containing only workflow-specific additional instructions. Do not copy this template's prompt, entity, or schema into the call.`
     });
   }));
   server.registerTool("create_template", {
     title: "Create Template",
     description: "Create a new template. After creation, use create_template_version to publish a version with prompt, schema, and notifications.",
     inputSchema: strictSchema({
-      name: z10.string().describe("Template name (1-255 chars)"),
-      description: z10.string().optional().describe("Template description (max 2000 chars)")
+      name: z11.string().describe("Template name (1-255 chars)"),
+      description: z11.string().optional().describe("Template description (max 2000 chars)")
     }),
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
   }, withErrorHandling("create_template", async (args) => {
@@ -2528,9 +2632,9 @@ function registerTemplateTools(server, ctx, helpers) {
 
 ` + "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: z10.string().min(1).describe("The template ID to update"),
-      name: z10.preprocess(coerceNull(), z10.string().optional()).optional().describe("New template name"),
-      description: z10.preprocess(coerceNull(), z10.string().optional()).optional().describe("New template description")
+      templateId: z11.string().min(1).describe("The template ID to update"),
+      name: z11.preprocess(coerceNull(), z11.string().optional()).optional().describe("New template name"),
+      description: z11.preprocess(coerceNull(), z11.string().optional()).optional().describe("New template description")
     }),
     annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("update_template", async (args) => {
@@ -2546,8 +2650,8 @@ function registerTemplateTools(server, ctx, helpers) {
     title: "Delete Template",
     description: "Delete (archive) a template. " + "You MUST first call this tool without confirmed=true to preview what will be deleted, " + "then show the user the template name and ask for confirmation, " + "then call again with confirmed=true only after the user explicitly agrees.",
     inputSchema: strictSchema({
-      templateId: z10.string().min(1).describe("The template ID to delete"),
-      confirmed: z10.preprocess(coerceBoolean(), z10.boolean()).optional().describe("Set to true only after the user has explicitly confirmed deletion. Omit or set to false for the initial preview call.")
+      templateId: z11.string().min(1).describe("The template ID to delete"),
+      confirmed: z11.preprocess(coerceBoolean(), z11.boolean()).optional().describe("Set to true only after the user has explicitly confirmed deletion. Omit or set to false for the initial preview call.")
     }),
     annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("delete_template", async (args) => {
@@ -2571,15 +2675,15 @@ function registerTemplateTools(server, ctx, helpers) {
     });
   }));
   const TemplateSchemaFieldShape = {
-    name: z10.string().describe("Field name"),
-    description: z10.string().optional().describe("Field description"),
-    fieldType: z10.enum(["SCHEMA", "CLASSIFICATION"]).optional().describe("Field role: SCHEMA (default) for extracted data, CLASSIFICATION for a field with predefined categories"),
-    example: z10.string().optional().describe("Example value"),
+    name: z11.string().describe("Field name"),
+    description: z11.string().optional().describe("Field description"),
+    fieldType: z11.enum(["SCHEMA", "CLASSIFICATION"]).optional().describe("Field role: SCHEMA (default) for extracted data, CLASSIFICATION for a field with predefined categories"),
+    example: z11.string().optional().describe("Example value"),
     dataType: SchemaFieldDataTypeSchema.optional().describe("Data type for SCHEMA fields"),
-    isKey: z10.preprocess(coerceBoolean(), z10.boolean()).optional().describe("Whether the field is a key field"),
-    categories: z10.preprocess(coerceArray(), z10.array(z10.object({
-      title: z10.string().describe("Short title/label of the category"),
-      definition: z10.string().describe("Full definition/description of the category")
+    isKey: z11.preprocess(coerceBoolean(), z11.boolean()).optional().describe("Whether the field is a key field"),
+    categories: z11.preprocess(coerceArray(), z11.array(z11.object({
+      title: z11.string().describe("Short title/label of the category"),
+      definition: z11.string().describe("Full definition/description of the category")
     }))).optional().describe("Predefined categories for a CLASSIFICATION field ({title, definition}[]). Required for fieldType=CLASSIFICATION; omitted otherwise.")
   };
   async function latestTemplateVersionRules(templateId) {
@@ -2604,25 +2708,25 @@ function registerTemplateTools(server, ctx, helpers) {
 
 ` + "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: z10.string().min(1).describe("The template ID to publish a version for"),
-      prompt: z10.string().optional().describe("User prompt to copy into workflow config"),
-      schemaId: z10.string().optional().describe("Existing schema ID to reference (mutually exclusive with schemaFields)"),
-      schemaFields: z10.preprocess(coerceArray(), z10.array(z10.preprocess(normalizeTemplateSchemaField, z10.object(TemplateSchemaFieldShape).strict()))).optional().describe("Inline schema fields to create a new schema (mutually exclusive with schemaId)"),
-      schemaEntity: z10.string().optional().describe("Entity name for the inline schema"),
-      schemaValidationRules: z10.preprocess((val) => stripSchemaValidationAttribution(coerceJson()(val)), SchemaValidationRulesSchema).optional().describe("Per-field schema validation rules keyed by field name. Each value is an object with a required `kind` and optional rules for that kind; unknown keys are rejected. " + "Every kind accepts presence and uniqueness, each { target: integer 0-100 in steps of 20 } (expected percentage of rows with a value / a unique value). " + "STRING: minLength, maxLength, minHtmlElements, maxHtmlElements, each { value: integer >= 0 }; format, one of " + '{ kind: "FORMAT", source: { kind: "PRESET", preset: url | email | phone | date | datetime | time | uuid | slug } or { kind: "CUSTOM", pattern: regex string } }, ' + '{ kind: "FREE_TEXT", charset: { kind: "PRESET", preset: natural_language | alphanumeric | alpha } }, or ' + '{ kind: "LIST", source: { kind: "PRESET", preset: language2 | country2 | country3 | currency3 | month3 | usState2 } or { kind: "CUSTOM", values: [non-empty strings] } }. ' + "NUMBER: minimum and maximum, each { value: number }; maxDecimalPlaces { value: integer 0-16 }. " + "OTHER: only presence and uniqueness. " + "OBJECT: properties (required), a map of nested field name to rule. " + "ARRAY: minItems, maxItems, each { value: integer >= 0 }; items, the rule for each element. " + 'Examples: { "price": { "kind": "NUMBER", "minimum": { "value": 0 } } }; { "email": { "kind": "STRING", "format": { "kind": "FORMAT", "source": { "kind": "PRESET", "preset": "email" } } } }. ' + "Edit attribution is stamped server-side, so send only rule values. Not inherited from prior versions - omitting this on a new version drops any rules the previous version had."),
-      notifications: z10.preprocess(coerceArray(), z10.array(z10.object({
-        eventType: z10.string().describe("Notification event type"),
-        eventConfiguration: z10.preprocess(coerceJson(), z10.record(z10.string(), z10.unknown())).optional(),
-        enabled: z10.preprocess(coerceBoolean(), z10.boolean()).optional(),
-        channelIds: z10.preprocess(coerceArray(), z10.array(z10.string().min(1))).optional(),
-        channels: z10.preprocess(coerceArray(), z10.array(z10.object({ channelId: z10.string() }))).optional()
+      templateId: z11.string().min(1).describe("The template ID to publish a version for"),
+      prompt: z11.string().optional().describe("User prompt to copy into workflow config"),
+      schemaId: z11.string().optional().describe("Existing schema ID to reference (mutually exclusive with schemaFields)"),
+      schemaFields: z11.preprocess(coerceArray(), z11.array(z11.preprocess(normalizeTemplateSchemaField, z11.object(TemplateSchemaFieldShape).strict()))).optional().describe("Inline schema fields to create a new schema (mutually exclusive with schemaId)"),
+      schemaEntity: z11.string().optional().describe("Entity name for the inline schema"),
+      schemaValidationRules: z11.preprocess((val) => stripSchemaValidationAttribution(coerceJson()(val)), SchemaValidationRulesSchema).optional().describe("Per-field schema validation rules keyed by field name. Each value is an object with a required `kind` and optional rules for that kind; unknown keys are rejected. " + "Every kind accepts presence and uniqueness, each { target: integer 0-100 in steps of 20 } (expected percentage of rows with a value / a unique value). " + "STRING: minLength, maxLength, minHtmlElements, maxHtmlElements, each { value: integer >= 0 }; format, one of " + '{ kind: "FORMAT", source: { kind: "PRESET", preset: url | email | phone | date | datetime | time | uuid | slug } or { kind: "CUSTOM", pattern: regex string } }, ' + '{ kind: "FREE_TEXT", charset: { kind: "PRESET", preset: natural_language | alphanumeric | alpha } }, or ' + '{ kind: "LIST", source: { kind: "PRESET", preset: language2 | country2 | country3 | currency3 | month3 | usState2 } or { kind: "CUSTOM", values: [non-empty strings] } }. ' + "NUMBER: minimum and maximum, each { value: number }; maxDecimalPlaces { value: integer 0-16 }. " + "OTHER: only presence and uniqueness. " + "OBJECT: properties (required), a map of nested field name to rule. " + "ARRAY: minItems, maxItems, each { value: integer >= 0 }; items, the rule for each element. " + 'Examples: { "price": { "kind": "NUMBER", "minimum": { "value": 0 } } }; { "email": { "kind": "STRING", "format": { "kind": "FORMAT", "source": { "kind": "PRESET", "preset": "email" } } } }. ' + "Edit attribution is stamped server-side, so send only rule values. Not inherited from prior versions - omitting this on a new version drops any rules the previous version had."),
+      notifications: z11.preprocess(coerceArray(), z11.array(z11.object({
+        eventType: z11.string().describe("Notification event type"),
+        eventConfiguration: z11.preprocess(coerceJson(), z11.record(z11.string(), z11.unknown())).optional(),
+        enabled: z11.preprocess(coerceBoolean(), z11.boolean()).optional(),
+        channelIds: z11.preprocess(coerceArray(), z11.array(z11.string().min(1))).optional(),
+        channels: z11.preprocess(coerceArray(), z11.array(z11.object({ channelId: z11.string() }))).optional()
       }))).optional().describe("Notification configuration for this version"),
-      frequency: z10.preprocess(coerceJson(), z10.object({
-        interval: z10.enum([...UpdateIntervalSchema.options, "REAL_TIME"]).optional().describe("Scheduling interval the template controls for linked workflows. Use CUSTOM with 'schedules' for cron."),
-        schedules: z10.preprocess(coerceArray(), z10.array(z10.object({
-          type: z10.enum(["repeat", "cron"]).describe("'repeat' (interval token) or 'cron' (cron expressions)"),
-          interval: z10.string().optional().describe("Repeat token (e.g. '1h', '1d') when type='repeat'"),
-          expressions: z10.preprocess(coerceArray(true), z10.array(z10.string())).optional().describe("Cron expressions when type='cron' (e.g. '0 8 * * 2')")
+      frequency: z11.preprocess(coerceJson(), z11.object({
+        interval: z11.enum([...UpdateIntervalSchema.options, "REAL_TIME"]).optional().describe("Scheduling interval the template controls for linked workflows. Use CUSTOM with 'schedules' for cron."),
+        schedules: z11.preprocess(coerceArray(), z11.array(z11.object({
+          type: z11.enum(["repeat", "cron"]).describe("'repeat' (interval token) or 'cron' (cron expressions)"),
+          interval: z11.string().optional().describe("Repeat token (e.g. '1h', '1d') when type='repeat'"),
+          expressions: z11.preprocess(coerceArray(true), z11.array(z11.string())).optional().describe("Cron expressions when type='cron' (e.g. '0 8 * * 2')")
         }))).optional().describe("Schedule specs. Required when interval='CUSTOM'.")
       })).optional().describe("Template-controlled scheduling for linked workflows ({interval, schedules}). Linked workflows inherit and cannot override this when set.")
     }),
@@ -2652,11 +2756,11 @@ function registerTemplateTools(server, ctx, helpers) {
     title: "Save Workflow as Template",
     description: "Create a template from an existing workflow's configuration (prompt, schema, notifications). " + "Provide 'name' to create a new template, or 'templateId' to add a new version to an existing template. " + "Use 'includeParts' to save only specific parts of the configuration.",
     inputSchema: strictSchema({
-      workflowId: z10.string().min(1).describe("Source workflow ID to extract config from"),
-      name: z10.string().optional().describe("Name for the new template (required if templateId is not set)"),
-      description: z10.string().optional().describe("Description for the new template"),
-      templateId: z10.string().optional().describe("Existing template ID to add a new version to (mutually exclusive with name)"),
-      includeParts: z10.preprocess(coerceArray(), z10.array(z10.enum(["prompt", "schema", "schemaValidationRules", "notifications", "frequency"])).optional()).describe("Which parts of the workflow config to include: prompt, schema, schemaValidationRules, notifications, frequency. Omit to include all. At least 1 required if provided.")
+      workflowId: z11.string().min(1).describe("Source workflow ID to extract config from"),
+      name: z11.string().optional().describe("Name for the new template (required if templateId is not set)"),
+      description: z11.string().optional().describe("Description for the new template"),
+      templateId: z11.string().optional().describe("Existing template ID to add a new version to (mutually exclusive with name)"),
+      includeParts: z11.preprocess(coerceArray(), z11.array(z11.enum(["prompt", "schema", "schemaValidationRules", "notifications", "frequency"])).optional()).describe("Which parts of the workflow config to include: prompt, schema, schemaValidationRules, notifications, frequency. Omit to include all. At least 1 required if provided.")
     }),
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
   }, withErrorHandling("save_workflow_as_template", async (args) => {
@@ -2677,7 +2781,7 @@ function registerTemplateTools(server, ctx, helpers) {
     title: "List Template Schemas",
     description: "List schemas associated with a template.",
     inputSchema: strictSchema({
-      templateId: z10.string().min(1).describe("The template ID")
+      templateId: z11.string().min(1).describe("The template ID")
     }),
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("list_template_schemas", async (args) => {
@@ -2688,9 +2792,9 @@ function registerTemplateTools(server, ctx, helpers) {
     title: "Link Template to Workflows",
     description: "Link one or more EXISTING workflows to a template in a single call. " + "This is the bulk equivalent of creating a workflow with `templateId`: linked workflows adopt the template's configuration (prompt, schema, notifications) and stay in sync with it. " + "The template ENFORCES its schema on linked workflows - their extracted output conforms to the template's declared field names, so this is the way to make many workflows produce a consistent, canonical schema. " + "Use `list_templates`/`get_template` to find the template, and `list_workflows` to find the workflow IDs. " + "Set `force: true` to relink workflows already linked to a different template.",
     inputSchema: strictSchema({
-      templateId: z10.string().min(1).describe("The template ID to link workflows to"),
-      workflowIds: z10.preprocess(coerceArray(true), z10.array(z10.string().min(1)).min(1)).describe("Workflow IDs to link to the template (array of strings). Also accepts a single ID string."),
-      force: z10.preprocess(coerceBoolean(), z10.boolean()).optional().describe("If true, relink workflows that are already linked to another template. Defaults to false.")
+      templateId: z11.string().min(1).describe("The template ID to link workflows to"),
+      workflowIds: z11.preprocess(coerceArray(true), z11.array(z11.string().min(1)).min(1)).describe("Workflow IDs to link to the template (array of strings). Also accepts a single ID string."),
+      force: z11.preprocess(coerceBoolean(), z11.boolean()).optional().describe("If true, relink workflows that are already linked to another template. Defaults to false.")
     }),
     annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("link_template_to_workflows", async (args) => {
@@ -2717,9 +2821,9 @@ function registerTemplateTools(server, ctx, helpers) {
     title: "Apply Template Version",
     description: "Push a template version onto its linked workflows. Updates the given workflows to the template's `targetVersion`, applying the template-controlled parts (prompt, schema, validation rules, notifications, frequency). " + "Use this after publishing a new template version to bring linked workflows up to date (see list_template_workflows for which workflows are outdated). " + "Returns how many workflows were updated and which parts the template controls.",
     inputSchema: strictSchema({
-      templateId: z10.string().min(1).describe("The template ID whose version to apply"),
-      targetVersion: z10.preprocess(coerceNumber(), z10.number()).describe("The template version number to apply to the workflows"),
-      workflowIds: z10.preprocess(coerceArray(true), z10.array(z10.string().min(1)).min(1)).describe("Workflow IDs to update to the target version (array of strings). Also accepts a single ID string.")
+      templateId: z11.string().min(1).describe("The template ID whose version to apply"),
+      targetVersion: z11.preprocess(coerceNumber(), z11.number()).describe("The template version number to apply to the workflows"),
+      workflowIds: z11.preprocess(coerceArray(true), z11.array(z11.string().min(1)).min(1)).describe("Workflow IDs to update to the target version (array of strings). Also accepts a single ID string.")
     }),
     annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("apply_template_version", async (args) => {
@@ -2739,7 +2843,7 @@ function registerTemplateTools(server, ctx, helpers) {
     title: "List Template Workflows",
     description: "List the workflows linked to a template, with each workflow's pinned template version and an `isOutdated` flag (true when a newer template version exists). " + "Use this to verify which workflows are bound to a template and to find ones that need apply_template_version.",
     inputSchema: strictSchema({
-      templateId: z10.string().min(1).describe("The template ID")
+      templateId: z11.string().min(1).describe("The template ID")
     }),
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("list_template_workflows", async (args) => {
@@ -2750,8 +2854,8 @@ function registerTemplateTools(server, ctx, helpers) {
     title: "Unlink Template from Workflows",
     description: "Unlink one or more workflows from a template in a single call. " + "Unlinked workflows keep their current configuration but stop tracking the template (future template version changes no longer apply to them).",
     inputSchema: strictSchema({
-      templateId: z10.string().min(1).describe("The template ID to unlink workflows from"),
-      workflowIds: z10.preprocess(coerceArray(true), z10.array(z10.string().min(1)).min(1)).describe("Workflow IDs to unlink from the template (array of strings). Also accepts a single ID string.")
+      templateId: z11.string().min(1).describe("The template ID to unlink workflows from"),
+      workflowIds: z11.preprocess(coerceArray(true), z11.array(z11.string().min(1)).min(1)).describe("Workflow IDs to unlink from the template (array of strings). Also accepts a single ID string.")
     }),
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("unlink_template_from_workflows", async (args) => {
@@ -2774,16 +2878,16 @@ var init_templates = __esm(() => {
 });
 
 // src/tools/variables.ts
-import { z as z11 } from "zod";
+import { z as z12 } from "zod";
 function registerVariableTools(server, ctx, helpers) {
   const { withErrorHandling } = helpers;
   server.registerTool("create_variable", {
     title: "Create Variable",
     description: "Create a new variable. Variables are key-value pairs that can be referenced in workflow prompts using @variableKey syntax. Keys must be unique within the team scope.",
     inputSchema: strictSchema({
-      key: z11.string().describe("Variable key (must be unique within scope). Referenced in prompts as @key."),
-      value: z11.string().describe("Variable value"),
-      dataType: z11.enum(["STRING", "SECRET", "OBJECT", "ARRAY"]).optional().describe("Data type of the value (defaults to STRING)")
+      key: z12.string().describe("Variable key (must be unique within scope). Referenced in prompts as @key."),
+      value: z12.string().describe("Variable value"),
+      dataType: z12.enum(["STRING", "SECRET", "OBJECT", "ARRAY"]).optional().describe("Data type of the value (defaults to STRING)")
     }),
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
   }, withErrorHandling("create_variable", async (args) => {
@@ -2815,7 +2919,7 @@ function registerVariableTools(server, ctx, helpers) {
     title: "Get Variable",
     description: "Get a specific variable by its ID.",
     inputSchema: strictSchema({
-      variableId: z11.string().min(1).describe("The variable ID")
+      variableId: z12.string().min(1).describe("The variable ID")
     }),
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("get_variable", async (args) => {
@@ -2826,10 +2930,10 @@ function registerVariableTools(server, ctx, helpers) {
     title: "Update Variable",
     description: "Update an existing variable. At least one field must be provided. If the variable key is referenced in workflow prompts (@variableKey), those workflows will automatically use the new value on next run.",
     inputSchema: strictSchema({
-      variableId: z11.string().min(1).describe("The variable ID to update"),
-      key: z11.string().optional().describe("New variable key"),
-      value: z11.string().optional().describe("New variable value"),
-      dataType: z11.enum(["STRING", "SECRET", "OBJECT", "ARRAY"]).optional().describe("New data type")
+      variableId: z12.string().min(1).describe("The variable ID to update"),
+      key: z12.string().optional().describe("New variable key"),
+      value: z12.string().optional().describe("New variable value"),
+      dataType: z12.enum(["STRING", "SECRET", "OBJECT", "ARRAY"]).optional().describe("New data type")
     }),
     annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("update_variable", async (args) => {
@@ -2845,8 +2949,8 @@ function registerVariableTools(server, ctx, helpers) {
     title: "Delete Variable",
     description: "Delete a variable permanently. This is irreversible. " + "You MUST first call this tool without confirmed=true to preview what will be deleted, " + "then show the user the variable key and ask for confirmation, " + "then call again with confirmed=true only after the user explicitly agrees.",
     inputSchema: strictSchema({
-      variableId: z11.string().min(1).describe("The variable ID to delete"),
-      confirmed: z11.preprocess(coerceBoolean(), z11.boolean()).optional().describe("Set to true only after the user has explicitly confirmed deletion. Omit or set to false for the initial preview call.")
+      variableId: z12.string().min(1).describe("The variable ID to delete"),
+      confirmed: z12.preprocess(coerceBoolean(), z12.boolean()).optional().describe("Set to true only after the user has explicitly confirmed deletion. Omit or set to false for the initial preview call.")
     }),
     annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("delete_variable", async (args) => {
@@ -2977,7 +3081,7 @@ var init_workflow_status = __esm(() => {
 
 // src/tools/workflows.ts
 import { WorkflowStatusFilter } from "@kadoa/node-sdk";
-import { z as z12 } from "zod";
+import { z as z13 } from "zod";
 function mapRunStatus(state) {
   switch (state) {
     case "FINISHED":
@@ -3188,13 +3292,12 @@ function registerWorkflowCoreTools(server, ctx, helpers, defaultProductType) {
       prompt: extractionPromptInput.describe('Natural language description of what to extract (e.g., "Extract product prices and names"). Required unless templateId is provided. With templateId, use it only for workflow-specific instructions to add to the template prompt.'),
       ...extractionInputShape,
       ...urlInputShape,
-      templateId: z12.string().optional().describe("Instantiate this workflow from a published template. Pass the templateId, source urls, optional templateVersion, and optional prompt with workflow-specific additional instructions. Do not copy the template's shared prompt, entity, or schema into this call - they are inherited from the published template version, and the workflow's output conforms to its declared schema. Discover templates via list_templates and get_template."),
-      templateVersion: z12.preprocess(coerceNumber(), z12.number()).optional().describe("Specific published template version (integer) to instantiate. Defaults to the latest published version when templateId is set."),
-      description: z12.string().max(500).optional().describe("Description of what this workflow does (max 500 characters)"),
-      tags: z12.preprocess(coerceArray(true), z12.array(z12.string())).optional().describe("Tags for organizing workflows"),
-      limit: z12.preprocess(coerceNumber(), z12.number()).optional().describe("Maximum number of records to extract per run. Useful for limiting scope or cost control."),
+      ...templateInputShape,
+      description: z13.string().max(500).optional().describe("Description of what this workflow does (max 500 characters)"),
+      tags: z13.preprocess(coerceArray(true), z13.array(z13.string())).optional().describe("Tags for organizing workflows"),
+      limit: z13.preprocess(coerceNumber(), z13.number()).optional().describe("Maximum number of records to extract per run. Useful for limiting scope or cost control."),
       updateInterval: UpdateIntervalSchema.optional().describe("How often the workflow runs. Defaults to ONLY_ONCE. Use CUSTOM with the 'schedules' field for cron-based scheduling."),
-      schedules: z12.preprocess(coerceArray(true), z12.array(z12.string())).optional().describe("Cron expressions for CUSTOM updateInterval (e.g. '0 8 * * 2' for Tuesdays at 8am UTC). Requires updateInterval='CUSTOM'."),
+      schedules: z13.preprocess(coerceArray(true), z13.array(z13.string())).optional().describe("Cron expressions for CUSTOM updateInterval (e.g. '0 8 * * 2' for Tuesdays at 8am UTC). Requires updateInterval='CUSTOM'."),
       ...notificationsInputShape
     }),
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
@@ -3338,13 +3441,14 @@ function registerWorkflowCoreTools(server, ctx, helpers, defaultProductType) {
     title: "Create Realtime Monitor",
     description: "Create a realtime monitoring workflow that continuously watches a page for data changes and sends alerts. " + (defaultProductType === "realtime" ? "This team's default product is realtime monitoring: use this tool whenever the user asks to monitor, track, or watch a page, or to get or extract data from it, unless they explicitly ask for a one-time run or a schedule. A request that names no frequency counts as realtime. " : "Use this when the user wants to monitor, track, or watch a page in realtime. ") + "At least one notification channel (email, webhook, slack, or websocket) is required; notification settings are persisted before Assistant creation is dispatched. " + `Realtime monitors CANNOT be converted to/from one-time or scheduled extraction workflows after creation.
 
-` + "If entity and schema are provided, they guide what the Assistant should monitor; otherwise the Assistant determines what to watch. " + "Creation is asynchronous and the response includes workflow, session, thread, and job IDs plus a dashboard URL. " + "Use generic workflow Assistant tools (get_workflow_assistant, answer_workflow_assistant_question, interrupt_workflow_assistant, resume_workflow_assistant, stop_workflow_assistant) for follow-up status, questions, and controls. " + "Do NOT poll or sleep-wait for completion.",
+` + "If entity and schema are provided, they guide what the Assistant should monitor; otherwise the Assistant determines what to watch. " + "To reuse a template, pass templateId, source urls, optional templateVersion, and optional prompt containing only workflow-specific additional instructions. Entity and schema are inherited from the template; do not copy its shared prompt or schema. Templates that control a batch frequency cannot be used for realtime monitors. " + "Creation is asynchronous and the response includes workflow, session, thread, and job IDs plus a dashboard URL. " + "Use generic workflow Assistant tools (get_workflow_assistant, answer_workflow_assistant_question, interrupt_workflow_assistant, resume_workflow_assistant, stop_workflow_assistant) for follow-up status, questions, and controls. " + "Do NOT poll or sleep-wait for completion.",
     inputSchema: strictSchema({
-      prompt: extractionPromptInput.describe("Optional natural language instructions describing what to monitor and which changes matter. If omitted, the Assistant determines what to watch."),
+      prompt: extractionPromptInput.describe("Optional natural language instructions describing what to monitor and which changes matter. With templateId, use it only for workflow-specific instructions to add to the template prompt. Otherwise, if omitted, the Assistant determines what to watch."),
       ...extractionInputShape,
       ...urlInputShape,
-      description: z12.string().max(500).optional().describe("Description of what this monitor watches (max 500 characters)"),
-      tags: z12.preprocess(coerceArray(true), z12.array(z12.string())).optional().describe("Tags for organizing monitors"),
+      ...templateInputShape,
+      description: z13.string().max(500).optional().describe("Description of what this monitor watches (max 500 characters)"),
+      tags: z13.preprocess(coerceArray(true), z13.array(z13.string())).optional().describe("Tags for organizing monitors"),
       ...requiredNotificationsInputShape
     }),
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
@@ -3358,6 +3462,21 @@ function registerWorkflowCoreTools(server, ctx, helpers, defaultProductType) {
     if (!hasNotifications) {
       return errorResult("Real-time monitors require at least one notification channel so you get alerted when data changes. " + "Add a notifications object with one or more channels: email, webhook, slack, or websocket.");
     }
+    let templateVersion;
+    if (args.templateId) {
+      if (args.entity || args.schema) {
+        return errorResult("When 'templateId' is set, 'entity' and 'schema' must NOT be supplied - they are inherited from the template version. Use 'prompt' only for workflow-specific additional instructions.");
+      }
+      const template = await ctx.client.template.get(args.templateId);
+      templateVersion = args.templateVersion ?? Math.max(...template.versions.map((version) => version.version));
+      const version = template.versions.find((version) => version.version === templateVersion);
+      if (!version) {
+        return errorResult("Template has no published version matching this request. Use get_template to choose a published version.");
+      }
+      if (version.frequency?.interval || version.frequency?.schedules?.length) {
+        return errorResult("This template controls a batch frequency and cannot create a realtime monitor. Use create_workflow for its configured frequency or choose a template without frequency control.");
+      }
+    }
     const channels = await ctx.client.notification.setup.setupChannels({
       channels: buildNotificationChannels(n)
     });
@@ -3367,11 +3486,26 @@ function registerWorkflowCoreTools(server, ctx, helpers, defaultProductType) {
     }
     let result;
     try {
-      result = await ctx.client.assistant.createRealtimeWorkflow({
-        instructions: buildRealtimeAssistantInstructions(args, urls),
-        notificationChannelIds,
-        ...args.tags?.length ? { tags: args.tags } : {}
-      });
+      const instructions = buildRealtimeAssistantInstructions(args, urls);
+      if (args.templateId) {
+        const response = await ctx.client.apis.agent.v5AgentPrompt({
+          agentPromptRequest: {
+            prompt: instructions,
+            productType: "realtime",
+            templateId: args.templateId,
+            templateVersion,
+            notificationChannelIds,
+            ...args.tags?.length ? { tags: args.tags } : {}
+          }
+        });
+        result = response.data?.data;
+      } else {
+        result = await ctx.client.assistant.createRealtimeWorkflow({
+          instructions,
+          notificationChannelIds,
+          ...args.tags?.length ? { tags: args.tags } : {}
+        });
+      }
     } catch (error) {
       console.error("[Tool Error] create_realtime_monitor:", safeErrorSummary(error));
       return isAmbiguousFailure(error) ? realtimeCreationFailure(shortErrorReason(error), notificationChannelIds, { outcomeUnknown: true }) : realtimeCreationFailure(classifyError(error, "create_realtime_monitor"), notificationChannelIds);
@@ -3401,13 +3535,13 @@ function registerWorkflowCoreTools(server, ctx, helpers, defaultProductType) {
         max: LIST_WORKFLOWS_MAX_LIMIT
       }),
       skip: offsetInput("skip", "workflows"),
-      state: z12.enum(["ACTIVE", "FAILED", "PAUSED", "PREVIEW"]).optional().describe("Filter by state (ACTIVE, FAILED, PAUSED, PREVIEW)"),
-      search: z12.string().optional().describe("Free-text filter matching workflow name, URL, or workflow ID"),
-      tags: z12.array(z12.string()).optional().describe("Filter to workflows having any of these tags"),
-      monitoring: z12.preprocess(coerceBoolean(), z12.boolean()).optional().describe("Filter by monitoring/real-time status"),
-      updateInterval: z12.enum(["HOURLY", "DAILY", "WEEKLY", "MONTHLY", "REAL_TIME"]).optional().describe("Filter by scheduled update frequency or realtime workflows"),
-      templateId: z12.string().optional().describe("Filter to workflows instantiated from this template ID"),
-      statusFilters: z12.array(z12.enum(Object.values(WorkflowStatusFilter))).optional().describe("Dashboard category filters. group:attention = workflows waiting on the requesting user (Assistant question, unfinished setup, or preview approval). Other groups: working, support, failed, active, complete, paused.")
+      state: z13.enum(["ACTIVE", "FAILED", "PAUSED", "PREVIEW"]).optional().describe("Filter by state (ACTIVE, FAILED, PAUSED, PREVIEW)"),
+      search: z13.string().optional().describe("Free-text filter matching workflow name, URL, or workflow ID"),
+      tags: z13.array(z13.string()).optional().describe("Filter to workflows having any of these tags"),
+      monitoring: z13.preprocess(coerceBoolean(), z13.boolean()).optional().describe("Filter by monitoring/real-time status"),
+      updateInterval: z13.enum(["HOURLY", "DAILY", "WEEKLY", "MONTHLY", "REAL_TIME"]).optional().describe("Filter by scheduled update frequency or realtime workflows"),
+      templateId: z13.string().optional().describe("Filter to workflows instantiated from this template ID"),
+      statusFilters: z13.array(z13.enum(Object.values(WorkflowStatusFilter))).optional().describe("Dashboard category filters. group:attention = workflows waiting on the requesting user (Assistant question, unfinished setup, or preview approval). Other groups: working, support, failed, active, complete, paused.")
     }),
     outputSchema: ListWorkflowsOutput,
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
@@ -3478,7 +3612,7 @@ function registerWorkflowCoreTools(server, ctx, helpers, defaultProductType) {
     title: "Get Workflow",
     description: 'Get canonical workflow details, including Assistant/session linkage, extraction intent, template-controlled parts, job/run state, schedule timezone, location, monitoring, and realtime health. For Assistant-built workflows, extractionSpec - not the legacy prompt - is authoritative. badges[].label is exactly what the Kadoa dashboard displays (lifecycle, activity, and support badges, e.g. "Setup" + "Agent working"): use these labels when describing the workflow to the user. status is the one-line summary in dashboard wording (e.g. "Verifying data" = the latest run is held for quality review before delivery; see reviewReason for why).',
     inputSchema: strictSchema({
-      workflowId: z12.string().min(1).describe("The workflow ID")
+      workflowId: z13.string().min(1).describe("The workflow ID")
     }),
     outputSchema: GetWorkflowOutput,
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
@@ -3567,9 +3701,9 @@ function registerWorkflowCoreTools(server, ctx, helpers, defaultProductType) {
     title: "Request Workflow Update",
     description: "Request an Assistant-driven change to an existing workflow while preserving its workflowId. " + "Use for extraction intent, navigation, pagination, data sourcing, generated-script changes, and repair after a site redesign. " + "Use update_workflow instead for deterministic metadata such as name, schedule, location, tags, and limits. " + "For template-controlled prompt or schema changes, create and apply a template version instead. " + "The update is asynchronous: do not poll or sleep-wait; use get_workflow_assistant later. Never delete and recreate the workflow as a workaround.",
     inputSchema: strictSchema({
-      workflowId: z12.string().min(1).describe("The existing workflow ID; it will not change"),
-      instructions: z12.string().min(1).describe("Natural-language instructions for the workflow Assistant"),
-      threadId: z12.string().optional().describe("Optional Assistant thread ID to continue")
+      workflowId: z13.string().min(1).describe("The existing workflow ID; it will not change"),
+      instructions: z13.string().min(1).describe("Natural-language instructions for the workflow Assistant"),
+      threadId: z13.string().optional().describe("Optional Assistant thread ID to continue")
     }),
     annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true }
   }, withErrorHandling("request_workflow_update", async (args) => {
@@ -3599,14 +3733,14 @@ function registerWorkflowHistoryTools(server, ctx, helpers) {
     title: "Get Workflow History",
     description: "Get the configuration revision history (audit log) for a workflow. Each entry captures who changed the workflow, when, from which channel (UI/API/SDK/MCP/CLI/SYSTEM), a `changedFields` list, and `changes` with the before/after value of each changed field (values over 1 KB are summarized). Use this to answer questions like 'did this workflow's prompt or schema change, when, and from what to what?'. Pass includeSnapshots: true only when you need the full previousValue/newValue workflow snapshots (large). Note: CREATE entries have empty `changedFields`/`changes` and null snapshots (no initial-state snapshot is captured).",
     inputSchema: strictSchema({
-      workflowId: z12.string().min(1).describe("The workflow ID"),
+      workflowId: z13.string().min(1).describe("The workflow ID"),
       page: pageInput(),
       limit: limitInput({
         noun: "Entries",
         defaultLimit: WORKFLOW_HISTORY_DEFAULT_LIMIT,
         max: WORKFLOW_HISTORY_MAX_LIMIT
       }),
-      includeSnapshots: z12.preprocess(coerceBoolean(), z12.boolean()).optional().describe("Include full previousValue/newValue workflow snapshots per entry (default false; large)")
+      includeSnapshots: z13.preprocess(coerceBoolean(), z13.boolean()).optional().describe("Include full previousValue/newValue workflow snapshots per entry (default false; large)")
     }),
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("get_workflow_history", async (args) => {
@@ -3658,8 +3792,8 @@ function registerWorkflowHistoryTools(server, ctx, helpers) {
     title: "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. `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. `label` is the dashboard's wording for the run " + "(Success, Failed, Running, or 'Verifying data' = held for quality review before delivery); " + "prefer it when describing a run to the user.",
     inputSchema: strictSchema({
-      workflowId: z12.string().min(1).describe("The workflow ID"),
-      status: z12.enum(["success", "failed", "in_progress"]).optional().describe("Filter runs by outcome"),
+      workflowId: z13.string().min(1).describe("The workflow ID"),
+      status: z13.enum(["success", "failed", "in_progress"]).optional().describe("Filter runs by outcome"),
       page: pageInput(),
       limit: limitInput({ noun: "Runs", defaultLimit: WORKFLOW_RUNS_DEFAULT_LIMIT, max: WORKFLOW_RUNS_MAX_LIMIT })
     }),
@@ -3703,8 +3837,8 @@ function registerWorkflowRunTools(server, ctx, helpers) {
     title: "Run Workflow",
     description: "Run a workflow to extract fresh data, including retrying a failed one-time or scheduled workflow. Preserve the existing workflow ID and configuration - do not delete and recreate the workflow solely to retry it. 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. Realtime workflows cannot be manually run.",
     inputSchema: strictSchema({
-      workflowId: z12.string().min(1).describe("The workflow ID to run"),
-      limit: z12.preprocess(coerceNumber(), z12.number()).optional().describe("Maximum number of records to extract (default: 1000)")
+      workflowId: z13.string().min(1).describe("The workflow ID to run"),
+      limit: z13.preprocess(coerceNumber(), z13.number()).optional().describe("Maximum number of records to extract (default: 1000)")
     }),
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
   }, withErrorHandling("run_workflow", async (args) => {
@@ -3727,7 +3861,7 @@ function registerWorkflowRunTools(server, ctx, helpers) {
     title: "Fetch Workflow Data",
     description: "Get a PAGE of extracted data from a workflow. Use ONLY for previews, sorted/filtered slices, or explicit 'first N rows' / 'top N' queries (capped at 500 rows per call). Do NOT use this to retrieve a full dataset, 'all rows', or anything the user wants to analyze in Excel / pandas / duckdb - use export_data for those. Data is only available after the workflow run has completed (status is no longer 'Running' or 'Verifying data'). Do NOT poll or sleep-wait for completion.",
     inputSchema: strictSchema({
-      workflowId: z12.string().min(1).describe("The workflow ID"),
+      workflowId: z13.string().min(1).describe("The workflow ID"),
       limit: limitInput({
         noun: "Rows",
         defaultLimit: FETCH_DATA_DEFAULT_LIMIT,
@@ -3736,8 +3870,8 @@ function registerWorkflowRunTools(server, ctx, helpers) {
       }),
       page: pageInput(),
       filters: dataFiltersInput,
-      sortBy: z12.string().optional().describe("Field name to sort by"),
-      order: z12.enum(["asc", "desc"]).optional().describe("Sort order: asc or desc")
+      sortBy: z13.string().optional().describe("Field name to sort by"),
+      order: z13.enum(["asc", "desc"]).optional().describe("Sort order: asc or desc")
     }),
     outputSchema: FetchDataOutput,
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
@@ -3786,13 +3920,13 @@ function registerWorkflowRunTools(server, ctx, helpers) {
     title: "Export Workflow Data",
     description: "PREFERRED tool for retrieving a workflow's FULL dataset. Materializes the data to object storage and returns a signed download URL. Use this whenever the user wants 'all rows', 'the full dataset', 'everything', an export, or anything destined for Excel / pandas / duckdb / a CSV file - even for small workflows. The URL is self-authenticating (open with `fetch(url)`, no Authorization header). Use fetch_data ONLY when the user explicitly asks for a small preview slice (e.g., 'first 10', 'top N sorted by X').",
     inputSchema: strictSchema({
-      workflowId: z12.string().min(1).describe("The workflow ID"),
-      format: z12.enum(["csv", "json"]).optional().describe("Export format. Default 'csv'."),
-      runId: z12.string().optional().describe("Specific run ID to export. Defaults to the latest completed run."),
+      workflowId: z13.string().min(1).describe("The workflow ID"),
+      format: z13.enum(["csv", "json"]).optional().describe("Export format. Default 'csv'."),
+      runId: z13.string().optional().describe("Specific run ID to export. Defaults to the latest completed run."),
       filters: dataFiltersInput,
-      sortBy: z12.string().optional().describe("Field name to sort by"),
-      order: z12.enum(["asc", "desc"]).optional().describe("Sort order: asc or desc"),
-      rowIds: z12.preprocess(coerceList(), z12.array(z12.string().trim().min(1)).max(1000)).optional().describe("Row ids to include (max 1000)")
+      sortBy: z13.string().optional().describe("Field name to sort by"),
+      order: z13.enum(["asc", "desc"]).optional().describe("Sort order: asc or desc"),
+      rowIds: z13.preprocess(coerceList(), z13.array(z13.string().trim().min(1)).max(1000)).optional().describe("Row ids to include (max 1000)")
     }),
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("export_data", async (args) => {
@@ -3826,9 +3960,9 @@ function registerWorkflowRunTools(server, ctx, helpers) {
     title: "List Detected Changes",
     description: "List detected data changes across one or more realtime monitoring workflows. " + "Returns structured diffs showing added, removed, and changed records. " + "Only works for workflows with realtime monitoring enabled.",
     inputSchema: strictSchema({
-      workflowIds: z12.preprocess(coerceArray(true), z12.array(z12.string().min(1))).optional().describe("Workflow IDs to filter by. If omitted, returns changes for all ACTIVE monitoring workflows."),
-      startDate: z12.string().optional().describe("Start date filter (ISO format, e.g. 2025-01-01)"),
-      endDate: z12.string().optional().describe("End date filter (ISO format, e.g. 2025-12-31)"),
+      workflowIds: z13.preprocess(coerceArray(true), z13.array(z13.string().min(1))).optional().describe("Workflow IDs to filter by. If omitted, returns changes for all ACTIVE monitoring workflows."),
+      startDate: z13.string().optional().describe("Start date filter (ISO format, e.g. 2025-01-01)"),
+      endDate: z13.string().optional().describe("End date filter (ISO format, e.g. 2025-12-31)"),
       skip: offsetInput("skip", "changes"),
       limit: limitInput({ noun: "Changes", defaultLimit: LIST_CHANGES_DEFAULT_LIMIT, max: LIST_CHANGES_MAX_LIMIT })
     }),
@@ -3866,7 +4000,7 @@ function registerWorkflowRunTools(server, ctx, helpers) {
     title: "Get Detected Change",
     description: "Get detailed information about a specific detected change, including the data snapshot and diff. Results over ~80 KB are cut to whole rows and marked truncated.",
     inputSchema: strictSchema({
-      changeId: z12.string().min(1).describe("The change ID")
+      changeId: z13.string().min(1).describe("The change ID")
     }),
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("get_change", async (args) => {
@@ -3877,8 +4011,8 @@ function registerWorkflowRunTools(server, ctx, helpers) {
     title: "Delete Workflow",
     description: "Delete a workflow permanently. This is irreversible. " + "You MUST first call this tool without confirmed=true to preview what will be deleted, " + "then show the user the workflow name and ask for confirmation, " + "then call again with confirmed=true only after the user explicitly agrees.",
     inputSchema: strictSchema({
-      workflowId: z12.string().min(1).describe("The workflow ID to delete"),
-      confirmed: z12.preprocess(coerceBoolean(), z12.boolean()).optional().describe("Set to true only after the user has explicitly confirmed deletion. Omit or set to false for the initial preview call.")
+      workflowId: z13.string().min(1).describe("The workflow ID to delete"),
+      confirmed: z13.preprocess(coerceBoolean(), z13.boolean()).optional().describe("Set to true only after the user has explicitly confirmed deletion. Omit or set to false for the initial preview call.")
     }),
     annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("delete_workflow", async (args) => {
@@ -3908,7 +4042,7 @@ function registerWorkflowRunTools(server, ctx, helpers) {
     title: "Approve Workflow",
     description: "Approve and activate a workflow that is in PREVIEW, PAUSED, or ERROR state. Transitions the workflow to ACTIVE so it can be run.",
     inputSchema: strictSchema({
-      workflowId: z12.string().min(1).describe("The workflow ID to approve/activate")
+      workflowId: z13.string().min(1).describe("The workflow ID to approve/activate")
     }),
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }
   }, withErrorHandling("approve_workflow", async (args) => {
@@ -3923,7 +4057,7 @@ function registerWorkflowRunTools(server, ctx, helpers) {
     title: "Pause Workflow",
     description: "Pause an ACTIVE workflow so it stops running on its schedule. Requires the workflow to be in ACTIVE state - pausing a workflow that is currently running, already paused, or in PREVIEW will return an error. Use approve_workflow to resume a paused workflow.",
     inputSchema: strictSchema({
-      workflowId: z12.string().min(1).describe("The workflow ID to pause")
+      workflowId: z13.string().min(1).describe("The workflow ID to pause")
     }),
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
   }, withErrorHandling("pause_workflow", async (args) => {
@@ -3942,20 +4076,20 @@ function registerWorkflowRunTools(server, ctx, helpers) {
 
 ` + "ASSISTANT-OWNED INTENT: Use request_workflow_update - not `userPrompt` - for Assistant-built workflow changes to extraction intent, navigation, pagination, data sourcing, repair, or generated scripts. The API may reject `userPrompt` because these workflows' canonical intent is owned by the Assistant. " + "Call get_workflow first. If its template.controlledParts contains the setting, create and apply a template version instead of overriding the workflow directly. NEVER delete and recreate a workflow to work around an update limitation - that changes workflowId, breaks downstream tables/connectors, and discards history.",
     inputSchema: strictSchema({
-      workflowId: z12.string().min(1).describe("The workflow ID to update"),
-      name: z12.string().optional().describe("New name for the workflow"),
-      urls: z12.preprocess(coerceArray(true), z12.array(z12.string()).min(1)).optional().describe("New target URLs for the workflow (array of strings). Also accepts a single URL string."),
-      entity: z12.string().optional().describe("Entity name for extraction (e.g., 'Product', 'Job Posting')"),
-      schema: z12.preprocess(coerceArray(), z12.array(z12.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: z12.string().max(500).optional().describe("Workflow description (max 500 characters)"),
-      tags: z12.preprocess(coerceArray(true), z12.array(z12.string())).optional().describe("Tags for organizing workflows"),
-      userPrompt: z12.string().optional().describe("Navigation prompt for agentic-navigation mode (10-5000 characters)"),
+      workflowId: z13.string().min(1).describe("The workflow ID to update"),
+      name: z13.string().optional().describe("New name for the workflow"),
+      urls: z13.preprocess(coerceArray(true), z13.array(z13.string()).min(1)).optional().describe("New target URLs for the workflow (array of strings). Also accepts a single URL string."),
+      entity: z13.string().optional().describe("Entity name for extraction (e.g., 'Product', 'Job Posting')"),
+      schema: z13.preprocess(coerceArray(), z13.array(z13.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: z13.string().max(500).optional().describe("Workflow description (max 500 characters)"),
+      tags: z13.preprocess(coerceArray(true), z13.array(z13.string())).optional().describe("Tags for organizing workflows"),
+      userPrompt: z13.string().optional().describe("Navigation prompt for agentic-navigation mode (10-5000 characters)"),
       updateInterval: UpdateIntervalSchema.optional().describe("How often the workflow should run. CUSTOM requires schedules. Note: REAL_TIME is NOT allowed here - realtime workflows must be created via create_realtime_monitor."),
-      schedules: z12.preprocess(coerceArray(true), z12.array(z12.string())).optional().describe("Cron expressions for CUSTOM update interval"),
-      timezone: z12.string().min(1).optional().describe("IANA timezone for cron schedules, for example America/New_York. A timezone-only update preserves existing cron expressions."),
-      location: z12.preprocess(coerceJson(), LocationSchema).optional().describe("Scraping location: {type:'auto'} or {type:'manual', isoCode:'US'}"),
-      monitoring: z12.preprocess(coerceJson(), MonitoringSchema).optional().describe("Complete monitoring replacement: fields to monitor and optional AND/OR conditions. Call get_workflow first because this replaces the existing monitoring configuration."),
-      limit: z12.preprocess(coerceNumber(), z12.number().positive().nullable()).optional().describe("Maximum records per run; must be positive (greater than 0). Pass null to clear the limit and extract all rows.")
+      schedules: z13.preprocess(coerceArray(true), z13.array(z13.string())).optional().describe("Cron expressions for CUSTOM update interval"),
+      timezone: z13.string().min(1).optional().describe("IANA timezone for cron schedules, for example America/New_York. A timezone-only update preserves existing cron expressions."),
+      location: z13.preprocess(coerceJson(), LocationSchema).optional().describe("Scraping location: {type:'auto'} or {type:'manual', isoCode:'US'}"),
+      monitoring: z13.preprocess(coerceJson(), MonitoringSchema).optional().describe("Complete monitoring replacement: fields to monitor and optional AND/OR conditions. Call get_workflow first because this replaces the existing monitoring configuration."),
+      limit: z13.preprocess(coerceNumber(), z13.number().positive().nullable()).optional().describe("Maximum records per run; must be positive (greater than 0). Pass null to clear the limit and extract all rows.")
     }),
     annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }
   }, withErrorHandling("update_workflow", async (args) => {
@@ -4031,10 +4165,12 @@ function registerTools(server, ctx, capabilities) {
   registerComplianceTools(server, ctx, helpers);
   registerVariableTools(server, ctx, helpers);
   registerTemplateTools(server, ctx, helpers);
+  registerDocsTools(server, ctx, helpers);
 }
 var init_tools = __esm(() => {
   init_assistant();
   init_compliance();
+  init_docs();
   init_notifications();
   init_observability();
   init_scrape();
@@ -4760,7 +4896,9 @@ async function createServer3(auth, options) {
       "Schema tips: Use descriptive field names and examples. Group related data under one entity.",
       "The AI agent uses the schema + prompt to understand what to extract - a detailed prompt with a comprehensive schema produces better results than multiple simple workflows.",
       "",
-      "Templates enforce their schema: a workflow created from a template (create_workflow with templateId) or linked to one (link_template_to_workflows) produces output whose field names conform to the template's declared schema. Use templates when you need many workflows to return a consistent, canonical set of fields - do NOT assume the extractor will drift field names away from a template's schema."
+      "For questions about how Kadoa works or where to find something (API keys, billing and invoices, usage, settings), use list_docs_pages then read_docs_page and cite the page URL. Do not answer those from memory.",
+      "",
+      "Templates enforce their schema: a workflow created from a template (create_workflow or create_realtime_monitor with templateId) or linked to one (link_template_to_workflows) produces output whose field names conform to the template's declared schema. Use templates when you need many workflows to return a consistent, canonical set of fields - do NOT assume the extractor will drift field names away from a template's schema."
     ].join(`
 `)
   });
@@ -5238,7 +5376,9 @@ async function createServer(auth, options) {
       "Schema tips: Use descriptive field names and examples. Group related data under one entity.",
       "The AI agent uses the schema + prompt to understand what to extract - a detailed prompt with a comprehensive schema produces better results than multiple simple workflows.",
       "",
-      "Templates enforce their schema: a workflow created from a template (create_workflow with templateId) or linked to one (link_template_to_workflows) produces output whose field names conform to the template's declared schema. Use templates when you need many workflows to return a consistent, canonical set of fields - do NOT assume the extractor will drift field names away from a template's schema."
+      "For questions about how Kadoa works or where to find something (API keys, billing and invoices, usage, settings), use list_docs_pages then read_docs_page and cite the page URL. Do not answer those from memory.",
+      "",
+      "Templates enforce their schema: a workflow created from a template (create_workflow or create_realtime_monitor with templateId) or linked to one (link_template_to_workflows) produces output whose field names conform to the template's declared schema. Use templates when you need many workflows to return a consistent, canonical set of fields - do NOT assume the extractor will drift field names away from a template's schema."
     ].join(`
 `)
   });