@almadar/core 10.35.0 → 10.36.0

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { h as ANIMATION_NAMES, i as ASSET_ASPECTS, j as ASSET_DIMENSIONS, k as A
 import { S as SExpr, a as EventPayload } from './expression-DpAj1RzP.js';
 export { C as CORE_BINDINGS, b as CoreBinding, c as EvalContext, d as EventPayloadValue, E as Expression, e as ExpressionInput, f as ExpressionSchema, L as LogMeta, g as LogMetaValue, P as ParsedBinding, h as SExprAtom, i as SExprAtomSchema, j as SExprInput, k as SExprSchema, l as collectBindings, m as getArgs, n as getOperator, o as isBinding, p as isEventPayloadValue, q as isSExpr, r as isSExprAtom, s as isSExprCall, t as isValidBinding, u as parseBinding, v as sexpr, w as walkSExpr } from './expression-DpAj1RzP.js';
 import { ResolvedIR, ResolvedEntity, ResolvedPage, ResolvedTrait, ChangesetValue, SchemaChange, CategorizedRemovals, PageContentReduction, SemanticSchemaChange } from './types/index.js';
-export { AgentCodeSearchResult, AgentCompactResult, AgentCompactStrategy, AgentContext, AgentGenerateOptions, AgentMemoryCategory, AgentMemoryRecord, AnalysisOrbital, AnalysisOrbitalParams, AnalysisPageOverride, AnalysisRename, AnalysisResult, AnnotationTier, AppCreatedEvent, AppSummary, AssetLoadStatus, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingContext, BindingRoot, BindingSchema, BridgeHealth, BuilderResult, BusEvent, BusEventListener, BusEventSource, CancelledEvent, ChangeAuthor, ChangeSetDocument, ChangeSummary, ChangesetRecordedEvent, CheckStatus, Clarification, ClarificationCandidate, ClarificationLevel, CompleteEvent, ComplexityAssessment, ComposeAllResult, ComposeChildrenResult, ComposeOptions, ContextExtensions, CreateFlow, DEFAULT_INTERACTION_MODELS, DeleteFlow, DispatchUpdatesResult, EdgeType, EditFlow, EffectPayload, EffectResult, EffectTrace, ErrorEvent, EventEmit, EventKey, EventListen, EventLogEntry, EvolutionDelta, ExecutePlanResult, ExtraTraitRef, FileOperationEvent, FileWrittenEvent, GateState, GenerationLogEvent, GitHubIssue, GitHubLink, GitHubRepo, HistoryMeta, IntegrationContext, InteractionModel, InteractionModelInput, InteractionModelSchema, InterruptEvent, KNOWN_VALIDATION_ERROR_CODES, KnobPayload, KnownValidationErrorCode, LazyService, LineageEntry, ListInteraction, LivingEdge, LivingEffect, LivingEntity, LivingEvent, LivingField, LivingOrbital, LivingOrbitalSchema, LivingPage, LivingState, LivingTrait, LivingTransition, LivingValue, LivingVertex, LlmCallToolsResult, LlmContext, LlmMessage, LlmTokenUsage, LlmToolCall, LlmToolDef, LoloEmitResult, MemoryContext, MessageEvent, OrbitalAddedEvent, OrbitalSchemaCompleteEvent, OrbitalVerificationAPI, ParamsRepairEmittedEvent, ParsedDesign, ParsedDomainContext, ParsedEmitDeclaration, ParsedEntity, ParsedEvent, ParsedListenDeclaration, ParsedOrbital, ParsedPage, ParsedState, ParsedStateMachine, ParsedTrait, ParsedTraitConfig, ParsedTransition, PatternTypeSchema, PersistActionName, PlanSnapshot, PlanSnapshotStatus, PlannerResult, Probability, ProcessCompleteEvent, ProcessErrorEvent, ProcessRepairCompleteEvent, ProcessRepairEvent, ProcessStartEvent, RepairResult, ResolvedEntityBinding, ResolvedField, ResolvedNavigation, ResolvedPattern, ResolvedSection, ResolvedSectionEvent, ResolvedTraitBinding, ResolvedTraitDataEntity, ResolvedTraitEvent, ResolvedTraitGuard, ResolvedTraitListener, ResolvedTraitState, ResolvedTraitTick, ResolvedTraitTransition, ResolvedTraitUIBinding, SSEEvent, SSEEventBase, SSEEventType, SaveOptions, SaveResult, SchemaPhaseUpdateEvent, SchemaPhaseValidatedEvent, SchemaUpdateEvent, SemanticAnnotation, SemanticChangeKind, SemanticVector, ServerResponseTrace, ServiceAction, ServiceActionName, ServiceCallResult, ServiceContract, ServiceEvents, SessionContext, SessionHistoryEntry, SnapshotCreatedEvent, SnapshotDocument, SpawnResult, StartEvent, StatsView, StoreContract, StoreFilter, StoreFilterOp, SubagentCompleteEvent, SubagentEvent, SubagentProgressEvent, SubagentStartEvent, TodoActivityType, TodoDetailEvent, TodoUpdateEvent, ToolCallEvent, ToolResultEvent, TraceContext, TraitFieldRef, TraitFieldRefSchema, TraitStateSnapshot, TransitionFrom, TransitionTrace, Unsubscribe, ValidateResult, ValidationDocument, ValidationError, ValidationErrorCode, ValidationIssue, ValidationMeta, ValidationResult, ValidationResults, VerificationCheck, VerificationSnapshot, VerificationSummary, VertexId, VertexPayload, VertexType, ViewFlow, WorkspaceContext, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, getBindingExamples, getInteractionModelForDomain, inferTsType, isKnownValidationErrorCode, isPlanSnapshot, isResolvedIR, isSessionHistoryEntry, isTraitFieldRef, toBindingRoot, validateBindingInContext, widenTier } from './types/index.js';
+export { ANONYMOUS_USER, AgentCodeSearchResult, AgentCompactResult, AgentCompactStrategy, AgentContext, AgentGenerateOptions, AgentMemoryCategory, AgentMemoryRecord, AnalysisOrbital, AnalysisOrbitalParams, AnalysisPageOverride, AnalysisRename, AnalysisResult, AnnotationTier, AppCreatedEvent, AppSummary, AssetLoadStatus, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingContext, BindingRoot, BindingSchema, BridgeHealth, BuilderResult, BusEvent, BusEventListener, BusEventSource, CancelledEvent, ChangeAuthor, ChangeSetDocument, ChangeSummary, ChangesetRecordedEvent, CheckStatus, Clarification, ClarificationCandidate, ClarificationLevel, CompleteEvent, ComplexityAssessment, ComposeAllResult, ComposeChildrenResult, ComposeOptions, ContextExtensions, CreateFlow, DEFAULT_INTERACTION_MODELS, DEV_TOKEN_PREFIX, DeleteFlow, DispatchUpdatesResult, EdgeType, EditFlow, EffectPayload, EffectResult, EffectTrace, ErrorEvent, EventEmit, EventKey, EventListen, EventLogEntry, EvolutionDelta, ExecutePlanResult, ExtraTraitRef, FileOperationEvent, FileWrittenEvent, GateState, GenerationLogEvent, GitHubIssue, GitHubLink, GitHubRepo, HistoryMeta, IntegrationContext, InteractionModel, InteractionModelInput, InteractionModelSchema, InterruptEvent, KNOWN_VALIDATION_ERROR_CODES, KnobPayload, KnownValidationErrorCode, LazyService, LineageEntry, ListInteraction, LivingEdge, LivingEffect, LivingEntity, LivingEvent, LivingField, LivingOrbital, LivingOrbitalSchema, LivingPage, LivingState, LivingTrait, LivingTransition, LivingValue, LivingVertex, LlmCallToolsResult, LlmContext, LlmMessage, LlmTokenUsage, LlmToolCall, LlmToolDef, LoloEmitResult, MOCK_PERSONAS, MemoryContext, MessageEvent, OrbitalAddedEvent, OrbitalSchemaCompleteEvent, OrbitalVerificationAPI, ParamsRepairEmittedEvent, ParsedDesign, ParsedDomainContext, ParsedEmitDeclaration, ParsedEntity, ParsedEvent, ParsedListenDeclaration, ParsedOrbital, ParsedPage, ParsedState, ParsedStateMachine, ParsedTrait, ParsedTraitConfig, ParsedTransition, PatternTypeSchema, PersistActionName, PlanSnapshot, PlanSnapshotStatus, PlannerResult, Probability, ProcessCompleteEvent, ProcessErrorEvent, ProcessRepairCompleteEvent, ProcessRepairEvent, ProcessStartEvent, RawUserClaims, RepairResult, ResolvedEntityBinding, ResolvedField, ResolvedNavigation, ResolvedPattern, ResolvedSection, ResolvedSectionEvent, ResolvedTraitBinding, ResolvedTraitDataEntity, ResolvedTraitEvent, ResolvedTraitGuard, ResolvedTraitListener, ResolvedTraitState, ResolvedTraitTick, ResolvedTraitTransition, ResolvedTraitUIBinding, SSEEvent, SSEEventBase, SSEEventType, SaveOptions, SaveResult, SchemaPhaseUpdateEvent, SchemaPhaseValidatedEvent, SchemaUpdateEvent, SemanticAnnotation, SemanticChangeKind, SemanticVector, ServerResponseTrace, ServiceAction, ServiceActionName, ServiceCallResult, ServiceContract, ServiceEvents, SessionContext, SessionHistoryEntry, SnapshotCreatedEvent, SnapshotDocument, SpawnResult, StartEvent, StatsView, StoreContract, StoreFilter, StoreFilterOp, SubagentCompleteEvent, SubagentEvent, SubagentProgressEvent, SubagentStartEvent, TodoActivityType, TodoDetailEvent, TodoUpdateEvent, ToolCallEvent, ToolResultEvent, TraceContext, TraitFieldRef, TraitFieldRefSchema, TraitStateSnapshot, TransitionFrom, TransitionTrace, Unsubscribe, UserContext, ValidateResult, ValidationDocument, ValidationError, ValidationErrorCode, ValidationIssue, ValidationMeta, ValidationResult, ValidationResults, VerificationCheck, VerificationSnapshot, VerificationSummary, VertexId, VertexPayload, VertexType, ViewFlow, WorkspaceContext, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, decodeDevIdentityToken, encodeDevIdentityToken, findMockPersona, getBindingExamples, getInteractionModelForDomain, inferTsType, isKnownValidationErrorCode, isPlanSnapshot, isResolvedIR, isSessionHistoryEntry, isTraitFieldRef, normalizeUserContext, resolvePersonaSpec, toBindingRoot, validateBindingInContext, widenTier } from './types/index.js';
 import { d as TraitConfig, S as State } from './trait-X5mQAMtW.js';
 export { e as CONFIG_REF_EVENT_PATTERN, C as CallSiteConfig, b as CallSiteConfigEntry, f as ConfigFieldDeclaration, g as ConfigFieldDeclarationSchema, h as ConfigFieldItemsDeclaration, i as ConfigRefEventError, D as DeclaredTraitConfig, j as DeclaredTraitConfigSchema, E as EntityFieldContract, k as EntityFieldContractSchema, l as Event, m as EventInput, n as EventPayloadField, o as EventPayloadFieldSchema, p as EventSchema, q as EventScope, r as EventScopeSchema, G as Guard, s as GuardInput, t as GuardSchema, L as ListenSource, u as ListenSourceSchema, O as OrbitalTraitRef, v as OrbitalTraitRefSchema, P as PayloadField, w as PayloadFieldSchema, x as PresentationType, R as REFERENCE_CONFIG_TYPES, y as ReferenceConfigType, z as RequiredField, A as RequiredFieldSchema, B as StateInput, F as StateMachine, H as StateMachineInput, I as StateMachineSchema, J as StateSchema, c as Trait, K as TraitCategory, M as TraitCategorySchema, N as TraitConfigObject, Q as TraitConfigSchema, U as TraitConfigValue, V as TraitConfigValueSchema, W as TraitDataEntity, X as TraitDataEntitySchema, Y as TraitEntityField, Z as TraitEntityFieldSchema, _ as TraitEventContract, $ as TraitEventContractSchema, T as TraitEventListener, a0 as TraitEventListenerSchema, a1 as TraitInput, a2 as TraitRef, a3 as TraitRefSchema, a as TraitReference, a4 as TraitReferenceInput, a5 as TraitReferenceSchema, a6 as TraitSchema, a7 as TraitTick, a8 as TraitTickSchema, a9 as TraitUIBinding, aa as Transition, ab as TransitionInput, ac as TransitionSchema, ad as configRefEventKnob, ae as getTraitConfig, af as getTraitName, ag as isCallSiteConfigDeclaration, ah as isCircuitEvent, ai as isInlineTrait, aj as isReferenceConfigType, ak as normalizeCallSiteConfigToValues, al as normalizeTraitRef, am as resolveConfigRefEventName } from './trait-X5mQAMtW.js';
 export { F as FactoryCallSite, a as FactoryCallSiteParams, b as FactoryConfigParam, c as FactoryConfigTier, d as FactoryEntitySignature, e as FactoryEventSignature, f as FactoryExposure, g as FactoryPageSignature, h as FactoryParamValue, i as FactoryProvenance, j as FactorySignature, k as FactorySignatureCatalog, l as FactorySignatureEntityField, m as FactoryTraitSignature, J as JsonSchema, n as JsonSchemaType, O as OwnershipOverlayEntry, P as PresentationNavItem, o as PresentationOverlay, R as RuleOverlay, p as RuleOverlayEntry, S as SchemaFieldType, T as TraitOverlay, q as TraitOverlayEntry, r as TraitOverlayListener } from './types-DujRcijG.js';
@@ -487,6 +487,77 @@ type ListenPayloadEvaluator = (expr: SExpr, payload: EventPayload) => unknown;
  */
 declare function applyListenPayloadMapping(payloadMapping: Record<string, SExpr> | undefined, payload: EventPayload | undefined, evaluate: ListenPayloadEvaluator): EventPayload | undefined;
 
+/**
+ * ML contract validation — the ONE pure implementation shared by the runtime
+ * path (`@almadar/evaluator`'s contract/* operators) and the compiled path
+ * (the TypeScript shell imports `validateContract` directly, so the two
+ * paths cannot drift). Mirrors `contract_helpers.py` (emitted by
+ * `orbital-shell-python`) semantically: same contract JSON in, same
+ * `{valid, violations}` out.
+ *
+ * A tensor on the JS side is a plain JSON value — a number, or (possibly
+ * nested) arrays of numbers — exactly what a `torch.Tensor` round-trips
+ * to/from via `tolist()`.
+ *
+ * @packageDocumentation
+ */
+/** A tensor on the JS path: a number, or nested arrays of numbers. */
+type TensorValue = number | TensorValue[];
+/** Per-dimension range bound. Missing bounds default to +-Infinity, matching contract_helpers.py's `float("-inf")`/`float("inf")`. */
+interface ContractRange {
+    min?: number;
+    max?: number;
+}
+interface ContractFieldSpec {
+    name: string;
+}
+type ContractFieldEntry = string | ContractFieldSpec;
+/**
+ * Canonical contract shape (matches contract_helpers.py's dict contracts
+ * byte-for-byte): `shape`/`ranges` drive validate/clamp/violations, `fields`
+ * drives the entity<->tensor mapping. A single contract object may carry
+ * both halves.
+ */
+interface ContractSpec {
+    shape?: number[];
+    ranges?: Record<string, ContractRange>;
+    fields?: ContractFieldEntry[];
+}
+interface ContractViolation {
+    type: 'shape_mismatch' | 'range_violation' | 'not_a_tensor';
+    expected?: number[];
+    actual?: number[];
+    dim?: number;
+    min?: number;
+    max?: number;
+    actualMin?: number;
+    actualMax?: number;
+    /** `not_a_tensor` only — what arrived instead, for diagnosis. */
+    actualType?: string;
+}
+interface ContractValidationResult {
+    valid: boolean;
+    violations: ContractViolation[];
+}
+declare function contractFieldName(f: ContractFieldEntry): string;
+/**
+ * A JS-path tensor is a number or nested arrays of numbers. Model output
+ * arrives from an untrusted service, so every contract operator guards before
+ * walking it — an unguarded walk throws a bare `TypeError` three frames deep,
+ * which stalls the transition instead of abstaining.
+ */
+declare function isTensorValue(v: unknown): v is TensorValue;
+/** What arrived instead of a tensor, for the `not_a_tensor` violation. */
+declare function describeTensorMismatch(v: unknown): string;
+/** Shape of a tensor value, e.g. `[[1,2],[3,4]]` -> `[2,2]`, `[1,2,3]` -> `[3]`. */
+declare function tensorShape(t: TensorValue): number[];
+declare function tensorLastDimSize(t: TensorValue): number;
+/** All values at index `dim` along the last axis, flattened across every leading axis — mirrors `tensor[..., dim]`. */
+declare function gatherTensorLastDim(t: TensorValue, dim: number): number[];
+/** Replace values at index `dim` along the last axis via `fn` — mirrors in-place `result[..., dim] = ...clamp(...)`. */
+declare function mapTensorLastDim(t: TensorValue, dim: number, fn: (v: number) => number): TensorValue;
+declare function validateContract(tensor: unknown, contract: ContractSpec): ContractValidationResult;
+
 /**
  * Schema Diffing & Protection
  *
@@ -688,4 +759,4 @@ type EntityFrameState = EntityRow;
  */
 declare function mergeEntityFrame(current: EntityFrameState, orderedWrites: readonly EntityFieldWrite[]): EntityFrameState;
 
-export { OrbitalSchema as AppSchema, CategorizedRemovals, ChangesetValue, type EditFocus, type EditFocusLevel, type EntityFieldWrite, type EntityFrameState, EntityRow, EventPayload, FieldValue, JsonValue, type ListenPayloadEvaluator, OrbitalDefinition, OrbitalSchema, PageContentReduction, type PatternNode, type PatternValue, type RenderOverlayResult, type RenderUiPatch, type RenderUiPatchAddress, type RenderUiPatchOp, ResolvedEntity, ResolvedIR, ResolvedPage, ResolvedTrait, SExpr, SchemaChange, type SchemaDiff, type SchemaDiffAuthor, type SchemaDiffChange, type SchemaDiffChangeset, type SchemaDiffMode, type SchemaDiffOptions, type SchemaDiffSource, type SchemaDiffSummary, SemanticSchemaChange, State, ToolArgs, type TraceActivity, type TraceActivityItem, type TraceAvatarRole, type TraceChatMessage, type TraceChatMessageToolCall, type TraceDiffHunk, type TraceDiffLine, type TraceFileOperation, type TraceSubagent, type TraceSubagentMessage, TraitConfig, OrbitalDefinition as ValidatedOrbital, applyListenPayloadMapping, applyRenderOverlay, buildResolvedTraitConfigs, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectEmbeddedTraitReferrers, collectTraitConfigRefAdjacency, collectTraitEmbedAdjacency, detectPageContentReduction, diffOrbitalSchemas, diffSchemaSemantics, diffSchemas, fingerprintNode, getEntity, getPage, getPages, getRemovals, getSchemaCacheStats, getTrait, hasSignificantPageReduction, insertChildAtPath, isDestructiveChange, mergeEntityFrame, navigatePatternPath, removeChildAtPath, replaceChildAtPath, requiresConfirmation, schemaToIR, setPropAtPath, summarizeOrbital, summarizeSchema };
+export { OrbitalSchema as AppSchema, CategorizedRemovals, ChangesetValue, type ContractFieldEntry, type ContractFieldSpec, type ContractRange, type ContractSpec, type ContractValidationResult, type ContractViolation, type EditFocus, type EditFocusLevel, type EntityFieldWrite, type EntityFrameState, EntityRow, EventPayload, FieldValue, JsonValue, type ListenPayloadEvaluator, OrbitalDefinition, OrbitalSchema, PageContentReduction, type PatternNode, type PatternValue, type RenderOverlayResult, type RenderUiPatch, type RenderUiPatchAddress, type RenderUiPatchOp, ResolvedEntity, ResolvedIR, ResolvedPage, ResolvedTrait, SExpr, SchemaChange, type SchemaDiff, type SchemaDiffAuthor, type SchemaDiffChange, type SchemaDiffChangeset, type SchemaDiffMode, type SchemaDiffOptions, type SchemaDiffSource, type SchemaDiffSummary, SemanticSchemaChange, State, type TensorValue, ToolArgs, type TraceActivity, type TraceActivityItem, type TraceAvatarRole, type TraceChatMessage, type TraceChatMessageToolCall, type TraceDiffHunk, type TraceDiffLine, type TraceFileOperation, type TraceSubagent, type TraceSubagentMessage, TraitConfig, OrbitalDefinition as ValidatedOrbital, applyListenPayloadMapping, applyRenderOverlay, buildResolvedTraitConfigs, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectEmbeddedTraitReferrers, collectTraitConfigRefAdjacency, collectTraitEmbedAdjacency, contractFieldName, describeTensorMismatch, detectPageContentReduction, diffOrbitalSchemas, diffSchemaSemantics, diffSchemas, fingerprintNode, gatherTensorLastDim, getEntity, getPage, getPages, getRemovals, getSchemaCacheStats, getTrait, hasSignificantPageReduction, insertChildAtPath, isDestructiveChange, isTensorValue, mapTensorLastDim, mergeEntityFrame, navigatePatternPath, removeChildAtPath, replaceChildAtPath, requiresConfirmation, schemaToIR, setPropAtPath, summarizeOrbital, summarizeSchema, tensorLastDimSize, tensorShape, validateContract };

package/dist/index.js

@@ -1923,6 +1923,75 @@ function isTraitFieldRef(value) {
 }
 var TraitFieldRefSchema = z.string().regex(TRAIT_REF_PATTERN, "expected `@trait.<TraitName>` reference");
 
+// src/types/user.ts
+var ANONYMOUS_USER = {
+  id: "anonymous",
+  role: "anonymous",
+  permissions: []
+};
+var DERIVED_CLAIM_KEYS = ["id", "name", "displayName", "email"];
+function normalizeUserContext(claims) {
+  if (!claims) return void 0;
+  const id = claims.id ?? claims.uid;
+  if (typeof id !== "string" || id.length === 0) return void 0;
+  const user = { id };
+  for (const [key, value] of Object.entries(claims)) {
+    if (value === void 0 || DERIVED_CLAIM_KEYS.includes(key)) continue;
+    user[key] = value;
+  }
+  const name = claims.name ?? claims.displayName;
+  if (typeof name === "string" && name.length > 0) user.name = name;
+  if (typeof claims.email === "string" && claims.email.length > 0) user.email = claims.email;
+  return user;
+}
+var MOCK_PERSONAS = [
+  { id: "admin-1", name: "Ada Admin", email: "ada@example.com", role: "admin", permissions: ["read", "write", "delete"] },
+  { id: "staff-1", name: "Sam Staff", email: "sam@example.com", role: "staff", permissions: ["read", "write"] },
+  { id: "member-1", name: "Maya Member", email: "maya@example.com", role: "member", permissions: ["read"] },
+  { id: "customer-1", name: "Cai Customer", email: "cai@example.com", role: "customer", permissions: ["read"] }
+];
+function findMockPersona(idOrRole) {
+  return MOCK_PERSONAS.find((p) => p.id === idOrRole) ?? MOCK_PERSONAS.find((p) => p.role === idOrRole);
+}
+function resolvePersonaSpec(spec) {
+  const raw = spec.trim();
+  if (!raw.startsWith("{")) {
+    const seeded = findMockPersona(raw);
+    if (!seeded) {
+      throw new Error(
+        `Persona "${raw}" is not a seeded persona id or role. Known: ${MOCK_PERSONAS.map((p) => `${p.id}/${p.role}`).join(", ")}`
+      );
+    }
+    return seeded;
+  }
+  let claims;
+  try {
+    claims = JSON.parse(raw);
+  } catch {
+    throw new Error(`Persona is not valid JSON: ${raw}`);
+  }
+  const user = normalizeUserContext(claims);
+  if (!user) {
+    throw new Error(`Persona needs an "id" (or "uid"): ${raw}`);
+  }
+  return user;
+}
+var DEV_TOKEN_PREFIX = "almadar-dev.";
+function encodeDevIdentityToken(user) {
+  return DEV_TOKEN_PREFIX + encodeURIComponent(JSON.stringify(user));
+}
+function decodeDevIdentityToken(token) {
+  if (!token.startsWith(DEV_TOKEN_PREFIX)) return void 0;
+  try {
+    const claims = JSON.parse(
+      decodeURIComponent(token.slice(DEV_TOKEN_PREFIX.length))
+    );
+    return normalizeUserContext(claims);
+  } catch {
+    return void 0;
+  }
+}
+
 // src/types/agent.ts
 function isSessionHistoryEntry(value) {
   if (typeof value !== "object" || value === null) return false;
@@ -47074,6 +47143,80 @@ function applyListenPayloadMapping(payloadMapping, payload, evaluate) {
   return mapped;
 }
 
+// src/ml-contract.ts
+function contractFieldName(f) {
+  return typeof f === "string" ? f : f.name;
+}
+function isTensorValue(v) {
+  if (typeof v === "number") return true;
+  return Array.isArray(v) && v.every(isTensorValue);
+}
+function describeTensorMismatch(v) {
+  if (v === null) return "null";
+  if (Array.isArray(v)) return "array containing non-numeric values";
+  return typeof v;
+}
+function tensorShape(t) {
+  if (typeof t === "number") return [];
+  if (t.length === 0) return [0];
+  const first = t[0];
+  if (typeof first === "number") return [t.length];
+  return [t.length, ...tensorShape(first)];
+}
+function tensorLastDimSize(t) {
+  const shape = tensorShape(t);
+  return shape.length === 0 ? 0 : shape[shape.length - 1];
+}
+function arraysEqual(a, b) {
+  return a.length === b.length && a.every((v, i) => v === b[i]);
+}
+function gatherTensorLastDim(t, dim) {
+  if (typeof t === "number") return [];
+  if (t.length === 0) return [];
+  if (typeof t[0] === "number") return [t[dim]];
+  const out = [];
+  for (const sub of t) out.push(...gatherTensorLastDim(sub, dim));
+  return out;
+}
+function mapTensorLastDim(t, dim, fn) {
+  if (typeof t === "number") return t;
+  if (t.length === 0) return t;
+  if (typeof t[0] === "number") {
+    const copy = [...t];
+    copy[dim] = fn(copy[dim]);
+    return copy;
+  }
+  return t.map((sub) => mapTensorLastDim(sub, dim, fn));
+}
+function validateContract(tensor, contract) {
+  if (!isTensorValue(tensor)) {
+    return {
+      valid: false,
+      violations: [{ type: "not_a_tensor", actualType: describeTensorMismatch(tensor) }]
+    };
+  }
+  const violations = [];
+  const shape = tensorShape(tensor);
+  if (contract.shape && !arraysEqual(shape, contract.shape)) {
+    violations.push({ type: "shape_mismatch", expected: contract.shape, actual: shape });
+  }
+  const ranges = contract.ranges ?? {};
+  const size = tensorLastDimSize(tensor);
+  for (const [dimStr, bounds] of Object.entries(ranges)) {
+    const dim = Number(dimStr);
+    if (dim >= size) continue;
+    const vals = gatherTensorLastDim(tensor, dim);
+    const min = bounds.min ?? -Infinity;
+    const max = bounds.max ?? Infinity;
+    const actualMin = Math.min(...vals);
+    const actualMax = Math.max(...vals);
+    if (actualMin < min || actualMax > max) {
+      violations.push({ type: "range_violation", dim, min, max, actualMin, actualMax });
+    }
+  }
+  return { valid: violations.length === 0, violations };
+}
+
 // src/diff.ts
 function diffSchemas(before, after) {
   const changes = [];
@@ -49240,6 +49383,6 @@ function mergeEntityFrame(current, orderedWrites) {
   return next;
 }
 
-export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, ANIMATION_NAMES, ASSET_ASPECTS, ASSET_DIMENSIONS, AgentDomainCategorySchema, AnimationDefSchema, AnimationNameSchema, AssetAspectSchema, AssetCatalogEntrySchema, AssetCatalogSchema, AssetDimensionSchema, AssetSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingSchema, CAMERA_MODES, COMPONENT_MAPPING, CONFIG_REF_EVENT_PATTERN, CORE_BINDINGS, CameraModeSchema, CameraSchema, ColorSliceSchema, ColorTokensSchema, ComputedEventContractSchema, ComputedEventListenerSchema, ConfigFieldDeclarationSchema, ConfigProvenanceRecordSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DeclaredTraitConfigSchema, DensitySliceSchema, DensityTokensSchema, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, ENTITY_ROLES, EVENT_CONTRACTS, EffectSchema, ElevationSliceSchema, ElevationTokensSchema, EntityCallSchema, EntityFieldContractSchema, EntityFieldSchema, EntityIdSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventIdSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FieldFormatSchema, FieldSchema, FieldTypeSchema, GameSubCategorySchema, GeometrySliceSchema, GeometryTokensSchema, GuardSchema, INTEGRATORS_REGISTRY, IconFamilySchema, IconographySliceSchema, IconographyTokensSchema, IdentityLedgerSchema, IllustrationSliceSchema, IllustrationStyleSchema, IllustrationTokensSchema, InteractionModelSchema, KNOWN_VALIDATION_ERROR_CODES, LedgerEntrySchema, LedgerKindSchema, ListenSourceSchema, McpServiceDefSchema, MotionDurationKeySchema, MotionDurationPaletteSchema, MotionEasingKeySchema, MotionEasingPaletteSchema, MotionIntentMapSchema, MotionIntentSchema, MotionSliceSchema, MotionTokensSchema, NodeClassificationSchema, OrbitalConfigSchema, OrbitalDefinitionSchema, OrbitalEntitySchema, OrbitalIdSchema, OrbitalPageSchema, OrbitalPageStrictSchema, OrbitalSchemaSchema, OrbitalTraitRefSchema, OrbitalUnitSchema, OrbitalSchema as OrbitalZodSchema, PATTERN_REGISTRY, PATTERN_TYPES, PageIdSchema, PageRefObjectSchema, PageRefSchema, PageRefStringSchema, PageSchema, PageTraitRefSchema, PaletteEntryIdSchema, PatternTypeSchema, PayloadFieldSchema, REFERENCE_CONFIG_TYPES, RelatedLinkSchema, RelationConfigSchema, RequiredFieldSchema, RestAuthConfigSchema, RestServiceDefSchema, SERVICE_TYPES, SExprAtomSchema, SExprSchema, SPRITE_DIRECTIONS, ScenePosSchema, SchemaMetadataSchema, SemanticAssetRefSchema, ServiceDefinitionSchema, ServiceIdSchema, ServiceRefObjectSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SkinSpecSchema, SocketEventsSchema, SocketServiceDefSchema, SpacingScaleSchema, SpriteDirectionSchema, SpriteSheetAtlasSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SubTextureSchema, SuggestedGuardSchema, TextureAtlasSchema, ThemeDefinitionSchema, ThemeIdSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TilesheetSchema, TraitCategorySchema, TraitConfigSchema, TraitConfigValueSchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitFieldRefSchema, TraitIdSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, TypeIntentMapSchema, TypeIntentSchema, TypeScaleEntrySchema, TypeScaleSchema, TypeScaleTokensSchema, TypeSizeKeySchema, TypeSliceSchema, TypeSlotSchema, TypeWeightSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, answerToMutations, answersToMutations, applyEventWiring, applyFactoryCallPlanMutation, applyListenPayloadMapping, applyRenderOverlay, asEntityId, asEventId, asOrbitalId, asPageId, asPaletteEntryId, asServiceId, asThemeId, asTraitId, atomic, buildEdgeCoveringWalk, buildGuardPayloads, buildRecommendationContext, buildReplayPaths, buildResolvedTraitConfigs, buildStateGraph, callService, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectBindings, collectEmbeddedTraitReferrers, collectReachableStates, collectRenderUiPatternTypes, collectTraitConfigRefAdjacency, collectTraitEmbedAdjacency, component_mapping_default as componentMapping, composeBehaviors, configRefEventKnob, constTruth, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, deref, deriveCollection, deriveInputType, despawn, detectLayoutStrategy, detectPageContentReduction, diffFactoryCalls, diffOrbitalSchemas, diffSchemaSemantics, diffSchemas, doEffects, emit, event_contracts_default as eventContracts, extractPayloadFieldRef, findCompatiblePatterns, findService, fingerprintNode, formatRecommendationsForPrompt, generatePatternDescription, generateQuestions, getAllPatternTypes, getArgs, getBindingExamples, getComponentForPattern, getDefaultAnimationsForRole, getEmittedEvents, getEntity, getEntityCardinality, getInteractionModelForDomain, getOperator, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPage, getPages, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, getRemovals, getSchemaCacheStats, getServiceNames, getTrait, getTraitConfig, getTraitName, hasService, hasSignificantPageReduction, idKindOf, idPrefix, inferTsType, insertChildAtPath, integrators_registry_default as integratorsRegistry, isBinding, isCallSiteConfigDeclaration, isCircuitEvent, isContentBodyPattern, isContentBodyPatternType, isDestructiveChange, isDrawHostPattern, isDrawablePattern, isEffect, isEntityAwarePattern, isEntityCall, isEntityId, isEntityReference, isEntityReferenceAny, isEventId, isEventPayloadValue, isFieldValue, isImportedTraitRef, isInlineTrait, isJsonArray, isJsonObject, isJsonPrimitive, isKnownValidationErrorCode, isMainSlotRenderUi, isMcpService, isOrbitalDefinition, isOrbitalId, isPageId, isPageReference, isPageReferenceObject, isPageReferenceString, isPaletteEntryId, isPlanSnapshot, isReferenceConfigType, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceId, isServiceReference, isServiceReferenceObject, isSessionHistoryEntry, isSocketService, isThemeId, isThemeReference, isTraitFieldRef, isTraitId, isValidBinding, isValidPatternType, ledgerCurName, ledgerRename, ledgerResolveName, mergeEntityFrame, mintId, navigate, navigatePatternPath, normalizeCallSiteConfigToValues, normalizeTraitRef, notify, parseAssetKey, parseBinding, parseEntityRef, parseImportedTraitRef, parseOrbitalSchema, parsePageRef, parseServiceRef, patterns_registry_default as patternsRegistry, persist, persistenceModeAllowsOverrides, recommendPatterns, ref, registry, removeChildAtPath, renderUI, renderUiPatternTypesOf, replaceChildAtPath, requiresConfirmation, resolveConfigRefEventName, safeParseOrbitalSchema, schemaToIR, set, setPropAtPath, sexpr, spawn, summarizeOrbital, summarizeSchema, swap, toBindingRoot, translateOverlaysToParams, validateAssetAnimations, validateBindingInContext, walkSExpr, walkStatePairs, watch, widenTier };
+export { AGENT_DOMAIN_CATEGORIES, ALLOWED_CUSTOM_COMPONENTS, ANIMATION_NAMES, ANONYMOUS_USER, ASSET_ASPECTS, ASSET_DIMENSIONS, AgentDomainCategorySchema, AnimationDefSchema, AnimationNameSchema, AssetAspectSchema, AssetCatalogEntrySchema, AssetCatalogSchema, AssetDimensionSchema, AssetSchema, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingSchema, CAMERA_MODES, COMPONENT_MAPPING, CONFIG_REF_EVENT_PATTERN, CORE_BINDINGS, CameraModeSchema, CameraSchema, ColorSliceSchema, ColorTokensSchema, ComputedEventContractSchema, ComputedEventListenerSchema, ConfigFieldDeclarationSchema, ConfigProvenanceRecordSchema, CustomPatternDefinitionSchema, CustomPatternMapSchema, DEFAULT_INTERACTION_MODELS, DEV_TOKEN_PREFIX, DeclaredTraitConfigSchema, DensitySliceSchema, DensityTokensSchema, DesignPreferencesSchema, DesignTokensSchema, DomainCategorySchema, DomainContextSchema, DomainVocabularySchema, ENTITY_ROLES, EVENT_CONTRACTS, EffectSchema, ElevationSliceSchema, ElevationTokensSchema, EntityCallSchema, EntityFieldContractSchema, EntityFieldSchema, EntityIdSchema, EntityPersistenceSchema, EntityRefSchema, EntityRefStringSchema, EntityRoleSchema, EntitySchema, EntitySemanticRoleSchema, EventIdSchema, EventListenerSchema, EventPayloadFieldSchema, EventSchema, EventScopeSchema, EventSemanticRoleSchema, EventSourceSchema, ExpressionSchema, FieldFormatSchema, FieldSchema, FieldTypeSchema, GameSubCategorySchema, GeometrySliceSchema, GeometryTokensSchema, GuardSchema, INTEGRATORS_REGISTRY, IconFamilySchema, IconographySliceSchema, IconographyTokensSchema, IdentityLedgerSchema, IllustrationSliceSchema, IllustrationStyleSchema, IllustrationTokensSchema, InteractionModelSchema, KNOWN_VALIDATION_ERROR_CODES, LedgerEntrySchema, LedgerKindSchema, ListenSourceSchema, MOCK_PERSONAS, McpServiceDefSchema, MotionDurationKeySchema, MotionDurationPaletteSchema, MotionEasingKeySchema, MotionEasingPaletteSchema, MotionIntentMapSchema, MotionIntentSchema, MotionSliceSchema, MotionTokensSchema, NodeClassificationSchema, OrbitalConfigSchema, OrbitalDefinitionSchema, OrbitalEntitySchema, OrbitalIdSchema, OrbitalPageSchema, OrbitalPageStrictSchema, OrbitalSchemaSchema, OrbitalTraitRefSchema, OrbitalUnitSchema, OrbitalSchema as OrbitalZodSchema, PATTERN_REGISTRY, PATTERN_TYPES, PageIdSchema, PageRefObjectSchema, PageRefSchema, PageRefStringSchema, PageSchema, PageTraitRefSchema, PaletteEntryIdSchema, PatternTypeSchema, PayloadFieldSchema, REFERENCE_CONFIG_TYPES, RelatedLinkSchema, RelationConfigSchema, RequiredFieldSchema, RestAuthConfigSchema, RestServiceDefSchema, SERVICE_TYPES, SExprAtomSchema, SExprSchema, SPRITE_DIRECTIONS, ScenePosSchema, SchemaMetadataSchema, SemanticAssetRefSchema, ServiceDefinitionSchema, ServiceIdSchema, ServiceRefObjectSchema, ServiceRefSchema, ServiceRefStringSchema, ServiceTypeSchema, SkinSpecSchema, SocketEventsSchema, SocketServiceDefSchema, SpacingScaleSchema, SpriteDirectionSchema, SpriteSheetAtlasSchema, StateMachineSchema, StateSchema, StateSemanticRoleSchema, SubTextureSchema, SuggestedGuardSchema, TextureAtlasSchema, ThemeDefinitionSchema, ThemeIdSchema, ThemeRefSchema, ThemeRefStringSchema, ThemeTokensSchema, ThemeVariantSchema, TilesheetSchema, TraitCategorySchema, TraitConfigSchema, TraitConfigValueSchema, TraitDataEntitySchema, TraitEntityFieldSchema, TraitEventContractSchema, TraitEventListenerSchema, TraitFieldRefSchema, TraitIdSchema, TraitRefSchema, TraitReferenceSchema, TraitSchema, TraitTickSchema, TransitionSchema, TypeIntentMapSchema, TypeIntentSchema, TypeScaleEntrySchema, TypeScaleSchema, TypeScaleTokensSchema, TypeSizeKeySchema, TypeSliceSchema, TypeSlotSchema, TypeWeightSchema, UISlotSchema, UI_SLOTS, UXHintsSchema, UseDeclarationSchema, UserPersonaSchema, VISUAL_STYLES, ViewTypeSchema, VisualStyleSchema, answerToMutations, answersToMutations, applyEventWiring, applyFactoryCallPlanMutation, applyListenPayloadMapping, applyRenderOverlay, asEntityId, asEventId, asOrbitalId, asPageId, asPaletteEntryId, asServiceId, asThemeId, asTraitId, atomic, buildEdgeCoveringWalk, buildGuardPayloads, buildRecommendationContext, buildReplayPaths, buildResolvedTraitConfigs, buildStateGraph, callService, categorizeRemovals, classifyWorkflow, clearSchemaCache, collectBindings, collectEmbeddedTraitReferrers, collectReachableStates, collectRenderUiPatternTypes, collectTraitConfigRefAdjacency, collectTraitEmbedAdjacency, component_mapping_default as componentMapping, composeBehaviors, configRefEventKnob, constTruth, contractFieldName, createAssetKey, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, decodeDevIdentityToken, deref, deriveCollection, deriveInputType, describeTensorMismatch, despawn, detectLayoutStrategy, detectPageContentReduction, diffFactoryCalls, diffOrbitalSchemas, diffSchemaSemantics, diffSchemas, doEffects, emit, encodeDevIdentityToken, event_contracts_default as eventContracts, extractPayloadFieldRef, findCompatiblePatterns, findMockPersona, findService, fingerprintNode, formatRecommendationsForPrompt, gatherTensorLastDim, generatePatternDescription, generateQuestions, getAllPatternTypes, getArgs, getBindingExamples, getComponentForPattern, getDefaultAnimationsForRole, getEmittedEvents, getEntity, getEntityCardinality, getInteractionModelForDomain, getOperator, getOrbAllowedPatterns, getOrbAllowedPatternsCompact, getOrbAllowedPatternsFiltered, getOrbAllowedPatternsSlim, getPage, getPages, getPatternActionsRef, getPatternDefinition, getPatternMetadata, getPatternPropsCompact, getPatternsGroupedByCategory, getRemovals, getSchemaCacheStats, getServiceNames, getTrait, getTraitConfig, getTraitName, hasService, hasSignificantPageReduction, idKindOf, idPrefix, inferTsType, insertChildAtPath, integrators_registry_default as integratorsRegistry, isBinding, isCallSiteConfigDeclaration, isCircuitEvent, isContentBodyPattern, isContentBodyPatternType, isDestructiveChange, isDrawHostPattern, isDrawablePattern, isEffect, isEntityAwarePattern, isEntityCall, isEntityId, isEntityReference, isEntityReferenceAny, isEventId, isEventPayloadValue, isFieldValue, isImportedTraitRef, isInlineTrait, isJsonArray, isJsonObject, isJsonPrimitive, isKnownValidationErrorCode, isMainSlotRenderUi, isMcpService, isOrbitalDefinition, isOrbitalId, isPageId, isPageReference, isPageReferenceObject, isPageReferenceString, isPaletteEntryId, isPlanSnapshot, isReferenceConfigType, isResolvedIR, isRestService, isRuntimeEntity, isSExpr, isSExprAtom, isSExprCall, isSExprEffect, isServiceId, isServiceReference, isServiceReferenceObject, isSessionHistoryEntry, isSocketService, isTensorValue, isThemeId, isThemeReference, isTraitFieldRef, isTraitId, isValidBinding, isValidPatternType, ledgerCurName, ledgerRename, ledgerResolveName, mapTensorLastDim, mergeEntityFrame, mintId, navigate, navigatePatternPath, normalizeCallSiteConfigToValues, normalizeTraitRef, normalizeUserContext, notify, parseAssetKey, parseBinding, parseEntityRef, parseImportedTraitRef, parseOrbitalSchema, parsePageRef, parseServiceRef, patterns_registry_default as patternsRegistry, persist, persistenceModeAllowsOverrides, recommendPatterns, ref, registry, removeChildAtPath, renderUI, renderUiPatternTypesOf, replaceChildAtPath, requiresConfirmation, resolveConfigRefEventName, resolvePersonaSpec, safeParseOrbitalSchema, schemaToIR, set, setPropAtPath, sexpr, spawn, summarizeOrbital, summarizeSchema, swap, tensorLastDimSize, tensorShape, toBindingRoot, translateOverlaysToParams, validateAssetAnimations, validateBindingInContext, validateContract, walkSExpr, walkStatePairs, watch, widenTier };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map