@velaro/cli 1.4.98 → 1.4.99

package/bin/velaro.js

@@ -26,6 +26,7 @@ import { statusCommand }     from '../lib/commands/status.js';
 import { activityCommand }   from '../lib/commands/activity.js';
 import { ruleCommand }       from '../lib/commands/rule.js';
 import { teamCommand }       from '../lib/commands/team.js';
+import { dynamicsCommand }   from '../lib/commands/dynamics.js';
 import { workflowCommand }   from '../lib/commands/workflow.js';
 import { aiConfigCommand }   from '../lib/commands/ai-config.js';
 import { deploymentCommand } from '../lib/commands/deployment.js';
@@ -39,6 +40,7 @@ import { calendlyCommand }   from '../lib/commands/calendly.js';
 import { copilotStudioCommand } from '../lib/commands/copilotstudio.js';
 import { acuityCommand }     from '../lib/commands/acuity.js';
 import { avatarCommand }     from '../lib/commands/avatar.js';
+import { imageAnalysisCommand } from '../lib/commands/image-analysis.js';
 import { integrationCommand } from '../lib/commands/integration.js';
 import { appointmentsCommand } from '../lib/commands/appointments.js';
 import { bookingCommand } from '../lib/commands/booking.js';
@@ -160,6 +162,7 @@ await yargs(hideBin(process.argv))
   .command(activityCommand)
   .command(ruleCommand)
   .command(teamCommand)
+  .command(dynamicsCommand)
   .command(workflowCommand)
   .command(aiConfigCommand)
   .command(deploymentCommand)
@@ -173,6 +176,7 @@ await yargs(hideBin(process.argv))
   .command(copilotStudioCommand)
   .command(acuityCommand)
   .command(avatarCommand)
+  .command(imageAnalysisCommand)
   .command(integrationCommand)
   .command(appointmentsCommand)
   .command(bookingCommand)

package/lib/commands/chat-intelligence-topics.js

@@ -4,14 +4,16 @@ import { runCommand } from '../run.js';
 const print = (data) => console.log(JSON.stringify(data, null, 2));
 const list = (v) => (v == null ? [] : String(v).split(',').map((s) => s.trim()).filter(Boolean));
 
-// velaro chat-topics <show|set|template|merge|rename|retire|group|group-suggestions|suggestions|accept|dismiss|
+// velaro chat-topics <show|settings|set|template|merge|rename|retire|group|group-suggestions|suggestions|accept|dismiss|
 //                     reclassify-estimate|reclassify|analysis-estimate|analysis|proposal>
 // REST: messaging /ChatIntelligenceTopics/*  (site comes from the CLI session, never an argument)
 export const chatIntelligenceTopicsCommand = {
   command: 'chat-topics <action>',
   describe: 'Chat Intelligence topics: edit the list, merge/rename/group (no AI cost), suggested topics, optional reclassify and analysis',
   builder: (y) => y
-    .positional('action', { choices: ['show', 'set', 'template', 'merge', 'rename', 'retire', 'group', 'group-suggestions', 'suggestions', 'accept', 'dismiss', 'reclassify-estimate', 'reclassify', 'analysis-estimate', 'analysis', 'proposal'] })
+    .positional('action', { choices: ['show', 'settings', 'set', 'template', 'merge', 'rename', 'retire', 'group', 'group-suggestions', 'suggestions', 'accept', 'dismiss', 'reclassify-estimate', 'reclassify', 'analysis-estimate', 'analysis', 'proposal'] })
+    .option('multi-topic', { type: 'boolean', describe: 'settings: turn multi-topic tracking on (--multi-topic) or off (--no-multi-topic); omit to just show' })
+    .option('re-eval', { type: 'number', describe: 'settings: re-check after N new visitor messages (1-50)' })
     .option('topics', { type: 'string', describe: 'set: comma-separated topic list' })
     .option('industry', { type: 'string', describe: 'template: insurance|healthcare|retail|ecommerce|financial|saas|government|manufacturing' })
     .option('from', { type: 'string', describe: 'merge/rename/retire/group: comma-separated topics' })
@@ -29,6 +31,9 @@ export const chatIntelligenceTopicsCommand = {
     const ops = (op) => messagingPost(`${base}/mapping`, { ops: [{ op, from: list(a.from), to: a.to ?? null, group: a.group ?? null }] });
     switch (a.action) {
       case 'show': return print(await messagingGet(base));
+      case 'settings':
+        if (a.multiTopic == null && a.reEval == null) return print(await messagingGet(`${base}/settings`));
+        return print(await messagingPut(`${base}/settings`, { themeMultiTopicEnabled: a.multiTopic ?? null, themeReEvalEveryNMessages: a.reEval ?? null }));
       case 'set': return print(await messagingPut(base, { topics: list(a.topics) }));
       case 'template': return print(await messagingPost(`${base}/template`, { industry: a.industry }));
       case 'merge': case 'rename': case 'retire': case 'group': return print(await ops(a.action));

package/lib/commands/dynamics.js

@@ -0,0 +1,44 @@
+import { request } from '../api.js';
+import { runCommand } from '../run.js';
+
+// ── velaro dynamics team-overrides ────────────────────────────────────────────
+// Per-team (group) override of Dynamics field mappings + activity type.
+// Effective value = team override ?? the connection's own setting ("apply to all groups" default).
+// Site is resolved server-side from the caller's credentials, never passed by the client.
+
+const base = (config) => `/Dynamics/Configs/${config}/team-overrides`;
+
+export const dynamicsCommand = {
+  command:  'dynamics <subcommand>',
+  describe: 'Dynamics 365 integration settings',
+  builder:  yargs => yargs
+    .command({
+      command:  'team-overrides <action>',
+      describe: 'Per-team overrides of field mappings / activity type (get | set | reset)',
+      builder:  y => y
+        .positional('action', { choices: ['get', 'set', 'reset'] })
+        .option('config',   { type: 'number', demandOption: true, describe: 'Dynamics config id (velaro dynamics config list in the admin UI)' })
+        .option('team',     { type: 'number', describe: 'Team id (required for set/reset; see: velaro team list)' })
+        .option('activity', { type: 'string', describe: 'Activity logical name (e.g. phonecall, task). Empty string = inherit the default.' })
+        .option('mappings', { type: 'string', describe: 'customFieldMappingsJson (JSON array). Empty string = inherit the default.' }),
+      handler:  runCommand(async argv => {
+        if (argv.action === 'get') {
+          const data = await request('GET', base(argv.config));
+          console.log(JSON.stringify(data, null, 2));
+          return;
+        }
+        if (!argv.team) throw new Error('--team is required for set/reset');
+        if (argv.action === 'reset') {
+          console.log(JSON.stringify(await request('DELETE', `${base(argv.config)}/${argv.team}`), null, 2));
+          return;
+        }
+        const body = {};
+        if (argv.activity !== undefined) body.activityLogicalName = argv.activity;
+        if (argv.mappings !== undefined) body.customFieldMappingsJson = argv.mappings;
+        if (!Object.keys(body).length) throw new Error('Pass --activity and/or --mappings (omitted fields are left unchanged).');
+        console.log(JSON.stringify(await request('PUT', `${base(argv.config)}/${argv.team}`, body), null, 2));
+      }),
+    })
+    .demandCommand(1, 'Specify a subcommand: team-overrides'),
+  handler: () => {},
+};

package/lib/commands/image-analysis.js

@@ -0,0 +1,27 @@
+import { request } from '../api.js';
+import { runCommand } from '../run.js';
+
+// velaro image-analysis limits --site N
+// Shows the Image Analysis (analyze_image) add-on cap and usage for any site (Velaro admin only).
+// To change the cap: velaro support set-limit --site N --key MaxImageAnalysesPerMonth --value 500
+export const imageAnalysisCommand = {
+  command:  'image-analysis <subcommand>',
+  describe: 'Image Analysis add-on limits and usage (Velaro admin only)',
+  builder:  yargs => yargs
+    .command({
+      command:  'limits',
+      describe: 'Show monthly cap, usage this month and per-chat cap for a site',
+      builder:  y => y.option('site', { type: 'number', demandOption: true, describe: 'Site ID' }),
+      handler:  runCommand(async argv => {
+        const d = await request('GET', `/ImageAnalysisLimits/superadmin?siteId=${argv.site}`);
+        const ent = d.entitled === null ? 'unknown' : d.entitled ? 'yes' : 'no';
+        console.log(`\nSite ${argv.site}: Image Analysis`);
+        console.log(`  Entitled:         ${ent}`);
+        console.log(`  Monthly cap:      ${d.monthlyCap} (effective ${d.effectiveMonthlyCap}, hard cap, no automatic overage)`);
+        console.log(`  Used this month:  ${d.usedThisMonth === null ? 'unknown' : d.usedThisMonth}`);
+        console.log(`  Per-chat cap:     ${d.perConversationCap}`);
+        console.log(`  Extra block size: ${d.blockSize}\n`);
+      }),
+    })
+    .demandCommand(1),
+};

package/lib/commands/quality-reports.js

@@ -108,9 +108,10 @@ export const qualityCommand = {
 export const chatIntelligenceThemesCommand = {
   command: 'chat-intelligence',
   describe: 'Chat Intelligence themes, optionally per website/team',
-  builder: (y) => scope(y.option('from', { type: 'string' }).option('to', { type: 'string' }).option('group-by', { type: 'string', default: 'month' })),
+  builder: (y) => scope(y.option('from', { type: 'string' }).option('to', { type: 'string' }).option('group-by', { type: 'string', default: 'month' }).option('include-secondary', { type: 'boolean', default: false, describe: 'Also show secondary topics (needs the site multi-topic setting on)' })),
   handler: runCommand(async (a) => {
     const qs = new URLSearchParams({ groupBy: a.groupBy });
+    if (a.includeSecondary) qs.set('includeSecondary', 'true');
     if (a.from) qs.set('startDate', a.from);
     if (a.to) qs.set('endDate', a.to);
     if (a.deployment != null) qs.set('deploymentId', String(a.deployment));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velaro/cli",
-  "version": "1.4.98",
+  "version": "1.4.99",
   "description": "Velaro Workspace v20 — command-line interface for managing bots, knowledge base ingestion, MCP API keys, search indexes, and ops health.",
   "type": "module",
   "bin": {