@almadar/core 2.11.0 → 2.13.0

package/dist/{schema-B2HUtPrQ.d.ts → schema-D3qNm2Ac.d.ts}

@@ -191,6 +191,18 @@ declare function walkSExpr(expr: SExpr, visitor: (node: SExpr, parent: SExpr[] |
 declare function collectBindings(expr: SExpr): string[];
 type SExprInput = z.input<typeof SExprSchema>;
 type ExpressionInput = z.input<typeof ExpressionSchema>;
+/** Evaluation context for guards and s-expressions. Recursive. */
+interface EvalContext {
+    [key: string]: string | number | boolean | Date | null | string[] | EvalContext | undefined;
+}
+/** Typed event payload map. Recursive to support nested objects like `{ data: { id: "..." } }`. */
+interface EventPayload {
+    [key: string]: string | number | boolean | null | undefined | EventPayload;
+}
+/** Structured log/event metadata. Recursive to support nested log data. */
+interface LogMeta {
+    [key: string]: string | number | boolean | null | undefined | Error | LogMeta;
+}
 
 /**
  * Field Types for Orbital Units
@@ -693,8 +705,8 @@ declare function validateAssetAnimations(assetRef: SemanticAssetRef, requiredAni
  * - singleton: Single global instance
  * - instance: Static data (read-only instances)
  */
-type EntityPersistence = 'persistent' | 'runtime' | 'singleton' | 'instance';
-declare const EntityPersistenceSchema: z.ZodEnum<["persistent", "runtime", "singleton", "instance"]>;
+type EntityPersistence = 'persistent' | 'runtime' | 'singleton' | 'instance' | 'local';
+declare const EntityPersistenceSchema: z.ZodEnum<["persistent", "runtime", "singleton", "instance", "local"]>;
 /**
  * OrbitalEntity - the nucleus of an Orbital Unit.
  *
@@ -711,7 +723,7 @@ interface OrbitalEntity {
     /** Entity fields */
     fields: EntityField[];
     /** Pre-authored instances (seed data or static reference data) */
-    instances?: Record<string, unknown>[];
+    instances?: EntityRow[];
     /** Auto-add createdAt/updatedAt timestamps */
     timestamps?: boolean;
     /** Soft delete support */
@@ -725,7 +737,7 @@ interface OrbitalEntity {
 }
 declare const OrbitalEntitySchema: z.ZodObject<{
     name: z.ZodString;
-    persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance"]>>;
+    persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance", "local"]>>;
     collection: z.ZodOptional<z.ZodString>;
     fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, EntityField>, "many">;
     instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
@@ -754,7 +766,7 @@ declare const OrbitalEntitySchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    persistence: "persistent" | "runtime" | "singleton" | "instance";
+    persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
     fields: EntityField[];
     collection?: string | undefined;
     instances?: Record<string, unknown>[] | undefined;
@@ -772,7 +784,7 @@ declare const OrbitalEntitySchema: z.ZodObject<{
 }, {
     name: string;
     fields: EntityField[];
-    persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
+    persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
     collection?: string | undefined;
     instances?: Record<string, unknown>[] | undefined;
     timestamps?: boolean | undefined;
@@ -793,7 +805,7 @@ type Entity = OrbitalEntity;
 /** Alias for OrbitalEntitySchema - preferred name */
 declare const EntitySchema: z.ZodObject<{
     name: z.ZodString;
-    persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance"]>>;
+    persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance", "local"]>>;
     collection: z.ZodOptional<z.ZodString>;
     fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, EntityField>, "many">;
     instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
@@ -822,7 +834,7 @@ declare const EntitySchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    persistence: "persistent" | "runtime" | "singleton" | "instance";
+    persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
     fields: EntityField[];
     collection?: string | undefined;
     instances?: Record<string, unknown>[] | undefined;
@@ -840,7 +852,7 @@ declare const EntitySchema: z.ZodObject<{
 }, {
     name: string;
     fields: EntityField[];
-    persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
+    persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
     collection?: string | undefined;
     instances?: Record<string, unknown>[] | undefined;
     timestamps?: boolean | undefined;
@@ -898,6 +910,33 @@ declare function isRuntimeEntity(entity: OrbitalEntity): boolean;
  * isSingletonEntity({ persistence: 'persistent' }); // returns false
  */
 declare function isSingletonEntity(entity: OrbitalEntity): boolean;
+/**
+ * A single field value at runtime.
+ * Union of all possible types from FieldType: string, number, boolean, date, array, nested.
+ */
+type FieldValue = string | number | boolean | Date | null | string[] | FieldValue[];
+/**
+ * One instance of an entity with actual field values.
+ * The shape is determined by the Entity definition at schema time.
+ *
+ * @example
+ * // Entity defines: Patient { fullName: string, age: number, active: boolean }
+ * // EntityRow is: { id: "p1", fullName: "Sarah", age: 34, active: true }
+ */
+type EntityRow = {
+    id?: string;
+} & Record<string, FieldValue>;
+/**
+ * Collection of entity instances keyed by entity name.
+ * Used by OrbPreview mockData, OrbitalServerRuntime state, data grids, etc.
+ *
+ * @example
+ * const data: EntityData = {
+ *   Patient: [{ id: "1", fullName: "Sarah", age: 34 }],
+ *   QueueEntry: [{ id: "1", patientName: "Sarah", waitMinutes: 12 }],
+ * };
+ */
+type EntityData = Record<string, EntityRow[]>;
 
 /**
  * Page Types for Orbital Units
@@ -1299,6 +1338,14 @@ type CheckpointSaveEffect = ['checkpoint/save', string, unknown];
  * @example ['checkpoint/load', '/path/to/model.pt']
  */
 type CheckpointLoadEffect = ['checkpoint/load', string];
+/**
+ * Agent effect - invokes an agent/* operator.
+ * Covers all 22 operators in the std-agent category.
+ * @example ['agent/memorize', 'use data-grid for tables', 'preference']
+ * @example ['agent/recall', 'user preferences']
+ * @example ['agent/generate', 'Summarize this schema']
+ */
+type AgentEffect = [`agent/${string}`, ...SExpr[]];
 /**
  * Async delay effect - wait then execute effects.
  * @example ['async/delay', 2000, ['emit', 'TIMEOUT']]
@@ -1341,7 +1388,7 @@ type AsyncSequenceEffect = ['async/sequence', ...Effect[]];
  * Union of all typed effects.
  * Provides compile-time validation for common effect types.
  */
-type TypedEffect = RenderUIEffect | NavigateEffect | EmitEffect | SetEffect | PersistEffect | CallServiceEffect | SpawnEffect | DespawnEffect | DoEffect | NotifyEffect | FetchEffect | IfEffect | WhenEffect | LetEffect | LogEffect | WaitEffect | RefEffect | DerefEffect | SwapEffect | WatchEffect | AtomicEffect | AsyncDelayEffect | AsyncDebounceEffect | AsyncThrottleEffect | AsyncIntervalEffect | AsyncRaceEffect | AsyncAllEffect | AsyncSequenceEffect | ForwardEffect | TrainEffect | EvaluateEffect | CheckpointSaveEffect | CheckpointLoadEffect;
+type TypedEffect = RenderUIEffect | NavigateEffect | EmitEffect | SetEffect | PersistEffect | CallServiceEffect | SpawnEffect | DespawnEffect | DoEffect | NotifyEffect | FetchEffect | IfEffect | WhenEffect | LetEffect | LogEffect | WaitEffect | RefEffect | DerefEffect | SwapEffect | WatchEffect | AtomicEffect | AsyncDelayEffect | AsyncDebounceEffect | AsyncThrottleEffect | AsyncIntervalEffect | AsyncRaceEffect | AsyncAllEffect | AsyncSequenceEffect | ForwardEffect | TrainEffect | EvaluateEffect | CheckpointSaveEffect | CheckpointLoadEffect | AgentEffect;
 /**
  * Effect type - typed S-expression format.
  *
@@ -1557,6 +1604,19 @@ declare function watch(binding: string, event: string, options: WatchOptions): W
  * // returns ["atomic", ["set", "@entity.x", 10], ["set", "@entity.y", 20]]
  */
 declare function atomic(...effects: SExpr[]): AtomicEffect;
+/** Resolved pattern props for render-ui effects at runtime. Recursive for nested pattern configs. */
+interface ResolvedPatternProps {
+    [prop: string]: string | number | boolean | null | undefined | ResolvedPatternProps | ResolvedPatternProps[];
+}
+/** A node in a render-ui effect tree. */
+interface RenderUINode {
+    type: string;
+    props?: ResolvedPatternProps;
+    children?: RenderUINode[];
+    content?: string;
+    entity?: string;
+    renderItem?: RenderUINode;
+}
 
 /**
  * Represents a state in the state machine
@@ -1975,8 +2035,8 @@ declare function isCircuitEvent(event: string): boolean;
 /**
  * Categories for organizing traits
  */
-type TraitCategory = 'lifecycle' | 'temporal' | 'validation' | 'notification' | 'integration' | 'interaction' | 'game-core' | 'game-character' | 'game-ai' | 'game-combat' | 'game-items' | 'game-cards' | 'game-board' | 'game-puzzle';
-declare const TraitCategorySchema: z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>;
+type TraitCategory = 'lifecycle' | 'temporal' | 'validation' | 'notification' | 'integration' | 'interaction' | 'agent' | 'game-core' | 'game-character' | 'game-ai' | 'game-combat' | 'game-items' | 'game-cards' | 'game-board' | 'game-puzzle';
+declare const TraitCategorySchema: z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "agent", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>;
 /**
  * Field types for trait data entities
  */
@@ -2394,7 +2454,7 @@ declare const TraitSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     description_visual_prompt: z.ZodOptional<z.ZodString>;
-    category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
+    category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "agent", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
     linkedEntity: z.ZodOptional<z.ZodString>;
     requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -2742,7 +2802,7 @@ declare const TraitSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     ui?: Record<string, unknown> | undefined;
-    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     description?: string | undefined;
     linkedEntity?: string | undefined;
     emits?: {
@@ -2837,7 +2897,7 @@ declare const TraitSchema: z.ZodObject<{
 }, {
     name: string;
     ui?: Record<string, unknown> | undefined;
-    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     description?: string | undefined;
     linkedEntity?: string | undefined;
     emits?: {
@@ -2946,7 +3006,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     description_visual_prompt: z.ZodOptional<z.ZodString>;
-    category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
+    category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "agent", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
     linkedEntity: z.ZodOptional<z.ZodString>;
     requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -3294,7 +3354,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     ui?: Record<string, unknown> | undefined;
-    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     description?: string | undefined;
     linkedEntity?: string | undefined;
     emits?: {
@@ -3389,7 +3449,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
 }, {
     name: string;
     ui?: Record<string, unknown> | undefined;
-    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     description?: string | undefined;
     linkedEntity?: string | undefined;
     emits?: {
@@ -3568,7 +3628,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     description_visual_prompt: z.ZodOptional<z.ZodString>;
-    category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
+    category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "agent", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
     linkedEntity: z.ZodOptional<z.ZodString>;
     requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -3916,7 +3976,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     ui?: Record<string, unknown> | undefined;
-    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     description?: string | undefined;
     linkedEntity?: string | undefined;
     emits?: {
@@ -4011,7 +4071,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
 }, {
     name: string;
     ui?: Record<string, unknown> | undefined;
-    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+    category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
     description?: string | undefined;
     linkedEntity?: string | undefined;
     emits?: {
@@ -5453,6 +5513,10 @@ declare function findService(services: ServiceDefinition[], name: string): Servi
  * Check if a service name exists (case-insensitive).
  */
 declare function hasService(services: ServiceDefinition[], name: string): boolean;
+/** Parameters passed to call-service effects. Recursive for nested request shapes. */
+interface ServiceParams {
+    [key: string]: string | number | boolean | Date | null | string[] | ServiceParams | undefined;
+}
 
 /**
  * UseDeclaration - Import an external Orbital as a namespace.
@@ -5535,7 +5599,7 @@ declare function isEntityReference(entity: EntityRef): entity is string;
 declare const EntityRefStringSchema: z.ZodString;
 declare const EntityRefSchema: z.ZodUnion<[z.ZodObject<{
     name: z.ZodString;
-    persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance"]>>;
+    persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance", "local"]>>;
     collection: z.ZodOptional<z.ZodString>;
     fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, EntityField>, "many">;
     instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
@@ -5564,7 +5628,7 @@ declare const EntityRefSchema: z.ZodUnion<[z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    persistence: "persistent" | "runtime" | "singleton" | "instance";
+    persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
     fields: EntityField[];
     collection?: string | undefined;
     instances?: Record<string, unknown>[] | undefined;
@@ -5582,7 +5646,7 @@ declare const EntityRefSchema: z.ZodUnion<[z.ZodObject<{
 }, {
     name: string;
     fields: EntityField[];
-    persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
+    persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
     collection?: string | undefined;
     instances?: Record<string, unknown>[] | undefined;
     timestamps?: boolean | undefined;
@@ -6347,7 +6411,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
     }>]>, z.ZodString]>, "many">>;
     entity: z.ZodUnion<[z.ZodObject<{
         name: z.ZodString;
-        persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance"]>>;
+        persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance", "local"]>>;
         collection: z.ZodOptional<z.ZodString>;
         fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, EntityField>, "many">;
         instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
@@ -6376,7 +6440,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         }>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
-        persistence: "persistent" | "runtime" | "singleton" | "instance";
+        persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
         fields: EntityField[];
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
@@ -6394,7 +6458,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
     }, {
         name: string;
         fields: EntityField[];
-        persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
+        persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -6425,7 +6489,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         description_visual_prompt: z.ZodOptional<z.ZodString>;
-        category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
+        category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "agent", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
         linkedEntity: z.ZodOptional<z.ZodString>;
         requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
@@ -6773,7 +6837,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
         linkedEntity?: string | undefined;
         emits?: {
@@ -6868,7 +6932,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
     }, {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
         linkedEntity?: string | undefined;
         emits?: {
@@ -7259,7 +7323,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     entity: string | {
         name: string;
-        persistence: "persistent" | "runtime" | "singleton" | "instance";
+        persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
         fields: EntityField[];
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
@@ -7279,7 +7343,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
     traits: (string | {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
         linkedEntity?: string | undefined;
         emits?: {
@@ -7517,7 +7581,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
     entity: string | {
         name: string;
         fields: EntityField[];
-        persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
+        persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -7536,7 +7600,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
     traits: (string | {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
         linkedEntity?: string | undefined;
         emits?: {
@@ -7987,7 +8051,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
     }>]>, z.ZodString]>, "many">>;
     entity: z.ZodUnion<[z.ZodObject<{
         name: z.ZodString;
-        persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance"]>>;
+        persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance", "local"]>>;
         collection: z.ZodOptional<z.ZodString>;
         fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, EntityField>, "many">;
         instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
@@ -8016,7 +8080,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
         }>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
-        persistence: "persistent" | "runtime" | "singleton" | "instance";
+        persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
         fields: EntityField[];
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
@@ -8034,7 +8098,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
     }, {
         name: string;
         fields: EntityField[];
-        persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
+        persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -8065,7 +8129,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         description_visual_prompt: z.ZodOptional<z.ZodString>;
-        category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
+        category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "agent", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
         linkedEntity: z.ZodOptional<z.ZodString>;
         requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
@@ -8413,7 +8477,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
         linkedEntity?: string | undefined;
         emits?: {
@@ -8508,7 +8572,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
     }, {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
         linkedEntity?: string | undefined;
         emits?: {
@@ -8899,7 +8963,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     entity: string | {
         name: string;
-        persistence: "persistent" | "runtime" | "singleton" | "instance";
+        persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
         fields: EntityField[];
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
@@ -8919,7 +8983,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
     traits: (string | {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
         linkedEntity?: string | undefined;
         emits?: {
@@ -9157,7 +9221,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
     entity: string | {
         name: string;
         fields: EntityField[];
-        persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
+        persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -9176,7 +9240,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
     traits: (string | {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
         linkedEntity?: string | undefined;
         emits?: {
@@ -9634,7 +9698,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
     }>]>, z.ZodString]>, "many">>;
     entity: z.ZodUnion<[z.ZodObject<{
         name: z.ZodString;
-        persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance"]>>;
+        persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance", "local"]>>;
         collection: z.ZodOptional<z.ZodString>;
         fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, EntityField>, "many">;
         instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
@@ -9663,7 +9727,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         }>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
-        persistence: "persistent" | "runtime" | "singleton" | "instance";
+        persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
         fields: EntityField[];
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
@@ -9681,7 +9745,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
     }, {
         name: string;
         fields: EntityField[];
-        persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
+        persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -9712,7 +9776,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         description_visual_prompt: z.ZodOptional<z.ZodString>;
-        category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
+        category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "agent", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
         linkedEntity: z.ZodOptional<z.ZodString>;
         requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
@@ -10060,7 +10124,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
         linkedEntity?: string | undefined;
         emits?: {
@@ -10155,7 +10219,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
     }, {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
         linkedEntity?: string | undefined;
         emits?: {
@@ -10546,7 +10610,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     entity: string | {
         name: string;
-        persistence: "persistent" | "runtime" | "singleton" | "instance";
+        persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
         fields: EntityField[];
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
@@ -10566,7 +10630,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
     traits: (string | {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
         linkedEntity?: string | undefined;
         emits?: {
@@ -10804,7 +10868,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
     entity: string | {
         name: string;
         fields: EntityField[];
-        persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
+        persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
         collection?: string | undefined;
         instances?: Record<string, unknown>[] | undefined;
         timestamps?: boolean | undefined;
@@ -10823,7 +10887,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
     traits: (string | {
         name: string;
         ui?: Record<string, unknown> | undefined;
-        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+        category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
         description?: string | undefined;
         linkedEntity?: string | undefined;
         emits?: {
@@ -11522,7 +11586,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         }>]>, z.ZodString]>, "many">>;
         entity: z.ZodUnion<[z.ZodObject<{
             name: z.ZodString;
-            persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance"]>>;
+            persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime", "singleton", "instance", "local"]>>;
             collection: z.ZodOptional<z.ZodString>;
             fields: z.ZodArray<z.ZodType<EntityField, z.ZodTypeDef, EntityField>, "many">;
             instances: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
@@ -11551,7 +11615,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             }>>;
         }, "strip", z.ZodTypeAny, {
             name: string;
-            persistence: "persistent" | "runtime" | "singleton" | "instance";
+            persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
             fields: EntityField[];
             collection?: string | undefined;
             instances?: Record<string, unknown>[] | undefined;
@@ -11569,7 +11633,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         }, {
             name: string;
             fields: EntityField[];
-            persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
+            persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
             collection?: string | undefined;
             instances?: Record<string, unknown>[] | undefined;
             timestamps?: boolean | undefined;
@@ -11600,7 +11664,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
             description_visual_prompt: z.ZodOptional<z.ZodString>;
-            category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
+            category: z.ZodOptional<z.ZodEnum<["lifecycle", "temporal", "validation", "notification", "integration", "interaction", "agent", "game-core", "game-character", "game-ai", "game-combat", "game-items", "game-cards", "game-board", "game-puzzle"]>>;
             linkedEntity: z.ZodOptional<z.ZodString>;
             requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
@@ -11948,7 +12012,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             name: string;
             ui?: Record<string, unknown> | undefined;
-            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
             description?: string | undefined;
             linkedEntity?: string | undefined;
             emits?: {
@@ -12043,7 +12107,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         }, {
             name: string;
             ui?: Record<string, unknown> | undefined;
-            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
             description?: string | undefined;
             linkedEntity?: string | undefined;
             emits?: {
@@ -12434,7 +12498,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         entity: string | {
             name: string;
-            persistence: "persistent" | "runtime" | "singleton" | "instance";
+            persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
             fields: EntityField[];
             collection?: string | undefined;
             instances?: Record<string, unknown>[] | undefined;
@@ -12454,7 +12518,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         traits: (string | {
             name: string;
             ui?: Record<string, unknown> | undefined;
-            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
             description?: string | undefined;
             linkedEntity?: string | undefined;
             emits?: {
@@ -12692,7 +12756,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         entity: string | {
             name: string;
             fields: EntityField[];
-            persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
+            persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
             collection?: string | undefined;
             instances?: Record<string, unknown>[] | undefined;
             timestamps?: boolean | undefined;
@@ -12711,7 +12775,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         traits: (string | {
             name: string;
             ui?: Record<string, unknown> | undefined;
-            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
             description?: string | undefined;
             linkedEntity?: string | undefined;
             emits?: {
@@ -13126,7 +13190,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
     orbitals: {
         entity: string | {
             name: string;
-            persistence: "persistent" | "runtime" | "singleton" | "instance";
+            persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
             fields: EntityField[];
             collection?: string | undefined;
             instances?: Record<string, unknown>[] | undefined;
@@ -13146,7 +13210,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         traits: (string | {
             name: string;
             ui?: Record<string, unknown> | undefined;
-            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
             description?: string | undefined;
             linkedEntity?: string | undefined;
             emits?: {
@@ -13473,7 +13537,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         entity: string | {
             name: string;
             fields: EntityField[];
-            persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
+            persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
             collection?: string | undefined;
             instances?: Record<string, unknown>[] | undefined;
             timestamps?: boolean | undefined;
@@ -13492,7 +13556,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         traits: (string | {
             name: string;
             ui?: Record<string, unknown> | undefined;
-            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
             description?: string | undefined;
             linkedEntity?: string | undefined;
             emits?: {
@@ -13866,7 +13930,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
         entity: string | {
             name: string;
             fields: EntityField[];
-            persistence?: "persistent" | "runtime" | "singleton" | "instance" | undefined;
+            persistence?: "persistent" | "runtime" | "singleton" | "instance" | "local" | undefined;
             collection?: string | undefined;
             instances?: Record<string, unknown>[] | undefined;
             timestamps?: boolean | undefined;
@@ -13885,7 +13949,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
         traits: (string | {
             name: string;
             ui?: Record<string, unknown> | undefined;
-            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
             description?: string | undefined;
             linkedEntity?: string | undefined;
             emits?: {
@@ -14211,7 +14275,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
     orbitals: {
         entity: string | {
             name: string;
-            persistence: "persistent" | "runtime" | "singleton" | "instance";
+            persistence: "persistent" | "runtime" | "singleton" | "instance" | "local";
             fields: EntityField[];
             collection?: string | undefined;
             instances?: Record<string, unknown>[] | undefined;
@@ -14231,7 +14295,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
         traits: (string | {
             name: string;
             ui?: Record<string, unknown> | undefined;
-            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
+            category?: "validation" | "notification" | "lifecycle" | "temporal" | "integration" | "interaction" | "agent" | "game-core" | "game-character" | "game-ai" | "game-combat" | "game-items" | "game-cards" | "game-board" | "game-puzzle" | undefined;
             description?: string | undefined;
             linkedEntity?: string | undefined;
             emits?: {
@@ -14556,4 +14620,4 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
 type OrbitalSchemaInput = z.input<typeof OrbitalSchemaSchema>;
 type OrbitalConfigInput = z.input<typeof OrbitalConfigSchema>;
 
-export { type EffectInput as $, AGENT_DOMAIN_CATEGORIES as A, CustomPatternDefinitionSchema as B, CORE_BINDINGS as C, type CustomPatternMap as D, type EntityField as E, type CustomPatternMapInput as F, CustomPatternMapSchema as G, type DerefEffect as H, type DesignPreferences as I, type DesignPreferencesInput as J, DesignPreferencesSchema as K, type DesignTokens as L, type DesignTokensInput as M, DesignTokensSchema as N, type OrbitalDefinition as O, type Page as P, type DomainCategory as Q, DomainCategorySchema as R, type State as S, type TraitEventContract as T, type DomainContext as U, type DomainContextInput as V, DomainContextSchema as W, type DomainVocabulary as X, DomainVocabularySchema as Y, ENTITY_ROLES as Z, type Effect as _, type EntityPersistence as a, OrbitalTraitRefSchema as a$, EffectSchema as a0, type EntityFieldInput as a1, EntityFieldSchema as a2, EntityPersistenceSchema as a3, type EntityRef as a4, EntityRefSchema as a5, EntityRefStringSchema as a6, type EntityRole as a7, EntityRoleSchema as a8, EntitySchema as a9, type GameSubCategory as aA, GameSubCategorySchema as aB, type GameType as aC, GameTypeSchema as aD, type Guard as aE, type GuardInput as aF, GuardSchema as aG, type McpServiceDef as aH, McpServiceDefSchema as aI, type NodeClassification as aJ, NodeClassificationSchema as aK, type OrbitalConfig as aL, type OrbitalConfigInput as aM, OrbitalConfigSchema as aN, OrbitalDefinitionSchema as aO, type OrbitalEntity as aP, type OrbitalEntityInput as aQ, OrbitalEntitySchema as aR, type OrbitalInput as aS, type OrbitalPage as aT, type OrbitalPageInput as aU, OrbitalPageSchema as aV, type OrbitalPageStrictInput as aW, OrbitalPageStrictSchema as aX, type OrbitalSchemaInput as aY, OrbitalSchemaSchema as aZ, type OrbitalTraitRef as a_, type EntitySemanticRole as aa, EntitySemanticRoleSchema as ab, type Event as ac, type EventInput as ad, type EventListener as ae, EventListenerSchema as af, type EventPayloadField as ag, EventPayloadFieldSchema as ah, EventSchema as ai, type EventScope as aj, EventScopeSchema as ak, type EventSemanticRole as al, EventSemanticRoleSchema as am, type EventSource as an, EventSourceSchema as ao, type Expression as ap, type ExpressionInput as aq, ExpressionSchema as ar, type Field as as, type FieldFormat as at, FieldFormatSchema as au, FieldSchema as av, type FieldType as aw, FieldTypeSchema as ax, type Orbital as ay, GAME_TYPES as az, type OrbitalSchema as b, ThemeRefSchema as b$, type OrbitalUnit as b0, OrbitalUnitSchema as b1, OrbitalSchema$1 as b2, type PageRef as b3, type PageRefObject as b4, PageRefObjectSchema as b5, PageRefSchema as b6, PageRefStringSchema as b7, PageSchema as b8, type PageTraitRef as b9, type SemanticAssetRef as bA, type SemanticAssetRefInput as bB, SemanticAssetRefSchema as bC, type ServiceDefinition as bD, ServiceDefinitionSchema as bE, type ServiceRef as bF, ServiceRefSchema as bG, ServiceRefStringSchema as bH, type ServiceType as bI, ServiceTypeSchema as bJ, type SocketEvents as bK, SocketEventsSchema as bL, type SocketServiceDef as bM, SocketServiceDefSchema as bN, type StateInput as bO, type StateMachine as bP, type StateMachineInput as bQ, StateMachineSchema as bR, StateSchema as bS, type StateSemanticRole as bT, StateSemanticRoleSchema as bU, type SuggestedGuard as bV, SuggestedGuardSchema as bW, type SwapEffect as bX, type ThemeDefinition as bY, ThemeDefinitionSchema as bZ, type ThemeRef as b_, PageTraitRefSchema as ba, type ParsedBinding as bb, type PayloadField as bc, PayloadFieldSchema as bd, type PresentationType as be, type RefEffect as bf, type RelatedLink as bg, RelatedLinkSchema as bh, type RelationConfig as bi, RelationConfigSchema as bj, type RenderUIConfig as bk, type RequiredField as bl, RequiredFieldSchema as bm, type ResolvedAsset as bn, type ResolvedAssetInput as bo, ResolvedAssetSchema as bp, type RestAuthConfig as bq, RestAuthConfigSchema as br, type RestServiceDef as bs, RestServiceDefSchema as bt, SERVICE_TYPES as bu, type SExpr as bv, type SExprAtom as bw, SExprAtomSchema as bx, type SExprInput as by, SExprSchema as bz, type Trait as c, isEffect as c$, ThemeRefStringSchema as c0, type ThemeTokens as c1, ThemeTokensSchema as c2, type ThemeVariant as c3, ThemeVariantSchema as c4, type TraitCategory as c5, TraitCategorySchema as c6, type TraitDataEntity as c7, TraitDataEntitySchema as c8, type TraitEntityField as c9, UserPersonaSchema as cA, VISUAL_STYLES as cB, type ViewType as cC, ViewTypeSchema as cD, type VisualStyle as cE, VisualStyleSchema as cF, type WatchEffect as cG, type WatchOptions as cH, atomic as cI, callService as cJ, collectBindings as cK, createAssetKey as cL, deref as cM, deriveCollection as cN, despawn as cO, doEffects as cP, emit as cQ, findService as cR, getArgs as cS, getDefaultAnimationsForRole as cT, getOperator as cU, getServiceNames as cV, getTraitConfig as cW, getTraitName as cX, hasService as cY, isBinding as cZ, isCircuitEvent as c_, TraitEntityFieldSchema as ca, TraitEventContractSchema as cb, type TraitEventListener as cc, TraitEventListenerSchema as cd, type TraitInput as ce, type TraitRef as cf, TraitRefSchema as cg, type TraitReference as ch, type TraitReferenceInput as ci, TraitReferenceSchema as cj, TraitSchema as ck, type TraitTick as cl, TraitTickSchema as cm, type TraitUIBinding as cn, type Transition as co, type TransitionInput as cp, TransitionSchema as cq, type UISlot as cr, UISlotSchema as cs, UI_SLOTS as ct, type UXHints as cu, UXHintsSchema as cv, type UseDeclaration as cw, UseDeclarationSchema as cx, type UserPersona as cy, type UserPersonaInput as cz, type Entity as d, isEntityReference as d0, isImportedTraitRef as d1, isInlineTrait as d2, isMcpService as d3, isOrbitalDefinition as d4, isPageReference as d5, isPageReferenceObject as d6, isPageReferenceString as d7, isRestService as d8, isRuntimeEntity as d9, spawn as dA, swap as dB, validateAssetAnimations as dC, walkSExpr as dD, watch as dE, isSExpr as da, isSExprAtom as db, isSExprCall as dc, isSExprEffect as dd, isServiceReference as de, isSingletonEntity as df, isSocketService as dg, isThemeReference as dh, isValidBinding as di, navigate as dj, normalizeTraitRef as dk, notify as dl, parseAssetKey as dm, parseBinding as dn, parseEntityRef as dp, parseImportedTraitRef as dq, parseOrbitalSchema as dr, parsePageRef as ds, parseServiceRef as dt, persist as du, ref as dv, renderUI as dw, safeParseOrbitalSchema as dx, set as dy, sexpr as dz, ALLOWED_CUSTOM_COMPONENTS as e, type AgentDomainCategory as f, AgentDomainCategorySchema as g, type AllowedCustomComponent as h, type AnimationDef as i, type AnimationDefInput as j, AnimationDefSchema as k, type AssetMap as l, type AssetMapInput as m, AssetMapSchema as n, type AssetMapping as o, type AssetMappingInput as p, AssetMappingSchema as q, type AtomicEffect as r, type CallServiceConfig as s, type ComputedEventContract as t, ComputedEventContractSchema as u, type ComputedEventListener as v, ComputedEventListenerSchema as w, type CoreBinding as x, type CustomPatternDefinition as y, type CustomPatternDefinitionInput as z };
+export { ENTITY_ROLES as $, AGENT_DOMAIN_CATEGORIES as A, type CustomPatternDefinition as B, CORE_BINDINGS as C, type CustomPatternDefinitionInput as D, type EntityField as E, CustomPatternDefinitionSchema as F, type CustomPatternMap as G, type CustomPatternMapInput as H, CustomPatternMapSchema as I, type DerefEffect as J, type DesignPreferences as K, type DesignPreferencesInput as L, DesignPreferencesSchema as M, type DesignTokens as N, type OrbitalDefinition as O, type Page as P, type DesignTokensInput as Q, DesignTokensSchema as R, type State as S, type TraitEventContract as T, type DomainCategory as U, DomainCategorySchema as V, type DomainContext as W, type DomainContextInput as X, DomainContextSchema as Y, type DomainVocabulary as Z, DomainVocabularySchema as _, type EntityPersistence as a, type OrbitalPageInput as a$, type Effect as a0, type EffectInput as a1, EffectSchema as a2, type EntityData as a3, type EntityFieldInput as a4, EntityFieldSchema as a5, EntityPersistenceSchema as a6, type EntityRef as a7, EntityRefSchema as a8, EntityRefStringSchema as a9, FieldSchema as aA, type FieldType as aB, FieldTypeSchema as aC, type FieldValue as aD, type Orbital as aE, GAME_TYPES as aF, type GameSubCategory as aG, GameSubCategorySchema as aH, type GameType as aI, GameTypeSchema as aJ, type Guard as aK, type GuardInput as aL, GuardSchema as aM, type LogMeta as aN, type McpServiceDef as aO, McpServiceDefSchema as aP, type NodeClassification as aQ, NodeClassificationSchema as aR, type OrbitalConfig as aS, type OrbitalConfigInput as aT, OrbitalConfigSchema as aU, OrbitalDefinitionSchema as aV, type OrbitalEntity as aW, type OrbitalEntityInput as aX, OrbitalEntitySchema as aY, type OrbitalInput as aZ, type OrbitalPage as a_, type EntityRole as aa, EntityRoleSchema as ab, EntitySchema as ac, type EntitySemanticRole as ad, EntitySemanticRoleSchema as ae, type EvalContext as af, type Event as ag, type EventInput as ah, type EventListener as ai, EventListenerSchema as aj, type EventPayload as ak, type EventPayloadField as al, EventPayloadFieldSchema as am, EventSchema as an, type EventScope as ao, EventScopeSchema as ap, type EventSemanticRole as aq, EventSemanticRoleSchema as ar, type EventSource as as, EventSourceSchema as at, type Expression as au, type ExpressionInput as av, ExpressionSchema as aw, type Field as ax, type FieldFormat as ay, FieldFormatSchema as az, type EntityRow as b, StateMachineSchema as b$, OrbitalPageSchema as b0, type OrbitalPageStrictInput as b1, OrbitalPageStrictSchema as b2, type OrbitalSchemaInput as b3, OrbitalSchemaSchema as b4, type OrbitalTraitRef as b5, OrbitalTraitRefSchema as b6, type OrbitalUnit as b7, OrbitalUnitSchema as b8, OrbitalSchema$1 as b9, RestAuthConfigSchema as bA, type RestServiceDef as bB, RestServiceDefSchema as bC, SERVICE_TYPES as bD, type SExpr as bE, type SExprAtom as bF, SExprAtomSchema as bG, type SExprInput as bH, SExprSchema as bI, type SemanticAssetRef as bJ, type SemanticAssetRefInput as bK, SemanticAssetRefSchema as bL, type ServiceDefinition as bM, ServiceDefinitionSchema as bN, type ServiceParams as bO, type ServiceRef as bP, ServiceRefSchema as bQ, ServiceRefStringSchema as bR, type ServiceType as bS, ServiceTypeSchema as bT, type SocketEvents as bU, SocketEventsSchema as bV, type SocketServiceDef as bW, SocketServiceDefSchema as bX, type StateInput as bY, type StateMachine as bZ, type StateMachineInput as b_, type PageRef as ba, type PageRefObject as bb, PageRefObjectSchema as bc, PageRefSchema as bd, PageRefStringSchema as be, PageSchema as bf, type PageTraitRef as bg, PageTraitRefSchema as bh, type ParsedBinding as bi, type PayloadField as bj, PayloadFieldSchema as bk, type PresentationType as bl, type RefEffect as bm, type RelatedLink as bn, RelatedLinkSchema as bo, type RelationConfig as bp, RelationConfigSchema as bq, type RenderUIConfig as br, type RenderUINode as bs, type RequiredField as bt, RequiredFieldSchema as bu, type ResolvedAsset as bv, type ResolvedAssetInput as bw, ResolvedAssetSchema as bx, type ResolvedPatternProps as by, type RestAuthConfig as bz, type OrbitalSchema as c, findService as c$, StateSchema as c0, type StateSemanticRole as c1, StateSemanticRoleSchema as c2, type SuggestedGuard as c3, SuggestedGuardSchema as c4, type SwapEffect as c5, type ThemeDefinition as c6, ThemeDefinitionSchema as c7, type ThemeRef as c8, ThemeRefSchema as c9, TransitionSchema as cA, type UISlot as cB, UISlotSchema as cC, UI_SLOTS as cD, type UXHints as cE, UXHintsSchema as cF, type UseDeclaration as cG, UseDeclarationSchema as cH, type UserPersona as cI, type UserPersonaInput as cJ, UserPersonaSchema as cK, VISUAL_STYLES as cL, type ViewType as cM, ViewTypeSchema as cN, type VisualStyle as cO, VisualStyleSchema as cP, type WatchEffect as cQ, type WatchOptions as cR, atomic as cS, callService as cT, collectBindings as cU, createAssetKey as cV, deref as cW, deriveCollection as cX, despawn as cY, doEffects as cZ, emit as c_, ThemeRefStringSchema as ca, type ThemeTokens as cb, ThemeTokensSchema as cc, type ThemeVariant as cd, ThemeVariantSchema as ce, type TraitCategory as cf, TraitCategorySchema as cg, type TraitDataEntity as ch, TraitDataEntitySchema as ci, type TraitEntityField as cj, TraitEntityFieldSchema as ck, TraitEventContractSchema as cl, type TraitEventListener as cm, TraitEventListenerSchema as cn, type TraitInput as co, type TraitRef as cp, TraitRefSchema as cq, type TraitReference as cr, type TraitReferenceInput as cs, TraitReferenceSchema as ct, TraitSchema as cu, type TraitTick as cv, TraitTickSchema as cw, type TraitUIBinding as cx, type Transition as cy, type TransitionInput as cz, type Trait as d, getArgs as d0, getDefaultAnimationsForRole as d1, getOperator as d2, getServiceNames as d3, getTraitConfig as d4, getTraitName as d5, hasService as d6, isBinding as d7, isCircuitEvent as d8, isEffect as d9, parseImportedTraitRef as dA, parseOrbitalSchema as dB, parsePageRef as dC, parseServiceRef as dD, persist as dE, ref as dF, renderUI as dG, safeParseOrbitalSchema as dH, set as dI, sexpr as dJ, spawn as dK, swap as dL, validateAssetAnimations as dM, walkSExpr as dN, watch as dO, isEntityReference as da, isImportedTraitRef as db, isInlineTrait as dc, isMcpService as dd, isOrbitalDefinition as de, isPageReference as df, isPageReferenceObject as dg, isPageReferenceString as dh, isRestService as di, isRuntimeEntity as dj, isSExpr as dk, isSExprAtom as dl, isSExprCall as dm, isSExprEffect as dn, isServiceReference as dp, isSingletonEntity as dq, isSocketService as dr, isThemeReference as ds, isValidBinding as dt, navigate as du, normalizeTraitRef as dv, notify as dw, parseAssetKey as dx, parseBinding as dy, parseEntityRef as dz, type Entity as e, ALLOWED_CUSTOM_COMPONENTS as f, type AgentDomainCategory as g, AgentDomainCategorySchema as h, type AgentEffect as i, type AllowedCustomComponent as j, type AnimationDef as k, type AnimationDefInput as l, AnimationDefSchema as m, type AssetMap as n, type AssetMapInput as o, AssetMapSchema as p, type AssetMapping as q, type AssetMappingInput as r, AssetMappingSchema as s, type AtomicEffect as t, type CallServiceConfig as u, type ComputedEventContract as v, ComputedEventContractSchema as w, type ComputedEventListener as x, ComputedEventListenerSchema as y, type CoreBinding as z };