@velaro/mcp-server 1.0.1 → 1.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velaro/mcp-server",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "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

@@ -882,6 +882,16 @@ const TOOLS = [
     },
   },
 
+  {
+    name: 'skill_usage_site',
+    description: 'Velaro staff only. Per-customer skill and integration usage for the month in one call: the billable counters (AI tool calls, MCP calls, API calls, workflow integration actions, workflow AI calls, bot turns) against the plan limits (same numbers as the customer Billing page), the effective usage-gate rollout mode per metric (Off/Observe/Enforce), calls by surface (MCP gateway, bot, workflow, REST business action, staff, copilot), and LLM cost split platform vs BYOK. BYOK removes LLM cost only; skill usage is counted and capped the same way. Lives in velaro-messaging - requires VELARO_MESSAGING_API.',
+    inputSchema: {
+      type: 'object',
+      properties: { siteId: { type: 'number', description: 'Target site ID (need not be your own)' } },
+      required: ['siteId'],
+    },
+  },
+
   {
     name: 'scraper_verify_token',
     description: "Show the calling site's web-scraper verification header (name + value), the scraper IP, and ready-to-send instructions for allowlisting Velaro's crawler with the customer's web host/WAF. Wraps GET ScraperJobs/VerifyToken. Site comes from auth context, never a parameter.",
@@ -1100,6 +1110,18 @@ const TOOLS = [
     },
   },
 
+  {
+    name: 'csat_override_unapprove_candidate',
+    description: 'Undo an approved Chat Intelligence improvement candidate: returns it to Pending, deactivates the promoted knowledge override and removes any vectorized copy. Requires site manager. Site comes from the key, never an argument.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        candidateId: { type: 'number', description: 'Id of the Approved override candidate' },
+      },
+      required: ['candidateId'],
+    },
+  },
+
   // ── Conversations ─────────────────────────────────────────────────────────
   {
     name: 'conversation_list',
@@ -2617,6 +2639,42 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: ['siteId', 'indexName'],
     },
   },
+  {
+    name: 'knowledge_clinical_text_get',
+    description: 'Read the Emergency and Safety Messages for a site: per-channel and per-language emergency/referral overrides (keys like chat, es, es.voice), the effective English wording, supportedLanguages, limits, and the read-only emergencyServiceMode. Customer: own site. Velaro staff: pass siteId. Wraps GET KnowledgeSetup/state (clinicalText).',
+    inputSchema: {
+      type: 'object',
+      properties: { siteId: { type: 'number', description: 'Velaro staff only: target site ID. Omit for your own site.' } },
+    },
+  },
+  {
+    name: 'knowledge_clinical_text_set',
+    description: 'Set the Emergency and Safety Messages. The server replaces the stored override set, so pass every override to keep (read first with knowledge_clinical_text_get). Keys: default, chat, voice, sms, whatsapp, email, a language code (es fr de pt it nl zh ja ko vi ru ar hi pl) or language.channel (es.voice). Each text 20-600 chars; emergency text must contain {emergencyNumber}; "hang up" only in voice wording. null value clears an entry. Wraps PUT KnowledgeSetup/clinical-text.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        siteId:          { type: 'number', description: 'Velaro staff only: target site ID. Omit for your own site.' },
+        emergency:       { type: 'object', description: 'Map of key to emergency wording', additionalProperties: { type: ['string', 'null'] } },
+        referral:        { type: 'object', description: 'Map of key to referral wording', additionalProperties: { type: ['string', 'null'] } },
+        emergencyNumber: { type: 'string', description: 'Replaces {emergencyNumber}; omit for the default' },
+        resetToDefault:  { type: 'boolean', description: 'Clear all custom wording' },
+      },
+    },
+  },
+  {
+    name: 'knowledge_emergency_service_mode_set',
+    description: 'Velaro staff only. Turn emergency-service mode on/off for a site that IS the emergency line: its own required text replaces the built-in emergency instruction (never the referral). Turning on needs confirm=true and text of 20-600 chars. Wraps PUT KnowledgeSetup/Staff/{siteId}/clinical-text (emergencyServiceMode); existing wording is left untouched.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        siteId:  { type: 'number', description: 'Target site ID' },
+        enabled: { type: 'boolean' },
+        text:    { type: 'string', description: 'Required emergency text (20-600 chars)' },
+        confirm: { type: 'boolean', description: 'Must be true to turn the mode on' },
+      },
+      required: ['siteId'],
+    },
+  },
   {
     name: 'index_set_profile',
     description: 'Velaro staff only. Set the ingestion profile of ONE named index on ANY site (chunk strategy, chunk size/overlap, purpose, search size, excludeFromAllSources). Apply-if-present: only fields you pass change. Changing the profile versions the content hash so the next ingest re-chunks. Wraps PUT KnowledgeSetup/Staff/{siteId}/index-profile (velaro-messaging).',
@@ -3288,6 +3346,50 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: ['id'],
     },
   },
+  // ── Visitor Monitor (session-scoped: SiteId comes from the caller's JWT, never an arg) ──
+  {
+    name: 'visitor_monitor_active',
+    description: 'List live visitors on this site (Visitor Monitor). Returns sessions (with region/city/ipTruncated when Store Location Detail is on), activeWindowMinutes, locationDetailEnabled, visitor limit and counts.',
+    inputSchema: { type: 'object', properties: {}, required: [] },
+  },
+  {
+    name: 'visitor_monitor_preferences_get',
+    description: 'Get the calling user\'s saved Visitor Monitor view (columns, groupBy, sortBy, sortDir, regionGrouping). Per user, follows them across browsers.',
+    inputSchema: { type: 'object', properties: {}, required: [] },
+  },
+  {
+    name: 'visitor_monitor_preferences_set',
+    description: 'Save the calling user\'s Visitor Monitor view. Replaces the saved view: send the full set of fields you want kept.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        columns:        { type: 'array', items: { type: 'string' }, description: 'Ordered column keys, e.g. ["visitor","status","region","city"]' },
+        groupBy:        { type: 'string', description: 'Group the list by this key (e.g. "region", "city", "none")' },
+        sortBy:         { type: 'string', description: 'Sort key, e.g. "lastSeen"' },
+        sortDir:        { type: 'string', enum: ['asc', 'desc'], description: 'Sort direction' },
+        regionGrouping: { type: 'string', description: 'Region grouping granularity: "region" or "city"' },
+      },
+      required: [],
+    },
+  },
+  {
+    name: 'visitor_monitor_settings_get',
+    description: 'Get this site\'s Visitor Monitor settings: storeLocationDetail and activeWindowMinutes (how long a visitor stays listed after leaving; default 30).',
+    inputSchema: { type: 'object', properties: {}, required: [] },
+  },
+  {
+    name: 'visitor_monitor_settings_set',
+    description: 'Update this site\'s Visitor Monitor settings (partial update). activeWindowMinutes must be 5-240; above 30 and storeLocationDetail need the Visitor Insights Advanced plan flag, otherwise the API returns 403 feature_not_in_plan.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        storeLocationDetail: { type: 'boolean', description: 'Store visitor region/city and a truncated IP on new sessions (Advanced plan)' },
+        activeWindowMinutes: { type: 'number', description: 'Minutes a visitor stays in the monitor after last activity (5-240; above 30 needs Advanced)' },
+      },
+      required: [],
+    },
+  },
+
   // ── Page Widget Containers ────────────────────────────────────────────────
   {
     name: 'widget_container_list',
@@ -4892,7 +4994,7 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
   },
   {
     name: 'teams_phone_test_config',
-    description: 'Test the Teams Phone connection by creating (or renewing) the Graph /communications/calls subscription — the real connectivity check. Surfaces the actual Graph error if the customer tenant hasn\'t admin-consented Calls.AccessMedia.All + Calls.Initiate.All, or the resource account isn\'t provisioned, rather than only being discovered when a call is missed. Lives in velaro-messaging — requires VELARO_MESSAGING_API.',
+    description: 'Run the Teams Phone readiness checks and return each check (name, ok, message) plus callingReady. Surfaces what is missing (admin consent, resource account, Graph reachability) rather than only being discovered when a call is missed. Lives in velaro-messaging — requires VELARO_MESSAGING_API.',
     inputSchema: { type: 'object', properties: {}, required: [] },
   },
 
@@ -7050,6 +7152,11 @@ async function handleTool(name, args) {
       return JSON.stringify(result, null, 2);
     }
 
+    case 'skill_usage_site': {
+      const usage = await messagingGet(`/SupportTools/sites/${args.siteId}/skill-usage`);
+      return JSON.stringify(usage, null, 2);
+    }
+
     case 'apple_health': {
       const h = await messagingGet(`/SupportTools/sites/${args.siteId}/apple/health`);
       return JSON.stringify(h, null, 2);
@@ -7159,6 +7266,12 @@ async function handleTool(name, args) {
         { dismissed: args.dismissed !== false }
       );
 
+    case 'csat_override_unapprove_candidate': {
+      const cid = Number(args.candidateId);
+      if (!Number.isInteger(cid) || cid <= 0) throw new Error('candidateId must be a positive integer');
+      return await messagingPost(`/api/intelligence/csat-override-candidates/${cid}/unapprove`, {});
+    }
+
     // ── Conversations ──────────────────────────────────────────────────────
     case 'conversation_list':
       return await rpc('conversation_list', args);
@@ -8727,6 +8840,34 @@ reply: ${r?.reply}`;
       return `Index ready on site ${args.siteId}: ${idx?.name} (id=${idx?.id}, purpose=${idx?.purpose}, excludeFromAllSources=${!!idx?.excludeFromAllSources}).`;
     }
 
+    case 'knowledge_clinical_text_get': {
+      const base = args.siteId ? `/KnowledgeSetup/Staff/${encodeURIComponent(args.siteId)}` : '/KnowledgeSetup';
+      const st = await messagingRequest('GET', `${base}/state`);
+      return JSON.stringify(st?.clinicalText ?? { error: 'state did not include clinicalText' }, null, 2);
+    }
+
+    case 'knowledge_clinical_text_set': {
+      const base = args.siteId ? `/KnowledgeSetup/Staff/${encodeURIComponent(args.siteId)}` : '/KnowledgeSetup';
+      const body = args.resetToDefault ? { resetToDefault: true } : {};
+      if (!args.resetToDefault) {
+        if (args.emergency !== undefined) body.emergency = args.emergency;
+        if (args.referral !== undefined) body.referral = args.referral;
+        if (args.emergencyNumber !== undefined) body.emergencyNumber = args.emergencyNumber;
+      }
+      const r = await messagingRequest('PUT', `${base}/clinical-text`, body);
+      return JSON.stringify(r, null, 2);
+    }
+
+    case 'knowledge_emergency_service_mode_set': {
+      if (!args.siteId) return 'siteId is required.';
+      const mode = {};
+      if (args.enabled !== undefined) mode.enabled = args.enabled;
+      if (args.text !== undefined) mode.text = args.text;
+      if (args.confirm) mode.confirm = true;
+      const r = await messagingRequest('PUT', `/KnowledgeSetup/Staff/${encodeURIComponent(args.siteId)}/clinical-text`, { emergencyServiceMode: mode });
+      return JSON.stringify(r, null, 2);
+    }
+
     case 'index_set_profile': {
       if (!args.siteId || !args.indexName) return 'siteId and indexName are required.';
       const body = { indexName: args.indexName };
@@ -9619,6 +9760,25 @@ reply: ${r?.reply}`;
       return `Widget ${args.id} ${args.isEnabled ? 'enabled' : 'disabled'}.`;
     }
 
+    // ── Visitor Monitor ───────────────────────────────────────────────────
+    case 'visitor_monitor_active':
+      return JSON.stringify(await messagingGet('/Visitor/active'), null, 2);
+    case 'visitor_monitor_preferences_get':
+      return JSON.stringify(await messagingGet('/Visitor/preferences'), null, 2);
+    case 'visitor_monitor_preferences_set': {
+      const body = {};
+      for (const k of ['columns', 'groupBy', 'sortBy', 'sortDir', 'regionGrouping']) if (args[k] !== undefined) body[k] = args[k];
+      return JSON.stringify(await messagingPut('/Visitor/preferences', body), null, 2);
+    }
+    case 'visitor_monitor_settings_get':
+      return JSON.stringify(await messagingGet('/Visitor/settings'), null, 2);
+    case 'visitor_monitor_settings_set': {
+      const body = {};
+      if (args.storeLocationDetail !== undefined) body.storeLocationDetail = args.storeLocationDetail;
+      if (args.activeWindowMinutes !== undefined) body.activeWindowMinutes = args.activeWindowMinutes;
+      return JSON.stringify(await messagingPut('/Visitor/settings', body), null, 2);
+    }
+
     // ── Page Widget Containers ────────────────────────────────────────────────
     case 'widget_container_list': {
       const data = await api('GET', '/PageWidgetContainers');
@@ -10989,7 +11149,12 @@ reply: ${r?.reply}`;
     }
     case 'teams_phone_test_config': {
       const result = await messagingPost('/TeamsPhone/Config/Test', {});
-      return `${result.success ? 'Success' : 'Failed'}: ${result.message ?? '(no message)'}`;
+      const lines = [`${result.success ? 'Success' : 'Failed'}: ${result.message ?? '(no message)'}`];
+      if (typeof result.callingReady === 'boolean') lines.push(`Inbound calling ready: ${result.callingReady}`);
+      if (Array.isArray(result.checks)) {
+        for (const ck of result.checks) lines.push(`${ck?.ok ? 'PASS' : 'FAIL'} ${ck?.name ?? ''}${ck?.message ? ': ' + ck.message : ''}`);
+      }
+      return lines.join(String.fromCharCode(10));
     }
 
     // ── Shopify write policy (velaro-messaging /api/Shopify/WritePolicy) ───────