@oratis/lisa 0.7.0 → 0.8.0

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"}

package/dist/tools/compare_agents.js

@@ -0,0 +1,145 @@
+/**
+ * compare_agents (vibe-coding, workflow form) — run the SAME task across two or
+ * more agents and compare what each produced, so you can pick the best result.
+ *
+ * It's a workflow, not a one-shot, because agents run for minutes:
+ *   start   → make an isolated git worktree per agent (off the repo, so they
+ *             don't clobber each other), launch each agent on the task, record
+ *             the job. Returns immediately.
+ *   status  → for each agent: live session state + how many files it has changed.
+ *   collect → diff stat per agent's worktree, side by side, so you choose.
+ *   cleanup → remove the worktrees + scratch branches once you've picked.
+ *   list    → existing comparison jobs.
+ */
+import path from "node:path";
+import { mkdir } from "node:fs/promises";
+import { getCurrentHub } from "../integrations/current-hub.js";
+import { launchAgent } from "./dispatch_agent.js";
+import { runIn, gitRoot } from "./exec-util.js";
+import { loadComparisons, addComparison, getComparison, removeComparison, newJobId, COMPARE_ROOT, } from "../integrations/comparisons.js";
+/** Pure: one line summarising an entry's live status. Exported for tests. */
+export function formatStatusLine(e, state, changed) {
+    if (e.launchError)
+        return `  ${e.agent}: failed to launch — ${e.launchError}`;
+    const st = state ?? "no session yet";
+    return `  ${e.agent}: ${st} · ${changed} file(s) changed  [${e.branch}]`;
+}
+/** Pure: header line for a job. Exported for tests. */
+export function formatJobHeader(j) {
+    const task = j.task.length > 70 ? j.task.slice(0, 67) + "…" : j.task;
+    return `compare ${j.id} (${j.entries.length} agents) in ${j.repo}\n  task: "${task}"`;
+}
+async function changedCount(worktree, signal) {
+    const r = await runIn(worktree, "git", ["-C", worktree, "status", "--porcelain"], { timeoutMs: 8000, signal });
+    return r.code === 0 ? r.stdout.split("\n").filter((l) => l.trim()).length : 0;
+}
+export const compareAgentsTool = {
+    name: "compare_agents",
+    description: "Run the same task across multiple agents in isolated git worktrees and compare results — a " +
+        "workflow (agents run for minutes): action:'start' (task + agents, default [claude,codex]) launches " +
+        "them; 'status' (id) shows each one's live state + files changed; 'collect' (id) diffs each result " +
+        "side by side so you pick a winner; 'cleanup' (id) removes the worktrees; 'list' shows jobs. Use when " +
+        "the user wants to try an approach two ways, or isn't sure which agent does better. Spawns agents.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            action: { type: "string", enum: ["start", "status", "collect", "cleanup", "list"] },
+            task: { type: "string", description: "The shared task to give every agent (for start).", minLength: 1 },
+            agents: { type: "array", items: { type: "string", enum: ["claude", "codex", "opencode", "aider"] }, description: "Agents to compare (for start). Default [claude, codex]." },
+            cwd: { type: "string", description: "Absolute path in the repo to branch worktrees from (for start). Defaults to current dir." },
+            id: { type: "string", description: "Comparison job id (for status/collect/cleanup)." },
+        },
+        additionalProperties: false,
+    },
+    async execute(input, ctx) {
+        const action = input.action ?? "start";
+        if (action === "list") {
+            const jobs = await loadComparisons();
+            if (jobs.length === 0)
+                return "(no comparison jobs)";
+            return jobs.map(formatJobHeader).join("\n\n");
+        }
+        if (action === "start") {
+            const task = input.task?.trim();
+            if (!task)
+                return "(start needs a task)";
+            const agents = input.agents && input.agents.length ? Array.from(new Set(input.agents)) : ["claude", "codex"];
+            if (agents.length < 2)
+                return "(comparing needs at least 2 agents)";
+            const cwd = input.cwd && input.cwd.startsWith("/") ? input.cwd : ctx.cwd;
+            const repo = await gitRoot(cwd, ctx.signal);
+            if (!repo)
+                return `(not a git repo: ${cwd} — compare_agents isolates each agent in a git worktree)`;
+            const id = newJobId();
+            await mkdir(path.join(COMPARE_ROOT, id), { recursive: true });
+            const entries = [];
+            for (const agent of agents) {
+                const branch = `lisa-compare/${id}-${agent}`;
+                const worktree = path.join(COMPARE_ROOT, id, agent);
+                const wt = await runIn(repo, "git", ["-C", repo, "worktree", "add", "-b", branch, worktree, "HEAD"], { timeoutMs: 20000, signal: ctx.signal });
+                if (wt.code !== 0) {
+                    entries.push({ agent, worktree, branch, launchError: `worktree add failed: ${wt.stderr.trim().slice(0, 120)}` });
+                    continue;
+                }
+                const r = await launchAgent(agent, task, worktree, ctx.log);
+                entries.push({ agent, worktree, branch, pid: r.pid, launchError: r.error });
+            }
+            const job = { id, task, repo, createdAt: Date.now(), entries };
+            await addComparison(job);
+            const launched = entries.filter((e) => !e.launchError).map((e) => e.agent);
+            const failed = entries.filter((e) => e.launchError);
+            return (`Started comparison ${id}: ${launched.join(" vs ")} on the same task in ${repo}.\n` +
+                entries.map((e) => `  ${e.agent} → ${e.launchError ? "FAILED: " + e.launchError : "pid " + e.pid + " in " + e.worktree}`).join("\n") +
+                (failed.length ? "" : "") +
+                `\n\nThey run in the background. Check progress with compare_agents action:'status' id:'${id}', ` +
+                `then action:'collect' id:'${id}' to diff the results, and 'cleanup' when done.`);
+        }
+        // status / collect / cleanup need a job
+        if (!input.id)
+            return `(${action} needs an id — from compare_agents action:'list')`;
+        const job = await getComparison(input.id);
+        if (!job)
+            return `(no comparison job matches "${input.id}")`;
+        if (action === "status") {
+            const hub = getCurrentHub();
+            const lines = [formatJobHeader(job)];
+            for (const e of job.entries) {
+                const session = hub?.list().find((s) => s.cwd === e.worktree);
+                const changed = await changedCount(e.worktree, ctx.signal);
+                lines.push(formatStatusLine(e, session ? session.state : null, changed));
+            }
+            return lines.join("\n");
+        }
+        if (action === "collect") {
+            const lines = [formatJobHeader(job), ""];
+            for (const e of job.entries) {
+                if (e.launchError) {
+                    lines.push(`── ${e.agent}: (didn't launch: ${e.launchError})`);
+                    continue;
+                }
+                const stat = await runIn(e.worktree, "git", ["-C", e.worktree, "diff", "HEAD", "--stat"], { timeoutMs: 10000, signal: ctx.signal });
+                // diff HEAD misses untracked new files — list those separately so a
+                // brand-new file an agent created isn't invisible in the comparison.
+                const st = await runIn(e.worktree, "git", ["-C", e.worktree, "status", "--porcelain"], { timeoutMs: 8000, signal: ctx.signal });
+                const untracked = st.code === 0 ? st.stdout.split("\n").filter((l) => l.startsWith("??")).map((l) => l.slice(3).trim()) : [];
+                let body = stat.code === 0 && stat.stdout.trim() ? stat.stdout.trim() : "";
+                if (untracked.length)
+                    body += `\n new files: ${untracked.slice(0, 10).join(", ")}${untracked.length > 10 ? ` (+${untracked.length - 10})` : ""}`;
+                lines.push(`── ${e.agent} [${e.branch}] ──\n${body.trim() || "(no changes)"}`);
+            }
+            lines.push("", "Review one in full with review_diff cwd:'<worktree>' target:'head', then cleanup.");
+            return lines.join("\n");
+        }
+        // cleanup
+        const errs = [];
+        for (const e of job.entries) {
+            const rm = await runIn(job.repo, "git", ["-C", job.repo, "worktree", "remove", "--force", e.worktree], { timeoutMs: 15000, signal: ctx.signal });
+            if (rm.code !== 0 && !/not a working tree|No such file/i.test(rm.stderr))
+                errs.push(`${e.agent}: ${rm.stderr.trim().slice(0, 80)}`);
+            await runIn(job.repo, "git", ["-C", job.repo, "branch", "-D", e.branch], { timeoutMs: 8000, signal: ctx.signal });
+        }
+        await removeComparison(job.id);
+        return errs.length ? `Cleaned up ${job.id} with warnings:\n${errs.join("\n")}` : `Cleaned up comparison ${job.id} (worktrees + scratch branches removed).`;
+    },
+};
+//# sourceMappingURL=compare_agents.js.map

package/dist/tools/compare_agents.js.map

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

package/dist/tools/dispatch_agent.d.ts

@@ -33,6 +33,19 @@ export declare function buildDispatchArgv(agent: DispatchInput["agent"], task: s
     cmd: string;
     args: string[];
 };
+export type DispatchAgentKind = DispatchInput["agent"];
+export interface LaunchResult {
+    pid?: number;
+    /** Present when the launch failed (binary missing, spawn error). */
+    error?: string;
+    cmd: string;
+}
+/**
+ * Spawn a CLI agent headlessly, detached, and record it in the dispatch ledger.
+ * Shared by dispatch_agent (interactive), scheduled_dispatch (heartbeat-timed),
+ * and compare_agents (parallel). Never throws — returns {pid} or {error}.
+ */
+export declare function launchAgent(agent: DispatchAgentKind, task: string, cwd: string, log?: (m: string) => void): Promise<LaunchResult>;
 export declare const dispatchAgentTool: ToolDefinition<DispatchInput, string>;
 export {};
 //# sourceMappingURL=dispatch_agent.d.ts.map