@tx5dr/contracts 2.0.0 → 2.5.0

package/dist/schema/websocket.schema.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { SlotPackSchema, SlotInfoSchema, SlotPackFrequencyContextSchema } from './slot-info.schema.js';
 import { PluginDataPayloadSchema, PluginLogEntrySchema, PluginRuntimeLogEntrySchema, PluginRuntimeLogHistoryPayloadSchema, PluginSystemSnapshotSchema, PluginStatusSchema, PluginUserActionPayloadSchema, } from './plugin.schema.js';
 import { ModeDescriptorSchema } from './mode.schema.js';
-import { QSORecordSchema } from './qso.schema.js';
+import { QSORecordSchema, } from './qso.schema.js';
 import { LogBookStatisticsSchema, LogbookHealthSchema, LogbookOperationErrorCodeSchema, } from './logbook.schema.js';
 import { RadioInfoSchema, HamlibConfigSchema, TunerCapabilitiesSchema, RadioConnectionStatusSchema, ReconnectProgressSchema, CoreRadioCapabilitiesSchema, CoreCapabilityDiagnosticsSchema } from './radio.schema.js';
 import { UserRole } from './auth.schema.js';
@@ -10,8 +10,9 @@ import { CWDecoderEventSchema, CWDecoderStatusSchema } from './cw-decoder.schema
 import { CapabilityListSchema, CapabilityStateSchema, WriteCapabilityPayloadSchema } from './radio-capability.schema.js';
 import { RadioPowerStateEventSchema } from './radio-power.schema.js';
 import { AudioSidecarStatusPayloadSchema } from './audio-sidecar.schema.js';
-import { SpectrumCapabilitiesSchema, SpectrumFrameSchema, SpectrumKindSchema, SpectrumSessionControlActionSchema, SpectrumSessionControlIdSchema, SpectrumSessionStateSchema } from './spectrum.schema.js';
+import { SpectrumCapabilitiesSchema, SpectrumFrameSchema, SpectrumKindSchema, SpectrumSessionControlActionSchema, SpectrumSessionControlIdSchema, SpectrumSessionStateSchema, SpectrumViewportSchema } from './spectrum.schema.js';
 import { ClockStatusSummarySchema } from './system.schema.js';
+import { ImageRadioStatusSchema, ImageRxEventSchema, ImageRxSubscriptionSchema, FaxCalibrationCommandResultSchema, FaxCalibrationResetCommandSchema, FaxCalibrationSetCommandSchema, SstvTxCancelCommandSchema, SstvTxCommandResultSchema, SstvTxStartCommandSchema, SstvTxStatusSchema, } from './image-radio.schema.js';
 // WebSocket消息类型枚举
 export var WSMessageType;
 (function (WSMessageType) {
@@ -26,6 +27,16 @@ export var WSMessageType;
     WSMessageType["STOP_ENGINE"] = "stopEngine";
     WSMessageType["GET_STATUS"] = "getStatus";
     WSMessageType["SET_MODE"] = "setMode";
+    WSMessageType["SUBSCRIBE_IMAGE_RX"] = "subscribeImageRx";
+    WSMessageType["IMAGE_RADIO_STATUS"] = "imageRadioStatus";
+    WSMessageType["IMAGE_RX_EVENT"] = "imageRxEvent";
+    WSMessageType["SSTV_TX_START"] = "sstvTxStart";
+    WSMessageType["SSTV_TX_CANCEL"] = "sstvTxCancel";
+    WSMessageType["SSTV_TX_STATUS"] = "sstvTxStatus";
+    WSMessageType["SSTV_TX_COMMAND_RESULT"] = "sstvTxCommandResult";
+    WSMessageType["FAX_CALIBRATION_SET"] = "faxCalibrationSet";
+    WSMessageType["FAX_CALIBRATION_RESET"] = "faxCalibrationReset";
+    WSMessageType["FAX_CALIBRATION_COMMAND_RESULT"] = "faxCalibrationCommandResult";
     // ===== 引擎事件 =====
     WSMessageType["MODE_CHANGED"] = "modeChanged";
     WSMessageType["SLOT_START"] = "slotStart";
@@ -37,6 +48,7 @@ export var WSMessageType;
     WSMessageType["SPECTRUM_FRAME"] = "spectrumFrame";
     WSMessageType["SPECTRUM_SESSION_STATE_CHANGED"] = "spectrumSessionStateChanged";
     WSMessageType["INVOKE_SPECTRUM_CONTROL"] = "invokeSpectrumControl";
+    WSMessageType["SPECTRUM_VIEWPORT_CHANGED"] = "spectrumViewportChanged";
     WSMessageType["DECODE_ERROR"] = "decodeError";
     WSMessageType["SYSTEM_STATUS"] = "systemStatus";
     WSMessageType["BOOTSTRAP_STATUS_CHANGED"] = "bootstrapStatusChanged";
@@ -49,6 +61,8 @@ export var WSMessageType;
     WSMessageType["OPERATOR_STATUS_UPDATE"] = "operatorStatusUpdate";
     WSMessageType["SET_OPERATOR_CONTEXT"] = "setOperatorContext";
     WSMessageType["SET_OPERATOR_RUNTIME_STATE"] = "setOperatorRuntimeState";
+    WSMessageType["SET_OPERATOR_STREAM_STATE"] = "setOperatorStreamState";
+    WSMessageType["INVOKE_OPERATOR_STRATEGY_ACTION"] = "invokeOperatorStrategyAction";
     WSMessageType["SET_OPERATOR_RUNTIME_SLOT_CONTENT"] = "setOperatorRuntimeSlotContent";
     WSMessageType["SET_OPERATOR_TRANSMIT_CYCLES"] = "setOperatorTransmitCycles";
     WSMessageType["START_OPERATOR"] = "startOperator";
@@ -199,7 +213,7 @@ export const SystemStatusSchema = z.object({
         connectionHealthy: z.boolean(),
     }).optional(),
     /** 引擎模式：digital（FT8/FT4）、voice（语音通联）或 cw（莫尔斯码） */
-    engineMode: z.enum(['digital', 'voice', 'cw']).default('digital'),
+    engineMode: z.enum(['digital', 'voice', 'cw', 'image']).default('digital'),
     /** 当前电台调制模式（语音模式下使用，如 USB/LSB/FM/AM） */
     currentRadioMode: z.string().optional(),
     /** 引擎状态机当前状态 */
@@ -283,10 +297,11 @@ export const DecodeErrorInfoSchema = z.object({
 /**
  * Current dial-frequency projection broadcast to plugins and clients.
  *
- * `frequency` is RF dial frequency in hertz; `mode` is the TX-5DR engine mode;
- * `band` and `description` are display labels; `radioMode` is the underlying
- * modulation when known. `source` distinguishes application changes from
- * updates reported by the radio.
+ * `frequency` is the logical RF dial target in hertz; `mode` is the TX-5DR
+ * engine mode; `band` and `description` are display labels; `radioMode` is the
+ * underlying modulation when known. `observedFrequency` is the latest physical
+ * readback. `source` distinguishes application changes from radio observations;
+ * `revision` and `connectionGeneration` reject stale events.
  */
 export const FrequencyStateSchema = z.object({
     frequency: z.number(),
@@ -296,6 +311,20 @@ export const FrequencyStateSchema = z.object({
     radioMode: z.string().optional(),
     radioConnected: z.boolean(),
     source: z.enum(['program', 'radio']).optional(),
+    /** Monotonic operating-state revision for stale-event suppression. */
+    revision: z.number().int().nonnegative().optional(),
+    /** Physical CAT session identity associated with this snapshot. */
+    connectionGeneration: z.number().int().nonnegative().optional(),
+    /** Physical confirmation status for the requested operating state. */
+    confirmation: z.enum(['confirmed', 'pending', 'mismatch', 'offline']).optional(),
+    /** Last frequency read back from the physical radio, when available. */
+    observedFrequency: z.number().optional(),
+    /** Requested logical frequency when it differs from the observed value. */
+    requestedFrequency: z.number().optional(),
+    /** Correlates a snapshot with one programmatic operating-state mutation. */
+    operationId: z.string().optional(),
+    /** Physical radio-mode confirmation status. */
+    modeConfirmation: z.enum(['confirmed', 'unconfirmed', 'unknown']).optional(),
 });
 export const SpectrumControlInvocationSchema = z.object({
     id: SpectrumSessionControlIdSchema,
@@ -307,7 +336,7 @@ export const PTTStatusSchema = z.object({
     operatorIds: z.array(z.string()),
     phase: z.enum(['idle', 'starting', 'on_air', 'draining', 'stopping', 'unknown']).optional(),
     frameId: z.string().optional(),
-    source: z.enum(['digital', 'voice', 'voice-keyer', 'cw', 'tune-tone', 'manual', 'test']).optional(),
+    source: z.enum(['digital', 'voice', 'voice-keyer', 'cw', 'sstv', 'tune-tone', 'manual', 'test']).optional(),
 });
 export const TuneToneStartPayloadSchema = z.object({
     operatorId: z.string().optional(),
@@ -335,8 +364,90 @@ export const StrategyRuntimeContextSchema = z.object({
     reportReceived: z.number().optional(),
     actualFrequency: z.number().optional(),
 });
+export const StrategyStateOptionSchema = z.object({
+    id: z.string().min(1),
+    label: z.string().min(1).optional(),
+    transmitText: z.string().optional(),
+});
+export const StrategyActionInputSchema = z.discriminatedUnion('kind', [
+    z.object({
+        kind: z.literal('text'),
+        label: z.string().optional(),
+        value: z.string().optional(),
+        placeholder: z.string().optional(),
+        maxLength: z.number().int().positive().optional(),
+    }),
+    z.object({
+        kind: z.enum(['number', 'audio-frequency']),
+        label: z.string().optional(),
+        value: z.number().optional(),
+        min: z.number().optional(),
+        max: z.number().optional(),
+        step: z.number().positive().optional(),
+        unit: z.string().optional(),
+        spectrumPick: z.boolean().optional(),
+    }),
+]);
+export const StrategyActionDescriptorSchema = z.object({
+    id: z.string().min(1),
+    label: z.string().min(1),
+    description: z.string().optional(),
+    icon: z.string().optional(),
+    tone: z.enum(['default', 'primary', 'success', 'warning', 'danger']).optional(),
+    presentation: z.enum(['primary', 'secondary', 'menu', 'segmented']).optional(),
+    groupId: z.string().optional(),
+    selected: z.boolean().optional(),
+    disabledReason: z.string().optional(),
+    previewText: z.string().optional(),
+    confirmation: z.object({
+        title: z.string().min(1),
+        description: z.string().optional(),
+        confirmLabel: z.string().optional(),
+        cancelLabel: z.string().optional(),
+    }).optional(),
+    input: StrategyActionInputSchema.optional(),
+    navigation: z.object({
+        kind: z.literal('plugin-page'),
+        pageId: z.string().min(1),
+    }).optional(),
+});
+export const StrategyAttentionSchema = z.object({
+    id: z.string().min(1),
+    tone: z.enum(['info', 'warning', 'danger', 'success']),
+    title: z.string().min(1),
+    description: z.string().optional(),
+    params: z.record(z.string(), z.union([z.string(), z.number()])).optional(),
+    notify: z.boolean().optional(),
+    expiresAt: z.number().optional(),
+    actionIds: z.array(z.string()).optional(),
+});
+export const StrategyCompletionProjectionSchema = z.object({
+    state: z.enum(['not-ready', 'ready', 'committing', 'committed', 'failed']),
+    label: z.string().optional(),
+    recordId: z.string().optional(),
+});
+export const StrategyStreamSnapshotSchema = z.object({
+    streamId: z.string().min(1),
+    currentState: z.string(),
+    targetCallsign: z.string().optional(),
+    targetGrid: z.string().optional(),
+    audioFrequencyHz: z.number().min(0).max(5000),
+    qsoLifecycleEpoch: z.number().int().nonnegative(),
+    stateOptions: z.array(StrategyStateOptionSchema).optional(),
+    actions: z.array(StrategyActionDescriptorSchema).optional(),
+    attentions: z.array(StrategyAttentionSchema).optional(),
+    completion: StrategyCompletionProjectionSchema.optional(),
+    lastReceivedText: z.string().optional(),
+    nextTransmitText: z.string().optional(),
+});
+export const StrategyTransmissionSchema = z.object({
+    streamId: z.string().min(1),
+    text: z.string().min(1),
+    audioFrequencyHz: z.number().min(0).max(5000),
+});
 export const AssistedQueueDisplayStateSchema = z.enum([
     'TX1', 'TX2', 'TX3', 'TX4', 'TX5', 'engaged', 'closing', 'paused', 'no-response', 'later', 'review',
+    'candidate', 'authorized', 'dupe',
 ]);
 export const AssistedQueuePauseReasonSchema = z.enum(['target-busy', 'stale']);
 export const AssistedQueueToneSchema = z.enum(['neutral', 'active', 'success', 'warning', 'danger']);
@@ -356,12 +467,69 @@ export const AssistedQueueRowSchema = z.object({
     targetGrid: z.string().optional(),
     lastSnr: z.number().optional(),
     lastHeardCyclesAgo: z.number().int().nonnegative().optional(),
+    lastHeardCycle: z.union([z.literal(0), z.literal(1)]).optional(),
+    streamId: z.string().optional(),
+    audioFrequencyHz: z.number().optional(),
+    authorizationId: z.string().optional(),
+    actions: z.array(StrategyActionDescriptorSchema).optional(),
 });
 export const AssistedQueueSnapshotSchema = z.object({
     version: z.number().int().nonnegative(),
     activeEntryId: z.string().optional(),
+    activeEntryIds: z.array(z.string()).optional(),
+    maxActiveStreams: z.number().int().min(1).max(5).optional(),
+    requestedMaxActiveStreams: z.number().int().min(1).max(5).optional(),
     rows: z.array(AssistedQueueRowSchema),
 });
+/** Null clears an unsettable runtime report field over JSON/WebSocket. */
+export const OperatorContextReportFieldSchema = z.number().nullish();
+export const StrategyMessagePresentationToneSchema = z.enum([
+    'neutral', 'primary', 'secondary', 'success', 'warning', 'danger',
+]);
+export const StrategyMessagePresentationBadgeSchema = z.object({
+    label: z.string().min(1),
+    tone: StrategyMessagePresentationToneSchema,
+});
+export const StrategyMessagePresentationTokenMatchSchema = z.object({
+    firstTokenIn: z.array(z.string().min(1)).optional(),
+    anyTokenIn: z.array(z.string().min(1)).optional(),
+});
+export const StrategyMessagePresentationClassSchema = z.object({
+    badge: StrategyMessagePresentationBadgeSchema.optional(),
+    badges: z.array(StrategyMessagePresentationBadgeSchema).optional(),
+    row: z.object({
+        tone: StrategyMessagePresentationToneSchema,
+        background: z.enum(['none', 'soft']).optional(),
+        accent: z.boolean().optional(),
+    }).optional(),
+    emphasisWhen: z.array(StrategyMessagePresentationTokenMatchSchema).min(1).optional(),
+    textDecoration: z.literal('line-through').optional(),
+    opacity: z.enum(['normal', 'muted']).optional(),
+});
+export const StrategyMessagePresentationProjectionSchema = z.object({
+    revision: z.number().int().nonnegative(),
+    mode: z.enum(['replace-logbook', 'augment']),
+    subject: z.literal('sender-callsign'),
+    partitionBy: z.enum(['band', 'mode', 'none']),
+    eligiblePartitions: z.array(z.string()).optional(),
+    defaultClass: z.string().optional(),
+    classes: z.record(z.string(), StrategyMessagePresentationClassSchema),
+    assignments: z.array(z.object({
+        subject: z.string().min(1),
+        partition: z.string().optional(),
+        classId: z.string().min(1),
+    })),
+    noveltyRules: z.array(z.object({
+        fact: z.literal('grid-field-2'),
+        knownValuesByPartition: z.record(z.string(), z.array(z.string().min(1))),
+        classId: z.string().min(1),
+    })).optional(),
+    tagRules: z.array(z.object({
+        id: z.string().min(1),
+        match: StrategyMessagePresentationTokenMatchSchema,
+        badge: StrategyMessagePresentationBadgeSchema,
+    })).optional(),
+});
 export const StrategyRuntimeSnapshotSchema = z.object({
     currentState: z.string(),
     slots: z.object({
@@ -375,8 +543,30 @@ export const StrategyRuntimeSnapshotSchema = z.object({
     context: StrategyRuntimeContextSchema.optional(),
     availableSlots: z.array(z.string()).optional(),
     qsoLifecycleEpoch: z.number().int().nonnegative().optional(),
+    streams: z.array(StrategyStreamSnapshotSchema).optional(),
     queue: AssistedQueueSnapshotSchema.optional(),
+    actions: z.array(StrategyActionDescriptorSchema).optional(),
+    attentions: z.array(StrategyAttentionSchema).optional(),
+    messagePresentation: StrategyMessagePresentationProjectionSchema.optional(),
+    transmitGate: z.object({
+        allowed: z.literal(false),
+        reason: z.string().min(1),
+        actionId: z.string().optional(),
+    }).optional(),
 });
+export const StrategyActionTargetSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('runtime') }),
+    z.object({
+        kind: z.literal('stream'),
+        streamId: z.string().min(1),
+        lifecycleEpoch: z.number().int().nonnegative(),
+    }),
+    z.object({
+        kind: z.literal('queue-entry'),
+        entryId: z.string().min(1),
+        queueVersion: z.number().int().nonnegative(),
+    }),
+]);
 export const LevelMeterDisplayStyleSchema = z.enum([
     's-meter-dbm',
     's-meter',
@@ -425,11 +615,12 @@ export const MeterDataSchema = z.object({
         raw: z.number(),
         percent: z.number(),
         alert: z.boolean(),
+        unit: z.enum(['percent', 'dbfs']).optional(),
     }).nullable(),
     level: LevelMeterReadingSchema.nullable(),
     power: z.object({
         raw: z.number(),
-        percent: z.number(),
+        percent: z.number().nullable(),
         watts: z.number().nullable(), // 绝对瓦数（仅当电台支持 RFPOWER_METER_WATTS 时非 null）
         maxWatts: z.number().nullable(), // 当前频率+模式对应的量程瓦数
     }).nullable(),
@@ -455,6 +646,46 @@ export const WSModeChangedMessageSchema = WSBaseMessageSchema.extend({
     type: z.literal(WSMessageType.MODE_CHANGED),
     data: ModeDescriptorSchema,
 });
+export const WSSubscribeImageRxMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SUBSCRIBE_IMAGE_RX),
+    data: ImageRxSubscriptionSchema,
+});
+export const WSImageRadioStatusMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.IMAGE_RADIO_STATUS),
+    data: ImageRadioStatusSchema,
+});
+export const WSImageRxEventMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.IMAGE_RX_EVENT),
+    data: ImageRxEventSchema,
+});
+export const WSSstvTxStartMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SSTV_TX_START),
+    data: SstvTxStartCommandSchema,
+});
+export const WSSstvTxCancelMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SSTV_TX_CANCEL),
+    data: SstvTxCancelCommandSchema,
+});
+export const WSSstvTxStatusMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SSTV_TX_STATUS),
+    data: SstvTxStatusSchema,
+});
+export const WSSstvTxCommandResultMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SSTV_TX_COMMAND_RESULT),
+    data: SstvTxCommandResultSchema,
+});
+export const WSFaxCalibrationSetMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.FAX_CALIBRATION_SET),
+    data: FaxCalibrationSetCommandSchema,
+});
+export const WSFaxCalibrationResetMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.FAX_CALIBRATION_RESET),
+    data: FaxCalibrationResetCommandSchema,
+});
+export const WSFaxCalibrationCommandResultMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.FAX_CALIBRATION_COMMAND_RESULT),
+    data: FaxCalibrationCommandResultSchema,
+});
 export const WSSlotStartMessageSchema = WSBaseMessageSchema.extend({
     type: z.literal(WSMessageType.SLOT_START),
     data: SlotInfoSchema,
@@ -475,8 +706,13 @@ export const WSSubscribeSpectrumMessageSchema = WSBaseMessageSchema.extend({
     type: z.literal(WSMessageType.SUBSCRIBE_SPECTRUM),
     data: z.object({
         kind: SpectrumKindSchema.nullable(),
+        viewport: SpectrumViewportSchema.optional(),
     }),
 });
+export const WSSpectrumViewportChangedMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SPECTRUM_VIEWPORT_CHANGED),
+    data: SpectrumViewportSchema.nullable(),
+});
 export const WSSpectrumSubscriptionChangedMessageSchema = WSBaseMessageSchema.extend({
     type: z.literal(WSMessageType.SPECTRUM_SUBSCRIPTION_CHANGED),
     data: z.object({
@@ -575,10 +811,13 @@ export const OperatorStatusSchema = z.object({
     isTransmitting: z.boolean(), // 是否已授予策略自动发射许可（发射开关状态）
     isInActivePTT: z.boolean().optional(), // 该操作员的音频是否正在被实际播放
     hasTransmitIntent: z.boolean().optional(), // 当前策略是否有可在合法周期发射的有效内容
+    currentTransmissions: z.array(StrategyTransmissionSchema).optional(),
     currentSlot: z.string().optional(),
     context: z.object({
         myCall: z.string(),
         myGrid: z.string(),
+        /** Canonical active target set; `targetCall` remains the primary compatibility field. */
+        targetCalls: z.array(z.string()).optional(),
         targetCall: z.string(),
         targetGrid: z.string().optional(),
         frequency: z.number().optional(),
@@ -638,8 +877,8 @@ export const WSSetOperatorContextMessageSchema = WSBaseMessageSchema.extend({
             targetCallsign: z.string().optional(),
             targetGrid: z.string().optional(),
             frequency: z.number().optional(),
-            reportSent: z.number().optional(),
-            reportReceived: z.number().optional(),
+            reportSent: OperatorContextReportFieldSchema,
+            reportReceived: OperatorContextReportFieldSchema,
         }),
     }),
 });
@@ -653,6 +892,25 @@ export const WSSetOperatorRuntimeStateMessageSchema = WSBaseMessageSchema.extend
         state: OperatorRuntimeSlotSchema,
     }),
 });
+/** Sets one strategy-owned stream to a protocol-approved state. */
+export const WSSetOperatorStreamStateMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SET_OPERATOR_STREAM_STATE),
+    data: z.object({
+        operatorId: z.string(),
+        streamId: z.string().min(1),
+        stateId: z.string().min(1),
+        expectedLifecycleEpoch: z.number().int().nonnegative(),
+    }),
+});
+export const WSInvokeOperatorStrategyActionMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.INVOKE_OPERATOR_STRATEGY_ACTION),
+    data: z.object({
+        operatorId: z.string().min(1),
+        target: StrategyActionTargetSchema,
+        actionId: z.string().min(1),
+        payload: z.unknown().optional(),
+    }),
+});
 /**
  * 设置操作员运行时槽位内容消息
  */
@@ -1236,12 +1494,23 @@ export const WSMessageSchema = z.discriminatedUnion('type', [
     WSPongMessageSchema,
     // 服务端到客户端
     WSModeChangedMessageSchema,
+    WSSubscribeImageRxMessageSchema,
+    WSImageRadioStatusMessageSchema,
+    WSImageRxEventMessageSchema,
+    WSSstvTxStartMessageSchema,
+    WSSstvTxCancelMessageSchema,
+    WSSstvTxStatusMessageSchema,
+    WSSstvTxCommandResultMessageSchema,
+    WSFaxCalibrationSetMessageSchema,
+    WSFaxCalibrationResetMessageSchema,
+    WSFaxCalibrationCommandResultMessageSchema,
     WSSlotStartMessageSchema,
     WSSubWindowMessageSchema,
     WSSlotPackUpdatedMessageSchema,
     WSSpectrumCapabilitiesMessageSchema,
     WSSubscribeSpectrumMessageSchema,
     WSSpectrumSubscriptionChangedMessageSchema,
+    WSSpectrumViewportChangedMessageSchema,
     WSSpectrumFrameMessageSchema,
     WSSpectrumSessionStateChangedMessageSchema,
     WSInvokeSpectrumControlMessageSchema,
@@ -1264,6 +1533,8 @@ export const WSMessageSchema = z.discriminatedUnion('type', [
     WSOperatorStatusUpdateMessageSchema,
     WSSetOperatorContextMessageSchema,
     WSSetOperatorRuntimeStateMessageSchema,
+    WSSetOperatorStreamStateMessageSchema,
+    WSInvokeOperatorStrategyActionMessageSchema,
     WSSetOperatorRuntimeSlotContentMessageSchema,
     WSSetOperatorTransmitCyclesMessageSchema,
     WSStartOperatorMessageSchema,
@@ -1336,7 +1607,9 @@ export const WSMessageSchema = z.discriminatedUnion('type', [
 ]);
 export const TransmitRequestSchema = z.object({
     operatorId: z.string(),
+    streamId: z.string().min(1).optional(),
     transmission: z.string(),
+    audioFrequencyHz: z.number().min(0).max(5000).optional(),
     /** 是否覆盖同一操作员在同一时隙的现有 TX 帧（自动重决策时为 true） */
     replaceExisting: z.boolean().optional(),
     source: z.enum(['standard-qso', 'plugin', 'late-decode', 'operator-edit', 'manual']).optional(),
@@ -1344,12 +1617,26 @@ export const TransmitRequestSchema = z.object({
     /** Host command epoch used to tombstone stale encode/mix callbacks. */
     decisionEpoch: z.number().int().nonnegative().optional(),
 });
+export const TransmitBatchRequestSchema = z.object({
+    operatorId: z.string(),
+    transmissions: z.array(z.object({
+        streamId: z.string().min(1),
+        transmission: z.string(),
+        audioFrequencyHz: z.number().min(0).max(5000),
+    })).max(5),
+    replaceExisting: z.boolean().optional(),
+    source: z.enum(['standard-qso', 'plugin', 'late-decode', 'operator-edit', 'manual']).optional(),
+    reason: z.string().optional(),
+    decisionEpoch: z.number().int().nonnegative().optional(),
+});
 // ===== 前端应用事件接口 =====
 /**
  * 发射完成事件信息
  */
 export const TransmissionCompleteInfoSchema = z.object({
     operatorId: z.string(),
+    streamId: z.string().optional(),
+    trackId: z.string().optional(),
     success: z.boolean(),
     frameId: z.string().optional(),
     physicalConfirmed: z.boolean().optional(),