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

package/dist/internal/event-store.js

@@ -17,5 +17,5 @@
  * Storage adapters use this subpath to address the same durable records as the
  * framework Event Store without adding the layout to the end-user package root.
  */
-export { eventStoreAccess, eventStoreRecordSpec } from "../event/event-store.js";
+export { eventStoreAccess, eventStoreRecordSpec, EventStoreGroups } from "../event/event-store.js";
 //# sourceMappingURL=event-store.js.map

package/dist/internal/event-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-store.js","sourceRoot":"","sources":["../../src/internal/event-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;GAKG;AACH,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"event-store.js","sourceRoot":"","sources":["../../src/internal/event-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;GAKG;AACH,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/internal/storage-preparation.d.ts

@@ -0,0 +1,88 @@
+import type { Message } from "@bufbuild/protobuf";
+import type { AgentHistoryStorageInput } from "../entity/agent-history.js";
+import type { EntityStorageInput } from "../memory/in-memory-entity-history.js";
+import type { RecordSpec } from "../record/record-spec.js";
+import type { StorageGroup } from "../record/storage-group.js";
+import type { StorageFactory } from "../storage/storage-factory.js";
+import type { StorageContext } from "../storage/storage.js";
+/**
+ * Selects creation or read-only compatibility checking.
+ */
+export type StoragePreparationMode = "create" | "check";
+/**
+ * Declares an Entity without borrowed history handles.
+ *
+ * @typeParam I Entity identifier type.
+ * @typeParam S Entity state type.
+ */
+export type EntityStoragePreparationInput<I, S extends Message> = Omit<EntityStorageInput<I, S>, "stateHistoryStorage" | "eventHistoryStorage">;
+/**
+ * Provider-only operations that establish physical storage requirements.
+ */
+export interface StoragePreparation {
+    /**
+     * Prepares one ordinary record family.
+     *
+     * @typeParam I Record identifier type.
+     * @typeParam R Record message type.
+     * @param context Complete storage scope.
+     * @param spec Declarative record layout.
+     * @param group Optional physical group.
+     * @param mode Creation or read-only compatibility check.
+     * @returns Completion after the requirement is established.
+     */
+    prepareRecord<I, R extends Message>(context: StorageContext, spec: RecordSpec<I, R>, group: StorageGroup | undefined, mode: StoragePreparationMode): Promise<void>;
+    /**
+     * Prepares current Entity records and enabled history families.
+     *
+     * @typeParam I Entity identifier type.
+     * @typeParam S Entity state type.
+     * @param input Complete declarative Entity layout.
+     * @param mode Creation or read-only compatibility check.
+     * @returns Completion after the requirements are established.
+     */
+    prepareEntity<I, S extends Message>(input: EntityStoragePreparationInput<I, S>, mode: StoragePreparationMode): Promise<void>;
+    /**
+     * Prepares the surviving Agent audit history family.
+     *
+     * @typeParam I Agent identifier type.
+     * @param input Agent history scope and codec.
+     * @param mode Creation or read-only compatibility check.
+     * @returns Completion after the audit requirement is established.
+     */
+    prepareAgentHistory<I>(input: AgentHistoryStorageInput<I>, mode: StoragePreparationMode): Promise<void>;
+    /**
+     * Prepares current Entity, enabled histories, final Agent audit, and model preferences.
+     * @typeParam I Typed Agent identifier.
+     * @typeParam S Generated Agent state.
+     * @param input Declarative Agent Entity layout.
+     * @param mode Creation or read-only compatibility check.
+     * @returns Completion after native transactional requirements are checked.
+     */
+    prepareAgentCommit<I, S extends Message>(input: EntityStoragePreparationInput<I, S>, mode: StoragePreparationMode): Promise<void>;
+}
+/**
+ * Registers and finds provider preparation capabilities.
+ */
+interface StoragePreparationAccess {
+    /**
+     * Registers a provider preparation port.
+     *
+     * @param factory The provider factory.
+     * @param preparation Its preparation implementation.
+     */
+    register(factory: StorageFactory, preparation: StoragePreparation): void;
+    /**
+     * Finds a registered preparation port.
+     *
+     * @param factory The provider factory.
+     * @returns Its preparation port.
+     */
+    for(factory: StorageFactory): StoragePreparation;
+}
+/**
+ * Framework lookup for a provider's registered preparation capability.
+ */
+export declare const StoragePreparations: StoragePreparationAccess;
+export {};
+//# sourceMappingURL=storage-preparation.d.ts.map

package/dist/internal/storage-preparation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-preparation.d.ts","sourceRoot":"","sources":["../../src/internal/storage-preparation.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAExD;;;;;GAKG;AACH,MAAM,MAAM,6BAA6B,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,IAAI,IAAI,CACpE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,EACxB,qBAAqB,GAAG,qBAAqB,CAC9C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;OAUG;IACH,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAChC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EACtB,KAAK,EAAE,YAAY,GAAG,SAAS,EAC/B,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;OAQG;IACH,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAChC,KAAK,EAAE,6BAA6B,CAAC,CAAC,EAAE,CAAC,CAAC,EAC1C,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;OAOG;IACH,mBAAmB,CAAC,CAAC,EACnB,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAClC,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;OAOG;IACH,kBAAkB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EACrC,KAAK,EAAE,6BAA6B,CAAC,CAAC,EAAE,CAAC,CAAC,EAC1C,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAID;;GAEG;AACH,UAAU,wBAAwB;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAEzE;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,kBAAkB,CAAC;CAClD;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,wBAuBhC,CAAC"}

package/dist/internal/storage-preparation.js

@@ -0,0 +1,41 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+const preparations = new WeakMap();
+/**
+ * Framework lookup for a provider's registered preparation capability.
+ */
+export const StoragePreparations = Object.freeze({
+    /**
+     * Registers a provider preparation port.
+     *
+     * @param factory The provider factory.
+     * @param preparation Its preparation implementation.
+     */
+    register(factory, preparation) {
+        preparations.set(factory, preparation);
+    },
+    /**
+     * Finds a registered preparation port, rejecting unsupported providers.
+     *
+     * @param factory The provider factory.
+     * @returns Its preparation port.
+     */
+    for(factory) {
+        const preparation = preparations.get(factory);
+        if (preparation === undefined)
+            throw new Error("StorageFactory does not support storage preparation.");
+        return preparation;
+    },
+});
+//# sourceMappingURL=storage-preparation.js.map

package/dist/internal/storage-preparation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-preparation.js","sourceRoot":"","sources":["../../src/internal/storage-preparation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA0FH,MAAM,YAAY,GAAG,IAAI,OAAO,EAAsC,CAAC;AAuBvE;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA6B,MAAM,CAAC,MAAM,CAAC;IACzE;;;;;OAKG;IACH,QAAQ,CAAC,OAAuB,EAAE,WAA+B;QAC/D,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,OAAuB;QACzB,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,WAAW,KAAK,SAAS;YAC3B,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,OAAO,WAAW,CAAC;IACrB,CAAC;CACF,CAAC,CAAC"}

package/dist/internal/tenancy.d.ts

@@ -131,6 +131,13 @@ export declare const TenantCatalogReads: Readonly<{
  * @internal
  */
 export interface TenantCatalog {
+    /**
+     * Checks current membership without registering or preparing storage.
+     *
+     * @param boundary Complete tenant boundary to inspect.
+     * @returns Whether this catalog currently includes the boundary.
+     */
+    contains(boundary: TenantBoundary): Promise<boolean>;
     /**
      * Lists the boundaries available for storage-backed startup work.
      *

package/dist/internal/tenancy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tenancy.d.ts","sourceRoot":"","sources":["../../src/internal/tenancy.ts"],"names":[],"mappings":"AAeA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAG7B;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;CACzC;AAED,UAAU,yBAA0B,SAAQ,cAAc;IACxD,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEhC;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,yBAAyB,CAAC;IAEpD;;;;;OAKG;IACH,EAAE,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAAC;CAC7C;AAQD;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,qBAuC5B,CAAC;AAoEF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,qBAAqB,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,cAAc,IAAI,IAAI,CAAC;IAEvB;;;;;;OAMG;IACH,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAEzF;;;;;OAKG;IACH,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;IAE/C;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC;IAAE,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAAE,CAYnF,CAAC;AAEL;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAG5B;;;;OAIG;IACH,GAAG,IAAI,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;IAE1C;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE7D;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IAGpC;;;;OAIG;IACH,aAAa,IAAI,aAAa,CAAC;CAChC"}
+{"version":3,"file":"tenancy.d.ts","sourceRoot":"","sources":["../../src/internal/tenancy.ts"],"names":[],"mappings":"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"}

package/dist/memory/in-memory-agent-history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory-agent-history.d.ts","sourceRoot":"","sources":["../../src/memory/in-memory-agent-history.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAGV,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,EACL,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE,wBAAwB,CAAC,EAAE,CAAC,GAClC,mBAAmB,CAAC,EAAE,CAAC,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,wBA2B/B,CAAC"}
+{"version":3,"file":"in-memory-agent-history.d.ts","sourceRoot":"","sources":["../../src/memory/in-memory-agent-history.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAGV,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,EACL,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE,wBAAwB,CAAC,EAAE,CAAC,GAClC,mBAAmB,CAAC,EAAE,CAAC,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,wBA2B/B,CAAC"}

package/dist/memory/in-memory-agent-history.js

@@ -11,6 +11,8 @@
  * or implied. See the License for the specific language governing permissions and limitations under
  * the License.
  */
+import { clone } from "@bufbuild/protobuf";
+import { AgentHistoryEntrySchema } from "@spine-event-engine/proto/agent";
 import { TenantBoundary } from "../internal/tenancy.js";
 import { AgentHistoryIndex } from "./agent-history-index.js";
 import { AgentHistoryMutationQueue } from "./agent-history-mutation-queue.js";
@@ -40,6 +42,7 @@ export const MemoryAgentHistory = Object.freeze({
  * @typeParam Id Typed Agent identifier.
  */
 class MemoryAgentHistoryHandle {
+    capacity = Object.freeze({});
     #idKey;
     #records;
     #queue;
@@ -64,15 +67,27 @@ class MemoryAgentHistoryHandle {
      * @returns Resolves after the entry is indexed.
      */
     append(entityId, entry) {
+        return this.appendAll(entityId, [entry]);
+    }
+    /**
+     * Writes atomically adds an immutable group after validating all rows and indexes.
+     *
+     * @param entityId Typed Entity identifier.
+     * @param entries Complete immutable history group.
+     * @returns Completion after the immutable audit group commits atomically.
+     */
+    async appendAll(entityId, entries) {
+        this.#requireOpen();
         const key = this.#key(entityId);
-        return this.#queue.run(key, () => {
-            this.#requireOpen();
-            let index = this.#records.get(key);
-            if (index === undefined) {
-                index = new AgentHistoryIndex();
+        const captured = entries.map((entry) => clone(AgentHistoryEntrySchema, entry));
+        if (captured.length === 0)
+            return;
+        await this.#queue.run(key, () => {
+            const existing = this.#records.get(key);
+            const index = existing ?? new AgentHistoryIndex();
+            index.withEntries(captured).apply();
+            if (existing === undefined)
                 this.#records.set(key, index);
-            }
-            index.append(entry);
         });
     }
     /**

package/dist/memory/in-memory-agent-history.js.map

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

package/dist/memory/in-memory-entity-commit.d.ts

@@ -1,84 +1,279 @@
 import { type Message } from "@bufbuild/protobuf";
-import type { EntityCommitInput, EntityCommitStorage } from "../internal/entity-commit.js";
+import { type ModelPreference } from "@spine-event-engine/proto/agent";
+import { type AgentCommitInput, type EntityCommitInput, type EntityCommitStorage } from "../internal/entity-commit.js";
 import type { RecordSpec } from "../record/record-spec.js";
 import type { StorageGroup } from "../record/storage-group.js";
 import type { StorageContext } from "../storage/storage.js";
-import type { StorageFactory } from "../storage/storage-factory.js";
 import { MemoryEntityStorageFactory, type EntityStorageInput } from "./in-memory-entity-history.js";
 import { TenantRecords } from "./tenant-records.js";
+import { InMemoryStorageBackend } from "./in-memory-storage-backend.js";
 /**
- * Opens the in-memory tenant slice for a generated record family.
+ * Acquires one tenant slice for a generated record family.
  *
  * @typeParam I Record identifier type.
- * @typeParam R Record message type.
- * @param context Supplies the storage and tenant context.
- * @param spec Supplies the materialized record layout.
- * @param group Selects a grouped history family when present.
- * @returns The tenant record slice.
+ * @typeParam R Stored message type.
  */
 type OpenRecords = <I, R extends Message>(context: StorageContext, spec: RecordSpec<I, R>, group?: StorageGroup) => TenantRecords<I, R>;
 /**
- * Implements provider Entity commits for one shared in-memory backend.
+ * Writes in-memory Entity records in order and retains a completed prefix.
  */
 export declare class MemoryEntityCommitStorage implements EntityCommitStorage {
     #private;
+    private readonly entities;
+    private readonly openRecords;
+    private readonly input;
+    private readonly backend;
+    private readonly onClose;
     /**
-     * Creates a commit handle bound to one Entity source type.
+     * Creates one source- and tenant-bound commit handle.
      *
-     * @param entities Opens the matching current Entity storage.
-     * @param factory Provides the Event Store coordination lock.
-     * @param openRecords Opens exact generic-record backing slices.
-     * @param input Defines the Entity storage source type.
+     * @param entities Opens current Entity storage.
+     * @param openRecords Opens generated history and Event record slices.
+     * @param input Captures the Entity source and tenant boundary.
+     * @param backend Shared tenant memory families for preferences and audit.
+     * @param onClose Releases factory tracking after terminal cleanup.
      */
-    constructor(entities: MemoryEntityStorageFactory, factory: StorageFactory, openRecords: OpenRecords, input: EntityStorageInput<unknown, Message>);
+    constructor(entities: MemoryEntityStorageFactory, openRecords: OpenRecords, input: EntityStorageInput<unknown, Message>, backend: InMemoryStorageBackend, onClose?: () => void);
     /**
-     * Applies one fully preflighted in-memory Entity commit.
+     * Binds shared Agent families only when this handle performs Agent work.
+     * @returns Cached preference, audit, and mutation-queue families.
+     */
+    private agentFamilies;
+    /**
+     * Writes history, diagnostics, delivery Events, then current state.
      *
      * @typeParam I Entity identifier type.
      * @typeParam S Entity state type.
-     * @param input Defines the current record, retained histories, and delivery events.
-     * @returns Completion after the in-memory commit.
+     * @param input Supplies the proposed mutation.
+     * @returns Completion after every record has been stored.
      */
     commit<I, S extends Message>(input: EntityCommitInput<I, S>): Promise<void>;
     /**
-     * Applies an Agent completion only while the current Entity Version matches.
+     * Reads a detached current preference image from the retained tenant family.
+     * @param entityId Typed Agent identifier.
+     * @returns Complete selections or absent record.
+     */
+    readAgentPreferences(entityId: unknown): Promise<readonly ModelPreference[] | undefined>;
+    /**
+     * Commits Agent state, final audit, and preferences under shared memory queues.
+     * @param input Captured initial images and prepared transition.
+     * @returns Completion after one conditional group.
+     * @typeParam I Typed Agent identifier.
+     * @typeParam S Generated Agent state.
+     */
+    commitAgent<I, S extends Message>(input: AgentCommitInput<I, S>): Promise<void>;
+    /**
+     * Validates the fixed Entity identity and one-version transition.
+     * @param entityId Captured Agent identifier.
+     * @param expectedVersion Initial Entity Version.
+     * @param entityCommit Optional prepared current-state mutation.
+     */
+    private validateAgentCommit;
+    /**
+     * Records final audit and preference replacements inside the Entity mutation.
+     * @param entityId Captured Agent identifier.
+     * @param slot Bounded preference record slot.
+     * @param expectedVersion Initial Entity Version.
+     * @param expected Initial preference image.
+     * @param next Complete next preference record.
+     * @param entityCommit Optional prepared current-state mutation.
+     * @param history Captured final audit rows.
+     * @returns Completion after one conditional group.
+     */
+    private commitAgentLocked;
+    /**
+     * Replaces preference and final audit rows with rollback for failed Entity work.
+     * @param slot Bounded preference record slot.
+     * @param next Complete next preference record.
+     * @param expected Initial preference image.
+     * @param prior Previously retained preference record.
+     * @param agentKey Canonical Agent identifier.
+     * @param index Current or new audit index.
+     * @param priorIndex Previously retained audit index.
+     * @param staged Reversible final audit batch.
+     * @returns Reversible publication callbacks.
+     */
+    private agentPublication;
+    /**
+     * Calculates a bounded v1 slot from complete preference identity evidence.
+     * @param key Complete generated Agent identity.
+     * @returns Fixed 67-character provider slot.
+     */
+    private preferenceSlot;
+    /**
+     * Performs the captured conditional Agent change.
+     *
+     * @param entity The Entity persistence contract.
+     * @param entityId The captured Entity identifier.
+     * @param expectedVersion The required prior Entity version.
+     * @param extra The additional conditional records.
+     * @param input The captured Entity persistence input.
+     * @returns Completion after the conditional Agent change settles.
+     * @typeParam I Entity identifier or record type.
+     * @typeParam S Generated Entity state message type.
+     */
+    private runAgentConditional;
+    /**
+     * Applies one prepared Agent transition and restores affected rows on failure.
+     *
+     * @typeParam I Entity identifier type.
+     * @typeParam S Entity state type.
+     * @param entity Configured Entity storage layout.
+     * @param backend Shared current records for this Entity scope.
+     * @param key Canonical Entity ID key.
+     * @param expectedVersion Version read before handler execution.
+     * @param snapshot Optional captured Entity state transition.
+     * @param extra Applies or restores Agent audit records and model preferences.
+     * @returns Completion after the transition is stored.
+     */
+    private applyAgentConditional;
+    /**
+     * Writes immutable Agent state history after checking each Version slot.
+     *
+     * @param states State-history records when that family is configured.
+     * @param prepared Materialized state rows from the captured transition.
+     */
+    private writeAgentStates;
+    /**
+     * Closes retained resources after admitted work settles.
+     *
+     * @returns The repeatable close outcome.
+     */
+    close(): Promise<void>;
+    /**
+     * Closes retained adapters only when no commit is admitted.
+     */
+    closeIdle(): void;
+    /**
+     * Applies one captured mutation without cross-record compensation.
+     *
+     * @typeParam I Entity identifier type.
+     * @typeParam S Entity state type.
+     * @param input Supplies immutable record snapshots.
+     * @returns Completion after every requested record write.
+     */
+    private apply;
+    /**
+     * Acquires only missing record families and retains them for this handle.
+     *
+     * @typeParam I Entity identifier type.
+     * @typeParam S Entity state type.
+     * @param input Supplies requested history and delivery records.
+     * @returns Retained Entity and requested family handles.
+     */
+    private openCommit;
+    /**
+     * Acquires the current Entity adapter once.
+     *
+     * @param acquired Newly acquired handles to close on failure.
+     * @param input The captured Entity persistence input.
+     * @returns The retained current Entity record handle.
+     * @typeParam I Entity identifier or record type.
+     * @typeParam S Generated Entity state message type.
+     */
+    private openCurrent;
+    /**
+     * Acquires retained state-history storage and its adapter.
+     *
+     * @param acquired Newly acquired handles to close on failure.
+     * @param input The captured Entity persistence input.
+     * @returns The retained state-history record handle.
+     * @typeParam I Entity identifier or record type.
+     * @typeParam S Generated Entity state message type.
+     */
+    private openStates;
+    /**
+     * Acquires retained diagnostic history storage and its adapter.
+     *
+     * @param acquired Newly acquired handles to close on failure.
+     * @param input The captured Entity persistence input.
+     * @returns The retained diagnostic Event record handle.
+     * @typeParam I Entity identifier or record type.
+     * @typeParam S Generated Entity state message type.
+     */
+    private openDiagnostics;
+    /**
+     * Acquires retained delivery Event storage.
+     *
+     * @param acquired Newly acquired handles to close on failure.
+     * @param input The captured Entity persistence input.
+     * @returns The retained delivery Event record handle.
+     * @typeParam I Entity identifier or record type.
+     * @typeParam S Generated Entity state message type.
+     */
+    private openDelivery;
+    /**
+     * Registers provider work before invoking the operation.
+     *
+     * @param action The admitted provider operation.
+     * @returns The admitted provider operation completion.
+     * @typeParam Value Result type of the admitted provider operation.
+     */
+    private track;
+    /**
+     * Waits for admitted commits and reports every retained close failure.
+     *
+     * @returns Completion after admitted work and cleanup settle.
+     */
+    private drain;
+    /**
+     * Closes retained adapters once after no commit remains active.
+     *
+     * @returns A cleanup failure, if any.
+     */
+    private closeRetained;
+    /**
+     * Closes every newly acquired handle and collects cleanup failures.
+     *
+     * @param ports The acquired record handles.
+     * @returns Cleanup failures from acquired handles.
+     */
+    private closeGroup;
+    /**
+     * Writes one immutable delivery Event or accepts an identical retry.
      *
-     * @typeParam I Typed Entity identifier.
-     * @typeParam S Generated Entity state.
-     * @param entity Existing Entity layout.
-     * @param entityId Typed Entity identifier.
-     * @param expectedVersion Version observed before Agent handlers ran.
-     * @param input Current-state mutation, absent for a no-op.
-     * @param extra Staged execution and history publication with restoration.
-     * @returns Completion after conditional Entity and execution publication.
+     * @param storage Supplies atomic single-record insertion.
+     * @param id Identifies the delivery Event.
+     * @param event Supplies the captured Event.
+     * @returns Completion after an identical Event is stored.
      */
-    commitConditional<I, S extends Message>(entity: EntityStorageInput<I, S>, entityId: I, expectedVersion: number, input: EntityCommitInput<I, S> | undefined, extra: {
-        apply(): void;
-        restore(): void;
-    }): Promise<void>;
+    private appendEvent;
     /**
-     * Closes this commit handle without closing sibling handles.
+     * Compares two stored Protobuf byte sequences.
+     *
+     * @param left First byte sequence.
+     * @param right Second byte sequence.
+     * @returns Whether every byte matches.
      */
-    close(): void;
+    private sameBytes;
     /**
-     * Opens only record families used by one commit.
+     * Validates current identity and duplicate delivery IDs before writes.
      *
      * @typeParam I Entity identifier type.
      * @typeParam S Entity state type.
-     * @param input Supplies configured histories and delivery Events.
-     * @returns Live affected record families and their layouts.
+     * @param input Supplies the captured mutation.
      */
-    private live;
+    private validateRows;
     /**
-     * Captures affected rows and creates isolated adapters for preparation.
+     * Rejects disabled history families.
      *
      * @typeParam I Entity identifier type.
      * @typeParam S Entity state type.
-     * @param input Supplies the proposed record changes.
-     * @param backend Supplies the live current-record map.
-     * @returns The prepared affected-record workspace.
+     * @param input Supplies the proposed histories.
+     */
+    private requireEnabledHistories;
+    /**
+     * Checks the tenant and source captured by this handle.
+     *
+     * @typeParam I Entity identifier type.
+     * @typeParam S Entity state type.
+     * @param input Supplies the requested scope.
+     */
+    private requireCompatible;
+    /**
+     * Rejects commits after this handle closes.
      */
-    private stage;
+    private requireOpen;
 }
 export {};
 //# sourceMappingURL=in-memory-entity-commit.d.ts.map

package/dist/memory/in-memory-entity-commit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory-entity-commit.d.ts","sourceRoot":"","sources":["../../src/memory/in-memory-entity-commit.ts"],"names":[],"mappings":"AAcA,OAAO,EAAS,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAOzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,EAGL,0BAA0B,EAG1B,KAAK,kBAAkB,EACxB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;GASG;AACH,KAAK,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EACtC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EACtB,KAAK,CAAC,EAAE,YAAY,KACjB,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEzB;;GAEG;AACH,qBAAa,yBAA0B,YAAW,mBAAmB;;IAenE;;;;;;;OAOG;gBAED,QAAQ,EAAE,0BAA0B,EACpC,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC;IAU7C;;;;;;;OAOG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC3E;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EACpC,MAAM,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,EAChC,QAAQ,EAAE,CAAC,EACX,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,EAC1C,KAAK,EAAE;QAAE,KAAK,IAAI,IAAI,CAAC;QAAC,OAAO,IAAI,IAAI,CAAA;KAAE,GACxC,OAAO,CAAC,IAAI,CAAC;IAgChB;;OAEG;IACH,KAAK,IAAI,IAAI;IA0Bb;;;;;;;OAOG;IACH,OAAO,CAAC,IAAI;IAsBZ;;;;;;;;OAQG;IACH,OAAO,CAAC,KAAK;CAgOd"}
+{"version":3,"file":"in-memory-entity-commit.d.ts","sourceRoot":"","sources":["../../src/memory/in-memory-entity-commit.ts"],"names":[],"mappings":"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"}