@almadar/runtime 6.29.0 → 6.31.0

package/dist/{OrbitalServerRuntime-BkaBvI6-.d.ts → OrbitalServerRuntime-DpAwIrmv.d.ts}

@@ -1,6 +1,6 @@
 import { Router } from 'express';
 import { I as IEventBus, g as RuntimeEvent, f as EventListener, U as Unsubscribe, T as TraitDefinition, R as RuntimeConfig, i as TransitionObserver, C as ConfigContext, h as TraitState, j as TransitionResult, E as EvaluationContextExtensions, a as EffectHandlers } from './types-D-9feVsj.js';
-import { EventPayload, EntityRow, Orbital, ServiceCallResult, TraitConfig, DeclaredTraitConfig, Entity, OrbitalSchema, Trait, PatternConfig, ResolvedPatternProps, SExpr, BusEventSource, OrbitalDefinition, TraitTick } from '@almadar/core';
+import { EventPayload, EntityRow, Orbital, ServiceCallResult, TraitConfig, DeclaredTraitConfig, Entity, CallSiteConfig, OrbitalSchema, Trait, PatternConfig, ResolvedPatternProps, SExpr, BusEventSource, OrbitalDefinition, TraitTick } from '@almadar/core';
 
 /**
  * EventBus - Platform-Agnostic Pub/Sub Implementation
@@ -358,6 +358,17 @@ interface SubstrateServices {
 declare function collectDeclaredConfigDefaults(trait: {
     config?: DeclaredTraitConfig;
 } | undefined): TraitConfig | undefined;
+/**
+ * Convert a call-site config map into plain runtime values.
+ *
+ * A `CallSiteConfig` may contain either plain wiring values
+ * (`TraitConfigValue`) or annotated `ConfigFieldDeclaration` objects
+ * (`{ type, default, label, ... }`). The runtime binding context expects
+ * only values, so this helper extracts `.default` from declarations and
+ * passes plain values through unchanged. Entries that are not recognized as
+ * declarations by `isCallSiteConfigDeclaration` are returned as-is.
+ */
+declare function normalizeCallSiteConfigToValues(config: CallSiteConfig | undefined): TraitConfig | undefined;
 /**
  * Walk an entity's `fields` array and return a flat `{ fieldName: default, … }`
  * map. Seeds the `@entity` binding context with declared field defaults before
@@ -1300,4 +1311,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 { normalizeCallSiteConfigToValues as A, normalizeEventKey as B, parseNamespacedEvent as C, preprocessSchema as D, type EntitySharingMap as E, processEvent as F, type ClientEffectTuple as G, type ClientNavigateTuple as H, type ImportChainLike as I, type ClientNotifyTuple as J, type ClientRenderUITuple as K, type LoadResult as L, type EffectResult 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-BkaBvI6-.js';
+export { G as ClientEffectTuple, H as ClientNavigateTuple, J as ClientNotifyTuple, K as ClientRenderUITuple, M as EffectResult, e as InMemoryPersistence, 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-DpAwIrmv.js';
 import './types-D-9feVsj.js';
 import '@almadar/core';

package/dist/OrbitalServerRuntime.js

@@ -1,7 +1,7 @@
-import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, normalizeCallSiteConfigToValues, StateMachineManager, parseDurationString, createContextFromBindings, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-6YDQGA6X.js';
-export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-6YDQGA6X.js';
-import { isValidCronExpression } from './chunk-U4PL237A.js';
-import './chunk-PZ5AY32C.js';
+import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, normalizeCallSiteConfigToValues, StateMachineManager, parseDurationString, createContextFromBindings, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-YFH577FH.js';
+export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-YFH577FH.js';
+import { isValidCronExpression } from './chunk-OU3ITB5S.js';
+import './chunk-MLKGABMK.js';
 import { createLogger } from '@almadar/logger';
 import * as nodeModule from 'module';
 import { evaluateGuard, evaluate } from '@almadar/evaluator';
@@ -138,7 +138,7 @@ var OrbitalServerRuntime = class {
     if (!isNodeEnv()) return;
     if (!this.substrateHandlersPromise) {
       this.substrateHandlersPromise = (async () => {
-        const { createAgentSubstrateHandlers } = await import('./createAgentSubstrateHandlers-WZCHKGU6.js');
+        const { createAgentSubstrateHandlers } = await import('./createAgentSubstrateHandlers-G6KSTJPA.js');
         this.substrateHandlers = createAgentSubstrateHandlers({
           emitEvent: (type, payload) => this.eventBus.emit(type, payload),
           services: this.config.substrateServices ?? {}
@@ -1921,5 +1921,3 @@ function buildMatcher(src, listenerOrbital) {
 }
 
 export { OrbitalServerRuntime, createOrbitalServerRuntime };
-//# sourceMappingURL=OrbitalServerRuntime.js.map
-//# sourceMappingURL=OrbitalServerRuntime.js.map

package/dist/ServerBridge.js

@@ -1,4 +1,4 @@
-import './chunk-PZ5AY32C.js';
+import './chunk-MLKGABMK.js';
 import { createLogger } from '@almadar/logger';
 
 var log = createLogger("almadar:runtime:server-bridge");
@@ -240,5 +240,3 @@ function createServerBridge(config) {
 }
 
 export { ServerBridge, createServerBridge };
-//# sourceMappingURL=ServerBridge.js.map
-//# sourceMappingURL=ServerBridge.js.map

package/dist/{chunk-PZ5AY32C.js → chunk-MLKGABMK.js}

@@ -5,5 +5,3 @@ var __export = (target, all) => {
 };
 
 export { __export };
-//# sourceMappingURL=chunk-PZ5AY32C.js.map
-//# sourceMappingURL=chunk-PZ5AY32C.js.map

package/dist/{chunk-U4PL237A.js → chunk-OU3ITB5S.js}

@@ -47,5 +47,3 @@ function cronMinuteKey(date) {
 }
 
 export { cronMatches, cronMinuteKey, isValidCronExpression, parseCron, parseCronField };
-//# sourceMappingURL=chunk-U4PL237A.js.map
-//# sourceMappingURL=chunk-U4PL237A.js.map

package/dist/{chunk-6YDQGA6X.js → chunk-YFH577FH.js}

@@ -1,4 +1,4 @@
-import { parseCron, cronMinuteKey, cronMatches } from './chunk-U4PL237A.js';
+import { parseCron, cronMinuteKey, cronMatches } from './chunk-OU3ITB5S.js';
 import { createLogger, setNamespaceLevel } from '@almadar/logger';
 import { resolveBinding, evaluate, createMinimalContext, evaluateGuard, SExpressionEvaluator } from '@almadar/evaluator';
 export { createMinimalContext } from '@almadar/evaluator';
@@ -1008,6 +1008,7 @@ var HANDLER_MANIFEST = {
 };
 var effectLog = createLogger("almadar:runtime:effects");
 setNamespaceLevel("almadar:runtime:effects", "WARN");
+var persistLog = createLogger("almadar:runtime:persist");
 function parseEffect(effect) {
   if (!Array.isArray(effect) || effect.length === 0) {
     return null;
@@ -1312,6 +1313,35 @@ var EffectExecutor = class _EffectExecutor {
       failure: emit.failure
     };
   }
+  /**
+   * Run a substrate (async) effect and dispatch the author's `emit.success`
+   * / `emit.failure` bus event when configured. Mirrors the compiled-path
+   * generic substrate dispatch (server.rs): uniform `{ result }` payload on
+   * success, `{ error }` on failure.
+   *
+   * When no `emit` config is present (fire-and-forget call) the op still runs
+   * but no event is dispatched and errors propagate (legacy behavior).
+   */
+  async runSubstrate(invoke, emitCfg) {
+    if (!emitCfg) {
+      await invoke();
+      return;
+    }
+    try {
+      const result = await invoke();
+      this.emitSuccess(emitCfg, "success", { result: result ?? null });
+    } catch (err) {
+      this.emitFailure(emitCfg, err);
+    }
+  }
+  /**
+   * Separate a trailing `{ emit: {...} }` options object from positional
+   * substrate-op args. Returns `[positionalArgs, emitConfig]`.
+   */
+  splitSubstrateEmit(args) {
+    const emitCfg = args.length > 0 ? this.extractEmitConfig(args[args.length - 1]) : void 0;
+    return emitCfg ? [args.slice(0, -1), emitCfg] : [args, void 0];
+  }
   // ==========================================================================
   // Effect Dispatch
   // ==========================================================================
@@ -1375,14 +1405,14 @@ var EffectExecutor = class _EffectExecutor {
         const action = args[0];
         const last = args[args.length - 1];
         const emitCfg = last && typeof last === "object" && !Array.isArray(last) && "emit" in last ? this.extractEmitConfig(last) : void 0;
-        effectLog.debug("persist:dispatch", {
+        persistLog.debug("persist:dispatch", {
           action,
           argCount: args.length,
           argTypes: args.map((a) => Array.isArray(a) ? "array" : a === null ? "null" : typeof a).join(","),
           traitName: this.context.traitName,
           transition: this.context.transition
         });
-        effectLog.debug("persist:emit-config", {
+        persistLog.debug("persist:emit-config", {
           action,
           hasEmitCfg: emitCfg !== void 0,
           success: emitCfg?.success,
@@ -1392,30 +1422,30 @@ var EffectExecutor = class _EffectExecutor {
           if (action === "batch") {
             const operations = args[1];
             await this.handlers.persist("batch", "", { operations });
-            effectLog.debug("persist:success", {
+            persistLog.debug("persist:success", {
               action,
               entityType: "batch",
               opCount: operations.length,
               willEmit: emitCfg?.success
             });
             this.emitSuccess(emitCfg, "success", operations);
-            effectLog.debug("persist:emit-fired", { action, eventName: emitCfg?.success });
+            persistLog.debug("persist:emit-fired", { action, eventName: emitCfg?.success });
           } 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;
-            effectLog.debug("persist:success", {
+            persistLog.debug("persist:success", {
               action,
               entityType,
               dataId,
               willEmit: emitCfg?.success
             });
             this.emitSuccess(emitCfg, "success", data);
-            effectLog.debug("persist:emit-fired", { action, eventName: emitCfg?.success });
+            persistLog.debug("persist:emit-fired", { action, eventName: emitCfg?.success });
           }
         } catch (err) {
-          effectLog.error("persist:error", {
+          persistLog.error("persist:error", {
             action,
             entityType: action === "batch" ? "batch" : args[1],
             error: err instanceof Error ? err.message : String(err)
@@ -1823,80 +1853,106 @@ var EffectExecutor = class _EffectExecutor {
         break;
       }
       // === Agent substrate operators (server-side, effect-position) ===
+      //
+      // Each honours a trailing `{ emit: { success, failure } }` options
+      // object (mirrors fetch/persist/call-service): on success the
+      // author's `emit.success` event fires with a uniform `{ result }`
+      // payload so `?result` captures the return value; on failure the
+      // `emit.failure` event fires with `{ error }`. Without an emit
+      // config the call is fire-and-forget (legacy).
       case "compose/compose-all": {
-        if (this.handlers.substrateComposeAll) {
-          const config = args[0];
-          await this.handlers.substrateComposeAll(config);
-        } else {
-          this.logUnsupported("compose/compose-all");
-        }
+        const [positional, emitCfg] = this.splitSubstrateEmit(args);
+        const config = positional[0];
+        await this.runSubstrate(async () => {
+          if (!this.handlers.substrateComposeAll) {
+            this.logUnsupported("compose/compose-all");
+            return null;
+          }
+          return this.handlers.substrateComposeAll(config);
+        }, emitCfg);
         break;
       }
       case "compose/compose-children": {
-        if (this.handlers.substrateComposeChildren) {
-          const parentName = args[0];
-          const children = args[1];
-          await this.handlers.substrateComposeChildren(parentName, children);
-        } else {
-          this.logUnsupported("compose/compose-children");
-        }
+        const [positional, emitCfg] = this.splitSubstrateEmit(args);
+        const parentName = positional[0];
+        const children = positional[1];
+        await this.runSubstrate(async () => {
+          if (!this.handlers.substrateComposeChildren) {
+            this.logUnsupported("compose/compose-children");
+            return null;
+          }
+          return this.handlers.substrateComposeChildren(parentName, children);
+        }, emitCfg);
         break;
       }
       case "behavior/instantiate": {
-        if (this.handlers.substrateInstantiate) {
-          const parentName = args[0];
-          const behavior = args[1];
-          const params = args.length > 2 ? args[2] : void 0;
-          await this.handlers.substrateInstantiate(parentName, behavior, params);
-        } else {
-          this.logUnsupported("behavior/instantiate");
-        }
+        const [positional, emitCfg] = this.splitSubstrateEmit(args);
+        const parentName = positional[0];
+        const behavior = positional[1];
+        const params = positional.length > 2 ? positional[2] : void 0;
+        await this.runSubstrate(async () => {
+          if (!this.handlers.substrateInstantiate) {
+            this.logUnsupported("behavior/instantiate");
+            return null;
+          }
+          return this.handlers.substrateInstantiate(parentName, behavior, params);
+        }, emitCfg);
         break;
       }
       case "behavior/call": {
-        if (this.handlers.substrateCall) {
-          const behavior = args[0];
-          const method = args[1];
-          const params = args.length > 2 ? args[2] : void 0;
-          await this.handlers.substrateCall(behavior, method, params);
-        } else {
-          this.logUnsupported("behavior/call");
-        }
+        const [positional, emitCfg] = this.splitSubstrateEmit(args);
+        const behavior = positional[0];
+        const method = positional[1];
+        const params = positional.length > 2 ? positional[2] : void 0;
+        await this.runSubstrate(async () => {
+          if (!this.handlers.substrateCall) {
+            this.logUnsupported("behavior/call");
+            return null;
+          }
+          return this.handlers.substrateCall(behavior, method, params);
+        }, emitCfg);
         break;
       }
       case "validate/validate": {
-        if (this.handlers.substrateValidate) {
-          const orbitalName = args[0];
-          await this.handlers.substrateValidate(orbitalName);
-        } else {
-          this.logUnsupported("validate/validate");
-        }
+        const [positional, emitCfg] = this.splitSubstrateEmit(args);
+        const orbitalName = positional[0];
+        await this.runSubstrate(async () => {
+          if (!this.handlers.substrateValidate) {
+            this.logUnsupported("validate/validate");
+            return null;
+          }
+          return this.handlers.substrateValidate(orbitalName);
+        }, emitCfg);
         break;
       }
       case "lolo/emit-body": {
-        if (this.handlers.substrateEmitBody) {
-          const orbitalName = args[0];
-          const loloSource = args[1];
-          await this.handlers.substrateEmitBody(orbitalName, loloSource);
-        } else {
-          this.logUnsupported("lolo/emit-body");
-        }
+        const [positional, emitCfg] = this.splitSubstrateEmit(args);
+        const orbitalName = positional[0];
+        const loloSource = positional[1];
+        await this.runSubstrate(async () => {
+          if (!this.handlers.substrateEmitBody) {
+            this.logUnsupported("lolo/emit-body");
+            return null;
+          }
+          return this.handlers.substrateEmitBody(orbitalName, loloSource);
+        }, emitCfg);
         break;
       }
       default: {
         if (operator.includes("/")) {
-          const ctx = createContextFromBindings(
-            this.bindings,
-            this.strictBindings,
-            this.contextExtensions
-          );
-          const result = this.getEvaluator().evaluate(
-            [operator, ...args],
-            ctx
-          );
-          if (result instanceof Promise) {
-            await result;
-          }
+          const [positional, emitCfg] = this.splitSubstrateEmit(args);
+          await this.runSubstrate(async () => {
+            const ctx = createContextFromBindings(
+              this.bindings,
+              this.strictBindings,
+              this.contextExtensions
+            );
+            const result = this.getEvaluator().evaluate(
+              [operator, ...positional],
+              ctx
+            );
+            return result instanceof Promise ? await result : result;
+          }, emitCfg);
         } else if (this.debug) {
           effectLog.warn("unknown-operator", { operator });
         }
@@ -2846,7 +2902,7 @@ async function getExternalLoaderModule() {
     return null;
   }
   try {
-    externalLoaderModule = await import('./external-loader-C2LO5XG3.js');
+    externalLoaderModule = await import('./external-loader-OPXVTNC4.js');
     return externalLoaderModule;
   } catch {
     return null;
@@ -3287,7 +3343,7 @@ var ReferenceResolver = class {
     if (this.loader || this.loaderInitialized) return;
     this.loaderInitialized = true;
     try {
-      const { ExternalOrbitalLoader } = await import('./external-loader-C2LO5XG3.js');
+      const { ExternalOrbitalLoader } = await import('./external-loader-OPXVTNC4.js');
       this.loader = new ExternalOrbitalLoader(this.options);
     } catch {
     }
@@ -3997,5 +4053,3 @@ var InMemoryPersistence = class {
 };
 
 export { EffectExecutor, EventBus, HANDLER_MANIFEST, InMemoryPersistence, MockPersistenceAdapter, StateMachineManager, TickScheduler, buildEmitsFromTraits, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, containsBindings, createContextFromBindings, createInitialTraitState, createMockPersistence, createTestExecutor, createTickScheduler, createUnifiedLoader, extractBindings, findInitialState, findTransition, formatPayloadValidationError, getIsolatedCollectionName, getNamespacedEvent, interpolateProps, interpolateValue, isBrowser, isElectron, isNamespacedEvent, isNode, isValidDurationString, normalizeCallSiteConfigToValues, normalizeEventKey, parseDurationString, parseNamespacedEvent, preprocessSchema, processEvent, validateEventPayload, validatePayloadShapes };
-//# sourceMappingURL=chunk-6YDQGA6X.js.map
-//# sourceMappingURL=chunk-6YDQGA6X.js.map

package/dist/{createAgentSubstrateHandlers-WZCHKGU6.js → createAgentSubstrateHandlers-G6KSTJPA.js}

@@ -1,4 +1,4 @@
-import './chunk-PZ5AY32C.js';
+import './chunk-MLKGABMK.js';
 import { createLogger } from '@almadar/logger';
 
 var log = createLogger("almadar:runtime:substrate-handlers");
@@ -9,54 +9,42 @@ function createAgentSubstrateHandlers(ctx) {
         log.warn("compose-all service not registered");
         return null;
       }
-      const result = await ctx.services.composeAll(config);
-      ctx.emitEvent("COMPOSED_ALL", { appName: config.appName, orbitalCount: config.orbitals.length });
-      return result;
+      return ctx.services.composeAll(config);
     },
     substrateComposeChildren: async (parentName, children) => {
       if (!ctx.services.composeChildren) {
         log.warn("compose-children service not registered");
         return null;
       }
-      const result = await ctx.services.composeChildren(parentName, children);
-      ctx.emitEvent("COMPOSED_CHILDREN", { parentName, childCount: children.length });
-      return result;
+      return ctx.services.composeChildren(parentName, children);
     },
     substrateInstantiate: async (parentName, behavior, params) => {
       if (!ctx.services.instantiate) {
         log.warn("instantiate service not registered");
         return null;
       }
-      const result = await ctx.services.instantiate(parentName, behavior, params);
-      ctx.emitEvent("BEHAVIOR_INSTANTIATED", { parentName, behavior });
-      return result;
+      return ctx.services.instantiate(parentName, behavior, params);
     },
     substrateCall: async (behavior, method) => {
       if (!ctx.services.call) {
         log.warn("call service not registered");
         return null;
       }
-      const result = await ctx.services.call(behavior, method);
-      ctx.emitEvent("BEHAVIOR_CALLED", { behavior, method });
-      return result;
+      return ctx.services.call(behavior, method);
     },
     substrateValidate: async (orbitalName) => {
       if (!ctx.services.validate) {
         log.warn("validate service not registered");
         return null;
       }
-      const result = await ctx.services.validate(orbitalName);
-      ctx.emitEvent("VALIDATED", { orbitalName });
-      return result;
+      return ctx.services.validate(orbitalName);
     },
     substrateEmitBody: async (orbitalName) => {
       if (!ctx.services.emitBody) {
         log.warn("emit-body service not registered");
         return null;
       }
-      const result = await ctx.services.emitBody(orbitalName, "");
-      ctx.emitEvent("LOLO_EMITTED", { orbitalName });
-      return result;
+      return ctx.services.emitBody(orbitalName, "");
     }
   };
   return {
@@ -67,5 +55,3 @@ function createAgentSubstrateHandlers(ctx) {
 }
 
 export { createAgentSubstrateHandlers };
-//# sourceMappingURL=createAgentSubstrateHandlers-WZCHKGU6.js.map
-//# sourceMappingURL=createAgentSubstrateHandlers-WZCHKGU6.js.map

package/dist/createOsHandlers.js

@@ -1,5 +1,5 @@
-import { parseCron, cronMinuteKey, cronMatches } from './chunk-U4PL237A.js';
-import './chunk-PZ5AY32C.js';
+import { parseCron, cronMinuteKey, cronMatches } from './chunk-OU3ITB5S.js';
+import './chunk-MLKGABMK.js';
 import * as fs from 'fs';
 import * as net from 'net';
 import { execFileSync } from 'child_process';
@@ -254,5 +254,3 @@ function createOsHandlers(ctx) {
 }
 
 export { createOsHandlers };
-//# sourceMappingURL=createOsHandlers.js.map
-//# sourceMappingURL=createOsHandlers.js.map

package/dist/{external-loader-C2LO5XG3.js → external-loader-OPXVTNC4.js}

@@ -1,4 +1,4 @@
-import './chunk-PZ5AY32C.js';
+import './chunk-MLKGABMK.js';
 import * as fs from 'fs';
 import * as path from 'path';
 import { OrbitalSchemaSchema } from '@almadar/core';
@@ -439,5 +439,3 @@ function autoDetectBehaviorsLibPaths(stdLibPath) {
 }
 
 export { ExternalOrbitalLoader, ImportChain, LoaderCache, createLoader, parseImportPath };
-//# sourceMappingURL=external-loader-C2LO5XG3.js.map
-//# sourceMappingURL=external-loader-C2LO5XG3.js.map

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { B as BindingContext, E as EvaluationContextExtensions, P as PatternProps, a as EffectHandlers, b as EffectContext, c as ExecutionEnvironment, d as EffectResult, T as TraitDefinition } from './types-D-9feVsj.js';
 export { e as Effect, f as EventListener, H as HANDLER_MANIFEST, I as IEventBus, R as RuntimeConfig, g as RuntimeEvent, h as TraitState, i as TransitionObserver, j as TransitionResult, U as Unsubscribe } from './types-D-9feVsj.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-BkaBvI6-.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-BkaBvI6-.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-DpAwIrmv.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 normalizeCallSiteConfigToValues, B as normalizeEventKey, C as parseNamespacedEvent, D as preprocessSchema, F as processEvent } from './OrbitalServerRuntime-DpAwIrmv.js';
 import { EvaluationContext, SExpressionEvaluator } from '@almadar/evaluator';
 export { EvaluationContext, createMinimalContext } from '@almadar/evaluator';
 import { EventPayload, EntityField, EntityRow, ServiceParams, PayloadField, OrbitalDefinition, OrbitalSchema } from '@almadar/core';
@@ -404,6 +404,21 @@ declare class EffectExecutor {
      * with a single `if (emit)` guard.
      */
     private osEmit;
+    /**
+     * Run a substrate (async) effect and dispatch the author's `emit.success`
+     * / `emit.failure` bus event when configured. Mirrors the compiled-path
+     * generic substrate dispatch (server.rs): uniform `{ result }` payload on
+     * success, `{ error }` on failure.
+     *
+     * When no `emit` config is present (fire-and-forget call) the op still runs
+     * but no event is dispatched and errors propagate (legacy behavior).
+     */
+    private runSubstrate;
+    /**
+     * Separate a trailing `{ emit: {...} }` options object from positional
+     * substrate-op args. Returns `[positionalArgs, emitConfig]`.
+     */
+    private splitSubstrateEmit;
     private dispatch;
     private logUnsupported;
 }

package/dist/index.js

@@ -1,7 +1,7 @@
-import { EffectExecutor, createContextFromBindings } from './chunk-6YDQGA6X.js';
-export { 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, normalizeEventKey, parseDurationString, parseNamespacedEvent, preprocessSchema, processEvent, validateEventPayload, validatePayloadShapes } from './chunk-6YDQGA6X.js';
-export { cronMatches, cronMinuteKey, isValidCronExpression, parseCron, parseCronField } from './chunk-U4PL237A.js';
-import { __export } from './chunk-PZ5AY32C.js';
+import { EffectExecutor, createContextFromBindings } from './chunk-YFH577FH.js';
+export { 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, validateEventPayload, validatePayloadShapes } from './chunk-YFH577FH.js';
+export { cronMatches, cronMinuteKey, isValidCronExpression, parseCron, parseCronField } from './chunk-OU3ITB5S.js';
+import { __export } from './chunk-MLKGABMK.js';
 import { createLogger } from '@almadar/logger';
 import { evaluate } from '@almadar/evaluator';
 import { isInlineTrait } from '@almadar/core';
@@ -763,5 +763,3 @@ function pipeBehaviors(seed, ...steps) {
 }
 
 export { applyEventWiring, composeBehaviors, composition_exports as composition, createClientEffectHandlers, createServerEffectHandlers, detectLayoutStrategy, pipeBehaviors };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/runtime",
-  "version": "6.29.0",
+  "version": "6.31.0",
   "description": "Interpreted runtime for Almadar orbital applications (OrbitalServerRuntime)",
   "type": "module",
   "main": "./dist/index.js",
@@ -42,11 +42,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^10.21.0",
-    "@almadar/evaluator": ">=2.9.2",
-    "@almadar/logger": "^1.0.0",
-    "@almadar/server": "^2.14.2",
-    "@almadar/std": ">=7.2.4",
+    "@almadar/core": "^10.27.0",
+    "@almadar/evaluator": "^2.29.0",
+    "@almadar/logger": "^1.9.0",
+    "@almadar/server": "^2.20.0",
+    "@almadar/std": "^16.137.0",
     "@faker-js/faker": "^9.3.0"
   },
   "peerDependencies": {
@@ -58,7 +58,7 @@
     }
   },
   "devDependencies": {
-    "@almadar/eslint-plugin": ">=2.7.0",
+    "@almadar/eslint-plugin": "^2.14.0",
     "@types/express": "^5.0.0",
     "@types/node": "^20.0.0",
     "@typescript-eslint/parser": "8.56.0",