@holoscript/core 7.0.0 → 8.0.0

package/dist/world/index.cjs

@@ -0,0 +1,947 @@
+'use strict';
+
+require('../chunk-HCCQLAA4.cjs');
+
+// src/world/WorldGeneratorAdapter.ts
+var WorldAdapterRegistry = class {
+  constructor() {
+    this.adapters = /* @__PURE__ */ new Map();
+  }
+  register(adapter) {
+    this.adapters.set(adapter.id, adapter);
+  }
+  get(engineId) {
+    const adapter = this.adapters.get(engineId);
+    if (!adapter) {
+      throw new Error(
+        `[WorldAdapterRegistry] No adapter registered for engine '${engineId}'. Registered: ${[...this.adapters.keys()].join(", ") || "(none)"}`
+      );
+    }
+    return adapter;
+  }
+  has(engineId) {
+    return this.adapters.has(engineId);
+  }
+  list() {
+    return [...this.adapters.keys()];
+  }
+};
+var worldAdapterRegistry = new WorldAdapterRegistry();
+
+// src/world/adapters/SovereignWorldAdapter.ts
+var QUALITY_MAP = {
+  low: "draft",
+  medium: "standard",
+  high: "high",
+  ultra: "ultra"
+};
+var FORMAT_MAP = {
+  "3dgs": "splat",
+  mesh: "mesh",
+  both: "both",
+  neural_field: "neural_field"
+};
+var DEFAULT_BASE_URL = typeof process !== "undefined" && process.env.HOLOSCRIPT_SOVEREIGN_BASE_URL || "https://api.holoscript.net/sovereign";
+var DEFAULT_API_KEY = typeof process !== "undefined" && process.env.HOLOSCRIPT_SOVEREIGN_API_KEY || "";
+var DEFAULT_TIMEOUT_MS = typeof process !== "undefined" && process.env.HOLOSCRIPT_SOVEREIGN_TIMEOUT_MS ? parseInt(process.env.HOLOSCRIPT_SOVEREIGN_TIMEOUT_MS, 10) : 3e5;
+var SovereignWorldAdapter = class {
+  constructor(options = {}) {
+    this.id = "sovereign-3d";
+    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.apiKey = options.apiKey ?? DEFAULT_API_KEY;
+    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.pollIntervalMs = options.pollIntervalMs ?? 2e3;
+  }
+  // ---------------------------------------------------------------------------
+  // PUBLIC API
+  // ---------------------------------------------------------------------------
+  async generate(req) {
+    const jobId = await this.submitJob(req);
+    return this.waitForCompletion(jobId);
+  }
+  async getProgress(generationId) {
+    const job = await this.fetchJob(generationId);
+    return job.progress ?? (job.status === "done" ? 1 : 0);
+  }
+  async cancel(generationId) {
+    await this.request(`/api/jobs/${generationId}/cancel`, { method: "POST" });
+  }
+  // ---------------------------------------------------------------------------
+  // PRIVATE HELPERS
+  // ---------------------------------------------------------------------------
+  async submitJob(req) {
+    const inputImages = req.input_images?.join(",") ?? req.input_image;
+    const payload = {
+      prompt: req.prompt,
+      output_format: FORMAT_MAP[req.format] ?? "splat",
+      quality_preset: QUALITY_MAP[req.quality] ?? "standard",
+      ...inputImages ? { input_images: inputImages } : {},
+      ...req.seed !== void 0 ? { seed: req.seed } : {},
+      ...req.navEnabled !== void 0 ? { nav_enabled: req.navEnabled } : {},
+      ...req.interactiveMode !== void 0 ? { interactive_mode: req.interactiveMode } : {}
+    };
+    const response = await this.request("/api/generate", {
+      method: "POST",
+      body: JSON.stringify(payload)
+    });
+    if (!response.job_id) {
+      throw new Error("[SovereignWorldAdapter] /api/generate did not return a job_id");
+    }
+    return response.job_id;
+  }
+  async waitForCompletion(jobId) {
+    const deadline = Date.now() + this.timeoutMs;
+    while (Date.now() < deadline) {
+      const job = await this.fetchJob(jobId);
+      if (job.status === "done") {
+        return this.mapResult(job);
+      }
+      if (job.status === "error") {
+        throw new Error(
+          `[SovereignWorldAdapter] Job ${jobId} failed: ${job.error ?? "unknown error"}`
+        );
+      }
+      await this.sleep(this.pollIntervalMs);
+    }
+    throw new Error(
+      `[SovereignWorldAdapter] Job ${jobId} timed out after ${this.timeoutMs}ms`
+    );
+  }
+  async fetchJob(jobId) {
+    return this.request(`/api/jobs/${jobId}`);
+  }
+  mapResult(job) {
+    if (!job.asset_url) {
+      throw new Error(
+        `[SovereignWorldAdapter] Job ${job.job_id} completed but returned no asset_url`
+      );
+    }
+    const rawMeta = job.metadata ?? {};
+    const bounds = rawMeta.bounds ?? [-10, 0, -10, 10, 5, 10];
+    const metadata = {
+      format: job.asset_url.endsWith(".glb") ? "mesh" : "3dgs",
+      bounds,
+      ...rawMeta.agent_start ? { agentStart: rawMeta.agent_start } : {},
+      ...rawMeta.waypoints ? { waypoints: rawMeta.waypoints } : {},
+      ...rawMeta.splat_count ? { splatCount: rawMeta.splat_count } : {},
+      ...rawMeta.triangle_count ? { triangleCount: rawMeta.triangle_count } : {},
+      ...rawMeta.generation_ms ? { generationMs: rawMeta.generation_ms } : {}
+    };
+    return {
+      generationId: job.job_id,
+      assetUrl: job.asset_url,
+      ...job.navmesh_url ? { navmeshUrl: job.navmesh_url } : {},
+      ...job.point_cloud_url ? { pointCloudUrl: job.point_cloud_url } : {},
+      metadata
+    };
+  }
+  async request(path, init = {}) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json",
+      ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}
+    };
+    const res = await fetch(url, { ...init, headers: { ...headers, ...init.headers ?? {} } });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(
+        `[SovereignWorldAdapter] HTTP ${res.status} at ${path}${text ? ": " + text : ""}`
+      );
+    }
+    return res.json();
+  }
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+// src/world/adapters/Sovereign3DAdapter.ts
+var QUALITY_MAP2 = {
+  low: "draft",
+  medium: "standard",
+  high: "high",
+  ultra: "ultra"
+};
+var FORMAT_MAP2 = {
+  "3dgs": "splat",
+  mesh: "mesh",
+  both: "both",
+  neural_field: "neural_field"
+};
+var DEFAULT_BASE_URL2 = typeof process !== "undefined" && process.env.HOLOSCRIPT_SOVEREIGN_BASE_URL || "https://api.holoscript.net/sovereign";
+var DEFAULT_API_KEY2 = typeof process !== "undefined" && process.env.HOLOSCRIPT_SOVEREIGN_API_KEY || "";
+var DEFAULT_TIMEOUT_MS2 = typeof process !== "undefined" && process.env.HOLOSCRIPT_SOVEREIGN_TIMEOUT_MS ? parseInt(process.env.HOLOSCRIPT_SOVEREIGN_TIMEOUT_MS, 10) : 3e5;
+var Sovereign3DAdapter = class {
+  constructor(options = {}) {
+    this.id = "sovereign-3d";
+    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL2).replace(/\/$/, "");
+    this.apiKey = options.apiKey ?? DEFAULT_API_KEY2;
+    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS2;
+    this.pollIntervalMs = options.pollIntervalMs ?? 2e3;
+    this.mockMode = Boolean(options.mockMode);
+    this.mockLatencyMs = Math.max(0, options.mockLatencyMs ?? 10);
+  }
+  // ---------------------------------------------------------------------------
+  // PUBLIC API
+  // ---------------------------------------------------------------------------
+  async generate(req) {
+    if (this.mockMode) {
+      await this.sleep(this.mockLatencyMs);
+      return this.mockResult(req);
+    }
+    const jobId = await this.submitJob(req);
+    return this.waitForCompletion(jobId);
+  }
+  async getProgress(generationId) {
+    if (this.mockMode || generationId.startsWith("mock_")) {
+      return 1;
+    }
+    const job = await this.fetchJob(generationId);
+    return job.progress ?? (job.status === "done" ? 1 : 0);
+  }
+  async cancel(generationId) {
+    if (this.mockMode || generationId.startsWith("mock_")) return;
+    await this.request(`/api/jobs/${generationId}/cancel`, { method: "POST" });
+  }
+  // ---------------------------------------------------------------------------
+  // PRIVATE HELPERS
+  // ---------------------------------------------------------------------------
+  async submitJob(req) {
+    const inputImages = req.input_images?.join(",") ?? req.input_image;
+    const payload = {
+      prompt: req.prompt,
+      output_format: FORMAT_MAP2[req.format] ?? "splat",
+      quality_preset: QUALITY_MAP2[req.quality] ?? "standard",
+      ...inputImages ? { input_images: inputImages } : {},
+      ...req.seed !== void 0 ? { seed: req.seed } : {},
+      ...req.navEnabled !== void 0 ? { nav_enabled: req.navEnabled } : {},
+      ...req.interactiveMode !== void 0 ? { interactive_mode: req.interactiveMode } : {}
+    };
+    const response = await this.request("/api/generate", {
+      method: "POST",
+      body: JSON.stringify(payload)
+    });
+    if (!response.job_id) {
+      throw new Error("[Sovereign3DAdapter] /api/generate did not return a job_id");
+    }
+    return response.job_id;
+  }
+  async waitForCompletion(jobId) {
+    const deadline = Date.now() + this.timeoutMs;
+    while (Date.now() < deadline) {
+      const job = await this.fetchJob(jobId);
+      if (job.status === "done") {
+        return this.mapResult(job);
+      }
+      if (job.status === "error") {
+        throw new Error(
+          `[Sovereign3DAdapter] Job ${jobId} failed: ${job.error ?? "unknown error"}`
+        );
+      }
+      await this.sleep(this.pollIntervalMs);
+    }
+    throw new Error(
+      `[Sovereign3DAdapter] Job ${jobId} timed out after ${this.timeoutMs}ms`
+    );
+  }
+  async fetchJob(jobId) {
+    return this.request(`/api/jobs/${jobId}`);
+  }
+  mapResult(job) {
+    if (!job.asset_url) {
+      throw new Error(
+        `[Sovereign3DAdapter] Job ${job.job_id} completed but returned no asset_url`
+      );
+    }
+    const rawMeta = job.metadata ?? {};
+    const bounds = rawMeta.bounds ?? [-10, 0, -10, 10, 5, 10];
+    const metadata = {
+      format: job.asset_url.endsWith(".glb") ? "mesh" : job.asset_url.includes("neural") ? "neural_field" : "3dgs",
+      bounds,
+      ...rawMeta.agent_start ? { agentStart: rawMeta.agent_start } : {},
+      ...rawMeta.waypoints ? { waypoints: rawMeta.waypoints } : {},
+      ...rawMeta.splat_count ? { splatCount: rawMeta.splat_count } : {},
+      ...rawMeta.triangle_count ? { triangleCount: rawMeta.triangle_count } : {},
+      ...rawMeta.generation_ms ? { generationMs: rawMeta.generation_ms } : {}
+    };
+    return {
+      generationId: job.job_id,
+      assetUrl: job.asset_url,
+      ...job.navmesh_url ? { navmeshUrl: job.navmesh_url } : {},
+      ...job.point_cloud_url ? { pointCloudUrl: job.point_cloud_url } : {},
+      metadata
+    };
+  }
+  async request(path, init = {}) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json",
+      ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}
+    };
+    const res = await fetch(url, { ...init, headers: { ...headers, ...init.headers ?? {} } });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(
+        `[Sovereign3DAdapter] HTTP ${res.status} at ${path}${text ? ": " + text : ""}`
+      );
+    }
+    return res.json();
+  }
+  mockResult(req) {
+    const generationId = `mock_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+    const basePath = `${this.baseUrl}/mock/${generationId}`;
+    const metadata = {
+      format: req.format,
+      bounds: [-20, 0, -20, 20, 12, 20],
+      agentStart: [0, 0, 0],
+      waypoints: [
+        [0, 0, 0],
+        [5, 0, 5],
+        [10, 0, 0]
+      ],
+      splatCount: req.format === "mesh" ? void 0 : 25e4,
+      triangleCount: req.format === "3dgs" ? void 0 : 12e4,
+      generationMs: this.mockLatencyMs
+    };
+    const assetUrl = req.format === "mesh" ? `${basePath}/world.glb` : req.format === "neural_field" ? `${basePath}/world.neural` : `${basePath}/world.splat`;
+    return {
+      generationId,
+      assetUrl,
+      ...req.navEnabled ? { navmeshUrl: `${basePath}/navmesh.glb` } : {},
+      ...req.format === "both" ? { pointCloudUrl: `${basePath}/world.ply` } : {},
+      metadata
+    };
+  }
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+// src/world/adapters/SovereignGeneratorAdapter.ts
+var DEFAULT_LOCAL_ENDPOINT = typeof process !== "undefined" && process.env.BRITTNEY_LOCAL_ENDPOINT || typeof process !== "undefined" && process.env.OLLAMA_HOST || "http://localhost:11434";
+var DEFAULT_LOCAL_MODEL = typeof process !== "undefined" && process.env.BRITTNEY_MODEL || "brittney-qwen-v23:latest";
+var DEFAULT_CLOUD_ENDPOINT = typeof process !== "undefined" && process.env.BRITTNEY_SERVICE_URL || "";
+var DEFAULT_CLOUD_API_KEY = typeof process !== "undefined" && process.env.BRITTNEY_API_KEY || "";
+var DEFAULT_CLOUD_MODEL = "brittney-standard";
+var DEFAULT_MAX_TOKENS = 4096;
+var DEFAULT_TIMEOUT_MS3 = 12e4;
+var SOVEREIGN_GENERATE_SYSTEM_PROMPT = `You are a HoloScript code generator running locally (sovereign, no cloud).
+Output ONLY valid HoloScript code, no markdown, no explanation.
+
+HoloScript syntax:
+  object "Name" {
+    geometry: "cube" | "sphere" | "cylinder" | "plane" | "cone"
+    position: [x, y, z]
+    rotation: [x, y, z]
+    scale: [x, y, z] | number
+    @color(red) @emissive(cyan) @grabbable @physics @collidable
+    @clickable @hoverable @networked @persistent @animated
+  }
+
+  composition "SceneName" {
+    environment {
+      skybox: "default"
+      ambient_light: 0.5
+    }
+    object "Obj1" { ... }
+  }
+
+Traits available: @grabbable, @throwable, @clickable, @hoverable, @draggable,
+@scalable, @physics, @collidable, @gravity, @glowing, @emissive, @transparent,
+@reflective, @animated, @billboard, @networked, @synced, @persistent, @owned,
+@host_only, @stackable, @attachable, @equippable, @consumable, @destructible,
+@anchor, @tracked, @world_locked, @hand_tracked, @eye_tracked, @spatial_audio,
+@ambient, @voice_activated, @state, @reactive, @observable, @computed,
+@shareable, @collaborative, @trigger, @pointable`;
+var SOVEREIGN_SUGGEST_SYSTEM_PROMPT = `You are a HoloScript trait suggestion engine running locally (sovereign, no cloud).
+Given a natural language description of an object or scene, suggest appropriate HoloScript traits.
+
+Available traits: @grabbable, @throwable, @clickable, @hoverable, @draggable, @scalable,
+@physics, @collidable, @gravity, @glowing, @emissive, @transparent, @reflective,
+@animated, @billboard, @networked, @synced, @persistent, @owned, @host_only,
+@stackable, @attachable, @equippable, @consumable, @destructible, @anchor,
+@tracked, @world_locked, @hand_tracked, @eye_tracked, @spatial_audio, @ambient,
+@voice_activated, @state, @reactive, @observable, @computed, @shareable,
+@collaborative, @trigger, @pointable, @state, @reactive
+
+Output JSON only: { "traits": ["@trait1", "@trait2"], "reasoning": { "@trait1": "reason", "@trait2": "reason" }, "confidence": 0.85 }`;
+var TRAIT_KEYWORDS = {
+  "pick up": ["@grabbable"],
+  grab: ["@grabbable"],
+  hold: ["@grabbable", "@holdable"],
+  throw: ["@grabbable", "@throwable"],
+  click: ["@clickable"],
+  point: ["@pointable"],
+  hover: ["@hoverable"],
+  drag: ["@draggable"],
+  scale: ["@scalable"],
+  resize: ["@scalable"],
+  collide: ["@collidable"],
+  bounce: ["@collidable", "@physics"],
+  physics: ["@physics", "@collidable"],
+  fall: ["@physics", "@gravity"],
+  gravity: ["@gravity"],
+  trigger: ["@trigger"],
+  glow: ["@glowing"],
+  light: ["@emissive"],
+  transparent: ["@transparent"],
+  "see through": ["@transparent"],
+  reflect: ["@reflective"],
+  mirror: ["@reflective"],
+  animate: ["@animated"],
+  spin: ["@animated"],
+  rotate: ["@animated"],
+  billboard: ["@billboard"],
+  "face camera": ["@billboard"],
+  multiplayer: ["@networked", "@synced"],
+  sync: ["@networked", "@synced"],
+  network: ["@networked"],
+  save: ["@persistent"],
+  persist: ["@persistent"],
+  own: ["@owned"],
+  host: ["@host_only"],
+  stack: ["@stackable"],
+  attach: ["@attachable"],
+  equip: ["@equippable"],
+  wear: ["@equippable"],
+  consume: ["@consumable"],
+  eat: ["@consumable"],
+  drink: ["@consumable"],
+  destroy: ["@destructible"],
+  break: ["@destructible"],
+  anchor: ["@anchor"],
+  track: ["@tracked"],
+  "world lock": ["@world_locked"],
+  "hand track": ["@hand_tracked"],
+  "eye track": ["@eye_tracked"],
+  sound: ["@spatial_audio"],
+  audio: ["@spatial_audio"],
+  ambient: ["@ambient"],
+  voice: ["@voice_activated"],
+  speak: ["@voice_activated"],
+  state: ["@state", "@reactive"],
+  react: ["@reactive"],
+  observe: ["@observable"],
+  compute: ["@computed"],
+  share: ["@shareable"],
+  collaborate: ["@collaborative"],
+  tweet: ["@tweetable"]
+};
+var SovereignGeneratorAdapter = class {
+  constructor(options = {}) {
+    this.id = "sovereign-generator";
+    this.localEndpoint = (options.localEndpoint ?? DEFAULT_LOCAL_ENDPOINT).replace(/\/$/, "");
+    this.cloudEndpoint = (options.cloudEndpoint ?? DEFAULT_CLOUD_ENDPOINT).replace(/\/$/, "");
+    this.cloudApiKey = options.cloudApiKey ?? DEFAULT_CLOUD_API_KEY;
+    this.localModel = options.localModel ?? DEFAULT_LOCAL_MODEL;
+    this.cloudModel = options.cloudModel ?? DEFAULT_CLOUD_MODEL;
+    this.maxTokens = options.maxTokens ?? DEFAULT_MAX_TOKENS;
+    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS3;
+    this.offlineOnly = options.offlineOnly ?? false;
+    this.mockMode = options.mockMode ?? false;
+    this.mockLatencyMs = Math.max(0, options.mockLatencyMs ?? 5);
+  }
+  // ---------------------------------------------------------------------------
+  // PUBLIC API — suggestTraits
+  // ---------------------------------------------------------------------------
+  /**
+   * Suggest HoloScript traits for a natural language description.
+   *
+   * Resolution order:
+   *   1. Local Brittney (Ollama/WebLLM) — sovereign, offline-capable
+   *   2. Cloud Brittney — if online and not offlineOnly
+   *   3. Keyword fallback — deterministic, no LLM needed
+   */
+  async suggestTraits(description, context) {
+    if (this.mockMode) {
+      await this.sleep(this.mockLatencyMs);
+      return this.keywordSuggestTraits(description, context, "mock");
+    }
+    try {
+      const localResult = await this.localSuggestTraits(description, context);
+      if (localResult) {
+        return { ...localResult, metadata: { source: "sovereign-local" } };
+      }
+    } catch {
+    }
+    if (!this.offlineOnly && this.cloudEndpoint) {
+      try {
+        const cloudResult = await this.cloudSuggestTraits(description, context);
+        if (cloudResult) {
+          return { ...cloudResult, metadata: { source: "sovereign-cloud" } };
+        }
+      } catch {
+      }
+    }
+    return this.keywordSuggestTraits(description, context, "keyword-fallback");
+  }
+  // ---------------------------------------------------------------------------
+  // PUBLIC API — generateObject
+  // ---------------------------------------------------------------------------
+  /**
+   * Generate a HoloScript object from natural language.
+   *
+   * Resolution order mirrors suggestTraits:
+   *   1. Local Brittney (sovereign)
+   *   2. Cloud Brittney
+   *   3. Keyword/template fallback
+   */
+  async generateObject(description) {
+    if (this.mockMode) {
+      await this.sleep(this.mockLatencyMs);
+      return this.templateGenerateObject(description, "mock");
+    }
+    try {
+      const localResult = await this.localGenerate(description, "object");
+      if (localResult) {
+        return {
+          code: localResult,
+          metadata: {
+            description,
+            traits: this.extractTraitsFromCode(localResult),
+            geometry: this.extractGeometryFromCode(localResult),
+            source: "sovereign-local"
+          }
+        };
+      }
+    } catch {
+    }
+    if (!this.offlineOnly && this.cloudEndpoint) {
+      try {
+        const cloudResult = await this.cloudGenerate(description, "object");
+        if (cloudResult) {
+          return {
+            code: cloudResult,
+            metadata: {
+              description,
+              traits: this.extractTraitsFromCode(cloudResult),
+              geometry: this.extractGeometryFromCode(cloudResult),
+              source: "sovereign-cloud"
+            }
+          };
+        }
+      } catch {
+      }
+    }
+    return this.templateGenerateObject(description, "keyword-fallback");
+  }
+  // ---------------------------------------------------------------------------
+  // PUBLIC API — generateScene
+  // ---------------------------------------------------------------------------
+  /**
+   * Generate a complete HoloScript composition from natural language.
+   */
+  async generateScene(description) {
+    if (this.mockMode) {
+      await this.sleep(this.mockLatencyMs);
+      return this.templateGenerateScene(description, "mock");
+    }
+    try {
+      const localResult = await this.localGenerate(description, "scene");
+      if (localResult) {
+        return {
+          code: localResult,
+          metadata: {
+            description,
+            objectCount: this.countObjects(localResult),
+            traits: this.extractTraitsFromCode(localResult),
+            source: "sovereign-local"
+          }
+        };
+      }
+    } catch {
+    }
+    if (!this.offlineOnly && this.cloudEndpoint) {
+      try {
+        const cloudResult = await this.cloudGenerate(description, "scene");
+        if (cloudResult) {
+          return {
+            code: cloudResult,
+            metadata: {
+              description,
+              objectCount: this.countObjects(cloudResult),
+              traits: this.extractTraitsFromCode(cloudResult),
+              source: "sovereign-cloud"
+            }
+          };
+        }
+      } catch {
+      }
+    }
+    return this.templateGenerateScene(description, "keyword-fallback");
+  }
+  // ---------------------------------------------------------------------------
+  // LOCAL BRITTNEY (Ollama / WebLLM)
+  // ---------------------------------------------------------------------------
+  async localSuggestTraits(description, context) {
+    const prompt = context ? `Description: "${description}"
+Context: "${context}"` : `Description: "${description}"`;
+    const body = {
+      model: this.localModel,
+      messages: [
+        { role: "system", content: SOVEREIGN_SUGGEST_SYSTEM_PROMPT },
+        { role: "user", content: prompt }
+      ],
+      stream: false,
+      options: { num_predict: 512 }
+    };
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      const response = await fetch(`${this.localEndpoint}/v1/chat/completions`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+      if (!response.ok) return null;
+      const data = await response.json();
+      const content = data?.choices?.[0]?.message?.content;
+      if (!content) return null;
+      return this.parseTraitSuggestion(content);
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+  async localGenerate(description, kind) {
+    const prompt = kind === "scene" ? `Generate a HoloScript composition for: ${description}` : `Generate a HoloScript object for: ${description}`;
+    const body = {
+      model: this.localModel,
+      messages: [
+        { role: "system", content: SOVEREIGN_GENERATE_SYSTEM_PROMPT },
+        { role: "user", content: prompt }
+      ],
+      stream: false,
+      options: { num_predict: this.maxTokens }
+    };
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      const response = await fetch(`${this.localEndpoint}/v1/chat/completions`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+      if (!response.ok) return null;
+      const data = await response.json();
+      const content = data?.choices?.[0]?.message?.content;
+      if (!content) return null;
+      return this.stripCodeFences(content);
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // CLOUD BRITTNEY
+  // ---------------------------------------------------------------------------
+  async cloudSuggestTraits(description, context) {
+    const prompt = context ? `Description: "${description}"
+Context: "${context}"` : `Description: "${description}"`;
+    const body = {
+      model: this.cloudModel,
+      messages: [
+        { role: "system", content: SOVEREIGN_SUGGEST_SYSTEM_PROMPT },
+        { role: "user", content: prompt }
+      ],
+      stream: false,
+      max_tokens: 512
+    };
+    const headers = {
+      "Content-Type": "application/json",
+      ...this.cloudApiKey ? { Authorization: `Bearer ${this.cloudApiKey}` } : {}
+    };
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      const response = await fetch(`${this.cloudEndpoint}/v1/chat/completions`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+      if (!response.ok) return null;
+      const data = await response.json();
+      const content = data?.choices?.[0]?.message?.content;
+      if (!content) return null;
+      return this.parseTraitSuggestion(content);
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+  async cloudGenerate(description, kind) {
+    const prompt = kind === "scene" ? `Generate a HoloScript composition for: ${description}` : `Generate a HoloScript object for: ${description}`;
+    const body = {
+      model: this.cloudModel,
+      messages: [
+        { role: "system", content: SOVEREIGN_GENERATE_SYSTEM_PROMPT },
+        { role: "user", content: prompt }
+      ],
+      stream: false,
+      max_tokens: this.maxTokens
+    };
+    const headers = {
+      "Content-Type": "application/json",
+      ...this.cloudApiKey ? { Authorization: `Bearer ${this.cloudApiKey}` } : {}
+    };
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      const response = await fetch(`${this.cloudEndpoint}/v1/chat/completions`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+      if (!response.ok) return null;
+      const data = await response.json();
+      const content = data?.choices?.[0]?.message?.content;
+      if (!content) return null;
+      return this.stripCodeFences(content);
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // KEYWORD / TEMPLATE FALLBACK — deterministic, no LLM
+  // ---------------------------------------------------------------------------
+  keywordSuggestTraits(description, context, source) {
+    const lowerDesc = (description + " " + (context || "")).toLowerCase();
+    const suggestedTraits = /* @__PURE__ */ new Set();
+    const reasoning = {};
+    for (const [keyword, traits2] of Object.entries(TRAIT_KEYWORDS)) {
+      if (lowerDesc.includes(keyword)) {
+        for (const trait of traits2) {
+          if (!suggestedTraits.has(trait)) {
+            suggestedTraits.add(trait);
+            reasoning[trait] = `Suggested because description mentions "${keyword}"`;
+          }
+        }
+      }
+    }
+    if (suggestedTraits.size === 0) {
+      suggestedTraits.add("@pointable");
+      reasoning["@pointable"] = "Default trait for interactive objects";
+    }
+    if (suggestedTraits.has("@physics") && !suggestedTraits.has("@collidable")) {
+      suggestedTraits.add("@collidable");
+      reasoning["@collidable"] = "Required for physics interactions";
+    }
+    const traits = Array.from(suggestedTraits);
+    const confidence = Math.min(0.95, 0.5 + traits.length * 0.1);
+    return {
+      traits,
+      reasoning,
+      confidence,
+      metadata: { source }
+    };
+  }
+  templateGenerateObject(description, source) {
+    const { traits } = this.keywordSuggestTraits(
+      description,
+      void 0,
+      source === "mock" ? "mock" : "keyword-fallback"
+    );
+    const code = `object "Generated" {
+  // Generated from: ${description}
+  geometry: "cube"
+  position: [0, 1, 0]
+${traits.length > 0 ? "  " + traits.join("\n  ") : ""}
+}`;
+    return {
+      code,
+      metadata: {
+        description,
+        traits,
+        geometry: "cube",
+        source
+      }
+    };
+  }
+  templateGenerateScene(description, source) {
+    const { traits } = this.keywordSuggestTraits(
+      description,
+      void 0,
+      source === "mock" ? "mock" : "keyword-fallback"
+    );
+    const code = `composition "Generated Scene" {
+  // Generated from: ${description}
+  environment {
+    skybox: "default"
+    ambient_light: 0.5
+  }
+
+  object "Object1" {
+    geometry: "cube"
+    position: [0, 1, 0]
+${traits.length > 0 ? "    " + traits.join("\n    ") : ""}
+  }
+}`;
+    return {
+      code,
+      metadata: {
+        description,
+        objectCount: 1,
+        traits,
+        source
+      }
+    };
+  }
+  // ---------------------------------------------------------------------------
+  // PARSING UTILITIES
+  // ---------------------------------------------------------------------------
+  parseTraitSuggestion(content) {
+    try {
+      const stripped = this.stripCodeFences(content).trim();
+      const jsonMatch = stripped.match(/\{[\s\S]*\}/);
+      if (!jsonMatch) return null;
+      const parsed = JSON.parse(jsonMatch[0]);
+      if (!Array.isArray(parsed.traits)) return null;
+      return {
+        traits: parsed.traits.filter((t) => typeof t === "string"),
+        reasoning: parsed.reasoning ?? {},
+        confidence: typeof parsed.confidence === "number" ? parsed.confidence : 0.7
+      };
+    } catch {
+      return null;
+    }
+  }
+  stripCodeFences(code) {
+    return code.replace(/^```(?:holoscript|hs|holo)?\s*\n?/m, "").replace(/\n?```\s*$/m, "").trim();
+  }
+  extractTraitsFromCode(code) {
+    const traitPattern = /@[\w]+/g;
+    const matches = code.match(traitPattern);
+    return matches ? [...new Set(matches)] : [];
+  }
+  extractGeometryFromCode(code) {
+    const geoMatch = code.match(/geometry:\s*"(\w+)"/);
+    return geoMatch?.[1] ?? "unknown";
+  }
+  countObjects(code) {
+    const objectMatches = code.match(/\bobject\s+"/g);
+    return objectMatches ? objectMatches.length : 1;
+  }
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+// src/world/WorldGeneratorService.ts
+var WorldGeneratorService = class {
+  constructor(registry = worldAdapterRegistry) {
+    this.emitters = /* @__PURE__ */ new Set();
+    this.defaultAdaptersRegistered = false;
+    this.registry = registry;
+  }
+  /**
+  * Register the built-in sovereign adapter (SovereignWorldAdapter — Brittney v43+).
+   * Call once during scene/runtime bootstrap.
+   */
+  registerDefaultAdapters() {
+    if (this.defaultAdaptersRegistered) return;
+    this.registry.register(new Sovereign3DAdapter({
+      // HOLOSCRIPT_SOVEREIGN_MOCK=true enables deterministic mock output when the
+      // live sovereign service (wss://api.hololand.io) is offline or not yet deployed.
+      mockMode: Boolean(process.env.HOLOSCRIPT_SOVEREIGN_MOCK)
+    }));
+    this.defaultAdaptersRegistered = true;
+  }
+  /**
+   * Bind to an event emitter (TraitContext-like).
+   * The service starts listening for 'world:generate' events on this emitter.
+   * Returns an unsubscribe function.
+   */
+  bindEventEmitter(emitter) {
+    const listener = (data) => {
+      void this.handleGenerateEvent(emitter, data);
+    };
+    emitter.on("world:generate", listener);
+    this.emitters.add(emitter);
+    return () => {
+      emitter.off?.("world:generate", listener);
+      this.emitters.delete(emitter);
+    };
+  }
+  // ---------------------------------------------------------------------------
+  // CORE HANDLER
+  // ---------------------------------------------------------------------------
+  async handleGenerateEvent(emitter, event) {
+    const { nodeId, engine } = event;
+    if (!this.registry.has(engine)) {
+      const errEvent = {
+        nodeId,
+        error: `No adapter registered for engine '${engine}'. Available: ${this.registry.list().join(", ")}`
+      };
+      emitter.emit("world:generation_error", errEvent);
+      return;
+    }
+    const adapter = this.registry.get(engine);
+    const request = {
+      prompt: event.prompt,
+      format: event.format,
+      quality: event.quality,
+      ...event.input_image ? { input_image: event.input_image } : {},
+      ...event.input_images ? { input_images: event.input_images } : {},
+      ...event.seed !== void 0 ? { seed: event.seed } : {},
+      ...event.navEnabled !== void 0 ? { navEnabled: event.navEnabled } : {},
+      ...event.interactiveMode !== void 0 ? { interactiveMode: event.interactiveMode } : {}
+    };
+    try {
+      const generationPromise = adapter.generate(request);
+      emitter.emit("world:generation_started", {
+        nodeId,
+        engine,
+        generationId: "pending"
+      });
+      let progressInterval;
+      if (adapter.getProgress) {
+        const getProgress = adapter.getProgress.bind(adapter);
+        progressInterval = setInterval(() => {
+          void getProgress("pending").then((progress) => {
+            emitter.emit("world:generation_progress", {
+              nodeId,
+              progress
+            });
+          }).catch(() => {
+          });
+        }, 3e3);
+      }
+      const result = await generationPromise;
+      if (progressInterval !== void 0) {
+        clearInterval(progressInterval);
+      }
+      emitter.emit("world:generation_progress", {
+        nodeId,
+        progress: 1
+      });
+      const completeEvent = {
+        nodeId,
+        assetUrl: result.assetUrl,
+        generationId: result.generationId,
+        metadata: result.metadata,
+        ...result.navmeshUrl ? { navmeshUrl: result.navmeshUrl } : {},
+        ...result.pointCloudUrl ? { pointCloudUrl: result.pointCloudUrl } : {}
+      };
+      emitter.emit("world:generation_complete", completeEvent);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      const errEvent = {
+        nodeId,
+        error: message
+      };
+      emitter.emit("world:generation_error", errEvent);
+    }
+  }
+};
+var worldGeneratorService = new WorldGeneratorService();
+
+exports.Sovereign3DAdapter = Sovereign3DAdapter;
+exports.SovereignGeneratorAdapter = SovereignGeneratorAdapter;
+exports.SovereignWorldAdapter = SovereignWorldAdapter;
+exports.WorldAdapterRegistry = WorldAdapterRegistry;
+exports.WorldGeneratorService = WorldGeneratorService;
+exports.worldAdapterRegistry = worldAdapterRegistry;
+exports.worldGeneratorService = worldGeneratorService;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map