@c4t4/heyamigo 0.9.25 → 0.10.1

package/migrations/meta/_journal.json

@@ -71,6 +71,13 @@
       "when": 1779721119860,
       "tag": "0009_crons_usage_tracking",
       "breakpoints": true
+    },
+    {
+      "idx": 10,
+      "version": "6",
+      "when": 1779726435009,
+      "tag": "0010_create_threads",
+      "breakpoints": true
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4t4/heyamigo",
-  "version": "0.9.25",
+  "version": "0.10.1",
   "description": "WhatsApp AI bot powered by Claude with long-term memory, browser control, and role-based access",
   "type": "module",
   "main": "dist/index.js",

package/dist/memory/journal-cadence.js

@@ -1,120 +0,0 @@
-// Cadence parsing and "is due?" evaluation for journals.
-//
-// Supported shapes:
-//   "daily HH:MM"        — daily at HH:MM in owner.timezone (e.g. "daily 21:00")
-//   "Xh"                 — every X hours (e.g. "24h")
-//   "Xd"                 — every X days (e.g. "3d")
-//   "Xm"                 — every X minutes (only for testing; rounded up)
-//
-// Quiet hours shape: "HH:MM-HH:MM" (may span midnight: "22:00-08:00")
-export function parseCadence(raw) {
-    if (!raw)
-        return null;
-    const s = raw.trim().toLowerCase();
-    const daily = s.match(/^daily\s+(\d{1,2}):(\d{2})$/);
-    if (daily) {
-        const hour = Number(daily[1]);
-        const minute = Number(daily[2]);
-        if (hour < 0 || hour > 23 || minute < 0 || minute > 59)
-            return null;
-        return { kind: 'daily', hour, minute };
-    }
-    const iv = s.match(/^(\d+)\s*([mhd])$/);
-    if (iv) {
-        const n = Number(iv[1]);
-        const unit = iv[2];
-        if (!Number.isFinite(n) || n <= 0)
-            return null;
-        const secs = unit === 'm' ? n * 60 : unit === 'h' ? n * 3600 : n * 86400;
-        return { kind: 'interval', seconds: secs };
-    }
-    return null;
-}
-// Returns unix seconds (ts) of the next scheduled firing AFTER the given
-// "lastFiredTs" (or since "now" if never fired). For daily cadences, the time
-// is computed in the owner's timezone.
-export function nextFireTs(params) {
-    const { cadence, lastFiredTs, now, timezone } = params;
-    if (cadence.kind === 'interval') {
-        const base = lastFiredTs ?? now;
-        return base + cadence.seconds;
-    }
-    // daily HH:MM in timezone
-    const anchor = lastFiredTs ?? now;
-    // Start from the day of anchor, then walk forward until target time > anchor.
-    let target = dailyTargetTs(anchor, cadence, timezone);
-    while (target <= anchor) {
-        target = dailyTargetTs(target + 1, cadence, timezone);
-    }
-    return target;
-}
-// For a given reference ts, compute the unix ts for HH:MM that same day in the
-// given timezone. May be earlier than ref if the clock time is past HH:MM.
-function dailyTargetTs(refTs, cadence, timezone) {
-    const parts = timezoneParts(refTs, timezone);
-    // Construct an ISO-like string for "that date at HH:MM in tz" and convert
-    // back to epoch via UTC offset derived from parts.
-    const y = parts.year;
-    const mo = parts.month;
-    const d = parts.day;
-    const ts = zonedDateTimeToEpoch(y, mo, d, cadence.hour, cadence.minute, timezone);
-    return ts;
-}
-export function timezoneParts(tsSeconds, timezone) {
-    const fmt = new Intl.DateTimeFormat('en-GB', {
-        timeZone: timezone,
-        year: 'numeric',
-        month: '2-digit',
-        day: '2-digit',
-        hour: '2-digit',
-        minute: '2-digit',
-        second: '2-digit',
-        hour12: false,
-    });
-    const p = Object.fromEntries(fmt.formatToParts(new Date(tsSeconds * 1000)).map((x) => [x.type, x.value]));
-    return {
-        year: Number(p.year),
-        month: Number(p.month),
-        day: Number(p.day),
-        hour: Number(p.hour) % 24,
-        minute: Number(p.minute),
-        second: Number(p.second),
-    };
-}
-// Convert a local (zoned) date-time to epoch seconds. Uses Intl to derive the
-// UTC offset for that zone at that wall time.
-function zonedDateTimeToEpoch(year, month, day, hour, minute, timezone) {
-    // Start with the wall time treated as UTC, then correct by the tz offset.
-    const asUtcMs = Date.UTC(year, month - 1, day, hour, minute, 0);
-    // Get what that UTC moment looks like in the target timezone
-    const parts = timezoneParts(Math.floor(asUtcMs / 1000), timezone);
-    // Compute the diff between the wall time we wanted and what we got
-    const wantedMs = asUtcMs;
-    const gotMs = Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, 0);
-    const offsetMs = gotMs - wantedMs;
-    return Math.floor((asUtcMs - offsetMs) / 1000);
-}
-// Quiet hours: is the given time inside the quiet-hours window (in tz)?
-// Accepts "HH:MM-HH:MM" (e.g. "22:00-08:00" = 10pm to 8am next day).
-export function isInQuietHours(params) {
-    const { now, window, timezone } = params;
-    if (!window)
-        return false;
-    const m = window.match(/^(\d{1,2}):(\d{2})\s*-\s*(\d{1,2}):(\d{2})$/);
-    if (!m)
-        return false;
-    const startH = Number(m[1]);
-    const startM = Number(m[2]);
-    const endH = Number(m[3]);
-    const endM = Number(m[4]);
-    const parts = timezoneParts(now, timezone);
-    const curMin = parts.hour * 60 + parts.minute;
-    const startMin = startH * 60 + startM;
-    const endMin = endH * 60 + endM;
-    if (startMin <= endMin) {
-        // Non-wrapping window: [start, end)
-        return curMin >= startMin && curMin < endMin;
-    }
-    // Wrapping window: [start, 24:00) ∪ [00:00, end)
-    return curMin >= startMin || curMin < endMin;
-}

package/dist/memory/journal-nudger.js

@@ -1,221 +0,0 @@
-import { getProvider } from '../ai/providers.js';
-import { config } from '../config.js';
-import { initiate } from '../gateway/outgoing.js';
-import { logger } from '../logger.js';
-import { readLast } from '../store/messages.js';
-import { canSendProactive } from '../wa/whitelist.js';
-import { isInQuietHours, nextFireTs, parseCadence, } from './journal-cadence.js';
-import { listJournals, loadNudgeState, readEntries, saveNudgeState, } from './journals.js';
-// Default nudge target: owner's self-DM. Group/other-chat nudges would require
-// explicit opt-in via access.json; we don't schedule those automatically in v1.
-function defaultNudgeJid() {
-    if (!config.owner.number)
-        return null;
-    return `${config.owner.number}@s.whatsapp.net`;
-}
-async function spawnComposer(prompt) {
-    const { reply } = await getProvider().runTask({
-        input: prompt,
-        caller: 'journal-nudger',
-        mode: 'auto',
-        lane: 'background',
-    });
-    return reply;
-}
-function formatMsg(m) {
-    const who = m.direction === 'out' ? 'assistant' : m.pushName || m.senderNumber || 'user';
-    return `${who}: ${m.text}`;
-}
-function buildPrompt(params) {
-    const { journal, kind, nowLocal, recentEntries, recentMessages } = params;
-    const kindDescription = kind === 'checkin'
-        ? "This is a scheduled recurring check-in for this journal. Ask the owner to log whatever belongs in the journal right now (e.g. for a health journal at night: how did you sleep, any symptoms, anything else)."
-        : "The owner has been silent on this journal's topic for a while. Send a gentle, natural nudge asking how things are going. Do not list every field; pick one thread.";
-    const lines = [
-        `You are composing a proactive WhatsApp message to the owner from their personal assistant bot.`,
-        ``,
-        `CONTEXT:`,
-        `- Journal: ${journal.name} (slug: ${journal.slug})`,
-        `- Purpose: ${journal.purpose}`,
-        journal.fields.length
-            ? `- Fields typically captured: ${journal.fields.join(', ')}`
-            : '',
-        `- Local time now: ${nowLocal}`,
-        `- Nudge type: ${kind}. ${kindDescription}`,
-        ``,
-        `RECENT JOURNAL ENTRIES (for continuity):`,
-        recentEntries.length
-            ? recentEntries
-                .map((e) => {
-                const d = new Date(e.ts * 1000).toISOString().slice(0, 16).replace('T', ' ');
-                return `- [${d}] ${e.note}`;
-            })
-                .join('\n')
-            : '(none yet)',
-        ``,
-        `RECENT CONVERSATION (so you sound like yourself, not a stranger):`,
-        recentMessages.length
-            ? recentMessages.slice(-10).map(formatMsg).join('\n')
-            : '(none)',
-        ``,
-        `RULES:`,
-        `- Stay fully in character (your personality file defines tone; you are NOT customer service and NOT a reminder app).`,
-        `- Short. One message, a few sentences max. No bullet lists, no headers.`,
-        `- Do not open with validation, greetings, or "hope you're doing well" fillers. Get to the point.`,
-        `- Be specific to the journal and what you know about the owner from recent entries and conversation.`,
-        `- If previous entries show a pattern or an unresolved thread, reference it.`,
-        `- Do NOT include any [TAG: ...] markers. This message is sent raw.`,
-        `- If you truly think sending nothing is better right now (e.g. you just talked about this an hour ago), output the single word: SKIP`,
-        ``,
-        `OUTPUT: either the message text, or the single word SKIP. No preamble, no explanation.`,
-    ];
-    return lines.filter(Boolean).join('\n');
-}
-function nowLocalString(timezone, now) {
-    const fmt = new Intl.DateTimeFormat('en-GB', {
-        timeZone: timezone,
-        weekday: 'long',
-        year: 'numeric',
-        month: '2-digit',
-        day: '2-digit',
-        hour: '2-digit',
-        minute: '2-digit',
-        timeZoneName: 'short',
-        hour12: false,
-    });
-    return fmt.format(new Date(now * 1000));
-}
-async function composeAndSend(params) {
-    const { journal, kind, jid } = params;
-    const now = Math.floor(Date.now() / 1000);
-    const nowLocal = nowLocalString(config.owner.timezone, now);
-    const recentMessages = await readLast(jid, 30);
-    const recentEntries = readEntries(journal.slug, 10).map((e) => ({
-        ts: e.ts,
-        note: e.note,
-    }));
-    const prompt = buildPrompt({
-        journal,
-        kind,
-        nowLocal,
-        recentEntries,
-        recentMessages,
-    });
-    let output;
-    try {
-        output = await spawnComposer(prompt);
-    }
-    catch (err) {
-        logger.error({ err, slug: journal.slug, kind }, 'nudge composer failed');
-        return false;
-    }
-    const text = output.trim();
-    if (!text || text.toUpperCase() === 'SKIP') {
-        logger.info({ slug: journal.slug, kind }, 'nudge composer chose to skip');
-        return false;
-    }
-    const sent = await initiate({ jid, text });
-    return sent;
-}
-function lastOwnerInboundTs(messages) {
-    for (let i = messages.length - 1; i >= 0; i--) {
-        const m = messages[i];
-        if (m.direction === 'in' && m.senderNumber === config.owner.number) {
-            return m.timestamp;
-        }
-    }
-    return 0;
-}
-function needCheckin(journal, state, now) {
-    const cadence = parseCadence(journal.cadence.checkin);
-    if (!cadence)
-        return false;
-    const next = nextFireTs({
-        cadence,
-        lastFiredTs: state.lastCheckinTs || null,
-        now,
-        timezone: config.owner.timezone,
-    });
-    return now >= next;
-}
-function needSilentNudge(params) {
-    const { journal, state, now, lastOwnerActivityTs } = params;
-    const cadence = parseCadence(journal.cadence.nudge_if_silent);
-    if (!cadence || cadence.kind !== 'interval')
-        return false;
-    const silenceThresholdSec = cadence.seconds;
-    if (now - lastOwnerActivityTs < silenceThresholdSec)
-        return false;
-    // Debounce: don't resend the same silent nudge more often than the threshold.
-    if (now - state.lastSilentNudgeTs < silenceThresholdSec)
-        return false;
-    return true;
-}
-export async function runNudgeTick() {
-    const jid = defaultNudgeJid();
-    if (!jid) {
-        logger.warn('nudge tick: no owner.number, skipping');
-        return;
-    }
-    if (!canSendProactive(jid)) {
-        logger.debug({ jid }, 'nudge tick: proactive sending not allowed for target jid');
-        return;
-    }
-    const now = Math.floor(Date.now() / 1000);
-    if (isInQuietHours({
-        now,
-        window: '22:00-08:00',
-        timezone: config.owner.timezone,
-    })) {
-        return;
-    }
-    const journals = listJournals().filter((j) => j.status === 'active');
-    for (const journal of journals) {
-        const state = loadNudgeState(journal.slug);
-        if (state.snoozedUntilTs && now < state.snoozedUntilTs)
-            continue;
-        // Per-journal quiet hours override
-        if (isInQuietHours({
-            now,
-            window: journal.quiet_hours,
-            timezone: config.owner.timezone,
-        })) {
-            continue;
-        }
-        const recent = await readLast(jid, 50);
-        const lastOwnerTs = lastOwnerInboundTs(recent);
-        if (needCheckin(journal, state, now)) {
-            const sent = await composeAndSend({
-                journal,
-                kind: 'checkin',
-                jid,
-            });
-            if (sent) {
-                const fresh = loadNudgeState(journal.slug);
-                fresh.lastCheckinTs = now;
-                saveNudgeState(journal.slug, fresh);
-                logger.info({ slug: journal.slug, kind: 'checkin' }, 'nudge sent');
-            }
-            // Don't also send a silent nudge in the same tick for this journal.
-            continue;
-        }
-        if (needSilentNudge({
-            journal,
-            state,
-            now,
-            lastOwnerActivityTs: lastOwnerTs,
-        })) {
-            const sent = await composeAndSend({
-                journal,
-                kind: 'silent',
-                jid,
-            });
-            if (sent) {
-                const fresh = loadNudgeState(journal.slug);
-                fresh.lastSilentNudgeTs = now;
-                saveNudgeState(journal.slug, fresh);
-                logger.info({ slug: journal.slug, kind: 'silent' }, 'nudge sent');
-            }
-        }
-    }
-}