@tx5dr/plugin-api 1.7.12 → 2.5.0

package/dist/toolkit/parallel-qso/ParallelQSOCoordinator.test.js

@@ -0,0 +1,470 @@
+import { describe, expect, it } from 'vitest';
+import { ParallelQSOCoordinator } from './ParallelQSOCoordinator.js';
+function completion(callsign, lifecycleEpoch) {
+    return {
+        lifecycleEpoch,
+        record: {
+            id: `qso-${callsign}`,
+            callsign,
+            frequency: 14_074_000,
+            mode: 'FT8',
+            startTime: 1,
+            endTime: 2,
+            messageHistory: [],
+            myCallsign: 'BG5DRB',
+        },
+    };
+}
+class TestProtocolLane {
+    constructor(streamId, audioFrequencyHz) {
+        this.streamId = streamId;
+        this.audioFrequencyHz = audioFrequencyHz;
+        this.physicalReceipts = [];
+        this.settlements = [];
+        this.lifecycleEpoch = 0;
+        this.observed = 0;
+        this.pending = false;
+        this.observeOnly = false;
+        this.decisionMutations = 0;
+    }
+    activate(entry) {
+        if (this.active)
+            return { accepted: false };
+        this.active = structuredClone(entry);
+        this.lifecycleEpoch += 1;
+        return { accepted: true };
+    }
+    deactivate() {
+        this.pending = this.active?.data.keepPendingAfterDeactivate === true;
+        this.observeOnly = this.active?.data.keepObserveAfterDeactivate === true;
+        this.active = undefined;
+    }
+    hasPendingWork() {
+        return this.active !== undefined || this.pending;
+    }
+    shouldObserve() {
+        return this.observeOnly;
+    }
+    observe(_messages, _meta) {
+        if (!this.active)
+            return false;
+        this.observed += 1;
+        return true;
+    }
+    async decide(_messages, _meta) {
+        if (this.decisionError)
+            throw this.decisionError;
+        await this.decisionGate;
+        if (!this.active)
+            return {};
+        this.decisionMutations += 1;
+        const failure = this.active.data.fail ? {
+            targetCallsign: this.active.callsign,
+            reason: 'timeout',
+            stage: 'TX1',
+        } : undefined;
+        return {
+            qsoCompletion: this.active.data.complete
+                ? completion(this.active.callsign, this.lifecycleEpoch)
+                : undefined,
+            qsoFailure: failure,
+            release: this.active.data.release ? {
+                disposition: this.active.data.release,
+                reason: failure ? 'failed' : 'complete',
+            } : undefined,
+        };
+    }
+    getTransmitText() {
+        return this.active?.data.text ?? null;
+    }
+    getSnapshot() {
+        if (!this.active)
+            return null;
+        return {
+            currentState: this.active.data.state ?? 'calling',
+            targetCallsign: this.active.callsign,
+            qsoLifecycleEpoch: this.lifecycleEpoch,
+            stateOptions: [
+                { id: 'calling', label: 'stateCalling', transmitText: this.active.data.text },
+                { id: 'answering', label: 'stateAnswering', transmitText: `R ${this.active.data.text}` },
+            ],
+        };
+    }
+    setUserState(stateId) {
+        if (!this.active || !['calling', 'answering'].includes(stateId))
+            return false;
+        if (this.active.data.state === stateId)
+            return false;
+        this.active.data.state = stateId;
+        return true;
+    }
+    checkpoint() {
+        return structuredClone({
+            active: this.active,
+            lifecycleEpoch: this.lifecycleEpoch,
+            physicalReceipts: this.physicalReceipts,
+            settlements: this.settlements,
+            observed: this.observed,
+            pending: this.pending,
+            observeOnly: this.observeOnly,
+            decisionMutations: this.decisionMutations,
+        });
+    }
+    restore(checkpoint) {
+        const state = structuredClone(checkpoint);
+        this.active = state.active;
+        this.lifecycleEpoch = state.lifecycleEpoch;
+        this.physicalReceipts.splice(0, this.physicalReceipts.length, ...state.physicalReceipts);
+        this.settlements.splice(0, this.settlements.length, ...state.settlements);
+        this.observed = state.observed;
+        this.pending = state.pending;
+        this.observeOnly = state.observeOnly;
+        this.decisionMutations = state.decisionMutations;
+    }
+    onPhysicalSuccess(receipt) {
+        this.physicalReceipts.push(structuredClone(receipt));
+    }
+    settleQSOCompletion(settlement) {
+        this.settlements.push(structuredClone(settlement));
+    }
+    reset() {
+        this.active = undefined;
+        this.lifecycleEpoch = 0;
+        this.physicalReceipts.length = 0;
+        this.settlements.length = 0;
+        this.observed = 0;
+        this.pending = false;
+        this.observeOnly = false;
+        this.decisionMutations = 0;
+        this.decisionGate = undefined;
+        this.decisionError = undefined;
+    }
+    setDecisionGate(gate) { this.decisionGate = gate; }
+    setDecisionError(error) { this.decisionError = error; }
+    getDecisionMutations() { return this.decisionMutations; }
+}
+function createCoordinator(initialMaxStreams = 3) {
+    const lanes = [];
+    const coordinator = new ParallelQSOCoordinator({
+        maxSupportedStreams: 5,
+        initialMaxStreams,
+        createLane({ streamId, laneIndex }) {
+            const lane = new TestProtocolLane(streamId, 1_000 + laneIndex * 100);
+            lanes.push(lane);
+            return lane;
+        },
+    });
+    return { coordinator, lanes };
+}
+function enqueue(coordinator, callsign, data = {}, requestedTransmitCycle) {
+    return coordinator.enqueue({
+        targetKey: callsign,
+        callsign,
+        requestedTransmitCycle,
+        data: { text: `${callsign} BG5DRB OL32`, ...data },
+    });
+}
+const decisionMeta = {
+    epoch: 1,
+    source: 'slot-auto',
+    isReDecision: false,
+    signal: new AbortController().signal,
+};
+describe('ParallelQSOCoordinator', () => {
+    it('routes custom state changes to one lifecycle-scoped stream', async () => {
+        const { coordinator } = createCoordinator(1);
+        enqueue(coordinator, 'JA1AAA');
+        await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 });
+        const epoch = coordinator.getStreams()[0].qsoLifecycleEpoch;
+        expect(coordinator.setStreamState('stream-1', 'answering', epoch)).toBe(true);
+        expect(coordinator.getStreams()[0]).toMatchObject({ currentState: 'answering' });
+        expect(() => coordinator.setStreamState('stream-1', 'calling', epoch + 1))
+            .toThrow('stream_lifecycle_conflict');
+        expect(() => coordinator.setStreamState('stream-1', 'not-exposed', epoch))
+            .toThrow('stream_state_not_available');
+    });
+    it('assigns stable streams in queue order and keeps incompatible cycles waiting', async () => {
+        const { coordinator } = createCoordinator();
+        const first = enqueue(coordinator, 'JA1AAA', {}, 1).entry;
+        const incompatible = enqueue(coordinator, 'JA2BBB', {}, 0).entry;
+        const flexible = enqueue(coordinator, 'JA3CCC').entry;
+        const fill = await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 });
+        expect(fill).toEqual({
+            activatedEntryIds: [first.entryId, flexible.entryId],
+            rejectedEntryIds: [],
+            requestedTransmitCycle: 1,
+        });
+        expect(coordinator.getTransmissions()).toEqual([
+            { streamId: 'stream-1', text: 'JA1AAA BG5DRB OL32', audioFrequencyHz: 1_000 },
+            { streamId: 'stream-2', text: 'JA3CCC BG5DRB OL32', audioFrequencyHz: 1_100 },
+        ]);
+        expect(coordinator.getQueueSnapshot()).toMatchObject({
+            activeEntryIds: [first.entryId, flexible.entryId],
+            entries: [
+                { entry: { callsign: 'JA1AAA' }, streamId: 'stream-1', active: true },
+                { entry: { callsign: 'JA3CCC' }, streamId: 'stream-2', active: true },
+                { entry: { entryId: incompatible.entryId, callsign: 'JA2BBB' }, active: false },
+            ],
+        });
+    });
+    it('shrinks without preempting active lanes and reuses the lowest stable stream', async () => {
+        const { coordinator } = createCoordinator();
+        const entries = ['JA1AAA', 'JA2BBB', 'JA3CCC', 'JA4DDD']
+            .map((callsign) => enqueue(coordinator, callsign).entry);
+        await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 });
+        coordinator.setMaxStreams(1);
+        expect(coordinator.getQueueSnapshot().activeEntryIds).toEqual(entries.slice(0, 3).map((entry) => entry.entryId));
+        expect(await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 })).toMatchObject({
+            activatedEntryIds: [],
+        });
+        coordinator.releaseEntry(entries[0].entryId, { removeEntry: true, reason: 'done' });
+        coordinator.releaseEntry(entries[1].entryId, { removeEntry: true, reason: 'done' });
+        expect(await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 })).toMatchObject({
+            activatedEntryIds: [],
+        });
+        coordinator.releaseEntry(entries[2].entryId, { removeEntry: true, reason: 'done' });
+        const refill = await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 });
+        expect(refill.activatedEntryIds).toEqual([entries[3].entryId]);
+        expect(coordinator.getQueueSnapshot().entries[0]).toMatchObject({
+            streamId: 'stream-1',
+            entry: { entryId: entries[3].entryId },
+        });
+    });
+    it('can preempt excess lanes when a Host safety limit is reduced', async () => {
+        const { coordinator } = createCoordinator();
+        const entries = ['JA1AAA', 'JA2BBB', 'JA3CCC']
+            .map((callsign) => enqueue(coordinator, callsign).entry);
+        await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 });
+        coordinator.setMaxStreams(1);
+        expect(coordinator.setMaxStreams(1, { preemptExcess: true })).toEqual([
+            entries[1].entryId,
+            entries[2].entryId,
+        ]);
+        expect(coordinator.getQueueSnapshot().activeEntryIds).toEqual([entries[0].entryId]);
+    });
+    it('does not assign a new target to an unbound lane with protocol-owned pending work', async () => {
+        const { coordinator, lanes } = createCoordinator(2);
+        const leaseOwner = enqueue(coordinator, 'JA1AAA', {
+            keepPendingAfterDeactivate: true,
+        }).entry;
+        await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 });
+        coordinator.releaseEntry(leaseOwner.entryId, { removeEntry: true, reason: 'lease retained' });
+        const next = enqueue(coordinator, 'JA2BBB').entry;
+        const waiting = enqueue(coordinator, 'JA3CCC').entry;
+        const fill = await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 });
+        expect(fill.activatedEntryIds).toEqual([next.entryId]);
+        expect(coordinator.getQueueSnapshot()).toMatchObject({
+            activeEntryIds: [next.entryId],
+            entries: [
+                { streamId: 'stream-2', entry: { entryId: next.entryId } },
+                { active: false, entry: { entryId: waiting.entryId } },
+            ],
+        });
+        expect(lanes[0].hasPendingWork()).toBe(true);
+        const cleared = coordinator.clear(coordinator.getQueueSnapshot().version);
+        expect(cleared.affectedStreamIds).toEqual(['stream-1', 'stream-2']);
+        expect(lanes[0].hasPendingWork()).toBe(false);
+    });
+    it('clears a lane that only remains observable after its queue entry is gone', async () => {
+        const { coordinator, lanes } = createCoordinator(1);
+        const entry = enqueue(coordinator, 'JA1AAA', {
+            keepObserveAfterDeactivate: true,
+        }).entry;
+        await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 });
+        coordinator.releaseEntry(entry.entryId, { removeEntry: true, reason: 'lease retained' });
+        expect(lanes[0].hasPendingWork()).toBe(false);
+        expect(lanes[0].shouldObserve()).toBe(true);
+        const beforeVersion = coordinator.getQueueSnapshot().version;
+        const cleared = coordinator.clear(beforeVersion);
+        expect(cleared.affectedStreamIds).toEqual(['stream-1']);
+        expect(cleared.version).toBe(beforeVersion + 1);
+        expect(lanes[0].shouldObserve()).toBe(false);
+    });
+    it('prefers a completely idle lane before reusing a passive observer', async () => {
+        const { coordinator } = createCoordinator(2);
+        const observed = enqueue(coordinator, 'JA1AAA', {
+            keepObserveAfterDeactivate: true,
+        }).entry;
+        await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 });
+        coordinator.releaseEntry(observed.entryId, { removeEntry: true, reason: 'observe after completion' });
+        const next = enqueue(coordinator, 'JA2BBB').entry;
+        const fill = await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 });
+        expect(fill.activatedEntryIds).toEqual([next.entryId]);
+        expect(coordinator.getQueueSnapshot().entries[0]).toMatchObject({
+            streamId: 'stream-2',
+            entry: { entryId: next.entryId },
+        });
+    });
+    it('aggregates lane effects and releases only the lanes that requested it', async () => {
+        const { coordinator } = createCoordinator();
+        const completed = enqueue(coordinator, 'JA1AAA', {
+            complete: true,
+            release: 'remove-entry',
+        }).entry;
+        const failed = enqueue(coordinator, 'JA2BBB', {
+            fail: true,
+            release: 'retain-entry',
+        }).entry;
+        const active = enqueue(coordinator, 'JA3CCC').entry;
+        await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 });
+        const result = await coordinator.decide([], decisionMeta);
+        expect(result.qsoCompletions).toMatchObject([{
+                streamId: 'stream-1',
+                record: { callsign: 'JA1AAA' },
+            }]);
+        expect(result.qsoFailures).toEqual([expect.objectContaining({ targetCallsign: 'JA2BBB' })]);
+        expect(result.releasedEntries).toEqual([
+            {
+                streamId: 'stream-1',
+                entryId: completed.entryId,
+                disposition: 'remove-entry',
+                reason: 'complete',
+            },
+            {
+                streamId: 'stream-2',
+                entryId: failed.entryId,
+                disposition: 'retain-entry',
+                reason: 'failed',
+            },
+        ]);
+        expect(result.transmissions).toEqual([
+            { streamId: 'stream-3', text: 'JA3CCC BG5DRB OL32', audioFrequencyHz: 1_200 },
+        ]);
+        expect(result.activeEntryIds).toEqual([active.entryId]);
+        expect(coordinator.getQueueSnapshot().entries).toMatchObject([
+            { entry: { entryId: active.entryId }, active: true },
+            { entry: { entryId: failed.entryId }, active: false },
+        ]);
+    });
+    it('routes identical physical messages and settlements by stream identity', async () => {
+        const { coordinator, lanes } = createCoordinator(2);
+        enqueue(coordinator, 'JA1AAA', { text: 'SAME MESSAGE' });
+        enqueue(coordinator, 'JA2BBB', { text: 'SAME MESSAGE' });
+        await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 });
+        const receipt = {
+            streamId: 'stream-2',
+            text: 'SAME MESSAGE',
+            audioFrequencyHz: 1_100,
+            frameId: 'frame-1',
+            revision: 2,
+            physicalConfirmed: true,
+        };
+        expect(coordinator.onPhysicalReceipts([receipt])).toEqual(['stream-2']);
+        expect(lanes[0].physicalReceipts).toHaveLength(0);
+        expect(lanes[1].physicalReceipts).toEqual([receipt]);
+        expect(coordinator.settleQSOCompletion({
+            streamId: 'stream-1',
+            lifecycleEpoch: 1,
+            recordId: 'record-1',
+            status: 'committed',
+        })).toBe(true);
+        expect(lanes[0].settlements).toHaveLength(1);
+        expect(lanes[1].settlements).toHaveLength(0);
+        expect(coordinator.settleQSOCompletion({
+            lifecycleEpoch: 1,
+            recordId: 'record-legacy',
+            status: 'committed',
+        })).toBe(false);
+    });
+    it('restores queue, lane, concurrency and protocol state from a cloneable checkpoint', async () => {
+        const { coordinator } = createCoordinator(2);
+        const first = enqueue(coordinator, 'JA1AAA').entry;
+        enqueue(coordinator, 'JA2BBB');
+        enqueue(coordinator, 'JA3CCC');
+        await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 });
+        const observationMeta = {
+            slotInfo: {
+                id: 'slot-1',
+                startMs: 0,
+                utcSeconds: 0,
+                phaseMs: 0,
+                driftMs: 0,
+                cycleNumber: 0,
+                mode: 'FT8',
+            },
+            source: 'slot-auto',
+            signal: new AbortController().signal,
+        };
+        coordinator.observe([], observationMeta);
+        const checkpoint = structuredClone(coordinator.checkpoint());
+        const beforeQueue = coordinator.getQueueSnapshot();
+        const beforeStreams = coordinator.getStreams();
+        coordinator.setMaxStreams(1);
+        coordinator.remove(first.entryId, coordinator.getQueueSnapshot().version);
+        coordinator.clear(coordinator.getQueueSnapshot().version);
+        coordinator.restore(checkpoint);
+        expect(coordinator.getQueueSnapshot()).toEqual(beforeQueue);
+        expect(coordinator.getStreams()).toEqual(beforeStreams);
+        expect(coordinator.getMaxStreams()).toBe(2);
+        expect(() => structuredClone(coordinator.checkpoint())).not.toThrow();
+    });
+    it('waits for every lane to settle before an error can trigger checkpoint restore', async () => {
+        const { coordinator, lanes } = createCoordinator(2);
+        enqueue(coordinator, 'JA1AAA');
+        enqueue(coordinator, 'JA2BBB');
+        await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 });
+        const checkpoint = coordinator.checkpoint();
+        let releaseDelayedLane;
+        const delayedLane = new Promise((resolve) => { releaseDelayedLane = resolve; });
+        lanes[0].setDecisionError(new Error('lane failed'));
+        lanes[1].setDecisionGate(delayedLane);
+        let rejected = false;
+        const pending = coordinator.decide([], decisionMeta).catch((error) => {
+            rejected = true;
+            throw error;
+        });
+        await Promise.resolve();
+        expect(rejected).toBe(false);
+        expect(lanes[1].getDecisionMutations()).toBe(0);
+        releaseDelayedLane();
+        await expect(pending).rejects.toThrow('lane failed');
+        expect(lanes[1].getDecisionMutations()).toBe(1);
+        coordinator.restore(checkpoint);
+        expect(lanes[1].getDecisionMutations()).toBe(0);
+        await Promise.resolve();
+        expect(lanes[1].getDecisionMutations()).toBe(0);
+    });
+    it('serializes optimistic queue mutations and keeps active rows immutable', async () => {
+        const { coordinator } = createCoordinator(1);
+        const first = enqueue(coordinator, 'JA1AAA').entry;
+        const secondResult = enqueue(coordinator, 'JA2BBB');
+        const second = secondResult.entry;
+        expect(enqueue(coordinator, 'JA2BBB').outcome).toBe('duplicate');
+        await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 });
+        expect(coordinator.reorder(first.entryId, null, coordinator.getQueueSnapshot().version)).toMatchObject({
+            outcome: 'rejected',
+            reason: 'active_entry',
+        });
+        expect(coordinator.reorder(second.entryId, null, secondResult.version)).toMatchObject({
+            outcome: 'rejected',
+            reason: 'version_conflict',
+        });
+        const currentVersion = coordinator.getQueueSnapshot().version;
+        expect(coordinator.reorder(second.entryId, null, currentVersion)).toMatchObject({
+            outcome: 'accepted',
+            version: currentVersion,
+        });
+    });
+    it('only observes lanes with an active binding or protocol-owned pending work', async () => {
+        const { coordinator, lanes } = createCoordinator(2);
+        enqueue(coordinator, 'JA1AAA');
+        await coordinator.fillAvailableLanes({ currentTransmitCycle: 0 });
+        const meta = {
+            slotInfo: {
+                id: 'slot-1',
+                startMs: 0,
+                utcSeconds: 0,
+                phaseMs: 0,
+                driftMs: 0,
+                cycleNumber: 0,
+                mode: 'FT8',
+            },
+            source: 'slot-auto',
+            signal: new AbortController().signal,
+        };
+        expect(coordinator.observe([], meta)).toBe(true);
+        expect(lanes[0].checkpoint().observed).toBe(1);
+        expect(lanes[1].checkpoint().observed).toBe(0);
+    });
+});
+//# sourceMappingURL=ParallelQSOCoordinator.test.js.map

package/dist/toolkit/parallel-qso/ParallelQSOCoordinator.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParallelQSOCoordinator.test.js","sourceRoot":"","sources":["../../../src/toolkit/parallel-qso/ParallelQSOCoordinator.test.ts"],"names":[],"mappings":"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"}

package/dist/toolkit/parallel-qso/PostCompletionRecoveryLease.d.ts

@@ -0,0 +1,20 @@
+export interface RecoveryMatch<TMessage, TAction> {
+    matches(message: TMessage): boolean;
+    action: TAction;
+}
+/** Protocol-neutral receive-cycle lease for post-completion recovery. */
+export declare class PostCompletionRecoveryLease<TMessage, TAction> {
+    private readonly matches;
+    private remainingReceiveCycles;
+    constructor(receiveCycles: number, matches: readonly RecoveryMatch<TMessage, TAction>[]);
+    get active(): boolean;
+    observe(messages: readonly TMessage[]): TAction[];
+    advanceReceiveCycle(): void;
+    checkpoint(): {
+        remainingReceiveCycles: number;
+    };
+    restore(checkpoint: {
+        remainingReceiveCycles: number;
+    }): void;
+}
+//# sourceMappingURL=PostCompletionRecoveryLease.d.ts.map

package/dist/toolkit/parallel-qso/PostCompletionRecoveryLease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostCompletionRecoveryLease.d.ts","sourceRoot":"","sources":["../../../src/toolkit/parallel-qso/PostCompletionRecoveryLease.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa,CAAC,QAAQ,EAAE,OAAO;IAC9C,OAAO,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC;IACpC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,yEAAyE;AACzE,qBAAa,2BAA2B,CAAC,QAAQ,EAAE,OAAO;IAKtD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,sBAAsB,CAAS;gBAGrC,aAAa,EAAE,MAAM,EACJ,OAAO,EAAE,SAAS,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE;IAQvE,IAAI,MAAM,IAAI,OAAO,CAA4C;IAEjE,OAAO,CAAC,QAAQ,EAAE,SAAS,QAAQ,EAAE,GAAG,OAAO,EAAE;IAQjD,mBAAmB,IAAI,IAAI;IAI3B,UAAU,IAAI;QAAE,sBAAsB,EAAE,MAAM,CAAA;KAAE;IAIhD,OAAO,CAAC,UAAU,EAAE;QAAE,sBAAsB,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAG9D"}

package/dist/toolkit/parallel-qso/PostCompletionRecoveryLease.js

@@ -0,0 +1,29 @@
+/** Protocol-neutral receive-cycle lease for post-completion recovery. */
+export class PostCompletionRecoveryLease {
+    constructor(receiveCycles, matches) {
+        this.matches = matches;
+        if (!Number.isInteger(receiveCycles) || receiveCycles < 1) {
+            throw new Error('Recovery receive cycles must be a positive integer');
+        }
+        this.remainingReceiveCycles = receiveCycles;
+    }
+    get active() { return this.remainingReceiveCycles > 0; }
+    observe(messages) {
+        if (!this.active)
+            return [];
+        return messages.flatMap((message) => {
+            const match = this.matches.find((candidate) => candidate.matches(message));
+            return match ? [structuredClone(match.action)] : [];
+        });
+    }
+    advanceReceiveCycle() {
+        this.remainingReceiveCycles = Math.max(0, this.remainingReceiveCycles - 1);
+    }
+    checkpoint() {
+        return { remainingReceiveCycles: this.remainingReceiveCycles };
+    }
+    restore(checkpoint) {
+        this.remainingReceiveCycles = Math.max(0, Math.trunc(checkpoint.remainingReceiveCycles));
+    }
+}
+//# sourceMappingURL=PostCompletionRecoveryLease.js.map

package/dist/toolkit/parallel-qso/PostCompletionRecoveryLease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostCompletionRecoveryLease.js","sourceRoot":"","sources":["../../../src/toolkit/parallel-qso/PostCompletionRecoveryLease.ts"],"names":[],"mappings":"AAKA,yEAAyE;AACzE,MAAM,OAAO,2BAA2B;IAGtC,YACE,aAAqB,EACJ,OAAoD;QAApD,YAAO,GAAP,OAAO,CAA6C;QAErE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,sBAAsB,GAAG,aAAa,CAAC;IAC9C,CAAC;IAED,IAAI,MAAM,KAAc,OAAO,IAAI,CAAC,sBAAsB,GAAG,CAAC,CAAC,CAAC,CAAC;IAEjE,OAAO,CAAC,QAA6B;QACnC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAC5B,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;YAC3E,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,mBAAmB;QACjB,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,sBAAsB,GAAG,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,UAAU;QACR,OAAO,EAAE,sBAAsB,EAAE,IAAI,CAAC,sBAAsB,EAAE,CAAC;IACjE,CAAC;IAED,OAAO,CAAC,UAA8C;QACpD,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAC3F,CAAC;CACF"}

package/dist/toolkit/parallel-qso/ProtocolLane.d.ts

@@ -0,0 +1,50 @@
+import type { ParsedFT8Message } from '@tx5dr/contracts';
+import type { QSOFailureInfo } from '../../hooks.js';
+import type { StrategyDecisionMetaV2, StrategyQSOCompletionEffect, StrategyQSOCompletionSettlement, StrategyStreamSnapshot, StreamPhysicalReceipt, QueuedStrategyObservationMeta } from '../../runtime.js';
+export interface ParallelQSOQueueEntry<TData> {
+    entryId: string;
+    targetKey: string;
+    callsign: string;
+    requestedTransmitCycle?: 0 | 1;
+    data: TData;
+}
+export interface ProtocolLaneIdentity {
+    streamId: string;
+    laneIndex: number;
+}
+export interface ProtocolLaneActivation {
+    accepted: boolean;
+}
+export interface ProtocolLaneRelease {
+    disposition: 'remove-entry' | 'retain-entry';
+    reason: string;
+}
+export interface ProtocolLaneDecision<TData = unknown> {
+    qsoCompletion?: StrategyQSOCompletionEffect;
+    qsoFailure?: QSOFailureInfo;
+    release?: ProtocolLaneRelease;
+    entryData?: TData;
+    queueChanged?: boolean;
+}
+export type ProtocolLaneSnapshot = Omit<StrategyStreamSnapshot, 'streamId' | 'audioFrequencyHz'>;
+/** One stable RF stream that can host successive protocol sessions. */
+export interface ProtocolLane<TData> {
+    readonly streamId: string;
+    readonly audioFrequencyHz: number;
+    activate(entry: Readonly<ParallelQSOQueueEntry<TData>>): ProtocolLaneActivation;
+    deactivate(reason: string): void;
+    hasPendingWork(): boolean;
+    shouldObserve?(): boolean;
+    observe?(messages: ParsedFT8Message[], meta: QueuedStrategyObservationMeta): boolean;
+    decide(messages: ParsedFT8Message[], meta: StrategyDecisionMetaV2): ProtocolLaneDecision<TData> | Promise<ProtocolLaneDecision<TData>>;
+    getTransmitText(): string | null;
+    getSnapshot(): ProtocolLaneSnapshot | null;
+    setUserState?(stateId: string): boolean;
+    invokeAction?(actionId: string, payload?: unknown): import('../../runtime.js').StrategyActionResult | void | Promise<import('../../runtime.js').StrategyActionResult | void>;
+    checkpoint(): unknown;
+    restore(checkpoint: unknown): void;
+    onPhysicalSuccess?(receipt: StreamPhysicalReceipt): void;
+    settleQSOCompletion?(settlement: StrategyQSOCompletionSettlement): boolean | void;
+    reset(reason?: string): void;
+}
+//# sourceMappingURL=ProtocolLane.d.ts.map

package/dist/toolkit/parallel-qso/ProtocolLane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProtocolLane.d.ts","sourceRoot":"","sources":["../../../src/toolkit/parallel-qso/ProtocolLane.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,+BAA+B,EAC/B,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,EAC9B,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,qBAAqB,CAAC,KAAK;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,EAAE,KAAK,CAAC;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,cAAc,GAAG,cAAc,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB,CAAC,KAAK,GAAG,OAAO;IACnD,aAAa,CAAC,EAAE,2BAA2B,CAAC;IAC5C,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,sBAAsB,EACtB,UAAU,GAAG,kBAAkB,CAChC,CAAC;AAEF,uEAAuE;AACvE,MAAM,WAAW,YAAY,CAAC,KAAK;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,GAAG,sBAAsB,CAAC;IAChF,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,IAAI,OAAO,CAAC;IAC1B,aAAa,CAAC,IAAI,OAAO,CAAC;IAE1B,OAAO,CAAC,CAAC,QAAQ,EAAE,gBAAgB,EAAE,EAAE,IAAI,EAAE,6BAA6B,GAAG,OAAO,CAAC;IACrF,MAAM,CACJ,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,IAAI,EAAE,sBAAsB,GAC3B,oBAAoB,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;IAEtE,eAAe,IAAI,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,IAAI,oBAAoB,GAAG,IAAI,CAAC;IAC3C,YAAY,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACxC,YAAY,CAAC,CACX,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,kBAAkB,EAAE,oBAAoB,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,kBAAkB,EAAE,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAE5H,UAAU,IAAI,OAAO,CAAC;IACtB,OAAO,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,iBAAiB,CAAC,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACzD,mBAAmB,CAAC,CAAC,UAAU,EAAE,+BAA+B,GAAG,OAAO,GAAG,IAAI,CAAC;IAClF,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B"}

package/dist/toolkit/parallel-qso/ProtocolLane.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ProtocolLane.js.map

package/dist/toolkit/parallel-qso/ProtocolLane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProtocolLane.js","sourceRoot":"","sources":["../../../src/toolkit/parallel-qso/ProtocolLane.ts"],"names":[],"mappings":""}

package/dist/toolkit/parallel-qso/controllers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=controllers.test.d.ts.map

package/dist/toolkit/parallel-qso/controllers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controllers.test.d.ts","sourceRoot":"","sources":["../../../src/toolkit/parallel-qso/controllers.test.ts"],"names":[],"mappings":""}