@creeperhost/modlens-mcp 1.6.0

package/dist/tools/gradle.js

@@ -0,0 +1,182 @@
+/**
+ * Gradle build file search tools.
+ *
+ * Scans decompiled/source mod directories for build.gradle / build.gradle.kts files
+ * and lets you query them — find dependencies, plugins, repositories, and custom
+ * blocks across multiple mods' build scripts.
+ */
+import { readFile, readdir } from "fs/promises";
+import { join } from "path";
+import { findModById, findModByModId, listMods } from "../repositories/mod.js";
+// ── Helpers ───────────────────────────────────────────────────────────────────
+async function findGradleFiles(rootDir) {
+    const results = [];
+    const walk = async (dir, depth = 0) => {
+        if (depth > 4)
+            return; // don't recurse too deep
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const full = join(dir, e.name);
+            if (e.isDirectory() && !["node_modules", ".git", "build", "out"].includes(e.name)) {
+                await walk(full, depth + 1);
+            }
+            else if (e.isFile() && (e.name === "build.gradle" || e.name === "build.gradle.kts" || e.name === "settings.gradle" || e.name === "settings.gradle.kts")) {
+                results.push(full);
+            }
+        }
+    };
+    await walk(rootDir);
+    return results;
+}
+function extractDepsFromGradle(content) {
+    const deps = [];
+    // Match: implementation("group:artifact:version") or implementation 'g:a:v'
+    const re = /(\w+)\s*[\(]?\s*["']([^"'\n]+:[^"'\n]+:[^"'\n]+)["']\s*[\)]?/g;
+    for (const m of content.matchAll(re)) {
+        const config = m[1];
+        // Filter to known gradle configs only
+        if (["implementation", "api", "compileOnly", "runtimeOnly", "testImplementation", "modImplementation", "jarJar", "include", "forgeRuntime"].includes(config)) {
+            deps.push({ config, notation: m[2] });
+        }
+    }
+    return deps;
+}
+function extractPluginsFromGradle(content) {
+    const plugins = [];
+    // plugins { id("foo.bar") version "x" } or id 'foo.bar'
+    const re = /id\s*[\(]?\s*["']([^"']+)["']/g;
+    for (const m of content.matchAll(re))
+        plugins.push(m[1]);
+    return [...new Set(plugins)];
+}
+function extractRepositoriesFromGradle(content) {
+    const repos = [];
+    // maven { url = "..." } or url("...")
+    const re = /url\s*[=(]?\s*["']?(https?:\/\/[^"'\s\)]+)["']?/g;
+    for (const m of content.matchAll(re))
+        repos.push(m[1]);
+    return [...new Set(repos)];
+}
+// ── Public tools ──────────────────────────────────────────────────────────────
+/**
+ * Get gradle build file contents for a specific mod.
+ * Searches the mod's sourcePath and decompPath directories.
+ */
+export async function getModGradleFiles(modIdOrDbId) {
+    const mod = typeof modIdOrDbId === "number" || !isNaN(Number(modIdOrDbId))
+        ? await findModById(Number(modIdOrDbId))
+        : await findModByModId(String(modIdOrDbId));
+    if (!mod)
+        return { error: `Mod not found: ${modIdOrDbId}` };
+    const searchDirs = [mod.sourcePath, mod.decompPath].filter(Boolean);
+    if (searchDirs.length === 0)
+        return { error: `No source or decompiled path for ${mod.modId}. Run download_source or decompile_mod first.` };
+    const files = [];
+    for (const dir of searchDirs) {
+        const gradleFiles = await findGradleFiles(dir);
+        for (const gf of gradleFiles) {
+            try {
+                const content = await readFile(gf, "utf8");
+                files.push({
+                    path: gf.replace(dir, "").replace(/\\/g, "/"),
+                    content,
+                    dependencies: extractDepsFromGradle(content),
+                    plugins: extractPluginsFromGradle(content),
+                    repositories: extractRepositoriesFromGradle(content),
+                });
+            }
+            catch { /* skip unreadable */ }
+        }
+    }
+    return { mod: mod.modId, version: mod.version, fileCount: files.length, files };
+}
+/**
+ * Search gradle files across all ingested mods for a pattern.
+ * Returns matching lines with context.
+ */
+export async function searchGradleFiles(query, modIdFilter, limit = 20) {
+    const mods = await listMods({ modIdFilter });
+    const results = [];
+    const lowerQuery = query.toLowerCase();
+    for (const mod of mods) {
+        if (results.length >= limit)
+            break;
+        const dirs = [mod.sourcePath, mod.decompPath].filter(Boolean);
+        for (const dir of dirs) {
+            const gradleFiles = await findGradleFiles(dir);
+            for (const gf of gradleFiles) {
+                if (results.length >= limit)
+                    break;
+                try {
+                    const content = await readFile(gf, "utf8");
+                    const lines = content.split("\n");
+                    for (let i = 0; i < lines.length; i++) {
+                        if (lines[i].toLowerCase().includes(lowerQuery)) {
+                            results.push({
+                                mod: mod.modId,
+                                file: gf.replace(dir, "").replace(/\\/g, "/"),
+                                lineNumber: i + 1,
+                                line: lines[i].trim(),
+                                context: lines.slice(Math.max(0, i - 2), i + 3).map((l) => l.trimEnd()),
+                            });
+                            if (results.length >= limit)
+                                break;
+                        }
+                    }
+                }
+                catch { /* skip */ }
+            }
+        }
+    }
+    return { query, resultCount: results.length, results };
+}
+/**
+ * Compare gradle dependencies across all mods — find who uses the same library,
+ * who uses different versions, who has jarJar/embed vs. compileOnly, etc.
+ */
+export async function compareGradleDeps(groupFilter, modIdFilter) {
+    const mods = await listMods({ modIdFilter });
+    // notation → [{ mod, config, version }]
+    const depMap = {};
+    for (const mod of mods) {
+        const dirs = [mod.sourcePath, mod.decompPath].filter(Boolean);
+        for (const dir of dirs) {
+            const gradleFiles = await findGradleFiles(dir);
+            for (const gf of gradleFiles) {
+                try {
+                    const content = await readFile(gf, "utf8");
+                    const deps = extractDepsFromGradle(content);
+                    for (const dep of deps) {
+                        const parts = dep.notation.split(":");
+                        const key = parts.slice(0, 2).join(":"); // group:artifact
+                        if (groupFilter && !key.toLowerCase().includes(groupFilter.toLowerCase()))
+                            continue;
+                        (depMap[key] ??= []).push({
+                            mod: mod.modId,
+                            config: dep.config,
+                            version: parts[2] ?? "?",
+                        });
+                    }
+                }
+                catch { /* skip */ }
+            }
+        }
+    }
+    // Sort: most-used first
+    const sorted = Object.entries(depMap)
+        .sort((a, b) => b[1].length - a[1].length)
+        .map(([dep, users]) => ({
+        dependency: dep,
+        usedBy: users.length,
+        versionConflict: new Set(users.map((u) => u.version)).size > 1,
+        users,
+    }));
+    return { groupFilter, totalDependencies: sorted.length, dependencies: sorted };
+}
+//# sourceMappingURL=gradle.js.map

package/dist/tools/gradle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradle.js","sourceRoot":"","sources":["../../src/tools/gradle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAE/E,iFAAiF;AAEjF,KAAK,UAAU,eAAe,CAAC,OAAe;IAC1C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,KAAK,EAAE,GAAW,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE;QAC1C,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,CAAC,yBAAyB;QAChD,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YAAC,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO;QAAC,CAAC;QAChF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChF,MAAM,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAChC,CAAC;iBAAM,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,IAAI,CAAC,CAAC,IAAI,KAAK,kBAAkB,IAAI,CAAC,CAAC,IAAI,KAAK,iBAAiB,IAAI,CAAC,CAAC,IAAI,KAAK,qBAAqB,CAAC,EAAE,CAAC;gBACxJ,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;QACL,CAAC;IACL,CAAC,CAAC;IACF,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAe;IAC1C,MAAM,IAAI,GAAgD,EAAE,CAAC;IAC7D,4EAA4E;IAC5E,MAAM,EAAE,GAAG,+DAA+D,CAAC;IAC3E,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpB,sCAAsC;QACtC,IAAI,CAAC,gBAAgB,EAAC,KAAK,EAAC,aAAa,EAAC,aAAa,EAAC,oBAAoB,EAAC,mBAAmB,EAAC,QAAQ,EAAC,SAAS,EAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACnJ,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,SAAS,wBAAwB,CAAC,OAAe;IAC7C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,wDAAwD;IACxD,MAAM,EAAE,GAAG,gCAAgC,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,6BAA6B,CAAC,OAAe;IAClD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,sCAAsC;IACtC,MAAM,EAAE,GAAG,kDAAkD,CAAC;IAC9D,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,WAA4B;IAChE,MAAM,GAAG,GAAG,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACtE,CAAC,CAAC,MAAM,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACxC,CAAC,CAAC,MAAM,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,KAAK,EAAE,kBAAkB,WAAW,EAAE,EAAE,CAAC;IAE5D,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,OAAO,CAAa,CAAC;IAChF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,oCAAoC,GAAG,CAAC,KAAK,+CAA+C,EAAE,CAAC;IAE5I,MAAM,KAAK,GAAgJ,EAAE,CAAC;IAE9J,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;QAC/C,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBAC3C,KAAK,CAAC,IAAI,CAAC;oBACP,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;oBAC7C,OAAO;oBACP,YAAY,EAAE,qBAAqB,CAAC,OAAO,CAAC;oBAC5C,OAAO,EAAE,wBAAwB,CAAC,OAAO,CAAC;oBAC1C,YAAY,EAAE,6BAA6B,CAAC,OAAO,CAAC;iBACvD,CAAC,CAAC;YACP,CAAC;YAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC;QACrC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;AACpF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACnC,KAAa,EACb,WAAoB,EACpB,KAAK,GAAG,EAAE;IAEV,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IAE7C,MAAM,OAAO,GAA8F,EAAE,CAAC;IAC9G,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAEvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK;YAAE,MAAM;QACnC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,OAAO,CAAa,CAAC;QAC1E,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;YAC/C,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;gBAC3B,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK;oBAAE,MAAM;gBACnC,IAAI,CAAC;oBACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;oBAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;wBACpC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;4BAC9C,OAAO,CAAC,IAAI,CAAC;gCACT,GAAG,EAAS,GAAG,CAAC,KAAK;gCACrB,IAAI,EAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;gCACnD,UAAU,EAAE,CAAC,GAAG,CAAC;gCACjB,IAAI,EAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;gCAC3B,OAAO,EAAK,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;6BAC7E,CAAC,CAAC;4BACH,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK;gCAAE,MAAM;wBACvC,CAAC;oBACL,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;YAC1B,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACnC,WAAoB,EACpB,WAAoB;IAEpB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IAE7C,wCAAwC;IACxC,MAAM,MAAM,GAA4E,EAAE,CAAC;IAE3F,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,OAAO,CAAa,CAAC;QAC1E,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;YAC/C,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;gBAC3B,IAAI,CAAC;oBACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;oBAC3C,MAAM,IAAI,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;oBAC5C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;wBACrB,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;wBACtC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,iBAAiB;wBAC1D,IAAI,WAAW,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;4BAAE,SAAS;wBACpF,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC;4BACtB,GAAG,EAAE,GAAG,CAAC,KAAK;4BACd,MAAM,EAAE,GAAG,CAAC,MAAM;4BAClB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG;yBAC3B,CAAC,CAAC;oBACP,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;YAC1B,CAAC;QACL,CAAC;IACL,CAAC;IAED,wBAAwB;IACxB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SAChC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;SACzC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACpB,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,eAAe,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QAC9D,KAAK;KACR,CAAC,CAAC,CAAC;IAER,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;AACnF,CAAC"}

package/dist/tools/graphify.d.ts

@@ -0,0 +1,144 @@
+export interface DetectedBackend {
+    backend: string;
+    model: string;
+    pricing: {
+        input: number;
+        output: number;
+    };
+}
+/** Returns true if at least one of the required API key env vars is set for this backend. */
+export declare function hasBackendKey(backend: string): boolean;
+/**
+ * Detect the best available Ollama generation model.
+ * Returns null if no suitable model found or Ollama unreachable.
+ * Results are cached for 5 minutes.
+ */
+export declare function detectOllamaModel(): Promise<{
+    model: string;
+    contextLength: number;
+    params: string;
+} | null>;
+/**
+ * Detect the best available backend for graphify semantic extraction.
+ * Checks explicit config, cloud API keys, then Ollama.
+ */
+export declare function detectBackend(): Promise<DetectedBackend | null>;
+/**
+ * Check if `graphify` CLI is available. Returns the command name or throws.
+ * Caches result for the process lifetime.
+ */
+export declare function ensureGraphify(): Promise<string>;
+/**
+ * Build a knowledge graph for a mod. Prefers downloaded source (has docs/comments)
+ * over decompiled source (bare Java). Spawns graphify in background.
+ * When a semantic backend is available, uses `extract` for richer graphs.
+ */
+export declare function buildModGraph(dbId: number, force?: boolean, backendOverride?: string): Promise<{
+    status: string;
+    graphDir: string;
+    sourceType: string;
+    message: string;
+    backend?: string;
+    estimatedCost?: string;
+    hint?: string;
+}>;
+export declare function graphBuildStatus(dbId: number): Promise<{
+    status: string;
+    graphDir: string;
+    message: string;
+}>;
+/**
+ * Query a mod's knowledge graph. Returns a compact subgraph (~500 tokens)
+ * instead of raw source files (~10-50K tokens).
+ */
+export declare function queryModGraph(dbId: number, query: string, budget?: number): Promise<{
+    answer: string;
+    graphUsed: boolean;
+    hint: string;
+}>;
+/**
+ * Return the GRAPH_REPORT.md for a mod — contains god nodes, surprising
+ * connections, and suggested questions. Much cheaper than reading source.
+ */
+export declare function getGraphReport(dbId: number): Promise<string>;
+/**
+ * Return the next un-enriched chunk of source files for the chat agent to process.
+ */
+export declare function enrichNextChunk(dbId: number): Promise<{
+    chunkIndex: number;
+    totalChunks: number;
+    prompt: string;
+    schema: string;
+    done: boolean;
+}>;
+/**
+ * Merge the chat agent's semantic response back into graph.json.
+ */
+export declare function submitEnrichment(dbId: number, chunkIndex: number, nodes: Array<{
+    id: string;
+    [k: string]: unknown;
+}>, edges: Array<{
+    source: string;
+    target: string;
+    relation: string;
+    [k: string]: unknown;
+}>): Promise<{
+    merged: {
+        newNodes: number;
+        newEdges: number;
+    };
+    nextChunk: number;
+    totalChunks: number;
+}>;
+type GraphTargetType = "mod" | "vanilla" | "modloader";
+type DownloadGraphRequest = {
+    targetType?: GraphTargetType;
+    dbId?: number;
+    targetId?: string;
+    targetVersion?: string;
+    loader?: string;
+    mcVersion?: string;
+};
+/**
+ * Download a pre-built graph from the public registry.
+ */
+export declare function downloadGraph(reqOrDbId: number | DownloadGraphRequest): Promise<{
+    status: string;
+    source?: string;
+    nodeCount?: number;
+    edgeCount?: number;
+    enriched?: boolean;
+    backend?: string;
+    model?: string;
+    targetType?: "mod" | "vanilla" | "modloader";
+}>;
+/**
+ * Export a mod's local graph as a shareable gzipped JSON bundle with metadata.
+ */
+export declare function exportGraph(dbId: number, outputDir: string): Promise<{
+    path: string;
+    nodeCount: number;
+    edgeCount: number;
+    enriched: boolean;
+    sha256: string;
+    sizeBytes: number;
+}>;
+/** Payload shape for future community graph submissions. */
+export interface GraphSubmission {
+    /** The exported graph bundle file path */
+    bundlePath: string;
+    /** Optional contributor alias */
+    contributor?: string;
+    /** Free-text note about the graph */
+    note?: string;
+}
+/**
+ * Submit a locally-built graph for inclusion in the public registry.
+ * NOT YET IMPLEMENTED — returns a stub response with groundwork details.
+ */
+export declare function submitGraph(_submission: GraphSubmission): Promise<{
+    status: string;
+    message: string;
+}>;
+export {};
+//# sourceMappingURL=graphify.d.ts.map

package/dist/tools/graphify.d.ts.map

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