@almadar/runtime 6.34.0 → 6.36.0

package/dist/{OrbitalServerRuntime-BrHSXDfp.d.ts → OrbitalServerRuntime-IMGtH9rA.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-C8RsO0xa.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-BAD9bSMA.js';
 import { EventPayload, EventId, EntityRow, Orbital, ServiceCallResult, TraitConfig, DeclaredTraitConfig, Entity, OrbitalSchema, Trait, PatternConfig, ResolvedPatternProps, SExpr, BusEventSource, OrbitalDefinition, TraitTick } from '@almadar/core';
 
 /**
@@ -308,7 +308,7 @@ declare class StateMachineManager {
      *
      * @returns Array of transition results (one per trait that had a matching transition)
      */
-    sendEvent(eventKey: string, payload?: EventPayload, entityData?: EntityRow, entityByTrait?: Record<string, EntityRow>, eventId?: EventId): Array<{
+    sendEvent(eventKey: string, payload?: EventPayload, entityData?: EntityRow, entityByTrait?: Record<string, EntityRow>, eventId?: EventId, targetTrait?: string): Array<{
         traitName: string;
         result: TransitionResult;
     }>;
@@ -945,6 +945,13 @@ interface OrbitalEventRequest {
     eventId?: EventId;
     payload?: EventPayload;
     entityId?: string;
+    /**
+     * Scoped-listen delivery: dispatch to THIS trait only. A listens-matched
+     * trigger is addressed to the listening trait; without this, a trigger
+     * renamed to INIT broadcast orbital-wide and re-ran every trait's
+     * initializer (R-SCOPED-LISTEN-INIT-RENAME-FREEZE re-fire cascade).
+     */
+    targetTrait?: string;
     /** User context for @user bindings (from Firebase auth) */
     user?: {
         uid: string;
@@ -952,6 +959,22 @@ interface OrbitalEventRequest {
         displayName?: string;
         [key: string]: unknown;
     };
+    /** Per-tab client identity (UUID) — excludes this request's origin from live-broadcast delivery. */
+    clientId?: string;
+}
+/**
+ * One persist-envelope success emit, handed to the live-broadcast sink
+ * (`setLiveBroadcastSink`). Fired only from the `persist` effect's
+ * `emit:{success}` envelope (batch and single-op) — never from the generic
+ * emit funnel — so transport layers can fan it out to every OTHER
+ * connected client without matching on event names.
+ */
+interface LiveBroadcastItem {
+    event: string;
+    payload?: EventPayload;
+    source: BusEventSource;
+    /** `clientId` of the request that produced this emit; excluded from delivery by the transport. */
+    originClientId?: string;
 }
 /**
  * Response from event processing
@@ -1097,6 +1120,8 @@ declare class OrbitalServerRuntime {
     private substrateHandlers;
     private substrateHandlersPromise;
     private resolvedSchema;
+    /** Wired by the hosting server (e.g. the playground SSE endpoint) via `setLiveBroadcastSink`. */
+    private liveBroadcastSink;
     /**
      * Trait name -> resolved `TraitConfig`, computed once per `register()` via
      * `buildResolvedTraitConfigs` (`@almadar/core`). An embedded sub-trait's
@@ -1266,6 +1291,14 @@ declare class OrbitalServerRuntime {
      * layer is not MockPersistenceAdapter.
      */
     resetMockPersistence(): void;
+    /**
+     * Wire a live-broadcast sink. Called only from a `persist` effect's
+     * `emit:{success}` envelope firing site (batch and single-op) — see
+     * `docs/Almadar_Live_Push.md`. The hosting server (e.g. the playground's
+     * `/api/events` SSE endpoint) uses this to fan persist mutations out to
+     * every OTHER connected client; a fresh call replaces the previous sink.
+     */
+    setLiveBroadcastSink(sink: (item: LiveBroadcastItem) => void): void;
     /**
      * Process an event for an orbital
      *
@@ -1355,4 +1388,4 @@ declare class OrbitalServerRuntime {
  */
 declare function createOrbitalServerRuntime(config?: OrbitalServerRuntimeConfig): OrbitalServerRuntime;
 
-export { normalizeEventKey as A, parseNamespacedEvent as B, preprocessSchema as C, processEvent as D, type EntitySharingMap as E, type ClientEffectTuple as F, type ClientNavigateTuple as G, type ClientNotifyTuple as H, type ImportChainLike as I, type ClientRenderUITuple as J, type EffectResult as K, type LoadResult as L, type LoaderConfig as M, OrbitalServerRuntime as N, type OrbitalEventRequest as O, type PersistenceAdapter as P, type RuntimeTraitTick as Q, type RegisteredOrbital as R, type SchemaLoader as S, createOrbitalServerRuntime as T, type UnifiedLoaderOptions as U, type LoadedSchema as a, type LoadedOrbital as b, EventBus as c, type EventNamespaceMap as d, InMemoryPersistence as e, type OrbitalEventResponse as f, type OrbitalServerRuntimeConfig as g, type PreprocessOptions as h, type PreprocessResult as i, type PreprocessedSchema as j, type ProcessEventOptions as k, type RuntimeOrbital as l, type RuntimeOrbitalSchema as m, type RuntimeTrait as n, StateMachineManager as o, collectDeclaredConfigDefaults as p, collectDeclaredEntityDefaults as q, createInitialTraitState as r, findInitialState as s, findTransition as t, getIsolatedCollectionName as u, getNamespacedEvent as v, isBrowser as w, isElectron as x, isNamespacedEvent as y, isNode as z };
+export { normalizeEventKey as A, parseNamespacedEvent as B, preprocessSchema as C, processEvent as D, type EntitySharingMap as E, type ClientEffectTuple as F, type ClientNavigateTuple as G, type ClientNotifyTuple as H, type ImportChainLike as I, type ClientRenderUITuple as J, type EffectResult as K, type LoadResult as L, type LiveBroadcastItem as M, type LoaderConfig as N, type OrbitalEventRequest as O, type PersistenceAdapter as P, OrbitalServerRuntime as Q, type RegisteredOrbital as R, type SchemaLoader as S, type RuntimeTraitTick as T, type UnifiedLoaderOptions as U, createOrbitalServerRuntime as V, type LoadedSchema as a, type LoadedOrbital as b, EventBus as c, type EventNamespaceMap as d, InMemoryPersistence as e, type OrbitalEventResponse as f, type OrbitalServerRuntimeConfig as g, type PreprocessOptions as h, type PreprocessResult as i, type PreprocessedSchema as j, type ProcessEventOptions as k, type RuntimeOrbital as l, type RuntimeOrbitalSchema as m, type RuntimeTrait as n, StateMachineManager as o, collectDeclaredConfigDefaults as p, collectDeclaredEntityDefaults as q, createInitialTraitState as r, findInitialState as s, findTransition as t, getIsolatedCollectionName as u, getNamespacedEvent as v, isBrowser as w, isElectron as x, isNamespacedEvent as y, isNode as z };

package/dist/OrbitalServerRuntime.d.ts

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

package/dist/OrbitalServerRuntime.js

@@ -1,5 +1,5 @@
-import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, normalizeCallSiteConfigToValues, StateMachineManager, parseDurationString, createContextFromBindings, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, resolveCallSitePayloadCaptures, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-TRA44DDY.js';
-export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-TRA44DDY.js';
+import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, normalizeCallSiteConfigToValues, StateMachineManager, parseDurationString, createContextFromBindings, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, resolveCallSitePayloadCaptures, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-5XS7DD4H.js';
+export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-5XS7DD4H.js';
 import { isValidCronExpression } from './chunk-OU3ITB5S.js';
 import './chunk-OQJIK6PZ.js';
 import './chunk-SCRAHWOC.js';
@@ -7,7 +7,7 @@ import './chunk-MLKGABMK.js';
 import { createLogger } from '@almadar/logger';
 import * as nodeModule from 'module';
 import { evaluateGuard, evaluate } from '@almadar/evaluator';
-import { buildResolvedTraitConfigs, isInlineTrait, isEntityCall } from '@almadar/core';
+import { buildResolvedTraitConfigs, isInlineTrait, isEntityCall, applyListenPayloadMapping } from '@almadar/core';
 
 // src/identity/routing.ts
 function eventRouteKey(eventName, eventId) {
@@ -97,6 +97,8 @@ var OrbitalServerRuntime = class {
   substrateHandlers = null;
   substrateHandlersPromise = null;
   resolvedSchema = null;
+  /** Wired by the hosting server (e.g. the playground SSE endpoint) via `setLiveBroadcastSink`. */
+  liveBroadcastSink = null;
   /**
    * Trait name -> resolved `TraitConfig`, computed once per `register()` via
    * `buildResolvedTraitConfigs` (`@almadar/core`). An embedded sub-trait's
@@ -614,20 +616,10 @@ var OrbitalServerRuntime = class {
                 sourceTrait: event.source?.trait ?? "?"
               }));
             }
-            let mappedPayload = event.payload;
-            if (listener.payloadMapping && event.payload) {
-              mappedPayload = {};
-              for (const [key, expr] of Object.entries(
-                listener.payloadMapping
-              )) {
-                if (typeof expr === "string" && expr.startsWith("@payload.")) {
-                  const field = expr.slice("@payload.".length);
-                  mappedPayload[key] = event.payload[field];
-                } else {
-                  mappedPayload[key] = expr;
-                }
-              }
-            }
+            const mappedPayload = applyListenPayloadMapping(
+              listener.payloadMapping,
+              event.payload
+            );
             const raw = event.payload;
             const mapped = mappedPayload;
             const pickId = (field) => mapped?.[field] ?? raw?.[field];
@@ -636,7 +628,8 @@ var OrbitalServerRuntime = class {
               event: listener.triggers,
               eventId: listener.triggersId,
               payload: mappedPayload,
-              entityId: forwardedEntityId
+              entityId: forwardedEntityId,
+              targetTrait: trait.name
             });
           });
           this.listenerCleanups.push(cleanup);
@@ -844,6 +837,16 @@ var OrbitalServerRuntime = class {
       }
     }
   }
+  /**
+   * Wire a live-broadcast sink. Called only from a `persist` effect's
+   * `emit:{success}` envelope firing site (batch and single-op) — see
+   * `docs/Almadar_Live_Push.md`. The hosting server (e.g. the playground's
+   * `/api/events` SSE endpoint) uses this to fan persist mutations out to
+   * every OTHER connected client; a fresh call replaces the previous sink.
+   */
+  setLiveBroadcastSink(sink) {
+    this.liveBroadcastSink = sink;
+  }
   // ==========================================================================
   // Event Processing
   // ==========================================================================
@@ -899,7 +902,8 @@ var OrbitalServerRuntime = class {
           request.payload?.["_activeTraits"] ?? null
         )
       }));
-      const { event, eventId, payload, entityId, user } = request;
+      const { event, eventId, payload, entityId, user, clientId } = request;
+      const targetTrait = request.targetTrait ?? payload?.["_targetTrait"];
       const validationFailures = [];
       for (const trait of registered.traits) {
         const eventSchema = trait.stateMachine?.events?.find((e) => e.key === event);
@@ -927,6 +931,7 @@ var OrbitalServerRuntime = class {
       const cleanPayload = payload ? { ...payload } : void 0;
       if (cleanPayload) {
         delete cleanPayload._activeTraits;
+        delete cleanPayload._targetTrait;
       }
       let entityData = {};
       if (entityId) {
@@ -949,7 +954,8 @@ var OrbitalServerRuntime = class {
         cleanPayload,
         entityData,
         entityByTrait,
-        eventId
+        eventId,
+        targetTrait
       );
       const filteredResults = activeTraits && activeTraits.length > 0 ? results.filter(({ traitName }) => activeTraits.includes(traitName)) : results;
       if (this.config.debug && activeTraits) {
@@ -974,7 +980,8 @@ var OrbitalServerRuntime = class {
             effectResults,
             user,
             clientEffectsByTrait,
-            onPush
+            onPush,
+            clientId
           );
         }
       }
@@ -1018,7 +1025,7 @@ var OrbitalServerRuntime = class {
   /**
    * Execute effects from a transition
    */
-  async executeEffects(registered, traitName, effects, payload, entityData, entityId, emittedEvents, fetchedData, clientEffects, effectResults, user, clientEffectsByTrait, onPush) {
+  async executeEffects(registered, traitName, effects, payload, entityData, entityId, emittedEvents, fetchedData, clientEffects, effectResults, user, clientEffectsByTrait, onPush, originClientId) {
     const entityType = registered.entity.name;
     const pushClientEffect = (effect) => {
       clientEffects.push(effect);
@@ -1028,7 +1035,7 @@ var OrbitalServerRuntime = class {
     let bindingsRef = null;
     let contextRef = null;
     const handlers = {
-      emit: (event, eventPayload, source) => {
+      emit: (event, eventPayload, source, fromPersistSuccess) => {
         if (this.config.debug) {
           busLog.debug("emit:dispatch", () => ({
             event,
@@ -1068,6 +1075,16 @@ var OrbitalServerRuntime = class {
           sourceTrait: stamp.trait,
           dispatchOrbital: registered.schema.name
         });
+        if (fromPersistSuccess) {
+          busLog.debug("live-broadcast:sink-call", {
+            event,
+            sourceOrbital: stamp.orbital,
+            sourceTrait: stamp.trait,
+            originClientId,
+            sinkWired: this.liveBroadcastSink !== null
+          });
+          this.liveBroadcastSink?.({ event, payload: eventPayload, source: stamp, originClientId });
+        }
       },
       set: async (targetId, field, value) => {
         let fieldState = registered.traitFieldStates.get(traitName);

package/dist/ServerBridge.d.ts

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

package/dist/{chunk-TRA44DDY.js → chunk-5XS7DD4H.js}

@@ -956,10 +956,11 @@ var StateMachineManager = class {
    *
    * @returns Array of transition results (one per trait that had a matching transition)
    */
-  sendEvent(eventKey, payload, entityData, entityByTrait, eventId) {
+  sendEvent(eventKey, payload, entityData, entityByTrait, eventId, targetTrait) {
     const results = [];
     const scope = scopeOf(entityData);
     for (const [traitName, trait] of this.traits) {
+      if (targetTrait !== void 0 && traitName !== targetTrait) continue;
       const traitState = this.getOrInitState(traitName, scope);
       if (!traitState) continue;
       const key = compositeKey(traitName, scope);
@@ -1431,10 +1432,10 @@ var EffectExecutor = class _EffectExecutor {
       transition: this.context.transition
     };
   }
-  emitSuccess(emit, key, payload) {
+  emitSuccess(emit, key, payload, fromPersistSuccess) {
     const eventName = emit?.[key];
     if (eventName) {
-      this.handlers.emit(eventName, payload, this.sourceStamp());
+      this.handlers.emit(eventName, payload, this.sourceStamp(), fromPersistSuccess);
     }
   }
   emitFailure(emit, err) {
@@ -1570,7 +1571,7 @@ var EffectExecutor = class _EffectExecutor {
               opCount: operations.length,
               willEmit: emitCfg?.success
             });
-            this.emitSuccess(emitCfg, "success", operations);
+            this.emitSuccess(emitCfg, "success", operations, true);
             persistLog.debug("persist:emit-fired", { action, eventName: emitCfg?.success });
           } else {
             const entityType = args[1];
@@ -1583,7 +1584,7 @@ var EffectExecutor = class _EffectExecutor {
               dataId,
               willEmit: emitCfg?.success
             });
-            this.emitSuccess(emitCfg, "success", data);
+            this.emitSuccess(emitCfg, "success", data, true);
             persistLog.debug("persist:emit-fired", { action, eventName: emitCfg?.success });
           }
         } catch (err) {
@@ -3862,10 +3863,13 @@ function resolveConfigRefsById(trait, idIndex) {
     const entry = idIndex.get(field.refId);
     if (!entry || entry.kind !== expectedKind) continue;
     const currentName = entry.kind === "entity" ? entry.node.name : entry.kind === "event" ? entry.node.key : entry.node.name;
-    if (!currentName || currentName === field.default) continue;
+    if (!currentName) continue;
+    const isTraitBinding = entry.kind === "trait" && typeof field.default === "string" && field.default.startsWith("@trait.");
+    const nextDefault = isTraitBinding ? `@trait.${currentName}` : currentName;
+    if (nextDefault === field.default) continue;
     nextSchema ??= { ...schema };
-    nextSchema[key] = { ...field, default: currentName };
-    rewrites.push({ key, from: field.default, to: currentName });
+    nextSchema[key] = { ...field, default: nextDefault };
+    rewrites.push({ key, from: field.default, to: nextDefault });
   }
   if (!nextSchema) return trait;
   refResolverLog.info("config-ref:id-resolve", {

package/dist/createOsHandlers.d.ts

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

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { B as BindingContext, f as EvaluationContextExtensions, P as PatternProps, E as EffectHandlers, g as EffectContext, h as ExecutionEnvironment, i as EffectResult, T as TraitDefinition } from './types-C8RsO0xa.js';
-export { j as BrowserFileMeta, k as BrowserFilePickerOptions, l as BrowserGeolocationOptions, m as BrowserGeolocationPosition, C as ConfigContext, n 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-C8RsO0xa.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-BrHSXDfp.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-BrHSXDfp.js';
+import { B as BindingContext, f as EvaluationContextExtensions, P as PatternProps, E as EffectHandlers, g as EffectContext, h as ExecutionEnvironment, i as EffectResult, T as TraitDefinition } from './types-BAD9bSMA.js';
+export { j as BrowserFileMeta, k as BrowserFilePickerOptions, l as BrowserGeolocationOptions, m as BrowserGeolocationPosition, C as ConfigContext, n 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-BAD9bSMA.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-IMGtH9rA.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-IMGtH9rA.js';
 import { EvaluationContext, SExpressionEvaluator } from '@almadar/evaluator';
 export { EvaluationContext, createMinimalContext } from '@almadar/evaluator';
 import { TraitConfigObject, EventPayload, PatternConfig, EntityId, EntityField, EntityRow, ServiceParams, PayloadField, OrbitalDefinition, OrbitalSchema } from '@almadar/core';

package/dist/index.js

@@ -1,5 +1,5 @@
-import { EffectExecutor, createContextFromBindings } from './chunk-TRA44DDY.js';
-export { CALLSITE_PAYLOAD_PREFIX, EffectExecutor, EventBus, HANDLER_MANIFEST, InMemoryPersistence, MockPersistenceAdapter, StateMachineManager, TickScheduler, buildEmitsFromTraits, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, containsBindings, createContextFromBindings, createInitialTraitState, createMinimalContext, createMockPersistence, createTestExecutor, createTickScheduler, createUnifiedLoader, extractBindings, findInitialState, findTransition, formatPayloadValidationError, getIsolatedCollectionName, getNamespacedEvent, interpolateProps, interpolateValue, isBrowser, isElectron, isNamespacedEvent, isNode, isValidDurationString, normalizeCallSiteConfigToValues, normalizeEventKey, parseDurationString, parseNamespacedEvent, preprocessSchema, processEvent, resolveCallSitePayloadCaptures, validateEventPayload, validatePayloadShapes } from './chunk-TRA44DDY.js';
+import { EffectExecutor, createContextFromBindings } from './chunk-5XS7DD4H.js';
+export { CALLSITE_PAYLOAD_PREFIX, EffectExecutor, EventBus, HANDLER_MANIFEST, InMemoryPersistence, MockPersistenceAdapter, StateMachineManager, TickScheduler, buildEmitsFromTraits, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, containsBindings, createContextFromBindings, createInitialTraitState, createMinimalContext, createMockPersistence, createTestExecutor, createTickScheduler, createUnifiedLoader, extractBindings, findInitialState, findTransition, formatPayloadValidationError, getIsolatedCollectionName, getNamespacedEvent, interpolateProps, interpolateValue, isBrowser, isElectron, isNamespacedEvent, isNode, isValidDurationString, normalizeCallSiteConfigToValues, normalizeEventKey, parseDurationString, parseNamespacedEvent, preprocessSchema, processEvent, resolveCallSitePayloadCaptures, validateEventPayload, validatePayloadShapes } from './chunk-5XS7DD4H.js';
 export { cronMatches, cronMinuteKey, isValidCronExpression, parseCron, parseCronField } from './chunk-OU3ITB5S.js';
 import './chunk-OQJIK6PZ.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-O5VGKPTG.js';

package/dist/{types-C8RsO0xa.d.ts → types-BAD9bSMA.d.ts}

@@ -1,5 +1,5 @@
 import * as _almadar_core from '@almadar/core';
-import { TraitId, EventId, SExpr, EventPayload, AgentContext, LlmContext, WorkspaceContext, SessionContext, MemoryContext, TraceContext, IntegrationContext, TraitConfig, BusEvent, EntityRow, FieldValue, ServiceParams, FetchResult, PatternConfig, ResolvedPatternProps, Orbital, ServiceCallResult, BusEventSource, BusEventListener, Unsubscribe as Unsubscribe$1 } from '@almadar/core';
+import { TraitId, EventId, SExpr, AgentContext, LlmContext, WorkspaceContext, SessionContext, MemoryContext, TraceContext, IntegrationContext, TraitConfig, EventPayload, BusEvent, EntityRow, FieldValue, ServiceParams, FetchResult, PatternConfig, ResolvedPatternProps, Orbital, ServiceCallResult, BusEventSource, BusEventListener, Unsubscribe as Unsubscribe$1 } from '@almadar/core';
 
 /** Alias for ResolvedPatternProps to avoid breaking internal consumers */
 type PatternProps = ResolvedPatternProps;
@@ -101,7 +101,8 @@ interface TraitDefinition {
         triggers: string;
         /** V4 dual-carry id sibling of `triggers` — optional until the Phase-7 flip. */
         triggersId?: EventId;
-        payloadMapping?: EventPayload;
+        /** `with { ... }` payload rewrite: `{ targetField: "@payload.<sourceField>" | literal }` */
+        payloadMapping?: Record<string, string>;
     }>;
 }
 /**
@@ -119,8 +120,15 @@ interface EffectHandlers {
      * `Orbital.TraitName EVENT -> TRIGGER` in .lolo) can filter incoming
      * events by their originating trait. Omitted when the emit is
      * synthesized by a non-trait context (e.g. test harness).
+     *
+     * `fromPersistSuccess` is set only by `EffectExecutor`'s `persist` case
+     * (batch and single-op), never inferred from the event name — the
+     * positional signal a server-side implementation uses to also fan this
+     * emit out to other connected clients (live-broadcast). Absent/false
+     * for every other emit source (plain `emit` effect, `set`/`call-service`/
+     * `fetch` success envelopes, cascade re-emits).
      */
-    emit: (event: string, payload?: EventPayload, source?: RuntimeEvent['source']) => void;
+    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>;
     /** Set a field value on an entity */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/runtime",
-  "version": "6.34.0",
+  "version": "6.36.0",
   "description": "Interpreted runtime for Almadar orbital applications (OrbitalServerRuntime)",
   "type": "module",
   "main": "./dist/index.js",
@@ -52,11 +52,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^10.31.0",
-    "@almadar/evaluator": "^2.31.0",
+    "@almadar/core": "^10.33.0",
+    "@almadar/evaluator": "^2.34.0",
     "@almadar/logger": "^1.9.0",
-    "@almadar/server": "^2.25.0",
-    "@almadar/std": "^16.141.0"
+    "@almadar/server": "^2.26.1",
+    "@almadar/std": "^16.143.0"
   },
   "peerDependencies": {
     "express": "^5.0.0"
@@ -67,7 +67,7 @@
     }
   },
   "devDependencies": {
-    "@almadar/eslint-plugin": "^2.14.0",
+    "@almadar/eslint-plugin": "^2.15.0",
     "@types/express": "^5.0.0",
     "@types/node": "^20.0.0",
     "@typescript-eslint/parser": "8.56.0",