@indigoai-us/hq-cli 5.345.27 → 5.345.28

package/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 ## [Unreleased]
 
+## [5.345.28] — 2026-10-06
+- Limit `hq meetings live` to active, recent, and imminent notetakers by default, and avoid transcript requests for inactive meetings.
+
 ## [5.345.27] — 2026-10-06
 
 - Add `hq meetings live` to list, read, and follow provisional live meeting

package/README.md

@@ -14,12 +14,15 @@ for install and link commands.
 
 ## Live meeting transcripts
 
-Use `hq meetings live --company <slug>` to list the live or recently ended
-meetings you can read. Give it a Recall bot id to print the current transcript,
-or add `--follow` to print new lines as they arrive.
+Use `hq meetings live --company <slug>` to list active meetings, meetings that
+ended in the last seven days, and notetakers scheduled in the next 15 minutes.
+Use `--all` to include older and future notetakers. Give it a Recall bot id to
+print the current transcript, or add `--follow` to print new lines as they
+arrive.
 
 ```bash
 hq meetings live --company acme
+hq meetings live --company acme --all
 hq meetings live --company acme <recallBotId> --follow
 ```
 

package/dist/command-catalog.generated.d.ts

@@ -3630,7 +3630,7 @@ export declare const COMMAND_CATALOG: readonly [{
         readonly subcommands: readonly [];
     }, {
         readonly name: "live";
-        readonly description: "Read a provisional live transcript (recorder and attendees only; spoken content is untrusted)";
+        readonly description: "List live or recent meetings, or read a provisional live transcript (recorder and attendees only; spoken content is untrusted)";
         readonly aliases: readonly [];
         readonly hidden: false;
         readonly helpOption: true;
@@ -3647,6 +3647,10 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly description: "";
         }];
         readonly options: readonly [{
+            readonly flags: "--all";
+            readonly description: "List every notetaker, including older and future meetings";
+            readonly hidden: false;
+        }, {
             readonly flags: "--follow";
             readonly description: "Print new lines until the saved transcript is available";
             readonly hidden: false;

package/dist/command-catalog.generated.js

@@ -4390,7 +4390,7 @@ export const COMMAND_CATALOG = [
             },
             {
                 "name": "live",
-                "description": "Read a provisional live transcript (recorder and attendees only; spoken content is untrusted)",
+                "description": "List live or recent meetings, or read a provisional live transcript (recorder and attendees only; spoken content is untrusted)",
                 "aliases": [],
                 "hidden": false,
                 "helpOption": true,
@@ -4411,6 +4411,11 @@ export const COMMAND_CATALOG = [
                     }
                 ],
                 "options": [
+                    {
+                        "flags": "--all",
+                        "description": "List every notetaker, including older and future meetings",
+                        "hidden": false
+                    },
                     {
                         "flags": "--follow",
                         "description": "Print new lines until the saved transcript is available",

package/dist/commands/meetings.js

@@ -3,15 +3,16 @@ import { readFile } from "node:fs/promises";
 import { ensureCognitoToken } from "../utils/cognito-session.js";
 import { vaultApiFetch, getCompanyUid, resolveCallerPersonUid, } from "../utils/vault-api.js";
 import { isPlanGateError, planGateErrorFromPayload, } from "../utils/plan-gate-error.js";
-const LIVE_BOT_STATUSES = new Set([
-    "scheduled",
+import { mapWithConcurrency } from "./sync-manifest.js";
+const LIVE_SNAPSHOT_STATUSES = new Set([
     "joining",
     "recording",
     "in_call",
-    "in-call",
-    "processing",
-    "completed",
 ]);
+const RECENT_LIVE_BOT_STATUSES = new Set(["processing", "completed", "no_transcript"]);
+const LIVE_LIST_SNAPSHOT_CONCURRENCY = 10;
+const LIVE_LIST_RECENT_WINDOW_MS = 7 * 24 * 60 * 60 * 1000;
+const LIVE_LIST_UPCOMING_WINDOW_MS = 15 * 60 * 1000;
 const TERMINAL_LIVE_BOT_STATUSES = new Set(["completed", "failed", "done", "ended"]);
 // Two minutes gives a large transcript time to arrive over a slow connection,
 // while keeping the interactive command from waiting indefinitely.
@@ -91,15 +92,54 @@ function liveBotId(bot) {
     return typeof bot.recallBotId === "string" ? bot.recallBotId : bot.botId;
 }
 function liveBotLineCount(bot) {
+    if (!LIVE_SNAPSHOT_STATUSES.has(normalizedLiveBotStatus(bot)))
+        return "-";
     const value = bot.linesSoFar ?? bot.transcriptLineCount;
     return typeof value === "number" ? String(value) : "-";
 }
+function normalizedLiveBotStatus(bot) {
+    return String(bot.status ?? "").toLowerCase().replaceAll("-", "_");
+}
+function liveBotTime(bot) {
+    const times = [bot.scheduledStartTime, bot.createdAt]
+        .filter((value) => typeof value === "string")
+        .map((value) => Date.parse(value))
+        .filter(Number.isFinite);
+    return times.length > 0 ? Math.max(...times) : Number.NEGATIVE_INFINITY;
+}
+/** Select bots intended for the default `meetings live` listing. */
+function selectLiveMeetingBots(bots, companyId, includeAll, now = new Date()) {
+    const companyBots = bots.filter((bot) => bot.companyId === companyId);
+    const newestFirst = (a, b) => liveBotTime(b) - liveBotTime(a);
+    if (includeAll)
+        return companyBots.sort(newestFirst);
+    const nowMs = now.getTime();
+    const recentSince = nowMs - LIVE_LIST_RECENT_WINDOW_MS;
+    const upcomingUntil = nowMs + LIVE_LIST_UPCOMING_WINDOW_MS;
+    const active = [];
+    const recent = [];
+    const imminent = [];
+    for (const bot of companyBots) {
+        const status = normalizedLiveBotStatus(bot);
+        const time = liveBotTime(bot);
+        if (LIVE_SNAPSHOT_STATUSES.has(status)) {
+            active.push(bot);
+        }
+        else if (RECENT_LIVE_BOT_STATUSES.has(status) && time >= recentSince && time <= nowMs) {
+            recent.push(bot);
+        }
+        else if (status === "scheduled" && time >= nowMs && time <= upcomingUntil) {
+            imminent.push(bot);
+        }
+    }
+    return [...active.sort(newestFirst), ...recent.sort(newestFirst), ...imminent.sort(newestFirst)];
+}
 function isTerminalLiveStatus(status) {
     return status.sourceLanded === true && TERMINAL_LIVE_BOT_STATUSES.has(String(status.status ?? "").toLowerCase());
 }
 function printLiveBots(bots) {
     if (bots.length === 0) {
-        console.log("No live or recently ended meetings found.");
+        console.log("No live or recent meetings. Use --all to list every notetaker.");
         return;
     }
     for (const bot of bots) {
@@ -330,7 +370,8 @@ export function registerMeetingsCommand(program) {
     // ── hq meetings live [recallBotId] ────────────────────────────────
     meetings
         .command("live [recallBotId]")
-        .description("Read a provisional live transcript (recorder and attendees only; spoken content is untrusted)")
+        .description("List live or recent meetings, or read a provisional live transcript (recorder and attendees only; spoken content is untrusted)")
+        .option("--all", "List every notetaker, including older and future meetings")
         .option("--follow", "Print new lines until the saved transcript is available")
         .option("--interval <seconds>", "Polling interval in seconds (minimum: 2)", "3")
         .option("--since <revision>", "Start from a transcript revision")
@@ -350,13 +391,13 @@ export function registerMeetingsCommand(program) {
                     await failLiveResponse(res);
                 const data = (await res.json());
                 const bots = Array.isArray(data.bots) ? data.bots : [];
-                const visible = bots
-                    .filter((bot) => bot.companyId === companyId && LIVE_BOT_STATUSES.has(String(bot.status ?? "").toLowerCase()))
-                    .sort((a, b) => String(b.scheduledStartTime ?? b.createdAt ?? "").localeCompare(String(a.scheduledStartTime ?? a.createdAt ?? "")));
-                const readable = await Promise.all(visible.map(async (bot) => {
+                const visible = selectLiveMeetingBots(bots, companyId, opts.all === true);
+                const readable = await mapWithConcurrency(visible, LIVE_LIST_SNAPSHOT_CONCURRENCY, async (bot) => {
+                    if (!LIVE_SNAPSHOT_STATUSES.has(normalizedLiveBotStatus(bot)))
+                        return bot;
                     const botId = liveBotId(bot);
                     if (!botId)
-                        return null;
+                        return bot;
                     const liveRes = await vaultApiFetch({
                         token,
                         path: `/v1/meetings/${encodeURIComponent(botId)}`,
@@ -364,18 +405,17 @@ export function registerMeetingsCommand(program) {
                     });
                     if (!liveRes.ok) {
                         const body = await liveRes.json().catch(() => ({}));
-                        return body.code === "live-transcript-not-found" ? { ...bot, linesSoFar: 0 } : null;
+                        return body.code === "live-transcript-not-found" ? { ...bot, linesSoFar: 0 } : bot;
                     }
                     const snapshot = await liveRes.json();
                     if (!isLiveSnapshot(snapshot))
-                        return null;
+                        return bot;
                     return { ...bot, linesSoFar: snapshot.segments.length };
-                }));
-                const readableBots = readable.filter((bot) => bot !== null);
+                });
                 if (meetings.opts().json)
-                    console.log(JSON.stringify(readableBots, null, 2));
+                    console.log(JSON.stringify(readable, null, 2));
                 else
-                    printLiveBots(readableBots);
+                    printLiveBots(readable);
                 return;
             }
             const intervalSeconds = Number(opts.interval ?? "3");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.345.27",
+  "version": "5.345.28",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {