@tx5dr/plugin-api 1.7.12 → 2.0.0

package/dist/runtime.d.ts

@@ -1,5 +1,5 @@
-import type { ParsedFT8Message, FrameMessage, SlotInfo } from '@tx5dr/contracts';
-import type { StrategyDecision, StrategyDecisionMeta } from './hooks.js';
+import type { ParsedFT8Message, FrameMessage, SlotInfo, QSORecord } from '@tx5dr/contracts';
+import type { StrategyDecision } from './hooks.js';
 /**
  * Logical FT8 transmit slot identifiers used by the built-in automation model.
  *
@@ -41,7 +41,102 @@ export interface StrategyRuntimeSnapshot {
     context?: StrategyRuntimeContext;
     /** Optional list of user-visible next states, modes or branch hints. */
     availableSlots?: string[];
+    /** Host correlation token for QSO persistence; it is not an RF decision epoch. */
+    qsoLifecycleEpoch?: number;
+    /** Optional compact projection exposed by queue-capable strategies. */
+    queue?: AssistedQueueSnapshot;
 }
+/** User-facing phase shown for one row in a queue-capable strategy. */
+export type AssistedQueueDisplayState = 'TX1' | 'TX2' | 'TX3' | 'TX4' | 'TX5' | 'engaged' | 'closing' | 'paused' | 'no-response' | 'later' | 'review';
+/** Why a queued target is temporarily paused instead of being selected. */
+export type AssistedQueuePauseReason = 'target-busy' | 'stale';
+/** Semantic color treatment requested for an assisted queue row. */
+export type AssistedQueueTone = 'neutral' | 'active' | 'success' | 'warning' | 'danger';
+/** Host icon identifier requested for an assisted queue row. */
+export type AssistedQueueIcon = 'circle' | 'radio' | 'check-circle' | 'loader-circle' | 'clock' | 'pause' | 'triangle-alert';
+/** Stable, serializable UI projection of one queued target. */
+export interface AssistedQueueRow {
+    /** Queue-entry identity used by reorder/remove/retry commands. */
+    entryId: string;
+    /** Target station callsign. */
+    callsign: string;
+    /** Zero-based display order in the current snapshot. */
+    order: number;
+    /** Whether the UI may offer drag-to-reorder for this row. */
+    draggable: boolean;
+    /** Current protocol or queue phase shown to the operator. */
+    displayState: AssistedQueueDisplayState;
+    /** Semantic visual treatment for the row. */
+    tone: AssistedQueueTone;
+    /** Icon chosen by the strategy for the current state. */
+    icon: AssistedQueueIcon;
+    /** Why this row is paused, when `displayState` is `paused`. */
+    pauseReason?: AssistedQueuePauseReason;
+    /** Consecutive no-response cycles observed for this target. */
+    noResponseCycles?: number;
+    /** Last known Maidenhead grid locator for the target. */
+    targetGrid?: string;
+    /** Most recently decoded signal report in dB. */
+    lastSnr?: number;
+    /** Receive cycles elapsed since this target was last decoded. */
+    lastHeardCyclesAgo?: number;
+}
+/** Versioned queue projection embedded in `StrategyRuntimeSnapshot.queue`. */
+export interface AssistedQueueSnapshot {
+    /** Monotonically increasing revision used for optimistic mutations. */
+    version: number;
+    /** Entry currently owned by the active QSO lifecycle, when any. */
+    activeEntryId?: string;
+    /** Queue rows in display order. */
+    rows: AssistedQueueRow[];
+}
+/** Metadata supplied when a queue-capable strategy observes decoded messages. */
+export interface QueuedStrategyObservationMeta {
+    /** Slot that produced the decoded messages. */
+    slotInfo: SlotInfo;
+    /** Why the Host is asking the strategy to observe this batch. */
+    source: StrategyDecisionSource;
+    /** Aborts when this observation is superseded or the instance stops. */
+    signal: AbortSignal;
+}
+/** Target and optional triggering frame submitted to an assisted queue. */
+export interface QueuedStrategyTargetRequest {
+    /** Callsign to normalize and enqueue. */
+    callsign: string;
+    /** Authentic decoder frame/slot pair that triggered the request, when known. */
+    lastMessage?: {
+        message: FrameMessage;
+        slotInfo: SlotInfo;
+    };
+}
+/** Result of an assisted queue mutation, including the authoritative snapshot. */
+export interface QueuedStrategyMutationResult {
+    /** Whether the mutation changed the queue, was already satisfied, or was rejected. */
+    outcome: 'accepted' | 'duplicate' | 'rejected';
+    /** Machine-readable rejection reason. */
+    reason?: 'queue_full' | 'invalid_target' | 'entry_not_found' | 'entry_not_retryable' | 'active_entry' | 'version_conflict';
+    /** Authoritative queue state after the attempted mutation. */
+    snapshot: AssistedQueueSnapshot;
+}
+/** Optional capability implemented by strategies that own a target queue. */
+export interface QueuedStrategyRuntime extends StrategyRuntime {
+    /** Incorporates a decoded batch and returns whether the queue projection changed. */
+    observeDecodedMessages(messages: ParsedFT8Message[], meta: QueuedStrategyObservationMeta): boolean;
+    /** Adds a target unless it is invalid, duplicated or the queue is full. */
+    enqueueTarget(request: QueuedStrategyTargetRequest): QueuedStrategyMutationResult;
+    /** Moves an entry before another entry, or to the end when `beforeEntryId` is null. */
+    reorderTarget(entryId: string, beforeEntryId: string | null, expectedVersion: number): QueuedStrategyMutationResult;
+    /** Removes a non-active entry using optimistic version validation. */
+    removeTarget(entryId: string, expectedVersion: number): QueuedStrategyMutationResult;
+    /** Makes a retryable failed/no-response entry eligible again. */
+    retryTarget?(entryId: string, expectedVersion: number): QueuedStrategyMutationResult;
+    /** Removes every non-active entry using optimistic version validation. */
+    clearTargets?(expectedVersion: number): QueuedStrategyMutationResult;
+    /** Returns the current detached queue snapshot. */
+    getQueueSnapshot(): AssistedQueueSnapshot;
+}
+/** Runtime type guard for the optional assisted-target queue capability. */
+export declare function isQueuedStrategyRuntime(runtime: StrategyRuntime): runtime is QueuedStrategyRuntime;
 /**
  * Describes a slot text mutation emitted by the strategy runtime.
  */
@@ -51,6 +146,53 @@ export interface StrategyRuntimeSlotContentUpdate {
     /** Human-readable content for the slot, usually an FT8 message template. */
     content: string;
 }
+/** Trigger that caused the Host to request a strategy decision. */
+export type StrategyDecisionSource = 'slot-auto' | 'late-decode';
+/** Invocation metadata for a speculative API v2 strategy decision. */
+export interface StrategyDecisionMetaV2 {
+    /** Monotonic Host decision epoch; newer epochs supersede older decisions. */
+    epoch: number;
+    /** Slot progression or late-decode event that triggered the decision. */
+    source: StrategyDecisionSource;
+    /** `true` when new information caused the current slot to be evaluated again. */
+    isReDecision: boolean;
+    /** Aborts when this decision is superseded, times out or the instance stops. */
+    signal: AbortSignal;
+}
+/**
+ * Strategy-owned state captured before a speculative decision.
+ *
+ * The value must be structured-clone compatible and must not contain Host
+ * capabilities, functions, promises or external resource handles.
+ */
+export type StrategyRuntimeCheckpoint = unknown;
+/** Declarative request for the Host to durably commit one completed QSO. */
+export interface StrategyQSOCompletionEffect {
+    /** Complete QSO record to validate and persist. */
+    record: QSORecord;
+    /** Stable within one strategy runtime generation; distinct from RF decision epochs. */
+    lifecycleEpoch: number;
+}
+/** Host acknowledgement for a previously returned QSO completion effect. */
+export interface StrategyQSOCompletionSettlement {
+    /** Lifecycle epoch copied from the effect being settled. */
+    lifecycleEpoch: number;
+    /** Record ID from the accepted completion effect after Host persistence settles. */
+    recordId: string;
+    /** Whether the Host committed the record or the durable operation failed. */
+    status: 'committed' | 'failed';
+}
+/** Complete output of one speculative strategy decision. */
+export interface StrategyDecisionResult extends StrategyDecision {
+    /** Exact text to queue next, or `null` when this decision should not transmit. */
+    transmission: string | null;
+    /** UI/diagnostic snapshot produced from the same post-decision state. */
+    snapshot: StrategyRuntimeSnapshot;
+    /** Optional QSO persistence effect executed by the Host after acceptance. */
+    qsoCompletion?: StrategyQSOCompletionEffect;
+    /** Optional cycle selected from the triggering RX frame; applied by the host after target reservation. */
+    requestedTransmitCycle?: number;
+}
 /**
  * Active controller for a `strategy` plugin.
  *
@@ -59,16 +201,27 @@ export interface StrategyRuntimeSlotContentUpdate {
  * respect to the incoming slot/decode stream.
  */
 export interface StrategyRuntime {
+    /** Captures all mutable state needed to roll back the next decision. */
+    checkpoint(): StrategyRuntimeCheckpoint;
+    /** Restores a previously captured checkpoint after a decision is discarded. */
+    restore(checkpoint: StrategyRuntimeCheckpoint): void;
+    /**
+     * Optional acknowledgement for a declarative QSO effect. Implementations may
+     * use it to prevent a completed contact from leaking into the next lifecycle.
+     * The Host invokes it only for an accepted effect from the same runtime
+     * generation and reports whether durable persistence committed or failed.
+     */
+    settleQSOCompletion?(settlement: StrategyQSOCompletionSettlement): void;
     /**
      * Re-evaluates the current automation state using the latest decoded messages.
      *
-     * Return `{ stop: true }` to ask the host to stop transmitting. During a
-     * late re-decision (`meta.isReDecision === true`), the host also immediately
-     * aborts the operator's current live transmission contribution. Any other
-     * decision fields can be added in future API revisions, so plugins should
-     * return an object rather than a bare boolean.
+     * Return `{ stop: true }` to stop this operator's automation and prevent new
+     * frames. It never grants an RF interrupt: an already committed/on-air frame
+     * is allowed to finish. Explicit operator contribution removal is available
+     * only through the invocation-guarded `operator:transmit-control` command
+     * port outside speculative strategy execution.
      */
-    decide(messages: ParsedFT8Message[], meta?: StrategyDecisionMeta): Promise<StrategyDecision> | StrategyDecision;
+    decide(messages: ParsedFT8Message[], meta: StrategyDecisionMetaV2): Promise<StrategyDecisionResult> | StrategyDecisionResult;
     /**
      * Returns the exact text that should be transmitted next, or `null` when no
      * transmission should be queued.
@@ -79,11 +232,13 @@ export interface StrategyRuntime {
      *
      * The optional `lastMessage` provides the frame that triggered the call, which
      * is useful when reacting to a specific CQ or completion signal.
+     * Return exactly `false` to reject the target; `true` or `void` means the
+     * runtime accepted it and the Host may start the operator.
      */
     requestCall(callsign: string, lastMessage?: {
         message: FrameMessage;
         slotInfo: SlotInfo;
-    }): void;
+    }): boolean | void;
     /**
      * Produces a serializable runtime snapshot for diagnostics and UI.
      */

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,4DAA4D;IAC5D,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,6DAA6D;IAC7D,IAAI,EAAE,mBAAmB,CAAC;IAC1B,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;OAQG;IACH,MAAM,CACJ,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,IAAI,CAAC,EAAE,oBAAoB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAAC;IAEhD;;;OAGG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;;OAKG;IACH,WAAW,CACT,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,YAAY,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,GAC1D,IAAI,CAAC;IAER;;OAEG;IACH,WAAW,IAAI,uBAAuB,CAAC;IAEvC;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAE3C;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,gCAAgC,GAAG,IAAI,CAAC;IAE/D;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;;;OAIG;IACH,oBAAoB,CAAC,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACnD"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}

package/dist/runtime.js

@@ -1,2 +1,10 @@
-export {};
+/** Runtime type guard for the optional assisted-target queue capability. */
+export function isQueuedStrategyRuntime(runtime) {
+    const candidate = runtime;
+    return typeof candidate.observeDecodedMessages === 'function'
+        && typeof candidate.enqueueTarget === 'function'
+        && typeof candidate.reorderTarget === 'function'
+        && typeof candidate.removeTarget === 'function'
+        && typeof candidate.getQueueSnapshot === 'function';
+}
 //# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":""}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAuJA,4EAA4E;AAC5E,MAAM,UAAU,uBAAuB,CAAC,OAAwB;IAC9D,MAAM,SAAS,GAAG,OAAyC,CAAC;IAC5D,OAAO,OAAO,SAAS,CAAC,sBAAsB,KAAK,UAAU;WACxD,OAAO,SAAS,CAAC,aAAa,KAAK,UAAU;WAC7C,OAAO,SAAS,CAAC,aAAa,KAAK,UAAU;WAC7C,OAAO,SAAS,CAAC,YAAY,KAAK,UAAU;WAC5C,OAAO,SAAS,CAAC,gBAAgB,KAAK,UAAU,CAAC;AACxD,CAAC"}

package/dist/settings.d.ts

@@ -4,33 +4,57 @@ import type { DecodeWindowSettings, NtpServerListSettings, PresetFrequency, PSKR
  * the `settings:ft8` permission.
  */
 export interface HostFT8Settings {
+    /** Station callsign used by the digital-mode engine. */
     myCallsign: string;
+    /** Station Maidenhead grid locator. */
     myGrid: string;
+    /** Current digital-mode dial frequency in hertz. */
     frequency: number;
+    /** Configured transmit power in watts. */
     transmitPower: number;
+    /** Whether the Host automatically answers eligible decoded calls. */
     autoReply: boolean;
+    /** No-progress receive/transmit cycles before the active QSO times out. */
     maxQSOTimeout: number;
     /** Set to 0 to disable the host repeated-transmission guard. */
     maxSameTransmissionCount: number;
+    /** Whether decoding continues while any operator is transmitting. */
     decodeWhileTransmitting: boolean;
+    /** Whether spectrum analysis continues while transmitting. */
     spectrumWhileTransmitting: boolean;
 }
+/** Partial update accepted by `ctx.settings.ft8.update()`. */
 export type HostFT8SettingsPatch = Partial<HostFT8Settings>;
+/** Current frequency preset list and whether it differs from Host defaults. */
 export interface HostFrequencyPresetsSettings {
+    /** Presets currently exposed by the Host. */
     presets: PresetFrequency[];
+    /** `true` when the current list is user- or plugin-customized. */
     isCustomized: boolean;
 }
+/** Partial station metadata update accepted by the station namespace. */
 export type HostStationInfoPatch = Partial<StationInfo>;
+/** Partial PSK Reporter update accepted by the PSK Reporter namespace. */
 export type HostPSKReporterSettingsPatch = Partial<PSKReporterConfig>;
+/**
+ * Read/update pair shared by patch- or replacement-based settings namespaces.
+ * The concrete namespace type determines whether `update` is a partial patch or
+ * complete replacement. Host schema validation, normalization or persistence
+ * failures reject the returned Promise.
+ */
 export interface HostSettingsNamespace<TValue, TPatch> {
     /** Returns the current host setting value for this namespace. */
     get(): Promise<TValue>;
     /** Applies a patch or replacement value and returns the updated value. */
     update(patch: TPatch): Promise<TValue>;
 }
+/** Frequency preset namespace with explicit update and reset operations. */
 export interface HostFrequencyPresetsSettingsNamespace {
+    /** Returns the current preset list and customization flag. */
     get(): Promise<HostFrequencyPresetsSettings>;
+    /** Replaces all presets and returns the normalized Host value. */
     update(presets: PresetFrequency[]): Promise<HostFrequencyPresetsSettings>;
+    /** Restores Host defaults and returns the resulting value. */
     reset(): Promise<HostFrequencyPresetsSettings>;
 }
 /**
@@ -40,12 +64,19 @@ export interface HostFrequencyPresetsSettingsNamespace {
  * `settings:ft8` for `ctx.settings.ft8`.
  */
 export interface HostSettingsControl {
+    /** FT8/FT4 engine settings. Requires `settings:ft8`. */
     readonly ft8: HostSettingsNamespace<HostFT8Settings, HostFT8SettingsPatch>;
+    /** Decode window configuration. Requires `settings:decode-windows`. */
     readonly decodeWindows: HostSettingsNamespace<DecodeWindowSettings, DecodeWindowSettings>;
+    /** Realtime audio transport configuration. Requires `settings:realtime`. */
     readonly realtime: HostSettingsNamespace<RealtimeSettings, RealtimeSettings>;
+    /** Frequency preset list. Requires `settings:frequency-presets`. */
     readonly frequencyPresets: HostFrequencyPresetsSettingsNamespace;
+    /** Public station metadata. Requires `settings:station`. */
     readonly station: HostSettingsNamespace<StationInfo, HostStationInfoPatch>;
+    /** PSK Reporter configuration. Requires `settings:psk-reporter`. */
     readonly pskReporter: HostSettingsNamespace<PSKReporterConfig, HostPSKReporterSettingsPatch>;
+    /** NTP server list. Requires `settings:ntp`. */
     readonly ntp: HostSettingsNamespace<NtpServerListSettings, UpdateNtpServerListRequest>;
 }
 //# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,0BAA0B,EAC3B,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,wBAAwB,EAAE,MAAM,CAAC;IACjC,uBAAuB,EAAE,OAAO,CAAC;IACjC,yBAAyB,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAE5D,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AACxD,MAAM,MAAM,4BAA4B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEtE,MAAM,WAAW,qBAAqB,CAAC,MAAM,EAAE,MAAM;IACnD,iEAAiE;IACjE,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACvB,0EAA0E;IAC1E,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,qCAAqC;IACpD,GAAG,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC7C,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC1E,KAAK,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAAC;CAChD;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,qBAAqB,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC;IAC3E,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC;IAC1F,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;IAC7E,QAAQ,CAAC,gBAAgB,EAAE,qCAAqC,CAAC;IACjE,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;IAC3E,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC,iBAAiB,EAAE,4BAA4B,CAAC,CAAC;IAC7F,QAAQ,CAAC,GAAG,EAAE,qBAAqB,CAAC,qBAAqB,EAAE,0BAA0B,CAAC,CAAC;CACxF"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,0BAA0B,EAC3B,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,SAAS,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,aAAa,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,wBAAwB,EAAE,MAAM,CAAC;IACjC,qEAAqE;IACrE,uBAAuB,EAAE,OAAO,CAAC;IACjC,8DAA8D;IAC9D,yBAAyB,EAAE,OAAO,CAAC;CACpC;AAED,8DAA8D;AAC9D,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAE5D,+EAA+E;AAC/E,MAAM,WAAW,4BAA4B;IAC3C,6CAA6C;IAC7C,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,kEAAkE;IAClE,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,yEAAyE;AACzE,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AACxD,0EAA0E;AAC1E,MAAM,MAAM,4BAA4B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB,CAAC,MAAM,EAAE,MAAM;IACnD,iEAAiE;IACjE,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACvB,0EAA0E;IAC1E,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,4EAA4E;AAC5E,MAAM,WAAW,qCAAqC;IACpD,8DAA8D;IAC9D,GAAG,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC7C,kEAAkE;IAClE,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC1E,8DAA8D;IAC9D,KAAK,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAAC;CAChD;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,QAAQ,CAAC,GAAG,EAAE,qBAAqB,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC;IAC3E,uEAAuE;IACvE,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC;IAC1F,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;IAC7E,oEAAoE;IACpE,QAAQ,CAAC,gBAAgB,EAAE,qCAAqC,CAAC;IACjE,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;IAC3E,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC,iBAAiB,EAAE,4BAA4B,CAAC,CAAC;IAC7F,gDAAgD;IAChD,QAAQ,CAAC,GAAG,EAAE,qBAAqB,CAAC,qBAAqB,EAAE,0BAA0B,CAAC,CAAC;CACxF"}

package/dist/sync.d.ts

@@ -4,6 +4,8 @@
  * A utility plugin registers a sync provider via `ctx.logbookSync.register()`
  * during `onLoad`. The host manages per-callsign lifecycle, auto-upload on QSO
  * completion, and renders the provider's settings page in the sync modal.
+ * Registration requires a global API v2 utility with `logbook:sync`; the
+ * referenced settings page must use `resourceBinding: 'callsign'`.
  */
 /**
  * A logbook sync provider implements the communication logic with a single
@@ -14,10 +16,15 @@
  * its own per-callsign state (typically via `ctx.store.global` keyed by
  * callsign).
  *
- * The provider has full access to the logbook via `ctx.logbook` and is
- * responsible for querying, writing and deduplicating QSO records internally.
- * The host only routes user actions to provider methods — it does not read or
- * write QSOs on the provider's behalf.
+ * A typical provider declares `network`, `logbook:read`, `logbook:write` and
+ * `logbook:sync`. It is responsible for querying, writing and deduplicating QSO
+ * records internally. The host routes actions and passes narrow auto-upload
+ * batches; it does not invent provider-specific synchronization behavior.
+ *
+ * Every method runs inside a fresh Host invocation. Results that complete after
+ * unload/reload are discarded. Return structured `failures` for expected
+ * operational problems; reserve thrown errors for unexpected failures. Provider
+ * results, details and progress payloads must remain JSON-compatible.
  */
 export interface LogbookSyncProvider {
     /** Stable service identifier (e.g. 'lotw', 'qrz', 'wavelog'). */
@@ -28,7 +35,7 @@ export interface LogbookSyncProvider {
     readonly icon?: string;
     /** Optional button color hint for the frontend (HeroUI color name). */
     readonly color?: 'default' | 'primary' | 'secondary' | 'success' | 'warning' | 'danger';
-    /** Which audience may access this provider through host runtime routes. */
+    /** Which audience may access Host routes for this provider. Defaults to `admin`. */
     readonly accessScope?: 'admin' | 'operator';
     /**
      * ID of the settings page declared in `PluginDefinition.ui.pages`.
@@ -44,7 +51,7 @@ export interface LogbookSyncProvider {
      * an iframe page for user input before proceeding (`pageId`).
      */
     readonly actions?: SyncAction[];
-    /** Tests whether the external service connection is healthy. */
+    /** Tests credentials/connectivity and returns a user-displayable result. */
     testConnection(callsign: string): Promise<SyncTestResult>;
     /**
      * Uploads QSO records to the external service.
@@ -108,65 +115,113 @@ export interface SyncAction {
      */
     operation?: 'upload' | 'download' | 'full_sync';
 }
+/** Layer that produced a synchronization failure. */
 export type SyncFailureSource = 'provider' | 'host' | 'remote' | 'network' | 'logbook';
+/** User-visible synchronization operation associated with a failure. */
 export type SyncFailureOperation = 'upload' | 'download' | 'full_sync' | 'preflight' | 'test_connection';
+/**
+ * Structured failure intended for logs and plugin UI.
+ *
+ * Construct failures with `createSyncFailure()` or `errorToSyncFailure()` so
+ * common credentials are redacted. Direct object construction performs no
+ * automatic sanitization.
+ */
 export interface SyncFailure {
+    /** Stable machine-readable code owned by the provider or Host. */
     code: string;
+    /** Short display message; callers constructing directly must sanitize secrets. */
     message: string;
+    /** Layer that produced the failure. */
     source?: SyncFailureSource;
+    /** Sync operation that was in progress. */
     operation?: SyncFailureOperation;
+    /** Provider ID when the failure crosses a shared Host surface. */
     providerId?: string;
+    /** Local QSO record ID for a per-record failure. */
     qsoId?: string;
+    /** Remote station callsign for a per-record failure. */
     qsoCallsign?: string;
+    /** HTTP response status when a remote request reached the server. */
     httpStatus?: number;
+    /** Whether retrying later without changing input may succeed. */
     retryable?: boolean;
+    /** Optional diagnostic detail; callers constructing directly must sanitize it. */
     detail?: string;
 }
+/** Input accepted by `createSyncFailure`, including values that must be redacted. */
 export type SyncFailureInput = Omit<SyncFailure, 'message' | 'detail'> & {
     message?: string;
     detail?: string;
     secrets?: Array<string | undefined | null>;
 };
+/** Best-effort redaction of explicit secrets and common credential-bearing URL/query patterns. */
 export declare function sanitizeSyncFailureText(value: unknown, secrets?: Array<string | undefined | null>): string;
+/** Builds a normalized failure after sanitizing its message and detail. */
 export declare function createSyncFailure(input: SyncFailureInput): SyncFailure;
+/** Converts an unknown thrown value into a normalized, sanitized failure. */
 export declare function errorToSyncFailure(error: unknown, defaults: SyncFailureInput): SyncFailure;
+/** Formats one failure for compact user-facing lists. */
 export declare function failureMessage(failure: SyncFailure): string;
+/** Result returned by `LogbookSyncProvider.testConnection()`. */
 export interface SyncTestResult {
+    /** Whether credentials and the tested remote operation succeeded. */
     success: boolean;
     /** Human-readable result description. */
     message?: string;
     /** Additional service-specific details (e.g. account info, logbook count). */
     details?: unknown;
+    /** Structured failures when the test did not fully succeed. */
     failures?: SyncFailure[];
 }
+/** Aggregate result returned after an upload attempt. */
 export interface SyncUploadResult {
     /** Number of records submitted to the external service. */
     submitted?: number;
     /** @deprecated Upload providers should not verify by querying the external service; download sync owns confirmation. */
     verified?: number;
+    /** Records accepted by the remote service and committed to local sync state. */
     uploaded: number;
+    /** Records intentionally not submitted, for example because they were already sent. */
     skipped: number;
+    /** Records that could not be uploaded. */
     failed: number;
+    /** Structured per-record or operation failures. */
     failures?: SyncFailure[];
 }
+/** Incremental upload status sent to an optional in-process progress callback. */
 export interface SyncUploadProgress {
+    /** Current upload pipeline phase. */
     stage: 'preparing' | 'prepared' | 'batch_uploading' | 'batch_accepted' | 'batch_failed' | 'updating_local' | 'finished';
+    /** Station callsign whose logbook is being synchronized. */
     callsign?: string;
+    /** One-based current batch number. */
     batchIndex?: number;
+    /** Total number of upload batches. */
     batchCount?: number;
+    /** QSO records represented by the current progress event. */
     qsoCount?: number;
+    /** Records discovered as pending upload. */
     pendingCount?: number;
+    /** Pending records eligible for this upload. */
     uploadableCount?: number;
+    /** Pending records blocked by preflight validation. */
     blockedCount?: number;
+    /** Records submitted to the remote service so far. */
     submitted?: number;
+    /** Records accepted and reflected in local sync state so far. */
     uploaded?: number;
     /** @deprecated Upload providers should not verify by querying the external service; download sync owns confirmation. */
     verified?: number;
+    /** Records intentionally skipped so far. */
     skipped?: number;
+    /** Records whose upload failed so far. */
     failed?: number;
+    /** Structured failures accumulated so far. */
     failureCount?: number;
+    /** Optional short status text for custom UIs. */
     message?: string;
 }
+/** Optional range, source batch and progress callback for an upload. */
 export interface SyncUploadOptions {
     /** Distinguishes manual uploads from auto-upload triggered by QSO completion. */
     trigger?: 'manual' | 'auto';
@@ -188,6 +243,7 @@ export interface SyncUploadOptions {
      */
     records?: import('@tx5dr/contracts').QSORecord[];
 }
+/** Range and inclusion rules used by an upload readiness check. */
 export interface SyncUploadPreflightOptions {
     /** Check records starting at this timestamp (epoch ms), inclusive. */
     since?: number;
@@ -196,23 +252,39 @@ export interface SyncUploadPreflightOptions {
     /** Include records already marked as uploaded/sent locally. Defaults to false. */
     includeAlreadyUploaded?: boolean;
 }
+/** One actionable issue discovered before upload starts. */
 export interface SyncPreflightIssue {
+    /** Stable provider-owned issue code. */
     code: string;
+    /** Whether the issue is informational, cautionary or blocking. */
     severity: 'info' | 'warning' | 'error';
+    /** Short user-facing explanation. */
     message: string;
+    /** Optional sanitized diagnostic or remediation detail. */
     detail?: string;
+    /** Local QSO ID when the issue concerns one record. */
     qsoId?: string;
+    /** Target callsign when the issue concerns one record. */
     qsoCallsign?: string;
 }
+/** Aggregate readiness result shown before an upload or full sync. */
 export interface SyncUploadPreflightResult {
+    /** Whether upload can start without skipping blocking records. */
     ready: boolean;
+    /** Records currently awaiting upload. */
     pendingCount: number;
+    /** Pending records that can be uploaded now. */
     uploadableCount: number;
+    /** Pending records blocked by validation or missing data. */
     blockedCount: number;
+    /** Structured issues for the operation or individual records. */
     issues?: SyncPreflightIssue[];
+    /** Whether the provider supports continuing with only uploadable records. */
     canSkipBlocked?: boolean;
+    /** Optional ordered remediation hints for the UI. */
     guidance?: string[];
 }
+/** Aggregate result returned after downloading and reconciling remote data. */
 export interface SyncDownloadResult {
     /** Number of records downloaded from the external service. */
     downloaded: number;
@@ -224,25 +296,43 @@ export interface SyncDownloadResult {
     imported?: number;
     /** Number of provider request windows used to download the range. */
     windowCount?: number;
+    /** Structured request, parsing or per-record failures. */
     failures?: SyncFailure[];
 }
+/** Incremental status sent while a provider downloads one or more windows. */
 export interface SyncDownloadProgress {
+    /** Current download pipeline phase. */
     stage: 'preparing' | 'window_waiting' | 'window_downloading' | 'window_retrying' | 'window_processing' | 'window_done' | 'window_failed' | 'finished';
+    /** Station callsign whose logbook is being synchronized. */
     callsign?: string;
+    /** One-based current request-window number. */
     windowIndex?: number;
+    /** Total request windows planned for the selected range. */
     windowCount?: number;
+    /** Human-readable date/time range represented by the current window. */
     range?: string;
+    /** Provider-mandated wait before the next request. */
     waitSeconds?: number;
+    /** One-based retry attempt for the current window. */
     attempt?: number;
+    /** Remote records returned by the current window. */
     recordCount?: number;
+    /** Remote records downloaded so far. */
     downloaded?: number;
+    /** Remote records matched to existing local QSOs so far. */
     matched?: number;
+    /** Existing local QSOs updated so far. */
     updated?: number;
+    /** New remote records imported so far. */
     imported?: number;
+    /** Records/windows that failed so far. */
     failed?: number;
+    /** Structured failures accumulated so far. */
     failureCount?: number;
+    /** Optional short status text for custom UIs. */
     message?: string;
 }
+/** Optional date range and progress callback for a download. */
 export interface SyncDownloadOptions {
     /** Download records since this timestamp (epoch ms). */
     since?: number;
@@ -261,6 +351,8 @@ export interface LogbookSyncRegistrar {
      *
      * A single plugin may register multiple providers (e.g. one plugin
      * supporting both upload and download for different services).
+     * The Host unregisters every provider owned by the plugin generation during
+     * disable, reload or unload.
      */
     register(provider: LogbookSyncProvider): void;
 }

package/dist/sync.d.ts.map

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