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

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

@@ -1,143 +0,0 @@
-import type { Timestamp } from "@bufbuild/protobuf/wkt";
-import type { CommandId } from "@spine-event-engine/proto";
-import { type AgentAcceptedInvocation, type AgentExecutionCompletion, type AgentExecutionHead, type AgentExecutionRecord, type AgentExecutionScope, type AgentInboxOrder, type AgentInvocationKey } from "@spine-event-engine/proto/generated/spine/server/agent/execution_record_pb.js";
-/**
- * Reads and compares original Agent execution values across storage providers.
- */
-export declare const AgentExecutionValues: {
-    /**
-     * Validates a present value at a provider trust boundary.
-     *
-     * @param value Optional decoded or selected value.
-     * @returns The present value.
-     * @typeParam T Value type.
-     */
-    require<T>(value: T | undefined): T;
-    /**
-     * Validates an invocation in the configured state family.
-     *
-     * @param key Complete original invocation key.
-     * @param stateType Configured generated state type.
-     * @returns Validated key.
-     */
-    requiredKey(key: AgentInvocationKey | undefined, stateType: string): AgentInvocationKey;
-    /**
-     * Validates immutable source facts and original Inbox order.
-     *
-     * @param record Persisted execution record.
-     * @returns Complete accepted source facts.
-     */
-    requiredAccepted(record: AgentExecutionRecord): AgentAcceptedInvocation;
-    /**
-     * Reads the accepted invocation key.
-     *
-     * @param record Persisted execution record.
-     * @returns Complete key.
-     */
-    requiredInvocation(record: AgentExecutionRecord): AgentInvocationKey;
-    /**
-     * Validates the generated state type and Agent key.
-     *
-     * @param key Original invocation identity.
-     * @returns Complete instance scope.
-     */
-    requiredScope(key: AgentInvocationKey | undefined): AgentExecutionScope;
-    /**
-     * Validates the scope stored in one per-instance head.
-     *
-     * @param head Persisted claim and discovery head.
-     * @returns Complete instance scope.
-     */
-    requiredHeadScope(head: AgentExecutionHead): AgentExecutionScope;
-    /**
-     * Reads original Inbox order from immutable acceptance.
-     *
-     * @param record Persisted execution record.
-     * @returns Complete Inbox order.
-     */
-    requiredOrder(record: AgentExecutionRecord): AgentInboxOrder;
-    /**
-     * Validates completed output obligations.
-     *
-     * @param record Persisted execution record.
-     * @returns Complete result.
-     */
-    requiredCompletion(record: AgentExecutionRecord): AgentExecutionCompletion;
-    /**
-     * Compares binary indexed strings without locale collation.
-     *
-     * @param left First full index key.
-     * @param right Second full index key.
-     * @returns Negative, zero, or positive order.
-     */
-    compareText(left: string, right: string): number;
-    /**
-     * Compares complete accepted source facts.
-     *
-     * @param left Previous accepted facts.
-     * @param right Proposed accepted facts.
-     * @returns Whether all original bytes match.
-     */
-    sameAccepted(left: AgentAcceptedInvocation | undefined, right: AgentAcceptedInvocation | undefined): boolean;
-    /**
-     * Compares exact binary images without integer conversion.
-     *
-     * @param left Previous Protobuf image.
-     * @param right Proposed Protobuf image.
-     * @returns Whether each byte matches.
-     */
-    sameBytes(left: Uint8Array, right: Uint8Array): boolean;
-    /**
-     * Returns an independent exact execution record.
-     *
-     * @param record Persisted record.
-     * @returns Binary round-tripped record.
-     */
-    cloneRecord(record: AgentExecutionRecord): AgentExecutionRecord;
-    /**
-     * Compares full seconds and nanos.
-     *
-     * @param left First Timestamp.
-     * @param right Second Timestamp.
-     * @returns Negative, zero, or positive order.
-     */
-    compareTime(left: Timestamp, right: Timestamp): number;
-    /**
-     * Checks whether accepted or expired work is claimable now.
-     *
-     * @param record Persisted invocation.
-     * @param now Fresh provider Timestamp.
-     * @returns Whether a claim may attempt it.
-     */
-    isPending(record: AgentExecutionRecord, now: Timestamp): boolean;
-    /**
-     * Clears the resolved claim while retaining original order.
-     *
-     * @param head Per-instance claim and discovery record.
-     * @param order Original Inbox order of resolved work.
-     */
-    release(head: AgentExecutionHead, order: AgentInboxOrder): void;
-    /**
-     * Updates a discoverable head for earlier original Inbox work without resetting eligibility.
-     *
-     * @param head Current per-instance claim and discovery row.
-     * @param record Newly accepted original invocation.
-     */
-    offerCandidate(head: AgentExecutionHead, record: AgentExecutionRecord): void;
-    /**
-     * Updates the resolved head with its earliest unresolved successor.
-     *
-     * @param head Current per-instance claim and discovery row.
-     * @param order Original Inbox order of resolved work.
-     * @param next Earliest remaining invocation when present.
-     */
-    advanceCandidate(head: AgentExecutionHead, order: AgentInboxOrder, next: AgentExecutionRecord | undefined): void;
-    /**
-     * Marks one original recorded outgoing ID delivered.
-     *
-     * @param record Completion carrying original outputs.
-     * @param signal Typed outgoing Command ID.
-     */
-    markSignal(record: AgentExecutionCompletion, signal: CommandId): void;
-};
-//# sourceMappingURL=agent-execution-values.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"agent-execution-values.d.ts","sourceRoot":"","sources":["../../src/entity/agent-execution-values.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAIL,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,+EAA+E,CAAC;AAIvF;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;;;;;OAMG;YACK,CAAC,SAAS,CAAC,GAAG,SAAS,GAAG,CAAC;IAKnC;;;;;;OAMG;qBACc,kBAAkB,GAAG,SAAS,aAAa,MAAM,GAAG,kBAAkB;IAavF;;;;;OAKG;6BACsB,oBAAoB,GAAG,uBAAuB;IAMvE;;;;;OAKG;+BACwB,oBAAoB,GAAG,kBAAkB;IAMpE;;;;;OAKG;uBACgB,kBAAkB,GAAG,SAAS,GAAG,mBAAmB;IAKvE;;;;;OAKG;4BACqB,kBAAkB,GAAG,mBAAmB;IAKhE;;;;;OAKG;0BACmB,oBAAoB,GAAG,eAAe;IAM5D;;;;;OAKG;+BACwB,oBAAoB,GAAG,wBAAwB;IAK1E;;;;;;OAMG;sBACe,MAAM,SAAS,MAAM,GAAG,MAAM;IAIhD;;;;;;OAMG;uBAEK,uBAAuB,GAAG,SAAS,SAClC,uBAAuB,GAAG,SAAS,GACzC,OAAO;IAcV;;;;;;OAMG;oBACa,UAAU,SAAS,UAAU,GAAG,OAAO;IAIvD;;;;;OAKG;wBACiB,oBAAoB,GAAG,oBAAoB;IAI/D;;;;;;OAMG;sBACe,SAAS,SAAS,SAAS,GAAG,MAAM;IAQtD;;;;;;OAMG;sBACe,oBAAoB,OAAO,SAAS,GAAG,OAAO;IAahE;;;;;OAKG;kBACW,kBAAkB,SAAS,eAAe,GAAG,IAAI;IAO/D;;;;;OAKG;yBACkB,kBAAkB,UAAU,oBAAoB,GAAG,IAAI;IAc5E;;;;;;OAMG;2BAEK,kBAAkB,SACjB,eAAe,QAChB,oBAAoB,GAAG,SAAS,GACrC,IAAI;IAOP;;;;;OAKG;uBACgB,wBAAwB,UAAU,SAAS,GAAG,IAAI;CAKtE,CAAC"}

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

@@ -1,251 +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 { clone, fromBinary, toBinary } from "@bufbuild/protobuf";
-import { Time } from "@spine-event-engine/core";
-import { AgentAcceptedInvocationSchema, AgentExecutionRecordSchema, AgentInvocationStatus, } from "@spine-event-engine/proto/generated/spine/server/agent/execution_record_pb.js";
-import { AgentExecutionRecords } from "./agent-execution-record-spec.js";
-/**
- * Reads and compares original Agent execution values across storage providers.
- */
-export const AgentExecutionValues = {
-    /**
-     * Validates a present value at a provider trust boundary.
-     *
-     * @param value Optional decoded or selected value.
-     * @returns The present value.
-     * @typeParam T Value type.
-     */
-    require(value) {
-        if (value === undefined)
-            throw new TypeError("Agent execution value is missing.");
-        return value;
-    },
-    /**
-     * Validates an invocation in the configured state family.
-     *
-     * @param key Complete original invocation key.
-     * @param stateType Configured generated state type.
-     * @returns Validated key.
-     */
-    requiredKey(key, stateType) {
-        if (key?.scope?.stateType !== stateType ||
-            !key.scope.agentKey ||
-            key.sourceSignal === undefined)
-            throw new TypeError("Agent execution requires configured state type, Agent key and source ID.");
-        AgentExecutionRecords.invocation(key);
-        return key;
-    },
-    /**
-     * Validates immutable source facts and original Inbox order.
-     *
-     * @param record Persisted execution record.
-     * @returns Complete accepted source facts.
-     */
-    requiredAccepted(record) {
-        if (record.accepted?.key?.scope === undefined || record.accepted.order === undefined)
-            throw new TypeError("Agent execution requires accepted source facts and Inbox order.");
-        return record.accepted;
-    },
-    /**
-     * Reads the accepted invocation key.
-     *
-     * @param record Persisted execution record.
-     * @returns Complete key.
-     */
-    requiredInvocation(record) {
-        const key = this.requiredAccepted(record).key;
-        if (key === undefined)
-            throw new TypeError("Agent invocation key is missing.");
-        return key;
-    },
-    /**
-     * Validates the generated state type and Agent key.
-     *
-     * @param key Original invocation identity.
-     * @returns Complete instance scope.
-     */
-    requiredScope(key) {
-        if (key?.scope === undefined)
-            throw new TypeError("Agent execution scope is missing.");
-        return key.scope;
-    },
-    /**
-     * Validates the scope stored in one per-instance head.
-     *
-     * @param head Persisted claim and discovery head.
-     * @returns Complete instance scope.
-     */
-    requiredHeadScope(head) {
-        if (head.scope === undefined)
-            throw new TypeError("Agent execution head scope is missing.");
-        return head.scope;
-    },
-    /**
-     * Reads original Inbox order from immutable acceptance.
-     *
-     * @param record Persisted execution record.
-     * @returns Complete Inbox order.
-     */
-    requiredOrder(record) {
-        const order = this.requiredAccepted(record).order;
-        if (order === undefined)
-            throw new TypeError("Agent Inbox order is missing.");
-        return order;
-    },
-    /**
-     * Validates completed output obligations.
-     *
-     * @param record Persisted execution record.
-     * @returns Complete result.
-     */
-    requiredCompletion(record) {
-        if (record.completion === undefined)
-            throw new TypeError("Agent completion is missing.");
-        return record.completion;
-    },
-    /**
-     * Compares binary indexed strings without locale collation.
-     *
-     * @param left First full index key.
-     * @param right Second full index key.
-     * @returns Negative, zero, or positive order.
-     */
-    compareText(left, right) {
-        return left < right ? -1 : left > right ? 1 : 0;
-    },
-    /**
-     * Compares complete accepted source facts.
-     *
-     * @param left Previous accepted facts.
-     * @param right Proposed accepted facts.
-     * @returns Whether all original bytes match.
-     */
-    sameAccepted(left, right) {
-        if (left === undefined || right === undefined)
-            return false;
-        const original = clone(AgentAcceptedInvocationSchema, left);
-        const repeated = clone(AgentAcceptedInvocationSchema, right);
-        // A retry may arrive in a new Inbox row after receipt retention expires.
-        // Keep the first order while requiring every source and binding fact to match.
-        original.order = undefined;
-        repeated.order = undefined;
-        return this.sameBytes(toBinary(AgentAcceptedInvocationSchema, original), toBinary(AgentAcceptedInvocationSchema, repeated));
-    },
-    /**
-     * Compares exact binary images without integer conversion.
-     *
-     * @param left Previous Protobuf image.
-     * @param right Proposed Protobuf image.
-     * @returns Whether each byte matches.
-     */
-    sameBytes(left, right) {
-        return left.length === right.length && left.every((byte, index) => byte === right[index]);
-    },
-    /**
-     * Returns an independent exact execution record.
-     *
-     * @param record Persisted record.
-     * @returns Binary round-tripped record.
-     */
-    cloneRecord(record) {
-        return fromBinary(AgentExecutionRecordSchema, toBinary(AgentExecutionRecordSchema, record));
-    },
-    /**
-     * Compares full seconds and nanos.
-     *
-     * @param left First Timestamp.
-     * @param right Second Timestamp.
-     * @returns Negative, zero, or positive order.
-     */
-    compareTime(left, right) {
-        return left.seconds < right.seconds
-            ? -1
-            : left.seconds > right.seconds
-                ? 1
-                : left.nanos - right.nanos;
-    },
-    /**
-     * Checks whether accepted or expired work is claimable now.
-     *
-     * @param record Persisted invocation.
-     * @param now Fresh provider Timestamp.
-     * @returns Whether a claim may attempt it.
-     */
-    isPending(record, now) {
-        if (record.status === AgentInvocationStatus.AGENT_INVOCATION_ACCEPTED ||
-            record.status === AgentInvocationStatus.AGENT_INVOCATION_COMPLETED_PENDING_COMMANDS)
-            return true;
-        return (record.status === AgentInvocationStatus.AGENT_INVOCATION_ACTIVE &&
-            record.claimExpiresAt !== undefined &&
-            this.compareTime(record.claimExpiresAt, now) <= 0);
-    },
-    /**
-     * Clears the resolved claim while retaining original order.
-     *
-     * @param head Per-instance claim and discovery record.
-     * @param order Original Inbox order of resolved work.
-     */
-    release(head, order) {
-        head.active = undefined;
-        head.claimToken = "";
-        head.claimExpiresAt = undefined;
-        head.lastResolved = order;
-    },
-    /**
-     * Updates a discoverable head for earlier original Inbox work without resetting eligibility.
-     *
-     * @param head Current per-instance claim and discovery row.
-     * @param record Newly accepted original invocation.
-     */
-    offerCandidate(head, record) {
-        const order = this.requiredOrder(record);
-        if (head.pendingOrder !== undefined &&
-            AgentExecutionRecords.order(head.pendingOrder) <= AgentExecutionRecords.order(order))
-            return;
-        head.pending = this.requiredInvocation(record);
-        head.pendingOrder = order;
-        if (head.active === undefined)
-            head.eligibleAt ??= Time.currentTime();
-        else if (head.claimExpiresAt !== undefined)
-            head.eligibleAt = head.claimExpiresAt;
-        else
-            throw new Error("Agent active head requires lease expiry.");
-    },
-    /**
-     * Updates the resolved head with its earliest unresolved successor.
-     *
-     * @param head Current per-instance claim and discovery row.
-     * @param order Original Inbox order of resolved work.
-     * @param next Earliest remaining invocation when present.
-     */
-    advanceCandidate(head, order, next) {
-        this.release(head, order);
-        head.pending = next === undefined ? undefined : this.requiredInvocation(next);
-        head.pendingOrder = next === undefined ? undefined : this.requiredOrder(next);
-        head.eligibleAt = next === undefined ? undefined : Time.currentTime();
-    },
-    /**
-     * Marks one original recorded outgoing ID delivered.
-     *
-     * @param record Completion carrying original outputs.
-     * @param signal Typed outgoing Command ID.
-     */
-    markSignal(record, signal) {
-        const outgoing = record.commands.find((item) => item.command?.id?.uuid === signal.uuid);
-        if (outgoing === undefined)
-            throw new Error("Agent outgoing signal ID was not recorded.");
-        outgoing.delivered = true;
-    },
-};
-//# sourceMappingURL=agent-execution-values.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"agent-execution-values.js","sourceRoot":"","sources":["../../src/entity/agent-execution-values.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAEhD,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,qBAAqB,GAQtB,MAAM,+EAA+E,CAAC;AAEvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEzE;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC;;;;;;OAMG;IACH,OAAO,CAAI,KAAoB;QAC7B,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;QAClF,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,GAAmC,EAAE,SAAiB;QAChE,IACE,GAAG,EAAE,KAAK,EAAE,SAAS,KAAK,SAAS;YACnC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ;YACnB,GAAG,CAAC,YAAY,KAAK,SAAS;YAE9B,MAAM,IAAI,SAAS,CACjB,0EAA0E,CAC3E,CAAC;QACJ,qBAAqB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACtC,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,MAA4B;QAC3C,IAAI,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS;YAClF,MAAM,IAAI,SAAS,CAAC,iEAAiE,CAAC,CAAC;QACzF,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,MAA4B;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC;QAC9C,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAC;QAC/E,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,GAAmC;QAC/C,IAAI,GAAG,EAAE,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;QACvF,OAAO,GAAG,CAAC,KAAK,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,IAAwB;QACxC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAC;QAC5F,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,MAA4B;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;QAC9E,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,MAA4B;QAC7C,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;YAAE,MAAM,IAAI,SAAS,CAAC,8BAA8B,CAAC,CAAC;QACzF,OAAO,MAAM,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,IAAY,EAAE,KAAa;QACrC,OAAO,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;OAMG;IACH,YAAY,CACV,IAAyC,EACzC,KAA0C;QAE1C,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC5D,MAAM,QAAQ,GAAG,KAAK,CAAC,6BAA6B,EAAE,IAAI,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QAC7D,yEAAyE;QACzE,+EAA+E;QAC/E,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAC;QAC3B,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAC;QAC3B,OAAO,IAAI,CAAC,SAAS,CACnB,QAAQ,CAAC,6BAA6B,EAAE,QAAQ,CAAC,EACjD,QAAQ,CAAC,6BAA6B,EAAE,QAAQ,CAAC,CAClD,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,IAAgB,EAAE,KAAiB;QAC3C,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,MAA4B;QACtC,OAAO,UAAU,CAAC,0BAA0B,EAAE,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,IAAe,EAAE,KAAgB;QAC3C,OAAO,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO;YACjC,CAAC,CAAC,CAAC,CAAC;YACJ,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO;gBAC5B,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IACjC,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,MAA4B,EAAE,GAAc;QACpD,IACE,MAAM,CAAC,MAAM,KAAK,qBAAqB,CAAC,yBAAyB;YACjE,MAAM,CAAC,MAAM,KAAK,qBAAqB,CAAC,2CAA2C;YAEnF,OAAO,IAAI,CAAC;QACd,OAAO,CACL,MAAM,CAAC,MAAM,KAAK,qBAAqB,CAAC,uBAAuB;YAC/D,MAAM,CAAC,cAAc,KAAK,SAAS;YACnC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,cAAc,EAAE,GAAG,CAAC,IAAI,CAAC,CAClD,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,IAAwB,EAAE,KAAsB;QACtD,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAChC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,IAAwB,EAAE,MAA4B;QACnE,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QACzC,IACE,IAAI,CAAC,YAAY,KAAK,SAAS;YAC/B,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC;YAEpF,OAAO;QACT,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;aACjE,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC;;YAC7E,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;OAMG;IACH,gBAAgB,CACd,IAAwB,EACxB,KAAsB,EACtB,IAAsC;QAEtC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC9E,IAAI,CAAC,YAAY,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC9E,IAAI,CAAC,UAAU,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACxE,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,MAAgC,EAAE,MAAiB;QAC5D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;QACxF,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC1F,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;IAC5B,CAAC;CACF,CAAC"}

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

@@ -1,235 +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 { AgentHistoryEntry, ModelPreference } from "@spine-event-engine/proto/agent";
-import type { AgentAcceptedInvocation, AgentExecutionRecord, AgentExecutionScope, AgentInvocationKey } 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 outgoing Command 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 Command IDs accepted by delivery.
-     * @returns Completion after original Commands are marked delivered.
-     */
-    markDelivered(key: AgentInvocationKey, token: string, expectedRecordBytes: Uint8Array, signals: readonly CommandId[]): 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"}