@almadar/core 10.10.0 → 10.12.0

package/dist/{schema-C4ia6wFF.d.ts → schema-CSn8gU27.d.ts}

@@ -1,5 +1,5 @@
 import { E as Expression, S as SExpr } from './expression-BUIi9ezJ.js';
-import { T as TraitConfig, l as TraitConfigObject, S as ServiceRef, d as Entity, f as EntityField, g as EntityPersistence, i as TraitRef, m as EventPayloadField, n as ConfigFieldDeclaration, o as ServiceDefinition, a as Trait } from './trait-CKueAwP9.js';
+import { T as TraitConfig, l as TraitConfigObject, S as ServiceRef, d as Entity, f as EntityField, g as EntityPersistence, i as TraitRef, m as EventPayloadField, n as ConfigFieldDeclaration, o as ServiceDefinition, a as Trait } from './trait-DecHZfpm.js';
 import { z } from 'zod';
 
 /**

package/dist/{trait-CKueAwP9.d.ts → trait-DecHZfpm.d.ts}

@@ -1721,6 +1721,23 @@ declare function isRuntimeEntity(entity: OrbitalEntity): boolean;
  * isSingletonEntity({ persistence: 'persistent' }); // returns false
  */
 declare function isSingletonEntity(entity: OrbitalEntity): boolean;
+/**
+ * Checks whether an entity's persistence mode allows `persistence` /
+ * `collection` overrides at the factory call site.
+ *
+ * Only `persistent` entities (explicit or default) support these overrides.
+ * Runtime, singleton, instance, and local entities are fixed; callers must
+ * not expose `persistence` or `collection` params for them.
+ *
+ * @param persistence - The entity persistence mode (undefined = default persistent)
+ * @returns True when overrides are allowed, false otherwise
+ *
+ * @example
+ * persistenceModeAllowsOverrides('persistent'); // returns true
+ * persistenceModeAllowsOverrides('runtime');    // returns false
+ * persistenceModeAllowsOverrides(undefined);    // returns true (default persistent)
+ */
+declare function persistenceModeAllowsOverrides(persistence: EntityPersistence | undefined): boolean;
 /**
  * A single field value at runtime.
  * Union of all possible types from FieldType: string, number, boolean, date, array, nested.
@@ -2926,7 +2943,17 @@ type CallSiteConfigEntry = TraitConfigValue | ConfigFieldDeclaration;
 type CallSiteConfig = Readonly<Record<string, CallSiteConfigEntry>>;
 /**
  * Type guard: returns `true` when `entry` is an annotated `ConfigFieldDeclaration`
- * (has a `"type"` string key) rather than a plain wiring value.
+ * (a config-field SCHEMA: a `"type"` string key AND a `"default"` value slot)
+ * rather than a plain wiring value or a render value object.
+ *
+ * The `"default"` requirement disambiguates a declaration from a `render-ui`
+ * VALUE object (e.g. `{ type: "tabs", items: "@entity.items", ... }`) that
+ * coincidentally carries a UI-component `type` key — such a value has no
+ * `default` slot and is a `TraitConfigValue`, not a schema declaration. Every
+ * annotated config field lowered from `.lolo` carries a `default`; misreading a
+ * render value as a declaration drops it straight into the `config` map where
+ * Rust's `serde` rejects its inner fields (e.g. `items` is a binding string,
+ * not a `FieldDefinition`).
  */
 declare function isCallSiteConfigDeclaration(entry: CallSiteConfigEntry): entry is ConfigFieldDeclaration;
 /**
@@ -6408,4 +6435,4 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     } | undefined;
 }>]>;
 
-export { ConfigFieldDeclarationSchema as $, ASSET_ASPECTS as A, type AssetCatalogEntry as B, type CallSiteConfig as C, type AssetCatalogEntryInput as D, type Effect as E, AssetCatalogEntrySchema as F, AssetCatalogSchema as G, type AssetDimension as H, AssetDimensionSchema as I, type AssetMap as J, type AssetMapInput as K, AssetMapSchema as L, type AssetMapping as M, type AssetMappingInput as N, AssetMappingSchema as O, AssetSchema as P, type AssetUrl as Q, type RenderBinding as R, type ServiceRef as S, type TraitConfig as T, type UISlot as U, type AtomicEffect as V, type CallServiceConfig as W, type CallServiceEffect as X, type CallSiteConfigEntry as Y, type CheckpointLoadEffect as Z, type CheckpointSaveEffect as _, type Trait as a, PayloadFieldSchema as a$, type DeclaredTraitConfig as a0, DeclaredTraitConfigSchema as a1, type DerefEffect as a2, type DespawnEffect as a3, type DoEffect as a4, ENTITY_ROLES as a5, type EffectInput as a6, EffectSchema as a7, type EmitConfig as a8, type EmitEffect as a9, type FieldType as aA, FieldTypeSchema as aB, type FieldValue as aC, type ForwardConfig as aD, type ForwardEffect as aE, GAME_TYPES as aF, type GameType as aG, GameTypeSchema as aH, type Guard as aI, type GuardInput as aJ, GuardSchema as aK, type ListenSource as aL, ListenSourceSchema as aM, type LogEffect as aN, type McpServiceDef as aO, McpServiceDefSchema as aP, type NavigateEffect as aQ, type NnConfig as aR, type NnLayer as aS, type NotifyEffect as aT, type OrbitalEntity as aU, type OrbitalEntityInput as aV, OrbitalEntitySchema as aW, type OrbitalTraitRef as aX, OrbitalTraitRefSchema as aY, type OsEffect as aZ, type PayloadField as a_, type EntityData as aa, type EntityFieldContract as ab, EntityFieldContractSchema as ac, type EntityFieldInput as ad, EntityFieldSchema as ae, EntityPersistenceSchema as af, type EntityRole as ag, EntityRoleSchema as ah, EntitySchema as ai, type EntityWith as aj, type EnumEntityField as ak, type EvaluateConfig as al, type EvaluateEffect as am, type Event as an, type EventInput as ao, EventPayloadFieldSchema as ap, EventSchema as aq, type EventScope as ar, EventScopeSchema as as, type FetchEffect as at, type FetchOptions as au, type FetchResult as av, type Field as aw, type FieldFormat as ax, FieldFormatSchema as ay, FieldSchema as az, type RenderUIEffect as b, TraitSchema as b$, type PersistData as b0, type PersistEffect as b1, type PersistEmitConfig as b2, type PresentationType as b3, type RefEffect as b4, RelationConfigSchema as b5, type RelationEntityField as b6, type RenderItemLambda as b7, type RenderUIConfig as b8, type RenderUINode as b9, SocketEventsSchema as bA, type SocketServiceDef as bB, SocketServiceDefSchema as bC, type SpawnEffect as bD, type StateInput as bE, type StateMachine as bF, type StateMachineInput as bG, StateMachineSchema as bH, StateSchema as bI, type SwapEffect as bJ, type TrainConfig as bK, type TrainEffect as bL, type TraitCategory as bM, TraitCategorySchema as bN, TraitConfigSchema as bO, type TraitConfigValue as bP, TraitConfigValueSchema as bQ, type TraitDataEntity as bR, TraitDataEntitySchema as bS, type TraitEntityField as bT, TraitEntityFieldSchema as bU, TraitEventContractSchema as bV, TraitEventListenerSchema as bW, type TraitInput as bX, TraitRefSchema as bY, type TraitReferenceInput as bZ, TraitReferenceSchema as b_, type RequiredField as ba, RequiredFieldSchema as bb, type ResolvedAsset as bc, type ResolvedAssetInput as bd, ResolvedAssetSchema as be, type ResolvedPatternProps as bf, type RestAuthConfig as bg, RestAuthConfigSchema as bh, type RestServiceDef as bi, RestServiceDefSchema as bj, SERVICE_TYPES as bk, type ScalarEntityField as bl, type SemanticAssetRef as bm, type SemanticAssetRefInput as bn, SemanticAssetRefSchema as bo, ServiceDefinitionSchema as bp, type ServiceParams as bq, type ServiceParamsValue as br, type ServiceRefObject as bs, ServiceRefObjectSchema as bt, ServiceRefSchema as bu, ServiceRefStringSchema as bv, type ServiceType as bw, ServiceTypeSchema as bx, type SetEffect as by, type SocketEvents as bz, type TraitEventContract as c, type TraitTick as c0, TraitTickSchema as c1, type TraitUIBinding as c2, type Transition as c3, type TransitionInput as c4, TransitionSchema as c5, type TypedEffect as c6, UISlotSchema as c7, UI_SLOTS as c8, VISUAL_STYLES as c9, isServiceReference as cA, isServiceReferenceObject as cB, isSingletonEntity as cC, isSocketService as cD, navigate as cE, normalizeTraitRef as cF, notify as cG, parseAssetKey as cH, parseServiceRef as cI, persist as cJ, ref as cK, renderUI as cL, set as cM, spawn as cN, swap as cO, validateAssetAnimations as cP, watch as cQ, type TraitScope as cR, type VisualStyle as ca, VisualStyleSchema as cb, type WatchEffect as cc, type WatchOptions as cd, atomic as ce, callService as cf, createAssetKey as cg, deref as ch, deriveCollection as ci, despawn as cj, doEffects as ck, emit as cl, findService as cm, getDefaultAnimationsForRole as cn, getServiceNames as co, getTraitConfig as cp, getTraitName as cq, hasService as cr, isCallSiteConfigDeclaration as cs, isCircuitEvent as ct, isEffect as cu, isInlineTrait as cv, isMcpService as cw, isRestService as cx, isRuntimeEntity as cy, isSExprEffect as cz, type Entity as d, type TraitEventListener as e, type EntityField as f, type EntityPersistence as g, type EntityRow as h, type TraitRef as i, type TraitReference as j, type RelationConfig as k, type TraitConfigObject as l, type EventPayloadField as m, type ConfigFieldDeclaration as n, type ServiceDefinition as o, type State as p, ASSET_DIMENSIONS as q, type AgentEffect as r, type AnimationDef as s, type AnimationDefInput as t, AnimationDefSchema as u, type ArrayEntityField as v, type Asset as w, type AssetAspect as x, AssetAspectSchema as y, type AssetCatalog as z };
+export { ConfigFieldDeclarationSchema as $, ASSET_ASPECTS as A, type AssetCatalogEntry as B, type CallSiteConfig as C, type AssetCatalogEntryInput as D, type Effect as E, AssetCatalogEntrySchema as F, AssetCatalogSchema as G, type AssetDimension as H, AssetDimensionSchema as I, type AssetMap as J, type AssetMapInput as K, AssetMapSchema as L, type AssetMapping as M, type AssetMappingInput as N, AssetMappingSchema as O, AssetSchema as P, type AssetUrl as Q, type RenderBinding as R, type ServiceRef as S, type TraitConfig as T, type UISlot as U, type AtomicEffect as V, type CallServiceConfig as W, type CallServiceEffect as X, type CallSiteConfigEntry as Y, type CheckpointLoadEffect as Z, type CheckpointSaveEffect as _, type Trait as a, PayloadFieldSchema as a$, type DeclaredTraitConfig as a0, DeclaredTraitConfigSchema as a1, type DerefEffect as a2, type DespawnEffect as a3, type DoEffect as a4, ENTITY_ROLES as a5, type EffectInput as a6, EffectSchema as a7, type EmitConfig as a8, type EmitEffect as a9, type FieldType as aA, FieldTypeSchema as aB, type FieldValue as aC, type ForwardConfig as aD, type ForwardEffect as aE, GAME_TYPES as aF, type GameType as aG, GameTypeSchema as aH, type Guard as aI, type GuardInput as aJ, GuardSchema as aK, type ListenSource as aL, ListenSourceSchema as aM, type LogEffect as aN, type McpServiceDef as aO, McpServiceDefSchema as aP, type NavigateEffect as aQ, type NnConfig as aR, type NnLayer as aS, type NotifyEffect as aT, type OrbitalEntity as aU, type OrbitalEntityInput as aV, OrbitalEntitySchema as aW, type OrbitalTraitRef as aX, OrbitalTraitRefSchema as aY, type OsEffect as aZ, type PayloadField as a_, type EntityData as aa, type EntityFieldContract as ab, EntityFieldContractSchema as ac, type EntityFieldInput as ad, EntityFieldSchema as ae, EntityPersistenceSchema as af, type EntityRole as ag, EntityRoleSchema as ah, EntitySchema as ai, type EntityWith as aj, type EnumEntityField as ak, type EvaluateConfig as al, type EvaluateEffect as am, type Event as an, type EventInput as ao, EventPayloadFieldSchema as ap, EventSchema as aq, type EventScope as ar, EventScopeSchema as as, type FetchEffect as at, type FetchOptions as au, type FetchResult as av, type Field as aw, type FieldFormat as ax, FieldFormatSchema as ay, FieldSchema as az, type RenderUIEffect as b, TraitSchema as b$, type PersistData as b0, type PersistEffect as b1, type PersistEmitConfig as b2, type PresentationType as b3, type RefEffect as b4, RelationConfigSchema as b5, type RelationEntityField as b6, type RenderItemLambda as b7, type RenderUIConfig as b8, type RenderUINode as b9, SocketEventsSchema as bA, type SocketServiceDef as bB, SocketServiceDefSchema as bC, type SpawnEffect as bD, type StateInput as bE, type StateMachine as bF, type StateMachineInput as bG, StateMachineSchema as bH, StateSchema as bI, type SwapEffect as bJ, type TrainConfig as bK, type TrainEffect as bL, type TraitCategory as bM, TraitCategorySchema as bN, TraitConfigSchema as bO, type TraitConfigValue as bP, TraitConfigValueSchema as bQ, type TraitDataEntity as bR, TraitDataEntitySchema as bS, type TraitEntityField as bT, TraitEntityFieldSchema as bU, TraitEventContractSchema as bV, TraitEventListenerSchema as bW, type TraitInput as bX, TraitRefSchema as bY, type TraitReferenceInput as bZ, TraitReferenceSchema as b_, type RequiredField as ba, RequiredFieldSchema as bb, type ResolvedAsset as bc, type ResolvedAssetInput as bd, ResolvedAssetSchema as be, type ResolvedPatternProps as bf, type RestAuthConfig as bg, RestAuthConfigSchema as bh, type RestServiceDef as bi, RestServiceDefSchema as bj, SERVICE_TYPES as bk, type ScalarEntityField as bl, type SemanticAssetRef as bm, type SemanticAssetRefInput as bn, SemanticAssetRefSchema as bo, ServiceDefinitionSchema as bp, type ServiceParams as bq, type ServiceParamsValue as br, type ServiceRefObject as bs, ServiceRefObjectSchema as bt, ServiceRefSchema as bu, ServiceRefStringSchema as bv, type ServiceType as bw, ServiceTypeSchema as bx, type SetEffect as by, type SocketEvents as bz, type TraitEventContract as c, type TraitTick as c0, TraitTickSchema as c1, type TraitUIBinding as c2, type Transition as c3, type TransitionInput as c4, TransitionSchema as c5, type TypedEffect as c6, UISlotSchema as c7, UI_SLOTS as c8, VISUAL_STYLES as c9, isServiceReference as cA, isServiceReferenceObject as cB, isSingletonEntity as cC, isSocketService as cD, navigate as cE, normalizeTraitRef as cF, notify as cG, parseAssetKey as cH, parseServiceRef as cI, persist as cJ, persistenceModeAllowsOverrides as cK, ref as cL, renderUI as cM, set as cN, spawn as cO, swap as cP, validateAssetAnimations as cQ, watch as cR, type TraitScope as cS, type VisualStyle as ca, VisualStyleSchema as cb, type WatchEffect as cc, type WatchOptions as cd, atomic as ce, callService as cf, createAssetKey as cg, deref as ch, deriveCollection as ci, despawn as cj, doEffects as ck, emit as cl, findService as cm, getDefaultAnimationsForRole as cn, getServiceNames as co, getTraitConfig as cp, getTraitName as cq, hasService as cr, isCallSiteConfigDeclaration as cs, isCircuitEvent as ct, isEffect as cu, isInlineTrait as cv, isMcpService as cw, isRestService as cx, isRuntimeEntity as cy, isSExprEffect as cz, type Entity as d, type TraitEventListener as e, type EntityField as f, type EntityPersistence as g, type EntityRow as h, type TraitRef as i, type TraitReference as j, type RelationConfig as k, type TraitConfigObject as l, type EventPayloadField as m, type ConfigFieldDeclaration as n, type ServiceDefinition as o, type State as p, ASSET_DIMENSIONS as q, type AgentEffect as r, type AnimationDef as s, type AnimationDefInput as t, AnimationDefSchema as u, type ArrayEntityField as v, type Asset as w, type AssetAspect as x, AssetAspectSchema as y, type AssetCatalog as z };

package/dist/types/index.d.ts

@@ -1,14 +1,14 @@
-import { O as OrbitalSchema, a7 as Orbital, b as Page, L as DomainContext, a as OrbitalDefinition, b0 as PageTraitRef } from '../schema-C4ia6wFF.js';
-export { A as AGENT_DOMAIN_CATEGORIES, d as ALLOWED_CUSTOM_COMPONENTS, e as AgentDomainCategory, f as AgentDomainCategorySchema, g as AllowedCustomComponent, C as ColorSlice, h as ColorSliceSchema, i as ColorTokens, j 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, F as DesignPreferencesSchema, G as DesignTokens, H as DesignTokensInput, I as DesignTokensSchema, J as DomainCategory, K as DomainCategorySchema, M as DomainContextInput, N as DomainContextSchema, Q as DomainVocabulary, R as DomainVocabularySchema, S as ElevationSlice, T as ElevationSliceSchema, V as ElevationTokens, W as ElevationTokensSchema, X as EntityCall, Y as EntityCallSchema, E as EntityRef, Z as EntityRefSchema, _ as EntityRefStringSchema, $ as EntitySemanticRole, a0 as EntitySemanticRoleSchema, a1 as EventListener, a2 as EventListenerSchema, a3 as EventSemanticRole, a4 as EventSemanticRoleSchema, a5 as EventSource, a6 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, aq as MotionDurationKey, ar as MotionDurationKeySchema, as as MotionDurationPalette, at as MotionDurationPaletteSchema, au as MotionEasingKey, av as MotionEasingKeySchema, aw as MotionEasingPalette, ax as MotionEasingPaletteSchema, ay as MotionIntent, az as MotionIntentMap, aA as MotionIntentMapSchema, aB as MotionIntentSchema, aC as MotionSlice, aD as MotionSliceSchema, aE as MotionTokens, aF as MotionTokensSchema, aG as NodeClassification, aH as NodeClassificationSchema, aI as OrbitalConfig, aJ as OrbitalConfigInput, aK as OrbitalConfigSchema, aL as OrbitalDefinitionSchema, aM as OrbitalInput, aN as OrbitalPage, aO as OrbitalPageInput, aP as OrbitalPageSchema, aQ as OrbitalPageStrictInput, aR as OrbitalPageStrictSchema, aS as OrbitalSchemaInput, aT as OrbitalSchemaSchema, aU as OrbitalSchemaWithTraits, aV as OrbitalUnit, aW as OrbitalUnitSchema, aX as OrbitalZodSchema, P as PageRef, c as PageRefObject, aY as PageRefObjectSchema, aZ as PageRefSchema, a_ as PageRefStringSchema, a$ as PageSchema, b1 as PageTraitRefSchema, b2 as RelatedLink, b3 as RelatedLinkSchema, b4 as SchemaMetadata, b5 as SchemaMetadataSchema, b6 as SkinSpec, b7 as SkinSpecSchema, b8 as SpacingScale, b9 as SpacingScaleSchema, ba as StateSemanticRole, bb as StateSemanticRoleSchema, bc as SuggestedGuard, bd as SuggestedGuardSchema, be as ThemeDefinition, bf as ThemeDefinitionSchema, bg as ThemeRef, bh as ThemeRefSchema, bi as ThemeRefStringSchema, bj as ThemeTokens, bk as ThemeTokensSchema, bl as ThemeVariant, bm as ThemeVariantSchema, bn as TypeIntent, bo as TypeIntentMap, bp as TypeIntentMapSchema, bq as TypeIntentSchema, br as TypeScale, bs as TypeScaleEntry, bt as TypeScaleEntrySchema, bu as TypeScaleSchema, bv as TypeScaleTokens, bw as TypeScaleTokensSchema, bx as TypeSizeKey, by as TypeSizeKeySchema, bz as TypeSlice, bA as TypeSliceSchema, bB as TypeSlot, bC as TypeSlotSchema, bD as TypeWeight, bE as TypeWeightSchema, bF as UXHints, bG as UXHintsSchema, U as UseDeclaration, bH as UseDeclarationSchema, bI as UserPersona, bJ as UserPersonaInput, bK as UserPersonaSchema, bL as ViewType, bM as ViewTypeSchema, bN as isEntityCall, bO as isEntityReference, bP as isEntityReferenceAny, bQ as isImportedTraitRef, bR as isOrbitalDefinition, bS as isPageReference, bT as isPageReferenceObject, bU as isPageReferenceString, bV as isThemeReference, bW as parseEntityRef, bX as parseImportedTraitRef, bY as parseOrbitalSchema, bZ as parsePageRef, b_ as safeParseOrbitalSchema } from '../schema-C4ia6wFF.js';
-import { bq as ServiceParams, a as Trait, d as Entity, h as EntityRow, aC as FieldValue, a0 as DeclaredTraitConfig, T as TraitConfig, E as Effect, n as ConfigFieldDeclaration, p as State, c3 as Transition, f as EntityField, an as Event, bP as TraitConfigValue, g as EntityPersistence, bM as TraitCategory, cR as TraitScope } from '../trait-CKueAwP9.js';
-export { A as ASSET_ASPECTS, q as ASSET_DIMENSIONS, r as AgentEffect, s as AnimationDef, t as AnimationDefInput, u as AnimationDefSchema, v as ArrayEntityField, w as Asset, x as AssetAspect, y as AssetAspectSchema, z as AssetCatalog, B as AssetCatalogEntry, D as AssetCatalogEntryInput, F as AssetCatalogEntrySchema, G as AssetCatalogSchema, H as AssetDimension, I as AssetDimensionSchema, J as AssetMap, K as AssetMapInput, L as AssetMapSchema, M as AssetMapping, N as AssetMappingInput, O as AssetMappingSchema, P as AssetSchema, Q as AssetUrl, V as AtomicEffect, W as CallServiceConfig, X as CallServiceEffect, C as CallSiteConfig, Y as CallSiteConfigEntry, Z as CheckpointLoadEffect, _ as CheckpointSaveEffect, $ as ConfigFieldDeclarationSchema, a1 as DeclaredTraitConfigSchema, a2 as DerefEffect, a3 as DespawnEffect, a4 as DoEffect, a5 as ENTITY_ROLES, a6 as EffectInput, a7 as EffectSchema, a8 as EmitConfig, a9 as EmitEffect, aa as EntityData, ab as EntityFieldContract, ac as EntityFieldContractSchema, ad as EntityFieldInput, ae as EntityFieldSchema, af as EntityPersistenceSchema, ag as EntityRole, ah as EntityRoleSchema, ai as EntitySchema, aj as EntityWith, ak as EnumEntityField, al as EvaluateConfig, am as EvaluateEffect, ao as EventInput, m as EventPayloadField, ap as EventPayloadFieldSchema, aq as EventSchema, ar as EventScope, as as EventScopeSchema, at as FetchEffect, au as FetchOptions, av as FetchResult, aw as Field, ax as FieldFormat, ay as FieldFormatSchema, az as FieldSchema, aA as FieldType, aB as FieldTypeSchema, aD as ForwardConfig, aE as ForwardEffect, aF as GAME_TYPES, aG as GameType, aH as GameTypeSchema, aI as Guard, aJ as GuardInput, aK as GuardSchema, aL as ListenSource, aM as ListenSourceSchema, aN as LogEffect, aO as McpServiceDef, aP as McpServiceDefSchema, aQ as NavigateEffect, aR as NnConfig, aS as NnLayer, aT as NotifyEffect, aU as OrbitalEntity, aV as OrbitalEntityInput, aW as OrbitalEntitySchema, aX as OrbitalTraitRef, aY as OrbitalTraitRefSchema, aZ as OsEffect, a_ as PayloadField, a$ as PayloadFieldSchema, b0 as PersistData, b1 as PersistEffect, b2 as PersistEmitConfig, b3 as PresentationType, b4 as RefEffect, k as RelationConfig, b5 as RelationConfigSchema, b6 as RelationEntityField, R as RenderBinding, b7 as RenderItemLambda, b8 as RenderUIConfig, b as RenderUIEffect, b9 as RenderUINode, ba as RequiredField, bb as RequiredFieldSchema, bc as ResolvedAsset, bd as ResolvedAssetInput, be as ResolvedAssetSchema, bf as ResolvedPatternProps, bg as RestAuthConfig, bh as RestAuthConfigSchema, bi as RestServiceDef, bj as RestServiceDefSchema, bk as SERVICE_TYPES, bl as ScalarEntityField, bm as SemanticAssetRef, bn as SemanticAssetRefInput, bo as SemanticAssetRefSchema, o as ServiceDefinition, bp as ServiceDefinitionSchema, br as ServiceParamsValue, S as ServiceRef, bs as ServiceRefObject, bt as ServiceRefObjectSchema, bu as ServiceRefSchema, bv as ServiceRefStringSchema, bw as ServiceType, bx as ServiceTypeSchema, by as SetEffect, bz as SocketEvents, bA as SocketEventsSchema, bB as SocketServiceDef, bC as SocketServiceDefSchema, bD as SpawnEffect, bE as StateInput, bF as StateMachine, bG as StateMachineInput, bH as StateMachineSchema, bI as StateSchema, bJ as SwapEffect, bK as TrainConfig, bL as TrainEffect, bN as TraitCategorySchema, l as TraitConfigObject, bO as TraitConfigSchema, bQ as TraitConfigValueSchema, bR as TraitDataEntity, bS as TraitDataEntitySchema, bT as TraitEntityField, bU as TraitEntityFieldSchema, c as TraitEventContract, bV as TraitEventContractSchema, e as TraitEventListener, bW as TraitEventListenerSchema, bX as TraitInput, i as TraitRef, bY as TraitRefSchema, j as TraitReference, bZ as TraitReferenceInput, b_ as TraitReferenceSchema, b$ as TraitSchema, c0 as TraitTick, c1 as TraitTickSchema, c2 as TraitUIBinding, c4 as TransitionInput, c5 as TransitionSchema, c6 as TypedEffect, U as UISlot, c7 as UISlotSchema, c8 as UI_SLOTS, c9 as VISUAL_STYLES, ca as VisualStyle, cb as VisualStyleSchema, cc as WatchEffect, cd as WatchOptions, ce as atomic, cf as callService, cg as createAssetKey, ch as deref, ci as deriveCollection, cj as despawn, ck as doEffects, cl as emit, cm as findService, cn as getDefaultAnimationsForRole, co as getServiceNames, cp as getTraitConfig, cq as getTraitName, cr as hasService, cs as isCallSiteConfigDeclaration, ct as isCircuitEvent, cu as isEffect, cv as isInlineTrait, cw as isMcpService, cx as isRestService, cy as isRuntimeEntity, cz as isSExprEffect, cA as isServiceReference, cB as isServiceReferenceObject, cC as isSingletonEntity, cD as isSocketService, cE as navigate, cF as normalizeTraitRef, cG as notify, cH as parseAssetKey, cI as parseServiceRef, cJ as persist, cK as ref, cL as renderUI, cM as set, cN as spawn, cO as swap, cP as validateAssetAnimations, cQ as watch } from '../trait-CKueAwP9.js';
+import { O as OrbitalSchema, a7 as Orbital, b as Page, L as DomainContext, a as OrbitalDefinition, b0 as PageTraitRef } from '../schema-CSn8gU27.js';
+export { A as AGENT_DOMAIN_CATEGORIES, d as ALLOWED_CUSTOM_COMPONENTS, e as AgentDomainCategory, f as AgentDomainCategorySchema, g as AllowedCustomComponent, C as ColorSlice, h as ColorSliceSchema, i as ColorTokens, j 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, F as DesignPreferencesSchema, G as DesignTokens, H as DesignTokensInput, I as DesignTokensSchema, J as DomainCategory, K as DomainCategorySchema, M as DomainContextInput, N as DomainContextSchema, Q as DomainVocabulary, R as DomainVocabularySchema, S as ElevationSlice, T as ElevationSliceSchema, V as ElevationTokens, W as ElevationTokensSchema, X as EntityCall, Y as EntityCallSchema, E as EntityRef, Z as EntityRefSchema, _ as EntityRefStringSchema, $ as EntitySemanticRole, a0 as EntitySemanticRoleSchema, a1 as EventListener, a2 as EventListenerSchema, a3 as EventSemanticRole, a4 as EventSemanticRoleSchema, a5 as EventSource, a6 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, aq as MotionDurationKey, ar as MotionDurationKeySchema, as as MotionDurationPalette, at as MotionDurationPaletteSchema, au as MotionEasingKey, av as MotionEasingKeySchema, aw as MotionEasingPalette, ax as MotionEasingPaletteSchema, ay as MotionIntent, az as MotionIntentMap, aA as MotionIntentMapSchema, aB as MotionIntentSchema, aC as MotionSlice, aD as MotionSliceSchema, aE as MotionTokens, aF as MotionTokensSchema, aG as NodeClassification, aH as NodeClassificationSchema, aI as OrbitalConfig, aJ as OrbitalConfigInput, aK as OrbitalConfigSchema, aL as OrbitalDefinitionSchema, aM as OrbitalInput, aN as OrbitalPage, aO as OrbitalPageInput, aP as OrbitalPageSchema, aQ as OrbitalPageStrictInput, aR as OrbitalPageStrictSchema, aS as OrbitalSchemaInput, aT as OrbitalSchemaSchema, aU as OrbitalSchemaWithTraits, aV as OrbitalUnit, aW as OrbitalUnitSchema, aX as OrbitalZodSchema, P as PageRef, c as PageRefObject, aY as PageRefObjectSchema, aZ as PageRefSchema, a_ as PageRefStringSchema, a$ as PageSchema, b1 as PageTraitRefSchema, b2 as RelatedLink, b3 as RelatedLinkSchema, b4 as SchemaMetadata, b5 as SchemaMetadataSchema, b6 as SkinSpec, b7 as SkinSpecSchema, b8 as SpacingScale, b9 as SpacingScaleSchema, ba as StateSemanticRole, bb as StateSemanticRoleSchema, bc as SuggestedGuard, bd as SuggestedGuardSchema, be as ThemeDefinition, bf as ThemeDefinitionSchema, bg as ThemeRef, bh as ThemeRefSchema, bi as ThemeRefStringSchema, bj as ThemeTokens, bk as ThemeTokensSchema, bl as ThemeVariant, bm as ThemeVariantSchema, bn as TypeIntent, bo as TypeIntentMap, bp as TypeIntentMapSchema, bq as TypeIntentSchema, br as TypeScale, bs as TypeScaleEntry, bt as TypeScaleEntrySchema, bu as TypeScaleSchema, bv as TypeScaleTokens, bw as TypeScaleTokensSchema, bx as TypeSizeKey, by as TypeSizeKeySchema, bz as TypeSlice, bA as TypeSliceSchema, bB as TypeSlot, bC as TypeSlotSchema, bD as TypeWeight, bE as TypeWeightSchema, bF as UXHints, bG as UXHintsSchema, U as UseDeclaration, bH as UseDeclarationSchema, bI as UserPersona, bJ as UserPersonaInput, bK as UserPersonaSchema, bL as ViewType, bM as ViewTypeSchema, bN as isEntityCall, bO as isEntityReference, bP as isEntityReferenceAny, bQ as isImportedTraitRef, bR as isOrbitalDefinition, bS as isPageReference, bT as isPageReferenceObject, bU as isPageReferenceString, bV as isThemeReference, bW as parseEntityRef, bX as parseImportedTraitRef, bY as parseOrbitalSchema, bZ as parsePageRef, b_ as safeParseOrbitalSchema } from '../schema-CSn8gU27.js';
+import { bq as ServiceParams, a as Trait, d as Entity, h as EntityRow, aC as FieldValue, a0 as DeclaredTraitConfig, T as TraitConfig, E as Effect, n as ConfigFieldDeclaration, p as State, c3 as Transition, f as EntityField, an as Event, bP as TraitConfigValue, g as EntityPersistence, bM as TraitCategory, cS as TraitScope } from '../trait-DecHZfpm.js';
+export { A as ASSET_ASPECTS, q as ASSET_DIMENSIONS, r as AgentEffect, s as AnimationDef, t as AnimationDefInput, u as AnimationDefSchema, v as ArrayEntityField, w as Asset, x as AssetAspect, y as AssetAspectSchema, z as AssetCatalog, B as AssetCatalogEntry, D as AssetCatalogEntryInput, F as AssetCatalogEntrySchema, G as AssetCatalogSchema, H as AssetDimension, I as AssetDimensionSchema, J as AssetMap, K as AssetMapInput, L as AssetMapSchema, M as AssetMapping, N as AssetMappingInput, O as AssetMappingSchema, P as AssetSchema, Q as AssetUrl, V as AtomicEffect, W as CallServiceConfig, X as CallServiceEffect, C as CallSiteConfig, Y as CallSiteConfigEntry, Z as CheckpointLoadEffect, _ as CheckpointSaveEffect, $ as ConfigFieldDeclarationSchema, a1 as DeclaredTraitConfigSchema, a2 as DerefEffect, a3 as DespawnEffect, a4 as DoEffect, a5 as ENTITY_ROLES, a6 as EffectInput, a7 as EffectSchema, a8 as EmitConfig, a9 as EmitEffect, aa as EntityData, ab as EntityFieldContract, ac as EntityFieldContractSchema, ad as EntityFieldInput, ae as EntityFieldSchema, af as EntityPersistenceSchema, ag as EntityRole, ah as EntityRoleSchema, ai as EntitySchema, aj as EntityWith, ak as EnumEntityField, al as EvaluateConfig, am as EvaluateEffect, ao as EventInput, m as EventPayloadField, ap as EventPayloadFieldSchema, aq as EventSchema, ar as EventScope, as as EventScopeSchema, at as FetchEffect, au as FetchOptions, av as FetchResult, aw as Field, ax as FieldFormat, ay as FieldFormatSchema, az as FieldSchema, aA as FieldType, aB as FieldTypeSchema, aD as ForwardConfig, aE as ForwardEffect, aF as GAME_TYPES, aG as GameType, aH as GameTypeSchema, aI as Guard, aJ as GuardInput, aK as GuardSchema, aL as ListenSource, aM as ListenSourceSchema, aN as LogEffect, aO as McpServiceDef, aP as McpServiceDefSchema, aQ as NavigateEffect, aR as NnConfig, aS as NnLayer, aT as NotifyEffect, aU as OrbitalEntity, aV as OrbitalEntityInput, aW as OrbitalEntitySchema, aX as OrbitalTraitRef, aY as OrbitalTraitRefSchema, aZ as OsEffect, a_ as PayloadField, a$ as PayloadFieldSchema, b0 as PersistData, b1 as PersistEffect, b2 as PersistEmitConfig, b3 as PresentationType, b4 as RefEffect, k as RelationConfig, b5 as RelationConfigSchema, b6 as RelationEntityField, R as RenderBinding, b7 as RenderItemLambda, b8 as RenderUIConfig, b as RenderUIEffect, b9 as RenderUINode, ba as RequiredField, bb as RequiredFieldSchema, bc as ResolvedAsset, bd as ResolvedAssetInput, be as ResolvedAssetSchema, bf as ResolvedPatternProps, bg as RestAuthConfig, bh as RestAuthConfigSchema, bi as RestServiceDef, bj as RestServiceDefSchema, bk as SERVICE_TYPES, bl as ScalarEntityField, bm as SemanticAssetRef, bn as SemanticAssetRefInput, bo as SemanticAssetRefSchema, o as ServiceDefinition, bp as ServiceDefinitionSchema, br as ServiceParamsValue, S as ServiceRef, bs as ServiceRefObject, bt as ServiceRefObjectSchema, bu as ServiceRefSchema, bv as ServiceRefStringSchema, bw as ServiceType, bx as ServiceTypeSchema, by as SetEffect, bz as SocketEvents, bA as SocketEventsSchema, bB as SocketServiceDef, bC as SocketServiceDefSchema, bD as SpawnEffect, bE as StateInput, bF as StateMachine, bG as StateMachineInput, bH as StateMachineSchema, bI as StateSchema, bJ as SwapEffect, bK as TrainConfig, bL as TrainEffect, bN as TraitCategorySchema, l as TraitConfigObject, bO as TraitConfigSchema, bQ as TraitConfigValueSchema, bR as TraitDataEntity, bS as TraitDataEntitySchema, bT as TraitEntityField, bU as TraitEntityFieldSchema, c as TraitEventContract, bV as TraitEventContractSchema, e as TraitEventListener, bW as TraitEventListenerSchema, bX as TraitInput, i as TraitRef, bY as TraitRefSchema, j as TraitReference, bZ as TraitReferenceInput, b_ as TraitReferenceSchema, b$ as TraitSchema, c0 as TraitTick, c1 as TraitTickSchema, c2 as TraitUIBinding, c4 as TransitionInput, c5 as TransitionSchema, c6 as TypedEffect, U as UISlot, c7 as UISlotSchema, c8 as UI_SLOTS, c9 as VISUAL_STYLES, ca as VisualStyle, cb as VisualStyleSchema, cc as WatchEffect, cd as WatchOptions, ce as atomic, cf as callService, cg as createAssetKey, ch as deref, ci as deriveCollection, cj as despawn, ck as doEffects, cl as emit, cm as findService, cn as getDefaultAnimationsForRole, co as getServiceNames, cp as getTraitConfig, cq as getTraitName, cr as hasService, cs as isCallSiteConfigDeclaration, ct as isCircuitEvent, cu as isEffect, cv as isInlineTrait, cw as isMcpService, cx as isRestService, cy as isRuntimeEntity, cz as isSExprEffect, cA as isServiceReference, cB as isServiceReferenceObject, cC as isSingletonEntity, cD as isSocketService, cE as navigate, cF as normalizeTraitRef, cG as notify, cH as parseAssetKey, cI as parseServiceRef, cJ as persist, cK as persistenceModeAllowsOverrides, cL as ref, cM as renderUI, cN as set, cO as spawn, cP as swap, cQ as validateAssetAnimations, cR as watch } from '../trait-DecHZfpm.js';
 import { d as EventPayloadValue, c as EventPayload, L as LogMeta, S as SExpr, b as EvalContext } from '../expression-BUIi9ezJ.js';
 export { C as CORE_BINDINGS, a as CoreBinding, E as Expression, e as ExpressionInput, f as ExpressionSchema, P as ParsedBinding, g as SExprAtom, h as SExprAtomSchema, i as SExprInput, j as SExprSchema, k as collectBindings, l as getArgs, m as getOperator, n as isBinding, o as isSExpr, p as isSExprAtom, q as isSExprCall, r as isValidBinding, s as parseBinding, t as sexpr, w as walkSExpr } from '../expression-BUIi9ezJ.js';
 import { z } from 'zod';
 import { AnyPatternConfig } from '@almadar/patterns';
 export { PATTERN_TYPES, PatternConfig, PatternType, isValidPatternType } from '@almadar/patterns';
-import { c as FactoryConfigTier } from '../types-DzmFPbo4.js';
-export { l as JsonObject, J as JsonValue, T as ToolArgs, t as isJsonArray, u as isJsonObject, v as isJsonPrimitive } from '../types-DzmFPbo4.js';
+import { l as JsonObject, T as ToolArgs, J as JsonValue, c as FactoryConfigTier } from '../types-C16w56HW.js';
+export { t as isJsonArray, u as isJsonObject, v as isJsonPrimitive } from '../types-C16w56HW.js';
 
 /**
  * S-Expression Bindings
@@ -1517,6 +1517,317 @@ interface OrbitalVerificationAPI {
     clearEventLog?: () => void;
 }
 
+/**
+ * Canonical SSE event types for the Almadar agent wire.
+ *
+ * These events are emitted by the rabit runtime (internal package
+ * `@almadar-io/rabit`) and consumed by public SDK clients. Because the rabit
+ * package is private, the SDK-relevant subset of the event surface is hoisted
+ * here into `@almadar/core` so public consumers can type their `onEvent`
+ * callbacks without depending on a private package.
+ *
+ * Rules for this file:
+ *   - Use only types already exported by `@almadar/core`.
+ *   - Do not import from `@almadar-io/rabit` or any other private package.
+ *   - Keep the discriminated union exhaustive over the included event types.
+ */
+
+type SSEEventType = 'start' | 'message' | 'tool_call' | 'tool_result' | 'todo_update' | 'todo_detail' | 'file_operation' | 'file_written' | 'schema_update' | 'generation_log' | 'subagent_event' | 'subagent_start' | 'subagent_progress' | 'subagent_complete' | 'interrupt' | 'error' | 'cancelled' | 'complete' | 'app_created' | 'schema_phase_validated' | 'schema_phase_update' | 'orbital_added' | 'orbital_schema_complete' | 'process_start' | 'process_complete' | 'process_error' | 'process_repair' | 'process_repair_complete' | 'params_repair_emitted' | 'changeset_recorded' | 'snapshot_created';
+interface SSEEventBase {
+    type: SSEEventType;
+    timestamp: number;
+}
+interface StartEvent extends SSEEventBase {
+    type: 'start';
+    data: {
+        threadId: string;
+        skill: string;
+        workDir: string;
+    };
+}
+interface MessageEvent extends SSEEventBase {
+    type: 'message';
+    data: {
+        content: string;
+        role: 'assistant' | 'user' | 'system';
+        isComplete: boolean;
+    };
+}
+interface ToolCallEvent extends SSEEventBase {
+    type: 'tool_call';
+    data: {
+        tool: string;
+        args: ToolArgs;
+    };
+}
+interface ToolResultEvent extends SSEEventBase {
+    type: 'tool_result';
+    data: {
+        tool: string;
+        result: JsonValue;
+        success: boolean;
+    };
+}
+interface TodoUpdateEvent extends SSEEventBase {
+    type: 'todo_update';
+    data: {
+        todos: Array<{
+            id: string;
+            task: string;
+            status: 'pending' | 'in_progress' | 'completed';
+        }>;
+    };
+}
+type TodoActivityType = 'thinking' | 'tool_call' | 'tool_result' | 'code_change';
+interface TodoDetailEvent extends SSEEventBase {
+    type: 'todo_detail';
+    data: {
+        todoId: string;
+        activityType: TodoActivityType;
+        content: string;
+        tool?: string;
+        args?: ToolArgs;
+        success?: boolean;
+        filePath?: string;
+        diff?: string;
+    };
+}
+interface FileOperationEvent extends SSEEventBase {
+    type: 'file_operation';
+    data: {
+        operation: 'ls' | 'read_file' | 'write_file' | 'edit_file';
+        path: string;
+        success: boolean;
+    };
+}
+interface FileWrittenEvent extends SSEEventBase {
+    type: 'file_written';
+    data: {
+        path: string;
+        fileType: 'schema' | 'orbital' | 'memory' | 'domain' | 'other';
+        orbitalName?: string;
+    };
+}
+interface SchemaUpdateEvent extends SSEEventBase {
+    type: 'schema_update';
+    data: {
+        appId: string;
+        version: number;
+        schema: OrbitalSchema;
+        isNew: boolean;
+        snapshotId?: string;
+        changesetId?: string;
+    };
+}
+interface GenerationLogEvent extends SSEEventBase {
+    type: 'generation_log';
+    data: {
+        level: 'info' | 'warn' | 'error' | 'debug';
+        message: string;
+        data?: JsonObject;
+        orbitalName?: string;
+    };
+}
+interface SubagentEvent extends SSEEventBase {
+    type: 'subagent_event';
+    data: {
+        orbitalName: string;
+        orbitalIndex: number;
+        totalOrbitals: number;
+        event: {
+            type: Exclude<SSEEventType, 'subagent_event'>;
+            data: JsonObject;
+            timestamp: number;
+        };
+    };
+}
+interface SubagentStartEvent extends SSEEventBase {
+    type: 'subagent_start';
+    data: {
+        subagentId: string;
+        name: string;
+        role: string;
+        orbitalName?: string;
+        parentId?: string;
+        task: string;
+    };
+}
+interface SubagentProgressEvent extends SSEEventBase {
+    type: 'subagent_progress';
+    data: {
+        subagentId: string;
+        orbitalName?: string;
+        message: string;
+        toolCall?: {
+            tool: string;
+            argsPreview?: string;
+        };
+    };
+}
+interface SubagentCompleteEvent extends SSEEventBase {
+    type: 'subagent_complete';
+    data: {
+        subagentId: string;
+        orbitalName?: string;
+        success: boolean;
+        durationMs: number;
+        summary?: string;
+    };
+}
+interface InterruptEvent extends SSEEventBase {
+    type: 'interrupt';
+    data: {
+        threadId: string;
+        actionRequests: Array<{
+            tool: string;
+            args: ToolArgs;
+            allowedDecisions: ('approve' | 'edit' | 'reject')[];
+            description?: string;
+        }>;
+    };
+}
+interface ErrorEvent extends SSEEventBase {
+    type: 'error';
+    data: {
+        error: string;
+        code?: string;
+    };
+}
+interface CancelledEvent extends SSEEventBase {
+    type: 'cancelled';
+    data: {
+        threadId: string;
+        message: string;
+    };
+}
+interface CompleteEvent extends SSEEventBase {
+    type: 'complete';
+    data: {
+        threadId: string;
+        skill: string;
+        workDir: string;
+        schemaGenerated: boolean;
+        appCompiled: boolean;
+        schema?: OrbitalSchema;
+        appId?: string;
+        schemaPersisted?: boolean;
+        snapshotId?: string;
+        changesetId?: string;
+    };
+}
+interface AppCreatedEvent extends SSEEventBase {
+    type: 'app_created';
+    data: {
+        appId: string;
+        name?: string;
+        orbitalCount?: number;
+        fromOrbitalPersistence?: boolean;
+    };
+}
+interface SchemaPhaseValidatedEvent extends SSEEventBase {
+    type: 'schema_phase_validated';
+    data: {
+        appId: string;
+        success: boolean;
+        errors?: JsonValue[];
+    };
+}
+interface SchemaPhaseUpdateEvent extends SSEEventBase {
+    type: 'schema_phase_update';
+    data: JsonObject;
+}
+interface OrbitalAddedEvent extends SSEEventBase {
+    type: 'orbital_added';
+    data: {
+        appId: string;
+        orbitalName: string;
+        orbitalIndex: number;
+        totalOrbitals: number;
+        isNew?: boolean;
+        orbitalSchema?: OrbitalDefinition;
+    };
+}
+interface OrbitalSchemaCompleteEvent extends SSEEventBase {
+    type: 'orbital_schema_complete';
+    data: {
+        appId: string;
+        totalOrbitals: number;
+        orbitalNames: string[];
+    };
+}
+interface ProcessStartEvent extends SSEEventBase {
+    type: 'process_start';
+    data: {
+        orbitalName: string;
+        method: 'deterministic' | 'llm';
+        behavior?: string;
+    };
+}
+interface ProcessCompleteEvent extends SSEEventBase {
+    type: 'process_complete';
+    data: {
+        orbitalName: string;
+        method: 'deterministic' | 'llm';
+        traitCount?: number;
+        transitionCount?: number;
+        duration?: number;
+    };
+}
+interface ProcessErrorEvent extends SSEEventBase {
+    type: 'process_error';
+    data: {
+        orbitalName: string;
+        method: 'deterministic' | 'llm';
+        error: string;
+    };
+}
+interface ProcessRepairEvent extends SSEEventBase {
+    type: 'process_repair';
+    data: {
+        orbitalName: string;
+        errorCount: number;
+        attempt: number;
+    };
+}
+interface ProcessRepairCompleteEvent extends SSEEventBase {
+    type: 'process_repair_complete';
+    data: {
+        orbitalName: string;
+    };
+}
+interface ParamsRepairEmittedEvent extends SSEEventBase {
+    type: 'params_repair_emitted';
+    data: {
+        orbitalName: string;
+        attempt: number;
+    };
+}
+interface ChangesetRecordedEvent extends SSEEventBase {
+    type: 'changeset_recorded';
+    data: {
+        appId: string;
+        changesetId: string;
+        version: number;
+        trackingMode: 'initial' | 'update';
+        summary: {
+            added: number;
+            modified: number;
+            removed: number;
+        };
+        source?: string;
+    };
+}
+interface SnapshotCreatedEvent extends SSEEventBase {
+    type: 'snapshot_created';
+    data: {
+        appId: string;
+        snapshotId: string;
+        version: number;
+        reason: string;
+    };
+}
+type SSEEvent = StartEvent | MessageEvent | ToolCallEvent | ToolResultEvent | TodoUpdateEvent | TodoDetailEvent | FileOperationEvent | FileWrittenEvent | SchemaUpdateEvent | GenerationLogEvent | SubagentEvent | SubagentStartEvent | SubagentProgressEvent | SubagentCompleteEvent | InterruptEvent | ErrorEvent | CancelledEvent | CompleteEvent | AppCreatedEvent | SchemaPhaseValidatedEvent | SchemaPhaseUpdateEvent | OrbitalAddedEvent | OrbitalSchemaCompleteEvent | ProcessStartEvent | ProcessCompleteEvent | ProcessErrorEvent | ProcessRepairEvent | ProcessRepairCompleteEvent | ParamsRepairEmittedEvent | ChangesetRecordedEvent | SnapshotCreatedEvent;
+
 /**
  * Validation error types — the shape emitted by every
  * `.orb` / `.lolo` validator pass.
@@ -2141,4 +2452,4 @@ interface ParsedDesign {
     };
 }
 
-export { type AgentCodeSearchResult, type AgentCompactResult, type AgentCompactStrategy, type AgentContext, type AgentGenerateOptions, type AgentMemoryCategory, type AgentMemoryRecord, type AnnotationTier, OrbitalSchema as AppSchema, type AppSummary, type AssetLoadStatus, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, type BindingContext, type BindingRoot, BindingSchema, type BridgeHealth, type BusEvent, type BusEventListener, type BusEventSource, type CategorizedRemovals, type ChangeAuthor, type ChangeSetDocument, type ChangeSummary, type ChangesetValue, type CheckStatus, ConfigFieldDeclaration, type ContextExtensions, type CreateFlow, DEFAULT_INTERACTION_MODELS, DeclaredTraitConfig, type DeleteFlow, DomainContext, type EdgeType, type EditFlow, Effect, type EffectPayload, type EffectResult, type EffectTrace, Entity, EntityField, EntityPersistence, EntityRow, EvalContext, Event, type EventEmit, type EventKey, type EventListen, type EventLogEntry, EventPayload, EventPayloadValue, type EvolutionDelta, FieldValue, Orbital as FullOrbitalUnit, type GateState, type GitHubLink, type HistoryMeta, type InteractionModel, type InteractionModelInput, InteractionModelSchema, KNOWN_VALIDATION_ERROR_CODES, type KnobPayload, type KnownValidationErrorCode, type LazyService, type LineageEntry, type ListInteraction, 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, LogMeta, Orbital, OrbitalDefinition, OrbitalSchema, type OrbitalVerificationAPI, Page, type PageContentReduction, PageTraitRef, 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 Probability, 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 SaveOptions, type SaveResult, type SchemaChange, type SemanticAnnotation, type SemanticChangeKind, type SemanticSchemaChange, type SemanticVector, type ServerResponseTrace, type ServiceAction, type ServiceActionName, type ServiceContract, type ServiceEvents, ServiceParams, type SnapshotDocument, State, type StatsView, type StoreContract, type StoreFilter, type StoreFilterOp, Trait, TraitCategory, TraitConfig, TraitConfigValue, type TraitFieldRef, TraitFieldRefSchema, type TraitStateSnapshot, Transition, type TransitionFrom, type TransitionTrace, type Unsubscribe, 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, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, getAllPatternTypes, getBindingExamples, getInteractionModelForDomain, inferTsType, isKnownValidationErrorCode, isResolvedIR, isTraitFieldRef, toBindingRoot, validateBindingInContext, widenTier };
+export { type AgentCodeSearchResult, type AgentCompactResult, type AgentCompactStrategy, type AgentContext, type AgentGenerateOptions, type AgentMemoryCategory, type AgentMemoryRecord, 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 BusEvent, type BusEventListener, type BusEventSource, type CancelledEvent, type CategorizedRemovals, type ChangeAuthor, type ChangeSetDocument, type ChangeSummary, type ChangesetRecordedEvent, type ChangesetValue, type CheckStatus, type CompleteEvent, ConfigFieldDeclaration, type ContextExtensions, type CreateFlow, DEFAULT_INTERACTION_MODELS, DeclaredTraitConfig, type DeleteFlow, DomainContext, type EdgeType, type EditFlow, Effect, type EffectPayload, type EffectResult, type EffectTrace, Entity, EntityField, EntityPersistence, EntityRow, type ErrorEvent, EvalContext, Event, type EventEmit, type EventKey, type EventListen, type EventLogEntry, EventPayload, EventPayloadValue, type EvolutionDelta, FieldValue, type FileOperationEvent, type FileWrittenEvent, Orbital as FullOrbitalUnit, type GateState, type GenerationLogEvent, type GitHubLink, type HistoryMeta, type InteractionModel, type InteractionModelInput, InteractionModelSchema, type InterruptEvent, JsonObject, JsonValue, KNOWN_VALIDATION_ERROR_CODES, type KnobPayload, type KnownValidationErrorCode, type LazyService, type LineageEntry, type ListInteraction, 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, LogMeta, type MessageEvent, Orbital, type OrbitalAddedEvent, OrbitalDefinition, 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 Probability, type ProcessCompleteEvent, type ProcessErrorEvent, type ProcessRepairCompleteEvent, type ProcessRepairEvent, type ProcessStartEvent, 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 ServiceContract, type ServiceEvents, ServiceParams, type SnapshotCreatedEvent, type SnapshotDocument, type StartEvent, State, type StatsView, type StoreContract, type StoreFilter, type StoreFilterOp, type SubagentCompleteEvent, type SubagentEvent, type SubagentProgressEvent, type SubagentStartEvent, type TodoActivityType, type TodoDetailEvent, type TodoUpdateEvent, ToolArgs, type ToolCallEvent, type ToolResultEvent, Trait, TraitCategory, TraitConfig, TraitConfigValue, type TraitFieldRef, TraitFieldRefSchema, type TraitStateSnapshot, Transition, type TransitionFrom, type TransitionTrace, type Unsubscribe, 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, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, getAllPatternTypes, getBindingExamples, getInteractionModelForDomain, inferTsType, isKnownValidationErrorCode, isResolvedIR, isTraitFieldRef, toBindingRoot, validateBindingInContext, widenTier };

package/dist/types/index.js

@@ -289,6 +289,9 @@ function isRuntimeEntity(entity) {
 function isSingletonEntity(entity) {
   return entity.persistence === "singleton";
 }
+function persistenceModeAllowsOverrides(persistence) {
+  return persistence === "persistent" || persistence === void 0;
+}
 var UI_SLOTS = [
   // App slots
   "main",
@@ -528,7 +531,7 @@ var TraitConfigValueSchema = z.lazy(
 );
 var TraitConfigSchema = z.record(TraitConfigValueSchema);
 function isCallSiteConfigDeclaration(entry) {
-  return typeof entry === "object" && entry !== null && !Array.isArray(entry) && "type" in entry && typeof entry.type === "string";
+  return typeof entry === "object" && entry !== null && !Array.isArray(entry) && "type" in entry && typeof entry.type === "string" && "default" in entry;
 }
 var ConfigFieldDeclarationSchema = z.object({
   type: z.string(),
@@ -1960,6 +1963,6 @@ function widenTier(tier) {
   return tier;
 }
 
-export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, ASSET_ASPECTS, ASSET_DIMENSIONS, AgentDomainCategorySchema, AnimationDefSchema, AssetAspectSchema, AssetCatalogEntrySchema, AssetCatalogSchema, AssetDimensionSchema, AssetMapSchema, AssetMappingSchema, AssetSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingSchema, CORE_BINDINGS, 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, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FieldFormatSchema, FieldSchema, FieldTypeSchema, GAME_TYPES, GameSubCategorySchema, GameTypeSchema, GeometrySliceSchema, GeometryTokensSchema, GuardSchema, IconFamilySchema, IconographySliceSchema, IconographyTokensSchema, IllustrationSliceSchema, IllustrationStyleSchema, IllustrationTokensSchema, InteractionModelSchema, KNOWN_VALIDATION_ERROR_CODES, ListenSourceSchema, McpServiceDefSchema, MotionDurationKeySchema, MotionDurationPaletteSchema, MotionEasingKeySchema, MotionEasingPaletteSchema, MotionIntentMapSchema, MotionIntentSchema, MotionSliceSchema, MotionTokensSchema, NodeClassificationSchema, OrbitalConfigSchema, OrbitalDefinitionSchema, OrbitalEntitySchema, OrbitalPageSchema, OrbitalPageStrictSchema, OrbitalSchemaSchema, OrbitalTraitRefSchema, OrbitalUnitSchema, OrbitalSchema as OrbitalZodSchema, PageRefObjectSchema, PageRefSchema, PageRefStringSchema, PageSchema, PageTraitRefSchema, PatternTypeSchema, PayloadFieldSchema, RelatedLinkSchema, RelationConfigSchema, RequiredFieldSchema, ResolvedAssetSchema, RestAuthConfigSchema, RestServiceDefSchema, SERVICE_TYPES, SExprAtomSchema, SExprSchema, SchemaMetadataSchema, SemanticAssetRefSchema, ServiceDefinitionSchema, ServiceRefObjectSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SkinSpecSchema, SocketEventsSchema, SocketServiceDefSchema, SpacingScaleSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SuggestedGuardSchema, ThemeDefinitionSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TraitCategorySchema, TraitConfigSchema, TraitConfigValueSchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitFieldRefSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, TypeIntentMapSchema, TypeIntentSchema, TypeScaleEntrySchema, TypeScaleSchema, TypeScaleTokensSchema, TypeSizeKeySchema, TypeSliceSchema, TypeSlotSchema, TypeWeightSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, atomic, callService, collectBindings, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, deref, deriveCollection, despawn, doEffects, emit, findService, getAllPatternTypes, getArgs, getBindingExamples, getDefaultAnimationsForRole, getInteractionModelForDomain, getOperator, getServiceNames, getTraitConfig, getTraitName, hasService, inferTsType, isBinding, isCallSiteConfigDeclaration, isCircuitEvent, isEffect, isEntityCall, isEntityReference, isEntityReferenceAny, isImportedTraitRef, isInlineTrait, isJsonArray, isJsonObject, isJsonPrimitive, isKnownValidationErrorCode, isMcpService, isOrbitalDefinition, isPageReference, isPageReferenceObject, isPageReferenceString, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceReference, isServiceReferenceObject, isSingletonEntity, isSocketService, isThemeReference, isTraitFieldRef, isValidBinding, navigate, normalizeTraitRef, notify, parseAssetKey, parseBinding, parseEntityRef, parseImportedTraitRef, parseOrbitalSchema, parsePageRef, parseServiceRef, persist, ref, renderUI, safeParseOrbitalSchema, set, sexpr, spawn, swap, toBindingRoot, validateAssetAnimations, validateBindingInContext, walkSExpr, watch, widenTier };
+export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, ASSET_ASPECTS, ASSET_DIMENSIONS, AgentDomainCategorySchema, AnimationDefSchema, AssetAspectSchema, AssetCatalogEntrySchema, AssetCatalogSchema, AssetDimensionSchema, AssetMapSchema, AssetMappingSchema, AssetSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingSchema, CORE_BINDINGS, 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, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FieldFormatSchema, FieldSchema, FieldTypeSchema, GAME_TYPES, GameSubCategorySchema, GameTypeSchema, GeometrySliceSchema, GeometryTokensSchema, GuardSchema, IconFamilySchema, IconographySliceSchema, IconographyTokensSchema, IllustrationSliceSchema, IllustrationStyleSchema, IllustrationTokensSchema, InteractionModelSchema, KNOWN_VALIDATION_ERROR_CODES, ListenSourceSchema, McpServiceDefSchema, MotionDurationKeySchema, MotionDurationPaletteSchema, MotionEasingKeySchema, MotionEasingPaletteSchema, MotionIntentMapSchema, MotionIntentSchema, MotionSliceSchema, MotionTokensSchema, NodeClassificationSchema, OrbitalConfigSchema, OrbitalDefinitionSchema, OrbitalEntitySchema, OrbitalPageSchema, OrbitalPageStrictSchema, OrbitalSchemaSchema, OrbitalTraitRefSchema, OrbitalUnitSchema, OrbitalSchema as OrbitalZodSchema, PageRefObjectSchema, PageRefSchema, PageRefStringSchema, PageSchema, PageTraitRefSchema, PatternTypeSchema, PayloadFieldSchema, RelatedLinkSchema, RelationConfigSchema, RequiredFieldSchema, ResolvedAssetSchema, RestAuthConfigSchema, RestServiceDefSchema, SERVICE_TYPES, SExprAtomSchema, SExprSchema, SchemaMetadataSchema, SemanticAssetRefSchema, ServiceDefinitionSchema, ServiceRefObjectSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SkinSpecSchema, SocketEventsSchema, SocketServiceDefSchema, SpacingScaleSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SuggestedGuardSchema, ThemeDefinitionSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TraitCategorySchema, TraitConfigSchema, TraitConfigValueSchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitFieldRefSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, TypeIntentMapSchema, TypeIntentSchema, TypeScaleEntrySchema, TypeScaleSchema, TypeScaleTokensSchema, TypeSizeKeySchema, TypeSliceSchema, TypeSlotSchema, TypeWeightSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, atomic, callService, collectBindings, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, deref, deriveCollection, despawn, doEffects, emit, findService, getAllPatternTypes, getArgs, getBindingExamples, getDefaultAnimationsForRole, getInteractionModelForDomain, getOperator, getServiceNames, getTraitConfig, getTraitName, hasService, inferTsType, isBinding, isCallSiteConfigDeclaration, isCircuitEvent, isEffect, isEntityCall, isEntityReference, isEntityReferenceAny, isImportedTraitRef, isInlineTrait, isJsonArray, isJsonObject, isJsonPrimitive, isKnownValidationErrorCode, isMcpService, isOrbitalDefinition, isPageReference, isPageReferenceObject, isPageReferenceString, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceReference, isServiceReferenceObject, isSingletonEntity, isSocketService, isThemeReference, isTraitFieldRef, isValidBinding, navigate, normalizeTraitRef, notify, parseAssetKey, parseBinding, parseEntityRef, parseImportedTraitRef, parseOrbitalSchema, parsePageRef, parseServiceRef, persist, persistenceModeAllowsOverrides, ref, renderUI, safeParseOrbitalSchema, set, sexpr, spawn, swap, toBindingRoot, validateAssetAnimations, validateBindingInContext, walkSExpr, watch, widenTier };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map