@aitne/daemon 0.1.0

package/dist/core/schedule-maintenance.d.ts

@@ -0,0 +1,22 @@
+import type Database from "better-sqlite3";
+export interface OrphanedRunningRecoveryResult {
+    skipped: number;
+    failed: number;
+}
+/**
+ * Discard pending tasks that belong to a previous agent day.
+ *
+ * The user explicitly prefers stale notifications / wake tasks to be dropped
+ * rather than replayed after downtime.
+ */
+export declare function discardStalePendingSchedules(db: Database.Database, currentAgentDayStartUtc: string): number;
+/**
+ * Resolve orphaned running tasks after a crash without replaying them.
+ *
+ * Replaying a mid-flight task can duplicate side effects (DM sends, external
+ * writes). Current-agent-day rows become failed for visibility; older rows are
+ * skipped as stale.
+ */
+export declare function recoverOrphanedRunningSchedules(db: Database.Database, currentAgentDayStartUtc: string): OrphanedRunningRecoveryResult;
+export declare function hasActionInWindow(db: Database.Database, actionType: string, startUtc: string, endUtc: string): boolean;
+//# sourceMappingURL=schedule-maintenance.d.ts.map

package/dist/core/schedule-maintenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-maintenance.d.ts","sourceRoot":"","sources":["../../src/core/schedule-maintenance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,uBAAuB,EAAE,MAAM,GAC9B,MAAM,CAWR;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,uBAAuB,EAAE,MAAM,GAC9B,6BAA6B,CA4B/B;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAaT"}

package/dist/core/schedule-maintenance.js

@@ -0,0 +1,57 @@
+import { createLogger } from "../logging.js";
+const logger = createLogger("schedule-maintenance");
+/**
+ * Discard pending tasks that belong to a previous agent day.
+ *
+ * The user explicitly prefers stale notifications / wake tasks to be dropped
+ * rather than replayed after downtime.
+ */
+export function discardStalePendingSchedules(db, currentAgentDayStartUtc) {
+    const result = db
+        .prepare(`UPDATE agent_schedule
+          SET status = 'skipped'
+        WHERE status = 'pending'
+          AND scheduled_for < ?`)
+        .run(currentAgentDayStartUtc);
+    return result.changes;
+}
+/**
+ * Resolve orphaned running tasks after a crash without replaying them.
+ *
+ * Replaying a mid-flight task can duplicate side effects (DM sends, external
+ * writes). Current-agent-day rows become failed for visibility; older rows are
+ * skipped as stale.
+ */
+export function recoverOrphanedRunningSchedules(db, currentAgentDayStartUtc) {
+    const skipResult = db
+        .prepare(`UPDATE agent_schedule
+          SET status = 'skipped'
+        WHERE status = 'running'
+          AND scheduled_for < ?`)
+        .run(currentAgentDayStartUtc);
+    const failResult = db
+        .prepare(`UPDATE agent_schedule
+          SET status = 'failed'
+        WHERE status = 'running'`)
+        .run();
+    const result = {
+        skipped: skipResult.changes,
+        failed: failResult.changes,
+    };
+    if (result.skipped > 0 || result.failed > 0) {
+        logger.info(result, "Recovered orphaned running schedules");
+    }
+    return result;
+}
+export function hasActionInWindow(db, actionType, startUtc, endUtc) {
+    const row = db
+        .prepare(`SELECT 1 AS seen
+         FROM agent_actions
+        WHERE action_type = ?
+          AND started_at >= ?
+          AND started_at < ?
+        LIMIT 1`)
+        .get(actionType, startUtc, endUtc);
+    return !!row;
+}
+//# sourceMappingURL=schedule-maintenance.js.map

package/dist/core/schedule-maintenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-maintenance.js","sourceRoot":"","sources":["../../src/core/schedule-maintenance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,MAAM,GAAG,YAAY,CAAC,sBAAsB,CAAC,CAAC;AAOpD;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,EAAqB,EACrB,uBAA+B;IAE/B,MAAM,MAAM,GAAG,EAAE;SACd,OAAO,CACN;;;gCAG0B,CAC3B;SACA,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAEhC,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,+BAA+B,CAC7C,EAAqB,EACrB,uBAA+B;IAE/B,MAAM,UAAU,GAAG,EAAE;SAClB,OAAO,CACN;;;gCAG0B,CAC3B;SACA,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAEhC,MAAM,UAAU,GAAG,EAAE;SAClB,OAAO,CACN;;iCAE2B,CAC5B;SACA,GAAG,EAAE,CAAC;IAET,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,MAAM,EAAE,UAAU,CAAC,OAAO;KAC3B,CAAC;IAEF,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,sCAAsC,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,EAAqB,EACrB,UAAkB,EAClB,QAAgB,EAChB,MAAc;IAEd,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CACN;;;;;gBAKU,CACX;SACA,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAiC,CAAC;IAErE,OAAO,CAAC,CAAC,GAAG,CAAC;AACf,CAAC"}

package/dist/core/scheduler.d.ts

@@ -0,0 +1,208 @@
+import type Database from "better-sqlite3";
+import type { AgentConfig } from "../config.js";
+import type { EventBus } from "./event-bus.js";
+import type { MessageDelivery } from "../adapters/message-hub.js";
+/**
+ * Build the cron expression that drives the hourly check.
+ *
+ * Two regimes:
+ *
+ * 1. **Divisor of 60** (`isDivisorOfHour(intervalMinutes)`, e.g. 1, 5, 15,
+ *    20, 30, 60): the firing minutes are predictable within every hour, so
+ *    we emit an exact minute list (`"0,15,30,45 4-23 * * *"`). The cron
+ *    only wakes on the actual firing minutes — no in-callback gating
+ *    needed.
+ *
+ * 2. **Arbitrary interval** (anything else, e.g. 7, 45, 90, 120, 720,
+ *    1440): we emit `"* <hourRange> * * *"` (every minute within active
+ *    hours). The caller is expected to gate each tick with
+ *    `shouldFireHourlyTickAt(...)`, which anchors the cadence to
+ *    `activeStartHour` via `((h*60 + m) - activeStartHour*60) %
+ *    intervalMinutes`. This anchor matters: a midnight-anchored modulo
+ *    plus `activeStartHour > 0` would silently drop intervals where the
+ *    only mod-zero point falls outside active hours (e.g. interval=1440
+ *    with startHour=4 — mod-zero only at 00:00, never inside the window).
+ *    Anchoring at `activeStartHour` guarantees the first fire of each
+ *    agent-day lands at the start of the window, then every N minutes
+ *    until the window closes.
+ *
+ * The minute-tick cron does fire 60× per hour even when most ticks are
+ * no-ops, but the callback's first action is the modulo check — overhead
+ * is negligible compared to the actual hourly-check work.
+ */
+export declare function buildHourlyCronExpr(intervalMinutes: number, startHour: number, endHourExclusive: number): string;
+/**
+ * Returns true when a minute-tick of the hourly cron should actually fire.
+ *
+ * Only meaningful for arbitrary (non-divisor-of-60) intervals — divisor
+ * cases get exact firing minutes baked into the cron expression and don't
+ * need this gate (handled by the early-return).
+ *
+ * The cadence is anchored at `activeStartHour` so the first slot of each
+ * agent-day lies at the start of the active window. This is what allows
+ * intervals up to 1440 (24h) to work correctly: a midnight anchor would
+ * make `interval=1440` fire only at 00:00, which is excluded by typical
+ * active-hour configs (4–24) and the day-boundary skip.
+ *
+ * Note: divisor-of-60 intervals always also divide `activeStartHour*60`
+ * (since `activeStartHour` is an integer and `intervalMinutes` divides 60),
+ * so the divisor early-return doesn't change behavior — it's just
+ * explicit about which path the cron expression itself handles.
+ */
+export declare function shouldFireHourlyTickAt(localHour: number, localMinute: number, intervalMinutes: number, activeStartHour: number): boolean;
+/**
+ * Cron expression for the morning user-profile sweep: 10 min before the
+ * day boundary, wrapping backward across midnight. For the default
+ * `dayBoundaryHour = 4`, returns `"50 3 * * *"`. Extracted as a pure
+ * helper so the arithmetic can be asserted without having to mock
+ * node-cron.
+ */
+export declare function buildUserProfileSweepMorningCronExpr(dayBoundaryHour: number): string;
+/**
+ * Cron expression for the evening user-profile sweep: fixed at 17:50
+ * local, which is 10 min before Evening Review's fixed 18:00. If
+ * Evening Review ever becomes time-configurable, this expression must
+ * track the same config knob in lockstep.
+ */
+export declare const USER_PROFILE_SWEEP_EVENING_CRON_EXPR = "50 17 * * *";
+/**
+ * AgentScheduler — manages recurring cron jobs and the DB-driven ScheduleWatcher.
+ *
+ * Cron jobs:
+ * - 04:00 daily: Morning Routine + daily cleanup + retention
+ * - 18:00 daily: Evening Review
+ * - 18:00 Friday: Weekly Review
+ * - 18:00 last day of month: Monthly Review
+ *
+ * ScheduleWatcher:
+ * - Polls agent_schedule table every N seconds for pending tasks
+ * - Handles agent-scheduled wake-ups and DMs
+ * - Uses optimistic locking to prevent duplicate execution
+ */
+export declare class AgentScheduler {
+    private readonly eventBus;
+    private readonly db;
+    private readonly config;
+    private shutdown;
+    private readonly cronJobs;
+    private noFutureTasksWarned;
+    private onDayBoundary;
+    private sendDm;
+    private onHourlyCheck;
+    /**
+     * Phase 4 auth probe hook — fired on every hourly cron tick BEFORE
+     * `onHourlyCheck` so the probe gets a chance to refresh DB cache +
+     * emit DMs even when the observation-threshold gate would skip the
+     * hourly check itself. The AuthHealthMonitor.checkAll() method owns
+     * its own kill-switch and morning-routine skip; the scheduler only
+     * applies the same `autonomousGate` short-circuit that protects the
+     * other cron callbacks.
+     *
+     * See `docs/design/09-safety-cost.md` §9.5.4 for the gate
+     * ordering: morning-routine → hourly-already-running → auth probe
+     * → observation-threshold. Steps 1 + 2 are handled inside
+     * `triggerHourlyCheck`; step 3 is this callback; step 4 is the
+     * threshold gate inside `triggerHourlyCheck`.
+     */
+    private onAuthProbe;
+    /**
+     * B-004 Phase 2a — nightly context-index reconciler callback (§4.1).
+     * Fires at 03:45 local (dayBoundaryHour - 15 min) via an internal cron
+     * job, BEFORE the morning routine so the index is fresh when the
+     * morning flow reads it. The observer owns the run-once guard.
+     */
+    private onContextIndexReconcile;
+    /**
+     * Setup gate — returns a skip reason when autonomous work should be
+     * paused (initial setup incomplete, or setup conversation active).
+     * Returns null when autonomous work may proceed. Wired from EventDispatcher
+     * via setAutonomousGate() so the scheduler doesn't take a hard dependency
+     * on the dispatcher.
+     */
+    private autonomousGate;
+    private lastGateBlockLoggedAt;
+    /**
+     * Aborted by stop() to interrupt the ScheduleWatcher's between-poll sleep
+     * immediately. Without this, SIGTERM has to wait up to
+     * `schedulePollIntervalSeconds` before the loop notices `this.shutdown`.
+     */
+    private pollAbort;
+    constructor(eventBus: EventBus, db: Database.Database, config: AgentConfig);
+    /**
+     * Register a callback that runs at the day boundary (4 AM) BEFORE
+     * the morning routine and daily cleanup. Used for DM session summarization.
+     */
+    setDayBoundaryCallback(fn: () => Promise<void>): void;
+    /**
+     * Register a callback for sending direct DMs (scheduled via POST /api/schedule/dm).
+     * When a task_type='dm' row is due, the message is sent directly without an agent.
+     */
+    setSendDmCallback(fn: (message: string, platforms?: string[]) => Promise<MessageDelivery[]>): void;
+    setHourlyCheckCallback(fn: (source: string) => Promise<unknown>): void;
+    /**
+     * Register the Phase 4 auth probe callback. Called on each hourly
+     * cron tick BEFORE the hourly-check observation threshold gate so
+     * the probe continues to run even when the hourly check itself
+     * would be skipped for lack of pending observations.
+     */
+    setAuthProbeCallback(fn: () => Promise<unknown>): void;
+    /**
+     * Register the context-index reconciler cron callback. Called every
+     * night at 03:45 local; the callback is expected to be fire-and-forget
+     * and enqueue a reconcile via the observer's run-once guard.
+     */
+    setContextIndexReconcilerCallback(fn: () => void): void;
+    /**
+     * Register the autonomous-work gate. Returning null allows autonomous work;
+     * any non-null string is treated as a skip reason and surfaced in logs.
+     */
+    setAutonomousGate(fn: () => null | string): void;
+    /** Log gate blocks at most once every 5 minutes to avoid spam. */
+    private logGateBlock;
+    start(): void;
+    stop(): void;
+    /** Hot-reload cron schedules (e.g. after dayBoundaryHour changes) */
+    reloadCrons(): void;
+    private stopCronJobs;
+    private setupRecurringJobs;
+    private emitRoutine;
+    /**
+     * Queue the morning routine as a durable wake task.
+     *
+     * This serializes all morning-routine entry points (cron, startup catchup,
+     * Google auth hot-load) behind a single DB-backed dedup guard so we don't
+     * run multiple overlapping full-day regenerations.
+     */
+    queueMorningRoutineWake(source: string, options?: {
+        postCatchupRoutines?: string[];
+        postCatchupHourlyCheck?: boolean;
+    }): {
+        inserted: boolean;
+        existingId?: number;
+    };
+    /**
+     * ScheduleWatcher — polls agent_schedule for pending tasks.
+     *
+     * Handles agent-scheduled wake-ups and DMs. Uses optimistic locking:
+     * only processes rows where
+     * UPDATE ... SET status='running' WHERE status='pending' succeeds.
+     */
+    private startScheduleWatcher;
+    /**
+     * Sleep for `ms` milliseconds, but resolve early if `pollAbort` aborts.
+     * Used by the ScheduleWatcher between polls so stop() can interrupt it.
+     */
+    private sleepInterruptible;
+    /**
+     * Handle a direct DM task: send the message directly via the registered
+     * callback, bypassing the agent pipeline entirely. This is zero-cost
+     * compared to running an AI agent for a pre-composed message.
+     *
+     * Quiet hours and rate limits are intentionally skipped — the user
+     * explicitly scheduled this DM, so it should fire at the requested time.
+     */
+    private handleDirectDm;
+    /** Daily cleanup: expire sessions, run retention */
+    private dailyCleanup;
+}
+//# sourceMappingURL=scheduler.d.ts.map

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

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