@indigoai-us/hq-cli 5.135.0 → 5.137.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## [Unreleased]
 
+## [5.137.0] — 2026-09-23
+### Added
+
+- Added `hq channels members <channel>` to print channel members for human and machine-principal sessions, with a `--json` format for scripts.
+
+## [5.136.0] — 2026-09-23
+
+### Added
+
+- Your local bots can now do work on a repeating schedule. Ask a company bot for something regular — "check the overnight errors every weekday morning" — and it sets the schedule up itself; you can also see and remove its schedules with `hq bot jobs <name>`. The schedule is kept in the cloud, not on your computer. If the Mac is asleep when a run is due, the run happens as a catch-up when it wakes, as long as that is within about an hour, and the bot's report says it ran late; after a longer outage that run is skipped and the job carries on at its next scheduled time. Personal bots can't schedule work yet.
+
 ## [5.135.0] — 2026-09-23
 
 ### Added

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

@@ -2388,6 +2388,22 @@ export declare const COMMAND_CATALOG: readonly [{
         readonly arguments: readonly [];
         readonly options: readonly [];
         readonly subcommands: readonly [];
+    }, {
+        readonly name: "members";
+        readonly description: "Print the members of one of your DM channels.";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly usage: "[options] <channel>";
+        readonly arguments: readonly [{
+            readonly name: "channel";
+            readonly required: true;
+            readonly variadic: false;
+        }];
+        readonly options: readonly [{
+            readonly flags: "--json";
+            readonly description: "Output the member array as JSON.";
+        }];
+        readonly subcommands: readonly [];
     }];
 }, {
     readonly name: "onboard";
@@ -7318,6 +7334,37 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly description: "Expected transfer size";
         }];
         readonly subcommands: readonly [];
+    }, {
+        readonly name: "jobs";
+        readonly description: "Show, schedule, or remove a bot's recurring jobs (the schedule runs in the cloud, not on this computer)";
+        readonly aliases: readonly [];
+        readonly hidden: false;
+        readonly usage: "[options] <name>";
+        readonly arguments: readonly [{
+            readonly name: "name";
+            readonly required: true;
+            readonly variadic: false;
+        }];
+        readonly options: readonly [{
+            readonly flags: "--add <what>";
+            readonly description: "Schedule new work, in plain language";
+        }, {
+            readonly flags: "--every <when>";
+            readonly description: "How often, in plain language (e.g. \"every weekday at 9am\")";
+        }, {
+            readonly flags: "--cron <expr>";
+            readonly description: "How often, as a cron expression (e.g. \"0 9 * * 1-5\")";
+        }, {
+            readonly flags: "--tz <zone>";
+            readonly description: "IANA timezone for the schedule (default: this computer's)";
+        }, {
+            readonly flags: "--rm <jobId>";
+            readonly description: "Remove a scheduled job";
+        }, {
+            readonly flags: "--json";
+            readonly description: "Print machine-readable JSON";
+        }];
+        readonly subcommands: readonly [];
     }, {
         readonly name: "promote";
         readonly description: "Move this local bot to cloud compute, preserving its identity and private context";

package/dist/command-catalog.generated.js

@@ -3067,6 +3067,27 @@ export const COMMAND_CATALOG = [
                 "arguments": [],
                 "options": [],
                 "subcommands": []
+            },
+            {
+                "name": "members",
+                "description": "Print the members of one of your DM channels.",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] <channel>",
+                "arguments": [
+                    {
+                        "name": "channel",
+                        "required": true,
+                        "variadic": false
+                    }
+                ],
+                "options": [
+                    {
+                        "flags": "--json",
+                        "description": "Output the member array as JSON."
+                    }
+                ],
+                "subcommands": []
             }
         ]
     },
@@ -9463,6 +9484,47 @@ export const COMMAND_CATALOG = [
                 ],
                 "subcommands": []
             },
+            {
+                "name": "jobs",
+                "description": "Show, schedule, or remove a bot's recurring jobs (the schedule runs in the cloud, not on this computer)",
+                "aliases": [],
+                "hidden": false,
+                "usage": "[options] <name>",
+                "arguments": [
+                    {
+                        "name": "name",
+                        "required": true,
+                        "variadic": false
+                    }
+                ],
+                "options": [
+                    {
+                        "flags": "--add <what>",
+                        "description": "Schedule new work, in plain language"
+                    },
+                    {
+                        "flags": "--every <when>",
+                        "description": "How often, in plain language (e.g. \"every weekday at 9am\")"
+                    },
+                    {
+                        "flags": "--cron <expr>",
+                        "description": "How often, as a cron expression (e.g. \"0 9 * * 1-5\")"
+                    },
+                    {
+                        "flags": "--tz <zone>",
+                        "description": "IANA timezone for the schedule (default: this computer's)"
+                    },
+                    {
+                        "flags": "--rm <jobId>",
+                        "description": "Remove a scheduled job"
+                    },
+                    {
+                        "flags": "--json",
+                        "description": "Print machine-readable JSON"
+                    }
+                ],
+                "subcommands": []
+            },
             {
                 "name": "promote",
                 "description": "Move this local bot to cloud compute, preserving its identity and private context",

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

@@ -0,0 +1,127 @@
+/**
+ * `hq bot jobs` — a local bot's recurring scheduled work.
+ *
+ *   hq bot jobs <botName>                                  list
+ *   hq bot jobs <botName> --add "<what to do>" --every "<plain english>"
+ *   hq bot jobs <botName> --add "<what to do>" --cron "0 9 * * 1-5"
+ *   hq bot jobs <botName> --rm <jobId>
+ *
+ * The schedule lives in the cloud, never on this computer: hq-pro-agents holds
+ * the job and fires it on an EventBridge schedule, and the bot's inbox loop
+ * runs the fired run (see lib/bot/job-run.ts). Nothing here writes a crontab,
+ * a launchd plist, or a systemd unit — by rule.
+ *
+ * The routes are self-only per agent, so every call uses the BOT's own machine
+ * identity — the same credential path its turns use — not the owner's session.
+ */
+import { execFileSync } from "node:child_process";
+import type { Command } from "commander";
+import { BotApi, type BotJobRecord, type CreateJobInput } from "../lib/bot/api.js";
+import { type BotConfig, type BotKind } from "../lib/bot/config.js";
+/** Mirrors hq-pro-agents `MIN_RECURRING_INTERVAL_SECONDS`. */
+export declare const MIN_RECURRING_INTERVAL_SECONDS: number;
+/** Mirrors hq-pro-agents `DEFAULT_MAX_ACTIVE_JOBS_PER_AGENT`. */
+export declare const MAX_ACTIVE_JOBS_PER_AGENT = 25;
+/** Mirrors hq-pro-agents `MAX_PROMPT_BYTES`. */
+export declare const MAX_PROMPT_BYTES: number;
+export declare class BotJobsError extends Error {
+    readonly expected: true;
+}
+/** The machine's own IANA zone, so "9am" means 9am where the owner lives. */
+export declare function machineTimezone(): string;
+/**
+ * Standard 5-field cron → the EventBridge form the cloud stores.
+ *
+ * EventBridge cron has SIX fields (a trailing year), numbers its days of week
+ * 1–7 with SUNDAY = 1 (standard cron uses 0–6 with SUNDAY = 0), and refuses
+ * `*` in BOTH the day-of-month and day-of-week fields — exactly one must be
+ * `?`. An expression that is already `cron(...)` or `rate(...)` is passed
+ * through untouched.
+ */
+export declare function toEventBridgeCron(expr: string): string;
+/**
+ * The smallest gap a recurring expression can produce, in seconds, or null
+ * when it is not a recognised rate()/cron() form. Mirrors hq-pro-agents
+ * `recurringIntervalSeconds` so the CLI can refuse a sub-floor schedule with
+ * the server's own reason instead of a round-trip and a raw 400.
+ */
+export declare function recurringIntervalSeconds(expr: string): number | null;
+/** Refuse a schedule the cloud would refuse, with the cloud's own reason. */
+export declare function assertScheduleWithinFloor(expr: string): void;
+export interface ParsedSchedule {
+    /** Standard 5-field cron, as the HQ helper emits it. */
+    cron: string;
+    timezone: string;
+    /** Plain words for the schedule, when the helper supplied them. */
+    human?: string;
+}
+export declare function scheduleHelperPath(hqRoot: string): string;
+/**
+ * Plain English → cron, using HQ's OWN helper (`core/scripts/jobs-schedule-parse.sh`)
+ * so `hq bot jobs --every` and the `/schedule` command agree on what "every
+ * weekday morning" means. When the helper is not in this HQ root, the caller is
+ * told to pass `--cron` instead rather than getting a second, divergent parser.
+ */
+export declare function parseScheduleText(text: string, opts: {
+    hqRoot: string;
+    timezone: string;
+    exec?: typeof execFileSync;
+    exists?: (p: string) => boolean;
+}): ParsedSchedule;
+/** The create body the cloud expects, with the client-side limits enforced first. */
+export declare function buildCreateJobBody(input: {
+    prompt: string;
+    cron: string;
+    timezone: string;
+    context?: Record<string, unknown>;
+}): CreateJobInput;
+/** A schedule in plain words, falling back to the raw expression. */
+export declare function describeSchedule(job: BotJobRecord): string;
+/** A small humaniser for the shapes `--every` actually produces. */
+export declare function cronInWords(expr: string): string | null;
+/** "never run yet" / "succeeded 2026-09-15 09:00 UTC". */
+export declare function describeLastRun(job: BotJobRecord): string;
+export declare function formatJobsList(botName: string, jobs: BotJobRecord[]): string;
+/**
+ * Turn a jobs-route failure into one plain line.
+ *
+ * Personal bots are refused by the cloud today: their JWT carries the owner's
+ * `per_…` company claim and the jobs routes require a `cmp_…`, so the fail-closed
+ * guard answers 403 `CROSS_AGENT_JOB` (hq-pro-agents jobs/errors.ts
+ * `CrossAgentJobError`). That server fix is a separate change; until it lands the
+ * refusal must read as "not available yet for this kind of bot", not as a raw 403.
+ * Once the server accepts personal bots the refusal simply stops happening — no
+ * client change needed.
+ *
+ * ONLY that exact code is rewritten. Every other 403, and every 404, keeps its
+ * real message: masking them would hide a genuinely missing job or a different
+ * permission problem behind copy about the wrong thing.
+ */
+export declare function jobsErrorMessage(err: unknown, ctx: {
+    botName: string;
+    kind: BotKind;
+}): string;
+export interface BotJobsDeps {
+    requireBot(name: string): {
+        name: string;
+        dir: string;
+        config: BotConfig;
+    };
+    botTokenSupplier(dir: string): () => Promise<string>;
+    /** Test seam: the jobs client for a bot directory. */
+    apiFor?(dir: string): Pick<BotApi, "listJobs" | "createJob" | "cancelJob">;
+    parseSchedule?: typeof parseScheduleText;
+    timezone?: () => string;
+    out?: (line: string) => void;
+}
+export interface BotJobsOptions {
+    add?: string;
+    every?: string;
+    cron?: string;
+    tz?: string;
+    rm?: string;
+    json?: boolean;
+}
+export declare function runBotJobs(nameArg: string, opts: BotJobsOptions, deps: BotJobsDeps): Promise<void>;
+export declare function registerBotJobsCommand(bot: Command, deps: BotJobsDeps): void;
+//# sourceMappingURL=bot-jobs.d.ts.map