@tx5dr/contracts 1.3.0 → 1.5.0

package/src/schema/websocket.schema.ts

@@ -26,6 +26,7 @@ import { RadioInfoSchema, HamlibConfigSchema, TunerStatusSchema, TunerCapabiliti
 import { RadioProfileSchema, ProfileChangedEventSchema } from './radio-profile.schema.js';
 import { UserRole } from './auth.schema.js';
 import type { VoicePTTLock } from './voice.schema.js';
+import type { VoiceKeyerStatus } from './voice-keyer.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';
@@ -116,6 +117,9 @@ export enum WSMessageType {
   // ===== 电台数值表 =====
   METER_DATA = 'meterData',
 
+  // ===== 电台实际静噪状态 =====
+  SQUELCH_STATUS_CHANGED = 'squelchStatusChanged',
+
   // ===== 极简文本消息 =====
   TEXT_MESSAGE = 'textMessage',
 
@@ -164,6 +168,9 @@ export enum WSMessageType {
   VOICE_PTT_LOCK_CHANGED = 'voicePttLockChanged',
   VOICE_SET_RADIO_MODE = 'voiceSetRadioMode',
   VOICE_RADIO_MODE_CHANGED = 'voiceRadioModeChanged',
+  VOICE_KEYER_PLAY = 'voiceKeyerPlay',
+  VOICE_KEYER_STOP = 'voiceKeyerStop',
+  VOICE_KEYER_STATUS_CHANGED = 'voiceKeyerStatusChanged',
 
   // ===== 进程监控 =====
   PROCESS_SNAPSHOT = 'processSnapshot',
@@ -180,6 +187,7 @@ export enum WSMessageType {
   PLUGIN_USER_ACTION = 'pluginUserAction',
   PLUGIN_PAGE_PUSH = 'pluginPagePush',
   PLUGIN_PANEL_META = 'pluginPanelMeta',
+  PLUGIN_PANEL_CONTRIBUTIONS_CHANGED = 'pluginPanelContributionsChanged',
 
   // ===== OpenWebRX SDR =====
   OPENWEBRX_LISTEN_STATUS = 'openwebrxListenStatus',
@@ -209,7 +217,7 @@ export const SystemStatusSchema = z.object({
   /** 当前电台调制模式（语音模式下使用，如 USB/LSB/FM/AM） */
   currentRadioMode: z.string().optional(),
   /** 引擎状态机当前状态 */
-  engineState: z.enum(['idle', 'waking', 'starting', 'running', 'stopping']).optional(),
+  engineState: z.enum(['idle', 'starting', 'running', 'stopping']).optional(),
   /** 引擎状态机上下文的精简投影 */
   engineContext: z.object({
     error: z.string().optional(),
@@ -259,6 +267,14 @@ export const PTTStatusSchema = z.object({
   operatorIds: z.array(z.string()),
 });
 
+export const SquelchStatusSchema = z.object({
+  supported: z.boolean(),
+  open: z.boolean().nullable(),
+  muted: z.boolean(),
+  source: z.enum(['hamlib-dcd', 'unsupported']),
+  updatedAt: z.number(),
+});
+
 export const OperatorRuntimeSlotSchema = z.enum(['TX1', 'TX2', 'TX3', 'TX4', 'TX5', 'TX6']);
 export type OperatorRuntimeSlot = z.infer<typeof OperatorRuntimeSlotSchema>;
 
@@ -357,6 +373,7 @@ export type SubWindowInfo = z.infer<typeof SubWindowInfoSchema>;
 export type DecodeErrorInfo = z.infer<typeof DecodeErrorInfoSchema>;
 export type FrequencyState = z.infer<typeof FrequencyStateSchema>;
 export type PTTStatus = z.infer<typeof PTTStatusSchema>;
+export type SquelchStatus = z.infer<typeof SquelchStatusSchema>;
 export type MeterData = z.infer<typeof MeterDataSchema>;
 
 // ===== WebSocket消息Schema定义 =====
@@ -526,11 +543,6 @@ export const OperatorStatusSchema = z.object({
     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(),
@@ -1020,6 +1032,13 @@ export const WSMeterDataMessageSchema = WSBaseMessageSchema.extend({
 
 export type WSMeterDataMessage = z.infer<typeof WSMeterDataMessageSchema>;
 
+export const WSSquelchStatusChangedMessageSchema = WSBaseMessageSchema.extend({
+  type: z.literal(WSMessageType.SQUELCH_STATUS_CHANGED),
+  data: SquelchStatusSchema,
+});
+
+export type WSSquelchStatusChangedMessage = z.infer<typeof WSSquelchStatusChangedMessageSchema>;
+
 /**
  * 文本消息（Toast通知）
  * 用于向客户端推送提示信息
@@ -1270,6 +1289,7 @@ export const WSMessageSchema = z.discriminatedUnion('type', [
 
   // 电台数值表消息
   WSMeterDataMessageSchema,
+  WSSquelchStatusChangedMessageSchema,
 
   // 文本消息（Toast通知）
   WSTextMessageSchema,
@@ -1404,6 +1424,9 @@ export interface DigitalRadioEngineEvents {
   // 电台数值表事件
   meterData: (data: MeterData) => void;
 
+  // 电台实际静噪状态事件
+  squelchStatusChanged: (data: SquelchStatus) => void;
+
   // QSO 日志事件
   qsoRecordAdded: (data: { operatorId: string; logBookId: string; qsoRecord: z.infer<typeof QSORecordSchema> }) => void;
   qsoRecordUpdated: (data: { operatorId: string; logBookId: string; qsoRecord: z.infer<typeof QSORecordSchema> }) => void;
@@ -1439,6 +1462,7 @@ export interface DigitalRadioEngineEvents {
   // 语音模式事件
   voicePttLockChanged: (data: VoicePTTLock) => void;
   voiceRadioModeChanged: (data: { radioMode: string }) => void;
+  voiceKeyerStatusChanged: (data: VoiceKeyerStatus) => void;
 
   // 进程监控事件
   processSnapshot: (data: import('./process-monitor.schema.js').ProcessSnapshot) => void;
@@ -1467,6 +1491,7 @@ export interface DigitalRadioEngineEvents {
     data?: unknown;
   }) => void;
   pluginPanelMeta: (data: import('./plugin.schema.js').PluginPanelMetaPayload) => void;
+  pluginPanelContributionsChanged: (data: import('./plugin.schema.js').PluginUIPanelContributionGroup) => void;
 
   // 内部子系统间通信事件（不通过 WebSocket 广播，用于 engine emitter 内部编排）
   encodeStart: (slotInfo: z.infer<typeof SlotInfoSchema>) => void;