@oratis/lisa 0.7.0 → 0.9.0

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/mcp/config.d.ts

@@ -11,4 +11,8 @@ export interface McpConfig {
 }
 export declare function loadMcpConfig(): Promise<McpServerSpec[]>;
 export declare const MCP_CONFIG_PATH: string;
+/** Add or replace a server in mcp.json (upsert by name). Returns the spec. */
+export declare function saveMcpServer(name: string, spec: Omit<McpServerSpec, "name">): Promise<void>;
+/** Remove a server from mcp.json. Returns false if it wasn't there. */
+export declare function deleteMcpServer(name: string): Promise<boolean>;
 //# sourceMappingURL=config.d.ts.map

package/dist/mcp/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/mcp/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;CACzD;AAID,wBAAsB,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAkB9D;AAED,eAAO,MAAM,eAAe,QAAc,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/mcp/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;CACzD;AAID,wBAAsB,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAkB9D;AAED,eAAO,MAAM,eAAe,QAAc,CAAC;AAE3C,8EAA8E;AAC9E,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,uEAAuE;AACvE,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYpE"}

package/dist/mcp/config.js

@@ -25,4 +25,38 @@ export async function loadMcpConfig() {
     }));
 }
 export const MCP_CONFIG_PATH = CONFIG_PATH;
+/** Add or replace a server in mcp.json (upsert by name). Returns the spec. */
+export async function saveMcpServer(name, spec) {
+    let config = { mcpServers: {} };
+    if (await pathExists(CONFIG_PATH)) {
+        try {
+            config = JSON.parse(await fs.readFile(CONFIG_PATH, "utf8"));
+        }
+        catch {
+            // start fresh on a corrupt file rather than lose the add
+        }
+    }
+    if (!config.mcpServers)
+        config.mcpServers = {};
+    config.mcpServers[name] = spec;
+    await fs.mkdir(path.dirname(CONFIG_PATH), { recursive: true });
+    await fs.writeFile(CONFIG_PATH, JSON.stringify(config, null, 2));
+}
+/** Remove a server from mcp.json. Returns false if it wasn't there. */
+export async function deleteMcpServer(name) {
+    if (!(await pathExists(CONFIG_PATH)))
+        return false;
+    let config;
+    try {
+        config = JSON.parse(await fs.readFile(CONFIG_PATH, "utf8"));
+    }
+    catch {
+        return false;
+    }
+    if (!config.mcpServers || !(name in config.mcpServers))
+        return false;
+    delete config.mcpServers[name];
+    await fs.writeFile(CONFIG_PATH, JSON.stringify(config, null, 2));
+    return true;
+}
 //# sourceMappingURL=config.js.map

package/dist/mcp/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/mcp/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAe5C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAChD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACnD,IAAI,MAAiB,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC;IACxC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,mBAAmB,WAAW,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;IACxC,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI;QACJ,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;QACrB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,KAAK;KACrC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/mcp/config.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"}

package/dist/orchestrator/journal.js

@@ -0,0 +1,82 @@
+/**
+ * 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.
+ */
+const MAX_EVENTS = 400;
+const events = [];
+/** Compact, structural one-liner from a session's Tier-2 activity. */
+export function summarizeActivity(s) {
+    const a = s.activity;
+    if (!a)
+        return undefined;
+    const bits = [];
+    const tool = a.lastTools?.length ? a.lastTools[a.lastTools.length - 1] : "";
+    if (tool)
+        bits.push(tool);
+    if (a.lastCommandName)
+        bits.push("$" + a.lastCommandName);
+    const file = a.filesTouched?.length
+        ? a.filesTouched[a.filesTouched.length - 1].split("/").pop()
+        : "";
+    if (file)
+        bits.push(file);
+    return bits.length ? bits.join(" · ") : 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 function recordEvent(s, now = Date.now()) {
+    // Find the most recent event for this session.
+    let prev;
+    for (let i = events.length - 1; i >= 0; i--) {
+        if (events[i].sessionId === s.sessionId) {
+            prev = events[i];
+            break;
+        }
+    }
+    if (prev && prev.state === s.state && prev.stateReason === s.stateReason) {
+        return null; // no real transition
+    }
+    const ev = {
+        agent: s.agent,
+        sessionId: s.sessionId,
+        project: s.project,
+        cwd: s.cwd,
+        state: s.state,
+        stateReason: s.stateReason,
+        at: Number.isFinite(s.lastMtime) && s.lastMtime > 0 ? s.lastMtime : now,
+        activity: summarizeActivity(s),
+        error: s.activity?.lastError,
+    };
+    events.push(ev);
+    if (events.length > MAX_EVENTS)
+        events.splice(0, events.length - MAX_EVENTS);
+    return ev;
+}
+/** All recorded events (oldest → newest). */
+export function allEvents() {
+    return events.slice();
+}
+/** Events at or after `sinceMs` (epoch ms), oldest → newest. */
+export function eventsSince(sinceMs) {
+    return events.filter((e) => e.at >= sinceMs);
+}
+/** Test hook — wipe the buffer. */
+export function _resetJournalForTest() {
+    events.length = 0;
+}
+//# sourceMappingURL=journal.js.map

package/dist/orchestrator/journal.js.map

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

package/dist/orchestrator/recap.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Recap (L6) — synthesize the orchestrator journal into a cross-agent
+ * "while you were away" digest. Deterministic (no LLM): given the journal
+ * events in a time window, group by project, tally how each session ended,
+ * and surface the notable moments (errors, finishes, merged PRs, blocks).
+ *
+ * This is the narrative counterpart to the advisor's alerts and list_agents'
+ * roster: it answers "what happened, across everything, since I left?"
+ */
+import type { AgentEvent } from "./journal.js";
+export interface ProjectRecap {
+    project: string;
+    agents: string[];
+    /** Distinct sessions seen in the window. */
+    sessions: number;
+    finished: number;
+    errored: number;
+    active: number;
+    /** Up to a few file basenames touched. */
+    files: string[];
+    /** Human-readable notable lines for this project. */
+    notable: string[];
+}
+export interface Recap {
+    sinceMs: number;
+    now: number;
+    /** Distinct sessions that had any event in the window. */
+    totalSessions: number;
+    totalEvents: number;
+    projects: ProjectRecap[];
+    /** One-line headline. */
+    headline: string;
+}
+/** Build the structured recap from journal events in [sinceMs, now]. Pure. */
+export declare function buildRecap(events: AgentEvent[], sinceMs: number, now: number): Recap;
+/** Render the recap as a readable multi-line digest. Pure. */
+export declare function formatRecap(recap: Recap): string;
+//# sourceMappingURL=recap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recap.d.ts","sourceRoot":"","sources":["../../src/orchestrator/recap.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,qDAAqD;IACrD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAoBD,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,CA6GpF;AAED,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAShD"}