@velaro/mcp-server 0.6.95 → 0.6.97

package/package.json

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

@@ -160,9 +160,17 @@ function avatarOverrideBody(args) {
   for (const k of ['providerSlug', 'avatarId', 'personalityPresetSlug', 'voiceId', 'displayName', 'backgroundMode', 'backgroundValue']) {
     if (args[k] !== undefined) body[k] = args[k];
   }
+  if (args.motionLevel !== undefined) body.motionLevel = parseAvatarMotionLevel(args.motionLevel);
   return body;
 }
 
+/** Closed vocabulary for avatar body motion; "" resets/inherits. Fails readably instead of a bare 400. */
+function parseAvatarMotionLevel(raw) {
+  const level = String(raw).trim().toLowerCase();
+  if (!['', 'off', 'subtle', 'natural', 'expressive'].includes(level)) throw new Error('motionLevel must be off, subtle, natural or expressive (empty string resets/inherits).');
+  return level;
+}
+
 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.'
@@ -1699,6 +1707,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 +2241,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.',
@@ -3299,7 +3394,7 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
   // ── AI Video Avatar management (superadmin) ────────────────────────────────
   {
     name: 'avatar_get_config',
-    description: 'Get the AI Video Avatar (Simli/D-ID/HeyGen) configuration for any customer site — provider, avatar/face ID, voice ID, enabled state, "call me" option, callback confirm window. Velaro admin only. Never returns provider API keys (Velaro uses its own master keys, never per-site).',
+    description: 'Get the AI Video Avatar (Simli/D-ID/HeyGen) configuration for any customer site — provider, avatar/face ID, voice ID, enabled state, "call me" option, callback confirm window, body motion level and strength. Velaro admin only. Never returns provider API keys (Velaro uses its own master keys, never per-site).',
     inputSchema: {
       type: 'object',
       properties: {
@@ -3325,6 +3420,8 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
         showBadge: { type: 'boolean', description: 'Show the name badge over the avatar video. Default true.' },
         sizePx: { type: 'number', description: 'Max avatar panel width in px (160-640, square). Default 360.' },
         allowVisitorCollapse: { type: 'boolean', description: 'Let visitors hide or collapse the avatar panel (up/down arrow and X). Default true.' },
+        motionLevel: { type: 'string', enum: ['', 'off', 'subtle', 'natural', 'expressive'], description: 'Body motion preset layered over the lip-sync (shoulders, breathing, head, brows). Empty string resets to the platform default (natural). Visitors with reduced-motion enabled always get a still avatar.' },
+        motionIntensityPercent: { type: 'integer', minimum: 25, maximum: 150, description: 'Body motion strength, whole percent 25-150 (default 100); multiplies every motion amplitude.' },
         maxAvatarMinutesPerMonth: { type: 'number', description: 'Monthly avatar video minutes cap for the site. Whole number 1-100000; never unlimited (0/negative rejected).' },
         maxAvatarTtsChars: { type: 'number', description: 'Monthly avatar TTS character cap (avatar_tts_chars) for the site. Whole number 1-100000000; never unlimited (0/negative rejected). Overage pricing is a platform-wide ladder, not per site.' },
       },
@@ -3374,6 +3471,7 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
         displayName: { type: 'string', description: 'Visitor-facing avatar name.' },
         backgroundMode: { type: 'string', description: 'none | color | gradient | image. "none" = explicitly no backdrop.' },
         backgroundValue: { type: 'string', description: 'Hex color, "#a,#b" gradient, or https image URL.' },
+        motionLevel: { type: 'string', enum: ['', 'off', 'subtle', 'natural', 'expressive'], description: 'Body motion preset for this group (perWorkflow ?? perGroup ?? perSite ?? natural). Empty string inherits.' },
         replace: { type: 'boolean', description: 'true = replace the whole override (omitted fields inherit) instead of merging.' },
       },
       required: ['groupId'],
@@ -3403,6 +3501,7 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
         displayName: { type: 'string' },
         backgroundMode: { type: 'string', description: 'none | color | gradient | image' },
         backgroundValue: { type: 'string' },
+        motionLevel: { type: 'string', enum: ['', 'off', 'subtle', 'natural', 'expressive'], description: 'Body motion preset for this workflow. Empty string inherits.' },
         replace: { type: 'boolean' },
       },
       required: ['workflowId'],
@@ -5246,6 +5345,11 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
     description: 'Hosted public job pages for this site: is the package included, are the pages published, and the opaque board link, sitemap, Indeed feed and Google feed URLs (the feed URLs contain a secret key). Returns { entitled, enabled, boardUrl, sitemapUrl, indeedFeedUrl, googleFeedUrl, publicApplyEnabled, eeocSelfIdAvailable, liveListings }; { entitled:false } without the package.',
     inputSchema: { type: 'object', properties: {}, required: [] },
   },
+  {
+    name: 'jobboard_applicant_accounts_status',
+    description: 'Applicant accounts on the hosted job board (applicant sign-in with an emailed one-time code, my applications, saved jobs, resume library). Returns { entitled, hostedEnabled, signInUrl, accounts, signedInLast30Days, deletionPending, savedJobs, linkedApplications } (counts only, never emails or resumes); { entitled:false } without the Job Board applicant accounts package.',
+    inputSchema: { type: 'object', properties: {}, required: [] },
+  },
   {
     name: 'jobboard_hosted_set',
     description: 'Publish or unpublish the hosted job pages (apply-if-present). enabled=true issues the opaque board link and feed key the first time. regenerateLink=true issues a NEW board link and every old hosted URL answers 404 (administrators only). Requires the Job Board hosted pages package (403 otherwise).',
@@ -5292,6 +5396,60 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: ['applicationId', 'stage'],
     },
   },
+  // -- Job Board employers + moderation (package "job-board-employers", default OFF: 403 job_board_employers_not_entitled without it) --
+  {
+    name: 'jobboard_employers_list',
+    description: 'List the employers on this site\'s job board with status, trusted flag (first posting approved), member count, live/total listings and how many listings wait for moderation. Requires the Job board employers package (403 otherwise).',
+    inputSchema: { type: 'object', properties: {}, required: [] },
+  },
+  {
+    name: 'jobboard_employer_create',
+    description: 'Create an employer on the job board (name 2-200 characters, unique per site; optional verified email domain). Administrator only. Invite its first member with jobboard_employer_invite.',
+    inputSchema: {
+      type: 'object',
+      properties: { name: { type: 'string' }, verifiedDomain: { type: 'string', description: 'Optional, e.g. example.com' } },
+      required: ['name'],
+    },
+  },
+  {
+    name: 'jobboard_employer_invite',
+    description: 'Email a single-use invitation (valid 7 days) to join an employer as Owner, Recruiter (default) or Viewer. Employers manage only their own listings and applicants and never see EEO data. Administrator only; 409 if the email already belongs to another employer or the hosted board is off.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        employerId: { type: 'number' },
+        email: { type: 'string' },
+        displayName: { type: 'string' },
+        role: { type: 'string', description: 'Owner | Recruiter | Viewer (default Recruiter)' },
+      },
+      required: ['employerId', 'email'],
+    },
+  },
+  {
+    name: 'jobboard_employer_suspend',
+    description: 'Suspend an employer: its members are signed out at once and every published listing is paused (off the public board). A reason of 3-500 characters is required. Administrator only.',
+    inputSchema: { type: 'object', properties: { employerId: { type: 'number' }, reason: { type: 'string' } }, required: ['employerId', 'reason'] },
+  },
+  {
+    name: 'jobboard_employer_reactivate',
+    description: 'Reactivate a suspended employer. Its paused listings stay paused until the employer resumes them. Administrator only.',
+    inputSchema: { type: 'object', properties: { employerId: { type: 'number' } }, required: ['employerId'] },
+  },
+  {
+    name: 'jobboard_moderation_list',
+    description: 'The moderation queue: employer listings waiting for a decision (an employer\'s first posting, or any posting that matched a scam signal such as fee requests, SSN/bank requests, gift cards, wire transfers, WhatsApp-only contact). Each item carries the matched flags. Pending listings are invisible on the public board.',
+    inputSchema: { type: 'object', properties: {}, required: [] },
+  },
+  {
+    name: 'jobboard_moderation_approve',
+    description: 'Approve a pending employer listing: it goes live, the employer becomes trusted (later clean postings publish at once), and the decision is audited. Administrator only; 409 unless the listing is waiting for moderation.',
+    inputSchema: { type: 'object', properties: { listingId: { type: 'number' } }, required: ['listingId'] },
+  },
+  {
+    name: 'jobboard_moderation_reject',
+    description: 'Reject a pending employer listing with a reason (3-500 characters) the employer will see; the listing stays hidden and the decision is audited. Administrator only.',
+    inputSchema: { type: 'object', properties: { listingId: { type: 'number' }, reason: { type: 'string' } }, required: ['listingId', 'reason'] },
+  },
   // -- Job Board pipeline (package "job-board-pipeline", default OFF: 403 job_board_pipeline_not_entitled without it, except jobboard_pipeline_get) --
   {
     name: 'jobboard_pipeline_get',
@@ -7145,6 +7303,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 +7825,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.';
@@ -8937,6 +9145,7 @@ async function handleTool(name, args) {
         `  Display name:    ${data.displayName || '(AI)'}`,
         `  Badge shown:     ${data.showBadge}`,
         `  Size:            ${data.sizePx}px`,
+        `  Body motion:     ${data.motionLevel || '(default: natural)'} @ ${data.motionIntensityPercent ?? 100}%`,
       ].join('\n');
     }
 
@@ -8952,6 +9161,11 @@ async function handleTool(name, args) {
       if (args.showBadge !== undefined) body.showBadge = args.showBadge;
       if (args.sizePx !== undefined) body.sizePx = args.sizePx;
       if (args.allowVisitorCollapse !== undefined) body.allowVisitorCollapse = args.allowVisitorCollapse;
+      if (args.motionLevel !== undefined) body.motionLevel = parseAvatarMotionLevel(args.motionLevel);
+      if (args.motionIntensityPercent !== undefined) {
+        if (!Number.isInteger(args.motionIntensityPercent) || args.motionIntensityPercent < 25 || args.motionIntensityPercent > 150) throw new Error('motionIntensityPercent must be a whole number between 25 and 150.');
+        body.motionIntensityPercent = args.motionIntensityPercent;
+      }
       for (const [arg, max] of [['maxAvatarMinutesPerMonth', 100000], ['maxAvatarTtsChars', 100000000]]) {
         if (args[arg] === undefined) continue;
         if (!Number.isInteger(args[arg]) || args[arg] < 1 || args[arg] > max) throw new Error(`${arg} must be a whole number between 1 and ${max} (never unlimited).`);
@@ -10720,6 +10934,10 @@ async function handleTool(name, args) {
       const r = await messagingGet('/Recruiting/Hosted');
       return JSON.stringify(r, null, 2);
     }
+    case 'jobboard_applicant_accounts_status': {
+      const r = await messagingGet('/Recruiting/Applicants');
+      return JSON.stringify(r, null, 2);
+    }
     case 'jobboard_hosted_set': {
       const body = {};
       if (args.enabled !== undefined) body.enabled = Boolean(args.enabled);
@@ -10758,6 +10976,55 @@ async function handleTool(name, args) {
       return JSON.stringify(r, null, 2);
     }
 
+    case 'jobboard_employers_list': {
+      return JSON.stringify(await messagingGet('/Recruiting/Employers'), null, 2);
+    }
+    case 'jobboard_employer_create': {
+      const name = String(args.name ?? '').trim();
+      if (name.length < 2 || name.length > 200) throw new Error('name must be 2 to 200 characters.');
+      const body = { name };
+      if (args.verifiedDomain !== undefined && String(args.verifiedDomain).trim()) body.verifiedDomain = String(args.verifiedDomain).trim();
+      return JSON.stringify(await messagingPost('/Recruiting/Employers', body), null, 2);
+    }
+    case 'jobboard_employer_invite': {
+      const id = Number(args.employerId);
+      if (!Number.isInteger(id) || id <= 0) throw new Error('employerId must be a positive integer.');
+      const email = String(args.email ?? '').trim();
+      if (!/^[^@\s]+@[^@\s]+\.[^@\s]{2,}$/.test(email)) throw new Error('email must be a valid email address.');
+      const role = ['Owner', 'Recruiter', 'Viewer'].find((r) => r.toLowerCase() === String(args.role ?? 'Recruiter').trim().toLowerCase());
+      if (!role) throw new Error('role must be Owner, Recruiter or Viewer.');
+      const body = { email, role };
+      if (args.displayName !== undefined && String(args.displayName).trim()) body.displayName = String(args.displayName).trim();
+      return JSON.stringify(await messagingPost(`/Recruiting/Employers/${id}/Invite`, body), null, 2);
+    }
+    case 'jobboard_employer_suspend': {
+      const id = Number(args.employerId);
+      if (!Number.isInteger(id) || id <= 0) throw new Error('employerId must be a positive integer.');
+      const reason = String(args.reason ?? '').trim();
+      if (reason.length < 3 || reason.length > 500) throw new Error('reason must be 3 to 500 characters.');
+      return JSON.stringify(await messagingPost(`/Recruiting/Employers/${id}/Suspend`, { reason }), null, 2);
+    }
+    case 'jobboard_employer_reactivate': {
+      const id = Number(args.employerId);
+      if (!Number.isInteger(id) || id <= 0) throw new Error('employerId must be a positive integer.');
+      return JSON.stringify(await messagingPost(`/Recruiting/Employers/${id}/Reactivate`, {}), null, 2);
+    }
+    case 'jobboard_moderation_list': {
+      return JSON.stringify(await messagingGet('/Recruiting/Moderation'), null, 2);
+    }
+    case 'jobboard_moderation_approve': {
+      const id = Number(args.listingId);
+      if (!Number.isInteger(id) || id <= 0) throw new Error('listingId must be a positive integer.');
+      return JSON.stringify(await messagingPost(`/Recruiting/Moderation/${id}/Approve`, {}), null, 2);
+    }
+    case 'jobboard_moderation_reject': {
+      const id = Number(args.listingId);
+      if (!Number.isInteger(id) || id <= 0) throw new Error('listingId must be a positive integer.');
+      const reason = String(args.reason ?? '').trim();
+      if (reason.length < 3 || reason.length > 500) throw new Error('reason must be 3 to 500 characters.');
+      return JSON.stringify(await messagingPost(`/Recruiting/Moderation/${id}/Reject`, { reason }), null, 2);
+    }
+
     case 'jobboard_move_application_stage': {
       const id = Number(args.applicationId);
       if (!Number.isInteger(id) || id <= 0) throw new Error('applicationId must be a positive integer.');