@wirecat/cli-core 0.583.0 → 0.584.0

package/CHANGELOG.md

@@ -7,6 +7,19 @@ shape of this file.
 
 ## Unreleased
 
+## 0.584.0 — 06.11.2026
+
+### Added
+
+- **`schedule list` gives an agent schedule's cost caps.** `max_cost_usd` is the cap on one run (`--max-cost`, null
+  when none) and `max_cost_per_day_usd` the daily cap in force, the schedule's `--max-cost-per-day` or the config's
+  (0 for none), so a screen can show `$0.84 of $5.00`; the text line says `today $0.84 of $5.00`.
+
+### Fixed
+
+- **`schedule list`'s output schema describes what it prints.** `spent_today_usd`, and the last run's `cost_usd`
+  and `skipped`, were printed but missing from the strict `scheduled_job` schema.
+
 ## 0.583.0 — 05.11.2026
 
 ### Changed — may break callers

package/dist/cli/schedule/schedule-command.js

@@ -138,6 +138,12 @@ export const scheduleLimitsOf = (config) => {
 const given = (limits) => Object.fromEntries(Object.entries(limits).filter(([, value]) => value !== undefined));
 const shown = (argv) => argv.map((arg) => (arg === "" ? '""' : arg)).join(" ");
 const usd = (value) => `$${value.toFixed(2)}`;
+/** The per-run cap an agent schedule was made with (`--max-cost`, passed to claude as --max-budget-usd), or null. */
+const runCapOf = (argv) => {
+    const at = argv.indexOf("--max-budget-usd");
+    const cap = at < 0 ? Number.NaN : Number(argv[at + 1]);
+    return Number.isFinite(cap) ? cap : null;
+};
 /**
  * Runs the CLI's own commands, or an agent, later or on a timer — through systemd (Linux), launchd
  * (macOS) or Task Scheduler (Windows). Every timer runs `schedule exec <file>`; the schedule file holds
@@ -184,19 +190,21 @@ export const scheduleCommandFor = ({ app, context: contextOf, newMail, limits: c
      * Why a run does not start now, or nothing: an agent whose runs reached the day's cost cap waits for tomorrow, and
      * one gated on mail waits for mail past its holder's mark — on its timer, until enough of it waits.
      */
+    /** A schedule's own limits, else the config file's, else the defaults. */
+    const limitsOf = (self, schedule) => ({
+        ...SCHEDULE_DEFAULTS,
+        ...given(configured?.(self) ?? {}),
+        ...given({
+            mailWaitMinutes: schedule.mailWaitMinutes,
+            mailBatch: schedule.mailBatch,
+            maxCostPerDay: schedule.maxCostPerDay,
+        }),
+    });
     const waits = async (self, file, { timed }) => {
         if (!existsSync(file))
             return undefined;
         const schedule = readSchedule(file);
-        const { mailWaitMinutes, mailBatch, maxCostPerDay } = {
-            ...SCHEDULE_DEFAULTS,
-            ...given(configured?.(self) ?? {}),
-            ...given({
-                mailWaitMinutes: schedule.mailWaitMinutes,
-                mailBatch: schedule.mailBatch,
-                maxCostPerDay: schedule.maxCostPerDay,
-            }),
-        };
+        const { mailWaitMinutes, mailBatch, maxCostPerDay } = limitsOf(self, schedule);
         if (schedule.kind === "agent" && maxCostPerDay > 0) {
             const spent = spentToday(file);
             if (spent >= maxCostPerDay) {
@@ -342,7 +350,13 @@ export const scheduleCommandFor = ({ app, context: contextOf, newMail, limits: c
             kind: schedule.kind,
             when: describeWhen(schedule.when),
             last: lastRun(scheduleFile(state, schedule.name)) ?? null,
-            ...(schedule.kind === "agent" ? { spentTodayUsd: spentToday(scheduleFile(state, schedule.name)) } : {}),
+            ...(schedule.kind === "agent"
+                ? {
+                    spentTodayUsd: spentToday(scheduleFile(state, schedule.name)),
+                    maxCostUsd: runCapOf(schedule.argv),
+                    maxCostPerDayUsd: limitsOf(this, schedule).maxCostPerDay,
+                }
+                : {}),
         }));
         const answer = listOf("schedule list", {
             items: rows.map((row) => snakeKeys(row)),
@@ -355,7 +369,7 @@ export const scheduleCommandFor = ({ app, context: contextOf, newMail, limits: c
                 return "";
             }
             return rows
-                .map(({ name, kind, when, last, spentTodayUsd }) => [
+                .map(({ name, kind, when, last, spentTodayUsd, maxCostPerDayUsd }) => [
                 name,
                 kind,
                 when,
@@ -366,7 +380,9 @@ export const scheduleCommandFor = ({ app, context: contextOf, newMail, limits: c
                                 `${last.failures} in a row${last.reason ? `: ${last.reason}` : ""} — ${last.output}`
                             : "")
                     : "not run yet",
-                ...(spentTodayUsd ? [`today ${usd(spentTodayUsd)}`] : []),
+                ...(spentTodayUsd
+                    ? [`today ${usd(spentTodayUsd)}${maxCostPerDayUsd ? ` of ${usd(maxCostPerDayUsd)}` : ""}`]
+                    : []),
                 ...(last?.skipped
                     ? [`skipped ${last.skipped.at.slice(0, 16).replace("T", " ")}: ${last.skipped.why}`]
                     : []),

package/dist/entities/index.d.ts

@@ -3979,7 +3979,15 @@ export declare const ENTITIES: {
             readonly error_code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly failing_since: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
             readonly failures: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            readonly cost_usd: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            readonly skipped: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+                readonly why: v.StringSchema<undefined>;
+            }, undefined>, undefined>;
         }, undefined>, undefined>;
+        readonly spent_today_usd: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly max_cost_usd: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+        readonly max_cost_per_day_usd: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
     }, undefined>;
     readonly call_record: v.StrictObjectSchema<{
         readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;

package/dist/entities/list-results.d.ts

@@ -57,7 +57,19 @@ export declare const scheduledJob: v.StrictObjectSchema<{
         readonly error_code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly failing_since: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly failures: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly cost_usd: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        /** The last time a run did not start, and why: the day's cost cap, or too little new mail. */
+        readonly skipped: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+            readonly why: v.StringSchema<undefined>;
+        }, undefined>, undefined>;
     }, undefined>, undefined>;
+    /** Agent schedules: what today's runs cost, in US dollars. */
+    readonly spent_today_usd: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    /** Agent schedules: the cap on one run (`--max-cost`), null when none. */
+    readonly max_cost_usd: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+    /** Agent schedules: the daily cap in force, the schedule's `--max-cost-per-day` or the config's; 0 for none. */
+    readonly max_cost_per_day_usd: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
 }, undefined>;
 export declare const botTemplate: v.StrictObjectSchema<{
     readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;

package/dist/entities/list-results.js

@@ -41,7 +41,16 @@ export const scheduledJob = v.strictObject({
         error_code: v.optional(text),
         failing_since: v.optional(time),
         failures: v.optional(v.number()),
+        cost_usd: v.optional(v.number()),
+        /** The last time a run did not start, and why: the day's cost cap, or too little new mail. */
+        skipped: v.optional(v.strictObject({ at: time, why: text })),
     })),
+    /** Agent schedules: what today's runs cost, in US dollars. */
+    spent_today_usd: v.optional(v.number()),
+    /** Agent schedules: the cap on one run (`--max-cost`), null when none. */
+    max_cost_usd: v.optional(v.nullable(v.number())),
+    /** Agent schedules: the daily cap in force, the schedule's `--max-cost-per-day` or the config's; 0 for none. */
+    max_cost_per_day_usd: v.optional(v.number()),
 });
 export const botTemplate = v.strictObject({
     name: v.nullable(text),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.583.0",
+  "version": "0.584.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",