@modwrench/workbench 0.0.1

package/dist/metadata/clients.js

@@ -0,0 +1,90 @@
+import { createHttpClient, getEnv, log, loadCredential, } from "@modwrench/core";
+// Minimal HTTP clients for the platforms we already cover via dedicated MCP
+// packages. We re-implement at this layer rather than depending on
+// @modwrench/nexus / @modwrench/modio because that would invert the dep
+// direction (workbench is supposed to be the leaner package, and the platform
+// packages don't need to know about workbench).
+//
+// Both clients use the shared @modwrench/core HTTP client for retry/backoff
+// /429 handling /concurrency cap — keeps behavior consistent with what the
+// platform packages do. Credentials are loaded best-effort at register time
+// via loadCredential; if neither keychain nor env is configured for a given
+// platform, the client is null and the metadata tool surfaces a clear error.
+const USER_AGENT = "ModWrench/0.0.1 (+https://github.com/171county/modwrench)";
+export function tryCreateNexusClient() {
+    let credential;
+    try {
+        credential = loadCredential({
+            service: "nexus",
+            envVar: "NEXUS_API_KEY",
+            authHint: "no-op",
+        });
+    }
+    catch {
+        return null;
+    }
+    const baseUrl = getEnv("NEXUS_BASE_URL", "https://api.nexusmods.com/v1");
+    const http = createHttpClient({
+        baseUrl,
+        userAgent: USER_AGENT,
+        errorCodePrefix: "nexus",
+        authHeaders: () => {
+            if (credential.source === "keychain") {
+                return { Authorization: `Bearer ${credential.accessToken}` };
+            }
+            return { apikey: credential.apiKey };
+        },
+    });
+    return {
+        baseUrl,
+        async request(path) {
+            log("debug", "workbench.nexus.request", { path });
+            return http.request(path);
+        },
+    };
+}
+export function tryCreateModioClient() {
+    let credential;
+    try {
+        credential = loadCredential({
+            service: "modio",
+            envVar: "MODIO_API_KEY",
+            authHint: "no-op",
+        });
+    }
+    catch {
+        return null;
+    }
+    const baseUrl = getEnv("MODIO_BASE_URL", "https://api.mod.io/v1");
+    const http = createHttpClient({
+        baseUrl,
+        userAgent: USER_AGENT,
+        errorCodePrefix: "modio",
+        authHeaders: () => {
+            if (credential.source === "keychain") {
+                return { Authorization: `Bearer ${credential.accessToken}` };
+            }
+            return {};
+        },
+    });
+    return {
+        baseUrl,
+        async request(path, query) {
+            const finalQuery = {
+                ...(query ?? {}),
+            };
+            // mod.io's quirk: legacy API key goes on the query string, not as a
+            // header. OAuth tokens use the Authorization header (handled by
+            // authHeaders above).
+            if (credential.source === "env") {
+                finalQuery["api_key"] = credential.apiKey;
+            }
+            log("debug", "workbench.modio.request", {
+                path,
+                auth: credential.source === "env" ? "api_key (query)" : "Bearer (header)",
+            });
+            return http.request(path, { query: finalQuery });
+        },
+    };
+}
+//# sourceMappingURL=clients.js.map

package/dist/metadata/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../../src/metadata/clients.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,MAAM,EACN,GAAG,EACH,cAAc,GAGf,MAAM,iBAAiB,CAAC;AAEzB,4EAA4E;AAC5E,mEAAmE;AACnE,wEAAwE;AACxE,8EAA8E;AAC9E,gDAAgD;AAChD,EAAE;AACF,4EAA4E;AAC5E,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,6EAA6E;AAE7E,MAAM,UAAU,GAAG,2DAA2D,CAAC;AAS/E,MAAM,UAAU,oBAAoB;IAClC,IAAI,UAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,UAAU,GAAG,cAAc,CAAC;YAC1B,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,eAAe;YACvB,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,gBAAgB,EAAE,8BAA8B,CAAC,CAAC;IACzE,MAAM,IAAI,GAAe,gBAAgB,CAAC;QACxC,OAAO;QACP,SAAS,EAAE,UAAU;QACrB,eAAe,EAAE,OAAO;QACxB,WAAW,EAAE,GAA2B,EAAE;YACxC,IAAI,UAAU,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBACrC,OAAO,EAAE,aAAa,EAAE,UAAU,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;YAC/D,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;QACvC,CAAC;KACF,CAAC,CAAC;IACH,OAAO;QACL,OAAO;QACP,KAAK,CAAC,OAAO,CAAI,IAAY;YAC3B,GAAG,CAAC,OAAO,EAAE,yBAAyB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,OAAO,IAAI,CAAC,OAAO,CAAI,IAAI,CAAC,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC;AAYD,MAAM,UAAU,oBAAoB;IAClC,IAAI,UAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,UAAU,GAAG,cAAc,CAAC;YAC1B,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,eAAe;YACvB,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,gBAAgB,EAAE,uBAAuB,CAAC,CAAC;IAClE,MAAM,IAAI,GAAe,gBAAgB,CAAC;QACxC,OAAO;QACP,SAAS,EAAE,UAAU;QACrB,eAAe,EAAE,OAAO;QACxB,WAAW,EAAE,GAA2B,EAAE;YACxC,IAAI,UAAU,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBACrC,OAAO,EAAE,aAAa,EAAE,UAAU,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;YAC/D,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC,CAAC;IACH,OAAO;QACL,OAAO;QACP,KAAK,CAAC,OAAO,CACX,IAAY,EACZ,KAAmD;YAEnD,MAAM,UAAU,GAAuD;gBACrE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;aACjB,CAAC;YACF,oEAAoE;YACpE,gEAAgE;YAChE,sBAAsB;YACtB,IAAI,UAAU,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBAChC,UAAU,CAAC,SAAS,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;YAC5C,CAAC;YACD,GAAG,CAAC,OAAO,EAAE,yBAAyB,EAAE;gBACtC,IAAI;gBACJ,IAAI,EACF,UAAU,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB;aACtE,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,OAAO,CAAI,IAAI,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACtD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/metadata/index.d.ts

@@ -0,0 +1,3 @@
+import type { QueryModMetadataInput, QueryModMetadataResult } from "./types.js";
+export declare function queryModMetadata(input: QueryModMetadataInput): Promise<QueryModMetadataResult>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metadata/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAEV,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAuDpB,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CAEjC"}

package/dist/metadata/index.js

@@ -0,0 +1,149 @@
+import { tryCreateNexusClient, tryCreateModioClient, } from "./clients.js";
+import { normalizeNexusMod, normalizeModioMod, } from "./normalize.js";
+// ─── Per-platform query implementations ───────────────────────────────────────
+async function queryNexus(client, gameDomain, modIdStr) {
+    const modId = Number.parseInt(modIdStr, 10);
+    if (!Number.isFinite(modId) || modId <= 0) {
+        throw new Error(`Nexus mod IDs are numeric; got "${modIdStr}". Pass the mod's numeric Nexus ID.`);
+    }
+    return client.request(`/games/${gameDomain}/mods/${modId}.json`);
+}
+async function queryModioById(client, gameIdStr, modIdStr) {
+    const gameId = Number.parseInt(gameIdStr, 10);
+    const modId = Number.parseInt(modIdStr, 10);
+    if (!Number.isFinite(gameId) || !Number.isFinite(modId)) {
+        throw new Error(`mod.io IDs are numeric; got gameId="${gameIdStr}", modId="${modIdStr}".`);
+    }
+    return client.request(`/games/${gameId}/mods/${modId}`);
+}
+async function searchModioByName(client, gameIdStr, name) {
+    const gameId = Number.parseInt(gameIdStr, 10);
+    if (!Number.isFinite(gameId)) {
+        throw new Error(`mod.io gameId must be numeric; got "${gameIdStr}".`);
+    }
+    const list = await client.request(`/games/${gameId}/mods`, { _q: name, _limit: 1 });
+    return list.data?.[0] ?? null;
+}
+// ─── Orchestration ────────────────────────────────────────────────────────────
+export function queryModMetadata(input) {
+    return queryModMetadataInner(input);
+}
+async function queryModMetadataInner(input) {
+    const platform = input.platform ?? "any";
+    const platformErrors = {};
+    const attempted = [];
+    if (!input.modId && !input.modName) {
+        return {
+            found: false,
+            reason: "Provide either modId or modName.",
+            attemptedPlatforms: [],
+        };
+    }
+    const tryNexus = (platform === "nexus" || platform === "any") &&
+        input.modId !== undefined &&
+        input.gameId !== undefined;
+    const tryModioById = (platform === "modio" || platform === "any") &&
+        input.modId !== undefined &&
+        input.gameId !== undefined;
+    const tryModioByName = (platform === "modio" || platform === "any") &&
+        input.modName !== undefined &&
+        input.gameId !== undefined;
+    if (platform === "thunderstore" || platform === "curseforge") {
+        return {
+            found: false,
+            reason: `Platform "${platform}" support is not implemented yet (planned for v3+). Use platform="nexus" or "modio" for now.`,
+            attemptedPlatforms: [],
+        };
+    }
+    // Try Nexus first (it's the dominant home for Bethesda games, which is
+    // where the bulk of crash-diagnosis traffic will come from).
+    if (tryNexus) {
+        attempted.push("nexus");
+        const client = tryCreateNexusClient();
+        if (!client) {
+            platformErrors["nexus"] =
+                "No Nexus credential configured. Run `modwrench auth login nexus` " +
+                    "(OAuth) or set NEXUS_API_KEY in your .env.";
+        }
+        else {
+            try {
+                const raw = await queryNexus(client, input.gameId, input.modId);
+                return {
+                    found: true,
+                    mod: normalizeNexusMod(raw, input.gameId),
+                    attemptedPlatforms: attempted,
+                };
+            }
+            catch (err) {
+                platformErrors["nexus"] =
+                    err instanceof Error ? err.message : String(err);
+            }
+        }
+    }
+    if (tryModioById) {
+        attempted.push("modio");
+        const client = tryCreateModioClient();
+        if (!client) {
+            platformErrors["modio"] =
+                "No mod.io credential configured. Run `modwrench auth login modio` " +
+                    "(OAuth) or set MODIO_API_KEY in your .env.";
+        }
+        else {
+            try {
+                const raw = await queryModioById(client, input.gameId, input.modId);
+                return {
+                    found: true,
+                    mod: normalizeModioMod(raw),
+                    attemptedPlatforms: attempted,
+                };
+            }
+            catch (err) {
+                platformErrors["modio"] =
+                    err instanceof Error ? err.message : String(err);
+            }
+        }
+    }
+    if (tryModioByName) {
+        if (!attempted.includes("modio"))
+            attempted.push("modio");
+        const client = tryCreateModioClient();
+        if (!client) {
+            platformErrors["modio"] ??=
+                "No mod.io credential configured. Run `modwrench auth login modio`.";
+        }
+        else {
+            try {
+                const raw = await searchModioByName(client, input.gameId, input.modName);
+                if (raw) {
+                    return {
+                        found: true,
+                        mod: normalizeModioMod(raw),
+                        attemptedPlatforms: attempted,
+                    };
+                }
+                platformErrors["modio"] = `No mod.io match for name "${input.modName}".`;
+            }
+            catch (err) {
+                platformErrors["modio"] =
+                    err instanceof Error ? err.message : String(err);
+            }
+        }
+    }
+    // No platform attempted? That means the input was insufficient for the
+    // platforms we actually support — surface a helpful error.
+    if (attempted.length === 0) {
+        return {
+            found: false,
+            reason: "Insufficient input. Nexus requires (modId + gameId as Nexus domain). " +
+                "mod.io requires (modId + numeric gameId) or (modName + numeric gameId).",
+            attemptedPlatforms: [],
+        };
+    }
+    return {
+        found: false,
+        reason: `No matching mod found across ${attempted.join(", ")}.`,
+        attemptedPlatforms: attempted,
+        platformErrors,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/metadata/index.js.map

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

package/dist/metadata/normalize.d.ts

@@ -0,0 +1,43 @@
+import type { NormalizedMod } from "./types.js";
+type NexusModResponse = {
+    mod_id: number;
+    domain_name: string;
+    name: string;
+    summary?: string;
+    description?: string;
+    version?: string;
+    author: string;
+    uploaded_by?: string;
+    uploaded_users_profile_url?: string;
+    mod_downloads?: number;
+    endorsement_count?: number;
+    updated_timestamp?: number;
+    updated_time?: string;
+};
+export declare function normalizeNexusMod(mod: NexusModResponse, gameDomain: string): NormalizedMod;
+type ModioModResponse = {
+    id: number;
+    game_id: number;
+    name: string;
+    name_id: string;
+    summary?: string;
+    description?: string;
+    description_plaintext?: string;
+    profile_url?: string;
+    date_updated?: number;
+    submitted_by?: {
+        username?: string;
+        profile_url?: string;
+    };
+    modfile?: {
+        version?: string;
+    };
+    stats?: {
+        downloads_total?: number;
+        ratings_total?: number;
+        ratings_positive?: number;
+    };
+};
+export declare function normalizeModioMod(mod: ModioModResponse): NormalizedMod;
+export type { NexusModResponse, ModioModResponse };
+//# sourceMappingURL=normalize.d.ts.map

package/dist/metadata/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/metadata/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,YAAY,CAAC;AA0BhE,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,MAAM,GACjB,aAAa,CA0Bf;AAID,KAAK,gBAAgB,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,KAAK,CAAC,EAAE;QACN,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,GAAG,aAAa,CAiCtE;AAED,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/metadata/normalize.js

@@ -0,0 +1,88 @@
+// Best-effort response normalization. The wiring prompt's permissions matrix
+// (modificationAllowed / assetReuseAllowed / conversionAllowed) is NOT fully
+// exposed by either platform's public API — those flags are set per-mod on
+// the page itself. We honor the spec shape but mark fields null when unknown
+// and surface a note so the LLM doesn't fabricate certainty.
+const PERMISSIONS_NOTE = "Author permissions (modification, asset reuse, conversion) are set on the " +
+    "mod's page and may not be fully exposed via API. Always confirm via " +
+    "pageUrl before reusing assets or republishing.";
+function unknownPermissions() {
+    return {
+        modificationAllowed: null,
+        assetReuseAllowed: null,
+        conversionAllowed: null,
+        note: PERMISSIONS_NOTE,
+    };
+}
+export function normalizeNexusMod(mod, gameDomain) {
+    const idStr = String(mod.mod_id);
+    const pageUrl = `https://www.nexusmods.com/${gameDomain}/mods/${idStr}`;
+    const out = {
+        id: idStr,
+        name: mod.name,
+        platform: "nexus",
+        pageUrl,
+        attribution: {
+            author: mod.author,
+            sourcePlatform: "nexus",
+            sourceModId: idStr,
+            pageUrl,
+        },
+        permissions: unknownPermissions(),
+    };
+    if (mod.version)
+        out.version = mod.version;
+    if (mod.summary)
+        out.summary = mod.summary;
+    if (mod.description)
+        out.description = mod.description;
+    if (mod.mod_downloads !== undefined)
+        out.downloadCount = mod.mod_downloads;
+    if (mod.endorsement_count !== undefined)
+        out.endorsements = mod.endorsement_count;
+    if (mod.updated_time)
+        out.lastUpdated = mod.updated_time;
+    else if (mod.updated_timestamp) {
+        out.lastUpdated = new Date(mod.updated_timestamp * 1000).toISOString();
+    }
+    return out;
+}
+export function normalizeModioMod(mod) {
+    const idStr = String(mod.id);
+    const pageUrl = mod.profile_url ?? `https://mod.io/g/${mod.game_id}/m/${mod.name_id}`;
+    const author = mod.submitted_by?.username ?? "(unknown)";
+    const out = {
+        id: idStr,
+        name: mod.name,
+        platform: "modio",
+        pageUrl,
+        attribution: {
+            author,
+            sourcePlatform: "modio",
+            sourceModId: idStr,
+            pageUrl,
+        },
+        permissions: unknownPermissions(),
+    };
+    if (mod.modfile?.version)
+        out.version = mod.modfile.version;
+    if (mod.summary)
+        out.summary = mod.summary;
+    // Prefer plaintext when available — it's friendlier for LLM ingestion than
+    // the HTML-laden description field.
+    if (mod.description_plaintext)
+        out.description = mod.description_plaintext;
+    else if (mod.description)
+        out.description = mod.description;
+    if (mod.stats?.downloads_total !== undefined) {
+        out.downloadCount = mod.stats.downloads_total;
+    }
+    if (mod.stats?.ratings_positive !== undefined) {
+        out.endorsements = mod.stats.ratings_positive;
+    }
+    if (mod.date_updated) {
+        out.lastUpdated = new Date(mod.date_updated * 1000).toISOString();
+    }
+    return out;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/metadata/normalize.js.map

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

package/dist/metadata/types.d.ts

@@ -0,0 +1,57 @@
+export type ModPlatform = "nexus" | "modio" | "thunderstore" | "curseforge";
+export type ModPermissions = {
+    /** Allow modification / patches by other authors. Null = not exposed via API. */
+    modificationAllowed: boolean | null;
+    /** Allow asset reuse in other mods. Null = not exposed via API. */
+    assetReuseAllowed: boolean | null;
+    /** Allow conversion to other games. Null = not exposed via API. */
+    conversionAllowed: boolean | null;
+    /** Human-readable note about why fields may be null. */
+    note: string;
+};
+export type ModAttribution = {
+    author: string;
+    sourcePlatform: ModPlatform;
+    sourceModId: string;
+    pageUrl: string;
+};
+export type NormalizedMod = {
+    id: string;
+    name: string;
+    /** Mandatory attribution block, non-optional and always populated. */
+    attribution: ModAttribution;
+    platform: ModPlatform;
+    version?: string;
+    lastUpdated?: string;
+    summary?: string;
+    description?: string;
+    downloadCount?: number;
+    endorsements?: number;
+    permissions?: ModPermissions;
+    pageUrl: string;
+};
+export type QueryModMetadataInput = {
+    modId?: string;
+    modName?: string;
+    platform?: ModPlatform | "any";
+    /**
+     * Platform-specific game identifier:
+     *   - nexus: domain name string ("skyrimspecialedition")
+     *   - modio: numeric game id as a string ("6195")
+     * For "any" with a canonical workbench gameId, the lookup resolves per
+     * platform via the KNOWN_GAMES catalogue.
+     */
+    gameId?: string;
+};
+export type QueryModMetadataResult = {
+    found: true;
+    mod: NormalizedMod;
+    attemptedPlatforms: ModPlatform[];
+} | {
+    found: false;
+    reason: string;
+    attemptedPlatforms: ModPlatform[];
+    /** Per-platform diagnostics so the LLM can suggest next steps. */
+    platformErrors?: Record<string, string>;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/metadata/types.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,cAAc,GAAG,YAAY,CAAC;AAE5E,MAAM,MAAM,cAAc,GAAG;IAC3B,iFAAiF;IACjF,mBAAmB,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,mEAAmE;IACnE,iBAAiB,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,mEAAmE;IACnE,iBAAiB,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,WAAW,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,WAAW,EAAE,cAAc,CAAC;IAC5B,QAAQ,EAAE,WAAW,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IAC/B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAC9B;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,aAAa,CAAC;IAAC,kBAAkB,EAAE,WAAW,EAAE,CAAA;CAAE,GACtE;IACE,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,WAAW,EAAE,CAAC;IAClC,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC,CAAC"}

package/dist/metadata/types.js

@@ -0,0 +1,9 @@
+// Normalized cross-platform mod metadata. The wiring prompt is explicit about
+// what must NEVER be stripped: author name, source platform, and source mod
+// id. Those fields are non-optional on every mod that comes back.
+//
+// The "Trust Architecture" rule from the wiring prompt:
+//   "Attribution preserved end-to-end. Author names, source platforms, and
+//   original mod URLs appear in every output that mentions a mod."
+export {};
+//# sourceMappingURL=types.js.map

package/dist/metadata/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/metadata/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,4EAA4E;AAC5E,kEAAkE;AAClE,EAAE;AACF,wDAAwD;AACxD,2EAA2E;AAC3E,mEAAmE"}

package/dist/register.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register all Workbench tools on the given MCP server. Workbench tools are
+ * uncredentialed — they read local filesystem state, not platform APIs. That
+ * makes the registration shape slightly different from @modwrench/nexus and
+ * @modwrench/modio: no Credential parameter required.
+ *
+ * Returns metadata useful for boot logging.
+ */
+export declare function registerWorkbenchTools(server: McpServer): {
+    toolCount: number;
+};
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG;IACzD,SAAS,EAAE,MAAM,CAAC;CACnB,CAuQA"}