@blulotus/trellis-core 0.7.0

package/dist/mem/filter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Project / time-range / source filters for mem session selection.
+ *
+ * These primitives belong to mem session filtering only — they are not
+ * promoted into a cross-domain `core/internal` until another core subdomain
+ * needs exactly the same semantics.
+ */
+import type { MemFilter } from "./types.js";
+/** Single-point range check: `since ≤ t ≤ until`. Pass-through when `iso` is
+ * undefined or unparseable. Internal-only — session list filtering uses
+ * {@link inRangeOverlap}. */
+export declare function inRange(iso: string | undefined, f: MemFilter): boolean;
+/**
+ * Interval-overlap range check for sessions with both a start and an end
+ * timestamp. A session is kept iff its lifetime `[start, end]` overlaps the
+ * query window `[since, until]`.
+ *
+ * Long / cross-day sessions (created before `--since` but still active inside
+ * the window) must survive — single-point `inRange(created, f)` dropped them.
+ *
+ * Degenerate inputs:
+ *   - both undefined → pass through (no timestamp = don't filter)
+ *   - one undefined  → fall back to single-point semantics on the other end
+ *   - unparseable iso → defer to the parsable end (or pass through if both bad)
+ */
+export declare function inRangeOverlap(start: string | undefined, end: string | undefined, f: MemFilter): boolean;
+/** True iff `sessionCwd` is within `target` (exact match or descendant
+ * directory). When `target` is undefined there is no scoping and everything
+ * matches; sessions with an unknown cwd are dropped under scoping. */
+export declare function sameProject(sessionCwd: string | undefined, target: string | undefined): boolean;
+//# sourceMappingURL=filter.d.ts.map

package/dist/mem/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/mem/filter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;6BAE6B;AAC7B,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,CAOtE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,CAAC,EAAE,SAAS,GACX,OAAO,CAaT;AAED;;sEAEsE;AACtE,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,OAAO,CAMT"}

package/dist/mem/filter.js

@@ -0,0 +1,66 @@
+/**
+ * Project / time-range / source filters for mem session selection.
+ *
+ * These primitives belong to mem session filtering only — they are not
+ * promoted into a cross-domain `core/internal` until another core subdomain
+ * needs exactly the same semantics.
+ */
+import * as path from "node:path";
+/** Single-point range check: `since ≤ t ≤ until`. Pass-through when `iso` is
+ * undefined or unparseable. Internal-only — session list filtering uses
+ * {@link inRangeOverlap}. */
+export function inRange(iso, f) {
+    if (!iso)
+        return true;
+    const t = new Date(iso);
+    if (Number.isNaN(+t))
+        return true;
+    if (f.since && t < f.since)
+        return false;
+    if (f.until && t > f.until)
+        return false;
+    return true;
+}
+/**
+ * Interval-overlap range check for sessions with both a start and an end
+ * timestamp. A session is kept iff its lifetime `[start, end]` overlaps the
+ * query window `[since, until]`.
+ *
+ * Long / cross-day sessions (created before `--since` but still active inside
+ * the window) must survive — single-point `inRange(created, f)` dropped them.
+ *
+ * Degenerate inputs:
+ *   - both undefined → pass through (no timestamp = don't filter)
+ *   - one undefined  → fall back to single-point semantics on the other end
+ *   - unparseable iso → defer to the parsable end (or pass through if both bad)
+ */
+export function inRangeOverlap(start, end, f) {
+    const s = start ?? end;
+    const e = end ?? start;
+    if (!s && !e)
+        return true;
+    if (f.since && e) {
+        const eT = new Date(e);
+        if (!Number.isNaN(+eT) && eT < f.since)
+            return false;
+    }
+    if (f.until && s) {
+        const sT = new Date(s);
+        if (!Number.isNaN(+sT) && sT > f.until)
+            return false;
+    }
+    return true;
+}
+/** True iff `sessionCwd` is within `target` (exact match or descendant
+ * directory). When `target` is undefined there is no scoping and everything
+ * matches; sessions with an unknown cwd are dropped under scoping. */
+export function sameProject(sessionCwd, target) {
+    if (!target)
+        return true;
+    if (!sessionCwd)
+        return false;
+    const a = path.resolve(sessionCwd);
+    const b = path.resolve(target);
+    return a === b || a.startsWith(b + path.sep);
+}
+//# sourceMappingURL=filter.js.map

package/dist/mem/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/mem/filter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAIlC;;6BAE6B;AAC7B,MAAM,UAAU,OAAO,CAAC,GAAuB,EAAE,CAAY;IAC3D,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAyB,EACzB,GAAuB,EACvB,CAAY;IAEZ,MAAM,CAAC,GAAG,KAAK,IAAI,GAAG,CAAC;IACvB,MAAM,CAAC,GAAG,GAAG,IAAI,KAAK,CAAC;IACvB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACjB,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACjB,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;IACvD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;sEAEsE;AACtE,MAAM,UAAU,WAAW,CACzB,UAA8B,EAC9B,MAA0B;IAE1B,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,CAAC"}

package/dist/mem/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Public surface for `@blulotus/trellis-core/mem` — reusable retrieval and
+ * dialogue-context extraction over persisted Claude Code / Codex / OpenCode
+ * sessions.
+ *
+ * This subpackage is intentionally NOT re-exported from the root
+ * `@blulotus/trellis-core` barrel. Import it explicitly:
+ *
+ *   import { searchMemSessions } from "@blulotus/trellis-core/mem";
+ *
+ * v1 scope: persisted-session search and context extraction only. It does not
+ * read channel / forum / thread event logs and has no cursor / pagination.
+ */
+export { listMemSessions, searchMemSessions, extractMemDialogue, MemSessionNotFoundError, } from "./sessions.js";
+export { readMemContext } from "./context.js";
+export { listMemProjects } from "./projects.js";
+export type { MemSourceKind, MemSourceFilter, MemPhase, DialogueRole, DialogueTurn, MemFilter, MemSessionInfo, SearchExcerpt, SearchHit, MemWarning, MemSearchMatch, MemSearchResult, MemContextTurn, MemContextResult, BrainstormWindow, MemDialogueGroup, MemExtractResult, MemProjectSummary, ListMemSessionsOptions, SearchMemSessionsOptions, ReadMemContextOptions, ExtractMemDialogueOptions, ListMemProjectsOptions, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mem/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mem/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,YAAY,EACV,aAAa,EACb,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,cAAc,EACd,aAAa,EACb,SAAS,EACT,UAAU,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/mem/index.js

@@ -0,0 +1,17 @@
+/**
+ * Public surface for `@blulotus/trellis-core/mem` — reusable retrieval and
+ * dialogue-context extraction over persisted Claude Code / Codex / OpenCode
+ * sessions.
+ *
+ * This subpackage is intentionally NOT re-exported from the root
+ * `@blulotus/trellis-core` barrel. Import it explicitly:
+ *
+ *   import { searchMemSessions } from "@blulotus/trellis-core/mem";
+ *
+ * v1 scope: persisted-session search and context extraction only. It does not
+ * read channel / forum / thread event logs and has no cursor / pagination.
+ */
+export { listMemSessions, searchMemSessions, extractMemDialogue, MemSessionNotFoundError, } from "./sessions.js";
+export { readMemContext } from "./context.js";
+export { listMemProjects } from "./projects.js";
+//# sourceMappingURL=index.js.map

package/dist/mem/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mem/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/mem/internal/jsonl.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Streaming JSONL / JSON readers for the persisted-session adapters.
+ *
+ * Zero-dependency on purpose — `@blulotus/trellis-core` does not depend on
+ * `zod`. The original CLI implementation validated every line against a Zod
+ * schema; the external session formats were all declared `.loose()` with every
+ * field `.optional()`, so the only thing the schema actually rejected was a
+ * top-level non-object line — which the `0x7b` byte-prefix fast-reject already
+ * filters. Adapters therefore receive each parsed line cast to a hand-written
+ * loose interface and read fields defensively.
+ */
+/**
+ * Walk a JSONL file line-by-line, invoking `onLine` with each parsed object.
+ * Bad JSON lines are skipped. Returning the literal `"stop"` from `onLine`
+ * halts iteration.
+ *
+ * Chunked sync streaming: 256 KB read window, leftover preserved across chunks
+ * for split-line reassembly — bounded heap on multi-MB session files and a
+ * `"stop"` short-circuit that avoids reading the whole file when only the head
+ * is needed.
+ *
+ * Byte-prefix fast-reject: a JSONL event line virtually always begins with `{`.
+ * Lines whose first byte is not `{` are blanks / log preambles / partial writes
+ * and are skipped before paying the `JSON.parse` cost.
+ */
+export declare function readJsonl<T>(file: string, onLine: (obj: T) => unknown): void;
+/** Read just the first parseable JSONL object (stops after one line). */
+export declare function readJsonlFirst<T>(file: string): T | undefined;
+/** Find the first JSONL object satisfying `predicate`, scanning at most
+ * `maxLines` lines. */
+export declare function findInJsonl<T>(file: string, predicate: (obj: T) => boolean, maxLines?: number): T | undefined;
+/** Read and JSON-parse a whole file; returns `undefined` on read / parse
+ * failure. The caller is responsible for shape-checking the result. */
+export declare function readJsonFile<T>(file: string): T | undefined;
+//# sourceMappingURL=jsonl.d.ts.map

package/dist/mem/internal/jsonl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.d.ts","sourceRoot":"","sources":["../../../src/mem/internal/jsonl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI,CAqD5E;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAO7D;AAED;uBACuB;AACvB,wBAAgB,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,EAC9B,QAAQ,SAAM,GACb,CAAC,GAAG,SAAS,CAYf;AAED;uEACuE;AACvE,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAM3D"}

package/dist/mem/internal/jsonl.js

@@ -0,0 +1,125 @@
+/**
+ * Streaming JSONL / JSON readers for the persisted-session adapters.
+ *
+ * Zero-dependency on purpose — `@blulotus/trellis-core` does not depend on
+ * `zod`. The original CLI implementation validated every line against a Zod
+ * schema; the external session formats were all declared `.loose()` with every
+ * field `.optional()`, so the only thing the schema actually rejected was a
+ * top-level non-object line — which the `0x7b` byte-prefix fast-reject already
+ * filters. Adapters therefore receive each parsed line cast to a hand-written
+ * loose interface and read fields defensively.
+ */
+import * as fs from "node:fs";
+const CHUNK = 256 * 1024;
+const OPEN_BRACE = 0x7b; // '{'
+/**
+ * Walk a JSONL file line-by-line, invoking `onLine` with each parsed object.
+ * Bad JSON lines are skipped. Returning the literal `"stop"` from `onLine`
+ * halts iteration.
+ *
+ * Chunked sync streaming: 256 KB read window, leftover preserved across chunks
+ * for split-line reassembly — bounded heap on multi-MB session files and a
+ * `"stop"` short-circuit that avoids reading the whole file when only the head
+ * is needed.
+ *
+ * Byte-prefix fast-reject: a JSONL event line virtually always begins with `{`.
+ * Lines whose first byte is not `{` are blanks / log preambles / partial writes
+ * and are skipped before paying the `JSON.parse` cost.
+ */
+export function readJsonl(file, onLine) {
+    let fd;
+    try {
+        fd = fs.openSync(file, "r");
+    }
+    catch {
+        return;
+    }
+    const buf = Buffer.alloc(CHUNK);
+    let leftover = "";
+    try {
+        let stop = false;
+        while (!stop) {
+            const n = fs.readSync(fd, buf, 0, CHUNK, null);
+            if (n === 0)
+                break;
+            const chunk = leftover + buf.toString("utf8", 0, n);
+            let from = 0;
+            while (true) {
+                const nl = chunk.indexOf("\n", from);
+                if (nl === -1) {
+                    leftover = chunk.slice(from);
+                    break;
+                }
+                const line = chunk.slice(from, nl);
+                from = nl + 1;
+                if (!line)
+                    continue;
+                if (line.charCodeAt(0) !== OPEN_BRACE)
+                    continue;
+                let raw;
+                try {
+                    raw = JSON.parse(line);
+                }
+                catch {
+                    continue;
+                }
+                if (onLine(raw) === "stop") {
+                    stop = true;
+                    break;
+                }
+            }
+        }
+        if (!stop && leftover) {
+            // File ended without a trailing newline — process the last partial line.
+            const line = leftover;
+            if (line.charCodeAt(0) === OPEN_BRACE) {
+                try {
+                    const raw = JSON.parse(line);
+                    onLine(raw);
+                }
+                catch {
+                    /* skip */
+                }
+            }
+        }
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+}
+/** Read just the first parseable JSONL object (stops after one line). */
+export function readJsonlFirst(file) {
+    let result;
+    readJsonl(file, (obj) => {
+        result = obj;
+        return "stop";
+    });
+    return result;
+}
+/** Find the first JSONL object satisfying `predicate`, scanning at most
+ * `maxLines` lines. */
+export function findInJsonl(file, predicate, maxLines = 200) {
+    let count = 0;
+    let hit;
+    readJsonl(file, (obj) => {
+        count++;
+        if (predicate(obj)) {
+            hit = obj;
+            return "stop";
+        }
+        if (count >= maxLines)
+            return "stop";
+    });
+    return hit;
+}
+/** Read and JSON-parse a whole file; returns `undefined` on read / parse
+ * failure. The caller is responsible for shape-checking the result. */
+export function readJsonFile(file) {
+    try {
+        return JSON.parse(fs.readFileSync(file, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=jsonl.js.map

package/dist/mem/internal/jsonl.js.map

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

package/dist/mem/internal/paths.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Default home-based session roots for the persisted-session adapters.
+ *
+ * `HOME` is captured once at module load — consumers that need to point the
+ * adapters at a fake home (tests) must mock `node:os` before importing any
+ * mem module.
+ */
+export declare const HOME: string;
+export declare const CLAUDE_PROJECTS: string;
+export declare const CODEX_SESSIONS: string;
+/** ZCode (Zhipu) persisted-session SQLite store. The companion `-wal` file is
+ * auto-detected by the readonly parser. */
+export declare const ZCODE_DB: string;
+/** Grok CLI session root: `<cwd url-encoded>/<session-id>/chat_history.jsonl`.
+ * The sibling `session_search.sqlite` is a search index only and is not read —
+ * this adapter needs no database and adds no dependency. */
+export declare const GROK_SESSIONS: string;
+export declare const PI_AGENT_DIR: string;
+export declare const PI_SESSIONS: string;
+/** Claude sanitizes a cwd into its on-disk project dir name by replacing
+ * every path separator (`/` and Windows `\`), drive colon (`:`), `_`, and `.`
+ * with `-`. Confirmed empirically against `~/.claude/projects/`:
+ * `/Users/x/.codex/...` → `-Users-x--codex-...`, `snap_note` → `snap-note`. */
+export declare function claudeProjectDirFromCwd(cwd: string): string;
+/** Grok names each project dir with the URL-encoded absolute cwd, e.g.
+ * `/Users/x/proj` → `%2FUsers%2Fx%2Fproj`. */
+export declare function grokProjectDirFromCwd(cwd: string): string;
+/** Inverse of {@link grokProjectDirFromCwd}. Returns `undefined` when the name
+ * is not valid percent-encoding rather than throwing on a stray `%`. */
+export declare function grokCwdFromProjectDir(dirName: string): string | undefined;
+/** Pi encodes a cwd as `--<resolved-cwd-with-separators-as-dashes>--`. */
+export declare function piProjectDirFromCwd(cwd: string): string;
+/** Discover Pi session roots visible from the current process and project. */
+export declare function piSessionRoots(cwd?: string): string[];
+/** Lazy stack-based recursive file walk — yields every file path under
+ * `root`. Missing roots and unreadable directories are skipped silently. */
+export declare function walkDir(root: string): Generator<string>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/mem/internal/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/mem/internal/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,eAAO,MAAM,IAAI,QAAe,CAAC;AACjC,eAAO,MAAM,eAAe,QAAyC,CAAC;AACtE,eAAO,MAAM,cAAc,QAAwC,CAAC;AACpE;2CAC2C;AAC3C,eAAO,MAAM,QAAQ,QAAsD,CAAC;AAC5E;;4DAE4D;AAC5D,eAAO,MAAM,aAAa,QAAuC,CAAC;AASlE,eAAO,MAAM,YAAY,QAExB,CAAC;AACF,eAAO,MAAM,WAAW,QAGvB,CAAC;AAiBF;;;+EAG+E;AAC/E,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;8CAC8C;AAC9C,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;wEACwE;AACxE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMzE;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBrD;AAED;4EAC4E;AAC5E,wBAAiB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAkBxD"}

package/dist/mem/internal/paths.js

@@ -0,0 +1,126 @@
+/**
+ * Default home-based session roots for the persisted-session adapters.
+ *
+ * `HOME` is captured once at module load — consumers that need to point the
+ * adapters at a fake home (tests) must mock `node:os` before importing any
+ * mem module.
+ */
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+export const HOME = os.homedir();
+export const CLAUDE_PROJECTS = path.join(HOME, ".claude", "projects");
+export const CODEX_SESSIONS = path.join(HOME, ".codex", "sessions");
+/** ZCode (Zhipu) persisted-session SQLite store. The companion `-wal` file is
+ * auto-detected by the readonly parser. */
+export const ZCODE_DB = path.join(HOME, ".zcode", "cli", "db", "db.sqlite");
+/** Grok CLI session root: `<cwd url-encoded>/<session-id>/chat_history.jsonl`.
+ * The sibling `session_search.sqlite` is a search index only and is not read —
+ * this adapter needs no database and adds no dependency. */
+export const GROK_SESSIONS = path.join(HOME, ".grok", "sessions");
+function expandHome(p) {
+    if (p === "~")
+        return HOME;
+    if (p.startsWith(`~${path.sep}`))
+        return path.join(HOME, p.slice(2));
+    if (p.startsWith("~/"))
+        return path.join(HOME, p.slice(2));
+    return p;
+}
+export const PI_AGENT_DIR = expandHome(process.env.PI_CODING_AGENT_DIR ?? path.join(HOME, ".pi", "agent"));
+export const PI_SESSIONS = expandHome(process.env.PI_CODING_AGENT_SESSION_DIR ??
+    path.join(PI_AGENT_DIR, "sessions"));
+function readPiSettingsSessionDir(settingsFile) {
+    try {
+        const raw = JSON.parse(fs.readFileSync(settingsFile, "utf8"));
+        if (!raw || typeof raw !== "object" || Array.isArray(raw))
+            return undefined;
+        const sessionDir = raw.sessionDir;
+        if (typeof sessionDir !== "string" || !sessionDir.trim())
+            return undefined;
+        const expanded = expandHome(sessionDir);
+        return path.isAbsolute(expanded)
+            ? expanded
+            : path.resolve(path.dirname(settingsFile), expanded);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Claude sanitizes a cwd into its on-disk project dir name by replacing
+ * every path separator (`/` and Windows `\`), drive colon (`:`), `_`, and `.`
+ * with `-`. Confirmed empirically against `~/.claude/projects/`:
+ * `/Users/x/.codex/...` → `-Users-x--codex-...`, `snap_note` → `snap-note`. */
+export function claudeProjectDirFromCwd(cwd) {
+    return path.join(CLAUDE_PROJECTS, cwd.replace(/[/\\:_.]/g, "-"));
+}
+/** Grok names each project dir with the URL-encoded absolute cwd, e.g.
+ * `/Users/x/proj` → `%2FUsers%2Fx%2Fproj`. */
+export function grokProjectDirFromCwd(cwd) {
+    return path.join(GROK_SESSIONS, encodeURIComponent(path.resolve(cwd)));
+}
+/** Inverse of {@link grokProjectDirFromCwd}. Returns `undefined` when the name
+ * is not valid percent-encoding rather than throwing on a stray `%`. */
+export function grokCwdFromProjectDir(dirName) {
+    try {
+        return decodeURIComponent(dirName);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Pi encodes a cwd as `--<resolved-cwd-with-separators-as-dashes>--`. */
+export function piProjectDirFromCwd(cwd) {
+    const resolvedCwd = path.resolve(cwd);
+    const safePath = `--${resolvedCwd.replace(/^[/\\]/, "").replace(/[/\\:]/g, "-")}--`;
+    return path.join(path.join(PI_AGENT_DIR, "sessions"), safePath);
+}
+/** Discover Pi session roots visible from the current process and project. */
+export function piSessionRoots(cwd) {
+    const roots = [path.join(PI_AGENT_DIR, "sessions"), PI_SESSIONS];
+    const globalSettingsDir = readPiSettingsSessionDir(path.join(PI_AGENT_DIR, "settings.json"));
+    if (globalSettingsDir)
+        roots.push(globalSettingsDir);
+    if (cwd) {
+        const projectSettingsDir = readPiSettingsSessionDir(path.join(path.resolve(cwd), ".pi", "settings.json"));
+        if (projectSettingsDir)
+            roots.push(projectSettingsDir);
+    }
+    const seen = new Set();
+    const out = [];
+    for (const root of roots) {
+        const normalized = path.resolve(root);
+        if (seen.has(normalized))
+            continue;
+        seen.add(normalized);
+        out.push(root);
+    }
+    return out;
+}
+/** Lazy stack-based recursive file walk — yields every file path under
+ * `root`. Missing roots and unreadable directories are skipped silently. */
+export function* walkDir(root) {
+    if (!fs.existsSync(root))
+        return;
+    const stack = [root];
+    while (stack.length) {
+        const cur = stack.pop();
+        if (cur === undefined)
+            break;
+        let entries;
+        try {
+            entries = fs.readdirSync(cur, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            const p = path.join(cur, e.name);
+            if (e.isDirectory())
+                stack.push(p);
+            else if (e.isFile())
+                yield p;
+        }
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/mem/internal/paths.js.map

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

package/dist/mem/internal/sqlite-readonly.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Zero-dependency read-only SQLite file parser.
+ *
+ * `@blulotus/trellis-core` is intentionally free of runtime dependencies —
+ * `better-sqlite3` was tried for the OpenCode adapter and reverted because its
+ * native build chain broke `npm install` on Windows + restricted networks. This
+ * parser is the minimum viable reader needed by the ZCode `mem` adapter: list
+ * tables, full-scan one table, return rows as `{ [columnName]: value }`. It is
+ * NOT a SQL engine: no WHERE pushdown, no index lookup, no writes.
+ *
+ * Scope:
+ *   - Database header (page size, db size, text encoding, WAL flag)
+ *   - Table b-tree leaf (0x0d) + interior (0x05) traversal
+ *   - Record decode for TEXT / INTEGER / NULL / float64 / BLOB(serial only)
+ *   - Overflow page chains (long TEXT rows like ZCode `message.data`)
+ *   - WAL replay: stable main/WAL snapshot, WAL-index `mxFrame` end mark, and
+ *     cumulative header/frame checksum verification.
+ *
+ * Out of scope:
+ *   - WITHOUT ROWID tables (return [] — their rows live in index b-trees,
+ *     which this parser doesn't walk). ZCode's tables are normal rowid tables.
+ *
+ * Format references:
+ *   - https://www.sqlite.org/fileformat2.html
+ *   - https://www.sqlite.org/walformat.html
+ *
+ * All multi-byte integers are big-endian (SQLite's native byte order).
+ */
+/** One row from `scanTable`, keyed by column name. Values are decoded JS
+ * primitives. NULL → null, INTEGER → number, TEXT → string, BLOB →
+ * Uint8Array, float → number. Columns are keyed by the CREATE TABLE column
+ * order; if the column-name parse failed, keys fall back to `col0`, `col1`... */
+export type SqliteRow = Record<string, unknown>;
+export interface SqliteTableInfo {
+    name: string;
+    rootPgno: number;
+    /** The raw `CREATE TABLE` SQL (used to recover column names). */
+    sql: string;
+}
+export interface SqliteReadOnly {
+    /** List user tables (type='table') from sqlite_master. */
+    listTables(): SqliteTableInfo[];
+    /** Full-scan a table by name, yielding rows. Returns [] when the table is
+     * missing. Throws `SqliteParseError` on structural corruption. */
+    scanTable(tableName: string, predicate?: (row: SqliteRow) => boolean): SqliteRow[];
+    /** The db file path this reader was opened against. */
+    readonly dbPath: string;
+    close(): void;
+}
+/** Thrown when the SQLite file is structurally invalid. Adapters are expected
+ * to catch this and degrade to an empty result rather than crash the CLI. */
+export declare class SqliteParseError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+/**
+ * Thrown when the database files do not remain stable across all snapshot
+ * capture attempts. This is deliberately distinct from a malformed database:
+ * callers must not parse a snapshot whose consistency they could not verify.
+ */
+export declare class SqliteSnapshotUnstableError extends SqliteParseError {
+    constructor(mainPath: string);
+}
+/**
+ * Open a SQLite database file for read-only access. Automatically loads the
+ * sibling `<db>-wal` file when present so active WAL-mode databases (e.g.
+ * ZCode's running store) return their latest committed data.
+ *
+ * Throws `SqliteParseError` if `mainPath` is not a SQLite file or is too
+ * corrupted to read the header. Adapters should catch and degrade.
+ */
+export declare function openSqliteReadOnly(mainPath: string): SqliteReadOnly;
+/** Convenience: open + scan + close in one call. Returns [] on any parse error
+ * or missing table, never throws. Useful for adapters that already decided to
+ * degrade silently. */
+export declare function scanTableSafe(mainPath: string, tableName: string): SqliteRow[];
+//# sourceMappingURL=sqlite-readonly.d.ts.map

package/dist/mem/internal/sqlite-readonly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-readonly.d.ts","sourceRoot":"","sources":["../../../src/mem/internal/sqlite-readonly.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAMH;;;iFAGiF;AACjF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,UAAU,IAAI,eAAe,EAAE,CAAC;IAChC;sEACkE;IAClE,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,GACtC,SAAS,EAAE,CAAC;IACf,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,KAAK,IAAI,IAAI,CAAC;CACf;AAID;6EAC6E;AAC7E,qBAAa,gBAAiB,SAAQ,KAAK;IAGvC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;gBADxB,OAAO,EAAE,MAAM,EACN,KAAK,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED;;;;GAIG;AACH,qBAAa,2BAA4B,SAAQ,gBAAgB;gBACnD,QAAQ,EAAE,MAAM;CAM7B;AAyxBD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CA2HnE;AAED;;uBAEuB;AACvB,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,SAAS,EAAE,CAWb"}