@edeng23/pines 0.1.0

package/dist/layout/lexical.js

@@ -0,0 +1,104 @@
+/**
+ * Cold-start forest layout: no embeddings needed, deterministic, instant.
+ *
+ * Trees cluster by cwd (shared project → shared neighborhood); cluster
+ * anchors sit on a phyllotaxis spiral (evenly spread, no grid artifacts),
+ * and trees within a cluster ring around the anchor by recency.
+ *
+ * Only unpositioned trees (x=0, y=0) are placed — semantic layout (M5) and
+ * user relayouts overwrite positions later; existing trees never move here.
+ */
+const GOLDEN_ANGLE = Math.PI * (3 - Math.sqrt(5));
+const CLUSTER_SPACING = 14;
+const RING_SPACING = 3.2;
+function hashString(s) {
+    let h = 2166136261;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 16777619);
+    }
+    return h >>> 0;
+}
+/**
+ * Sanity bound for persisted world coordinates. Real layouts live within
+ * ~±100; anything beyond this is corruption (e.g. the pre-fix relax()
+ * divide-by-zero wrote positions around ±1.5e9 into people's databases) and
+ * should be re-placed rather than trusted — one such tree makes zoom-to-fit
+ * frame a viewport a billion units wide.
+ */
+export const MAX_SANE_COORD = 10_000;
+export function isSanePosition(x, y) {
+    return (Number.isFinite(x) && Number.isFinite(y) && Math.abs(x) <= MAX_SANE_COORD && Math.abs(y) <= MAX_SANE_COORD);
+}
+export function assignLexicalPositions(trees) {
+    const unplaced = trees.filter((t) => t.x === 0 && t.y === 0);
+    if (unplaced.length === 0)
+        return [];
+    // Cluster key: cwd (or a bucket for unknown).
+    const clusters = new Map();
+    for (const t of unplaced) {
+        const key = t.cwd ?? "~unknown";
+        let arr = clusters.get(key);
+        if (!arr)
+            clusters.set(key, (arr = []));
+        arr.push(t);
+    }
+    // Anchor per cluster on a deterministic phyllotaxis spiral, ordered by key
+    // hash so anchors are stable regardless of discovery order. Anchors of
+    // clusters that already have placed trees reuse their centroid.
+    const placedByCwd = new Map();
+    for (const t of trees) {
+        if (t.x === 0 && t.y === 0)
+            continue;
+        const key = t.cwd ?? "~unknown";
+        const c = placedByCwd.get(key) ?? { x: 0, y: 0, n: 0 };
+        c.x += t.x;
+        c.y += t.y;
+        c.n++;
+        placedByCwd.set(key, c);
+    }
+    const keys = [...clusters.keys()].sort((a, b) => hashString(a) - hashString(b));
+    const changed = [];
+    keys.forEach((key) => {
+        const members = clusters.get(key);
+        let ax;
+        let ay;
+        const placed = placedByCwd.get(key);
+        if (placed && placed.n > 0) {
+            ax = placed.x / placed.n;
+            ay = placed.y / placed.n;
+        }
+        else {
+            // Spiral slot derived purely from the key hash: stable regardless of
+            // discovery order, and a wide slot range keeps distinct clusters from
+            // landing on the same anchor (exact collisions are still safe — the
+            // overlap relaxation separates them).
+            const idx = 1 + (hashString(key) % 97);
+            const r = CLUSTER_SPACING * Math.sqrt(1 + (idx % 12));
+            const theta = idx * GOLDEN_ANGLE;
+            ax = r * Math.cos(theta);
+            ay = r * Math.sin(theta);
+        }
+        // Members ring around the anchor by recency (newest closest).
+        members.sort((a, b) => b.mtime - a.mtime);
+        members.forEach((t, mi) => {
+            if (mi === 0 && !placed) {
+                t.x = ax;
+                t.y = ay;
+            }
+            else {
+                const ringIdx = placed ? mi + placed.n : mi;
+                const r = RING_SPACING * Math.sqrt(ringIdx + 1);
+                const theta = ringIdx * GOLDEN_ANGLE + hashString(t.treeId) % 7;
+                t.x = ax + r * Math.cos(theta);
+                t.y = ay + r * Math.sin(theta);
+            }
+            // (0,0) is the "unpositioned" sentinel — nudge exact zeros off it.
+            if (t.x === 0 && t.y === 0)
+                t.x = 0.001;
+            changed.push(t);
+        });
+    });
+    return changed;
+}
+//# sourceMappingURL=lexical.js.map

package/dist/layout/lexical.js.map

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

package/dist/layout/pca.js

@@ -0,0 +1,91 @@
+/**
+ * PCA projection: 384-d embeddings → 2-d forest coordinates.
+ *
+ * Deterministic power iteration for the top-2 principal components. The basis
+ * (mean + two components) is cached; new trees project through the cached
+ * basis so existing trees never move when a tree is added.
+ */
+function dot(a, b) {
+    let s = 0;
+    for (let i = 0; i < a.length; i++)
+        s += a[i] * b[i];
+    return s;
+}
+function norm(a) {
+    return Math.sqrt(dot(a, a));
+}
+/** Deterministic unit start vector (no Math.random — reproducible layouts). */
+function seedVector(d, seed) {
+    const v = new Array(d);
+    let state = seed >>> 0 || 1;
+    for (let i = 0; i < d; i++) {
+        // xorshift32
+        state ^= state << 13;
+        state ^= state >>> 17;
+        state ^= state << 5;
+        state >>>= 0;
+        v[i] = state / 0xffffffff - 0.5;
+    }
+    const n = norm(v);
+    for (let i = 0; i < d; i++)
+        v[i] /= n;
+    return v;
+}
+/**
+ * Power-iterate the covariance of `vectors` (n×d, centered internally) for the
+ * top component orthogonal to `deflate` (if given).
+ */
+function topComponent(centered, d, deflate, seed) {
+    let v = seedVector(d, seed);
+    for (let iter = 0; iter < 60; iter++) {
+        // w = Cov · v computed as Σ x (x·v) without materializing the d×d matrix.
+        const w = new Array(d).fill(0);
+        for (const x of centered) {
+            const p = dot(x, v);
+            for (let i = 0; i < d; i++)
+                w[i] += x[i] * p;
+        }
+        if (deflate) {
+            const p = dot(w, deflate);
+            for (let i = 0; i < d; i++)
+                w[i] -= deflate[i] * p;
+        }
+        const n = norm(w);
+        if (n < 1e-12)
+            break;
+        for (let i = 0; i < d; i++)
+            w[i] /= n;
+        v = w;
+    }
+    return v;
+}
+export function fitPca(vectors, targetSpan = 30) {
+    const n = vectors.length;
+    const d = vectors[0]?.length ?? 0;
+    const mean = new Array(d).fill(0);
+    for (const v of vectors)
+        for (let i = 0; i < d; i++)
+            mean[i] += v[i] / n;
+    const centered = vectors.map((v) => {
+        const c = new Array(d);
+        for (let i = 0; i < d; i++)
+            c[i] = v[i] - mean[i];
+        return c;
+    });
+    const c1 = topComponent(centered, d, null, 42);
+    const c2 = topComponent(centered, d, c1, 1337);
+    // Scale so the projected point cloud spans roughly `targetSpan` world units.
+    let maxAbs = 1e-9;
+    for (const x of centered) {
+        maxAbs = Math.max(maxAbs, Math.abs(dot(x, c1)), Math.abs(dot(x, c2)));
+    }
+    return { mean, c1, c2, scale: targetSpan / (2 * maxAbs) };
+}
+export function projectPca(basis, v) {
+    const d = basis.mean.length;
+    const c = new Array(d);
+    for (let i = 0; i < d; i++)
+        c[i] = v[i] - basis.mean[i];
+    return { x: dot(c, basis.c1) * basis.scale, y: dot(c, basis.c2) * basis.scale };
+}
+//# sourceMappingURL=pca.js.map

package/dist/layout/pca.js.map

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

package/dist/layout/relax.js

@@ -0,0 +1,47 @@
+/**
+ * Overlap removal: repulsion-only local relaxation.
+ *
+ * Movable points are pushed apart until no pair sits closer than `minDist`;
+ * pinned points never move (existing trees stay put when new ones arrive).
+ */
+export function relax(points, minDist = 2.4, iterations = 30) {
+    for (let iter = 0; iter < iterations; iter++) {
+        let moved = false;
+        for (let i = 0; i < points.length; i++) {
+            const p = points[i];
+            if (p.pinned)
+                continue;
+            let pushX = 0;
+            let pushY = 0;
+            for (let j = 0; j < points.length; j++) {
+                if (i === j)
+                    continue;
+                const q = points[j];
+                let dx = p.x - q.x;
+                let dy = p.y - q.y;
+                const dist = Math.hypot(dx, dy);
+                if (dist >= minDist)
+                    continue;
+                if (dist < 1e-9) {
+                    // Coincident: push a half-separation in a deterministic direction.
+                    // (dx/dy are unit-length here — do NOT divide by the zero distance.)
+                    const angle = (i * 2.399963) % (Math.PI * 2);
+                    pushX += Math.cos(angle) * minDist * 0.5;
+                    pushY += Math.sin(angle) * minDist * 0.5;
+                    continue;
+                }
+                const overlap = (minDist - dist) / dist;
+                pushX += dx * overlap * 0.5;
+                pushY += dy * overlap * 0.5;
+            }
+            if (pushX !== 0 || pushY !== 0) {
+                p.x += pushX;
+                p.y += pushY;
+                moved = true;
+            }
+        }
+        if (!moved)
+            break;
+    }
+}
+//# sourceMappingURL=relax.js.map

package/dist/layout/relax.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relax.js","sourceRoot":"","sources":["../../src/layout/relax.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,UAAU,KAAK,CAAC,MAAoB,EAAE,OAAO,GAAG,GAAG,EAAE,UAAU,GAAG,EAAE;IACxE,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;QAC7C,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;YACrB,IAAI,CAAC,CAAC,MAAM;gBAAE,SAAS;YACvB,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACvC,IAAI,CAAC,KAAK,CAAC;oBAAE,SAAS;gBACtB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;gBACrB,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACnB,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACnB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAChC,IAAI,IAAI,IAAI,OAAO;oBAAE,SAAS;gBAC9B,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;oBAChB,mEAAmE;oBACnE,qEAAqE;oBACrE,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;oBAC7C,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,OAAO,GAAG,GAAG,CAAC;oBACzC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,OAAO,GAAG,GAAG,CAAC;oBACzC,SAAS;gBACX,CAAC;gBACD,MAAM,OAAO,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;gBACxC,KAAK,IAAI,EAAE,GAAG,OAAO,GAAG,GAAG,CAAC;gBAC5B,KAAK,IAAI,EAAE,GAAG,OAAO,GAAG,GAAG,CAAC;YAC9B,CAAC;YACD,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAC/B,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;gBACb,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;gBACb,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK;YAAE,MAAM;IACpB,CAAC;AACH,CAAC"}

package/dist/session/ingest.js

@@ -0,0 +1,95 @@
+/**
+ * Incremental ingest: session JSONL → trees row + FTS index.
+ *
+ * JSONL is append-only, so we index only entries that appeared after the
+ * stored ingest_offset. A file that shrank (e.g. replaced by a fork flow)
+ * triggers a full re-ingest for that tree.
+ */
+import { randomUUID } from "node:crypto";
+import { readFileSync, statSync } from "node:fs";
+import { deleteFtsForTree, insertFts, treeBySessionPath, upsertTree, } from "../store/db.js";
+import { parseSessionContent, parseSessionFile } from "./parser.js";
+function ftsRowsFrom(parsed, treeId, sinceByte) {
+    // We re-derive which entries are "new" by parsing only the appended slice in
+    // the caller; here parsed is already just that slice (or the whole file).
+    void sinceByte;
+    const rows = [];
+    for (const e of parsed.entries) {
+        if (e.type === "message" && e.role === "user" && e.text) {
+            rows.push({ text: e.text, treeId, entryId: e.id, kind: "user_msg" });
+        }
+        else if ((e.type === "compaction" || e.type === "branch_summary") && e.text) {
+            rows.push({ text: e.text, treeId, entryId: e.id, kind: "summary" });
+        }
+    }
+    for (const [entryId, label] of parsed.labels) {
+        rows.push({ text: label, treeId, entryId, kind: "label" });
+    }
+    return rows;
+}
+/**
+ * Ingest one session file. Returns the treeId (existing or newly assigned)
+ * and the full parse of the file. `preferredTreeId` is used only when the
+ * session has no row yet (lets the daemon keep a spawn-time provisional id).
+ */
+export async function ingestSessionFile(db, sessionPath, opts) {
+    const st = statSync(sessionPath);
+    const existing = treeBySessionPath(db, sessionPath);
+    const full = await parseSessionFile(sessionPath);
+    let treeId;
+    let isNew = false;
+    let newRows;
+    if (!existing) {
+        treeId = opts?.preferredTreeId ?? `t_${randomUUID().slice(0, 8)}`;
+        isNew = true;
+        newRows = ftsRowsFrom(full, treeId, 0);
+        if (full.name)
+            newRows.push({ text: full.name, treeId, entryId: null, kind: "name" });
+    }
+    else {
+        treeId = existing.tree_id;
+        if (st.size < existing.ingest_offset) {
+            // File shrank: full re-index.
+            deleteFtsForTree(db, treeId);
+            newRows = ftsRowsFrom(full, treeId, 0);
+            if (full.name)
+                newRows.push({ text: full.name, treeId, entryId: null, kind: "name" });
+        }
+        else if (full.completeBytes > existing.ingest_offset) {
+            // Parse only the appended slice for FTS deltas (labels in the slice are
+            // additive; full.labels remains authoritative for display).
+            const slice = readFileSync(sessionPath).subarray(existing.ingest_offset).toString("utf8");
+            const appended = await parseSessionContent(slice);
+            newRows = ftsRowsFrom(appended, treeId, existing.ingest_offset);
+            const knownName = existing.name ?? null;
+            if (full.name && full.name !== knownName) {
+                newRows.push({ text: full.name, treeId, entryId: null, kind: "name" });
+            }
+        }
+        else {
+            newRows = [];
+        }
+    }
+    upsertTree(db, {
+        tree_id: treeId,
+        session_path: sessionPath,
+        session_id: full.header.sessionId,
+        name: full.name,
+        cwd: full.header.cwd,
+        parent_session_path: full.header.parentSession,
+        leaf_id: full.leafId,
+        node_count: full.entries.length,
+        mtime: Math.floor(st.mtimeMs),
+        ingest_offset: full.completeBytes,
+    });
+    if (isNew) {
+        // Lineage row (ordinal 0) — graft (v2) adds more ordinals.
+        if (full.header.parentSession) {
+            db.prepare("INSERT OR IGNORE INTO graft_parents (tree_id, parent_session_path, parent_entry_id, ordinal) VALUES (?, ?, NULL, 0)").run(treeId, full.header.parentSession);
+        }
+    }
+    if (newRows.length > 0)
+        insertFts(db, newRows);
+    return { treeId, parsed: full, isNew };
+}
+//# sourceMappingURL=ingest.js.map

package/dist/session/ingest.js.map

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

package/dist/session/parser.js

@@ -0,0 +1,254 @@
+/**
+ * Session JSONL → tree. This is the isolation layer around pi's session format:
+ * all @earendil-works imports for *reading* sessions live here (R3), and the
+ * parser tolerates a torn trailing line (a live pi may be mid-append, R8).
+ */
+import { readFileSync, statSync } from "node:fs";
+let piModule;
+function pi() {
+    piModule ??= import("@earendil-works/pi-coding-agent");
+    return piModule;
+}
+/**
+ * Extract display text from a pi message-ish object. Content is a string or
+ * an array of blocks — text, thinking {thinking}, toolCall {name}, image.
+ * An assistant turn that only thinks and calls tools has no text block, so
+ * fall through: text, else the tool calls, else the thinking, else images.
+ */
+function textOf(obj) {
+    if (typeof obj === "string")
+        return obj;
+    if (!Array.isArray(obj))
+        return "";
+    const texts = [];
+    const calls = [];
+    const thinking = [];
+    let images = 0;
+    for (const part of obj) {
+        if (typeof part !== "object" || part === null)
+            continue;
+        const p = part;
+        if (typeof p.text === "string" && p.text.trim())
+            texts.push(p.text);
+        else if (p.type === "toolCall")
+            calls.push(`${String(p.name ?? "tool")}(…)`);
+        else if (typeof p.thinking === "string" && p.thinking.trim())
+            thinking.push(p.thinking);
+        else if (p.type === "image")
+            images += 1;
+    }
+    if (texts.length > 0)
+        return texts.join(" ");
+    if (calls.length > 0)
+        return calls.join(", ");
+    if (thinking.length > 0)
+        return thinking.join(" ");
+    if (images > 0)
+        return images === 1 ? "[image]" : `[${images} images]`;
+    return "";
+}
+function entryText(raw) {
+    const type = raw.type;
+    if (type === "message") {
+        const msg = raw.message;
+        const role = msg?.role ?? null;
+        return { role, text: textOf(msg?.content).trim() };
+    }
+    if (type === "compaction" || type === "branch_summary") {
+        return { role: null, text: String(raw.summary ?? "").trim() };
+    }
+    if (type === "custom_message") {
+        return { role: "custom", text: textOf(raw.content).trim() };
+    }
+    if (type === "session_info") {
+        return { role: null, text: String(raw.name ?? "").trim() };
+    }
+    // Settings bookkeeping that pi records as tree entries. Normally spliced
+    // out of the lane graph; readable when surfaced (e.g. labeled).
+    if (type === "model_change") {
+        return { role: null, text: `model → ${String(raw.modelId ?? "?")}` };
+    }
+    if (type === "thinking_level_change") {
+        return { role: null, text: `thinking → ${String(raw.thinkingLevel ?? "?")}` };
+    }
+    if (type === "active_tools_change") {
+        return { role: null, text: "active tools changed" };
+    }
+    return { role: null, text: "" };
+}
+/**
+ * Parse raw JSONL content. Lines are split on LF only; an incomplete trailing
+ * line is ignored and excluded from `completeBytes`.
+ */
+export async function parseSessionContent(content) {
+    const { migrateSessionEntries } = await pi();
+    const header = { sessionId: null, cwd: null, parentSession: null };
+    let headerRaw;
+    const rawEntries = [];
+    let completeBytes = 0;
+    let cursor = 0;
+    while (cursor < content.length) {
+        const nl = content.indexOf("\n", cursor);
+        if (nl < 0)
+            break; // torn tail — a writer is mid-append
+        const line = content.slice(cursor, nl);
+        const lineEnd = nl + 1;
+        cursor = lineEnd;
+        const trimmed = line.endsWith("\r") ? line.slice(0, -1) : line;
+        if (trimmed.length === 0) {
+            completeBytes = Buffer.byteLength(content.slice(0, lineEnd), "utf8");
+            continue;
+        }
+        let obj;
+        try {
+            obj = JSON.parse(trimmed);
+        }
+        catch {
+            // A malformed complete line should not appear in an append-only file;
+            // stop advancing the cursor so a future re-read can retry.
+            break;
+        }
+        completeBytes = Buffer.byteLength(content.slice(0, lineEnd), "utf8");
+        if (obj.type === "session") {
+            headerRaw = obj;
+            header.sessionId = obj.id ?? null;
+            header.cwd = obj.cwd ?? null;
+            header.parentSession = obj.parentSession ?? null;
+        }
+        else {
+            rawEntries.push(obj);
+        }
+    }
+    // Let pi migrate v1/v2 shapes in place. The header MUST be in the array —
+    // version detection reads it (headerless input would be "migrated" as v1,
+    // rewriting every id). Unknown future entry types (e.g. the newer "leaf"
+    // pointer) pass through untouched.
+    try {
+        const fileEntries = headerRaw ? [headerRaw, ...rawEntries] : rawEntries;
+        migrateSessionEntries(fileEntries);
+    }
+    catch {
+        // Migration is best-effort; raw v3 files don't need it.
+    }
+    const entries = [];
+    const order = [];
+    const labels = new Map();
+    let name = null;
+    let leafFromLeafEntry;
+    let firstUserText = null;
+    const summaries = [];
+    for (const raw of rawEntries) {
+        const type = raw.type;
+        if (type === "leaf") {
+            // Newer agent-core persists the active leaf pointer as an entry.
+            leafFromLeafEntry = raw.targetId ?? null;
+            continue;
+        }
+        if (type === "label") {
+            const target = raw.targetId;
+            const label = raw.label;
+            if (label)
+                labels.set(target, label);
+            else
+                labels.delete(target);
+            continue;
+        }
+        if (type === "session_info") {
+            name = raw.name ?? name;
+            continue;
+        }
+        const id = raw.id;
+        if (!id)
+            continue;
+        const { role, text } = entryText(raw);
+        if (type === "compaction" || type === "branch_summary") {
+            if (text)
+                summaries.push(text);
+        }
+        if (role === "user" && firstUserText === null && text)
+            firstUserText = text;
+        entries.push({
+            id,
+            parentId: raw.parentId ?? null,
+            type,
+            timestamp: raw.timestamp ?? "",
+            role,
+            text,
+            raw,
+        });
+        order.push(id);
+    }
+    // Leaf: an explicit leaf entry wins; otherwise the last appended tree entry
+    // (pi reconstructs the leaf the same way on load).
+    const leafId = leafFromLeafEntry !== undefined ? leafFromLeafEntry : (order[order.length - 1] ?? null);
+    return { header, entries, order, name, labels, leafId, completeBytes, firstUserText, summaries };
+}
+const cache = new Map();
+const CACHE_MAX = 64;
+export async function parseSessionFile(path) {
+    const st = statSync(path);
+    const hit = cache.get(path);
+    if (hit && hit.mtimeMs === st.mtimeMs && hit.size === st.size)
+        return hit.parsed;
+    const parsed = await parseSessionContent(readFileSync(path, "utf8"));
+    cache.set(path, { mtimeMs: st.mtimeMs, size: st.size, parsed });
+    if (cache.size > CACHE_MAX) {
+        const oldest = cache.keys().next().value;
+        if (oldest !== undefined)
+            cache.delete(oldest);
+    }
+    return parsed;
+}
+/** Which entry types appear as nodes in tree views. */
+function nodeKind(e) {
+    if (e.type === "message") {
+        if (e.role === "user")
+            return "user";
+        if (e.role === "assistant")
+            return "assistant";
+        if (e.role === "toolResult")
+            return "tool";
+        return "other";
+    }
+    if (e.type === "compaction")
+        return "compaction";
+    if (e.type === "branch_summary")
+        return "branch_summary";
+    if (e.type === "custom" || e.type === "custom_message")
+        return "custom";
+    // Settings changes are plumbing, not conversation: give them the same
+    // spliceable kind as pines' own markers so trees don't open with a stack
+    // of unreadable bookkeeping rows.
+    if (e.type === "model_change" ||
+        e.type === "thinking_level_change" ||
+        e.type === "active_tools_change") {
+        return "custom";
+    }
+    return "other";
+}
+const EXCERPT_LEN = 80;
+export function toTreeDetail(treeId, parsed) {
+    const nodes = {};
+    const rootIds = [];
+    for (const e of parsed.entries) {
+        nodes[e.id] = {
+            id: e.id,
+            parentId: e.parentId,
+            kind: nodeKind(e),
+            excerpt: e.text.replace(/\s+/g, " ").slice(0, EXCERPT_LEN),
+            label: parsed.labels.get(e.id) ?? null,
+            timestamp: e.timestamp,
+            children: [],
+        };
+    }
+    for (const e of parsed.entries) {
+        if (e.parentId && nodes[e.parentId]) {
+            nodes[e.parentId].children.push(e.id);
+        }
+        else {
+            rootIds.push(e.id);
+        }
+    }
+    return { treeId, rootIds, nodes, leafId: parsed.leafId };
+}
+//# sourceMappingURL=parser.js.map

package/dist/session/parser.js.map

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