@holoscript/core 8.0.5 → 8.0.7

package/dist/{chunk-QPSKHBJP.js → chunk-C7ZBSV2Q.js}

@@ -1,5 +1,5 @@
 import { init_traitDocs, getTraitDoc, formatTraitDocCompact } from './chunk-THCK6ECW.js';
-import { init_AgentRiskRegistry, getAgentRiskRegistry, TIER_COMPOSITION_RISK_CAP, isDangerousOperation } from './chunk-N75IH2HY.js';
+import { init_AgentRiskRegistry, getAgentRiskRegistry, TIER_COMPOSITION_RISK_CAP, isDangerousOperation } from './chunk-2Y3V22SG.js';
 import { init_safeJsonParse, safeJsonParse, readJson } from './chunk-VVKVQZI6.js';
 import { __esm } from './chunk-OL46QLBJ.js';
 import * as crypto3 from 'crypto';
@@ -3958,7 +3958,9 @@ var init_ANSNamespace = __esm({
       STATE: "/compile/meta/state",
       TRAIT_COMPOSITION: "/compile/meta/trait-composition",
       // ── mixin ────────────────────────────────────────────────────────────
-      DOMAIN_BLOCK: "/compile/mixin/domain-block"
+      DOMAIN_BLOCK: "/compile/mixin/domain-block",
+      // ── studio ───────────────────────────────────────────────────────────
+      CODE_EDITOR: "/compile/studio/code-editor"
     };
     COMPILER_DOMAIN_MAP = {
       // gamedev
@@ -4016,7 +4018,9 @@ var init_ANSNamespace = __esm({
       state: ANSDomain.META,
       "trait-composition": ANSDomain.META,
       // mixin
-      "domain-block": ANSDomain.MIXIN
+      "domain-block": ANSDomain.MIXIN,
+      // studio
+      "code-editor": ANSDomain.META
     };
     COMPILER_ANS_MAP = {
       unity: ANSCapabilityPath.UNITY,
@@ -4059,7 +4063,8 @@ var init_ANSNamespace = __esm({
       incremental: ANSCapabilityPath.INCREMENTAL,
       state: ANSCapabilityPath.STATE,
       "trait-composition": ANSCapabilityPath.TRAIT_COMPOSITION,
-      "domain-block": ANSCapabilityPath.DOMAIN_BLOCK
+      "domain-block": ANSCapabilityPath.DOMAIN_BLOCK,
+      "code-editor": ANSCapabilityPath.CODE_EDITOR
     };
     ALL_COMPILER_NAMES = Object.keys(
       COMPILER_DOMAIN_MAP
@@ -5505,7 +5510,8 @@ var init_CompilerBase = __esm({
       NodeServiceCompiler: "node-service",
       NextJSAPICompiler: "nextjs-api",
       MCPConfigCompiler: "domain-block",
-      AgentInferenceCompiler: "agent-inference"
+      AgentInferenceCompiler: "agent-inference",
+      CodeEditorCompiler: "code-editor"
     };
     UnauthorizedCompilerAccessError = class extends Error {
       constructor(decision, operation, compilerName) {
@@ -5959,5 +5965,5 @@ Required Permission: ${decision.requiredPermission || "unknown"}`
 });
 
 export { ANSCapabilityPath, BUILTIN_NORMS, BUILTIN_NORM_PROVENANCE, CompilerBase, CompilerDocumentationGenerator, UNKNOWN_NORM_PROVENANCE, UnauthorizedCompilerAccessError, createTestCompilerToken, criticalMassForChange, deserializeNormProvenance, escapeStringValue, getBuiltinNorm, getRBAC, init_ANSNamespace, init_AgentRBAC, init_CompilerBase, init_CompilerDocumentationGenerator, init_CultureTraits, isCapabilityTokenCredential, normalizeNormProvenance, normsByCategory, serializeNormProvenance };
-//# sourceMappingURL=chunk-QPSKHBJP.js.map
-//# sourceMappingURL=chunk-QPSKHBJP.js.map
+//# sourceMappingURL=chunk-C7ZBSV2Q.js.map
+//# sourceMappingURL=chunk-C7ZBSV2Q.js.map

package/dist/{chunk-YN6V7R3L.cjs → chunk-CCPSNT6B.cjs}

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkKKP7JKN4_cjs = require('./chunk-KKP7JKN4.cjs');
+var chunkLODTHGST_cjs = require('./chunk-LODTHGST.cjs');
 
 // src/compiler/QuantumCircuitCompiler.ts
-chunkKKP7JKN4_cjs.init_CompilerBase();
+chunkLODTHGST_cjs.init_CompilerBase();
 function qubitsForMolecule(atoms) {
   const orbitalCount = atoms.reduce((sum, a) => {
     if (a.symbol === "H") return sum + 1;
@@ -88,7 +88,9 @@ function generateVQECircuit(atoms, moleculeName, ansatzLayers, initialParams) {
   }
   let paramIdx = 0;
   for (let layer = 0; layer < ansatzLayers; layer++) {
-    lines.push(`// Layer ${layer}: Ry rotations ( - [${paramIdx}..${paramIdx + n - 1}] optimised by VQE)`);
+    lines.push(
+      `// Layer ${layer}: Ry rotations ( - [${paramIdx}..${paramIdx + n - 1}] optimised by VQE)`
+    );
     for (let i = 0; i < n; i++) {
       lines.push(`ry(theta_${paramIdx}) q[${i}];`);
       paramIdx++;
@@ -185,7 +187,7 @@ function generateStubCircuit() {
     ]
   };
 }
-var QuantumCircuitCompiler = class extends chunkKKP7JKN4_cjs.CompilerBase {
+var QuantumCircuitCompiler = class extends chunkLODTHGST_cjs.CompilerBase {
   constructor() {
     super(...arguments);
     this.compilerName = "QuantumCircuitCompiler";
@@ -277,7 +279,10 @@ var QuantumCircuitCompiler = class extends chunkKKP7JKN4_cjs.CompilerBase {
   /** Build a {@link QASMOutput} for a VQE circuit. */
   buildVQEOutput(atoms, cfg) {
     const moleculeName = (extractNumber(cfg, "moleculeName") !== void 0 ? void 0 : cfg["moleculeName"]?.value) ?? atoms.map((a) => a.symbol).join("") ?? "molecule";
-    const ansatzLayers = Math.max(1, Math.round(extractNumber(cfg, "ansatzLayers") ?? extractNumber(cfg, "ansatz_layers") ?? 2));
+    const ansatzLayers = Math.max(
+      1,
+      Math.round(extractNumber(cfg, "ansatzLayers") ?? extractNumber(cfg, "ansatz_layers") ?? 2)
+    );
     const initialParams = cfg["initialParams"]?.value ?? cfg["initial_params"]?.value ?? void 0;
     const { qasm, numQubits, estimatedDepth, warnings, paramNames } = generateVQECircuit(
       atoms,
@@ -323,5 +328,5 @@ var QuantumCircuitCompiler = class extends chunkKKP7JKN4_cjs.CompilerBase {
 };
 
 exports.QuantumCircuitCompiler = QuantumCircuitCompiler;
-//# sourceMappingURL=chunk-YN6V7R3L.cjs.map
-//# sourceMappingURL=chunk-YN6V7R3L.cjs.map
+//# sourceMappingURL=chunk-CCPSNT6B.cjs.map
+//# sourceMappingURL=chunk-CCPSNT6B.cjs.map

package/dist/{chunk-NW5G5FBQ.js → chunk-DD2JQ7TS.js}

@@ -201,7 +201,8 @@ function describeEnvironment(env) {
   if (env.browser?.browser) parts.push(env.browser.browser);
   if (env.browser?.os) parts.push(env.browser.os);
   if (env.node) parts.push(`node ${env.node.version} ${env.node.platform}/${env.node.arch}`);
-  if (env.gpu?.vendor) parts.push(`gpu:${env.gpu.vendor}${env.gpu.architecture ? "/" + env.gpu.architecture : ""}`);
+  if (env.gpu?.vendor)
+    parts.push(`gpu:${env.gpu.vendor}${env.gpu.architecture ? "/" + env.gpu.architecture : ""}`);
   if (env.annotations) {
     for (const [k, v] of Object.entries(env.annotations)) {
       parts.push(`${k}=${v}`);
@@ -211,5 +212,5 @@ function describeEnvironment(env) {
 }
 
 export { DeterminismHarness, captureEnvironment, describeEnvironment, hashBytes };
-//# sourceMappingURL=chunk-NW5G5FBQ.js.map
-//# sourceMappingURL=chunk-NW5G5FBQ.js.map
+//# sourceMappingURL=chunk-DD2JQ7TS.js.map
+//# sourceMappingURL=chunk-DD2JQ7TS.js.map

package/dist/{chunk-JD7CIZ33.js → chunk-DUCB6LGL.js}

@@ -1,4 +1,4 @@
-import { init_AgentRiskRegistry, getAgentRiskRegistry } from './chunk-N75IH2HY.js';
+import { init_AgentRiskRegistry, getAgentRiskRegistry } from './chunk-2Y3V22SG.js';
 import { __export } from './chunk-OL46QLBJ.js';
 
 // src/hololand/index.ts
@@ -620,7 +620,9 @@ var _HololandClient = class _HololandClient {
         signal: controller.signal
       });
       if (!response.ok) {
-        throw new Error(`Failed to fetch world "${worldId}": ${response.status} ${response.statusText}`);
+        throw new Error(
+          `Failed to fetch world "${worldId}": ${response.status} ${response.statusText}`
+        );
       }
       return await response.json();
     } finally {
@@ -964,14 +966,10 @@ var CrossValidationRegistry = class {
       );
     }
     if (this.agreementSeverityThreshold < 0 || this.agreementSeverityThreshold > 100) {
-      throw new Error(
-        "CrossValidationRegistry: agreementSeverityThreshold must be in [0,100]"
-      );
+      throw new Error("CrossValidationRegistry: agreementSeverityThreshold must be in [0,100]");
     }
     if (this.tolerance.defaultNumericTolerance <= 0) {
-      throw new Error(
-        "CrossValidationRegistry: defaultNumericTolerance must be > 0"
-      );
+      throw new Error("CrossValidationRegistry: defaultNumericTolerance must be > 0");
     }
     if (this.maxRounds < 1) {
       throw new Error("CrossValidationRegistry: maxRounds must be >= 1");
@@ -1945,5 +1943,5 @@ function createMessage(type, payload, options = {}) {
 }
 
 export { CrossValidationRegistry, DEFAULT_ENVELOPES, DEFAULT_ITEM_AUTONOMOUS_AGENDA, DEFAULT_ITEM_REPUTATION_LEDGER, DEFAULT_ITEM_VERBAL_FINGERPRINT, DEFAULT_ITEM_VOCABULARY_REGISTER, HEARTBEAT_INTERVAL, HololandClient, ITEM_DEFAULT_TICK_INTERVAL_MS, MAX_CHUNK_SIZE, MAX_MESSAGE_SIZE, PROTOCOL_VERSION, PhysicsBoundsRegistry, StreamProtocol, TIMEOUT_INTERVAL, computeConsensus, connectToHololand, createHoloLandItem, createMessage, createWorldConfig, createWorldDefinition, createWorldEnvironment, createWorldMetadata, disconnectFromHololand, getCrossValidationRegistry, getHololandClient, getItemChain, getPhysicsBoundsRegistry, getStreamProtocol, hololand_exports, linkItems, resetCrossValidationRegistry, resetPhysicsBoundsRegistry, suggestedQuorum, wrapPhysicsService };
-//# sourceMappingURL=chunk-JD7CIZ33.js.map
-//# sourceMappingURL=chunk-JD7CIZ33.js.map
+//# sourceMappingURL=chunk-DUCB6LGL.js.map
+//# sourceMappingURL=chunk-DUCB6LGL.js.map

package/dist/{chunk-ANXZFVY2.js → chunk-DY72BMU5.js}

@@ -1,4 +1,4 @@
-import { init_AgentRBAC, init_CompilerBase, getRBAC, UnauthorizedCompilerAccessError } from './chunk-QPSKHBJP.js';
+import { init_AgentRBAC, init_CompilerBase, getRBAC, UnauthorizedCompilerAccessError } from './chunk-C7ZBSV2Q.js';
 import { __export, __esm } from './chunk-OL46QLBJ.js';
 
 // src/compiler/StateCompiler.ts
@@ -109,5 +109,5 @@ var init_StateCompiler = __esm({
 });
 
 export { StateCompiler, StateCompiler_exports, UnauthorizedStateCompilerAccessError, init_StateCompiler };
-//# sourceMappingURL=chunk-ANXZFVY2.js.map
-//# sourceMappingURL=chunk-ANXZFVY2.js.map
+//# sourceMappingURL=chunk-DY72BMU5.js.map
+//# sourceMappingURL=chunk-DY72BMU5.js.map

package/dist/{chunk-AIA52I7T.cjs → chunk-EBS32AJI.cjs}

@@ -428,7 +428,8 @@ function validatePlatformConstraints(composition) {
     }
   };
   for (const obj of composition.objects || []) checkObject(obj);
-  for (const tmpl of composition.templates || []) check(tmpl.platformConstraint, `template "${tmpl.name}"`);
+  for (const tmpl of composition.templates || [])
+    check(tmpl.platformConstraint, `template "${tmpl.name}"`);
   for (const tmpl of composition.templates || []) {
     for (const trait of tmpl.traits || []) {
       check(trait.platformConstraint, `trait "@${trait.name}" on template "${tmpl.name}"`);
@@ -436,7 +437,8 @@ function validatePlatformConstraints(composition) {
   }
   for (const norm of composition.norms || []) check(norm.platformConstraint, `norm "${norm.name}"`);
   for (const grp of composition.spatialGroups || []) checkGroup(grp);
-  for (const light of composition.lights || []) check(light.platformConstraint, `light "${light.name}"`);
+  for (const light of composition.lights || [])
+    check(light.platformConstraint, `light "${light.name}"`);
   return errors;
 }
 function filterCompositionForPlatform(composition, platform) {
@@ -539,5 +541,5 @@ exports.normalizePlatformName = normalizePlatformName;
 exports.platformCategory = platformCategory;
 exports.resolvePlatforms = resolvePlatforms;
 exports.selectBlock = selectBlock;
-//# sourceMappingURL=chunk-AIA52I7T.cjs.map
-//# sourceMappingURL=chunk-AIA52I7T.cjs.map
+//# sourceMappingURL=chunk-EBS32AJI.cjs.map
+//# sourceMappingURL=chunk-EBS32AJI.cjs.map

package/dist/{chunk-6DO5IZ5N.cjs → chunk-EDPYCLRC.cjs}

@@ -2,11 +2,10 @@
 
 var chunkGJNCFRJU_cjs = require('./chunk-GJNCFRJU.cjs');
 var chunkYDPEHCCI_cjs = require('./chunk-YDPEHCCI.cjs');
-var chunkJIYN45TV_cjs = require('./chunk-JIYN45TV.cjs');
-var chunkTVHSPJ4N_cjs = require('./chunk-TVHSPJ4N.cjs');
+var chunkGVFJ6T4S_cjs = require('./chunk-GVFJ6T4S.cjs');
+var chunkX2AVEAZM_cjs = require('./chunk-X2AVEAZM.cjs');
 var chunkILRBGFVD_cjs = require('./chunk-ILRBGFVD.cjs');
 var chunkE7JP3BS3_cjs = require('./chunk-E7JP3BS3.cjs');
-var ws = require('ws');
 
 // src/HoloScriptRuntime.ts
 chunkE7JP3BS3_cjs.init_safeJsonParse();
@@ -28,13 +27,7 @@ function calculateArc(start, end, speed) {
 }
 
 // src/runtime/condition-evaluator.ts
-var SUSPICIOUS_KEYWORDS = [
-  "eval",
-  "process",
-  "require",
-  "__proto__",
-  "constructor"
-];
+var SUSPICIOUS_KEYWORDS = ["eval", "process", "require", "__proto__", "constructor"];
 function evaluateCondition(condition, evaluate) {
   if (!condition) return false;
   const condStr = String(condition);
@@ -230,7 +223,10 @@ async function applyTransformation(data, transform, ctx) {
           return ctx.evaluateExpression(mapper);
         });
       }
-      return data.map((item) => ({ value: item, processed: true }));
+      return data.map((item) => ({
+        value: item,
+        processed: true
+      }));
     }
     case "reduce": {
       if (!Array.isArray(data)) return data;
@@ -324,11 +320,14 @@ function updateAnimations(animations, setVariable, now) {
     }
   }
 }
+
+// src/runtime/visualizer-server.ts
+var WebSocket = chunkYDPEHCCI_cjs.lazyPeerSymbol("ws", "WebSocket");
 function broadcast(wss, type, payload) {
   if (!wss) return;
   const message = JSON.stringify({ type, payload });
   wss.clients.forEach((client) => {
-    if (client.readyState === ws.WebSocket.OPEN) {
+    if (client.readyState === WebSocket.OPEN) {
       client.send(message);
     }
   });
@@ -585,11 +584,7 @@ var CREATION_PUFF_COUNT = 20;
 function normalizePosition(position) {
   if (!position) return [0, 0, 0];
   if (Array.isArray(position)) {
-    return [
-      Number(position[0]) || 0,
-      Number(position[1]) || 0,
-      Number(position[2]) || 0
-    ];
+    return [Number(position[0]) || 0, Number(position[1]) || 0, Number(position[2]) || 0];
   }
   const p = position;
   return [Number(p[0]) || 0, Number(p[1]) || 0, Number(p[2]) || 0];
@@ -695,7 +690,12 @@ async function executeOrb(node, ctx) {
     ctx.applyDirectives(orbData);
   }
   if (!isUpdate) {
-    ctx.createParticleEffect(`${node.name}_creation`, adjustedPos, CREATION_PUFF_COLOR, CREATION_PUFF_COUNT);
+    ctx.createParticleEffect(
+      `${node.name}_creation`,
+      adjustedPos,
+      CREATION_PUFF_COLOR,
+      CREATION_PUFF_COUNT
+    );
   }
   if (ctx.isAgent(node)) {
     if (!isUpdate || !ctx.getAgentRuntime(node.name)) {
@@ -1191,10 +1191,7 @@ var NODE_TYPE_HANDLERS = {
   building: (node) => executeStructure(node),
   // Capitalization-sensitive branches (composition vs Composition, template vs Template)
   composition: (node, r) => executeComposition(node, r.buildSimpleExecutorContext()),
-  Composition: (node, r) => executeHoloComposition(
-    node,
-    r.buildHoloCompositionContext()
-  ),
+  Composition: (node, r) => executeHoloComposition(node, r.buildHoloCompositionContext()),
   template: (node, r) => r.executeTemplate(node),
   Template: (node, r) => executeHoloTemplate(
     node,
@@ -1239,9 +1236,7 @@ var NODE_TYPE_HANDLERS = {
   forEach: (node, r) => r.executeForEachLoop(
     node
   ),
-  while: (node, r) => r.executeWhileLoop(
-    node
-  ),
+  while: (node, r) => r.executeWhileLoop(node),
   if: (node, r) => r.executeIfStatement(
     node
   ),
@@ -1404,9 +1399,7 @@ async function executeHoloObject(node, ctx) {
       })),
       ...template?.directives || []
     ],
-    traits: new Map(
-      (node.traits || []).map((t) => [t.name, t.config])
-    ),
+    traits: new Map((node.traits || []).map((t) => [t.name, t.config])),
     children: node.children || []
   };
   if (template) {
@@ -1454,7 +1447,14 @@ function applyDirectives(node, ctx) {
       if (handler) {
         handler.onAttach?.(node, d.config || {}, {
           emit: (event, payload) => ctx.emit(event, payload),
-          getScaleMultiplier: () => ctx.getCurrentScale() || 1
+          getScaleMultiplier: () => ctx.getCurrentScale() || 1,
+          // premortem 2026-06-07 (task_1780881034070_wnlv): the attach context
+          // previously lacked state access, so a handler's `setState` no-op'd on
+          // attach and solver results never reached durable runtime state (only
+          // the fire-and-forget emit). Mirror updateTraits' context so attach-time
+          // results are persisted for receipt / SimulationContract readers (D.057).
+          getState: () => ctx.state.getSnapshot(),
+          setState: (updates) => ctx.state.update(updates)
         });
       }
       if (d.name === "chat") {
@@ -2250,7 +2250,11 @@ async function executeMatch(node, ctx) {
           return lastResult;
         } else {
           const result = ctx.evaluateExpression(String(matchCase.body));
-          return { success: true, output: result, executionTime: Date.now() - startTime };
+          return {
+            success: true,
+            output: result,
+            executionTime: Date.now() - startTime
+          };
         }
       }
     }
@@ -2311,9 +2315,7 @@ async function evaluateHoloExpression(expr, scopeOverride, ctx) {
       }
       const callee = await evaluateHoloExpression(expr.callee, scopeOverride, ctx);
       const args = await Promise.all(
-        expr.arguments.map(
-          (a) => evaluateHoloExpression(a, scopeOverride, ctx)
-        )
+        expr.arguments.map((a) => evaluateHoloExpression(a, scopeOverride, ctx))
       );
       if (typeof callee === "function") {
         return callee(...args);
@@ -2455,7 +2457,7 @@ var HoloScriptAgentRuntime = class _HoloScriptAgentRuntime {
     // JEPA action-planning loop (Phase 8)
     // Default latentDim=64, condDim=16 (action conditioning). Caller can swap
     // weights externally via this.jepaPredictor.setWeights() after training.
-    this.jepaPredictor = new chunkTVHSPJ4N_cjs.JEPAPredictor({ latentDim: 64, condDim: 16 });
+    this.jepaPredictor = new chunkX2AVEAZM_cjs.JEPAPredictor({ latentDim: 64, condDim: 16 });
     this.jepaObjectiveNode = {};
     this.jepaObjectiveAttached = false;
     if (!agentNode || !parentRuntime) {
@@ -2599,16 +2601,12 @@ var HoloScriptAgentRuntime = class _HoloScriptAgentRuntime {
   ensureJepaObjectiveAttached() {
     if (!this.jepaObjectiveAttached) {
       const config = this.getJepaObjectiveConfig();
-      chunkTVHSPJ4N_cjs.jepObjectiveHandler.onAttach?.(
-        this.jepaObjectiveNode,
-        config,
-        this.buildJepaTraitContext()
-      );
+      chunkX2AVEAZM_cjs.jepObjectiveHandler.onAttach?.(this.jepaObjectiveNode, config, this.buildJepaTraitContext());
       this.jepaObjectiveAttached = true;
     }
   }
   getJepaObjectiveConfig() {
-    const config = chunkTVHSPJ4N_cjs.jepObjectiveHandler.defaultConfig;
+    const config = chunkX2AVEAZM_cjs.jepObjectiveHandler.defaultConfig;
     if (!config) {
       throw new Error("JEPAObjective handler defaultConfig is required for offline training");
     }
@@ -2658,17 +2656,12 @@ var HoloScriptAgentRuntime = class _HoloScriptAgentRuntime {
     const latentDim = config.latentDim;
     const outcomeStr = outcome.success ? `success:${String(outcome.output ?? "")}` : `failure:${String(outcome.error ?? "")}`;
     const targetVec = textToEmbeddingFloat32(outcomeStr, latentDim);
-    chunkTVHSPJ4N_cjs.jepObjectiveHandler.onEvent?.(
-      this.jepaObjectiveNode,
-      config,
-      this.buildJepaTraitContext(),
-      {
-        type: "jepa:encode_pair",
-        context: contextStr,
-        targetVec,
-        conditioning: void 0
-      }
-    );
+    chunkX2AVEAZM_cjs.jepObjectiveHandler.onEvent?.(this.jepaObjectiveNode, config, this.buildJepaTraitContext(), {
+      type: "jepa:encode_pair",
+      context: contextStr,
+      targetVec,
+      conditioning: void 0
+    });
   }
   /**
    * Lightweight fork-detection heuristic for runtime adapters.
@@ -2744,7 +2737,9 @@ var HoloScriptAgentRuntime = class _HoloScriptAgentRuntime {
     if (this.isDestroyed) return { success: false, error: "Agent destroyed" };
     const forkCheck = this.checkForkSandbox();
     if (!forkCheck.allowed) {
-      chunkILRBGFVD_cjs.logger.warn(`[Agent:${this.agentNode.name}] ForkSandboxGate blocked action "${actionName}": ${forkCheck.reason}`);
+      chunkILRBGFVD_cjs.logger.warn(
+        `[Agent:${this.agentNode.name}] ForkSandboxGate blocked action "${actionName}": ${forkCheck.reason}`
+      );
       return { success: false, error: `ForkSandboxGate: ${forkCheck.reason}` };
     }
     const directives = this.agentNode.directives;
@@ -2802,9 +2797,7 @@ var HoloScriptAgentRuntime = class _HoloScriptAgentRuntime {
     try {
       this.trainJepaOffline(stateBefore, actionName, executionResult);
     } catch (trainErr) {
-      chunkILRBGFVD_cjs.logger.warn(
-        `[JEPA:${this.agentNode.name}] trainJepaOffline error: ${String(trainErr)}`
-      );
+      chunkILRBGFVD_cjs.logger.warn(`[JEPA:${this.agentNode.name}] trainJepaOffline error: ${String(trainErr)}`);
     }
     return executionResult;
   }
@@ -2945,6 +2938,15 @@ var HoloScriptAgentRuntime = class _HoloScriptAgentRuntime {
   }
 };
 
+// src/runtime/plugin-trait-registrar.ts
+var TRAIT_OWNER_KEY = "__pluginOwner";
+function registerPluginTraits(target, pluginId, handlers) {
+  for (const handler of handlers) {
+    handler[TRAIT_OWNER_KEY] = pluginId;
+    target.registerTrait(handler.name, handler);
+  }
+}
+
 // src/extensions/ExtensionRegistry.ts
 var ExtensionRegistry = class {
   constructor(runtime) {
@@ -3022,9 +3024,11 @@ var StateSynchronizer = chunkYDPEHCCI_cjs.lazyPeerSymbol(
   "@holoscript/mesh",
   "StateSynchronizer"
 );
-var engineRuntime = chunkYDPEHCCI_cjs.definePeerNamespace(
-  "@holoscript/engine/runtime"
+var WebSocketServer = chunkYDPEHCCI_cjs.lazyPeerSymbol(
+  "ws",
+  "WebSocketServer"
 );
+var engineRuntime = chunkYDPEHCCI_cjs.definePeerNamespace("@holoscript/engine/runtime");
 var RUNTIME_SECURITY_LIMITS = {
   maxExecutionDepth: 50,
   maxTotalNodes: 1e3,
@@ -3063,7 +3067,10 @@ var HoloScriptRuntime = class {
     for (const [name, fn] of this.builtinFunctions) {
       this.context.functions.set(name, ((...spreadArgs) => fn(spreadArgs)));
     }
-    attachStateInvalidationConsumer(this.buildEventSystemContext(), defaultStateInvalidationRegistry);
+    attachStateInvalidationConsumer(
+      this.buildEventSystemContext(),
+      defaultStateInvalidationRegistry
+    );
     this.registerFunction("get_attended_entities", (args) => {
       const topK = typeof args[0] === "number" ? args[0] : 10;
       const selfRaw = this.context.variables.get("self");
@@ -3088,11 +3095,13 @@ var HoloScriptRuntime = class {
         topK
       );
     });
-    this.traitHandlers.set("mitosis", chunkTVHSPJ4N_cjs.mitosisHandler);
-    this.traitHandlers.set("orbital", chunkTVHSPJ4N_cjs.orbitalHandler);
+    this.traitHandlers.set("mitosis", chunkX2AVEAZM_cjs.mitosisHandler);
+    this.traitHandlers.set("orbital", chunkX2AVEAZM_cjs.orbitalHandler);
     this.extensionRegistry = new ExtensionRegistry(this);
     engineRuntime.stateMachineInterpreter.setHookExecutor((code) => this.evaluateExpression(code));
-    engineRuntime.stateMachineInterpreter.setGuardEvaluator((expr) => this.evaluateExpression(expr));
+    engineRuntime.stateMachineInterpreter.setGuardEvaluator(
+      (expr) => this.evaluateExpression(expr)
+    );
   }
   /**
    * Initialize built-in functions
@@ -3136,6 +3145,15 @@ var HoloScriptRuntime = class {
    */
   registerTrait(name, handler) {
     const vrName = name;
+    const existingHandler = this.traitHandlers.get(vrName);
+    if (existingHandler) {
+      const priorOwner = existingHandler[TRAIT_OWNER_KEY] ?? "unknown";
+      const incomingOwner = handler[TRAIT_OWNER_KEY] ?? "unknown";
+      chunkILRBGFVD_cjs.logger.warn(
+        `Trait '${name}' is already registered by '${String(priorOwner)}'; ignoring the duplicate from '${String(incomingOwner)}' (keep-first). Trait names must be unique across plugins.`
+      );
+      return;
+    }
     this.traitHandlers.set(vrName, handler);
     chunkILRBGFVD_cjs.logger.info(`Registered trait: ${name}`);
   }
@@ -3708,7 +3726,7 @@ var HoloScriptRuntime = class {
   // ============================================================================
   startVisualizationServer(port = 8080) {
     try {
-      this.wss = new ws.WebSocketServer({ port });
+      this.wss = new WebSocketServer({ port });
       chunkILRBGFVD_cjs.logger.info(`[Visualizer] WebSocket server started on port ${port}`);
       this.timeManager = new TimeManager(/* @__PURE__ */ new Date());
       this.timeManager.onUpdate((julianDate, date) => {
@@ -4081,7 +4099,7 @@ var HoloScriptRuntime = class {
       parent: previousScope
     };
     try {
-      const parser = new chunkJIYN45TV_cjs.HoloScriptCodeParser();
+      const parser = new chunkGVFJ6T4S_cjs.HoloScriptCodeParser();
       const result = parser.parse(migration.body);
       if (result.errors.length > 0) {
         chunkILRBGFVD_cjs.logger.error(`Migration parse errors for ${orb.name}:`, {
@@ -4303,5 +4321,7 @@ var HoloScriptRuntime = class {
 
 exports.HoloScriptAgentRuntime = HoloScriptAgentRuntime;
 exports.HoloScriptRuntime = HoloScriptRuntime;
-//# sourceMappingURL=chunk-6DO5IZ5N.cjs.map
-//# sourceMappingURL=chunk-6DO5IZ5N.cjs.map
+exports.TRAIT_OWNER_KEY = TRAIT_OWNER_KEY;
+exports.registerPluginTraits = registerPluginTraits;
+//# sourceMappingURL=chunk-EDPYCLRC.cjs.map
+//# sourceMappingURL=chunk-EDPYCLRC.cjs.map