@deepblend/dsh-blender-tool 0.8.1 → 0.9.0

package/lib/tools.js

@@ -38,6 +38,8 @@ import {
   CREATION_REQUEST_VERSION,
   BlenderWarningCode,
   warning,
+  verifyGeometryReport,
+  validateGeometrySelection,
 } from '@deepblend/dsh-blender-contracts'
 
 import {
@@ -388,10 +390,18 @@ function sceneGet(ctx) {
       'location and visibility, camera parameters, animation tracks and the render profiles. That is ' +
       'usually everything you need to decide what to change. Pass full:true to also get the complete ' +
       'SceneSpec document, which you should do only when you actually need exact field values. ' +
+      'To measure saved native parts, pass geometryEntityIds (1–8 IDs from this scene) and an explicit geometryFrame. ' +
+      'This returns source-verified world-axis spans in millimeters and transforms without rendering or creating a revision. ' +
+      'Spans include rotation, handles and protrusions; they are not body diameter, wall thickness, clearance or quality approval. ' +
+      'Do not subtract shell/liner spans or radii to claim a gap, or use unchanged height/scale to certify wall thickness. Those surface conditions remain unmeasured. ' +
       'ALWAYS use the revision this returns as `baseRevision` for your next blender_scene_patch.',
     parameters: {
       projectId: { type: 'string', required: true, description: 'The project id.' },
       revision: { type: 'string', description: 'Read a specific revision instead of the current one.' },
+      geometryEntityIds: { type: 'array', items: { type: 'string' },
+        description: 'Optional: measure 1–8 distinct saved native entity IDs. Requires geometryFrame. Hidden viewport objects and non-mesh roots are explicitly unavailable.' },
+      geometryFrame: { type: 'integer',
+        description: 'Explicit integer frame from 0 to 1000000 for native geometry measurement. Use the frame of the preview being checked. Requires geometryEntityIds.' },
       full: {
         type: 'boolean',
         description: 'Also return the complete SceneSpec and its compiled form. Costs a lot of context — ' +
@@ -403,10 +413,27 @@ function sceneGet(ctx) {
       const resolved = resolveStudio(ctx)
       if (resolved.unavailable !== undefined) return { ok: false, ...resolved.unavailable }
       try {
+        if ((args.geometryEntityIds === undefined) !== (args.geometryFrame === undefined)) {
+          throw new BlenderError(BlenderErrorCode.SCRIPT_ERROR, 'Native measurements require both geometryEntityIds and geometryFrame.')
+        }
+        if (args.geometryEntityIds !== undefined) validateGeometrySelection({ entityIds: args.geometryEntityIds,
+          frame: args.geometryFrame, checkpointSha256: '0'.repeat(64) })
         const { data, canonicalWarnings } = await canonicalCall(resolved.studio.getScene(args.projectId, {
           ...definedFields({ revision: args.revision }),
           full: args.full === true,
+          ...(args.geometryEntityIds === undefined ? {} : { geometry: { entityIds: args.geometryEntityIds, frame: args.geometryFrame }, signal: exec?.signal }),
         }), warning)
+        if (args.geometryEntityIds !== undefined && (!data.geometryInspection || data.geometryInspection.schemaVersion !== 'deepblend.scene-geometry/v1' ||
+            data.geometryInspection.projectId !== args.projectId || data.geometryInspection.sourceRevision !== data.revision ||
+            data.geometryInspection.sourceDigest !== data.digest || data.geometryInspection.sourceUnchanged !== true || data.geometryInspection.frame !== args.geometryFrame ||
+            !Array.isArray(data.geometryInspection.limitations) ||
+            JSON.stringify(data.geometryInspection.objects?.map(o => o.entityId)) !== JSON.stringify(args.geometryEntityIds))) {
+          throw new BlenderError(BlenderErrorCode.RUNTIME_UNAVAILABLE, 'The Host did not return measurements for the requested source and frame. Upgrade DeepBlend before measuring; ordinary scene reads remain available.')
+        }
+        if (data.geometryInspection) verifyGeometryReport({ frame: data.geometryInspection.frame, blenderVersion: data.geometryInspection.blenderVersion, objects: data.geometryInspection.objects,
+          schemaVersion: 'deepblend.geometry-inspection/v1', checkpointSha256: data.geometryInspection.sourceCheckpointSha256,
+          checkpointUnchanged: data.geometryInspection.sourceUnchanged }, { entityIds: args.geometryEntityIds, frame: args.geometryFrame,
+          checkpointSha256: data.geometryInspection.sourceCheckpointSha256 })
         const counts = data.counts ?? {}
         const notes = [
           `Revision ${data.revision}${data.isCurrent ? ' (current)' : ' (NOT current — patches against it will be refused)'}`,
@@ -417,6 +444,9 @@ function sceneGet(ctx) {
           '',
           'Entities:',
         ]
+        if (data.geometryInspection) notes.splice(notes.length - 2, 0,
+          `Measured saved native geometry at frame ${data.geometryInspection.frame}; source SHA256 ${data.geometryInspection.sourceCheckpointSha256}.`,
+          ...data.geometryInspection.limitations)
         for (const entity of data.entities ?? []) {
           notes.push(
             `  ${entity.id.padEnd(22)} ${String(entity.type).padEnd(15)} ${String(entity.shape ?? '-').padEnd(12)}` +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepblend/dsh-blender-tool",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "type": "module",
   "description": "Agent-preset tool consumer: registers the model-visible DeepBlend Blender tools. Publishes no service.",
   "main": "lib/index.js",
@@ -11,7 +11,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@deepblend/dsh-blender-contracts": "0.8.1"
+    "@deepblend/dsh-blender-contracts": "0.9.0"
   },
   "license": "MIT",
   "repository": {