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

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

@@ -1,285 +0,0 @@
-import { type Message } from "@bufbuild/protobuf";
-import type { Timestamp } from "@bufbuild/protobuf/wkt";
-import type { CommandId } from "@spine-event-engine/proto";
-import { type AgentAcceptedInvocation, type AgentExecutionHead, type AgentExecutionRecord, type AgentInvocationKey } from "@spine-event-engine/proto/generated/spine/server/agent/execution_record_pb.js";
-import type { AgentHistoryRecord } from "@spine-event-engine/proto/generated/spine/server/agent/history_record_pb.js";
-import type { EntityRecord } from "@spine-event-engine/proto/generated/spine/server/entity/entity_pb.js";
-import { type AgentExecutionStorage, type AgentExecutionCapacity, type AgentExecutionStorageInput, type AgentExecutionClaim, type AgentExecutionUpdate, type AgentExecutionComplete, type AgentPendingRead, type AgentPendingPage } from "@spine-event-engine/storage/provider";
-import { PostgresRecordStorage } from "./record-storage.js";
-import { PostgresEntityCommitStorage } from "./entity-commit.js";
-/**
- * Persists accepted Agent work, exclusive claims and deterministic evidence.
- *
- * @typeParam I Typed Agent identifier.
- * @typeParam S Generated Agent state.
- */
-export declare class PostgresAgentExecution<I, S extends Message> implements AgentExecutionStorage<I, S> {
-    #private;
-    private readonly input;
-    private readonly invocation;
-    private readonly head;
-    private readonly history;
-    private readonly current;
-    private readonly commits;
-    /**
-     * PostgreSQL has no tighter fixed row limit in this provider contract.
-     */
-    readonly capacity: AgentExecutionCapacity;
-    /**
-     * Binds prepared record families to one Agent repository and tenant boundary.
-     *
-     * @param input Agent repository and current Entity layout.
-     * @param invocation Mutable invocation records.
-     * @param head Per-instance claim and current preference records.
-     * @param history Immutable Agent conversation, System and domain entries.
-     * @param current Existing Entity current records used for no-op version checks.
-     * @param commits Opens the existing conditional Entity commit coordinator.
-     */
-    constructor(input: AgentExecutionStorageInput<I, S>, invocation: PostgresRecordStorage<string, AgentExecutionRecord>, head: PostgresRecordStorage<string, AgentExecutionHead>, history: PostgresRecordStorage<string, AgentHistoryRecord>, current: PostgresRecordStorage<I, EntityRecord>, commits: () => PostgresEntityCommitStorage<I, S>);
-    /**
-     * Persists original accepted work idempotently under its per-instance lock.
-     *
-     * @param accepted Complete source signal and selected bindings.
-     * @returns Detached stored invocation.
-     */
-    admit(accepted: AgentAcceptedInvocation): Promise<AgentExecutionRecord>;
-    /**
-     * Reads a bounded indexed page of eligible accepted or interrupted work.
-     *
-     * @param request Complete continuation and page count.
-     * @returns Detached records and continuation state.
-     */
-    pending(request: AgentPendingRead): Promise<AgentPendingPage>;
-    /**
-     * Builds one binary-collated native pending-head query.
-     *
-     * @param request Bounded pending-page request.
-     * @param asOf Fixed provider-time eligibility cutoff.
-     * @param table Resolved head table in the current schema.
-     * @returns Native SQL and exact bound values.
-     */
-    private pendingQuery;
-    /**
-     * Reads one complete persisted invocation.
-     *
-     * @param key Original source and Agent instance identity.
-     * @returns Detached record if present.
-     */
-    read(key: AgentInvocationKey): Promise<AgentExecutionRecord | undefined>;
-    /**
-     * Acquires only earliest unresolved same-instance work under a fresh transaction clock.
-     *
-     * @param key Original source and Agent instance identity.
-     * @param token New exclusive token.
-     * @param expiresAt Requested future expiry.
-     * @returns Claimed record and current preferences, when eligible.
-     */
-    claim(key: AgentInvocationKey, token: string, expiresAt: Timestamp): Promise<AgentExecutionClaim | undefined>;
-    /**
-     * Checks the locked instance and persists one exclusive lease.
-     *
-     * @param client Native client in the current transaction.
-     * @param rows Tenant record executors.
-     * @param key Original Agent invocation identity.
-     * @param token New exclusive token.
-     * @param expiresAt Requested future lease expiry.
-     * @returns Claimed record and preferences when eligible.
-     */
-    private claimLocked;
-    /**
-     * Checks the current head and earliest same-instance source.
-     *
-     * @param client Native client in the current transaction.
-     * @param rows Tenant record executors.
-     * @param head Per-instance pending and lease record.
-     * @param key Original Agent invocation identity.
-     * @param now Fresh time read under the per-instance lock.
-     * @returns Whether this invocation may receive the next lease.
-     */
-    private eligibleClaim;
-    /**
-     * Updates one still-current lease under the per-instance transaction lock.
-     *
-     * @param key Original source and Agent instance identity.
-     * @param token Current exclusive token.
-     * @param expiresAt Requested later expiry.
-     * @returns Whether renewal succeeded.
-     */
-    renew(key: AgentInvocationKey, token: string, expiresAt: Timestamp): Promise<boolean>;
-    /**
-     * Persists one execution update and its immutable history rows in the same transaction.
-     *
-     * @param input Exact read image, next execution record and history entries.
-     * @returns Completion after fenced evidence is persisted.
-     */
-    update(input: AgentExecutionUpdate): Promise<void>;
-    /**
-     * Commits Entity state, history, preferences and outgoing obligations together.
-     *
-     * @param input Complete conditional transition.
-     * @returns Completion after conditional Entity and evidence commit.
-     */
-    complete(input: AgentExecutionComplete<I, S>): Promise<void>;
-    /**
-     * Applies every conditional completion row on one transaction client.
-     *
-     * @param client Native database client in the current transaction.
-     * @param input Requested fenced execution change.
-     * @param prepared Prepared Entity state and Version write.
-     * @param rows Provider record handles bound to the tenant.
-     * @returns Completion after Entity and execution evidence commit.
-     */
-    private completeLocked;
-    /**
-     * Validates one Version increment or no-op and a nonterminal prior phase.
-     *
-     * @param input Requested fenced execution change.
-     * @param prior Previously persisted execution record.
-     * @returns Expected initial Entity Version.
-     */
-    private validateCompletion;
-    /**
-     * Marks original outgoing IDs accepted by normal delivery.
-     *
-     * @param key Original source and Agent instance identity.
-     * @param token Current exclusive token.
-     * @param expectedRecordBytes Exact previous record bytes.
-     * @param signals Original accepted output IDs.
-     * @returns Completion after original output IDs are marked delivered.
-     */
-    markDelivered(key: AgentInvocationKey, token: string, expectedRecordBytes: Uint8Array, signals: readonly CommandId[]): Promise<void>;
-    /**
-     * Marks original output IDs while the per-instance native lock is held.
-     *
-     * @param client Native client in the current transaction.
-     * @param rows Tenant record executors.
-     * @param key Original Agent invocation identity.
-     * @param token Current exclusive claim token.
-     * @param expectedRecordBytes Exact prior execution record bytes.
-     * @param signals Original accepted output IDs.
-     * @returns Completion after persisted output status is updated.
-     */
-    private deliverLocked;
-    /**
-     * Closes all provider record handles without deleting persisted work.
-     */
-    close(): void;
-    /**
-     * Rejects calls after handle closure.
-     */
-    private requireOpen;
-    /**
-     * Prepares three existing record families and required native indexes once.
-     *
-     * @returns Completion after provider capabilities are checked.
-     */
-    private ready;
-    /**
-     * Ensures full scoped order and expiry indexes before accepted work.
-     *
-     * @returns Completion after native tables and indexes are prepared.
-     */
-    private initialize;
-    /**
-     * Acquires a transaction-scoped lock even when the head row is absent.
-     *
-     * @param client Native database client in the current transaction.
-     * @param key Original Agent invocation identity.
-     * @param rows Provider record handles bound to the tenant.
-     * @returns Completion after locking the per-instance head.
-     */
-    private lockHead;
-    /**
-     * Reads one head and rejects a physical digest collision.
-     *
-     * @param client Native database client in the current transaction.
-     * @param key Original Agent invocation identity.
-     * @param rows Provider record handles bound to the tenant.
-     * @returns Per-instance head when present.
-     */
-    private currentHead;
-    /**
-     * Reads one invocation and rejects a physical digest collision.
-     *
-     * @param client Native database client in the current transaction.
-     * @param key Original Agent invocation identity.
-     * @param rows Provider record handles bound to the tenant.
-     * @returns Stored invocation when present.
-     */
-    private existing;
-    /**
-     * Checks fresh Time, exact token and complete previous record bytes.
-     *
-     * @param checkNext Whether to validate the proposed next record.
-     * @param client Native database client in the current transaction.
-     * @param input Requested fenced execution change.
-     * @param rows Provider record handles bound to the tenant.
-     * @returns Current fenced record and head.
-     */
-    private expected;
-    /**
-     * Reads claimed rows under the already acquired per-instance lock.
-     *
-     * @param client Native database client in the current transaction.
-     * @param key Original Agent invocation identity.
-     * @param rows Provider record handles bound to the tenant.
-     * @param token Exclusive claim token.
-     * @returns Current record and head if the token remains valid.
-     */
-    private claimed;
-    /**
-     * Checks no earlier unresolved signal in the same full Agent scope.
-     *
-     * @param client Native database client in the current transaction.
-     * @param key Original Agent invocation identity.
-     * @param rows Provider record handles bound to the tenant.
-     * @returns Whether this invocation is earliest unresolved work.
-     */
-    private earliest;
-    /**
-     * Adds an earlier accepted source without resetting an existing eligibility.
-     *
-     * @param head Per-instance pending and lease record.
-     * @param record Persisted Agent execution record.
-     */
-    private offerCandidate;
-    /**
-     * Updates the head to one bounded native successor before terminal publication.
-     *
-     * @param client Native database client in the current transaction.
-     * @param head Per-instance pending and lease record.
-     * @param key Original Agent invocation identity.
-     * @param order Original Inbox order.
-     * @param rows Provider record handles bound to the tenant.
-     * @returns Completion after updating the next pending head.
-     */
-    private advanceCandidate;
-    /**
-     * Reads at most two rows per unresolved status in original Inbox order.
-     *
-     * @param client Native database client in the current transaction.
-     * @param exclude Invocation omitted while selecting the successor.
-     * @param key Original Agent invocation identity.
-     * @param rows Provider record handles bound to the tenant.
-     * @returns Earliest unresolved invocation when present.
-     */
-    private successor;
-    /**
-     * Builds the bounded native query for one unresolved invocation status.
-     *
-     * @param table Resolved invocation table in the current schema.
-     * @returns Complete indexed successor query.
-     */
-    private successorSql;
-    /**
-     * Validates current Version and applies optional Entity rows in this transaction.
-     *
-     * @param client Native database client in the current transaction.
-     * @param expectedVersion Expected current Entity Version.
-     * @param input Requested fenced execution change.
-     * @param prepared Prepared Entity state and Version write.
-     * @returns Completion after conditional Entity state and Version write.
-     */
-    private completeEntity;
-}
-//# sourceMappingURL=agent-execution.d.ts.map

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

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