@series-inc/stowkit-cli 0.1.16 → 0.1.18

package/dist/app/disk-project.d.ts

@@ -72,6 +72,7 @@ export interface StowMetaGlbChild {
     sampleRate?: string;
     dracoQuality?: string;
     materialOverrides?: Record<string, string | null>;
+    sceneNodeNames?: string[];
     targetMeshId?: string | null;
     materialConfig?: {
         schemaId: string;

package/dist/orchestrator.js

@@ -149,7 +149,15 @@ export async function fullBuild(projectDir, opts) {
             }
             for (const mesh of extract.meshes) {
                 const typeName = mesh.hasSkeleton ? 'skinnedMesh' : 'staticMesh';
-                childrenManifest.push(existingChildren.get(mesh.name) ?? generateDefaultGlbChild(mesh.name, typeName));
+                const meshChild = existingChildren.get(mesh.name) ?? generateDefaultGlbChild(mesh.name, typeName);
+                // Store scene node names so AI agents can see the hierarchy in the stowmeta
+                if (mesh.imported.nodes.length > 1) {
+                    meshChild.sceneNodeNames = mesh.imported.nodes.map(n => n.name);
+                }
+                else {
+                    delete meshChild.sceneNodeNames;
+                }
+                childrenManifest.push(meshChild);
             }
             for (const mat of extract.materials) {
                 const matName = `${mat.name}.stowmat`;

package/dist/server.js

@@ -240,8 +240,15 @@ async function processGlbContainer(containerId) {
     // Process meshes
     for (const mesh of extract.meshes) {
         const typeName = mesh.hasSkeleton ? 'skinnedMesh' : 'staticMesh';
-        const existing = existingChildren.get(mesh.name);
-        childrenManifest.push(existing ?? generateDefaultGlbChild(mesh.name, typeName));
+        const meshChild = existingChildren.get(mesh.name) ?? generateDefaultGlbChild(mesh.name, typeName);
+        // Store scene node names so AI agents can see the hierarchy in the stowmeta
+        if (mesh.imported.nodes.length > 1) {
+            meshChild.sceneNodeNames = mesh.imported.nodes.map(n => n.name);
+        }
+        else {
+            delete meshChild.sceneNodeNames;
+        }
+        childrenManifest.push(meshChild);
     }
     // Process materials
     for (const mat of extract.materials) {
@@ -516,8 +523,14 @@ async function processOneAsset(id) {
     const asset = assets.find(a => a.id === id);
     if (!asset)
         return;
-    if (asset.type === AssetType.MaterialSchema)
+    if (asset.type === AssetType.MaterialSchema) {
+        // Materials are metadata-only — no encoding needed. Ensure they're always ready.
+        if (asset.status !== 'ready') {
+            asset.status = 'ready';
+            broadcast({ type: 'asset-update', id, updates: { status: 'ready' } });
+        }
         return;
+    }
     // GLB children: if source data isn't in BlobStore, re-extract from parent GLB
     // and process just this child (not the entire container)
     if (asset.parentId && !BlobStore.getSource(id)) {
@@ -734,9 +747,12 @@ async function handleRequest(req, res, staticApps) {
                 [...currentIds].some(id => !diskIds.has(id)) ||
                 [...diskIds].some(id => !currentIds.has(id));
             // Check for modified files (size or mtime changed)
+            // Skip MaterialSchema — .stowmat files are metadata-only and written by the server itself
             const modifiedIds = [];
             if (!changed) {
                 for (const asset of currentAssets) {
+                    if (asset.type === AssetType.MaterialSchema)
+                        continue;
                     const diskFile = diskFiles.get(asset.id);
                     if (diskFile && asset.sourceSize > 0 && diskFile.size !== asset.sourceSize) {
                         modifiedIds.push(asset.id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@series-inc/stowkit-cli",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "type": "module",
   "bin": {
     "stowkit": "./dist/cli.js"

package/skill.md

@@ -248,6 +248,19 @@ The build pipeline automatically:
 
 Set `"preserveHierarchy": true` on a GLB container to preserve the scene graph node hierarchy in extracted static meshes. When false (default), all mesh geometry is baked to world space and flattened. Skinned meshes are always excluded from hierarchy preservation.
 
+When preserve hierarchy is enabled, mesh children in the `.stowmeta` will include a `sceneNodeNames` array listing all scene graph nodes in that mesh:
+
+```json
+{
+  "name": "Environment",
+  "childType": "staticMesh",
+  "stringId": "environment",
+  "sceneNodeNames": ["Root", "Floor", "Wall_North", "Wall_South", "Ceiling", "Door_Frame"]
+}
+```
+
+This lets you see which nodes are in the hierarchy without reading the binary processed data. The array is automatically populated during extraction and only appears when the mesh has more than one node.
+
 ### GLB child settings
 
 Each child in the `children` array supports the same settings as its corresponding standalone asset type: