@oratis/lisa 0.2.0

package/dist/channels/telegram.js

@@ -0,0 +1,103 @@
+import { registerChannel } from "./registry.js";
+const API = (token) => `https://api.telegram.org/bot${token}`;
+export class TelegramChannel {
+    name = "telegram";
+    opts;
+    offset = 0;
+    running = false;
+    handler;
+    constructor(opts) {
+        if (!opts.token)
+            throw new Error("telegram: token is required");
+        this.opts = opts;
+    }
+    async start(handler) {
+        this.handler = handler;
+        this.running = true;
+        // Disable any old webhook so long-poll works.
+        try {
+            await this.api("deleteWebhook", { drop_pending_updates: false });
+        }
+        catch { }
+        void this.poll();
+    }
+    async stop() {
+        this.running = false;
+    }
+    async send(msg) {
+        const chatId = msg.threadId ?? msg.to;
+        await this.api("sendMessage", {
+            chat_id: parseInt(chatId, 10) || chatId,
+            text: msg.text,
+            parse_mode: "Markdown",
+        });
+    }
+    async poll() {
+        while (this.running) {
+            try {
+                const updates = await this.api("getUpdates", {
+                    offset: this.offset,
+                    timeout: this.opts.longPollSec ?? 30,
+                    allowed_updates: ["message"],
+                });
+                for (const u of updates) {
+                    if (u.update_id >= this.offset)
+                        this.offset = u.update_id + 1;
+                    const m = u.message;
+                    if (!m || !m.text)
+                        continue;
+                    if (!this.allowed(m))
+                        continue;
+                    await this.handler?.({
+                        channel: this.name,
+                        from: String(m.chat.id),
+                        text: m.text,
+                        threadId: String(m.chat.id),
+                        receivedAt: new Date(m.date * 1000),
+                    });
+                }
+            }
+            catch (err) {
+                console.error(`[telegram] poll error: ${err.message}`);
+                await new Promise((r) => setTimeout(r, 3_000));
+            }
+        }
+    }
+    allowed(m) {
+        if (this.opts.allowedChatIds?.length) {
+            if (!this.opts.allowedChatIds.includes(m.chat.id))
+                return false;
+        }
+        if (this.opts.allowedUsernames?.length) {
+            const u = (m.from?.username ?? "").toLowerCase();
+            if (!u || !this.opts.allowedUsernames.map((x) => x.toLowerCase()).includes(u)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    async api(method, body) {
+        const res = await fetch(`${API(this.opts.token)}/${method}`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(body),
+        });
+        const json = (await res.json());
+        if (!json.ok)
+            throw new Error(`telegram ${method}: ${json.description}`);
+        return json.result;
+    }
+}
+registerChannel("telegram", (cfg) => {
+    return new TelegramChannel({
+        token: String(cfg.token ?? ""),
+        allowedChatIds: Array.isArray(cfg.allowedChatIds)
+            ? cfg.allowedChatIds
+            : undefined,
+        allowedUsernames: Array.isArray(cfg.allowedUsernames)
+            ? cfg.allowedUsernames
+            : undefined,
+        longPollSec: typeof cfg.longPollSec === "number" ? cfg.longPollSec : undefined,
+    });
+});
+//# sourceMappingURL=telegram.js.map

package/dist/channels/telegram.js.map

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

package/dist/channels/types.d.ts

@@ -0,0 +1,20 @@
+export interface IncomingMessage {
+    channel: string;
+    from: string;
+    text: string;
+    threadId?: string;
+    receivedAt: Date;
+}
+export interface OutgoingMessage {
+    channel: string;
+    to: string;
+    text: string;
+    threadId?: string;
+}
+export interface ChannelAdapter {
+    readonly name: string;
+    start(handler: (msg: IncomingMessage) => Promise<void>): Promise<void>;
+    send(msg: OutgoingMessage): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/channels/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,IAAI,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}

package/dist/channels/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/channels/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":""}

package/dist/channels/webhook.d.ts

@@ -0,0 +1,34 @@
+import type { ChannelAdapter, IncomingMessage, OutgoingMessage } from "./types.js";
+interface WebhookOptions {
+    port: number;
+    /** Bearer token expected in `Authorization: Bearer <token>` header. */
+    token: string;
+    /** Optional outbound webhook URL to POST replies to. */
+    replyUrl?: string;
+}
+/**
+ * Generic webhook channel for any sender that can POST JSON.
+ *
+ * Inbound:  POST /  with Authorization: Bearer <token>
+ *           body: {"from": "<sender id>", "text": "...", "threadId"?: "..."}
+ *           Lisa replies inline (long-running response) — the HTTP request stays
+ *           open until she's done answering, then her reply is the response body.
+ *
+ * Outbound: if `replyUrl` is configured, replies are also POSTed there as
+ *           {"to": "<sender>", "text": "...", "threadId"?: "...", "channel": "webhook"}.
+ */
+export declare class WebhookChannel implements ChannelAdapter {
+    readonly name = "webhook";
+    private server?;
+    private opts;
+    private handler?;
+    private pending;
+    constructor(opts: WebhookOptions);
+    start(handler: (msg: IncomingMessage) => Promise<void>): Promise<void>;
+    stop(): Promise<void>;
+    send(msg: OutgoingMessage): Promise<void>;
+    private onRequest;
+    private checkAuth;
+}
+export {};
+//# sourceMappingURL=webhook.d.ts.map

package/dist/channels/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/channels/webhook.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAQD;;;;;;;;;;GAUG;AACH,qBAAa,cAAe,YAAW,cAAc;IACnD,QAAQ,CAAC,IAAI,aAAa;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAc;IAC7B,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,OAAO,CAAC,CAA0C;IAC1D,OAAO,CAAC,OAAO,CAAmC;gBAEtC,IAAI,EAAE,cAAc;IAK1B,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAStE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,IAAI,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B/C,OAAO,CAAC,SAAS;IAyDjB,OAAO,CAAC,SAAS;CAYlB"}

package/dist/channels/webhook.js

@@ -0,0 +1,139 @@
+import http from "node:http";
+import crypto from "node:crypto";
+import { registerChannel } from "./registry.js";
+/**
+ * Generic webhook channel for any sender that can POST JSON.
+ *
+ * Inbound:  POST /  with Authorization: Bearer <token>
+ *           body: {"from": "<sender id>", "text": "...", "threadId"?: "..."}
+ *           Lisa replies inline (long-running response) — the HTTP request stays
+ *           open until she's done answering, then her reply is the response body.
+ *
+ * Outbound: if `replyUrl` is configured, replies are also POSTed there as
+ *           {"to": "<sender>", "text": "...", "threadId"?: "...", "channel": "webhook"}.
+ */
+export class WebhookChannel {
+    name = "webhook";
+    server;
+    opts;
+    handler;
+    pending = new Map();
+    constructor(opts) {
+        if (!opts.token)
+            throw new Error("webhook: token is required (set a shared secret)");
+        this.opts = opts;
+    }
+    async start(handler) {
+        this.handler = handler;
+        this.server = http.createServer((req, res) => this.onRequest(req, res));
+        await new Promise((resolve) => this.server.listen(this.opts.port, resolve));
+        console.error(`[webhook] listening on http://localhost:${this.opts.port} (Bearer auth required)`);
+    }
+    async stop() {
+        if (this.server) {
+            await new Promise((resolve) => this.server.close(() => resolve()));
+        }
+    }
+    async send(msg) {
+        // Resolve any pending HTTP request for this thread.
+        const key = msg.threadId ?? msg.to;
+        const pending = this.pending.get(key);
+        if (pending) {
+            this.pending.delete(key);
+            pending.resolve(msg.text);
+        }
+        // Also POST to the configured replyUrl if set.
+        if (this.opts.replyUrl) {
+            try {
+                await fetch(this.opts.replyUrl, {
+                    method: "POST",
+                    headers: { "content-type": "application/json" },
+                    body: JSON.stringify({
+                        channel: this.name,
+                        to: msg.to,
+                        text: msg.text,
+                        threadId: msg.threadId,
+                    }),
+                });
+            }
+            catch (err) {
+                console.error(`[webhook] reply POST failed: ${err.message}`);
+            }
+        }
+    }
+    onRequest(req, res) {
+        if (req.method !== "POST") {
+            res.writeHead(405);
+            res.end();
+            return;
+        }
+        const auth = req.headers.authorization ?? "";
+        if (!this.checkAuth(auth)) {
+            res.writeHead(401);
+            res.end("unauthorized");
+            return;
+        }
+        let body = "";
+        req.on("data", (chunk) => (body += chunk));
+        req.on("end", async () => {
+            let parsed;
+            try {
+                parsed = JSON.parse(body);
+            }
+            catch {
+                res.writeHead(400);
+                res.end("bad json");
+                return;
+            }
+            if (!parsed.from || !parsed.text) {
+                res.writeHead(400);
+                res.end('expected {"from":"...","text":"..."[,"threadId":"..."]}');
+                return;
+            }
+            const key = parsed.threadId ?? parsed.from;
+            const replyPromise = new Promise((resolve, reject) => {
+                this.pending.set(key, { resolve, reject, res });
+            });
+            try {
+                await this.handler?.({
+                    channel: this.name,
+                    from: parsed.from,
+                    text: parsed.text,
+                    threadId: parsed.threadId,
+                    receivedAt: new Date(),
+                });
+                // Wait up to 5 minutes for Lisa's reply.
+                const reply = await Promise.race([
+                    replyPromise,
+                    new Promise((_, rej) => setTimeout(() => rej(new Error("timeout")), 300_000)),
+                ]);
+                res.writeHead(200, { "content-type": "application/json" });
+                res.end(JSON.stringify({ reply }));
+            }
+            catch (err) {
+                this.pending.delete(key);
+                res.writeHead(504);
+                res.end(err.message);
+            }
+        });
+    }
+    checkAuth(header) {
+        const m = header.match(/^Bearer\s+(.+)$/);
+        if (!m)
+            return false;
+        try {
+            return crypto.timingSafeEqual(Buffer.from(m[1].trim()), Buffer.from(this.opts.token));
+        }
+        catch {
+            return false;
+        }
+    }
+}
+registerChannel("webhook", (cfg) => {
+    return new WebhookChannel({
+        port: typeof cfg.port === "number" ? cfg.port : 5800,
+        token: String(cfg.token ?? ""),
+        replyUrl: typeof cfg.replyUrl === "string" ? cfg.replyUrl : undefined,
+    });
+});
+//# sourceMappingURL=webhook.js.map

package/dist/channels/webhook.js.map

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

package/dist/cli/colors.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Tiny zero-dep ANSI color helpers.
+ *
+ * Project policy is "no chalk-class CLI deps" so this module rolls its own.
+ * Every function checks if stdout is a TTY and respects NO_COLOR env;
+ * non-TTY / piped / NO_COLOR=1 output is plain text.
+ */
+export declare const dim: (s: string) => string;
+export declare const bold: (s: string) => string;
+export declare const italic: (s: string) => string;
+export declare const underline: (s: string) => string;
+export declare const red: (s: string) => string;
+export declare const green: (s: string) => string;
+export declare const yellow: (s: string) => string;
+export declare const blue: (s: string) => string;
+export declare const magenta: (s: string) => string;
+export declare const cyan: (s: string) => string;
+export declare const grey: (s: string) => string;
+export declare const greenBg: (s: string) => string;
+export declare const yellowBg: (s: string) => string;
+export declare const redBg: (s: string) => string;
+/** Status badges: ✓ green, ✗ red, ⚠ yellow, • dim. */
+export declare const ok: (s: string) => string;
+export declare const fail: (s: string) => string;
+export declare const warn: (s: string) => string;
+export declare const note: (s: string) => string;
+/** Box-drawing helpers for sectioned output. */
+export declare function rule(label?: string, width?: number): string;
+export declare function heading(label: string): string;
+//# sourceMappingURL=colors.d.ts.map

package/dist/cli/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/cli/colors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH,eAAO,MAAM,GAAG,MAPH,MAAM,KAAG,MAOQ,CAAC;AAC/B,eAAO,MAAM,IAAI,MARJ,MAAM,KAAG,MAQS,CAAC;AAChC,eAAO,MAAM,MAAM,MATN,MAAM,KAAG,MASW,CAAC;AAClC,eAAO,MAAM,SAAS,MAVT,MAAM,KAAG,MAUc,CAAC;AAErC,eAAO,MAAM,GAAG,MAZH,MAAM,KAAG,MAYS,CAAC;AAChC,eAAO,MAAM,KAAK,MAbL,MAAM,KAAG,MAaW,CAAC;AAClC,eAAO,MAAM,MAAM,MAdN,MAAM,KAAG,MAcY,CAAC;AACnC,eAAO,MAAM,IAAI,MAfJ,MAAM,KAAG,MAeU,CAAC;AACjC,eAAO,MAAM,OAAO,MAhBP,MAAM,KAAG,MAgBa,CAAC;AACpC,eAAO,MAAM,IAAI,MAjBJ,MAAM,KAAG,MAiBU,CAAC;AACjC,eAAO,MAAM,IAAI,MAlBJ,MAAM,KAAG,MAkBU,CAAC;AAEjC,eAAO,MAAM,OAAO,MApBP,MAAM,KAAG,MAoBa,CAAC;AACpC,eAAO,MAAM,QAAQ,MArBR,MAAM,KAAG,MAqBc,CAAC;AACrC,eAAO,MAAM,KAAK,MAtBL,MAAM,KAAG,MAsBW,CAAC;AAElC,sDAAsD;AACtD,eAAO,MAAM,EAAE,GAAI,GAAG,MAAM,KAAG,MAAyB,CAAC;AACzD,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,KAAG,MAAuB,CAAC;AACzD,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,KAAG,MAA0B,CAAC;AAC5D,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,KAAG,MAAuB,CAAC;AAEzD,gDAAgD;AAChD,wBAAgB,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,CAMvD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/cli/colors.js

@@ -0,0 +1,53 @@
+/**
+ * Tiny zero-dep ANSI color helpers.
+ *
+ * Project policy is "no chalk-class CLI deps" so this module rolls its own.
+ * Every function checks if stdout is a TTY and respects NO_COLOR env;
+ * non-TTY / piped / NO_COLOR=1 output is plain text.
+ */
+const NO_COLOR = process.env.NO_COLOR != null && process.env.NO_COLOR !== "" && process.env.NO_COLOR !== "0";
+function supportsColor() {
+    if (NO_COLOR)
+        return false;
+    return process.stdout.isTTY === true;
+}
+function wrap(open, close) {
+    return (s) => {
+        if (!supportsColor())
+            return s;
+        return `\x1b[${open}m${s}\x1b[${close}m`;
+    };
+}
+// Foreground colors (30-37, bright 90-97)
+export const dim = wrap(2, 22);
+export const bold = wrap(1, 22);
+export const italic = wrap(3, 23);
+export const underline = wrap(4, 24);
+export const red = wrap(31, 39);
+export const green = wrap(32, 39);
+export const yellow = wrap(33, 39);
+export const blue = wrap(34, 39);
+export const magenta = wrap(35, 39);
+export const cyan = wrap(36, 39);
+export const grey = wrap(90, 39);
+export const greenBg = wrap(42, 49);
+export const yellowBg = wrap(43, 49);
+export const redBg = wrap(41, 49);
+/** Status badges: ✓ green, ✗ red, ⚠ yellow, • dim. */
+export const ok = (s) => green("✓ " + s);
+export const fail = (s) => red("✗ " + s);
+export const warn = (s) => yellow("⚠ " + s);
+export const note = (s) => dim("• " + s);
+/** Box-drawing helpers for sectioned output. */
+export function rule(label, width = 60) {
+    if (!label)
+        return grey("─".repeat(width));
+    const padded = ` ${label} `;
+    const left = 4;
+    const right = Math.max(0, width - left - padded.length);
+    return grey("─".repeat(left)) + cyan(padded) + grey("─".repeat(right));
+}
+export function heading(label) {
+    return "\n" + bold(cyan(label)) + "\n" + grey("─".repeat(label.length));
+}
+//# sourceMappingURL=colors.js.map

package/dist/cli/colors.js.map

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

package/dist/cli/doctor.d.ts

@@ -0,0 +1,2 @@
+export declare function runDoctor(): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AA0IA,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAgD/C"}

package/dist/cli/doctor.js

@@ -0,0 +1,172 @@
+/**
+ * `lisa doctor` — health check across config / network / git / models.
+ *
+ * Diagnoses the most common "Lisa won't start" failures:
+ *   - Missing API keys
+ *   - Anthropic API unreachable (geo-block / no proxy)
+ *   - git not in PATH (soul history breaks)
+ *   - Outdated Node
+ *   - sandbox env weirdness
+ *   - heartbeat not installed
+ *
+ * Exit code: 0 if all critical checks pass, 1 if any critical issue.
+ */
+import { execSync } from "node:child_process";
+import os from "node:os";
+import path from "node:path";
+import { dim, fail, green, grey, heading, ok, rule, warn, } from "./colors.js";
+import { LISA_HOME } from "../paths.js";
+import { CONFIG_ENV_PATH } from "../env.js";
+import { SOUL_DIR } from "../soul/paths.js";
+import { listConfiguredProviders, OPENAI_COMPAT_PRESETS } from "../providers/registry.js";
+import { isBorn } from "../soul/store.js";
+import { pathExists } from "../fs-utils.js";
+const checks = [
+    {
+        label: "Node version ≥ 20",
+        critical: true,
+        run: async () => {
+            const major = parseInt(process.versions.node.split(".")[0], 10);
+            return major >= 20
+                ? { ok: true, detail: `node ${process.versions.node}` }
+                : { ok: false, detail: `node ${process.versions.node} (need ≥ 20)` };
+        },
+    },
+    {
+        label: "git available",
+        critical: false, // soul history is best-effort; Lisa works without it
+        run: async () => {
+            try {
+                const v = execSync("git --version 2>&1", { encoding: "utf8" }).trim();
+                return { ok: true, detail: v };
+            }
+            catch {
+                return { ok: false, detail: "soul git history will be disabled" };
+            }
+        },
+    },
+    {
+        label: "~/.lisa/ exists",
+        critical: false,
+        run: async () => {
+            return (await pathExists(LISA_HOME))
+                ? { ok: true, detail: LISA_HOME }
+                : { ok: false, detail: `${LISA_HOME} not yet created (will be on first run)` };
+        },
+    },
+    {
+        label: "~/.lisa/config.env exists",
+        critical: false,
+        run: async () => {
+            return (await pathExists(CONFIG_ENV_PATH))
+                ? { ok: true, detail: CONFIG_ENV_PATH }
+                : { ok: false, detail: `not found — keys must be in shell env` };
+        },
+    },
+    {
+        label: "Soul born",
+        critical: false,
+        run: async () => {
+            return (await isBorn())
+                ? { ok: true, detail: "yes" }
+                : { ok: false, detail: "run `lisa birth` (auto-runs on first session)" };
+        },
+    },
+    {
+        label: "Soul git repo initialized",
+        critical: false,
+        run: async () => {
+            const dotGit = path.join(SOUL_DIR, ".git");
+            return (await pathExists(dotGit))
+                ? { ok: true, detail: dotGit }
+                : { ok: false, detail: "init pending; will run automatically on next start" };
+        },
+    },
+    {
+        label: "At least one LLM provider configured",
+        critical: true,
+        run: async () => {
+            const provs = listConfiguredProviders().filter((p) => p.configured);
+            return provs.length > 0
+                ? { ok: true, detail: provs.map((p) => p.name).join(", ") }
+                : { ok: false, detail: "set ANTHROPIC_API_KEY / OPENAI_API_KEY / DEEPSEEK_API_KEY / etc." };
+        },
+    },
+    {
+        label: "Outbound HTTPS to api.anthropic.com",
+        critical: false, // not critical — user might use openai-compat exclusively
+        run: async () => testHttp("https://api.anthropic.com/v1/messages"),
+    },
+    {
+        label: "Outbound HTTPS to api.openai.com",
+        critical: false,
+        run: async () => testHttp("https://api.openai.com/v1/models"),
+    },
+];
+async function testHttp(url) {
+    try {
+        const r = await fetch(url, {
+            method: "HEAD",
+            signal: AbortSignal.timeout(5000),
+        });
+        // 4xx is fine — server reachable, just no auth
+        if (r.status > 0 && r.status < 600) {
+            return { ok: true, detail: `${r.status} (reachable)` };
+        }
+        return { ok: false, detail: `unexpected status ${r.status}` };
+    }
+    catch (err) {
+        const msg = err.message?.slice(0, 80) ?? "unknown error";
+        return { ok: false, detail: msg };
+    }
+}
+export async function runDoctor() {
+    console.log(rule("LISA DOCTOR"));
+    // Environment summary
+    console.log(heading("Environment"));
+    console.log(`  ${dim("platform:")}  ${process.platform} ${os.release()}`);
+    console.log(`  ${dim("node:")}      ${process.versions.node}`);
+    console.log(`  ${dim("LISA_HOME:")} ${LISA_HOME}`);
+    if (process.env.HTTPS_PROXY || process.env.HTTP_PROXY) {
+        console.log(`  ${dim("proxy:")}     ${process.env.HTTPS_PROXY ?? process.env.HTTP_PROXY}`);
+    }
+    else {
+        console.log(`  ${dim("proxy:")}     ${dim("(none)")}`);
+    }
+    // Run checks
+    console.log(heading("Checks"));
+    let failures = 0;
+    let criticalFailures = 0;
+    for (const check of checks) {
+        const r = await check.run();
+        const tag = r.ok ? ok(check.label) : check.critical ? fail(check.label) : warn(check.label);
+        console.log(`  ${tag}${r.detail ? grey("  " + r.detail) : ""}`);
+        if (!r.ok) {
+            failures++;
+            if (check.critical)
+                criticalFailures++;
+        }
+    }
+    // Provider preset hint
+    console.log(heading("LLM provider presets"));
+    console.log(`  ${dim("(set the matching key, then use the listed model prefix)")}`);
+    for (const p of OPENAI_COMPAT_PRESETS) {
+        const set = !!process.env[p.apiKeyEnv];
+        const flag = set ? green("●") : grey("○");
+        console.log(`  ${flag} ${p.name.padEnd(28)} ${dim(p.apiKeyEnv.padEnd(22))} ${dim(p.modelPrefixes.join(", "))}`);
+    }
+    // Summary
+    console.log();
+    console.log(rule());
+    if (criticalFailures > 0) {
+        console.log(fail(`${criticalFailures} critical failure${criticalFailures === 1 ? "" : "s"} — Lisa won't run reliably`));
+        process.exit(1);
+    }
+    else if (failures > 0) {
+        console.log(warn(`${failures} non-critical issue${failures === 1 ? "" : "s"} — Lisa will run but degraded`));
+    }
+    else {
+        console.log(ok("all checks passed"));
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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

package/dist/cli/monitor.d.ts

@@ -0,0 +1,2 @@
+export declare function runMonitor(): Promise<void>;
+//# sourceMappingURL=monitor.d.ts.map

package/dist/cli/monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../../src/cli/monitor.ts"],"names":[],"mappings":"AAgCA,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAqBhD"}