aec-agent 1.0.3 → 1.0.4

package/dist/components/multi-agent-orchestration/agent/job-manager/schedule.d.ts

@@ -0,0 +1,15 @@
+import type { JobSchedule } from "./types.js";
+/** Shortest "every" interval — keeps an agent from scheduling a turn every second. */
+export declare const MIN_INTERVAL_MS = 60000;
+/** Longest single timer — Node's setTimeout overflows above 2^31-1 ms (it then fires after 1ms). */
+export declare const MAX_TIMER_MS = 2147483647;
+/** Validate a schedule from untrusted input and return it in normalized form. Throws JobError. */
+export declare function validateSchedule(input: unknown): JobSchedule;
+/**
+ * The first run time strictly after `after`, or null when the schedule never
+ * fires again (a one-off time that has passed).
+ */
+export declare function computeNextRun(schedule: JobSchedule, after: Date): Date | null;
+/** A short English description, e.g. "cron 0 8 * * 1 (Asia/Ho_Chi_Minh)" — for logs and tool replies. */
+export declare function describeSchedule(schedule: JobSchedule): string;
+//# sourceMappingURL=schedule.d.ts.map

package/dist/components/multi-agent-orchestration/agent/job-manager/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/job-manager/schedule.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAS9C,sFAAsF;AACtF,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,oGAAoG;AACpG,eAAO,MAAM,YAAY,aAAgB,CAAC;AAE1C,kGAAkG;AAClG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAqC5D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAW9E;AAED,yGAAyG;AACzG,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAS9D"}

package/dist/components/multi-agent-orchestration/agent/job-manager/schedule.js

@@ -0,0 +1,113 @@
+import { Cron } from "croner";
+import { JobError } from "../../../../kernel/errors/job-error.js";
+// ---------------------------------------------------------------------------
+// Schedule math for prompt jobs (A-69) — validation and next-run times.
+// Update (A-126): used by the JobClock for schedule jobs (scheduled tasks were removed).
+// Cron parsing is croner's (ranges, steps, lists, names, timezones, and the
+// classic day-of-month OR day-of-week rule), not a hand-written parser.
+// ---------------------------------------------------------------------------
+/** Shortest "every" interval — keeps an agent from scheduling a turn every second. */
+export const MIN_INTERVAL_MS = 60_000;
+/** Longest single timer — Node's setTimeout overflows above 2^31-1 ms (it then fires after 1ms). */
+export const MAX_TIMER_MS = 2_147_483_647;
+/** Validate a schedule from untrusted input and return it in normalized form. Throws JobError. */
+export function validateSchedule(input) {
+    if (typeof input !== "object" || input === null) {
+        throw invalid('schedule must be an object: { kind: "cron", expr, tz? } | { kind: "every", ms } | { kind: "at", at }');
+    }
+    const raw = input;
+    switch (raw["kind"]) {
+        case "cron": {
+            const expr = typeof raw["expr"] === "string" ? raw["expr"].trim().replace(/\s+/g, " ") : "";
+            if (!expr)
+                throw invalid('cron schedule needs "expr", e.g. "0 8 * * 1" (Mondays 08:00)');
+            const tz = typeof raw["tz"] === "string" && raw["tz"].trim() ? raw["tz"].trim() : undefined;
+            if (tz && !isValidTimezone(tz))
+                throw invalid(`unknown timezone "${tz}" — use an IANA name such as "Asia/Ho_Chi_Minh"`);
+            let cron;
+            try {
+                cron = cronFor(expr, tz);
+            }
+            catch (err) {
+                throw invalid(`invalid cron expression "${expr}": ${err instanceof Error ? err.message : String(err)}`);
+            }
+            // Seconds are not supported (5 fields), so runs are at least a minute apart; check it can fire at all.
+            if (!cron.nextRun())
+                throw invalid(`cron expression "${expr}" never fires`);
+            return tz ? { kind: "cron", expr, tz } : { kind: "cron", expr };
+        }
+        case "every": {
+            const ms = raw["ms"];
+            if (typeof ms !== "number" || !Number.isFinite(ms))
+                throw invalid('"every" schedule needs "ms" (a number of milliseconds)');
+            if (ms < MIN_INTERVAL_MS)
+                throw invalid(`interval must be at least ${MIN_INTERVAL_MS / 1000} seconds`);
+            return { kind: "every", ms: Math.floor(ms) };
+        }
+        case "at": {
+            const at = typeof raw["at"] === "string" ? raw["at"].trim() : "";
+            const time = Date.parse(at);
+            if (!at || Number.isNaN(time))
+                throw invalid('"at" schedule needs "at" as an ISO 8601 time, e.g. "2026-10-07T09:00:00Z"');
+            if (time <= Date.now())
+                throw invalid(`"at" time ${at} is in the past`);
+            return { kind: "at", at: new Date(time).toISOString() };
+        }
+        default:
+            throw invalid('schedule.kind must be "cron", "every" or "at"');
+    }
+}
+/**
+ * The first run time strictly after `after`, or null when the schedule never
+ * fires again (a one-off time that has passed).
+ */
+export function computeNextRun(schedule, after) {
+    switch (schedule.kind) {
+        case "cron":
+            return cronFor(schedule.expr, schedule.tz).nextRun(after);
+        case "every":
+            return new Date(after.getTime() + schedule.ms);
+        case "at": {
+            const at = new Date(schedule.at);
+            return at.getTime() > after.getTime() ? at : null;
+        }
+    }
+}
+/** A short English description, e.g. "cron 0 8 * * 1 (Asia/Ho_Chi_Minh)" — for logs and tool replies. */
+export function describeSchedule(schedule) {
+    switch (schedule.kind) {
+        case "cron":
+            return `cron "${schedule.expr}"${schedule.tz ? ` (${schedule.tz})` : ""}`;
+        case "every":
+            return `every ${formatDuration(schedule.ms)}`;
+        case "at":
+            return `once at ${schedule.at}`;
+    }
+}
+function formatDuration(ms) {
+    const units = [[86_400_000, "day"], [3_600_000, "hour"], [60_000, "minute"]];
+    for (const [size, name] of units) {
+        if (ms % size === 0) {
+            const n = ms / size;
+            return `${n} ${name}${n === 1 ? "" : "s"}`;
+        }
+    }
+    return `${Math.round(ms / 1000)} seconds`;
+}
+/** A paused croner instance — used only to compute times, it never schedules anything itself. */
+function cronFor(expr, tz) {
+    return new Cron(expr, { paused: true, mode: "5-part", ...(tz ? { timezone: tz } : {}) });
+}
+function isValidTimezone(tz) {
+    try {
+        new Intl.DateTimeFormat("en-US", { timeZone: tz });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function invalid(message) {
+    return new JobError(message, "invalid_argument");
+}
+//# sourceMappingURL=schedule.js.map

package/dist/components/multi-agent-orchestration/agent/job-manager/schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/job-manager/schedule.ts"],"names":[],"mappings":"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"}

package/dist/components/multi-agent-orchestration/agent/job-manager/timers.d.ts

@@ -0,0 +1,8 @@
+export interface JobTimer {
+    /** Epoch ms the timer fires at. */
+    readonly at: number;
+    cancel(): void;
+}
+/** Call `fire` at epoch ms `at` (immediately when `at` has passed). */
+export declare function armTimer(at: number, fire: () => void, now?: () => number): JobTimer;
+//# sourceMappingURL=timers.d.ts.map

package/dist/components/multi-agent-orchestration/agent/job-manager/timers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/job-manager/timers.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,QAAQ;IACvB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,EAAE,GAAG,GAAE,MAAM,MAAiB,GAAG,QAAQ,CA6B7F"}

package/dist/components/multi-agent-orchestration/agent/job-manager/timers.js

@@ -0,0 +1,33 @@
+import { MAX_TIMER_MS } from "./schedule.js";
+/** Call `fire` at epoch ms `at` (immediately when `at` has passed). */
+export function armTimer(at, fire, now = Date.now) {
+    let handle = null;
+    let cancelled = false;
+    const wait = () => {
+        // Always through setTimeout — even when already due — so the caller has stored the handle first.
+        handle = setTimeout(tick, Math.min(Math.max(at - now(), 0), MAX_TIMER_MS));
+        handle.unref?.();
+    };
+    const tick = () => {
+        handle = null;
+        if (cancelled)
+            return;
+        if (at - now() > 0) {
+            // Woke from one step of a long delay — wait for the rest.
+            wait();
+            return;
+        }
+        fire();
+    };
+    wait();
+    return {
+        at,
+        cancel() {
+            cancelled = true;
+            if (handle)
+                clearTimeout(handle);
+            handle = null;
+        },
+    };
+}
+//# sourceMappingURL=timers.js.map

package/dist/components/multi-agent-orchestration/agent/job-manager/timers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.js","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/job-manager/timers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAe7C,uEAAuE;AACvE,MAAM,UAAU,QAAQ,CAAC,EAAU,EAAE,IAAgB,EAAE,GAAG,GAAiB,IAAI,CAAC,GAAG;IACjF,IAAI,MAAM,GAAyC,IAAI,CAAC;IACxD,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,iGAAiG;QACjG,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;QAC3E,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;IACnB,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,MAAM,GAAG,IAAI,CAAC;QACd,IAAI,SAAS;YAAE,OAAO;QACtB,IAAI,EAAE,GAAG,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YACnB,0DAA0D;YAC1D,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QACD,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;IACF,IAAI,EAAE,CAAC;IAEP,OAAO;QACL,EAAE;QACF,MAAM;YACJ,SAAS,GAAG,IAAI,CAAC;YACjB,IAAI,MAAM;gBAAE,YAAY,CAAC,MAAM,CAAC,CAAC;YACjC,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}