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

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,12 +1,14 @@
 import { type Message } from "@bufbuild/protobuf";
-import { type EntityCommitInput, type 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 { MemoryEntityStorageFactory, type EntityStorageInput } from "./in-memory-entity-history.js";
 import { TenantRecords } from "./tenant-records.js";
+import { InMemoryStorageBackend } from "./in-memory-storage-backend.js";
 /**
- * Opens one tenant slice for a generated record family.
+ * Acquires one tenant slice for a generated record family.
  *
  * @typeParam I Record identifier type.
  * @typeParam R Stored message type.
@@ -20,14 +22,23 @@ export declare class MemoryEntityCommitStorage implements EntityCommitStorage {
     private readonly entities;
     private readonly openRecords;
     private readonly input;
+    private readonly backend;
+    private readonly onClose;
     /**
      * Creates one source- and tenant-bound commit handle.
      *
      * @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, openRecords: OpenRecords, input: EntityStorageInput<unknown, Message>);
+    constructor(entities: MemoryEntityStorageFactory, openRecords: OpenRecords, input: EntityStorageInput<unknown, Message>, backend: InMemoryStorageBackend, onClose?: () => void);
+    /**
+     * 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.
      *
@@ -38,21 +49,70 @@ export declare class MemoryEntityCommitStorage implements EntityCommitStorage {
      */
     commit<I, S extends Message>(input: EntityCommitInput<I, S>): Promise<void>;
     /**
-     * Commits one Agent transition under the Entity scope queue and Version fence.
+     * 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.
      *
-     * @typeParam I Entity identifier type.
-     * @typeParam S Entity state type.
-     * @param entity Configured Entity storage layout.
-     * @param entityId Typed Agent Entity identifier.
-     * @param expectedVersion Version read before the Agent handler ran.
-     * @param input Optional changed Entity state and history.
-     * @param extra Applies or restores the Agent execution record with the Entity state.
-     * @returns Completion after the fenced transition is stored.
+     * @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.
      */
-    commitAgentConditional<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 runAgentConditional;
     /**
      * Applies one prepared Agent transition and restores affected rows on failure.
      *
@@ -63,7 +123,7 @@ export declare class MemoryEntityCommitStorage implements EntityCommitStorage {
      * @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 the Agent execution record.
+     * @param extra Applies or restores Agent audit records and model preferences.
      * @returns Completion after the transition is stored.
      */
     private applyAgentConditional;
@@ -75,9 +135,15 @@ export declare class MemoryEntityCommitStorage implements EntityCommitStorage {
      */
     private writeAgentStates;
     /**
-     * Closes this handle to new commits.
+     * Closes retained resources after admitted work settles.
+     *
+     * @returns The repeatable close outcome.
+     */
+    close(): Promise<void>;
+    /**
+     * Closes retained adapters only when no commit is admitted.
      */
-    close(): void;
+    closeIdle(): void;
     /**
      * Applies one captured mutation without cross-record compensation.
      *
@@ -88,14 +154,81 @@ export declare class MemoryEntityCommitStorage implements EntityCommitStorage {
      */
     private apply;
     /**
-     * Opens the record families needed by one captured mutation.
+     * 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 Entity and record handles to close after the mutation.
+     * @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.
      *

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,EAAY,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAM5D,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,8BAA8B,CAAC;AAGtC,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,EACL,0BAA0B,EAG1B,KAAK,kBAAkB,EAExB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;GAKG;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;;IA4BjE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAVxB;;;;;;OAMG;gBAEgB,QAAQ,EAAE,0BAA0B,EACpC,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC;IAM9D;;;;;;;OAOG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3E;;;;;;;;;;;OAWG;IACH,sBAAsB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EACzC,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;IAmBhB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,qBAAqB;IAmC7B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;;OAOG;YACW,KAAK;IAqBnB;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;IAiClB;;;;;;;OAOG;YACW,WAAW;IAezB;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAIjB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAUpB;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAO/B;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,WAAW;CAGpB"}
+{"version":3,"file":"in-memory-entity-commit.d.ts","sourceRoot":"","sources":["../../src/memory/in-memory-entity-commit.ts"],"names":[],"mappings":"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"}