@almadar/core 8.7.3 → 8.8.0

package/dist/json-lCu3FWzv.d.ts

@@ -0,0 +1,57 @@
+/**
+ * JSON primitives — the universal "data crossed a boundary" type.
+ *
+ * Every value that arrives over the wire from an LLM (tool-call args),
+ * from disk (workspace files), or from an HTTP body before
+ * domain-specific validation is a `JsonValue`. Narrow with a typed
+ * predicate (`is`-guard) at the boundary; don't widen back to `unknown`.
+ *
+ * `JsonObject` and `ToolArgs` are aliases for the common
+ * `Record<string, JsonValue>` shape. `ToolArgs` is the name the
+ * agent surface uses for LLM-emitted tool-call arguments; `JsonObject`
+ * is the general-purpose alias. They are the same type — the alias
+ * exists so call sites read at the right semantic level.
+ *
+ * Why not `Record<string, unknown>`? Two reasons. (1) `unknown` widens
+ * back to anything, which defeats the purpose of typing the boundary.
+ * (2) The `@almadar/eslint-plugin/no-record-string-unknown` rule blocks
+ * the wider form — `JsonValue`-based records are the typed answer.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Recursive JSON value union — every shape JSON can carry.
+ */
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/**
+ * JSON object — keyed string→JsonValue. The wire form of arbitrary
+ * structured data. Replaces `Record<string, unknown>` at typed
+ * boundaries (LLM emits, file reads, HTTP bodies).
+ */
+type JsonObject = {
+    [key: string]: JsonValue;
+};
+/**
+ * LLM tool-call arguments — same shape as `JsonObject`, named for the
+ * agent-surface call site. Each tool's `execute(args: ToolArgs)`
+ * receives this and narrows via an `is`-guard predicate before any
+ * field access.
+ */
+type ToolArgs = JsonObject;
+/**
+ * Type guard: is the given value a JSON primitive (non-array,
+ * non-object)? Used by walkers that decide whether to recurse.
+ */
+declare function isJsonPrimitive(value: JsonValue): value is string | number | boolean | null;
+/**
+ * Type guard: is the given value a JSON object (non-array, non-null)?
+ */
+declare function isJsonObject(value: JsonValue): value is JsonObject;
+/**
+ * Type guard: is the given value a JSON array?
+ */
+declare function isJsonArray(value: JsonValue): value is JsonValue[];
+
+export { type JsonObject as J, type ToolArgs as T, type JsonValue as a, isJsonObject as b, isJsonPrimitive as c, isJsonArray as i };

package/dist/{schema-BQCTssuv.d.ts → schema-pKqQXuGN.d.ts}

@@ -1,5 +1,5 @@
 import { d as Expression, S as SExpr } from './expression-BVRFm0sV.js';
-import { bn as TraitConfig, bo as TraitConfigObject, a_ as ServiceRef, z as Entity, F as EntityField, I as EntityPersistence, bB as TraitRef, T as EventPayloadField, o as ConfigFieldDeclaration, aW as ServiceDefinition, bk as Trait } from './trait-Cvs0OQbV.js';
+import { bn as TraitConfig, bo as TraitConfigObject, a_ as ServiceRef, z as Entity, F as EntityField, I as EntityPersistence, bB as TraitRef, T as EventPayloadField, o as ConfigFieldDeclaration, aW as ServiceDefinition, bk as Trait } from './trait-BVLBQ9uk.js';
 import { z } from 'zod';
 
 /**

package/dist/{trait-Cvs0OQbV.d.ts → trait-BVLBQ9uk.d.ts}

@@ -5770,4 +5770,4 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     } | undefined;
 }>]>;
 
-export { type Field as $, type AgentEffect as A, type EntityData as B, type CallServiceConfig as C, type DeclaredTraitConfig as D, ENTITY_ROLES as E, type EntityField as F, type EntityFieldInput as G, EntityFieldSchema as H, type EntityPersistence as I, EntityPersistenceSchema as J, type EntityRole as K, EntityRoleSchema as L, type EntityRow as M, EntitySchema as N, type EnumEntityField as O, type EvaluateConfig as P, type EvaluateEffect as Q, type Event as R, type EventInput as S, type EventPayloadField as T, EventPayloadFieldSchema as U, EventSchema as V, type EventScope as W, EventScopeSchema as X, type FetchEffect as Y, type FetchOptions as Z, type FetchResult as _, type AnimationDef as a, type ServiceRefObject as a$, type FieldFormat as a0, FieldFormatSchema as a1, FieldSchema as a2, type FieldType as a3, FieldTypeSchema as a4, type FieldValue as a5, type ForwardConfig as a6, type ForwardEffect as a7, GAME_TYPES as a8, type GameType as a9, type RelationConfig as aA, RelationConfigSchema as aB, type RelationEntityField as aC, type RenderItemLambda as aD, type RenderUIConfig as aE, type RenderUIEffect as aF, type RenderUINode as aG, type RequiredField as aH, RequiredFieldSchema as aI, type ResolvedAsset as aJ, type ResolvedAssetInput as aK, ResolvedAssetSchema as aL, type ResolvedPatternProps as aM, type RestAuthConfig as aN, RestAuthConfigSchema as aO, type RestServiceDef as aP, RestServiceDefSchema as aQ, SERVICE_TYPES as aR, type ScalarEntityField as aS, type SemanticAssetRef as aT, type SemanticAssetRefInput as aU, SemanticAssetRefSchema as aV, type ServiceDefinition as aW, ServiceDefinitionSchema as aX, type ServiceParams as aY, type ServiceParamsValue as aZ, type ServiceRef as a_, GameTypeSchema as aa, type Guard as ab, type GuardInput as ac, GuardSchema as ad, type ListenSource as ae, ListenSourceSchema as af, type LogEffect as ag, type McpServiceDef as ah, McpServiceDefSchema as ai, type NavigateEffect as aj, type NnConfig as ak, type NnLayer as al, type NotifyEffect as am, type OrbitalEntity as an, type OrbitalEntityInput as ao, OrbitalEntitySchema as ap, type OrbitalTraitRef as aq, OrbitalTraitRefSchema as ar, type OsEffect as as, type PayloadField as at, PayloadFieldSchema as au, type PersistData as av, type PersistEffect as aw, type PersistEmitConfig as ax, type PresentationType as ay, type RefEffect as az, type AnimationDefInput as b, despawn as b$, ServiceRefObjectSchema as b0, ServiceRefSchema as b1, ServiceRefStringSchema as b2, type ServiceType as b3, ServiceTypeSchema as b4, type SetEffect as b5, type SocketEvents as b6, SocketEventsSchema as b7, type SocketServiceDef as b8, SocketServiceDefSchema as b9, type TraitInput as bA, type TraitRef as bB, TraitRefSchema as bC, type TraitReference as bD, type TraitReferenceInput as bE, TraitReferenceSchema as bF, TraitSchema as bG, type TraitTick as bH, TraitTickSchema as bI, type TraitUIBinding as bJ, type Transition as bK, type TransitionInput as bL, TransitionSchema as bM, type TypedEffect as bN, type UISlot as bO, UISlotSchema as bP, UI_SLOTS as bQ, VISUAL_STYLES as bR, type VisualStyle as bS, VisualStyleSchema as bT, type WatchEffect as bU, type WatchOptions as bV, atomic as bW, callService as bX, createAssetKey as bY, deref as bZ, deriveCollection as b_, type SpawnEffect as ba, type State as bb, type StateInput as bc, type StateMachine as bd, type StateMachineInput as be, StateMachineSchema as bf, StateSchema as bg, type SwapEffect as bh, type TrainConfig as bi, type TrainEffect as bj, type Trait as bk, type TraitCategory as bl, TraitCategorySchema as bm, type TraitConfig as bn, type TraitConfigObject as bo, TraitConfigSchema as bp, type TraitConfigValue as bq, TraitConfigValueSchema as br, type TraitDataEntity as bs, TraitDataEntitySchema as bt, type TraitEntityField as bu, TraitEntityFieldSchema as bv, type TraitEventContract as bw, TraitEventContractSchema as bx, type TraitEventListener as by, TraitEventListenerSchema as bz, AnimationDefSchema as c, doEffects as c0, emit as c1, findService as c2, getDefaultAnimationsForRole as c3, getServiceNames as c4, getTraitConfig as c5, getTraitName as c6, hasService as c7, isCircuitEvent as c8, isEffect as c9, isInlineTrait as ca, isMcpService as cb, isRestService as cc, isRuntimeEntity as cd, isSExprEffect as ce, isServiceReference as cf, isServiceReferenceObject as cg, isSingletonEntity as ch, isSocketService as ci, navigate as cj, normalizeTraitRef as ck, notify as cl, parseAssetKey as cm, parseServiceRef as cn, persist as co, ref as cp, renderUI as cq, set as cr, spawn as cs, swap as ct, validateAssetAnimations as cu, watch as cv, type ArrayEntityField as d, type AssetMap as e, type AssetMapInput as f, AssetMapSchema as g, type AssetMapping as h, type AssetMappingInput as i, AssetMappingSchema as j, type AtomicEffect as k, type CallServiceEffect as l, type CheckpointLoadEffect as m, type CheckpointSaveEffect as n, type ConfigFieldDeclaration as o, ConfigFieldDeclarationSchema as p, DeclaredTraitConfigSchema as q, type DerefEffect as r, type DespawnEffect as s, type DoEffect as t, type Effect as u, type EffectInput as v, EffectSchema as w, type EmitConfig as x, type EmitEffect as y, type Entity as z };
+export { type Field as $, type AgentEffect as A, type EntityData as B, type CallServiceConfig as C, type DeclaredTraitConfig as D, ENTITY_ROLES as E, type EntityField as F, type EntityFieldInput as G, EntityFieldSchema as H, type EntityPersistence as I, EntityPersistenceSchema as J, type EntityRole as K, EntityRoleSchema as L, type EntityRow as M, EntitySchema as N, type EnumEntityField as O, type EvaluateConfig as P, type EvaluateEffect as Q, type Event as R, type EventInput as S, type EventPayloadField as T, EventPayloadFieldSchema as U, EventSchema as V, type EventScope as W, EventScopeSchema as X, type FetchEffect as Y, type FetchOptions as Z, type FetchResult as _, type AnimationDef as a, type ServiceRefObject as a$, type FieldFormat as a0, FieldFormatSchema as a1, FieldSchema as a2, type FieldType as a3, FieldTypeSchema as a4, type FieldValue as a5, type ForwardConfig as a6, type ForwardEffect as a7, GAME_TYPES as a8, type GameType as a9, type RelationConfig as aA, RelationConfigSchema as aB, type RelationEntityField as aC, type RenderItemLambda as aD, type RenderUIConfig as aE, type RenderUIEffect as aF, type RenderUINode as aG, type RequiredField as aH, RequiredFieldSchema as aI, type ResolvedAsset as aJ, type ResolvedAssetInput as aK, ResolvedAssetSchema as aL, type ResolvedPatternProps as aM, type RestAuthConfig as aN, RestAuthConfigSchema as aO, type RestServiceDef as aP, RestServiceDefSchema as aQ, SERVICE_TYPES as aR, type ScalarEntityField as aS, type SemanticAssetRef as aT, type SemanticAssetRefInput as aU, SemanticAssetRefSchema as aV, type ServiceDefinition as aW, ServiceDefinitionSchema as aX, type ServiceParams as aY, type ServiceParamsValue as aZ, type ServiceRef as a_, GameTypeSchema as aa, type Guard as ab, type GuardInput as ac, GuardSchema as ad, type ListenSource as ae, ListenSourceSchema as af, type LogEffect as ag, type McpServiceDef as ah, McpServiceDefSchema as ai, type NavigateEffect as aj, type NnConfig as ak, type NnLayer as al, type NotifyEffect as am, type OrbitalEntity as an, type OrbitalEntityInput as ao, OrbitalEntitySchema as ap, type OrbitalTraitRef as aq, OrbitalTraitRefSchema as ar, type OsEffect as as, type PayloadField as at, PayloadFieldSchema as au, type PersistData as av, type PersistEffect as aw, type PersistEmitConfig as ax, type PresentationType as ay, type RefEffect as az, type AnimationDefInput as b, deriveCollection as b$, ServiceRefObjectSchema as b0, ServiceRefSchema as b1, ServiceRefStringSchema as b2, type ServiceType as b3, ServiceTypeSchema as b4, type SetEffect as b5, type SocketEvents as b6, SocketEventsSchema as b7, type SocketServiceDef as b8, SocketServiceDefSchema as b9, type TraitInput as bA, type TraitRef as bB, TraitRefSchema as bC, type TraitReference as bD, type TraitReferenceInput as bE, TraitReferenceSchema as bF, TraitSchema as bG, type TraitScope as bH, type TraitTick as bI, TraitTickSchema as bJ, type TraitUIBinding as bK, type Transition as bL, type TransitionInput as bM, TransitionSchema as bN, type TypedEffect as bO, type UISlot as bP, UISlotSchema as bQ, UI_SLOTS as bR, VISUAL_STYLES as bS, type VisualStyle as bT, VisualStyleSchema as bU, type WatchEffect as bV, type WatchOptions as bW, atomic as bX, callService as bY, createAssetKey as bZ, deref as b_, type SpawnEffect as ba, type State as bb, type StateInput as bc, type StateMachine as bd, type StateMachineInput as be, StateMachineSchema as bf, StateSchema as bg, type SwapEffect as bh, type TrainConfig as bi, type TrainEffect as bj, type Trait as bk, type TraitCategory as bl, TraitCategorySchema as bm, type TraitConfig as bn, type TraitConfigObject as bo, TraitConfigSchema as bp, type TraitConfigValue as bq, TraitConfigValueSchema as br, type TraitDataEntity as bs, TraitDataEntitySchema as bt, type TraitEntityField as bu, TraitEntityFieldSchema as bv, type TraitEventContract as bw, TraitEventContractSchema as bx, type TraitEventListener as by, TraitEventListenerSchema as bz, AnimationDefSchema as c, despawn as c0, doEffects as c1, emit as c2, findService as c3, getDefaultAnimationsForRole as c4, getServiceNames as c5, getTraitConfig as c6, getTraitName as c7, hasService as c8, isCircuitEvent as c9, isEffect as ca, isInlineTrait as cb, isMcpService as cc, isRestService as cd, isRuntimeEntity as ce, isSExprEffect as cf, isServiceReference as cg, isServiceReferenceObject as ch, isSingletonEntity as ci, isSocketService as cj, navigate as ck, normalizeTraitRef as cl, notify as cm, parseAssetKey as cn, parseServiceRef as co, persist as cp, ref as cq, renderUI as cr, set as cs, spawn as ct, swap as cu, validateAssetAnimations as cv, watch as cw, type ArrayEntityField as d, type AssetMap as e, type AssetMapInput as f, AssetMapSchema as g, type AssetMapping as h, type AssetMappingInput as i, AssetMappingSchema as j, type AtomicEffect as k, type CallServiceEffect as l, type CheckpointLoadEffect as m, type CheckpointSaveEffect as n, type ConfigFieldDeclaration as o, ConfigFieldDeclarationSchema as p, DeclaredTraitConfigSchema as q, type DerefEffect as r, type DespawnEffect as s, type DoEffect as t, type Effect as u, type EffectInput as v, EffectSchema as w, type EmitConfig as x, type EmitEffect as y, type Entity as z };

package/dist/types/index.d.ts

@@ -1,12 +1,13 @@
-import { a3 as OrbitalSchema, T as Orbital, aa as Page, u as DomainContext } from '../schema-BQCTssuv.js';
-export { A as AGENT_DOMAIN_CATEGORIES, a as ALLOWED_CUSTOM_COMPONENTS, b as AgentDomainCategory, c as AgentDomainCategorySchema, d as AllowedCustomComponent, C as ComputedEventContract, e as ComputedEventContractSchema, f as ComputedEventListener, g as ComputedEventListenerSchema, h as CustomPatternDefinition, i as CustomPatternDefinitionInput, j as CustomPatternDefinitionSchema, k as CustomPatternMap, l as CustomPatternMapInput, m as CustomPatternMapSchema, D as DesignPreferences, n as DesignPreferencesInput, o as DesignPreferencesSchema, p as DesignTokens, q as DesignTokensInput, r as DesignTokensSchema, s as DomainCategory, t as DomainCategorySchema, v as DomainContextInput, w as DomainContextSchema, x as DomainVocabulary, y as DomainVocabularySchema, E as EntityCall, z as EntityCallSchema, B as EntityRef, F as EntityRefSchema, G as EntityRefStringSchema, H as EntitySemanticRole, I as EntitySemanticRoleSchema, J as EventListener, K as EventListenerSchema, L as EventSemanticRole, M as EventSemanticRoleSchema, N as EventSource, O as EventSourceSchema, P as GameSubCategory, Q as GameSubCategorySchema, R as NodeClassification, S as NodeClassificationSchema, U as OrbitalConfig, V as OrbitalConfigInput, W as OrbitalConfigSchema, X as OrbitalDefinition, Y as OrbitalDefinitionSchema, Z as OrbitalInput, _ as OrbitalPage, $ as OrbitalPageInput, a0 as OrbitalPageSchema, a1 as OrbitalPageStrictInput, a2 as OrbitalPageStrictSchema, a5 as OrbitalSchemaInput, a6 as OrbitalSchemaSchema, a7 as OrbitalSchemaWithTraits, a8 as OrbitalUnit, a9 as OrbitalUnitSchema, a4 as OrbitalZodSchema, ab as PageRef, ac as PageRefObject, ad as PageRefObjectSchema, ae as PageRefSchema, af as PageRefStringSchema, ag as PageSchema, ah as PageTraitRef, ai as PageTraitRefSchema, aj as RelatedLink, ak as RelatedLinkSchema, al as StateSemanticRole, am as StateSemanticRoleSchema, an as SuggestedGuard, ao as SuggestedGuardSchema, ap as ThemeDefinition, aq as ThemeDefinitionSchema, ar as ThemeRef, as as ThemeRefSchema, at as ThemeRefStringSchema, au as ThemeTokens, av as ThemeTokensSchema, aw as ThemeVariant, ax as ThemeVariantSchema, ay as UXHints, az as UXHintsSchema, aA as UseDeclaration, aB as UseDeclarationSchema, aC as UserPersona, aD as UserPersonaInput, aE as UserPersonaSchema, aF as ViewType, aG as ViewTypeSchema, aH as isEntityCall, aI as isEntityReference, aJ as isEntityReferenceAny, aK as isImportedTraitRef, aL as isOrbitalDefinition, aM as isPageReference, aN as isPageReferenceObject, aO as isPageReferenceString, aP as isThemeReference, aQ as parseEntityRef, aR as parseImportedTraitRef, aS as parseOrbitalSchema, aT as parsePageRef, aU as safeParseOrbitalSchema } from '../schema-BQCTssuv.js';
-import { aY as ServiceParams, bk as Trait, z as Entity, M as EntityRow, a5 as FieldValue, D as DeclaredTraitConfig, bn as TraitConfig } from '../trait-Cvs0OQbV.js';
-export { A as AgentEffect, a as AnimationDef, b as AnimationDefInput, c as AnimationDefSchema, d as ArrayEntityField, e as AssetMap, f as AssetMapInput, g as AssetMapSchema, h as AssetMapping, i as AssetMappingInput, j as AssetMappingSchema, k as AtomicEffect, C as CallServiceConfig, l as CallServiceEffect, m as CheckpointLoadEffect, n as CheckpointSaveEffect, o as ConfigFieldDeclaration, p as ConfigFieldDeclarationSchema, q as DeclaredTraitConfigSchema, r as DerefEffect, s as DespawnEffect, t as DoEffect, E as ENTITY_ROLES, u as Effect, v as EffectInput, w as EffectSchema, x as EmitConfig, y as EmitEffect, B as EntityData, F as EntityField, G as EntityFieldInput, H as EntityFieldSchema, I as EntityPersistence, J as EntityPersistenceSchema, K as EntityRole, L as EntityRoleSchema, N as EntitySchema, O as EnumEntityField, P as EvaluateConfig, Q as EvaluateEffect, R as Event, S as EventInput, T as EventPayloadField, U as EventPayloadFieldSchema, V as EventSchema, W as EventScope, X as EventScopeSchema, Y as FetchEffect, Z as FetchOptions, _ as FetchResult, $ as Field, a0 as FieldFormat, a1 as FieldFormatSchema, a2 as FieldSchema, a3 as FieldType, a4 as FieldTypeSchema, a6 as ForwardConfig, a7 as ForwardEffect, a8 as GAME_TYPES, a9 as GameType, aa as GameTypeSchema, ab as Guard, ac as GuardInput, ad as GuardSchema, ae as ListenSource, af as ListenSourceSchema, ag as LogEffect, ah as McpServiceDef, ai as McpServiceDefSchema, aj as NavigateEffect, ak as NnConfig, al as NnLayer, am as NotifyEffect, an as OrbitalEntity, ao as OrbitalEntityInput, ap as OrbitalEntitySchema, aq as OrbitalTraitRef, ar as OrbitalTraitRefSchema, as as OsEffect, at as PayloadField, au as PayloadFieldSchema, av as PersistData, aw as PersistEffect, ax as PersistEmitConfig, ay as PresentationType, az as RefEffect, aA as RelationConfig, aB as RelationConfigSchema, aC as RelationEntityField, aD as RenderItemLambda, aE as RenderUIConfig, aF as RenderUIEffect, aG as RenderUINode, aH as RequiredField, aI as RequiredFieldSchema, aJ as ResolvedAsset, aK as ResolvedAssetInput, aL as ResolvedAssetSchema, aM as ResolvedPatternProps, aN as RestAuthConfig, aO as RestAuthConfigSchema, aP as RestServiceDef, aQ as RestServiceDefSchema, aR as SERVICE_TYPES, aS as ScalarEntityField, aT as SemanticAssetRef, aU as SemanticAssetRefInput, aV as SemanticAssetRefSchema, aW as ServiceDefinition, aX as ServiceDefinitionSchema, aZ as ServiceParamsValue, a_ as ServiceRef, a$ as ServiceRefObject, b0 as ServiceRefObjectSchema, b1 as ServiceRefSchema, b2 as ServiceRefStringSchema, b3 as ServiceType, b4 as ServiceTypeSchema, b5 as SetEffect, b6 as SocketEvents, b7 as SocketEventsSchema, b8 as SocketServiceDef, b9 as SocketServiceDefSchema, ba as SpawnEffect, bb as State, bc as StateInput, bd as StateMachine, be as StateMachineInput, bf as StateMachineSchema, bg as StateSchema, bh as SwapEffect, bi as TrainConfig, bj as TrainEffect, bl as TraitCategory, bm as TraitCategorySchema, bo as TraitConfigObject, bp as TraitConfigSchema, bq as TraitConfigValue, br as TraitConfigValueSchema, bs as TraitDataEntity, bt as TraitDataEntitySchema, bu as TraitEntityField, bv as TraitEntityFieldSchema, bw as TraitEventContract, bx as TraitEventContractSchema, by as TraitEventListener, bz as TraitEventListenerSchema, bA as TraitInput, bB as TraitRef, bC as TraitRefSchema, bD as TraitReference, bE as TraitReferenceInput, bF as TraitReferenceSchema, bG as TraitSchema, bH as TraitTick, bI as TraitTickSchema, bJ as TraitUIBinding, bK as Transition, bL as TransitionInput, bM as TransitionSchema, bN as TypedEffect, bO as UISlot, bP as UISlotSchema, bQ as UI_SLOTS, bR as VISUAL_STYLES, bS as VisualStyle, bT as VisualStyleSchema, bU as WatchEffect, bV as WatchOptions, bW as atomic, bX as callService, bY as createAssetKey, bZ as deref, b_ as deriveCollection, b$ as despawn, c0 as doEffects, c1 as emit, c2 as findService, c3 as getDefaultAnimationsForRole, c4 as getServiceNames, c5 as getTraitConfig, c6 as getTraitName, c7 as hasService, c8 as isCircuitEvent, c9 as isEffect, ca as isInlineTrait, cb as isMcpService, cc as isRestService, cd as isRuntimeEntity, ce as isSExprEffect, cf as isServiceReference, cg as isServiceReferenceObject, ch as isSingletonEntity, ci as isSocketService, cj as navigate, ck as normalizeTraitRef, cl as notify, cm as parseAssetKey, cn as parseServiceRef, co as persist, cp as ref, cq as renderUI, cr as set, cs as spawn, ct as swap, cu as validateAssetAnimations, cv as watch } from '../trait-Cvs0OQbV.js';
+import { a3 as OrbitalSchema, T as Orbital, aa as Page, u as DomainContext, ah as PageTraitRef } from '../schema-pKqQXuGN.js';
+export { A as AGENT_DOMAIN_CATEGORIES, a as ALLOWED_CUSTOM_COMPONENTS, b as AgentDomainCategory, c as AgentDomainCategorySchema, d as AllowedCustomComponent, C as ComputedEventContract, e as ComputedEventContractSchema, f as ComputedEventListener, g as ComputedEventListenerSchema, h as CustomPatternDefinition, i as CustomPatternDefinitionInput, j as CustomPatternDefinitionSchema, k as CustomPatternMap, l as CustomPatternMapInput, m as CustomPatternMapSchema, D as DesignPreferences, n as DesignPreferencesInput, o as DesignPreferencesSchema, p as DesignTokens, q as DesignTokensInput, r as DesignTokensSchema, s as DomainCategory, t as DomainCategorySchema, v as DomainContextInput, w as DomainContextSchema, x as DomainVocabulary, y as DomainVocabularySchema, E as EntityCall, z as EntityCallSchema, B as EntityRef, F as EntityRefSchema, G as EntityRefStringSchema, H as EntitySemanticRole, I as EntitySemanticRoleSchema, J as EventListener, K as EventListenerSchema, L as EventSemanticRole, M as EventSemanticRoleSchema, N as EventSource, O as EventSourceSchema, P as GameSubCategory, Q as GameSubCategorySchema, R as NodeClassification, S as NodeClassificationSchema, U as OrbitalConfig, V as OrbitalConfigInput, W as OrbitalConfigSchema, X as OrbitalDefinition, Y as OrbitalDefinitionSchema, Z as OrbitalInput, _ as OrbitalPage, $ as OrbitalPageInput, a0 as OrbitalPageSchema, a1 as OrbitalPageStrictInput, a2 as OrbitalPageStrictSchema, a5 as OrbitalSchemaInput, a6 as OrbitalSchemaSchema, a7 as OrbitalSchemaWithTraits, a8 as OrbitalUnit, a9 as OrbitalUnitSchema, a4 as OrbitalZodSchema, ab as PageRef, ac as PageRefObject, ad as PageRefObjectSchema, ae as PageRefSchema, af as PageRefStringSchema, ag as PageSchema, ai as PageTraitRefSchema, aj as RelatedLink, ak as RelatedLinkSchema, al as StateSemanticRole, am as StateSemanticRoleSchema, an as SuggestedGuard, ao as SuggestedGuardSchema, ap as ThemeDefinition, aq as ThemeDefinitionSchema, ar as ThemeRef, as as ThemeRefSchema, at as ThemeRefStringSchema, au as ThemeTokens, av as ThemeTokensSchema, aw as ThemeVariant, ax as ThemeVariantSchema, ay as UXHints, az as UXHintsSchema, aA as UseDeclaration, aB as UseDeclarationSchema, aC as UserPersona, aD as UserPersonaInput, aE as UserPersonaSchema, X as ValidatedOrbital, aF as ViewType, aG as ViewTypeSchema, aH as isEntityCall, aI as isEntityReference, aJ as isEntityReferenceAny, aK as isImportedTraitRef, aL as isOrbitalDefinition, aM as isPageReference, aN as isPageReferenceObject, aO as isPageReferenceString, aP as isThemeReference, aQ as parseEntityRef, aR as parseImportedTraitRef, aS as parseOrbitalSchema, aT as parsePageRef, aU as safeParseOrbitalSchema } from '../schema-pKqQXuGN.js';
+import { aY as ServiceParams, bk as Trait, z as Entity, M as EntityRow, a5 as FieldValue, D as DeclaredTraitConfig, bn as TraitConfig, F as EntityField, I as EntityPersistence, bl as TraitCategory, bH as TraitScope } from '../trait-BVLBQ9uk.js';
+export { A as AgentEffect, a as AnimationDef, b as AnimationDefInput, c as AnimationDefSchema, d as ArrayEntityField, e as AssetMap, f as AssetMapInput, g as AssetMapSchema, h as AssetMapping, i as AssetMappingInput, j as AssetMappingSchema, k as AtomicEffect, C as CallServiceConfig, l as CallServiceEffect, m as CheckpointLoadEffect, n as CheckpointSaveEffect, o as ConfigFieldDeclaration, p as ConfigFieldDeclarationSchema, q as DeclaredTraitConfigSchema, r as DerefEffect, s as DespawnEffect, t as DoEffect, E as ENTITY_ROLES, u as Effect, v as EffectInput, w as EffectSchema, x as EmitConfig, y as EmitEffect, B as EntityData, G as EntityFieldInput, H as EntityFieldSchema, J as EntityPersistenceSchema, K as EntityRole, L as EntityRoleSchema, N as EntitySchema, O as EnumEntityField, P as EvaluateConfig, Q as EvaluateEffect, R as Event, S as EventInput, T as EventPayloadField, U as EventPayloadFieldSchema, V as EventSchema, W as EventScope, X as EventScopeSchema, Y as FetchEffect, Z as FetchOptions, _ as FetchResult, $ as Field, a0 as FieldFormat, a1 as FieldFormatSchema, a2 as FieldSchema, a3 as FieldType, a4 as FieldTypeSchema, a6 as ForwardConfig, a7 as ForwardEffect, a8 as GAME_TYPES, a9 as GameType, aa as GameTypeSchema, ab as Guard, ac as GuardInput, ad as GuardSchema, ae as ListenSource, af as ListenSourceSchema, ag as LogEffect, ah as McpServiceDef, ai as McpServiceDefSchema, aj as NavigateEffect, ak as NnConfig, al as NnLayer, am as NotifyEffect, an as OrbitalEntity, ao as OrbitalEntityInput, ap as OrbitalEntitySchema, aq as OrbitalTraitRef, ar as OrbitalTraitRefSchema, as as OsEffect, at as PayloadField, au as PayloadFieldSchema, av as PersistData, aw as PersistEffect, ax as PersistEmitConfig, ay as PresentationType, az as RefEffect, aA as RelationConfig, aB as RelationConfigSchema, aC as RelationEntityField, aD as RenderItemLambda, aE as RenderUIConfig, aF as RenderUIEffect, aG as RenderUINode, aH as RequiredField, aI as RequiredFieldSchema, aJ as ResolvedAsset, aK as ResolvedAssetInput, aL as ResolvedAssetSchema, aM as ResolvedPatternProps, aN as RestAuthConfig, aO as RestAuthConfigSchema, aP as RestServiceDef, aQ as RestServiceDefSchema, aR as SERVICE_TYPES, aS as ScalarEntityField, aT as SemanticAssetRef, aU as SemanticAssetRefInput, aV as SemanticAssetRefSchema, aW as ServiceDefinition, aX as ServiceDefinitionSchema, aZ as ServiceParamsValue, a_ as ServiceRef, a$ as ServiceRefObject, b0 as ServiceRefObjectSchema, b1 as ServiceRefSchema, b2 as ServiceRefStringSchema, b3 as ServiceType, b4 as ServiceTypeSchema, b5 as SetEffect, b6 as SocketEvents, b7 as SocketEventsSchema, b8 as SocketServiceDef, b9 as SocketServiceDefSchema, ba as SpawnEffect, bb as State, bc as StateInput, bd as StateMachine, be as StateMachineInput, bf as StateMachineSchema, bg as StateSchema, bh as SwapEffect, bi as TrainConfig, bj as TrainEffect, bm as TraitCategorySchema, bo as TraitConfigObject, bp as TraitConfigSchema, bq as TraitConfigValue, br as TraitConfigValueSchema, bs as TraitDataEntity, bt as TraitDataEntitySchema, bu as TraitEntityField, bv as TraitEntityFieldSchema, bw as TraitEventContract, bx as TraitEventContractSchema, by as TraitEventListener, bz as TraitEventListenerSchema, bA as TraitInput, bB as TraitRef, bC as TraitRefSchema, bD as TraitReference, bE as TraitReferenceInput, bF as TraitReferenceSchema, bG as TraitSchema, bI as TraitTick, bJ as TraitTickSchema, bK as TraitUIBinding, bL as Transition, bM as TransitionInput, bN as TransitionSchema, bO as TypedEffect, bP as UISlot, bQ as UISlotSchema, bR as UI_SLOTS, bS as VISUAL_STYLES, bT as VisualStyle, bU as VisualStyleSchema, bV as WatchEffect, bW as WatchOptions, bX as atomic, bY as callService, bZ as createAssetKey, b_ as deref, b$ as deriveCollection, c0 as despawn, c1 as doEffects, c2 as emit, c3 as findService, c4 as getDefaultAnimationsForRole, c5 as getServiceNames, c6 as getTraitConfig, c7 as getTraitName, c8 as hasService, c9 as isCircuitEvent, ca as isEffect, cb as isInlineTrait, cc as isMcpService, cd as isRestService, ce as isRuntimeEntity, cf as isSExprEffect, cg as isServiceReference, ch as isServiceReferenceObject, ci as isSingletonEntity, cj as isSocketService, ck as navigate, cl as normalizeTraitRef, cm as notify, cn as parseAssetKey, co as parseServiceRef, cp as persist, cq as ref, cr as renderUI, cs as set, ct as spawn, cu as swap, cv as validateAssetAnimations, cw as watch } from '../trait-BVLBQ9uk.js';
 import { c as EventPayloadValue, b as EventPayload, L as LogMeta, S as SExpr } from '../expression-BVRFm0sV.js';
 export { C as CORE_BINDINGS, a as CoreBinding, E as EvalContext, d 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-BVRFm0sV.js';
 import { z } from 'zod';
 import { AnyPatternConfig } from '@almadar/patterns';
 export { PATTERN_TYPES, PatternConfig, PatternType, isValidPatternType } from '@almadar/patterns';
+export { J as JsonObject, a as JsonValue, T as ToolArgs, i as isJsonArray, b as isJsonObject, c as isJsonPrimitive } from '../json-lCu3FWzv.js';
 
 /**
  * S-Expression Bindings
@@ -1515,4 +1516,424 @@ interface OrbitalVerificationAPI {
     clearEventLog?: () => void;
 }
 
-export { type AgentCodeSearchResult, type AgentCompactResult, type AgentCompactStrategy, type AgentContext, type AgentGenerateOptions, type AgentMemoryCategory, type AgentMemoryRecord, 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, type ContextExtensions, type CreateFlow, DEFAULT_INTERACTION_MODELS, DeclaredTraitConfig, type DeleteFlow, DomainContext, type EditFlow, type EffectTrace, Entity, EntityRow, type EventEmit, type EventKey, type EventListen, type EventLogEntry, EventPayload, EventPayloadValue, FieldValue, Orbital as FullOrbitalUnit, type GitHubLink, type HistoryMeta, type InteractionModel, type InteractionModelInput, InteractionModelSchema, type LazyService, type ListInteraction, LogMeta, Orbital, OrbitalSchema, type OrbitalVerificationAPI, Page, type PageContentReduction, PatternTypeSchema, type PersistActionName, 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 SemanticChangeKind, type SemanticSchemaChange, type ServerResponseTrace, type ServiceAction, type ServiceActionName, type ServiceContract, type ServiceEvents, ServiceParams, type SnapshotDocument, type StatsView, type StoreContract, type StoreFilter, type StoreFilterOp, Trait, TraitConfig, type TraitFieldRef, TraitFieldRefSchema, type TraitStateSnapshot, type TransitionFrom, type TransitionTrace, type Unsubscribe, type ValidationDocument, type ValidationIssue, type ValidationMeta, type ValidationResults, type VerificationCheck, type VerificationSnapshot, type VerificationSummary, type ViewFlow, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, getAllPatternTypes, getBindingExamples, getInteractionModelForDomain, inferTsType, isResolvedIR, isTraitFieldRef, toBindingRoot, validateBindingInContext };
+/**
+ * Validation error types — the shape emitted by every
+ * `.orb` / `.lolo` validator pass.
+ *
+ * `ValidationError` is the wire shape: `{ code, path, message, suggestion? }`.
+ * `code` is `ValidationErrorCode`, which is an OPEN `string` to let the
+ * Rust validator emit new codes without an `@almadar/core` rev. The
+ * `KNOWN_VALIDATION_ERROR_CODES` const documents the codes currently
+ * emitted by the validator + lolo lower pipeline (extracted from
+ * `orbital-rust/crates/orbital-compiler/src/phases/validation/` +
+ * `orbital-rust/crates/orbital-lolo/src/`).
+ *
+ * Consumers that want to narrow a code to the closed known set use
+ * `KnownValidationErrorCode`:
+ *
+ * ```ts
+ * if (err.code in KNOWN_VALIDATION_ERROR_CODES) {
+ *   // err.code is now narrowable to KnownValidationErrorCode for
+ *   // exhaustive switch handling.
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+/**
+ * One validation diagnostic emitted by the validator / lolo lower pipeline.
+ *
+ * - `code`: machine-readable identifier (see `KNOWN_VALIDATION_ERROR_CODES`).
+ * - `path`: JSON pointer-like path into the failing schema location,
+ *   e.g. `'orbitals[0].traits[2].stateMachine.transitions[1].effects[0]'`.
+ * - `message`: human-readable description of the failure.
+ * - `suggestion`: optional hint the validator may add to help the
+ *   author / LLM fix the issue.
+ */
+interface ValidationError {
+    code: ValidationErrorCode;
+    path: string;
+    message: string;
+    suggestion?: string;
+}
+/**
+ * Validation error code — open `string` for forward-compat with the
+ * Rust validator's evolving code set. Narrow to the closed known set
+ * via `KnownValidationErrorCode` when exhaustive handling is needed.
+ */
+type ValidationErrorCode = string;
+/**
+ * Closed set of validation codes the Rust validator + lolo lower
+ * pipeline currently emit. Source-tagged: codes are extracted from
+ * `orbital-rust/crates/orbital-compiler/src/phases/validation/**.rs`
+ * and `orbital-rust/crates/orbital-lolo/src/**.rs`. Keep this in sync
+ * with the Rust side; mismatches are caught by the Rust validator's
+ * own unit tests, which assert the emitted code-set matches an
+ * exported manifest.
+ *
+ * Categories (prefix → meaning):
+ * - `ORB_BINDING_*` — binding (`@entity.X`, `@payload.Y`, ...) issues
+ * - `ORB_E_*` / `ORB_EFF_*` / `ORB_EMIT_*` — entity / effect / emit
+ * - `ORB_GEN_*` — generic / cross-cutting structure
+ * - `ORB_O_*` / `ORB_P_*` / `ORB_S_*` / `ORB_SM_*` / `ORB_T_*` —
+ *   orbital / page / schema / state-machine / trait
+ * - `ORB_QUERY_*` — query / search behaviors
+ * - `ORB_RUI_*` — render-UI binding + prop validation
+ * - `ORB_SLOT_*` — UI-slot conflict / contention
+ * - `ORB_SVC_*` / `ORB_UI_*` — service / UI primitives
+ * - `ORB_X_*` — cross-orbital constraints (listens, emits, IDs)
+ */
+declare const KNOWN_VALIDATION_ERROR_CODES: {
+    readonly ORB_BINDING_ENTITY_FIELD_NEVER_SET: "ORB_BINDING_ENTITY_FIELD_NEVER_SET";
+    readonly ORB_BINDING_ENTITY_FIELD_NOT_FOUND: "ORB_BINDING_ENTITY_FIELD_NOT_FOUND";
+    readonly ORB_BINDING_INVALID_FIELD_NAME: "ORB_BINDING_INVALID_FIELD_NAME";
+    readonly ORB_BINDING_INVALID_FORMAT: "ORB_BINDING_INVALID_FORMAT";
+    readonly ORB_BINDING_INVALID_PATH: "ORB_BINDING_INVALID_PATH";
+    readonly ORB_BINDING_NOW_NO_PATH: "ORB_BINDING_NOW_NO_PATH";
+    readonly ORB_BINDING_PAYLOAD_FIELD_UNDECLARED: "ORB_BINDING_PAYLOAD_FIELD_UNDECLARED";
+    readonly ORB_BINDING_PAYLOAD_IN_TICK: "ORB_BINDING_PAYLOAD_IN_TICK";
+    readonly ORB_BINDING_PAYLOAD_TYPE_INCOMPATIBLE: "ORB_BINDING_PAYLOAD_TYPE_INCOMPATIBLE";
+    readonly ORB_BINDING_SET_TARGET_MISSING_PATH: "ORB_BINDING_SET_TARGET_MISSING_PATH";
+    readonly ORB_BINDING_STATE_NO_PATH: "ORB_BINDING_STATE_NO_PATH";
+    readonly ORB_BINDING_TRAIT_CYCLE: "ORB_BINDING_TRAIT_CYCLE";
+    readonly ORB_BINDING_TRAIT_INVALID_FORMAT: "ORB_BINDING_TRAIT_INVALID_FORMAT";
+    readonly ORB_BINDING_TRAIT_INVALID_POSITION: "ORB_BINDING_TRAIT_INVALID_POSITION";
+    readonly ORB_BINDING_TRAIT_MISSING_NAME: "ORB_BINDING_TRAIT_MISSING_NAME";
+    readonly ORB_BINDING_TRAIT_SELF_REFERENCE: "ORB_BINDING_TRAIT_SELF_REFERENCE";
+    readonly ORB_BINDING_TRAIT_UNKNOWN: "ORB_BINDING_TRAIT_UNKNOWN";
+    readonly ORB_BINDING_UNKNOWN_ENTITY: "ORB_BINDING_UNKNOWN_ENTITY";
+    readonly ORB_BINDING_UNKNOWN_ROOT: "ORB_BINDING_UNKNOWN_ROOT";
+    readonly ORB_E_DUPLICATE_FIELD: "ORB_E_DUPLICATE_FIELD";
+    readonly ORB_E_EMPTY_ENUM_VALUES: "ORB_E_EMPTY_ENUM_VALUES";
+    readonly ORB_E_INVALID_FIELD_NAME: "ORB_E_INVALID_FIELD_NAME";
+    readonly ORB_E_INVALID_FIELD_TYPE: "ORB_E_INVALID_FIELD_TYPE";
+    readonly ORB_E_INVALID_RELATION: "ORB_E_INVALID_RELATION";
+    readonly ORB_E_LITERAL_UNION_DEFAULT_MISMATCH: "ORB_E_LITERAL_UNION_DEFAULT_MISMATCH";
+    readonly ORB_E_MISSING_COLLECTION: "ORB_E_MISSING_COLLECTION";
+    readonly ORB_E_MISSING_NAME: "ORB_E_MISSING_NAME";
+    readonly ORB_E_NO_FIELDS: "ORB_E_NO_FIELDS";
+    readonly ORB_EFF_CALL_SERVICE_MISSING_ACTION: "ORB_EFF_CALL_SERVICE_MISSING_ACTION";
+    readonly ORB_EFF_CALL_SERVICE_MISSING_HANDLERS: "ORB_EFF_CALL_SERVICE_MISSING_HANDLERS";
+    readonly ORB_EFF_CALL_SERVICE_MISSING_SERVICE: "ORB_EFF_CALL_SERVICE_MISSING_SERVICE";
+    readonly ORB_EFF_EMIT_INVALID_NAME: "ORB_EFF_EMIT_INVALID_NAME";
+    readonly ORB_EFF_EMIT_KEY_INVALID: "ORB_EFF_EMIT_KEY_INVALID";
+    readonly ORB_EFF_EMIT_UNDECLARED_EVENT: "ORB_EFF_EMIT_UNDECLARED_EVENT";
+    readonly ORB_EFF_FETCH_INVALID_ENTITY: "ORB_EFF_FETCH_INVALID_ENTITY";
+    readonly ORB_EFF_FETCH_INVALID_INCLUDE: "ORB_EFF_FETCH_INVALID_INCLUDE";
+    readonly ORB_EFF_MISSING_FETCH_FOR_ENTITY: "ORB_EFF_MISSING_FETCH_FOR_ENTITY";
+    readonly ORB_EFF_MISSING_REQUIRED_EMIT: "ORB_EFF_MISSING_REQUIRED_EMIT";
+    readonly ORB_EFF_NAVIGATE_MISSING_PAYLOAD: "ORB_EFF_NAVIGATE_MISSING_PAYLOAD";
+    readonly ORB_EFF_NAVIGATE_TARGET_UNREACHABLE: "ORB_EFF_NAVIGATE_TARGET_UNREACHABLE";
+    readonly ORB_EFF_SET_INVALID_BINDING: "ORB_EFF_SET_INVALID_BINDING";
+    readonly ORB_EFF_SET_PAYLOAD_NOT_ALLOWED: "ORB_EFF_SET_PAYLOAD_NOT_ALLOWED";
+    readonly ORB_EFF_SLOT_CONFLICT: "ORB_EFF_SLOT_CONFLICT";
+    readonly ORB_EFF_UNKNOWN_TYPE: "ORB_EFF_UNKNOWN_TYPE";
+    readonly ORB_EMIT_DECLARED_BUT_UNFIRED: "ORB_EMIT_DECLARED_BUT_UNFIRED";
+    readonly ORB_EMIT_PAYLOAD_EXTRA_FIELD: "ORB_EMIT_PAYLOAD_EXTRA_FIELD";
+    readonly ORB_EMIT_PAYLOAD_FIELD_TYPE_MISMATCH: "ORB_EMIT_PAYLOAD_FIELD_TYPE_MISMATCH";
+    readonly ORB_EMIT_PAYLOAD_MISSING_REQUIRED: "ORB_EMIT_PAYLOAD_MISSING_REQUIRED";
+    readonly ORB_EMIT_SUCCESS_PAYLOAD_RETURN_MISMATCH: "ORB_EMIT_SUCCESS_PAYLOAD_RETURN_MISMATCH";
+    readonly ORB_GEN_DUPLICATE: "ORB_GEN_DUPLICATE";
+    readonly ORB_GEN_INVALID_REFERENCE: "ORB_GEN_INVALID_REFERENCE";
+    readonly ORB_GEN_INVALID_VALUE: "ORB_GEN_INVALID_VALUE";
+    readonly ORB_GEN_MISSING_FIELD: "ORB_GEN_MISSING_FIELD";
+    readonly ORB_O_MISSING_PAGES: "ORB_O_MISSING_PAGES";
+    readonly ORB_P_DUPLICATE_PATH: "ORB_P_DUPLICATE_PATH";
+    readonly ORB_P_EMPTY_TRAITS: "ORB_P_EMPTY_TRAITS";
+    readonly ORB_P_INVALID_PATH: "ORB_P_INVALID_PATH";
+    readonly ORB_P_INVALID_TRAIT_REF: "ORB_P_INVALID_TRAIT_REF";
+    readonly ORB_P_INVALID_VIEW_TYPE: "ORB_P_INVALID_VIEW_TYPE";
+    readonly ORB_P_MISSING_NAME: "ORB_P_MISSING_NAME";
+    readonly ORB_P_MISSING_PATH: "ORB_P_MISSING_PATH";
+    readonly ORB_P_MISSING_TRAITS: "ORB_P_MISSING_TRAITS";
+    readonly ORB_P_SECTIONS_FORBIDDEN: "ORB_P_SECTIONS_FORBIDDEN";
+    readonly ORB_QUERY_MISSING_RECOMMENDED: "ORB_QUERY_MISSING_RECOMMENDED";
+    readonly ORB_QUERY_MISSING_SEARCH: "ORB_QUERY_MISSING_SEARCH";
+    readonly ORB_QUERY_UNKNOWN_SINGLETON: "ORB_QUERY_UNKNOWN_SINGLETON";
+    readonly ORB_QUERY_UNSUPPORTED_PATTERN: "ORB_QUERY_UNSUPPORTED_PATTERN";
+    readonly ORB_QUERY_UNUSED_SINGLETON: "ORB_QUERY_UNUSED_SINGLETON";
+    readonly ORB_RUI_BINDING_TYPE_MISMATCH: "ORB_RUI_BINDING_TYPE_MISMATCH";
+    readonly ORB_RUI_ELEMENT_SHAPE_MISMATCH: "ORB_RUI_ELEMENT_SHAPE_MISMATCH";
+    readonly ORB_RUI_EVENT_BINDING_PAYLOAD_MISMATCH: "ORB_RUI_EVENT_BINDING_PAYLOAD_MISMATCH";
+    readonly ORB_RUI_INVALID_FIELD_PATH: "ORB_RUI_INVALID_FIELD_PATH";
+    readonly ORB_RUI_INVALID_ITEM_ACTION: "ORB_RUI_INVALID_ITEM_ACTION";
+    readonly ORB_RUI_INVALID_PATTERN: "ORB_RUI_INVALID_PATTERN";
+    readonly ORB_RUI_INVALID_PROP: "ORB_RUI_INVALID_PROP";
+    readonly ORB_RUI_INVALID_SLOT: "ORB_RUI_INVALID_SLOT";
+    readonly ORB_RUI_MISSING_ACTION: "ORB_RUI_MISSING_ACTION";
+    readonly ORB_RUI_MISSING_PATTERN_TYPE: "ORB_RUI_MISSING_PATTERN_TYPE";
+    readonly ORB_RUI_MISSING_REQUIRED_PROP: "ORB_RUI_MISSING_REQUIRED_PROP";
+    readonly ORB_RUI_PROP_TYPE_MISMATCH: "ORB_RUI_PROP_TYPE_MISMATCH";
+    readonly ORB_RUI_UNKNOWN_ITEM_ACTION_PROP: "ORB_RUI_UNKNOWN_ITEM_ACTION_PROP";
+    readonly ORB_S_EMPTY_VERSION: "ORB_S_EMPTY_VERSION";
+    readonly ORB_S_MISSING_NAME: "ORB_S_MISSING_NAME";
+    readonly ORB_S_NO_ORBITALS: "ORB_S_NO_ORBITALS";
+    readonly ORB_SLOT_CONTENTION: "ORB_SLOT_CONTENTION";
+    readonly ORB_SLOT_CONTENTION_RUNTIME: "ORB_SLOT_CONTENTION_RUNTIME";
+    readonly ORB_SLOT_HUD_NON_GAME: "ORB_SLOT_HUD_NON_GAME";
+    readonly ORB_SLOT_INVALID_NAME: "ORB_SLOT_INVALID_NAME";
+    readonly ORB_SLOT_INVALID_NESTING: "ORB_SLOT_INVALID_NESTING";
+    readonly ORB_SLOT_MAIN_NOT_COVERED: "ORB_SLOT_MAIN_NOT_COVERED";
+    readonly ORB_SLOT_PRIORITY_CONFLICT: "ORB_SLOT_PRIORITY_CONFLICT";
+    readonly ORB_SVC_DUPLICATE_NAME: "ORB_SVC_DUPLICATE_NAME";
+    readonly ORB_SVC_INVALID_INTEGRATOR: "ORB_SVC_INVALID_INTEGRATOR";
+    readonly ORB_SVC_INVALID_URL: "ORB_SVC_INVALID_URL";
+    readonly ORB_SVC_MISSING_BASE_URL: "ORB_SVC_MISSING_BASE_URL";
+    readonly ORB_SVC_MISSING_CAPABILITIES: "ORB_SVC_MISSING_CAPABILITIES";
+    readonly ORB_SVC_MISSING_EVENTS: "ORB_SVC_MISSING_EVENTS";
+    readonly ORB_SVC_MISSING_SERVER_PATH: "ORB_SVC_MISSING_SERVER_PATH";
+    readonly ORB_SVC_RESERVED_EVENT: "ORB_SVC_RESERVED_EVENT";
+    readonly ORB_SVC_UNKNOWN_TYPE: "ORB_SVC_UNKNOWN_TYPE";
+    readonly ORB_T_CONFIG_OBJECT_ARRAY_FORBIDDEN: "ORB_T_CONFIG_OBJECT_ARRAY_FORBIDDEN";
+    readonly ORB_T_CONFIG_SHAPE_MISMATCH: "ORB_T_CONFIG_SHAPE_MISMATCH";
+    readonly ORB_T_CONFIG_TIER_INVALID: "ORB_T_CONFIG_TIER_INVALID";
+    readonly ORB_T_DEPRECATED_UI: "ORB_T_DEPRECATED_UI";
+    readonly ORB_T_DUPLICATE_NAME: "ORB_T_DUPLICATE_NAME";
+    readonly ORB_T_DUPLICATE_STATE: "ORB_T_DUPLICATE_STATE";
+    readonly ORB_T_DUPLICATE_TRANSITION: "ORB_T_DUPLICATE_TRANSITION";
+    readonly ORB_T_ENTITY_NAME_SHADOWS_TRAIT_UNION: "ORB_T_ENTITY_NAME_SHADOWS_TRAIT_UNION";
+    readonly ORB_T_EVENT_TYPE_WRONG_KIND: "ORB_T_EVENT_TYPE_WRONG_KIND";
+    readonly ORB_T_EVT_DUPLICATE: "ORB_T_EVT_DUPLICATE";
+    readonly ORB_T_EVT_EXTERNAL_MISSING_PAYLOAD: "ORB_T_EVT_EXTERNAL_MISSING_PAYLOAD";
+    readonly ORB_T_EVT_INVALID_NAME: "ORB_T_EVT_INVALID_NAME";
+    readonly ORB_T_EVT_SCOPE_MISMATCH: "ORB_T_EVT_SCOPE_MISMATCH";
+    readonly ORB_T_EVT_TICK_UNDECLARED: "ORB_T_EVT_TICK_UNDECLARED";
+    readonly ORB_T_EVT_UNDECLARED: "ORB_T_EVT_UNDECLARED";
+    readonly ORB_T_INIT_MISSING_FETCH: "ORB_T_INIT_MISSING_FETCH";
+    readonly ORB_T_INVALID_CATEGORY: "ORB_T_INVALID_CATEGORY";
+    readonly ORB_T_INVALID_FORMAT: "ORB_T_INVALID_FORMAT";
+    readonly ORB_T_INVALID_PATTERN_DEFAULT: "ORB_T_INVALID_PATTERN_DEFAULT";
+    readonly ORB_T_INVALID_SLOT_DEFAULT: "ORB_T_INVALID_SLOT_DEFAULT";
+    readonly ORB_T_INVALID_TRANSITION: "ORB_T_INVALID_TRANSITION";
+    readonly ORB_T_MISSING_INIT_TRANSITION: "ORB_T_MISSING_INIT_TRANSITION";
+    readonly ORB_T_MISSING_RENDER_UI: "ORB_T_MISSING_RENDER_UI";
+    readonly ORB_T_MULTIPLE_INITIAL_STATES: "ORB_T_MULTIPLE_INITIAL_STATES";
+    readonly ORB_T_NO_INITIAL_STATE: "ORB_T_NO_INITIAL_STATE";
+    readonly ORB_T_TYPE_ANNOTATION_MISMATCH: "ORB_T_TYPE_ANNOTATION_MISMATCH";
+    readonly ORB_T_TYPE_COMPOSITION_CONFLICT: "ORB_T_TYPE_COMPOSITION_CONFLICT";
+    readonly ORB_T_TYPE_CYCLE: "ORB_T_TYPE_CYCLE";
+    readonly ORB_T_TYPE_KIND_MISMATCH: "ORB_T_TYPE_KIND_MISMATCH";
+    readonly ORB_T_TYPE_UNKNOWN: "ORB_T_TYPE_UNKNOWN";
+    readonly ORB_T_TYPE_UNKNOWN_PARAM: "ORB_T_TYPE_UNKNOWN_PARAM";
+    readonly ORB_T_TYPE_WRONG_ARG_COUNT: "ORB_T_TYPE_WRONG_ARG_COUNT";
+    readonly ORB_T_UNDEFINED_EVENT: "ORB_T_UNDEFINED_EVENT";
+    readonly ORB_T_UNDEFINED_TRAIT: "ORB_T_UNDEFINED_TRAIT";
+    readonly ORB_UI_ICON_EMPTY: "ORB_UI_ICON_EMPTY";
+    readonly ORB_UI_ICON_INVALID_FORMAT: "ORB_UI_ICON_INVALID_FORMAT";
+    readonly ORB_UI_ICON_NOT_FOUND: "ORB_UI_ICON_NOT_FOUND";
+    readonly ORB_X_CIRCULAR_DEPENDENCY: "ORB_X_CIRCULAR_DEPENDENCY";
+    readonly ORB_X_CROSS_EMITTER_DECLARED_PAYLOAD_MISMATCH: "ORB_X_CROSS_EMITTER_DECLARED_PAYLOAD_MISMATCH";
+    readonly ORB_X_DUPLICATE_ENTITY: "ORB_X_DUPLICATE_ENTITY";
+    readonly ORB_X_EVENT_COLLISION: "ORB_X_EVENT_COLLISION";
+    readonly ORB_X_INTERNAL_EVENT_EXPOSED: "ORB_X_INTERNAL_EVENT_EXPOSED";
+    readonly ORB_X_LISTEN_SOURCE_UNRESOLVED: "ORB_X_LISTEN_SOURCE_UNRESOLVED";
+    readonly ORB_X_MISSING_ORBITAL_NAME: "ORB_X_MISSING_ORBITAL_NAME";
+    readonly ORB_X_ORPHAN_LISTENER: "ORB_X_ORPHAN_LISTENER";
+    readonly ORB_X_PAYLOAD_MISMATCH: "ORB_X_PAYLOAD_MISMATCH";
+    readonly ORB_X_RENDER_UI_EVENT_LITERAL_STALE: "ORB_X_RENDER_UI_EVENT_LITERAL_STALE";
+    readonly ORB_X_UNRESOLVED_PATTERN_FIELD_REF: "ORB_X_UNRESOLVED_PATTERN_FIELD_REF";
+    readonly ORB_X_UNUSED_EMISSION: "ORB_X_UNUSED_EMISSION";
+};
+/**
+ * Narrow union of the codes documented in `KNOWN_VALIDATION_ERROR_CODES`.
+ * Use this in exhaustive `switch` handlers; use the broader
+ * `ValidationErrorCode` (open `string`) anywhere a fresh validator-side
+ * code could plausibly arrive.
+ */
+type KnownValidationErrorCode = typeof KNOWN_VALIDATION_ERROR_CODES[keyof typeof KNOWN_VALIDATION_ERROR_CODES];
+/**
+ * Type guard: is the given code a known one? After the guard returns
+ * true, the code can be narrowed to `KnownValidationErrorCode` via a
+ * separate cast, because the type system can't track `in` against
+ * `as const` records without an explicit narrowing helper.
+ */
+declare function isKnownValidationErrorCode(code: ValidationErrorCode): boolean;
+
+/**
+ * Parsed AST — LLM-emit relaxed views of the canonical orbital types.
+ *
+ * Every `Parsed*` type mirrors its canonical counterpart in this module
+ * (`Trait`, `StateMachine`, `Transition`, `State`, `Event`, `OrbitalDefinition`,
+ * `PageRefObject`, etc.) but loosens required fields to optional. The
+ * loosening exists for one reason: the LLM can emit a partial orbital
+ * (mid-stream, mid-tool-call, mid-LoLo lowering) and consumer code
+ * needs to walk it WITHOUT casting to the strict canonical type before
+ * every field access.
+ *
+ * Discipline:
+ *
+ * - **No `unknown`.** Every field has a concrete type, sourced from
+ *   this same module where the type already exists (`EntityField`,
+ *   `EntityPersistence`, `TraitCategory`, `TraitScope`, `SExpr`,
+ *   `PageTraitRef`, `TraitEventContract`, `TraitEventListener`).
+ *
+ * - **No index signatures.** If the LLM emits a key the schema doesn't
+ *   know about, the validator rejects it. The `Parsed*` types do not
+ *   pretend to accept unknown keys at the type level.
+ *
+ * - **Required fields stay required.** `name` on `ParsedOrbital` is
+ *   required because no orbital can exist without one. `name` /
+ *   `linkedEntity` on `ParsedTrait` are required because the orbital
+ *   compiler rejects traits missing either. Only fields the LLM
+ *   legitimately omits during construction are optional.
+ *
+ * Use site: walkers that observe an orbital before it's fully
+ * validated. Construct it as `ParsedOrbital`, narrow to
+ * `OrbitalDefinition` after validation.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Top-level orbital as the LLM emits it. Relaxed view of
+ * `OrbitalDefinition`: traits and pages may be partial, the domain
+ * context + design hints may be missing.
+ */
+interface ParsedOrbital {
+    name: string;
+    entity: ParsedEntity;
+    traits: ParsedTrait[];
+    pages: ParsedPage[];
+    domainContext?: ParsedDomainContext;
+    design?: ParsedDesign;
+}
+/**
+ * Entity nucleus of an orbital. `name` + `fields` are required; the
+ * factory canonical defaults can fill `persistence` and `collection`
+ * when omitted.
+ */
+interface ParsedEntity {
+    name: string;
+    fields: EntityField[];
+    persistence?: EntityPersistence;
+    collection?: string;
+}
+/**
+ * One trait on an orbital. `name` + `linkedEntity` are required (the
+ * compiler rejects either omission); state machine + scope + category
+ * are filled by defaults when the LLM doesn't specify them.
+ */
+interface ParsedTrait {
+    name: string;
+    linkedEntity: string;
+    category?: TraitCategory;
+    scope?: TraitScope;
+    description?: string;
+    config?: ParsedTraitConfig;
+    emits?: ParsedEmitDeclaration[];
+    listens?: ParsedListenDeclaration[];
+    stateMachine?: ParsedStateMachine;
+    capabilities?: string[];
+}
+/**
+ * Trait `config { }` block — the LLM-emit shape carries each declared
+ * config key as a typed value drawn from the JSON primitive set. A
+ * stricter view (`DeclaredTraitConfig` in `trait.ts`) captures the
+ * authored field descriptors with type+default+label+tier metadata;
+ * `ParsedTraitConfig` is the in-flight value map.
+ */
+type ParsedTraitConfig = {
+    [key: string]: string | number | boolean | null | ReadonlyArray<string | number | boolean | null>;
+};
+/**
+ * State-machine of a trait. Every field optional because the LLM may
+ * emit the trait header before its body. A canonical
+ * `StateMachine` (`state-machine.ts`) requires at least one state +
+ * one transition.
+ */
+interface ParsedStateMachine {
+    states?: ParsedState[];
+    events?: ParsedEvent[];
+    transitions?: ParsedTransition[];
+    initial?: string;
+}
+/**
+ * One state of a `ParsedStateMachine`. Mirrors `State` from
+ * `state-machine.ts` with name optional during construction.
+ */
+interface ParsedState {
+    name?: string;
+    isInitial?: boolean;
+}
+/**
+ * One event of a `ParsedStateMachine`. Mirrors `Event` from
+ * `state-machine.ts`. `payloadSchema` is the canonical shape — an
+ * array of `EntityField`s describing the event's payload.
+ */
+interface ParsedEvent {
+    key?: string;
+    name?: string;
+    payloadSchema?: EntityField[];
+}
+/**
+ * One transition of a `ParsedStateMachine`. `effects` + `guard` use
+ * `SExpr` from `expression.ts` — the canonical S-expression shape the
+ * runtime evaluates.
+ */
+interface ParsedTransition {
+    from?: string;
+    to?: string;
+    event?: string;
+    effects?: SExpr[];
+    guard?: SExpr;
+}
+/**
+ * Trait-emit declaration. Aliases `TraitEventContract` from
+ * `trait.ts` with every field optional. The canonical contract
+ * carries `event`, `scope`, `payload`; here all three are optional so
+ * an in-flight emit (just the name, no payload yet) types correctly.
+ */
+interface ParsedEmitDeclaration {
+    event?: string;
+    scope?: 'internal' | 'external';
+    payload?: EntityField[];
+}
+/**
+ * Trait-listen declaration. Mirrors `TraitEventListener` from
+ * `trait.ts` with the source remap and trigger key optional.
+ */
+interface ParsedListenDeclaration {
+    event?: string;
+    triggers?: string;
+    scope?: 'internal' | 'external';
+    payloadMapping?: {
+        [key: string]: string;
+    };
+}
+/**
+ * One page entry on an orbital. Mirrors `PageRefObject` /
+ * `OrbitalPage`; `path` is the URL, `name` is the canonical
+ * identifier the molecule references.
+ */
+interface ParsedPage {
+    path?: string;
+    name?: string;
+    primaryEntity?: string;
+    traits?: PageTraitRef[];
+}
+/**
+ * Domain-context decorations the analyzer attaches to an orbital
+ * (vocabulary, category, original request). Mirrors `DomainContext`
+ * from `domain.ts` for the fields used in the parsed-AST surface; the
+ * full `DomainContext` carries semantic-role overlays + custom-pattern
+ * maps too, which the LLM doesn't emit in this surface.
+ */
+interface ParsedDomainContext {
+    request?: string;
+    category?: string;
+    vocabulary?: {
+        [key: string]: string;
+    };
+}
+/**
+ * Design hints (style + UX cues) the analyzer attaches. Mirrors
+ * `DesignPreferences` from `domain.ts`.
+ */
+interface ParsedDesign {
+    style?: string;
+    uxHints?: {
+        [key: string]: string;
+    };
+}
+
+export { type AgentCodeSearchResult, type AgentCompactResult, type AgentCompactStrategy, type AgentContext, type AgentGenerateOptions, type AgentMemoryCategory, type AgentMemoryRecord, 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, type ContextExtensions, type CreateFlow, DEFAULT_INTERACTION_MODELS, DeclaredTraitConfig, type DeleteFlow, DomainContext, type EditFlow, type EffectTrace, Entity, EntityField, EntityPersistence, EntityRow, type EventEmit, type EventKey, type EventListen, type EventLogEntry, EventPayload, EventPayloadValue, FieldValue, Orbital as FullOrbitalUnit, type GitHubLink, type HistoryMeta, type InteractionModel, type InteractionModelInput, InteractionModelSchema, KNOWN_VALIDATION_ERROR_CODES, type KnownValidationErrorCode, type LazyService, type ListInteraction, LogMeta, Orbital, 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 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 SemanticChangeKind, type SemanticSchemaChange, type ServerResponseTrace, type ServiceAction, type ServiceActionName, type ServiceContract, type ServiceEvents, ServiceParams, type SnapshotDocument, type StatsView, type StoreContract, type StoreFilter, type StoreFilterOp, Trait, TraitCategory, TraitConfig, type TraitFieldRef, TraitFieldRefSchema, type TraitStateSnapshot, type TransitionFrom, type TransitionTrace, type Unsubscribe, type ValidationDocument, type ValidationError, type ValidationErrorCode, type ValidationIssue, type ValidationMeta, type ValidationResults, type VerificationCheck, type VerificationSnapshot, type VerificationSummary, type ViewFlow, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, getAllPatternTypes, getBindingExamples, getInteractionModelForDomain, inferTsType, isKnownValidationErrorCode, isResolvedIR, isTraitFieldRef, toBindingRoot, validateBindingInContext };