@almadar/core 4.4.1 → 4.5.0

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
-import { b as EntityRow, aK as FieldValue, bR as SExpr } from '../schema-B0Yin-RM.js';
-export { A as AGENT_DOMAIN_CATEGORIES, f as ALLOWED_CUSTOM_COMPONENTS, g as AgentDomainCategory, h as AgentDomainCategorySchema, i as AgentEffect, j as AllowedCustomComponent, k as AnimationDef, l as AnimationDefInput, m as AnimationDefSchema, c as AppSchema, n as AssetMap, o as AssetMapInput, p as AssetMapSchema, q as AssetMapping, r as AssetMappingInput, s as AssetMappingSchema, t as AtomicEffect, C as CORE_BINDINGS, u as CallServiceConfig, v as CallServiceEffect, w as ComputedEventContract, x as ComputedEventContractSchema, y as ComputedEventListener, z as ComputedEventListenerSchema, B as CoreBinding, D as CustomPatternDefinition, F as CustomPatternDefinitionInput, G as CustomPatternDefinitionSchema, H as CustomPatternMap, I as CustomPatternMapInput, J as CustomPatternMapSchema, K as DerefEffect, L as DesignPreferences, M as DesignPreferencesInput, N as DesignPreferencesSchema, Q as DesignTokens, R as DesignTokensInput, U as DesignTokensSchema, V as DespawnEffect, W as DoEffect, X as DomainCategory, Y as DomainCategorySchema, Z as DomainContext, _ as DomainContextInput, $ as DomainContextSchema, a0 as DomainVocabulary, a1 as DomainVocabularySchema, a2 as ENTITY_ROLES, a3 as Effect, a4 as EffectInput, a5 as EffectSchema, a6 as EmitEffect, e as Entity, a7 as EntityCall, a8 as EntityCallSchema, a9 as EntityData, E as EntityField, aa as EntityFieldInput, ab as EntityFieldSchema, a as EntityPersistence, ac as EntityPersistenceSchema, ad as EntityRef, ae as EntityRefSchema, af as EntityRefStringSchema, ag as EntityRole, ah as EntityRoleSchema, ai as EntitySchema, aj as EntitySemanticRole, ak as EntitySemanticRoleSchema, al as EvalContext, am as Event, an as EventInput, ao as EventListener, ap as EventListenerSchema, aq as EventPayload, ar as EventPayloadField, as as EventPayloadFieldSchema, at as EventSchema, au as EventScope, av as EventScopeSchema, aw as EventSemanticRole, ax as EventSemanticRoleSchema, ay as EventSource, az as EventSourceSchema, aA as Expression, aB as ExpressionInput, aC as ExpressionSchema, aD as FetchEffect, aE as Field, aF as FieldFormat, aG as FieldFormatSchema, aH as FieldSchema, aI as FieldType, aJ as FieldTypeSchema, aL as FullOrbitalUnit, aM as GAME_TYPES, aN as GameSubCategory, aO as GameSubCategorySchema, aP as GameType, aQ as GameTypeSchema, aR as Guard, aS as GuardInput, aT as GuardSchema, aU as LogEffect, aV as LogMeta, aW as McpServiceDef, aX as McpServiceDefSchema, aY as NavigateEffect, aZ as NodeClassification, a_ as NodeClassificationSchema, a$ as NotifyEffect, aL as Orbital, b0 as OrbitalConfig, b1 as OrbitalConfigInput, b2 as OrbitalConfigSchema, O as OrbitalDefinition, b3 as OrbitalDefinitionSchema, b4 as OrbitalEntity, b5 as OrbitalEntityInput, b6 as OrbitalEntitySchema, b7 as OrbitalInput, b8 as OrbitalPage, b9 as OrbitalPageInput, ba as OrbitalPageSchema, bb as OrbitalPageStrictInput, bc as OrbitalPageStrictSchema, c as OrbitalSchema, bd as OrbitalSchemaInput, be as OrbitalSchemaSchema, bf as OrbitalTraitRef, bg as OrbitalTraitRefSchema, bh as OrbitalUnit, bi as OrbitalUnitSchema, bj as OrbitalZodSchema, P as Page, bk as PageRef, bl as PageRefObject, bm as PageRefObjectSchema, bn as PageRefSchema, bo as PageRefStringSchema, bp as PageSchema, bq as PageTraitRef, br as PageTraitRefSchema, bs as ParsedBinding, bt as PayloadField, bu as PayloadFieldSchema, bv as PersistEffect, bw as PresentationType, bx as RefEffect, by as RelatedLink, bz as RelatedLinkSchema, bA as RelationConfig, bB as RelationConfigSchema, bC as RenderItemLambda, bD as RenderUIConfig, bE as RenderUIEffect, bF as RenderUINode, bG as RequiredField, bH as RequiredFieldSchema, bI as ResolvedAsset, bJ as ResolvedAssetInput, bK as ResolvedAssetSchema, bL as ResolvedPatternProps, bM as RestAuthConfig, bN as RestAuthConfigSchema, bO as RestServiceDef, bP as RestServiceDefSchema, bQ as SERVICE_TYPES, bS as SExprAtom, bT as SExprAtomSchema, bU as SExprInput, bV as SExprSchema, bW as SemanticAssetRef, bX as SemanticAssetRefInput, bY as SemanticAssetRefSchema, bZ as ServiceDefinition, b_ as ServiceDefinitionSchema, b$ as ServiceParams, c0 as ServiceRef, c1 as ServiceRefObject, c2 as ServiceRefObjectSchema, c3 as ServiceRefSchema, c4 as ServiceRefStringSchema, c5 as ServiceType, c6 as ServiceTypeSchema, c7 as SetEffect, c8 as SocketEvents, c9 as SocketEventsSchema, ca as SocketServiceDef, cb as SocketServiceDefSchema, cc as SpawnEffect, S as State, cd as StateInput, ce as StateMachine, cf as StateMachineInput, cg as StateMachineSchema, ch as StateSchema, ci as StateSemanticRole, cj as StateSemanticRoleSchema, ck as SuggestedGuard, cl as SuggestedGuardSchema, cm as SwapEffect, cn as ThemeDefinition, co as ThemeDefinitionSchema, cp as ThemeRef, cq as ThemeRefSchema, cr as ThemeRefStringSchema, cs as ThemeTokens, ct as ThemeTokensSchema, cu as ThemeVariant, cv as ThemeVariantSchema, d as Trait, cw as TraitCategory, cx as TraitCategorySchema, cy as TraitDataEntity, cz as TraitDataEntitySchema, cA as TraitEntityField, cB as TraitEntityFieldSchema, T as TraitEventContract, cC as TraitEventContractSchema, cD as TraitEventListener, cE as TraitEventListenerSchema, cF as TraitInput, cG as TraitRef, cH as TraitRefSchema, cI as TraitReference, cJ as TraitReferenceInput, cK as TraitReferenceSchema, cL as TraitSchema, cM as TraitTick, cN as TraitTickSchema, cO as TraitUIBinding, cP as Transition, cQ as TransitionInput, cR as TransitionSchema, cS as TypedEffect, cT as UISlot, cU as UISlotSchema, cV as UI_SLOTS, cW as UXHints, cX as UXHintsSchema, cY as UseDeclaration, cZ as UseDeclarationSchema, c_ as UserPersona, c$ as UserPersonaInput, d0 as UserPersonaSchema, d1 as VISUAL_STYLES, d2 as ViewType, d3 as ViewTypeSchema, d4 as VisualStyle, d5 as VisualStyleSchema, d6 as WatchEffect, d7 as WatchOptions, d8 as atomic, d9 as callService, da as collectBindings, db as createAssetKey, dc as deref, dd as deriveCollection, de as despawn, df as doEffects, dg as emit, dh as findService, di as getArgs, dj as getDefaultAnimationsForRole, dk as getOperator, dl as getServiceNames, dm as getTraitConfig, dn as getTraitName, dp as hasService, dq as isBinding, dr as isCircuitEvent, ds as isEffect, dt as isEntityCall, du as isEntityReference, dv as isEntityReferenceAny, dw as isImportedTraitRef, dx as isInlineTrait, dy as isMcpService, dz as isOrbitalDefinition, dA as isPageReference, dB as isPageReferenceObject, dC as isPageReferenceString, dD as isRestService, dE as isRuntimeEntity, dF as isSExpr, dG as isSExprAtom, dH as isSExprCall, dI as isSExprEffect, dJ as isServiceReference, dK as isServiceReferenceObject, dL as isSingletonEntity, dM as isSocketService, dN as isThemeReference, dO as isValidBinding, dP as navigate, dQ as normalizeTraitRef, dR as notify, dS as parseAssetKey, dT as parseBinding, dU as parseEntityRef, dV as parseImportedTraitRef, dW as parseOrbitalSchema, dX as parsePageRef, dY as parseServiceRef, dZ as persist, d_ as ref, d$ as renderUI, e0 as safeParseOrbitalSchema, e1 as set, e2 as sexpr, e3 as spawn, e4 as swap, e5 as validateAssetAnimations, e6 as walkSExpr, e7 as watch } from '../schema-B0Yin-RM.js';
+import { b as EntityRow, aK as FieldValue, bR as SExpr } from '../schema-D4VBpRZI.js';
+export { A as AGENT_DOMAIN_CATEGORIES, f as ALLOWED_CUSTOM_COMPONENTS, g as AgentDomainCategory, h as AgentDomainCategorySchema, i as AgentEffect, j as AllowedCustomComponent, k as AnimationDef, l as AnimationDefInput, m as AnimationDefSchema, c as AppSchema, n as AssetMap, o as AssetMapInput, p as AssetMapSchema, q as AssetMapping, r as AssetMappingInput, s as AssetMappingSchema, t as AtomicEffect, C as CORE_BINDINGS, u as CallServiceConfig, v as CallServiceEffect, w as ComputedEventContract, x as ComputedEventContractSchema, y as ComputedEventListener, z as ComputedEventListenerSchema, B as CoreBinding, D as CustomPatternDefinition, F as CustomPatternDefinitionInput, G as CustomPatternDefinitionSchema, H as CustomPatternMap, I as CustomPatternMapInput, J as CustomPatternMapSchema, K as DerefEffect, L as DesignPreferences, M as DesignPreferencesInput, N as DesignPreferencesSchema, Q as DesignTokens, R as DesignTokensInput, U as DesignTokensSchema, V as DespawnEffect, W as DoEffect, X as DomainCategory, Y as DomainCategorySchema, Z as DomainContext, _ as DomainContextInput, $ as DomainContextSchema, a0 as DomainVocabulary, a1 as DomainVocabularySchema, a2 as ENTITY_ROLES, a3 as Effect, a4 as EffectInput, a5 as EffectSchema, a6 as EmitEffect, e as Entity, a7 as EntityCall, a8 as EntityCallSchema, a9 as EntityData, E as EntityField, aa as EntityFieldInput, ab as EntityFieldSchema, a as EntityPersistence, ac as EntityPersistenceSchema, ad as EntityRef, ae as EntityRefSchema, af as EntityRefStringSchema, ag as EntityRole, ah as EntityRoleSchema, ai as EntitySchema, aj as EntitySemanticRole, ak as EntitySemanticRoleSchema, al as EvalContext, am as Event, an as EventInput, ao as EventListener, ap as EventListenerSchema, aq as EventPayload, ar as EventPayloadField, as as EventPayloadFieldSchema, at as EventSchema, au as EventScope, av as EventScopeSchema, aw as EventSemanticRole, ax as EventSemanticRoleSchema, ay as EventSource, az as EventSourceSchema, aA as Expression, aB as ExpressionInput, aC as ExpressionSchema, aD as FetchEffect, aE as Field, aF as FieldFormat, aG as FieldFormatSchema, aH as FieldSchema, aI as FieldType, aJ as FieldTypeSchema, aL as FullOrbitalUnit, aM as GAME_TYPES, aN as GameSubCategory, aO as GameSubCategorySchema, aP as GameType, aQ as GameTypeSchema, aR as Guard, aS as GuardInput, aT as GuardSchema, aU as LogEffect, aV as LogMeta, aW as McpServiceDef, aX as McpServiceDefSchema, aY as NavigateEffect, aZ as NodeClassification, a_ as NodeClassificationSchema, a$ as NotifyEffect, aL as Orbital, b0 as OrbitalConfig, b1 as OrbitalConfigInput, b2 as OrbitalConfigSchema, O as OrbitalDefinition, b3 as OrbitalDefinitionSchema, b4 as OrbitalEntity, b5 as OrbitalEntityInput, b6 as OrbitalEntitySchema, b7 as OrbitalInput, b8 as OrbitalPage, b9 as OrbitalPageInput, ba as OrbitalPageSchema, bb as OrbitalPageStrictInput, bc as OrbitalPageStrictSchema, c as OrbitalSchema, bd as OrbitalSchemaInput, be as OrbitalSchemaSchema, bf as OrbitalTraitRef, bg as OrbitalTraitRefSchema, bh as OrbitalUnit, bi as OrbitalUnitSchema, bj as OrbitalZodSchema, P as Page, bk as PageRef, bl as PageRefObject, bm as PageRefObjectSchema, bn as PageRefSchema, bo as PageRefStringSchema, bp as PageSchema, bq as PageTraitRef, br as PageTraitRefSchema, bs as ParsedBinding, bt as PayloadField, bu as PayloadFieldSchema, bv as PersistEffect, bw as PresentationType, bx as RefEffect, by as RelatedLink, bz as RelatedLinkSchema, bA as RelationConfig, bB as RelationConfigSchema, bC as RenderItemLambda, bD as RenderUIConfig, bE as RenderUIEffect, bF as RenderUINode, bG as RequiredField, bH as RequiredFieldSchema, bI as ResolvedAsset, bJ as ResolvedAssetInput, bK as ResolvedAssetSchema, bL as ResolvedPatternProps, bM as RestAuthConfig, bN as RestAuthConfigSchema, bO as RestServiceDef, bP as RestServiceDefSchema, bQ as SERVICE_TYPES, bS as SExprAtom, bT as SExprAtomSchema, bU as SExprInput, bV as SExprSchema, bW as SemanticAssetRef, bX as SemanticAssetRefInput, bY as SemanticAssetRefSchema, bZ as ServiceDefinition, b_ as ServiceDefinitionSchema, b$ as ServiceParams, c0 as ServiceRef, c1 as ServiceRefObject, c2 as ServiceRefObjectSchema, c3 as ServiceRefSchema, c4 as ServiceRefStringSchema, c5 as ServiceType, c6 as ServiceTypeSchema, c7 as SetEffect, c8 as SocketEvents, c9 as SocketEventsSchema, ca as SocketServiceDef, cb as SocketServiceDefSchema, cc as SpawnEffect, S as State, cd as StateInput, ce as StateMachine, cf as StateMachineInput, cg as StateMachineSchema, ch as StateSchema, ci as StateSemanticRole, cj as StateSemanticRoleSchema, ck as SuggestedGuard, cl as SuggestedGuardSchema, cm as SwapEffect, cn as ThemeDefinition, co as ThemeDefinitionSchema, cp as ThemeRef, cq as ThemeRefSchema, cr as ThemeRefStringSchema, cs as ThemeTokens, ct as ThemeTokensSchema, cu as ThemeVariant, cv as ThemeVariantSchema, d as Trait, cw as TraitCategory, cx as TraitCategorySchema, cy as TraitDataEntity, cz as TraitDataEntitySchema, cA as TraitEntityField, cB as TraitEntityFieldSchema, T as TraitEventContract, cC as TraitEventContractSchema, cD as TraitEventListener, cE as TraitEventListenerSchema, cF as TraitInput, cG as TraitRef, cH as TraitRefSchema, cI as TraitReference, cJ as TraitReferenceInput, cK as TraitReferenceSchema, cL as TraitSchema, cM as TraitTick, cN as TraitTickSchema, cO as TraitUIBinding, cP as Transition, cQ as TransitionInput, cR as TransitionSchema, cS as TypedEffect, cT as UISlot, cU as UISlotSchema, cV as UI_SLOTS, cW as UXHints, cX as UXHintsSchema, cY as UseDeclaration, cZ as UseDeclarationSchema, c_ as UserPersona, c$ as UserPersonaInput, d0 as UserPersonaSchema, d1 as VISUAL_STYLES, d2 as ViewType, d3 as ViewTypeSchema, d4 as VisualStyle, d5 as VisualStyleSchema, d6 as WatchEffect, d7 as WatchOptions, d8 as atomic, d9 as callService, da as collectBindings, db as createAssetKey, dc as deref, dd as deriveCollection, de as despawn, df as doEffects, dg as emit, dh as findService, di as getArgs, dj as getDefaultAnimationsForRole, dk as getOperator, dl as getServiceNames, dm as getTraitConfig, dn as getTraitName, dp as hasService, dq as isBinding, dr as isCircuitEvent, ds as isEffect, dt as isEntityCall, du as isEntityReference, dv as isEntityReferenceAny, dw as isImportedTraitRef, dx as isInlineTrait, dy as isMcpService, dz as isOrbitalDefinition, dA as isPageReference, dB as isPageReferenceObject, dC as isPageReferenceString, dD as isRestService, dE as isRuntimeEntity, dF as isSExpr, dG as isSExprAtom, dH as isSExprCall, dI as isSExprEffect, dJ as isServiceReference, dK as isServiceReferenceObject, dL as isSingletonEntity, dM as isSocketService, dN as isThemeReference, dO as isValidBinding, dP as navigate, dQ as normalizeTraitRef, dR as notify, dS as parseAssetKey, dT as parseBinding, dU as parseEntityRef, dV as parseImportedTraitRef, dW as parseOrbitalSchema, dX as parsePageRef, dY as parseServiceRef, dZ as persist, d_ as ref, d$ as renderUI, e0 as safeParseOrbitalSchema, e1 as set, e2 as sexpr, e3 as spawn, e4 as swap, e5 as validateAssetAnimations, e6 as walkSExpr, e7 as watch } from '../schema-D4VBpRZI.js';
 import { z } from 'zod';
 export { CATEGORIES, CategoryMeta, OPERATORS, OPERATORS_SCHEMA, OPERATOR_NAMES, OperatorCategory, OperatorMeta, OperatorStats, OperatorsSchema, TargetPlatform, getOperatorMeta, getOperatorStats, getOperatorsByCategory, getOperatorsForTarget, isEffectOperator, isGuardOperator, isKnownOperator, validateOperatorArity } from '@almadar/operators';
 export { PATTERN_TYPES, PatternConfig, PatternType, isValidPatternType } from '@almadar/patterns';

package/dist/types/index.js

@@ -50,22 +50,61 @@ var FieldFormatSchema = z.enum([
   "datetime",
   "uuid"
 ]);
+var FIELD_TYPE_ALIASES = {
+  text: "string",
+  int: "number",
+  float: "number",
+  ts: "timestamp"
+};
 var EntityFieldSchema = z.lazy(
-  () => z.object({
-    name: z.string().min(1, "Field name is required"),
-    type: FieldTypeSchema,
-    required: z.boolean().optional(),
-    default: z.unknown().optional(),
-    values: z.array(z.string()).optional(),
-    enum: z.array(z.string()).optional(),
-    format: FieldFormatSchema.optional(),
-    min: z.number().optional(),
-    max: z.number().optional(),
-    items: EntityFieldSchema.optional(),
-    relation: RelationConfigSchema.optional()
-  }).refine(
-    (field) => field.type !== "relation" || field.relation !== void 0,
-    { message: 'Relation config is required when type is "relation"', path: ["relation"] }
+  () => z.preprocess(
+    (input) => {
+      if (input !== null && typeof input === "object" && "type" in input && typeof input.type === "string") {
+        const raw = input.type;
+        const canonical = FIELD_TYPE_ALIASES[raw];
+        if (canonical !== void 0) {
+          return { ...input, type: canonical };
+        }
+      }
+      return input;
+    },
+    z.object({
+      name: z.string().min(1, "Field name is required"),
+      type: FieldTypeSchema,
+      required: z.boolean().optional(),
+      default: z.unknown().optional(),
+      values: z.array(z.string()).optional(),
+      enum: z.array(z.string()).optional(),
+      format: FieldFormatSchema.optional(),
+      min: z.number().optional(),
+      max: z.number().optional(),
+      items: EntityFieldSchema.optional(),
+      relation: RelationConfigSchema.optional()
+    }).refine(
+      (field) => field.type !== "relation" || field.relation !== void 0,
+      { message: 'Relation config is required when type is "relation"', path: ["relation"] }
+    ).refine(
+      // Enum fields must carry their allowed values. Without this refine,
+      // the type was lying about what's valid — bare `type: 'enum'` without
+      // `values` passed zod but failed `orb validate` downstream with
+      // ORB_E_EMPTY_ENUM_VALUES, stalling the agent pipeline for 20 minutes.
+      // `enum` is the legacy field-name alias; accept either.
+      (field) => {
+        if (field.type !== "enum") return true;
+        const vals = field.values ?? field.enum;
+        return Array.isArray(vals) && vals.length > 0;
+      },
+      { message: "Enum field requires a non-empty `values` array", path: ["values"] }
+    ).refine(
+      // Array fields must describe their element shape. Bare `type: 'array'`
+      // with no `items` forces downstream consumers (builders, UI renderers,
+      // persistence) to guess, so reject it at the schema boundary.
+      (field) => {
+        if (field.type !== "array") return true;
+        return field.items !== void 0;
+      },
+      { message: "Array field requires an `items` schema describing each element", path: ["items"] }
+    )
   )
 );
 var FieldSchema = EntityFieldSchema;
@@ -543,6 +582,8 @@ var RequiredFieldSchema = z.object({
 });
 var TraitReferenceSchema = z.object({
   ref: z.string().min(1),
+  // Phase 1.2: optional registry path disambiguator, pairs with `ref`.
+  from: z.string().optional(),
   linkedEntity: z.string().optional(),
   name: z.string().optional(),
   events: z.record(
@@ -982,6 +1023,8 @@ var PageRefStringSchema = z.string().regex(
 );
 var PageRefObjectSchema = z.object({
   ref: PageRefStringSchema,
+  // Phase 1.2: optional registry path disambiguator, pairs with `ref`.
+  from: z.string().optional(),
   path: z.string().startsWith("/").optional(),
   linkedEntity: z.string().optional(),
   traits: z.array(TraitRefSchema).optional()