@oratis/lisa 0.8.0 → 0.11.0

package/dist/model/local.js

@@ -0,0 +1,118 @@
+/**
+ * Local-model lifecycle (PLAN_MODEL_v1.0 M1).
+ *
+ * Before this, "local models" meant: the user installs Ollama themselves, runs
+ * `ollama serve`, and hand-edits LISA_BASE_URL in config.env. This module makes
+ * it a first-class option — install / list / health / switch — while still
+ * routing through the existing OpenAI-compatible provider (Ollama et al. speak
+ * the OpenAI API), so no provider code changes.
+ *
+ * The runtime (process exec + HTTP) is injectable so the logic is unit-testable
+ * without a real Ollama install.
+ */
+import { spawn } from "node:child_process";
+export const defaultRuntime = {
+    exec(cmd, args, onLine) {
+        return new Promise((resolve) => {
+            let stdout = "";
+            let stderr = "";
+            let child;
+            try {
+                child = spawn(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
+            }
+            catch (err) {
+                resolve({ code: 127, stdout: "", stderr: err.message });
+                return;
+            }
+            const pump = (chunk, sink) => {
+                const s = chunk.toString();
+                if (sink === "out")
+                    stdout += s;
+                else
+                    stderr += s;
+                if (onLine)
+                    for (const line of s.split("\n"))
+                        if (line.trim())
+                            onLine(line.trim());
+            };
+            child.stdout?.on("data", (c) => pump(c, "out"));
+            child.stderr?.on("data", (c) => pump(c, "err")); // ollama writes pull progress to stderr
+            child.on("error", (err) => resolve({ code: 127, stdout, stderr: stderr + err.message }));
+            child.on("close", (code) => resolve({ code: code ?? 0, stdout, stderr }));
+        });
+    },
+    async httpGet(url) {
+        try {
+            const res = await fetch(url);
+            return { ok: res.ok, status: res.status, body: await res.text() };
+        }
+        catch {
+            return { ok: false, status: 0, body: "" };
+        }
+    },
+};
+/** Default OpenAI-compatible endpoints per local backend. Pure. */
+export function localEndpoint(backend) {
+    const hosts = {
+        ollama: "http://localhost:11434",
+        lmstudio: "http://localhost:1234",
+        llamacpp: "http://localhost:8080",
+    };
+    const envHost = backend === "ollama" ? process.env.OLLAMA_HOST : undefined;
+    const host = (envHost || hosts[backend] || hosts.ollama).replace(/\/$/, "");
+    return { host, baseURL: `${host}/v1`, apiKey: backend };
+}
+/** Parse a `local://[backend/]model` reference. Pure. */
+export function parseLocalRef(ref) {
+    const m = ref.match(/^local:\/\/(.+)$/);
+    if (!m)
+        return null;
+    const rest = m[1].trim();
+    if (!rest)
+        return null;
+    const known = new Set(["ollama", "lmstudio", "llamacpp"]);
+    const slash = rest.indexOf("/");
+    if (slash > 0 && known.has(rest.slice(0, slash))) {
+        return { backend: rest.slice(0, slash), model: rest.slice(slash + 1) };
+    }
+    return { backend: "ollama", model: rest };
+}
+/** Parse Ollama's /api/tags JSON into model infos. Pure. */
+export function parseOllamaTags(body) {
+    try {
+        const json = JSON.parse(body);
+        return (json.models ?? [])
+            .filter((m) => typeof m.name === "string")
+            .map((m) => ({ name: m.name, sizeBytes: typeof m.size === "number" ? m.size : undefined }));
+    }
+    catch {
+        return [];
+    }
+}
+/** The Ollama backend: install / list / health via its CLI + HTTP API. */
+export class OllamaBackend {
+    runtime;
+    name = "ollama";
+    host;
+    constructor(runtime = defaultRuntime, host = localEndpoint("ollama").host) {
+        this.runtime = runtime;
+        this.host = host.replace(/\/$/, "");
+    }
+    async health() {
+        const res = await this.runtime.httpGet(`${this.host}/api/tags`);
+        return res.ok ? "up" : "down";
+    }
+    async listInstalled() {
+        const res = await this.runtime.httpGet(`${this.host}/api/tags`);
+        return res.ok ? parseOllamaTags(res.body) : [];
+    }
+    async install(model, onLine) {
+        const { code, stderr } = await this.runtime.exec("ollama", ["pull", model], onLine);
+        if (code === 0)
+            return;
+        throw new Error(code === 127
+            ? "ollama CLI not found — install it from https://ollama.com, then retry"
+            : `\`ollama pull ${model}\` failed: ${stderr.trim().slice(-200) || `exit ${code}`}`);
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/model/local.js.map

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

package/dist/model/plan-usage.d.ts

@@ -0,0 +1,41 @@
+import type { PlanId } from "./plans.js";
+/** Claude subscription limits reset on a rolling ~5h basis. */
+export declare const WINDOW_HOURS = 5;
+export interface PlanUsage {
+    /** Gross tokens (input + output + cache create + cache read) in the rolling window. */
+    windowTokens: number;
+    windowHours: number;
+    /** Gross tokens since local midnight. */
+    todayTokens: number;
+    /** Transcript files that contributed to the window/today. */
+    sessions: number;
+}
+interface UsageEntry {
+    atMs: number;
+    tokens: number;
+}
+/** Sum the billable token fields from a Claude `usage` object. Pure. */
+export declare function usageTokens(u: Record<string, unknown>): number;
+/** Local midnight (ms) for the day containing nowMs. Pure-ish (no Date.now). */
+export declare function startOfLocalDay(nowMs: number): number;
+/** Bucket timestamped token entries into rolling-window + today sums. Pure. */
+export declare function aggregateUsage(entries: UsageEntry[], nowMs: number, windowMs: number, dayStartMs: number): {
+    windowTokens: number;
+    todayTokens: number;
+};
+/**
+ * Read Claude Code's local transcripts and sum token usage over the rolling
+ * window + today. Returns null if the projects dir is absent/unreadable.
+ */
+export declare function readClaudeUsage(opts: {
+    home?: string;
+    nowMs: number;
+}): PlanUsage | null;
+/** Usage for a plan, or null if it has no readable local token log. */
+export declare function planUsage(id: PlanId, nowMs: number): PlanUsage | null;
+/** Compact token count, e.g. 1234567 → "1.2M". Pure. */
+export declare function formatTokens(n: number): string;
+/** One-line usage summary, e.g. "1.2M tok in 5h · 4.8M today". Pure. */
+export declare function formatUsage(u: PlanUsage): string;
+export {};
+//# sourceMappingURL=plan-usage.d.ts.map

package/dist/model/plan-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-usage.d.ts","sourceRoot":"","sources":["../../src/model/plan-usage.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,+DAA+D;AAC/D,eAAO,MAAM,YAAY,IAAI,CAAC;AAI9B,MAAM,WAAW,SAAS;IACxB,uFAAuF;IACvF,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAO9D;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAC5B,OAAO,EAAE,UAAU,EAAE,EACrB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAS/C;AA6BD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAAG,IAAI,CAwDxF;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAGrE;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9C;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAEhD"}

package/dist/model/plan-usage.js

@@ -0,0 +1,168 @@
+/**
+ * Real coding-plan usage (CODING_PLANS Phase 5a) — honest, local, no faked %.
+ *
+ * Subscription plans are rate-limited, not metered, and the per-window limit
+ * isn't published in token terms — so we do NOT invent a "headroom %". What we
+ * CAN show truthfully is *consumption*: Claude Code records per-turn token usage
+ * in its local transcripts (`~/.claude/projects/**​/*.jsonl`), each line stamped
+ * with a `timestamp` and a `message.usage` object. Summing those over Claude's
+ * rolling ~5-hour limit window (and since local midnight) is real usage from
+ * local data — the same `usage` field the claude-code observer already reads, so
+ * the metadata-not-payload privacy posture holds (we read token COUNTS and
+ * timestamps only, never message content).
+ *
+ * Codex / Copilot have no comparable standard local token log, so usage is null
+ * for them rather than guessed.
+ */
+import { readdirSync, statSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/** Claude subscription limits reset on a rolling ~5h basis. */
+export const WINDOW_HOURS = 5;
+/** Safety cap on transcript files scanned per call (newest first). */
+const MAX_FILES = 80;
+function num(v) {
+    return typeof v === "number" && Number.isFinite(v) ? v : 0;
+}
+/** Sum the billable token fields from a Claude `usage` object. Pure. */
+export function usageTokens(u) {
+    return (num(u.input_tokens) +
+        num(u.output_tokens) +
+        num(u.cache_creation_input_tokens) +
+        num(u.cache_read_input_tokens));
+}
+/** Local midnight (ms) for the day containing nowMs. Pure-ish (no Date.now). */
+export function startOfLocalDay(nowMs) {
+    const d = new Date(nowMs);
+    d.setHours(0, 0, 0, 0);
+    return d.getTime();
+}
+/** Bucket timestamped token entries into rolling-window + today sums. Pure. */
+export function aggregateUsage(entries, nowMs, windowMs, dayStartMs) {
+    const windowStart = nowMs - windowMs;
+    let windowTokens = 0;
+    let todayTokens = 0;
+    for (const e of entries) {
+        if (e.atMs >= windowStart)
+            windowTokens += e.tokens;
+        if (e.atMs >= dayStartMs)
+            todayTokens += e.tokens;
+    }
+    return { windowTokens, todayTokens };
+}
+/** Recursively collect `*.jsonl` paths under dir (Claude nests one level). */
+function listTranscripts(dir) {
+    const out = [];
+    const walk = (d, depth) => {
+        let ents;
+        try {
+            ents = readdirSync(d, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const ent of ents) {
+            const p = join(d, ent.name);
+            if (ent.isDirectory()) {
+                if (depth < 3)
+                    walk(p, depth + 1);
+            }
+            else if (ent.isFile() && ent.name.endsWith(".jsonl")) {
+                try {
+                    out.push({ path: p, mtimeMs: statSync(p).mtimeMs });
+                }
+                catch {
+                    /* unreadable → skip */
+                }
+            }
+        }
+    };
+    walk(dir, 0);
+    return out;
+}
+/**
+ * Read Claude Code's local transcripts and sum token usage over the rolling
+ * window + today. Returns null if the projects dir is absent/unreadable.
+ */
+export function readClaudeUsage(opts) {
+    const home = opts.home ?? process.env.CLAUDE_HOME ?? join(homedir(), ".claude");
+    const projects = join(home, "projects");
+    const nowMs = opts.nowMs;
+    const windowMs = WINDOW_HOURS * 3_600_000;
+    const dayStart = startOfLocalDay(nowMs);
+    const scanFrom = Math.min(nowMs - windowMs, dayStart);
+    let files;
+    try {
+        files = listTranscripts(projects);
+    }
+    catch {
+        return null;
+    }
+    if (files.length === 0)
+        return null;
+    // Only files touched within the scan window can hold in-window entries.
+    // Newest first, capped, so a heavy history can't make this unbounded.
+    const recent = files
+        .filter((f) => f.mtimeMs >= scanFrom)
+        .sort((a, b) => b.mtimeMs - a.mtimeMs)
+        .slice(0, MAX_FILES);
+    const entries = [];
+    let sessions = 0;
+    for (const f of recent) {
+        let raw;
+        try {
+            raw = readFileSync(f.path, "utf8");
+        }
+        catch {
+            continue;
+        }
+        let contributed = false;
+        for (const line of raw.split("\n")) {
+            if (!line)
+                continue;
+            let e;
+            try {
+                e = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            const atMs = Date.parse(typeof e.timestamp === "string" ? e.timestamp : "");
+            if (!Number.isFinite(atMs) || atMs < scanFrom)
+                continue;
+            const u = e.message?.usage;
+            if (!u || typeof u !== "object")
+                continue;
+            const tokens = usageTokens(u);
+            if (tokens > 0) {
+                entries.push({ atMs, tokens });
+                contributed = true;
+            }
+        }
+        if (contributed)
+            sessions++;
+    }
+    const { windowTokens, todayTokens } = aggregateUsage(entries, nowMs, windowMs, dayStart);
+    return { windowTokens, windowHours: WINDOW_HOURS, todayTokens, sessions };
+}
+/** Usage for a plan, or null if it has no readable local token log. */
+export function planUsage(id, nowMs) {
+    if (id === "claude")
+        return readClaudeUsage({ nowMs });
+    return null; // codex / copilot: no standard local token log
+}
+/** Compact token count, e.g. 1234567 → "1.2M". Pure. */
+export function formatTokens(n) {
+    if (n >= 1e9)
+        return (n / 1e9).toFixed(1) + "B";
+    if (n >= 1e6)
+        return (n / 1e6).toFixed(1) + "M";
+    if (n >= 1e3)
+        return Math.round(n / 1e3) + "K";
+    return String(n);
+}
+/** One-line usage summary, e.g. "1.2M tok in 5h · 4.8M today". Pure. */
+export function formatUsage(u) {
+    return `${formatTokens(u.windowTokens)} tok in ${u.windowHours}h · ${formatTokens(u.todayTokens)} today`;
+}
+//# sourceMappingURL=plan-usage.js.map

package/dist/model/plan-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-usage.js","sourceRoot":"","sources":["../../src/model/plan-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAC9B,sEAAsE;AACtE,MAAM,SAAS,GAAG,EAAE,CAAC;AAiBrB,SAAS,GAAG,CAAC,CAAU;IACrB,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,WAAW,CAAC,CAA0B;IACpD,OAAO,CACL,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC;QACnB,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC;QACpB,GAAG,CAAC,CAAC,CAAC,2BAA2B,CAAC;QAClC,GAAG,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAC/B,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACvB,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAC5B,OAAqB,EACrB,KAAa,EACb,QAAgB,EAChB,UAAkB;IAElB,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,CAAC;IACrC,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,IAAI,IAAI,WAAW;YAAE,YAAY,IAAI,CAAC,CAAC,MAAM,CAAC;QACpD,IAAI,CAAC,CAAC,IAAI,IAAI,UAAU;YAAE,WAAW,IAAI,CAAC,CAAC,MAAM,CAAC;IACpD,CAAC;IACD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;AACvC,CAAC;AAED,8EAA8E;AAC9E,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,GAAG,GAA6C,EAAE,CAAC;IACzD,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,KAAa,EAAE,EAAE;QACxC,IAAI,IAAgC,CAAC;QACrC,IAAI,CAAC;YACH,IAAI,GAAG,WAAW,CAAC,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;gBACtB,IAAI,KAAK,GAAG,CAAC;oBAAE,IAAI,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YACpC,CAAC;iBAAM,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvD,IAAI,CAAC;oBACH,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBACtD,CAAC;gBAAC,MAAM,CAAC;oBACP,uBAAuB;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACb,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAsC;IACpE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAChF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,MAAM,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;IAC1C,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEtD,IAAI,KAA+C,CAAC;IACpD,IAAI,CAAC;QACH,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,wEAAwE;IACxE,sEAAsE;IACtE,MAAM,MAAM,GAAG,KAAK;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,QAAQ,CAAC;SACpC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;SACrC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAEvB,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,IAAI,CAAyD,CAAC;YAC9D,IAAI,CAAC;gBACH,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC5E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,QAAQ;gBAAE,SAAS;YACxD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC;YAC3B,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,SAAS;YAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,CAA4B,CAAC,CAAC;YACzD,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC/B,WAAW,GAAG,IAAI,CAAC;YACrB,CAAC;QACH,CAAC;QACD,IAAI,WAAW;YAAE,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACzF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AAC5E,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,SAAS,CAAC,EAAU,EAAE,KAAa;IACjD,IAAI,EAAE,KAAK,QAAQ;QAAE,OAAO,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC,CAAC,+CAA+C;AAC9D,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,IAAI,CAAC,IAAI,GAAG;QAAE,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IAChD,IAAI,CAAC,IAAI,GAAG;QAAE,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IAChD,IAAI,CAAC,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAC/C,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,WAAW,CAAC,CAAY;IACtC,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,WAAW,OAAO,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC;AAC3G,CAAC"}

package/dist/model/plans.d.ts

@@ -0,0 +1,73 @@
+export type PlanId = "claude" | "codex" | "copilot";
+export declare const PLAN_IDS: readonly PlanId[];
+export interface PlanStatus {
+    id: PlanId;
+    /** Human label, e.g. "Claude Pro/Max". */
+    label: string;
+    /** The vendor CLI that owns this plan's auth. */
+    cli: string;
+    /** Resolved binary path/name, or null if not found. */
+    binary: string | null;
+    /** Is the CLI installed (binary present)? */
+    available: boolean;
+    /**
+     * Best-effort login signal from credential *presence* (never contents):
+     * true = a credential file / token env was found, false = looked and found
+     * none, null = can't tell (e.g. macOS Keychain — opaque without reading it).
+     */
+    loggedIn: boolean | null;
+    /** Short human hint about state / how to enable. */
+    detail: string;
+}
+/** Injectable view of the host used for presence-only detection. Pure inputs. */
+export interface PlanProbe {
+    home: string;
+    platform: NodeJS.Platform;
+    env: Record<string, string | undefined>;
+    /** Does a file/dir exist at this absolute path? */
+    exists(p: string): boolean;
+    /** Directory entries, or [] on any error. */
+    readdir(p: string): string[];
+    /** Is `cmd` an executable on PATH (or an existing absolute path)? */
+    onPath(cmd: string): boolean;
+}
+/** The real host probe (filesystem + PATH + env). */
+export declare function defaultPlanProbe(): PlanProbe;
+/** Is `cmd` resolvable on PATH? Absolute/relative paths are checked directly. Pure-ish. */
+export declare function onPath(cmd: string, env: Record<string, string | undefined>): boolean;
+/** Parse a `plan://<id>` reference into a known PlanId, else null. Pure. */
+export declare function parsePlanRef(ref: string): PlanId | null;
+/** Currently selected coding-plan delegation target, if any (LISA_CODING_PLAN). */
+export declare function selectedPlan(env?: Record<string, string | undefined>): PlanId | null;
+/** Detect one plan's status. */
+export declare function detectPlan(id: PlanId, probe?: PlanProbe): PlanStatus;
+/** Detect every known plan. */
+export declare function detectPlans(probe?: PlanProbe): PlanStatus[];
+/**
+ * The headless dispatch CLI kind a plan delegates through. Each plan id is also
+ * its CLI kind in launchAgent: claude → `claude -p`, codex → `codex exec`,
+ * copilot → `copilot -p`.
+ */
+export declare function planDispatchKind(id: PlanId): "claude" | "codex" | "copilot";
+export interface PlanPreflight {
+    ok: boolean;
+    /** Why delegation can't proceed (only when ok=false). */
+    reason?: string;
+}
+/**
+ * Can we delegate coding work to this detected plan right now? Pure. A null
+ * (unknown) login passes — on macOS the credential lives in the Keychain and
+ * "installed but login unverifiable" should not block; the CLI itself will
+ * prompt if truly logged out.
+ */
+export declare function planPreflight(status: PlanStatus): PlanPreflight;
+/** Status glyph: ✓ logged in · ✗ unavailable/logged-out · ? installed, login unknown. Pure. */
+export declare function planMark(s: PlanStatus): "✓" | "✗" | "?";
+/**
+ * One-line coding-plan summary for surfaces like `lisa agents`. Pure. Shows the
+ * selected delegation target (★) and each plan's glyph. Headroom/rate-limit
+ * numbers are intentionally omitted — they'd need version-fragile parsing of the
+ * vendor CLI's output, and a wrong number is worse than none.
+ */
+export declare function planSummaryLine(statuses: PlanStatus[], selected: PlanId | null): string;
+//# sourceMappingURL=plans.d.ts.map

package/dist/model/plans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../../src/model/plans.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpD,eAAO,MAAM,QAAQ,EAAE,SAAS,MAAM,EAAmC,CAAC;AAE1E,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,iFAAiF;AACjF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC,mDAAmD;IACnD,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,6CAA6C;IAC7C,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,qEAAqE;IACrE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC9B;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,IAAI,SAAS,CAsB5C;AAED,2FAA2F;AAC3F,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAsBpF;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKvD;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,MAAM,GAAG,IAAI,CAGjG;AAkGD,gCAAgC;AAChC,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,GAAE,SAA8B,GAAG,UAAU,CASxF;AAED,+BAA+B;AAC/B,wBAAgB,WAAW,CAAC,KAAK,GAAE,SAA8B,GAAG,UAAU,EAAE,CAE/E;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAE3E;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CAK/D;AAID,+FAA+F;AAC/F,wBAAgB,QAAQ,CAAC,CAAC,EAAE,UAAU,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAIvD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAIvF"}