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

package/dist/delivery/agent-delivery-scope.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Result of one Agent-specific admission inside ordinary Inbox delivery.
+ */
+export type AgentDeliveryOutcome = {
+    /**
+     * Indicates capacity deferral before receipt admission.
+     */
+    readonly kind: "deferred";
+} | {
+    /**
+     * Indicates a provider error that must not acknowledge the row.
+     */
+    readonly kind: "error";
+    /**
+     * Original provider or admission error.
+     */
+    readonly error: unknown;
+} | {
+    /**
+     * Indicates a previously accepted exact signal.
+     */
+    readonly kind: "duplicate";
+} | {
+    /**
+     * Indicates a newly accepted exact signal.
+     */
+    readonly kind: "accepted";
+    /**
+     * Executes the admitted live turn after Inbox acknowledgement.
+     *
+     * @param signal Cancellation signal for the admitted turn.
+     * @param checkSession Validates the current shard session before commit.
+     * @returns Completion of the admitted Agent turn.
+     */
+    readonly run: (signal: AbortSignal, checkSession: () => Promise<void>) => Promise<void>;
+    /**
+     * Clears the capacity reservation when acknowledgement does not complete.
+     */
+    readonly discard: () => void;
+};
+interface AgentDeliveryScopeAccess {
+    /**
+     * Executes one endpoint callback inside its exact Agent outcome scope.
+     *
+     * @param onDispatch Endpoint callback to run in the scoped context.
+     * @param signal Cancellation signal for this delivery attempt.
+     * @returns Recorded Agent outcome, when the endpoint admitted one.
+     */
+    run(onDispatch: () => Promise<void>, signal: AbortSignal): Promise<AgentDeliveryOutcome | undefined>;
+    /**
+     * Returns the current delivery cancellation fence.
+     * @returns Cancellation signal for the current delivery attempt, if present.
+     */
+    signal(): AbortSignal | undefined;
+    /**
+     * Records the exact Agent admission outcome.
+     * @param outcome Exact admission outcome for the current delivery attempt.
+     */
+    record(outcome: AgentDeliveryOutcome): void;
+}
+/**
+ * Carries an internal Agent outcome through the existing void endpoint callback.
+ */
+export declare const AgentDeliveryScope: AgentDeliveryScopeAccess;
+export {};
+//# sourceMappingURL=agent-delivery-scope.d.ts.map

package/dist/delivery/agent-delivery-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-delivery-scope.d.ts","sourceRoot":"","sources":["../../src/delivery/agent-delivery-scope.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IACE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B,GACD;IACE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,GACD;IACE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B,GACD;IACE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAExF;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B,CAAC;AASN,UAAU,wBAAwB;IAChC;;;;;;OAMG;IACH,GAAG,CACD,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC/B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;IAE7C;;;OAGG;IACH,MAAM,IAAI,WAAW,GAAG,SAAS,CAAC;IAElC;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC7C;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,wBA6B/B,CAAC"}

package/dist/delivery/agent-delivery-scope.js

@@ -0,0 +1,44 @@
+/*
+ * 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 { AsyncLocalStorage } from "node:async_hooks";
+const dispatches = new AsyncLocalStorage();
+/**
+ * Carries an internal Agent outcome through the existing void endpoint callback.
+ */
+export const AgentDeliveryScope = Object.freeze({
+    /**
+     * Executes one endpoint callback and returns its Agent outcome, if one was recorded.
+     */
+    async run(onDispatch, signal) {
+        const scoped = { signal };
+        await dispatches.run(scoped, onDispatch);
+        return scoped.value;
+    },
+    /**
+     * Returns the cancellation fence for the current ordinary delivery attempt.
+     */
+    signal() {
+        return dispatches.getStore()?.signal;
+    },
+    /**
+     * Records one Agent admission result for the current ordinary delivery attempt.
+     */
+    record(outcome) {
+        const scoped = dispatches.getStore();
+        if (scoped === undefined || scoped.value !== undefined)
+            throw new Error("Agent admission requires one current delivery attempt.");
+        scoped.value = outcome;
+    },
+});
+//# sourceMappingURL=agent-delivery-scope.js.map

package/dist/delivery/agent-delivery-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-delivery-scope.js","sourceRoot":"","sources":["../../src/delivery/agent-delivery-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAuDrD,MAAM,UAAU,GAAG,IAAI,iBAAiB,EAAiB,CAAC;AA4B1D;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B,MAAM,CAAC,MAAM,CAAC;IACxE;;OAEG;IACH,KAAK,CAAC,GAAG,CACP,UAA+B,EAC/B,MAAmB;QAEnB,MAAM,MAAM,GAAkB,EAAE,MAAM,EAAE,CAAC;QACzC,MAAM,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,UAAU,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAA6B;QAClC,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC;QACrC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;YACpD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC;IACzB,CAAC;CACF,CAAC,CAAC"}

package/dist/delivery/delivery-builder.d.ts

@@ -1,7 +1,7 @@
 import type { Any } from "@bufbuild/protobuf/wkt";
 import type { StorageContext, StorageFactory } from "@spine-event-engine/storage";
 import type { WorkerId } from "@spine-event-engine/proto/delivery";
-import { type OnDeliveryMessage } from "./delivery.js";
+import { Delivery as CoreDelivery, type OnDeliveryMessage } from "./delivery.js";
 import { DeliveryMonitor } from "./delivery-monitor.js";
 import type { DeliveryInbox, DeliveryWorkRegistry } from "./delivery-ports.js";
 import type { DeliveryControlledRun } from "./delivery-run-control.js";
@@ -17,6 +17,19 @@ export interface DeliveryControls {
      * @returns Its controlled runner, if present.
      */
     runner(delivery: Delivery): ((options: DeliveryControlledRun) => Promise<DeliveryResult>) | undefined;
+    /**
+     * Finds the active-run wake callback for a builder-created delivery.
+     *
+     * @param delivery Retained Delivery instance.
+     * @returns The active Delivery wake callback, if one is registered.
+     */
+    waker(delivery: Delivery): ((shard: ShardIndex) => void) | undefined;
+    /**
+     * Registers the environment's single retained core for supervised runs.
+     * @param core Actual retained Delivery runtime.
+     * @returns The controlled facade for that same runtime.
+     */
+    supervised(core: CoreDelivery): Delivery;
 }
 /**
  * Exposes package-local controls for builder-created deliveries.
@@ -64,6 +77,11 @@ export declare class UniformAcrossAllShards implements DeliveryStrategy {
      * Number of uniformly distributed shards.
      */
     readonly shardCount: number;
+    /**
+     * Creates a fixed uniform shard strategy.
+     *
+     * @param shards Positive shard count.
+     */
     private constructor();
     /**
      * Determines a stable shard from a target identity.
@@ -213,4 +231,10 @@ export declare class DeliveryBuilder {
      */
     build(): Delivery;
 }
+/**
+ * Package-local validated strategy snapshot for the environment Delivery.
+ */
+export declare const deliveryStrategyAccess: Readonly<{
+    snapshot(strategy: DeliveryStrategy): DeliveryStrategy;
+}>;
 //# sourceMappingURL=delivery-builder.d.ts.map

package/dist/delivery/delivery-builder.d.ts.map

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

package/dist/delivery/delivery-builder.js

@@ -23,6 +23,7 @@ const defaultContext = Object.freeze({
 });
 const defaultPageSize = 100;
 const controlledDeliveryRunners = new WeakMap();
+const controlledDeliveryWakers = new WeakMap();
 /**
  * Exposes package-local controls for builder-created deliveries.
  */
@@ -34,6 +35,12 @@ export const deliveryControls = Object.freeze({
     runner(delivery) {
         return controlledDeliveryRunners.get(delivery);
     },
+    waker(delivery) {
+        return controlledDeliveryWakers.get(delivery);
+    },
+    supervised(core) {
+        return new BuiltDelivery(core);
+    },
 });
 /**
  * Places every target in one local shard.
@@ -61,6 +68,11 @@ export class UniformAcrossAllShards {
      * Number of uniformly distributed shards.
      */
     shardCount;
+    /**
+     * Creates a fixed uniform shard strategy.
+     *
+     * @param shards Positive shard count.
+     */
     constructor(shards) {
         if (!Number.isSafeInteger(shards) || shards <= 0) {
             throw new Error("Delivery shard count must be a positive safe integer.");
@@ -106,6 +118,8 @@ export class DeliveryBuilder {
      * @returns This builder.
      */
     withContext(context) {
+        if (context.multitenant)
+            throw new TypeError("Delivery requires a single-tenant storage context.");
         this.#context = DeliveryValues.snapshotContext(context);
         return this;
     }
@@ -240,6 +254,9 @@ export class DeliveryBuilder {
         return new BuiltDelivery(core);
     }
 }
+/**
+ * Exposes one configured Delivery through the public facade.
+ */
 class BuiltDelivery {
     context;
     storageFactory;
@@ -249,6 +266,11 @@ class BuiltDelivery {
     pageSize;
     inbox;
     #core;
+    /**
+     * Captures the configured core without changing its run lifetime.
+     *
+     * @param core Complete configured Delivery core.
+     */
     constructor(core) {
         this.#core = core;
         this.context = core.context;
@@ -259,8 +281,17 @@ class BuiltDelivery {
         this.pageSize = core.pageSize;
         this.inbox = core.inbox;
         controlledDeliveryRunners.set(this, (options) => core.runControlled(options));
+        controlledDeliveryWakers.set(this, (shard) => {
+            core.wake(shard);
+        });
         Object.freeze(this);
     }
+    /**
+     * Executes one finite shard delivery through the configured core.
+     *
+     * @param options Shard and endpoint callback for this run.
+     * @returns Terminal finite-run result.
+     */
     run(options) {
         return this.#core.run(options);
     }
@@ -269,16 +300,35 @@ class BuiltDelivery {
  * Groups immutable delivery configuration operations.
  */
 const DeliveryValues = Object.freeze({
+    /**
+     * Validates the physical shard count of a configured strategy.
+     *
+     * @param strategy Strategy to validate.
+     * @returns The validated strategy.
+     */
     requireStrategy(strategy) {
         if (!Number.isSafeInteger(strategy.shardCount) || strategy.shardCount <= 0) {
             throw new Error("Delivery strategy shard count must be a positive safe integer.");
         }
         return strategy;
     },
+    /**
+     * Captures a strategy while preserving its shard decision.
+     *
+     * @param strategy Strategy to snapshot.
+     * @returns Detached uniform strategy snapshot.
+     */
     snapshotStrategy(strategy) {
         const shardCount = this.requireStrategy(strategy).shardCount;
         return Object.freeze({
             shardCount,
+            /**
+             * Maps a typed target to its configured shard.
+             *
+             * @param targetId Typed delivery target identifier.
+             * @param targetType Declared target type URL.
+             * @returns Stable shard selected by the original strategy.
+             */
             shardFor(targetId, targetType) {
                 const shard = strategy.shardFor(InboxTargets.clone(targetId), targetType);
                 if (shard.ofTotal !== shardCount) {
@@ -288,6 +338,12 @@ const DeliveryValues = Object.freeze({
             },
         });
     },
+    /**
+     * Calculates a stable unsigned hash for a target key.
+     *
+     * @param value Canonical target key.
+     * @returns Stable unsigned hash.
+     */
     hash(value) {
         let result = 0;
         for (const character of value) {
@@ -295,6 +351,14 @@ const DeliveryValues = Object.freeze({
         }
         return result;
     },
+    /**
+     * Checks one positive bounded configuration value.
+     *
+     * @param name Name reported for invalid configuration.
+     * @param value Supplied configuration value.
+     * @param max Maximum accepted value.
+     * @returns The validated positive value.
+     */
     requireBound(name, value, max) {
         if (!Number.isSafeInteger(value) || value <= 0) {
             throw new Error(`${name} must be a positive safe integer.`);
@@ -304,12 +368,24 @@ const DeliveryValues = Object.freeze({
         }
         return value;
     },
+    /**
+     * Captures a valid storage context without caller mutation.
+     *
+     * @param context Storage context to validate.
+     * @returns Detached storage context.
+     */
     snapshotContext(context) {
         if (typeof context.name !== "string" || context.name.length === 0) {
             throw new Error("Delivery storage context name must be a non-empty string.");
         }
         return Object.freeze({ ...context });
     },
+    /**
+     * Captures a worker with its required node identifier.
+     *
+     * @param worker Delivery worker to validate.
+     * @returns Detached worker identifier.
+     */
     snapshotWorker(worker) {
         const nodeId = worker.nodeId;
         if (nodeId === undefined)
@@ -320,4 +396,17 @@ const DeliveryValues = Object.freeze({
         });
     },
 });
+/**
+ * Package-local validated strategy snapshot for the environment Delivery.
+ */
+export const deliveryStrategyAccess = Object.freeze({
+    /**
+     * Captures one environment strategy before any context routes targets.
+     * @param strategy Configured strategy.
+     * @returns Detached target-safe strategy.
+     */
+    snapshot(strategy) {
+        return DeliveryValues.snapshotStrategy(strategy);
+    },
+});
 //# sourceMappingURL=delivery-builder.js.map

package/dist/delivery/delivery-builder.js.map

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

package/dist/delivery/delivery-monitor.d.ts

@@ -1,13 +1,14 @@
 import type { InboxMessage } from "./inbox.js";
 import type { ShardIndex } from "./shard-index.js";
 /**
- * Executes a monitor-selected asynchronous reception outcome.
+ * Executes a monitor-selected asynchronous reception outcome. A normal return
+ * completes delivery and the enclosing delivery stage acknowledges the row.
  */
 export interface ReceptionAction {
     /**
      * Executes the selected reception outcome.
      *
-     * @returns A promise that settles when the outcome has completed.
+     * @returns A promise that settles when the outcome has completed; rejection propagates.
      */
     execute(): Promise<void>;
 }
@@ -31,12 +32,12 @@ export declare class FailedReception {
     private readonly mark;
     private readonly repeat;
     /**
-     * Creates facts and fallback actions for a failed reception.
+     * Creates facts and actions for a failed reception.
      *
      * @param message The message whose dispatch failed.
      * @param error The dispatch failure.
      * @param mark Marks the message delivered under the current shard session.
-     * @param repeat Repeats dispatch once under the current shard session.
+     * @param repeat Repeats processing under the current shard session.
      */
     constructor(message: InboxMessage, error: unknown, mark: () => Promise<void>, repeat: () => Promise<void>);
     /**
@@ -46,7 +47,7 @@ export declare class FailedReception {
      */
     markDelivered(): ReceptionAction;
     /**
-     * Returns one immediate repeat of the failed dispatch.
+     * Returns an immediate repeat of the failed dispatch.
      *
      * @returns The repeat-dispatch action.
      */
@@ -115,8 +116,10 @@ export interface DeliveryStatistics {
  * Controls finite delivery failure actions without scheduling retries.
  *
  * Subclasses can return direct values or promises from every hook. The default
- * reception policy marks the failed row delivered so independent targets keep
- * draining; it never persists attempts, receipts, markers, or quarantine data.
+ * reception policy marks a failed row delivered. A custom action that completes
+ * normally also completes delivery and the enclosing stage acknowledges the row.
+ * It never persists attempts,
+ * receipts, markers, or quarantine data.
  */
 export declare class DeliveryMonitor {
     /**
@@ -141,9 +144,9 @@ export declare class DeliveryMonitor {
      */
     onDeliveryCompleted(statistics: DeliveryStatistics): void | Promise<void>;
     /**
-     * Returns an action after endpoint dispatch or acknowledgement fails.
+     * Returns an action after a handler or its output/transition validation fails.
      *
-     * @param reception The failure facts and one-shot actions.
+     * @param reception The failure facts and actions; a failed repeat calls this hook again.
      * @returns The selected asynchronous reception action.
      */
     onReceptionFailure(reception: FailedReception): ReceptionAction | Promise<ReceptionAction>;

package/dist/delivery/delivery-monitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delivery-monitor.d.ts","sourceRoot":"","sources":["../../src/delivery/delivery-monitor.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,eAAe;IAG9B;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAG3B;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,eAAe;IAYxB,QAAQ,CAAC,OAAO,EAAE,YAAY;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAZzB;;;;;;;OAOG;gBAEQ,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,OAAO,EACN,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACzB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAG9C;;;;OAIG;IACH,aAAa,IAAI,eAAe;IAIhC;;;;OAIG;IACH,iBAAiB,IAAI,eAAe;CAGrC;AAED;;GAEG;AACH,qBAAa,YAAY;IAUrB,QAAQ,CAAC,KAAK,EAAE,UAAU;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO;IARzB;;;;;OAKG;gBAEQ,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,OAAO;IAGzB;;;;OAIG;IACH,IAAI,IAAI,YAAY;CAGrB;AAED;;GAEG;AACH,qBAAa,eAAe;IAQd,QAAQ,CAAC,KAAK,EAAE,UAAU;IALtC;;;;OAIG;gBACkB,KAAK,EAAE,UAAU;IAEtC;;;;OAIG;IACH,IAAI,IAAI,YAAY;CAGrB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAGjC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,qBAAa,eAAe;IAG1B;;;;;OAKG;IACH,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrE;;;;;OAKG;IACH,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D;;;;;OAKG;IACH,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzE;;;;;OAKG;IACH,kBAAkB,CAAC,SAAS,EAAE,eAAe,GAAG,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAI1F;;;;;OAKG;IACH,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAIjF;;;;;OAKG;IACH,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;CAGrF"}
+{"version":3,"file":"delivery-monitor.d.ts","sourceRoot":"","sources":["../../src/delivery/delivery-monitor.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAG9B;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAG3B;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,eAAe;IAYxB,QAAQ,CAAC,OAAO,EAAE,YAAY;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAZzB;;;;;;;OAOG;gBAEQ,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,OAAO,EACN,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACzB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAG9C;;;;OAIG;IACH,aAAa,IAAI,eAAe;IAMhC;;;;OAIG;IACH,iBAAiB,IAAI,eAAe;CAKrC;AAED;;GAEG;AACH,qBAAa,YAAY;IAUrB,QAAQ,CAAC,KAAK,EAAE,UAAU;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO;IARzB;;;;;OAKG;gBAEQ,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,OAAO;IAGzB;;;;OAIG;IACH,IAAI,IAAI,YAAY;CAGrB;AAED;;GAEG;AACH,qBAAa,eAAe;IAQd,QAAQ,CAAC,KAAK,EAAE,UAAU;IALtC;;;;OAIG;gBACkB,KAAK,EAAE,UAAU;IAEtC;;;;OAIG;IACH,IAAI,IAAI,YAAY;CAGrB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAGjC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAG1B;;;;;OAKG;IACH,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrE;;;;;OAKG;IACH,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D;;;;;OAKG;IACH,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzE;;;;;OAKG;IACH,kBAAkB,CAAC,SAAS,EAAE,eAAe,GAAG,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAI1F;;;;;OAKG;IACH,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAIjF;;;;;OAKG;IACH,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;CAGrF"}

package/dist/delivery/delivery-monitor.js

@@ -21,12 +21,12 @@ export class FailedReception {
     repeat;
     // prettier-ignore
     /**
-     * Creates facts and fallback actions for a failed reception.
+     * Creates facts and actions for a failed reception.
      *
      * @param message The message whose dispatch failed.
      * @param error The dispatch failure.
      * @param mark Marks the message delivered under the current shard session.
-     * @param repeat Repeats dispatch once under the current shard session.
+     * @param repeat Repeats processing under the current shard session.
      */
     constructor(message, error, mark, repeat) {
         this.message = message;
@@ -40,15 +40,19 @@ export class FailedReception {
      * @returns The acknowledgement action.
      */
     markDelivered() {
-        return Object.freeze({ execute: this.mark });
+        return Object.freeze({
+            execute: () => this.mark(),
+        });
     }
     /**
-     * Returns one immediate repeat of the failed dispatch.
+     * Returns an immediate repeat of the failed dispatch.
      *
      * @returns The repeat-dispatch action.
      */
     repeatDispatching() {
-        return Object.freeze({ execute: this.repeat });
+        return Object.freeze({
+            execute: () => this.repeat(),
+        });
     }
 }
 /**
@@ -104,8 +108,10 @@ export class AlreadyPickedUp {
  * Controls finite delivery failure actions without scheduling retries.
  *
  * Subclasses can return direct values or promises from every hook. The default
- * reception policy marks the failed row delivered so independent targets keep
- * draining; it never persists attempts, receipts, markers, or quarantine data.
+ * reception policy marks a failed row delivered. A custom action that completes
+ * normally also completes delivery and the enclosing stage acknowledges the row.
+ * It never persists attempts,
+ * receipts, markers, or quarantine data.
  */
 export class DeliveryMonitor {
     // prettier-ignore
@@ -138,9 +144,9 @@ export class DeliveryMonitor {
         void statistics;
     }
     /**
-     * Returns an action after endpoint dispatch or acknowledgement fails.
+     * Returns an action after a handler or its output/transition validation fails.
      *
-     * @param reception The failure facts and one-shot actions.
+     * @param reception The failure facts and actions; a failed repeat calls this hook again.
      * @returns The selected asynchronous reception action.
      */
     onReceptionFailure(reception) {

package/dist/delivery/delivery-monitor.js.map

@@ -1 +1 @@
-{"version":3,"file":"delivery-monitor.js","sourceRoot":"","sources":["../../src/delivery/delivery-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAiCH;;GAEG;AACH,MAAM,OAAO,eAAe;IAYf;IACA;IACQ;IACA;IAdnB,kBAAkB;IAElB;;;;;;;OAOG;IACH,YACW,OAAqB,EACrB,KAAc,EACN,IAAyB,EACzB,MAA2B;QAHnC,YAAO,GAAP,OAAO,CAAc;QACrB,UAAK,GAAL,KAAK,CAAS;QACN,SAAI,GAAJ,IAAI,CAAqB;QACzB,WAAM,GAAN,MAAM,CAAqB;IAC3C,CAAC;IAEJ;;;;OAIG;IACH,aAAa;QACX,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACH,iBAAiB;QACf,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;IAUZ;IACA;IAVX,kBAAkB;IAElB;;;;;OAKG;IACH,YACW,KAAiB,EACjB,KAAc;QADd,UAAK,GAAL,KAAK,CAAY;QACjB,UAAK,GAAL,KAAK,CAAS;IACtB,CAAC;IAEJ;;;;OAIG;IACH,IAAI;QACF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAe;IAQL;IAPrB,kBAAkB;IAElB;;;;OAIG;IACH,YAAqB,KAAiB;QAAjB,UAAK,GAAL,KAAK,CAAY;IAAG,CAAC;IAE1C;;;;OAIG;IACH,IAAI;QACF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF;AA6BD;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IAC1B,kBAAkB;IAElB;;;;;OAKG;IACH,mBAAmB,CAAC,KAAoB;QACtC,KAAK,KAAK,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,KAAiB;QACjC,KAAK,KAAK,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,mBAAmB,CAAC,UAA8B;QAChD,KAAK,UAAU,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,SAA0B;QAC3C,OAAO,SAAS,CAAC,aAAa,EAAE,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,oBAAoB,CAAC,OAAqB;QACxC,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACH,oBAAoB,CAAC,OAAwB;QAC3C,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;CACF"}
+{"version":3,"file":"delivery-monitor.js","sourceRoot":"","sources":["../../src/delivery/delivery-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAkCH;;GAEG;AACH,MAAM,OAAO,eAAe;IAYf;IACA;IACQ;IACA;IAdnB,kBAAkB;IAElB;;;;;;;OAOG;IACH,YACW,OAAqB,EACrB,KAAc,EACN,IAAyB,EACzB,MAA2B;QAHnC,YAAO,GAAP,OAAO,CAAc;QACrB,UAAK,GAAL,KAAK,CAAS;QACN,SAAI,GAAJ,IAAI,CAAqB;QACzB,WAAM,GAAN,MAAM,CAAqB;IAC3C,CAAC;IAEJ;;;;OAIG;IACH,aAAa;QACX,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE;SAC3B,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,iBAAiB;QACf,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE;SAC7B,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;IAUZ;IACA;IAVX,kBAAkB;IAElB;;;;;OAKG;IACH,YACW,KAAiB,EACjB,KAAc;QADd,UAAK,GAAL,KAAK,CAAY;QACjB,UAAK,GAAL,KAAK,CAAS;IACtB,CAAC;IAEJ;;;;OAIG;IACH,IAAI;QACF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAe;IAQL;IAPrB,kBAAkB;IAElB;;;;OAIG;IACH,YAAqB,KAAiB;QAAjB,UAAK,GAAL,KAAK,CAAY;IAAG,CAAC;IAE1C;;;;OAIG;IACH,IAAI;QACF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF;AA6BD;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAe;IAC1B,kBAAkB;IAElB;;;;;OAKG;IACH,mBAAmB,CAAC,KAAoB;QACtC,KAAK,KAAK,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,KAAiB;QACjC,KAAK,KAAK,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,mBAAmB,CAAC,UAA8B;QAChD,KAAK,UAAU,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,SAA0B;QAC3C,OAAO,SAAS,CAAC,aAAa,EAAE,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,oBAAoB,CAAC,OAAqB;QACxC,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACH,oBAAoB,CAAC,OAAwB;QAC3C,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/delivery/delivery-ports.d.ts

@@ -56,30 +56,23 @@ export interface DeliveryInbox {
      */
     markDelivered(message: InboxMessage, options?: DeliveryOperationOptions): Promise<InboxMessage | undefined>;
     /**
-     * Removes one exact pending duplicate while the supplied shard session remains current.
+     * Removes one pending duplicate by storage ID after delivery selects it.
      *
      * @param message Supplies the pending duplicate snapshot.
-     * @param session Supplies the session that currently holds the message shard.
      * @param options Propagates cancellation and a delivery deadline.
-     * @returns Whether the adapter removed the exact pending snapshot.
+     * @returns Whether the adapter deleted the ID.
      */
-    removeDuplicate(message: InboxMessage, session: DeliveryWorkSession, options?: DeliveryOperationOptions): Promise<boolean>;
+    removeDuplicate(message: InboxMessage, options?: DeliveryOperationOptions): Promise<boolean>;
     /**
-     * Removes one delivered snapshot while the supplied shard
-     * session remains current.
+     * Removes one eligible delivered message by storage ID.
      *
-     * Built-in direct Inbox storage implements this through its provider-owned
-     * ownership-and-delete operation. Custom structural ports may omit this
-     * optional retention capability. A remote adapter may only be able to check
-     * the snapshot and then issue a separate removal request, so this interface
-     * does not promise atomic compare-and-delete for every implementation.
+     * Custom structural ports may omit this optional retention capability.
      *
      * @param message Supplies the expected delivered row snapshot.
-     * @param session Supplies the currently owned shard session.
      * @param options Propagates cancellation and a delivery deadline.
      * @returns Whether the adapter completed its supported removal operation.
      */
-    removeDelivered?(message: InboxMessage, session: DeliveryWorkSession, options?: DeliveryOperationOptions): Promise<boolean>;
+    removeDelivered?(message: InboxMessage, options?: DeliveryOperationOptions): Promise<boolean>;
 }
 /**
  * Server-owned exclusive shard-work boundary.

package/dist/delivery/delivery-ports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delivery-ports.d.ts","sourceRoot":"","sources":["../../src/delivery/delivery-ports.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"delivery-ports.d.ts","sourceRoot":"","sources":["../../src/delivery/delivery-ports.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IAGvC;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAG5B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAElD;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEjG;;;;;;OAMG;IACH,IAAI,CACF,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,gBAAgB,GAAG,wBAAwB,GACpD,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;IAEpC;;;;;;OAMG;IACH,WAAW,CACT,EAAE,EAAE,cAAc,EAClB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IAErC;;;;;;OAMG;IACH,aAAa,CACX,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IAErC;;;;;;OAMG;IACH,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7F;;;;;;;;OAQG;IACH,eAAe,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/F;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IAGnC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAElD;;;;;;;OAOG;IACH,MAAM,CACJ,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,QAAQ,EAChB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;IAE5C;;;;;;OAMG;IACH,KAAK,CAAC,CACJ,OAAO,EAAE,yBAAyB,EAClC,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC,CAAC;IAElD;;;;;;;;;;OAUG;IACH,iBAAiB,CACf,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;IAE5C;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7F;AAED;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,YAAY,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAG3C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,GAAG,4BAA4B,CAAC"}