@velaro/mcp-server 0.6.92 → 0.6.93

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velaro/mcp-server",
-  "version": "0.6.92",
+  "version": "0.6.93",
   "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": {
@@ -10,7 +10,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@modelcontextprotocol/sdk": "^1.32.1",
     "qs": "^6.16.0"
   },
   "overrides": {

package/server.js

@@ -1048,6 +1048,7 @@ Key node shapes:
     propName:"myAnswerVar" }                      // variable that stores the result as JSON array string
 • condition:      { type:"action", actionType:"condition", conditionOptions:[...] }
 • transferToAI:   { type:"action", actionType:"transferToAI", aiConfigId:N }
+  AI follow-up suggestions ("AI mode"): add suggestFollowUps:true|false (omit = use the account default, set via ai_followups_site_set), suggestFollowUpCount:2-4, suggestFollowUpInstruction:"<=300 chars". After each web-chat bot reply the bot offers short tappable follow-up replies; typing stays available.
 
 For multiSelect dynamic options: the variable named in dynamicOptionsVariable must contain a JSON array like [{"label":"Red","value":"red"},{"label":"Blue","value":"blue"}]. Populate it via an HTTP Request node before the ask node.`,
     inputSchema: {
@@ -1061,6 +1062,20 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
     },
   },
 
+  {
+    name: 'ai_followups_site_get',
+    description: "Read this account's default for AI follow-up suggestions (the AI Chatbot node's \"AI mode\": after each web-chat bot reply the bot offers 2-4 short tappable follow-up replies). A node's own suggestFollowUps setting wins over this default; platform default is off.",
+    inputSchema: { type: 'object', properties: {}, required: [] },
+  },
+  {
+    name: 'ai_followups_site_set',
+    description: "Set this account's default for AI follow-up suggestions. enabled=true/false, or omit/null to clear (platform default: off). Per-node settings (workflow_update_node: suggestFollowUps) override this. Returns the value read back from the server.",
+    inputSchema: {
+      type: 'object',
+      properties: { enabled: { type: ['boolean', 'null'], description: 'true = on, false = off, null/omitted = clear' } },
+      required: [],
+    },
+  },
   // ── Surveys ──────────────────────────────────────────────────────────────
   {
     name: 'survey_list',
@@ -1594,10 +1609,28 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
         },
         buttonLabel: { type: 'string', description: 'Optional action button label' },
         buttonUrl:   { type: 'string', description: 'Optional action button URL (required if buttonLabel is set)' },
+        mentions:    { type: 'array', description: 'People to @mention (real Teams notification). Velaro staff only. Uses the ops Teams sender instead of a webhook.', items: { type: 'object', properties: { user: { type: 'string', description: 'Entra object id or UPN, e.g. andrea@velaro.com' }, name: { type: 'string', description: 'Display name shown in the @mention' } }, required: ['user'] } },
+        destination: { type: 'string', description: 'Named channel in the DevOps team instead of General: prs, workflows, deploys, alerts, qa, general. Velaro staff only; uses the ops Teams sender instead of a webhook.' },
       },
       required: ['title'],
     },
   },
+  {
+    name: 'teams_send_direct',
+    description: 'Send a 1:1 Teams message (Adaptive Card) directly to any user in the Velaro tenant by UPN/email or Entra object id. Velaro staff only. Graph chat first, Velaro Bot proactive fallback.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        user:        { type: 'string', description: 'UPN/email (alex@velaro.com) or Entra object id' },
+        title:       { type: 'string', description: 'Card title' },
+        message:     { type: 'string', description: 'Message text' },
+        fields:      { type: 'array', description: 'Optional fact rows', items: { type: 'object', properties: { label: { type: 'string' }, value: { type: 'string' } }, required: ['label', 'value'] } },
+        buttonLabel: { type: 'string', description: 'Optional button label' },
+        buttonUrl:   { type: 'string', description: 'Optional button URL' },
+      },
+      required: ['user', 'title'],
+    },
+  },
 
   // ── Slack ─────────────────────────────────────────────────────────────────
   {
@@ -3057,7 +3090,7 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
     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'] },
+        report:       { type: 'string', enum: ['program_breakdown', 'agent_scorecard', 'qa_coverage', 'coaching_queue', 'sentiment_breakdown', 'topic_radar', 'weekly_brief', 'weekly_brief_send_test', 'repeat_contact', 'demand_coverage', 'bot_containment', 'effort_index', 'promise_ledger', 'promise_dismiss'] },
         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.' },
@@ -3067,6 +3100,14 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
         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).' },
+        windowDays:   { type: 'number', description: 'repeat_contact: days a contact has to come back to count as a repeat (1-30, default 7).' },
+        weeks:        { type: 'number', description: 'demand_coverage: whole local weeks of history (1-12, default 6). from/to are IGNORED by demand_coverage.' },
+        handleMinutes: { type: 'number', description: 'demand_coverage: assumed minutes per chat (1-120, default 10).' },
+        maxConcurrent: { type: 'number', description: 'demand_coverage: assumed chats an agent handles at once (1-10, default 3).' },
+        timeZone:     { type: 'string', description: 'demand_coverage: IANA time zone (default America/Los_Angeles).' },
+        lowScore:     { type: 'number', description: 'bot_containment: QA score below which a handed-off chat counts as regret (1-100, default 60).' },
+        includeDemo:  { type: 'boolean', description: 'true = show only the seeded sample (demo) data. Default false.' },
+        promiseId:    { type: 'string', description: 'promise_dismiss: the promise id to dismiss (managers only).' },
       },
       required: ['report'],
     },
@@ -3750,6 +3791,15 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: [],
     },
   },
+  {
+    name: 'ai_federation',
+    description: 'SuperAdmin: Anthropic Workload Identity Federation for the AI gateway. action=status shows enabled, circuit breaker state, last success/failure reason, federated vs API-key fallback counts and token expiry. action=test does a real token exchange plus a 1-token Haiku message and reports which path (federated, apikey, apikey-fallback) served it. action=reset_breaker closes the breaker so the next call retries federation.',
+    inputSchema: {
+      type: 'object',
+      properties: { action: { type: 'string', enum: ['status', 'test', 'reset_breaker'], description: 'Default status.' } },
+      required: [],
+    },
+  },
   {
     name: 'status_incident_list',
     description: 'Velaro staff only (SuperAdmin). Lists public status page incidents, including component overrides (IncidentType "Override").',
@@ -4998,6 +5048,7 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       properties: {
         publicApplyEnabled: { type: 'boolean' },
         autoCreateCaseTypeId: { type: 'number', description: 'Case type id; 0 clears the auto-create link' },
+        defaultListingDays: { type: 'number', description: '1-365: how many days a new listing stays live when its feed gives no expiry. Requires the Job Board lifecycle package.' },
       },
       required: [],
     },
@@ -5103,6 +5154,29 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: ['sourceId', 'title'],
     },
   },
+  // -- Job Board listing lifecycle (package "job-board-lifecycle", default OFF: 403 for a site without it) --
+  {
+    name: 'jobboard_lifecycle_status',
+    description: 'Does this site have the Job Board listing lifecycle package (close/renew, expiry, JSON-LD listing pages), and what is its default listing duration? Returns { entitled, defaultListingDays }.',
+    inputSchema: { type: 'object', properties: {}, required: [] },
+  },
+  {
+    name: 'jobboard_close_listing',
+    description: 'Close a job listing: it stops appearing in search and the public board, the public listing page answers 410, and applying to it answers 410. Idempotent. Requires the Job Board lifecycle package (403 otherwise); 404 for an id that is not on this site.',
+    inputSchema: { type: 'object', properties: { listingId: { type: 'number' } }, required: ['listingId'] },
+  },
+  {
+    name: 'jobboard_renew_listing',
+    description: 'Renew a job listing: extends its expiry by `days` (default: the site\'s default listing days) from the later of its current expiry and now, increments its renewal count and republishes it if it was closed or expired. Requires the Job Board lifecycle package (403 otherwise).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        listingId: { type: 'number' },
+        days: { type: 'number', description: '1-365; omit for the site default' },
+      },
+      required: ['listingId'],
+    },
+  },
   {
     name: 'jobboard_move_application_stage',
     description: 'Move a candidate application to a new HR/agency-side pipeline stage on the applicant Kanban board (Applied, Screened, Interview, Offer, Hired, Rejected).',
@@ -5994,6 +6068,17 @@ async function handleTool(name, args) {
     // [Authorize] does not accept vel_live_* service keys (only a handful of controllers opt
     // into that manually) — these tools need VELARO_JWT, same requirement as the existing
     // notifications_get/ai_config_staff_get tools they're modeled on.
+    case 'ai_followups_site_get': {
+      const r = await messagingGet('/SiteSettings/AiFollowUps');
+      return JSON.stringify({ enabled: r?.enabled ?? null }, null, 2);
+    }
+
+    case 'ai_followups_site_set': {
+      await messagingPut('/SiteSettings/AiFollowUps', { enabled: typeof args.enabled === 'boolean' ? args.enabled : null });
+      const r = await messagingGet('/SiteSettings/AiFollowUps');
+      return JSON.stringify({ enabled: r?.enabled ?? null }, null, 2);
+    }
+
     case 'survey_list': {
       const surveys = (await messagingGet('/Surveys/list')) ?? [];
       if (!surveys.length) return 'No surveys found.';
@@ -6492,7 +6577,26 @@ async function handleTool(name, args) {
       return await api('PUT', '/TeamsBot/ChannelConfig', body);
     }
 
+    case 'teams_send_direct': {
+      const r = await api('POST', '/TeamsMessaging/Direct', {
+        user: args.user, title: args.title, message: args.message || '',
+        facts: (args.fields || []).map(f => ({ label: f.label, value: f.value })),
+        actionUrl: args.buttonUrl, actionLabel: args.buttonLabel,
+      });
+      return r?.sent ? `Direct message sent to ${args.user} via ${r.path}.` : `Send failed: ${r?.error || 'unknown error'} ${(r?.warnings || []).join('; ')}`;
+    }
+
     case 'teams_notify_card': {
+      if ((args.mentions && args.mentions.length) || args.destination) {
+        const r = await api('POST', '/TeamsMessaging/Card', {
+          title: args.title,
+          facts: (args.fields || []).map(f => ({ label: f.label, value: f.value })),
+          actionUrl: args.buttonUrl, actionLabel: args.buttonLabel,
+          destination: args.destination,
+          mentions: (args.mentions || []).map(m => ({ user: m.user, name: m.name })),
+        });
+        return r?.sent ? `Card sent via ${r.path}${r.warnings?.length ? ' (' + r.warnings.join('; ') + ')' : ''}.` : `Send failed: ${r?.error || 'unknown error'}`;
+      }
       const webhooks = await api('GET', '/TeamsNotification');
       if (!Array.isArray(webhooks) || !webhooks.length)
         return 'No Teams webhooks configured. Go to Integrations → Microsoft Teams to add one, or call velaro teams create <name> <webhookUrl> via CLI.';
@@ -8485,12 +8589,18 @@ async function handleTool(name, args) {
         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',
+        repeat_contact: 'repeat-contact', demand_coverage: 'demand-coverage', bot_containment: 'bot-containment',
+        effort_index: 'effort-index', promise_ledger: 'promise-ledger',
       };
+      if (args.report === 'promise_dismiss') {
+        if (!args.promiseId) throw new Error('promiseId is required for promise_dismiss');
+        return JSON.stringify(await messagingPost('/api/enterprise-reports/promise-ledger/' + encodeURIComponent(String(args.promiseId)) + '/dismiss', {}), null, 2);
+      }
       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']) {
+      for (const k of ['from', 'to', 'groupBy', 'deploymentId', 'teamId', 'threshold', 'perAgent', 'limit', 'days', 'windowDays', 'weeks', 'handleMinutes', 'maxConcurrent', 'timeZone', 'lowScore', 'includeDemo']) {
         if (args[k] != null && args[k] !== '') qs.set(k, String(args[k]));
       }
       const q = qs.toString();
@@ -8908,6 +9018,13 @@ async function handleTool(name, args) {
       return JSON.stringify(data, null, 2);
     }
 
+    case 'ai_federation': {
+      const action = args.action || 'status';
+      if (action === 'test') return JSON.stringify(await api('POST', '/AiFederation/test', {}), null, 2);
+      if (action === 'reset_breaker') return JSON.stringify(await api('POST', '/AiFederation/reset-breaker', {}), null, 2);
+      return JSON.stringify(await api('GET', '/AiFederation/status'), null, 2);
+    }
+
     case 'status_incident_list': {
       const rows = await messagingRequest('GET', `/superadmin/status-incidents?filter=${encodeURIComponent(args.filter || 'active')}`);
       return JSON.stringify(rows, null, 2);
@@ -10330,7 +10447,12 @@ async function handleTool(name, args) {
         if (!Number.isInteger(n) || n < 0) throw new Error('autoCreateCaseTypeId must be an integer >= 0 (0 clears).');
         body.autoCreateCaseTypeId = n;
       }
-      if (!Object.keys(body).length) throw new Error('Specify publicApplyEnabled and/or autoCreateCaseTypeId.');
+      if (args.defaultListingDays !== undefined) {
+        const d = Number(args.defaultListingDays);
+        if (!Number.isInteger(d) || d < 1 || d > 365) throw new Error('defaultListingDays must be an integer from 1 to 365.');
+        body.defaultListingDays = d;
+      }
+      if (!Object.keys(body).length) throw new Error('Specify publicApplyEnabled, autoCreateCaseTypeId and/or defaultListingDays.');
       const r = await messagingPut('/Recruiting/ApplySettings', body);
       return JSON.stringify(r, null, 2);
     }
@@ -10367,6 +10489,29 @@ async function handleTool(name, args) {
       }, null, 2);
     }
 
+    case 'jobboard_lifecycle_status': {
+      const r = await messagingGet('/Recruiting/Lifecycle');
+      return JSON.stringify(r, null, 2);
+    }
+    case 'jobboard_close_listing': {
+      const id = Number(args.listingId);
+      if (!Number.isInteger(id) || id <= 0) throw new Error('listingId must be a positive integer.');
+      const r = await messagingPost(`/Recruiting/Jobs/${id}/close`, {});
+      return JSON.stringify(r, null, 2);
+    }
+    case 'jobboard_renew_listing': {
+      const id = Number(args.listingId);
+      if (!Number.isInteger(id) || id <= 0) throw new Error('listingId must be a positive integer.');
+      const body = {};
+      if (args.days !== undefined) {
+        const d = Number(args.days);
+        if (!Number.isInteger(d) || d < 1 || d > 365) throw new Error('days must be an integer from 1 to 365.');
+        body.days = d;
+      }
+      const r = await messagingPost(`/Recruiting/Jobs/${id}/renew`, body);
+      return JSON.stringify(r, null, 2);
+    }
+
     case 'jobboard_move_application_stage': {
       const app = await messagingPut(`/Recruiting/Applications/${args.applicationId}/Stage`, { stage: args.stage });
       return JSON.stringify(app, null, 2);