@velaro/mcp-server 0.6.71 → 0.6.73

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velaro/mcp-server",
-  "version": "0.6.71",
+  "version": "0.6.73",
   "description": "Velaro MCP server — connect Claude and other AI agents directly to your Velaro account: KB, workflows, bots, conversations, contacts, routing, and more.",
   "type": "module",
   "bin": {

package/server.js

@@ -2103,6 +2103,33 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: ['reportType', 'isEnabled'],
     },
   },
+  {
+    name: 'report_subscriptions_list',
+    description: "List the caller's own scheduled report email subscriptions (velaro-messaging /report-subscriptions): id, report type, frequency, active, delivery hour, format (pdf/html), extra recipients.",
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'report_subscription_update',
+    description: "Update one of the caller's report subscriptions by id. Only passed fields change. Extra recipients must be other users on the same account (max 10); pass an empty string to clear.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id:                { type: 'number', description: 'Subscription id from report_subscriptions_list' },
+        frequency:         { type: 'string', enum: ['daily', 'weekly', 'bi-monthly', 'monthly'] },
+        deliveryHour:      { type: 'number', description: 'Site-local hour 0-23 to deliver at or after' },
+        clearDeliveryHour: { type: 'boolean', description: 'Remove the delivery hour (send at the first run)' },
+        format:            { type: 'string', enum: ['pdf', 'html'] },
+        extraRecipients:   { type: 'string', description: 'Comma-separated emails; empty string clears' },
+        isActive:          { type: 'boolean', description: 'false pauses, true resumes' },
+      },
+      required: ['id'],
+    },
+  },
+  {
+    name: 'report_subscription_delete',
+    description: "Delete one of the caller's report subscriptions by id (not by report type).",
+    inputSchema: { type: 'object', properties: { id: { type: 'number', description: 'Subscription id' } }, required: ['id'] },
+  },
   {
     name: 'report_export_status',
     description: 'Check the status of a queued async report export (Reports/ExportStatus/{id}) — pending/processing/completed/failed and the download URL once ready.',
@@ -2787,6 +2814,20 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       },
     },
   },
+  {
+    name: 'report_backfill',
+    description: 'Backfill report data for the caller site. Preview by default (reports "would fill N", writes nothing); apply=true writes. Idempotent. type "csat" fills missing survey ratings (SurveySubmission.Rating) from existing data; it does NOT touch ticket CSAT. Site managers only; scoped to the caller site.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        type:  { type: 'string', description: 'Backfill type, e.g. csat.' },
+        from:  { type: 'string', description: 'yyyy-MM-dd start.' },
+        to:    { type: 'string', description: 'yyyy-MM-dd end.' },
+        apply: { type: 'boolean', description: 'true = write. Default false (preview only).' },
+      },
+      required: ['type', 'from', 'to'],
+    },
+  },
   // -- Staff: schedule adherence by site + role (SupportTools-style: explicit siteId, never auth-derived) --
   // Backend: velaro-messaging ReportsController.ScheduleAdherenceDiagnosticsAsync, gated by
   // IsSuperAdminAsync(allowSupport: true) -> 403 for non-staff. role=agent REQUIRES agentId (fails closed).
@@ -4305,6 +4346,12 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
     },
   },
 
+  {
+    name: 'focus_get_triage_economy_report',
+    description: 'Triage Economy report for this site: conversations triaged, rules vs Haiku counts, rules hit rate, Haiku calls avoided, estimated USD saved, latency, correction rates (rules vs Haiku quality), effective mode and its source (force|site|default). Skill selection is unaffected by economy mode. siteId comes from the session, never an argument.',
+    inputSchema: { type: 'object', properties: { days: { type: 'number', description: 'Lookback window in days (default 30).' } } },
+  },
+
   // Feature Discovery -- non-nag "features on other plans this account doesn't have yet" nudge
   // siteId is never accepted as a tool argument -- FeatureDiscoveryController derives it
   // server-side from the caller's auth context (MCP key / JWT site scope), same pattern as the
@@ -6881,6 +6928,33 @@ async function handleTool(name, args) {
         : `Failed to save schedule for "${args.reportType}".`;
     }
 
+    case 'report_subscriptions_list': {
+      const rows = await messagingGet('/report-subscriptions');
+      if (!Array.isArray(rows) || !rows.length) return 'No report subscriptions.';
+      return rows.map(x =>
+        `#${x.id} ${x.reportType}: ${x.isActive ? 'active' : 'paused'}, ${x.frequency}, ${x.deliveryHour == null ? 'any hour' : String(x.deliveryHour).padStart(2, '0') + ':00'}, ${x.format ?? 'pdf'}${x.extraRecipients ? ' | also to ' + x.extraRecipients : ''}`
+      ).join('\n');
+    }
+
+    case 'report_subscription_update': {
+      if (!Number.isInteger(args.id)) return 'Error: id is required.';
+      const body = {};
+      for (const k of ['frequency', 'format', 'extraRecipients', 'isActive', 'clearDeliveryHour']) if (args[k] !== undefined) body[k] = args[k];
+      if (args.deliveryHour !== undefined) {
+        if (!Number.isInteger(args.deliveryHour) || args.deliveryHour < 0 || args.deliveryHour > 23) return 'Error: deliveryHour must be an integer 0-23.';
+        body.deliveryHour = args.deliveryHour;
+      }
+      if (!Object.keys(body).length) return 'Error: pass at least one field to update.';
+      await messagingRequest('PUT', `/report-subscriptions/${args.id}`, body);
+      return `Subscription #${args.id} updated.`;
+    }
+
+    case 'report_subscription_delete': {
+      if (!Number.isInteger(args.id)) return 'Error: id is required.';
+      await messagingRequest('DELETE', `/report-subscriptions/${args.id}`);
+      return `Subscription #${args.id} deleted.`;
+    }
+
     case 'report_export_status': {
       if (!args.exportId) return 'Error: exportId is required.';
       const s = await api('GET', `/Reports/ExportStatus/${args.exportId}`);
@@ -7855,6 +7929,12 @@ async function handleTool(name, args) {
       return lines.join('\n');
     }
 
+    case 'report_backfill': {
+      const qs = new URLSearchParams({ from: String(args.from), to: String(args.to), apply: String(args.apply === true) });
+      const r = await messagingPost(`/Reports/backfill/${encodeURIComponent(args.type)}?${qs}`);
+      return (args.apply === true ? 'Backfill APPLIED\n' : 'Backfill PREVIEW (nothing written; pass apply=true to write)\n') + JSON.stringify(r, null, 2);
+    }
+
     case 'support_schedule_adherence': {
       if (args.role === 'agent' && !args.agentId) throw new Error('agentId is required when role=agent');
       const qs = new URLSearchParams({ detail: 'true' });
@@ -9313,6 +9393,11 @@ async function handleTool(name, args) {
       return await messagingGet('/Focus/DraftPregeneration/Report');
 
     // -- Focus Inbox AI triage rules (#582 Phase B) --
+    case 'focus_get_triage_economy_report': {
+      const d = args.days !== undefined ? Number(args.days) : 30;
+      if (!Number.isFinite(d) || d < 1) throw new Error('days must be a positive number.');
+      return await messagingGet('/Focus/Triage/EconomyReport?days=' + Math.floor(d));
+    }
     case 'focus_get_triage_rules':
       return await messagingGet('/Focus/triage-rules');
     case 'focus_update_triage_rules': {