sceneview-mcp 4.0.11 → 4.0.13

package/dist/generated/version.js

@@ -1,5 +1,8 @@
 // AUTO-GENERATED by scripts/generate-version.js — do not edit by hand.
-// Snapshots the package.json "version" field at build time so that
-// the MCP server and telemetry report the actual published version
-// instead of a stale hardcoded constant.
-export const PACKAGE_VERSION = "4.0.11";
+// Snapshots both the MCP package version (from package.json) and the
+// SceneView SDK version (from ../gradle.properties:VERSION_NAME) at
+// build time so the MCP server, telemetry, and the install-snippet
+// generators all report the actually-published versions instead of
+// stale hardcoded constants. See #941.
+export const PACKAGE_VERSION = "4.0.13";
+export const LATEST_SCENEVIEW_RELEASE = "4.18.0";

package/dist/guides.js

@@ -3,19 +3,20 @@
  *
  * Static content for the platform roadmap, best practices, and AR setup tools.
  */
+import { LATEST_SCENEVIEW_RELEASE } from "./generated/version.js";
 // ─── Platform Roadmap ─────────────────────────────────────────────────────────
 export const PLATFORM_ROADMAP = `# SceneView Multi-Platform Roadmap
 
-## Current Status (v4.0.0)
+## Current Status (v${LATEST_SCENEVIEW_RELEASE})
 
 | Platform | Status | Artifact | Renderer |
 |----------|--------|----------|----------|
-| **Android (Compose)** | Stable | \`io.github.sceneview:sceneview:4.0.0\` | Filament |
-| **Android (AR)** | Stable | \`io.github.sceneview:arsceneview:4.0.0\` | Filament + ARCore |
-| **iOS (SwiftUI)** | Alpha | SceneViewSwift SPM \`from: "4.0.0"\` | RealityKit + ARKit |
+| **Android (Compose)** | Stable | \`io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}\` | Filament |
+| **Android (AR)** | Stable | \`io.github.sceneview:arsceneview:${LATEST_SCENEVIEW_RELEASE}\` | Filament + ARCore |
+| **iOS (SwiftUI)** | Alpha | SceneViewSwift SPM \`from: "${LATEST_SCENEVIEW_RELEASE}"\` | RealityKit + ARKit |
 | **macOS (SwiftUI)** | Alpha | SceneViewSwift SPM (in Package.swift) | RealityKit |
 | **visionOS (SwiftUI)** | Alpha | SceneViewSwift SPM (in Package.swift) | RealityKit |
-| **KMP Core** | Stable | \`io.github.sceneview:sceneview-core:4.0.0\` | N/A (shared logic) |
+| **KMP Core** | Stable | \`io.github.sceneview:sceneview-core:${LATEST_SCENEVIEW_RELEASE}\` | N/A (shared logic) |
 
 ## Architecture: Native Renderers per Platform
 
@@ -32,7 +33,7 @@ KMP shares **logic**, not **rendering**. Each platform uses its native renderer.
 - **3D rendering** via Google Filament: PBR materials, HDR environments, glTF/GLB models, post-processing.
 - **AR** via ARCore: plane detection, hit testing, anchors, cloud anchors, augmented images, depth, light estimation, point cloud.
 - **Compose-native DSL**: all nodes are \`@Composable\` functions inside \`SceneView { }\` or \`ARSceneView { }\`.
-- **26+ node types**: ModelNode, LightNode, AnchorNode, CameraNode, TextNode, PathNode, ViewNode, PlaneNode, SphereNode, CylinderNode, CubeNode, DynamicSkyNode, FogNode, ReflectionProbeNode, PhysicsNode, BillboardNode, LineNode, and more.
+- **42+ node types**: ModelNode, LightNode, AnchorNode, CameraNode, TextNode, PathNode, ViewNode, PlaneNode, SphereNode, CylinderNode, CubeNode, DynamicSkyNode, FogNode, ReflectionProbeNode, PhysicsNode, BillboardNode, LineNode, and more.
 
 ## Apple — Alpha (SceneViewSwift)
 
@@ -338,7 +339,7 @@ export const AR_SETUP_GUIDE = `# SceneView AR — Complete Setup Guide (Android
 ## 1. SPM Dependency
 
 \`\`\`swift
-.package(url: "https://github.com/sceneview/sceneview", from: "4.0.0")
+.package(url: "https://github.com/sceneview/sceneview", from: "${LATEST_SCENEVIEW_RELEASE}")
 \`\`\`
 
 ## 2. Info.plist — Camera Permission
@@ -423,7 +424,7 @@ ARSceneView(
 \`\`\`kotlin
 // build.gradle.kts (app module)
 dependencies {
-    implementation("io.github.sceneview:arsceneview:4.0.0")
+    implementation("io.github.sceneview:arsceneview:${LATEST_SCENEVIEW_RELEASE}")
     // arsceneview includes sceneview transitively — no need to add both
 }
 \`\`\`

package/dist/index.js

@@ -7,7 +7,7 @@
  * and handler logic now live in `./tools/`, so this file is a thin
  * adapter that wires the library into the MCP stdio server plus the
  * two MCP resources (`sceneview://api`, `sceneview://known-issues`) and
- * the pro-tier access / billing checks.
+ * the proxy dispatch for Pro-tier tools (`./proxy.ts`).
  *
  * IMPORTANT: the runtime behaviour must stay identical to v4.0.0 for
  * existing npm consumers. Do not reorder checks, do not change content
@@ -17,11 +17,12 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { fetchKnownIssues } from "./issues.js";
+import { DEMO_WITH_SETTINGS_EXAMPLE, SKETCHFAB_STREAMING_EXAMPLE, } from "./examples.js";
 import { recordClientInit, recordToolCall } from "./telemetry.js";
 import { isProTool, getToolTier } from "./tiers.js";
 import { dispatchProxyToolCall, isProxyConfigured, DEFAULT_PRICING_URL, } from "./proxy.js";
 import { API_DOCS, TOOL_DEFINITIONS, dispatchTool, } from "./tools/index.js";
-import { PACKAGE_VERSION } from "./generated/version.js";
+import { LATEST_SCENEVIEW_RELEASE, PACKAGE_VERSION } from "./generated/version.js";
 // ─── v4 lite-mode startup banner ─────────────────────────────────────────────
 //
 // MCP servers must keep stdout clean for JSON-RPC, so we log to stderr.
@@ -57,7 +58,7 @@ server.setRequestHandler(ListResourcesRequestSchema, async () => ({
         {
             uri: "sceneview://api",
             name: "SceneView API Reference",
-            description: "Complete SceneView 4.0.0 API — SceneView, ARSceneView, SceneScope DSL, ARSceneScope DSL, node types, resource loading, camera, gestures, math types, threading rules, and common patterns. Read this before writing any SceneView code.",
+            description: `Complete SceneView ${LATEST_SCENEVIEW_RELEASE} API — SceneView, ARSceneView, SceneScope DSL, ARSceneScope DSL, node types, resource loading, camera, gestures, math types, threading rules, and common patterns. Read this before writing any SceneView code.`,
             mimeType: "text/markdown",
         },
         {
@@ -66,6 +67,18 @@ server.setRequestHandler(ListResourcesRequestSchema, async () => ({
             description: "Live list of open issues from the SceneView GitHub repository. Check this before reporting a bug or when something isn't working — there may already be a known workaround.",
             mimeType: "text/markdown",
         },
+        {
+            uri: "examples://demo-with-settings",
+            name: "Example — DemoScaffold v2 (full-screen scene + ModalBottomSheet)",
+            description: "Pattern for full-screen 3D / AR scene + Material 3 ModalBottomSheet controls. The DemoScaffold v2 contract used by every demo in samples/android-demo (issue #1154, PR #1169). Read this before adding a new demo with settings.",
+            mimeType: "text/markdown",
+        },
+        {
+            uri: "examples://sketchfab-streaming",
+            name: "Example — Stream Sketchfab CC-BY models into a SceneView demo",
+            description: "Pattern for streaming CC-BY licensed glTF models from Sketchfab on demand instead of bundling 30 MB of GLBs in the APK. Uses SketchfabAssetResolver + SampleAssets registry + per-slug bundled fallback (Stage 2 of umbrella issue #1152). Read this before adding a streamed demo.",
+            mimeType: "text/markdown",
+        },
     ],
 }));
 server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
@@ -80,6 +93,22 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
                 contents: [{ uri: "sceneview://known-issues", mimeType: "text/markdown", text: issues }],
             };
         }
+        case "examples://demo-with-settings":
+            return {
+                contents: [{
+                        uri: "examples://demo-with-settings",
+                        mimeType: "text/markdown",
+                        text: DEMO_WITH_SETTINGS_EXAMPLE,
+                    }],
+            };
+        case "examples://sketchfab-streaming":
+            return {
+                contents: [{
+                        uri: "examples://sketchfab-streaming",
+                        mimeType: "text/markdown",
+                        text: SKETCHFAB_STREAMING_EXAMPLE,
+                    }],
+            };
         default:
             throw new Error(`Unknown resource: ${request.params.uri}`);
     }

package/dist/issues.js

@@ -1,3 +1,4 @@
+import { PACKAGE_VERSION } from "./generated/version.js";
 export const COMMON_ISSUES = [
     {
         id: "threading-sigabrt",
@@ -134,7 +135,10 @@ export async function fetchKnownIssues() {
         const response = await fetch("https://api.github.com/repos/sceneview/sceneview/issues?state=open&per_page=30", {
             headers: {
                 Accept: "application/vnd.github+json",
-                "User-Agent": "sceneview-mcp/3.5.4",
+                // Plumb the actual MCP package version so GitHub abuse-watch
+                // logs show which MCP build is hitting them — was hardcoded
+                // to "3.5.4" pre-#941, far behind the current release.
+                "User-Agent": `sceneview-mcp/${PACKAGE_VERSION}`,
                 "X-GitHub-Api-Version": "2022-11-28",
             },
         });
@@ -147,10 +151,12 @@ export async function fetchKnownIssues() {
                 fetchError = "GitHub API returned unexpected response format (expected array).";
             }
             else {
-                issues = json.filter((item) => typeof item === "object" &&
+                issues = json
+                    .filter((item) => typeof item === "object" &&
                     item !== null &&
                     typeof item.number === "number" &&
-                    typeof item.title === "string");
+                    typeof item.title === "string")
+                    .map(normalizeIssue);
             }
         }
     }
@@ -161,6 +167,51 @@ export async function fetchKnownIssues() {
     cache = { data: result, fetchedAt: now };
     return result;
 }
+/**
+ * Coerce a loosely-validated GitHub API item into a complete {@link GitHubIssue}.
+ *
+ * The upstream type guard only asserts `number` + `title`. A malformed API
+ * response — or a partial item served during a GitHub incident — can be
+ * missing `user`, `labels` or `updated_at`. Reading those unconditionally in
+ * `formatIssues` throws a `TypeError` and takes down the whole
+ * `sceneview://known-issues` resource. Default every optional field here so
+ * formatting can never crash.
+ */
+function normalizeIssue(item) {
+    const rawLabels = item.labels;
+    const labels = Array.isArray(rawLabels)
+        ? rawLabels
+            .map((l) => {
+            if (typeof l === "string")
+                return { name: l };
+            if (l !== null && typeof l === "object") {
+                const name = l.name;
+                if (typeof name === "string")
+                    return { name };
+            }
+            return null;
+        })
+            .filter((l) => l !== null)
+        : [];
+    const rawUser = item.user;
+    const login = rawUser !== null &&
+        typeof rawUser === "object" &&
+        typeof rawUser.login === "string"
+        ? rawUser.login
+        : "unknown";
+    const updatedAt = typeof item.updated_at === "string" ? item.updated_at : "";
+    const createdAt = typeof item.created_at === "string" ? item.created_at : "";
+    return {
+        number: item.number,
+        title: item.title,
+        html_url: typeof item.html_url === "string" ? item.html_url : "",
+        body: typeof item.body === "string" ? item.body : null,
+        labels,
+        created_at: createdAt,
+        updated_at: updatedAt,
+        user: { login },
+    };
+}
 function formatIssues(issues, fetchError) {
     const lines = ["# SceneView — Open GitHub Issues\n"];
     if (fetchError) {

package/dist/migration.js

@@ -1,3 +1,4 @@
+import { LATEST_SCENEVIEW_RELEASE } from "./generated/version.js";
 export const MIGRATION_GUIDE = `# SceneView 2.x → 3.0 Migration Guide
 
 SceneView 3.0 is a full rewrite from Android Views to **Jetpack Compose**. Nearly every public API changed. This guide covers every breaking change and how to fix it.
@@ -6,10 +7,10 @@ SceneView 3.0 is a full rewrite from Android Views to **Jetpack Compose**. Nearl
 
 ## 1. Gradle dependency
 
-| 2.x | 3.0 |
-|-----|-----|
-| \`io.github.sceneview:sceneview:2.x.x\` | \`io.github.sceneview:sceneview:4.0.0\` |
-| \`io.github.sceneview:arsceneview:2.x.x\` | \`io.github.sceneview:arsceneview:4.0.0\` |
+| 2.x | Current |
+|-----|---------|
+| \`io.github.sceneview:sceneview:2.x.x\` | \`io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}\` |
+| \`io.github.sceneview:arsceneview:2.x.x\` | \`io.github.sceneview:arsceneview:${LATEST_SCENEVIEW_RELEASE}\` |
 
 ---
 

package/dist/platform-setup.js

@@ -4,6 +4,7 @@
  * Setup guides for every supported SceneView platform.
  * Consolidates Android, iOS, Web, Flutter, React Native, Desktop, and TV.
  */
+import { LATEST_SCENEVIEW_RELEASE } from "./generated/version.js";
 export const PLATFORM_IDS = ["android", "ios", "web", "flutter", "react-native", "desktop", "tv"];
 const ANDROID_3D = `## SceneView Android — 3D Setup
 
@@ -12,7 +13,7 @@ const ANDROID_3D = `## SceneView Android — 3D Setup
 \`\`\`kotlin
 // build.gradle.kts (app module)
 dependencies {
-    implementation("io.github.sceneview:sceneview:4.0.0")
+    implementation("io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}")
 }
 \`\`\`
 
@@ -87,7 +88,7 @@ const ANDROID_AR = `## SceneView Android — AR Setup
 \`\`\`kotlin
 // build.gradle.kts (app module)
 dependencies {
-    implementation("io.github.sceneview:arsceneview:4.0.0")
+    implementation("io.github.sceneview:arsceneview:${LATEST_SCENEVIEW_RELEASE}")
     // arsceneview includes sceneview transitively
 }
 \`\`\`
@@ -177,7 +178,7 @@ In Xcode: **File > Add Package Dependencies** > paste:
 \`\`\`
 https://github.com/sceneview/sceneview
 \`\`\`
-Set version rule to **"from: 4.0.0"**.
+Set version rule to **"from: ${LATEST_SCENEVIEW_RELEASE}"**.
 
 Or in Package.swift:
 \`\`\`swift
@@ -188,7 +189,7 @@ let package = Package(
     name: "MyApp",
     platforms: [.iOS(.v18), .macOS(.v15), .visionOS(.v1)],
     dependencies: [
-        .package(url: "https://github.com/sceneview/sceneview", from: "4.0.0")
+        .package(url: "https://github.com/sceneview/sceneview", from: "${LATEST_SCENEVIEW_RELEASE}")
     ],
     targets: [
         .executableTarget(
@@ -273,7 +274,7 @@ const IOS_AR = `## SceneViewSwift — iOS AR Setup
 ### 1. SPM Dependency
 
 \`\`\`swift
-.package(url: "https://github.com/sceneview/sceneview", from: "4.0.0")
+.package(url: "https://github.com/sceneview/sceneview", from: "${LATEST_SCENEVIEW_RELEASE}")
 \`\`\`
 
 ### 2. Info.plist — Camera Permission (Required)
@@ -414,10 +415,18 @@ SceneView Flutter uses **PlatformView** to embed native SceneView (Android: Fila
 
 ### 1. Dependencies
 
+> **Note:** the 4.0 line of \`sceneview_flutter\` is not yet on pub.dev
+> (registry still holds an unrelated 0.0.1 demo) — see #923. Use the
+> git dependency snippet below for now.
+
 \`\`\`yaml
 # pubspec.yaml
 dependencies:
-  sceneview_flutter: ^4.0.0
+  sceneview_flutter:
+    git:
+      url: https://github.com/sceneview/sceneview
+      path: flutter/sceneview_flutter
+      ref: v${LATEST_SCENEVIEW_RELEASE}
 \`\`\`
 
 ### 2. Android Setup
@@ -475,8 +484,13 @@ const FLUTTER_AR = `## SceneView Flutter — AR Setup
 ### 1. Dependencies
 
 \`\`\`yaml
+# pub.dev publish for 4.x is pending — see #923. Use the git ref:
 dependencies:
-  sceneview_flutter: ^4.0.0
+  sceneview_flutter:
+    git:
+      url: https://github.com/sceneview/sceneview
+      path: flutter/sceneview_flutter
+      ref: v${LATEST_SCENEVIEW_RELEASE}
 \`\`\`
 
 ### 2. Android Manifest
@@ -632,7 +646,7 @@ plugins {
 
 dependencies {
     implementation(compose.desktop.currentOs)
-    implementation("io.github.sceneview:sceneview-desktop:4.0.0") // when published
+    implementation("io.github.sceneview:sceneview-desktop:${LATEST_SCENEVIEW_RELEASE}") // when published
 }
 \`\`\`
 
@@ -641,6 +655,7 @@ dependencies {
 \`\`\`kotlin
 import androidx.compose.ui.window.Window
 import androidx.compose.ui.window.application
+import { LATEST_SCENEVIEW_RELEASE } from "./generated/version.js";
 
 fun main() = application {
     Window(
@@ -683,7 +698,7 @@ SceneView on Android TV uses the same Filament renderer as mobile Android, with
 
 \`\`\`kotlin
 dependencies {
-    implementation("io.github.sceneview:sceneview:4.0.0")
+    implementation("io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}")
     implementation("androidx.leanback:leanback:1.0.0")
     implementation("androidx.tv:tv-foundation:1.0.0-alpha10")
 }
@@ -748,14 +763,14 @@ const SETUPS = {
     android: {
         name: "Android (Jetpack Compose)",
         renderer: "Filament (OpenGL ES / Vulkan)",
-        status: "Stable (v4.0.0)",
+        status: "Stable (v${LATEST_SCENEVIEW_RELEASE})",
         guide3d: ANDROID_3D,
         guideAr: ANDROID_AR,
     },
     ios: {
         name: "iOS / macOS / visionOS (SwiftUI)",
         renderer: "RealityKit (Metal)",
-        status: "Alpha (v4.0.0)",
+        status: "Alpha (v${LATEST_SCENEVIEW_RELEASE})",
         guide3d: IOS_3D,
         guideAr: IOS_AR,
     },