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

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"}

package/dist/internal/tenancy.js

@@ -60,21 +60,39 @@ export const TenantBoundary = {
     },
 };
 Object.freeze(TenantBoundary);
+/**
+ * Clones and validates a complete multitenant identifier.
+ */
 class MultitenantBoundary {
     #tenantId;
     key;
     single = false;
+    /**
+     * Stores one validated tenant identity.
+     *
+     * @param tenantId Complete generated tenant identifier.
+     */
     constructor(tenantId) {
         TenantIds.require(tenantId);
         this.#tenantId = clone(TenantIdSchema, tenantId);
         this.key = TenantIds.key(this.#tenantId);
         Object.freeze(this);
     }
+    /**
+     * Returns a detached complete tenant identifier.
+     *
+     * @returns The cloned generated tenant identifier.
+     */
     get tenantId() {
         return clone(TenantIdSchema, this.#tenantId);
     }
 }
 const TenantIds = Object.freeze({
+    /**
+     * Rejects an empty or unspecified generated tenant identifier.
+     *
+     * @param tenantId Identifier to validate.
+     */
     require(tenantId) {
         const kind = tenantId.kind;
         const value = kind.case === "value"
@@ -86,6 +104,12 @@ const TenantIds = Object.freeze({
             throw new Error("Multitenant storage requires a non-empty TenantId.");
         }
     },
+    /**
+     * Encodes the complete generated tenant identifier as a map key.
+     *
+     * @param tenantId Identifier to encode.
+     * @returns Hexadecimal Protobuf bytes without unknown fields.
+     */
     key(tenantId) {
         const bytes = toBinary(TenantIdSchema, tenantId, { writeUnknownFields: false });
         let encoded = "";
@@ -94,4 +118,19 @@ const TenantIds = Object.freeze({
         return encoded;
     },
 });
+/**
+ * Validates common finite-page limits for provider catalogs.
+ */
+export const TenantCatalogReads = Object.freeze({
+    /**
+     * Rejects invalid page bounds or cancellation.
+     *
+     * @param request Requested finite page.
+     */
+    require(request) {
+        if (!Number.isSafeInteger(request.count) || request.count < 1)
+            throw new RangeError("Tenant catalog count must be a positive safe integer.");
+        request.signal.throwIfAborted();
+    },
+});
 //# sourceMappingURL=tenancy.js.map

package/dist/internal/tenancy.js.map

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

package/dist/memory/agent-execution-head-index.d.ts

@@ -0,0 +1,52 @@
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import { type AgentExecutionHead } from "@spine-event-engine/proto/generated/spine/server/agent/execution_record_pb.js";
+/**
+ * One complete observed head-index entry.
+ */
+export interface MemoryPendingHead {
+    /**
+     * Complete native-equivalent order key.
+     */
+    readonly orderKey: string;
+    /**
+     * Independent head snapshot at the page read.
+     */
+    readonly head: AgentExecutionHead;
+}
+/**
+ * Keeps one ordered discovery entry per Agent instance.
+ */
+export declare class MemoryPendingHeadIndex {
+    #private;
+    /**
+     * Replaces the visible entry for one complete Agent scope.
+     *
+     * @param head Per-instance pending and lease record.
+     * @param scope Generated state type and Agent key.
+     */
+    set(scope: string, head: AgentExecutionHead): void;
+    /**
+     * Reads no more than count plus one candidate before the fixed cutoff.
+     *
+     * @param after Observed pending-page cursor.
+     * @param asOf Fixed eligibility cutoff for the page.
+     * @param count Maximum number of records in the page.
+     * @returns Ordered bounded per-instance head entries.
+     */
+    page(after: string | undefined, asOf: Timestamp, count: number): readonly MemoryPendingHead[];
+    /**
+     * Finds the first index entry whose key is not smaller than value.
+     *
+     * @param value Value read from a provider boundary.
+     * @returns First matching index position.
+     */
+    private lower;
+    /**
+     * Finds the first index entry strictly after the cursor.
+     *
+     * @param value Value read from a provider boundary.
+     * @returns Position after the last matching index entry.
+     */
+    private upper;
+}
+//# sourceMappingURL=agent-execution-head-index.d.ts.map

package/dist/memory/agent-execution-head-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-execution-head-index.d.ts","sourceRoot":"","sources":["../../src/memory/agent-execution-head-index.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,+EAA+E,CAAC;AAIvF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;CACnC;AAED;;GAEG;AACH,qBAAa,sBAAsB;;IAKjC;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI;IAelD;;;;;;;OAOG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,iBAAiB,EAAE;IAM7F;;;;;OAKG;IACH,OAAO,CAAC,KAAK;IAab;;;;;OAKG;IACH,OAAO,CAAC,KAAK;CAKd"}

package/dist/memory/agent-execution-head-index.js

@@ -0,0 +1,91 @@
+/*
+ * 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.
+ */
+import { fromBinary, toBinary } from "@bufbuild/protobuf";
+import { AgentExecutionHeadSchema, } from "@spine-event-engine/proto/generated/spine/server/agent/execution_record_pb.js";
+import { AgentExecutionRecords } from "../entity/agent-execution-record-spec.js";
+/**
+ * Keeps one ordered discovery entry per Agent instance.
+ */
+export class MemoryPendingHeadIndex {
+    #byScope = new Map();
+    #ordered = [];
+    /**
+     * Replaces the visible entry for one complete Agent scope.
+     *
+     * @param head Per-instance pending and lease record.
+     * @param scope Generated state type and Agent key.
+     */
+    set(scope, head) {
+        const previous = this.#byScope.get(scope);
+        if (previous !== undefined)
+            this.#ordered.splice(this.lower(previous.orderKey), 1);
+        if (head.pending === undefined || head.eligibleAt === undefined || head.scope === undefined) {
+            this.#byScope.delete(scope);
+            return;
+        }
+        const entry = {
+            orderKey: AgentExecutionRecords.pendingKey(head.eligibleAt, head.scope),
+            head: fromBinary(AgentExecutionHeadSchema, toBinary(AgentExecutionHeadSchema, head)),
+        };
+        this.#ordered.splice(this.lower(entry.orderKey), 0, entry);
+        this.#byScope.set(scope, entry);
+    }
+    /**
+     * Reads no more than count plus one candidate before the fixed cutoff.
+     *
+     * @param after Observed pending-page cursor.
+     * @param asOf Fixed eligibility cutoff for the page.
+     * @param count Maximum number of records in the page.
+     * @returns Ordered bounded per-instance head entries.
+     */
+    page(after, asOf, count) {
+        const start = after === undefined ? 0 : this.upper(after);
+        const end = this.lower(AgentExecutionRecords.pendingLower(asOf));
+        return this.#ordered.slice(start, Math.min(end, start + count + 1));
+    }
+    /**
+     * Finds the first index entry whose key is not smaller than value.
+     *
+     * @param value Value read from a provider boundary.
+     * @returns First matching index position.
+     */
+    lower(value) {
+        let left = 0;
+        let right = this.#ordered.length;
+        while (left < right) {
+            const middle = (left + right) >>> 1;
+            const entry = this.#ordered[middle];
+            if (entry === undefined)
+                throw new Error("Agent head index position is missing.");
+            if (entry.orderKey < value)
+                left = middle + 1;
+            else
+                right = middle;
+        }
+        return left;
+    }
+    /**
+     * Finds the first index entry strictly after the cursor.
+     *
+     * @param value Value read from a provider boundary.
+     * @returns Position after the last matching index entry.
+     */
+    upper(value) {
+        let left = this.lower(value);
+        while (this.#ordered[left]?.orderKey === value)
+            left += 1;
+        return left;
+    }
+}
+//# sourceMappingURL=agent-execution-head-index.js.map

package/dist/memory/agent-execution-head-index.js.map

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

package/dist/memory/agent-history-index.d.ts

@@ -0,0 +1,49 @@
+import { type AgentHistoryEntry } from "@spine-event-engine/proto/agent";
+import { type AgentHistoryOrderKey, type AgentHistoryPage, type AgentHistoryView } from "../entity/agent-history.js";
+/**
+ * A validated batch applied and restored within a fenced mutation.
+ */
+export interface AgentHistoryUpdate {
+    /**
+     * The retained index receiving the new rows.
+     */
+    readonly index: AgentHistoryIndex;
+    /**
+     * Adds the validated rows once.
+     */
+    apply(): void;
+    /**
+     * Removes only rows added by this batch.
+     */
+    restore(): void;
+}
+/**
+ * Maintains ordered category and conversation indexes for one Agent ID.
+ */
+export declare class AgentHistoryIndex {
+    #private;
+    /**
+     * Validates and serializes only the new entries before a fenced mutation.
+     *
+     * @param entries Entries to append after the containing write is accepted.
+     * @returns A reversible batch without copying retained rows.
+     */
+    withEntries(entries: readonly AgentHistoryEntry[]): AgentHistoryUpdate;
+    /**
+     * Adds an immutable entry to its indexed views.
+     *
+     * @param entry Complete Proto history record.
+     */
+    append(entry: AgentHistoryEntry): void;
+    /**
+     * Reads the selected index after a complete ordering key.
+     *
+     * @param view Full, category, or conversation selection.
+     * @param after Last returned complete key, when continuing.
+     * @param count Maximum returned records.
+     * @param maxBytes Maximum serialized wrapper bytes.
+     * @returns Bounded independent entries and continuation flag.
+     */
+    read(view: AgentHistoryView, after: AgentHistoryOrderKey | undefined, count: number, maxBytes: number | undefined): AgentHistoryPage;
+}
+//# sourceMappingURL=agent-history-index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-history-index.d.ts","sourceRoot":"","sources":["../../src/memory/agent-history-index.ts"],"names":[],"mappings":"AAeA,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAElG,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AAUpC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAElC;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,iBAAiB;;IAW5B;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,GAAG,kBAAkB;IAmCtE;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IA8DtC;;;;;;;;OAQG;IACH,IAAI,CACF,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,oBAAoB,GAAG,SAAS,EACvC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,gBAAgB;CAwFpB"}

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

@@ -0,0 +1,239 @@
+/*
+ * 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.
+ */
+import { fromBinary, toBinary } from "@bufbuild/protobuf";
+import { AgentHistoryEntrySchema } from "@spine-event-engine/proto/agent";
+import { AgentHistoryKeys, } from "../entity/agent-history.js";
+/**
+ * Maintains ordered category and conversation indexes for one Agent ID.
+ */
+export class AgentHistoryIndex {
+    #all = [];
+    #system = [];
+    #domain = [];
+    #conversations = new Map();
+    #byIdentity = new Map();
+    /**
+     * Validates and serializes only the new entries before a fenced mutation.
+     *
+     * @param entries Entries to append after the containing write is accepted.
+     * @returns A reversible batch without copying retained rows.
+     */
+    withEntries(entries) {
+        const additions = [];
+        const pending = new Map();
+        for (const entry of entries) {
+            const indexed = this.#indexed(entry);
+            const existing = pending.get(indexed.identity) ?? this.#byIdentity.get(indexed.identity);
+            if (existing !== undefined) {
+                if (!this.#sameBytes(existing.bytes, indexed.bytes))
+                    throw new Error("Agent history record ID conflicts with immutable content.");
+                continue;
+            }
+            pending.set(indexed.identity, indexed);
+            additions.push(indexed);
+        }
+        let applied = false;
+        return {
+            index: this,
+            apply: () => {
+                if (applied)
+                    return;
+                try {
+                    for (const indexed of additions)
+                        this.#appendIndexed(indexed);
+                    applied = true;
+                }
+                catch (error) {
+                    for (const indexed of additions)
+                        this.#removeIndexed(indexed);
+                    throw error;
+                }
+            },
+            restore: () => {
+                if (!applied)
+                    return;
+                for (const indexed of additions)
+                    this.#removeIndexed(indexed);
+                applied = false;
+            },
+        };
+    }
+    /**
+     * Adds an immutable entry to its indexed views.
+     *
+     * @param entry Complete Proto history record.
+     */
+    append(entry) {
+        this.withEntries([entry]).apply();
+    }
+    /**
+     * Serializes one entry after checking its complete history identity.
+     *
+     * @param entry Complete history entry.
+     * @returns Immutable indexed row.
+     */
+    #indexed(entry) {
+        const key = AgentHistoryKeys.fromEntry(entry);
+        const indexKey = AgentHistoryKeys.indexValue(key);
+        const bytes = toBinary(AgentHistoryEntrySchema, entry);
+        const identity = `${key.category}:${key.recordId}`;
+        const conversation = entry.item.case === "conversationRecord" ? entry.item.value.conversation?.value : undefined;
+        if (key.category === "conversation" && conversation === undefined)
+            throw new TypeError("Conversation history requires a ConversationId.");
+        return {
+            indexKey,
+            identity,
+            category: key.category,
+            ...(conversation === undefined ? {} : { conversation }),
+            bytes,
+        };
+    }
+    /**
+     * Adds one already validated immutable entry to its indexed views.
+     *
+     * @param indexed Serialized row to append.
+     */
+    #appendIndexed(indexed) {
+        this.#byIdentity.set(indexed.identity, indexed);
+        this.#insert(this.#all, indexed);
+        if (indexed.category === "system")
+            this.#insert(this.#system, indexed);
+        if (indexed.category === "domain")
+            this.#insert(this.#domain, indexed);
+        if (indexed.conversation !== undefined)
+            this.#insert(this.#conversation(indexed.conversation), indexed);
+    }
+    /**
+     * Reverses only rows appended by a failed containing mutation.
+     *
+     * @param indexed Serialized row to remove.
+     */
+    #removeIndexed(indexed) {
+        if (this.#byIdentity.get(indexed.identity) !== indexed)
+            return;
+        this.#byIdentity.delete(indexed.identity);
+        this.#remove(this.#all, indexed);
+        if (indexed.category === "system")
+            this.#remove(this.#system, indexed);
+        if (indexed.category === "domain")
+            this.#remove(this.#domain, indexed);
+        if (indexed.conversation !== undefined) {
+            const records = this.#conversations.get(indexed.conversation);
+            if (records !== undefined) {
+                this.#remove(records, indexed);
+                if (records.length === 0)
+                    this.#conversations.delete(indexed.conversation);
+            }
+        }
+    }
+    /**
+     * Reads the selected index after a complete ordering key.
+     *
+     * @param view Full, category, or conversation selection.
+     * @param after Last returned complete key, when continuing.
+     * @param count Maximum returned records.
+     * @param maxBytes Maximum serialized wrapper bytes.
+     * @returns Bounded independent entries and continuation flag.
+     */
+    read(view, after, count, maxBytes) {
+        const records = this.#view(view);
+        const start = after === undefined
+            ? records.length - 1
+            : this.#firstNotOlder(records, AgentHistoryKeys.indexValue(after)) - 1;
+        const entries = [];
+        let bytes = 0;
+        let index = start;
+        while (index >= 0 && entries.length < count) {
+            const record = records[index];
+            if (record === undefined)
+                throw new Error("Agent history index changed during read.");
+            if (maxBytes !== undefined && record.bytes.length > maxBytes - bytes) {
+                if (entries.length === 0)
+                    throw new RangeError("Agent history first entry exceeds maxBytes.");
+                break;
+            }
+            entries.push(fromBinary(AgentHistoryEntrySchema, record.bytes));
+            bytes += record.bytes.length;
+            index -= 1;
+        }
+        return { entries: Object.freeze(entries), hasMore: index >= 0 };
+    }
+    /**
+     * Selects one already ordered index without scanning unrelated categories.
+     */
+    #view(view) {
+        if (view.kind === "full")
+            return this.#all;
+        if (view.kind === "system")
+            return this.#system;
+        if (view.kind === "domain")
+            return this.#domain;
+        if (view.conversation.value.length === 0)
+            throw new TypeError("Conversation history requires a ConversationId.");
+        return this.#conversations.get(view.conversation.value) ?? [];
+    }
+    /**
+     * Finds or creates the ordered index for one conversation.
+     */
+    #conversation(id) {
+        let records = this.#conversations.get(id);
+        if (records === undefined) {
+            records = [];
+            this.#conversations.set(id, records);
+        }
+        return records;
+    }
+    /**
+     * Inserts one immutable record at its sorted position.
+     */
+    #insert(records, entry) {
+        records.splice(this.#firstNotOlder(records, entry.indexKey), 0, entry);
+    }
+    /**
+     * Removes one exact indexed row when its containing mutation restores.
+     *
+     * @param records Ordered view to update.
+     * @param entry Exact appended row.
+     */
+    #remove(records, entry) {
+        const index = records.indexOf(entry);
+        if (index >= 0)
+            records.splice(index, 1);
+    }
+    /**
+     * Finds the first record strictly after the complete key.
+     */
+    #firstNotOlder(records, key) {
+        let low = 0;
+        let high = records.length;
+        while (low < high) {
+            const middle = Math.floor((low + high) / 2);
+            const candidate = records[middle];
+            if (candidate === undefined)
+                throw new Error("Agent history index changed during search.");
+            if (candidate.indexKey > key)
+                low = middle + 1;
+            else
+                high = middle;
+        }
+        return low;
+    }
+    /**
+     * Compares immutable serialized Proto bytes.
+     */
+    #sameBytes(first, second) {
+        return first.length === second.length && first.every((byte, index) => byte === second[index]);
+    }
+}
+//# sourceMappingURL=agent-history-index.js.map

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

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