@creeperhost/modlens-mcp 1.6.0

package/dist/repositories/packs.js

@@ -0,0 +1,138 @@
+/**
+ * Repository layer for PackVersion and PackFile tables.
+ * Tracks which files (mods, configs, scripts, etc.) are present in each
+ * modpack version that has been synced or inspected via sync_pack_mods.
+ */
+import { getDb } from "../db.js";
+/** Upsert a pack version record and return its DB id. */
+export async function upsertPackVersion(input) {
+    const db = await getDb();
+    const record = await db.packVersion.upsert({
+        where: {
+            namespace_packId_versionId: {
+                namespace: input.namespace,
+                packId: input.packId,
+                versionId: input.versionId,
+            },
+        },
+        create: {
+            namespace: input.namespace,
+            packId: input.packId,
+            versionId: input.versionId,
+            packName: input.packName,
+            versionName: input.versionName,
+            mcVersion: input.mcVersion ?? null,
+            modloader: input.modloader ?? null,
+        },
+        update: {
+            packName: input.packName,
+            versionName: input.versionName,
+            mcVersion: input.mcVersion ?? null,
+            modloader: input.modloader ?? null,
+            updatedAt: new Date(),
+        },
+    });
+    return record.id;
+}
+/** Upsert a single pack file record. Keyed on (packVersionId, manifestFileId). */
+export async function upsertPackFile(input) {
+    const db = await getDb();
+    const data = {
+        packVersionId: input.packVersionId,
+        manifestFileId: input.manifestFileId ?? null,
+        fileType: input.fileType,
+        fileName: input.fileName,
+        filePath: input.filePath ?? null,
+        cfProject: input.cfProject ?? null,
+        cfFile: input.cfFile ?? null,
+        sha1: input.sha1 ?? null,
+        status: input.status,
+        modId: input.modId ?? null,
+    };
+    if (input.manifestFileId != null) {
+        await db.packFile.upsert({
+            where: {
+                packVersionId_manifestFileId: {
+                    packVersionId: input.packVersionId,
+                    manifestFileId: input.manifestFileId,
+                },
+            },
+            create: data,
+            update: {
+                fileType: data.fileType,
+                fileName: data.fileName,
+                filePath: data.filePath,
+                cfProject: data.cfProject,
+                cfFile: data.cfFile,
+                sha1: data.sha1,
+                status: data.status,
+                modId: data.modId,
+            },
+        });
+    }
+    else {
+        await db.packFile.create({ data }).catch(() => { });
+    }
+}
+// ── Queries ───────────────────────────────────────────────────────────────────
+/** List all known pack versions, optionally filtered by namespace and/or packId. */
+export async function listPackVersions(namespace, packId) {
+    const db = await getDb();
+    return db.packVersion.findMany({
+        where: {
+            ...(namespace !== undefined ? { namespace } : {}),
+            ...(packId !== undefined ? { packId } : {}),
+        },
+        orderBy: { syncedAt: "desc" },
+    });
+}
+/** List all files recorded for a specific pack version DB id. */
+export async function listPackFiles(packVersionId) {
+    const db = await getDb();
+    return db.packFile.findMany({
+        where: { packVersionId },
+        orderBy: [{ fileType: "asc" }, { fileName: "asc" }],
+    });
+}
+/** Find every pack version that contains a specific Mod (by DB id). */
+export async function findPacksForMod(modId) {
+    const db = await getDb();
+    const files = await db.packFile.findMany({
+        where: { modId },
+        include: { packVersion: true },
+    });
+    return files.map((f) => ({
+        ...f.packVersion,
+        fileName: f.fileName,
+        fileType: f.fileType,
+        status: f.status,
+        cfProject: f.cfProject,
+        cfFile: f.cfFile,
+    }));
+}
+/** Find every pack version that contains a file with a given CurseForge project id. */
+export async function findPacksForCfProject(cfProject) {
+    const db = await getDb();
+    const files = await db.packFile.findMany({
+        where: { cfProject },
+        include: { packVersion: true },
+    });
+    return files.map((f) => ({
+        ...f.packVersion,
+        fileName: f.fileName,
+        fileType: f.fileType,
+        status: f.status,
+        cfProject: f.cfProject,
+        cfFile: f.cfFile,
+    }));
+}
+/** Resolve a PackVersion record by namespace + packId + versionId. */
+export async function findPackVersion(namespace, packId, versionId) {
+    const db = await getDb();
+    return db.packVersion.findUnique({
+        where: {
+            namespace_packId_versionId: { namespace, packId, versionId },
+        },
+    });
+}
+//# sourceMappingURL=packs.js.map

package/dist/repositories/packs.js.map

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

package/dist/search-adapter.d.ts

@@ -0,0 +1,34 @@
+export interface FtsSourceResult {
+    className: string;
+    snippet: string;
+}
+export interface FtsDocResult {
+    id: number;
+    class_name: string | null;
+    title: string;
+    summary: string | null;
+    url: string;
+    category: string;
+    namespace: string;
+    tags: string[];
+}
+export interface FtsPrimerResult {
+    id: number;
+    title: string;
+    summary: string | null;
+    from_version: string;
+    to_version: string;
+    modloader: string | null;
+    url: string;
+}
+export declare function ftsSearchSource(mcVersionId: number, query: string, limit: number): Promise<FtsSourceResult[]>;
+/**
+ * BM25-ranked FTS search over mod source files.
+ * SQLite: fts_mod_source FTS5 table (ORDER BY rank = BM25).
+ * PostgreSQL: to_tsvector GIN index + ts_rank.
+ * Mod source must be indexed first (mod index_fts or index_semantic action).
+ */
+export declare function ftsSearchModSource(modId: number, query: string, limit: number): Promise<FtsSourceResult[]>;
+export declare function ftsSearchDocs(query: string, limit?: number): Promise<FtsDocResult[]>;
+export declare function ftsSearchPrimers(query: string, modloader?: string, limit?: number): Promise<FtsPrimerResult[]>;
+//# sourceMappingURL=search-adapter.d.ts.map

package/dist/search-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-adapter.d.ts","sourceRoot":"","sources":["../src/search-adapter.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;CACf;AAID,wBAAsB,eAAe,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,EAAE,CAAC,CA2C5B;AAID;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACpC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,EAAE,CAAC,CA2C5B;AAID,wBAAsB,aAAa,CAC/B,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACX,OAAO,CAAC,YAAY,EAAE,CAAC,CA4CzB;AAID,wBAAsB,gBAAgB,CAClC,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,SAAK,GACX,OAAO,CAAC,eAAe,EAAE,CAAC,CA+D5B"}

package/dist/search-adapter.js

@@ -0,0 +1,195 @@
+// src/search-adapter.ts
+/**
+ * Backend-agnostic FTS adapter.
+ *
+ * Postgres/PGlite: uses native tsvector (mc_source_files) or
+ *   case-insensitive LIKE via Prisma's mode:"insensitive".
+ * SQLite: uses FTS5 MATCH (mc_source_files) or raw LIKE (docs/primers).
+ *   SQLite paths throw until P2 wires them.
+ */
+import { detectBackend } from "./db-backend.js";
+import { getDb } from "./db.js";
+/** Escape LIKE metacharacters so user input is matched literally. */
+function escapeLike(s) {
+    return s.replace(/[%_\\]/g, c => "\\" + c);
+}
+// ── mc_source_files FTS ───────────────────────────────────────────────────────
+export async function ftsSearchSource(mcVersionId, query, limit) {
+    const backend = detectBackend();
+    if (backend === "sqlite") {
+        const url = process.env.DATABASE_URL ?? "";
+        const path = url.replace(/^file:\/\//, "").replace(/^file:/, "");
+        const Database = (await import("better-sqlite3")).default;
+        const db = new Database(path, { readonly: true });
+        try {
+            const rows = db.prepare(`SELECT s.id, s.class_name, s.content FROM fts_mc_source f
+                 JOIN mc_source_files s ON s.id = f.rowid
+                 WHERE f.fts_mc_source MATCH ? AND s.mc_version_id = ?
+                 ORDER BY rank
+                 LIMIT ?`).all(query, mcVersionId, limit);
+            return rows.map(r => ({
+                className: r.class_name,
+                snippet: r.content.slice(0, 300),
+            }));
+        }
+        finally {
+            db.close();
+        }
+    }
+    // Postgres / PGlite — existing tsvector query
+    const db = await getDb();
+    const rows = await db.$queryRaw `
+        SELECT
+            class_name,
+            ts_headline('simple', content,
+                plainto_tsquery('simple', ${query}),
+                'MaxWords=25, MinWords=15, StartSel="", StopSel=""'
+            ) AS snippet
+        FROM mc_source_files
+        WHERE mc_version_id = ${mcVersionId}
+          AND to_tsvector('simple', content) @@ plainto_tsquery('simple', ${query})
+        ORDER BY ts_rank(to_tsvector('simple', content), plainto_tsquery('simple', ${query})) DESC
+        LIMIT ${limit}
+    `;
+    return rows.map(r => ({ className: r.class_name, snippet: r.snippet }));
+}
+// ── mod_source_files FTS (fabric / neoforge / forge / quilt) ─────────────────
+/**
+ * BM25-ranked FTS search over mod source files.
+ * SQLite: fts_mod_source FTS5 table (ORDER BY rank = BM25).
+ * PostgreSQL: to_tsvector GIN index + ts_rank.
+ * Mod source must be indexed first (mod index_fts or index_semantic action).
+ */
+export async function ftsSearchModSource(modId, query, limit) {
+    const backend = detectBackend();
+    if (backend === "sqlite") {
+        const url = process.env.DATABASE_URL ?? "";
+        const path = url.replace(/^file:\/\//, "").replace(/^file:/, "");
+        const Database = (await import("better-sqlite3")).default;
+        const db = new Database(path, { readonly: true });
+        try {
+            const rows = db.prepare(`SELECT s.id, s.class_name, s.content FROM fts_mod_source f
+                 JOIN mod_source_files s ON s.id = f.rowid
+                 WHERE f.fts_mod_source MATCH ? AND s.mod_id = ?
+                 ORDER BY rank
+                 LIMIT ?`).all(query, modId, limit);
+            return rows.map(r => ({
+                className: r.class_name,
+                snippet: r.content.slice(0, 300),
+            }));
+        }
+        finally {
+            db.close();
+        }
+    }
+    // PostgreSQL — GIN index on to_tsvector('simple', content)
+    const db = await getDb();
+    const rows = await db.$queryRaw `
+        SELECT
+            class_name,
+            ts_headline('simple', content,
+                plainto_tsquery('simple', ${query}),
+                'MaxWords=25, MinWords=15, StartSel="", StopSel=""'
+            ) AS snippet
+        FROM mod_source_files
+        WHERE mod_id = ${modId}
+          AND to_tsvector('simple', content) @@ plainto_tsquery('simple', ${query})
+        ORDER BY ts_rank(to_tsvector('simple', content), plainto_tsquery('simple', ${query})) DESC
+        LIMIT ${limit}
+    `;
+    return rows.map(r => ({ className: r.class_name, snippet: r.snippet }));
+}
+// ── doc_entries FTS ───────────────────────────────────────────────────────────
+export async function ftsSearchDocs(query, limit = 20) {
+    const backend = detectBackend();
+    if (backend === "sqlite") {
+        const url = process.env.DATABASE_URL ?? "";
+        const path = url.replace(/^file:\/\//, "").replace(/^file:/, "");
+        const Database = (await import("better-sqlite3")).default;
+        const db = new Database(path, { readonly: true });
+        try {
+            const rows = db.prepare(`SELECT d.id, d.class_name, d.title, d.summary, d.url, d.category, d.namespace, d.tags
+                 FROM fts_doc_entries f
+                 JOIN doc_entries d ON d.id = f.rowid
+                 WHERE f.fts_doc_entries MATCH ?
+                 ORDER BY rank
+                 LIMIT ?`).all(query, limit);
+            return rows.map(r => ({ ...r, tags: JSON.parse(r.tags ?? "[]") }));
+        }
+        finally {
+            db.close();
+        }
+    }
+    // Postgres / PGlite — raw LIKE (case-insensitive via lower())
+    const db = await getDb();
+    const kw = escapeLike(query.toLowerCase());
+    const rows = await db.$queryRaw `
+        SELECT id, class_name, title, summary, url, category, namespace, tags
+        FROM doc_entries
+        WHERE lower(title)      LIKE ${"%" + kw + "%"}
+           OR lower(summary)    LIKE ${"%" + kw + "%"}
+           OR lower(class_name) LIKE ${"%" + kw + "%"}
+        ORDER BY id
+        LIMIT ${limit}
+    `;
+    return rows;
+}
+// ── primers FTS ───────────────────────────────────────────────────────────────
+export async function ftsSearchPrimers(query, modloader, limit = 20) {
+    const backend = detectBackend();
+    if (backend === "sqlite") {
+        const url = process.env.DATABASE_URL ?? "";
+        const path = url.replace(/^file:\/\//, "").replace(/^file:/, "");
+        const Database = (await import("better-sqlite3")).default;
+        const db = new Database(path, { readonly: true });
+        try {
+            const rows = db.prepare(`SELECT p.id, p.title, p.summary, p.from_version, p.to_version, p.modloader, p.url
+                 FROM fts_primers f
+                 JOIN primers p ON p.id = f.rowid
+                 WHERE f.fts_primers MATCH ?
+                 ${modloader ? "AND p.modloader = ?" : ""}
+                 ORDER BY rank
+                 LIMIT ?`).all(...[query, ...(modloader ? [modloader] : []), limit]);
+            return rows.map(r => ({
+                id: r.id, title: r.title, summary: r.summary,
+                from_version: r.from_version, to_version: r.to_version,
+                modloader: r.modloader ?? null, url: r.url,
+            }));
+        }
+        finally {
+            db.close();
+        }
+    }
+    // Postgres / PGlite — Prisma case-insensitive contains
+    const db = await getDb();
+    const rows = await db.primer.findMany({
+        where: {
+            AND: [
+                {
+                    OR: [
+                        { title: { contains: query, mode: "insensitive" } },
+                        { summary: { contains: query, mode: "insensitive" } },
+                        { content: { contains: query, mode: "insensitive" } },
+                        { tags: { has: query } },
+                    ],
+                },
+                ...(modloader ? [{ modloader }] : []),
+            ],
+        },
+        select: {
+            id: true, title: true, summary: true,
+            fromVersion: true, toVersion: true, modloader: true, url: true,
+        },
+        take: limit,
+    });
+    return rows.map(r => ({
+        id: r.id,
+        title: r.title,
+        summary: r.summary,
+        from_version: r.fromVersion,
+        to_version: r.toVersion,
+        modloader: r.modloader ?? null,
+        url: r.url,
+    }));
+}
+//# sourceMappingURL=search-adapter.js.map

package/dist/search-adapter.js.map

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

package/dist/search.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Class name search — CamelCase acronym, prefix, and substring matching.
+ * Ported from the mcsrc web app search algorithm.
+ */
+export declare function searchClasses(classes: string[], query: string): string[];
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA+CxE"}

package/dist/search.js

@@ -0,0 +1,54 @@
+/**
+ * Class name search — CamelCase acronym, prefix, and substring matching.
+ * Ported from the mcsrc web app search algorithm.
+ */
+export function searchClasses(classes, query) {
+    const q = query.trim();
+    if (!q)
+        return [];
+    const simpleNames = classes.map((c) => {
+        const parts = c.split("/");
+        return parts[parts.length - 1];
+    });
+    const results = [];
+    const upperQ = q.toUpperCase();
+    const lowerQ = q.toLowerCase();
+    for (let i = 0; i < classes.length; i++) {
+        const simple = simpleNames[i];
+        const simpleUpper = simple.toUpperCase();
+        if (simple === q) {
+            results.push({ score: 0, name: classes[i] });
+            continue;
+        }
+        if (simple.startsWith(q)) {
+            results.push({ score: 1, name: classes[i] });
+            continue;
+        }
+        // CamelCase acronym match
+        if (camelMatch(simple, q)) {
+            results.push({ score: 2, name: classes[i] });
+            continue;
+        }
+        // Case-insensitive prefix
+        if (simpleUpper.startsWith(upperQ)) {
+            results.push({ score: 3, name: classes[i] });
+            continue;
+        }
+        // Substring
+        if (simple.toLowerCase().includes(lowerQ)) {
+            results.push({ score: 4 + simple.toLowerCase().indexOf(lowerQ), name: classes[i] });
+        }
+    }
+    return results
+        .sort((a, b) => a.score - b.score || a.name.localeCompare(b.name))
+        .slice(0, 100)
+        .map((r) => r.name);
+}
+function camelMatch(className, query) {
+    const uppers = className.match(/[A-Z]/g);
+    if (!uppers)
+        return false;
+    const acronym = uppers.join("");
+    return acronym.toUpperCase().includes(query.toUpperCase());
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/dist/search.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=search.test.d.ts.map

package/dist/search.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.test.d.ts","sourceRoot":"","sources":["../src/search.test.ts"],"names":[],"mappings":""}

package/dist/search.test.js

@@ -0,0 +1,71 @@
+import { describe, it, expect } from "vitest";
+import { searchClasses } from "./search.js";
+const CLASSES = [
+    "net/minecraft/world/entity/LivingEntity",
+    "net/minecraft/world/entity/player/Player",
+    "net/minecraft/world/level/block/Block",
+    "net/minecraft/world/level/block/entity/BlockEntity",
+    "net/minecraft/world/item/Item",
+    "net/minecraft/world/item/ItemStack",
+    "com/example/mod/EnergyStorage",
+    "com/example/mod/EnergyStorageBlockEntity",
+    "com/example/mod/ExampleMod",
+    "com/example/mod/integration/jei/JEIPlugin",
+];
+describe("searchClasses", () => {
+    it("returns empty array for empty query", () => {
+        expect(searchClasses(CLASSES, "")).toHaveLength(0);
+        expect(searchClasses(CLASSES, "   ")).toHaveLength(0);
+    });
+    it("exact simple name match ranks first", () => {
+        const results = searchClasses(CLASSES, "Block");
+        expect(results[0]).toBe("net/minecraft/world/level/block/Block");
+    });
+    it("prefix match ranks before substring match", () => {
+        const results = searchClasses(CLASSES, "Item");
+        // "Item" exact match before "ItemStack" prefix match
+        expect(results[0]).toBe("net/minecraft/world/item/Item");
+        expect(results[1]).toBe("net/minecraft/world/item/ItemStack");
+    });
+    it("CamelCase acronym match works", () => {
+        const results = searchClasses(CLASSES, "LE");
+        expect(results).toContain("net/minecraft/world/entity/LivingEntity");
+    });
+    it("CamelCase acronym is case-insensitive", () => {
+        const results = searchClasses(CLASSES, "le");
+        expect(results).toContain("net/minecraft/world/entity/LivingEntity");
+    });
+    it("case-insensitive prefix match works", () => {
+        const results = searchClasses(CLASSES, "block");
+        expect(results).toContain("net/minecraft/world/level/block/Block");
+        expect(results).toContain("net/minecraft/world/level/block/entity/BlockEntity");
+    });
+    it("substring match works", () => {
+        const results = searchClasses(CLASSES, "Storage");
+        expect(results).toContain("com/example/mod/EnergyStorage");
+        expect(results).toContain("com/example/mod/EnergyStorageBlockEntity");
+    });
+    it("substring match on full internal path works", () => {
+        const results = searchClasses(CLASSES, "jei");
+        expect(results).toContain("com/example/mod/integration/jei/JEIPlugin");
+    });
+    it("returns at most 100 results", () => {
+        const many = Array.from({ length: 200 }, (_, i) => `com/example/Foo${i}`);
+        const results = searchClasses(many, "Foo");
+        expect(results.length).toBeLessThanOrEqual(100);
+    });
+    it("returns empty array when nothing matches", () => {
+        expect(searchClasses(CLASSES, "Zzzzz")).toHaveLength(0);
+    });
+    it("results are sorted — lower score before higher score", () => {
+        // "ES" is a CamelCase match for EnergyStorage — should appear before a pure substring match
+        const results = searchClasses(CLASSES, "ES");
+        const esIdx = results.findIndex(r => r.includes("EnergyStorage"));
+        const exIdx = results.findIndex(r => r.includes("ExampleMod"));
+        // EnergyStorage "ES" acronym should rank before ExampleMod "EM" — which shouldn't match at all
+        expect(esIdx).toBeGreaterThanOrEqual(0);
+        if (exIdx !== -1)
+            expect(esIdx).toBeLessThan(exIdx);
+    });
+});
+//# sourceMappingURL=search.test.js.map

package/dist/search.test.js.map

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

package/dist/security.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Normalizes a path that may have been typed from a WSL shell or a Windows
+ * shell so both work transparently.
+ *
+ * On Windows:
+ *   /mnt/c/foo/bar.jar  →  C:/foo/bar.jar
+ *   /mnt/wsl/foo.jar    →  left as-is (no drive letter, unlikely to be valid Win path)
+ *   C:\foo\bar.jar      →  left as-is (already Windows)
+ *
+ * On Linux/macOS: returned unchanged (WSL paths are native there).
+ */
+export declare function normalizeJarPath(p: string): string;
+/**
+ * Validate that `untrusted` resolves to a path inside `base`.
+ * Throws if it would escape (path traversal attempt).
+ * Returns the resolved absolute path on success.
+ */
+export declare function validatePath(untrusted: string, base: string): string;
+/**
+ * Assert that `p` is an absolute path ending in `.jar`.
+ * Use on paths sourced from the DB or other semi-trusted boundaries
+ * to prevent filesystem access to arbitrary files.
+ */
+export declare function assertJarPath(p: string): void;
+/**
+ * Compile a user-supplied regex string safely.
+ * Throws if the pattern is too long or fails to compile.
+ */
+export declare function safeRegex(pattern: string, flags?: string): RegExp;
+/**
+ * Compute the SHA-512 hex digest of a file on disk.
+ */
+export declare function fileSha512(filePath: string): Promise<string>;
+/**
+ * Verify a file's SHA-512 against an expected value.
+ * Throws `HashMismatchError` if they differ.
+ */
+export declare class HashMismatchError extends Error {
+    constructor(filePath: string, expected: string, actual: string);
+}
+export declare function verifyFileHash(filePath: string, expectedSha512: string): Promise<void>;
+/**
+ * Decode Unicode Tag characters (U+E0000-E007F) back to their ASCII equivalents.
+ * This is the technique used by tools like HideTextTool to embed invisible text
+ * within visible strings.  Returns the hidden ASCII payload (empty if none).
+ */
+export declare function decodeTagChars(text: string): string;
+/**
+ * Strip all invisible / zero-width Unicode characters from a string.
+ * Covers: Unicode Tag block (U+E0000-E007F), zero-width chars (U+200B-200D,
+ * U+FEFF, U+2060), bidi overrides (U+200E-200F, U+202A-202E, U+2066-2069),
+ * interlinear annotations (U+FFF9-FFFB), and variation selectors (U+FE00-FE0F).
+ */
+export declare function stripInvisibleUnicode(text: string): string;
+/**
+ * Check whether a string contains any invisible Unicode characters
+ * (Tag block, zero-width, bidi overrides, etc.).
+ */
+export declare function containsInvisibleUnicode(text: string): boolean;
+interface ValidationResult {
+    valid: boolean;
+    reason?: string;
+    flaggedEntries?: string[];
+}
+/**
+ * Validate a graph.json bundle for security issues.
+ * Checks schema, string lengths, prompt injection, and size limits.
+ */
+export declare function validateGraphBundle(graph: unknown): ValidationResult;
+/**
+ * Validate nodes/edges submitted by the chat agent during enrichment.
+ * Same checks as validateGraphBundle but on individual arrays.
+ */
+export declare function validateGraphEntries(nodes: Array<{
+    id: string;
+    [k: string]: unknown;
+}>, edges: Array<{
+    source: string;
+    target: string;
+    relation: string;
+    [k: string]: unknown;
+}>): ValidationResult;
+/**
+ * Validate an embedding bundle for security issues.
+ */
+export declare function validateEmbeddingBundle(bundle: unknown): ValidationResult;
+/**
+ * Validate an embedding registry index (index.json) returned from a remote server.
+ * Ensures each bundle entry has the expected field types to prevent TypeErrors
+ * from malformed/malicious registry responses.
+ */
+export declare function validateEmbedRegistryIndex(data: unknown): ValidationResult;
+/**
+ * Validate a graph registry index (index.json) returned from a remote server.
+ */
+export declare function validateGraphRegistryIndex(data: unknown): ValidationResult;
+export {};
+//# sourceMappingURL=security.d.ts.map

package/dist/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CASlD;AAID;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAYpE;AAID;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAI7C;AAMD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,MAAM,CAS9D;AAID;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGlE;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC5B,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAIjE;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK5F;AAID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBnD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmC1D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAYD,UAAU,gBAAgB;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAoBD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAwFpE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAChC,KAAK,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC,EAClD,KAAK,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC,GACzF,gBAAgB,CAElB;AAkBD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAwEzE;AAID;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAuB1E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAsB1E"}