@nicia-ai/typegraph 0.24.1 → 0.25.0

package/dist/index.d.cts

@@ -1,13 +1,16 @@
 import { z } from 'zod';
-import { N as NodeType, E as EdgeType, I as InferenceType, M as MetaEdge, O as OntologyRelation } from './types-Qk2l3IkQ.cjs';
-export { A as AnyEdgeType, B as BackendCapabilities, C as Cardinality, a as Collation, D as DEFAULT_SQL_SCHEMA, b as DeleteBehavior, c as DeleteFulltextBatchParams, d as EdgeId, e as EdgeProps, f as EdgeRegistration, g as EdgeTypeWithEndpoints, h as EndpointExistence, F as FulltextBatchRow, i as FulltextCapabilities, j as FulltextQueryMode, k as FulltextSearchParams, l as FulltextSearchResult, m as FulltextStrategy, G as GraphBackend, n as GraphDefaults, o as MetaEdgeProperties, p as NodeId, q as NodeProps, r as NodeRegistration, S as SqlDialect, s as SqlSchema, t as SqlTableNames, T as TemporalMode, u as TransactionBackend, U as UniqueConstraint, v as UniquenessScope, w as UpsertFulltextBatchParams, V as VectorCapabilities, x as createSqlSchema, y as fts5Strategy, z as isEdgeType, H as isEdgeTypeWithEndpoints, J as isMetaEdge, K as isNodeType, L as tsvectorStrategy } from './types-Qk2l3IkQ.cjs';
-import { A as AliasMap, E as EdgeAliasMap, Q as QueryBuilder, T as TraversalBuilder, C as CreateQueryBuilderOptions } from './store-CpvwTMxV.cjs';
-export { a as AggregateResult, b as AlgorithmCyclePolicy, c as AnyEdge, d as AnyNode, B as BaseTraversalOptions, e as BatchResults, f as BatchableQuery, g as ConstraintNames, h as CreateEdgeInput, i as CreateNodeInput, D as DEFAULT_SEARCHABLE_LANGUAGE, j as DegreeOptions, k as DynamicEdgeCollection, l as DynamicNodeCollection, m as Edge, n as EdgeAccessor, o as EdgeCollection, p as EdgeFindByEndpointsOptions, q as EdgeGetOrCreateByEndpointsOptions, r as EdgeGetOrCreateByEndpointsResult, s as EmbeddingSchema, t as EmbeddingValue, u as ExecutableAggregateQuery, v as ExecutableQuery, F as FieldAccessor, w as FulltextSearchHit, x as FulltextSearchOptions, G as GetOrCreateAction, y as GraphAlgorithms, z as GraphEdgeCollections, H as GraphNodeCollections, I as HookContext, J as HybridFulltextOptions, K as HybridSearchHit, L as HybridSearchOptions, M as HybridVectorOptions, N as IfExistsMode, O as NeighborsOptions, P as Node, R as NodeAccessor, S as NodeAlias, U as NodeCollection, V as NodeGetOrCreateByConstraintOptions, W as NodeGetOrCreateByConstraintResult, X as NodeIdentifier, Y as NodeRef, Z as OperationHookContext, _ as PaginateOptions, $ as PaginatedResult, a0 as PathNode, a1 as Predicate, a2 as PreparedQuery, a3 as PropsAccessor, a4 as QueryHookContext, a5 as QueryOptions, a6 as ReachableNode, a7 as ReachableOptions, a8 as RebuildFulltextOptions, a9 as RebuildFulltextResult, aa as RecursiveTraversalOptions, ab as SearchableMetadata, ac as SearchableOptions, ad as SearchableSchema, ae as SelectContext, af as SelectableEdge, ag as SelectableNode, ah as ShortestPathOptions, ai as ShortestPathResult, aj as Store, ak as StoreHooks, al as StoreOptions, am as StoreProjection, an as StoreSearch, ao as StreamOptions, ap as SubgraphEdgeResult, aq as SubgraphNodeResult, ar as SubgraphOptions, as as SubgraphResult, at as SubsetEdge, au as SubsetNode, av as TemporalAlgorithmOptions, aw as TransactionContext, ax as TraversalDirection, ay as TypedEdgeCollection, az as UnionableQuery, aA as UpdateEdgeInput, aB as UpdateNodeInput, aC as VectorSearchHit, aD as createStore, aE as createStoreWithSchema, aF as defineSubgraphProject, aG as embedding, aH as exists, aI as fieldRef, aJ as getEmbeddingDimensions, aK as getSearchableMetadata, aL as inSubquery, aM as isEmbeddingSchema, aN as isParameterRef, aO as isSearchableSchema, aP as notExists, aQ as notInSubquery, aR as param, aS as searchable } from './store-CpvwTMxV.cjs';
-import { G as GraphDef, K as KindRegistry } from './manager-Vkz28eAC.cjs';
-export { A as AllEdgeTypes, a as AllNodeTypes, E as EdgeKinds, b as GetEdgeType, c as GetNodeType, N as NodeKinds, S as SchemaManagerOptions, d as SchemaValidationResult, e as defineGraph, g as getEdgeKinds, f as getNodeKinds, i as isGraphDef } from './manager-Vkz28eAC.cjs';
-export { B as BackendDisposedError, C as CardinalityError, a as CompilerInvariantError, b as ConfigurationError, D as DatabaseOperationError, c as DisjointError, E as EdgeNotFoundError, d as EndpointError, e as EndpointNotFoundError, f as ErrorCategory, K as KindNotFoundError, M as MigrationError, N as NodeConstraintNotFoundError, g as NodeNotFoundError, R as RestrictedDeleteError, S as SchemaMismatchError, T as TypeGraphError, h as TypeGraphErrorOptions, U as UniquenessError, i as UnsupportedPredicateError, V as ValidationError, j as ValidationErrorDetails, k as ValidationIssue, l as VersionConflictError, m as getErrorSuggestion, n as isConstraintError, o as isSystemError, p as isTypeGraphError, q as isUserRecoverable } from './index-DXkEXpNz.cjs';
-import { A as AggregateExpr, F as FieldRef, C as ComparisonOp, a as AggregateComparisonPredicate } from './ast-dgLhLOg0.cjs';
-export { H as HybridFusionOptions, J as JsonPointer, b as JsonPointerFor, c as JsonPointerInput, d as JsonPointerSegment, e as JsonPointerSegments, f as JsonPointerSegmentsFor, M as MAX_JSON_POINTER_DEPTH, O as OrderSpec, P as ParameterRef, R as ResolveJsonPointer, g as ResolveJsonPointerSegments, S as SortDirection, T as TraversalExpansion, j as joinJsonPointers, h as jsonPointer, n as normalizeJsonPointer, p as parseJsonPointer } from './ast-dgLhLOg0.cjs';
+import { e as KindAnnotations, N as NodeType, d as EdgeType } from './extension-types-D07e_NTw.cjs';
+export { A as AnyEdgeType, h as CURRENT_GRAPH_EXTENSION_VERSION, f as Cardinality, C as Collation, D as DeleteBehavior, i as EdgeId, j as EdgeProps, E as EdgeRegistration, k as EdgeTypeWithEndpoints, g as EndpointExistence, c as GraphDefaults, G as GraphExtension, l as GraphExtensionVersion, J as JsonValue, L as LEGACY_GRAPH_EXTENSION_VERSION, m as NodeId, n as NodeProps, b as NodeRegistration, T as TemporalMode, o as UniqueConstraint, U as UniquenessScope, p as isEdgeType, q as isEdgeTypeWithEndpoints, r as isNodeType } from './extension-types-D07e_NTw.cjs';
+import { z as InferenceType, M as MetaEdge, O as OntologyRelation, A as AggregateExpr, C as FieldRef, D as ComparisonOp, H as AggregateComparisonPredicate } from './types--0EslBx5.cjs';
+export { B as BackendCapabilities, K as CommitSchemaVersionExpected, L as CommitSchemaVersionParams, P as DEFAULT_SQL_SCHEMA, T as DeleteFulltextBatchParams, E as EdgeIndexConfig, a as EdgeIndexDeclaration, n as EdgeIndexDirection, o as EdgeIndexWhereBuilder, U as FulltextBatchRow, W as FulltextCapabilities, X as FulltextQueryMode, Y as FulltextSearchParams, Z as FulltextSearchResult, F as FulltextStrategy, G as GraphBackend, _ as HybridFusionOptions, I as IndexDeclaration, p as IndexOrigin, q as IndexScope, c as IndexWhereExpression, r as IndexWhereFieldBuilder, s as IndexWhereInput, J as JsonPointer, $ as JsonPointerFor, a0 as JsonPointerInput, a1 as JsonPointerSegment, a2 as JsonPointerSegments, a3 as JsonPointerSegmentsFor, a4 as MAX_JSON_POINTER_DEPTH, a5 as MetaEdgeProperties, N as NodeIndexConfig, b as NodeIndexDeclaration, t as NodeIndexWhereBuilder, a6 as OrderSpec, a7 as ParameterRef, a8 as ResolveJsonPointer, a9 as ResolveJsonPointerSegments, y as SchemaVersionRow, aa as SetActiveVersionParams, ab as SortDirection, m as SqlDialect, ac as SqlSchema, ad as SqlTableNames, ae as TransactionBackend, af as TraversalExpansion, ag as UpsertFulltextBatchParams, ah as VectorCapabilities, ai as createSqlSchema, aj as fts5Strategy, ak as isMetaEdge, al as joinJsonPointers, am as jsonPointer, an as normalizeJsonPointer, ao as parseJsonPointer, ap as tsvectorStrategy } from './types--0EslBx5.cjs';
+import { A as AliasMap, E as EdgeAliasMap, Q as QueryBuilder, T as TraversalBuilder, C as CreateQueryBuilderOptions } from './store-BAGuOHDh.cjs';
+export { a as AggregateResult, b as AlgorithmCyclePolicy, c as AnyEdge, d as AnyNode, B as BaseTraversalOptions, e as BatchResults, f as BatchableQuery, g as ConstraintNames, h as CreateEdgeInput, i as CreateNodeInput, D as DEFAULT_SEARCHABLE_LANGUAGE, j as DegreeOptions, k as DynamicEdgeAccessor, l as DynamicEdgeCollection, m as DynamicEdgeType, n as DynamicFieldBuilder, o as DynamicNodeAccessor, p as DynamicNodeCollection, q as DynamicNodeType, r as DynamicSelectableEdge, s as DynamicSelectableNode, t as Edge, u as EdgeAccessor, v as EdgeCollection, w as EdgeFindByEndpointsOptions, x as EdgeGetOrCreateByEndpointsOptions, y as EdgeGetOrCreateByEndpointsResult, z as EdgeIntrospection, F as EmbeddingSchema, G as EmbeddingValue, H as ExecutableAggregateQuery, I as ExecutableQuery, J as FieldAccessor, K as FulltextSearchHit, L as FulltextSearchOptions, M as GetOrCreateAction, N as GraphAlgorithms, O as GraphEdgeCollections, P as GraphNodeCollections, R as HookContext, U as HybridFulltextOptions, V as HybridSearchHit, W as HybridSearchOptions, X as HybridVectorOptions, Y as IfExistsMode, Z as KindIntrospection, _ as MaterializeRemovalsEntry, $ as MaterializeRemovalsOptions, a0 as MaterializeRemovalsResult, a1 as NeighborsOptions, a2 as Node, a3 as NodeAccessor, a4 as NodeAlias, a5 as NodeCollection, a6 as NodeGetOrCreateByConstraintOptions, a7 as NodeGetOrCreateByConstraintResult, a8 as NodeIdentifier, a9 as NodeRef, aa as OntologyIntrospection, ab as OperationHookContext, ac as PaginateOptions, ad as PaginatedResult, ae as PathNode, af as Predicate, ag as PreparedQuery, ah as PropsAccessor, ai as QueryHookContext, aj as QueryOptions, ak as ReachableNode, al as ReachableOptions, am as RebuildFulltextOptions, an as RebuildFulltextResult, ao as RecursiveTraversalOptions, ap as SchemaIntrospection, aq as SearchableMetadata, ar as SearchableOptions, as as SearchableSchema, at as SelectContext, au as SelectableEdge, av as SelectableNode, aw as ShortestPathOptions, ax as ShortestPathResult, S as Store, ay as StoreHooks, az as StoreOptions, aA as StoreProjection, aB as StoreRef, aC as StoreSearch, aD as StreamOptions, aE as SubgraphEdgeResult, aF as SubgraphNodeResult, aG as SubgraphOptions, aH as SubgraphResult, aI as SubsetEdge, aJ as SubsetNode, aK as TemporalAlgorithmOptions, aL as TransactionContext, aM as TraversalDirection, aN as TypedEdgeCollection, aO as UnionableQuery, aP as UniqueIntrospection, aQ as UpdateEdgeInput, aR as UpdateNodeInput, aS as VectorSearchHit, aT as VectorSearchOptions, aU as createStore, aV as createStoreWithSchema, aW as defineSubgraphProject, aX as embedding, aY as exists, aZ as fieldRef, a_ as getEmbeddingDimensions, a$ as getSearchableMetadata, b0 as inSubquery, b1 as isEmbeddingSchema, b2 as isParameterRef, b3 as isSearchableSchema, b4 as notExists, b5 as notInSubquery, b6 as param, b7 as searchable } from './store-BAGuOHDh.cjs';
+import { G as GraphDef, K as KindRegistry } from './manager-BpjBW1JK.cjs';
+export { A as AllEdgeTypes, s as AllNodeTypes, t as EdgeKinds, u as GetEdgeType, v as GetNodeType, w as NodeKinds, c as SchemaManagerOptions, d as SchemaValidationResult, x as defineGraph, y as getEdgeKinds, z as getNodeKinds, B as isGraphDef } from './manager-BpjBW1JK.cjs';
+export { B as BackendDisposedError, C as CardinalityError, b as CompilerInvariantError, c as ConfigurationError, D as DatabaseOperationError, d as DisjointError, E as EagerMaterializationError, e as EdgeNotFoundError, f as EndpointError, g as EndpointNotFoundError, h as ErrorCategory, K as KindNotFoundError, M as MigrationError, N as NodeConstraintNotFoundError, i as NodeNotFoundError, R as RestrictedDeleteError, S as SchemaContentConflictError, j as SchemaMismatchError, k as StaleVersionError, T as TypeGraphError, l as TypeGraphErrorOptions, U as UniquenessError, m as UnsupportedPredicateError, a as ValidationError, n as ValidationErrorDetails, V as ValidationIssue, o as VersionConflictError, p as getErrorSuggestion, q as isConstraintError, r as isSystemError, s as isTypeGraphError, t as isUserRecoverable } from './index-CT6nvtxL.cjs';
+export { a as MaterializeIndexesEntry, b as MaterializeIndexesOptions, M as MaterializeIndexesResult } from './materialize-indexes-BB9N5uQl.cjs';
+export { a as andWhere, d as defineEdgeIndex, b as defineNodeIndex, n as notWhere, o as orWhere } from './where-m1uWsdua.cjs';
+export { GraphExtensionError, GraphExtensionIssue, GraphExtensionIssueCode, GraphExtensionUnresolvedEndpointError, GraphExtensionValidationError, GraphExtensionVersionUnsupportedError, IncompatibleChange, IncompatibleChangeError, KindCollisionError, KindHasReferentsError, KindReferent, RemoveCompileTimeKindError, defineGraphExtension, validateGraphExtension } from './graph-extension/index.cjs';
 import 'drizzle-orm';
 
 /**
@@ -18,6 +21,14 @@ type DefineNodeOptions<S extends z.ZodObject<z.ZodRawShape>> = Readonly<{
     schema: S;
     /** Optional description for documentation */
     description?: string;
+    /**
+     * Consumer-owned structured annotations for the kind.
+     *
+     * Stored in the canonical schema and **participates in schema hashing** —
+     * any change bumps the schema version and shows up as a `safe`-severity
+     * diff in `getSchemaChanges`. See `KindAnnotations` for the contract.
+     */
+    annotations?: KindAnnotations;
 }>;
 /**
  * Creates a node type definition.
@@ -43,6 +54,14 @@ type DefineEdgeOptions<S extends z.ZodObject<z.ZodRawShape>, From extends readon
     schema?: S;
     /** Optional description for documentation */
     description?: string;
+    /**
+     * Consumer-owned structured annotations for the kind.
+     *
+     * Stored in the canonical schema and **participates in schema hashing** —
+     * any change bumps the schema version and shows up as a `safe`-severity
+     * diff in `getSchemaChanges`. See `KindAnnotations` for the contract.
+     */
+    annotations?: KindAnnotations;
     /** Node types that can be the source of this edge (domain constraint) */
     from?: From;
     /** Node types that can be the target of this edge (range constraint) */
@@ -766,4 +785,4 @@ type IdConfig = Readonly<{
     edgeIdGenerator: IdGenerator;
 }>;
 
-export { AliasMap, type DefineEdgeOptions, type DefineNodeOptions, EdgeType, type ExternalRefSchema, type ExternalRefValue, FieldRef, type FlexibleQueryFragment, GraphDef, type IdConfig, type IdGenerator, InferenceType, MAX_EXPLICIT_RECURSIVE_DEPTH, MAX_RECURSIVE_DEPTH, MetaEdge, type MetaEdgeOptions, NodeType, OntologyRelation, QueryBuilder, type QueryFragment, type TraversalFragment, avg, broader, composeFragments, core, count, countDistinct, countDistinctEdges, countEdges, createExternalRef, createFragment, createQueryBuilder, defineEdge, defineNode, differentFrom, disjointWith, equivalentTo, externalRef, field, generateId, getExternalRefTable, hasPart, having, havingEq, havingGt, havingGte, havingLt, havingLte, implies, inverseOf, isExternalRefSchema, limitFragment, max, metaEdge, min, narrower, offsetFragment, orderByFragment, partOf, relatedTo, sameAs, subClassOf, sum };
+export { AliasMap, type DefineEdgeOptions, type DefineNodeOptions, EdgeType, type ExternalRefSchema, type ExternalRefValue, FieldRef, type FlexibleQueryFragment, GraphDef, type IdConfig, type IdGenerator, InferenceType, KindAnnotations, MAX_EXPLICIT_RECURSIVE_DEPTH, MAX_RECURSIVE_DEPTH, MetaEdge, type MetaEdgeOptions, NodeType, OntologyRelation, QueryBuilder, type QueryFragment, type TraversalFragment, avg, broader, composeFragments, core, count, countDistinct, countDistinctEdges, countEdges, createExternalRef, createFragment, createQueryBuilder, defineEdge, defineNode, differentFrom, disjointWith, equivalentTo, externalRef, field, generateId, getExternalRefTable, hasPart, having, havingEq, havingGt, havingGte, havingLt, havingLte, implies, inverseOf, isExternalRefSchema, limitFragment, max, metaEdge, min, narrower, offsetFragment, orderByFragment, partOf, relatedTo, sameAs, subClassOf, sum };

package/dist/index.d.ts

@@ -1,13 +1,16 @@
 import { z } from 'zod';
-import { N as NodeType, E as EdgeType, I as InferenceType, M as MetaEdge, O as OntologyRelation } from './types-Qk2l3IkQ.js';
-export { A as AnyEdgeType, B as BackendCapabilities, C as Cardinality, a as Collation, D as DEFAULT_SQL_SCHEMA, b as DeleteBehavior, c as DeleteFulltextBatchParams, d as EdgeId, e as EdgeProps, f as EdgeRegistration, g as EdgeTypeWithEndpoints, h as EndpointExistence, F as FulltextBatchRow, i as FulltextCapabilities, j as FulltextQueryMode, k as FulltextSearchParams, l as FulltextSearchResult, m as FulltextStrategy, G as GraphBackend, n as GraphDefaults, o as MetaEdgeProperties, p as NodeId, q as NodeProps, r as NodeRegistration, S as SqlDialect, s as SqlSchema, t as SqlTableNames, T as TemporalMode, u as TransactionBackend, U as UniqueConstraint, v as UniquenessScope, w as UpsertFulltextBatchParams, V as VectorCapabilities, x as createSqlSchema, y as fts5Strategy, z as isEdgeType, H as isEdgeTypeWithEndpoints, J as isMetaEdge, K as isNodeType, L as tsvectorStrategy } from './types-Qk2l3IkQ.js';
-import { A as AliasMap, E as EdgeAliasMap, Q as QueryBuilder, T as TraversalBuilder, C as CreateQueryBuilderOptions } from './store-U3i2tUch.js';
-export { a as AggregateResult, b as AlgorithmCyclePolicy, c as AnyEdge, d as AnyNode, B as BaseTraversalOptions, e as BatchResults, f as BatchableQuery, g as ConstraintNames, h as CreateEdgeInput, i as CreateNodeInput, D as DEFAULT_SEARCHABLE_LANGUAGE, j as DegreeOptions, k as DynamicEdgeCollection, l as DynamicNodeCollection, m as Edge, n as EdgeAccessor, o as EdgeCollection, p as EdgeFindByEndpointsOptions, q as EdgeGetOrCreateByEndpointsOptions, r as EdgeGetOrCreateByEndpointsResult, s as EmbeddingSchema, t as EmbeddingValue, u as ExecutableAggregateQuery, v as ExecutableQuery, F as FieldAccessor, w as FulltextSearchHit, x as FulltextSearchOptions, G as GetOrCreateAction, y as GraphAlgorithms, z as GraphEdgeCollections, H as GraphNodeCollections, I as HookContext, J as HybridFulltextOptions, K as HybridSearchHit, L as HybridSearchOptions, M as HybridVectorOptions, N as IfExistsMode, O as NeighborsOptions, P as Node, R as NodeAccessor, S as NodeAlias, U as NodeCollection, V as NodeGetOrCreateByConstraintOptions, W as NodeGetOrCreateByConstraintResult, X as NodeIdentifier, Y as NodeRef, Z as OperationHookContext, _ as PaginateOptions, $ as PaginatedResult, a0 as PathNode, a1 as Predicate, a2 as PreparedQuery, a3 as PropsAccessor, a4 as QueryHookContext, a5 as QueryOptions, a6 as ReachableNode, a7 as ReachableOptions, a8 as RebuildFulltextOptions, a9 as RebuildFulltextResult, aa as RecursiveTraversalOptions, ab as SearchableMetadata, ac as SearchableOptions, ad as SearchableSchema, ae as SelectContext, af as SelectableEdge, ag as SelectableNode, ah as ShortestPathOptions, ai as ShortestPathResult, aj as Store, ak as StoreHooks, al as StoreOptions, am as StoreProjection, an as StoreSearch, ao as StreamOptions, ap as SubgraphEdgeResult, aq as SubgraphNodeResult, ar as SubgraphOptions, as as SubgraphResult, at as SubsetEdge, au as SubsetNode, av as TemporalAlgorithmOptions, aw as TransactionContext, ax as TraversalDirection, ay as TypedEdgeCollection, az as UnionableQuery, aA as UpdateEdgeInput, aB as UpdateNodeInput, aC as VectorSearchHit, aD as createStore, aE as createStoreWithSchema, aF as defineSubgraphProject, aG as embedding, aH as exists, aI as fieldRef, aJ as getEmbeddingDimensions, aK as getSearchableMetadata, aL as inSubquery, aM as isEmbeddingSchema, aN as isParameterRef, aO as isSearchableSchema, aP as notExists, aQ as notInSubquery, aR as param, aS as searchable } from './store-U3i2tUch.js';
-import { G as GraphDef, K as KindRegistry } from './manager-nIhmttD-.js';
-export { A as AllEdgeTypes, a as AllNodeTypes, E as EdgeKinds, b as GetEdgeType, c as GetNodeType, N as NodeKinds, S as SchemaManagerOptions, d as SchemaValidationResult, e as defineGraph, g as getEdgeKinds, f as getNodeKinds, i as isGraphDef } from './manager-nIhmttD-.js';
-export { B as BackendDisposedError, C as CardinalityError, a as CompilerInvariantError, b as ConfigurationError, D as DatabaseOperationError, c as DisjointError, E as EdgeNotFoundError, d as EndpointError, e as EndpointNotFoundError, f as ErrorCategory, K as KindNotFoundError, M as MigrationError, N as NodeConstraintNotFoundError, g as NodeNotFoundError, R as RestrictedDeleteError, S as SchemaMismatchError, T as TypeGraphError, h as TypeGraphErrorOptions, U as UniquenessError, i as UnsupportedPredicateError, V as ValidationError, j as ValidationErrorDetails, k as ValidationIssue, l as VersionConflictError, m as getErrorSuggestion, n as isConstraintError, o as isSystemError, p as isTypeGraphError, q as isUserRecoverable } from './index-DXkEXpNz.js';
-import { A as AggregateExpr, F as FieldRef, C as ComparisonOp, a as AggregateComparisonPredicate } from './ast-C8S37w1A.js';
-export { H as HybridFusionOptions, J as JsonPointer, b as JsonPointerFor, c as JsonPointerInput, d as JsonPointerSegment, e as JsonPointerSegments, f as JsonPointerSegmentsFor, M as MAX_JSON_POINTER_DEPTH, O as OrderSpec, P as ParameterRef, R as ResolveJsonPointer, g as ResolveJsonPointerSegments, S as SortDirection, T as TraversalExpansion, j as joinJsonPointers, h as jsonPointer, n as normalizeJsonPointer, p as parseJsonPointer } from './ast-C8S37w1A.js';
+import { e as KindAnnotations, N as NodeType, d as EdgeType } from './extension-types-D07e_NTw.js';
+export { A as AnyEdgeType, h as CURRENT_GRAPH_EXTENSION_VERSION, f as Cardinality, C as Collation, D as DeleteBehavior, i as EdgeId, j as EdgeProps, E as EdgeRegistration, k as EdgeTypeWithEndpoints, g as EndpointExistence, c as GraphDefaults, G as GraphExtension, l as GraphExtensionVersion, J as JsonValue, L as LEGACY_GRAPH_EXTENSION_VERSION, m as NodeId, n as NodeProps, b as NodeRegistration, T as TemporalMode, o as UniqueConstraint, U as UniquenessScope, p as isEdgeType, q as isEdgeTypeWithEndpoints, r as isNodeType } from './extension-types-D07e_NTw.js';
+import { z as InferenceType, M as MetaEdge, O as OntologyRelation, A as AggregateExpr, C as FieldRef, D as ComparisonOp, H as AggregateComparisonPredicate } from './types-BNWYZ-0-.js';
+export { B as BackendCapabilities, K as CommitSchemaVersionExpected, L as CommitSchemaVersionParams, P as DEFAULT_SQL_SCHEMA, T as DeleteFulltextBatchParams, E as EdgeIndexConfig, a as EdgeIndexDeclaration, n as EdgeIndexDirection, o as EdgeIndexWhereBuilder, U as FulltextBatchRow, W as FulltextCapabilities, X as FulltextQueryMode, Y as FulltextSearchParams, Z as FulltextSearchResult, F as FulltextStrategy, G as GraphBackend, _ as HybridFusionOptions, I as IndexDeclaration, p as IndexOrigin, q as IndexScope, c as IndexWhereExpression, r as IndexWhereFieldBuilder, s as IndexWhereInput, J as JsonPointer, $ as JsonPointerFor, a0 as JsonPointerInput, a1 as JsonPointerSegment, a2 as JsonPointerSegments, a3 as JsonPointerSegmentsFor, a4 as MAX_JSON_POINTER_DEPTH, a5 as MetaEdgeProperties, N as NodeIndexConfig, b as NodeIndexDeclaration, t as NodeIndexWhereBuilder, a6 as OrderSpec, a7 as ParameterRef, a8 as ResolveJsonPointer, a9 as ResolveJsonPointerSegments, y as SchemaVersionRow, aa as SetActiveVersionParams, ab as SortDirection, m as SqlDialect, ac as SqlSchema, ad as SqlTableNames, ae as TransactionBackend, af as TraversalExpansion, ag as UpsertFulltextBatchParams, ah as VectorCapabilities, ai as createSqlSchema, aj as fts5Strategy, ak as isMetaEdge, al as joinJsonPointers, am as jsonPointer, an as normalizeJsonPointer, ao as parseJsonPointer, ap as tsvectorStrategy } from './types-BNWYZ-0-.js';
+import { A as AliasMap, E as EdgeAliasMap, Q as QueryBuilder, T as TraversalBuilder, C as CreateQueryBuilderOptions } from './store-De98Lod4.js';
+export { a as AggregateResult, b as AlgorithmCyclePolicy, c as AnyEdge, d as AnyNode, B as BaseTraversalOptions, e as BatchResults, f as BatchableQuery, g as ConstraintNames, h as CreateEdgeInput, i as CreateNodeInput, D as DEFAULT_SEARCHABLE_LANGUAGE, j as DegreeOptions, k as DynamicEdgeAccessor, l as DynamicEdgeCollection, m as DynamicEdgeType, n as DynamicFieldBuilder, o as DynamicNodeAccessor, p as DynamicNodeCollection, q as DynamicNodeType, r as DynamicSelectableEdge, s as DynamicSelectableNode, t as Edge, u as EdgeAccessor, v as EdgeCollection, w as EdgeFindByEndpointsOptions, x as EdgeGetOrCreateByEndpointsOptions, y as EdgeGetOrCreateByEndpointsResult, z as EdgeIntrospection, F as EmbeddingSchema, G as EmbeddingValue, H as ExecutableAggregateQuery, I as ExecutableQuery, J as FieldAccessor, K as FulltextSearchHit, L as FulltextSearchOptions, M as GetOrCreateAction, N as GraphAlgorithms, O as GraphEdgeCollections, P as GraphNodeCollections, R as HookContext, U as HybridFulltextOptions, V as HybridSearchHit, W as HybridSearchOptions, X as HybridVectorOptions, Y as IfExistsMode, Z as KindIntrospection, _ as MaterializeRemovalsEntry, $ as MaterializeRemovalsOptions, a0 as MaterializeRemovalsResult, a1 as NeighborsOptions, a2 as Node, a3 as NodeAccessor, a4 as NodeAlias, a5 as NodeCollection, a6 as NodeGetOrCreateByConstraintOptions, a7 as NodeGetOrCreateByConstraintResult, a8 as NodeIdentifier, a9 as NodeRef, aa as OntologyIntrospection, ab as OperationHookContext, ac as PaginateOptions, ad as PaginatedResult, ae as PathNode, af as Predicate, ag as PreparedQuery, ah as PropsAccessor, ai as QueryHookContext, aj as QueryOptions, ak as ReachableNode, al as ReachableOptions, am as RebuildFulltextOptions, an as RebuildFulltextResult, ao as RecursiveTraversalOptions, ap as SchemaIntrospection, aq as SearchableMetadata, ar as SearchableOptions, as as SearchableSchema, at as SelectContext, au as SelectableEdge, av as SelectableNode, aw as ShortestPathOptions, ax as ShortestPathResult, S as Store, ay as StoreHooks, az as StoreOptions, aA as StoreProjection, aB as StoreRef, aC as StoreSearch, aD as StreamOptions, aE as SubgraphEdgeResult, aF as SubgraphNodeResult, aG as SubgraphOptions, aH as SubgraphResult, aI as SubsetEdge, aJ as SubsetNode, aK as TemporalAlgorithmOptions, aL as TransactionContext, aM as TraversalDirection, aN as TypedEdgeCollection, aO as UnionableQuery, aP as UniqueIntrospection, aQ as UpdateEdgeInput, aR as UpdateNodeInput, aS as VectorSearchHit, aT as VectorSearchOptions, aU as createStore, aV as createStoreWithSchema, aW as defineSubgraphProject, aX as embedding, aY as exists, aZ as fieldRef, a_ as getEmbeddingDimensions, a$ as getSearchableMetadata, b0 as inSubquery, b1 as isEmbeddingSchema, b2 as isParameterRef, b3 as isSearchableSchema, b4 as notExists, b5 as notInSubquery, b6 as param, b7 as searchable } from './store-De98Lod4.js';
+import { G as GraphDef, K as KindRegistry } from './manager-BKaPQbns.js';
+export { A as AllEdgeTypes, s as AllNodeTypes, t as EdgeKinds, u as GetEdgeType, v as GetNodeType, w as NodeKinds, c as SchemaManagerOptions, d as SchemaValidationResult, x as defineGraph, y as getEdgeKinds, z as getNodeKinds, B as isGraphDef } from './manager-BKaPQbns.js';
+export { B as BackendDisposedError, C as CardinalityError, b as CompilerInvariantError, c as ConfigurationError, D as DatabaseOperationError, d as DisjointError, E as EagerMaterializationError, e as EdgeNotFoundError, f as EndpointError, g as EndpointNotFoundError, h as ErrorCategory, K as KindNotFoundError, M as MigrationError, N as NodeConstraintNotFoundError, i as NodeNotFoundError, R as RestrictedDeleteError, S as SchemaContentConflictError, j as SchemaMismatchError, k as StaleVersionError, T as TypeGraphError, l as TypeGraphErrorOptions, U as UniquenessError, m as UnsupportedPredicateError, a as ValidationError, n as ValidationErrorDetails, V as ValidationIssue, o as VersionConflictError, p as getErrorSuggestion, q as isConstraintError, r as isSystemError, s as isTypeGraphError, t as isUserRecoverable } from './index-DQheiVQV.js';
+export { a as MaterializeIndexesEntry, b as MaterializeIndexesOptions, M as MaterializeIndexesResult } from './materialize-indexes-BYpU2RKh.js';
+export { a as andWhere, d as defineEdgeIndex, b as defineNodeIndex, n as notWhere, o as orWhere } from './where-CluR73rs.js';
+export { GraphExtensionError, GraphExtensionIssue, GraphExtensionIssueCode, GraphExtensionUnresolvedEndpointError, GraphExtensionValidationError, GraphExtensionVersionUnsupportedError, IncompatibleChange, IncompatibleChangeError, KindCollisionError, KindHasReferentsError, KindReferent, RemoveCompileTimeKindError, defineGraphExtension, validateGraphExtension } from './graph-extension/index.js';
 import 'drizzle-orm';
 
 /**
@@ -18,6 +21,14 @@ type DefineNodeOptions<S extends z.ZodObject<z.ZodRawShape>> = Readonly<{
     schema: S;
     /** Optional description for documentation */
     description?: string;
+    /**
+     * Consumer-owned structured annotations for the kind.
+     *
+     * Stored in the canonical schema and **participates in schema hashing** —
+     * any change bumps the schema version and shows up as a `safe`-severity
+     * diff in `getSchemaChanges`. See `KindAnnotations` for the contract.
+     */
+    annotations?: KindAnnotations;
 }>;
 /**
  * Creates a node type definition.
@@ -43,6 +54,14 @@ type DefineEdgeOptions<S extends z.ZodObject<z.ZodRawShape>, From extends readon
     schema?: S;
     /** Optional description for documentation */
     description?: string;
+    /**
+     * Consumer-owned structured annotations for the kind.
+     *
+     * Stored in the canonical schema and **participates in schema hashing** —
+     * any change bumps the schema version and shows up as a `safe`-severity
+     * diff in `getSchemaChanges`. See `KindAnnotations` for the contract.
+     */
+    annotations?: KindAnnotations;
     /** Node types that can be the source of this edge (domain constraint) */
     from?: From;
     /** Node types that can be the target of this edge (range constraint) */
@@ -766,4 +785,4 @@ type IdConfig = Readonly<{
     edgeIdGenerator: IdGenerator;
 }>;
 
-export { AliasMap, type DefineEdgeOptions, type DefineNodeOptions, EdgeType, type ExternalRefSchema, type ExternalRefValue, FieldRef, type FlexibleQueryFragment, GraphDef, type IdConfig, type IdGenerator, InferenceType, MAX_EXPLICIT_RECURSIVE_DEPTH, MAX_RECURSIVE_DEPTH, MetaEdge, type MetaEdgeOptions, NodeType, OntologyRelation, QueryBuilder, type QueryFragment, type TraversalFragment, avg, broader, composeFragments, core, count, countDistinct, countDistinctEdges, countEdges, createExternalRef, createFragment, createQueryBuilder, defineEdge, defineNode, differentFrom, disjointWith, equivalentTo, externalRef, field, generateId, getExternalRefTable, hasPart, having, havingEq, havingGt, havingGte, havingLt, havingLte, implies, inverseOf, isExternalRefSchema, limitFragment, max, metaEdge, min, narrower, offsetFragment, orderByFragment, partOf, relatedTo, sameAs, subClassOf, sum };
+export { AliasMap, type DefineEdgeOptions, type DefineNodeOptions, EdgeType, type ExternalRefSchema, type ExternalRefValue, FieldRef, type FlexibleQueryFragment, GraphDef, type IdConfig, type IdGenerator, InferenceType, KindAnnotations, MAX_EXPLICIT_RECURSIVE_DEPTH, MAX_RECURSIVE_DEPTH, MetaEdge, type MetaEdgeOptions, NodeType, OntologyRelation, QueryBuilder, type QueryFragment, type TraversalFragment, avg, broader, composeFragments, core, count, countDistinct, countDistinctEdges, countEdges, createExternalRef, createFragment, createQueryBuilder, defineEdge, defineNode, differentFrom, disjointWith, equivalentTo, externalRef, field, generateId, getExternalRefTable, hasPart, having, havingEq, havingGt, havingGte, havingLt, havingLte, implies, inverseOf, isExternalRefSchema, limitFragment, max, metaEdge, min, narrower, offsetFragment, orderByFragment, partOf, relatedTo, sameAs, subClassOf, sum };