@almadar/core 10.29.0 → 10.31.0

package/dist/{trait-B_CzfDSi.d.ts → trait-DE6VU4Cd.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-VDIr2TkX.js';
 import { S as SExpr, E as EventPayload, a as Expression } from './expression-CB9R3KWk.js';
 import { z } from 'zod';
 
@@ -37,7 +37,7 @@ declare const ServiceTypeSchema: z.ZodEnum<["rest", "socket", "mcp"]>;
  * };
  * ```
  */
-interface RestServiceDef {
+type RestServiceDef = {
     /** Unique service name (used in call_service effect) */
     name: string;
     /** Service type */
@@ -52,11 +52,11 @@ interface RestServiceDef {
     auth?: RestAuthConfig;
     /** Timeout in milliseconds (default: 30000) */
     timeout?: number;
-}
+};
 /**
  * Authentication configuration for REST services.
  */
-interface RestAuthConfig {
+type RestAuthConfig = {
     /** Authentication type */
     type: "api-key" | "bearer" | "basic" | "oauth2";
     /** For api-key: the query parameter or header name */
@@ -65,7 +65,7 @@ interface RestAuthConfig {
     location?: "query" | "header";
     /** Environment variable name containing the secret (for secure storage) */
     secretEnv?: string;
-}
+};
 declare const RestAuthConfigSchema: z.ZodObject<{
     type: z.ZodEnum<["api-key", "bearer", "basic", "oauth2"]>;
     keyName: z.ZodOptional<z.ZodString>;
@@ -148,7 +148,7 @@ declare const RestServiceDefSchema: z.ZodObject<{
  * };
  * ```
  */
-interface SocketServiceDef {
+type SocketServiceDef = {
     /** Unique service name */
     name: string;
     /** Service type */
@@ -168,16 +168,16 @@ interface SocketServiceDef {
         /** Delay between attempts in ms */
         delayMs?: number;
     };
-}
+};
 /**
  * Socket event definitions.
  */
-interface SocketEvents {
+type SocketEvents = {
     /** Events received from server (maps to orbital events) */
     inbound: string[];
     /** Events sent to server (triggered by effects) */
     outbound: string[];
-}
+};
 declare const SocketEventsSchema: z.ZodObject<{
     inbound: z.ZodArray<z.ZodString, "many">;
     outbound: z.ZodArray<z.ZodString, "many">;
@@ -258,7 +258,7 @@ declare const SocketServiceDefSchema: z.ZodObject<{
  * };
  * ```
  */
-interface McpServiceDef {
+type McpServiceDef = {
     /** Unique service name */
     name: string;
     /** Service type */
@@ -271,7 +271,7 @@ interface McpServiceDef {
     capabilities: string[];
     /** Environment variables to pass to the MCP server */
     env?: Record<string, string>;
-}
+};
 declare const McpServiceDefSchema: z.ZodObject<{
     name: z.ZodString;
     type: z.ZodLiteral<"mcp">;
@@ -450,7 +450,7 @@ type ServiceRef = ServiceDefinition | ServiceRefObject | string;
  * };
  * ```
  */
-interface ServiceRefObject {
+type ServiceRefObject = {
     /** Reference to imported service: "Alias.services.ServiceName" */
     ref: string;
     /** Override the service description */
@@ -463,7 +463,7 @@ interface ServiceRefObject {
     url?: string;
     /** Override the MCP server path */
     serverPath?: string;
-}
+};
 /**
  * Checks if a service reference is a bare string reference.
  *
@@ -742,9 +742,9 @@ declare function hasService(services: ServiceDefinition[], name: string): boolea
  */
 type ServiceParamsValue = string | number | boolean | Date | null | undefined | ServiceParams | readonly ServiceParamsValue[];
 /** Parameters passed to call-service effects. Recursive for nested request shapes. */
-interface ServiceParams {
+type ServiceParams = {
     [key: string]: ServiceParamsValue;
-}
+};
 
 /**
  * Effect Types (Self-Contained)
@@ -765,7 +765,7 @@ declare const UISlotSchema: z.ZodEnum<["main", "sidebar", "modal", "drawer", "ov
 /**
  * Configuration extracted from call-service effects
  */
-interface CallServiceConfig {
+type CallServiceConfig = {
     service: string;
     action: string;
     endpoint?: string;
@@ -773,7 +773,7 @@ interface CallServiceConfig {
     params?: ServiceParams;
     onSuccess?: string;
     onError?: string;
-}
+};
 /**
  * A binding reference to a render tree stored elsewhere — a trait `config`
  * knob or a payload field — e.g. `"@config.bodyContent"`. Resolved to a pattern
@@ -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' }]
@@ -871,12 +882,12 @@ type SetEffect = ['set', string, unknown] | ['set', string, string, unknown];
  * position. See `(persist create Entity @payload.data { emit: { success:
  * "Saved", failure: "SaveFailed" } })` in `.lolo` source.
  */
-interface PersistEmitConfig {
+type PersistEmitConfig = {
     emit?: {
         success?: string;
         failure?: string;
     };
-}
+};
 /**
  * Persist effect data argument: either an entity row literal (field map)
  * or a binding string referencing a row in scope (e.g. `@payload.data`,
@@ -942,7 +953,7 @@ type NotifyEffect = ['notify', string, string | SExpr] | ['notify', string, stri
  * `limit`, `offset`, `include`, plus the trailing `emit:` map for
  * success/failure event names.
  */
-interface FetchOptions {
+type FetchOptions = {
     /** Fetch a single entity by ID */
     id?: string;
     /** Filter expression (S-expression) */
@@ -958,7 +969,7 @@ interface FetchOptions {
         success?: string;
         failure?: string;
     };
-}
+};
 /**
  * Fetch effect - retrieves entity data (server-side).
  * @example ['fetch', 'User'] or ['fetch', 'User', { id: '@payload.userId' }]
@@ -1031,7 +1042,7 @@ type SwapEffect = ['swap!', string, SExpr];
  * Options accepted by `watch` effects. Mirrors what the runtime reads when
  * registering the change callback: `debounce` and the trailing `emit:` map.
  */
-interface WatchOptions {
+type WatchOptions = {
     /** Debounce duration in milliseconds */
     debounce?: number;
     /** Lifecycle events to emit on update / failure */
@@ -1039,7 +1050,7 @@ interface WatchOptions {
         on_message?: string;
         failure?: string;
     };
-}
+};
 /**
  * Watch effect - registers a callback for entity changes.
  * Emits an event whenever the watched binding changes.
@@ -1059,48 +1070,48 @@ type AtomicEffect = ['atomic', ...SExpr[]];
  * lives in `almadar-std/modules/nn`; here we keep the wire shape generic
  * enough for the cross-package runtime + Python bridge to round-trip.
  */
-interface NnLayer {
+type NnLayer = {
     type: string;
     [key: string]: string | number | boolean | number[] | string[] | undefined;
-}
+};
 /**
  * Hyperparameters for `train` and `evaluate`. Recursive to allow nested
  * optimizer / scheduler config blocks without falling back to `unknown`.
  */
-interface NnConfig {
+type NnConfig = {
     [key: string]: string | number | boolean | string[] | number[] | NnConfig | undefined;
-}
+};
 /**
  * Forward-pass config: `input` is a binding string (`@payload.input`), and
  * `on-complete` names the event to fire when the prediction lands.
  */
-interface ForwardConfig {
+type ForwardConfig = {
     architecture: NnLayer[];
     input: string;
     'on-complete'?: string;
     config?: NnConfig;
-}
+};
 /**
  * Training-loop config. `dataset` is a binding string referencing the rows
  * to train on. Optimizer / loss / scheduler land inside `config`.
  */
-interface TrainConfig {
+type TrainConfig = {
     architecture: NnLayer[];
     dataset: string;
     config?: NnConfig;
     'on-complete'?: string;
-}
+};
 /**
  * Evaluation config. `metrics` lists named metrics the Python backend
  * computes (`accuracy`, `precision`, ...).
  */
-interface EvaluateConfig {
+type EvaluateConfig = {
     architecture: NnLayer[];
     dataset: string;
     metrics: string[];
     config?: NnConfig;
     'on-complete'?: string;
-}
+};
 /**
  * Forward effect - runs a neural network forward pass (Python backend).
  * @example ['forward', 'primary', { architecture: [...], input: '@payload.input', 'on-complete': 'PREDICTION_READY' }]
@@ -1426,14 +1437,17 @@ declare function watch(binding: string, event: string, options: WatchOptions): W
  */
 declare function atomic(...effects: SExpr[]): AtomicEffect;
 /** Resolved pattern props for render-ui effects at runtime. Recursive for nested pattern configs. */
-interface ResolvedPatternProps {
+type ResolvedPatternProps = {
     [prop: string]: string | number | boolean | null | undefined | ResolvedPatternProps | ResolvedPatternProps[];
-}
+};
 /** A node in a render-ui effect tree. */
 interface RenderUINode {
     type: string;
     props?: ResolvedPatternProps;
-    children?: RenderUINode[];
+    /** 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;
@@ -1442,7 +1456,7 @@ interface RenderUINode {
 /**
  * Represents a state in the state machine
  */
-interface State {
+type State = {
     /** State name (unique identifier) */
     name: string;
     /** Whether this is the initial state */
@@ -1457,7 +1471,7 @@ interface State {
     onEntry?: string[];
     /** Effect names to run on exit */
     onExit?: string[];
-}
+};
 declare const StateSchema: z.ZodObject<{
     name: z.ZodString;
     isInitial: z.ZodOptional<z.ZodBoolean>;
@@ -1486,7 +1500,7 @@ declare const StateSchema: z.ZodObject<{
 /**
  * Payload field definition for events
  */
-interface PayloadField {
+type PayloadField = {
     name: string;
     /**
      * Field type. Mirrors the Rust validator's acceptance: any non-empty
@@ -1499,14 +1513,16 @@ interface PayloadField {
     required?: boolean;
     /** Structured property schema for object-typed payload fields (recursive). */
     properties?: ReadonlyArray<PayloadField>;
-}
+};
 declare const PayloadFieldSchema: z.ZodType<PayloadField>;
 /**
  * Represents an event that can trigger transitions
  */
-interface Event {
+type 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). */
@@ -1522,9 +1538,10 @@ interface Event {
     classification?: "domain" | "system";
     /** Semantic role of this event (optional, for analysis) */
     semanticRole?: string;
-}
+};
 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;
@@ -1562,12 +1581,12 @@ declare const EventSchema: z.ZodObject<{
  *   description: "Check if entity has health remaining"
  * }
  */
-interface Guard {
+type Guard = {
     name: string;
     /** Guard expression - S-expression array only */
     expression: Expression;
     description?: string;
-}
+};
 declare const GuardSchema: z.ZodObject<{
     name: z.ZodString;
     expression: z.ZodType<SExpr, z.ZodTypeDef, SExpr>;
@@ -1597,24 +1616,27 @@ declare const GuardSchema: z.ZodObject<{
  *   ]
  * }
  */
-interface Transition {
+type Transition = {
     /** Source state name */
     from: string;
     /** Target state name */
     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 */
     effects?: Effect[];
     /** Description */
     description?: string | null;
-}
+};
 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,13 +1653,14 @@ declare const TransitionSchema: z.ZodObject<{
     from: string;
     to: string;
     description?: string | null | undefined;
+    eventId?: string | undefined;
     guard?: SExpr | undefined;
     effects?: unknown[][] | undefined;
 }>;
 /**
  * Complete state machine definition
  */
-interface StateMachine {
+type StateMachine = {
     /** All states in the machine */
     states: State[];
     /** All events that can be triggered */
@@ -1645,7 +1669,7 @@ interface StateMachine {
     transitions: Transition[];
     /** Named guard definitions */
     guards?: Guard[];
-}
+};
 declare const StateMachineSchema: z.ZodObject<{
     states: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -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;
     }[];
@@ -1831,9 +1865,9 @@ declare function isCircuitEvent(event: string): boolean;
  * via `@config.<key>` bindings.
  */
 type TraitConfigValue = string | number | boolean | null | ReadonlyArray<TraitConfigValue> | TraitConfigObject;
-interface TraitConfigObject {
+type TraitConfigObject = {
     readonly [key: string]: TraitConfigValue;
-}
+};
 type TraitConfig = TraitConfigObject;
 /** Zod schema for TraitConfig. Recursive via z.lazy to allow nested structures. */
 declare const TraitConfigValueSchema: z.ZodType<TraitConfigValue>;
@@ -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.
  */
-interface ConfigFieldDeclaration {
+/**
+ * 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;
+type 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. */
@@ -1919,14 +1973,14 @@ interface ConfigFieldDeclaration {
     readonly items?: ConfigFieldItemsDeclaration;
     /** Structured property schema for object-typed config fields (no items wrapper). */
     readonly properties?: Readonly<Record<string, TraitEntityField>>;
-}
-interface ConfigFieldItemsDeclaration {
+};
+type ConfigFieldItemsDeclaration = {
     readonly type?: string;
     /** Absent for arrays of scalars (`items: { type: "string" }`). */
     readonly properties?: Readonly<Record<string, TraitEntityField>>;
     /** Nested per-item schema for arrays of arrays (recursive). */
     readonly items?: ConfigFieldItemsDeclaration;
-}
+};
 declare const ConfigFieldDeclarationSchema: z.ZodType<ConfigFieldDeclaration>;
 /**
  * Map of declared config fields keyed by name. Lives on `Trait.config`
@@ -1947,22 +2001,23 @@ type TraitFieldType = 'string' | 'number' | 'boolean' | 'date' | 'array' | 'obje
 /**
  * Simplified field for trait data entities
  */
-interface TraitEntityField {
+type TraitEntityField = {
     name: string;
     type: TraitFieldType;
     required?: boolean;
-    default?: unknown;
+    /** Field default parsed from `.orb` — always a JSON-shaped value. */
+    default?: TraitConfigValue;
     values?: string[];
     /** Structured per-item schema for array-of-object fields (recursive). */
     items?: ConfigFieldItemsDeclaration;
     /** Structured property schema for object-typed entity fields. */
     properties?: Readonly<Record<string, TraitEntityField>>;
-}
+};
 declare const TraitEntityFieldSchema: z.ZodType<TraitEntityField>;
 /**
  * Simplified data entity for traits
  */
-interface TraitDataEntity {
+type TraitDataEntity = {
     name: string;
     collection?: string;
     fields: TraitEntityField[];
@@ -1971,7 +2026,7 @@ interface TraitDataEntity {
     runtime?: boolean;
     singleton?: boolean;
     pages?: string[];
-}
+};
 declare const TraitDataEntitySchema: z.ZodObject<{
     name: z.ZodString;
     collection: z.ZodOptional<z.ZodString>;
@@ -2005,13 +2060,15 @@ declare const TraitDataEntitySchema: z.ZodObject<{
  * Guards can be legacy strings or S-expressions.
  * Effects can be typed Effect objects or S-expressions.
  */
-interface TraitTick {
+type TraitTick = {
     name: string;
     description?: string;
     priority?: number;
     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,7 +2079,9 @@ 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;
     description: z.ZodOptional<z.ZodString>;
@@ -2030,9 +2089,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 +2103,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 +2115,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:
@@ -2065,7 +2130,7 @@ declare const EventScopeSchema: z.ZodEnum<["internal", "external"]>;
  * Payload field definition for events.
  * Defines the structure of data carried by events.
  */
-interface EventPayloadField {
+type EventPayloadField = {
     /** Field name */
     name: string;
     /**
@@ -2088,15 +2153,17 @@ interface EventPayloadField {
     entityType?: string;
     /** Structured property schema for object-typed payload fields (recursive). */
     properties?: ReadonlyArray<EventPayloadField>;
-}
+};
 declare const EventPayloadFieldSchema: z.ZodType<EventPayloadField>;
 /**
  * Event contract for events a trait emits.
  * Declares the event name, scope, and payload schema.
  */
-interface TraitEventContract {
+type 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
@@ -2114,7 +2181,7 @@ interface TraitEventContract {
      * - 'external': Exposed for cross-orbital communication
      */
     scope?: EventScope;
-}
+};
 /**
  * `@config.<knob>` is the only legal reference form for an emit/listen
  * event name (Option B — the declared event name resolves to a
@@ -2153,6 +2220,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 +2233,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 +2241,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 +2266,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 +2286,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 {
+type 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). */
@@ -2255,10 +2344,12 @@ interface TraitEventListener {
      * a local payload declaration rather than a bus subscription.
      */
     source?: ListenSource;
-}
+};
 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 +2365,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 +2403,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,34 +2427,39 @@ 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;
 }>;
 /**
  * Field required by a trait from its linkedEntity
  */
-interface RequiredField {
+type RequiredField = {
     name: string;
     type: 'string' | 'number' | 'boolean' | 'date' | 'array' | 'object' | 'timestamp' | 'datetime' | 'enum';
     description?: string;
-}
+};
 declare const RequiredFieldSchema: 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;
 }>;
@@ -2361,8 +2471,18 @@ declare const RequiredFieldSchema: z.ZodObject<{
  * identifier-substitution pass uses these arguments to rewrite the
  * inlined trait clone before lowering.
  */
-interface TraitReference {
+type 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 +2492,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,
@@ -2435,66 +2559,86 @@ interface TraitReference {
      * }
      * ```
      */
-    effects?: Record<string, unknown[]>;
-}
+    effects?: Record<string, SExpr[]>;
+};
 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">>;
     listens: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
     emitsScope: z.ZodOptional<z.ZodEnum<["internal", "external"]>>;
-    effects: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown, "many">>>;
+    effects: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodType<SExpr, z.ZodTypeDef, SExpr>, "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;
+    effects?: Record<string, SExpr[]> | 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;
+    effects?: Record<string, SExpr[]> | 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;
+    effects?: Record<string, SExpr[]> | 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;
+    effects?: Record<string, SExpr[]> | 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;
 }>;
@@ -2515,7 +2659,7 @@ type TraitRef = string | {
     events?: Record<string, string>;
 } | Trait;
 type PresentationType = 'modal' | 'drawer' | 'popover' | 'inline' | 'confirm-dialog';
-interface TraitUIBinding {
+type TraitUIBinding = {
     [stateName: string]: {
         presentation: PresentationType;
         content: AnyPatternConfig | AnyPatternConfig[];
@@ -2530,7 +2674,7 @@ interface TraitUIBinding {
             totalSteps?: number;
         };
     };
-}
+};
 /**
  * A Trait is a reusable behavioral module with state machine.
  *
@@ -2560,10 +2704,10 @@ type TraitScope = 'instance' | 'collection';
  * validator enforces it (`ORB_T_REBIND_MISSING_FIELDS`). Mirrors the Rust
  * `EntityFieldContract` serde shape exactly.
  */
-interface EntityFieldContract {
+type EntityFieldContract = {
     requires: string[];
     provides: string[];
-}
+};
 declare const EntityFieldContractSchema: z.ZodObject<{
     requires: z.ZodArray<z.ZodString, "many">;
     provides: z.ZodArray<z.ZodString, "many">;
@@ -2574,7 +2718,9 @@ declare const EntityFieldContractSchema: z.ZodObject<{
     requires: string[];
     provides: string[];
 }>;
-interface Trait {
+type 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 +2769,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;
@@ -2662,14 +2825,14 @@ interface Trait {
      * `linkedEntity` without re-walking the import graph at runtime.
      */
     sourceEntityDefinition?: Entity;
-}
+};
 /**
  * Provenance attached to a trait that was cloned from a `uses[]` import
  * during the inline phase. The resolved schema carries this so Studio
  * can group L2 cards by source behavior and offer an L3 drill into the
  * import's own transitions.
  */
-interface SourceBehaviorMetadata {
+type SourceBehaviorMetadata = {
     /** Behavior name (e.g. "std-stat-card") — the resolved `from:` value. */
     behavior: string;
     /** Alias used at the import site (e.g. "Stat"). Multiple imports of
@@ -2678,8 +2841,9 @@ interface SourceBehaviorMetadata {
     /** Original trait name inside the imported behavior, before any
      *  call-site `name:` rename. */
     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 +2864,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 +2936,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 +2947,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 +2957,7 @@ declare const TraitSchema: z.ZodObject<{
         }, {
             name: string;
             key: string;
+            id?: string | undefined;
             description?: string | undefined;
             synonyms?: string | undefined;
             tier?: string | undefined;
@@ -2799,6 +2969,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 +2978,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 +2986,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 +3007,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 +3029,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 +3042,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 +3064,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 +3082,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 +3096,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 +3108,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 +3123,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 +3136,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 +3144,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 +3166,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 +3204,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 +3228,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 +3338,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 +3358,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 +3380,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 +3397,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 +3411,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 +3434,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 +3451,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 +3484,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 +3504,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 +3526,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 +3543,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 +3557,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 +3580,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 +3597,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 +3647,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 +3668,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 +3740,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 +3751,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 +3761,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 +3773,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 +3782,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 +3790,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 +3811,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 +3833,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 +3846,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 +3868,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 +3886,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 +3900,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 +3912,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 +3927,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 +3940,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 +3948,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 +3970,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 +4008,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 +4032,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 +4142,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 +4162,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 +4184,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 +4201,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 +4215,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 +4238,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 +4255,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 +4288,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 +4308,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 +4330,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 +4347,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 +4361,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 +4384,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 +4401,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 +4521,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 +4542,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 +4614,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 +4625,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 +4635,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 +4647,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 +4656,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 +4664,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 +4685,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 +4707,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 +4720,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 +4742,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 +4760,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 +4774,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 +4786,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 +4801,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 +4814,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 +4822,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 +4844,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 +4882,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 +4906,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 +5016,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 +5036,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 +5058,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 +5075,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 +5089,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 +5112,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 +5129,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 +5162,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 +5182,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 +5204,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 +5221,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 +5235,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 +5258,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 +5275,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 +5307,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 };