@oratis/lisa 0.7.0 → 0.9.0

package/dist/tools/npm_info.js

@@ -0,0 +1,102 @@
+import { runIn, isDir, gitRoot } from "./exec-util.js";
+/** Pure: format `npm view --json` metadata. Exported for tests. */
+export function formatView(json) {
+    let d;
+    try {
+        d = JSON.parse(json);
+    }
+    catch {
+        return json.trim();
+    }
+    if (Array.isArray(d))
+        d = d[d.length - 1]; // version range → newest match
+    const lines = [
+        `${d.name}@${d.version}`,
+        d.description ? `  ${d.description}` : "",
+        d.license ? `  license: ${d.license}` : "",
+        d.homepage ? `  homepage: ${d.homepage}` : "",
+        d.deprecated ? `  ⚠ DEPRECATED: ${d.deprecated}` : "",
+        d.dist?.unpackedSize ? `  size: ${Math.round(d.dist.unpackedSize / 1024)} KB` : "",
+    ].filter(Boolean);
+    return lines.join("\n");
+}
+/** Pure: format `npm outdated --json`. Exported for tests. */
+export function formatOutdated(json) {
+    let d;
+    try {
+        d = JSON.parse(json || "{}");
+    }
+    catch {
+        return json.trim();
+    }
+    const names = Object.keys(d);
+    if (names.length === 0)
+        return "(all dependencies up to date)";
+    return `${names.length} outdated:\n` + names.map((n) => `  ${n}: ${d[n].current ?? "?"} → ${d[n].latest ?? "?"}`).join("\n");
+}
+/** Pure: summarise `npm audit --json` (npm v7+ shape). Exported for tests. */
+export function formatAudit(json) {
+    let d;
+    try {
+        d = JSON.parse(json);
+    }
+    catch {
+        return json.trim();
+    }
+    const v = d?.metadata?.vulnerabilities;
+    if (!v)
+        return "(no audit data)";
+    const total = (v.critical ?? 0) + (v.high ?? 0) + (v.moderate ?? 0) + (v.low ?? 0) + (v.info ?? 0);
+    if (total === 0)
+        return "(no known vulnerabilities)";
+    const parts = ["critical", "high", "moderate", "low", "info"].filter((k) => v[k]).map((k) => `${v[k]} ${k}`);
+    return `${total} vulnerabilit${total === 1 ? "y" : "ies"}: ${parts.join(", ")}  (run \`npm audit\` for detail)`;
+}
+export const npmInfoTool = {
+    name: "npm_info",
+    description: "npm registry info: action:'view' (package — latest version, description, license, deprecation), " +
+        "'outdated' (which of a repo's dependencies have newer versions), 'audit' (known vulnerabilities in " +
+        "a repo). Use when the user asks about a package, whether deps are current, or for a security pass. " +
+        "Read-only; no auth; uses the local npm CLI.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            action: { type: "string", enum: ["view", "outdated", "audit"] },
+            package: { type: "string", description: "Package name (optionally name@range) for action:'view'." },
+            cwd: { type: "string", description: "Repo path for outdated/audit. Defaults to current directory." },
+        },
+        required: ["action"],
+        additionalProperties: false,
+    },
+    async execute(input, ctx) {
+        if (input.action === "view") {
+            if (!input.package)
+                return "(view needs a package name)";
+            const r = await runIn(ctx.cwd, "npm", ["view", input.package, "--json"], { timeoutMs: 20000, signal: ctx.signal, maxBytes: 200_000 });
+            if (r.spawnError)
+                return "(npm isn't installed)";
+            if (r.code !== 0)
+                return `(npm view failed: ${r.stderr.trim().slice(0, 160) || "no such package?"})`;
+            return formatView(r.stdout);
+        }
+        const cwd = input.cwd && input.cwd.startsWith("/") ? input.cwd : ctx.cwd;
+        if (!(await isDir(cwd)))
+            return `(not a directory: ${cwd})`;
+        const root = (await gitRoot(cwd, ctx.signal)) ?? cwd;
+        if (input.action === "outdated") {
+            // npm outdated exits non-zero when there ARE outdated deps — that's not an error.
+            const r = await runIn(root, "npm", ["outdated", "--json"], { timeoutMs: 60000, signal: ctx.signal, maxBytes: 200_000 });
+            if (r.spawnError)
+                return "(npm isn't installed)";
+            return formatOutdated(r.stdout || "{}");
+        }
+        // audit
+        const r = await runIn(root, "npm", ["audit", "--json"], { timeoutMs: 60000, signal: ctx.signal, maxBytes: 400_000 });
+        if (r.spawnError)
+            return "(npm isn't installed)";
+        if (!r.stdout.trim())
+            return `(npm audit produced no output${r.stderr ? ": " + r.stderr.trim().slice(0, 120) : ""})`;
+        return formatAudit(r.stdout);
+    },
+};
+//# sourceMappingURL=npm_info.js.map

package/dist/tools/npm_info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm_info.js","sourceRoot":"","sources":["../../src/tools/npm_info.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AASvD,mEAAmE;AACnE,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,CAAM,CAAC;IACX,IAAI,CAAC;QAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IAAC,CAAC;IAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,+BAA+B;IAC1E,MAAM,KAAK,GAAG;QACZ,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE;QACxB,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE;QACzC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE;QAC1C,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE;QAC7C,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE;QACrD,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;KACnF,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAsB,CAAC;IAC3B,IAAI,CAAC;QAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IAAC,CAAC;IACnE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,+BAA+B,CAAC;IAC/D,OAAO,GAAG,KAAK,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/H,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAM,CAAC;IACX,IAAI,CAAC;QAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IAAC,CAAC;IAC3D,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,eAAe,CAAC;IACvC,IAAI,CAAC,CAAC;QAAE,OAAO,iBAAiB,CAAC;IACjC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IACnG,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,4BAA4B,CAAC;IACrD,MAAM,KAAK,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7G,OAAO,GAAG,KAAK,gBAAgB,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,kCAAkC,CAAC;AAClH,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAqC;IAC3D,IAAI,EAAE,UAAU;IAChB,WAAW,EACT,kGAAkG;QAClG,qGAAqG;QACrG,qGAAqG;QACrG,6CAA6C;IAC/C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE;YAC/D,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yDAAyD,EAAE;YACnG,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8DAA8D,EAAE;SACrG;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,oBAAoB,EAAE,KAAK;KAC5B;IACD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,OAAO;gBAAE,OAAO,6BAA6B,CAAC;YACzD,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YACtI,IAAI,CAAC,CAAC,UAAU;gBAAE,OAAO,uBAAuB,CAAC;YACjD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;gBAAE,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,kBAAkB,GAAG,CAAC;YACrG,OAAO,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QACzE,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO,qBAAqB,GAAG,GAAG,CAAC;QAC5D,MAAM,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC;QAErD,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAChC,kFAAkF;YAClF,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YACxH,IAAI,CAAC,CAAC,UAAU;gBAAE,OAAO,uBAAuB,CAAC;YACjD,OAAO,cAAc,CAAC,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;QAC1C,CAAC;QAED,QAAQ;QACR,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACrH,IAAI,CAAC,CAAC,UAAU;YAAE,OAAO,uBAAuB,CAAC;QACjD,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;YAAE,OAAO,gCAAgC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;QACrH,OAAO,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;CACF,CAAC"}

package/dist/tools/pr_status.d.ts

@@ -0,0 +1,31 @@
+/**
+ * pr_status (vibe-coding) — when many agents open many PRs, which are green,
+ * which need review, which are failing? Wraps `gh pr list` to surface each open
+ * PR's CI rollup + review decision in one glance. Read-only.
+ */
+import type { ToolDefinition } from "../types.js";
+interface PrStatusInput {
+    cwd?: string;
+    /** Only your own PRs (gh --author @me). Default false = all open PRs. */
+    mine?: boolean;
+}
+interface RollupItem {
+    conclusion?: string | null;
+    status?: string | null;
+    state?: string | null;
+}
+interface PR {
+    number: number;
+    title: string;
+    headRefName: string;
+    isDraft: boolean;
+    reviewDecision?: string | null;
+    statusCheckRollup?: RollupItem[] | null;
+}
+/** Pure: reduce a PR's check rollup to one of ✓ / ✗ / ⏳ / – . */
+export declare function summarizeChecks(rollup: RollupItem[] | null | undefined): string;
+/** Pure: one PR → a readable line. Exported for tests. */
+export declare function formatPR(pr: PR): string;
+export declare const prStatusTool: ToolDefinition<PrStatusInput, string>;
+export {};
+//# sourceMappingURL=pr_status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pr_status.d.ts","sourceRoot":"","sources":["../../src/tools/pr_status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,UAAU,aAAa;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,UAAU;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AACD,UAAU,EAAE;IACV,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,iBAAiB,CAAC,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;CACzC;AAED,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAkB/E;AAWD,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,EAAE,EAAE,EAAE,GAAG,MAAM,CAIvC;AAED,eAAO,MAAM,YAAY,EAAE,cAAc,CAAC,aAAa,EAAE,MAAM,CA2C9D,CAAC"}

package/dist/tools/pr_status.js

@@ -0,0 +1,90 @@
+import { runIn, isDir, gitRoot } from "./exec-util.js";
+/** Pure: reduce a PR's check rollup to one of ✓ / ✗ / ⏳ / – . */
+export function summarizeChecks(rollup) {
+    if (!rollup || rollup.length === 0)
+        return "–";
+    let fail = false;
+    let pending = false;
+    for (const c of rollup) {
+        const concl = (c.conclusion ?? "").toUpperCase();
+        const state = (c.state ?? "").toUpperCase();
+        if (["FAILURE", "ERROR", "CANCELLED", "TIMED_OUT", "ACTION_REQUIRED"].includes(concl) || ["FAILURE", "ERROR"].includes(state)) {
+            fail = true;
+        }
+        else if (concl === "SUCCESS" || state === "SUCCESS") {
+            // ok
+        }
+        else {
+            pending = true; // queued / in_progress / pending / expected
+        }
+    }
+    if (fail)
+        return "✗";
+    if (pending)
+        return "⏳";
+    return "✓";
+}
+function reviewLabel(d) {
+    switch ((d ?? "").toUpperCase()) {
+        case "APPROVED": return "approved";
+        case "CHANGES_REQUESTED": return "changes requested";
+        case "REVIEW_REQUIRED": return "needs review";
+        default: return "no review";
+    }
+}
+/** Pure: one PR → a readable line. Exported for tests. */
+export function formatPR(pr) {
+    const draft = pr.isDraft ? " (draft)" : "";
+    const title = pr.title.length > 60 ? pr.title.slice(0, 57) + "…" : pr.title;
+    return `#${pr.number} ${summarizeChecks(pr.statusCheckRollup)} CI · ${reviewLabel(pr.reviewDecision)} · ${title}${draft}  [${pr.headRefName}]`;
+}
+export const prStatusTool = {
+    name: "pr_status",
+    description: "List the repo's open pull requests with each one's CI status (✓/✗/⏳) and review decision " +
+        "(approved / changes requested / needs review). Use when the user asks which PRs are green, " +
+        "ready to merge, failing, or waiting on review — handy when several agents have opened PRs. " +
+        "Read-only; needs the `gh` CLI (authenticated). mine:true limits to your own PRs.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            cwd: { type: "string", description: "Absolute path inside the repo. Defaults to the current directory." },
+            mine: { type: "boolean", description: "Only your own PRs (default false = all open)." },
+        },
+        additionalProperties: false,
+    },
+    async execute(input, ctx) {
+        const cwd = input.cwd && input.cwd.startsWith("/") ? input.cwd : ctx.cwd;
+        if (!(await isDir(cwd)))
+            return `(not a directory: ${cwd})`;
+        const root = (await gitRoot(cwd, ctx.signal)) ?? cwd;
+        const args = [
+            "pr", "list", "--state", "open", "--limit", "30",
+            "--json", "number,title,headRefName,isDraft,reviewDecision,statusCheckRollup",
+        ];
+        if (input.mine)
+            args.push("--author", "@me");
+        const r = await runIn(root, "gh", args, { timeoutMs: 20000, signal: ctx.signal, maxBytes: 200_000 });
+        if (r.spawnError)
+            return "(the `gh` CLI isn't installed — needed for PR status. Install: https://cli.github.com)";
+        if (r.code !== 0) {
+            const e = r.stderr.trim();
+            if (/auth|login/i.test(e))
+                return "(`gh` isn't authenticated — run `gh auth login`)";
+            return `(gh pr list failed: ${e.slice(0, 200) || "is this a GitHub repo?"})`;
+        }
+        let prs;
+        try {
+            prs = JSON.parse(r.stdout);
+        }
+        catch {
+            return "(couldn't parse gh output)";
+        }
+        if (prs.length === 0)
+            return "(no open PRs)";
+        // failing first, then pending, then the rest
+        const rank = (p) => { const s = summarizeChecks(p.statusCheckRollup); return s === "✗" ? 0 : s === "⏳" ? 1 : 2; };
+        prs.sort((a, b) => rank(a) - rank(b) || a.number - b.number);
+        return `${prs.length} open PR(s):\n` + prs.map(formatPR).join("\n");
+    },
+};
+//# sourceMappingURL=pr_status.js.map

package/dist/tools/pr_status.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA+BlD,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,mBAAwB,GAAG,cAAc,EAAE,CA2ClF;AAED,eAAO,MAAM,oBAAoB,aAS/B,CAAC;AAEH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAExE"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA4ClD,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,mBAAwB,GAAG,cAAc,EAAE,CAwDlF;AAED,eAAO,MAAM,oBAAoB,aAU/B,CAAC;AAEH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAExE"}

package/dist/tools/registry.js

@@ -1,8 +1,21 @@
 import { memoryTool } from "../memory/tool.js";
 import { memorySearchTool } from "../memory/search_tool.js";
 import { adviseNowTool } from "./advise_now.js";
+import { listAgentsTool } from "./list_agents.js";
+import { inspectAgentTool } from "./inspect_agent.js";
+import { repoDigestTool } from "./repo_digest.js";
+import { reviewDiffTool } from "./review_diff.js";
+import { runChecksTool } from "./run_checks.js";
+import { prStatusTool } from "./pr_status.js";
 import { dispatchAgentTool } from "./dispatch_agent.js";
+import { scheduledDispatchTool } from "./scheduled_dispatch.js";
+import { compareAgentsTool } from "./compare_agents.js";
+import { githubLinkTool } from "./github_link.js";
+import { githubTool } from "./github.js";
+import { npmInfoTool } from "./npm_info.js";
+import { mcpTool } from "./mcp.js";
 import { signalAgentTool } from "./signal_agent.js";
+import { agentRecapTool } from "./agent_recap.js";
 import { skillManageTool } from "../skills/tool.js";
 import { desireCloseTool, desireProgressTool, soulDiffTool, soulFeelTool, soulHistoryTool, soulJournalTool, soulObjectTool, soulPatchTool, soulReadTool, } from "../soul/tools.js";
 import { speakTool, transcribeTool } from "../voice/tool.js";
@@ -43,9 +56,22 @@ export function buildToolRegistry(opts = {}) {
         webSearchTool,
         redeployTool,
         // Orchestration (docs/ORCHESTRATOR_PLAN.md): observe → advise → dispatch → control.
+        listAgentsTool,
+        inspectAgentTool,
+        repoDigestTool,
+        reviewDiffTool,
+        runChecksTool,
+        prStatusTool,
         adviseNowTool,
         dispatchAgentTool,
+        scheduledDispatchTool,
+        compareAgentsTool,
+        githubLinkTool,
+        githubTool,
+        npmInfoTool,
+        mcpTool,
         signalAgentTool,
+        agentRecapTool,
     ];
     if (opts.includeVoice) {
         tools.push(speakTool, transcribeTool);
@@ -71,6 +97,7 @@ export const READ_ONLY_TOOL_NAMES = new Set([
     "soul_diff",
     "web_fetch",
     "web_search",
+    "agent_recap",
 ]);
 export function readOnlySubset(tools) {
     return tools.filter((t) => READ_ONLY_TOOL_NAMES.has(t.name));

package/dist/tools/registry.js.map

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

package/dist/tools/repo_digest.d.ts

@@ -0,0 +1,33 @@
+/**
+ * repo_digest (vibe-coding) — "what actually changed?" across the repos your
+ * agents are working in. The orchestrator only sees structural activity (tool
+ * names, file paths); git is the source of truth for *what was produced*. This
+ * wraps git so LISA can answer "what did Claude Code do today" with real
+ * commits + working-tree state, per repo.
+ *
+ * Reads the user's own git repos (content they've asked LISA to look at) — this
+ * is separate from the orchestrator's no-conversation-content privacy rule.
+ */
+import type { ToolDefinition } from "../types.js";
+interface RepoDigestInput {
+    /** Repo path. Omit to digest every repo with an observed agent session. */
+    cwd?: string;
+    /** git --since value. Default "1 day ago". */
+    since?: string;
+}
+export interface RepoDigest {
+    root: string;
+    branch: string;
+    commits: string[];
+    dirtyFiles: number;
+    diffStat: string;
+    ahead: number;
+    behind: number;
+    since: string;
+    error?: string;
+}
+/** Pure: render one repo's digest. Exported for tests. */
+export declare function formatDigest(d: RepoDigest): string;
+export declare const repoDigestTool: ToolDefinition<RepoDigestInput, string>;
+export {};
+//# sourceMappingURL=repo_digest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repo_digest.d.ts","sourceRoot":"","sources":["../../src/tools/repo_digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,UAAU,eAAe;IACvB,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAqBlD;AAoDD,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,eAAe,EAAE,MAAM,CAkClE,CAAC"}

package/dist/tools/repo_digest.js

@@ -0,0 +1,113 @@
+import { getCurrentHub } from "../integrations/current-hub.js";
+import { runIn, isDir, gitRoot } from "./exec-util.js";
+/** Pure: render one repo's digest. Exported for tests. */
+export function formatDigest(d) {
+    const name = d.root.split("/").pop() || d.root;
+    if (d.error)
+        return `▸ ${name} — ${d.error}`;
+    const lines = [];
+    const sync = d.ahead || d.behind
+        ? `  (${d.ahead ? "↑" + d.ahead : ""}${d.behind ? "↓" + d.behind : ""} vs upstream)`
+        : "";
+    lines.push(`▸ ${name} @ ${d.branch}${sync}`);
+    if (d.commits.length) {
+        lines.push(`  commits since ${d.since}:`);
+        for (const c of d.commits)
+            lines.push(`    ${c}`);
+    }
+    else {
+        lines.push(`  no commits since ${d.since}`);
+    }
+    if (d.dirtyFiles > 0) {
+        lines.push(`  uncommitted: ${d.dirtyFiles} file(s)${d.diffStat ? " · " + d.diffStat : ""}`);
+    }
+    else {
+        lines.push(`  working tree clean`);
+    }
+    return lines.join("\n");
+}
+async function digestRepo(cwd, since, signal) {
+    const root = await gitRoot(cwd, signal);
+    const base = { root: root ?? cwd, branch: "?", commits: [], dirtyFiles: 0, diffStat: "", ahead: 0, behind: 0, since };
+    if (!root)
+        return { ...base, error: "not a git repo" };
+    const git = (args) => runIn(root, "git", ["-C", root, ...args], { timeoutMs: 8000, signal });
+    const branch = await git(["rev-parse", "--abbrev-ref", "HEAD"]);
+    base.branch = branch.code === 0 ? branch.stdout.trim() || "?" : "?";
+    // Commits across all refs in the window (covers agent worktrees/branches).
+    const log = await git(["log", "--all", "--oneline", "--no-decorate", `--since=${since}`, "-n", "25"]);
+    if (log.code === 0) {
+        base.commits = log.stdout.split("\n").map((l) => l.trim()).filter(Boolean);
+    }
+    const status = await git(["status", "--porcelain"]);
+    if (status.code === 0) {
+        base.dirtyFiles = status.stdout.split("\n").filter((l) => l.trim()).length;
+    }
+    if (base.dirtyFiles > 0) {
+        const ds = await git(["diff", "--shortstat"]);
+        if (ds.code === 0)
+            base.diffStat = ds.stdout.trim();
+    }
+    const ab = await git(["rev-list", "--left-right", "--count", "@{upstream}...HEAD"]);
+    if (ab.code === 0) {
+        const m = ab.stdout.trim().split(/\s+/);
+        base.behind = parseInt(m[0] ?? "0", 10) || 0;
+        base.ahead = parseInt(m[1] ?? "0", 10) || 0;
+    }
+    return base;
+}
+/** Collect distinct git roots from the observed agent sessions' cwds. */
+async function observedRepoRoots(signal) {
+    const hub = getCurrentHub();
+    if (!hub)
+        return [];
+    const cwds = Array.from(new Set(hub.list().map((s) => s.cwd).filter((c) => !!c && c.startsWith("/"))));
+    const roots = new Set();
+    for (const c of cwds) {
+        const r = await gitRoot(c, signal);
+        if (r)
+            roots.add(r);
+        if (roots.size >= 8)
+            break;
+    }
+    return Array.from(roots);
+}
+export const repoDigestTool = {
+    name: "repo_digest",
+    description: "Summarise what actually changed in a git repo (or, with no cwd, every repo your agents are " +
+        "working in): recent commits in a time window, current branch, uncommitted file count + diff " +
+        "stat, and ahead/behind vs upstream. Use to answer 'what did <agent> / I do today', 'what's the " +
+        "state of <repo>', or before reviewing/merging. Reads git only (no writes). Pair with review_diff " +
+        "to see the actual changes and run_checks to verify them.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            cwd: { type: "string", description: "Absolute path inside the repo. Omit to digest all repos with an active agent session." },
+            since: { type: "string", description: 'git --since window, e.g. "1 day ago", "today", "3 hours ago". Default "1 day ago".' },
+        },
+        additionalProperties: false,
+    },
+    async execute(input, ctx) {
+        const since = input.since?.trim() || "1 day ago";
+        let roots;
+        if (input.cwd) {
+            if (!(await isDir(input.cwd)))
+                return `(not a directory: ${input.cwd})`;
+            roots = [input.cwd];
+        }
+        else {
+            roots = await observedRepoRoots(ctx.signal);
+            if (roots.length === 0) {
+                // Fall back to the current working directory's repo.
+                const r = await gitRoot(ctx.cwd, ctx.signal);
+                if (r)
+                    roots = [r];
+            }
+        }
+        if (roots.length === 0)
+            return "(no git repos to digest — no active agent sessions and cwd isn't a repo)";
+        const digests = await Promise.all(roots.map((r) => digestRepo(r, since, ctx.signal)));
+        return digests.map(formatDigest).join("\n\n");
+    },
+};
+//# sourceMappingURL=repo_digest.js.map

package/dist/tools/repo_digest.js.map

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

package/dist/tools/review_diff.d.ts

@@ -0,0 +1,28 @@
+/**
+ * review_diff (vibe-coding) — show the actual code changes in a repo (or a PR)
+ * so LISA can review an agent's work: spot bugs, risky edits, leftover debug
+ * code, missing tests. The natural follow-up to repo_digest ("something
+ * changed") and the natural lead-in to run_checks ("does it pass?").
+ *
+ * Read-only. Diff output is capped so a huge change doesn't blow the context.
+ */
+import type { ToolDefinition } from "../types.js";
+interface ReviewDiffInput {
+    /** Repo path. Defaults to the current working directory. */
+    cwd?: string;
+    /**
+     * What to diff: "head" (all uncommitted vs HEAD, default), "working"
+     * (unstaged only), "staged" (staged only), or any git ref/range
+     * (e.g. "main...HEAD", "HEAD~3").
+     */
+    target?: string;
+    /** Review a GitHub PR's diff instead (needs the `gh` CLI). */
+    pr?: number;
+    /** Max diff lines to return. Default 600. */
+    max_lines?: number;
+}
+/** Pure: assemble the stat header + (capped) diff body. Exported for tests. */
+export declare function assembleReview(stat: string, diff: string, maxLines: number): string;
+export declare const reviewDiffTool: ToolDefinition<ReviewDiffInput, string>;
+export {};
+//# sourceMappingURL=review_diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review_diff.d.ts","sourceRoot":"","sources":["../../src/tools/review_diff.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,UAAU,eAAe;IACvB,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgBD,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOnF;AAED,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,eAAe,EAAE,MAAM,CAuClE,CAAC"}

package/dist/tools/review_diff.js

@@ -0,0 +1,68 @@
+import { runIn, isDir, gitRoot } from "./exec-util.js";
+function gitDiffArgs(target) {
+    switch (target) {
+        case "working":
+            return ["diff"];
+        case "staged":
+            return ["diff", "--cached"];
+        case "head":
+        case "":
+            return ["diff", "HEAD"];
+        default:
+            return ["diff", target];
+    }
+}
+/** Pure: assemble the stat header + (capped) diff body. Exported for tests. */
+export function assembleReview(stat, diff, maxLines) {
+    const header = stat.trim() ? stat.trim() : "(no changes)";
+    if (!diff.trim())
+        return header;
+    const lines = diff.split("\n");
+    if (lines.length <= maxLines)
+        return `${header}\n\n${diff.trimEnd()}`;
+    const shown = lines.slice(0, maxLines).join("\n");
+    return `${header}\n\n${shown}\n… [diff truncated — ${maxLines} of ${lines.length} lines shown; narrow with target or review per-file]`;
+}
+export const reviewDiffTool = {
+    name: "review_diff",
+    description: "Show the actual code diff in a repo so you can review it — uncommitted changes vs HEAD by " +
+        "default, or working/staged only, or any git ref/range, or a GitHub PR (pr:<n>, needs `gh`). " +
+        "Use to review what an agent wrote before committing/merging: bugs, risky edits, debug leftovers, " +
+        "missing tests. Read-only; output is capped. Pair with repo_digest (what changed) and run_checks " +
+        "(does it pass).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            cwd: { type: "string", description: "Absolute path inside the repo. Defaults to the current directory." },
+            target: { type: "string", description: '"head" (default, all uncommitted), "working", "staged", or a git ref/range like "main...HEAD".' },
+            pr: { type: "integer", description: "Review this GitHub PR's diff instead (needs `gh`)." },
+            max_lines: { type: "integer", minimum: 50, maximum: 4000, description: "Max diff lines (default 600)." },
+        },
+        additionalProperties: false,
+    },
+    async execute(input, ctx) {
+        const cwd = input.cwd && input.cwd.startsWith("/") ? input.cwd : ctx.cwd;
+        if (!(await isDir(cwd)))
+            return `(not a directory: ${cwd})`;
+        const root = await gitRoot(cwd, ctx.signal);
+        if (!root)
+            return `(not a git repo: ${cwd})`;
+        const maxLines = input.max_lines ?? 600;
+        if (typeof input.pr === "number") {
+            const r = await runIn(root, "gh", ["pr", "diff", String(input.pr)], { timeoutMs: 20000, signal: ctx.signal, maxBytes: 200_000 });
+            if (r.spawnError)
+                return "(the `gh` CLI isn't installed — needed to fetch PR diffs)";
+            if (r.code !== 0)
+                return `(gh pr diff ${input.pr} failed: ${r.stderr.trim().slice(0, 200) || "unknown error"})`;
+            return assembleReview(`PR #${input.pr} diff`, r.stdout, maxLines);
+        }
+        const target = (input.target ?? "head").trim();
+        const args = gitDiffArgs(target);
+        const stat = await runIn(root, "git", ["-C", root, ...args, "--stat"], { timeoutMs: 10000, signal: ctx.signal });
+        const diff = await runIn(root, "git", ["-C", root, ...args], { timeoutMs: 15000, signal: ctx.signal, maxBytes: 200_000 });
+        if (diff.code !== 0)
+            return `(git diff failed: ${diff.stderr.trim().slice(0, 200) || "bad target?"})`;
+        return assembleReview(stat.stdout, diff.stdout, maxLines);
+    },
+};
+//# sourceMappingURL=review_diff.js.map

package/dist/tools/review_diff.js.map

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

package/dist/tools/run_checks.d.ts

@@ -0,0 +1,15 @@
+import type { ToolDefinition } from "../types.js";
+interface RunChecksInput {
+    cwd?: string;
+    /** Subset to run, e.g. ["test","typecheck"]. Omit = all detected. */
+    only?: string[];
+}
+export interface DetectedCheck {
+    name: string;
+    script: string;
+}
+/** Pure: pick which checks to run from a scripts map. Exported for tests. */
+export declare function detectChecks(scripts: Record<string, string>, only?: string[]): DetectedCheck[];
+export declare const runChecksTool: ToolDefinition<RunChecksInput, string>;
+export {};
+//# sourceMappingURL=run_checks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run_checks.d.ts","sourceRoot":"","sources":["../../src/tools/run_checks.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,UAAU,cAAc;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAiBD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAe9F;AAOD,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,cAAc,EAAE,MAAM,CA8DhE,CAAC"}