@oratis/lisa 0.5.0 → 0.8.0

package/dist/integrations/opencode/observer.js

@@ -0,0 +1,207 @@
+/**
+ * OpenCode observer (O3 — local CLI agent, SQLite-backed).
+ *
+ * Recent OpenCode (≥ ~1.15) stores sessions in a SQLite database at
+ *   $XDG_DATA_HOME/opencode/opencode.db   (≈ ~/.local/share/opencode/opencode.db)
+ * — not flat JSONL like Claude Code / Codex. So instead of tailing files this
+ * adapter POLLS the DB (read-only) via the system `sqlite3` CLI, which keeps us
+ * dependency-free (no sqlite npm package, and `node:sqlite` isn't available on
+ * the Node 20/22 we support).
+ *
+ * State is derived from the `session` row plus its newest `message`:
+ *   - session.time_archived set      → done
+ *   - session.time_compacting set    → working (compacting context)
+ *   - latest message has `error`     → error
+ *   - latest message role=assistant + time.completed set → waiting (it replied)
+ *   - latest message role=assistant, not completed       → working (mid-turn)
+ *   - latest message role=user                           → working (its turn)
+ *
+ * PRIVACY: only structural fields — session title, directory, token counts,
+ * message role/role-timing/error flag. Never message text or tool arguments.
+ * DISABLED by default; opt in via ~/.lisa/agents.json. Graceful no-op if
+ * `sqlite3` or the DB is absent (every read failure → empty, never throws).
+ */
+import os from "node:os";
+import path from "node:path";
+import { EventEmitter } from "node:events";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { registerIntegration } from "../registry.js";
+const pexec = promisify(execFile);
+const POLL_MS_DEFAULT = 60_000;
+const ACTIVE_WINDOW_MS_DEFAULT = 6 * 60 * 60_000; // 6h
+const MAX_LISTED = 12;
+function defaultDbPath(cfg) {
+    const home = cfg.home
+        ? cfg.home.replace(/^~/, os.homedir())
+        : process.env.XDG_DATA_HOME
+            ? path.join(process.env.XDG_DATA_HOME, "opencode")
+            : path.join(os.homedir(), ".local", "share", "opencode");
+    return path.join(home, "opencode.db");
+}
+/** Map one query row to the normalized session. Pure — the unit under test. */
+export function mapOpencodeSession(row) {
+    const directory = row.directory ?? undefined;
+    const lastMtime = typeof row.time_updated === "number" ? row.time_updated : 0;
+    let state;
+    let reason;
+    if (row.time_archived) {
+        state = "done";
+        reason = "archived";
+    }
+    else if (row.time_compacting) {
+        state = "working";
+        reason = "compacting";
+    }
+    else {
+        const msg = parseLastMessage(row.last_msg);
+        if (msg.error) {
+            state = "error";
+            reason = msg.errorReason ?? "error";
+        }
+        else if (msg.role === "assistant") {
+            state = msg.completed ? "waiting" : "working";
+            reason = msg.completed ? "assistant" : "assistant-streaming";
+        }
+        else if (msg.role === "user") {
+            state = "working";
+            reason = "user";
+        }
+        else {
+            state = "idle";
+            reason = "no-messages";
+        }
+    }
+    const title = (row.title ?? "").trim();
+    const project = directory ? path.basename(directory) : title || row.id;
+    const session = {
+        agent: "opencode",
+        sessionId: row.id,
+        project,
+        cwd: directory,
+        state,
+        stateReason: reason,
+        lastMtime,
+    };
+    const tin = row.tokens_input ?? 0;
+    const tout = row.tokens_output ?? 0;
+    if (tin || tout) {
+        session.activity = {
+            turnCount: 0,
+            lastTools: [],
+            filesTouched: [],
+            tokens: { input: tin, output: tout },
+        };
+    }
+    return session;
+}
+/** Tolerant parse of an OpenCode message `data` JSON blob. */
+export function parseLastMessage(raw) {
+    if (!raw)
+        return {};
+    let d;
+    try {
+        d = JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+    const role = typeof d.role === "string" ? d.role : undefined;
+    const time = (d.time ?? {});
+    const completed = time.completed != null && time.completed !== 0;
+    const err = d.error;
+    let error = false;
+    let errorReason;
+    if (err && typeof err === "object") {
+        error = true;
+        const m = err.data?.message;
+        errorReason =
+            typeof m === "string"
+                ? m.slice(0, 80)
+                : typeof err.name === "string"
+                    ? err.name
+                    : "error";
+    }
+    return { role, completed, error, errorReason };
+}
+const QUERY = "SELECT s.id AS id, s.directory AS directory, s.title AS title, s.agent AS agent, " +
+    "s.time_updated AS time_updated, s.time_archived AS time_archived, " +
+    "s.time_compacting AS time_compacting, s.tokens_input AS tokens_input, " +
+    "s.tokens_output AS tokens_output, " +
+    "(SELECT m.data FROM message m WHERE m.session_id = s.id ORDER BY m.time_created DESC LIMIT 1) AS last_msg " +
+    "FROM session s ORDER BY s.time_updated DESC LIMIT 40;";
+/** Read sessions from the OpenCode DB via the system sqlite3 CLI. [] on failure. */
+async function sqliteFetch(dbPath) {
+    try {
+        const { stdout } = await pexec("sqlite3", ["-json", "-readonly", dbPath, QUERY], {
+            maxBuffer: 16 * 1024 * 1024,
+            timeout: 15_000,
+        });
+        const s = stdout.trim();
+        if (!s)
+            return [];
+        return JSON.parse(s);
+    }
+    catch {
+        return []; // sqlite3 missing, db absent/locked, parse error — graceful no-op
+    }
+}
+export class OpencodeObserver extends EventEmitter {
+    agent = "opencode";
+    sessions = new Map();
+    timer = null;
+    emitFn = null;
+    fetcher;
+    pollMs;
+    windowMs;
+    now;
+    constructor(cfg) {
+        super();
+        const db = defaultDbPath(cfg);
+        this.fetcher = cfg.fetchRows ?? (() => sqliteFetch(db));
+        this.pollMs = typeof cfg.pollMs === "number" && cfg.pollMs > 0 ? cfg.pollMs : POLL_MS_DEFAULT;
+        this.windowMs =
+            typeof cfg.activeWindowMs === "number" && cfg.activeWindowMs > 0
+                ? cfg.activeWindowMs
+                : ACTIVE_WINDOW_MS_DEFAULT;
+        this.now = cfg.now ?? Date.now;
+    }
+    async start(emit) {
+        this.emitFn = emit;
+        await this.poll();
+        this.timer = setInterval(() => void this.poll(), this.pollMs);
+        this.timer.unref?.();
+    }
+    list() {
+        const cutoff = this.now() - this.windowMs;
+        return [...this.sessions.values()]
+            .filter((s) => s.lastMtime >= cutoff)
+            .sort((a, b) => b.lastMtime - a.lastMtime)
+            .slice(0, MAX_LISTED);
+    }
+    async stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+    }
+    /** One refresh cycle — exposed for deterministic tests. */
+    async poll() {
+        let rows;
+        try {
+            rows = await this.fetcher();
+        }
+        catch {
+            return;
+        }
+        for (const row of rows) {
+            const s = mapOpencodeSession(row);
+            const prev = this.sessions.get(s.sessionId);
+            this.sessions.set(s.sessionId, s);
+            if (this.emitFn && (!prev || prev.state !== s.state || prev.lastMtime !== s.lastMtime)) {
+                this.emitFn(s);
+            }
+        }
+    }
+}
+registerIntegration("opencode", (cfg) => new OpencodeObserver(cfg));
+//# sourceMappingURL=observer.js.map

package/dist/integrations/opencode/observer.js.map

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

package/dist/integrations/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/integrations/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAIpB,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAEN;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,aAAa,CAAC,CAUxB;AAED,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAEpD;AAED,yDAAyD;AACzD,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAKD,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAMjE"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/integrations/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAIpB,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAEN;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,aAAa,CAAC,CAUxB;AAED,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAEpD;AAED,yDAAyD;AACzD,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAKD,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAQjE"}

package/dist/integrations/registry.js

@@ -33,6 +33,8 @@ export async function registerBuiltinIntegrations() {
     builtinsRegistered = true;
     await import("./claude-code/observer.js");
     await import("./codex/observer.js");
-    // Additional adapters register here as they land (opencode, aider, …).
+    await import("./github-pr/observer.js");
+    await import("./opencode/observer.js");
+    await import("./aider/observer.js");
 }
 //# sourceMappingURL=registry.js.map

package/dist/integrations/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/integrations/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,SAAS,GAAG,IAAI,GAAG,EAAgC,CAAC;AAE1D,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,OAA6B;IAE7B,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,GAA2B;IAE3B,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,aAC1B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,mBAC7C,EAAE,CACH,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,yBAAyB;IACvC,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,kBAAkB,GAAG,KAAK,CAAC;AAC7B,CAAC;AAED,4DAA4D;AAC5D,wCAAwC;AACxC,IAAI,kBAAkB,GAAG,KAAK,CAAC;AAC/B,MAAM,CAAC,KAAK,UAAU,2BAA2B;IAC/C,IAAI,kBAAkB;QAAE,OAAO;IAC/B,kBAAkB,GAAG,IAAI,CAAC;IAC1B,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IAC1C,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACpC,uEAAuE;AACzE,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/integrations/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,SAAS,GAAG,IAAI,GAAG,EAAgC,CAAC;AAE1D,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,OAA6B;IAE7B,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,GAA2B;IAE3B,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,aAC1B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,mBAC7C,EAAE,CACH,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,yBAAyB;IACvC,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,kBAAkB,GAAG,KAAK,CAAC;AAC7B,CAAC;AAED,4DAA4D;AAC5D,wCAAwC;AACxC,IAAI,kBAAkB,GAAG,KAAK,CAAC;AAC/B,MAAM,CAAC,KAAK,UAAU,2BAA2B;IAC/C,IAAI,kBAAkB;QAAE,OAAO;IAC/B,kBAAkB,GAAG,IAAI,CAAC;IAC1B,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IAC1C,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACpC,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;IACxC,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IACvC,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;AACtC,CAAC"}

package/dist/integrations/scheduled-dispatch.d.ts

@@ -0,0 +1,42 @@
+export type ScheduledAgent = "claude" | "codex" | "opencode" | "aider";
+export interface ScheduledDispatch {
+    id: string;
+    agent: ScheduledAgent;
+    task: string;
+    cwd: string;
+    /** "every:30m" | "every:2h" | "every:1d" | "daily:09:00" */
+    schedule: string;
+    maxRuns: number;
+    runs: number;
+    lastRunAt?: number;
+    createdAt: number;
+}
+export declare const DEFAULT_MAX_RUNS = 30;
+export declare function loadScheduled(): Promise<ScheduledDispatch[]>;
+export declare function addScheduled(e: Omit<ScheduledDispatch, "id" | "runs" | "createdAt"> & {
+    createdAt?: number;
+}): Promise<ScheduledDispatch>;
+export declare function removeScheduled(id: string): Promise<boolean>;
+/** Persist run bookkeeping after a fire. */
+export declare function markRan(id: string, when: number): Promise<void>;
+export declare function isValidSchedule(schedule: string): boolean;
+/**
+ * Is this entry due to fire at `now`? Pure + testable.
+ * - capped: false once runs >= maxRuns
+ * - every:N — due when now - lastRunAt >= interval (or never run)
+ * - daily:HH:MM — due when now is past today's HH:MM and it hasn't run since
+ */
+export declare function isDue(e: ScheduledDispatch, now: number): boolean;
+/**
+ * Fire every due entry via the injected `launch` (dependency-injected so this
+ * module stays free of the tools layer and is testable). Marks each fired entry
+ * regardless of launch success, so a broken entry burns its run budget rather
+ * than retrying every tick. Returns one summary line per fire.
+ */
+export declare function fireDue(now: number, launch: (e: ScheduledDispatch) => Promise<{
+    pid?: number;
+    error?: string;
+}>): Promise<string[]>;
+/** Human description of an entry for listing. */
+export declare function describeScheduled(e: ScheduledDispatch): string;
+//# sourceMappingURL=scheduled-dispatch.d.ts.map

package/dist/integrations/scheduled-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-dispatch.d.ts","sourceRoot":"","sources":["../../src/integrations/scheduled-dispatch.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAMnC,wBAAsB,aAAa,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAQlE;AAMD,wBAAsB,YAAY,CAChC,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,MAAM,GAAG,WAAW,CAAC,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/E,OAAO,CAAC,iBAAiB,CAAC,CAW5B;AAED,wBAAsB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMlE;AAED,4CAA4C;AAC5C,wBAAsB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOrE;AAqBD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAoBhE;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1E,OAAO,CAAC,MAAM,EAAE,CAAC,CAenB;AAED,iDAAiD;AACjD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAI9D"}

package/dist/integrations/scheduled-dispatch.js

@@ -0,0 +1,140 @@
+/**
+ * Scheduled dispatches — a small persisted store of "launch agent X in repo Y
+ * with task Z on schedule S". The heartbeat runner checks it each tick and
+ * fires the due ones (see fireDueScheduledDispatches, called from the runner).
+ *
+ * Safety: this auto-launches autonomous agents unattended at heartbeat cadence,
+ * so each entry carries a maxRuns cap (default 30) and records its run count;
+ * once spent it's inert until the user removes/re-adds it.
+ */
+import { randomUUID } from "node:crypto";
+import path from "node:path";
+import { readFile } from "node:fs/promises";
+import { atomicWrite } from "../fs-utils.js";
+import { LISA_HOME } from "../paths.js";
+const FILE = path.join(LISA_HOME, "scheduled-dispatches.json");
+export const DEFAULT_MAX_RUNS = 30;
+export async function loadScheduled() {
+    try {
+        const raw = await readFile(FILE, "utf8");
+        const store = JSON.parse(raw);
+        return Array.isArray(store.entries) ? store.entries : [];
+    }
+    catch {
+        return [];
+    }
+}
+async function saveScheduled(entries) {
+    await atomicWrite(FILE, JSON.stringify({ entries }, null, 2));
+}
+export async function addScheduled(e) {
+    const entries = await loadScheduled();
+    const entry = {
+        ...e,
+        id: randomUUID().slice(0, 8),
+        runs: 0,
+        createdAt: e.createdAt ?? Date.now(),
+    };
+    entries.push(entry);
+    await saveScheduled(entries);
+    return entry;
+}
+export async function removeScheduled(id) {
+    const entries = await loadScheduled();
+    const next = entries.filter((e) => e.id !== id && !e.id.startsWith(id));
+    if (next.length === entries.length)
+        return false;
+    await saveScheduled(next);
+    return true;
+}
+/** Persist run bookkeeping after a fire. */
+export async function markRan(id, when) {
+    const entries = await loadScheduled();
+    const e = entries.find((x) => x.id === id);
+    if (!e)
+        return;
+    e.runs += 1;
+    e.lastRunAt = when;
+    await saveScheduled(entries);
+}
+/** Parse "every:<N><m|h|d>" → interval ms, or null if not that form. */
+function parseEvery(schedule) {
+    const m = schedule.match(/^every:(\d+)([mhd])$/i);
+    if (!m)
+        return null;
+    const n = parseInt(m[1], 10);
+    const unit = m[2].toLowerCase();
+    return n * (unit === "m" ? 60_000 : unit === "h" ? 3_600_000 : 86_400_000);
+}
+/** Parse "daily:HH:MM" → {h, m}, or null. */
+function parseDaily(schedule) {
+    const m = schedule.match(/^daily:(\d{1,2}):(\d{2})$/i);
+    if (!m)
+        return null;
+    const h = parseInt(m[1], 10);
+    const min = parseInt(m[2], 10);
+    if (h > 23 || min > 59)
+        return null;
+    return { h, m: min };
+}
+export function isValidSchedule(schedule) {
+    return parseEvery(schedule) !== null || parseDaily(schedule) !== null;
+}
+/**
+ * Is this entry due to fire at `now`? Pure + testable.
+ * - capped: false once runs >= maxRuns
+ * - every:N — due when now - lastRunAt >= interval (or never run)
+ * - daily:HH:MM — due when now is past today's HH:MM and it hasn't run since
+ */
+export function isDue(e, now) {
+    if (e.runs >= e.maxRuns)
+        return false;
+    const everyMs = parseEvery(e.schedule);
+    if (everyMs !== null) {
+        if (e.lastRunAt == null)
+            return true;
+        return now - e.lastRunAt >= everyMs;
+    }
+    const daily = parseDaily(e.schedule);
+    if (daily) {
+        const target = new Date(now);
+        target.setHours(daily.h, daily.m, 0, 0);
+        const targetMs = target.getTime();
+        if (now < targetMs)
+            return false; // today's time hasn't arrived
+        // Past today's target: due unless we already ran at/after it.
+        return e.lastRunAt == null || e.lastRunAt < targetMs;
+    }
+    return false; // unparseable schedule never fires
+}
+/**
+ * Fire every due entry via the injected `launch` (dependency-injected so this
+ * module stays free of the tools layer and is testable). Marks each fired entry
+ * regardless of launch success, so a broken entry burns its run budget rather
+ * than retrying every tick. Returns one summary line per fire.
+ */
+export async function fireDue(now, launch) {
+    const entries = await loadScheduled();
+    const fired = [];
+    for (const e of entries) {
+        if (!isDue(e, now))
+            continue;
+        let result;
+        try {
+            result = await launch(e);
+        }
+        catch (err) {
+            result = { error: err.message };
+        }
+        await markRan(e.id, now);
+        fired.push(`${e.agent} in ${e.cwd} — ${result.error ? "FAILED: " + result.error : "pid " + result.pid}`);
+    }
+    return fired;
+}
+/** Human description of an entry for listing. */
+export function describeScheduled(e) {
+    const last = e.lastRunAt ? new Date(e.lastRunAt).toISOString().slice(0, 16).replace("T", " ") : "never";
+    const task = e.task.length > 60 ? e.task.slice(0, 57) + "…" : e.task;
+    return `• ${e.id}  ${e.agent} @ ${e.schedule}  (${e.runs}/${e.maxRuns} runs, last ${last})\n    ${e.cwd}\n    "${task}"`;
+}
+//# sourceMappingURL=scheduled-dispatch.js.map

package/dist/integrations/scheduled-dispatch.js.map

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

package/dist/launchd.d.ts

@@ -0,0 +1,18 @@
+/** Escape a string for inclusion as XML text/attribute content in a plist. */
+export declare function escapeXml(s: string): string;
+/** Run a command, resolving stdout on exit 0 and rejecting otherwise. */
+export declare function runCmd(cmd: string, args: string[]): Promise<string>;
+/**
+ * Best-effort path to the `lisa` binary, used for the human-readable
+ * instructions line and the Linux service snippet. May return a "node <path>"
+ * form when only the local dist build is available.
+ */
+export declare function resolveLisaBin(): Promise<string>;
+/**
+ * Resolve the displayed binary into launchd ProgramArguments slots (one argv
+ * element per array entry). A "node <path>" form is split into two slots with
+ * an absolute node path so launchd — which has no shell and a minimal PATH —
+ * can exec it.
+ */
+export declare function resolveLisaArgv(displayedBin: string): Promise<string[]>;
+//# sourceMappingURL=launchd.d.ts.map

package/dist/launchd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launchd.d.ts","sourceRoot":"","sources":["../src/launchd.ts"],"names":[],"mappings":"AAQA,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3C;AAED,yEAAyE;AACzE,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAcnE;AAED;;;;GAIG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAYtD;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAO7E"}

package/dist/launchd.js

@@ -0,0 +1,60 @@
+/**
+ * Shared launchd / process helpers used by both the heartbeat scheduler and
+ * the login autostart installer. Kept dependency-free (node built-ins only).
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { spawn } from "node:child_process";
+/** Escape a string for inclusion as XML text/attribute content in a plist. */
+export function escapeXml(s) {
+    return s.replace(/[<>&"']/g, (c) => ({ "<": "&lt;", ">": "&gt;", "&": "&amp;", '"': "&quot;", "'": "&apos;" }[c]));
+}
+/** Run a command, resolving stdout on exit 0 and rejecting otherwise. */
+export function runCmd(cmd, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(cmd, args);
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (b) => (stdout += b.toString("utf8")));
+        child.stderr.on("data", (b) => (stderr += b.toString("utf8")));
+        child.on("error", reject);
+        child.on("close", (code) => code === 0
+            ? resolve(stdout)
+            : reject(new Error(`${cmd} exited ${code}: ${stderr.trim()}`)));
+    });
+}
+/**
+ * Best-effort path to the `lisa` binary, used for the human-readable
+ * instructions line and the Linux service snippet. May return a "node <path>"
+ * form when only the local dist build is available.
+ */
+export async function resolveLisaBin() {
+    try {
+        const out = await runCmd("which", ["lisa"]);
+        const trimmed = out.trim();
+        if (trimmed)
+            return trimmed;
+    }
+    catch { }
+    const here = path.resolve(process.cwd(), "dist", "cli.js");
+    try {
+        await fs.access(here);
+        return `node ${here}`;
+    }
+    catch { }
+    return "lisa";
+}
+/**
+ * Resolve the displayed binary into launchd ProgramArguments slots (one argv
+ * element per array entry). A "node <path>" form is split into two slots with
+ * an absolute node path so launchd — which has no shell and a minimal PATH —
+ * can exec it.
+ */
+export async function resolveLisaArgv(displayedBin) {
+    if (displayedBin.startsWith("node ")) {
+        const nodePath = (await runCmd("which", ["node"]).catch(() => "node")).trim() || "node";
+        return [nodePath, displayedBin.slice("node ".length)];
+    }
+    return [displayedBin];
+}
+//# sourceMappingURL=launchd.js.map

package/dist/launchd.js.map

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

package/dist/orchestrator/journal.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Orchestrator journal (L6) — a small temporal record of agent activity.
+ *
+ * The hub (L1) only holds a *live snapshot*; once a session goes idle/done it
+ * falls out of `hub.list()`. The advisor (L5) surfaces relevance-gated alerts.
+ * Neither answers "what actually happened across all my agents while I was
+ * away?" — which needs a record over *time*, including sessions that have since
+ * ended. This journal is that record: every meaningful state transition the hub
+ * emits is appended to a capped ring buffer, from which recap.ts synthesizes a
+ * cross-agent "while you were away" digest.
+ *
+ * In-memory + capped (no growth): a recap covers the current server's uptime,
+ * which is exactly the window the user was away *for*. PRIVACY: stores only the
+ * same structural metadata the hub emits (agent, project, state, tool/file
+ * names, error strings) — never prompts, replies, or file contents.
+ */
+import type { AgentSession, AgentSessionState } from "../integrations/types.js";
+export interface AgentEvent {
+    agent: string;
+    sessionId: string;
+    project: string;
+    cwd?: string;
+    state: AgentSessionState;
+    stateReason: string;
+    /** Epoch ms of the transition. */
+    at: number;
+    /** Compact structural activity summary (tool · file · $cmd), if any. */
+    activity?: string;
+    /** Short error string when the session errored. */
+    error?: string;
+}
+/** Compact, structural one-liner from a session's Tier-2 activity. */
+export declare function summarizeActivity(s: AgentSession): string | undefined;
+/**
+ * Append a transition. Consecutive events for the same session with the same
+ * state + reason are collapsed (we only record *changes*), so a session that
+ * sits in "working" for an hour produces one entry, not hundreds.
+ */
+export declare function recordEvent(s: AgentSession, now?: number): AgentEvent | null;
+/** All recorded events (oldest → newest). */
+export declare function allEvents(): AgentEvent[];
+/** Events at or after `sinceMs` (epoch ms), oldest → newest. */
+export declare function eventsSince(sinceMs: number): AgentEvent[];
+/** Test hook — wipe the buffer. */
+export declare function _resetJournalForTest(): void;
+//# sourceMappingURL=journal.d.ts.map

package/dist/orchestrator/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/orchestrator/journal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEhF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,iBAAiB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAYrE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,GAAE,MAAmB,GAAG,UAAU,GAAG,IAAI,CA0BxF;AAED,6CAA6C;AAC7C,wBAAgB,SAAS,IAAI,UAAU,EAAE,CAExC;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAEzD;AAED,mCAAmC;AACnC,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}