@indigoai-us/hq-cli 5.345.197 → 5.345.199

package/dist/commands/bot-jobs.d.ts

@@ -114,6 +114,8 @@ export interface BotJobsOptions {
     add?: string;
     every?: string;
     cron?: string;
+    on?: string;
+    filter?: string[];
     tz?: string;
     rm?: string;
     /** Change an existing job's schedule, keeping its id, instruction and history. */

package/dist/commands/bot-jobs.js

@@ -16,7 +16,7 @@
  * back when it checks what is due.
  */
 import chalk from "chalk";
-import { localJobsClient } from "../lib/bot/local-jobs.js";
+import { addLocalJob, localJobsClient, readLocalJobs, toJobRecord } from "../lib/bot/local-jobs.js";
 import { BotApiError } from "../lib/bot/api.js";
 import { effectiveBotKind, HQ_FLEET_RUNTIME_ENGINE_ID } from "../lib/bot/config.js";
 import { fleetCronOps, fleetOwnerOrigin, fleetScheduleFromLegacy } from "../lib/bot/fleet-cron.js";
@@ -318,6 +318,10 @@ export function fleetJobsClient(config, ops, timezone) {
 // ─── Reading jobs back ───────────────────────────────────────────────────────
 /** A schedule in plain words, falling back to the raw expression. */
 export function describeSchedule(job) {
+    if (job.trigger) {
+        const filters = Object.entries(job.trigger.filter ?? {}).map(([key, value]) => `${key}=${value}`).join(", ");
+        return `on ${job.trigger.event}${filters ? ` (${filters})` : ""}`;
+    }
     const schedule = job.schedule;
     if (!schedule)
         return "on a schedule";
@@ -391,7 +395,7 @@ export function formatJobsList(botName, jobs, showQuietOption = false) {
         lines.push(`    runs ${describeSchedule(job)}`);
         if (showQuietOption && isQuietJobContext(job.context))
             lines.push("    delivery: quiet after successful runs");
-        lines.push(`    next run: ${job.nextRunAt ? `${utcMinute(job.nextRunAt)} UTC` : "not scheduled yet"}`);
+        lines.push(`    next run: ${job.trigger ? "when a matching event arrives" : job.nextRunAt ? `${utcMinute(job.nextRunAt)} UTC` : "not scheduled yet"}`);
         lines.push(`    last run: ${describeLastRun(job)}`);
     }
     return lines.join("\n");
@@ -454,6 +458,11 @@ export async function runBotJobs(nameArg, opts, deps) {
     if (opts.quiet && opts.add === undefined) {
         refuse("Use --quiet with --add to set a scheduled job's delivery option.");
     }
+    if (opts.on !== undefined && (opts.add === undefined || opts.every !== undefined || opts.cron !== undefined || opts.tz !== undefined)) {
+        refuse("Use --on with --add and without --every, --cron, or --tz.");
+    }
+    if (opts.filter?.length && opts.on === undefined)
+        refuse("Use --filter with --on.");
     // Shared by --add and --reschedule: one schedule from --every or --cron, in
     // the stored form, held to the same floor.
     const scheduleFromOptions = () => {
@@ -516,6 +525,36 @@ export async function runBotJobs(nameArg, opts, deps) {
         if (opts.quiet && !(await quietOptionEnabled())) {
             refuse(`--quiet requires the ${BOT_JOB_QUIET_OPTION_FLAG} flag, which is currently disabled.`);
         }
+        if (opts.on !== undefined) {
+            if (fleet)
+                refuse("Event jobs require a local CLI bot; HQ Fleet Runtime does not drain this event journal.");
+            const event = opts.on.trim();
+            if (!event || event.length > 256 || /[\r\n]/.test(event))
+                refuse("Event name must be 1–256 characters without newlines.");
+            const prompt = opts.add.trim();
+            if (!prompt || Buffer.byteLength(prompt, "utf8") > MAX_PROMPT_BYTES)
+                refuse("Job instruction must be non-empty and at most 16 KB.");
+            const filter = Object.create(null);
+            for (const entry of opts.filter ?? []) {
+                const split = entry.indexOf("=");
+                if (split < 1 || !entry.slice(0, split).trim())
+                    refuse("Each --filter must be key=value.");
+                const key = entry.slice(0, split).trim();
+                if (Object.hasOwn(filter, key))
+                    refuse(`Duplicate filter key: ${key}`);
+                filter[key] = entry.slice(split + 1);
+            }
+            if (readLocalJobs(dir).length >= MAX_ACTIVE_JOBS_PER_AGENT)
+                refuse(`${name} already has the maximum of ${MAX_ACTIVE_JOBS_PER_AGENT} jobs. Remove one first.`);
+            const created = toJobRecord(addLocalJob(dir, {
+                prompt,
+                timezone: localZone,
+                trigger: { kind: "event", event, ...(Object.keys(filter).length ? { filter } : {}) },
+                ...(opts.quiet ? { context: { [JOB_RUN_OPTIONS_CONTEXT_KEY]: { quiet: true } } } : {}),
+            }));
+            out(opts.json ? JSON.stringify({ ok: true, job: created }, null, 2) : `Added ${created.jobId}: ${name} runs it ${describeSchedule(created)}.`);
+            return;
+        }
         const schedule = scheduleFromOptions();
         const body = buildCreateJobBody({ prompt: opts.add, cron: schedule.cron, timezone: schedule.timezone, quiet: opts.quiet });
         const api = await jobsApi();
@@ -558,6 +597,8 @@ export function registerBotJobsCommand(bot, deps) {
         .option("--add <what>", "Schedule new work, in plain language")
         .option("--every <when>", 'How often, in plain language (e.g. "every weekday at 9am")')
         .option("--cron <expr>", 'How often, as a cron expression (e.g. "0 9 * * 1-5")')
+        .option("--on <event>", "Run when this event is emitted")
+        .option("--filter <key=value>", "Match an event payload field (repeatable)", (value, values) => [...values, value], [])
         .option("--tz <zone>", "IANA timezone for the schedule (default: this computer's)")
         .option("--quiet", "Skip owner DMs after successful runs (requires rollout flag)")
         .option("--rm <jobId>", "Remove a scheduled job")

package/dist/commands/bot.d.ts

@@ -1,5 +1,6 @@
 import { Command } from "commander";
 import { type RuntimeSignInCheck, type RuntimeSignInIssue } from "../lib/bot/runtime-sign-in.js";
+import { type ClaudeLoginCheck } from "../lib/bot/claude-login.js";
 import type { BotStatusFile } from "../lib/bot/status.js";
 import { probeBotRuntime, type RuntimeProbeResult } from "../lib/bot/probe.js";
 import { type SpawnInteractive } from "../lib/bot/runtime-auth.js";
@@ -115,6 +116,10 @@ export declare function spawnDetachedRun(name: string, dir: string): number;
  * "unreadable output: trailing characters").
  */
 /** Seams for the self-stop path, replaced in tests. */
+export declare const botCreateSeams: {
+    /** The Claude Code login read the way the HQ Fleet Runtime reads it. */
+    claudeLogin: () => ClaudeLoginCheck;
+};
 export declare const botStopSeams: {
     /** True when this process runs inside the bot process `botPid` (one of its turns). */
     isInsideBot: (botPid: number) => boolean;

package/dist/commands/bot.js

@@ -43,6 +43,8 @@ import { createVaultObjectDownloader } from "../lib/agent-kit/attachment-downloa
 import { addBotToCompanies, describeCompanyFailures, removeBotFromCompanies } from "./bot-companies.js";
 import { registerBotContinuityCommand } from "./bot-continuity.js";
 import { registerBotJobsCommand } from "./bot-jobs.js";
+import { registerBotEventsCommand } from "./bot-events.js";
+import { executiveStatus } from "../lib/bot/executive-settings.js";
 import { ensureFleetHotSignalSync, fleetCronOps, migrateLegacyJobsToFleet } from "../lib/bot/fleet-cron.js";
 import { resolvePackSetupPrompt } from "../lib/bot/pack-setup.js";
 import { detectCodingToolActivity } from "../lib/bot/coding-tool-activity.js";
@@ -63,6 +65,8 @@ import { daemonPaths } from "../lib/daemon/paths.js";
 import { launchdLabel } from "../lib/bot/paths.js";
 import { isAncestorProcess } from "../lib/bot/self-process.js";
 import { runtimeDisplayName, signInCommand } from "../lib/bot/runtime-sign-in.js";
+import { checkClaudeCodeLogin, claudeLoginFix, describeClaudeLoginSources } from "../lib/bot/claude-login.js";
+import { unresolvedLastFailure } from "../lib/doctor/checks/bots.js";
 import { classifyRuntimeFailure, runtimeFailureReason } from "../lib/bot/runtime-failure.js";
 import { PROBE_DEFAULT_TIMEOUT_MS, probeBotRuntime } from "../lib/bot/probe.js";
 import { BOT_LOGIN_RUNTIMES, botAuthEnv, botRuntimeAuth, capacityAccountHome, describeBotAuth, formatBotAuth, isBotLoginRuntime, restoreBotSessions, setAsideBotSessions, signInBotRuntime, signOutBotRuntime, withRuntimeAuth, } from "../lib/bot/runtime-auth.js";
@@ -774,6 +778,22 @@ async function installFleetRuntimeProfile(name, dir, config, opts = {}) {
  * "unreadable output: trailing characters").
  */
 /** Seams for the self-stop path, replaced in tests. */
+export const botCreateSeams = {
+    /** The Claude Code login read the way the HQ Fleet Runtime reads it. */
+    claudeLogin: () => checkClaudeCodeLogin(),
+};
+/**
+ * A Claude bot on the HQ Fleet Runtime answers with the owner's Claude Code
+ * login. Creating one on a computer with no readable login provisions an
+ * identity that can only ever answer "I'm away for a bit", so refuse first
+ * and say which sources were checked.
+ */
+function requireClaudeCodeLoginForCreate(name) {
+    const check = botCreateSeams.claudeLogin();
+    if (check.signedIn)
+        return;
+    throw Object.assign(new Error(`Claude Code is not signed in on this computer, so ${name} could not answer. ${describeClaudeLoginSources(check)} ${claudeLoginFix()}`.replace(/\s+/g, " ").trim()), { expected: true });
+}
 export const botStopSeams = {
     /** True when this process runs inside the bot process `botPid` (one of its turns). */
     isInsideBot: (botPid) => isAncestorProcess(botPid),
@@ -1114,6 +1134,8 @@ async function runBotCreateLocked(name, opts) {
     }
     const fleetProvider = fleetProviderForRuntime(runtime, model);
     const fleetAuthPending = fleetProviderNeedsSignIn(fleetProvider);
+    if (fleetProvider.id === "anthropic")
+        requireClaudeCodeLoginForCreate(name);
     const token = await ownerToken();
     const owner = await resolveCallerPersonUid(token, undefined, { command: "hq bot create" });
     if (!owner)
@@ -1664,7 +1686,7 @@ async function runBotStatus(nameArg, opts) {
     const creds = readBotCredsIdentity(dir);
     const channels = fleet ? fleetLocalChannels(readFleetLocalGatewayState(config.agentUid), row.processAlive) : null;
     if (opts.json) {
-        console.log(JSON.stringify({ ...row, ...(fleet ? { engine: config.engine, channels } : {}), credsPresent: fleet || !!creds, login: describeBotAuth(dir, config), status }, null, 2));
+        console.log(JSON.stringify({ ...row, executive: executiveStatus(config, dir), ...(fleet ? { engine: config.engine, channels } : {}), credsPresent: fleet || !!creds, login: describeBotAuth(dir, config), status }, null, 2));
         return;
     }
     console.log(`${chalk.bold(name)}  ${row.agentUid}`);
@@ -1733,6 +1755,15 @@ async function runBotStatus(nameArg, opts) {
             const cls = classifyRuntimeFailure(status.lastError);
             console.log(`  last problem: ${chalk.yellow(`${cls}: ${runtimeFailureReason(cls, row.runtime)}`)}  ${chalk.dim(`(details: hq bot logs ${name})`)}`);
         }
+        if (status.lastFailure) {
+            const failure = status.lastFailure;
+            const resolved = unresolvedLastFailure(status) === null;
+            const paint = resolved ? chalk.dim : chalk.yellow;
+            console.log(`  last failure: ${paint(`${failure.at} (${failure.class}${resolved ? ", answered since" : ""})`)}`);
+            console.log(`    cause:    ${paint(failure.cause)}`);
+            console.log(`    fix:      ${paint(failure.fix)}`);
+            console.log(`    report:   ${failure.uploaded && failure.reportId ? `${failure.reportId} (in HQ, with the bot's last log lines)` : chalk.red("not uploaded to HQ")}  ${chalk.dim(`owner DM ${failure.ownerNotified ? "sent" : "not sent"}`)}`);
+        }
     }
     console.log(chalk.dim(`  state dir:  ${dir}`));
 }
@@ -3052,6 +3083,7 @@ export function registerBotCommand(program) {
         .description("Personal local bots that run on this computer with your own model login");
     registerBotContinuityCommand(bot);
     registerBotJobsCommand(bot, { requireBot, botTokenSupplier });
+    registerBotEventsCommand(bot, { requireBot });
     bot.command("promote <name>")
         .description("Move this local bot to cloud compute, preserving its identity and private context")
         .requiredOption("--company <uid>", "Destination company identity")

package/dist/commands/core-resolve-company-native.d.ts

@@ -1,4 +1,6 @@
 import * as fs from "node:fs";
+import { parseManifestSlugs } from "../lib/core-utils/manifest-slugs.js";
+export { parseManifestSlugs };
 export declare const RESOLVE_COMPANY_ASSET = "core/scripts/resolve-company.sh";
 export declare const RESOLVE_COMPANY_HELP: string;
 export type ResolveCompanyResult = {
@@ -27,5 +29,4 @@ export type ResolveCompanyDependencies = {
 };
 export declare function resolveCompany(args: readonly string[], dependencies: ResolveCompanyDependencies): Promise<ResolveCompanyResult>;
 export declare function runResolveCompanyFast(args: readonly string[], stdin: string, cwd: string, hqRoot: string | undefined, _commandName?: string, _hqRootArg?: string, stdinReader?: () => Promise<string>): Promise<number>;
-export {};
 //# sourceMappingURL=core-resolve-company-native.d.ts.map

package/dist/commands/core-resolve-company-native.js

@@ -4,7 +4,9 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import { awkCannotOpenFileDiagnostic } from "../lib/core-utils/awk-diagnostics.js";
 import { buildCmdExeSpawnPlan, isWindowsBatchFile } from "../utils/windows-spawn.js";
+import { parseManifestSlugs } from "../lib/core-utils/manifest-slugs.js";
 import { fastFlagEnabledDefaultOn } from "../native-fast-route.js";
+export { parseManifestSlugs };
 export const RESOLVE_COMPANY_ASSET = "core/scripts/resolve-company.sh";
 export const RESOLVE_COMPANY_HELP = [
     "hq-core: public",
@@ -29,7 +31,6 @@ export const RESOLVE_COMPANY_HELP = [
     "ROOT=\"\"",
 ].join("\n") + "\n";
 const EMPTY_ENV = {};
-const keepSlug = (slug) => slug !== "" && slug !== "_template" && slug !== "companies" && slug !== "unaffiliated_repos";
 function errorCode(error) {
     return error && typeof error === "object" && "code" in error && typeof error.code === "string"
         ? error.code
@@ -75,29 +76,6 @@ function isFile(filePath, fileSystem) {
         throw error;
     }
 }
-function parseManifestSlugs(text) {
-    const slugs = new Set();
-    let wrapped = false;
-    for (const rawLine of text.split("\n")) {
-        const line = rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine;
-        if (/^companies:[ \t]*$/.test(line)) {
-            wrapped = true;
-            continue;
-        }
-        if (wrapped && /^[^ \t][^:]*:[ \t]*$/.test(line))
-            wrapped = false;
-        if (wrapped) {
-            const match = line.match(/^ {2}([A-Za-z][A-Za-z0-9_-]*):/);
-            if (match && keepSlug(match[1]))
-                slugs.add(match[1]);
-            continue;
-        }
-        const match = line.match(/^([A-Za-z][A-Za-z0-9_-]*):/);
-        if (match && keepSlug(match[1]))
-            slugs.add(match[1]);
-    }
-    return [...slugs];
-}
 function promptSlug(prompt, slugs) {
     if (!prompt)
         return "";

package/dist/commands/deploy-domains.d.ts

@@ -43,8 +43,12 @@ export declare function addOnConfirmQuestion(domain: string, environment: string
     appLabel: string;
     orgSlug: string;
 }, pricing: Record<string, unknown> | null): string;
-/** Shown in the buy prompt when GET /v1/pricing does not answer. */
-export declare const PURCHASE_TERMS_UNAVAILABLE = "The renewal and refund terms could not be loaded. Check them on the HQ pricing page before you buy.";
+/** Shown in the buy prompt when neither search nor GET /v1/pricing names a renewal price. */
+export declare const PURCHASE_TERMS_UNAVAILABLE = "The renewal price could not be loaded. Run 'hq deploy domains search' and check the renewal price before you buy.";
+/** Sandbox label. Every search and buy surface prints this when the server says testMode. */
+export declare const TEST_MODE_LABEL = "Test mode: sandbox prices. Nothing real is registered or charged.";
+export declare const TRANSFER_LOCK_NOTICE = "Domains cannot be transferred to another registrar for 60 days after purchase.";
+export declare const PURCHASES_ARE_FINAL = "Purchases are final.";
 /** The purchase terms published as usage.domains.purchase. Null when not published. */
 export declare function purchaseTermsLine(pricing: Record<string, unknown> | null): string | null;
 /** Hard deadline for `base status --wait`, so a script never waits forever. */
@@ -68,6 +72,14 @@ export declare function baseDomainPriceLine(body: {
 /** The approval question for `base add`, before the server says the basis. */
 export declare function baseAddConfirmQuestion(domain: string, orgSlug: string, pricing: Record<string, unknown> | null): string;
 export declare function parsePrice(raw: string): number;
+interface PurchaseUse {
+    kind: "app" | "base" | "hold";
+    appId?: string;
+}
+/** What the purchase is for. `app:<id>` attaches to that deployment, `base` is the company domain, `hold` registers only. */
+export declare function parseUse(raw: string): PurchaseUse;
+/** Hosting tier, separate from the registrar price. Hold is register-only. */
+export declare function hostingTierLine(use: PurchaseUse, pricing: Record<string, unknown> | null): string;
 export declare function registerDeployDomainsCommand(deploy: Command): void;
 export {};
 //# sourceMappingURL=deploy-domains.d.ts.map