@silicaclaw/cli 2026.3.19-9 → 2026.3.20-10

package/apps/local-console/dist/config/silicaclaw-defaults.json

@@ -0,0 +1,19 @@
+{
+    "ports": {
+        "local_console": 4310,
+        "public_explorer": 4311,
+        "openclaw_gateway": 18789,
+        "network_default": 44123
+    },
+    "network": {
+        "default_mode": "global-preview",
+        "default_namespace": "silicaclaw.preview",
+        "global_preview": {
+            "relay_url": "https://relay.silicaclaw.com",
+            "room": "silicaclaw-global-preview"
+        }
+    },
+    "bridge": {
+        "api_base": "http://localhost:4310"
+    }
+}

package/apps/local-console/dist/packages/core/src/index.d.ts

@@ -4,6 +4,8 @@ export * from "./identity";
 export * from "./profile";
 export * from "./presence";
 export * from "./socialMessage";
+export * from "./privateCrypto";
+export * from "./privateMessage";
 export * from "./indexing";
 export * from "./directory";
 export * from "./publicProfileSummary";

package/apps/local-console/dist/packages/core/src/index.js

@@ -20,6 +20,8 @@ __exportStar(require("./identity"), exports);
 __exportStar(require("./profile"), exports);
 __exportStar(require("./presence"), exports);
 __exportStar(require("./socialMessage"), exports);
+__exportStar(require("./privateCrypto"), exports);
+__exportStar(require("./privateMessage"), exports);
 __exportStar(require("./indexing"), exports);
 __exportStar(require("./directory"), exports);
 __exportStar(require("./publicProfileSummary"), exports);

package/apps/local-console/dist/packages/core/src/privateCrypto.d.ts

@@ -0,0 +1,17 @@
+import { PrivateEncryptionKeyPair } from "./types";
+export declare function createPrivateEncryptionKeyPair(now?: number): PrivateEncryptionKeyPair;
+export declare function encryptPrivatePayload(input: {
+    plaintext: string;
+    recipient_public_key: string;
+    sender_keypair?: PrivateEncryptionKeyPair | null;
+}): {
+    ciphertext: string;
+    nonce: string;
+    sender_encryption_public_key: string;
+};
+export declare function decryptPrivatePayload(input: {
+    ciphertext: string;
+    nonce: string;
+    sender_encryption_public_key: string;
+    recipient_private_key: string;
+}): string | null;

package/apps/local-console/dist/packages/core/src/privateCrypto.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPrivateEncryptionKeyPair = createPrivateEncryptionKeyPair;
+exports.encryptPrivatePayload = encryptPrivatePayload;
+exports.decryptPrivatePayload = decryptPrivatePayload;
+const tweetnacl_1 = __importDefault(require("tweetnacl"));
+const crypto_1 = require("./crypto");
+function createPrivateEncryptionKeyPair(now = Date.now()) {
+    const pair = tweetnacl_1.default.box.keyPair();
+    return {
+        public_key: (0, crypto_1.toBase64)(pair.publicKey),
+        private_key: (0, crypto_1.toBase64)(pair.secretKey),
+        created_at: now,
+    };
+}
+function encryptPrivatePayload(input) {
+    const sender = input.sender_keypair || createPrivateEncryptionKeyPair();
+    const nonce = tweetnacl_1.default.randomBytes(tweetnacl_1.default.box.nonceLength);
+    const message = Buffer.from(String(input.plaintext || ""), "utf8");
+    const ciphertext = tweetnacl_1.default.box(new Uint8Array(message), nonce, (0, crypto_1.fromBase64)(input.recipient_public_key), (0, crypto_1.fromBase64)(sender.private_key));
+    return {
+        ciphertext: (0, crypto_1.toBase64)(ciphertext),
+        nonce: (0, crypto_1.toBase64)(nonce),
+        sender_encryption_public_key: sender.public_key,
+    };
+}
+function decryptPrivatePayload(input) {
+    try {
+        const opened = tweetnacl_1.default.box.open((0, crypto_1.fromBase64)(input.ciphertext), (0, crypto_1.fromBase64)(input.nonce), (0, crypto_1.fromBase64)(input.sender_encryption_public_key), (0, crypto_1.fromBase64)(input.recipient_private_key));
+        if (!opened)
+            return null;
+        return Buffer.from(opened).toString("utf8");
+    }
+    catch {
+        return null;
+    }
+}

package/apps/local-console/dist/packages/core/src/privateMessage.d.ts

@@ -0,0 +1,23 @@
+import { AgentIdentity, PrivateMessageReceiptRecord, PrivateMessageRecord } from "./types";
+export declare function signPrivateMessage(input: {
+    identity: AgentIdentity;
+    message_id: string;
+    conversation_id: string;
+    to_agent_id: string;
+    sender_encryption_public_key: string;
+    recipient_encryption_public_key: string;
+    ciphertext: string;
+    nonce: string;
+    created_at?: number;
+}): PrivateMessageRecord;
+export declare function verifyPrivateMessage(record: PrivateMessageRecord): boolean;
+export declare function signPrivateMessageReceipt(input: {
+    identity: AgentIdentity;
+    receipt_id: string;
+    message_id: string;
+    conversation_id: string;
+    to_agent_id: string;
+    status: "received" | "read";
+    created_at?: number;
+}): PrivateMessageReceiptRecord;
+export declare function verifyPrivateMessageReceipt(record: PrivateMessageReceiptRecord): boolean;

package/apps/local-console/dist/packages/core/src/privateMessage.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signPrivateMessage = signPrivateMessage;
+exports.verifyPrivateMessage = verifyPrivateMessage;
+exports.signPrivateMessageReceipt = signPrivateMessageReceipt;
+exports.verifyPrivateMessageReceipt = verifyPrivateMessageReceipt;
+const crypto_1 = require("./crypto");
+function unsignedPrivateMessage(record) {
+    const { signature: _signature, ...rest } = record;
+    return rest;
+}
+function unsignedPrivateMessageReceipt(record) {
+    const { signature: _signature, ...rest } = record;
+    return rest;
+}
+function signPrivateMessage(input) {
+    const payload = {
+        type: "private.message",
+        message_id: input.message_id,
+        conversation_id: input.conversation_id,
+        from_agent_id: input.identity.agent_id,
+        to_agent_id: input.to_agent_id,
+        sender_public_key: input.identity.public_key,
+        sender_encryption_public_key: input.sender_encryption_public_key,
+        recipient_encryption_public_key: input.recipient_encryption_public_key,
+        cipher_scheme: "nacl-box-v1",
+        ciphertext: input.ciphertext,
+        nonce: input.nonce,
+        created_at: input.created_at ?? Date.now(),
+    };
+    return {
+        ...payload,
+        signature: (0, crypto_1.signPayload)(payload, input.identity.private_key),
+    };
+}
+function verifyPrivateMessage(record) {
+    try {
+        if ((0, crypto_1.hashPublicKey)((0, crypto_1.fromBase64)(record.sender_public_key)) !== record.from_agent_id) {
+            return false;
+        }
+        return (0, crypto_1.verifyPayload)(unsignedPrivateMessage(record), record.signature, record.sender_public_key);
+    }
+    catch {
+        return false;
+    }
+}
+function signPrivateMessageReceipt(input) {
+    const payload = {
+        type: "private.message.receipt",
+        receipt_id: input.receipt_id,
+        message_id: input.message_id,
+        conversation_id: input.conversation_id,
+        from_agent_id: input.identity.agent_id,
+        to_agent_id: input.to_agent_id,
+        sender_public_key: input.identity.public_key,
+        status: input.status,
+        created_at: input.created_at ?? Date.now(),
+    };
+    return {
+        ...payload,
+        signature: (0, crypto_1.signPayload)(payload, input.identity.private_key),
+    };
+}
+function verifyPrivateMessageReceipt(record) {
+    try {
+        if ((0, crypto_1.hashPublicKey)((0, crypto_1.fromBase64)(record.sender_public_key)) !== record.from_agent_id) {
+            return false;
+        }
+        return (0, crypto_1.verifyPayload)(unsignedPrivateMessageReceipt(record), record.signature, record.sender_public_key);
+    }
+    catch {
+        return false;
+    }
+}

package/apps/local-console/dist/packages/core/src/profile.js

@@ -15,6 +15,7 @@ function signProfile(input, identity) {
         bio: input.bio,
         tags: input.tags,
         avatar_url: input.avatar_url,
+        private_encryption_public_key: input.private_encryption_public_key,
         public_enabled: input.public_enabled,
         updated_at: Date.now(),
     };
@@ -34,6 +35,7 @@ function createDefaultProfileInput(agentId) {
         bio: "",
         tags: [],
         avatar_url: "",
+        private_encryption_public_key: "",
         public_enabled: false,
     };
 }

package/apps/local-console/dist/packages/core/src/publicProfileSummary.d.ts

@@ -7,9 +7,11 @@ export type ProfileVisibility = {
 };
 export type PublicProfileSummary = {
     agent_id: string;
+    is_self: boolean;
     display_name: string;
     bio: string;
     avatar_url?: string;
+    private_encryption_public_key?: string;
     public_enabled: boolean;
     updated_at: number;
     online: boolean;
@@ -30,6 +32,7 @@ export type PublicProfileSummary = {
         display_name: string;
         bio: string;
         avatar_url?: string;
+        private_encryption_public_key?: string;
         tags: string[];
         public_enabled: boolean;
         profile_version: string;
@@ -57,6 +60,7 @@ export type PublicProfileSummary = {
 export declare function deriveCapabilitiesSummary(tags: string[]): string[];
 export declare function buildPublicProfileSummary(args: {
     profile: PublicProfile;
+    is_self?: boolean;
     online: boolean;
     last_seen_at: number | null;
     network_mode?: string;

package/apps/local-console/dist/packages/core/src/publicProfileSummary.js

@@ -53,9 +53,11 @@ function buildPublicProfileSummary(args) {
     ].filter((field) => Boolean(field));
     return {
         agent_id: args.profile.agent_id,
+        is_self: Boolean(args.is_self),
         display_name: args.profile.display_name,
         bio: args.profile.bio,
         avatar_url: args.profile.avatar_url,
+        private_encryption_public_key: args.profile.private_encryption_public_key,
         public_enabled: args.profile.public_enabled,
         updated_at: args.profile.updated_at,
         online: args.online,
@@ -76,6 +78,7 @@ function buildPublicProfileSummary(args) {
             display_name: args.profile.display_name,
             bio: args.profile.bio,
             avatar_url: args.profile.avatar_url,
+            private_encryption_public_key: args.profile.private_encryption_public_key,
             tags,
             public_enabled: args.profile.public_enabled,
             profile_version: args.profile_version ?? "v1",

package/apps/local-console/dist/packages/core/src/socialConfig.js

@@ -1,10 +1,14 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseFrontmatterObject = parseFrontmatterObject;
 exports.extractFrontmatter = extractFrontmatter;
 exports.normalizeSocialConfig = normalizeSocialConfig;
 exports.getDefaultSocialConfig = getDefaultSocialConfig;
 exports.generateDefaultSocialMdTemplate = generateDefaultSocialMdTemplate;
+const silicaclaw_defaults_json_1 = __importDefault(require("../../../config/silicaclaw-defaults.json"));
 const DEFAULT_SOCIAL_CONFIG = {
     enabled: true,
     public_enabled: false,
@@ -15,13 +19,13 @@ const DEFAULT_SOCIAL_CONFIG = {
         tags: [],
     },
     network: {
-        mode: "global-preview",
-        namespace: "silicaclaw.preview",
+        mode: silicaclaw_defaults_json_1.default.network.default_mode,
+        namespace: silicaclaw_defaults_json_1.default.network.default_namespace,
         adapter: "relay-preview",
-        port: 44123,
-        signaling_url: "https://relay.silicaclaw.com",
+        port: silicaclaw_defaults_json_1.default.ports.network_default,
+        signaling_url: silicaclaw_defaults_json_1.default.network.global_preview.relay_url,
         signaling_urls: [],
-        room: "silicaclaw-global-preview",
+        room: silicaclaw_defaults_json_1.default.network.global_preview.room,
         seed_peers: [],
         bootstrap_hints: [],
     },

package/apps/local-console/dist/packages/core/src/types.d.ts

@@ -4,12 +4,18 @@ export type AgentIdentity = {
     private_key: string;
     created_at: number;
 };
+export type PrivateEncryptionKeyPair = {
+    public_key: string;
+    private_key: string;
+    created_at: number;
+};
 export type PublicProfile = {
     agent_id: string;
     display_name: string;
     bio: string;
     tags: string[];
     avatar_url?: string;
+    private_encryption_public_key?: string;
     public_enabled: boolean;
     updated_at: number;
     signature: string;
@@ -51,6 +57,40 @@ export type SocialMessageObservationRecord = {
     observed_at: number;
     signature: string;
 };
+export type PrivateMessageRecord = {
+    type: "private.message";
+    message_id: string;
+    conversation_id: string;
+    from_agent_id: string;
+    to_agent_id: string;
+    sender_public_key: string;
+    sender_encryption_public_key: string;
+    recipient_encryption_public_key: string;
+    cipher_scheme: "nacl-box-v1";
+    ciphertext: string;
+    nonce: string;
+    created_at: number;
+    signature: string;
+};
+export type PrivateMessageReceiptRecord = {
+    type: "private.message.receipt";
+    receipt_id: string;
+    message_id: string;
+    conversation_id: string;
+    from_agent_id: string;
+    to_agent_id: string;
+    sender_public_key: string;
+    status: "received" | "read";
+    created_at: number;
+    signature: string;
+};
+export type PrivateConversationSummary = {
+    conversation_id: string;
+    peer_agent_id: string;
+    last_message_at: number | null;
+    last_message_preview: string;
+    unread_count: number;
+};
 export type DirectoryState = {
     profiles: Record<string, PublicProfile>;
     presence: Record<string, number>;

package/apps/local-console/dist/packages/network/src/realPreview.js

@@ -1,4 +1,7 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RealNetworkAdapterPreview = void 0;
 const crypto_1 = require("crypto");
@@ -7,6 +10,7 @@ const jsonMessageEnvelopeCodec_1 = require("./codec/jsonMessageEnvelopeCodec");
 const jsonTopicCodec_1 = require("./codec/jsonTopicCodec");
 const udpLanBroadcastTransport_1 = require("./transport/udpLanBroadcastTransport");
 const heartbeatPeerDiscovery_1 = require("./discovery/heartbeatPeerDiscovery");
+const silicaclaw_defaults_json_1 = __importDefault(require("../../../config/silicaclaw-defaults.json"));
 class RealNetworkAdapterPreview {
     started = false;
     peerId;
@@ -46,7 +50,7 @@ class RealNetworkAdapterPreview {
     };
     constructor(options = {}) {
         this.peerId = options.peerId ?? `peer-${process.pid}-${Math.random().toString(36).slice(2, 10)}`;
-        this.namespace = this.normalizeNamespace(options.namespace ?? "silicaclaw.preview");
+        this.namespace = this.normalizeNamespace(options.namespace ?? silicaclaw_defaults_json_1.default.network.default_namespace);
         this.transport = options.transport ?? new udpLanBroadcastTransport_1.UdpLanBroadcastTransport();
         this.envelopeCodec = options.envelopeCodec ?? new jsonMessageEnvelopeCodec_1.JsonMessageEnvelopeCodec();
         this.topicCodec = options.topicCodec ?? new jsonTopicCodec_1.JsonTopicCodec();
@@ -315,7 +319,7 @@ class RealNetworkAdapterPreview {
     }
     normalizeNamespace(namespace) {
         const normalized = namespace.trim();
-        return normalized.length > 0 ? normalized : "silicaclaw.preview";
+        return normalized.length > 0 ? normalized : silicaclaw_defaults_json_1.default.network.default_namespace;
     }
     errorMessage(error) {
         if (error instanceof Error) {

package/apps/local-console/dist/packages/network/src/relayPreview.d.ts

@@ -22,6 +22,10 @@ type RelayPeer = {
     last_seen_at: number;
     messages_seen: number;
     reconnect_attempts: number;
+    meta?: {
+        signal_queue_size?: number;
+        relay_queue_size?: number;
+    };
 };
 type RelayDiagnostics = {
     adapter: "relay-preview";
@@ -126,6 +130,7 @@ export declare class RelayPreviewAdapter implements NetworkAdapter {
     private started;
     private poller;
     private handlers;
+    private directHandlers;
     private peers;
     private seenMessageIds;
     private activeEndpoint;
@@ -150,10 +155,16 @@ export declare class RelayPreviewAdapter implements NetworkAdapter {
     stop(): Promise<void>;
     publish(topic: string, data: any): Promise<void>;
     subscribe(topic: string, handler: (data: any) => void): void;
+    sendDirect(peerId: string, topic: string, data: any): Promise<void>;
+    subscribeDirect(topic: string, handler: (data: any, meta?: {
+        peerId?: string;
+    }) => void): void;
     getDiagnostics(): RelayDiagnostics;
     private pollOnce;
     private refreshPeers;
     private onEnvelope;
+    private onDirectEnvelope;
+    private dispatchEnvelope;
     private recordDiscovery;
     private joinRoom;
     private maybeRefreshJoin;
@@ -162,5 +173,6 @@ export declare class RelayPreviewAdapter implements NetworkAdapter {
     private requestJson;
     private updatePeersFromList;
     private scheduleNextPoll;
+    private ensurePollingAlive;
 }
 export {};

package/apps/local-console/dist/packages/network/src/relayPreview.js

@@ -1,10 +1,14 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RelayPreviewAdapter = void 0;
 const crypto_1 = require("crypto");
 const messageEnvelope_1 = require("./abstractions/messageEnvelope");
 const jsonMessageEnvelopeCodec_1 = require("./codec/jsonMessageEnvelopeCodec");
 const jsonTopicCodec_1 = require("./codec/jsonTopicCodec");
+const silicaclaw_defaults_json_1 = __importDefault(require("../../../config/silicaclaw-defaults.json"));
 function dedupe(values) {
     return Array.from(new Set(values.map((value) => value.trim()).filter(Boolean)));
 }
@@ -27,6 +31,7 @@ class RelayPreviewAdapter {
     started = false;
     poller = null;
     handlers = new Map();
+    directHandlers = new Map();
     peers = new Map();
     seenMessageIds = new Set();
     activeEndpoint = "";
@@ -77,13 +82,15 @@ class RelayPreviewAdapter {
     };
     constructor(options = {}) {
         this.peerId = options.peerId ?? `peer-${process.pid}-${Math.random().toString(36).slice(2, 10)}`;
-        this.namespace = String(options.namespace || "silicaclaw.preview").trim() || "silicaclaw.preview";
+        this.namespace =
+            String(options.namespace || silicaclaw_defaults_json_1.default.network.default_namespace).trim() || silicaclaw_defaults_json_1.default.network.default_namespace;
         this.signalingEndpoints = dedupe((options.signalingUrls && options.signalingUrls.length > 0
             ? options.signalingUrls
             : [options.signalingUrl || "http://localhost:4510"]));
         this.activeEndpoint = this.signalingEndpoints[0] || "http://localhost:4510";
         this.activeEndpointIndex = 0;
-        this.room = String(options.room || "silicaclaw-global-preview").trim() || "silicaclaw-global-preview";
+        this.room =
+            String(options.room || silicaclaw_defaults_json_1.default.network.global_preview.room).trim() || silicaclaw_defaults_json_1.default.network.global_preview.room;
         this.seedPeers = dedupe(options.seedPeers || []);
         this.bootstrapHints = dedupe(options.bootstrapHints || []);
         this.bootstrapSources = dedupe(options.bootstrapSources || []);
@@ -103,7 +110,6 @@ class RelayPreviewAdapter {
         try {
             await this.joinRoom("start");
             this.started = true;
-            await this.refreshPeers();
             await this.pollOnce();
             this.scheduleNextPoll(this.pollIntervalMs);
             this.recordDiscovery("signaling_connected", { endpoint: this.activeEndpoint });
@@ -160,6 +166,42 @@ class RelayPreviewAdapter {
         }
         this.handlers.get(key)?.add(handler);
     }
+    async sendDirect(peerId, topic, data) {
+        if (!this.started)
+            return;
+        const targetPeerId = String(peerId || "").trim();
+        if (!targetPeerId)
+            return;
+        await this.maybeRefreshJoin("direct_send");
+        const envelope = {
+            version: 1,
+            message_id: (0, crypto_1.randomUUID)(),
+            topic: `${this.namespace}:${topic}`,
+            source_peer_id: this.peerId,
+            timestamp: Date.now(),
+            payload: this.topicCodec.encode(topic, data),
+        };
+        const raw = this.envelopeCodec.encode(envelope);
+        if (raw.length > this.maxMessageBytes) {
+            this.stats.dropped_oversized += 1;
+            return;
+        }
+        await this.post("/direct/send", {
+            room: this.room,
+            from_peer_id: this.peerId,
+            to_peer_id: targetPeerId,
+            envelope,
+        });
+        this.lastPublishAt = Date.now();
+        this.signalingMessagesSentTotal += 1;
+    }
+    subscribeDirect(topic, handler) {
+        const key = `${this.namespace}:${topic}`;
+        if (!this.directHandlers.has(key)) {
+            this.directHandlers.set(key, new Set());
+        }
+        this.directHandlers.get(key)?.add(handler);
+    }
     getDiagnostics() {
         const peerItems = Array.from(this.peers.values()).sort((a, b) => b.last_seen_at - a.last_seen_at);
         return {
@@ -229,6 +271,15 @@ class RelayPreviewAdapter {
                 this.signalingMessagesReceivedTotal += 1;
                 this.onEnvelope(message?.envelope);
             }
+            let directMessages = Array.isArray(payload?.direct_messages) ? payload.direct_messages : null;
+            if (!directMessages) {
+                const directPayload = await this.get(`/direct/poll?room=${encodeURIComponent(this.room)}&peer_id=${encodeURIComponent(this.peerId)}`);
+                directMessages = Array.isArray(directPayload?.messages) ? directPayload.messages : [];
+            }
+            for (const message of directMessages) {
+                this.signalingMessagesReceivedTotal += 1;
+                this.onDirectEnvelope(message?.envelope, { peerId: String(message?.from_peer_id || "") || undefined });
+            }
             if (Array.isArray(payload?.peers)) {
                 this.updatePeersFromList(payload.peers);
             }
@@ -252,10 +303,18 @@ class RelayPreviewAdapter {
         const payload = await this.get(`/peers?room=${encodeURIComponent(this.room)}`);
         this.lastPeerRefreshAt = Date.now();
         this.stats.peers_refresh_succeeded += 1;
-        const peerIds = Array.isArray(payload?.peers) ? payload.peers : [];
-        this.updatePeersFromList(peerIds);
+        const peerItems = Array.isArray(payload?.peer_details) && payload.peer_details.length
+            ? payload.peer_details
+            : Array.isArray(payload?.peers) ? payload.peers : [];
+        this.updatePeersFromList(peerItems);
     }
     onEnvelope(envelope) {
+        this.dispatchEnvelope(envelope, this.handlers);
+    }
+    onDirectEnvelope(envelope, meta) {
+        this.dispatchEnvelope(envelope, this.directHandlers, meta);
+    }
+    dispatchEnvelope(envelope, handlersByTopic, meta) {
         this.stats.received_total += 1;
         const validated = (0, messageEnvelope_1.validateNetworkMessageEnvelope)(envelope, {
             max_future_drift_ms: this.maxFutureDriftMs,
@@ -294,7 +353,7 @@ class RelayPreviewAdapter {
         this.stats.received_validated += 1;
         const topicKey = message.topic;
         const topic = topicKey.slice(this.namespace.length + 1);
-        const handlers = this.handlers.get(topicKey);
+        const handlers = handlersByTopic.get(topicKey);
         if (!handlers || handlers.size === 0)
             return;
         const peer = this.peers.get(message.source_peer_id);
@@ -312,7 +371,7 @@ class RelayPreviewAdapter {
         }
         for (const handler of handlers) {
             try {
-                handler(payload);
+                handler(payload, meta || { peerId: message.source_peer_id });
                 this.stats.delivered_total += 1;
             }
             catch {
@@ -334,15 +393,20 @@ class RelayPreviewAdapter {
     }
     async joinRoom(reason) {
         this.stats.join_attempted += 1;
-        await this.post("/join", { room: this.room, peer_id: this.peerId });
+        const payload = await this.post("/join", { room: this.room, peer_id: this.peerId });
         this.lastJoinAt = Date.now();
         this.stats.join_succeeded += 1;
+        if (Array.isArray(payload?.peers)) {
+            this.updatePeersFromList(payload.peers);
+            this.lastPeerRefreshAt = this.lastJoinAt;
+        }
         this.recordDiscovery("join_ok", { endpoint: this.activeEndpoint, detail: reason });
     }
     async maybeRefreshJoin(reason) {
         if (!this.lastJoinAt || Date.now() - this.lastJoinAt > Math.max(45_000, this.pollIntervalMs * 6)) {
             await this.joinRoom(reason);
         }
+        this.ensurePollingAlive(reason);
     }
     async get(path) {
         return this.requestJson("GET", path);
@@ -400,13 +464,38 @@ class RelayPreviewAdapter {
         throw new Error(errors.join(" | "));
     }
     updatePeersFromList(values) {
-        const peerIds = values.map((value) => String(value || "").trim()).filter(Boolean);
+        const parsedPeers = [];
+        for (const value of values) {
+            if (typeof value === "string") {
+                const peerId = String(value || "").trim();
+                if (peerId) {
+                    parsedPeers.push({ peer_id: peerId });
+                }
+                continue;
+            }
+            if (value && typeof value === "object") {
+                const raw = value;
+                const peerId = String(raw.peer_id || "").trim();
+                if (!peerId) {
+                    continue;
+                }
+                parsedPeers.push({
+                    peer_id: peerId,
+                    meta: {
+                        signal_queue_size: Number(raw.signal_queue_size ?? 0),
+                        relay_queue_size: Number(raw.relay_queue_size ?? 0),
+                    },
+                });
+            }
+        }
+        const peerIds = parsedPeers.map((peer) => peer.peer_id);
         if (!peerIds.includes(this.peerId)) {
             void this.joinRoom("self_missing_from_peers").catch(() => { });
         }
         const now = Date.now();
         const next = new Map();
-        for (const peerId of peerIds) {
+        for (const peerInfo of parsedPeers) {
+            const peerId = peerInfo.peer_id;
             if (peerId === this.peerId)
                 continue;
             const existing = this.peers.get(peerId);
@@ -420,6 +509,7 @@ class RelayPreviewAdapter {
                 last_seen_at: now,
                 messages_seen: existing?.messages_seen ?? 0,
                 reconnect_attempts: existing?.reconnect_attempts ?? 0,
+                meta: peerInfo.meta || existing?.meta,
             });
         }
         for (const peerId of this.peers.keys()) {
@@ -438,5 +528,21 @@ class RelayPreviewAdapter {
             this.pollOnce().catch(() => { });
         }, Math.max(1000, delayMs + jitterMs));
     }
+    ensurePollingAlive(reason) {
+        if (!this.started)
+            return;
+        const pollStaleMs = Math.max(45_000, this.pollIntervalMs * 6);
+        const pollMissing = !this.poller;
+        const pollStale = Boolean(this.lastPollAt) && Date.now() - this.lastPollAt > pollStaleMs;
+        if (!pollMissing && !pollStale) {
+            return;
+        }
+        this.recordDiscovery("poll_recover_scheduled", {
+            endpoint: this.activeEndpoint,
+            detail: `${reason}:${pollMissing ? "missing" : "stale"}`,
+        });
+        this.currentPollDelayMs = this.pollIntervalMs;
+        this.scheduleNextPoll(0);
+    }
 }
 exports.RelayPreviewAdapter = RelayPreviewAdapter;