@velaro/mcp-server 0.6.90 → 0.6.91

package/package.json

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

@@ -822,6 +822,41 @@ const TOOLS = [
       },
     },
   },
+  {
+    name: 'canned_learning_suggestions',
+    description: 'List AI-proposed canned message improvements awaiting human review (learned from low ratings and never-used messages). Each row shows currentText, proposedText, the reason, the signals it learned from, and a review state (pending_review, approved, rejected, rolled_back). Intelligence Suite entitlement required.',
+    inputSchema: { type: 'object', properties: { state: { type: 'string', description: 'pending_review (default), approved, rejected, rolled_back, or all' } } },
+  },
+  {
+    name: 'canned_learning_generate',
+    description: 'Analyze this site canned message usage and ratings and queue AI-proposed improvements for human review. Nothing changes until approved. Capped at 5 messages per run and one run per day; text is PII-redacted before it reaches the model.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'canned_learning_approve',
+    description: 'Approve a suggestion: replaces the live canned message with the proposed text (or editedText if given). The original is snapshotted so canned_learning_rollback can restore it.',
+    inputSchema: { type: 'object', properties: { suggestionId: { type: 'number' }, editedText: { type: 'string', description: 'Optional human-edited replacement' } }, required: ['suggestionId'] },
+  },
+  {
+    name: 'canned_learning_reject',
+    description: 'Reject a pending canned message suggestion. The live message is untouched.',
+    inputSchema: { type: 'object', properties: { suggestionId: { type: 'number' } }, required: ['suggestionId'] },
+  },
+  {
+    name: 'canned_learning_edit_summary',
+    description: 'Which canned messages agents edit most before sending (last 90 days): canned response id, shortcut, edit count and average similarity of the sent text to the original. This is the edited-before-send evidence the weekly canned message learning job uses. Intelligence Suite entitlement required.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'canned_learning_record_edit',
+    description: 'Record that an agent edited a canned response before sending. The sent text is PII-redacted and length-capped server-side; the site comes from the session. Rows are capped per site and expire after 90 days.',
+    inputSchema: { type: 'object', properties: { cannedResponseId: { type: 'number' }, finalText: { type: 'string', description: 'The text the agent actually sent' } }, required: ['cannedResponseId', 'finalText'] },
+  },
+  {
+    name: 'canned_learning_rollback',
+    description: 'Roll back an approved suggestion, restoring the original canned message text.',
+    inputSchema: { type: 'object', properties: { suggestionId: { type: 'number' }, notes: { type: 'string' } }, required: ['suggestionId'] },
+  },
   {
     name: 'chat_intelligence_recommendations',
     description: 'List the active (non-dismissed) AI-generated improvement recommendations for this site — widget availability, bot gaps, missed-chat patterns, content-gap drafts. Each row includes id, type, priority, title, body, supportingDataBlob, plus lifecycle fields (appliedAt, appliedArtifactRef, rolledBackAt).',
@@ -2976,6 +3011,26 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       },
     },
   },
+  {
+    name: 'enterprise_reports',
+    description: 'Enterprise Reports package (enterprise-internal, default OFF; every report returns 403 when the site does not hold that package item). report: program_breakdown (compare websites, teams, platforms, devices or entry pages: volume, missed, transfers, wait, first reply, QA score and coverage, sentiment), agent_scorecard (per agent by name: resolution, transfers, handle time, AI score, supervisor-reviewed score, sentiment impact), qa_coverage (share of resolved chats AI-scored and supervisor-reviewed by week and program), coaching_queue (low-scoring chats nobody reviewed, per agent), sentiment_breakdown (by website, team, agent or topic with change vs prior period), topic_radar (topics by volume, growth, transfer rate), weekly_brief (preview of the Monday brief sections), weekly_brief_send_test (emails this week\'s brief to the signed-in user). Scoped to the caller site.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        report:       { type: 'string', enum: ['program_breakdown', 'agent_scorecard', 'qa_coverage', 'coaching_queue', 'sentiment_breakdown', 'topic_radar', 'weekly_brief', 'weekly_brief_send_test'] },
+        from:         { type: 'string', description: 'yyyy-MM-dd start (default: 30 days ago).' },
+        to:           { type: 'string', description: 'yyyy-MM-dd end, inclusive (default: today).' },
+        groupBy:      { type: 'string', description: 'program_breakdown: website|team|platform|device|entrypage. sentiment_breakdown: website|team|agent|theme.' },
+        deploymentId: { type: 'number', description: 'Optional website (deployment) ID.' },
+        teamId:       { type: 'number', description: 'Optional team ID.' },
+        threshold:    { type: 'number', description: 'coaching_queue: queue chats scored below this (1-100; default = the rubric low-score threshold or 60).' },
+        perAgent:     { type: 'number', description: 'coaching_queue: chats listed per agent (default 5).' },
+        limit:        { type: 'number', description: 'topic_radar: max topics (default 25).' },
+        days:         { type: 'number', description: 'weekly_brief: days to cover (default 7).' },
+      },
+      required: ['report'],
+    },
+  },
   {
     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.',
@@ -3156,6 +3211,9 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
         voiceId:      { type: 'string',  description: 'ElevenLabs voice ID override. Omit to use the site default.' },
         showCallMeOption: { type: 'boolean', description: 'Show the "Call me instead" option (requires EnableClickToCall).' },
         callbackConfirmWindowMinutes: { type: 'number', description: 'Minutes to confirm a callback request before it expires. Default 10.' },
+        displayName: { type: 'string', description: 'Visitor-facing avatar name shown on the badge (e.g. "Moshky"). Empty string resets to "AI".' },
+        showBadge: { type: 'boolean', description: 'Show the name badge over the avatar video. Default true.' },
+        sizePx: { type: 'number', description: 'Max avatar panel width in px (160-640, square). Default 360.' },
         maxAvatarMinutesPerMonth: { type: 'number', description: 'Monthly avatar video minutes cap for the site. Whole number 1-100000; never unlimited (0/negative rejected).' },
         maxAvatarTtsChars: { type: 'number', description: 'Monthly avatar TTS character cap (avatar_tts_chars) for the site. Whole number 1-100000000; never unlimited (0/negative rejected). Overage pricing is a platform-wide ladder, not per site.' },
       },
@@ -3371,7 +3429,7 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
   },
   {
     name: 'email_inbox_get_status',
-    description: 'Check global Gmail OAuth/Domain-Wide-Delegation/Pub-Sub configuration presence (gmail only — these are global App Settings, not per-site). For per-mailbox connection state (either provider) use email_inbox_list_mailboxes instead. Velaro staff only.',
+    description: 'Check global Gmail OAuth/Domain-Wide-Delegation/Pub-Sub configuration presence AND prove the OAuth client id/secret are a matching pair (credentialPair) plus duplicate App Setting spellings (Gmail:X vs Gmail__X) (gmail only — these are global App Settings, not per-site). For per-mailbox connection state (either provider) use email_inbox_list_mailboxes instead. Velaro staff only.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -3380,6 +3438,33 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: ['siteId'],
     },
   },
+  {
+    name: 'email_inbox_resubscribe_outlook',
+    description: 'Recreate the Microsoft Graph inbound-mail subscription for a connected Outlook mailbox. A mailbox with graphSubscriptionId null (see email_inbox_list_mailboxes) shows "connected" but never receives email - this repairs it immediately. Velaro staff only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        siteId:    { type: 'number', description: 'Site ID' },
+        mailboxId: { type: 'number', description: 'Outlook mailbox integration ID from email_inbox_list_mailboxes' },
+      },
+      required: ['siteId', 'mailboxId'],
+    },
+  },
+  {
+    name: 'site_integration_logs',
+    description: "Read ANY site's integration Activity Log (same rows as the admin Activity Log tab), optionally filtered by integration slug (e.g. OutlookInbox, GmailInbox, NetSuite), severity and message search. Use this first when diagnosing a customer/test-site integration. Velaro staff only.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        siteId:   { type: 'number', description: 'Site ID' },
+        slug:     { type: 'string', description: 'Integration slug, e.g. OutlookInbox' },
+        severity: { type: 'string', enum: ['Info', 'Warning', 'Error'], description: 'Optional severity filter' },
+        search:   { type: 'string', description: 'Optional substring match on message / additional info' },
+        take:     { type: 'number', description: 'Max rows (default 50, max 200)' },
+      },
+      required: ['siteId'],
+    },
+  },
   {
     name: 'email_inbox_set_team',
     description: 'Reassign the team a connected Gmail/Outlook mailbox routes inbound mail to, or clear it back to the site default/catch-all (teamId: 0). Velaro staff only.',
@@ -4396,6 +4481,11 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
     description: 'List all registered EntitlementFeature keys with their display names and categories. Useful for finding the right featureKey before setting overrides. Superadmin only.',
     inputSchema: { type: 'object', properties: {} },
   },
+  {
+    name: 'entitlement_enterprise_reports_package',
+    description: 'Show the Enterprise Reports package (enterprise-internal, default OFF): every item with its feature key, what it builds on, and, when siteId is given, whether it is ON for that site. Superadmin only.',
+    inputSchema: { type: 'object', properties: { siteId: { type: 'number', description: 'Optional site ID to show which items are on' } } },
+  },
   {
     name: 'entitlement_set_override',
     description: 'Set a per-site feature override — enable or disable a specific feature for one site, independent of their plan. Superadmin only. Use entitlement_list_features to find valid featureKey values.',
@@ -5725,6 +5815,20 @@ async function handleTool(name, args) {
       if (args.teamId != null) qs.set('teamId', String(args.teamId));
       return await messagingGet(`/Reports/chat-intelligence/themes?${qs.toString()}`);
     }
+    case 'canned_learning_suggestions':
+      return await messagingGet(`/CannedLearning/suggestions?state=${encodeURIComponent(args.state ?? 'pending_review')}`);
+    case 'canned_learning_generate':
+      return await messagingPost('/CannedLearning/generate', {});
+    case 'canned_learning_approve':
+      return await messagingPost(`/CannedLearning/suggestions/${args.suggestionId}/approve`, { editedText: args.editedText ?? null });
+    case 'canned_learning_reject':
+      return await messagingPost(`/CannedLearning/suggestions/${args.suggestionId}/reject`, {});
+    case 'canned_learning_edit_summary':
+      return await messagingGet('/CannedLearning/edit-events');
+    case 'canned_learning_record_edit':
+      return await messagingPost('/CannedLearning/edit-events', { cannedResponseId: args.cannedResponseId, finalText: args.finalText });
+    case 'canned_learning_rollback':
+      return await messagingPost(`/CannedLearning/suggestions/${args.suggestionId}/rollback`, { notes: args.notes ?? null });
     case 'chat_intelligence_recommendations':
       return await messagingGet(`/Reports/chat-intelligence/recommendations`);
     case 'chat_intelligence_draft_article':
@@ -8266,6 +8370,23 @@ async function handleTool(name, args) {
       return `Subscribed to ${args.reportType} (${args.frequency ?? 'weekly'}, ${args.deliveryHour ?? 7}:00 site time).`;
     }
 
+    case 'enterprise_reports': {
+      const ER_PATHS = {
+        program_breakdown: 'program-breakdown', agent_scorecard: 'agent-scorecard', qa_coverage: 'qa-coverage',
+        coaching_queue: 'coaching-queue', sentiment_breakdown: 'sentiment-breakdown', topic_radar: 'topic-radar',
+        weekly_brief: 'weekly-brief', weekly_brief_send_test: 'weekly-brief/send-test',
+      };
+      const seg = ER_PATHS[args.report];
+      if (!seg) throw new Error('report must be one of: ' + Object.keys(ER_PATHS).join(', '));
+      if (args.report === 'weekly_brief_send_test') return JSON.stringify(await messagingPost('/api/enterprise-reports/' + seg, {}), null, 2);
+      const qs = new URLSearchParams();
+      for (const k of ['from', 'to', 'groupBy', 'deploymentId', 'teamId', 'threshold', 'perAgent', 'limit', 'days']) {
+        if (args[k] != null && args[k] !== '') qs.set(k, String(args[k]));
+      }
+      const q = qs.toString();
+      return JSON.stringify(await messagingGet('/api/enterprise-reports/' + seg + (q ? '?' + q : '')), null, 2);
+    }
+
     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]));
@@ -8394,6 +8515,9 @@ async function handleTool(name, args) {
         `  Enabled:         ${data.enabled}`,
         `  "Call me":       ${data.showCallMeOption}`,
         `  Callback window: ${data.callbackConfirmWindowMinutes} min`,
+        `  Display name:    ${data.displayName || '(AI)'}`,
+        `  Badge shown:     ${data.showBadge}`,
+        `  Size:            ${data.sizePx}px`,
       ].join('\n');
     }
 
@@ -8405,6 +8529,9 @@ async function handleTool(name, args) {
       if (args.enabled !== undefined) body.enabled = args.enabled;
       if (args.showCallMeOption !== undefined) body.showCallMeOption = args.showCallMeOption;
       if (args.callbackConfirmWindowMinutes !== undefined) body.callbackConfirmWindowMinutes = args.callbackConfirmWindowMinutes;
+      if (args.displayName !== undefined) body.displayName = args.displayName;
+      if (args.showBadge !== undefined) body.showBadge = args.showBadge;
+      if (args.sizePx !== undefined) body.sizePx = args.sizePx;
       for (const [arg, max] of [['maxAvatarMinutesPerMonth', 100000], ['maxAvatarTtsChars', 100000000]]) {
         if (args[arg] === undefined) continue;
         if (!Number.isInteger(args[arg]) || args[arg] < 1 || args[arg] > max) throw new Error(`${arg} must be a whole number between 1 and ${max} (never unlimited).`);
@@ -8524,6 +8651,23 @@ async function handleTool(name, args) {
       return JSON.stringify(data, null, 2);
     }
 
+    case 'email_inbox_resubscribe_outlook': {
+      if (!args.siteId || !args.mailboxId) return 'siteId and mailboxId are required.';
+      const data = await messagingPost(`/SupportTools/sites/${args.siteId}/email-inbox/outlook/${args.mailboxId}/resubscribe`, {});
+      return JSON.stringify(data, null, 2);
+    }
+
+    case 'site_integration_logs': {
+      if (!args.siteId) return 'siteId is required.';
+      const q = new URLSearchParams();
+      if (args.slug) q.set('slug', args.slug);
+      if (args.severity) q.set('severity', args.severity);
+      if (args.search) q.set('search', args.search);
+      if (args.take) q.set('take', String(args.take));
+      const data = await messagingGet(`/SupportTools/sites/${args.siteId}/integration-logs?${q.toString()}`);
+      return JSON.stringify(data, null, 2);
+    }
+
     case 'email_inbox_set_team': {
       if (!args.siteId || !args.provider || !args.mailboxId || args.teamId == null) return 'siteId, provider, mailboxId, and teamId are required.';
       const data = await messagingPatch(`/SupportTools/sites/${args.siteId}/email-inbox/${args.provider}/${args.mailboxId}/team`, { teamId: args.teamId });
@@ -9678,6 +9822,18 @@ async function handleTool(name, args) {
       return lines.join('\n');
     }
 
+    case 'entitlement_enterprise_reports_package': {
+      const q = args && args.siteId ? `?siteId=${encodeURIComponent(args.siteId)}` : '';
+      const pkg = await api('GET', `/Entitlements/packages/enterprise-reports${q}`);
+      const lines = [`${pkg.displayName} (${pkg.packageKey}) - plan ${pkg.plan}, default OFF${pkg.siteId ? `, site ${pkg.siteId}` : ''}`, ''];
+      for (const it of pkg.items) {
+        lines.push(`${pkg.siteId ? (it.enabled ? '[ON ] ' : '[off] ') : ''}${it.ask}. ${it.title}`);
+        lines.push(`     key: ${it.featureKey}; builds on: ${it.buildsOn.join(', ')}`);
+        lines.push(`     ${it.summary}`);
+      }
+      return lines.join(String.fromCharCode(10));
+    }
+
     case 'entitlement_list_features': {
       const features = await api('GET', '/Entitlements/features');
       const byCategory = {};