@velaro/mcp-server 0.6.95 → 0.6.96

package/package.json

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

@@ -1699,6 +1699,79 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
   },
 
   // ── Livefluence Migration ─────────────────────────────────────────────────
+  {
+    name: 'livefluence_site_workflows_list',
+    description: 'Velaro staff only (superadmin). List ANOTHER v20 site\'s workflows: id, name, enabled, priority, action, team/AI target. Use after livefluence_migrate to see what exists on the destination site (e.g. 100140).',
+    inputSchema: { type: 'object', properties: { site_id: { type: 'number', description: 'V20 site ID to inspect' } }, required: ['site_id'] },
+  },
+  {
+    name: 'livefluence_site_workflows_set_enabled',
+    description: 'Velaro staff only (superadmin). Enable or disable workflows on a v20 site by ids or names. Idempotent, audit-logged. Enabling REFUSES a workflow whose trigger is not fully converted from v10 unless force_partial=true; pass v10_site_id to check each against its same-named v10 rule. Use dry_run=true first.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        site_id:       { type: 'number', description: 'V20 site ID' },
+        workflow_ids:  { type: 'array', items: { type: 'number' } },
+        names:         { type: 'array', items: { type: 'string' } },
+        enabled:       { type: 'boolean', description: 'true = enable, false = disable' },
+        v10_site_id:   { type: 'number', description: 'Verify conversion against this v10 site rules' },
+        force_partial: { type: 'boolean', description: 'Enable even if v10 expression terms were not converted' },
+        dry_run:       { type: 'boolean' },
+      },
+      required: ['site_id', 'enabled'],
+    },
+  },
+  {
+    name: 'livefluence_site_workflow_create',
+    description: 'Velaro staff only (superadmin). Create a workflow on a v20 site from a nodes-blob JSON (object of nodes with a trigger node). Disabled unless enabled=true. Idempotent by name; validates that referenced AI configs/teams exist on the site. Use dry_run=true first.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        site_id:      { type: 'number' },
+        name:         { type: 'string' },
+        nodes_blob:   { type: 'string', description: 'JSON string of the nodes object' },
+        trigger_type: { type: 'string', description: 'Default conversation_opened' },
+        enabled:      { type: 'boolean' },
+        dry_run:      { type: 'boolean' },
+      },
+      required: ['site_id', 'name', 'nodes_blob'],
+    },
+  },
+  {
+    name: 'livefluence_site_workflow_set_action',
+    description: 'Velaro staff only (superadmin). Set a workflow action node on a v20 site to transferToAI {aiConfigId} or routeToTeam {teamId}. Validates the target exists on that site. Idempotent, audit-logged.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        site_id:     { type: 'number' },
+        workflow_id: { type: 'number' },
+        action_type: { type: 'string', enum: ['transferToAI', 'routeToTeam'] },
+        target_id:   { type: 'number', description: 'aiConfigId for transferToAI, teamId for routeToTeam' },
+        dry_run:     { type: 'boolean' },
+      },
+      required: ['site_id', 'workflow_id', 'action_type', 'target_id'],
+    },
+  },
+  {
+    name: 'livefluence_site_rules_list',
+    description: 'Velaro staff only (superadmin). List a v20 site Rules (e.g. the use-ai rules seeded by livefluence_seed_url_rules) with enabled state.',
+    inputSchema: { type: 'object', properties: { site_id: { type: 'number' } }, required: ['site_id'] },
+  },
+  {
+    name: 'livefluence_site_rules_set_enabled',
+    description: 'Velaro staff only (superadmin). Switch v20 Rules off/on without deleting them (reversible), by rule ids or by trigger (e.g. use-ai). Use to turn off the url-rules seeded earlier so they do not double-route with migrated workflows. Idempotent, audit-logged.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        site_id:  { type: 'number' },
+        rule_ids: { type: 'array', items: { type: 'number' } },
+        trigger:  { type: 'string', description: 'Every rule with this trigger, e.g. use-ai' },
+        enabled:  { type: 'boolean' },
+        dry_run:  { type: 'boolean' },
+      },
+      required: ['site_id', 'enabled'],
+    },
+  },
   {
     name: 'livefluence_seed_url_rules',
     description: 'Velaro staff only. Seed v20 use-ai routing rules on a target site from v10 URL rules. Each rule matches "url contains <path>" with scheme/host stripped (path-only), so a demo page path triggers the same rule as the customer real URL. Idempotent. Domain-only URLs are skipped. Use dry_run=true first.',
@@ -2160,6 +2233,20 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: ['jobId'],
     },
   },
+  {
+    name: 'index_create',
+    description: 'Velaro staff only. Create a named virtual knowledge index on ANY site (e.g. "100140-troubleshooting", "100140-manual-catalog") so uploads/publishes with that indexName work. Idempotent: returns the existing index if the name already exists. Respects the site index quota. Wraps POST KnowledgeSetup/Staff/{siteId}/create-index.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        siteId:                { type: 'number', description: 'Target site ID' },
+        indexName:             { type: 'string', description: 'Index name (lowercased, a-z 0-9 and dashes)' },
+        purpose:               { type: 'string', enum: ['general', 'troubleshooting', 'catalog'], description: 'Index purpose (default general)' },
+        excludeFromAllSources: { type: 'boolean', description: 'Keep out of the ["*"] all-sources search' },
+      },
+      required: ['siteId', 'indexName'],
+    },
+  },
   {
     name: 'uploaded_file_reindex',
     description: 'Re-index an already-uploaded AI training file from blob storage — use when a file shows 0 chunks (e.g. PDF uploaded before PDF support was added). Reads from blob and re-runs full ingestion. Use index_status after ~30s to verify chunks appear.',
@@ -7145,6 +7232,47 @@ async function handleTool(name, args) {
       return JSON.stringify(result, null, 2);
     }
 
+    case 'livefluence_site_workflows_list': {
+      const result = await api('GET', `/DatabaseTool/SiteWorkflows/${args.site_id}`);
+      return JSON.stringify(result, null, 2);
+    }
+
+    case 'livefluence_site_workflows_set_enabled': {
+      const result = await api('POST', '/DatabaseTool/SiteWorkflows/SetEnabled', {
+        siteId: args.site_id, workflowIds: args.workflow_ids ?? [], names: args.names ?? [],
+        enabled: !!args.enabled, dryRun: !!args.dry_run, forcePartial: !!args.force_partial, v10SiteId: args.v10_site_id ?? null,
+      });
+      return JSON.stringify(result, null, 2);
+    }
+
+    case 'livefluence_site_workflow_create': {
+      const result = await api('POST', '/DatabaseTool/SiteWorkflows/Create', {
+        siteId: args.site_id, name: args.name, triggerType: args.trigger_type ?? 'conversation_opened',
+        nodesBlob: typeof args.nodes_blob === 'string' ? args.nodes_blob : JSON.stringify(args.nodes_blob),
+        enabled: !!args.enabled, dryRun: !!args.dry_run,
+      });
+      return JSON.stringify(result, null, 2);
+    }
+
+    case 'livefluence_site_workflow_set_action': {
+      const result = await api('POST', '/DatabaseTool/SiteWorkflows/SetAction', {
+        siteId: args.site_id, workflowId: args.workflow_id, actionType: args.action_type, targetId: args.target_id, dryRun: !!args.dry_run,
+      });
+      return JSON.stringify(result, null, 2);
+    }
+
+    case 'livefluence_site_rules_list': {
+      const result = await api('GET', `/DatabaseTool/SiteRules/${args.site_id}`);
+      return JSON.stringify(result, null, 2);
+    }
+
+    case 'livefluence_site_rules_set_enabled': {
+      const result = await api('POST', '/DatabaseTool/SiteRules/SetEnabled', {
+        siteId: args.site_id, ruleIds: args.rule_ids ?? [], trigger: args.trigger ?? null, enabled: !!args.enabled, dryRun: !!args.dry_run,
+      });
+      return JSON.stringify(result, null, 2);
+    }
+
     case 'livefluence_seed_url_rules': {
       const result = await api('POST', '/DatabaseTool/V10SeedUrlRules', {
         siteId: args.site_id, aiConfigId: args.ai_config_id, dryRun: !!args.dry_run, rules: args.rules,
@@ -7626,6 +7754,15 @@ async function handleTool(name, args) {
       return lines.join('\n');
     }
 
+    case 'index_create': {
+      if (!args.siteId || !args.indexName) return 'siteId and indexName are required.';
+      const body = { indexName: args.indexName, purpose: args.purpose ?? 'general' };
+      if (args.excludeFromAllSources !== undefined) body.excludeFromAllSources = args.excludeFromAllSources;
+      const idx = await messagingRequest('POST', `/KnowledgeSetup/Staff/${encodeURIComponent(args.siteId)}/create-index`, body);
+      if (idx?.error) return `Create index error: ${idx.error}`;
+      return `Index ready on site ${args.siteId}: ${idx?.name} (id=${idx?.id}, purpose=${idx?.purpose}, excludeFromAllSources=${!!idx?.excludeFromAllSources}).`;
+    }
+
     case 'uploaded_files_list': {
       const files = await messagingRequest('GET', '/uploadedFiles/list/AI');
       if (!Array.isArray(files) || !files.length) return 'No AI training files uploaded for this site.';