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

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

@@ -0,0 +1,182 @@
+/*
+ * 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, toBinary } from "@bufbuild/protobuf";
+import { AgentExecutionRecordSchema, AgentSavedDispatchPlanSchema as SavedDispatchPlanSchema, AgentSavedTargetKind, AgentSavedRepositoryFamily, } from "@spine-event-engine/proto/generated/spine/server/agent/execution_record_pb.js";
+/**
+ * Enforces immutable saved output envelopes and one-time route preparation.
+ */
+export const AgentExecutionTransitions = {
+    /**
+     * Rejects an initial completion that claims transport acceptance or a saved route.
+     *
+     * @param record Persisted Agent execution record.
+     */
+    assertCompletion(record) {
+        const originalIds = new Set();
+        for (const output of record.completion?.outgoing ?? []) {
+            if (output.signal.case === undefined || output.delivered || output.plan !== undefined)
+                throw new Error("Agent completion requires an undelivered original output without a plan.");
+            const original = this.originalId(output);
+            if (originalIds.has(original))
+                throw new Error("Agent completion has duplicate outgoing IDs.");
+            originalIds.add(original);
+        }
+    },
+    /**
+     * Reads the complete typed ID of one original outgoing envelope.
+     *
+     * @param output Original Event or Command envelope.
+     * @returns Kind and nonempty source ID.
+     */
+    originalId(output) {
+        const kind = output.signal.case;
+        const id = kind === "event"
+            ? output.signal.value.id?.value
+            : kind === "command"
+                ? output.signal.value.id?.uuid
+                : undefined;
+        if (!id?.trim())
+            throw new Error("Agent outgoing original ID must be nonempty.");
+        if (kind !== "event" && kind !== "command")
+            throw new Error("Agent outgoing signal must have a typed kind.");
+        return `${kind}:${id}`;
+    },
+    /**
+     * Accepts only absent-to-present saved-plan installation after completion.
+     *
+     * @param next Proposed next execution record.
+     * @param prior Previously persisted execution record.
+     */
+    assertUpdate(prior, next) {
+        if (prior.completion === undefined) {
+            if (next.completion !== undefined)
+                throw new Error("Agent execution update cannot install completion outside conditional commit.");
+            return;
+        }
+        if (next.completion?.outgoing.length !== prior.completion.outgoing.length)
+            throw new Error("Agent saved outputs cannot be replaced.");
+        const masked = clone(AgentExecutionRecordSchema, next);
+        const priorCompletion = prior.completion;
+        const maskedCompletion = masked.completion;
+        if (maskedCompletion === undefined)
+            throw new Error("Agent completion is missing.");
+        for (let i = 0; i < prior.completion.outgoing.length; i += 1) {
+            const old = priorCompletion.outgoing[i];
+            const current = next.completion.outgoing[i];
+            const maskedOutput = maskedCompletion.outgoing[i];
+            if (old === undefined || current === undefined || maskedOutput === undefined)
+                throw new Error("Agent saved output is missing.");
+            if (old.plan !== undefined && !this.samePlan(old, current))
+                throw new Error("Agent saved output plan is immutable.");
+            if (old.plan === undefined && current.plan !== undefined)
+                this.validatePlan(current);
+            maskedOutput.plan = old.plan;
+        }
+        if (!this.sameRecord(prior, masked))
+            throw new Error("Completed Agent execution permits only one-time output plan installation.");
+    },
+    /**
+     * Validates a persisted plan before acknowledging each selected original ID.
+     *
+     * @param record Persisted Agent execution record.
+     * @param signals Original outgoing signal identities.
+     */
+    assertDelivery(record, signals) {
+        for (const signal of signals) {
+            const output = record.completion?.outgoing.find((item) => this.matches(item, signal));
+            if (output?.plan === undefined)
+                throw new Error("Agent output cannot be acknowledged before its saved plan exists.");
+        }
+    },
+    /**
+     * Checks complete binding identities and typed repository recipients.
+     *
+     * @param output Saved outgoing signal.
+     */
+    validatePlan(output) {
+        if (output.delivered)
+            throw new Error("Agent delivered output cannot install a route plan.");
+        for (const target of output.plan?.targets ?? [])
+            this.validateTarget(output, target);
+    },
+    /**
+     * Rejects a target that cannot be rebound to the original output kind.
+     *
+     * @param output Saved outgoing signal.
+     * @param target Prepared delivery target.
+     */
+    validateTarget(output, target) {
+        const event = output.signal.case === "event";
+        const repository = target.kind === AgentSavedTargetKind.AGENT_SAVED_REPOSITORY_EVENT ||
+            target.kind === AgentSavedTargetKind.AGENT_SAVED_REPOSITORY_COMMAND;
+        if (!target.signalType.trim() ||
+            !target.bindingFingerprint.trim() ||
+            (event
+                ? target.kind !== AgentSavedTargetKind.AGENT_SAVED_REPOSITORY_EVENT &&
+                    target.kind !== AgentSavedTargetKind.AGENT_SAVED_STANDALONE_EVENT
+                : target.kind !== AgentSavedTargetKind.AGENT_SAVED_REPOSITORY_COMMAND &&
+                    target.kind !== AgentSavedTargetKind.AGENT_SAVED_STANDALONE_COMMAND))
+            throw new Error("Agent saved dispatcher does not match the original output.");
+        if (repository
+            ? !target.receiverStateType.trim() ||
+                target.repositoryFamily === AgentSavedRepositoryFamily.AGENT_SAVED_FAMILY_UNSPECIFIED ||
+                target.recipients.some((id) => !id.typeUrl.trim())
+            : target.receiverStateType !== "" ||
+                target.repositoryFamily !== AgentSavedRepositoryFamily.AGENT_SAVED_FAMILY_UNSPECIFIED ||
+                target.recipients.length > 0)
+            throw new Error("Agent saved dispatcher has invalid repository or standalone identity.");
+    },
+    /**
+     * Compares complete original plan bytes after installation.
+     *
+     * @param left First value in the comparison.
+     * @param right Second value in the comparison.
+     * @returns Whether both saved dispatch plans have identical bytes.
+     */
+    samePlan(left, right) {
+        if (left.plan === undefined || right.plan === undefined)
+            return left.plan === right.plan;
+        const a = toBinary(SavedDispatchPlanSchema, left.plan);
+        const b = toBinary(SavedDispatchPlanSchema, right.plan);
+        return a.length === b.length && a.every((byte, index) => byte === b[index]);
+    },
+    /**
+     * Compares every execution field after masking the newly installed plans.
+     *
+     * @param left First value in the comparison.
+     * @param right Second value in the comparison.
+     * @returns Whether both execution records have identical bytes.
+     */
+    sameRecord(left, right) {
+        const a = toBinary(AgentExecutionRecordSchema, left);
+        const b = toBinary(AgentExecutionRecordSchema, right);
+        return a.length === b.length && a.every((byte, index) => byte === b[index]);
+    },
+    /**
+     * Matches a selected typed original Event or Command ID.
+     *
+     * @param output Saved outgoing signal.
+     * @param signal Original signal identity.
+     * @returns Whether the saved output has the original signal identity.
+     */
+    matches(output, signal) {
+        return ((signal.id.case === "event" &&
+            output.signal.case === "event" &&
+            output.signal.value.id?.value === signal.id.value.value) ||
+            (signal.id.case === "command" &&
+                output.signal.case === "command" &&
+                output.signal.value.id?.uuid === signal.id.value.uuid));
+    },
+};
+//# sourceMappingURL=agent-execution-transitions.js.map

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

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

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

@@ -0,0 +1,142 @@
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import { type AgentAcceptedInvocation, type AgentExecutionCompletion, type AgentExecutionHead, type AgentExecutionRecord, type AgentExecutionScope, type AgentInboxOrder, type AgentInvocationKey, type AgentSignalKey } 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 Event or Command ID.
+     */
+    markSignal(record: AgentExecutionCompletion, signal: AgentSignalKey): void;
+};
+//# sourceMappingURL=agent-execution-values.d.ts.map

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

@@ -0,0 +1 @@
+{"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,EAIL,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,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;IAWV;;;;;;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,cAAc,GAAG,IAAI;CAa3E,CAAC"}

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

@@ -0,0 +1,250 @@
+/*
+ * 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 { 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) {
+        return (left !== undefined &&
+            right !== undefined &&
+            this.sameBytes(toBinary(AgentAcceptedInvocationSchema, left), toBinary(AgentAcceptedInvocationSchema, right)));
+    },
+    /**
+     * 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_DELIVERY)
+            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 Event or Command ID.
+     */
+    markSignal(record, signal) {
+        const outgoing = record.outgoing.find((item) => (signal.id.case === "event" &&
+            item.signal.case === "event" &&
+            item.signal.value.id?.value === signal.id.value.value) ||
+            (signal.id.case === "command" &&
+                item.signal.case === "command" &&
+                item.signal.value.id?.uuid === signal.id.value.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

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