@series-inc/stowkit-cli 0.1.16 → 0.1.17

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) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@series-inc/stowkit-cli",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "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: