agentrem 1.2.2 → 1.3.0

package/dist/watch.d.ts

@@ -0,0 +1,34 @@
+import type { Reminder } from './types.js';
+export declare const DEDUP_COOLDOWN_MS: number;
+export interface WatchOptions {
+    /** Poll interval in seconds (default 30) */
+    interval?: number;
+    /** Agent name to check for (default 'main') */
+    agent?: string;
+    /** Run check once and exit (no loop) */
+    once?: boolean;
+    /** Verbose logging */
+    verbose?: boolean;
+    /** Optional db path (for testing) */
+    dbPath?: string;
+    /**
+     * Override the notification function (defaults to fireNotification).
+     * Useful for testing — pass a no-op or spy to avoid spawning OS notifiers.
+     */
+    onNotify?: (rem: Reminder) => void;
+}
+export interface WatchState {
+    /** Map of reminder ID → timestamp of last notification */
+    lastNotified: Map<string, number>;
+}
+/** Returns true if the reminder should be notified (not in cooldown). */
+export declare function shouldNotify(state: WatchState, reminderId: string, now?: number): boolean;
+/** Mark a reminder as notified (records current timestamp). */
+export declare function markNotified(state: WatchState, reminderId: string, now?: number): void;
+/** Send a native OS notification for a single reminder. */
+export declare function fireNotification(rem: Reminder): void;
+/** Run a single check cycle: poll DB, notify due reminders, return notified list. */
+export declare function runCheckCycle(state: WatchState, opts: WatchOptions, now?: number): Reminder[];
+/** Start the watch loop. Resolves when the loop stops (only if `once` or `signal` fires). */
+export declare function startWatch(opts: WatchOptions, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=watch.d.ts.map

package/dist/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,eAAO,MAAM,iBAAiB,QAAgB,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sBAAsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,0DAA0D;IAC1D,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,OAAO,CAIrG;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI,CAElG;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAGpD;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,YAAY,EAClB,GAAG,GAAE,MAAmB,GACvB,QAAQ,EAAE,CAmCZ;AAED,6FAA6F;AAC7F,wBAAsB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCxF"}

package/dist/watch.js

@@ -0,0 +1,93 @@
+// ── Watch / Notification Loop ─────────────────────────────────────────────
+// Polls coreCheck() on an interval and fires native OS notifications for
+// due reminders, with per-reminder dedup (5-minute cooldown).
+import { getDb } from './db.js';
+import { coreCheck } from './core.js';
+import { truncate } from './date-parser.js';
+import { buildNotifyOpts, sendNotification } from './notifier.js';
+export const DEDUP_COOLDOWN_MS = 5 * 60 * 1000; // 5 minutes
+/** Returns true if the reminder should be notified (not in cooldown). */
+export function shouldNotify(state, reminderId, now = Date.now()) {
+    const last = state.lastNotified.get(reminderId);
+    if (last === undefined)
+        return true;
+    return now - last >= DEDUP_COOLDOWN_MS;
+}
+/** Mark a reminder as notified (records current timestamp). */
+export function markNotified(state, reminderId, now = Date.now()) {
+    state.lastNotified.set(reminderId, now);
+}
+/** Send a native OS notification for a single reminder. */
+export function fireNotification(rem) {
+    const opts = buildNotifyOpts(rem);
+    sendNotification(opts);
+}
+/** Run a single check cycle: poll DB, notify due reminders, return notified list. */
+export function runCheckCycle(state, opts, now = Date.now()) {
+    const db = getDb(opts.dbPath);
+    let notified = [];
+    try {
+        const result = coreCheck(db, {
+            type: 'time,heartbeat,session,condition',
+            agent: opts.agent || 'main',
+            escalate: true,
+        });
+        const notify = opts.onNotify ?? fireNotification;
+        for (const rem of result.included) {
+            if (shouldNotify(state, rem.id, now)) {
+                notify(rem);
+                markNotified(state, rem.id, now);
+                notified.push(rem);
+                if (opts.verbose) {
+                    console.log(`[agentrem watch] 🔔 [${rem.id.slice(0, 8)}] ${truncate(rem.content, 60)}`);
+                }
+            }
+            else if (opts.verbose) {
+                console.log(`[agentrem watch] ⏭️  [${rem.id.slice(0, 8)}] in cooldown, skipping`);
+            }
+        }
+        if (opts.verbose) {
+            console.log(`[agentrem watch] checked at ${new Date(now).toISOString()} — ` +
+                `${result.totalTriggered} triggered, ${notified.length} notified`);
+        }
+    }
+    finally {
+        db.close();
+    }
+    return notified;
+}
+/** Start the watch loop. Resolves when the loop stops (only if `once` or `signal` fires). */
+export async function startWatch(opts, signal) {
+    const intervalMs = (opts.interval ?? 30) * 1000;
+    const state = { lastNotified: new Map() };
+    if (opts.verbose) {
+        console.log(`[agentrem watch] started — interval=${opts.interval ?? 30}s agent=${opts.agent ?? 'main'}`);
+    }
+    // Run immediately on start
+    runCheckCycle(state, opts);
+    if (opts.once)
+        return;
+    await new Promise((resolve) => {
+        let timer;
+        const stop = () => {
+            clearInterval(timer);
+            resolve();
+        };
+        timer = setInterval(() => {
+            if (signal?.aborted) {
+                stop();
+                return;
+            }
+            runCheckCycle(state, opts);
+        }, intervalMs);
+        if (signal) {
+            signal.addEventListener('abort', stop, { once: true });
+        }
+        // SIGINT / SIGTERM for clean shutdown when running as a daemon
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+    });
+    if (opts.verbose)
+        console.log('[agentrem watch] stopped.');
+}
+//# sourceMappingURL=watch.js.map

package/dist/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,yEAAyE;AACzE,8DAA8D;AAE9D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGlE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAyB5D,yEAAyE;AACzE,MAAM,UAAU,YAAY,CAAC,KAAiB,EAAE,UAAkB,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAC1F,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,GAAG,GAAG,IAAI,IAAI,iBAAiB,CAAC;AACzC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,YAAY,CAAC,KAAiB,EAAE,UAAkB,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAC1F,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,gBAAgB,CAAC,GAAa;IAC5C,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAClC,gBAAgB,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAC3B,KAAiB,EACjB,IAAkB,EAClB,MAAc,IAAI,CAAC,GAAG,EAAE;IAExB,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,QAAQ,GAAe,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,EAAE;YAC3B,IAAI,EAAE,kCAAkC;YACxC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,MAAM;YAC3B,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,IAAI,gBAAgB,CAAC;QACjD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAClC,IAAI,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC;gBACrC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACZ,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;gBACjC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACnB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBACjB,OAAO,CAAC,GAAG,CAAC,wBAAwB,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC1F,CAAC;YACH,CAAC;iBAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACxB,OAAO,CAAC,GAAG,CAAC,yBAAyB,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,yBAAyB,CAAC,CAAC;YACpF,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CACT,+BAA+B,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,KAAK;gBAC7D,GAAG,MAAM,CAAC,cAAc,eAAe,QAAQ,CAAC,MAAM,WAAW,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAkB,EAAE,MAAoB;IACvE,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAChD,MAAM,KAAK,GAAe,EAAE,YAAY,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IAEtD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CACT,uCAAuC,IAAI,CAAC,QAAQ,IAAI,EAAE,WAAW,IAAI,CAAC,KAAK,IAAI,MAAM,EAAE,CAC5F,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAE3B,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO;IAEtB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,IAAI,KAAqC,CAAC;QAE1C,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,aAAa,CAAC,KAAK,CAAC,CAAC;YACrB,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QAEF,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YACvB,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,IAAI,EAAE,CAAC;gBACP,OAAO;YACT,CAAC;YACD,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC,EAAE,UAAU,CAAC,CAAC;QAEf,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,+DAA+D;QAC/D,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAC7D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentrem",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "description": "Structured reminders CLI for AI agents with MCP server",
   "type": "module",
   "main": "dist/index.js",
@@ -13,10 +13,12 @@
     "llms.txt",
     "llms-full.txt",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "assets"
   ],
   "scripts": {
     "build": "tsc",
+    "build:notify": "bash scripts/build-notify.sh",
     "dev": "tsc --watch",
     "test": "vitest run",
     "test:watch": "vitest",