tci-client-node 0.1.2 → 0.2.0

package/dist/dialect/index.js

@@ -0,0 +1,292 @@
+// src/dialect/builtins.ts
+var StandardTciDialect = class {
+  id;
+  label;
+  streamLengthSemantics;
+  supportsStreamChannels;
+  supportsTxAudioSource;
+  driveHasTrx;
+  detector;
+  resolver;
+  constructor(options) {
+    this.id = options.id;
+    this.label = options.label;
+    this.streamLengthSemantics = options.streamLengthSemantics;
+    this.supportsStreamChannels = options.supportsStreamChannels;
+    this.supportsTxAudioSource = options.supportsTxAudioSource;
+    this.driveHasTrx = options.driveHasTrx;
+    this.detector = options.detect;
+    this.resolver = options.resolve;
+  }
+  detect(context) {
+    return this.detector(context);
+  }
+  resolve(context) {
+    return this.resolver?.(context) ?? this;
+  }
+  buildDriveSetArgs(trx, value) {
+    return this.driveHasTrx ? [trx, value] : [value];
+  }
+  buildDriveReadArgs(trx) {
+    return this.driveHasTrx ? [trx] : [];
+  }
+  parseDrive(args, defaultTrx) {
+    return parseDriveState(args, defaultTrx, this.driveHasTrx);
+  }
+  buildTuneDriveSetArgs(trx, value) {
+    return this.driveHasTrx ? [trx, value] : [value];
+  }
+  buildTuneDriveReadArgs(trx) {
+    return this.driveHasTrx ? [trx] : [];
+  }
+  parseTuneDrive(args, defaultTrx) {
+    return parseDriveState(args, defaultTrx, this.driveHasTrx);
+  }
+};
+function parseDriveState(args, defaultTrx, hasTrx) {
+  const trx = hasTrx ? Number(args[0]) : defaultTrx;
+  const value = Number(args[hasTrx ? 1 : 0]);
+  if (!Number.isInteger(trx) || !Number.isFinite(value)) return void 0;
+  return { trx, value };
+}
+function version(context) {
+  return parseTciVersion(context.identity.protocolVersion);
+}
+function programIncludes(context, value) {
+  return context.identity.programName?.toLowerCase().includes(value) ?? false;
+}
+var expertSdr14Dialect = new StandardTciDialect({
+  id: "expertsdr-1.4",
+  label: "ExpertSDR / TCI 1.4",
+  streamLengthSemantics: "per-channel",
+  supportsStreamChannels: false,
+  supportsTxAudioSource: false,
+  driveHasTrx: false,
+  detect: (context) => {
+    const parsed = version(context);
+    if (!parsed || compareTciVersion(parsed, [1, 4]) > 0) return { score: 0, evidence: [] };
+    return { score: 80 + (programIncludes(context, "expert") ? 10 : 0), evidence: [`protocol ${formatVersion(parsed)} <= 1.4`] };
+  }
+});
+var expertSdrLegacyDialect = new StandardTciDialect({
+  id: "expertsdr-1.5-1.8",
+  label: "ExpertSDR / TCI 1.5-1.8",
+  streamLengthSemantics: "per-channel",
+  supportsStreamChannels: false,
+  supportsTxAudioSource: false,
+  driveHasTrx: true,
+  detect: (context) => {
+    const parsed = version(context);
+    if (!parsed || compareTciVersion(parsed, [1, 5]) < 0 || compareTciVersion(parsed, [1, 9]) >= 0) return { score: 0, evidence: [] };
+    return { score: 80 + (programIncludes(context, "expert") ? 10 : 0), evidence: [`protocol ${formatVersion(parsed)} is in 1.5-1.8`] };
+  }
+});
+var expertSdrModernDialect = new StandardTciDialect({
+  id: "expertsdr-1.9-2.0",
+  label: "ExpertSDR / TCI 1.9-2.0",
+  streamLengthSemantics: "scalar",
+  supportsStreamChannels: true,
+  supportsTxAudioSource: true,
+  driveHasTrx: true,
+  detect: (context) => {
+    const parsed = version(context);
+    if (!parsed || compareTciVersion(parsed, [1, 9]) < 0) return { score: 0, evidence: [] };
+    const future = compareTciVersion(parsed, [2, 0]) > 0;
+    return {
+      score: 70 + (programIncludes(context, "expert") ? 15 : 0),
+      evidence: [`protocol ${formatVersion(parsed)} uses modern stream negotiation`],
+      warnings: future ? [`Unknown future TCI version ${formatVersion(parsed)}; using the modern dialect`] : []
+    };
+  }
+});
+var thetisDialect = new StandardTciDialect({
+  id: "thetis-2.0",
+  label: "Thetis / TCI 2.0",
+  streamLengthSemantics: "scalar",
+  supportsStreamChannels: true,
+  supportsTxAudioSource: true,
+  driveHasTrx: true,
+  detect: (context) => {
+    const evidence = [];
+    let score = 0;
+    if (programIncludes(context, "thetis")) {
+      score += 120;
+      evidence.push("PROTOCOL program is Thetis");
+    }
+    const observed = ["tx_frequency_ex", "tx_profiles_ex", "tx_profile_ex", "calibration_ex"].filter((name) => context.commandNames.has(name));
+    if (observed.length > 0) {
+      score += 100;
+      evidence.push(`Thetis extension commands: ${observed.join(", ")}`);
+    }
+    if (/anan|hermes|orion|saturn/i.test(context.identity.device ?? "")) {
+      score += 30;
+      evidence.push(`Thetis-family device: ${context.identity.device}`);
+    }
+    return { score, evidence };
+  }
+});
+var aetherSdrDialect = new StandardTciDialect({
+  id: "aethersdr-1.5",
+  label: "AetherSDR / TCI 1.5 hybrid",
+  streamLengthSemantics: "scalar",
+  supportsStreamChannels: true,
+  supportsTxAudioSource: true,
+  driveHasTrx: true,
+  detect: (context) => {
+    if (!/^aethersdr$/i.test(context.identity.device ?? "")) return { score: 0, evidence: [] };
+    const evidence = [`AetherSDR device identity: ${context.identity.device}`];
+    const modernAudioCommands = ["audio_stream_sample_type", "audio_stream_channels", "audio_stream_samples"].filter((name) => context.commandNames.has(name));
+    if (modernAudioCommands.length > 0) evidence.push(`Modern audio negotiation: ${modernAudioCommands.join(", ")}`);
+    return {
+      score: 150,
+      evidence,
+      warnings: context.identity.protocolVersion === "1.5" ? ["AetherSDR reports TCI 1.5 but uses modern scalar audio stream semantics"] : []
+    };
+  }
+});
+var genericObservedDialect = new StandardTciDialect({
+  id: "generic-observed",
+  label: "Generic observed TCI",
+  streamLengthSemantics: "auto",
+  supportsStreamChannels: true,
+  supportsTxAudioSource: true,
+  driveHasTrx: true,
+  detect: (context) => ({
+    score: context.commandNames.has("ready") ? 10 : 0,
+    evidence: ["No vendor-specific match; using observed command shapes"],
+    warnings: ["Dialect identity is uncertain"]
+  }),
+  resolve: (context) => {
+    const drive = [...context.commands].reverse().find((command) => command.name === "drive");
+    const driveHasTrx = (drive?.args.length ?? 0) >= 2;
+    return new StandardTciDialect({
+      id: "generic-observed",
+      label: "Generic observed TCI",
+      streamLengthSemantics: "auto",
+      supportsStreamChannels: context.commandNames.has("audio_stream_channels"),
+      supportsTxAudioSource: compareTciVersion(version(context) ?? [0], [2, 0]) >= 0,
+      driveHasTrx,
+      detect: genericObservedDialect.detect.bind(genericObservedDialect)
+    });
+  }
+});
+var builtInDialects = [
+  aetherSdrDialect,
+  thetisDialect,
+  expertSdr14Dialect,
+  expertSdrLegacyDialect,
+  expertSdrModernDialect,
+  genericObservedDialect
+];
+function parseTciVersion(value) {
+  if (!value) return void 0;
+  const match = value.trim().match(/^(\d+)(?:\.(\d+))?(?:\.(\d+))?/);
+  if (!match) return void 0;
+  return match.slice(1).filter((part) => part !== void 0).map(Number);
+}
+function compareTciVersion(left, right) {
+  const length = Math.max(left.length, right.length);
+  for (let index = 0; index < length; index += 1) {
+    const difference = (left[index] ?? 0) - (right[index] ?? 0);
+    if (difference !== 0) return difference;
+  }
+  return 0;
+}
+function formatVersion(value) {
+  return value.join(".");
+}
+
+// src/errors.ts
+var TciError = class extends Error {
+  code;
+  details;
+  constructor(code, message, details) {
+    super(message);
+    this.name = "TciError";
+    this.code = code;
+    this.details = details;
+  }
+};
+
+// src/dialect/registry.ts
+var TciDialectRegistry = class {
+  dialects = /* @__PURE__ */ new Map();
+  constructor(dialects = builtInDialects) {
+    for (const dialect of dialects) this.register(dialect);
+  }
+  register(dialect) {
+    this.dialects.set(dialect.id, dialect);
+  }
+  get(id) {
+    return this.dialects.get(id);
+  }
+  list() {
+    return [...this.dialects.values()];
+  }
+  select(context, selection = "auto") {
+    if (typeof selection === "object") {
+      return { dialect: selection, confidence: "manual", evidence: ["Custom dialect supplied by caller"], warnings: [] };
+    }
+    if (selection !== "auto") {
+      const dialect = this.get(selection);
+      if (!dialect) throw new TciError("unknown-dialect", `Unknown TCI dialect: ${selection}`);
+      return { dialect: dialect.resolve?.(context) ?? dialect, confidence: "manual", evidence: [`Dialect ${selection} selected by caller`], warnings: [] };
+    }
+    const candidates = this.list().map((dialect) => ({ dialect, result: dialect.detect(context) })).sort((left, right) => right.result.score - left.result.score);
+    const selected = candidates[0];
+    if (!selected || selected.result.score <= 0) {
+      throw new TciError("unknown-dialect", "Unable to identify the TCI server dialect");
+    }
+    return {
+      dialect: selected.dialect.resolve?.(context) ?? selected.dialect,
+      confidence: selected.result.score >= 100 ? "high" : selected.result.score >= 70 ? "medium" : "low",
+      evidence: selected.result.evidence,
+      warnings: selected.result.warnings ?? []
+    };
+  }
+};
+var defaultTciDialectRegistry = new TciDialectRegistry();
+
+// src/dialect/handshake.ts
+var IDENTITY_COMMANDS = /* @__PURE__ */ new Set(["protocol", "device", "trx_count", "channels_count", "channel_count"]);
+var STATE_COMMANDS = /* @__PURE__ */ new Set(["vfo", "modulation", "modulations_list", "trx", "drive"]);
+function parseProtocolIdentity(commands) {
+  const protocol = [...commands].reverse().find((command) => command.name === "protocol");
+  const device = [...commands].reverse().find((command) => command.name === "device");
+  const rawProtocolArgs = protocol?.args ?? [];
+  const firstLooksLikeVersion = /^\d+(?:\.\d+){0,2}/.test(rawProtocolArgs[0] ?? "");
+  return {
+    programName: firstLooksLikeVersion ? void 0 : rawProtocolArgs[0],
+    protocolVersion: firstLooksLikeVersion ? rawProtocolArgs[0] : rawProtocolArgs[1],
+    rawProtocolArgs: [...rawProtocolArgs],
+    device: device?.args.join(",")
+  };
+}
+function assertValidTciHandshake(commands) {
+  const names = new Set(commands.map((command) => command.name));
+  if (!names.has("ready")) throw new TciError("handshake-timeout", "TCI READY was not received");
+  const categories = [
+    [...IDENTITY_COMMANDS].some((name) => names.has(name)),
+    [...STATE_COMMANDS].some((name) => names.has(name))
+  ].filter(Boolean).length;
+  const identitySignals = [...IDENTITY_COMMANDS].filter((name) => names.has(name)).length;
+  if (categories < 2 && identitySignals < 2) {
+    throw new TciError("invalid-handshake", "WebSocket opened but did not provide enough TCI initialization evidence");
+  }
+}
+export {
+  TciDialectRegistry,
+  aetherSdrDialect,
+  assertValidTciHandshake,
+  builtInDialects,
+  compareTciVersion,
+  defaultTciDialectRegistry,
+  expertSdr14Dialect,
+  expertSdrLegacyDialect,
+  expertSdrModernDialect,
+  genericObservedDialect,
+  parseProtocolIdentity,
+  parseTciVersion,
+  thetisDialect
+};
+//# sourceMappingURL=index.js.map

package/dist/dialect/index.js.map

@@ -0,0 +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":[]}

package/dist/{index-CK3XdXP3.d.cts → index-lbK6NGY4.d.cts}

@@ -1,6 +1,6 @@
 import { T as TciCommand, a as TciCommandInput } from './text-BwCWY1k1.cjs';
 
-type TciErrorCode = 'connect-timeout' | 'command-timeout' | 'not-connected' | 'disconnected' | 'protocol-error' | 'invalid-frame' | 'cancelled';
+type TciErrorCode = 'connect-timeout' | 'handshake-timeout' | 'invalid-handshake' | 'unknown-dialect' | 'command-timeout' | 'not-connected' | 'disconnected' | 'protocol-error' | 'invalid-frame' | 'cancelled';
 declare class TciError extends Error {
     readonly code: TciErrorCode;
     readonly details?: unknown;

package/dist/{index-Dfmrk2MR.d.ts → index-paj1AOJY.d.ts}

@@ -1,6 +1,6 @@
 import { T as TciCommand, a as TciCommandInput } from './text-BwCWY1k1.js';
 
-type TciErrorCode = 'connect-timeout' | 'command-timeout' | 'not-connected' | 'disconnected' | 'protocol-error' | 'invalid-frame' | 'cancelled';
+type TciErrorCode = 'connect-timeout' | 'handshake-timeout' | 'invalid-handshake' | 'unknown-dialect' | 'command-timeout' | 'not-connected' | 'disconnected' | 'protocol-error' | 'invalid-frame' | 'cancelled';
 declare class TciError extends Error {
     readonly code: TciErrorCode;
     readonly details?: unknown;