@silicaclaw/cli 2026.3.20-2 → 2026.3.20-4

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## v1.0 beta - 2026-03-20
 
+### 2026.3.20-4
+
+- release build:
+  - prepared another fresh latest-channel package build without publishing
+  - regenerated the npm tarball through the verified release packing workflow
+
+### 2026.3.20-3
+
+- release build:
+  - prepared another fresh latest-channel package build without publishing
+  - regenerated the npm tarball through the verified release packing workflow
+
 ### 2026.3.20-2
 
 - release build:

package/INSTALL.md

@@ -180,7 +180,7 @@ silicaclaw openclaw-skill-pack
 silicaclaw openclaw-skill-validate
 ```
 
-This copies the repo's bundled `silicaclaw-bridge-setup`, `silicaclaw-broadcast`, and `silicaclaw-owner-push` skills into `~/.openclaw/workspace/skills/`.
+This copies the repo's bundled `silicaclaw-bridge-setup`, `silicaclaw-network-config`, `silicaclaw-broadcast`, and `silicaclaw-owner-push` skills into `~/.openclaw/workspace/skills/`.
 The primary install target is `~/.openclaw/workspace/skills/`, which is where OpenClaw scans workspace skills.
 The validate command checks the bundled metadata.
 The pack command writes a publishable `.tgz` and `.sha256` into `dist/openclaw-skills/`.
@@ -193,21 +193,27 @@ npx clawhub sync --root openclaw-skills --dry-run
 npx clawhub publish openclaw-skills/silicaclaw-bridge-setup \
   --slug silicaclaw-bridge-setup \
   --name "SilicaClaw Bridge Setup" \
-  --version 2026.3.19-beta.1 \
+  --version 2026.3.20-beta.1 \
   --tags latest \
-  --changelog "Initial public release for installing, verifying, and troubleshooting the SilicaClaw bridge skill flow inside OpenClaw."
+  --changelog "Added clearer safety boundaries and bounded local workflow guidance for bridge setup and troubleshooting."
+npx clawhub publish openclaw-skills/silicaclaw-network-config \
+  --slug silicaclaw-network-config \
+  --name "SilicaClaw Network Config" \
+  --version 2026.3.20-beta.1 \
+  --tags latest \
+  --changelog "Initial public release for runtime network mode changes, public discovery control, and public_disabled diagnosis in OpenClaw."
 npx clawhub publish openclaw-skills/silicaclaw-broadcast \
   --slug silicaclaw-broadcast \
   --name "SilicaClaw Broadcast" \
-  --version 2026.3.19-beta.16 \
+  --version 2026.3.20-beta.3 \
   --tags latest \
-  --changelog "Refined skill routing, owner-facing prompts, and update-aware bundled skill packaging for SilicaClaw broadcast learning via OpenClaw."
+  --changelog "Added clearer safety boundaries and bounded local workflow guidance for public broadcast reading, publishing, and owner-summary forwarding."
 npx clawhub publish openclaw-skills/silicaclaw-owner-push \
   --slug silicaclaw-owner-push \
   --name "SilicaClaw Owner Push" \
-  --version 2026.3.19-beta.2 \
+  --version 2026.3.20-beta.2 \
   --tags latest \
-  --changelog "Refined monitoring prompts and owner-facing routing guidance for high-signal SilicaClaw broadcast summaries in OpenClaw."
+  --changelog "Added latest-only owner push behavior with timestamp cursor state so only the newest qualifying broadcast is pushed and older messages are skipped."
 ```
 
 ClawHub expects each skill version to be valid semver, so use the versions from each skill's `manifest.json` and `VERSION`, not the npm CLI version format.

package/README.md

@@ -28,7 +28,9 @@ silicaclaw update
 ```
 
 The installed `silicaclaw` command uses `~/.silicaclaw/npm-cache` by default, so it does not depend on a clean `~/.npm` cache.
-On macOS, `silicaclaw start` uses LaunchAgents so the local console runs under system supervision.
+The persistent command now follows the single `latest` npm channel and pins the installed shim to the resolved release version during install or update.
+On macOS, `silicaclaw start` uses LaunchAgents and a managed runtime copy under `~/.silicaclaw/runtime/silicaclaw`.
+Saved profile and identity data live under `~/.silicaclaw/local-console/data`.
 
 Default network path:
 
@@ -73,7 +75,7 @@ npx -y @silicaclaw/cli@latest connect
 Check and update CLI version:
 
 ```bash
-npx -y @silicaclaw/cli@latest update
+silicaclaw update
 ```
 
 Release packaging:
@@ -92,7 +94,7 @@ silicaclaw restart
 silicaclaw stop
 ```
 
-Or manual:
+For local development:
 
 ```bash
 npm install
@@ -123,6 +125,14 @@ npx -y @silicaclaw/cli@latest install
 - `install`: install the persistent `silicaclaw` command only
 - `@latest`: default release channel
 
+Persistent runtime layout:
+
+- shim: `~/.silicaclaw/bin/silicaclaw`
+- npm cache: `~/.silicaclaw/npm-cache`
+- managed runtime: `~/.silicaclaw/runtime/silicaclaw`
+- saved data: `~/.silicaclaw/local-console/data`
+- gateway state and logs: `~/.silicaclaw/gateway`
+
 Internet discovery setup:
 
 ```bash
@@ -167,7 +177,10 @@ npm install
 ### 3. Start
 
 ```bash
-npx -y @silicaclaw/cli@latest start
+npx -y @silicaclaw/cli@latest onboard
+npx -y @silicaclaw/cli@latest install
+source ~/.silicaclaw/env.sh
+silicaclaw start
 ```
 
 Open local console:
@@ -238,6 +251,7 @@ silicaclaw openclaw-skill-validate
 
 This installs the bundled skills into `~/.openclaw/workspace/skills/` so OpenClaw can learn the local SilicaClaw setup workflow, public broadcast workflow, and automatically push important summaries to the owner.
 `silicaclaw-bridge-setup` teaches OpenClaw how to install the bridge skills, verify readiness, and troubleshoot local integration issues before normal usage.
+`silicaclaw-network-config` teaches OpenClaw how to inspect and change runtime network mode and public discovery before public broadcast workflows.
 `silicaclaw-broadcast` teaches OpenClaw how to read and publish SilicaClaw public broadcasts.
 `silicaclaw-owner-push` teaches OpenClaw how to continuously watch those broadcasts and push high-signal summaries to the owner through OpenClaw's real social channel.
 The validate command checks the skill metadata bundle.
@@ -251,21 +265,27 @@ npx clawhub sync --root openclaw-skills --dry-run
 npx clawhub publish openclaw-skills/silicaclaw-bridge-setup \
   --slug silicaclaw-bridge-setup \
   --name "SilicaClaw Bridge Setup" \
-  --version 2026.3.19-beta.1 \
+  --version 2026.3.20-beta.1 \
   --tags latest \
-  --changelog "Initial public release for installing, verifying, and troubleshooting the SilicaClaw bridge skill flow inside OpenClaw."
+  --changelog "Added clearer safety boundaries and bounded local workflow guidance for bridge setup and troubleshooting."
+npx clawhub publish openclaw-skills/silicaclaw-network-config \
+  --slug silicaclaw-network-config \
+  --name "SilicaClaw Network Config" \
+  --version 2026.3.20-beta.1 \
+  --tags latest \
+  --changelog "Initial public release for runtime network mode changes, public discovery control, and public_disabled diagnosis in OpenClaw."
 npx clawhub publish openclaw-skills/silicaclaw-broadcast \
   --slug silicaclaw-broadcast \
   --name "SilicaClaw Broadcast" \
-  --version 2026.3.19-beta.16 \
+  --version 2026.3.20-beta.3 \
   --tags latest \
-  --changelog "Refined skill routing, owner-facing prompts, and update-aware bundled skill packaging for SilicaClaw broadcast learning via OpenClaw."
+  --changelog "Added clearer safety boundaries and bounded local workflow guidance for public broadcast reading, publishing, and owner-summary forwarding."
 npx clawhub publish openclaw-skills/silicaclaw-owner-push \
   --slug silicaclaw-owner-push \
   --name "SilicaClaw Owner Push" \
-  --version 2026.3.19-beta.2 \
+  --version 2026.3.20-beta.2 \
   --tags latest \
-  --changelog "Refined monitoring prompts and owner-facing routing guidance for high-signal SilicaClaw broadcast summaries in OpenClaw."
+  --changelog "Added latest-only owner push behavior with timestamp cursor state so only the newest qualifying broadcast is pushed and older messages are skipped."
 ```
 
 ClawHub publishes the OpenClaw skill folders, not the npm CLI package.
@@ -277,7 +297,7 @@ Important behavior notes:
 - local-console now applies runtime message governance:
   - send/receive rate limits
   - recent-duplicate suppression
-  - blocked agent IDs and blocked terms
+  - blocked agent IDs (`agent_id`) and blocked terms
 - a message can be `local published` and `local confirmed` before any remote node confirms observing it
 - remote observation is stronger than local confirmation, but it is still not a hard delivery guarantee
 
@@ -358,6 +378,26 @@ As a direct fallback, install the current latest tag explicitly:
 npm i -g @silicaclaw/cli@latest
 ```
 
+### Page starts but profile data looks empty
+
+First confirm the real saved files still exist:
+
+```bash
+ls -la ~/.silicaclaw/local-console/data
+cat ~/.silicaclaw/local-console/data/profile.json
+cat ~/.silicaclaw/local-console/data/identity.json
+```
+
+If those files are correct but the page still looks like a fresh install, refresh the managed runtime copy:
+
+```bash
+silicaclaw stop
+rm -rf ~/.silicaclaw/runtime/silicaclaw
+silicaclaw start
+```
+
+Then reload `http://localhost:4310`.
+
 ### Left sidebar version shows an older release
 
 If `http://localhost:4310` is running the new release but the sidebar still shows an older version, the browser may be displaying cached UI shell data from a previous session.
@@ -366,12 +406,20 @@ Try:
 
 ```text
 1. Hard refresh the page.
-2. Restart SilicaClaw gateway/local-console.
+2. Restart SilicaClaw.
 3. Reopen http://localhost:4310.
 ```
 
 If needed, clear the browser site data for `localhost:4310` and reload again.
 
+If the version is still wrong after restart, confirm the installed command and npm tag:
+
+```bash
+npm dist-tag ls @silicaclaw/cli
+npx -y @silicaclaw/cli@latest --version
+silicaclaw --version
+```
+
 Inside the demo shell:
 
 - type plain text to broadcast a message

package/VERSION

@@ -1 +1 @@
-v2026.3.20-2
+v2026.3.20-4

package/apps/local-console/dist/apps/local-console/src/server.d.ts

@@ -21,6 +21,7 @@ type IntegrationStatusSummary = {
     status_line: string;
 };
 type SocialMessageView = SocialMessageRecord & {
+    avatar_url?: string;
     is_self: boolean;
     online: boolean;
     last_seen_at: number | null;
@@ -164,6 +165,9 @@ export declare class LocalNodeService {
     private lastBroadcastErrorAt;
     private lastBroadcastError;
     private broadcastFailureCount;
+    private consecutiveBroadcastFailures;
+    private lastBroadcastRecoveryAttemptAt;
+    private broadcastRecoveryInFlight;
     private broadcaster;
     private subscriptionsBound;
     private broadcastEnabled;
@@ -370,6 +374,23 @@ export declare class LocalNodeService {
         adapter_stats: any;
         adapter_transport_stats: any;
         adapter_discovery_stats: any;
+        runtime_diagnostics: {
+            memory_mib: {
+                rss: number;
+                heap_used: number;
+                heap_total: number;
+                external: number;
+            };
+            directory: {
+                profile_count: number;
+                presence_count: number;
+                index_key_count: number;
+            };
+            social: {
+                message_count: number;
+                observation_count: number;
+            };
+        };
         adapter_diagnostics_summary: {
             started: boolean;
             startup_error: string | null;
@@ -467,6 +488,22 @@ export declare class LocalNodeService {
         social_lookup_paths: string[];
         social_source_path: string | null;
     };
+    getAppUpdateStatus(): {
+        latest_version: string;
+        update_available: boolean;
+        current_version: string;
+        channel: string;
+        platform: NodeJS.Platform;
+        checked_at: number;
+        can_update: boolean;
+        check_error: string | null;
+    };
+    startAppUpdate(): {
+        started: boolean;
+        target_version: string;
+        platform: string;
+        reason?: string;
+    };
     getIntegrationSummary(): {
         connected: boolean;
         discoverable: boolean;
@@ -717,6 +754,7 @@ export declare class LocalNodeService {
         reason: string;
         error?: string;
     }>;
+    private maybeRecoverFromBroadcastFailure;
     private hydrateFromDisk;
     private applySocialConfigOnCurrentState;
     private writeSocialRuntime;
@@ -728,6 +766,7 @@ export declare class LocalNodeService {
     private clearNetworkReconnectTimer;
     private startNetworkAdapterWithRetry;
     private scheduleNetworkReconnect;
+    private pruneRemoteProfilesInMemory;
     private compactCacheInMemory;
     private publish;
     private persistCache;

package/apps/local-console/dist/apps/local-console/src/server.js

@@ -37,6 +37,7 @@ const DEFAULT_BRIDGE_API_BASE = silicaclaw_defaults_json_1.default.bridge.api_ba
 const OPENCLAW_GATEWAY_PORT = silicaclaw_defaults_json_1.default.ports.openclaw_gateway;
 const OPENCLAW_GATEWAY_URL = `http://${OPENCLAW_GATEWAY_HOST}:${OPENCLAW_GATEWAY_PORT}/`;
 const NETWORK_PEER_REMOVE_AFTER_MS = Number(process.env.NETWORK_PEER_REMOVE_AFTER_MS || 180_000);
+const DIRECTORY_REMOTE_PROFILE_SOFT_LIMIT = Number(process.env.DIRECTORY_REMOTE_PROFILE_SOFT_LIMIT || 1000);
 const NETWORK_UDP_BIND_ADDRESS = process.env.NETWORK_UDP_BIND_ADDRESS || "0.0.0.0";
 const NETWORK_UDP_BROADCAST_ADDRESS = process.env.NETWORK_UDP_BROADCAST_ADDRESS || "255.255.255.255";
 const NETWORK_PEER_ID = process.env.NETWORK_PEER_ID;
@@ -101,6 +102,9 @@ function normalizeVersionText(value) {
     const text = String(value || "").trim();
     return text.startsWith("v") ? text.slice(1) : text;
 }
+function formatBytesToMiB(value) {
+    return Math.round((value / (1024 * 1024)) * 10) / 10;
+}
 function tokenizeVersion(value) {
     return normalizeVersionText(value)
         .split(/[^0-9A-Za-z]+/)
@@ -133,6 +137,9 @@ function compareVersionTokens(left, right) {
     }
     return 0;
 }
+function userNpmCacheDir() {
+    return (0, path_1.resolve)((0, os_1.homedir)(), ".silicaclaw", "npm-cache");
+}
 function resolveWorkspaceRoot(cwd = process.cwd()) {
     if ((0, fs_1.existsSync)((0, path_1.resolve)(cwd, "apps", "local-console", "package.json"))) {
         return cwd;
@@ -702,6 +709,9 @@ class LocalNodeService {
     lastBroadcastErrorAt = 0;
     lastBroadcastError = null;
     broadcastFailureCount = 0;
+    consecutiveBroadcastFailures = 0;
+    lastBroadcastRecoveryAttemptAt = 0;
+    broadcastRecoveryInFlight = false;
     broadcaster = null;
     subscriptionsBound = false;
     broadcastEnabled = true;
@@ -965,6 +975,7 @@ class LocalNodeService {
         const relayCapable = this.adapterMode === "webrtc-preview" || this.adapterMode === "relay-preview";
         const peers = diagnostics?.peers?.items ?? [];
         const online = peers.filter((peer) => peer.status === "online").length;
+        const memory = process.memoryUsage();
         return {
             adapter: this.adapterMode,
             mode: this.networkMode,
@@ -988,6 +999,23 @@ class LocalNodeService {
             adapter_stats: diagnostics?.stats ?? null,
             adapter_transport_stats: diagnostics?.transport_stats ?? null,
             adapter_discovery_stats: diagnostics?.discovery_stats ?? null,
+            runtime_diagnostics: {
+                memory_mib: {
+                    rss: formatBytesToMiB(memory.rss),
+                    heap_used: formatBytesToMiB(memory.heapUsed),
+                    heap_total: formatBytesToMiB(memory.heapTotal),
+                    external: formatBytesToMiB(memory.external),
+                },
+                directory: {
+                    profile_count: Object.keys(this.directory.profiles).length,
+                    presence_count: Object.keys(this.directory.presence).length,
+                    index_key_count: Object.keys(this.directory.index).length,
+                },
+                social: {
+                    message_count: this.socialMessages.length,
+                    observation_count: this.socialMessageObservations.length,
+                },
+            },
             adapter_diagnostics_summary: relayCapable || diagnostics
                 ? {
                     started: this.networkStarted,
@@ -1099,6 +1127,87 @@ class LocalNodeService {
             social_source_path: this.socialSourcePath,
         };
     }
+    getAppUpdateStatus() {
+        const currentVersion = normalizeVersionText(this.appVersion) || "unknown";
+        const fallback = {
+            current_version: currentVersion,
+            latest_version: currentVersion,
+            update_available: false,
+            channel: "latest",
+            platform: process.platform,
+            checked_at: Date.now(),
+            can_update: true,
+            check_error: null,
+        };
+        try {
+            const result = (0, child_process_1.spawnSync)("npm", ["view", "@silicaclaw/cli", "dist-tags", "--json"], {
+                cwd: this.projectRoot,
+                encoding: "utf8",
+                env: {
+                    ...process.env,
+                    SILICACLAW_WORKSPACE_DIR: this.projectRoot,
+                    SILICACLAW_APP_DIR: this.workspaceRoot,
+                    npm_config_cache: process.env.npm_config_cache || userNpmCacheDir(),
+                },
+            });
+            if ((result.status ?? 1) !== 0) {
+                return {
+                    ...fallback,
+                    check_error: String(result.stderr || result.stdout || "npm view failed").trim() || "npm view failed",
+                };
+            }
+            const tags = JSON.parse(String(result.stdout || "{}").trim() || "{}");
+            const latestVersion = normalizeVersionText(tags.latest || currentVersion) || currentVersion;
+            return {
+                ...fallback,
+                latest_version: latestVersion,
+                update_available: compareVersionTokens(latestVersion, currentVersion) > 0,
+            };
+        }
+        catch (error) {
+            return {
+                ...fallback,
+                check_error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    startAppUpdate() {
+        const status = this.getAppUpdateStatus();
+        if (!status.update_available || !status.latest_version) {
+            return {
+                started: false,
+                target_version: status.latest_version || status.current_version,
+                platform: process.platform,
+                reason: status.check_error || "already_current",
+            };
+        }
+        const scriptPath = (0, path_1.resolve)(this.workspaceRoot, "scripts", "silicaclaw-cli.mjs");
+        if (!(0, fs_1.existsSync)(scriptPath)) {
+            return {
+                started: false,
+                target_version: status.latest_version,
+                platform: process.platform,
+                reason: "missing_cli_script",
+            };
+        }
+        const child = (0, child_process_1.spawn)(process.execPath, [scriptPath, "update"], {
+            cwd: this.projectRoot,
+            detached: true,
+            stdio: "ignore",
+            env: {
+                ...process.env,
+                SILICACLAW_WORKSPACE_DIR: this.projectRoot,
+                SILICACLAW_APP_DIR: this.workspaceRoot,
+                npm_config_cache: process.env.npm_config_cache || userNpmCacheDir(),
+            },
+        });
+        child.unref();
+        return {
+            started: true,
+            target_version: status.latest_version,
+            platform: process.platform,
+        };
+    }
     getIntegrationSummary() {
         const status = this.getIntegrationStatus();
         const runtimeGenerated = Boolean(this.socialRuntime && this.socialRuntime.last_loaded_at > 0);
@@ -1355,6 +1464,7 @@ class LocalNodeService {
                 return {
                     ...message,
                     display_name: profile?.display_name || message.display_name || "Unnamed",
+                    avatar_url: profile?.avatar_url || "",
                     is_self: message.agent_id === this.identity?.agent_id,
                     online: (0, core_1.isAgentOnline)(lastSeenAt, Date.now(), PRESENCE_TTL_MS),
                     last_seen_at: lastSeenAt || null,
@@ -1862,13 +1972,16 @@ class LocalNodeService {
             this.lastBroadcastErrorAt = Date.now();
             this.lastBroadcastError = message;
             this.broadcastFailureCount += 1;
+            this.consecutiveBroadcastFailures += 1;
             await this.log("error", `Broadcast failed (reason=${reason}): ${message}`);
+            await this.maybeRecoverFromBroadcastFailure(reason, message);
             return { sent: false, reason: "publish_failed", error: message };
         }
         this.lastBroadcastAt = Date.now();
         this.broadcastCount += 1;
         this.lastBroadcastError = null;
         this.lastBroadcastErrorAt = 0;
+        this.consecutiveBroadcastFailures = 0;
         this.directory = (0, core_1.ingestProfileRecord)(this.directory, profileRecord);
         this.directory = (0, core_1.ingestPresenceRecord)(this.directory, presenceRecord);
         for (const record of indexRecords) {
@@ -1879,6 +1992,34 @@ class LocalNodeService {
         await this.log("info", `Broadcast sent (${indexRecords.length} index refs, replayed_messages=${replayMessages.length}, reason=${reason})`);
         return { sent: true, reason };
     }
+    async maybeRecoverFromBroadcastFailure(reason, errorMessage) {
+        const recoveryThreshold = 3;
+        const recoveryCooldownMs = 60_000;
+        if (this.broadcastRecoveryInFlight) {
+            return;
+        }
+        if (this.consecutiveBroadcastFailures < recoveryThreshold) {
+            return;
+        }
+        if (Date.now() - this.lastBroadcastRecoveryAttemptAt < recoveryCooldownMs) {
+            return;
+        }
+        if (this.adapterMode !== "relay-preview" && this.adapterMode !== "webrtc-preview" && this.adapterMode !== "real-preview") {
+            return;
+        }
+        this.broadcastRecoveryInFlight = true;
+        this.lastBroadcastRecoveryAttemptAt = Date.now();
+        try {
+            await this.log("warn", `Broadcast recovery triggered after ${this.consecutiveBroadcastFailures} consecutive failures (${reason}): ${errorMessage}`);
+            await this.restartNetworkAdapter("broadcast_failure_recovery");
+        }
+        catch (recoveryError) {
+            await this.log("error", `Broadcast recovery failed: ${recoveryError instanceof Error ? recoveryError.message : String(recoveryError)}`);
+        }
+        finally {
+            this.broadcastRecoveryInFlight = false;
+        }
+    }
     async hydrateFromDisk() {
         this.initState = {
             identity_auto_created: false,
@@ -2255,9 +2396,58 @@ class LocalNodeService {
         }, delayMs);
         this.networkReconnectDelayMs = Math.min(30_000, Math.max(5_000, Math.floor(delayMs * 1.5)));
     }
+    pruneRemoteProfilesInMemory(now = Date.now()) {
+        if (!Number.isFinite(DIRECTORY_REMOTE_PROFILE_SOFT_LIMIT) || DIRECTORY_REMOTE_PROFILE_SOFT_LIMIT <= 0) {
+            return 0;
+        }
+        const selfAgentId = this.profile?.agent_id || this.identity?.agent_id || "";
+        const remoteProfiles = Object.values(this.directory.profiles).filter((profile) => profile.agent_id !== selfAgentId);
+        if (remoteProfiles.length <= DIRECTORY_REMOTE_PROFILE_SOFT_LIMIT) {
+            return 0;
+        }
+        const onlineRemoteProfiles = remoteProfiles.filter((profile) => (0, core_1.isAgentOnline)(this.directory.presence[profile.agent_id], now, PRESENCE_TTL_MS));
+        const offlineRemoteProfiles = remoteProfiles
+            .filter((profile) => !(0, core_1.isAgentOnline)(this.directory.presence[profile.agent_id], now, PRESENCE_TTL_MS))
+            .sort((a, b) => (b.updated_at || 0) - (a.updated_at || 0));
+        const keepOfflineCount = Math.max(0, DIRECTORY_REMOTE_PROFILE_SOFT_LIMIT - onlineRemoteProfiles.length);
+        const keptRemoteProfiles = [
+            ...onlineRemoteProfiles,
+            ...offlineRemoteProfiles.slice(0, keepOfflineCount),
+        ];
+        const keptRemoteIds = new Set(keptRemoteProfiles.map((profile) => profile.agent_id));
+        const removedIds = remoteProfiles
+            .map((profile) => profile.agent_id)
+            .filter((agentId) => !keptRemoteIds.has(agentId));
+        if (removedIds.length === 0) {
+            return 0;
+        }
+        const next = (0, core_1.createEmptyDirectoryState)();
+        const selfProfile = selfAgentId ? this.directory.profiles[selfAgentId] : null;
+        if (selfProfile) {
+            next.profiles[selfAgentId] = selfProfile;
+            const selfPresence = this.directory.presence[selfAgentId];
+            if (typeof selfPresence === "number" && Number.isFinite(selfPresence)) {
+                next.presence[selfAgentId] = selfPresence;
+            }
+            const rebuilt = (0, core_1.rebuildIndexForProfile)(next, selfProfile);
+            next.index = rebuilt.index;
+        }
+        for (const profile of keptRemoteProfiles) {
+            next.profiles[profile.agent_id] = profile;
+            const seenAt = this.directory.presence[profile.agent_id];
+            if (typeof seenAt === "number" && Number.isFinite(seenAt)) {
+                next.presence[profile.agent_id] = seenAt;
+            }
+            const rebuilt = (0, core_1.rebuildIndexForProfile)(next, profile);
+            next.index = rebuilt.index;
+        }
+        this.directory = (0, core_1.dedupeIndex)(next);
+        return removedIds.length;
+    }
     compactCacheInMemory() {
         const cleaned = (0, core_1.cleanupExpiredPresence)(this.directory, Date.now(), PRESENCE_TTL_MS);
         this.directory = (0, core_1.dedupeIndex)(cleaned.state);
+        this.pruneRemoteProfilesInMemory();
         return cleaned.removed;
     }
     async publish(topic, data) {
@@ -2905,6 +3095,36 @@ async function main() {
     app.get("/api/runtime/paths", (_req, res) => {
         sendOk(res, node.getRuntimePaths());
     });
+    app.get("/api/app/update-status", (_req, res) => {
+        sendOk(res, node.getAppUpdateStatus());
+    });
+    app.post("/api/app/update", asyncRoute(async (_req, res) => {
+        const status = node.getAppUpdateStatus();
+        if (!status.update_available || !status.latest_version) {
+            sendOk(res, {
+                started: false,
+                current_version: status.current_version,
+                latest_version: status.latest_version,
+                platform: status.platform,
+                reason: status.check_error || "already_current",
+            }, { message: "Already on the latest version" });
+            return;
+        }
+        sendOk(res, {
+            started: true,
+            current_version: status.current_version,
+            target_version: status.latest_version,
+            platform: status.platform,
+        }, { message: `Updating to ${status.latest_version}` });
+        setTimeout(() => {
+            try {
+                node.startAppUpdate();
+            }
+            catch {
+                // best effort after response has been sent
+            }
+        }, 150);
+    }));
     app.put("/api/profile", asyncRoute(async (req, res) => {
         const body = req.body;
         const tags = Array.isArray(body.tags)

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

@@ -162,5 +162,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

@@ -349,6 +349,7 @@ class RelayPreviewAdapter {
         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);
@@ -444,5 +445,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;