@velaro/mcp-server 0.6.63 → 0.6.65

package/package.json

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

@@ -2555,13 +2555,14 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
   },
   {
     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.',
+    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, a bot-vs-human breakdown (bot only, bot-to-human handoff, human only, with wait, missed, CSAT and bot containment rate), 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.' },
+        includeDemo: { type: 'boolean', description: 'true = show only the seeded sample (demo) data instead of real conversations. Default false. The response demoAvailable flag says whether sample data exists for the range.' },
       },
     },
   },
@@ -7245,6 +7246,7 @@ async function handleTool(name, args) {
     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]));
+      if (args.includeDemo === true) qs.set('includeDemo', 'true');
       const r = await messagingGet(`/Reports/experience-impact${qs.toString() ? '?' + qs : ''}`);
       const sm = r.summary ?? {};
       const lines = [
@@ -7252,8 +7254,17 @@ async function handleTool(name, args) {
         `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}`),
+        ...(r.demoAvailable ? ['Sample (demo) data is available for this range; pass includeDemo=true to view it.'] : []),
         `Intervals: ${(r.intervals ?? []).length} | Agents: ${(r.agents ?? []).length}`,
       ];
+      if (r.botVsHuman) {
+        const bh = r.botVsHuman;
+        lines.push(`Bots vs humans (bot containment ${bh.containmentRatePct}%)`);
+        for (const [label, k] of [['Bot only', 'botOnly'], ['Bot to human', 'handoff'], ['Human only', 'humanOnly']]) {
+          const x = bh[k] ?? {};
+          lines.push(`  ${label}: ${x.chats} chats | avg wait ${x.avgWaitSec}s | missed ${x.missed} | CSAT ${x.csatResponses ? x.csatAvg : '-'} (${x.csatResponses ?? 0})`);
+        }
+      }
       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');
     }