@tx5dr/contracts 1.2.0

package/dist/schema/websocket.schema.js

@@ -0,0 +1,1050 @@
+import { z } from 'zod';
+import { SlotPackSchema, SlotInfoSchema } 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 { LogBookStatisticsSchema } from './logbook.schema.js';
+import { RadioInfoSchema, HamlibConfigSchema, TunerCapabilitiesSchema, RadioConnectionStatusSchema, ReconnectProgressSchema, CoreRadioCapabilitiesSchema, CoreCapabilityDiagnosticsSchema } from './radio.schema.js';
+import { UserRole } from './auth.schema.js';
+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 { ClockStatusSummarySchema } from './system.schema.js';
+// WebSocket消息类型枚举
+export var WSMessageType;
+(function (WSMessageType) {
+    // ===== 基础连接管理 =====
+    WSMessageType["PING"] = "ping";
+    WSMessageType["PONG"] = "pong";
+    WSMessageType["ERROR"] = "error";
+    /** 服务端通知客户端：此连接已被同一 clientInstance 的新连接替换，客户端不应重连 */
+    WSMessageType["CONNECTION_REPLACED"] = "connectionReplaced";
+    // ===== 引擎控制 =====
+    WSMessageType["START_ENGINE"] = "startEngine";
+    WSMessageType["STOP_ENGINE"] = "stopEngine";
+    WSMessageType["GET_STATUS"] = "getStatus";
+    WSMessageType["SET_MODE"] = "setMode";
+    // ===== 引擎事件 =====
+    WSMessageType["MODE_CHANGED"] = "modeChanged";
+    WSMessageType["SLOT_START"] = "slotStart";
+    WSMessageType["SUB_WINDOW"] = "subWindow";
+    WSMessageType["SLOT_PACK_UPDATED"] = "slotPackUpdated";
+    WSMessageType["SPECTRUM_CAPABILITIES"] = "spectrumCapabilities";
+    WSMessageType["SUBSCRIBE_SPECTRUM"] = "subscribeSpectrum";
+    WSMessageType["SPECTRUM_FRAME"] = "spectrumFrame";
+    WSMessageType["SPECTRUM_SESSION_STATE_CHANGED"] = "spectrumSessionStateChanged";
+    WSMessageType["INVOKE_SPECTRUM_CONTROL"] = "invokeSpectrumControl";
+    WSMessageType["DECODE_ERROR"] = "decodeError";
+    WSMessageType["SYSTEM_STATUS"] = "systemStatus";
+    WSMessageType["CLIENT_COUNT_CHANGED"] = "clientCountChanged";
+    WSMessageType["CLOCK_STATUS_CHANGED"] = "clockStatusChanged";
+    WSMessageType["RIGCTLD_STATUS"] = "rigctldStatus";
+    // ===== 电台操作员管理 =====
+    WSMessageType["GET_OPERATORS"] = "getOperators";
+    WSMessageType["OPERATORS_LIST"] = "operatorsList";
+    WSMessageType["OPERATOR_STATUS_UPDATE"] = "operatorStatusUpdate";
+    WSMessageType["SET_OPERATOR_CONTEXT"] = "setOperatorContext";
+    WSMessageType["SET_OPERATOR_RUNTIME_STATE"] = "setOperatorRuntimeState";
+    WSMessageType["SET_OPERATOR_RUNTIME_SLOT_CONTENT"] = "setOperatorRuntimeSlotContent";
+    WSMessageType["SET_OPERATOR_TRANSMIT_CYCLES"] = "setOperatorTransmitCycles";
+    WSMessageType["START_OPERATOR"] = "startOperator";
+    WSMessageType["STOP_OPERATOR"] = "stopOperator";
+    WSMessageType["OPERATOR_REQUEST_CALL"] = "operatorRequestCall";
+    // ===== 客户端操作员过滤 =====
+    WSMessageType["SET_CLIENT_ENABLED_OPERATORS"] = "setClientEnabledOperators";
+    WSMessageType["SET_CLIENT_SELECTED_OPERATOR"] = "setClientSelectedOperator";
+    // ===== 握手协议 =====
+    WSMessageType["CLIENT_HANDSHAKE"] = "clientHandshake";
+    WSMessageType["SERVER_HANDSHAKE_COMPLETE"] = "serverHandshakeComplete";
+    WSMessageType["SLOT_PACKS_RESET"] = "slotPacksReset";
+    // ===== 发射日志 =====
+    WSMessageType["TRANSMISSION_LOG"] = "transmissionLog";
+    // ===== 音量控制 =====
+    WSMessageType["SET_VOLUME_GAIN"] = "setVolumeGain";
+    WSMessageType["SET_VOLUME_GAIN_DB"] = "setVolumeGainDb";
+    WSMessageType["VOLUME_GAIN_CHANGED"] = "volumeGainChanged";
+    // ===== 通联日志 =====
+    WSMessageType["QSO_RECORD_ADDED"] = "qsoRecordAdded";
+    WSMessageType["QSO_RECORD_UPDATED"] = "qsoRecordUpdated";
+    WSMessageType["LOGBOOK_UPDATED"] = "logbookUpdated";
+    // 仅通知的日志本变更事件（专用于日志本WS）
+    WSMessageType["LOGBOOK_CHANGE_NOTICE"] = "logbookChangeNotice";
+    // ===== 电台连接管理 =====
+    WSMessageType["RADIO_STATUS_CHANGED"] = "radioStatusChanged";
+    WSMessageType["RADIO_ERROR"] = "radioError";
+    WSMessageType["RADIO_MANUAL_RECONNECT"] = "radioManualReconnect";
+    WSMessageType["RADIO_DISCONNECTED_DURING_TRANSMISSION"] = "radioDisconnectedDuringTransmission";
+    // ===== 频率管理 =====
+    WSMessageType["FREQUENCY_CHANGED"] = "frequencyChanged";
+    // ===== PTT状态管理 =====
+    WSMessageType["PTT_STATUS_CHANGED"] = "pttStatusChanged";
+    WSMessageType["FORCE_STOP_TRANSMISSION"] = "forceStopTransmission";
+    WSMessageType["REMOVE_OPERATOR_FROM_TRANSMISSION"] = "removeOperatorFromTransmission";
+    // ===== 电台数值表 =====
+    WSMessageType["METER_DATA"] = "meterData";
+    // ===== 极简文本消息 =====
+    WSMessageType["TEXT_MESSAGE"] = "textMessage";
+    // ===== 天线调谐器（已迁移至统一能力系统，枚举值保留以避免运行时错误，不再广播）=====
+    /** @deprecated Use RADIO_CAPABILITY_CHANGED with id='tuner_switch' instead */
+    WSMessageType["TUNER_STATUS_CHANGED"] = "tunerStatusChanged";
+    // ===== 统一电台控制能力系统 =====
+    /** 连接时下发能力快照（server → client） */
+    WSMessageType["RADIO_CAPABILITY_LIST"] = "radioCapabilityList";
+    /** 单个能力值变化（server → client） */
+    WSMessageType["RADIO_CAPABILITY_CHANGED"] = "radioCapabilityChanged";
+    /** 客户端写入能力值（client → server） */
+    WSMessageType["WRITE_RADIO_CAPABILITY"] = "writeRadioCapability";
+    /** 客户端请求刷新所有能力值（client → server） */
+    WSMessageType["REFRESH_RADIO_CAPABILITIES"] = "refreshRadioCapabilities";
+    // ===== 电台重连控制 =====
+    WSMessageType["RADIO_STOP_RECONNECT"] = "radioStopReconnect";
+    // ===== 音频旁路（sidecar） =====
+    /** 音频 sidecar 状态变化（server → client） */
+    WSMessageType["AUDIO_SIDECAR_STATUS_CHANGED"] = "audioSidecarStatusChanged";
+    /** 客户端请求立即重试音频启动（client → server） */
+    WSMessageType["AUDIO_RETRY_NOW"] = "audioRetryNow";
+    // ===== 电台电源管理 =====
+    /** 电源操作进度事件（server → client） */
+    WSMessageType["RADIO_POWER_STATE"] = "radioPowerState";
+    // ===== Profile 管理 =====
+    WSMessageType["PROFILE_CHANGED"] = "profileChanged";
+    WSMessageType["PROFILE_LIST_UPDATED"] = "profileListUpdated";
+    WSMessageType["REALTIME_SETTINGS_CHANGED"] = "realtimeSettingsChanged";
+    // ===== 认证 =====
+    WSMessageType["AUTH_REQUIRED"] = "authRequired";
+    WSMessageType["AUTH_TOKEN"] = "authToken";
+    WSMessageType["AUTH_PUBLIC_VIEWER"] = "authPublicViewer";
+    WSMessageType["AUTH_RESULT"] = "authResult";
+    WSMessageType["AUTH_EXPIRED"] = "authExpired";
+    // ===== 语音模式 =====
+    WSMessageType["VOICE_PTT_REQUEST"] = "voicePttRequest";
+    WSMessageType["VOICE_PTT_RELEASE"] = "voicePttRelease";
+    WSMessageType["VOICE_PTT_LOCK_CHANGED"] = "voicePttLockChanged";
+    WSMessageType["VOICE_SET_RADIO_MODE"] = "voiceSetRadioMode";
+    WSMessageType["VOICE_RADIO_MODE_CHANGED"] = "voiceRadioModeChanged";
+    // ===== 进程监控 =====
+    WSMessageType["PROCESS_SNAPSHOT"] = "processSnapshot";
+    WSMessageType["PROCESS_SNAPSHOT_HISTORY"] = "processSnapshotHistory";
+    // ===== 插件系统 =====
+    WSMessageType["PLUGIN_LIST"] = "pluginList";
+    WSMessageType["PLUGIN_STATUS_CHANGED"] = "pluginStatusChanged";
+    WSMessageType["PLUGIN_DATA"] = "pluginData";
+    WSMessageType["PLUGIN_LOG"] = "pluginLog";
+    WSMessageType["PLUGIN_RUNTIME_LOG"] = "pluginRuntimeLog";
+    WSMessageType["GET_PLUGIN_RUNTIME_LOG_HISTORY"] = "getPluginRuntimeLogHistory";
+    WSMessageType["PLUGIN_RUNTIME_LOG_HISTORY"] = "pluginRuntimeLogHistory";
+    WSMessageType["PLUGIN_USER_ACTION"] = "pluginUserAction";
+    WSMessageType["PLUGIN_PAGE_PUSH"] = "pluginPagePush";
+    // ===== OpenWebRX SDR =====
+    WSMessageType["OPENWEBRX_LISTEN_STATUS"] = "openwebrxListenStatus";
+    WSMessageType["OPENWEBRX_PROFILE_SELECT_REQUEST"] = "openwebrxProfileSelectRequest";
+    WSMessageType["OPENWEBRX_PROFILE_SELECT_RESPONSE"] = "openwebrxProfileSelectResponse";
+    WSMessageType["OPENWEBRX_PROFILE_VERIFY_RESULT"] = "openwebrxProfileVerifyResult";
+    WSMessageType["OPENWEBRX_CLIENT_COUNT"] = "openwebrxClientCount";
+    WSMessageType["OPENWEBRX_COOLDOWN_NOTICE"] = "openwebrxCooldownNotice";
+})(WSMessageType || (WSMessageType = {}));
+// ===== 共享数据类型Schema定义 =====
+// 系统状态数据结构
+export const SystemStatusSchema = z.object({
+    isRunning: z.boolean(),
+    isDecoding: z.boolean(),
+    currentMode: ModeDescriptorSchema,
+    currentTime: z.number(),
+    nextSlotIn: z.number(),
+    audioStarted: z.boolean(),
+    radioConnected: z.boolean().optional(),
+    radioConnectionHealth: z.object({
+        connectionHealthy: z.boolean(),
+    }).optional(),
+    /** 引擎模式：digital（FT8/FT4）或 voice（语音通联） */
+    engineMode: z.enum(['digital', 'voice']).default('digital'),
+    /** 当前电台调制模式（语音模式下使用，如 USB/LSB/FM/AM） */
+    currentRadioMode: z.string().optional(),
+    /** 引擎状态机当前状态 */
+    engineState: z.enum(['idle', 'waking', 'starting', 'running', 'stopping']).optional(),
+    /** 引擎状态机上下文的精简投影 */
+    engineContext: z.object({
+        error: z.string().optional(),
+        startedResources: z.array(z.string()).optional(),
+        forcedStop: z.boolean().optional(),
+    }).nullable().optional(),
+});
+// 子窗口信息数据结构
+export const SubWindowInfoSchema = z.object({
+    slotInfo: SlotInfoSchema,
+    windowIdx: z.number(),
+});
+// 解码错误信息数据结构
+export const DecodeErrorInfoSchema = z.object({
+    error: z.object({
+        message: z.string(),
+        stack: z.string().optional(),
+    }),
+    request: z.object({
+        slotId: z.string(),
+        windowIdx: z.number(),
+    }),
+});
+// 频率状态数据结构
+export const FrequencyStateSchema = z.object({
+    frequency: z.number(),
+    mode: z.string(),
+    band: z.string(),
+    description: z.string(),
+    radioMode: z.string().optional(),
+    radioConnected: z.boolean(),
+    source: z.enum(['program', 'radio']).optional(),
+});
+export const SpectrumControlInvocationSchema = z.object({
+    id: SpectrumSessionControlIdSchema,
+    action: SpectrumSessionControlActionSchema,
+});
+// PTT状态数据结构
+export const PTTStatusSchema = z.object({
+    isTransmitting: z.boolean(),
+    operatorIds: z.array(z.string()),
+});
+export const OperatorRuntimeSlotSchema = z.enum(['TX1', 'TX2', 'TX3', 'TX4', 'TX5', 'TX6']);
+export const StrategyRuntimeContextSchema = z.object({
+    targetCallsign: z.string().optional(),
+    targetGrid: z.string().optional(),
+    reportSent: z.number().optional(),
+    reportReceived: z.number().optional(),
+    actualFrequency: z.number().optional(),
+});
+export const StrategyRuntimeSnapshotSchema = z.object({
+    currentState: z.string(),
+    slots: z.object({
+        TX1: z.string().optional(),
+        TX2: z.string().optional(),
+        TX3: z.string().optional(),
+        TX4: z.string().optional(),
+        TX5: z.string().optional(),
+        TX6: z.string().optional(),
+    }).optional(),
+    context: StrategyRuntimeContextSchema.optional(),
+    availableSlots: z.array(z.string()).optional(),
+});
+export const LevelMeterDisplayStyleSchema = z.enum([
+    's-meter-dbm',
+    's-meter',
+    'db-over-s9',
+]);
+/**
+ * Meter level reading
+ *
+ * Depending on the radio/vendor strategy, the same structure can represent:
+ * - branded S-meter output with optional dBm estimate
+ * - branded S-meter output without dBm display
+ * - generic Hamlib STRENGTH output shown as dB relative to S9
+ */
+export const LevelMeterReadingSchema = z.object({
+    /** Raw meter reading from the radio or normalized backend value */
+    raw: z.number(),
+    /** Percentage (0-100%) */
+    percent: z.number(),
+    /** S-unit value (0-9+), supports decimal (e.g., 4.5 = S4.5) */
+    sUnits: z.number(),
+    /** dB above S9 (only when >S9, e.g., 20 means S9+20dB) */
+    dbAboveS9: z.number().optional(),
+    /** Estimated absolute signal level in dBm (may be approximate depending on strategy) */
+    dBm: z.number(),
+    /** Human-readable formatted string (e.g., "S4", "S9+20dB", "-24 dB@S9") */
+    formatted: z.string(),
+    /** Preferred frontend presentation style for this meter reading */
+    displayStyle: LevelMeterDisplayStyleSchema,
+});
+// 电台数值表能力检测
+export const MeterCapabilitiesSchema = z.object({
+    strength: z.boolean(), // 接收信号强度 (STRENGTH)
+    swr: z.boolean(), // 驻波比 (SWR)
+    alc: z.boolean(), // 自动电平控制 (ALC)
+    power: z.boolean(), // 射频功率 (RFPOWER_METER / RFPOWER_METER_WATTS)
+    powerWatts: z.boolean(), // 是否支持绝对瓦数读取 (RFPOWER_METER_WATTS)
+});
+// 电台数值表数据结构
+export const MeterDataSchema = z.object({
+    swr: z.object({
+        raw: z.number(),
+        swr: z.number(),
+        alert: z.boolean(),
+    }).nullable(),
+    alc: z.object({
+        raw: z.number(),
+        percent: z.number(),
+        alert: z.boolean(),
+    }).nullable(),
+    level: LevelMeterReadingSchema.nullable(),
+    power: z.object({
+        raw: z.number(),
+        percent: z.number(),
+        watts: z.number().nullable(), // 绝对瓦数（仅当电台支持 RFPOWER_METER_WATTS 时非 null）
+        maxWatts: z.number().nullable(), // 当前频率+模式对应的量程瓦数
+    }).nullable(),
+});
+// ===== WebSocket消息Schema定义 =====
+// WebSocket基础消息结构
+export const WSBaseMessageSchema = z.object({
+    type: z.nativeEnum(WSMessageType),
+    timestamp: z.string(),
+    id: z.string().optional(),
+});
+// 通用消息
+export const WSPingMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.PING),
+    data: z.object({}).optional(),
+});
+export const WSPongMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.PONG),
+    data: z.object({}).optional(),
+});
+// 服务端到客户端消息
+export const WSModeChangedMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.MODE_CHANGED),
+    data: ModeDescriptorSchema,
+});
+export const WSSlotStartMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SLOT_START),
+    data: SlotInfoSchema,
+});
+export const WSSubWindowMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SUB_WINDOW),
+    data: SubWindowInfoSchema,
+});
+export const WSSlotPackUpdatedMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SLOT_PACK_UPDATED),
+    data: SlotPackSchema,
+});
+export const WSSpectrumCapabilitiesMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SPECTRUM_CAPABILITIES),
+    data: SpectrumCapabilitiesSchema,
+});
+export const WSSubscribeSpectrumMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SUBSCRIBE_SPECTRUM),
+    data: z.object({
+        kind: SpectrumKindSchema.nullable(),
+    }),
+});
+export const WSSpectrumFrameMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SPECTRUM_FRAME),
+    data: SpectrumFrameSchema,
+});
+export const WSSpectrumSessionStateChangedMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SPECTRUM_SESSION_STATE_CHANGED),
+    data: SpectrumSessionStateSchema,
+});
+export const WSInvokeSpectrumControlMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.INVOKE_SPECTRUM_CONTROL),
+    data: SpectrumControlInvocationSchema,
+});
+export const WSDecodeErrorMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.DECODE_ERROR),
+    data: DecodeErrorInfoSchema,
+});
+export const WSSystemStatusMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SYSTEM_STATUS),
+    data: SystemStatusSchema,
+});
+export const WSClientCountChangedMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.CLIENT_COUNT_CHANGED),
+    data: z.object({
+        count: z.number(),
+        timestamp: z.number(),
+    }),
+});
+export const WSClockStatusChangedMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.CLOCK_STATUS_CHANGED),
+    data: ClockStatusSummarySchema,
+});
+export const WSErrorMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.ERROR),
+    data: z.object({
+        message: z.string(),
+        userMessage: z.string().optional(),
+        /** 前端 i18n 翻译键（优先用于 Toast 副标题本地化） */
+        userMessageKey: z.string().optional(),
+        userMessageParams: z.record(z.union([z.string(), z.number()])).optional(),
+        code: z.string().optional(),
+        severity: z.enum(['info', 'warning', 'error', 'critical']).optional(),
+        suggestions: z.array(z.string()).optional(),
+        timestamp: z.union([z.string(), z.number()]).optional(),
+        context: z.record(z.unknown()).optional(),
+        details: z.any().optional(),
+    }),
+});
+// 日志本轻量变更通知（仅包含标识信息）
+export const WSLogbookChangeNoticeMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.LOGBOOK_CHANGE_NOTICE),
+    data: z.object({
+        logBookId: z.string(),
+        operatorId: z.string().optional(),
+    }),
+});
+// 客户端到服务端消息
+export const WSStartEngineMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.START_ENGINE),
+    data: z.object({}).optional(),
+});
+export const WSStopEngineMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.STOP_ENGINE),
+    data: z.object({}).optional(),
+});
+export const WSSetModeMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SET_MODE),
+    data: z.object({
+        mode: ModeDescriptorSchema,
+    }),
+});
+export const WSGetStatusMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.GET_STATUS),
+    data: z.object({}).optional(),
+});
+// ===== 电台操作员相关Schema =====
+/**
+ * 电台操作员状态信息
+ */
+export const OperatorStatusSchema = z.object({
+    id: z.string(),
+    isActive: z.boolean(),
+    isTransmitting: z.boolean(), // 是否正在发射（发射开关状态）
+    isInActivePTT: z.boolean().optional(), // 该操作员的音频是否正在被实际播放
+    currentSlot: z.string().optional(),
+    context: z.object({
+        myCall: z.string(),
+        myGrid: z.string(),
+        targetCall: z.string(),
+        targetGrid: z.string().optional(),
+        frequency: z.number().optional(),
+        reportSent: z.number().optional(), // 改为number类型
+        reportReceived: z.number().optional(), // 改为number类型
+    }),
+    strategy: z.object({
+        name: z.string(),
+        state: z.string(),
+        availableSlots: z.array(z.string()),
+    }),
+    runtime: StrategyRuntimeSnapshotSchema.optional(),
+    cycleInfo: z.object({
+        currentCycle: z.number(),
+        isTransmitCycle: z.boolean(),
+        cycleProgress: z.number().min(0).max(1), // 0-1 表示周期进度百分比
+    }).optional(),
+    // TX1-TX6 时隙内容
+    slots: z.object({
+        TX1: z.string().optional(),
+        TX2: z.string().optional(),
+        TX3: z.string().optional(),
+        TX4: z.string().optional(),
+        TX5: z.string().optional(),
+        TX6: z.string().optional(),
+    }).optional(),
+    // 发射周期配置
+    transmitCycles: z.array(z.number()).optional(),
+});
+/**
+ * 获取操作员列表消息
+ */
+export const WSGetOperatorsMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.GET_OPERATORS),
+});
+/**
+ * 操作员列表响应消息
+ */
+export const WSOperatorsListMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.OPERATORS_LIST),
+    data: z.object({
+        operators: z.array(OperatorStatusSchema),
+    }),
+});
+/**
+ * 操作员状态更新消息
+ */
+export const WSOperatorStatusUpdateMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.OPERATOR_STATUS_UPDATE),
+    data: OperatorStatusSchema,
+});
+/**
+ * 设置操作员上下文消息
+ */
+export const WSSetOperatorContextMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SET_OPERATOR_CONTEXT),
+    data: z.object({
+        operatorId: z.string(),
+        context: z.object({
+            myCall: z.string().optional(),
+            myGrid: z.string().optional(),
+            targetCallsign: z.string().optional(),
+            targetGrid: z.string().optional(),
+            frequency: z.number().optional(),
+            reportSent: z.number().optional(),
+            reportReceived: z.number().optional(),
+        }),
+    }),
+});
+/**
+ * 设置操作员运行时状态消息
+ */
+export const WSSetOperatorRuntimeStateMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SET_OPERATOR_RUNTIME_STATE),
+    data: z.object({
+        operatorId: z.string(),
+        state: OperatorRuntimeSlotSchema,
+    }),
+});
+/**
+ * 设置操作员运行时槽位内容消息
+ */
+export const WSSetOperatorRuntimeSlotContentMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SET_OPERATOR_RUNTIME_SLOT_CONTENT),
+    data: z.object({
+        operatorId: z.string(),
+        slot: OperatorRuntimeSlotSchema,
+        content: z.string(),
+    }),
+});
+/**
+ * 设置操作员发射周期消息
+ */
+export const WSSetOperatorTransmitCyclesMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SET_OPERATOR_TRANSMIT_CYCLES),
+    data: z.object({
+        operatorId: z.string(),
+        transmitCycles: z.array(z.number().min(0).max(1)),
+    }),
+});
+/**
+ * 启动操作员消息
+ */
+export const WSStartOperatorMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.START_OPERATOR),
+    data: z.object({
+        operatorId: z.string(),
+    }),
+});
+/**
+ * 停止操作员消息
+ */
+export const WSStopOperatorMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.STOP_OPERATOR),
+    data: z.object({
+        operatorId: z.string(),
+    }),
+});
+/**
+ * 手动双击消息行时附带的原始解码快照
+ */
+export const WSSelectedFrameSchema = z.object({
+    message: z.string(),
+    snr: z.number(),
+    dt: z.number(),
+    freq: z.number(),
+    slotStartMs: z.number(),
+});
+/**
+ * 操作员请求手动呼叫消息
+ */
+export const WSOperatorRequestCallMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.OPERATOR_REQUEST_CALL),
+    data: z.object({
+        operatorId: z.string(),
+        callsign: z.string(),
+        selectedFrame: WSSelectedFrameSchema.optional(),
+    }),
+});
+/**
+ * 设置客户端启用的操作员列表消息
+ */
+export const WSSetClientEnabledOperatorsMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SET_CLIENT_ENABLED_OPERATORS),
+    data: z.object({
+        enabledOperatorIds: z.array(z.string()),
+    }),
+});
+/**
+ * 设置客户端当前选中操作员消息
+ */
+export const WSSetClientSelectedOperatorMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SET_CLIENT_SELECTED_OPERATOR),
+    data: z.object({
+        selectedOperatorId: z.string().nullable(),
+    }),
+});
+/**
+ * 客户端握手消息
+ */
+export const WSClientHandshakeMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.CLIENT_HANDSHAKE),
+    data: z.object({
+        enabledOperatorIds: z.array(z.string()).nullable(), // null表示新客户端，数组表示已配置的偏好
+        selectedOperatorId: z.string().nullable().optional(),
+        clientInstanceId: z.string().min(1),
+        clientVersion: z.string().optional(),
+        clientCapabilities: z.array(z.string()).optional(),
+    }),
+});
+/**
+ * 服务器握手完成消息
+ */
+export const WSServerHandshakeCompleteMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SERVER_HANDSHAKE_COMPLETE),
+    data: z.object({
+        serverVersion: z.string().optional(),
+        supportedFeatures: z.array(z.string()).optional(),
+        finalEnabledOperatorIds: z.array(z.string()).optional(),
+        finalSelectedOperatorId: z.string().nullable().optional(),
+    }),
+});
+export const WSSlotPacksResetMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SLOT_PACKS_RESET),
+    data: z.object({
+        phase: z.enum(['start', 'complete']),
+    }),
+});
+/**
+ * 发射日志消息
+ */
+export const WSTransmissionLogMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.TRANSMISSION_LOG),
+    data: z.object({
+        operatorId: z.string(),
+        time: z.string(),
+        message: z.string(),
+        frequency: z.number(),
+        slotStartMs: z.number()
+    }),
+});
+/**
+ * 设置音量增益消息（线性单位）
+ */
+export const WSSetVolumeGainMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SET_VOLUME_GAIN),
+    data: z.object({
+        gain: z.number().min(0.001).max(10),
+    }),
+});
+/**
+ * 设置音量增益消息（dB单位）
+ */
+export const WSSetVolumeGainDbMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SET_VOLUME_GAIN_DB),
+    data: z.object({
+        gainDb: z.number().min(-60).max(20),
+    }),
+});
+/**
+ * QSO记录添加消息（服务端到客户端）
+ */
+export const WSQSORecordAddedMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.QSO_RECORD_ADDED),
+    data: z.object({
+        operatorId: z.string(),
+        logBookId: z.string(),
+        qsoRecord: QSORecordSchema,
+    }),
+});
+/**
+ * QSO记录更新消息（服务端到客户端）
+ */
+export const WSQSORecordUpdatedMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.QSO_RECORD_UPDATED),
+    data: z.object({
+        operatorId: z.string(),
+        logBookId: z.string(),
+        qsoRecord: QSORecordSchema,
+    }),
+});
+/**
+ * 日志本更新消息（服务端到客户端）
+ */
+export const WSLogbookUpdatedMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.LOGBOOK_UPDATED),
+    data: z.object({
+        logBookId: z.string(),
+        statistics: LogBookStatisticsSchema,
+    }),
+});
+/**
+ * 电台状态变化消息
+ */
+export const WSRadioStatusChangedMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.RADIO_STATUS_CHANGED),
+    data: z.object({
+        connected: z.boolean(),
+        status: RadioConnectionStatusSchema, // 精细化连接状态（必填）
+        radioInfo: RadioInfoSchema.nullable(), // 电台信息（连接时有值，断开时为null）
+        radioConfig: HamlibConfigSchema.optional(), // 电台配置（保持当前配置）
+        reason: z.string().optional(),
+        message: z.string().optional(), // 用户友好的消息
+        recommendation: z.string().optional(), // 操作建议
+        reconnectProgress: ReconnectProgressSchema.optional(), // 重连进度
+        connectionHealth: z.object({
+            connectionHealthy: z.boolean(),
+        }).optional(),
+        coreCapabilities: CoreRadioCapabilitiesSchema.optional(),
+        coreCapabilityDiagnostics: CoreCapabilityDiagnosticsSchema.optional(),
+        meterCapabilities: MeterCapabilitiesSchema.optional(), // 电台数值表能力（connected=true 时应始终携带）
+        /** @deprecated Tuner capability is now in radioCapabilityList event. Kept for backward compat. */
+        tunerCapabilities: TunerCapabilitiesSchema.optional(),
+    }),
+});
+/**
+ * 电台错误事件数据（专用错误频道）
+ * 包含完整的错误信息、解决建议、Profile 关联等
+ */
+export const RadioErrorEventDataSchema = z.object({
+    /** 技术错误消息（精简摘要；完整原始内容在 context.rawHamlibTrace） */
+    message: z.string(),
+    /** 用户友好的错误消息（兜底英文文案） */
+    userMessage: z.string(),
+    /** 前端 i18n 翻译键，格式如 'radio:error.xxx'；存在时前端优先使用 t() */
+    userMessageKey: z.string().optional(),
+    /** i18n 参数（与 userMessageKey 配合） */
+    userMessageParams: z.record(z.union([z.string(), z.number()])).optional(),
+    /** 解决建议列表 */
+    suggestions: z.array(z.string()).default([]),
+    /** 错误代码（RadioErrorCode） */
+    code: z.string().optional(),
+    /** 严重程度 */
+    severity: z.enum(['info', 'warning', 'error', 'critical']).default('error'),
+    /** ISO 时间戳（服务端生成） */
+    timestamp: z.string(),
+    /** 错误堆栈（仅非生产环境） */
+    stack: z.string().optional(),
+    /** 错误上下文 */
+    context: z.record(z.unknown()).optional(),
+    /** 连接健康状态 */
+    connectionHealth: z.object({
+        connectionHealthy: z.boolean(),
+    }).optional(),
+    /** 关联的 Profile ID */
+    profileId: z.string().nullable(),
+    /** 关联的 Profile 名称 */
+    profileName: z.string().nullable(),
+});
+/**
+ * 电台错误消息
+ */
+export const WSRadioErrorMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.RADIO_ERROR),
+    data: RadioErrorEventDataSchema,
+});
+/**
+ * 手动重连电台消息（客户端到服务端）
+ */
+export const WSRadioManualReconnectMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.RADIO_MANUAL_RECONNECT),
+    data: z.object({}).optional(),
+});
+/**
+ * 电台发射中断开连接消息
+ */
+export const WSRadioDisconnectedDuringTransmissionMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.RADIO_DISCONNECTED_DURING_TRANSMISSION),
+    data: z.object({
+        reason: z.string(),
+        message: z.string(),
+        recommendation: z.string(),
+    }),
+});
+/**
+ * 停止电台重连消息（客户端到服务端）
+ */
+export const WSRadioStopReconnectMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.RADIO_STOP_RECONNECT),
+    data: z.object({}).optional(),
+});
+/**
+ * 音频 sidecar 状态变化消息（服务端→客户端）
+ */
+export const WSAudioSidecarStatusChangedMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.AUDIO_SIDECAR_STATUS_CHANGED),
+    data: AudioSidecarStatusPayloadSchema,
+});
+/**
+ * 音频立即重试命令（客户端→服务端）
+ */
+export const WSAudioRetryNowMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.AUDIO_RETRY_NOW),
+    data: z.object({}).optional(),
+});
+/**
+ * 电源操作进度事件（服务端→客户端）
+ */
+export const WSRadioPowerStateMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.RADIO_POWER_STATE),
+    data: RadioPowerStateEventSchema,
+});
+/**
+ * 频率变化消息（服务端到客户端）
+ */
+export const WSFrequencyChangedMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.FREQUENCY_CHANGED),
+    data: FrequencyStateSchema,
+});
+export const WSSpectrumSessionStateChangedOutboundMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.SPECTRUM_SESSION_STATE_CHANGED),
+    data: SpectrumSessionStateSchema,
+});
+/**
+ * PTT状态变化消息（服务端到客户端）
+ */
+export const WSPTTStatusChangedMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.PTT_STATUS_CHANGED),
+    data: PTTStatusSchema,
+});
+/**
+ * 强制停止发射消息（客户端到服务端）
+ * 立即停止PTT并清空音频播放队列
+ */
+export const WSForceStopTransmissionMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.FORCE_STOP_TRANSMISSION),
+    data: z.object({}).optional(),
+});
+/**
+ * 从当前发射中移除单个操作员消息（客户端到服务端）
+ * 移除该操作员的音频并重混音，如果是最后一个操作员则停止PTT
+ */
+export const WSRemoveOperatorFromTransmissionMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.REMOVE_OPERATOR_FROM_TRANSMISSION),
+    data: z.object({
+        operatorId: z.string(),
+    }),
+});
+/**
+ * 电台数值表数据消息（服务端到客户端）
+ */
+export const WSMeterDataMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.METER_DATA),
+    data: MeterDataSchema,
+});
+/**
+ * 文本消息（Toast通知）
+ * 用于向客户端推送提示信息
+ */
+export const WSTextMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.TEXT_MESSAGE),
+    data: z.object({
+        title: z.string(),
+        text: z.string(),
+        color: z.enum(['success', 'warning', 'danger', 'default']).optional(),
+        timeout: z.number().nullable().optional(), // null 表示需要手动关闭，number 表示自动关闭的毫秒数
+        /** i18n key，前端有此字段时优先翻译显示 */
+        key: z.string().optional(),
+        /** i18n 插值参数 */
+        params: z.record(z.string()).optional(),
+    }),
+});
+// ===== 统一电台控制能力消息 =====
+/**
+ * 能力列表快照（连接成功后推送，server → client）
+ */
+export const WSRadioCapabilityListMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.RADIO_CAPABILITY_LIST),
+    data: CapabilityListSchema,
+});
+/**
+ * 单个能力值变化通知（server → client）
+ */
+export const WSRadioCapabilityChangedMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.RADIO_CAPABILITY_CHANGED),
+    data: CapabilityStateSchema,
+});
+/**
+ * 客户端写入能力值命令（client → server）
+ * 权限：execute:RadioControl
+ */
+export const WSWriteRadioCapabilityMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.WRITE_RADIO_CAPABILITY),
+    data: WriteCapabilityPayloadSchema,
+});
+// ===== 认证相关消息 =====
+/**
+ * 服务端要求认证（连接建立后发送）
+ */
+export const WSAuthRequiredMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.AUTH_REQUIRED),
+    data: z.object({
+        allowPublicViewing: z.boolean(),
+    }),
+});
+/**
+ * 客户端发送 JWT 进行认证（登录或权限升级）
+ */
+export const WSAuthTokenMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.AUTH_TOKEN),
+    data: z.object({
+        jwt: z.string(),
+    }),
+});
+/**
+ * 客户端选择公开观察者模式
+ */
+export const WSAuthPublicViewerMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.AUTH_PUBLIC_VIEWER),
+    data: z.object({}).optional(),
+});
+/**
+ * 认证结果（服务端到客户端）
+ */
+export const WSAuthResultMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.AUTH_RESULT),
+    data: z.object({
+        success: z.boolean(),
+        role: z.nativeEnum(UserRole).optional(),
+        label: z.string().optional(),
+        operatorIds: z.array(z.string()).optional(),
+        error: z.string().optional(),
+    }),
+});
+/**
+ * JWT 过期通知（服务端到客户端）
+ */
+export const WSAuthExpiredMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.AUTH_EXPIRED),
+    data: z.object({
+        reason: z.string().optional(),
+    }),
+});
+export const WSPluginListMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.PLUGIN_LIST),
+    data: PluginSystemSnapshotSchema,
+});
+export const WSPluginStatusChangedMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.PLUGIN_STATUS_CHANGED),
+    data: z.object({
+        generation: z.number().int().nonnegative(),
+        plugin: PluginStatusSchema,
+    }),
+});
+export const WSPluginDataMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.PLUGIN_DATA),
+    data: PluginDataPayloadSchema,
+});
+export const WSPluginLogMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.PLUGIN_LOG),
+    data: PluginLogEntrySchema,
+});
+export const WSPluginRuntimeLogMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.PLUGIN_RUNTIME_LOG),
+    data: PluginRuntimeLogEntrySchema,
+});
+export const WSGetPluginRuntimeLogHistoryMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.GET_PLUGIN_RUNTIME_LOG_HISTORY),
+    data: z.object({
+        limit: z.number().int().positive().max(5000).optional(),
+    }).optional(),
+});
+export const WSPluginRuntimeLogHistoryMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.PLUGIN_RUNTIME_LOG_HISTORY),
+    data: PluginRuntimeLogHistoryPayloadSchema,
+});
+export const WSPluginUserActionMessageSchema = WSBaseMessageSchema.extend({
+    type: z.literal(WSMessageType.PLUGIN_USER_ACTION),
+    data: PluginUserActionPayloadSchema,
+});
+// 联合所有WebSocket消息类型
+export const WSMessageSchema = z.discriminatedUnion('type', [
+    WSPingMessageSchema,
+    WSPongMessageSchema,
+    // 服务端到客户端
+    WSModeChangedMessageSchema,
+    WSSlotStartMessageSchema,
+    WSSubWindowMessageSchema,
+    WSSlotPackUpdatedMessageSchema,
+    WSSpectrumCapabilitiesMessageSchema,
+    WSSubscribeSpectrumMessageSchema,
+    WSSpectrumFrameMessageSchema,
+    WSSpectrumSessionStateChangedMessageSchema,
+    WSInvokeSpectrumControlMessageSchema,
+    WSDecodeErrorMessageSchema,
+    WSSystemStatusMessageSchema,
+    WSClientCountChangedMessageSchema,
+    WSClockStatusChangedMessageSchema,
+    WSErrorMessageSchema,
+    WSLogbookChangeNoticeMessageSchema,
+    WSTransmissionLogMessageSchema,
+    // 客户端到服务端
+    WSStartEngineMessageSchema,
+    WSStopEngineMessageSchema,
+    WSSetModeMessageSchema,
+    WSGetStatusMessageSchema,
+    // 操作员相关消息
+    WSGetOperatorsMessageSchema,
+    WSOperatorsListMessageSchema,
+    WSOperatorStatusUpdateMessageSchema,
+    WSSetOperatorContextMessageSchema,
+    WSSetOperatorRuntimeStateMessageSchema,
+    WSSetOperatorRuntimeSlotContentMessageSchema,
+    WSSetOperatorTransmitCyclesMessageSchema,
+    WSStartOperatorMessageSchema,
+    WSStopOperatorMessageSchema,
+    WSOperatorRequestCallMessageSchema,
+    // 音量控制消息
+    WSSetVolumeGainMessageSchema,
+    WSSetVolumeGainDbMessageSchema,
+    // 通联日志消息
+    WSQSORecordAddedMessageSchema,
+    WSQSORecordUpdatedMessageSchema,
+    WSLogbookUpdatedMessageSchema,
+    // 客户端启用操作员列表消息
+    WSSetClientEnabledOperatorsMessageSchema,
+    WSSetClientSelectedOperatorMessageSchema,
+    // 握手消息
+    WSClientHandshakeMessageSchema,
+    WSServerHandshakeCompleteMessageSchema,
+    WSSlotPacksResetMessageSchema,
+    // 电台连接管理消息
+    WSRadioStatusChangedMessageSchema,
+    WSRadioErrorMessageSchema,
+    WSRadioManualReconnectMessageSchema,
+    WSRadioStopReconnectMessageSchema,
+    WSRadioDisconnectedDuringTransmissionMessageSchema,
+    WSRadioPowerStateMessageSchema,
+    // 音频 sidecar 消息
+    WSAudioSidecarStatusChangedMessageSchema,
+    WSAudioRetryNowMessageSchema,
+    // 频率管理消息
+    WSFrequencyChangedMessageSchema,
+    // PTT状态管理消息
+    WSPTTStatusChangedMessageSchema,
+    WSForceStopTransmissionMessageSchema,
+    WSRemoveOperatorFromTransmissionMessageSchema,
+    // 电台数值表消息
+    WSMeterDataMessageSchema,
+    // 文本消息（Toast通知）
+    WSTextMessageSchema,
+    // 认证消息
+    WSAuthRequiredMessageSchema,
+    WSAuthTokenMessageSchema,
+    WSAuthPublicViewerMessageSchema,
+    WSAuthResultMessageSchema,
+    WSAuthExpiredMessageSchema,
+    // 插件系统消息
+    WSPluginListMessageSchema,
+    WSPluginStatusChangedMessageSchema,
+    WSPluginDataMessageSchema,
+    WSPluginLogMessageSchema,
+    WSPluginRuntimeLogMessageSchema,
+    WSGetPluginRuntimeLogHistoryMessageSchema,
+    WSPluginRuntimeLogHistoryMessageSchema,
+    WSPluginUserActionMessageSchema,
+]);
+export const TransmitRequestSchema = z.object({
+    operatorId: z.string(),
+    transmission: z.string(),
+    /** 是否覆盖同一操作员在同一时隙的现有 TX 帧（自动重决策时为 true） */
+    replaceExisting: z.boolean().optional(),
+});
+// ===== 前端应用事件接口 =====
+/**
+ * 发射完成事件信息
+ */
+export const TransmissionCompleteInfoSchema = z.object({
+    operatorId: z.string(),
+    success: z.boolean(),
+    duration: z.number().optional(),
+    error: z.string().optional(),
+    mixedWith: z.array(z.string()).optional(), // 与其他操作员混音的ID列表
+});
+//# sourceMappingURL=websocket.schema.js.map