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

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

@@ -1,234 +0,0 @@
-import type { Message } from "@bufbuild/protobuf";
-import type { Timestamp } from "@bufbuild/protobuf/wkt";
-import type { AgentHistoryEntry, ModelPreference } from "@spine-event-engine/proto/agent";
-import type { AgentAcceptedInvocation, AgentExecutionRecord, AgentExecutionScope, AgentInvocationKey, AgentSignalKey } from "@spine-event-engine/proto/generated/spine/server/agent/execution_record_pb.js";
-import type { EntityCommitInput } from "../internal/entity-commit.js";
-import type { EntityStorageInput } from "../internal/entity-history.js";
-/**
- * Defines one Agent repository scope for a provider handle.
- *
- * @typeParam I Typed Agent identifier.
- * @typeParam S Generated Agent state.
- */
-export interface AgentExecutionStorageInput<I, S extends Message> {
-    /**
-     * Entity layout and complete tenant boundary used by conditional completion.
-     */
-    readonly entity: EntityStorageInput<I, S>;
-    /**
-     * Generated Agent state type named in every execution scope.
-     */
-    readonly stateType: string;
-}
-/**
- * Selects a bounded page of provider-observed candidate heads in one Agent state type.
- */
-export interface AgentPendingRead {
-    /**
-     * Provider-observed continuation and fixed time boundary from the preceding page.
-     */
-    readonly after?: AgentPendingCursor;
-    /**
-     * Maximum number of observed candidates returned.
-     */
-    readonly count: number;
-}
-/**
- * Orders observed candidate heads without allocating a history position.
- */
-export interface AgentPendingKey {
-    /**
-     * Complete Agent instance identity.
-     */
-    readonly scope: AgentExecutionScope;
-    /**
-     * Provider time at which this instance became eligible.
-     */
-    readonly eligibleAt: Timestamp;
-}
-/**
- * Fixed sweep time and complete index key observed by a provider page.
- */
-export interface AgentPendingCursor {
-    /**
-     * Time sampled once when the sweep began.
-     */
-    readonly asOf: Timestamp;
-    /**
-     * Last examined head index key, before any concurrent mutation.
-     */
-    readonly key: AgentPendingKey;
-}
-/**
- * Returns detached records for observed candidates and their continuation.
- * A concurrent mutation can make a record stale; claim decides whether work is current.
- */
-export interface AgentPendingPage {
-    /**
-     * Candidate records observed through the pending-head index.
-     */
-    readonly records: readonly AgentExecutionRecord[];
-    /**
-     * Last examined provider index key; advance it even when no claim succeeds.
-     */
-    readonly after?: AgentPendingCursor;
-    /**
-     * Whether another indexed candidate was observed during this page read.
-     */
-    readonly hasMore: boolean;
-}
-/**
- * Provides a claimed record and queryable current model preferences.
- */
-export interface AgentExecutionClaim {
-    /**
-     * Complete claimed execution record.
-     */
-    readonly record: AgentExecutionRecord;
-    /**
-     * Current per-instance preferences at the claim boundary.
-     */
-    readonly preferences: readonly ModelPreference[];
-}
-/**
- * Replaces one fenced execution record and appends its conversation or System history.
- */
-export interface AgentExecutionUpdate {
-    /**
-     * Exact accepted invocation identity.
-     */
-    readonly key: AgentInvocationKey;
-    /**
-     * Exclusive token granted by the current per-instance claim.
-     */
-    readonly token: string;
-    /**
-     * Exact binary image read before constructing this update.
-     */
-    readonly expectedRecordBytes: Uint8Array;
-    /**
-     * Complete next record with immutable acceptance unchanged.
-     */
-    readonly next: AgentExecutionRecord;
-    /**
-     * Original conversation or System entries committed with the journal.
-     */
-    readonly historyEntries?: readonly AgentHistoryEntry[];
-}
-/**
- * Commits an Agent transition and its fenced execution record together.
- *
- * @typeParam I Typed Agent identifier.
- * @typeParam S Generated Agent state.
- */
-export interface AgentExecutionComplete<I, S extends Message> extends AgentExecutionUpdate {
-    /**
-     * Current-state and framework history mutation; absent for a no-op.
-     */
-    readonly entityCommit?: EntityCommitInput<I, S>;
-}
-/**
- * Native serialized payload bounds available before model or tool dispatch.
- *
- * Every limit applies to the complete internal Protobuf record, including its
- * scope and metadata. An absent limit means this provider enforces no tighter
- * fixed bound for that record.
- */
-export interface AgentExecutionCapacity {
-    /**
-     * Maximum serialized AgentExecutionRecord bytes.
-     */
-    readonly executionRecordBytes?: number;
-    /**
-     * Maximum serialized AgentExecutionHead bytes.
-     */
-    readonly executionHeadBytes?: number;
-    /**
-     * Maximum serialized AgentHistoryRecord bytes.
-     */
-    readonly historyRecordBytes?: number;
-    /**
-     * Maximum aggregate staged native transaction payload bytes.
-     */
-    readonly transactionPayloadBytes?: number;
-}
-/**
- * Provider-only durable execution capability for one Agent repository scope.
- *
- * @typeParam I Typed Agent identifier.
- * @typeParam S Generated Agent state.
- */
-export interface AgentExecutionStorage<I, S extends Message> {
-    /**
-     * Native bounds used to reject unjournalable work before external dispatch.
-     */
-    readonly capacity: AgentExecutionCapacity;
-    /**
-     * Persists accepted source work before its Inbox handoff is acknowledged.
-     *
-     * @param accepted Exact source envelope and selected handler bindings.
-     * @returns Stored record, accepting an identical repeat only.
-     */
-    admit(accepted: AgentAcceptedInvocation): Promise<AgentExecutionRecord>;
-    /**
-     * Reads bounded, time-eligible unresolved work through a provider index.
-     *
-     * @param request Page count and complete continuation.
-     * @returns Independent records and continuation state.
-     */
-    pending(request: AgentPendingRead): Promise<AgentPendingPage>;
-    /**
-     * Reads a complete execution record after reconstruction.
-     *
-     * @param key Exact source and Agent instance identity.
-     * @returns Stored record, if present.
-     */
-    read(key: AgentInvocationKey): Promise<AgentExecutionRecord | undefined>;
-    /**
-     * Acquires the earliest unresolved invocation with a fresh provider-side time check.
-     *
-     * @param key Exact source and Agent instance identity.
-     * @param token New unpredictable exclusive token.
-     * @param expiresAt Requested claim expiry.
-     * @returns Claimed record and current preferences, if eligible.
-     */
-    claim(key: AgentInvocationKey, token: string, expiresAt: Timestamp): Promise<AgentExecutionClaim | undefined>;
-    /**
-     * Updates the same unexpired token under the per-instance claim lock.
-     *
-     * @param key Exact source and Agent instance identity.
-     * @param token Current exclusive token.
-     * @param expiresAt Requested later expiry.
-     * @returns Whether the current token was renewed.
-     */
-    renew(key: AgentInvocationKey, token: string, expiresAt: Timestamp): Promise<boolean>;
-    /**
-     * Persists fenced budgets, evidence and conversation/System history atomically.
-     *
-     * @param input Expected exact record and next retained evidence.
-     * @returns Completion after fenced evidence is persisted.
-     */
-    update(input: AgentExecutionUpdate): Promise<void>;
-    /**
-     * Persists Entity, history, preferences, execution result and output obligations atomically.
-     *
-     * @param input Expected exact record and complete transition.
-     * @returns Completion after conditional Entity and evidence commit.
-     */
-    complete(input: AgentExecutionComplete<I, S>): Promise<void>;
-    /**
-     * Marks output IDs accepted by normal delivery without rerunning handlers.
-     *
-     * @param key Exact source and Agent instance identity.
-     * @param token Current exclusive token.
-     * @param expectedRecordBytes Exact binary image before acknowledgement.
-     * @param signals Original IDs accepted by delivery.
-     * @returns Completion after original output IDs are marked delivered.
-     */
-    markDelivered(key: AgentInvocationKey, token: string, expectedRecordBytes: Uint8Array, signals: readonly AgentSignalKey[]): Promise<void>;
-    /**
-     * Closes this handle without deleting any persisted work.
-     */
-    close(): void;
-}
-//# sourceMappingURL=agent-execution.d.ts.map

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

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

package/dist/entity/agent-execution.js

@@ -1,15 +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.
- */
-export {};
-//# sourceMappingURL=agent-execution.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"agent-execution.js","sourceRoot":"","sources":["../../src/entity/agent-execution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

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/internal/delivery-cleanup.d.ts

@@ -1,99 +0,0 @@
-import type { Message } from "@bufbuild/protobuf";
-import type { RecordSpec } from "../record/record-spec.js";
-import type { StorageContext } from "../storage/storage.js";
-import type { StorageFactory } from "../storage/storage-factory.js";
-/**
- * Describes cooperative operation state at a provider safe boundary.
- */
-export interface CleanupOperation {
-    /**
-     * Indicates whether cancellation has been requested.
-     */
-    readonly signal?: {
-        readonly aborted: boolean;
-    };
-    /**
-     * Carries the admitted non-negative timeout budget.
-     */
-    readonly timeoutMs?: number;
-    /**
-     * Determines whether the admission-relative deadline remains active.
-     *
-     * @returns Whether provider work remains within its admitted deadline.
-     */
-    readonly isActive?: () => boolean;
-}
-/**
- * Determines whether a cleanup operation may proceed at a provider safe boundary.
- *
- * @param operation Supplies cooperative cancellation and deadline state.
- * @returns Whether provider work may continue.
- */
-export declare function cleanupOperationActive(operation: CleanupOperation | undefined): boolean;
-/**
- * Describes provider input for one fenced exact delivered-row removal.
- */
-export interface DeliveryCleanupInput<InboxId, InboxRecord extends Message, SessionId, SessionRecord extends Message> {
-    /**
-     * Selects the tenant and storage group containing both records.
-     */
-    readonly context: StorageContext;
-    /**
-     * Carries cooperative cancellation and an internal admission-relative activity predicate.
-     */
-    readonly operation?: CleanupOperation;
-    /**
-     * Describes the exact delivered Inbox record expected for deletion.
-     */
-    readonly inbox: {
-        readonly spec: RecordSpec<InboxId, InboxRecord>;
-        readonly id: InboxId;
-        readonly expected: InboxRecord;
-    };
-    /**
-     * Describes the current shard-session record that fences deletion.
-     */
-    readonly session: {
-        readonly spec: RecordSpec<SessionId, SessionRecord>;
-        readonly id: SessionId;
-        readonly expected: SessionRecord;
-        readonly isCurrent: (record: SessionRecord) => boolean;
-    };
-}
-/**
- * Defines a provider-owned handle for atomically deleting a fenced Inbox record.
- */
-export interface DeliveryCleanupStorage {
-    /**
-     * Removes an exact Inbox record after validating the current session.
-     *
-     * @param input Describes the records and ownership predicate for deletion.
-     * @returns Whether the provider deleted the exact Inbox record.
-     */
-    remove<InboxId, InboxRecord extends Message, SessionId, SessionRecord extends Message>(input: DeliveryCleanupInput<InboxId, InboxRecord, SessionId, SessionRecord>): Promise<boolean>;
-    /**
-     * Closes this cleanup handle to further removal operations.
-     */
-    close(): void;
-}
-/**
- * Defines a provider factory capability narrower than a general transaction API.
- */
-export interface DeliveryCleanupStorageFactory {
-    /**
-     * Creates a provider-owned cleanup handle.
-     *
-     * @returns The cleanup handle bound to this provider.
-     */
-    createDeliveryCleanupStorage(): DeliveryCleanupStorage;
-}
-interface DeliveryCleanupFactoryAccess {
-    register(factory: StorageFactory, creator: DeliveryCleanupStorageFactory): void;
-    create(factory: StorageFactory): DeliveryCleanupStorage;
-}
-/**
- * Registers and resolves provider cleanup handles for direct delivery.
- */
-export declare const DeliveryCleanupStorageFactories: DeliveryCleanupFactoryAccess;
-export {};
-//# sourceMappingURL=delivery-cleanup.d.ts.map

package/dist/internal/delivery-cleanup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"delivery-cleanup.d.ts","sourceRoot":"","sources":["../../src/internal/delivery-cleanup.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAG/B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAIvF;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB,CACnC,OAAO,EACP,WAAW,SAAS,OAAO,EAC3B,SAAS,EACT,aAAa,SAAS,OAAO;IAI7B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAChD,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;QACrB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;KAChC,CAAC;IAEF;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACpD,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;QACvB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;QACjC,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC;KACxD,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IAGrC;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,SAAS,OAAO,EAAE,SAAS,EAAE,aAAa,SAAS,OAAO,EACnF,KAAK,EAAE,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC,GAC1E,OAAO,CAAC,OAAO,CAAC,CAAC;IAGpB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAG5C;;;;OAIG;IACH,4BAA4B,IAAI,sBAAsB,CAAC;CACxD;AAED,UAAU,4BAA4B;IACpC,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,6BAA6B,GAAG,IAAI,CAAC;IAChF,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,sBAAsB,CAAC;CACzD;AAED;;GAEG;AACH,eAAO,MAAM,+BAA+B,EAAE,4BAU5C,CAAC"}

package/dist/internal/delivery-cleanup.js

@@ -1,38 +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.
- */
-/**
- * Determines whether a cleanup operation may proceed at a provider safe boundary.
- *
- * @param operation Supplies cooperative cancellation and deadline state.
- * @returns Whether provider work may continue.
- */
-export function cleanupOperationActive(operation) {
-    return (!operation?.signal?.aborted && operation?.timeoutMs !== 0 && operation?.isActive?.() !== false);
-}
-/**
- * Registers and resolves provider cleanup handles for direct delivery.
- */
-export const DeliveryCleanupStorageFactories = Object.freeze({
-    register(factory, creator) {
-        creators.set(factory, creator);
-    },
-    create(factory) {
-        const creator = creators.get(factory);
-        if (creator === undefined)
-            throw new Error("StorageFactory does not provide atomic delivery cleanup storage.");
-        return creator.createDeliveryCleanupStorage();
-    },
-});
-const creators = new WeakMap();
-//# sourceMappingURL=delivery-cleanup.js.map

package/dist/internal/delivery-cleanup.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"delivery-cleanup.js","sourceRoot":"","sources":["../../src/internal/delivery-cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAgCH;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAuC;IAC5E,OAAO,CACL,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,IAAI,SAAS,EAAE,SAAS,KAAK,CAAC,IAAI,SAAS,EAAE,QAAQ,EAAE,EAAE,KAAK,KAAK,CAC/F,CAAC;AACJ,CAAC;AAqFD;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAiC,MAAM,CAAC,MAAM,CAAC;IACzF,QAAQ,CAAC,OAAuB,EAAE,OAAsC;QACtE,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,CAAC,OAAuB;QAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,OAAO,KAAK,SAAS;YACvB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,OAAO,OAAO,CAAC,4BAA4B,EAAE,CAAC;IAChD,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAiD,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