@almadar/core 10.35.0 → 10.36.0

package/dist/types/index.d.ts

@@ -1,6 +1,6 @@
 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 { 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';
@@ -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

@@ -1923,6 +1923,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 +2605,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, 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