@velaro/mcp-server 0.6.92 → 0.6.94

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velaro/mcp-server",
-  "version": "0.6.92",
+  "version": "0.6.94",
   "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": {
@@ -10,7 +10,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@modelcontextprotocol/sdk": "^1.32.1",
     "qs": "^6.16.0"
   },
   "overrides": {

package/server.js

@@ -151,6 +151,18 @@ function extractLogEntries(response) {
   return [];
 }
 
+/**
+ * Body for PUT avatar/groups|workflows/{id}/override. Merge by default (only passed fields change, "" clears one);
+ * `replace: true` replaces the whole override. Mirrors cli/lib/commands/avatar.js.
+ */
+function avatarOverrideBody(args) {
+  const body = { merge: args.replace !== true };
+  for (const k of ['providerSlug', 'avatarId', 'personalityPresetSlug', 'voiceId', 'displayName', 'backgroundMode', 'backgroundValue']) {
+    if (args[k] !== undefined) body[k] = args[k];
+  }
+  return body;
+}
+
 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.'
@@ -1048,6 +1060,7 @@ Key node shapes:
     propName:"myAnswerVar" }                      // variable that stores the result as JSON array string
 • condition:      { type:"action", actionType:"condition", conditionOptions:[...] }
 • transferToAI:   { type:"action", actionType:"transferToAI", aiConfigId:N }
+  AI follow-up suggestions ("AI mode"): add suggestFollowUps:true|false (omit = use the account default, set via ai_followups_site_set), suggestFollowUpCount:2-4, suggestFollowUpInstruction:"<=300 chars". After each web-chat bot reply the bot offers short tappable follow-up replies; typing stays available.
 
 For multiSelect dynamic options: the variable named in dynamicOptionsVariable must contain a JSON array like [{"label":"Red","value":"red"},{"label":"Blue","value":"blue"}]. Populate it via an HTTP Request node before the ask node.`,
     inputSchema: {
@@ -1061,6 +1074,20 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
     },
   },
 
+  {
+    name: 'ai_followups_site_get',
+    description: "Read this account's default for AI follow-up suggestions (the AI Chatbot node's \"AI mode\": after each web-chat bot reply the bot offers 2-4 short tappable follow-up replies). A node's own suggestFollowUps setting wins over this default; platform default is off.",
+    inputSchema: { type: 'object', properties: {}, required: [] },
+  },
+  {
+    name: 'ai_followups_site_set',
+    description: "Set this account's default for AI follow-up suggestions. enabled=true/false, or omit/null to clear (platform default: off). Per-node settings (workflow_update_node: suggestFollowUps) override this. Returns the value read back from the server.",
+    inputSchema: {
+      type: 'object',
+      properties: { enabled: { type: ['boolean', 'null'], description: 'true = on, false = off, null/omitted = clear' } },
+      required: [],
+    },
+  },
   // ── Surveys ──────────────────────────────────────────────────────────────
   {
     name: 'survey_list',
@@ -1594,10 +1621,28 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
         },
         buttonLabel: { type: 'string', description: 'Optional action button label' },
         buttonUrl:   { type: 'string', description: 'Optional action button URL (required if buttonLabel is set)' },
+        mentions:    { type: 'array', description: 'People to @mention (real Teams notification). Velaro staff only. Uses the ops Teams sender instead of a webhook.', items: { type: 'object', properties: { user: { type: 'string', description: 'Entra object id or UPN, e.g. andrea@velaro.com' }, name: { type: 'string', description: 'Display name shown in the @mention' } }, required: ['user'] } },
+        destination: { type: 'string', description: 'Named channel in the DevOps team instead of General: prs, workflows, deploys, alerts, qa, general. Velaro staff only; uses the ops Teams sender instead of a webhook.' },
       },
       required: ['title'],
     },
   },
+  {
+    name: 'teams_send_direct',
+    description: 'Send a 1:1 Teams message (Adaptive Card) directly to any user in the Velaro tenant by UPN/email or Entra object id. Velaro staff only. Graph chat first, Velaro Bot proactive fallback.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        user:        { type: 'string', description: 'UPN/email (alex@velaro.com) or Entra object id' },
+        title:       { type: 'string', description: 'Card title' },
+        message:     { type: 'string', description: 'Message text' },
+        fields:      { type: 'array', description: 'Optional fact rows', items: { type: 'object', properties: { label: { type: 'string' }, value: { type: 'string' } }, required: ['label', 'value'] } },
+        buttonLabel: { type: 'string', description: 'Optional button label' },
+        buttonUrl:   { type: 'string', description: 'Optional button URL' },
+      },
+      required: ['user', 'title'],
+    },
+  },
 
   // ── Slack ─────────────────────────────────────────────────────────────────
   {
@@ -1682,6 +1727,8 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
         v20_site_id:    { type: 'number', description: 'V20 site ID to migrate TO (defaults to the authenticated site)' },
         dry_run:        { type: 'boolean', description: 'Preview what would be created without creating. Default: false.' },
         enable:         { type: 'boolean', description: 'Enable created workflows immediately. Default: false.' },
+        include_non_routing: { type: 'boolean', description: 'Also migrate v10 rules with IsRouting=false (group-assignment rules). Default: false.' },
+        route_bot_groups_to_team: { type: 'boolean', description: 'Route to the v20 team named after the v10 group even if it had a v10 bot. Default: false.' },
         team_mappings:  { type: 'array',  description: 'Override auto-resolution: [{v10GroupId, v20TeamId}]', items: { type: 'object' } },
         ai_config_mappings: { type: 'array', description: 'Override auto-resolution: [{v10GroupId, v20AiConfigId}]', items: { type: 'object' } },
       },
@@ -1696,10 +1743,25 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       properties: {
         v10_site_id: { type: 'number', description: 'V10 (Livefluence) site ID' },
         v20_site_id: { type: 'number', description: 'V20 site ID to match against (for name suggestions)' },
+        include_non_routing: { type: 'boolean', description: 'Also include v10 rules with IsRouting=false. Default: false.' },
       },
       required: ['v10_site_id'],
     },
   },
+  {
+    name: 'livefluence_create_teams',
+    description: 'Copy v10 (Livefluence) groups to v20 teams on a site. v10 is read-only; idempotent by name; "Default Group" maps to the site default team; members are not copied. Use dry_run=true first.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        v10_site_id: { type: 'number', description: 'V10 (Livefluence) site ID to copy FROM' },
+        v20_site_id: { type: 'number', description: 'V20 site ID to create teams on' },
+        group_names: { type: 'array', items: { type: 'string' }, description: 'Group names to copy (default: every non-deleted v10 group)' },
+        dry_run:     { type: 'boolean', description: 'Preview without creating. Default: false.' },
+      },
+      required: ['v10_site_id', 'v20_site_id'],
+    },
+  },
 
   // ── Smart Routing Engine ──────────────────────────────────────────────────
   {
@@ -3057,7 +3119,7 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
     inputSchema: {
       type: 'object',
       properties: {
-        report:       { type: 'string', enum: ['program_breakdown', 'agent_scorecard', 'qa_coverage', 'coaching_queue', 'sentiment_breakdown', 'topic_radar', 'weekly_brief', 'weekly_brief_send_test'] },
+        report:       { type: 'string', enum: ['program_breakdown', 'agent_scorecard', 'qa_coverage', 'coaching_queue', 'sentiment_breakdown', 'topic_radar', 'weekly_brief', 'weekly_brief_send_test', 'repeat_contact', 'demand_coverage', 'bot_containment', 'effort_index', 'promise_ledger', 'promise_dismiss'] },
         from:         { type: 'string', description: 'yyyy-MM-dd start (default: 30 days ago).' },
         to:           { type: 'string', description: 'yyyy-MM-dd end, inclusive (default: today).' },
         groupBy:      { type: 'string', description: 'program_breakdown: website|team|platform|device|entrypage. sentiment_breakdown: website|team|agent|theme.' },
@@ -3067,6 +3129,14 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
         perAgent:     { type: 'number', description: 'coaching_queue: chats listed per agent (default 5).' },
         limit:        { type: 'number', description: 'topic_radar: max topics (default 25).' },
         days:         { type: 'number', description: 'weekly_brief: days to cover (default 7).' },
+        windowDays:   { type: 'number', description: 'repeat_contact: days a contact has to come back to count as a repeat (1-30, default 7).' },
+        weeks:        { type: 'number', description: 'demand_coverage: whole local weeks of history (1-12, default 6). from/to are IGNORED by demand_coverage.' },
+        handleMinutes: { type: 'number', description: 'demand_coverage: assumed minutes per chat (1-120, default 10).' },
+        maxConcurrent: { type: 'number', description: 'demand_coverage: assumed chats an agent handles at once (1-10, default 3).' },
+        timeZone:     { type: 'string', description: 'demand_coverage: IANA time zone (default America/Los_Angeles).' },
+        lowScore:     { type: 'number', description: 'bot_containment: QA score below which a handed-off chat counts as regret (1-100, default 60).' },
+        includeDemo:  { type: 'boolean', description: 'true = show only the seeded sample (demo) data. Default false.' },
+        promiseId:    { type: 'string', description: 'promise_dismiss: the promise id to dismiss (managers only).' },
       },
       required: ['report'],
     },
@@ -3287,19 +3357,24 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
   },
   {
     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'] },
+    description: 'Show the effective avatar settings (person, personality, voice, display name, backdrop) for a group, layered perWorkflow ?? perGroup ?? perSite. Pass workflowId too to see what a conversation in that workflow inside that group gets. Also returns whether each override exists.',
+    inputSchema: { type: 'object', properties: { groupId: { type: 'number', description: 'Team (group) id.' }, workflowId: { type: 'number', description: 'Optional workflow id to layer on top of the group.' } }, required: ['groupId'] },
   },
   {
     name: 'avatar_set_group_override',
-    description: 'Override avatar/personality/provider for one group. Omitted fields inherit the site default.',
+    description: 'Override the avatar person/personality/voice/display name/backdrop for one group (a group is a Team). Only the fields you pass change (merge); pass an empty string to clear one field back to the site default. A library avatarId always uses the velaro provider. Backdrop: backgroundMode none|color|gradient|image with backgroundValue (hex, "#a,#b", or an https image URL).',
     inputSchema: {
       type: 'object',
       properties: {
         groupId: { type: 'number' },
         providerSlug: { type: 'string' },
-        avatarId: { type: 'string' },
+        avatarId: { type: 'string', description: 'Library slug (see avatar_list_library), e.g. priya.' },
         personalityPresetSlug: { type: 'string' },
+        voiceId: { type: 'string', description: 'ElevenLabs voice id.' },
+        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.' },
+        replace: { type: 'boolean', description: 'true = replace the whole override (omitted fields inherit) instead of merging.' },
       },
       required: ['groupId'],
     },
@@ -3309,9 +3384,38 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
     description: 'Reset one group to the site default avatar settings (removes its override).',
     inputSchema: { type: 'object', properties: { groupId: { type: 'number' } }, required: ['groupId'] },
   },
+  {
+    name: 'avatar_get_workflow_effective',
+    description: 'Show the effective avatar settings for a workflow (workflow override, else its group, else site). Pass groupId to include a group override beneath the workflow.',
+    inputSchema: { type: 'object', properties: { workflowId: { type: 'number' }, groupId: { type: 'number' } }, required: ['workflowId'] },
+  },
+  {
+    name: 'avatar_set_workflow_override',
+    description: 'Override the avatar person/personality/voice/display name/backdrop for one workflow (wins over its group and the site). Same fields and merge semantics as avatar_set_group_override. Example: library avatar priya with the Timken HR office backdrop https://admin.velaro.com/avatar-backdrops/timken-hr-office.png for the recruiter workflow.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        workflowId: { type: 'number' },
+        providerSlug: { type: 'string' },
+        avatarId: { type: 'string' },
+        personalityPresetSlug: { type: 'string' },
+        voiceId: { type: 'string' },
+        displayName: { type: 'string' },
+        backgroundMode: { type: 'string', description: 'none | color | gradient | image' },
+        backgroundValue: { type: 'string' },
+        replace: { type: 'boolean' },
+      },
+      required: ['workflowId'],
+    },
+  },
+  {
+    name: 'avatar_reset_workflow',
+    description: 'Reset one workflow to its group / site default avatar settings (removes its override).',
+    inputSchema: { type: 'object', properties: { workflowId: { type: 'number' } }, required: ['workflowId'] },
+  },
   {
     name: 'avatar_reset_all_overrides',
-    description: 'Reset ALL group overrides for the calling site back to the site default.',
+    description: 'Reset ALL group and workflow overrides for the calling site back to the site default.',
     inputSchema: { type: 'object', properties: {} },
   },
 
@@ -3750,6 +3854,15 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: [],
     },
   },
+  {
+    name: 'ai_federation',
+    description: 'SuperAdmin: Anthropic Workload Identity Federation for the AI gateway. action=status shows enabled, circuit breaker state, last success/failure reason, federated vs API-key fallback counts and token expiry. action=test does a real token exchange plus a 1-token Haiku message and reports which path (federated, apikey, apikey-fallback) served it. action=reset_breaker closes the breaker so the next call retries federation.',
+    inputSchema: {
+      type: 'object',
+      properties: { action: { type: 'string', enum: ['status', 'test', 'reset_breaker'], description: 'Default status.' } },
+      required: [],
+    },
+  },
   {
     name: 'status_incident_list',
     description: 'Velaro staff only (SuperAdmin). Lists public status page incidents, including component overrides (IncidentType "Override").',
@@ -4998,6 +5111,7 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       properties: {
         publicApplyEnabled: { type: 'boolean' },
         autoCreateCaseTypeId: { type: 'number', description: 'Case type id; 0 clears the auto-create link' },
+        defaultListingDays: { type: 'number', description: '1-365: how many days a new listing stays live when its feed gives no expiry. Requires the Job Board lifecycle package.' },
       },
       required: [],
     },
@@ -5103,6 +5217,68 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
       required: ['sourceId', 'title'],
     },
   },
+  // -- Job Board listing lifecycle (package "job-board-lifecycle", default OFF: 403 for a site without it) --
+  {
+    name: 'jobboard_lifecycle_status',
+    description: 'Does this site have the Job Board listing lifecycle package (close/renew, expiry, JSON-LD listing pages), and what is its default listing duration? Returns { entitled, defaultListingDays }.',
+    inputSchema: { type: 'object', properties: {}, required: [] },
+  },
+  {
+    name: 'jobboard_close_listing',
+    description: 'Close a job listing: it stops appearing in search and the public board, the public listing page answers 410, and applying to it answers 410. Idempotent. Requires the Job Board lifecycle package (403 otherwise); 404 for an id that is not on this site.',
+    inputSchema: { type: 'object', properties: { listingId: { type: 'number' } }, required: ['listingId'] },
+  },
+  {
+    name: 'jobboard_renew_listing',
+    description: 'Renew a job listing: extends its expiry by `days` (default: the site\'s default listing days) from the later of its current expiry and now, increments its renewal count and republishes it if it was closed or expired. Requires the Job Board lifecycle package (403 otherwise).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        listingId: { type: 'number' },
+        days: { type: 'number', description: '1-365; omit for the site default' },
+      },
+      required: ['listingId'],
+    },
+  },
+  // -- Job Board hosted pages (package "job-board-hosted", default OFF: 403 for a site without it) --
+  {
+    name: 'jobboard_hosted_status',
+    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_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).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        enabled: { type: 'boolean' },
+        regenerateLink: { type: 'boolean', description: 'Retire the current board link and issue a new one (administrators only)' },
+      },
+      required: [],
+    },
+  },
+  {
+    name: 'jobboard_rotate_feed_key',
+    description: 'Rotate the outbound feed key: the current Indeed and Google feed URLs stop working immediately and the response carries the new ones. Administrators only; requires the Job Board hosted pages package (403 otherwise).',
+    inputSchema: { type: 'object', properties: {}, required: [] },
+  },
+  {
+    name: 'jobboard_set_listing_pay',
+    description: 'Set or clear the pay range of a job listing (pay transparency): shown on the hosted page and in its schema.org baseSalary. A manual value is never overwritten by a feed sync. Pass clear=true to remove it. Requires the Job Board hosted pages package (403 otherwise); 404 for an id that is not on this site.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        listingId: { type: 'number' },
+        min: { type: 'number', description: 'Minimum (or only) amount, greater than 0' },
+        max: { type: 'number', description: 'Maximum amount, at least min (optional)' },
+        currency: { type: 'string', description: '3-letter ISO code, default USD' },
+        period: { type: 'string', description: 'Hour | Day | Week | Month | Year' },
+        clear: { type: 'boolean', description: 'Remove the stated pay' },
+      },
+      required: ['listingId'],
+    },
+  },
   {
     name: 'jobboard_move_application_stage',
     description: 'Move a candidate application to a new HR/agency-side pipeline stage on the applicant Kanban board (Applied, Screened, Interview, Offer, Hired, Rejected).',
@@ -5994,6 +6170,17 @@ async function handleTool(name, args) {
     // [Authorize] does not accept vel_live_* service keys (only a handful of controllers opt
     // into that manually) — these tools need VELARO_JWT, same requirement as the existing
     // notifications_get/ai_config_staff_get tools they're modeled on.
+    case 'ai_followups_site_get': {
+      const r = await messagingGet('/SiteSettings/AiFollowUps');
+      return JSON.stringify({ enabled: r?.enabled ?? null }, null, 2);
+    }
+
+    case 'ai_followups_site_set': {
+      await messagingPut('/SiteSettings/AiFollowUps', { enabled: typeof args.enabled === 'boolean' ? args.enabled : null });
+      const r = await messagingGet('/SiteSettings/AiFollowUps');
+      return JSON.stringify({ enabled: r?.enabled ?? null }, null, 2);
+    }
+
     case 'survey_list': {
       const surveys = (await messagingGet('/Surveys/list')) ?? [];
       if (!surveys.length) return 'No surveys found.';
@@ -6492,7 +6679,26 @@ async function handleTool(name, args) {
       return await api('PUT', '/TeamsBot/ChannelConfig', body);
     }
 
+    case 'teams_send_direct': {
+      const r = await api('POST', '/TeamsMessaging/Direct', {
+        user: args.user, title: args.title, message: args.message || '',
+        facts: (args.fields || []).map(f => ({ label: f.label, value: f.value })),
+        actionUrl: args.buttonUrl, actionLabel: args.buttonLabel,
+      });
+      return r?.sent ? `Direct message sent to ${args.user} via ${r.path}.` : `Send failed: ${r?.error || 'unknown error'} ${(r?.warnings || []).join('; ')}`;
+    }
+
     case 'teams_notify_card': {
+      if ((args.mentions && args.mentions.length) || args.destination) {
+        const r = await api('POST', '/TeamsMessaging/Card', {
+          title: args.title,
+          facts: (args.fields || []).map(f => ({ label: f.label, value: f.value })),
+          actionUrl: args.buttonUrl, actionLabel: args.buttonLabel,
+          destination: args.destination,
+          mentions: (args.mentions || []).map(m => ({ user: m.user, name: m.name })),
+        });
+        return r?.sent ? `Card sent via ${r.path}${r.warnings?.length ? ' (' + r.warnings.join('; ') + ')' : ''}.` : `Send failed: ${r?.error || 'unknown error'}`;
+      }
       const webhooks = await api('GET', '/TeamsNotification');
       if (!Array.isArray(webhooks) || !webhooks.length)
         return 'No Teams webhooks configured. Go to Integrations → Microsoft Teams to add one, or call velaro teams create <name> <webhookUrl> via CLI.';
@@ -6820,7 +7026,10 @@ async function handleTool(name, args) {
 
     // ── Livefluence Migration ──────────────────────────────────────────────
     case 'livefluence_export': {
-      const qs = args.v20_site_id ? `?v20SiteId=${args.v20_site_id}` : '';
+      const params = [];
+      if (args.v20_site_id) params.push(`v20SiteId=${args.v20_site_id}`);
+      if (args.include_non_routing) params.push('includeNonRouting=true');
+      const qs = params.length ? `?${params.join('&')}` : '';
       const data = await api('GET', `/DatabaseTool/V10Export/${args.v10_site_id}${qs}`);
       const lines = [
         `V10 Site ${data.v10SiteId} — ${data.ruleCount} routing rule(s), ${data.groupCount} group(s)`,
@@ -6845,6 +7054,16 @@ async function handleTool(name, args) {
       return lines.join('\n');
     }
 
+    case 'livefluence_create_teams': {
+      const result = await api('POST', '/DatabaseTool/V10CreateTeams', {
+        v10SiteId:  args.v10_site_id,
+        v20SiteId:  args.v20_site_id,
+        dryRun:     args.dry_run ?? false,
+        groupNames: args.group_names ?? [],
+      });
+      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,
@@ -6858,6 +7077,8 @@ async function handleTool(name, args) {
         v20SiteId:        args.v20_site_id ?? null,
         dryRun:           args.dry_run  ?? false,
         enable:           args.enable   ?? false,
+        includeNonRouting:    args.include_non_routing ?? false,
+        routeBotGroupsToTeam: args.route_bot_groups_to_team ?? false,
         teamMappings:     args.team_mappings     ?? [],
         aiConfigMappings: args.ai_config_mappings ?? [],
       });
@@ -6873,6 +7094,7 @@ async function handleTool(name, args) {
         for (const item of result.createdItems) {
           lines.push(`  [#${item.priority}] ${item.ruleName}${item.workflowId ? ` → id=${item.workflowId}` : ''}`);
           lines.push(`    Action: ${item.action}${item.v2AiConfigId ? `, aiConfigId=${item.v2AiConfigId}` : ''}${item.v2TeamId ? `, teamId=${item.v2TeamId}` : ''}`);
+          for (const u of item.unconverted ?? []) lines.push(`    not converted: ${u}`);
         }
         lines.push('');
       }
@@ -8485,12 +8707,18 @@ async function handleTool(name, args) {
         program_breakdown: 'program-breakdown', agent_scorecard: 'agent-scorecard', qa_coverage: 'qa-coverage',
         coaching_queue: 'coaching-queue', sentiment_breakdown: 'sentiment-breakdown', topic_radar: 'topic-radar',
         weekly_brief: 'weekly-brief', weekly_brief_send_test: 'weekly-brief/send-test',
+        repeat_contact: 'repeat-contact', demand_coverage: 'demand-coverage', bot_containment: 'bot-containment',
+        effort_index: 'effort-index', promise_ledger: 'promise-ledger',
       };
+      if (args.report === 'promise_dismiss') {
+        if (!args.promiseId) throw new Error('promiseId is required for promise_dismiss');
+        return JSON.stringify(await messagingPost('/api/enterprise-reports/promise-ledger/' + encodeURIComponent(String(args.promiseId)) + '/dismiss', {}), null, 2);
+      }
       const seg = ER_PATHS[args.report];
       if (!seg) throw new Error('report must be one of: ' + Object.keys(ER_PATHS).join(', '));
       if (args.report === 'weekly_brief_send_test') return JSON.stringify(await messagingPost('/api/enterprise-reports/' + seg, {}), null, 2);
       const qs = new URLSearchParams();
-      for (const k of ['from', 'to', 'groupBy', 'deploymentId', 'teamId', 'threshold', 'perAgent', 'limit', 'days']) {
+      for (const k of ['from', 'to', 'groupBy', 'deploymentId', 'teamId', 'threshold', 'perAgent', 'limit', 'days', 'windowDays', 'weeks', 'handleMinutes', 'maxConcurrent', 'timeZone', 'lowScore', 'includeDemo']) {
         if (args[k] != null && args[k] !== '') qs.set(k, String(args[k]));
       }
       const q = qs.toString();
@@ -8661,12 +8889,17 @@ async function handleTool(name, args) {
       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);
+      return JSON.stringify(await messagingRequest('GET', `/avatar/groups/${Number(args.groupId)}/effective${args.workflowId != null ? `?workflowId=${Number(args.workflowId)}` : ''}`), 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);
+      return JSON.stringify(await messagingRequest('PUT', `/avatar/groups/${Number(args.groupId)}/override`, avatarOverrideBody(args)), null, 2);
     case 'avatar_reset_group':
       return JSON.stringify(await messagingRequest('DELETE', `/avatar/groups/${Number(args.groupId)}/override`), null, 2);
+    case 'avatar_get_workflow_effective':
+      return JSON.stringify(await messagingRequest('GET', `/avatar/workflows/${Number(args.workflowId)}/effective${args.groupId != null ? `?groupId=${Number(args.groupId)}` : ''}`), null, 2);
+    case 'avatar_set_workflow_override':
+      return JSON.stringify(await messagingRequest('PUT', `/avatar/workflows/${Number(args.workflowId)}/override`, avatarOverrideBody(args)), null, 2);
+    case 'avatar_reset_workflow':
+      return JSON.stringify(await messagingRequest('DELETE', `/avatar/workflows/${Number(args.workflowId)}/override`), null, 2);
     case 'avatar_reset_all_overrides':
       return JSON.stringify(await messagingRequest('POST', '/avatar/group-overrides/reset-all', {}), null, 2);
 
@@ -8908,6 +9141,13 @@ async function handleTool(name, args) {
       return JSON.stringify(data, null, 2);
     }
 
+    case 'ai_federation': {
+      const action = args.action || 'status';
+      if (action === 'test') return JSON.stringify(await api('POST', '/AiFederation/test', {}), null, 2);
+      if (action === 'reset_breaker') return JSON.stringify(await api('POST', '/AiFederation/reset-breaker', {}), null, 2);
+      return JSON.stringify(await api('GET', '/AiFederation/status'), null, 2);
+    }
+
     case 'status_incident_list': {
       const rows = await messagingRequest('GET', `/superadmin/status-incidents?filter=${encodeURIComponent(args.filter || 'active')}`);
       return JSON.stringify(rows, null, 2);
@@ -10330,7 +10570,12 @@ async function handleTool(name, args) {
         if (!Number.isInteger(n) || n < 0) throw new Error('autoCreateCaseTypeId must be an integer >= 0 (0 clears).');
         body.autoCreateCaseTypeId = n;
       }
-      if (!Object.keys(body).length) throw new Error('Specify publicApplyEnabled and/or autoCreateCaseTypeId.');
+      if (args.defaultListingDays !== undefined) {
+        const d = Number(args.defaultListingDays);
+        if (!Number.isInteger(d) || d < 1 || d > 365) throw new Error('defaultListingDays must be an integer from 1 to 365.');
+        body.defaultListingDays = d;
+      }
+      if (!Object.keys(body).length) throw new Error('Specify publicApplyEnabled, autoCreateCaseTypeId and/or defaultListingDays.');
       const r = await messagingPut('/Recruiting/ApplySettings', body);
       return JSON.stringify(r, null, 2);
     }
@@ -10367,6 +10612,71 @@ async function handleTool(name, args) {
       }, null, 2);
     }
 
+    case 'jobboard_lifecycle_status': {
+      const r = await messagingGet('/Recruiting/Lifecycle');
+      return JSON.stringify(r, null, 2);
+    }
+    case 'jobboard_close_listing': {
+      const id = Number(args.listingId);
+      if (!Number.isInteger(id) || id <= 0) throw new Error('listingId must be a positive integer.');
+      const r = await messagingPost(`/Recruiting/Jobs/${id}/close`, {});
+      return JSON.stringify(r, null, 2);
+    }
+    case 'jobboard_renew_listing': {
+      const id = Number(args.listingId);
+      if (!Number.isInteger(id) || id <= 0) throw new Error('listingId must be a positive integer.');
+      const body = {};
+      if (args.days !== undefined) {
+        const d = Number(args.days);
+        if (!Number.isInteger(d) || d < 1 || d > 365) throw new Error('days must be an integer from 1 to 365.');
+        body.days = d;
+      }
+      const r = await messagingPost(`/Recruiting/Jobs/${id}/renew`, body);
+      return JSON.stringify(r, null, 2);
+    }
+
+    case 'jobboard_hosted_status': {
+      const r = await messagingGet('/Recruiting/Hosted');
+      return JSON.stringify(r, null, 2);
+    }
+    case 'jobboard_hosted_set': {
+      const body = {};
+      if (args.enabled !== undefined) body.enabled = Boolean(args.enabled);
+      if (args.regenerateLink) body.regenerateSlug = true;
+      if (!Object.keys(body).length) throw new Error('Specify enabled and/or regenerateLink (use jobboard_hosted_status to read).');
+      const r = await messagingPut('/Recruiting/Hosted', body);
+      return JSON.stringify(r, null, 2);
+    }
+    case 'jobboard_rotate_feed_key': {
+      const r = await messagingPost('/Recruiting/Hosted/FeedKey/Rotate', {});
+      return JSON.stringify(r, null, 2);
+    }
+    case 'jobboard_set_listing_pay': {
+      const id = Number(args.listingId);
+      if (!Number.isInteger(id) || id <= 0) throw new Error('listingId must be a positive integer.');
+      let body;
+      if (args.clear) {
+        body = { clear: true };
+      } else {
+        const lo = Number(args.min);
+        if (args.min === undefined || !Number.isFinite(lo) || lo <= 0) throw new Error('min must be a number greater than 0 (or pass clear=true).');
+        body = { salaryMin: lo };
+        if (args.max !== undefined) {
+          const hi = Number(args.max);
+          if (!Number.isFinite(hi) || hi < lo) throw new Error('max must be a number greater than or equal to min.');
+          body.salaryMax = hi;
+        }
+        const cur = String(args.currency ?? 'USD').trim().toUpperCase();
+        if (!/^[A-Z]{3}$/.test(cur)) throw new Error('currency must be a 3-letter ISO code such as USD.');
+        body.salaryCurrency = cur;
+        const per = ['Hour', 'Day', 'Week', 'Month', 'Year'].find((p) => p.toLowerCase() === String(args.period ?? '').trim().toLowerCase());
+        if (!per) throw new Error('period must be one of: Hour, Day, Week, Month, Year.');
+        body.salaryPeriod = per;
+      }
+      const r = await messagingPut(`/Recruiting/Jobs/${id}/Pay`, body);
+      return JSON.stringify(r, null, 2);
+    }
+
     case 'jobboard_move_application_stage': {
       const app = await messagingPut(`/Recruiting/Applications/${args.applicationId}/Stage`, { stage: args.stage });
       return JSON.stringify(app, null, 2);