@oratis/lisa 0.5.0 → 0.8.0

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

package/dist/tools/run_checks.js

@@ -0,0 +1,117 @@
+/**
+ * run_checks (vibe-coding) — the quality gate. Auto-detects the repo's own
+ * checks (typecheck / lint / test / build from package.json scripts) and runs
+ * them, reporting pass/fail + the tail of any failure. "Lisa, does the agent's
+ * work pass?" before you commit or merge.
+ *
+ * Runs the project's OWN scripts (npm/pnpm/yarn run <script>) — same trust as
+ * running them yourself; capped per-check by a timeout.
+ */
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { runIn, isDir, gitRoot } from "./exec-util.js";
+/** Preferred order — fast/cheap signals first, slow build last. */
+const CHECK_PRIORITY = ["typecheck", "lint", "test", "build"];
+/** Script-name aliases mapped onto a canonical check. */
+const ALIASES = {
+    typecheck: "typecheck",
+    tsc: "typecheck",
+    "type-check": "typecheck",
+    lint: "lint",
+    eslint: "lint",
+    test: "test",
+    tests: "test",
+    build: "build",
+    check: "lint",
+};
+/** Pure: pick which checks to run from a scripts map. Exported for tests. */
+export function detectChecks(scripts, only) {
+    const onlySet = only && only.length ? new Set(only.map((s) => s.toLowerCase())) : null;
+    const byCanon = new Map(); // canonical → script key (first wins)
+    for (const key of Object.keys(scripts)) {
+        const canon = ALIASES[key.toLowerCase()];
+        if (!canon)
+            continue;
+        if (!byCanon.has(canon))
+            byCanon.set(canon, key);
+    }
+    const out = [];
+    for (const canon of CHECK_PRIORITY) {
+        if (!byCanon.has(canon))
+            continue;
+        if (onlySet && !onlySet.has(canon))
+            continue;
+        out.push({ name: canon, script: byCanon.get(canon) });
+    }
+    return out;
+}
+function tail(s, n) {
+    const lines = s.split("\n").filter((l) => l.length);
+    return lines.slice(-n).join("\n");
+}
+export const runChecksTool = {
+    name: "run_checks",
+    description: "Run a repo's own quality checks (typecheck, lint, test, build — auto-detected from package.json " +
+        "scripts) and report pass/fail with the tail of any failure. Use to verify an agent's work before " +
+        "committing/merging, or when the user asks 'does it pass / are tests green'. Runs the project's own " +
+        "npm/pnpm/yarn scripts (capped by a per-check timeout). Narrow with only:['test'] etc.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            cwd: { type: "string", description: "Absolute path inside the repo. Defaults to the current directory." },
+            only: { type: "array", items: { type: "string" }, description: "Subset: any of typecheck/lint/test/build. Omit to run all detected." },
+        },
+        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;
+        let scripts = {};
+        try {
+            const pkg = JSON.parse(await readFile(path.join(root, "package.json"), "utf8"));
+            scripts = pkg.scripts ?? {};
+        }
+        catch {
+            return "(no package.json with scripts found — run_checks currently supports Node/npm projects)";
+        }
+        const checks = detectChecks(scripts, input.only);
+        if (checks.length === 0) {
+            return `(no recognised check scripts in package.json; available: ${Object.keys(scripts).join(", ") || "none"})`;
+        }
+        // Pick the package manager from the lockfile.
+        const has = async (f) => isDir(root).then(() => readFile(path.join(root, f)).then(() => true).catch(() => false));
+        let pm = "npm";
+        if (await has("pnpm-lock.yaml"))
+            pm = "pnpm";
+        else if (await has("yarn.lock"))
+            pm = "yarn";
+        else if (await has("bun.lockb"))
+            pm = "bun";
+        const results = [];
+        const failures = [];
+        for (const c of checks) {
+            const r = await runIn(root, pm, ["run", c.script], { timeoutMs: 240_000, signal: ctx.signal, maxBytes: 200_000 });
+            if (r.spawnError) {
+                results.push(`✗ ${c.name} (couldn't run ${pm})`);
+                continue;
+            }
+            if (r.timedOut) {
+                results.push(`⏱ ${c.name} (timed out at 240s)`);
+                continue;
+            }
+            if (r.code === 0) {
+                results.push(`✓ ${c.name}`);
+            }
+            else {
+                results.push(`✗ ${c.name} (exit ${r.code})`);
+                const out = tail(r.stdout + "\n" + r.stderr, 20);
+                failures.push(`── ${c.name} (${pm} run ${c.script}) ──\n${out}`);
+            }
+        }
+        const head = `${root.split("/").pop()}: ${results.join("  ")}`;
+        return failures.length ? `${head}\n\n${failures.join("\n\n")}` : head;
+    },
+};
+//# sourceMappingURL=run_checks.js.map

package/dist/tools/run_checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run_checks.js","sourceRoot":"","sources":["../../src/tools/run_checks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAQvD,mEAAmE;AACnE,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AACvE,yDAAyD;AACzD,MAAM,OAAO,GAA2B;IACtC,SAAS,EAAE,WAAW;IACtB,GAAG,EAAE,WAAW;IAChB,YAAY,EAAE,WAAW;IACzB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,MAAM;CACd,CAAC;AAOF,6EAA6E;AAC7E,MAAM,UAAU,YAAY,CAAC,OAA+B,EAAE,IAAe;IAC3E,MAAM,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,sCAAsC;IACjF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAClC,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAC7C,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAE,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,IAAI,CAAC,CAAS,EAAE,CAAS;IAChC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAA2C;IACnE,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,kGAAkG;QAClG,mGAAmG;QACnG,qGAAqG;QACrG,uFAAuF;IACzF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mEAAmE,EAAE;YACzG,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,qEAAqE,EAAE;SACvI;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,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,OAAO,GAA2B,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YAChF,OAAO,GAAI,GAAG,CAAC,OAAkC,IAAI,EAAE,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,wFAAwF,CAAC;QAClG,CAAC;QACD,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,4DAA4D,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CAAC;QAClH,CAAC;QAED,8CAA8C;QAC9C,MAAM,GAAG,GAAG,KAAK,EAAE,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1H,IAAI,EAAE,GAAG,KAAK,CAAC;QACf,IAAI,MAAM,GAAG,CAAC,gBAAgB,CAAC;YAAE,EAAE,GAAG,MAAM,CAAC;aACxC,IAAI,MAAM,GAAG,CAAC,WAAW,CAAC;YAAE,EAAE,GAAG,MAAM,CAAC;aACxC,IAAI,MAAM,GAAG,CAAC,WAAW,CAAC;YAAE,EAAE,GAAG,KAAK,CAAC;QAE5C,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAClH,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,kBAAkB,EAAE,GAAG,CAAC,CAAC;gBACjD,SAAS;YACX,CAAC;YACD,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,sBAAsB,CAAC,CAAC;gBAChD,SAAS;YACX,CAAC;YACD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;gBAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBACjD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,EAAE,QAAQ,CAAC,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/D,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACxE,CAAC;CACF,CAAC"}

package/dist/tools/scheduled_dispatch.d.ts

@@ -0,0 +1,27 @@
+/**
+ * scheduled_dispatch (vibe-coding) — schedule an agent to run a task on a
+ * recurring basis: "every night triage the issue backlog", "every 2h sync the
+ * docs". Entries are stored and fired by the heartbeat at its cadence.
+ *
+ * SAFETY: this auto-launches an autonomous agent unattended (no approval at
+ * fire time, like any heartbeat action). Each entry has a maxRuns cap (default
+ * 30) so a forgotten schedule can't run forever. Needs the heartbeat installed
+ * (`lisa heartbeat install`) to actually fire.
+ */
+import type { ToolDefinition } from "../types.js";
+import { type ScheduledAgent } from "../integrations/scheduled-dispatch.js";
+interface ScheduledDispatchInput {
+    action: "add" | "list" | "remove";
+    agent?: ScheduledAgent;
+    task?: string;
+    cwd?: string;
+    /** "every:30m" | "every:2h" | "every:1d" | "daily:09:00" */
+    schedule?: string;
+    /** Max times to fire before going inert. Default 30. */
+    max_runs?: number;
+    /** For remove: the entry id (or prefix). */
+    id?: string;
+}
+export declare const scheduledDispatchTool: ToolDefinition<ScheduledDispatchInput, string>;
+export {};
+//# sourceMappingURL=scheduled_dispatch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled_dispatch.d.ts","sourceRoot":"","sources":["../../src/tools/scheduled_dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,uCAAuC,CAAC;AAE/C,UAAU,sBAAsB;IAC9B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClC,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,sBAAsB,EAAE,MAAM,CA0DhF,CAAC"}

package/dist/tools/scheduled_dispatch.js

@@ -0,0 +1,57 @@
+import { loadScheduled, addScheduled, removeScheduled, isValidSchedule, describeScheduled, DEFAULT_MAX_RUNS, } from "../integrations/scheduled-dispatch.js";
+export const scheduledDispatchTool = {
+    name: "scheduled_dispatch",
+    description: "Schedule a CLI agent to run a task recurringly (fired by the heartbeat). action:'add' needs " +
+        "agent + task + cwd + schedule ('every:30m'/'every:2h'/'every:1d'/'daily:09:00'); 'list' shows " +
+        "scheduled dispatches; 'remove' (needs id) deletes one. Use for standing autonomous work like " +
+        "nightly issue triage or periodic doc sync. It auto-launches an agent unattended, so it has a " +
+        "maxRuns cap (default 30) and needs `lisa heartbeat install` to fire.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            action: { type: "string", enum: ["add", "list", "remove"] },
+            agent: { type: "string", enum: ["claude", "codex", "opencode", "aider"], description: "Which agent to launch (for add)." },
+            task: { type: "string", description: "Task/prompt for the agent (for add).", minLength: 1 },
+            cwd: { type: "string", description: "Absolute working directory (for add). Defaults to the current directory." },
+            schedule: { type: "string", description: "every:30m | every:2h | every:1d | daily:HH:MM (for add)." },
+            max_runs: { type: "integer", minimum: 1, maximum: 1000, description: `Max fires before inert (default ${DEFAULT_MAX_RUNS}).` },
+            id: { type: "string", description: "Entry id or prefix (for remove)." },
+        },
+        required: ["action"],
+        additionalProperties: false,
+    },
+    async execute(input, ctx) {
+        if (input.action === "list") {
+            const entries = await loadScheduled();
+            if (entries.length === 0)
+                return "(no scheduled dispatches)";
+            return `${entries.length} scheduled dispatch(es):\n` + entries.map(describeScheduled).join("\n");
+        }
+        if (input.action === "remove") {
+            if (!input.id)
+                return "(remove needs an id — from scheduled_dispatch action:'list')";
+            const ok = await removeScheduled(input.id);
+            return ok ? `Removed scheduled dispatch ${input.id}.` : `(no scheduled dispatch matches "${input.id}")`;
+        }
+        // add
+        if (!input.agent || !input.task || !input.schedule) {
+            return "(add needs agent, task and schedule)";
+        }
+        if (!isValidSchedule(input.schedule)) {
+            return `(bad schedule "${input.schedule}" — use every:30m / every:2h / every:1d / daily:09:00)`;
+        }
+        const cwd = input.cwd && input.cwd.startsWith("/") ? input.cwd : ctx.cwd;
+        const entry = await addScheduled({
+            agent: input.agent,
+            task: input.task,
+            cwd,
+            schedule: input.schedule,
+            maxRuns: input.max_runs ?? DEFAULT_MAX_RUNS,
+        });
+        const heartbeatNote = "\n(Fires via the heartbeat — if you haven't, run `lisa heartbeat install` so it actually ticks.)";
+        return (`Scheduled ${entry.agent} ${entry.schedule} in ${cwd} (id ${entry.id}, max ${entry.maxRuns} runs):\n` +
+            `  "${input.task.slice(0, 100)}"` +
+            heartbeatNote);
+    },
+};
+//# sourceMappingURL=scheduled_dispatch.js.map

package/dist/tools/scheduled_dispatch.js.map

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

package/dist/tools/signal_agent.d.ts

@@ -0,0 +1,36 @@
+/**
+ * signal_agent (L3/O5 DISPATCH — active control) — the other half of
+ * dispatch_agent. Once LISA has launched CLI agents she should be able to act
+ * on what she observes: see which of her dispatched agents are still running
+ * and stop one that's stuck, conflicting, or burning tokens.
+ *
+ * Scope & safety:
+ *   - It only ever targets agents recorded in the dispatch ledger — i.e. ones
+ *     LISA *herself* launched via dispatch_agent. The user's own manually
+ *     started sessions are observed via session files, carry no pid, and are
+ *     therefore unreachable here. LISA cannot kill an arbitrary process.
+ *   - `cancel` terminates an autonomous process the host already approved
+ *     LISA to spawn; it's the inverse of that approval. It sends SIGTERM to the
+ *     whole process *group* (dispatch spawns detached group leaders, so the
+ *     agent's child processes die with it), then escalates to SIGKILL after a
+ *     short grace period if the group is still alive.
+ *
+ * Composes with the advisor: "codex looks stuck in ~/p — cancel it?" →
+ * signal_agent({action:"cancel", target:"<id>"}).
+ */
+import type { ToolDefinition } from "../types.js";
+import { type DispatchEntry } from "../integrations/dispatch-ledger.js";
+interface SignalInput {
+    action: "list" | "cancel";
+    /** For cancel: the dispatch id (preferred) or pid of the agent to stop. */
+    target?: string;
+    /** Skip the graceful SIGTERM and SIGKILL the group immediately. */
+    force?: boolean;
+}
+/** Human-friendly elapsed time, e.g. "3m", "2h 5m", "8s". */
+export declare function formatUptime(ms: number): string;
+/** One ledger entry → a readable line. Pure, for display + tests. */
+export declare function formatDispatchLine(e: DispatchEntry, now: number): string;
+export declare const signalAgentTool: ToolDefinition<SignalInput, string>;
+export {};
+//# sourceMappingURL=signal_agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signal_agent.d.ts","sourceRoot":"","sources":["../../src/tools/signal_agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,oCAAoC,CAAC;AAE5C,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAQ/C;AAED,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIxE;AAsBD,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,WAAW,EAAE,MAAM,CA2F/D,CAAC"}

package/dist/tools/signal_agent.js

@@ -0,0 +1,140 @@
+/**
+ * signal_agent (L3/O5 DISPATCH — active control) — the other half of
+ * dispatch_agent. Once LISA has launched CLI agents she should be able to act
+ * on what she observes: see which of her dispatched agents are still running
+ * and stop one that's stuck, conflicting, or burning tokens.
+ *
+ * Scope & safety:
+ *   - It only ever targets agents recorded in the dispatch ledger — i.e. ones
+ *     LISA *herself* launched via dispatch_agent. The user's own manually
+ *     started sessions are observed via session files, carry no pid, and are
+ *     therefore unreachable here. LISA cannot kill an arbitrary process.
+ *   - `cancel` terminates an autonomous process the host already approved
+ *     LISA to spawn; it's the inverse of that approval. It sends SIGTERM to the
+ *     whole process *group* (dispatch spawns detached group leaders, so the
+ *     agent's child processes die with it), then escalates to SIGKILL after a
+ *     short grace period if the group is still alive.
+ *
+ * Composes with the advisor: "codex looks stuck in ~/p — cancel it?" →
+ * signal_agent({action:"cancel", target:"<id>"}).
+ */
+import { findDispatch, listLiveDispatches, removeDispatch, isAlive, } from "../integrations/dispatch-ledger.js";
+/** Human-friendly elapsed time, e.g. "3m", "2h 5m", "8s". */
+export function formatUptime(ms) {
+    if (ms < 0)
+        ms = 0;
+    const s = Math.floor(ms / 1000);
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m`;
+    const h = Math.floor(m / 60);
+    return `${h}h ${m % 60}m`;
+}
+/** One ledger entry → a readable line. Pure, for display + tests. */
+export function formatDispatchLine(e, now) {
+    const up = formatUptime(now - e.startedAt);
+    const task = e.task.length > 70 ? e.task.slice(0, 67) + "…" : e.task;
+    return `• ${e.id}  ${e.agent} (pid ${e.pid}, up ${up})  ${e.cwd}\n    "${task}"`;
+}
+/**
+ * Send `signal` to the process group led by `pid`, falling back to the lone
+ * process if the group send fails. Returns true if either delivery succeeded.
+ */
+function signalGroup(pid, signal) {
+    try {
+        process.kill(-pid, signal); // negative pid → whole process group
+        return true;
+    }
+    catch {
+        try {
+            process.kill(pid, signal);
+            return true;
+        }
+        catch {
+            return false; // already gone, or not permitted
+        }
+    }
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+export const signalAgentTool = {
+    name: "signal_agent",
+    description: "List or stop the CLI agents LISA dispatched. action:'list' shows the still-running " +
+        "agents LISA launched via dispatch_agent (id, agent, pid, uptime, cwd, task). " +
+        "action:'cancel' (needs target = the id or pid from the list) stops one: SIGTERM to " +
+        "its process group, escalating to SIGKILL after a grace period (or pass force:true to " +
+        "kill immediately). Use when a dispatched agent is stuck, conflicting, or running away. " +
+        "Only agents LISA herself dispatched can be targeted — never the user's own sessions.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            action: {
+                type: "string",
+                enum: ["list", "cancel"],
+                description: "'list' the running dispatched agents, or 'cancel' one.",
+            },
+            target: {
+                type: "string",
+                description: "For cancel: the dispatch id (preferred) or the pid of the agent to stop. From action:'list'.",
+            },
+            force: {
+                type: "boolean",
+                description: "Cancel only: skip graceful SIGTERM and SIGKILL the process group immediately (default false).",
+            },
+        },
+        required: ["action"],
+        additionalProperties: false,
+    },
+    async execute(input, ctx) {
+        const now = Date.now();
+        if (input.action === "list") {
+            const live = listLiveDispatches();
+            if (live.length === 0) {
+                return "No agents dispatched by LISA are currently running. (Only agents launched via dispatch_agent are tracked here.)";
+            }
+            const lines = live
+                .sort((a, b) => a.startedAt - b.startedAt)
+                .map((e) => formatDispatchLine(e, now))
+                .join("\n");
+            return `${live.length} dispatched agent${live.length === 1 ? "" : "s"} running:\n${lines}\n\nCancel one with signal_agent({action:"cancel", target:"<id>"}).`;
+        }
+        // action === "cancel"
+        const target = (input.target ?? "").trim();
+        if (!target) {
+            return 'cancel needs a target — the dispatch id or pid from signal_agent({action:"list"}).';
+        }
+        const entry = findDispatch(target);
+        if (!entry) {
+            const live = listLiveDispatches();
+            const hint = live.length > 0
+                ? ` Currently running: ${live.map((e) => `${e.id} (${e.agent}, pid ${e.pid})`).join(", ")}.`
+                : " No dispatched agents are running.";
+            return `No running dispatched agent matches "${target}".${hint}`;
+        }
+        const sig = input.force ? "SIGKILL" : "SIGTERM";
+        const delivered = signalGroup(entry.pid, sig);
+        if (!delivered && !isAlive(entry.pid)) {
+            // It exited on its own between the lookup and the signal — clean up.
+            removeDispatch(entry.id);
+            return `${entry.agent} (pid ${entry.pid}) had already exited; removed it from the ledger.`;
+        }
+        let escalated = false;
+        if (!input.force) {
+            // Give it a moment to shut down gracefully, then SIGKILL if it clings on.
+            await sleep(1500);
+            if (isAlive(entry.pid)) {
+                escalated = signalGroup(entry.pid, "SIGKILL");
+            }
+        }
+        removeDispatch(entry.id);
+        ctx.log(`[signal] cancelled ${entry.agent} (pid ${entry.pid}) in ${entry.cwd}${escalated ? " [SIGKILL]" : ""}`);
+        const how = input.force
+            ? "SIGKILL"
+            : escalated
+                ? "SIGTERM then SIGKILL"
+                : "SIGTERM";
+        return `Cancelled ${entry.agent} (pid ${entry.pid}) in ${entry.cwd} via ${how}. Removed from the dispatch ledger.`;
+    },
+};
+//# sourceMappingURL=signal_agent.js.map

package/dist/tools/signal_agent.js.map

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