@jini-ai/daemon 0.1.0

package/dist/routines/schedule.js

@@ -0,0 +1,263 @@
+// ---------- timezone math ----------
+/**
+ * Returns the wall-clock parts of `atUtc` rendered in `timezone`. Uses `Intl.DateTimeFormat`. If
+ * the timezone is invalid the formatter throws — callers catch upstream.
+ *
+ * Exported for the same reason as {@link tzWallToUtcCandidates}/{@link tzWallToUtcGapFallback}:
+ * its two defensive fallbacks (an Intl-reported hour of `"24"` at local midnight in some
+ * locale/zone combinations, and an unrecognized weekday abbreviation) are ICU-implementation
+ * edge cases no timezone on this test runner's ICU data naturally triggers — directly testable
+ * with a mocked `Intl.DateTimeFormat.prototype.formatToParts` instead of left unreachable.
+ */
+export function partsInTimezone(timezone, atUtc) {
+    const dtf = new Intl.DateTimeFormat('en-US', {
+        timeZone: timezone,
+        hour12: false,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        weekday: 'short',
+    });
+    const parts = dtf.formatToParts(atUtc);
+    const get = (type) => parts.find((p) => p.type === type)?.value ?? '0';
+    const weekdayStr = get('weekday');
+    const weekdayMap = {
+        Sun: 0,
+        Mon: 1,
+        Tue: 2,
+        Wed: 3,
+        Thu: 4,
+        Fri: 5,
+        Sat: 6,
+    };
+    let h = Number(get('hour'));
+    // Intl emits "24" at midnight in some locales/zones; normalize to 0.
+    if (h === 24)
+        h = 0;
+    return {
+        year: Number(get('year')),
+        month: Number(get('month')),
+        day: Number(get('day')),
+        hour: h,
+        minute: Number(get('minute')),
+        second: Number(get('second')),
+        weekday: weekdayMap[weekdayStr] ?? 0,
+    };
+}
+/**
+ * Returns every UTC instant at which the wall clock in `timezone` reads the requested Y-M-D h:m,
+ * sorted ascending. Most days have exactly one match. On a fall-back transition day the requested
+ * time inside the repeated hour has two matches (one before the transition, one after); outside
+ * that hour it still has one. On a spring-forward gap the requested time inside the gap has zero
+ * matches — callers fall back to {@link tzWallToUtcGapFallback} to land on a post-gap instant the
+ * same day. Probes offsets at three reference points across the day so that both pre- and
+ * post-transition offsets are sampled regardless of which side of the transition `tentative`
+ * happens to land on. Returns `[]` if `timezone` is invalid.
+ *
+ * Exported (unlike this module's other low-level helpers) so its own `catch` branch is directly
+ * unit-testable: {@link nextWallTimeMatching}, this function's only real caller, already calls
+ * the unguarded `partsInTimezone` earlier in its own loop body, so an invalid timezone throws
+ * there first — this function's defensive catch is otherwise unreachable through that call path.
+ */
+export function tzWallToUtcCandidates(timezone, year, month, day, hour, minute) {
+    try {
+        const tentative = Date.UTC(year, month - 1, day, hour, minute, 0);
+        const probeOffsetsMs = [-12, 0, 12].map((h) => h * 60 * 60_000);
+        const seen = new Set();
+        const out = [];
+        for (const dms of probeOffsetsMs) {
+            const off = tzOffsetMinutes(timezone, new Date(tentative + dms));
+            const cand = new Date(tentative - off * 60_000);
+            const t = cand.getTime();
+            if (seen.has(t))
+                continue;
+            if (matchesWallClock(timezone, cand, year, month, day, hour, minute)) {
+                seen.add(t);
+                out.push(cand);
+            }
+        }
+        return out.sort((a, b) => a.getTime() - b.getTime());
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Spring-forward gap fallback: when the requested wall time doesn't exist in `timezone` on this
+ * day (clocks jumped over it), return the later of the two probe candidates. That instant has
+ * crossed the transition and renders as the first valid post-gap wall time, so a routine still
+ * fires today instead of firing an hour early before the gap. Returns `null` if `timezone` is
+ * invalid.
+ *
+ * Exported for the same reason as {@link tzWallToUtcCandidates} — its own `catch` branch is
+ * otherwise unreachable through {@link nextWallTimeMatching}'s call path.
+ */
+export function tzWallToUtcGapFallback(timezone, year, month, day, hour, minute) {
+    try {
+        const tentative = Date.UTC(year, month - 1, day, hour, minute, 0);
+        const t1 = tzOffsetMinutes(timezone, new Date(tentative));
+        const candidate1 = new Date(tentative - t1 * 60_000);
+        const t2 = tzOffsetMinutes(timezone, candidate1);
+        const candidate2 = new Date(tentative - t2 * 60_000);
+        return candidate1.getTime() > candidate2.getTime() ? candidate1 : candidate2;
+    }
+    catch {
+        return null;
+    }
+}
+function matchesWallClock(timezone, at, year, month, day, hour, minute) {
+    const p = partsInTimezone(timezone, at);
+    return p.year === year && p.month === month && p.day === day && p.hour === hour && p.minute === minute;
+}
+/** Minutes east of UTC for `timezone` at instant `at`. e.g. Asia/Shanghai returns 480. */
+function tzOffsetMinutes(timezone, at) {
+    const p = partsInTimezone(timezone, at);
+    const asIfUtc = Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute, p.second);
+    return Math.round((asIfUtc - at.getTime()) / 60_000);
+}
+// ---------- next-fire calculation ----------
+export function nextHourlyRunAt(minute, now = new Date()) {
+    const next = new Date(now);
+    next.setSeconds(0, 0);
+    next.setMinutes(minute);
+    if (next.getTime() <= now.getTime()) {
+        next.setHours(next.getHours() + 1);
+    }
+    return next;
+}
+/**
+ * Returns the next instant at which the wall-clock in `timezone` reads "HH:MM" on a day where
+ * `predicate(weekday)` holds. Walks forward at most 14 calendar days as a safety bound (covers
+ * any weekday-based pattern). Exported (unlike this module's other internal helpers) so its
+ * 14-day-exhaustion fallback is directly unit-testable: every `predicate` `nextRunAtForSchedule`
+ * actually passes (daily/weekdays/weekly) structurally guarantees a match within 7 days, making
+ * that branch otherwise unreachable through the public schedule-kind API alone.
+ */
+export function nextWallTimeMatching(timezone, time, predicate, now) {
+    const m = /^(\d{2}):(\d{2})$/.exec(time);
+    if (!m)
+        return null;
+    const hour = Number(m[1]);
+    const minute = Number(m[2]);
+    if (!Number.isFinite(hour) || hour < 0 || hour > 23)
+        return null;
+    if (!Number.isFinite(minute) || minute < 0 || minute > 59)
+        return null;
+    // Walk day by day in the target timezone.
+    for (let offset = 0; offset < 14; offset += 1) {
+        const probe = new Date(now.getTime() + offset * 24 * 60 * 60_000);
+        const parts = partsInTimezone(timezone, probe);
+        if (!predicate(parts.weekday))
+            continue;
+        const candidates = tzWallToUtcCandidates(timezone, parts.year, parts.month, parts.day, hour, minute);
+        if (candidates.length === 0) {
+            // Spring-forward gap: no valid wall instant exists today; pick the synthesized post-gap
+            // fallback so the routine still fires today.
+            const fallback = tzWallToUtcGapFallback(timezone, parts.year, parts.month, parts.day, hour, minute);
+            // Null-safety guard against tzWallToUtcGapFallback's `Date | null` return type (it returns
+            // null only for an invalid timezone). Structurally unreachable from THIS call site: the
+            // unguarded `partsInTimezone(timezone, probe)` two lines above already succeeded for this
+            // exact `timezone` earlier in this same loop iteration, which proves it valid before
+            // `tzWallToUtcGapFallback` (guarding the identical Intl call) is ever reached — so this
+            // branch cannot be exercised without bypassing that invariant. Kept rather than removed:
+            // the guard is still correct defensive programming against the function's real signature,
+            // and `tzWallToUtcGapFallback`'s own null path is independently covered by a direct test
+            // (see schedule.test.ts) against an invalid timezone.
+            if (!fallback)
+                return null;
+            if (fallback.getTime() > now.getTime())
+                return fallback;
+            continue;
+        }
+        // Iterate candidates in ascending order so that on a fall-back overlap day, when `now`
+        // already passed the first occurrence (EDT), we still pick the second one (EST) before
+        // walking to the next day.
+        for (const candidate of candidates) {
+            if (candidate.getTime() > now.getTime())
+                return candidate;
+        }
+    }
+    return null;
+}
+export function nextRunAtForSchedule(schedule, now = new Date()) {
+    if (schedule.kind === 'hourly') {
+        return nextHourlyRunAt(schedule.minute, now);
+    }
+    if (schedule.kind === 'daily') {
+        return nextWallTimeMatching(schedule.timezone, schedule.time, () => true, now);
+    }
+    if (schedule.kind === 'weekdays') {
+        // Mon=1 .. Fri=5
+        return nextWallTimeMatching(schedule.timezone, schedule.time, (w) => w >= 1 && w <= 5, now);
+    }
+    if (schedule.kind === 'weekly') {
+        return nextWallTimeMatching(schedule.timezone, schedule.time, (w) => w === schedule.weekday, now);
+    }
+    return null;
+}
+// ---------- validation ----------
+export function isValidWallTime(time) {
+    const m = /^(\d{2}):(\d{2})$/.exec(time);
+    if (!m)
+        return false;
+    const h = Number(m[1]);
+    const mm = Number(m[2]);
+    return h >= 0 && h <= 23 && mm >= 0 && mm <= 59;
+}
+export function isValidTimezone(tz) {
+    if (!tz || typeof tz !== 'string')
+        return false;
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone: tz });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function validateSchedule(schedule) {
+    if (!schedule || typeof schedule !== 'object') {
+        throw new Error('schedule is required');
+    }
+    if (schedule.kind === 'hourly') {
+        const m = schedule.minute;
+        if (!Number.isInteger(m) || m < 0 || m > 59) {
+            throw new Error('hourly.minute must be an integer 0-59');
+        }
+        return;
+    }
+    if (schedule.kind === 'daily' || schedule.kind === 'weekdays' || schedule.kind === 'weekly') {
+        if (!isValidWallTime(schedule.time)) {
+            throw new Error(`Invalid time: ${schedule.time}`);
+        }
+        if (!isValidTimezone(schedule.timezone)) {
+            throw new Error(`Invalid timezone: ${schedule.timezone}`);
+        }
+        if (schedule.kind === 'weekly') {
+            const w = schedule.weekday;
+            if (!Number.isInteger(w) || w < 0 || w > 6) {
+                throw new Error('weekly.weekday must be 0-6');
+            }
+        }
+        return;
+    }
+    throw new Error(`Unsupported schedule kind: ${schedule.kind}`);
+}
+export function validateTarget(target) {
+    if (!target || typeof target !== 'object') {
+        throw new Error('target is required');
+    }
+    if (target.mode === 'create_each_run')
+        return;
+    if (target.mode === 'reuse') {
+        if (!target.projectId || typeof target.projectId !== 'string') {
+            throw new Error('Reuse target requires a projectId');
+        }
+        return;
+    }
+    throw new Error(`Unsupported routine target mode: ${target.mode}`);
+}
+//# sourceMappingURL=schedule.js.map

package/dist/routines/schedule.js.map

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

package/dist/routines/scheduler.d.ts

@@ -0,0 +1,34 @@
+import type { RoutinePersistence, RoutineRunHandler, RoutineRunHandlerStart } from './types.js';
+/**
+ * Distinguishes "a sibling daemon already won this scheduled slot, or the durable write itself
+ * failed" from every other run-handler failure, so the scheduler can retry the same slot instead
+ * of silently advancing to the next cadence (which would skip a fire the caller never actually
+ * got).
+ */
+export declare class ScheduledRunPersistenceError extends Error {
+    readonly routineId: string;
+    readonly slotAt: number;
+    readonly originalError: unknown;
+    constructor(routineId: string, slotAt: number, originalError: unknown);
+}
+export declare class RoutineService {
+    private readonly persistence;
+    private timers;
+    private inflight;
+    private runHandler;
+    private started;
+    constructor(persistence: RoutinePersistence);
+    setRunHandler(handler: RoutineRunHandler): void;
+    start(): void;
+    stop(): void;
+    rescheduleAll(): void;
+    rescheduleOne(routineId: string): void;
+    unschedule(routineId: string): void;
+    private scheduleRoutine;
+    private retryScheduledSlot;
+    private scheduleRoutineAt;
+    nextRunAt(routineId: string): Date | null;
+    runNow(routineId: string): Promise<RoutineRunHandlerStart>;
+    private start_;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/routines/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/routines/scheduler.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAEV,kBAAkB,EAElB,iBAAiB,EACjB,sBAAsB,EAEvB,MAAM,YAAY,CAAC;AAYpB;;;;;GAKG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IAEnD,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,aAAa,EAAE,OAAO;gBAFtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,OAAO;CAKlC;AAMD,qBAAa,cAAc;IAMb,OAAO,CAAC,QAAQ,CAAC,WAAW;IALxC,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,QAAQ,CAAsD;IACtE,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,OAAO,CAAS;gBAEK,WAAW,EAAE,kBAAkB;IAE5D,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAI/C,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI;IAMZ,aAAa,IAAI,IAAI;IASrB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAWtC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQnC,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,iBAAiB;IAmCzB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAInC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;YAIlD,MAAM;CA4KrB"}

package/dist/routines/scheduler.js

@@ -0,0 +1,330 @@
+/**
+ * `RoutineService` — a multi-routine scheduler: a list of user-defined routines, each with its
+ * own schedule, that fires a host-registered run handler. Schedule kinds covered: hourly (every
+ * hour at minute M), daily (HH:MM in timezone), weekdays (Mon-Fri at HH:MM in timezone), weekly
+ * (one weekday at HH:MM in timezone) — see {@link ./schedule.js} for the DST-safe wall-clock math
+ * behind `nextRunAtForSchedule`. The run handler is host-owned: it is responsible for whatever
+ * "firing a routine" means to a given consumer (project/conversation creation and dispatch into a
+ * chat run, for OD) — this engine has no opinion on that, matching `RunLifecycle`'s existing
+ * precedent for a kernel-owned, storage-injected service with a host-supplied driver.
+ *
+ * Ported from OD's `apps/daemon/src/routines.ts` (726 lines) per the porting proposal
+ * (`ADS-memory/reports/proposals/PROP-http-route-packs-automation-routines-2026-07-21.md`,
+ * Finding 2): "a genuinely clean, already-portable generic scheduling engine... ready to port
+ * today as its own small, well-scoped task." Its only import was `node:crypto`'s `randomUUID`
+ * (unchanged here); its `Routine`/`RoutineSchedule` types were already a documented local mirror,
+ * not a product coupling (now `./types.js`); its `RoutinePersistence` injected port and
+ * `RoutineRunHandler` callback are unchanged (see `./types.js`'s doc comments for why
+ * `RoutinePersistence` deliberately stays synchronous rather than converted to this package's
+ * usual async-port convention). Logic is otherwise unchanged from the OD source — this is a
+ * faithful port, not a redesign, per the proposal's own warning against "casually reinventing"
+ * the race-safe scheduled-slot claim below.
+ */
+import { randomUUID } from 'node:crypto';
+import { nextRunAtForSchedule } from './schedule.js';
+function clearRoutinePlaceholderId(value) {
+    return value.startsWith('routine-pending-') ? '' : value;
+}
+/**
+ * Distinguishes "a sibling daemon already won this scheduled slot, or the durable write itself
+ * failed" from every other run-handler failure, so the scheduler can retry the same slot instead
+ * of silently advancing to the next cadence (which would skip a fire the caller never actually
+ * got).
+ */
+export class ScheduledRunPersistenceError extends Error {
+    routineId;
+    slotAt;
+    originalError;
+    constructor(routineId, slotAt, originalError) {
+        super(`Routine ${routineId} scheduled slot ${slotAt} could not be persisted`);
+        this.routineId = routineId;
+        this.slotAt = slotAt;
+        this.originalError = originalError;
+        this.name = 'ScheduledRunPersistenceError';
+    }
+}
+function isScheduledRunPersistenceError(error) {
+    return error instanceof ScheduledRunPersistenceError;
+}
+export class RoutineService {
+    persistence;
+    timers = new Map();
+    inflight = new Map();
+    runHandler = null;
+    started = false;
+    constructor(persistence) {
+        this.persistence = persistence;
+    }
+    setRunHandler(handler) {
+        this.runHandler = handler;
+    }
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        this.rescheduleAll();
+    }
+    stop() {
+        for (const entry of this.timers.values())
+            clearTimeout(entry.timer);
+        this.timers.clear();
+        this.started = false;
+    }
+    rescheduleAll() {
+        for (const entry of this.timers.values())
+            clearTimeout(entry.timer);
+        this.timers.clear();
+        if (!this.started)
+            return;
+        for (const routine of this.persistence.list()) {
+            this.scheduleRoutine(routine);
+        }
+    }
+    rescheduleOne(routineId) {
+        const existing = this.timers.get(routineId);
+        if (existing) {
+            clearTimeout(existing.timer);
+            this.timers.delete(routineId);
+        }
+        if (!this.started)
+            return;
+        const routine = this.persistence.list().find((r) => r.id === routineId);
+        if (routine)
+            this.scheduleRoutine(routine);
+    }
+    unschedule(routineId) {
+        const existing = this.timers.get(routineId);
+        if (existing) {
+            clearTimeout(existing.timer);
+            this.timers.delete(routineId);
+        }
+    }
+    scheduleRoutine(routine) {
+        if (!routine.enabled)
+            return;
+        const fireAt = nextRunAtForSchedule(routine.schedule);
+        if (!fireAt)
+            return;
+        this.scheduleRoutineAt(routine, fireAt);
+    }
+    retryScheduledSlot(routineId, fireAt) {
+        if (!this.started)
+            return;
+        const routine = this.persistence.list().find((candidate) => candidate.id === routineId);
+        if (!routine?.enabled)
+            return;
+        this.scheduleRoutineAt(routine, fireAt);
+    }
+    scheduleRoutineAt(routine, fireAt) {
+        // setTimeout can't carry past 2^31 ms (~24.8 days); we cap and use a chained re-schedule.
+        // Routines fire within hours/days, but a misconfigured "next month" weekly value could
+        // otherwise overflow.
+        const delay = Math.max(1_000, Math.min(2_000_000_000, fireAt.getTime() - Date.now()));
+        const timer = setTimeout(() => {
+            this.timers.delete(routine.id);
+            const slotAt = fireAt.getTime();
+            this.start_(routine.id, 'scheduled', { scheduledSlotAt: slotAt })
+                .then(() => {
+                // Always reschedule so a single fire keeps the cadence alive.
+                this.rescheduleOne(routine.id);
+            })
+                .catch((error) => {
+                console.error(`[@jini-ai/daemon] routine ${routine.id} scheduled run failed:`, error instanceof ScheduledRunPersistenceError
+                    ? error.originalError instanceof Error
+                        ? error.originalError.message
+                        : error.originalError
+                    : error instanceof Error
+                        ? error.message
+                        : error);
+                if (isScheduledRunPersistenceError(error)) {
+                    this.retryScheduledSlot(routine.id, fireAt);
+                }
+                else {
+                    this.rescheduleOne(routine.id);
+                }
+            });
+        }, delay);
+        if (typeof timer.unref === 'function')
+            timer.unref();
+        this.timers.set(routine.id, { routineId: routine.id, timer, fireAt });
+    }
+    nextRunAt(routineId) {
+        return this.timers.get(routineId)?.fireAt ?? null;
+    }
+    async runNow(routineId) {
+        return this.start_(routineId, 'manual');
+    }
+    async start_(routineId, trigger, options = {}) {
+        if (!this.runHandler)
+            throw new Error('Routine run handler is not configured');
+        const inflight = this.inflight.get(routineId);
+        if (inflight)
+            return inflight;
+        const routine = this.persistence.list().find((r) => r.id === routineId);
+        if (!routine)
+            throw new Error(`Routine ${routineId} not found`);
+        const startedAt = Date.now();
+        const runId = `routine-run-${randomUUID()}`;
+        const promise = (async () => {
+            const handler = this.runHandler;
+            if (!handler)
+                throw new Error('Routine run handler is not configured');
+            const handlerStart = await handler({ routine, trigger, startedAt, runId });
+            const run = {
+                id: runId,
+                routineId: routine.id,
+                trigger,
+                status: 'running',
+                projectId: handlerStart.projectId,
+                conversationId: handlerStart.conversationId,
+                agentRunId: handlerStart.agentRunId,
+                startedAt,
+                completedAt: null,
+                summary: null,
+                error: null,
+                errorCode: null,
+            };
+            const scheduledSlotAt = options.scheduledSlotAt;
+            const wasScheduled = scheduledSlotAt != null;
+            const publicProjectId = () => clearRoutinePlaceholderId(run.projectId);
+            const publicConversationId = () => clearRoutinePlaceholderId(run.conversationId);
+            const publicAgentRunId = () => clearRoutinePlaceholderId(run.agentRunId);
+            const scrubRoutinePlaceholders = () => {
+                run.projectId = publicProjectId();
+                run.conversationId = publicConversationId();
+                run.agentRunId = publicAgentRunId();
+            };
+            // Tear-down to use when the durable routine_run row was never inserted (insertRun threw, or
+            // another daemon already won the slot). Prefer the explicit `discardUnstarted` callback
+            // when the handler distinguishes the two cases — that one drops the in-memory chat run
+            // entirely instead of finalizing it as `canceled`, so duplicate scheduled losers do not
+            // surface phantom runs on a run listing. Handlers that do not implement the split still see
+            // `discard`.
+            const discardUnstarted = handlerStart.discardUnstarted ?? handlerStart.discard;
+            let inserted = true;
+            try {
+                inserted = this.persistence.insertRun(run, options) !== false;
+            }
+            catch (error) {
+                try {
+                    discardUnstarted?.();
+                }
+                catch (discardError) {
+                    if (wasScheduled) {
+                        throw new ScheduledRunPersistenceError(routine.id, scheduledSlotAt, discardError);
+                    }
+                    throw discardError;
+                }
+                if (wasScheduled) {
+                    throw new ScheduledRunPersistenceError(routine.id, scheduledSlotAt, error);
+                }
+                throw error;
+            }
+            if (!inserted) {
+                try {
+                    discardUnstarted?.();
+                }
+                catch (discardError) {
+                    if (wasScheduled) {
+                        throw new ScheduledRunPersistenceError(routine.id, scheduledSlotAt, discardError);
+                    }
+                    throw discardError;
+                }
+                return handlerStart;
+            }
+            try {
+                await handlerStart.prepare?.(run);
+                const preparedIdsChanged = run.projectId !== handlerStart.projectId
+                    || run.conversationId !== handlerStart.conversationId
+                    || run.agentRunId !== handlerStart.agentRunId;
+                handlerStart.projectId = run.projectId;
+                handlerStart.conversationId = run.conversationId;
+                handlerStart.agentRunId = run.agentRunId;
+                if (wasScheduled || preparedIdsChanged) {
+                    this.persistence.updateRun(runId, {
+                        projectId: run.projectId,
+                        conversationId: run.conversationId,
+                        agentRunId: run.agentRunId,
+                    });
+                }
+            }
+            catch (error) {
+                // Terminate the in-memory chat run created by `handler(...)` so its `completion` promise
+                // resolves instead of waiting forever on a run that will never start. Surface any cleanup
+                // failure rather than swallow it, but still finalize the persisted row.
+                let discardError = null;
+                try {
+                    handlerStart.discard?.();
+                }
+                catch (err) {
+                    discardError = err;
+                }
+                if (discardError != null) {
+                    console.error(`[@jini-ai/daemon] routine ${routine.id} prepare cleanup failed:`, discardError instanceof Error ? discardError.message : discardError);
+                }
+                // Persist IDs only after `prepare()` has replaced routine placeholders with real
+                // resources. If preparation failed before enrichment, clear the sentinels so the terminal
+                // row does not point at fabricated project/conversation IDs. For scheduled runs the slot
+                // claim was already accepted at `insertRun()`, so retrying the same slot is not
+                // appropriate — let the error propagate so the scheduler advances to the next cadence.
+                scrubRoutinePlaceholders();
+                this.persistence.updateRun(runId, {
+                    status: 'failed',
+                    completedAt: Date.now(),
+                    summary: null,
+                    error: error instanceof Error ? error.message : String(error),
+                    errorCode: null,
+                    projectId: run.projectId,
+                    conversationId: run.conversationId,
+                    agentRunId: run.agentRunId,
+                });
+                throw error;
+            }
+            handlerStart.completion
+                .then((completion) => {
+                this.persistence.updateRun(runId, {
+                    status: completion.status,
+                    completedAt: Date.now(),
+                    summary: completion.summary ?? null,
+                    error: completion.error ?? null,
+                    errorCode: completion.errorCode ?? null,
+                });
+            })
+                .catch((error) => {
+                this.persistence.updateRun(runId, {
+                    status: 'failed',
+                    completedAt: Date.now(),
+                    summary: null,
+                    error: error instanceof Error ? error.message : String(error),
+                    errorCode: null,
+                });
+            });
+            try {
+                handlerStart.start?.();
+            }
+            catch (error) {
+                this.persistence.updateRun(runId, {
+                    status: 'failed',
+                    completedAt: Date.now(),
+                    summary: null,
+                    error: error instanceof Error ? error.message : String(error),
+                    errorCode: null,
+                });
+                throw error;
+            }
+            return handlerStart;
+        })();
+        this.inflight.set(routineId, promise);
+        // The trailing `finally(...)` returns a new promise that mirrors the original rejection;
+        // without `.catch` it would surface as an unhandled rejection (fatal in modern Node) when the
+        // handler rejects before producing a start handle. The original `promise` is still returned
+        // to callers, who handle the rejection there.
+        promise
+            .finally(() => {
+            this.inflight.delete(routineId);
+        })
+            .catch(() => { });
+        return promise;
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/routines/scheduler.js.map

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