@velaro/mcp-server 0.6.66 → 0.6.68

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.66",
+  "version": "0.6.68",
   "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?"',
@@ -3989,15 +4024,16 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
   // Moshky AI safety rule and ConversationTriageService's prompt assembly (velaro-messaging).
   {
     name: 'focus_get_triage_rules',
-    description: 'Get this site\'s current AI triage rules: which of the 5 fixed labels (urgent, needs_reply, offer, fyi, waiting) are enabled, plus the per-channel triage-on-off and priority weight already owned by the channel-config endpoint, shown here for context. A label missing/never configured defaults to enabled.',
+    description: 'Get this site\'s current AI triage rules: which of the 5 fixed labels (urgent, needs_reply, offer, fyi, waiting) are enabled, plus the per-channel triage-on-off and priority weight already owned by the channel-config endpoint, shown here for context. A label missing/never configured defaults to enabled. Also returns triageMode ("off" or "economy").',
     inputSchema: { type: 'object', properties: {} },
   },
   {
     name: 'focus_update_triage_rules',
-    description: 'Enable or disable one or more of the 5 fixed AI triage labels (urgent, needs_reply, offer, fyi, waiting) for this site. Apply-if-present -- only labels included are changed. Rejects any label name outside the fixed set. Disabling all 5 fails safe back to all-enabled server-side rather than breaking triage.',
+    description: 'Enable or disable one or more of the 5 fixed AI triage labels (urgent, needs_reply, offer, fyi, waiting) for this site. Apply-if-present -- only labels included are changed. Rejects any label name outside the fixed set. Disabling all 5 fails safe back to all-enabled server-side rather than breaking triage. Optionally set triageMode: "economy" classifies obvious messages (auto-replies, clear urgency) without an AI call, lowering AI usage; "off" keeps current behavior. Unspecified fields are preserved.',
     inputSchema: {
       type: 'object',
       properties: {
+        triageMode: { type: 'string', enum: ['off', 'economy'], description: 'Optional. "economy" skips the AI call for obvious messages; "off" (default) keeps current behavior.' },
         labels: {
           type: 'array',
           description: 'Labels to update.',
@@ -4011,7 +4047,6 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
           },
         },
       },
-      required: ['labels'],
     },
   },
 
@@ -5635,6 +5670,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);
@@ -8776,10 +8826,17 @@ async function handleTool(name, args) {
     case 'focus_get_triage_rules':
       return await messagingGet('/Focus/triage-rules');
     case 'focus_update_triage_rules': {
-      if (!Array.isArray(args.labels) || args.labels.length === 0) {
-        throw new Error('labels is required and must be a non-empty array.');
+      const hasLabels = Array.isArray(args.labels) && args.labels.length > 0;
+      const hasMode = args.triageMode !== undefined && args.triageMode !== null;
+      if (!hasLabels && !hasMode) {
+        throw new Error('Provide labels (non-empty array) and/or triageMode.');
+      }
+      if (hasMode && !['off', 'economy'].includes(args.triageMode)) {
+        throw new Error('triageMode must be "off" or "economy".');
       }
-      const body = args.labels.map((l) => ({ Label: l.label, Enabled: l.enabled }));
+      const labels = hasLabels ? args.labels.map((l) => ({ Label: l.label, Enabled: l.enabled })) : undefined;
+      // Legacy array body when only labels are sent; object body when triageMode is involved.
+      const body = hasMode ? { ...(labels ? { labels } : {}), triageMode: args.triageMode } : labels;
       return await messagingPut('/Focus/triage-rules', body);
     }