@velaro/cli 1.4.60 → 1.4.62

package/bin/velaro.js

@@ -39,6 +39,7 @@ import { integrationCommand } from '../lib/commands/integration.js';
 import { appointmentsCommand } from '../lib/commands/appointments.js';
 import { bookingCommand } from '../lib/commands/booking.js';
 import { reportCommand }       from '../lib/commands/report.js';
+import { scheduleAdherenceCommand } from '../lib/commands/schedule-adherence.js';
 import { conversationEfficiencyCommand } from '../lib/commands/conversation-efficiency.js';
 import { dbCommand } from '../lib/commands/db.js';
 import { focusCommand }       from '../lib/commands/focus.js';
@@ -75,6 +76,7 @@ import { subscriptionCommand }      from '../lib/commands/subscription.js';
 import { supportCommand }           from '../lib/commands/support.js';
 import { routingCommand }           from '../lib/commands/routing.js';
 import { diagnosticsCommand }       from '../lib/commands/diagnostics.js';
+import { aiSpendCommand }           from '../lib/commands/ai-spend.js';
 import { emailInboxCommand }        from '../lib/commands/email-inbox.js';
 import { callbackCommand }          from '../lib/commands/callback.js';
 import { caseCommand }              from '../lib/commands/case.js';
@@ -138,6 +140,7 @@ await yargs(hideBin(process.argv))
   .command(bookingCommand)
   .command(reportCommand)
   .command(conversationEfficiencyCommand)
+  .command(scheduleAdherenceCommand)
   .command(dbCommand)
   .command(focusCommand)
   .command(automationDraftCommand)
@@ -173,6 +176,7 @@ await yargs(hideBin(process.argv))
   .command({ command: 'support', desc: 'Staff SupportTools actions on a site (superadmin only)', builder: supportCommand, handler: () => {} })
   .command(routingCommand)
   .command(diagnosticsCommand)
+  .command(aiSpendCommand)
   .command(emailInboxCommand)
   .command(callbackCommand)
   .command(caseCommand)

package/lib/commands/ai-spend.js

@@ -0,0 +1,71 @@
+import { get, post } from '../api.js';
+
+const usd = (n) => `$${Number(n ?? 0).toFixed(2)}`;
+
+function fmtPT(ts) {
+  if (!ts) return '-';
+  return new Date(ts).toLocaleString('en-US', { timeZone: 'America/Los_Angeles', dateStyle: 'short', timeStyle: 'short' }) + ' PT';
+}
+
+const reportCommand = {
+  command: 'report',
+  describe: 'AI spend by environment (prod/staging), site, model and key source (superadmin only)',
+  builder: (y) => y
+    .option('env',  { type: 'string', default: 'both', choices: ['both', 'prod', 'staging'] })
+    .option('days', { type: 'number', default: 7 })
+    .option('json', { type: 'boolean', default: false }),
+  handler: async (argv) => {
+    const to = new Date();
+    const from = new Date(to.getTime() - argv.days * 86400000);
+    const r = await get(`SuperAdmin/AiSpend/Report?env=${argv.env}&from=${encodeURIComponent(from.toISOString())}&to=${encodeURIComponent(to.toISOString())}`);
+    if (argv.json) { console.log(JSON.stringify(r, null, 2)); return; }
+    console.log(`AI spend ${fmtPT(r.from)} to ${fmtPT(r.to)} (breaker trips: not available)`);
+    for (const e of r.environments ?? []) {
+      if (!e.available) { console.log(`\n[${e.environment}] unavailable: ${e.error}`); continue; }
+      const c = e.current;
+      console.log(`\n[${e.environment}] ${usd(c.totalEstimatedCostUsd)} / ${c.totalCalls} calls (prev ${usd(e.previous?.totalEstimatedCostUsd)}), cache read ${(e.cacheReadRatio * 100).toFixed(1)}%, QA ${e.qaSharePercent}%`);
+      (c.bySite ?? []).slice(0, 10).forEach(s => console.log(`  site ${s.siteId}: ${usd(s.estimatedCostUsd)} (${s.calls} calls)`));
+      (e.anomalies ?? []).forEach(a => console.log(`  ANOMALY site ${a.siteId}: ${a.kind} ${a.detail}`));
+    }
+  },
+};
+
+const reconcileCommand = {
+  command: 'reconcile',
+  describe: 'Record a provider console total and compare to logged spend',
+  builder: (y) => y
+    .option('env',       { type: 'string', default: 'prod', choices: ['both', 'prod', 'staging'] })
+    .option('days',      { type: 'number', default: 7 })
+    .option('provider',  { type: 'string', default: 'Anthropic' })
+    .option('key',       { type: 'string', describe: 'key bucket: platform, copilot, byok (omit for provider total)' })
+    .option('entered',   { type: 'number', demandOption: true, describe: 'console total in USD' })
+    .option('threshold', { type: 'number', default: 25 })
+    .option('notes',     { type: 'string' }),
+  handler: async (argv) => {
+    const to = new Date();
+    const from = new Date(to.getTime() - argv.days * 86400000);
+    const r = await post('SuperAdmin/AiSpend/Reconciliations', {
+      periodStartUtc: from.toISOString(), periodEndUtc: to.toISOString(), environment: argv.env,
+      provider: argv.provider, keyLabel: argv.key ?? null, enteredUsd: argv.entered, thresholdUsd: argv.threshold, notes: argv.notes ?? null,
+    });
+    console.log(`logged ${usd(r.loggedUsd)} vs console ${usd(r.enteredUsd)}: gap ${usd(r.gapUsd)} (${r.gapPercent ?? 'n/a'}%)${r.unloggedSpendFlagged ? '  FLAG: unlogged spend' : ''}`);
+  },
+};
+
+const historyCommand = {
+  command: 'history',
+  describe: 'List saved reconciliations',
+  builder: (y) => y,
+  handler: async () => {
+    const rows = await get('SuperAdmin/AiSpend/Reconciliations?take=50');
+    for (const r of rows) console.log(`${fmtPT(r.createdUtc)}  ${r.environment}  ${r.provider}${r.keyLabel ? '/' + r.keyLabel : ''}  logged ${usd(r.loggedUsd)}  console ${usd(r.enteredUsd)}  gap ${usd(r.gapUsd)}${r.unloggedSpendFlagged ? '  FLAG' : ''}`);
+  },
+};
+
+export const aiSpendCommand = {
+  command: 'ai-spend <subcommand>',
+  describe: 'AI spend report and provider reconciliation (superadmin only)',
+  builder: (y) => y.command(reportCommand).command(reconcileCommand).command(historyCommand)
+    .demandCommand(1, 'Specify a subcommand: report, reconcile, history').strict(),
+  handler: () => {},
+};

package/lib/commands/schedule-adherence.js

@@ -0,0 +1,33 @@
+import { messagingGet } from '../api.js';
+import { runCommand } from '../run.js';
+
+// -- velaro schedule-adherence --------------------------------------------------
+// Staff-only. siteId is an EXPLICIT argument (SupportTools-style), never derived from the caller.
+// Backend: velaro-messaging GET /Reports/sites/{siteId}/schedule-adherence-diagnostics
+// (IsSuperAdminAsync allowSupport gate; role=agent requires agentId, fails closed).
+
+export const scheduleAdherenceCommand = {
+  command:  'schedule-adherence <siteId>',
+  describe: 'Staff: schedule adherence overview/breakdown/intraday/timeline for a site as manager or agent',
+  builder:  (y) => y
+    .positional('siteId', { type: 'number', describe: 'Target customer site ID' })
+    .option('role', { type: 'string', choices: ['manager', 'agent'], default: 'manager', describe: 'Scope to apply' })
+    .option('agent-id', { type: 'number', describe: 'WorkspaceUser id (required for --role agent)' })
+    .option('start', { type: 'string', describe: 'yyyy-MM-dd' })
+    .option('end', { type: 'string', describe: 'yyyy-MM-dd' })
+    .option('tz', { type: 'string', describe: 'IANA time zone override' })
+    .option('json', { type: 'boolean', default: false, describe: 'Raw JSON output' }),
+  handler:  runCommand(async (argv) => {
+    if (argv.role === 'agent' && !argv.agentId) throw new Error('--agent-id is required with --role agent');
+    const qs = new URLSearchParams({ detail: 'true', role: argv.role });
+    if (argv.agentId) qs.set('agentId', String(argv.agentId));
+    for (const k of ['start', 'end', 'tz']) if (argv[k]) qs.set(k, argv[k]);
+    const d = await messagingGet(`/Reports/sites/${argv.siteId}/schedule-adherence-diagnostics?${qs}`);
+    if (argv.json) { console.log(JSON.stringify(d, null, 2)); return; }
+    console.log(`\nSite ${d.siteId} scope=${d.scope} ${d.range?.start}..${d.range?.end} tz=${d.timeZone} invariantsPass=${d.invariantsPass}`);
+    console.log(`  Totals: sched ${d.totals?.scheduledMinutes}m adherent ${d.totals?.adherentMinutes}m avg ${d.totals?.avgAdherencePercent}%`);
+    for (const a of d.agents ?? []) {
+      console.log(`  [${a.agentId}] ${a.agentName}: ${a.adherencePercent}% status=${a.currentStatus ?? '-'} days=${a.days?.length ?? 0} shiftsToday=${a.timeline?.shifts?.length ?? 0}`);
+    }
+  }),
+};

package/lib/commands/scraper.js

@@ -18,10 +18,21 @@ async function usage(argv) {
   for (const note of u.notes ?? []) console.log(`  Note: ${note}`);
 }
 
+async function verifyToken(argv) {
+  const t = await request('GET', 'ScraperJobs/VerifyToken');
+  if (argv.json) { console.log(JSON.stringify(t, null, 2)); return; }
+  console.log('\nScraper verification (give this to your web host to allowlist our crawler)');
+  console.log(`  Header:     ${t.header_name}: ${t.header_value}`);
+  console.log(`  Scraper IP: ${t.scraper_ip}`);
+  if (t.instructions) console.log(`\n${t.instructions}`);
+}
+
 export function scraperCommand(yargs) {
   return yargs
     .command('usage', 'Show scraper/upload/chunk usage for a site (staff only)', (y) => y
       .option('site', { type: 'number', demandOption: true, describe: 'Target site id' })
       .option('json', { type: 'boolean', describe: 'Print raw JSON' }), (a) => usage(a))
-    .demandCommand(1, 'Specify a subcommand: usage');
+    .command('verify-token', 'Show your scraper verification header + IP for web-host allowlisting', (y) => y
+      .option('json', { type: 'boolean', describe: 'Print raw JSON' }), (a) => verifyToken(a))
+    .demandCommand(1, 'Specify a subcommand: usage, verify-token');
 }

package/package.json

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