wldx-cli 1.0.0 → 1.2.0

package/src/cli.mjs

@@ -1,256 +1,17 @@
-// The router: `wx <group> <command> [options]` and `wx <command> [options]`. The commands are listed in
-// src/commands/index.mjs. What run() returns is printed on stdout: as text by default (the command's text()
-// formatter, else toText()), as JSON with --output json (--pretty indents it). A streaming command prints one
-// line per event with ctx.emit() (text, or one JSON object per line) and returns nothing. Like the internal Wildix
-// CLI, --output, --pretty and --no-color may stand anywhere on the command line.
-//
-// The context of run():
-//   values, positionals     parsed options and arguments
-//   token                   a valid IdToken when the command needs auth (undefined otherwise)
-//   freshToken()            a valid IdToken again (renewed when it expired): for long-running commands
-//   profile                 the --profile value (or undefined)
-//   client(factory)         factory({token, env, fetchImpl}): a service client bound to the token
-//   emit(data)              print one JSON line on stdout now (streaming commands)
-//   info(text)              print a line for the person on stderr (progress, prompts); never data
-//   signal                  aborted on Ctrl-C / SIGTERM: long-running commands stop and return
-//   output ('text'|'json'), color (colors allowed)
-//   env, stdin, stdout, stderr, fetch, WebSocket, now (ms at the start), clock() (ms now), cwd
-import path from 'node:path';
-import {parseArgs} from 'node:util';
-import {getToken} from './auth.mjs';
-import {COMMON_OPTIONS, GLOBAL_OPTIONS, REGISTRY, commandOf, groupOf, singleOf} from './commands/index.mjs';
-import {SHELLS, TOP_LEVEL, complete, completionScript, completionUsage} from './completion.mjs';
-import {AuthError, UsageError} from './errors.mjs';
-import {clean, toText} from './format.mjs';
+// wx: the spec of the command line (its commands, its lines in the help) on the router of wldx-core.
+import {createMain} from 'wldx-core/cli';
+import {complete as completeOf} from 'wldx-core/completion';
+import {setProgram} from 'wldx-core/program';
+import {COMMANDS, GROUPS} from './commands/index.mjs';
 import {VERSION} from './version.mjs';
 
-const OUTPUTS = GLOBAL_OPTIONS.output.choices;
+setProgram({name: 'wx', pkg: 'wldx-cli', version: VERSION});
 
-// The value of an option given as `--name value` or `--name=value` at argv[i]; [value, next index] or undefined.
-function valueOf(argv, i, names) {
-  const a = argv[i];
-  for (const name of names) {
-    if (a === `--${name}`) return [argv[i + 1], i + 1, name];
-    if (a.startsWith(`--${name}=`)) return [a.slice(name.length + 3), i, name];
-  }
-  return undefined;
-}
+export const SPEC = {
+  groups: GROUPS,
+  commands: COMMANDS,
+  help: {exitCodes: 'Exit codes: 0 done, 1 error, 2 not logged in, 3 nothing to show (no transcript), 64 wrong usage.'},
+};
 
-// Takes --output, --pretty, --no-color and --profile out of the arguments, wherever they stand (up to a "--").
-export function takeGlobals(argv) {
-  const g = {output: 'text', pretty: false, color: true, profile: undefined};
-  const rest = [];
-  for (let i = 0; i < argv.length; i += 1) {
-    const a = argv[i];
-    if (a === '--') {
-      rest.push(...argv.slice(i));
-      break;
-    }
-    const profile = valueOf(argv, i, ['profile']);
-    if (profile) {
-      const [value, next, name] = profile;
-      if (!value || value.startsWith('--')) throw new UsageError(`--${name} needs a profile: the e-mail of a login`);
-      if (g.profile !== undefined && g.profile.toLowerCase() !== value.toLowerCase()) throw new UsageError(`Two profiles given: ${g.profile} and ${value}`);
-      g.profile = value;
-      i = next;
-      continue;
-    }
-    if (a === '--output' || a.startsWith('--output=')) {
-      g.output = a === '--output' ? argv[(i += 1)] : a.slice('--output='.length);
-      if (!OUTPUTS.includes(g.output)) throw new UsageError(`--output must be one of ${OUTPUTS.join(', ')}${g.output === undefined ? '' : `: ${g.output}`}`);
-    } else if (a === '--pretty') g.pretty = true;
-    else if (a === '--no-color') g.color = false;
-    else rest.push(a);
-  }
-  return {globals: g, rest};
-}
-
-function render(data, formatter, ctx, pretty) {
-  if (ctx.output === 'json') return JSON.stringify(data, null, pretty ? 2 : 0);
-  const t = formatter ? formatter(data, ctx) : toText(data);
-  return clean(Array.isArray(t) ? t.join('\n') : String(t ?? ''));
-}
-
-const pad = (s, n) => s + ' '.repeat(Math.max(1, n - s.length));
-
-function mainUsage(registry) {
-  return [
-    'Usage: wx <command> [options]',
-    '',
-    'Commands:',
-    ...Object.entries(registry.groups).map(([name, g]) => `  ${pad(name, 14)}${g.summary}`),
-    ...Object.entries(registry.commands).map(([name, c]) => `  ${pad(name, 14)}${c.summary}`),
-    ...Object.entries(TOP_LEVEL).map(([name, summary]) => `  ${pad(name, 14)}${summary}`),
-    '',
-    'Options:',
-    '  --output text|json  text for people (default), JSON for scripts and agents',
-    '  --pretty            indent the JSON',
-    '  --no-color          no colors in the text',
-    '  --profile EMAIL     the profile (a logged-in e-mail) to use; else WILDIX_EMAIL, else the default',
-    '  -h, --help          help of wx, a command or a subcommand',
-    '  -v, --version       the version of wx',
-    '',
-    'Exit codes: 0 done, 1 error, 2 not logged in, 3 nothing to show (no transcript), 64 wrong usage.',
-    'Without installing: npx wldx-cli <command>',
-  ].join('\n');
-}
-
-function groupUsage(name, g) {
-  return [`Usage: wx ${name} <command> [options]`, '', ...Object.values(g.commands).flatMap((cmd) => [`  ${cmd.usage}`, `      ${cmd.summary}`])].join('\n');
-}
-
-function commandUsage(cmd) {
-  const options = Object.entries({...cmd.options, ...COMMON_OPTIONS, ...GLOBAL_OPTIONS}).map(([name, o]) => {
-    const value = o.choices && o.choices.length <= 8 ? o.choices.join('|') : o.placeholder ?? 'VALUE';
-    const flag = `${o.short ? `-${o.short}, ` : ''}--${name}${o.type === 'string' ? ` ${value}` : ''}`;
-    const values = o.choices && o.choices.length > 8 ? ` (one of: ${o.choices.join(', ')})` : '';
-    return `  ${pad(flag, 34)}${o.description ?? ''}${o.multiple ? ' (repeatable)' : ''}${values}`;
-  });
-  return [`Usage: ${cmd.usage}`, '', cmd.summary, ...(cmd.details ? ['', cmd.details] : []), '', 'Options:', ...options].join('\n');
-}
-
-function line(stream, text) {
-  stream.write(text.endsWith('\n') ? text : `${text}\n`);
-}
-
-function completion(args, io) {
-  if (args.includes('-h') || args.includes('--help')) return line(io.stdout, completionUsage());
-  if (args.length > 1) throw new UsageError('wx completion takes one shell', completionUsage());
-  const shell = args[0] ?? path.basename(io.env.SHELL ?? '');
-  const script = completionScript(shell);
-  if (!script) throw new UsageError(`No completion for the shell "${shell}": give one of ${SHELLS.join(', ')}`, completionUsage());
-  line(io.stdout, script);
-}
-
-// Ctrl-C and SIGTERM abort ctx.signal once; a second Ctrl-C leaves it to Node (exit).
-function stopSignal(io) {
-  if (io.signal) return {signal: io.signal, dispose() {}};
-  const controller = new AbortController();
-  const onSignal = () => {
-    process.off('SIGINT', onSignal);
-    process.off('SIGTERM', onSignal);
-    controller.abort();
-  };
-  process.on('SIGINT', onSignal);
-  process.on('SIGTERM', onSignal);
-  return {signal: controller.signal, dispose: onSignal};
-}
-
-async function runCommand(cmd, args, needsAuth, io) {
-  const options = {...COMMON_OPTIONS, ...cmd.options};
-  let parsed;
-  try {
-    parsed = parseArgs({args, options, allowPositionals: true, strict: true});
-  } catch (e) {
-    if (String(e.code).startsWith('ERR_PARSE_ARGS')) throw new UsageError(e.message, commandUsage(cmd));
-    throw e;
-  }
-  const {values, positionals} = parsed;
-  if (values.help) return line(io.stdout, commandUsage(cmd));
-  if (io.globals.profile !== undefined) values.profile = io.globals.profile;
-  for (const [name, o] of Object.entries(options)) {
-    const given = values[name] === undefined ? [] : [values[name]].flat();
-    const bad = o.choices && given.find((v) => !o.choices.includes(v));
-    if (bad !== undefined) throw new UsageError(`--${name} must be one of ${o.choices.join(', ')}: ${bad}`, commandUsage(cmd));
-  }
-  const [min, max] = cmd.args;
-  if (positionals.length < min || positionals.length > max) {
-    throw new UsageError(positionals.length < min ? 'Missing arguments' : `Unexpected argument: ${positionals[max]}`, commandUsage(cmd));
-  }
-
-  const freshToken = () => getToken({profile: values.profile, env: io.env, fetchImpl: io.fetch, now: io.now()});
-  const token = needsAuth ? await freshToken() : undefined;
-  const stop = stopSignal(io);
-  const ctx = {
-    values,
-    positionals,
-    token,
-    freshToken,
-    profile: values.profile,
-    client: (factory) => factory({token, env: io.env, fetchImpl: io.fetch}),
-    output: io.globals.output,
-    color: io.globals.color && !io.env.NO_COLOR && Boolean(io.stdout.isTTY),
-    emit: (data) => {
-      const text = io.globals.output === 'json' ? JSON.stringify(data) : render(data, cmd.textEvent ?? cmd.text, ctx);
-      if (text) line(io.stdout, text);
-    },
-    info: (text) => line(io.stderr, clean(text)),
-    signal: stop.signal,
-    usage: () => commandUsage(cmd),
-    env: io.env,
-    stdin: io.stdin,
-    stdout: io.stdout,
-    stderr: io.stderr,
-    fetch: io.fetch,
-    WebSocket: io.WebSocket, // only when injected (tests); a command falls back to globalThis.WebSocket
-    now: io.now(),
-    clock: io.now,
-    cwd: io.cwd,
-  };
-  try {
-    const result = await cmd.run(ctx);
-    if (result !== undefined) {
-      const text = render(result, cmd.text, ctx, io.globals.pretty);
-      if (text) line(io.stdout, text);
-    }
-  } finally {
-    stop.dispose();
-  }
-}
-
-async function dispatch(all, io) {
-  const registry = io.registry;
-  const {globals, rest: argv} = takeGlobals(all);
-  io.globals = globals;
-  const [first, sub, ...rest] = argv;
-  if (!first || first === '-h' || first === '--help' || first === 'help') return line(io.stdout, mainUsage(registry));
-  if (first === '-v' || first === '--version') return line(io.stdout, VERSION);
-  if (first === '__complete') {
-    const out = complete(argv.slice(sub === '--' ? 2 : 1), io.env, registry);
-    if (out.length) line(io.stdout, out.join('\n'));
-    return;
-  }
-  if (first === 'completion') return completion(argv.slice(1), io);
-
-  const single = singleOf(first, registry);
-  if (single) return runCommand(single, argv.slice(1), Boolean(single.auth), io);
-
-  const group = groupOf(first, registry);
-  if (!group) throw new UsageError(`Unknown command: ${first}`, mainUsage(registry));
-  if (sub === '-h' || sub === '--help') return line(io.stdout, groupUsage(first, group));
-  if (!sub) throw new UsageError(`wx ${first} needs a command`, groupUsage(first, group));
-  const cmd = commandOf(group, sub);
-  if (!cmd) throw new UsageError(`Unknown command: wx ${first} ${sub}`, groupUsage(first, group));
-  return runCommand(cmd, rest, Boolean(cmd.auth ?? group.auth), io);
-}
-
-// Runs wx with the arguments and returns the exit code: 0 done, 1 error, 2 not logged in, 3 nothing to show (an
-// error with exitCode 3, e.g. no transcript), 64 wrong usage.
-// io replaces the process streams, environment, fetch, clock and (in tests) the commands themselves.
-export async function main(argv, io = {}) {
-  io = {
-    stdout: process.stdout,
-    stderr: process.stderr,
-    stdin: process.stdin,
-    env: process.env,
-    fetch: globalThis.fetch,
-    now: Date.now,
-    cwd: process.cwd(),
-    registry: REGISTRY,
-    ...io,
-  };
-  try {
-    await dispatch(argv, io);
-    return 0;
-  } catch (e) {
-    line(io.stderr, `wx: ${clean(e.message)}`);
-    if (e instanceof UsageError) {
-      if (e.usage) line(io.stderr, `\n${e.usage}`);
-      return 64;
-    }
-    if (e instanceof AuthError) return 2;
-    if (Number.isInteger(e.exitCode)) return e.exitCode;
-    if (io.env.WX_DEBUG === '1' && e.stack) line(io.stderr, e.stack);
-    return 1;
-  }
-}
+export const main = createMain(SPEC);
+export const complete = (words, env = process.env) => completeOf(words, env, SPEC);

package/src/commands/calls.mjs

@@ -1,11 +1,22 @@
 // wx calls: the user's own call history (as the PBX recorded it) and one call after the fact: its record, the
 // transcript, the AI summary and insights, the characteristics, the recordings. 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} from '../http.mjs';
+import {UsageError} from 'wldx-core/errors';
+import {localTime, oneLine, table} from 'wldx-core/format';
+import {apiPath} from 'wldx-core/http';
 import {insightLines, millis, party, secs, summaryLines} from '../history/text.mjs';
-import {NoDataError, alt, callFlow, checkIso, compactInsights, intOption, isoSeconds, optional, wdaClient, writePrivate} from '../history/wda.mjs';
+import {
+  NoDataError,
+  alt,
+  callFlow,
+  checkIso,
+  compactInsights,
+  intOption,
+  isoSeconds,
+  optional,
+  wdaClient,
+  writePrivate,
+} from '../history/wda.mjs';
 
 const CALL_ARGS = '<callId> [flow]';
 
@@ -13,7 +24,10 @@ const callPath = ({callId, flow}) => apiPath`/${callId}/flows/${String(flow)}`;
 
 // The user call history gives durations in seconds; the record of one call in milliseconds. The start and the end
 // are milliseconds in both, so the length of a call comes from them when they are there.
-const lengthSec = (c) => (Number.isFinite(c.startTime) && Number.isFinite(c.endTime) ? Math.round((c.endTime - c.startTime) / 1000) : Math.round(c.duration ?? 0));
+const lengthSec = (c) =>
+  Number.isFinite(c.startTime) && Number.isFinite(c.endTime)
+    ? Math.round((c.endTime - c.startTime) / 1000)
+    : Math.round(c.duration ?? 0);
 
 const hasRecording = (c) => (c.recordingsData ?? []).length > 0 || (c.attachments ?? []).some((a) => a?.recording);
 
@@ -33,7 +47,10 @@ export function briefHistoryCall(c) {
   };
 }
 
-const person = (p) => (p ? {name: p.name ?? null, phone: p.phone ?? null, extension: p.userExtension ?? null, email: p.email ?? null} : {name: null, phone: null, extension: null, email: null});
+const person = (p) =>
+  p
+    ? {name: p.name ?? null, phone: p.phone ?? null, extension: p.userExtension ?? null, email: p.email ?? null}
+    : {name: null, phone: null, extension: null, email: null};
 
 // `calls brief`: the record, the summary and the insights as one readable object.
 export function briefCall(id, rec, sum, ins) {
@@ -53,7 +70,10 @@ export function briefCall(id, rec, sum, ins) {
     tags: c.tags ?? [],
     transcriptionStatus: c.transcriptionStatus ?? null,
     hasRecording: hasRecording(c),
-    summary: sum?.status === 'SUCCEEDED' ? {title: sum.summary?.title ?? null, brief: sum.summary?.brief ?? null} : {status: sum?.status ?? 'UNKNOWN'},
+    summary:
+      sum?.status === 'SUCCEEDED'
+        ? {title: sum.summary?.title ?? null, brief: sum.summary?.brief ?? null}
+        : {status: sum?.status ?? 'UNKNOWN'},
     insights: compactInsights(ins),
   };
 }
@@ -73,15 +93,28 @@ export function recordingsOf(c) {
 
 // The history filter of `list` and `missed`.
 const LIST_OPTIONS = {
-  direction: {type: 'string', choices: ['INTERNAL', 'INBOUND', 'OUTBOUND'], description: 'only calls of this direction'},
+  direction: {
+    type: 'string',
+    choices: ['INTERNAL', 'INBOUND', 'OUTBOUND'],
+    description: 'only calls of this direction',
+  },
   status: {type: 'string', choices: ['COMPLETED', 'MISSED'], description: 'only answered (COMPLETED) or missed calls'},
-  flag: {type: 'string', multiple: true, choices: ['FAX', 'VOICEMAIL'], description: 'only calls with a fax or a voicemail'},
+  flag: {
+    type: 'string',
+    multiple: true,
+    choices: ['FAX', 'VOICEMAIL'],
+    description: 'only calls with a fax or a voicemail',
+  },
   from: {type: 'string', placeholder: 'ISO', description: 'calls from this time (ISO, e.g. 2026-11-01T00:00:00Z)'},
   to: {type: 'string', placeholder: 'ISO', description: 'calls up to this time (ISO)'},
   search: {type: 'string', placeholder: 'TEXT', description: 'a name or a number to search for'},
   tag: {type: 'string', multiple: true, placeholder: 'TAG', description: 'only calls with this tag'},
   'has-attachment': {type: 'boolean', description: 'only calls with an attachment (a recording, a fax, a voicemail)'},
-  'user-direction': {type: 'string', choices: ['INCOMING', 'OUTGOING'], description: 'only calls you received or placed'},
+  'user-direction': {
+    type: 'string',
+    choices: ['INCOMING', 'OUTGOING'],
+    description: 'only calls you received or placed',
+  },
   limit: {type: 'string', placeholder: '1-100', description: 'calls per page (50 by default, at most 100)'},
   offset: {type: 'string', placeholder: 'N', description: 'skip this many calls (the next page)'},
   brief: {type: 'boolean', description: 'one short object per call: id, start, duration, direction, status, from, to'},
@@ -129,7 +162,17 @@ function recordText(r) {
   const rows = [
     ['Call', `${c.id ?? ''} flow ${c.flowIndex ?? 0}`],
     ['Start', localTime(c.startTime, {seconds: true})],
-    ['Duration', [millis(c.duration), Number.isFinite(c.talkTime) && `talk ${millis(c.talkTime)}`, c.waitTime && `wait ${millis(c.waitTime)}`, c.holdTime && `hold ${millis(c.holdTime)}`].filter(Boolean).join(' · ')],
+    [
+      'Duration',
+      [
+        millis(c.duration),
+        Number.isFinite(c.talkTime) && `talk ${millis(c.talkTime)}`,
+        c.waitTime && `wait ${millis(c.waitTime)}`,
+        c.holdTime && `hold ${millis(c.holdTime)}`,
+      ]
+        .filter(Boolean)
+        .join(' · '),
+    ],
     ['Direction', [c.direction, c.callStatus].filter(Boolean).join(' · ')],
     ['From', party(c.caller)],
     ['To', party(c.callee)],
@@ -138,14 +181,18 @@ function recordText(r) {
   if (c.service) rows.push(['Service', c.service]);
   if (c.trunkName) rows.push(['Trunk', [c.trunkName, c.trunkDirection].filter(Boolean).join(' · ')]);
   if (c.tags?.length) rows.push(['Tags', c.tags.join(', ')]);
-  if (c.transcriptionStatus) rows.push(['Transcript', [c.transcriptionStatus, c.transcriptionLanguage].filter(Boolean).join(' · ')]);
+  if (c.transcriptionStatus)
+    rows.push(['Transcript', [c.transcriptionStatus, c.transcriptionLanguage].filter(Boolean).join(' · ')]);
   const recs = recordingsOf(c);
   if (recs.length) rows.push(['Recordings', String(recs.length)]);
   return table(rows);
 }
 
 function briefText(b) {
-  const who = (p) => [p.name, p.extension && `(${p.extension})`, p.phone && p.phone !== p.extension ? p.phone : undefined].filter(Boolean).join(' ');
+  const who = (p) =>
+    [p.name, p.extension && `(${p.extension})`, p.phone && p.phone !== p.extension ? p.phone : undefined]
+      .filter(Boolean)
+      .join(' ');
   const rows = [
     ['Call', `${b.id} flow ${b.flowIndex ?? 0}`],
     ['Start', localTime(b.start)],
@@ -174,7 +221,8 @@ const group = {
   commands: {
     list: {
       summary: 'your own call history, newest first, 50 per page',
-      usage: 'wx calls list [--direction INTERNAL|INBOUND|OUTBOUND] [--status COMPLETED|MISSED] [--flag FAX|VOICEMAIL]... [--from ISO] [--to ISO] [--search TEXT] [--tag TAG]... [--has-attachment] [--user-direction INCOMING|OUTGOING] [--limit 1-100] [--offset N] [--brief]',
+      usage:
+        'wx calls list [--direction INTERNAL|INBOUND|OUTBOUND] [--status COMPLETED|MISSED] [--flag FAX|VOICEMAIL]... [--from ISO] [--to ISO] [--search TEXT] [--tag TAG]... [--has-attachment] [--user-direction INCOMING|OUTGOING] [--limit 1-100] [--offset N] [--brief]',
       details: 'Calls only (not meetings), as the PBX recorded them. The next page: --offset.',
       options: LIST_OPTIONS,
       args: [0, 0],
@@ -207,7 +255,11 @@ const group = {
         const call = callFlow(ctx.positionals);
         const p = callPath(call);
         const wda = ctx.client(wdaClient);
-        const [rec, sum, ins] = await Promise.all([wda.get(`/history/calls${p}`), optional(wda.get(`/insights/calls${p}/summary`), ctx.info), optional(wda.get(`/insights/calls${p}/insights`), ctx.info)]);
+        const [rec, sum, ins] = await Promise.all([
+          wda.get(`/history/calls${p}`),
+          optional(wda.get(`/insights/calls${p}/summary`), ctx.info),
+          optional(wda.get(`/insights/calls${p}/insights`), ctx.info),
+        ]);
         return briefCall(call.callId, rec, sum, ins);
       },
       text: briefText,
@@ -215,10 +267,18 @@ const group = {
     transcript: {
       summary: 'the dialogue of a call (exit 3 when there is none)',
       usage: `wx calls transcript ${CALL_ARGS} [--to FILE] [--structured]`,
-      details: 'Text: the dialogue, "[MM:SS] Name: text". --output json: the text and its chunks as the service gives them. --structured: the transcription record with the interaction data. --to writes the dialogue to a new private file and prints its path.',
+      details:
+        'Text: the dialogue, "[MM:SS] Name: text". --output json: the text and its chunks as the service gives them. --structured: the transcription record with the interaction data. --to writes the dialogue to a new private file and prints its path.',
       options: {
-        to: {type: 'string', placeholder: 'FILE', description: 'write the dialogue to this new 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 dialogue to this new file (private) and print its path',
+        },
+        structured: {
+          type: 'boolean',
+          description: 'the transcription record: chunks with timing, sentiment, the interaction',
+        },
       },
       args: [1, 2],
       async run(ctx) {
@@ -240,7 +300,11 @@ const group = {
       },
       text(r, ctx) {
         if (r.file) return r.file;
-        if (ctx.values.structured) return structuredLines(r.transcription?.chunks ?? [], r.transcription?.callStartTime ?? r.transcription?.flowStartTime);
+        if (ctx.values.structured)
+          return structuredLines(
+            r.transcription?.chunks ?? [],
+            r.transcription?.callStartTime ?? r.transcription?.flowStartTime,
+          );
         return (r.text ?? '').replace(/\n+$/, '');
       },
     },
@@ -296,20 +360,29 @@ const group = {
         const r = await ctx.client(wdaClient).get(`/history/calls${callPath(callFlow(ctx.positionals))}`);
         return {recordings: recordingsOf(r.call ?? {})};
       },
-      text: (r) => (r.recordings.length ? table(r.recordings.map((x) => [localTime(x.start, {seconds: true}), Number.isFinite(x.start) && Number.isFinite(x.end) ? millis(x.end - x.start) : '', x.url ?? x.fileName ?? ''])) : 'No recordings.'),
+      text: (r) =>
+        r.recordings.length
+          ? table(
+              r.recordings.map((x) => [
+                localTime(x.start, {seconds: true}),
+                Number.isFinite(x.start) && Number.isFinite(x.end) ? millis(x.end - x.start) : '',
+                x.url ?? x.fileName ?? '',
+              ]),
+            )
+          : 'No recordings.',
     },
     'schedule-summary': {
       summary: 'ask the service to generate the summary of a call again (only when asked: it does work)',
       usage: `wx calls schedule-summary ${CALL_ARGS}`,
       options: {},
       args: [1, 2],
-      run: (ctx) => ctx.client(wdaClient).post(`/insights/calls${callPath(callFlow(ctx.positionals))}/schedule_summary_generation`),
+      run: (ctx) =>
+        ctx.client(wdaClient).post(`/insights/calls${callPath(callFlow(ctx.positionals))}/schedule_summary_generation`),
       text: () => 'The summary was scheduled: read it later with wx calls summary.',
     },
   },
 };
 
-
 export const groups = {calls: group};
 
 // Shared with wx meetings.
@@ -320,16 +393,33 @@ export function structuredLines(chunks, start, names = {}) {
   const t0 = Number.isFinite(start) ? start : chunks.find((c) => Number.isFinite(c.start))?.start;
   const ordered = [...chunks].sort((a, b) => (a.start ?? 0) - (b.start ?? 0));
   return ordered.map((c) => {
-    const at = Number.isFinite(c.start) && Number.isFinite(t0) ? Math.max(0, Math.floor((c.start - t0) / 1000)) : undefined;
-    const mmss = at === undefined ? '--:--' : `${String(Math.floor(at / 60)).padStart(2, '0')}:${String(at % 60).padStart(2, '0')}`;
-    const who = c.jid ? names[c.jid] ?? c.jid : typeof c.speaker === 'object' ? c.speaker?.name ?? c.speaker?.type ?? '?' : c.speaker ?? '?';
-    return `[${mmss}] ${who}: ${String(c.text ?? '').replace(/\s+/g, ' ').trim()}`;
+    const at =
+      Number.isFinite(c.start) && Number.isFinite(t0) ? Math.max(0, Math.floor((c.start - t0) / 1000)) : undefined;
+    const mmss =
+      at === undefined
+        ? '--:--'
+        : `${String(Math.floor(at / 60)).padStart(2, '0')}:${String(at % 60).padStart(2, '0')}`;
+    const who = c.jid
+      ? (names[c.jid] ?? c.jid)
+      : typeof c.speaker === 'object'
+        ? (c.speaker?.name ?? c.speaker?.type ?? '?')
+        : (c.speaker ?? '?');
+    return `[${mmss}] ${who}: ${String(c.text ?? '')
+      .replace(/\s+/g, ' ')
+      .trim()}`;
   });
 }
 
 export function annotationLines(list) {
   if (!list.length) return 'No annotations.';
-  return table(list.map((a) => [localTime(a.time, {seconds: true}), a.key ?? '', a.source?.name ?? a.source?.type ?? '', oneLine(JSON.stringify(a.payload ?? {}), 160)]));
+  return table(
+    list.map((a) => [
+      localTime(a.time, {seconds: true}),
+      a.key ?? '',
+      a.source?.name ?? a.source?.type ?? '',
+      oneLine(JSON.stringify(a.payload ?? {}), 160),
+    ]),
+  );
 }
 
 export function insightsText(r) {
@@ -339,7 +429,12 @@ export function insightsText(r) {
   }
   const list = r.insights ?? [];
   if (!list.length) return `No insights${r.status ? ` (${r.status})` : ''}.`;
-  return list.flatMap((p) => [`${p.id}: ${p.status ?? ''}${p.reason ? ` (${p.reason})` : ''}`, ...(p.fields ?? []).map((f) => `  ${f.id}: ${oneLine(typeof f.value === 'object' ? JSON.stringify(f.value) : f.value ?? '', 300)}`)]);
+  return list.flatMap((p) => [
+    `${p.id}: ${p.status ?? ''}${p.reason ? ` (${p.reason})` : ''}`,
+    ...(p.fields ?? []).map(
+      (f) => `  ${f.id}: ${oneLine(typeof f.value === 'object' ? JSON.stringify(f.value) : (f.value ?? ''), 300)}`,
+    ),
+  ]);
 }
 
 export function stateText(r) {
@@ -348,7 +443,12 @@ export function stateText(r) {
   if (s.firstWatchedAt) rows.push(['First watched', localTime(s.firstWatchedAt)]);
   if (s.lastWatchedAt) rows.push(['Last watched', localTime(s.lastWatchedAt)]);
   if (s.playback) rows.push(['Playback', `${millis(s.playback.position)} of ${millis(s.playback.duration)}`]);
-  rows.push(['Playlists', (s.playlists ?? []).length ? s.playlists.map((p) => (typeof p === 'object' ? p.name ?? p.id : p)).join(', ') : 'none']);
+  rows.push([
+    'Playlists',
+    (s.playlists ?? []).length
+      ? s.playlists.map((p) => (typeof p === 'object' ? (p.name ?? p.id) : p)).join(', ')
+      : 'none',
+  ]);
   return table(rows);
 }
 
@@ -357,11 +457,14 @@ function characteristicsText(r) {
   if (!c) return `No characteristics${r.status ? ` (${r.status})` : ''}.`;
   const rows = [];
   if (Number.isFinite(c.duration)) rows.push(['Duration', millis(c.duration)]);
-  for (const t of c.talkTime?.detailsByParticipant ?? []) rows.push([`Talk ${t.interrupter ?? '?'}`, millis(t.totalTime)]);
-  for (const t of c.talkSpeed?.detailsByParticipant ?? []) rows.push([`Speed ${t.interrupter ?? '?'}`, `${Math.round(t.averageWordsPerMinute ?? 0)} words/min`]);
+  for (const t of c.talkTime?.detailsByParticipant ?? [])
+    rows.push([`Talk ${t.interrupter ?? '?'}`, millis(t.totalTime)]);
+  for (const t of c.talkSpeed?.detailsByParticipant ?? [])
+    rows.push([`Speed ${t.interrupter ?? '?'}`, `${Math.round(t.averageWordsPerMinute ?? 0)} words/min`]);
   if (c.interruptions) rows.push(['Interruptions', String((c.interruptions.chunks ?? []).length)]);
   if (c.nonTalkTime) rows.push(['Silences', String((c.nonTalkTime.chunks ?? []).length)]);
   if (c.sentiment && Number.isFinite(c.sentiment.score)) rows.push(['Sentiment', String(c.sentiment.score)]);
-  for (const s of c.sentiment?.scoreByParticipant ?? []) rows.push([`Sentiment ${s.interrupter ?? '?'}`, String(s.score)]);
+  for (const s of c.sentiment?.scoreByParticipant ?? [])
+    rows.push([`Sentiment ${s.interrupter ?? '?'}`, String(s.score)]);
   return [`Status: ${r.status ?? ''}`, ...table(rows)];
 }