agim-cli 1.2.44 → 1.2.48

package/dist/core/heartbeat-store.js

@@ -0,0 +1,302 @@
+// heartbeat-store — persistent state for the heartbeat service (P0 #1).
+//
+// One row per IM thread that has a heartbeat configured. The row holds
+// the markdown "body" the heartbeat agent reasons against, the tick
+// recurrence, the latest tick outcome (for /heartbeat show), and a tiny
+// preview of the most recent delivery (so users can see "I last pinged
+// you about X at HH:MM").
+//
+// Storage layout decision: SQLite, NOT a file-per-workspace markdown
+// store (nanobot's HEARTBEAT.md design). agim is multi-tenant by IM
+// thread; co-locating heartbeat config with the rest of agim's state
+// (reminders.db, audit.db, etc.) keeps backup / restore / migration
+// simple and avoids creating workspace directories for users who never
+// touch the CLI agents.
+//
+// All public APIs return / accept plain objects (HeartbeatRow). Callers
+// don't see SQLite directly so swapping the backend later is easy.
+import { join } from 'node:path';
+import { AGIM_HOME } from './agim-paths.js';
+import { logger as rootLogger } from './logger.js';
+import { createSqliteHelper } from './sqlite-helper.js';
+const HEARTBEAT_DB = process.env.IMHUB_HEARTBEAT_DB
+    ?? join(AGIM_HOME, 'heartbeat.db');
+/** Per-thread tick recurrence, in minutes. The default lines up with
+ *  nanobot's 30-min cadence; operators can override per binding with
+ *  `/heartbeat interval N` or the IMHUB_HEARTBEAT_DEFAULT_INTERVAL env. */
+export const DEFAULT_INTERVAL_MIN = 30;
+/** Hard lower bound on the recurrence. 1-minute heartbeats are almost
+ *  always a misconfiguration (the agent burns through API calls and
+ *  there's no time for the previous tick to even finish). */
+export const MIN_INTERVAL_MIN = 5;
+/** Hard upper bound — 24h. Above this just use cron + reminders. */
+export const MAX_INTERVAL_MIN = 24 * 60;
+/** Max characters in a heartbeat body. Keeps prompt size bounded; the
+ *  body is the entire context the cheap decide-step LLM sees, so
+ *  unbounded text would silently blow the context window. */
+export const MAX_BODY_CHARS = 8_000;
+/** Max characters of the last delivered text we keep around for the
+ *  /heartbeat show preview. Beyond this is truncated with "…". */
+const MAX_PREVIEW_CHARS = 240;
+const helper = createSqliteHelper({
+    file: HEARTBEAT_DB,
+    component: 'heartbeat-store',
+    logger: rootLogger,
+    schema: `
+    CREATE TABLE IF NOT EXISTS heartbeats (
+      id                INTEGER PRIMARY KEY AUTOINCREMENT,
+      platform          TEXT    NOT NULL,
+      channel_id        TEXT    NOT NULL,
+      thread_id         TEXT    NOT NULL,
+      user_id           TEXT    NOT NULL DEFAULT '',
+      body              TEXT    NOT NULL,
+      interval_minutes  INTEGER NOT NULL,
+      enabled           INTEGER NOT NULL DEFAULT 1,
+      last_tick_at      TEXT,
+      last_status       TEXT    NOT NULL DEFAULT 'pending',
+      last_reason       TEXT    NOT NULL DEFAULT '',
+      last_text_preview TEXT    NOT NULL DEFAULT '',
+      created_at        TEXT    NOT NULL DEFAULT (datetime('now')),
+      updated_at        TEXT    NOT NULL DEFAULT (datetime('now')),
+      UNIQUE (platform, channel_id, thread_id)
+    );
+    CREATE INDEX IF NOT EXISTS idx_heartbeats_tick   ON heartbeats(enabled, last_tick_at);
+    CREATE INDEX IF NOT EXISTS idx_heartbeats_owner  ON heartbeats(platform, user_id);
+  `,
+});
+function getDb() {
+    return helper.get();
+}
+function rowFromRaw(r) {
+    return {
+        id: r.id,
+        platform: r.platform,
+        channelId: r.channel_id,
+        threadId: r.thread_id,
+        userId: r.user_id,
+        body: r.body,
+        intervalMinutes: r.interval_minutes,
+        enabled: r.enabled !== 0,
+        lastTickAt: r.last_tick_at,
+        lastStatus: (r.last_status || 'pending'),
+        lastReason: r.last_reason || '',
+        lastTextPreview: r.last_text_preview || '',
+        createdAt: r.created_at,
+        updatedAt: r.updated_at,
+    };
+}
+/** Read the operator-provided default interval (env override or constant). */
+export function defaultIntervalMinutes() {
+    const raw = process.env.IMHUB_HEARTBEAT_DEFAULT_INTERVAL_MIN;
+    if (raw) {
+        const n = parseInt(raw, 10);
+        if (Number.isFinite(n) && n >= MIN_INTERVAL_MIN && n <= MAX_INTERVAL_MIN) {
+            return n;
+        }
+    }
+    return DEFAULT_INTERVAL_MIN;
+}
+/**
+ * Create or replace the heartbeat for a thread. UPSERT semantics — one
+ * binding per thread, calling bind() again overwrites the body and
+ * resets last_tick_at so the new body takes effect on the next tick
+ * (not 30 min later).
+ */
+export function upsertBinding(input) {
+    const d = getDb();
+    if (!d)
+        return null;
+    const body = input.body.slice(0, MAX_BODY_CHARS);
+    const interval = clampInterval(input.intervalMinutes ?? defaultIntervalMinutes());
+    try {
+        // ON CONFLICT preserves the auto-increment id and timestamps while
+        // refreshing the user-visible fields. We deliberately RESET
+        // last_tick_at to NULL on rebind so the new body runs at the next
+        // scheduler tick — otherwise the user's "/heartbeat bind X" sits
+        // dormant for up to `intervalMinutes` minutes.
+        d.prepare(`
+      INSERT INTO heartbeats
+        (platform, channel_id, thread_id, user_id, body, interval_minutes,
+         enabled, last_tick_at, last_status, last_reason, last_text_preview,
+         updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, 1, NULL, 'pending', '', '', datetime('now'))
+      ON CONFLICT (platform, channel_id, thread_id) DO UPDATE SET
+        user_id          = excluded.user_id,
+        body             = excluded.body,
+        interval_minutes = excluded.interval_minutes,
+        enabled          = 1,
+        last_tick_at     = NULL,
+        last_status      = 'pending',
+        last_reason      = '',
+        updated_at       = datetime('now')
+    `).run(input.platform, input.channelId, input.threadId, input.userId, body, interval);
+        return getBinding(input.platform, input.channelId, input.threadId);
+    }
+    catch (err) {
+        rootLogger.warn({ event: 'heartbeat-store.upsert_failed', err: String(err) });
+        return null;
+    }
+}
+/** Disable (don't delete) a binding for the given thread. */
+export function disableBinding(platform, channelId, threadId) {
+    const d = getDb();
+    if (!d)
+        return false;
+    try {
+        const info = d.prepare(`
+      UPDATE heartbeats SET enabled = 0, updated_at = datetime('now')
+      WHERE platform = ? AND channel_id = ? AND thread_id = ?
+    `).run(platform, channelId, threadId);
+        return info.changes > 0;
+    }
+    catch (err) {
+        rootLogger.warn({ event: 'heartbeat-store.disable_failed', err: String(err) });
+        return false;
+    }
+}
+/** Soft-enable an existing binding (no-op if missing). */
+export function enableBinding(platform, channelId, threadId) {
+    const d = getDb();
+    if (!d)
+        return false;
+    try {
+        const info = d.prepare(`
+      UPDATE heartbeats SET enabled = 1, updated_at = datetime('now')
+      WHERE platform = ? AND channel_id = ? AND thread_id = ?
+    `).run(platform, channelId, threadId);
+        return info.changes > 0;
+    }
+    catch (err) {
+        rootLogger.warn({ event: 'heartbeat-store.enable_failed', err: String(err) });
+        return false;
+    }
+}
+/** Replace the interval for an existing binding (no-op if missing). */
+export function updateInterval(platform, channelId, threadId, intervalMinutes) {
+    const d = getDb();
+    if (!d)
+        return false;
+    const interval = clampInterval(intervalMinutes);
+    try {
+        const info = d.prepare(`
+      UPDATE heartbeats
+        SET interval_minutes = ?, updated_at = datetime('now')
+      WHERE platform = ? AND channel_id = ? AND thread_id = ?
+    `).run(interval, platform, channelId, threadId);
+        return info.changes > 0;
+    }
+    catch (err) {
+        rootLogger.warn({ event: 'heartbeat-store.update_interval_failed', err: String(err) });
+        return false;
+    }
+}
+/** Stamp the outcome of a tick. Caller is the scheduler / runForBinding. */
+export function recordTick(input) {
+    const d = getDb();
+    if (!d)
+        return;
+    try {
+        if (input.status === 'delivered') {
+            const preview = (input.deliveredText ?? '').slice(0, MAX_PREVIEW_CHARS);
+            d.prepare(`
+        UPDATE heartbeats SET
+          last_tick_at      = datetime('now'),
+          last_status       = ?,
+          last_reason       = ?,
+          last_text_preview = ?,
+          updated_at        = datetime('now')
+        WHERE id = ?
+      `).run(input.status, input.reason.slice(0, 240), preview, input.id);
+        }
+        else {
+            d.prepare(`
+        UPDATE heartbeats SET
+          last_tick_at = datetime('now'),
+          last_status  = ?,
+          last_reason  = ?,
+          updated_at   = datetime('now')
+        WHERE id = ?
+      `).run(input.status, input.reason.slice(0, 240), input.id);
+        }
+    }
+    catch (err) {
+        rootLogger.warn({ event: 'heartbeat-store.record_tick_failed', err: String(err) });
+    }
+}
+export function getBinding(platform, channelId, threadId) {
+    const d = getDb();
+    if (!d)
+        return null;
+    try {
+        const row = d.prepare(`
+      SELECT * FROM heartbeats
+      WHERE platform = ? AND channel_id = ? AND thread_id = ?
+    `).get(platform, channelId, threadId);
+        return row ? rowFromRaw(row) : null;
+    }
+    catch (err) {
+        rootLogger.warn({ event: 'heartbeat-store.get_failed', err: String(err) });
+        return null;
+    }
+}
+/** All bindings, regardless of enabled state. Admin-facing /heartbeat list. */
+export function listAllBindings() {
+    const d = getDb();
+    if (!d)
+        return [];
+    try {
+        const rows = d.prepare(`SELECT * FROM heartbeats ORDER BY id ASC`).all();
+        return rows.map(rowFromRaw);
+    }
+    catch (err) {
+        rootLogger.warn({ event: 'heartbeat-store.list_failed', err: String(err) });
+        return [];
+    }
+}
+/**
+ * All enabled bindings whose next tick is due. "Due" = `last_tick_at IS
+ * NULL` OR `datetime(last_tick_at) <= datetime('now', '-N minutes')`.
+ *
+ * Each row carries its own interval, so we can't precompute a single
+ * cutoff — the SQL filter checks per-row using interval_minutes.
+ */
+export function listDueBindings() {
+    const d = getDb();
+    if (!d)
+        return [];
+    try {
+        const rows = d.prepare(`
+      SELECT * FROM heartbeats
+      WHERE enabled = 1
+        AND (
+          last_tick_at IS NULL
+          OR datetime(last_tick_at, '+' || interval_minutes || ' minutes') <= datetime('now')
+        )
+      ORDER BY (last_tick_at IS NULL) DESC, last_tick_at ASC
+      LIMIT 50
+    `).all();
+        return rows.map(rowFromRaw);
+    }
+    catch (err) {
+        rootLogger.warn({ event: 'heartbeat-store.list_due_failed', err: String(err) });
+        return [];
+    }
+}
+/** Strictly for tests: drop the table contents. NEVER call from runtime
+ *  paths — the alternative is `disableBinding` per row. */
+export function _truncateForTests() {
+    const d = getDb();
+    if (!d)
+        return;
+    d.exec('DELETE FROM heartbeats');
+}
+function clampInterval(n) {
+    if (!Number.isFinite(n))
+        return DEFAULT_INTERVAL_MIN;
+    if (n < MIN_INTERVAL_MIN)
+        return MIN_INTERVAL_MIN;
+    if (n > MAX_INTERVAL_MIN)
+        return MAX_INTERVAL_MIN;
+    return Math.floor(n);
+}
+//# sourceMappingURL=heartbeat-store.js.map

package/dist/core/heartbeat-store.js.map

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

package/dist/core/heartbeat.d.ts

@@ -0,0 +1,35 @@
+import { type HeartbeatRow } from './heartbeat-store.js';
+export interface RunResult {
+    status: 'skipped' | 'delivered' | 'suppressed' | 'no-agent' | 'failed';
+    reason: string;
+    /** Populated only when status='delivered'. */
+    deliveredText?: string;
+    /** Populated when status='delivered' or 'suppressed' so /heartbeat
+     *  run-now can print "the gate / sink got this much". */
+    rawAgentOutput?: string;
+}
+/**
+ * Single binding tick. ALL exceptions caught + logged + stamped onto
+ * the row; never throws. Returns the result so the slash command's
+ * `/heartbeat run-now` can show it back to the user synchronously.
+ */
+export declare function runForBinding(row: HeartbeatRow): Promise<RunResult>;
+/**
+ * One scheduler pass. Picks up to 50 due bindings and runs them
+ * sequentially; concurrent ticks on the same scheduler are intentional
+ * (avoids stampedes on the user's agent, keeps memory bounded). Returns
+ * a summary so tests can assert on it.
+ */
+export declare function tickOnce(): Promise<{
+    scanned: number;
+    results: Record<string, number>;
+}>;
+export declare function startHeartbeatScheduler(): void;
+export declare function stopHeartbeatScheduler(): void;
+/** Reflect current scheduler state for /heartbeat status output. */
+export declare function schedulerInfo(): {
+    enabled: boolean;
+    running: boolean;
+    periodMs: number;
+};
+//# sourceMappingURL=heartbeat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../src/core/heartbeat.ts"],"names":[],"mappings":"AAmCA,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAA;AAmK7B,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAA;IACtE,MAAM,EAAE,MAAM,CAAA;IACd,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;6DACyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAsFzE;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAmB9F;AAQD,wBAAgB,uBAAuB,IAAI,IAAI,CAiB9C;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAK7C;AAED,oEAAoE;AACpE,wBAAgB,aAAa,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAMxF"}