@almadar/runtime 6.33.0 → 6.34.0

package/dist/createOsHandlers.d.ts

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

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

@@ -50,6 +50,22 @@ var LoaderCache = class {
     return this.cache.size;
   }
 };
+var BROWSE_FORM_HELP = "Accepted forms \u2014 loader: std/behaviors/<name> (e.g. std/behaviors/std-stats) | almadar-behaviors/<name> (e.g. almadar-behaviors/rpg-hero); browse: @std/<topic>/<kind>/<name>.lolo (e.g. @std/ui/core/atoms/std-stats.lolo) | @behaviors/<topic>/<kind>/<name>.lolo (e.g. @behaviors/app/molecules/app-crud-manager.lolo)";
+var BROWSE_PREFIX_TO_PACKAGE = [
+  ["@std/", "std/behaviors/"],
+  ["@behaviors/", "almadar-behaviors/"]
+];
+function mapBrowseSpecifier(importPath) {
+  for (const [prefix, pkg] of BROWSE_PREFIX_TO_PACKAGE) {
+    if (!importPath.startsWith(prefix)) continue;
+    const rest = importPath.slice(prefix.length);
+    const basename2 = rest.slice(rest.lastIndexOf("/") + 1);
+    const name = basename2.endsWith(".lolo") ? basename2.slice(0, -".lolo".length) : basename2;
+    if (name.length === 0) return { kind: "malformed" };
+    return { kind: "mapped", canonical: `${pkg}${name}` };
+  }
+  return { kind: "not-browse-form" };
+}
 var ExternalOrbitalLoader = class {
   options;
   cache;
@@ -147,6 +163,16 @@ var ExternalOrbitalLoader = class {
    * Resolve an import path to an absolute filesystem path.
    */
   resolvePath(importPath, fromPath) {
+    const mapped = mapBrowseSpecifier(importPath);
+    if (mapped.kind === "malformed") {
+      return {
+        success: false,
+        error: `Unresolvable primitive import "${importPath}". ${BROWSE_FORM_HELP}`
+      };
+    }
+    if (mapped.kind === "mapped") {
+      importPath = mapped.canonical;
+    }
     if (importPath.startsWith("std/")) {
       return this.resolveStdPath(importPath);
     }
@@ -438,4 +464,4 @@ function autoDetectBehaviorsLibPaths(stdLibPath) {
   return found;
 }
 
-export { ExternalOrbitalLoader, ImportChain, LoaderCache, createLoader, parseImportPath };
+export { ExternalOrbitalLoader, ImportChain, LoaderCache, createLoader, mapBrowseSpecifier, parseImportPath };

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-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-ConZnrpe.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-ConZnrpe.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-Cep380it.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-Cep380it.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-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 { EvaluationContext, SExpressionEvaluator } from '@almadar/evaluator';
 export { EvaluationContext, createMinimalContext } from '@almadar/evaluator';
-import { TraitConfigObject, EventPayload, PatternConfig, EntityField, EntityRow, ServiceParams, PayloadField, OrbitalDefinition, OrbitalSchema } from '@almadar/core';
+import { TraitConfigObject, EventPayload, PatternConfig, EntityId, EntityField, EntityRow, ServiceParams, PayloadField, OrbitalDefinition, OrbitalSchema } from '@almadar/core';
 export { EntityField, normalizeCallSiteConfigToValues } from '@almadar/core';
 export { ServerBridgeConfig, ServerBridgeState } from './ServerBridge.js';
 export { OsHandlerContext, OsHandlerResult } from './createOsHandlers.js';
@@ -540,6 +540,8 @@ type NamedEntityField = EntityField & {
 };
 interface EntitySchema {
     name: string;
+    /** V4 dual-carry id sibling of `name` — optional until the Phase-7 flip. */
+    id?: EntityId;
     fields: NamedEntityField[];
     /** Pre-authored instance data from the schema (used instead of generated mocks) */
     seedData?: EntityRow[];
@@ -559,6 +561,8 @@ declare class MockPersistenceAdapter implements PersistenceAdapter {
     private stores;
     private schemas;
     private idCounters;
+    /** entityId -> normalized store name, so relation lookups can prefer the id sibling over `relation.entity` name-matching. */
+    private storeNameById;
     private config;
     constructor(config?: MockPersistenceConfig);
     /** Re-anchor the PRNG to the configured seed. Called before every
@@ -961,8 +965,8 @@ declare function detectLayoutStrategy(orbitals: OrbitalDefinition[], eventWiring
 interface ComposeBehaviorsInput {
     /** Application name */
     appName: string;
-    /** Orbital definitions to compose */
-    orbitals: OrbitalDefinition[];
+    /** Orbital definitions (or schemas) to compose */
+    orbitals: (OrbitalDefinition | OrbitalSchema)[];
     /** Layout strategy override, or 'auto' to detect */
     layoutStrategy?: LayoutStrategy | 'auto';
     /** Cross-orbital event wiring */

package/dist/index.js

@@ -1,5 +1,5 @@
-import { EffectExecutor, createContextFromBindings } from './chunk-JZDLN2FS.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-JZDLN2FS.js';
+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';
 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';
@@ -719,6 +719,41 @@ function detectLayoutStrategy(orbitals, eventWiring) {
 }
 
 // src/composition/compose-behaviors.ts
+function isSchema(input) {
+  return "orbitals" in input && Array.isArray(input.orbitals);
+}
+function asDefinitions(inputs) {
+  return inputs.flatMap(
+    (input) => isSchema(input) ? input.orbitals : [input]
+  );
+}
+function mergeLedgers(inputs) {
+  const merged = /* @__PURE__ */ new Map();
+  let sawLedger = false;
+  for (const input of inputs) {
+    if (!isSchema(input) || input.ledger === void 0) continue;
+    sawLedger = true;
+    for (const [id, entry] of Object.entries(input.ledger.entries)) {
+      if (!merged.has(id)) merged.set(id, entry);
+    }
+  }
+  if (!sawLedger) return void 0;
+  const entries = {};
+  for (const [id, entry] of [...merged.entries()].sort(
+    ([a], [b]) => a < b ? -1 : a > b ? 1 : 0
+  )) {
+    entries[id] = entry;
+  }
+  return { schemaVersion: 1, entries };
+}
+function mergeSchemaVersions(inputs) {
+  let max;
+  for (const input of inputs) {
+    if (!isSchema(input) || input.schemaVersion === void 0) continue;
+    max = max === void 0 ? input.schemaVersion : Math.max(max, input.schemaVersion);
+  }
+  return max;
+}
 function toKebabCase(name) {
   return name.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
 }
@@ -769,10 +804,11 @@ function getEntityName(orbital) {
 function composeBehaviors(input) {
   const {
     appName,
-    orbitals: rawOrbitals,
+    orbitals: rawInputs,
     layoutStrategy: strategyInput,
     eventWiring
   } = input;
+  const rawOrbitals = asDefinitions(rawInputs);
   const wiredOrbitals = eventWiring && eventWiring.length > 0 ? applyEventWiring(rawOrbitals, eventWiring) : rawOrbitals;
   const strategy = !strategyInput || strategyInput === "auto" ? detectLayoutStrategy(wiredOrbitals, eventWiring) : strategyInput;
   const pages = generatePages(wiredOrbitals, strategy);
@@ -786,10 +822,14 @@ function composeBehaviors(input) {
       pages: page ? [page] : []
     };
   });
+  const ledger = mergeLedgers(rawInputs);
+  const schemaVersion = mergeSchemaVersions(rawInputs);
   const schema = {
     name: appName,
     version: "1.0.0",
-    orbitals: orbitalsWithPages
+    orbitals: orbitalsWithPages,
+    ...schemaVersion !== void 0 ? { schemaVersion } : {},
+    ...ledger !== void 0 ? { ledger } : {}
   };
   return {
     schema,

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

@@ -1,5 +1,5 @@
 import * as _almadar_core from '@almadar/core';
-import { 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, 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';
 
 /** Alias for ResolvedPatternProps to avoid breaking internal consumers */
 type PatternProps = ResolvedPatternProps;
@@ -17,8 +17,9 @@ type Unsubscribe = Unsubscribe$1;
  * Event bus interface for pub/sub communication
  */
 interface IEventBus {
-    /** Emit an event */
-    emit(type: string, payload?: EventPayload, source?: BusEventSource): void;
+    /** Emit an event. `routingKey` (V4) keys delivery by event-id when the
+     *  schema carries ids; absent → keyed by `type` (name, legacy). */
+    emit(type: string, payload?: EventPayload, source?: BusEventSource, routingKey?: string): void;
     /** Subscribe to an event */
     on(type: string, listener: EventListener): Unsubscribe;
     /** Subscribe to ALL events (wildcard listener) */
@@ -70,6 +71,9 @@ interface TransitionResult {
  * Minimal trait definition for state machine processing
  */
 interface TraitDefinition {
+    /** V4 dual-carry id sibling of `name` — the stable state-machine lookup
+     *  key when present (ledger-backed). Absent → keyed by name (legacy). */
+    id?: TraitId;
     name: string;
     states: Array<{
         name: string;
@@ -79,6 +83,8 @@ interface TraitDefinition {
         from: string | string[];
         to: string;
         event: string;
+        /** V4 dual-carry id sibling of `event` — optional until the Phase-7 flip. */
+        eventId?: EventId;
         guard?: unknown;
         effects?: SExpr[];
         /** Compensating transition when effects fail (RCG-04) */
@@ -90,7 +96,11 @@ interface TraitDefinition {
     /** Cross-trait event listeners (optional) */
     listens?: Array<{
         event: string;
+        /** V4 dual-carry id sibling of `event` — optional until the Phase-7 flip. */
+        eventId?: EventId;
         triggers: string;
+        /** V4 dual-carry id sibling of `triggers` — optional until the Phase-7 flip. */
+        triggersId?: EventId;
         payloadMapping?: EventPayload;
     }>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/runtime",
-  "version": "6.33.0",
+  "version": "6.34.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.29.0",
-    "@almadar/evaluator": "^2.29.0",
+    "@almadar/core": "^10.31.0",
+    "@almadar/evaluator": "^2.31.0",
     "@almadar/logger": "^1.9.0",
     "@almadar/server": "^2.25.0",
-    "@almadar/std": "^16.138.0"
+    "@almadar/std": "^16.141.0"
   },
   "peerDependencies": {
     "express": "^5.0.0"