@oratis/lisa 0.2.0 → 0.3.1

package/dist/integrations/claude-code/parser.js

@@ -0,0 +1,224 @@
+/**
+ * Claude Code session state parser — Phase 2 of issue #27.
+ *
+ * Reads the TAIL of a session jsonl (last 32KB max) to derive whether
+ * Claude Code is currently:
+ *
+ *   - "working"  — Claude is mid-turn (tool call in flight, or assistant
+ *                  streaming, or user just sent something)
+ *   - "waiting"  — Claude finished (stopReason: end_turn) and is now
+ *                  awaiting the next user message; OR Claude requested a
+ *                  tool that needs permission
+ *   - "error"    — most recent meaningful line has is_error: true,
+ *                  hookErrors > 0, or an explicit error envelope
+ *   - "unknown"  — couldn't decide (file empty, malformed, only meta
+ *                  entries)
+ *
+ * ── PRIVACY CONTRACT (extends watcher.ts) ──────────────────────────
+ *
+ *   We DO read jsonl in this module — necessary to derive state —
+ *   but we ONLY ever inspect structural / metadata fields:
+ *
+ *     • type
+ *     • stopReason
+ *     • is_error / error
+ *     • hookErrors / hookCount
+ *     • subtype
+ *
+ *   We NEVER read, log, transmit, or persist `content`, `text`,
+ *   `message.content`, prompts, or replies. The parser destructures
+ *   only the fields above and discards the rest. A reviewer can audit
+ *   the entire module in 60 seconds — search for `content` or `text`
+ *   should produce zero hits except in comments like this one.
+ *
+ * ── ROBUSTNESS ──────────────────────────────────────────────────────
+ *
+ *   Claude Code's jsonl format may change between versions. Unknown
+ *   shapes return "unknown" rather than throwing. Malformed JSON lines
+ *   are skipped. Partial writes during streaming are tolerated (we
+ *   take the LAST complete line). File deletion mid-parse returns
+ *   "unknown".
+ */
+import fsp from "node:fs/promises";
+const META_TYPES = new Set([
+    "ai-title",
+    "custom-title",
+    "last-prompt",
+    "queue-operation",
+    "attachment",
+    // pr-link entries are written when Claude Code creates a PR. They
+    // appear after the actual conversation activity and would otherwise
+    // mask the real last-state if we stopped at the bottom-most line.
+    "pr-link",
+]);
+const TAIL_BYTES = 32 * 1024;
+export async function parseSessionState(filePath) {
+    let size;
+    try {
+        const st = await fsp.stat(filePath);
+        if (!st.isFile())
+            return { state: "unknown", reason: "not-a-file" };
+        size = st.size;
+    }
+    catch {
+        return { state: "unknown", reason: "stat-failed" };
+    }
+    if (size === 0)
+        return { state: "unknown", reason: "empty" };
+    let tail;
+    try {
+        const fd = await fsp.open(filePath, "r");
+        try {
+            const length = Math.min(TAIL_BYTES, size);
+            const buf = Buffer.alloc(length);
+            await fd.read(buf, 0, length, size - length);
+            tail = buf.toString("utf8");
+        }
+        finally {
+            await fd.close();
+        }
+    }
+    catch {
+        return { state: "unknown", reason: "read-failed" };
+    }
+    // Drop the first partial line if we didn't read from the very start —
+    // it might be truncated mid-record. (Doesn't matter for our purposes
+    // since we walk from the bottom anyway, but cheap insurance.)
+    const lines = tail.split("\n").filter(Boolean);
+    if (size > TAIL_BYTES && lines.length > 0)
+        lines.shift();
+    // Walk bottom-up, skip meta entries, decide on the first real one.
+    // While walking, also harvest `cwd` (top-level metadata field set
+    // by Claude Code at session start) — it's commonly present on every
+    // line, so we'll find it quickly.
+    let foundCwd;
+    let decision = null;
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i];
+        if (!foundCwd) {
+            foundCwd = sniffCwd(line);
+        }
+        if (decision === null) {
+            decision = decide(line);
+        }
+        if (decision !== null && foundCwd)
+            break;
+    }
+    if (decision !== null) {
+        return { ...decision, cwd: foundCwd };
+    }
+    return { state: "unknown", reason: "only-meta", cwd: foundCwd };
+}
+/**
+ * Extract only the top-level `.cwd` string from a line, without
+ * parsing the rest. We do a full JSON.parse here for safety (the
+ * `cwd` could in theory contain `}` chars), but immediately discard
+ * everything except the cwd field. Same privacy rule: structural
+ * metadata only, never `content` / `text`.
+ */
+function sniffCwd(line) {
+    try {
+        const obj = JSON.parse(line);
+        if (obj && typeof obj === "object") {
+            const cwd = obj.cwd;
+            if (typeof cwd === "string" && cwd.startsWith("/"))
+                return cwd;
+        }
+    }
+    catch { /* skip */ }
+    return undefined;
+}
+/**
+ * Parse one jsonl line and decide whether it carries enough info to
+ * declare a state. Returns null to mean "keep walking" (meta or
+ * unparseable).
+ *
+ * Destructures only metadata fields. Never touches content / text /
+ * message bodies.
+ */
+function decide(line) {
+    let entry;
+    try {
+        entry = JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+    if (!entry || typeof entry !== "object")
+        return null;
+    const e = entry;
+    const type = readString(e.type);
+    if (!type)
+        return null;
+    if (META_TYPES.has(type))
+        return null;
+    // Privacy: from this point on we only ever read metadata fields.
+    // Real Claude Code jsonl puts stop_reason nested under .message —
+    // we read it via a typed accessor that never touches .message.content.
+    const stopReason = readNestedStopReason(e);
+    const subtype = readString(e.subtype);
+    const isError = e.is_error === true || e.error === true;
+    const hookErrors = typeof e.hookErrors === "number" && e.hookErrors > 0;
+    if (isError || hookErrors) {
+        return { state: "error", reason: "is_error" };
+    }
+    if (type === "assistant") {
+        // `end_turn` = Claude finished talking, waiting for user reply
+        // `tool_use` = Claude wants to run a tool. In Claude Code this is
+        //              usually mid-loop (tool runs, result comes back,
+        //              Claude continues) — so we report "working" unless
+        //              the tool requires permission, which surfaces as a
+        //              separate system entry we'd see later.
+        if (stopReason === "end_turn")
+            return { state: "waiting", reason: "end_turn" };
+        if (stopReason === "tool_use")
+            return { state: "working", reason: "tool_use" };
+        if (stopReason === "max_tokens")
+            return { state: "waiting", reason: "max_tokens" };
+        if (stopReason === "stop_sequence")
+            return { state: "waiting", reason: "stop_sequence" };
+        // Unknown / no stop_reason yet — likely streaming in progress.
+        return { state: "working", reason: "assistant" };
+    }
+    if (type === "user") {
+        // The user just typed — Claude is about to (or already) respond.
+        return { state: "working", reason: "user" };
+    }
+    if (type === "tool_use") {
+        return { state: "working", reason: "tool_use" };
+    }
+    if (type === "system") {
+        // Permission prompts often come as system entries with a
+        // subtype like "permission_request" / "tool_permission". Treat
+        // them as "waiting" (user needs to approve).
+        if (subtype && /permission/i.test(subtype)) {
+            return { state: "waiting", reason: "permission" };
+        }
+        // Other system entries are transient — keep walking.
+        return null;
+    }
+    // Unknown but non-meta type — keep walking; if everything above
+    // turns out to be unknown, the caller's loop will fall through to
+    // "unknown" anyway.
+    return null;
+}
+function readString(v) {
+    return typeof v === "string" ? v : undefined;
+}
+/**
+ * Claude Code stores stop_reason nested under `.message.stop_reason`
+ * (snake_case). We extract ONLY that one field; `.message.content`,
+ * `.message.text`, etc. are deliberately never touched.
+ */
+function readNestedStopReason(e) {
+    const direct = readString(e.stopReason) ?? readString(e.stop_reason);
+    if (direct)
+        return direct;
+    const msg = e.message;
+    if (msg && typeof msg === "object") {
+        const m = msg;
+        return readString(m.stop_reason) ?? readString(m.stopReason);
+    }
+    return undefined;
+}
+//# sourceMappingURL=parser.js.map

package/dist/integrations/claude-code/parser.js.map

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

package/dist/integrations/claude-code/watcher.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Claude Code session monitor — Phase 1.
+ *
+ * Watches ~/.claude/projects/<encoded-cwd>/<session-uuid>.jsonl for activity
+ * from Claude Code's CLI / IDE clients. Emits an `update` event whenever
+ * a session jsonl appears (new) or grows (message). LISA's web server
+ * subscribes and broadcasts to /events SSE so the island widget and other
+ * surfaces can render a "Claude is busy" indicator.
+ *
+ * ── PRIVACY CONTRACT ────────────────────────────────────────────────
+ *
+ *   This module NEVER reads the jsonl message contents. Only:
+ *     - filename / directory name (= encoded cwd)
+ *     - mtime
+ *     - size in bytes
+ *
+ *   The user's prompts and Claude's replies stay in their files. We do
+ *   not parse, log, or transmit them anywhere. Phase 2 might add an
+ *   opt-in parser to detect "waiting for permission" semantics — that
+ *   will be a separate, explicit decision.
+ *
+ * ── DEPENDENCIES ────────────────────────────────────────────────────
+ *
+ *   None added. Uses only `node:fs` (`fs.watch` with `recursive: true`
+ *   works on macOS 10.5+ and Windows 10+ — perfect for our target).
+ *
+ * ── EVENT SEMANTICS ─────────────────────────────────────────────────
+ *
+ *   - "new"     — a session jsonl appeared we hadn't seen before
+ *   - "message" — an existing session jsonl grew (debounced 200ms so a
+ *                 fast token stream doesn't fire a flood)
+ *   - (Phase 2) "waiting" / "completed" / "error" — needs jsonl parse
+ *
+ *   Active = mtime within ACTIVE_WINDOW_MS (30 min). listActive()
+ *   returns sessions sorted newest-first, capped at MAX_LISTED.
+ */
+import { EventEmitter } from "node:events";
+import { type ClaudeSessionState } from "./parser.js";
+/**
+ * One row in the in-memory session map. We hold mtime + size only —
+ * never any jsonl content.
+ */
+export interface ClaudeSessionInfo {
+    /** Encoded form, e.g. "-Users-oratis-Projects-Adex" */
+    projectEncoded: string;
+    /** Best-effort display label, e.g. "Adex" */
+    projectLabel: string;
+    /** UUID (.jsonl basename without extension) */
+    sessionId: string;
+    /** Last modification time (epoch ms) */
+    lastMtime: number;
+    /** Size in bytes (rough indicator of message volume) */
+    size: number;
+    /** Derived state — Phase 2; see parser.ts. */
+    state: ClaudeSessionState;
+    /** Short reason label for the derived state (debugging / tooltip). */
+    stateReason: string;
+    /**
+     * Phase 3.5: cwd from Claude Code's top-level jsonl `.cwd` field.
+     * Used by the island UI for "Open in Finder" / "Copy resume
+     * command". Undefined if the jsonl didn't record it.
+     */
+    cwd?: string;
+}
+export interface ClaudeSessionUpdate {
+    event: "new" | "message" | "state_changed";
+    projectEncoded: string;
+    projectLabel: string;
+    sessionId: string;
+    state: ClaudeSessionState;
+    stateReason: string;
+    cwd?: string;
+    ts: string;
+}
+type Log = (msg: string) => void;
+export declare class ClaudeCodeWatcher extends EventEmitter {
+    private sessions;
+    private watcher;
+    private retryTimer;
+    private repollTimer;
+    private pendingChanges;
+    private readonly log;
+    private started;
+    constructor(opts?: {
+        log?: Log;
+    });
+    /** Begin watching. Idempotent. Survives ~/.claude/projects not existing yet. */
+    start(): Promise<void>;
+    stop(): void;
+    /** Sessions modified in the last 30 min, newest first, capped. */
+    listActive(): ClaudeSessionInfo[];
+    private initialScan;
+    private recordExisting;
+    private attachWatcher;
+    private scheduleRetry;
+    /**
+     * fs.watch fires the relative path of the changed entry. We debounce
+     * to coalesce rapid streaming writes into one `message` event per
+     * burst.
+     */
+    private handleFsEvent;
+    private diff;
+    private emitUpdate;
+    private makeInfo;
+    /**
+     * Periodic re-evaluation of active sessions' state. The fs.watch
+     * stream only fires when the file changes — but the very condition
+     * we want to detect (Claude waiting for permission) is "the file
+     * STOPPED changing". So we sweep every few seconds: for each session
+     * with a recent mtime, re-stat + re-parse + emit `state_changed` if
+     * the derived state has flipped.
+     *
+     * Cheap: stat is O(1), parser reads only the file's tail.
+     */
+    private startRepollLoop;
+    private repollActive;
+}
+/**
+ * `~/.claude/projects/-Users-oratis-Projects-Adex` → "Adex".
+ * Heuristic: strip a leading dash, replace remaining dashes with slashes,
+ * take the basename. Falls back to the raw encoded form if the result
+ * looks broken (no `/`, suspiciously empty).
+ */
+export declare function decodeProjectLabel(encoded: string): string;
+export declare const CLAUDE_PROJECTS_DIR: string;
+export {};
+//# sourceMappingURL=watcher.d.ts.map

package/dist/integrations/claude-code/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../../src/integrations/claude-code/watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAkCzE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,KAAK,EAAE,kBAAkB,CAAC;IAC1B,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,eAAe,CAAC;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,KAAK,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;AAEjC,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,OAAO,CAAC,OAAO,CAAS;gBAEZ,IAAI,GAAE;QAAE,GAAG,CAAC,EAAE,GAAG,CAAA;KAAO;IAMpC,gFAAgF;IAC1E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,IAAI,IAAI,IAAI;IAWZ,kEAAkE;IAClE,UAAU,IAAI,iBAAiB,EAAE;YAUnB,WAAW;YA8BX,cAAc;YAad,aAAa;IA8B3B,OAAO,CAAC,aAAa;IAQrB;;;;OAIG;IACH,OAAO,CAAC,aAAa;YAcP,IAAI;IAiClB,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,QAAQ;IAgDhB;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;YAUT,YAAY;CAuB3B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,eAAO,MAAM,mBAAmB,QAAe,CAAC"}