@oratis/lisa 0.9.0 → 0.11.0

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

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

package/dist/model/plans.js

@@ -0,0 +1,246 @@
+/**
+ * Coding-plan backends (CODING_PLANS.md, Phase 1 — detection + picker).
+ *
+ * A "coding plan" is a flat-rate subscription (Claude Pro/Max, a ChatGPT plan
+ * via Codex, GitHub Copilot) that the user already pays for. LISA can spend that
+ * budget on *coding work* by DELEGATING to the vendor's own CLI — never by
+ * extracting or replaying its subscription token (Anthropic's terms forbid that,
+ * and enforced it against OpenClaw; see docs/CODING_PLANS.md).
+ *
+ * This module is the Phase-1 slice: *detect* which plan CLIs are installed /
+ * logged in, and *select* one as the default delegation target. It performs NO
+ * authentication and reads NO secrets — detection is presence-only (binary on
+ * PATH / credential file exists), exactly the metadata-not-payload posture of
+ * every LISA observer. Actually routing coding work to the selected plan is a
+ * later phase that builds on the existing PTY bridge (src/agents/pty.ts).
+ *
+ * The probe (filesystem / PATH / env) is injectable so detection is unit-testable
+ * without a real claude/codex install.
+ */
+import { existsSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const PLAN_IDS = ["claude", "codex", "copilot"];
+/** The real host probe (filesystem + PATH + env). */
+export function defaultPlanProbe() {
+    const env = process.env;
+    return {
+        home: homedir(),
+        platform: process.platform,
+        env,
+        exists: (p) => {
+            try {
+                return existsSync(p);
+            }
+            catch {
+                return false;
+            }
+        },
+        readdir: (p) => {
+            try {
+                return readdirSync(p);
+            }
+            catch {
+                return [];
+            }
+        },
+        onPath: (cmd) => onPath(cmd, env),
+    };
+}
+/** Is `cmd` resolvable on PATH? Absolute/relative paths are checked directly. Pure-ish. */
+export function onPath(cmd, env) {
+    if (cmd.includes("/") || cmd.includes("\\")) {
+        try {
+            return existsSync(cmd);
+        }
+        catch {
+            return false;
+        }
+    }
+    const isWin = process.platform === "win32";
+    const sep = isWin ? ";" : ":";
+    const exts = isWin ? ["", ".exe", ".cmd", ".bat"] : [""];
+    for (const dir of (env.PATH ?? "").split(sep)) {
+        if (!dir)
+            continue;
+        for (const ext of exts) {
+            try {
+                if (existsSync(join(dir, cmd + ext)))
+                    return true;
+            }
+            catch {
+                /* unreadable dir → skip */
+            }
+        }
+    }
+    return false;
+}
+/** Parse a `plan://<id>` reference into a known PlanId, else null. Pure. */
+export function parsePlanRef(ref) {
+    const m = ref.match(/^plan:\/\/(.+)$/i);
+    if (!m)
+        return null;
+    const id = m[1].trim().toLowerCase();
+    return PLAN_IDS.includes(id) ? id : null;
+}
+/** Currently selected coding-plan delegation target, if any (LISA_CODING_PLAN). */
+export function selectedPlan(env = process.env) {
+    const v = (env.LISA_CODING_PLAN ?? "").trim().toLowerCase();
+    return PLAN_IDS.includes(v) ? v : null;
+}
+// ── per-plan detection (presence-only) ───────────────────────────────────────
+function cmpVersionDesc(a, b) {
+    const pa = a.split(".").map((n) => parseInt(n, 10) || 0);
+    const pb = b.split(".").map((n) => parseInt(n, 10) || 0);
+    for (let i = 0; i < 3; i++)
+        if ((pb[i] || 0) !== (pa[i] || 0))
+            return (pb[i] || 0) - (pa[i] || 0);
+    return 0;
+}
+/** Newest app-bundled `claude` binary on macOS (mirrors pty.detectClaudeBinary). */
+function claudeAppBundle(probe) {
+    if (probe.platform !== "darwin")
+        return null;
+    const root = join(probe.home, "Library", "Application Support", "Claude", "claude-code");
+    const versions = probe.readdir(root).filter((v) => /^\d+\.\d+\.\d+/.test(v)).sort(cmpVersionDesc);
+    for (const v of versions) {
+        const bin = join(root, v, "claude.app", "Contents", "MacOS", "claude");
+        if (probe.exists(bin))
+            return bin;
+    }
+    return null;
+}
+function detectClaude(probe) {
+    const override = probe.env.LISA_PTY_CLAUDE_CMD;
+    const binary = override
+        ? probe.onPath(override)
+            ? override
+            : null
+        : (claudeAppBundle(probe) ?? (probe.onPath("claude") ? "claude" : null));
+    // Login: token env, else credentials file (Linux/Windows). On macOS the creds
+    // live in the Keychain (opaque) → unknown rather than "logged out".
+    const configDir = probe.env.CLAUDE_CONFIG_DIR
+        ? probe.env.CLAUDE_CONFIG_DIR
+        : join(probe.home, ".claude");
+    let loggedIn;
+    if (probe.env.CLAUDE_CODE_OAUTH_TOKEN || probe.env.ANTHROPIC_AUTH_TOKEN)
+        loggedIn = true;
+    else if (probe.exists(join(configDir, ".credentials.json")))
+        loggedIn = true;
+    else if (probe.platform === "darwin")
+        loggedIn = null; // Keychain — can't tell from presence
+    else
+        loggedIn = false;
+    return {
+        id: "claude",
+        label: "Claude Pro/Max",
+        cli: "claude",
+        binary,
+        available: binary !== null,
+        loggedIn,
+        detail: hint(binary !== null, loggedIn, "claude", "`claude` (Claude Code)"),
+    };
+}
+function detectCodex(probe) {
+    const cli = probe.env.LISA_PTY_CODEX_CMD || "codex";
+    const binary = probe.onPath(cli) ? cli : null;
+    const codexHome = probe.env.CODEX_HOME ? probe.env.CODEX_HOME : join(probe.home, ".codex");
+    // auth.json exists → logged in. Absent could mean OS-keyring storage → unknown.
+    const loggedIn = probe.exists(join(codexHome, "auth.json")) ? true : binary ? null : false;
+    return {
+        id: "codex",
+        label: "ChatGPT plan (Codex)",
+        cli: "codex",
+        binary,
+        available: binary !== null,
+        loggedIn,
+        detail: hint(binary !== null, loggedIn, "codex", "`codex` (OpenAI Codex)"),
+    };
+}
+function detectCopilot(probe) {
+    // The delegate target is the standalone agentic `copilot` CLI, which runs a
+    // task non-interactively via `copilot -p "<task>"`. The older `gh copilot`
+    // (suggest/explain) is NOT agentic and can't run a task, so it doesn't count.
+    const binary = probe.onPath("copilot") ? "copilot" : null;
+    // Copilot login sits behind GitHub auth — not cheaply checkable without
+    // spawning, so: installed → unknown, absent → false.
+    const loggedIn = binary ? null : false;
+    return {
+        id: "copilot",
+        label: "GitHub Copilot",
+        cli: "copilot",
+        binary,
+        available: binary !== null,
+        loggedIn,
+        detail: binary
+            ? "installed — login state unknown (GitHub auth)"
+            : "install the GitHub Copilot CLI (`copilot`) to enable",
+    };
+}
+function hint(available, loggedIn, loginCmd, what) {
+    if (!available)
+        return `install ${what} to enable`;
+    if (loggedIn === true)
+        return "ready";
+    if (loggedIn === false)
+        return `installed — run \`${loginCmd} login\` to sign in`;
+    return "installed — login state unknown (stored in the OS keychain)";
+}
+/** Detect one plan's status. */
+export function detectPlan(id, probe = defaultPlanProbe()) {
+    switch (id) {
+        case "claude":
+            return detectClaude(probe);
+        case "codex":
+            return detectCodex(probe);
+        case "copilot":
+            return detectCopilot(probe);
+    }
+}
+/** Detect every known plan. */
+export function detectPlans(probe = defaultPlanProbe()) {
+    return PLAN_IDS.map((id) => detectPlan(id, probe));
+}
+// ── delegation (CODING_PLANS Phase 2) ────────────────────────────────────────
+/**
+ * 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 function planDispatchKind(id) {
+    return id; // each plan id is also its headless dispatch CLI kind
+}
+/**
+ * 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 function planPreflight(status) {
+    if (!status.available)
+        return { ok: false, reason: `${status.cli} isn't installed — ${status.detail}` };
+    if (status.loggedIn === false)
+        return { ok: false, reason: `${status.cli} is installed but not logged in — ${status.detail}` };
+    return { ok: true };
+}
+// ── surfacing (CODING_PLANS Phase 4) ─────────────────────────────────────────
+/** Status glyph: ✓ logged in · ✗ unavailable/logged-out · ? installed, login unknown. Pure. */
+export function planMark(s) {
+    if (!s.available || s.loggedIn === false)
+        return "✗";
+    if (s.loggedIn === true)
+        return "✓";
+    return "?";
+}
+/**
+ * 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 function planSummaryLine(statuses, selected) {
+    const bits = statuses.map((s) => `${s.label} ${planMark(s)}${s.id === selected ? " ★" : ""}`);
+    const head = selected ? `coding plan → ${selected}` : "coding plan → none selected";
+    return `${head}  ·  ${bits.join("  ·  ")}`;
+}
+//# sourceMappingURL=plans.js.map

package/dist/model/plans.js.map

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

package/dist/orchestrator/recent-recap.d.ts

@@ -0,0 +1,2 @@
+export declare function recentAgentRecap(windowMs?: number, now?: number): string | null;
+//# sourceMappingURL=recent-recap.d.ts.map

package/dist/orchestrator/recent-recap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recent-recap.d.ts","sourceRoot":"","sources":["../../src/orchestrator/recent-recap.ts"],"names":[],"mappings":"AAaA,wBAAgB,gBAAgB,CAC9B,QAAQ,GAAE,MAAwB,EAClC,GAAG,GAAE,MAAmB,GACvB,MAAM,GAAG,IAAI,CAKf"}

package/dist/orchestrator/recent-recap.js

@@ -0,0 +1,20 @@
+/**
+ * Recent agent-fleet recap, ready to inject into Lisa's self-driven runs
+ * (PLAN_REVE_v1.0 R5). The orchestrator journal records what every agent did;
+ * before this, that record was write-only — reflection and heartbeat never read
+ * it. This composes journal + recap so Lisa can factor "what my fleet did" into
+ * how she reflects and what she pursues.
+ *
+ * Returns null when there was no activity in the window, so callers can inject
+ * conditionally. Structural metadata only (no prompts/replies/file contents).
+ */
+import { eventsSince } from "./journal.js";
+import { buildRecap, formatRecap } from "./recap.js";
+export function recentAgentRecap(windowMs = 2 * 60 * 60_000, now = Date.now()) {
+    const sinceMs = now - windowMs;
+    const recap = buildRecap(eventsSince(sinceMs), sinceMs, now);
+    if (recap.totalSessions === 0)
+        return null;
+    return formatRecap(recap);
+}
+//# sourceMappingURL=recent-recap.js.map

package/dist/orchestrator/recent-recap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recent-recap.js","sourceRoot":"","sources":["../../src/orchestrator/recent-recap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,UAAU,gBAAgB,CAC9B,WAAmB,CAAC,GAAG,EAAE,GAAG,MAAM,EAClC,MAAc,IAAI,CAAC,GAAG,EAAE;IAExB,MAAM,OAAO,GAAG,GAAG,GAAG,QAAQ,CAAC;IAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC"}

package/dist/providers/anthropic.d.ts

@@ -4,6 +4,7 @@ export declare class AnthropicProvider implements Provider {
     private client;
     constructor(opts?: {
         apiKey?: string;
+        authToken?: string;
         baseURL?: string;
     });
     runTurn(opts: ProviderRunOpts): Promise<ProviderResult>;

package/dist/providers/anthropic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,qBAAa,iBAAkB,YAAW,QAAQ;IAChD,QAAQ,CAAC,IAAI,eAAe;IAC5B,OAAO,CAAC,MAAM,CAAY;gBAEd,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;IActD,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAyD9D"}
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,qBAAa,iBAAkB,YAAW,QAAQ;IAChD,QAAQ,CAAC,IAAI,eAAe;IAC5B,OAAO,CAAC,MAAM,CAAY;gBAEd,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;IAmB1E,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;CAgE9D"}

package/dist/providers/anthropic.js

@@ -10,8 +10,13 @@ export class AnthropicProvider {
         // baseURL overrides the default https://api.anthropic.com — used to
         // route through an Anthropic-compatible proxy (one-api, openrouter,
         // self-hosted relay) when direct access is blocked.
+        // authToken sends `Authorization: Bearer …` instead of the default
+        // `x-api-key` header — the sanctioned path for an Anthropic-compatible
+        // LLM gateway / proxy (matches Claude Code's ANTHROPIC_AUTH_TOKEN). When
+        // set it takes precedence over apiKey, so callers pass one or the other.
         this.client = new Anthropic({
             apiKey: opts.apiKey,
+            authToken: opts.authToken,
             baseURL: opts.baseURL,
             fetch: proxyAwareFetch,
         });
@@ -43,12 +48,15 @@ export class AnthropicProvider {
         }
         const onText = (delta) => opts.handlers?.onTextDelta?.(delta);
         const onThinking = (delta) => opts.handlers?.onThinkingDelta?.(delta);
+        // Second argument is the SDK's per-request options; `signal` aborts the
+        // in-flight HTTP stream (the SDK then throws APIUserAbortError).
+        const requestOpts = { signal: opts.signal };
         let message;
         if (opts.compaction) {
             const stream = this.client.beta.messages.stream({
                 ...params,
                 ...extras,
-            });
+            }, requestOpts);
             if (opts.handlers?.onTextDelta)
                 stream.on("text", onText);
             if (opts.handlers?.onThinkingDelta)
@@ -56,7 +64,7 @@ export class AnthropicProvider {
             message = (await stream.finalMessage());
         }
         else {
-            const stream = this.client.messages.stream(params);
+            const stream = this.client.messages.stream(params, requestOpts);
             if (opts.handlers?.onTextDelta)
                 stream.on("text", onText);
             if (opts.handlers?.onThinkingDelta)