@almadar/runtime 6.29.0 → 6.30.0

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

@@ -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,5 @@ function createAgentSubstrateHandlers(ctx) {
 }
 
 export { createAgentSubstrateHandlers };
-//# sourceMappingURL=createAgentSubstrateHandlers-WZCHKGU6.js.map
-//# sourceMappingURL=createAgentSubstrateHandlers-WZCHKGU6.js.map
+//# sourceMappingURL=createAgentSubstrateHandlers-RUX4RFC6.js.map
+//# sourceMappingURL=createAgentSubstrateHandlers-RUX4RFC6.js.map

package/dist/createAgentSubstrateHandlers-RUX4RFC6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/createAgentSubstrateHandlers.ts"],"names":[],"mappings":";;;AAyBA,IAAM,GAAA,GAAM,aAAa,oCAAoC,CAAA;AAqBtD,SAAS,6BAA6B,GAAA,EAAgE;AACzG,EAAA,MAAM,QAAA,GAAoC;AAAA,IACtC,mBAAA,EAAqB,OAAO,MAAA,KAAW;AACnC,MAAA,IAAI,CAAC,GAAA,CAAI,QAAA,CAAS,UAAA,EAAY;AAC1B,QAAA,GAAA,CAAI,KAAK,oCAAoC,CAAA;AAC7C,QAAA,OAAO,IAAA;AAAA,MACX;AAIA,MAAA,OAAO,GAAA,CAAI,QAAA,CAAS,UAAA,CAAW,MAAM,CAAA;AAAA,IACzC,CAAA;AAAA,IAEA,wBAAA,EAA0B,OAAO,UAAA,EAAY,QAAA,KAAa;AACtD,MAAA,IAAI,CAAC,GAAA,CAAI,QAAA,CAAS,eAAA,EAAiB;AAC/B,QAAA,GAAA,CAAI,KAAK,yCAAyC,CAAA;AAClD,QAAA,OAAO,IAAA;AAAA,MACX;AACA,MAAA,OAAO,GAAA,CAAI,QAAA,CAAS,eAAA,CAAgB,UAAA,EAAY,QAAQ,CAAA;AAAA,IAC5D,CAAA;AAAA,IAEA,oBAAA,EAAsB,OAAO,UAAA,EAAY,QAAA,EAAU,MAAA,KAAW;AAC1D,MAAA,IAAI,CAAC,GAAA,CAAI,QAAA,CAAS,WAAA,EAAa;AAC3B,QAAA,GAAA,CAAI,KAAK,oCAAoC,CAAA;AAC7C,QAAA,OAAO,IAAA;AAAA,MACX;AACA,MAAA,OAAO,GAAA,CAAI,QAAA,CAAS,WAAA,CAAY,UAAA,EAAY,UAAU,MAAM,CAAA;AAAA,IAChE,CAAA;AAAA,IAEA,aAAA,EAAe,OAAO,QAAA,EAAU,MAAA,KAAW;AACvC,MAAA,IAAI,CAAC,GAAA,CAAI,QAAA,CAAS,IAAA,EAAM;AACpB,QAAA,GAAA,CAAI,KAAK,6BAA6B,CAAA;AACtC,QAAA,OAAO,IAAA;AAAA,MACX;AACA,MAAA,OAAO,GAAA,CAAI,QAAA,CAAS,IAAA,CAAK,QAAA,EAAU,MAAM,CAAA;AAAA,IAC7C,CAAA;AAAA,IAEA,iBAAA,EAAmB,OAAO,WAAA,KAAgB;AACtC,MAAA,IAAI,CAAC,GAAA,CAAI,QAAA,CAAS,QAAA,EAAU;AACxB,QAAA,GAAA,CAAI,KAAK,iCAAiC,CAAA;AAC1C,QAAA,OAAO,IAAA;AAAA,MACX;AACA,MAAA,OAAO,GAAA,CAAI,QAAA,CAAS,QAAA,CAAS,WAAW,CAAA;AAAA,IAC5C,CAAA;AAAA,IAEA,iBAAA,EAAmB,OAAO,WAAA,KAAgB;AACtC,MAAA,IAAI,CAAC,GAAA,CAAI,QAAA,CAAS,QAAA,EAAU;AACxB,QAAA,GAAA,CAAI,KAAK,kCAAkC,CAAA;AAC3C,QAAA,OAAO,IAAA;AAAA,MACX;AACA,MAAA,OAAO,GAAA,CAAI,QAAA,CAAS,QAAA,CAAS,WAAA,EAAa,EAAE,CAAA;AAAA,IAChD;AAAA,GACJ;AAEA,EAAA,OAAO;AAAA,IACH,QAAA;AAAA,IACA,SAAS,MAAM;AAAA,IAAC;AAAA,GACpB;AACJ","file":"createAgentSubstrateHandlers-RUX4RFC6.js","sourcesContent":["/**\n * Agent Substrate Handlers — Server-Side Only\n *\n * Provides implementations for the effect-position substrate operators:\n * compose/compose-all, compose/compose-children, behavior/instantiate,\n * behavior/call, validate/validate, lolo/emit-body.\n *\n * Used by OrbitalServerRuntime (interpreted path). Wired alongside\n * createOsHandlers — same lazy-import + merge-under-user-handlers pattern.\n *\n * The actual service invocations are injected via the `services` field of\n * AgentSubstrateHandlerContext. @almadar-io/rabit supplies these at runtime;\n * tests can inject mocks. When a service is absent, the handler logs a\n * warning and returns a safe default.\n *\n * NOT exported from the main index.ts because it references Node-only types.\n * Import directly: import { createAgentSubstrateHandlers } from '@almadar/runtime/createAgentSubstrateHandlers';\n *\n * @packageDocumentation\n */\n\nimport { createLogger } from '@almadar/logger';\nimport type { EventPayload, EffectHandlers } from './types.js';\nimport type { ServiceCallResult, Orbital, TraitConfig } from '@almadar/core';\n\nconst log = createLogger('almadar:runtime:substrate-handlers');\n\nexport interface SubstrateServices {\n    composeAll?: (config: { appName: string; orbitals: Orbital[]; layoutStrategy?: string }) => Promise<ServiceCallResult>;\n    composeChildren?: (parentName: string, children: Orbital[]) => Promise<ServiceCallResult>;\n    instantiate?: (parentName: string, behavior: string, params?: TraitConfig) => Promise<ServiceCallResult>;\n    call?: (behavior: string, method: string, params?: TraitConfig) => Promise<ServiceCallResult>;\n    validate?: (orbitalName: string) => Promise<ServiceCallResult>;\n    emitBody?: (orbitalName: string, loloSource: string) => Promise<ServiceCallResult>;\n}\n\nexport interface AgentSubstrateHandlerContext {\n    emitEvent: (type: string, payload: EventPayload) => void;\n    services: SubstrateServices;\n}\n\nexport interface AgentSubstrateHandlerResult {\n    handlers: Partial<EffectHandlers>;\n    cleanup: () => void;\n}\n\nexport function createAgentSubstrateHandlers(ctx: AgentSubstrateHandlerContext): AgentSubstrateHandlerResult {\n    const handlers: Partial<EffectHandlers> = {\n        substrateComposeAll: async (config) => {\n            if (!ctx.services.composeAll) {\n                log.warn('compose-all service not registered');\n                return null;\n            }\n            // Success/failure events are dispatched by EffectExecutor via the\n            // author's `emit:` config (uniform `{ result }` payload); this\n            // handler only performs the invocation and returns the value.\n            return ctx.services.composeAll(config);\n        },\n\n        substrateComposeChildren: async (parentName, children) => {\n            if (!ctx.services.composeChildren) {\n                log.warn('compose-children service not registered');\n                return null;\n            }\n            return ctx.services.composeChildren(parentName, children);\n        },\n\n        substrateInstantiate: async (parentName, behavior, params) => {\n            if (!ctx.services.instantiate) {\n                log.warn('instantiate service not registered');\n                return null;\n            }\n            return ctx.services.instantiate(parentName, behavior, params);\n        },\n\n        substrateCall: async (behavior, method) => {\n            if (!ctx.services.call) {\n                log.warn('call service not registered');\n                return null;\n            }\n            return ctx.services.call(behavior, method);\n        },\n\n        substrateValidate: async (orbitalName) => {\n            if (!ctx.services.validate) {\n                log.warn('validate service not registered');\n                return null;\n            }\n            return ctx.services.validate(orbitalName);\n        },\n\n        substrateEmitBody: async (orbitalName) => {\n            if (!ctx.services.emitBody) {\n                log.warn('emit-body service not registered');\n                return null;\n            }\n            return ctx.services.emitBody(orbitalName, '');\n        },\n    };\n\n    return {\n        handlers,\n        cleanup: () => {},\n    };\n}\n"]}

package/dist/index.d.ts

@@ -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,5 +1,5 @@
-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';
+import { EffectExecutor, createContextFromBindings } from './chunk-TGL6XC6E.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-TGL6XC6E.js';
 export { cronMatches, cronMinuteKey, isValidCronExpression, parseCron, parseCronField } from './chunk-U4PL237A.js';
 import { __export } from './chunk-PZ5AY32C.js';
 import { createLogger } from '@almadar/logger';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/runtime",
-  "version": "6.29.0",
+  "version": "6.30.0",
   "description": "Interpreted runtime for Almadar orbital applications (OrbitalServerRuntime)",
   "type": "module",
   "main": "./dist/index.js",