@almadar/core 10.34.0 → 10.36.0

package/dist/patterns/integrators-registry.json

@@ -379,6 +379,36 @@
         }
       ]
     },
+    "ml": {
+      "name": "ml",
+      "description": "ML service - model inference on a trained or off-the-shelf checkpoint, reached via a deployed serving orbital",
+      "category": "ai",
+      "actions": [
+        {
+          "name": "infer",
+          "description": "Run inference against a deployed model checkpoint",
+          "params": [
+            {
+              "name": "model",
+              "type": "string",
+              "required": true,
+              "description": "hf:<id> for off-the-shelf weights, or a masar checkpoint id"
+            },
+            {
+              "name": "input",
+              "type": "any",
+              "required": true,
+              "description": "JSON-safe model input (object, array, or primitive tensor payload)"
+            }
+          ],
+          "responseShape": {
+            "output": "object",
+            "confidence": "number",
+            "violations": "string[]"
+          }
+        }
+      ]
+    },
     "deepagent": {
       "name": "deepagent",
       "description": "AI code generation agent with tool use - generates schemas, code, and manages projects",

package/dist/patterns/patterns-registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-07-24T05:10:33.187Z",
+  "exportedAt": "2026-07-25T06:32:53.902Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -16320,6 +16320,63 @@
             "auto"
           ],
           "default": "auto"
+        },
+        "titleField": {
+          "types": [
+            "string"
+          ],
+          "description": "Row field holding the chip label. Defaults to `title`. Lets a host bound to its own entity name the column instead of being forced to rename its fields to this grid's contract (same accessor idiom as `DataList`'s `senderField` / `DataGrid`'s `imageField`).",
+          "default": "title"
+        },
+        "startField": {
+          "types": [
+            "string"
+          ],
+          "description": "Row field holding the start timestamp (ISO or epoch). Defaults to `startTime`.",
+          "default": "startTime"
+        },
+        "colorField": {
+          "types": [
+            "string"
+          ],
+          "description": "Row field holding the chip's Tailwind colour class. Defaults to `color`.",
+          "default": "color"
+        },
+        "children": {
+          "types": [
+            "function"
+          ],
+          "description": "Render function for one event chip's content. Receives the row and its index in the materialised events array. The grid keeps ownership of placement, colour and the click target; this replaces only what is drawn INSIDE the chip, so a host can show a time + instructor + badge stack instead of the default single label.",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "item",
+              "type": "object"
+            },
+            {
+              "name": "index",
+              "type": "number"
+            }
+          ],
+          "renderCallback": true
+        },
+        "renderItem": {
+          "types": [
+            "function"
+          ],
+          "description": "Per-event render function (schema-level alias for the children render prop). In `.orb`: `[\"fn\", \"item\", { pattern tree with @item.field bindings }]`. In `.lolo`: `renderItem: (fn item <Component …={@item.field}/>)` — the same contract `data-list` / `data-grid` / `carousel` already use.",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "item",
+              "type": "object"
+            },
+            {
+              "name": "index",
+              "type": "number"
+            }
+          ],
+          "renderCallback": true
         }
       }
     },

package/dist/patterns/registry.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "exportedAt": "2026-07-24T05:10:33.187Z",
+  "exportedAt": "2026-07-25T06:32:53.902Z",
   "patterns": {
     "entity-table": {
       "type": "entity-table",
@@ -16320,6 +16320,63 @@
             "auto"
           ],
           "default": "auto"
+        },
+        "titleField": {
+          "types": [
+            "string"
+          ],
+          "description": "Row field holding the chip label. Defaults to `title`. Lets a host bound to its own entity name the column instead of being forced to rename its fields to this grid's contract (same accessor idiom as `DataList`'s `senderField` / `DataGrid`'s `imageField`).",
+          "default": "title"
+        },
+        "startField": {
+          "types": [
+            "string"
+          ],
+          "description": "Row field holding the start timestamp (ISO or epoch). Defaults to `startTime`.",
+          "default": "startTime"
+        },
+        "colorField": {
+          "types": [
+            "string"
+          ],
+          "description": "Row field holding the chip's Tailwind colour class. Defaults to `color`.",
+          "default": "color"
+        },
+        "children": {
+          "types": [
+            "function"
+          ],
+          "description": "Render function for one event chip's content. Receives the row and its index in the materialised events array. The grid keeps ownership of placement, colour and the click target; this replaces only what is drawn INSIDE the chip, so a host can show a time + instructor + badge stack instead of the default single label.",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "item",
+              "type": "object"
+            },
+            {
+              "name": "index",
+              "type": "number"
+            }
+          ],
+          "renderCallback": true
+        },
+        "renderItem": {
+          "types": [
+            "function"
+          ],
+          "description": "Per-event render function (schema-level alias for the children render prop). In `.orb`: `[\"fn\", \"item\", { pattern tree with @item.field bindings }]`. In `.lolo`: `renderItem: (fn item <Component …={@item.field}/>)` — the same contract `data-list` / `data-grid` / `carousel` already use.",
+          "kind": "callback",
+          "callbackArgs": [
+            {
+              "name": "item",
+              "type": "object"
+            },
+            {
+              "name": "index",
+              "type": "number"
+            }
+          ],
+          "renderCallback": true
         }
       }
     },

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

@@ -1,4 +1,4 @@
-import { b as EventId, c as Effect, T as TraitId, O as OrbitalId, d as EntityId, P as PageId, A as AnyPatternConfig, e as Entity, E as EntityField } from './effect-D9WY6JgN.js';
+import { b as EventId, c as Effect, T as TraitId, O as OrbitalId, d as EntityId, P as PageId, A as AnyPatternConfig, e as Entity, E as EntityField } from './effect-Cd6ibbZc.js';
 import { E as Expression, S as SExpr } from './expression-DpAj1RzP.js';
 import { z } from 'zod';
 
@@ -886,8 +886,13 @@ type TraitEventListener = {
      * - 'external': Listen to events from other orbitals
      */
     scope?: EventScope;
-    /** Map event payload fields to transition payload */
-    payloadMapping?: Record<string, string>;
+    /**
+     * `with { ... }` payload rewrite: `{ targetField: SExpr }`. Each value is a
+     * full s-expression evaluated against the source payload — a `@payload.<field>`
+     * read, a literal, or an operator list. Apply it with
+     * `applyListenPayloadMapping`.
+     */
+    payloadMapping?: Record<string, SExpr>;
     /**
      * Source scoping (see `ListenSource`). Undefined when the listen entry is
      * a local payload declaration rather than a bus subscription.
@@ -904,7 +909,7 @@ declare const TraitEventListenerSchema: z.ZodObject<{
     tier: z.ZodOptional<z.ZodString>;
     guard: z.ZodOptional<z.ZodType<SExpr, z.ZodTypeDef, SExpr>>;
     scope: z.ZodOptional<z.ZodEnum<["internal", "external"]>>;
-    payloadMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    payloadMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<SExpr, z.ZodTypeDef, SExpr>>>;
     source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"any">;
     }, "strip", z.ZodTypeAny, {
@@ -965,7 +970,7 @@ declare const TraitEventListenerSchema: z.ZodObject<{
     eventId?: EventId | undefined;
     guard?: SExpr | undefined;
     triggersId?: EventId | undefined;
-    payloadMapping?: Record<string, string> | undefined;
+    payloadMapping?: Record<string, SExpr> | undefined;
 }, {
     event: string;
     triggers: string;
@@ -989,7 +994,7 @@ declare const TraitEventListenerSchema: z.ZodObject<{
     eventId?: string | undefined;
     guard?: SExpr | undefined;
     triggersId?: string | undefined;
-    payloadMapping?: Record<string, string> | undefined;
+    payloadMapping?: Record<string, SExpr> | undefined;
 }>;
 /**
  * Field required by a trait from its linkedEntity
@@ -1705,7 +1710,7 @@ declare const TraitSchema: z.ZodObject<{
         tier: z.ZodOptional<z.ZodString>;
         guard: z.ZodOptional<z.ZodType<SExpr, z.ZodTypeDef, SExpr>>;
         scope: z.ZodOptional<z.ZodEnum<["internal", "external"]>>;
-        payloadMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        payloadMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<SExpr, z.ZodTypeDef, SExpr>>>;
         source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"any">;
         }, "strip", z.ZodTypeAny, {
@@ -1766,7 +1771,7 @@ declare const TraitSchema: z.ZodObject<{
         eventId?: EventId | undefined;
         guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
-        payloadMapping?: Record<string, string> | undefined;
+        payloadMapping?: Record<string, SExpr> | undefined;
     }, {
         event: string;
         triggers: string;
@@ -1790,7 +1795,7 @@ declare const TraitSchema: z.ZodObject<{
         eventId?: string | undefined;
         guard?: SExpr | undefined;
         triggersId?: string | undefined;
-        payloadMapping?: Record<string, string> | undefined;
+        payloadMapping?: Record<string, SExpr> | undefined;
     }>, "many">>;
     ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     config: z.ZodOptional<z.ZodType<Readonly<Record<string, ConfigFieldDeclaration>>, z.ZodTypeDef, Readonly<Record<string, ConfigFieldDeclaration>>>>;
@@ -1973,7 +1978,7 @@ declare const TraitSchema: z.ZodObject<{
         eventId?: EventId | undefined;
         guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
-        payloadMapping?: Record<string, string> | undefined;
+        payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
     description_visual_prompt?: string | undefined;
     entityRebindable?: boolean | undefined;
@@ -2119,7 +2124,7 @@ declare const TraitSchema: z.ZodObject<{
         eventId?: string | undefined;
         guard?: SExpr | undefined;
         triggersId?: string | undefined;
-        payloadMapping?: Record<string, string> | undefined;
+        payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
     description_visual_prompt?: string | undefined;
     entityRebindable?: boolean | undefined;
@@ -2509,7 +2514,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         tier: z.ZodOptional<z.ZodString>;
         guard: z.ZodOptional<z.ZodType<SExpr, z.ZodTypeDef, SExpr>>;
         scope: z.ZodOptional<z.ZodEnum<["internal", "external"]>>;
-        payloadMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        payloadMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<SExpr, z.ZodTypeDef, SExpr>>>;
         source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"any">;
         }, "strip", z.ZodTypeAny, {
@@ -2570,7 +2575,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         eventId?: EventId | undefined;
         guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
-        payloadMapping?: Record<string, string> | undefined;
+        payloadMapping?: Record<string, SExpr> | undefined;
     }, {
         event: string;
         triggers: string;
@@ -2594,7 +2599,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         eventId?: string | undefined;
         guard?: SExpr | undefined;
         triggersId?: string | undefined;
-        payloadMapping?: Record<string, string> | undefined;
+        payloadMapping?: Record<string, SExpr> | undefined;
     }>, "many">>;
     ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     config: z.ZodOptional<z.ZodType<Readonly<Record<string, ConfigFieldDeclaration>>, z.ZodTypeDef, Readonly<Record<string, ConfigFieldDeclaration>>>>;
@@ -2777,7 +2782,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         eventId?: EventId | undefined;
         guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
-        payloadMapping?: Record<string, string> | undefined;
+        payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
     description_visual_prompt?: string | undefined;
     entityRebindable?: boolean | undefined;
@@ -2923,7 +2928,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         eventId?: string | undefined;
         guard?: SExpr | undefined;
         triggersId?: string | undefined;
-        payloadMapping?: Record<string, string> | undefined;
+        payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
     description_visual_prompt?: string | undefined;
     entityRebindable?: boolean | undefined;
@@ -3383,7 +3388,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         tier: z.ZodOptional<z.ZodString>;
         guard: z.ZodOptional<z.ZodType<SExpr, z.ZodTypeDef, SExpr>>;
         scope: z.ZodOptional<z.ZodEnum<["internal", "external"]>>;
-        payloadMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        payloadMapping: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<SExpr, z.ZodTypeDef, SExpr>>>;
         source: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"any">;
         }, "strip", z.ZodTypeAny, {
@@ -3444,7 +3449,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         eventId?: EventId | undefined;
         guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
-        payloadMapping?: Record<string, string> | undefined;
+        payloadMapping?: Record<string, SExpr> | undefined;
     }, {
         event: string;
         triggers: string;
@@ -3468,7 +3473,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         eventId?: string | undefined;
         guard?: SExpr | undefined;
         triggersId?: string | undefined;
-        payloadMapping?: Record<string, string> | undefined;
+        payloadMapping?: Record<string, SExpr> | undefined;
     }>, "many">>;
     ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     config: z.ZodOptional<z.ZodType<Readonly<Record<string, ConfigFieldDeclaration>>, z.ZodTypeDef, Readonly<Record<string, ConfigFieldDeclaration>>>>;
@@ -3651,7 +3656,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         eventId?: EventId | undefined;
         guard?: SExpr | undefined;
         triggersId?: EventId | undefined;
-        payloadMapping?: Record<string, string> | undefined;
+        payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
     description_visual_prompt?: string | undefined;
     entityRebindable?: boolean | undefined;
@@ -3797,7 +3802,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         eventId?: string | undefined;
         guard?: SExpr | undefined;
         triggersId?: string | undefined;
-        payloadMapping?: Record<string, string> | undefined;
+        payloadMapping?: Record<string, SExpr> | undefined;
     }[] | undefined;
     description_visual_prompt?: string | undefined;
     entityRebindable?: boolean | undefined;

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-DFOj9_N8.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-DFOj9_N8.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-D9WY6JgN.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-D9WY6JgN.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-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 { 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-6_gs33fs.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-6_gs33fs.js';
-import { T as TraitOverlay, R as RuleOverlay, J as JsonSchema, c as FactoryConfigTier } from '../types-CeGT3YB1.js';
+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';
 
 /**
  * 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.
@@ -1535,8 +1640,8 @@ interface ResolvedTraitListener {
     event: string;
     triggers: string;
     guard?: SExpr;
-    /** `with { ... }` payload rewrite: `{ targetField: "@payload.<sourceField>" | literal }` */
-    payloadMapping?: Record<string, string>;
+    /** `with { ... }` payload rewrite: `{ targetField: SExpr }`, evaluated against the source payload. */
+    payloadMapping?: Record<string, SExpr>;
     /** Source scoping (see `ListenSource` in types/trait). */
     source?: ListenSource;
 }
@@ -2800,7 +2905,7 @@ interface ParsedListenDeclaration {
     triggers?: string;
     scope?: 'internal' | 'external';
     payloadMapping?: {
-        [key: string]: string;
+        [key: string]: SExpr;
     };
 }
 /**
@@ -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 };