@instruktlabs/kiln 1.2.0 → 1.2.1

package/lib/asset-widget-uri.d.ts

@@ -6,4 +6,4 @@
  * engine has loaded. Neither of those may import the other, so the literal
  * lives here on its own.
  */
-export declare const KILN_ASSET_WIDGET_URI = "ui://kiln/asset-v5.html";
+export declare const KILN_ASSET_WIDGET_URI = "ui://kiln/asset-v6.html";

package/lib/asset-widget-uri.js

@@ -6,4 +6,4 @@
  * engine has loaded. Neither of those may import the other, so the literal
  * lives here on its own.
  */
-export const KILN_ASSET_WIDGET_URI = 'ui://kiln/asset-v5.html';
+export const KILN_ASSET_WIDGET_URI = 'ui://kiln/asset-v6.html';

package/lib/engine-identity.d.ts

@@ -26,7 +26,7 @@
  * `src/__tests__/package-contents.test.ts` fails if it disagrees with the manifest
  * or with any plugin manifest, which is what keeps the literal honest.
  */
-export declare const ENGINE_VERSION = "1.2.0";
+export declare const ENGINE_VERSION = "1.2.1";
 /**
  * Where this engine was loaded from, as a `file://` URL of the package root.
  *

package/lib/engine-identity.js

@@ -26,7 +26,7 @@
  * `src/__tests__/package-contents.test.ts` fails if it disagrees with the manifest
  * or with any plugin manifest, which is what keeps the literal honest.
  */
-export const ENGINE_VERSION = '1.2.0';
+export const ENGINE_VERSION = '1.2.1';
 /**
  * Where this engine was loaded from, as a `file://` URL of the package root.
  *

package/lib/mcp-core.d.ts

@@ -23,7 +23,7 @@ import { type ServeStdioOptions, type StdioServerHandle } from '@modelcontextpro
 import type { AssetLink } from "./assets-resources.js";
 /** Server identity reported in the handshake and stamped into every 2026-07-28 result. */
 export declare const MCP_SERVER_NAME = "kiln";
-export declare const MCP_SERVER_VERSION = "1.2.0";
+export declare const MCP_SERVER_VERSION = "1.2.1";
 /**
  * The spec's optional `instructions` field, returned by `initialize` and
  * `server/discover`.

package/lib/tools/registry.d.ts

@@ -17,7 +17,7 @@ import { type ViewRenderTimeoutContextProvider, type ViewRenderTimeoutResolver }
 import { ViewEvidenceHistoryStore } from "../views/evidence-history.js";
 import { type BackdropId } from "../views/background.js";
 import type { TextureUsage } from "../textures.js";
-export declare const KILN_ASSET_WIDGET_URI = "ui://kiln/asset-v5.html";
+export { KILN_ASSET_WIDGET_URI } from "../asset-widget-uri.js";
 export interface KilnToolDef {
     /** Shared action ownership and requirements; never hand-maintained by transports. */
     actionContract?: Readonly<Record<string, import("./operation-contract.js").KilnActionContract>>;
@@ -793,4 +793,3 @@ export declare function newestRevision(target: {
 export declare function buildProgramAssetDraft(code: string, context: KilnToolContext, backdrop?: BackdropId): Promise<Pick<import("../assets.js").AssetDraft, 'code' | 'glb' | 'preview' | 'previewInfo' | 'build'>>;
 /** All asset operation schemas live here, alongside the existing tool definitions. */
 export declare function createKilnAssetDefs(context: KilnToolContext, presentation?: 'grouped' | 'operations'): KilnToolDef[];
-export {};

package/lib/tools/registry.js

@@ -35,7 +35,8 @@ import { persistedPreviewFidelity } from "./preview-fidelity.js";
 // =============================================================================
 // Tool definition contract
 // =============================================================================
-export const KILN_ASSET_WIDGET_URI = 'ui://kiln/asset-v5.html';
+export { KILN_ASSET_WIDGET_URI } from "../asset-widget-uri.js";
+import { KILN_ASSET_WIDGET_URI } from "../asset-widget-uri.js";
 function proceduralTextureMaterialContract(rendered, context) {
     const required = [...new Set(context.requiredProceduralTextureUsages ?? [])];
     if (required.length === 0)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instruktlabs/kiln",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Create and refine procedural 3D assets with JavaScript, image feedback, and reusable source revisions.",
   "license": "MIT",
   "author": "Matthew Kissinger",

package/plugin.json

@@ -2,7 +2,7 @@
   "name": "kiln",
   "displayName": "Kiln",
   "description": "Build and revise 3D assets with your coding agent. Write JavaScript, inspect selected views, edit saved source revisions, and export GLB files locally.",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "license": "MIT",
   "homepage": "https://github.com/instruktlabs/kiln",
   "keywords": [

package/plugins/kiln-engine/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "kiln-engine",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Set up a local Kiln workspace to create, inspect and revise editable 3D assets with Claude Code or Codex.",
   "author": {
     "name": "Instrukt Labs",

package/plugins/kiln-engine/README.md

@@ -1,7 +1,7 @@
 # Kiln local plugin
 
-Plugin version 1.2.0, maintained by Instrukt Labs under the MIT license.
-This plugin pins engine 1.2.0. Registry setup requires that exact version
+Plugin version 1.2.1, maintained by Instrukt Labs under the MIT license.
+This plugin pins engine 1.2.1. Registry setup requires that exact version
 to be published. Use a published release tag for normal installation or a reviewed
 local archive for development qualification. The installation ID remains
 `kiln-engine@instruktlabs`.
@@ -31,7 +31,7 @@ codex plugin add kiln-engine@instruktlabs
 Restart or reload your coding agent's plugins as its installation message directs.
 Then ask it to set up a Kiln workspace. The maintained setup skill runs this
 plugin's `bin/kiln-setup-workspace.mjs` with Node, installs
-`@instruktlabs/kiln@1.2.0` outside the project and configures your chosen
+`@instruktlabs/kiln@1.2.1` outside the project and configures your chosen
 workspace. The same initializer supports existing projects and new workspaces.
 
 The plugin registers setup only. The workspace supplies authoring skills and one

package/plugins/kiln-engine/package-provenance.json

@@ -1,20 +1,20 @@
 {
   "schemaVersion": 1,
   "kind": "kiln-local-plugin",
-  "pluginVersion": "1.2.0",
-  "engineVersion": "1.2.0",
+  "pluginVersion": "1.2.1",
+  "engineVersion": "1.2.1",
   "executables": [
     "bin/kiln-setup-workspace.mjs"
   ],
   "files": {
     ".claude-plugin/icon.png": "sha256:b4b651c402793b7e27cab780f04b14f80daec6d0cd5b7e4e90313930581a54e9",
-    ".claude-plugin/plugin.json": "sha256:616a6a61da072fcfdd4d0e1cf513e0e91bf1e56fb61b9b02d23e72fa291556bc",
+    ".claude-plugin/plugin.json": "sha256:bef717ea5e0c96411c2db93d54e298dc3798512df9909ba74c950a6c1c03f6cb",
     "bin/kiln-setup-workspace.mjs": "sha256:3d9a30236919a6ca91acb6b26f808cec442e6edc3dd88fe010645b010d76e838",
     "LICENSE": "sha256:cdba278ebf1d6de618869936226bf03be4887179c128efc7aaa13d22034826a5",
-    "plugin.json": "sha256:3437107d46ad4fef4a710a8e821e56b43894cc1722504fe4e8ff0120fa6a8d8d",
+    "plugin.json": "sha256:9ef79b862a25ae3efe86c03a37e09cd622912b97a0165a08fdf55cff8b71a010",
     "PRIVACY.md": "sha256:5f58d981667e40441e21c2dec411f269a9a67a6141cec61976d27088fb12573b",
-    "README.md": "sha256:0b82e6eb8b679f8b991c1a5567957574ed7b3341a87ef989403e5521f83ab50e",
-    "runtime.json": "sha256:5ebac8387f4bedcc7cac02a36f73c5ffba969ce6c8c6e2b0e356ef569168d0a5",
+    "README.md": "sha256:029732d7bb9e04561105727f8e46118d3106f513b4575a8d74d57cbd1bb68e7a",
+    "runtime.json": "sha256:b6d078f1223cb5ed3a522b0ef5a3cb778e051afc0115237cfd9cfe04c1f42025",
     "skills/kiln-setup-workspace/references/plugin-install.md": "sha256:c338fb792e7fad0364c3e1a13c94c506afa1395489ec1b6e83b36d04728935fb",
     "skills/kiln-setup-workspace/references/renderer-setup.md": "sha256:b743b1b2827fa814385990e1e5b849391cb427413e9c016d273aa19cebd46031",
     "skills/kiln-setup-workspace/SKILL.md": "sha256:65ed926b3503a33f4fe793e84e4a045ce36e3967f0e6b340e456a15dd010ce54"

package/plugins/kiln-engine/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "kiln-engine",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Set up a local Kiln workspace to create, inspect and revise editable 3D assets with Claude Code or Codex.",
   "author": {
     "name": "Instrukt Labs",

package/plugins/kiln-engine/runtime.json

@@ -1,6 +1,6 @@
 {
   "name": "@instruktlabs/kiln",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "harnesses": [
     "claude",
     "codex",

package/src/asset-widget-uri.ts

@@ -6,4 +6,4 @@
  * engine has loaded. Neither of those may import the other, so the literal
  * lives here on its own.
  */
-export const KILN_ASSET_WIDGET_URI = 'ui://kiln/asset-v5.html';
+export const KILN_ASSET_WIDGET_URI = 'ui://kiln/asset-v6.html';

package/src/engine-identity.ts

@@ -27,7 +27,7 @@
  * `src/__tests__/package-contents.test.ts` fails if it disagrees with the manifest
  * or with any plugin manifest, which is what keeps the literal honest.
  */
-export const ENGINE_VERSION = '1.2.0';
+export const ENGINE_VERSION = '1.2.1';
 
 /**
  * Where this engine was loaded from, as a `file://` URL of the package root.

package/src/generated/mcp-manifest.json

@@ -1733,13 +1733,13 @@
       },
       "_meta": {
         "ui": {
-          "resourceUri": "ui://kiln/asset-v5.html",
+          "resourceUri": "ui://kiln/asset-v6.html",
           "visibility": [
             "model"
           ]
         },
-        "openai/outputTemplate": "ui://kiln/asset-v5.html",
-        "ui/resourceUri": "ui://kiln/asset-v5.html"
+        "openai/outputTemplate": "ui://kiln/asset-v6.html",
+        "ui/resourceUri": "ui://kiln/asset-v6.html"
       },
       "outputSchema": {
         "type": "object",
@@ -2018,7 +2018,7 @@
   ],
   "resources": [
     {
-      "uri": "ui://kiln/asset-v5.html",
+      "uri": "ui://kiln/asset-v6.html",
       "name": "kiln-asset-viewer",
       "mimeType": "text/html;profile=mcp-app",
       "description": "Interactive Kiln asset viewer and downloads",

package/src/tools/registry.ts

@@ -94,7 +94,8 @@ import type { TextureUsage } from '../textures';
 // Tool definition contract
 // =============================================================================
 
-export const KILN_ASSET_WIDGET_URI = 'ui://kiln/asset-v5.html';
+export { KILN_ASSET_WIDGET_URI } from '../asset-widget-uri';
+import { KILN_ASSET_WIDGET_URI } from '../asset-widget-uri';
 export interface KilnToolDef {
   /** Shared action ownership and requirements; never hand-maintained by transports. */
   actionContract?: Readonly<Record<string, import('./operation-contract').KilnActionContract>>;

package/src/viewer/chat-app.ts

@@ -51,6 +51,8 @@ function encode(bytes: Uint8Array) {
 async function show(input: unknown) {
   const revision = ++presentationRevision;
   record = undefined;
+  element('stats').textContent = '';
+  element<HTMLSelectElement>('clips').hidden = true;
   for (const button of document.querySelectorAll<HTMLButtonElement>('button[data-download]'))
     button.disabled = true;
   try {
@@ -116,14 +118,16 @@ async function showResult(
     status.textContent = 'Drag to orbit · Scroll to zoom';
   } catch (error) {
     if (revision !== presentationRevision) return;
+    stage?.dispose();
+    stage = undefined;
     const preview = record.files['preview.png'];
     if (preview) {
       const image = new Image();
-      image.alt = record.manifest.name;
+      image.alt = `${record.manifest.name} · saved preview image`;
       image.src = `data:image/png;base64,${encode(preview)}`;
       element('stage').replaceChildren(image);
     }
-    status.textContent = `3D preview unavailable: ${String(error)}`;
+    status.textContent = `${preview ? 'Showing saved preview. ' : ''}3D preview unavailable: ${String(error)}`;
   }
   for (const button of document.querySelectorAll<HTMLButtonElement>('button[data-download]'))
     button.disabled = false;

package/src/viewer/glb-loader.ts

@@ -0,0 +1,78 @@
+import {
+  LoadingManager,
+  TextureLoader,
+  Texture,
+  type Object3D,
+  type Mesh,
+  type BufferGeometry,
+  type Material,
+} from 'three';
+import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
+import { validateAssetGlb } from '../assets';
+
+export function disposeAssetModel(model: Object3D) {
+  const geometries = new Set<BufferGeometry>();
+  const materials = new Set<Material>();
+  const textures = new Set<Texture>();
+  model.traverse((object) => {
+    const mesh = object as Mesh;
+    if (!mesh.isMesh) return;
+    geometries.add(mesh.geometry);
+    for (const material of Array.isArray(mesh.material) ? mesh.material : [mesh.material]) {
+      materials.add(material);
+      for (const value of Object.values(material))
+        if (value instanceof Texture) textures.add(value);
+    }
+  });
+  for (const value of [...geometries, ...materials, ...textures]) value.dispose();
+}
+
+/**
+ * Parse self-contained GLBs under MCP Apps' img-src data: / connect-src none policy.
+ * ImageBitmapLoader fetches even blob/data URLs. Use the documented image handler
+ * instead, preserving GLTFLoader's sampler, UV, color-space and extension logic.
+ * Only the parser's private JSON copy changes; downloaded GLB bytes remain exact.
+ */
+export async function loadAssetGlb(bytes: Uint8Array) {
+  validateAssetGlb(bytes);
+  const manager = new LoadingManager();
+  let imageFailed = false;
+  manager.onError = () => {
+    imageFailed = true;
+  };
+  manager.addHandler(/^data:image\//, new TextureLoader(manager));
+  manager.setURLModifier((url) => {
+    if (!url.startsWith('blob:') && !url.startsWith('data:'))
+      throw new Error('External model resources are not loaded');
+    return url;
+  });
+  const loader = new GLTFLoader(manager);
+  loader.register((parser) => ({
+    name: 'KILN_embedded_images',
+    async beforeRoot() {
+      for (const image of parser.json.images ?? []) {
+        if (image.bufferView === undefined) continue;
+        const buffer = new Uint8Array(await parser.getDependency('bufferView', image.bufferView));
+        let binary = '';
+        for (let i = 0; i < buffer.length; i += 8192)
+          binary += String.fromCharCode(...buffer.subarray(i, i + 8192));
+        if (!/^image\/(png|jpeg|webp|avif)$/.test(image.mimeType ?? ''))
+          throw new Error('Unsupported embedded image type');
+        image.uri = `data:${image.mimeType};base64,${btoa(binary)}`;
+        delete image.bufferView;
+      }
+    },
+  }));
+  const gltf = await loader.parseAsync(Uint8Array.from(bytes).buffer, '');
+  if (imageFailed) {
+    for (const scene of gltf.scenes) disposeAssetModel(scene);
+    throw new Error('An embedded texture could not be decoded.');
+  }
+  // GLTFLoader deliberately converts failed images to null maps. Never commit a
+  // material-degraded scene, including resources loaded later for detached LODs.
+  return Object.assign(gltf, {
+    assertTexturesLoaded() {
+      if (imageFailed) throw new Error('An embedded texture could not be decoded.');
+    },
+  });
+}

package/src/viewer/scene.ts

@@ -1,9 +1,8 @@
 /// <reference lib="dom" />
 import * as THREE from 'three';
-import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
 import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
 import { RoomEnvironment } from 'three/addons/environments/RoomEnvironment.js';
-import { validateAssetGlb } from '../assets';
+import { loadAssetGlb, disposeAssetModel as disposeModel } from './glb-loader';
 import { frameAssetBounds } from './framing';
 import {
   captureCameraView,
@@ -156,22 +155,6 @@ export function createAssetStage(container: HTMLElement) {
       ],
     };
   };
-  const disposeModel = (model: THREE.Object3D) => {
-    const geometries = new Set<THREE.BufferGeometry>();
-    const materials = new Set<THREE.Material>();
-    const textures = new Set<THREE.Texture>();
-    model.traverse((object) => {
-      const mesh = object as THREE.Mesh;
-      if (!mesh.isMesh) return;
-      geometries.add(mesh.geometry);
-      for (const material of Array.isArray(mesh.material) ? mesh.material : [mesh.material]) {
-        materials.add(material);
-        for (const value of Object.values(material))
-          if (value instanceof THREE.Texture) textures.add(value);
-      }
-    });
-    for (const value of [...geometries, ...materials, ...textures]) value.dispose();
-  };
   const reset = () => {
     if (!root) return;
     const box = drawnBounds(root);
@@ -263,17 +246,17 @@ export function createAssetStage(container: HTMLElement) {
       const loadStarted = performance.now();
       const current = ++generation;
       cancelMeasurement('The artifact changed during measurement. Measure the new revision again.');
-      validateAssetGlb(bytes);
-      const manager = new THREE.LoadingManager();
-      manager.setURLModifier((url) => {
-        if (!url.startsWith('blob:') && !url.startsWith('data:'))
-          throw new Error('External model resources are not loaded');
-        return url;
-      });
-      const parsed = await new GLTFLoader(manager).parseAsync(Uint8Array.from(bytes).buffer, '');
+      const parsed = await loadAssetGlb(bytes);
       // three's loader draws every node; hide what KHR_node_visibility hides before counting.
       applyNodeVisibility(parsed, [parsed.scene]);
       const parsedLevels = await loadViewerLevels(parsed);
+      try {
+        parsed.assertTexturesLoaded();
+      } catch (error) {
+        disposeModel(parsed.scene);
+        for (const level of detachedLevels(parsedLevels)) disposeModel(level);
+        throw error;
+      }
       const gltf = acceptLoadedResource(
         parsed,
         () => !disposed && current === generation && options.isCurrent?.() !== false,