@almadar/core 10.35.0 → 10.37.0

package/dist/{trait-X5mQAMtW.d.ts → trait-CEO7o8Ne.d.ts}

@@ -631,11 +631,24 @@ type TraitTick = {
     /** V4 dual-carry id sibling of `emits` — optional until the Phase-7 flip. */
     emitIds?: EventId[];
 };
+/**
+ * A tick's cadence: `"frame"`, a positive number of milliseconds, a duration
+ * string, or a cron expression.
+ *
+ * This schema previously accepted only `"frame"` or a number, while `TraitTick`
+ * declared `string | number` and BOTH schedulers already parsed durations and cron
+ * (`OrbitalServerRuntime.registerTick` → `isValidCronExpression`/
+ * `parseDurationString`; Rust `TickScheduler::parse_interval` → `cron::parse_cron`).
+ * The gate therefore rejected every cron/duration tick before its runtime could
+ * run it — `std-data-erasure`'s hourly `executionScan` made the whole orbital
+ * unloadable in the interpreter with only `traits.N: Invalid input` to go on.
+ */
+declare const TickIntervalSchema: z.ZodUnion<[z.ZodLiteral<"frame">, z.ZodNumber, z.ZodEffects<z.ZodString, string, string>]>;
 declare const TraitTickSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     priority: z.ZodOptional<z.ZodNumber>;
-    interval: z.ZodUnion<[z.ZodLiteral<"frame">, z.ZodNumber]>;
+    interval: z.ZodUnion<[z.ZodLiteral<"frame">, z.ZodNumber, z.ZodEffects<z.ZodString, string, string>]>;
     appliesTo: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     pages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     pageIds: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, PageId, string>, "many">>;
@@ -646,7 +659,7 @@ declare const TraitTickSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     effects: unknown[][];
-    interval: number | "frame";
+    interval: string | number;
     description?: string | undefined;
     pages?: string[] | undefined;
     guard?: SExpr | undefined;
@@ -658,7 +671,7 @@ declare const TraitTickSchema: z.ZodObject<{
 }, {
     name: string;
     effects: unknown[][];
-    interval: number | "frame";
+    interval: string | number;
     description?: string | undefined;
     pages?: string[] | undefined;
     guard?: SExpr | undefined;
@@ -1633,7 +1646,7 @@ declare const TraitSchema: z.ZodObject<{
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         priority: z.ZodOptional<z.ZodNumber>;
-        interval: z.ZodUnion<[z.ZodLiteral<"frame">, z.ZodNumber]>;
+        interval: z.ZodUnion<[z.ZodLiteral<"frame">, z.ZodNumber, z.ZodEffects<z.ZodString, string, string>]>;
         appliesTo: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         pages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         pageIds: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, PageId, string>, "many">>;
@@ -1644,7 +1657,7 @@ declare const TraitSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         name: string;
         effects: unknown[][];
-        interval: number | "frame";
+        interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
         guard?: SExpr | undefined;
@@ -1656,7 +1669,7 @@ declare const TraitSchema: z.ZodObject<{
     }, {
         name: string;
         effects: unknown[][];
-        interval: number | "frame";
+        interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
         guard?: SExpr | undefined;
@@ -1999,7 +2012,7 @@ declare const TraitSchema: z.ZodObject<{
     ticks?: {
         name: string;
         effects: unknown[][];
-        interval: number | "frame";
+        interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
         guard?: SExpr | undefined;
@@ -2145,7 +2158,7 @@ declare const TraitSchema: z.ZodObject<{
     ticks?: {
         name: string;
         effects: unknown[][];
-        interval: number | "frame";
+        interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
         guard?: SExpr | undefined;
@@ -2437,7 +2450,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         priority: z.ZodOptional<z.ZodNumber>;
-        interval: z.ZodUnion<[z.ZodLiteral<"frame">, z.ZodNumber]>;
+        interval: z.ZodUnion<[z.ZodLiteral<"frame">, z.ZodNumber, z.ZodEffects<z.ZodString, string, string>]>;
         appliesTo: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         pages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         pageIds: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, PageId, string>, "many">>;
@@ -2448,7 +2461,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         name: string;
         effects: unknown[][];
-        interval: number | "frame";
+        interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
         guard?: SExpr | undefined;
@@ -2460,7 +2473,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }, {
         name: string;
         effects: unknown[][];
-        interval: number | "frame";
+        interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
         guard?: SExpr | undefined;
@@ -2803,7 +2816,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     ticks?: {
         name: string;
         effects: unknown[][];
-        interval: number | "frame";
+        interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
         guard?: SExpr | undefined;
@@ -2949,7 +2962,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     ticks?: {
         name: string;
         effects: unknown[][];
-        interval: number | "frame";
+        interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
         guard?: SExpr | undefined;
@@ -3311,7 +3324,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         priority: z.ZodOptional<z.ZodNumber>;
-        interval: z.ZodUnion<[z.ZodLiteral<"frame">, z.ZodNumber]>;
+        interval: z.ZodUnion<[z.ZodLiteral<"frame">, z.ZodNumber, z.ZodEffects<z.ZodString, string, string>]>;
         appliesTo: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         pages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         pageIds: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, PageId, string>, "many">>;
@@ -3322,7 +3335,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         name: string;
         effects: unknown[][];
-        interval: number | "frame";
+        interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
         guard?: SExpr | undefined;
@@ -3334,7 +3347,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }, {
         name: string;
         effects: unknown[][];
-        interval: number | "frame";
+        interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
         guard?: SExpr | undefined;
@@ -3677,7 +3690,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     ticks?: {
         name: string;
         effects: unknown[][];
-        interval: number | "frame";
+        interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
         guard?: SExpr | undefined;
@@ -3823,7 +3836,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     ticks?: {
         name: string;
         effects: unknown[][];
-        interval: number | "frame";
+        interval: string | number;
         description?: string | undefined;
         pages?: string[] | undefined;
         guard?: SExpr | undefined;
@@ -3861,4 +3874,4 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     } | undefined;
 }>]>;
 
-export { TraitEventContractSchema as $, RequiredFieldSchema as A, type StateInput as B, type CallSiteConfig as C, type DeclaredTraitConfig as D, type EntityFieldContract as E, type StateMachine as F, type Guard as G, type StateMachineInput as H, StateMachineSchema as I, StateSchema as J, type TraitCategory as K, type ListenSource as L, TraitCategorySchema as M, type TraitConfigObject as N, type OrbitalTraitRef as O, type PayloadField as P, TraitConfigSchema as Q, REFERENCE_CONFIG_TYPES as R, type State as S, type TraitEventListener as T, type TraitConfigValue as U, TraitConfigValueSchema as V, type TraitDataEntity as W, TraitDataEntitySchema as X, type TraitEntityField as Y, TraitEntityFieldSchema as Z, type TraitEventContract as _, type TraitReference as a, TraitEventListenerSchema as a0, type TraitInput as a1, type TraitRef as a2, TraitRefSchema as a3, type TraitReferenceInput as a4, TraitReferenceSchema as a5, TraitSchema as a6, type TraitTick as a7, TraitTickSchema as a8, type TraitUIBinding as a9, type Transition as aa, type TransitionInput as ab, TransitionSchema as ac, configRefEventKnob as ad, getTraitConfig as ae, getTraitName as af, isCallSiteConfigDeclaration as ag, isCircuitEvent as ah, isInlineTrait as ai, isReferenceConfigType as aj, normalizeCallSiteConfigToValues as ak, normalizeTraitRef as al, resolveConfigRefEventName as am, type TraitScope as an, type CallSiteConfigEntry as b, type Trait as c, type TraitConfig as d, CONFIG_REF_EVENT_PATTERN as e, type ConfigFieldDeclaration as f, ConfigFieldDeclarationSchema as g, type ConfigFieldItemsDeclaration as h, type ConfigRefEventError as i, DeclaredTraitConfigSchema as j, EntityFieldContractSchema as k, type Event as l, type EventInput as m, type EventPayloadField as n, EventPayloadFieldSchema as o, EventSchema as p, type EventScope as q, EventScopeSchema as r, type GuardInput as s, GuardSchema as t, ListenSourceSchema as u, OrbitalTraitRefSchema as v, PayloadFieldSchema as w, type PresentationType as x, type ReferenceConfigType as y, type RequiredField as z };
+export { type TraitEventContract as $, RequiredFieldSchema as A, type StateInput as B, type CallSiteConfig as C, type DeclaredTraitConfig as D, type EntityFieldContract as E, type StateMachine as F, type Guard as G, type StateMachineInput as H, StateMachineSchema as I, StateSchema as J, TickIntervalSchema as K, type ListenSource as L, type TraitCategory as M, TraitCategorySchema as N, type OrbitalTraitRef as O, type PayloadField as P, type TraitConfigObject as Q, REFERENCE_CONFIG_TYPES as R, type State as S, type TraitEventListener as T, TraitConfigSchema as U, type TraitConfigValue as V, TraitConfigValueSchema as W, type TraitDataEntity as X, TraitDataEntitySchema as Y, type TraitEntityField as Z, TraitEntityFieldSchema as _, type TraitReference as a, TraitEventContractSchema as a0, TraitEventListenerSchema as a1, type TraitInput as a2, type TraitRef as a3, TraitRefSchema as a4, type TraitReferenceInput as a5, TraitReferenceSchema as a6, TraitSchema as a7, type TraitTick as a8, TraitTickSchema as a9, type TraitUIBinding as aa, type Transition as ab, type TransitionInput as ac, TransitionSchema as ad, configRefEventKnob as ae, getTraitConfig as af, getTraitName as ag, isCallSiteConfigDeclaration as ah, isCircuitEvent as ai, isInlineTrait as aj, isReferenceConfigType as ak, normalizeCallSiteConfigToValues as al, normalizeTraitRef as am, resolveConfigRefEventName as an, type TraitScope as ao, type CallSiteConfigEntry as b, type Trait as c, type TraitConfig as d, CONFIG_REF_EVENT_PATTERN as e, type ConfigFieldDeclaration as f, ConfigFieldDeclarationSchema as g, type ConfigFieldItemsDeclaration as h, type ConfigRefEventError as i, DeclaredTraitConfigSchema as j, EntityFieldContractSchema as k, type Event as l, type EventInput as m, type EventPayloadField as n, EventPayloadFieldSchema as o, EventSchema as p, type EventScope as q, EventScopeSchema as r, type GuardInput as s, GuardSchema as t, ListenSourceSchema as u, OrbitalTraitRefSchema as v, PayloadFieldSchema as w, type PresentationType as x, type ReferenceConfigType as y, type RequiredField as z };

package/dist/types/index.d.ts

@@ -1,13 +1,13 @@
-import { M as MakeTraitRefOpts, b4 as PageTraitRef, O as OrbitalSchema, a6 as EventWiringEntry, aq as LayoutStrategy, bi as ThemeDefinition, a7 as Orbital, aZ as Page, K as DomainContext, a as OrbitalDefinition } 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, 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, 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, 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, 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, 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, a_ as PageRef, a$ as PageRefObject, b0 as PageRefObjectSchema, b1 as PageRefSchema, b2 as PageRefStringSchema, b3 as PageSchema, 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, 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, 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 { E as EntityField, a as EntityPersistence, bn as ServiceParams, F as FieldValue, J as JsonValue, e as Entity, g as EntityRow, A as AnyPatternConfig, O as OrbitalId, T as TraitId, b as EventId, aw as JsonObject, f as ToolArgs, c as Effect } from '../effect-Cd6ibbZc.js';
+import { M as MakeTraitRefOpts, b4 as PageTraitRef, O as OrbitalSchema, a6 as EventWiringEntry, aq as LayoutStrategy, bi as ThemeDefinition, a7 as Orbital, aZ as Page, K as DomainContext, a as OrbitalDefinition } 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, 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, 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, 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, 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, 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, a_ as PageRef, a$ as PageRefObject, b0 as PageRefObjectSchema, b1 as PageRefSchema, b2 as PageRefStringSchema, b3 as PageSchema, 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, 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, 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 FieldValue, E as EntityField, a as EntityPersistence, bn as ServiceParams, J as JsonValue, e as Entity, g as EntityRow, A as AnyPatternConfig, O as OrbitalId, T as TraitId, b as EventId, aw as JsonObject, f as ToolArgs, c as Effect } 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, 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, a0 as EffectInput, a1 as EffectSchema, a2 as EmitConfig, a3 as EmitEffect, a4 as EntityData, a5 as EntityFieldInput, a6 as EntityFieldSchema, d as EntityId, a7 as EntityIdSchema, a8 as EntityPersistenceSchema, a9 as EntityRole, aa as EntityRoleSchema, ab as EntitySchema, ac as EntityWith, ad as EnumEntityField, ae as EvaluateConfig, af as EvaluateEffect, 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, 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, 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, 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, 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, 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 { d as EventPayloadValue, a as EventPayload, L as LogMeta, S as SExpr, c as EvalContext } from '../expression-DpAj1RzP.js';
 export { C as CORE_BINDINGS, b as CoreBinding, E as Expression, e as ExpressionInput, f as ExpressionSchema, 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 { z } from 'zod';
-import { a as TraitReference, c as Trait, L as ListenSource, D as DeclaredTraitConfig, d as TraitConfig, f as ConfigFieldDeclaration, S as State, aa as Transition, l as Event, U as TraitConfigValue, K as TraitCategory, an as TraitScope } from '../trait-X5mQAMtW.js';
-export { e as CONFIG_REF_EVENT_PATTERN, C as CallSiteConfig, b as CallSiteConfigEntry, g as ConfigFieldDeclarationSchema, h as ConfigFieldItemsDeclaration, i as ConfigRefEventError, j as DeclaredTraitConfigSchema, E as EntityFieldContract, k as EntityFieldContractSchema, 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, 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, M as TraitCategorySchema, N as TraitConfigObject, Q as TraitConfigSchema, 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, a4 as TraitReferenceInput, a5 as TraitReferenceSchema, a6 as TraitSchema, a7 as TraitTick, a8 as TraitTickSchema, a9 as TraitUIBinding, 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';
-import { T as TraitOverlay, R as RuleOverlay, J as JsonSchema, c as FactoryConfigTier } from '../types-DujRcijG.js';
+import { a as TraitReference, c as Trait, L as ListenSource, D as DeclaredTraitConfig, d as TraitConfig, f as ConfigFieldDeclaration, S as State, ab as Transition, l as Event, V as TraitConfigValue, M as TraitCategory, ao as TraitScope } from '../trait-CEO7o8Ne.js';
+export { e as CONFIG_REF_EVENT_PATTERN, C as CallSiteConfig, b as CallSiteConfigEntry, g as ConfigFieldDeclarationSchema, h as ConfigFieldItemsDeclaration, i as ConfigRefEventError, j as DeclaredTraitConfigSchema, E as EntityFieldContract, k as EntityFieldContractSchema, 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, 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, N as TraitCategorySchema, Q as TraitConfigObject, U as TraitConfigSchema, 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, a5 as TraitReferenceInput, a6 as TraitReferenceSchema, a7 as TraitSchema, a8 as TraitTick, a9 as TraitTickSchema, aa as TraitUIBinding, 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';
+import { T as TraitOverlay, R as RuleOverlay, J as JsonSchema, c as FactoryConfigTier } from '../types-1YGQKdbm.js';
 
 /**
  * S-Expression Bindings
@@ -179,6 +179,111 @@ declare function isTraitFieldRef(value: unknown): value is TraitFieldRef;
  *  JSON or recipe overrides at runtime boundaries. */
 declare const TraitFieldRefSchema: z.ZodString;
 
+/**
+ * Authenticated user context — what `@user.x` resolves against.
+ *
+ * The canonical shape for the `user` binding root, shared by both execution
+ * paths: the JS interpreter resolves `@user.id` through
+ * `EvaluationContext.user`, and the compiled shell emits `user?.id` against the
+ * `UserContext` its `@app/shared` re-exports from here.
+ *
+ * `id` is the field the behavior library reads for ownership scoping and `role`
+ * the field it reads for capability gating. Auth providers that name the subject
+ * `uid` must normalize at their boundary — {@link normalizeUserContext} does that.
+ *
+ * @packageDocumentation
+ */
+
+/** Authenticated user / agent identity behind `@user.x` bindings. */
+interface UserContext {
+    /** Stable subject identifier. `@user.id` — the ownership key. */
+    id: string;
+    /** `@user.email` */
+    email?: string;
+    /** `@user.name` — display name. */
+    name?: string;
+    /** `@user.role` — single role string, compared against a policy's allowed list. */
+    role?: string;
+    /** `@user.permissions` — fine-grained capability strings. */
+    permissions?: string[];
+    /** Additional provider claims, readable as `@user.<claim>`. */
+    [key: string]: FieldValue | undefined;
+}
+/**
+ * The identity of an unauthenticated viewer. A resolvable object rather than
+ * `undefined` so a role predicate evaluates to a definite `false` instead of
+ * comparing against nothing.
+ */
+declare const ANONYMOUS_USER: UserContext;
+/** Provider-shaped identity claims, before normalization. */
+interface RawUserClaims {
+    id?: string;
+    uid?: string;
+    email?: string | null;
+    name?: string;
+    displayName?: string | null;
+    role?: string;
+    permissions?: string[];
+    [key: string]: FieldValue | undefined;
+}
+/**
+ * Normalize provider claims into a {@link UserContext}.
+ *
+ * Firebase (and most OIDC providers) name the subject `uid` and the display name
+ * `displayName`, while every `.lolo` behavior reads `@user.id` / `@user.name`.
+ * Without this normalization `@user.id` is `undefined` against a fully
+ * authenticated request and every ownership filter silently matches no rows.
+ * `uid` is preserved so `@user.uid` keeps working.
+ *
+ * Returns `undefined` for absent or subject-less claims so callers can
+ * distinguish "no auth ran" from "anonymous"; use {@link ANONYMOUS_USER} where a
+ * definite identity is required.
+ */
+declare function normalizeUserContext(claims: RawUserClaims | null | undefined): UserContext | undefined;
+/**
+ * Dev persona roster — seeded identities for local runs, previews and mocked
+ * sign-in. NOT production data: nothing authenticates against this. It exists so
+ * an app can be viewed as each persona its domain implies before real auth is
+ * wired.
+ *
+ * A domain whose end-user role is named differently (`patient`, `student`) adds
+ * its own persona at the call site; these are defaults, not an allow-list.
+ */
+declare const MOCK_PERSONAS: readonly UserContext[];
+/** Look a dev persona up by id, or by role when no id matches. */
+declare function findMockPersona(idOrRole: string): UserContext | undefined;
+/**
+ * Resolve a persona spec — a bare seeded id/role (`member-1`, `member`) or a full
+ * JSON `UserContext` — into a viewer. This is the `ALMADAR_PERSONA` contract,
+ * shared by every host that presents an app as somebody.
+ *
+ * Throws on anything unresolvable rather than returning `undefined`: "no persona"
+ * and "persona silently ignored" look identical on screen, so a bad spec must
+ * fail at boot instead of rendering as nobody.
+ */
+declare function resolvePersonaSpec(spec: string): UserContext;
+/**
+ * Marks a bearer token as a mocked dev identity rather than a real ID token.
+ * The prefix is deliberately unmistakable: a server accepts these ONLY behind an
+ * explicit dev opt-in, so a production deployment rejects them like any other
+ * malformed token.
+ */
+declare const DEV_TOKEN_PREFIX = "almadar-dev.";
+/**
+ * Encode a viewer as a dev bearer token.
+ *
+ * Carries the WHOLE identity, not just the subject: real Firebase claims have no
+ * `role`, so a server that only reads `uid` leaves every `@user.role` gate inert
+ * even for a signed-in user. URI-encoded JSON keeps the token header-safe (no
+ * spaces or delimiters) and works unchanged in Node and the browser.
+ */
+declare function encodeDevIdentityToken(user: UserContext): string;
+/**
+ * Decode a dev bearer token back into a viewer, or `undefined` if it is not one
+ * / is malformed — callers fail closed rather than inventing an identity.
+ */
+declare function decodeDevIdentityToken(token: string): UserContext | undefined;
+
 /**
  * Validation error types — the shape emitted by every
  * `.orb` / `.lolo` validator pass.
@@ -2839,4 +2944,4 @@ interface ParsedDesign {
     };
 }
 
-export { type AgentCodeSearchResult, type AgentCompactResult, type AgentCompactStrategy, type AgentContext, type AgentGenerateOptions, type AgentMemoryCategory, type AgentMemoryRecord, type AnalysisOrbital, type AnalysisOrbitalParams, type AnalysisPageOverride, type AnalysisRename, type AnalysisResult, type AnnotationTier, type AppCreatedEvent, OrbitalSchema as AppSchema, type AppSummary, type AssetLoadStatus, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, type BindingContext, type BindingRoot, BindingSchema, type BridgeHealth, type BuilderResult, type BusEvent, type BusEventListener, type BusEventSource, type CancelledEvent, type CategorizedRemovals, type ChangeAuthor, type ChangeSetDocument, type ChangeSummary, type ChangesetRecordedEvent, type ChangesetValue, type CheckStatus, type Clarification, type ClarificationCandidate, type ClarificationLevel, type CompleteEvent, type ComplexityAssessment, type ComposeAllResult, type ComposeChildrenResult, type ComposeOptions, ConfigFieldDeclaration, type ContextExtensions, type CreateFlow, DEFAULT_INTERACTION_MODELS, DeclaredTraitConfig, type DeleteFlow, type DispatchUpdatesResult, DomainContext, type EdgeType, type EditFlow, Effect, type EffectPayload, type EffectResult, type EffectTrace, Entity, EntityField, EntityPersistence, EntityRow, type ErrorEvent, EvalContext, Event, type EventEmit, EventId, type EventKey, type EventListen, type EventLogEntry, EventPayload, EventPayloadValue, type EvolutionDelta, type ExecutePlanResult, type ExtraTraitRef, FieldValue, type FileOperationEvent, type FileWrittenEvent, Orbital as FullOrbitalUnit, type GateState, type GenerationLogEvent, type GitHubIssue, type GitHubLink, type GitHubRepo, type HistoryMeta, type IntegrationContext, type InteractionModel, type InteractionModelInput, InteractionModelSchema, type InterruptEvent, JsonObject, JsonValue, KNOWN_VALIDATION_ERROR_CODES, type KnobPayload, type KnownValidationErrorCode, type LazyService, type LineageEntry, type ListInteraction, ListenSource, type LivingEdge, type LivingEffect, type LivingEntity, type LivingEvent, type LivingField, type LivingOrbital, type LivingOrbitalSchema, type LivingPage, type LivingState, type LivingTrait, type LivingTransition, type LivingValue, type LivingVertex, type LlmCallToolsResult, type LlmContext, type LlmMessage, type LlmTokenUsage, type LlmToolCall, type LlmToolDef, LogMeta, type LoloEmitResult, type MemoryContext, type MessageEvent, Orbital, type OrbitalAddedEvent, OrbitalDefinition, OrbitalId, OrbitalSchema, type OrbitalSchemaCompleteEvent, type OrbitalVerificationAPI, Page, type PageContentReduction, PageTraitRef, type ParamsRepairEmittedEvent, type ParsedDesign, type ParsedDomainContext, type ParsedEmitDeclaration, type ParsedEntity, type ParsedEvent, type ParsedListenDeclaration, type ParsedOrbital, type ParsedPage, type ParsedState, type ParsedStateMachine, type ParsedTrait, type ParsedTraitConfig, type ParsedTransition, PatternTypeSchema, type PersistActionName, type PlanSnapshot, type PlanSnapshotStatus, type PlannerResult, type Probability, type ProcessCompleteEvent, type ProcessErrorEvent, type ProcessRepairCompleteEvent, type ProcessRepairEvent, type ProcessStartEvent, type RepairResult, type ResolvedEntity, type ResolvedEntityBinding, type ResolvedField, type ResolvedIR, type ResolvedNavigation, type ResolvedPage, type ResolvedPattern, type ResolvedSection, type ResolvedSectionEvent, type ResolvedTrait, type ResolvedTraitBinding, type ResolvedTraitDataEntity, type ResolvedTraitEvent, type ResolvedTraitGuard, type ResolvedTraitListener, type ResolvedTraitState, type ResolvedTraitTick, type ResolvedTraitTransition, type ResolvedTraitUIBinding, SExpr, type SSEEvent, type SSEEventBase, type SSEEventType, type SaveOptions, type SaveResult, type SchemaChange, type SchemaPhaseUpdateEvent, type SchemaPhaseValidatedEvent, type SchemaUpdateEvent, type SemanticAnnotation, type SemanticChangeKind, type SemanticSchemaChange, type SemanticVector, type ServerResponseTrace, type ServiceAction, type ServiceActionName, type ServiceCallResult, type ServiceContract, type ServiceEvents, ServiceParams, type SessionContext, type SessionHistoryEntry, type SnapshotCreatedEvent, type SnapshotDocument, type SpawnResult, type StartEvent, State, type StatsView, type StoreContract, type StoreFilter, type StoreFilterOp, type SubagentCompleteEvent, type SubagentEvent, type SubagentProgressEvent, type SubagentStartEvent, ThemeDefinition, type TodoActivityType, type TodoDetailEvent, type TodoUpdateEvent, ToolArgs, type ToolCallEvent, type ToolResultEvent, type TraceContext, Trait, TraitCategory, TraitConfig, TraitConfigValue, type TraitFieldRef, TraitFieldRefSchema, TraitId, TraitReference, type TraitStateSnapshot, Transition, type TransitionFrom, type TransitionTrace, type Unsubscribe, type ValidateResult, OrbitalDefinition as ValidatedOrbital, type ValidationDocument, type ValidationError, type ValidationErrorCode, type ValidationIssue, type ValidationMeta, type ValidationResult, type ValidationResults, type VerificationCheck, type VerificationSnapshot, type VerificationSummary, type VertexId, type VertexPayload, type VertexType, type ViewFlow, type WorkspaceContext, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, getBindingExamples, getInteractionModelForDomain, inferTsType, isKnownValidationErrorCode, isPlanSnapshot, isResolvedIR, isSessionHistoryEntry, isTraitFieldRef, toBindingRoot, validateBindingInContext, widenTier };
+export { ANONYMOUS_USER, type AgentCodeSearchResult, type AgentCompactResult, type AgentCompactStrategy, type AgentContext, type AgentGenerateOptions, type AgentMemoryCategory, type AgentMemoryRecord, type AnalysisOrbital, type AnalysisOrbitalParams, type AnalysisPageOverride, type AnalysisRename, type AnalysisResult, type AnnotationTier, type AppCreatedEvent, OrbitalSchema as AppSchema, type AppSummary, type AssetLoadStatus, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, type BindingContext, type BindingRoot, BindingSchema, type BridgeHealth, type BuilderResult, type BusEvent, type BusEventListener, type BusEventSource, type CancelledEvent, type CategorizedRemovals, type ChangeAuthor, type ChangeSetDocument, type ChangeSummary, type ChangesetRecordedEvent, type ChangesetValue, type CheckStatus, type Clarification, type ClarificationCandidate, type ClarificationLevel, type CompleteEvent, type ComplexityAssessment, type ComposeAllResult, type ComposeChildrenResult, type ComposeOptions, ConfigFieldDeclaration, type ContextExtensions, type CreateFlow, DEFAULT_INTERACTION_MODELS, DEV_TOKEN_PREFIX, DeclaredTraitConfig, type DeleteFlow, type DispatchUpdatesResult, DomainContext, type EdgeType, type EditFlow, Effect, type EffectPayload, type EffectResult, type EffectTrace, Entity, EntityField, EntityPersistence, EntityRow, type ErrorEvent, EvalContext, Event, type EventEmit, EventId, type EventKey, type EventListen, type EventLogEntry, EventPayload, EventPayloadValue, type EvolutionDelta, type ExecutePlanResult, type ExtraTraitRef, FieldValue, type FileOperationEvent, type FileWrittenEvent, Orbital as FullOrbitalUnit, type GateState, type GenerationLogEvent, type GitHubIssue, type GitHubLink, type GitHubRepo, type HistoryMeta, type IntegrationContext, type InteractionModel, type InteractionModelInput, InteractionModelSchema, type InterruptEvent, JsonObject, JsonValue, KNOWN_VALIDATION_ERROR_CODES, type KnobPayload, type KnownValidationErrorCode, type LazyService, type LineageEntry, type ListInteraction, ListenSource, type LivingEdge, type LivingEffect, type LivingEntity, type LivingEvent, type LivingField, type LivingOrbital, type LivingOrbitalSchema, type LivingPage, type LivingState, type LivingTrait, type LivingTransition, type LivingValue, type LivingVertex, type LlmCallToolsResult, type LlmContext, type LlmMessage, type LlmTokenUsage, type LlmToolCall, type LlmToolDef, LogMeta, type LoloEmitResult, MOCK_PERSONAS, type MemoryContext, type MessageEvent, Orbital, type OrbitalAddedEvent, OrbitalDefinition, OrbitalId, OrbitalSchema, type OrbitalSchemaCompleteEvent, type OrbitalVerificationAPI, Page, type PageContentReduction, PageTraitRef, type ParamsRepairEmittedEvent, type ParsedDesign, type ParsedDomainContext, type ParsedEmitDeclaration, type ParsedEntity, type ParsedEvent, type ParsedListenDeclaration, type ParsedOrbital, type ParsedPage, type ParsedState, type ParsedStateMachine, type ParsedTrait, type ParsedTraitConfig, type ParsedTransition, PatternTypeSchema, type PersistActionName, type PlanSnapshot, type PlanSnapshotStatus, type PlannerResult, type Probability, type ProcessCompleteEvent, type ProcessErrorEvent, type ProcessRepairCompleteEvent, type ProcessRepairEvent, type ProcessStartEvent, type RawUserClaims, type RepairResult, type ResolvedEntity, type ResolvedEntityBinding, type ResolvedField, type ResolvedIR, type ResolvedNavigation, type ResolvedPage, type ResolvedPattern, type ResolvedSection, type ResolvedSectionEvent, type ResolvedTrait, type ResolvedTraitBinding, type ResolvedTraitDataEntity, type ResolvedTraitEvent, type ResolvedTraitGuard, type ResolvedTraitListener, type ResolvedTraitState, type ResolvedTraitTick, type ResolvedTraitTransition, type ResolvedTraitUIBinding, SExpr, type SSEEvent, type SSEEventBase, type SSEEventType, type SaveOptions, type SaveResult, type SchemaChange, type SchemaPhaseUpdateEvent, type SchemaPhaseValidatedEvent, type SchemaUpdateEvent, type SemanticAnnotation, type SemanticChangeKind, type SemanticSchemaChange, type SemanticVector, type ServerResponseTrace, type ServiceAction, type ServiceActionName, type ServiceCallResult, type ServiceContract, type ServiceEvents, ServiceParams, type SessionContext, type SessionHistoryEntry, type SnapshotCreatedEvent, type SnapshotDocument, type SpawnResult, type StartEvent, State, type StatsView, type StoreContract, type StoreFilter, type StoreFilterOp, type SubagentCompleteEvent, type SubagentEvent, type SubagentProgressEvent, type SubagentStartEvent, ThemeDefinition, type TodoActivityType, type TodoDetailEvent, type TodoUpdateEvent, ToolArgs, type ToolCallEvent, type ToolResultEvent, type TraceContext, Trait, TraitCategory, TraitConfig, TraitConfigValue, type TraitFieldRef, TraitFieldRefSchema, TraitId, TraitReference, type TraitStateSnapshot, Transition, type TransitionFrom, type TransitionTrace, type Unsubscribe, type UserContext, type ValidateResult, OrbitalDefinition as ValidatedOrbital, type ValidationDocument, type ValidationError, type ValidationErrorCode, type ValidationIssue, type ValidationMeta, type ValidationResult, type ValidationResults, type VerificationCheck, type VerificationSnapshot, type VerificationSummary, type VertexId, type VertexPayload, type VertexType, type ViewFlow, type WorkspaceContext, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, decodeDevIdentityToken, encodeDevIdentityToken, findMockPersona, getBindingExamples, getInteractionModelForDomain, inferTsType, isKnownValidationErrorCode, isPlanSnapshot, isResolvedIR, isSessionHistoryEntry, isTraitFieldRef, normalizeUserContext, resolvePersonaSpec, toBindingRoot, validateBindingInContext, widenTier };

package/dist/types/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;
@@ -2536,6 +2614,6 @@ function widenTier(tier) {
   return tier;
 }
 
-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, 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, 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, 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_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, asEntityId, asEventId, asOrbitalId, asPageId, asPaletteEntryId, asServiceId, asThemeId, asTraitId, atomic, callService, collectBindings, configRefEventKnob, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, deref, deriveCollection, despawn, doEffects, emit, findService, getArgs, getBindingExamples, getDefaultAnimationsForRole, getInteractionModelForDomain, getOperator, getServiceNames, getTraitConfig, getTraitName, hasService, idKindOf, idPrefix, inferTsType, isBinding, isCallSiteConfigDeclaration, isCircuitEvent, isEffect, isEntityCall, isEntityId, isEntityReference, isEntityReferenceAny, isEventId, isEventPayloadValue, isFieldValue, isImportedTraitRef, isInlineTrait, isJsonArray, isJsonObject, isJsonPrimitive, isKnownValidationErrorCode, 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, mintId, navigate, normalizeCallSiteConfigToValues, normalizeTraitRef, notify, parseAssetKey, parseBinding, parseEntityRef, parseImportedTraitRef, parseOrbitalSchema, parsePageRef, parseServiceRef, persist, persistenceModeAllowsOverrides, ref, renderUI, resolveConfigRefEventName, safeParseOrbitalSchema, set, sexpr, spawn, swap, toBindingRoot, validateAssetAnimations, validateBindingInContext, walkSExpr, 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, 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, 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, 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_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, asEntityId, asEventId, asOrbitalId, asPageId, asPaletteEntryId, asServiceId, asThemeId, asTraitId, atomic, callService, collectBindings, configRefEventKnob, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, decodeDevIdentityToken, deref, deriveCollection, despawn, doEffects, emit, encodeDevIdentityToken, findMockPersona, findService, getArgs, getBindingExamples, getDefaultAnimationsForRole, getInteractionModelForDomain, getOperator, getServiceNames, getTraitConfig, getTraitName, hasService, idKindOf, idPrefix, inferTsType, isBinding, isCallSiteConfigDeclaration, isCircuitEvent, isEffect, isEntityCall, isEntityId, isEntityReference, isEntityReferenceAny, isEventId, isEventPayloadValue, isFieldValue, isImportedTraitRef, isInlineTrait, isJsonArray, isJsonObject, isJsonPrimitive, isKnownValidationErrorCode, 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, mintId, navigate, normalizeCallSiteConfigToValues, normalizeTraitRef, normalizeUserContext, notify, parseAssetKey, parseBinding, parseEntityRef, parseImportedTraitRef, parseOrbitalSchema, parsePageRef, parseServiceRef, persist, persistenceModeAllowsOverrides, ref, renderUI, resolveConfigRefEventName, resolvePersonaSpec, safeParseOrbitalSchema, set, sexpr, spawn, swap, toBindingRoot, validateAssetAnimations, validateBindingInContext, walkSExpr, watch, widenTier };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map