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

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

@@ -1,51 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,53 +0,0 @@
-/*
- * 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

@@ -1 +0,0 @@
-{"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/memory/agent-execution-head-index.d.ts

@@ -1,52 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,91 +0,0 @@
-/*
- * 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

@@ -1 +0,0 @@
-{"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/in-memory-agent-execution.d.ts

@@ -1,21 +0,0 @@
-import { type Message } from "@bufbuild/protobuf";
-import type { AgentExecutionStorage, AgentExecutionStorageInput } from "../entity/agent-execution.js";
-import { InMemoryStorageBackend } from "./in-memory-storage-backend.js";
-import type { StorageFactory } from "../storage/storage-factory.js";
-/**
- * Opens a shared in-memory execution family within a complete tenant boundary.
- */
-export declare const MemoryAgentExecution: {
-    /**
-     * Opens a closeable Agent execution handle.
-     *
-     * @typeParam I Typed Agent identifier.
-     * @typeParam S Generated Agent state.
-     * @param backend Shared memory backend.
-     * @param factory Storage factory supplying Entity commits.
-     * @param input Agent repository and state type.
-     * @returns Closeable provider handle.
-     */
-    open<I, S extends Message>(backend: InMemoryStorageBackend, factory: StorageFactory, input: AgentExecutionStorageInput<I, S>): AgentExecutionStorage<I, S>;
-};
-//# sourceMappingURL=in-memory-agent-execution.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"in-memory-agent-execution.d.ts","sourceRoot":"","sources":["../../src/memory/in-memory-agent-execution.ts"],"names":[],"mappings":"AAcA,OAAO,EAA2B,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAiB3E,OAAO,KAAK,EAGV,qBAAqB,EACrB,0BAA0B,EAI3B,MAAM,8BAA8B,CAAC;AAQtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AA4BpE;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;;;;;;;;OASG;SACE,CAAC,EAAE,CAAC,SAAS,OAAO,WACd,sBAAsB,WACtB,cAAc,SAChB,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,GACtC,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC;CA0B/B,CAAC"}