sceneview-mcp 3.6.2 → 3.6.4

package/dist/telemetry.js

@@ -0,0 +1,120 @@
+// ─── Anonymous opt-out telemetry for sceneview-mcp ───────────────────────────
+//
+// Fire-and-forget, non-blocking, no personal data. Ever.
+//
+// What gets sent:
+//   - timestamp (UTC ISO string)
+//   - event: "init" | "tool"
+//   - 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"
+//   - tool?: tool name (only for "tool" events)
+//
+// What NEVER gets sent:
+//   - IP address (the endpoint strips it server-side; we never send headers)
+//   - hostname, OS user, machine id
+//   - prompt content, tool arguments, tool results
+//   - API keys, billing info
+//
+// Opt out with `SCENEVIEW_TELEMETRY=0` or by running in CI (`CI=true`).
+// TODO: Provision a Cloudflare Worker at this address that ingests events
+// into a lightweight store (Workers Analytics Engine or R2 + daily rollup).
+// Until the Worker is deployed, requests to this endpoint will fail silently,
+// which is fine — fetch errors are swallowed by design.
+const TELEMETRY_ENDPOINT = "https://telemetry.sceneview.io/v1/events";
+// Hard cap so we never hang the process on a slow endpoint.
+const TELEMETRY_TIMEOUT_MS = 2000;
+let clientContext;
+// Read lazily so tests that mutate env vars between runs see the latest value.
+function isEnabled() {
+    if (process.env.SCENEVIEW_TELEMETRY === "0")
+        return false;
+    if (process.env.CI === "true")
+        return false;
+    return true;
+}
+// Read the package version lazily so tests don't need to mock fs.
+// Falls back to "unknown" so payloads stay well-formed even if
+// something goes wrong.
+function getMcpVersion() {
+    return process.env.SCENEVIEW_MCP_VERSION ?? "3.6.4";
+}
+/** Exposed for tests — resets the cached client context. */
+export function __resetClientContext() {
+    clientContext = undefined;
+}
+// Fire-and-forget POST with a timeout. Never throws, never awaits the caller.
+function send(payload) {
+    if (!isEnabled())
+        return;
+    // Build a bounded promise so we never hang on a slow endpoint. We
+    // intentionally do NOT await this from the caller — telemetry must
+    // never block the handshake or a tool call. Wrap everything in a
+    // try/catch because a buggy fetch polyfill (or a test mock) could
+    // throw synchronously before we get a chance to attach .catch.
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), TELEMETRY_TIMEOUT_MS);
+        fetch(TELEMETRY_ENDPOINT, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(payload),
+            signal: controller.signal,
+        })
+            .catch(() => {
+            // Swallow all failures — network errors, DNS, timeouts, non-2xx.
+            // Telemetry is best-effort.
+        })
+            .finally(() => {
+            clearTimeout(timeoutId);
+        });
+    }
+    catch {
+        // Swallow synchronous throws too.
+    }
+}
+/**
+ * Record an MCP client handshake. Called from the server's `oninitialized`
+ * callback once the client has advertised its name/version. Safe to call
+ * with `undefined` if the client didn't report info — the event is dropped.
+ */
+export function recordClientInit(clientInfo) {
+    if (!clientInfo)
+        return;
+    clientContext = {
+        client: clientInfo.name,
+        clientVersion: clientInfo.version,
+    };
+    if (!isEnabled())
+        return;
+    send({
+        timestamp: new Date().toISOString(),
+        event: "init",
+        client: clientContext.client,
+        clientVersion: clientContext.clientVersion,
+        mcpVersion: getMcpVersion(),
+        tier: "free",
+    });
+}
+/**
+ * Record a tool invocation. Called from the `CallToolRequestSchema` handler
+ * after the tier check has passed. `tier` is the tier the tool resolved to,
+ * not the user's subscription status.
+ */
+export function recordToolCall(toolName, tier) {
+    if (!isEnabled())
+        return;
+    // If the client never completed initialization (which shouldn't happen in
+    // practice), fall back to "unknown" so we can still see the tool mix.
+    const ctx = clientContext ?? { client: "unknown", clientVersion: "unknown" };
+    send({
+        timestamp: new Date().toISOString(),
+        event: "tool",
+        client: ctx.client,
+        clientVersion: ctx.clientVersion,
+        mcpVersion: getMcpVersion(),
+        tier,
+        tool: toolName,
+    });
+}

package/dist/tiers.js

@@ -0,0 +1,100 @@
+// ─── Tool tier system ─────────────────────────────────────────────────────────
+//
+// Defines free vs pro tool access for SceneView MCP.
+// ─── Free tools (17) ─────────────────────────────────────────────────────────
+const FREE_TOOLS = [
+    "list_samples",
+    "get_sample",
+    "get_setup",
+    "get_node_reference",
+    "list_platforms",
+    "validate_code",
+    "get_troubleshooting",
+    "debug_issue",
+    "get_best_practices",
+    "get_animation_guide",
+    "get_gesture_guide",
+    "get_performance_tips",
+    "get_material_guide",
+    "get_collision_guide",
+    "get_platform_roadmap",
+    "search_models",
+    "analyze_project",
+];
+// ─── Pro tools ────────────────────────────────────────────────────────────────
+const PRO_TOOLS = [
+    // Core pro tools
+    "get_ios_setup",
+    "get_web_setup",
+    "get_ar_setup",
+    "get_platform_setup",
+    "migrate_code",
+    "get_migration_guide",
+    "render_3d_preview",
+    "create_3d_artifact",
+    "generate_scene",
+    "get_model_optimization_guide",
+    "get_web_rendering_guide",
+    // Automotive package
+    "get_car_configurator",
+    "get_dashboard_3d",
+    "get_parts_catalog",
+    "get_hud_overlay",
+    "get_ar_showroom",
+    "list_car_models",
+    // Gaming package
+    "get_physics_game",
+    "get_particle_effects",
+    "get_level_editor",
+    "get_inventory_3d",
+    "get_character_viewer",
+    "list_game_models",
+    // Healthcare package
+    "get_surgical_planning",
+    "get_dental_viewer",
+    "get_medical_imaging",
+    "get_anatomy_viewer",
+    "get_molecule_viewer",
+    "list_medical_models",
+    // Interior package
+    "get_room_planner",
+    "get_lighting_design",
+    "get_room_tour",
+    "get_material_switcher",
+    "get_furniture_placement",
+    "list_furniture_models",
+];
+// ─── Tier map ─────────────────────────────────────────────────────────────────
+export const TOOL_TIERS = Object.fromEntries([
+    ...FREE_TOOLS.map((name) => [name, "free"]),
+    ...PRO_TOOLS.map((name) => [name, "pro"]),
+]);
+// ─── Helper functions ─────────────────────────────────────────────────────────
+/** Returns true if the tool requires a Pro subscription. Unknown tools default to pro. */
+export function isProTool(toolName) {
+    return getToolTier(toolName) === "pro";
+}
+/** Returns the tier for a tool. Defaults to "pro" for unknown tools. */
+export function getToolTier(toolName) {
+    return TOOL_TIERS[toolName] ?? "pro";
+}
+/** Returns all pro tool names. */
+export function getProToolNames() {
+    return [...PRO_TOOLS];
+}
+/** Returns all free tool names. */
+export function getFreeToolNames() {
+    return [...FREE_TOOLS];
+}
+// ─── Upgrade message ──────────────────────────────────────────────────────────
+export const PRO_UPGRADE_MESSAGE = `## \u{1F512} Pro Feature
+
+This tool requires a SceneView MCP Pro subscription.
+
+**Upgrade for \u20AC9.99/month** to unlock:
+- 36+ premium tools (AR, multi-platform, scene generation, artifacts)
+- Specialized packages (Automotive, Gaming, Healthcare, Interior)
+- Priority support
+
+\u2192 Subscribe at https://polar.sh/sceneview
+\u2192 Then set your API key: \`SCENEVIEW_API_KEY=your_key\``;