@velaro/mcp-server 0.6.100 → 0.6.102

package/package.json

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

@@ -842,6 +842,7 @@ const TOOLS = [
         groupBy:   { type: 'string', description: '"month" or "week" (default month)' },
         deploymentId: { type: 'number', description: 'Optional website (deployment row id) filter' },
         teamId:    { type: 'number', description: 'Optional team filter' },
+        includeSecondary: { type: 'boolean', description: 'Also return secondary topics per conversation (needs the site multi-topic setting on). Response becomes { report, secondary: [{ theme, conversations, avgConfidence }] }.' },
       },
     },
   },
@@ -895,6 +896,16 @@ const TOOLS = [
     description: 'Replace the active topic list (max 60 topics, 60 chars each, duplicates removed). Used for new classifications only; existing history is untouched. Optionally load a template first with industry.',
     inputSchema: { type: 'object', properties: { topics: { type: 'array', items: { type: 'string' } }, industry: { type: 'string', description: 'Load a template instead: insurance, healthcare, retail, ecommerce, financial, saas, government, manufacturing' } } },
   },
+  {
+    name: 'chat_topics_settings_get',
+    description: 'Chat Intelligence multi-topic site setting: { themeMultiTopicEnabled (default off), themeReEvalEveryNMessages (1-50, default 5) }. Customer-writable by site supervisors.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'chat_topics_settings_set',
+    description: 'Turn multi-topic tracking on or off for this site and/or set how many new visitor messages trigger a topic re-check (1-50). Partial and idempotent: omit a field to leave it unchanged. Supervisor only.',
+    inputSchema: { type: 'object', properties: { themeMultiTopicEnabled: { type: 'boolean' }, themeReEvalEveryNMessages: { type: 'number' } } },
+  },
   {
     name: 'chat_topics_edit',
     description: 'Merge, rename, retire or group topics. Applied when reports are read, so history follows the new names with zero AI cost. op = merge|rename|retire|group; from = topic names; to = target (merge/rename); group = group name (empty clears).',
@@ -1139,10 +1150,25 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
   },
   {
     name: 'survey_upsert',
-    description: 'Create (omit id or set id=0) or update (set id) a survey. body must be the full SurveyViewModel JSON shape (id, name, questions[], each question with type/text/options/required/variable/etc.). Use survey_get on an existing survey to fetch this full shape as a template rather than guessing the question schema from scratch.',
-    inputSchema: {
-      type: 'object',
-      properties: { body: { type: 'object', description: 'Full SurveyViewModel JSON' } },
+    description: 'Create (omit id or set id=0) or update (set id) a survey. body must be the full SurveyViewModel JSON shape (id, name, questions[], each question with type/text/options/required/variable/etc.). Use survey_get on an existing survey to fetch this full shape as a template rather than guessing the question schema from scratch. Each question also accepts isThemeAnchor (boolean, default false: this answer sets the Chat Intelligence topic) and themeMapping (string: JSON object mapping answer text to a site topic, e.g. "{\\"Pay my bill\\":\\"Billing Questions\\"}"). Both only take effect when the site has the multi-topic setting on.',
+    inputSchema: {
+      type: 'object',
+      properties: { body: {
+        type: 'object',
+        description: 'Full SurveyViewModel JSON',
+        properties: {
+          questions: {
+            type: 'array',
+            items: {
+              type: 'object',
+              properties: {
+                isThemeAnchor: { type: 'boolean', description: 'Use the answer to this question as the Chat Intelligence topic (default false)' },
+                themeMapping: { type: 'string', description: 'JSON object string mapping answer text to a site topic; invalid or empty is stored as null' },
+              },
+            },
+          },
+        },
+      } },
       required: ['body'],
     },
   },
@@ -1562,6 +1588,23 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
     },
   },
 
+  // ── Dynamics per-team overrides (effective = team override ?? connection default) ──
+  {
+    name: 'dynamics_team_overrides_get',
+    description: 'List per-team (group) Dynamics overrides of custom field mappings and activity type for a Dynamics config, plus the config\'s own "apply to all groups" defaults. Site is resolved server-side.',
+    inputSchema: { type: 'object', properties: { configId: { type: 'number' } }, required: ['configId'] },
+  },
+  {
+    name: 'dynamics_team_overrides_set',
+    description: 'Create/update one team\'s Dynamics override. Apply-if-present: omitted fields are unchanged; an empty string clears that field back to the default. Fields: activityLogicalName (e.g. phonecall, task), customFieldMappingsJson (JSON array string).',
+    inputSchema: { type: 'object', properties: { configId: { type: 'number' }, teamId: { type: 'number' }, activityLogicalName: { type: 'string' }, customFieldMappingsJson: { type: 'string' } }, required: ['configId', 'teamId'] },
+  },
+  {
+    name: 'dynamics_team_overrides_reset',
+    description: 'Reset a team to the Dynamics default (removes its override).',
+    inputSchema: { type: 'object', properties: { configId: { type: 'number' }, teamId: { type: 'number' } }, required: ['configId', 'teamId'] },
+  },
+
   // ── Teams ─────────────────────────────────────────────────────────────────
   {
     name: 'team_list',
@@ -1824,6 +1867,25 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: ['v10_site_id'],
     },
   },
+  {
+    name: 'livefluence_conversion_advisor',
+    description: 'Velaro staff only (superadmin). Livefluence conversion advisor: reads a v10 site\'s groups and routing rules, clusters them by intent and returns a consolidated v20 design (one workflow per intent; page-path + device + geo conditions; team availability check with AI-node fallback), diffed against what already exists on the v20 site. Or pass intents (a structured list built from a customer description) instead of v10_site_id. apply=false (default) is a dry run; apply=true creates missing teams and workflows, ALWAYS DISABLED, idempotent by name. Always dry-run first. Same as CLI `velaro migrate advise`.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        v10_site_id: { type: 'number', description: 'V10 (Livefluence) site to read. Omit when passing intents.' },
+        v20_site_id: { type: 'number', description: 'V20 destination site ID' },
+        apply: { type: 'boolean', description: 'Create missing teams and DISABLED workflows. Default false (dry run + diff).' },
+        include_non_routing: { type: 'boolean', description: 'Also read v10 rules with IsRouting=false (group-assignment rules). Default false.' },
+        intents: {
+          type: 'array',
+          description: 'Structured intents: [{intent, paths[], device: any|mobile|desktop, countries[], excludeCountries[], target: "Service team + troubleshooting AI node" (or team / aiNode), mode: humanFirst|botFirst|aiOnly, priority}]',
+          items: { type: 'object' },
+        },
+      },
+      required: ['v20_site_id'],
+    },
+  },
   {
     name: 'livefluence_export',
     description: 'Export V10 (Livefluence) routing rules for a site and show a preview of what would be created in V20. Auto-suggests V20 team and AI config matches by name. Use this before livefluence_migrate to confirm the mapping is correct.',
@@ -3474,6 +3536,18 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
     },
   },
 
+  // -- Image Analysis (analyze_image) limits (superadmin) --
+  {
+    name: 'image_analysis_limits',
+    description: 'Show a customer site Image Analysis (photo analysis) add-on limits: entitlement, monthly cap (MaxImageAnalysesPerMonth), usage this month, per-chat cap and extra-block size. Velaro admin only. To change the cap use support_set_limit with key MaxImageAnalysesPerMonth.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        siteId: { type: 'number', description: 'Site ID to check' },
+      },
+      required: ['siteId'],
+    },
+  },
   // ── AI Video Avatar management (superadmin) ────────────────────────────────
   {
     name: 'avatar_get_config',
@@ -6398,6 +6472,7 @@ async function handleTool(name, args) {
       qs.set('groupBy', args.groupBy ?? 'month');
       if (args.deploymentId != null) qs.set('deploymentId', String(args.deploymentId));
       if (args.teamId != null) qs.set('teamId', String(args.teamId));
+      if (args.includeSecondary === true) qs.set('includeSecondary', 'true');
       return await messagingGet(`/Reports/chat-intelligence/themes?${qs.toString()}`);
     }
     case 'chat_topics_get':
@@ -6406,6 +6481,13 @@ async function handleTool(name, args) {
       return args.industry
         ? await messagingPost('/ChatIntelligenceTopics/template', { industry: args.industry })
         : await messagingPut('/ChatIntelligenceTopics', { topics: args.topics ?? [] });
+    case 'chat_topics_settings_get':
+      return await messagingGet('/ChatIntelligenceTopics/settings');
+    case 'chat_topics_settings_set':
+      return await messagingPut('/ChatIntelligenceTopics/settings', {
+        themeMultiTopicEnabled: typeof args.themeMultiTopicEnabled === 'boolean' ? args.themeMultiTopicEnabled : null,
+        themeReEvalEveryNMessages: typeof args.themeReEvalEveryNMessages === 'number' ? args.themeReEvalEveryNMessages : null,
+      });
     case 'chat_topics_edit':
       return await messagingPost('/ChatIntelligenceTopics/mapping', { ops: [{ op: args.op, from: args.from ?? [], to: args.to ?? null, group: args.group ?? null }] });
     case 'chat_topics_group_suggestions':
@@ -6993,6 +7075,19 @@ async function handleTool(name, args) {
       return await api('PUT', '/TeamsBot/PushSettings', body);
     }
 
+    case 'dynamics_team_overrides_get':
+      return await api('GET', `/Dynamics/Configs/${Number(args.configId)}/team-overrides`);
+
+    case 'dynamics_team_overrides_set': {
+      const body = {};
+      for (const k of ['activityLogicalName', 'customFieldMappingsJson'])
+        if (args[k] !== undefined) body[k] = args[k];
+      return await api('PUT', `/Dynamics/Configs/${Number(args.configId)}/team-overrides/${Number(args.teamId)}`, body);
+    }
+
+    case 'dynamics_team_overrides_reset':
+      return await api('DELETE', `/Dynamics/Configs/${Number(args.configId)}/team-overrides/${Number(args.teamId)}`);
+
     case 'teams_channel_config_get':
       return await api('GET', '/TeamsBot/ChannelConfig');
 
@@ -7436,6 +7531,17 @@ async function handleTool(name, args) {
       return JSON.stringify(result, null, 2);
     }
 
+    case 'livefluence_conversion_advisor': {
+      const result = await api('POST', '/DatabaseTool/ConversionAdvisor', {
+        v10SiteId: args.intents?.length ? null : (args.v10_site_id ?? null),
+        v20SiteId: args.v20_site_id,
+        apply: !!args.apply,
+        includeNonRouting: !!args.include_non_routing,
+        intents: args.intents ?? null,
+      });
+      return JSON.stringify(result, null, 2);
+    }
+
     case 'livefluence_migrate': {
       const result = await api('POST', '/DatabaseTool/V10Migrate', {
         v10SiteId:        args.v10_site_id,
@@ -9275,6 +9381,18 @@ async function handleTool(name, args) {
     }
 
     // ── AI Video Avatar ────────────────────────────────────────────────────
+    // -- Image Analysis limits --
+    case 'image_analysis_limits': {
+      const d = await api('GET', `/ImageAnalysisLimits/superadmin?siteId=${args.siteId}`);
+      return [
+        `Site ${args.siteId}: Image Analysis ${d.entitled === null ? 'entitlement unknown' : d.entitled ? 'ENTITLED' : 'NOT entitled'}`,
+        `  Monthly cap:      ${d.monthlyCap} (effective ${d.effectiveMonthlyCap}, hard cap, no automatic overage)`,
+        `  Used this month:  ${d.usedThisMonth === null ? 'unknown' : d.usedThisMonth}`,
+        `  Per-chat cap:     ${d.perConversationCap}`,
+        `  Extra block size: ${d.blockSize}`,
+      ].join('\n');
+    }
+
     case 'avatar_get_config': {
       const data = await api('GET', `/Avatar/superadmin/status?siteId=${args.siteId}`);
       if (!data.configured) return `Site ${args.siteId}: AI Video Avatar NOT configured (no saved config).`;