@almadar/core 10.29.0 → 10.30.0

package/dist/{trait-B_CzfDSi.d.ts → trait-CwWjkU-1.d.ts}

@@ -1,4 +1,4 @@
-import { A as AnyPatternConfig, b as EntityRow, c as Entity, E as EntityField } from './pattern-types-JZordBZv.js';
+import { A as AnyPatternConfig, b as EntityRow, c as EventId, T as TraitId, O as OrbitalId, d as EntityId, P as PageId, e as Entity, E as EntityField } from './pattern-types-CLcOXOmW.js';
 import { S as SExpr, E as EventPayload, a as Expression } from './expression-CB9R3KWk.js';
 import { z } from 'zod';
 
@@ -800,6 +800,17 @@ type RenderUIEffect = ['render-ui', UISlot, AnyPatternConfig] | ['render-ui', UI
  * @example ["fn", "item", { "type": "stack", "children": [{ "type": "typography", "content": "@item.title" }] }]
  */
 type RenderItemLambda = ['fn', string, AnyPatternConfig];
+/**
+ * Dynamic-collection children entry: renders one child per item of a collection
+ * expression, authored inline in a `children:` position and kept verbatim as IR
+ * (no new node kind). The collection expression is an {@link SExpr} evaluated at
+ * render time; the {@link RenderItemLambda} body is instantiated per item with
+ * the lambda param bound as an `@item`-scope binding. Both execution paths lower
+ * onto the one lambda + `@item` + splice machinery.
+ *
+ * @example ["array/map", "@entity.tasks", ["fn", "item", { "type": "typography", "content": "@item.title" }]]
+ */
+type RenderChildrenMap = ['array/map', SExpr, RenderItemLambda];
 /**
  * Navigate effect - navigates to an internal page path or an external URL.
  * @example ['navigate', '/tasks'] or ['navigate', '/tasks/:id', { id: '123' }]
@@ -1433,7 +1444,10 @@ interface ResolvedPatternProps {
 interface RenderUINode {
     type: string;
     props?: ResolvedPatternProps;
-    children?: RenderUINode[];
+    /** Static child nodes and/or dynamic-collection map entries. A
+     *  {@link RenderChildrenMap} entry expands at render time into resolved
+     *  `RenderUINode`s, so components always receive a flat, fully-resolved list. */
+    children?: Array<RenderUINode | RenderChildrenMap>;
     content?: string;
     entity?: string;
     renderItem?: RenderUINode;
@@ -1507,6 +1521,8 @@ declare const PayloadFieldSchema: z.ZodType<PayloadField>;
 interface Event {
     /** Event key (UPPER_SNAKE_CASE) */
     key: string;
+    /** V4 dual-carry id sibling of `key` — optional until the Phase-7 flip. */
+    id?: EventId;
     /** Human-readable name */
     name: string;
     /** Description (authored `@description` on the emit/listen). */
@@ -1525,6 +1541,7 @@ interface Event {
 }
 declare const EventSchema: z.ZodObject<{
     key: z.ZodString;
+    id: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     synonyms: z.ZodOptional<z.ZodString>;
@@ -1535,6 +1552,7 @@ declare const EventSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     key: string;
+    id?: EventId | undefined;
     description?: string | undefined;
     synonyms?: string | undefined;
     tier?: string | undefined;
@@ -1544,6 +1562,7 @@ declare const EventSchema: z.ZodObject<{
 }, {
     name: string;
     key: string;
+    id?: string | undefined;
     description?: string | undefined;
     synonyms?: string | undefined;
     tier?: string | undefined;
@@ -1604,6 +1623,8 @@ interface Transition {
     to: string;
     /** Event key that triggers this transition */
     event: string;
+    /** V4 dual-carry id sibling of `event` — optional until the Phase-7 flip. */
+    eventId?: EventId;
     /** Guard expression - S-expression array */
     guard?: Expression | null;
     /** Effects to execute - S-expression arrays */
@@ -1615,6 +1636,7 @@ declare const TransitionSchema: z.ZodObject<{
     from: z.ZodString;
     to: z.ZodString;
     event: z.ZodString;
+    eventId: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
     guard: z.ZodOptional<z.ZodNullable<z.ZodType<SExpr, z.ZodTypeDef, SExpr>>>;
     effects: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodUnknown, "many">, unknown[], unknown[]>, "many">>;
     description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1623,6 +1645,7 @@ declare const TransitionSchema: z.ZodObject<{
     from: string;
     to: string;
     description?: string | null | undefined;
+    eventId?: EventId | undefined;
     guard?: SExpr | undefined;
     effects?: unknown[][] | undefined;
 }, {
@@ -1630,6 +1653,7 @@ declare const TransitionSchema: z.ZodObject<{
     from: string;
     to: string;
     description?: string | null | undefined;
+    eventId?: string | undefined;
     guard?: SExpr | undefined;
     effects?: unknown[][] | undefined;
 }>;
@@ -1674,6 +1698,7 @@ declare const StateMachineSchema: z.ZodObject<{
     }>, "many">;
     events: z.ZodArray<z.ZodObject<{
         key: z.ZodString;
+        id: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         synonyms: z.ZodOptional<z.ZodString>;
@@ -1684,6 +1709,7 @@ declare const StateMachineSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         name: string;
         key: string;
+        id?: EventId | undefined;
         description?: string | undefined;
         synonyms?: string | undefined;
         tier?: string | undefined;
@@ -1693,6 +1719,7 @@ declare const StateMachineSchema: z.ZodObject<{
     }, {
         name: string;
         key: string;
+        id?: string | undefined;
         description?: string | undefined;
         synonyms?: string | undefined;
         tier?: string | undefined;
@@ -1704,6 +1731,7 @@ declare const StateMachineSchema: z.ZodObject<{
         from: z.ZodString;
         to: z.ZodString;
         event: z.ZodString;
+        eventId: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
         guard: z.ZodOptional<z.ZodNullable<z.ZodType<SExpr, z.ZodTypeDef, SExpr>>>;
         effects: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodUnknown, "many">, unknown[], unknown[]>, "many">>;
         description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1712,6 +1740,7 @@ declare const StateMachineSchema: z.ZodObject<{
         from: string;
         to: string;
         description?: string | null | undefined;
+        eventId?: EventId | undefined;
         guard?: SExpr | undefined;
         effects?: unknown[][] | undefined;
     }, {
@@ -1719,6 +1748,7 @@ declare const StateMachineSchema: z.ZodObject<{
         from: string;
         to: string;
         description?: string | null | undefined;
+        eventId?: string | undefined;
         guard?: SExpr | undefined;
         effects?: unknown[][] | undefined;
     }>, "many">;
@@ -1739,6 +1769,7 @@ declare const StateMachineSchema: z.ZodObject<{
     events: {
         name: string;
         key: string;
+        id?: EventId | undefined;
         description?: string | undefined;
         synonyms?: string | undefined;
         tier?: string | undefined;
@@ -1760,6 +1791,7 @@ declare const StateMachineSchema: z.ZodObject<{
         from: string;
         to: string;
         description?: string | null | undefined;
+        eventId?: EventId | undefined;
         guard?: SExpr | undefined;
         effects?: unknown[][] | undefined;
     }[];
@@ -1772,6 +1804,7 @@ declare const StateMachineSchema: z.ZodObject<{
     events: {
         name: string;
         key: string;
+        id?: string | undefined;
         description?: string | undefined;
         synonyms?: string | undefined;
         tier?: string | undefined;
@@ -1793,6 +1826,7 @@ declare const StateMachineSchema: z.ZodObject<{
         from: string;
         to: string;
         description?: string | null | undefined;
+        eventId?: string | undefined;
         guard?: SExpr | undefined;
         effects?: unknown[][] | undefined;
     }[];
@@ -1900,9 +1934,29 @@ declare function normalizeCallSiteConfigToValues(config: CallSiteConfig | undefi
  * the enum member list through lowering — consumed by config-driven UI
  * (e.g. the playground property inspector) to render typed controls.
  */
+/**
+ * The reference config-field types (V4-W5). A config knob typed `entity`,
+ * `trait`, or `event` holds a REFERENCE (an entity/trait/event name), not a
+ * plain value — so the stamp records the referenced node's id on the field
+ * (`ConfigFieldDeclaration.refId`) and both execution paths resolve the value to
+ * the node's CURRENT name by id, exactly like `entityRefIds`/`traitEmbedIds`.
+ * This is the deterministic, source-tagged contract that lets a declaration-only
+ * rename flow through a config value without any name-scanning heuristic.
+ */
+declare const REFERENCE_CONFIG_TYPES: readonly ["entity", "trait", "event"];
+type ReferenceConfigType = (typeof REFERENCE_CONFIG_TYPES)[number];
+/** True when a config field's `type` marks its value as an entity/trait/event reference. */
+declare function isReferenceConfigType(type: string): type is ReferenceConfigType;
 interface ConfigFieldDeclaration {
     readonly type: string;
     readonly default?: TraitConfigValue;
+    /**
+     * V4-W5 dual-carry id — set by the stamp when `type` is a reference config
+     * type (`entity`/`trait`/`event`): the stable id of the entity/trait/event
+     * the field's value names. Readers resolve the value to that node's current
+     * name by id (rename-proof); absent for non-reference fields.
+     */
+    readonly refId?: string;
     /** Marks the knob as mandatory at every call site (own-page binding exempt). `required` + `default` may coexist — the default only serves the trait's own demo page. */
     readonly required?: boolean;
     /** `@label` — human-readable control label. */
@@ -2012,6 +2066,8 @@ interface TraitTick {
     interval: string | number;
     appliesTo?: string[];
     pages?: string[];
+    /** V4 dual-carry id sibling of `pages` — optional until the Phase-7 flip. */
+    pageIds?: PageId[];
     /** Guard expression - string (legacy) or S-expression array */
     guard?: Expression;
     /** Effects to execute (S-expressions) */
@@ -2022,6 +2078,8 @@ interface TraitTick {
      * Used for validation and documentation.
      */
     emits?: string[];
+    /** V4 dual-carry id sibling of `emits` — optional until the Phase-7 flip. */
+    emitIds?: EventId[];
 }
 declare const TraitTickSchema: z.ZodObject<{
     name: z.ZodString;
@@ -2030,9 +2088,11 @@ declare const TraitTickSchema: z.ZodObject<{
     interval: z.ZodUnion<[z.ZodLiteral<"frame">, z.ZodNumber]>;
     appliesTo: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     pages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    pageIds: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, PageId, string>, "many">>;
     guard: z.ZodOptional<z.ZodType<SExpr, z.ZodTypeDef, SExpr>>;
     effects: z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodUnknown, "many">, unknown[], unknown[]>, "many">;
     emits: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    emitIds: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, EventId, string>, "many">>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     effects: unknown[][];
@@ -2042,7 +2102,9 @@ declare const TraitTickSchema: z.ZodObject<{
     guard?: SExpr | undefined;
     priority?: number | undefined;
     appliesTo?: string[] | undefined;
+    pageIds?: PageId[] | undefined;
     emits?: string[] | undefined;
+    emitIds?: EventId[] | undefined;
 }, {
     name: string;
     effects: unknown[][];
@@ -2052,7 +2114,9 @@ declare const TraitTickSchema: z.ZodObject<{
     guard?: SExpr | undefined;
     priority?: number | undefined;
     appliesTo?: string[] | undefined;
+    pageIds?: string[] | undefined;
     emits?: string[] | undefined;
+    emitIds?: string[] | undefined;
 }>;
 /**
  * Event scope determines visibility:
@@ -2097,6 +2161,8 @@ declare const EventPayloadFieldSchema: z.ZodType<EventPayloadField>;
 interface TraitEventContract {
     /** Event name (UPPER_SNAKE_CASE) */
     event: string;
+    /** V4 dual-carry id sibling of `event` — optional until the Phase-7 flip. */
+    eventId?: EventId;
     /** Human-readable description */
     description?: string;
     /** User-vocabulary synonyms (comma-separated) — the per-event analogue of a
@@ -2153,6 +2219,7 @@ declare const TraitEventContractSchema: z.ZodObject<{
      * knob's effective literal before codegen/runtime consume it.
      */
     event: z.ZodString;
+    eventId: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
     description: z.ZodOptional<z.ZodString>;
     synonyms: z.ZodOptional<z.ZodString>;
     tier: z.ZodOptional<z.ZodString>;
@@ -2165,6 +2232,7 @@ declare const TraitEventContractSchema: z.ZodObject<{
     scope?: "internal" | "external" | undefined;
     tier?: string | undefined;
     payloadSchema?: EventPayloadField[] | undefined;
+    eventId?: EventId | undefined;
 }, {
     event: string;
     description?: string | undefined;
@@ -2172,6 +2240,7 @@ declare const TraitEventContractSchema: z.ZodObject<{
     scope?: "internal" | "external" | undefined;
     tier?: string | undefined;
     payloadSchema?: EventPayloadField[] | undefined;
+    eventId?: string | undefined;
 }>;
 /**
  * Event listener for trait communication.
@@ -2196,10 +2265,16 @@ type ListenSource = {
 } | {
     kind: 'trait';
     trait: string;
+    /** V4 dual-carry id sibling of `trait` — optional until the Phase-7 flip. */
+    traitId?: TraitId;
 } | {
     kind: 'orbital';
     orbital: string;
     trait: string;
+    /** V4 dual-carry id sibling of `orbital` — optional until the Phase-7 flip. */
+    orbitalId?: OrbitalId;
+    /** V4 dual-carry id sibling of `trait` — optional until the Phase-7 flip. */
+    traitId?: TraitId;
 };
 declare const ListenSourceSchema: z.ZodUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"any">;
@@ -2210,30 +2285,43 @@ declare const ListenSourceSchema: z.ZodUnion<[z.ZodObject<{
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"trait">;
     trait: z.ZodString;
+    traitId: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
 }, "strip", z.ZodTypeAny, {
     trait: string;
     kind: "trait";
+    traitId?: TraitId | undefined;
 }, {
     trait: string;
     kind: "trait";
+    traitId?: string | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"orbital">;
     orbital: z.ZodString;
     trait: z.ZodString;
+    orbitalId: z.ZodOptional<z.ZodEffects<z.ZodString, OrbitalId, string>>;
+    traitId: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
 }, "strip", z.ZodTypeAny, {
+    orbital: string;
     trait: string;
     kind: "orbital";
-    orbital: string;
+    traitId?: TraitId | undefined;
+    orbitalId?: OrbitalId | undefined;
 }, {
+    orbital: string;
     trait: string;
     kind: "orbital";
-    orbital: string;
+    traitId?: string | undefined;
+    orbitalId?: string | undefined;
 }>]>;
 interface TraitEventListener {
     /** Event key to listen for (bare event name, no source prefix in the new shape) */
     event: string;
+    /** V4 dual-carry id sibling of `event` — optional until the Phase-7 flip. */
+    eventId?: EventId;
     /** State machine event to trigger */
     triggers: string;
+    /** V4 dual-carry id sibling of `triggers` — optional until the Phase-7 flip. */
+    triggersId?: EventId;
     /** Human-readable description (authored `@description` on the listen). */
     description?: string;
     /** User-vocabulary synonyms (comma-separated). */
@@ -2258,7 +2346,9 @@ interface TraitEventListener {
 }
 declare const TraitEventListenerSchema: z.ZodObject<{
     event: z.ZodString;
+    eventId: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
     triggers: z.ZodString;
+    triggersId: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
     description: z.ZodOptional<z.ZodString>;
     synonyms: z.ZodOptional<z.ZodString>;
     tier: z.ZodOptional<z.ZodString>;
@@ -2274,24 +2364,33 @@ declare const TraitEventListenerSchema: z.ZodObject<{
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"trait">;
         trait: z.ZodString;
+        traitId: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
     }, "strip", z.ZodTypeAny, {
         trait: string;
         kind: "trait";
+        traitId?: TraitId | undefined;
     }, {
         trait: string;
         kind: "trait";
+        traitId?: string | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"orbital">;
         orbital: z.ZodString;
         trait: z.ZodString;
+        orbitalId: z.ZodOptional<z.ZodEffects<z.ZodString, OrbitalId, string>>;
+        traitId: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
     }, "strip", z.ZodTypeAny, {
+        orbital: string;
         trait: string;
         kind: "orbital";
-        orbital: string;
+        traitId?: TraitId | undefined;
+        orbitalId?: OrbitalId | undefined;
     }, {
+        orbital: string;
         trait: string;
         kind: "orbital";
-        orbital: string;
+        traitId?: string | undefined;
+        orbitalId?: string | undefined;
     }>]>>;
 }, "strip", z.ZodTypeAny, {
     event: string;
@@ -2303,14 +2402,19 @@ declare const TraitEventListenerSchema: z.ZodObject<{
     } | {
         trait: string;
         kind: "trait";
+        traitId?: TraitId | undefined;
     } | {
+        orbital: string;
         trait: string;
         kind: "orbital";
-        orbital: string;
+        traitId?: TraitId | undefined;
+        orbitalId?: OrbitalId | undefined;
     } | undefined;
     scope?: "internal" | "external" | undefined;
     tier?: string | undefined;
+    eventId?: EventId | undefined;
     guard?: SExpr | undefined;
+    triggersId?: EventId | undefined;
     payloadMapping?: Record<string, string> | undefined;
 }, {
     event: string;
@@ -2322,14 +2426,19 @@ declare const TraitEventListenerSchema: z.ZodObject<{
     } | {
         trait: string;
         kind: "trait";
+        traitId?: string | undefined;
     } | {
+        orbital: string;
         trait: string;
         kind: "orbital";
-        orbital: string;
+        traitId?: string | undefined;
+        orbitalId?: string | undefined;
     } | undefined;
     scope?: "internal" | "external" | undefined;
     tier?: string | undefined;
+    eventId?: string | undefined;
     guard?: SExpr | undefined;
+    triggersId?: string | undefined;
     payloadMapping?: Record<string, string> | undefined;
 }>;
 /**
@@ -2345,11 +2454,11 @@ declare const RequiredFieldSchema: z.ZodObject<{
     type: z.ZodEnum<["string", "number", "boolean", "date", "array", "object", "timestamp", "datetime", "enum"]>;
     description: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    type: "string" | "number" | "boolean" | "object" | "date" | "timestamp" | "datetime" | "array" | "enum";
+    type: "string" | "number" | "boolean" | "object" | "date" | "array" | "timestamp" | "datetime" | "enum";
     name: string;
     description?: string | undefined;
 }, {
-    type: "string" | "number" | "boolean" | "object" | "date" | "timestamp" | "datetime" | "array" | "enum";
+    type: "string" | "number" | "boolean" | "object" | "date" | "array" | "timestamp" | "datetime" | "enum";
     name: string;
     description?: string | undefined;
 }>;
@@ -2363,6 +2472,16 @@ declare const RequiredFieldSchema: z.ZodObject<{
  */
 interface TraitReference {
     ref: string;
+    /** V4 dual-carry id sibling of `ref` — optional until the Phase-7 flip. */
+    refId?: TraitId;
+    /**
+     * V4 LOCAL DECLARATION id — the identity of this trait AS DECLARED in its
+     * orbital (`trait X = Alias.traits.Y` declares node X; `refId` carries
+     * Y's id). Minted by the stamp so page trait refs and `@trait.X` embeds
+     * resolve by id across `name:` renames (the composed-organism surface was
+     * the one declaration class without an id).
+     */
+    id?: TraitId;
     /**
      * Phase 1.2: optional registry path disambiguator. Pairs with `ref` to
      * explicitly name which `uses` entry the alias was imported from
@@ -2372,10 +2491,14 @@ interface TraitReference {
      */
     from?: string;
     linkedEntity?: string;
+    /** V4 dual-carry id sibling of `linkedEntity` — optional until the Phase-7 flip. */
+    linkedEntityId?: EntityId;
     /** Phase F: rename the inlined trait at the call site */
     name?: string;
     /** Phase F: rename atom event keys at the call site, e.g. {OPEN: "ADD_ITEM"} */
     events?: Record<string, string>;
+    /** V4 dual-carry id sibling of `events` (keys = baked event names resolved to ids) — optional until the Phase-7 flip. */
+    eventIds?: Record<string, EventId>;
     /**
      * Entity-field remap: rewrite the inlined trait's canonical `@entity.X` /
      * `@payload.row.X` field references to the consumer entity's field names,
@@ -2439,10 +2562,14 @@ interface TraitReference {
 }
 declare const TraitReferenceSchema: z.ZodEffects<z.ZodObject<{
     ref: z.ZodString;
+    refId: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
+    id: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
     from: z.ZodOptional<z.ZodString>;
     linkedEntity: z.ZodOptional<z.ZodString>;
+    linkedEntityId: z.ZodOptional<z.ZodEffects<z.ZodString, EntityId, string>>;
     name: z.ZodOptional<z.ZodString>;
     events: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    eventIds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, EventId, string>>>;
     fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodType<ConfigFieldDeclaration, z.ZodTypeDef, ConfigFieldDeclaration>, z.ZodType<TraitConfigValue, z.ZodTypeDef, TraitConfigValue>]>>>;
     appliesTo: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -2451,50 +2578,66 @@ declare const TraitReferenceSchema: z.ZodEffects<z.ZodObject<{
     effects: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown, "many">>>;
 }, "strip", z.ZodTypeAny, {
     ref: string;
+    id?: TraitId | undefined;
+    from?: string | undefined;
     name?: string | undefined;
     fields?: Record<string, string> | undefined;
     config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     events?: Record<string, string> | undefined;
-    from?: string | undefined;
     effects?: Record<string, unknown[]> | undefined;
+    refId?: TraitId | undefined;
     appliesTo?: string[] | undefined;
     linkedEntity?: string | undefined;
+    linkedEntityId?: EntityId | undefined;
+    eventIds?: Record<string, EventId> | undefined;
     listens?: unknown[] | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }, {
     ref: string;
+    id?: string | undefined;
+    from?: string | undefined;
     name?: string | undefined;
     fields?: Record<string, string> | undefined;
     config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     events?: Record<string, string> | undefined;
-    from?: string | undefined;
     effects?: Record<string, unknown[]> | undefined;
+    refId?: string | undefined;
     appliesTo?: string[] | undefined;
     linkedEntity?: string | undefined;
+    linkedEntityId?: string | undefined;
+    eventIds?: Record<string, string> | undefined;
     listens?: unknown[] | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }>, {
     ref: string;
+    id?: TraitId | undefined;
+    from?: string | undefined;
     name?: string | undefined;
     fields?: Record<string, string> | undefined;
     config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     events?: Record<string, string> | undefined;
-    from?: string | undefined;
     effects?: Record<string, unknown[]> | undefined;
+    refId?: TraitId | undefined;
     appliesTo?: string[] | undefined;
     linkedEntity?: string | undefined;
+    linkedEntityId?: EntityId | undefined;
+    eventIds?: Record<string, EventId> | undefined;
     listens?: unknown[] | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }, {
     ref: string;
+    id?: string | undefined;
+    from?: string | undefined;
     name?: string | undefined;
     fields?: Record<string, string> | undefined;
     config?: Record<string, TraitConfigValue | ConfigFieldDeclaration> | undefined;
     events?: Record<string, string> | undefined;
-    from?: string | undefined;
     effects?: Record<string, unknown[]> | undefined;
+    refId?: string | undefined;
     appliesTo?: string[] | undefined;
     linkedEntity?: string | undefined;
+    linkedEntityId?: string | undefined;
+    eventIds?: Record<string, string> | undefined;
     listens?: unknown[] | undefined;
     emitsScope?: "internal" | "external" | undefined;
 }>;
@@ -2575,6 +2718,8 @@ declare const EntityFieldContractSchema: z.ZodObject<{
     provides: string[];
 }>;
 interface Trait {
+    /** V4 dual-carry id sibling of `name` — optional until the Phase-7 flip. */
+    id?: TraitId;
     name: string;
     description?: string;
     description_visual_prompt?: string;
@@ -2623,6 +2768,23 @@ interface Trait {
      * Required for inline trait definitions within an orbital.
      */
     linkedEntity?: string;
+    /** V4 dual-carry id sibling of `linkedEntity` — optional until the Phase-7 flip. */
+    linkedEntityId?: EntityId;
+    /**
+     * V4 leverage-ids — id side-map for `@entity.<Name>` binding tokens + positional
+     * entity args (`fetch`/`ref`/`persist`/`spawn`) in this trait's guards/effects/
+     * ticks/listens. Maps the referenced entity NAME → its stable id, so readers
+     * resolve these bare-string positions by id (else name) and an entity rename never
+     * strands them — the coverage that lets the entity name-rewriter be deleted.
+     */
+    entityRefIds?: Record<string, EntityId>;
+    /**
+     * V4 leverage-ids — id side-map for `@trait.<Name>` embed tokens (render-ui embeds /
+     * effect-tree sibling refs). Maps the embed token NAME → the embedded trait's stable
+     * id, so readers splice embeds by id (else name) — the coverage that lets the
+     * `@trait.` name-rewriter be deleted.
+     */
+    traitEmbedIds?: Record<string, TraitId>;
     requiredFields?: RequiredField[];
     dataEntities?: TraitDataEntity[];
     stateMachine?: StateMachine;
@@ -2680,6 +2842,7 @@ interface SourceBehaviorMetadata {
     originalName: string;
 }
 declare const TraitSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     description_visual_prompt: z.ZodOptional<z.ZodString>;
@@ -2700,16 +2863,19 @@ declare const TraitSchema: z.ZodObject<{
     capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     scope: z.ZodEnum<["instance", "collection"]>;
     linkedEntity: z.ZodOptional<z.ZodString>;
+    linkedEntityId: z.ZodOptional<z.ZodEffects<z.ZodString, EntityId, string>>;
+    entityRefIds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, EntityId, string>>>;
+    traitEmbedIds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, TraitId, string>>>;
     requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         type: z.ZodEnum<["string", "number", "boolean", "date", "array", "object", "timestamp", "datetime", "enum"]>;
         description: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        type: "string" | "number" | "boolean" | "object" | "date" | "timestamp" | "datetime" | "array" | "enum";
+        type: "string" | "number" | "boolean" | "object" | "date" | "array" | "timestamp" | "datetime" | "enum";
         name: string;
         description?: string | undefined;
     }, {
-        type: "string" | "number" | "boolean" | "object" | "date" | "timestamp" | "datetime" | "array" | "enum";
+        type: "string" | "number" | "boolean" | "object" | "date" | "array" | "timestamp" | "datetime" | "enum";
         name: string;
         description?: string | undefined;
     }>, "many">>;
@@ -2769,6 +2935,7 @@ declare const TraitSchema: z.ZodObject<{
         }>, "many">;
         events: z.ZodArray<z.ZodObject<{
             key: z.ZodString;
+            id: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
             synonyms: z.ZodOptional<z.ZodString>;
@@ -2779,6 +2946,7 @@ declare const TraitSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             name: string;
             key: string;
+            id?: EventId | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -2788,6 +2956,7 @@ declare const TraitSchema: z.ZodObject<{
         }, {
             name: string;
             key: string;
+            id?: string | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -2799,6 +2968,7 @@ declare const TraitSchema: z.ZodObject<{
             from: z.ZodString;
             to: z.ZodString;
             event: z.ZodString;
+            eventId: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
             guard: z.ZodOptional<z.ZodNullable<z.ZodType<SExpr, z.ZodTypeDef, SExpr>>>;
             effects: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodUnknown, "many">, unknown[], unknown[]>, "many">>;
             description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2807,6 +2977,7 @@ declare const TraitSchema: z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: EventId | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }, {
@@ -2814,6 +2985,7 @@ declare const TraitSchema: z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }>, "many">;
@@ -2834,6 +3006,7 @@ declare const TraitSchema: z.ZodObject<{
         events: {
             name: string;
             key: string;
+            id?: EventId | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -2855,6 +3028,7 @@ declare const TraitSchema: z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: EventId | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }[];
@@ -2867,6 +3041,7 @@ declare const TraitSchema: z.ZodObject<{
         events: {
             name: string;
             key: string;
+            id?: string | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -2888,6 +3063,7 @@ declare const TraitSchema: z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }[];
@@ -2905,9 +3081,11 @@ declare const TraitSchema: z.ZodObject<{
         interval: z.ZodUnion<[z.ZodLiteral<"frame">, z.ZodNumber]>;
         appliesTo: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         pages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        pageIds: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, PageId, string>, "many">>;
         guard: z.ZodOptional<z.ZodType<SExpr, z.ZodTypeDef, SExpr>>;
         effects: z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodUnknown, "many">, unknown[], unknown[]>, "many">;
         emits: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        emitIds: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, EventId, string>, "many">>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         effects: unknown[][];
@@ -2917,7 +3095,9 @@ declare const TraitSchema: z.ZodObject<{
         guard?: SExpr | undefined;
         priority?: number | undefined;
         appliesTo?: string[] | undefined;
+        pageIds?: PageId[] | undefined;
         emits?: string[] | undefined;
+        emitIds?: EventId[] | undefined;
     }, {
         name: string;
         effects: unknown[][];
@@ -2927,7 +3107,9 @@ declare const TraitSchema: z.ZodObject<{
         guard?: SExpr | undefined;
         priority?: number | undefined;
         appliesTo?: string[] | undefined;
+        pageIds?: string[] | undefined;
         emits?: string[] | undefined;
+        emitIds?: string[] | undefined;
     }>, "many">>;
     emits: z.ZodOptional<z.ZodArray<z.ZodObject<{
         /**
@@ -2940,6 +3122,7 @@ declare const TraitSchema: z.ZodObject<{
          * knob's effective literal before codegen/runtime consume it.
          */
         event: z.ZodString;
+        eventId: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
         description: z.ZodOptional<z.ZodString>;
         synonyms: z.ZodOptional<z.ZodString>;
         tier: z.ZodOptional<z.ZodString>;
@@ -2952,6 +3135,7 @@ declare const TraitSchema: z.ZodObject<{
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        eventId?: EventId | undefined;
     }, {
         event: string;
         description?: string | undefined;
@@ -2959,10 +3143,13 @@ declare const TraitSchema: z.ZodObject<{
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        eventId?: string | undefined;
     }>, "many">>;
     listens: z.ZodOptional<z.ZodArray<z.ZodObject<{
         event: z.ZodString;
+        eventId: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
         triggers: z.ZodString;
+        triggersId: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
         description: z.ZodOptional<z.ZodString>;
         synonyms: z.ZodOptional<z.ZodString>;
         tier: z.ZodOptional<z.ZodString>;
@@ -2978,24 +3165,33 @@ declare const TraitSchema: z.ZodObject<{
         }>, z.ZodObject<{
             kind: z.ZodLiteral<"trait">;
             trait: z.ZodString;
+            traitId: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
         }, "strip", z.ZodTypeAny, {
             trait: string;
             kind: "trait";
+            traitId?: TraitId | undefined;
         }, {
             trait: string;
             kind: "trait";
+            traitId?: string | undefined;
         }>, z.ZodObject<{
             kind: z.ZodLiteral<"orbital">;
             orbital: z.ZodString;
             trait: z.ZodString;
+            orbitalId: z.ZodOptional<z.ZodEffects<z.ZodString, OrbitalId, string>>;
+            traitId: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
         }, "strip", z.ZodTypeAny, {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: TraitId | undefined;
+            orbitalId?: OrbitalId | undefined;
         }, {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: string | undefined;
+            orbitalId?: string | undefined;
         }>]>>;
     }, "strip", z.ZodTypeAny, {
         event: string;
@@ -3007,14 +3203,19 @@ declare const TraitSchema: z.ZodObject<{
         } | {
             trait: string;
             kind: "trait";
+            traitId?: TraitId | undefined;
         } | {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: TraitId | undefined;
+            orbitalId?: OrbitalId | undefined;
         } | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
+        eventId?: EventId | undefined;
         guard?: SExpr | undefined;
+        triggersId?: EventId | undefined;
         payloadMapping?: Record<string, string> | undefined;
     }, {
         event: string;
@@ -3026,14 +3227,19 @@ declare const TraitSchema: z.ZodObject<{
         } | {
             trait: string;
             kind: "trait";
+            traitId?: string | undefined;
         } | {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: string | undefined;
+            orbitalId?: string | undefined;
         } | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
+        eventId?: string | undefined;
         guard?: SExpr | undefined;
+        triggersId?: string | undefined;
         payloadMapping?: Record<string, string> | undefined;
     }>, "many">>;
     ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -3131,6 +3337,7 @@ declare const TraitSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     scope: "collection" | "instance";
+    id?: TraitId | undefined;
     description?: string | undefined;
     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;
@@ -3150,6 +3357,7 @@ declare const TraitSchema: z.ZodObject<{
         events: {
             name: string;
             key: string;
+            id?: EventId | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -3171,6 +3379,7 @@ declare const TraitSchema: z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: EventId | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }[];
@@ -3187,8 +3396,10 @@ declare const TraitSchema: z.ZodObject<{
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        eventId?: EventId | undefined;
     }[] | undefined;
     linkedEntity?: string | undefined;
+    linkedEntityId?: EntityId | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -3199,14 +3410,19 @@ declare const TraitSchema: z.ZodObject<{
         } | {
             trait: string;
             kind: "trait";
+            traitId?: TraitId | undefined;
         } | {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: TraitId | undefined;
+            orbitalId?: OrbitalId | undefined;
         } | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
+        eventId?: EventId | undefined;
         guard?: SExpr | undefined;
+        triggersId?: EventId | undefined;
         payloadMapping?: Record<string, string> | undefined;
     }[] | undefined;
     description_visual_prompt?: string | undefined;
@@ -3217,8 +3433,10 @@ declare const TraitSchema: z.ZodObject<{
     } | undefined;
     entityBindingDescription?: string | undefined;
     entityBindingSynonyms?: string | undefined;
+    entityRefIds?: Record<string, EntityId> | undefined;
+    traitEmbedIds?: Record<string, TraitId> | undefined;
     requiredFields?: {
-        type: "string" | "number" | "boolean" | "object" | "date" | "timestamp" | "datetime" | "array" | "enum";
+        type: "string" | "number" | "boolean" | "object" | "date" | "array" | "timestamp" | "datetime" | "enum";
         name: string;
         description?: string | undefined;
     }[] | undefined;
@@ -3232,7 +3450,9 @@ declare const TraitSchema: z.ZodObject<{
         guard?: SExpr | undefined;
         priority?: number | undefined;
         appliesTo?: string[] | undefined;
+        pageIds?: PageId[] | undefined;
         emits?: string[] | undefined;
+        emitIds?: EventId[] | undefined;
     }[] | undefined;
     sourceBehavior?: {
         behavior: string;
@@ -3263,6 +3483,7 @@ declare const TraitSchema: z.ZodObject<{
 }, {
     name: string;
     scope: "collection" | "instance";
+    id?: string | undefined;
     description?: string | undefined;
     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;
@@ -3282,6 +3503,7 @@ declare const TraitSchema: z.ZodObject<{
         events: {
             name: string;
             key: string;
+            id?: string | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -3303,6 +3525,7 @@ declare const TraitSchema: z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }[];
@@ -3319,8 +3542,10 @@ declare const TraitSchema: z.ZodObject<{
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        eventId?: string | undefined;
     }[] | undefined;
     linkedEntity?: string | undefined;
+    linkedEntityId?: string | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -3331,14 +3556,19 @@ declare const TraitSchema: z.ZodObject<{
         } | {
             trait: string;
             kind: "trait";
+            traitId?: string | undefined;
         } | {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: string | undefined;
+            orbitalId?: string | undefined;
         } | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
+        eventId?: string | undefined;
         guard?: SExpr | undefined;
+        triggersId?: string | undefined;
         payloadMapping?: Record<string, string> | undefined;
     }[] | undefined;
     description_visual_prompt?: string | undefined;
@@ -3349,8 +3579,10 @@ declare const TraitSchema: z.ZodObject<{
     } | undefined;
     entityBindingDescription?: string | undefined;
     entityBindingSynonyms?: string | undefined;
+    entityRefIds?: Record<string, string> | undefined;
+    traitEmbedIds?: Record<string, string> | undefined;
     requiredFields?: {
-        type: "string" | "number" | "boolean" | "object" | "date" | "timestamp" | "datetime" | "array" | "enum";
+        type: "string" | "number" | "boolean" | "object" | "date" | "array" | "timestamp" | "datetime" | "enum";
         name: string;
         description?: string | undefined;
     }[] | undefined;
@@ -3364,7 +3596,9 @@ declare const TraitSchema: z.ZodObject<{
         guard?: SExpr | undefined;
         priority?: number | undefined;
         appliesTo?: string[] | undefined;
+        pageIds?: string[] | undefined;
         emits?: string[] | undefined;
+        emitIds?: string[] | undefined;
     }[] | undefined;
     sourceBehavior?: {
         behavior: string;
@@ -3412,6 +3646,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     events?: Record<string, string> | undefined;
     linkedEntity?: string | undefined;
 }>, z.ZodObject<{
+    id: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     description_visual_prompt: z.ZodOptional<z.ZodString>;
@@ -3432,16 +3667,19 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     scope: z.ZodEnum<["instance", "collection"]>;
     linkedEntity: z.ZodOptional<z.ZodString>;
+    linkedEntityId: z.ZodOptional<z.ZodEffects<z.ZodString, EntityId, string>>;
+    entityRefIds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, EntityId, string>>>;
+    traitEmbedIds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, TraitId, string>>>;
     requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         type: z.ZodEnum<["string", "number", "boolean", "date", "array", "object", "timestamp", "datetime", "enum"]>;
         description: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        type: "string" | "number" | "boolean" | "object" | "date" | "timestamp" | "datetime" | "array" | "enum";
+        type: "string" | "number" | "boolean" | "object" | "date" | "array" | "timestamp" | "datetime" | "enum";
         name: string;
         description?: string | undefined;
     }, {
-        type: "string" | "number" | "boolean" | "object" | "date" | "timestamp" | "datetime" | "array" | "enum";
+        type: "string" | "number" | "boolean" | "object" | "date" | "array" | "timestamp" | "datetime" | "enum";
         name: string;
         description?: string | undefined;
     }>, "many">>;
@@ -3501,6 +3739,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }>, "many">;
         events: z.ZodArray<z.ZodObject<{
             key: z.ZodString;
+            id: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
             synonyms: z.ZodOptional<z.ZodString>;
@@ -3511,6 +3750,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             name: string;
             key: string;
+            id?: EventId | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -3520,6 +3760,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }, {
             name: string;
             key: string;
+            id?: string | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -3531,6 +3772,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             from: z.ZodString;
             to: z.ZodString;
             event: z.ZodString;
+            eventId: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
             guard: z.ZodOptional<z.ZodNullable<z.ZodType<SExpr, z.ZodTypeDef, SExpr>>>;
             effects: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodUnknown, "many">, unknown[], unknown[]>, "many">>;
             description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -3539,6 +3781,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: EventId | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }, {
@@ -3546,6 +3789,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }>, "many">;
@@ -3566,6 +3810,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         events: {
             name: string;
             key: string;
+            id?: EventId | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -3587,6 +3832,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: EventId | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }[];
@@ -3599,6 +3845,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         events: {
             name: string;
             key: string;
+            id?: string | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -3620,6 +3867,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }[];
@@ -3637,9 +3885,11 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         interval: z.ZodUnion<[z.ZodLiteral<"frame">, z.ZodNumber]>;
         appliesTo: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         pages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        pageIds: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, PageId, string>, "many">>;
         guard: z.ZodOptional<z.ZodType<SExpr, z.ZodTypeDef, SExpr>>;
         effects: z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodUnknown, "many">, unknown[], unknown[]>, "many">;
         emits: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        emitIds: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, EventId, string>, "many">>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         effects: unknown[][];
@@ -3649,7 +3899,9 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         guard?: SExpr | undefined;
         priority?: number | undefined;
         appliesTo?: string[] | undefined;
+        pageIds?: PageId[] | undefined;
         emits?: string[] | undefined;
+        emitIds?: EventId[] | undefined;
     }, {
         name: string;
         effects: unknown[][];
@@ -3659,7 +3911,9 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         guard?: SExpr | undefined;
         priority?: number | undefined;
         appliesTo?: string[] | undefined;
+        pageIds?: string[] | undefined;
         emits?: string[] | undefined;
+        emitIds?: string[] | undefined;
     }>, "many">>;
     emits: z.ZodOptional<z.ZodArray<z.ZodObject<{
         /**
@@ -3672,6 +3926,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
          * knob's effective literal before codegen/runtime consume it.
          */
         event: z.ZodString;
+        eventId: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
         description: z.ZodOptional<z.ZodString>;
         synonyms: z.ZodOptional<z.ZodString>;
         tier: z.ZodOptional<z.ZodString>;
@@ -3684,6 +3939,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        eventId?: EventId | undefined;
     }, {
         event: string;
         description?: string | undefined;
@@ -3691,10 +3947,13 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        eventId?: string | undefined;
     }>, "many">>;
     listens: z.ZodOptional<z.ZodArray<z.ZodObject<{
         event: z.ZodString;
+        eventId: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
         triggers: z.ZodString;
+        triggersId: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
         description: z.ZodOptional<z.ZodString>;
         synonyms: z.ZodOptional<z.ZodString>;
         tier: z.ZodOptional<z.ZodString>;
@@ -3710,24 +3969,33 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }>, z.ZodObject<{
             kind: z.ZodLiteral<"trait">;
             trait: z.ZodString;
+            traitId: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
         }, "strip", z.ZodTypeAny, {
             trait: string;
             kind: "trait";
+            traitId?: TraitId | undefined;
         }, {
             trait: string;
             kind: "trait";
+            traitId?: string | undefined;
         }>, z.ZodObject<{
             kind: z.ZodLiteral<"orbital">;
             orbital: z.ZodString;
             trait: z.ZodString;
+            orbitalId: z.ZodOptional<z.ZodEffects<z.ZodString, OrbitalId, string>>;
+            traitId: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
         }, "strip", z.ZodTypeAny, {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: TraitId | undefined;
+            orbitalId?: OrbitalId | undefined;
         }, {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: string | undefined;
+            orbitalId?: string | undefined;
         }>]>>;
     }, "strip", z.ZodTypeAny, {
         event: string;
@@ -3739,14 +4007,19 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         } | {
             trait: string;
             kind: "trait";
+            traitId?: TraitId | undefined;
         } | {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: TraitId | undefined;
+            orbitalId?: OrbitalId | undefined;
         } | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
+        eventId?: EventId | undefined;
         guard?: SExpr | undefined;
+        triggersId?: EventId | undefined;
         payloadMapping?: Record<string, string> | undefined;
     }, {
         event: string;
@@ -3758,14 +4031,19 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         } | {
             trait: string;
             kind: "trait";
+            traitId?: string | undefined;
         } | {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: string | undefined;
+            orbitalId?: string | undefined;
         } | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
+        eventId?: string | undefined;
         guard?: SExpr | undefined;
+        triggersId?: string | undefined;
         payloadMapping?: Record<string, string> | undefined;
     }>, "many">>;
     ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -3863,6 +4141,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     scope: "collection" | "instance";
+    id?: TraitId | undefined;
     description?: string | undefined;
     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;
@@ -3882,6 +4161,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         events: {
             name: string;
             key: string;
+            id?: EventId | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -3903,6 +4183,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: EventId | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }[];
@@ -3919,8 +4200,10 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        eventId?: EventId | undefined;
     }[] | undefined;
     linkedEntity?: string | undefined;
+    linkedEntityId?: EntityId | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -3931,14 +4214,19 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         } | {
             trait: string;
             kind: "trait";
+            traitId?: TraitId | undefined;
         } | {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: TraitId | undefined;
+            orbitalId?: OrbitalId | undefined;
         } | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
+        eventId?: EventId | undefined;
         guard?: SExpr | undefined;
+        triggersId?: EventId | undefined;
         payloadMapping?: Record<string, string> | undefined;
     }[] | undefined;
     description_visual_prompt?: string | undefined;
@@ -3949,8 +4237,10 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     } | undefined;
     entityBindingDescription?: string | undefined;
     entityBindingSynonyms?: string | undefined;
+    entityRefIds?: Record<string, EntityId> | undefined;
+    traitEmbedIds?: Record<string, TraitId> | undefined;
     requiredFields?: {
-        type: "string" | "number" | "boolean" | "object" | "date" | "timestamp" | "datetime" | "array" | "enum";
+        type: "string" | "number" | "boolean" | "object" | "date" | "array" | "timestamp" | "datetime" | "enum";
         name: string;
         description?: string | undefined;
     }[] | undefined;
@@ -3964,7 +4254,9 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         guard?: SExpr | undefined;
         priority?: number | undefined;
         appliesTo?: string[] | undefined;
+        pageIds?: PageId[] | undefined;
         emits?: string[] | undefined;
+        emitIds?: EventId[] | undefined;
     }[] | undefined;
     sourceBehavior?: {
         behavior: string;
@@ -3995,6 +4287,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
 }, {
     name: string;
     scope: "collection" | "instance";
+    id?: string | undefined;
     description?: string | undefined;
     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;
@@ -4014,6 +4307,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         events: {
             name: string;
             key: string;
+            id?: string | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -4035,6 +4329,7 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }[];
@@ -4051,8 +4346,10 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        eventId?: string | undefined;
     }[] | undefined;
     linkedEntity?: string | undefined;
+    linkedEntityId?: string | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -4063,14 +4360,19 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         } | {
             trait: string;
             kind: "trait";
+            traitId?: string | undefined;
         } | {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: string | undefined;
+            orbitalId?: string | undefined;
         } | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
+        eventId?: string | undefined;
         guard?: SExpr | undefined;
+        triggersId?: string | undefined;
         payloadMapping?: Record<string, string> | undefined;
     }[] | undefined;
     description_visual_prompt?: string | undefined;
@@ -4081,8 +4383,10 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     } | undefined;
     entityBindingDescription?: string | undefined;
     entityBindingSynonyms?: string | undefined;
+    entityRefIds?: Record<string, string> | undefined;
+    traitEmbedIds?: Record<string, string> | undefined;
     requiredFields?: {
-        type: "string" | "number" | "boolean" | "object" | "date" | "timestamp" | "datetime" | "array" | "enum";
+        type: "string" | "number" | "boolean" | "object" | "date" | "array" | "timestamp" | "datetime" | "enum";
         name: string;
         description?: string | undefined;
     }[] | undefined;
@@ -4096,7 +4400,9 @@ declare const TraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         guard?: SExpr | undefined;
         priority?: number | undefined;
         appliesTo?: string[] | undefined;
+        pageIds?: string[] | undefined;
         emits?: string[] | undefined;
+        emitIds?: string[] | undefined;
     }[] | undefined;
     sourceBehavior?: {
         behavior: string;
@@ -4214,6 +4520,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     events?: Record<string, string> | undefined;
     linkedEntity?: string | undefined;
 }>, z.ZodObject<{
+    id: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     description_visual_prompt: z.ZodOptional<z.ZodString>;
@@ -4234,16 +4541,19 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     scope: z.ZodEnum<["instance", "collection"]>;
     linkedEntity: z.ZodOptional<z.ZodString>;
+    linkedEntityId: z.ZodOptional<z.ZodEffects<z.ZodString, EntityId, string>>;
+    entityRefIds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, EntityId, string>>>;
+    traitEmbedIds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, TraitId, string>>>;
     requiredFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         type: z.ZodEnum<["string", "number", "boolean", "date", "array", "object", "timestamp", "datetime", "enum"]>;
         description: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        type: "string" | "number" | "boolean" | "object" | "date" | "timestamp" | "datetime" | "array" | "enum";
+        type: "string" | "number" | "boolean" | "object" | "date" | "array" | "timestamp" | "datetime" | "enum";
         name: string;
         description?: string | undefined;
     }, {
-        type: "string" | "number" | "boolean" | "object" | "date" | "timestamp" | "datetime" | "array" | "enum";
+        type: "string" | "number" | "boolean" | "object" | "date" | "array" | "timestamp" | "datetime" | "enum";
         name: string;
         description?: string | undefined;
     }>, "many">>;
@@ -4303,6 +4613,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }>, "many">;
         events: z.ZodArray<z.ZodObject<{
             key: z.ZodString;
+            id: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
             synonyms: z.ZodOptional<z.ZodString>;
@@ -4313,6 +4624,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             name: string;
             key: string;
+            id?: EventId | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -4322,6 +4634,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }, {
             name: string;
             key: string;
+            id?: string | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -4333,6 +4646,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             from: z.ZodString;
             to: z.ZodString;
             event: z.ZodString;
+            eventId: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
             guard: z.ZodOptional<z.ZodNullable<z.ZodType<SExpr, z.ZodTypeDef, SExpr>>>;
             effects: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodUnknown, "many">, unknown[], unknown[]>, "many">>;
             description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -4341,6 +4655,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: EventId | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }, {
@@ -4348,6 +4663,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }>, "many">;
@@ -4368,6 +4684,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         events: {
             name: string;
             key: string;
+            id?: EventId | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -4389,6 +4706,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: EventId | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }[];
@@ -4401,6 +4719,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         events: {
             name: string;
             key: string;
+            id?: string | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -4422,6 +4741,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }[];
@@ -4439,9 +4759,11 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         interval: z.ZodUnion<[z.ZodLiteral<"frame">, z.ZodNumber]>;
         appliesTo: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         pages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        pageIds: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, PageId, string>, "many">>;
         guard: z.ZodOptional<z.ZodType<SExpr, z.ZodTypeDef, SExpr>>;
         effects: z.ZodArray<z.ZodEffects<z.ZodArray<z.ZodUnknown, "many">, unknown[], unknown[]>, "many">;
         emits: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        emitIds: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, EventId, string>, "many">>;
     }, "strip", z.ZodTypeAny, {
         name: string;
         effects: unknown[][];
@@ -4451,7 +4773,9 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         guard?: SExpr | undefined;
         priority?: number | undefined;
         appliesTo?: string[] | undefined;
+        pageIds?: PageId[] | undefined;
         emits?: string[] | undefined;
+        emitIds?: EventId[] | undefined;
     }, {
         name: string;
         effects: unknown[][];
@@ -4461,7 +4785,9 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         guard?: SExpr | undefined;
         priority?: number | undefined;
         appliesTo?: string[] | undefined;
+        pageIds?: string[] | undefined;
         emits?: string[] | undefined;
+        emitIds?: string[] | undefined;
     }>, "many">>;
     emits: z.ZodOptional<z.ZodArray<z.ZodObject<{
         /**
@@ -4474,6 +4800,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
          * knob's effective literal before codegen/runtime consume it.
          */
         event: z.ZodString;
+        eventId: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
         description: z.ZodOptional<z.ZodString>;
         synonyms: z.ZodOptional<z.ZodString>;
         tier: z.ZodOptional<z.ZodString>;
@@ -4486,6 +4813,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        eventId?: EventId | undefined;
     }, {
         event: string;
         description?: string | undefined;
@@ -4493,10 +4821,13 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        eventId?: string | undefined;
     }>, "many">>;
     listens: z.ZodOptional<z.ZodArray<z.ZodObject<{
         event: z.ZodString;
+        eventId: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
         triggers: z.ZodString;
+        triggersId: z.ZodOptional<z.ZodEffects<z.ZodString, EventId, string>>;
         description: z.ZodOptional<z.ZodString>;
         synonyms: z.ZodOptional<z.ZodString>;
         tier: z.ZodOptional<z.ZodString>;
@@ -4512,24 +4843,33 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         }>, z.ZodObject<{
             kind: z.ZodLiteral<"trait">;
             trait: z.ZodString;
+            traitId: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
         }, "strip", z.ZodTypeAny, {
             trait: string;
             kind: "trait";
+            traitId?: TraitId | undefined;
         }, {
             trait: string;
             kind: "trait";
+            traitId?: string | undefined;
         }>, z.ZodObject<{
             kind: z.ZodLiteral<"orbital">;
             orbital: z.ZodString;
             trait: z.ZodString;
+            orbitalId: z.ZodOptional<z.ZodEffects<z.ZodString, OrbitalId, string>>;
+            traitId: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
         }, "strip", z.ZodTypeAny, {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: TraitId | undefined;
+            orbitalId?: OrbitalId | undefined;
         }, {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: string | undefined;
+            orbitalId?: string | undefined;
         }>]>>;
     }, "strip", z.ZodTypeAny, {
         event: string;
@@ -4541,14 +4881,19 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         } | {
             trait: string;
             kind: "trait";
+            traitId?: TraitId | undefined;
         } | {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: TraitId | undefined;
+            orbitalId?: OrbitalId | undefined;
         } | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
+        eventId?: EventId | undefined;
         guard?: SExpr | undefined;
+        triggersId?: EventId | undefined;
         payloadMapping?: Record<string, string> | undefined;
     }, {
         event: string;
@@ -4560,14 +4905,19 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         } | {
             trait: string;
             kind: "trait";
+            traitId?: string | undefined;
         } | {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: string | undefined;
+            orbitalId?: string | undefined;
         } | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
+        eventId?: string | undefined;
         guard?: SExpr | undefined;
+        triggersId?: string | undefined;
         payloadMapping?: Record<string, string> | undefined;
     }>, "many">>;
     ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -4665,6 +5015,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     scope: "collection" | "instance";
+    id?: TraitId | undefined;
     description?: string | undefined;
     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;
@@ -4684,6 +5035,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         events: {
             name: string;
             key: string;
+            id?: EventId | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -4705,6 +5057,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: EventId | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }[];
@@ -4721,8 +5074,10 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        eventId?: EventId | undefined;
     }[] | undefined;
     linkedEntity?: string | undefined;
+    linkedEntityId?: EntityId | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -4733,14 +5088,19 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         } | {
             trait: string;
             kind: "trait";
+            traitId?: TraitId | undefined;
         } | {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: TraitId | undefined;
+            orbitalId?: OrbitalId | undefined;
         } | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
+        eventId?: EventId | undefined;
         guard?: SExpr | undefined;
+        triggersId?: EventId | undefined;
         payloadMapping?: Record<string, string> | undefined;
     }[] | undefined;
     description_visual_prompt?: string | undefined;
@@ -4751,8 +5111,10 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     } | undefined;
     entityBindingDescription?: string | undefined;
     entityBindingSynonyms?: string | undefined;
+    entityRefIds?: Record<string, EntityId> | undefined;
+    traitEmbedIds?: Record<string, TraitId> | undefined;
     requiredFields?: {
-        type: "string" | "number" | "boolean" | "object" | "date" | "timestamp" | "datetime" | "array" | "enum";
+        type: "string" | "number" | "boolean" | "object" | "date" | "array" | "timestamp" | "datetime" | "enum";
         name: string;
         description?: string | undefined;
     }[] | undefined;
@@ -4766,7 +5128,9 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         guard?: SExpr | undefined;
         priority?: number | undefined;
         appliesTo?: string[] | undefined;
+        pageIds?: PageId[] | undefined;
         emits?: string[] | undefined;
+        emitIds?: EventId[] | undefined;
     }[] | undefined;
     sourceBehavior?: {
         behavior: string;
@@ -4797,6 +5161,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
 }, {
     name: string;
     scope: "collection" | "instance";
+    id?: string | undefined;
     description?: string | undefined;
     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;
@@ -4816,6 +5181,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         events: {
             name: string;
             key: string;
+            id?: string | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -4837,6 +5203,7 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
             from: string;
             to: string;
             description?: string | null | undefined;
+            eventId?: string | undefined;
             guard?: SExpr | undefined;
             effects?: unknown[][] | undefined;
         }[];
@@ -4853,8 +5220,10 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
         payloadSchema?: EventPayloadField[] | undefined;
+        eventId?: string | undefined;
     }[] | undefined;
     linkedEntity?: string | undefined;
+    linkedEntityId?: string | undefined;
     listens?: {
         event: string;
         triggers: string;
@@ -4865,14 +5234,19 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         } | {
             trait: string;
             kind: "trait";
+            traitId?: string | undefined;
         } | {
+            orbital: string;
             trait: string;
             kind: "orbital";
-            orbital: string;
+            traitId?: string | undefined;
+            orbitalId?: string | undefined;
         } | undefined;
         scope?: "internal" | "external" | undefined;
         tier?: string | undefined;
+        eventId?: string | undefined;
         guard?: SExpr | undefined;
+        triggersId?: string | undefined;
         payloadMapping?: Record<string, string> | undefined;
     }[] | undefined;
     description_visual_prompt?: string | undefined;
@@ -4883,8 +5257,10 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     } | undefined;
     entityBindingDescription?: string | undefined;
     entityBindingSynonyms?: string | undefined;
+    entityRefIds?: Record<string, string> | undefined;
+    traitEmbedIds?: Record<string, string> | undefined;
     requiredFields?: {
-        type: "string" | "number" | "boolean" | "object" | "date" | "timestamp" | "datetime" | "array" | "enum";
+        type: "string" | "number" | "boolean" | "object" | "date" | "array" | "timestamp" | "datetime" | "enum";
         name: string;
         description?: string | undefined;
     }[] | undefined;
@@ -4898,7 +5274,9 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         guard?: SExpr | undefined;
         priority?: number | undefined;
         appliesTo?: string[] | undefined;
+        pageIds?: string[] | undefined;
         emits?: string[] | undefined;
+        emitIds?: string[] | undefined;
     }[] | undefined;
     sourceBehavior?: {
         behavior: string;
@@ -4928,4 +5306,4 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     } | undefined;
 }>]>;
 
-export { type LogEffect as $, type AgentEffect as A, type BehaviorEffect as B, type CallSiteConfig as C, type DeclaredTraitConfig as D, type Effect as E, type EvaluateConfig as F, type EvaluateEffect as G, type Event as H, type EventInput as I, type EventPayloadField as J, EventPayloadFieldSchema as K, EventSchema as L, type EventScope as M, EventScopeSchema as N, type FetchEffect as O, type FetchOptions as P, type FetchResult as Q, type ForwardConfig as R, type State as S, type TraitEventListener as T, type ForwardEffect as U, type Guard as V, type GuardInput as W, GuardSchema as X, type ListenSource as Y, ListenSourceSchema as Z, type LlmEffect as _, type TraitReference as a, TraitDataEntitySchema as a$, type McpServiceDef as a0, McpServiceDefSchema as a1, type MemoryEffect as a2, type NavigateEffect as a3, type NnConfig as a4, type NnLayer as a5, type NotifyEffect as a6, type OrbitalTraitRef as a7, OrbitalTraitRefSchema as a8, type OsEffect as a9, ServiceRefSchema as aA, ServiceRefStringSchema as aB, type ServiceType as aC, ServiceTypeSchema as aD, type SessionEffect as aE, type SetEffect as aF, type SocketEvents as aG, SocketEventsSchema as aH, type SocketServiceDef as aI, SocketServiceDefSchema as aJ, type SpawnEffect as aK, type StateInput as aL, type StateMachine as aM, type StateMachineInput as aN, StateMachineSchema as aO, StateSchema as aP, type SwapEffect as aQ, type TraceEffect as aR, type TrainConfig as aS, type TrainEffect as aT, type TraitCategory as aU, TraitCategorySchema as aV, type TraitConfigObject as aW, TraitConfigSchema as aX, type TraitConfigValue as aY, TraitConfigValueSchema as aZ, type TraitDataEntity as a_, type PayloadField as aa, PayloadFieldSchema as ab, type PersistData as ac, type PersistEffect as ad, type PersistEmitConfig as ae, type PresentationType as af, type RefEffect as ag, type RenderBinding as ah, type RenderItemLambda as ai, type RenderUIEffect as aj, type RenderUINode as ak, type RequiredField as al, RequiredFieldSchema as am, type ResolvedPatternProps as an, type RestAuthConfig as ao, RestAuthConfigSchema as ap, type RestServiceDef as aq, RestServiceDefSchema as ar, SERVICE_TYPES as as, type ServiceDefinition as at, ServiceDefinitionSchema as au, type ServiceParams as av, type ServiceParamsValue as aw, type ServiceRef as ax, type ServiceRefObject as ay, ServiceRefObjectSchema as az, type CallSiteConfigEntry as b, type TraitEntityField as b0, TraitEntityFieldSchema as b1, type TraitEventContract as b2, TraitEventContractSchema as b3, TraitEventListenerSchema as b4, type TraitInput as b5, type TraitRef as b6, TraitRefSchema as b7, type TraitReferenceInput as b8, TraitReferenceSchema as b9, isCallSiteConfigDeclaration as bA, isCircuitEvent as bB, isEffect as bC, isInlineTrait as bD, isMcpService as bE, isRestService as bF, isSExprEffect as bG, isServiceReference as bH, isServiceReferenceObject as bI, isSocketService as bJ, navigate as bK, normalizeCallSiteConfigToValues as bL, normalizeTraitRef as bM, notify as bN, parseServiceRef as bO, persist as bP, ref as bQ, renderUI as bR, resolveConfigRefEventName as bS, set as bT, spawn as bU, swap as bV, watch as bW, type TraitScope as bX, TraitSchema as ba, type TraitTick as bb, TraitTickSchema as bc, type TraitUIBinding as bd, type Transition as be, type TransitionInput as bf, TransitionSchema as bg, type TypedEffect as bh, type UISlot as bi, UISlotSchema as bj, UI_SLOTS as bk, type ValidateEffect as bl, type WatchEffect as bm, type WatchOptions as bn, atomic as bo, callService as bp, configRefEventKnob as bq, deref as br, despawn as bs, doEffects as bt, emit as bu, findService as bv, getServiceNames as bw, getTraitConfig as bx, getTraitName as by, hasService as bz, type Trait as c, type TraitConfig as d, type ApplicationEffect as e, type AtomicEffect as f, CONFIG_REF_EVENT_PATTERN as g, type CallServiceConfig as h, type CallServiceEffect as i, type CheckpointLoadEffect as j, type CheckpointSaveEffect as k, type ComposeEffect as l, type ConfigFieldDeclaration as m, ConfigFieldDeclarationSchema as n, type ConfigFieldItemsDeclaration as o, type ConfigRefEventError as p, DeclaredTraitConfigSchema as q, type DerefEffect as r, type DespawnEffect as s, type DoEffect as t, type EffectInput as u, EffectSchema as v, type EmitConfig as w, type EmitEffect as x, type EntityFieldContract as y, EntityFieldContractSchema as z };
+export { type LogEffect as $, type AgentEffect as A, type BehaviorEffect as B, type CallSiteConfig as C, type DeclaredTraitConfig as D, type Effect as E, type EvaluateConfig as F, type EvaluateEffect as G, type Event as H, type EventInput as I, type EventPayloadField as J, EventPayloadFieldSchema as K, EventSchema as L, type EventScope as M, EventScopeSchema as N, type FetchEffect as O, type FetchOptions as P, type FetchResult as Q, type ForwardConfig as R, type State as S, type TraitEventListener as T, type ForwardEffect as U, type Guard as V, type GuardInput as W, GuardSchema as X, type ListenSource as Y, ListenSourceSchema as Z, type LlmEffect as _, type TraitReference as a, type TraitConfigValue as a$, type McpServiceDef as a0, McpServiceDefSchema as a1, type MemoryEffect as a2, type NavigateEffect as a3, type NnConfig as a4, type NnLayer as a5, type NotifyEffect as a6, type OrbitalTraitRef as a7, OrbitalTraitRefSchema as a8, type OsEffect as a9, type ServiceRef as aA, type ServiceRefObject as aB, ServiceRefObjectSchema as aC, ServiceRefSchema as aD, ServiceRefStringSchema as aE, type ServiceType as aF, ServiceTypeSchema as aG, type SessionEffect as aH, type SetEffect as aI, type SocketEvents as aJ, SocketEventsSchema as aK, type SocketServiceDef as aL, SocketServiceDefSchema as aM, type SpawnEffect as aN, type StateInput as aO, type StateMachine as aP, type StateMachineInput as aQ, StateMachineSchema as aR, StateSchema as aS, type SwapEffect as aT, type TraceEffect as aU, type TrainConfig as aV, type TrainEffect as aW, type TraitCategory as aX, TraitCategorySchema as aY, type TraitConfigObject as aZ, TraitConfigSchema as a_, type PayloadField as aa, PayloadFieldSchema as ab, type PersistData as ac, type PersistEffect as ad, type PersistEmitConfig as ae, type PresentationType as af, REFERENCE_CONFIG_TYPES as ag, type RefEffect as ah, type ReferenceConfigType as ai, type RenderBinding as aj, type RenderChildrenMap as ak, type RenderItemLambda as al, type RenderUIEffect as am, type RenderUINode as an, type RequiredField as ao, RequiredFieldSchema as ap, type ResolvedPatternProps as aq, type RestAuthConfig as ar, RestAuthConfigSchema as as, type RestServiceDef as at, RestServiceDefSchema as au, SERVICE_TYPES as av, type ServiceDefinition as aw, ServiceDefinitionSchema as ax, type ServiceParams as ay, type ServiceParamsValue as az, type CallSiteConfigEntry as b, type TraitScope as b$, TraitConfigValueSchema as b0, type TraitDataEntity as b1, TraitDataEntitySchema as b2, type TraitEntityField as b3, TraitEntityFieldSchema as b4, type TraitEventContract as b5, TraitEventContractSchema as b6, TraitEventListenerSchema as b7, type TraitInput as b8, type TraitRef as b9, getTraitConfig as bA, getTraitName as bB, hasService as bC, isCallSiteConfigDeclaration as bD, isCircuitEvent as bE, isEffect as bF, isInlineTrait as bG, isMcpService as bH, isReferenceConfigType as bI, isRestService as bJ, isSExprEffect as bK, isServiceReference as bL, isServiceReferenceObject as bM, isSocketService as bN, navigate as bO, normalizeCallSiteConfigToValues as bP, normalizeTraitRef as bQ, notify as bR, parseServiceRef as bS, persist as bT, ref as bU, renderUI as bV, resolveConfigRefEventName as bW, set as bX, spawn as bY, swap as bZ, watch as b_, TraitRefSchema as ba, type TraitReferenceInput as bb, TraitReferenceSchema as bc, TraitSchema as bd, type TraitTick as be, TraitTickSchema as bf, type TraitUIBinding as bg, type Transition as bh, type TransitionInput as bi, TransitionSchema as bj, type TypedEffect as bk, type UISlot as bl, UISlotSchema as bm, UI_SLOTS as bn, type ValidateEffect as bo, type WatchEffect as bp, type WatchOptions as bq, atomic as br, callService as bs, configRefEventKnob as bt, deref as bu, despawn as bv, doEffects as bw, emit as bx, findService as by, getServiceNames as bz, type Trait as c, type TraitConfig as d, type ApplicationEffect as e, type AtomicEffect as f, CONFIG_REF_EVENT_PATTERN as g, type CallServiceConfig as h, type CallServiceEffect as i, type CheckpointLoadEffect as j, type CheckpointSaveEffect as k, type ComposeEffect as l, type ConfigFieldDeclaration as m, ConfigFieldDeclarationSchema as n, type ConfigFieldItemsDeclaration as o, type ConfigRefEventError as p, DeclaredTraitConfigSchema as q, type DerefEffect as r, type DespawnEffect as s, type DoEffect as t, type EffectInput as u, EffectSchema as v, type EmitConfig as w, type EmitEffect as x, type EntityFieldContract as y, EntityFieldContractSchema as z };