@almadar/runtime 6.26.0 → 6.28.0

package/dist/createAgentSubstrateHandlers-4JMLGDZQ.js

@@ -0,0 +1,71 @@
+import './chunk-PZ5AY32C.js';
+import { createLogger } from '@almadar/logger';
+
+var log = createLogger("almadar:runtime:substrate-handlers");
+function createAgentSubstrateHandlers(ctx) {
+  const handlers = {
+    substrateComposeAll: async (config) => {
+      if (!ctx.services.composeAll) {
+        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;
+    },
+    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;
+    },
+    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;
+    },
+    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;
+    },
+    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;
+    },
+    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 {
+    handlers,
+    cleanup: () => {
+    }
+  };
+}
+
+export { createAgentSubstrateHandlers };
+//# sourceMappingURL=createAgentSubstrateHandlers-4JMLGDZQ.js.map
+//# sourceMappingURL=createAgentSubstrateHandlers-4JMLGDZQ.js.map

package/dist/createAgentSubstrateHandlers-4JMLGDZQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/createAgentSubstrateHandlers.ts"],"names":[],"mappings":"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","file":"createAgentSubstrateHandlers-4JMLGDZQ.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 } from '@almadar/core';\n\nconst log = createLogger('almadar:runtime:substrate-handlers');\n\nexport interface SubstrateServices {\n    composeAll?: (config: { appName: string; orbitals: unknown[]; layoutStrategy?: string }) => Promise<ServiceCallResult>;\n    composeChildren?: (parentName: string, children: unknown[]) => Promise<ServiceCallResult>;\n    instantiate?: (parentName: string, behavior: string, params?: unknown) => Promise<ServiceCallResult>;\n    call?: (behavior: string, method: string, params?: unknown) => 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            const result = await ctx.services.composeAll(config);\n            ctx.emitEvent('COMPOSED_ALL', { appName: config.appName, orbitalCount: config.orbitals.length });\n            return result;\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            const result = await ctx.services.composeChildren(parentName, children);\n            ctx.emitEvent('COMPOSED_CHILDREN', { parentName, childCount: children.length });\n            return result;\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            const result = await ctx.services.instantiate(parentName, behavior, params);\n            ctx.emitEvent('BEHAVIOR_INSTANTIATED', { parentName, behavior });\n            return result;\n        },\n\n        substrateCall: async (behavior, method) => {\n            if (!ctx.services.call) {\n                log.warn('call service not registered');\n                return null;\n            }\n            const result = await ctx.services.call(behavior, method);\n            ctx.emitEvent('BEHAVIOR_CALLED', { behavior, method });\n            return result;\n        },\n\n        substrateValidate: async (orbitalName) => {\n            if (!ctx.services.validate) {\n                log.warn('validate service not registered');\n                return null;\n            }\n            const result = await ctx.services.validate(orbitalName);\n            ctx.emitEvent('VALIDATED', { orbitalName });\n            return result;\n        },\n\n        substrateEmitBody: async (orbitalName) => {\n            if (!ctx.services.emitBody) {\n                log.warn('emit-body service not registered');\n                return null;\n            }\n            const result = await ctx.services.emitBody(orbitalName, '');\n            ctx.emitEvent('LOLO_EMITTED', { orbitalName });\n            return result;\n        },\n    };\n\n    return {\n        handlers,\n        cleanup: () => {},\n    };\n}\n"]}

package/dist/createOsHandlers.d.ts

@@ -1,4 +1,4 @@
-import { a as EffectHandlers } from './types-BA7GoDni.js';
+import { a as EffectHandlers } from './types-CguyGOms.js';
 import { EventPayload } from '@almadar/core';
 
 /**

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-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-BA7GoDni.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-BA7GoDni.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-h0NCwFuc.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-h0NCwFuc.js';
-import { EvaluationContext } from '@almadar/evaluator';
+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-CguyGOms.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-CguyGOms.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-DCkk0alk.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-DCkk0alk.js';
+import { EvaluationContext, SExpressionEvaluator } from '@almadar/evaluator';
 export { EvaluationContext, createMinimalContext } from '@almadar/evaluator';
 import { EventPayload, EntityField, EntityRow, ServiceParams, PayloadField, OrbitalDefinition, OrbitalSchema } from '@almadar/core';
 export { EntityField } from '@almadar/core';
@@ -307,6 +307,8 @@ interface EffectExecutorOptions {
     strictBindings?: boolean;
     /** Additional fields to spread onto EvaluationContext (e.g., { agent: AgentContext }) */
     contextExtensions?: EvaluationContextExtensions;
+    /** Evaluator for resolving nested S-expression values in `set` (e.g., substrate operators) */
+    evaluator?: SExpressionEvaluator;
 }
 /**
  * EffectExecutor - Routes effects to handlers.
@@ -341,7 +343,10 @@ declare class EffectExecutor {
     private debug;
     private strictBindings;
     private contextExtensions?;
+    private evaluator?;
     constructor(options: EffectExecutorOptions);
+    private _evaluator?;
+    private getEvaluator;
     /**
      * Validate that all effect types used in a schema have handlers registered.
      * Call this at runtime startup to catch missing handler setup immediately.

package/dist/index.js

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

package/dist/{types-BA7GoDni.d.ts → types-CguyGOms.d.ts}

@@ -1,5 +1,5 @@
 import * as _almadar_core from '@almadar/core';
-import { SExpr, EventPayload, AgentContext, TraitConfig, BusEvent, EntityRow, FieldValue, ServiceParams, FetchResult, PatternConfig, ResolvedPatternProps, BusEventSource, BusEventListener, Unsubscribe as Unsubscribe$1 } from '@almadar/core';
+import { SExpr, EventPayload, AgentContext, LlmContext, WorkspaceContext, SessionContext, MemoryContext, TraceContext, IntegrationContext, TraitConfig, BusEvent, EntityRow, FieldValue, ServiceParams, FetchResult, PatternConfig, ResolvedPatternProps, BusEventSource, BusEventListener, Unsubscribe as Unsubscribe$1 } from '@almadar/core';
 
 /** Alias for ResolvedPatternProps to avoid breaking internal consumers */
 type PatternProps = ResolvedPatternProps;
@@ -221,6 +221,22 @@ interface EffectHandlers {
     osWatchEnv?: (variable: string, emit?: OsEmitConfig) => void;
     /** Configure debounce for an OS event type */
     osDebounce?: (ms: number, eventType: string) => void;
+    /** compose/compose-all — compose multiple orbitals into one schema */
+    substrateComposeAll?: (config: {
+        appName: string;
+        orbitals: unknown[];
+        layoutStrategy?: string;
+    }) => Promise<unknown>;
+    /** compose/compose-children — compose children under a parent */
+    substrateComposeChildren?: (parentName: string, children: unknown[]) => Promise<unknown>;
+    /** behavior/instantiate — instantiate a behavior at runtime (meta `uses`) */
+    substrateInstantiate?: (parentName: string, behavior: string, params?: unknown) => Promise<unknown>;
+    /** behavior/call — call a method on an instantiated behavior */
+    substrateCall?: (behavior: string, method: string, params?: unknown) => Promise<unknown>;
+    /** validate/validate — validate an orbital, fires VALIDATED_OK/ERROR */
+    substrateValidate?: (orbitalName: string) => Promise<unknown>;
+    /** lolo/emit-body — emit lolo source for an orbital */
+    substrateEmitBody?: (orbitalName: string, loloSource: string) => Promise<unknown>;
 }
 /**
  * Author-configured `emit:` block threaded into `os/watch-*` handlers.
@@ -333,6 +349,13 @@ interface RuntimeConfig {
 interface EvaluationContextExtensions {
     /** Agent context for agent/* operators (memory, LLM, tools, session) */
     agent?: AgentContext;
+    /** Substrate contexts for the new operator namespaces */
+    llm?: LlmContext;
+    workspace?: WorkspaceContext;
+    session?: SessionContext;
+    memory?: MemoryContext;
+    trace?: TraceContext;
+    integration?: IntegrationContext;
 }
 /**
  * Execution context for handler manifest validation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/runtime",
-  "version": "6.26.0",
+  "version": "6.28.0",
   "description": "Interpreted runtime for Almadar orbital applications (OrbitalServerRuntime)",
   "type": "module",
   "main": "./dist/index.js",
@@ -42,7 +42,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^10.11.0",
+    "@almadar/core": "^10.21.0",
     "@almadar/evaluator": ">=2.9.2",
     "@almadar/logger": "^1.0.0",
     "@almadar/server": "^2.14.2",