@tx5dr/contracts 1.7.3 → 1.7.5

package/dist/utils/__tests__/cwTiming.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cwTiming.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/cwTiming.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,oBAAoB,EACpB,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AAExB,SAAS,oBAAoB,CAAC,IAAY,EAAE,GAAW;IACrD,OAAO,8BAA8B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;AACzG,CAAC;AAED,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACpD,MAAM,CAAC,8BAA8B,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,2BAA2B,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5C,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE;YAChC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;SAChC,CAAC,CAAC;QAEH,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YAC7C,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE;YAChC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;YAC/B,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE;YAClC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;SAChC,CAAC,CAAC;QAEH,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9C,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE;YAChC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;YAC/B,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE;YAClC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;SAChC,CAAC,CAAC;QAEH,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5C,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE;YAChC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;YAC/B,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE;YACjC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE;SACjC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,CAAC,8BAA8B,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACtD,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE;SAClC,CAAC,CAAC;QAEH,MAAM,CAAC,8BAA8B,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACvD,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE;YACjC,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE;YACnC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE;SAClC,CAAC,CAAC;QAEH,MAAM,CAAC,8BAA8B,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACxD,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE;YACjC,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE;YACnC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE;SAClC,CAAC,CAAC;QAEH,MAAM,CAAC,8BAA8B,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACtD,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE;YACjC,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE;YAClC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE;SACnC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,2BAA2B,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxD,MAAM,CAAC,2BAA2B,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,CAAC,2BAA2B,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gFAAgF,EAAE,GAAG,EAAE;QACxF,MAAM,CAAC,2BAA2B,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1D,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnD,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,2BAA2B,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzD,MAAM,CAAC,2BAA2B,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtD,MAAM,CAAC,2BAA2B,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/cwTiming.d.ts

@@ -0,0 +1,36 @@
+/**
+ * CW text to Morse timing encoder.
+ *
+ * Timing follows the ITU/PARIS convention:
+ * - dit = 1200 / WPM ms
+ * - dah = 3 dits
+ * - intra-character gap = 1 dit
+ * - character gap = 3 dits
+ * - word gap = 7 dits
+ */
+export interface CWTimingEvent {
+    type: 'key-down' | 'key-up';
+    /** Delay from the previous event, in milliseconds. */
+    afterMs: number;
+}
+export interface CWKeyStateSegment {
+    /** true when the key/tone is closed, false for silence/open key. */
+    keyDown: boolean;
+    /** Segment duration in milliseconds. */
+    durationMs: number;
+}
+/**
+ * Encodes supported CW text into a sequence of timing events.
+ */
+export declare function encodeTextToCWEvents(text: string, wpm: number): CWTimingEvent[];
+/**
+ * Encodes supported CW text into key-down/silence duration segments.
+ * This is the shared adapter input for browser sidetone and other local keying outputs.
+ */
+export declare function encodeTextToCWKeyStateSegments(text: string, wpm: number): CWKeyStateSegment[];
+/**
+ * Estimates total CW message duration from the first key-down to the final key-up.
+ * Uses the PARIS timing base from Hamlib: dot milliseconds = 1200 / WPM.
+ */
+export declare function estimateCWMessageDurationMs(text: string, wpm: number): number;
+//# sourceMappingURL=cwTiming.d.ts.map

package/dist/utils/cwTiming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cwTiming.d.ts","sourceRoot":"","sources":["../../src/utils/cwTiming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;CACpB;AAuCD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,CAgB/E;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAkB7F;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAO7E"}

package/dist/utils/cwTiming.js

@@ -0,0 +1,155 @@
+const DOT_UNITS = {
+    dit: 1,
+    dah: 3,
+    intraChar: 1,
+    interChar: 3,
+    interWord: 7,
+};
+const MORSE_TABLE = {
+    A: '.-', B: '-...', C: '-.-.', D: '-..',
+    E: '.', F: '..-.', G: '--.', H: '....',
+    I: '..', J: '.---', K: '-.-', L: '.-..',
+    M: '--', N: '-.', O: '---', P: '.--.',
+    Q: '--.-', R: '.-.', S: '...', T: '-',
+    U: '..-', V: '...-', W: '.--', X: '-..-',
+    Y: '-.--', Z: '--..',
+    '0': '-----', '1': '.----', '2': '..---', '3': '...--',
+    '4': '....-', '5': '.....', '6': '-....', '7': '--...',
+    '8': '---..', '9': '----.',
+    '.': '.-.-.-', ',': '--..--', '?': '..--..', '/': '-..-.',
+    '@': '.--.-.', '=': '-...-', '-': '-....-', '+': '.-.-.',
+    ':': '---...', ';': '-.-.-.', '\'': '.----.', '"': '.-..-.',
+    '!': '-.-.--', '&': '.-...', '(': '-.--.', ')': '-.--.-',
+    '_': '..--.-', '$': '...-..-',
+};
+const PROSIGN_MAP = {
+    '<AR>': '.-.-.',
+    '<SK>': '...-.-',
+    '<BT>': '-...-',
+    '<KN>': '-.--.',
+    '<BK>': '-...-.-',
+    '<CL>': '-.-..-..',
+};
+const PROSIGN_TOKENS = Object.keys(PROSIGN_MAP).sort((a, b) => b.length - a.length);
+/**
+ * Encodes supported CW text into a sequence of timing events.
+ */
+export function encodeTextToCWEvents(text, wpm) {
+    const events = [];
+    let nextEventDelayMs = 0;
+    for (const segment of encodeTextToCWKeyStateSegments(text, wpm)) {
+        if (!segment.keyDown) {
+            nextEventDelayMs += segment.durationMs;
+            continue;
+        }
+        events.push({ type: 'key-down', afterMs: nextEventDelayMs });
+        events.push({ type: 'key-up', afterMs: segment.durationMs });
+        nextEventDelayMs = 0;
+    }
+    return events;
+}
+/**
+ * Encodes supported CW text into key-down/silence duration segments.
+ * This is the shared adapter input for browser sidetone and other local keying outputs.
+ */
+export function encodeTextToCWKeyStateSegments(text, wpm) {
+    const dotMs = getRoundedDotMs(wpm);
+    const tokenizedWords = tokenizeText(text);
+    const segments = [];
+    let firstToken = true;
+    for (const word of tokenizedWords) {
+        for (let ti = 0; ti < word.length; ti += 1) {
+            if (!firstToken) {
+                appendSegment(segments, false, (ti === 0 ? DOT_UNITS.interWord : DOT_UNITS.interChar) * dotMs);
+            }
+            appendCodeSegments(segments, word[ti], dotMs);
+            firstToken = false;
+        }
+    }
+    return segments;
+}
+/**
+ * Estimates total CW message duration from the first key-down to the final key-up.
+ * Uses the PARIS timing base from Hamlib: dot milliseconds = 1200 / WPM.
+ */
+export function estimateCWMessageDurationMs(text, wpm) {
+    const safeWpm = getSafeWpm(wpm);
+    const dotUnits = countCWMessageDotUnits(text);
+    if (dotUnits <= 0) {
+        return 0;
+    }
+    return Math.ceil(dotUnits * (1200 / safeWpm));
+}
+function appendCodeSegments(segments, code, dotMs) {
+    for (let si = 0; si < code.length; si += 1) {
+        if (si > 0) {
+            appendSegment(segments, false, DOT_UNITS.intraChar * dotMs);
+        }
+        appendSegment(segments, true, (code[si] === '-' ? DOT_UNITS.dah : DOT_UNITS.dit) * dotMs);
+    }
+}
+function appendSegment(segments, keyDown, durationMs) {
+    if (durationMs <= 0) {
+        return;
+    }
+    const previous = segments[segments.length - 1];
+    if (previous?.keyDown === keyDown) {
+        previous.durationMs += durationMs;
+        return;
+    }
+    segments.push({ keyDown, durationMs });
+}
+function countCWMessageDotUnits(text) {
+    const tokenizedWords = tokenizeText(text);
+    let firstToken = true;
+    let totalUnits = 0;
+    for (const word of tokenizedWords) {
+        for (let ti = 0; ti < word.length; ti += 1) {
+            if (!firstToken) {
+                totalUnits += ti === 0 ? DOT_UNITS.interWord : DOT_UNITS.interChar;
+            }
+            const code = word[ti];
+            for (let si = 0; si < code.length; si += 1) {
+                totalUnits += si === 0 ? 0 : DOT_UNITS.intraChar;
+                totalUnits += code[si] === '-' ? DOT_UNITS.dah : DOT_UNITS.dit;
+            }
+            firstToken = false;
+        }
+    }
+    return totalUnits;
+}
+function tokenizeText(text) {
+    const normalized = text.toUpperCase().trim();
+    if (!normalized) {
+        return [];
+    }
+    return normalized
+        .split(/\s+/)
+        .map(tokenizeWord)
+        .filter((word) => word.length > 0);
+}
+function tokenizeWord(word) {
+    const codes = [];
+    let index = 0;
+    while (index < word.length) {
+        const prosign = PROSIGN_TOKENS.find((token) => word.startsWith(token, index));
+        if (prosign) {
+            codes.push(PROSIGN_MAP[prosign]);
+            index += prosign.length;
+            continue;
+        }
+        const code = MORSE_TABLE[word[index]];
+        if (code) {
+            codes.push(code);
+        }
+        index += 1;
+    }
+    return codes;
+}
+function getRoundedDotMs(wpm) {
+    return Math.round(1200 / getSafeWpm(wpm));
+}
+function getSafeWpm(wpm) {
+    return Math.max(5, Math.min(60, Math.round(Number(wpm) || 20)));
+}
+//# sourceMappingURL=cwTiming.js.map

package/dist/utils/cwTiming.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tx5dr/contracts",
-  "version": "1.7.3",
+  "version": "1.7.5",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/index.ts

@@ -118,12 +118,17 @@ export * from './schema/system.schema.js';
 export * from './schema/voice.schema.js';
 export * from './schema/voice-keyer.schema.js';
 
+// CW Keyer Schema
+export * from './schema/cw-keyer.schema.js';
+export * from './schema/cw-decoder.schema.js';
+
 // Station Info Schema
 export * from './schema/station-info.schema.js';
 
 // Grid Utils
 export * from './utils/grid.js';
 export * from './utils/callsign.js';
+export * from './utils/cwTiming.js';
 
 // Process Monitor Schema
 export * from './schema/process-monitor.schema.js';
@@ -153,6 +158,9 @@ export * from './schema/realtime.schema.js';
 // Desktop HTTPS Schema
 export * from './schema/desktop-https.schema.js';
 
+// Device UI Schema
+export * from './schema/device-ui.schema.js';
+
 // Plugin Schema
 export * from './schema/plugin.schema.js';
 export * from './schema/update.schema.js';

package/src/schema/__tests__/ability.test.ts

@@ -0,0 +1,40 @@
+import { describe, expect, it } from 'vitest';
+import {
+  buildAbilityRules,
+  Permission,
+  PERMISSION_GROUPS,
+  PERMISSION_RULE_MAP,
+} from '../ability.js';
+import { UserRole } from '../auth.schema.js';
+
+describe('ability contracts', () => {
+  it('maps CW decoder permissions to separate control and config capabilities', () => {
+    expect(PERMISSION_RULE_MAP[Permission.CW_DECODER_CONTROL]).toEqual({
+      action: 'execute',
+      subject: 'CWDecoder',
+    });
+    expect(PERMISSION_RULE_MAP[Permission.CW_DECODER_CONFIG]).toEqual({
+      action: 'update',
+      subject: 'CWDecoderConfig',
+    });
+  });
+
+  it('keeps CW decoder permissions delegatable instead of granting them to every operator', () => {
+    expect(buildAbilityRules({ role: UserRole.OPERATOR, operatorIds: ['op1'] }))
+      .not.toContainEqual({ action: 'execute', subject: 'CWDecoder' });
+
+    expect(buildAbilityRules({
+      role: UserRole.OPERATOR,
+      operatorIds: ['op1'],
+      permissionGrants: [{ permission: Permission.CW_DECODER_CONTROL }],
+    })).toContainEqual({ action: 'execute', subject: 'CWDecoder' });
+  });
+
+  it('exposes CW permissions in the token permission groups', () => {
+    const cwGroup = PERMISSION_GROUPS.find(group => group.key === 'cw');
+    expect(cwGroup?.permissions).toEqual([
+      Permission.CW_DECODER_CONTROL,
+      Permission.CW_DECODER_CONFIG,
+    ]);
+  });
+});

package/src/schema/__tests__/cw-decoder.schema.test.ts

@@ -0,0 +1,127 @@
+import { describe, expect, it } from 'vitest';
+import {
+  CWDecoderConfigSchema,
+  CWDecoderEventSchema,
+  CWDecoderStatusSchema,
+  CWDecoderTuningUpdateSchema,
+} from '../cw-decoder.schema.js';
+
+describe('CW decoder contracts', () => {
+  it('parses v1 defaults', () => {
+    expect(CWDecoderConfigSchema.parse({})).toMatchObject({
+      enabled: false,
+      backend: 'deepcw-onnx',
+      runtimeBackend: 'cpu',
+      modelSize: 'tiny',
+      language: 'en',
+      mode: 'streaming',
+      targetFreqHz: 800,
+      filterWidthHz: 800,
+      windowSeconds: 12,
+      decodeIntervalMs: 1000,
+      muteWhileTransmitting: true,
+      workerCount: 1,
+      minCommitChars: 1,
+      commitStability: 2,
+      maxPendingAgeMs: 4000,
+    });
+  });
+
+  it('accepts pending and commit transcript events', () => {
+    expect(CWDecoderEventSchema.parse({
+      kind: 'pending',
+      text: 'CQ TEST',
+      confidence: 0.8,
+      timestamp: 1,
+    })).toMatchObject({ kind: 'pending', text: 'CQ TEST' });
+
+    expect(CWDecoderEventSchema.parse({
+      kind: 'commit',
+      text: 'CQ TEST',
+      confidence: 0.9,
+      timestamp: 2,
+      segment: {
+        id: 'seg-1',
+        sessionId: 'session-1',
+        sequence: 1,
+        text: 'CQ TEST',
+        startedAt: 1,
+        updatedAt: 2,
+        endedAt: 2,
+        confidence: 0.9,
+        finalized: true,
+        prependSpace: true,
+      },
+    })).toMatchObject({ kind: 'commit', segment: { finalized: true } });
+  });
+
+  it('accepts structured transcript reset, pending, and commit events', () => {
+    expect(CWDecoderEventSchema.parse({
+      kind: 'transcript_reset',
+      sessionId: 'session-1',
+      timestamp: 1,
+    })).toMatchObject({ kind: 'transcript_reset', sessionId: 'session-1' });
+
+    expect(CWDecoderEventSchema.parse({
+      kind: 'transcript_pending',
+      pending: {
+        sessionId: 'session-1',
+        version: 1,
+        text: 'CQ TE',
+        plainText: 'CQ TE',
+        finalized: false,
+        confidence: 0.7,
+        targetFreqHz: 800,
+        filterWidthHz: 800,
+        updatedAt: 2,
+      },
+      timestamp: 2,
+    })).toMatchObject({ kind: 'transcript_pending', pending: { finalized: false, version: 1 } });
+
+    expect(CWDecoderEventSchema.parse({
+      kind: 'transcript_commit',
+      segment: {
+        id: 'seg-1',
+        sessionId: 'session-1',
+        sequence: 1,
+        text: 'CQ TEST',
+        plainText: 'CQ TEST',
+        finalized: true,
+        prependSpace: false,
+        confidence: 0.9,
+        targetFreqHz: 800,
+        filterWidthHz: 800,
+        characterSpans: [{ char: 'C', startFrame: 1, endFrame: 2 }],
+        wordSpaceSpans: [{ startFrame: 10, endFrame: 12 }],
+        startedAt: 1,
+        endedAt: 3,
+        updatedAt: 3,
+      },
+      timestamp: 3,
+    })).toMatchObject({ kind: 'transcript_commit', segment: { sequence: 1, prependSpace: false } });
+  });
+
+  it('rejects model sizes that are not packaged in v1', () => {
+    expect(() => CWDecoderConfigSchema.parse({ modelSize: 'base' })).toThrow();
+  });
+
+  it('validates runtime tuning updates', () => {
+    expect(CWDecoderTuningUpdateSchema.parse({ targetFreqHz: 650 })).toEqual({ targetFreqHz: 650 });
+    expect(CWDecoderTuningUpdateSchema.parse({ filterWidthHz: 250 })).toEqual({ filterWidthHz: 250 });
+    expect(() => CWDecoderTuningUpdateSchema.parse({})).toThrow();
+    expect(() => CWDecoderTuningUpdateSchema.parse({ targetFreqHz: 50 })).toThrow();
+    expect(() => CWDecoderTuningUpdateSchema.parse({ filterWidthHz: 900 })).toThrow();
+  });
+
+  it('represents muted listening state', () => {
+    const config = CWDecoderConfigSchema.parse({ enabled: true });
+    expect(CWDecoderStatusSchema.parse({
+      enabled: true,
+      state: 'muted',
+      config,
+      muted: true,
+      active: false,
+      updatedAt: 3,
+    })).toMatchObject({ state: 'muted', muted: true });
+  });
+});

package/src/schema/__tests__/device-ui.schema.test.ts

@@ -0,0 +1,122 @@
+import { describe, expect, it } from 'vitest';
+
+import {
+  DeviceUiBootstrapSnapshotSchema,
+  DeviceUiWsEventSchema,
+  DeviceUiJwtPayloadSchema,
+  DeviceUiSessionRequestSchema,
+  DeviceUiSessionResponseSchema,
+} from '../device-ui.schema.js';
+
+describe('device UI schemas', () => {
+  it('accepts the dedicated device UI JWT payload only', () => {
+    expect(DeviceUiJwtPayloadSchema.parse({
+      typ: 'device-ui',
+      aud: 'tx5dr-device-ui',
+      deviceId: 'panel-1',
+      sessionId: 'session-1',
+      iat: 1,
+      exp: 2,
+    }).aud).toBe('tx5dr-device-ui');
+
+    expect(() => DeviceUiJwtPayloadSchema.parse({
+      typ: 'access',
+      aud: 'tx5dr-device-ui',
+      deviceId: 'panel-1',
+      sessionId: 'session-1',
+      iat: 1,
+      exp: 2,
+    })).toThrow();
+  });
+
+  it('describes session request and response contracts', () => {
+    expect(DeviceUiSessionRequestSchema.parse({ deviceId: 'panel-1', sessionToken: 'secret' }).deviceId).toBe('panel-1');
+    expect(DeviceUiSessionResponseSchema.parse({
+      jwt: 'jwt',
+      deviceId: 'panel-1',
+      sessionId: 'session-1',
+      expiresAt: 1_700_000_001_000,
+    }).sessionId).toBe('session-1');
+  });
+
+  it('describes the mode-aware bootstrap snapshot and WS event', () => {
+    const snapshot = DeviceUiBootstrapSnapshotSchema.parse({
+      server: { status: 'ok', version: 'test', webPort: 8076 },
+      station: { callsign: 'BG5DRB', callsigns: ['BG5DRB', 'BG5AAA'] },
+      operators: [{ id: 'op1', callsign: 'BG5AAA', active: true, transmitting: false, ptt: false }],
+      engine: { running: true, mode: 'digital', currentMode: { name: 'FT8', slotMs: 15000 }, state: 'running' },
+      radio: { connected: true, frequency: 7074000, radioMode: 'USB-D', ptt: false, tx: false },
+      ft8: {
+        slot: null,
+        utc: null,
+        cycle: null,
+        periodMs: 15000,
+        recentDecodeRawMessages: ['CQ TEST AA00'],
+        lastDecodeRawMessage: 'CQ TEST AA00',
+        recentFramesSlotId: 'FT8-1',
+        recentFramesSlotStartMs: 1_700_000_000_000,
+        recentFrames: [{
+          slotId: 'FT8-1',
+          slotStartMs: 1_700_000_000_000,
+          snr: -10,
+          freq: 1200,
+          dt: 0.1,
+          message: 'CQ TEST AA00',
+          operatorId: null,
+          countryZh: '测试地区',
+          countryEn: 'Test Region',
+        }],
+        currentTx: { active: false, operatorIds: [], messages: [], lastMessage: null, slotStartMs: null },
+      },
+      voice: {
+        active: false,
+        radioMode: null,
+        pttLocked: false,
+        pttLockedByLabel: null,
+        keyerActive: false,
+        keyerMode: null,
+        keyerSlotId: null,
+      },
+      cw: {
+        decoder: {
+          enabled: false,
+          active: false,
+          state: 'disabled',
+          muted: false,
+          pendingText: '',
+          committedText: '',
+          lastDecodeAt: null,
+          updatedAt: 1,
+        },
+        keyer: {
+          active: false,
+          mode: null,
+          messageId: null,
+          currentText: null,
+          lastText: null,
+        },
+        currentTx: {
+          active: false,
+          messages: [],
+          lastMessage: null,
+        },
+      },
+      access: { localUrl: 'http://192.168.1.10:8076', localUrls: ['http://192.168.1.10:8076'] },
+      updatedAt: 1,
+    });
+
+    expect(snapshot.station.callsign).toBe('BG5DRB');
+    expect(snapshot.station.callsigns).toEqual(['BG5DRB', 'BG5AAA']);
+    expect(snapshot.operators[0]?.callsign).toBe('BG5AAA');
+    expect(snapshot.ft8.recentFramesSlotId).toBe('FT8-1');
+    expect(snapshot.ft8.recentFrames[0]?.slotId).toBe('FT8-1');
+    expect(snapshot.ft8.recentFrames[0]?.countryZh).toBe('测试地区');
+    expect(snapshot.ft8.lastDecodeRawMessage).toBe('CQ TEST AA00');
+    expect(snapshot.cw.decoder.state).toBe('disabled');
+    expect(DeviceUiWsEventSchema.parse({
+      type: 'snapshot',
+      payload: snapshot,
+      timestamp: '2026-05-14T00:00:00.000Z',
+    }).payload.server.status).toBe('ok');
+  });
+});

package/src/schema/__tests__/process-monitor.schema.test.ts

@@ -143,4 +143,103 @@ describe('ProcessSnapshotSchema', () => {
     expect(parsed.decodeWorkers?.summary.status).toBe('stopped');
     expect(parsed.decodeWorkers?.summary.lastError).toBeUndefined();
   });
+
+  it('accepts generic worker pool telemetry while preserving decodeWorkers compatibility', () => {
+    const decodeWorkerTelemetry = {
+      summary: {
+        status: 'ready' as const,
+        workerCount: 1,
+        desiredWorkers: 1,
+        readyCount: 1,
+        busyCount: 0,
+        totalRss: 256,
+        totalCpu: 12,
+        nativeThreadsPerWorker: 2,
+        pendingJobs: 0,
+        activeJobs: 0,
+      },
+      workers: [
+        {
+          workerId: 1,
+          pid: 1234,
+          ready: true,
+          busy: false,
+          nativeThreads: 2,
+          uptimeSeconds: 30,
+          memory: {
+            heapUsed: 100,
+            heapTotal: 200,
+            rss: 256,
+            external: 20,
+            arrayBuffers: 10,
+          },
+          cpu: {
+            user: 10,
+            system: 2,
+            total: 12,
+          },
+          lastSeenAt: 2,
+        },
+      ],
+    };
+
+    const parsed = ProcessSnapshotSchema.parse({
+      ...createBaseSnapshot(),
+      decodeWorkers: decodeWorkerTelemetry,
+      workerPools: [
+        {
+          id: 'ft8-decode',
+          name: 'FT8 Decode Workers',
+          kind: 'decode',
+          ...decodeWorkerTelemetry,
+        },
+        {
+          id: 'cw-decoder',
+          name: 'CW Decoder Workers',
+          kind: 'cw-decoder',
+          summary: {
+            status: 'ready',
+            workerCount: 1,
+            desiredWorkers: 1,
+            readyCount: 1,
+            busyCount: 0,
+            totalRss: 512,
+            totalCpu: 4,
+            nativeThreadsPerWorker: 1,
+            pendingJobs: 0,
+            activeJobs: 0,
+          },
+          workers: [
+            {
+              workerId: 1,
+              pid: 5678,
+              ready: true,
+              busy: false,
+              nativeThreads: 1,
+              uptimeSeconds: 8,
+              memory: {
+                heapUsed: 120,
+                heapTotal: 220,
+                rss: 512,
+                external: 30,
+                arrayBuffers: 15,
+              },
+              cpu: {
+                user: 3,
+                system: 1,
+                total: 4,
+              },
+              lastSeenAt: 3,
+            },
+          ],
+        },
+      ],
+    });
+
+    expect(parsed.decodeWorkers?.summary.workerCount).toBe(1);
+    expect(parsed.workerPools?.map((pool) => pool.id)).toEqual(['ft8-decode', 'cw-decoder']);
+    expect(parsed.workerPools?.[0].workers[0].workerId).toBe(1);
+    expect(parsed.workerPools?.[1].summary.totalRss).toBe(512);
+    expect(parsed.workerPools?.[1].workers[0].pid).toBe(5678);
+  });
 });