sceneview-mcp 4.0.11 → 4.0.13

package/dist/samples.js

@@ -1,11 +1,12 @@
+import { LATEST_SCENEVIEW_RELEASE } from "./generated/version.js";
 export const SAMPLES = {
     "model-viewer": {
         id: "model-viewer",
         title: "3D Model Viewer",
         description: "Full-screen 3D scene with a GLB model, HDR environment, orbit camera, and animation controls",
         tags: ["3d", "model", "environment", "camera", "animation"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create an Android Compose screen that loads a GLB model and displays it with HDR lighting, orbit camera, and animation playback. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create an Android Compose screen that loads a GLB model and displays it with HDR lighting, orbit camera, and animation playback. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun ModelViewerScreen() {
     val engine = rememberEngine()
@@ -38,8 +39,8 @@ fun ModelViewerScreen() {
         title: "AR Tap-to-Place Model Viewer",
         description: "AR scene with plane detection. Tap a surface to place a 3D model with pinch-to-scale and drag-to-rotate gestures.",
         tags: ["ar", "model", "anchor", "plane-detection", "placement", "gestures"],
-        dependency: "io.github.sceneview:arsceneview:4.0.0",
-        prompt: "Create an AR screen that detects surfaces and lets the user tap to place a GLB model. Support pinch-to-scale and drag-to-rotate. Use SceneView `io.github.sceneview:arsceneview:4.0.0`.",
+        dependency: "io.github.sceneview:arsceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create an AR screen that detects surfaces and lets the user tap to place a GLB model. Support pinch-to-scale and drag-to-rotate. Use SceneView `io.github.sceneview:arsceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun ARModelViewerScreen() {
     val engine = rememberEngine()
@@ -83,8 +84,8 @@ fun ARModelViewerScreen() {
         title: "AR Augmented Image",
         description: "Detects reference images in the camera feed and overlays 3D models or video above them.",
         tags: ["ar", "model", "image-tracking"],
-        dependency: "io.github.sceneview:arsceneview:4.0.0",
-        prompt: "Create an AR screen that detects a printed reference image and places a 3D model above it. Use SceneView `io.github.sceneview:arsceneview:4.0.0`.",
+        dependency: "io.github.sceneview:arsceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create an AR screen that detects a printed reference image and places a 3D model above it. Use SceneView `io.github.sceneview:arsceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun AugmentedImageScreen() {
     val engine = rememberEngine()
@@ -125,8 +126,8 @@ fun AugmentedImageScreen() {
         title: "AR Cloud Anchor",
         description: "Host and resolve persistent cross-device anchors using ARCore Cloud Anchors.",
         tags: ["ar", "anchor", "cloud-anchor"],
-        dependency: "io.github.sceneview:arsceneview:4.0.0",
-        prompt: "Create an AR screen that can host a cloud anchor (saving its ID) and resolve it later on another device. Use SceneView `io.github.sceneview:arsceneview:4.0.0`.",
+        dependency: "io.github.sceneview:arsceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create an AR screen that can host a cloud anchor (saving its ID) and resolve it later on another device. Use SceneView `io.github.sceneview:arsceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `// ⚠️ Cloud Anchors require an ARCore Cloud API key in AndroidManifest.xml:
 //   <meta-data android:name="com.google.android.ar.API_KEY"
 //              android:value="\${arcoreApiKey}" />
@@ -164,8 +165,8 @@ fun CloudAnchorScreen() {
         title: "AR Point Cloud",
         description: "Visualizes ARCore feature points as 3D spheres with confidence-based filtering.",
         tags: ["ar", "point-cloud"],
-        dependency: "io.github.sceneview:arsceneview:4.0.0",
-        prompt: "Create an AR screen that visualizes ARCore feature points as small 3D spheres, filtered by confidence. Use SceneView `io.github.sceneview:arsceneview:4.0.0`.",
+        dependency: "io.github.sceneview:arsceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create an AR screen that visualizes ARCore feature points as small 3D spheres, filtered by confidence. Use SceneView `io.github.sceneview:arsceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun PointCloudScreen() {
     val engine = rememberEngine()
@@ -196,8 +197,8 @@ fun PointCloudScreen() {
         title: "AR Face Mesh",
         description: "AR face tracking with AugmentedFaceNode — applies a textured mesh overlay to detected faces using the front camera.",
         tags: ["ar", "face-tracking", "model"],
-        dependency: "io.github.sceneview:arsceneview:4.0.0",
-        prompt: "Create an AR screen that uses the front camera to detect faces and overlay a 3D mesh on them. Use SceneView `io.github.sceneview:arsceneview:4.0.0`.",
+        dependency: "io.github.sceneview:arsceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create an AR screen that uses the front camera to detect faces and overlay a 3D mesh on them. Use SceneView `io.github.sceneview:arsceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun ARFaceMeshScreen() {
     val engine = rememberEngine()
@@ -240,8 +241,8 @@ fun ARFaceMeshScreen() {
         title: "glTF Camera",
         description: "Extracts and uses camera definitions embedded in a glTF file for cinematic viewpoints.",
         tags: ["3d", "model", "camera"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene that loads a GLB file containing embedded camera definitions, then uses those cameras for cinematic viewpoints. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene that loads a GLB file containing embedded camera definitions, then uses those cameras for cinematic viewpoints. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun GltfCameraScreen() {
     val engine = rememberEngine()
@@ -270,8 +271,8 @@ fun GltfCameraScreen() {
         title: "Camera Manipulator",
         description: "Orbit, pan, and zoom camera with customizable sensitivity and bounds.",
         tags: ["3d", "camera", "gestures"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene with a fully configurable orbit camera — drag to rotate, two-finger pan, pinch to zoom. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene with a fully configurable orbit camera — drag to rotate, two-finger pan, pinch to zoom. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun CameraManipulatorScreen() {
     val engine = rememberEngine()
@@ -301,8 +302,8 @@ fun CameraManipulatorScreen() {
         title: "Camera Animation",
         description: "Animated camera flythrough around a 3D model — smooth orbit using LaunchedEffect and trigonometric interpolation.",
         tags: ["3d", "camera", "animation", "model"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene with a camera that automatically orbits around a model in a smooth circle. Include a play/pause button. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene with a camera that automatically orbits around a model in a smooth circle. Include a play/pause button. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun CameraAnimationScreen() {
     val engine = rememberEngine()
@@ -362,8 +363,8 @@ fun CameraAnimationScreen() {
         title: "Autopilot Demo",
         description: "Autonomous driving HUD with animated car, road geometry, and real-time telemetry overlay.",
         tags: ["3d", "model", "animation", "geometry"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create an autopilot-style visualization with a 3D car on a road and a HUD overlay showing speed, distance, and status. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create an autopilot-style visualization with a 3D car on a road and a HUD overlay showing speed, distance, and status. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun AutopilotScreen() {
     val engine = rememberEngine()
@@ -431,8 +432,8 @@ fun AutopilotScreen() {
         title: "Physics Simulation",
         description: "Animated physics simulation with spheres falling under gravity and bouncing off a floor, using onFrame for per-frame updates.",
         tags: ["3d", "physics", "geometry", "animation"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene with spheres that fall under gravity and bounce on a floor using per-frame animation. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene with spheres that fall under gravity and bounce on a floor using per-frame animation. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun PhysicsDemoScreen() {
     val engine = rememberEngine()
@@ -524,8 +525,8 @@ fun PhysicsDemoScreen() {
         title: "Dynamic Sky & Lighting",
         description: "Time-of-day sun cycle with animated LightNode direction, intensity, and color to simulate sunrise through sunset.",
         tags: ["3d", "sky", "environment", "animation", "lighting"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene with a time-of-day sun that moves from sunrise through noon to sunset, with animated light color and intensity. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene with a time-of-day sun that moves from sunrise through noon to sunset, with animated light color and intensity. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun DynamicSkyScreen() {
     val engine = rememberEngine()
@@ -608,8 +609,8 @@ fun DynamicSkyScreen() {
         title: "Line & Path",
         description: "Animated 3D line art with sine waves and Lissajous curves using PathNode and LineNode, with parameter sliders.",
         tags: ["3d", "lines", "geometry", "animation"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene that draws animated parametric curves (sine wave, Lissajous) using PathNode with amplitude and frequency sliders. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene that draws animated parametric curves (sine wave, Lissajous) using PathNode with amplitude and frequency sliders. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun LinePathScreen() {
     val engine = rememberEngine()
@@ -685,8 +686,8 @@ fun LinePathScreen() {
         title: "Text Labels",
         description: "Camera-facing 3D text labels using TextNode — floating labels above geometry spheres representing planets.",
         tags: ["3d", "text", "geometry"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene with floating text labels above colored spheres representing planets. Use TextNode for the labels. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene with floating text labels above colored spheres representing planets. Use TextNode for the labels. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun TextLabelsScreen() {
     val engine = rememberEngine()
@@ -743,8 +744,8 @@ fun TextLabelsScreen() {
         title: "Reflection Probe",
         description: "Zone-based IBL overrides with material picker (Chrome, Gold, Copper, Rough) and probe toggle.",
         tags: ["3d", "reflection", "environment", "model"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene with a metallic sphere and a ReflectionProbeNode that overrides the IBL. Add a material picker to switch between Chrome, Gold, Copper, and Rough. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene with a metallic sphere and a ReflectionProbeNode that overrides the IBL. Add a material picker to switch between Chrome, Gold, Copper, and Rough. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun ReflectionProbeScreen() {
     val engine = rememberEngine()
@@ -779,8 +780,8 @@ fun ReflectionProbeScreen() {
         title: "Post-Processing",
         description: "Real-time post-processing effects: bloom, vignette, tone mapping, FXAA, and SSAO controls.",
         tags: ["3d", "post-processing", "environment"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene with interactive post-processing controls for bloom, vignette, tone mapping, FXAA, and SSAO. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene with interactive post-processing controls for bloom, vignette, tone mapping, FXAA, and SSAO. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun PostProcessingScreen() {
     val engine = rememberEngine()
@@ -807,8 +808,8 @@ fun PostProcessingScreen() {
         title: "Video Texture",
         description: "Video playback on a 3D plane using VideoNode with MediaPlayer — supports looping, chroma-key, and auto-sizing.",
         tags: ["3d", "video", "model"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene with a video playing on a floating 3D plane. Include play/pause controls and chroma-key support. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene with a video playing on a floating 3D plane. Include play/pause controls and chroma-key support. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun VideoTextureScreen() {
     val context = LocalContext.current
@@ -857,8 +858,8 @@ fun VideoTextureScreen() {
         title: "Multi-Model Scene",
         description: "Scene with multiple 3D models loaded independently, positioned and scaled to create a complete environment.",
         tags: ["3d", "model", "multi-model", "environment"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene that loads multiple GLB models (a car, a building, and trees) and positions them to form a street scene. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene that loads multiple GLB models (a car, a building, and trees) and positions them to form a street scene. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun MultiModelScreen() {
     val engine = rememberEngine()
@@ -923,8 +924,8 @@ fun MultiModelScreen() {
         title: "Gesture Interaction",
         description: "Full gesture handling — tap to select, double-tap to scale, long-press for info, pinch-to-scale, drag-to-move on editable nodes.",
         tags: ["3d", "gestures", "model"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene with a model that responds to tap (select), double-tap (scale up), long-press (show info), and supports pinch-to-scale and drag-to-move. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene with a model that responds to tap (select), double-tap (scale up), long-press (show info), and supports pinch-to-scale and drag-to-move. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun GestureInteractionScreen() {
     val engine = rememberEngine()
@@ -987,8 +988,8 @@ fun GestureInteractionScreen() {
         title: "Environment & Lighting",
         description: "Complete lighting setup — HDR environment (IBL + skybox), main directional light, point light, and spot light with LightNode.",
         tags: ["3d", "environment", "lighting", "model"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene with full HDR environment lighting (IBL + skybox), a directional sun light, a red point light, and a blue spot light. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene with full HDR environment lighting (IBL + skybox), a directional sun light, a red point light, and a blue spot light. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun EnvironmentLightingScreen() {
     val engine = rememberEngine()
@@ -1056,8 +1057,8 @@ fun EnvironmentLightingScreen() {
         title: "Procedural Geometry",
         description: "Procedural shapes — CubeNode, SphereNode, CylinderNode, PlaneNode — with PBR materials (metallic, roughness, color).",
         tags: ["3d", "geometry", "model"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene showing procedural geometry shapes (cube, sphere, cylinder, plane) with different PBR materials. No model files needed. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene showing procedural geometry shapes (cube, sphere, cylinder, plane) with different PBR materials. No model files needed. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun ProceduralGeometryScreen() {
     val engine = rememberEngine()
@@ -1136,8 +1137,8 @@ fun ProceduralGeometryScreen() {
         title: "Compose UI in 3D",
         description: "Embed interactive Jetpack Compose UI (Cards, Buttons, Text) inside 3D space using ViewNode.",
         tags: ["3d", "compose-ui", "text"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene with interactive Compose UI elements (Card with text and a button) floating in 3D space using ViewNode. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene with interactive Compose UI elements (Card with text and a button) floating in 3D space using ViewNode. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun ComposeUI3DScreen() {
     val engine = rememberEngine()
@@ -1186,8 +1187,8 @@ fun ComposeUI3DScreen() {
         title: "Node Hierarchy",
         description: "Parent-child node relationships — a spinning solar system with planet groups orbiting a central sun.",
         tags: ["3d", "hierarchy", "geometry", "animation"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D solar system where planets orbit a sun using parent-child node hierarchies. Each planet group rotates independently. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D solar system where planets orbit a sun using parent-child node hierarchies. Each planet group rotates independently. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun NodeHierarchyScreen() {
     val engine = rememberEngine()
@@ -1267,7 +1268,7 @@ fun NodeHierarchyScreen() {
         title: "iOS 3D Model Viewer",
         description: "SwiftUI 3D scene with a USDZ model, IBL environment, orbit camera, and animation playback.",
         tags: ["3d", "model", "environment", "camera", "animation", "ios", "swift"],
-        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0\"",
+        dependency: `https://github.com/sceneview/sceneview — from: "${LATEST_SCENEVIEW_RELEASE}"`,
         spmDependency: "https://github.com/sceneview/sceneview",
         prompt: "Create a SwiftUI screen that loads a USDZ model and displays it with IBL lighting, orbit camera, and animation playback. Use SceneViewSwift.",
         language: "swift",
@@ -1306,7 +1307,7 @@ struct ModelViewerScreen: View {
         title: "iOS AR Tap-to-Place Model Viewer",
         description: "AR scene with plane detection. Tap a surface to place a 3D model using ARKit + RealityKit.",
         tags: ["ar", "model", "anchor", "plane-detection", "placement", "ios", "swift"],
-        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0\"",
+        dependency: `https://github.com/sceneview/sceneview — from: "${LATEST_SCENEVIEW_RELEASE}"`,
         spmDependency: "https://github.com/sceneview/sceneview",
         prompt: "Create an iOS AR screen that detects surfaces and lets the user tap to place a USDZ model. Use SceneViewSwift.",
         language: "swift",
@@ -1346,7 +1347,7 @@ struct ARModelViewerScreen: View {
         title: "iOS AR Augmented Image",
         description: "Detects reference images in the camera feed and overlays 3D content above them using ARKit.",
         tags: ["ar", "model", "image-tracking", "ios", "swift"],
-        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0\"",
+        dependency: `https://github.com/sceneview/sceneview — from: "${LATEST_SCENEVIEW_RELEASE}"`,
         spmDependency: "https://github.com/sceneview/sceneview",
         prompt: "Create an iOS AR screen that detects a printed reference image and places a 3D model above it. Use SceneViewSwift.",
         language: "swift",
@@ -1384,7 +1385,7 @@ struct AugmentedImageScreen: View {
         title: "iOS Procedural Geometry",
         description: "Procedural geometry shapes — cube, sphere, cylinder, cone, and plane — with PBR materials.",
         tags: ["3d", "geometry", "ios", "swift"],
-        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0\"",
+        dependency: `https://github.com/sceneview/sceneview — from: "${LATEST_SCENEVIEW_RELEASE}"`,
         spmDependency: "https://github.com/sceneview/sceneview",
         prompt: "Create a SwiftUI scene showing procedural geometry shapes (cube, sphere, cylinder, cone, plane) with different materials. Use SceneViewSwift.",
         language: "swift",
@@ -1438,7 +1439,7 @@ struct GeometryShapesScreen: View {
         title: "iOS Lighting",
         description: "Directional, point, and spot lights with configurable intensity, color, and shadows.",
         tags: ["3d", "lighting", "environment", "ios", "swift"],
-        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0\"",
+        dependency: `https://github.com/sceneview/sceneview — from: "${LATEST_SCENEVIEW_RELEASE}"`,
         spmDependency: "https://github.com/sceneview/sceneview",
         prompt: "Create a SwiftUI 3D scene with directional, point, and spot lights illuminating geometry. Use SceneViewSwift.",
         language: "swift",
@@ -1502,7 +1503,7 @@ struct LightingScreen: View {
         title: "iOS Physics Demo",
         description: "Interactive physics simulation with bouncing spheres, gravity, and configurable restitution.",
         tags: ["3d", "physics", "geometry", "ios", "swift"],
-        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0\"",
+        dependency: `https://github.com/sceneview/sceneview — from: "${LATEST_SCENEVIEW_RELEASE}"`,
         spmDependency: "https://github.com/sceneview/sceneview",
         prompt: "Create a SwiftUI 3D scene where tapping spawns coloured spheres that fall under gravity and bounce off a floor. Use SceneViewSwift.",
         language: "swift",
@@ -1566,7 +1567,7 @@ struct PhysicsDemoScreen: View {
         title: "iOS 3D Text Labels",
         description: "Camera-facing 3D text labels using TextNode and BillboardNode for always-facing-camera behavior.",
         tags: ["3d", "text", "geometry", "ios", "swift"],
-        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0\"",
+        dependency: `https://github.com/sceneview/sceneview — from: "${LATEST_SCENEVIEW_RELEASE}"`,
         spmDependency: "https://github.com/sceneview/sceneview",
         prompt: "Create a SwiftUI 3D scene with floating text labels that always face the camera, showing planet names. Use SceneViewSwift.",
         language: "swift",
@@ -1614,7 +1615,7 @@ struct TextLabelsScreen: View {
         title: "iOS Video on 3D Surface",
         description: "Video playback on a 3D plane using VideoNode with play/pause controls.",
         tags: ["3d", "video", "ios", "swift"],
-        dependency: "https://github.com/sceneview/sceneview — from: \"4.0.0\"",
+        dependency: `https://github.com/sceneview/sceneview — from: "${LATEST_SCENEVIEW_RELEASE}"`,
         spmDependency: "https://github.com/sceneview/sceneview",
         prompt: "Create a SwiftUI 3D scene with a video playing on a floating 3D plane. Include play/pause controls. Use SceneViewSwift.",
         language: "swift",
@@ -1685,8 +1686,8 @@ struct VideoPlayerScreen: View {
         title: "Image Node",
         description: "Display images on 3D planes using ImageNode — from assets, resources, or Bitmaps.",
         tags: ["3d", "image", "geometry"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene with images displayed on floating planes using ImageNode. Show examples from file, resource, and Bitmap. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene with images displayed on floating planes using ImageNode. Show examples from file, resource, and Bitmap. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun ImageNodeScreen() {
     val engine = rememberEngine()
@@ -1744,8 +1745,8 @@ fun ImageNodeScreen() {
         title: "Billboard Sprite",
         description: "Always-facing-camera sprites using BillboardNode — useful for markers, icons, and info overlays in 3D space.",
         tags: ["3d", "billboard", "image"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene with billboard sprites that always face the camera, useful for markers and info overlays. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene with billboard sprites that always face the camera, useful for markers and info overlays. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun BillboardSpriteScreen() {
     val engine = rememberEngine()
@@ -1809,8 +1810,8 @@ fun BillboardSpriteScreen() {
         title: "Animation State Machine",
         description: "Reactive animation driven by Compose state — switch between Idle, Walk, and Run animations on a character model.",
         tags: ["3d", "model", "animation"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene with a character model that switches between Idle, Walk, and Run animations based on button clicks. Use animationName for state-driven animation. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene with a character model that switches between Idle, Walk, and Run animations based on button clicks. Use animationName for state-driven animation. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun AnimationStateScreen() {
     val engine = rememberEngine()
@@ -1873,8 +1874,8 @@ fun AnimationStateScreen() {
         title: "Spring Animation",
         description: "Smooth spring-based node animations using Compose animateFloatAsState with spring spec for natural motion.",
         tags: ["3d", "animation", "spring", "geometry"],
-        dependency: "io.github.sceneview:sceneview:4.0.0",
-        prompt: "Create a 3D scene with geometry nodes that animate position using spring physics via Compose's animateFloatAsState. Tap to toggle positions with springy motion. Use SceneView `io.github.sceneview:sceneview:4.0.0`.",
+        dependency: "io.github.sceneview:sceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create a 3D scene with geometry nodes that animate position using spring physics via Compose's animateFloatAsState. Tap to toggle positions with springy motion. Use SceneView `io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun SpringAnimationScreen() {
     val engine = rememberEngine()
@@ -1966,8 +1967,8 @@ fun SpringAnimationScreen() {
         title: "AR Surface Cursor",
         description: "AR scene with a center-screen reticle using HitResultNode that follows the detected surface.",
         tags: ["ar", "cursor", "plane-detection", "placement"],
-        dependency: "io.github.sceneview:arsceneview:4.0.0",
-        prompt: "Create an AR screen with a surface cursor (reticle) in the center of the screen that follows detected surfaces, using HitResultNode. Tap to place a model at the cursor position. Use SceneView `io.github.sceneview:arsceneview:4.0.0`.",
+        dependency: "io.github.sceneview:arsceneview:" + LATEST_SCENEVIEW_RELEASE + "",
+        prompt: "Create an AR screen with a surface cursor (reticle) in the center of the screen that follows detected surfaces, using HitResultNode. Tap to place a model at the cursor position. Use SceneView `io.github.sceneview:arsceneview:${LATEST_SCENEVIEW_RELEASE}`.",
         code: `@Composable
 fun ARSurfaceCursorScreen() {
     val engine = rememberEngine()

package/dist/telemetry.js

@@ -8,16 +8,25 @@
 //   - client: MCP client name (e.g. "claude-desktop", "cursor")
 //   - clientVersion: MCP client version string reported during handshake
 //   - mcpVersion: this package's version
-//   - tier: "free" | "pro"
+//   - tier: "free" | "pro" — tier the TOOL resolved to, NOT the user's plan
 //   - tool?: tool name (only for "tool" events)
+//   - installId?: opaque random UUID per install — lets the worker count
+//     unique developers per client runtime without identifying who they are
+//   - botLikelihood?: float in [0.0, 1.0] computed at the sender side from
+//     environment signals (CI flags, no-TTY, container hints). Worker uses
+//     it to exclude bot traffic from monetization analytics by default.
 //
 // What NEVER gets sent:
 //   - IP address (the endpoint strips it server-side; we never send headers)
-//   - hostname, OS user, machine id
+//   - hostname, OS user, machine id, cwd, project path, package name
 //   - prompt content, tool arguments, tool results
 //   - API keys, billing info
 //
 // Opt out with `SCENEVIEW_TELEMETRY=0` or by running in CI (`CI=true`).
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
 // Worker implementation: telemetry-worker/ (Hono + D1 + KV rate limiting).
 // Deploy with: cd telemetry-worker && see DEPLOY.md
 const TELEMETRY_ENDPOINT = "https://sceneview-telemetry.mcp-tools-lab.workers.dev/v1/events";
@@ -31,6 +40,9 @@ let clientContext;
 // ─── Client-side batch buffer ─────────────────────────────────────────────────
 let buffer = [];
 let flushTimer;
+// Cached fingerprint values — computed once per process.
+let cachedInstallId;
+let cachedBotLikelihood;
 // Read lazily so tests that mutate env vars between runs see the latest value.
 function isEnabled() {
     if (process.env.SCENEVIEW_TELEMETRY === "0")
@@ -47,6 +59,156 @@ import { PACKAGE_VERSION } from "./generated/version.js";
 function getMcpVersion() {
     return process.env.SCENEVIEW_MCP_VERSION ?? PACKAGE_VERSION;
 }
+// ─── Install ID — anonymous per-install fingerprint ──────────────────────────
+//
+// Stored at `$XDG_CONFIG_HOME/sceneview-mcp/install.json` (default
+// `~/.config/sceneview-mcp/install.json`). Created on first run if missing.
+// Contents: `{ "installId": "<uuid v4>", "createdAt": "<ISO>" }`.
+//
+// Why a UUID and not a hash of hostname / cwd / etc.:
+//   - hostnames/cwd are personally identifying (employee laptop name,
+//     `/Users/<name>/...`) — even hashed, they're predictable enough that
+//     a determined attacker with worker-side DB access could brute-force
+//     them back. A UUID is provably non-identifying.
+//   - The point is to count unique developers per `client` runtime, not to
+//     fingerprint the host. A fresh install = a fresh identity, by design.
+//
+// Disabled when telemetry is disabled (no file is written).
+function getInstallIdConfigPath() {
+    const xdg = process.env.XDG_CONFIG_HOME;
+    const base = xdg && xdg.length > 0 ? xdg : join(homedir(), ".config");
+    return join(base, "sceneview-mcp", "install.json");
+}
+function loadOrCreateInstallId() {
+    if (cachedInstallId !== undefined)
+        return cachedInstallId;
+    let path;
+    try {
+        path = getInstallIdConfigPath();
+    }
+    catch {
+        return undefined;
+    }
+    // Try to read an existing install record.
+    try {
+        const raw = readFileSync(path, "utf8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.installId === "string" && parsed.installId.length > 0) {
+            cachedInstallId = parsed.installId;
+            return cachedInstallId;
+        }
+    }
+    catch {
+        // File missing or unreadable — fall through to create.
+    }
+    // Create a fresh install record. All failures are swallowed: a read-only
+    // home directory (CI sandboxes, container images) should not break telemetry
+    // or the MCP server itself.
+    try {
+        const installId = randomUUID();
+        const dir = join(path, "..");
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(path, JSON.stringify({ installId, createdAt: new Date().toISOString() }, null, 2), { encoding: "utf8" });
+        cachedInstallId = installId;
+        return cachedInstallId;
+    }
+    catch {
+        // Fallback: an ephemeral per-process UUID. Better than nothing —
+        // still distinguishes parallel scripted runs from a real install.
+        cachedInstallId = randomUUID();
+        return cachedInstallId;
+    }
+}
+// ─── Bot likelihood — sender-side heuristic ──────────────────────────────────
+//
+// Returns a score in [0.0, 1.0] where 1.0 = almost certainly automation.
+// Signals (each independently bumps the score):
+//
+//   - GITHUB_ACTIONS / GITLAB_CI / CIRCLECI / BUILDKITE / TF_BUILD / JENKINS_URL
+//     are set                                              → +0.45 (strong)
+//   - CI is set to any truthy value                        → +0.30 (medium)
+//   - stdout is not a TTY                                  → +0.15 (weak)
+//   - common container/sandbox hints
+//     (KUBERNETES_SERVICE_HOST, container=docker, AWS_LAMBDA_FUNCTION_NAME)
+//                                                          → +0.20 (medium)
+//   - DEBIAN_FRONTEND=noninteractive (popular in scripts)  → +0.10 (weak)
+//
+// The score is computed ONCE per process and reused on every event. It is
+// clamped to [0.0, 1.0]. The worker uses it as an advisory exclusion filter
+// (default threshold 0.7); raw events are still stored for forensics.
+function computeBotLikelihood() {
+    if (cachedBotLikelihood !== undefined)
+        return cachedBotLikelihood;
+    let score = 0;
+    const env = process.env;
+    // Strong: a named CI provider env var.
+    const strongCiVars = [
+        "GITHUB_ACTIONS",
+        "GITLAB_CI",
+        "CIRCLECI",
+        "BUILDKITE",
+        "TF_BUILD",
+        "JENKINS_URL",
+        "BITBUCKET_BUILD_NUMBER",
+        "TEAMCITY_VERSION",
+        "TRAVIS",
+        "DRONE",
+    ];
+    if (strongCiVars.some((k) => typeof env[k] === "string" && env[k].length > 0)) {
+        score += 0.45;
+    }
+    // Medium: generic CI=truthy. We don't double-count if a strong var fired,
+    // but for cheap envs ("CI=true" alone), this captures them.
+    const ci = env.CI;
+    if (typeof ci === "string" && (ci === "true" || ci === "1")) {
+        score += 0.3;
+    }
+    // Weak: no TTY → almost always automation or piped invocation. We test
+    // stdout because the MCP protocol uses stdin/stdout, but stderr is the
+    // more reliable indicator of "is a human watching".
+    try {
+        // process.stderr is most reliable; some MCP runners pipe stdout but leave
+        // stderr attached. Both being non-TTY is a stronger bot signal.
+        const stderrTty = typeof process.stderr === "object" &&
+            typeof process.stderr.isTTY === "boolean" &&
+            process.stderr.isTTY === true;
+        if (!stderrTty)
+            score += 0.15;
+    }
+    catch {
+        // Defensive — if stderr isn't introspectable, treat as non-TTY.
+        score += 0.15;
+    }
+    // Medium: containerized environments.
+    const containerVars = [
+        "KUBERNETES_SERVICE_HOST",
+        "AWS_LAMBDA_FUNCTION_NAME",
+        "VERCEL",
+        "NETLIFY",
+        "CODESPACE_NAME",
+    ];
+    if (containerVars.some((k) => typeof env[k] === "string" && env[k].length > 0) ||
+        env.container === "docker") {
+        score += 0.2;
+    }
+    // Weak: scripted invocations frequently set this.
+    if (env.DEBIAN_FRONTEND === "noninteractive")
+        score += 0.1;
+    cachedBotLikelihood = Math.min(1, Math.max(0, score));
+    return cachedBotLikelihood;
+}
+// Build a base payload populated with the install fingerprint + bot score.
+// `installId` is omitted when telemetry is disabled or the install file
+// could not be created. `botLikelihood` is always present (default 0).
+function buildBase() {
+    const out = {
+        botLikelihood: computeBotLikelihood(),
+    };
+    const installId = loadOrCreateInstallId();
+    if (installId)
+        out.installId = installId;
+    return out;
+}
 // Fire-and-forget POST of a single payload to the individual event endpoint.
 // Used as fallback when batch delivery fails.
 function sendSingle(payload) {
@@ -148,6 +310,8 @@ function send(payload) {
 /** Exposed for tests — resets the cached client context and the batch buffer. */
 export function __resetClientContext() {
     clientContext = undefined;
+    cachedInstallId = undefined;
+    cachedBotLikelihood = undefined;
     buffer = [];
     if (flushTimer !== undefined) {
         clearTimeout(flushTimer);
@@ -175,6 +339,7 @@ export function recordClientInit(clientInfo) {
         clientVersion: clientContext.clientVersion,
         mcpVersion: getMcpVersion(),
         tier: "free",
+        ...buildBase(),
     });
 }
 /**
@@ -196,5 +361,16 @@ export function recordToolCall(toolName, tier) {
         mcpVersion: getMcpVersion(),
         tier,
         tool: toolName,
+        ...buildBase(),
     });
 }
+// ─── Test-only exports ────────────────────────────────────────────────────────
+/** Exposed for tests — bypass the cache and recompute the bot score. */
+export function __computeBotLikelihoodForTest() {
+    cachedBotLikelihood = undefined;
+    return computeBotLikelihood();
+}
+/** Exposed for tests — read the install ID without going through send(). */
+export function __getInstallIdForTest() {
+    return loadOrCreateInstallId();
+}

package/dist/tiers.js

@@ -29,6 +29,8 @@ const FREE_TOOLS = [
     "get_platform_roadmap",
     "search_models",
     "analyze_project",
+    "search_android_docs",
+    "fetch_android_doc",
     // Setup guides (moved from Pro in 4.0.5)
     "get_ios_setup",
     "get_web_setup",