@velaro/mcp-server 0.6.61 → 0.6.63

package/package.json

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

@@ -1451,6 +1451,24 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
   },
 
   // ── Livefluence Migration ─────────────────────────────────────────────────
+  {
+    name: 'livefluence_seed_url_rules',
+    description: 'Velaro staff only. Seed v20 use-ai routing rules on a target site from v10 URL rules. Each rule matches "url contains <path>" with scheme/host stripped (path-only), so a demo page path triggers the same rule as the customer real URL. Idempotent. Domain-only URLs are skipped. Use dry_run=true first.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        site_id:      { type: 'number', description: 'V20 destination site ID' },
+        ai_config_id: { type: 'number', description: 'AI config on that site that receives routed chats' },
+        dry_run:      { type: 'boolean', description: 'Preview without writing' },
+        rules: {
+          type: 'array',
+          description: 'Rules in priority order',
+          items: { type: 'object', properties: { name: { type: 'string' }, priority: { type: 'number' }, paths: { type: 'array', items: { type: 'string' } } }, required: ['name', 'priority', 'paths'] },
+        },
+      },
+      required: ['site_id', 'ai_config_id', 'rules'],
+    },
+  },
   {
     name: 'livefluence_migrate',
     description: 'Migrate a Livefluence (V10) customer to Velaro V20. Reads REAL routing rules from the V10 config database and creates V20 canvas workflows (conversation_opened trigger + transferToAI or routeToTeam action nodes). Auto-matches V10 groups to V20 teams/AI configs by name. Use dry_run=true to preview first. All workflows created DISABLED — review conditions in the canvas then enable. Note: V10 expression conditions are NOT auto-converted; add them manually after migration.',
@@ -2535,6 +2553,18 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: ['siteId'],
     },
   },
+  {
+    name: 'experience_impact_report',
+    description: 'Experience Impact report: shows how staffing and schedule adherence affect customer experience. Returns a 0-100 experience index (adherence 25, service level 30, missed-chat rate 20, CSAT 25), per-interval staffing vs chat demand (scheduled vs actual agents, missed chats, wait time, CSAT), per-agent rows, and plain-language insights. Scoped to the caller site.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        from:   { type: 'string', description: 'yyyy-MM-dd start (default: 7 days ago).' },
+        to:     { type: 'string', description: 'yyyy-MM-dd end (default: today).' },
+        teamId: { type: 'number', description: 'Optional team ID to narrow the report.' },
+      },
+    },
+  },
   // -- 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).
@@ -5784,6 +5814,13 @@ async function handleTool(name, args) {
       return lines.join('\n');
     }
 
+    case 'livefluence_seed_url_rules': {
+      const result = await api('POST', '/DatabaseTool/V10SeedUrlRules', {
+        siteId: args.site_id, aiConfigId: args.ai_config_id, dryRun: !!args.dry_run, rules: args.rules,
+      });
+      return JSON.stringify(result, null, 2);
+    }
+
     case 'livefluence_migrate': {
       const result = await api('POST', '/DatabaseTool/V10Migrate', {
         v10SiteId:        args.v10_site_id,
@@ -7205,6 +7242,22 @@ async function handleTool(name, args) {
       ).join('\n');
     }
 
+    case 'experience_impact_report': {
+      const qs = new URLSearchParams();
+      for (const k of ['from', 'to', 'teamId']) if (args[k] != null && args[k] !== '') qs.set(k, String(args[k]));
+      const r = await messagingGet(`/Reports/experience-impact${qs.toString() ? '?' + qs : ''}`);
+      const sm = r.summary ?? {};
+      const lines = [
+        `=== Experience Impact ${r.range?.from ?? ''}..${r.range?.to ?? ''} ===`,
+        `Experience index: ${sm.experienceIndex ?? '-'} / 100`,
+        `Adherence ${sm.adherencePct ?? '-'}% | Service level ${sm.serviceLevelPct ?? '-'}% | Missed chats ${sm.missedChats ?? '-'} | Avg wait ${sm.avgWaitSec ?? '-'}s | CSAT ${sm.csatAvg ?? '-'} (${sm.csatResponses ?? 0} responses)`,
+        ...(r.insights ?? []).map(i => `  [${i.severity}] ${i.text}`),
+        `Intervals: ${(r.intervals ?? []).length} | Agents: ${(r.agents ?? []).length}`,
+      ];
+      for (const a of r.agents ?? []) lines.push(`  ${a.name}: index ${a.experienceIndex} | adherence ${a.adherencePct}% | CSAT ${a.csatAvg ?? '-'} | handled ${a.handled}`);
+      return lines.join('\n');
+    }
+
     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' });