@edgemodders/redcode-mcp 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+What changed in each redcode-mcp release. The release notes on GitHub come from these sections; changes are grouped as **New**, **Changed**, **Fixed** and **Other**, and older sections keep the form they had.
+
+## Unreleased
+
+## 0.5.0 (2026-11-10)
+
+For EDGEfab and EDGEhack: `library_add`, and image imports with a texture setup. `texture` needs REDbridge 0.12.0; the rest work as in 0.4.0.
+
+**New**
+
+- `library_add`: a game file or a project's file, with the files it needs, as one asset item in the EDGE Library (REDcode issue #19). With no Library yet or no folder given, it answers what to ask the modder. `gamePathFolders` is the Use the game path choice. Works with REDbridge 0.10.0 or later.
+- `project_import` takes `texture`, an image's `.xbm` setup (a preset, a texture group, or its fields), and answers the setup read back. Needs REDbridge 0.12.0.
+
 ## 0.4.0 (2026-10-27)
 
 The new tool needs REDbridge 0.11.0, the bridge for game 2.5; the rest work as in 0.3.0.

package/README.md

@@ -53,7 +53,8 @@ To build from source, run `npm install` and `npm run mcp:build` in the [REDcode
 | `texture_to_png`, `texture_file_to_png` | Decode an `.xbm` to PNG |
 | `hash_fnv1a64`, `hash_resolve` | Hash a string; look a hash up |
 | `archive_open_mod`, `archive_extract_from_mod` | List the resources in a mod's `.archive` on disk; extract them, by game path or hash. No game needed |
-| `project_export`, `project_import`, `project_pack` | WolvenKit's exporter (a mesh to glTF, a texture to an image, a `.wem` to Ogg) and importer between `source/archive` and `source/raw`; pack a folder into `<modName>.archive` |
+| `project_export`, `project_import`, `project_pack` | WolvenKit's exporter (a mesh to glTF, a texture to an image, a `.wem` to Ogg) and importer between `source/archive` and `source/raw`; pack a folder into `<modName>.archive`. An image import takes `texture`, the `.xbm`'s setup (a preset, a texture group or its fields), and answers the setup read back (bridge 0.12.0) |
+| `library_add` | A game file or a project's file, with the files it needs, as one asset item in the EDGE Library. With no Library yet or no folder given, it answers what to ask the modder |
 | `loc_languages`, `loc_search`, `loc_get` | The game's on-screen texts (LocKeys) per language, base game and Phantom Liberty, read offline. Search by LocKey, secondary key or words of the text; get by LocKey or secondary key. With `projectDir`, the project's own onscreens entries win. Bridge 0.10.0 |
 | `tweakdb_types`, `tweakdb_records`, `tweakdb_record`, `tweakdb_flat`, `tweakdb_search`, `tweakdb_names` | TweakDB as the game ships it, read offline from `tweakdb_ep1.bin` (the first call loads it, about 12 s). Records by type (subtypes included) or prefix with the flats you name, one record with every flat, one flat, a search by path words, and ids to paths. Record links come back as paths, LocKeys as `{ key, text }`. Bridge 0.8.0 |
 | `mesh_items` | The TweakDB item records whose look shows a mesh, each with its display name, the mesh appearance it shows, the `.app` look and the root entity on the way. Covers items that pick their look by `appearanceName`, such as clothing. Bridge 0.11.0 |

package/dist/ThirdPartyNotices.txt

@@ -1,4 +1,4 @@
-@edgemodders/redcode-mcp 0.4.0 bundles the following packages into dist/server.cjs. Their notices follow.
+@edgemodders/redcode-mcp 0.5.0 bundles the following packages into dist/server.cjs. Their notices follow.
 
 ------------------------------------------------------------------------------
 

package/dist/server.cjs

@@ -2236,8 +2236,8 @@ var require_resolve = __commonJS({
       }
       return count;
     }
-    function getFullPath(resolver, id = "", normalize) {
-      if (normalize !== false)
+    function getFullPath(resolver, id = "", normalize2) {
+      if (normalize2 !== false)
         id = normalizeId(id);
       const p = resolver.parse(id);
       return _getFullPath(resolver, p);
@@ -2985,7 +2985,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve2.call(this, root, ref);
+      let _sch = resolve4.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a = root.localRefs) === null || _a === void 0 ? void 0 : _a[ref];
         const { schemaId } = this.opts;
@@ -3012,7 +3012,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve2(root, ref) {
+    function resolve4(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -3263,8 +3263,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path4) {
-      let input = path4;
+    function removeDotSegments(path6) {
+      let input = path6;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -3673,8 +3673,8 @@ var require_schemes = __commonJS({
       }
       if (wsComponent.resourceName) {
         const queryIndex = wsComponent.resourceName.indexOf("?");
-        const path4 = queryIndex === -1 ? wsComponent.resourceName : wsComponent.resourceName.slice(0, queryIndex);
-        wsComponent.path = path4 && path4 !== "/" ? path4 : void 0;
+        const path6 = queryIndex === -1 ? wsComponent.resourceName : wsComponent.resourceName.slice(0, queryIndex);
+        wsComponent.path = path6 && path6 !== "/" ? path6 : void 0;
         wsComponent.query = queryIndex === -1 ? void 0 : wsComponent.resourceName.slice(queryIndex + 1);
         wsComponent.resourceName = void 0;
       }
@@ -3832,7 +3832,7 @@ var require_fast_uri = __commonJS({
       }
       return decodedScheme;
     }
-    function normalize(uri, options) {
+    function normalize2(uri, options) {
       if (typeof uri === "string") {
         uri = /** @type {T} */
         normalizeString(uri, options);
@@ -3842,7 +3842,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve2(baseURI, relativeURI, options) {
+    function resolve4(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const {
         parsed: baseParsed,
@@ -3875,49 +3875,49 @@ var require_fast_uri = __commonJS({
       schemelessOptions.skipEscape = true;
       return serialize(resolved, schemelessOptions);
     }
-    function resolveComponent(base, relative2, options, skipNormalization) {
+    function resolveComponent(base, relative3, options, skipNormalization) {
       const target = {};
       if (!skipNormalization) {
         base = parse3(serialize(base, options), options);
-        relative2 = parse3(serialize(relative2, options), options);
+        relative3 = parse3(serialize(relative3, options), options);
       }
       options = options || {};
-      if (!options.tolerant && relative2.scheme) {
-        target.scheme = relative2.scheme;
-        target.userinfo = relative2.userinfo;
-        target.host = relative2.host;
-        target.port = relative2.port;
-        target.path = removeDotSegments(relative2.path || "");
-        target.query = relative2.query;
+      if (!options.tolerant && relative3.scheme) {
+        target.scheme = relative3.scheme;
+        target.userinfo = relative3.userinfo;
+        target.host = relative3.host;
+        target.port = relative3.port;
+        target.path = removeDotSegments(relative3.path || "");
+        target.query = relative3.query;
       } else {
-        if (relative2.userinfo !== void 0 || relative2.host !== void 0 || relative2.port !== void 0) {
-          target.userinfo = relative2.userinfo;
-          target.host = relative2.host;
-          target.port = relative2.port;
-          target.path = removeDotSegments(relative2.path || "");
-          target.query = relative2.query;
+        if (relative3.userinfo !== void 0 || relative3.host !== void 0 || relative3.port !== void 0) {
+          target.userinfo = relative3.userinfo;
+          target.host = relative3.host;
+          target.port = relative3.port;
+          target.path = removeDotSegments(relative3.path || "");
+          target.query = relative3.query;
         } else {
-          if (!relative2.path) {
+          if (!relative3.path) {
             target.path = base.path;
-            if (relative2.query !== void 0) {
-              target.query = relative2.query;
+            if (relative3.query !== void 0) {
+              target.query = relative3.query;
             } else {
               target.query = base.query;
             }
           } else {
-            if (relative2.path[0] === "/") {
-              target.path = removeDotSegments(relative2.path);
+            if (relative3.path[0] === "/") {
+              target.path = removeDotSegments(relative3.path);
             } else {
               if ((base.userinfo !== void 0 || base.host !== void 0 || base.port !== void 0) && !base.path) {
-                target.path = "/" + relative2.path;
+                target.path = "/" + relative3.path;
               } else if (!base.path) {
-                target.path = relative2.path;
+                target.path = relative3.path;
               } else {
-                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative2.path;
+                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative3.path;
               }
               target.path = removeDotSegments(target.path);
             }
-            target.query = relative2.query;
+            target.query = relative3.query;
           }
           target.userinfo = base.userinfo;
           target.host = base.host;
@@ -3925,7 +3925,7 @@ var require_fast_uri = __commonJS({
         }
         target.scheme = base.scheme;
       }
-      target.fragment = relative2.fragment;
+      target.fragment = relative3.fragment;
       return target;
     }
     function equal(uriA, uriB, options) {
@@ -4210,8 +4210,8 @@ var require_fast_uri = __commonJS({
     }
     var fastUri = {
       SCHEMES,
-      normalize,
-      resolve: resolve2,
+      normalize: normalize2,
+      resolve: resolve4,
       resolveComponent,
       equal,
       serialize,
@@ -7187,12 +7187,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f;
     };
-    function addFormats(ajv, list, fs4, exportName) {
+    function addFormats(ajv, list, fs6, exportName) {
       var _a;
       var _b;
       (_a = (_b = ajv.opts.code).formats) !== null && _a !== void 0 ? _a : _b.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f of list)
-        ajv.addFormat(f, fs4[f]);
+        ajv.addFormat(f, fs6[f]);
     }
     module2.exports = exports2 = formatsPlugin;
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -8416,8 +8416,8 @@ var require_semaphore = __commonJS({
         this._waiting = [];
       }
       lock(thunk) {
-        return new Promise((resolve2, reject) => {
-          this._waiting.push({ thunk, resolve: resolve2, reject });
+        return new Promise((resolve4, reject) => {
+          this._waiting.push({ thunk, resolve: resolve4, reject });
           this.runNext();
         });
       }
@@ -10043,9 +10043,9 @@ ${JSON.stringify(message, null, 4)}`);
           if (typeof cancellationStrategy.sender.enableCancellation === "function") {
             cancellationStrategy.sender.enableCancellation(requestMessage);
           }
-          return new Promise(async (resolve2, reject) => {
+          return new Promise(async (resolve4, reject) => {
             const resolveWithCleanup = (r) => {
-              resolve2(r);
+              resolve4(r);
               cancellationStrategy.sender.cleanup(id);
               disposable?.dispose();
             };
@@ -10474,10 +10474,10 @@ var require_ril = __commonJS({
         return api_1.Disposable.create(() => this.stream.off("end", listener));
       }
       write(data, encoding) {
-        return new Promise((resolve2, reject) => {
+        return new Promise((resolve4, reject) => {
           const callback = (error2) => {
             if (error2 === void 0 || error2 === null) {
-              resolve2();
+              resolve4();
             } else {
               reject(error2);
             }
@@ -10613,9 +10613,9 @@ var require_main = __commonJS({
     exports2.createMessageConnection = createMessageConnection2;
     var ril_1 = __importDefault(require_ril());
     ril_1.default.install();
-    var path4 = __importStar(require("path"));
-    var os2 = __importStar(require("os"));
-    var fs4 = __importStar(require("fs"));
+    var path6 = __importStar(require("path"));
+    var os3 = __importStar(require("os"));
+    var fs6 = __importStar(require("fs"));
     var crypto_1 = require("crypto");
     var net_1 = require("net");
     var api_1 = require_api();
@@ -10756,7 +10756,7 @@ var require_main = __commonJS({
       }
       let randomLength = 32;
       const fixedLength = "/lsp-.sock".length;
-      const tmpDir = fs4.realpathSync(XDG_RUNTIME_DIR ?? os2.tmpdir());
+      const tmpDir = fs6.realpathSync(XDG_RUNTIME_DIR ?? os3.tmpdir());
       const limit = safeIpcPathLengths.get(process.platform);
       if (limit !== void 0) {
         randomLength = Math.min(limit - tmpDir.length - fixedLength, randomLength);
@@ -10765,14 +10765,14 @@ var require_main = __commonJS({
         throw new Error(`Unable to generate a random pipe name with ${randomLength} characters.`);
       }
       const randomSuffix = (0, crypto_1.randomBytes)(Math.floor(randomLength / 2)).toString("hex");
-      return path4.join(tmpDir, `lsp-${randomSuffix}.sock`);
+      return path6.join(tmpDir, `lsp-${randomSuffix}.sock`);
     }
     function createClientPipeTransport(pipeName, encoding = "utf-8") {
       let connectResolve;
-      const connected = new Promise((resolve2, _reject) => {
-        connectResolve = resolve2;
+      const connected = new Promise((resolve4, _reject) => {
+        connectResolve = resolve4;
       });
-      return new Promise((resolve2, reject) => {
+      return new Promise((resolve4, reject) => {
         const server2 = (0, net_1.createServer)((socket) => {
           server2.close();
           connectResolve([
@@ -10783,7 +10783,7 @@ var require_main = __commonJS({
         server2.on("error", reject);
         server2.listen(pipeName, () => {
           server2.removeListener("error", reject);
-          resolve2({
+          resolve4({
             onConnected: () => {
               return connected;
             }
@@ -10800,10 +10800,10 @@ var require_main = __commonJS({
     }
     function createClientSocketTransport(port, encoding = "utf-8") {
       let connectResolve;
-      const connected = new Promise((resolve2, _reject) => {
-        connectResolve = resolve2;
+      const connected = new Promise((resolve4, _reject) => {
+        connectResolve = resolve4;
       });
-      return new Promise((resolve2, reject) => {
+      return new Promise((resolve4, reject) => {
         const server2 = (0, net_1.createServer)((socket) => {
           server2.close();
           connectResolve([
@@ -10820,7 +10820,7 @@ var require_main = __commonJS({
             return;
           }
           const boundPort = address.port;
-          resolve2({
+          resolve4({
             port: () => boundPort,
             onConnected: () => {
               return connected;
@@ -10859,9 +10859,9 @@ var require_main = __commonJS({
 });
 
 // src/server.ts
-var fs3 = __toESM(require("node:fs"));
-var os = __toESM(require("node:os"));
-var path3 = __toESM(require("node:path"));
+var fs5 = __toESM(require("node:fs"));
+var os2 = __toESM(require("node:os"));
+var path5 = __toESM(require("node:path"));
 
 // ../../node_modules/zod/v3/external.js
 var external_exports = {};
@@ -11341,8 +11341,8 @@ function getErrorMap() {
 
 // ../../node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path4, errorMaps, issueData } = params;
-  const fullPath = [...path4, ...issueData.path || []];
+  const { data, path: path6, errorMaps, issueData } = params;
+  const fullPath = [...path6, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -11458,11 +11458,11 @@ var errorUtil;
 
 // ../../node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path4, key) {
+  constructor(parent, value, path6, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path4;
+    this._path = path6;
     this._key = key;
   }
   get path() {
@@ -15099,10 +15099,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path4) {
-  if (!path4)
+function getElementAtPath(obj, path6) {
+  if (!path6)
     return obj;
-  return path4.reduce((acc, key) => acc?.[key], obj);
+  return path6.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -15422,11 +15422,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path4, issues) {
+function prefixIssues(path6, issues) {
   return issues.map((iss) => {
     var _a;
     (_a = iss).path ?? (_a.path = []);
-    iss.path.unshift(path4);
+    iss.path.unshift(path6);
     return iss;
   });
 }
@@ -18837,11 +18837,11 @@ function normalizeObjectSchema(schema) {
   }
   return void 0;
 }
-function getDotPath(path4) {
-  if (path4.length === 0) {
+function getDotPath(path6) {
+  if (path6.length === 0) {
     return "object root";
   }
-  return path4.reduce((acc, seg, index) => {
+  return path6.reduce((acc, seg, index) => {
     if (index === 0) {
       return String(seg);
     }
@@ -22992,7 +22992,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve2) => setTimeout(resolve2, pollInterval));
+        await new Promise((resolve4) => setTimeout(resolve4, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error2) {
@@ -23009,7 +23009,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve2, reject) => {
+    return new Promise((resolve4, reject) => {
       const earlyReject = (error2) => {
         reject(error2);
       };
@@ -23087,7 +23087,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve2(parseResult.data);
+            resolve4(parseResult.data);
           }
         } catch (error2) {
           reject(error2);
@@ -23349,12 +23349,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve2, reject) => {
+    return new Promise((resolve4, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve2, interval);
+      const timeoutId = setTimeout(resolve4, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -24485,7 +24485,7 @@ var McpServer = class {
     let task = createTaskResult.task;
     const pollInterval = task.pollInterval ?? 5e3;
     while (task.status !== "completed" && task.status !== "failed" && task.status !== "cancelled") {
-      await new Promise((resolve2) => setTimeout(resolve2, pollInterval));
+      await new Promise((resolve4) => setTimeout(resolve4, pollInterval));
       const updatedTask = await extra.taskStore.getTask(taskId);
       if (!updatedTask) {
         throw new McpError(ErrorCode.InternalError, `Task ${taskId} not found during polling`);
@@ -25149,12 +25149,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve2) => {
+    return new Promise((resolve4) => {
       const json = serializeMessage(message);
       if (this._stdout.write(json)) {
-        resolve2();
+        resolve4();
       } else {
-        this._stdout.once("drain", resolve2);
+        this._stdout.once("drain", resolve4);
       }
     });
   }
@@ -25167,8 +25167,44 @@ var path2 = __toESM(require("node:path"));
 // ../../extensions/redcode/src/exportCache.ts
 var fs = __toESM(require("node:fs"));
 var path = __toESM(require("node:path"));
+function gameStamp(gameDir) {
+  if (!gameDir) return "no game";
+  try {
+    const s = fs.statSync(path.join(gameDir, "bin", "x64", "Cyberpunk2077.exe"));
+    return `${path.resolve(gameDir).toLowerCase()}|${s.size}|${Math.round(s.mtimeMs)}`;
+  } catch {
+    return `${path.resolve(gameDir).toLowerCase()}|no exe`;
+  }
+}
+function checkGameCache(cacheRoot, stamp) {
+  const dir = path.join(cacheRoot, "game");
+  const file = path.join(dir, "stamp.txt");
+  let old;
+  try {
+    old = fs.readFileSync(file, "utf8").trim();
+  } catch {
+  }
+  if (old === stamp) return stamp;
+  fs.rmSync(dir, { recursive: true, force: true });
+  fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(file, `${stamp}
+`);
+  return stamp;
+}
+var checkedStamps = /* @__PURE__ */ new Map();
+async function gameCacheReady(bridge2, cacheRoot) {
+  const info = await bridge2.info();
+  if (!info.gameDir) return void 0;
+  const stamp = gameStamp(info.gameDir);
+  if (checkedStamps.get(cacheRoot) !== stamp) {
+    checkGameCache(cacheRoot, stamp);
+    checkedStamps.set(cacheRoot, stamp);
+  }
+  return stamp;
+}
 async function sourceFile(bridge2, cacheRoot, source) {
   if (source.gamePath) {
+    await gameCacheReady(bridge2, cacheRoot);
     const archiveDir = path.join(cacheRoot, "game", "archive");
     const file2 = path.join(archiveDir, ...source.gamePath.split("\\"));
     if (!fs.existsSync(file2)) await bridge2.extract(source.gamePath, file2);
@@ -25345,11 +25381,11 @@ var BridgeClient = class extends import_node_events.EventEmitter {
     if (!child || child.exitCode !== null) {
       return Promise.resolve();
     }
-    return new Promise((resolve2) => {
-      const timer = setTimeout(resolve2, timeoutMs);
+    return new Promise((resolve4) => {
+      const timer = setTimeout(resolve4, timeoutMs);
       child.once("exit", () => {
         clearTimeout(timer);
-        resolve2();
+        resolve4();
       });
     });
   }
@@ -25376,17 +25412,17 @@ var BridgeClient = class extends import_node_events.EventEmitter {
     return this.call("archive.search", { query, limit });
   }
   /** One level of the archive folder tree. An empty path is the root. */
-  tree(path4 = "") {
-    return this.call("archive.tree", { path: path4 });
+  tree(path6 = "") {
+    return this.call("archive.tree", { path: path6 });
   }
-  extract(path4, outFile) {
-    return this.call("archive.extract", { path: path4, outFile });
+  extract(path6, outFile) {
+    return this.call("archive.extract", { path: path6, outFile });
   }
   extractMany(items) {
     return this.call("archive.extractMany", { items });
   }
-  toJson(path4, outFile) {
-    return this.call("cr2w.toJson", outFile ? { path: path4, outFile } : { path: path4 });
+  toJson(path6, outFile) {
+    return this.call("cr2w.toJson", outFile ? { path: path6, outFile } : { path: path6 });
   }
   /** Converts a CR2W file on disk, for example one in a project, to JSON. */
   fileToJson(file, outFile) {
@@ -25395,8 +25431,8 @@ var BridgeClient = class extends import_node_events.EventEmitter {
   fromJson(outFile, source) {
     return this.call("cr2w.fromJson", { outFile, ...source });
   }
-  toPng(path4, outFile) {
-    return this.call("texture.toPng", { path: path4, outFile });
+  toPng(path6, outFile) {
+    return this.call("texture.toPng", { path: path6, outFile });
   }
   /** Converts a texture file on disk, for example one in a project, to PNG. Needs REDbridge 0.3.0. */
   fileToPng(file, outFile) {
@@ -25415,16 +25451,16 @@ var BridgeClient = class extends import_node_events.EventEmitter {
     return this.call("archive.extractFromMod", { archivePath, items });
   }
   /** Lists the resources inside a mod archive on disk. No game needed. Bridge 0.4.0. */
-  openMod(path4) {
-    return this.call("archive.openMod", { path: path4 });
+  openMod(path6) {
+    return this.call("archive.openMod", { path: path6 });
   }
   /** Exports a file under archiveDir into rawDir at the same relative path, through WolvenKit's exporter. Bridge 0.7.0. */
   exportFile(file, archiveDir, rawDir, options) {
     return this.call("project.export", { file, archiveDir, rawDir, options: options ?? null });
   }
   /** Imports a raw file under rawDir back into archiveDir, through WolvenKit's importer. keep: an existing file keeps its settings. Bridge 0.7.0. */
-  importFile(file, rawDir, archiveDir, keep = true, template) {
-    return this.call("project.import", { file, rawDir, archiveDir, keep, template: template ?? null });
+  importFile(file, rawDir, archiveDir, keep = true, template, texture) {
+    return this.call("project.import", { file, rawDir, archiveDir, keep, template: template ?? null, ...texture !== void 0 ? { texture } : {} });
   }
   /** The sound event names WolvenKit knows, with their Wwise hashes, which name the groups in an .opusinfo. Bridge 0.7.2. */
   soundEvents() {
@@ -25441,11 +25477,11 @@ var BridgeClient = class extends import_node_events.EventEmitter {
   tweakRecords(query) {
     return this.call("tweakdb.records", { ...query });
   }
-  tweakRecord(path4, resolveLocKeys = false, language = "en-us") {
-    return this.call("tweakdb.record", { path: path4, resolveLocKeys, language });
+  tweakRecord(path6, resolveLocKeys = false, language = "en-us") {
+    return this.call("tweakdb.record", { path: path6, resolveLocKeys, language });
   }
-  tweakFlat(path4, resolveLocKeys = false, language = "en-us") {
-    return this.call("tweakdb.flat", { path: path4, resolveLocKeys, language });
+  tweakFlat(path6, resolveLocKeys = false, language = "en-us") {
+    return this.call("tweakdb.flat", { path: path6, resolveLocKeys, language });
   }
   tweakSearch(text, type, limit = 200) {
     return this.call("tweakdb.search", { text, type: type ?? null, limit });
@@ -25458,8 +25494,8 @@ var BridgeClient = class extends import_node_events.EventEmitter {
    * The item records whose look shows a mesh (a game path), and every .app look that shows it. With
    * appearance, only the looks that show that mesh appearance. Loads TweakDB on the first call. Bridge 0.11.0.
    */
-  meshItems(path4, appearance, language = "en-us") {
-    return this.call("mesh.items", { path: path4, appearance: appearance ?? null, language });
+  meshItems(path6, appearance, language = "en-us") {
+    return this.call("mesh.items", { path: path6, appearance: appearance ?? null, language });
   }
   // ---- on-screen texts (bridge 0.10.0) ------------------------------------------------
   /** The languages with on-screen texts in the game, and whether the base game and Phantom Liberty have them. */
@@ -25497,16 +25533,16 @@ var BridgeClient = class extends import_node_events.EventEmitter {
     return this.call("cr2w.documents");
   }
   /** One node by dotted path from the root chunk; an empty path is the root. Arrays page from offset. */
-  getNode(doc, path4 = "", offset = 0, limit = 200) {
-    return this.call("cr2w.getNode", { doc, path: path4, offset, limit });
+  getNode(doc, path6 = "", offset = 0, limit = 200) {
+    return this.call("cr2w.getNode", { doc, path: path6, offset, limit });
   }
   /** Several nodes in one call; a path that fails gives a node of kind "error" whose type holds the message. */
   getNodes(doc, paths, limit = 200) {
     return this.call("cr2w.getNodes", { doc, paths, limit });
   }
   /** Leaves whose text or property name contains the query, below a path. Total counts all; hits holds the first limit. */
-  searchDocument(doc, query, path4 = "", limit = 200) {
-    return this.call("cr2w.search", { doc, query, path: path4, limit });
+  searchDocument(doc, query, path6 = "", limit = 200) {
+    return this.call("cr2w.search", { doc, query, path: path6, limit });
   }
   /** Applies the operations atomically and returns the inverse, for undo. */
   patch(doc, ops) {
@@ -25532,8 +25568,359 @@ var BridgeClient = class extends import_node_events.EventEmitter {
   }
 };
 
+// ../../extensions/redcode/src/library.ts
+var import_node_child_process2 = require("node:child_process");
+var import_node_crypto = require("node:crypto");
+var fs3 = __toESM(require("node:fs"));
+var os = __toESM(require("node:os"));
+var path3 = __toESM(require("node:path"));
+function libraryConfigFile() {
+  return path3.join(process.env.APPDATA ?? path3.join(os.homedir(), "AppData", "Roaming"), "EDGE", "library.json");
+}
+function readLibraryRoot(file = libraryConfigFile()) {
+  try {
+    const root = JSON.parse(fs3.readFileSync(file, "utf8")).root;
+    return typeof root === "string" && root.trim() ? root.trim() : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function writeLibraryRoot(root, file = libraryConfigFile()) {
+  root = path3.resolve(root);
+  fs3.mkdirSync(root, { recursive: true });
+  let data = {};
+  try {
+    data = JSON.parse(fs3.readFileSync(file, "utf8"));
+  } catch {
+  }
+  fs3.mkdirSync(path3.dirname(file), { recursive: true });
+  fs3.writeFileSync(file, JSON.stringify({ ...data, root }, null, 2));
+  return root;
+}
+function documentsFolder() {
+  const fallback = path3.join(os.homedir(), "Documents");
+  if (process.platform !== "win32") return fallback;
+  try {
+    const out = (0, import_node_child_process2.execFileSync)("reg", ["query", "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\User Shell Folders", "/v", "Personal"], { encoding: "utf8", windowsHide: true, timeout: 5e3 });
+    const m = /Personal\s+REG_(?:EXPAND_)?SZ\s+(.+)/.exec(out);
+    if (!m) return fallback;
+    return m[1].trim().replace(/%([^%]+)%/g, (all, name) => process.env[name] ?? all);
+  } catch {
+    return fallback;
+  }
+}
+function suggestedLibraryRoot() {
+  return path3.join(documentsFolder(), "EDGE Library");
+}
+var ItemEnding = /\.(asset|bake)$/i;
+function libraryFolders(root, cap = 2e3) {
+  const found = [];
+  const walk = (dir, rel, depth) => {
+    let entries;
+    try {
+      entries = fs3.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const e of entries) {
+      if (found.length >= cap) return;
+      if (!e.isDirectory() || e.name.startsWith(".") || ItemEnding.test(e.name)) continue;
+      const child = rel ? `${rel}/${e.name}` : e.name;
+      found.push(child);
+      if (depth < 16) walk(path3.join(dir, e.name), child, depth + 1);
+    }
+  };
+  walk(root, "", 0);
+  return found.sort((a, b) => a.localeCompare(b, void 0, { sensitivity: "base" }));
+}
+function safeFolder(folder) {
+  const parts = (folder ?? "").split(/[\\/]+/).filter((p) => p !== "");
+  for (const p of parts) {
+    if (p === "." || p === "..") throw new Error(`A Library folder cannot go through "${p}": ${folder}`);
+    if (/[<>:"|?*\u0000-\u001f]/.test(p) || /[. ]$/.test(p)) throw new Error(`Not a folder name: "${p}"`);
+    if (ItemEnding.test(p)) throw new Error(`"${p}" is a Library item, not a folder.`);
+  }
+  return parts.join("/");
+}
+function isInside(child, parent) {
+  const rel = path3.relative(parent, child);
+  return rel === "" || !rel.startsWith("..") && !path3.isAbsolute(rel);
+}
+var versions = /* @__PURE__ */ new Map();
+function gameVersionOf(gameDir) {
+  if (!gameDir) return Promise.resolve(void 0);
+  let v = versions.get(gameDir);
+  if (!v) {
+    const exe = path3.join(gameDir, "bin", "x64", "Cyberpunk2077.exe");
+    v = new Promise((resolve4) => {
+      (0, import_node_child_process2.execFile)(
+        "powershell.exe",
+        ["-NoProfile", "-NonInteractive", "-Command", `(Get-Item -LiteralPath '${exe.replace(/'/g, "''")}').VersionInfo.ProductVersion`],
+        { windowsHide: true, timeout: 15e3 },
+        (e, out) => resolve4(e ? void 0 : out.trim() || void 0)
+      );
+    });
+    versions.set(gameDir, v);
+  }
+  return v;
+}
+var TakenTypes = /* @__PURE__ */ new Set(["mesh", "ent", "app", "mi", "mlsetup", "mlmask", "xbm"]);
+var ReadTypes = /* @__PURE__ */ new Set(["mesh", "ent", "app", "mi", "mlsetup"]);
+var SharedFolders = /^(engine|(base|ep1)\\(surfaces|materials|fx))\\/i;
+var typeOf = (p) => path3.win32.extname(p).slice(1).toLowerCase();
+function assetTakes(gamePath) {
+  return TakenTypes.has(typeOf(gamePath)) && !SharedFolders.test(gamePath);
+}
+function safeGamePath(p) {
+  const parts = p.split(/[\\/]+/);
+  if (!parts.length || parts.some((s) => s === "" || s === "." || s === ".." || /[<>:"|?*\u0000-\u001f]/.test(s))) return void 0;
+  return parts.join("\\");
+}
+function referencesIn(json) {
+  const named = /* @__PURE__ */ new Set();
+  let unnamed = 0;
+  const walk = (v) => {
+    if (Array.isArray(v)) {
+      for (const x of v) walk(x);
+    } else if (v && typeof v === "object") {
+      const o = v;
+      if (o.$type === "ResourcePath") {
+        if (o.$storage === "string" && typeof o.$value === "string" && o.$value) named.add(o.$value);
+        else if (o.$value && o.$value !== "0") unnamed++;
+        return;
+      }
+      for (const k of Object.keys(o)) walk(o[k]);
+    }
+  };
+  walk(json);
+  return { named, unnamed };
+}
+function kindOf(gamePath) {
+  const kind = typeOf(gamePath);
+  if (!/^[a-z0-9_]+$/.test(kind)) throw new Error(`${gamePath} has no file type, so it cannot be a Library asset.`);
+  return kind;
+}
+var projectFile = (dir, gamePath) => path3.join(dir, "source", "archive", ...gamePath.split("\\"));
+async function planAsset(b, source) {
+  const main2 = safeGamePath(source.path);
+  if (!main2) throw new Error(`Not a game path: ${source.path}`);
+  kindOf(main2);
+  const plan = { main: main2, take: [], stay: [], unread: [], badPaths: [], unnamed: 0 };
+  const seen = /* @__PURE__ */ new Set();
+  const queue = [main2];
+  while (queue.length) {
+    const p = queue.shift();
+    const key = p.toLowerCase();
+    if (seen.has(key)) continue;
+    seen.add(key);
+    if (p !== main2 && !assetTakes(p)) {
+      plan.stay.push(p);
+      continue;
+    }
+    plan.take.push(p);
+    if (!ReadTypes.has(typeOf(p))) continue;
+    let text;
+    try {
+      const own = source.project && projectFile(source.project.dir, p);
+      text = (own && fs3.existsSync(own) ? await b.fileToJson(own) : await b.toJson(p)).json;
+    } catch (e) {
+      if (p === main2) throw e;
+      plan.unread.push(p);
+      continue;
+    }
+    if (text === null) {
+      plan.unread.push(p);
+      continue;
+    }
+    const refs = referencesIn(JSON.parse(text));
+    plan.unnamed += refs.unnamed;
+    for (const r of refs.named) {
+      const safe = safeGamePath(r);
+      if (safe) queue.push(safe);
+      else plan.badPaths.push(r);
+    }
+  }
+  plan.stay.sort();
+  return plan;
+}
+var ItemExists = class extends Error {
+  constructor(item) {
+    super(`${path3.basename(item)} is already in the Library: ${item}`);
+    this.item = item;
+  }
+  item;
+};
+function itemFolder(root, folder, main2, gamePathFolders) {
+  const gameFolders = gamePathFolders ? main2.split("\\").slice(0, -1) : [];
+  return path3.join(root, ...safeFolder(folder).split("/").filter(Boolean), ...gameFolders, itemName(main2));
+}
+var stemOf = (main2) => path3.win32.basename(main2, path3.win32.extname(main2));
+function itemName(main2) {
+  return `${stemOf(main2).toLowerCase()}.${kindOf(main2)}.asset`;
+}
+function freeFolder(wanted) {
+  const parent = path3.dirname(wanted);
+  const m = /^(.*)(\.[^.]+\.asset)$/.exec(path3.basename(wanted));
+  for (let n = 2; ; n++) {
+    const next = path3.join(parent, `${m[1]}_${n}${m[2]}`);
+    if (!fs3.existsSync(next)) return next;
+  }
+}
+function readAssetJson(item) {
+  try {
+    return JSON.parse(fs3.readFileSync(path3.join(item, "asset.json"), "utf8"));
+  } catch {
+    return {};
+  }
+}
+function filesUnder(dir) {
+  return fs3.readdirSync(dir, { withFileTypes: true }).flatMap((e) => e.isDirectory() ? filesUnder(path3.join(dir, e.name)) : [path3.join(dir, e.name)]);
+}
+async function renameFolder(from, to, waits = [50, 100, 200, 400, 800, 1600, 3200, 6400]) {
+  for (let i = 0; ; i++) {
+    try {
+      fs3.renameSync(from, to);
+      return;
+    } catch (e) {
+      const code = e.code;
+      if (code !== "EPERM" && code !== "EACCES" && code !== "EBUSY") throw e;
+      if (i >= waits.length) throw new Error(`Could not move ${from} to ${to}: something has a file in it open, such as an antivirus or the search indexer. Try again in a moment. (${code})`);
+      await new Promise((resolve4) => setTimeout(resolve4, waits[i]));
+    }
+  }
+}
+async function writeAsset(b, source, plan, opts) {
+  const root = path3.resolve(opts.root);
+  if (opts.gameDir && isInside(root, opts.gameDir)) throw new Error(`The Library must not be inside the game's folder: ${root}`);
+  let item = itemFolder(root, opts.folder, plan.main, opts.gamePathFolders);
+  const had = fs3.existsSync(item);
+  if (had && (opts.ifExists ?? "stop") === "stop") throw new ItemExists(item);
+  if (had && opts.ifExists === "another") item = freeFolder(item);
+  const replacing = had && opts.ifExists === "replace" ? readAssetJson(item) : void 0;
+  const parent = path3.dirname(item);
+  fs3.mkdirSync(parent, { recursive: true });
+  const tag = (0, import_node_crypto.randomBytes)(6).toString("hex");
+  const building = path3.join(parent, `.redcode-add-${tag}`);
+  const archive = path3.join(building, "source", "archive");
+  try {
+    fs3.mkdirSync(archive, { recursive: true });
+    const out = (p) => path3.join(archive, ...p.split("\\"));
+    const fromGame = [];
+    let files = 0;
+    let bytes = 0;
+    for (const p of plan.take) {
+      const own = source.project && projectFile(source.project.dir, p);
+      if (own && fs3.existsSync(own)) {
+        fs3.mkdirSync(path3.dirname(out(p)), { recursive: true });
+        fs3.copyFileSync(own, out(p));
+        files++;
+        bytes += fs3.statSync(own).size;
+      } else {
+        fromGame.push(p);
+      }
+    }
+    let missing = [];
+    if (fromGame.length) {
+      const got = await b.extractMany(fromGame.map((p) => ({ path: p, outFile: out(p) })));
+      files += got.extracted;
+      bytes += got.bytes;
+      missing = got.failed;
+    }
+    if (missing.some((m) => m.toLowerCase() === plan.main.toLowerCase())) throw new Error(`Could not get ${plan.main} from the game.`);
+    const stem = stemOf(plan.main);
+    const inGame = !source.project || !fs3.existsSync(projectFile(source.project.dir, plan.main)) || await existsInGame(b, plan.main);
+    const entry = { tool: opts.tool, did: replacing ? source.project ? `Replaced from project ${source.project.name}` : "Replaced from the game" : source.project ? `Added from project ${source.project.name}` : "Added from the game", date: (/* @__PURE__ */ new Date()).toISOString() };
+    const asset = {
+      format: 1,
+      id: replacing?.id ?? (0, import_node_crypto.randomBytes)(8).toString("hex"),
+      name: replacing?.name ?? stem,
+      kind: kindOf(plan.main),
+      main: plan.main,
+      version: (replacing?.version ?? 0) + 1,
+      from: source.project ? { project: source.project.name, path: plan.main } : { game: plan.main, gameVersion: opts.gameVersion ?? null },
+      // The asset's own terms, in the shape EDGEfab's assets have when they are not the game's.
+      license: inGame ? "game" : { source: "own", note: "From a REDcode project: record its source and terms before releasing it." },
+      history: [...replacing?.history ?? [], entry]
+    };
+    fs3.writeFileSync(path3.join(building, "asset.json"), JSON.stringify(asset, null, 2) + "\n");
+    const longPaths = filesUnder(building).filter((f) => item.length + f.length - building.length > 259).length;
+    if (replacing) {
+      const old = path3.join(parent, `.redcode-old-${tag}`);
+      await renameFolder(item, old);
+      try {
+        await renameFolder(building, item);
+      } catch (e) {
+        await renameFolder(old, item);
+        throw e;
+      }
+      fs3.rmSync(old, { recursive: true, force: true, maxRetries: 5, retryDelay: 200 });
+    } else {
+      await renameFolder(building, item);
+    }
+    const relative3 = path3.relative(root, item).split(path3.sep).join("/");
+    return { item, relative: relative3, id: asset.id, kind: asset.kind, main: plan.main, version: asset.version, files, bytes, stay: plan.stay, missing, unread: plan.unread, badPaths: plan.badPaths, unnamed: plan.unnamed, longPaths };
+  } finally {
+    fs3.rmSync(building, { recursive: true, force: true, maxRetries: 5, retryDelay: 200 });
+  }
+}
+async function existsInGame(b, gamePath) {
+  return b.toJson(gamePath).then(
+    () => true,
+    () => false
+  );
+}
+
+// ../../extensions/redcode/src/project.ts
+var fs4 = __toESM(require("node:fs"));
+var path4 = __toESM(require("node:path"));
+var ProjectFolders = {
+  archive: path4.join("source", "archive"),
+  raw: path4.join("source", "raw"),
+  resources: path4.join("source", "resources"),
+  /** REDmod custom sounds, named in source/resources/info.json. Made by the tool that writes the first one, not by a new project. */
+  customSounds: path4.join("source", "customSounds"),
+  /** EDGEbuilder's scenes (<name>.scene.json, REDcode issue #2). Made by EDGEbuilder; not packed. */
+  scenes: path4.join("source", "scenes"),
+  packed: "packed"
+};
+function findProject(dir) {
+  let entries;
+  try {
+    entries = fs4.readdirSync(dir);
+  } catch {
+    return void 0;
+  }
+  const file = entries.find((e) => e.toLowerCase().endsWith(".cpmodproj"));
+  return file ? readProject(path4.join(dir, file)) : void 0;
+}
+function readProject(file) {
+  const xml = fs4.readFileSync(file, "utf8");
+  const get = (tag) => {
+    const m = xml.match(new RegExp(`<${tag}>([\\s\\S]*?)</${tag}>`));
+    return m ? unescapeXml(m[1].trim()) : "";
+  };
+  const name = get("Name") || path4.basename(file, path4.extname(file));
+  return {
+    file,
+    dir: path4.dirname(file),
+    name,
+    modName: get("ModName") || name,
+    author: get("Author"),
+    email: get("Email"),
+    description: get("Description"),
+    version: get("Version") || "1.0.0"
+  };
+}
+function gamePathOf(project, file) {
+  const root = path4.join(project.dir, ProjectFolders.archive) + path4.sep;
+  return file.startsWith(root) ? file.slice(root.length).split(path4.sep).join("\\") : void 0;
+}
+function unescapeXml(s) {
+  return s.replace(/&quot;/g, '"').replace(/&gt;/g, ">").replace(/&lt;/g, "<").replace(/&amp;/g, "&");
+}
+
 // src/server.ts
-var Version = "0.4.0";
+var Version = "0.5.0";
 function arg(name) {
   const i = process.argv.indexOf(name);
   return i >= 0 ? process.argv[i + 1] || void 0 : void 0;
@@ -25542,11 +25929,11 @@ function env(name) {
   return process.env[name]?.trim() || void 0;
 }
 function vscodeSetting(key) {
-  const base = process.platform === "win32" ? process.env.APPDATA : process.platform === "darwin" ? path3.join(process.env.HOME ?? "", "Library/Application Support") : path3.join(process.env.HOME ?? "", ".config");
+  const base = process.platform === "win32" ? process.env.APPDATA : process.platform === "darwin" ? path5.join(process.env.HOME ?? "", "Library/Application Support") : path5.join(process.env.HOME ?? "", ".config");
   if (!base) return void 0;
-  const file = path3.join(base, "Code", "User", "settings.json");
+  const file = path5.join(base, "Code", "User", "settings.json");
   try {
-    const text = fs3.readFileSync(file, "utf8");
+    const text = fs5.readFileSync(file, "utf8");
     const match = text.match(new RegExp(`"${key.replace(/\./g, "\\.")}"\\s*:\\s*"((?:[^"\\\\]|\\\\.)*)"`));
     return match ? JSON.parse(`"${match[1]}"`) || void 0 : void 0;
   } catch {
@@ -25555,8 +25942,8 @@ function vscodeSetting(key) {
 }
 function resolveBridgeExe() {
   let exe = arg("--bridge") ?? env("REDBRIDGE_EXE") ?? vscodeSetting("redcode.bridgePath") ?? "REDbridge.exe";
-  if (exe && fs3.existsSync(exe) && fs3.statSync(exe).isDirectory()) {
-    exe = path3.join(exe, "REDbridge.exe");
+  if (exe && fs5.existsSync(exe) && fs5.statSync(exe).isDirectory()) {
+    exe = path5.join(exe, "REDbridge.exe");
   }
   return exe;
 }
@@ -25688,8 +26075,47 @@ tool("project_import", "Import a raw file under a project's source/raw back into
   rawDir: external_exports.string().describe("The project's source/raw folder."),
   archiveDir: external_exports.string().describe("The project's source/archive folder."),
   keep: external_exports.boolean().optional().describe("Keep the replaced file's settings; default true."),
-  template: external_exports.string().optional().describe("For a GLB with no mesh to import over: a game path (base\\...mesh) or a .mesh file to start the new mesh from.")
-}, (a, b) => b.importFile(a.file, a.rawDir, a.archiveDir, a.keep ?? true, a.template));
+  template: external_exports.string().optional().describe("For a GLB with no mesh to import over: a game path (base\\...mesh) or a .mesh file to start the new mesh from."),
+  texture: external_exports.union([
+    external_exports.string(),
+    external_exports.object({
+      group: external_exports.string().optional(),
+      compression: external_exports.string().optional(),
+      rawFormat: external_exports.string().optional(),
+      isGamma: external_exports.boolean().optional(),
+      hasMipchain: external_exports.boolean().optional(),
+      isStreamable: external_exports.boolean().optional()
+    })
+  ]).optional().describe("For an image import: the .xbm's setup. A preset (color, normal, grayscale), a texture group name (TEXG_Generic_UI), or { group, compression, rawFormat, isGamma, hasMipchain, isStreamable } with the game's enum names, the rest from the group's defaults. Wins over the existing texture's setup; the answer's texture is the setup read back. Bridge 0.12.0.")
+}, (a, b) => b.importFile(a.file, a.rawDir, a.archiveDir, a.keep ?? true, a.template, a.texture));
+tool("library_add", "Add a game file or a project's file to the EDGE Library, the modder's store shared by every EDGE tool, as one asset item: <name>.<kind>.asset with asset.json and source/archive holding the file and the files it needs (a mesh's materials and textures; an entity's appearances and meshes), at their game paths. Game-wide files (base materials, templates, surfaces, effects, rigs) stay in the game and are referred to. Returns the item's folder, id, version, the files copied, those that stay, and those it names that are not in the game (the game's own files name some such). Writes outside the game, in the modder's Library only. With no Library yet, it answers where one would go: ask the modder, then call again with root. With no folder, it answers the modder's folders: ask which, or pass the folder, since the folders are theirs and tools never pick one on their own.", {
+  path: external_exports.string().describe("A game path (base\\...\\comfy_rocker.mesh), or the full path of a file under a WolvenKit project's source/archive, whose project copies then win over the game's."),
+  folder: external_exports.string().optional().describe("A folder under the Library's root, with /, for example Production/Meshes; made if missing. An empty string is the root itself."),
+  gamePathFolders: external_exports.boolean().optional().describe("Puts the item in its game path's folders under the folder, each made if missing: <folder>/base/.../comfy_rocker.mesh.asset, so the Library browses like the game's files. The modder's choice."),
+  root: external_exports.string().optional().describe("Only when there is no Library yet: where to make it, written to %APPDATA%\\EDGE\\library.json for every EDGE tool. Ask the modder first."),
+  ifExists: external_exports.enum(["stop", "replace", "another"]).optional().describe("When the item is there already: stop (default), another (a second item beside it), or replace (a new copy, version raised, id kept; anything changed in the item since is lost, so ask the modder first)."),
+  allowLarge: external_exports.boolean().optional().describe("Copy more than 500 files. An entity's walk can reach that; check with the modder first.")
+}, async (a, b) => {
+  const known = readLibraryRoot();
+  if (a.root && known) throw new Error(`The EDGE Library is already at ${known}. Leave root out; moving it is Relocate, in EDGEbuilder.`);
+  if (!a.root && !known) return { needsRoot: true, suggested: suggestedLibraryRoot(), note: "No EDGE Library yet. Ask the modder where it should go, then call again with root." };
+  const info = await b.info();
+  if (a.root && info.gameDir && isInside(path5.resolve(a.root), info.gameDir)) throw new Error("The EDGE Library cannot be inside the game's folder.");
+  const root = known ?? writeLibraryRoot(a.root);
+  if (a.folder === void 0) return { needsFolder: true, root, folders: libraryFolders(root), note: "Ask the modder which folder, or for a new one, then call again with folder (an empty string is the root)." };
+  const source = { path: a.path };
+  if (path5.isAbsolute(a.path)) {
+    const m = /^(.*?)[\\/]source[\\/]archive[\\/]/i.exec(a.path);
+    const project = m ? findProject(m[1]) : void 0;
+    const gamePath = project && gamePathOf(project, path5.normalize(a.path));
+    if (!project || !gamePath) throw new Error(`${a.path} is not under a WolvenKit project's source/archive.`);
+    source.path = gamePath;
+    source.project = { name: project.name, dir: project.dir };
+  }
+  const plan = await planAsset(b, source);
+  if (plan.take.length > 500 && !a.allowLarge) throw new Error(`${plan.main} needs ${plan.take.length} files. Check with the modder, then pass allowLarge.`);
+  return writeAsset(b, source, plan, { root, folder: a.folder, gamePathFolders: a.gamePathFolders, ifExists: a.ifExists, tool: `redcode-mcp ${Version}`, gameVersion: await gameVersionOf(info.gameDir), gameDir: info.gameDir });
+});
 tool("project_pack", "Pack a folder (a project's source/archive) into <modName>.archive in outDir through WolvenKit's packer. Returns the archive path, size, file count and warnings for paths with capital letters or spaces. Bridge 0.6.1.", {
   dir: external_exports.string().describe("The folder to pack, laid out as game paths (base/..., ep1/...)."),
   outDir: external_exports.string().describe("Where the archive goes, usually packed/archive/pc/mod."),
@@ -25750,13 +26176,13 @@ tool("loc_get", `The texts for LocKeys, by number or secondary key, with or with
   language: external_exports.string().optional(),
   projectDir: external_exports.string().optional()
 }, (a, b) => b.locGet(a.keys, a.language ?? "en-us", a.projectDir));
-var soundCache = path3.join(os.tmpdir(), "redcode-mcp", "sounds");
+var soundCache = path5.join(os2.tmpdir(), "redcode-mcp", "sounds");
 var soundIndex;
 async function gameSounds(b) {
   if (!soundIndex) {
-    const file = path3.join(soundCache, "sfx_container.opusinfo");
-    if (!fs3.existsSync(file)) await b.extract(GameSoundIndex, file);
-    soundIndex = parseOpusInfo(fs3.readFileSync(file));
+    const file = path5.join(soundCache, "sfx_container.opusinfo");
+    if (!fs5.existsSync(file)) await b.extract(GameSoundIndex, file);
+    soundIndex = parseOpusInfo(fs5.readFileSync(file));
   }
   return soundIndex;
 }
@@ -25796,12 +26222,12 @@ tool("sound_extract", "Write game sound effects as .opus files (Ogg Opus, 48 kHz
   } else {
     throw new Error("event or sounds is required");
   }
-  fs3.mkdirSync(a.outDir, { recursive: true });
+  fs5.mkdirSync(a.outDir, { recursive: true });
   const written = [];
   for (const i of picks) {
     const bytes = await opusSound(b, soundCache, { gamePath: GameSoundIndex }, index, i);
-    const file = path3.join(a.outDir, `${index.hashes[i]}.opus`);
-    fs3.writeFileSync(file, bytes);
+    const file = path5.join(a.outDir, `${index.hashes[i]}.opus`);
+    fs5.writeFileSync(file, bytes);
     const f = audioFormat(bytes);
     written.push({ file, bytes: bytes.length, channels: f.channels });
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edgemodders/redcode-mcp",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Cyberpunk 2077 modding tools for AI assistants over MCP: the game archives, CR2W files as JSON and node-by-node edits, textures, TweakDB, game sounds, export, import and pack, through REDbridge and WolvenKit's engine.",
   "license": "MIT",
   "author": "Edgemodders",