@oratis/lisa 0.7.0 → 0.9.0

package/dist/tools/github_link.d.ts

@@ -0,0 +1,36 @@
+import type { ToolDefinition } from "../types.js";
+interface GithubLinkInput {
+    /** What to link: repo (default), branch, commit, file, pr, issue. */
+    target?: "repo" | "branch" | "commit" | "file" | "pr" | "issue";
+    cwd?: string;
+    /** Branch name or commit sha; defaults to the current branch/HEAD. */
+    ref?: string;
+    /** For target:file — path (absolute or repo-relative). */
+    path?: string;
+    start_line?: number;
+    end_line?: number;
+    /** For target:pr/issue — the number. */
+    number?: number;
+    /** Also open the URL in the default browser. */
+    open?: boolean;
+}
+export interface Remote {
+    host: string;
+    owner: string;
+    repo: string;
+}
+/** Parse a git remote URL (scp or https/ssh) into host/owner/repo. Pure. */
+export declare function parseRemote(url: string): Remote | null;
+/** Build a GitHub URL for the given target. Pure + tested. */
+export declare function buildUrl(r: Remote, target: NonNullable<GithubLinkInput["target"]>, opts?: {
+    ref?: string;
+    path?: string;
+    startLine?: number;
+    endLine?: number;
+    number?: number;
+}): string | {
+    error: string;
+};
+export declare const githubLinkTool: ToolDefinition<GithubLinkInput, string>;
+export {};
+//# sourceMappingURL=github_link.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github_link.d.ts","sourceRoot":"","sources":["../../src/tools/github_link.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,UAAU,eAAe;IACvB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAatD;AAED,8DAA8D;AAC9D,wBAAgB,QAAQ,CACtB,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,EAC9C,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChG,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CA2B5B;AAED,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,eAAe,EAAE,MAAM,CAgElE,CAAC"}

package/dist/tools/github_link.js

@@ -0,0 +1,127 @@
+/**
+ * github_link (vibe-coding) — turn the local git context into a shareable
+ * GitHub URL: the repo, a branch, a commit, a file (optionally with a line
+ * range), or a PR / issue. So when LISA references "src/web/server.ts:120" or
+ * "PR #58" she can hand you a clickable link instead of a path.
+ *
+ * URL building is pure git (parses `origin`), so it needs no gh. `open:true`
+ * best-effort opens it in your browser.
+ */
+import path from "node:path";
+import { runIn, isDir, gitRoot } from "./exec-util.js";
+/** Parse a git remote URL (scp or https/ssh) into host/owner/repo. Pure. */
+export function parseRemote(url) {
+    let s = url.trim().replace(/\.git$/i, "").replace(/\/$/, "");
+    // scp-like: git@github.com:owner/repo  (also ssh://git@github.com/owner/repo)
+    let m = s.match(/^(?:ssh:\/\/)?[^@\s]*@([^:/]+)[:/](.+)$/i);
+    if (!m) {
+        // url: https://github.com/owner/repo
+        m = s.match(/^https?:\/\/(?:[^@/]+@)?([^/]+)\/(.+)$/i);
+    }
+    if (!m)
+        return null;
+    const host = m[1];
+    const parts = m[2].split("/").filter(Boolean);
+    if (parts.length < 2)
+        return null;
+    return { host, owner: parts[0], repo: parts[1] };
+}
+/** Build a GitHub URL for the given target. Pure + tested. */
+export function buildUrl(r, target, opts = {}) {
+    const base = `https://${r.host}/${r.owner}/${r.repo}`;
+    switch (target) {
+        case "repo":
+            return base;
+        case "branch":
+            return opts.ref ? `${base}/tree/${encodeURIComponent(opts.ref)}` : base;
+        case "commit":
+            return opts.ref ? `${base}/commit/${opts.ref}` : { error: "commit needs a ref/sha" };
+        case "file": {
+            if (!opts.path)
+                return { error: "file needs a path" };
+            const ref = opts.ref || "HEAD";
+            const cleanPath = opts.path.split("/").map(encodeURIComponent).join("/").replace(/^\//, "");
+            let url = `${base}/blob/${encodeURIComponent(ref)}/${cleanPath}`;
+            if (opts.startLine) {
+                url += `#L${opts.startLine}`;
+                if (opts.endLine && opts.endLine !== opts.startLine)
+                    url += `-L${opts.endLine}`;
+            }
+            return url;
+        }
+        case "pr":
+            return opts.number ? `${base}/pull/${opts.number}` : { error: "pr needs a number" };
+        case "issue":
+            return opts.number ? `${base}/issues/${opts.number}` : { error: "issue needs a number" };
+        default:
+            return { error: `unknown target: ${target}` };
+    }
+}
+export const githubLinkTool = {
+    name: "github_link",
+    description: "Build a shareable GitHub URL from the local git repo: target 'repo' (default), 'branch', " +
+        "'commit', 'file' (path + optional start_line/end_line), 'pr' or 'issue' (number). Defaults the " +
+        "ref to the current branch / HEAD. Use to give the user a clickable link to a file/line, commit, " +
+        "branch, or PR you're referencing. open:true also opens it in the browser. Needs a GitHub `origin` " +
+        "remote; no gh required.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            target: { type: "string", enum: ["repo", "branch", "commit", "file", "pr", "issue"] },
+            cwd: { type: "string", description: "Absolute path inside the repo. Defaults to the current directory." },
+            ref: { type: "string", description: "Branch name or commit sha. Defaults to the current branch (for file/branch) or HEAD." },
+            path: { type: "string", description: "For target:file — absolute or repo-relative file path." },
+            start_line: { type: "integer", minimum: 1 },
+            end_line: { type: "integer", minimum: 1 },
+            number: { type: "integer", minimum: 1, description: "For target:pr or issue." },
+            open: { type: "boolean", description: "Also open the URL in the default browser." },
+        },
+        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 remoteR = await runIn(root, "git", ["-C", root, "remote", "get-url", "origin"], { timeoutMs: 5000, signal: ctx.signal });
+        if (remoteR.code !== 0)
+            return "(no `origin` remote on this repo)";
+        const remote = parseRemote(remoteR.stdout);
+        if (!remote)
+            return `(couldn't parse a GitHub URL from origin: ${remoteR.stdout.trim().slice(0, 120)})`;
+        const target = input.target ?? "repo";
+        // Resolve a default ref for branch/file when none given.
+        let ref = input.ref;
+        if (!ref && (target === "branch" || target === "file")) {
+            const b = await runIn(root, "git", ["-C", root, "rev-parse", "--abbrev-ref", "HEAD"], { timeoutMs: 5000, signal: ctx.signal });
+            if (b.code === 0)
+                ref = b.stdout.trim();
+        }
+        if (!ref && target === "commit") {
+            const h = await runIn(root, "git", ["-C", root, "rev-parse", "HEAD"], { timeoutMs: 5000, signal: ctx.signal });
+            if (h.code === 0)
+                ref = h.stdout.trim();
+        }
+        // For file: make the path repo-relative.
+        let filePath = input.path;
+        if (target === "file" && filePath) {
+            if (filePath.startsWith("/"))
+                filePath = path.relative(root, filePath);
+            if (filePath.startsWith(".."))
+                return `(file is outside the repo: ${input.path})`;
+        }
+        const built = buildUrl(remote, target, { ref, path: filePath, startLine: input.start_line, endLine: input.end_line, number: input.number });
+        if (typeof built !== "string")
+            return `(${built.error})`;
+        if (input.open) {
+            const opener = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
+            const args = process.platform === "win32" ? ["/c", "start", built] : [built];
+            runIn(root, opener, args, { timeoutMs: 5000, signal: ctx.signal }).catch(() => { });
+            return `${built}\n(opened in browser)`;
+        }
+        return built;
+    },
+};
+//# sourceMappingURL=github_link.js.map

package/dist/tools/github_link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github_link.js","sourceRoot":"","sources":["../../src/tools/github_link.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAwBvD,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC7D,8EAA8E;IAC9E,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC5D,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,qCAAqC;QACrC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IACnB,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAE,EAAE,CAAC;AACrD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,QAAQ,CACtB,CAAS,EACT,MAA8C,EAC9C,OAA+F,EAAE;IAEjG,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;QACd,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,SAAS,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1E,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,WAAW,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;QACvF,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,IAAI,CAAC,IAAI,CAAC,IAAI;gBAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;YACtD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC;YAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5F,IAAI,GAAG,GAAG,GAAG,IAAI,SAAS,kBAAkB,CAAC,GAAG,CAAC,IAAI,SAAS,EAAE,CAAC;YACjE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,GAAG,IAAI,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC7B,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,SAAS;oBAAE,GAAG,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAClF,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,KAAK,IAAI;YACP,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;QACtF,KAAK,OAAO;YACV,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC;QAC3F;YACE,OAAO,EAAE,KAAK,EAAE,mBAAmB,MAAM,EAAE,EAAE,CAAC;IAClD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAA4C;IACrE,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,2FAA2F;QAC3F,iGAAiG;QACjG,kGAAkG;QAClG,oGAAoG;QACpG,yBAAyB;IAC3B,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE;YACrF,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mEAAmE,EAAE;YACzG,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sFAAsF,EAAE;YAC5H,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wDAAwD,EAAE;YAC/F,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;YAC3C,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;YACzC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE;YAC/E,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,2CAA2C,EAAE;SACpF;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,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI;YAAE,OAAO,oBAAoB,GAAG,GAAG,CAAC;QAE7C,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/H,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,mCAAmC,CAAC;QACnE,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM;YAAE,OAAO,6CAA6C,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;QAExG,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC;QAEtC,yDAAyD;QACzD,IAAI,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,MAAM,CAAC,EAAE,CAAC;YACvD,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YAC/H,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;gBAAE,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,GAAG,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YAC/G,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;gBAAE,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1C,CAAC;QAED,yCAAyC;QACzC,IAAI,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC;QAC1B,IAAI,MAAM,KAAK,MAAM,IAAI,QAAQ,EAAE,CAAC;YAClC,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACvE,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,OAAO,8BAA8B,KAAK,CAAC,IAAI,GAAG,CAAC;QACpF,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5I,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC;QAEzD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;YAC1G,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAC7E,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACnF,OAAO,GAAG,KAAK,uBAAuB,CAAC;QACzC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC"}

package/dist/tools/inspect_agent.d.ts

@@ -0,0 +1,21 @@
+/**
+ * inspect_agent (vibe-coding) — the deep view of ONE observed session, where
+ * list_agents is the one-line-each roster. Full structural activity for the
+ * matched session: state + reason, branch, turn count, every tool it has run,
+ * every file it has touched, last command, pending permission, error, tokens.
+ *
+ * PRIVACY: structural metadata only — never conversation content (file PATHS
+ * and tool NAMES, not contents). For what a repo actually changed, use
+ * repo_digest / review_diff against its cwd.
+ */
+import type { ToolDefinition } from "../types.js";
+import type { AgentSession } from "../integrations/types.js";
+interface InspectInput {
+    /** Session id (or a prefix), or a project name, to inspect. */
+    target: string;
+}
+/** Pure: full structural detail for one session. Exported for tests. */
+export declare function formatDetail(s: AgentSession, now: number): string;
+export declare const inspectAgentTool: ToolDefinition<InspectInput, string>;
+export {};
+//# sourceMappingURL=inspect_agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspect_agent.d.ts","sourceRoot":"","sources":["../../src/tools/inspect_agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,UAAU,YAAY;IACpB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;CAChB;AAUD,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAmBjE;AAYD,eAAO,MAAM,gBAAgB,EAAE,cAAc,CAAC,YAAY,EAAE,MAAM,CAoCjE,CAAC"}

package/dist/tools/inspect_agent.js

@@ -0,0 +1,87 @@
+import { getCurrentHub } from "../integrations/current-hub.js";
+function ago(ms, now) {
+    const s = Math.max(0, Math.floor((now - ms) / 1000));
+    if (s < 60)
+        return `${s}s ago`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m ago`;
+    return `${Math.floor(m / 60)}h ago`;
+}
+/** Pure: full structural detail for one session. Exported for tests. */
+export function formatDetail(s, now) {
+    const a = s.activity;
+    const lines = [];
+    lines.push(`${s.project} · ${s.agent} · ${s.sessionId}`);
+    lines.push(`  state: ${s.state}${s.stateReason ? ` (${s.stateReason})` : ""} · last active ${ago(s.lastMtime, now)}`);
+    if (s.cwd)
+        lines.push(`  cwd: ${s.cwd}`);
+    if (a?.gitBranch)
+        lines.push(`  branch: ${a.gitBranch}`);
+    if (typeof a?.turnCount === "number")
+        lines.push(`  turns: ${a.turnCount}`);
+    if (a?.pendingPermission)
+        lines.push(`  ⏳ waiting on permission: ${a.pendingPermission}`);
+    if (a?.lastCommandName)
+        lines.push(`  last command: ${a.lastCommandName}`);
+    if (a?.lastTools && a.lastTools.length)
+        lines.push(`  tools: ${a.lastTools.join(" → ")}`);
+    if (a?.filesTouched && a.filesTouched.length) {
+        lines.push(`  files touched (${a.filesTouched.length}):`);
+        for (const f of a.filesTouched.slice(0, 15))
+            lines.push(`    ${f}`);
+        if (a.filesTouched.length > 15)
+            lines.push(`    … +${a.filesTouched.length - 15} more`);
+    }
+    if (a?.tokens)
+        lines.push(`  tokens: ${a.tokens.input} in / ${a.tokens.output} out`);
+    if (a?.lastError)
+        lines.push(`  error: ${a.lastError}`);
+    return lines.join("\n");
+}
+function matches(s, target) {
+    const t = target.toLowerCase();
+    return (s.sessionId.toLowerCase().startsWith(t) ||
+        s.sessionId.toLowerCase() === t ||
+        s.project.toLowerCase() === t ||
+        s.project.toLowerCase().includes(t));
+}
+export const inspectAgentTool = {
+    name: "inspect_agent",
+    description: "Deep-dive one observed agent session (by session id / prefix, or project name): its full " +
+        "structural activity — state + reason, git branch, turn count, every tool it ran, all files it " +
+        "touched, last command, pending permission, errors, token usage. Use when the user asks 'what is " +
+        "<session/project> doing in detail'. list_agents is the roster; this is one session. Structural " +
+        "metadata only — never conversation content.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            target: { type: "string", description: "Session id (or prefix) or project name to inspect." },
+        },
+        required: ["target"],
+        additionalProperties: false,
+    },
+    async execute(input) {
+        const hub = getCurrentHub();
+        if (!hub)
+            return "(agent monitoring isn't active — start the web server with `lisa serve --web`)";
+        const target = (input.target ?? "").trim();
+        if (!target)
+            return "(give a session id or project name to inspect)";
+        const now = Date.now();
+        const all = hub.list();
+        const hits = all.filter((s) => matches(s, target));
+        if (hits.length === 0) {
+            const names = all.map((s) => `${s.project} (${s.sessionId.slice(0, 8)})`).slice(0, 10).join(", ");
+            return `(no observed session matches "${target}". Active: ${names || "none"})`;
+        }
+        if (hits.length > 1) {
+            // Disambiguate, but still detail the most recently active one.
+            hits.sort((a, b) => b.lastMtime - a.lastMtime);
+            const head = `(${hits.length} match "${target}"; showing the most recent — narrow by session id)\n`;
+            return head + formatDetail(hits[0], now);
+        }
+        return formatDetail(hits[0], now);
+    },
+};
+//# sourceMappingURL=inspect_agent.js.map

package/dist/tools/inspect_agent.js.map

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

package/dist/tools/list_agents.d.ts

@@ -0,0 +1,21 @@
+/**
+ * list_agents (orchestrator OBSERVE — read side) — enumerate the CLI agent
+ * sessions LISA is watching (Claude Code, Codex, …) with their structural
+ * activity, so she can answer "what are my agents doing right now?" in chat.
+ *
+ * Fills the gap between:
+ *   - advise_now  — only the relevance-gated *summary* ("10 active, nothing notable")
+ *   - signal_agent — only LISA's OWN dispatched agents (the user's manual sessions
+ *                    are observed but unreachable there)
+ * The sidebar/island already show this data; this exposes it to the chat agent.
+ *
+ * PRIVACY: structural metadata only — state, project, git branch, tool/command
+ * NAMES, file PATHS, counts, error strings. Never a prompt, a reply, or full
+ * command arguments. Same boundary the parser privacy tests assert.
+ */
+import type { ToolDefinition } from "../types.js";
+import type { AgentSession } from "../integrations/types.js";
+/** One session → a readable, structural-only line. Pure, for display + tests. */
+export declare function formatSessionLine(s: AgentSession, now: number): string;
+export declare const listAgentsTool: ToolDefinition<Record<string, never>, string>;
+//# sourceMappingURL=list_agents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list_agents.d.ts","sourceRoot":"","sources":["../../src/tools/list_agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAoB7D,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAiBtE;AAED,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CA2BxE,CAAC"}

package/dist/tools/list_agents.js

@@ -0,0 +1,88 @@
+/**
+ * list_agents (orchestrator OBSERVE — read side) — enumerate the CLI agent
+ * sessions LISA is watching (Claude Code, Codex, …) with their structural
+ * activity, so she can answer "what are my agents doing right now?" in chat.
+ *
+ * Fills the gap between:
+ *   - advise_now  — only the relevance-gated *summary* ("10 active, nothing notable")
+ *   - signal_agent — only LISA's OWN dispatched agents (the user's manual sessions
+ *                    are observed but unreachable there)
+ * The sidebar/island already show this data; this exposes it to the chat agent.
+ *
+ * PRIVACY: structural metadata only — state, project, git branch, tool/command
+ * NAMES, file PATHS, counts, error strings. Never a prompt, a reply, or full
+ * command arguments. Same boundary the parser privacy tests assert.
+ */
+import { getCurrentHub } from "../integrations/current-hub.js";
+const STATE_RANK = {
+    error: 0,
+    waiting: 1,
+    working: 2,
+    done: 3,
+    idle: 4,
+    unknown: 5,
+};
+function ago(ms, now) {
+    const d = Math.max(0, now - ms);
+    const s = Math.floor(d / 1000);
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m`;
+    return `${Math.floor(m / 60)}h`;
+}
+/** One session → a readable, structural-only line. Pure, for display + tests. */
+export function formatSessionLine(s, now) {
+    const a = s.activity;
+    const bits = [];
+    if (a?.gitBranch)
+        bits.push(`@${a.gitBranch}`);
+    if (a?.pendingPermission)
+        bits.push(`⏳ needs permission: ${a.pendingPermission}`);
+    else if (a?.lastCommandName)
+        bits.push(`$ ${a.lastCommandName}`);
+    else if (a?.lastTools && a.lastTools.length)
+        bits.push(a.lastTools.slice(-3).join("→"));
+    if (a?.lastError)
+        bits.push(`error: ${a.lastError}`);
+    if (a?.filesTouched && a.filesTouched.length) {
+        const f = a.filesTouched
+            .slice(-2)
+            .map((p) => p.split("/").pop() ?? p)
+            .join(", ");
+        bits.push(`files: ${f}`);
+    }
+    const detail = bits.length ? " · " + bits.join(" · ") : "";
+    return `• [${s.state}] ${s.project} (${s.agent}, ${ago(s.lastMtime, now)} ago)${detail}`;
+}
+export const listAgentsTool = {
+    name: "list_agents",
+    description: "List the CLI agent sessions LISA is observing right now (Claude Code, Codex, …) with their " +
+        "structural activity: state (working/waiting/error/idle), project, git branch, last tool/command " +
+        "NAME, files touched, pending permission, errors. Use when the user asks what their agents are " +
+        "doing, what's running, or 'what is <agent> up to'. Structural metadata only — never conversation " +
+        "content; to see what a repo actually changed, read its `git log`. For LISA's OWN dispatched " +
+        "agents (start/stop) use signal_agent; for a relevance-gated summary use advise_now.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    async execute() {
+        const hub = getCurrentHub();
+        if (!hub) {
+            return "(agent monitoring isn't active — start the web server with `lisa serve --web`)";
+        }
+        const now = Date.now();
+        const sessions = hub.list();
+        if (sessions.length === 0)
+            return "(no agents are active right now)";
+        const sorted = sessions.slice().sort((a, b) => {
+            const ra = STATE_RANK[a.state] ?? 9;
+            const rb = STATE_RANK[b.state] ?? 9;
+            if (ra !== rb)
+                return ra - rb;
+            return b.lastMtime - a.lastMtime;
+        });
+        const head = `${sessions.length} agent session(s) observed (structural activity only):`;
+        return [head, ...sorted.map((s) => formatSessionLine(s, now))].join("\n");
+    },
+};
+//# sourceMappingURL=list_agents.js.map

package/dist/tools/list_agents.js.map

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

package/dist/tools/mcp.d.ts

@@ -0,0 +1,28 @@
+/**
+ * mcp (integration) — manage LISA's MCP server connections, so she can connect
+ * any integration that ships an MCP server (GitHub, Linear, Sentry, Postgres,
+ * filesystem, …) on request, rather than each needing a bespoke tool. MCP is
+ * the standard way to "add all the integrations an agent might use".
+ *
+ *   list   — configured MCP servers (from ~/.lisa/mcp.json)
+ *   add    — add a server (name + command [+ args/env]); connects on next start
+ *   remove — remove a server
+ *
+ * Servers connect at startup, so add/remove take effect after a restart
+ * (`lisa serve --web`). Their tools then appear in LISA's toolset automatically.
+ */
+import type { ToolDefinition } from "../types.js";
+interface McpInput {
+    action: "list" | "add" | "remove";
+    name?: string;
+    /** For add: the server command, e.g. "npx". */
+    command?: string;
+    /** For add: command args, e.g. ["-y","@modelcontextprotocol/server-filesystem","/path"]. */
+    args?: string[];
+    /** For add: env vars the server needs (e.g. API tokens). */
+    env?: Record<string, string>;
+    enabled?: boolean;
+}
+export declare const mcpTool: ToolDefinition<McpInput, string>;
+export {};
+//# sourceMappingURL=mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/tools/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,UAAU,QAAQ;IAChB,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4FAA4F;IAC5F,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,QAAQ,EAAE,MAAM,CA0DpD,CAAC"}

package/dist/tools/mcp.js

@@ -0,0 +1,55 @@
+import { loadMcpConfig, saveMcpServer, deleteMcpServer, MCP_CONFIG_PATH } from "../mcp/config.js";
+export const mcpTool = {
+    name: "mcp",
+    description: "Manage MCP server connections — the standard way to add external integrations (GitHub, Linear, " +
+        "Sentry, Postgres, filesystem, …) whose tools then appear in LISA's toolset. action:'list' shows " +
+        "configured servers; 'add' (name + command [+ args/env]) adds one; 'remove' (name) deletes one. " +
+        "Servers connect at startup, so add/remove take effect after restarting `lisa serve --web`. Use " +
+        "when the user wants to connect a new integration via its MCP server.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            action: { type: "string", enum: ["list", "add", "remove"] },
+            name: { type: "string", description: "Server name (for add/remove)." },
+            command: { type: "string", description: "Executable for add, e.g. 'npx'." },
+            args: { type: "array", items: { type: "string" }, description: "Args for add, e.g. ['-y','@scope/server-x']." },
+            env: { type: "object", additionalProperties: { type: "string" }, description: "Env vars the server needs (e.g. API tokens)." },
+            enabled: { type: "boolean", description: "Whether the server is enabled (default true)." },
+        },
+        required: ["action"],
+        additionalProperties: false,
+    },
+    async execute(input) {
+        if (input.action === "list") {
+            const servers = await loadMcpConfig();
+            if (servers.length === 0) {
+                return `(no MCP servers configured — add one with mcp action:'add', or edit ${MCP_CONFIG_PATH})`;
+            }
+            return (`${servers.length} MCP server(s) in ${MCP_CONFIG_PATH}:\n` +
+                servers
+                    .map((s) => `  ${s.name}${s.enabled === false ? " (disabled)" : ""}: ${s.command} ${(s.args ?? []).join(" ")}`.trimEnd())
+                    .join("\n"));
+        }
+        if (input.action === "remove") {
+            if (!input.name)
+                return "(remove needs a name — from mcp action:'list')";
+            const ok = await deleteMcpServer(input.name);
+            return ok
+                ? `Removed MCP server "${input.name}". Restart \`lisa serve --web\` for it to disconnect.`
+                : `(no MCP server named "${input.name}")`;
+        }
+        // add
+        if (!input.name || !input.command) {
+            return "(add needs a name and a command, e.g. name:'filesystem' command:'npx' args:['-y','@modelcontextprotocol/server-filesystem','/path'])";
+        }
+        await saveMcpServer(input.name, {
+            command: input.command,
+            args: input.args ?? [],
+            env: input.env,
+            enabled: input.enabled ?? true,
+        });
+        return (`Added MCP server "${input.name}": ${input.command} ${(input.args ?? []).join(" ")}`.trimEnd() +
+            `\nRestart \`lisa serve --web\` to connect it — its tools then appear in my toolset automatically.`);
+    },
+};
+//# sourceMappingURL=mcp.js.map

package/dist/tools/mcp.js.map

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

package/dist/tools/npm_info.d.ts

@@ -0,0 +1,21 @@
+/**
+ * npm_info (integration) — the npm registry, the external service every JS
+ * agent touches. view a package's metadata, find outdated deps in a repo, or
+ * audit it for known vulnerabilities. No auth; uses the local npm CLI.
+ */
+import type { ToolDefinition } from "../types.js";
+interface NpmInput {
+    action: "view" | "outdated" | "audit";
+    /** Package name for view (optionally name@range). */
+    package?: string;
+    cwd?: string;
+}
+/** Pure: format `npm view --json` metadata. Exported for tests. */
+export declare function formatView(json: string): string;
+/** Pure: format `npm outdated --json`. Exported for tests. */
+export declare function formatOutdated(json: string): string;
+/** Pure: summarise `npm audit --json` (npm v7+ shape). Exported for tests. */
+export declare function formatAudit(json: string): string;
+export declare const npmInfoTool: ToolDefinition<NpmInput, string>;
+export {};
+//# sourceMappingURL=npm_info.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"npm_info.d.ts","sourceRoot":"","sources":["../../src/tools/npm_info.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,UAAU,QAAQ;IAChB,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;IACtC,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAa/C;AAED,8DAA8D;AAC9D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAShD;AAED,eAAO,MAAM,WAAW,EAAE,cAAc,CAAC,QAAQ,EAAE,MAAM,CA2CxD,CAAC"}