@almadar/runtime 6.59.0 → 6.61.0

package/dist/{OrbitalServerRuntime-PI9Ioxdp.d.ts → OrbitalServerRuntime-CZHHxo_A.d.ts}

@@ -1,5 +1,5 @@
 import { Router } from 'express';
-import { I as IEventBus, R as RuntimeEvent, a as EventListener, U as Unsubscribe, T as TraitDefinition, b as RuntimeConfig, c as TransitionObserver, d as TraitState, C as ConfigContext, e as TransitionResult, f as EvaluationContextExtensions, E as EffectHandlers } from './types-TwQ8Dybu.js';
+import { I as IEventBus, R as RuntimeEvent, a as EventListener, U as Unsubscribe, T as TraitDefinition, b as RuntimeConfig, c as TransitionObserver, d as TraitState, C as ConfigContext, e as TransitionResult, f as EvaluationContextExtensions, E as EffectHandlers } from './types-BaD_ox7e.js';
 import { EventPayload, EventId, EntityRow, UserContext, Orbital, ServiceCallResult, TraitConfig, DeclaredTraitConfig, Entity, OrbitalSchema, Trait, PatternConfig, ResolvedPatternProps, SExpr, BusEventSource, RawUserClaims, OrbitalDefinition, TraitTick } from '@almadar/core';
 
 /**
@@ -478,8 +478,15 @@ interface LoadedSchema {
  * Result of loading a single orbital from a schema.
  */
 interface LoadedOrbital {
-    /** The loaded orbital */
+    /** The loaded orbital — the named one when requested, else the first. */
     orbital: Orbital;
+    /**
+     * EVERY orbital in the loaded schema. `Alias.traits.X` carries no orbital
+     * segment, so a multi-orbital behavior's traits and pages must all stay
+     * reachable; resolving against `orbital` alone silently loses everything
+     * outside it. Mirrors the compiled path's `AliasEntry.orbitals`.
+     */
+    orbitals?: Orbital[];
     /** Source path/URL (resolved) */
     sourcePath: string;
     /** Original import path */

package/dist/OrbitalServerRuntime.d.ts

@@ -1,4 +1,4 @@
 import 'express';
-export { F as ClientEffectTuple, G as ClientNavigateBackTuple, H as ClientNavigateTuple, J as ClientNotifyTuple, K as ClientRenderUITuple, M as EffectResult, e as InMemoryPersistence, N as LiveBroadcastItem, Q as LoaderConfig, O as OrbitalEventRequest, f as OrbitalEventResponse, T as OrbitalServerRuntime, g as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, V as RuntimeTraitTick, p as collectDeclaredConfigDefaults, W as createOrbitalServerRuntime } from './OrbitalServerRuntime-PI9Ioxdp.js';
-import './types-TwQ8Dybu.js';
+export { F as ClientEffectTuple, G as ClientNavigateBackTuple, H as ClientNavigateTuple, J as ClientNotifyTuple, K as ClientRenderUITuple, M as EffectResult, e as InMemoryPersistence, N as LiveBroadcastItem, Q as LoaderConfig, O as OrbitalEventRequest, f as OrbitalEventResponse, T as OrbitalServerRuntime, g as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, V as RuntimeTraitTick, p as collectDeclaredConfigDefaults, W as createOrbitalServerRuntime } from './OrbitalServerRuntime-CZHHxo_A.js';
+import './types-BaD_ox7e.js';
 import '@almadar/core';

package/dist/OrbitalServerRuntime.js

@@ -1,5 +1,5 @@
-import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, normalizeCallSiteConfigToValues, StateMachineManager, parseDurationString, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-WSNZNXZE.js';
-export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-WSNZNXZE.js';
+import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, normalizeCallSiteConfigToValues, StateMachineManager, parseDurationString, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-QY5EUGR2.js';
+export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-QY5EUGR2.js';
 import { isValidCronExpression } from './chunk-OU3ITB5S.js';
 import { createContextFromBindings, resolveCallSitePayloadCaptures, applyRowAccess, checkMutationAccess, accessDeniedMessage } from './chunk-ZJ62H3ES.js';
 import './chunk-T4VDAB4C.js';
@@ -1542,6 +1542,7 @@ var OrbitalServerRuntime = class {
             data: resultData,
             success: true
           });
+          return resultData;
         } catch (err) {
           effectLog.error("persist:store-mutate-error", {
             action,
@@ -1556,6 +1557,7 @@ var OrbitalServerRuntime = class {
             error: err instanceof Error ? err.message : String(err)
           });
         }
+        return void 0;
       },
       callService: async (service, action, params) => {
         try {

package/dist/ServerBridge.d.ts

@@ -1,4 +1,4 @@
-import { I as IEventBus } from './types-TwQ8Dybu.js';
+import { I as IEventBus } from './types-BaD_ox7e.js';
 import { EventPayload } from '@almadar/core';
 
 /**

package/dist/{chunk-FOFLEZRJ.js → chunk-F5W3YZGJ.js}

@@ -134,6 +134,9 @@ function push(entry) {
   scheduleNotify();
 }
 function isEnabled() {
+  return isLogLevelEnabled("DEBUG", PERF_NAMESPACE) || globalThis.__ALMADAR_PERF__ === true;
+}
+function isVerbose() {
   return isLogLevelEnabled("DEBUG", PERF_NAMESPACE);
 }
 function now() {
@@ -161,7 +164,8 @@ function perfEnd(name, startToken, detail) {
     }
   }
   push({ name, durationMs, ts: endTs, detail });
-  log.debug(name, () => ({ durationMs, ...detail ?? {} }));
+  aggregate(name, durationMs);
+  if (isVerbose()) log.debug(name, () => ({ durationMs, ...detail ?? {} }));
 }
 function perfTime(name, fn, detail) {
   const t = perfStart(name);
@@ -171,6 +175,46 @@ function perfTime(name, fn, detail) {
     perfEnd(name, t, detail);
   }
 }
+async function perfTimeAsync(name, fn) {
+  const t = perfStart(name);
+  try {
+    return await fn();
+  } finally {
+    perfEnd(name, t);
+  }
+}
+function perfGauge(name, value) {
+  if (!isEnabled()) return;
+  aggregate(name, value);
+}
+var buckets = /* @__PURE__ */ new Map();
+var dumpTimer = null;
+function aggregate(name, ms) {
+  const b = buckets.get(name);
+  if (b) {
+    b.count++;
+    b.totalMs += ms;
+    if (ms > b.maxMs) b.maxMs = ms;
+  } else {
+    buckets.set(name, { count: 1, totalMs: ms, maxMs: ms });
+  }
+  if (dumpTimer === null) {
+    dumpTimer = setInterval(dumpSummary, 5e3);
+    if (typeof dumpTimer === "object" && "unref" in dumpTimer) dumpTimer.unref();
+  }
+}
+function dumpSummary() {
+  if (buckets.size === 0) return;
+  const rows = [...buckets.entries()].map(([name, b]) => ({
+    name,
+    count: b.count,
+    totalMs: Math.round(b.totalMs),
+    avgMs: Math.round(b.totalMs / b.count * 100) / 100,
+    maxMs: Math.round(b.maxMs * 10) / 10
+  })).sort((a, b) => b.totalMs - a.totalMs);
+  log.warn("[PROFILE] summary", { phases: JSON.stringify(rows) });
+  buckets.clear();
+}
 function getPerfSnapshot() {
   if (ring.length < RING_SIZE) return ring.slice();
   return [...ring.slice(writeIdx), ...ring.slice(0, writeIdx)];
@@ -424,4 +468,4 @@ function bindTraitStateGetter(getter) {
   api.getTraitState = getter;
 }
 
-export { PERF_NAMESPACE, RendererContractViolationError, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfStart, perfStore, perfTime, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent };
+export { PERF_NAMESPACE, RendererContractViolationError, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfGauge, perfStart, perfStore, perfTime, perfTimeAsync, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent };

package/dist/{chunk-WSNZNXZE.js → chunk-QY5EUGR2.js}

@@ -1363,15 +1363,16 @@ var EffectExecutor = class _EffectExecutor {
           } else {
             const entityType = args[1];
             const data = args[2];
-            await this.handlers.persist(action, entityType, data);
-            const dataId = typeof data === "string" ? data : data && typeof data === "object" ? data.id : void 0;
+            const persisted = await this.handlers.persist(action, entityType, data);
+            const successPayload = persisted ?? data;
+            const dataId = typeof successPayload === "string" ? successPayload : successPayload && typeof successPayload === "object" ? successPayload.id : void 0;
             persistLog.debug("persist:success", {
               action,
               entityType,
               dataId,
               willEmit: emitCfg?.success
             });
-            this.emitSuccess(emitCfg, "success", data, true);
+            this.emitSuccess(emitCfg, "success", successPayload, true);
             persistLog.debug("persist:emit-fired", { action, eventName: emitCfg?.success });
           }
         } catch (err) {
@@ -1974,8 +1975,7 @@ var EffectExecutor = class _EffectExecutor {
   }
 };
 function createTestExecutor(overrides = {}) {
-  const noopAsync = async () => {
-  };
+  const noopAsync = async () => void 0;
   const noop = () => {
   };
   return new EffectExecutor({
@@ -2635,6 +2635,7 @@ var HttpLoader = class {
       success: true,
       data: {
         orbital,
+        orbitals: schema.orbitals,
         sourcePath: schemaResult.data.sourcePath,
         importPath
       }
@@ -2844,7 +2845,7 @@ async function getExternalLoaderModule() {
     return null;
   }
   try {
-    externalLoaderModule = await import('./external-loader-WYQAS3BS.js');
+    externalLoaderModule = await import('./external-loader-YUUADLAP.js');
     return externalLoaderModule;
   } catch {
     return null;
@@ -3017,6 +3018,7 @@ var UnifiedLoader = class {
         success: true,
         data: {
           orbital: found,
+          orbitals: schema.orbitals,
           sourcePath: schemaResult.data.sourcePath,
           importPath
         }
@@ -3032,6 +3034,7 @@ var UnifiedLoader = class {
       success: true,
       data: {
         orbital: schema.orbitals[0],
+        orbitals: schema.orbitals,
         sourcePath: schemaResult.data.sourcePath,
         importPath
       }
@@ -3400,10 +3403,13 @@ function buildIdIndex(orbital, orbitals) {
   const idIndex = /* @__PURE__ */ new Map();
   indexOrbitalNodes(orbital, idIndex);
   for (const imported of orbitals.values()) {
-    indexOrbitalNodes(imported.orbital, idIndex);
+    for (const o of importedOrbitals(imported)) indexOrbitalNodes(o, idIndex);
   }
   return idIndex;
 }
+function importedOrbitals(imported) {
+  return imported.orbitals?.length ? imported.orbitals : [imported.orbital];
+}
 function renameEventsInRenderUiConfig(node, rename) {
   if (node === null || node === void 0) return node;
   if (Array.isArray(node)) {
@@ -3616,6 +3622,23 @@ function traitEmbedNamesOf(trait) {
   for (const field of Object.values(trait.config ?? {})) walk(field.default);
   return [...found];
 }
+function resolveForwardedSiblingConfig(trait, parent) {
+  const declared = trait.config;
+  const parentDeclared = parent?.config;
+  if (!declared || !parentDeclared) return trait;
+  let next;
+  for (const [key, field] of Object.entries(declared)) {
+    const forward = field.default;
+    if (typeof forward !== "string" || !forward.startsWith("@config.")) continue;
+    const knob = forward.slice("@config.".length);
+    if (knob.length === 0 || knob.includes(".")) continue;
+    const value = parentDeclared[knob]?.default;
+    if (value === void 0 || value === forward) continue;
+    next ??= { ...declared };
+    next[key] = { ...field, default: value };
+  }
+  return next ? { ...trait, config: next } : trait;
+}
 function applyLinkedEntityRename(trait, linkedEntity) {
   const atomLinked = trait.linkedEntity;
   if (!linkedEntity || !atomLinked || linkedEntity === atomLinked) return trait;
@@ -3804,7 +3827,7 @@ var ReferenceResolver = class {
     if (this.loader || this.loaderInitialized) return;
     this.loaderInitialized = true;
     try {
-      const { ExternalOrbitalLoader } = await import('./external-loader-WYQAS3BS.js');
+      const { ExternalOrbitalLoader } = await import('./external-loader-YUUADLAP.js');
       this.loader = new ExternalOrbitalLoader(this.options);
     } catch {
     }
@@ -3912,6 +3935,7 @@ var ReferenceResolver = class {
         alias: use.as,
         from: use.from,
         orbital: loadResult.data.orbital,
+        orbitals: loadResult.data.orbitals ?? [loadResult.data.orbital],
         sourcePath: loadResult.data.sourcePath
       });
     }
@@ -4116,7 +4140,11 @@ var ReferenceResolver = class {
       visited.add(pullKey);
       const imported = imports.orbitals.get(alias);
       if (!imported) continue;
-      const atomEntry = findTraitEntryInOrbital(imported.orbital, sibling);
+      let atomEntry = null;
+      for (const o of importedOrbitals(imported)) {
+        atomEntry = findTraitEntryInOrbital(o, sibling);
+        if (atomEntry) break;
+      }
       if (!atomEntry) continue;
       let atomTrait;
       if ("stateMachine" in atomEntry) {
@@ -4148,7 +4176,11 @@ var ReferenceResolver = class {
         }
         atomTrait = nested.data.trait;
       }
-      let copy = applyLinkedEntityRename(atomTrait, linkedEntity);
+      const embedder = resolved.find((r) => r.trait.name === parent)?.trait ?? pulled.find((r) => r.trait.name === parent)?.trait;
+      let copy = resolveForwardedSiblingConfig(
+        applyLinkedEntityRename(atomTrait, linkedEntity),
+        embedder
+      );
       if (finalName !== sibling) {
         copy = { ...copy, name: finalName };
         noteRewrite(parent, sibling, finalName);
@@ -4261,12 +4293,17 @@ var ReferenceResolver = class {
           ]
         };
       }
-      const trait = this.findTraitInOrbital(imported.orbital, parsed.traitName, refId, imports.idIndex);
+      let trait = null;
+      for (const o of importedOrbitals(imported)) {
+        trait = this.findTraitInOrbital(o, parsed.traitName, refId, imports.idIndex);
+        if (trait) break;
+      }
       if (!trait) {
+        const available = importedOrbitals(imported).flatMap((o) => this.listTraitsInOrbital(o));
         return {
           success: false,
           errors: [
-            `Trait "${parsed.traitName}" not found in imported orbital "${parsed.alias}". Available traits: ${this.listTraitsInOrbital(imported.orbital).join(", ") || "none"}`
+            `Trait "${parsed.traitName}" not found in imported orbital "${parsed.alias}". Available traits: ${available.join(", ") || "none"}`
           ]
         };
       }
@@ -4435,12 +4472,17 @@ var ReferenceResolver = class {
         ]
       };
     }
-    const page = this.findPageInOrbital(imported.orbital, parsed.pageName, refId, imports.idIndex);
+    let page = null;
+    for (const o of importedOrbitals(imported)) {
+      page = this.findPageInOrbital(o, parsed.pageName, refId, imports.idIndex);
+      if (page) break;
+    }
     if (!page) {
+      const available = importedOrbitals(imported).flatMap((o) => this.listPagesInOrbital(o));
       return {
         success: false,
         errors: [
-          `Page "${parsed.pageName}" not found in imported orbital "${parsed.alias}". Available pages: ${this.listPagesInOrbital(imported.orbital).join(", ") || "none"}`
+          `Page "${parsed.pageName}" not found in imported orbital "${parsed.alias}". Available pages: ${available.join(", ") || "none"}`
         ]
       };
     }

package/dist/createOsHandlers.d.ts

@@ -1,4 +1,4 @@
-import { E as EffectHandlers } from './types-TwQ8Dybu.js';
+import { E as EffectHandlers } from './types-BaD_ox7e.js';
 import { EventPayload } from '@almadar/core';
 
 /**

package/dist/{external-loader-WYQAS3BS.js → external-loader-YUUADLAP.js}

@@ -154,6 +154,7 @@ var ExternalOrbitalLoader = class {
       success: true,
       data: {
         orbital,
+        orbitals: schema.orbitals,
         sourcePath: schemaResult.data.sourcePath,
         importPath
       }

package/dist/index.d.ts

@@ -1,15 +1,15 @@
-import { g as RuntimePatternValue, B as BindingContext, f as EvaluationContextExtensions, P as PatternProps, E as EffectHandlers, h as EffectContext, i as ExecutionEnvironment, j as EffectResult, S as ServiceCallContext, T as TraitDefinition } from './types-TwQ8Dybu.js';
-export { k as BrowserFileMeta, l as BrowserFilePickerOptions, m as BrowserGeolocationOptions, n as BrowserGeolocationPosition, C as ConfigContext, o as Effect, a as EventListener, H as HANDLER_MANIFEST, I as IEventBus, b as RuntimeConfig, R as RuntimeEvent, d as TraitState, c as TransitionObserver, e as TransitionResult, U as Unsubscribe } from './types-TwQ8Dybu.js';
-import { U as UnifiedLoaderOptions, S as SchemaLoader, I as ImportChainLike, L as LoadResult, a as LoadedSchema, b as LoadedOrbital, P as PersistenceAdapter } from './OrbitalServerRuntime-PI9Ioxdp.js';
-export { E as EntitySharingMap, c as EventBus, d as EventNamespaceMap, e as InMemoryPersistence, O as OrbitalEventRequest, f as OrbitalEventResponse, g as OrbitalServerRuntimeConfig, h as PreprocessOptions, i as PreprocessResult, j as PreprocessedSchema, k as ProcessEventOptions, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, o as StateMachineManager, p as collectDeclaredConfigDefaults, q as collectDeclaredEntityDefaults, r as createInitialTraitState, s as findInitialState, t as findTransition, u as getIsolatedCollectionName, v as getNamespacedEvent, w as isBrowser, x as isElectron, y as isNamespacedEvent, z as isNode, A as normalizeEventKey, B as parseNamespacedEvent, C as preprocessSchema, D as processEvent } from './OrbitalServerRuntime-PI9Ioxdp.js';
+import { g as RuntimePatternValue, B as BindingContext, f as EvaluationContextExtensions, P as PatternProps, E as EffectHandlers, h as EffectContext, i as ExecutionEnvironment, j as EffectResult, S as ServiceCallContext, T as TraitDefinition } from './types-BaD_ox7e.js';
+export { k as BrowserFileMeta, l as BrowserFilePickerOptions, m as BrowserGeolocationOptions, n as BrowserGeolocationPosition, C as ConfigContext, o as Effect, a as EventListener, H as HANDLER_MANIFEST, I as IEventBus, b as RuntimeConfig, R as RuntimeEvent, d as TraitState, c as TransitionObserver, e as TransitionResult, U as Unsubscribe } from './types-BaD_ox7e.js';
+import { U as UnifiedLoaderOptions, S as SchemaLoader, I as ImportChainLike, L as LoadResult, a as LoadedSchema, b as LoadedOrbital, P as PersistenceAdapter } from './OrbitalServerRuntime-CZHHxo_A.js';
+export { E as EntitySharingMap, c as EventBus, d as EventNamespaceMap, e as InMemoryPersistence, O as OrbitalEventRequest, f as OrbitalEventResponse, g as OrbitalServerRuntimeConfig, h as PreprocessOptions, i as PreprocessResult, j as PreprocessedSchema, k as ProcessEventOptions, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, o as StateMachineManager, p as collectDeclaredConfigDefaults, q as collectDeclaredEntityDefaults, r as createInitialTraitState, s as findInitialState, t as findTransition, u as getIsolatedCollectionName, v as getNamespacedEvent, w as isBrowser, x as isElectron, y as isNamespacedEvent, z as isNode, A as normalizeEventKey, B as parseNamespacedEvent, C as preprocessSchema, D as processEvent } from './OrbitalServerRuntime-CZHHxo_A.js';
 import { EvaluationContext, SExpressionEvaluator } from '@almadar/evaluator';
 export { EvaluationContext, createMinimalContext } from '@almadar/evaluator';
-import { RenderBindingMarker, SExpr, TraitConfigObject, EventPayload, PatternConfig, EntityId, EntityField, EntityRow, EntityPersistence, ServiceParams, EntityAccessPolicies, PayloadField, OrbitalDefinition, OrbitalSchema } from '@almadar/core';
+import { RenderBindingMarker, SExpr, RuntimeValue, TraitConfigObject, EventPayload, PatternConfig, EntityId, EntityField, EntityRow, EntityPersistence, ServiceParams, EntityAccessPolicies, PayloadField, OrbitalDefinition, OrbitalSchema } from '@almadar/core';
 export { EntityField, normalizeCallSiteConfigToValues } from '@almadar/core';
 export { AccessBindings, applyRowAccess, checkMutationAccess } from './entityAccess.js';
 export { ServerBridgeConfig, ServerBridgeState } from './ServerBridge.js';
 export { OsHandlerContext, OsHandlerResult } from './createOsHandlers.js';
-export { MultiSourceSlotManager, PERF_NAMESPACE, PerfDetail, PerfDetailValue, PerfEntry, PreparedPreviewSchema, RendererContractViolationError, ResolvedPageTraits, SlotContent, SlotContentValidationError, SlotManager, SlotSource, VerificationBus, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, collectEmbeddedTraits, collectTraitRefsFromResolvedTrait, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfStart, perfStore, perfTime, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent } from './ui/index.js';
+export { MultiSourceSlotManager, PERF_NAMESPACE, PerfDetail, PerfDetailValue, PerfEntry, PreparedPreviewSchema, RendererContractViolationError, ResolvedPageTraits, SlotContent, SlotContentValidationError, SlotManager, SlotSource, VerificationBus, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, collectEmbeddedTraits, collectTraitRefsFromResolvedTrait, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfGauge, perfStart, perfStore, perfTime, perfTimeAsync, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent } from './ui/index.js';
 import 'express';
 import '@almadar/core/patterns';
 
@@ -289,7 +289,7 @@ declare function interpolateProps(props: PatternProps, ctx: EvaluationContext):
 /**
  * Interpolate a single value.
  */
-declare function interpolateValue(value: unknown, ctx: EvaluationContext): unknown;
+declare function interpolateValue(value: RuntimeValue, ctx: EvaluationContext): RuntimeValue;
 /**
  * Value a deferred render-ui prop tree can carry: interpolated runtime
  * values, raw pass-through S-expressions (`fn` lambdas), render-time
@@ -419,15 +419,15 @@ declare class EffectExecutor {
     /**
      * Execute a single effect.
      */
-    execute(effect: unknown): Promise<void>;
+    execute(effect: RuntimeValue): Promise<void>;
     /**
      * Execute multiple effects in sequence.
      */
-    executeAll(effects: unknown[]): Promise<void>;
+    executeAll(effects: RuntimeValue[]): Promise<void>;
     /**
      * Execute multiple effects in parallel.
      */
-    executeParallel(effects: unknown[]): Promise<void>;
+    executeParallel(effects: RuntimeValue[]): Promise<void>;
     /**
      * Execute effects and return detailed results for each.
      * Enables compensating transitions by reporting which effects failed.
@@ -435,7 +435,7 @@ declare class EffectExecutor {
      * Unlike `executeAll`, this method does NOT throw on effect errors.
      * Instead, it captures errors in the returned `EffectResult[]` array.
      */
-    executeWithResults(effects: unknown[]): Promise<EffectResult[]>;
+    executeWithResults(effects: RuntimeValue[]): Promise<EffectResult[]>;
     private extractEmitConfig;
     /** Build the source metadata stamp for an emit fired from this trait. */
     private sourceStamp;

package/dist/index.js

@@ -1,10 +1,10 @@
-import { EffectExecutor } from './chunk-WSNZNXZE.js';
-export { EffectExecutor, EventBus, HANDLER_MANIFEST, InMemoryPersistence, MockPersistenceAdapter, StateMachineManager, TickScheduler, buildEmitsFromTraits, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, createInitialTraitState, createMockPersistence, createTestExecutor, createTickScheduler, createUnifiedLoader, findInitialState, findTransition, formatPayloadValidationError, getIsolatedCollectionName, getNamespacedEvent, isBrowser, isElectron, isNamespacedEvent, isNode, isValidDurationString, normalizeCallSiteConfigToValues, normalizeEventKey, parseDurationString, parseNamespacedEvent, preprocessSchema, processEvent, validateEventPayload, validatePayloadShapes } from './chunk-WSNZNXZE.js';
+import { EffectExecutor } from './chunk-QY5EUGR2.js';
+export { EffectExecutor, EventBus, HANDLER_MANIFEST, InMemoryPersistence, MockPersistenceAdapter, StateMachineManager, TickScheduler, buildEmitsFromTraits, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, createInitialTraitState, createMockPersistence, createTestExecutor, createTickScheduler, createUnifiedLoader, findInitialState, findTransition, formatPayloadValidationError, getIsolatedCollectionName, getNamespacedEvent, isBrowser, isElectron, isNamespacedEvent, isNode, isValidDurationString, normalizeCallSiteConfigToValues, normalizeEventKey, parseDurationString, parseNamespacedEvent, preprocessSchema, processEvent, validateEventPayload, validatePayloadShapes } from './chunk-QY5EUGR2.js';
 export { cronMatches, cronMinuteKey, isValidCronExpression, parseCron, parseCronField } from './chunk-OU3ITB5S.js';
 import { createContextFromBindings, applyRowAccess, checkMutationAccess, accessDeniedMessage } from './chunk-ZJ62H3ES.js';
 export { CALLSITE_PAYLOAD_PREFIX, applyRowAccess, checkMutationAccess, containsBindings, createContextFromBindings, createMinimalContext, deferEntityBindings, extractBindings, interpolateProps, interpolateValue, resolveCallSitePayloadCaptures } from './chunk-ZJ62H3ES.js';
 import './chunk-T4VDAB4C.js';
-export { PERF_NAMESPACE, RendererContractViolationError, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfStart, perfStore, perfTime, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent } from './chunk-FOFLEZRJ.js';
+export { PERF_NAMESPACE, RendererContractViolationError, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfGauge, perfStart, perfStore, perfTime, perfTimeAsync, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent } from './chunk-F5W3YZGJ.js';
 export { collectEmbeddedTraits, collectTraitRefsFromResolvedTrait } from './chunk-SCRAHWOC.js';
 import { __export } from './chunk-MLKGABMK.js';
 import { createLogger } from '@almadar/logger';
@@ -416,6 +416,7 @@ function createServerEffectHandlers(opts) {
           data: resultData,
           success: true
         });
+        return resultData;
       } catch (err) {
         effectLog.error("persist:store-mutate-error", {
           action,
@@ -430,6 +431,7 @@ function createServerEffectHandlers(opts) {
           error: err instanceof Error ? err.message : String(err)
         });
       }
+      return void 0;
     },
     callService: async (service, action, params) => {
       try {

package/dist/{types-TwQ8Dybu.d.ts → types-BaD_ox7e.d.ts}

@@ -1,5 +1,5 @@
 import * as _almadar_core from '@almadar/core';
-import { TraitId, EventId, SExpr, TraitEventListener, AgentContext, LlmContext, WorkspaceContext, SessionContext, MemoryContext, TraceContext, IntegrationContext, TraitConfig, EventPayload, BusEvent, EntityRow, FieldValue, ServiceParams, FetchResult, PatternConfig, ResolvedPatternProps, Orbital, ServiceCallResult, BusEventSource, BusEventListener, Unsubscribe as Unsubscribe$1, UserContext, NavItem } from '@almadar/core';
+import { TraitId, EventId, SExpr, TraitEventListener, AgentContext, LlmContext, WorkspaceContext, SessionContext, MemoryContext, TraceContext, IntegrationContext, TraitConfig, EventPayload, BusEvent, EntityRow, FieldValue, ServiceParams, FetchResult, PatternConfig, ResolvedPatternProps, Orbital, ServiceCallResult, BusEventSource, BusEventListener, Unsubscribe as Unsubscribe$1, UserContext, NavItem, RuntimeValue } from '@almadar/core';
 
 /** Alias for ResolvedPatternProps to avoid breaking internal consumers */
 type PatternProps = ResolvedPatternProps;
@@ -149,8 +149,19 @@ interface EffectHandlers {
      * `fetch` success envelopes, cascade re-emits).
      */
     emit: (event: string, payload?: EventPayload, source?: RuntimeEvent['source'], fromPersistSuccess?: boolean) => void;
-    /** Persist data (create/update/delete/batch) */
-    persist: (action: 'create' | 'update' | 'delete' | 'batch', entityType: string, data?: EntityRow) => Promise<void>;
+    /**
+     * Persist data (create/update/delete/batch).
+     *
+     * Returns the persisted ROW — for a create that is the submitted data
+     * plus the store-minted `id`, which the caller's `emit:{success}`
+     * envelope carries. Without it a `*_CREATED` listener sees no id (the
+     * compiled path emits the created row), so anything routing on the new
+     * row's identity — navigating to the page just created — worked in one
+     * execution path only. Implementations that have no row to hand back
+     * (batch, a denied write, a no-op stub) return undefined and the
+     * envelope falls back to the submitted data.
+     */
+    persist: (action: 'create' | 'update' | 'delete' | 'batch', entityType: string, data?: EntityRow) => Promise<EntityRow | undefined>;
     /** Set a field value on an entity */
     set: (entityId: string, field: string, value: FieldValue) => void;
     /** Call an external service. `context` carries the caller's identity
@@ -371,7 +382,7 @@ interface BindingContext {
      * a `let` body's effects resolve their value expressions against the
      * `let`-bound locals.
      */
-    locals?: Map<string, unknown>;
+    locals?: Map<string, RuntimeValue>;
     /** Additional custom bindings */
     [key: string]: unknown;
 }

package/dist/ui/index.d.ts

@@ -339,6 +339,10 @@ declare function perfStart(name: string): number;
 declare function perfEnd(name: string, startToken: number, detail?: PerfDetail): void;
 /** Synchronous wrapper that times a fn end-to-end. */
 declare function perfTime<T>(name: string, fn: () => T, detail?: PerfDetail): T;
+/** Async wrapper — the tick/effect paths are async end-to-end. */
+declare function perfTimeAsync<T>(name: string, fn: () => Promise<T> | T): Promise<T>;
+/** Record a non-duration scalar (queue depth, entries/pass) into the summary. */
+declare function perfGauge(name: string, value: number): void;
 declare function getSnapshot(): readonly PerfEntry[];
 declare function subscribe(fn: () => void): () => void;
 /** Push a pre-computed entry (e.g. React.Profiler callback). */
@@ -416,4 +420,4 @@ declare function bindEventBus(eventBus: VerificationBus): void;
  */
 declare function bindTraitStateGetter(getter: (traitName: string) => string | undefined): void;
 
-export { type MultiSourceSlotManager, PERF_NAMESPACE, type PerfDetail, type PerfDetailValue, type PerfEntry, type PreparedPreviewSchema, RendererContractViolationError, type ResolvedPageTraits, type SlotContent, type SlotContentValidationError, type SlotManager, type SlotSource, type VerificationBus, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, collectEmbeddedTraits, collectTraitRefsFromResolvedTrait, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfStart, perfStore, perfTime, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent };
+export { type MultiSourceSlotManager, PERF_NAMESPACE, type PerfDetail, type PerfDetailValue, type PerfEntry, type PreparedPreviewSchema, RendererContractViolationError, type ResolvedPageTraits, type SlotContent, type SlotContentValidationError, type SlotManager, type SlotSource, type VerificationBus, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, collectEmbeddedTraits, collectTraitRefsFromResolvedTrait, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfGauge, perfStart, perfStore, perfTime, perfTimeAsync, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent };

package/dist/ui/index.js

@@ -1,3 +1,3 @@
-export { PERF_NAMESPACE, RendererContractViolationError, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfStart, perfStore, perfTime, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent } from '../chunk-FOFLEZRJ.js';
+export { PERF_NAMESPACE, RendererContractViolationError, adjustSchemaForMockData, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, buildMockData, buildOrbitalsByTrait, clearPerf, createSlotSetter, ensureVerificationApi, getOrbitalVerification, perfEnd, perfGauge, perfStart, perfStore, perfTime, perfTimeAsync, prepareSchemaForPreview, pushPerfEntry, validateSlotContent, wrapCallbackForEvent } from '../chunk-F5W3YZGJ.js';
 export { collectEmbeddedTraits, collectTraitRefsFromResolvedTrait } from '../chunk-SCRAHWOC.js';
 import '../chunk-MLKGABMK.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/runtime",
-  "version": "6.59.0",
+  "version": "6.61.0",
   "description": "Interpreted runtime for Almadar orbital applications (OrbitalServerRuntime)",
   "type": "module",
   "main": "./dist/index.js",
@@ -57,11 +57,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^10.68.0",
-    "@almadar/evaluator": "^2.41.0",
+    "@almadar/core": "^10.70.0",
+    "@almadar/evaluator": "^2.42.0",
     "@almadar/logger": "^1.11.0",
-    "@almadar/server": "^2.37.0",
-    "@almadar/std": "^16.184.0"
+    "@almadar/server": "^2.38.0",
+    "@almadar/std": "^16.186.0"
   },
   "peerDependencies": {
     "express": "^5.0.0"