@adea-ai/spatial 0.74.8 → 0.75.1

package/dist/engine.d.ts

@@ -18,6 +18,13 @@
  */
 export declare const OFFICIAL_AGENT_SIM_WEB_HOSTS: readonly ["adea.dev", "adea.io"];
 export type AgentSimWebPlatform = 'web' | 'desktop';
+/**
+ * Designer surfaces the pack may expose as separate cold entries alongside
+ * the HQ entry. Each surface mounts through the same entitlement gate as
+ * the standard virtual view; a pack without the surface simply reports it
+ * unavailable and the host renders its offline fallback.
+ */
+export type AgentSimEngineSurface = 'character-designer' | 'room-designer';
 export type AgentSimEngineManifest = {
     /**
      * Same-origin ES module URL of the engine entry. The entry must register
@@ -27,6 +34,13 @@ export type AgentSimEngineManifest = {
     entryUrl: string;
     /** Engine pack version (agent-sim repo release). Diagnostics only. */
     version: string;
+    /**
+     * Same-origin cold-entry URLs for the designer surfaces (agent-sim
+     * v0.13.2+ packs). A designer entry registers its mount under
+     * `window.adeaAgentSimSurfaces[surface]`. Absent on older packs — the
+     * host then renders the surface's offline fallback.
+     */
+    surfaces?: Partial<Record<AgentSimEngineSurface, string>>;
 };
 /** Well-known same-origin URL the official pack lane writes the manifest to. */
 export declare function agentSimEngineManifestUrl(origin: string): string;

package/dist/engine.js

@@ -49,7 +49,30 @@ export function parseAgentSimEngineManifest(value, origin) {
         return { ok: false };
     if (!resolved.pathname.endsWith('.js'))
         return { ok: false };
-    return { ok: true, manifest: { entryUrl: resolved.toString(), version } };
+    // Surfaces are optional and individually validated: anything that is not a
+    // same-origin .js URL is dropped rather than failing the whole manifest, so
+    // a partially-written pack degrades to the fallback instead of breaking HQ.
+    const rawSurfaces = value.engine?.surfaces;
+    let surfaces;
+    if (typeof rawSurfaces === 'object' && rawSurfaces !== null) {
+        for (const [name, url] of Object.entries(rawSurfaces)) {
+            if (typeof url !== 'string' || url.length === 0)
+                continue;
+            try {
+                const surfaceUrl = new URL(url, origin);
+                if (surfaceUrl.origin !== new URL(origin).origin)
+                    continue;
+                if (!surfaceUrl.pathname.endsWith('.js'))
+                    continue;
+                surfaces ??= {};
+                surfaces[name] = surfaceUrl.toString();
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return { ok: true, manifest: { entryUrl: resolved.toString(), version, surfaces } };
 }
 /**
  * Whether a web origin is an official Adea deployment allowed to resolve the

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export * from './asset-manifests';
-export { agentSimEngineManifestUrl, isLocalDevHost, isOfficialAgentSimWebOrigin, parseAgentSimEngineManifest, OFFICIAL_AGENT_SIM_WEB_HOSTS, type AgentSimEngineManifest, } from './engine';
+export { agentSimEngineManifestUrl, isLocalDevHost, isOfficialAgentSimWebOrigin, parseAgentSimEngineManifest, OFFICIAL_AGENT_SIM_WEB_HOSTS, type AgentSimEngineManifest, type AgentSimEngineSurface, } from './engine';
 export { hqHomeManifest, hqWorkManifest } from './manifests';
 export { appRouteHref, encodeSceneStartPosition, portalNavigationHref, readSceneStartPosition, type PortalNavigation, type SceneApp, } from './scene-spawn';
 export { createSceneTelemetryEnvelope, MAX_SCENE_TELEMETRY_BYTES, onRouterTransitionStart, parseScenePerformanceReport, recordNavigation, SCENE_TELEMETRY_LOG_PREFIX, type SceneNavigationType, type ScenePerformanceReport, type SceneRuntimeStats, type SceneTelemetryEnvelope, } from './telemetry';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adea-ai/spatial",
-  "version": "0.74.8",
+  "version": "0.75.1",
   "description": "Scene and asset manifest contracts plus the shell-to-engine spatial protocol for Adea workspaces: scene mount manifests, spawn URL helpers, and scene telemetry schemas. Pure types — no rendering, no binaries.",
   "keywords": [
     "assets",

package/src/engine.ts

@@ -25,6 +25,14 @@ const OFFICIAL_LOCAL_HOSTS = ['localhost', '127.0.0.1', '[::1]']
 
 export type AgentSimWebPlatform = 'web' | 'desktop'
 
+/**
+ * Designer surfaces the pack may expose as separate cold entries alongside
+ * the HQ entry. Each surface mounts through the same entitlement gate as
+ * the standard virtual view; a pack without the surface simply reports it
+ * unavailable and the host renders its offline fallback.
+ */
+export type AgentSimEngineSurface = 'character-designer' | 'room-designer'
+
 export type AgentSimEngineManifest = {
   /**
    * Same-origin ES module URL of the engine entry. The entry must register
@@ -34,6 +42,13 @@ export type AgentSimEngineManifest = {
   entryUrl: string
   /** Engine pack version (agent-sim repo release). Diagnostics only. */
   version: string
+  /**
+   * Same-origin cold-entry URLs for the designer surfaces (agent-sim
+   * v0.13.2+ packs). A designer entry registers its mount under
+   * `window.adeaAgentSimSurfaces[surface]`. Absent on older packs — the
+   * host then renders the surface's offline fallback.
+   */
+  surfaces?: Partial<Record<AgentSimEngineSurface, string>>
 }
 
 /** Well-known same-origin URL the official pack lane writes the manifest to. */
@@ -63,7 +78,28 @@ export function parseAgentSimEngineManifest(
   }
   if (resolved.origin !== new URL(origin).origin) return { ok: false }
   if (!resolved.pathname.endsWith('.js')) return { ok: false }
-  return { ok: true, manifest: { entryUrl: resolved.toString(), version } }
+
+  // Surfaces are optional and individually validated: anything that is not a
+  // same-origin .js URL is dropped rather than failing the whole manifest, so
+  // a partially-written pack degrades to the fallback instead of breaking HQ.
+  const rawSurfaces = (value as { engine?: { surfaces?: unknown } }).engine?.surfaces
+  let surfaces: AgentSimEngineManifest['surfaces']
+  if (typeof rawSurfaces === 'object' && rawSurfaces !== null) {
+    for (const [name, url] of Object.entries(rawSurfaces as Record<string, unknown>)) {
+      if (typeof url !== 'string' || url.length === 0) continue
+      try {
+        const surfaceUrl = new URL(url, origin)
+        if (surfaceUrl.origin !== new URL(origin).origin) continue
+        if (!surfaceUrl.pathname.endsWith('.js')) continue
+        surfaces ??= {}
+        surfaces[name as keyof NonNullable<typeof surfaces>] = surfaceUrl.toString()
+      } catch {
+        continue
+      }
+    }
+  }
+
+  return { ok: true, manifest: { entryUrl: resolved.toString(), version, surfaces } }
 }
 
 /**

package/src/index.ts

@@ -6,6 +6,7 @@ export {
   parseAgentSimEngineManifest,
   OFFICIAL_AGENT_SIM_WEB_HOSTS,
   type AgentSimEngineManifest,
+  type AgentSimEngineSurface,
 } from './engine'
 export { hqHomeManifest, hqWorkManifest } from './manifests'
 export {