@velaro/mcp-server 0.6.52 → 0.6.53

package/package.json

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

@@ -128,6 +128,17 @@ async function messagingApi(path) {
   return res.json();
 }
 
+// FIXED 2026-09-24: velaro-messaging's /superadmin/logs/search used to return a bare JSON array
+// for some queries and {entries, nextCursor} for others, depending on which internal code path
+// served the request (see that repo's LogsController.cs ENVELOPE SHAPE comment). It now always
+// returns {entries, nextCursor} -- this helper also accepts a bare array so callers degrade
+// gracefully rather than throwing if ever pointed at an older deploy.
+function extractLogEntries(response) {
+  if (Array.isArray(response)) return response;
+  if (response && Array.isArray(response.entries)) return response.entries;
+  return [];
+}
+
 async function messagingRequest(method, path, body) {
   if (!MESSAGING_API) throw new Error(
     'VELARO_MESSAGING_API is not configured. Add "VELARO_MESSAGING_API": "https://velaro-messaging-api-staging.azurewebsites.net" to your MCP env config.'
@@ -1944,13 +1955,18 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
     inputSchema: {
       type: 'object',
       properties: {
-        q:           { type: 'string',  description: 'Text to search for in log messages (plain or regex)' },
-        level:       { type: 'string',  enum: ['ERROR', 'WARN', 'INFO', 'DEBUG'], description: 'Filter by log level' },
-        integration: { type: 'string',  description: 'Integration tag filter (HubSpot, [Skill], NetSuite, etc.)' },
-        siteId:      { type: 'number',  description: 'Filter by site ID' },
-        last:        { type: 'string',  description: 'Time window: 30m, 2h, 1d (default: 2h)' },
-        take:        { type: 'number',  description: 'Max results (default: 50, max: 500)' },
-        regex:       { type: 'boolean', description: 'Treat q as a regex pattern (default: false)' },
+        q:             { type: 'string',  description: 'Text to search for in log messages (plain or regex)' },
+        level:         { type: 'string',  enum: ['ERROR', 'WARN', 'INFO', 'DEBUG'], description: 'Filter by log level' },
+        logger:        { type: 'string',  description: 'Logger name filter (substring match, or regex when regex=true)' },
+        integration:   { type: 'string',  description: 'Integration tag filter (HubSpot, [Skill], NetSuite, etc.)' },
+        siteId:        { type: 'number',  description: 'Filter by site ID' },
+        source:        { type: 'string',  description: 'Source/app-tag filter, e.g. velaro-messaging-Staging' },
+        platform:      { type: 'string',  enum: ['v10', 'v20', 'admin'], description: 'Filter by platform' },
+        environment:   { type: 'string',  enum: ['Production', 'Staging', 'Development'] },
+        correlationId: { type: 'string',  description: 'Exact correlation/trace ID filter' },
+        last:          { type: 'string',  description: 'Time window: 30m, 2h, 1d (default: 2h)' },
+        take:          { type: 'number',  description: 'Max results (default: 50, max: 500)' },
+        regex:         { type: 'boolean', description: 'Treat q/logger as a regex pattern (default: false)' },
       },
     },
   },
@@ -5469,7 +5485,8 @@ async function handleTool(name, args) {
       const velaroLoggerP = safeJson(async () => {
         if (!MESSAGING_API) return { _error: 'VELARO_MESSAGING_API not set — add it to MCP env config' };
         const q = encodeURIComponent('ERROR|WF-AI-ROUTE|PERF-SLOW');
-        return messagingApi(`/superadmin/logs/search?q=${q}&from=${encodeURIComponent(from1h)}&take=30&regex=true`);
+        const res = await messagingApi(`/superadmin/logs/search?q=${q}&from=${encodeURIComponent(from1h)}&take=30&regex=true`);
+        return extractLogEntries(res);
       });
 
       // ── Layer 4b: Loggly ERROR + SLOW + AI-routing logs (last 1h) — SECONDARY (migrating away)
@@ -6321,13 +6338,18 @@ async function handleTool(name, args) {
     case 'velaro_logs_search': {
       const from   = new Date(Date.now() - parseDuration(args.last));
       const params = new URLSearchParams({ from: from.toISOString(), take: String(args.take ?? 50) });
-      if (args.q)           params.set('q',           args.q);
-      if (args.level)       params.set('level',        args.level.toUpperCase());
-      if (args.integration) params.set('integration',  args.integration);
-      if (args.siteId)      params.set('siteId',        String(args.siteId));
-      if (args.regex)       params.set('regex',         'true');
-      const entries = await messagingApi(`/superadmin/logs/search?${params}`);
-      if (!Array.isArray(entries) || !entries.length) return 'No results.';
+      if (args.q)             params.set('q',             args.q);
+      if (args.level)         params.set('level',         args.level.toUpperCase());
+      if (args.logger)        params.set('logger',        args.logger);
+      if (args.integration)   params.set('integration',   args.integration);
+      if (args.siteId)        params.set('siteId',        String(args.siteId));
+      if (args.source)        params.set('source',        args.source);
+      if (args.platform)      params.set('platform',      args.platform);
+      if (args.environment)   params.set('environment',   args.environment);
+      if (args.correlationId) params.set('correlationId', args.correlationId);
+      if (args.regex)         params.set('regex',         'true');
+      const entries = extractLogEntries(await messagingApi(`/superadmin/logs/search?${params}`));
+      if (!entries.length) return 'No results.';
       const lines = [`${entries.length} result(s) from ${from.toISOString().slice(0, 16)} UTC\n`];
       for (const e of entries) {
         const ts    = new Date(e.timestamp ?? e.LogTimestamp).toISOString().replace('T', ' ').slice(0, 19);