@velaro/mcp-server 0.6.67 → 0.6.69

package/README.md

@@ -132,6 +132,8 @@ This works with any MCP client that supports HTTP/SSE transport — including Cl
 | `team_list` | List all teams for this site |
 | `routing_list` | List all routing rules ordered by priority |
 | `routing_get` | Get routing rule details including rule and value JSON |
+| `routing_team_get_config` | Team-level routing config (routing type, queue timeout, idle alerts); omit teamId for site default |
+| `routing_team_update_config` | Partial update of team-level routing config; unknown fields pass through |
 | `routing_get_policy` | Site auto-routing policy including reassignment mode and the agent inactivity chain |
 | `routing_update_policy` | Update the policy, reassignment mode and inactivity chain (mode is always sent back) |
 | `routing_simulate_inactivity` | DRY RUN of the inactivity chain for a mocked scenario, nothing is sent |

package/package.json

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

@@ -166,6 +166,12 @@ const MCP_SUBMISSION_LIMIT = 50;
 const messagingGet   = (path)       => messagingRequest('GET',  path);
 const messagingPost  = (path, body) => messagingRequest('POST', path, body);
 const messagingPut   = (path, body) => messagingRequest('PUT',  path, body);
+function teamRoutingConfigPath(teamId) {
+  if (teamId === undefined || teamId === null || teamId === '') return '/RoutingConfig';
+  const n = Number(teamId);
+  if (!Number.isInteger(n) || n <= 0) throw new Error('teamId must be a positive integer.');
+  return `/RoutingConfig?teamId=${n}`;
+}
 const messagingPatch = (path, body) => messagingRequest('PATCH', path, body);
 const messagingDel   = (path)       => messagingRequest('DELETE', path);
 
@@ -1571,6 +1577,35 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: [],
     },
   },
+  {
+    name: 'routing_team_get_config',
+    description: 'Get team-level routing config (routing type roundRobin/leastBusy/longestIdle, routing action, queue timeout, idle queue alert settings, schedule-aware routing). Pass teamId for a team row, omit for the site default row. Site is taken from auth.',
+    inputSchema: { type: 'object', properties: { teamId: { type: 'number', description: 'Team (group) id; omit for the site default row' } }, required: [] },
+  },
+  {
+    name: 'routing_team_update_config',
+    description: 'Partially update team-level routing config. Only fields you pass change; null means inherit. Any extra field in `config` is passed through to messaging unchanged (new routing types and fields work without an MCP release).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        teamId:                           { type: 'number', description: 'Team (group) id; omit for the site default row' },
+        routingType:                      { type: 'string', description: 'roundRobin | leastBusy | longestIdle (validated by messaging)' },
+        routingAction:                    { type: 'string', description: 'Routing action (validated by messaging)' },
+        queueTimeoutEnabled:              { type: ['boolean', 'null'] },
+        queueTimeoutMinutes:              { type: ['number', 'null'] },
+        prioritizeAgents:                 { type: ['boolean', 'null'] },
+        idleQueueAlertEnabled:            { type: ['boolean', 'null'] },
+        idleQueueAlertAfterMinutes:       { type: ['number', 'null'] },
+        idleQueueAlertRepeatMinutes:      { type: ['number', 'null'] },
+        idleQueueAlertMaxPerConversation: { type: ['number', 'null'] },
+        idleQueueAlertTitle:              { type: ['string', 'null'] },
+        idleQueueAlertBody:               { type: ['string', 'null'] },
+        scheduleAwareRoutingEnabled:      { type: ['boolean', 'null'] },
+        config:                           { type: 'object', additionalProperties: true, description: 'Any other RoutingConfig fields, passed through as-is' },
+      },
+      required: [],
+    },
+  },
   {
     name: 'routing_get_decision_log',
     description: 'Get the routing decision log for a specific conversation — shows every routing step, reroute attempt, agent assignments, terminal action, and rule source. Use to diagnose "why was this conversation handled this way?"',
@@ -2721,6 +2756,59 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
     },
   },
 
+  // ── Velaro Avatar (first-party provider) — library, personalities, site/group inheritance ──
+  {
+    name: 'avatar_list_library',
+    description: 'List Velaro Avatar library entries (realistic and character) with id slug, name, kind, hasImage, default personality. Lives in velaro-messaging — requires VELARO_MESSAGING_API.',
+    inputSchema: { type: 'object', properties: { kind: { type: 'string', description: '"realistic" or "character". Omit for all.' } } },
+  },
+  {
+    name: 'avatar_list_personalities',
+    description: 'List Velaro Avatar personality presets (tone/style) that can be selected at site or group level.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'avatar_set_site_default',
+    description: 'Set the calling site\'s default avatar provider, avatar and personality (applies to all groups without an override). Provider "velaro" is the default Velaro-owned avatar; "simli", "d-id", "heygen", "none" also valid.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        providerSlug: { type: 'string', description: 'velaro | simli | d-id | heygen | none' },
+        avatarId: { type: 'string', description: 'Library slug when provider is velaro, else the provider avatar id.' },
+        personalityPresetSlug: { type: 'string', description: 'Personality preset slug.' },
+      },
+    },
+  },
+  {
+    name: 'avatar_get_group_effective',
+    description: 'Show the effective avatar settings for a group (group override field, else site default) and whether an override exists.',
+    inputSchema: { type: 'object', properties: { groupId: { type: 'number' } }, required: ['groupId'] },
+  },
+  {
+    name: 'avatar_set_group_override',
+    description: 'Override avatar/personality/provider for one group. Omitted fields inherit the site default.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        groupId: { type: 'number' },
+        providerSlug: { type: 'string' },
+        avatarId: { type: 'string' },
+        personalityPresetSlug: { type: 'string' },
+      },
+      required: ['groupId'],
+    },
+  },
+  {
+    name: 'avatar_reset_group',
+    description: 'Reset one group to the site default avatar settings (removes its override).',
+    inputSchema: { type: 'object', properties: { groupId: { type: 'number' } }, required: ['groupId'] },
+  },
+  {
+    name: 'avatar_reset_all_overrides',
+    description: 'Reset ALL group overrides for the calling site back to the site default.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+
   // ── Calendly integration management (superadmin) ──────────────────────────
   {
     name: 'calendly_get_status',
@@ -5635,6 +5723,21 @@ async function handleTool(name, args) {
       return 'Circuit breaker reset. Smart routing is now active again.';
     }
 
+    case 'routing_team_get_config': {
+      return JSON.stringify(await messagingGet(teamRoutingConfigPath(args.teamId)), null, 2);
+    }
+
+    case 'routing_team_update_config': {
+      const { teamId, config, ...rest } = args;
+      const body = {};
+      for (const [k, v] of Object.entries({ ...(config && typeof config === 'object' ? config : {}), ...rest })) {
+        if (v !== undefined) body[k] = v;
+      }
+      if (!Object.keys(body).length) throw new Error('No fields to update. Pass at least one field.');
+      await messagingPut(teamRoutingConfigPath(teamId), body);
+      return `Team routing config updated (${teamId ? `team ${teamId}` : 'site default'}): ${Object.keys(body).join(', ')}.`;
+    }
+
     case 'routing_get_policy': {
       const p = await messagingGet('/AutoRoutingPolicy');
       const terminalLabel = terminalActionLabel(p.terminalActionOverride);
@@ -7438,6 +7541,23 @@ async function handleTool(name, args) {
       return `✓ AI Video Avatar updated for site ${args.siteId}. Provider: ${res.providerSlug}, enabled: ${res.enabled}`;
     }
 
+    case 'avatar_list_library':
+      return JSON.stringify(await messagingRequest('GET', `/avatar/library${args.kind ? `?kind=${encodeURIComponent(args.kind)}` : ''}`), null, 2);
+    case 'avatar_list_personalities':
+      return JSON.stringify(await messagingRequest('GET', '/avatar/personalities'), null, 2);
+    case 'avatar_set_site_default':
+      return JSON.stringify(await messagingRequest('POST', '/avatar/site-default', {
+        providerSlug: args.providerSlug, avatarId: args.avatarId, personalityPresetSlug: args.personalityPresetSlug }), null, 2);
+    case 'avatar_get_group_effective':
+      return JSON.stringify(await messagingRequest('GET', `/avatar/groups/${Number(args.groupId)}/effective`), null, 2);
+    case 'avatar_set_group_override':
+      return JSON.stringify(await messagingRequest('PUT', `/avatar/groups/${Number(args.groupId)}/override`, {
+        providerSlug: args.providerSlug, avatarId: args.avatarId, personalityPresetSlug: args.personalityPresetSlug }), null, 2);
+    case 'avatar_reset_group':
+      return JSON.stringify(await messagingRequest('DELETE', `/avatar/groups/${Number(args.groupId)}/override`), null, 2);
+    case 'avatar_reset_all_overrides':
+      return JSON.stringify(await messagingRequest('POST', '/avatar/group-overrides/reset-all', {}), null, 2);
+
     case 'calendly_get_status': {
       // `env`, when given, targets one specific admin API environment instead of whatever
       // VELARO_ADMIN_API this server process happens to be configured with — see ADMIN_API_HOSTS