@glows777/vela-channels 0.0.0-stage → 0.5.0

package/dist/routine-time.d.ts

@@ -0,0 +1,8 @@
+import type { RoutineSchedule } from './types.ts';
+export declare function routineTimezone(value?: unknown): string;
+/** A tool's date/time is local to the deployment, never the host's Date parser. */
+export declare function localRoutineInstant(value: string, zone: string): string;
+export declare function routineLocalTime(at: number, zone: string): string;
+export declare function nextOccurrence(schedule: RoutineSchedule, after: number, zone: string): number | undefined;
+export declare function latestOccurrence(schedule: RoutineSchedule, after: number, through: number, zone: string): number | undefined;
+//# sourceMappingURL=routine-time.d.ts.map

package/dist/routine-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routine-time.d.ts","sourceRoot":"","sources":["../src/routine-time.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAKjD,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAgBvD;AA2DD,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAUvE;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjE;AAgBD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAYpB;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAYpB"}

package/dist/routine-time.js

@@ -0,0 +1,114 @@
+const weekdays = ['sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat'];
+const formatters = new Map();
+export function routineTimezone(value) {
+    if (value !== undefined &&
+        (typeof value !== 'string' || !value.trim() || /^[+-]/.test(value)))
+        throw new Error('Routine timezone must be an IANA timezone name');
+    const zone = value === undefined
+        ? new Intl.DateTimeFormat().resolvedOptions().timeZone
+        : value;
+    try {
+        formatter(zone);
+    }
+    catch (cause) {
+        throw new Error(`Invalid routine timezone ${zone}`, { cause });
+    }
+    return zone;
+}
+function formatter(zone) {
+    let value = formatters.get(zone);
+    if (!value) {
+        value = new Intl.DateTimeFormat('en-GB', {
+            timeZone: zone,
+            year: 'numeric',
+            month: '2-digit',
+            day: '2-digit',
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit',
+            hourCycle: 'h23',
+        });
+        formatters.set(zone, value);
+    }
+    return value;
+}
+function localWall(at, zone) {
+    const parts = Object.fromEntries(formatter(zone)
+        .formatToParts(at)
+        .map((p) => [p.type, Number(p.value)]));
+    return Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, parts.second);
+}
+function localDay(at, zone) {
+    const day = new Date(localWall(at, zone));
+    return Date.UTC(day.getUTCFullYear(), day.getUTCMonth(), day.getUTCDate());
+}
+/** Resolve a local wall clock using offsets on both sides of a transition. */
+function occurrence(day, time, zone) {
+    const [hour, minute] = time.split(':').map(Number);
+    const wall = day + hour * 3_600_000 + minute * 60_000;
+    const offsets = new Set();
+    for (let hours = -36; hours <= 36; hours += 12) {
+        const at = wall + hours * 3_600_000;
+        offsets.add(localWall(at, zone) - at);
+    }
+    const candidates = [...offsets].map((offset) => wall - offset);
+    const exact = candidates.filter((at) => localWall(at, zone) === wall);
+    // A fold chooses the first instant. A gap advances by the offset gap, retaining minutes.
+    if (exact.length)
+        return Math.min(...exact);
+    return candidates
+        .filter((at) => localWall(at, zone) > wall)
+        .sort((a, b) => localWall(a, zone) - localWall(b, zone) || a - b)[0];
+}
+/** A tool's date/time is local to the deployment, never the host's Date parser. */
+export function localRoutineInstant(value, zone) {
+    const match = /^(\d{4})-(\d{2})-(\d{2})T((?:[01]\d|2[0-3]):[0-5]\d)$/.exec(value);
+    if (!match)
+        throw new Error('Invalid local date/time; use YYYY-MM-DDTHH:mm');
+    const [, year, month, date, time] = match;
+    const day = Date.UTC(Number(year), Number(month) - 1, Number(date));
+    if (new Date(day).toISOString().slice(0, 10) !== value.slice(0, 10))
+        throw new Error('Invalid local calendar date');
+    return new Date(occurrence(day, time, zone)).toISOString();
+}
+export function routineLocalTime(at, zone) {
+    return new Date(localWall(at, zone))
+        .toISOString()
+        .slice(0, 16)
+        .replace('T', ' ');
+}
+function matches(day, schedule) {
+    return (!schedule.days ||
+        schedule.days.includes(weekdays[new Date(day).getUTCDay()]));
+}
+export function nextOccurrence(schedule, after, zone) {
+    if ('at' in schedule) {
+        const at = Date.parse(schedule.at);
+        return at > after ? at : undefined;
+    }
+    const start = localDay(after, zone);
+    for (let i = 0; i <= 8; i++) {
+        const day = start + i * 86_400_000;
+        if (!matches(day, schedule))
+            continue;
+        const at = occurrence(day, schedule.time, zone);
+        if (at > after)
+            return at;
+    }
+}
+export function latestOccurrence(schedule, after, through, zone) {
+    if ('at' in schedule) {
+        const at = Date.parse(schedule.at);
+        return at > after && at <= through ? at : undefined;
+    }
+    const start = localDay(through, zone);
+    for (let i = 0; i <= 8; i++) {
+        const day = start - i * 86_400_000;
+        if (!matches(day, schedule))
+            continue;
+        const at = occurrence(day, schedule.time, zone);
+        if (at > after && at <= through)
+            return at;
+    }
+}
+//# sourceMappingURL=routine-time.js.map

package/dist/routine-time.js.map

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

package/dist/routines.d.ts

@@ -0,0 +1,126 @@
+import type { VelaLogger, VelaSession } from '@glows777/vela-core/extension-api';
+import { z } from 'zod';
+import type { ChannelDirectory } from './directory.ts';
+import type { ChannelDefinition, ChannelRoutine, ChannelRuntime, IncomingMessage } from './types.ts';
+/** Provider input must have an object root; the pipe retains strict operation validation. */
+export declare const routineToolSchema: z.ZodPipe<z.ZodObject<{
+    message: z.ZodOptional<z.ZodString>;
+    schedule: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        at: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        time: z.ZodString;
+        days: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            mon: "mon";
+            tue: "tue";
+            wed: "wed";
+            thu: "thu";
+            fri: "fri";
+            sat: "sat";
+            sun: "sun";
+        }>>>;
+    }, z.core.$strict>]>>;
+    action: z.ZodEnum<{
+        create: "create";
+        list: "list";
+        cancel: "cancel";
+    }>;
+    id: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"create">;
+    message: z.ZodString;
+    schedule: z.ZodUnion<readonly [z.ZodObject<{
+        at: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        time: z.ZodString;
+        days: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            mon: "mon";
+            tue: "tue";
+            wed: "wed";
+            thu: "thu";
+            fri: "fri";
+            sat: "sat";
+            sun: "sun";
+        }>>>;
+    }, z.core.$strict>]>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"list">;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"cancel">;
+    id: z.ZodString;
+}, z.core.$strict>], "action">>;
+export declare const channelRoutinesSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    routines: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        channel: z.ZodString;
+        chatId: z.ZodString;
+        targetKey: z.ZodString;
+        creator: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        message: z.ZodString;
+        schedule: z.ZodUnion<readonly [z.ZodObject<{
+            at: z.ZodISODateTime;
+        }, z.core.$strict>, z.ZodObject<{
+            time: z.ZodString;
+            days: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                mon: "mon";
+                tue: "tue";
+                wed: "wed";
+                thu: "thu";
+                fri: "fri";
+                sat: "sat";
+                sun: "sun";
+            }>>>;
+        }, z.core.$strict>]>;
+        createdAt: z.ZodISODateTime;
+        lastFiredAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export interface RoutineClock {
+    now(): number;
+    setTimeout(callback: () => void, delay: number): unknown;
+    clearTimeout(timer: unknown): void;
+}
+/** Channel-local persistence and wake-ups. Gateway queues own execution and recovery. */
+export declare class ChannelRoutines {
+    private directory;
+    private channel;
+    private enqueue;
+    private restored;
+    private logger;
+    clock: RoutineClock;
+    private records;
+    private writing;
+    private loaded?;
+    private zones;
+    private started;
+    private disabled;
+    private inFlight;
+    readonly active: Set<Promise<void>>;
+    private timer?;
+    private stopped;
+    private readonly path?;
+    constructor(dataDir: string | undefined, directory: ChannelDirectory, channel: (name: string) => ChannelDefinition | undefined, enqueue: (name: string, msg: IncomingMessage) => Promise<void>, restored: (key: string, name: string, msg: IncomingMessage) => Promise<VelaSession | undefined>, logger: VelaLogger);
+    load(channels: Iterable<ChannelDefinition>): Promise<void>;
+    private read;
+    start(name: string): void;
+    private change;
+    list(channel: string, chatId: string): ChannelRoutine[];
+    create(input: Omit<ChannelRoutine, 'id' | 'createdAt' | 'lastFiredAt'>): Promise<ChannelRoutine>;
+    cancel(channel: string, chatId: string, id: string): Promise<boolean>;
+    private describe;
+    private describeChat;
+    formatList(channel: string, chatId: string): string;
+    scoped(name: string, context: (id: string) => IncomingMessage | undefined): ChannelRuntime['routines'];
+    confirmed(msg: IncomingMessage): Promise<void>;
+    /** Re-align a committed session marker before submitting another scheduled input. */
+    shouldRun(msg: IncomingMessage, session: VelaSession): Promise<boolean>;
+    private tick;
+    private deliver;
+    private arm;
+    stop(): void;
+    drain(): Promise<void>;
+}
+//# sourceMappingURL=routines.d.ts.map

package/dist/routines.d.ts.map

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

package/dist/routines.js

@@ -0,0 +1,370 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { writeAtomicJson } from "./atomic-json.js";
+import { errorMessage } from "./log.js";
+import { latestOccurrence, localRoutineInstant, nextOccurrence, routineLocalTime, routineTimezone, } from "./routine-time.js";
+const instant = z.iso
+    .datetime()
+    .refine((value) => Number.isFinite(Date.parse(value)), 'Invalid instant');
+const recurringSchema = z
+    .object({
+    time: z.string().regex(/^(?:[01]\d|2[0-3]):[0-5]\d$/),
+    days: z
+        .array(z.enum(['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun']))
+        .min(1)
+        .optional(),
+})
+    .strict();
+const scheduleSchema = z.union([
+    z.object({ at: instant }).strict(),
+    recurringSchema,
+]);
+const createRoutineSchema = z
+    .object({
+    action: z.literal('create'),
+    message: z.string().trim().min(1),
+    schedule: z.union([z.object({ at: z.string() }).strict(), recurringSchema]),
+})
+    .strict();
+/** Provider input must have an object root; the pipe retains strict operation validation. */
+export const routineToolSchema = createRoutineSchema
+    .extend({
+    action: z.enum(['create', 'list', 'cancel']),
+    id: z.string().min(1).optional(),
+})
+    .partial({ message: true, schedule: true })
+    .pipe(z.discriminatedUnion('action', [
+    createRoutineSchema,
+    z.object({ action: z.literal('list') }).strict(),
+    z.object({ action: z.literal('cancel'), id: z.string().min(1) }).strict(),
+]));
+const routineSchema = z
+    .object({
+    id: z.string().min(1),
+    channel: z.string().min(1),
+    chatId: z.string().min(1),
+    targetKey: z.string().min(1),
+    creator: z.object({ id: z.string().min(1), name: z.string().min(1) }),
+    message: z.string().trim().min(1),
+    schedule: scheduleSchema,
+    createdAt: instant,
+    lastFiredAt: instant.nullable(),
+})
+    .strict();
+export const channelRoutinesSchema = z
+    .object({ version: z.literal(1), routines: z.array(routineSchema) })
+    .strict();
+/** Channel-local persistence and wake-ups. Gateway queues own execution and recovery. */
+export class ChannelRoutines {
+    directory;
+    channel;
+    enqueue;
+    restored;
+    logger;
+    clock = {
+        now: Date.now,
+        setTimeout: (callback, delay) => setTimeout(callback, delay),
+        clearTimeout: (timer) => clearTimeout(timer),
+    };
+    records = [];
+    writing = Promise.resolve();
+    loaded;
+    zones = new Map();
+    started = new Set();
+    disabled = new Set();
+    inFlight = new Map();
+    active = new Set();
+    timer;
+    stopped = true;
+    path;
+    constructor(dataDir, directory, channel, enqueue, restored, logger) {
+        this.directory = directory;
+        this.channel = channel;
+        this.enqueue = enqueue;
+        this.restored = restored;
+        this.logger = logger;
+        this.path = dataDir ? join(dataDir, 'channels', 'routines.json') : undefined;
+    }
+    async load(channels) {
+        for (const ch of channels)
+            this.zones.set(ch.name, routineTimezone(ch.timezone));
+        this.loaded ??= this.read();
+        await this.loaded;
+        this.started.clear();
+        this.disabled.clear();
+        this.stopped = false;
+    }
+    async read() {
+        if (!this.path)
+            return;
+        let text;
+        try {
+            text = await readFile(this.path, 'utf8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return;
+            throw new Error(`Cannot read channel routines ${this.path}`, {
+                cause: error,
+            });
+        }
+        try {
+            const data = channelRoutinesSchema.parse(JSON.parse(text));
+            if (new Set(data.routines.map((r) => r.id)).size !== data.routines.length)
+                throw new Error('Duplicate routine id');
+            this.records = data.routines;
+        }
+        catch (cause) {
+            throw new Error(`Invalid channel routines ${this.path}: ${String(cause)}`, { cause });
+        }
+    }
+    start(name) {
+        this.started.add(name);
+        this.tick(name);
+    }
+    change(update) {
+        const task = this.writing
+            .catch(() => { })
+            .then(async () => {
+            const next = update(this.records);
+            if (this.path)
+                await writeAtomicJson(this.path, { version: 1, routines: next });
+            this.records = next;
+        });
+        this.writing = task;
+        this.active.add(task);
+        void task.then(() => this.active.delete(task), () => this.active.delete(task));
+        return task;
+    }
+    list(channel, chatId) {
+        return structuredClone(this.records.filter((r) => r.channel === channel && r.chatId === chatId));
+    }
+    async create(input) {
+        const record = routineSchema.parse({
+            ...input,
+            id: crypto.randomUUID(),
+            createdAt: new Date(this.clock.now()).toISOString(),
+            lastFiredAt: null,
+        });
+        if (!nextOccurrence(record.schedule, this.clock.now(), this.zones.get(record.channel)))
+            throw new Error('A one-off routine must be in the future');
+        await this.change((records) => {
+            if (records.filter((r) => r.channel === record.channel && r.chatId === record.chatId).length >= 20)
+                throw new Error('This chat already has 20 routines');
+            return [...records, record];
+        });
+        this.arm();
+        return structuredClone(record);
+    }
+    async cancel(channel, chatId, id) {
+        let cancelled = false;
+        await this.change((records) => records.filter((r) => {
+            const matches = r.id === id && r.channel === channel && r.chatId === chatId;
+            if (matches)
+                cancelled = true;
+            return !matches;
+        }));
+        this.arm();
+        return cancelled;
+    }
+    describe(record) {
+        const timezone = this.zones.get(record.channel);
+        const target = this.directory.get(record.targetKey);
+        const next = nextOccurrence(record.schedule, this.clock.now(), timezone);
+        return {
+            ...structuredClone(record),
+            timezone,
+            scheduleText: 'at' in record.schedule
+                ? routineLocalTime(Date.parse(record.schedule.at), timezone)
+                : `${record.schedule.days?.join(',') ?? 'daily'} at ${record.schedule.time}`,
+            target: !target
+                ? 'Unavailable target'
+                : target.rootId
+                    ? `Topic: ${target.task}`
+                    : target.chatKind === 'group'
+                        ? 'Group channel'
+                        : 'Direct chat',
+            nextRun: next === undefined ? null : routineLocalTime(next, timezone),
+        };
+    }
+    describeChat(channel, chatId) {
+        return {
+            timezone: this.zones.get(channel),
+            routines: this.list(channel, chatId).map((r) => this.describe(r)),
+        };
+    }
+    formatList(channel, chatId) {
+        const { timezone, routines } = this.describeChat(channel, chatId);
+        return [
+            `Routines (${timezone})`,
+            ...routines.map((r) => `${r.id} | ${r.scheduleText} | ${r.target} | set by ${r.creator.name} | next: ${r.nextRun ?? 'no future occurrence'}`),
+            ...(routines.length ? [] : ['No routines in this chat.']),
+        ].join('\n');
+    }
+    scoped(name, context) {
+        const source = (id) => {
+            const msg = context(id);
+            const key = this.directory.keyForSession(id);
+            if (!msg || this.directory.sessionId(key) !== id)
+                throw new Error('Routines require an active channel run');
+            return { msg, key };
+        };
+        return {
+            create: async (id, message, schedule) => {
+                const { msg, key } = source(id);
+                const record = await this.create({
+                    channel: name,
+                    chatId: msg.channelId,
+                    targetKey: key,
+                    creator: { id: msg.senderId, name: msg.senderName },
+                    message,
+                    schedule: 'at' in schedule
+                        ? { at: localRoutineInstant(schedule.at, this.zones.get(name)) }
+                        : schedule,
+                });
+                return this.describe(record);
+            },
+            list: (id) => this.describeChat(name, source(id).msg.channelId),
+            cancel: (id, routineId) => this.cancel(name, source(id).msg.channelId, routineId),
+        };
+    }
+    async confirmed(msg) {
+        if (!msg.routine)
+            return;
+        const { id, scheduledAt } = msg.routine;
+        await this.change((records) => records.flatMap((r) => {
+            if (r.id !== id ||
+                r.channel !== this.directory.get(r.targetKey)?.channel ||
+                r.chatId !== msg.channelId ||
+                (r.lastFiredAt &&
+                    Date.parse(r.lastFiredAt) >= Date.parse(scheduledAt)))
+                return [r];
+            return 'at' in r.schedule ? [] : [{ ...r, lastFiredAt: scheduledAt }];
+        }));
+        this.arm();
+    }
+    /** Re-align a committed session marker before submitting another scheduled input. */
+    async shouldRun(msg, session) {
+        for (const entry of session.getEntries()) {
+            if (entry.type !== 'custom' || entry.customType !== 'channel.input')
+                continue;
+            const routine = entry.data
+                ?.routine;
+            if (routine?.id === msg.routine?.id)
+                await this.confirmed({ ...msg, routine });
+        }
+        const record = this.records.find((r) => r.id === msg.routine?.id);
+        return (!!record &&
+            (!record.lastFiredAt ||
+                Date.parse(record.lastFiredAt) < Date.parse(msg.routine.scheduledAt)));
+    }
+    tick(name) {
+        if (this.stopped)
+            return;
+        const now = this.clock.now();
+        for (const record of this.records) {
+            if ((name && name !== record.channel) ||
+                !this.started.has(record.channel) ||
+                (this.inFlight.has(record.id) &&
+                    Date.parse(record.lastFiredAt ?? record.createdAt) <
+                        this.inFlight.get(record.id)))
+                continue;
+            const at = latestOccurrence(record.schedule, Date.parse(record.lastFiredAt ?? record.createdAt), now, this.zones.get(record.channel));
+            if (at === undefined)
+                continue;
+            this.inFlight.set(record.id, at);
+            const task = this.deliver(record, at, !!name)
+                .catch((error) => {
+                this.logger.error(`[${record.channel}] Routine ${record.id} failed: ${errorMessage(error)}`);
+            })
+                .finally(() => {
+                if (this.inFlight.get(record.id) === at)
+                    this.inFlight.delete(record.id);
+                this.active.delete(task);
+                this.arm();
+            });
+            this.active.add(task);
+        }
+        this.arm();
+    }
+    async deliver(routine, at, startup) {
+        const record = this.directory.get(routine.targetKey);
+        const channel = this.channel(routine.channel);
+        if (!record ||
+            record.channel !== routine.channel ||
+            record.chatId !== routine.chatId ||
+            !channel) {
+            this.logger.warn(`[${routine.channel}] Routine ${routine.id} has no logical target`);
+            return;
+        }
+        const late = this.clock.now() - at;
+        let msg = {
+            channelId: routine.chatId,
+            senderId: routine.creator.id,
+            senderName: routine.creator.name,
+            text: `Scheduled wake-up ${routine.id}, set by ${routine.creator.name}, scheduled for ${new Date(at).toISOString()} (${this.zones.get(routine.channel)})${late > 0 ? `; late by ${Math.ceil(late / 1000)} seconds` : ''}:\n${routine.message}`,
+            routine: { id: routine.id, scheduledAt: new Date(at).toISOString() },
+            ...(record.rootId && record.threadId
+                ? {
+                    topic: { rootId: record.rootId, threadId: record.threadId },
+                    replyToId: record.rootId,
+                }
+                : {}),
+        };
+        if (channel.canRecover?.(msg, record.chatKind) === false) {
+            const chat = `${routine.channel}\0${routine.chatId}`;
+            if (!this.disabled.has(chat)) {
+                this.disabled.add(chat);
+                this.logger.info(`[${routine.channel}] Routine skipped: chat is disabled`);
+            }
+            return;
+        }
+        if (this.stopped || !this.records.some((r) => r.id === routine.id))
+            return;
+        if (startup) {
+            // Recovery owns the key first. Reconcile saved inputs before announcing a catch-up.
+            const session = await this.restored(routine.targetKey, routine.channel, msg);
+            if (!session || !(await this.shouldRun(msg, session)) || this.stopped)
+                return;
+        }
+        if (channel.prepareRoutine) {
+            const prepared = await channel.prepareRoutine(msg, record.chatKind, {
+                message: routine.message,
+                lateByMs: late,
+            });
+            if (!prepared)
+                return;
+            msg = prepared;
+        }
+        if (!this.stopped)
+            await this.enqueue(routine.channel, msg);
+    }
+    arm() {
+        this.clock.clearTimeout(this.timer);
+        this.timer = undefined;
+        if (this.stopped)
+            return;
+        const now = this.clock.now();
+        const times = this.records.flatMap((r) => {
+            if (!this.started.has(r.channel))
+                return [];
+            const next = nextOccurrence(r.schedule, Math.max(now, Date.parse(r.lastFiredAt ?? r.createdAt)), this.zones.get(r.channel));
+            return next === undefined ? [] : [next];
+        });
+        if (!times.length)
+            return;
+        this.timer = this.clock.setTimeout(() => this.tick(), Math.min(2_147_483_647, Math.max(0, Math.min(...times) - now)));
+    }
+    stop() {
+        this.stopped = true;
+        this.clock.clearTimeout(this.timer);
+        this.timer = undefined;
+    }
+    async drain() {
+        while (this.active.size)
+            await Promise.all([...this.active]);
+        await this.writing;
+    }
+}
+//# sourceMappingURL=routines.js.map