@almadar/core 2.9.1 → 2.12.0

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

@@ -191,6 +191,14 @@ 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. */
+type EventPayload = Record<string, string | number | boolean | null | undefined>;
+/** Structured log/event metadata. Constrains values to serializable types. */
+type LogMeta = Record<string, string | number | boolean | null | undefined | Error>;
 
 /**
  * Field Types for Orbital Units
@@ -693,8 +701,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.
  *
@@ -725,7 +733,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 +762,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 +780,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 +801,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 +830,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 +848,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 +906,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
@@ -1108,15 +1143,6 @@ declare const PageSchema: z.ZodObject<{
     isInitial?: boolean | undefined;
 }>;
 
-/**
- * Effect Types (Self-Contained)
- *
- * Defines effect types for trait transitions and ticks.
- * Effects are S-expressions (arrays) that describe actions to perform.
- *
- * @packageDocumentation
- */
-
 /**
  * Known UI slots where content can be rendered
  */
@@ -1299,6 +1325,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 +1375,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 +1591,15 @@ 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;
+/** A node in a render-ui effect tree. */
+interface RenderUINode {
+    type: string;
+    props?: Record<string, FieldValue | string | undefined>;
+    children?: RenderUINode[];
+    content?: string;
+    entity?: string;
+    renderItem?: RenderUINode;
+}
 
 /**
  * Represents a state in the state machine
@@ -1975,8 +2018,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 +2437,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 +2785,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 +2880,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 +2989,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 +3337,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 +3432,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 +3611,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 +3959,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 +4054,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 +5496,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 +5582,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 +5611,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 +5629,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 +6394,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 +6423,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 +6441,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 +6472,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 +6820,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 +6915,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 +7306,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 +7326,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 +7564,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 +7583,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 +8034,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 +8063,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 +8081,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 +8112,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 +8460,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 +8555,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 +8946,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 +8966,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 +9204,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 +9223,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 +9681,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 +9710,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 +9728,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 +9759,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 +10107,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 +10202,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 +10593,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 +10613,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 +10851,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 +10870,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 +11569,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 +11598,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 +11616,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 +11647,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 +11995,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 +12090,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 +12481,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 +12501,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 +12739,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 +12758,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 +13173,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 +13193,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 +13520,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 +13539,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 +13913,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 +13932,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 +14258,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 +14278,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 +14603,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 { type Effect as $, AGENT_DOMAIN_CATEGORIES as A, type CustomPatternDefinitionInput as B, CORE_BINDINGS as C, CustomPatternDefinitionSchema as D, type EntityField as E, type CustomPatternMap as F, type CustomPatternMapInput as G, CustomPatternMapSchema as H, type DerefEffect as I, type DesignPreferences as J, type DesignPreferencesInput as K, DesignPreferencesSchema as L, type DesignTokens as M, type DesignTokensInput as N, type OrbitalDefinition as O, type Page as P, DesignTokensSchema as Q, type DomainCategory as R, type State as S, type TraitEventContract as T, DomainCategorySchema as U, type DomainContext as V, type DomainContextInput as W, DomainContextSchema as X, type DomainVocabulary as Y, DomainVocabularySchema as Z, ENTITY_ROLES as _, type EntityPersistence as a, type OrbitalPageInput as a$, type EffectInput as a0, EffectSchema as a1, type EntityData as a2, type EntityFieldInput as a3, EntityFieldSchema as a4, EntityPersistenceSchema as a5, type EntityRef as a6, EntityRefSchema as a7, EntityRefStringSchema as a8, type EntityRole 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_, EntityRoleSchema as aa, type EntityRow 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 OrbitalSchema as b, StateSchema 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, type RestServiceDef as bA, RestServiceDefSchema as bB, SERVICE_TYPES as bC, type SExpr as bD, type SExprAtom as bE, SExprAtomSchema as bF, type SExprInput as bG, SExprSchema as bH, type SemanticAssetRef as bI, type SemanticAssetRefInput as bJ, SemanticAssetRefSchema as bK, type ServiceDefinition as bL, ServiceDefinitionSchema as bM, type ServiceParams as bN, type ServiceRef as bO, ServiceRefSchema as bP, ServiceRefStringSchema as bQ, type ServiceType as bR, ServiceTypeSchema as bS, type SocketEvents as bT, SocketEventsSchema as bU, type SocketServiceDef as bV, SocketServiceDefSchema as bW, type StateInput as bX, type StateMachine as bY, type StateMachineInput as bZ, StateMachineSchema 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 RestAuthConfig as by, RestAuthConfigSchema as bz, type Trait as c, getArgs as c$, type StateSemanticRole as c0, StateSemanticRoleSchema as c1, type SuggestedGuard as c2, SuggestedGuardSchema as c3, type SwapEffect as c4, type ThemeDefinition as c5, ThemeDefinitionSchema as c6, type ThemeRef as c7, ThemeRefSchema as c8, ThemeRefStringSchema as c9, type UISlot as cA, UISlotSchema as cB, UI_SLOTS as cC, type UXHints as cD, UXHintsSchema as cE, type UseDeclaration as cF, UseDeclarationSchema as cG, type UserPersona as cH, type UserPersonaInput as cI, UserPersonaSchema as cJ, VISUAL_STYLES as cK, type ViewType as cL, ViewTypeSchema as cM, type VisualStyle as cN, VisualStyleSchema as cO, type WatchEffect as cP, type WatchOptions as cQ, atomic as cR, callService as cS, collectBindings as cT, createAssetKey as cU, deref as cV, deriveCollection as cW, despawn as cX, doEffects as cY, emit as cZ, findService as c_, type ThemeTokens as ca, ThemeTokensSchema as cb, type ThemeVariant as cc, ThemeVariantSchema as cd, type TraitCategory as ce, TraitCategorySchema as cf, type TraitDataEntity as cg, TraitDataEntitySchema as ch, type TraitEntityField as ci, TraitEntityFieldSchema as cj, TraitEventContractSchema as ck, type TraitEventListener as cl, TraitEventListenerSchema as cm, type TraitInput as cn, type TraitRef as co, TraitRefSchema as cp, type TraitReference as cq, type TraitReferenceInput as cr, TraitReferenceSchema as cs, TraitSchema as ct, type TraitTick as cu, TraitTickSchema as cv, type TraitUIBinding as cw, type Transition as cx, type TransitionInput as cy, TransitionSchema as cz, type Entity as d, getDefaultAnimationsForRole as d0, getOperator as d1, getServiceNames as d2, getTraitConfig as d3, getTraitName as d4, hasService as d5, isBinding as d6, isCircuitEvent as d7, isEffect as d8, isEntityReference as d9, parseOrbitalSchema as dA, parsePageRef as dB, parseServiceRef as dC, persist as dD, ref as dE, renderUI as dF, safeParseOrbitalSchema as dG, set as dH, sexpr as dI, spawn as dJ, swap as dK, validateAssetAnimations as dL, walkSExpr as dM, watch as dN, isImportedTraitRef as da, isInlineTrait as db, isMcpService as dc, isOrbitalDefinition as dd, isPageReference as de, isPageReferenceObject as df, isPageReferenceString as dg, isRestService as dh, isRuntimeEntity as di, isSExpr as dj, isSExprAtom as dk, isSExprCall as dl, isSExprEffect as dm, isServiceReference as dn, isSingletonEntity as dp, isSocketService as dq, isThemeReference as dr, isValidBinding as ds, navigate as dt, normalizeTraitRef as du, notify as dv, parseAssetKey as dw, parseBinding as dx, parseEntityRef as dy, parseImportedTraitRef as dz, ALLOWED_CUSTOM_COMPONENTS as e, type AgentDomainCategory as f, AgentDomainCategorySchema as g, type AgentEffect as h, type AllowedCustomComponent as i, type AnimationDef as j, type AnimationDefInput as k, AnimationDefSchema as l, type AssetMap as m, type AssetMapInput as n, AssetMapSchema as o, type AssetMapping as p, type AssetMappingInput as q, AssetMappingSchema as r, type AtomicEffect as s, type CallServiceConfig as t, type ComputedEventContract as u, ComputedEventContractSchema as v, type ComputedEventListener as w, ComputedEventListenerSchema as x, type CoreBinding as y, type CustomPatternDefinition as z };