@almadar/core 10.35.0 → 10.37.0

package/dist/index.d.ts

@@ -1,14 +1,14 @@
-import { a as OrbitalDefinition, O as OrbitalSchema } from './builders-CBL9rED-.js';
-export { A as AGENT_DOMAIN_CATEGORIES, b as ALLOWED_CUSTOM_COMPONENTS, c as AgentDomainCategory, d as AgentDomainCategorySchema, e as AllowedCustomComponent, C as ColorSlice, f as ColorSliceSchema, g as ColorTokens, h as ColorTokensSchema, i as ComposeBehaviorsInput, j as ComposeBehaviorsResult, k as ComputedEventContract, l as ComputedEventContractSchema, m as ComputedEventListener, n as ComputedEventListenerSchema, o as ConfigProvenanceRecord, p as ConfigProvenanceRecordSchema, q as CustomPatternDefinition, r as CustomPatternDefinitionInput, s as CustomPatternDefinitionSchema, t as CustomPatternMap, u as CustomPatternMapInput, v as CustomPatternMapSchema, D as DensitySlice, w as DensitySliceSchema, x as DensityTokens, y as DensityTokensSchema, z as DesignPreferences, B as DesignPreferencesInput, E as DesignPreferencesSchema, F as DesignTokens, G as DesignTokensInput, H as DesignTokensSchema, I as DomainCategory, J as DomainCategorySchema, K as DomainContext, L as DomainContextInput, N as DomainContextSchema, P as DomainVocabulary, Q as DomainVocabularySchema, R as ElevationSlice, S as ElevationSliceSchema, T as ElevationTokens, U as ElevationTokensSchema, V as EntityCall, W as EntityCallSchema, X as EntityRef, Y as EntityRefSchema, Z as EntityRefStringSchema, _ as EntitySemanticRole, $ as EntitySemanticRoleSchema, a0 as EventListener, a1 as EventListenerSchema, a2 as EventSemanticRole, a3 as EventSemanticRoleSchema, a4 as EventSource, a5 as EventSourceSchema, a6 as EventWiringEntry, a7 as FullOrbitalUnit, a8 as GameSubCategory, a9 as GameSubCategorySchema, aa as GeometrySlice, ab as GeometrySliceSchema, ac as GeometryTokens, ad as GeometryTokensSchema, ae as IconFamily, af as IconFamilySchema, ag as IconographySlice, ah as IconographySliceSchema, ai as IconographyTokens, aj as IconographyTokensSchema, ak as IllustrationSlice, al as IllustrationSliceSchema, am as IllustrationStyle, an as IllustrationStyleSchema, ao as IllustrationTokens, ap as IllustrationTokensSchema, aq as LayoutStrategy, ar as MotionDurationKey, as as MotionDurationKeySchema, at as MotionDurationPalette, au as MotionDurationPaletteSchema, av as MotionEasingKey, aw as MotionEasingKeySchema, ax as MotionEasingPalette, ay as MotionEasingPaletteSchema, az as MotionIntent, aA as MotionIntentMap, aB as MotionIntentMapSchema, aC as MotionIntentSchema, aD as MotionSlice, aE as MotionSliceSchema, aF as MotionTokens, aG as MotionTokensSchema, aH as NodeClassification, aI as NodeClassificationSchema, a7 as Orbital, aJ as OrbitalConfig, aK as OrbitalConfigInput, aL as OrbitalConfigSchema, aM as OrbitalDefinitionSchema, aN as OrbitalInput, aO as OrbitalPage, aP as OrbitalPageInput, aQ as OrbitalPageSchema, aR as OrbitalPageStrictInput, aS as OrbitalPageStrictSchema, aT as OrbitalSchemaInput, aU as OrbitalSchemaSchema, aV as OrbitalSchemaWithTraits, aW as OrbitalUnit, aX as OrbitalUnitSchema, aY as OrbitalZodSchema, aZ as Page, a_ as PageRef, a$ as PageRefObject, b0 as PageRefObjectSchema, b1 as PageRefSchema, b2 as PageRefStringSchema, b3 as PageSchema, b4 as PageTraitRef, b5 as PageTraitRefSchema, b6 as RelatedLink, b7 as RelatedLinkSchema, b8 as SchemaMetadata, b9 as SchemaMetadataSchema, ba as SkinSpec, bb as SkinSpecSchema, bc as SpacingScale, bd as SpacingScaleSchema, be as StateSemanticRole, bf as StateSemanticRoleSchema, bg as SuggestedGuard, bh as SuggestedGuardSchema, bi as ThemeDefinition, bj as ThemeDefinitionSchema, bk as ThemeRef, bl as ThemeRefSchema, bm as ThemeRefStringSchema, bn as ThemeTokens, bo as ThemeTokensSchema, bp as ThemeVariant, bq as ThemeVariantSchema, br as TypeIntent, bs as TypeIntentMap, bt as TypeIntentMapSchema, bu as TypeIntentSchema, bv as TypeScale, bw as TypeScaleEntry, bx as TypeScaleEntrySchema, by as TypeScaleSchema, bz as TypeScaleTokens, bA as TypeScaleTokensSchema, bB as TypeSizeKey, bC as TypeSizeKeySchema, bD as TypeSlice, bE as TypeSliceSchema, bF as TypeSlot, bG as TypeSlotSchema, bH as TypeWeight, bI as TypeWeightSchema, bJ as UXHints, bK as UXHintsSchema, bL as UseDeclaration, bM as UseDeclarationSchema, bN as UserPersona, bO as UserPersonaInput, bP as UserPersonaSchema, bQ as ViewType, bR as ViewTypeSchema, bS as applyEventWiring, bT as composeBehaviors, bU as detectLayoutStrategy, bV as isEntityCall, bW as isEntityReference, bX as isEntityReferenceAny, bY as isImportedTraitRef, bZ as isOrbitalDefinition, b_ as isPageReference, b$ as isPageReferenceObject, c0 as isPageReferenceString, c1 as isThemeReference, c2 as parseEntityRef, c3 as parseImportedTraitRef, c4 as parseOrbitalSchema, c5 as parsePageRef, c6 as safeParseOrbitalSchema } from './builders-CBL9rED-.js';
+import { a as OrbitalDefinition, O as OrbitalSchema } from './builders-CBdyt_gd.js';
+export { A as AGENT_DOMAIN_CATEGORIES, b as ALLOWED_CUSTOM_COMPONENTS, c as AgentDomainCategory, d as AgentDomainCategorySchema, e as AllowedCustomComponent, C as ColorSlice, f as ColorSliceSchema, g as ColorTokens, h as ColorTokensSchema, i as ComposeBehaviorsInput, j as ComposeBehaviorsResult, k as ComputedEventContract, l as ComputedEventContractSchema, m as ComputedEventListener, n as ComputedEventListenerSchema, o as ConfigProvenanceRecord, p as ConfigProvenanceRecordSchema, q as CustomPatternDefinition, r as CustomPatternDefinitionInput, s as CustomPatternDefinitionSchema, t as CustomPatternMap, u as CustomPatternMapInput, v as CustomPatternMapSchema, D as DensitySlice, w as DensitySliceSchema, x as DensityTokens, y as DensityTokensSchema, z as DesignPreferences, B as DesignPreferencesInput, E as DesignPreferencesSchema, F as DesignTokens, G as DesignTokensInput, H as DesignTokensSchema, I as DomainCategory, J as DomainCategorySchema, K as DomainContext, L as DomainContextInput, N as DomainContextSchema, P as DomainVocabulary, Q as DomainVocabularySchema, R as ElevationSlice, S as ElevationSliceSchema, T as ElevationTokens, U as ElevationTokensSchema, V as EntityCall, W as EntityCallSchema, X as EntityRef, Y as EntityRefSchema, Z as EntityRefStringSchema, _ as EntitySemanticRole, $ as EntitySemanticRoleSchema, a0 as EventListener, a1 as EventListenerSchema, a2 as EventSemanticRole, a3 as EventSemanticRoleSchema, a4 as EventSource, a5 as EventSourceSchema, a6 as EventWiringEntry, a7 as FullOrbitalUnit, a8 as GameSubCategory, a9 as GameSubCategorySchema, aa as GeometrySlice, ab as GeometrySliceSchema, ac as GeometryTokens, ad as GeometryTokensSchema, ae as IconFamily, af as IconFamilySchema, ag as IconographySlice, ah as IconographySliceSchema, ai as IconographyTokens, aj as IconographyTokensSchema, ak as IllustrationSlice, al as IllustrationSliceSchema, am as IllustrationStyle, an as IllustrationStyleSchema, ao as IllustrationTokens, ap as IllustrationTokensSchema, aq as LayoutStrategy, ar as MotionDurationKey, as as MotionDurationKeySchema, at as MotionDurationPalette, au as MotionDurationPaletteSchema, av as MotionEasingKey, aw as MotionEasingKeySchema, ax as MotionEasingPalette, ay as MotionEasingPaletteSchema, az as MotionIntent, aA as MotionIntentMap, aB as MotionIntentMapSchema, aC as MotionIntentSchema, aD as MotionSlice, aE as MotionSliceSchema, aF as MotionTokens, aG as MotionTokensSchema, aH as NodeClassification, aI as NodeClassificationSchema, a7 as Orbital, aJ as OrbitalConfig, aK as OrbitalConfigInput, aL as OrbitalConfigSchema, aM as OrbitalDefinitionSchema, aN as OrbitalInput, aO as OrbitalPage, aP as OrbitalPageInput, aQ as OrbitalPageSchema, aR as OrbitalPageStrictInput, aS as OrbitalPageStrictSchema, aT as OrbitalSchemaInput, aU as OrbitalSchemaSchema, aV as OrbitalSchemaWithTraits, aW as OrbitalUnit, aX as OrbitalUnitSchema, aY as OrbitalZodSchema, aZ as Page, a_ as PageRef, a$ as PageRefObject, b0 as PageRefObjectSchema, b1 as PageRefSchema, b2 as PageRefStringSchema, b3 as PageSchema, b4 as PageTraitRef, b5 as PageTraitRefSchema, b6 as RelatedLink, b7 as RelatedLinkSchema, b8 as SchemaMetadata, b9 as SchemaMetadataSchema, ba as SkinSpec, bb as SkinSpecSchema, bc as SpacingScale, bd as SpacingScaleSchema, be as StateSemanticRole, bf as StateSemanticRoleSchema, bg as SuggestedGuard, bh as SuggestedGuardSchema, bi as ThemeDefinition, bj as ThemeDefinitionSchema, bk as ThemeRef, bl as ThemeRefSchema, bm as ThemeRefStringSchema, bn as ThemeTokens, bo as ThemeTokensSchema, bp as ThemeVariant, bq as ThemeVariantSchema, br as TypeIntent, bs as TypeIntentMap, bt as TypeIntentMapSchema, bu as TypeIntentSchema, bv as TypeScale, bw as TypeScaleEntry, bx as TypeScaleEntrySchema, by as TypeScaleSchema, bz as TypeScaleTokens, bA as TypeScaleTokensSchema, bB as TypeSizeKey, bC as TypeSizeKeySchema, bD as TypeSlice, bE as TypeSliceSchema, bF as TypeSlot, bG as TypeSlotSchema, bH as TypeWeight, bI as TypeWeightSchema, bJ as UXHints, bK as UXHintsSchema, bL as UseDeclaration, bM as UseDeclarationSchema, bN as UserPersona, bO as UserPersonaInput, bP as UserPersonaSchema, bQ as ViewType, bR as ViewTypeSchema, bS as applyEventWiring, bT as composeBehaviors, bU as detectLayoutStrategy, bV as isEntityCall, bW as isEntityReference, bX as isEntityReferenceAny, bY as isImportedTraitRef, bZ as isOrbitalDefinition, b_ as isPageReference, b$ as isPageReferenceObject, c0 as isPageReferenceString, c1 as isThemeReference, c2 as parseEntityRef, c3 as parseImportedTraitRef, c4 as parseOrbitalSchema, c5 as parsePageRef, c6 as safeParseOrbitalSchema } from './builders-CBdyt_gd.js';
 import { f as ToolArgs, J as JsonValue, F as FieldValue, g as EntityRow } from './effect-Cd6ibbZc.js';
 export { h as ANIMATION_NAMES, i as ASSET_ASPECTS, j as ASSET_DIMENSIONS, k as AgentEffect, l as AnimationDef, m as AnimationDefInput, n as AnimationDefSchema, o as AnimationName, p as AnimationNameSchema, A as AnyPatternConfig, q as ApplicationEffect, r as ArrayEntityField, s as Asset, t as AssetAspect, u as AssetAspectSchema, v as AssetCatalog, w as AssetCatalogEntry, x as AssetCatalogEntryInput, y as AssetCatalogEntrySchema, z as AssetCatalogSchema, B as AssetDimension, C as AssetDimensionSchema, D as AssetSchema, G as AssetUrl, H as AtomicEffect, I as BehaviorEffect, K as CAMERA_MODES, L as CallServiceConfig, M as CallServiceEffect, N as Camera, Q as CameraMode, S as CameraModeSchema, U as CameraSchema, V as CheckpointLoadEffect, W as CheckpointSaveEffect, X as ComposeEffect, Y as DerefEffect, Z as DespawnEffect, _ as DoEffect, $ as ENTITY_ROLES, c as Effect, a0 as EffectInput, a1 as EffectSchema, a2 as EmitConfig, a3 as EmitEffect, e as Entity, a4 as EntityData, E as EntityField, a5 as EntityFieldInput, a6 as EntityFieldSchema, d as EntityId, a7 as EntityIdSchema, a as EntityPersistence, a8 as EntityPersistenceSchema, a9 as EntityRole, aa as EntityRoleSchema, ab as EntitySchema, ac as EntityWith, ad as EnumEntityField, ae as EvaluateConfig, af as EvaluateEffect, b as EventId, ag as EventIdSchema, ah as FetchEffect, ai as FetchOptions, aj as FetchResult, ak as Field, al as FieldFormat, am as FieldFormatSchema, an as FieldSchema, ao as FieldType, ap as FieldTypeSchema, aq as ForwardConfig, ar as ForwardEffect, as as IdForKind, at as IdKind, au as IdentityLedger, av as IdentityLedgerSchema, aw as JsonObject, ax as LedgerEntry, ay as LedgerEntrySchema, az as LedgerKind, aA as LedgerKindSchema, aB as LlmEffect, aC as LogEffect, aD as McpServiceDef, aE as McpServiceDefSchema, aF as MemoryEffect, aG as NavigateEffect, aH as NnConfig, aI as NnLayer, aJ as NotifyEffect, aK as OrbitalEntity, aL as OrbitalEntityInput, aM as OrbitalEntitySchema, O as OrbitalId, aN as OrbitalIdSchema, aO as OsEffect, aP as PATTERN_TYPES, P as PageId, aQ as PageIdSchema, aR as PaletteEntryId, aS as PaletteEntryIdSchema, aT as PatternConfig, aU as PatternProps, aV as PatternPropsMap, aW as PatternType, aX as PersistData, aY as PersistEffect, aZ as PersistEmitConfig, a_ as RefEffect, R as RelationConfig, a$ as RelationConfigSchema, b0 as RelationEntityField, b1 as RenderBinding, b2 as RenderChildrenMap, b3 as RenderItemLambda, b4 as RenderUIEffect, b5 as RenderUINode, b6 as ResolvedPatternProps, b7 as RestAuthConfig, b8 as RestAuthConfigSchema, b9 as RestServiceDef, ba as RestServiceDefSchema, bb as SERVICE_TYPES, bc as SPRITE_DIRECTIONS, bd as ScalarEntityField, be as ScenePos, bf as ScenePosSchema, bg as SemanticAssetRef, bh as SemanticAssetRefInput, bi as SemanticAssetRefSchema, bj as ServiceDefinition, bk as ServiceDefinitionSchema, bl as ServiceId, bm as ServiceIdSchema, bn as ServiceParams, bo as ServiceParamsValue, bp as ServiceRef, bq as ServiceRefObject, br as ServiceRefObjectSchema, bs as ServiceRefSchema, bt as ServiceRefStringSchema, bu as ServiceType, bv as ServiceTypeSchema, bw as SessionEffect, bx as SetEffect, by as SocketEvents, bz as SocketEventsSchema, bA as SocketServiceDef, bB as SocketServiceDefSchema, bC as SpawnEffect, bD as SpriteDirection, bE as SpriteDirectionSchema, bF as SpriteSheetAtlas, bG as SpriteSheetAtlasInput, bH as SpriteSheetAtlasSchema, bI as SubTexture, bJ as SubTextureSchema, bK as SwapEffect, bL as TextureAtlas, bM as TextureAtlasSchema, bN as ThemeId, bO as ThemeIdSchema, bP as Tilesheet, bQ as TilesheetSchema, bR as TraceEffect, bS as TrainConfig, bT as TrainEffect, T as TraitId, bU as TraitIdSchema, bV as TypedEffect, bW as UISlot, bX as UISlotSchema, bY as UI_SLOTS, bZ as VISUAL_STYLES, b_ as ValidateEffect, b$ as VisualStyle, c0 as VisualStyleSchema, c1 as WatchEffect, c2 as WatchOptions, c3 as asEntityId, c4 as asEventId, c5 as asOrbitalId, c6 as asPageId, c7 as asPaletteEntryId, c8 as asServiceId, c9 as asThemeId, ca as asTraitId, cb as atomic, cc as callService, cd as createAssetKey, ce as deref, cf as deriveCollection, cg as despawn, ch as doEffects, ci as emit, cj as findService, ck as getDefaultAnimationsForRole, cl as getServiceNames, cm as hasService, cn as idKindOf, co as idPrefix, cp as isEffect, cq as isEntityId, cr as isEventId, cs as isFieldValue, ct as isJsonArray, cu as isJsonObject, cv as isJsonPrimitive, cw as isMcpService, cx as isOrbitalId, cy as isPageId, cz as isPaletteEntryId, cA as isRestService, cB as isRuntimeEntity, cC as isSExprEffect, cD as isServiceId, cE as isServiceReference, cF as isServiceReferenceObject, cG as isSocketService, cH as isThemeId, cI as isTraitId, cJ as isValidPatternType, cK as ledgerCurName, cL as ledgerRename, cM as ledgerResolveName, cN as mintId, cO as navigate, cP as notify, cQ as parseAssetKey, cR as parseServiceRef, cS as persist, cT as persistenceModeAllowsOverrides, cU as ref, cV as renderUI, cW as set, cX as spawn, cY as swap, cZ as validateAssetAnimations, c_ as watch } from './effect-Cd6ibbZc.js';
 import { S as SExpr, a as EventPayload } from './expression-DpAj1RzP.js';
 export { C as CORE_BINDINGS, b as CoreBinding, c as EvalContext, d as EventPayloadValue, E as Expression, e as ExpressionInput, f as ExpressionSchema, L as LogMeta, g as LogMetaValue, P as ParsedBinding, h as SExprAtom, i as SExprAtomSchema, j as SExprInput, k as SExprSchema, l as collectBindings, m as getArgs, n as getOperator, o as isBinding, p as isEventPayloadValue, q as isSExpr, r as isSExprAtom, s as isSExprCall, t as isValidBinding, u as parseBinding, v as sexpr, w as walkSExpr } from './expression-DpAj1RzP.js';
 import { ResolvedIR, ResolvedEntity, ResolvedPage, ResolvedTrait, ChangesetValue, SchemaChange, CategorizedRemovals, PageContentReduction, SemanticSchemaChange } from './types/index.js';
-export { AgentCodeSearchResult, AgentCompactResult, AgentCompactStrategy, AgentContext, AgentGenerateOptions, AgentMemoryCategory, AgentMemoryRecord, AnalysisOrbital, AnalysisOrbitalParams, AnalysisPageOverride, AnalysisRename, AnalysisResult, AnnotationTier, AppCreatedEvent, AppSummary, AssetLoadStatus, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingContext, BindingRoot, BindingSchema, BridgeHealth, BuilderResult, BusEvent, BusEventListener, BusEventSource, CancelledEvent, ChangeAuthor, ChangeSetDocument, ChangeSummary, ChangesetRecordedEvent, CheckStatus, Clarification, ClarificationCandidate, ClarificationLevel, CompleteEvent, ComplexityAssessment, ComposeAllResult, ComposeChildrenResult, ComposeOptions, ContextExtensions, CreateFlow, DEFAULT_INTERACTION_MODELS, DeleteFlow, DispatchUpdatesResult, EdgeType, EditFlow, EffectPayload, EffectResult, EffectTrace, ErrorEvent, EventEmit, EventKey, EventListen, EventLogEntry, EvolutionDelta, ExecutePlanResult, ExtraTraitRef, FileOperationEvent, FileWrittenEvent, GateState, GenerationLogEvent, GitHubIssue, GitHubLink, GitHubRepo, HistoryMeta, IntegrationContext, InteractionModel, InteractionModelInput, InteractionModelSchema, InterruptEvent, KNOWN_VALIDATION_ERROR_CODES, KnobPayload, KnownValidationErrorCode, LazyService, LineageEntry, ListInteraction, LivingEdge, LivingEffect, LivingEntity, LivingEvent, LivingField, LivingOrbital, LivingOrbitalSchema, LivingPage, LivingState, LivingTrait, LivingTransition, LivingValue, LivingVertex, LlmCallToolsResult, LlmContext, LlmMessage, LlmTokenUsage, LlmToolCall, LlmToolDef, LoloEmitResult, MemoryContext, MessageEvent, OrbitalAddedEvent, OrbitalSchemaCompleteEvent, OrbitalVerificationAPI, ParamsRepairEmittedEvent, ParsedDesign, ParsedDomainContext, ParsedEmitDeclaration, ParsedEntity, ParsedEvent, ParsedListenDeclaration, ParsedOrbital, ParsedPage, ParsedState, ParsedStateMachine, ParsedTrait, ParsedTraitConfig, ParsedTransition, PatternTypeSchema, PersistActionName, PlanSnapshot, PlanSnapshotStatus, PlannerResult, Probability, ProcessCompleteEvent, ProcessErrorEvent, ProcessRepairCompleteEvent, ProcessRepairEvent, ProcessStartEvent, RepairResult, ResolvedEntityBinding, ResolvedField, ResolvedNavigation, ResolvedPattern, ResolvedSection, ResolvedSectionEvent, ResolvedTraitBinding, ResolvedTraitDataEntity, ResolvedTraitEvent, ResolvedTraitGuard, ResolvedTraitListener, ResolvedTraitState, ResolvedTraitTick, ResolvedTraitTransition, ResolvedTraitUIBinding, SSEEvent, SSEEventBase, SSEEventType, SaveOptions, SaveResult, SchemaPhaseUpdateEvent, SchemaPhaseValidatedEvent, SchemaUpdateEvent, SemanticAnnotation, SemanticChangeKind, SemanticVector, ServerResponseTrace, ServiceAction, ServiceActionName, ServiceCallResult, ServiceContract, ServiceEvents, SessionContext, SessionHistoryEntry, SnapshotCreatedEvent, SnapshotDocument, SpawnResult, StartEvent, StatsView, StoreContract, StoreFilter, StoreFilterOp, SubagentCompleteEvent, SubagentEvent, SubagentProgressEvent, SubagentStartEvent, TodoActivityType, TodoDetailEvent, TodoUpdateEvent, ToolCallEvent, ToolResultEvent, TraceContext, TraitFieldRef, TraitFieldRefSchema, TraitStateSnapshot, TransitionFrom, TransitionTrace, Unsubscribe, ValidateResult, ValidationDocument, ValidationError, ValidationErrorCode, ValidationIssue, ValidationMeta, ValidationResult, ValidationResults, VerificationCheck, VerificationSnapshot, VerificationSummary, VertexId, VertexPayload, VertexType, ViewFlow, WorkspaceContext, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, getBindingExamples, getInteractionModelForDomain, inferTsType, isKnownValidationErrorCode, isPlanSnapshot, isResolvedIR, isSessionHistoryEntry, isTraitFieldRef, toBindingRoot, validateBindingInContext, widenTier } from './types/index.js';
-import { d as TraitConfig, S as State } from './trait-X5mQAMtW.js';
-export { e as CONFIG_REF_EVENT_PATTERN, C as CallSiteConfig, b as CallSiteConfigEntry, f as ConfigFieldDeclaration, g as ConfigFieldDeclarationSchema, h as ConfigFieldItemsDeclaration, i as ConfigRefEventError, D as DeclaredTraitConfig, j as DeclaredTraitConfigSchema, E as EntityFieldContract, k as EntityFieldContractSchema, l as Event, m as EventInput, n as EventPayloadField, o as EventPayloadFieldSchema, p as EventSchema, q as EventScope, r as EventScopeSchema, G as Guard, s as GuardInput, t as GuardSchema, L as ListenSource, u as ListenSourceSchema, O as OrbitalTraitRef, v as OrbitalTraitRefSchema, P as PayloadField, w as PayloadFieldSchema, x as PresentationType, R as REFERENCE_CONFIG_TYPES, y as ReferenceConfigType, z as RequiredField, A as RequiredFieldSchema, B as StateInput, F as StateMachine, H as StateMachineInput, I as StateMachineSchema, J as StateSchema, c as Trait, K as TraitCategory, M as TraitCategorySchema, N as TraitConfigObject, Q as TraitConfigSchema, U as TraitConfigValue, V as TraitConfigValueSchema, W as TraitDataEntity, X as TraitDataEntitySchema, Y as TraitEntityField, Z as TraitEntityFieldSchema, _ as TraitEventContract, $ as TraitEventContractSchema, T as TraitEventListener, a0 as TraitEventListenerSchema, a1 as TraitInput, a2 as TraitRef, a3 as TraitRefSchema, a as TraitReference, a4 as TraitReferenceInput, a5 as TraitReferenceSchema, a6 as TraitSchema, a7 as TraitTick, a8 as TraitTickSchema, a9 as TraitUIBinding, aa as Transition, ab as TransitionInput, ac as TransitionSchema, ad as configRefEventKnob, ae as getTraitConfig, af as getTraitName, ag as isCallSiteConfigDeclaration, ah as isCircuitEvent, ai as isInlineTrait, aj as isReferenceConfigType, ak as normalizeCallSiteConfigToValues, al as normalizeTraitRef, am as resolveConfigRefEventName } from './trait-X5mQAMtW.js';
-export { F as FactoryCallSite, a as FactoryCallSiteParams, b as FactoryConfigParam, c as FactoryConfigTier, d as FactoryEntitySignature, e as FactoryEventSignature, f as FactoryExposure, g as FactoryPageSignature, h as FactoryParamValue, i as FactoryProvenance, j as FactorySignature, k as FactorySignatureCatalog, l as FactorySignatureEntityField, m as FactoryTraitSignature, J as JsonSchema, n as JsonSchemaType, O as OwnershipOverlayEntry, P as PresentationNavItem, o as PresentationOverlay, R as RuleOverlay, p as RuleOverlayEntry, S as SchemaFieldType, T as TraitOverlay, q as TraitOverlayEntry, r as TraitOverlayListener } from './types-DujRcijG.js';
+export { ANONYMOUS_USER, AgentCodeSearchResult, AgentCompactResult, AgentCompactStrategy, AgentContext, AgentGenerateOptions, AgentMemoryCategory, AgentMemoryRecord, AnalysisOrbital, AnalysisOrbitalParams, AnalysisPageOverride, AnalysisRename, AnalysisResult, AnnotationTier, AppCreatedEvent, AppSummary, AssetLoadStatus, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingContext, BindingRoot, BindingSchema, BridgeHealth, BuilderResult, BusEvent, BusEventListener, BusEventSource, CancelledEvent, ChangeAuthor, ChangeSetDocument, ChangeSummary, ChangesetRecordedEvent, CheckStatus, Clarification, ClarificationCandidate, ClarificationLevel, CompleteEvent, ComplexityAssessment, ComposeAllResult, ComposeChildrenResult, ComposeOptions, ContextExtensions, CreateFlow, DEFAULT_INTERACTION_MODELS, DEV_TOKEN_PREFIX, DeleteFlow, DispatchUpdatesResult, EdgeType, EditFlow, EffectPayload, EffectResult, EffectTrace, ErrorEvent, EventEmit, EventKey, EventListen, EventLogEntry, EvolutionDelta, ExecutePlanResult, ExtraTraitRef, FileOperationEvent, FileWrittenEvent, GateState, GenerationLogEvent, GitHubIssue, GitHubLink, GitHubRepo, HistoryMeta, IntegrationContext, InteractionModel, InteractionModelInput, InteractionModelSchema, InterruptEvent, KNOWN_VALIDATION_ERROR_CODES, KnobPayload, KnownValidationErrorCode, LazyService, LineageEntry, ListInteraction, LivingEdge, LivingEffect, LivingEntity, LivingEvent, LivingField, LivingOrbital, LivingOrbitalSchema, LivingPage, LivingState, LivingTrait, LivingTransition, LivingValue, LivingVertex, LlmCallToolsResult, LlmContext, LlmMessage, LlmTokenUsage, LlmToolCall, LlmToolDef, LoloEmitResult, MOCK_PERSONAS, MemoryContext, MessageEvent, OrbitalAddedEvent, OrbitalSchemaCompleteEvent, OrbitalVerificationAPI, ParamsRepairEmittedEvent, ParsedDesign, ParsedDomainContext, ParsedEmitDeclaration, ParsedEntity, ParsedEvent, ParsedListenDeclaration, ParsedOrbital, ParsedPage, ParsedState, ParsedStateMachine, ParsedTrait, ParsedTraitConfig, ParsedTransition, PatternTypeSchema, PersistActionName, PlanSnapshot, PlanSnapshotStatus, PlannerResult, Probability, ProcessCompleteEvent, ProcessErrorEvent, ProcessRepairCompleteEvent, ProcessRepairEvent, ProcessStartEvent, RawUserClaims, RepairResult, ResolvedEntityBinding, ResolvedField, ResolvedNavigation, ResolvedPattern, ResolvedSection, ResolvedSectionEvent, ResolvedTraitBinding, ResolvedTraitDataEntity, ResolvedTraitEvent, ResolvedTraitGuard, ResolvedTraitListener, ResolvedTraitState, ResolvedTraitTick, ResolvedTraitTransition, ResolvedTraitUIBinding, SSEEvent, SSEEventBase, SSEEventType, SaveOptions, SaveResult, SchemaPhaseUpdateEvent, SchemaPhaseValidatedEvent, SchemaUpdateEvent, SemanticAnnotation, SemanticChangeKind, SemanticVector, ServerResponseTrace, ServiceAction, ServiceActionName, ServiceCallResult, ServiceContract, ServiceEvents, SessionContext, SessionHistoryEntry, SnapshotCreatedEvent, SnapshotDocument, SpawnResult, StartEvent, StatsView, StoreContract, StoreFilter, StoreFilterOp, SubagentCompleteEvent, SubagentEvent, SubagentProgressEvent, SubagentStartEvent, TodoActivityType, TodoDetailEvent, TodoUpdateEvent, ToolCallEvent, ToolResultEvent, TraceContext, TraitFieldRef, TraitFieldRefSchema, TraitStateSnapshot, TransitionFrom, TransitionTrace, Unsubscribe, UserContext, ValidateResult, ValidationDocument, ValidationError, ValidationErrorCode, ValidationIssue, ValidationMeta, ValidationResult, ValidationResults, VerificationCheck, VerificationSnapshot, VerificationSummary, VertexId, VertexPayload, VertexType, ViewFlow, WorkspaceContext, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, decodeDevIdentityToken, encodeDevIdentityToken, findMockPersona, getBindingExamples, getInteractionModelForDomain, inferTsType, isKnownValidationErrorCode, isPlanSnapshot, isResolvedIR, isSessionHistoryEntry, isTraitFieldRef, normalizeUserContext, resolvePersonaSpec, toBindingRoot, validateBindingInContext, widenTier } from './types/index.js';
+import { d as TraitConfig, S as State } from './trait-CEO7o8Ne.js';
+export { e as CONFIG_REF_EVENT_PATTERN, C as CallSiteConfig, b as CallSiteConfigEntry, f as ConfigFieldDeclaration, g as ConfigFieldDeclarationSchema, h as ConfigFieldItemsDeclaration, i as ConfigRefEventError, D as DeclaredTraitConfig, j as DeclaredTraitConfigSchema, E as EntityFieldContract, k as EntityFieldContractSchema, l as Event, m as EventInput, n as EventPayloadField, o as EventPayloadFieldSchema, p as EventSchema, q as EventScope, r as EventScopeSchema, G as Guard, s as GuardInput, t as GuardSchema, L as ListenSource, u as ListenSourceSchema, O as OrbitalTraitRef, v as OrbitalTraitRefSchema, P as PayloadField, w as PayloadFieldSchema, x as PresentationType, R as REFERENCE_CONFIG_TYPES, y as ReferenceConfigType, z as RequiredField, A as RequiredFieldSchema, B as StateInput, F as StateMachine, H as StateMachineInput, I as StateMachineSchema, J as StateSchema, K as TickIntervalSchema, c as Trait, M as TraitCategory, N as TraitCategorySchema, Q as TraitConfigObject, U as TraitConfigSchema, V as TraitConfigValue, W as TraitConfigValueSchema, X as TraitDataEntity, Y as TraitDataEntitySchema, Z as TraitEntityField, _ as TraitEntityFieldSchema, $ as TraitEventContract, a0 as TraitEventContractSchema, T as TraitEventListener, a1 as TraitEventListenerSchema, a2 as TraitInput, a3 as TraitRef, a4 as TraitRefSchema, a as TraitReference, a5 as TraitReferenceInput, a6 as TraitReferenceSchema, a7 as TraitSchema, a8 as TraitTick, a9 as TraitTickSchema, aa as TraitUIBinding, ab as Transition, ac as TransitionInput, ad as TransitionSchema, ae as configRefEventKnob, af as getTraitConfig, ag as getTraitName, ah as isCallSiteConfigDeclaration, ai as isCircuitEvent, aj as isInlineTrait, ak as isReferenceConfigType, al as normalizeCallSiteConfigToValues, am as normalizeTraitRef, an as resolveConfigRefEventName } from './trait-CEO7o8Ne.js';
+export { F as FactoryCallSite, a as FactoryCallSiteParams, b as FactoryConfigParam, c as FactoryConfigTier, d as FactoryEntitySignature, e as FactoryEventSignature, f as FactoryExposure, g as FactoryPageSignature, h as FactoryParamValue, i as FactoryProvenance, j as FactorySignature, k as FactorySignatureCatalog, l as FactorySignatureEntityField, m as FactoryTraitSignature, J as JsonSchema, n as JsonSchemaType, O as OwnershipOverlayEntry, P as PresentationNavItem, o as PresentationOverlay, R as RuleOverlay, p as RuleOverlayEntry, S as SchemaFieldType, T as TraitOverlay, q as TraitOverlayEntry, r as TraitOverlayListener } from './types-1YGQKdbm.js';
 export { CallSiteDiff, DomainQuestion, DomainQuestionAnswer, DomainQuestionAnswers, DomainQuestionInputType, FactoryCallPlanMutation, FactoryCallPlanMutationTemplate, FactoryCallPlanState, OrbitalCallInput, TranslationBinding, TranslationResult, TranslationWarning, answerToMutations, answersToMutations, applyFactoryCallPlanMutation, deriveInputType, diffFactoryCalls, generateQuestions, translateOverlaysToParams } from './factory/index.js';
 export { COMPONENT_MAPPING, EVENT_CONTRACTS, FormSubmitPayload, INTEGRATORS_REGISTRY, ItemActionPayload, LoadMoreRequestPayload, PATTERN_REGISTRY, PatternCallbackArg, PatternEntry, PatternPayloadField, PatternPropDef, PatternRecommendation, PatternSwapGate, PropKind, RecommendationContext, RenderUiPayload, SelectionChangePayload, buildRecommendationContext, collectRenderUiPatternTypes, componentMapping, eventContracts, findCompatiblePatterns, formatRecommendationsForPrompt, generatePatternDescription, getAllPatternTypes, getComponentForPattern, getEmittedEvents, getEntityCardinality, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, integratorsRegistry, isContentBodyPattern, isContentBodyPatternType, isDrawHostPattern, isDrawablePattern, isEntityAwarePattern, isMainSlotRenderUi, patternsRegistry, recommendPatterns, registry, renderUiPatternTypesOf } from './patterns/index.js';
 export { BFSNode, BFSPathNode, EdgeWalkTransition, GraphTransition, GuardPayload, ReplayStep, ReplayTransition, StateEdge, WalkStep, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, collectReachableStates, constTruth, extractPayloadFieldRef, walkStatePairs } from './state-machine/index.js';
@@ -487,6 +487,77 @@ type ListenPayloadEvaluator = (expr: SExpr, payload: EventPayload) => unknown;
  */
 declare function applyListenPayloadMapping(payloadMapping: Record<string, SExpr> | undefined, payload: EventPayload | undefined, evaluate: ListenPayloadEvaluator): EventPayload | undefined;
 
+/**
+ * ML contract validation — the ONE pure implementation shared by the runtime
+ * path (`@almadar/evaluator`'s contract/* operators) and the compiled path
+ * (the TypeScript shell imports `validateContract` directly, so the two
+ * paths cannot drift). Mirrors `contract_helpers.py` (emitted by
+ * `orbital-shell-python`) semantically: same contract JSON in, same
+ * `{valid, violations}` out.
+ *
+ * A tensor on the JS side is a plain JSON value — a number, or (possibly
+ * nested) arrays of numbers — exactly what a `torch.Tensor` round-trips
+ * to/from via `tolist()`.
+ *
+ * @packageDocumentation
+ */
+/** A tensor on the JS path: a number, or nested arrays of numbers. */
+type TensorValue = number | TensorValue[];
+/** Per-dimension range bound. Missing bounds default to +-Infinity, matching contract_helpers.py's `float("-inf")`/`float("inf")`. */
+interface ContractRange {
+    min?: number;
+    max?: number;
+}
+interface ContractFieldSpec {
+    name: string;
+}
+type ContractFieldEntry = string | ContractFieldSpec;
+/**
+ * Canonical contract shape (matches contract_helpers.py's dict contracts
+ * byte-for-byte): `shape`/`ranges` drive validate/clamp/violations, `fields`
+ * drives the entity<->tensor mapping. A single contract object may carry
+ * both halves.
+ */
+interface ContractSpec {
+    shape?: number[];
+    ranges?: Record<string, ContractRange>;
+    fields?: ContractFieldEntry[];
+}
+interface ContractViolation {
+    type: 'shape_mismatch' | 'range_violation' | 'not_a_tensor';
+    expected?: number[];
+    actual?: number[];
+    dim?: number;
+    min?: number;
+    max?: number;
+    actualMin?: number;
+    actualMax?: number;
+    /** `not_a_tensor` only — what arrived instead, for diagnosis. */
+    actualType?: string;
+}
+interface ContractValidationResult {
+    valid: boolean;
+    violations: ContractViolation[];
+}
+declare function contractFieldName(f: ContractFieldEntry): string;
+/**
+ * A JS-path tensor is a number or nested arrays of numbers. Model output
+ * arrives from an untrusted service, so every contract operator guards before
+ * walking it — an unguarded walk throws a bare `TypeError` three frames deep,
+ * which stalls the transition instead of abstaining.
+ */
+declare function isTensorValue(v: unknown): v is TensorValue;
+/** What arrived instead of a tensor, for the `not_a_tensor` violation. */
+declare function describeTensorMismatch(v: unknown): string;
+/** Shape of a tensor value, e.g. `[[1,2],[3,4]]` -> `[2,2]`, `[1,2,3]` -> `[3]`. */
+declare function tensorShape(t: TensorValue): number[];
+declare function tensorLastDimSize(t: TensorValue): number;
+/** All values at index `dim` along the last axis, flattened across every leading axis — mirrors `tensor[..., dim]`. */
+declare function gatherTensorLastDim(t: TensorValue, dim: number): number[];
+/** Replace values at index `dim` along the last axis via `fn` — mirrors in-place `result[..., dim] = ...clamp(...)`. */
+declare function mapTensorLastDim(t: TensorValue, dim: number, fn: (v: number) => number): TensorValue;
+declare function validateContract(tensor: unknown, contract: ContractSpec): ContractValidationResult;
+
 /**
  * Schema Diffing & Protection
  *
@@ -688,4 +759,4 @@ type EntityFrameState = EntityRow;
  */
 declare function mergeEntityFrame(current: EntityFrameState, orderedWrites: readonly EntityFieldWrite[]): EntityFrameState;
 
-export { OrbitalSchema as AppSchema, CategorizedRemovals, ChangesetValue, type EditFocus, type EditFocusLevel, type EntityFieldWrite, type EntityFrameState, EntityRow, EventPayload, FieldValue, JsonValue, type ListenPayloadEvaluator, OrbitalDefinition, OrbitalSchema, PageContentReduction, type PatternNode, type PatternValue, type RenderOverlayResult, type RenderUiPatch, type RenderUiPatchAddress, type RenderUiPatchOp, ResolvedEntity, ResolvedIR, ResolvedPage, ResolvedTrait, SExpr, SchemaChange, type SchemaDiff, type SchemaDiffAuthor, type SchemaDiffChange, type SchemaDiffChangeset, type SchemaDiffMode, type SchemaDiffOptions, type SchemaDiffSource, type SchemaDiffSummary, SemanticSchemaChange, State, ToolArgs, type TraceActivity, type TraceActivityItem, type TraceAvatarRole, type TraceChatMessage, type TraceChatMessageToolCall, type TraceDiffHunk, type TraceDiffLine, type TraceFileOperation, type TraceSubagent, type TraceSubagentMessage, TraitConfig, OrbitalDefinition as ValidatedOrbital, applyListenPayloadMapping, applyRenderOverlay, buildResolvedTraitConfigs, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectEmbeddedTraitReferrers, collectTraitConfigRefAdjacency, collectTraitEmbedAdjacency, detectPageContentReduction, diffOrbitalSchemas, diffSchemaSemantics, diffSchemas, fingerprintNode, getEntity, getPage, getPages, getRemovals, getSchemaCacheStats, getTrait, hasSignificantPageReduction, insertChildAtPath, isDestructiveChange, mergeEntityFrame, navigatePatternPath, removeChildAtPath, replaceChildAtPath, requiresConfirmation, schemaToIR, setPropAtPath, summarizeOrbital, summarizeSchema };
+export { OrbitalSchema as AppSchema, CategorizedRemovals, ChangesetValue, type ContractFieldEntry, type ContractFieldSpec, type ContractRange, type ContractSpec, type ContractValidationResult, type ContractViolation, type EditFocus, type EditFocusLevel, type EntityFieldWrite, type EntityFrameState, EntityRow, EventPayload, FieldValue, JsonValue, type ListenPayloadEvaluator, OrbitalDefinition, OrbitalSchema, PageContentReduction, type PatternNode, type PatternValue, type RenderOverlayResult, type RenderUiPatch, type RenderUiPatchAddress, type RenderUiPatchOp, ResolvedEntity, ResolvedIR, ResolvedPage, ResolvedTrait, SExpr, SchemaChange, type SchemaDiff, type SchemaDiffAuthor, type SchemaDiffChange, type SchemaDiffChangeset, type SchemaDiffMode, type SchemaDiffOptions, type SchemaDiffSource, type SchemaDiffSummary, SemanticSchemaChange, State, type TensorValue, ToolArgs, type TraceActivity, type TraceActivityItem, type TraceAvatarRole, type TraceChatMessage, type TraceChatMessageToolCall, type TraceDiffHunk, type TraceDiffLine, type TraceFileOperation, type TraceSubagent, type TraceSubagentMessage, TraitConfig, OrbitalDefinition as ValidatedOrbital, applyListenPayloadMapping, applyRenderOverlay, buildResolvedTraitConfigs, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectEmbeddedTraitReferrers, collectTraitConfigRefAdjacency, collectTraitEmbedAdjacency, contractFieldName, describeTensorMismatch, detectPageContentReduction, diffOrbitalSchemas, diffSchemaSemantics, diffSchemas, fingerprintNode, gatherTensorLastDim, getEntity, getPage, getPages, getRemovals, getSchemaCacheStats, getTrait, hasSignificantPageReduction, insertChildAtPath, isDestructiveChange, isTensorValue, mapTensorLastDim, mergeEntityFrame, navigatePatternPath, removeChildAtPath, replaceChildAtPath, requiresConfirmation, schemaToIR, setPropAtPath, summarizeOrbital, summarizeSchema, tensorLastDimSize, tensorShape, validateContract };

package/dist/index.js

@@ -829,11 +829,20 @@ var TraitDataEntitySchema = z.object({
   singleton: z.boolean().optional(),
   pages: z.array(z.string()).optional()
 });
+var DURATION_INTERVAL = /^\d+(ms|s|m|h|d)$/;
+var CRON_INTERVAL = /^\S+(\s+\S+){4}$/;
+var TickIntervalSchema = z.union([
+  z.literal("frame"),
+  z.number().positive(),
+  z.string().refine((v) => DURATION_INTERVAL.test(v) || CRON_INTERVAL.test(v), {
+    message: 'interval must be "frame", a positive number of milliseconds, a duration ("500ms"/"5s"/"1m"/"1h"/"1d"), or a 5-field cron expression ("0 9 * * *")'
+  })
+]);
 var TraitTickSchema = z.object({
   name: z.string().min(1),
   description: z.string().optional(),
   priority: z.number().optional(),
-  interval: z.union([z.literal("frame"), z.number().positive()]),
+  interval: TickIntervalSchema,
   appliesTo: z.array(z.string()).optional(),
   pages: z.array(z.string()).optional(),
   pageIds: z.array(PageIdSchema).optional(),
@@ -1923,6 +1932,75 @@ function isTraitFieldRef(value) {
 }
 var TraitFieldRefSchema = z.string().regex(TRAIT_REF_PATTERN, "expected `@trait.<TraitName>` reference");
 
+// src/types/user.ts
+var ANONYMOUS_USER = {
+  id: "anonymous",
+  role: "anonymous",
+  permissions: []
+};
+var DERIVED_CLAIM_KEYS = ["id", "name", "displayName", "email"];
+function normalizeUserContext(claims) {
+  if (!claims) return void 0;
+  const id = claims.id ?? claims.uid;
+  if (typeof id !== "string" || id.length === 0) return void 0;
+  const user = { id };
+  for (const [key, value] of Object.entries(claims)) {
+    if (value === void 0 || DERIVED_CLAIM_KEYS.includes(key)) continue;
+    user[key] = value;
+  }
+  const name = claims.name ?? claims.displayName;
+  if (typeof name === "string" && name.length > 0) user.name = name;
+  if (typeof claims.email === "string" && claims.email.length > 0) user.email = claims.email;
+  return user;
+}
+var MOCK_PERSONAS = [
+  { id: "admin-1", name: "Ada Admin", email: "ada@example.com", role: "admin", permissions: ["read", "write", "delete"] },
+  { id: "staff-1", name: "Sam Staff", email: "sam@example.com", role: "staff", permissions: ["read", "write"] },
+  { id: "member-1", name: "Maya Member", email: "maya@example.com", role: "member", permissions: ["read"] },
+  { id: "customer-1", name: "Cai Customer", email: "cai@example.com", role: "customer", permissions: ["read"] }
+];
+function findMockPersona(idOrRole) {
+  return MOCK_PERSONAS.find((p) => p.id === idOrRole) ?? MOCK_PERSONAS.find((p) => p.role === idOrRole);
+}
+function resolvePersonaSpec(spec) {
+  const raw = spec.trim();
+  if (!raw.startsWith("{")) {
+    const seeded = findMockPersona(raw);
+    if (!seeded) {
+      throw new Error(
+        `Persona "${raw}" is not a seeded persona id or role. Known: ${MOCK_PERSONAS.map((p) => `${p.id}/${p.role}`).join(", ")}`
+      );
+    }
+    return seeded;
+  }
+  let claims;
+  try {
+    claims = JSON.parse(raw);
+  } catch {
+    throw new Error(`Persona is not valid JSON: ${raw}`);
+  }
+  const user = normalizeUserContext(claims);
+  if (!user) {
+    throw new Error(`Persona needs an "id" (or "uid"): ${raw}`);
+  }
+  return user;
+}
+var DEV_TOKEN_PREFIX = "almadar-dev.";
+function encodeDevIdentityToken(user) {
+  return DEV_TOKEN_PREFIX + encodeURIComponent(JSON.stringify(user));
+}
+function decodeDevIdentityToken(token) {
+  if (!token.startsWith(DEV_TOKEN_PREFIX)) return void 0;
+  try {
+    const claims = JSON.parse(
+      decodeURIComponent(token.slice(DEV_TOKEN_PREFIX.length))
+    );
+    return normalizeUserContext(claims);
+  } catch {
+    return void 0;
+  }
+}
+
 // src/types/agent.ts
 function isSessionHistoryEntry(value) {
   if (typeof value !== "object" || value === null) return false;
@@ -47074,6 +47152,80 @@ function applyListenPayloadMapping(payloadMapping, payload, evaluate) {
   return mapped;
 }
 
+// src/ml-contract.ts
+function contractFieldName(f) {
+  return typeof f === "string" ? f : f.name;
+}
+function isTensorValue(v) {
+  if (typeof v === "number") return true;
+  return Array.isArray(v) && v.every(isTensorValue);
+}
+function describeTensorMismatch(v) {
+  if (v === null) return "null";
+  if (Array.isArray(v)) return "array containing non-numeric values";
+  return typeof v;
+}
+function tensorShape(t) {
+  if (typeof t === "number") return [];
+  if (t.length === 0) return [0];
+  const first = t[0];
+  if (typeof first === "number") return [t.length];
+  return [t.length, ...tensorShape(first)];
+}
+function tensorLastDimSize(t) {
+  const shape = tensorShape(t);
+  return shape.length === 0 ? 0 : shape[shape.length - 1];
+}
+function arraysEqual(a, b) {
+  return a.length === b.length && a.every((v, i) => v === b[i]);
+}
+function gatherTensorLastDim(t, dim) {
+  if (typeof t === "number") return [];
+  if (t.length === 0) return [];
+  if (typeof t[0] === "number") return [t[dim]];
+  const out = [];
+  for (const sub of t) out.push(...gatherTensorLastDim(sub, dim));
+  return out;
+}
+function mapTensorLastDim(t, dim, fn) {
+  if (typeof t === "number") return t;
+  if (t.length === 0) return t;
+  if (typeof t[0] === "number") {
+    const copy = [...t];
+    copy[dim] = fn(copy[dim]);
+    return copy;
+  }
+  return t.map((sub) => mapTensorLastDim(sub, dim, fn));
+}
+function validateContract(tensor, contract) {
+  if (!isTensorValue(tensor)) {
+    return {
+      valid: false,
+      violations: [{ type: "not_a_tensor", actualType: describeTensorMismatch(tensor) }]
+    };
+  }
+  const violations = [];
+  const shape = tensorShape(tensor);
+  if (contract.shape && !arraysEqual(shape, contract.shape)) {
+    violations.push({ type: "shape_mismatch", expected: contract.shape, actual: shape });
+  }
+  const ranges = contract.ranges ?? {};
+  const size = tensorLastDimSize(tensor);
+  for (const [dimStr, bounds] of Object.entries(ranges)) {
+    const dim = Number(dimStr);
+    if (dim >= size) continue;
+    const vals = gatherTensorLastDim(tensor, dim);
+    const min = bounds.min ?? -Infinity;
+    const max = bounds.max ?? Infinity;
+    const actualMin = Math.min(...vals);
+    const actualMax = Math.max(...vals);
+    if (actualMin < min || actualMax > max) {
+      violations.push({ type: "range_violation", dim, min, max, actualMin, actualMax });
+    }
+  }
+  return { valid: violations.length === 0, violations };
+}
+
 // src/diff.ts
 function diffSchemas(before, after) {
   const changes = [];
@@ -49240,6 +49392,6 @@ function mergeEntityFrame(current, orderedWrites) {
   return next;
 }
 
-export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, ANIMATION_NAMES, ASSET_ASPECTS, ASSET_DIMENSIONS, AgentDomainCategorySchema, AnimationDefSchema, AnimationNameSchema, AssetAspectSchema, AssetCatalogEntrySchema, AssetCatalogSchema, AssetDimensionSchema, AssetSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingSchema, CAMERA_MODES, COMPONENT_MAPPING, CONFIG_REF_EVENT_PATTERN, CORE_BINDINGS, CameraModeSchema, CameraSchema, ColorSliceSchema, ColorTokensSchema, ComputedEventContractSchema, ComputedEventListenerSchema, ConfigFieldDeclarationSchema, ConfigProvenanceRecordSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DeclaredTraitConfigSchema, DensitySliceSchema, DensityTokensSchema, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, ENTITY_ROLES, EVENT_CONTRACTS, EffectSchema, ElevationSliceSchema, ElevationTokensSchema, EntityCallSchema, EntityFieldContractSchema, EntityFieldSchema, EntityIdSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventIdSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FieldFormatSchema, FieldSchema, FieldTypeSchema, GameSubCategorySchema, GeometrySliceSchema, GeometryTokensSchema, GuardSchema, INTEGRATORS_REGISTRY, IconFamilySchema, IconographySliceSchema, IconographyTokensSchema, IdentityLedgerSchema, IllustrationSliceSchema, IllustrationStyleSchema, IllustrationTokensSchema, InteractionModelSchema, KNOWN_VALIDATION_ERROR_CODES, LedgerEntrySchema, LedgerKindSchema, ListenSourceSchema, McpServiceDefSchema, MotionDurationKeySchema, MotionDurationPaletteSchema, MotionEasingKeySchema, MotionEasingPaletteSchema, MotionIntentMapSchema, MotionIntentSchema, MotionSliceSchema, MotionTokensSchema, NodeClassificationSchema, OrbitalConfigSchema, OrbitalDefinitionSchema, OrbitalEntitySchema, OrbitalIdSchema, OrbitalPageSchema, OrbitalPageStrictSchema, OrbitalSchemaSchema, OrbitalTraitRefSchema, OrbitalUnitSchema, OrbitalSchema as OrbitalZodSchema, PATTERN_REGISTRY, PATTERN_TYPES, PageIdSchema, PageRefObjectSchema, PageRefSchema, PageRefStringSchema, PageSchema, PageTraitRefSchema, PaletteEntryIdSchema, PatternTypeSchema, PayloadFieldSchema, REFERENCE_CONFIG_TYPES, RelatedLinkSchema, RelationConfigSchema, RequiredFieldSchema, RestAuthConfigSchema, RestServiceDefSchema, SERVICE_TYPES, SExprAtomSchema, SExprSchema, SPRITE_DIRECTIONS, ScenePosSchema, SchemaMetadataSchema, SemanticAssetRefSchema, ServiceDefinitionSchema, ServiceIdSchema, ServiceRefObjectSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SkinSpecSchema, SocketEventsSchema, SocketServiceDefSchema, SpacingScaleSchema, SpriteDirectionSchema, SpriteSheetAtlasSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SubTextureSchema, SuggestedGuardSchema, TextureAtlasSchema, ThemeDefinitionSchema, ThemeIdSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TilesheetSchema, TraitCategorySchema, TraitConfigSchema, TraitConfigValueSchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitFieldRefSchema, TraitIdSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, TypeIntentMapSchema, TypeIntentSchema, TypeScaleEntrySchema, TypeScaleSchema, TypeScaleTokensSchema, TypeSizeKeySchema, TypeSliceSchema, TypeSlotSchema, TypeWeightSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, answerToMutations, answersToMutations, applyEventWiring, applyFactoryCallPlanMutation, applyListenPayloadMapping, applyRenderOverlay, asEntityId, asEventId, asOrbitalId, asPageId, asPaletteEntryId, asServiceId, asThemeId, asTraitId, atomic, buildEdgeCoveringWalk, buildGuardPayloads, buildRecommendationContext, buildReplayPaths, buildResolvedTraitConfigs, buildStateGraph, callService, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectBindings, collectEmbeddedTraitReferrers, collectReachableStates, collectRenderUiPatternTypes, collectTraitConfigRefAdjacency, collectTraitEmbedAdjacency, component_mapping_default as componentMapping, composeBehaviors, configRefEventKnob, constTruth, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, deref, deriveCollection, deriveInputType, despawn, detectLayoutStrategy, detectPageContentReduction, diffFactoryCalls, diffOrbitalSchemas, diffSchemaSemantics, diffSchemas, doEffects, emit, event_contracts_default as eventContracts, extractPayloadFieldRef, findCompatiblePatterns, findService, fingerprintNode, formatRecommendationsForPrompt, generatePatternDescription, generateQuestions, getAllPatternTypes, getArgs, getBindingExamples, getComponentForPattern, getDefaultAnimationsForRole, getEmittedEvents, getEntity, getEntityCardinality, getInteractionModelForDomain, getOperator, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPage, getPages, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, getRemovals, getSchemaCacheStats, getServiceNames, getTrait, getTraitConfig, getTraitName, hasService, hasSignificantPageReduction, idKindOf, idPrefix, inferTsType, insertChildAtPath, integrators_registry_default as integratorsRegistry, isBinding, isCallSiteConfigDeclaration, isCircuitEvent, isContentBodyPattern, isContentBodyPatternType, isDestructiveChange, isDrawHostPattern, isDrawablePattern, isEffect, isEntityAwarePattern, isEntityCall, isEntityId, isEntityReference, isEntityReferenceAny, isEventId, isEventPayloadValue, isFieldValue, isImportedTraitRef, isInlineTrait, isJsonArray, isJsonObject, isJsonPrimitive, isKnownValidationErrorCode, isMainSlotRenderUi, isMcpService, isOrbitalDefinition, isOrbitalId, isPageId, isPageReference, isPageReferenceObject, isPageReferenceString, isPaletteEntryId, isPlanSnapshot, isReferenceConfigType, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceId, isServiceReference, isServiceReferenceObject, isSessionHistoryEntry, isSocketService, isThemeId, isThemeReference, isTraitFieldRef, isTraitId, isValidBinding, isValidPatternType, ledgerCurName, ledgerRename, ledgerResolveName, mergeEntityFrame, mintId, navigate, navigatePatternPath, normalizeCallSiteConfigToValues, normalizeTraitRef, notify, parseAssetKey, parseBinding, parseEntityRef, parseImportedTraitRef, parseOrbitalSchema, parsePageRef, parseServiceRef, patterns_registry_default as patternsRegistry, persist, persistenceModeAllowsOverrides, recommendPatterns, ref, registry, removeChildAtPath, renderUI, renderUiPatternTypesOf, replaceChildAtPath, requiresConfirmation, resolveConfigRefEventName, safeParseOrbitalSchema, schemaToIR, set, setPropAtPath, sexpr, spawn, summarizeOrbital, summarizeSchema, swap, toBindingRoot, translateOverlaysToParams, validateAssetAnimations, validateBindingInContext, walkSExpr, walkStatePairs, watch, widenTier };
+export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, ANIMATION_NAMES, ANONYMOUS_USER, ASSET_ASPECTS, ASSET_DIMENSIONS, AgentDomainCategorySchema, AnimationDefSchema, AnimationNameSchema, AssetAspectSchema, AssetCatalogEntrySchema, AssetCatalogSchema, AssetDimensionSchema, AssetSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingSchema, CAMERA_MODES, COMPONENT_MAPPING, CONFIG_REF_EVENT_PATTERN, CORE_BINDINGS, CameraModeSchema, CameraSchema, ColorSliceSchema, ColorTokensSchema, ComputedEventContractSchema, ComputedEventListenerSchema, ConfigFieldDeclarationSchema, ConfigProvenanceRecordSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DEV_TOKEN_PREFIX, DeclaredTraitConfigSchema, DensitySliceSchema, DensityTokensSchema, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, ENTITY_ROLES, EVENT_CONTRACTS, EffectSchema, ElevationSliceSchema, ElevationTokensSchema, EntityCallSchema, EntityFieldContractSchema, EntityFieldSchema, EntityIdSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventIdSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FieldFormatSchema, FieldSchema, FieldTypeSchema, GameSubCategorySchema, GeometrySliceSchema, GeometryTokensSchema, GuardSchema, INTEGRATORS_REGISTRY, IconFamilySchema, IconographySliceSchema, IconographyTokensSchema, IdentityLedgerSchema, IllustrationSliceSchema, IllustrationStyleSchema, IllustrationTokensSchema, InteractionModelSchema, KNOWN_VALIDATION_ERROR_CODES, LedgerEntrySchema, LedgerKindSchema, ListenSourceSchema, MOCK_PERSONAS, McpServiceDefSchema, MotionDurationKeySchema, MotionDurationPaletteSchema, MotionEasingKeySchema, MotionEasingPaletteSchema, MotionIntentMapSchema, MotionIntentSchema, MotionSliceSchema, MotionTokensSchema, NodeClassificationSchema, OrbitalConfigSchema, OrbitalDefinitionSchema, OrbitalEntitySchema, OrbitalIdSchema, OrbitalPageSchema, OrbitalPageStrictSchema, OrbitalSchemaSchema, OrbitalTraitRefSchema, OrbitalUnitSchema, OrbitalSchema as OrbitalZodSchema, PATTERN_REGISTRY, PATTERN_TYPES, PageIdSchema, PageRefObjectSchema, PageRefSchema, PageRefStringSchema, PageSchema, PageTraitRefSchema, PaletteEntryIdSchema, PatternTypeSchema, PayloadFieldSchema, REFERENCE_CONFIG_TYPES, RelatedLinkSchema, RelationConfigSchema, RequiredFieldSchema, RestAuthConfigSchema, RestServiceDefSchema, SERVICE_TYPES, SExprAtomSchema, SExprSchema, SPRITE_DIRECTIONS, ScenePosSchema, SchemaMetadataSchema, SemanticAssetRefSchema, ServiceDefinitionSchema, ServiceIdSchema, ServiceRefObjectSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SkinSpecSchema, SocketEventsSchema, SocketServiceDefSchema, SpacingScaleSchema, SpriteDirectionSchema, SpriteSheetAtlasSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SubTextureSchema, SuggestedGuardSchema, TextureAtlasSchema, ThemeDefinitionSchema, ThemeIdSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TickIntervalSchema, TilesheetSchema, TraitCategorySchema, TraitConfigSchema, TraitConfigValueSchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitFieldRefSchema, TraitIdSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, TypeIntentMapSchema, TypeIntentSchema, TypeScaleEntrySchema, TypeScaleSchema, TypeScaleTokensSchema, TypeSizeKeySchema, TypeSliceSchema, TypeSlotSchema, TypeWeightSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, answerToMutations, answersToMutations, applyEventWiring, applyFactoryCallPlanMutation, applyListenPayloadMapping, applyRenderOverlay, asEntityId, asEventId, asOrbitalId, asPageId, asPaletteEntryId, asServiceId, asThemeId, asTraitId, atomic, buildEdgeCoveringWalk, buildGuardPayloads, buildRecommendationContext, buildReplayPaths, buildResolvedTraitConfigs, buildStateGraph, callService, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectBindings, collectEmbeddedTraitReferrers, collectReachableStates, collectRenderUiPatternTypes, collectTraitConfigRefAdjacency, collectTraitEmbedAdjacency, component_mapping_default as componentMapping, composeBehaviors, configRefEventKnob, constTruth, contractFieldName, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, decodeDevIdentityToken, deref, deriveCollection, deriveInputType, describeTensorMismatch, despawn, detectLayoutStrategy, detectPageContentReduction, diffFactoryCalls, diffOrbitalSchemas, diffSchemaSemantics, diffSchemas, doEffects, emit, encodeDevIdentityToken, event_contracts_default as eventContracts, extractPayloadFieldRef, findCompatiblePatterns, findMockPersona, findService, fingerprintNode, formatRecommendationsForPrompt, gatherTensorLastDim, generatePatternDescription, generateQuestions, getAllPatternTypes, getArgs, getBindingExamples, getComponentForPattern, getDefaultAnimationsForRole, getEmittedEvents, getEntity, getEntityCardinality, getInteractionModelForDomain, getOperator, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPage, getPages, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, getRemovals, getSchemaCacheStats, getServiceNames, getTrait, getTraitConfig, getTraitName, hasService, hasSignificantPageReduction, idKindOf, idPrefix, inferTsType, insertChildAtPath, integrators_registry_default as integratorsRegistry, isBinding, isCallSiteConfigDeclaration, isCircuitEvent, isContentBodyPattern, isContentBodyPatternType, isDestructiveChange, isDrawHostPattern, isDrawablePattern, isEffect, isEntityAwarePattern, isEntityCall, isEntityId, isEntityReference, isEntityReferenceAny, isEventId, isEventPayloadValue, isFieldValue, isImportedTraitRef, isInlineTrait, isJsonArray, isJsonObject, isJsonPrimitive, isKnownValidationErrorCode, isMainSlotRenderUi, isMcpService, isOrbitalDefinition, isOrbitalId, isPageId, isPageReference, isPageReferenceObject, isPageReferenceString, isPaletteEntryId, isPlanSnapshot, isReferenceConfigType, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceId, isServiceReference, isServiceReferenceObject, isSessionHistoryEntry, isSocketService, isTensorValue, isThemeId, isThemeReference, isTraitFieldRef, isTraitId, isValidBinding, isValidPatternType, ledgerCurName, ledgerRename, ledgerResolveName, mapTensorLastDim, mergeEntityFrame, mintId, navigate, navigatePatternPath, normalizeCallSiteConfigToValues, normalizeTraitRef, normalizeUserContext, notify, parseAssetKey, parseBinding, parseEntityRef, parseImportedTraitRef, parseOrbitalSchema, parsePageRef, parseServiceRef, patterns_registry_default as patternsRegistry, persist, persistenceModeAllowsOverrides, recommendPatterns, ref, registry, removeChildAtPath, renderUI, renderUiPatternTypesOf, replaceChildAtPath, requiresConfirmation, resolveConfigRefEventName, resolvePersonaSpec, safeParseOrbitalSchema, schemaToIR, set, setPropAtPath, sexpr, spawn, summarizeOrbital, summarizeSchema, swap, tensorLastDimSize, tensorShape, toBindingRoot, translateOverlaysToParams, validateAssetAnimations, validateBindingInContext, validateContract, walkSExpr, walkStatePairs, watch, widenTier };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map