@almadar/core 4.4.2 → 4.6.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 { c as EntityRow, aL as FieldValue, bS as SExpr } from '../schema-CLFPg1xW.js';
+export { A as AGENT_DOMAIN_CATEGORIES, g as ALLOWED_CUSTOM_COMPONENTS, h as AgentDomainCategory, i as AgentDomainCategorySchema, j as AgentEffect, k as AllowedCustomComponent, l as AnimationDef, m as AnimationDefInput, n as AnimationDefSchema, d as AppSchema, o as AssetMap, p as AssetMapInput, q as AssetMapSchema, r as AssetMapping, s as AssetMappingInput, t as AssetMappingSchema, u as AtomicEffect, C as CORE_BINDINGS, v as CallServiceConfig, w as CallServiceEffect, x as ComputedEventContract, y as ComputedEventContractSchema, z as ComputedEventListener, B as ComputedEventListenerSchema, D as CoreBinding, F as CustomPatternDefinition, G as CustomPatternDefinitionInput, H as CustomPatternDefinitionSchema, I as CustomPatternMap, J as CustomPatternMapInput, K as CustomPatternMapSchema, L as DerefEffect, M as DesignPreferences, N as DesignPreferencesInput, Q as DesignPreferencesSchema, R as DesignTokens, U as DesignTokensInput, V as DesignTokensSchema, W as DespawnEffect, X as DoEffect, Y as DomainCategory, Z as DomainCategorySchema, _ as DomainContext, $ as DomainContextInput, a0 as DomainContextSchema, a1 as DomainVocabulary, a2 as DomainVocabularySchema, a3 as ENTITY_ROLES, a4 as Effect, a5 as EffectInput, a6 as EffectSchema, a7 as EmitEffect, f as Entity, a8 as EntityCall, a9 as EntityCallSchema, aa as EntityData, E as EntityField, ab as EntityFieldInput, ac as EntityFieldSchema, b as EntityPersistence, ad as EntityPersistenceSchema, ae as EntityRef, af as EntityRefSchema, ag as EntityRefStringSchema, ah as EntityRole, ai as EntityRoleSchema, aj as EntitySchema, ak as EntitySemanticRole, al as EntitySemanticRoleSchema, am as EvalContext, an as Event, ao as EventInput, ap as EventListener, aq as EventListenerSchema, ar as EventPayload, as as EventPayloadField, at as EventPayloadFieldSchema, au as EventSchema, av as EventScope, aw as EventScopeSchema, ax as EventSemanticRole, ay as EventSemanticRoleSchema, az as EventSource, aA as EventSourceSchema, aB as Expression, aC as ExpressionInput, aD as ExpressionSchema, aE as FetchEffect, aF as Field, aG as FieldFormat, aH as FieldFormatSchema, aI as FieldSchema, aJ as FieldType, aK as FieldTypeSchema, aM as FullOrbitalUnit, aN as GAME_TYPES, aO as GameSubCategory, aP as GameSubCategorySchema, aQ as GameType, aR as GameTypeSchema, aS as Guard, aT as GuardInput, aU as GuardSchema, aV as LogEffect, aW as LogMeta, aX as McpServiceDef, aY as McpServiceDefSchema, aZ as NavigateEffect, a_ as NodeClassification, a$ as NodeClassificationSchema, b0 as NotifyEffect, aM as Orbital, b1 as OrbitalConfig, b2 as OrbitalConfigInput, b3 as OrbitalConfigSchema, O as OrbitalDefinition, b4 as OrbitalDefinitionSchema, b5 as OrbitalEntity, b6 as OrbitalEntityInput, b7 as OrbitalEntitySchema, b8 as OrbitalInput, b9 as OrbitalPage, ba as OrbitalPageInput, bb as OrbitalPageSchema, bc as OrbitalPageStrictInput, bd as OrbitalPageStrictSchema, d as OrbitalSchema, be as OrbitalSchemaInput, bf as OrbitalSchemaSchema, bg as OrbitalTraitRef, bh as OrbitalTraitRefSchema, bi as OrbitalUnit, bj as OrbitalUnitSchema, bk as OrbitalZodSchema, P as Page, bl as PageRef, bm as PageRefObject, bn as PageRefObjectSchema, bo as PageRefSchema, bp as PageRefStringSchema, bq as PageSchema, br as PageTraitRef, bs as PageTraitRefSchema, bt as ParsedBinding, bu as PayloadField, bv as PayloadFieldSchema, bw as PersistEffect, bx as PresentationType, by as RefEffect, bz as RelatedLink, bA as RelatedLinkSchema, bB as RelationConfig, bC as RelationConfigSchema, bD as RenderItemLambda, bE as RenderUIConfig, bF as RenderUIEffect, bG as RenderUINode, bH as RequiredField, bI as RequiredFieldSchema, bJ as ResolvedAsset, bK as ResolvedAssetInput, bL as ResolvedAssetSchema, bM as ResolvedPatternProps, bN as RestAuthConfig, bO as RestAuthConfigSchema, bP as RestServiceDef, bQ as RestServiceDefSchema, bR as SERVICE_TYPES, bT as SExprAtom, bU as SExprAtomSchema, bV as SExprInput, bW as SExprSchema, bX as SemanticAssetRef, bY as SemanticAssetRefInput, bZ as SemanticAssetRefSchema, b_ as ServiceDefinition, b$ as ServiceDefinitionSchema, c0 as ServiceParams, c1 as ServiceRef, c2 as ServiceRefObject, c3 as ServiceRefObjectSchema, c4 as ServiceRefSchema, c5 as ServiceRefStringSchema, c6 as ServiceType, c7 as ServiceTypeSchema, c8 as SetEffect, c9 as SocketEvents, ca as SocketEventsSchema, cb as SocketServiceDef, cc as SocketServiceDefSchema, cd as SpawnEffect, S as State, ce as StateInput, cf as StateMachine, cg as StateMachineInput, ch as StateMachineSchema, ci as StateSchema, cj as StateSemanticRole, ck as StateSemanticRoleSchema, cl as SuggestedGuard, cm as SuggestedGuardSchema, cn as SwapEffect, co as ThemeDefinition, cp as ThemeDefinitionSchema, cq as ThemeRef, cr as ThemeRefSchema, cs as ThemeRefStringSchema, ct as ThemeTokens, cu as ThemeTokensSchema, cv as ThemeVariant, cw as ThemeVariantSchema, e as Trait, cx as TraitCategory, cy as TraitCategorySchema, cz as TraitDataEntity, cA as TraitDataEntitySchema, cB as TraitEntityField, cC as TraitEntityFieldSchema, a as TraitEventContract, cD as TraitEventContractSchema, cE as TraitEventListener, cF as TraitEventListenerSchema, cG as TraitInput, cH as TraitRef, cI as TraitRefSchema, T 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-CLFPg1xW.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,34 +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"] }
-  ).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;
+  () => 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;
     },
-    { message: "Enum field requires a non-empty `values` array", path: ["values"] }
+    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;
@@ -555,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(
@@ -994,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()