@holoscript/core 8.0.13 → 8.0.15

package/dist/{chunk-2KKOYZYI.cjs → chunk-FPGYWNNA.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunkCFVK26P4_cjs = require('./chunk-CFVK26P4.cjs');
-var chunkZK7KX5CD_cjs = require('./chunk-ZK7KX5CD.cjs');
+var chunkCMEINO5I_cjs = require('./chunk-CMEINO5I.cjs');
 var chunkAWXFEAQL_cjs = require('./chunk-AWXFEAQL.cjs');
 var chunkN74QRJGP_cjs = require('./chunk-N74QRJGP.cjs');
 var chunkZHPMP447_cjs = require('./chunk-ZHPMP447.cjs');
@@ -2305,13 +2305,13 @@ function compileToAndroid(composition, options) {
 exports.AndroidCompiler = void 0;
 var init_AndroidCompiler = chunkZHPMP447_cjs.__esm({
   "src/compiler/AndroidCompiler.ts"() {
-    chunkZK7KX5CD_cjs.init_CompilerBase();
+    chunkCMEINO5I_cjs.init_CompilerBase();
     init_AndroidARGenerators();
     init_AndroidFeatureGenerators();
     init_AndroidSceneViewFeatureGenerators();
     init_AndroidPeripheralGenerators();
     chunkCFVK26P4_cjs.init_AndroidKotlinHelpers();
-    exports.AndroidCompiler = class extends chunkZK7KX5CD_cjs.CompilerBase {
+    exports.AndroidCompiler = class extends chunkCMEINO5I_cjs.CompilerBase {
       constructor(options = {}) {
         super();
         this.compilerName = "AndroidCompiler";
@@ -2465,5 +2465,5 @@ var init_AndroidCompiler = chunkZHPMP447_cjs.__esm({
 exports.AndroidCompiler_exports = AndroidCompiler_exports;
 exports.compileToAndroid = compileToAndroid;
 exports.init_AndroidCompiler = init_AndroidCompiler;
-//# sourceMappingURL=chunk-2KKOYZYI.cjs.map
-//# sourceMappingURL=chunk-2KKOYZYI.cjs.map
+//# sourceMappingURL=chunk-FPGYWNNA.cjs.map
+//# sourceMappingURL=chunk-FPGYWNNA.cjs.map

package/dist/{chunk-65S62L4D.cjs → chunk-FQ4MYZYU.cjs}

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunkQEDMOGF3_cjs = require('./chunk-QEDMOGF3.cjs');
-var chunkZK7KX5CD_cjs = require('./chunk-ZK7KX5CD.cjs');
+var chunkIYK6LMQ7_cjs = require('./chunk-IYK6LMQ7.cjs');
+var chunkCMEINO5I_cjs = require('./chunk-CMEINO5I.cjs');
 var ans = require('@holoscript/core-types/ans');
 
 // src/compiler/USDPhysicsCompiler.ts
-chunkZK7KX5CD_cjs.init_CompilerBase();
-chunkQEDMOGF3_cjs.init_DomainBlockCompilerMixin();
-var USDPhysicsCompiler = class extends chunkZK7KX5CD_cjs.CompilerBase {
+chunkCMEINO5I_cjs.init_CompilerBase();
+chunkIYK6LMQ7_cjs.init_DomainBlockCompilerMixin();
+var USDPhysicsCompiler = class extends chunkCMEINO5I_cjs.CompilerBase {
   constructor(options = {}) {
     super();
     this.compilerName = "USDPhysicsCompiler";
@@ -264,34 +264,34 @@ var USDPhysicsCompiler = class extends chunkZK7KX5CD_cjs.CompilerBase {
     if (domainBlocks.length > 0) {
       this.emitBlank();
       this.emit(`# === v4.2 Domain Blocks ===`);
-      const compiled = chunkQEDMOGF3_cjs.compileDomainBlocks(
+      const compiled = chunkIYK6LMQ7_cjs.compileDomainBlocks(
         domainBlocks,
         {
           material: (block) => {
-            const mat = chunkQEDMOGF3_cjs.compileMaterialBlock(block);
-            return chunkQEDMOGF3_cjs.materialToUSD(mat);
+            const mat = chunkIYK6LMQ7_cjs.compileMaterialBlock(block);
+            return chunkIYK6LMQ7_cjs.materialToUSD(mat);
           },
           physics: (block) => {
-            const phys = chunkQEDMOGF3_cjs.compilePhysicsBlock(block);
-            const urdf = chunkQEDMOGF3_cjs.physicsToURDF(phys);
+            const phys = chunkIYK6LMQ7_cjs.compilePhysicsBlock(block);
+            const urdf = chunkIYK6LMQ7_cjs.physicsToURDF(phys);
             return `# Physics: ${phys.keyword} "${phys.name || ""}"
 ` + urdf.split("\n").map((l) => `# URDF: ${l}`).join("\n");
           },
           vfx: (block) => {
-            const ps = chunkQEDMOGF3_cjs.compileParticleBlock(block);
-            return chunkQEDMOGF3_cjs.particlesToUSD(ps);
+            const ps = chunkIYK6LMQ7_cjs.compileParticleBlock(block);
+            return chunkIYK6LMQ7_cjs.particlesToUSD(ps);
           },
           postfx: (block) => {
-            const pp = chunkQEDMOGF3_cjs.compilePostProcessingBlock(block);
-            return chunkQEDMOGF3_cjs.postProcessingToUSD(pp);
+            const pp = chunkIYK6LMQ7_cjs.compilePostProcessingBlock(block);
+            return chunkIYK6LMQ7_cjs.postProcessingToUSD(pp);
           },
           audio: (block) => {
-            const audio = chunkQEDMOGF3_cjs.compileAudioSourceBlock(block);
-            return chunkQEDMOGF3_cjs.audioSourceToUSD(audio);
+            const audio = chunkIYK6LMQ7_cjs.compileAudioSourceBlock(block);
+            return chunkIYK6LMQ7_cjs.audioSourceToUSD(audio);
           },
           weather: (block) => {
-            const weather = chunkQEDMOGF3_cjs.compileWeatherBlock(block);
-            return chunkQEDMOGF3_cjs.weatherToUSD(weather);
+            const weather = chunkIYK6LMQ7_cjs.compileWeatherBlock(block);
+            return chunkIYK6LMQ7_cjs.weatherToUSD(weather);
           }
         },
         (block) => `# Domain block: ${block.domain}/${block.keyword} "${this.escapeStringValue(block.name, "TypeScript")}"`
@@ -890,5 +890,5 @@ function compileForIsaacSim(composition, options) {
 exports.USDPhysicsCompiler = USDPhysicsCompiler;
 exports.compileForIsaacSim = compileForIsaacSim;
 exports.compileToUSDPhysics = compileToUSDPhysics;
-//# sourceMappingURL=chunk-65S62L4D.cjs.map
-//# sourceMappingURL=chunk-65S62L4D.cjs.map
+//# sourceMappingURL=chunk-FQ4MYZYU.cjs.map
+//# sourceMappingURL=chunk-FQ4MYZYU.cjs.map

package/dist/{chunk-UGQ3QNV6.js → chunk-FT4FGTR6.js}

@@ -1,4 +1,4 @@
-import { init_CompilerBase, CompilerBase } from './chunk-DUG3OQAS.js';
+import { init_CompilerBase, CompilerBase } from './chunk-QC3CAVFN.js';
 import { __export, __esm } from './chunk-W4GABFCR.js';
 import { ANSCapabilityPath } from '@holoscript/core-types/ans';
 
@@ -99,7 +99,7 @@ var init_AgentInferenceExportTarget = __esm({
         if (allTools.length > 0) {
           output[`tools.${ext}`] = this.emitToolDefinitions(allTools);
         }
-        output["config.json"] = this.emitConfigJson();
+        output["config.json"] = this.emitConfigJson(composition.name);
         if (this.options.language === "typescript") {
           output["package.json"] = this.emitPackageJson(composition.name);
           if (this.options.includeTypes) {
@@ -319,12 +319,14 @@ var init_AgentInferenceExportTarget = __esm({
             }
           }
         }
+        const target = this.extractStringValue(trait.config["target"]);
         return {
           name,
           description,
           parameters,
           returnType: this.extractStringValue(trait.config["returns"]) ?? "string",
-          source: "trait"
+          source: "trait",
+          ...target ? { target } : {}
         };
       }
       parseBehaviorAsTool(behavior) {
@@ -798,7 +800,7 @@ var init_AgentInferenceExportTarget = __esm({
         return lines.join("\n");
       }
       // ─── Config & Package Files ─────────────────────────────────────────
-      emitConfigJson() {
+      emitConfigJson(compositionName) {
         const configs = this.agents.map((a) => ({
           name: a.name,
           role: a.role,
@@ -811,9 +813,23 @@ var init_AgentInferenceExportTarget = __esm({
             top_k: a.modelConfig.topK
           },
           system_prompt: a.modelConfig.systemPrompt,
-          tools: a.tools.map((t) => t.name)
+          tools: a.tools.map((t) => t.name),
+          // Structured facts an independent consumer can re-derive without parsing
+          // generated code: full tool descriptors (incl. the optional world-model
+          // `target` binding) and the agent's state fields. `tools` stays a name
+          // array for backward compatibility.
+          tool_details: a.tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            ...t.target ? { target: t.target } : {}
+          })),
+          state: a.stateProperties.map((s) => ({
+            key: s.key,
+            type: s.type,
+            default: s.defaultValue
+          }))
         }));
-        return JSON.stringify({ agents: configs }, null, 2);
+        return JSON.stringify({ source: compositionName, agents: configs }, null, 2);
       }
       emitPackageJson(compositionName) {
         const pkg = {
@@ -988,5 +1004,5 @@ export interface ToolResult {
 });
 
 export { AgentInferenceCompiler, AgentInferenceExportTarget_default, AgentInferenceExportTarget_exports, createAgentInferenceCompiler, createPythonAgentInferenceCompiler, init_AgentInferenceExportTarget };
-//# sourceMappingURL=chunk-UGQ3QNV6.js.map
-//# sourceMappingURL=chunk-UGQ3QNV6.js.map
+//# sourceMappingURL=chunk-FT4FGTR6.js.map
+//# sourceMappingURL=chunk-FT4FGTR6.js.map

package/dist/{chunk-Q4K2GEMW.cjs → chunk-FVNV4WHQ.cjs}

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkOIBRWLPY_cjs = require('./chunk-OIBRWLPY.cjs');
+var chunkILO2KMER_cjs = require('./chunk-ILO2KMER.cjs');
 var chunkYP5CHEYU_cjs = require('./chunk-YP5CHEYU.cjs');
-var chunkLHUDAJQT_cjs = require('./chunk-LHUDAJQT.cjs');
-var chunkEI3J6LTW_cjs = require('./chunk-EI3J6LTW.cjs');
+var chunk2PVEXEOL_cjs = require('./chunk-2PVEXEOL.cjs');
+var chunk6RDHWSZM_cjs = require('./chunk-6RDHWSZM.cjs');
 var chunkNTQRFOPP_cjs = require('./chunk-NTQRFOPP.cjs');
 var crypto = require('crypto');
 
@@ -1010,7 +1010,7 @@ function similarity(a, b) {
 function findSimilarTrait(input, threshold = 0.5) {
   let bestMatch;
   let bestScore = threshold;
-  for (const trait of chunkEI3J6LTW_cjs.VR_TRAITS) {
+  for (const trait of chunk6RDHWSZM_cjs.VR_TRAITS) {
     const score = similarity(input, trait);
     if (score > bestScore) {
       bestScore = score;
@@ -1822,7 +1822,7 @@ var HoloScriptPlusParser = class _HoloScriptPlusParser {
     this.hasVRTraits = false;
     this.hasControlFlow = false;
     this.compiledExpressions = /* @__PURE__ */ new Map();
-    this.errorRecovery = new chunkOIBRWLPY_cjs.ErrorRecovery();
+    this.errorRecovery = new chunkILO2KMER_cjs.ErrorRecovery();
     /**
      * Internal incremental parser for parseIncremental.
      * Uses ChunkBasedIncrementalParser with AST-aware chunking and
@@ -1848,7 +1848,7 @@ var HoloScriptPlusParser = class _HoloScriptPlusParser {
   getQuickFixes() {
     const fixes = /* @__PURE__ */ new Map();
     for (const error of this.errors) {
-      const errorFixes = chunkOIBRWLPY_cjs.generateQuickFixes(
+      const errorFixes = chunkILO2KMER_cjs.generateQuickFixes(
         {
           code: error.code,
           message: error.message,
@@ -1869,7 +1869,7 @@ var HoloScriptPlusParser = class _HoloScriptPlusParser {
    */
   getEnrichedErrors() {
     return this.errors.map(
-      (error) => chunkOIBRWLPY_cjs.enrichErrorWithSuggestions(
+      (error) => chunkILO2KMER_cjs.enrichErrorWithSuggestions(
         {
           code: error.code,
           message: error.message,
@@ -2939,7 +2939,7 @@ var HoloScriptPlusParser = class _HoloScriptPlusParser {
       }
       return { type: "waypoints", points };
     }
-    if (chunkEI3J6LTW_cjs.VR_TRAITS.includes(name)) {
+    if (chunk6RDHWSZM_cjs.VR_TRAITS.includes(name)) {
       if (!this.options.enableVRTraits) {
         this.warn(`VR trait @${name} is disabled`);
         return null;
@@ -2969,7 +2969,7 @@ var HoloScriptPlusParser = class _HoloScriptPlusParser {
       }
       return this.parseTraitSumTail(directive2);
     }
-    if (chunkLHUDAJQT_cjs.LIFECYCLE_HOOKS.includes(name)) {
+    if (chunk2PVEXEOL_cjs.LIFECYCLE_HOOKS.includes(name)) {
       const params = [];
       if (this.check("LPAREN")) {
         this.advance();
@@ -3285,7 +3285,7 @@ var HoloScriptPlusParser = class _HoloScriptPlusParser {
         return { type: "hololand_event", event: eventName, params };
       }
     }
-    if (chunkLHUDAJQT_cjs.STRUCTURAL_DIRECTIVES.includes(name)) {
+    if (chunk2PVEXEOL_cjs.STRUCTURAL_DIRECTIVES.includes(name)) {
       let nodeName;
       if (this.check("STRING")) {
         nodeName = this.advance().value;
@@ -3293,10 +3293,13 @@ var HoloScriptPlusParser = class _HoloScriptPlusParser {
       const config2 = this.check("LBRACE") ? this.parseBlockContent() : this.parseTraitConfig();
       return { ...config2, type: name, name: nodeName };
     }
-    if (this.options.strict) {
-      this.traitError(name);
-    } else {
-      this.warn(`Unknown directive @${name}`);
+    const isKnownRuntimeDirective = chunkILO2KMER_cjs.RUNTIME_DIRECTIVE_TRAITS.includes(name);
+    if (!isKnownRuntimeDirective) {
+      if (this.options.strict) {
+        this.traitError(name);
+      } else {
+        this.warn(`Unknown directive @${name}`);
+      }
     }
     let config = {};
     let configStyle = "none";
@@ -6063,7 +6066,7 @@ var HoloScriptPlusParser = class _HoloScriptPlusParser {
         code: "HSP001"
       };
     }
-    if (current.type === "IDENTIFIER" && chunkEI3J6LTW_cjs.VR_TRAITS.includes(current.value)) {
+    if (current.type === "IDENTIFIER" && chunk6RDHWSZM_cjs.VR_TRAITS.includes(current.value)) {
       if (prev?.type !== "AT") {
         return {
           message: `'${current.value}' is a trait and requires '@' prefix`,
@@ -6289,5 +6292,5 @@ exports.getSourceContext = getSourceContext;
 exports.globalParseCache = globalParseCache;
 exports.parse = parse;
 exports.parseIncrementalChunks = parseIncrementalChunks;
-//# sourceMappingURL=chunk-Q4K2GEMW.cjs.map
-//# sourceMappingURL=chunk-Q4K2GEMW.cjs.map
+//# sourceMappingURL=chunk-FVNV4WHQ.cjs.map
+//# sourceMappingURL=chunk-FVNV4WHQ.cjs.map

package/dist/{chunk-SJIRCTIS.cjs → chunk-HSGJFCVJ.cjs}

@@ -783,5 +783,5 @@ exports.jepObjectiveHandler = jepObjectiveHandler;
 exports.mitosisHandler = mitosisHandler;
 exports.orbitalHandler = orbitalHandler;
 exports.setSharedEventBus = setSharedEventBus;
-//# sourceMappingURL=chunk-SJIRCTIS.cjs.map
-//# sourceMappingURL=chunk-SJIRCTIS.cjs.map
+//# sourceMappingURL=chunk-HSGJFCVJ.cjs.map
+//# sourceMappingURL=chunk-HSGJFCVJ.cjs.map

package/dist/{chunk-B3CWTCK2.js → chunk-IA7FCSRY.js}

@@ -118,6 +118,31 @@ var TRAIT_DOCS;
 var init_traitDocs = __esm({
   "src/traitDocs/traitDocs.ts"() {
     TRAIT_DOCS = {
+      // ============================================================================
+      // Governance Traits
+      // ============================================================================
+      freeze_when: {
+        name: "FreezeWhenTrait",
+        annotation: "@freeze_when",
+        description: 'Declares a self-controlling Freeze RULE: gate `scope` WHEN `signal` trips, and auto-lift the moment it clears. The freeze is DERIVED from a live signal, never a stored "FROZEN" flag, so it cannot go stale. Native/fix/infra work is always exempt. Projected to a freeze-registry.json rule that a controller evaluates on a cadence.',
+        category: "utility",
+        properties: [
+          { name: "id", type: "string", description: "Stable rule id \u2014 the registry key.", required: true },
+          { name: "scope", type: "string", description: 'The change-class this freeze gates (e.g. "new-feature-work").', required: true },
+          { name: "signal", type: "string", description: 'Live trigger: "required-gate:red" (a gate command fails) or "surface-absent:<path>" (a consume surface is missing).', required: true },
+          { name: "unfreeze", type: "string", description: "Human-readable lift condition; the derived state auto-lifts when the signal clears.", required: true },
+          { name: "exempt", type: "string[]", description: "Labels always allowed even under this freeze \u2014 the native-first guarantee.", default: '["fix", "native-format", "infra-repair"]' },
+          { name: "severity", type: '"advisory" | "blocking"', description: "advisory surfaces the freeze; blocking gates the scope.", default: '"advisory"' },
+          { name: "reason", type: "string", description: "Why the freeze exists (shown only while active).", default: '""' },
+          { name: "repair", type: "string", description: "Optional self-heal repair routed while the freeze is active.", default: '""' }
+        ],
+        methods: [],
+        events: [
+          { name: "freeze_declared", description: "Emitted onAttach with the derived rule.", payload: "{ rule, derived: true, nativeExempt: true }" }
+        ],
+        example: '@freeze_when(id: "features-on-red-gate", scope: "new-feature-work", signal: "required-gate:red", unfreeze: "gate passes")',
+        since: "6.0"
+      },
       // ============================================================================
       // Physics Traits
       // ============================================================================
@@ -2309,5 +2334,5 @@ orb rune_loom_tapestry {
 });
 
 export { TRAIT_DOCS, formatTraitDocAsMarkdown, formatTraitDocCompact, getAllTraitNames, getTraitDoc, getTraitsByCategory, init_traitDocs };
-//# sourceMappingURL=chunk-B3CWTCK2.js.map
-//# sourceMappingURL=chunk-B3CWTCK2.js.map
+//# sourceMappingURL=chunk-IA7FCSRY.js.map
+//# sourceMappingURL=chunk-IA7FCSRY.js.map

package/dist/{chunk-OIBRWLPY.cjs → chunk-ILO2KMER.cjs}

@@ -1,6 +1,53 @@
 'use strict';
 
-var chunkEI3J6LTW_cjs = require('./chunk-EI3J6LTW.cjs');
+var chunk6RDHWSZM_cjs = require('./chunk-6RDHWSZM.cjs');
+
+// src/traits/knownTraitSet.ts
+var NATIVE2D_TRAITS = [
+  "text",
+  "fetch",
+  "bind",
+  "hook",
+  "theme",
+  "panel",
+  "slot",
+  "link",
+  "button",
+  "image",
+  "input",
+  "icon",
+  "when",
+  "each",
+  "count_of",
+  "form",
+  "semantic_layout",
+  "semantic_entity",
+  "color",
+  "content",
+  "layout",
+  "native_panel",
+  "view",
+  "page",
+  "route",
+  "metadata"
+];
+var CODE_GRAPH_TRAITS = ["route", "file", "reused_in", "uses_stores", "calls_apis"];
+var RUNTIME_DIRECTIVE_TRAITS = [
+  "llama_serve",
+  "model_fleet",
+  "provider_policy",
+  "freeze_when",
+  "evolve_program"
+];
+function buildKnownTraitSet(extras = []) {
+  return /* @__PURE__ */ new Set([
+    ...chunk6RDHWSZM_cjs.VR_TRAITS,
+    ...NATIVE2D_TRAITS,
+    ...CODE_GRAPH_TRAITS,
+    ...RUNTIME_DIRECTIVE_TRAITS,
+    ...extras.flat()
+  ]);
+}
 
 // src/parser/ErrorRecovery.ts
 var VALID_KEYWORDS = [
@@ -49,7 +96,7 @@ var VALID_GEOMETRIES = [
   "particles"
 ];
 function validTraits() {
-  return [...chunkEI3J6LTW_cjs.VR_TRAITS];
+  return [...buildKnownTraitSet()];
 }
 var COMMON_PROPERTIES = [
   "position",
@@ -525,11 +572,15 @@ var HOLOSCHEMA_KEYWORDS = VALID_KEYWORDS;
 var HOLOSCHEMA_GEOMETRIES = VALID_GEOMETRIES;
 var HOLOSCHEMA_PROPERTIES = COMMON_PROPERTIES;
 
+exports.CODE_GRAPH_TRAITS = CODE_GRAPH_TRAITS;
 exports.ErrorRecovery = ErrorRecovery;
 exports.HOLOSCHEMA_GEOMETRIES = HOLOSCHEMA_GEOMETRIES;
 exports.HOLOSCHEMA_KEYWORDS = HOLOSCHEMA_KEYWORDS;
 exports.HOLOSCHEMA_PROPERTIES = HOLOSCHEMA_PROPERTIES;
+exports.NATIVE2D_TRAITS = NATIVE2D_TRAITS;
+exports.RUNTIME_DIRECTIVE_TRAITS = RUNTIME_DIRECTIVE_TRAITS;
+exports.buildKnownTraitSet = buildKnownTraitSet;
 exports.enrichErrorWithSuggestions = enrichErrorWithSuggestions;
 exports.generateQuickFixes = generateQuickFixes;
-//# sourceMappingURL=chunk-OIBRWLPY.cjs.map
-//# sourceMappingURL=chunk-OIBRWLPY.cjs.map
+//# sourceMappingURL=chunk-ILO2KMER.cjs.map
+//# sourceMappingURL=chunk-ILO2KMER.cjs.map