tci-client-node 0.2.0 → 0.3.0

package/dist/dialect/index.d.ts

@@ -1,5 +1,5 @@
-import { d as TciDialect, T as TciDialectId, f as TciDialectDetectionContext, b as TciDialectSelection, e as TciDialectDetection, i as TciProtocolIdentity } from '../types-9seY9Th-.js';
-export { B as BuiltInTciDialectId, g as TciDialectScore, h as TciDriveState, a as TciHandshakeResult, j as TciStreamLengthSemantics, c as TciWriteResult } from '../types-9seY9Th-.js';
+import { d as TciDialect, a as TciDialectId, f as TciDialectDetectionContext, c as TciDialectSelection, e as TciDialectDetection, i as TciProtocolIdentity } from '../types-BtPh4Dbd.js';
+export { B as BuiltInTciDialectId, g as TciDialectScore, h as TciDriveState, b as TciHandshakeResult, j as TciStreamLengthSemantics, T as TciWriteResult } from '../types-BtPh4Dbd.js';
 import { T as TciCommand } from '../text-BwCWY1k1.js';
 
 type VersionTuple = readonly number[];

package/dist/dialect/index.js

@@ -5,6 +5,8 @@ var StandardTciDialect = class {
   streamLengthSemantics;
   supportsStreamChannels;
   supportsTxAudioSource;
+  supportsIqStream;
+  iqSampleRates;
   driveHasTrx;
   detector;
   resolver;
@@ -14,6 +16,8 @@ var StandardTciDialect = class {
     this.streamLengthSemantics = options.streamLengthSemantics;
     this.supportsStreamChannels = options.supportsStreamChannels;
     this.supportsTxAudioSource = options.supportsTxAudioSource;
+    this.supportsIqStream = options.supportsIqStream;
+    this.iqSampleRates = [...options.iqSampleRates];
     this.driveHasTrx = options.driveHasTrx;
     this.detector = options.detect;
     this.resolver = options.resolve;
@@ -61,6 +65,8 @@ var expertSdr14Dialect = new StandardTciDialect({
   streamLengthSemantics: "per-channel",
   supportsStreamChannels: false,
   supportsTxAudioSource: false,
+  supportsIqStream: true,
+  iqSampleRates: [48e3, 96e3, 192e3, 384e3],
   driveHasTrx: false,
   detect: (context) => {
     const parsed = version(context);
@@ -74,6 +80,8 @@ var expertSdrLegacyDialect = new StandardTciDialect({
   streamLengthSemantics: "per-channel",
   supportsStreamChannels: false,
   supportsTxAudioSource: false,
+  supportsIqStream: true,
+  iqSampleRates: [48e3, 96e3, 192e3, 384e3],
   driveHasTrx: true,
   detect: (context) => {
     const parsed = version(context);
@@ -87,6 +95,8 @@ var expertSdrModernDialect = new StandardTciDialect({
   streamLengthSemantics: "scalar",
   supportsStreamChannels: true,
   supportsTxAudioSource: true,
+  supportsIqStream: true,
+  iqSampleRates: [48e3, 96e3, 192e3, 384e3],
   driveHasTrx: true,
   detect: (context) => {
     const parsed = version(context);
@@ -105,6 +115,8 @@ var thetisDialect = new StandardTciDialect({
   streamLengthSemantics: "scalar",
   supportsStreamChannels: true,
   supportsTxAudioSource: true,
+  supportsIqStream: true,
+  iqSampleRates: [48e3, 96e3, 192e3, 384e3],
   driveHasTrx: true,
   detect: (context) => {
     const evidence = [];
@@ -131,6 +143,8 @@ var aetherSdrDialect = new StandardTciDialect({
   streamLengthSemantics: "scalar",
   supportsStreamChannels: true,
   supportsTxAudioSource: true,
+  supportsIqStream: true,
+  iqSampleRates: [24e3, 48e3, 96e3, 192e3],
   driveHasTrx: true,
   detect: (context) => {
     if (!/^aethersdr$/i.test(context.identity.device ?? "")) return { score: 0, evidence: [] };
@@ -150,6 +164,8 @@ var genericObservedDialect = new StandardTciDialect({
   streamLengthSemantics: "auto",
   supportsStreamChannels: true,
   supportsTxAudioSource: true,
+  supportsIqStream: false,
+  iqSampleRates: [],
   driveHasTrx: true,
   detect: (context) => ({
     score: context.commandNames.has("ready") ? 10 : 0,
@@ -165,6 +181,8 @@ var genericObservedDialect = new StandardTciDialect({
       streamLengthSemantics: "auto",
       supportsStreamChannels: context.commandNames.has("audio_stream_channels"),
       supportsTxAudioSource: compareTciVersion(version(context) ?? [0], [2, 0]) >= 0,
+      supportsIqStream: context.commandNames.has("iq_samplerate"),
+      iqSampleRates: context.commandNames.has("iq_samplerate") ? [48e3] : [],
       driveHasTrx,
       detect: genericObservedDialect.detect.bind(genericObservedDialect)
     });

package/dist/dialect/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/dialect/builtins.ts","../../src/errors.ts","../../src/dialect/registry.ts","../../src/dialect/handshake.ts"],"sourcesContent":["import type {\n  TciDialect,\n  TciDialectDetectionContext,\n  TciDialectScore,\n  TciDriveState,\n  TciStreamLengthSemantics,\n} from './types.js';\n\ntype VersionTuple = readonly number[];\n\ninterface StandardDialectOptions {\n  id: TciDialect['id'];\n  label: string;\n  streamLengthSemantics: TciStreamLengthSemantics;\n  supportsStreamChannels: boolean;\n  supportsTxAudioSource: boolean;\n  driveHasTrx: boolean;\n  detect: (context: TciDialectDetectionContext) => TciDialectScore;\n  resolve?: (context: TciDialectDetectionContext) => TciDialect;\n}\n\nclass StandardTciDialect implements TciDialect {\n  readonly id: TciDialect['id'];\n  readonly label: string;\n  readonly streamLengthSemantics: TciStreamLengthSemantics;\n  readonly supportsStreamChannels: boolean;\n  readonly supportsTxAudioSource: boolean;\n  private readonly driveHasTrx: boolean;\n  private readonly detector: StandardDialectOptions['detect'];\n  private readonly resolver?: StandardDialectOptions['resolve'];\n\n  constructor(options: StandardDialectOptions) {\n    this.id = options.id;\n    this.label = options.label;\n    this.streamLengthSemantics = options.streamLengthSemantics;\n    this.supportsStreamChannels = options.supportsStreamChannels;\n    this.supportsTxAudioSource = options.supportsTxAudioSource;\n    this.driveHasTrx = options.driveHasTrx;\n    this.detector = options.detect;\n    this.resolver = options.resolve;\n  }\n\n  detect(context: TciDialectDetectionContext): TciDialectScore {\n    return this.detector(context);\n  }\n\n  resolve(context: TciDialectDetectionContext): TciDialect {\n    return this.resolver?.(context) ?? this;\n  }\n\n  buildDriveSetArgs(trx: number, value: number): readonly unknown[] {\n    return this.driveHasTrx ? [trx, value] : [value];\n  }\n\n  buildDriveReadArgs(trx: number): readonly unknown[] {\n    return this.driveHasTrx ? [trx] : [];\n  }\n\n  parseDrive(args: readonly string[], defaultTrx: number): TciDriveState | undefined {\n    return parseDriveState(args, defaultTrx, this.driveHasTrx);\n  }\n\n  buildTuneDriveSetArgs(trx: number, value: number): readonly unknown[] {\n    return this.driveHasTrx ? [trx, value] : [value];\n  }\n\n  buildTuneDriveReadArgs(trx: number): readonly unknown[] {\n    return this.driveHasTrx ? [trx] : [];\n  }\n\n  parseTuneDrive(args: readonly string[], defaultTrx: number): TciDriveState | undefined {\n    return parseDriveState(args, defaultTrx, this.driveHasTrx);\n  }\n}\n\nfunction parseDriveState(args: readonly string[], defaultTrx: number, hasTrx: boolean): TciDriveState | undefined {\n  const trx = hasTrx ? Number(args[0]) : defaultTrx;\n  const value = Number(args[hasTrx ? 1 : 0]);\n  if (!Number.isInteger(trx) || !Number.isFinite(value)) return undefined;\n  return { trx, value };\n}\n\nfunction version(context: TciDialectDetectionContext): VersionTuple | undefined {\n  return parseTciVersion(context.identity.protocolVersion);\n}\n\nfunction programIncludes(context: TciDialectDetectionContext, value: string): boolean {\n  return context.identity.programName?.toLowerCase().includes(value) ?? false;\n}\n\nexport const expertSdr14Dialect: TciDialect = new StandardTciDialect({\n  id: 'expertsdr-1.4', label: 'ExpertSDR / TCI 1.4', streamLengthSemantics: 'per-channel',\n  supportsStreamChannels: false, supportsTxAudioSource: false, driveHasTrx: false,\n  detect: (context) => {\n    const parsed = version(context);\n    if (!parsed || compareTciVersion(parsed, [1, 4]) > 0) return { score: 0, evidence: [] };\n    return { score: 80 + (programIncludes(context, 'expert') ? 10 : 0), evidence: [`protocol ${formatVersion(parsed)} <= 1.4`] };\n  },\n});\n\nexport const expertSdrLegacyDialect: TciDialect = new StandardTciDialect({\n  id: 'expertsdr-1.5-1.8', label: 'ExpertSDR / TCI 1.5-1.8', streamLengthSemantics: 'per-channel',\n  supportsStreamChannels: false, supportsTxAudioSource: false, driveHasTrx: true,\n  detect: (context) => {\n    const parsed = version(context);\n    if (!parsed || compareTciVersion(parsed, [1, 5]) < 0 || compareTciVersion(parsed, [1, 9]) >= 0) return { score: 0, evidence: [] };\n    return { score: 80 + (programIncludes(context, 'expert') ? 10 : 0), evidence: [`protocol ${formatVersion(parsed)} is in 1.5-1.8`] };\n  },\n});\n\nexport const expertSdrModernDialect: TciDialect = new StandardTciDialect({\n  id: 'expertsdr-1.9-2.0', label: 'ExpertSDR / TCI 1.9-2.0', streamLengthSemantics: 'scalar',\n  supportsStreamChannels: true, supportsTxAudioSource: true, driveHasTrx: true,\n  detect: (context) => {\n    const parsed = version(context);\n    if (!parsed || compareTciVersion(parsed, [1, 9]) < 0) return { score: 0, evidence: [] };\n    const future = compareTciVersion(parsed, [2, 0]) > 0;\n    return {\n      score: 70 + (programIncludes(context, 'expert') ? 15 : 0),\n      evidence: [`protocol ${formatVersion(parsed)} uses modern stream negotiation`],\n      warnings: future ? [`Unknown future TCI version ${formatVersion(parsed)}; using the modern dialect`] : [],\n    };\n  },\n});\n\nexport const thetisDialect: TciDialect = new StandardTciDialect({\n  id: 'thetis-2.0', label: 'Thetis / TCI 2.0', streamLengthSemantics: 'scalar',\n  supportsStreamChannels: true, supportsTxAudioSource: true, driveHasTrx: true,\n  detect: (context) => {\n    const evidence: string[] = [];\n    let score = 0;\n    if (programIncludes(context, 'thetis')) { score += 120; evidence.push('PROTOCOL program is Thetis'); }\n    const observed = ['tx_frequency_ex', 'tx_profiles_ex', 'tx_profile_ex', 'calibration_ex']\n      .filter((name) => context.commandNames.has(name));\n    if (observed.length > 0) { score += 100; evidence.push(`Thetis extension commands: ${observed.join(', ')}`); }\n    if (/anan|hermes|orion|saturn/i.test(context.identity.device ?? '')) {\n      score += 30;\n      evidence.push(`Thetis-family device: ${context.identity.device}`);\n    }\n    return { score, evidence };\n  },\n});\n\nexport const aetherSdrDialect: TciDialect = new StandardTciDialect({\n  id: 'aethersdr-1.5', label: 'AetherSDR / TCI 1.5 hybrid', streamLengthSemantics: 'scalar',\n  supportsStreamChannels: true, supportsTxAudioSource: true, driveHasTrx: true,\n  detect: (context) => {\n    if (!/^aethersdr$/i.test(context.identity.device ?? '')) return { score: 0, evidence: [] };\n    const evidence = [`AetherSDR device identity: ${context.identity.device}`];\n    const modernAudioCommands = ['audio_stream_sample_type', 'audio_stream_channels', 'audio_stream_samples']\n      .filter((name) => context.commandNames.has(name));\n    if (modernAudioCommands.length > 0) evidence.push(`Modern audio negotiation: ${modernAudioCommands.join(', ')}`);\n    return {\n      score: 150,\n      evidence,\n      warnings: context.identity.protocolVersion === '1.5'\n        ? ['AetherSDR reports TCI 1.5 but uses modern scalar audio stream semantics']\n        : [],\n    };\n  },\n});\n\nexport const genericObservedDialect: TciDialect = new StandardTciDialect({\n  id: 'generic-observed', label: 'Generic observed TCI', streamLengthSemantics: 'auto',\n  supportsStreamChannels: true, supportsTxAudioSource: true, driveHasTrx: true,\n  detect: (context) => ({\n    score: context.commandNames.has('ready') ? 10 : 0,\n    evidence: ['No vendor-specific match; using observed command shapes'],\n    warnings: ['Dialect identity is uncertain'],\n  }),\n  resolve: (context) => {\n    const drive = [...context.commands].reverse().find((command) => command.name === 'drive');\n    const driveHasTrx = (drive?.args.length ?? 0) >= 2;\n    return new StandardTciDialect({\n      id: 'generic-observed',\n      label: 'Generic observed TCI',\n      streamLengthSemantics: 'auto',\n      supportsStreamChannels: context.commandNames.has('audio_stream_channels'),\n      supportsTxAudioSource: compareTciVersion(version(context) ?? [0], [2, 0]) >= 0,\n      driveHasTrx,\n      detect: genericObservedDialect.detect.bind(genericObservedDialect),\n    });\n  },\n});\n\nexport const builtInDialects: readonly TciDialect[] = [\n  aetherSdrDialect, thetisDialect, expertSdr14Dialect, expertSdrLegacyDialect, expertSdrModernDialect, genericObservedDialect,\n];\n\nexport function parseTciVersion(value: string | undefined): VersionTuple | undefined {\n  if (!value) return undefined;\n  const match = value.trim().match(/^(\\d+)(?:\\.(\\d+))?(?:\\.(\\d+))?/);\n  if (!match) return undefined;\n  return match.slice(1).filter((part): part is string => part !== undefined).map(Number);\n}\n\nexport function compareTciVersion(left: VersionTuple, right: VersionTuple): number {\n  const length = Math.max(left.length, right.length);\n  for (let index = 0; index < length; index += 1) {\n    const difference = (left[index] ?? 0) - (right[index] ?? 0);\n    if (difference !== 0) return difference;\n  }\n  return 0;\n}\n\nfunction formatVersion(value: VersionTuple): string { return value.join('.'); }\n","export type TciErrorCode =\n  | 'connect-timeout'\n  | 'handshake-timeout'\n  | 'invalid-handshake'\n  | 'unknown-dialect'\n  | 'command-timeout'\n  | 'not-connected'\n  | 'disconnected'\n  | 'protocol-error'\n  | 'invalid-frame'\n  | 'cancelled';\n\nexport class TciError extends Error {\n  readonly code: TciErrorCode;\n  readonly details?: unknown;\n\n  constructor(code: TciErrorCode, message: string, details?: unknown) {\n    super(message);\n    this.name = 'TciError';\n    this.code = code;\n    this.details = details;\n  }\n}\n\nexport function toTciError(error: unknown, fallbackCode: TciErrorCode = 'protocol-error'): TciError {\n  if (error instanceof TciError) {\n    return error;\n  }\n  if (error instanceof Error) {\n    return new TciError(fallbackCode, error.message, error);\n  }\n  return new TciError(fallbackCode, String(error), error);\n}\n","import { TciError } from '../errors.js';\nimport { builtInDialects } from './builtins.js';\nimport type {\n  TciDialect,\n  TciDialectDetection,\n  TciDialectDetectionContext,\n  TciDialectId,\n  TciDialectSelection,\n} from './types.js';\n\nexport class TciDialectRegistry {\n  private readonly dialects = new Map<TciDialectId, TciDialect>();\n\n  constructor(dialects: readonly TciDialect[] = builtInDialects) {\n    for (const dialect of dialects) this.register(dialect);\n  }\n\n  register(dialect: TciDialect): void { this.dialects.set(dialect.id, dialect); }\n  get(id: TciDialectId): TciDialect | undefined { return this.dialects.get(id); }\n  list(): TciDialect[] { return [...this.dialects.values()]; }\n\n  select(context: TciDialectDetectionContext, selection: TciDialectSelection = 'auto'): TciDialectDetection {\n    if (typeof selection === 'object') {\n      return { dialect: selection, confidence: 'manual', evidence: ['Custom dialect supplied by caller'], warnings: [] };\n    }\n    if (selection !== 'auto') {\n      const dialect = this.get(selection);\n      if (!dialect) throw new TciError('unknown-dialect', `Unknown TCI dialect: ${selection}`);\n      return { dialect: dialect.resolve?.(context) ?? dialect, confidence: 'manual', evidence: [`Dialect ${selection} selected by caller`], warnings: [] };\n    }\n\n    const candidates = this.list()\n      .map((dialect) => ({ dialect, result: dialect.detect(context) }))\n      .sort((left, right) => right.result.score - left.result.score);\n    const selected = candidates[0];\n    if (!selected || selected.result.score <= 0) {\n      throw new TciError('unknown-dialect', 'Unable to identify the TCI server dialect');\n    }\n    return {\n      dialect: selected.dialect.resolve?.(context) ?? selected.dialect,\n      confidence: selected.result.score >= 100 ? 'high' : selected.result.score >= 70 ? 'medium' : 'low',\n      evidence: selected.result.evidence,\n      warnings: selected.result.warnings ?? [],\n    };\n  }\n}\n\nexport const defaultTciDialectRegistry = new TciDialectRegistry();\n","import { TciError } from '../errors.js';\nimport type { TciCommand } from '../protocol/text.js';\nimport type { TciProtocolIdentity } from './types.js';\n\nconst IDENTITY_COMMANDS = new Set(['protocol', 'device', 'trx_count', 'channels_count', 'channel_count']);\nconst STATE_COMMANDS = new Set(['vfo', 'modulation', 'modulations_list', 'trx', 'drive']);\n\nexport function parseProtocolIdentity(commands: readonly TciCommand[]): TciProtocolIdentity {\n  const protocol = [...commands].reverse().find((command) => command.name === 'protocol');\n  const device = [...commands].reverse().find((command) => command.name === 'device');\n  const rawProtocolArgs = protocol?.args ?? [];\n  const firstLooksLikeVersion = /^\\d+(?:\\.\\d+){0,2}/.test(rawProtocolArgs[0] ?? '');\n  return {\n    programName: firstLooksLikeVersion ? undefined : rawProtocolArgs[0],\n    protocolVersion: firstLooksLikeVersion ? rawProtocolArgs[0] : rawProtocolArgs[1],\n    rawProtocolArgs: [...rawProtocolArgs],\n    device: device?.args.join(','),\n  };\n}\n\nexport function assertValidTciHandshake(commands: readonly TciCommand[]): void {\n  const names = new Set(commands.map((command) => command.name));\n  if (!names.has('ready')) throw new TciError('handshake-timeout', 'TCI READY was not received');\n  const categories = [\n    [...IDENTITY_COMMANDS].some((name) => names.has(name)),\n    [...STATE_COMMANDS].some((name) => names.has(name)),\n  ].filter(Boolean).length;\n  const identitySignals = [...IDENTITY_COMMANDS].filter((name) => names.has(name)).length;\n  if (categories < 2 && identitySignals < 2) {\n    throw new TciError('invalid-handshake', 'WebSocket opened but did not provide enough TCI initialization evidence');\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/dialect/builtins.ts","../../src/errors.ts","../../src/dialect/registry.ts","../../src/dialect/handshake.ts"],"sourcesContent":["import type {\n  TciDialect,\n  TciDialectDetectionContext,\n  TciDialectScore,\n  TciDriveState,\n  TciStreamLengthSemantics,\n} from './types.js';\n\ntype VersionTuple = readonly number[];\n\ninterface StandardDialectOptions {\n  id: TciDialect['id'];\n  label: string;\n  streamLengthSemantics: TciStreamLengthSemantics;\n  supportsStreamChannels: boolean;\n  supportsTxAudioSource: boolean;\n  supportsIqStream: boolean;\n  iqSampleRates: readonly number[];\n  driveHasTrx: boolean;\n  detect: (context: TciDialectDetectionContext) => TciDialectScore;\n  resolve?: (context: TciDialectDetectionContext) => TciDialect;\n}\n\nclass StandardTciDialect implements TciDialect {\n  readonly id: TciDialect['id'];\n  readonly label: string;\n  readonly streamLengthSemantics: TciStreamLengthSemantics;\n  readonly supportsStreamChannels: boolean;\n  readonly supportsTxAudioSource: boolean;\n  readonly supportsIqStream: boolean;\n  readonly iqSampleRates: readonly number[];\n  private readonly driveHasTrx: boolean;\n  private readonly detector: StandardDialectOptions['detect'];\n  private readonly resolver?: StandardDialectOptions['resolve'];\n\n  constructor(options: StandardDialectOptions) {\n    this.id = options.id;\n    this.label = options.label;\n    this.streamLengthSemantics = options.streamLengthSemantics;\n    this.supportsStreamChannels = options.supportsStreamChannels;\n    this.supportsTxAudioSource = options.supportsTxAudioSource;\n    this.supportsIqStream = options.supportsIqStream;\n    this.iqSampleRates = [...options.iqSampleRates];\n    this.driveHasTrx = options.driveHasTrx;\n    this.detector = options.detect;\n    this.resolver = options.resolve;\n  }\n\n  detect(context: TciDialectDetectionContext): TciDialectScore {\n    return this.detector(context);\n  }\n\n  resolve(context: TciDialectDetectionContext): TciDialect {\n    return this.resolver?.(context) ?? this;\n  }\n\n  buildDriveSetArgs(trx: number, value: number): readonly unknown[] {\n    return this.driveHasTrx ? [trx, value] : [value];\n  }\n\n  buildDriveReadArgs(trx: number): readonly unknown[] {\n    return this.driveHasTrx ? [trx] : [];\n  }\n\n  parseDrive(args: readonly string[], defaultTrx: number): TciDriveState | undefined {\n    return parseDriveState(args, defaultTrx, this.driveHasTrx);\n  }\n\n  buildTuneDriveSetArgs(trx: number, value: number): readonly unknown[] {\n    return this.driveHasTrx ? [trx, value] : [value];\n  }\n\n  buildTuneDriveReadArgs(trx: number): readonly unknown[] {\n    return this.driveHasTrx ? [trx] : [];\n  }\n\n  parseTuneDrive(args: readonly string[], defaultTrx: number): TciDriveState | undefined {\n    return parseDriveState(args, defaultTrx, this.driveHasTrx);\n  }\n}\n\nfunction parseDriveState(args: readonly string[], defaultTrx: number, hasTrx: boolean): TciDriveState | undefined {\n  const trx = hasTrx ? Number(args[0]) : defaultTrx;\n  const value = Number(args[hasTrx ? 1 : 0]);\n  if (!Number.isInteger(trx) || !Number.isFinite(value)) return undefined;\n  return { trx, value };\n}\n\nfunction version(context: TciDialectDetectionContext): VersionTuple | undefined {\n  return parseTciVersion(context.identity.protocolVersion);\n}\n\nfunction programIncludes(context: TciDialectDetectionContext, value: string): boolean {\n  return context.identity.programName?.toLowerCase().includes(value) ?? false;\n}\n\nexport const expertSdr14Dialect: TciDialect = new StandardTciDialect({\n  id: 'expertsdr-1.4', label: 'ExpertSDR / TCI 1.4', streamLengthSemantics: 'per-channel',\n  supportsStreamChannels: false, supportsTxAudioSource: false, supportsIqStream: true,\n  iqSampleRates: [48_000, 96_000, 192_000, 384_000], driveHasTrx: false,\n  detect: (context) => {\n    const parsed = version(context);\n    if (!parsed || compareTciVersion(parsed, [1, 4]) > 0) return { score: 0, evidence: [] };\n    return { score: 80 + (programIncludes(context, 'expert') ? 10 : 0), evidence: [`protocol ${formatVersion(parsed)} <= 1.4`] };\n  },\n});\n\nexport const expertSdrLegacyDialect: TciDialect = new StandardTciDialect({\n  id: 'expertsdr-1.5-1.8', label: 'ExpertSDR / TCI 1.5-1.8', streamLengthSemantics: 'per-channel',\n  supportsStreamChannels: false, supportsTxAudioSource: false, supportsIqStream: true,\n  iqSampleRates: [48_000, 96_000, 192_000, 384_000], driveHasTrx: true,\n  detect: (context) => {\n    const parsed = version(context);\n    if (!parsed || compareTciVersion(parsed, [1, 5]) < 0 || compareTciVersion(parsed, [1, 9]) >= 0) return { score: 0, evidence: [] };\n    return { score: 80 + (programIncludes(context, 'expert') ? 10 : 0), evidence: [`protocol ${formatVersion(parsed)} is in 1.5-1.8`] };\n  },\n});\n\nexport const expertSdrModernDialect: TciDialect = new StandardTciDialect({\n  id: 'expertsdr-1.9-2.0', label: 'ExpertSDR / TCI 1.9-2.0', streamLengthSemantics: 'scalar',\n  supportsStreamChannels: true, supportsTxAudioSource: true, supportsIqStream: true,\n  iqSampleRates: [48_000, 96_000, 192_000, 384_000], driveHasTrx: true,\n  detect: (context) => {\n    const parsed = version(context);\n    if (!parsed || compareTciVersion(parsed, [1, 9]) < 0) return { score: 0, evidence: [] };\n    const future = compareTciVersion(parsed, [2, 0]) > 0;\n    return {\n      score: 70 + (programIncludes(context, 'expert') ? 15 : 0),\n      evidence: [`protocol ${formatVersion(parsed)} uses modern stream negotiation`],\n      warnings: future ? [`Unknown future TCI version ${formatVersion(parsed)}; using the modern dialect`] : [],\n    };\n  },\n});\n\nexport const thetisDialect: TciDialect = new StandardTciDialect({\n  id: 'thetis-2.0', label: 'Thetis / TCI 2.0', streamLengthSemantics: 'scalar',\n  supportsStreamChannels: true, supportsTxAudioSource: true, supportsIqStream: true,\n  iqSampleRates: [48_000, 96_000, 192_000, 384_000], driveHasTrx: true,\n  detect: (context) => {\n    const evidence: string[] = [];\n    let score = 0;\n    if (programIncludes(context, 'thetis')) { score += 120; evidence.push('PROTOCOL program is Thetis'); }\n    const observed = ['tx_frequency_ex', 'tx_profiles_ex', 'tx_profile_ex', 'calibration_ex']\n      .filter((name) => context.commandNames.has(name));\n    if (observed.length > 0) { score += 100; evidence.push(`Thetis extension commands: ${observed.join(', ')}`); }\n    if (/anan|hermes|orion|saturn/i.test(context.identity.device ?? '')) {\n      score += 30;\n      evidence.push(`Thetis-family device: ${context.identity.device}`);\n    }\n    return { score, evidence };\n  },\n});\n\nexport const aetherSdrDialect: TciDialect = new StandardTciDialect({\n  id: 'aethersdr-1.5', label: 'AetherSDR / TCI 1.5 hybrid', streamLengthSemantics: 'scalar',\n  supportsStreamChannels: true, supportsTxAudioSource: true, supportsIqStream: true,\n  iqSampleRates: [24_000, 48_000, 96_000, 192_000], driveHasTrx: true,\n  detect: (context) => {\n    if (!/^aethersdr$/i.test(context.identity.device ?? '')) return { score: 0, evidence: [] };\n    const evidence = [`AetherSDR device identity: ${context.identity.device}`];\n    const modernAudioCommands = ['audio_stream_sample_type', 'audio_stream_channels', 'audio_stream_samples']\n      .filter((name) => context.commandNames.has(name));\n    if (modernAudioCommands.length > 0) evidence.push(`Modern audio negotiation: ${modernAudioCommands.join(', ')}`);\n    return {\n      score: 150,\n      evidence,\n      warnings: context.identity.protocolVersion === '1.5'\n        ? ['AetherSDR reports TCI 1.5 but uses modern scalar audio stream semantics']\n        : [],\n    };\n  },\n});\n\nexport const genericObservedDialect: TciDialect = new StandardTciDialect({\n  id: 'generic-observed', label: 'Generic observed TCI', streamLengthSemantics: 'auto',\n  supportsStreamChannels: true, supportsTxAudioSource: true, supportsIqStream: false,\n  iqSampleRates: [], driveHasTrx: true,\n  detect: (context) => ({\n    score: context.commandNames.has('ready') ? 10 : 0,\n    evidence: ['No vendor-specific match; using observed command shapes'],\n    warnings: ['Dialect identity is uncertain'],\n  }),\n  resolve: (context) => {\n    const drive = [...context.commands].reverse().find((command) => command.name === 'drive');\n    const driveHasTrx = (drive?.args.length ?? 0) >= 2;\n    return new StandardTciDialect({\n      id: 'generic-observed',\n      label: 'Generic observed TCI',\n      streamLengthSemantics: 'auto',\n      supportsStreamChannels: context.commandNames.has('audio_stream_channels'),\n      supportsTxAudioSource: compareTciVersion(version(context) ?? [0], [2, 0]) >= 0,\n      supportsIqStream: context.commandNames.has('iq_samplerate'),\n      iqSampleRates: context.commandNames.has('iq_samplerate') ? [48_000] : [],\n      driveHasTrx,\n      detect: genericObservedDialect.detect.bind(genericObservedDialect),\n    });\n  },\n});\n\nexport const builtInDialects: readonly TciDialect[] = [\n  aetherSdrDialect, thetisDialect, expertSdr14Dialect, expertSdrLegacyDialect, expertSdrModernDialect, genericObservedDialect,\n];\n\nexport function parseTciVersion(value: string | undefined): VersionTuple | undefined {\n  if (!value) return undefined;\n  const match = value.trim().match(/^(\\d+)(?:\\.(\\d+))?(?:\\.(\\d+))?/);\n  if (!match) return undefined;\n  return match.slice(1).filter((part): part is string => part !== undefined).map(Number);\n}\n\nexport function compareTciVersion(left: VersionTuple, right: VersionTuple): number {\n  const length = Math.max(left.length, right.length);\n  for (let index = 0; index < length; index += 1) {\n    const difference = (left[index] ?? 0) - (right[index] ?? 0);\n    if (difference !== 0) return difference;\n  }\n  return 0;\n}\n\nfunction formatVersion(value: VersionTuple): string { return value.join('.'); }\n","export type TciErrorCode =\n  | 'connect-timeout'\n  | 'handshake-timeout'\n  | 'invalid-handshake'\n  | 'unknown-dialect'\n  | 'command-timeout'\n  | 'not-connected'\n  | 'disconnected'\n  | 'protocol-error'\n  | 'invalid-frame'\n  | 'cancelled';\n\nexport class TciError extends Error {\n  readonly code: TciErrorCode;\n  readonly details?: unknown;\n\n  constructor(code: TciErrorCode, message: string, details?: unknown) {\n    super(message);\n    this.name = 'TciError';\n    this.code = code;\n    this.details = details;\n  }\n}\n\nexport function toTciError(error: unknown, fallbackCode: TciErrorCode = 'protocol-error'): TciError {\n  if (error instanceof TciError) {\n    return error;\n  }\n  if (error instanceof Error) {\n    return new TciError(fallbackCode, error.message, error);\n  }\n  return new TciError(fallbackCode, String(error), error);\n}\n","import { TciError } from '../errors.js';\nimport { builtInDialects } from './builtins.js';\nimport type {\n  TciDialect,\n  TciDialectDetection,\n  TciDialectDetectionContext,\n  TciDialectId,\n  TciDialectSelection,\n} from './types.js';\n\nexport class TciDialectRegistry {\n  private readonly dialects = new Map<TciDialectId, TciDialect>();\n\n  constructor(dialects: readonly TciDialect[] = builtInDialects) {\n    for (const dialect of dialects) this.register(dialect);\n  }\n\n  register(dialect: TciDialect): void { this.dialects.set(dialect.id, dialect); }\n  get(id: TciDialectId): TciDialect | undefined { return this.dialects.get(id); }\n  list(): TciDialect[] { return [...this.dialects.values()]; }\n\n  select(context: TciDialectDetectionContext, selection: TciDialectSelection = 'auto'): TciDialectDetection {\n    if (typeof selection === 'object') {\n      return { dialect: selection, confidence: 'manual', evidence: ['Custom dialect supplied by caller'], warnings: [] };\n    }\n    if (selection !== 'auto') {\n      const dialect = this.get(selection);\n      if (!dialect) throw new TciError('unknown-dialect', `Unknown TCI dialect: ${selection}`);\n      return { dialect: dialect.resolve?.(context) ?? dialect, confidence: 'manual', evidence: [`Dialect ${selection} selected by caller`], warnings: [] };\n    }\n\n    const candidates = this.list()\n      .map((dialect) => ({ dialect, result: dialect.detect(context) }))\n      .sort((left, right) => right.result.score - left.result.score);\n    const selected = candidates[0];\n    if (!selected || selected.result.score <= 0) {\n      throw new TciError('unknown-dialect', 'Unable to identify the TCI server dialect');\n    }\n    return {\n      dialect: selected.dialect.resolve?.(context) ?? selected.dialect,\n      confidence: selected.result.score >= 100 ? 'high' : selected.result.score >= 70 ? 'medium' : 'low',\n      evidence: selected.result.evidence,\n      warnings: selected.result.warnings ?? [],\n    };\n  }\n}\n\nexport const defaultTciDialectRegistry = new TciDialectRegistry();\n","import { TciError } from '../errors.js';\nimport type { TciCommand } from '../protocol/text.js';\nimport type { TciProtocolIdentity } from './types.js';\n\nconst IDENTITY_COMMANDS = new Set(['protocol', 'device', 'trx_count', 'channels_count', 'channel_count']);\nconst STATE_COMMANDS = new Set(['vfo', 'modulation', 'modulations_list', 'trx', 'drive']);\n\nexport function parseProtocolIdentity(commands: readonly TciCommand[]): TciProtocolIdentity {\n  const protocol = [...commands].reverse().find((command) => command.name === 'protocol');\n  const device = [...commands].reverse().find((command) => command.name === 'device');\n  const rawProtocolArgs = protocol?.args ?? [];\n  const firstLooksLikeVersion = /^\\d+(?:\\.\\d+){0,2}/.test(rawProtocolArgs[0] ?? '');\n  return {\n    programName: firstLooksLikeVersion ? undefined : rawProtocolArgs[0],\n    protocolVersion: firstLooksLikeVersion ? rawProtocolArgs[0] : rawProtocolArgs[1],\n    rawProtocolArgs: [...rawProtocolArgs],\n    device: device?.args.join(','),\n  };\n}\n\nexport function assertValidTciHandshake(commands: readonly TciCommand[]): void {\n  const names = new Set(commands.map((command) => command.name));\n  if (!names.has('ready')) throw new TciError('handshake-timeout', 'TCI READY was not received');\n  const categories = [\n    [...IDENTITY_COMMANDS].some((name) => names.has(name)),\n    [...STATE_COMMANDS].some((name) => names.has(name)),\n  ].filter(Boolean).length;\n  const identitySignals = [...IDENTITY_COMMANDS].filter((name) => names.has(name)).length;\n  if (categories < 2 && identitySignals < 2) {\n    throw new TciError('invalid-handshake', 'WebSocket opened but did not provide enough TCI initialization evidence');\n  }\n}\n"],"mappings":";AAuBA,IAAM,qBAAN,MAA+C;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACQ;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,SAAiC;AAC3C,SAAK,KAAK,QAAQ;AAClB,SAAK,QAAQ,QAAQ;AACrB,SAAK,wBAAwB,QAAQ;AACrC,SAAK,yBAAyB,QAAQ;AACtC,SAAK,wBAAwB,QAAQ;AACrC,SAAK,mBAAmB,QAAQ;AAChC,SAAK,gBAAgB,CAAC,GAAG,QAAQ,aAAa;AAC9C,SAAK,cAAc,QAAQ;AAC3B,SAAK,WAAW,QAAQ;AACxB,SAAK,WAAW,QAAQ;AAAA,EAC1B;AAAA,EAEA,OAAO,SAAsD;AAC3D,WAAO,KAAK,SAAS,OAAO;AAAA,EAC9B;AAAA,EAEA,QAAQ,SAAiD;AACvD,WAAO,KAAK,WAAW,OAAO,KAAK;AAAA,EACrC;AAAA,EAEA,kBAAkB,KAAa,OAAmC;AAChE,WAAO,KAAK,cAAc,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK;AAAA,EACjD;AAAA,EAEA,mBAAmB,KAAiC;AAClD,WAAO,KAAK,cAAc,CAAC,GAAG,IAAI,CAAC;AAAA,EACrC;AAAA,EAEA,WAAW,MAAyB,YAA+C;AACjF,WAAO,gBAAgB,MAAM,YAAY,KAAK,WAAW;AAAA,EAC3D;AAAA,EAEA,sBAAsB,KAAa,OAAmC;AACpE,WAAO,KAAK,cAAc,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK;AAAA,EACjD;AAAA,EAEA,uBAAuB,KAAiC;AACtD,WAAO,KAAK,cAAc,CAAC,GAAG,IAAI,CAAC;AAAA,EACrC;AAAA,EAEA,eAAe,MAAyB,YAA+C;AACrF,WAAO,gBAAgB,MAAM,YAAY,KAAK,WAAW;AAAA,EAC3D;AACF;AAEA,SAAS,gBAAgB,MAAyB,YAAoB,QAA4C;AAChH,QAAM,MAAM,SAAS,OAAO,KAAK,CAAC,CAAC,IAAI;AACvC,QAAM,QAAQ,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC;AACzC,MAAI,CAAC,OAAO,UAAU,GAAG,KAAK,CAAC,OAAO,SAAS,KAAK,EAAG,QAAO;AAC9D,SAAO,EAAE,KAAK,MAAM;AACtB;AAEA,SAAS,QAAQ,SAA+D;AAC9E,SAAO,gBAAgB,QAAQ,SAAS,eAAe;AACzD;AAEA,SAAS,gBAAgB,SAAqC,OAAwB;AACpF,SAAO,QAAQ,SAAS,aAAa,YAAY,EAAE,SAAS,KAAK,KAAK;AACxE;AAEO,IAAM,qBAAiC,IAAI,mBAAmB;AAAA,EACnE,IAAI;AAAA,EAAiB,OAAO;AAAA,EAAuB,uBAAuB;AAAA,EAC1E,wBAAwB;AAAA,EAAO,uBAAuB;AAAA,EAAO,kBAAkB;AAAA,EAC/E,eAAe,CAAC,MAAQ,MAAQ,OAAS,KAAO;AAAA,EAAG,aAAa;AAAA,EAChE,QAAQ,CAAC,YAAY;AACnB,UAAM,SAAS,QAAQ,OAAO;AAC9B,QAAI,CAAC,UAAU,kBAAkB,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAG,QAAO,EAAE,OAAO,GAAG,UAAU,CAAC,EAAE;AACtF,WAAO,EAAE,OAAO,MAAM,gBAAgB,SAAS,QAAQ,IAAI,KAAK,IAAI,UAAU,CAAC,YAAY,cAAc,MAAM,CAAC,SAAS,EAAE;AAAA,EAC7H;AACF,CAAC;AAEM,IAAM,yBAAqC,IAAI,mBAAmB;AAAA,EACvE,IAAI;AAAA,EAAqB,OAAO;AAAA,EAA2B,uBAAuB;AAAA,EAClF,wBAAwB;AAAA,EAAO,uBAAuB;AAAA,EAAO,kBAAkB;AAAA,EAC/E,eAAe,CAAC,MAAQ,MAAQ,OAAS,KAAO;AAAA,EAAG,aAAa;AAAA,EAChE,QAAQ,CAAC,YAAY;AACnB,UAAM,SAAS,QAAQ,OAAO;AAC9B,QAAI,CAAC,UAAU,kBAAkB,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,kBAAkB,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAG,QAAO,EAAE,OAAO,GAAG,UAAU,CAAC,EAAE;AAChI,WAAO,EAAE,OAAO,MAAM,gBAAgB,SAAS,QAAQ,IAAI,KAAK,IAAI,UAAU,CAAC,YAAY,cAAc,MAAM,CAAC,gBAAgB,EAAE;AAAA,EACpI;AACF,CAAC;AAEM,IAAM,yBAAqC,IAAI,mBAAmB;AAAA,EACvE,IAAI;AAAA,EAAqB,OAAO;AAAA,EAA2B,uBAAuB;AAAA,EAClF,wBAAwB;AAAA,EAAM,uBAAuB;AAAA,EAAM,kBAAkB;AAAA,EAC7E,eAAe,CAAC,MAAQ,MAAQ,OAAS,KAAO;AAAA,EAAG,aAAa;AAAA,EAChE,QAAQ,CAAC,YAAY;AACnB,UAAM,SAAS,QAAQ,OAAO;AAC9B,QAAI,CAAC,UAAU,kBAAkB,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAG,QAAO,EAAE,OAAO,GAAG,UAAU,CAAC,EAAE;AACtF,UAAM,SAAS,kBAAkB,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI;AACnD,WAAO;AAAA,MACL,OAAO,MAAM,gBAAgB,SAAS,QAAQ,IAAI,KAAK;AAAA,MACvD,UAAU,CAAC,YAAY,cAAc,MAAM,CAAC,iCAAiC;AAAA,MAC7E,UAAU,SAAS,CAAC,8BAA8B,cAAc,MAAM,CAAC,4BAA4B,IAAI,CAAC;AAAA,IAC1G;AAAA,EACF;AACF,CAAC;AAEM,IAAM,gBAA4B,IAAI,mBAAmB;AAAA,EAC9D,IAAI;AAAA,EAAc,OAAO;AAAA,EAAoB,uBAAuB;AAAA,EACpE,wBAAwB;AAAA,EAAM,uBAAuB;AAAA,EAAM,kBAAkB;AAAA,EAC7E,eAAe,CAAC,MAAQ,MAAQ,OAAS,KAAO;AAAA,EAAG,aAAa;AAAA,EAChE,QAAQ,CAAC,YAAY;AACnB,UAAM,WAAqB,CAAC;AAC5B,QAAI,QAAQ;AACZ,QAAI,gBAAgB,SAAS,QAAQ,GAAG;AAAE,eAAS;AAAK,eAAS,KAAK,4BAA4B;AAAA,IAAG;AACrG,UAAM,WAAW,CAAC,mBAAmB,kBAAkB,iBAAiB,gBAAgB,EACrF,OAAO,CAAC,SAAS,QAAQ,aAAa,IAAI,IAAI,CAAC;AAClD,QAAI,SAAS,SAAS,GAAG;AAAE,eAAS;AAAK,eAAS,KAAK,8BAA8B,SAAS,KAAK,IAAI,CAAC,EAAE;AAAA,IAAG;AAC7G,QAAI,4BAA4B,KAAK,QAAQ,SAAS,UAAU,EAAE,GAAG;AACnE,eAAS;AACT,eAAS,KAAK,yBAAyB,QAAQ,SAAS,MAAM,EAAE;AAAA,IAClE;AACA,WAAO,EAAE,OAAO,SAAS;AAAA,EAC3B;AACF,CAAC;AAEM,IAAM,mBAA+B,IAAI,mBAAmB;AAAA,EACjE,IAAI;AAAA,EAAiB,OAAO;AAAA,EAA8B,uBAAuB;AAAA,EACjF,wBAAwB;AAAA,EAAM,uBAAuB;AAAA,EAAM,kBAAkB;AAAA,EAC7E,eAAe,CAAC,MAAQ,MAAQ,MAAQ,KAAO;AAAA,EAAG,aAAa;AAAA,EAC/D,QAAQ,CAAC,YAAY;AACnB,QAAI,CAAC,eAAe,KAAK,QAAQ,SAAS,UAAU,EAAE,EAAG,QAAO,EAAE,OAAO,GAAG,UAAU,CAAC,EAAE;AACzF,UAAM,WAAW,CAAC,8BAA8B,QAAQ,SAAS,MAAM,EAAE;AACzE,UAAM,sBAAsB,CAAC,4BAA4B,yBAAyB,sBAAsB,EACrG,OAAO,CAAC,SAAS,QAAQ,aAAa,IAAI,IAAI,CAAC;AAClD,QAAI,oBAAoB,SAAS,EAAG,UAAS,KAAK,6BAA6B,oBAAoB,KAAK,IAAI,CAAC,EAAE;AAC/G,WAAO;AAAA,MACL,OAAO;AAAA,MACP;AAAA,MACA,UAAU,QAAQ,SAAS,oBAAoB,QAC3C,CAAC,yEAAyE,IAC1E,CAAC;AAAA,IACP;AAAA,EACF;AACF,CAAC;AAEM,IAAM,yBAAqC,IAAI,mBAAmB;AAAA,EACvE,IAAI;AAAA,EAAoB,OAAO;AAAA,EAAwB,uBAAuB;AAAA,EAC9E,wBAAwB;AAAA,EAAM,uBAAuB;AAAA,EAAM,kBAAkB;AAAA,EAC7E,eAAe,CAAC;AAAA,EAAG,aAAa;AAAA,EAChC,QAAQ,CAAC,aAAa;AAAA,IACpB,OAAO,QAAQ,aAAa,IAAI,OAAO,IAAI,KAAK;AAAA,IAChD,UAAU,CAAC,yDAAyD;AAAA,IACpE,UAAU,CAAC,+BAA+B;AAAA,EAC5C;AAAA,EACA,SAAS,CAAC,YAAY;AACpB,UAAM,QAAQ,CAAC,GAAG,QAAQ,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,YAAY,QAAQ,SAAS,OAAO;AACxF,UAAM,eAAe,OAAO,KAAK,UAAU,MAAM;AACjD,WAAO,IAAI,mBAAmB;AAAA,MAC5B,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,uBAAuB;AAAA,MACvB,wBAAwB,QAAQ,aAAa,IAAI,uBAAuB;AAAA,MACxE,uBAAuB,kBAAkB,QAAQ,OAAO,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK;AAAA,MAC7E,kBAAkB,QAAQ,aAAa,IAAI,eAAe;AAAA,MAC1D,eAAe,QAAQ,aAAa,IAAI,eAAe,IAAI,CAAC,IAAM,IAAI,CAAC;AAAA,MACvE;AAAA,MACA,QAAQ,uBAAuB,OAAO,KAAK,sBAAsB;AAAA,IACnE,CAAC;AAAA,EACH;AACF,CAAC;AAEM,IAAM,kBAAyC;AAAA,EACpD;AAAA,EAAkB;AAAA,EAAe;AAAA,EAAoB;AAAA,EAAwB;AAAA,EAAwB;AACvG;AAEO,SAAS,gBAAgB,OAAqD;AACnF,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,QAAQ,MAAM,KAAK,EAAE,MAAM,gCAAgC;AACjE,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,MAAM,MAAM,CAAC,EAAE,OAAO,CAAC,SAAyB,SAAS,MAAS,EAAE,IAAI,MAAM;AACvF;AAEO,SAAS,kBAAkB,MAAoB,OAA6B;AACjF,QAAM,SAAS,KAAK,IAAI,KAAK,QAAQ,MAAM,MAAM;AACjD,WAAS,QAAQ,GAAG,QAAQ,QAAQ,SAAS,GAAG;AAC9C,UAAM,cAAc,KAAK,KAAK,KAAK,MAAM,MAAM,KAAK,KAAK;AACzD,QAAI,eAAe,EAAG,QAAO;AAAA,EAC/B;AACA,SAAO;AACT;AAEA,SAAS,cAAc,OAA6B;AAAE,SAAO,MAAM,KAAK,GAAG;AAAG;;;AC/MvE,IAAM,WAAN,cAAuB,MAAM;AAAA,EACzB;AAAA,EACA;AAAA,EAET,YAAY,MAAoB,SAAiB,SAAmB;AAClE,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,UAAU;AAAA,EACjB;AACF;;;ACZO,IAAM,qBAAN,MAAyB;AAAA,EACb,WAAW,oBAAI,IAA8B;AAAA,EAE9D,YAAY,WAAkC,iBAAiB;AAC7D,eAAW,WAAW,SAAU,MAAK,SAAS,OAAO;AAAA,EACvD;AAAA,EAEA,SAAS,SAA2B;AAAE,SAAK,SAAS,IAAI,QAAQ,IAAI,OAAO;AAAA,EAAG;AAAA,EAC9E,IAAI,IAA0C;AAAE,WAAO,KAAK,SAAS,IAAI,EAAE;AAAA,EAAG;AAAA,EAC9E,OAAqB;AAAE,WAAO,CAAC,GAAG,KAAK,SAAS,OAAO,CAAC;AAAA,EAAG;AAAA,EAE3D,OAAO,SAAqC,YAAiC,QAA6B;AACxG,QAAI,OAAO,cAAc,UAAU;AACjC,aAAO,EAAE,SAAS,WAAW,YAAY,UAAU,UAAU,CAAC,mCAAmC,GAAG,UAAU,CAAC,EAAE;AAAA,IACnH;AACA,QAAI,cAAc,QAAQ;AACxB,YAAM,UAAU,KAAK,IAAI,SAAS;AAClC,UAAI,CAAC,QAAS,OAAM,IAAI,SAAS,mBAAmB,wBAAwB,SAAS,EAAE;AACvF,aAAO,EAAE,SAAS,QAAQ,UAAU,OAAO,KAAK,SAAS,YAAY,UAAU,UAAU,CAAC,WAAW,SAAS,qBAAqB,GAAG,UAAU,CAAC,EAAE;AAAA,IACrJ;AAEA,UAAM,aAAa,KAAK,KAAK,EAC1B,IAAI,CAAC,aAAa,EAAE,SAAS,QAAQ,QAAQ,OAAO,OAAO,EAAE,EAAE,EAC/D,KAAK,CAAC,MAAM,UAAU,MAAM,OAAO,QAAQ,KAAK,OAAO,KAAK;AAC/D,UAAM,WAAW,WAAW,CAAC;AAC7B,QAAI,CAAC,YAAY,SAAS,OAAO,SAAS,GAAG;AAC3C,YAAM,IAAI,SAAS,mBAAmB,2CAA2C;AAAA,IACnF;AACA,WAAO;AAAA,MACL,SAAS,SAAS,QAAQ,UAAU,OAAO,KAAK,SAAS;AAAA,MACzD,YAAY,SAAS,OAAO,SAAS,MAAM,SAAS,SAAS,OAAO,SAAS,KAAK,WAAW;AAAA,MAC7F,UAAU,SAAS,OAAO;AAAA,MAC1B,UAAU,SAAS,OAAO,YAAY,CAAC;AAAA,IACzC;AAAA,EACF;AACF;AAEO,IAAM,4BAA4B,IAAI,mBAAmB;;;AC3ChE,IAAM,oBAAoB,oBAAI,IAAI,CAAC,YAAY,UAAU,aAAa,kBAAkB,eAAe,CAAC;AACxG,IAAM,iBAAiB,oBAAI,IAAI,CAAC,OAAO,cAAc,oBAAoB,OAAO,OAAO,CAAC;AAEjF,SAAS,sBAAsB,UAAsD;AAC1F,QAAM,WAAW,CAAC,GAAG,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,YAAY,QAAQ,SAAS,UAAU;AACtF,QAAM,SAAS,CAAC,GAAG,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,YAAY,QAAQ,SAAS,QAAQ;AAClF,QAAM,kBAAkB,UAAU,QAAQ,CAAC;AAC3C,QAAM,wBAAwB,qBAAqB,KAAK,gBAAgB,CAAC,KAAK,EAAE;AAChF,SAAO;AAAA,IACL,aAAa,wBAAwB,SAAY,gBAAgB,CAAC;AAAA,IAClE,iBAAiB,wBAAwB,gBAAgB,CAAC,IAAI,gBAAgB,CAAC;AAAA,IAC/E,iBAAiB,CAAC,GAAG,eAAe;AAAA,IACpC,QAAQ,QAAQ,KAAK,KAAK,GAAG;AAAA,EAC/B;AACF;AAEO,SAAS,wBAAwB,UAAuC;AAC7E,QAAM,QAAQ,IAAI,IAAI,SAAS,IAAI,CAAC,YAAY,QAAQ,IAAI,CAAC;AAC7D,MAAI,CAAC,MAAM,IAAI,OAAO,EAAG,OAAM,IAAI,SAAS,qBAAqB,4BAA4B;AAC7F,QAAM,aAAa;AAAA,IACjB,CAAC,GAAG,iBAAiB,EAAE,KAAK,CAAC,SAAS,MAAM,IAAI,IAAI,CAAC;AAAA,IACrD,CAAC,GAAG,cAAc,EAAE,KAAK,CAAC,SAAS,MAAM,IAAI,IAAI,CAAC;AAAA,EACpD,EAAE,OAAO,OAAO,EAAE;AAClB,QAAM,kBAAkB,CAAC,GAAG,iBAAiB,EAAE,OAAO,CAAC,SAAS,MAAM,IAAI,IAAI,CAAC,EAAE;AACjF,MAAI,aAAa,KAAK,kBAAkB,GAAG;AACzC,UAAM,IAAI,SAAS,qBAAqB,yEAAyE;AAAA,EACnH;AACF;","names":[]}

package/dist/index.cjs

@@ -35,6 +35,7 @@ __export(src_exports, {
   TciCommandQueue: () => TciCommandQueue,
   TciDialectRegistry: () => TciDialectRegistry,
   TciError: () => TciError,
+  TciIqStreamSession: () => TciIqStreamSession,
   TciSampleType: () => TciSampleType,
   TciStreamType: () => TciStreamType,
   WebSocketTciTransport: () => WebSocketTciTransport,
@@ -46,6 +47,7 @@ __export(src_exports, {
   commandKey: () => commandKey,
   compareTciVersion: () => compareTciVersion,
   createTciClient: () => createTciClient,
+  decodeInterleavedIq: () => decodeInterleavedIq,
   defaultTciDialectRegistry: () => defaultTciDialectRegistry,
   deinterleaveChannels: () => deinterleaveChannels,
   escapeTciText: () => escapeTciText,
@@ -319,6 +321,15 @@ function payloadToFloat32(frameOrPayload, sampleType) {
   }
   return output;
 }
+function decodeInterleavedIq(frame) {
+  if (frame.streamType !== 0 /* IQ_STREAM */) {
+    throw new TciError("invalid-frame", "Expected a TCI IQ stream frame");
+  }
+  if (frame.channels !== 2 || frame.sampleCount % 2 !== 0) {
+    throw new TciError("invalid-frame", `TCI IQ frame must contain interleaved I/Q pairs, got ${frame.channels} channels`);
+  }
+  return payloadToFloat32(frame);
+}
 function samplesToPayload(samples, sampleType) {
   const type = normalizeSampleType(sampleType);
   const bytes = sampleTypeBytes(type);
@@ -673,6 +684,8 @@ var StandardTciDialect = class {
   streamLengthSemantics;
   supportsStreamChannels;
   supportsTxAudioSource;
+  supportsIqStream;
+  iqSampleRates;
   driveHasTrx;
   detector;
   resolver;
@@ -682,6 +695,8 @@ var StandardTciDialect = class {
     this.streamLengthSemantics = options.streamLengthSemantics;
     this.supportsStreamChannels = options.supportsStreamChannels;
     this.supportsTxAudioSource = options.supportsTxAudioSource;
+    this.supportsIqStream = options.supportsIqStream;
+    this.iqSampleRates = [...options.iqSampleRates];
     this.driveHasTrx = options.driveHasTrx;
     this.detector = options.detect;
     this.resolver = options.resolve;
@@ -729,6 +744,8 @@ var expertSdr14Dialect = new StandardTciDialect({
   streamLengthSemantics: "per-channel",
   supportsStreamChannels: false,
   supportsTxAudioSource: false,
+  supportsIqStream: true,
+  iqSampleRates: [48e3, 96e3, 192e3, 384e3],
   driveHasTrx: false,
   detect: (context) => {
     const parsed = version(context);
@@ -742,6 +759,8 @@ var expertSdrLegacyDialect = new StandardTciDialect({
   streamLengthSemantics: "per-channel",
   supportsStreamChannels: false,
   supportsTxAudioSource: false,
+  supportsIqStream: true,
+  iqSampleRates: [48e3, 96e3, 192e3, 384e3],
   driveHasTrx: true,
   detect: (context) => {
     const parsed = version(context);
@@ -755,6 +774,8 @@ var expertSdrModernDialect = new StandardTciDialect({
   streamLengthSemantics: "scalar",
   supportsStreamChannels: true,
   supportsTxAudioSource: true,
+  supportsIqStream: true,
+  iqSampleRates: [48e3, 96e3, 192e3, 384e3],
   driveHasTrx: true,
   detect: (context) => {
     const parsed = version(context);
@@ -773,6 +794,8 @@ var thetisDialect = new StandardTciDialect({
   streamLengthSemantics: "scalar",
   supportsStreamChannels: true,
   supportsTxAudioSource: true,
+  supportsIqStream: true,
+  iqSampleRates: [48e3, 96e3, 192e3, 384e3],
   driveHasTrx: true,
   detect: (context) => {
     const evidence = [];
@@ -799,6 +822,8 @@ var aetherSdrDialect = new StandardTciDialect({
   streamLengthSemantics: "scalar",
   supportsStreamChannels: true,
   supportsTxAudioSource: true,
+  supportsIqStream: true,
+  iqSampleRates: [24e3, 48e3, 96e3, 192e3],
   driveHasTrx: true,
   detect: (context) => {
     if (!/^aethersdr$/i.test(context.identity.device ?? "")) return { score: 0, evidence: [] };
@@ -818,6 +843,8 @@ var genericObservedDialect = new StandardTciDialect({
   streamLengthSemantics: "auto",
   supportsStreamChannels: true,
   supportsTxAudioSource: true,
+  supportsIqStream: false,
+  iqSampleRates: [],
   driveHasTrx: true,
   detect: (context) => ({
     score: context.commandNames.has("ready") ? 10 : 0,
@@ -833,6 +860,8 @@ var genericObservedDialect = new StandardTciDialect({
       streamLengthSemantics: "auto",
       supportsStreamChannels: context.commandNames.has("audio_stream_channels"),
       supportsTxAudioSource: compareTciVersion(version(context) ?? [0], [2, 0]) >= 0,
+      supportsIqStream: context.commandNames.has("iq_samplerate"),
+      iqSampleRates: context.commandNames.has("iq_samplerate") ? [48e3] : [],
       driveHasTrx,
       detect: genericObservedDialect.detect.bind(genericObservedDialect)
     });
@@ -1044,6 +1073,77 @@ function dataToBuffer(data) {
 }
 
 // src/client/TciClient.ts
+var TciIqStreamSession = class extends import_eventemitter32.EventEmitter {
+  receiver;
+  _appliedSampleRate;
+  callbacks;
+  closed = false;
+  firstFrame;
+  constructor(receiver, appliedSampleRate, callbacks) {
+    super();
+    this.receiver = receiver;
+    this._appliedSampleRate = appliedSampleRate;
+    this.callbacks = callbacks;
+  }
+  get appliedSampleRate() {
+    return this._appliedSampleRate;
+  }
+  async setSampleRate(sampleRate) {
+    if (this.closed) throw new TciError("cancelled", "TCI IQ stream is closed");
+    const result = await this.callbacks.setSampleRate(sampleRate);
+    this._appliedSampleRate = result.applied;
+    return result;
+  }
+  async close() {
+    if (this.closed) return;
+    this.closed = true;
+    this.rejectFirstFrame(new TciError("cancelled", "TCI IQ stream closed before its first frame"));
+    try {
+      await this.callbacks.close();
+    } finally {
+      this.emit("closed");
+      this.removeAllListeners();
+    }
+  }
+  waitForFirstFrame(timeoutMs) {
+    if (this.firstFrame) return this.firstFrame.promise;
+    let resolvePromise;
+    let rejectPromise;
+    const promise = new Promise((resolve, reject) => {
+      resolvePromise = resolve;
+      rejectPromise = reject;
+    });
+    const timer = setTimeout(() => {
+      this.firstFrame = void 0;
+      rejectPromise(new TciError("command-timeout", `Timed out waiting for TCI IQ frame for receiver ${this.receiver}`));
+    }, timeoutMs);
+    this.firstFrame = { promise, resolve: resolvePromise, reject: rejectPromise, timer };
+    return promise;
+  }
+  _acceptFrame(frame) {
+    if (this.closed || frame.receiver !== this.receiver) return;
+    this._appliedSampleRate = frame.sampleRate;
+    const firstFrame = this.firstFrame;
+    if (firstFrame) {
+      clearTimeout(firstFrame.timer);
+      this.firstFrame = void 0;
+      firstFrame.resolve(frame);
+    }
+    this.emit("frame", frame);
+  }
+  _fail(error) {
+    if (this.closed) return;
+    this.rejectFirstFrame(error);
+    this.emit("error", error);
+  }
+  rejectFirstFrame(error) {
+    const firstFrame = this.firstFrame;
+    if (!firstFrame) return;
+    clearTimeout(firstFrame.timer);
+    this.firstFrame = void 0;
+    firstFrame.reject(error);
+  }
+};
 var TciClient = class extends import_eventemitter32.EventEmitter {
   options;
   WebSocketImpl;
@@ -1058,6 +1158,7 @@ var TciClient = class extends import_eventemitter32.EventEmitter {
   handshakeError;
   initializationCommands = [];
   handshakeWaiter;
+  activeIqSession;
   constructor(options) {
     super();
     this.options = {
@@ -1096,7 +1197,9 @@ var TciClient = class extends import_eventemitter32.EventEmitter {
       split: {},
       dialectWarnings: [],
       rxSensors: {},
-      txSensors: {}
+      txSensors: {},
+      iq: { activeReceivers: {} },
+      dds: {}
     };
     this.stateReducers = this.createStateReducers();
   }
@@ -1135,6 +1238,68 @@ var TciClient = class extends import_eventemitter32.EventEmitter {
   getHandshakeResult() {
     return this.handshakeResult ? cloneHandshake(this.handshakeResult) : void 0;
   }
+  getIqCapabilities() {
+    const dialect = this.requireDialect();
+    return {
+      supported: dialect.supportsIqStream,
+      currentSampleRate: this.state.iq.sampleRate,
+      supportedSampleRates: [...dialect.iqSampleRates]
+    };
+  }
+  async setIqSampleRate(sampleRate, timeoutMs = this.options.commandTimeoutMs) {
+    const capabilities = this.getIqCapabilities();
+    const requested = Math.round(sampleRate);
+    if (!capabilities.supported) throw new TciError("protocol-error", `TCI dialect ${this.requireDialect().id} does not support IQ streaming`);
+    if (!Number.isFinite(requested) || requested <= 0) throw new TciError("protocol-error", `Invalid TCI IQ sample rate: ${sampleRate}`);
+    if (capabilities.supportedSampleRates.length > 0 && !capabilities.supportedSampleRates.includes(requested)) {
+      throw new TciError("protocol-error", `TCI IQ sample rate ${requested} is not supported by dialect ${this.requireDialect().id}`);
+    }
+    if (this.state.iq.sampleRate === requested) return writeResult(requested, requested, "state");
+    const waiter = this.waitForCommand((command) => command.name === "iq_samplerate", timeoutMs, "IQ_SAMPLERATE readback");
+    try {
+      await this.sendCommand("IQ_SAMPLERATE", [requested], { waitForReply: false });
+      const reply = await waiter.promise;
+      const applied = parseNumber(reply.args[0]);
+      if (applied === void 0 || applied <= 0) throw new TciError("protocol-error", `Invalid IQ_SAMPLERATE readback: ${reply.raw}`);
+      return writeResult(requested, applied, "reply");
+    } finally {
+      waiter.cancel();
+    }
+  }
+  async openIqStream(options = {}) {
+    if (this.activeIqSession) throw new TciError("protocol-error", "This TCI client already has an active IQ stream session");
+    const capabilities = this.getIqCapabilities();
+    if (!capabilities.supported) throw new TciError("protocol-error", `TCI dialect ${this.requireDialect().id} does not support IQ streaming`);
+    const receiver = Math.floor(options.receiver ?? this.options.receiver);
+    if (!Number.isInteger(receiver) || receiver < 0) throw new TciError("protocol-error", `Invalid TCI IQ receiver: ${receiver}`);
+    const requestedRate = options.sampleRate ?? capabilities.currentSampleRate ?? capabilities.supportedSampleRates[0] ?? 48e3;
+    const rateResult = await this.setIqSampleRate(requestedRate);
+    let session;
+    session = new TciIqStreamSession(receiver, rateResult.applied, {
+      setSampleRate: (rate) => this.setIqSampleRate(rate),
+      close: async () => {
+        try {
+          if (this.isConnected()) await this.sendCommand("IQ_STOP", [receiver], { waitForReply: false });
+        } finally {
+          this.state.iq.activeReceivers[String(receiver)] = false;
+          if (this.activeIqSession === session) this.activeIqSession = void 0;
+          this.emitState();
+        }
+      }
+    });
+    this.activeIqSession = session;
+    const firstFrame = session.waitForFirstFrame(options.firstFrameTimeoutMs ?? 5e3);
+    try {
+      await this.sendCommand("IQ_START", [receiver], { waitForReply: false });
+      this.state.iq.activeReceivers[String(receiver)] = true;
+      this.emitState();
+      await firstFrame;
+      return session;
+    } catch (error) {
+      await session.close().catch(() => void 0);
+      throw error;
+    }
+  }
   async sendCommand(name, args = [], options = {}) {
     const raw = formatTciCommand(name, args);
     if (options.waitForReply === false) {
@@ -1624,6 +1789,22 @@ var TciClient = class extends import_eventemitter32.EventEmitter {
     this.emit("tci:binary", frame);
     this.emit("binary", frame);
     switch (frame.streamType) {
+      case 0 /* IQ_STREAM */: {
+        if (frame.channels !== 2 || frame.sampleCount % 2 !== 0) {
+          throw new TciError("invalid-frame", "TCI IQ stream frame must contain interleaved I/Q pairs");
+        }
+        this.state.iq.sampleRate = frame.sampleRate;
+        const iqFrame = {
+          frame,
+          receiver: frame.receiver,
+          sampleRate: frame.sampleRate,
+          centerFrequency: this.state.dds[String(frame.receiver)],
+          complexSampleCount: frame.frameCount
+        };
+        this.emit("iqFrame", iqFrame);
+        this.activeIqSession?._acceptFrame(iqFrame);
+        break;
+      }
       case 1 /* RX_AUDIO_STREAM */:
         this.emit("rxAudioFrame", frame);
         break;
@@ -1701,6 +1882,11 @@ var TciClient = class extends import_eventemitter32.EventEmitter {
       this.state.modulations = args.map((mode) => mode.toLowerCase());
     });
     reducers.set("vfo", (args) => this.applyVfo(args));
+    reducers.set("dds", (args) => {
+      const receiver = parseNumber(args[0]);
+      const frequency = parseNumber(args[1]);
+      if (receiver !== void 0 && frequency !== void 0 && frequency >= 0) this.state.dds[String(receiver)] = frequency;
+    });
     reducers.set("modulation", (args) => this.applyModulation(args));
     reducers.set("trx", (args) => this.applyTrx(args));
     reducers.set("tune", (args) => this.applyBooleanByFirstArg(this.state.tune, args));
@@ -1717,6 +1903,15 @@ var TciClient = class extends import_eventemitter32.EventEmitter {
     reducers.set("tx_stream_audio_buffering", (args) => this.updateAudioState({ txBufferingMs: parseNumber(args[0]) }));
     reducers.set("audio_start", () => this.updateAudioState({ running: true }));
     reducers.set("audio_stop", () => this.updateAudioState({ running: false }));
+    reducers.set("iq_samplerate", (args) => {
+      this.state.iq.sampleRate = parseNumber(args[0]);
+    });
+    reducers.set("iq_start", (args) => {
+      this.state.iq.activeReceivers[String(args[0] ?? this.options.receiver)] = true;
+    });
+    reducers.set("iq_stop", (args) => {
+      this.state.iq.activeReceivers[String(args[0] ?? this.options.receiver)] = false;
+    });
     return reducers;
   }
   applyVfo(args) {
@@ -1824,6 +2019,8 @@ var TciClient = class extends import_eventemitter32.EventEmitter {
     this.state.ready = false;
     this.queue.setConnected(false);
     this.rejectHandshake(new TciError("disconnected", "TCI connection closed during handshake", reason));
+    this.activeIqSession?._fail(new TciError("disconnected", "TCI connection closed while IQ stream was active", reason));
+    this.activeIqSession = void 0;
     if (wasConnected) {
       this.emit("disconnected", reason);
       this.emitState();
@@ -1904,7 +2101,9 @@ function cloneState(state) {
     dialectWarnings: [...state.dialectWarnings],
     rxSensors: cloneNested(state.rxSensors),
     txSensors: cloneNested(state.txSensors),
-    audio: state.audio ? { ...state.audio } : void 0
+    audio: state.audio ? { ...state.audio } : void 0,
+    iq: { ...state.iq, activeReceivers: { ...state.iq.activeReceivers } },
+    dds: { ...state.dds }
   };
 }
 function cloneHandshake(result) {
@@ -1929,6 +2128,7 @@ function cloneNested(value) {
   TciCommandQueue,
   TciDialectRegistry,
   TciError,
+  TciIqStreamSession,
   TciSampleType,
   TciStreamType,
   WebSocketTciTransport,
@@ -1940,6 +2140,7 @@ function cloneNested(value) {
   commandKey,
   compareTciVersion,
   createTciClient,
+  decodeInterleavedIq,
   defaultTciDialectRegistry,
   deinterleaveChannels,
   escapeTciText,