@oratis/lisa 0.7.0 → 0.9.0

package/dist/orchestrator/recap.js

@@ -0,0 +1,134 @@
+/**
+ * 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?"
+ */
+const FILES_PER_PROJECT = 6;
+function basename(p) {
+    return p.split("/").pop() || p;
+}
+/** Build the structured recap from journal events in [sinceMs, now]. Pure. */
+export function buildRecap(events, sinceMs, now) {
+    const inWindow = events.filter((e) => e.at >= sinceMs);
+    // Roll up per session (the latest meaningful state wins).
+    const sessions = new Map();
+    for (const e of inWindow) {
+        let r = sessions.get(e.sessionId);
+        if (!r) {
+            r = {
+                agent: e.agent,
+                project: e.project || "(unknown)",
+                lastState: e.state,
+                lastReason: e.stateReason,
+                lastAt: e.at,
+                files: new Set(),
+                errored: false,
+            };
+            sessions.set(e.sessionId, r);
+        }
+        if (e.at >= r.lastAt) {
+            r.lastState = e.state;
+            r.lastReason = e.stateReason;
+            r.lastAt = e.at;
+            if (e.activity)
+                r.lastActivity = e.activity;
+        }
+        if (e.state === "error") {
+            r.errored = true;
+            if (e.error || e.stateReason)
+                r.lastError = e.error || e.stateReason;
+        }
+        if (e.activity) {
+            // The activity summary's last token is often a file basename; cheap to keep.
+            const f = e.activity.split(" · ").find((t) => /\.[a-z0-9]+$/i.test(t));
+            if (f)
+                r.files.add(f);
+        }
+    }
+    // Group sessions by project.
+    const byProject = new Map();
+    for (const r of sessions.values()) {
+        const list = byProject.get(r.project) ?? [];
+        list.push(r);
+        byProject.set(r.project, list);
+    }
+    const projects = [];
+    let totalFinished = 0, totalErrored = 0, totalActive = 0;
+    for (const [project, rolls] of byProject) {
+        const agents = [...new Set(rolls.map((r) => r.agent))].sort();
+        let finished = 0, errored = 0, active = 0;
+        const files = new Set();
+        const notable = [];
+        for (const r of rolls) {
+            if (r.errored) {
+                errored++;
+                notable.push(`✗ ${r.agent} errored${r.lastError ? `: ${r.lastError}` : ""}`);
+            }
+            else if (r.lastState === "done") {
+                finished++;
+                notable.push(`✓ ${r.agent} finished${r.lastReason ? ` (${r.lastReason})` : ""}`);
+            }
+            else if (r.lastState === "working" || r.lastState === "waiting") {
+                active++;
+                if (r.lastState === "waiting" && r.lastReason)
+                    notable.push(`• ${r.agent} waiting — ${r.lastReason}`);
+            }
+            for (const f of r.files)
+                files.add(basename(f));
+        }
+        totalFinished += finished;
+        totalErrored += errored;
+        totalActive += active;
+        projects.push({
+            project,
+            agents,
+            sessions: rolls.length,
+            finished,
+            errored,
+            active,
+            files: [...files].slice(0, FILES_PER_PROJECT),
+            notable: notable.slice(0, 6),
+        });
+    }
+    // Errors first, then most sessions, then name.
+    projects.sort((a, b) => b.errored - a.errored || b.sessions - a.sessions || a.project.localeCompare(b.project));
+    const parts = [];
+    if (totalFinished)
+        parts.push(`${totalFinished} finished`);
+    if (totalErrored)
+        parts.push(`${totalErrored} errored`);
+    if (totalActive)
+        parts.push(`${totalActive} still going`);
+    const headline = sessions.size === 0
+        ? "No agent activity in this window."
+        : `${sessions.size} agent session${sessions.size === 1 ? "" : "s"} across ` +
+            `${projects.length} project${projects.length === 1 ? "" : "s"}` +
+            (parts.length ? ` — ${parts.join(", ")}.` : ".");
+    return {
+        sinceMs,
+        now,
+        totalSessions: sessions.size,
+        totalEvents: inWindow.length,
+        projects,
+        headline,
+    };
+}
+/** Render the recap as a readable multi-line digest. Pure. */
+export function formatRecap(recap) {
+    if (recap.totalSessions === 0)
+        return recap.headline;
+    const lines = [recap.headline, ""];
+    for (const p of recap.projects) {
+        lines.push(`${p.project} · ${p.agents.join(", ")}`);
+        for (const n of p.notable)
+            lines.push(`  ${n}`);
+        if (p.files.length)
+            lines.push(`  touched: ${p.files.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=recap.js.map

package/dist/orchestrator/recap.js.map

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

package/dist/screen_advisor/engine.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Screen advisor — periodic, opt-in screen-aware coaching.
+ *
+ * When enabled, the server captures a full-screen screenshot every N minutes,
+ * asks the model for the single best next coding step grounded in what's on
+ * screen, and pushes it to the Lisa Island as a suggestion card. Clicking it
+ * prefills the suggestion into the chat composer so the user can confirm before
+ * any coding agent is dispatched.
+ *
+ * PRIVACY (this is a sensitive capability — treat it as such):
+ *   - DISABLED by default. Nothing is captured until the user turns it on in
+ *     Settings.
+ *   - The screenshot only leaves the machine for the single analysis call to
+ *     the model the user already uses; the image is never persisted by LISA
+ *     (capture writes a temp PNG that the capture layer deletes), and only the
+ *     short text suggestion is kept in memory.
+ *   - The suggestion never auto-runs anything: clicking it only prefills chat.
+ *
+ * This module is provider-agnostic and side-effect-light so the parsing and
+ * config logic can be unit-tested without a real LLM or a real screen.
+ */
+export interface ScreenAdvisorConfig {
+    /** Master switch. Off by default — capture only happens when true. */
+    enabled: boolean;
+    /** Minutes between captures. Clamped to [MIN, MAX]. */
+    intervalMinutes: number;
+}
+export declare const DEFAULT_SCREEN_ADVISOR_CONFIG: ScreenAdvisorConfig;
+export declare const MIN_INTERVAL_MINUTES = 2;
+export declare const MAX_INTERVAL_MINUTES = 240;
+export declare const SCREEN_ADVISOR_CONFIG_PATH: string;
+/** Coerce arbitrary input into a valid config (clamped interval, boolean enabled). */
+export declare function normalizeConfig(raw: Partial<ScreenAdvisorConfig> | null | undefined): ScreenAdvisorConfig;
+export declare function loadScreenAdvisorConfig(p?: string): Promise<ScreenAdvisorConfig>;
+export declare function saveScreenAdvisorConfig(cfg: ScreenAdvisorConfig, p?: string): Promise<ScreenAdvisorConfig>;
+/** A single screen-grounded next-step suggestion. */
+export interface ScreenSuggestion {
+    /** ≤8-word imperative headline. */
+    title: string;
+    /** 1–2 sentences citing what was on screen. */
+    rationale: string;
+    /** Self-contained prompt a coding agent could act on. */
+    task: string;
+    /** ISO timestamp, stamped by the caller. */
+    at: string;
+}
+export declare const SCREEN_ADVISOR_SYSTEM = "You are Lisa's screen advisor. You are shown ONE screenshot of the user's screen. Suggest the single highest-value next CODING step, grounded in what is actually visible \u2014 an error, a failing test, a TODO/FIXME, an open file, a diff, a PR, a design. Be specific and actionable: prefer something a coding agent could pick up and finish.\n\nRespond with ONLY a compact JSON object \u2014 no prose, no markdown, no code fences:\n{\"title\":\"<=8-word imperative headline\",\"rationale\":\"1-2 sentences citing what you saw\",\"task\":\"a self-contained prompt for a coding agent: exactly what to do, and in which file/dir if visible\"}\n\nIf the screen shows nothing actionable for coding (a video, a chat, the desktop, unrelated browsing), respond with exactly: {\"skip\":true}";
+/**
+ * Tolerantly parse the model's reply into a suggestion. Strips code fences,
+ * extracts the first JSON object, and returns null for {"skip":true} or any
+ * malformed / incomplete reply (so the loop simply surfaces nothing).
+ */
+export declare function parseSuggestion(text: string | null | undefined): Omit<ScreenSuggestion, "at"> | null;
+/** Minimal provider surface the analyzer needs (keeps the engine testable). */
+export interface SuggestionProvider {
+    runTurn(opts: {
+        systemPrompt: string;
+        messages: Array<{
+            role: "user" | "assistant";
+            content: unknown;
+        }>;
+        tools: unknown[];
+        model: string;
+        maxTokens?: number;
+    }): Promise<{
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+    }>;
+}
+/** Run one screenshot through the model and parse the suggestion (or null). */
+export declare function analyzeScreenshot(opts: {
+    provider: SuggestionProvider;
+    model: string;
+    imageBase64: string;
+    mediaType?: string;
+}): Promise<Omit<ScreenSuggestion, "at"> | null>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/screen_advisor/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/screen_advisor/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,6BAA6B,EAAE,mBAG3C,CAAC;AAEF,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,eAAO,MAAM,0BAA0B,QAA8C,CAAC;AAEtF,sFAAsF;AACtF,wBAAgB,eAAe,CAC7B,GAAG,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI,GAAG,SAAS,GACnD,mBAAmB,CAQrB;AAED,wBAAsB,uBAAuB,CAC3C,CAAC,GAAE,MAAmC,GACrC,OAAO,CAAC,mBAAmB,CAAC,CAO9B;AAED,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,mBAAmB,EACxB,CAAC,GAAE,MAAmC,GACrC,OAAO,CAAC,mBAAmB,CAAC,CAK9B;AAED,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,eAAO,MAAM,qBAAqB,ixBAKwG,CAAC;AAE3I;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,GAAG,IAAI,CAwBpG;AAED,+EAA+E;AAC/E,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,IAAI,EAAE;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;YAAC,OAAO,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QAClE,KAAK,EAAE,OAAO,EAAE,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CAClE;AAED,+EAA+E;AAC/E,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAyB/C"}

package/dist/screen_advisor/engine.js

@@ -0,0 +1,128 @@
+/**
+ * Screen advisor — periodic, opt-in screen-aware coaching.
+ *
+ * When enabled, the server captures a full-screen screenshot every N minutes,
+ * asks the model for the single best next coding step grounded in what's on
+ * screen, and pushes it to the Lisa Island as a suggestion card. Clicking it
+ * prefills the suggestion into the chat composer so the user can confirm before
+ * any coding agent is dispatched.
+ *
+ * PRIVACY (this is a sensitive capability — treat it as such):
+ *   - DISABLED by default. Nothing is captured until the user turns it on in
+ *     Settings.
+ *   - The screenshot only leaves the machine for the single analysis call to
+ *     the model the user already uses; the image is never persisted by LISA
+ *     (capture writes a temp PNG that the capture layer deletes), and only the
+ *     short text suggestion is kept in memory.
+ *   - The suggestion never auto-runs anything: clicking it only prefills chat.
+ *
+ * This module is provider-agnostic and side-effect-light so the parsing and
+ * config logic can be unit-tested without a real LLM or a real screen.
+ */
+import fsp from "node:fs/promises";
+import path from "node:path";
+import { LISA_HOME } from "../paths.js";
+export const DEFAULT_SCREEN_ADVISOR_CONFIG = {
+    enabled: false,
+    intervalMinutes: 10,
+};
+export const MIN_INTERVAL_MINUTES = 2;
+export const MAX_INTERVAL_MINUTES = 240;
+export const SCREEN_ADVISOR_CONFIG_PATH = path.join(LISA_HOME, "screen-advisor.json");
+/** Coerce arbitrary input into a valid config (clamped interval, boolean enabled). */
+export function normalizeConfig(raw) {
+    const enabled = raw?.enabled === true;
+    let n = Number(raw?.intervalMinutes);
+    if (!Number.isFinite(n))
+        n = DEFAULT_SCREEN_ADVISOR_CONFIG.intervalMinutes;
+    n = Math.round(n);
+    if (n < MIN_INTERVAL_MINUTES)
+        n = MIN_INTERVAL_MINUTES;
+    if (n > MAX_INTERVAL_MINUTES)
+        n = MAX_INTERVAL_MINUTES;
+    return { enabled, intervalMinutes: n };
+}
+export async function loadScreenAdvisorConfig(p = SCREEN_ADVISOR_CONFIG_PATH) {
+    try {
+        const raw = JSON.parse(await fsp.readFile(p, "utf8"));
+        return normalizeConfig(raw);
+    }
+    catch {
+        return { ...DEFAULT_SCREEN_ADVISOR_CONFIG };
+    }
+}
+export async function saveScreenAdvisorConfig(cfg, p = SCREEN_ADVISOR_CONFIG_PATH) {
+    const norm = normalizeConfig(cfg);
+    await fsp.mkdir(path.dirname(p), { recursive: true });
+    await fsp.writeFile(p, JSON.stringify(norm, null, 2));
+    return norm;
+}
+export const SCREEN_ADVISOR_SYSTEM = `You are Lisa's screen advisor. You are shown ONE screenshot of the user's screen. Suggest the single highest-value next CODING step, grounded in what is actually visible — an error, a failing test, a TODO/FIXME, an open file, a diff, a PR, a design. Be specific and actionable: prefer something a coding agent could pick up and finish.
+
+Respond with ONLY a compact JSON object — no prose, no markdown, no code fences:
+{"title":"<=8-word imperative headline","rationale":"1-2 sentences citing what you saw","task":"a self-contained prompt for a coding agent: exactly what to do, and in which file/dir if visible"}
+
+If the screen shows nothing actionable for coding (a video, a chat, the desktop, unrelated browsing), respond with exactly: {"skip":true}`;
+/**
+ * Tolerantly parse the model's reply into a suggestion. Strips code fences,
+ * extracts the first JSON object, and returns null for {"skip":true} or any
+ * malformed / incomplete reply (so the loop simply surfaces nothing).
+ */
+export function parseSuggestion(text) {
+    if (!text)
+        return null;
+    let s = text.trim();
+    // Drop a leading ```json / ``` fence and a trailing fence if present.
+    s = s.replace(/^```[a-zA-Z]*\s*/, "").replace(/\s*```$/, "").trim();
+    const a = s.indexOf("{");
+    const b = s.lastIndexOf("}");
+    if (a < 0 || b <= a)
+        return null;
+    let obj;
+    try {
+        obj = JSON.parse(s.slice(a, b + 1));
+    }
+    catch {
+        return null;
+    }
+    if (obj.skip === true)
+        return null;
+    const title = typeof obj.title === "string" ? obj.title.trim() : "";
+    const task = typeof obj.task === "string" ? obj.task.trim() : "";
+    if (!title || !task)
+        return null;
+    const rationale = typeof obj.rationale === "string" ? obj.rationale.trim() : "";
+    return {
+        title: title.slice(0, 120),
+        rationale: rationale.slice(0, 400),
+        task: task.slice(0, 2000),
+    };
+}
+/** Run one screenshot through the model and parse the suggestion (or null). */
+export async function analyzeScreenshot(opts) {
+    const result = await opts.provider.runTurn({
+        systemPrompt: SCREEN_ADVISOR_SYSTEM,
+        messages: [
+            {
+                role: "user",
+                content: [
+                    { type: "text", text: "Here is my screen right now. What is the single best next coding step?" },
+                    {
+                        type: "image",
+                        source: {
+                            type: "base64",
+                            media_type: opts.mediaType ?? "image/png",
+                            data: opts.imageBase64,
+                        },
+                    },
+                ],
+            },
+        ],
+        tools: [],
+        model: opts.model,
+        maxTokens: 600,
+    });
+    const textBlock = result.content.find((b) => b.type === "text");
+    return parseSuggestion(textBlock?.text ?? "");
+}
+//# sourceMappingURL=engine.js.map

package/dist/screen_advisor/engine.js.map

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

package/dist/soul/lock.d.ts

@@ -9,10 +9,13 @@
  *   - lose a desire-progress append (read-modify-write race), or
  *   - collide on .git/index.lock (one commit fails).
  *
- * withFileLock implements a portable advisory mutex via exclusive file
- * creation (`open(..., "wx")` succeeds only if the file doesn't exist). It
- * self-heals from a crashed holder via a staleness timeout + a best-effort
- * liveness check on the recorded pid.
+ * withFileLock implements a portable advisory mutex by writing the lock body to
+ * a private temp file and then `link()`-ing it into place — link() fails if the
+ * target exists, so the lock is created exclusively AND already holds its full
+ * content (no window where a contender can read a half-written file and mistake
+ * it for stale). It self-heals from a crashed holder via a staleness timeout +
+ * a best-effort liveness check on the recorded pid, stealing atomically by
+ * renaming the stale file away so racing contenders can't clobber each other.
  */
 export interface FileLockOpts {
     /** Treat a held lock as abandoned after this many ms (crashed holder). */

package/dist/soul/lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/soul/lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAoCD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,CAAC,CAAC,CAmCZ;AAED,0CAA0C;AAC1C,eAAO,MAAM,cAAc,QAAqC,CAAC;AAEjE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAErF"}
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/soul/lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAyCD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,CAAC,CAAC,CAkDZ;AAED,0CAA0C;AAC1C,eAAO,MAAM,cAAc,QAAqC,CAAC;AAEjE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAErF"}

package/dist/soul/lock.js

@@ -9,10 +9,13 @@
  *   - lose a desire-progress append (read-modify-write race), or
  *   - collide on .git/index.lock (one commit fails).
  *
- * withFileLock implements a portable advisory mutex via exclusive file
- * creation (`open(..., "wx")` succeeds only if the file doesn't exist). It
- * self-heals from a crashed holder via a staleness timeout + a best-effort
- * liveness check on the recorded pid.
+ * withFileLock implements a portable advisory mutex by writing the lock body to
+ * a private temp file and then `link()`-ing it into place — link() fails if the
+ * target exists, so the lock is created exclusively AND already holds its full
+ * content (no window where a contender can read a half-written file and mistake
+ * it for stale). It self-heals from a crashed holder via a staleness timeout +
+ * a best-effort liveness check on the recorded pid, stealing atomically by
+ * renaming the stale file away so racing contenders can't clobber each other.
  */
 import fsp from "node:fs/promises";
 import path from "node:path";
@@ -28,7 +31,13 @@ async function isStale(lockPath, staleMs) {
     try {
         body = JSON.parse(await fsp.readFile(lockPath, "utf8"));
     }
-    catch {
+    catch (e) {
+        // The file vanished between the failed create and our read — the holder
+        // released it. There's nothing to steal; let the caller retry the create
+        // race. (Treating this as "stale" would race a concurrent acquirer into an
+        // unconditional rm that could delete a *different* holder's fresh lock.)
+        if (e.code === "ENOENT")
+            return false;
         // Unreadable / malformed lock file → treat as stale so we can recover.
         return true;
     }
@@ -58,22 +67,37 @@ export async function withFileLock(lockPath, fn, opts = {}) {
     const deadline = Date.now() + timeoutMs;
     // ── acquire ──
     for (;;) {
+        // Write the lock body to a private temp file first, then atomically link it
+        // into place. link() fails with EEXIST if the lock already exists, so
+        // exclusive creation and "the lock file always has complete content" hold
+        // simultaneously — a contender can never observe a half-written lock and
+        // mistake it for malformed/stale. The temp name is unique per attempt so
+        // concurrent acquirers in the *same* process don't clobber each other.
+        const tmp = `${lockPath}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
         try {
-            const fh = await fsp.open(lockPath, "wx");
+            await fsp.writeFile(tmp, JSON.stringify({ pid: process.pid, ts: Date.now() }));
             try {
-                await fh.writeFile(JSON.stringify({ pid: process.pid, ts: Date.now() }));
+                await fsp.link(tmp, lockPath);
             }
             finally {
-                await fh.close();
+                await fsp.rm(tmp, { force: true }).catch(() => { });
             }
             break; // acquired
         }
         catch (e) {
+            await fsp.rm(tmp, { force: true }).catch(() => { });
             if (e.code !== "EEXIST")
                 throw e;
             // Held by someone. Steal if stale, else wait.
             if (await isStale(lockPath, staleMs)) {
-                await fsp.rm(lockPath, { force: true }).catch(() => { });
+                // Steal atomically: rename the stale file to a unique name so only one
+                // contender can claim it. Losers get ENOENT and just retry the link
+                // race — nobody unconditionally rm's a path that may already hold a
+                // fresh lock from a concurrent acquirer.
+                await fsp
+                    .rename(lockPath, tmp)
+                    .then(() => fsp.rm(tmp, { force: true }))
+                    .catch(() => { });
                 continue; // retry immediately
             }
             if (Date.now() >= deadline) {

package/dist/soul/lock.js.map

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

package/dist/tools/agent_recap.d.ts

@@ -0,0 +1,21 @@
+/**
+ * agent_recap (L6) — the cross-agent "while you were away" digest.
+ *
+ * Answers "what happened across all my agents since I left?" by synthesizing
+ * the orchestrator journal (every observed session's state transitions over
+ * time) into a readable, project-grouped recap: who ran where, what finished,
+ * what errored, what's still going. Complements advise_now (relevance-gated
+ * alerts, now) and list_agents (the current roster) with the temporal story —
+ * including sessions that have since ended and dropped out of the live list.
+ *
+ * Structural metadata only (agent, project, state, tool/file names, errors) —
+ * never prompts, replies, or file contents. Read-only.
+ */
+import type { ToolDefinition } from "../types.js";
+interface RecapInput {
+    /** Look back this many minutes (default 120, clamped 1–1440). */
+    sinceMinutes?: number;
+}
+export declare const agentRecapTool: ToolDefinition<RecapInput, string>;
+export {};
+//# sourceMappingURL=agent_recap.d.ts.map

package/dist/tools/agent_recap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent_recap.d.ts","sourceRoot":"","sources":["../../src/tools/agent_recap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,UAAU,UAAU;IAClB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,UAAU,EAAE,MAAM,CA2B7D,CAAC"}

package/dist/tools/agent_recap.js

@@ -0,0 +1,43 @@
+/**
+ * agent_recap (L6) — the cross-agent "while you were away" digest.
+ *
+ * Answers "what happened across all my agents since I left?" by synthesizing
+ * the orchestrator journal (every observed session's state transitions over
+ * time) into a readable, project-grouped recap: who ran where, what finished,
+ * what errored, what's still going. Complements advise_now (relevance-gated
+ * alerts, now) and list_agents (the current roster) with the temporal story —
+ * including sessions that have since ended and dropped out of the live list.
+ *
+ * Structural metadata only (agent, project, state, tool/file names, errors) —
+ * never prompts, replies, or file contents. Read-only.
+ */
+import { eventsSince } from "../orchestrator/journal.js";
+import { buildRecap, formatRecap } from "../orchestrator/recap.js";
+export const agentRecapTool = {
+    name: "agent_recap",
+    description: "Summarize what happened across ALL the coding agents LISA observes (Claude Code, " +
+        "Codex, OpenCode, Aider, GitHub PRs) over a recent time window — the cross-agent " +
+        '"while you were away" recap. Use when the user asks what their agents did, what ' +
+        "happened since they were gone, or for an end-of-session wrap-up. Groups by project " +
+        "and reports what finished, errored, or is still running. Structural metadata only — " +
+        "never conversation content. Read-only.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sinceMinutes: {
+                type: "number",
+                description: "Window to look back over, in minutes (default 120; max 1440).",
+            },
+        },
+        additionalProperties: false,
+    },
+    async execute(input) {
+        const mins = Math.max(1, Math.min(1440, Math.round(input.sinceMinutes ?? 120)));
+        const now = Date.now();
+        const sinceMs = now - mins * 60_000;
+        const recap = buildRecap(eventsSince(sinceMs), sinceMs, now);
+        const window = mins >= 60 ? `${Math.round(mins / 60)}h` : `${mins}m`;
+        return `Cross-agent recap (last ${window}):\n${formatRecap(recap)}`;
+    },
+};
+//# sourceMappingURL=agent_recap.js.map

package/dist/tools/agent_recap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent_recap.js","sourceRoot":"","sources":["../../src/tools/agent_recap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAOnE,MAAM,CAAC,MAAM,cAAc,GAAuC;IAChE,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,mFAAmF;QACnF,kFAAkF;QAClF,kFAAkF;QAClF,qFAAqF;QACrF,sFAAsF;QACtF,wCAAwC;IAC1C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+DAA+D;aAC7E;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,GAAG,MAAM,CAAC;QACpC,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;QACrE,OAAO,2BAA2B,MAAM,OAAO,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;IACtE,CAAC;CACF,CAAC"}

package/dist/tools/compare_agents.d.ts

@@ -0,0 +1,16 @@
+import type { ToolDefinition } from "../types.js";
+import { type ComparisonJob, type ComparisonEntry, type CompareAgentKind } from "../integrations/comparisons.js";
+interface CompareInput {
+    action?: "start" | "status" | "collect" | "cleanup" | "list";
+    task?: string;
+    agents?: CompareAgentKind[];
+    cwd?: string;
+    id?: string;
+}
+/** Pure: one line summarising an entry's live status. Exported for tests. */
+export declare function formatStatusLine(e: ComparisonEntry, state: string | null, changed: number): string;
+/** Pure: header line for a job. Exported for tests. */
+export declare function formatJobHeader(j: ComparisonJob): string;
+export declare const compareAgentsTool: ToolDefinition<CompareInput, string>;
+export {};
+//# sourceMappingURL=compare_agents.d.ts.map

package/dist/tools/compare_agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare_agents.d.ts","sourceRoot":"","sources":["../../src/tools/compare_agents.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,OAAO,EAOL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,gCAAgC,CAAC;AAExC,UAAU,YAAY;IACpB,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIlG;AAED,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAGxD;AAOD,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,YAAY,EAAE,MAAM,CA8GlE,CAAC"}