@indigoai-us/hq-cli 5.342.16 → 5.342.17

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## [Unreleased]
 
+## [5.342.17] — 2026-10-04
+- Show agent display names in the agents list and accept them when selecting an agent.
+- Resume due blocked keep-alive for story-less standing lead lanes, record no-open-story skips in lane history, and report the latest blocked skip in keep-alive audit.
+
 ## [5.342.16] — 2026-10-04
 - Keep resident command leases until monitor, agent, OAuth, bot, daemon and lane-watch runtime modules and their transitive Cognito, first-sync, hq-cloud and local-file dependencies are preloaded.
 - CI now runs the core utility parity assertions on Ubuntu, macOS, and Windows.

package/dist/commands/agents.d.ts

@@ -127,6 +127,7 @@ export interface CompanyAgentView {
     codexModel?: string;
     codexReasoningEffort?: string;
     codexServiceTier?: string;
+    displayName?: string;
     profile?: {
         displayName?: string;
         title?: string;
@@ -368,12 +369,6 @@ export interface DmThreadMessage {
     /** "out" = sent by the caller; "in" = received (the agent's reply). */
     direction: "in" | "out";
 }
-/**
- * Resolve an agent reference to its `agt_` uid. An `agt_…` value is used
- * directly; anything else is treated as a slug or display name and resolved
- * against the company's roster (requires `--company` or a single active
- * membership).
- */
 export declare function resolveAgentUid(token: string, ref: string, companySlug: string | undefined): Promise<string>;
 /**
  * Fail-closed local guard for the off-box `hq agents jobs` operator commands.

package/dist/commands/agents.js

@@ -996,15 +996,26 @@ function catalogUnavailableMessage() {
  * against the company's roster (requires `--company` or a single active
  * membership).
  */
+function effectiveAgentDisplayName(agent) {
+    return agent.profile?.displayName || agent.displayName || agent.name || "";
+}
 export async function resolveAgentUid(token, ref, companySlug) {
     if (AGENT_UID_PATTERN.test(ref.trim()))
         return ref.trim();
     const companyUid = await getCompanyUid(token, companySlug);
     const roster = await listAgents(token, companyUid);
-    const needle = ref.trim().toLowerCase();
-    const match = roster.find((a) => a.slug?.toLowerCase() === needle ||
-        a.name?.toLowerCase() === needle ||
-        a.uid === ref.trim());
+    const trimmedRef = ref.trim();
+    const needle = trimmedRef.toLowerCase();
+    const exactMatch = roster.find((agent) => agent.slug?.toLowerCase() === needle) ??
+        roster.find((agent) => agent.name?.toLowerCase() === needle) ??
+        roster.find((agent) => agent.uid === trimmedRef);
+    if (exactMatch)
+        return exactMatch.uid;
+    const displayNameMatches = roster.filter((agent) => effectiveAgentDisplayName(agent).toLowerCase() === needle);
+    if (displayNameMatches.length > 1) {
+        throw new AgentsHttpError(409, `More than one agent matches "${ref}" in this company. Use an agent slug or agt_ UID.`);
+    }
+    const match = displayNameMatches[0];
     if (!match) {
         throw new AgentsHttpError(404, `No agent named "${ref}" in this company. Run \`hq agents list\` to see slugs/uids, ` +
             `or pass the agt_ uid directly.`);
@@ -1697,7 +1708,7 @@ export function registerAgentsCommand(program) {
                 console.log(chalk.gray("No agents found for this company."));
                 return;
             }
-            const nameW = Math.max(4, ...roster.map((a) => (a.name ?? "").length));
+            const nameW = Math.max(4, ...roster.map((agent) => effectiveAgentDisplayName(agent).length));
             const slugW = Math.max(4, ...roster.map((a) => (a.slug ?? "").length));
             const statusW = Math.max(6, ...roster.map((a) => rosterStatusLabel(a).length));
             const modelW = Math.max(5, ...roster.map((a) => (a.codexModel ?? "").length));
@@ -1710,7 +1721,7 @@ export function registerAgentsCommand(program) {
             ].join("  ")));
             for (const a of roster) {
                 console.log([
-                    (a.name ?? "").padEnd(nameW),
+                    effectiveAgentDisplayName(a).padEnd(nameW),
                     (a.slug ?? "").padEnd(slugW),
                     rosterStatusLabel(a).padEnd(statusW),
                     (a.codexModel ?? "").padEnd(modelW),

package/dist/lib/lanes/keep-alive-audit.js

@@ -355,8 +355,6 @@ function blockedKeepAliveOutcome(lane, stop, nextEnvelopeMs) {
             : Math.abs(terminal - stop.mtimeMs) <= 10 * 60_000;
         if (!sameStop)
             return [];
-        if (entry.event === "keep_alive_blocked_skipped" && entry.reason !== "flag_off")
-            return [];
         return [{
                 status: entry.event === "keep_alive_blocked_resumed" ? "woken" : "skipped",
                 ...(entry.reason === undefined ? {} : { reason: entry.reason }),

package/dist/lib/lanes/reconcile.js

@@ -2328,8 +2328,9 @@ async function resumeBlockedKeepAlive(hqRoot, lane, questions, summary, deps, no
         recordKeepAliveSkip(hqRoot, lane, "missing_interruption_time", summary, deps, "blocked terminal time is invalid");
         return;
     }
-    if (activeLaneStories(lane).length === 0) {
+    if (laneStories(lane).length > 0 && activeLaneStories(lane).length === 0) {
         summary.skipped.push({ kind: "lane", id: lane.lane_id, why: "keep_alive_no_open_stories" });
+        recordBlockedKeepAliveSkipEvent(hqRoot, lane, "no_open_stories", summary, deps);
         return;
     }
     let pendingQuestion = questions.some((question) => question.lane_id === lane.lane_id && question.status === "pending");
@@ -2496,6 +2497,27 @@ function recordBlockedKeepAliveFlagOff(hqRoot, lane, summary, deps) {
         markDirty(summary, { kind: "lane", id: lane.lane_id, why: `blocked keep-alive skip record failed: ${err instanceof Error ? err.message : String(err)}` });
     }
 }
+function recordBlockedKeepAliveSkipEvent(hqRoot, lane, reason, summary, deps) {
+    const terminalAt = lane.last_envelope?.at;
+    if (deps.dryRun || lane.last_envelope?.decision !== "blocked" || terminalAt === undefined)
+        return;
+    if (lane.status_gate_history?.some((entry) => entry.event === "keep_alive_blocked_skipped" && entry.terminal_at === terminalAt && entry.reason === reason))
+        return;
+    try {
+        casLaneIf(hqRoot, lane.lane_id, (current) => current.version === lane.version && current.state === "blocked" && current.last_envelope?.at === terminalAt, (current) => ({
+            ...current,
+            status_gate_history: appendCappedHistory(current.status_gate_history ?? [], {
+                event: "keep_alive_blocked_skipped",
+                at: deps.now().toISOString(),
+                terminal_at: terminalAt,
+                reason,
+            }),
+        }), false);
+    }
+    catch (err) {
+        markDirty(summary, { kind: "lane", id: lane.lane_id, why: `blocked keep-alive skip record failed: ${err instanceof Error ? err.message : String(err)}` });
+    }
+}
 function appendBlockedKeepAliveHistory(hqRoot, lane, terminalAt, at, reason, deps) {
     if (deps.dryRun || lane.status_gate_history?.some((entry) => entry.event === "keep_alive_blocked_grace" && entry.terminal_at === terminalAt && entry.resume_skipped_reason === reason))
         return;

package/dist/lib/lanes/types.d.ts

@@ -449,7 +449,7 @@ export interface KeepAliveBlockedHistoryEntry {
     at: string;
     terminal_at: string;
     resume_skipped_reason?: "open_question" | "blocked_grace";
-    reason?: "flag_off" | "backoff" | "next_check_at_due";
+    reason?: "flag_off" | "backoff" | "next_check_at_due" | "no_open_stories";
     resume_queued?: boolean;
 }
 export interface KeepAliveResumeHistoryEntry {

package/package.json

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