@womp/spark-agent 5.0.1 → 5.0.2

package/dist/capabilities/scene.js

@@ -108,14 +108,15 @@ Check font, HDR, and material catalogs before selecting names. A host can explic
 unavailable. Selecting an HDR resets its intensity; apply a custom intensity after selecting it.
 For library materials, use listSuperMaterials(), then await materialImport(name) inside scene.access and assign the returned numeric ID the way that object requires: nodeSetMaterialId or curvePointSetMaterialId for scene nodes, the FlowIR SetMaterial node for a Geometry Nodes graph. A failed import rolls back the draft.
 Filter large read results with JavaScript and print only useful details.
-After a major edit, capture a screenshot outside the transaction and emitImage its reference.
-screenshot() captures the current Kakapo viewport without moving or fitting the camera.
+After a major edit, capture a screenshot outside the transaction and emitImage its reference.
 screenshot({ camera: { position: {x,y,z}, target: {x,y,z}, projection: 'perspective', horizontalFovDegrees: 60 } })
-sets a world-space camera in Womp scene coordinates and current project units (Y-up), and leaves it active.
-Use horizontalFovDegrees for perspective zoom, or projection: 'orthographic' with orthographicWidth in project units.
-Omitted projection/lens settings are preserved. Position and target are required together; avoid coincident points or an exactly vertical direction.
-Pass an explicit camera again for repeatable captures; targetId and view presets are not supported.
-Respect the host's camera-lock restrictions. Only claim visual verification for features visible in the captured view. Verify silhouette,
+sets a world-space camera in the same Womp coordinates and project units as scene positions (Y-up).
+For orthographic framing use projection: 'orthographic' and orthographicWidth in project units instead of FOV.
+Direction is derived from position/target; do not use coincident points or an exactly vertical viewing direction.
+Omitted projection/lens settings come from the active camera. Pass the camera again for repeatable captures.
+For object-focused screenshots, identify the requested object and frame it using world-space bounds. Convert local bounds using the object’s and applicable ancestor transforms, including translation, rotation, and scale; do not transform world-space bounds again. Reuse established framing when appropriate and avoid clipping the subject.
+Omitting camera captures the active viewport without auto-fit. Use it when the user asks about the current viewport or clearly refers to what is visible on screen, not on the assumption that it shows the requested object.
+Respect the host's camera-lock restrictions. Verify silhouette,
 connections, openings, proportions, and materials before claiming completion. Use the owning top-level Area for scene-space bounds;
 OpenSCAD part bounds are local to the part; individual primitive and curve bounds are unsupported. Renderer bounds and resize calls
 must finish before subsequent writes. Inside scene.access, complete renderer-backed bounds reads before the first
@@ -126,9 +127,7 @@ A failed script can retain earlier committed effects. Use receipts and inspect u
                     "print(await womp.scene.health());",
                     "print(await womp.scene.health([objectId]));",
                     "print(await womp.scene.access(scene => scene.nodes({ name: 'body' })));",
-                    "const unit = await womp.scene.access(scene => scene.unitMultiplier); await emitImage(await womp.scene.screenshot({ camera: { position: { x: 100 * unit, y: 75 * unit, z: 100 * unit }, target: { x: 0, y: 0, z: 0 }, projection: 'perspective', horizontalFovDegrees: 60 } }));",
-                    "const unit = await womp.scene.access(scene => scene.unitMultiplier); await emitImage(await womp.scene.screenshot({ camera: { position: { x: 0, y: 25 * unit, z: 100 * unit }, target: { x: 0, y: 0, z: 0 }, projection: 'orthographic', orthographicWidth: 80 * unit } }));",
-                    "const result = await womp.scene.access(scene => { const diameter = 20 * scene.unitMultiplier; const areaId = scene.nodeCreate(scene.NodeType.Union, 0); const bodyId = scene.nodeCreate(scene.NodeType.Primitive, areaId); scene.nodeSetName(bodyId, '20 mm orange sphere'); scene.nodeSetPrimType(bodyId, scene.PrimitiveType.Sphere); scene.nodeSetSize(bodyId, { x: diameter, y: diameter, z: diameter }); scene.nodeSetPos(bodyId, { x: 0, y: diameter / 2, z: 0 }); const materialId = scene.materialCreate(); scene.materialSetColor(materialId, { r: 255, g: 128, b: 0 }); scene.nodeSetMaterialId(bodyId, materialId); return { areaId, bodyId }; }); print(result); await emitImage(await womp.scene.screenshot());",
+                    "const snapshot = await womp.scene.access(scene => ({ unitMultiplier: scene.unitMultiplier })); const diameter = 20 * snapshot.unitMultiplier; const result = await womp.scene.access(scene => { const areaId = scene.nodeCreate(scene.NodeType.Union, 0); const bodyId = scene.nodeCreate(scene.NodeType.Primitive, areaId); scene.nodeSetName(bodyId, '20 mm orange sphere'); scene.nodeSetPrimType(bodyId, scene.PrimitiveType.Sphere); scene.nodeSetSize(bodyId, { x: diameter, y: diameter, z: diameter }); scene.nodeSetPos(bodyId, { x: 0, y: diameter / 2, z: 0 }); const materialId = scene.materialCreate(); scene.materialSetColor(materialId, { r: 255, g: 128, b: 0 }); scene.nodeSetMaterialId(bodyId, materialId); return { areaId, bodyId }; }); print(result); await emitImage(await womp.scene.screenshot({ camera: { position: { x: diameter * 2, y: diameter * 1.5, z: diameter * 2 }, target: { x: 0, y: diameter / 2, z: 0 }, projection: 'perspective', horizontalFovDegrees: 60 } }));",
                 ],
             },
         ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@womp/spark-agent",
-  "version": "5.0.1",
+  "version": "5.0.2",
   "description": "Portable skills-based AI agent with local and durable chat transports for Womp",
   "type": "module",
   "main": "./dist/index.js",