@namzu/sdk 45.0.0 → 45.1.0

package/dist/schedules/next-fire.js

@@ -0,0 +1,250 @@
+/**
+ * When a spec fires: the next instant, the previous one, and how many fall
+ * in a window.
+ *
+ * Cron is walked a local DAY at a time — never a minute at a time over years
+ * — and a day with no DST change is computed arithmetically from one offset.
+ * Only a day whose offset changes is examined slot by slot, and that is where
+ * cronie's rule is applied:
+ *
+ * - a fixed-time expression (`30 2 * * *`) whose time falls in a
+ *   spring-forward gap fires once, at the first instant after the gap;
+ *   whose time is repeated by a fall-back fires once, at the first of the two;
+ * - a wildcard or step expression (`0 * * * *`, `*\/15 * * * *`) fires at
+ *   every instant whose wall time matches: the repeated hour runs twice and
+ *   slots inside the gap do not exist.
+ */
+import { cronMatchesDay, parseCronExpression } from './cron.js';
+import { ScheduleValidationError } from './errors.js';
+import { civil, firstInstantAfterGap, instantsForWall, offsetAt, validateTimeZone } from './tz.js';
+const MINUTE = 60_000;
+const HOUR = 60 * MINUTE;
+const DAY = 24 * HOUR;
+/** How far ahead a cron search looks before deciding the expression never fires. */
+export const CRON_HORIZON_DAYS = 366 * 5 + 2;
+/**
+ * Occurrence counts stop here. Counting a day without a DST change costs one
+ * multiplication, so the cap bounds the pathological case (a years-long gap
+ * on a per-minute job) rather than the ordinary one.
+ */
+export const OCCURRENCE_COUNT_CAP = 100_000;
+const parsedCache = new Map();
+function cronOf(expr) {
+    let parsed = parsedCache.get(expr);
+    if (!parsed) {
+        parsed = parseCronExpression(expr);
+        if (parsedCache.size > 256)
+            parsedCache.clear();
+        parsedCache.set(expr, parsed);
+    }
+    return parsed;
+}
+/** The local-midnight wall value of the day containing `wall`. */
+function dayStart(wall) {
+    return Math.floor(wall / DAY) * DAY;
+}
+/**
+ * Every instant the expression fires on one local day (`dayWall` is that
+ * day's midnight as a wall value), ascending.
+ */
+export function cronInstantsOnDay(expr, tz, dayWall) {
+    const c = civil(dayWall);
+    if (!cronMatchesDay(expr, c.month, c.day, c.weekday))
+        return [];
+    const before = offsetAt(dayWall - 14 * HOUR, tz);
+    const after = offsetAt(dayWall + DAY + 14 * HOUR, tz);
+    const out = [];
+    if (before === after) {
+        for (const h of expr.hours)
+            for (const m of expr.minutes)
+                out.push(dayWall + h * HOUR + m * MINUTE - before);
+        return out;
+    }
+    // A day the offset changes on (or next to): slot by slot.
+    const seen = new Set();
+    for (const h of expr.hours) {
+        for (const m of expr.minutes) {
+            const wall = dayWall + h * HOUR + m * MINUTE;
+            const instants = instantsForWall(wall, tz);
+            if (instants.length === 0) {
+                if (expr.fixedTime) {
+                    const shifted = firstInstantAfterGap(wall, tz);
+                    if (!seen.has(shifted)) {
+                        seen.add(shifted);
+                        out.push(shifted);
+                    }
+                }
+                continue;
+            }
+            const chosen = expr.fixedTime ? instants.slice(0, 1) : instants;
+            for (const t of chosen) {
+                if (seen.has(t))
+                    continue;
+                seen.add(t);
+                out.push(t);
+            }
+        }
+    }
+    return out.sort((a, b) => a - b);
+}
+function validEvery(spec) {
+    const anchor = Date.parse(spec.anchorAt);
+    if (!Number.isFinite(anchor)) {
+        throw new ScheduleValidationError(`anchor "${spec.anchorAt}" is not a date`, spec.anchorAt);
+    }
+    if (!Number.isSafeInteger(spec.everyMs) || spec.everyMs < MINUTE || spec.everyMs % MINUTE !== 0) {
+        throw new ScheduleValidationError('an interval must be a whole number of minutes, at least one', String(spec.everyMs));
+    }
+    return anchor;
+}
+/**
+ * The first instant strictly after `afterExclusive` at which `spec` fires,
+ * or `null` when there is none (a past `at`, or a cron expression with no
+ * occurrence in the next five years).
+ */
+export function nextFireTime(spec, afterExclusive) {
+    const after = afterExclusive.getTime();
+    switch (spec.kind) {
+        case 'at': {
+            const at = Date.parse(spec.at);
+            return Number.isFinite(at) && at > after ? new Date(at) : null;
+        }
+        case 'every': {
+            const anchor = validEvery(spec);
+            const k = after < anchor ? 1 : Math.floor((after - anchor) / spec.everyMs) + 1;
+            return new Date(anchor + Math.max(1, k) * spec.everyMs);
+        }
+        case 'cron': {
+            const expr = cronOf(spec.expr);
+            const tz = spec.tz;
+            // A day early: a gap-shifted or offset-crossing instant of the
+            // previous local day can still lie after `after`.
+            let day = dayStart(after + offsetAt(after, tz)) - DAY;
+            for (let i = 0; i <= CRON_HORIZON_DAYS; i++, day += DAY) {
+                for (const t of cronInstantsOnDay(expr, tz, day))
+                    if (t > after)
+                        return new Date(t);
+            }
+            return null;
+        }
+    }
+}
+/**
+ * The last instant at or before `atOrBefore` at which `spec` fired, or
+ * `null` if none within the horizon (or before the anchor / the `at`).
+ */
+export function previousFireTime(spec, atOrBefore) {
+    const before = atOrBefore.getTime();
+    switch (spec.kind) {
+        case 'at': {
+            const at = Date.parse(spec.at);
+            return Number.isFinite(at) && at <= before ? new Date(at) : null;
+        }
+        case 'every': {
+            const anchor = validEvery(spec);
+            const k = Math.floor((before - anchor) / spec.everyMs);
+            return k >= 1 ? new Date(anchor + k * spec.everyMs) : null;
+        }
+        case 'cron': {
+            const expr = cronOf(spec.expr);
+            const tz = spec.tz;
+            let day = dayStart(before + offsetAt(before, tz)) + DAY;
+            for (let i = 0; i <= CRON_HORIZON_DAYS; i++, day -= DAY) {
+                const instants = cronInstantsOnDay(expr, tz, day);
+                for (let j = instants.length - 1; j >= 0; j--) {
+                    const t = instants[j];
+                    if (t <= before)
+                        return new Date(t);
+                }
+            }
+            return null;
+        }
+    }
+}
+/**
+ * How many times `spec` fires in `(fromExclusive, toInclusive]`, with the
+ * first and latest of them. Stops counting at `cap` (default 100 000) and
+ * says so, without enumerating beyond it; the latest is exact either way.
+ */
+export function countOccurrences(spec, fromExclusive, toInclusive, cap = OCCURRENCE_COUNT_CAP) {
+    const from = fromExclusive.getTime();
+    const to = toInclusive.getTime();
+    if (to <= from)
+        return { count: 0, capped: false };
+    switch (spec.kind) {
+        case 'at': {
+            const at = Date.parse(spec.at);
+            return at > from && at <= to
+                ? { count: 1, capped: false, first: new Date(at), latest: new Date(at) }
+                : { count: 0, capped: false };
+        }
+        case 'every': {
+            const anchor = validEvery(spec);
+            const firstK = from < anchor ? 1 : Math.floor((from - anchor) / spec.everyMs) + 1;
+            const lastK = Math.floor((to - anchor) / spec.everyMs);
+            if (lastK < Math.max(1, firstK))
+                return { count: 0, capped: false };
+            const k0 = Math.max(1, firstK);
+            const total = lastK - k0 + 1;
+            return {
+                count: Math.min(total, cap),
+                capped: total > cap,
+                first: new Date(anchor + k0 * spec.everyMs),
+                latest: new Date(anchor + lastK * spec.everyMs),
+            };
+        }
+        case 'cron': {
+            const expr = cronOf(spec.expr);
+            const tz = spec.tz;
+            const latest = previousFireTime(spec, toInclusive);
+            if (!latest || latest.getTime() <= from)
+                return { count: 0, capped: false };
+            const perUniformDay = expr.hours.length * expr.minutes.length;
+            let count = 0;
+            let first;
+            const lastDay = dayStart(to + offsetAt(to, tz)) + DAY;
+            for (let day = dayStart(from + offsetAt(from, tz)) - DAY; day <= lastDay; day += DAY) {
+                const c = civil(day);
+                if (!cronMatchesDay(expr, c.month, c.day, c.weekday))
+                    continue;
+                const o1 = offsetAt(day - 14 * HOUR, tz);
+                const o2 = offsetAt(day + DAY + 14 * HOUR, tz);
+                const dayFirst = day - o1;
+                const dayLast = day + DAY - o1;
+                if (first !== undefined && o1 === o2 && dayFirst > from && dayLast <= to) {
+                    count += perUniformDay;
+                }
+                else {
+                    for (const t of cronInstantsOnDay(expr, tz, day)) {
+                        if (t <= from || t > to)
+                            continue;
+                        if (first === undefined)
+                            first = t;
+                        count++;
+                    }
+                }
+                if (count > cap)
+                    break;
+            }
+            return {
+                count: Math.min(count, cap),
+                capped: count > cap,
+                ...(first !== undefined ? { first: new Date(first) } : {}),
+                latest,
+            };
+        }
+    }
+}
+/** Validate a spec as a whole: its zone, its expression, and that it can ever fire after `now`. */
+export function assertSpecFires(spec, now) {
+    if (spec.kind === 'cron') {
+        validateTimeZone(spec.tz);
+        cronOf(spec.expr);
+    }
+    if (nextFireTime(spec, now) === null) {
+        throw new ScheduleValidationError(spec.kind === 'at'
+            ? `${spec.at} is in the past`
+            : `"${spec.kind === 'cron' ? spec.expr : ''}" never fires in the next five years`, spec.kind === 'cron' ? spec.expr : spec.kind === 'at' ? spec.at : undefined);
+    }
+}
+//# sourceMappingURL=next-fire.js.map

package/dist/schedules/next-fire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-fire.js","sourceRoot":"","sources":["../../src/schedules/next-fire.ts"],"names":[],"mappings":"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"}

package/dist/schedules/spec.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The words an operator or a model types for a schedule, turned into a spec.
+ *
+ * | Input | Spec |
+ * |---|---|
+ * | `at 2026-09-24T09:00`, `at 2026-09-24 09:00`, `at 09:00`, `in 30m` | `at` |
+ * | an ISO instant with `Z` or an offset, with or without `at` | `at` |
+ * | `every 30m`, `every 2h`, `every 1d`, `every 90m` | `every` |
+ * | five-field cron, `@hourly`, `@daily`, `@weekly`, `@monthly`, `@yearly` | `cron` |
+ *
+ * A local time is read in `tz`. Nothing is rounded silently: `every 30s` is
+ * refused and the refusal names the nearest interval that is allowed.
+ */
+import type { ScheduleSpec } from './types.js';
+export interface ParseScheduleOptions {
+    /** "Now", for `in …`, `at HH:MM` and the anchor of `every`. Default: the clock. */
+    readonly now?: Date;
+    /** Zone a local time and a cron expression are read in. Default: the host's. */
+    readonly tz?: string;
+}
+/** `90m` → 5 400 000. Throws on anything else. */
+export declare function parseDuration(text: string): number;
+/**
+ * Parse schedule words into a spec, validated: the zone exists, the
+ * expression parses, and the spec fires at least once after `now`.
+ */
+export declare function parseScheduleSpec(input: string, options?: ParseScheduleOptions): ScheduleSpec;
+/** The next `count` fire times after `after`. */
+export declare function upcomingFireTimes(spec: ScheduleSpec, after: Date, count?: number): Date[];
+//# sourceMappingURL=spec.d.ts.map

package/dist/schedules/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/schedules/spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AA4B9C,MAAM,WAAW,oBAAoB;IACpC,mFAAmF;IACnF,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAA;IACnB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,kDAAkD;AAClD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUlD;AAmGD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,YAAY,CA8BjG;AAED,iDAAiD;AACjD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,SAAI,GAAG,IAAI,EAAE,CAUpF"}

package/dist/schedules/spec.js

@@ -0,0 +1,169 @@
+/**
+ * The words an operator or a model types for a schedule, turned into a spec.
+ *
+ * | Input | Spec |
+ * |---|---|
+ * | `at 2026-09-24T09:00`, `at 2026-09-24 09:00`, `at 09:00`, `in 30m` | `at` |
+ * | an ISO instant with `Z` or an offset, with or without `at` | `at` |
+ * | `every 30m`, `every 2h`, `every 1d`, `every 90m` | `every` |
+ * | five-field cron, `@hourly`, `@daily`, `@weekly`, `@monthly`, `@yearly` | `cron` |
+ *
+ * A local time is read in `tz`. Nothing is rounded silently: `every 30s` is
+ * refused and the refusal names the nearest interval that is allowed.
+ */
+import { parseCronExpression } from './cron.js';
+import { ScheduleValidationError } from './errors.js';
+import { assertSpecFires, nextFireTime } from './next-fire.js';
+import { civil, hostTimeZone, instantsForWall, validateTimeZone, wallOf } from './tz.js';
+const MINUTE = 60_000;
+const UNIT_MS = {
+    s: 1_000,
+    sec: 1_000,
+    secs: 1_000,
+    second: 1_000,
+    seconds: 1_000,
+    m: MINUTE,
+    min: MINUTE,
+    mins: MINUTE,
+    minute: MINUTE,
+    minutes: MINUTE,
+    h: 60 * MINUTE,
+    hr: 60 * MINUTE,
+    hrs: 60 * MINUTE,
+    hour: 60 * MINUTE,
+    hours: 60 * MINUTE,
+    d: 24 * 60 * MINUTE,
+    day: 24 * 60 * MINUTE,
+    days: 24 * 60 * MINUTE,
+    w: 7 * 24 * 60 * MINUTE,
+    week: 7 * 24 * 60 * MINUTE,
+    weeks: 7 * 24 * 60 * MINUTE,
+};
+/** `90m` → 5 400 000. Throws on anything else. */
+export function parseDuration(text) {
+    const match = /^(\d+)\s*([a-z]+)$/i.exec(text.trim());
+    const unit = match ? UNIT_MS[(match[2] ?? '').toLowerCase()] : undefined;
+    if (!match || unit === undefined) {
+        throw new ScheduleValidationError(`"${text}" is not a duration (write it like 30m, 2h, 1d)`, text);
+    }
+    return Number(match[1]) * unit;
+}
+function formatInterval(ms) {
+    if (ms % (24 * 60 * MINUTE) === 0)
+        return `${ms / (24 * 60 * MINUTE)}d`;
+    if (ms % (60 * MINUTE) === 0)
+        return `${ms / (60 * MINUTE)}h`;
+    return `${ms / MINUTE}m`;
+}
+function everySpec(text, now) {
+    const ms = parseDuration(text);
+    if (ms < MINUTE) {
+        throw new ScheduleValidationError(`every ${text} is shorter than the minimum interval; the nearest allowed is every 1m`, text);
+    }
+    if (ms % MINUTE !== 0) {
+        const down = Math.floor(ms / MINUTE) * MINUTE;
+        const up = down + MINUTE;
+        throw new ScheduleValidationError(`every ${text} is not a whole number of minutes; the nearest allowed are every ${formatInterval(down)} and every ${formatInterval(up)}`, text);
+    }
+    const anchor = new Date(Math.floor(now.getTime() / MINUTE) * MINUTE);
+    return { kind: 'every', everyMs: ms, anchorAt: anchor.toISOString() };
+}
+/** Resolve a local `YYYY-MM-DD HH:MM` in `tz` to one instant (the earlier of two). */
+function localToInstant(y, mo, d, h, mi, tz, token) {
+    const wall = Date.UTC(y, mo - 1, d, h, mi);
+    const c = civil(wall);
+    if (c.year !== y || c.month !== mo || c.day !== d || h > 23 || mi > 59) {
+        throw new ScheduleValidationError(`"${token}" is not a real date and time`, token);
+    }
+    const instants = instantsForWall(wall, tz);
+    if (instants.length === 0) {
+        throw new ScheduleValidationError(`"${token}" does not exist in ${tz} (the clocks skip it); pick a time outside the change`, token);
+    }
+    return instants[0];
+}
+function atSpec(text, now, tz) {
+    const t = text.trim();
+    // An instant with its own offset: taken as written.
+    if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:?\d{2})$/i.test(t)) {
+        const at = Date.parse(t);
+        if (!Number.isFinite(at))
+            throw new ScheduleValidationError(`"${t}" is not a date`, t);
+        return { kind: 'at', at: new Date(at).toISOString() };
+    }
+    const full = /^(\d{4})-(\d{2})-(\d{2})[T ](\d{1,2}):(\d{2})$/.exec(t);
+    if (full) {
+        const [, y, mo, d, h, mi] = full.map(Number);
+        const at = localToInstant(y, mo, d, h, mi, tz, t);
+        return { kind: 'at', at: new Date(at).toISOString() };
+    }
+    const clock = /^(\d{1,2}):(\d{2})$/.exec(t);
+    if (clock) {
+        const h = Number(clock[1]);
+        const mi = Number(clock[2]);
+        if (h > 23 || mi > 59)
+            throw new ScheduleValidationError(`"${t}" is not a time of day`, t);
+        // The next time the wall clock reads HH:MM, today or tomorrow.
+        const today = civil(wallOf(now.getTime(), tz));
+        for (let add = 0; add < 3; add++) {
+            const day = new Date(Date.UTC(today.year, today.month - 1, today.day + add));
+            const instants = instantsForWall(Date.UTC(day.getUTCFullYear(), day.getUTCMonth(), day.getUTCDate(), h, mi), tz);
+            const first = instants.find((i) => i > now.getTime());
+            if (first !== undefined)
+                return { kind: 'at', at: new Date(first).toISOString() };
+        }
+        throw new ScheduleValidationError(`"${t}" does not occur in ${tz} in the next two days`, t);
+    }
+    throw new ScheduleValidationError(`"${t}" is not a time (write 2026-09-24 09:00, 09:00, or an ISO instant)`, t);
+}
+/**
+ * Parse schedule words into a spec, validated: the zone exists, the
+ * expression parses, and the spec fires at least once after `now`.
+ */
+export function parseScheduleSpec(input, options = {}) {
+    const now = options.now ?? new Date();
+    const tz = validateTimeZone(options.tz ?? hostTimeZone());
+    const text = input.trim();
+    if (text === '')
+        throw new ScheduleValidationError('a schedule is required', '');
+    let spec;
+    const lower = text.toLowerCase();
+    if (lower.startsWith('every ')) {
+        spec = everySpec(text.slice(6).trim(), now);
+    }
+    else if (lower.startsWith('in ')) {
+        const ms = parseDuration(text.slice(3).trim());
+        if (ms < MINUTE) {
+            throw new ScheduleValidationError(`in ${text.slice(3).trim()} is less than a minute away; the nearest allowed is in 1m`, text.slice(3).trim());
+        }
+        spec = { kind: 'at', at: new Date(now.getTime() + ms).toISOString() };
+    }
+    else if (lower.startsWith('at ')) {
+        spec = atSpec(text.slice(3), now, tz);
+    }
+    else if (/^\d{4}-\d{2}-\d{2}T/i.test(text)) {
+        spec = atSpec(text, now, tz);
+    }
+    else if (lower === '@reboot') {
+        throw new ScheduleValidationError('@reboot is not supported: a job runs on a schedule', text);
+    }
+    else {
+        const expr = parseCronExpression(text);
+        spec = { kind: 'cron', expr: expr.source, tz };
+    }
+    assertSpecFires(spec, now);
+    return spec;
+}
+/** The next `count` fire times after `after`. */
+export function upcomingFireTimes(spec, after, count = 3) {
+    const out = [];
+    let cursor = after;
+    for (let i = 0; i < count; i++) {
+        const next = nextFireTime(spec, cursor);
+        if (!next)
+            break;
+        out.push(next);
+        cursor = next;
+    }
+    return out;
+}
+//# sourceMappingURL=spec.js.map

package/dist/schedules/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/schedules/spec.ts"],"names":[],"mappings":"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"}

package/dist/schedules/types.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Types of the schedule time engine and evaluator.
+ *
+ * The SDK owns WHEN something is due and nothing about how a host stores a
+ * job or runs it: the CLI keeps its job files, claims and history records to
+ * itself, so its on-disk format is not SDK API. The unions exported here
+ * (`ScheduleDecision`, `ScheduleSkipReason`, `ScheduleMissedReason`) may grow
+ * in a minor release; switch over them with a `default:` branch.
+ */
+/** A single instant (ISO-8601 UTC). */
+export interface ScheduleAtSpec {
+    readonly kind: 'at';
+    readonly at: string;
+}
+/**
+ * Elapsed time from an anchor: `anchorAt + k * everyMs` for k ≥ 1. Pure UTC
+ * arithmetic, so `every 24h` drifts against the wall clock across a DST
+ * change; a cron spec is the way to say "every day at 09:00".
+ */
+export interface ScheduleEverySpec {
+    readonly kind: 'every';
+    /** At least one minute, and a whole number of minutes. */
+    readonly everyMs: number;
+    readonly anchorAt: string;
+}
+/** Five-field cron, evaluated in an IANA time zone the spec carries. */
+export interface ScheduleCronSpec {
+    readonly kind: 'cron';
+    /** Normalised five-field text; macros are expanded. */
+    readonly expr: string;
+    readonly tz: string;
+}
+export type ScheduleSpec = ScheduleAtSpec | ScheduleEverySpec | ScheduleCronSpec;
+/** A parsed cron expression: each field as the sorted set of values it allows. */
+export interface CronExpression {
+    readonly source: string;
+    readonly minutes: readonly number[];
+    readonly hours: readonly number[];
+    readonly daysOfMonth: readonly number[];
+    readonly months: readonly number[];
+    /** 0-6, Sunday = 0 (a written 7 is folded into 0). */
+    readonly daysOfWeek: readonly number[];
+    /** The day-of-month field does not start with `*`. */
+    readonly domRestricted: boolean;
+    /** The day-of-week field does not start with `*`. */
+    readonly dowRestricted: boolean;
+    /**
+     * Minute and hour are single values or lists with no `*` or step. Decides
+     * the DST rule (cronie's): a fixed-time job fires once per day across a
+     * DST change, a wildcard job fires at every instant whose wall time
+     * matches.
+     */
+    readonly fixedTime: boolean;
+}
+/** Why an occurrence did not run. May grow in a minor release. */
+export type ScheduleSkipReason = 'previous-run-active' | 'previous-run-awaiting-approval' | 'paused' | 'awaiting-confirmation' | 'beyond-catch-up-window' | 'one-shot-expired' | 'quota-hold';
+/** Why occurrences were missed. Best effort; may grow in a minor release. */
+export type ScheduleMissedReason = 'daemon-not-running' | 'machine-asleep' | 'clock-jumped-forward';
+/** The lifecycle a job is in, as far as the evaluator cares. */
+export type ScheduleJobLifecycle = 'pending-confirmation' | 'active' | 'paused' | 'completed' | 'expired';
+/** The evaluator's structural view of a job: what it needs and nothing else. */
+export interface ScheduleEvaluationJob {
+    readonly spec: ScheduleSpec;
+    readonly state: ScheduleJobLifecycle;
+    /** Catch-up window; default {@link SCHEDULE_CATCH_UP_WINDOW_MS}. */
+    readonly catchUp?: {
+        readonly windowMs: number;
+    };
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    /** Bumped on every definition change. */
+    readonly revision: number;
+}
+/** What the host remembers between evaluations of one job. */
+export interface ScheduleEvaluationState {
+    /** Everything up to and including this instant has been decided. */
+    readonly lastEvaluatedAt?: string;
+    /** The job revision `lastEvaluatedAt` was computed under. */
+    readonly jobRevision?: number;
+    /** A run of this job that has not finished (or a fire queued but not started). */
+    readonly activeRun?: {
+        readonly status: 'queued' | 'running' | 'awaiting-approval';
+    };
+    /** Provider asked to be left alone until this instant. */
+    readonly quotaHoldUntil?: string;
+}
+export interface ScheduleObservedGap {
+    readonly from: Date;
+    readonly to: Date;
+    readonly kind: 'asleep' | 'clock-forward' | 'clock-backward';
+}
+export interface ScheduleEvaluationInput {
+    readonly job: ScheduleEvaluationJob;
+    readonly state: ScheduleEvaluationState;
+    readonly now: Date;
+    /** When this daemon instance started, and a gap it observed itself. */
+    readonly daemon: {
+        readonly startedAt: Date;
+        readonly observedGap?: ScheduleObservedGap;
+    };
+    /** How late a fire may be and still count as on time; default {@link SCHEDULE_LATE_GRACE_MS}. */
+    readonly lateGraceMs?: number;
+    /** Whether an occurrence key was already started (claimed) by someone. */
+    readonly isClaimed?: (key: string) => boolean;
+}
+export type ScheduleFireTrigger = 'scheduled' | 'late' | 'catch-up';
+/** What to do about one job now. May grow in a minor release. */
+export interface ScheduleDecision {
+    readonly fire?: {
+        /** Occurrence key: the scheduled instant in epoch milliseconds. */
+        readonly key: string;
+        readonly scheduledFor: Date;
+        readonly trigger: ScheduleFireTrigger;
+    };
+    /** Occurrences that will not run, collapsed: one entry per reason. */
+    readonly skip: readonly {
+        readonly scheduledFor: Date;
+        readonly reason: ScheduleSkipReason;
+        readonly count: number;
+    }[];
+    readonly missed?: {
+        readonly from: Date;
+        readonly to: Date;
+        readonly count: number;
+        /** The count stopped at the cap; the real number is at least `count`. */
+        readonly capped: boolean;
+        readonly reason: ScheduleMissedReason;
+    };
+    readonly jobTransition?: 'completed' | 'expired';
+    readonly nextState: {
+        readonly lastEvaluatedAt: Date;
+        readonly nextFireAt?: Date;
+        readonly jobRevision: number;
+    };
+}
+/** How occurrences in a window were counted. */
+export interface OccurrenceCount {
+    readonly count: number;
+    /** The count stopped at the cap. */
+    readonly capped: boolean;
+    readonly first?: Date;
+    readonly latest?: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/schedules/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/schedules/types.ts"],"names":[],"mappings":"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"}

package/dist/schedules/types.js

@@ -0,0 +1,11 @@
+/**
+ * Types of the schedule time engine and evaluator.
+ *
+ * The SDK owns WHEN something is due and nothing about how a host stores a
+ * job or runs it: the CLI keeps its job files, claims and history records to
+ * itself, so its on-disk format is not SDK API. The unions exported here
+ * (`ScheduleDecision`, `ScheduleSkipReason`, `ScheduleMissedReason`) may grow
+ * in a minor release; switch over them with a `default:` branch.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/schedules/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/schedules/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}