wldx-cli 1.0.0 → 1.2.0

package/src/commands/reports.mjs

@@ -2,29 +2,77 @@
 // x-caracal service of WDA, and the list of the queues. Read only. Counts, never percentages from the service: a
 // rate is computed from the counts (in the text only). A report covers one PBX: the one named by --pbx, else the
 // PBX of the first --queue (its id is <company>_<pbx>_<number>), else the PBX of the login.
-import {UsageError} from '../errors.mjs';
-import {localTime, oneLine, table} from '../format.mjs';
-import {apiPath, query} from '../http.mjs';
+import {UsageError} from 'wldx-core/errors';
+import {localTime, oneLine, table} from 'wldx-core/format';
+import {apiPath, query} from 'wldx-core/http';
 import {millis} from '../history/text.mjs';
 import {callFlow, checkId, checkZone, intOption, plural, wdaClient} from '../history/wda.mjs';
 
-export const OUTCOMES = ['offered', 'received', 'answered', 'completed', 'transferred', 'abandoned', 'unanswered', 'lost', 'lostAbandoned', 'lostUnanswered', 'overflow', 'unknown'];
+export const OUTCOMES = [
+  'offered',
+  'received',
+  'answered',
+  'completed',
+  'transferred',
+  'abandoned',
+  'unanswered',
+  'lost',
+  'lostAbandoned',
+  'lostUnanswered',
+  'overflow',
+  'unknown',
+];
 
 const FILTER_OPTIONS = {
-  from: {type: 'string', placeholder: 'YYYY-MM-DD', description: 'the first day (today when --from and --to are left out)'},
+  from: {
+    type: 'string',
+    placeholder: 'YYYY-MM-DD',
+    description: 'the first day (today when --from and --to are left out)',
+  },
   to: {type: 'string', placeholder: 'YYYY-MM-DD', description: 'the last day, inclusive (today by default)'},
   days: {type: 'string', placeholder: 'N', description: 'the last N days, today included (1-90)'},
   tz: {type: 'string', placeholder: 'ZONE', description: "the zone the days are cut in (the PBX's own by default)"},
-  pbx: {type: 'string', placeholder: 'SERIAL', description: 'the PBX of the report (else the PBX of the first --queue, else of the login)'},
-  queue: {type: 'string', multiple: true, placeholder: 'ID', description: 'only these queues (ids from wx reports list)'},
-  extension: {type: 'string', multiple: true, placeholder: 'EXT', description: 'only the calls these users answered, or that rang them unanswered'},
+  pbx: {
+    type: 'string',
+    placeholder: 'SERIAL',
+    description: 'the PBX of the report (else the PBX of the first --queue, else of the login)',
+  },
+  queue: {
+    type: 'string',
+    multiple: true,
+    placeholder: 'ID',
+    description: 'only these queues (ids from wx reports list)',
+  },
+  extension: {
+    type: 'string',
+    multiple: true,
+    placeholder: 'EXT',
+    description: 'only the calls these users answered, or that rang them unanswered',
+  },
   outcome: {type: 'string', multiple: true, choices: OUTCOMES, description: 'only calls of these outcomes'},
-  hours: {type: 'string', placeholder: 'HH:MM-HH:MM', description: 'the time of day the call entered the queue (slow: reads every call)'},
+  hours: {
+    type: 'string',
+    placeholder: 'HH:MM-HH:MM',
+    description: 'the time of day the call entered the queue (slow: reads every call)',
+  },
   weekday: {type: 'string', multiple: true, placeholder: '1-7', description: '1 = Monday … 7 = Sunday (slow)'},
-  wait: {type: 'string', placeholder: 'FROM-TO', description: 'a band of wait seconds: more than FROM, at most TO (TO may be left out) (slow)'},
+  wait: {
+    type: 'string',
+    placeholder: 'FROM-TO',
+    description: 'a band of wait seconds: more than FROM, at most TO (TO may be left out) (slow)',
+  },
   talk: {type: 'string', placeholder: 'FROM-TO', description: 'a band of talk seconds (slow)'},
-  reason: {type: 'string', multiple: true, placeholder: 'R', description: 'disconnect reasons: HANGUP, TRANSFER, TIMEOUT, EMPTY, EXITWITHKEY, … (slow)'},
-  sla: {type: 'string', placeholder: 'S', description: 'the SLA threshold in seconds, 5 to 120 in steps of 5 (20 by default)'},
+  reason: {
+    type: 'string',
+    multiple: true,
+    placeholder: 'R',
+    description: 'disconnect reasons: HANGUP, TRANSFER, TIMEOUT, EMPTY, EXITWITHKEY, … (slow)',
+  },
+  sla: {
+    type: 'string',
+    placeholder: 'S',
+    description: 'the SLA threshold in seconds, 5 to 120 in steps of 5 (20 by default)',
+  },
   'queue-sla': {type: 'string', multiple: true, placeholder: 'ID=S', description: 'the SLA threshold of one queue'},
 };
 
@@ -44,7 +92,8 @@ const localDay = (now, back) => {
 function checkDay(name, value) {
   const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
   const d = m && new Date(Date.UTC(+m[1], +m[2] - 1, +m[3]));
-  if (!m || d.getUTCMonth() !== +m[2] - 1 || d.getUTCDate() !== +m[3]) throw new UsageError(`${name} must be a day as YYYY-MM-DD: ${value}`);
+  if (!m || d.getUTCMonth() !== +m[2] - 1 || d.getUTCDate() !== +m[3])
+    throw new UsageError(`${name} must be a day as YYYY-MM-DD: ${value}`);
   return value;
 }
 
@@ -100,7 +149,8 @@ export function reportFilter(v, now) {
     f.disconnectReasons = v.reason;
   }
   if (v.weekday?.length) {
-    for (const d of v.weekday) if (!/^[1-7]$/.test(d)) throw new UsageError(`--weekday is 1 (Monday) to 7 (Sunday): ${d}`);
+    for (const d of v.weekday)
+      if (!/^[1-7]$/.test(d)) throw new UsageError(`--weekday is 1 (Monday) to 7 (Sunday): ${d}`);
     f.daysOfWeek = v.weekday.map(Number);
   }
   if (v.hours !== undefined) {
@@ -142,16 +192,30 @@ function ladder(v, widthKey, stepsKey) {
 // The queues: {total, pbxs: {pbx: n}, queues: [{id, name, pbx, aclGroup?}]}, by PBX and name.
 export function shapeQueues(r, {pbx, name} = {}) {
   const needle = (name ?? '').toLowerCase();
-  const list = (r.services ?? []).filter((s) => (!pbx || s.pbx === pbx) && (!needle || String(s.name ?? '').toLowerCase().includes(needle)));
+  const list = (r.services ?? []).filter(
+    (s) =>
+      (!pbx || s.pbx === pbx) &&
+      (!needle ||
+        String(s.name ?? '')
+          .toLowerCase()
+          .includes(needle)),
+  );
   const pbxs = {};
   for (const s of [...list].sort((a, b) => cmp(a.pbx, b.pbx))) pbxs[s.pbx] = (pbxs[s.pbx] ?? 0) + 1;
   const queues = [...list]
     .sort((a, b) => cmp(a.pbx, b.pbx) || cmp(a.name ?? '', b.name ?? ''))
-    .map((s) => Object.fromEntries(Object.entries({id: s.id, name: s.name, pbx: s.pbx, aclGroup: s.aclGroup ? s.aclGroup : null}).filter(([, x]) => x !== null && x !== undefined)));
+    .map((s) =>
+      Object.fromEntries(
+        Object.entries({id: s.id, name: s.name, pbx: s.pbx, aclGroup: s.aclGroup ? s.aclGroup : null}).filter(
+          ([, x]) => x !== null && x !== undefined,
+        ),
+      ),
+    );
   return {total: list.length, pbxs, queues};
 }
 
-const cmp = (a, b) => (a === b ? 0 : a === undefined || a === null ? -1 : b === undefined || b === null ? 1 : a < b ? -1 : 1);
+const cmp = (a, b) =>
+  a === b ? 0 : a === undefined || a === null ? -1 : b === undefined || b === null ? 1 : a < b ? -1 : 1;
 
 // Customers' numbers and names are shown only with --full.
 const CALLER = ['callerPhone', 'callerName'];
@@ -160,8 +224,10 @@ const dropCaller = (row) => (row ? Object.fromEntries(Object.entries(row).filter
 // Text.
 
 const n = (x) => (Number.isFinite(x) ? String(x) : '');
-const rate = (within, eligible) => (eligible ? `${within}/${eligible} ${Math.round((100 * within) / eligible)}%` : 'no calls');
-const slaText = (s) => (s ? `${rate(s.answeredWithin ?? s.abandonedWithin ?? 0, s.eligible ?? 0)} within ${s.thresholdSeconds ?? 20} s` : '');
+const rate = (within, eligible) =>
+  eligible ? `${within}/${eligible} ${Math.round((100 * within) / eligible)}%` : 'no calls';
+const slaText = (s) =>
+  s ? `${rate(s.answeredWithin ?? s.abandonedWithin ?? 0, s.eligible ?? 0)} within ${s.thresholdSeconds ?? 20} s` : '';
 
 function heading(r) {
   const w = r.window;
@@ -174,7 +240,10 @@ function metricsRows(m = {}) {
   return [
     ['Offered', n(c.offered)],
     ['Received', n(c.received)],
-    ['Answered', `${(c.completed ?? 0) + (c.transferred ?? 0)} (completed ${c.completed ?? 0}, transferred ${c.transferred ?? 0})`],
+    [
+      'Answered',
+      `${(c.completed ?? 0) + (c.transferred ?? 0)} (completed ${c.completed ?? 0}, transferred ${c.transferred ?? 0})`,
+    ],
     ['Abandoned', `${c.abandoned ?? 0}${c.shortAbandoned ? ` (within 5 s: ${c.shortAbandoned})` : ''}`],
     ['Unanswered', n(c.unanswered ?? 0)],
     ['Lost', `${c.lost ?? 0} (abandoned ${c.lostAbandoned ?? 0}, unanswered ${c.lostUnanswered ?? 0})`],
@@ -191,12 +260,25 @@ function metricsRows(m = {}) {
 const METRIC_HEAD = ['Offered', 'Answered', 'Abandoned', 'Lost', 'Overflow', 'SLA', 'Avg wait', 'Max wait', 'Avg talk'];
 const metricCells = (m = {}) => {
   const c = m.counts ?? {};
-  return [n(c.offered ?? 0), n((c.completed ?? 0) + (c.transferred ?? 0)), n(c.abandoned ?? 0), n(c.lost ?? 0), n(c.overflow ?? 0), m.sla ? rate(m.sla.answeredWithin ?? 0, m.sla.eligible ?? 0) : '', millis(m.avgWaitMs), millis(m.maxWaitMs), millis(m.avgTalkMs)];
+  return [
+    n(c.offered ?? 0),
+    n((c.completed ?? 0) + (c.transferred ?? 0)),
+    n(c.abandoned ?? 0),
+    n(c.lost ?? 0),
+    n(c.overflow ?? 0),
+    m.sla ? rate(m.sla.answeredWithin ?? 0, m.sla.eligible ?? 0) : '',
+    millis(m.avgWaitMs),
+    millis(m.maxWaitMs),
+    millis(m.avgTalkMs),
+  ];
 };
 
 // 1 = Monday … 7 = Sunday, as in the --weekday filter.
 const ISO_WEEKDAYS = [undefined, 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday'];
-const periodLabel = (b, granularity) => (granularity === 'dayOfWeek' ? ISO_WEEKDAYS[Number(b.bucketKey)] ?? b.bucketKey : b.bucketKey ?? b.bucketStart ?? '');
+const periodLabel = (b, granularity) =>
+  granularity === 'dayOfWeek'
+    ? (ISO_WEEKDAYS[Number(b.bucketKey)] ?? b.bucketKey)
+    : (b.bucketKey ?? b.bucketStart ?? '');
 
 const who = (name, ext) => [name, ext && `(${ext})`].filter(Boolean).join(' ');
 
@@ -247,7 +329,13 @@ const group = {
         return shapeQueues(await ctx.client(wdaClient).post('/stream/services', {}), {pbx, name});
       },
       text(r) {
-        const lines = [`${plural(r.total, 'queue')} · ${Object.entries(r.pbxs).map(([p, k]) => `PBX ${p}: ${k}`).join(', ') || 'no PBX'}`];
+        const lines = [
+          `${plural(r.total, 'queue')} · ${
+            Object.entries(r.pbxs)
+              .map(([p, k]) => `PBX ${p}: ${k}`)
+              .join(', ') || 'no PBX'
+          }`,
+        ];
         if (r.queues.length) lines.push(...table(r.queues.map((q) => [q.pbx ?? '', oneLine(q.name ?? '', 50), q.id])));
         return lines;
       },
@@ -255,7 +343,8 @@ const group = {
     summary: {
       summary: 'every queue call of the filter: offered, answered, abandoned, lost, waits, talk, ring, the SLA counts',
       usage: 'wx reports summary [filter]',
-      details: 'Filter: --from/--to days or --days N (today by default; at most 90 days), --tz, --pbx, --queue, --extension, --outcome, --sla, --queue-sla; slow ones: --hours, --weekday, --wait, --talk, --reason.',
+      details:
+        'Filter: --from/--to days or --days N (today by default; at most 90 days), --tz, --pbx, --queue, --extension, --outcome, --sla, --queue-sla; slow ones: --hours, --weekday, --wait, --talk, --reason.',
       options: FILTER_OPTIONS,
       args: [0, 0],
       run: (ctx) => report(ctx, 'distribution/summary/query'),
@@ -267,38 +356,81 @@ const group = {
       options: FILTER_OPTIONS,
       args: [0, 0],
       run: (ctx) => report(ctx, 'distribution/by-service/query'),
-      text: (r) => [heading(r), ...table([['Queue', ...METRIC_HEAD], ...(r.groups ?? []).map((g) => [oneLine(g.serviceName ?? g.serviceId ?? '', 40), ...metricCells(g.metrics)])])],
+      text: (r) => [
+        heading(r),
+        ...table([
+          ['Queue', ...METRIC_HEAD],
+          ...(r.groups ?? []).map((g) => [oneLine(g.serviceName ?? g.serviceId ?? '', 40), ...metricCells(g.metrics)]),
+        ]),
+      ],
     },
     'by-period': {
       summary: 'the same figures as a series (hour: the 24 hours of the day over the window)',
       usage: 'wx reports by-period --by hour|day|week|month|weekday [filter]',
-      options: {...FILTER_OPTIONS, by: {type: 'string', choices: ['hour', 'day', 'week', 'month', 'weekday'], description: 'the period of a bucket'}},
+      options: {
+        ...FILTER_OPTIONS,
+        by: {
+          type: 'string',
+          choices: ['hour', 'day', 'week', 'month', 'weekday'],
+          description: 'the period of a bucket',
+        },
+      },
       args: [0, 0],
       run(ctx) {
         if (!ctx.values.by) throw new UsageError('by-period needs --by hour|day|week|month|weekday', ctx.usage());
-        return report(ctx, 'distribution/by-period/query', {granularity: ctx.values.by === 'weekday' ? 'dayOfWeek' : ctx.values.by});
+        return report(ctx, 'distribution/by-period/query', {
+          granularity: ctx.values.by === 'weekday' ? 'dayOfWeek' : ctx.values.by,
+        });
       },
-      text: (r) => [heading(r), ...table([['Period', ...METRIC_HEAD], ...(r.buckets ?? []).map((b) => [periodLabel(b, r.granularity), ...metricCells(b.metrics)])])],
+      text: (r) => [
+        heading(r),
+        ...table([
+          ['Period', ...METRIC_HEAD],
+          ...(r.buckets ?? []).map((b) => [periodLabel(b, r.granularity), ...metricCells(b.metrics)]),
+        ]),
+      ],
     },
     answered: {
       summary: 'the answered calls: summary, or grouped by queue, agent, user, reason or talk time',
       usage: 'wx reports answered [--by queue|agent|user|reason|talk-time] [--band S --steps N] [filter]',
-      details: 'agent: a person in one queue; user: a person over every queue; talk-time: bands of --band seconds, --steps of them. The breakdowns read every call of the window (slow).',
-      options: {...FILTER_OPTIONS, by: {type: 'string', choices: ['queue', 'agent', 'user', 'reason', 'talk-time'], description: 'group the calls'}, ...LADDER},
+      details:
+        'agent: a person in one queue; user: a person over every queue; talk-time: bands of --band seconds, --steps of them. The breakdowns read every call of the window (slow).',
+      options: {
+        ...FILTER_OPTIONS,
+        by: {
+          type: 'string',
+          choices: ['queue', 'agent', 'user', 'reason', 'talk-time'],
+          description: 'group the calls',
+        },
+        ...LADDER,
+      },
       args: [0, 0],
       run(ctx) {
         const v = ctx.values;
-        if (v.by !== 'talk-time' && (v.band !== undefined || v.steps !== undefined)) throw new UsageError('--band and --steps go with --by talk-time');
+        if (v.by !== 'talk-time' && (v.band !== undefined || v.steps !== undefined))
+          throw new UsageError('--band and --steps go with --by talk-time');
         if (!v.by) return report(ctx, 'answered/summary/query');
-        const dimension = {queue: 'byService', agent: 'byAgent', user: 'byUser', reason: 'byDisconnectReason', 'talk-time': 'byTalkTime'}[v.by];
-        return report(ctx, 'answered/breakdown/query', {...(dimension === 'byTalkTime' ? ladder(v, 'talkBandSeconds', 'talkBandSteps') : {}), dimension});
+        const dimension = {
+          queue: 'byService',
+          agent: 'byAgent',
+          user: 'byUser',
+          reason: 'byDisconnectReason',
+          'talk-time': 'byTalkTime',
+        }[v.by];
+        return report(ctx, 'answered/breakdown/query', {
+          ...(dimension === 'byTalkTime' ? ladder(v, 'talkBandSeconds', 'talkBandSteps') : {}),
+          dimension,
+        });
       },
       text(r) {
         if (!r.groups) {
           return [
             heading(r),
             ...table([
-              ['Answered', `${(r.completed ?? 0) + (r.transferred ?? 0)} (completed ${r.completed ?? 0}, transferred ${r.transferred ?? 0})`],
+              [
+                'Answered',
+                `${(r.completed ?? 0) + (r.transferred ?? 0)} (completed ${r.completed ?? 0}, transferred ${r.transferred ?? 0})`,
+              ],
               ...(r.unknown ? [['Unknown', n(r.unknown)]] : []),
               ['Service level', slaText(r.sla)],
               ['Wait', `avg ${millis(r.avgWaitMs)}, max ${millis(r.maxWaitMs)}`],
@@ -308,7 +440,18 @@ const group = {
         }
         return [
           `${heading(r)} · ${r.total ?? 0} answered`,
-          ...table([['', 'Calls', 'Completed', 'Transferred', 'Avg wait', 'Avg talk', 'Total talk'], ...r.groups.map((g) => [oneLine(groupKey(g, r.dimension), 60), n(g.calls ?? 0), n(g.completed ?? 0), n(g.transferred ?? 0), millis(g.avgWaitMs), millis(g.avgTalkMs), millis(g.totalTalkMs)])]),
+          ...table([
+            ['', 'Calls', 'Completed', 'Transferred', 'Avg wait', 'Avg talk', 'Total talk'],
+            ...r.groups.map((g) => [
+              oneLine(groupKey(g, r.dimension), 60),
+              n(g.calls ?? 0),
+              n(g.completed ?? 0),
+              n(g.transferred ?? 0),
+              millis(g.avgWaitMs),
+              millis(g.avgTalkMs),
+              millis(g.totalTalkMs),
+            ]),
+          ]),
         ];
       },
     },
@@ -319,7 +462,9 @@ const group = {
       args: [0, 0],
       run(ctx) {
         if (!ctx.values.by) return report(ctx, 'unanswered/summary/query');
-        return report(ctx, 'unanswered/breakdown/query', {dimension: ctx.values.by === 'queue' ? 'byService' : 'byDisconnectReason'});
+        return report(ctx, 'unanswered/breakdown/query', {
+          dimension: ctx.values.by === 'queue' ? 'byService' : 'byDisconnectReason',
+        });
       },
       text(r) {
         if (!r.groups) {
@@ -332,14 +477,28 @@ const group = {
               ['Overflow', n(r.overflow ?? 0)],
               ...(r.unknown ? [['Unknown', n(r.unknown)]] : []),
               ['Given up', slaText(r.sla)],
-              ['Wait', `avg ${millis(r.avgWaitMs)}, max ${millis(r.maxWaitMs)}, abandoned avg ${millis(r.abandonedAvgWaitMs)}`],
+              [
+                'Wait',
+                `avg ${millis(r.avgWaitMs)}, max ${millis(r.maxWaitMs)}, abandoned avg ${millis(r.abandonedAvgWaitMs)}`,
+              ],
               ['Place in line', `avg start ${n(r.avgStartPosition ?? 0)}, avg final ${n(r.avgFinalPosition ?? 0)}`],
             ]),
           ];
         }
         return [
           `${heading(r)} · ${r.total ?? 0} not answered`,
-          ...table([['', 'Abandoned', 'Unanswered', 'Lost', 'Overflow', 'Avg wait', 'Max wait'], ...r.groups.map((g) => [oneLine(groupKey(g, r.dimension), 60), n(g.abandoned ?? 0), n(g.unanswered ?? 0), n(g.lost ?? 0), n(g.overflow ?? 0), millis(g.avgWaitMs), millis(g.maxWaitMs)])]),
+          ...table([
+            ['', 'Abandoned', 'Unanswered', 'Lost', 'Overflow', 'Avg wait', 'Max wait'],
+            ...r.groups.map((g) => [
+              oneLine(groupKey(g, r.dimension), 60),
+              n(g.abandoned ?? 0),
+              n(g.unanswered ?? 0),
+              n(g.lost ?? 0),
+              n(g.overflow ?? 0),
+              millis(g.avgWaitMs),
+              millis(g.maxWaitMs),
+            ]),
+          ]),
         ];
       },
     },
@@ -350,20 +509,27 @@ const group = {
       args: [1, 1],
       run(ctx) {
         const kind = ctx.positionals[0];
-        if (kind !== 'answered' && kind !== 'unanswered') throw new UsageError('service-level answered|unanswered', ctx.usage());
+        if (kind !== 'answered' && kind !== 'unanswered')
+          throw new UsageError('service-level answered|unanswered', ctx.usage());
         return report(ctx, `${kind}/service-level/query`, ladder(ctx.values, 'waitBandSeconds', 'waitBandSteps'));
       },
       text(r, ctx) {
         const unanswered = ctx.positionals[0] === 'unanswered';
         const head = `${heading(r)} · ${r.total ?? 0} ${unanswered ? 'not answered' : 'answered'}${unanswered ? ` (lost ${r.lost ?? 0}, overflow ${r.overflow ?? 0})` : ''}`;
-        const rows = (r.bands ?? []).map((b) => [`within ${b.withinSeconds} s`, n(b.count), `+${b.delta ?? 0}`, ...(unanswered ? [`lost ${b.lost ?? 0}`, `overflow ${b.overflow ?? 0}`] : [])]);
+        const rows = (r.bands ?? []).map((b) => [
+          `within ${b.withinSeconds} s`,
+          n(b.count),
+          `+${b.delta ?? 0}`,
+          ...(unanswered ? [`lost ${b.lost ?? 0}`, `overflow ${b.overflow ?? 0}`] : []),
+        ]);
         return [head, ...table(rows)];
       },
     },
     calls: {
       summary: 'the queue calls one by one, newest first: queue, times, wait, talk, outcome, who answered',
       usage: 'wx reports calls [--limit N] [--pages N] [--cursor C] [--call CALLID] [--full] [filter]',
-      details: '50 a page (--limit up to 200); --pages follows the next pages (up to 20); --call: every queue a phone call went through. The caller (number and name) only with --full: show it when the user asks for the callers.',
+      details:
+        '50 a page (--limit up to 200); --pages follows the next pages (up to 20); --call: every queue a phone call went through. The caller (number and name) only with --full: show it when the user asks for the callers.',
       options: {
         ...FILTER_OPTIONS,
         limit: {type: 'string', placeholder: 'N', description: 'calls per page (1-200, 50 by default)'},
@@ -377,7 +543,8 @@ const group = {
         const v = ctx.values;
         const limit = intOption('--limit', v.limit, 1, 200);
         const pages = intOption('--pages', v.pages, 1, 20) ?? 1;
-        if (v.cursor !== undefined && (v.cursor.length > 2048 || !/^[A-Za-z0-9_=+/.:-]+$/.test(v.cursor))) throw new UsageError('not a cursor');
+        if (v.cursor !== undefined && (v.cursor.length > 2048 || !/^[A-Za-z0-9_=+/.:-]+$/.test(v.cursor)))
+          throw new UsageError('not a cursor');
         const filter = reportFilter(v, ctx.now);
         const x = {};
         if (limit !== undefined) x.limit = limit;
@@ -416,12 +583,20 @@ const group = {
       async run(ctx) {
         const {callId, flow} = callFlow(ctx.positionals);
         const q = ctx.values.queue === undefined ? undefined : checkId('the queue id', ctx.values.queue);
-        const r = await ctx.client(wdaClient).get(apiPath`/xcaracal/services/calls/${callId}/flows/${String(flow)}/events` + query({serviceId: q}));
+        const r = await ctx
+          .client(wdaClient)
+          .get(apiPath`/xcaracal/services/calls/${callId}/flows/${String(flow)}/events` + query({serviceId: q}));
         return ctx.values.full ? r : {...r, call: dropCaller(r.call)};
       },
       text(r, ctx) {
         const lines = r.call ? table([callLine(r.call, ctx.values.full)]) : [];
-        const rows = (r.events ?? []).map((e) => [localTime(e.time, {seconds: true}), e.action ?? '', e.reason ?? '', who(e.userName, e.userExtension), e.queuePosition === undefined ? '' : `place ${e.queuePosition}`]);
+        const rows = (r.events ?? []).map((e) => [
+          localTime(e.time, {seconds: true}),
+          e.action ?? '',
+          e.reason ?? '',
+          who(e.userName, e.userExtension),
+          e.queuePosition === undefined ? '' : `place ${e.queuePosition}`,
+        ]);
         return [...lines, ...(rows.length ? table(rows).map((l) => `  ${l}`) : ['  No events.'])];
       },
     },

package/src/commands/section.mjs

@@ -1,14 +1,15 @@
 // wx section: the user's sections of the chat inbox (the agent skill's sections.sh). The list and its counters come
 // from the inbox; creating, renaming, deleting and moving channels are not implemented by the service yet.
-import {UsageError} from '../errors.mjs';
-import {apiPath} from '../http.mjs';
+import {UsageError} from 'wldx-core/errors';
+import {apiPath} from 'wldx-core/http';
 import {channelId} from '../stream.mjs';
 import {done} from '../chat/format.mjs';
 import {NOT_IMPLEMENTED, api, notImplemented} from '../chat/lib.mjs';
 import {sectionLines} from './inbox.mjs';
 
 function sectionId(value) {
-  if (!/^[a-z0-9_-]{1,32}$/.test(String(value))) throw new UsageError(`A section id must match [a-z0-9_-] (up to 32): ${value}`);
+  if (!/^[a-z0-9_-]{1,32}$/.test(String(value)))
+    throw new UsageError(`A section id must match [a-z0-9_-] (up to 32): ${value}`);
   return value;
 }
 
@@ -49,11 +50,51 @@ const section = {
   auth: true,
   commands: {
     list,
-    create: make('create', 'create a section', '<sectionId> <name>', 'CreateSection', 2, ([id, name]) => ['POST', '/sections', {sectionId: sectionId(id), name: sectionName(name)}], 'Created'),
-    rename: make('rename', 'rename a section', '<sectionId> <name>', 'RenameSection', 2, ([id, name]) => ['PATCH', apiPath`/sections/${sectionId(id)}`, {name: sectionName(name)}], 'Renamed'),
-    delete: make('delete', 'delete a section', '<sectionId>', 'DeleteSection', 1, ([id]) => ['DELETE', apiPath`/sections/${sectionId(id)}`], 'Deleted'),
-    add: make('add', 'put a channel into a section', '<channel> <sectionId>', 'MoveChannelToSection', 2, ([ch, id]) => ['PUT', apiPath`/channels/${channelId(ch)}/sections/${sectionId(id)}`], 'Added'),
-    remove: make('remove', 'take a channel out of a section', '<channel> <sectionId>', 'RemoveChannelFromSection', 2, ([ch, id]) => ['DELETE', apiPath`/channels/${channelId(ch)}/sections/${sectionId(id)}`], 'Removed'),
+    create: make(
+      'create',
+      'create a section',
+      '<sectionId> <name>',
+      'CreateSection',
+      2,
+      ([id, name]) => ['POST', '/sections', {sectionId: sectionId(id), name: sectionName(name)}],
+      'Created',
+    ),
+    rename: make(
+      'rename',
+      'rename a section',
+      '<sectionId> <name>',
+      'RenameSection',
+      2,
+      ([id, name]) => ['PATCH', apiPath`/sections/${sectionId(id)}`, {name: sectionName(name)}],
+      'Renamed',
+    ),
+    delete: make(
+      'delete',
+      'delete a section',
+      '<sectionId>',
+      'DeleteSection',
+      1,
+      ([id]) => ['DELETE', apiPath`/sections/${sectionId(id)}`],
+      'Deleted',
+    ),
+    add: make(
+      'add',
+      'put a channel into a section',
+      '<channel> <sectionId>',
+      'MoveChannelToSection',
+      2,
+      ([ch, id]) => ['PUT', apiPath`/channels/${channelId(ch)}/sections/${sectionId(id)}`],
+      'Added',
+    ),
+    remove: make(
+      'remove',
+      'take a channel out of a section',
+      '<channel> <sectionId>',
+      'RemoveChannelFromSection',
+      2,
+      ([ch, id]) => ['DELETE', apiPath`/channels/${channelId(ch)}/sections/${sectionId(id)}`],
+      'Removed',
+    ),
   },
 };
 

package/src/commands/user.mjs

@@ -1,9 +1,9 @@
 // wx user: people of the corporate directory on the stream service (the agent skill's users.sh and search.sh
 // users): who you are, a colleague by name (any script, typos, as it sounds), e-mail or phone.
-import {jwtClaims} from '../auth.mjs';
-import {UsageError} from '../errors.mjs';
-import {paint, table} from '../format.mjs';
-import {query} from '../http.mjs';
+import {jwtClaims} from 'wldx-core/auth';
+import {UsageError} from 'wldx-core/errors';
+import {paint, table} from 'wldx-core/format';
+import {query} from 'wldx-core/http';
 import {nextPage, userLine} from '../chat/format.mjs';
 import {api, checkId, checkInt, displayName} from '../chat/lib.mjs';
 
@@ -20,7 +20,11 @@ const me = {
   },
   text(u, ctx) {
     if (!u) return 'Not found in the chat directory.';
-    const rows = [['Name', paint(ctx).bold(displayName(u) ?? '')], ['Id', u.id], ['E-mail', u.email ?? '']];
+    const rows = [
+      ['Name', paint(ctx).bold(displayName(u) ?? '')],
+      ['Id', u.id],
+      ['E-mail', u.email ?? ''],
+    ];
     if (u.pbxExtension) rows.push(['Extension', u.pbxExtension]);
     if (u.timeZone) rows.push(['Time zone', u.timeZone]);
     if (u.locale) rows.push(['Locale', u.locale]);
@@ -31,12 +35,21 @@ const me = {
 const brief = (r) => ({
   margin: r?.margin,
   nextCursor: r?.nextCursor,
-  results: (r?.results ?? []).map((x) => ({id: x.user?.id, name: x.user?.displayName, email: x.user?.email, extension: x.user?.pbxExtension, bot: x.user?.bot, confidence: x.confidence, matchedOn: x.matchedOn})),
+  results: (r?.results ?? []).map((x) => ({
+    id: x.user?.id,
+    name: x.user?.displayName,
+    email: x.user?.email,
+    extension: x.user?.pbxExtension,
+    bot: x.user?.bot,
+    confidence: x.confidence,
+    matchedOn: x.matchedOn,
+  })),
 });
 
 const find = {
   summary: 'find a colleague by name (any script, typos, as it sounds), e-mail or phone',
-  usage: 'wx user find <query> [--mode auto|name|email|phone] [--kind human|bot|all] [--with-extension] [--min-confidence 0..1] [--brief] [--size 1-50] [--cursor C]',
+  usage:
+    'wx user find <query> [--mode auto|name|email|phone] [--kind human|bot|all] [--with-extension] [--min-confidence 0..1] [--brief] [--size 1-50] [--cursor C]',
   details: [
     'An e-mail or a phone number (with its country code, +…) is looked up exactly (confidence 1). confidence (0..1)',
     'is how much the query looks like the name, not the probability that it is the right person (default cut 0.5;',
@@ -45,10 +58,18 @@ const find = {
     'matchedOn (JSON).',
   ].join('\n'),
   options: {
-    mode: {type: 'string', choices: ['auto', 'name', 'email', 'phone'], description: 'what the query is (auto by default)'},
+    mode: {
+      type: 'string',
+      choices: ['auto', 'name', 'email', 'phone'],
+      description: 'what the query is (auto by default)',
+    },
     kind: {type: 'string', choices: ['human', 'bot', 'all'], description: 'people (default), bots or both'},
     'with-extension': {type: 'boolean', description: 'only people with a PBX extension'},
-    'min-confidence': {type: 'string', placeholder: '0..1', description: 'drop hits below this confidence (default 0.5)'},
+    'min-confidence': {
+      type: 'string',
+      placeholder: '0..1',
+      description: 'drop hits below this confidence (default 0.5)',
+    },
     brief: {type: 'boolean', description: 'only the fields needed to pick a person'},
     size: {type: 'string', placeholder: '1-50', description: 'results per page (default 20)'},
     cursor: {type: 'string', description: 'the next page (nextCursor of the previous one)'},
@@ -57,7 +78,8 @@ const find = {
   async run(ctx) {
     const {values} = ctx;
     const minc = values['min-confidence'];
-    if (minc !== undefined && !/^(0|1|0?\.[0-9]+|1\.0+)$/.test(minc)) throw new UsageError(`--min-confidence is a number from 0 to 1: ${minc}`);
+    if (minc !== undefined && !/^(0|1|0?\.[0-9]+|1\.0+)$/.test(minc))
+      throw new UsageError(`--min-confidence is a number from 0 to 1: ${minc}`);
     const q = query({
       q: ctx.positionals[0],
       mode: values.mode,
@@ -79,7 +101,12 @@ const find = {
       return [...userLine(u, c), `${Number(x.confidence ?? 0).toFixed(2)} ${x.matchedOn ?? ''}`.trim()];
     });
     const lines = table(rows);
-    if (hits.length > 1 && typeof r.margin === 'number') lines.push(r.margin < 0.1 ? c.yellow(`Ambiguous (margin ${r.margin.toFixed(2)}): several people fit, ask which one`) : c.dim(`margin ${r.margin.toFixed(2)}`));
+    if (hits.length > 1 && typeof r.margin === 'number')
+      lines.push(
+        r.margin < 0.1
+          ? c.yellow(`Ambiguous (margin ${r.margin.toFixed(2)}): several people fit, ask which one`)
+          : c.dim(`margin ${r.margin.toFixed(2)}`),
+      );
     return [...lines, ...nextPage(r.nextCursor, c)];
   },
 };
@@ -90,7 +117,8 @@ const PHONE = /^\+?[0-9]{4,17}$/;
 const get = {
   summary: 'people by user id, e-mail or phone (exact lookup)',
   usage: 'wx user get [<id|email|phone>...] [--id USERID]... [--email EMAIL]... [--phone PHONE]...',
-  details: 'A value given without an option is an e-mail when it has "@", a phone when it is digits (+ allowed), else a user id. For a search by name: wx user find.',
+  details:
+    'A value given without an option is an e-mail when it has "@", a phone when it is digits (+ allowed), else a user id. For a search by name: wx user find.',
   options: {
     id: {type: 'string', multiple: true, placeholder: 'USERID', description: 'a user id'},
     email: {type: 'string', multiple: true, placeholder: 'EMAIL', description: 'an e-mail address'},
@@ -111,7 +139,8 @@ const get = {
     if (ids.length) q.ids = ids.map((id) => checkId('The user id', id));
     if (emails.length) q.emails = emails;
     if (phones.length) q.phones = phones;
-    if (!Object.keys(q).length) throw new UsageError('Give a user id, an e-mail or a phone (or --id, --email, --phone)', ctx.usage());
+    if (!Object.keys(q).length)
+      throw new UsageError('Give a user id, an e-mail or a phone (or --id, --email, --phone)', ctx.usage());
     return api(ctx).call('POST', '/users/query', {query: q});
   },
   text(r, ctx) {