universal-game-modder 0.1.4

package/dist/decoders/unity/texture2d.js

@@ -0,0 +1,185 @@
+/**
+ * texture2d.ts — parse a Unity Texture2D object payload (Unity 2020.3 / format v22,
+ * typeTree DISABLED) into the fields needed to locate and decode its pixels.
+ *
+ * When the serialized file has enableTypeTree=false (Baldi's case, and the common
+ * release-build case), object payloads have no embedded schema — they are read
+ * POSITIONALLY against the known field order for the engine version. This module
+ * encodes the 2020.3 Texture2D field order. It is the one place that is version-shaped;
+ * a different major Unity version would need its own field order (a future slice).
+ *
+ * Reference field order (Unity 2020.3 Texture2D, little-endian desktop):
+ *   m_Name                : AlignedString
+ *   m_ForcedFallbackFormat: Int32
+ *   m_DownscaleFallback   : bool ; (2020.2+) m_IsAlphaChannelOptional : bool ; align(4)
+ *   m_Width               : Int32
+ *   m_Height              : Int32
+ *   m_CompleteImageSize   : Int32
+ *   m_MipsStripped        : Int32        (2020.1+)
+ *   m_TextureFormat       : Int32
+ *   m_MipCount            : Int32
+ *   m_IsReadable          : bool
+ *   m_IsPreProcessed      : bool         (2020.1+)
+ *   m_IgnoreMasterTextureLimit : bool    (2019.3+)
+ *   m_StreamingMipmaps    : bool         (2018.2+)
+ *   align(4)
+ *   m_StreamingMipmapsPriority : Int32   (2018.2+)
+ *   m_ImageCount          : Int32
+ *   m_TextureDimension    : Int32
+ *   m_TextureSettings     : { FilterMode:i32, Aniso:i32, MipBias:f32, WrapU:i32, WrapV:i32, WrapW:i32 }
+ *   m_LightmapFormat      : Int32
+ *   m_ColorSpace          : Int32
+ *   m_PlatformBlob        : UInt8[]  (Int32 len + bytes + align)   (2020.2+)
+ *   image data size       : Int32  (== bytes inline, or 0 when streamed)
+ *   m_StreamData          : { offset:UInt64, size:UInt32, path:AlignedString }  (when inline size==0)
+ *
+ * We tolerate trailing-field drift by reading defensively and validating width/height/
+ * format against sane bounds; an implausible parse throws rather than emitting garbage.
+ */
+import { BinaryReader } from './binary-reader.js';
+/** Unity TextureFormat enum (subset + names) — mirrors the codec lib's mapping. */
+export var TextureFormat;
+(function (TextureFormat) {
+    TextureFormat[TextureFormat["Alpha8"] = 1] = "Alpha8";
+    TextureFormat[TextureFormat["ARGB4444"] = 2] = "ARGB4444";
+    TextureFormat[TextureFormat["RGB24"] = 3] = "RGB24";
+    TextureFormat[TextureFormat["RGBA32"] = 4] = "RGBA32";
+    TextureFormat[TextureFormat["ARGB32"] = 5] = "ARGB32";
+    TextureFormat[TextureFormat["RGB565"] = 7] = "RGB565";
+    TextureFormat[TextureFormat["R16"] = 9] = "R16";
+    TextureFormat[TextureFormat["DXT1"] = 10] = "DXT1";
+    TextureFormat[TextureFormat["DXT3"] = 11] = "DXT3";
+    TextureFormat[TextureFormat["DXT5"] = 12] = "DXT5";
+    TextureFormat[TextureFormat["RGBA4444"] = 13] = "RGBA4444";
+    TextureFormat[TextureFormat["BGRA32"] = 14] = "BGRA32";
+    TextureFormat[TextureFormat["RHalf"] = 15] = "RHalf";
+    TextureFormat[TextureFormat["RGHalf"] = 16] = "RGHalf";
+    TextureFormat[TextureFormat["RGBAHalf"] = 17] = "RGBAHalf";
+    TextureFormat[TextureFormat["RFloat"] = 18] = "RFloat";
+    TextureFormat[TextureFormat["RGFloat"] = 19] = "RGFloat";
+    TextureFormat[TextureFormat["RGBAFloat"] = 20] = "RGBAFloat";
+    TextureFormat[TextureFormat["YUY2"] = 21] = "YUY2";
+    TextureFormat[TextureFormat["RGB9e5Float"] = 22] = "RGB9e5Float";
+    TextureFormat[TextureFormat["BC6H"] = 24] = "BC6H";
+    TextureFormat[TextureFormat["BC7"] = 25] = "BC7";
+    TextureFormat[TextureFormat["BC4"] = 26] = "BC4";
+    TextureFormat[TextureFormat["BC5"] = 27] = "BC5";
+    TextureFormat[TextureFormat["DXT1Crunched"] = 28] = "DXT1Crunched";
+    TextureFormat[TextureFormat["DXT5Crunched"] = 29] = "DXT5Crunched";
+    TextureFormat[TextureFormat["PVRTC_RGB2"] = 30] = "PVRTC_RGB2";
+    TextureFormat[TextureFormat["PVRTC_RGBA2"] = 31] = "PVRTC_RGBA2";
+    TextureFormat[TextureFormat["PVRTC_RGB4"] = 32] = "PVRTC_RGB4";
+    TextureFormat[TextureFormat["PVRTC_RGBA4"] = 33] = "PVRTC_RGBA4";
+    TextureFormat[TextureFormat["ETC_RGB4"] = 34] = "ETC_RGB4";
+    TextureFormat[TextureFormat["ATC_RGB4"] = 35] = "ATC_RGB4";
+    TextureFormat[TextureFormat["ATC_RGBA8"] = 36] = "ATC_RGBA8";
+    TextureFormat[TextureFormat["EAC_R"] = 41] = "EAC_R";
+    TextureFormat[TextureFormat["EAC_R_SIGNED"] = 42] = "EAC_R_SIGNED";
+    TextureFormat[TextureFormat["EAC_RG"] = 43] = "EAC_RG";
+    TextureFormat[TextureFormat["EAC_RG_SIGNED"] = 44] = "EAC_RG_SIGNED";
+    TextureFormat[TextureFormat["ETC2_RGB"] = 45] = "ETC2_RGB";
+    TextureFormat[TextureFormat["ETC2_RGBA1"] = 46] = "ETC2_RGBA1";
+    TextureFormat[TextureFormat["ETC2_RGBA8"] = 47] = "ETC2_RGBA8";
+    TextureFormat[TextureFormat["ASTC_RGB_4x4"] = 48] = "ASTC_RGB_4x4";
+    TextureFormat[TextureFormat["ASTC_RGB_5x5"] = 49] = "ASTC_RGB_5x5";
+    TextureFormat[TextureFormat["ASTC_RGB_6x6"] = 50] = "ASTC_RGB_6x6";
+    TextureFormat[TextureFormat["ASTC_RGB_8x8"] = 51] = "ASTC_RGB_8x8";
+    TextureFormat[TextureFormat["ASTC_RGB_10x10"] = 52] = "ASTC_RGB_10x10";
+    TextureFormat[TextureFormat["ASTC_RGB_12x12"] = 53] = "ASTC_RGB_12x12";
+    TextureFormat[TextureFormat["ASTC_RGBA_4x4"] = 54] = "ASTC_RGBA_4x4";
+    TextureFormat[TextureFormat["ASTC_RGBA_5x5"] = 55] = "ASTC_RGBA_5x5";
+    TextureFormat[TextureFormat["ASTC_RGBA_6x6"] = 56] = "ASTC_RGBA_6x6";
+    TextureFormat[TextureFormat["ASTC_RGBA_8x8"] = 57] = "ASTC_RGBA_8x8";
+    TextureFormat[TextureFormat["ASTC_RGBA_10x10"] = 58] = "ASTC_RGBA_10x10";
+    TextureFormat[TextureFormat["ASTC_RGBA_12x12"] = 59] = "ASTC_RGBA_12x12";
+    TextureFormat[TextureFormat["RG16"] = 62] = "RG16";
+    TextureFormat[TextureFormat["R8"] = 63] = "R8";
+    TextureFormat[TextureFormat["ETC_RGB4Crunched"] = 64] = "ETC_RGB4Crunched";
+    TextureFormat[TextureFormat["ETC2_RGBA8Crunched"] = 65] = "ETC2_RGBA8Crunched";
+    TextureFormat[TextureFormat["RG32"] = 72] = "RG32";
+    TextureFormat[TextureFormat["RGB48"] = 73] = "RGB48";
+    TextureFormat[TextureFormat["RGBA64"] = 74] = "RGBA64";
+})(TextureFormat || (TextureFormat = {}));
+const MAX_DIM = 32768; // sanity bound — Unity textures never exceed this
+/**
+ * Parse a Texture2D from its object byte-range. `header` provides endianness;
+ * `obj.byteStart` is RELATIVE to header.dataOffset.
+ */
+export function parseTexture2D(buf, header, obj) {
+    const little = header.endianess === 0;
+    const start = Number(header.dataOffset + obj.byteStart);
+    const end = start + obj.byteSize;
+    if (start < 0 || end > buf.length) {
+        throw new RangeError(`parseTexture2D: object range [${start}, ${end}] outside buffer ${buf.length}`);
+    }
+    // Bind the reader to this object's slice so a field-order miss can't wander into the
+    // next object's bytes — it throws inside this window instead.
+    const r = new BinaryReader(buf.subarray(start, end), /* bigEndian */ !little, 0);
+    const name = r.readAlignedString();
+    r.readInt32(); // m_ForcedFallbackFormat
+    r.readUInt8(); // m_DownscaleFallback
+    r.readUInt8(); // m_IsAlphaChannelOptional (2020.2+)
+    r.align(4);
+    const width = r.readInt32();
+    const height = r.readInt32();
+    const completeImageSize = r.readInt32();
+    r.readInt32(); // m_MipsStripped (2020.1+)
+    const textureFormat = r.readInt32();
+    const mipCount = r.readInt32();
+    if (width <= 0 || height <= 0 || width > MAX_DIM || height > MAX_DIM) {
+        throw new RangeError(`parseTexture2D("${name}"): implausible dimensions ${width}x${height} — field-order mismatch for this Unity version`);
+    }
+    r.readUInt8(); // m_IsReadable
+    r.readUInt8(); // m_IsPreProcessed (2020.1+)
+    r.readUInt8(); // m_IgnoreMasterTextureLimit (2019.3+)
+    r.readUInt8(); // m_StreamingMipmaps (2018.2+)
+    r.align(4);
+    r.readInt32(); // m_StreamingMipmapsPriority
+    r.readInt32(); // m_ImageCount
+    r.readInt32(); // m_TextureDimension
+    // m_TextureSettings (6 ints; MipBias is a float but width-equal)
+    r.skip(6 * 4);
+    r.readInt32(); // m_LightmapFormat
+    r.readInt32(); // m_ColorSpace
+    // m_PlatformBlob (2020.2+): Int32 length + bytes + align(4)
+    const blobLen = r.readInt32();
+    if (blobLen < 0 || blobLen > r.remaining) {
+        throw new RangeError(`parseTexture2D("${name}"): implausible m_PlatformBlob length ${blobLen}`);
+    }
+    r.skip(blobLen);
+    r.align(4);
+    // image data: Int32 size; if >0 the bytes are inline, else they're streamed.
+    const inlineSize = r.readInt32();
+    let inlineData = Buffer.alloc(0);
+    if (inlineSize > 0) {
+        inlineData = Buffer.from(r.readBytes(inlineSize)); // copy out of the shared buffer
+    }
+    // m_StreamData (offset:UInt64, size:UInt32, path:AlignedString)
+    let streamData = null;
+    if (r.remaining >= 12) {
+        const offset = r.readUInt64();
+        const size = r.readUInt32();
+        const path = r.remaining >= 4 ? r.readAlignedString() : '';
+        if (size > 0 && path) {
+            streamData = { offset, size, path };
+        }
+    }
+    if (inlineData.length === 0 && !streamData) {
+        // Some textures legitimately have completeImageSize but no stream/inline (rare);
+        // surface it as a parse note rather than silently producing an empty texture.
+        if (completeImageSize > 0) {
+            throw new Error(`parseTexture2D("${name}"): no inline data and no stream data, but completeImageSize=${completeImageSize}`);
+        }
+    }
+    return {
+        name,
+        width,
+        height,
+        textureFormat,
+        formatName: TextureFormat[textureFormat] ?? `Unknown(${textureFormat})`,
+        mipCount,
+        inlineData,
+        streamData,
+    };
+}
+//# sourceMappingURL=texture2d.js.map

package/dist/decoders/unity/vertex-data.d.ts

@@ -0,0 +1,54 @@
+/**
+ * vertex-data.ts — decode a Unity Mesh's m_VertexData into typed vertex attributes.
+ *
+ * Unity packs all vertex attributes (position, normal, tangent, color, uv0..uv7) into one
+ * interleaved byte blob, described by a list of ChannelInfo entries. Each channel says:
+ *   stream    — which interleaved stream it lives in (usually 0)
+ *   offset    — byte offset WITHIN one vertex's slice of that stream
+ *   format    — the component data type (float32 / float16 / unorm8 / ...)
+ *   dimension — component count (3 for position, 2 for uv, 4 for tangent/color)
+ * The per-vertex stride of a stream is the sum of its channels' byte sizes (aligned).
+ *
+ * This module reads the channels we export (POSITION, NORMAL, and UV0) as float32 arrays.
+ * Other channels are skipped for the first slice; nothing throws on an unknown channel —
+ * it's simply not extracted (and the caller notes which attributes were exported).
+ *
+ * Reference field order: Unity 2020.3 VertexData (AssetStudio Mesh.cs), little-endian.
+ */
+/** Unity VertexChannelFormat (2019+). The values we decode are the common ones. */
+export declare enum VertexFormat {
+    Float = 0,
+    Float16 = 1,
+    UNorm8 = 2,
+    SNorm8 = 3,
+    UNorm16 = 4,
+    SNorm16 = 5,
+    UInt8 = 6,
+    SInt8 = 7,
+    UInt16 = 8,
+    SInt16 = 9,
+    UInt32 = 10,
+    SInt32 = 11
+}
+export interface ChannelInfo {
+    stream: number;
+    offset: number;
+    format: number;
+    dimension: number;
+}
+export interface VertexDataRaw {
+    vertexCount: number;
+    channels: ChannelInfo[];
+    /** the interleaved vertex byte blob (after resolving inline vs streamed). */
+    data: Buffer;
+}
+/** Byte size of one component of a given vertex format. */
+export declare function formatSize(format: number): number;
+/** IEEE half (float16) -> float32. */
+export declare function halfToFloat(h: number): number;
+/**
+ * Extract a per-vertex float attribute (e.g. POSITION dim=3) from the interleaved blob.
+ * Returns a flat Float32Array of length vertexCount*outDim. Components beyond the channel's
+ * real dimension are zero-filled; if the channel is absent, returns null.
+ */
+export declare function extractAttribute(vd: VertexDataRaw, channelIndex: number, outDim: number): Float32Array | null;

package/dist/decoders/unity/vertex-data.js

@@ -0,0 +1,174 @@
+/**
+ * vertex-data.ts — decode a Unity Mesh's m_VertexData into typed vertex attributes.
+ *
+ * Unity packs all vertex attributes (position, normal, tangent, color, uv0..uv7) into one
+ * interleaved byte blob, described by a list of ChannelInfo entries. Each channel says:
+ *   stream    — which interleaved stream it lives in (usually 0)
+ *   offset    — byte offset WITHIN one vertex's slice of that stream
+ *   format    — the component data type (float32 / float16 / unorm8 / ...)
+ *   dimension — component count (3 for position, 2 for uv, 4 for tangent/color)
+ * The per-vertex stride of a stream is the sum of its channels' byte sizes (aligned).
+ *
+ * This module reads the channels we export (POSITION, NORMAL, and UV0) as float32 arrays.
+ * Other channels are skipped for the first slice; nothing throws on an unknown channel —
+ * it's simply not extracted (and the caller notes which attributes were exported).
+ *
+ * Reference field order: Unity 2020.3 VertexData (AssetStudio Mesh.cs), little-endian.
+ */
+import { BinaryReader } from './binary-reader.js';
+/** Unity VertexChannelFormat (2019+). The values we decode are the common ones. */
+export var VertexFormat;
+(function (VertexFormat) {
+    VertexFormat[VertexFormat["Float"] = 0] = "Float";
+    VertexFormat[VertexFormat["Float16"] = 1] = "Float16";
+    VertexFormat[VertexFormat["UNorm8"] = 2] = "UNorm8";
+    VertexFormat[VertexFormat["SNorm8"] = 3] = "SNorm8";
+    VertexFormat[VertexFormat["UNorm16"] = 4] = "UNorm16";
+    VertexFormat[VertexFormat["SNorm16"] = 5] = "SNorm16";
+    VertexFormat[VertexFormat["UInt8"] = 6] = "UInt8";
+    VertexFormat[VertexFormat["SInt8"] = 7] = "SInt8";
+    VertexFormat[VertexFormat["UInt16"] = 8] = "UInt16";
+    VertexFormat[VertexFormat["SInt16"] = 9] = "SInt16";
+    VertexFormat[VertexFormat["UInt32"] = 10] = "UInt32";
+    VertexFormat[VertexFormat["SInt32"] = 11] = "SInt32";
+})(VertexFormat || (VertexFormat = {}));
+/** Byte size of one component of a given vertex format. */
+export function formatSize(format) {
+    switch (format) {
+        case VertexFormat.Float:
+        case VertexFormat.UInt32:
+        case VertexFormat.SInt32:
+            return 4;
+        case VertexFormat.Float16:
+        case VertexFormat.UNorm16:
+        case VertexFormat.SNorm16:
+        case VertexFormat.UInt16:
+        case VertexFormat.SInt16:
+            return 2;
+        case VertexFormat.UNorm8:
+        case VertexFormat.SNorm8:
+        case VertexFormat.UInt8:
+        case VertexFormat.SInt8:
+            return 1;
+        default:
+            return 4;
+    }
+}
+/** Read one component as a float (normalizing where the format implies it). */
+function readComponent(r, format) {
+    switch (format) {
+        case VertexFormat.Float:
+            return readF32(r);
+        case VertexFormat.Float16:
+            return halfToFloat(readU16(r));
+        case VertexFormat.UNorm8:
+            return readU8(r) / 255;
+        case VertexFormat.SNorm8:
+            return Math.max(readI8(r) / 127, -1);
+        case VertexFormat.UNorm16:
+            return readU16(r) / 65535;
+        case VertexFormat.SNorm16:
+            return Math.max(readI16(r) / 32767, -1);
+        case VertexFormat.UInt8:
+            return readU8(r);
+        case VertexFormat.SInt8:
+            return readI8(r);
+        case VertexFormat.UInt16:
+            return readU16(r);
+        case VertexFormat.SInt16:
+            return readI16(r);
+        case VertexFormat.UInt32:
+        case VertexFormat.SInt32:
+            return Number(readU32(r));
+        default:
+            return readF32(r);
+    }
+}
+// Small explicit readers (avoid the awkward advance() trick above for clarity).
+function readF32(r) {
+    const v = r.buf.readFloatLE(r.pos);
+    r.pos += 4;
+    return v;
+}
+function readU8(r) {
+    const v = r.buf.readUInt8(r.pos);
+    r.pos += 1;
+    return v;
+}
+function readI8(r) {
+    const v = r.buf.readInt8(r.pos);
+    r.pos += 1;
+    return v;
+}
+function readU16(r) {
+    const v = r.buf.readUInt16LE(r.pos);
+    r.pos += 2;
+    return v;
+}
+function readI16(r) {
+    const v = r.buf.readInt16LE(r.pos);
+    r.pos += 2;
+    return v;
+}
+function readU32(r) {
+    const v = r.buf.readUInt32LE(r.pos);
+    r.pos += 4;
+    return v;
+}
+/** IEEE half (float16) -> float32. */
+export function halfToFloat(h) {
+    const s = (h & 0x8000) >> 15;
+    const e = (h & 0x7c00) >> 10;
+    const f = h & 0x03ff;
+    if (e === 0)
+        return (s ? -1 : 1) * Math.pow(2, -14) * (f / 1024);
+    if (e === 0x1f)
+        return f ? NaN : (s ? -1 : 1) * Infinity;
+    return (s ? -1 : 1) * Math.pow(2, e - 15) * (1 + f / 1024);
+}
+/**
+ * Extract a per-vertex float attribute (e.g. POSITION dim=3) from the interleaved blob.
+ * Returns a flat Float32Array of length vertexCount*outDim. Components beyond the channel's
+ * real dimension are zero-filled; if the channel is absent, returns null.
+ */
+export function extractAttribute(vd, channelIndex, outDim) {
+    const ch = vd.channels[channelIndex];
+    if (!ch || (ch.dimension & 0x0f) === 0)
+        return null;
+    const dim = ch.dimension & 0x0f;
+    const compSize = formatSize(ch.format);
+    // Per-stream stride = sum of byte sizes of all channels in that stream.
+    const stride = streamStride(vd.channels, ch.stream);
+    if (stride === 0)
+        return null;
+    // Byte offset of this stream's region within the blob: streams are concatenated, each
+    // region = vertexCount * thatStreamStride. Compute the start of ch.stream.
+    let streamStart = 0;
+    for (let s = 0; s < ch.stream; s++) {
+        streamStart += vd.vertexCount * streamStride(vd.channels, s);
+    }
+    const out = new Float32Array(vd.vertexCount * outDim);
+    const r = new BinaryReader(vd.data, false, 0);
+    for (let v = 0; v < vd.vertexCount; v++) {
+        const base = streamStart + v * stride + ch.offset;
+        for (let c = 0; c < dim && c < outDim; c++) {
+            r.pos = base + c * compSize;
+            if (r.pos + compSize > vd.data.length)
+                return out; // bounds guard: stop, return what we have
+            out[v * outDim + c] = readComponent(r, ch.format);
+        }
+    }
+    return out;
+}
+/** Sum of byte sizes of channels assigned to a given stream. */
+function streamStride(channels, stream) {
+    let s = 0;
+    for (const ch of channels) {
+        if (ch.stream !== stream)
+            continue;
+        const dim = ch.dimension & 0x0f;
+        s += dim * formatSize(ch.format);
+    }
+    return s;
+}
+//# sourceMappingURL=vertex-data.js.map

package/dist/decoders/unity/vertex-data.js.map

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

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { startMcpServer } from './server.js';
+import { startWebServer } from './web/web-server.js';
+import { loadConfig } from './core/config.js';
+import { logger } from './utils/logger.js';
+async function main() {
+    const config = loadConfig();
+    // Start the web dashboard (runs on HTTP port, independent of MCP stdio)
+    try {
+        startWebServer(config.webPort);
+    }
+    catch (err) {
+        logger.warn('Web dashboard failed to start', err);
+        // Non-fatal: MCP server can run without the dashboard
+    }
+    // Start the MCP server (communicates via stdio)
+    await startMcpServer();
+}
+main().catch((err) => {
+    logger.error('Fatal error', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/server.d.ts

@@ -0,0 +1 @@
+export declare function startMcpServer(): Promise<void>;

package/dist/server.js

@@ -0,0 +1,66 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ListToolsRequestSchema, CallToolRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { getAllTools } from './tools/index.js';
+import { logger } from './utils/logger.js';
+// Single source of truth for the version: package.json. A hardcoded string here
+// silently drifts from the shipped package (it once reported 1.0.0 for a 0.1.0
+// release), which makes it impossible to tell which build a user is running.
+function getVersion() {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const pkg = JSON.parse(readFileSync(resolve(here, '../package.json'), 'utf-8'));
+        return typeof pkg.version === 'string' ? pkg.version : '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+export async function startMcpServer() {
+    const server = new Server({ name: 'universal-game-modder', version: getVersion() }, { capabilities: { tools: {} } });
+    // Register tool list handler
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        const tools = getAllTools();
+        return {
+            tools: tools.map(t => ({
+                name: t.name,
+                description: t.description,
+                inputSchema: t.inputSchema,
+            })),
+        };
+    });
+    // Register tool call handler
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const tools = getAllTools();
+        const tool = tools.find(t => t.name === name);
+        if (!tool) {
+            return {
+                content: [{ type: 'text', text: `Unknown tool: ${name}. Use list_available_tools to see available tools.` }],
+                isError: true,
+            };
+        }
+        try {
+            const result = await tool.handler(args || {});
+            return {
+                content: [{ type: 'text', text: result }],
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.error(`Tool ${name} failed`, msg);
+            return {
+                content: [{ type: 'text', text: `ERROR in ${name}: ${msg}` }],
+                isError: true,
+            };
+        }
+    });
+    // Connect to stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info('Universal Game Modder MCP server started on stdio');
+}
+//# sourceMappingURL=server.js.map

package/dist/tools/decode-tools.d.ts

@@ -0,0 +1,29 @@
+/**
+ * decode-tools.ts — PR-2 "Universal Asset Decoder" (texture-first slice).
+ *
+ * decode_assets(db_path | game_path): reads the PR-1 catalog (The Model), finds the Unity
+ * .assets container rows PR-1 catalogued as un-expanded, cracks each one open with our
+ * serialized-file walker, extracts every Texture2D (pulling streamed pixels from the
+ * sibling .resS), decodes to RGBA via the wrapped codec, writes a PNG, and writes the
+ * decoded asset back into The Model as its own row:
+ *
+ *   asset(container_path = the .assets file, internal_path = "<TexName>#<pathID>",
+ *         type = 'texture', format = <TextureFormat>, decoded = 1,
+ *         decoded_path = <png>, provenance = 'verified', source_tool = 'decode_assets')
+ *
+ * This uses the container_path/internal_path seam PR-1 built for exactly this (PR-1 rows
+ * have internal_path = '' for standalone files; PR-2 members get a non-empty internal_path,
+ * so the UNIQUE (game_id, container_path, internal_path) key never collides with the
+ * container's own catalog row).
+ *
+ * RAILS (honored):
+ *  - READ-ONLY on game files. The ONLY writes are: the decoded PNGs (jailed to the output
+ *    dir, default <game>/.autopsy/decoded/, overridable for write-protected installs) and
+ *    the .autopsy.db rows. Never a byte into the game's own assets.
+ *  - VERIFY-AFTER-WRITE: each PNG is re-read/validated; each DB row is read back.
+ *  - NEVER SILENTLY DROP: an unsupported format / unreadable stream becomes a decoded=0
+ *    row with a note, and the run continues (A3-class).
+ *  - PROVENANCE: a byte-level decoded texture is 'verified'; a failed one is 'uncertain'.
+ */
+import type { ToolDefinition } from './index.js';
+export declare function getDecodeTools(): ToolDefinition[];