@sixb/pg 0.2.0 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/README.md +9 -8
  2. package/dist/agents/computers.d.ts +8 -2
  3. package/dist/agents/computers.d.ts.map +1 -1
  4. package/dist/index.js +566 -144
  5. package/dist/index.js.map +20 -17
  6. package/dist/migrations.d.ts.map +1 -1
  7. package/dist/objects/conditional-reader.d.ts +7 -2
  8. package/dist/objects/conditional-reader.d.ts.map +1 -1
  9. package/dist/objects/partitions.d.ts.map +1 -1
  10. package/dist/objects/prepare-queries.d.ts.map +1 -1
  11. package/dist/objects/query-compiler.d.ts +14 -1
  12. package/dist/objects/query-compiler.d.ts.map +1 -1
  13. package/dist/objects/query-indexes.d.ts +13 -1
  14. package/dist/objects/query-indexes.d.ts.map +1 -1
  15. package/dist/objects/read-scope.d.ts.map +1 -1
  16. package/dist/objects/reader.d.ts +14 -1
  17. package/dist/objects/reader.d.ts.map +1 -1
  18. package/dist/objects/storage.d.ts +1 -0
  19. package/dist/objects/storage.d.ts.map +1 -1
  20. package/dist/objects/visibility-indexes.d.ts +22 -0
  21. package/dist/objects/visibility-indexes.d.ts.map +1 -0
  22. package/dist/objects/visibility-statistics.d.ts +26 -0
  23. package/dist/objects/visibility-statistics.d.ts.map +1 -0
  24. package/dist/objects/visibility.d.ts +34 -0
  25. package/dist/objects/visibility.d.ts.map +1 -0
  26. package/dist/pg-client.d.ts.map +1 -1
  27. package/dist/pg-pipeline-run-storage.d.ts.map +1 -1
  28. package/dist/pg-sync-run-storage.d.ts.map +1 -1
  29. package/package.json +3 -3
  30. package/src/agents/computers.ts +54 -5
  31. package/src/migrations/087-agent-computer-background-commands.sql +4 -0
  32. package/src/migrations/088-web-search-model-kind.sql +12 -0
  33. package/src/migrations.ts +6 -0
  34. package/src/objects/conditional-reader.ts +26 -4
  35. package/src/objects/partitions.ts +17 -4
  36. package/src/objects/prepare-queries.ts +8 -3
  37. package/src/objects/query-compiler.ts +64 -23
  38. package/src/objects/query-indexes.ts +93 -27
  39. package/src/objects/read-scope.ts +147 -77
  40. package/src/objects/reader.ts +46 -18
  41. package/src/objects/storage.ts +4 -0
  42. package/src/objects/visibility-indexes.ts +222 -0
  43. package/src/objects/visibility-statistics.ts +73 -0
  44. package/src/objects/visibility.ts +135 -0
  45. package/src/ontology-storage/materializations.ts +3 -1
  46. package/src/pg-client.ts +4 -0
  47. package/src/pg-pipeline-run-storage.ts +5 -7
  48. package/src/pg-sync-run-storage.ts +2 -7
@@ -1 +1 @@
1
- {"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../src/migrations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAGV,YAAY,EACZ,aAAa,EACb,oBAAoB,EACrB,MAAM,oBAAoB,CAAA;AAqH3B,OAAO,KAAK,EAAe,GAAG,EAAa,MAAM,aAAa,CAAA;AAG9D,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACrC;AAED,eAAO,MAAM,2BAA2B,wBAAwB,CAAA;AAEhE,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,wBAAwB,CAAC,CAE1F;AAED,wBAAgB,MAAM,CACpB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC/D,OAAO,GAAE,oBAAyB,GACjC,aAAa,CAAC,wBAAwB,CAAC,CAEzC;AAED,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,GAAG,EACR,UAAU,EAAE,MAAM,GACjB,SAAS,eAAe,EAAE,CAQ5B;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;IACjB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,wBAAwB,CAAC,CAAA;CAC5D,GAAG,eAAe,CAqBlB;AAED,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMxF;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5E;AAED,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAKrD;AAuKD,eAAO,MAAM,yBAAyB,wCA0FpC,CAAA"}
1
+ {"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../src/migrations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAGV,YAAY,EACZ,aAAa,EACb,oBAAoB,EACrB,MAAM,oBAAoB,CAAA;AAqH3B,OAAO,KAAK,EAAe,GAAG,EAAa,MAAM,aAAa,CAAA;AAG9D,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACrC;AAED,eAAO,MAAM,2BAA2B,wBAAwB,CAAA;AAEhE,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,wBAAwB,CAAC,CAE1F;AAED,wBAAgB,MAAM,CACpB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC/D,OAAO,GAAE,oBAAyB,GACjC,aAAa,CAAC,wBAAwB,CAAC,CAEzC;AAED,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,GAAG,EACR,UAAU,EAAE,MAAM,GACjB,SAAS,eAAe,EAAE,CAQ5B;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;IACjB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,wBAAwB,CAAC,CAAA;CAC5D,GAAG,eAAe,CAqBlB;AAED,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMxF;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5E;AAED,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAKrD;AAuKD,eAAO,MAAM,yBAAyB,wCA4FpC,CAAA"}
@@ -1,17 +1,22 @@
1
1
  import type { CompiledConditionalObjectReadScope, ObjectQueryCapabilities, ObjectReadStorage } from "@sixb/core/storage";
2
2
  import { type PgStoreClient } from "../transactions";
3
3
  import type { PgAggregateAdmission } from "./aggregate-admission";
4
+ import type { PgSortIndexCatalog } from "./query-indexes";
5
+ import { type PgVisibilityStatisticsCatalog } from "./visibility-statistics";
4
6
  /**
5
7
  * Read objects and links through relations that apply the scope's conditions as they are read.
6
8
  *
7
- * Reads run as unscoped ones do, under the same aggregate admission: on the pool, and a vector
8
- * query on one repeatable-read snapshot for its candidate probe and its rows.
9
+ * Reads run as unscoped ones do, under the same aggregate admission and over the same sort
10
+ * indexes: on the pool, and a vector query on one repeatable-read snapshot for its candidate probe
11
+ * and its rows.
9
12
  */
10
13
  export declare function createPgConditionalReader(sql: PgStoreClient, params: {
11
14
  projectId: string;
12
15
  scope: CompiledConditionalObjectReadScope;
13
16
  }, options: {
14
17
  aggregateAdmission?: PgAggregateAdmission;
18
+ sortIndexes: PgSortIndexCatalog;
19
+ visibilityStatistics: PgVisibilityStatisticsCatalog;
15
20
  queryCapabilities: () => ObjectQueryCapabilities;
16
21
  }): ObjectReadStorage;
17
22
  //# sourceMappingURL=conditional-reader.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"conditional-reader.d.ts","sourceRoot":"","sources":["../../src/objects/conditional-reader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kCAAkC,EAClC,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,KAAK,aAAa,EAAkC,MAAM,iBAAiB,CAAA;AACpF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAKjE;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE;IACN,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,kCAAkC,CAAA;CAC1C,EACD,OAAO,EAAE;IACP,kBAAkB,CAAC,EAAE,oBAAoB,CAAA;IACzC,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;CACjD,GACA,iBAAiB,CAcnB"}
1
+ {"version":3,"file":"conditional-reader.d.ts","sourceRoot":"","sources":["../../src/objects/conditional-reader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kCAAkC,EAClC,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,KAAK,aAAa,EAAkC,MAAM,iBAAiB,CAAA;AACpF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAIzD,OAAO,EAAE,KAAK,6BAA6B,EAAmB,MAAM,yBAAyB,CAAA;AAE7F;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE;IACN,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,kCAAkC,CAAA;CAC1C,EACD,OAAO,EAAE;IACP,kBAAkB,CAAC,EAAE,oBAAoB,CAAA;IACzC,WAAW,EAAE,kBAAkB,CAAA;IAC/B,oBAAoB,EAAE,6BAA6B,CAAA;IACnD,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;CACjD,GACA,iBAAiB,CA8BnB"}
@@ -1 +1 @@
1
- {"version":3,"file":"partitions.d.ts","sourceRoot":"","sources":["../../src/objects/partitions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAY/C,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,WAAW,EACvB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAsBjB"}
1
+ {"version":3,"file":"partitions.d.ts","sourceRoot":"","sources":["../../src/objects/partitions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAkB/C,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,WAAW,EACvB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CA6BjB"}
@@ -1 +1 @@
1
- {"version":3,"file":"prepare-queries.d.ts","sourceRoot":"","sources":["../../src/objects/prepare-queries.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAA;AAClG,OAAO,KAAK,EAAe,GAAG,EAAa,MAAM,cAAc,CAAA;AAQ/D,mGAAmG;AACnG,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,4BAA4B,CAAC,CAoCvC"}
1
+ {"version":3,"file":"prepare-queries.d.ts","sourceRoot":"","sources":["../../src/objects/prepare-queries.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAA;AAClG,OAAO,KAAK,EAAe,GAAG,EAAa,MAAM,cAAc,CAAA;AAU/D,mGAAmG;AACnG,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,4BAA4B,CAAC,CAoCvC"}
@@ -1,4 +1,5 @@
1
1
  import { type ObjectQuery, type ObjectQueryPredicate, type QueryScalarKind } from "@sixb/core";
2
+ import type { PgSortIndexRead } from "./query-indexes";
2
3
  export interface PgObjectQueryPageRow {
3
4
  object_type_id: string;
4
5
  primary_id: string;
@@ -64,12 +65,24 @@ export declare function compilePgObjectQuery(projectId: string, query: ObjectQue
64
65
  includeTotal?: boolean;
65
66
  source?: PgObjectQuerySource;
66
67
  correlatedTraversal?: boolean;
67
- sortIndexBound?: string;
68
+ sortIndex?: PgSortIndexRead;
69
+ /**
70
+ * Read the objects the query keeps before ordering them, never along an index that orders
71
+ * them: for a reader who sees few objects of the type, a walk would check nearly all of them.
72
+ */
73
+ unorderedStart?: boolean;
68
74
  }): CompiledPgObjectQuery;
69
75
  /** Physical relations used by the PostgreSQL object-query compiler. */
70
76
  export interface PgObjectQuerySource {
71
77
  readonly objectsTable: string;
72
78
  readonly linksTable: string;
79
+ /**
80
+ * The links a statement reads where it already joins both endpoints through `objectsTable`, or
81
+ * only sizes a traversal, when a link's visibility and contents follow from its endpoints alone.
82
+ * Unset, it reads `linksTable`: a selected scope reaches links by path and redacts their
83
+ * properties.
84
+ */
85
+ readonly linksBetweenVisibleObjectsTable?: string;
73
86
  readonly objectPropertyPermissionsTable?: string;
74
87
  /**
75
88
  * Where to read one concrete type's objects, when the source can say it more precisely than
@@ -1 +1 @@
1
- {"version":3,"file":"query-compiler.d.ts","sourceRoot":"","sources":["../../src/objects/query-compiler.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"query-compiler.d.ts","sourceRoot":"","sources":["../../src/objects/query-compiler.ts"],"names":[],"mappings":"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"}
@@ -54,8 +54,20 @@ export declare class PgSortIndexCatalog {
54
54
  indexes(sql: SQLClient): Promise<readonly PgSortIndex[]>;
55
55
  invalidate(): void;
56
56
  }
57
+ /** How an ordered read walks a prepared sort index. */
58
+ export interface PgSortIndexRead {
59
+ /** The type whose objects the index orders. */
60
+ readonly objectTypeId: string;
61
+ /** The rows the index holds; the others are read through its overflow index. */
62
+ readonly bound: string;
63
+ /**
64
+ * Set when the read walks the index backwards: the field's null rank, whose two values are read
65
+ * apart, since null values sort last in both directions.
66
+ */
67
+ readonly nullRank?: string;
68
+ }
57
69
  /** Only split a flat, bounded ordered read; joins, nested limits and projections keep the
58
70
  * general compiler. Its unrestricted fallback always preserves semantics. */
59
- export declare function findPgSortIndexBound(sql: SQLClient, catalog: PgSortIndexCatalog, projectId: string, query: ObjectQuery): Promise<string | undefined>;
71
+ export declare function findPgSortIndexRead(sql: SQLClient, catalog: PgSortIndexCatalog, projectId: string, query: ObjectQuery): Promise<PgSortIndexRead | undefined>;
60
72
  export {};
61
73
  //# sourceMappingURL=query-indexes.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"query-indexes.d.ts","sourceRoot":"","sources":["../../src/objects/query-indexes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAQ/D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,iGAAiG;IACjG,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAA;CAC5E;AAED,MAAM,MAAM,kBAAkB,GAAG,uBAAuB,GACtD,CACI;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS;QACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;QAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;QACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAA;KACtC,EAAE,CAAA;CACJ,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CACtE,CAAA;AAEH,kGAAkG;AAClG,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,GAAG,GAAG,WAAW,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CA4C5B;AAmLD;4EAC4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAW3F;AAED,KAAK,WAAW,GAAG,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAKhE;;;;;;;GAOG;AACH,qBAAa,kBAAkB;;IAG7B,8FAA8F;IAC9F,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC;IAYxD,UAAU,IAAI,IAAI;CAGnB;AA2BD;6EAC6E;AAC7E,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA6E7B"}
1
+ {"version":3,"file":"query-indexes.d.ts","sourceRoot":"","sources":["../../src/objects/query-indexes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAQ/D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,iGAAiG;IACjG,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAA;CAC5E;AAED,MAAM,MAAM,kBAAkB,GAAG,uBAAuB,GACtD,CACI;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS;QACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;QAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;QACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAA;KACtC,EAAE,CAAA;CACJ,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CACtE,CAAA;AAEH,kGAAkG;AAClG,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,GAAG,GAAG,WAAW,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CA4C5B;AAsND;4EAC4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAW3F;AAED,KAAK,WAAW,GAAG,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAKhE;;;;;;;GAOG;AACH,qBAAa,kBAAkB;;IAG7B,8FAA8F;IAC9F,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC;IAYxD,UAAU,IAAI,IAAI;CAGnB;AA2BD,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;6EAC6E;AAC7E,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CA+FtC"}
@@ -1 +1 @@
1
- {"version":3,"file":"read-scope.d.ts","sourceRoot":"","sources":["../../src/objects/read-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kCAAkC,EAClC,+BAA+B,EAChC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAA;AAEzB,MAAM,WAAW,0BAA2B,SAAQ,mBAAmB;IACrE,QAAQ,CAAC,8BAA8B,EAAE,MAAM,CAAA;IAC/C,QAAQ,CAAC,cAAc,EAAE;QACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;QACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;KAClC,CAAA;CACF;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,+BAA+B,EACtC,iBAAiB,EAAE,MAAM,GACxB,0BAA0B,CAgC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,oCAAoC,CAClD,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,kCAAkC,GACxC,mBAAmB,CAgBrB"}
1
+ {"version":3,"file":"read-scope.d.ts","sourceRoot":"","sources":["../../src/objects/read-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kCAAkC,EAClC,+BAA+B,EAChC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAA;AAGzB,MAAM,WAAW,0BAA2B,SAAQ,mBAAmB;IACrE,QAAQ,CAAC,8BAA8B,EAAE,MAAM,CAAA;IAC/C,QAAQ,CAAC,cAAc,EAAE;QACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;QACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;KAClC,CAAA;CACF;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,+BAA+B,EACtC,iBAAiB,EAAE,MAAM,GACxB,0BAA0B,CAiC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,oCAAoC,CAClD,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,kCAAkC,GACxC,mBAAmB,CAsBrB"}
@@ -9,8 +9,21 @@ export declare class PgObjectReader {
9
9
  private readonly sql;
10
10
  private readonly source;
11
11
  private readonly aggregateAdmission?;
12
+ /**
13
+ * Ordered pages walk a prepared sort index when one fits. A selected source takes none: its
14
+ * objects are the ones its paths reach, which no index over a type's rows orders.
15
+ */
12
16
  private readonly sortIndexes?;
13
- constructor(sql: SQLClient, source: PgObjectQuerySource | PgSelectedObjectReadSource, aggregateAdmission?: PgAggregateAdmission | undefined, sortIndexes?: PgSortIndexCatalog | undefined);
17
+ /** Whether the reader sees so few objects of a type that its pages read them before ordering. */
18
+ private readonly readsFewObjects?;
19
+ constructor(sql: SQLClient, source: PgObjectQuerySource | PgSelectedObjectReadSource, aggregateAdmission?: PgAggregateAdmission | undefined,
20
+ /**
21
+ * Ordered pages walk a prepared sort index when one fits. A selected source takes none: its
22
+ * objects are the ones its paths reach, which no index over a type's rows orders.
23
+ */
24
+ sortIndexes?: PgSortIndexCatalog | undefined,
25
+ /** Whether the reader sees so few objects of a type that its pages read them before ordering. */
26
+ readsFewObjects?: ((sql: SQLClient, objectTypeId: string) => Promise<boolean>) | undefined);
14
27
  private assertVectorSearch;
15
28
  queryObjects(params: QueryObjectsInput): Promise<QueryObjectsResult>;
16
29
  /** Use the ordered traversal path only when its bounded probe finds a broad fanout. */
@@ -1 +1 @@
1
- {"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/objects/reader.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/objects/reader.ts"],"names":[],"mappings":"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"}
@@ -7,6 +7,7 @@ export declare class PgObjectStorage implements ObjectStorage {
7
7
  private readonly sortIndexes;
8
8
  private readonly aggregateAdmission?;
9
9
  private readonly reader;
10
+ private readonly visibilityStatistics;
10
11
  constructor(sql: PgStoreClient, sortIndexes?: PgSortIndexCatalog, maxConcurrentAggregates?: number);
11
12
  queryCapabilities(): ObjectQueryCapabilities;
12
13
  createSelectedReadScope(params: {
@@ -1 +1 @@
1
- {"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/objects/storage.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/objects/storage.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ import type { ObjectQueryPreparationPlan, ObjectVisibilityKeys } from "@sixb/core/storage";
2
+ import type { ReservedSQL } from "../pg-client";
3
+ /**
4
+ * Index the keys of every view condition, so a member's read finds the rows it sees instead of
5
+ * checking each one.
6
+ *
7
+ * One GIN index per condition and type, partial on the project and built concurrently, with
8
+ * statistics on its expression so the planner knows how many rows a reader's keys show. A read
9
+ * repeats the indexed expression, so it is served by an index only once it exists, and is right
10
+ * either way. Indexes no condition of the project needs any more are dropped. Runs under the
11
+ * preparation lock, on the connection that holds it.
12
+ */
13
+ export declare function preparePgVisibilityIndexes(connection: ReservedSQL, schema: string, plan: ObjectQueryPreparationPlan): Promise<{
14
+ readonly names: readonly string[];
15
+ readonly warnings: readonly string[];
16
+ }>;
17
+ /**
18
+ * The statistics on a condition's keys. Statistics cannot be partial, so projects sharing a schema
19
+ * share those of one expression.
20
+ */
21
+ export declare function visibilityStatisticsName(objectTypeId: string, keys: ObjectVisibilityKeys): string;
22
+ //# sourceMappingURL=visibility-indexes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"visibility-indexes.d.ts","sourceRoot":"","sources":["../../src/objects/visibility-indexes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC1F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAqB/C;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,WAAW,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC,CAkBtF;AAeD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAGjG"}
@@ -0,0 +1,26 @@
1
+ import type { ObjectReadCondition } from "@sixb/core/storage";
2
+ import type { SQLClient } from "../pg-client";
3
+ /**
4
+ * The keys the statistics of each view condition list as most common, read at most once a minute.
5
+ *
6
+ * ANALYZE lists every key above a small share of the rows. PostgreSQL estimates one it does not
7
+ * list at about half a percent of them, whatever its real share: a reader who sees nothing looks
8
+ * like one who sees thousands of objects.
9
+ */
10
+ export declare class PgVisibilityStatisticsCatalog {
11
+ #private;
12
+ /** Read through the caller's client, so a transaction never waits for a second connection. */
13
+ commonKeys(sql: SQLClient): Promise<ReadonlyMap<string, ReadonlySet<string>>>;
14
+ }
15
+ /**
16
+ * Whether a reader sees so few objects of a type that its ordered pages read the objects it sees
17
+ * first, then sort them.
18
+ *
19
+ * Walking a sort index stops at a page's last object, so it is the right plan for a reader who sees
20
+ * many. For one who sees few, it checks nearly every object, and PostgreSQL cannot tell them apart
21
+ * when the statistics list none of the reader's keys. Such a reader sees few objects: those its
22
+ * keys meet are under the share ANALYZE lists. Without statistics, or with a remainder read object
23
+ * by object, the reader's share is unknown and PostgreSQL chooses.
24
+ */
25
+ export declare function readsFewObjects(condition: ObjectReadCondition, common: ReadonlyMap<string, ReadonlySet<string>>): boolean;
26
+ //# sourceMappingURL=visibility-statistics.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"visibility-statistics.d.ts","sourceRoot":"","sources":["../../src/objects/visibility-statistics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAO7C;;;;;;GAMG;AACH,qBAAa,6BAA6B;;IAQxC,8FAA8F;IAC9F,UAAU,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;CAY9E;AAWD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,mBAAmB,EAC9B,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,GAC/C,OAAO,CAYT"}
@@ -0,0 +1,34 @@
1
+ import type { UserRef } from "@sixb/core";
2
+ import type { ObjectReadCondition, ObjectVisibilityKeys } from "@sixb/core/storage";
3
+ /**
4
+ * Visibility keys as SQL: one expression over `properties` returning who the condition shows the
5
+ * row to, `*` for everyone holding it and `u:<id>` for a user.
6
+ *
7
+ * The expression is IMMUTABLE and holds its values inline, so PostgreSQL can index it and match a
8
+ * read that repeats it, whatever the reader. A user's id is written as jsonb prints it between its
9
+ * quotes: that is how a list's ids come out of `jsonb_path_query_array` with no subquery, which an
10
+ * index expression cannot hold. An escaped quote holds a `"`, so `\\` and `\"` are first written as
11
+ * control characters jsonb never prints raw: `", "` then only separates two ids, and `\x1f` never
12
+ * appears in one. A reader's key is written the same way.
13
+ *
14
+ * A GIN entry holds at most 2,712 bytes, and jsonb prints a character in up to 6 bytes, so ids
15
+ * longer than `MAX_KEYED_ID_LENGTH` characters get no key: a reader with such an id reads the
16
+ * predicate instead. A short list keeps its long ids, which no reader looks up, rather than run a
17
+ * regex on each of its ids.
18
+ *
19
+ * Reads number every `?` of a statement as a parameter, so none is written: text goes in `E''`
20
+ * strings, where `?` is written `\x3f`.
21
+ */
22
+ export declare function compilePgVisibilityKeys(keys: ObjectVisibilityKeys): string;
23
+ /** The keys a reader holds: everyone's, and its user's. */
24
+ export declare function pgVisibilityReaderKeys(user: UserRef | undefined): string[];
25
+ /**
26
+ * A conditioned type's filter: each condition's keys meet the reader's, or the remainder matches.
27
+ * Without keys, or for a user whose id is too long to have one, the condition's predicate.
28
+ */
29
+ export declare function compilePgConditionFilter(condition: ObjectReadCondition): {
30
+ readonly sql: string;
31
+ readonly args: readonly unknown[];
32
+ };
33
+ export declare const MAX_KEYED_ID_LENGTH = 200;
34
+ //# sourceMappingURL=visibility.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../src/objects/visibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAInF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAkC1E;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,EAAE,CAS1E;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,mBAAmB,GAAG;IACxE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;CAClC,CAkBA;AAED,eAAO,MAAM,mBAAmB,MAAM,CAAA"}
@@ -1 +1 @@
1
- {"version":3,"file":"pg-client.d.ts","sourceRoot":"","sources":["../src/pg-client.ts"],"names":[],"mappings":"AAEA,OAAO,QAAQ,MAAM,UAAU,CAAA;AAY/B;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;AAErD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;AAE5D,oGAAoG;AACpG,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;AAErE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;AAE1D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,+FAA+F;IAC/F,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IACnC,mEAAmE;IACnE,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;IACxC,qFAAqF;IACrF,QAAQ,CAAC,qCAAqC,CAAC,EAAE,MAAM,CAAA;IACvD,kEAAkE;IAClE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IACtC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAA;CAC9C;AAQD,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,GAAG,CAsDlE"}
1
+ {"version":3,"file":"pg-client.d.ts","sourceRoot":"","sources":["../src/pg-client.ts"],"names":[],"mappings":"AAEA,OAAO,QAAQ,MAAM,UAAU,CAAA;AAY/B;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;AAErD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;AAE5D,oGAAoG;AACpG,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;AAErE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;AAE1D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,+FAA+F;IAC/F,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IACnC,mEAAmE;IACnE,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;IACxC,qFAAqF;IACrF,QAAQ,CAAC,qCAAqC,CAAC,EAAE,MAAM,CAAA;IACvD,kEAAkE;IAClE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IACtC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAA;CAC9C;AAQD,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,GAAG,CA0DlE"}
@@ -1 +1 @@
1
- {"version":3,"file":"pg-pipeline-run-storage.d.ts","sourceRoot":"","sources":["../src/pg-pipeline-run-storage.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,oBAAoB,CAAA;AAM3B,OAAO,EAAE,KAAK,aAAa,EAAoB,MAAM,gBAAgB,CAAA;AAErE,qBAAa,oBAAqB,YAAW,kBAAkB;IAE3D,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,gBAAgB;IAGzC,KAAK,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAwCvD,0BAA0B;IA8BlC,KAAK,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAqB/D,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAqDjE,SAAS,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAkE3E,UAAU,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAwD7E,OAAO,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IASrF,IAAI,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAmDnE,uBAAuB,CAC3B,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,4BAA4B,CAAC;IAelC,SAAS,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC;CAqDvF"}
1
+ {"version":3,"file":"pg-pipeline-run-storage.d.ts","sourceRoot":"","sources":["../src/pg-pipeline-run-storage.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,oBAAoB,CAAA;AAM3B,OAAO,EAAE,KAAK,aAAa,EAAoB,MAAM,gBAAgB,CAAA;AAErE,qBAAa,oBAAqB,YAAW,kBAAkB;IAE3D,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,gBAAgB;IAGzC,KAAK,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAwCvD,0BAA0B;IA8BlC,KAAK,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAqB/D,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgDjE,SAAS,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAkE3E,UAAU,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAwD7E,OAAO,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IASrF,IAAI,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAmDnE,uBAAuB,CAC3B,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,4BAA4B,CAAC;IAelC,SAAS,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC;CAqDvF"}
@@ -1 +1 @@
1
- {"version":3,"file":"pg-sync-run-storage.d.ts","sourceRoot":"","sources":["../src/pg-sync-run-storage.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACf,MAAM,oBAAoB,CAAA;AAM3B,OAAO,EAAE,KAAK,aAAa,EAAoB,MAAM,gBAAgB,CAAA;AAErE,qBAAa,gBAAiB,YAAW,cAAc;IAEnD,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,gBAAgB;IAGzC,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;YAgD/C,0BAA0B;IAyBlC,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAqBvD,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAoEzD,OAAO,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IASjF,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAwD3D,mBAAmB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAe7F"}
1
+ {"version":3,"file":"pg-sync-run-storage.d.ts","sourceRoot":"","sources":["../src/pg-sync-run-storage.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACf,MAAM,oBAAoB,CAAA;AAM3B,OAAO,EAAE,KAAK,aAAa,EAAoB,MAAM,gBAAgB,CAAA;AAErE,qBAAa,gBAAiB,YAAW,cAAc;IAEnD,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,gBAAgB;IAGzC,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;YAgD/C,0BAA0B;IAyBlC,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAqBvD,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IA+DzD,OAAO,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IASjF,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAwD3D,mBAAmB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAe7F"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sixb/pg",
3
- "version": "0.2.0",
3
+ "version": "0.2.2",
4
4
  "description": "PostgreSQL storage provider for Sixb",
5
5
  "keywords": [
6
6
  "sixb",
@@ -40,10 +40,10 @@
40
40
  "postgres": "^3.4.5"
41
41
  },
42
42
  "peerDependencies": {
43
- "@sixb/core": "0.2.0"
43
+ "@sixb/core": "0.2.2"
44
44
  },
45
45
  "devDependencies": {
46
- "@sixb/core": "0.2.0",
46
+ "@sixb/core": "0.2.2",
47
47
  "@types/bun": "latest",
48
48
  "typescript": "^5.7.0"
49
49
  },
@@ -1,5 +1,11 @@
1
- import { assertAgentComputerSession } from "@sixb/core/internal/agent-run-storage-provider"
1
+ import {
2
+ AGENT_COMPUTER_BACKGROUND_COMMANDS_MAX,
3
+ assertAgentBackgroundCommandRef,
4
+ assertAgentComputerSession,
5
+ } from "@sixb/core/internal/agent-run-storage-provider"
2
6
  import type {
7
+ AgentBackgroundCommandRef,
8
+ AgentComputerBackgroundCommand,
3
9
  AgentComputerSessionRecord,
4
10
  AgentComputerSessionStore,
5
11
  Principal,
@@ -15,30 +21,71 @@ interface AgentComputerSessionRow {
15
21
  computer_name: string
16
22
  folder: string
17
23
  expires_at: Date | string
24
+ background_commands: readonly AgentComputerBackgroundCommand[]
25
+ stop_requests: readonly AgentBackgroundCommandRef[]
18
26
  }
19
27
 
20
28
  export class PgAgentComputerSessionStore implements AgentComputerSessionStore {
21
29
  constructor(private readonly sql: PgStoreClient) {}
22
30
 
23
- async hold(input: AgentComputerSessionRecord): Promise<void> {
31
+ async hold(input: Omit<AgentComputerSessionRecord, "stopRequests">): Promise<void> {
24
32
  assertAgentComputerSession(input, "SixbPg")
33
+ const background = JSON.stringify(input.backgroundCommands ?? [])
25
34
  await this.sql`
26
35
  INSERT INTO agent_computer_sessions (
27
36
  project_id, owner_principal_type, owner_principal_id, id,
28
- computer_id, computer_name, folder, expires_at
37
+ computer_id, computer_name, folder, expires_at, background_commands
29
38
  ) VALUES (
30
39
  ${input.projectId}, ${input.ownerPrincipal.type}, ${input.ownerPrincipal.id}, ${input.id},
31
- ${input.computer.id}, ${input.computer.name}, ${input.computer.folder}, ${input.expiresAt}
40
+ ${input.computer.id}, ${input.computer.name}, ${input.computer.folder}, ${input.expiresAt},
41
+ ${background}::text::jsonb
32
42
  )
33
43
  ON CONFLICT (project_id, owner_principal_type, owner_principal_id, id)
34
44
  DO UPDATE SET
35
45
  computer_id = excluded.computer_id,
36
46
  computer_name = excluded.computer_name,
37
47
  folder = excluded.folder,
38
- expires_at = excluded.expires_at
48
+ expires_at = excluded.expires_at,
49
+ background_commands = excluded.background_commands
39
50
  `
40
51
  }
41
52
 
53
+ async requestStop(input: {
54
+ readonly projectId: string
55
+ readonly id: string
56
+ readonly ownerPrincipal: Principal
57
+ readonly command: AgentBackgroundCommandRef
58
+ }): Promise<AgentComputerSessionRecord | null> {
59
+ assertAgentBackgroundCommandRef(input.command, "SixbPg")
60
+ const { threadId, id, startedAt } = input.command
61
+ const ref = JSON.stringify({ threadId, id, startedAt })
62
+ // Added once, at the end, keeping the newest: in one statement, as two stops may race.
63
+ const [row] = await this.sql<AgentComputerSessionRow[]>`
64
+ UPDATE agent_computer_sessions AS session
65
+ SET stop_requests = (
66
+ SELECT COALESCE(jsonb_agg(kept.value ORDER BY kept.position), '[]'::jsonb)
67
+ FROM (
68
+ SELECT request.value, request.position
69
+ FROM jsonb_array_elements(
70
+ CASE
71
+ WHEN session.stop_requests @> jsonb_build_array(${ref}::text::jsonb)
72
+ THEN session.stop_requests
73
+ ELSE session.stop_requests || jsonb_build_array(${ref}::text::jsonb)
74
+ END
75
+ ) WITH ORDINALITY AS request(value, position)
76
+ ORDER BY request.position DESC
77
+ LIMIT ${AGENT_COMPUTER_BACKGROUND_COMMANDS_MAX}
78
+ ) AS kept
79
+ )
80
+ WHERE project_id = ${input.projectId}
81
+ AND owner_principal_type = ${input.ownerPrincipal.type}
82
+ AND owner_principal_id = ${input.ownerPrincipal.id}
83
+ AND id = ${input.id}
84
+ RETURNING *
85
+ `
86
+ return row ? rowToSession(row) : null
87
+ }
88
+
42
89
  async release(input: {
43
90
  readonly projectId: string
44
91
  readonly id: string
@@ -91,5 +138,7 @@ function rowToSession(row: AgentComputerSessionRow): AgentComputerSessionRecord
91
138
  ownerPrincipal: { type: row.owner_principal_type, id: row.owner_principal_id },
92
139
  computer: { id: row.computer_id, name: row.computer_name, folder: row.folder },
93
140
  expiresAt: new Date(row.expires_at),
141
+ ...(row.background_commands.length > 0 ? { backgroundCommands: row.background_commands } : {}),
142
+ ...(row.stop_requests.length > 0 ? { stopRequests: row.stop_requests } : {}),
94
143
  }
95
144
  }
@@ -0,0 +1,4 @@
1
+ -- What each open sixb reports of its threads' background commands, which outlive the turn that
2
+ -- started them, and the ones someone asked to stop from the web: its renewals hand those back.
3
+ ALTER TABLE agent_computer_sessions ADD COLUMN background_commands JSONB NOT NULL DEFAULT '[]';
4
+ ALTER TABLE agent_computer_sessions ADD COLUMN stop_requests JSONB NOT NULL DEFAULT '[]';
@@ -0,0 +1,12 @@
1
+ ALTER TABLE ai_model_call_usage
2
+ DROP CONSTRAINT ai_model_call_usage_model_kind_check;
3
+
4
+ ALTER TABLE ai_model_call_usage
5
+ ADD CONSTRAINT ai_model_call_usage_model_kind_check
6
+ CHECK (
7
+ model_kind IS NULL
8
+ OR model_kind IN (
9
+ 'language', 'image', 'video', 'embedding', 'decision', 'transcription', 'speech', 'reranking',
10
+ 'web-search'
11
+ )
12
+ );
package/src/migrations.ts CHANGED
@@ -457,6 +457,8 @@ export const postgresStorageMigrations = defineMigrations<PostgresMigrationConte
457
457
  pgSql("084-agent-token-rates", agentTokenRatesSql),
458
458
  pgSql("085-agent-computer-sessions", agentComputerSessionsSql),
459
459
  pgSql("086-partition-objects", partitionObjectsSql),
460
+ pgSql("087-agent-computer-background-commands", agentComputerBackgroundCommandsSql),
461
+ pgSql("088-web-search-model-kind", webSearchModelKindSql),
460
462
  ],
461
463
  })
462
464
 
@@ -529,3 +531,7 @@ import agentComputerSessionsSql from "./migrations/085-agent-computer-sessions.s
529
531
  type: "text",
530
532
  }
531
533
  import partitionObjectsSql from "./migrations/086-partition-objects.sql" with { type: "text" }
534
+ import agentComputerBackgroundCommandsSql from "./migrations/087-agent-computer-background-commands.sql" with {
535
+ type: "text",
536
+ }
537
+ import webSearchModelKindSql from "./migrations/088-web-search-model-kind.sql" with { type: "text" }
@@ -5,17 +5,21 @@ import type {
5
5
  ObjectQueryCapabilities,
6
6
  ObjectReadStorage,
7
7
  } from "@sixb/core/storage"
8
+ import type { SQLClient } from "../pg-client"
8
9
  import { type PgStoreClient, runPgRepeatableReadTransaction } from "../transactions"
9
10
  import type { PgAggregateAdmission } from "./aggregate-admission"
11
+ import type { PgSortIndexCatalog } from "./query-indexes"
10
12
  import { compilePgConditionalObjectReadSource } from "./read-scope"
11
13
  import { PgObjectReader } from "./reader"
12
14
  import { createPgScopedReader } from "./scoped-reader"
15
+ import { type PgVisibilityStatisticsCatalog, readsFewObjects } from "./visibility-statistics"
13
16
 
14
17
  /**
15
18
  * Read objects and links through relations that apply the scope's conditions as they are read.
16
19
  *
17
- * Reads run as unscoped ones do, under the same aggregate admission: on the pool, and a vector
18
- * query on one repeatable-read snapshot for its candidate probe and its rows.
20
+ * Reads run as unscoped ones do, under the same aggregate admission and over the same sort
21
+ * indexes: on the pool, and a vector query on one repeatable-read snapshot for its candidate probe
22
+ * and its rows.
19
23
  */
20
24
  export function createPgConditionalReader(
21
25
  sql: PgStoreClient,
@@ -25,18 +29,36 @@ export function createPgConditionalReader(
25
29
  },
26
30
  options: {
27
31
  aggregateAdmission?: PgAggregateAdmission
32
+ sortIndexes: PgSortIndexCatalog
33
+ visibilityStatistics: PgVisibilityStatisticsCatalog
28
34
  queryCapabilities: () => ObjectQueryCapabilities
29
35
  }
30
36
  ): ObjectReadStorage {
31
37
  const source = compilePgConditionalObjectReadSource(params.projectId, params.scope)
32
- const reader = new PgObjectReader(sql, source, options.aggregateAdmission)
38
+
39
+ const fewObjects = async (client: SQLClient, objectTypeId: string) => {
40
+ const condition = params.scope.conditions.find((item) => item.objectTypeId === objectTypeId)
41
+ if (!condition) return false
42
+
43
+ return readsFewObjects(condition, await options.visibilityStatistics.commonKeys(client))
44
+ }
45
+
46
+ const reader = new PgObjectReader(
47
+ sql,
48
+ source,
49
+ options.aggregateAdmission,
50
+ options.sortIndexes,
51
+ fewObjects
52
+ )
33
53
 
34
54
  return createPgScopedReader(
35
55
  {
36
56
  projectId: params.projectId,
37
57
  read: (run, query?: ObjectQuery) =>
38
58
  query && hasVectorProfile(query)
39
- ? runPgRepeatableReadTransaction(sql, (tx) => run(new PgObjectReader(tx, source)))
59
+ ? runPgRepeatableReadTransaction(sql, (tx) =>
60
+ run(new PgObjectReader(tx, source, undefined, options.sortIndexes, fewObjects))
61
+ )
40
62
  : run(reader),
41
63
  },
42
64
  options.queryCapabilities
@@ -11,6 +11,12 @@ const LOCK_TIMEOUT = "1s"
11
11
  const LOCK_ATTEMPTS = 120
12
12
  const LOCK_RETRY_MS = 1_000
13
13
 
14
+ // Autovacuum analyzes a partition once 50 rows plus 2% of it changed, instead of 10%. A value the
15
+ // statistics have never seen is estimated at a row or two: once 5% of a 30,000-row type held one,
16
+ // a read planned on that took 6 s instead of 75 ms (at 4% it was still fine). ANALYZE samples at
17
+ // most 30,000 rows, so on any large partition it takes about half a second to a second.
18
+ const ANALYZE_SCALE_FACTOR = "autovacuum_analyze_scale_factor=0.02"
19
+
14
20
  /** Migration 086 derives the same name in SQL: `'objects_' || left(md5(type), 24)`. */
15
21
  export function objectPartitionName(objectTypeId: string): string {
16
22
  return `objects_${createHash("md5").update(objectTypeId).digest("hex").slice(0, 24)}`
@@ -28,9 +34,16 @@ export async function ensureObjectPartition(
28
34
  ): Promise<string> {
29
35
  const name = objectPartitionName(objectTypeId)
30
36
  const partition = `${identifier(schema)}.${identifier(name)}`
31
- const [existing] = await connection<{ found: string | null }[]>`
32
- SELECT to_regclass(${partition})::text AS found`
33
- if (existing?.found) return name
37
+ const [existing] = await connection<{ tuned: boolean }[]>`
38
+ SELECT coalesce(reloptions, '{}') @> ARRAY[${ANALYZE_SCALE_FACTOR}] AS tuned
39
+ FROM pg_class WHERE oid = to_regclass(${partition})`
40
+ if (existing) {
41
+ // Partitions created without it, such as migration 086's, take it on their next preparation.
42
+ if (!existing.tuned) {
43
+ await connection.unsafe(`ALTER TABLE ${partition} SET (${ANALYZE_SCALE_FACTOR})`)
44
+ }
45
+ return name
46
+ }
34
47
 
35
48
  for (let attempt = 1; ; attempt++) {
36
49
  try {
@@ -100,7 +113,7 @@ async function createObjectPartition(
100
113
  }
101
114
 
102
115
  await connection.unsafe(
103
- `CREATE TABLE ${partition} (LIKE ${parent} INCLUDING DEFAULTS INCLUDING GENERATED INCLUDING CONSTRAINTS INCLUDING STORAGE)`
116
+ `CREATE TABLE ${partition} (LIKE ${parent} INCLUDING DEFAULTS INCLUDING GENERATED INCLUDING CONSTRAINTS INCLUDING STORAGE) WITH (${ANALYZE_SCALE_FACTOR})`
104
117
  )
105
118
  if (moving) await moveRowsFromDefault(connection, parent, fallback, partition, type, references)
106
119
  await connection.unsafe(