@vortex-os/memory-extended 0.5.1

package/dist/sessionArchive/store.js

@@ -0,0 +1,491 @@
+import Database from "better-sqlite3";
+import { chmodSync, copyFileSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { join, relative, resolve, sep } from "node:path";
+import { MAX_TRANSCRIPT_BYTES } from "./types.js";
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS ingested_sessions (
+  host             TEXT NOT NULL,
+  session_id       TEXT NOT NULL,
+  cwd              TEXT NOT NULL,
+  started_at       TEXT NOT NULL,
+  ended_at         TEXT,
+  model            TEXT,
+  event_count      INTEGER NOT NULL,
+  raw_path         TEXT NOT NULL,
+  normalized_path  TEXT NOT NULL,
+  ingested_at      TEXT NOT NULL,
+  reviewed_at      TEXT,
+  source_mtime_ms  INTEGER NOT NULL,
+  PRIMARY KEY (host, session_id)
+);
+
+CREATE TABLE IF NOT EXISTS events (
+  host         TEXT NOT NULL,
+  session_id   TEXT NOT NULL,
+  idx          INTEGER NOT NULL,
+  turn_id      TEXT,
+  kind         TEXT NOT NULL,
+  at           TEXT NOT NULL,
+  text         TEXT,
+  tool_use_id  TEXT,
+  PRIMARY KEY (host, session_id, idx)
+);
+
+CREATE INDEX IF NOT EXISTS events_kind_at ON events(kind, at);
+CREATE INDEX IF NOT EXISTS events_turn ON events(host, session_id, turn_id);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS events_fts USING fts5(
+  text,
+  content = 'events',
+  content_rowid = 'rowid'
+);
+
+CREATE TRIGGER IF NOT EXISTS events_ai AFTER INSERT ON events BEGIN
+  INSERT INTO events_fts(rowid, text) VALUES (new.rowid, new.text);
+END;
+
+CREATE TRIGGER IF NOT EXISTS events_ad AFTER DELETE ON events BEGIN
+  INSERT INTO events_fts(events_fts, rowid, text) VALUES('delete', old.rowid, old.text);
+END;
+
+CREATE TRIGGER IF NOT EXISTS events_au AFTER UPDATE ON events BEGIN
+  INSERT INTO events_fts(events_fts, rowid, text) VALUES('delete', old.rowid, old.text);
+  INSERT INTO events_fts(rowid, text) VALUES (new.rowid, new.text);
+END;
+`;
+/**
+ * Append-only store backing the sessionArchive namespace.
+ *
+ * Layout under `<dataDir>/_session-archive/`:
+ *   raw/<host>/<session-id>.{jsonl|json}    ← byte-for-byte copy of host file (when available)
+ *   normalized/YYYY/MM/<session-id>.jsonl    ← vortex VortexTranscriptEvent JSONL
+ *   metadata.sqlite                          ← ingested_sessions + events + events_fts
+ *
+ * SQLite indexes are rebuildable from the normalized JSONL — they are derived state, not SoT.
+ */
+export class SessionArchiveStore {
+    archiveDir;
+    rawDir;
+    normalizedDir;
+    dbPath;
+    db;
+    constructor(dataDir) {
+        this.archiveDir = join(dataDir, "_session-archive");
+        this.rawDir = join(this.archiveDir, "raw");
+        this.normalizedDir = join(this.archiveDir, "normalized");
+        this.dbPath = join(this.archiveDir, "metadata.sqlite");
+        // Transcript archives hold verbatim session content; on multi-user POSIX
+        // hosts they should not be world/group readable. mode 0o700 (dirs) / 0o600
+        // (files) is a no-op on Windows but protects POSIX. Applied as a chmod after
+        // creation too, since mkdirSync's mode is masked by umask on first create.
+        mkdirSync(this.archiveDir, { recursive: true, mode: 0o700 });
+        mkdirSync(this.rawDir, { recursive: true, mode: 0o700 });
+        mkdirSync(this.normalizedDir, { recursive: true, mode: 0o700 });
+        chmodDirQuietly(this.archiveDir);
+        chmodDirQuietly(this.rawDir);
+        chmodDirQuietly(this.normalizedDir);
+        this.db = new Database(this.dbPath);
+        chmodFileQuietly(this.dbPath); // 0o600 — index holds transcript-derived data
+        this.db.pragma("journal_mode = WAL");
+        this.db.exec(SCHEMA);
+        this.migrate();
+    }
+    /** True iff a session with the same (host, sessionId) is already ingested at or beyond the given mtime. */
+    hasIngested(host, sessionId, mtimeMs) {
+        const row = this.db
+            .prepare("SELECT source_mtime_ms FROM ingested_sessions WHERE host = ? AND session_id = ?")
+            .get(host, sessionId);
+        return !!row && row.source_mtime_ms >= mtimeMs;
+    }
+    /** All rows in `ingested_sessions` — used by the orchestrator for incremental re-scan. */
+    listIngested() {
+        const rows = this.db
+            .prepare("SELECT host, session_id, source_mtime_ms FROM ingested_sessions")
+            .all();
+        return rows.map((r) => ({ host: r.host, sessionId: r.session_id, mtimeMs: r.source_mtime_ms }));
+    }
+    /**
+     * Session metadata — used by consolidate (and any future analyzer) to
+     * filter recently-ingested sessions before pulling their event bodies.
+     *
+     * Ordered newest-ingested first. `sinceMs` is checked against
+     * `ingested_at`, not the session's own `started_at`, so a session that
+     * was ingested today but happened weeks ago still surfaces on a
+     * "consolidate since last run" query.
+     */
+    listSessions(options) {
+        const wheres = [];
+        const params = [];
+        if (options?.sinceMs !== undefined) {
+            wheres.push("ingested_at > ?");
+            params.push(options.sinceMs);
+        }
+        if (options?.hosts && options.hosts.length > 0) {
+            wheres.push(`host IN (${options.hosts.map(() => "?").join(", ")})`);
+            params.push(...options.hosts);
+        }
+        if (options?.onlyUnreviewed) {
+            wheres.push("reviewed_at IS NULL");
+        }
+        let sql = `
+      SELECT host, session_id, cwd, started_at, ended_at, model, event_count, ingested_at, reviewed_at
+      FROM ingested_sessions
+    `;
+        if (wheres.length > 0)
+            sql += ` WHERE ${wheres.join(" AND ")}`;
+        sql += ` ORDER BY ingested_at DESC`;
+        if (options?.limit !== undefined) {
+            sql += ` LIMIT ?`;
+            params.push(options.limit);
+        }
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map((r) => ({
+            host: r.host,
+            sessionId: r.session_id,
+            cwd: r.cwd,
+            startedAt: r.started_at,
+            endedAt: r.ended_at,
+            model: r.model,
+            eventCount: r.event_count,
+            ingestedAt: r.ingested_at,
+            reviewedAt: r.reviewed_at,
+        }));
+    }
+    /**
+     * Replay all events of one session, in original order. Useful for analyzers
+     * (consolidate, future LLM-driven tooling) that need the actual content,
+     * not just metadata.
+     */
+    readSessionEvents(host, sessionId) {
+        const rows = this.db
+            .prepare(`
+        SELECT idx, turn_id, kind, at, text, tool_use_id
+        FROM events
+        WHERE host = ? AND session_id = ?
+        ORDER BY idx ASC
+      `)
+            .all(host, sessionId);
+        return rows.map((r) => ({
+            idx: r.idx,
+            turnId: r.turn_id,
+            kind: r.kind,
+            at: r.at,
+            text: r.text,
+            toolUseId: r.tool_use_id,
+        }));
+    }
+    /**
+     * Persist a normalized session — writes the raw copy (if a source path is provided),
+     * writes the normalized JSONL, and replaces metadata + events rows in a single transaction.
+     */
+    writeSession(session, rawSourcePath, sourceMtimeMs) {
+        const rawAbs = rawSourcePath ? this.writeRawCopy(session.host, session.sessionId, rawSourcePath) : "";
+        const normalizedAbs = this.writeNormalized(session);
+        // writeRawCopy returns "" when the source is a directory or missing — treat as no raw.
+        const rawRel = rawAbs ? relative(this.archiveDir, rawAbs).replace(/\\/g, "/") : "";
+        const normalizedRel = relative(this.archiveDir, normalizedAbs).replace(/\\/g, "/");
+        this.indexSession(session, rawRel, normalizedRel, sourceMtimeMs);
+    }
+    /**
+     * DB-only upsert of a session's metadata + events — no file writes. Shared
+     * by {@link writeSession} (fresh ingest, which also writes the raw +
+     * normalized files first) and {@link reindexFromNormalized} (a session whose
+     * normalized text is already on disk, typically pulled from another machine
+     * via git). `INSERT OR REPLACE` intentionally clears `reviewed_at`: a
+     * re-indexed session has new content since any prior review, so curate
+     * should surface it again.
+     */
+    indexSession(session, rawRel, normalizedRel, sourceMtimeMs) {
+        const deleteOld = this.db.prepare(`DELETE FROM events WHERE host = ? AND session_id = ?`);
+        const insertSession = this.db.prepare(`
+      INSERT OR REPLACE INTO ingested_sessions
+      (host, session_id, cwd, started_at, ended_at, model, event_count,
+       raw_path, normalized_path, ingested_at, source_mtime_ms)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        const insertEvent = this.db.prepare(`
+      INSERT INTO events (host, session_id, idx, turn_id, kind, at, text, tool_use_id)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        const tx = this.db.transaction(() => {
+            deleteOld.run(session.host, session.sessionId);
+            insertSession.run(session.host, session.sessionId, session.cwd, session.startedAt, session.endedAt ?? null, session.model ?? null, session.events.length, rawRel, normalizedRel, new Date().toISOString(), sourceMtimeMs);
+            session.events.forEach((ev, idx) => {
+                insertEvent.run(session.host, session.sessionId, idx, getTurnId(ev), ev.kind, ev.at, getEventText(ev), getToolUseId(ev));
+            });
+        });
+        tx();
+    }
+    /**
+     * Index any normalized transcript on disk that this DB has not seen yet, and
+     * return the session ids newly indexed.
+     *
+     * The normalized JSONL under `normalized/` is the synced source of truth; the
+     * sqlite DB is local, derived, and gitignored. So a session created on another
+     * machine arrives here as a normalized file (via git pull) with no DB row
+     * until this runs — this is what makes a pulled conversation searchable on
+     * this machine. Already-indexed sessions are skipped by `(host, sessionId)`.
+     */
+    reindexFromNormalized() {
+        const known = new Set(this.listIngested().map((r) => `${r.host}${r.sessionId}`));
+        const ids = [];
+        for (const file of this.listNormalizedFiles()) {
+            // Size cap: stat before reading so an oversized normalized file (e.g. one
+            // pulled in via git) is never slurped into memory. Skip it on over-cap.
+            let mtimeMs = 0;
+            try {
+                const st = statSync(file);
+                if (st.size > MAX_TRANSCRIPT_BYTES)
+                    continue;
+                mtimeMs = st.mtimeMs;
+            }
+            catch {
+                // unreadable stat — index with 0; presence in the table is what matters
+            }
+            const session = readNormalizedSession(file);
+            if (!session)
+                continue;
+            const key = `${session.host}${session.sessionId}`;
+            if (known.has(key))
+                continue;
+            const normalizedRel = relative(this.archiveDir, file).replace(/\\/g, "/");
+            this.indexSession(session, "", normalizedRel, mtimeMs);
+            known.add(key);
+            ids.push(session.sessionId);
+        }
+        return { indexed: ids.length, sessionIds: ids };
+    }
+    /** Every `*.jsonl` under the normalized dir (`normalized/YYYY/MM/<id>.jsonl`). */
+    listNormalizedFiles() {
+        const out = [];
+        const walk = (dir) => {
+            let entries;
+            try {
+                entries = readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const e of entries) {
+                const p = join(dir, e.name);
+                if (e.isDirectory())
+                    walk(p);
+                else if (e.isFile() && e.name.endsWith(".jsonl"))
+                    out.push(p);
+            }
+        };
+        walk(this.normalizedDir);
+        return out;
+    }
+    /** Stamp a session as curate-reviewed at the given ISO-8601 time (last write wins). */
+    markReviewed(host, sessionId, atIso) {
+        this.db
+            .prepare("UPDATE ingested_sessions SET reviewed_at = ? WHERE host = ? AND session_id = ?")
+            .run(atIso, host, sessionId);
+    }
+    /**
+     * Additive schema migrations for DBs created by an earlier version.
+     * `CREATE TABLE IF NOT EXISTS` will not add a column to a table that
+     * already exists, so new columns are introduced here, guarded by a
+     * column-presence check so the migration is idempotent.
+     */
+    migrate() {
+        const cols = this.db
+            .prepare("PRAGMA table_info(ingested_sessions)")
+            .all();
+        if (!cols.some((c) => c.name === "reviewed_at")) {
+            this.db.exec("ALTER TABLE ingested_sessions ADD COLUMN reviewed_at TEXT");
+        }
+    }
+    close() {
+        this.db.close();
+    }
+    writeRawCopy(host, sessionId, sourcePath) {
+        // Only copy regular files. Claude Desktop passes a directory path (the LevelDB dir),
+        // and tests sometimes pass paths that don't exist on disk — in both cases skip the raw
+        // copy and let `writeSession` proceed with normalized-only storage.
+        let stat;
+        try {
+            stat = statSync(sourcePath);
+        }
+        catch {
+            return "";
+        }
+        if (!stat.isFile())
+            return "";
+        // host + sessionId are derived from adapter-parsed host fields / transcript
+        // filenames (external input). Validate as path segments before interpolating
+        // them, then containment-check the resolved target. (mirror base validateSegment)
+        validateSegment("host", host);
+        validateSegment("sessionId", sessionId);
+        const hostDir = join(this.rawDir, host);
+        assertContained(hostDir, this.rawDir);
+        mkdirSync(hostDir, { recursive: true, mode: 0o700 });
+        chmodDirQuietly(hostDir);
+        const ext = sourcePath.toLowerCase().endsWith(".json") ? ".json" : ".jsonl";
+        const target = join(hostDir, `${sessionId}${ext}`);
+        assertContained(target, this.rawDir);
+        copyFileSync(sourcePath, target);
+        chmodFileQuietly(target); // 0o600 — verbatim copy of the host transcript
+        return target;
+    }
+    writeNormalized(session) {
+        // sessionId is external input (adapter-parsed from a transcript filename).
+        // Validate it as a path segment, then containment-check the resolved target.
+        // (mirror base validateSegment / assertContained)
+        validateSegment("sessionId", session.sessionId);
+        const started = new Date(session.startedAt);
+        const yearDir = String(started.getUTCFullYear());
+        const monthDir = String(started.getUTCMonth() + 1).padStart(2, "0");
+        const targetDir = join(this.normalizedDir, yearDir, monthDir);
+        mkdirSync(targetDir, { recursive: true, mode: 0o700 });
+        chmodDirQuietly(targetDir);
+        const target = join(targetDir, `${session.sessionId}.jsonl`);
+        assertContained(target, this.normalizedDir);
+        const headerLine = JSON.stringify({
+            kind: "session_header",
+            host: session.host,
+            sessionId: session.sessionId,
+            cwd: session.cwd,
+            startedAt: session.startedAt,
+            endedAt: session.endedAt,
+            model: session.model,
+            cliVersion: session.cliVersion,
+        });
+        const eventLines = session.events.map((ev) => JSON.stringify(ev));
+        writeFileSync(target, [headerLine, ...eventLines].join("\n") + "\n", { encoding: "utf8", mode: 0o600 });
+        chmodFileQuietly(target); // ensure 0o600 even if the file pre-existed with looser perms
+        return target;
+    }
+}
+// chmod helpers — best-effort POSIX hardening. On Windows (and other platforms
+// where chmod is unsupported / the path is gone) these are intentional no-ops:
+// archive integrity must never hinge on a permission bit failing to set.
+function chmodDirQuietly(path) {
+    try {
+        chmodSync(path, 0o700);
+    }
+    catch {
+        /* no-op on Windows / unsupported FS */
+    }
+}
+function chmodFileQuietly(path) {
+    try {
+        chmodSync(path, 0o600);
+    }
+    catch {
+        /* no-op on Windows / unsupported FS */
+    }
+}
+/**
+ * Reject a path segment (host / sessionId) that could escape the archive
+ * directory or smuggle a path into a filename. host + sessionId derive from
+ * adapter-parsed transcript filenames / host fields, which are external input,
+ * so the same defensive rules as `@vortex-os/base` (worklog/decision-log
+ * `validateSegment`) apply: no path separators, no `..` traversal, no
+ * absolute paths / drive letters / UNC, no leading `~`, no NUL / control chars,
+ * not empty or bare `.`/`..`.
+ */
+function validateSegment(label, value) {
+    const v = (value ?? "").trim();
+    if (v.length === 0)
+        throw new Error(`${label} is required`);
+    if (v === "." || v === "..")
+        throw new Error(`${label} must not be '.' or '..': ${value}`);
+    if (v.includes("/") || v.includes("\\"))
+        throw new Error(`${label} must not contain path separators: ${value}`);
+    if (/(^|[\\/])\.\.([\\/]|$)/.test(v))
+        throw new Error(`${label} must not contain '..': ${value}`);
+    if (v.startsWith("/") || v.startsWith("\\") || /^[a-zA-Z]:/.test(v))
+        throw new Error(`${label} must be a relative name, not an absolute path: ${value}`);
+    if (v.startsWith("~"))
+        throw new Error(`${label} must not start with '~': ${value}`);
+    // eslint-disable-next-line no-control-regex
+    if (/[\u0000-\u001f\u007f]/.test(v))
+        throw new Error(`${label} must not contain NUL or control characters: ${value}`);
+}
+/**
+ * Defense-in-depth containment: the resolved absolute target must live inside
+ * `rootDir`. Catches any traversal the segment check missed (symlinks, future
+ * callers). Throws on escape. Mirrors worklog/decision-log `assertContained`
+ * and the `runWriteDocument` data-root guard in `mcp/document-tools.ts`.
+ */
+function assertContained(abs, rootDir) {
+    const root = resolve(rootDir);
+    const target = resolve(abs);
+    if (target !== root && !(target + sep).startsWith(root + sep)) {
+        throw new Error(`Refusing to write outside the archive directory: ${abs}`);
+    }
+}
+// Helpers — narrow VortexTranscriptEvent's discriminated union without `any`.
+function getTurnId(ev) {
+    return ev.kind === "meta" ? null : ev.turnId;
+}
+function getEventText(ev) {
+    switch (ev.kind) {
+        case "user_message":
+        case "assistant_message":
+            return ev.text;
+        case "tool_result":
+            return ev.content;
+        default:
+            return null;
+    }
+}
+function getToolUseId(ev) {
+    if (ev.kind === "tool_call" || ev.kind === "tool_result")
+        return ev.toolUseId;
+    return null;
+}
+/**
+ * Reconstruct a session from a normalized JSONL file (the inverse of
+ * {@link SessionArchiveStore.writeNormalized}): line 1 is the
+ * `session_header`, the rest are one `VortexTranscriptEvent` each. Returns
+ * null for an unreadable file or a missing/invalid header; a single malformed
+ * event line is skipped rather than discarding the whole session.
+ */
+function readNormalizedSession(path) {
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const lines = raw.split(/\r?\n/).filter((l) => l.length > 0);
+    if (lines.length === 0)
+        return null;
+    let header;
+    try {
+        header = JSON.parse(lines[0]);
+    }
+    catch {
+        return null;
+    }
+    if (header.kind !== "session_header" ||
+        !header.host ||
+        typeof header.sessionId !== "string" ||
+        typeof header.startedAt !== "string") {
+        return null;
+    }
+    const events = [];
+    for (let i = 1; i < lines.length; i++) {
+        try {
+            events.push(JSON.parse(lines[i]));
+        }
+        catch {
+            // skip a malformed event line rather than dropping the whole session
+        }
+    }
+    return {
+        host: header.host,
+        sessionId: header.sessionId,
+        cwd: header.cwd ?? "",
+        startedAt: header.startedAt,
+        endedAt: header.endedAt ?? undefined,
+        model: header.model ?? undefined,
+        cliVersion: header.cliVersion ?? undefined,
+        events,
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/sessionArchive/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/sessionArchive/store.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDd,CAAC;AAyCF;;;;;;;;;GASG;AACH,MAAM,OAAO,mBAAmB;IACrB,UAAU,CAAS;IACnB,MAAM,CAAS;IACf,aAAa,CAAS;IACtB,MAAM,CAAS;IAChB,EAAE,CAAoB;IAE9B,YAAY,OAAe;QACzB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;QAEvD,yEAAyE;QACzE,2EAA2E;QAC3E,6EAA6E;QAC7E,2EAA2E;QAC3E,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAChE,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAEpC,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,8CAA8C;QAC7E,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,2GAA2G;IAC3G,WAAW,CAAC,IAAY,EAAE,SAAiB,EAAE,OAAe;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CAAC,iFAAiF,CAAC;aAC1F,GAAG,CAAC,IAAI,EAAE,SAAS,CAA4C,CAAC;QACnE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC;IACjD,CAAC;IAED,0FAA0F;IAC1F,YAAY;QACV,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC,iEAAiE,CAAC;aAC1E,GAAG,EAAkF,CAAC;QACzF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IAClG,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY,CAAC,OAA6B;QACxC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,OAAO,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,OAAO,EAAE,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpE,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,GAAG,GAAG;;;KAGT,CAAC;QACF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,IAAI,UAAU,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/D,GAAG,IAAI,4BAA4B,CAAC;QACpC,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC;YACjC,GAAG,IAAI,UAAU,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAU7C,CAAC;QACH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS,EAAE,CAAC,CAAC,UAAU;YACvB,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,SAAS,EAAE,CAAC,CAAC,UAAU;YACvB,OAAO,EAAE,CAAC,CAAC,QAAQ;YACnB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,UAAU,EAAE,CAAC,CAAC,WAAW;YACzB,UAAU,EAAE,CAAC,CAAC,WAAW;YACzB,UAAU,EAAE,CAAC,CAAC,WAAW;SAC1B,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,IAAY,EAAE,SAAiB;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC;;;;;OAKR,CAAC;aACD,GAAG,CAAC,IAAI,EAAE,SAAS,CAOlB,CAAC;QACL,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtB,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,MAAM,EAAE,CAAC,CAAC,OAAO;YACjB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS,EAAE,CAAC,CAAC,WAAW;SACzB,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;OAGG;IACH,YAAY,CACV,OAAgC,EAChC,aAA4B,EAC5B,aAAqB;QAErB,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtG,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACpD,uFAAuF;QACvF,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACnF,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;;OAQG;IACK,YAAY,CAClB,OAAgC,EAChC,MAAc,EACd,aAAqB,EACrB,aAAqB;QAErB,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,sDAAsD,CAAC,CAAC;QAC1F,MAAM,aAAa,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;KAKrC,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;KAGnC,CAAC,CAAC;QAEH,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YAClC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YAC/C,aAAa,CAAC,GAAG,CACf,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,GAAG,EACX,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,OAAO,IAAI,IAAI,EACvB,OAAO,CAAC,KAAK,IAAI,IAAI,EACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EACrB,MAAM,EACN,aAAa,EACb,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EACxB,aAAa,CACd,CAAC;YACF,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE;gBACjC,WAAW,CAAC,GAAG,CACb,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,SAAS,EACjB,GAAG,EACH,SAAS,CAAC,EAAE,CAAC,EACb,EAAE,CAAC,IAAI,EACP,EAAE,CAAC,EAAE,EACL,YAAY,CAAC,EAAE,CAAC,EAChB,YAAY,CAAC,EAAE,CAAC,CACjB,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,EAAE,EAAE,CAAC;IACP,CAAC;IAED;;;;;;;;;OASG;IACH,qBAAqB;QACnB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAClF,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAC9C,0EAA0E;YAC1E,wEAAwE;YACxE,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC1B,IAAI,EAAE,CAAC,IAAI,GAAG,oBAAoB;oBAAE,SAAS;gBAC7C,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,wEAAwE;YAC1E,CAAC;YACD,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACnD,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC7B,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC1E,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;YACvD,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;IAClD,CAAC;IAED,kFAAkF;IAC1E,mBAAmB;QACzB,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;YACjC,IAAI,OAAO,CAAC;YACZ,IAAI,CAAC;gBACH,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;YACT,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC5B,IAAI,CAAC,CAAC,WAAW,EAAE;oBAAE,IAAI,CAAC,CAAC,CAAC,CAAC;qBACxB,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChE,CAAC;QACH,CAAC,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,uFAAuF;IACvF,YAAY,CAAC,IAAY,EAAE,SAAiB,EAAE,KAAa;QACzD,IAAI,CAAC,EAAE;aACJ,OAAO,CAAC,gFAAgF,CAAC;aACzF,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACK,OAAO;QACb,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC,sCAAsC,CAAC;aAC/C,GAAG,EAAqC,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;IAEO,YAAY,CAAC,IAAY,EAAE,SAAiB,EAAE,UAAkB;QACtE,qFAAqF;QACrF,uFAAuF;QACvF,oEAAoE;QACpE,IAAI,IAAI,CAAC;QACT,IAAI,CAAC;YACH,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAAE,OAAO,EAAE,CAAC;QAC9B,4EAA4E;QAC5E,6EAA6E;QAC7E,kFAAkF;QAClF,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC9B,eAAe,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACxC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACrD,eAAe,CAAC,OAAO,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,SAAS,GAAG,GAAG,EAAE,CAAC,CAAC;QACnD,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACrC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACjC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,+CAA+C;QACzE,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,eAAe,CAAC,OAAgC;QACtD,2EAA2E;QAC3E,6EAA6E;QAC7E,kDAAkD;QAClD,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACpE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC9D,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,eAAe,CAAC,SAAS,CAAC,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,OAAO,CAAC,SAAS,QAAQ,CAAC,CAAC;QAC7D,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAE5C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;YAChC,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QAClE,aAAa,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACxG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,8DAA8D;QACxF,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,+EAA+E;AAC/E,+EAA+E;AAC/E,yEAAyE;AACzE,SAAS,eAAe,CAAC,IAAY;IACnC,IAAI,CAAC;QACH,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;IACzC,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;IACzC,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,eAAe,CAAC,KAAa,EAAE,KAAa;IACnD,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,cAAc,CAAC,CAAC;IAC5D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,6BAA6B,KAAK,EAAE,CAAC,CAAC;IAC3F,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,sCAAsC,KAAK,EAAE,CAAC,CAAC;IACzE,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,2BAA2B,KAAK,EAAE,CAAC,CAAC;IAC9D,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,mDAAmD,KAAK,EAAE,CAAC,CAAC;IACtF,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,6BAA6B,KAAK,EAAE,CAAC,CAAC;IACrF,4CAA4C;IAC5C,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,gDAAgD,KAAK,EAAE,CAAC,CAAC;AACrF,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,GAAW,EAAE,OAAe;IACnD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,oDAAoD,GAAG,EAAE,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,8EAA8E;AAE9E,SAAS,SAAS,CAAC,EAAyB;IAC1C,OAAO,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC;AAC/C,CAAC;AAED,SAAS,YAAY,CAAC,EAAyB;IAC7C,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,cAAc,CAAC;QACpB,KAAK,mBAAmB;YACtB,OAAO,EAAE,CAAC,IAAI,CAAC;QACjB,KAAK,aAAa;YAChB,OAAO,EAAE,CAAC,OAAO,CAAC;QACpB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,EAAyB;IAC7C,IAAI,EAAE,CAAC,IAAI,KAAK,WAAW,IAAI,EAAE,CAAC,IAAI,KAAK,aAAa;QAAE,OAAO,EAAE,CAAC,SAAS,CAAC;IAC9E,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,SAAS,qBAAqB,CAAC,IAAY;IACzC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,MASH,CAAC;IACF,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAE,CAAkB,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IACE,MAAM,CAAC,IAAI,KAAK,gBAAgB;QAChC,CAAC,MAAM,CAAC,IAAI;QACZ,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QACpC,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,EACpC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAE,CAA0B,CAAC,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;QACvE,CAAC;IACH,CAAC;IACD,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,SAAS;QACpC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS;QAChC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,SAAS;QAC1C,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/sessionArchive/types.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Hard cap on a single transcript's on-disk size. Files larger than this are
+ * skipped at ingest (a `skip` progress event with reason `"oversize"` is
+ * emitted) and not read into memory, bounding the worst-case heap a single
+ * descriptor can demand. 50 MiB is far above any real session and well below a
+ * memory-pressure threshold.
+ */
+export declare const MAX_TRANSCRIPT_BYTES: number;
+export type HostId = "claude-code" | "codex" | "gemini" | "claude-desktop" | string;
+export interface VortexTranscriptSession {
+    readonly host: HostId;
+    readonly sessionId: string;
+    readonly cwd: string;
+    readonly startedAt: string;
+    readonly endedAt?: string;
+    readonly model?: string;
+    readonly cliVersion?: string;
+    readonly events: readonly VortexTranscriptEvent[];
+}
+export type VortexTranscriptEvent = UserMessageEvent | AssistantMessageEvent | ToolCallEvent | ToolResultEvent | AttachmentEvent | UsageEvent | MetaEvent;
+export interface UserMessageEvent {
+    readonly kind: "user_message";
+    readonly turnId: string;
+    readonly at: string;
+    readonly text: string;
+    readonly hostRaw?: unknown;
+}
+export interface AssistantMessageEvent {
+    readonly kind: "assistant_message";
+    readonly turnId: string;
+    readonly at: string;
+    readonly text: string;
+    readonly thinking?: string;
+    readonly hostRaw?: unknown;
+}
+export interface ToolCallEvent {
+    readonly kind: "tool_call";
+    readonly turnId: string;
+    readonly at: string;
+    readonly name: string;
+    readonly input: unknown;
+    readonly toolUseId: string;
+    readonly hostRaw?: unknown;
+}
+export interface ToolResultEvent {
+    readonly kind: "tool_result";
+    readonly turnId: string;
+    readonly at: string;
+    readonly toolUseId: string;
+    readonly content: string;
+    readonly isError?: boolean;
+    readonly hostRaw?: unknown;
+}
+export interface AttachmentEvent {
+    readonly kind: "attachment";
+    readonly turnId: string;
+    readonly at: string;
+    readonly path?: string;
+    readonly mime?: string;
+    readonly hostRaw?: unknown;
+}
+export interface UsageEvent {
+    readonly kind: "usage";
+    readonly turnId: string;
+    readonly at: string;
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+    readonly cachedTokens?: number;
+    readonly hostRaw?: unknown;
+}
+export interface MetaEvent {
+    readonly kind: "meta";
+    readonly at: string;
+    readonly payload: unknown;
+}
+export interface SessionDescriptor {
+    readonly host: HostId;
+    readonly sessionId: string;
+    readonly cwd: string;
+    readonly path: string;
+    readonly mtimeMs: number;
+    readonly bytes: number;
+}
+export interface AdapterEnv {
+    readonly home: string;
+    readonly platform: NodeJS.Platform;
+    readonly now: () => Date;
+}
+export interface ListQuery {
+    readonly cwd?: string;
+    readonly cwdAnywhere?: boolean;
+    readonly since?: string;
+}
+/**
+ * Host-specific transcript adapter. Each first-party host (Claude Code / Codex / Gemini /
+ * Claude Desktop) implements this once; external hosts (Cursor, Zed, etc.) can implement
+ * it externally and be passed into ingest() at the consumer side.
+ *
+ * Adapters are stateless: open files, read, close. The orchestrator tracks ingestion progress.
+ */
+export interface TranscriptAdapter {
+    readonly host: HostId;
+    /** Cheap probe — does this host appear to be installed on this machine? */
+    detect(env: AdapterEnv): Promise<boolean>;
+    /** All sessions found on disk, optionally filtered by cwd / since. */
+    list(query: ListQuery, env: AdapterEnv): Promise<readonly SessionDescriptor[]>;
+    /** Read a single session and yield normalized events. */
+    read(descriptor: SessionDescriptor, env: AdapterEnv): Promise<VortexTranscriptSession>;
+}
+export interface AdapterOptions {
+    /** Optional redaction hook — runs after normalization, before storage. First-party adapters leave this undefined. */
+    readonly redact?: (event: VortexTranscriptEvent) => VortexTranscriptEvent;
+}
+/**
+ * Typed error surfaced when the Claude Desktop adapter cannot open the LevelDB
+ * because Claude Desktop is running and holds the lock. The orchestrator catches
+ * this specifically and surfaces a user-facing "quit Desktop and retry" message
+ * instead of a stack trace.
+ */
+export declare class ClaudeDesktopRunningError extends Error {
+    readonly host: HostId;
+    constructor(message?: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sessionArchive/types.d.ts.map

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

package/dist/sessionArchive/types.js

@@ -0,0 +1,24 @@
+// Types shared across the sessionArchive namespace.
+// Schema is captured in docs/transcript-adapter-design.md — keep this file aligned with that document.
+/**
+ * Hard cap on a single transcript's on-disk size. Files larger than this are
+ * skipped at ingest (a `skip` progress event with reason `"oversize"` is
+ * emitted) and not read into memory, bounding the worst-case heap a single
+ * descriptor can demand. 50 MiB is far above any real session and well below a
+ * memory-pressure threshold.
+ */
+export const MAX_TRANSCRIPT_BYTES = 50 * 1024 * 1024;
+/**
+ * Typed error surfaced when the Claude Desktop adapter cannot open the LevelDB
+ * because Claude Desktop is running and holds the lock. The orchestrator catches
+ * this specifically and surfaces a user-facing "quit Desktop and retry" message
+ * instead of a stack trace.
+ */
+export class ClaudeDesktopRunningError extends Error {
+    host = "claude-desktop";
+    constructor(message = "Claude Desktop is currently running and holds the LevelDB lock. Quit it (system tray → Quit) and retry.") {
+        super(message);
+        this.name = "ClaudeDesktopRunningError";
+    }
+}
+//# sourceMappingURL=types.js.map