@almadar/core 2.14.3 → 4.0.0

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { c as OrbitalSchema, S as State, O as OrbitalDefinition } from './schema-BFnZrBhm.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, 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 ComputedEventContract, w as ComputedEventContractSchema, x as ComputedEventListener, y as ComputedEventListenerSchema, z as CoreBinding, B as CustomPatternDefinition, D as CustomPatternDefinitionInput, F as CustomPatternDefinitionSchema, G as CustomPatternMap, H as CustomPatternMapInput, I as CustomPatternMapSchema, J as DerefEffect, K as DesignPreferences, L as DesignPreferencesInput, M as DesignPreferencesSchema, N as DesignTokens, Q as DesignTokensInput, R as DesignTokensSchema, U as DomainCategory, V as DomainCategorySchema, W as DomainContext, X as DomainContextInput, Y as DomainContextSchema, Z as DomainVocabulary, _ as DomainVocabularySchema, $ as ENTITY_ROLES, a0 as Effect, a1 as EffectInput, a2 as EffectSchema, e as Entity, a3 as EntityData, E as EntityField, a4 as EntityFieldInput, a5 as EntityFieldSchema, a as EntityPersistence, a6 as EntityPersistenceSchema, a7 as EntityRef, a8 as EntityRefSchema, a9 as EntityRefStringSchema, aa as EntityRole, ab as EntityRoleSchema, b as EntityRow, ac as EntitySchema, ad as EntitySemanticRole, ae as EntitySemanticRoleSchema, af as EvalContext, ag as Event, ah as EventInput, ai as EventListener, aj as EventListenerSchema, ak as EventPayload, al as EventPayloadField, am as EventPayloadFieldSchema, an as EventSchema, ao as EventScope, ap as EventScopeSchema, aq as EventSemanticRole, ar as EventSemanticRoleSchema, as as EventSource, at as EventSourceSchema, au as Expression, av as ExpressionInput, aw as ExpressionSchema, ax as Field, ay as FieldFormat, az as FieldFormatSchema, aA as FieldSchema, aB as FieldType, aC as FieldTypeSchema, aD as FieldValue, aE as FullOrbitalUnit, aF as GAME_TYPES, aG as GameSubCategory, aH as GameSubCategorySchema, aI as GameType, aJ as GameTypeSchema, aK as Guard, aL as GuardInput, aM as GuardSchema, aN as LogMeta, aO as McpServiceDef, aP as McpServiceDefSchema, aQ as NodeClassification, aR as NodeClassificationSchema, aE as Orbital, aS as OrbitalConfig, aT as OrbitalConfigInput, aU as OrbitalConfigSchema, aV as OrbitalDefinitionSchema, aW as OrbitalEntity, aX as OrbitalEntityInput, aY as OrbitalEntitySchema, aZ as OrbitalInput, a_ as OrbitalPage, a$ as OrbitalPageInput, b0 as OrbitalPageSchema, b1 as OrbitalPageStrictInput, b2 as OrbitalPageStrictSchema, b3 as OrbitalSchemaInput, b4 as OrbitalSchemaSchema, b5 as OrbitalTraitRef, b6 as OrbitalTraitRefSchema, b7 as OrbitalUnit, b8 as OrbitalUnitSchema, b9 as OrbitalZodSchema, P as Page, ba as PageRef, bb as PageRefObject, bc as PageRefObjectSchema, bd as PageRefSchema, be as PageRefStringSchema, bf as PageSchema, bg as PageTraitRef, bh as PageTraitRefSchema, bi as ParsedBinding, bj as PayloadField, bk as PayloadFieldSchema, bl as PresentationType, bm as RefEffect, bn as RelatedLink, bo as RelatedLinkSchema, bp as RelationConfig, bq as RelationConfigSchema, br as RenderUIConfig, bs as RenderUINode, bt as RequiredField, bu as RequiredFieldSchema, bv as ResolvedAsset, bw as ResolvedAssetInput, bx as ResolvedAssetSchema, by as ResolvedPatternProps, bz as RestAuthConfig, bA as RestAuthConfigSchema, bB as RestServiceDef, bC as RestServiceDefSchema, bD as SERVICE_TYPES, bE as SExpr, bF as SExprAtom, bG as SExprAtomSchema, bH as SExprInput, bI as SExprSchema, bJ as SemanticAssetRef, bK as SemanticAssetRefInput, bL as SemanticAssetRefSchema, bM as ServiceDefinition, bN as ServiceDefinitionSchema, bO as ServiceParams, bP as ServiceRef, bQ as ServiceRefSchema, bR as ServiceRefStringSchema, bS as ServiceType, bT as ServiceTypeSchema, bU as SocketEvents, bV as SocketEventsSchema, bW as SocketServiceDef, bX as SocketServiceDefSchema, bY as StateInput, bZ as StateMachine, b_ as StateMachineInput, b$ as StateMachineSchema, c0 as StateSchema, c1 as StateSemanticRole, c2 as StateSemanticRoleSchema, c3 as SuggestedGuard, c4 as SuggestedGuardSchema, c5 as SwapEffect, c6 as ThemeDefinition, c7 as ThemeDefinitionSchema, c8 as ThemeRef, c9 as ThemeRefSchema, ca as ThemeRefStringSchema, cb as ThemeTokens, cc as ThemeTokensSchema, cd as ThemeVariant, ce as ThemeVariantSchema, d as Trait, cf as TraitCategory, cg as TraitCategorySchema, ch as TraitDataEntity, ci as TraitDataEntitySchema, cj as TraitEntityField, ck as TraitEntityFieldSchema, T as TraitEventContract, cl as TraitEventContractSchema, cm as TraitEventListener, cn as TraitEventListenerSchema, co as TraitInput, cp as TraitRef, cq as TraitRefSchema, cr as TraitReference, cs as TraitReferenceInput, ct as TraitReferenceSchema, cu as TraitSchema, cv as TraitTick, cw as TraitTickSchema, cx as TraitUIBinding, cy as Transition, cz as TransitionInput, cA as TransitionSchema, cB as UISlot, cC as UISlotSchema, cD as UI_SLOTS, cE as UXHints, cF as UXHintsSchema, cG as UseDeclaration, cH as UseDeclarationSchema, cI as UserPersona, cJ as UserPersonaInput, cK as UserPersonaSchema, cL as VISUAL_STYLES, cM as ViewType, cN as ViewTypeSchema, cO as VisualStyle, cP as VisualStyleSchema, cQ as WatchEffect, cR as WatchOptions, cS as atomic, cT as callService, cU as collectBindings, cV as createAssetKey, cW as deref, cX as deriveCollection, cY as despawn, cZ as doEffects, c_ as emit, c$ as findService, d0 as getArgs, d1 as getDefaultAnimationsForRole, d2 as getOperator, d3 as getServiceNames, d4 as getTraitConfig, d5 as getTraitName, d6 as hasService, d7 as isBinding, d8 as isCircuitEvent, d9 as isEffect, da as isEntityReference, db as isImportedTraitRef, dc as isInlineTrait, dd as isMcpService, de as isOrbitalDefinition, df as isPageReference, dg as isPageReferenceObject, dh as isPageReferenceString, di as isRestService, dj as isRuntimeEntity, dk as isSExpr, dl as isSExprAtom, dm as isSExprCall, dn as isSExprEffect, dp as isServiceReference, dq as isSingletonEntity, dr as isSocketService, ds as isThemeReference, dt as isValidBinding, du as navigate, dv as normalizeTraitRef, dw as notify, dx as parseAssetKey, dy as parseBinding, dz as parseEntityRef, dA as parseImportedTraitRef, dB as parseOrbitalSchema, dC as parsePageRef, dD as parseServiceRef, dE as persist, dF as ref, dG as renderUI, dH as safeParseOrbitalSchema, dI as set, dJ as sexpr, dK as spawn, dL as swap, dM as validateAssetAnimations, dN as walkSExpr, dO as watch } from './schema-BFnZrBhm.js';
+import { c as OrbitalSchema, S as State, O as OrbitalDefinition } from './schema-CDA_dJjH.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, 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 ComputedEventContract, w as ComputedEventContractSchema, x as ComputedEventListener, y as ComputedEventListenerSchema, z as CoreBinding, B as CustomPatternDefinition, D as CustomPatternDefinitionInput, F as CustomPatternDefinitionSchema, G as CustomPatternMap, H as CustomPatternMapInput, I as CustomPatternMapSchema, J as DerefEffect, K as DesignPreferences, L as DesignPreferencesInput, M as DesignPreferencesSchema, N as DesignTokens, Q as DesignTokensInput, R as DesignTokensSchema, U as DomainCategory, V as DomainCategorySchema, W as DomainContext, X as DomainContextInput, Y as DomainContextSchema, Z as DomainVocabulary, _ as DomainVocabularySchema, $ as ENTITY_ROLES, a0 as Effect, a1 as EffectInput, a2 as EffectSchema, e as Entity, a3 as EntityCall, a4 as EntityCallSchema, a5 as EntityData, E as EntityField, a6 as EntityFieldInput, a7 as EntityFieldSchema, a as EntityPersistence, a8 as EntityPersistenceSchema, a9 as EntityRef, aa as EntityRefSchema, ab as EntityRefStringSchema, ac as EntityRole, ad as EntityRoleSchema, b as EntityRow, ae as EntitySchema, af as EntitySemanticRole, ag as EntitySemanticRoleSchema, ah as EvalContext, ai as Event, aj as EventInput, ak as EventListener, al as EventListenerSchema, am as EventPayload, an as EventPayloadField, ao as EventPayloadFieldSchema, ap as EventSchema, aq as EventScope, ar as EventScopeSchema, as as EventSemanticRole, at as EventSemanticRoleSchema, au as EventSource, av as EventSourceSchema, aw as Expression, ax as ExpressionInput, ay as ExpressionSchema, az as Field, aA as FieldFormat, aB as FieldFormatSchema, aC as FieldSchema, aD as FieldType, aE as FieldTypeSchema, aF as FieldValue, aG as FullOrbitalUnit, aH as GAME_TYPES, aI as GameSubCategory, aJ as GameSubCategorySchema, aK as GameType, aL as GameTypeSchema, aM as Guard, aN as GuardInput, aO as GuardSchema, aP as LogMeta, aQ as McpServiceDef, aR as McpServiceDefSchema, aS as NodeClassification, aT as NodeClassificationSchema, aG as Orbital, aU as OrbitalConfig, aV as OrbitalConfigInput, aW as OrbitalConfigSchema, aX as OrbitalDefinitionSchema, aY as OrbitalEntity, aZ as OrbitalEntityInput, a_ as OrbitalEntitySchema, a$ as OrbitalInput, b0 as OrbitalPage, b1 as OrbitalPageInput, b2 as OrbitalPageSchema, b3 as OrbitalPageStrictInput, b4 as OrbitalPageStrictSchema, b5 as OrbitalSchemaInput, b6 as OrbitalSchemaSchema, b7 as OrbitalTraitRef, b8 as OrbitalTraitRefSchema, b9 as OrbitalUnit, ba as OrbitalUnitSchema, bb as OrbitalZodSchema, P as Page, bc as PageRef, bd as PageRefObject, be as PageRefObjectSchema, bf as PageRefSchema, bg as PageRefStringSchema, bh as PageSchema, bi as PageTraitRef, bj as PageTraitRefSchema, bk as ParsedBinding, bl as PayloadField, bm as PayloadFieldSchema, bn as PresentationType, bo as RefEffect, bp as RelatedLink, bq as RelatedLinkSchema, br as RelationConfig, bs as RelationConfigSchema, bt as RenderUIConfig, bu as RenderUINode, bv as RequiredField, bw as RequiredFieldSchema, bx as ResolvedAsset, by as ResolvedAssetInput, bz as ResolvedAssetSchema, bA as ResolvedPatternProps, bB as RestAuthConfig, bC as RestAuthConfigSchema, bD as RestServiceDef, bE as RestServiceDefSchema, bF as SERVICE_TYPES, bG as SExpr, bH as SExprAtom, bI as SExprAtomSchema, bJ as SExprInput, bK as SExprSchema, bL as SemanticAssetRef, bM as SemanticAssetRefInput, bN as SemanticAssetRefSchema, bO as ServiceDefinition, bP as ServiceDefinitionSchema, bQ as ServiceParams, bR as ServiceRef, bS as ServiceRefObject, bT as ServiceRefObjectSchema, bU as ServiceRefSchema, bV as ServiceRefStringSchema, bW as ServiceType, bX as ServiceTypeSchema, bY as SocketEvents, bZ as SocketEventsSchema, b_ as SocketServiceDef, b$ as SocketServiceDefSchema, c0 as StateInput, c1 as StateMachine, c2 as StateMachineInput, c3 as StateMachineSchema, c4 as StateSchema, c5 as StateSemanticRole, c6 as StateSemanticRoleSchema, c7 as SuggestedGuard, c8 as SuggestedGuardSchema, c9 as SwapEffect, ca as ThemeDefinition, cb as ThemeDefinitionSchema, cc as ThemeRef, cd as ThemeRefSchema, ce as ThemeRefStringSchema, cf as ThemeTokens, cg as ThemeTokensSchema, ch as ThemeVariant, ci as ThemeVariantSchema, d as Trait, cj as TraitCategory, ck as TraitCategorySchema, cl as TraitDataEntity, cm as TraitDataEntitySchema, cn as TraitEntityField, co as TraitEntityFieldSchema, T as TraitEventContract, cp as TraitEventContractSchema, cq as TraitEventListener, cr as TraitEventListenerSchema, cs as TraitInput, ct as TraitRef, cu as TraitRefSchema, cv as TraitReference, cw as TraitReferenceInput, cx as TraitReferenceSchema, cy as TraitSchema, cz as TraitTick, cA as TraitTickSchema, cB as TraitUIBinding, cC as Transition, cD as TransitionInput, cE as TransitionSchema, cF as UISlot, cG as UISlotSchema, cH as UI_SLOTS, cI as UXHints, cJ as UXHintsSchema, cK as UseDeclaration, cL as UseDeclarationSchema, cM as UserPersona, cN as UserPersonaInput, cO as UserPersonaSchema, cP as VISUAL_STYLES, cQ as ViewType, cR as ViewTypeSchema, cS as VisualStyle, cT as VisualStyleSchema, cU as WatchEffect, cV as WatchOptions, cW as atomic, cX as callService, cY as collectBindings, cZ as createAssetKey, c_ as deref, c$ as deriveCollection, d0 as despawn, d1 as doEffects, d2 as emit, d3 as findService, d4 as getArgs, d5 as getDefaultAnimationsForRole, d6 as getOperator, d7 as getServiceNames, d8 as getTraitConfig, d9 as getTraitName, da as hasService, db as isBinding, dc as isCircuitEvent, dd as isEffect, de as isEntityCall, df as isEntityReference, dg as isEntityReferenceAny, dh as isImportedTraitRef, di as isInlineTrait, dj as isMcpService, dk as isOrbitalDefinition, dl as isPageReference, dm as isPageReferenceObject, dn as isPageReferenceString, dp as isRestService, dq as isRuntimeEntity, dr as isSExpr, ds as isSExprAtom, dt as isSExprCall, du as isSExprEffect, dv as isServiceReference, dw as isServiceReferenceObject, dx as isSingletonEntity, dy as isSocketService, dz as isThemeReference, dA as isValidBinding, dB as navigate, dC as normalizeTraitRef, dD as notify, dE as parseAssetKey, dF as parseBinding, dG as parseEntityRef, dH as parseImportedTraitRef, dI as parseOrbitalSchema, dJ as parsePageRef, dK as parseServiceRef, dL as persist, dM as ref, dN as renderUI, dO as safeParseOrbitalSchema, dP as set, dQ as sexpr, dR as spawn, dS as swap, dT as validateAssetAnimations, dU as walkSExpr, dV as watch } from './schema-CDA_dJjH.js';
 import { ResolvedIR, ResolvedEntity, ResolvedPage, ResolvedTrait, SchemaChange, CategorizedRemovals, PageContentReduction, SemanticSchemaChange } from './types/index.js';
 export { AgentCodeSearchResult, AgentCompactResult, AgentCompactStrategy, AgentContext, AgentGenerateOptions, AgentMemoryCategory, AgentMemoryRecord, AppSummary, BINDING_CONTEXT_RULES, BINDING_DOCS, BindingContext, BindingSchema, ChangeAuthor, ChangeSetDocument, ChangeSummary, CreateFlow, DEFAULT_INTERACTION_MODELS, DeleteFlow, EditFlow, GitHubLink, HistoryMeta, InteractionModel, InteractionModelInput, InteractionModelSchema, LazyService, ListInteraction, OperatorName, PatternTypeSchema, PersistActionName, ResolvedEntityBinding, ResolvedField, ResolvedNavigation, ResolvedPattern, ResolvedSection, ResolvedSectionEvent, ResolvedTraitBinding, ResolvedTraitDataEntity, ResolvedTraitEvent, ResolvedTraitGuard, ResolvedTraitListener, ResolvedTraitState, ResolvedTraitTick, ResolvedTraitTransition, ResolvedTraitUIBinding, SaveOptions, SaveResult, SemanticChangeKind, ServiceAction, ServiceActionName, ServiceContract, ServiceEvents, SnapshotDocument, StatsView, StoreContract, StoreFilter, StoreFilterOp, TransitionFrom, ValidationDocument, ValidationIssue, ValidationMeta, ValidationResults, ViewFlow, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, getAllOperators, getAllPatternTypes, getBindingExamples, getInteractionModelForDomain, inferTsType, isResolvedIR, validateBindingInContext } from './types/index.js';
 export { ASTNode, ComparisonCondition, ComparisonOperator, DomainBehavior, DomainChunk, DomainDocument, DomainEffect, DomainEntity, DomainField, DomainFieldType, DomainGuard, DomainPage, DomainPageAction, DomainPageSection, DomainRelationship, DomainTick, DomainToSchemaResult, DomainTransition, EFFECT_REGISTRY, EffectMapping, EffectType, FIELD_TYPE_REGISTRY, FieldCheckCondition, FieldReference, FieldTypeMapping, GUARD_REGISTRY, GuardCondition, GuardMapping, KEYWORDS, Lexer, LogicalCondition, LogicalOperator, MULTI_WORD_KEYWORDS, MappingStore, MergeResult, ParseError, ParseResult, RelationshipType, SchemaToDomainResult, SectionMapping, SourceLocation, SourceRange, Token, TokenType, UserCheckCondition, applySectionUpdate, computeSchemaHash, convertDomainToSchema, convertEntitiesToDomain, convertPagesToDomain, convertSchemaToDomain, convertTraitsToDomain, createMappingStore, deleteSection, detectChanges, domainKeywordToSchemaType, findMapping, findMappingByPath, findMappingsByType, formatBehaviorToDomain, formatBehaviorToSchema, formatDomainGuardToSchema, formatEntityToDomain, formatEntityToSchema, formatGuardConditionToDomain, formatGuardToDomain, formatGuardToSchema, formatMergeSummary, formatPageToDomain, formatPageToSchema, formatSchemaEntityToDomain, formatSchemaGuardToDomain, formatSchemaPageToDomain, formatSchemaTraitToDomain, generateDomainLanguageReference, generateSectionId, getEffectMapping, getFieldTypeMapping, getGuardMapping, getRegisteredEffects, getRegisteredFieldTypes, getRegisteredGuards, getRegistryStats, getSchemaPath, hasSchemaChanged, isEffectRegistered, isFieldTypeRegistered, isGuardRegistered, mergeDomainChunks, parseBehavior, parseDomainEffect, parseDomainEffects, parseDomainGuard, parseEntity, parseGuard, parsePage, parseSectionId, removeMapping, resolveConflict, schemaEntityToDomainEntity, schemaPageToDomainPage, schemaTraitToDomainBehavior, schemaTypeToDomainKeyword, tokenize, updateMappingRange, updateSchemaHash, upsertMapping, validateDomainChunk } from './domain-language/index.js';
-export { C as ComposeBehaviorsInput, a as ComposeBehaviorsResult, E as EventWiringEntry, L as LayoutStrategy, b as applyEventWiring, c as composeBehaviors, d as detectLayoutStrategy } from './compose-behaviors-CQC8hsaL.js';
+export { C as ComposeBehaviorsInput, a as ComposeBehaviorsResult, E as EventWiringEntry, L as LayoutStrategy, b as applyEventWiring, c as composeBehaviors, d as detectLayoutStrategy } from './compose-behaviors-DQTTCmR2.js';
 export { BFSNode, BFSPathNode, EdgeWalkTransition, GraphTransition, GuardPayload, ReplayStep, ReplayTransition, StateEdge, WalkStep, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, collectReachableStates, extractPayloadFieldRef, walkStatePairs } from './state-machine/index.js';
 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/index.js

@@ -544,9 +544,41 @@ var RequiredFieldSchema = z.object({
 var TraitReferenceSchema = z.object({
   ref: z.string().min(1),
   linkedEntity: z.string().optional(),
+  name: z.string().optional(),
+  events: z.record(
+    z.string().min(1, "events key (atom event name) must be non-empty"),
+    z.string().min(1, "events value (caller event name) must be non-empty")
+  ).optional(),
   config: z.record(z.record(z.unknown())).optional(),
-  appliesTo: z.array(z.string()).optional()
-});
+  appliesTo: z.array(z.string()).optional(),
+  // Phase F.7: zod accepts an array (the inliner validates element
+  // shape). The full ListenDefinition shape isn't recursively encoded
+  // here because TraitReference is the call-site form — listen entries
+  // pasted in are already-resolved structured definitions, not nested
+  // overrides.
+  listens: z.array(z.unknown()).optional(),
+  emitsScope: z.enum(["internal", "external"]).optional(),
+  // Phase F.8: per-transition effects override. The keys are event
+  // names (the transition triggers AFTER renames). Values are arrays
+  // of SExpression-shaped data; the inliner validates the SExpression
+  // shape during application, so the schema accepts loose `unknown[]`.
+  effects: z.record(
+    z.string().min(1, "effects override key (event name) must be non-empty"),
+    z.array(z.unknown())
+  ).optional()
+}).refine(
+  (ref2) => {
+    if (!ref2.events) return true;
+    for (const [from, to] of Object.entries(ref2.events)) {
+      if (from.length === 0 || to.length === 0) return false;
+    }
+    return true;
+  },
+  {
+    message: 'TraitReference "events" entries must have non-empty atom and caller event names',
+    path: ["events"]
+  }
+);
 var TraitSchema = z.object({
   name: z.string().min(1),
   description: z.string().optional(),
@@ -567,7 +599,15 @@ var TraitRefSchema = z.union([
   z.object({
     ref: z.string().min(1),
     config: z.record(z.unknown()).optional(),
-    linkedEntity: z.string().optional()
+    linkedEntity: z.string().optional(),
+    name: z.string().optional(),
+    // Phase F.4: same non-empty refine as TraitReferenceSchema.events.
+    // Both schemas accept the same call-site argument shape, so the
+    // validators should agree.
+    events: z.record(
+      z.string().min(1, "events key (atom event name) must be non-empty"),
+      z.string().min(1, "events value (caller event name) must be non-empty")
+    ).optional()
   }),
   TraitSchema
   // Allow inline trait definitions
@@ -831,12 +871,24 @@ var ServiceDefinitionSchema = z.discriminatedUnion("type", [
 function isServiceReference(service) {
   return typeof service === "string";
 }
+function isServiceReferenceObject(service) {
+  return typeof service === "object" && service !== null && "ref" in service && !("type" in service);
+}
 var ServiceRefStringSchema = z.string().regex(
   /^[A-Z][a-zA-Z0-9]*\.services\.[a-zA-Z][a-zA-Z0-9]*$/,
   'Service reference must be in format "Alias.services.ServiceName" (e.g., "Weather.services.openweather")'
 );
+var ServiceRefObjectSchema = z.object({
+  ref: ServiceRefStringSchema,
+  description: z.string().optional(),
+  baseUrl: z.string().url("baseUrl override must be a valid URL").optional(),
+  headers: z.record(z.string()).optional(),
+  url: z.string().url("url override must be a valid URL").optional(),
+  serverPath: z.string().optional()
+});
 var ServiceRefSchema = z.union([
   ServiceDefinitionSchema,
+  ServiceRefObjectSchema,
   ServiceRefStringSchema
 ]);
 function parseServiceRef(ref2) {
@@ -876,11 +928,45 @@ var UseDeclarationSchema = z.object({
 function isEntityReference(entity) {
   return typeof entity === "string";
 }
+function isEntityCall(entity) {
+  return typeof entity === "object" && entity !== null && "extends" in entity;
+}
+function isEntityReferenceAny(entity) {
+  return isEntityReference(entity) || isEntityCall(entity);
+}
 var EntityRefStringSchema = z.string().regex(
   /^[A-Z][a-zA-Z0-9]*\.entity$/,
   'Entity reference must be in format "Alias.entity" (e.g., "Goblin.entity")'
 );
-var EntityRefSchema = z.union([EntitySchema, EntityRefStringSchema]);
+var EntityCallSchema = z.object({
+  extends: z.string().regex(
+    /^[A-Z][a-zA-Z0-9]*\.entity$/,
+    'EntityCall "extends" must be in format "Alias.entity"'
+  ),
+  name: z.string().optional(),
+  fields: z.array(EntityFieldSchema).optional(),
+  persistence: EntityPersistenceSchema.optional(),
+  collection: z.string().optional()
+}).refine(
+  (call) => {
+    if (!call.fields) return true;
+    const seen = /* @__PURE__ */ new Set();
+    for (const field of call.fields) {
+      if (seen.has(field.name)) return false;
+      seen.add(field.name);
+    }
+    return true;
+  },
+  {
+    message: 'EntityCall "fields" override list must not contain duplicate field names',
+    path: ["fields"]
+  }
+);
+var EntityRefSchema = z.union([
+  EntitySchema,
+  EntityRefStringSchema,
+  EntityCallSchema
+]);
 function isPageReferenceString(page) {
   return typeof page === "string";
 }
@@ -896,7 +982,9 @@ var PageRefStringSchema = z.string().regex(
 );
 var PageRefObjectSchema = z.object({
   ref: PageRefStringSchema,
-  path: z.string().startsWith("/").optional()
+  path: z.string().startsWith("/").optional(),
+  linkedEntity: z.string().optional(),
+  traits: z.array(TraitRefSchema).optional()
 });
 var PageRefSchema = z.union([
   PageSchema,
@@ -1857,6 +1945,15 @@ function summarizeOrbital(orbital) {
   let entity;
   if (isEntityReference(orbital.entity)) {
     entity = { name: orbital.entity, fields: [] };
+  } else if (isEntityCall(orbital.entity)) {
+    const call = orbital.entity;
+    const name = call.name ?? parseEntityRef(call.extends)?.alias ?? call.extends;
+    entity = {
+      name,
+      fields: call.fields ?? [],
+      ...call.persistence ? { persistence: call.persistence } : {},
+      ...call.collection ? { collection: call.collection } : {}
+    };
   } else {
     entity = summarizeEntity(orbital.entity);
   }
@@ -6361,10 +6458,13 @@ function getEntityName(entity) {
   if (isEntityReference(entity)) {
     return entity.replace(".entity", "");
   }
+  if (isEntityCall(entity)) {
+    return entity.name ?? entity.extends.replace(".entity", "");
+  }
   return entity.name;
 }
 function isInlineEntity(entity) {
-  return !isEntityReference(entity);
+  return !isEntityReference(entity) && !isEntityCall(entity);
 }
 function isInlinePage(page) {
   return !isPageReferenceString(page) && !isPageReferenceObject(page);
@@ -6659,6 +6759,9 @@ function getEntityName2(entity) {
   if (isEntityReference(entity)) {
     return entity.replace(".entity", "");
   }
+  if (isEntityCall(entity)) {
+    return entity.name ?? entity.extends.replace(".entity", "");
+  }
   return entity.name;
 }
 function getPageName(page) {
@@ -8412,6 +8515,6 @@ function buildPayloadForEdge(transition, guardCase) {
   return {};
 }
 
-export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, AgentDomainCategorySchema, AnimationDefSchema, AssetMapSchema, AssetMappingSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BindingSchema, CORE_BINDINGS, ComputedEventContractSchema, ComputedEventListenerSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, EFFECT_REGISTRY, ENTITY_ROLES, EffectSchema, EntityFieldSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FIELD_TYPE_REGISTRY, FieldFormatSchema, FieldSchema, FieldTypeSchema, GAME_TYPES, GUARD_REGISTRY, GameSubCategorySchema, GameTypeSchema, GuardSchema, InteractionModelSchema, KEYWORDS, Lexer, MULTI_WORD_KEYWORDS, McpServiceDefSchema, NodeClassificationSchema, OrbitalConfigSchema, OrbitalDefinitionSchema, OrbitalEntitySchema, OrbitalPageSchema, OrbitalPageStrictSchema, OrbitalSchemaSchema, OrbitalTraitRefSchema, OrbitalUnitSchema, OrbitalSchema as OrbitalZodSchema, PageRefObjectSchema, PageRefSchema, PageRefStringSchema, PageSchema, PageTraitRefSchema, PatternTypeSchema, PayloadFieldSchema, RelatedLinkSchema, RelationConfigSchema, RequiredFieldSchema, ResolvedAssetSchema, RestAuthConfigSchema, RestServiceDefSchema, SERVICE_TYPES, SExprAtomSchema, SExprSchema, SemanticAssetRefSchema, ServiceDefinitionSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SocketEventsSchema, SocketServiceDefSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SuggestedGuardSchema, ThemeDefinitionSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TokenType, TraitCategorySchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, applyEventWiring, applySectionUpdate, atomic, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, callService, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectBindings, collectReachableStates, composeBehaviors, computeSchemaHash, convertDomainToSchema, convertEntitiesToDomain, convertPagesToDomain, convertSchemaToDomain, convertTraitsToDomain, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createMappingStore, createResolvedField, createTypedEventBus, deleteSection, deref, deriveCollection, despawn, detectChanges, detectLayoutStrategy, detectPageContentReduction, diffSchemaSemantics, diffSchemas, doEffects, domainKeywordToSchemaType, emit, extractPayloadFieldRef, findMapping, findMappingByPath, findMappingsByType, findService, formatBehaviorToDomain, formatBehaviorToSchema, formatDomainGuardToSchema, formatEntityToDomain, formatEntityToSchema, formatGuardConditionToDomain, formatGuardToDomain, formatGuardToSchema, formatMergeSummary, formatPageToDomain, formatPageToSchema, formatSchemaEntityToDomain, formatSchemaGuardToDomain, formatSchemaPageToDomain, formatSchemaTraitToDomain, generateDomainLanguageReference, generateSectionId, getAllOperators, getAllPatternTypes, getArgs, getBindingExamples, getDefaultAnimationsForRole, getEffectMapping, getEntity, getFieldTypeMapping, getGuardMapping, getInteractionModelForDomain, getOperator, getPage, getPages, getRegisteredEffects, getRegisteredFieldTypes, getRegisteredGuards, getRegistryStats, getRemovals, getSchemaCacheStats, getSchemaPath, getServiceNames, getTrait, getTraitConfig, getTraitName, hasSchemaChanged, hasService, hasSignificantPageReduction, inferTsType, isBinding, isCircuitEvent, isDestructiveChange, isEffect, isEffectRegistered, isEntityReference, isFieldTypeRegistered, isGuardRegistered, isImportedTraitRef, isInlineTrait, isMcpService, isOrbitalDefinition, isPageReference, isPageReferenceObject, isPageReferenceString, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceReference, isSingletonEntity, isSocketService, isThemeReference, isValidBinding, mergeDomainChunks, navigate, normalizeTraitRef, notify, parseAssetKey, parseBehavior, parseBinding, parseDomainEffect, parseDomainEffects, parseDomainGuard, parseEntity, parseEntityRef, parseGuard, parseImportedTraitRef, parseOrbitalSchema, parsePage, parsePageRef, parseSectionId, parseServiceRef, persist, ref, removeMapping, renderUI, requiresConfirmation, resolveConflict, safeParseOrbitalSchema, schemaEntityToDomainEntity, schemaPageToDomainPage, schemaToIR, schemaTraitToDomainBehavior, schemaTypeToDomainKeyword, set, sexpr, spawn, summarizeOrbital, summarizeSchema, swap, tokenize, updateMappingRange, updateSchemaHash, upsertMapping, validateAssetAnimations, validateBindingInContext, validateDomainChunk, walkSExpr, walkStatePairs, watch };
+export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, AgentDomainCategorySchema, AnimationDefSchema, AssetMapSchema, AssetMappingSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BindingSchema, CORE_BINDINGS, ComputedEventContractSchema, ComputedEventListenerSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, EFFECT_REGISTRY, ENTITY_ROLES, EffectSchema, EntityCallSchema, EntityFieldSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FIELD_TYPE_REGISTRY, FieldFormatSchema, FieldSchema, FieldTypeSchema, GAME_TYPES, GUARD_REGISTRY, GameSubCategorySchema, GameTypeSchema, GuardSchema, InteractionModelSchema, KEYWORDS, Lexer, MULTI_WORD_KEYWORDS, McpServiceDefSchema, NodeClassificationSchema, OrbitalConfigSchema, OrbitalDefinitionSchema, OrbitalEntitySchema, OrbitalPageSchema, OrbitalPageStrictSchema, OrbitalSchemaSchema, OrbitalTraitRefSchema, OrbitalUnitSchema, OrbitalSchema as OrbitalZodSchema, PageRefObjectSchema, PageRefSchema, PageRefStringSchema, PageSchema, PageTraitRefSchema, PatternTypeSchema, PayloadFieldSchema, RelatedLinkSchema, RelationConfigSchema, RequiredFieldSchema, ResolvedAssetSchema, RestAuthConfigSchema, RestServiceDefSchema, SERVICE_TYPES, SExprAtomSchema, SExprSchema, SemanticAssetRefSchema, ServiceDefinitionSchema, ServiceRefObjectSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SocketEventsSchema, SocketServiceDefSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SuggestedGuardSchema, ThemeDefinitionSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TokenType, TraitCategorySchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, applyEventWiring, applySectionUpdate, atomic, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, callService, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectBindings, collectReachableStates, composeBehaviors, computeSchemaHash, convertDomainToSchema, convertEntitiesToDomain, convertPagesToDomain, convertSchemaToDomain, convertTraitsToDomain, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createMappingStore, createResolvedField, createTypedEventBus, deleteSection, deref, deriveCollection, despawn, detectChanges, detectLayoutStrategy, detectPageContentReduction, diffSchemaSemantics, diffSchemas, doEffects, domainKeywordToSchemaType, emit, extractPayloadFieldRef, findMapping, findMappingByPath, findMappingsByType, findService, formatBehaviorToDomain, formatBehaviorToSchema, formatDomainGuardToSchema, formatEntityToDomain, formatEntityToSchema, formatGuardConditionToDomain, formatGuardToDomain, formatGuardToSchema, formatMergeSummary, formatPageToDomain, formatPageToSchema, formatSchemaEntityToDomain, formatSchemaGuardToDomain, formatSchemaPageToDomain, formatSchemaTraitToDomain, generateDomainLanguageReference, generateSectionId, getAllOperators, getAllPatternTypes, getArgs, getBindingExamples, getDefaultAnimationsForRole, getEffectMapping, getEntity, getFieldTypeMapping, getGuardMapping, getInteractionModelForDomain, getOperator, getPage, getPages, getRegisteredEffects, getRegisteredFieldTypes, getRegisteredGuards, getRegistryStats, getRemovals, getSchemaCacheStats, getSchemaPath, getServiceNames, getTrait, getTraitConfig, getTraitName, hasSchemaChanged, hasService, hasSignificantPageReduction, inferTsType, isBinding, isCircuitEvent, isDestructiveChange, isEffect, isEffectRegistered, isEntityCall, isEntityReference, isEntityReferenceAny, isFieldTypeRegistered, isGuardRegistered, isImportedTraitRef, isInlineTrait, isMcpService, isOrbitalDefinition, isPageReference, isPageReferenceObject, isPageReferenceString, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceReference, isServiceReferenceObject, isSingletonEntity, isSocketService, isThemeReference, isValidBinding, mergeDomainChunks, navigate, normalizeTraitRef, notify, parseAssetKey, parseBehavior, parseBinding, parseDomainEffect, parseDomainEffects, parseDomainGuard, parseEntity, parseEntityRef, parseGuard, parseImportedTraitRef, parseOrbitalSchema, parsePage, parsePageRef, parseSectionId, parseServiceRef, persist, ref, removeMapping, renderUI, requiresConfirmation, resolveConflict, safeParseOrbitalSchema, schemaEntityToDomainEntity, schemaPageToDomainPage, schemaToIR, schemaTraitToDomainBehavior, schemaTypeToDomainKeyword, set, sexpr, spawn, summarizeOrbital, summarizeSchema, swap, tokenize, updateMappingRange, updateSchemaHash, upsertMapping, validateAssetAnimations, validateBindingInContext, validateDomainChunk, walkSExpr, walkStatePairs, watch };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map