@energy8platform/golem 0.6.0 → 0.7.0

package/dist/lib/rig-import-layers.d.ts

@@ -28,5 +28,7 @@ export interface LayerSpec {
     blend?: "normal" | "add" | "multiply" | "screen";
 }
 export declare function pngSize(buf: Buffer): [number, number];
+/** `file`, named by a sidecar inside `dir` (layers.json, a Spine atlas), leaves `dir`: absolute or climbing out. */
+export declare function outsideDir(dir: string, file: string): boolean;
 export declare function importLayers(doc: Doc, dir: string, relPrefix?: string): Promise<Doc>;
 export {};

package/dist/lib/rig-version.d.ts

@@ -0,0 +1,12 @@
+import { type ToolResult } from "./rig-api";
+/** `mtimeMs:size` of the file, or "missing" */
+export declare function rigVersion(abs: string): Promise<string>;
+/**
+ * callTool with the rig's version just before and just after, both read inside the rig's queue, so no other writer in
+ * this process lands between them. `args.path` must be absolute; a call without one reads "missing" twice.
+ */
+export declare function callToolVersioned(name: string, args: Record<string, unknown>): Promise<{
+    result: ToolResult;
+    before: string;
+    after: string;
+}>;

package/dist/lib/tool-schema.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from "./rig-api";
+/** draft-07, every ref inlined, no `$schema` key — the tool's own strict zod object, so unknown keys stay refused */
+export declare function jsonSchemaOf(tool: ToolDef): Record<string, unknown>;

package/dist/lib/tools.d.ts

@@ -1,2 +1,4 @@
 /** `@energy8platform/golem/tools` — the tool registry (node): MCP, CLI and the editor call the same list. */
 export { tools, callTool, closeTools, type ToolDef, type ToolResult } from "./rig-api";
+export { rigVersion, callToolVersioned } from "./rig-version";
+export { jsonSchemaOf } from "./tool-schema";

package/dist/lib/tools.js

@@ -1,7 +1,7 @@
 // src/rig-api.ts
 import { z as z3 } from "zod";
 import { readFile as readFile9, writeFile as writeFile7, stat as stat2, mkdir as mkdir6, readdir as readdir4 } from "node:fs/promises";
-import { dirname as dirname8, join as join9, relative as relative2, isAbsolute } from "node:path";
+import { dirname as dirname8, join as join9, relative as relative3, isAbsolute as isAbsolute2 } from "node:path";
 
 // src/rig-io.ts
 import { mkdir, rename, rm, writeFile } from "node:fs/promises";
@@ -24,8 +24,10 @@ var saveJson = (path, value) => saveBytes(path, JSON.stringify(value, null, 2));
 // src/rig-queue.ts
 import { AsyncLocalStorage } from "node:async_hooks";
 import { resolve } from "node:path";
-var pending = /* @__PURE__ */ new Map();
-var active = new AsyncLocalStorage();
+var { pending, active } = globalThis[Symbol.for("golem.rigQueue")] ??= {
+  pending: /* @__PURE__ */ new Map(),
+  active: new AsyncLocalStorage()
+};
 async function withRigQueue(path, op) {
   const key = resolve(path);
   const held = active.getStore();
@@ -2001,8 +2003,9 @@ function createDoc(name, width, height, notes) {
 function createSymbol(name, asset, margin = 0.15, notes) {
   const mx = Math.ceil(asset.width * margin), my = Math.ceil(asset.height * margin);
   const width = asset.width + 2 * mx, height = asset.height + 2 * my;
-  const fromFile = asset.src.replace(/^.*\//, "").replace(/\.[^.]+$/, "").toLowerCase().replace(/[^a-z0-9_]/g, "_").replace(/^[^a-z]+/, "");
-  const id = asset.id ?? (fromFile || name);
+  const stem = asset.src.replace(/^.*\//, "").replace(/\.[^.]+$/, "").toLowerCase().replace(/[^a-z0-9_]/g, "_");
+  const fromFile = stem.replace(/^[^a-z]+/, "") || (stem ? `symbol_${stem}` : "");
+  const id = asset.id ?? (ID_RE.test(fromFile) ? fromFile : ID_RE.test(name) ? name : "symbol");
   let doc = createDoc(name, width, height, notes);
   doc = { ...doc, bones: [{ ...doc.bones[0], transform: { ...doc.bones[0].transform, x: width / 2, y: height - my } }] };
   doc = { ...doc, assets: [RigSchema.shape.assets.element.parse({ id, src: asset.src, width: asset.width, height: asset.height })] };
@@ -2758,7 +2761,7 @@ function setGoal(doc, bone, x, y, opts) {
 
 // src/rig-import-layers.ts
 import { readdir, readFile } from "node:fs/promises";
-import { join as join2, basename as basename2 } from "node:path";
+import { join as join2, basename as basename2, isAbsolute, relative, sep } from "node:path";
 var DEFAULT_PARENT = {
   head: "neck",
   neck: "torso",
@@ -2784,6 +2787,10 @@ function pngSize(buf) {
   if (buf.readUInt32BE(12) !== 1229472850) throw new Error("not a PNG (IHDR missing)");
   return [buf.readUInt32BE(16), buf.readUInt32BE(20)];
 }
+function outsideDir(dir, file) {
+  const r = relative(dir, join2(dir, file));
+  return isAbsolute(file) || r === ".." || r.startsWith(".." + sep);
+}
 async function importLayers(doc, dir, relPrefix = "layers") {
   let specs;
   try {
@@ -2796,6 +2803,7 @@ async function importLayers(doc, dir, relPrefix = "layers") {
   let next = doc;
   const parsed = [];
   for (const s of specs) {
+    if (outsideDir(dir, s.file)) throw new Error(`layers.json file "${s.file}" is outside the layers folder (${dir})`);
     const buf = await readFile(join2(dir, s.file));
     const [w, h] = pngSize(buf);
     const m = basename2(s.file, ".png").match(/^(?:(\d+)_)?(.+)$/);
@@ -4052,7 +4060,7 @@ async function buildAtlas(doc, assetsDir, outDir, opts = {}) {
 
 // src/spine-import.ts
 import { readFile as readFile7, stat, writeFile as writeFile5 } from "node:fs/promises";
-import { basename as basename4, dirname as dirname6, extname, join as join8, relative } from "node:path";
+import { basename as basename4, dirname as dirname6, extname, join as join8, relative as relative2 } from "node:path";
 
 // src/ktx2.ts
 import { readFile as readFile6 } from "node:fs/promises";
@@ -4858,6 +4866,7 @@ async function importSpineProject(opts) {
   const rigDir = dirname6(opts.rigPath);
   const pagePaths = /* @__PURE__ */ new Map();
   for (const page2 of pages) {
+    if (!opts.image && outsideDir(dirname6(atlasPath), page2.name)) throw new Error(`atlas page "${page2.name}" is outside the atlas folder (${dirname6(atlasPath)})`);
     const pageStem = join8(dirname6(atlasPath), page2.name.replace(/\.[a-z0-9]+$/i, ""));
     const imagePath = opts.image ?? await firstExisting([join8(dirname6(atlasPath), page2.name), pageStem + ".png", pageStem + ".ktx2", ...pages.length === 1 ? [stem + ".png", stem + ".ktx2"] : []], `atlas page image ${page2.name}`);
     let pngPath = imagePath;
@@ -4870,7 +4879,7 @@ async function importSpineProject(opts) {
     }
     pagePaths.set(page2.name, pngPath);
   }
-  const pageImage = (page2) => relative(rigDir, pagePaths.get(page2)).split("\\").join("/");
+  const pageImage = (page2) => relative2(rigDir, pagePaths.get(page2)).split("\\").join("/");
   const name = opts.name ?? basename4(stem);
   const imagePaths = [...pagePaths.values()];
   return { ...importSpine(json, atlasText, { name, skin: opts.skin, pageImage, margin: opts.margin, notes: opts.notes }), imagePath: imagePaths[0], imagePaths };
@@ -5563,8 +5572,8 @@ async function load(path) {
 }
 var save = (path, doc) => saveJson(path, doc);
 var exists2 = (p) => stat2(p).then(() => true, () => false);
-var resolveFrom = (rigPath, p) => isAbsolute(p) ? p : join9(dirname8(rigPath), p);
-var srcFor = (rigPath, file) => relative2(dirname8(rigPath), file).split("\\").join("/");
+var resolveFrom = (rigPath, p) => isAbsolute2(p) ? p : join9(dirname8(rigPath), p);
+var srcFor = (rigPath, file) => relative3(dirname8(rigPath), file).split("\\").join("/");
 var libraryFor = (rigPath, lib) => lib ? resolveFrom(rigPath, lib) : join9(dirname8(rigPath), "presets.json");
 async function pngInfo(rigPath, file) {
   const abs = resolveFrom(rigPath, file);
@@ -6588,9 +6597,39 @@ tool(
     }
   }
 );
+
+// src/rig-version.ts
+import { stat as stat3 } from "node:fs/promises";
+async function rigVersion(abs) {
+  try {
+    const s = await stat3(abs);
+    return `${s.mtimeMs}:${s.size}`;
+  } catch {
+    return "missing";
+  }
+}
+async function callToolVersioned(name, args) {
+  const path = typeof args.path === "string" ? args.path : void 0;
+  if (!path) return { result: await callTool(name, args), before: "missing", after: "missing" };
+  return withRigQueue(path, async () => {
+    const before = await rigVersion(path);
+    const result = await callTool(name, args);
+    return { result, before, after: await rigVersion(path) };
+  });
+}
+
+// src/tool-schema.ts
+import { zodToJsonSchema } from "zod-to-json-schema";
+function jsonSchemaOf(tool2) {
+  const { $schema: _drop, ...schema } = zodToJsonSchema(tool2.input, { $refStrategy: "none" });
+  return schema;
+}
 export {
   callTool,
+  callToolVersioned,
   closeTools,
+  jsonSchemaOf,
+  rigVersion,
   tools
 };
 //# sourceMappingURL=tools.js.map