@deepblend/dsh-blender-host 0.3.9 → 0.5.0

package/lib/asset-preview.js

@@ -1,4 +1,5 @@
 /** Fixed asset preview scenes, compiled in batch mode outside project revisions. */
+import { assertRuntimeSceneFeatures } from './runtime-scene-features.js'
 import { copyFileSync, existsSync, writeFileSync } from 'node:fs'
 import { join } from 'node:path'
 import { randomUUID } from 'node:crypto'
@@ -100,6 +101,8 @@ export async function renderAssetPreview({ runtime, asset, directory, maxMeshPol
       'The isolated preview scene is invalid.', { detail: { errors: checked.errors } })
     const compiled = compileSceneSpec(scene).spec
     writeFileSync(sceneSpecPath, JSON.stringify(compiled))
+    const featureCheck = assertRuntimeSceneFeatures(runtime, compiled, { signal })
+    if (featureCheck) await featureCheck
     const result = await runtime.compileScene({ sceneSpecPath, profile: 'preview', projectRoot: directory,
       jobId: `asset-compile-${randomUUID()}`, session: false, signal,
       onWorkingDirectory: info => { copyFileSync(join(info.directory, 'result.blend'), checkpointPath) } })

package/lib/diagnostic-preview.js

@@ -1,4 +1,5 @@
 /** Isolated inspection renders. Successful tasks are published with one directory rename. */
+import { assertRuntimeSceneFeatures } from './runtime-scene-features.js'
 import { createReadStream, copyFileSync, existsSync, mkdirSync, readdirSync, renameSync, writeFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { randomUUID } from 'node:crypto'
@@ -186,6 +187,8 @@ export async function renderDiagnostic(host, request) {
     }
     const sceneSpecPath = join(compileRoot, 'scene-spec.json'), checkpointPath = join(compileRoot, 'derived.blend')
     writeJsonAtomic(sceneSpecPath, scene)
+    const featureCheck = assertRuntimeSceneFeatures(runtime, scene, { signal })
+    if (featureCheck) await featureCheck
     const compiled = await runtime.compileScene({ sceneSpecPath, projectRoot: compileRoot, profile: 'preview',
       jobId: `${jobId}-compile`, session: false, signal,
       onWorkingDirectory: info => copyFileSync(join(info.directory, 'result.blend'), checkpointPath) })

package/lib/index.js

@@ -25,6 +25,7 @@
  * Plane: Host composition
  */
 
+import { assertRuntimeSceneFeatures } from './runtime-scene-features.js'
 import { Service } from '@deepseek-ai/cordis'
 import z from '@deepseek-ai/schemastery'
 
@@ -35,6 +36,7 @@ import {
   BlenderError,
   BlenderErrorCode,
   CREATION_REQUEST_VERSION,
+  CAMERA_UPDATE_FIELDS,
   BlenderWarningCode,
   SCENE_PATCH_VERSION,
   buildViewPlan,
@@ -626,6 +628,7 @@ export default class BlenderStudio extends Service {
   }
 
   get creationRequestProtocol() { return CREATION_REQUEST_VERSION }
+  get cameraTargetResetSupported() { return CAMERA_UPDATE_FIELDS.includes('clearTarget') }
 
   async _createProject(request, creationRequest) {
     const source = request.recipe ? this.recipes.instantiate(request.recipe) : null
@@ -1185,6 +1188,8 @@ export default class BlenderStudio extends Service {
    */
   async compileRevisionForRender(input) {
     const { projectId, revision, spec } = input
+    const featureCheck = assertRuntimeSceneFeatures(this.runtime, spec, { signal: input.signal })
+    if (featureCheck) await featureCheck
     const scratch = resolveInside(
       this.store.workspaceRoot,
       join(this.store.workspaceRoot, 'tmp', `render-${revision}-${Date.now().toString(36)}`),

package/lib/revision-transaction.js

@@ -41,6 +41,7 @@
  * Plane: Host composition
  */
 
+import { assertRuntimeSceneFeatures } from './runtime-scene-features.js'
 import { existsSync, mkdirSync, readdirSync, renameSync, statSync } from 'node:fs'
 import { randomUUID } from 'node:crypto'
 import { join } from 'node:path'
@@ -570,6 +571,8 @@ export class RevisionTransaction {
       const checkpointStaging = join(staging, 'scene.blend')
 
       try {
+        const featureCheck = assertRuntimeSceneFeatures(this.runtime, plan.spec, { signal: plan.signal })
+        if (featureCheck) await featureCheck
         const run = await this.runtime.compileScene({
           sceneSpecPath: specPath,
           profile: plan.spec.renderProfiles?.preview === undefined ? undefined : 'preview',

package/lib/runtime-scene-features.js

@@ -0,0 +1,21 @@
+import { BlenderError, BlenderErrorCode, requiredSceneFeatures } from '@deepblend/dsh-blender-contracts'
+
+/** Old runtimes must not silently compile an axis-sized box as their scalar default. */
+export function assertRuntimeSceneFeatures(runtime, spec, { signal } = {}) {
+  const required = requiredSceneFeatures(spec)
+  if (required.length === 0) return
+  return (async () => {
+    signal?.throwIfAborted()
+    const capabilities = typeof runtime?.getCapabilities === 'function'
+      ? await runtime.getCapabilities({ signal }) : null
+    signal?.throwIfAborted()
+    if (capabilities?.installed === false) {
+      throw new BlenderError(BlenderErrorCode.NOT_FOUND, 'Blender is unavailable for this scene.')
+    }
+    const supported = Array.isArray(capabilities?.sceneFeatures) ? capabilities.sceneFeatures : []
+    const missing = required.filter(feature => !supported.includes(feature))
+    if (missing.length) throw new BlenderError(BlenderErrorCode.SCENE_FEATURE_UNSUPPORTED,
+      `The runtime does not support ${missing.join(', ')}. Update the runtime before compiling this scene.`,
+      { detail: { required, supported, missing } })
+  })()
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepblend/dsh-blender-host",
-  "version": "0.3.9",
+  "version": "0.5.0",
   "type": "module",
   "description": "DeepBlend Host service: the blenderStudio business facade over the BlenderRuntime seam.",
   "main": "lib/index.js",
@@ -20,7 +20,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@deepblend/dsh-blender-contracts": "0.3.9",
+    "@deepblend/dsh-blender-contracts": "0.5.0",
     "sharp": "0.35.5"
   },
   "license": "MIT",