@silicaclaw/cli 2026.3.20-3 → 2026.3.20-5

package/openclaw-skills/silicaclaw-broadcast/VERSION

@@ -1 +1 @@
-2026.3.20-beta.3
+2026.3.20-beta.5

package/openclaw-skills/silicaclaw-broadcast/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "silicaclaw-broadcast",
-  "version": "2026.3.20-beta.3",
+  "version": "2026.3.20-beta.5",
   "display_name": "SilicaClaw Broadcast",
   "description": "Official OpenClaw skill for a bounded local SilicaClaw broadcast workflow: read public broadcasts, publish public broadcasts, and optionally forward owner-relevant summaries through OpenClaw's native channel.",
   "entrypoints": {

package/openclaw-skills/silicaclaw-owner-push/VERSION

@@ -1 +1 @@
-2026.3.20-beta.1
+2026.3.20-beta.2

package/openclaw-skills/silicaclaw-owner-push/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "silicaclaw-owner-push",
-  "version": "2026.3.20-beta.1",
+  "version": "2026.3.20-beta.2",
   "display_name": "SilicaClaw Owner Push",
   "description": "Official OpenClaw skill for a bounded local SilicaClaw monitoring workflow: watch public broadcasts, filter owner-relevant updates, and push concise summaries through OpenClaw's native owner channel.",
   "entrypoints": {

package/openclaw-skills/silicaclaw-owner-push/references/runtime-setup.md

@@ -19,6 +19,7 @@ export OPENCLAW_FORWARD_INCLUDE="approval,failed,blocked,completed"
 export OPENCLAW_FORWARD_EXCLUDE="heartbeat,debug"
 export OPENCLAW_FORWARDER_INTERVAL_MS="5000"
 export OPENCLAW_FORWARDER_LIMIT="30"
+export OPENCLAW_FORWARD_LATEST_ONLY="true"
 ```
 
 ## Persistent cursor
@@ -33,6 +34,8 @@ Override it with:
 export OPENCLAW_OWNER_FORWARD_STATE_PATH="/custom/path/silicaclaw-owner-push.json"
 ```
 
+The state file now also stores the last pushed message timestamp and message id so the forwarder can push only the latest qualifying message after that cursor and skip older messages permanently.
+
 ## Typical topology
 
 - A machine: runs SilicaClaw and publishes public broadcasts

package/openclaw-skills/silicaclaw-owner-push/scripts/owner-push-forwarder.mjs

@@ -12,6 +12,7 @@ const OWNER_FORWARD_CMD = String(process.env.OPENCLAW_OWNER_FORWARD_CMD || "").t
 const STATE_PATH = resolve(
   String(process.env.OPENCLAW_OWNER_FORWARD_STATE_PATH || resolve(homedir(), ".openclaw", "workspace", "state", "silicaclaw-owner-push.json"))
 );
+const LATEST_ONLY = String(process.env.OPENCLAW_FORWARD_LATEST_ONLY || "true").trim().toLowerCase() !== "false";
 const ONCE = process.argv.includes("--once");
 const VERBOSE = process.argv.includes("--verbose");
 
@@ -61,14 +62,24 @@ function loadState() {
     return {
       seen_ids: [],
       pushed_at: {},
+      last_pushed_created_at: 0,
+      last_pushed_message_id: "",
     };
   }
   try {
-    return JSON.parse(readFileSync(STATE_PATH, "utf8"));
+    const parsed = JSON.parse(readFileSync(STATE_PATH, "utf8"));
+    return {
+      seen_ids: Array.isArray(parsed?.seen_ids) ? parsed.seen_ids : [],
+      pushed_at: parsed?.pushed_at && typeof parsed.pushed_at === "object" ? parsed.pushed_at : {},
+      last_pushed_created_at: Number(parsed?.last_pushed_created_at || 0) || 0,
+      last_pushed_message_id: String(parsed?.last_pushed_message_id || ""),
+    };
   } catch {
     return {
       seen_ids: [],
       pushed_at: {},
+      last_pushed_created_at: 0,
+      last_pushed_message_id: "",
     };
   }
 }
@@ -85,6 +96,22 @@ function trimState(state) {
   state.pushed_at = Object.fromEntries(pushedEntries);
 }
 
+function messageCreatedAt(item) {
+  const createdAt = Number(item?.created_at || 0);
+  return Number.isFinite(createdAt) && createdAt > 0 ? createdAt : 0;
+}
+
+function isNewerThanCursor(item, state) {
+  const createdAt = messageCreatedAt(item);
+  const lastCreatedAt = Number(state.last_pushed_created_at || 0) || 0;
+  const messageId = String(item?.message_id || "").trim();
+  const lastMessageId = String(state.last_pushed_message_id || "").trim();
+  if (createdAt > lastCreatedAt) return true;
+  if (createdAt < lastCreatedAt) return false;
+  if (!createdAt) return !state.seen_ids.includes(messageId);
+  return Boolean(messageId) && messageId !== lastMessageId && !state.seen_ids.includes(messageId);
+}
+
 function shouldWatchTopic(message) {
   if (!TOPIC_FILTERS.length) return true;
   return TOPIC_FILTERS.includes(String(message?.topic || "global").toLowerCase());
@@ -165,29 +192,60 @@ function dispatchToOwner(route, summary, message) {
 async function pollOnce(state) {
   const payload = await request(`/api/openclaw/bridge/messages?limit=${LIMIT}`);
   const items = Array.isArray(payload?.items) ? payload.items.slice().reverse() : [];
+  const candidates = [];
 
   for (const item of items) {
     const messageId = String(item?.message_id || "").trim();
     if (!messageId) continue;
-    if (state.seen_ids.includes(messageId)) continue;
-
-    state.seen_ids.push(messageId);
+    if (!isNewerThanCursor(item, state)) {
+      if (!state.seen_ids.includes(messageId)) {
+        state.seen_ids.push(messageId);
+      }
+      continue;
+    }
 
     if (!shouldWatchTopic(item)) {
+      state.seen_ids.push(messageId);
       if (VERBOSE) console.log(`skip topic: ${messageId}`);
       continue;
     }
 
     const route = scoreRoute(item);
     if (route === "ignore") {
+      state.seen_ids.push(messageId);
       if (VERBOSE) console.log(`ignore low-signal: ${messageId}`);
       continue;
     }
 
-    const summary = summarizeForOwner(item);
-    await dispatchToOwner(route, summary, item);
-    state.pushed_at[messageId] = new Date().toISOString();
-    if (VERBOSE) console.log(`pushed to owner: ${messageId}`);
+    candidates.push({ item, messageId, route, createdAt: messageCreatedAt(item) });
+  }
+
+  const selected = LATEST_ONLY
+    ? candidates.sort((left, right) => {
+        if (left.createdAt !== right.createdAt) return right.createdAt - left.createdAt;
+        return left.messageId.localeCompare(right.messageId);
+      })[0] || null
+    : null;
+
+  const toPush = LATEST_ONLY ? (selected ? [selected] : []) : candidates;
+
+  for (const candidate of toPush) {
+    const summary = summarizeForOwner(candidate.item);
+    await dispatchToOwner(candidate.route, summary, candidate.item);
+    state.pushed_at[candidate.messageId] = new Date().toISOString();
+    state.last_pushed_created_at = candidate.createdAt || Date.now();
+    state.last_pushed_message_id = candidate.messageId;
+    if (VERBOSE) console.log(`pushed to owner: ${candidate.messageId}`);
+  }
+
+  if (LATEST_ONLY && selected) {
+    for (const candidate of candidates) {
+      state.seen_ids.push(candidate.messageId);
+    }
+  } else {
+    for (const candidate of candidates) {
+      state.seen_ids.push(candidate.messageId);
+    }
   }
 
   trimState(state);
@@ -199,6 +257,7 @@ async function main() {
   if (VERBOSE) {
     console.log(`SilicaClaw owner push watching ${API_BASE}`);
     console.log(`State file: ${STATE_PATH}`);
+    console.log(`Latest-only mode: ${LATEST_ONLY ? "on" : "off"}`);
   }
 
   do {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silicaclaw/cli",
-  "version": "2026.3.20-3",
+  "version": "2026.3.20-5",
   "private": false,
   "publishConfig": {
     "access": "public"

package/packages/network/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";

package/packages/network/dist/packages/network/src/relayPreview.js

@@ -109,7 +109,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 });
@@ -258,8 +257,10 @@ 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.stats.received_total += 1;
@@ -340,9 +341,13 @@ 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) {
@@ -407,13 +412,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);
@@ -427,6 +457,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()) {

package/packages/network/src/relayPreview.ts

@@ -34,6 +34,10 @@ type RelayPeer = {
   last_seen_at: number;
   messages_seen: number;
   reconnect_attempts: number;
+  meta?: {
+    signal_queue_size?: number;
+    relay_queue_size?: number;
+  };
 };
 
 type RelayDiagnostics = {
@@ -227,7 +231,6 @@ export class RelayPreviewAdapter implements NetworkAdapter {
     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 });
@@ -375,8 +378,10 @@ export class RelayPreviewAdapter implements NetworkAdapter {
     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);
   }
 
   private onEnvelope(envelope: unknown): void {
@@ -457,9 +462,13 @@ export class RelayPreviewAdapter implements NetworkAdapter {
 
   private async joinRoom(reason: string): Promise<void> {
     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 });
   }
 
@@ -528,13 +537,38 @@ export class RelayPreviewAdapter implements NetworkAdapter {
   }
 
   private updatePeersFromList(values: unknown[]): void {
-    const peerIds = values.map((value) => String(value || "").trim()).filter(Boolean);
+    const parsedPeers: Array<{ peer_id: string; meta?: RelayPeer["meta"] }> = [];
+    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 as Record<string, unknown>;
+        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<string, RelayPeer>();
-    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);
       if (!existing) {
@@ -547,6 +581,7 @@ export class RelayPreviewAdapter implements NetworkAdapter {
         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()) {

package/scripts/silicaclaw-cli.mjs

@@ -224,10 +224,12 @@ function shellInitTargets() {
     shell.endsWith("/bash") ||
     process.env.BASH_VERSION ||
     existsSync(resolve(home, ".bashrc")) ||
-    existsSync(resolve(home, ".bash_profile"))
+    existsSync(resolve(home, ".bash_profile")) ||
+    existsSync(resolve(home, ".profile"))
   ) {
     add(resolve(home, ".bashrc"));
     add(resolve(home, ".bash_profile"));
+    add(resolve(home, ".profile"));
   }
 
   if (targets.length === 0) {
@@ -280,6 +282,7 @@ function installPersistentCommand(specifier = readPackageVersion()) {
   kv("Command", "silicaclaw");
   console.log("");
   kv("Activate", `source "${envFile}"`);
+  kv("Current shell", "run Activate now if `silicaclaw` is not found yet");
   if (configuredFiles.length > 0) {
     kv("Startup", "configured");
   } else {

package/scripts/silicaclaw-gateway.mjs

@@ -74,6 +74,11 @@ function readJson(file) {
   }
 }
 
+function readPackageVersionFrom(dir) {
+  const pkg = readJson(resolve(dir, "package.json"));
+  return String(pkg?.version || "latest").trim() || "latest";
+}
+
 function isSilicaClawDir(dir) {
   const pkgPath = join(dir, "package.json");
   if (!existsSync(pkgPath)) return false;
@@ -144,6 +149,107 @@ function ensureStateDir() {
   mkdirSync(STATE_DIR, { recursive: true });
 }
 
+function userShimDir() {
+  return join(homedir(), ".silicaclaw", "bin");
+}
+
+function userShimPath() {
+  return join(userShimDir(), "silicaclaw");
+}
+
+function userEnvFile() {
+  return join(homedir(), ".silicaclaw", "env.sh");
+}
+
+function userNpmCacheDir() {
+  return join(homedir(), ".silicaclaw", "npm-cache");
+}
+
+function preferredShellRcFile() {
+  const shell = String(process.env.SHELL || "");
+  if (shell.endsWith("/zsh")) return resolve(homedir(), ".zshrc");
+  if (shell.endsWith("/bash")) return resolve(homedir(), ".bashrc");
+  if (process.env.ZSH_VERSION) return resolve(homedir(), ".zshrc");
+  return resolve(homedir(), ".bashrc");
+}
+
+function shellInitTargets() {
+  const home = homedir();
+  const shell = String(process.env.SHELL || "");
+  const targets = [];
+  const add = (filePath) => {
+    if (!targets.includes(filePath)) targets.push(filePath);
+  };
+
+  if (shell.endsWith("/zsh") || process.env.ZSH_VERSION || existsSync(resolve(home, ".zshrc"))) {
+    add(resolve(home, ".zshrc"));
+  }
+
+  if (
+    shell.endsWith("/bash") ||
+    process.env.BASH_VERSION ||
+    existsSync(resolve(home, ".bashrc")) ||
+    existsSync(resolve(home, ".bash_profile")) ||
+    existsSync(resolve(home, ".profile"))
+  ) {
+    add(resolve(home, ".bashrc"));
+    add(resolve(home, ".bash_profile"));
+    add(resolve(home, ".profile"));
+  }
+
+  if (targets.length === 0) {
+    add(preferredShellRcFile());
+  }
+  return targets;
+}
+
+function ensureLineInFile(filePath, block) {
+  try {
+    const current = existsSync(filePath) ? readFileSync(filePath, "utf8") : "";
+    if (current.includes(block.trim())) return true;
+    const next = `${current.replace(/\s*$/, "")}\n\n${block}\n`;
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, next, "utf8");
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function shimScriptText(specifier = "latest") {
+  return [
+    "#!/usr/bin/env bash",
+    "set -euo pipefail",
+    'export npm_config_cache="${npm_config_cache:-$HOME/.silicaclaw/npm-cache}"',
+    `exec npx -y @silicaclaw/cli@${specifier} "$@"`,
+    "",
+  ].join("\n");
+}
+
+function ensureUserCommandInstalled() {
+  const version = readPackageVersionFrom(APP_DIR);
+  const envBlock = [
+    "#!/usr/bin/env bash",
+    'export PATH="$HOME/.silicaclaw/bin:$PATH"',
+    'export npm_config_cache="$HOME/.silicaclaw/npm-cache"',
+    "",
+  ].join("\n");
+  const rcBlock = [
+    "# >>> silicaclaw >>>",
+    '[ -f "$HOME/.silicaclaw/env.sh" ] && . "$HOME/.silicaclaw/env.sh"',
+    "# <<< silicaclaw <<<",
+  ].join("\n");
+
+  mkdirSync(userShimDir(), { recursive: true });
+  mkdirSync(userNpmCacheDir(), { recursive: true });
+  writeFileSync(userEnvFile(), envBlock, { encoding: "utf8", mode: 0o755 });
+  writeFileSync(userShimPath(), shimScriptText(version), { encoding: "utf8", mode: 0o755 });
+
+  for (const filePath of shellInitTargets()) {
+    ensureLineInFile(filePath, rcBlock);
+  }
+}
+
 function ensureLaunchAgentsDir() {
   mkdirSync(LAUNCH_AGENTS_DIR, { recursive: true });
 }
@@ -797,6 +903,7 @@ async function stopAll() {
 
 async function startAll() {
   ensureStateDir();
+  ensureUserCommandInstalled();
 
   const mode = parseMode(parseFlag("mode", process.env.NETWORK_MODE || DEFAULT_NETWORK_MODE));
   const adapter = adapterForMode(mode);
@@ -923,6 +1030,7 @@ async function startAll() {
 }
 
 async function restartAll() {
+  ensureUserCommandInstalled();
   if (!isLaunchdPlatform()) {
     await stopAll();
     await startAll();