@almadar/core 4.9.0 → 5.0.0

package/dist/{schema-BCEjl1a1.d.ts → schema-CfW0RBck.d.ts}

@@ -3330,11 +3330,32 @@ interface TraitUIBinding {
  * - `emits`: Events this trait can emit (with scope and payload schema)
  * - `listens`: Events this trait listens for (with optional payloadMapping)
  */
+/**
+ * Instance vs collection scope for a trait.
+ *
+ * Mirrors the `.lolo` trait modifier list (`[interaction, instance]` /
+ * `[interaction, collection]`). Instance traits own a single entity record
+ * (typed by `linkedEntity`) and read/write `@entity.field`. Collection
+ * traits render records of `linkedEntity` without owning any one; data flows
+ * through `@payload.data` typed as `Array<linkedEntity>`.
+ *
+ * Optional today. A future phase (Almadar_Entity_V2_Plan.md Phase 4) makes
+ * it required and adds static checks in the compiler.
+ */
+type TraitScope = 'instance' | 'collection';
 interface Trait {
     name: string;
     description?: string;
     description_visual_prompt?: string;
     category?: TraitCategory;
+    /**
+     * Instance or collection scope. Required in V2: every trait operates on
+     * either a single record (`instance`) or a group (`collection`). Drives
+     * payload-inference rules for emits declared via `type X = Event<T>` and
+     * shapes the runtime's binding semantics. Authored in `.lolo` as the
+     * `[instance]` / `[collection]` modifier on the trait header.
+     */
+    scope: TraitScope;
     /**
      * The entity this trait is linked to.
      * Required for inline trait definitions within an orbital.
@@ -3363,6 +3384,7 @@ declare const TraitSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     description_visual_prompt: z.ZodOptional<z.ZodString>;
     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"]>>;
+    scope: z.ZodEnum<["instance", "collection"]>;
     linkedEntity: z.ZodOptional<z.ZodString>;
     requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -3709,6 +3731,7 @@ declare const TraitSchema: z.ZodObject<{
     ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
+    scope: "instance" | "collection";
     ui?: Record<string, unknown> | 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;
@@ -3804,6 +3827,7 @@ declare const TraitSchema: z.ZodObject<{
     }[] | undefined;
 }, {
     name: string;
+    scope: "instance" | "collection";
     ui?: Record<string, unknown> | 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;
@@ -3921,6 +3945,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     description_visual_prompt: z.ZodOptional<z.ZodString>;
     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"]>>;
+    scope: z.ZodEnum<["instance", "collection"]>;
     linkedEntity: z.ZodOptional<z.ZodString>;
     requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -4267,6 +4292,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
+    scope: "instance" | "collection";
     ui?: Record<string, unknown> | 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;
@@ -4362,6 +4388,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }[] | undefined;
 }, {
     name: string;
+    scope: "instance" | "collection";
     ui?: Record<string, unknown> | 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;
@@ -4549,6 +4576,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     description_visual_prompt: z.ZodOptional<z.ZodString>;
     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"]>>;
+    scope: z.ZodEnum<["instance", "collection"]>;
     linkedEntity: z.ZodOptional<z.ZodString>;
     requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -4895,6 +4923,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
+    scope: "instance" | "collection";
     ui?: Record<string, unknown> | 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;
@@ -4990,6 +5019,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     }[] | undefined;
 }, {
     name: string;
+    scope: "instance" | "collection";
     ui?: Record<string, unknown> | 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;
@@ -6208,6 +6238,7 @@ declare const PageRefObjectSchema: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         description_visual_prompt: z.ZodOptional<z.ZodString>;
         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"]>>;
+        scope: z.ZodEnum<["instance", "collection"]>;
         linkedEntity: z.ZodOptional<z.ZodString>;
         requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
@@ -6554,6 +6585,7 @@ declare const PageRefObjectSchema: z.ZodObject<{
         ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -6649,6 +6681,7 @@ declare const PageRefObjectSchema: z.ZodObject<{
         }[] | undefined;
     }, {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -6749,6 +6782,7 @@ declare const PageRefObjectSchema: z.ZodObject<{
     linkedEntity?: string | undefined;
     traits?: (string | {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -6856,6 +6890,7 @@ declare const PageRefObjectSchema: z.ZodObject<{
     linkedEntity?: string | undefined;
     traits?: (string | {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -7030,6 +7065,7 @@ declare const PageRefSchema: z.ZodUnion<[z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         description_visual_prompt: z.ZodOptional<z.ZodString>;
         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"]>>;
+        scope: z.ZodEnum<["instance", "collection"]>;
         linkedEntity: z.ZodOptional<z.ZodString>;
         requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
@@ -7376,6 +7412,7 @@ declare const PageRefSchema: z.ZodUnion<[z.ZodObject<{
         ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -7471,6 +7508,7 @@ declare const PageRefSchema: z.ZodUnion<[z.ZodObject<{
         }[] | undefined;
     }, {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -7571,6 +7609,7 @@ declare const PageRefSchema: z.ZodUnion<[z.ZodObject<{
     linkedEntity?: string | undefined;
     traits?: (string | {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -7678,6 +7717,7 @@ declare const PageRefSchema: z.ZodUnion<[z.ZodObject<{
     linkedEntity?: string | undefined;
     traits?: (string | {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -8511,6 +8551,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         description_visual_prompt: z.ZodOptional<z.ZodString>;
         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"]>>;
+        scope: z.ZodEnum<["instance", "collection"]>;
         linkedEntity: z.ZodOptional<z.ZodString>;
         requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
@@ -8857,6 +8898,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -8952,6 +8994,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         }[] | undefined;
     }, {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -9118,6 +9161,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             description_visual_prompt: z.ZodOptional<z.ZodString>;
             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"]>>;
+            scope: z.ZodEnum<["instance", "collection"]>;
             linkedEntity: z.ZodOptional<z.ZodString>;
             requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
@@ -9464,6 +9508,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
             ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, "strip", z.ZodTypeAny, {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -9559,6 +9604,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
             }[] | undefined;
         }, {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -9659,6 +9705,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -9766,6 +9813,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -10137,6 +10185,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
     name: string;
     traits: (string | {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -10255,6 +10304,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -10513,6 +10563,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
     name: string;
     traits: (string | {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -10631,6 +10682,7 @@ declare const OrbitalDefinitionSchema: z.ZodObject<{
         linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -11214,6 +11266,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         description_visual_prompt: z.ZodOptional<z.ZodString>;
         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"]>>;
+        scope: z.ZodEnum<["instance", "collection"]>;
         linkedEntity: z.ZodOptional<z.ZodString>;
         requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
@@ -11560,6 +11613,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
         ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -11655,6 +11709,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
         }[] | undefined;
     }, {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -11821,6 +11876,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             description_visual_prompt: z.ZodOptional<z.ZodString>;
             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"]>>;
+            scope: z.ZodEnum<["instance", "collection"]>;
             linkedEntity: z.ZodOptional<z.ZodString>;
             requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
@@ -12167,6 +12223,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
             ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, "strip", z.ZodTypeAny, {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -12262,6 +12319,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
             }[] | undefined;
         }, {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -12362,6 +12420,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
         linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -12469,6 +12528,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
         linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -12840,6 +12900,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
     name: string;
     traits: (string | {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -12958,6 +13019,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
         linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -13216,6 +13278,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
     name: string;
     traits: (string | {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -13334,6 +13397,7 @@ declare const OrbitalSchema$1: z.ZodObject<{
         linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -13924,6 +13988,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         description_visual_prompt: z.ZodOptional<z.ZodString>;
         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"]>>;
+        scope: z.ZodEnum<["instance", "collection"]>;
         linkedEntity: z.ZodOptional<z.ZodString>;
         requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
@@ -14270,6 +14335,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -14365,6 +14431,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         }[] | undefined;
     }, {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -14531,6 +14598,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             description_visual_prompt: z.ZodOptional<z.ZodString>;
             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"]>>;
+            scope: z.ZodEnum<["instance", "collection"]>;
             linkedEntity: z.ZodOptional<z.ZodString>;
             requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
@@ -14877,6 +14945,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
             ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, "strip", z.ZodTypeAny, {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -14972,6 +15041,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
             }[] | undefined;
         }, {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -15072,6 +15142,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -15179,6 +15250,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -15550,6 +15622,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
     name: string;
     traits: (string | {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -15668,6 +15741,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -15926,6 +16000,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
     name: string;
     traits: (string | {
         name: string;
+        scope: "instance" | "collection";
         ui?: Record<string, unknown> | 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;
@@ -16044,6 +16119,7 @@ declare const OrbitalUnitSchema: z.ZodObject<{
         linkedEntity?: string | undefined;
         traits?: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -16875,6 +16951,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             description_visual_prompt: z.ZodOptional<z.ZodString>;
             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"]>>;
+            scope: z.ZodEnum<["instance", "collection"]>;
             linkedEntity: z.ZodOptional<z.ZodString>;
             requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
@@ -17221,6 +17298,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, "strip", z.ZodTypeAny, {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -17316,6 +17394,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             }[] | undefined;
         }, {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -17482,6 +17561,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
                 description: z.ZodOptional<z.ZodString>;
                 description_visual_prompt: z.ZodOptional<z.ZodString>;
                 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"]>>;
+                scope: z.ZodEnum<["instance", "collection"]>;
                 linkedEntity: z.ZodOptional<z.ZodString>;
                 requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     name: z.ZodString;
@@ -17828,6 +17908,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
                 ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             }, "strip", z.ZodTypeAny, {
                 name: string;
+                scope: "instance" | "collection";
                 ui?: Record<string, unknown> | 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;
@@ -17923,6 +18004,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
                 }[] | undefined;
             }, {
                 name: string;
+                scope: "instance" | "collection";
                 ui?: Record<string, unknown> | 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;
@@ -18023,6 +18105,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             linkedEntity?: string | undefined;
             traits?: (string | {
                 name: string;
+                scope: "instance" | "collection";
                 ui?: Record<string, unknown> | 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;
@@ -18130,6 +18213,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             linkedEntity?: string | undefined;
             traits?: (string | {
                 name: string;
+                scope: "instance" | "collection";
                 ui?: Record<string, unknown> | 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;
@@ -18501,6 +18585,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         name: string;
         traits: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -18619,6 +18704,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             linkedEntity?: string | undefined;
             traits?: (string | {
                 name: string;
+                scope: "instance" | "collection";
                 ui?: Record<string, unknown> | 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;
@@ -18877,6 +18963,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         name: string;
         traits: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -18995,6 +19082,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             linkedEntity?: string | undefined;
             traits?: (string | {
                 name: string;
+                scope: "instance" | "collection";
                 ui?: Record<string, unknown> | 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;
@@ -19431,6 +19519,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         name: string;
         traits: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -19549,6 +19638,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             linkedEntity?: string | undefined;
             traits?: (string | {
                 name: string;
+                scope: "instance" | "collection";
                 ui?: Record<string, unknown> | 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;
@@ -19896,6 +19986,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
         name: string;
         traits: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -20014,6 +20105,7 @@ declare const OrbitalSchemaSchema: z.ZodObject<{
             linkedEntity?: string | undefined;
             traits?: (string | {
                 name: string;
+                scope: "instance" | "collection";
                 ui?: Record<string, unknown> | 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;
@@ -20408,6 +20500,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
         name: string;
         traits: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -20526,6 +20619,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
             linkedEntity?: string | undefined;
             traits?: (string | {
                 name: string;
+                scope: "instance" | "collection";
                 ui?: Record<string, unknown> | 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;
@@ -20873,6 +20967,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
         name: string;
         traits: (string | {
             name: string;
+            scope: "instance" | "collection";
             ui?: Record<string, unknown> | 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;
@@ -20991,6 +21086,7 @@ declare function safeParseOrbitalSchema(data: unknown): z.SafeParseReturnType<{
             linkedEntity?: string | undefined;
             traits?: (string | {
                 name: string;
+                scope: "instance" | "collection";
                 ui?: Record<string, unknown> | 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;