sceneview-mcp 4.0.0 → 4.0.1

package/dist/tools/handler.js

@@ -9,7 +9,7 @@
  *   1. The stdio MCP server in `../index.ts` (legacy npm package path).
  *   2. The HTTP gateway in `mcp-gateway/src/mcp/registry.ts` (hosted path).
  *
- * Zero runtime behaviour change from 4.0.0-rc.1: every tool returns exactly the
+ * Zero runtime behaviour change from 4.0.0: every tool returns exactly the
  * same content it did when the logic lived inside the stdio server's
  * `CallToolRequestSchema` handler.
  *
@@ -35,7 +35,7 @@ import { MATERIAL_GUIDE, COLLISION_GUIDE, MODEL_OPTIMIZATION_GUIDE, WEB_RENDERIN
 import { searchModels, formatSearchResults } from "../search-models.js";
 import { analyzeProject, formatAnalysisReport } from "../analyze-project.js";
 import { LLMS_TXT } from "../generated/llms-txt.js";
-// ─── Legal disclaimer (identical to index.ts 4.0.0-rc.1) ─────────────────────
+// ─── Legal disclaimer (identical to index.ts 4.0.0) ─────────────────────
 const DISCLAIMER = "\n\n---\n*Generated code suggestion. Review before use in production. See [TERMS.md](https://github.com/sceneview/sceneview/blob/main/mcp/TERMS.md).*";
 // ─── Sponsor CTA (shown every N tool calls, opt-out via env var) ────────────
 //
@@ -111,7 +111,7 @@ export async function dispatchTool(toolName, args, _ctx = {}) {
                 ? [
                     `**SPM dependency:**`,
                     `\`\`\`swift`,
-                    `.package(url: "${sample.spmDependency ?? sample.dependency}", from: "4.0.0-rc.1")`,
+                    `.package(url: "${sample.spmDependency ?? sample.dependency}", from: "4.0.0")`,
                     `\`\`\``,
                 ]
                 : [
@@ -184,7 +184,7 @@ export async function dispatchTool(toolName, args, _ctx = {}) {
                                 `### build.gradle.kts`,
                                 `\`\`\`kotlin`,
                                 `dependencies {`,
-                                `    implementation("io.github.sceneview:sceneview:4.0.0-rc.1")`,
+                                `    implementation("io.github.sceneview:sceneview:4.0.0")`,
                                 `}`,
                                 `\`\`\``,
                                 ``,
@@ -205,7 +205,7 @@ export async function dispatchTool(toolName, args, _ctx = {}) {
                                 `### build.gradle.kts`,
                                 `\`\`\`kotlin`,
                                 `dependencies {`,
-                                `    implementation("io.github.sceneview:arsceneview:4.0.0-rc.1")`,
+                                `    implementation("io.github.sceneview:arsceneview:4.0.0")`,
                                 `}`,
                                 `\`\`\``,
                                 ``,
@@ -318,7 +318,7 @@ export async function dispatchTool(toolName, args, _ctx = {}) {
                                 `\`\`\``,
                                 `https://github.com/sceneview/sceneview`,
                                 `\`\`\``,
-                                `Set version rule to **"from: 4.0.0-rc.1"**.`,
+                                `Set version rule to **"from: 4.0.0"**.`,
                                 ``,
                                 `Or in Package.swift:`,
                                 `\`\`\`swift`,
@@ -329,7 +329,7 @@ export async function dispatchTool(toolName, args, _ctx = {}) {
                                 `    name: "MyApp",`,
                                 `    platforms: [.iOS(.v17), .macOS(.v14), .visionOS(.v1)],`,
                                 `    dependencies: [`,
-                                `        .package(url: "https://github.com/sceneview/sceneview", from: "4.0.0-rc.1")`,
+                                `        .package(url: "https://github.com/sceneview/sceneview", from: "4.0.0")`,
                                 `    ],`,
                                 `    targets: [`,
                                 `        .executableTarget(`,
@@ -400,7 +400,7 @@ export async function dispatchTool(toolName, args, _ctx = {}) {
                                 `### 1. Add SPM Dependency`,
                                 ``,
                                 `\`\`\`swift`,
-                                `.package(url: "https://github.com/sceneview/sceneview", from: "4.0.0-rc.1")`,
+                                `.package(url: "https://github.com/sceneview/sceneview", from: "4.0.0")`,
                                 `\`\`\``,
                                 ``,
                                 `### 2. Minimum Platform`,
@@ -680,15 +680,15 @@ export async function dispatchTool(toolName, args, _ctx = {}) {
         // ── list_platforms ────────────────────────────────────────────────────────
         case "list_platforms": {
             const platforms = [
-                { platform: "Android", renderer: "Filament", framework: "Jetpack Compose", status: "Stable", version: "4.0.0-rc.1", dependency: "io.github.sceneview:sceneview:4.0.0-rc.1", features: ["3D", "AR (ARCore)", "Model loading (GLB/glTF)", "Geometry nodes", "Physics", "Gestures"] },
-                { platform: "Android TV", renderer: "Filament", framework: "Compose TV", status: "Alpha", version: "4.0.0-rc.1", dependency: "io.github.sceneview:sceneview:4.0.0-rc.1", features: ["3D", "D-pad controls", "Auto-rotation", "Model loading"] },
+                { platform: "Android", renderer: "Filament", framework: "Jetpack Compose", status: "Stable", version: "4.0.0", dependency: "io.github.sceneview:sceneview:4.0.0", features: ["3D", "AR (ARCore)", "Model loading (GLB/glTF)", "Geometry nodes", "Physics", "Gestures"] },
+                { platform: "Android TV", renderer: "Filament", framework: "Compose TV", status: "Alpha", version: "4.0.0", dependency: "io.github.sceneview:sceneview:4.0.0", features: ["3D", "D-pad controls", "Auto-rotation", "Model loading"] },
                 { platform: "Android XR", renderer: "Jetpack XR SceneCore", framework: "Compose XR", status: "Planned", version: "-", dependency: "-", features: ["Spatial computing", "Hand tracking", "Passthrough"] },
-                { platform: "iOS", renderer: "RealityKit", framework: "SwiftUI", status: "Alpha", version: "4.0.0-rc.1", dependency: "SceneViewSwift (SPM)", features: ["3D", "AR (ARKit)", "16 node types", "USDZ models"] },
-                { platform: "macOS", renderer: "RealityKit", framework: "SwiftUI", status: "Alpha", version: "4.0.0-rc.1", dependency: "SceneViewSwift (SPM)", features: ["3D", "Orbit camera", "USDZ models"] },
-                { platform: "visionOS", renderer: "RealityKit", framework: "SwiftUI", status: "Alpha", version: "4.0.0-rc.1", dependency: "SceneViewSwift (SPM)", features: ["3D", "Immersive spaces", "Hand tracking (planned)"] },
-                { platform: "Web", renderer: "Filament.js (WASM)", framework: "Kotlin/JS", status: "Alpha", version: "4.0.0-rc.1", dependency: "@sceneview/sceneview-web", features: ["3D", "WebXR AR/VR", "GLB models", "WebGL2"] },
-                { platform: "Desktop", renderer: "Software / Filament JNI", framework: "Compose Desktop", status: "Alpha", version: "4.0.0-rc.1", dependency: "sceneview-desktop (local)", features: ["3D", "Software renderer", "Wireframe"] },
-                { platform: "Flutter", renderer: "Filament / RealityKit", framework: "PlatformView", status: "Alpha", version: "4.0.0-rc.1", dependency: "flutter pub: sceneview", features: ["3D", "AR", "Android + iOS bridge"] },
+                { platform: "iOS", renderer: "RealityKit", framework: "SwiftUI", status: "Alpha", version: "4.0.0", dependency: "SceneViewSwift (SPM)", features: ["3D", "AR (ARKit)", "16 node types", "USDZ models"] },
+                { platform: "macOS", renderer: "RealityKit", framework: "SwiftUI", status: "Alpha", version: "4.0.0", dependency: "SceneViewSwift (SPM)", features: ["3D", "Orbit camera", "USDZ models"] },
+                { platform: "visionOS", renderer: "RealityKit", framework: "SwiftUI", status: "Alpha", version: "4.0.0", dependency: "SceneViewSwift (SPM)", features: ["3D", "Immersive spaces", "Hand tracking (planned)"] },
+                { platform: "Web", renderer: "Filament.js (WASM)", framework: "Kotlin/JS", status: "Alpha", version: "4.0.0", dependency: "@sceneview/sceneview-web", features: ["3D", "WebXR AR/VR", "GLB models", "WebGL2"] },
+                { platform: "Desktop", renderer: "Software / Filament JNI", framework: "Compose Desktop", status: "Alpha", version: "4.0.0", dependency: "sceneview-desktop (local)", features: ["3D", "Software renderer", "Wireframe"] },
+                { platform: "Flutter", renderer: "Filament / RealityKit", framework: "PlatformView", status: "Alpha", version: "4.0.0", dependency: "flutter pub: sceneview", features: ["3D", "AR", "Android + iOS bridge"] },
             ];
             const lines = [
                 "## SceneView Supported Platforms\n",

package/llms.txt

@@ -1069,6 +1069,25 @@ SceneView(surfaceType = SurfaceType.TextureSurface, isOpaque = false)  // Textur
 
 ---
 
+## Performance
+
+- **Frame budget**: 16.6ms at 60fps. Target 12ms for headroom.
+- **Cold start**: ~120ms (3D), ~350ms (AR, ARCore init dominates).
+- **APK size**: +3.2MB (sceneview), +5.1MB (sceneview + arsceneview).
+- **Memory**: ~25MB empty 3D scene, ~45MB empty AR scene.
+- **Triangle budget**: <100K per model, <200K total scene (mid-tier devices).
+- **Textures**: use KTX2 with Basis Universal, max 2048x2048 on mobile.
+- **Draw calls**: aim for <100 per frame. Merge static geometry in Blender before export.
+- **Lights**: 1 directional + IBL covers most cases. Max 2-3 additional point/spot lights.
+- **Post-processing**: Bloom ~1ms, SSAO ~2-3ms. Disable SSAO on low-end devices.
+- **Compose**: use `remember` for Position/Rotation/Scale — no allocations in composition body.
+- **Engine**: create one `rememberEngine()` at app level, share across all scenes.
+- **AR**: disable `planeRenderer` after object placement to reduce overdraw.
+- **Rerun bridge**: adds ~0.5ms when active. Gate with `BuildConfig.DEBUG`.
+- See full guide: docs/docs/performance.md
+
+---
+
 ## Error Handling
 
 | Problem | Cause | Fix |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sceneview-mcp",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "mcpName": "io.github.sceneview/mcp",
   "description": "MCP server for SceneView — cross-platform 3D & AR SDK for Android and iOS. Give Claude the full SceneView SDK so it writes correct, compilable code.",
   "keywords": [