@holoscript/core 8.0.8 → 8.0.9

package/dist/{chunk-5WUNN6ZN.cjs → chunk-QHSAVOOL.cjs}

@@ -315,6 +315,28 @@ var SceneGraphGenerator = class {
     if (npc.npcType) node["hs:npcType"] = npc.npcType;
     if (npc.model) node["hs:model"] = npc.model;
     if (npc.dialogueTree) node["hs:dialogueTree"] = npc.dialogueTree;
+    if (npc.position) {
+      node["hs:locatedAt"] = {
+        "@type": "hs:Position",
+        "hs:x": npc.position.x,
+        "hs:y": npc.position.y,
+        "hs:z": npc.position.z
+      };
+    }
+    if (npc.brain) {
+      const brain = {
+        "@type": "hs:AgentBrain",
+        "hs:brainType": npc.brain.brainType
+      };
+      if (npc.brain.autonomy) brain["hs:autonomy"] = npc.brain.autonomy;
+      if (npc.brain.brainRef) brain["hs:brainRef"] = npc.brain.brainRef;
+      if (npc.brain.toolPermissions?.length) brain["hs:canInteractWith"] = npc.brain.toolPermissions;
+      if (npc.brain.model) {
+        brain["hs:model"] = { "hs:provider": npc.brain.model.provider, "hs:name": npc.brain.model.name };
+      }
+      node["hs:brain"] = brain;
+      node["hs:hasAgency"] = true;
+    }
     if (npc.properties?.length > 0) {
       const props = {};
       for (const prop of npc.properties) {
@@ -424,5 +446,5 @@ exports.SemanticSceneGraph = SemanticSceneGraph;
 exports.SemanticSceneGraph_default = SemanticSceneGraph_default;
 exports.generateSemanticSceneGraph = generateSemanticSceneGraph;
 exports.generateSemanticSceneGraphObject = generateSemanticSceneGraphObject;
-//# sourceMappingURL=chunk-5WUNN6ZN.cjs.map
-//# sourceMappingURL=chunk-5WUNN6ZN.cjs.map
+//# sourceMappingURL=chunk-QHSAVOOL.cjs.map
+//# sourceMappingURL=chunk-QHSAVOOL.cjs.map

package/dist/chunk-QJNCDVYM.cjs

@@ -0,0 +1,137 @@
+'use strict';
+
+// src/keyword-registry/PluginKeywordRegistry.ts
+var NODE_TYPE_FAMILIES = [
+  // ── Existing reaction categories (from ReactionCategory) ──────────────────
+  "movement",
+  // locomotion: move, turn, strafe, jump, land
+  "interaction",
+  // object interaction verbs
+  "collision",
+  // physics collision response
+  "lifecycle",
+  // attach, detach, spawn, destroy
+  "combat",
+  // combat/attack verbs
+  "signal",
+  // event emission verbs
+  // ── H2 additions ─────────────────────────────────────────────────────────
+  "cognitive",
+  // AI/LLM: llm_call, recall, rag_query, plan, reflect
+  "control",
+  // actuate, drive, set_joint, emit_gcode (ControlLoopTrait)
+  "sensor",
+  // measure, read, sample, measure_qubits (robotics/IoT/QM)
+  "transaction"
+  // pay, transfer, stake (x402 economic)
+];
+var PluginKeywordRegistry = class {
+  constructor() {
+    this.table = /* @__PURE__ */ new Map();
+    this._sealed = false;
+    this._registerBuiltins();
+  }
+  _registerBuiltins() {
+    for (const verb of ["move", "turn", "strafe", "jump", "land"]) {
+      this.table.set(verb, { verb, family: "movement", registeredBy: "core" });
+    }
+    for (const verb of ["llm_call", "recall", "rag_query", "plan", "reflect"]) {
+      this.table.set(verb, { verb, family: "cognitive", registeredBy: "core" });
+    }
+  }
+  /**
+   * Register a plugin-supplied verb.
+   *
+   * @param verb      The .hs verb (e.g., `'actuate'`, `'emit_gcode'`). Must be
+   *                  a non-empty string containing only `[a-z0-9_]`.
+   * @param family    Must be a known `NodeTypeFamily`. Conformance gate rejects
+   *                  anything outside the fixed set.
+   * @param pluginId  The registering plugin's manifest id (e.g., `'robotics'`).
+   *
+   * @throws If the registry is sealed, the family is unknown, or the verb is
+   *         already registered by a DIFFERENT plugin (idempotent for same plugin).
+   */
+  register(verb, family, pluginId) {
+    if (this._sealed) {
+      throw new Error(
+        `[PluginKeywordRegistry] Registry is sealed \u2014 cannot register verb "${verb}" after scene init.`
+      );
+    }
+    if (!verb || !/^[a-z][a-z0-9_]*$/.test(verb)) {
+      throw new Error(
+        `[PluginKeywordRegistry] Invalid verb "${verb}". Must match [a-z][a-z0-9_]*.`
+      );
+    }
+    if (!NODE_TYPE_FAMILIES.includes(family)) {
+      throw new Error(
+        `[PluginKeywordRegistry] Unknown node-type family "${family}". Must be one of: ${NODE_TYPE_FAMILIES.join(", ")}.`
+      );
+    }
+    const existing = this.table.get(verb);
+    if (existing) {
+      if (existing.registeredBy === pluginId) {
+        return;
+      }
+      throw new Error(
+        `[PluginKeywordRegistry] Verb "${verb}" is already registered by plugin "${existing.registeredBy}". Cannot be re-registered by "${pluginId}".`
+      );
+    }
+    this.table.set(verb, { verb, family, registeredBy: pluginId });
+  }
+  /**
+   * Seal the registry after scene init. All plugin verbs must be registered
+   * before this call. After sealing, `register()` throws.
+   *
+   * Idempotent — calling seal() on an already-sealed registry is a no-op.
+   */
+  seal() {
+    this._sealed = true;
+  }
+  /** Whether the registry has been sealed. */
+  get isSealed() {
+    return this._sealed;
+  }
+  /**
+   * Look up the `NodeTypeFamily` for a verb.
+   * Returns `undefined` for unregistered verbs.
+   */
+  lookupFamily(verb) {
+    return this.table.get(verb)?.family;
+  }
+  /** Returns `true` if the verb is registered (built-in or plugin-supplied). */
+  isKnownVerb(verb) {
+    return this.table.has(verb);
+  }
+  /**
+   * Return all registered `VerbEntry` objects — the flat machine-introspectable
+   * table. Safe for LSP / marketplace / Brittney to read without importing TS.
+   */
+  entries() {
+    return [...this.table.values()];
+  }
+  /** Return all registered verbs for a given family. */
+  verbsInFamily(family) {
+    return [...this.table.values()].filter((e) => e.family === family).map((e) => e.verb);
+  }
+  /** Total number of registered verbs. */
+  get size() {
+    return this.table.size;
+  }
+};
+var globalKeywordRegistry = new PluginKeywordRegistry();
+function registerPluginVerb(verb, family, pluginId) {
+  globalKeywordRegistry.register(verb, family, pluginId);
+}
+function registerPluginVerbs(pluginId, verbs) {
+  for (const { verb, family } of verbs) {
+    globalKeywordRegistry.register(verb, family, pluginId);
+  }
+}
+
+exports.NODE_TYPE_FAMILIES = NODE_TYPE_FAMILIES;
+exports.PluginKeywordRegistry = PluginKeywordRegistry;
+exports.globalKeywordRegistry = globalKeywordRegistry;
+exports.registerPluginVerb = registerPluginVerb;
+exports.registerPluginVerbs = registerPluginVerbs;
+//# sourceMappingURL=chunk-QJNCDVYM.cjs.map
+//# sourceMappingURL=chunk-QJNCDVYM.cjs.map