@instruktlabs/kiln 1.0.0 → 1.1.0

package/dist/build.json

@@ -2,12 +2,12 @@
   "schemaVersion": 1,
   "entries": {
     "worker": {
-      "identity": "sha256:81875ff0bc5f7b4b952f2bb32ffa11d9b4e2ee7067f1ccd458f6ec0aec455538",
-      "engineVersion": "1.0.0",
+      "identity": "sha256:adbc219831fef0d5cac0d2050a8171a3fd11860bb632b0e27545ed1cd571acfc",
+      "engineVersion": "1.1.0",
       "toolchain": "bun@1.4.2",
-      "sourceHash": "83b57574766f2e278eeee58d8b923b9bfc642a6832f2d1c137408b2b389acc7f",
+      "sourceHash": "31bf69f080bbcca05a98b7c485b5642e90e7f63625f4b03d89a91fbbb5f81e9c",
       "rendererSourceHash": "27927c48b377f7694251a76c0cecd05216fcbbb8a7d03e8bf2bd681dabb5573a",
-      "dependencyHash": "182eedef24fb67faae8fed2506e5ad51afee511fdcbce8fb8c709c3cc6fd91f9",
+      "dependencyHash": "bb179f2715f8fd9059898ef3a2028947e8f5f7e7979ad7eafe59d7a464c18f9f",
       "dependencies": {
         "@gltf-transform/core": "4.5.1",
         "@gltf-transform/extensions": "4.5.1",
@@ -19,10 +19,12 @@
         "acorn": "^8.18.0",
         "acorn-walk": "^8.3.5",
         "gltf-validator": "2.0.0-dev.3.10",
+        "jsonc-parser": "3.3.1",
         "manifold-3d": "^3.5.4",
         "minisearch": "7.2.0",
         "pngjs": "7.0.0",
         "sharp": "^0.35.5",
+        "smol-toml": "1.9.0",
         "three": "0.186.1",
         "three-subdivide": "1.1.5",
         "xatlasjs": "^0.2.0",
@@ -37,12 +39,12 @@
       "bundleHash": "sha256:37098a17b5304a5f5746131c9652498d937a5181c0fb0975861dec999721d5be"
     },
     "agent-run": {
-      "identity": "sha256:81875ff0bc5f7b4b952f2bb32ffa11d9b4e2ee7067f1ccd458f6ec0aec455538",
-      "engineVersion": "1.0.0",
+      "identity": "sha256:adbc219831fef0d5cac0d2050a8171a3fd11860bb632b0e27545ed1cd571acfc",
+      "engineVersion": "1.1.0",
       "toolchain": "bun@1.4.2",
-      "sourceHash": "83b57574766f2e278eeee58d8b923b9bfc642a6832f2d1c137408b2b389acc7f",
+      "sourceHash": "31bf69f080bbcca05a98b7c485b5642e90e7f63625f4b03d89a91fbbb5f81e9c",
       "rendererSourceHash": "27927c48b377f7694251a76c0cecd05216fcbbb8a7d03e8bf2bd681dabb5573a",
-      "dependencyHash": "182eedef24fb67faae8fed2506e5ad51afee511fdcbce8fb8c709c3cc6fd91f9",
+      "dependencyHash": "bb179f2715f8fd9059898ef3a2028947e8f5f7e7979ad7eafe59d7a464c18f9f",
       "dependencies": {
         "@gltf-transform/core": "4.5.1",
         "@gltf-transform/extensions": "4.5.1",
@@ -54,10 +56,12 @@
         "acorn": "^8.18.0",
         "acorn-walk": "^8.3.5",
         "gltf-validator": "2.0.0-dev.3.10",
+        "jsonc-parser": "3.3.1",
         "manifold-3d": "^3.5.4",
         "minisearch": "7.2.0",
         "pngjs": "7.0.0",
         "sharp": "^0.35.5",
+        "smol-toml": "1.9.0",
         "three": "0.186.1",
         "three-subdivide": "1.1.5",
         "xatlasjs": "^0.2.0",
@@ -69,15 +73,15 @@
       },
       "target": "node",
       "file": "agent-run.mjs",
-      "bundleHash": "sha256:60946cbf1ddfbc28e60829013354fd069947892c1698c9597e14c672730f8628"
+      "bundleHash": "sha256:3fdb17224ded3a55afff6cf0b84f3de902728834d32ffe6e0c449ed3b71ac641"
     },
     "agent-providers": {
-      "identity": "sha256:81875ff0bc5f7b4b952f2bb32ffa11d9b4e2ee7067f1ccd458f6ec0aec455538",
-      "engineVersion": "1.0.0",
+      "identity": "sha256:adbc219831fef0d5cac0d2050a8171a3fd11860bb632b0e27545ed1cd571acfc",
+      "engineVersion": "1.1.0",
       "toolchain": "bun@1.4.2",
-      "sourceHash": "83b57574766f2e278eeee58d8b923b9bfc642a6832f2d1c137408b2b389acc7f",
+      "sourceHash": "31bf69f080bbcca05a98b7c485b5642e90e7f63625f4b03d89a91fbbb5f81e9c",
       "rendererSourceHash": "27927c48b377f7694251a76c0cecd05216fcbbb8a7d03e8bf2bd681dabb5573a",
-      "dependencyHash": "182eedef24fb67faae8fed2506e5ad51afee511fdcbce8fb8c709c3cc6fd91f9",
+      "dependencyHash": "bb179f2715f8fd9059898ef3a2028947e8f5f7e7979ad7eafe59d7a464c18f9f",
       "dependencies": {
         "@gltf-transform/core": "4.5.1",
         "@gltf-transform/extensions": "4.5.1",
@@ -89,10 +93,12 @@
         "acorn": "^8.18.0",
         "acorn-walk": "^8.3.5",
         "gltf-validator": "2.0.0-dev.3.10",
+        "jsonc-parser": "3.3.1",
         "manifold-3d": "^3.5.4",
         "minisearch": "7.2.0",
         "pngjs": "7.0.0",
         "sharp": "^0.35.5",
+        "smol-toml": "1.9.0",
         "three": "0.186.1",
         "three-subdivide": "1.1.5",
         "xatlasjs": "^0.2.0",
@@ -107,12 +113,12 @@
       "bundleHash": "sha256:9d6faf03d307321bc2e3bd5ce5bdee0bbbf61e0ebed8bfebfa1fb072287b83fa"
     },
     "mcp": {
-      "identity": "sha256:81875ff0bc5f7b4b952f2bb32ffa11d9b4e2ee7067f1ccd458f6ec0aec455538",
-      "engineVersion": "1.0.0",
+      "identity": "sha256:adbc219831fef0d5cac0d2050a8171a3fd11860bb632b0e27545ed1cd571acfc",
+      "engineVersion": "1.1.0",
       "toolchain": "bun@1.4.2",
-      "sourceHash": "83b57574766f2e278eeee58d8b923b9bfc642a6832f2d1c137408b2b389acc7f",
+      "sourceHash": "31bf69f080bbcca05a98b7c485b5642e90e7f63625f4b03d89a91fbbb5f81e9c",
       "rendererSourceHash": "27927c48b377f7694251a76c0cecd05216fcbbb8a7d03e8bf2bd681dabb5573a",
-      "dependencyHash": "182eedef24fb67faae8fed2506e5ad51afee511fdcbce8fb8c709c3cc6fd91f9",
+      "dependencyHash": "bb179f2715f8fd9059898ef3a2028947e8f5f7e7979ad7eafe59d7a464c18f9f",
       "dependencies": {
         "@gltf-transform/core": "4.5.1",
         "@gltf-transform/extensions": "4.5.1",
@@ -124,10 +130,12 @@
         "acorn": "^8.18.0",
         "acorn-walk": "^8.3.5",
         "gltf-validator": "2.0.0-dev.3.10",
+        "jsonc-parser": "3.3.1",
         "manifold-3d": "^3.5.4",
         "minisearch": "7.2.0",
         "pngjs": "7.0.0",
         "sharp": "^0.35.5",
+        "smol-toml": "1.9.0",
         "three": "0.186.1",
         "three-subdivide": "1.1.5",
         "xatlasjs": "^0.2.0",
@@ -139,15 +147,15 @@
       },
       "target": "node",
       "file": "mcp-server.mjs",
-      "bundleHash": "sha256:1f0727c7d63590d950d964e4dd15e303fdd27a79c97bf864aaaee5d7a7b9289e"
+      "bundleHash": "sha256:8de0309a6995e5d49ed2c261b9e7cb7ab6d7eab13c2f2f16f12511d8fd703a27"
     },
     "cli": {
-      "identity": "sha256:81875ff0bc5f7b4b952f2bb32ffa11d9b4e2ee7067f1ccd458f6ec0aec455538",
-      "engineVersion": "1.0.0",
+      "identity": "sha256:adbc219831fef0d5cac0d2050a8171a3fd11860bb632b0e27545ed1cd571acfc",
+      "engineVersion": "1.1.0",
       "toolchain": "bun@1.4.2",
-      "sourceHash": "83b57574766f2e278eeee58d8b923b9bfc642a6832f2d1c137408b2b389acc7f",
+      "sourceHash": "31bf69f080bbcca05a98b7c485b5642e90e7f63625f4b03d89a91fbbb5f81e9c",
       "rendererSourceHash": "27927c48b377f7694251a76c0cecd05216fcbbb8a7d03e8bf2bd681dabb5573a",
-      "dependencyHash": "182eedef24fb67faae8fed2506e5ad51afee511fdcbce8fb8c709c3cc6fd91f9",
+      "dependencyHash": "bb179f2715f8fd9059898ef3a2028947e8f5f7e7979ad7eafe59d7a464c18f9f",
       "dependencies": {
         "@gltf-transform/core": "4.5.1",
         "@gltf-transform/extensions": "4.5.1",
@@ -159,10 +167,12 @@
         "acorn": "^8.18.0",
         "acorn-walk": "^8.3.5",
         "gltf-validator": "2.0.0-dev.3.10",
+        "jsonc-parser": "3.3.1",
         "manifold-3d": "^3.5.4",
         "minisearch": "7.2.0",
         "pngjs": "7.0.0",
         "sharp": "^0.35.5",
+        "smol-toml": "1.9.0",
         "three": "0.186.1",
         "three-subdivide": "1.1.5",
         "xatlasjs": "^0.2.0",
@@ -174,15 +184,15 @@
       },
       "target": "node",
       "file": "cli.mjs",
-      "bundleHash": "sha256:bfe2e039974e093486b4d92af795235ac20c2d3772424237c90eb16455db47c5"
+      "bundleHash": "sha256:d7ebfce5b290a5da221c5890778ddc3ceaec1beb5022360aef12a82e1a193685"
     },
     "engine": {
-      "identity": "sha256:81875ff0bc5f7b4b952f2bb32ffa11d9b4e2ee7067f1ccd458f6ec0aec455538",
-      "engineVersion": "1.0.0",
+      "identity": "sha256:adbc219831fef0d5cac0d2050a8171a3fd11860bb632b0e27545ed1cd571acfc",
+      "engineVersion": "1.1.0",
       "toolchain": "bun@1.4.2",
-      "sourceHash": "83b57574766f2e278eeee58d8b923b9bfc642a6832f2d1c137408b2b389acc7f",
+      "sourceHash": "31bf69f080bbcca05a98b7c485b5642e90e7f63625f4b03d89a91fbbb5f81e9c",
       "rendererSourceHash": "27927c48b377f7694251a76c0cecd05216fcbbb8a7d03e8bf2bd681dabb5573a",
-      "dependencyHash": "182eedef24fb67faae8fed2506e5ad51afee511fdcbce8fb8c709c3cc6fd91f9",
+      "dependencyHash": "bb179f2715f8fd9059898ef3a2028947e8f5f7e7979ad7eafe59d7a464c18f9f",
       "dependencies": {
         "@gltf-transform/core": "4.5.1",
         "@gltf-transform/extensions": "4.5.1",
@@ -194,10 +204,12 @@
         "acorn": "^8.18.0",
         "acorn-walk": "^8.3.5",
         "gltf-validator": "2.0.0-dev.3.10",
+        "jsonc-parser": "3.3.1",
         "manifold-3d": "^3.5.4",
         "minisearch": "7.2.0",
         "pngjs": "7.0.0",
         "sharp": "^0.35.5",
+        "smol-toml": "1.9.0",
         "three": "0.186.1",
         "three-subdivide": "1.1.5",
         "xatlasjs": "^0.2.0",
@@ -209,7 +221,7 @@
       },
       "target": "node",
       "file": "mcp-engine.mjs",
-      "bundleHash": "sha256:c86e0280590c819d12baad3173fa0acc788cc6feb376e53cebf11abb44814d35"
+      "bundleHash": "sha256:3cb423f905dddc8b3c248db00304b2da976e69c0c899e0f63bbdf065f9af8f08"
     }
   }
 }

package/dist/cli.mjs

@@ -29342,7 +29342,7 @@ function isolatedWorkerUrls(moduleUrl) {
 }
 
 // src/evaluator/isolation.ts
-import { existsSync } from "node:fs";
+import { existsSync, readlinkSync } from "node:fs";
 import { posix } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 function isolationUnavailable() {
@@ -29384,7 +29384,7 @@ function isolatedEvaluatorLaunchWithLoader(workerPath, host = {}, loader = "tsx"
   const setprivPath = requiredAbsolutePath(host.setprivPath ?? DEFAULT_SETPRIV_PATH);
   const prlimitPath = requiredAbsolutePath(host.prlimitPath ?? DEFAULT_PRLIMIT_PATH);
   const nodePath = requiredAbsolutePath(host.nodePath ?? DEFAULT_NODE_PATH);
-  for (const executable of [bwrapPath, setprivPath, prlimitPath, nodePath]) {
+  for (const executable of [bwrapPath, setprivPath, prlimitPath, nodePath, ENV_PATH]) {
     if (!pathExists(executable))
       isolationUnavailable();
   }
@@ -29420,11 +29420,11 @@ function isolatedEvaluatorLaunchWithLoader(workerPath, host = {}, loader = "tsx"
   for (const mount of runtimeMounts(runtimeRoot, pathExists)) {
     bwrapArgs.push("--ro-bind", mount, mount);
   }
-  const nodeArgs = [nodePath, "--max-old-space-size=512", "--disable-proto=throw"];
+  const nodeArgs = [nodePath, "--max-old-space-size=512", "--disable-proto=delete"];
   if (loader === "tsx")
     nodeArgs.push("--import", "tsx");
   nodeArgs.push(resolvedWorkerPath);
-  bwrapArgs.push("--chdir", runtimeRoot, "--preserve-fds", "1", "--", prlimitPath, "--cpu=65:65", "--as=6442450944:6442450944", "--fsize=100663296:100663296", "--nofile=64:64", "--nproc=64:64", "--", ...nodeArgs);
+  bwrapArgs.push("--chdir", runtimeRoot, "--", prlimitPath, "--cpu=65:65", "--as=6442450944:6442450944", "--fsize=100663296:100663296", "--nofile=64:64", "--nproc=64:64", "--", ENV_PATH, "-i", "NODE_ENV=production", "NO_COLOR=1", ...nodeArgs);
   return {
     command: setprivPath,
     args: [
@@ -29448,7 +29448,7 @@ async function renderGLBViaIsolatedEvaluator(code, options = {}, controls = {})
   const { host: _, ...processControls } = controls;
   return renderGLBViaProcessLaunch(code, options, processControls, launch);
 }
-var DEFAULT_RUNTIME_ROOT = "/app", DEFAULT_BWRAP_PATH = "/usr/local/bin/bwrap", DEFAULT_SETPRIV_PATH = "/usr/bin/setpriv", DEFAULT_PRLIMIT_PATH = "/usr/bin/prlimit", DEFAULT_NODE_PATH = "/usr/local/bin/node", MAX_READINESS_PROTOCOL_BYTES;
+var DEFAULT_RUNTIME_ROOT = "/app", DEFAULT_BWRAP_PATH = "/usr/local/bin/bwrap", DEFAULT_SETPRIV_PATH = "/usr/bin/setpriv", DEFAULT_PRLIMIT_PATH = "/usr/bin/prlimit", DEFAULT_NODE_PATH = "/usr/local/bin/node", ENV_PATH = "/usr/bin/env", MAX_READINESS_PROTOCOL_BYTES;
 var init_isolation = __esm(() => {
   init_subprocess();
   MAX_READINESS_PROTOCOL_BYTES = 16 * 1024;
@@ -36171,7 +36171,7 @@ var init_program_artifacts = __esm(() => {
 function engineIdentity() {
   return { version: ENGINE_VERSION, installUrl: ENGINE_INSTALL_URL };
 }
-var ENGINE_VERSION = "1.0.0", ENGINE_INSTALL_URL;
+var ENGINE_VERSION = "1.1.0", ENGINE_INSTALL_URL;
 var init_engine_identity = __esm(() => {
   ENGINE_INSTALL_URL = new URL("../", import.meta.url).href;
 });
@@ -44428,8 +44428,7 @@ async function startLocalRenderService(dir = renderServiceDir(), environment = p
       if (exited)
         exitedAt ??= Date.now();
       if (spawnError || exitedAt !== undefined && Date.now() - exitedAt >= 1500)
-        throw new Error(`render service exited during startup${spawnError ? `: ${spawnError.message}` : ""}${stderr.trim() ? `: ${stderr.trim().split(`
-`).slice(-3).join(" ")}` : windowsLaunch ? "; launch the renderer manually to inspect native-driver errors" : ""}`);
+        throw new Error(`render service exited during startup${spawnError ? `: ${spawnError.message}` : ""}${stderr.trim() ? `: ${stderr.trim()}` : windowsLaunch ? "; launch the renderer manually to inspect native-driver errors" : ""}`);
       await new Promise((done) => setTimeout(done, 250));
     }
     throw new Error(`render service health is unknown after ${budget}ms; inspect with \`kiln service reprobe\``);
@@ -44558,12 +44557,17 @@ function makeLazyRenderPort(start, token, sourceFingerprint, initialUrl) {
     } catch (error) {
       if (execution?.signal?.aborted || error.name === "TimeoutError")
         throw error;
-      if ((await readRenderServiceHealth(url, {
+      if (resolving !== pending)
+        return (await resolve()).port(req, execution);
+      const health = await readRenderServiceHealth(url, {
         token,
         signal: execution?.signal
-      })).kind !== "absent")
-        throw error;
+      });
       execution?.signal?.throwIfAborted();
+      if (resolving !== pending)
+        return (await resolve()).port(req, execution);
+      if (health.kind !== "absent")
+        throw error;
       if (resolving === pending)
         resolving = undefined;
       return (await resolve()).port(req, execution);
@@ -47448,11 +47452,11 @@ EXPORT ENVIRONMENT
   KILN_INDEX_POLICY      indexed (default) | asBuilt (requires optimization off)
 
 EXAMPLES
-  kiln render examples/crate.kiln.js --out crate.glb --views sheet.png
+  kiln render my-asset.kiln.js --out asset.glb --views sheet.png
   kiln generate "a weathered wooden crate" --out crate.glb --views sheet.png
-  kiln render examples/crate.kiln.js --render cpu --views sheet.png
+  kiln render my-asset.kiln.js --render cpu --views sheet.png
   kiln render p_RETURNED_HANDLE --capture cameras.json --views chosen.png
-  kiln render examples/crate.kiln.js --views sheet.png --backdrop light
+  kiln render my-asset.kiln.js --views sheet.png --backdrop light
 `;
 function parseArgs(argv) {
   let renderOption;

package/dist/mcp-engine.mjs

@@ -28525,7 +28525,7 @@ function isolatedWorkerUrls(moduleUrl) {
 }
 
 // src/evaluator/isolation.ts
-import { existsSync as existsSync3 } from "node:fs";
+import { existsSync as existsSync3, readlinkSync } from "node:fs";
 import { posix } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 function isolationUnavailable() {
@@ -28567,7 +28567,7 @@ function isolatedEvaluatorLaunchWithLoader(workerPath, host = {}, loader = "tsx"
   const setprivPath = requiredAbsolutePath(host.setprivPath ?? DEFAULT_SETPRIV_PATH);
   const prlimitPath = requiredAbsolutePath(host.prlimitPath ?? DEFAULT_PRLIMIT_PATH);
   const nodePath = requiredAbsolutePath(host.nodePath ?? DEFAULT_NODE_PATH);
-  for (const executable of [bwrapPath, setprivPath, prlimitPath, nodePath]) {
+  for (const executable of [bwrapPath, setprivPath, prlimitPath, nodePath, ENV_PATH]) {
     if (!pathExists(executable))
       isolationUnavailable();
   }
@@ -28603,11 +28603,11 @@ function isolatedEvaluatorLaunchWithLoader(workerPath, host = {}, loader = "tsx"
   for (const mount of runtimeMounts(runtimeRoot, pathExists)) {
     bwrapArgs.push("--ro-bind", mount, mount);
   }
-  const nodeArgs = [nodePath, "--max-old-space-size=512", "--disable-proto=throw"];
+  const nodeArgs = [nodePath, "--max-old-space-size=512", "--disable-proto=delete"];
   if (loader === "tsx")
     nodeArgs.push("--import", "tsx");
   nodeArgs.push(resolvedWorkerPath);
-  bwrapArgs.push("--chdir", runtimeRoot, "--preserve-fds", "1", "--", prlimitPath, "--cpu=65:65", "--as=6442450944:6442450944", "--fsize=100663296:100663296", "--nofile=64:64", "--nproc=64:64", "--", ...nodeArgs);
+  bwrapArgs.push("--chdir", runtimeRoot, "--", prlimitPath, "--cpu=65:65", "--as=6442450944:6442450944", "--fsize=100663296:100663296", "--nofile=64:64", "--nproc=64:64", "--", ENV_PATH, "-i", "NODE_ENV=production", "NO_COLOR=1", ...nodeArgs);
   return {
     command: setprivPath,
     args: [
@@ -28631,7 +28631,7 @@ async function renderGLBViaIsolatedEvaluator(code, options = {}, controls = {})
   const { host: _, ...processControls } = controls;
   return renderGLBViaProcessLaunch(code, options, processControls, launch);
 }
-var DEFAULT_RUNTIME_ROOT = "/app", DEFAULT_BWRAP_PATH = "/usr/local/bin/bwrap", DEFAULT_SETPRIV_PATH = "/usr/bin/setpriv", DEFAULT_PRLIMIT_PATH = "/usr/bin/prlimit", DEFAULT_NODE_PATH = "/usr/local/bin/node", MAX_READINESS_PROTOCOL_BYTES;
+var DEFAULT_RUNTIME_ROOT = "/app", DEFAULT_BWRAP_PATH = "/usr/local/bin/bwrap", DEFAULT_SETPRIV_PATH = "/usr/bin/setpriv", DEFAULT_PRLIMIT_PATH = "/usr/bin/prlimit", DEFAULT_NODE_PATH = "/usr/local/bin/node", ENV_PATH = "/usr/bin/env", MAX_READINESS_PROTOCOL_BYTES;
 var init_isolation = __esm(() => {
   init_subprocess();
   MAX_READINESS_PROTOCOL_BYTES = 16 * 1024;
@@ -33769,8 +33769,7 @@ async function startLocalRenderService(dir = renderServiceDir(), environment = p
       if (exited)
         exitedAt ??= Date.now();
       if (spawnError || exitedAt !== undefined && Date.now() - exitedAt >= 1500)
-        throw new Error(`render service exited during startup${spawnError ? `: ${spawnError.message}` : ""}${stderr.trim() ? `: ${stderr.trim().split(`
-`).slice(-3).join(" ")}` : windowsLaunch ? "; launch the renderer manually to inspect native-driver errors" : ""}`);
+        throw new Error(`render service exited during startup${spawnError ? `: ${spawnError.message}` : ""}${stderr.trim() ? `: ${stderr.trim()}` : windowsLaunch ? "; launch the renderer manually to inspect native-driver errors" : ""}`);
       await new Promise((done) => setTimeout(done, 250));
     }
     throw new Error(`render service health is unknown after ${budget}ms; inspect with \`kiln service reprobe\``);
@@ -33889,12 +33888,17 @@ function makeLazyRenderPort(start, token, sourceFingerprint, initialUrl) {
     } catch (error) {
       if (execution?.signal?.aborted || error.name === "TimeoutError")
         throw error;
-      if ((await readRenderServiceHealth(url, {
+      if (resolving !== pending)
+        return (await resolve()).port(req, execution);
+      const health = await readRenderServiceHealth(url, {
         token,
         signal: execution?.signal
-      })).kind !== "absent")
-        throw error;
+      });
       execution?.signal?.throwIfAborted();
+      if (resolving !== pending)
+        return (await resolve()).port(req, execution);
+      if (health.kind !== "absent")
+        throw error;
       if (resolving === pending)
         resolving = undefined;
       return (await resolve()).port(req, execution);
@@ -36102,7 +36106,7 @@ import { readFile as readFile8 } from "node:fs/promises";
 var KILN_ASSET_WIDGET_URI = "ui://kiln/asset-v5.html";
 
 // src/engine-identity.ts
-var ENGINE_VERSION = "1.0.0";
+var ENGINE_VERSION = "1.1.0";
 var ENGINE_INSTALL_URL = new URL("../", import.meta.url).href;
 function engineIdentity() {
   return { version: ENGINE_VERSION, installUrl: ENGINE_INSTALL_URL };

package/dist/mcp-server.mjs

@@ -2085,7 +2085,7 @@ import { readFile } from "node:fs/promises";
 var KILN_ASSET_WIDGET_URI = "ui://kiln/asset-v5.html";
 
 // src/engine-identity.ts
-var ENGINE_VERSION = "1.0.0";
+var ENGINE_VERSION = "1.1.0";
 var ENGINE_INSTALL_URL = new URL("../", import.meta.url).href;
 
 // src/requirements-json.ts

package/docs/architecture.md

@@ -4,11 +4,11 @@ Kiln builds JavaScript programs into GLB assets, validates structure, and render
 
 ## Entry points
 
-The v1 checkout prepares `@instruktlabs/kiln` with compiled ESM and TypeScript
+The npm package `@instruktlabs/kiln` ships compiled ESM and TypeScript
 declarations. Node consumers need no source loader. Build the SDK on a fresh source
 checkout before using package imports; the installed archive already contains it.
 See the [SDK contract](sdk.md) for runtime and experimental-feature boundaries.
-There is no published npm release yet.
+See [installation](install.md) for package, source-checkout and plugin setup.
 
 | Subpath | Purpose |
 |---|---|
@@ -66,12 +66,15 @@ CPU render paths are deterministic for the same inputs. GPU images can vary by d
 ## Development
 
 ```bash
+node scripts/example-archive.mjs --fetch
 bun run typecheck
 bun run lint
 bun run test
 bun run test:coverage
 ```
 
-Offline tests pin CPU rendering and exercise the checked-in example programs. The coverage ratchet lives in [scripts/check-coverage.mjs](https://github.com/instruktlabs/kiln/blob/main/scripts/check-coverage.mjs). Threshold decreases require an explicit measured rationale. Live provider tests require an explicit opt-in.
+Prepare the pinned historical corpus once with the explicit fetch command above.
+Subsequent tests stay offline, pin CPU rendering and include those archived programs.
+The coverage ratchet lives in [scripts/check-coverage.mjs](https://github.com/instruktlabs/kiln/blob/main/scripts/check-coverage.mjs). Threshold decreases require an explicit measured rationale. Live provider tests require an explicit opt-in.
 
 Core dependencies include Three.js, glTF Transform, Manifold, Acorn, and Zod. The agent SDK is an optional peer. Keep provider adapters compatible with the SDK's declared interface version; a TypeScript cast cannot fix a runtime protocol mismatch.

package/docs/chatgpt.md

@@ -2,17 +2,27 @@
 
 Kiln's local CLI and stdio MCP server share the same collection store and tool registry. ChatGPT web needs a reachable MCP connection: a private Secure MCP Tunnel can carry this existing stdio server without making a public endpoint. The tunnel process must remain running while ChatGPT discovers or calls tools.
 
+This is an owner-managed development connection. Kiln's public hosted service and
+directory listing are deferred. Local CLI/MCP use needs no Kiln account; the
+optional OpenAI tunnel separately requires Platform access and a runtime API key.
+
 ## Connect a private development server
 
-1. Build with the supported toolchain: `bun run build:runtime`.
-2. Create a tunnel in OpenAI Platform, scoped to the intended ChatGPT workspace. The account needs Tunnels Read and Manage; its runtime API key needs Read and Use. Existing organization roles may already grant these. Do not broaden other permissions.
-3. Download a pinned official `openai/tunnel-client` release and verify its release digest. This dogfood used Windows amd64 v0.0.14. Keep credentials in the environment or a supported secret reference, never in the plugin.
+1. [Install Kiln](install.md) and create a dedicated asset workspace. The npm package already contains the built server; an engine checkout needs `bun run build:runtime` first.
+2. Create a tunnel in OpenAI Platform and associate it with the intended ChatGPT workspace and Platform organization. Creating it requires Tunnels Read and Manage; running or selecting it requires Read and Use. ChatGPT workspace policy also applies.
+3. Obtain the client through the [official tunnel setup guide](https://developers.openai.com/api/docs/guides/secure-mcp-tunnels#set-up-tunnel-client). Record the version you test. Keep credentials outside the plugin and source repository.
 4. Configure the tunnel's stdio command to launch `node /absolute/path/dist/mcp-server.mjs` in a dedicated asset workspace. Set `KILN_PROGRAM_STORE` and `KILN_COLLECTIONS` explicitly. The server does not need provider keys. The tunnel control process needs its OpenAI key, which should not be inherited by the MCP child.
-5. Run `tunnel-client doctor`, then `tunnel-client run` with the configured profile. In ChatGPT's Plugins page choose Create app, Tunnel, the intended tunnel, and No Auth for the stdio server. Access is still controlled by the private tunnel; this does not create a public unauthenticated service.
+5. Run `tunnel-client doctor --profile NAME --explain`, then `tunnel-client run --profile NAME`. In ChatGPT Plugins, use the plus button, Add custom MCP server, then Tunnel. Select your tunnel, configure authentication, review the warning and create the plugin. Kiln's local stdio server has no separate OAuth; access is controlled by the private tunnel.
 6. Verify the seventeen-tool MCP surface appears, including `kiln_discover`, `kiln_renderer`, `kiln_present` and `kiln_project`. Test source submission, actual render-image visibility, save/list, copy, restore/edit, and exact revision export. Refresh connector metadata after changing tools.
 
 Local subprocess evaluation has deadlines and a sanitized environment; it is not the Linux isolated evaluator's OS security boundary. This setup is for an owner-controlled development test. A hosted multi-user deployment needs tenant-scoped storage, authentication, and the isolated evaluator posture.
 
+A private tunnel is not eligible as a public plugin endpoint. OpenAI's
+[connection guide](https://developers.openai.com/plugins/deploy/connect-chatgpt)
+requires a public HTTPS endpoint for submission. The steps above were checked
+against official documentation on 7 October 2026; that is a documentation check,
+not a new end-to-end ChatGPT qualification.
+
 ## Expose the skills
 
 Keep `skills/*/SKILL.md` and their adjacent `references/` directories as the maintained source. Skill descriptions provide discovery; instructions load on selection, and reference files provide modeling detail when needed. Avoid pasting the complete modeling catalog into every tool description or prompt.
@@ -45,4 +55,9 @@ The local viewer (`kiln view`) provides browser downloads, revision selection, c
 
 The Node and Bun JavaScript runtimes can produce tiny floating-point differences in regenerated GLB JSON. Preserve the original artifact for byte-exact delivery and rebuild with the recorded engine's supported Node toolchain for reproducibility. ZIP import/export preserves original bytes regardless of runtime.
 
-Official references checked September 6, 2026: [Connect ChatGPT](https://developers.openai.com/plugins/deploy/connect-chatgpt), [Secure MCP Tunnels](https://developers.openai.com/api/docs/guides/secure-mcp-tunnels), and [Package plugins](https://developers.openai.com/plugins/build/plugins). Surface availability can change; verify the actual host before claiming installation or download support.
+The uploader and download observations above are historical tests from September 6,
+2026, not claims about every current account. Check the actual client's installation,
+image display and file download behavior before advertising support. See
+[Connect ChatGPT](https://developers.openai.com/plugins/deploy/connect-chatgpt),
+[Secure MCP Tunnels](https://developers.openai.com/api/docs/guides/secure-mcp-tunnels)
+and [Package plugins](https://developers.openai.com/plugins/build/plugins).