sceneview-mcp 3.6.2 → 3.6.4

package/dist/tools/index.js

@@ -0,0 +1,18 @@
+/**
+ * Public entrypoint for the SceneView MCP tool library.
+ *
+ * Consumers (stdio server in `../index.ts`, hosted gateway in
+ * `mcp-gateway/src/mcp/registry.ts`) should import from this file and
+ * never reach into `definitions.ts` / `handler.ts` directly.
+ */
+export { TOOL_DEFINITIONS } from "./definitions.js";
+export { dispatchTool, API_DOCS, __resetSponsorCounter } from "./handler.js";
+import { TOOL_DEFINITIONS } from "./definitions.js";
+/** Returns the full tool definition list (read-only copy). */
+export function getAllTools() {
+    return [...TOOL_DEFINITIONS];
+}
+/** Returns the tool definition for a given name, or `undefined`. */
+export function getToolDefinition(name) {
+    return TOOL_DEFINITIONS.find((t) => t.name === name);
+}

package/dist/tools/types.js

@@ -0,0 +1,8 @@
+/**
+ * Public types for the SceneView MCP tool library.
+ *
+ * These are the contract shared with the `mcp-gateway` package. Any change here
+ * MUST be reflected in `mcp-gateway/src/mcp/types.ts` (or that file should
+ * import from this one once workspaces are set up).
+ */
+export {};

package/dist/validator.js

@@ -272,7 +272,7 @@ const RULES = [
             const issues = [];
             if (!code.includes("DynamicSkyNode"))
                 return issues;
-            // If DynamicSkyNode appears but Scene { } doesn't, it's likely wrong
+            // If DynamicSkyNode appears but SceneView { } doesn't, it's likely wrong
             if (!code.includes("SceneView(") && !code.includes("SceneView {")) {
                 findLines(lines, /DynamicSkyNode\s*\(/).forEach((line) => issues.push({
                     severity: "warning",

package/llms.txt

@@ -1955,6 +1955,19 @@ MCP server: `sceneview-mcp`. Add to `.claude/mcp.json`:
 { "mcpServers": { "sceneview": { "command": "npx", "args": ["-y", "sceneview-mcp"] } } }
 ```
 
+### Complete nodes reference
+
+For an exhaustive, AI-first reference covering every node composable — signatures, copy-paste examples, gotchas, lifecycle behaviour, nesting & coordinate spaces, and common mistakes — see **[docs/docs/nodes.md](https://sceneview.github.io/docs/nodes/)** (`NODES.md`). This file is the authoritative walkthrough for:
+
+- **Standard nodes:** ModelNode (animations, `scaleToUnits`), LightNode (intensity units by type, the `apply` trap), ViewNode (Compose UI on a plane, why `viewNodeWindowManager` is mandatory)
+- **Procedural geometry:** CubeNode / SphereNode / CylinderNode / PlaneNode / LineNode / PathNode / MeshNode — with the recomposition model for reactive geometry updates
+- **Content nodes:** TextNode, ImageNode, VideoNode, BillboardNode, ReflectionProbeNode
+- **AR-only nodes:** AnchorNode (the correct pattern for pinning state without 60 FPS recomposition), PoseNode, HitResultNode, AugmentedImageNode, AugmentedFaceNode, CloudAnchorNode, StreetscapeGeometryNode
+- **Composition & state:** nesting and parent→child coordinate spaces, reactive parameters, automatic destruction, imperative `apply = { … }` blocks, and a table of common mistakes with symptoms and fixes
+
+This reference is consumed by `sceneview-mcp` so Claude and other AI assistants can answer deep questions about any node without hallucinating parameter names.
+
+
 ### Claude Artifacts — 3D in claude.ai
 
 SceneView works inside Claude Artifacts (HTML type). Use this template:
@@ -2028,16 +2041,26 @@ ferrari_f40.glb
 | visionOS | RealityKit | SwiftUI | via SceneViewSwift | Alpha |
 | Web | Filament.js + WebXR | Kotlin/JS | `samples/web-demo` | Alpha |
 
-SceneView Web (sceneview.js v3.6.0) — JavaScript API:
+SceneView Web (sceneview.js v3.6.2) — JavaScript API:
   SceneView.modelViewer(canvas, url, options?) → Promise<instance>
   SceneView.create(canvas, options?) → Promise<instance>
   instance.loadModel(url) → Promise<instance>
+  instance.clearScene() → instance  // removes all models + primitives
   instance.setAutoRotate(enabled) → instance
   instance.setCameraDistance(d) → instance
+  instance.setCameraManipulator('orbit'|'map'|'freelook') → instance
   instance.setBackgroundColor(r, g, b, a?) → instance
   instance.setQuality('low'|'medium'|'high') → instance
   instance.setBloom(true|false|{strength,resolution,threshold,levels}) → instance
+  instance.loadEnvironment(ktxUrl, intensity?) → Promise<instance>
   instance.addLight({type?,color?,intensity?,direction?,position?,falloff?}) → entity
+  instance.removeLight(entity) → instance
+  instance.clearLights() → instance  // wipes base 3-point rig + IBL
+  instance.createBox(center, [w,h,d], [r,g,b,a]) → asset
+  instance.createSphere(center, radius, [r,g,b,a]) → asset
+  instance.createCylinder(center, radius, height, [r,g,b,a]) → asset
+  instance.playAnimation(index=0, loop=true) → instance  // glTF keyframe + skinning
+  instance.stopAnimation() → instance
   instance.createText({text, fontSize?, color?, position?, billboard?}) → entity
   instance.createImage({url, position?, size?, billboard?}) → entity
   instance.createVideo({url, position?, size?, loop?, autoplay?, chromaKey?}) → entity

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sceneview-mcp",
-  "version": "3.6.2",
+  "version": "3.6.4",
   "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": [
@@ -37,32 +37,21 @@
     "sceneview-mcp": "dist/index.js"
   },
   "files": [
-    "dist/index.js",
-    "dist/issues.js",
-    "dist/guides.js",
-    "dist/migration.js",
-    "dist/node-reference.js",
-    "dist/samples.js",
-    "dist/preview.js",
-    "dist/artifact.js",
-    "dist/validator.js",
-    "dist/platform-setup.js",
-    "dist/migrate-code.js",
-    "dist/debug-issue.js",
-    "dist/generate-scene.js",
-    "dist/advanced-guides.js",
-    "dist/extra-guides.js",
+    "dist/**/*.js",
+    "!dist/**/*.test.js",
+    "!dist/**/__fixtures__/**",
     "llms.txt"
   ],
   "engines": {
     "node": ">=18"
   },
   "scripts": {
+    "prebuild": "node scripts/generate-llms-txt.js",
     "build": "tsc",
-    "prepare": "cp ../llms.txt ./llms.txt && tsc",
+    "prepare": "cp ../llms.txt ./llms.txt && node scripts/generate-llms-txt.js && tsc",
     "start": "node dist/index.js",
     "dev": "tsx src/index.ts",
-    "test": "vitest run"
+    "test": "node scripts/generate-llms-txt.js && vitest run"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0"