wldx-cli 1.0.0 → 1.2.0

package/src/commands/meetings.mjs

@@ -1,11 +1,22 @@
 // wx meetings: conferences (x-bees meetings) after the fact: the record, a readable card, the transcript, the AI
 // summary and insights, who spoke when, the recording link. Read only, except schedule-summary (asks the service
 // to generate the summary again). Data of WDA History and WDA Insights.
-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 {insightLines, millis, sectionLines, summaryLines} from '../history/text.mjs';
-import {NoDataError, alt, compactInsights, conferenceId, isoSeconds, optional, participantNames, plural, wdaClient, writePrivate} from '../history/wda.mjs';
+import {
+  NoDataError,
+  alt,
+  compactInsights,
+  conferenceId,
+  isoSeconds,
+  optional,
+  participantNames,
+  plural,
+  wdaClient,
+  writePrivate,
+} from '../history/wda.mjs';
 import {annotationLines, insightsText, stateText, structuredLines} from './calls.mjs';
 
 const CONF = '<conference>';
@@ -45,7 +56,11 @@ export function briefConference(id, rec, sum, ins) {
     hasRecording: (c.recordings ?? []).length > 0,
     summary:
       sum?.status === 'SUCCEEDED'
-        ? {title: s.title ?? null, brief: s.brief ?? null, ...Object.fromEntries(SUMMARY_KEYS.map((k) => [k, s.json?.[k] ?? []]))}
+        ? {
+            title: s.title ?? null,
+            brief: s.brief ?? null,
+            ...Object.fromEntries(SUMMARY_KEYS.map((k) => [k, s.json?.[k] ?? []])),
+          }
         : {status: sum?.status ?? 'UNKNOWN'},
     insights: compactInsights(ins),
   };
@@ -53,7 +68,11 @@ export function briefConference(id, rec, sum, ins) {
 
 async function briefOne(wda, id, info) {
   const base = apiPath`/${id}`;
-  const [rec, ins, sum] = await Promise.all([wda.get(`/history/conferences${base}`), optional(wda.get(`/insights/conferences${base}/insights`), info), optional(wda.get(`/insights/conferences${base}/summary`), info)]);
+  const [rec, ins, sum] = await Promise.all([
+    wda.get(`/history/conferences${base}`),
+    optional(wda.get(`/insights/conferences${base}/insights`), info),
+    optional(wda.get(`/insights/conferences${base}/summary`), info),
+  ]);
   return briefConference(id, rec, sum, ins);
 }
 
@@ -76,9 +95,22 @@ export function transcriptHeader(id, c, lines) {
 const NO_TRANSCRIPT = 'This conference has no transcription, or there is no such conference.';
 
 function briefLines(b) {
-  const head = [localTime(b.start), `${b.durationMin} min`, b.status, b.direction, b.transcriptionStatus && `transcript ${b.transcriptionStatus}${b.transcriptionLanguage ? ` (${b.transcriptionLanguage})` : ''}`, b.hasRecording && 'recording'].filter(Boolean).join(' · ');
+  const head = [
+    localTime(b.start),
+    `${b.durationMin} min`,
+    b.status,
+    b.direction,
+    b.transcriptionStatus &&
+      `transcript ${b.transcriptionStatus}${b.transcriptionLanguage ? ` (${b.transcriptionLanguage})` : ''}`,
+    b.hasRecording && 'recording',
+  ]
+    .filter(Boolean)
+    .join(' · ');
   const lines = [oneLine(b.subject || 'Conference', 200), `  ${head}`, `  ${b.id}`];
-  if (b.participants.length) lines.push(`  Participants: ${b.participants.map((p) => `${p.name}${p.speakMin ? ` (${p.speakMin} min)` : ''}`).join(', ')}`);
+  if (b.participants.length)
+    lines.push(
+      `  Participants: ${b.participants.map((p) => `${p.name}${p.speakMin ? ` (${p.speakMin} min)` : ''}`).join(', ')}`,
+    );
   if (b.summary.status) lines.push(`  Summary: ${b.summary.status}`);
   else {
     if (b.summary.title) lines.push(`  Summary: ${oneLine(b.summary.title, 200)}`);
@@ -91,7 +123,8 @@ function briefLines(b) {
 }
 
 const conf = (ctx) => conferenceId(ctx.positionals[0]);
-const get = (ctx, suffix) => ctx.client(wdaClient).get(`/${suffix[0]}/conferences${apiPath`/${conf(ctx)}`}${suffix[1] ?? ''}`);
+const get = (ctx, suffix) =>
+  ctx.client(wdaClient).get(`/${suffix[0]}/conferences${apiPath`/${conf(ctx)}`}${suffix[1] ?? ''}`);
 
 const group = {
   summary: 'meetings (conferences) after the fact: record, transcript, summary, insights, recording',
@@ -146,8 +179,15 @@ const group = {
       usage: `wx meetings transcript ${CONF} [--to FILE] [--structured]`,
       details: `${CONF_HINT} Text: a header (subject, id, link, start in UTC, duration, language, participants, lines) and the dialogue "[MM:SS] Name: text". --output json: the header fields under "conference", and the text and its chunks as the service gives them. --structured: the transcription record with the interaction data. --to writes the header and the dialogue to a new private file (an existing file only when it is the transcript of the same meeting) and prints its path.`,
       options: {
-        to: {type: 'string', placeholder: 'FILE', description: 'write the transcript to this file (private) and print its path'},
-        structured: {type: 'boolean', description: 'the transcription record: chunks with timing, sentiment, the interaction'},
+        to: {
+          type: 'string',
+          placeholder: 'FILE',
+          description: 'write the transcript to this file (private) and print its path',
+        },
+        structured: {
+          type: 'boolean',
+          description: 'the transcription record: chunks with timing, sentiment, the interaction',
+        },
       },
       args: [1, 1],
       async run(ctx) {
@@ -156,26 +196,47 @@ const group = {
         const base = apiPath`/${id}`;
         if (ctx.values.structured) {
           if (ctx.values.to) throw new UsageError('--to writes the dialogue: leave out --structured');
-          const [r, rec] = await Promise.all([wda.soft(`/history/conferences${base}/transcription`), ctx.output === 'text' ? optional(wda.get(`/history/conferences${base}`), ctx.info) : null]);
+          const [r, rec] = await Promise.all([
+            wda.soft(`/history/conferences${base}/transcription`),
+            ctx.output === 'text' ? optional(wda.get(`/history/conferences${base}`), ctx.info) : null,
+          ]);
           if (!r) throw new NoDataError(NO_TRANSCRIPT);
-          if (rec) Object.defineProperty(r, 'names', {value: Object.fromEntries((rec.conference?.participants ?? []).map((p) => [p.jid, alt(p.info?.name, p.info?.email, p.jid)])), enumerable: false});
+          if (rec)
+            Object.defineProperty(r, 'names', {
+              value: Object.fromEntries(
+                (rec.conference?.participants ?? []).map((p) => [p.jid, alt(p.info?.name, p.info?.email, p.jid)]),
+              ),
+              enumerable: false,
+            });
           return r;
         }
-        const [text, rec] = await Promise.allSettled([wda.soft(`/history/conferences${base}/transcription/text`), wda.get(`/history/conferences${base}`)]);
+        const [text, rec] = await Promise.allSettled([
+          wda.soft(`/history/conferences${base}/transcription/text`),
+          wda.get(`/history/conferences${base}`),
+        ]);
         if (text.status === 'rejected') throw text.reason;
         if (!text.value) throw new NoDataError(NO_TRANSCRIPT);
         if (rec.status === 'rejected') throw rec.reason;
         const c = rec.value.conference ?? {};
         const body = text.value;
         const dialogue = (body.text ?? '').trim();
-        if (c.transcriptionStatus === 'UNAVAILABLE') throw new NoDataError("Transcription is not available for this conference (transcriptionStatus 'UNAVAILABLE'): it was most likely never enabled on the call.");
+        if (c.transcriptionStatus === 'UNAVAILABLE')
+          throw new NoDataError(
+            "Transcription is not available for this conference (transcriptionStatus 'UNAVAILABLE'): it was most likely never enabled on the call.",
+          );
         if (!dialogue) {
-          if (c.transcriptionStatus === 'POST_TRANSCRIPTION') throw new NoDataError("The transcription is still being processed (transcriptionStatus 'POST_TRANSCRIPTION'): try again later.");
+          if (c.transcriptionStatus === 'POST_TRANSCRIPTION')
+            throw new NoDataError(
+              "The transcription is still being processed (transcriptionStatus 'POST_TRANSCRIPTION'): try again later.",
+            );
           throw new NoDataError('The transcription is empty: nothing was transcribed on this call.');
         }
         const lines = (body.chunks ?? []).length;
         const header = transcriptHeader(id, c, lines);
-        if (ctx.values.to) return {file: writePrivate(ctx.values.to, `${header}${dialogue}\n`, {cwd: ctx.cwd, conferenceId: id, env: ctx.env})};
+        if (ctx.values.to)
+          return {
+            file: writePrivate(ctx.values.to, `${header}${dialogue}\n`, {cwd: ctx.cwd, conferenceId: id, env: ctx.env}),
+          };
         const out = {
           conference: {
             id,
@@ -195,7 +256,9 @@ const group = {
       text(r, ctx) {
         if (r.file) return r.file;
         if (ctx.values.structured) {
-          return (r.transcription?.transcriptions ?? []).flatMap((t) => structuredLines(t.chunks ?? [], t.start, r.names ?? {}));
+          return (r.transcription?.transcriptions ?? []).flatMap((t) =>
+            structuredLines(t.chunks ?? [], t.start, r.names ?? {}),
+          );
         }
         return `${r.header}${(r.text ?? '').trim()}`;
       },
@@ -243,10 +306,15 @@ const group = {
       async run(ctx) {
         const wda = ctx.client(wdaClient);
         const base = apiPath`/${conf(ctx)}`;
-        const [r, rec] = await Promise.all([wda.get(`/insights/conferences${base}/timeframes`), ctx.output === 'text' ? optional(wda.get(`/history/conferences${base}`), ctx.info) : null]);
+        const [r, rec] = await Promise.all([
+          wda.get(`/insights/conferences${base}/timeframes`),
+          ctx.output === 'text' ? optional(wda.get(`/history/conferences${base}`), ctx.info) : null,
+        ]);
         if (rec) {
           const c = rec.conference ?? {};
-          const names = Object.fromEntries((c.participants ?? []).map((p) => [p.jid, alt(p.info?.name, p.info?.email, p.jid)]));
+          const names = Object.fromEntries(
+            (c.participants ?? []).map((p) => [p.jid, alt(p.info?.name, p.info?.email, p.jid)]),
+          );
           Object.defineProperty(r, 'names', {value: names, enumerable: false});
           Object.defineProperty(r, 'startTime', {value: c.startTime, enumerable: false});
         }
@@ -261,8 +329,16 @@ const group = {
           list.map((t) => {
             const frames = t.frames ?? [];
             const total = frames.reduce((n, f) => n + Math.max(0, (f.end ?? f.start) - f.start), 0);
-            const spans = frames.slice(0, 12).map((f) => `${at(f.start)}-${at(f.end ?? f.start)}`).join(' ');
-            return [oneLine(r.names?.[t.jid] ?? t.jid, 40), millis(total), plural(frames.length, 'time'), spans + (frames.length > 12 ? ' …' : '')];
+            const spans = frames
+              .slice(0, 12)
+              .map((f) => `${at(f.start)}-${at(f.end ?? f.start)}`)
+              .join(' ');
+            return [
+              oneLine(r.names?.[t.jid] ?? t.jid, 40),
+              millis(total),
+              plural(frames.length, 'time'),
+              spans + (frames.length > 12 ? ' …' : ''),
+            ];
           }),
         );
       },
@@ -270,18 +346,28 @@ const group = {
     'recording-url': {
       summary: 'a link to download or play a recording of a meeting',
       usage: 'wx meetings recording-url --file-id ID --category channels|recordings|wizyconfRecordings [--download]',
-      details: 'The file id is the identifier of the recording file as the record gives it. The link is presigned: whoever has it can open the file until it expires.',
+      details:
+        'The file id is the identifier of the recording file as the record gives it. The link is presigned: whoever has it can open the file until it expires.',
       options: {
         'file-id': {type: 'string', placeholder: 'ID', description: 'the identifier of the recording file'},
-        category: {type: 'string', choices: ['channels', 'recordings', 'wizyconfRecordings'], description: 'the category of the file'},
+        category: {
+          type: 'string',
+          choices: ['channels', 'recordings', 'wizyconfRecordings'],
+          description: 'the category of the file',
+        },
         download: {type: 'boolean', description: 'a link that always downloads (else audio and video play)'},
       },
       args: [0, 0],
       async run(ctx) {
         const v = ctx.values;
         if (!v['file-id'] || !v.category) throw new UsageError('--file-id and --category are required', ctx.usage());
-        if (v['file-id'].length > 1024 || /[\s\0]/.test(v['file-id'])) throw new UsageError(`not a file id: ${v['file-id']}`);
-        return ctx.client(wdaClient).get(`/insights/conferences/recording/download_url${query({fileId: v['file-id'], category: v.category, download: v.download ? '1' : undefined})}`);
+        if (v['file-id'].length > 1024 || /[\s\0]/.test(v['file-id']))
+          throw new UsageError(`not a file id: ${v['file-id']}`);
+        return ctx
+          .client(wdaClient)
+          .get(
+            `/insights/conferences/recording/download_url${query({fileId: v['file-id'], category: v.category, download: v.download ? '1' : undefined})}`,
+          );
       },
       text: (r) => r.presignedDownloadUrl ?? '',
     },
@@ -290,7 +376,8 @@ const group = {
       usage: `wx meetings schedule-summary ${CONF}`,
       options: {},
       args: [1, 1],
-      run: (ctx) => ctx.client(wdaClient).post(`/insights/conferences${apiPath`/${conf(ctx)}`}/schedule_summary_generation`),
+      run: (ctx) =>
+        ctx.client(wdaClient).post(`/insights/conferences${apiPath`/${conf(ctx)}`}/schedule_summary_generation`),
       text: () => 'The summary was scheduled: read it later with wx meetings summary.',
     },
   },

package/src/commands/phone.mjs

@@ -5,13 +5,26 @@
 //   - SIP over a WebSocket (wss://<pbx>/sip/): a headless SIP user of the extension (no media; it turns every call
 //     offered to it down) for the live view and what only SIP has: recording and the transfer through a conference.
 // The user acts on their own calls and devices only; the admin-only `user` parameter of the API is left out.
-import {jwtClaims} from '../auth.mjs';
-import {UsageError} from '../errors.mjs';
-import {duration, localTime, paint, table} from '../format.mjs';
-import {pbxUrl} from '../services.mjs';
+import {jwtClaims} from 'wldx-core/auth';
+import {UsageError} from 'wldx-core/errors';
+import {duration, localTime, paint, table} from 'wldx-core/format';
+import {pbxUrl} from 'wldx-core/services';
 import {CallControl, RECORD_ACTIONS} from '../phone/control.mjs';
 import {deviceName} from '../phone/events.mjs';
-import {PbxError, WATCHER_USER_AGENT, checkCallId, checkContact, checkDigits, extensionOf, isWatcher, normNumber, pbxAction, pbxCall, sipEndpoint, sipPassword} from '../phone/pbx.mjs';
+import {
+  PbxError,
+  WATCHER_USER_AGENT,
+  checkCallId,
+  checkContact,
+  checkDigits,
+  extensionOf,
+  isWatcher,
+  normNumber,
+  pbxAction,
+  pbxCall,
+  sipEndpoint,
+  sipPassword,
+} from '../phone/pbx.mjs';
 
 // Tests replace the WebSocket (a fake PBX) and the timings of the SIP channel here.
 export const sipIo = {WebSocket: undefined, options: {}};
@@ -35,10 +48,27 @@ const party = (number, name) => [number, name].filter((v) => v !== undefined &&
 // A call of the REST list or of the SIP view, as table cells.
 function callRow(call, c) {
   if (call.sipCallId !== undefined) {
-    return [callColor(c, call.state), duration(Number(call.duration)), party(call.callerNumber, call.callerName), '→', party(call.calleeNumber, call.calleeName), c.dim(call.sipCallId)];
+    return [
+      callColor(c, call.state),
+      duration(Number(call.duration)),
+      party(call.callerNumber, call.callerName),
+      '→',
+      party(call.calleeNumber, call.calleeName),
+      c.dim(call.sipCallId),
+    ];
   }
-  const extras = [call.recording && call.recording !== 'off' && `recording ${call.recording}`, call.tags?.length && `[${call.tags.join(', ')}]`, call.endReason && `(${call.endReason})`];
-  return [callColor(c, call.state), call.direction === 'outbound' ? 'to' : 'from', party(call.remoteNumber, call.remoteName), extras.filter(Boolean).join(' '), c.dim(call.id)];
+  const extras = [
+    call.recording && call.recording !== 'off' && `recording ${call.recording}`,
+    call.tags?.length && `[${call.tags.join(', ')}]`,
+    call.endReason && `(${call.endReason})`,
+  ];
+  return [
+    callColor(c, call.state),
+    call.direction === 'outbound' ? 'to' : 'from',
+    party(call.remoteNumber, call.remoteName),
+    extras.filter(Boolean).join(' '),
+    c.dim(call.id),
+  ];
 }
 
 // table() without the columns that are empty in every row.
@@ -56,15 +86,35 @@ function callsText(calls, ctx) {
 function devicesText(devices, ctx) {
   if (!devices?.length) return 'No device of yours is registered now.';
   const c = paint(ctx);
-  return compactTable(devices.map((d) => [[d.active && c.green('active'), d.watcher && c.dim('watcher')].filter(Boolean).join(' '), d.name ?? deviceName(d.userAgent), d.contact ?? '']));
+  return compactTable(
+    devices.map((d) => [
+      [d.active && c.green('active'), d.watcher && c.dim('watcher')].filter(Boolean).join(' '),
+      d.name ?? deviceName(d.userAgent),
+      d.contact ?? '',
+    ]),
+  );
 }
 
 const actionText = (r) => (typeof r.message === 'string' ? r.message : `OK ${JSON.stringify(r.message ?? {})}`);
 
 // ---- the SIP channel
 
-const callView = (c) => ({id: c.id, direction: c.direction, state: c.state, remoteNumber: c.remoteNumber, remoteName: c.remoteName, tags: c.tags, recording: c.recording, endReason: c.endReason});
-const deviceView = (d) => ({contact: d.uri, name: d.deviceName, userAgent: d.userAgent, ...(isWatcher(d.userAgent) || d.isLocalRegistration ? {watcher: true} : {})});
+const callView = (c) => ({
+  id: c.id,
+  direction: c.direction,
+  state: c.state,
+  remoteNumber: c.remoteNumber,
+  remoteName: c.remoteName,
+  tags: c.tags,
+  recording: c.recording,
+  endReason: c.endReason,
+});
+const deviceView = (d) => ({
+  contact: d.uri,
+  name: d.deviceName,
+  userAgent: d.userAgent,
+  ...(isWatcher(d.userAgent) || d.isLocalRegistration ? {watcher: true} : {}),
+});
 
 // Connects as a SIP user of the extension and waits for the first call state. setup(cc, extension) adds the
 // listeners before the connection. The registration asks for 120 s, so a watcher killed instead of stopped leaves
@@ -73,7 +123,16 @@ async function openSip(ctx, setup) {
   const extension = extensionOf(ctx.token);
   const {wsUrl, domain} = sipEndpoint(ctx.token, ctx.env);
   const password = await sipPassword(ctx, extension);
-  const cc = new CallControl({domain, wsUrl, extension, password, userAgent: WATCHER_USER_AGENT, expires: 120, WebSocketImpl: sipIo.WebSocket ?? globalThis.WebSocket, ...sipIo.options});
+  const cc = new CallControl({
+    domain,
+    wsUrl,
+    extension,
+    password,
+    userAgent: WATCHER_USER_AGENT,
+    expires: 120,
+    WebSocketImpl: sipIo.WebSocket ?? globalThis.WebSocket,
+    ...sipIo.options,
+  });
   cc.on('error', () => {}); // a one-shot command reports only its own failure
   setup?.(cc, extension);
   try {
@@ -90,7 +149,10 @@ async function openSip(ctx, setup) {
 async function sipCommand(ctx, command, callId, action) {
   const cc = await openSip(ctx);
   try {
-    if (!cc.getActiveCalls().some((call) => call.id === callId)) throw new PbxError(`no current call of this user has the id ${callId} (see: wx phone list --sip or wx phone list)`);
+    if (!cc.getActiveCalls().some((call) => call.id === callId))
+      throw new PbxError(
+        `no current call of this user has the id ${callId} (see: wx phone list --sip or wx phone list)`,
+      );
     try {
       await action(cc);
     } catch (e) {
@@ -130,7 +192,11 @@ function eventText(e, ctx) {
       if (d.presence?.status) parts.push(`presence ${d.presence.status}`);
       if (d.devices) parts.push(`${d.devices.filter((x) => !x.watcher).length} device(s)`);
       if (d.activeDevice) parts.push(`ringing ${activeDeviceText(d.activeDevice)}`);
-      line = [c.bold(e.event === 'READY' ? 'ready' : 'reconnected'), parts.join(', '), ...(d.calls ?? []).map((call) => `\n  ${compactTable([callRow(call, c)])[0]}`)].join(' ');
+      line = [
+        c.bold(e.event === 'READY' ? 'ready' : 'reconnected'),
+        parts.join(', '),
+        ...(d.calls ?? []).map((call) => `\n  ${compactTable([callRow(call, c)])[0]}`),
+      ].join(' ');
       break;
     }
     case 'CALL_START':
@@ -202,7 +268,14 @@ const phone = {
         };
       },
       text(r) {
-        const rows = [['Extension', r.extension], ['Name', r.name], ['E-mail', r.email], ['Role', r.role], ['License', r.license], ['PBX', r.pbx]];
+        const rows = [
+          ['Extension', r.extension],
+          ['Name', r.name],
+          ['E-mail', r.email],
+          ['Role', r.role],
+          ['License', r.license],
+          ['PBX', r.pbx],
+        ];
         return table(rows.filter(([, v]) => v !== null && v !== undefined && v !== ''));
       },
     },
@@ -212,7 +285,9 @@ const phone = {
       details:
         'REST (default): {calls: [{sipCallId, callerNumber, callerName, calleeNumber, calleeName, state, duration}], total}; state is the PBX channel state (Up also when held).\n' +
         '--sip: {calls: [{id, direction, state ringing|answered|held, remoteNumber, remoteName, tags, recording}]} over a short SIP registration (it shows hold and the number dialled).',
-      options: {sip: {type: 'boolean', description: 'the calls as SIP sees them (held, direction, recording, number dialled)'}},
+      options: {
+        sip: {type: 'boolean', description: 'the calls as SIP sees them (held, direction, recording, number dialled)'},
+      },
       args: [0, 0],
       async run(ctx) {
         if (!ctx.values.sip) return pbxCall(ctx, 'GET', '/list-calls/');
@@ -224,7 +299,8 @@ const phone = {
       text: (r, ctx) => callsText(r.calls, ctx),
     },
     call: {
-      summary: 'place a call from your device: it rings first and dials when you pick up, or starts at once on --device',
+      summary:
+        'place a call from your device: it rings first and dials when you pick up, or starts at once on --device',
       usage: 'wx phone call <number> [--mobile | --any | --device CONTACT]',
       details:
         'Click-to-call. A number is an extension, a phone number (spaces, dashes, dots and brackets are dropped) or a code like *76.\n' +
@@ -234,30 +310,43 @@ const phone = {
       options: {
         mobile: {type: 'boolean', description: 'ring your mobile number (from the PBX settings) first'},
         any: {type: 'boolean', description: 'ring all your devices first'},
-        device: {type: 'string', placeholder: 'CONTACT', description: 'place the call on this device (contact from wx phone devices); on the active one at once'},
+        device: {
+          type: 'string',
+          placeholder: 'CONTACT',
+          description: 'place the call on this device (contact from wx phone devices); on the active one at once',
+        },
       },
       args: [1, 1],
       async run(ctx) {
         const {values} = ctx;
         const destination = normNumber(ctx.positionals[0]);
-        if ([values.mobile, values.any, values.device !== undefined].filter(Boolean).length > 1) throw new UsageError('give one of --mobile, --any, --device', ctx.usage());
+        if ([values.mobile, values.any, values.device !== undefined].filter(Boolean).length > 1)
+          throw new UsageError('give one of --mobile, --any, --device', ctx.usage());
         const body = {destination};
         if (values.mobile) body.callType = 'mobility';
         else if (values.any) body.callType = 'any';
-        else if (values.device !== undefined) Object.assign(body, {callType: 'device', deviceContact: checkContact(values.device)});
+        else if (values.device !== undefined)
+          Object.assign(body, {callType: 'device', deviceContact: checkContact(values.device)});
         else {
           // With no active device the PBX takes the first registered one, which may be a SIP watcher (it turns every
           // call down). Pick the device here: the active one, else the first real one.
           const list = await pbxCall(ctx, 'GET', '/list-devices/');
           const real = (list?.devices ?? []).filter((d) => !isWatcher(d.userAgent));
           const device = [...real.filter((d) => d.active), ...real][0]?.contact;
-          if (!device) throw new PbxError('no device of this user is online to place the call from: open x-bees or a Wildix phone, or call through the mobile (--mobile)');
+          if (!device)
+            throw new PbxError(
+              'no device of this user is online to place the call from: open x-bees or a Wildix phone, or call through the mobile (--mobile)',
+            );
           body.deviceContact = device;
         }
         return pbxAction(ctx, 'POST', '/make-call/', body);
       },
       text(r, ctx) {
-        if (ctx.values.device !== undefined) return [actionText(r), 'The call is placed on the device you named (on your active device it starts at once).'];
+        if (ctx.values.device !== undefined)
+          return [
+            actionText(r),
+            'The call is placed on the device you named (on your active device it starts at once).',
+          ];
         const where = ctx.values.mobile ? 'your mobile' : ctx.values.any ? 'your devices' : 'your device';
         return [actionText(r), `The PBX rings ${where} first; it dials the number when you pick up.`];
       },
@@ -265,7 +354,13 @@ const phone = {
     answer: {
       summary: 'answer a ringing call (on a device that can answer remotely: a Wildix phone, x-bees)',
       usage: 'wx phone answer <callId> [--device CONTACT]',
-      options: {device: {type: 'string', placeholder: 'CONTACT', description: 'answer on this device (its contact from wx phone devices)'}},
+      options: {
+        device: {
+          type: 'string',
+          placeholder: 'CONTACT',
+          description: 'answer on this device (its contact from wx phone devices)',
+        },
+      },
       ...callIdArg,
       async run(ctx) {
         const body = {sipCallId: checkCallId(ctx.positionals[0])};
@@ -284,7 +379,10 @@ const phone = {
       args: [2, 2],
       async run(ctx) {
         const [id, number] = ctx.positionals;
-        return pbxAction(ctx, 'POST', '/blind-transfer/', {sipCallId: checkCallId(id), destination: normNumber(number)});
+        return pbxAction(ctx, 'POST', '/blind-transfer/', {
+          sipCallId: checkCallId(id),
+          destination: normNumber(number),
+        });
       },
       text: actionText,
     },
@@ -309,7 +407,8 @@ const phone = {
         const id = checkCallId(ctx.positionals[0]);
         const digits = checkDigits(ctx.positionals[1]);
         let out;
-        for (let i = 0; i < digits.length; i += DTMF_PART) out = await pbxAction(ctx, 'POST', '/dtmf/', {sipCallId: id, digits: digits.slice(i, i + DTMF_PART)});
+        for (let i = 0; i < digits.length; i += DTMF_PART)
+          out = await pbxAction(ctx, 'POST', '/dtmf/', {sipCallId: id, digits: digits.slice(i, i + DTMF_PART)});
         return out;
       },
       text: actionText,
@@ -325,9 +424,11 @@ const phone = {
       async run(ctx) {
         const {values} = ctx;
         const body = {sipCallId: checkCallId(ctx.positionals[0])};
-        if (values.name === undefined && values.number === undefined) throw new UsageError('give --name, --number or both', ctx.usage());
+        if (values.name === undefined && values.number === undefined)
+          throw new UsageError('give --name, --number or both', ctx.usage());
         if (values.name !== undefined) {
-          if (!values.name || values.name.length > NAME_MAX) throw new UsageError(`--name takes 1 to ${NAME_MAX} characters`);
+          if (!values.name || values.name.length > NAME_MAX)
+            throw new UsageError(`--name takes 1 to ${NAME_MAX} characters`);
           body.name = values.name;
         }
         if (values.number !== undefined) body.number = normNumber(values.number);
@@ -342,7 +443,8 @@ const phone = {
       args: [0, 0],
       async run(ctx) {
         const r = await pbxCall(ctx, 'GET', '/list-devices/');
-        if (Array.isArray(r?.devices)) r.devices = r.devices.map((d) => (isWatcher(d.userAgent) ? {...d, watcher: true} : d));
+        if (Array.isArray(r?.devices))
+          r.devices = r.devices.map((d) => (isWatcher(d.userAgent) ? {...d, watcher: true} : d));
         return r;
       },
       text: (r, ctx) => devicesText(r.devices, ctx),
@@ -357,7 +459,8 @@ const phone = {
       args: [0, 1],
       async run(ctx) {
         const {values, positionals} = ctx;
-        if ([values.mobile, values.any, positionals.length > 0].filter(Boolean).length !== 1) throw new UsageError('give one device contact, --mobile or --any', ctx.usage());
+        if ([values.mobile, values.any, positionals.length > 0].filter(Boolean).length !== 1)
+          throw new UsageError('give one device contact, --mobile or --any', ctx.usage());
         let body;
         if (values.mobile) body = {deviceType: 'mobility'};
         else if (values.any) body = {deviceType: 'any'};
@@ -366,7 +469,8 @@ const phone = {
           // The PBX wants the device's user agent too: take it from the registration of that contact.
           const list = await pbxCall(ctx, 'GET', '/list-devices/');
           const ua = (list?.devices ?? []).find((d) => d.contact === contact)?.userAgent;
-          if (!ua) throw new PbxError(`no registered device of this user has the contact ${contact} (see: wx phone devices)`);
+          if (!ua)
+            throw new PbxError(`no registered device of this user has the contact ${contact} (see: wx phone devices)`);
           if (isWatcher(ua)) throw new PbxError('this is a SIP watcher, not a phone: it cannot carry a call');
           body = {deviceType: 'device', contact, userAgent: ua};
         }
@@ -389,7 +493,8 @@ const phone = {
       args: [0, 0],
       async run(ctx) {
         const {values} = ctx;
-        if (values.for !== undefined && !/^\d{1,7}$/.test(values.for)) throw new UsageError(`--for takes whole seconds: ${values.for}`);
+        if (values.for !== undefined && !/^\d{1,7}$/.test(values.for))
+          throw new UsageError(`--for takes whole seconds: ${values.for}`);
         const seconds = Number(values.for ?? 0);
         const all = !values['calls-only'];
         const emit = (event, data) => ctx.emit({event, data: data ?? {}});
@@ -404,7 +509,13 @@ const phone = {
             emit(readyOnce ? 'RECONNECTED' : 'READY', {
               extension,
               calls: cc.getActiveCalls().map(callView),
-              ...(all ? {devices: cc.getDevices().map(deviceView), presence: cc.getPresence(), activeDevice: cc.getActiveDevice()} : {}),
+              ...(all
+                ? {
+                    devices: cc.getDevices().map(deviceView),
+                    presence: cc.getPresence(),
+                    activeDevice: cc.getActiveDevice(),
+                  }
+                : {}),
             });
             readyOnce = true;
           });
@@ -427,7 +538,8 @@ const phone = {
       async run(ctx) {
         const id = checkCallId(ctx.positionals[0]);
         const action = ctx.positionals[1];
-        if (!RECORD_ACTIONS.includes(action)) throw new UsageError(`record takes ${RECORD_ACTIONS.join(', ')}: ${action}`, ctx.usage());
+        if (!RECORD_ACTIONS.includes(action))
+          throw new UsageError(`record takes ${RECORD_ACTIONS.join(', ')}: ${action}`, ctx.usage());
         return sipCommand(ctx, 'record', id, (cc) => cc.record(id, action));
       },
       text: (r, ctx) => `record ${ctx.positionals[1]}: the PBX took it (call ${r.callId})`,