@tx5dr/contracts 1.2.0

package/dist/schema/qso.schema.d.ts

@@ -0,0 +1,419 @@
+import { z } from 'zod';
+/**
+ * Candidate-ranking policy used when choosing which station to answer first.
+ *
+ * - `balanced`: combine multiple heuristics without strongly favoring one.
+ * - `dxcc_first`: prioritize entities that advance DXCC goals.
+ * - `new_callsign_first`: prioritize callsigns not yet worked before.
+ */
+export declare const TargetSelectionPriorityModeSchema: z.ZodEnum<["balanced", "dxcc_first", "new_callsign_first"]>;
+/**
+ * Current work status of a resolved DXCC entity in local logbook context.
+ *
+ * - `current`: active/current DXCC entity.
+ * - `deleted`: historically valid but deleted DXCC entity.
+ * - `none`: no DXCC entity could be associated.
+ * - `unknown`: resolution has not completed or confidence is insufficient.
+ */
+export declare const DxccStatusSchema: z.ZodEnum<["current", "deleted", "none", "unknown"]>;
+export declare const DxccSourceSchema: z.ZodEnum<["resolver", "adif", "lotw", "manual_override"]>;
+export declare const DxccConfidenceSchema: z.ZodEnum<["exception", "prefix", "heuristic", "manual", "unknown"]>;
+export declare const SubdivisionConfidenceSchema: z.ZodEnum<["high", "low"]>;
+export declare const OperatorConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    mode: z.ZodObject<{
+        name: z.ZodString;
+        slotMs: z.ZodNumber;
+        toleranceMs: z.ZodDefault<z.ZodNumber>;
+        windowTiming: z.ZodArray<z.ZodNumber, "many">;
+        transmitTiming: z.ZodNumber;
+        encodeAdvance: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        slotMs: number;
+        toleranceMs: number;
+        windowTiming: number[];
+        transmitTiming: number;
+        encodeAdvance: number;
+    }, {
+        name: string;
+        slotMs: number;
+        windowTiming: number[];
+        transmitTiming: number;
+        toleranceMs?: number | undefined;
+        encodeAdvance?: number | undefined;
+    }>;
+    myCallsign: z.ZodString;
+    myGrid: z.ZodString;
+    transmitCycles: z.ZodArray<z.ZodNumber, "many">;
+    autoReplyToCQ: z.ZodBoolean;
+    maxQSOTimeoutCycles: z.ZodNumber;
+    maxCallAttempts: z.ZodNumber;
+    frequency: z.ZodNumber;
+    autoResumeCQAfterFail: z.ZodDefault<z.ZodBoolean>;
+    autoResumeCQAfterSuccess: z.ZodDefault<z.ZodBoolean>;
+    replyToWorkedStations: z.ZodDefault<z.ZodBoolean>;
+    prioritizeNewCalls: z.ZodDefault<z.ZodBoolean>;
+    targetSelectionPriorityMode: z.ZodDefault<z.ZodEnum<["balanced", "dxcc_first", "new_callsign_first"]>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    mode: {
+        name: string;
+        slotMs: number;
+        toleranceMs: number;
+        windowTiming: number[];
+        transmitTiming: number;
+        encodeAdvance: number;
+    };
+    myCallsign: string;
+    myGrid: string;
+    transmitCycles: number[];
+    autoReplyToCQ: boolean;
+    maxQSOTimeoutCycles: number;
+    maxCallAttempts: number;
+    frequency: number;
+    autoResumeCQAfterFail: boolean;
+    autoResumeCQAfterSuccess: boolean;
+    replyToWorkedStations: boolean;
+    prioritizeNewCalls: boolean;
+    targetSelectionPriorityMode: "balanced" | "dxcc_first" | "new_callsign_first";
+}, {
+    id: string;
+    mode: {
+        name: string;
+        slotMs: number;
+        windowTiming: number[];
+        transmitTiming: number;
+        toleranceMs?: number | undefined;
+        encodeAdvance?: number | undefined;
+    };
+    myCallsign: string;
+    myGrid: string;
+    transmitCycles: number[];
+    autoReplyToCQ: boolean;
+    maxQSOTimeoutCycles: number;
+    maxCallAttempts: number;
+    frequency: number;
+    autoResumeCQAfterFail?: boolean | undefined;
+    autoResumeCQAfterSuccess?: boolean | undefined;
+    replyToWorkedStations?: boolean | undefined;
+    prioritizeNewCalls?: boolean | undefined;
+    targetSelectionPriorityMode?: "balanced" | "dxcc_first" | "new_callsign_first" | undefined;
+}>;
+export declare const QSOContextSchema: z.ZodObject<{
+    config: z.ZodObject<{
+        id: z.ZodString;
+        mode: z.ZodObject<{
+            name: z.ZodString;
+            slotMs: z.ZodNumber;
+            toleranceMs: z.ZodDefault<z.ZodNumber>;
+            windowTiming: z.ZodArray<z.ZodNumber, "many">;
+            transmitTiming: z.ZodNumber;
+            encodeAdvance: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            slotMs: number;
+            toleranceMs: number;
+            windowTiming: number[];
+            transmitTiming: number;
+            encodeAdvance: number;
+        }, {
+            name: string;
+            slotMs: number;
+            windowTiming: number[];
+            transmitTiming: number;
+            toleranceMs?: number | undefined;
+            encodeAdvance?: number | undefined;
+        }>;
+        myCallsign: z.ZodString;
+        myGrid: z.ZodString;
+        transmitCycles: z.ZodArray<z.ZodNumber, "many">;
+        autoReplyToCQ: z.ZodBoolean;
+        maxQSOTimeoutCycles: z.ZodNumber;
+        maxCallAttempts: z.ZodNumber;
+        frequency: z.ZodNumber;
+        autoResumeCQAfterFail: z.ZodDefault<z.ZodBoolean>;
+        autoResumeCQAfterSuccess: z.ZodDefault<z.ZodBoolean>;
+        replyToWorkedStations: z.ZodDefault<z.ZodBoolean>;
+        prioritizeNewCalls: z.ZodDefault<z.ZodBoolean>;
+        targetSelectionPriorityMode: z.ZodDefault<z.ZodEnum<["balanced", "dxcc_first", "new_callsign_first"]>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        mode: {
+            name: string;
+            slotMs: number;
+            toleranceMs: number;
+            windowTiming: number[];
+            transmitTiming: number;
+            encodeAdvance: number;
+        };
+        myCallsign: string;
+        myGrid: string;
+        transmitCycles: number[];
+        autoReplyToCQ: boolean;
+        maxQSOTimeoutCycles: number;
+        maxCallAttempts: number;
+        frequency: number;
+        autoResumeCQAfterFail: boolean;
+        autoResumeCQAfterSuccess: boolean;
+        replyToWorkedStations: boolean;
+        prioritizeNewCalls: boolean;
+        targetSelectionPriorityMode: "balanced" | "dxcc_first" | "new_callsign_first";
+    }, {
+        id: string;
+        mode: {
+            name: string;
+            slotMs: number;
+            windowTiming: number[];
+            transmitTiming: number;
+            toleranceMs?: number | undefined;
+            encodeAdvance?: number | undefined;
+        };
+        myCallsign: string;
+        myGrid: string;
+        transmitCycles: number[];
+        autoReplyToCQ: boolean;
+        maxQSOTimeoutCycles: number;
+        maxCallAttempts: number;
+        frequency: number;
+        autoResumeCQAfterFail?: boolean | undefined;
+        autoResumeCQAfterSuccess?: boolean | undefined;
+        replyToWorkedStations?: boolean | undefined;
+        prioritizeNewCalls?: boolean | undefined;
+        targetSelectionPriorityMode?: "balanced" | "dxcc_first" | "new_callsign_first" | undefined;
+    }>;
+    targetCallsign: z.ZodOptional<z.ZodString>;
+    targetGrid: z.ZodOptional<z.ZodString>;
+    reportSent: z.ZodOptional<z.ZodNumber>;
+    reportReceived: z.ZodOptional<z.ZodNumber>;
+    actualFrequency: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    config: {
+        id: string;
+        mode: {
+            name: string;
+            slotMs: number;
+            toleranceMs: number;
+            windowTiming: number[];
+            transmitTiming: number;
+            encodeAdvance: number;
+        };
+        myCallsign: string;
+        myGrid: string;
+        transmitCycles: number[];
+        autoReplyToCQ: boolean;
+        maxQSOTimeoutCycles: number;
+        maxCallAttempts: number;
+        frequency: number;
+        autoResumeCQAfterFail: boolean;
+        autoResumeCQAfterSuccess: boolean;
+        replyToWorkedStations: boolean;
+        prioritizeNewCalls: boolean;
+        targetSelectionPriorityMode: "balanced" | "dxcc_first" | "new_callsign_first";
+    };
+    targetCallsign?: string | undefined;
+    targetGrid?: string | undefined;
+    reportSent?: number | undefined;
+    reportReceived?: number | undefined;
+    actualFrequency?: number | undefined;
+}, {
+    config: {
+        id: string;
+        mode: {
+            name: string;
+            slotMs: number;
+            windowTiming: number[];
+            transmitTiming: number;
+            toleranceMs?: number | undefined;
+            encodeAdvance?: number | undefined;
+        };
+        myCallsign: string;
+        myGrid: string;
+        transmitCycles: number[];
+        autoReplyToCQ: boolean;
+        maxQSOTimeoutCycles: number;
+        maxCallAttempts: number;
+        frequency: number;
+        autoResumeCQAfterFail?: boolean | undefined;
+        autoResumeCQAfterSuccess?: boolean | undefined;
+        replyToWorkedStations?: boolean | undefined;
+        prioritizeNewCalls?: boolean | undefined;
+        targetSelectionPriorityMode?: "balanced" | "dxcc_first" | "new_callsign_first" | undefined;
+    };
+    targetCallsign?: string | undefined;
+    targetGrid?: string | undefined;
+    reportSent?: number | undefined;
+    reportReceived?: number | undefined;
+    actualFrequency?: number | undefined;
+}>;
+export declare const QslSentStatusSchema: z.ZodOptional<z.ZodEnum<["Y", "N", "R", "Q", "I"]>>;
+export declare const QslReceivedStatusSchema: z.ZodOptional<z.ZodEnum<["Y", "N", "R", "I", "V"]>>;
+export declare const QslSimpleStatusSchema: z.ZodOptional<z.ZodEnum<["Y", "N"]>>;
+/**
+ * Canonical persisted QSO record used by TX-5DR logbooks and plugin hooks.
+ *
+ * The schema intentionally spans multiple layers of information:
+ * - core contact details such as callsign, grid, frequency and timestamps;
+ * - message-level exchange details such as reports and raw message history;
+ * - DXCC enrichment and review metadata;
+ * - LoTW / QRZ confirmation state;
+ * - station-location metadata used when exporting ADIF-like records.
+ */
+export declare const QSORecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    callsign: z.ZodString;
+    grid: z.ZodOptional<z.ZodString>;
+    frequency: z.ZodNumber;
+    mode: z.ZodString;
+    submode: z.ZodOptional<z.ZodString>;
+    startTime: z.ZodNumber;
+    endTime: z.ZodOptional<z.ZodNumber>;
+    reportSent: z.ZodOptional<z.ZodString>;
+    reportReceived: z.ZodOptional<z.ZodString>;
+    messageHistory: z.ZodArray<z.ZodString, "many">;
+    comment: z.ZodOptional<z.ZodString>;
+    myCallsign: z.ZodOptional<z.ZodString>;
+    myGrid: z.ZodOptional<z.ZodString>;
+    qth: z.ZodOptional<z.ZodString>;
+    dxccId: z.ZodOptional<z.ZodNumber>;
+    dxccEntity: z.ZodOptional<z.ZodString>;
+    dxccStatus: z.ZodOptional<z.ZodEnum<["current", "deleted", "none", "unknown"]>>;
+    countryCode: z.ZodOptional<z.ZodString>;
+    cqZone: z.ZodOptional<z.ZodNumber>;
+    ituZone: z.ZodOptional<z.ZodNumber>;
+    dxccSource: z.ZodOptional<z.ZodEnum<["resolver", "adif", "lotw", "manual_override"]>>;
+    dxccConfidence: z.ZodOptional<z.ZodEnum<["exception", "prefix", "heuristic", "manual", "unknown"]>>;
+    dxccResolvedAt: z.ZodOptional<z.ZodNumber>;
+    dxccResolverVersion: z.ZodOptional<z.ZodString>;
+    dxccNeedsReview: z.ZodOptional<z.ZodBoolean>;
+    stationLocationId: z.ZodOptional<z.ZodString>;
+    myDxccId: z.ZodOptional<z.ZodNumber>;
+    myCqZone: z.ZodOptional<z.ZodNumber>;
+    myItuZone: z.ZodOptional<z.ZodNumber>;
+    myState: z.ZodOptional<z.ZodString>;
+    myCounty: z.ZodOptional<z.ZodString>;
+    myIota: z.ZodOptional<z.ZodString>;
+    lotwQslSent: z.ZodOptional<z.ZodEnum<["Y", "N", "R", "Q", "I"]>>;
+    lotwQslReceived: z.ZodOptional<z.ZodEnum<["Y", "N", "R", "I", "V"]>>;
+    lotwQslSentDate: z.ZodOptional<z.ZodNumber>;
+    lotwQslReceivedDate: z.ZodOptional<z.ZodNumber>;
+    qrzQslSent: z.ZodOptional<z.ZodEnum<["Y", "N"]>>;
+    qrzQslReceived: z.ZodOptional<z.ZodEnum<["Y", "N"]>>;
+    qrzQslSentDate: z.ZodOptional<z.ZodNumber>;
+    qrzQslReceivedDate: z.ZodOptional<z.ZodNumber>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    mode: string;
+    frequency: number;
+    callsign: string;
+    startTime: number;
+    messageHistory: string[];
+    myCallsign?: string | undefined;
+    myGrid?: string | undefined;
+    reportSent?: string | undefined;
+    reportReceived?: string | undefined;
+    grid?: string | undefined;
+    submode?: string | undefined;
+    endTime?: number | undefined;
+    comment?: string | undefined;
+    qth?: string | undefined;
+    dxccId?: number | undefined;
+    dxccEntity?: string | undefined;
+    dxccStatus?: "unknown" | "current" | "deleted" | "none" | undefined;
+    countryCode?: string | undefined;
+    cqZone?: number | undefined;
+    ituZone?: number | undefined;
+    dxccSource?: "resolver" | "adif" | "lotw" | "manual_override" | undefined;
+    dxccConfidence?: "unknown" | "exception" | "prefix" | "heuristic" | "manual" | undefined;
+    dxccResolvedAt?: number | undefined;
+    dxccResolverVersion?: string | undefined;
+    dxccNeedsReview?: boolean | undefined;
+    stationLocationId?: string | undefined;
+    myDxccId?: number | undefined;
+    myCqZone?: number | undefined;
+    myItuZone?: number | undefined;
+    myState?: string | undefined;
+    myCounty?: string | undefined;
+    myIota?: string | undefined;
+    lotwQslSent?: "Y" | "N" | "R" | "Q" | "I" | undefined;
+    lotwQslReceived?: "Y" | "N" | "R" | "I" | "V" | undefined;
+    lotwQslSentDate?: number | undefined;
+    lotwQslReceivedDate?: number | undefined;
+    qrzQslSent?: "Y" | "N" | undefined;
+    qrzQslReceived?: "Y" | "N" | undefined;
+    qrzQslSentDate?: number | undefined;
+    qrzQslReceivedDate?: number | undefined;
+    notes?: string | undefined;
+}, {
+    id: string;
+    mode: string;
+    frequency: number;
+    callsign: string;
+    startTime: number;
+    messageHistory: string[];
+    myCallsign?: string | undefined;
+    myGrid?: string | undefined;
+    reportSent?: string | undefined;
+    reportReceived?: string | undefined;
+    grid?: string | undefined;
+    submode?: string | undefined;
+    endTime?: number | undefined;
+    comment?: string | undefined;
+    qth?: string | undefined;
+    dxccId?: number | undefined;
+    dxccEntity?: string | undefined;
+    dxccStatus?: "unknown" | "current" | "deleted" | "none" | undefined;
+    countryCode?: string | undefined;
+    cqZone?: number | undefined;
+    ituZone?: number | undefined;
+    dxccSource?: "resolver" | "adif" | "lotw" | "manual_override" | undefined;
+    dxccConfidence?: "unknown" | "exception" | "prefix" | "heuristic" | "manual" | undefined;
+    dxccResolvedAt?: number | undefined;
+    dxccResolverVersion?: string | undefined;
+    dxccNeedsReview?: boolean | undefined;
+    stationLocationId?: string | undefined;
+    myDxccId?: number | undefined;
+    myCqZone?: number | undefined;
+    myItuZone?: number | undefined;
+    myState?: string | undefined;
+    myCounty?: string | undefined;
+    myIota?: string | undefined;
+    lotwQslSent?: "Y" | "N" | "R" | "Q" | "I" | undefined;
+    lotwQslReceived?: "Y" | "N" | "R" | "I" | "V" | undefined;
+    lotwQslSentDate?: number | undefined;
+    lotwQslReceivedDate?: number | undefined;
+    qrzQslSent?: "Y" | "N" | undefined;
+    qrzQslReceived?: "Y" | "N" | undefined;
+    qrzQslSentDate?: number | undefined;
+    qrzQslReceivedDate?: number | undefined;
+    notes?: string | undefined;
+}>;
+export declare const StrategiesResultSchema: z.ZodObject<{
+    stop: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    stop?: boolean | undefined;
+}, {
+    stop?: boolean | undefined;
+}>;
+export type OperatorConfig = z.infer<typeof OperatorConfigSchema>;
+/**
+ * Candidate-ranking policy used when choosing which station to answer first.
+ */
+export type TargetSelectionPriorityMode = z.infer<typeof TargetSelectionPriorityModeSchema>;
+/**
+ * Current work status of a resolved DXCC entity in local logbook context.
+ */
+export type DxccStatus = z.infer<typeof DxccStatusSchema>;
+export type DxccSource = z.infer<typeof DxccSourceSchema>;
+export type DxccConfidence = z.infer<typeof DxccConfidenceSchema>;
+export type QSOContext = z.infer<typeof QSOContextSchema>;
+/**
+ * Canonical persisted QSO record used by TX-5DR logbooks and plugin hooks.
+ *
+ * Plugin authors will most commonly encounter this in completion hooks and
+ * logbook queries.
+ */
+export type QSORecord = z.infer<typeof QSORecordSchema>;
+export type StrategiesResult = z.infer<typeof StrategiesResultSchema>;
+//# sourceMappingURL=qso.schema.d.ts.map

package/dist/schema/qso.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qso.schema.d.ts","sourceRoot":"","sources":["../../src/schema/qso.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,6DAI5C,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,sDAK3B,CAAC;AAEH,eAAO,MAAM,gBAAgB,4DAK3B,CAAC;AAEH,eAAO,MAAM,oBAAoB,sEAM/B,CAAC;AAEH,eAAO,MAAM,2BAA2B,4BAGtC,CAAC;AAGH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe/B,CAAC;AAGH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO3B,CAAC;AAGH,eAAO,MAAM,mBAAmB,qDAA+C,CAAC;AAChF,eAAO,MAAM,uBAAuB,qDAA+C,CAAC;AACpF,eAAO,MAAM,qBAAqB,sCAAgC,CAAC;AAEnE;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiD1B,CAAC;AAGH,eAAO,MAAM,sBAAsB;;;;;;EAEjC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/schema/qso.schema.js

@@ -0,0 +1,137 @@
+import { z } from 'zod';
+import { ModeDescriptorSchema } from './mode.schema.js';
+/**
+ * Candidate-ranking policy used when choosing which station to answer first.
+ *
+ * - `balanced`: combine multiple heuristics without strongly favoring one.
+ * - `dxcc_first`: prioritize entities that advance DXCC goals.
+ * - `new_callsign_first`: prioritize callsigns not yet worked before.
+ */
+export const TargetSelectionPriorityModeSchema = z.enum([
+    'balanced',
+    'dxcc_first',
+    'new_callsign_first',
+]);
+/**
+ * Current work status of a resolved DXCC entity in local logbook context.
+ *
+ * - `current`: active/current DXCC entity.
+ * - `deleted`: historically valid but deleted DXCC entity.
+ * - `none`: no DXCC entity could be associated.
+ * - `unknown`: resolution has not completed or confidence is insufficient.
+ */
+export const DxccStatusSchema = z.enum([
+    'current',
+    'deleted',
+    'none',
+    'unknown',
+]);
+export const DxccSourceSchema = z.enum([
+    'resolver',
+    'adif',
+    'lotw',
+    'manual_override',
+]);
+export const DxccConfidenceSchema = z.enum([
+    'exception',
+    'prefix',
+    'heuristic',
+    'manual',
+    'unknown',
+]);
+export const SubdivisionConfidenceSchema = z.enum([
+    'high',
+    'low',
+]);
+// 操作配置
+export const OperatorConfigSchema = z.object({
+    id: z.string(),
+    mode: ModeDescriptorSchema,
+    myCallsign: z.string(),
+    myGrid: z.string(),
+    transmitCycles: z.array(z.number()),
+    autoReplyToCQ: z.boolean(),
+    maxQSOTimeoutCycles: z.number(),
+    maxCallAttempts: z.number(),
+    frequency: z.number(),
+    autoResumeCQAfterFail: z.boolean().default(false),
+    autoResumeCQAfterSuccess: z.boolean().default(false),
+    replyToWorkedStations: z.boolean().default(false),
+    prioritizeNewCalls: z.boolean().default(true),
+    targetSelectionPriorityMode: TargetSelectionPriorityModeSchema.default('dxcc_first'),
+});
+// QSO状态机上下文
+export const QSOContextSchema = z.object({
+    config: OperatorConfigSchema,
+    targetCallsign: z.string().optional(),
+    targetGrid: z.string().optional(),
+    reportSent: z.number().optional(),
+    reportReceived: z.number().optional(),
+    actualFrequency: z.number().optional(), // 实际通联频率 (基础频率 + 偏移频率)
+});
+// QSL 确认状态枚举（参考 ADIF 3.1.4 规范）
+export const QslSentStatusSchema = z.enum(['Y', 'N', 'R', 'Q', 'I']).optional(); // Y=yes, N=no, R=requested, Q=queued, I=invalid
+export const QslReceivedStatusSchema = z.enum(['Y', 'N', 'R', 'I', 'V']).optional(); // Y=yes, V=validated
+export const QslSimpleStatusSchema = z.enum(['Y', 'N']).optional();
+/**
+ * Canonical persisted QSO record used by TX-5DR logbooks and plugin hooks.
+ *
+ * The schema intentionally spans multiple layers of information:
+ * - core contact details such as callsign, grid, frequency and timestamps;
+ * - message-level exchange details such as reports and raw message history;
+ * - DXCC enrichment and review metadata;
+ * - LoTW / QRZ confirmation state;
+ * - station-location metadata used when exporting ADIF-like records.
+ */
+export const QSORecordSchema = z.object({
+    id: z.string(),
+    callsign: z.string(), // 对方呼号
+    grid: z.string().optional(), // 对方网格定位
+    frequency: z.number(), // 频率
+    mode: z.string(), // 模式（FT8）
+    submode: z.string().optional(), // ADIF 子模式（如 FT4）
+    startTime: z.number(), // 开始时间
+    endTime: z.number().optional(), // 结束时间
+    reportSent: z.string().optional(), // 发送的信号报告
+    reportReceived: z.string().optional(), // 接收的信号报告
+    messageHistory: z.array(z.string()), // 内部消息历史（FT8 等数字模式）
+    comment: z.string().optional(), // 标准 ADIF COMMENT 字段
+    myCallsign: z.string().optional(), // 我的呼号（操作员呼号）
+    myGrid: z.string().optional(), // 我的网格定位（操作员网格）
+    qth: z.string().optional(), // 对方 QTH（地点，语音通联常用）
+    dxccId: z.number().int().positive().optional(),
+    dxccEntity: z.string().optional(),
+    dxccStatus: DxccStatusSchema.optional(),
+    countryCode: z.string().optional(),
+    cqZone: z.number().int().positive().optional(),
+    ituZone: z.number().int().positive().optional(),
+    dxccSource: DxccSourceSchema.optional(),
+    dxccConfidence: DxccConfidenceSchema.optional(),
+    dxccResolvedAt: z.number().optional(),
+    dxccResolverVersion: z.string().optional(),
+    dxccNeedsReview: z.boolean().optional(),
+    stationLocationId: z.string().optional(),
+    myDxccId: z.number().int().positive().optional(),
+    myCqZone: z.number().int().positive().optional(),
+    myItuZone: z.number().int().positive().optional(),
+    myState: z.string().optional(),
+    myCounty: z.string().optional(),
+    myIota: z.string().optional(),
+    // LoTW QSL 确认状态
+    lotwQslSent: QslSentStatusSchema,
+    lotwQslReceived: QslReceivedStatusSchema,
+    lotwQslSentDate: z.number().optional(), // 发送日期 (timestamp)
+    lotwQslReceivedDate: z.number().optional(), // 确认日期 (timestamp)
+    // QRZ QSL 确认状态
+    qrzQslSent: QslSimpleStatusSchema,
+    qrzQslReceived: QslSimpleStatusSchema,
+    qrzQslSentDate: z.number().optional(),
+    qrzQslReceivedDate: z.number().optional(),
+    // 附注（对应 ADIF NOTES 字段）
+    notes: z.string().optional(),
+});
+// 策略执行结果
+export const StrategiesResultSchema = z.object({
+    stop: z.boolean().optional(),
+});
+//# sourceMappingURL=qso.schema.js.map

package/dist/schema/qso.schema.js.map

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