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

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { EventStore, type EventRollback, type EventStoreContext, type OnEventAccepted, } from "./event/event-store.js";
+export { EventStore, type EventStoreContext, type OnEventAccepted } from "./event/event-store.js";
 export type { EntityEventStorage, EntityStateHistoryStorage, } from "./entity/entity-history-storage.js";
 export { InMemoryRecordStorage } from "./memory/in-memory-record-storage.js";
 export { InMemoryStorageBackend } from "./memory/in-memory-storage-backend.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,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,YAAY,EACV,4BAA4B,EAC5B,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,YAAY,EACZ,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAClG,YAAY,EACV,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,YAAY,EACV,4BAA4B,EAC5B,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,YAAY,EACZ,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/index.js

@@ -11,7 +11,7 @@
  * or implied. See the License for the specific language governing permissions and limitations under
  * the License.
  */
-export { EventStore, } from "./event/event-store.js";
+export { EventStore } from "./event/event-store.js";
 export { InMemoryRecordStorage } from "./memory/in-memory-record-storage.js";
 export { InMemoryStorageBackend } from "./memory/in-memory-storage-backend.js";
 export { InMemoryStorageFactory } from "./memory/in-memory-storage-factory.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,UAAU,GAIX,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AAUpC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAyB,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EACL,cAAc,GAGf,MAAM,4BAA4B,CAAC;AAOpC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,UAAU,EAA0B,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAgD,MAAM,wBAAwB,CAAC;AAKlG,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AAUpC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAyB,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EACL,cAAc,GAGf,MAAM,4BAA4B,CAAC;AAOpC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,UAAU,EAA0B,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/internal/agent-execution.d.ts

@@ -0,0 +1,51 @@
+import type { Message } from "@bufbuild/protobuf";
+import type { AgentExecutionStorage, AgentExecutionStorageInput } from "../entity/agent-execution.js";
+import type { StorageFactory } from "../storage/storage-factory.js";
+/**
+ * Opens provider handles for durable Agent execution.
+ */
+export interface AgentExecutionStorageFactory {
+    /**
+     * Opens a closeable provider handle for one Agent repository.
+     *
+     * @typeParam I Typed Agent identifier.
+     * @typeParam S Generated Agent state.
+     * @param input Entity layout and generated Agent state type.
+     * @returns Provider execution handle.
+     */
+    createAgentExecutionStorage<I, S extends Message>(input: AgentExecutionStorageInput<I, S>): AgentExecutionStorage<I, S>;
+}
+/**
+ * Registers and opens the provider-only durable Agent execution capability.
+ */
+export interface AgentExecutionFactoryAccess {
+    /**
+     * Returns whether a storage factory registered durable Agent execution.
+     *
+     * @param factory Storage factory checked at Bounded Context registration.
+     * @returns Whether the provider offers Agent execution handles.
+     */
+    supports(factory: StorageFactory): boolean;
+    /**
+     * Registers a provider capability.
+     *
+     * @param factory Storage factory offering execution.
+     * @param creator Provider-specific handle creator.
+     */
+    register(factory: StorageFactory, creator: AgentExecutionStorageFactory): void;
+    /**
+     * Opens the required provider capability.
+     *
+     * @typeParam I Typed Agent identifier.
+     * @typeParam S Generated Agent state.
+     * @param factory Storage factory offering execution.
+     * @param input Agent repository scope and Entity layout.
+     * @returns Closeable provider execution handle.
+     */
+    create<I, S extends Message>(factory: StorageFactory, input: AgentExecutionStorageInput<I, S>): AgentExecutionStorage<I, S>;
+}
+/**
+ * Registers and creates provider execution handles without exposing them to applications.
+ */
+export declare const AgentExecutionStorageFactories: AgentExecutionFactoryAccess;
+//# sourceMappingURL=agent-execution.d.ts.map

package/dist/internal/agent-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-execution.d.ts","sourceRoot":"","sources":["../../src/internal/agent-execution.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EACV,qBAAqB,EACrB,0BAA0B,EAC3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;;;;OAOG;IACH,2BAA2B,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAC9C,KAAK,EAAE,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,GACtC,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAChC;AAID;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC;IAE3C;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,4BAA4B,GAAG,IAAI,CAAC;IAE/E;;;;;;;;OAQG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EACzB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,GACtC,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,2BAuC3C,CAAC"}

package/dist/internal/agent-execution.js

@@ -0,0 +1,53 @@
+/*
+ * 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 factories = new WeakMap();
+/**
+ * Registers and creates provider execution handles without exposing them to applications.
+ */
+export const AgentExecutionStorageFactories = Object.freeze({
+    /**
+     * Checks provider registration without selecting or fabricating a tenant.
+     *
+     * @param factory Storage factory checked at Bounded Context registration.
+     * @returns Whether the provider offers Agent execution handles.
+     */
+    supports(factory) {
+        return factories.has(factory);
+    },
+    /**
+     * Registers one provider's execution capability.
+     *
+     * @param factory Storage factory offering execution.
+     * @param creator Provider-specific handle creator.
+     */
+    register(factory, creator) {
+        factories.set(factory, creator);
+    },
+    /**
+     * Rejects providers without durable Agent execution support before intake.
+     *
+     * @typeParam I Typed Agent identifier.
+     * @typeParam S Generated Agent state.
+     * @param factory Storage factory offering execution.
+     * @param input Agent repository scope and Entity layout.
+     * @returns Closeable provider execution handle.
+     */
+    create(factory, input) {
+        const creator = factories.get(factory);
+        if (creator === undefined)
+            throw new Error("StorageFactory does not provide durable Agent execution storage.");
+        return creator.createAgentExecutionStorage(input);
+    },
+});
+//# sourceMappingURL=agent-execution.js.map

package/dist/internal/agent-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-execution.js","sourceRoot":"","sources":["../../src/internal/agent-execution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA2BH,MAAM,SAAS,GAAG,IAAI,OAAO,EAAgD,CAAC;AAqC9E;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAgC,MAAM,CAAC,MAAM,CAAC;IACvF;;;;;OAKG;IACH,QAAQ,CAAC,OAAuB;QAC9B,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAAuB,EAAE,OAAqC;QACrE,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CACJ,OAAuB,EACvB,KAAuC;QAEvC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,OAAO,KAAK,SAAS;YACvB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,OAAO,OAAO,CAAC,2BAA2B,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,48 @@
+import type { AgentHistoryStorage, AgentHistoryStorageInput } from "../entity/agent-history.js";
+import type { StorageFactory } from "../storage/storage-factory.js";
+/**
+ * Creates provider handles for one Agent history scope.
+ */
+export interface AgentHistoryStorageFactory {
+    /**
+     * Opens the provider's indexed Agent history handle.
+     *
+     * @typeParam Id Typed Agent identifier.
+     * @param input Bounded Context, tenant, state type, and ID codec.
+     * @returns Independently closeable history handle.
+     */
+    createAgentHistoryStorage<Id>(input: AgentHistoryStorageInput<Id>): AgentHistoryStorage<Id>;
+}
+/**
+ * Registers provider capability and opens its scoped handles.
+ */
+export interface AgentHistoryFactoryAccess {
+    /**
+     * Returns whether the provider registered mandatory Agent history.
+     *
+     * @param factory Storage factory checked before a tenant is selected.
+     * @returns Whether indexed Agent history handles are available.
+     */
+    supports(factory: StorageFactory): boolean;
+    /**
+     * Registers an Agent history provider capability.
+     *
+     * @param factory Provider storage factory.
+     * @param creator Provider-specific handle creator.
+     */
+    register(factory: StorageFactory, creator: AgentHistoryStorageFactory): void;
+    /**
+     * Opens the required Agent history provider capability.
+     *
+     * @typeParam Id Typed Agent identifier.
+     * @param factory Provider storage factory.
+     * @param input Bounded Context, state type, and typed ID scope.
+     * @returns Independently closeable history handle.
+     */
+    create<Id>(factory: StorageFactory, input: AgentHistoryStorageInput<Id>): AgentHistoryStorage<Id>;
+}
+/**
+ * Registers and opens the provider-only Agent history capability.
+ */
+export declare const AgentHistoryStorageFactories: AgentHistoryFactoryAccess;
+//# sourceMappingURL=agent-history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-history.d.ts","sourceRoot":"","sources":["../../src/internal/agent-history.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAChG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;;OAMG;IACH,yBAAyB,CAAC,EAAE,EAAE,KAAK,EAAE,wBAAwB,CAAC,EAAE,CAAC,GAAG,mBAAmB,CAAC,EAAE,CAAC,CAAC;CAC7F;AAID;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC;IAE3C;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAE7E;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,wBAAwB,CAAC,EAAE,CAAC,GAAG,mBAAmB,CAAC,EAAE,CAAC,CAAC;CACnG;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,yBAsCzC,CAAC"}

package/dist/internal/agent-history.js

@@ -0,0 +1,52 @@
+/*
+ * 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 factories = new WeakMap();
+/**
+ * Registers and opens the provider-only Agent history capability.
+ */
+export const AgentHistoryStorageFactories = Object.freeze({
+    /**
+     * Checks registration without creating a handle for an invented tenant.
+     *
+     * @param factory Storage factory checked at Bounded Context registration.
+     * @returns Whether Agent history handles are available.
+     */
+    supports(factory) {
+        return factories.has(factory);
+    },
+    /**
+     * Registers a provider's Agent history handle factory.
+     *
+     * @param factory Storage factory offering the capability.
+     * @param creator Provider-specific handle creator.
+     */
+    register(factory, creator) {
+        factories.set(factory, creator);
+    },
+    /**
+     * Opens an Agent history handle or fails when the provider lacks one.
+     *
+     * @typeParam Id Typed Agent identifier.
+     * @param factory Provider storage factory.
+     * @param input Bounded Context, tenant, state type, and ID codec.
+     * @returns Independently closeable history handle.
+     */
+    create(factory, input) {
+        const creator = factories.get(factory);
+        if (creator === undefined)
+            throw new Error("StorageFactory does not provide required Agent history storage.");
+        return creator.createAgentHistoryStorage(input);
+    },
+});
+//# sourceMappingURL=agent-history.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-history.js","sourceRoot":"","sources":["../../src/internal/agent-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAmBH,MAAM,SAAS,GAAG,IAAI,OAAO,EAA8C,CAAC;AAiC5E;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAA8B,MAAM,CAAC,MAAM,CAAC;IACnF;;;;;OAKG;IACH,QAAQ,CAAC,OAAuB;QAC9B,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAAuB,EAAE,OAAmC;QACnE,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CACJ,OAAuB,EACvB,KAAmC;QAEnC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,OAAO,KAAK,SAAS;YACvB,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,OAAO,OAAO,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;CACF,CAAC,CAAC"}

package/dist/internal/entity-commit.d.ts

@@ -1,16 +1,17 @@
-import type { Message } from "@bufbuild/protobuf";
-import type { Event } from "@spine-event-engine/proto";
+import { type Message } from "@bufbuild/protobuf";
+import { type Event } from "@spine-event-engine/proto";
 import type { EntityRecord } from "../entity/entity-record.js";
 import type { StorageContext } from "../storage/storage.js";
 import type { EntityStorageInput } from "./entity-history.js";
 import type { StorageFactory } from "../storage/storage-factory.js";
 /**
- * Describes one coordinated provider mutation for an Entity commit.
+ * Describes one prepared provider mutation for an Entity commit.
  *
  * This provider-only contract combines current state, retained histories, and
- * framework delivery events. Memory and transactional database providers apply
- * the changes atomically. MyISAM and Aria tables can retain partial writes.
- * This contract is not an application-level transaction API.
+ * framework delivery events. Providers write histories, diagnostic events,
+ * delivery events, then current state independently. A failed commit can leave
+ * a completed prefix on every provider. Single-record conditional operations
+ * remain atomic per storage slot; this port does not coordinate multiple records.
  *
  * @typeParam I Entity identifier type.
  * @typeParam S Entity state message type.
@@ -46,10 +47,28 @@ export interface EntityCommitInput<I, S extends Message> {
     readonly events?: readonly Event[];
 }
 /**
- * A provider handle for coordinated changes to one bounded Entity scope.
+ * Captures prepared Entity records before provider I/O or a bounded retry.
  *
- * Memory and transactional database providers apply each commit atomically.
- * MyISAM and Aria tables can retain partial writes if a commit fails.
+ * Every retry reuses the same Entity ID, versions, and Event IDs; providers
+ * never invoke the application handler to prepare a second mutation.
+ */
+export declare const EntityCommitSnapshots: Readonly<{
+    /**
+     * Captures one prepared mutation before provider I/O.
+     *
+     * @typeParam I Entity identifier type.
+     * @typeParam S Entity state message type.
+     * @param input Supplies the prepared mutation.
+     * @returns An independent mutation snapshot.
+     */
+    capture<I, S extends Message>(input: EntityCommitInput<I, S>): EntityCommitInput<I, S>;
+}>;
+/**
+ * A provider handle for one bounded Entity scope.
+ *
+ * A commit may retain a completed prefix when a later record fails. Replaying
+ * the same captured input reuses versions and Event IDs. An Event's presence
+ * alone does not establish that current state was saved.
  */
 export interface EntityCommitStorage {
     /**
@@ -71,7 +90,7 @@ export interface EntityCommitStorage {
  */
 export interface EntityCommitStorageFactory {
     /**
-     * Creates a handle that coordinates Entity persistence changes for one provider.
+     * Creates a handle that persists one Entity's prepared records.
      *
      * @typeParam I Entity identifier type.
      * @typeParam S Entity state message type.
@@ -103,7 +122,7 @@ interface EntityCommitFactoryAccess {
     create<I, S extends Message>(factory: StorageFactory, input: EntityStorageInput<I, S>): EntityCommitStorage;
 }
 /**
- * Provides the typed internal lookup for provider-managed atomic commit handles.
+ * Provides the typed internal lookup for provider-managed Entity commit handles.
  *
  * Provider adapters register their creator while constructing their factory;
  * the end-user storage root deliberately exposes no commit-construction method.

package/dist/internal/entity-commit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-commit.d.ts","sourceRoot":"","sources":["../../src/internal/entity-commit.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO;IAGrD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;CACpC;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAGlC;;;;;;;OAOG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAGzC;;;;;;;OAOG;IACH,yBAAyB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAC5C,KAAK,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC9B,mBAAmB,CAAC;CACxB;AAED;;GAEG;AACH,UAAU,yBAAyB;IAGjC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAE7E;;;;;;;;OAQG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EACzB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC9B,mBAAmB,CAAC;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,yBAuBzC,CAAC"}
+{"version":3,"file":"entity-commit.d.ts","sourceRoot":"","sources":["../../src/internal/entity-commit.ts"],"names":[],"mappings":"AAcA,OAAO,EAAS,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAGpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO;IAGrD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;CACpC;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC;IAC3C;;;;;;;OAOG;IACH,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACxF,CAiCC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAGlC;;;;;;;OAOG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAGzC;;;;;;;OAOG;IACH,yBAAyB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EAC5C,KAAK,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC9B,mBAAmB,CAAC;CACxB;AAED;;GAEG;AACH,UAAU,yBAAyB;IAGjC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAE7E;;;;;;;;OAQG;IACH,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EACzB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC9B,mBAAmB,CAAC;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,yBAuBzC,CAAC"}

package/dist/internal/entity-commit.js

@@ -11,8 +11,51 @@
  * or implied. See the License for the specific language governing permissions and limitations under
  * the License.
  */
+import { clone } from "@bufbuild/protobuf";
+import { EventSchema } from "@spine-event-engine/proto";
+import { EntityRecordSchema } from "@spine-event-engine/proto/generated/spine/server/entity/entity_pb.js";
+import { TenantBoundary } from "./tenancy.js";
 /**
- * Provides the typed internal lookup for provider-managed atomic commit handles.
+ * Captures prepared Entity records before provider I/O or a bounded retry.
+ *
+ * Every retry reuses the same Entity ID, versions, and Event IDs; providers
+ * never invoke the application handler to prepare a second mutation.
+ */
+export const EntityCommitSnapshots = Object.freeze({
+    // prettier-ignore
+    /**
+     * Copies one mutation and its tenant boundary before the first await.
+     *
+     * @typeParam I Entity identifier type.
+     * @typeParam S Entity state type.
+     * @param input Supplies the prepared mutation.
+     * @returns Independent records for every provider attempt.
+     */
+    capture(input) {
+        const boundary = TenantBoundary.of(input.context);
+        const context = boundary.tenantId === undefined
+            ? { name: input.context.name, multitenant: false }
+            : { name: input.context.name, multitenant: true, tenantId: boundary.tenantId };
+        return {
+            ...input,
+            context,
+            entity: { ...input.entity, context },
+            entityId: input.entity.id.clone(input.entityId),
+            next: clone(EntityRecordSchema, input.next),
+            ...(input.states === undefined
+                ? {}
+                : { states: input.states.map((record) => clone(EntityRecordSchema, record)) }),
+            ...(input.diagnostics === undefined
+                ? {}
+                : { diagnostics: input.diagnostics.map((event) => clone(EventSchema, event)) }),
+            ...(input.events === undefined
+                ? {}
+                : { events: input.events.map((event) => clone(EventSchema, event)) }),
+        };
+    },
+});
+/**
+ * Provides the typed internal lookup for provider-managed Entity commit handles.
  *
  * Provider adapters register their creator while constructing their factory;
  * the end-user storage root deliberately exposes no commit-construction method.
@@ -33,7 +76,7 @@ export const EntityCommitStorageFactories = Object.freeze({
     create(factory, input) {
         const creator = creators.get(factory);
         if (creator === undefined)
-            throw new Error("StorageFactory does not provide the required atomic Entity commit storage.");
+            throw new Error("StorageFactory does not provide the required Entity commit storage.");
         return creator.createEntityCommitStorage(input);
     },
 });

package/dist/internal/entity-commit.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity-commit.js","sourceRoot":"","sources":["../../src/internal/entity-commit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqIH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAA8B,MAAM,CAAC,MAAM,CAAC;IACnF,QAAQ,CAAC,OAAuB,EAAE,OAAmC;QACnE,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CACJ,OAAuB,EACvB,KAA+B;QAE/B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,OAAO,KAAK,SAAS;YACvB,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;QAChG,OAAO,OAAO,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,IAAI,OAAO,EAA8C,CAAC"}
+{"version":3,"file":"entity-commit.js","sourceRoot":"","sources":["../../src/internal/entity-commit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,EAAgB,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAc,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sEAAsE,CAAC;AAM1G,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAqD9C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAU7B,MAAM,CAAC,MAAM,CAAC;IACjB,kBAAkB;IAElB;;;;;;;OAOG;IACH,OAAO,CAAuB,KAA8B;QAC1D,MAAM,QAAQ,GAAG,cAAc,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,OAAO,GAAmB,QAAQ,CAAC,QAAQ,KAAK,SAAS;YAC7D,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE;YAClD,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACjF,OAAO;YACL,GAAG,KAAK;YACR,OAAO;YACP,MAAM,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE;YACpC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC/C,IAAI,EAAE,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,IAAI,CAAC;YAC3C,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS;gBAC5B,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YAChF,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS;gBACjC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;YACjF,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS;gBAC5B,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;SACxE,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AA4EH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAA8B,MAAM,CAAC,MAAM,CAAC;IACnF,QAAQ,CAAC,OAAuB,EAAE,OAAmC;QACnE,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CACJ,OAAuB,EACvB,KAA+B;QAE/B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,OAAO,KAAK,SAAS;YACvB,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QACzF,OAAO,OAAO,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,IAAI,OAAO,EAA8C,CAAC"}

package/dist/internal/entity-history.d.ts

@@ -6,7 +6,18 @@ export type { EntityEventHistoryPort, EntityStateHistoryPort, } from "../entity/
 export { disabledEventHistoryPort, disabledStateHistoryPort, } from "../entity/entity-history-storage.js";
 export type { EntityRecord, EntityRecordStorage } from "../entity/entity-record.js";
 export { eventHistorySpec, stateHistorySpec } from "../entity/entity-history-record-spec.js";
+export { AgentHistoryRecords } from "../entity/agent-history-record-spec.js";
+export { AgentExecutionRecords } from "../entity/agent-execution-record-spec.js";
+export { AgentExecutionSizes } from "../entity/agent-execution-sizes.js";
+export { AgentExecutionTransitions } from "../entity/agent-execution-transitions.js";
+export { AgentExecutionValues } from "../entity/agent-execution-values.js";
+export { AgentHistoryPages } from "../entity/agent-history-provider-page.js";
 export { EntityHistoryConformance, type EntityHistoryConformanceAdapter, type EntityStorageConformance, } from "../entity/history-conformance.js";
 export type { EntityIdCodec, EntityStorageInput } from "../memory/in-memory-entity-history.js";
+export { AgentHistoryKeys, type AgentHistoryOrderKey, type AgentHistoryView, type AgentHistoryStorageInput, type AgentHistoryRead, type AgentHistoryPage, type AgentHistoryStorage, } from "../entity/agent-history.js";
+export { AgentHistoryStorageFactories, type AgentHistoryStorageFactory } from "./agent-history.js";
+export { AgentExecutionStorageFactories, type AgentExecutionStorageFactory, } from "./agent-execution.js";
+export type { AgentExecutionStorage, AgentExecutionCapacity, AgentExecutionStorageInput, AgentExecutionClaim, AgentExecutionUpdate, AgentExecutionComplete, AgentPendingRead, AgentPendingKey, AgentPendingCursor, AgentPendingPage, } from "../entity/agent-execution.js";
+export { AgentHistoryConformance, type AgentHistoryConformanceAdapter, } from "../entity/agent-history-conformance.js";
 export type { EntityCommitInput, EntityCommitStorage, EntityCommitStorageFactory, } from "./entity-commit.js";
 //# sourceMappingURL=entity-history.d.ts.map

package/dist/internal/entity-history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-history.d.ts","sourceRoot":"","sources":["../../src/internal/entity-history.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,YAAY,EACV,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EACL,wBAAwB,EACxB,KAAK,+BAA+B,EACpC,KAAK,wBAAwB,GAC9B,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC/F,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"entity-history.d.ts","sourceRoot":"","sources":["../../src/internal/entity-history.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,YAAY,EACV,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EACL,wBAAwB,EACxB,KAAK,+BAA+B,EACpC,KAAK,wBAAwB,GAC9B,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC/F,OAAO,EACL,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,4BAA4B,EAAE,KAAK,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACnG,OAAO,EACL,8BAA8B,EAC9B,KAAK,4BAA4B,GAClC,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,uBAAuB,EACvB,KAAK,8BAA8B,GACpC,MAAM,wCAAwC,CAAC;AAChD,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC"}

package/dist/internal/entity-history.js

@@ -13,5 +13,15 @@
  */
 export { disabledEventHistoryPort, disabledStateHistoryPort, } from "../entity/entity-history-storage.js";
 export { eventHistorySpec, stateHistorySpec } from "../entity/entity-history-record-spec.js";
+export { AgentHistoryRecords } from "../entity/agent-history-record-spec.js";
+export { AgentExecutionRecords } from "../entity/agent-execution-record-spec.js";
+export { AgentExecutionSizes } from "../entity/agent-execution-sizes.js";
+export { AgentExecutionTransitions } from "../entity/agent-execution-transitions.js";
+export { AgentExecutionValues } from "../entity/agent-execution-values.js";
+export { AgentHistoryPages } from "../entity/agent-history-provider-page.js";
 export { EntityHistoryConformance, } from "../entity/history-conformance.js";
+export { AgentHistoryKeys, } from "../entity/agent-history.js";
+export { AgentHistoryStorageFactories } from "./agent-history.js";
+export { AgentExecutionStorageFactories, } from "./agent-execution.js";
+export { AgentHistoryConformance, } from "../entity/agent-history-conformance.js";
 //# sourceMappingURL=entity-history.js.map

package/dist/internal/entity-history.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity-history.js","sourceRoot":"","sources":["../../src/internal/entity-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EACL,wBAAwB,GAGzB,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"entity-history.js","sourceRoot":"","sources":["../../src/internal/entity-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EACL,wBAAwB,GAGzB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,gBAAgB,GAOjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,4BAA4B,EAAmC,MAAM,oBAAoB,CAAC;AACnG,OAAO,EACL,8BAA8B,GAE/B,MAAM,sBAAsB,CAAC;AAa9B,OAAO,EACL,uBAAuB,GAExB,MAAM,wCAAwC,CAAC"}

package/dist/internal/event-store.d.ts

@@ -4,5 +4,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 { eventStoreRecordSpec } from "../event/event-store.js";
 //# sourceMappingURL=event-store.d.ts.map

package/dist/internal/event-store.d.ts.map

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

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 { eventStoreRecordSpec } 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,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/internal/tenancy.d.ts

@@ -33,7 +33,7 @@ interface TenantBoundaryFactory {
      */
     from(tenantId: TenantId): MultitenantTenantBoundary;
     /**
-     * Selects the boundary declared by a storage context.
+     * Validates a storage context and returns its complete tenant boundary.
      *
      * @param context The storage context.
      * @returns The validated tenant boundary.
@@ -46,6 +46,85 @@ interface TenantBoundaryFactory {
  * @internal
  */
 export declare const TenantBoundary: TenantBoundaryFactory;
+/**
+ * Opaque continuation issued by one provider catalog instance.
+ */
+export interface TenantCatalogCursor {
+    /**
+     * Identifies an opaque in-process catalog continuation.
+     */
+    readonly [Symbol.toStringTag]: "TenantCatalogCursor";
+}
+/**
+ * Structural cancellation accepted from a platform AbortSignal.
+ */
+export interface TenantCatalogSignal {
+    /**
+     * Whether cancellation has already been requested.
+     */
+    readonly aborted: boolean;
+    /**
+     * Throws when cancellation has been requested.
+     */
+    throwIfAborted(): void;
+    /**
+     * Observes one cancellation notification.
+     *
+     * @param type Abort event name.
+     * @param onAbort Callback notified on cancellation.
+     * @param options One-shot listener selection.
+     */
+    addEventListener(type: "abort", onAbort: () => void, options?: {
+        once?: boolean;
+    }): void;
+    /**
+     * Removes a previously registered cancellation listener.
+     *
+     * @param type Abort event name.
+     * @param onAbort Callback to remove.
+     */
+    removeEventListener(type: "abort", onAbort: () => void): void;
+}
+/**
+ * Bounded provider tenant-page request.
+ */
+export interface TenantCatalogRead {
+    /**
+     * Positive safe page size bounding native candidates.
+     */
+    readonly count: number;
+    /**
+     * Cancels discovery before native work and before results become visible.
+     */
+    readonly signal: TenantCatalogSignal;
+    /**
+     * Continuation issued by this same catalog instance.
+     */
+    readonly after?: TenantCatalogCursor;
+}
+/**
+ * One finite tenant-catalog page.
+ */
+export interface TenantCatalogPage {
+    /**
+     * Complete boundaries selected from this page's native candidates.
+     */
+    readonly boundaries: readonly TenantBoundary[];
+    /**
+     * Continuation when more candidates remain.
+     */
+    readonly after?: TenantCatalogCursor;
+    /**
+     * Whether another page belongs to this finite sweep.
+     */
+    readonly hasMore: boolean;
+}
+/**
+ * Validates common finite-page limits for provider catalogs.
+ */
+export declare const TenantCatalogReads: Readonly<{
+    require(request: TenantCatalogRead): void;
+}>;
 /**
  * Provider-owned enumeration of storage tenant boundaries.
  *
@@ -58,6 +137,13 @@ export interface TenantCatalog {
      * @returns The available tenant boundaries.
      */
     all(): Promise<readonly TenantBoundary[]>;
+    /**
+     * Reads at most the requested number of native candidates per page.
+     *
+     * @param request Finite page request and opaque continuation.
+     * @returns A possibly empty continuing page or terminal page.
+     */
+    page(request: TenantCatalogRead): Promise<TenantCatalogPage>;
     /**
      * Closes resources owned by this catalog.
      *

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;AA0CF;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAG5B;;;;OAIG;IACH,GAAG,IAAI,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;IAE1C;;;;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":"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"}