@mono-agent/agent-app 0.2.2 → 0.4.0

package/dist/memory-rituals.js

@@ -0,0 +1,228 @@
+/**
+ * In-app memory ritual scheduler for the `bujo` tier.
+ *
+ * Schedules `store.reflect()` and `store.migrate()` on their configured cron
+ * cadences (defaults: `0 3 * * *` / `0 4 1 * *`). Uses a hand-rolled minimal
+ * cron next-run calculator (5-field `m h dom mon dow`); avoids adding
+ * `cron-parser` as a direct dep of this package.
+ *
+ * Design guarantees:
+ * - Only schedules for `store.tier() === "bujo"` (needs the LLM tier).
+ * - Rituals default-enabled; set `enabled: false` to opt out.
+ * - Skip-overlap: never starts a run while the previous is in flight.
+ * - Never-throws: errors are caught and logged via `logger.warn`; the
+ *   scheduler reschedules after every run (success or failure).
+ * - Injectable `now` / `setTimer` / `clearTimer` for deterministic testing.
+ */
+const DEFAULT_REFLECTION_CRON = "0 3 * * *";
+const DEFAULT_MIGRATION_CRON = "0 4 1 * *";
+// ---------------------------------------------------------------------------
+// Public entry point
+// ---------------------------------------------------------------------------
+export function startMemoryRituals(input) {
+    const { store, logger } = input;
+    // Only schedule for the bujo tier.
+    if (store.tier() !== "bujo") {
+        return noopRituals();
+    }
+    const now = input.now ?? (() => new Date());
+    const setTimer = input.setTimer ?? defaultSetTimer;
+    const clearTimer = input.clearTimer ?? ((h) => clearTimeout(h));
+    const handles = [];
+    let stopped = false;
+    function scheduleRitual(name, cronExpr, run) {
+        let inFlight = false;
+        let currentHandle;
+        function schedule() {
+            if (stopped) {
+                return;
+            }
+            const current = now();
+            let delayMs;
+            try {
+                delayMs = nextCronDelayMs(cronExpr, current);
+            }
+            catch (err) {
+                logger?.warn(`Memory ritual "${name}" has an invalid cron expression "${cronExpr}": ${err instanceof Error ? err.message : String(err)}. Ritual disabled.`);
+                return;
+            }
+            const handle = setTimer(() => {
+                // Remove from tracked handles (it has fired)
+                const idx = handles.indexOf(handle);
+                if (idx !== -1) {
+                    handles.splice(idx, 1);
+                }
+                currentHandle = undefined;
+                if (stopped) {
+                    return;
+                }
+                if (inFlight) {
+                    // Skip: the previous run is still in flight. Do NOT reschedule here — the in-flight run's
+                    // .finally schedules the next tick, keeping exactly one pending timer per ritual (no double-schedule).
+                    logger?.warn(`Memory ritual "${name}" skipped — previous run is still in flight.`);
+                    return;
+                }
+                inFlight = true;
+                run()
+                    .catch((err) => {
+                    logger?.warn(`Memory ritual "${name}" failed: ${err instanceof Error ? err.message : String(err)}.`);
+                })
+                    .finally(() => {
+                    inFlight = false;
+                    schedule();
+                });
+            }, delayMs);
+            handle.unref?.();
+            currentHandle = handle;
+            handles.push(handle);
+        }
+        schedule();
+        void currentHandle; // suppress unused-variable lint; reference is in handles
+    }
+    // Schedule reflection ritual
+    if (input.reflection?.enabled !== false) {
+        const cronExpr = input.reflection?.cron ?? DEFAULT_REFLECTION_CRON;
+        scheduleRitual("reflect", cronExpr, () => store.reflect());
+    }
+    // Schedule migration ritual
+    if (input.migration?.enabled !== false) {
+        const cronExpr = input.migration?.cron ?? DEFAULT_MIGRATION_CRON;
+        scheduleRitual("migrate", cronExpr, () => store.migrate());
+    }
+    return {
+        stop() {
+            stopped = true;
+            for (const h of handles.splice(0)) {
+                if (h !== undefined) {
+                    clearTimer(h);
+                }
+            }
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Minimal 5-field cron next-run calculator
+// ---------------------------------------------------------------------------
+//
+// Supports `m h dom mon dow` where each field is:
+//   *              matches every value
+//   <number>       exact match
+//   */n            step (e.g. */5 = every 5)
+//   a-b            range
+//   a,b,c          list
+//   a-b/n          range with step
+//
+// Sufficient for the two defaults + most simple expressions.
+// Time complexity: O(minutes-until-next-run), bounded by 366*24*60 ≈ 530k.
+// ---------------------------------------------------------------------------
+function nextCronDelayMs(expression, from) {
+    const fields = expression.trim().split(/\s+/u);
+    if (fields.length !== 5) {
+        throw new Error(`Expected 5 fields; got ${fields.length}`);
+    }
+    const [mField, hField, domField, monField, dowField] = fields;
+    // Search forward minute by minute for up to ~2 years
+    // Start from the NEXT minute after `from` (cron fires at the start of the minute)
+    const candidate = new Date(from.getTime());
+    // Advance to the next whole minute
+    candidate.setUTCSeconds(0, 0);
+    candidate.setUTCMinutes(candidate.getUTCMinutes() + 1);
+    const MAX_ITERATIONS = 365 * 24 * 60 * 2; // 2 years in minutes
+    for (let i = 0; i < MAX_ITERATIONS; i++) {
+        const min = candidate.getUTCMinutes();
+        const hour = candidate.getUTCHours();
+        const dom = candidate.getUTCDate();
+        const mon = candidate.getUTCMonth() + 1; // 1-12
+        const dow = candidate.getUTCDay(); // 0 (Sun) – 6 (Sat)
+        if (matchField(mField, min, 0, 59) &&
+            matchField(hField, hour, 0, 23) &&
+            matchField(monField, mon, 1, 12) &&
+            matchDayField(domField, dowField, dom, dow)) {
+            return candidate.getTime() - from.getTime();
+        }
+        candidate.setUTCMinutes(candidate.getUTCMinutes() + 1);
+    }
+    throw new Error(`No match found in 2 years for cron expression "${expression}"`);
+}
+/**
+ * Standard cron DOM/DOW logic:
+ * - If BOTH dom and dow are restricted (not `*`), either matching satisfies.
+ * - If only one is restricted, only that one must match.
+ * - If both are `*`, always matches.
+ */
+function matchDayField(domField, dowField, dom, dow) {
+    const domRestricted = domField !== "*";
+    const dowRestricted = dowField !== "*";
+    if (domRestricted && dowRestricted) {
+        return matchField(domField, dom, 1, 31) || matchField(dowField, dow, 0, 6);
+    }
+    if (domRestricted) {
+        return matchField(domField, dom, 1, 31);
+    }
+    if (dowRestricted) {
+        return matchField(dowField, dow, 0, 6);
+    }
+    return true;
+}
+function matchField(field, value, _min, _max) {
+    // Comma-separated list
+    const parts = field.split(",");
+    return parts.some((part) => matchPart(part.trim(), value, _min, _max));
+}
+function matchPart(part, value, min, max) {
+    // Wildcard
+    if (part === "*") {
+        return true;
+    }
+    // Step: */n or a-b/n
+    const slashIdx = part.indexOf("/");
+    if (slashIdx !== -1) {
+        const stepStr = part.slice(slashIdx + 1);
+        const step = parseInt(stepStr, 10);
+        if (Number.isNaN(step) || step <= 0) {
+            throw new Error(`Invalid step in cron field part "${part}"`);
+        }
+        const rangePart = part.slice(0, slashIdx);
+        let rangeStart = min;
+        let rangeEnd = max;
+        if (rangePart !== "*") {
+            const dashIdx = rangePart.indexOf("-");
+            if (dashIdx !== -1) {
+                rangeStart = parseInt(rangePart.slice(0, dashIdx), 10);
+                rangeEnd = parseInt(rangePart.slice(dashIdx + 1), 10);
+            }
+            else {
+                rangeStart = parseInt(rangePart, 10);
+                rangeEnd = max;
+            }
+        }
+        if (value < rangeStart || value > rangeEnd) {
+            return false;
+        }
+        return (value - rangeStart) % step === 0;
+    }
+    // Range: a-b
+    const dashIdx = part.indexOf("-");
+    if (dashIdx !== -1) {
+        const rangeStart = parseInt(part.slice(0, dashIdx), 10);
+        const rangeEnd = parseInt(part.slice(dashIdx + 1), 10);
+        return value >= rangeStart && value <= rangeEnd;
+    }
+    // Exact number
+    const num = parseInt(part, 10);
+    if (Number.isNaN(num)) {
+        throw new Error(`Invalid cron field part "${part}"`);
+    }
+    return value === num;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function noopRituals() {
+    return { stop() { } };
+}
+function defaultSetTimer(cb, ms) {
+    const handle = setTimeout(cb, ms);
+    return { unref: () => handle.unref() };
+}
+//# sourceMappingURL=memory-rituals.js.map

package/dist/memory-rituals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-rituals.js","sourceRoot":"","sources":["../src/memory-rituals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,uBAAuB,GAAG,WAAW,CAAC;AAC5C,MAAM,sBAAsB,GAAG,WAAW,CAAC;AAoC3C,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,MAAM,UAAU,kBAAkB,CAAC,KAA8B;IAC/D,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAEhC,mCAAmC;IACnC,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,WAAW,EAAE,CAAC;IACvB,CAAC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,eAAe,CAAC;IACnD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAkC,CAAC,CAAC,CAAC;IAEjG,MAAM,OAAO,GAA8C,EAAE,CAAC;IAC9D,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,SAAS,cAAc,CACrB,IAAY,EACZ,QAAgB,EAChB,GAA2B;QAE3B,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,aAAiD,CAAC;QAEtD,SAAS,QAAQ;YACf,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC;YACtB,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,GAAG,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,EAAE,IAAI,CACV,kBAAkB,IAAI,qCAAqC,QAAQ,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAC9I,CAAC;gBACF,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE;gBAC3B,6CAA6C;gBAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACpC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;oBACf,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBACzB,CAAC;gBACD,aAAa,GAAG,SAAS,CAAC;gBAE1B,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO;gBACT,CAAC;gBAED,IAAI,QAAQ,EAAE,CAAC;oBACb,0FAA0F;oBAC1F,uGAAuG;oBACvG,MAAM,EAAE,IAAI,CAAC,kBAAkB,IAAI,8CAA8C,CAAC,CAAC;oBACnF,OAAO;gBACT,CAAC;gBAED,QAAQ,GAAG,IAAI,CAAC;gBAChB,GAAG,EAAE;qBACF,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;oBACtB,MAAM,EAAE,IAAI,CACV,kBAAkB,IAAI,aAAa,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CACvF,CAAC;gBACJ,CAAC,CAAC;qBACD,OAAO,CAAC,GAAG,EAAE;oBACZ,QAAQ,GAAG,KAAK,CAAC;oBACjB,QAAQ,EAAE,CAAC;gBACb,CAAC,CAAC,CAAC;YACP,CAAC,EAAE,OAAO,CAAC,CAAC;YAEZ,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;YACjB,aAAa,GAAG,MAAM,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAED,QAAQ,EAAE,CAAC;QACX,KAAK,aAAa,CAAC,CAAC,yDAAyD;IAC/E,CAAC;IAED,6BAA6B;IAC7B,IAAI,KAAK,CAAC,UAAU,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,IAAI,uBAAuB,CAAC;QACnE,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,4BAA4B;IAC5B,IAAI,KAAK,CAAC,SAAS,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,EAAE,IAAI,IAAI,sBAAsB,CAAC;QACjE,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO;QACL,IAAI;YACF,OAAO,GAAG,IAAI,CAAC;YACf,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;oBACpB,UAAU,CAAC,CAAC,CAAC,CAAC;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,2CAA2C;AAC3C,8EAA8E;AAC9E,EAAE;AACF,kDAAkD;AAClD,uCAAuC;AACvC,+BAA+B;AAC/B,6CAA6C;AAC7C,yBAAyB;AACzB,wBAAwB;AACxB,mCAAmC;AACnC,EAAE;AACF,6DAA6D;AAC7D,2EAA2E;AAC3E,8EAA8E;AAE9E,SAAS,eAAe,CAAC,UAAkB,EAAE,IAAU;IACrD,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAMtD,CAAC;IAEF,qDAAqD;IACrD,kFAAkF;IAClF,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3C,mCAAmC;IACnC,SAAS,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC;IAEvD,MAAM,cAAc,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,qBAAqB;IAC/D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,SAAS,CAAC,aAAa,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO;QAChD,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,oBAAoB;QAEvD,IACE,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,EAC3C,CAAC;YACD,OAAO,SAAS,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9C,CAAC;QAED,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,kDAAkD,UAAU,GAAG,CAAC,CAAC;AACnF,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,QAAgB,EAAE,QAAgB,EAAE,GAAW,EAAE,GAAW;IACjF,MAAM,aAAa,GAAG,QAAQ,KAAK,GAAG,CAAC;IACvC,MAAM,aAAa,GAAG,QAAQ,KAAK,GAAG,CAAC;IAEvC,IAAI,aAAa,IAAI,aAAa,EAAE,CAAC;QACnC,OAAO,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,EAAE,KAAa,EAAE,IAAY,EAAE,IAAY;IAC1E,uBAAuB;IACvB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,KAAa,EAAE,GAAW,EAAE,GAAW;IACtE,WAAW;IACX,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qBAAqB;IACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,GAAG,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC1C,IAAI,UAAU,GAAG,GAAG,CAAC;QACrB,IAAI,QAAQ,GAAG,GAAG,CAAC;QACnB,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACvC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;gBACnB,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;gBACvD,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,UAAU,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBACrC,QAAQ,GAAG,GAAG,CAAC;YACjB,CAAC;QACH,CAAC;QACD,IAAI,KAAK,GAAG,UAAU,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;YAC3C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,aAAa;IACb,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;QACnB,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvD,OAAO,KAAK,IAAI,UAAU,IAAI,KAAK,IAAI,QAAQ,CAAC;IAClD,CAAC;IAED,eAAe;IACf,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,GAAG,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,KAAK,KAAK,GAAG,CAAC;AACvB,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,WAAW;IAClB,OAAO,EAAE,IAAI,KAAiB,CAAC,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,eAAe,CAAC,EAAc,EAAE,EAAU;IACjD,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAClC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;AACzC,CAAC"}

package/dist/sessions.d.ts

@@ -0,0 +1,21 @@
+import type { MonoAgentAppConfigInput } from "./app-config.js";
+export interface PurgeSessionsResult {
+    /** The resolved sessions root, or undefined when sessions are in-memory only. */
+    readonly root?: string;
+    /** True when an on-disk sessions store existed and was removed. */
+    readonly removed: boolean;
+    /** Count of removed `*.jsonl` session files (best-effort; 0 when none/unknown). */
+    readonly files: number;
+}
+/**
+ * Remove the durable pi-session store so the next start begins with fresh sessions
+ * instead of resuming persisted transcripts. A no-op (`removed: false`) when no
+ * on-disk store is configured (in-memory sessions) or the directory does not exist.
+ *
+ * The runtime recreates the directory on the next session, and the agent's durable
+ * memory lives elsewhere (`memory.path`), so this drops only resumable conversation
+ * transcripts — not the knowledge base. Stop the worker before calling this so it is
+ * not writing sessions while they are deleted.
+ */
+export declare function purgeSessions(input: MonoAgentAppConfigInput): Promise<PurgeSessionsResult>;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgBhG"}

package/dist/sessions.js

@@ -0,0 +1,45 @@
+import { readdir, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { resolveAppSessionsRoot } from "./app-config.js";
+/**
+ * Remove the durable pi-session store so the next start begins with fresh sessions
+ * instead of resuming persisted transcripts. A no-op (`removed: false`) when no
+ * on-disk store is configured (in-memory sessions) or the directory does not exist.
+ *
+ * The runtime recreates the directory on the next session, and the agent's durable
+ * memory lives elsewhere (`memory.path`), so this drops only resumable conversation
+ * transcripts — not the knowledge base. Stop the worker before calling this so it is
+ * not writing sessions while they are deleted.
+ */
+export async function purgeSessions(input) {
+    const root = await resolveAppSessionsRoot(input);
+    if (root === undefined) {
+        return { removed: false, files: 0 };
+    }
+    let files = 0;
+    try {
+        files = await countSessionFiles(root);
+    }
+    catch {
+        // The store may not exist yet; treat it as nothing to remove.
+        return { root, removed: false, files: 0 };
+    }
+    await rm(root, { recursive: true, force: true });
+    return { root, removed: true, files };
+}
+/** Recursively count `*.jsonl` session files under a sessions root. */
+async function countSessionFiles(dir) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    let total = 0;
+    for (const entry of entries) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            total += await countSessionFiles(full);
+        }
+        else if (entry.isFile() && entry.name.endsWith(".jsonl")) {
+            total += 1;
+        }
+    }
+    return total;
+}
+//# sourceMappingURL=sessions.js.map

package/dist/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAYzD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAA8B;IAChE,MAAM,IAAI,GAAG,MAAM,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACtC,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,8DAA8D;QAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACxC,CAAC;AAED,uEAAuE;AACvE,KAAK,UAAU,iBAAiB,CAAC,GAAW;IAC1C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,KAAK,IAAI,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3D,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/ui.d.ts

@@ -0,0 +1,54 @@
+import type { ValidationStatus } from "./doctor.js";
+/**
+ * Decide whether ANSI color should be emitted. `NO_COLOR` (any value) always
+ * wins per the no-color.org convention; `FORCE_COLOR` forces the decision when
+ * set to a recognized truthy/falsy value; otherwise color follows the TTY-ness
+ * of the stream. Pure and env-injected so it is trivially testable.
+ */
+export declare function computeColorEnabled(env: Record<string, string | undefined>, isTty: boolean | undefined): boolean;
+export declare function isColorEnabled(): boolean;
+/** Color/weight helpers. Each is the identity function when color is disabled. */
+export declare const style: {
+    readonly bold: (text: string) => string;
+    readonly dim: (text: string) => string;
+    readonly red: (text: string) => string;
+    readonly green: (text: string) => string;
+    readonly yellow: (text: string) => string;
+    readonly cyan: (text: string) => string;
+    readonly gray: (text: string) => string;
+};
+/**
+ * Render a status badge as a fixed-width prefix (badge + trailing space). With
+ * color on it is a green/yellow/dim/red glyph; with color off it falls back to
+ * an equal-width ASCII tag so columns still line up in plain output.
+ */
+export declare function badge(status: ValidationStatus): string;
+/**
+ * Render aligned `label  value` rows: labels are padded to the widest label so
+ * values line up, replacing the hand-tuned `padEnd` blocks. `indent` prefixes
+ * every row with that many spaces (used to nest rows under a section rule).
+ * Returns one string with a trailing newline per row (empty when there are no
+ * rows).
+ */
+export declare function keyValue(rows: ReadonlyArray<readonly [label: string, value: string]>, indent?: number): string;
+/**
+ * A horizontal section divider, optionally labeled — `── instance ────────`.
+ * Width tracks the terminal (read at call time so resizes are honored), capped
+ * for readability and falling back to a fixed width when stdout is not a TTY.
+ * Rendered dim/gray (identity when color is off); the label appears verbatim so
+ * it stays greppable. Always ends with a newline.
+ */
+export declare function rule(label?: string): string;
+/** Badge for a channel status *kind* string (running/waiting…/disabled/error). */
+export declare function channelBadge(kind: string): string;
+/** Badge for a trace-source health word (running/stale/stopped/…). */
+export declare function healthBadge(health: string): string;
+/** A bold/cyan section heading with a trailing newline. */
+export declare function heading(text: string): string;
+/** The CLI title block: bold title plus an optional dim subtitle. */
+export declare function banner(title: string, subtitle?: string): string;
+/** A red error line (✗ prefix) with a trailing newline — write to stderr. */
+export declare function errorLine(message: string): string;
+/** A dim hint line (→ prefix) with a trailing newline. */
+export declare function hint(message: string): string;
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAuBpD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,KAAK,EAAE,OAAO,GAAG,SAAS,GACzB,OAAO,CAYT;AAID,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAMD,kFAAkF;AAClF,eAAO,MAAM,KAAK;0BACH,MAAM,KAAG,MAAM;yBAChB,MAAM,KAAG,MAAM;yBACf,MAAM,KAAG,MAAM;2BACb,MAAM,KAAG,MAAM;4BACd,MAAM,KAAG,MAAM;0BACjB,MAAM,KAAG,MAAM;0BACf,MAAM,KAAG,MAAM;CACpB,CAAC;AAgBX;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAGtD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,EAC5D,MAAM,SAAI,GACT,MAAM,CASR;AAKD;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ3C;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAcjD;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWlD;AAED,2DAA2D;AAC3D,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,qEAAqE;AACrE,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,0DAA0D;AAC1D,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5C"}

package/dist/ui.js

@@ -0,0 +1,153 @@
+import process from "node:process";
+/**
+ * Tiny zero-dependency terminal styling layer for the CLI. Every helper returns
+ * a plain string, so callers can keep writing through `process.stdout.write` or
+ * the injected `deps.stdout`/`deps.stderr` sinks in background.ts. Color is a
+ * single global decision keyed on the REAL process stdout (see
+ * {@link computeColorEnabled}); when it is off — piped output, `NO_COLOR`, or a
+ * non-TTY test harness — every styling helper degrades to plain ASCII so logs
+ * and test assertions stay greppable.
+ */
+const ANSI = {
+    reset: "",
+    bold: "",
+    dim: "",
+    red: "",
+    green: "",
+    yellow: "",
+    cyan: "",
+    gray: "",
+};
+/**
+ * Decide whether ANSI color should be emitted. `NO_COLOR` (any value) always
+ * wins per the no-color.org convention; `FORCE_COLOR` forces the decision when
+ * set to a recognized truthy/falsy value; otherwise color follows the TTY-ness
+ * of the stream. Pure and env-injected so it is trivially testable.
+ */
+export function computeColorEnabled(env, isTty) {
+    if (env.NO_COLOR !== undefined) {
+        return false;
+    }
+    const force = env.FORCE_COLOR;
+    if (force === "1" || force === "true") {
+        return true;
+    }
+    if (force === "0" || force === "false") {
+        return false;
+    }
+    return Boolean(isTty);
+}
+const colorEnabled = computeColorEnabled(process.env, process.stdout.isTTY);
+export function isColorEnabled() {
+    return colorEnabled;
+}
+function paint(code, text) {
+    return colorEnabled ? `${code}${text}${ANSI.reset}` : text;
+}
+/** Color/weight helpers. Each is the identity function when color is disabled. */
+export const style = {
+    bold: (text) => paint(ANSI.bold, text),
+    dim: (text) => paint(ANSI.dim, text),
+    red: (text) => paint(ANSI.red, text),
+    green: (text) => paint(ANSI.green, text),
+    yellow: (text) => paint(ANSI.yellow, text),
+    cyan: (text) => paint(ANSI.cyan, text),
+    gray: (text) => paint(ANSI.gray, text),
+};
+const BADGES = {
+    ok: { glyph: "✓", paint: style.green, plain: "[ok]   " },
+    waiting: { glyph: "⚠", paint: style.yellow, plain: "[wait] " },
+    disabled: { glyph: "○", paint: style.dim, plain: "[off]  " },
+    error: { glyph: "✗", paint: style.red, plain: "[error]" },
+};
+/**
+ * Render a status badge as a fixed-width prefix (badge + trailing space). With
+ * color on it is a green/yellow/dim/red glyph; with color off it falls back to
+ * an equal-width ASCII tag so columns still line up in plain output.
+ */
+export function badge(status) {
+    const spec = BADGES[status];
+    return colorEnabled ? `${spec.paint(spec.glyph)} ` : `${spec.plain} `;
+}
+/**
+ * Render aligned `label  value` rows: labels are padded to the widest label so
+ * values line up, replacing the hand-tuned `padEnd` blocks. `indent` prefixes
+ * every row with that many spaces (used to nest rows under a section rule).
+ * Returns one string with a trailing newline per row (empty when there are no
+ * rows).
+ */
+export function keyValue(rows, indent = 0) {
+    if (rows.length === 0) {
+        return "";
+    }
+    const pad = " ".repeat(indent);
+    const width = rows.reduce((max, [label]) => Math.max(max, label.length), 0);
+    return rows
+        .map(([label, value]) => `${pad}${style.gray(label.padEnd(width))}  ${value}\n`)
+        .join("");
+}
+const RULE_FALLBACK_WIDTH = 44;
+const RULE_MAX_WIDTH = 72;
+/**
+ * A horizontal section divider, optionally labeled — `── instance ────────`.
+ * Width tracks the terminal (read at call time so resizes are honored), capped
+ * for readability and falling back to a fixed width when stdout is not a TTY.
+ * Rendered dim/gray (identity when color is off); the label appears verbatim so
+ * it stays greppable. Always ends with a newline.
+ */
+export function rule(label) {
+    const width = Math.min(process.stdout.columns ?? RULE_FALLBACK_WIDTH, RULE_MAX_WIDTH);
+    if (label === undefined) {
+        return `${style.gray("─".repeat(width))}\n`;
+    }
+    const prefix = `── ${label} `;
+    const fill = Math.max(0, width - prefix.length);
+    return `${style.gray(`${prefix}${"─".repeat(fill)}`)}\n`;
+}
+/** Badge for a channel status *kind* string (running/waiting…/disabled/error). */
+export function channelBadge(kind) {
+    if (kind === "running") {
+        return badge("ok");
+    }
+    if (kind.startsWith("waiting")) {
+        return badge("waiting");
+    }
+    if (kind === "disabled") {
+        return badge("disabled");
+    }
+    if (/error|fail|crash/u.test(kind)) {
+        return badge("error");
+    }
+    return badge("waiting");
+}
+/** Badge for a trace-source health word (running/stale/stopped/…). */
+export function healthBadge(health) {
+    switch (health) {
+        case "running":
+            return badge("ok");
+        case "stale":
+            return badge("waiting");
+        case "stopped":
+            return badge("disabled");
+        default:
+            return badge("error");
+    }
+}
+/** A bold/cyan section heading with a trailing newline. */
+export function heading(text) {
+    return `${style.bold(style.cyan(text))}\n`;
+}
+/** The CLI title block: bold title plus an optional dim subtitle. */
+export function banner(title, subtitle) {
+    const head = style.bold(style.cyan(title));
+    return subtitle === undefined ? `${head}\n` : `${head} ${style.dim(`— ${subtitle}`)}\n`;
+}
+/** A red error line (✗ prefix) with a trailing newline — write to stderr. */
+export function errorLine(message) {
+    return `${style.red(`✗ ${message}`)}\n`;
+}
+/** A dim hint line (→ prefix) with a trailing newline. */
+export function hint(message) {
+    return `${style.dim(`→ ${message}`)}\n`;
+}
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mono-agent/agent-app",
-  "version": "0.2.2",
-  "description": "Config-first mono-agent host: builds a responder and starts every configured communication channel, operator console, and traceability from one mono-agent.config.json.",
+  "version": "0.4.0",
+  "description": "Config-first mono-agent host: builds a responder and starts every configured communication channel and traceability from one mono-agent.config.json.",
   "type": "module",
   "license": "UNLICENSED",
   "private": false,
@@ -14,7 +14,8 @@
     }
   },
   "bin": {
-    "mono-agent": "./dist/cli.js"
+    "mono-agent": "./dist/cli.js",
+    "mono-agent-memory-recall": "./dist/memory-recall-main.js"
   },
   "files": [
     "dist",
@@ -22,20 +23,24 @@
     "README.md"
   ],
   "dependencies": {
-    "@mono-agent/a2a-adapter": "0.2.2",
-    "@mono-agent/agent-contracts": "0.2.2",
-    "@mono-agent/agent-host": "0.2.2",
-    "@mono-agent/config": "0.2.2",
-    "@mono-agent/cron-adapter": "0.2.2",
-    "@mono-agent/observability": "0.2.2",
-    "@mono-agent/openai-api-adapter": "0.2.2",
-    "@mono-agent/operator-console": "0.2.2",
-    "@mono-agent/runtime-adapter": "0.2.2",
-    "@mono-agent/settings": "0.2.2",
-    "@mono-agent/slack-adapter": "0.2.2",
-    "@mono-agent/telegram-adapter": "0.2.2",
-    "@mono-agent/webhook-adapter": "0.2.2",
-    "@mono-agent/whatsapp-adapter": "0.2.2"
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@mono-agent/a2a-adapter": "0.4.0",
+    "@mono-agent/agent-contracts": "0.4.0",
+    "@mono-agent/agent-host": "0.4.0",
+    "@mono-agent/config": "0.4.0",
+    "@mono-agent/cron-adapter": "0.4.0",
+    "@mono-agent/memory-bujo": "0.4.0",
+    "@mono-agent/memory-search": "0.4.0",
+    "@mono-agent/observability": "0.4.0",
+    "@mono-agent/observability-otel": "0.4.0",
+    "@mono-agent/openai-api-adapter": "0.4.0",
+    "@mono-agent/runtime-adapter": "0.4.0",
+    "@mono-agent/settings": "0.4.0",
+    "@mono-agent/slack-adapter": "0.4.0",
+    "@mono-agent/telegram-adapter": "0.4.0",
+    "@mono-agent/webhook-adapter": "0.4.0",
+    "@mono-agent/whatsapp-adapter": "0.4.0",
+    "zod": "^4.4.3"
   },
   "publishConfig": {
     "access": "public"