@indigoai-us/hq-cli 5.342.16 → 5.342.18

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## [Unreleased]
 
+## [5.342.18] — 2026-10-04
+- Preserve confirmed remote lane-message responses for in-process monitor delivery.
+- Use native TypeScript renderers for `hq core rebuild-index` commands.
+
+## [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/assets/scaffold/core/scripts/rebuild-company-knowledge-index.sh

@@ -44,7 +44,7 @@ describe_item() {
     n=$(find "$path" -mindepth 1 -maxdepth 1 ! -name '.*' 2>/dev/null | wc -l | tr -d ' ')
     local h=""
     if [[ -f "$path/README.md" ]]; then
-      h=$(awk '/^# / { sub(/^# +/, ""); print; exit }' "$path/README.md" 2>/dev/null || true)
+      h=$(awk '/^# / { sub(/^# +/, ""); sub(/\r$/, ""); print; exit }' "$path/README.md" 2>/dev/null || true)
     fi
     if [[ -n "$h" ]]; then
       echo "${h} (${n} item(s))"
@@ -56,7 +56,7 @@ describe_item() {
   case "$name" in
     *.md)
       local h
-      h=$(awk '/^# / { sub(/^# +/, ""); print; exit }' "$path" 2>/dev/null || true)
+      h=$(awk '/^# / { sub(/^# +/, ""); sub(/\r$/, ""); print; exit }' "$path" 2>/dev/null || true)
       [[ -z "$h" ]] && h="$name"
       echo "$h"
       ;;

package/assets/scaffold/core/scripts/rebuild-public-knowledge-index.sh

@@ -25,7 +25,7 @@ trunc() {
 }
 
 heading_of() {
-  awk '/^# / { sub(/^# +/, ""); print; exit }' "$1" 2>/dev/null || true
+  awk '/^# / { sub(/^# +/, ""); sub(/\r$/, ""); print; exit }' "$1" 2>/dev/null || true
 }
 
 describe_subdir() {

package/assets/scaffold/core/scripts/rebuild-reports-index.sh

@@ -25,7 +25,7 @@ trunc() {
 }
 
 heading_md() {
-  awk '/^# / { sub(/^# +/, ""); print; exit }' "$1" 2>/dev/null || true
+  awk '/^# / { sub(/^# +/, ""); sub(/\r$/, ""); print; exit }' "$1" 2>/dev/null || true
 }
 title_html() {
   awk 'BEGIN{IGNORECASE=1} /<title>/ { sub(/.*<title>/, ""); sub(/<\/title>.*/, ""); print; exit }' "$1" 2>/dev/null || true

package/assets/scaffold/core/scripts/rebuild-social-drafts-index.sh

@@ -27,7 +27,7 @@ trunc() {
 }
 
 heading_md() {
-  awk '/^# / { sub(/^# +/, ""); print; exit }' "$1" 2>/dev/null || true
+  awk '/^# / { sub(/^# +/, ""); sub(/\r$/, ""); print; exit }' "$1" 2>/dev/null || true
 }
 
 describe_subdir() {

package/assets/scaffold/core/scripts/rebuild-workers-index.sh

@@ -26,8 +26,12 @@ worker_desc() {
   if command -v yq >/dev/null 2>&1; then
     yq -r '.worker.description // .worker.bio.role // ""' "$yaml" 2>/dev/null || echo ""
   else
-    # Fallback: first-line description grep
-    awk -F: '/^[[:space:]]+description:/ { sub(/^[^:]+: */, ""); gsub(/^["\x27]|["\x27]$/, ""); print; exit }' "$yaml" 2>/dev/null || echo ""
+    # Fallback for machines without yq: prefer description, then bio.role.
+    awk -F: '
+      /^[[:space:]]+description:/ { sub(/^[^:]+:[[:space:]]*/, ""); gsub(/^["\x27]|["\x27]$/, ""); print; found=1; exit }
+      /^[[:space:]]+role:/ { role=$0; sub(/^[^:]+:[[:space:]]*/, "", role); gsub(/^["\x27]|["\x27]$/, "", role) }
+      END { if (!found && role != "") print role }
+    ' "$yaml" 2>/dev/null || echo ""
   fi
 }
 

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/commands/lanes-message.js

@@ -309,8 +309,7 @@ export function createLaneMessageHandlers(deps) {
                 throw err;
             }
             const text = readMessageText(requestedLaneId);
-            await dispatchPrimaryLaneMessage(ctx, requestedLaneId, { ...opts, text });
-            return;
+            return await dispatchPrimaryLaneMessage(ctx, requestedLaneId, { ...opts, text });
         }
         laneId = resolution.lane.lane_id;
         let text = readMessageText(laneId);
@@ -336,7 +335,7 @@ export function createLaneMessageHandlers(deps) {
                 callerMatchesSessionSenior(ctx, sessionSeniorId)
                 ? sessionSeniorId
                 : undefined;
-            await dispatchOutpostLaneCommand(ctx, lane, "message", {
+            return await dispatchOutpostLaneCommand(ctx, lane, "message", {
                 ...opts,
                 text,
                 ...(supersededMessageCallerId === undefined ? {} : { supersededMessageCallerId }),
@@ -349,7 +348,6 @@ export function createLaneMessageHandlers(deps) {
                     afterFallbackResume: () => deps.cancelFallbackQuestionsForLane(ctx, lane, "message", fallbackAt),
                 }),
             });
-            return;
         }
         assertLaneRunsHereForOperatorMutation(ctx, lane, "message");
         const projectId = opts.project?.trim() || lane.project_id;

package/dist/commands/lanes-shared.d.ts

@@ -179,8 +179,8 @@ export interface LaneMessageHandlerDeps {
         alreadyQueued?: boolean;
     }): Promise<AdmissionResult>;
     casUpdateLane(hqRoot: string, laneId: string, updater: (current: LaneRecord) => LaneRecord): LaneRecord;
-    dispatchOutpostLaneCommand(ctx: Ctx, lane: LaneRecord, action: "message" | "resume", options: LaneMessageOptions | LaneResumeOptions, behavior?: OutpostLaneDispatchBehavior): Promise<void>;
-    dispatchPrimaryLaneMessage(ctx: Ctx, laneId: string, options: LaneMessageOptions): Promise<void>;
+    dispatchOutpostLaneCommand(ctx: Ctx, lane: LaneRecord, action: "message" | "resume", options: LaneMessageOptions | LaneResumeOptions, behavior?: OutpostLaneDispatchBehavior): Promise<LaneMessageResponse | undefined>;
+    dispatchPrimaryLaneMessage(ctx: Ctx, laneId: string, options: LaneMessageOptions): Promise<LaneMessageResponse | undefined>;
     drainHookStatusFor(ctx: Ctx, lane: LaneRecord): {
         registered: boolean;
         kind: string;

package/dist/commands/lanes.js

@@ -4516,7 +4516,7 @@ async function dispatchOutpostLaneCommand(ctx, lane, action, options, behavior =
         const ownerCancellationFailures = Array.isArray(remote.question_cancellation_failures)
             ? remote.question_cancellation_failures
             : [];
-        printJson({
+        const response = {
             ...remote,
             lane_id: ownerLane.lane_id,
             lane: ownerLane,
@@ -4534,8 +4534,10 @@ async function dispatchOutpostLaneCommand(ctx, lane, action, options, behavior =
             outpost_command_id: dispatched.commandId,
             outpost_transport: "outposts_exec",
             delivered_to: { host: outpostId, lane_id: ownerLane.lane_id, mechanism: "outposts_exec" },
-        });
-        return;
+        };
+        if (!("silent" in options) || !options.silent)
+            printJson(response);
+        return response;
     }
     if (action === "approve" || action === "reparent" || action === "resume") {
         const ownerLane = dispatchedOwnerLane(ctx, lane.lane_id, outpostId, remote.lane, behavior);
@@ -4578,7 +4580,7 @@ async function dispatchOutpostLaneCommand(ctx, lane, action, options, behavior =
         });
         return;
     }
-    printJson({
+    const response = {
         ...remote,
         outpost_id: outpostId,
         outpost_command_id: dispatched.commandId,
@@ -4586,7 +4588,11 @@ async function dispatchOutpostLaneCommand(ctx, lane, action, options, behavior =
         ...(action === "message"
             ? { delivered_to: { host: outpostId, lane_id: lane.lane_id, mechanism: "outposts_exec" } }
             : {}),
-    });
+    };
+    const silentMessage = action === "message" && "silent" in options && options.silent === true;
+    if (!silentMessage)
+        printJson(response);
+    return action === "message" ? response : undefined;
 }
 function dispatchedOwnerLane(ctx, laneId, outpostId, rawLane, behavior) {
     if (behavior.syncPrimary !== false) {
@@ -7426,15 +7432,16 @@ async function dispatchPrimaryLaneMessage(ctx, laneId, options) {
         remote.accepted !== true) {
         throw new LanesError("outpost_delivery_unconfirmed", `Primary completed exec without a confirmed message result for lane ${laneId}`, { lane_id: laneId, outpost_id: outpostId, command_id: confirmedCommandId });
     }
-    if (!options.silent) {
-        printJson({
-            ...remote,
-            outpost_id: outpostId,
-            outpost_command_id: confirmedCommandId,
-            outpost_transport: "outposts_exec",
-            delivered_to: { host: outpostId, lane_id: laneId, mechanism: "outposts_exec" },
-        });
-    }
+    const response = {
+        ...remote,
+        outpost_id: outpostId,
+        outpost_command_id: confirmedCommandId,
+        outpost_transport: "outposts_exec",
+        delivered_to: { host: outpostId, lane_id: laneId, mechanism: "outposts_exec" },
+    };
+    if (!options.silent)
+        printJson(response);
+    return response;
 }
 async function dispatchOutpostLaneStop(ctx, lane, reason, quiet = false) {
     if (lane.host.kind !== "outpost") {
@@ -8416,7 +8423,9 @@ export function registerLanesCommand(parent, deps = {}) {
         authorizeFailedResume,
         authorizeResumeProfileRepin,
         casUpdateLane,
-        dispatchOutpostLaneCommand,
+        dispatchOutpostLaneCommand: async (commandCtx, lane, action, options, behavior) => {
+            await dispatchOutpostLaneCommand(commandCtx, lane, action, options, behavior);
+        },
         laneIsHostedHere,
         laneWithRecoveredProviderSession,
         mintMessageId,

package/dist/lib/index-render/index.js

@@ -33,7 +33,10 @@ export function renderIndexTarget(target, context, args = []) {
             }
             // The shell sorts and deduplicates the `wrote` paths before JSON output.
             const stdoutPaths = written.filter((file) => /^(workspace|companies|knowledge|workers|projects)/.test(file));
-            (context.output ?? ((message) => process.stdout.write(message)))(`${JSON.stringify([...new Set(stdoutPaths)].sort(), null, 2)}\n`);
+            const json = JSON.stringify([...new Set(stdoutPaths)].sort(), null, 2);
+            // Windows jq emits CRLF when its JSON output is captured by the shell.
+            const lineEndings = process.platform === "win32" ? json.replace(/\n/g, "\r\n") : json;
+            (context.output ?? ((message) => process.stdout.write(message)))(`${lineEndings}\n`);
             context.log?.(errors ? `all-indexes: errors (${errors})` : "all-indexes: ok");
             return { written };
         }

package/dist/lib/index-render/social-drafts.js

@@ -1,5 +1,5 @@
 import * as fs from "fs";
-import { basename, countImmediate, date, exists, heading, immediateEntries, isHidden, log, mtime, sanitize, truncate, write } from "./shared.js";
+import { basename, countImmediate, date, exists, heading, immediateEntries, isHidden, log, mtime, rel, sanitize, truncate, write } from "./shared.js";
 function directoryDescription(context, name) {
     const base = `workspace/social-drafts/${name}`;
     const files = countImmediate(context.root, base, (child, file) => !isHidden(child) && fs.statSync(file).isFile());
@@ -29,7 +29,7 @@ export function renderSocialDrafts(context) {
     const recent = ["x", "linkedin", "blog", "tiktok"].flatMap((channel) => immediateEntries(context.root, `${base}/${channel}`, "file").filter((file) => file.endsWith(".md"))).sort((a, b) => mtime(b) - mtime(a)).slice(0, 20);
     const lines = ["# Social Drafts", "", `> Auto-generated. Updated: ${date(context.now)}`, "", "## Recent Drafts", ""];
     for (const file of recent) {
-        const relative = file.slice(`${context.root}/workspace/social-drafts/`.length);
+        const relative = rel(context.root, file).slice("workspace/social-drafts/".length);
         lines.push(`- \`${relative}\` - ${truncate(sanitize(heading(file) || basename(file).slice(0, -3)), 100)}`);
     }
     lines.push("", "## Directories", "", "| Name | Description |", "|------|-------------|");

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.18",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {