@dxos/echo-query 0.8.4-main.74a063c4e0 → 0.8.4-main.765dc60934

package/dist/query-lite/index.d.ts

@@ -8034,7 +8034,7 @@ declare const FilterObject_: Struct<{
    * Filter by property.
    * Must not include object ID.
    */
-  props: Record$<SchemaClass<string, string, never>, suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterNot | FilterAnd | FilterOr, never>>;
+  props: Record$<SchemaClass<string, string, never>, suspend<FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, never>>;
   /**
    * Objects that have any of the given foreign keys.
    */
@@ -8045,6 +8045,15 @@ declare const FilterObject_: Struct<{
     readonly source: string;
     readonly id: string;
   }, never>>>;
+  /**
+   * Match objects whose meta `key` equals this fully-qualified registry key (FQN format).
+   */
+  metaKey: optional<typeof String$>;
+  /**
+   * Semver range matched against the object's meta `version`.
+   * Only consulted when {@link metaKey} is set. Objects with no `version` do not satisfy a version-constrained filter.
+   */
+  metaVersion: optional<typeof String$>;
 }>;
 interface FilterObject extends Schema.Type<typeof FilterObject_> {}
 declare const FilterObject: Schema<FilterObject>;
@@ -8126,7 +8135,7 @@ declare const FilterTextSearch: Schema<FilterTextSearch>;
  */
 declare const FilterNot_: Struct<{
   type: Literal<["not"]>;
-  filter: suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterNot | FilterAnd | FilterOr, never>;
+  filter: suspend<FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, never>;
 }>;
 interface FilterNot extends Schema.Type<typeof FilterNot_> {}
 declare const FilterNot: Schema<FilterNot>;
@@ -8135,7 +8144,7 @@ declare const FilterNot: Schema<FilterNot>;
  */
 declare const FilterAnd_: Struct<{
   type: Literal<["and"]>;
-  filters: Array$<suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterNot | FilterAnd | FilterOr, never>>;
+  filters: Array$<suspend<FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, never>>;
 }>;
 interface FilterAnd extends Schema.Type<typeof FilterAnd_> {}
 declare const FilterAnd: Schema<FilterAnd>;
@@ -8144,21 +8153,34 @@ declare const FilterAnd: Schema<FilterAnd>;
  */
 declare const FilterOr_: Struct<{
   type: Literal<["or"]>;
-  filters: Array$<suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterNot | FilterAnd | FilterOr, never>>;
+  filters: Array$<suspend<FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, never>>;
 }>;
 interface FilterOr extends Schema.Type<typeof FilterOr_> {}
 declare const FilterOr: Schema<FilterOr>;
+/**
+ * Filter objects that are children of the specified parents.
+ * With transitive=true (default), matches grandchildren and beyond.
+ */
+declare const FilterChildOf_: Struct<{
+  type: Literal<["child-of"]>;
+  /** Parent DXNs to match children of. */
+  parents: Array$<refine<string, typeof NonEmptyString>>;
+  /** Whether to match transitively (grandchildren, etc.). Defaults to true. */
+  transitive: typeof Boolean$;
+}>;
+interface FilterChildOf extends Schema.Type<typeof FilterChildOf_> {}
+declare const FilterChildOf: Schema<FilterChildOf>;
 /**
  * Union of filters.
  */
-declare const Filter$1: Union<[Schema<FilterObject, FilterObject, never>, Schema<FilterCompare, FilterCompare, never>, Schema<FilterIn, FilterIn, never>, Schema<FilterContains, FilterContains, never>, Schema<FilterTag, FilterTag, never>, Schema<FilterRange, FilterRange, never>, Schema<FilterTimestamp, FilterTimestamp, never>, Schema<FilterTextSearch, FilterTextSearch, never>, Schema<FilterNot, FilterNot, never>, Schema<FilterAnd, FilterAnd, never>, Schema<FilterOr, FilterOr, never>]>;
+declare const Filter$1: Union<[Schema<FilterObject, FilterObject, never>, Schema<FilterCompare, FilterCompare, never>, Schema<FilterIn, FilterIn, never>, Schema<FilterContains, FilterContains, never>, Schema<FilterTag, FilterTag, never>, Schema<FilterRange, FilterRange, never>, Schema<FilterTimestamp, FilterTimestamp, never>, Schema<FilterTextSearch, FilterTextSearch, never>, Schema<FilterChildOf, FilterChildOf, never>, Schema<FilterNot, FilterNot, never>, Schema<FilterAnd, FilterAnd, never>, Schema<FilterOr, FilterOr, never>]>;
 type Filter$1 = Schema.Type<typeof Filter$1>;
 /**
  * Query objects by type, id, and/or predicates.
  */
 declare const QuerySelectClause_: Struct<{
   type: Literal<["select"]>;
-  filter: suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterNot | FilterAnd | FilterOr, never>;
+  filter: suspend<FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, never>;
 }>;
 interface QuerySelectClause extends Schema.Type<typeof QuerySelectClause_> {}
 declare const QuerySelectClause: Schema<QuerySelectClause>;
@@ -8167,8 +8189,8 @@ declare const QuerySelectClause: Schema<QuerySelectClause>;
  */
 declare const QueryFilterClause_: Struct<{
   type: Literal<["filter"]>;
-  selection: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
-  filter: suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterNot | FilterAnd | FilterOr, never>;
+  selection: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
+  filter: suspend<FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, never>;
 }>;
 interface QueryFilterClause extends Schema.Type<typeof QueryFilterClause_> {}
 declare const QueryFilterClause: Schema<QueryFilterClause>;
@@ -8177,7 +8199,7 @@ declare const QueryFilterClause: Schema<QueryFilterClause>;
  */
 declare const QueryReferenceTraversalClause_: Struct<{
   type: Literal<["reference-traversal"]>;
-  anchor: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
+  anchor: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
   property: typeof String$;
 }>;
 interface QueryReferenceTraversalClause extends Schema.Type<typeof QueryReferenceTraversalClause_> {}
@@ -8187,7 +8209,7 @@ declare const QueryReferenceTraversalClause: Schema<QueryReferenceTraversalClaus
  */
 declare const QueryIncomingReferencesClause_: Struct<{
   type: Literal<["incoming-references"]>;
-  anchor: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
+  anchor: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
   /**
    * Property path where the reference is located.
    * If null, matches references from any property.
@@ -8202,14 +8224,14 @@ declare const QueryIncomingReferencesClause: Schema<QueryIncomingReferencesClaus
  */
 declare const QueryRelationClause_: Struct<{
   type: Literal<["relation"]>;
-  anchor: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
+  anchor: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
   /**
    * outgoing: anchor is the source of the relation.
    * incoming: anchor is the target of the relation.
    * both: anchor is either the source or target of the relation.
    */
   direction: Literal<["outgoing", "incoming", "both"]>;
-  filter: optional<suspend<FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterNot | FilterAnd | FilterOr, FilterObject | FilterCompare | FilterIn | FilterContains | FilterTag | FilterRange | FilterTimestamp | FilterTextSearch | FilterNot | FilterAnd | FilterOr, never>>;
+  filter: optional<suspend<FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, FilterAnd | FilterChildOf | FilterCompare | FilterContains | FilterIn | FilterNot | FilterObject | FilterOr | FilterRange | FilterTag | FilterTextSearch | FilterTimestamp, never>>;
 }>;
 interface QueryRelationClause extends Schema.Type<typeof QueryRelationClause_> {}
 declare const QueryRelationClause: Schema<QueryRelationClause>;
@@ -8218,7 +8240,7 @@ declare const QueryRelationClause: Schema<QueryRelationClause>;
  */
 declare const QueryRelationTraversalClause_: Struct<{
   type: Literal<["relation-traversal"]>;
-  anchor: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
+  anchor: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
   direction: Literal<["source", "target", "both"]>;
 }>;
 interface QueryRelationTraversalClause extends Schema.Type<typeof QueryRelationTraversalClause_> {}
@@ -8228,7 +8250,7 @@ declare const QueryRelationTraversalClause: Schema<QueryRelationTraversalClause>
  */
 declare const QueryHierarchyTraversalClause_: Struct<{
   type: Literal<["hierarchy-traversal"]>;
-  anchor: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
+  anchor: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
   /**
    * to-parent: traverse from child to parent.
    * to-children: traverse from parent to children.
@@ -8242,7 +8264,7 @@ declare const QueryHierarchyTraversalClause: Schema<QueryHierarchyTraversalClaus
  */
 declare const QueryUnionClause_: Struct<{
   type: Literal<["union"]>;
-  queries: Array$<suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>>;
+  queries: Array$<suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>>;
 }>;
 interface QueryUnionClause extends Schema.Type<typeof QueryUnionClause_> {}
 declare const QueryUnionClause: Schema<QueryUnionClause>;
@@ -8251,8 +8273,8 @@ declare const QueryUnionClause: Schema<QueryUnionClause>;
  */
 declare const QuerySetDifferenceClause_: Struct<{
   type: Literal<["set-difference"]>;
-  source: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
-  exclude: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
+  source: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
+  exclude: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
 }>;
 interface QuerySetDifferenceClause extends Schema.Type<typeof QuerySetDifferenceClause_> {}
 declare const QuerySetDifferenceClause: Schema<QuerySetDifferenceClause>;
@@ -8276,7 +8298,7 @@ declare const Order$1: Schema<Order$1>;
  */
 declare const QueryOrderClause_: Struct<{
   type: Literal<["order"]>;
-  query: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
+  query: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
   order: Array$<Schema<{
     readonly kind: "natural";
   } | {
@@ -8304,11 +8326,13 @@ declare const QueryOrderClause: Schema<QueryOrderClause>;
  */
 declare const QueryOptionsClause_: Struct<{
   type: Literal<["options"]>;
-  query: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
+  query: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
   options: suspend<{
-    readonly deleted?: "include" | "exclude" | "only" | undefined;
+    readonly deleted?: "exclude" | "include" | "only" | undefined;
+    readonly debugLabel?: string | undefined;
   }, {
-    readonly deleted?: "include" | "exclude" | "only" | undefined;
+    readonly debugLabel?: string | undefined;
+    readonly deleted?: "exclude" | "include" | "only" | undefined;
   }, never>;
 }>;
 interface QueryOptionsClause extends Schema.Type<typeof QueryOptionsClause_> {}
@@ -8318,26 +8342,26 @@ declare const QueryOptionsClause: Schema<QueryOptionsClause>;
  */
 declare const QueryLimitClause_: Struct<{
   type: Literal<["limit"]>;
-  query: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
+  query: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
   limit: typeof Number$;
 }>;
 interface QueryLimitClause extends Schema.Type<typeof QueryLimitClause_> {}
 declare const QueryLimitClause: Schema<QueryLimitClause>;
 declare const QueryFromClause_: Struct<{
   type: Literal<["from"]>;
-  query: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
+  query: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
   from: Union<[TaggedStruct<"scope", {
     scope: suspend<{
       readonly spaceIds?: readonly string[] | undefined;
-      readonly allQueuesFromSpaces?: boolean | undefined;
-      readonly queues?: readonly string[] | undefined;
+      readonly allFeedsFromSpaces?: boolean | undefined;
+      readonly feeds?: readonly string[] | undefined;
     }, {
+      readonly allFeedsFromSpaces?: boolean | undefined;
+      readonly feeds?: readonly string[] | undefined;
       readonly spaceIds?: readonly string[] | undefined;
-      readonly allQueuesFromSpaces?: boolean | undefined;
-      readonly queues?: readonly string[] | undefined;
     }, never>;
   }>, TaggedStruct<"query", {
-    query: suspend<QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause, never>;
+    query: suspend<QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause, never>;
   }>]>;
 }>;
 interface QueryFromClause extends Schema.Type<typeof QueryFromClause_> {}
@@ -8350,6 +8374,10 @@ declare const QueryOptions: Struct<{
    * Nested select statements will use this option to filter deleted objects.
    */
   deleted: optional<Literal<["include", "exclude", "only"]>>;
+  /**
+   * Diagnostics-only label for logs / tooling (not used by execution semantics).
+   */
+  debugLabel: optional<typeof String$>;
 }>;
 interface QueryOptions extends Schema.Type<typeof QueryOptions> {}
 /**
@@ -8359,19 +8387,19 @@ declare const Scope: Struct<{
   /**
    * The nested select statemets will select from the given spaces.
    *
-   * NOTE: Spaces and queues are unioned together if both are specified.
+   * NOTE: Spaces and feeds are unioned together if both are specified.
    */
   spaceIds: optional<Array$<typeof String$>>;
   /**
-   * If true, the nested select statements will select from all queues in the spaces specified by `spaceIds`.
+   * If true, the nested select statements will select from all feeds in the spaces specified by `spaceIds`.
    */
-  allQueuesFromSpaces: optional<typeof Boolean$>;
+  allFeedsFromSpaces: optional<typeof Boolean$>;
   /**
-   * The nested select statemets will select from the given queues.
+   * The nested select statemets will select from the given feeds (by underlying queue DXN).
    *
-   * NOTE: Spaces and queues are unioned together if both are specified.
+   * NOTE: Spaces and feeds are unioned together if both are specified.
    */
-  queues: optional<Array$<refine<string, typeof NonEmptyString>>>;
+  feeds: optional<Array$<refine<string, typeof NonEmptyString>>>;
 }>;
 interface Scope extends Schema.Type<typeof Scope> {}
 //#endregion
@@ -8421,137 +8449,6 @@ interface EchoTypeSchema<Self extends Schema.Any, ExtraFields = {}, K$1 extends
   readonly fields: Fields;
   instanceOf(value: unknown): boolean;
 }
-declare namespace Filter_d_exports {
-  export { Any$3 as Any, Filter, Props, TextSearchOptions, Type$2 as Type, and, between, contains, created, eq, everything, foreignKeys, fromAst$1 as fromAst, gt, gte, id, in$ as in, is$1 as is, lt, lte, neq, not, nothing, or, pretty$1 as pretty, props, tag, text, type$2 as type, typeDXN, typename$1 as typename, updated };
-}
-interface Filter<T$1> {
-  '~Filter': {
-    value: Covariant<T$1>;
-  };
-  ast: Filter$1;
-}
-type Props<T$1> = { [K in keyof T$1 & string]?: Filter<T$1[K]> | T$1[K] };
-type Any$3 = Filter<any>;
-type Type$2<F extends Any$3> = F extends Filter<infer T> ? T : never;
-declare class FilterClass implements Any$3 {
-  readonly ast: Filter$1;
-  private static 'variance';
-  constructor(ast: Filter$1);
-  '~Filter': {
-    value: Covariant<any>;
-  };
-}
-declare const is$1: (value: unknown) => value is Any$3;
-/** Construct a filter from an ast. */
-declare const fromAst$1: (ast: Filter$1) => Any$3;
-/**
- * Filter that matches all objects.
- */
-declare const everything: () => FilterClass;
-/**
- * Filter that matches no objects.
- */
-declare const nothing: () => FilterClass;
-declare const id: (...ids: ObjectId[]) => Any$3;
-/**
- * Filter by type.
- */
-declare const type$2: <S$1 extends Schema.All>(schema: S$1 | string, props?: Props<Schema.Type<S$1>>) => Filter<Schema.Type<S$1>>;
-/**
- * Filter by non-qualified typename.
- */
-declare const typename$1: (typename: string) => Any$3;
-/**
- * Filter by fully qualified type DXN.
- */
-declare const typeDXN: (dxn: DXN) => Any$3;
-/**
- * Filter by tag.
- */
-declare const tag: (tag: string) => Any$3;
-/**
- * Filter by properties.
- */
-declare const props: <T$1>(props: Props<T$1>) => Filter<T$1>;
-type TextSearchOptions = {
-  type?: 'full-text' | 'vector';
-};
-/**
- * Full-text or vector search.
- */
-declare const text: (text: string, options?: TextSearchOptions) => Any$3;
-/**
- * Filter by foreign keys.
- */
-declare const foreignKeys: <S$1 extends Schema.All>(schema: S$1 | string, keys: ForeignKey[]) => Filter<Schema.Type<S$1>>;
-/**
- * Predicate for property to be equal to the provided value.
- */
-declare const eq: <T$1>(value: T$1) => Filter<T$1 | undefined>;
-/**
- * Predicate for property to be not equal to the provided value.
- */
-declare const neq: <T$1>(value: T$1) => Filter<T$1 | undefined>;
-/**
- * Predicate for property to be greater than the provided value.
- */
-declare const gt: <T$1>(value: T$1) => Filter<T$1 | undefined>;
-/**
- * Predicate for property to be greater than or equal to the provided value.
- */
-declare const gte: <T$1>(value: T$1) => Filter<T$1 | undefined>;
-/**
- * Predicate for property to be less than the provided value.
- */
-declare const lt: <T$1>(value: T$1) => Filter<T$1 | undefined>;
-/**
- * Predicate for property to be less than or equal to the provided value.
- */
-declare const lte: <T$1>(value: T$1) => Filter<T$1 | undefined>;
-/**
- * Predicate for property to be in the provided array.
- * @param values - Values to check against.
- */
-declare const in$: <T$1>(...values: T$1[]) => Filter<T$1>;
-/**
- * Predicate for an array property to contain the provided value.
- * @param value - Value to check against.
- */
-declare const contains: <T$1>(value: T$1) => Filter<readonly T$1[] | undefined>;
-/**
- * Predicate for property to be in the provided range.
- * @param from - Start of the range (inclusive).
- * @param to - End of the range (exclusive).
- */
-declare const between: <T$1>(from: T$1, to: T$1) => Filter<T$1>;
-type TimeRange = {
-  after?: Date | number;
-  before?: Date | number;
-};
-/**
- * Filter objects by updatedAt timestamp.
- */
-declare const updated: (range: TimeRange) => Any$3;
-/**
- * Filter objects by createdAt timestamp.
- */
-declare const created: (range: TimeRange) => Any$3;
-/**
- * Negate the filter.
- */
-declare const not: <F extends Any$3>(filter: F) => Filter<Type$2<F>>;
-/**
- * Combine filters with a logical AND.
- */
-declare const and: <Filters extends readonly Any$3[]>(...filters: Filters) => Filter<Type$2<Filters[number]>>;
-/**
- * Combine filters with a logical OR.
- */
-declare const or: <Filters extends readonly Any$3[]>(...filters: Filters) => Filter<Type$2<Filters[number]>>;
-/**
- * Returns a human-readable string representation of a Filter AST.
- */
-declare const pretty$1: (filter: Any$3) => string;
 //#endregion
 //#region ../echo/dist/types/src/internal/JsonSchema/json-schema-type.d.ts
 /**
@@ -8679,7 +8576,7 @@ declare const _JsonSchemaType: Struct<{
   patternProperties: optional<Record$<typeof String$, suspend<JsonSchemaType, JsonSchemaType, never>>>;
   propertyNames: optional<suspend<JsonSchemaType, JsonSchemaType, never>>;
   definitions: optional<Record$<typeof String$, suspend<JsonSchemaType, JsonSchemaType, never>>>;
-  dependencies: optional<Record$<typeof String$, suspend<string | readonly string[] | JsonSchemaType, string | readonly string[] | JsonSchemaType, never>>>;
+  dependencies: optional<Record$<typeof String$, suspend<string | JsonSchemaType | readonly string[], string | JsonSchemaType | readonly string[], never>>>;
   contentMediaType: optional<typeof String$>;
   contentEncoding: optional<typeof String$>;
   if: optional<suspend<JsonSchemaType, JsonSchemaType, never>>;
@@ -8834,6 +8731,15 @@ interface Ref<T$1> extends Pipeable {
    * @returns Promise that will resolves with the target object or undefined if the object is not loaded locally.
    */
   tryLoad(): Promise<T$1 | undefined>;
+  /**
+   * Subscribe to the ref's resolution event.
+   * The callback fires when the target object becomes available in the working set
+   * (e.g. when its document is loaded after sibling-client mutation).
+   * Note: the resolver only schedules a notification when the target is requested
+   * via {@link target} while it is not yet loaded.
+   * @returns Function that unsubscribes the callback.
+   */
+  onResolved(callback: () => void): () => void;
   /**
    * Do not inline the target object in the reference.
    * Makes .target unavailable unless the reference is connected to a database context.
@@ -8883,6 +8789,63 @@ interface RefResolver {
   resolveSchema(dxn: DXN): Promise<Schema.AnyNoContext | undefined>;
 }
 //#endregion
+//#region ../echo/dist/types/src/Ref.d.ts
+/**
+ * Instance type for a reference.
+ *
+ * Reference can point to any object or relation.
+ * References are lazy loaded.
+ *
+ * `ref.dxn` is the DXN of the referenced object.
+ *
+ * @example
+ * ```ts
+ * const taskRef: Ref<Task> = Ref.make(task);
+ *
+ * await taskRef.load(); // Returns Promise<Task>
+ * yield* Database.load(taskRef); // Effectful version.
+ *
+ * database.makeRef(dxn); // Create a ref from a DXN.
+ * ```
+ */
+type Ref$1<T$1> = Ref<T$1>;
+type Unknown$2 = Ref<Unknown$1>;
+/**
+ * Factory function to create a Ref schema for the given target schema.
+ * Use this in schema definitions to declare reference fields.
+ *
+ * @example
+ * ```ts
+ * const Task = Schema.Struct({
+ *   assignee: Ref.Ref(Person),  // Creates a Ref schema
+ * }).pipe(Type.object({ typename: 'Task', version: '0.1.0' }));
+ * ```
+ */
+declare const Ref$1: <S$1 extends Schema.Any>(schema: S$1) => RefSchema<Schema.Type<S$1>>;
+/**
+ * TypeScript type for a Ref schema.
+ * This is the type of the SCHEMA itself, not the runtime ref instance.
+ * For the instance type, use `Ref.Ref<T>` from the Ref module.
+ *
+ * @example
+ * ```ts
+ * // Schema type annotation (rarely needed, usually inferred):
+ * const refSchema: Ref.RefSchema<typeof Task> = Ref.Ref(Task);
+ *
+ * // Instance type annotation (use Ref.Ref instead):
+ * const refInstance: Ref.Ref<Task> = Ref.make(task);
+ * ```
+ */
+interface RefSchema<T$1 extends Unknown> extends RefSchema$1<T$1> {}
+/**
+ * Extract reference target.
+ */
+type Target<R$1 extends Unknown$2> = R$1 extends Ref<infer T> ? T : never;
+/**
+ * Reference resolver.
+ */
+type Resolver = RefResolver;
+//#endregion
 //#region ../echo/dist/types/src/internal/Obj/typed-object.d.ts
 /**
  * Definition for an object type that can be stored in an ECHO database.
@@ -9032,7 +8995,7 @@ declare class EchoSchema<A$1 = any, I$1 = any> extends EchoSchema_base implement
    */
   removeFields(fieldNames: string[]): void;
   /**
-   * Wrapper for Obj.change that handles the change context for the persistent schema.
+   * Wrapper for Obj.update that handles the change context for the persistent schema.
    */
   private _change;
   /**
@@ -9153,7 +9116,7 @@ type OfShape<Props$1> = BaseObj & Props$1;
  * NOTE: This is a TypeScript type only, not a schema.
  * To validate that a value is an ECHO object, use `Schema.is(Type.Obj)`.
  */
-interface Unknown$2 extends BaseObj {}
+interface Unknown$1 extends BaseObj {}
 /**
  * Runtime Effect schema for any ECHO object.
  * Use for validation, parsing, or as a reference target for collections.
@@ -9175,70 +9138,176 @@ interface Unknown$2 extends BaseObj {}
  * }).pipe(Type.object({ typename: 'Collection', version: '0.1.0' }));
  * ```
  */
-declare const Unknown$2: Obj$1<Unknown$2>;
+declare const Unknown$1: Obj$1<Unknown$1>;
 /**
  * JSON-encoded properties for objects.
  */
 interface BaseObjJson {
   id: string;
 }
-//#endregion
-//#region ../echo/dist/types/src/Ref.d.ts
+declare namespace Filter_d_exports {
+  export { Any$3 as Any, ChildOfOptions, Filter, KeyFilterOptions, Props, TextSearchOptions, Type$2 as Type, and, between, childOf, contains, created, eq, everything, foreignKeys, fromAst$1 as fromAst, gt, gte, id, in$ as in, is$1 as is, key$1 as key, lt, lte, neq, not, nothing, or, pretty$1 as pretty, props, tag, text, type$2 as type, typeDXN, typename$1 as typename, updated };
+}
+interface Filter<T$1> {
+  '~Filter': {
+    value: Covariant<T$1>;
+  };
+  ast: Filter$1;
+}
+type Props<T$1> = { [K in keyof T$1 & string]?: Filter<T$1[K]> | T$1[K] };
+type Any$3 = Filter<any>;
+type Type$2<F extends Any$3> = F extends Filter<infer T> ? T : never;
+declare class FilterClass implements Any$3 {
+  readonly ast: Filter$1;
+  private static 'variance';
+  constructor(ast: Filter$1);
+  '~Filter': {
+    value: Covariant<any>;
+  };
+}
+declare const is$1: (value: unknown) => value is Any$3;
+/** Construct a filter from an ast. */
+declare const fromAst$1: (ast: Filter$1) => Any$3;
 /**
- * Instance type for a reference.
- *
- * Reference can point to any object or relation.
- * References are lazy loaded.
- *
- * `ref.dxn` is the DXN of the referenced object.
- *
- * @example
- * ```ts
- * const taskRef: Ref<Task> = Ref.make(task);
- *
- * await taskRef.load(); // Returns Promise<Task>
- * yield* Database.load(taskRef); // Effectful version.
- *
- * database.makeRef(dxn); // Create a ref from a DXN.
- * ```
+ * Filter that matches all objects.
  */
-type Ref$1<T$1> = Ref<T$1>;
-type Unknown$1 = Ref<Unknown$2>;
+declare const everything: () => FilterClass;
 /**
- * Factory function to create a Ref schema for the given target schema.
- * Use this in schema definitions to declare reference fields.
- *
- * @example
- * ```ts
- * const Task = Schema.Struct({
- *   assignee: Ref.Ref(Person),  // Creates a Ref schema
- * }).pipe(Type.object({ typename: 'Task', version: '0.1.0' }));
- * ```
+ * Filter that matches no objects.
  */
-declare const Ref$1: <S$1 extends Schema.Any>(schema: S$1) => RefSchema<Schema.Type<S$1>>;
+declare const nothing: () => FilterClass;
+declare const id: (...ids: ObjectId[]) => Any$3;
 /**
- * TypeScript type for a Ref schema.
- * This is the type of the SCHEMA itself, not the runtime ref instance.
- * For the instance type, use `Ref.Ref<T>` from the Ref module.
+ * Filter by type.
+ */
+declare const type$2: <S$1 extends Schema.All>(schema: S$1 | string, props?: Props<Schema.Type<S$1>>) => Filter<Schema.Type<S$1>>;
+/**
+ * Filter by non-qualified typename.
+ */
+declare const typename$1: (typename: string) => Any$3;
+/**
+ * Filter by fully qualified type DXN.
+ */
+declare const typeDXN: (dxn: DXN) => Any$3;
+/**
+ * Filter by tag.
+ */
+declare const tag: (tag: string) => Any$3;
+/**
+ * Options for {@link key} filter.
+ */
+type KeyFilterOptions = {
+  /**
+   * Optional semver range expression (e.g. `^1.2.3`, `~2.0.0`, `>=1.0.0 <2.0.0`).
+   * Matches the object's meta `version` field against the range.
+   * If omitted, matches any version (including objects with no version).
+   */
+  version?: string;
+};
+/**
+ * Filter by registry key stored in object meta.
  *
  * @example
  * ```ts
- * // Schema type annotation (rarely needed, usually inferred):
- * const refSchema: Ref.RefSchema<typeof Task> = Ref.Ref(Task);
- *
- * // Instance type annotation (use Ref.Ref instead):
- * const refInstance: Ref.Ref<Task> = Ref.make(task);
+ * Filter.key('org.example.type.foo');
+ * Filter.key('org.example.type.foo', { version: '^1.2.3' });
  * ```
  */
-interface RefSchema<T$1 extends Unknown> extends RefSchema$1<T$1> {}
+declare const key$1: (key: string, options?: KeyFilterOptions) => Any$3;
 /**
- * Extract reference target.
+ * Filter by properties.
  */
-type Target<R$1 extends Unknown$1> = R$1 extends Ref<infer T> ? T : never;
+declare const props: <T$1>(props: Props<T$1>) => Filter<T$1>;
+type TextSearchOptions = {
+  type?: 'full-text' | 'vector';
+};
 /**
- * Reference resolver.
+ * Full-text or vector search.
  */
-type Resolver = RefResolver;
+declare const text: (text: string, options?: TextSearchOptions) => Any$3;
+/**
+ * Filter by foreign keys.
+ */
+declare const foreignKeys: <S$1 extends Schema.All>(schema: S$1 | string, keys: ForeignKey[]) => Filter<Schema.Type<S$1>>;
+/**
+ * Predicate for property to be equal to the provided value.
+ */
+declare const eq: <T$1>(value: T$1) => Filter<T$1 | undefined>;
+/**
+ * Predicate for property to be not equal to the provided value.
+ */
+declare const neq: <T$1>(value: T$1) => Filter<T$1 | undefined>;
+/**
+ * Predicate for property to be greater than the provided value.
+ */
+declare const gt: <T$1>(value: T$1) => Filter<T$1 | undefined>;
+/**
+ * Predicate for property to be greater than or equal to the provided value.
+ */
+declare const gte: <T$1>(value: T$1) => Filter<T$1 | undefined>;
+/**
+ * Predicate for property to be less than the provided value.
+ */
+declare const lt: <T$1>(value: T$1) => Filter<T$1 | undefined>;
+/**
+ * Predicate for property to be less than or equal to the provided value.
+ */
+declare const lte: <T$1>(value: T$1) => Filter<T$1 | undefined>;
+/**
+ * Predicate for property to be in the provided array.
+ * @param values - Values to check against.
+ */
+declare const in$: <T$1>(...values: T$1[]) => Filter<T$1>;
+/**
+ * Predicate for an array property to contain the provided value.
+ * @param value - Value to check against.
+ */
+declare const contains: <T$1>(value: T$1) => Filter<readonly T$1[] | undefined>;
+/**
+ * Predicate for property to be in the provided range.
+ * @param from - Start of the range (inclusive).
+ * @param to - End of the range (exclusive).
+ */
+declare const between: <T$1>(from: T$1, to: T$1) => Filter<T$1>;
+type TimeRange = {
+  after?: Date | number;
+  before?: Date | number;
+};
+/**
+ * Filter objects by updatedAt timestamp.
+ */
+declare const updated: (range: TimeRange) => Any$3;
+/**
+ * Filter objects by createdAt timestamp.
+ */
+declare const created: (range: TimeRange) => Any$3;
+type ChildOfOptions = {
+  /** Whether to match transitively (grandchildren, etc.). Defaults to true. */
+  transitive?: boolean;
+};
+/**
+ * Filter objects that are children of the specified parent(s).
+ * Accepts ECHO objects, Refs, or arrays of either.
+ * Refs are resolved to DXNs without loading; objects use {@link Obj.getDXN}.
+ * With transitive=true (default), also matches grandchildren and beyond.
+ */
+declare const childOf: (parents: Unknown$1 | Unknown$2 | readonly (Unknown$1 | Unknown$2)[], options?: ChildOfOptions) => Any$3;
+/**
+ * Negate the filter.
+ */
+declare const not: <F extends Any$3>(filter: F) => Filter<Type$2<F>>;
+/**
+ * Combine filters with a logical AND.
+ */
+declare const and: <Filters extends readonly Any$3[]>(...filters: Filters) => Filter<Type$2<Filters[number]>>;
+/**
+ * Combine filters with a logical OR.
+ */
+declare const or: <Filters extends readonly Any$3[]>(...filters: Filters) => Filter<Type$2<Filters[number]>>;
+/**
+ * Returns a human-readable string representation of a Filter AST.
+ */
+declare const pretty$1: (filter: Any$3) => string;
 //#endregion
 //#region ../echo/dist/types/src/JsonSchema.d.ts
 /**
@@ -9413,10 +9482,10 @@ interface RefResolutionContext {
    */
   space?: SpaceId;
   /**
-   * Queue that the resolution is happening from.
-   * This queue will be searched first, and then the space it belongs to.
+   * Feed that the resolution is happening from (as the underlying queue DXN).
+   * This feed will be searched first, and then the space it belongs to.
    */
-  queue?: DXN;
+  feed?: DXN;
 }
 interface RefResolverOptions {
   /**
@@ -9467,7 +9536,7 @@ interface Hypergraph extends Queryable {
  */
 declare const Collection: Obj$1<{
   readonly name?: string | undefined;
-  readonly objects: readonly Ref<OfKind<EntityKind.Object> & Unknown$2>[];
+  readonly objects: readonly Ref<OfKind<EntityKind.Object> & Unknown$1>[];
 }, Struct.Fields>;
 interface Collection extends Schema.Type<typeof Collection> {}
 //#endregion
@@ -9481,8 +9550,8 @@ interface Collection extends Schema.Type<typeof Collection> {}
  * ```
  */
 declare const Feed: Obj$1<{
-  readonly kind?: string | undefined;
   readonly name?: string | undefined;
+  readonly kind?: string | undefined;
   readonly namespace?: "data" | "trace" | undefined;
 }, Struct.Fields>;
 /**
@@ -9497,8 +9566,8 @@ interface Feed extends Schema.Type<typeof Feed> {}
  */
 declare const ViewSchema: Obj$1<{
   readonly query: {
-    readonly ast: QuerySelectClause | QueryFilterClause | QueryReferenceTraversalClause | QueryIncomingReferencesClause | QueryRelationClause | QueryRelationTraversalClause | QueryHierarchyTraversalClause | QueryUnionClause | QuerySetDifferenceClause | QueryOrderClause | QueryOptionsClause | QueryLimitClause | QueryFromClause;
     readonly raw?: string | undefined;
+    readonly ast: QueryFilterClause | QueryFromClause | QueryHierarchyTraversalClause | QueryIncomingReferencesClause | QueryLimitClause | QueryOptionsClause | QueryOrderClause | QueryReferenceTraversalClause | QueryRelationClause | QueryRelationTraversalClause | QuerySelectClause | QuerySetDifferenceClause | QueryUnionClause;
   };
   readonly projection: {
     readonly schema?: JsonSchemaType | undefined;
@@ -9522,12 +9591,12 @@ declare const View: Obj$1<View>;
  * Abstart set of objects, represented by a view, feed, or collection.
  */
 declare const Dataset: Union<[Obj$1<{
-  readonly kind?: string | undefined;
   readonly name?: string | undefined;
+  readonly kind?: string | undefined;
   readonly namespace?: "data" | "trace" | undefined;
 }, Struct.Fields>, Obj$1<{
   readonly name?: string | undefined;
-  readonly objects: readonly Ref<OfKind<EntityKind.Object> & Unknown$2>[];
+  readonly objects: readonly Ref<OfKind<EntityKind.Object> & Unknown$1>[];
 }, Struct.Fields>, Obj$1<View, Struct.Fields>]>;
 type Dataset = Feed | Collection | View;
 declare namespace Order_d_exports {
@@ -9571,7 +9640,7 @@ interface Query<T$1> {
    * @param key - Property path inside T that is a reference or optional reference.
    * @returns Query for the target of the reference.
    */
-  'reference'<K$1 extends RefPropKey<T$1>>(key: K$1): Query<T$1[K$1] extends Unknown$1 ? Target<T$1[K$1]> : T$1[K$1] extends Unknown$1 | undefined ? Target<Exclude<T$1[K$1], undefined>> : never>;
+  'reference'<K$1 extends RefPropKey<T$1>>(key: K$1): Query<T$1[K$1] extends Unknown$2 ? Target<T$1[K$1]> : T$1[K$1] extends Unknown$2 | undefined ? Target<Exclude<T$1[K$1], undefined>> : never>;
   /**
    * Find objects referencing this object.
    * @param target - Schema of the referencing object. If not provided, matches any type.
@@ -9696,6 +9765,10 @@ interface Query<T$1> {
    * Add options to a query.
    */
   'options'(options: QueryOptions): Query<T$1>;
+  /**
+   * Attach a diagnostic label for logs and tooling (execution semantics unchanged).
+   */
+  'debugLabel'(label: string): Query<T$1>;
 }
 type Any$1 = Query<any>;
 type Type$1<Q extends Any$1> = Q extends Query<infer T> ? T : never;
@@ -9740,7 +9813,7 @@ declare const without: <T$1>(source: Query<T$1>, exclude: Query<T$1>) => Query<T
  * @param source - Data source: database, feed, 'all-accessible-spaces', or another query.
  * @returns Query scoped to the given source.
  */
-declare const from: (source: Database | Database[] | Feed | Feed[] | Any$1 | Scope | "all-accessible-spaces", options?: {
+declare const from: (source: Database | Database[] | Feed | Feed[] | Any$1 | Scope | 'all-accessible-spaces', options?: {
   includeFeeds?: boolean;
 }) => Any$1;
 /**
@@ -9757,7 +9830,7 @@ interface QueryFn {
   <F extends Any$3>(filter: F): QueryResult<Type$2<F>>;
 }
 /**
- * Common interface for Database and Queue.
+ * Common interface for Database, Feed, and Hypergraph.
  */
 interface Queryable {
   query: QueryFn;
@@ -9811,7 +9884,7 @@ interface Database extends Queryable {
   /**
    * Return object by local ID.
    */
-  getObjectById<T$1 extends Unknown$2 = OfShape<AnyProperties>>(id: string, opts?: GetObjectByIdOptions): T$1 | undefined;
+  getObjectById<T$1 extends Unknown$1 = OfShape<AnyProperties>>(id: string, opts?: GetObjectByIdOptions): T$1 | undefined;
   /**
    * Query objects.
    */
@@ -9893,13 +9966,13 @@ interface AnyEntity {
 /**
  * String key used to identify the kind of an entity instance (object or relation).
  */
-declare const KindId: "~@dxos/echo/Kind";
+declare const KindId: '~@dxos/echo/Kind';
 type KindId = typeof KindId;
 /**
  * String key used to identify the kind of a schema (object schema or relation schema).
  * Parallels KindId which identifies instance kinds.
  */
-declare const SchemaKindId: "~@dxos/echo/SchemaKind";
+declare const SchemaKindId: '~@dxos/echo/SchemaKind';
 type SchemaKindId = typeof SchemaKindId;
 /**
  * Kinds of entities stored in ECHO: objects and relations.