@steve02081504/fount-p2p 0.0.22 → 0.0.24

package/registries/inbound.mjs

@@ -1,4 +1,18 @@
-/** @typedef {import('../wire/part_invoke.mjs').PartInvokeResponse} PartInvokeResponse */
+/**
+ * @typedef {{ message: string, code: string }} PartInvokeError
+ */
+
+/**
+ * @typedef {object} PartInvokeResultResponse
+ * @property {unknown} result
+ */
+
+/**
+ * @typedef {object} PartInvokeErrorResponse
+ * @property {PartInvokeError} error
+ */
+
+/** @typedef {PartInvokeResultResponse | PartInvokeErrorResponse} PartInvokeResponse */
 
 /**
  * @typedef {{
@@ -29,7 +43,7 @@ const deliveryHandlers = new Map()
  * @returns {void}
  */
 export function registerRpcInboundHandler(type, handler) {
-	rpcHandlers.set(String(type || '').trim(), handler)
+	rpcHandlers.set(type, handler)
 }
 
 /**
@@ -38,7 +52,7 @@ export function registerRpcInboundHandler(type, handler) {
  * @returns {void}
  */
 export function registerDeliveryInboundHandler(type, handler) {
-	deliveryHandlers.set(String(type || '').trim(), handler)
+	deliveryHandlers.set(type, handler)
 }
 
 /**
@@ -47,9 +61,7 @@ export function registerDeliveryInboundHandler(type, handler) {
  * @returns {Promise<PartInvokeResponse | null>} 处理器返回值
  */
 export async function dispatchRpcInbound(inboundContext, message) {
-	const type = String(message?.type || '').trim()
-	if (!type) return null
-	const handler = rpcHandlers.get(type)
+	const handler = rpcHandlers.get(message.type)
 	if (!handler) return null
 	return handler(inboundContext, message)
 }
@@ -60,9 +72,7 @@ export async function dispatchRpcInbound(inboundContext, message) {
  * @returns {Promise<void>}
  */
 export async function dispatchDeliveryInbound(inboundContext, message) {
-	const type = String(message?.type || '').trim()
-	if (!type) return
-	const handler = deliveryHandlers.get(type)
+	const handler = deliveryHandlers.get(message.type)
 	if (!handler) return
 	await handler(inboundContext, message)
 }

package/registries/part_path.mjs

@@ -1,5 +1,3 @@
-import { normalizePartpath } from '../wire/part_invoke.mjs'
-
 /** @type {Map<string, string>} shell 逻辑名 → partpath */
 const shellPartpaths = new Map()
 
@@ -10,10 +8,7 @@ const shellPartpaths = new Map()
  * @returns {void}
  */
 export function registerShellPartpath(shellKey, partpath) {
-	const key = String(shellKey || '').trim()
-	const path = normalizePartpath(partpath)
-	if (!key || !path) throw new Error('invalid_shell_partpath_registration')
-	shellPartpaths.set(key, path)
+	shellPartpaths.set(shellKey, partpath)
 }
 
 /**
@@ -21,7 +16,7 @@ export function registerShellPartpath(shellKey, partpath) {
  * @returns {void}
  */
 export function unregisterShellPartpath(shellKey) {
-	shellPartpaths.delete(String(shellKey || '').trim())
+	shellPartpaths.delete(shellKey)
 }
 
 /**
@@ -29,7 +24,7 @@ export function unregisterShellPartpath(shellKey) {
  * @returns {string} 已注册的 partpath
  */
 export function getShellPartpath(shellKey) {
-	const path = shellPartpaths.get(String(shellKey || '').trim())
+	const path = shellPartpaths.get(shellKey)
 	if (!path) throw new Error(`shell partpath not registered: ${shellKey}`)
 	return path
 }

package/schemas/discovery.mjs

@@ -1,5 +1,5 @@
 import { assertHex64, isHex64, isSignatureHex128, normalizeHex64 } from '../core/hexIds.mjs'
-import { isPlainObject } from '../wire/ingress.mjs'
+import { isPlainObject } from '../core/object.mjs'
 
 const MAX_DISCOVERY_ADS = 64
 

package/schemas/federation_pull.mjs

@@ -2,8 +2,8 @@
  * 联邦补拉 attestation / HPKE 响应 wire 解析（无 attestation/envelope 即丢弃）。
  */
 import { isHex64, isSignatureHex128, normalizeHex64 } from '../core/hexIds.mjs'
+import { isPlainObject } from '../core/object.mjs'
 import { EVENT_ID_HEX } from '../dag/index.mjs'
-import { isPlainObject } from '../wire/ingress.mjs'
 
 /** @typedef {{ requesterPubKeyHash: string, groupId: string, requestId: string, timestamp: number, wantIds?: string[], signature: string }} PullAttestation */
 

package/schemas/part_query.mjs

@@ -2,9 +2,10 @@ import { Buffer } from 'node:buffer'
 
 import { canonicalStringify } from '../core/canonical_json.mjs'
 import { isHex64, normalizeHex64 } from '../core/hexIds.mjs'
-import { isPlainObject } from '../wire/ingress.mjs'
-import { normalizePartpath } from '../wire/part_invoke.mjs'
-import partQueryTunables from '../wire/part_query.tunables.json' with { type: 'json' }
+import { isPlainObject } from '../core/object.mjs'
+import { parsePartpath } from '../core/partpath.mjs'
+
+import partQueryTunables from './part_query.tunables.json' with { type: 'json' }
 
 /**
  * @typedef {{
@@ -100,7 +101,7 @@ export function parsePartQueryReq(value, tunables = partQueryTunables) {
 	if (!requestId) return null
 	const originNodeHash = normalizeHex64(value.originNodeHash)
 	if (!isHex64(originNodeHash)) return null
-	const partpath = normalizePartpath(value.partpath)
+	const partpath = parsePartpath(value.partpath)
 	if (!partpath) return null
 	const kind = String(value.kind || '').trim()
 	if (!kind) return null
@@ -143,7 +144,7 @@ export function parsePartQueryRes(value, tunables = partQueryTunables) {
  * @returns {string | null} 规范化三元组的缓存材料；非法 null
  */
 export function normalizePartQueryCacheMaterial(partpath, kind, query) {
-	const path = normalizePartpath(partpath)
+	const path = parsePartpath(partpath)
 	const k = String(kind || '').trim()
 	if (!path || !k) return null
 	if (measureJsonBytes(query) > partQueryTunables.maxQueryBytes) return null

package/transport/group_link_set.mjs

@@ -1,9 +1,9 @@
+import { noteAdvertPeerHints } from '../discovery/advert_peer_hints.mjs'
 import { listVisibleNodeHashes, startGroupPresence, watchVerifiedGroupAdverts } from '../discovery/index.mjs'
 import { loadPeerPoolView } from '../node/network.mjs'
 import { loadReputation } from '../node/reputation_store.mjs'
 import { emitSafe } from '../utils/emit_safe.mjs'
 
-import { applyAdvertPeerHints } from './advert_ingest.mjs'
 import { getLinkRegistry } from './link_registry.mjs'
 import { resolveFederationPoolLimits, selectLinkTargetsFromMembers } from './peer_pool.mjs'
 import { loadTransportTunables } from './tunables.mjs'
@@ -208,7 +208,7 @@ export function createGroupLinkSet(options) {
 		registerCleanup(await watchVerifiedGroupAdverts(roomSecret, async (verifiedNodeHash, body, meta) => {
 			if (verifiedNodeHash === selfNodeHash) return
 			if (!allowNode(verifiedNodeHash)) return
-			applyAdvertPeerHints(verifiedNodeHash, body, meta)
+			noteAdvertPeerHints(verifiedNodeHash, body, meta)
 			notePeerCandidate(verifiedNodeHash)
 		}))
 

package/transport/link_registry.mjs

@@ -2,6 +2,7 @@ import { Buffer } from 'node:buffer'
 
 import { compareHex64Asc, normalizeHex64 } from '../core/hexIds.mjs'
 import { keyPairFromSeed } from '../crypto/crypto.mjs'
+import { noteAdvertPeerHints } from '../discovery/advert_peer_hints.mjs'
 import { watchVerifiedNodeAdvert, setDiscoveryLinkDialer, prepareConnectToNode } from '../discovery/index.mjs'
 import { setDiscoveryPeerClueListener } from '../discovery/peer_clue.mjs'
 import { listLinkProviders } from '../link/providers/index.mjs'
@@ -13,7 +14,6 @@ import { ms } from '../utils/duration.mjs'
 import { emitSafe } from '../utils/emit_safe.mjs'
 import { createLruMap } from '../utils/lru.mjs'
 
-import { applyAdvertPeerHints } from './advert_ingest.mjs'
 import { DEFAULT_ICE_SERVERS } from './ice_servers.mjs'
 import { createMeshKeepalive } from './mesh_keepalive.mjs'
 import { createOfferAnswerDial } from './offer_answer.mjs'
@@ -650,7 +650,7 @@ export function createLinkRegistry(options = {}) {
 		async watchNodeAdvert(nodeHash, onAdvert) {
 			const hash = normalizeHex64(nodeHash)
 			return await watchVerifiedNodeAdvert(hash, async (verifiedNodeHash, body, meta) => {
-				applyAdvertPeerHints(verifiedNodeHash, body, meta)
+				noteAdvertPeerHints(verifiedNodeHash, body, meta)
 				recentAdverts.touch(verifiedNodeHash, Date.now())
 				dialCooldown.delete(verifiedNodeHash)
 				await Promise.resolve(onAdvert(verifiedNodeHash, body))

package/transport/node_scope/features.mjs

@@ -0,0 +1,166 @@
+import { attachNodeScopeFedResponder } from '../../files/fed/responder.mjs'
+import { attachMailboxWire } from '../../mailbox/wire.mjs'
+import { attachPartWire } from '../../wire/part/ingress.mjs'
+import { attachPartQueryWire } from '../../wire/part/query.mjs'
+
+import {
+	clearNodeScopeSubscribe,
+	ensureNodeScope,
+	getNodeScopeContext,
+	getNodeScopeWire,
+} from './wire.mjs'
+
+/** @typedef {import('./wire.mjs').NodeScopeWire} NodeScopeWire */
+/** @typedef {import('./wire.mjs').NodeScopeContext} NodeScopeContext */
+
+/** @type {Set<() => void>} */
+const nodeScopeFeatureDisposers = new Set()
+
+/** @type {Map<string, { count: number, disposeCore: () => void }>} */
+const featureAttachRefs = new Map()
+
+/**
+ * @param {() => void} dispose - feature 卸载函数
+ * @returns {() => void} 包装后的 dispose（同时从跟踪集移除）
+ */
+function trackFeatureDisposer(dispose) {
+	nodeScopeFeatureDisposers.add(dispose)
+	return () => {
+		dispose()
+		nodeScopeFeatureDisposers.delete(dispose)
+	}
+}
+
+/**
+ * 同一 feature 多次 attach 共享一份 wire；dispose 引用计数归零才卸。
+ * @param {string} key - feature 去重键
+ * @param {() => () => void} attachCore - 首次 attach 时执行，返回核心 dispose
+ * @returns {() => void} 引用计数包装的 dispose
+ */
+function attachFeatureRefCounted(key, attachCore) {
+	let entry = featureAttachRefs.get(key)
+	if (!entry) {
+		entry = { count: 0, disposeCore: attachCore() }
+		featureAttachRefs.set(key, entry)
+	}
+	entry.count++
+	return trackFeatureDisposer(() => {
+		const current = featureAttachRefs.get(key)
+		if (!current) return
+		current.count--
+		if (current.count > 0) return
+		current.disposeCore()
+		featureAttachRefs.delete(key)
+	})
+}
+
+/**
+ * @param {string} key - feature 去重键
+ * @param {(wire: NodeScopeWire, context: NodeScopeContext) => () => void} attachCore - 首次 attach
+ * @param {{ replicaUsername?: string }} [options] - 可选副本用户名
+ * @returns {() => void} 引用计数包装的 dispose
+ */
+export function attachNodeScopeFeature(key, attachCore, options = {}) {
+	ensureNodeScope(options)
+	return attachFeatureRefCounted(key, () => attachCore(getNodeScopeWire(), getNodeScopeContext()))
+}
+
+/** @type {Record<string, (wire: NodeScopeWire, context: NodeScopeContext) => () => void>} */
+const builtinFeatures = {
+	/**
+	 * @param {NodeScopeWire} wire node scope wire
+	 * @param {NodeScopeContext} context 入站上下文
+	 * @returns {() => void} 取消挂载的 dispose
+	 */
+	mailbox: (wire, context) => attachMailboxWire(context, wire),
+	/**
+	 * @param {NodeScopeWire} wire node scope wire
+	 * @param {NodeScopeContext} context 入站上下文
+	 * @returns {() => void} 取消挂载的 dispose
+	 */
+	part: (wire, context) => attachPartWire(context, wire),
+	/**
+	 * @param {NodeScopeWire} wire node scope wire
+	 * @param {NodeScopeContext} context 入站上下文
+	 * @returns {() => void} 取消挂载的 dispose
+	 */
+	partQuery: (wire, context) => attachPartQueryWire(context, wire),
+	/**
+	 * @param {NodeScopeWire} wire node scope wire
+	 * @returns {() => void} 取消挂载的 dispose
+	 */
+	chunks: wire => attachNodeScopeFedResponder(wire),
+}
+
+/**
+ * @param {keyof typeof builtinFeatures} key - 内置 feature 名
+ * @param {{ replicaUsername?: string }} [options] - 可选副本用户名
+ * @returns {() => void} 引用计数包装的 dispose
+ */
+function attachBuiltin(key, options = {}) {
+	return attachNodeScopeFeature(key, builtinFeatures[key], options)
+}
+
+/**
+ * @param {{ replicaUsername?: string }} [options] - 可选副本用户名
+ * @returns {() => void} 取消挂载的 dispose
+ */
+export function attachNodeScopeMailbox(options = {}) {
+	return attachBuiltin('mailbox', options)
+}
+
+/**
+ * @param {{ replicaUsername?: string }} [options] - 可选副本用户名
+ * @returns {() => void} 取消挂载的 dispose
+ */
+export function attachNodeScopePart(options = {}) {
+	return attachBuiltin('part', options)
+}
+
+/**
+ * @param {{ replicaUsername?: string }} [options] - 可选副本用户名
+ * @returns {() => void} 取消挂载的 dispose
+ */
+export function attachNodeScopePartQuery(options = {}) {
+	return attachBuiltin('partQuery', options)
+}
+
+/**
+ * @param {{ replicaUsername?: string }} [options] - 可选副本用户名
+ * @returns {() => void} 取消挂载的 dispose
+ */
+export function attachNodeScopeChunks(options = {}) {
+	return attachBuiltin('chunks', options)
+}
+
+/**
+ * 全业务 preset（part / partQuery / mailbox / chunks）。
+ * @param {{ replicaUsername?: string }} [options] - 可选副本用户名
+ * @returns {() => void} 取消全部 preset 挂载的 dispose
+ */
+export function attachNodeScopeDefaultFeatures(options = {}) {
+	const disposers = [
+		attachNodeScopePart(options),
+		attachNodeScopePartQuery(options),
+		attachNodeScopeMailbox(options),
+		attachNodeScopeChunks(options),
+	]
+	return () => {
+		for (const dispose of disposers) dispose()
+	}
+}
+
+/**
+ * 卸掉 feature 挂载；可选保留 node scope 订阅。
+ * @param {{ keepSubscribe?: boolean }} [options] - true 时保留 node scope 订阅
+ * @returns {void}
+ */
+export function stopNodeScopeRuntime(options = {}) {
+	for (const dispose of [...nodeScopeFeatureDisposers]) dispose()
+	nodeScopeFeatureDisposers.clear()
+	for (const entry of featureAttachRefs.values())
+		try { entry.disposeCore() } catch { /* ignore */ }
+	featureAttachRefs.clear()
+	if (options.keepSubscribe) return
+	clearNodeScopeSubscribe()
+}

package/transport/node_scope/wire.mjs

@@ -0,0 +1,124 @@
+import { subscribeScope, sendToNodeLink } from '../link_registry.mjs'
+
+/** @typedef {import('../../wire/adapter.mjs').WireAdapter} NodeScopeWire */
+/** @typedef {{ replicaUsername: string }} NodeScopeContext */
+
+/** @type {Map<string, Set<(payload: unknown, peerId: string) => void>>} */
+const nodeActionHandlers = new Map()
+
+/** @type {NodeScopeContext} */
+const nodeScopeContext = { replicaUsername: '' }
+
+/** @type {NodeScopeWire | null} */
+let nodeScopeWire = null
+
+/** @type {(() => void) | null} */
+let nodeScopeSubscribeCleanup = null
+
+/**
+ * @returns {NodeScopeWire} node scope 的 wire 适配器
+ */
+function createNodeScopeWire() {
+	return {
+		/**
+		 * @param {string} name action 名
+		 * @param {(payload: unknown, peerId: string) => void} handler 回调
+		 * @returns {() => void} 取消订阅
+		 */
+		on(name, handler) {
+			if (!nodeActionHandlers.has(name)) nodeActionHandlers.set(name, new Set())
+			nodeActionHandlers.get(name).add(handler)
+			return () => {
+				const set = nodeActionHandlers.get(name)
+				if (!set) return
+				set.delete(handler)
+				if (!set.size) nodeActionHandlers.delete(name)
+			}
+		},
+		/**
+		 * @param {string} name action 名
+		 * @param {unknown} payload 载荷
+		 * @param {string} peerId 目标 peer
+		 * @returns {void}
+		 */
+		send(name, payload, peerId) {
+			if (!peerId) return
+			void sendToNodeLink(peerId, { scope: 'node', action: name, payload }).catch(() => { })
+		},
+	}
+}
+
+/**
+ * @param {string} action - action 名
+ * @returns {boolean} 是否已挂载处理器
+ */
+export function hasNodeScopeAction(action) {
+	return (nodeActionHandlers.get(action)?.size ?? 0) > 0
+}
+
+/**
+ * @param {string} action - action 名
+ * @returns {number} 已注册的处理器数量
+ */
+export function countNodeScopeActionHandlers(action) {
+	return nodeActionHandlers.get(action)?.size ?? 0
+}
+
+/**
+ * 测试/调试：直接派发已挂载的 node action。
+ * @param {string} action - action 名
+ * @param {unknown} payload - 载荷
+ * @param {string} peerId - 发送方 nodeHash
+ * @returns {boolean} 是否有处理器被调用
+ */
+export function dispatchNodeScopeAction(action, payload, peerId) {
+	const handlers = nodeActionHandlers.get(action)
+	if (!handlers?.size) return false
+	for (const handler of handlers)
+		try { handler(payload, peerId) } catch { /* ignore */ }
+	return true
+}
+
+/**
+ * @returns {NodeScopeWire | null} 当前 wire，未 ensure 时为 null
+ */
+export function getNodeScopeWire() {
+	return nodeScopeWire
+}
+
+/**
+ * @returns {NodeScopeContext} 可变 node scope 上下文
+ */
+export function getNodeScopeContext() {
+	return nodeScopeContext
+}
+
+/**
+ * 只订阅 node scope 派发，不挂任何 feature。
+ * @param {{ replicaUsername?: string }} [options] - 可选副本用户名
+ * @returns {() => void} 取消订阅的 dispose
+ */
+export function ensureNodeScope(options = {}) {
+	if (options.replicaUsername != null)
+		nodeScopeContext.replicaUsername = String(options.replicaUsername)
+	if (nodeScopeSubscribeCleanup) return nodeScopeSubscribeCleanup
+	nodeScopeSubscribeCleanup = subscribeScope('node', (senderNodeHash, envelope) => {
+		const handlers = nodeActionHandlers.get(envelope.action)
+		if (!handlers?.size) return
+		for (const handler of handlers)
+			try { handler(envelope.payload, senderNodeHash) } catch { /* ignore */ }
+	})
+	nodeScopeWire ||= createNodeScopeWire()
+	return nodeScopeSubscribeCleanup
+}
+
+/**
+ * 卸掉 scope 订阅与 wire（feature 须先卸）。
+ * @returns {void}
+ */
+export function clearNodeScopeSubscribe() {
+	nodeScopeSubscribeCleanup?.()
+	nodeScopeSubscribeCleanup = null
+	nodeScopeWire = null
+	nodeActionHandlers.clear()
+}

package/transport/remote_user_room.mjs

@@ -28,7 +28,6 @@ registerFederationRoomProvider('remote-user-room', () => {
  * @returns {Promise<RemoteUserRoomSlot>} 房间槽
  */
 export async function ensureRemoteUserRoom(username, targetNodeHash) {
-	void username
 	const key = targetNodeHash.toLowerCase()
 	const existing = slots.get(key)
 	if (existing) return existing

package/{rooms → transport}/scoped_link.mjs

@@ -1,4 +1,4 @@
-import { createGroupLinkSet } from '../transport/group_link_set.mjs'
+import { createGroupLinkSet } from './group_link_set.mjs'
 
 /**
  * scoped 房间：group_link_set 的薄预设（任意 scope + allowNode + 发现即拨）。

package/transport/user_room.mjs

@@ -5,21 +5,12 @@ import { registerFederationRoomProvider } from '../registries/room_provider.mjs'
 import { shuffleInPlace } from '../utils/shuffle.mjs'
 
 import { getLinkRegistry, listLinks, sendToNodeLink } from './link_registry.mjs'
-import {
-	attachUserRoomDefaultWires,
-	ensureNodeScope,
-} from './node_scope.mjs'
+import { attachNodeScopeDefaultFeatures } from './node_scope/features.mjs'
+import { ensureNodeScope } from './node_scope/wire.mjs'
 import { USER_ROOM_SCOPE } from './room_scopes.mjs'
 
-/**
- * 经 node scope 向对端发 action。
- * @param {string} peerId 对端 nodeHash
- * @param {string} action 动作名
- * @param {unknown} payload 载荷
- * @returns {Promise<boolean>} 是否发出
- */
-const sendNodeAction = (peerId, action, payload) =>
-	sendToNodeLink(peerId, { scope: 'node', action, payload })
+/** User Room 随机 peer 转发默认上限 */
+const USER_ROOM_PEER_FANOUT_DEFAULT = 6
 
 /** @type {Promise<UserRoomSlot> | null} */
 let userRoomInflight = null
@@ -50,7 +41,7 @@ export function activeLinkRoster() {
  *   roomId: string
  *   roomSecret: string
  *   room: object | null
- *   sendToPeer: (peerId: string, actionName: string, payload: unknown) => void
+ *   sendToPeer: (peerId: string, actionName: string, payload: unknown) => Promise<boolean>
  *   getRoster: () => Array<{ peerId: string, remoteNodeHash: string | undefined }>
  *   getPeerIdByNodeHash: (nodeHash: string) => string | null
  * }} UserRoomSlot
@@ -74,7 +65,7 @@ registerFederationRoomProvider('user-room', () => {
 		 * @param {string} peerId - 目标 peer
 		 * @param {string} actionName - node scope action 名
 		 * @param {unknown} payload - 载荷
-		 * @returns {void}
+		 * @returns {Promise<boolean>} 是否发出
 		 */
 		sendToPeer: (peerId, actionName, payload) => slot.sendToPeer(peerId, actionName, payload),
 	}]
@@ -95,7 +86,7 @@ export function resolveUserRoomCredentials() {
 }
 
 /**
- * 用户房间槽 + runtime；默认不挂业务 wire（用 `attachUserRoomDefaultWires` / `attachDefaultWires: true`）。
+ * 用户房间槽 + runtime；默认不挂业务 wire（用 `attachNodeScopeDefaultFeatures` / `attachDefaultWires: true`）。
  * @param {{ replicaUsername?: string, attachDefaultWires?: boolean }} [options] - 副本用户名与是否挂载默认 wire
  * @returns {Promise<UserRoomSlot>} 用户房间槽
  */
@@ -105,7 +96,7 @@ export async function ensureUserRoom(options = {}) {
 		ensureNodeScope({ replicaUsername: options.replicaUsername })
 	if (userRoomSlot) {
 		if (attachDefaultWires && !userRoomDefaultWiresDispose)
-			userRoomDefaultWiresDispose = attachUserRoomDefaultWires({ replicaUsername: options.replicaUsername })
+			userRoomDefaultWiresDispose = attachNodeScopeDefaultFeatures({ replicaUsername: options.replicaUsername })
 		return userRoomSlot
 	}
 	if (userRoomInflight) return await userRoomInflight
@@ -115,7 +106,7 @@ export async function ensureUserRoom(options = {}) {
 		await getLinkRegistry().ensureRuntime()
 		ensureNodeScope({ replicaUsername: options.replicaUsername })
 		if (attachDefaultWires && !userRoomDefaultWiresDispose)
-			userRoomDefaultWiresDispose = attachUserRoomDefaultWires({ replicaUsername: options.replicaUsername })
+			userRoomDefaultWiresDispose = attachNodeScopeDefaultFeatures({ replicaUsername: options.replicaUsername })
 		const creds = resolveUserRoomCredentials()
 		userRoomSlot = {
 			roomId: creds.roomId,
@@ -125,10 +116,10 @@ export async function ensureUserRoom(options = {}) {
 			 * @param {string} peerId - 目标 peer
 			 * @param {string} actionName - node scope action 名
 			 * @param {unknown} payload - 载荷
-			 * @returns {void}
+			 * @returns {Promise<boolean>} 是否发出
 			 */
 			sendToPeer(peerId, actionName, payload) {
-				void sendNodeAction(peerId, actionName, payload).catch(() => { })
+				return sendToNodeLink(peerId, { scope: 'node', action: actionName, payload }).catch(() => false)
 			},
 			/**
 			 * @returns {Array<{ peerId: string, remoteNodeHash: string }>} 当前活跃链路 roster
@@ -162,16 +153,15 @@ export async function ensureUserRoom(options = {}) {
  * @returns {Promise<number>} 成功转发的 peer 数
  */
 export async function deliverToUserRoomPeers(username, actionName, payload, exceptPeerId = null, limit) {
-	void username
-	const { USER_ROOM_PEER_FANOUT_DEFAULT } = await import('../wire/part_common.mjs')
 	const fanoutLimit = limit ?? USER_ROOM_PEER_FANOUT_DEFAULT
-	const body = { ...payload, nodeHash: getNodeHash() }
+	if (fanoutLimit <= 0) return 0
+	const slot = await ensureUserRoom({ replicaUsername: username })
 	let sent = 0
-	const peers = shuffleInPlace(activeLinkRoster()
+	const peers = shuffleInPlace(slot.getRoster()
 		.filter(({ peerId }) => peerId && peerId !== exceptPeerId))
 	for (const { peerId } of peers)
 		try {
-			if (await sendNodeAction(peerId, actionName, body))
+			if (await slot.sendToPeer(peerId, actionName, { ...payload, nodeHash: getNodeHash() }))
 				sent++
 			if (sent >= fanoutLimit) break
 		}
@@ -179,6 +169,3 @@ export async function deliverToUserRoomPeers(username, actionName, payload, exce
 
 	return sent
 }
-
-/** 再导出：node-scope 订阅与默认 wires（见 `node_scope.mjs`）。 */
-export { attachUserRoomDefaultWires, ensureNodeScope } from './node_scope.mjs'