@holoscript/core 6.1.3 → 8.0.0

package/dist/{chunk-6S6TKNEA.cjs → chunk-3HYYMEXI.cjs}

@@ -6,33 +6,15 @@ var chunkWDT3JTGM_cjs = require('./chunk-WDT3JTGM.cjs');
 var chunk4PDEPEQW_cjs = require('./chunk-4PDEPEQW.cjs');
 var chunkXJAN7CZG_cjs = require('./chunk-XJAN7CZG.cjs');
 var chunkXHIV6326_cjs = require('./chunk-XHIV6326.cjs');
-var chunkAIX25INK_cjs = require('./chunk-AIX25INK.cjs');
+var chunkTVHSPJ4N_cjs = require('./chunk-TVHSPJ4N.cjs');
 var chunkILRBGFVD_cjs = require('./chunk-ILRBGFVD.cjs');
 var chunkE7JP3BS3_cjs = require('./chunk-E7JP3BS3.cjs');
 var chunkHCCQLAA4_cjs = require('./chunk-HCCQLAA4.cjs');
-var NavigationEngine = require('@holoscript/engine/runtime/NavigationEngine');
-var VoiceSynthesizer = require('@holoscript/engine/runtime/VoiceSynthesizer');
-var EmotionDetector = require('@holoscript/engine/runtime/EmotionDetector');
-var PhysicsEngine = require('@holoscript/engine/runtime/PhysicsEngine');
-var IslandDetector = require('@holoscript/engine/physics/IslandDetector');
-var SoftBodyAdapter = require('@holoscript/engine/physics/SoftBodyAdapter');
-var MLSMPMFluid = require('@holoscript/engine/physics/MLSMPMFluid');
-var WeatherBlackboard = require('@holoscript/engine/environment/WeatherBlackboard');
-var SoftBodySolver = require('@holoscript/engine/physics/SoftBodySolver');
-var choreography = require('@holoscript/engine/choreography');
-var negotiation = require('@holoscript/framework/negotiation');
-var mesh = require('@holoscript/mesh');
-var agents = require('@holoscript/framework/agents');
-var MQTTClient = require('@holoscript/engine/runtime/protocols/MQTTClient');
-var BoneSystem = require('@holoscript/engine/animation/BoneSystem');
-var IKSolver = require('@holoscript/engine/animation/IKSolver');
-var AvatarController = require('@holoscript/engine/animation/AvatarController');
-var ai = require('@holoscript/framework/ai');
-var SpringAnimator = require('@holoscript/engine/animation/SpringAnimator');
 var events = require('events');
-var spatial = require('@holoscript/engine/spatial');
 var jose = require('jose');
 
+// src/traits/FlowFieldTrait.ts
+var _navigationEngine = null;
 function toTuple(v) {
   if (Array.isArray(v)) return v;
   return [v[0] ?? 0, v[1] ?? 0, v[2] ?? 0];
@@ -55,10 +37,12 @@ var flowFieldHandler = {
   onDetach(node) {
     delete node.__flowFieldState;
   },
-  onUpdate(node, config, context, delta) {
+  async onUpdate(node, config, context, delta) {
     const state = node.__flowFieldState;
     if (!state || !config.destinationId) return;
-    const navEngine = NavigationEngine.getNavigationEngine("gpu_flowfield") || NavigationEngine.getNavigationEngine("default");
+    _navigationEngine ?? (_navigationEngine = await import('@holoscript/engine/runtime/NavigationEngine'));
+    const { getNavigationEngine } = _navigationEngine;
+    const navEngine = getNavigationEngine("gpu_flowfield") || getNavigationEngine("default");
     if (!navEngine) return;
     const currentPos = toTuple(node.properties?.position || [0, 0, 0]);
     const flowDir = toTuple(navEngine.sampleDirection(config.destinationId, currentPos));
@@ -966,6 +950,9 @@ var rbacHandler = {
     }
   }
 };
+
+// src/traits/EmotionalVoiceTrait.ts
+var _voiceSynthesizer = null;
 var emotionalVoiceHandler = {
   name: "emotional_voice",
   defaultConfig: {
@@ -1003,7 +990,9 @@ var emotionalVoiceHandler = {
   }
 };
 emotionalVoiceHandler.handleSpeak = async function(node, config, state, request) {
-  const synthesizer = VoiceSynthesizer.getVoiceSynthesizer("default") || Array.from(VoiceSynthesizer.voiceSynthesizerRegistry.values())[0];
+  _voiceSynthesizer ?? (_voiceSynthesizer = await import('@holoscript/engine/runtime/VoiceSynthesizer'));
+  const { getVoiceSynthesizer, voiceSynthesizerRegistry } = _voiceSynthesizer;
+  const synthesizer = getVoiceSynthesizer("default") || Array.from(voiceSynthesizerRegistry.values())[0];
   if (!synthesizer) {
     console.warn("No VoiceSynthesizer registered. Skipping speech for", node.name);
     return;
@@ -1033,9 +1022,14 @@ emotionalVoiceHandler.handleSpeak = async function(node, config, state, request)
     request
   });
 };
+
+// src/traits/UserMonitorTrait.ts
+var _emotionDetector = null;
 var traitState = /* @__PURE__ */ new WeakMap();
-function performInference(node, config, _context, state) {
-  const detector = EmotionDetector.getEmotionDetector("default") || EmotionDetector.getEmotionDetector("lite");
+async function performInference(node, config, _context, state) {
+  _emotionDetector ?? (_emotionDetector = await import('@holoscript/engine/runtime/EmotionDetector'));
+  const { getEmotionDetector } = _emotionDetector;
+  const detector = getEmotionDetector("default") || getEmotionDetector("lite");
   if (!detector) return;
   const headStability = calculateStability(state.headPositions);
   const handStability = calculateStability(state.handPositions);
@@ -1079,7 +1073,7 @@ var userMonitorHandler = {
     traitState.delete(node);
     delete node.__userMonitorState;
   },
-  onUpdate(node, config, context, delta) {
+  async onUpdate(node, config, context, delta) {
     const state = traitState.get(node);
     if (!state) return;
     const headPos = context.vr.headset.position;
@@ -1100,7 +1094,7 @@ var userMonitorHandler = {
     state.lastInferenceTime += delta;
     if (state.lastInferenceTime >= (config.updateRate ?? 0.2)) {
       state.lastInferenceTime = 0;
-      performInference(node, config, context, state);
+      await performInference(node, config, context, state);
     }
   },
   onEvent(node, config, context, event) {
@@ -7057,6 +7051,11 @@ var gpuParticleHandler = {
     }
   }
 };
+
+// src/traits/GPUPhysicsTrait.ts
+var _physicsEngineModule = null;
+var _islandDetectorModule = null;
+var _softBodyAdapterModule = null;
 function extractPosition(node) {
   const pos = node?.properties?.position ?? node?.position;
   if (Array.isArray(pos) && pos.length >= 3) {
@@ -7081,19 +7080,25 @@ var gpuPhysicsHandler = {
     restitution: 0.3,
     isStatic: false
   },
-  onAttach(node, config, _context) {
+  async onAttach(node, config, _context) {
+    _islandDetectorModule ?? (_islandDetectorModule = await import('@holoscript/engine/physics/IslandDetector'));
+    const { IslandDetector } = _islandDetectorModule;
     if (config.sim_type === "soft_body") {
-      const softBody = new SoftBodyAdapter.SoftBodyAdapter(node, config);
+      _softBodyAdapterModule ?? (_softBodyAdapterModule = await import('@holoscript/engine/physics/SoftBodyAdapter'));
+      const { SoftBodyAdapter } = _softBodyAdapterModule;
+      const softBody = new SoftBodyAdapter(node, config);
       node.__gpuPhysicsState = {
         engineId: "soft_body_solver",
         isSimulating: true,
         lastPosition: extractPosition(node),
-        islandDetector: new IslandDetector.IslandDetector(),
+        islandDetector: new IslandDetector(),
         softBody
       };
       return;
     }
-    const engine = PhysicsEngine.getPhysicsEngine("webgpu") || PhysicsEngine.getPhysicsEngine("default");
+    _physicsEngineModule ?? (_physicsEngineModule = await import('@holoscript/engine/runtime/PhysicsEngine'));
+    const { getPhysicsEngine } = _physicsEngineModule;
+    const engine = getPhysicsEngine("webgpu") || getPhysicsEngine("default");
     if (!engine) {
       console.warn("No GPU PhysicsEngine found. Physics will be disabled for", node.name);
       return;
@@ -7103,7 +7108,7 @@ var gpuPhysicsHandler = {
       // Fallback or from config
       isSimulating: true,
       lastPosition: [0, 0, 0],
-      islandDetector: new IslandDetector.IslandDetector()
+      islandDetector: new IslandDetector()
     };
     node.__gpuPhysicsState = state;
     engine?.addBody(node.name || "", {
@@ -7117,24 +7122,28 @@ var gpuPhysicsHandler = {
       restitution: config.restitution
     });
   },
-  onDetach(node) {
+  async onDetach(node) {
     const state = node.__gpuPhysicsState;
     if (state) {
       if (state.softBody) ; else {
-        const engine = PhysicsEngine.getPhysicsEngine(state.engineId);
+        _physicsEngineModule ?? (_physicsEngineModule = await import('@holoscript/engine/runtime/PhysicsEngine'));
+        const { getPhysicsEngine } = _physicsEngineModule;
+        const engine = getPhysicsEngine(state.engineId);
         engine?.removeBody(node.name || "");
       }
       delete node.__gpuPhysicsState;
     }
   },
-  onUpdate(node, _config, _context, _delta) {
+  async onUpdate(node, _config, _context, _delta) {
     const state = node.__gpuPhysicsState;
     if (!state || !state.isSimulating) return;
     if (state.softBody) {
       state.softBody.update(_delta);
       return;
     }
-    const engine = PhysicsEngine.getPhysicsEngine(state.engineId);
+    _physicsEngineModule ?? (_physicsEngineModule = await import('@holoscript/engine/runtime/PhysicsEngine'));
+    const { getPhysicsEngine } = _physicsEngineModule;
+    const engine = getPhysicsEngine(state.engineId);
     if (!engine) return;
     const states = engine.getStates();
     const bodyState = states[node.name || ""];
@@ -7143,13 +7152,15 @@ var gpuPhysicsHandler = {
       node.rotation = bodyState.rotation;
     }
   },
-  onEvent(node, config, context, event) {
+  async onEvent(node, config, context, event) {
     const state = node.__gpuPhysicsState;
     if (!state) return;
     const eventType = typeof event === "string" ? event : event.type;
     if (eventType === "apply-force") {
       if (state.softBody) ; else {
-        const engine = PhysicsEngine.getPhysicsEngine(state.engineId || "webgpu");
+        _physicsEngineModule ?? (_physicsEngineModule = await import('@holoscript/engine/runtime/PhysicsEngine'));
+        const { getPhysicsEngine } = _physicsEngineModule;
+        const engine = getPhysicsEngine(state.engineId || "webgpu");
         engine?.applyForce(
           node.name || "",
           event.data?.force,
@@ -16773,6 +16784,10 @@ function initializeClothMesh(state, config) {
     }
   }
 }
+
+// src/traits/FluidTrait.ts
+var _mlsMpmModule = null;
+var _weatherModule = null;
 var fluidHandler = {
   name: "fluid",
   defaultConfig: {
@@ -16795,7 +16810,7 @@ var fluidHandler = {
     absorption_color: [0.4, 0.04, 0],
     absorption_strength: 2
   },
-  onAttach(node, config, context) {
+  async onAttach(node, config, context) {
     const state = {
       isSimulating: false,
       particleCount: 0,
@@ -16811,7 +16826,9 @@ var fluidHandler = {
     };
     node.__fluidState = state;
     if (config.method === "mls_mpm" && context.gpuDevice) {
-      const sim = new MLSMPMFluid.MLSMPMFluid({
+      _mlsMpmModule ?? (_mlsMpmModule = await import('@holoscript/engine/physics/MLSMPMFluid'));
+      const { MLSMPMFluid } = _mlsMpmModule;
+      const sim = new MLSMPMFluid({
         type: "liquid",
         particleCount: config.particle_count,
         viscosity: config.viscosity,
@@ -16859,15 +16876,17 @@ var fluidHandler = {
     }
     delete node.__fluidState;
   },
-  onUpdate(node, config, context, delta) {
+  async onUpdate(node, config, context, delta) {
     const state = node.__fluidState;
     if (!state || !state.isSimulating) return;
     if (state.mlsMpm && state.gpuReady) {
-      if (config.wind_sensitivity > 0 && WeatherBlackboard.weatherBlackboard.wind_speed > 0) {
+      _weatherModule ?? (_weatherModule = await import('@holoscript/engine/environment/WeatherBlackboard'));
+      const { weatherBlackboard } = _weatherModule;
+      if (config.wind_sensitivity > 0 && weatherBlackboard.wind_speed > 0) {
         const s = config.wind_sensitivity;
-        const wv = WeatherBlackboard.weatherBlackboard.wind_vector;
+        const wv = weatherBlackboard.wind_vector;
         const windDir = wv ? [wv[0], wv[1], wv[2]] : [0, 0, 0];
-        const windSpeed = WeatherBlackboard.weatherBlackboard.wind_speed;
+        const windSpeed = weatherBlackboard.wind_speed;
         state.mlsMpm.setExternalForce(
           windDir[0] * windSpeed * s,
           windDir[1] * windSpeed * s,
@@ -16980,6 +16999,9 @@ var fluidHandler = {
     }
   }
 };
+
+// src/traits/SoftBodyTrait.ts
+var _softBodySolverModule = null;
 function autoPopulateFromMesh(node, config) {
   const meshData = node.properties?.meshData;
   if (!meshData || !meshData.positions || !meshData.indices) {
@@ -17041,7 +17063,7 @@ var softBodyHandler = {
     surface_stiffness: 0.5,
     bending_stiffness: 0.3
   },
-  onAttach(node, config, context) {
+  async onAttach(node, config, context) {
     const state = {
       isSimulating: false,
       isDeformed: false,
@@ -17053,8 +17075,10 @@ var softBodyHandler = {
       solver: null
     };
     node.__softBodyState = state;
+    _softBodySolverModule ?? (_softBodySolverModule = await import('@holoscript/engine/physics/SoftBodySolver'));
+    const { SoftBodySolver } = _softBodySolverModule;
     const { particles, constraints } = autoPopulateFromMesh(node, config);
-    state.solver = new SoftBodySolver.SoftBodySolver(particles, constraints);
+    state.solver = new SoftBodySolver(particles, constraints);
     state.isSimulating = true;
     state.restVolume = node.properties?.meshData?.volume || 1;
   },
@@ -18634,6 +18658,9 @@ var layerAwareHandler = {
   onUpdate(node, config, context, _delta) {
   }
 };
+
+// src/traits/ChoreographyTrait.ts
+var _choreography = null;
 var DEFAULT_CHOREOGRAPHY_CONFIG = {
   mode: "participant",
   auto_start: true,
@@ -18672,14 +18699,16 @@ function addEvent(state, type, planId, config, stepId) {
 var choreographyHandler = {
   name: "choreography",
   defaultConfig: DEFAULT_CHOREOGRAPHY_CONFIG,
-  onAttach(node, config, _context) {
+  async onAttach(node, config, _context) {
+    _choreography ?? (_choreography = await import('@holoscript/engine/choreography'));
+    const { ChoreographyEngine, ChoreographyPlanner } = _choreography;
     const cfg = { ...DEFAULT_CHOREOGRAPHY_CONFIG, ...config };
     const state = createDefaultState();
     state.mode = cfg.mode;
     node.__choreography_state = state;
-    state.planner = new choreography.ChoreographyPlanner();
+    state.planner = new ChoreographyPlanner();
     if (cfg.mode === "orchestrator" || cfg.mode === "hybrid") {
-      state.engine = new choreography.ChoreographyEngine({
+      state.engine = new ChoreographyEngine({
         maxConcurrency: cfg.max_concurrent_plans,
         defaultTimeout: cfg.default_step_timeout,
         executeFallback: cfg.execute_fallback,
@@ -18731,6 +18760,9 @@ var choreographyHandler = {
     delete n.__choreography_state;
   }
 };
+
+// src/traits/NegotiationTrait.ts
+var _negotiationMod = null;
 var DEFAULT_NEGOTIATION_CONFIG = {
   role: "participant",
   default_mechanism: "majority",
@@ -18803,10 +18835,12 @@ async function autoVoteInternal(node, sessionId, config) {
     default:
       return null;
   }
+  _negotiationMod ?? (_negotiationMod = await import('@holoscript/framework/negotiation'));
+  const { getTrustWeight } = _negotiationMod;
   const voteResult = await state.protocol.vote(sessionId, {
     agentId: state.agentId,
     ranking,
-    weight: negotiation.getTrustWeight("local"),
+    weight: getTrustWeight("local"),
     justification: `Auto-voted: ${config.auto_vote_strategy}`,
     approvals: void 0,
     abstain: false
@@ -18820,13 +18854,15 @@ async function autoVoteInternal(node, sessionId, config) {
 var negotiationHandler = {
   name: "negotiation",
   defaultConfig: DEFAULT_NEGOTIATION_CONFIG,
-  onAttach(node, config, _context) {
+  async onAttach(node, config, _context) {
     const cfg = { ...DEFAULT_NEGOTIATION_CONFIG, ...config };
     const state = createDefaultState2();
     state.role = cfg.role;
     state.agentId = cfg.agent_id || node.id || `agent-${Date.now()}`;
     node.__negotiation_state = state;
-    state.protocol = negotiation.getNegotiationProtocol();
+    _negotiationMod ?? (_negotiationMod = await import('@holoscript/framework/negotiation'));
+    const { getNegotiationProtocol } = _negotiationMod;
+    state.protocol = getNegotiationProtocol();
     const unsub1 = state.protocol.on("sessionStarted", ({ session }) => {
       if (session.participants.includes(state.agentId)) {
         state.activeSessions.set(session.id, session);
@@ -18913,10 +18949,12 @@ async function vote(node, sessionId, ranking, options) {
   if (state.role === "observer") {
     throw new Error("Observers cannot vote");
   }
+  _negotiationMod ?? (_negotiationMod = await import('@holoscript/framework/negotiation'));
+  const { getTrustWeight } = _negotiationMod;
   const voteResult = await state.protocol.vote(sessionId, {
     agentId: state.agentId,
     ranking,
-    weight: options?.weight ?? negotiation.getTrustWeight("local"),
+    weight: options?.weight ?? getTrustWeight("local"),
     justification: options?.justification,
     approvals: options?.approvals,
     abstain: options?.abstain
@@ -19035,12 +19073,17 @@ function getNegotiationMethods(node) {
     leave: (sessionId) => leave(node, sessionId)
   };
 }
+
+// src/traits/NetworkedTrait.ts
 chunkE7JP3BS3_cjs.init_safeJsonParse();
+var _mesh = null;
 var syncProtocolPool = /* @__PURE__ */ new Map();
-function getOrCreateSyncProtocol(roomId, transport = "local", serverUrl) {
+async function getOrCreateSyncProtocol(roomId, transport = "local", serverUrl) {
+  _mesh ?? (_mesh = await import('@holoscript/mesh'));
+  const { SyncProtocol } = _mesh;
   const isTestEnv = process.env.NODE_ENV === "test" || !!process.env.VITEST;
   if (isTestEnv) {
-    return new mesh.SyncProtocol({
+    return new SyncProtocol({
       roomId,
       transport,
       serverUrl,
@@ -19050,7 +19093,7 @@ function getOrCreateSyncProtocol(roomId, transport = "local", serverUrl) {
   }
   const key = `${transport}:${roomId}`;
   if (!syncProtocolPool.has(key)) {
-    const protocol = new mesh.SyncProtocol({
+    const protocol = new SyncProtocol({
       roomId,
       transport,
       serverUrl,
@@ -19107,9 +19150,11 @@ var NetworkedTrait = class {
    */
   async connect(transport = "local", serverUrl) {
     const roomId = this.config.room || "default-room";
+    _mesh ?? (_mesh = await import('@holoscript/mesh'));
+    const { WebRTCTransport, WebSocketTransport } = _mesh;
     if (transport === "auto" && serverUrl) {
       try {
-        this.rtcTransport = new mesh.WebRTCTransport(serverUrl);
+        this.rtcTransport = new WebRTCTransport(serverUrl);
         await this.rtcTransport.connect();
         this.rtcTransport.onMessage((msg) => {
           const networkMsg = msg;
@@ -19125,7 +19170,7 @@ var NetworkedTrait = class {
         this.rtcTransport = null;
       }
       try {
-        this.wsTransport = new mesh.WebSocketTransport(serverUrl);
+        this.wsTransport = new WebSocketTransport(serverUrl);
         await this.wsTransport.connect();
         this.wsTransport.onMessage((msg) => {
           this.handleNetworkMessage(msg);
@@ -19142,7 +19187,7 @@ var NetworkedTrait = class {
     }
     if (serverUrl && transport === "websocket") {
       try {
-        this.wsTransport = new mesh.WebSocketTransport(serverUrl);
+        this.wsTransport = new WebSocketTransport(serverUrl);
         await this.wsTransport.connect();
         this.wsTransport.onMessage((msg) => {
           this.handleNetworkMessage(msg);
@@ -19158,7 +19203,7 @@ var NetworkedTrait = class {
     }
     if (serverUrl && transport === "webrtc") {
       try {
-        this.rtcTransport = new mesh.WebRTCTransport(serverUrl);
+        this.rtcTransport = new WebRTCTransport(serverUrl);
         await this.rtcTransport.connect();
         this.rtcTransport.onMessage((msg) => {
           const networkMsg = msg;
@@ -19173,7 +19218,7 @@ var NetworkedTrait = class {
         chunkILRBGFVD_cjs.logger.warn(`[NetworkedTrait] WebRTC connection failed, using local sync: ${error}`);
       }
     }
-    this.syncProtocol = getOrCreateSyncProtocol(roomId, "local", serverUrl);
+    this.syncProtocol = await getOrCreateSyncProtocol(roomId, "local", serverUrl);
     this.syncProtocol.on("state-updated", (event) => {
       const data = event.data;
       if (data.entityId === this.entityId && !this.isOwner) {
@@ -19726,6 +19771,9 @@ function createNetworkedTrait(config) {
     ...config
   });
 }
+
+// src/traits/NetworkedTraitHandler.ts
+var _mesh2 = null;
 var handlerStates = /* @__PURE__ */ new Map();
 function getNodeKey(node) {
   return node.id || `__anon_${Math.random().toString(36).slice(2, 8)}`;
@@ -19835,12 +19883,14 @@ var networkedHandler = {
   // ===========================================================================
   // onUpdate — per-frame sync
   // ===========================================================================
-  onUpdate(node, config, context, delta) {
+  async onUpdate(node, config, context, delta) {
     const key = getNodeKey(node);
     const state = handlerStates.get(key);
     if (!state || !state.registered) return;
     const trait = state.trait;
-    const baseSyncRate = mesh.SYNC_TIER_RATES[config.syncTier] ?? config.syncRate;
+    _mesh2 ?? (_mesh2 = await import('@holoscript/mesh'));
+    const { SYNC_TIER_RATES } = _mesh2;
+    const baseSyncRate = SYNC_TIER_RATES[config.syncTier] ?? config.syncRate;
     const effectiveRate = baseSyncRate * state.priorityWeight;
     const syncIntervalMs = effectiveRate > 0 ? 1e3 / effectiveRate : Infinity;
     if (trait.isLocalOwner()) {
@@ -24821,6 +24871,9 @@ function average(values) {
 function round(value) {
   return Math.round(value * 1e6) / 1e6;
 }
+
+// src/traits/AgentDiscoveryTrait.ts
+var _frameworkAgents = null;
 function generateAgentId() {
   return `agent_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
 }
@@ -24868,7 +24921,9 @@ var agentDiscoveryHandler = {
     registry_config: null,
     tags: []
   },
-  onAttach(node, config, context) {
+  async onAttach(node, config, context) {
+    _frameworkAgents ?? (_frameworkAgents = await import('@holoscript/framework/agents'));
+    const { getDefaultRegistry } = _frameworkAgents;
     const state = {
       registrationStatus: "unregistered",
       manifest: null,
@@ -24880,7 +24935,7 @@ var agentDiscoveryHandler = {
       registry: null
     };
     node.__agentDiscoveryState = state;
-    state.registry = agents.getDefaultRegistry(config.registry_config || void 0);
+    state.registry = getDefaultRegistry(config.registry_config || void 0);
     const nodeId = node.id || "unknown";
     state.manifest = createManifest(nodeId, config);
     if (config.auto_register) {
@@ -29578,6 +29633,9 @@ var messagingHandler = {
     });
   }
 };
+
+// src/traits/MQTTSinkTrait.ts
+var _mqttClientMod = null;
 var defaultConfig = {
   broker: "mqtt://localhost:1883",
   topic: "holoscript/{nodeId}/state",
@@ -29591,7 +29649,7 @@ var defaultConfig = {
 var mqttSinkHandler = {
   name: "mqtt_sink",
   defaultConfig,
-  onAttach(node, config, context) {
+  async onAttach(node, config, context) {
     const state = {
       connected: false,
       publishCount: 0,
@@ -29601,16 +29659,18 @@ var mqttSinkHandler = {
       lastStateHash: null
     };
     node.__mqttSinkState = state;
+    _mqttClientMod ?? (_mqttClientMod = await import('@holoscript/engine/runtime/protocols/MQTTClient'));
+    const { createMQTTClient, getMQTTClient, registerMQTTClient } = _mqttClientMod;
     const clientKey = `${config.broker}_${config.clientId || "default"}`;
-    let client = MQTTClient.getMQTTClient(clientKey);
+    let client = getMQTTClient(clientKey);
     if (!client) {
-      client = MQTTClient.createMQTTClient({
+      client = createMQTTClient({
         broker: config.broker,
         clientId: config.clientId,
         username: config.username,
         password: config.password
       });
-      MQTTClient.registerMQTTClient(clientKey, client);
+      registerMQTTClient(clientKey, client);
     }
     state.client = client;
     client.on("connect", () => {
@@ -29756,6 +29816,9 @@ function publishToMQTTSink(node, payload, topic) {
     }
   );
 }
+
+// src/traits/MQTTSourceTrait.ts
+var _mqttClientMod2 = null;
 var defaultConfig2 = {
   broker: "mqtt://localhost:1883",
   topic: "#",
@@ -29767,7 +29830,7 @@ var defaultConfig2 = {
 var mqttSourceHandler = {
   name: "mqtt_source",
   defaultConfig: defaultConfig2,
-  onAttach(node, config, context) {
+  async onAttach(node, config, context) {
     const state = {
       connected: false,
       lastMessage: null,
@@ -29777,16 +29840,18 @@ var mqttSourceHandler = {
       client: null
     };
     node.__mqttSourceState = state;
+    _mqttClientMod2 ?? (_mqttClientMod2 = await import('@holoscript/engine/runtime/protocols/MQTTClient'));
+    const { createMQTTClient, getMQTTClient, registerMQTTClient } = _mqttClientMod2;
     const clientKey = `${config.broker}_${config.clientId || "default"}`;
-    let client = MQTTClient.getMQTTClient(clientKey);
+    let client = getMQTTClient(clientKey);
     if (!client) {
-      client = MQTTClient.createMQTTClient({
+      client = createMQTTClient({
         broker: config.broker,
         clientId: config.clientId,
         username: config.username,
         password: config.password
       });
-      MQTTClient.registerMQTTClient(clientKey, client);
+      registerMQTTClient(clientKey, client);
     }
     state.client = client;
     client.on("connect", () => {
@@ -29818,8 +29883,8 @@ var mqttSourceHandler = {
     };
     client.subscribe({ topic: config.topic, qos: config.qos }, (message) => {
       let value = message.payload;
-      if (config.parseJson) {
-        value = MQTTClient.MQTTClient.parsePayload(message);
+      if (config.parseJson && _mqttClientMod2) {
+        value = _mqttClientMod2.MQTTClient.parsePayload(message);
       }
       if (config.debounce && config.debounce > 0) {
         pendingMessage = value;
@@ -30281,16 +30346,27 @@ var multiAgentHandler = {
     }
   }
 };
+
+// src/traits/NetworkedAvatarTrait.ts
+var _boneSystemMod = null;
+var _ikSolverMod = null;
+var _avatarControllerMod = null;
 var networkedAvatarHandler = {
   name: "networked_avatar",
   defaultConfig: {
     isLocal: false,
     updateRate: 30
   },
-  onAttach(node, config, context) {
-    const bones = new BoneSystem.BoneSystem();
-    const solver = new IKSolver.IKSolver();
-    const controller = new AvatarController.AvatarController(solver, bones);
+  async onAttach(node, config, context) {
+    _boneSystemMod ?? (_boneSystemMod = await import('@holoscript/engine/animation/BoneSystem'));
+    _ikSolverMod ?? (_ikSolverMod = await import('@holoscript/engine/animation/IKSolver'));
+    _avatarControllerMod ?? (_avatarControllerMod = await import('@holoscript/engine/animation/AvatarController'));
+    const { BoneSystem } = _boneSystemMod;
+    const { IKSolver } = _ikSolverMod;
+    const { AvatarController } = _avatarControllerMod;
+    const bones = new BoneSystem();
+    const solver = new IKSolver();
+    const controller = new AvatarController(solver, bones);
     bones.addBone("Hips", "Hips", null, { ty: 1 });
     bones.addBone("Spine", "Spine", "Hips", { ty: 0.2 });
     bones.addBone("Head", "Head", "Spine", { ty: 0.3 });
@@ -30701,6 +30777,9 @@ var neuralForgeHandler = {
     }
   }
 };
+
+// src/traits/NPCAITrait.ts
+var _frameworkAI = null;
 var npcAIHandler = {
   name: "npc_ai",
   defaultConfig: {
@@ -30729,7 +30808,7 @@ var npcAIHandler = {
     const state = node.__npcAIState;
     if (!state || state.isThinking) return;
   },
-  onEvent(node, config, context, event) {
+  async onEvent(node, config, context, event) {
     const state = node.__npcAIState;
     if (!state) return;
     if (event.type === "npc_ai_prompt") {
@@ -30737,7 +30816,9 @@ var npcAIHandler = {
       state.isThinking = true;
       state.conversationHistory.push({ role: "user", content: prompt });
       context.emit?.("npc_ai_think_begin", { node, prompt });
-      const adapter = ai.getDefaultAIAdapter();
+      _frameworkAI ?? (_frameworkAI = await import('@holoscript/framework/ai'));
+      const { getDefaultAIAdapter } = _frameworkAI;
+      const adapter = getDefaultAIAdapter();
       if (adapter && adapter.chat) {
         adapter.chat(prompt, void 0, state.conversationHistory.slice(0, -1)).then((response) => {
           context.emit?.("npc_ai_response", { node, text: response });
@@ -36259,6 +36340,9 @@ var lotusGenesisTriggerHandler = {
     });
   }
 };
+
+// src/traits/HandMenuTrait.ts
+var _springAnimatorModule = null;
 var getCoord = (v, idx, key) => (Array.isArray(v) ? v[idx] : v[key]) ?? 0;
 var add2 = (v1, v2) => [
   getCoord(v1, 0, "x") + getCoord(v2, 0, "x"),
@@ -36274,8 +36358,10 @@ var handMenuHandler = {
     offset: [0, 0.2, 0],
     scale: 1
   },
-  onAttach(node, config, context) {
-    const spring = new SpringAnimator.SpringAnimator(0, SpringAnimator.SpringPresets.gentle);
+  async onAttach(node, config, context) {
+    _springAnimatorModule ?? (_springAnimatorModule = await import('@holoscript/engine/animation/SpringAnimator'));
+    const { SpringAnimator, SpringPresets } = _springAnimatorModule;
+    const spring = new SpringAnimator(0, SpringPresets.gentle);
     menuSprings.set(node.id, spring);
     if (node.properties) {
       node.properties.scale = [0, 0, 0];
@@ -36319,6 +36405,9 @@ var handMenuHandler = {
     }
   }
 };
+
+// src/traits/ScrollableTrait.ts
+var _springAnimatorModule2 = null;
 var scrollStates = /* @__PURE__ */ new Map();
 var scrollableHandler = {
   name: "scrollable",
@@ -36329,8 +36418,10 @@ var scrollableHandler = {
     elasticity: 0.1,
     useSpringBounce: true
   },
-  onAttach(node, config, context) {
-    const spring = config.useSpringBounce ? new SpringAnimator.SpringAnimator(0, { ...SpringAnimator.SpringPresets.gentle, precision: 5e-3 }) : null;
+  async onAttach(node, config, context) {
+    _springAnimatorModule2 ?? (_springAnimatorModule2 = await import('@holoscript/engine/animation/SpringAnimator'));
+    const { SpringAnimator, SpringPresets } = _springAnimatorModule2;
+    const spring = config.useSpringBounce ? new SpringAnimator(0, { ...SpringPresets.gentle, precision: 5e-3 }) : null;
     scrollStates.set(node.id, {
       offset: 0,
       velocity: 0,
@@ -38410,6 +38501,7 @@ var characterHandler = {
     if (typeof instance.onUpdate === "function") instance.onUpdate(node, ctx, dt);
   }
 };
+var _mesh3 = null;
 var DEFAULT_TRAIT_CONFIG = {
   mechanism: "simple_majority",
   timeout: 5e3
@@ -38430,12 +38522,14 @@ var ConsensusTrait = class extends events.EventEmitter {
   /**
    * Start the consensus trait
    */
-  start() {
+  async start() {
     if (this.isStarted) return;
+    _mesh3 ?? (_mesh3 = await import('@holoscript/mesh'));
+    const { RaftConsensus, ConsensusManager } = _mesh3;
     const nodeId = this.config.nodeId || this.entityId;
     const mechanism = this.config.mechanism || "simple_majority";
     if (mechanism === "raft") {
-      this.raft = new mesh.RaftConsensus(nodeId, this.config);
+      this.raft = new RaftConsensus(nodeId, this.config);
       if (this.config.messageSender) {
         this.raft.setMessageSender(this.config.messageSender);
       }
@@ -38458,7 +38552,7 @@ var ConsensusTrait = class extends events.EventEmitter {
       }
       this.raft.start();
     } else {
-      this.manager = new mesh.ConsensusManager(nodeId, this.config);
+      this.manager = new ConsensusManager(nodeId, this.config);
       this.manager.on("proposal:accepted", (result) => {
         this.emit("proposal:accepted", result);
       });
@@ -44591,15 +44685,26 @@ var slidableHandler = {
     if (typeof instance.onUpdate === "function") instance.onUpdate(node, ctx, dt);
   }
 };
+var _spatial = null;
 var DEFAULT_TRAIT_CONFIG2 = {
-  ...spatial.DEFAULT_SPATIAL_CONFIG,
   initialPosition: [0, 0, 0],
   autoStart: true
 };
 var SpatialAwarenessTrait = class extends events.EventEmitter {
   constructor(id, config = {}) {
     super();
+    /**
+     * The underlying spatial provider. `null` until `ensureInitialized()` has run
+     * (it lazy-imports the optional engine peer to construct it). All sync methods
+     * that touch `this.provider` null-guard and no-op until initialization, since
+     * the trait is not "active" until `start()` / `ensureInitialized()` completes.
+     */
+    this.provider = null;
     this.ownsProvider = false;
+    /** True once `ensureInitialized()` has constructed the provider + wired events. */
+    this.initialized = false;
+    /** In-flight initialization promise so concurrent `ensureInitialized()` calls share one import. */
+    this.initPromise = null;
     this.velocity = [0, 0, 0];
     this.isActive = false;
     this.lastContext = null;
@@ -44608,26 +44713,53 @@ var SpatialAwarenessTrait = class extends events.EventEmitter {
     this.id = id;
     this.config = { ...DEFAULT_TRAIT_CONFIG2, ...config };
     this.position = this.config.initialPosition || [0, 0, 0];
-    if (this.config.sharedProvider) {
-      this.provider = this.config.sharedProvider;
-      this.ownsProvider = false;
-    } else {
-      this.provider = new spatial.SpatialContextProvider();
-      this.ownsProvider = true;
-    }
-    this.setupEventHandlers();
+    this.ownsProvider = !this.config.sharedProvider;
     if (this.config.autoStart) {
-      this.start();
+      void this.start().catch(() => {
+      });
     }
   }
   // ===========================================================================
   // LIFECYCLE
   // ===========================================================================
   /**
-   * Start spatial awareness
+   * Lazily load the optional `@holoscript/engine/spatial` peer, construct the
+   * provider, merge in the spatial defaults, and wire event forwarding.
+   *
+   * This is the single place the optional engine module is dynamically imported,
+   * so a cold `import '@holoscript/core'` never touches it. Safe to call multiple
+   * times — the import + construction happen exactly once (guarded by `initPromise`
+   * and `this.initialized`).
+   *
+   * @throws if `@holoscript/engine/spatial` is not installed (the optional peer).
+   */
+  async ensureInitialized() {
+    if (this.initialized) return;
+    if (this.initPromise) return this.initPromise;
+    this.initPromise = (async () => {
+      _spatial ?? (_spatial = await import('@holoscript/engine/spatial'));
+      this.config = { ..._spatial.DEFAULT_SPATIAL_CONFIG, ...this.config };
+      this.provider = this.config.sharedProvider ?? new _spatial.SpatialContextProvider();
+      this.setupEventHandlers();
+      this.initialized = true;
+    })();
+    try {
+      await this.initPromise;
+    } finally {
+      this.initPromise = null;
+    }
+  }
+  /**
+   * Start spatial awareness.
+   *
+   * Now async: it first awaits `ensureInitialized()` (which lazy-imports the
+   * optional engine peer and constructs the provider), then registers the agent.
    */
-  start() {
+  async start() {
     if (this.isActive) return;
+    await this.ensureInitialized();
+    if (this.isActive) return;
+    if (!this.provider) return;
     this.provider.registerAgent(this.id, this.position, this.config);
     if (this.ownsProvider) {
       this.provider.start();
@@ -44639,6 +44771,10 @@ var SpatialAwarenessTrait = class extends events.EventEmitter {
    */
   stop() {
     if (!this.isActive) return;
+    if (!this.provider) {
+      this.isActive = false;
+      return;
+    }
     this.provider.unregisterAgent(this.id);
     if (this.ownsProvider) {
       this.provider.stop();
@@ -44666,7 +44802,7 @@ var SpatialAwarenessTrait = class extends events.EventEmitter {
    */
   setPosition(position) {
     this.position = position;
-    if (this.isActive) {
+    if (this.isActive && this.provider) {
       this.provider.updateAgentPosition(this.id, position, this.velocity);
     }
   }
@@ -44681,7 +44817,7 @@ var SpatialAwarenessTrait = class extends events.EventEmitter {
    */
   setVelocity(velocity) {
     this.velocity = velocity;
-    if (this.isActive) {
+    if (this.isActive && this.provider) {
       this.provider.updateAgentPosition(this.id, this.position, velocity);
     }
   }
@@ -44698,7 +44834,9 @@ var SpatialAwarenessTrait = class extends events.EventEmitter {
    * Get current spatial context
    */
   getContext() {
-    return this.lastContext || this.provider.getContext(this.id);
+    if (this.lastContext) return this.lastContext;
+    if (!this.provider) return null;
+    return this.provider.getContext(this.id);
   }
   /**
    * Get nearby entities
@@ -44728,6 +44866,7 @@ var SpatialAwarenessTrait = class extends events.EventEmitter {
    * Find nearest entity
    */
   findNearest(typeFilter) {
+    if (!this.provider) return null;
     const results = this.provider.findNearest(this.position, 1, typeFilter);
     return results[0] || null;
   }
@@ -44735,12 +44874,14 @@ var SpatialAwarenessTrait = class extends events.EventEmitter {
    * Find all entities within radius
    */
   findWithin(radius, typeFilter) {
+    if (!this.provider) return [];
     return this.provider.findWithin(this.position, radius, typeFilter);
   }
   /**
    * Find visible entities
    */
   findVisible(direction, fov, maxDistance) {
+    if (!this.provider) return [];
     return this.provider.findVisible(this.position, direction, fov, maxDistance);
   }
   /**
@@ -44768,18 +44909,21 @@ var SpatialAwarenessTrait = class extends events.EventEmitter {
    * Register an entity for tracking
    */
   registerEntity(entity) {
+    if (!this.provider) return;
     this.provider.setEntity(entity);
   }
   /**
    * Unregister an entity
    */
   unregisterEntity(entityId) {
+    if (!this.provider) return;
     this.provider.removeEntity(entityId);
   }
   /**
    * Batch register entities
    */
   registerEntities(entities) {
+    if (!this.provider) return;
     this.provider.setEntities(entities);
   }
   // ===========================================================================
@@ -44789,24 +44933,28 @@ var SpatialAwarenessTrait = class extends events.EventEmitter {
    * Register a region
    */
   registerRegion(region) {
+    if (!this.provider) return;
     this.provider.setRegion(region);
   }
   /**
    * Unregister a region
    */
   unregisterRegion(regionId) {
+    if (!this.provider) return;
     this.provider.removeRegion(regionId);
   }
   /**
    * Subscribe to region events
    */
   watchRegion(regionId, callback) {
+    if (!this.provider) return;
     this.provider.subscribeToRegion(this.id, regionId, callback);
   }
   /**
    * Unsubscribe from region events
    */
   unwatchRegion(regionId) {
+    if (!this.provider) return;
     this.provider.unsubscribeFromRegion(this.id, regionId);
   }
   // ===========================================================================
@@ -44817,23 +44965,26 @@ var SpatialAwarenessTrait = class extends events.EventEmitter {
    */
   setPerceptionRadius(radius) {
     this.config.perceptionRadius = radius;
-    if (this.isActive) {
+    if (this.isActive && this.provider) {
       this.provider.unregisterAgent(this.id);
       this.provider.registerAgent(this.id, this.position, this.config);
     }
   }
   /**
    * Get perception radius
+   *
+   * Returns 0 if the spatial defaults have not yet been merged (i.e. before
+   * `ensureInitialized()` ran and no explicit value was supplied in config).
    */
   getPerceptionRadius() {
-    return this.config.perceptionRadius;
+    return this.config.perceptionRadius ?? 0;
   }
   /**
    * Set entity type filter
    */
   setEntityTypeFilter(types) {
     this.config.entityTypeFilter = types;
-    if (this.isActive) {
+    if (this.isActive && this.provider) {
       this.provider.unregisterAgent(this.id);
       this.provider.registerAgent(this.id, this.position, this.config);
     }
@@ -44845,38 +44996,40 @@ var SpatialAwarenessTrait = class extends events.EventEmitter {
    * Setup event handlers from provider
    */
   setupEventHandlers() {
-    this.provider.on("entity:entered", (agentId, event) => {
+    const provider = this.provider;
+    if (!provider) return;
+    provider.on("entity:entered", (agentId, event) => {
       if (agentId !== this.id) return;
       if (event.type === "entity_entered") {
         this.emit("entity:entered", event.entity, event.distance);
       }
     });
-    this.provider.on("entity:exited", (agentId, event) => {
+    provider.on("entity:exited", (agentId, event) => {
       if (agentId !== this.id) return;
       if (event.type === "entity_exited") {
         this.emit("entity:exited", event.entity);
       }
     });
-    this.provider.on("region:entered", (agentId, event) => {
+    provider.on("region:entered", (agentId, event) => {
       if (agentId !== this.id) return;
       if (event.type === "region_entered") {
         this.emit("region:entered", event.region, event.previousRegion);
       }
     });
-    this.provider.on("region:exited", (agentId, event) => {
+    provider.on("region:exited", (agentId, event) => {
       if (agentId !== this.id) return;
       if (event.type === "region_exited") {
         this.emit("region:exited", event.region);
       }
     });
-    this.provider.on("visibility:changed", (agentId, event) => {
+    provider.on("visibility:changed", (agentId, event) => {
       if (agentId !== this.id) return;
       if (event.type === "visibility_changed") {
         this.visibleEntities.set(event.entityId, event.visible);
         this.emit("visibility:changed", event.entityId, event.visible);
       }
     });
-    this.provider.on("context:updated", (agentId, context) => {
+    provider.on("context:updated", (agentId, context) => {
       if (agentId !== this.id) return;
       this.lastContext = context;
       this.emit("context:updated", context);
@@ -44886,15 +45039,17 @@ var SpatialAwarenessTrait = class extends events.EventEmitter {
 function createSpatialAwarenessTrait(id, config) {
   return new SpatialAwarenessTrait(id, config);
 }
-function createSharedSpatialProvider() {
-  return new spatial.SpatialContextProvider();
+async function createSharedSpatialProvider() {
+  _spatial ?? (_spatial = await import('@holoscript/engine/spatial'));
+  return new _spatial.SpatialContextProvider();
 }
 var spatialAwarenessHandler = {
   name: "spatial_awareness",
   defaultConfig: {},
-  onAttach(node, config, ctx) {
+  async onAttach(node, config, ctx) {
     const instance = new SpatialAwarenessTrait(node.id || "spatial_awareness", config);
     node.__spatial_awareness_instance = instance;
+    await instance.start();
     ctx.emit("spatial_awareness_attached", { node, config });
   },
   onDetach(node, _config, ctx) {
@@ -55553,7 +55708,7 @@ var VRTraitRegistry = class {
     this.register(hapticHandler);
     this.register(eyeTrackedHandler);
     this.register(roadmapNodeHandler);
-    this.register(chunkAIX25INK_cjs.mitosisHandler);
+    this.register(chunkTVHSPJ4N_cjs.mitosisHandler);
     this.register(planeDetectionHandler);
     this.register(meshDetectionHandler);
     this.register(roomMeshHandler);
@@ -55718,8 +55873,8 @@ var VRTraitRegistry = class {
     this.register(sseHandler);
     this.register(modelLoadHandler);
     this.register(inferenceHandler);
-    this.register(chunkAIX25INK_cjs.embeddingHandler);
-    this.register(chunkAIX25INK_cjs.jepObjectiveHandler);
+    this.register(chunkTVHSPJ4N_cjs.embeddingHandler);
+    this.register(chunkTVHSPJ4N_cjs.jepObjectiveHandler);
     this.register(fineTuneHandler);
     this.register(vectorSearchHandler);
     this.register(promptTemplateHandler);
@@ -55801,8 +55956,8 @@ var VRTraitRegistry = class {
     this.register(trainingLoopHandler);
     this.register(modelLoadHandler);
     this.register(inferenceHandler);
-    this.register(chunkAIX25INK_cjs.embeddingHandler);
-    this.register(chunkAIX25INK_cjs.jepObjectiveHandler);
+    this.register(chunkTVHSPJ4N_cjs.embeddingHandler);
+    this.register(chunkTVHSPJ4N_cjs.jepObjectiveHandler);
     this.register(sqlQueryHandler);
     this.register(ormEntityHandler);
     this.register(offlineSyncHandler);
@@ -55852,7 +56007,7 @@ var VRTraitRegistry = class {
     this.register(npcAIHandler);
     this.register(objectTrackingHandler);
     this.register(openXRHALHandler);
-    this.register(chunkAIX25INK_cjs.orbitalHandler);
+    this.register(chunkTVHSPJ4N_cjs.orbitalHandler);
     this.register(partnerSDKHandler);
     this.register(poseEstimationHandler);
     this.register(ragKnowledgeHandler);
@@ -56419,5 +56574,5 @@ exports.windHandler = windHandler;
 exports.withNegotiation = withNegotiation;
 exports.wotThingHandler = wotThingHandler;
 exports.zkPrivateHandler = zkPrivateHandler;
-//# sourceMappingURL=chunk-6S6TKNEA.cjs.map
-//# sourceMappingURL=chunk-6S6TKNEA.cjs.map
+//# sourceMappingURL=chunk-3HYYMEXI.cjs.map
+//# sourceMappingURL=chunk-3HYYMEXI.cjs.map