@almadar/runtime 6.58.0 → 6.60.0

package/dist/{OrbitalServerRuntime-Dn9dIwJk.d.ts → OrbitalServerRuntime-Cvw0CUfG.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';
 
 /**
@@ -974,6 +974,16 @@ interface OrbitalEventRequest {
     user?: RawUserClaims;
     /** Per-tab client identity (UUID) — excludes this request's origin from live-broadcast delivery. */
     clientId?: string;
+    /**
+     * Broadcast-class marker (T6, docs/Almadar_Tick_Loop.md §3a): the name of
+     * the tick that emitted this event. Tick-stamped dispatches are
+     * latest-state broadcasts — the client fires them without awaiting the
+     * response, and the server relays them to OTHER tabs coalesced
+     * (newest-per-key) at a snapshot rate instead of 1:1.
+     */
+    tick?: string;
+    /** Emitting trait for a tick-stamped dispatch — builds the relay's BusEventSource (sourceless emits are dropped client-side). */
+    sourceTrait?: string;
 }
 /**
  * One persist-envelope success emit, handed to the live-broadcast sink
@@ -1072,6 +1082,12 @@ interface LoaderConfig {
 interface OrbitalServerRuntimeConfig {
     /** Enable debug logging */
     debug?: boolean;
+    /**
+     * Snapshot cadence (ms) for relaying tick-stamped broadcasts to other
+     * clients — newest-per-(client, orbital, event) wins between flushes
+     * (T6, docs/Almadar_Tick_Loop.md §3a). Default 50 (≈20Hz).
+     */
+    tickRelayIntervalMs?: number;
     /** Custom effect handlers (for integrating with your data layer) */
     effectHandlers?: Partial<EffectHandlers>;
     /** Persistence adapter for entity data */
@@ -1162,6 +1178,14 @@ declare class OrbitalServerRuntime {
     private appThemeKey;
     /** Wired by the hosting server (e.g. the playground SSE endpoint) via `setLiveBroadcastSink`. */
     private liveBroadcastSink;
+    /**
+     * Tick-broadcast relay (T6): newest pending item per
+     * (originClientId, orbital, event), flushed to the live-broadcast sink on
+     * the `tickRelayIntervalMs` cadence — other tabs get the latest position
+     * at snapshot rate, never 1:1 with emissions.
+     */
+    private readonly tickRelayPending;
+    private tickRelayTimer;
     /**
      * Trait name -> resolved `TraitConfig`, computed once per `register()` via
      * `buildResolvedTraitConfigs` (`@almadar/core`). An embedded sub-trait's
@@ -1382,6 +1406,13 @@ declare class OrbitalServerRuntime {
     setDefaultUser(user: UserContext | undefined): void;
     /** The viewer a dev host is currently presenting the app as. */
     getDefaultUser(): UserContext | undefined;
+    /**
+     * Queue a tick-stamped dispatch for coalesced snapshot relay (T6). Newest
+     * per (originClientId, orbital, event) wins between flushes — the standard
+     * netcode position-broadcast discipline.
+     */
+    private queueTickRelay;
+    private flushTickRelay;
     /**
      * The registered app's declared persona roster: the live rows of its
      * `[identity]` entity, mapped onto viewers (`Almadar_LOLO_Identity.md` §4.3).

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-Dn9dIwJk.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-Cvw0CUfG.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-MMVKKLAP.js';
-export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-MMVKKLAP.js';
+import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, normalizeCallSiteConfigToValues, StateMachineManager, parseDurationString, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-5IFHQDW2.js';
+export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-5IFHQDW2.js';
 import { isValidCronExpression } from './chunk-OU3ITB5S.js';
 import { createContextFromBindings, resolveCallSitePayloadCaptures, applyRowAccess, checkMutationAccess, accessDeniedMessage } from './chunk-ZJ62H3ES.js';
 import './chunk-T4VDAB4C.js';
@@ -137,6 +137,14 @@ var OrbitalServerRuntime = class {
   appThemeKey;
   /** Wired by the hosting server (e.g. the playground SSE endpoint) via `setLiveBroadcastSink`. */
   liveBroadcastSink = null;
+  /**
+   * Tick-broadcast relay (T6): newest pending item per
+   * (originClientId, orbital, event), flushed to the live-broadcast sink on
+   * the `tickRelayIntervalMs` cadence — other tabs get the latest position
+   * at snapshot rate, never 1:1 with emissions.
+   */
+  tickRelayPending = /* @__PURE__ */ new Map();
+  tickRelayTimer = null;
   /**
    * Trait name -> resolved `TraitConfig`, computed once per `register()` via
    * `buildResolvedTraitConfigs` (`@almadar/core`). An embedded sub-trait's
@@ -1047,6 +1055,37 @@ var OrbitalServerRuntime = class {
   getDefaultUser() {
     return this.config.defaultUser;
   }
+  /**
+   * Queue a tick-stamped dispatch for coalesced snapshot relay (T6). Newest
+   * per (originClientId, orbital, event) wins between flushes — the standard
+   * netcode position-broadcast discipline.
+   */
+  queueTickRelay(orbitalName, request) {
+    const key = `${request.clientId ?? ""}:${orbitalName}:${request.event}`;
+    this.tickRelayPending.set(key, {
+      event: request.event,
+      payload: request.payload,
+      source: { orbital: orbitalName, trait: request.sourceTrait, tick: request.tick },
+      originClientId: request.clientId
+    });
+    if (this.tickRelayTimer === null) {
+      const timer = setInterval(() => this.flushTickRelay(), this.config.tickRelayIntervalMs ?? 50);
+      if (typeof timer === "object" && typeof timer.unref === "function") timer.unref();
+      this.tickRelayTimer = timer;
+    }
+  }
+  flushTickRelay() {
+    if (this.tickRelayPending.size === 0) {
+      if (this.tickRelayTimer !== null) {
+        clearInterval(this.tickRelayTimer);
+        this.tickRelayTimer = null;
+      }
+      return;
+    }
+    const items = Array.from(this.tickRelayPending.values());
+    this.tickRelayPending.clear();
+    for (const item of items) this.liveBroadcastSink?.(item);
+  }
   /**
    * The registered app's declared persona roster: the live rows of its
    * `[identity]` entity, mapped onto viewers (`Almadar_LOLO_Identity.md` §4.3).
@@ -1252,6 +1291,9 @@ var OrbitalServerRuntime = class {
       if (effectResults.length > 0) {
         response.effectResults = effectResults;
       }
+      if (request.tick !== void 0 && this.liveBroadcastSink !== null) {
+        this.queueTickRelay(orbitalName, request);
+      }
       return response;
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
@@ -1500,6 +1542,7 @@ var OrbitalServerRuntime = class {
             data: resultData,
             success: true
           });
+          return resultData;
         } catch (err) {
           effectLog.error("persist:store-mutate-error", {
             action,
@@ -1514,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-MMVKKLAP.js → chunk-5IFHQDW2.js}

@@ -234,9 +234,9 @@ var TickScheduler = class {
       }
       tick.accumulatedMs += timestamp - tick.lastTimestamp;
       tick.lastTimestamp = timestamp;
-      while (tick.accumulatedMs >= tick.intervalMs) {
-        tick.accumulatedMs -= tick.intervalMs;
+      if (tick.accumulatedMs >= tick.intervalMs) {
         tick.onDue();
+        tick.accumulatedMs = tick.accumulatedMs % tick.intervalMs;
       }
     }
   }
@@ -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({
@@ -3616,6 +3616,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;
@@ -4148,7 +4165,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);

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/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/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-Dn9dIwJk.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-Dn9dIwJk.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-Cvw0CUfG.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-Cvw0CUfG.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';
 
@@ -146,8 +146,13 @@ declare function createUnifiedLoader(options: UnifiedLoaderOptions): UnifiedLoad
  * isn't available, e.g. Node/SSR) that walks every registered tick each pass
  * and fires whichever one(s) have crossed their own interval — so ticks due
  * in the same pass commit together instead of on independent, uncoordinated
- * timers. Framework-light: no React, usable from `OrbitalServerRuntime`
- * (this package) and from `@almadar/ui`'s `useTraitStateMachine` alike.
+ * timers. Each interval tick fires AT MOST ONCE per pass: missed beats are
+ * dropped (the phase remainder is kept, so healthy cadence is unchanged),
+ * because bursting catch-up firings after a slow pass multiplies the work
+ * that made the pass slow — an unbounded accumulator is a spiral-of-death
+ * amplifier that pegs the main thread and starves input. Framework-light:
+ * no React, usable from `OrbitalServerRuntime` (this package) and from
+ * `@almadar/ui`'s `useTraitStateMachine` alike.
  *
  * @packageDocumentation
  */
@@ -284,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
@@ -414,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.
@@ -430,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-MMVKKLAP.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-MMVKKLAP.js';
+import { EffectExecutor } from './chunk-5IFHQDW2.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-5IFHQDW2.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.58.0",
+  "version": "6.60.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.67.0",
-    "@almadar/evaluator": "^2.41.0",
+    "@almadar/core": "^10.69.0",
+    "@almadar/evaluator": "^2.42.0",
     "@almadar/logger": "^1.11.0",
-    "@almadar/server": "^2.37.0",
-    "@almadar/std": "^16.183.0"
+    "@almadar/server": "^2.38.0",
+    "@almadar/std": "^16.185.0"
   },
   "peerDependencies": {
     "express": "^5.0.0"