@tx5dr/plugin-api 2.0.0 → 2.5.0

package/dist/hooks.d.ts

@@ -56,6 +56,8 @@ export interface StrategyDecision {
     };
     /** Optional structured reason for a strategy-requested QSO failure stop. */
     qsoFailure?: QSOFailureInfo;
+    /** Parallel lane failures emitted by one accepted decision. */
+    qsoFailures?: QSOFailureInfo[];
 }
 /**
  * Metadata describing why a strategy decision is being evaluated.

package/dist/hooks.d.ts.map

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

package/dist/index.d.ts

@@ -21,22 +21,28 @@
  */
 /** Core plugin definition and lifecycle interfaces. */
 export { definePlugin } from './definition.js';
+export { assertPluginApiCompatible, comparePluginApiVersions, PluginApiCompatibilityError, } from './compatibility.js';
 export { PLUGIN_COMMAND_CAPABILITY_PERMISSIONS, PLUGIN_CONTEXT_CAPABILITY_KEYS, getPluginContextCapabilityKeys, } from './capabilities.js';
 export type { PluginContextCapabilityKey, PluginContextCapabilityPermission, } from './capabilities.js';
 export type { PluginDefinition, AnyPluginDefinition } from './definition.js';
+export type { SimulationMode, SimulationPeerIdentity, SimulationScenarioChoice, SimulationScenarioRule, SimulationScenarioTimeoutRule, SimulationScenarioState, SimulationAddressedRestartPolicy, SimulationScenarioDescriptor, } from './simulation.js';
 export type { PluginContext, PluginContextBase, PluginCleanupContext, PluginContextFor, RuntimePluginContext, StrategyPluginContext, PluginEligibilityContext, } from './context.js';
+export type { PluginAfterStartupTask, PluginLifecyclePort } from './context.js';
 export type { HostDependencies, HamlibHostDependency, HamlibRotator, HamlibRotatorConstructor, HamlibSupportedRotatorInfo, HamlibRotatorConnectionInfo, HamlibRotatorPosition, HamlibRotatorStatus, HamlibRotatorDirection, HamlibRotatorResetType, HamlibConfigFieldDescriptor, HamlibPortCaps, HamlibRotatorCaps, } from './host-dependencies.js';
 export type { PluginHooks, AutoCallProposal, AutoCallExecutionRequest, AutoCallExecutionPlan, SlotActivityEvent, FrequencyChangeState, ScoredCandidate, StrategyDecision, StrategyDecisionMeta, LastMessageInfo, QSOFailureInfo, } from './hooks.js';
-export type { StrategyRuntime, StrategyRuntimeContext, StrategyRuntimeSnapshot, StrategyRuntimeSlot, StrategyRuntimeSlotContentUpdate, StrategyRuntimeCheckpoint, StrategyDecisionMetaV2, StrategyDecisionResult, StrategyDecisionSource, StrategyQSOCompletionEffect, StrategyQSOCompletionSettlement, AssistedQueueDisplayState, AssistedQueuePauseReason, AssistedQueueTone, AssistedQueueIcon, AssistedQueueRow, AssistedQueueSnapshot, QueuedStrategyObservationMeta, QueuedStrategyTargetRequest, QueuedStrategyMutationResult, QueuedStrategyRuntime, } from './runtime.js';
+export type { StrategyRuntime, StrategyRuntimeContext, StrategyRuntimeSnapshot, StrategyMessagePresentationTone, StrategyMessagePresentationBadge, StrategyMessagePresentationClass, StrategyMessagePresentationProjection, StrategyMessagePresentationNoveltyRule, StrategyMessagePresentationTagRule, StrategyTransmitGate, StrategyStateOption, StrategyActionDescriptor, StrategyActionInput, StrategyActionTone, StrategyActionPresentation, StrategyAttention, StrategyCompletionProjection, StrategyActionTarget, StrategyActionInvocation, StrategyActionResult, StrategyLogbookSessionEffect, StrategyStreamSnapshot, StrategyStreamStateUpdate, StrategyTransmission, StreamPhysicalReceipt, StrategyRuntimeSlot, StrategyRuntimeSlotContentUpdate, StrategyRuntimeCheckpoint, StrategyOperatorTransmitCyclesChanged, StrategyDecisionMetaV2, StrategyDecisionResult, StrategyDecisionSource, StrategyQSOCompletionEffect, StrategyQSOCompletionSettlement, AssistedQueueDisplayState, AssistedQueuePauseReason, AssistedQueueTone, AssistedQueueIcon, AssistedQueueRow, AssistedQueueSnapshot, QueuedStrategyObservationMeta, QueuedStrategyTargetRequest, QueuedStrategyMutationResult, QueuedStrategyRuntime, } from './runtime.js';
 export { isQueuedStrategyRuntime } from './runtime.js';
 export type { HostSettingsControl, HostSettingsNamespace, HostFrequencyPresetsSettingsNamespace, HostFT8Settings, HostFT8SettingsPatch, HostFrequencyPresetsSettings, HostStationInfoPatch, HostPSKReporterSettingsPatch, } from './settings.js';
 /** Host-provided helper interfaces available through {@link PluginContext}. */
-export type { KVStore, PluginLogger, PluginTimers, OtherOperatorSnapshot, OperatorSnapshot, OperatorCommandPort, PluginOperatorCommand, PluginOperatorCommandResult, RadioView, RadioOperatingMode, RadioCapabilitiesView, RadioCommandPort, PluginRadioCommand, RadioTunerCommandPort, PluginRadioTunerCommand, RadioPowerView, RadioPowerCommandPort, PluginRadioPowerCommand, RadioPowerSetOptions, LogbookAccess, LogbookReadAccess, LogbookCommandPort, CallsignLogbookAccess, CallsignLogbookReadAccess, CallsignLogbookCommandPort, QSOQueryFilter, BandAccess, IdleTransmitFrequencyOptions, AutoTargetEligibilityReason, AutoTargetEligibilityDecision, UIBridge, PanelMeta, PluginUIHandler, PluginUIRequestContext, PluginUIRequestUser, PluginUIBoundResource, PluginUIInstanceTarget, PluginUIPageSessionInfo, PluginUIPageContext, PluginFileStore, PluginNetworkControl, PluginEventBus, PluginEventBusMessage, PluginUdpControl, PluginUdpSocket, PluginUdpSocketOptions, PluginUdpBindOptions, PluginUdpRemoteInfo, } from './helpers.js';
+export type { KVStore, DigitalMessagePreflight, DigitalMessagePreflightRequest, DigitalMessagePreflightResult, PluginLogger, PluginTimers, OtherOperatorSnapshot, OperatorSnapshot, OperatorCommandPort, PluginOperatorCommand, PluginOperatorCommandResult, RadioView, RadioOperatingMode, RadioCapabilitiesView, RadioCommandPort, PluginRadioCommand, RadioTunerCommandPort, PluginRadioTunerCommand, RadioPowerView, RadioPowerCommandPort, PluginRadioPowerCommand, RadioPowerSetOptions, LogbookAccess, LogbookReadAccess, LogbookCommandPort, CallsignLogbookAccess, CallsignLogbookReadAccess, CallsignLogbookCommandPort, PluginLogbookSessionDescriptor, PluginLogbookSessionAccess, PluginLogbookSessions, QSOQueryFilter, BandAccess, IdleTransmitFrequencyOptions, AutoTargetEligibilityReason, AutoTargetEligibilityDecision, UIBridge, PanelMeta, PluginUIHandler, PluginUIHandlerRegistration, PluginUIRequestContext, PluginUIRequestUser, PluginUIBoundResource, PluginUIInstanceTarget, PluginUIPageSessionInfo, PluginUIPageContext, PluginFileStore, PluginNetworkControl, PluginEventBus, ReadonlyKVStore, PluginEventBusMessage, PluginUdpControl, PluginUdpSocket, PluginUdpSocketOptions, PluginUdpBindOptions, PluginUdpRemoteInfo, } from './helpers.js';
+export type { LogbookBatchMutation, LogbookBatchOptions, LogbookBatchOutcome, LogbookBatchResult, LogbookQsoSnapshot, } from '@tx5dr/core';
+/** Atomic contest-QSO contract and its durable private-field codec. */
+export { CONTEST_QSO_ENVELOPE_MAX_BYTES, ContestQsoEnvelopeSchema, parseContestQsoEnvelope, serializeContestQsoEnvelope, } from '@tx5dr/contracts';
 /** Callsign and DXCC helpers available to plugins. */
 export { getCallsignInfo, listDXCCEntities, resolveDXCCEntity, } from '@tx5dr/core';
 export type { CallsignInfo, DXCCEntity, DXCCResolutionResult, } from '@tx5dr/core';
 /** Common radio/message/settings types re-exported for plugin author convenience. */
-export type { FT8Message, FT8MessageBase, FT8MessageCQ, FT8MessageCall, FT8MessageSignalReport, FT8MessageRogerReport, FT8MessageRRR, FT8MessageSeventyThree, FT8MessageFoxRR73, FT8MessageCustom, FT8MessageUnknown, ParsedFT8Message, LogbookAnalysis, SlotInfo, SlotPack, FrequencyState, QSORecord, FrameMessage, ModeDescriptor, OperatorSlots, DxccStatus, TargetSelectionPriorityMode, PluginType, PluginInstanceScope, PluginPermission, PluginSettingType, PluginSettingDescriptor, PluginSettingScope, PluginQuickAction, PluginQuickSetting, PluginCapability, PluginPanelDescriptor, PluginPanelComponent, PluginPanelWidth, PluginPanelOpenMode, PluginPanelUISize, PluginUIPanelContributionGroup, PluginUIPanelContributionTarget, PluginObjectArrayField, PluginKeyedStringArrayKey, PluginSettingCondition, PluginSettingConditionalDescription, PluginSettingOption, PluginStorageScope, PluginStorageConfig, PluginManifest, PluginStatus, PluginUIPageDescriptor, PluginUIConfig, CapabilityList, CapabilityState, CapabilityDescriptor, CapabilityValue, WriteCapabilityPayload, RadioPowerRequest, RadioPowerResponse, RadioPowerState, RadioPowerStateEvent, RadioPowerSupportInfo, RadioPowerTarget, DecodeWindowSettings, RealtimeSettings, RealtimeSettingsResponseData, PresetFrequency, StationInfo, PSKReporterConfig, NtpServerListSettings, UpdateNtpServerListRequest, } from '@tx5dr/contracts';
+export type { FT8Message, FT8MessageBase, FT8MessageCQ, FT8MessageCall, FT8MessageSignalReport, FT8MessageRogerReport, FT8MessageRRR, FT8MessageSeventyThree, FT8MessageFoxRR73, FT8MessageCustom, FT8MessageUnknown, ParsedFT8Message, LogbookAnalysis, SlotInfo, SlotPack, FrequencyState, QSORecord, ContestQsoEnvelope, FrameMessage, ModeDescriptor, OperatorSlots, DxccStatus, TargetSelectionPriorityMode, PluginType, PluginInstanceScope, PluginPermission, PluginSettingType, PluginSettingDescriptor, PluginSettingScope, PluginQuickAction, PluginQuickSetting, PluginCapability, PluginPanelDescriptor, PluginPanelComponent, PluginPanelWidth, PluginPanelOpenMode, PluginPanelUISize, PluginUIPanelContributionGroup, PluginUIPanelContributionTarget, PluginObjectArrayField, PluginKeyedStringArrayKey, PluginSettingCondition, PluginSettingConditionalDescription, PluginSettingOption, PluginStorageScope, PluginStorageConfig, PluginManifest, PluginStatus, PluginUIPageDescriptor, PluginUIConfig, CapabilityList, CapabilityState, CapabilityDescriptor, CapabilityValue, WriteCapabilityPayload, RadioPowerRequest, RadioPowerResponse, RadioPowerState, RadioPowerStateEvent, RadioPowerSupportInfo, RadioPowerTarget, DecodeWindowSettings, RealtimeSettings, RealtimeSettingsResponseData, PresetFrequency, StationInfo, PSKReporterConfig, NtpServerListSettings, UpdateNtpServerListRequest, } from '@tx5dr/contracts';
 /** Logbook sync provider interfaces. */
 export type { LogbookSyncProvider, LogbookSyncRegistrar, SyncAction, SyncFailure, SyncFailureInput, SyncFailureOperation, SyncFailureSource, SyncTestResult, SyncUploadProgress, SyncUploadOptions, SyncUploadPreflightOptions, SyncUploadResult, SyncPreflightIssue, SyncUploadPreflightResult, SyncDownloadProgress, SyncDownloadResult, SyncDownloadOptions, } from './sync.js';
 export { createSyncFailure, errorToSyncFailure, failureMessage, sanitizeSyncFailureText, } from './sync.js';
@@ -49,6 +55,10 @@ export { parseADIFContent, parseADIFRecord, parseADIFFields, convertQSOToADIF, g
 /** Plugin page scope path utilities. */
 export { getPluginPageFileScopePath, getPluginPageScopePath, getPluginPageScopeSegments, getPluginPageStorePath, } from './utils/page-scope.js';
 export type { PluginPageBoundResource } from './utils/page-scope.js';
+/** Composable FT8/FT4 contest rules, assembler and framework-neutral test kit. */
+export * from './toolkit/contest/index.js';
+/** Reusable standard FT8/FT4 QSO runtime for external strategy plugins. */
+export * from './ft8/index.js';
 /** QSO text field utilities. */
 export { buildSignalReportComment, parseQsoTextFields, parseLegacyComment, parseMessageHistoryText, resolveQsoComment, buildCommentFromMessageHistory, normalizeMessageHistory, sanitizeAdifFieldValue, } from './utils/qso-text-fields.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -21,8 +21,11 @@
  */
 /** Core plugin definition and lifecycle interfaces. */
 export { definePlugin } from './definition.js';
+export { assertPluginApiCompatible, comparePluginApiVersions, PluginApiCompatibilityError, } from './compatibility.js';
 export { PLUGIN_COMMAND_CAPABILITY_PERMISSIONS, PLUGIN_CONTEXT_CAPABILITY_KEYS, getPluginContextCapabilityKeys, } from './capabilities.js';
 export { isQueuedStrategyRuntime } from './runtime.js';
+/** Atomic contest-QSO contract and its durable private-field codec. */
+export { CONTEST_QSO_ENVELOPE_MAX_BYTES, ContestQsoEnvelopeSchema, parseContestQsoEnvelope, serializeContestQsoEnvelope, } from '@tx5dr/contracts';
 /** Callsign and DXCC helpers available to plugins. */
 export { getCallsignInfo, listDXCCEntities, resolveDXCCEntity, } from '@tx5dr/core';
 export { createSyncFailure, errorToSyncFailure, failureMessage, sanitizeSyncFailureText, } from './sync.js';
@@ -34,6 +37,10 @@ export { normalizeCallsign } from './utils/callsign.js';
 export { parseADIFContent, parseADIFRecord, parseADIFFields, convertQSOToADIF, generateADIFFile, formatADIFDate, formatADIFTime, parseADIFDateTime, } from './utils/adif.js';
 /** Plugin page scope path utilities. */
 export { getPluginPageFileScopePath, getPluginPageScopePath, getPluginPageScopeSegments, getPluginPageStorePath, } from './utils/page-scope.js';
+/** Composable FT8/FT4 contest rules, assembler and framework-neutral test kit. */
+export * from './toolkit/contest/index.js';
+/** Reusable standard FT8/FT4 QSO runtime for external strategy plugins. */
+export * from './ft8/index.js';
 /** QSO text field utilities. */
 export { buildSignalReportComment, parseQsoTextFields, parseLegacyComment, parseMessageHistoryText, resolveQsoComment, buildCommentFromMessageHistory, normalizeMessageHistory, sanitizeAdifFieldValue, } from './utils/qso-text-fields.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,uDAAuD;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACL,qCAAqC,EACrC,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAkE3B,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAiEvD,sDAAsD;AACtD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAoGrB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,uBAAuB,GACxB,MAAM,WAAW,CAAC;AAEnB,gFAAgF;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,4CAA4C;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,wDAAwD;AACxD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,wCAAwC;AACxC,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,gCAAgC;AAChC,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,8BAA8B,EAC9B,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,uDAAuD;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qCAAqC,EACrC,8BAA8B,EAC9B,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAoG3B,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAgFvD,uEAAuE;AACvE,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAG1B,sDAAsD;AACtD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAqGrB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,uBAAuB,GACxB,MAAM,WAAW,CAAC;AAEnB,gFAAgF;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,4CAA4C;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,wDAAwD;AACxD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,wCAAwC;AACxC,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,kFAAkF;AAClF,cAAc,4BAA4B,CAAC;AAE3C,2EAA2E;AAC3E,cAAc,gBAAgB,CAAC;AAE/B,gCAAgC;AAChC,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,8BAA8B,EAC9B,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC"}

package/dist/runtime.d.ts

@@ -1,10 +1,10 @@
 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.
+ * Legacy identifiers for the six selectable FT8 transmit messages.
  *
- * These labels correspond to the six sequential transmit messages in a typical
- * FT8 QSO flow and are used for status snapshots and UI updates.
+ * These labels describe message choices, not T/R time slots or parallel QSO
+ * streams. User-facing interfaces should call them Tx messages.
  */
 export type StrategyRuntimeSlot = 'TX1' | 'TX2' | 'TX3' | 'TX4' | 'TX5' | 'TX6';
 /**
@@ -39,15 +39,316 @@ export interface StrategyRuntimeSnapshot {
     slots?: Partial<Record<StrategyRuntimeSlot, string>>;
     /** Current conversation metadata tracked by the runtime. */
     context?: StrategyRuntimeContext;
-    /** Optional list of user-visible next states, modes or branch hints. */
+    /** Optional legacy list of user-visible next Tx messages or branch hints. */
     availableSlots?: string[];
     /** Host correlation token for QSO persistence; it is not an RF decision epoch. */
     qsoLifecycleEpoch?: number;
+    /** Active protocol lanes owned by a parallel-capable strategy. */
+    streams?: StrategyStreamSnapshot[];
     /** Optional compact projection exposed by queue-capable strategies. */
     queue?: AssistedQueueSnapshot;
+    /** Plugin-declared operator controls rendered without business interpretation. */
+    actions?: StrategyActionDescriptor[];
+    /** Plugin-declared operator attention items. */
+    attentions?: StrategyAttention[];
+    /** Optional strategy-owned presentation for decoded message history. */
+    messagePresentation?: StrategyMessagePresentationProjection;
+    /** Strategy-owned operator-start gate, enforced by both Host UI and Server. */
+    transmitGate?: StrategyTransmitGate;
+}
+/** Semantic tone requested by strategy-owned message presentation rules. */
+export type StrategyMessagePresentationTone = 'neutral' | 'primary' | 'secondary' | 'success' | 'warning' | 'danger';
+/** Compact label and semantic tone rendered beside a decoded message. */
+export interface StrategyMessagePresentationBadge {
+    /** Literal label or plugin locale key. */
+    label: string;
+    /** Host-themed semantic tone; plugins cannot provide CSS. */
+    tone: StrategyMessagePresentationTone;
+}
+/** Bounded token matcher evaluated by the Host against normalized message tokens. */
+export interface StrategyMessagePresentationTokenMatch {
+    /** Exact, case-insensitive token matching; arbitrary regular expressions are not accepted. */
+    firstTokenIn?: string[];
+    /** Matches when any normalized message token equals one of these values. */
+    anyTokenIn?: string[];
+}
+/** Named visual class assigned by a strategy presentation projection. */
+export interface StrategyMessagePresentationClass {
+    /** @deprecated Use `badges`; retained for API v2 snapshot compatibility. */
+    badge?: {
+        label: string;
+        tone: StrategyMessagePresentationTone;
+    };
+    /** Badges revealed when the optional emphasis matcher succeeds. */
+    badges?: StrategyMessagePresentationBadge[];
+    /** Semantic row treatment; Host maps tones to its theme and never accepts plugin CSS. */
+    row?: {
+        tone: StrategyMessagePresentationTone;
+        background?: 'none' | 'soft';
+        accent?: boolean;
+    };
+    /**
+     * Only expose badges and soft row emphasis when any matcher succeeds.
+     * The accent, text decoration and opacity remain visible when none match.
+     */
+    emphasisWhen?: StrategyMessagePresentationTokenMatch[];
+    /** Optional semantic strike-through for completed or excluded rows. */
+    textDecoration?: 'line-through';
+    /** Optional semantic opacity treatment. */
+    opacity?: 'normal' | 'muted';
+}
+/** Assigns a class when a Host-extracted fact is new within a partition. */
+export interface StrategyMessagePresentationNoveltyRule {
+    /** Canonical message fact extracted by Host before comparing plugin-owned known values. */
+    fact: 'grid-field-2';
+    /** Plugin-owned known values keyed by the configured partition. */
+    knownValuesByPartition: Record<string, string[]>;
+    /** Presentation class used when the extracted fact is not known. */
+    classId: string;
+}
+/** Adds a badge when a bounded token matcher accepts the decoded message. */
+export interface StrategyMessagePresentationTagRule {
+    /** Stable rule identity for diagnostics and replacement. */
+    id: string;
+    /** Host-evaluated token matcher. */
+    match: StrategyMessagePresentationTokenMatch;
+    /** Badge rendered when the matcher succeeds. */
+    badge: StrategyMessagePresentationBadge;
+}
+/** Complete strategy-owned, data-only presentation projection for decoded messages. */
+export interface StrategyMessagePresentationProjection {
+    /** Monotonic plugin revision used to replace stale projections. */
+    revision: number;
+    /** Whether the projection replaces logbook presentation or augments it. */
+    mode: 'replace-logbook' | 'augment';
+    /** Canonical message subject classified by the projection. */
+    subject: 'sender-callsign';
+    /** Partition used for assignments and novelty checks. */
+    partitionBy: 'band' | 'mode' | 'none';
+    /** Optional partition allowlist. */
+    eligiblePartitions?: string[];
+    /** Class applied when no assignment or rule selects another class. */
+    defaultClass?: string;
+    /** Strategy-defined presentation classes keyed by stable ID. */
+    classes: Record<string, StrategyMessagePresentationClass>;
+    /** Explicit subject-to-class assignments. */
+    assignments: Array<{
+        subject: string;
+        partition?: string;
+        classId: string;
+    }>;
+    /** Optional Host-evaluated novelty rules. */
+    noveltyRules?: StrategyMessagePresentationNoveltyRule[];
+    /** Optional Host-evaluated tag rules. */
+    tagRules?: StrategyMessagePresentationTagRule[];
+}
+/** Strategy-owned reason that prevents an operator from starting transmission. */
+export interface StrategyTransmitGate {
+    /** Always false while the gate is present. */
+    allowed: false;
+    /** Literal message or plugin locale key shown to the operator. */
+    reason: string;
+    /** Optional strategy action that can resolve the gate. */
+    actionId?: string;
+}
+/** Semantic tone used for strategy-owned operator actions. */
+export type StrategyActionTone = 'default' | 'primary' | 'success' | 'warning' | 'danger';
+/** Host layout requested for a strategy-owned action. */
+export type StrategyActionPresentation = 'primary' | 'secondary' | 'menu' | 'segmented';
+/** Optional value editor attached to a strategy-owned action. */
+export type StrategyActionInput = {
+    kind: 'text';
+    label?: string;
+    value?: string;
+    placeholder?: string;
+    maxLength?: number;
+} | {
+    kind: 'number' | 'audio-frequency';
+    label?: string;
+    value?: number;
+    min?: number;
+    max?: number;
+    step?: number;
+    unit?: string;
+    spectrumPick?: boolean;
+};
+/** One context-sensitive command wholly owned by a strategy plugin. */
+export interface StrategyActionDescriptor {
+    /** Stable action identifier passed back to the owning runtime. */
+    id: string;
+    /** Literal label or plugin locale key. */
+    label: string;
+    /** Optional literal description or plugin locale key. */
+    description?: string;
+    /** Host icon identifier. */
+    icon?: string;
+    /** Semantic action tone. */
+    tone?: StrategyActionTone;
+    /** Preferred Host layout for this command. */
+    presentation?: StrategyActionPresentation;
+    /** Optional group identity used by menus and segmented controls. */
+    groupId?: string;
+    /** Whether a toggle-like action is currently selected. */
+    selected?: boolean;
+    /** Explanation shown while the action is disabled. */
+    disabledReason?: string;
+    /** Optional exact transmission preview. */
+    previewText?: string;
+    /** Confirmation dialog requested before invocation. */
+    confirmation?: {
+        title: string;
+        description?: string;
+        confirmLabel?: string;
+        cancelLabel?: string;
+    };
+    /** Optional text, number, or audio-frequency editor. */
+    input?: StrategyActionInput;
+    /** Host-validated navigation to a page declared by the owning plugin. */
+    navigation?: {
+        kind: 'plugin-page';
+        pageId: string;
+    };
+}
+/** Strategy-owned operator attention item with optional actions and notification. */
+export interface StrategyAttention {
+    /** Stable identity used to replace or dismiss the item. */
+    id: string;
+    /** Semantic severity rendered by the Host. */
+    tone: 'info' | 'warning' | 'danger' | 'success';
+    /** Literal title or plugin locale key. */
+    title: string;
+    /** Optional literal description or plugin locale key. */
+    description?: string;
+    /** Locale interpolation parameters. */
+    params?: Record<string, string | number>;
+    /** Whether the Host may surface an out-of-page notification. */
+    notify?: boolean;
+    /** Epoch milliseconds after which the Host may discard the item. */
+    expiresAt?: number;
+    /** Strategy action IDs offered with the item. */
+    actionIds?: string[];
+}
+/** Durable QSO completion state projected by one strategy stream. */
+export interface StrategyCompletionProjection {
+    /** Current preparation or commit phase. */
+    state: 'not-ready' | 'ready' | 'committing' | 'committed' | 'failed';
+    /** Optional literal label or plugin locale key. */
+    label?: string;
+    /** Durable record ID once the Host commits the QSO. */
+    recordId?: string;
+}
+/** One user-selectable state exposed by a strategy-owned state machine. */
+export interface StrategyStateOption {
+    /** Stable state identifier understood only by the owning strategy. */
+    id: string;
+    /** Literal label or plugin locale key shown by the Host UI. */
+    label?: string;
+    /** Exact transmission produced when this state is selected, when applicable. */
+    transmitText?: string;
+}
+/** One independently progressing parallel QSO inside an operator strategy. */
+export interface StrategyStreamSnapshot {
+    /** Stable identity within the owning strategy runtime. */
+    streamId: string;
+    /** Current lane state selected by the protocol implementation. */
+    currentState: string;
+    /** Target station currently owned by this lane. */
+    targetCallsign?: string;
+    /** Last accepted target grid, when known. */
+    targetGrid?: string;
+    /** Audio carrier used by this lane in hertz. */
+    audioFrequencyHz: number;
+    /** Lane-local lifecycle epoch used to correlate durable QSO effects. */
+    qsoLifecycleEpoch: number;
+    /** Protocol-approved states that the operator may select for this lane. */
+    stateOptions?: StrategyStateOption[];
+    /** Context-sensitive actions owned by this lane. */
+    actions?: StrategyActionDescriptor[];
+    /** Operator attention items owned by this lane. */
+    attentions?: StrategyAttention[];
+    /** Durable QSO completion projection for this lane. */
+    completion?: StrategyCompletionProjection;
+    /** Most recent accepted inbound protocol text. */
+    lastReceivedText?: string;
+    /** Exact text this lane plans to transmit next. */
+    nextTransmitText?: string;
+}
+/** Optimistic target for a strategy action invocation. */
+export type StrategyActionTarget = {
+    kind: 'runtime';
+} | {
+    kind: 'stream';
+    streamId: string;
+    lifecycleEpoch: number;
+} | {
+    kind: 'queue-entry';
+    entryId: string;
+    queueVersion: number;
+};
+/** Host-validated invocation of one strategy-owned action. */
+export interface StrategyActionInvocation {
+    /** Runtime, stream, or queue entry that owns the action. */
+    target: StrategyActionTarget;
+    /** Action identifier from the current strategy projection. */
+    actionId: string;
+    /** Untrusted action input that the strategy must validate. */
+    payload?: unknown;
+}
+/** Host-managed plugin logbook session effect returned by an accepted action or decision. */
+export type StrategyLogbookSessionEffect = {
+    operation: 'open';
+    sessionKey: string;
+    title: string;
+    retention?: 'durable' | 'runtime';
+} | {
+    operation: 'destroy';
+    sessionKey: string;
+};
+/** Declarative effects returned after invoking a strategy-owned action. */
+export interface StrategyActionResult {
+    /** Requests a fresh speculative decision after the action commits. */
+    requestDecision?: boolean;
+    /** Start this operator through the Host's normal automation path after a direct user action. */
+    requestOperatorStart?: boolean;
+    /** QSO effects prepared and committed by the Host. */
+    qsoCompletions?: StrategyQSOCompletionEffect[];
+    /** Host-managed plugin logbook session operations caused by this explicit action. */
+    logbookSessionEffects?: StrategyLogbookSessionEffect[];
+    /** Stable action outcome for UI feedback and diagnostics. */
+    outcome?: {
+        code: string;
+        message?: string;
+    };
+}
+/** Optimistic request to move one strategy-owned lane to a user-selectable state. */
+export interface StrategyStreamStateUpdate {
+    /** Lane to update. */
+    streamId: string;
+    /** Strategy-approved target state. */
+    stateId: string;
+    /** Optimistic lane lifecycle epoch from the current projection. */
+    expectedLifecycleEpoch: number;
+}
+/** One independently encoded transmission contributed by a strategy. */
+export interface StrategyTransmission {
+    /** Stable lane identity within one operator. */
+    streamId: string;
+    /** Exact FT8/FT4 text to encode. */
+    text: string;
+    /** Audio carrier frequency in hertz. */
+    audioFrequencyHz: number;
+}
+/** Physical confirmation for one transmitted lane in an atomic frame. */
+export interface StreamPhysicalReceipt extends StrategyTransmission {
+    /** Host physical-frame identity. */
+    frameId: string;
+    /** Monotonic physical-frame revision. */
+    revision: number;
+    /** Literal proof that this lane reached physical transmission. */
+    physicalConfirmed: true;
 }
 /** 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';
+export type AssistedQueueDisplayState = 'TX1' | 'TX2' | 'TX3' | 'TX4' | 'TX5' | 'engaged' | 'closing' | 'paused' | 'no-response' | 'later' | 'review' | 'candidate' | 'authorized' | 'dupe';
 /** 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. */
@@ -80,6 +381,16 @@ export interface AssistedQueueRow {
     lastSnr?: number;
     /** Receive cycles elapsed since this target was last decoded. */
     lastHeardCyclesAgo?: number;
+    /** Cycle in which the target was most recently decoded transmitting. */
+    lastHeardCycle?: 0 | 1;
+    /** Active strategy stream currently processing this entry. */
+    streamId?: string;
+    /** Reserved audio carrier when the entry owns a stream. */
+    audioFrequencyHz?: number;
+    /** Audited operator authorization associated with this entry. */
+    authorizationId?: string;
+    /** Plugin-declared row actions. Omission preserves legacy queue controls. */
+    actions?: StrategyActionDescriptor[];
 }
 /** Versioned queue projection embedded in `StrategyRuntimeSnapshot.queue`. */
 export interface AssistedQueueSnapshot {
@@ -87,6 +398,12 @@ export interface AssistedQueueSnapshot {
     version: number;
     /** Entry currently owned by the active QSO lifecycle, when any. */
     activeEntryId?: string;
+    /** Entries currently owned by parallel QSO lifecycles. */
+    activeEntryIds?: string[];
+    /** Maximum number of entries that may be active at once. */
+    maxActiveStreams?: number;
+    /** User-requested stream count before Host radio-frequency policy is applied. */
+    requestedMaxActiveStreams?: number;
     /** Queue rows in display order. */
     rows: AssistedQueueRow[];
 }
@@ -117,6 +434,8 @@ export interface QueuedStrategyMutationResult {
     reason?: 'queue_full' | 'invalid_target' | 'entry_not_found' | 'entry_not_retryable' | 'active_entry' | 'version_conflict';
     /** Authoritative queue state after the attempted mutation. */
     snapshot: AssistedQueueSnapshot;
+    /** Requests a normal operator start after this explicit manual queue mutation. */
+    requestOperatorStart?: boolean;
 }
 /** Optional capability implemented by strategies that own a target queue. */
 export interface QueuedStrategyRuntime extends StrategyRuntime {
@@ -166,30 +485,65 @@ export interface StrategyDecisionMetaV2 {
  * capabilities, functions, promises or external resource handles.
  */
 export type StrategyRuntimeCheckpoint = unknown;
+/** Operator transmit-cycle selection observed by an active strategy runtime. */
+export interface StrategyOperatorTransmitCyclesChanged {
+    /** Previous Host-selected transmit cycles. */
+    previousTransmitCycles: number[];
+    /** Current Host-selected transmit cycles. */
+    transmitCycles: number[];
+    /** Source of the accepted cycle change. */
+    source?: 'manual' | 'plugin' | 'late-decode' | 'slot-auto';
+}
 /** 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;
+    /** Lane that produced the completion; omitted by legacy single-lane strategies. */
+    streamId?: string;
+    /** Host persistence behavior requested by the strategy. */
+    persistencePolicy?: 'merge-nearby' | 'preserve-distinct';
+    /** Optional Host-issued destination. Omitted effects use the operator's primary logbook. */
+    destination?: {
+        kind: 'plugin-session';
+        sessionId: string;
+    } | {
+        kind: 'plugin-session-key';
+        sessionKey: string;
+    };
+    /** Structured-cloneable source metadata returned with post-commit delivery. */
+    metadata?: Record<string, unknown>;
 }
 /** 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. */
+    /** Record ID from the accepted completion effect, used for correlation. */
     recordId: string;
+    /** Final durable record ID; differs when the Host merged into an existing QSO. */
+    persistedRecordId?: string;
     /** Whether the Host committed the record or the durable operation failed. */
     status: 'committed' | 'failed';
+    /** Lane copied from the accepted completion effect. */
+    streamId?: string;
+    /** Detached source metadata copied from the accepted completion effect. */
+    metadata?: Record<string, unknown>;
 }
 /** 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;
+    /** Parallel transmissions. New strategies use this instead of `transmission`. */
+    transmissions?: StrategyTransmission[];
     /** UI/diagnostic snapshot produced from the same post-decision state. */
     snapshot: StrategyRuntimeSnapshot;
     /** Optional QSO persistence effect executed by the Host after acceptance. */
     qsoCompletion?: StrategyQSOCompletionEffect;
+    /** Parallel QSO effects committed in the same accepted decision. */
+    qsoCompletions?: StrategyQSOCompletionEffect[];
+    /** Host-managed plugin logbook lifecycle effects accepted with this decision. */
+    logbookSessionEffects?: StrategyLogbookSessionEffect[];
     /** Optional cycle selected from the triggering RX frame; applied by the host after target reservation. */
     requestedTransmitCycle?: number;
 }
@@ -205,6 +559,11 @@ export interface StrategyRuntime {
     checkpoint(): StrategyRuntimeCheckpoint;
     /** Restores a previously captured checkpoint after a decision is discarded. */
     restore(checkpoint: StrategyRuntimeCheckpoint): void;
+    /**
+     * Observes an already-applied Host transmit-cycle selection. Returning true
+     * asks the Host to publish the resulting runtime projection.
+     */
+    onOperatorTransmitCyclesChanged?(change: StrategyOperatorTransmitCyclesChanged): boolean;
     /**
      * Optional acknowledgement for a declarative QSO effect. Implementations may
      * use it to prevent a completed contact from leaking into the next lifecycle.
@@ -227,6 +586,12 @@ export interface StrategyRuntime {
      * transmission should be queued.
      */
     getTransmitText(): string | null;
+    /**
+     * Returns every lane that should contribute to the next physical frame.
+     * Legacy runtimes may omit this method; the Host then maps getTransmitText()
+     * to the `default` stream at the operator's configured audio frequency.
+     */
+    getTransmissions?(): StrategyTransmission[];
     /**
      * Requests that the runtime initiate or resume a call to a target station.
      *
@@ -251,6 +616,10 @@ export interface StrategyRuntime {
      * Switches the runtime to a specific logical transmit slot/state.
      */
     setState(state: StrategyRuntimeSlot): void;
+    /** Switches one independently progressing lane to a strategy-approved state. */
+    setStreamState?(update: StrategyStreamStateUpdate): void;
+    /** Executes one plugin-declared runtime, stream or queue-entry action. */
+    invokeAction?(invocation: StrategyActionInvocation): StrategyActionResult | void | Promise<StrategyActionResult | void>;
     /**
      * Updates the human-readable content associated with a logical slot.
      */
@@ -267,5 +636,7 @@ export interface StrategyRuntime {
      * Use this to mirror queued text into internal state when needed.
      */
     onTransmissionQueued?(transmission: string): void;
+    /** Physical success notification for a complete parallel frame. */
+    onTransmissionsCompleted?(receipts: StreamPhysicalReceipt[]): void;
 }
 //# sourceMappingURL=runtime.d.ts.map