@spine-event-engine/storage-postgres 2.0.0-snapshot.24 → 2.0.0-snapshot.25

package/README.md

@@ -1,5 +1,8 @@
 # PostgreSQL storage for Spine TS
 
+See [storage layout and database preparation](https://github.com/SpineEventEngine/spine-ts/blob/master/docs/STORAGE_LAYOUT.md) for
+physical structures, tenant placement, prerequisites, and customization.
+
 `@spine-event-engine/storage-postgres` stores Spine TS records in PostgreSQL.
 It is a separate provider package; the existing `storage-mysql` package remains
 the MySQL provider. PostgreSQL support currently targets PostgreSQL 16 or newer,
@@ -8,9 +11,10 @@ with live acceptance recorded against PostgreSQL 16.15 and 18.6.
 This is an experimental snapshot package. Use Node 24 or newer. For the precise
 public API and operational rules, see the [coding-agent reference](REFERENCE.md).
 
-Agent repositories can use this factory to retain accepted work and conversation
-history across restarts. Their state and execution completion are saved together
-in PostgreSQL; a model call does not keep a database transaction open.
+Agent repositories can use this factory to retain state, typed admission receipts,
+and conversation history across restarts. An interrupted Agent handler does not
+restart from those records. Atomic live Agent commits save accepted state and
+audit together; a model call does not keep a database transaction open.
 
 ## Install
 
@@ -47,27 +51,40 @@ try {
   if (stored?.value !== "task-42") throw new Error("The record was not stored.");
 } finally {
   records.close();
-  factory.close();
+  await factory.close();
 }
 ```
 
 The URL must include a database name. Use `postgres:` or `postgresql:` URLs;
 credentials should come from the deployment environment. TLS options, pool
 limits, connection timeout, and an explicit schema are configured through the
-factory options. When no schema is supplied, the factory resolves
-`current_schema()` once and uses that validated schema for all later operations.
-
-For multitenancy, configure one database and pool per complete generated
-`TenantId`. A schema is not a substitute for the database boundary. Duplicate
-tenant or database targets are rejected during construction.
+factory options. Building the factory and creating a record handle do not open
+a connection. Call `await factory.checkConnection()` for a read-only check of
+the shared database; it opens and closes a temporary pool unless normal storage
+use already opened one. When no schema is supplied, the first awaited use
+resolves the server's `current_schema()` and retains that schema for later use.
+
+For multitenancy, set the shared database with `setOptions()` and select tenant
+databases with `setTenantOptions()` or `setTenantResolver()`. The resolver may be
+asynchronous and is called only on first use of a tenant. Distinct tenants must
+resolve to distinct databases; a schema is not a substitute for that boundary.
+The shared database may coincide with a tenant database only when their record
+families do not map to the same physical table.
 
 ## Lifecycle and operations
 
 Tables are initialized lazily and checked against the expected PostgreSQL
-layout. Each acquired client is released; history maintenance applies deletion
-pages independently. Call `factory.close()` when the application stops; it is
-idempotent and drains live handles and pools. A closed factory cannot create new
-handles.
+layout. Provider integrations can prepare declared record, Entity current and
+enabled history, and Agent audit families through
+`StoragePreparations.for(factory)`. Creation verifies the resulting layout;
+check mode only inspects existing tables and audit indexes, and a compatible
+check avoids later creation SQL for the same family. Explicit preparation uses
+and releases a temporary pool when no runtime pool exists; otherwise it reuses
+the retained runtime pool. Each acquired
+client is released; history maintenance applies deletion
+pages independently. Await `factory.close()` when the application stops; it is
+idempotent, drains admitted work and pools, and reports cleanup failures. A
+closed factory cannot create new handles or check a connection.
 
 The provider supports record CRUD, compare-and-set, immutable append, Entity
 state and event history, declared-column filtering, sorting, limits, offsets,

package/REFERENCE.md

@@ -6,7 +6,7 @@ agents.
 ## Public entry point
 
 Import `PostgresStorageFactory`, `PostgresStorageFactoryBuilder`,
-`PostgresStorageFactoryOptions`, `PostgresTenantStorageOptions`,
+`PostgresStorageFactoryOptions`, `PostgresTenantStorageOptions`, `PostgresTenantResolver`,
 `PostgresEntityStorageHandle`, `PostgresTableSpec`,
 `PostgresCreateOperation`, `PostgresCreateOperationFactory`, and
 `PostgresColumnSpec` from the package root. Provider errors are
@@ -16,19 +16,37 @@ Import `PostgresStorageFactory`, `PostgresStorageFactoryBuilder`,
 
 ## Configuration
 
-`PostgresStorageFactory.newBuilder().setOptions(options).build()` configures a
-single database and schema. `setTenantOptions(entries)` configures one database
-and pool per complete generated `TenantId`; every operation selects its tenant
-pool before table, metadata, transaction, lock, or data work. Options include a
+`PostgresStorageFactory.newBuilder().setOptions(options).build()` assembles a
+logical factory without connecting. Shared `setOptions()` is required;
+`setTenantOptions(entries)` or `setTenantResolver(resolver)` additionally selects
+one database per complete generated `TenantId`. The two tenant selection modes
+cannot be combined. A resolver may return options asynchronously; concurrent
+first uses of one tenant share resolution, failed attempts may retry, and a
+successful binding stays fixed for this factory. Options include a
 PostgreSQL URL, pool maximum, connection timeout, TLS CA/certificate/key,
 server-certificate verification, and optional schema name. URLs must include a
 database and cannot bypass the explicit options model with fragments or driver
-parameters. The factory proves configured connections during build and
-sanitizes provider errors.
+parameters. `checkConnection()` checks only the shared destination using
+read-only SQL; it does not resolve tenants, create tables, or check a model.
+Provider integrations can use `StoragePreparations.for(factory)` to create or
+check a declared Record, Entity current/enabled history, or surviving Agent
+audit family. Check mode inspects the selected tenant's actual schema, table,
+and required audit indexes without DDL or custom creation SQL. A successful
+compatible preparation is reused by later handles and operations in this
+factory. Explicit preparation uses and releases a temporary pool when no runtime
+pool exists; otherwise it reuses the retained runtime pool. Failed requirements
+can be retried without discarding
+earlier compatible families.
+
+The default shared registry converts message-valued IDs and columns using
+generated descriptors registered on module import. A registry supplied with
+`setStringifierRegistry(registry)` is snapshotted at factory construction.
+`setEventStoreTable(contextName, table, role?)` selects one physical Event Store
+table for the exact bounded-context name and domain or system role.
 
 PostgreSQL creates tables but not databases or schemas. A missing schema is a
-configuration error. Without an explicit schema, `current_schema()` is resolved
-once while building the target and the validated result is qualified into every
+configuration error on `checkConnection()` or first use. Without an explicit schema, `current_schema()`
+is resolved from the server on first use and the validated result qualifies every
 table and metadata statement.
 
 ## Physical layout and queries
@@ -96,23 +114,23 @@ B-tree entry limits still apply to exceptionally long record IDs. Pages use
 bounded SQL chunks and sum serialized entry bytes; a fetched chunk can be
 larger than the returned byte budget.
 
-## Agent execution
+## Agent live persistence
 
-Agent execution records and per-instance pending entries are stored in separate
-tenant database tables. Indexed queries select the next eligible instance and
-the first unresolved signal within it. Required B-tree indexes use complete
-binary-comparable ordering keys and are checked before admission.
-
-Claims, history updates and conditional Entity completion use the same native
-transaction connection. Completion compares the original Entity Version before
-writing the resulting state, history, preferences and outgoing Commands. Reopening
-a factory can read the saved work. No database transaction remains open while a
-model request runs.
+Agent audit entries use the indexed tenant-scoped `agent_history` family above.
+`appendAll()` writes the complete immutable group in one PostgreSQL transaction.
+Live Agent completion uses `EntityCommitStorage.commitAgent()` to compare the
+exact Entity state image and model preferences, and to commit state, preference,
+and history changes atomically. A no-op or preference-only turn does not need a
+new Entity Version. The typed admission receipt is a separate record family;
+it is not a replayable execution record. No database transaction remains open
+while a model request runs. Factory shutdown drains admitted operations before
+closing their retained connections.
 
 ## Lifecycle and errors
 
-`factory.close()` is idempotent, closes registered handles, prevents new handle
-creation, and drains pools. Record and Entity handles can close independently.
+Await `factory.close()` to observe cleanup failures. It synchronously prevents new handle
+creation, waits for admitted Entity commits, then closes registered handles and pools.
+Repeated calls return the same completion. Record and Entity handles can close independently.
 Acquired clients are released in `finally` blocks. History maintenance applies
 each deletion page independently. Top-level provider error messages and public
 responses omit URLs, credentials, SQL text, and driver details. The original

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { PostgresStorageFactory, type PostgresCreateOperation, type PostgresCreateOperationFactory, type PostgresColumnSpec, type PostgresStorageFactoryBuilder, type PostgresStorageFactoryOptions, type PostgresTableSpec, type PostgresTenantStorageOptions, } from "./postgres/storage-factory.js";
+export { PostgresStorageFactory, type PostgresCreateOperation, type PostgresCreateOperationFactory, type PostgresColumnSpec, type PostgresStorageFactoryBuilder, type PostgresStorageFactoryOptions, type PostgresTableSpec, type PostgresTenantStorageOptions, type PostgresTenantResolver, } from "./postgres/storage-factory.js";
 export type { PostgresDdlType } from "./postgres/data-type.js";
 export { PostgresStorageConfigurationError, PostgresStorageConnectionError, PostgresStorageDataError, PostgresStorageOperationError, PostgresStorageSchemaError, } from "./postgres/errors.js";
 export type { PostgresEntityStorageHandle } from "./postgres/entity-history.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,sBAAsB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,KAAK,kBAAkB,EACvB,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EAClC,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,GAClC,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EACL,iCAAiC,EACjC,8BAA8B,EAC9B,wBAAwB,EACxB,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,sBAAsB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,KAAK,kBAAkB,EACvB,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EAClC,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,GAC5B,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EACL,iCAAiC,EACjC,8BAA8B,EAC9B,wBAAwB,EACxB,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,sBAAsB,GAQvB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EACL,iCAAiC,EACjC,8BAA8B,EAC9B,wBAAwB,EACxB,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,sBAAsB,GASvB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EACL,iCAAiC,EACjC,8BAA8B,EAC9B,wBAAwB,EACxB,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC"}

package/dist/postgres/agent-history.d.ts

@@ -1,7 +1,9 @@
 import type { AgentHistoryEntry } from "@spine-event-engine/proto/agent";
-import type { AgentHistoryRecord } from "@spine-event-engine/proto/generated/spine/server/agent/history_record_pb.js";
-import { type AgentHistoryPage, type AgentHistoryRead, type AgentHistoryStorage, type AgentHistoryStorageInput } from "@spine-event-engine/storage/provider";
-import { PostgresRecordStorage } from "./record-storage.js";
+import { type AgentHistoryRecord } from "@spine-event-engine/proto/generated/spine/server/agent/history_record_pb.js";
+import { type AgentHistoryPage, type AgentHistoryCapacity, type AgentHistoryRead, type AgentHistoryStorage, type AgentHistoryStorageInput } from "@spine-event-engine/storage/provider";
+import type { StoragePreparationMode } from "@spine-event-engine/storage/provider";
+import type { PoolClient } from "pg";
+import { PostgresRecordStorage, type OnPublicOperation } from "./record-storage.js";
 /**
  * Hashes complete identities into bounded physical IDs and indexed scope keys.
  */
@@ -23,13 +25,21 @@ export declare class PostgresAgentHistory<Id> implements AgentHistoryStorage<Id>
     #private;
     private readonly input;
     private readonly records;
+    private readonly onAdmit;
+    private readonly onPrepare?;
+    /**
+     * Native PostgreSQL Agent history capacity declaration.
+     */
+    readonly capacity: AgentHistoryCapacity;
     /**
      * Binds one typed Agent repository to the provider record handle.
      *
      * @param input Repository and complete tenant scope.
      * @param records Native record-family storage.
+     * @param onAdmit Admits complete public Agent-history operations.
+     * @param onPrepare Optionally uses factory-shared index readiness.
      */
-    constructor(input: AgentHistoryStorageInput<Id>, records: PostgresRecordStorage<string, AgentHistoryRecord>);
+    constructor(input: AgentHistoryStorageInput<Id>, records: PostgresRecordStorage<string, AgentHistoryRecord>, onAdmit: OnPublicOperation, onPrepare?: ((mode: StoragePreparationMode) => Promise<void>) | undefined);
     /**
      * Writes one original entry or confirms byte-identical content.
      *
@@ -38,6 +48,21 @@ export declare class PostgresAgentHistory<Id> implements AgentHistoryStorage<Id>
      * @returns Completion after immutable storage confirms the entry.
      */
     append(entityId: Id, entry: AgentHistoryEntry): Promise<void>;
+    /**
+     * Writes atomically writes one captured immutable Agent audit group.
+     * @param entityId Typed Agent identifier.
+     * @param entries Complete history rows.
+     * @returns Completion after the group commits.
+     */
+    appendAll(entityId: Id, entries: readonly AgentHistoryEntry[]): Promise<void>;
+    /**
+     * Writes an admitted immutable group on one rollback-capable transaction.
+     *
+     * @param entityId Typed Entity identifier.
+     * @param entries Complete immutable history group.
+     * @returns Completion after the complete immutable audit group commits atomically.
+     */
+    private appendAllAdmitted;
     /**
      * Reads a bounded indexed page in full Timestamp/category/UTF-8 order.
      *
@@ -46,9 +71,13 @@ export declare class PostgresAgentHistory<Id> implements AgentHistoryStorage<Id>
      */
     read(request: AgentHistoryRead<Id>): Promise<AgentHistoryPage>;
     /**
-  
+     * Reads an admitted Agent-history page.
+     * @param request Typed Agent view and continuation limits.
+     * @returns Original entries and continuation status.
+     */
+    private readAdmitted;
+    /**
      * Closes this handle without deleting stored records.
-  
      */
     close(): void;
     /**
@@ -63,16 +92,6 @@ export declare class PostgresAgentHistory<Id> implements AgentHistoryStorage<Id>
      * @returns Completion after all three definitions are validated.
      */
     private initialize;
-    /**
-     * Rejects an existing same-name index with incomplete columns or collation.
-     *
-     * @param client Acquired PostgreSQL client.
-     * @param table Validated physical table name.
-     * @param name Fixed required index name.
-     * @param columns Required complete binary-order columns.
-     * @returns Completion after the index definition is checked.
-     */
-    private ensureIndex;
     /**
      * Reads a bounded native page with complete scope and view predicates.
      *
@@ -105,10 +124,33 @@ export declare class PostgresAgentHistory<Id> implements AgentHistoryStorage<Id>
      */
     private key;
     /**
-  
      * Rejects calls after this handle closes.
-  
      */
     private requireOpen;
 }
+/**
+ * Verifies the fixed Agent audit indexes without changing a checked database.
+ */
+export declare const PostgresAgentIndexes: {
+    /**
+     * Prepares each required Agent audit index.
+     *
+     * @param client Acquired client.
+     * @param table Qualified audit table.
+     * @param mode Preparation mode.
+     * @returns Completion after all three indexes match.
+     */
+    prepare(client: PoolClient, table: string, mode: StoragePreparationMode): Promise<void>;
+    /**
+     * Validates one fixed index and creates it only in create mode.
+     *
+     * @param client Acquired client.
+     * @param table Qualified audit table.
+     * @param name Fixed index name.
+     * @param columns Required columns.
+     * @param mode Preparation mode.
+     * @returns Completion after exact index validation.
+     */
+    ensure(client: PoolClient, table: string, name: string, columns: string, mode: StoragePreparationMode): Promise<void>;
+};
 //# sourceMappingURL=agent-history.d.ts.map

package/dist/postgres/agent-history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-history.d.ts","sourceRoot":"","sources":["../../src/postgres/agent-history.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6EAA6E,CAAC;AACtH,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC9B,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;;;;OAKG;iBACU,MAAM,GAAG,MAAM;CAG7B,CAAC;AAEF;;;;GAIG;AACH,qBAAa,oBAAoB,CAAC,EAAE,CAAE,YAAW,mBAAmB,CAAC,EAAE,CAAC;;IAoBpE,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR1B;;;;;OAKG;gBAEgB,KAAK,EAAE,wBAAwB,CAAC,EAAE,CAAC,EACnC,OAAO,EAAE,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAG7E;;;;;;OAMG;IACG,MAAM,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnE;;;;;OAKG;IACG,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAYpE;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAMb;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAIb;;;;OAIG;YACW,UAAU;IA0BxB;;;;;;;;OAQG;YACW,WAAW;IA6BzB;;;;;;;;OAQG;YACW,KAAK;IAyBnB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAkBrB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAQpB;;;;;OAKG;IACH,OAAO,CAAC,GAAG;IAMX;;;;OAIG;IACH,OAAO,CAAC,WAAW;CAGpB"}
+{"version":3,"file":"agent-history.d.ts","sourceRoot":"","sources":["../../src/postgres/agent-history.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,6EAA6E,CAAC;AACrF,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC9B,MAAM,sCAAsC,CAAC;AAE9C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAErC,OAAO,EAAE,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGpF;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;;;;OAKG;iBACU,MAAM,GAAG,MAAM;CAG7B,CAAC;AAEF;;;;GAIG;AACH,qBAAa,oBAAoB,CAAC,EAAE,CAAE,YAAW,mBAAmB,CAAC,EAAE,CAAC;;IAyBpE,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IA3B7B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAqB;IAY5D;;;;;;;OAOG;gBAEgB,KAAK,EAAE,wBAAwB,CAAC,EAAE,CAAC,EACnC,OAAO,EAAE,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAC1D,OAAO,EAAE,iBAAiB,EAC1B,SAAS,CAAC,GAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,aAAA;IAG9E;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,iBAAiB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7E;;;;;;OAMG;YACW,iBAAiB;IAiB/B;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI9D;;;;OAIG;YACW,YAAY;IAY1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAOb;;;;OAIG;YACW,UAAU;IAmBxB;;;;;;;;OAQG;YACW,KAAK;IAyBnB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAkBrB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAQpB;;;;;OAKG;IACH,OAAO,CAAC,GAAG;IAMX;;OAEG;IACH,OAAO,CAAC,WAAW;CAGpB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;;;;;;OAOG;oBACmB,UAAU,SAAS,MAAM,QAAQ,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7F;;;;;;;;;OASG;mBAEO,UAAU,SACX,MAAM,QACP,MAAM,WACH,MAAM,QACT,sBAAsB,GAC3B,OAAO,CAAC,IAAI,CAAC;CAwBjB,CAAC"}

package/dist/postgres/agent-history.js

@@ -12,9 +12,12 @@
  * the License.
  */
 import { createHash } from "node:crypto";
+import { clone } from "@bufbuild/protobuf";
+import { AgentHistoryRecordSchema, } from "@spine-event-engine/proto/generated/spine/server/agent/history_record_pb.js";
 import { AgentHistoryKeys, AgentHistoryPages, } from "@spine-event-engine/storage/provider";
 import { AgentHistoryRecords } from "@spine-event-engine/storage/provider";
 import { PostgresRecordStorage } from "./record-storage.js";
+import { PostgresStorageOperationError } from "./errors.js";
 /**
  * Hashes complete identities into bounded physical IDs and indexed scope keys.
  */
@@ -37,14 +40,18 @@ export const AgentHistoryHash = {
 export class PostgresAgentHistory {
     input;
     records;
+    onAdmit;
+    onPrepare;
+    /**
+     * Native PostgreSQL Agent history capacity declaration.
+     */
+    capacity = Object.freeze({});
     /**
      * Records whether this handle accepts calls.
      */
     #open = true;
     /**
-  
      * Reuses one table and index preparation promise.
-  
      */
     #ready;
     /**
@@ -52,10 +59,14 @@ export class PostgresAgentHistory {
      *
      * @param input Repository and complete tenant scope.
      * @param records Native record-family storage.
+     * @param onAdmit Admits complete public Agent-history operations.
+     * @param onPrepare Optionally uses factory-shared index readiness.
      */
-    constructor(input, records) {
+    constructor(input, records, onAdmit, onPrepare) {
         this.input = input;
         this.records = records;
+        this.onAdmit = onAdmit;
+        this.onPrepare = onPrepare;
     }
     /**
      * Writes one original entry or confirms byte-identical content.
@@ -64,10 +75,37 @@ export class PostgresAgentHistory {
      * @param entry Complete history entry.
      * @returns Completion after immutable storage confirms the entry.
      */
-    async append(entityId, entry) {
+    append(entityId, entry) {
+        return this.appendAll(entityId, [entry]);
+    }
+    /**
+     * Writes atomically writes one captured immutable Agent audit group.
+     * @param entityId Typed Agent identifier.
+     * @param entries Complete history rows.
+     * @returns Completion after the group commits.
+     */
+    appendAll(entityId, entries) {
+        return this.onAdmit(() => this.appendAllAdmitted(entityId, entries));
+    }
+    /**
+     * Writes an admitted immutable group on one rollback-capable transaction.
+     *
+     * @param entityId Typed Entity identifier.
+     * @param entries Complete immutable history group.
+     * @returns Completion after the complete immutable audit group commits atomically.
+     */
+    async appendAllAdmitted(entityId, entries) {
         this.requireOpen();
+        const key = this.key(entityId);
+        const records = entries.map((entry) => clone(AgentHistoryRecordSchema, AgentHistoryRecords.record(this.input.stateType, key, entry)));
+        if (records.length === 0)
+            return;
         await this.ready();
-        await this.records.writeImmutable(AgentHistoryRecords.record(this.input.stateType, this.key(entityId), entry));
+        const executor = this.records.historyExecutor();
+        await executor.transaction(async (client) => {
+            for (const record of records)
+                await executor.appendImmutable(client, record);
+        });
     }
     /**
      * Reads a bounded indexed page in full Timestamp/category/UTF-8 order.
@@ -75,7 +113,15 @@ export class PostgresAgentHistory {
      * @param request Typed Agent, view, continuation, and response limits.
      * @returns Original entries and continuation status.
      */
-    async read(request) {
+    read(request) {
+        return this.onAdmit(() => this.readAdmitted(request));
+    }
+    /**
+     * Reads an admitted Agent-history page.
+     * @param request Typed Agent view and continuation limits.
+     * @returns Original entries and continuation status.
+     */
+    async readAdmitted(request) {
         this.requireOpen();
         await this.ready();
         const agentKey = this.key(request.entityId);
@@ -84,9 +130,7 @@ export class PostgresAgentHistory {
         return AgentHistoryPages.read(request, after, (cursor, limit) => this.fetch(agentKey, request, cursor, limit));
     }
     /**
-  
      * Closes this handle without deleting stored records.
-  
      */
     close() {
         if (!this.#open)
@@ -100,7 +144,10 @@ export class PostgresAgentHistory {
      * @returns Shared preparation promise for this handle.
      */
     ready() {
-        return (this.#ready ??= this.initialize());
+        return (this.#ready ??= this.initialize().catch((error) => {
+            this.#ready = undefined;
+            throw error;
+        }));
     }
     /**
      * Creates each native index idempotently on the shared record family.
@@ -110,36 +157,22 @@ export class PostgresAgentHistory {
     async initialize() {
         const executor = this.records.historyExecutor();
         await executor.prepare();
+        if (this.onPrepare !== undefined) {
+            try {
+                await this.onPrepare("create");
+            }
+            catch (error) {
+                throw new PostgresStorageOperationError("PostgreSQL record operation failed.", {
+                    cause: error,
+                });
+            }
+            return;
+        }
         await executor.using(async (client) => {
             const table = executor.table();
-            await this.ensureIndex(client, table, "agent_history_full", 'scope_digest, order_key COLLATE "C"');
-            await this.ensureIndex(client, table, "agent_history_category", 'scope_digest, category, order_key COLLATE "C"');
-            await this.ensureIndex(client, table, "agent_history_conversation", 'scope_digest, conversation_digest, order_key COLLATE "C"');
+            await PostgresAgentIndexes.prepare(client, table, "create");
         });
     }
-    /**
-     * Rejects an existing same-name index with incomplete columns or collation.
-     *
-     * @param client Acquired PostgreSQL client.
-     * @param table Validated physical table name.
-     * @param name Fixed required index name.
-     * @param columns Required complete binary-order columns.
-     * @returns Completion after the index definition is checked.
-     */
-    async ensureIndex(client, table, name, columns) {
-        await client.query(`CREATE INDEX IF NOT EXISTS "${name}" ON ${table} (${columns})`);
-        const result = await client.query("SELECT pg_get_indexdef(i.indexrelid) AS definition, i.indisvalid, i.indisready " +
-            "FROM pg_index i " +
-            "JOIN pg_class c ON c.oid=i.indexrelid WHERE i.indrelid=to_regclass($1) AND c.relname=$2", [table, name]);
-        const index = result.rows[0];
-        const definition = index?.definition ?? "";
-        if (!index?.indisvalid ||
-            !index.indisready ||
-            !definition.includes(" USING btree ") ||
-            !definition.includes(`(${columns})`) ||
-            definition.includes(" WHERE "))
-            throw new Error("PostgreSQL Agent history index is incompatible.");
-    }
     /**
      * Reads a bounded native page with complete scope and view predicates.
      *
@@ -213,13 +246,57 @@ export class PostgresAgentHistory {
         return key;
     }
     /**
-  
      * Rejects calls after this handle closes.
-  
      */
     requireOpen() {
         if (!this.#open)
             throw new Error("Agent history storage handle is closed.");
     }
 }
+/**
+ * Verifies the fixed Agent audit indexes without changing a checked database.
+ */
+export const PostgresAgentIndexes = {
+    /**
+     * Prepares each required Agent audit index.
+     *
+     * @param client Acquired client.
+     * @param table Qualified audit table.
+     * @param mode Preparation mode.
+     * @returns Completion after all three indexes match.
+     */
+    async prepare(client, table, mode) {
+        for (const [name, columns] of [
+            ["agent_history_full", 'scope_digest, order_key COLLATE "C"'],
+            ["agent_history_category", 'scope_digest, category, order_key COLLATE "C"'],
+            ["agent_history_conversation", 'scope_digest, conversation_digest, order_key COLLATE "C"'],
+        ])
+            await this.ensure(client, table, name, columns, mode);
+    },
+    /**
+     * Validates one fixed index and creates it only in create mode.
+     *
+     * @param client Acquired client.
+     * @param table Qualified audit table.
+     * @param name Fixed index name.
+     * @param columns Required columns.
+     * @param mode Preparation mode.
+     * @returns Completion after exact index validation.
+     */
+    async ensure(client, table, name, columns, mode) {
+        if (mode === "create")
+            await client.query(`CREATE INDEX IF NOT EXISTS "${name}" ON ${table} (${columns})`);
+        const result = await client.query("SELECT pg_get_indexdef(i.indexrelid) AS definition, i.indisvalid, i.indisready " +
+            "FROM pg_index i " +
+            "JOIN pg_class c ON c.oid=i.indexrelid WHERE i.indrelid=to_regclass($1) AND c.relname=$2", [table, name]);
+        const index = result.rows[0];
+        const definition = index?.definition ?? "";
+        if (!index?.indisvalid ||
+            !index.indisready ||
+            !definition.includes(" USING btree ") ||
+            !definition.includes(`(${columns})`) ||
+            definition.includes(" WHERE "))
+            throw new Error("PostgreSQL Agent history index is incompatible.");
+    },
+};
 //# sourceMappingURL=agent-history.js.map

package/dist/postgres/agent-history.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-history.js","sourceRoot":"","sources":["../../src/postgres/agent-history.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-history.js","sourceRoot":"","sources":["../../src/postgres/agent-history.ts"],"names":[],"mappings":"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"}

package/dist/postgres/column-mapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"column-mapping.d.ts","sourceRoot":"","sources":["../../src/postgres/column-mapping.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKxD;;;;;GAKG;AACH,qBAAa,qBAAsB,YAAW,aAAa,CAAC,iBAAiB,CAAC;;IAG5E;;;;OAIG;gBACS,YAAY,GAAE,mBAA+C;IAIzE;;;;;;OAMG;IACH,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,EAAE,iBAAiB,CAAC;IAWzE;;;;OAIG;IACH,MAAM,IAAI,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,CAAC;CAGrD"}
+{"version":3,"file":"column-mapping.d.ts","sourceRoot":"","sources":["../../src/postgres/column-mapping.ts"],"names":[],"mappings":"AAgBA,OAAO,EAA8B,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC3F,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKxD;;;;;GAKG;AACH,qBAAa,qBAAsB,YAAW,aAAa,CAAC,iBAAiB,CAAC;;IAG5E;;;;OAIG;gBACS,YAAY,GAAE,mBAAgD;IAO1E;;;;;;OAMG;IACH,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,EAAE,iBAAiB,CAAC;IAWzE;;;;OAIG;IACH,MAAM,IAAI,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,CAAC;CAGrD"}

package/dist/postgres/column-mapping.js

@@ -12,7 +12,7 @@
  * the License.
  */
 import { ScalarType } from "@bufbuild/protobuf";
-import { StringifierRegistry } from "@spine-event-engine/core";
+import { defaultStringifierRegistry, StringifierRegistry } from "@spine-event-engine/core";
 const timestampType = "google.protobuf.Timestamp";
 const versionType = "spine.core.Version";
 /**
@@ -28,8 +28,11 @@ export class PostgresColumnMapping {
      *
      * @param stringifiers Provides schema-bound message stringifiers.
      */
-    constructor(stringifiers = new StringifierRegistry()) {
-        this.#stringifiers = new StringifierRegistry(stringifiers);
+    constructor(stringifiers = defaultStringifierRegistry) {
+        this.#stringifiers =
+            stringifiers === defaultStringifierRegistry
+                ? stringifiers
+                : new StringifierRegistry(stringifiers);
     }
     /**
      * Returns the native conversion for one declared column type.

package/dist/postgres/column-mapping.js.map

@@ -1 +1 @@
-{"version":3,"file":"column-mapping.js","sourceRoot":"","sources":["../../src/postgres/column-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAgB,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAS/D,MAAM,aAAa,GAAG,2BAA2B,CAAC;AAClD,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,OAAO,qBAAqB;IACvB,aAAa,CAAsB;IAE5C;;;;OAIG;IACH,YAAY,eAAoC,IAAI,mBAAmB,EAAE;QACvE,IAAI,CAAC,aAAa,GAAG,IAAI,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;OAMG;IACH,EAAE,CAAI,IAAyB;QAC7B,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,sBAAsB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9E,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAA0B,CAAC;QACvE,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,aAAa;YACzC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,WAAW;YACvC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1D,OAAO,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAA8B,CAAC,CAAC,QAAQ,CAAC,KAAgB,CAAC,CAAC;IAClG,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C;;;;;;OAMG;IACH,MAAM,CAAI,IAAgB;QACxB,KAAK,IAAI,CAAC;QACV,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAA0B,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,KAAc;QACtB,MAAM,SAAS,GAAG,KAA6D,CAAC;QAChF,OAAO,SAAS,CAAC,OAAO,GAAG,WAAc,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,KAAc;QACpB,OAAQ,KAAqC,CAAC,MAAM,CAAC;IACvD,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"column-mapping.js","sourceRoot":"","sources":["../../src/postgres/column-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAgB,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAS3F,MAAM,aAAa,GAAG,2BAA2B,CAAC;AAClD,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,OAAO,qBAAqB;IACvB,aAAa,CAAsB;IAE5C;;;;OAIG;IACH,YAAY,eAAoC,0BAA0B;QACxE,IAAI,CAAC,aAAa;YAChB,YAAY,KAAK,0BAA0B;gBACzC,CAAC,CAAC,YAAY;gBACd,CAAC,CAAC,IAAI,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;OAMG;IACH,EAAE,CAAI,IAAyB;QAC7B,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,sBAAsB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9E,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAA0B,CAAC;QACvE,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,aAAa;YACzC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,WAAW;YACvC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1D,OAAO,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAA8B,CAAC,CAAC,QAAQ,CAAC,KAAgB,CAAC,CAAC;IAClG,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C;;;;;;OAMG;IACH,MAAM,CAAI,IAAgB;QACxB,KAAK,IAAI,CAAC;QACV,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAA0B,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,KAAc;QACtB,MAAM,SAAS,GAAG,KAA6D,CAAC;QAChF,OAAO,SAAS,CAAC,OAAO,GAAG,WAAc,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,KAAc;QACpB,OAAQ,KAAqC,CAAC,MAAM,CAAC;IACvD,CAAC;CACF,CAAC,CAAC"}