@almadar/runtime 6.57.0 → 6.59.0

package/dist/{OrbitalServerRuntime-CgDV0DwN.d.ts → OrbitalServerRuntime-PI9Ioxdp.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-D20NPs1X.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-TwQ8Dybu.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-CgDV0DwN.js';
-import './types-D20NPs1X.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-PI9Ioxdp.js';
+import './types-TwQ8Dybu.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-WSNZNXZE.js';
+export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-WSNZNXZE.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);
@@ -1522,7 +1564,8 @@ var OrbitalServerRuntime = class {
             result = await this.config.effectHandlers.callService(
               service,
               action,
-              params
+              params,
+              user ? { principal: user.id, role: user.role } : void 0
             );
           } else if (this.config.mode === "mock") {
             const mockId = `mock_${service}_${action}_${Math.random().toString(36).slice(2, 10)}`;

package/dist/ServerBridge.d.ts

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

package/dist/{chunk-MMVKKLAP.js → chunk-WSNZNXZE.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;
       }
     }
   }

package/dist/createOsHandlers.d.ts

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

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-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, T as TraitDefinition } from './types-D20NPs1X.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-D20NPs1X.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-CgDV0DwN.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-CgDV0DwN.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-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 { 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';
@@ -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
  */
@@ -803,7 +808,7 @@ interface CreateServerEffectHandlersOptions {
         trait?: string;
     };
     /** Consumer-supplied `call-service` handler. When absent, calls warn and return null. */
-    callService?: (service: string, action: string, params?: ServiceParams) => Promise<EventPayload | null>;
+    callService?: (service: string, action: string, params?: ServiceParams, context?: ServiceCallContext) => Promise<EventPayload | null>;
     /**
      * The declared `@read`/`@create`/`@update`/`@delete` directives, keyed by
      * entity name. Build it with `entityAccessTable(schema)` from `@almadar/core`.

package/dist/index.js

@@ -1,5 +1,5 @@
-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-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';
 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';
@@ -435,7 +435,13 @@ function createServerEffectHandlers(opts) {
       try {
         let result = null;
         if (consumerCallService) {
-          result = await consumerCallService(service, action, params);
+          const viewer = bindings?.user;
+          result = await consumerCallService(
+            service,
+            action,
+            params,
+            viewer ? { principal: viewer.id, role: viewer.role } : void 0
+          );
         } else {
           const mockId = `mock_${service}_${action}_${Math.random().toString(36).slice(2, 10)}`;
           const paramsEcho = {};

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

@@ -121,6 +121,16 @@ interface TraitDefinition {
  * Client: React hooks, DOM, router
  * Server: Express, database, integrators
  */
+/**
+ * Caller identity forwarded with a call-service dispatch (I-25) — the id and
+ * roster role of the SAME normalized viewer entity ACL enforces against.
+ * Absent when no viewer is bound (ticks, anonymous); role-gated services
+ * fail closed on absence.
+ */
+interface ServiceCallContext {
+    principal?: string;
+    role?: string;
+}
 interface EffectHandlers {
     /**
      * Emit an event to the event bus.
@@ -143,8 +153,10 @@ interface EffectHandlers {
     persist: (action: 'create' | 'update' | 'delete' | 'batch', entityType: string, data?: EntityRow) => Promise<void>;
     /** Set a field value on an entity */
     set: (entityId: string, field: string, value: FieldValue) => void;
-    /** Call an external service */
-    callService: (service: string, action: string, params?: ServiceParams) => Promise<EventPayload | null>;
+    /** Call an external service. `context` carries the caller's identity
+     * (the same viewer entity ACL enforces against) so role-gated services
+     * can enforce server-side; hosts forward it to the integration factory. */
+    callService: (service: string, action: string, params?: ServiceParams, context?: ServiceCallContext) => Promise<EventPayload | null>;
     /** Fetch entity data (server only) - returns data for client-side rendering.
      *
      * Always returns a `FetchResult` (`{rows, total}`) on success. `total`
@@ -489,4 +501,4 @@ interface TransitionObserver {
  */
 declare const HANDLER_MANIFEST: Record<ExecutionEnvironment, string[]>;
 
-export { type BindingContext as B, type ConfigContext as C, type EffectHandlers as E, HANDLER_MANIFEST as H, type IEventBus as I, type PatternProps as P, type RuntimeEvent as R, type TraitDefinition as T, type Unsubscribe as U, type EventListener as a, type RuntimeConfig as b, type TransitionObserver as c, type TraitState as d, type TransitionResult as e, type EvaluationContextExtensions as f, type RuntimePatternValue as g, type EffectContext as h, type ExecutionEnvironment as i, type EffectResult as j, type BrowserFileMeta as k, type BrowserFilePickerOptions as l, type BrowserGeolocationOptions as m, type BrowserGeolocationPosition as n, type Effect as o };
+export { type BindingContext as B, type ConfigContext as C, type EffectHandlers as E, HANDLER_MANIFEST as H, type IEventBus as I, type PatternProps as P, type RuntimeEvent as R, type ServiceCallContext as S, type TraitDefinition as T, type Unsubscribe as U, type EventListener as a, type RuntimeConfig as b, type TransitionObserver as c, type TraitState as d, type TransitionResult as e, type EvaluationContextExtensions as f, type RuntimePatternValue as g, type EffectContext as h, type ExecutionEnvironment as i, type EffectResult as j, type BrowserFileMeta as k, type BrowserFilePickerOptions as l, type BrowserGeolocationOptions as m, type BrowserGeolocationPosition as n, type Effect as o };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/runtime",
-  "version": "6.57.0",
+  "version": "6.59.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.66.0",
+    "@almadar/core": "^10.68.0",
     "@almadar/evaluator": "^2.41.0",
     "@almadar/logger": "^1.11.0",
-    "@almadar/server": "^2.36.0",
-    "@almadar/std": "^16.182.0"
+    "@almadar/server": "^2.37.0",
+    "@almadar/std": "^16.184.0"
   },
   "peerDependencies": {
     "express": "^5.0.0"