@almadar/core 7.14.1 → 7.14.2

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { k as OrbitalSchema, S as State, O as OrbitalDefinition } from './schema-DEkM0GfA.js';
-export { A as AGENT_DOMAIN_CATEGORIES, o as ALLOWED_CUSTOM_COMPONENTS, p as AgentDomainCategory, q as AgentDomainCategorySchema, r as AgentEffect, s as AllowedCustomComponent, t as AnimationDef, u as AnimationDefInput, v as AnimationDefSchema, w as AssetMap, x as AssetMapInput, y as AssetMapSchema, z as AssetMapping, B as AssetMappingInput, C as AssetMappingSchema, D as AtomicEffect, F as CallServiceConfig, G as CallServiceEffect, H as CheckpointLoadEffect, I as CheckpointSaveEffect, J as ComputedEventContract, K as ComputedEventContractSchema, L as ComputedEventListener, M as ComputedEventListenerSchema, N as ConfigFieldDeclaration, Q as ConfigFieldDeclarationSchema, V as CustomPatternDefinition, W as CustomPatternDefinitionInput, X as CustomPatternDefinitionSchema, Y as CustomPatternMap, Z as CustomPatternMapInput, _ as CustomPatternMapSchema, $ as DeclaredTraitConfig, a0 as DeclaredTraitConfigSchema, a1 as DerefEffect, a2 as DesignPreferences, a3 as DesignPreferencesInput, a4 as DesignPreferencesSchema, a5 as DesignTokens, a6 as DesignTokensInput, a7 as DesignTokensSchema, a8 as DespawnEffect, a9 as DoEffect, aa as DomainCategory, ab as DomainCategorySchema, ac as DomainContext, ad as DomainContextInput, ae as DomainContextSchema, af as DomainVocabulary, ag as DomainVocabularySchema, ah as ENTITY_ROLES, E as Effect, ai as EffectInput, aj as EffectSchema, ak as EmitConfig, al as EmitEffect, b as Entity, am as EntityCall, an as EntityCallSchema, ao as EntityData, e as EntityField, ap as EntityFieldInput, aq as EntityFieldSchema, f as EntityPersistence, ar as EntityPersistenceSchema, i as EntityRef, as as EntityRefSchema, at as EntityRefStringSchema, au as EntityRole, av as EntityRoleSchema, g as EntityRow, aw as EntitySchema, ax as EntitySemanticRole, ay as EntitySemanticRoleSchema, az as EvaluateConfig, aA as EvaluateEffect, aB as Event, aC as EventInput, aD as EventListener, aE as EventListenerSchema, aF as EventPayloadField, aG as EventPayloadFieldSchema, aH as EventSchema, aI as EventScope, aJ as EventScopeSchema, aK as EventSemanticRole, aL as EventSemanticRoleSchema, aM as EventSource, aN as EventSourceSchema, aO as FetchEffect, aP as FetchOptions, aQ as FetchResult, aR as Field, aS as FieldFormat, aT as FieldFormatSchema, aU as FieldSchema, aV as FieldType, aW as FieldTypeSchema, aX as FieldValue, aY as ForwardConfig, aZ as ForwardEffect, a_ as FullOrbitalUnit, a$ as GAME_TYPES, b0 as GameSubCategory, b1 as GameSubCategorySchema, b2 as GameType, b3 as GameTypeSchema, b4 as Guard, b5 as GuardInput, b6 as GuardSchema, b7 as ListenSource, b8 as ListenSourceSchema, b9 as LogEffect, ba as McpServiceDef, bb as McpServiceDefSchema, bc as NavigateEffect, bd as NnConfig, be as NnLayer, bf as NodeClassification, bg as NodeClassificationSchema, bh as NotifyEffect, a_ as Orbital, bi as OrbitalConfig, bj as OrbitalConfigInput, bk as OrbitalConfigSchema, bl as OrbitalDefinitionSchema, bm as OrbitalEntity, bn as OrbitalEntityInput, bo as OrbitalEntitySchema, bp as OrbitalInput, bq as OrbitalPage, br as OrbitalPageInput, bs as OrbitalPageSchema, bt as OrbitalPageStrictInput, bu as OrbitalPageStrictSchema, bv as OrbitalSchemaInput, bw as OrbitalSchemaSchema, bx as OrbitalTraitRef, by as OrbitalTraitRefSchema, bz as OrbitalUnit, bA as OrbitalUnitSchema, bB as OrbitalZodSchema, bC as OsEffect, l as Page, P as PageRef, m as PageRefObject, bD as PageRefObjectSchema, bE as PageRefSchema, bF as PageRefStringSchema, bG as PageSchema, bH as PageTraitRef, bI as PageTraitRefSchema, bJ as PayloadField, bK as PayloadFieldSchema, bL as PersistData, bM as PersistEffect, bN as PersistEmitConfig, bO as PresentationType, bP as RefEffect, bQ as RelatedLink, bR as RelatedLinkSchema, bS as RelationConfig, bT as RelationConfigSchema, bU as RenderItemLambda, bV as RenderUIConfig, R as RenderUIEffect, bW as RenderUINode, bX as RequiredField, bY as RequiredFieldSchema, bZ as ResolvedAsset, b_ as ResolvedAssetInput, b$ as ResolvedAssetSchema, c0 as ResolvedPatternProps, c1 as RestAuthConfig, c2 as RestAuthConfigSchema, c3 as RestServiceDef, c4 as RestServiceDefSchema, c5 as SERVICE_TYPES, c6 as SemanticAssetRef, c7 as SemanticAssetRefInput, c8 as SemanticAssetRefSchema, c9 as ServiceDefinition, ca as ServiceDefinitionSchema, cb as ServiceParams, cc as ServiceParamsValue, cd as ServiceRef, ce as ServiceRefObject, cf as ServiceRefObjectSchema, cg as ServiceRefSchema, ch as ServiceRefStringSchema, ci as ServiceType, cj as ServiceTypeSchema, ck as SetEffect, cl as SocketEvents, cm as SocketEventsSchema, cn as SocketServiceDef, co as SocketServiceDefSchema, cp as SpawnEffect, cq as StateInput, cr as StateMachine, cs as StateMachineInput, ct as StateMachineSchema, cu as StateSchema, cv as StateSemanticRole, cw as StateSemanticRoleSchema, cx as SuggestedGuard, cy as SuggestedGuardSchema, cz as SwapEffect, cA as ThemeDefinition, cB as ThemeDefinitionSchema, cC as ThemeRef, cD as ThemeRefSchema, cE as ThemeRefStringSchema, cF as ThemeTokens, cG as ThemeTokensSchema, cH as ThemeVariant, cI as ThemeVariantSchema, cJ as TrainConfig, cK as TrainEffect, T as Trait, cL as TraitCategory, cM as TraitCategorySchema, d as TraitConfig, cN as TraitConfigObject, cO as TraitConfigSchema, cP as TraitConfigValue, cQ as TraitConfigValueSchema, cR as TraitDataEntity, cS as TraitDataEntitySchema, cT as TraitEntityField, cU as TraitEntityFieldSchema, a as TraitEventContract, cV as TraitEventContractSchema, c as TraitEventListener, cW as TraitEventListenerSchema, cX as TraitInput, j as TraitRef, cY as TraitRefSchema, n as TraitReference, cZ as TraitReferenceInput, c_ as TraitReferenceSchema, c$ as TraitSchema, d0 as TraitTick, d1 as TraitTickSchema, d2 as TraitUIBinding, d3 as Transition, d4 as TransitionInput, d5 as TransitionSchema, d6 as TypedEffect, U as UISlot, d7 as UISlotSchema, d8 as UI_SLOTS, d9 as UXHints, da as UXHintsSchema, h as UseDeclaration, db as UseDeclarationSchema, dc as UserPersona, dd as UserPersonaInput, de as UserPersonaSchema, df as VISUAL_STYLES, dg as ViewType, dh as ViewTypeSchema, di as VisualStyle, dj as VisualStyleSchema, dk as WatchEffect, dl as WatchOptions, dm as atomic, dn as callService, dp as createAssetKey, dq as deref, dr as deriveCollection, ds as despawn, dt as doEffects, du as emit, dv as findService, dw as getDefaultAnimationsForRole, dx as getServiceNames, dy as getTraitConfig, dz as getTraitName, dA as hasService, dB as isCircuitEvent, dC as isEffect, dD as isEntityCall, dE as isEntityReference, dF as isEntityReferenceAny, dG as isImportedTraitRef, dH as isInlineTrait, dI as isMcpService, dJ as isOrbitalDefinition, dK as isPageReference, dL as isPageReferenceObject, dM as isPageReferenceString, dN as isRestService, dO as isRuntimeEntity, dP as isSExprEffect, dQ as isServiceReference, dR as isServiceReferenceObject, dS as isSingletonEntity, dT as isSocketService, dU as isThemeReference, dV as navigate, dW as normalizeTraitRef, dX as notify, dY as parseAssetKey, dZ as parseEntityRef, d_ as parseImportedTraitRef, d$ as parseOrbitalSchema, e0 as parsePageRef, e1 as parseServiceRef, e2 as persist, e3 as ref, e4 as renderUI, e5 as safeParseOrbitalSchema, e6 as set, e7 as spawn, e8 as swap, e9 as validateAssetAnimations, ea as watch } from './schema-DEkM0GfA.js';
+import { k as OrbitalSchema, S as State, O as OrbitalDefinition } from './schema-BAT_cYlE.js';
+export { A as AGENT_DOMAIN_CATEGORIES, o as ALLOWED_CUSTOM_COMPONENTS, p as AgentDomainCategory, q as AgentDomainCategorySchema, r as AgentEffect, s as AllowedCustomComponent, t as AnimationDef, u as AnimationDefInput, v as AnimationDefSchema, w as AssetMap, x as AssetMapInput, y as AssetMapSchema, z as AssetMapping, B as AssetMappingInput, C as AssetMappingSchema, D as AtomicEffect, F as CallServiceConfig, G as CallServiceEffect, H as CheckpointLoadEffect, I as CheckpointSaveEffect, J as ComputedEventContract, K as ComputedEventContractSchema, L as ComputedEventListener, M as ComputedEventListenerSchema, N as ConfigFieldDeclaration, Q as ConfigFieldDeclarationSchema, V as CustomPatternDefinition, W as CustomPatternDefinitionInput, X as CustomPatternDefinitionSchema, Y as CustomPatternMap, Z as CustomPatternMapInput, _ as CustomPatternMapSchema, $ as DeclaredTraitConfig, a0 as DeclaredTraitConfigSchema, a1 as DerefEffect, a2 as DesignPreferences, a3 as DesignPreferencesInput, a4 as DesignPreferencesSchema, a5 as DesignTokens, a6 as DesignTokensInput, a7 as DesignTokensSchema, a8 as DespawnEffect, a9 as DoEffect, aa as DomainCategory, ab as DomainCategorySchema, ac as DomainContext, ad as DomainContextInput, ae as DomainContextSchema, af as DomainVocabulary, ag as DomainVocabularySchema, ah as ENTITY_ROLES, E as Effect, ai as EffectInput, aj as EffectSchema, ak as EmitConfig, al as EmitEffect, b as Entity, am as EntityCall, an as EntityCallSchema, ao as EntityData, e as EntityField, ap as EntityFieldInput, aq as EntityFieldSchema, f as EntityPersistence, ar as EntityPersistenceSchema, i as EntityRef, as as EntityRefSchema, at as EntityRefStringSchema, au as EntityRole, av as EntityRoleSchema, g as EntityRow, aw as EntitySchema, ax as EntitySemanticRole, ay as EntitySemanticRoleSchema, az as EvaluateConfig, aA as EvaluateEffect, aB as Event, aC as EventInput, aD as EventListener, aE as EventListenerSchema, aF as EventPayloadField, aG as EventPayloadFieldSchema, aH as EventSchema, aI as EventScope, aJ as EventScopeSchema, aK as EventSemanticRole, aL as EventSemanticRoleSchema, aM as EventSource, aN as EventSourceSchema, aO as FetchEffect, aP as FetchOptions, aQ as FetchResult, aR as Field, aS as FieldFormat, aT as FieldFormatSchema, aU as FieldSchema, aV as FieldType, aW as FieldTypeSchema, aX as FieldValue, aY as ForwardConfig, aZ as ForwardEffect, a_ as FullOrbitalUnit, a$ as GAME_TYPES, b0 as GameSubCategory, b1 as GameSubCategorySchema, b2 as GameType, b3 as GameTypeSchema, b4 as Guard, b5 as GuardInput, b6 as GuardSchema, b7 as ListenSource, b8 as ListenSourceSchema, b9 as LogEffect, ba as McpServiceDef, bb as McpServiceDefSchema, bc as NavigateEffect, bd as NnConfig, be as NnLayer, bf as NodeClassification, bg as NodeClassificationSchema, bh as NotifyEffect, a_ as Orbital, bi as OrbitalConfig, bj as OrbitalConfigInput, bk as OrbitalConfigSchema, bl as OrbitalDefinitionSchema, bm as OrbitalEntity, bn as OrbitalEntityInput, bo as OrbitalEntitySchema, bp as OrbitalInput, bq as OrbitalPage, br as OrbitalPageInput, bs as OrbitalPageSchema, bt as OrbitalPageStrictInput, bu as OrbitalPageStrictSchema, bv as OrbitalSchemaInput, bw as OrbitalSchemaSchema, bx as OrbitalSchemaWithTraits, by as OrbitalTraitRef, bz as OrbitalTraitRefSchema, bA as OrbitalUnit, bB as OrbitalUnitSchema, bC as OrbitalZodSchema, bD as OsEffect, l as Page, P as PageRef, m as PageRefObject, bE as PageRefObjectSchema, bF as PageRefSchema, bG as PageRefStringSchema, bH as PageSchema, bI as PageTraitRef, bJ as PageTraitRefSchema, bK as PayloadField, bL as PayloadFieldSchema, bM as PersistData, bN as PersistEffect, bO as PersistEmitConfig, bP as PresentationType, bQ as RefEffect, bR as RelatedLink, bS as RelatedLinkSchema, bT as RelationConfig, bU as RelationConfigSchema, bV as RenderItemLambda, bW as RenderUIConfig, R as RenderUIEffect, bX as RenderUINode, bY as RequiredField, bZ as RequiredFieldSchema, b_ as ResolvedAsset, b$ as ResolvedAssetInput, c0 as ResolvedAssetSchema, c1 as ResolvedPatternProps, c2 as RestAuthConfig, c3 as RestAuthConfigSchema, c4 as RestServiceDef, c5 as RestServiceDefSchema, c6 as SERVICE_TYPES, c7 as SemanticAssetRef, c8 as SemanticAssetRefInput, c9 as SemanticAssetRefSchema, ca as ServiceDefinition, cb as ServiceDefinitionSchema, cc as ServiceParams, cd as ServiceParamsValue, ce as ServiceRef, cf as ServiceRefObject, cg as ServiceRefObjectSchema, ch as ServiceRefSchema, ci as ServiceRefStringSchema, cj as ServiceType, ck as ServiceTypeSchema, cl as SetEffect, cm as SocketEvents, cn as SocketEventsSchema, co as SocketServiceDef, cp as SocketServiceDefSchema, cq as SpawnEffect, cr as StateInput, cs as StateMachine, ct as StateMachineInput, cu as StateMachineSchema, cv as StateSchema, cw as StateSemanticRole, cx as StateSemanticRoleSchema, cy as SuggestedGuard, cz as SuggestedGuardSchema, cA as SwapEffect, cB as ThemeDefinition, cC as ThemeDefinitionSchema, cD as ThemeRef, cE as ThemeRefSchema, cF as ThemeRefStringSchema, cG as ThemeTokens, cH as ThemeTokensSchema, cI as ThemeVariant, cJ as ThemeVariantSchema, cK as TrainConfig, cL as TrainEffect, T as Trait, cM as TraitCategory, cN as TraitCategorySchema, d as TraitConfig, cO as TraitConfigObject, cP as TraitConfigSchema, cQ as TraitConfigValue, cR as TraitConfigValueSchema, cS as TraitDataEntity, cT as TraitDataEntitySchema, cU as TraitEntityField, cV as TraitEntityFieldSchema, a as TraitEventContract, cW as TraitEventContractSchema, c as TraitEventListener, cX as TraitEventListenerSchema, cY as TraitInput, j as TraitRef, cZ as TraitRefSchema, n as TraitReference, c_ as TraitReferenceInput, c$ as TraitReferenceSchema, d0 as TraitSchema, d1 as TraitTick, d2 as TraitTickSchema, d3 as TraitUIBinding, d4 as Transition, d5 as TransitionInput, d6 as TransitionSchema, d7 as TypedEffect, U as UISlot, d8 as UISlotSchema, d9 as UI_SLOTS, da as UXHints, db as UXHintsSchema, h as UseDeclaration, dc as UseDeclarationSchema, dd as UserPersona, de as UserPersonaInput, df as UserPersonaSchema, dg as VISUAL_STYLES, dh as ViewType, di as ViewTypeSchema, dj as VisualStyle, dk as VisualStyleSchema, dl as WatchEffect, dm as WatchOptions, dn as atomic, dp as callService, dq as createAssetKey, dr as deref, ds as deriveCollection, dt as despawn, du as doEffects, dv as emit, dw as findService, dx as getDefaultAnimationsForRole, dy as getServiceNames, dz as getTraitConfig, dA as getTraitName, dB as hasService, dC as isCircuitEvent, dD as isEffect, dE as isEntityCall, dF as isEntityReference, dG as isEntityReferenceAny, dH as isImportedTraitRef, dI as isInlineTrait, dJ as isMcpService, dK as isOrbitalDefinition, dL as isPageReference, dM as isPageReferenceObject, dN as isPageReferenceString, dO as isRestService, dP as isRuntimeEntity, dQ as isSExprEffect, dR as isServiceReference, dS as isServiceReferenceObject, dT as isSingletonEntity, dU as isSocketService, dV as isThemeReference, dW as navigate, dX as normalizeTraitRef, dY as notify, dZ as parseAssetKey, d_ as parseEntityRef, d$ as parseImportedTraitRef, e0 as parseOrbitalSchema, e1 as parsePageRef, e2 as parseServiceRef, e3 as persist, e4 as ref, e5 as renderUI, e6 as safeParseOrbitalSchema, e7 as set, e8 as spawn, e9 as swap, ea as validateAssetAnimations, eb as watch } from './schema-BAT_cYlE.js';
 export { C as CORE_BINDINGS, a as CoreBinding, E as EvalContext, b as EventPayload, c as EventPayloadValue, d as Expression, e as ExpressionInput, f as ExpressionSchema, L as LogMeta, P as ParsedBinding, S as SExpr, 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-CkBbMSmB.js';
-import { ResolvedIR, ResolvedEntity, ResolvedPage, ResolvedTrait, SchemaChange, CategorizedRemovals, PageContentReduction, SemanticSchemaChange } from './types/index.js';
+import { ResolvedIR, ResolvedEntity, ResolvedPage, ResolvedTrait, ChangesetValue, SchemaChange, CategorizedRemovals, PageContentReduction, SemanticSchemaChange } from './types/index.js';
 export { AgentCodeSearchResult, AgentCompactResult, AgentCompactStrategy, AgentContext, AgentGenerateOptions, AgentMemoryCategory, AgentMemoryRecord, AppSummary, AssetLoadStatus, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingContext, BindingRoot, BindingSchema, BridgeHealth, BusEvent, BusEventListener, BusEventSource, ChangeAuthor, ChangeSetDocument, ChangeSummary, CheckStatus, ContextExtensions, CreateFlow, DEFAULT_INTERACTION_MODELS, DeleteFlow, EditFlow, EffectTrace, EventEmit, EventKey, EventListen, EventLogEntry, GitHubLink, HistoryMeta, InteractionModel, InteractionModelInput, InteractionModelSchema, LazyService, ListInteraction, OrbitalVerificationAPI, PatternTypeSchema, PersistActionName, ResolvedEntityBinding, ResolvedField, ResolvedNavigation, ResolvedPattern, ResolvedSection, ResolvedSectionEvent, ResolvedTraitBinding, ResolvedTraitDataEntity, ResolvedTraitEvent, ResolvedTraitGuard, ResolvedTraitListener, ResolvedTraitState, ResolvedTraitTick, ResolvedTraitTransition, ResolvedTraitUIBinding, SaveOptions, SaveResult, SemanticChangeKind, ServerResponseTrace, ServiceAction, ServiceActionName, ServiceContract, ServiceEvents, SnapshotDocument, StatsView, StoreContract, StoreFilter, StoreFilterOp, TraitFieldRef, TraitFieldRefSchema, TraitStateSnapshot, TransitionFrom, TransitionTrace, Unsubscribe, ValidationDocument, ValidationIssue, ValidationMeta, ValidationResults, VerificationCheck, VerificationSnapshot, VerificationSummary, ViewFlow, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, getAllPatternTypes, getBindingExamples, getInteractionModelForDomain, inferTsType, isResolvedIR, isTraitFieldRef, toBindingRoot, validateBindingInContext } from './types/index.js';
 export { ASTNode, ComparisonCondition, ComparisonOperator, DomainBehavior, DomainChunk, DomainDocument, DomainEffect, DomainEntity, DomainField, DomainFieldType, DomainGuard, DomainPage, DomainPageAction, DomainPageSection, DomainRelationship, DomainTick, DomainToSchemaResult, DomainTransition, EFFECT_REGISTRY, EffectMapping, EffectType, FIELD_TYPE_REGISTRY, FieldCheckCondition, FieldReference, FieldTypeMapping, GUARD_REGISTRY, GuardCondition, GuardMapping, KEYWORDS, Lexer, LogicalCondition, LogicalOperator, MULTI_WORD_KEYWORDS, MappingStore, MergeResult, ParseError, ParseResult, RelationshipType, SchemaToDomainResult, SectionMapping, SourceLocation, SourceRange, Token, TokenType, UserCheckCondition, applySectionUpdate, computeSchemaHash, convertDomainToSchema, convertEntitiesToDomain, convertPagesToDomain, convertSchemaToDomain, convertTraitsToDomain, createMappingStore, deleteSection, detectChanges, domainKeywordToSchemaType, findMapping, findMappingByPath, findMappingsByType, formatBehaviorToDomain, formatBehaviorToSchema, formatDomainGuardToSchema, formatEntityToDomain, formatEntityToSchema, formatGuardConditionToDomain, formatGuardToDomain, formatGuardToSchema, formatMergeSummary, formatPageToDomain, formatPageToSchema, formatSchemaEntityToDomain, formatSchemaGuardToDomain, formatSchemaPageToDomain, formatSchemaTraitToDomain, generateDomainLanguageReference, generateSectionId, getEffectMapping, getFieldTypeMapping, getGuardMapping, getRegisteredEffects, getRegisteredFieldTypes, getRegisteredGuards, getRegistryStats, getSchemaPath, hasSchemaChanged, isEffectRegistered, isFieldTypeRegistered, isGuardRegistered, mergeDomainChunks, parseBehavior, parseDomainEffect, parseDomainEffects, parseDomainGuard, parseEntity, parseGuard, parsePage, parseSectionId, removeMapping, resolveConflict, schemaEntityToDomainEntity, schemaPageToDomainPage, schemaTraitToDomainBehavior, schemaTypeToDomainKeyword, tokenize, updateMappingRange, updateSchemaHash, upsertMapping, validateDomainChunk } from './domain-language/index.js';
-export { C as ComposeBehaviorsInput, a as ComposeBehaviorsResult, E as EventWiringEntry, L as LayoutStrategy, b as applyEventWiring, c as composeBehaviors, d as detectLayoutStrategy } from './compose-behaviors-BJTsmdSN.js';
+export { C as ComposeBehaviorsInput, a as ComposeBehaviorsResult, E as EventWiringEntry, L as LayoutStrategy, b as applyEventWiring, c as composeBehaviors, d as detectLayoutStrategy } from './compose-behaviors-7NS0qVIh.js';
 export { PATTERN_TYPES, PatternConfig, PatternType, isValidPatternType } from '@almadar/patterns';
 export { BFSNode, BFSPathNode, EdgeWalkTransition, GraphTransition, GuardPayload, ReplayStep, ReplayTransition, StateEdge, WalkStep, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, collectReachableStates, extractPayloadFieldRef, walkStatePairs } from './state-machine/index.js';
 import 'zod';
@@ -146,6 +146,70 @@ declare function hasSignificantPageReduction(reductions: PageContentReduction[])
  * for canvas focus derivation, CLI narration, and selective re-verification.
  */
 declare function diffSchemaSemantics(before: OrbitalSchema, after: OrbitalSchema): SemanticSchemaChange[];
+/**
+ * Source label for a changeset. The persistence layer accepts the canonical
+ * agent labels plus `skill-agent:<skill>`-style identifiers, so the type stays
+ * open as a string.
+ */
+type SchemaDiffSource = 'requirements-agent' | 'builder-agent' | 'user' | 'auto-fix' | (string & {});
+/** Tracking granularity used when generating the diff. */
+type SchemaDiffMode = 'initial' | 'update';
+/** Author identification carried on the changeset envelope. */
+interface SchemaDiffAuthor {
+    userId: string;
+    name?: string;
+}
+/** Options that shape the resulting diff envelope. */
+interface SchemaDiffOptions {
+    mode: SchemaDiffMode;
+    author: SchemaDiffAuthor;
+    source: SchemaDiffSource;
+}
+/** Per-change entry in the diff envelope. */
+interface SchemaDiffChange {
+    operation: 'add' | 'modify' | 'remove' | 'rename' | 'merge' | 'set';
+    path: string;
+    value?: ChangesetValue;
+    previousValue?: ChangesetValue;
+}
+/** Aggregate orbital/trait deltas surfaced by the diff. */
+interface SchemaDiffSummary {
+    orbitalsAdded: string[];
+    orbitalsRemoved: string[];
+    orbitalsModified: string[];
+    traitsAdded: string[];
+    traitsModified: string[];
+    traitsRemoved: string[];
+}
+/** Changeset envelope produced by `diffOrbitalSchemas`. */
+interface SchemaDiffChangeset {
+    id: string;
+    source: SchemaDiffSource;
+    author: SchemaDiffAuthor;
+    description: string;
+    changes: SchemaDiffChange[];
+}
+/** Result of comparing two OrbitalSchema versions. */
+interface SchemaDiff {
+    hasChanges: boolean;
+    changeCount: number;
+    changeset: SchemaDiffChangeset;
+    summary: SchemaDiffSummary;
+}
+/**
+ * Compare two `OrbitalSchema` versions and produce a changeset envelope.
+ *
+ * Higher-level companion to `diffSchemas`: where `diffSchemas` returns a flat
+ * list of `SchemaChange` entries keyed by structural path, this returns the
+ * envelope the persistence layer ships to Firestore (id, author, source,
+ * summary buckets).
+ *
+ * Identifier generation: `changeset.id` is a deterministic `chg_<hex>` value
+ * derived from the schema name + change count when `globalThis.crypto.randomUUID`
+ * is unavailable; otherwise a UUID is used. Callers that need a stable id
+ * across regenerations should supply one themselves.
+ */
+declare function diffOrbitalSchemas(before: OrbitalSchema | null, after: OrbitalSchema, options: SchemaDiffOptions): SchemaDiff;
 
 /**
  * Orbital Summarization
@@ -188,4 +252,4 @@ declare function summarizeOrbital(orbital: OrbitalDefinition): OrbitalDefinition
  */
 declare function summarizeSchema(schema: OrbitalSchema): OrbitalSchema;
 
-export { OrbitalSchema as AppSchema, CategorizedRemovals, OrbitalDefinition, OrbitalSchema, PageContentReduction, ResolvedEntity, ResolvedIR, ResolvedPage, ResolvedTrait, SchemaChange, SemanticSchemaChange, State, categorizeRemovals, classifyWorkflow, clearSchemaCache, detectPageContentReduction, diffSchemaSemantics, diffSchemas, getEntity, getPage, getPages, getRemovals, getSchemaCacheStats, getTrait, hasSignificantPageReduction, isDestructiveChange, requiresConfirmation, schemaToIR, summarizeOrbital, summarizeSchema };
+export { OrbitalSchema as AppSchema, CategorizedRemovals, ChangesetValue, OrbitalDefinition, OrbitalSchema, PageContentReduction, ResolvedEntity, ResolvedIR, ResolvedPage, ResolvedTrait, SchemaChange, type SchemaDiff, type SchemaDiffAuthor, type SchemaDiffChange, type SchemaDiffChangeset, type SchemaDiffMode, type SchemaDiffOptions, type SchemaDiffSource, type SchemaDiffSummary, SemanticSchemaChange, State, categorizeRemovals, classifyWorkflow, clearSchemaCache, detectPageContentReduction, diffOrbitalSchemas, diffSchemaSemantics, diffSchemas, getEntity, getPage, getPages, getRemovals, getSchemaCacheStats, getTrait, hasSignificantPageReduction, isDestructiveChange, requiresConfirmation, schemaToIR, summarizeOrbital, summarizeSchema };

package/dist/index.js

@@ -1173,6 +1173,7 @@ var OrbitalConfigSchema = z.object({
 var OrbitalSchemaSchema = z.object({
   name: z.string().min(1, "Schema name is required"),
   description: z.string().optional(),
+  summary: z.string().optional(),
   version: z.string().optional(),
   domainContext: DomainContextSchema.optional(),
   design: DesignPreferencesSchema.optional(),
@@ -1972,6 +1973,140 @@ function diffSchemaSemantics(before, after) {
   }
   return changes;
 }
+function diffOrbitalSchemas(before, after, options) {
+  const summary = {
+    orbitalsAdded: [],
+    orbitalsRemoved: [],
+    orbitalsModified: [],
+    traitsAdded: [],
+    traitsModified: [],
+    traitsRemoved: []
+  };
+  const changes = [];
+  if (!before) {
+    for (const orbital of after.orbitals ?? []) {
+      const orb = orbital;
+      summary.orbitalsAdded.push(orb.name);
+      changes.push({
+        operation: "add",
+        path: `orbitals[${summary.orbitalsAdded.length - 1}]`,
+        value: orb
+      });
+    }
+  } else {
+    const beforeOrbitals = /* @__PURE__ */ new Map();
+    for (const o of before.orbitals ?? []) {
+      const orb = o;
+      beforeOrbitals.set(orb.name, orb);
+    }
+    const afterOrbitals = /* @__PURE__ */ new Map();
+    for (const o of after.orbitals ?? []) {
+      const orb = o;
+      afterOrbitals.set(orb.name, orb);
+    }
+    let idx = 0;
+    for (const [name, orb] of afterOrbitals) {
+      const prev = beforeOrbitals.get(name);
+      if (!prev) {
+        summary.orbitalsAdded.push(name);
+        changes.push({
+          operation: "add",
+          path: `orbitals[${idx}]`,
+          value: orb
+        });
+      } else if (JSON.stringify(prev) !== JSON.stringify(orb)) {
+        summary.orbitalsModified.push(name);
+        changes.push({
+          operation: "merge",
+          path: `orbitals[${idx}]`,
+          previousValue: prev,
+          value: orb
+        });
+      }
+      idx++;
+    }
+    for (const [name, orb] of beforeOrbitals) {
+      if (!afterOrbitals.has(name)) {
+        summary.orbitalsRemoved.push(name);
+        changes.push({
+          operation: "remove",
+          path: `orbitals[${name}]`,
+          previousValue: orb
+        });
+      }
+    }
+    if (before.name !== after.name) {
+      changes.push({
+        operation: "set",
+        path: "name",
+        previousValue: before.name,
+        value: after.name
+      });
+    }
+    if (before.version !== after.version) {
+      changes.push({
+        operation: "set",
+        path: "version",
+        previousValue: before.version,
+        value: after.version
+      });
+    }
+    if (before.description !== after.description) {
+      changes.push({
+        operation: "set",
+        path: "description",
+        previousValue: before.description,
+        value: after.description
+      });
+    }
+    if (before.summary !== after.summary) {
+      changes.push({
+        operation: "set",
+        path: "summary",
+        previousValue: before.summary,
+        value: after.summary
+      });
+    }
+  }
+  const hasChanges = changes.length > 0;
+  const description = describeDiff(summary, options.mode, after.name);
+  return {
+    hasChanges,
+    changeCount: changes.length,
+    changeset: {
+      id: generateChangesetId(after.name, changes.length),
+      source: options.source,
+      author: options.author,
+      description,
+      changes
+    },
+    summary
+  };
+}
+function describeDiff(summary, mode, schemaName) {
+  const parts = [];
+  if (summary.orbitalsAdded.length > 0) {
+    parts.push(`+${summary.orbitalsAdded.length} orbital(s)`);
+  }
+  if (summary.orbitalsModified.length > 0) {
+    parts.push(`~${summary.orbitalsModified.length} orbital(s)`);
+  }
+  if (summary.orbitalsRemoved.length > 0) {
+    parts.push(`-${summary.orbitalsRemoved.length} orbital(s)`);
+  }
+  if (parts.length === 0) return "No changes";
+  return `${mode === "initial" ? "Initial" : "Update"} ${schemaName}: ${parts.join(", ")}`;
+}
+function generateChangesetId(seed, count) {
+  const cryptoApi = globalThis.crypto;
+  if (cryptoApi?.randomUUID) return cryptoApi.randomUUID();
+  let hash = 0;
+  const source = `${seed}:${count}:${Date.now()}`;
+  for (let i = 0; i < source.length; i++) {
+    hash = hash * 31 + source.charCodeAt(i) | 0;
+  }
+  return `chg_${(hash >>> 0).toString(16)}_${count}`;
+}
 
 // src/summarize.ts
 var CRUD_STATES = /* @__PURE__ */ new Set(["browsing", "creating", "editing", "viewing", "deleting"]);
@@ -8663,6 +8798,6 @@ function buildPayloadForEdge(transition, guardCase) {
   return {};
 }
 
-export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, AgentDomainCategorySchema, AnimationDefSchema, AssetMapSchema, AssetMappingSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingSchema, CORE_BINDINGS, ComputedEventContractSchema, ComputedEventListenerSchema, ConfigFieldDeclarationSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DeclaredTraitConfigSchema, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, EFFECT_REGISTRY, ENTITY_ROLES, EffectSchema, EntityCallSchema, EntityFieldSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FIELD_TYPE_REGISTRY, FieldFormatSchema, FieldSchema, FieldTypeSchema, GAME_TYPES, GUARD_REGISTRY, GameSubCategorySchema, GameTypeSchema, GuardSchema, InteractionModelSchema, KEYWORDS, Lexer, ListenSourceSchema, MULTI_WORD_KEYWORDS, McpServiceDefSchema, 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, SemanticAssetRefSchema, ServiceDefinitionSchema, ServiceRefObjectSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SocketEventsSchema, SocketServiceDefSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SuggestedGuardSchema, ThemeDefinitionSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TokenType, TraitCategorySchema, TraitConfigSchema, TraitConfigValueSchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitFieldRefSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, applyEventWiring, applySectionUpdate, atomic, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, callService, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectBindings, collectReachableStates, composeBehaviors, computeSchemaHash, convertDomainToSchema, convertEntitiesToDomain, convertPagesToDomain, convertSchemaToDomain, convertTraitsToDomain, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createMappingStore, createResolvedField, createTypedEventBus, deleteSection, deref, deriveCollection, despawn, detectChanges, detectLayoutStrategy, detectPageContentReduction, diffSchemaSemantics, diffSchemas, doEffects, domainKeywordToSchemaType, emit, extractPayloadFieldRef, findMapping, findMappingByPath, findMappingsByType, findService, formatBehaviorToDomain, formatBehaviorToSchema, formatDomainGuardToSchema, formatEntityToDomain, formatEntityToSchema, formatGuardConditionToDomain, formatGuardToDomain, formatGuardToSchema, formatMergeSummary, formatPageToDomain, formatPageToSchema, formatSchemaEntityToDomain, formatSchemaGuardToDomain, formatSchemaPageToDomain, formatSchemaTraitToDomain, generateDomainLanguageReference, generateSectionId, getAllPatternTypes, getArgs, getBindingExamples, getDefaultAnimationsForRole, getEffectMapping, getEntity, getFieldTypeMapping, getGuardMapping, getInteractionModelForDomain, getOperator, getPage, getPages, getRegisteredEffects, getRegisteredFieldTypes, getRegisteredGuards, getRegistryStats, getRemovals, getSchemaCacheStats, getSchemaPath, getServiceNames, getTrait, getTraitConfig, getTraitName, hasSchemaChanged, hasService, hasSignificantPageReduction, inferTsType, isBinding, isCircuitEvent, isDestructiveChange, isEffect, isEffectRegistered, isEntityCall, isEntityReference, isEntityReferenceAny, isFieldTypeRegistered, isGuardRegistered, isImportedTraitRef, isInlineTrait, isMcpService, isOrbitalDefinition, isPageReference, isPageReferenceObject, isPageReferenceString, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceReference, isServiceReferenceObject, isSingletonEntity, isSocketService, isThemeReference, isTraitFieldRef, isValidBinding, mergeDomainChunks, navigate, normalizeTraitRef, notify, parseAssetKey, parseBehavior, parseBinding, parseDomainEffect, parseDomainEffects, parseDomainGuard, parseEntity, parseEntityRef, parseGuard, parseImportedTraitRef, parseOrbitalSchema, parsePage, parsePageRef, parseSectionId, parseServiceRef, persist, ref, removeMapping, renderUI, requiresConfirmation, resolveConflict, safeParseOrbitalSchema, schemaEntityToDomainEntity, schemaPageToDomainPage, schemaToIR, schemaTraitToDomainBehavior, schemaTypeToDomainKeyword, set, sexpr, spawn, summarizeOrbital, summarizeSchema, swap, toBindingRoot, tokenize, updateMappingRange, updateSchemaHash, upsertMapping, validateAssetAnimations, validateBindingInContext, validateDomainChunk, walkSExpr, walkStatePairs, watch };
+export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, AgentDomainCategorySchema, AnimationDefSchema, AssetMapSchema, AssetMappingSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingSchema, CORE_BINDINGS, ComputedEventContractSchema, ComputedEventListenerSchema, ConfigFieldDeclarationSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DeclaredTraitConfigSchema, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, EFFECT_REGISTRY, ENTITY_ROLES, EffectSchema, EntityCallSchema, EntityFieldSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FIELD_TYPE_REGISTRY, FieldFormatSchema, FieldSchema, FieldTypeSchema, GAME_TYPES, GUARD_REGISTRY, GameSubCategorySchema, GameTypeSchema, GuardSchema, InteractionModelSchema, KEYWORDS, Lexer, ListenSourceSchema, MULTI_WORD_KEYWORDS, McpServiceDefSchema, 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, SemanticAssetRefSchema, ServiceDefinitionSchema, ServiceRefObjectSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SocketEventsSchema, SocketServiceDefSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SuggestedGuardSchema, ThemeDefinitionSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TokenType, TraitCategorySchema, TraitConfigSchema, TraitConfigValueSchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitFieldRefSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, applyEventWiring, applySectionUpdate, atomic, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, callService, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectBindings, collectReachableStates, composeBehaviors, computeSchemaHash, convertDomainToSchema, convertEntitiesToDomain, convertPagesToDomain, convertSchemaToDomain, convertTraitsToDomain, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createMappingStore, createResolvedField, createTypedEventBus, deleteSection, deref, deriveCollection, despawn, detectChanges, detectLayoutStrategy, detectPageContentReduction, diffOrbitalSchemas, diffSchemaSemantics, diffSchemas, doEffects, domainKeywordToSchemaType, emit, extractPayloadFieldRef, findMapping, findMappingByPath, findMappingsByType, findService, formatBehaviorToDomain, formatBehaviorToSchema, formatDomainGuardToSchema, formatEntityToDomain, formatEntityToSchema, formatGuardConditionToDomain, formatGuardToDomain, formatGuardToSchema, formatMergeSummary, formatPageToDomain, formatPageToSchema, formatSchemaEntityToDomain, formatSchemaGuardToDomain, formatSchemaPageToDomain, formatSchemaTraitToDomain, generateDomainLanguageReference, generateSectionId, getAllPatternTypes, getArgs, getBindingExamples, getDefaultAnimationsForRole, getEffectMapping, getEntity, getFieldTypeMapping, getGuardMapping, getInteractionModelForDomain, getOperator, getPage, getPages, getRegisteredEffects, getRegisteredFieldTypes, getRegisteredGuards, getRegistryStats, getRemovals, getSchemaCacheStats, getSchemaPath, getServiceNames, getTrait, getTraitConfig, getTraitName, hasSchemaChanged, hasService, hasSignificantPageReduction, inferTsType, isBinding, isCircuitEvent, isDestructiveChange, isEffect, isEffectRegistered, isEntityCall, isEntityReference, isEntityReferenceAny, isFieldTypeRegistered, isGuardRegistered, isImportedTraitRef, isInlineTrait, isMcpService, isOrbitalDefinition, isPageReference, isPageReferenceObject, isPageReferenceString, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceReference, isServiceReferenceObject, isSingletonEntity, isSocketService, isThemeReference, isTraitFieldRef, isValidBinding, mergeDomainChunks, navigate, normalizeTraitRef, notify, parseAssetKey, parseBehavior, parseBinding, parseDomainEffect, parseDomainEffects, parseDomainGuard, parseEntity, parseEntityRef, parseGuard, parseImportedTraitRef, parseOrbitalSchema, parsePage, parsePageRef, parseSectionId, parseServiceRef, persist, ref, removeMapping, renderUI, requiresConfirmation, resolveConflict, safeParseOrbitalSchema, schemaEntityToDomainEntity, schemaPageToDomainPage, schemaToIR, schemaTraitToDomainBehavior, schemaTypeToDomainKeyword, set, sexpr, spawn, summarizeOrbital, summarizeSchema, swap, toBindingRoot, tokenize, updateMappingRange, updateSchemaHash, upsertMapping, validateAssetAnimations, validateBindingInContext, validateDomainChunk, walkSExpr, walkStatePairs, watch };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map