@cohesivesystems/relations 0.1.0-alpha.14 → 0.1.0-alpha.140

package/dist/generated/relations.shapes.generated.d.ts

@@ -1,5 +1,312 @@
+export type GraphDeltaKind = 'Unspecified' | 'Overlay' | 'Version';
+export declare const graphDeltaKinds: {
+    readonly unspecified: "Unspecified";
+    readonly overlay: "Overlay";
+    readonly version: "Version";
+};
+export declare const graphDeltaKindLabels: Record<GraphDeltaKind, string>;
 export type GraphId = string;
+export type GraphDeltaOperation = {
+    readonly $operation: 'addShape';
+} & AddShapeOperation | {
+    readonly $operation: 'removeShape';
+} & RemoveShapeOperation | {
+    readonly $operation: 'replaceShape';
+} & ReplaceShapeOperation | {
+    readonly $operation: 'setGraphAnnotation';
+} & SetGraphAnnotationOperation | {
+    readonly $operation: 'removeGraphAnnotation';
+} & RemoveGraphAnnotationOperation | {
+    readonly $operation: 'addNamedType';
+} & AddNamedTypeOperation | {
+    readonly $operation: 'removeNamedType';
+} & RemoveNamedTypeOperation | {
+    readonly $operation: 'replaceNamedType';
+} & ReplaceNamedTypeOperation | {
+    readonly $operation: 'addShapeField';
+} & AddShapeFieldOperation | {
+    readonly $operation: 'removeShapeField';
+} & RemoveShapeFieldOperation | {
+    readonly $operation: 'replaceShapeField';
+} & ReplaceShapeFieldOperation | {
+    readonly $operation: 'addTypeField';
+} & AddTypeFieldOperation | {
+    readonly $operation: 'removeTypeField';
+} & RemoveTypeFieldOperation | {
+    readonly $operation: 'replaceTypeField';
+} & ReplaceTypeFieldOperation | {
+    readonly $operation: 'setFieldType';
+} & SetFieldTypeOperation | {
+    readonly $operation: 'setFieldPresence';
+} & SetFieldPresenceOperation | {
+    readonly $operation: 'setFieldCardinality';
+} & SetFieldCardinalityOperation | {
+    readonly $operation: 'setFieldNullability';
+} & SetFieldNullabilityOperation | {
+    readonly $operation: 'addFieldConstraint';
+} & AddFieldConstraintOperation | {
+    readonly $operation: 'removeFieldConstraint';
+} & RemoveFieldConstraintOperation | {
+    readonly $operation: 'setShapeAnnotation';
+} & SetShapeAnnotationOperation | {
+    readonly $operation: 'removeShapeAnnotation';
+} & RemoveShapeAnnotationOperation | {
+    readonly $operation: 'setTypeAnnotation';
+} & SetTypeAnnotationOperation | {
+    readonly $operation: 'removeTypeAnnotation';
+} & RemoveTypeAnnotationOperation | {
+    readonly $operation: 'setFieldAnnotation';
+} & SetFieldAnnotationOperation | {
+    readonly $operation: 'removeFieldAnnotation';
+} & RemoveFieldAnnotationOperation | {
+    readonly $operation: 'restrictAllowedValues';
+} & RestrictAllowedValuesOperation | {
+    readonly $operation: 'extendAllowedValues';
+} & ExtendAllowedValuesOperation | {
+    readonly $operation: 'addEnumValue';
+} & AddEnumValueOperation | {
+    readonly $operation: 'removeEnumValue';
+} & RemoveEnumValueOperation;
+export interface AddShapeOperation {
+    shape: Shape;
+    ordinal?: number | null;
+    note?: string | null;
+}
+export interface RemoveShapeOperation {
+    note?: string | null;
+    shapeId: ShapeId;
+}
+export interface ReplaceShapeOperation {
+    note?: string | null;
+    shape: Shape;
+}
+export interface SetGraphAnnotationOperation {
+    note?: string | null;
+    key: AnnotationKey;
+    value: AnnotationValue;
+}
+export interface RemoveGraphAnnotationOperation {
+    note?: string | null;
+    key: AnnotationKey;
+}
+export interface AddNamedTypeOperation {
+    type: TypeDefinition;
+    ordinal?: number | null;
+    note?: string | null;
+}
+export interface RemoveNamedTypeOperation {
+    note?: string | null;
+    typeId: TypeId;
+}
+export interface ReplaceNamedTypeOperation {
+    note?: string | null;
+    type: TypeDefinition;
+}
+export interface AddShapeFieldOperation {
+    shapeId: ShapeId;
+    field: FieldDefinition;
+    ordinal?: number | null;
+    note?: string | null;
+}
+export interface RemoveShapeFieldOperation {
+    note?: string | null;
+    shapeId: ShapeId;
+    fieldName: FieldName;
+    replacementPath?: string | null;
+}
+export interface ReplaceShapeFieldOperation {
+    note?: string | null;
+    shapeId: ShapeId;
+    field: FieldDefinition;
+}
+export interface AddTypeFieldOperation {
+    typeId: TypeId;
+    field: StructuralField;
+    ordinal?: number | null;
+    note?: string | null;
+}
+export interface RemoveTypeFieldOperation {
+    note?: string | null;
+    typeId: TypeId;
+    fieldName: FieldName;
+    replacementPath?: string | null;
+}
+export interface ReplaceTypeFieldOperation {
+    note?: string | null;
+    typeId: TypeId;
+    field: StructuralField;
+}
+export interface SetFieldTypeOperation {
+    note?: string | null;
+    target: GraphFieldPath;
+    type: TypeRef;
+}
+export interface SetFieldPresenceOperation {
+    note?: string | null;
+    target: GraphFieldPath;
+    presence: FieldPresence;
+}
+export interface SetFieldCardinalityOperation {
+    note?: string | null;
+    target: GraphFieldPath;
+    cardinality: FieldCardinality;
+}
+export interface SetFieldNullabilityOperation {
+    note?: string | null;
+    target: GraphFieldPath;
+    nullability: FieldNullability;
+}
+export interface AddFieldConstraintOperation {
+    target: GraphFieldPath;
+    constraint: ShapeConstraint;
+    note?: string | null;
+}
+export interface RemoveFieldConstraintOperation {
+    note?: string | null;
+    target: GraphFieldPath;
+    constraint: ShapeConstraint;
+}
+export interface SetShapeAnnotationOperation {
+    note?: string | null;
+    shapeId: ShapeId;
+    key: AnnotationKey;
+    value: AnnotationValue;
+}
+export interface RemoveShapeAnnotationOperation {
+    note?: string | null;
+    shapeId: ShapeId;
+    key: AnnotationKey;
+}
+export interface SetTypeAnnotationOperation {
+    note?: string | null;
+    typeId: TypeId;
+    key: AnnotationKey;
+    value: AnnotationValue;
+}
+export interface RemoveTypeAnnotationOperation {
+    note?: string | null;
+    typeId: TypeId;
+    key: AnnotationKey;
+}
+export interface SetFieldAnnotationOperation {
+    note?: string | null;
+    target: GraphFieldPath;
+    key: AnnotationKey;
+    value: AnnotationValue;
+}
+export interface RemoveFieldAnnotationOperation {
+    note?: string | null;
+    target: GraphFieldPath;
+    key: AnnotationKey;
+}
+export interface RestrictAllowedValuesOperation {
+    note?: string | null;
+    target: GraphFieldPath;
+    values: string[];
+}
+export interface ExtendAllowedValuesOperation {
+    target: GraphFieldPath;
+    values: string[];
+    note?: string | null;
+}
+export interface AddEnumValueOperation {
+    typeId: TypeId;
+    value: EnumValue;
+    note?: string | null;
+}
+export interface RemoveEnumValueOperation {
+    note?: string | null;
+    typeId: TypeId;
+    valueName: string;
+}
+export type AnnotationKey = string;
+export type AnnotationValue = unknown;
 export type ShapeId = string;
+export interface ShapeGraphDocumentMetadata {
+    origin: DocumentOrigin;
+    name?: string | null;
+    description?: string | null;
+    sourceUri?: string | null;
+    createdAtUtc?: string | null;
+    updatedAtUtc?: string | null;
+    annotations: Record<string, AnnotationValue>;
+}
+export interface ShapeGraph {
+    id: GraphId;
+    shapes: Shape[];
+    namedTypes: TypeDefinition[];
+    annotations: Record<string, AnnotationValue>;
+    diagnostics: GraphDiagnostic[];
+    hasErrors: boolean;
+}
+export type TypeRef = {
+    readonly $type: 'named';
+} & NamedTypeRef | {
+    readonly $type: 'opaque';
+} & OpaqueRuntimeTypeRef | {
+    readonly $type: 'scalar';
+} & ScalarTypeRef | {
+    readonly $type: 'enum';
+} & EnumTypeRef | {
+    readonly $type: 'entityRef';
+} & EntityReferenceTypeRef | {
+    readonly $type: 'array';
+} & ArrayTypeRef | {
+    readonly $type: 'object';
+} & ObjectTypeRef | {
+    readonly $type: 'quantity';
+} & QuantityTypeRef | {
+    readonly $type: 'json';
+} & JsonTypeRef;
+export interface NamedTypeRef {
+    typeId: TypeId;
+}
+export interface OpaqueRuntimeTypeRef {
+    runtimeType: string;
+    inferenceDiagnostic?: TypeInferenceDiagnostic | null;
+}
+export interface ScalarTypeRef {
+    kind: ScalarTypeKind;
+    format: PrimitiveFormat;
+}
+export interface EnumTypeRef {
+    name: string;
+    members: string[];
+}
+export interface EntityReferenceTypeRef {
+    entity: EntityTypeName;
+}
+export interface ArrayTypeRef {
+    elementType: TypeRef;
+}
+export interface ObjectTypeRef {
+    fields: ObjectFieldTypeDef[];
+}
+export interface QuantityTypeRef {
+    quantity: string;
+    baseKind: ScalarTypeKind;
+}
+export interface JsonTypeRef {
+    kind: JsonTypeKind;
+}
+export type FieldCardinality = 'Single' | 'Many';
+export declare const fieldCardinalities: {
+    readonly single: "Single";
+    readonly many: "Many";
+};
+export declare const fieldCardinalityLabels: Record<FieldCardinality, string>;
+export type FieldPresence = 'Required' | 'Optional';
+export declare const fieldPresences: {
+    readonly required: "Required";
+    readonly optional: "Optional";
+};
+export declare const fieldPresenceLabels: Record<FieldPresence, string>;
+export type FieldNullability = 'NonNullable' | 'Nullable';
+export declare const fieldNullabilities: {
+    readonly nonNullable: "NonNullable";
+    readonly nullable: "Nullable";
+};
+export declare const fieldNullabilityLabels: Record<FieldNullability, string>;
 export type RelationQueryExplainStage = {
     readonly $stage: 'staticCompilation';
 } & RelationQueryStaticCompilationExplainStage | {
@@ -333,6 +640,7 @@ export interface QueryDefinition {
     id: QueryId;
     name: QueryName;
     results: QueryResultDefinition[];
+    assembly?: NestedQueryResultAssembly | null;
     body: LogicalQueryDefinition;
 }
 export interface RelationQueryDefinitionFingerprint {
@@ -370,6 +678,198 @@ export interface RelationshipCatalogDocumentMetadata {
     updatedAtUtc?: string | null;
     annotations: Record<string, AnnotationValue>;
 }
+export interface Shape {
+    id: ShapeId;
+    fields: FieldDefinition[];
+    constraints: ShapeConstraint[];
+    annotations: Record<string, AnnotationValue>;
+    role?: string | null;
+    entityType?: EntityTypeName | null;
+}
+export type TypeDefinition = {
+    readonly $typeDef: 'structural';
+} & Structural | {
+    readonly $typeDef: 'enum';
+} & Enum | {
+    readonly $typeDef: 'union';
+} & Union;
+export interface Structural {
+    id: TypeId;
+    name: string;
+    fields: StructuralField[];
+    constraints: ShapeConstraint[];
+    annotations: Record<string, AnnotationValue>;
+}
+export interface Enum {
+    id: TypeId;
+    name: string;
+    underlying: PrimitiveType;
+    values: EnumValue[];
+    annotations: Record<string, AnnotationValue>;
+}
+export interface Union {
+    id: TypeId;
+    name: string;
+    discriminator: UnionDiscriminator;
+    cases: UnionCase[];
+    annotations: Record<string, AnnotationValue>;
+}
+export type TypeId = string;
+export interface FieldDefinition {
+    name: FieldName;
+    type: TypeRef;
+    cardinality: FieldCardinality;
+    presence: FieldPresence;
+    role: FieldRole;
+    nullability: FieldNullability;
+    mutability: FieldMutability;
+    compute?: ComputeDefinition | null;
+    constraints: ShapeConstraint[];
+    annotations: Record<string, AnnotationValue>;
+}
+export type FieldName = string;
+export interface StructuralField {
+    name: FieldName;
+    type: TypeRef;
+    cardinality: FieldCardinality;
+    presence: FieldPresence;
+    nullability: FieldNullability;
+    role: FieldRole;
+    constraints: ShapeConstraint[];
+    annotations: Record<string, AnnotationValue>;
+}
+export interface GraphFieldPath {
+    shapeId?: ShapeId | null;
+    typeId?: TypeId | null;
+    path: FieldPath;
+}
+export type ShapeConstraint = {
+    readonly $constraint: 'required';
+} & RequiredConstraint | {
+    readonly $constraint: 'minLength';
+} & MinLengthConstraint | {
+    readonly $constraint: 'maxLength';
+} & MaxLengthConstraint | {
+    readonly $constraint: 'range';
+} & RangeConstraint | {
+    readonly $constraint: 'regex';
+} & RegexConstraint | {
+    readonly $constraint: 'allowedValues';
+} & AllowedValuesConstraint | {
+    readonly $constraint: 'occurrence';
+} & OccurrenceConstraint;
+export interface RequiredConstraint {
+    field?: FieldPath | null;
+    message?: string | null;
+}
+export interface MinLengthConstraint {
+    value: number;
+    field?: FieldPath | null;
+    message?: string | null;
+}
+export interface MaxLengthConstraint {
+    value: number;
+    field?: FieldPath | null;
+    message?: string | null;
+}
+export interface RangeConstraint {
+    minimum?: number | null;
+    maximum?: number | null;
+    field?: FieldPath | null;
+    message?: string | null;
+}
+export interface RegexConstraint {
+    pattern: string;
+    field?: FieldPath | null;
+    message?: string | null;
+}
+export interface AllowedValuesConstraint {
+    values: string[];
+    field?: FieldPath | null;
+    message?: string | null;
+}
+export interface OccurrenceConstraint {
+    minimum?: number | null;
+    maximum?: number | null;
+    field?: FieldPath | null;
+    message?: string | null;
+}
+export interface EnumValue {
+    name: string;
+    value?: string | null;
+    label?: string | null;
+    description?: string | null;
+}
+export type DocumentOrigin = 'Unknown' | 'User' | 'System' | 'Imported' | 'Generated' | 'Compiled' | 'Extracted';
+export declare const documentOrigins: {
+    readonly unknown: "Unknown";
+    readonly user: "User";
+    readonly system: "System";
+    readonly imported: "Imported";
+    readonly generated: "Generated";
+    readonly compiled: "Compiled";
+    readonly extracted: "Extracted";
+};
+export declare const documentOriginLabels: Record<DocumentOrigin, string>;
+export interface GraphDiagnostic {
+    id: DiagnosticId;
+    severity: DiagnosticSeverity;
+    message: string;
+    shapeId?: ShapeId | null;
+    fieldIdentity?: string | null;
+    typeId?: TypeId | null;
+}
+export interface TypeInferenceDiagnostic {
+    reason: string;
+    message?: string | null;
+}
+export type ScalarTypeKind = 'Bool' | 'Int32' | 'Int64' | 'Decimal' | 'String' | 'Guid' | 'Date' | 'DateTime' | 'Instant' | 'Bytes';
+export declare const scalarTypeKinds: {
+    readonly bool: "Bool";
+    readonly int32: "Int32";
+    readonly int64: "Int64";
+    readonly decimal: "Decimal";
+    readonly string: "String";
+    readonly guid: "Guid";
+    readonly date: "Date";
+    readonly dateTime: "DateTime";
+    readonly instant: "Instant";
+    readonly bytes: "Bytes";
+};
+export declare const scalarTypeKindLabels: Record<ScalarTypeKind, string>;
+export type PrimitiveFormat = 'None' | 'Uuid' | 'IsoDate' | 'IsoDateTime' | 'IsoInstant' | 'CurrencyCode' | 'CountryCode' | 'Email' | 'Uri' | 'Base64';
+export declare const primitiveFormats: {
+    readonly none: "None";
+    readonly uuid: "Uuid";
+    readonly isoDate: "IsoDate";
+    readonly isoDateTime: "IsoDateTime";
+    readonly isoInstant: "IsoInstant";
+    readonly currencyCode: "CurrencyCode";
+    readonly countryCode: "CountryCode";
+    readonly email: "Email";
+    readonly uri: "Uri";
+    readonly base64: "Base64";
+};
+export declare const primitiveFormatLabels: Record<PrimitiveFormat, string>;
+export type EntityTypeName = string;
+export interface ObjectFieldTypeDef {
+    name: string;
+    type: TypeRef;
+    cardinality: FieldCardinality;
+    presence: FieldPresence;
+    nullability: FieldNullability;
+    annotations: Record<string, AnnotationValue>;
+}
+export type JsonTypeKind = 'Any' | 'Object' | 'Array' | 'String' | 'Number' | 'Boolean';
+export declare const jsonTypeKinds: {
+    readonly any: "Any";
+    readonly object: "Object";
+    readonly array: "Array";
+    readonly string: "String";
+    readonly number: "Number";
+    readonly boolean: "Boolean";
+};
+export declare const jsonTypeKindLabels: Record<JsonTypeKind, string>;
 export type RelationQueryExplainStageStatus = 'Complete' | 'Unavailable' | 'Invalid' | 'Incomplete' | 'Failed';
 export declare const relationQueryExplainStageStatuses: {
     readonly complete: "Complete";
@@ -859,19 +1359,6 @@ export interface InvariantDefinition {
     expression: Expr;
     message?: string | null;
 }
-export type DocumentOrigin = 'Unknown' | 'User' | 'System' | 'Imported' | 'Generated' | 'Compiled' | 'Extracted';
-export declare const documentOrigins: {
-    readonly unknown: "Unknown";
-    readonly user: "User";
-    readonly system: "System";
-    readonly imported: "Imported";
-    readonly generated: "Generated";
-    readonly compiled: "Compiled";
-    readonly extracted: "Extracted";
-};
-export declare const documentOriginLabels: Record<DocumentOrigin, string>;
-export type AnnotationKey = string;
-export type AnnotationValue = unknown;
 export interface RelationDraftProducerArtifactReference {
     kind: string;
     value: string;
@@ -905,6 +1392,13 @@ export interface AggregationQueryResultDefinition {
     id: QueryResultId;
     input: QueryNodeId;
 }
+export interface NestedQueryResultAssembly {
+    result: QueryResultId;
+    shape: QualifiedShapeId;
+    identity: FieldPath;
+    fields: QueryResultFieldMapping[];
+    collections: QueryResultCollectionAssembly[];
+}
 export interface RelationshipDefinition {
     id: RelationshipId;
     sourceShape: QualifiedShapeId;
@@ -913,6 +1407,49 @@ export interface RelationshipDefinition {
     targetKey: RelationshipTargetKey;
     sourceReferenceUniqueness: SourceReferenceUniqueness;
 }
+export type PrimitiveType = 'Bool' | 'Int32' | 'Int64' | 'Decimal' | 'String' | 'Guid' | 'Date' | 'DateTime' | 'Instant' | 'Bytes';
+export declare const primitiveTypes: {
+    readonly bool: "Bool";
+    readonly int32: "Int32";
+    readonly int64: "Int64";
+    readonly decimal: "Decimal";
+    readonly string: "String";
+    readonly guid: "Guid";
+    readonly date: "Date";
+    readonly dateTime: "DateTime";
+    readonly instant: "Instant";
+    readonly bytes: "Bytes";
+};
+export declare const primitiveTypeLabels: Record<PrimitiveType, string>;
+export interface UnionDiscriminator {
+    fieldName: string;
+    type: PrimitiveType;
+}
+export interface UnionCase {
+    name: string;
+    type: TypeRef;
+    discriminatorValue: string;
+}
+export type FieldRole = 'Data' | 'Identity' | 'Reference' | 'Computed' | 'Metadata';
+export declare const fieldRoles: {
+    readonly data: "Data";
+    readonly identity: "Identity";
+    readonly reference: "Reference";
+    readonly computed: "Computed";
+    readonly metadata: "Metadata";
+};
+export declare const fieldRoleLabels: Record<FieldRole, string>;
+export type FieldMutability = 'Mutable' | 'WriteOnce' | 'Computed';
+export declare const fieldMutabilities: {
+    readonly mutable: "Mutable";
+    readonly writeOnce: "WriteOnce";
+    readonly computed: "Computed";
+};
+export declare const fieldMutabilityLabels: Record<FieldMutability, string>;
+export interface ComputeDefinition {
+    expression: Expr;
+}
+export type DiagnosticId = string;
 export interface RelationQueryLogicalPlan {
     nodes: RelationQueryLogicalPlanNode[];
     retainedNodes: QueryNodeId[];
@@ -1040,7 +1577,7 @@ export declare const relationQueryBoundAssessmentStatuses: {
     readonly blocked: "Blocked";
 };
 export declare const relationQueryBoundAssessmentStatusLabels: Record<RelationQueryBoundAssessmentStatus, string>;
-export type RelationQueryLogicalCapabilityKind = 'Source' | 'Filter' | 'RelationshipTraversal' | 'ForwardRelationshipTraversal' | 'InverseRelationshipTraversal' | 'AtMostOneRelationshipTraversal' | 'ManyRelationshipTraversal' | 'RequiredRelationshipTraversal' | 'OptionalRelationshipTraversal' | 'Join' | 'InnerJoin' | 'LeftOuterJoin' | 'RightOuterJoin' | 'FullOuterJoin' | 'TemporalJoin' | 'ExpandCollection' | 'Projection' | 'ProjectionAssignment' | 'DistinctRows' | 'DistinctKeys' | 'Aggregation' | 'AggregateGrouping' | 'AggregateFilter' | 'CountAggregate' | 'SumAggregate' | 'MinimumAggregate' | 'MaximumAggregate' | 'AnyAggregate' | 'AllAggregate' | 'Ordering' | 'AscendingOrdering' | 'DescendingOrdering' | 'NullsFirst' | 'NullsLast' | 'StableTieOrdering' | 'OffsetPaging' | 'KeysetPaging' | 'OnePerRootRelationOutput' | 'ZeroOrOnePerRootRelationOutput' | 'ManyPerRootRelationOutput' | 'SetRelationOutput' | 'RelationOutputIdentity' | 'RelationInvariant' | 'QueryRowsResult' | 'QueryAggregationResult' | 'AlwaysPresentBinding' | 'MayBeAbsentBinding' | 'AverageAggregate';
+export type RelationQueryLogicalCapabilityKind = 'Source' | 'Filter' | 'RelationshipTraversal' | 'ForwardRelationshipTraversal' | 'InverseRelationshipTraversal' | 'AtMostOneRelationshipTraversal' | 'ManyRelationshipTraversal' | 'RequiredRelationshipTraversal' | 'OptionalRelationshipTraversal' | 'Join' | 'InnerJoin' | 'LeftOuterJoin' | 'RightOuterJoin' | 'FullOuterJoin' | 'TemporalJoin' | 'ExpandCollection' | 'Projection' | 'ProjectionAssignment' | 'DistinctRows' | 'DistinctKeys' | 'Aggregation' | 'AggregateGrouping' | 'AggregateFilter' | 'CountAggregate' | 'SumAggregate' | 'MinimumAggregate' | 'MaximumAggregate' | 'AnyAggregate' | 'AllAggregate' | 'Ordering' | 'AscendingOrdering' | 'DescendingOrdering' | 'NullsFirst' | 'NullsLast' | 'StableTieOrdering' | 'OffsetPaging' | 'KeysetPaging' | 'OnePerRootRelationOutput' | 'ZeroOrOnePerRootRelationOutput' | 'ManyPerRootRelationOutput' | 'SetRelationOutput' | 'RelationOutputIdentity' | 'RelationInvariant' | 'QueryRowsResult' | 'QueryAggregationResult' | 'AlwaysPresentBinding' | 'MayBeAbsentBinding' | 'AverageAggregate' | 'SelectRepresentative';
 export declare const relationQueryLogicalCapabilityKinds: {
     readonly source: "Source";
     readonly filter: "Filter";
@@ -1090,6 +1627,7 @@ export declare const relationQueryLogicalCapabilityKinds: {
     readonly alwaysPresentBinding: "AlwaysPresentBinding";
     readonly mayBeAbsentBinding: "MayBeAbsentBinding";
     readonly averageAggregate: "AverageAggregate";
+    readonly selectRepresentative: "SelectRepresentative";
 };
 export declare const relationQueryLogicalCapabilityKindLabels: Record<RelationQueryLogicalCapabilityKind, string>;
 export interface ExprCapabilityId {
@@ -1232,6 +1770,8 @@ export type LogicalQueryNode = {
 } & ProjectQueryNode | {
     readonly $node: 'distinct';
 } & DistinctQueryNode | {
+    readonly $node: 'selectRepresentative';
+} & SelectRepresentativeQueryNode | {
     readonly $node: 'aggregate';
 } & AggregateQueryNode | {
     readonly $node: 'order';
@@ -1278,6 +1818,7 @@ export interface ExpandCollectionQueryNode {
     collection: Expr;
     itemBinding: ValueBindingId;
     itemType: TypeRef;
+    itemShape?: QualifiedShapeId | null;
     id: QueryNodeId;
 }
 export interface ProjectQueryNode {
@@ -1292,6 +1833,12 @@ export interface DistinctQueryNode {
     keys: Expr[];
     id: QueryNodeId;
 }
+export interface SelectRepresentativeQueryNode {
+    id: QueryNodeId;
+    input: QueryNodeId;
+    keys: Expr[];
+    orderings: QueryOrdering[];
+}
 export interface AggregateQueryNode {
     input: QueryNodeId;
     resultBinding: ValueBindingId;
@@ -1344,56 +1891,6 @@ export declare const binaryOperators: {
     readonly div: "Div";
 };
 export declare const binaryOperatorLabels: Record<BinaryOperator, string>;
-export type TypeRef = {
-    readonly $type: 'named';
-} & NamedTypeRef | {
-    readonly $type: 'opaque';
-} & OpaqueRuntimeTypeRef | {
-    readonly $type: 'scalar';
-} & ScalarTypeRef | {
-    readonly $type: 'enum';
-} & EnumTypeRef | {
-    readonly $type: 'entityRef';
-} & EntityReferenceTypeRef | {
-    readonly $type: 'array';
-} & ArrayTypeRef | {
-    readonly $type: 'object';
-} & ObjectTypeRef | {
-    readonly $type: 'quantity';
-} & QuantityTypeRef | {
-    readonly $type: 'json';
-} & JsonTypeRef;
-export interface NamedTypeRef {
-    typeId: TypeId;
-}
-export interface OpaqueRuntimeTypeRef {
-    runtimeType: string;
-    inferenceDiagnostic?: TypeInferenceDiagnostic | null;
-}
-export interface ScalarTypeRef {
-    kind: ScalarTypeKind;
-    format: PrimitiveFormat;
-}
-export interface EnumTypeRef {
-    name: string;
-    members: string[];
-}
-export interface EntityReferenceTypeRef {
-    entity: EntityTypeName;
-}
-export interface ArrayTypeRef {
-    elementType: TypeRef;
-}
-export interface ObjectTypeRef {
-    fields: ObjectFieldTypeDef[];
-}
-export interface QuantityTypeRef {
-    quantity: string;
-    baseKind: ScalarTypeKind;
-}
-export interface JsonTypeRef {
-    kind: JsonTypeKind;
-}
 export type AggregateOperator = 'Count' | 'Sum' | 'Min' | 'Max' | 'Any' | 'All' | 'Average';
 export declare const aggregateOperators: {
     readonly count: "Count";
@@ -1409,6 +1906,15 @@ export type EntityId = string;
 export type QueryAssignmentId = string;
 export type RelationDraftCandidateId = string;
 export type QueryResultId = string;
+export interface QueryResultFieldMapping {
+    source: FieldPath;
+    target: FieldPath;
+}
+export interface QueryResultCollectionAssembly {
+    target: FieldPath;
+    identity: FieldPath;
+    fields: QueryResultFieldMapping[];
+}
 export type RelationshipId = string;
 export type RelationshipTargetKey = {
     readonly $targetKey: 'observationIdentity';
@@ -1580,6 +2086,11 @@ export interface ProjectionAssignment {
     target: FieldPath;
     value: Expr;
 }
+export interface QueryOrdering {
+    key: Expr;
+    direction: QuerySortDirection;
+    nullPlacement: QueryNullPlacement;
+}
 export interface QueryGrouping {
     id: QueryAssignmentId;
     target: FieldPath;
@@ -1592,11 +2103,6 @@ export interface QueryAggregateAssignment {
     value?: Expr | null;
     filter?: Expr | null;
 }
-export interface QueryOrdering {
-    key: Expr;
-    direction: QuerySortDirection;
-    nullPlacement: QueryNullPlacement;
-}
 export type QueryPageDefinition = {
     readonly $page: 'offset';
 } & OffsetPageDefinition | {
@@ -1611,12 +2117,6 @@ export interface KeysetPageDefinition {
     limit: number;
 }
 export type QueryParameterId = string;
-export type FieldPresence = 'Required' | 'Optional';
-export declare const fieldPresences: {
-    readonly required: "Required";
-    readonly optional: "Optional";
-};
-export declare const fieldPresenceLabels: Record<FieldPresence, string>;
 export type QueryParameterDefaultKind = 'None' | 'Value';
 export declare const queryParameterDefaultKinds: {
     readonly none: "None";
@@ -1646,58 +2146,6 @@ export interface UnresolvedRelationDraftAssignmentResolution {
 export interface AmbiguousRelationDraftAssignmentResolution {
     candidateIds: RelationDraftCandidateId[];
 }
-export type TypeId = string;
-export interface TypeInferenceDiagnostic {
-    reason: string;
-    message?: string | null;
-}
-export type ScalarTypeKind = 'Bool' | 'Int32' | 'Int64' | 'Decimal' | 'String' | 'Guid' | 'Date' | 'DateTime' | 'Instant' | 'Bytes';
-export declare const scalarTypeKinds: {
-    readonly bool: "Bool";
-    readonly int32: "Int32";
-    readonly int64: "Int64";
-    readonly decimal: "Decimal";
-    readonly string: "String";
-    readonly guid: "Guid";
-    readonly date: "Date";
-    readonly dateTime: "DateTime";
-    readonly instant: "Instant";
-    readonly bytes: "Bytes";
-};
-export declare const scalarTypeKindLabels: Record<ScalarTypeKind, string>;
-export type PrimitiveFormat = 'None' | 'Uuid' | 'IsoDate' | 'IsoDateTime' | 'IsoInstant' | 'CurrencyCode' | 'CountryCode' | 'Email' | 'Uri' | 'Base64';
-export declare const primitiveFormats: {
-    readonly none: "None";
-    readonly uuid: "Uuid";
-    readonly isoDate: "IsoDate";
-    readonly isoDateTime: "IsoDateTime";
-    readonly isoInstant: "IsoInstant";
-    readonly currencyCode: "CurrencyCode";
-    readonly countryCode: "CountryCode";
-    readonly email: "Email";
-    readonly uri: "Uri";
-    readonly base64: "Base64";
-};
-export declare const primitiveFormatLabels: Record<PrimitiveFormat, string>;
-export type EntityTypeName = string;
-export interface ObjectFieldTypeDef {
-    name: string;
-    type: TypeRef;
-    cardinality: FieldCardinality;
-    presence: FieldPresence;
-    nullability: FieldNullability;
-    annotations: Record<string, AnnotationValue>;
-}
-export type JsonTypeKind = 'Any' | 'Object' | 'Array' | 'String' | 'Number' | 'Boolean';
-export declare const jsonTypeKinds: {
-    readonly any: "Any";
-    readonly object: "Object";
-    readonly array: "Array";
-    readonly string: "String";
-    readonly number: "Number";
-    readonly boolean: "Boolean";
-};
-export declare const jsonTypeKindLabels: Record<JsonTypeKind, string>;
 export interface RelationQueryLogicalPlanInput {
     canonicalInput: QueryNodeId;
     effectiveInput: QueryNodeId;
@@ -1730,7 +2178,7 @@ export declare const relationQueryRealizationTraceStepKinds: {
     readonly terminal: "Terminal";
 };
 export declare const relationQueryRealizationTraceStepKindLabels: Record<RelationQueryRealizationTraceStepKind, string>;
-export type RelationQueryExpressionSiteKind = 'FilterPredicate' | 'JoinPredicate' | 'ExpandCollection' | 'ProjectionAssignmentValue' | 'DistinctKey' | 'AggregateGroupingKey' | 'AggregateAssignmentValue' | 'AggregateAssignmentFilter' | 'OrderKey' | 'KeysetBoundary' | 'RelationOutputKey' | 'RelationInvariant' | 'TemporalJoinCorrelation' | 'TemporalJoinPoint' | 'TemporalJoinIntervalLowerBound' | 'TemporalJoinIntervalUpperBound';
+export type RelationQueryExpressionSiteKind = 'FilterPredicate' | 'JoinPredicate' | 'ExpandCollection' | 'ProjectionAssignmentValue' | 'DistinctKey' | 'AggregateGroupingKey' | 'AggregateAssignmentValue' | 'AggregateAssignmentFilter' | 'OrderKey' | 'KeysetBoundary' | 'RelationOutputKey' | 'RelationInvariant' | 'TemporalJoinCorrelation' | 'TemporalJoinPoint' | 'TemporalJoinIntervalLowerBound' | 'TemporalJoinIntervalUpperBound' | 'RepresentativeKey';
 export declare const relationQueryExpressionSiteKinds: {
     readonly filterPredicate: "FilterPredicate";
     readonly joinPredicate: "JoinPredicate";
@@ -1748,6 +2196,7 @@ export declare const relationQueryExpressionSiteKinds: {
     readonly temporalJoinPoint: "TemporalJoinPoint";
     readonly temporalJoinIntervalLowerBound: "TemporalJoinIntervalLowerBound";
     readonly temporalJoinIntervalUpperBound: "TemporalJoinIntervalUpperBound";
+    readonly representativeKey: "RepresentativeKey";
 };
 export declare const relationQueryExpressionSiteKindLabels: Record<RelationQueryExpressionSiteKind, string>;
 export type ExprSiteId = string;
@@ -1780,18 +2229,6 @@ export declare const relationDraftUnresolvedReasons: {
     readonly multipleCandidates: "MultipleCandidates";
 };
 export declare const relationDraftUnresolvedReasonLabels: Record<RelationDraftUnresolvedReason, string>;
-export type FieldCardinality = 'Single' | 'Many';
-export declare const fieldCardinalities: {
-    readonly single: "Single";
-    readonly many: "Many";
-};
-export declare const fieldCardinalityLabels: Record<FieldCardinality, string>;
-export type FieldNullability = 'NonNullable' | 'Nullable';
-export declare const fieldNullabilities: {
-    readonly nonNullable: "NonNullable";
-    readonly nullable: "Nullable";
-};
-export declare const fieldNullabilityLabels: Record<FieldNullability, string>;
 export interface RelationQueryLogicalBypass {
     kind: RelationQueryLogicalBypassKind;
     node: QueryNodeId;
@@ -1845,10 +2282,32 @@ export declare const temporalNullBoundBehaviors: {
     readonly unbounded: "Unbounded";
 };
 export declare const temporalNullBoundBehaviorLabels: Record<TemporalNullBoundBehavior, string>;
+export interface GraphDelta {
+    id: string;
+    kind: GraphDeltaKind;
+    sourceGraphId?: GraphId | null;
+    targetGraphId?: GraphId | null;
+    sourceVersion?: string | null;
+    targetVersion?: string | null;
+    operations: GraphDeltaOperation[];
+    annotations: Record<string, AnnotationValue>;
+}
 export interface QualifiedShapeId {
     graphId: GraphId;
     shapeId: ShapeId;
 }
+export interface ShapeGraphDocument {
+    schemaVersion: string;
+    metadata: ShapeGraphDocumentMetadata;
+    graph: ShapeGraph;
+}
+export interface ValueContract {
+    type?: TypeRef | null;
+    shape?: QualifiedShapeId | null;
+    cardinality: FieldCardinality;
+    presence: FieldPresence;
+    nullability: FieldNullability;
+}
 export interface RelationQueryExplainArtifact {
     schemaVersion: string;
     stages: RelationQueryExplainStage[];