@kadoa/mcp 0.6.2 → 0.6.3

package/README.md

@@ -77,8 +77,6 @@ Point your client to `https://mcp.kadoa.com/mcp` with OAuth authentication.
 | `get_workflow_history` | Get the workflow's configuration revision history (audit log) — who changed it, when, from which channel, and a `changedFields` summary per revision |
 | `list_activity` | List the team's Activity log (audit trail) across all workflows and resources: actor email, resource name, action, interface, timestamp, change summary; filter by time window, user, workflow, action, interface, resource type. Use `get_workflow_history` for one workflow's config diffs |
 | `list_workflow_runs` | List a workflow's execution run history (status, start/finish, record count, errors); filter by outcome and paginate |
-| `get_usage` | Current plan usage for the active team or its organization: workflow slot quota and usage, billable and active workflows, extracted rows, billing period and renewal date |
-| `get_usage_history` | Daily usage history (active workflows, billing-period cumulative, or daily activity) for up to 366 days |
 | `get_observability` | Team-wide workflow health for a window of days: uptime, failed runs, MTTR, records delivered, health counts, and a ranked list of down or degraded workflows (the Observability page data) |
 | `run_workflow` | Execute a workflow |
 | `fetch_data` | Get extracted data from a workflow |
@@ -98,7 +96,6 @@ For detailed customer guidance, see the [Kadoa documentation](https://docs.kadoa
 - **Run history:** `list_workflow_runs` filters by `status` (`success`, `failed`, or `in_progress`) and supports 1-based `page` and `limit` pagination.
 - **Notifications:** `create_realtime_monitor` requires at least one email, webhook, Slack, or WebSocket notification channel. Notifications are optional when creating a standard one-time or scheduled workflow with `create_workflow`.
 - **Template changes:** `update_template` changes template name and description only. To change template-controlled configuration, create an immutable version with `create_template_version`, then roll it out to linked workflows with `apply_template_version`.
-- **Usage:** `get_usage` reports slots and rows, not credits. `usedThisPeriod` resets at the renewal date; `usedActive` is the current slot count; `usedAllTime` never resets. Pass `scope: "organization"` to match the Usage page for organization members.
 
 ## Usage Examples
 

package/dist/index.js

@@ -45841,31 +45841,6 @@ function mapActivityEvent2(event, includeDetails) {
     ...includeDetails ? { details: { previousValue: details.previousValue, newValue: details.newValue } } : {}
   };
 }
-function shapeUsageWorkflows(workflows, limit) {
-  const sorted = [...workflows].sort((a, b) => b.slotWeight - a.slotWeight || b.runsInPeriod - a.runsInPeriod || (a.name ?? "").localeCompare(b.name ?? ""));
-  return {
-    totalCount: workflows.length,
-    truncated: sorted.length > limit,
-    items: sorted.slice(0, limit)
-  };
-}
-function usagePeriodProgress(period, now) {
-  if (!period)
-    return null;
-  const start = Date.parse(period.start);
-  const end = Date.parse(period.end);
-  if (Number.isNaN(start) || Number.isNaN(end) || end <= start)
-    return null;
-  const total = end - start;
-  const elapsed = Math.min(Math.max(now.getTime() - start, 0), total);
-  const totalDays = total / DAY_MS;
-  const daysElapsed = Math.floor(elapsed / DAY_MS);
-  return {
-    daysElapsed,
-    daysRemaining: Math.ceil((total - elapsed) / DAY_MS),
-    percentElapsed: Math.round(daysElapsed / totalDays * 100)
-  };
-}
 function rankWorkflowsBySeverity(workflows) {
   return [...workflows].sort((a, b) => {
     const bySeverity = HEALTH_SEVERITY[a.health] - HEALTH_SEVERITY[b.health];
@@ -47462,150 +47437,6 @@ function registerTools(server, ctx, capabilities) {
       message: `Switched to team "${match.name}". All subsequent API calls will use this team.`
     });
   }));
-  const usageScopeInput = _enum(["team", "organization"]).optional().describe("Which workspace to report. 'team' (default) is the active team. 'organization' is the whole organization that owns the active team, matching the Usage page for organization members. Errors for a standalone team.");
-  function usageTeamId() {
-    const teamId = ctx.teamId ?? ctx.principal.teamId;
-    if (!teamId)
-      throw new Error("No active team on this session; run team_list first");
-    return teamId;
-  }
-  server.registerTool("get_usage", {
-    description: "Current plan usage for the active team (or its organization): workflow slot quota and slots used, workflows counted by each billing rule, extracted rows this billing period, the billing period with renewal date, and the workflows behind the numbers. " + "Kadoa has no credits; usage is measured in workflow slots (each workflow weighs 0.1, 1, or 2-10 slots) and extracted rows. " + "Use for questions like 'how much of my plan have I used', 'when does my contract renew', 'which workflows are billing this period', 'am I near my limit'. " + "For trends over time use get_usage_history. For a single workflow's runs use list_workflow_runs. " + "'usedThisPeriod' values reset at the renewal date; 'usedActive' is the number of slots in use right now; 'usedAllTime' never resets. A null billingPeriod means a trial or a contract without a renewal date, and period-scoped values are then null too. Quote workflows by name; ids are stripped from customer-facing text.",
-    inputSchema: {
-      scope: usageScopeInput,
-      includeWorkflows: preprocess(coerceBoolean(), boolean2()).optional().describe("Include the billable and active workflow lists (default true). Set false for a numbers-only answer."),
-      workflowLimit: preprocess(coerceNumber(), number2().int().min(1).max(100)).optional().describe("Maximum workflows per list, heaviest slot weight first (default 25, max 100).")
-    },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true }
-  }, withErrorHandling("get_usage", async (args) => {
-    const scope = args.scope ?? "team";
-    const includeWorkflows = args.includeWorkflows ?? true;
-    const workflowLimit = args.workflowLimit ?? 25;
-    const workspace = await ctx.client.usage.resolveWorkspace(usageTeamId(), scope);
-    const [quotas, billable] = await Promise.all([
-      ctx.client.usage.getQuotas(workspace.workspaceId),
-      includeWorkflows ? ctx.client.usage.listBillableWorkflows(workspace.workspaceId) : Promise.resolve(null)
-    ]);
-    const progress = usagePeriodProgress(quotas.billingPeriod, new Date);
-    const shapeItems = (list) => {
-      const shaped = shapeUsageWorkflows(list, workflowLimit);
-      return {
-        totalCount: shaped.totalCount,
-        truncated: shaped.truncated,
-        items: shaped.items.map((w) => ({
-          workflowId: w.workflowId,
-          name: w.name,
-          state: w.state,
-          scheduled: w.scheduled,
-          slotWeight: w.slotWeight,
-          runsInPeriod: w.runsInPeriod,
-          rowsExtracted: w.rowsExtracted,
-          firstRunAt: w.firstRunAt
-        }))
-      };
-    };
-    return jsonResult({
-      workspace: { id: workspace.workspaceId, type: workspace.workspaceType, name: workspace.name },
-      billingModel: quotas.billingModel,
-      billingPeriod: quotas.billingPeriod ? {
-        start: quotas.billingPeriod.start,
-        end: quotas.billingPeriod.end,
-        renewalDate: quotas.billingPeriod.renewalDate,
-        ...progress
-      } : null,
-      workflowSlots: {
-        limit: quotas.limits.workflowSlots,
-        usedActive: quotas.used.activeWorkflowSlots,
-        usedThisPeriod: quotas.used.contractActiveWorkflowSlots,
-        usedPreviousPeriod: quotas.used.previousContractActiveWorkflowSlots
-      },
-      workflows: {
-        total: quotas.used.totalWorkflows,
-        active: quotas.used.activeWorkflows,
-        active35Days: quotas.used.active35Workflows,
-        billableThisPeriod: quotas.used.contractActiveWorkflows,
-        billablePreviousPeriod: quotas.used.previousContractActiveWorkflows,
-        scheduledIntoNextPeriod: billable?.scheduledWorkflows ?? null
-      },
-      extractedRows: {
-        limit: quotas.limits.extractedRows,
-        usedThisPeriod: quotas.used.extractedRowsThisPeriod,
-        usedAllTime: quotas.used.extractedRowsAllTime
-      },
-      ...billable ? {
-        billableWorkflows: { slotUsage: billable.billableSlotUsage, ...shapeItems(billable.billableWorkflows) },
-        activeWorkflows: { slotUsage: billable.activeSlotUsage, ...shapeItems(billable.activeWorkflows) }
-      } : {},
-      units: {
-        workflowSlots: "slots (weighted: 0.1 simple, 1 standard, 2-10 complex)",
-        extractedRows: "rows",
-        dates: "ISO 8601 UTC"
-      }
-    });
-  }));
-  server.registerTool("get_usage_history", {
-    description: "Daily usage history for the active team (or its organization), one point per UTC day, oldest first. Pick one metric: " + "'active_workflows' = workflows and slots counted by the Active billing rule each day (today's point matches get_usage.workflowSlots.usedActive; older points are an approximation); " + "'billing_period_cumulative' = billable workflows, slots, and extracted rows accumulated since the start of the billing period that contains each day, resetting to zero at each renewal (today's point matches get_usage usedThisPeriod); " + "'daily_activity' = per-day totals of existing workflows, newly approved workflows, and rows extracted that day, informational only and not a billing number. " + "Use for 'how has my usage changed', 'when did slot usage jump', 'rows per day last month'. Use get_usage for the current numbers. Default window is 90 days; maximum 366.",
-    inputSchema: {
-      metric: _enum(["active_workflows", "billing_period_cumulative", "daily_activity"]).describe("Which series to return. See the tool description for what each one measures."),
-      days: preprocess(coerceNumber(), number2().int().min(1).max(366)).optional().describe("Trailing UTC days to return, 1-366 (default 90)."),
-      scope: usageScopeInput
-    },
-    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true }
-  }, withErrorHandling("get_usage_history", async (args) => {
-    const days = args.days ?? 90;
-    const workspace = await ctx.client.usage.resolveWorkspace(usageTeamId(), args.scope ?? "team");
-    const base = {
-      workspace: { id: workspace.workspaceId, type: workspace.workspaceType, name: workspace.name },
-      metric: args.metric,
-      days
-    };
-    if (args.metric === "active_workflows") {
-      const points = (await ctx.client.usage.getActiveSeries(workspace.workspaceId, { days })).map((p) => ({
-        date: p.date,
-        activeWorkflows: p.active,
-        activeSlots: p.activeSlots,
-        active35Days: p.active35
-      }));
-      return jsonResult({
-        ...base,
-        units: { activeWorkflows: "workflows", activeSlots: "slots", active35Days: "workflows" },
-        pointCount: points.length,
-        latest: points.at(-1) ?? null,
-        points
-      });
-    }
-    if (args.metric === "billing_period_cumulative") {
-      const points = (await ctx.client.usage.getPeriodSeries(workspace.workspaceId, { days })).map((p) => ({
-        date: p.date,
-        billableWorkflows: p.approved,
-        billableSlots: p.approvedSlots,
-        extractedRows: p.rows
-      }));
-      return jsonResult({
-        ...base,
-        units: { billableWorkflows: "workflows since period start", billableSlots: "slots", extractedRows: "rows since period start" },
-        pointCount: points.length,
-        latest: points.at(-1) ?? null,
-        points
-      });
-    }
-    const activity = await ctx.client.usage.getActivityUsage(workspace.workspaceId, { days });
-    const points = activity.days.map((p) => ({
-      date: p.date,
-      totalWorkflows: p.totalWorkflows,
-      approvedWorkflows: p.approvedWorkflows,
-      extractedRows: p.extractedRows
-    }));
-    return jsonResult({
-      ...base,
-      range: { start: activity.start, end: activity.end },
-      units: { totalWorkflows: "workflows existing that day", approvedWorkflows: "workflows approved that day", extractedRows: "rows extracted that day" },
-      totals: activity.totals,
-      pointCount: points.length,
-      latest: points.at(-1) ?? null,
-      points
-    });
-  }));
   server.registerTool("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({
@@ -47981,7 +47812,7 @@ function registerTools(server, ctx, capabilities) {
     });
   }));
 }
-var SchemaFieldShape, SchemaValidationAttributionShape, SchemaValidationPresenceRule, SchemaValidationUniquenessRule, SchemaValidationStringLengthRule, SchemaValidationStringFormatRule, SchemaValidationFieldRulesSchema, SchemaValidationRulesSchema, LocationSchema, MonitoringValueOperators, MonitoringValuelessOperators, MonitoringConditionOperatorSchema, MonitoringConditionSchema, MonitoringSchema, RESUMABLE_ASSISTANT_STATUSES, ACTIVE_ASSISTANT_STATUSES, IDLE_ASSISTANT_STATUSES, CLOSED_ASSISTANT_STATUSES, DASHBOARD_BASE_URL = "https://www.kadoa.com", WORKFLOW_AUDIT_WATCHED_KEYS, ACTIVITY_DEFAULT_LIMIT = 25, ACTIVITY_MAX_LIMIT = 200, DAY_MS = 86400000, HEALTH_SEVERITY;
+var SchemaFieldShape, SchemaValidationAttributionShape, SchemaValidationPresenceRule, SchemaValidationUniquenessRule, SchemaValidationStringLengthRule, SchemaValidationStringFormatRule, SchemaValidationFieldRulesSchema, SchemaValidationRulesSchema, LocationSchema, MonitoringValueOperators, MonitoringValuelessOperators, MonitoringConditionOperatorSchema, MonitoringConditionSchema, MonitoringSchema, RESUMABLE_ASSISTANT_STATUSES, ACTIVE_ASSISTANT_STATUSES, IDLE_ASSISTANT_STATUSES, CLOSED_ASSISTANT_STATUSES, DASHBOARD_BASE_URL = "https://www.kadoa.com", WORKFLOW_AUDIT_WATCHED_KEYS, ACTIVITY_DEFAULT_LIMIT = 25, ACTIVITY_MAX_LIMIT = 200, HEALTH_SEVERITY;
 var init_tools = __esm(() => {
   init_dist2();
   init_zod();
@@ -48179,7 +48010,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kadoa/mcp",
-    version: "0.6.2",
+    version: "0.6.3",
     description: "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
     type: "module",
     main: "dist/index.js",

package/package.json

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