@undefineds.co/xpod 0.3.53 → 0.3.54

package/dist/edge/EdgeNodeAgent.js

@@ -12,10 +12,16 @@ const FrpcProcessManager_1 = require("./frp/FrpcProcessManager");
 const AcmeCertificateManager_1 = require("./acme/AcmeCertificateManager");
 const ClusterCertificateManager_1 = require("./acme/ClusterCertificateManager");
 const EdgeNodeCapabilityDetector_1 = require("./EdgeNodeCapabilityDetector");
+const reachability_1 = require("./reachability");
+const DEFAULT_P2P_ACCEPT_INTERVAL_MS = 1_000;
 class EdgeNodeAgent {
     constructor() {
         this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
         this.lastNetworkDetection = 0;
+        this.p2pAcceptRunning = false;
+        this.p2pAcceptGeneration = 0;
+        this.p2pAcceptedSessionIds = new Set();
+        this.p2pSocketHandles = new Set();
         this.networkDetectionIntervalMs = 60_000; // 每分钟重新检测一次
     }
     async start(options) {
@@ -51,7 +57,7 @@ class EdgeNodeAgent {
         }
         const systemMetrics = options.includeSystemMetrics ? this.collectSystemMetrics() : undefined;
         const metadataPayload = {
-            ...(options.metadata ?? {}),
+            ...this.buildHeartbeatMetadata(options),
             system: systemMetrics,
         };
         const certificatePayload = this.clusterCertificate?.getHeartbeatPayload();
@@ -77,15 +83,118 @@ class EdgeNodeAgent {
             heartbeatOptions.tunnelSupplier = () => this.buildTunnelHeartbeatPayload();
         }
         this.heartbeat = new EdgeNodeSignalClient_1.EdgeNodeSignalClient(heartbeatOptions);
+        this.startP2PAcceptLoop(options);
     }
     stop() {
         if (this.heartbeat && typeof this.heartbeat.dispose === 'function') {
             this.heartbeat.dispose();
         }
         this.heartbeat = undefined;
+        if (this.p2pAcceptInterval) {
+            clearInterval(this.p2pAcceptInterval);
+            this.p2pAcceptInterval = undefined;
+        }
+        this.p2pAcceptGeneration += 1;
+        for (const handle of this.p2pSocketHandles) {
+            handle.close();
+        }
+        this.p2pSocketHandles.clear();
+        this.p2pAcceptedSessionIds.clear();
+        this.p2pAcceptRunning = false;
         void this.frpManager?.stop();
         this.clusterCertificate?.stop();
     }
+    startP2PAcceptLoop(options) {
+        const p2p = options.p2p;
+        if (!p2p || this.normalizeBoolean(p2p.enabled) === false) {
+            return;
+        }
+        const signaling = p2p.signaling ?? (0, reachability_1.createP2PSignalingClient)({
+            apiBaseUrl: this.resolveP2PApiBaseUrl(options.signalEndpoint),
+            nodeId: options.nodeId,
+            token: options.nodeToken,
+        });
+        const handler = (0, reachability_1.createP2PDataPlaneHandler)({ targetBaseUrl: p2p.targetBaseUrl });
+        const intervalMs = this.normalizePositiveInteger(p2p.acceptIntervalMs) ?? DEFAULT_P2P_ACCEPT_INTERVAL_MS;
+        this.p2pAcceptGeneration += 1;
+        const generation = this.p2pAcceptGeneration;
+        const run = () => {
+            void this.acceptP2PConnectionOnce({
+                generation,
+                signaling,
+                sourceId: options.nodeId,
+                host: p2p.host,
+                address: p2p.address,
+                handler,
+                connectTimeoutMs: this.normalizePositiveInteger(p2p.connectTimeoutMs),
+                winnerSelectionWindowMs: this.normalizeNonNegativeInteger(p2p.winnerSelectionWindowMs),
+                localAddress: p2p.localAddress,
+                sleepMs: p2p.sleepMs,
+                connectSocket: p2p.connectSocket,
+                onP2PAccept: p2p.onP2PAccept,
+            });
+        };
+        run();
+        this.p2pAcceptInterval = setInterval(run, intervalMs);
+    }
+    async acceptP2PConnectionOnce(options) {
+        if (this.p2pAcceptRunning) {
+            return;
+        }
+        this.p2pAcceptRunning = true;
+        try {
+            const { generation, onP2PAccept, ...acceptOptions } = options;
+            const accepted = await (0, reachability_1.acceptSignaledRawTcpP2PConnectionOnce)({
+                ...acceptOptions,
+                signaling: this.skipAcceptedP2PSessions(acceptOptions.signaling),
+                host: acceptOptions.host,
+            });
+            if (accepted) {
+                if (generation !== this.p2pAcceptGeneration) {
+                    accepted.socketHandle.close();
+                    return;
+                }
+                this.p2pAcceptedSessionIds.add(accepted.session.sessionId);
+                this.p2pSocketHandles.add(accepted.socketHandle);
+                onP2PAccept?.({
+                    sessionId: accepted.session.sessionId,
+                    nodeId: accepted.session.nodeId,
+                    clientId: accepted.session.clientId,
+                    localCandidateCount: accepted.localCandidates.length,
+                    remoteCandidateCount: accepted.remoteCandidates.length,
+                    nodeAddress: addressEvidenceFromCandidates(accepted.localCandidates),
+                    clientAddress: addressEvidenceFromCandidates(accepted.remoteCandidates),
+                    acceptedAt: new Date().toISOString(),
+                });
+                this.logger.info(`Accepted raw TCP P2P session ${accepted.session.sessionId}.`);
+            }
+        }
+        catch (error) {
+            this.logger.debug(`Raw TCP P2P accept attempt failed: ${error.message}`);
+        }
+        finally {
+            this.p2pAcceptRunning = false;
+        }
+    }
+    skipAcceptedP2PSessions(signaling) {
+        return {
+            createP2PSession: (request) => signaling.createP2PSession(request),
+            getP2PSession: (sessionIdOrUrl) => signaling.getP2PSession(sessionIdOrUrl),
+            addP2PCandidates: (sessionIdOrUrl, request) => signaling.addP2PCandidates(sessionIdOrUrl, request),
+            listP2PSessions: async () => {
+                const sessions = await signaling.listP2PSessions();
+                return sessions.filter((session) => !this.p2pAcceptedSessionIds.has(session.sessionId));
+            },
+        };
+    }
+    resolveP2PApiBaseUrl(signalEndpoint) {
+        try {
+            return new URL(signalEndpoint).origin;
+        }
+        catch {
+            return signalEndpoint;
+        }
+    }
     stringifyIfContent(data) {
         const sanitized = {};
         for (const [key, value] of Object.entries(data)) {
@@ -110,6 +219,81 @@ class EdgeNodeAgent {
             freeMem: node_os_1.default.freemem(),
         };
     }
+    buildHeartbeatMetadata(options) {
+        const metadata = { ...(options.metadata ?? {}) };
+        const p2pRoute = this.buildP2PHeartbeatRoute(options);
+        if (p2pRoute) {
+            metadata.routes = this.mergeHeartbeatRoutes(metadata.routes, p2pRoute);
+        }
+        return metadata;
+    }
+    buildP2PHeartbeatRoute(options) {
+        const p2p = options.p2p;
+        if (!p2p || this.normalizeBoolean(p2p.enabled) === false) {
+            return undefined;
+        }
+        const label = typeof p2p.label === 'string' && p2p.label.length > 0 ? p2p.label : undefined;
+        return {
+            id: 'p2p-raw-tcp',
+            nodeId: options.nodeId,
+            ...(options.baseUrl ? { canonicalUrl: options.baseUrl } : {}),
+            kind: 'p2p',
+            targetUrl: `tcp-punch://node/${encodeURIComponent(options.nodeId)}`,
+            priority: 40,
+            requiresManagedClient: true,
+            visibility: 'authorized-client',
+            health: 'healthy',
+            metadata: {
+                protocols: {
+                    'raw-tcp-hole-punch': {
+                        enabled: true,
+                        ...(label ? { label } : {}),
+                    },
+                },
+            },
+        };
+    }
+    mergeHeartbeatRoutes(existing, p2pRoute) {
+        const routes = Array.isArray(existing)
+            ? existing.filter((entry) => Boolean(entry) && typeof entry === 'object')
+            : [];
+        const withoutGeneratedRoute = routes.filter((route) => route.id !== p2pRoute.id);
+        return [...withoutGeneratedRoute, p2pRoute];
+    }
+    normalizePositiveInteger(value) {
+        if (typeof value === 'number' && Number.isFinite(value) && value > 0) {
+            return Math.floor(value);
+        }
+        if (typeof value === 'string') {
+            const parsed = Number(value);
+            if (Number.isFinite(parsed) && parsed > 0) {
+                return Math.floor(parsed);
+            }
+        }
+        return undefined;
+    }
+    normalizeNonNegativeInteger(value) {
+        if (typeof value === 'number' && Number.isFinite(value) && value >= 0) {
+            return Math.floor(value);
+        }
+        if (typeof value === 'string') {
+            const parsed = Number(value);
+            if (Number.isFinite(parsed) && parsed >= 0) {
+                return Math.floor(parsed);
+            }
+        }
+        return undefined;
+    }
+    normalizeBoolean(value) {
+        if (value === undefined) {
+            return true;
+        }
+        if (typeof value === 'boolean') {
+            return value;
+        }
+        const normalized = value.trim().toLowerCase();
+        return normalized === 'true' || normalized === '1' || normalized === 'yes' || normalized === 'on';
+    }
     handleHeartbeatResponse(data) {
         if (!data || typeof data !== 'object') {
             return;
@@ -227,4 +411,27 @@ class EdgeNodeAgent {
     }
 }
 exports.EdgeNodeAgent = EdgeNodeAgent;
+function addressEvidenceFromCandidates(candidates) {
+    const evidence = candidates.map(candidateAddressEvidence);
+    return evidence.find((entry) => entry === 'explicit-host')
+        ?? evidence.find((entry) => entry === 'explicit-address')
+        ?? evidence.find((entry) => entry === 'signal-observed')
+        ?? evidence.find((entry) => entry === 'candidate-url')
+        ?? 'port-only';
+}
+function candidateAddressEvidence(candidate) {
+    if (candidate.host) {
+        return 'explicit-host';
+    }
+    if (candidate.address && candidate.url) {
+        return 'explicit-address';
+    }
+    if (candidate.address) {
+        return 'signal-observed';
+    }
+    if (candidate.url) {
+        return 'candidate-url';
+    }
+    return 'port-only';
+}
 //# sourceMappingURL=EdgeNodeAgent.js.map

package/dist/edge/EdgeNodeAgent.js.map

@@ -1 +1 @@
-{"version":3,"file":"EdgeNodeAgent.js","sourceRoot":"","sources":["../../src/edge/EdgeNodeAgent.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AACzB,2DAA2C;AAC3C,iEAAqD;AAErD,0EAAuE;AACvE,iEAAsF;AACtF,0EAAuE;AACvE,gFAA6E;AAC7E,6EAAmG;AAoCnG,MAAa,aAAa;IAA1B;QACmB,WAAM,GAAG,IAAA,oCAAY,EAAC,IAAI,CAAC,CAAC;QAMrC,yBAAoB,GAAG,CAAC,CAAC;QAChB,+BAA0B,GAAG,MAAM,CAAC,CAAC,YAAY;IA4NpE,CAAC;IA1NQ,KAAK,CAAC,KAAK,CAAC,OAA6B;QAC9C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC;YAC1C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,UAAU,GAAG,IAAI,uCAAkB,CAAC;gBACvC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU;gBAClC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU;gBAClC,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;gBAC9C,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS;gBAChC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW;aACrC,CAAC,CAAC;QACL,CAAC;QAED,WAAW;QACX,IAAI,OAAO,CAAC,sBAAsB,KAAK,KAAK,EAAE,CAAC;YAC7C,IAAI,CAAC,eAAe,GAAG,IAAI,uDAA0B,CAAC;gBACpD,gBAAgB,EAAE;oBAChB,sBAAsB,EAAE,IAAI;iBAC7B;aACF,CAAC,CAAC;YACH,WAAW;YACX,IAAI,CAAC,iBAAiB,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,sBAAsB,EAAE,CAAC;YAC7E,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,IAAI,CAAC,iBAAiB,CAAC,UAAU,IAAI,IAAI,CAAC,iBAAiB,CAAC,IAAI,UAAU,IAAI,CAAC,iBAAiB,CAAC,UAAU,IAAI,IAAI,CAAC,iBAAiB,CAAC,IAAI,mBAAmB,IAAI,CAAC,iBAAiB,CAAC,aAAa,EAAE,CAAC,CAAC;QACnP,CAAC;QAED,MAAM,aAAa,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7F,MAAM,eAAe,GAAG;YACtB,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;YAC3B,MAAM,EAAE,aAAa;SACK,CAAC;QAE7B,MAAM,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,EAAE,mBAAmB,EAAE,CAAC;QAC1E,MAAM,gBAAgB,GAAgC;YACpD,gBAAgB,EAAE,IAAI;YACtB,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,QAAQ,EAAE,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC;YAClD,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS;YAClE,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,SAAS;YAChF,mBAAmB,EAAE,CAAC,IAAa,EAAQ,EAAE;gBAC3C,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;gBACnC,OAAO,CAAC,mBAAmB,EAAE,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;YACD,eAAe,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS;SAChF,CAAC;QACF,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,gBAAgB,CAAC,cAAc,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,2BAA2B,EAAE,CAAC;QAC7E,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,2CAAoB,CAAC,gBAAgB,CAAC,CAAC;IAC9D,CAAC;IAEM,IAAI;QACT,IAAI,IAAI,CAAC,SAAS,IAAI,OAAQ,IAAI,CAAC,SAAiB,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YAC3E,IAAI,CAAC,SAAiB,CAAC,OAAO,EAAE,CAAC;QACpC,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,KAAK,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC;IAClC,CAAC;IAEO,kBAAkB,CAAC,IAA6B;QACtD,MAAM,SAAS,GAA4B,EAAE,CAAC;QAC9C,KAAK,MAAM,CAAE,GAAG,EAAE,KAAK,CAAE,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACzB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACnF,CAAC;IAEO,oBAAoB;QAC1B,MAAM,IAAI,GAAG,iBAAE,CAAC,OAAO,EAAE,CAAC;QAC1B,OAAO;YACL,QAAQ,EAAE,iBAAE,CAAC,QAAQ,EAAE;YACvB,QAAQ,EAAE,iBAAE,CAAC,QAAQ,EAAE;YACvB,IAAI,EAAE,iBAAE,CAAC,IAAI,EAAE;YACf,MAAM,EAAE,iBAAE,CAAC,MAAM,EAAE;YACnB,QAAQ,EAAE,iBAAE,CAAC,IAAI,EAAE,CAAC,MAAM;YAC1B,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;YACd,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;YACf,QAAQ,EAAE,iBAAE,CAAC,QAAQ,EAAE;YACvB,OAAO,EAAE,iBAAE,CAAC,OAAO,EAAE;SACtB,CAAC;IACJ,CAAC;IAEO,uBAAuB,CAAC,IAAa;QAC3C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,IAA2B,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAA2C,CAAC;QAClE,IAAI,CAAC,kBAAkB,EAAE,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,QAAQ,EAAE,MAAyC,CAAC;QACnE,MAAM,MAAM,GAAG,MAAM,EAAE,MAAyC,CAAC;QACjE,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;QACnH,CAAC;QACD,MAAM,UAAU,GAAG,OAAO,MAAM,EAAE,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC7E,OAAO,MAAM,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QACvE,KAAK,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,MAAa,EAAE,MAAM,EAAE,MAA4B,EAAE,UAAU,CAAC,CAAC;IACrG,CAAC;IAEO,KAAK,CAAC,uBAAuB,CAAC,OAA6B;QACjE,MAAM,WAAW,GAAG,OAAO,CAAC,IAAK,CAAC;QAClC,IAAI,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnF,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,+CAAsB,CAAC;YACzC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,KAAK,EAAE,WAAW,CAAC,KAAM;YACzB,OAAO,EAAE,WAAW,CAAC,OAAQ;YAC7B,YAAY,EAAE,WAAW,CAAC,YAAY;YACtC,cAAc,EAAE,WAAW,CAAC,cAAe;YAC3C,kBAAkB,EAAE,WAAW,CAAC,kBAAkB;YAClD,eAAe,EAAE,WAAW,CAAC,eAAe;YAC5C,aAAa,EAAE,WAAW,CAAC,aAAa;YACxC,eAAe,EAAE,WAAW,CAAC,eAAe;YAC5C,kBAAkB,EAAE,WAAW,CAAC,kBAAkB;SACnD,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACjD,IAAI,MAAM,IAAI,WAAW,CAAC,iBAAiB,IAAI,WAAW,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxF,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAa,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,wBAAwB,CAAC,OAA6B;QAClE,MAAM,WAAW,GAAG,OAAO,CAAC,IAAK,CAAC;QAClC,IAAI,CAAC,WAAW,CAAC,kBAAkB,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,qDAAyB,CAAC;YAC5C,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,kBAAkB,EAAE,WAAW,CAAC,kBAAkB;YAClD,eAAe,EAAE,WAAW,CAAC,eAAe;YAC5C,aAAa,EAAE,WAAW,CAAC,aAAa;YACxC,eAAe,EAAE,WAAW,CAAC,eAAe;YAC5C,sBAAsB,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,iBAAkB,CAAC,CAAC,CAAC,CAAC,SAAS;SAC7H,CAAC,CAAC;QACH,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC;QAClC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,OAAiB;QAC3C,MAAM,CAAE,UAAU,EAAE,GAAG,IAAI,CAAE,GAAG,OAAO,CAAC;QACxC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,KAAK,GAAG,IAAA,0BAAK,EAAC,UAAU,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YAC5D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC1B,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBACxB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,OAAO,EAAE,CAAC;gBACZ,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,UAAU,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,2BAA2B;QACjC,MAAM,MAAM,GAAkC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,CAAC;QAC3E,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,cAAc;QACd,IAAI,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC,0BAA0B,EAAE,CAAC;YACnG,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,IAAI,CAAC,iBAAiB,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,sBAAsB,EAAE,CAAC;oBAC7E,IAAI,CAAC,oBAAoB,GAAG,GAAG,CAAC;gBAClC,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA8B,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC7E,CAAC;YACH,CAAC;QACH,CAAC;QAED,WAAW;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,IAAI,IAAI,CAAC,iBAAiB,EAAE,IAAI;YACxE,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,IAAI,IAAI,CAAC,iBAAiB,EAAE,IAAI;SACzE,CAAC;IACJ,CAAC;CACF;AApOD,sCAoOC","sourcesContent":["import os from 'node:os';\nimport { spawn } from 'node:child_process';\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { EdgeNodeSignalClientOptions } from '../service/EdgeNodeSignalClient';\nimport { EdgeNodeSignalClient } from '../service/EdgeNodeSignalClient';\nimport { FrpcProcessManager, type FrpcRuntimeStatus } from './frp/FrpcProcessManager';\nimport { AcmeCertificateManager } from './acme/AcmeCertificateManager';\nimport { ClusterCertificateManager } from './acme/ClusterCertificateManager';\nimport { EdgeNodeCapabilityDetector, type NetworkAddressInfo } from './EdgeNodeCapabilityDetector';\n\nexport interface EdgeNodeAgentOptions {\n  signalEndpoint: string;\n  nodeId: string;\n  nodeToken: string;\n  baseUrl?: string;\n  directCandidates?: string | string[];\n  pods?: string[];\n  includeSystemMetrics?: boolean;\n  enableNetworkDetection?: boolean;\n  metadata?: Record<string, unknown>;\n  intervalMs?: number;\n  onHeartbeatResponse?: (data: unknown) => void;\n  acme?: {\n    mode?: 'local' | 'cluster';\n    email?: string;\n    domains?: string[];\n    directoryUrl?: string;\n    accountKeyPath?: string;\n    certificateKeyPath: string;\n    certificatePath: string;\n    fullChainPath?: string;\n    renewBeforeDays?: number;\n    propagationDelayMs?: number;\n    postDeployCommand?: string[];\n  };\n  frp?: {\n    binaryPath: string;\n    configPath: string;\n    workingDirectory?: string;\n    logPrefix?: string;\n    autoRestart?: boolean;\n  };\n}\n\nexport class EdgeNodeAgent {\n  private readonly logger = getLoggerFor(this);\n  private heartbeat?: EdgeNodeSignalClient;\n  private frpManager?: FrpcProcessManager;\n  private clusterCertificate?: ClusterCertificateManager;\n  private networkDetector?: EdgeNodeCapabilityDetector;\n  private cachedNetworkInfo?: NetworkAddressInfo;\n  private lastNetworkDetection = 0;\n  private readonly networkDetectionIntervalMs = 60_000; // 每分钟重新检测一次\n\n  public async start(options: EdgeNodeAgentOptions): Promise<void> {\n    if (options.acme) {\n      const mode = options.acme.mode ?? 'local';\n      if (mode === 'cluster') {\n        await this.ensureClusterCertificate(options);\n      } else {\n        await this.issueCertificateLocally(options);\n      }\n    }\n    if (options.frp) {\n      this.frpManager = new FrpcProcessManager({\n        binaryPath: options.frp.binaryPath,\n        configPath: options.frp.configPath,\n        workingDirectory: options.frp.workingDirectory,\n        logPrefix: options.frp.logPrefix,\n        autoRestart: options.frp.autoRestart,\n      });\n    }\n    \n    // 初始化网络检测器\n    if (options.enableNetworkDetection !== false) {\n      this.networkDetector = new EdgeNodeCapabilityDetector({\n        dynamicDetection: {\n          enableNetworkDetection: true,\n        },\n      });\n      // 执行初始网络检测\n      this.cachedNetworkInfo = await this.networkDetector.detectNetworkAddresses();\n      this.lastNetworkDetection = Date.now();\n      this.logger.info(`Network detection: IPv4=${this.cachedNetworkInfo.ipv4Public ?? this.cachedNetworkInfo.ipv4}, IPv6=${this.cachedNetworkInfo.ipv6Public ?? this.cachedNetworkInfo.ipv6}, hasPublicIPv6=${this.cachedNetworkInfo.hasPublicIPv6}`);\n    }\n    \n    const systemMetrics = options.includeSystemMetrics ? this.collectSystemMetrics() : undefined;\n    const metadataPayload = {\n      ...(options.metadata ?? {}),\n      system: systemMetrics,\n    } as Record<string, unknown>;\n\n    const certificatePayload = this.clusterCertificate?.getHeartbeatPayload();\n    const heartbeatOptions: EdgeNodeSignalClientOptions = {\n      edgeNodesEnabled: true,\n      signalEndpoint: options.signalEndpoint,\n      nodeId: options.nodeId,\n      nodeToken: options.nodeToken,\n      baseUrl: options.baseUrl,\n      directCandidates: options.directCandidates,\n      pods: options.pods,\n      intervalMs: options.intervalMs,\n      metadata: this.stringifyIfContent(metadataPayload),\n      metrics: systemMetrics ? JSON.stringify(systemMetrics) : undefined,\n      certificate: certificatePayload ? JSON.stringify(certificatePayload) : undefined,\n      onHeartbeatResponse: (data: unknown): void => {\n        this.handleHeartbeatResponse(data);\n        options.onHeartbeatResponse?.(data);\n      },\n      networkSupplier: this.networkDetector ? () => this.getNetworkInfo() : undefined,\n    };\n    if (this.frpManager) {\n      heartbeatOptions.tunnelSupplier = () => this.buildTunnelHeartbeatPayload();\n    }\n\n    this.heartbeat = new EdgeNodeSignalClient(heartbeatOptions);\n  }\n\n  public stop(): void {\n    if (this.heartbeat && typeof (this.heartbeat as any).dispose === 'function') {\n      (this.heartbeat as any).dispose();\n    }\n    this.heartbeat = undefined;\n    void this.frpManager?.stop();\n    this.clusterCertificate?.stop();\n  }\n\n  private stringifyIfContent(data: Record<string, unknown>): string | undefined {\n    const sanitized: Record<string, unknown> = {};\n    for (const [ key, value ] of Object.entries(data)) {\n      if (value !== undefined) {\n        sanitized[key] = value;\n      }\n    }\n    return Object.keys(sanitized).length > 0 ? JSON.stringify(sanitized) : undefined;\n  }\n\n  private collectSystemMetrics(): Record<string, unknown> {\n    const load = os.loadavg();\n    return {\n      hostname: os.hostname(),\n      platform: os.platform(),\n      arch: os.arch(),\n      uptime: os.uptime(),\n      cpuCount: os.cpus().length,\n      load1: load[0],\n      load5: load[1],\n      load15: load[2],\n      totalMem: os.totalmem(),\n      freeMem: os.freemem(),\n    };\n  }\n\n  private handleHeartbeatResponse(data: unknown): void {\n    if (!data || typeof data !== 'object') {\n      return;\n    }\n    const body = data as Record<string, any>;\n    const metadata = body.metadata as Record<string, any> | undefined;\n    this.clusterCertificate?.handleHeartbeatMetadata(metadata);\n    const tunnel = metadata?.tunnel as Record<string, any> | undefined;\n    const config = tunnel?.config as Record<string, any> | undefined;\n    if (config) {\n      this.logger.debug(`接收到隧道配置: ${JSON.stringify({ entrypoint: tunnel?.entrypoint, proxyName: config.proxyName })}`);\n    }\n    const entrypoint = typeof tunnel?.entrypoint === 'string' ? tunnel.entrypoint :\n      typeof config?.publicUrl === 'string' ? config.publicUrl : undefined;\n    void this.frpManager?.applyConfig(config as any, tunnel?.status as string | undefined, entrypoint);\n  }\n\n  private async issueCertificateLocally(options: EdgeNodeAgentOptions): Promise<void> {\n    const acmeOptions = options.acme!;\n    if (!acmeOptions.email || !acmeOptions.domains || acmeOptions.domains.length === 0) {\n      throw new Error('本地 ACME 模式需要提供 email 与 domains。');\n    }\n    if (!acmeOptions.accountKeyPath) {\n      throw new Error('本地 ACME 模式需要提供 accountKeyPath。');\n    }\n    const manager = new AcmeCertificateManager({\n      signalEndpoint: options.signalEndpoint,\n      nodeId: options.nodeId,\n      nodeToken: options.nodeToken,\n      email: acmeOptions.email!,\n      domains: acmeOptions.domains!,\n      directoryUrl: acmeOptions.directoryUrl,\n      accountKeyPath: acmeOptions.accountKeyPath!,\n      certificateKeyPath: acmeOptions.certificateKeyPath,\n      certificatePath: acmeOptions.certificatePath,\n      fullChainPath: acmeOptions.fullChainPath,\n      renewBeforeDays: acmeOptions.renewBeforeDays,\n      propagationDelayMs: acmeOptions.propagationDelayMs,\n    });\n    try {\n      const issued = await manager.ensureCertificate();\n      if (issued && acmeOptions.postDeployCommand && acmeOptions.postDeployCommand.length > 0) {\n        await this.runPostDeploy(acmeOptions.postDeployCommand);\n      }\n    } catch (error: unknown) {\n      this.logger.error(`自动签发证书失败：${(error as Error).message}`);\n      throw error;\n    }\n  }\n\n  private async ensureClusterCertificate(options: EdgeNodeAgentOptions): Promise<void> {\n    const acmeOptions = options.acme!;\n    if (!acmeOptions.certificateKeyPath || !acmeOptions.certificatePath) {\n      throw new Error('Cluster 模式需要提供 certificateKeyPath 与 certificatePath。');\n    }\n    const manager = new ClusterCertificateManager({\n      signalEndpoint: options.signalEndpoint,\n      nodeId: options.nodeId,\n      nodeToken: options.nodeToken,\n      certificateKeyPath: acmeOptions.certificateKeyPath,\n      certificatePath: acmeOptions.certificatePath,\n      fullChainPath: acmeOptions.fullChainPath,\n      renewBeforeDays: acmeOptions.renewBeforeDays,\n      onCertificateInstalled: acmeOptions.postDeployCommand ? () => this.runPostDeploy(acmeOptions.postDeployCommand!) : undefined,\n    });\n    this.clusterCertificate = manager;\n    await manager.start();\n  }\n\n  private async runPostDeploy(command: string[]): Promise<void> {\n    const [ executable, ...args ] = command;\n    if (!executable) {\n      return;\n    }\n    await new Promise<void>((resolve, reject) => {\n      const child = spawn(executable, args, { stdio: 'inherit' });\n      child.on('error', reject);\n      child.on('exit', (code) => {\n        if (code === 0) {\n          resolve();\n        } else {\n          reject(new Error(`命令 ${executable} 退出码 ${code}`));\n        }\n      });\n    });\n  }\n\n  private buildTunnelHeartbeatPayload(): Record<string, unknown> | undefined {\n    const status: FrpcRuntimeStatus | undefined = this.frpManager?.getStatus();\n    if (!status) {\n      return undefined;\n    }\n    return { client: status };\n  }\n\n  /**\n   * 获取网络信息（带缓存，每分钟刷新一次）\n   */\n  private async getNetworkInfo(): Promise<{ ipv4?: string; ipv6?: string }> {\n    const now = Date.now();\n    \n    // 如果缓存过期，重新检测\n    if (!this.cachedNetworkInfo || (now - this.lastNetworkDetection) > this.networkDetectionIntervalMs) {\n      if (this.networkDetector) {\n        try {\n          this.cachedNetworkInfo = await this.networkDetector.detectNetworkAddresses();\n          this.lastNetworkDetection = now;\n        } catch (error: unknown) {\n          this.logger.debug(`Network detection failed: ${(error as Error).message}`);\n        }\n      }\n    }\n    \n    // 优先返回公网地址\n    return {\n      ipv4: this.cachedNetworkInfo?.ipv4Public ?? this.cachedNetworkInfo?.ipv4,\n      ipv6: this.cachedNetworkInfo?.ipv6Public ?? this.cachedNetworkInfo?.ipv6,\n    };\n  }\n}\n"]}
+{"version":3,"file":"EdgeNodeAgent.js","sourceRoot":"","sources":["../../src/edge/EdgeNodeAgent.ts"],"names":[],"mappings":"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","sourcesContent":["import os from 'node:os';\nimport { spawn } from 'node:child_process';\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { EdgeNodeSignalClientOptions } from '../service/EdgeNodeSignalClient';\nimport { EdgeNodeSignalClient } from '../service/EdgeNodeSignalClient';\nimport { FrpcProcessManager, type FrpcRuntimeStatus } from './frp/FrpcProcessManager';\nimport { AcmeCertificateManager } from './acme/AcmeCertificateManager';\nimport { ClusterCertificateManager } from './acme/ClusterCertificateManager';\nimport { EdgeNodeCapabilityDetector, type NetworkAddressInfo } from './EdgeNodeCapabilityDetector';\nimport {\n  acceptSignaledRawTcpP2PConnectionOnce,\n  createP2PDataPlaneHandler,\n  createP2PSignalingClient,\n  type AccessRoute,\n  type P2PSignalingClient,\n  type RawTcpP2PConnectSocket,\n  type RawTcpP2PSleep,\n  type TcpP2PDataPlaneSocketHandle,\n} from './reachability';\n\ntype EdgeNodeP2PHeartbeatRoute = Omit<AccessRoute, 'canonicalUrl'> & { canonicalUrl?: string };\n\nexport interface EdgeNodeP2PAcceptEvent {\n  sessionId: string;\n  nodeId: string;\n  clientId: string;\n  localCandidateCount: number;\n  remoteCandidateCount: number;\n  nodeAddress: CandidateAddressEvidence;\n  clientAddress: CandidateAddressEvidence;\n  acceptedAt: string;\n}\n\ntype CandidateAddressEvidence =\n  | 'explicit-host'\n  | 'explicit-address'\n  | 'signal-observed'\n  | 'candidate-url'\n  | 'port-only';\n\nconst DEFAULT_P2P_ACCEPT_INTERVAL_MS = 1_000;\n\nexport interface EdgeNodeAgentOptions {\n  signalEndpoint: string;\n  nodeId: string;\n  nodeToken: string;\n  baseUrl?: string;\n  directCandidates?: string | string[];\n  pods?: string[];\n  includeSystemMetrics?: boolean;\n  enableNetworkDetection?: boolean;\n  metadata?: Record<string, unknown>;\n  intervalMs?: number;\n  onHeartbeatResponse?: (data: unknown) => void;\n  acme?: {\n    mode?: 'local' | 'cluster';\n    email?: string;\n    domains?: string[];\n    directoryUrl?: string;\n    accountKeyPath?: string;\n    certificateKeyPath: string;\n    certificatePath: string;\n    fullChainPath?: string;\n    renewBeforeDays?: number;\n    propagationDelayMs?: number;\n    postDeployCommand?: string[];\n  };\n  frp?: {\n    binaryPath: string;\n    configPath: string;\n    workingDirectory?: string;\n    logPrefix?: string;\n    autoRestart?: boolean;\n  };\n  p2p?: {\n    enabled?: boolean | string;\n    targetBaseUrl: string | URL;\n    label?: string;\n    host?: string;\n    address?: string;\n    signaling?: P2PSignalingClient;\n    acceptIntervalMs?: number | string;\n    connectTimeoutMs?: number | string;\n    winnerSelectionWindowMs?: number | string;\n    localAddress?: string;\n    sleepMs?: RawTcpP2PSleep;\n    connectSocket?: RawTcpP2PConnectSocket;\n    onP2PAccept?: (event: EdgeNodeP2PAcceptEvent) => void;\n  };\n}\n\nexport class EdgeNodeAgent {\n  private readonly logger = getLoggerFor(this);\n  private heartbeat?: EdgeNodeSignalClient;\n  private frpManager?: FrpcProcessManager;\n  private clusterCertificate?: ClusterCertificateManager;\n  private networkDetector?: EdgeNodeCapabilityDetector;\n  private cachedNetworkInfo?: NetworkAddressInfo;\n  private lastNetworkDetection = 0;\n  private p2pAcceptInterval?: NodeJS.Timeout;\n  private p2pAcceptRunning = false;\n  private p2pAcceptGeneration = 0;\n  private readonly p2pAcceptedSessionIds = new Set<string>();\n  private readonly p2pSocketHandles = new Set<TcpP2PDataPlaneSocketHandle>();\n  private readonly networkDetectionIntervalMs = 60_000; // 每分钟重新检测一次\n\n  public async start(options: EdgeNodeAgentOptions): Promise<void> {\n    if (options.acme) {\n      const mode = options.acme.mode ?? 'local';\n      if (mode === 'cluster') {\n        await this.ensureClusterCertificate(options);\n      } else {\n        await this.issueCertificateLocally(options);\n      }\n    }\n    if (options.frp) {\n      this.frpManager = new FrpcProcessManager({\n        binaryPath: options.frp.binaryPath,\n        configPath: options.frp.configPath,\n        workingDirectory: options.frp.workingDirectory,\n        logPrefix: options.frp.logPrefix,\n        autoRestart: options.frp.autoRestart,\n      });\n    }\n    \n    // 初始化网络检测器\n    if (options.enableNetworkDetection !== false) {\n      this.networkDetector = new EdgeNodeCapabilityDetector({\n        dynamicDetection: {\n          enableNetworkDetection: true,\n        },\n      });\n      // 执行初始网络检测\n      this.cachedNetworkInfo = await this.networkDetector.detectNetworkAddresses();\n      this.lastNetworkDetection = Date.now();\n      this.logger.info(`Network detection: IPv4=${this.cachedNetworkInfo.ipv4Public ?? this.cachedNetworkInfo.ipv4}, IPv6=${this.cachedNetworkInfo.ipv6Public ?? this.cachedNetworkInfo.ipv6}, hasPublicIPv6=${this.cachedNetworkInfo.hasPublicIPv6}`);\n    }\n    \n    const systemMetrics = options.includeSystemMetrics ? this.collectSystemMetrics() : undefined;\n    const metadataPayload = {\n      ...this.buildHeartbeatMetadata(options),\n      system: systemMetrics,\n    } as Record<string, unknown>;\n\n    const certificatePayload = this.clusterCertificate?.getHeartbeatPayload();\n    const heartbeatOptions: EdgeNodeSignalClientOptions = {\n      edgeNodesEnabled: true,\n      signalEndpoint: options.signalEndpoint,\n      nodeId: options.nodeId,\n      nodeToken: options.nodeToken,\n      baseUrl: options.baseUrl,\n      directCandidates: options.directCandidates,\n      pods: options.pods,\n      intervalMs: options.intervalMs,\n      metadata: this.stringifyIfContent(metadataPayload),\n      metrics: systemMetrics ? JSON.stringify(systemMetrics) : undefined,\n      certificate: certificatePayload ? JSON.stringify(certificatePayload) : undefined,\n      onHeartbeatResponse: (data: unknown): void => {\n        this.handleHeartbeatResponse(data);\n        options.onHeartbeatResponse?.(data);\n      },\n      networkSupplier: this.networkDetector ? () => this.getNetworkInfo() : undefined,\n    };\n    if (this.frpManager) {\n      heartbeatOptions.tunnelSupplier = () => this.buildTunnelHeartbeatPayload();\n    }\n\n    this.heartbeat = new EdgeNodeSignalClient(heartbeatOptions);\n    this.startP2PAcceptLoop(options);\n  }\n\n  public stop(): void {\n    if (this.heartbeat && typeof (this.heartbeat as any).dispose === 'function') {\n      (this.heartbeat as any).dispose();\n    }\n    this.heartbeat = undefined;\n    if (this.p2pAcceptInterval) {\n      clearInterval(this.p2pAcceptInterval);\n      this.p2pAcceptInterval = undefined;\n    }\n    this.p2pAcceptGeneration += 1;\n    for (const handle of this.p2pSocketHandles) {\n      handle.close();\n    }\n    this.p2pSocketHandles.clear();\n    this.p2pAcceptedSessionIds.clear();\n    this.p2pAcceptRunning = false;\n    void this.frpManager?.stop();\n    this.clusterCertificate?.stop();\n  }\n\n  private startP2PAcceptLoop(options: EdgeNodeAgentOptions): void {\n    const p2p = options.p2p;\n    if (!p2p || this.normalizeBoolean(p2p.enabled) === false) {\n      return;\n    }\n    const signaling = p2p.signaling ?? createP2PSignalingClient({\n      apiBaseUrl: this.resolveP2PApiBaseUrl(options.signalEndpoint),\n      nodeId: options.nodeId,\n      token: options.nodeToken,\n    });\n    const handler = createP2PDataPlaneHandler({ targetBaseUrl: p2p.targetBaseUrl });\n    const intervalMs = this.normalizePositiveInteger(p2p.acceptIntervalMs) ?? DEFAULT_P2P_ACCEPT_INTERVAL_MS;\n    this.p2pAcceptGeneration += 1;\n    const generation = this.p2pAcceptGeneration;\n    const run = (): void => {\n      void this.acceptP2PConnectionOnce({\n        generation,\n        signaling,\n        sourceId: options.nodeId,\n        host: p2p.host,\n        address: p2p.address,\n        handler,\n        connectTimeoutMs: this.normalizePositiveInteger(p2p.connectTimeoutMs),\n        winnerSelectionWindowMs: this.normalizeNonNegativeInteger(p2p.winnerSelectionWindowMs),\n        localAddress: p2p.localAddress,\n        sleepMs: p2p.sleepMs,\n        connectSocket: p2p.connectSocket,\n        onP2PAccept: p2p.onP2PAccept,\n      });\n    };\n    run();\n    this.p2pAcceptInterval = setInterval(run, intervalMs);\n  }\n\n  private async acceptP2PConnectionOnce(options: Parameters<typeof acceptSignaledRawTcpP2PConnectionOnce>[0] & {\n    generation: number;\n    onP2PAccept?: (event: EdgeNodeP2PAcceptEvent) => void;\n  }): Promise<void> {\n    if (this.p2pAcceptRunning) {\n      return;\n    }\n    this.p2pAcceptRunning = true;\n    try {\n      const { generation, onP2PAccept, ...acceptOptions } = options;\n      const accepted = await acceptSignaledRawTcpP2PConnectionOnce({\n        ...acceptOptions,\n        signaling: this.skipAcceptedP2PSessions(acceptOptions.signaling),\n        host: acceptOptions.host,\n      });\n      if (accepted) {\n        if (generation !== this.p2pAcceptGeneration) {\n          accepted.socketHandle.close();\n          return;\n        }\n        this.p2pAcceptedSessionIds.add(accepted.session.sessionId);\n        this.p2pSocketHandles.add(accepted.socketHandle);\n        onP2PAccept?.({\n          sessionId: accepted.session.sessionId,\n          nodeId: accepted.session.nodeId,\n          clientId: accepted.session.clientId,\n          localCandidateCount: accepted.localCandidates.length,\n          remoteCandidateCount: accepted.remoteCandidates.length,\n          nodeAddress: addressEvidenceFromCandidates(accepted.localCandidates),\n          clientAddress: addressEvidenceFromCandidates(accepted.remoteCandidates),\n          acceptedAt: new Date().toISOString(),\n        });\n        this.logger.info(`Accepted raw TCP P2P session ${accepted.session.sessionId}.`);\n      }\n    } catch (error: unknown) {\n      this.logger.debug(`Raw TCP P2P accept attempt failed: ${(error as Error).message}`);\n    } finally {\n      this.p2pAcceptRunning = false;\n    }\n  }\n\n  private skipAcceptedP2PSessions(signaling: P2PSignalingClient): P2PSignalingClient {\n    return {\n      createP2PSession: (request) => signaling.createP2PSession(request),\n      getP2PSession: (sessionIdOrUrl) => signaling.getP2PSession(sessionIdOrUrl),\n      addP2PCandidates: (sessionIdOrUrl, request) => signaling.addP2PCandidates(sessionIdOrUrl, request),\n      listP2PSessions: async () => {\n        const sessions = await signaling.listP2PSessions();\n        return sessions.filter((session) => !this.p2pAcceptedSessionIds.has(session.sessionId));\n      },\n    };\n  }\n\n  private resolveP2PApiBaseUrl(signalEndpoint: string): string {\n    try {\n      return new URL(signalEndpoint).origin;\n    } catch {\n      return signalEndpoint;\n    }\n  }\n\n  private stringifyIfContent(data: Record<string, unknown>): string | undefined {\n    const sanitized: Record<string, unknown> = {};\n    for (const [ key, value ] of Object.entries(data)) {\n      if (value !== undefined) {\n        sanitized[key] = value;\n      }\n    }\n    return Object.keys(sanitized).length > 0 ? JSON.stringify(sanitized) : undefined;\n  }\n\n  private collectSystemMetrics(): Record<string, unknown> {\n    const load = os.loadavg();\n    return {\n      hostname: os.hostname(),\n      platform: os.platform(),\n      arch: os.arch(),\n      uptime: os.uptime(),\n      cpuCount: os.cpus().length,\n      load1: load[0],\n      load5: load[1],\n      load15: load[2],\n      totalMem: os.totalmem(),\n      freeMem: os.freemem(),\n    };\n  }\n\n  private buildHeartbeatMetadata(options: EdgeNodeAgentOptions): Record<string, unknown> {\n    const metadata = { ...(options.metadata ?? {}) } as Record<string, unknown>;\n    const p2pRoute = this.buildP2PHeartbeatRoute(options);\n    if (p2pRoute) {\n      metadata.routes = this.mergeHeartbeatRoutes(metadata.routes, p2pRoute);\n    }\n    return metadata;\n  }\n\n  private buildP2PHeartbeatRoute(options: EdgeNodeAgentOptions): EdgeNodeP2PHeartbeatRoute | undefined {\n    const p2p = options.p2p;\n    if (!p2p || this.normalizeBoolean(p2p.enabled) === false) {\n      return undefined;\n    }\n    const label = typeof p2p.label === 'string' && p2p.label.length > 0 ? p2p.label : undefined;\n    return {\n      id: 'p2p-raw-tcp',\n      nodeId: options.nodeId,\n      ...(options.baseUrl ? { canonicalUrl: options.baseUrl } : {}),\n      kind: 'p2p',\n      targetUrl: `tcp-punch://node/${encodeURIComponent(options.nodeId)}`,\n      priority: 40,\n      requiresManagedClient: true,\n      visibility: 'authorized-client',\n      health: 'healthy',\n      metadata: {\n        protocols: {\n          'raw-tcp-hole-punch': {\n            enabled: true,\n            ...(label ? { label } : {}),\n          },\n        },\n      },\n    };\n  }\n\n  private mergeHeartbeatRoutes(existing: unknown, p2pRoute: EdgeNodeP2PHeartbeatRoute): EdgeNodeP2PHeartbeatRoute[] {\n    const routes = Array.isArray(existing)\n      ? existing.filter((entry): entry is EdgeNodeP2PHeartbeatRoute => Boolean(entry) && typeof entry === 'object')\n      : [];\n    const withoutGeneratedRoute = routes.filter((route) => route.id !== p2pRoute.id);\n    return [...withoutGeneratedRoute, p2pRoute];\n  }\n\n  private normalizePositiveInteger(value: number | string | undefined): number | undefined {\n    if (typeof value === 'number' && Number.isFinite(value) && value > 0) {\n      return Math.floor(value);\n    }\n    if (typeof value === 'string') {\n      const parsed = Number(value);\n      if (Number.isFinite(parsed) && parsed > 0) {\n        return Math.floor(parsed);\n      }\n    }\n    return undefined;\n  }\n\n  private normalizeNonNegativeInteger(value: number | string | undefined): number | undefined {\n    if (typeof value === 'number' && Number.isFinite(value) && value >= 0) {\n      return Math.floor(value);\n    }\n    if (typeof value === 'string') {\n      const parsed = Number(value);\n      if (Number.isFinite(parsed) && parsed >= 0) {\n        return Math.floor(parsed);\n      }\n    }\n    return undefined;\n  }\n\n  private normalizeBoolean(value: boolean | string | undefined): boolean {\n    if (value === undefined) {\n      return true;\n    }\n    if (typeof value === 'boolean') {\n      return value;\n    }\n    const normalized = value.trim().toLowerCase();\n    return normalized === 'true' || normalized === '1' || normalized === 'yes' || normalized === 'on';\n  }\n\n  private handleHeartbeatResponse(data: unknown): void {\n    if (!data || typeof data !== 'object') {\n      return;\n    }\n    const body = data as Record<string, any>;\n    const metadata = body.metadata as Record<string, any> | undefined;\n    this.clusterCertificate?.handleHeartbeatMetadata(metadata);\n    const tunnel = metadata?.tunnel as Record<string, any> | undefined;\n    const config = tunnel?.config as Record<string, any> | undefined;\n    if (config) {\n      this.logger.debug(`接收到隧道配置: ${JSON.stringify({ entrypoint: tunnel?.entrypoint, proxyName: config.proxyName })}`);\n    }\n    const entrypoint = typeof tunnel?.entrypoint === 'string' ? tunnel.entrypoint :\n      typeof config?.publicUrl === 'string' ? config.publicUrl : undefined;\n    void this.frpManager?.applyConfig(config as any, tunnel?.status as string | undefined, entrypoint);\n  }\n\n  private async issueCertificateLocally(options: EdgeNodeAgentOptions): Promise<void> {\n    const acmeOptions = options.acme!;\n    if (!acmeOptions.email || !acmeOptions.domains || acmeOptions.domains.length === 0) {\n      throw new Error('本地 ACME 模式需要提供 email 与 domains。');\n    }\n    if (!acmeOptions.accountKeyPath) {\n      throw new Error('本地 ACME 模式需要提供 accountKeyPath。');\n    }\n    const manager = new AcmeCertificateManager({\n      signalEndpoint: options.signalEndpoint,\n      nodeId: options.nodeId,\n      nodeToken: options.nodeToken,\n      email: acmeOptions.email!,\n      domains: acmeOptions.domains!,\n      directoryUrl: acmeOptions.directoryUrl,\n      accountKeyPath: acmeOptions.accountKeyPath!,\n      certificateKeyPath: acmeOptions.certificateKeyPath,\n      certificatePath: acmeOptions.certificatePath,\n      fullChainPath: acmeOptions.fullChainPath,\n      renewBeforeDays: acmeOptions.renewBeforeDays,\n      propagationDelayMs: acmeOptions.propagationDelayMs,\n    });\n    try {\n      const issued = await manager.ensureCertificate();\n      if (issued && acmeOptions.postDeployCommand && acmeOptions.postDeployCommand.length > 0) {\n        await this.runPostDeploy(acmeOptions.postDeployCommand);\n      }\n    } catch (error: unknown) {\n      this.logger.error(`自动签发证书失败：${(error as Error).message}`);\n      throw error;\n    }\n  }\n\n  private async ensureClusterCertificate(options: EdgeNodeAgentOptions): Promise<void> {\n    const acmeOptions = options.acme!;\n    if (!acmeOptions.certificateKeyPath || !acmeOptions.certificatePath) {\n      throw new Error('Cluster 模式需要提供 certificateKeyPath 与 certificatePath。');\n    }\n    const manager = new ClusterCertificateManager({\n      signalEndpoint: options.signalEndpoint,\n      nodeId: options.nodeId,\n      nodeToken: options.nodeToken,\n      certificateKeyPath: acmeOptions.certificateKeyPath,\n      certificatePath: acmeOptions.certificatePath,\n      fullChainPath: acmeOptions.fullChainPath,\n      renewBeforeDays: acmeOptions.renewBeforeDays,\n      onCertificateInstalled: acmeOptions.postDeployCommand ? () => this.runPostDeploy(acmeOptions.postDeployCommand!) : undefined,\n    });\n    this.clusterCertificate = manager;\n    await manager.start();\n  }\n\n  private async runPostDeploy(command: string[]): Promise<void> {\n    const [ executable, ...args ] = command;\n    if (!executable) {\n      return;\n    }\n    await new Promise<void>((resolve, reject) => {\n      const child = spawn(executable, args, { stdio: 'inherit' });\n      child.on('error', reject);\n      child.on('exit', (code) => {\n        if (code === 0) {\n          resolve();\n        } else {\n          reject(new Error(`命令 ${executable} 退出码 ${code}`));\n        }\n      });\n    });\n  }\n\n  private buildTunnelHeartbeatPayload(): Record<string, unknown> | undefined {\n    const status: FrpcRuntimeStatus | undefined = this.frpManager?.getStatus();\n    if (!status) {\n      return undefined;\n    }\n    return { client: status };\n  }\n\n  /**\n   * 获取网络信息（带缓存，每分钟刷新一次）\n   */\n  private async getNetworkInfo(): Promise<{ ipv4?: string; ipv6?: string }> {\n    const now = Date.now();\n    \n    // 如果缓存过期，重新检测\n    if (!this.cachedNetworkInfo || (now - this.lastNetworkDetection) > this.networkDetectionIntervalMs) {\n      if (this.networkDetector) {\n        try {\n          this.cachedNetworkInfo = await this.networkDetector.detectNetworkAddresses();\n          this.lastNetworkDetection = now;\n        } catch (error: unknown) {\n          this.logger.debug(`Network detection failed: ${(error as Error).message}`);\n        }\n      }\n    }\n    \n    // 优先返回公网地址\n    return {\n      ipv4: this.cachedNetworkInfo?.ipv4Public ?? this.cachedNetworkInfo?.ipv4,\n      ipv6: this.cachedNetworkInfo?.ipv6Public ?? this.cachedNetworkInfo?.ipv6,\n    };\n  }\n}\n\nfunction addressEvidenceFromCandidates(candidates: Array<{ host?: string; address?: string; url?: string }>): CandidateAddressEvidence {\n  const evidence = candidates.map(candidateAddressEvidence);\n  return evidence.find((entry) => entry === 'explicit-host')\n    ?? evidence.find((entry) => entry === 'explicit-address')\n    ?? evidence.find((entry) => entry === 'signal-observed')\n    ?? evidence.find((entry) => entry === 'candidate-url')\n    ?? 'port-only';\n}\n\nfunction candidateAddressEvidence(candidate: { host?: string; address?: string; url?: string }): CandidateAddressEvidence {\n  if (candidate.host) {\n    return 'explicit-host';\n  }\n  if (candidate.address && candidate.url) {\n    return 'explicit-address';\n  }\n  if (candidate.address) {\n    return 'signal-observed';\n  }\n  if (candidate.url) {\n    return 'candidate-url';\n  }\n  return 'port-only';\n}\n"]}

package/dist/edge/EdgeNodeAgent.jsonld

@@ -4,6 +4,112 @@
   ],
   "@id": "npmd:@undefineds.co/xpod",
   "components": [
+    {
+      "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgentOptions",
+      "@type": "AbstractClass",
+      "requireElement": "EdgeNodeAgentOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgentOptions__member_signalEndpoint",
+          "memberFieldName": "signalEndpoint"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgentOptions__member_nodeId",
+          "memberFieldName": "nodeId"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgentOptions__member_nodeToken",
+          "memberFieldName": "nodeToken"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgentOptions__member_baseUrl",
+          "memberFieldName": "baseUrl"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgentOptions__member_directCandidates",
+          "memberFieldName": "directCandidates"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgentOptions__member_pods",
+          "memberFieldName": "pods"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgentOptions__member_includeSystemMetrics",
+          "memberFieldName": "includeSystemMetrics"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgentOptions__member_enableNetworkDetection",
+          "memberFieldName": "enableNetworkDetection"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgentOptions__member_metadata",
+          "memberFieldName": "metadata"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgentOptions__member_intervalMs",
+          "memberFieldName": "intervalMs"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgentOptions__member_onHeartbeatResponse",
+          "memberFieldName": "onHeartbeatResponse"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgentOptions__member_acme",
+          "memberFieldName": "acme"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgentOptions__member_frp",
+          "memberFieldName": "frp"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgentOptions__member_p2p",
+          "memberFieldName": "p2p"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeP2PAcceptEvent",
+      "@type": "AbstractClass",
+      "requireElement": "EdgeNodeP2PAcceptEvent",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeP2PAcceptEvent__member_sessionId",
+          "memberFieldName": "sessionId"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeP2PAcceptEvent__member_nodeId",
+          "memberFieldName": "nodeId"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeP2PAcceptEvent__member_clientId",
+          "memberFieldName": "clientId"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeP2PAcceptEvent__member_localCandidateCount",
+          "memberFieldName": "localCandidateCount"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeP2PAcceptEvent__member_remoteCandidateCount",
+          "memberFieldName": "remoteCandidateCount"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeP2PAcceptEvent__member_nodeAddress",
+          "memberFieldName": "nodeAddress"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeP2PAcceptEvent__member_clientAddress",
+          "memberFieldName": "clientAddress"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeP2PAcceptEvent__member_acceptedAt",
+          "memberFieldName": "acceptedAt"
+        }
+      ],
+      "constructorArguments": []
+    },
     {
       "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent",
       "@type": "Class",
@@ -38,6 +144,26 @@
           "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_lastNetworkDetection",
           "memberFieldName": "lastNetworkDetection"
         },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_p2pAcceptInterval",
+          "memberFieldName": "p2pAcceptInterval"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_p2pAcceptRunning",
+          "memberFieldName": "p2pAcceptRunning"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_p2pAcceptGeneration",
+          "memberFieldName": "p2pAcceptGeneration"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_p2pAcceptedSessionIds",
+          "memberFieldName": "p2pAcceptedSessionIds"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_p2pSocketHandles",
+          "memberFieldName": "p2pSocketHandles"
+        },
         {
           "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_networkDetectionIntervalMs",
           "memberFieldName": "networkDetectionIntervalMs"
@@ -50,6 +176,22 @@
           "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_stop",
           "memberFieldName": "stop"
         },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_startP2PAcceptLoop",
+          "memberFieldName": "startP2PAcceptLoop"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_acceptP2PConnectionOnce",
+          "memberFieldName": "acceptP2PConnectionOnce"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_skipAcceptedP2PSessions",
+          "memberFieldName": "skipAcceptedP2PSessions"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_resolveP2PApiBaseUrl",
+          "memberFieldName": "resolveP2PApiBaseUrl"
+        },
         {
           "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_stringifyIfContent",
           "memberFieldName": "stringifyIfContent"
@@ -58,6 +200,30 @@
           "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_collectSystemMetrics",
           "memberFieldName": "collectSystemMetrics"
         },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_buildHeartbeatMetadata",
+          "memberFieldName": "buildHeartbeatMetadata"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_buildP2PHeartbeatRoute",
+          "memberFieldName": "buildP2PHeartbeatRoute"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_mergeHeartbeatRoutes",
+          "memberFieldName": "mergeHeartbeatRoutes"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_normalizePositiveInteger",
+          "memberFieldName": "normalizePositiveInteger"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_normalizeNonNegativeInteger",
+          "memberFieldName": "normalizeNonNegativeInteger"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_normalizeBoolean",
+          "memberFieldName": "normalizeBoolean"
+        },
         {
           "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_handleHeartbeatResponse",
           "memberFieldName": "handleHeartbeatResponse"

package/dist/edge/EdgeNodeAgentInitializer.d.ts

@@ -1,10 +1,25 @@
 import { Initializer } from '@solid/community-server';
-import { type EdgeNodeAgentOptions } from './EdgeNodeAgent';
 /**
  * 所有配置项设为可选，以便在 disabled 状态下即使缺少 CLI 变量也能成功实例化。
  */
-export interface EdgeNodeAgentInitializerOptions extends Partial<EdgeNodeAgentOptions> {
+export interface EdgeNodeAgentInitializerOptions {
     enabled?: boolean | string;
+    signalEndpoint?: string;
+    nodeId?: string;
+    nodeToken?: string;
+    baseUrl?: string;
+    directCandidates?: string | string[];
+    pods?: string[];
+    includeSystemMetrics?: boolean;
+    enableNetworkDetection?: boolean;
+    metadata?: Record<string, unknown>;
+    intervalMs?: number | string;
+    p2pEnabled?: boolean | string;
+    p2pTargetBaseUrl?: string;
+    p2pLabel?: string;
+    p2pAcceptIntervalMs?: number | string;
+    p2pConnectTimeoutMs?: number | string;
+    p2pWinnerSelectionWindowMs?: number | string;
 }
 /**
  * Initializer that starts the EdgeNodeAgent.
@@ -21,5 +36,8 @@ export declare class EdgeNodeAgentInitializer extends Initializer {
      * 确保启用时必需参数存在
      */
     private validateOptions;
+    private buildAgentOptions;
     private normalizeBoolean;
+    private normalizePositiveInteger;
+    private normalizeNonNegativeInteger;
 }