@velaro/mcp-server 2.0.25 → 2.0.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -119,6 +119,8 @@ This works with any MCP client that supports HTTP/SSE transport — including Cl
119
119
  | `bot_get` | Get full bot config including system prompt |
120
120
  | `bot_update_prompt` | Update a bot's system prompt |
121
121
  | `ai_config_set_reply_format` | Set reply format: global (plain text), plain, or markdown |
122
+ | `ai_config_channel_overrides_get` | List per-channel overrides incl. selection presentation settings ("All" row = bot default) |
123
+ | `ai_config_selection_presentation_set` | Set how choice lists are shown for a channel or the "All" default: carousel/list/text, cap 1-25, repeat, Tell me more, follow-up chips (null = inherit) |
122
124
 
123
125
  ### CRM Mobile Fields
124
126
  | Tool | What It Does |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@velaro/mcp-server",
3
- "version": "2.0.25",
3
+ "version": "2.0.26",
4
4
  "description": "Velaro MCP server — connect Claude and other AI agents directly to your Velaro account: KB, workflows, bots, conversations, contacts, routing, and more.",
5
5
  "type": "module",
6
6
  "bin": {
package/server.js CHANGED
@@ -1257,6 +1257,33 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
1257
1257
  required: ['aiConfigId', 'mode'],
1258
1258
  },
1259
1259
  },
1260
+ {
1261
+ name: 'ai_config_channel_overrides_get',
1262
+ description: 'List a bot\'s per-channel overrides including the selection presentation settings (how product/choice lists are shown). Rows: conversationSource Web, AppleMessages, WhatsApp, TwilioSms, TwilioIvr, etc., plus "All" = the bot/site default row. Resolution: channel row, then the "All" row, then the platform default (carousel; caps 10 web / 3 Apple / 3 SMS; repeat always; tell-me-more on; chips on). Admin UI: Bots > AI Settings > Channel Overrides.',
1263
+ inputSchema: {
1264
+ type: 'object',
1265
+ properties: { aiConfigId: { type: 'number', description: 'AI configuration ID (from bot_list)' } },
1266
+ required: ['aiConfigId'],
1267
+ },
1268
+ },
1269
+ {
1270
+ name: 'ai_config_selection_presentation_set',
1271
+ description: 'Set selection presentation for one channel row (or "All" = bot/site default) on a bot, leaving every other row and field untouched (read-modify-write of the channel-overrides list). Fields: selectionPresentation ("carousel"|"list"|"text"), maxSelectionResults (1-25), repeatSelectionsInline ("always"|"collapsed"), showTellMeMore (bool), tellMeMoreLabel (<=64 chars), showFollowUpChips (bool). null = inherit. Pass only the fields to change; pass null to reset a field to inherit. Channels: web = carousel, Apple Messages = native rich links, WhatsApp = native list/cards, IVR = spoken summary only (no links). Admin UI: Bots > AI Settings > Channel Overrides.',
1272
+ inputSchema: {
1273
+ type: 'object',
1274
+ properties: {
1275
+ aiConfigId: { type: 'number', description: 'AI configuration ID (from bot_list)' },
1276
+ channel: { type: 'string', description: 'conversationSource: All, Web, AppleMessages, WhatsApp, TwilioSms, TwilioIvr, Email, Facebook, Twitter, Rcs' },
1277
+ selectionPresentation: { type: ['string', 'null'], enum: ['carousel', 'list', 'text', null] },
1278
+ maxSelectionResults: { type: ['number', 'null'], minimum: 1, maximum: 25 },
1279
+ repeatSelectionsInline: { type: ['string', 'null'], enum: ['always', 'collapsed', null] },
1280
+ showTellMeMore: { type: ['boolean', 'null'] },
1281
+ tellMeMoreLabel: { type: ['string', 'null'], maxLength: 64 },
1282
+ showFollowUpChips: { type: ['boolean', 'null'] },
1283
+ },
1284
+ required: ['aiConfigId', 'channel'],
1285
+ },
1286
+ },
1260
1287
  {
1261
1288
  name: 'site_identity_secret_status',
1262
1289
  description: 'Check whether a visitor identity signing secret is configured for this site. The secret lets pre-authenticated visitors (already logged in to the customer website) skip the OTP challenge when the bot looks up their CRM data. Returns whether configured and the masked secret. To generate or rotate the secret, the customer goes to Admin → Account Settings → Security → "Visitor Identity Signing Secret".',
@@ -5405,6 +5432,27 @@ async function handleTool(name, args) {
5405
5432
  // [Authorize] does not accept vel_live_* service keys (only a handful of controllers opt
5406
5433
  // into that manually) — these tools need VELARO_JWT, same requirement as the existing
5407
5434
  // notifications_get tool they're modeled on.
5435
+ case 'ai_config_channel_overrides_get': {
5436
+ const rows = await messagingGet(`/AIConfiguration/${encodeURIComponent(args.aiConfigId)}/channel-overrides`);
5437
+ return JSON.stringify(Array.isArray(rows) ? rows : [], null, 2);
5438
+ }
5439
+
5440
+ case 'ai_config_selection_presentation_set': {
5441
+ const path = `/AIConfiguration/${encodeURIComponent(args.aiConfigId)}/channel-overrides`;
5442
+ const FIELDS = ['selectionPresentation', 'maxSelectionResults', 'repeatSelectionsInline', 'showTellMeMore', 'tellMeMoreLabel', 'showFollowUpChips'];
5443
+ const rows = (await messagingGet(path)) ?? [];
5444
+ const list = Array.isArray(rows) ? rows : [];
5445
+ const src = String(args.channel);
5446
+ const cur = list.find(r => r.conversationSource === src)
5447
+ ?? { conversationSource: src, mode: 'additive', overrideText: '' };
5448
+ const next = { ...cur };
5449
+ for (const f of FIELDS) if (f in args) next[f] = args[f];
5450
+ // PUT replaces all rows, so send every existing row back (fields round-trip as returned).
5451
+ const out = [...list.filter(r => r.conversationSource !== src), next];
5452
+ await messagingPut(path, out);
5453
+ return JSON.stringify(await messagingGet(path), null, 2);
5454
+ }
5455
+
5408
5456
  case 'ai_followups_site_get': {
5409
5457
  const r = await messagingGet('/SiteSettings/AiFollowUps');
5410
5458
  return JSON.stringify({ enabled: r?.enabled ?? null }, null, 2);
@@ -24,6 +24,7 @@ const MUTATING = new Set([
24
24
  'monday_set_field_mapping', 'teams_push_settings_update', 'teams_channel_config_update',
25
25
  'routing_team_update_config', 'pickup_update_config', 'payment_recovery_update_config',
26
26
  'recruiting_sync_jobs', 'ai_config_set_reply_format', 'magento_set_sidebar_fields',
27
+ 'ai_config_selection_presentation_set',
27
28
  'zoom_phone_set_config', 'callpresence_set', 'callpresence_set_groups', 'callpresence_clear',
28
29
  'billing_insights_set_preferences', 'billing_insights_dismiss_recommendation',
29
30
  'site_sale_create', 'site_sale_update', 'site_sale_end',