reasoning Static interface comparison

Vectreal

3.2.0 3.3.0

REVIEWPending human review

1 schema change requires review.No new authority detected.

View the upgrade review as Markdown

A shareable summary of this comparison for an issue, pull request or ticket. Select the text and copy it.

Tools13 → 13
Added0
Removed0
Schema changes1
Input schema changes1
Output schema changes0
Unclassified schema changes0
Description changes3
New write authority0
New destructive authority0
New unknown authority0
AnalysisREVIEW

INTERFACE DIFF

What changed, tool by tool

Classification from the recorded findings · definitions from the published snapshots

3 tools with recorded changes

  1. get_scene_settingsModifiedDescriptionINFO

    What changed

    • get_scene_settings: description changed.

    Why it could matter

    • Models choose and call tools partly from their descriptions.

    What to verify

    • Spot-check that agents still select this tool as intended.
    Declared effect
    read → read
    Description
    PreviousEvery settings section of a scene (environment, controls, bounds, shadows, presentation, camera, hotspots, interactions, animation, normalization), defaults filled in.
    CurrentEvery settings section of a scene (lighting, environment, controls, bounds, shadows, presentation, camera, hotspots, interactions, animation, normalization), defaults filled in.

    Input schema

    Input schema unchanged.

    2 unchanged entries
    • (schema root)
    • sceneId

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  2. publish_sceneModifiedDescriptionINFO

    What changed

    • publish_scene: description changed.

    Why it could matter

    • Models choose and call tools partly from their descriptions.

    What to verify

    • Spot-check that agents still select this tool as intended.
    Declared effect
    write → write
    Description
    PreviousCompresses a local GLB the way the publisher exports it (Draco geometry and KTX2 textures, each on unless turned off) and publishes it as what the scene's visitors load. Send the GLB the scene was created from. Publishing again replaces it.
    CurrentCompresses a local GLB the way the publisher exports it (Draco geometry and KTX2 textures, each on unless turned off) and publishes it as what the scene's visitors load. Send the GLB the scene was created from. Publishing again replaces it. Ambient occlusion and studio lights the scene's lighting asks to bake are not baked here, which needs a GPU: the result warns, and publishing from the Publisher bakes them.

    Input schema

    Input schema unchanged.

    5 unchanged entries
    • (schema root)
    • draco
    • ktx2
    • path
    • sceneId

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  3. update_scene_settingsModifiedSchemaDescriptionREVIEWINFO

    What changed

    • update_scene_settings — Schema change: input property settings changed: properties {"bounds":{"propert… → {"bounds":{"propert….
    • update_scene_settings: description changed.

    Why it could matter

    • Calls or consumers built for the earlier schema may need to change.
    • Models choose and call tools partly from their descriptions.

    What to verify

    • Validate representative existing tool calls against the new argument schema.
    • Spot-check that agents still select this tool as intended.
    Declared effect
    write → write
    Description
    PreviousReplaces the environment, controls, bounds, shadows or presentation sections sent; each section sent is stored whole with the keys it leaves out at their defaults, so read the section with get_scene_settings and send it back changed. Camera, hotspots, interactions, animation and normalization are read-only here. Live embeds show the change at once.
    CurrentReplaces the lighting, environment, controls, bounds, shadows or presentation sections sent; each section sent is stored whole with the keys it leaves out at their defaults, so read the section with get_scene_settings and send it back changed. Camera, hotspots, interactions, animation and normalization are read-only here. Lighting supersedes environment and shadows: those two only show on a scene with no lighting section, so change lighting. Live embeds show the change at once.

    Input schema

    PropertyPrevious (3.2.0)Current (3.3.0)Change
    settings › lightingnot presentobjectoptional
    • Added
    settings › lighting › backgroundnot presentoneOf (4)optional
    • Added
    settings › lighting › bakenot presentobjectoptional
    • Added
    settings › lighting › bake › lightsnot presentbooleanoptional
    • Added
    settings › lighting › environmentnot presentobjectoptional
    • Added
    settings › lighting › environment › intensitynot presentnumber, minimum=0optional
    • Added
    settings › lighting › environment › mapnot presentstring, enum (15)optional
    • Added
    settings › lighting › environment › resolutionnot presentstring, enum (2)optional
    • Added
    settings › lighting › environment › rotationnot presentnumberoptional
    • Added
    settings › lighting › groundnot presentobjectoptional
    • Added
    settings › lighting › ground › enablednot presentbooleanoptional
    • Added
    settings › lighting › lightsnot presentarrayoptional
    • Added
    settings › lighting › lights › [items]not presentobject
    • Added
    settings › lighting › lights › [items] › azimuthnot presentnumberoptional
    • Added
    settings › lighting › lights › [items] › colornot presentstring, pattern="^#[0-9a-f]{6}$"optional
    • Added
    settings › lighting › lights › [items] › elevationnot presentnumber, maximum=90, minimum=-90optional
    • Added
    settings › lighting › lights › [items] › enablednot presentbooleanoptional
    • Added
    settings › lighting › lights › [items] › intensitynot presentnumber, minimum=0optional
    • Added
    settings › lighting › lights › [items] › rolenot presentstring, enum (3)required
    • Added
    settings › lighting › lights › [items] › sizenot presentnumber, maximum=180, minimum=0optional
    • Added
    settings › lighting › occlusionnot presentobjectoptional
    • Added
    settings › lighting › occlusion › livenot presentobjectoptional
    • Added
    settings › lighting › occlusion › live › atRestnot presentbooleanoptional
    • Added
    settings › lighting › occlusion › live › intensitynot presentnumber, minimum=0optional
    • Added
    settings › lighting › occlusion › modenot presentstring, enum (3)optional
    • Added
    75 unchanged entries
    • (schema root)
    • sceneId
    • settings
    • settings › bounds
    • settings › bounds › clip
    • settings › bounds › enable
    • settings › bounds › fit
    • settings › bounds › margin
    • settings › bounds › maxDuration
    • settings › bounds › observe
    • settings › controls
    • settings › controls › autoRotate
    • settings › controls › autoRotateSpeed
    • settings › controls › controlsTimeout
    • settings › controls › dampingFactor
    • settings › controls › enableDamping
    • settings › controls › enablePan
    • settings › controls › enableRotate
    • settings › controls › enableZoom
    • settings › controls › makeDefault
    • settings › controls › maxDistance
    • settings › controls › maxPolarAngle
    • settings › controls › minDistance
    • settings › controls › minPolarAngle
    • settings › controls › panSpeed
    • settings › controls › rotateSpeed
    • settings › controls › zoomSpeed
    • settings › environment
    • settings › environment › backdrop
    • settings › environment › background
    • settings › environment › backgroundBlurriness
    • settings › environment › backgroundIntensity
    • settings › environment › environmentIntensity
    • settings › environment › environmentResolution
    • settings › environment › preset
    • settings › presentation
    • settings › presentation › compressTexturesForGpu
    • settings › presentation › showInfoPopover
    • settings › presentation › showLoadingThumbnail
    • settings › presentation › showSceneViewReturn
    • settings › shadows
    • settings › shadows › alphaTest
    • settings › shadows › ao
    • settings › shadows › aoAtRest
    • settings › shadows › aoIntensity
    • settings › shadows › baked
    • settings › shadows › baked › assetId
    • settings › shadows › baked › basis
    • settings › shadows › baked › basis › footprint
    • settings › shadows › baked › basis › radius
    • settings › shadows › baked › basis › vertexCount
    • settings › shadows › baked › signature
    • settings › shadows › color
    • settings › shadows › colorBlend
    • settings › shadows › contact
    • settings › shadows › contact › blur
    • settings › shadows › contact › enabled
    • settings › shadows › contact › opacity
    • settings › shadows › contact › reach
    • settings › shadows › contact › scale
    • settings › shadows › cutoffScale
    • settings › shadows › enabled
    • settings › shadows › frames
    • settings › shadows › light
    • settings › shadows › light › ambient
    • settings › shadows › light › amount
    • settings › shadows › light › bias
    • settings › shadows › light › intensity
    • settings › shadows › light › position
    • settings › shadows › light › position › [items]
    • settings › shadows › light › radius
    • settings › shadows › opacity
    • settings › shadows › resolution
    • settings › shadows › scale
    • settings › shadows › temporal

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
10 tools with no recorded change
  • create_project
  • create_scene_from_file
  • describe_model
  • get_embed_snippet
  • list_projects
  • list_scenes
  • read_doc
  • search_docs
  • unpublish_scene
  • whoami

Evidence and provenance

Static findings
REVIEW from Modelara’s automated analysis of the two declared interfaces. A policy outcome, not a security rating or a runtime test.
Human review
Pending human review. No reviewer decision is recorded for this comparison.
Published evidence
Part of Valyd’s published data generation listed in valyd-data-source.json. Published records are not rewritten.
Show provenance and exact files
Comparison
vectreal/3.2.0~3.3.0The published comparison identifier.
Analyzer
modelara v0.1.8Policy version not recorded.Analyzed Nov 16, 2026, 10:46 PM UTC.
Distribution
npm
Previous release
@vctrl/cli@3.2.013 tools · published by the registry Oct 30, 2026, 12:25 PM UTCArtifact integritysha512-11dMOb6QQY+M1Ukkshuo3NtQDgGK6F/FTawvnvMYIR7sdt3H3U8WKQYHbCFyjaAW9d5/PoaeUmkqhSJOjPEPZg==Interface fingerprintsha256:2177b78c2798d01069d794f72d8ac30c3ee0b81c343284b0aeedd864335b9cc0Exact interface snapshot (JSON)
Current release
@vctrl/cli@3.3.013 tools · published by the registry Nov 1, 2026, 12:56 PM UTCArtifact integritysha512-t7RJ2e0q+owrMtNPYNqTWdJVgsR58+p1StiB+P3txfZbebviL/0ceAtqXlJd/xEu5PBt25eopYlsH/UNPPPtdA==Interface fingerprintsha256:bdb138fa698a57c25936cc570fe0610282f0d1e8e7a58d8da64ace6dede41454Exact interface snapshot (JSON)

The integrity value or digest identifies the exact artifact that was inspected; it does not show that the package is safe. The interface fingerprint identifies the declared tools and schemas Modelara recorded for that release.

MODELARA ANALYSIS OUTPUT

Interface findings

Analyzed with Modelara v0.1.8 · Nov 16, 2026

Requires review

1 finding
  • update_scene_settingsREVIEWChanged

    Input schema changed

    Show details
    • input property settings changed: properties {"bounds":{"propert… → {"bounds":{"propert…
    Authority
    WRITEWRITE
    Authority unchanged

Informational

3 findings
  • get_scene_settingsINFOChanged

    Description changed

    Authority
    READREAD
    Authority unchanged
  • publish_sceneINFOChanged

    Description changed

    Authority
    WRITEWRITE
    Authority unchanged
  • update_scene_settingsINFOChanged

    Description changed

    Authority
    WRITEWRITE
    Authority unchanged
What do these results mean?
PASS
No policy-significant interface change detected.
REVIEW
Interface changes require inspection.
FAIL
A policy-significant change was detected.
INVALID
The comparison could not be evaluated reliably.
← Back to Vectreal release history