@namzu/sdk 44.3.0 → 45.1.0

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":"AAAA;;;;;;;;GAQG;AAEH,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CACzB;AAED,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,iBAAiB,GAAG,gBAAgB,CAAA;AAEhF,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,sDAAsD;IACtD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC3B;AAED,kEAAkE;AAClE,MAAM,MAAM,kBAAkB,GAC3B,qBAAqB,GACrB,gCAAgC,GAChC,QAAQ,GACR,uBAAuB,GACvB,wBAAwB,GACxB,kBAAkB,GAClB,YAAY,CAAA;AAEf,6EAA6E;AAC7E,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,GAAG,gBAAgB,GAAG,sBAAsB,CAAA;AAEnG,gEAAgE;AAChE,MAAM,MAAM,oBAAoB,GAC7B,sBAAsB,GACtB,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,SAAS,CAAA;AAEZ,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;IACpC,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CACzB;AAED,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACvC,oEAAoE;IACpE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,kFAAkF;IAClF,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,mBAAmB,CAAA;KAAE,CAAA;IACpF,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAChC;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;IACjB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,eAAe,GAAG,gBAAgB,CAAA;CAC5D;AAED,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,GAAG,EAAE,qBAAqB,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAA;IACvC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAA;IAClB,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,mBAAmB,CAAA;KAAE,CAAA;IACzF,iGAAiG;IACjG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;CAC7C;AAED,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,CAAA;AAEnE,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE;QACf,mEAAmE;QACnE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;QACpB,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAA;QAC3B,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAA;KACrC,CAAA;IACD,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,SAAS;QACvB,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAA;QAC3B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;QACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KACtB,EAAE,CAAA;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE;QACjB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;QACnB,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;QACjB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,yEAAyE;QACzE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;QACxB,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;KACrC,CAAA;IACD,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;IAChD,QAAQ,CAAC,SAAS,EAAE;QACnB,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAA;QAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,CAAA;QAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAC5B,CAAA;CACD;AAED,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAA;CACtB"}

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"}

package/dist/schedules/tz.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Time-zone arithmetic over `Intl` alone.
+ *
+ * The SDK carries no time-zone database of its own: the runtime's ICU data is
+ * the source, read through `Intl.DateTimeFormat#formatToParts`. Everything in
+ * this file is expressed in "wall" milliseconds — a local date and time
+ * written as if it were UTC (`Date.UTC(y, m - 1, d, h, min)`) — so local
+ * arithmetic is plain integer arithmetic and only the conversions touch Intl.
+ */
+/**
+ * Throw unless `tz` is an IANA zone this runtime knows. Returns the zone as
+ * the runtime spells it (`europe/istanbul` → `Europe/Istanbul`).
+ */
+export declare function validateTimeZone(tz: string): string;
+/** The zone this host is in, as the runtime reports it. */
+export declare function hostTimeZone(): string;
+/** The wall clock of `instant` in `tz`, as wall milliseconds (seconds dropped). */
+export declare function wallOf(instant: number, tz: string): number;
+/** `tz`'s offset from UTC at `instant`, in milliseconds, minute precision. */
+export declare function offsetAt(instant: number, tz: string): number;
+/**
+ * Every instant whose wall clock in `tz` reads `wall`.
+ *
+ * One instant normally, two in the hour a fall-back repeats (earliest first),
+ * none in the hour a spring-forward skips.
+ */
+export declare function instantsForWall(wall: number, tz: string): number[];
+/**
+ * The first instant whose wall clock is later than `wall`, for a `wall` that
+ * falls inside a spring-forward gap: the moment the clocks jumped.
+ */
+export declare function firstInstantAfterGap(wall: number, tz: string): number;
+/** Civil date parts of a wall value. */
+export declare function civil(wall: number): {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+    weekday: number;
+};
+/** `YYYY-MM-DD HH:MM` for an instant in `tz`. */
+export declare function formatWall(instant: number, tz: string): string;
+//# sourceMappingURL=tz.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tz.d.ts","sourceRoot":"","sources":["../../src/schedules/tz.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2BH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CASnD;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,mFAAmF;AACnF,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CA2B1D;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAYlE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAYrE;AAED,wCAAwC;AACxC,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CACf,CAUA;AAED,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAI9D"}

package/dist/schedules/tz.js

@@ -0,0 +1,141 @@
+/**
+ * Time-zone arithmetic over `Intl` alone.
+ *
+ * The SDK carries no time-zone database of its own: the runtime's ICU data is
+ * the source, read through `Intl.DateTimeFormat#formatToParts`. Everything in
+ * this file is expressed in "wall" milliseconds — a local date and time
+ * written as if it were UTC (`Date.UTC(y, m - 1, d, h, min)`) — so local
+ * arithmetic is plain integer arithmetic and only the conversions touch Intl.
+ */
+import { ScheduleValidationError } from './errors.js';
+const MINUTE = 60_000;
+const HOUR = 60 * MINUTE;
+const formatters = new Map();
+function formatterFor(tz) {
+    let f = formatters.get(tz);
+    if (!f) {
+        f = new Intl.DateTimeFormat('en-US', {
+            timeZone: tz,
+            hourCycle: 'h23',
+            year: 'numeric',
+            month: 'numeric',
+            day: 'numeric',
+            hour: 'numeric',
+            minute: 'numeric',
+            second: 'numeric',
+        });
+        formatters.set(tz, f);
+    }
+    return f;
+}
+/**
+ * Throw unless `tz` is an IANA zone this runtime knows. Returns the zone as
+ * the runtime spells it (`europe/istanbul` → `Europe/Istanbul`).
+ */
+export function validateTimeZone(tz) {
+    if (typeof tz !== 'string' || tz.trim() === '') {
+        throw new ScheduleValidationError('a time zone is required', String(tz));
+    }
+    try {
+        return new Intl.DateTimeFormat('en-US', { timeZone: tz.trim() }).resolvedOptions().timeZone;
+    }
+    catch {
+        throw new ScheduleValidationError(`unknown time zone "${tz}"`, tz);
+    }
+}
+/** The zone this host is in, as the runtime reports it. */
+export function hostTimeZone() {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC';
+}
+/** The wall clock of `instant` in `tz`, as wall milliseconds (seconds dropped). */
+export function wallOf(instant, tz) {
+    const parts = formatterFor(tz).formatToParts(new Date(instant));
+    let year = 0;
+    let month = 1;
+    let day = 1;
+    let hour = 0;
+    let minute = 0;
+    for (const part of parts) {
+        switch (part.type) {
+            case 'year':
+                year = Number(part.value);
+                break;
+            case 'month':
+                month = Number(part.value);
+                break;
+            case 'day':
+                day = Number(part.value);
+                break;
+            case 'hour':
+                hour = Number(part.value) % 24;
+                break;
+            case 'minute':
+                minute = Number(part.value);
+                break;
+        }
+    }
+    return Date.UTC(year, month - 1, day, hour, minute);
+}
+/** `tz`'s offset from UTC at `instant`, in milliseconds, minute precision. */
+export function offsetAt(instant, tz) {
+    const floored = Math.floor(instant / MINUTE) * MINUTE;
+    return wallOf(floored, tz) - floored;
+}
+/**
+ * Every instant whose wall clock in `tz` reads `wall`.
+ *
+ * One instant normally, two in the hour a fall-back repeats (earliest first),
+ * none in the hour a spring-forward skips.
+ */
+export function instantsForWall(wall, tz) {
+    const offsets = new Set([
+        offsetAt(wall - 26 * HOUR, tz),
+        offsetAt(wall, tz),
+        offsetAt(wall + 26 * HOUR, tz),
+    ]);
+    const found = new Set();
+    for (const offset of offsets) {
+        const candidate = wall - offset;
+        if (wallOf(candidate, tz) === wall)
+            found.add(candidate);
+    }
+    return [...found].sort((a, b) => a - b);
+}
+/**
+ * The first instant whose wall clock is later than `wall`, for a `wall` that
+ * falls inside a spring-forward gap: the moment the clocks jumped.
+ */
+export function firstInstantAfterGap(wall, tz) {
+    const a = offsetAt(wall - 26 * HOUR, tz);
+    const b = offsetAt(wall + 26 * HOUR, tz);
+    let lo = Math.floor((wall - Math.max(a, b)) / MINUTE);
+    let hi = Math.ceil((wall - Math.min(a, b)) / MINUTE);
+    // Smallest minute m in [lo, hi] with wallOf(m) > wall.
+    while (lo < hi) {
+        const mid = Math.floor((lo + hi) / 2);
+        if (wallOf(mid * MINUTE, tz) > wall)
+            hi = mid;
+        else
+            lo = mid + 1;
+    }
+    return lo * MINUTE;
+}
+/** Civil date parts of a wall value. */
+export function civil(wall) {
+    const d = new Date(wall);
+    return {
+        year: d.getUTCFullYear(),
+        month: d.getUTCMonth() + 1,
+        day: d.getUTCDate(),
+        hour: d.getUTCHours(),
+        minute: d.getUTCMinutes(),
+        weekday: d.getUTCDay(),
+    };
+}
+/** `YYYY-MM-DD HH:MM` for an instant in `tz`. */
+export function formatWall(instant, tz) {
+    const c = civil(wallOf(instant, tz));
+    const p = (n) => String(n).padStart(2, '0');
+    return `${c.year}-${p(c.month)}-${p(c.day)} ${p(c.hour)}:${p(c.minute)}`;
+}
+//# sourceMappingURL=tz.js.map

package/dist/schedules/tz.js.map

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

package/dist/skills/index.d.ts

@@ -1,3 +1,3 @@
-export { loadSkill, discoverSkills } from './loader.js';
+export { SKILL_FRONTMATTER_KEYS, loadSkill, discoverSkills } from './loader.js';
 export { SkillRegistry, resolveSkillChain } from './registry.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/skills/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC/E,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA"}

package/dist/skills/index.js

@@ -1,3 +1,3 @@
-export { loadSkill, discoverSkills } from './loader.js';
+export { SKILL_FRONTMATTER_KEYS, loadSkill, discoverSkills } from './loader.js';
 export { SkillRegistry, resolveSkillChain } from './registry.js';
 //# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC/E,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA"}

package/dist/skills/loader.d.ts

@@ -1,6 +1,27 @@
 import type { SkillDisclosureLevel, SkillLoadResult } from '../types/skills/index.js';
 import { type Logger } from '../utils/logger.js';
 export declare const SKILL_FILENAME = "SKILL.md";
+/**
+ * The frontmatter keys this loader reads.
+ *
+ * Every other key is skipped whole, whatever YAML it is written in, so a
+ * skill written for another agent — `argument-hint: [file]`, a `hooks:`
+ * block, `user-invocable: false` — loads here with those fields ignored
+ * instead of being refused over syntax in a field nothing reads. The keys
+ * listed are still parsed strictly: a value this loader USES is never read
+ * wrongly.
+ */
+export declare const SKILL_FRONTMATTER_KEYS: readonly string[];
+/**
+ * How this loader reads frontmatter. `allowed-tools` may be a YAML list: the
+ * Agent Skills format writes it space-separated, comma-separated or as a
+ * list, and all three must mean the same grant; the reader joins a list into
+ * the comma form. Keys the loader does not read are skipped whole.
+ */
+export declare const SKILL_FRONTMATTER_OPTIONS: {
+    readonly lists: readonly ["allowed-tools"];
+    readonly readsKey: (key: string) => boolean;
+};
 export declare function loadSkill(dirPath: string, level?: SkillDisclosureLevel, log?: Logger): Promise<SkillLoadResult>;
 export declare function discoverSkills(parentDir: string, log?: Logger): Promise<string[]>;
 //# sourceMappingURL=loader.d.ts.map

package/dist/skills/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEX,oBAAoB,EACpB,eAAe,EAEf,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,oBAAoB,CAAA;AAE/D,eAAO,MAAM,cAAc,aAAa,CAAA;AAuIxC,wBAAsB,SAAS,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,oBAAiC,EACxC,GAAG,CAAC,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,CAAC,CAwC1B;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBvF"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEX,oBAAoB,EACpB,eAAe,EAEf,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,oBAAoB,CAAA;AAE/D,eAAO,MAAM,cAAc,aAAa,CAAA;AAExC;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EASlD,CAAA;AAIF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;6BARR,MAAM,KAAG,OAAO;CAWpC,CAAA;AA+JV,wBAAsB,SAAS,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,oBAAiC,EACxC,GAAG,CAAC,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,CAAC,CAwC1B;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBvF"}

package/dist/skills/loader.js

@@ -4,6 +4,37 @@ import { parseFrontmatter } from '../utils/frontmatter.js';
 import { SCOPE_ATTRIBUTE } from '../utils/log/types.js';
 import { resolveLogger } from '../utils/logger.js';
 export const SKILL_FILENAME = 'SKILL.md';
+/**
+ * The frontmatter keys this loader reads.
+ *
+ * Every other key is skipped whole, whatever YAML it is written in, so a
+ * skill written for another agent — `argument-hint: [file]`, a `hooks:`
+ * block, `user-invocable: false` — loads here with those fields ignored
+ * instead of being refused over syntax in a field nothing reads. The keys
+ * listed are still parsed strictly: a value this loader USES is never read
+ * wrongly.
+ */
+export const SKILL_FRONTMATTER_KEYS = Object.freeze([
+    'name',
+    'description',
+    'license',
+    'compatibility',
+    'allowed-tools',
+    'invocation',
+    'disable-model-invocation',
+    'metadata',
+]);
+const READS_SKILL_KEY = (key) => SKILL_FRONTMATTER_KEYS.includes(key);
+/**
+ * How this loader reads frontmatter. `allowed-tools` may be a YAML list: the
+ * Agent Skills format writes it space-separated, comma-separated or as a
+ * list, and all three must mean the same grant; the reader joins a list into
+ * the comma form. Keys the loader does not read are skipped whole.
+ */
+export const SKILL_FRONTMATTER_OPTIONS = {
+    lists: ['allowed-tools'],
+    readsKey: READS_SKILL_KEY,
+};
 /**
  * How this file's errors name themselves. Passed to the shared reader so a
  * frontmatter failure still reads as a `SKILL.md` failure — the reader is
@@ -80,6 +111,25 @@ function toSkillMetadata(parsed, dirPath) {
         }
         skillMetadata.invocation = invocation;
     }
+    // The other common spelling of "the model may not pick this":
+    // `disable-model-invocation: true` is `invocation: operator`. Read here,
+    // at the one parser, so a registry that re-reads the file on every load
+    // cannot lose it — a host-side override would be dropped by the first
+    // freshness reload and the model could then load an operator-only skill.
+    const disableModel = scalarAt(values, 'disable-model-invocation');
+    if (disableModel !== undefined) {
+        if (disableModel !== 'true' && disableModel !== 'false') {
+            // Refused for the reason `invocation` is: `yes` quietly reading as
+            // "not disabled" would put the skill back in front of the model.
+            throw new Error(`${source}: disable-model-invocation must be true or false — got "${disableModel}"`);
+        }
+        if (disableModel === 'true') {
+            if (skillMetadata.invocation !== undefined && skillMetadata.invocation !== 'operator') {
+                throw new Error(`${source}: disable-model-invocation: true contradicts invocation: ${skillMetadata.invocation}`);
+            }
+            skillMetadata.invocation = 'operator';
+        }
+    }
     const extra = mappingAt(values, 'metadata');
     if (extra && Object.keys(extra).length > 0) {
         skillMetadata.metadata = { ...extra };
@@ -114,7 +164,7 @@ function estimateTokens(text) {
 export async function loadSkill(dirPath, level = 'metadata', log) {
     const skillMdPath = join(dirPath, SKILL_FILENAME);
     const raw = await readFile(skillMdPath, 'utf-8');
-    const parsed = parseFrontmatter(raw, sourceLabel(dirPath));
+    const parsed = parseFrontmatter(raw, sourceLabel(dirPath), SKILL_FRONTMATTER_OPTIONS);
     const metadata = toSkillMetadata(parsed, dirPath);
     const skill = {
         metadata,

package/dist/skills/loader.js.map

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

package/dist/tools/builtins/bash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/bash.ts"],"names":[],"mappings":"AA2RA,6GAA6G;AAC7G,eAAO,MAAM,qBAAqB,4NACwL,CAAA;AAE1N;;;GAGG;AACH,eAAO,MAAM,2BAA2B,sSAC4P,CAAA;AAEpS,eAAO,MAAM,QAAQ;;;;;EA8PnB,CAAA"}
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/bash.ts"],"names":[],"mappings":"AAwSA,6GAA6G;AAC7G,eAAO,MAAM,qBAAqB,4NACwL,CAAA;AAE1N;;;GAGG;AACH,eAAO,MAAM,2BAA2B,sSAC4P,CAAA;AAEpS,eAAO,MAAM,QAAQ;;;;;EAmQnB,CAAA"}

package/dist/tools/builtins/bash.js

@@ -6,6 +6,7 @@ import { DANGEROUS_PATTERNS } from '../../constants/tools/index.js';
 import { killTree } from '../../process/kill-tree.js';
 import { subscribeToAbort } from '../../utils/abort.js';
 import { readPositiveIntEnv } from '../../utils/env.js';
+import { bashToolDialect, hostShellSpawn, sandboxShellSpawn, withoutBashStartup, } from '../command-shell.js';
 import { defineTool } from '../defineTool.js';
 import { scrubInheritedEnv } from '../env-scrub.js';
 // Namzu owns its own bash timeout knob — `NAMZU_BASH_TIMEOUT_MS`.
@@ -115,13 +116,19 @@ function shellProgress(report) {
 function execHostShell(command, options) {
     options.signal?.throwIfAborted();
     return new Promise((resolve, reject) => {
-        const child = spawn(command, {
+        // bash where the host has it, `/bin/sh` where it does not; the
+        // permission rules read the line in the matching dialect. See
+        // `../command-shell.ts`.
+        const shell = hostShellSpawn(command, options.env);
+        const spawnOptions = {
             cwd: options.cwd,
-            env: options.env,
-            shell: true,
+            env: shell.env,
             // killTree's negative PID must never target the caller's own group.
             detached: process.platform !== 'win32',
-        });
+        };
+        const child = shell.file === undefined
+            ? spawn(command, { ...spawnOptions, shell: true })
+            : spawn(shell.file, [...shell.args], spawnOptions);
         const captures = {
             stdout: {
                 chunks: [],
@@ -262,6 +269,8 @@ export const BashTool = defineTool({
     // so a permission rule about it is a rule about several commands more often
     // than not. Naming the argument is what lets the gate read it that way.
     commandArgument: 'command',
+    // The shell that runs it, so the rules read the line as that shell will.
+    commandDialect: bashToolDialect,
     // The kernel reviews a call that sets it under a sandbox every time and
     // confirms it only by id; see `ToolDefinition.sandboxEscapeArgument`.
     sandboxEscapeArgument: 'dangerously_disable_sandbox',
@@ -369,9 +378,12 @@ export const BashTool = defineTool({
         // builtin doesn't have that requirement today.
         const onOutput = shellProgress(context.report);
         if (context.sandbox && !leaveSandbox) {
-            const result = await context.sandbox.exec('/bin/sh', ['-c', input.command], {
+            // bash if the guest has it, `/bin/sh` if not; read in the `sh`
+            // dialect, which holds for both.
+            const launch = sandboxShellSpawn(input.command);
+            const result = await context.sandbox.exec(launch.file, launch.args, {
                 timeout: input.timeout,
-                env: context.env,
+                ...(context.env ? { env: withoutBashStartup(context.env) } : {}),
                 // Same reason as the host path below: a Stop must reach the
                 // process, not just the promise waiting on it.
                 signal: context.abortSignal,