@silicaclaw/cli 2026.3.19-2 → 2026.3.19-21

package/apps/public-explorer/dist/apps/public-explorer/src/server.d.ts

@@ -0,0 +1 @@
+export {};

package/apps/public-explorer/dist/apps/public-explorer/src/server.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const express_1 = __importDefault(require("express"));
+const cors_1 = __importDefault(require("cors"));
+const path_1 = require("path");
+const fs_1 = require("fs");
+const silicaclaw_defaults_json_1 = __importDefault(require("../../../config/silicaclaw-defaults.json"));
+const app = (0, express_1.default)();
+const port = Number(process.env.PORT || silicaclaw_defaults_json_1.default.ports.public_explorer);
+function resolvePublicExplorerStaticDir() {
+    const candidates = [
+        (0, path_1.resolve)(process.cwd(), "public"),
+        (0, path_1.resolve)(process.cwd(), "apps", "public-explorer", "public"),
+        (0, path_1.resolve)(__dirname, "..", "public"),
+        (0, path_1.resolve)(__dirname, "..", "..", "apps", "public-explorer", "public"),
+    ];
+    for (const dir of candidates) {
+        if ((0, fs_1.existsSync)((0, path_1.resolve)(dir, "index.html"))) {
+            return dir;
+        }
+    }
+    return candidates[0];
+}
+app.use((0, cors_1.default)({ origin: true }));
+app.get("/api/config", (_req, res) => {
+    res.json({
+        ok: true,
+        data: {
+            local_console_api_base: silicaclaw_defaults_json_1.default.bridge.api_base,
+            local_console_port: silicaclaw_defaults_json_1.default.ports.local_console,
+        },
+    });
+});
+app.use(express_1.default.static(resolvePublicExplorerStaticDir()));
+app.listen(port, () => {
+    // eslint-disable-next-line no-console
+    console.log(`SilicaClaw public-explorer running: http://localhost:${port}`);
+});

package/apps/public-explorer/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/public-explorer/dist/server.d.ts

@@ -0,0 +1 @@
+export {};

package/apps/public-explorer/dist/server.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const express_1 = __importDefault(require("express"));
+const cors_1 = __importDefault(require("cors"));
+const path_1 = require("path");
+const fs_1 = require("fs");
+const app = (0, express_1.default)();
+const port = Number(process.env.PORT || 4311);
+function resolvePublicExplorerStaticDir() {
+    const candidates = [
+        (0, path_1.resolve)(process.cwd(), "public"),
+        (0, path_1.resolve)(process.cwd(), "apps", "public-explorer", "public"),
+        (0, path_1.resolve)(__dirname, "..", "public"),
+        (0, path_1.resolve)(__dirname, "..", "..", "apps", "public-explorer", "public"),
+    ];
+    for (const dir of candidates) {
+        if ((0, fs_1.existsSync)((0, path_1.resolve)(dir, "index.html"))) {
+            return dir;
+        }
+    }
+    return candidates[0];
+}
+app.use((0, cors_1.default)({ origin: true }));
+app.use(express_1.default.static(resolvePublicExplorerStaticDir()));
+app.listen(port, () => {
+    // eslint-disable-next-line no-console
+    console.log(`SilicaClaw public-explorer running: http://localhost:${port}`);
+});

package/apps/public-explorer/package.json

@@ -4,6 +4,7 @@
   "private": true,
   "scripts": {
     "dev": "tsx src/server.ts",
+    "start": "node dist/server.js",
     "build": "tsc -p tsconfig.json",
     "check": "tsc -p tsconfig.json --noEmit"
   },

package/apps/public-explorer/public/app/app.js

@@ -0,0 +1,322 @@
+import { appTemplate } from "./template.js";
+import { createI18n } from "./i18n.js";
+import { TRANSLATIONS } from "./translations.js";
+import {
+  escapeHtml,
+  formatMessageBody,
+  freshnessStatusText,
+  shortId,
+  toPrettyJson,
+  verificationStatusText,
+} from "./utils.js";
+
+const root = document.getElementById("app-root");
+if (!root) {
+  throw new Error("Missing root element: app-root");
+}
+root.innerHTML = appTemplate;
+
+      const i18n = createI18n(TRANSLATIONS);
+      const t = i18n.t;
+      function setLocale(locale) {
+        return i18n.setLocale(locale);
+      }
+      function applyTranslations() {
+        document.title = t('meta.title');
+        document.getElementById('metaDescription').setAttribute('content', t('meta.description'));
+        document.getElementById('ogTitle').setAttribute('content', t('meta.title'));
+        document.getElementById('ogDescription').setAttribute('content', t('meta.socialDescription'));
+        document.getElementById('twitterTitle').setAttribute('content', t('meta.title'));
+        document.getElementById('twitterDescription').setAttribute('content', t('meta.socialDescription'));
+        document.getElementById('pageTitle').textContent = t('page.title');
+        document.getElementById('pageSubtitle').textContent = t('page.subtitle');
+        document.getElementById('themeDarkBtn').textContent = t('page.themeDark');
+        document.getElementById('themeLightBtn').textContent = t('page.themeLight');
+        document.getElementById('q').setAttribute('placeholder', t('page.searchPlaceholder'));
+        document.getElementById('searchBtn').textContent = t('page.search');
+        document.getElementById('directoryTitle').textContent = t('page.directoryTitle');
+        document.getElementById('directorySubtitle').textContent = t('page.directorySubtitle');
+        document.getElementById('streamTitle').textContent = t('page.streamTitle');
+        document.getElementById('streamSubtitle').textContent = t('page.streamSubtitle');
+        document.getElementById('refreshMessagesBtn').textContent = t('page.refreshMessages');
+      }
+
+      setLocale(i18n.getCurrentLocale());
+      applyTranslations();
+
+      let API_BASE = localStorage.getItem('silicaclaw_api_base') || '';
+      const state = document.getElementById('state');
+      const cards = document.getElementById('cards');
+      const detail = document.getElementById('detail');
+      const messageStreamList = document.getElementById('messageStreamList');
+      let publicMessages = [];
+
+      async function resolveApiBase() {
+        if (API_BASE) {
+          return API_BASE;
+        }
+        try {
+          const res = await fetch('/api/config');
+          const json = await res.json().catch(() => null);
+          const configuredBase = String(json?.data?.local_console_api_base || '').trim();
+          if (res.ok && json?.ok && configuredBase) {
+            API_BASE = configuredBase.replace(/\/+$/, '');
+            return API_BASE;
+          }
+        } catch {
+          // Ignore and fall back to localhost convention below.
+        }
+        API_BASE = `${location.protocol}//${location.hostname}:4310`;
+        return API_BASE;
+      }
+
+      function toast(msg) {
+        const t = document.getElementById('toast');
+        t.textContent = msg;
+        t.classList.add('show');
+        setTimeout(() => t.classList.remove('show'), 1800);
+      }
+      async function copyText(text, btn, successText = null) {
+        try {
+          await navigator.clipboard.writeText(text);
+          toast(successText || t('common.copied'));
+          if (!btn) return;
+          const old = btn.textContent || '';
+          btn.disabled = true;
+          btn.textContent = t('common.copied');
+          setTimeout(() => {
+            btn.textContent = old;
+            btn.disabled = false;
+          }, 900);
+        } catch (err) {
+          toast(err instanceof Error ? err.message : t('common.copyFailed'));
+        }
+      }
+      function applyTheme(mode) {
+        const next = mode === 'light' ? 'light' : 'dark';
+        document.documentElement.setAttribute('data-theme-mode', next);
+        localStorage.setItem('silicaclaw_theme_mode', next);
+        document.getElementById('themeDarkBtn').classList.toggle('active', next === 'dark');
+        document.getElementById('themeLightBtn').classList.toggle('active', next === 'light');
+      }
+
+      async function api(path) {
+        const apiBase = await resolveApiBase();
+        const res = await fetch(`${apiBase}${path}`);
+        const json = await res.json().catch(() => null);
+        if (!res.ok || !json || !json.ok) throw new Error(json?.error?.message || t('common.requestFailed', { status: String(res.status) }));
+        return json;
+      }
+
+      function renderState(text) { state.innerHTML = `<div class="state">${text}</div>`; }
+      function clearState() { state.innerHTML = ''; }
+      function renderMessageStream(messages) {
+        if (!Array.isArray(messages) || !messages.length) {
+          messageStreamList.innerHTML = `<div class="state">${t('state.noMessages')}</div>`;
+          return;
+        }
+        messageStreamList.innerHTML = messages.map((item) => `
+          <article class="stream-item" data-agent-id="${item.agent_id}">
+            <div class="stream-item__meta">
+              <div>
+                <strong>${escapeHtml(item.display_name || t('card.unnamedAgent'))}</strong>
+                <span class="mono muted" style="margin-left:8px;">${escapeHtml(shortId(item.agent_id || ''))}</span>
+                ${item.online ? `<span class="badge ok" style="margin-left:8px;">${t('card.online')}</span>` : `<span class="badge warn" style="margin-left:8px;">${t('card.offline')}</span>`}
+              </div>
+              <div class="mono muted">${item.created_at ? new Date(item.created_at).toLocaleString() : '-'}</div>
+            </div>
+            <div class="stream-item__body">${formatMessageBody(item.body || '')}</div>
+          </article>
+        `).join('');
+        messageStreamList.querySelectorAll('.stream-item').forEach((el) => {
+          el.addEventListener('click', () => {
+            if (el.dataset.agentId) {
+              location.hash = `#agent/${el.dataset.agentId}`;
+            }
+          });
+        });
+      }
+
+      async function refreshMessages() {
+        try {
+          const payload = (await api('/api/messages?limit=24')).data || {};
+          publicMessages = Array.isArray(payload.items) ? payload.items : [];
+          renderMessageStream(publicMessages);
+        } catch (e) {
+          messageStreamList.innerHTML = `<div class="state">${t('state.messagesFailed', { message: e instanceof Error ? e.message : t('common.unknownError') })}</div>`;
+        }
+      }
+
+      async function search() {
+        try {
+          renderState(t('state.searching'));
+          const q = document.getElementById('q').value.trim();
+          const profiles = (await api(`/api/search?q=${encodeURIComponent(q)}`)).data || [];
+          if (!profiles.length) {
+            cards.innerHTML = '';
+            renderState(q ? t('state.noResult', { query: q }) : t('state.noAgents'));
+            return;
+          }
+          clearState();
+          cards.innerHTML = profiles.map((p) => `
+            <article class="card" data-id="${p.agent_id}">
+              <div style="display:flex; justify-content:space-between; gap:8px; align-items:center;">
+                <h3 style="margin:0;">${p.display_name || t('card.unnamedAgent')}</h3>
+                ${p.openclaw_bound ? `<span class="badge">${t('card.openclaw')}</span>` : ''}
+              </div>
+              <div class="muted" style="margin-top:6px;">${p.bio || t('card.noBioYet')}</div>
+              <div class="chips">${(p.tags || []).map((t) => `<span class="chip">${t}</span>`).join('') || `<span class="muted">${t('card.noTags')}</span>`}</div>
+              <div class="chips">${(p.capabilities_summary || []).map((t) => `<span class="chip">${t}</span>`).join('') || `<span class="muted">${t('card.noCapabilities')}</span>`}</div>
+              <div class="chips">
+                <span class="badge ${p.verification_status === 'verified' ? 'ok' : p.verification_status === 'stale' ? 'warn' : 'err'}">${verificationStatusText(t, p.verification_status)}</span>
+                <span class="badge ${p.freshness_status === 'live' ? 'ok' : p.freshness_status === 'recently_seen' ? 'warn' : 'err'}">${freshnessStatusText(t, p.freshness_status)}</span>
+              </div>
+              <div class="meta">
+                <span class="mono">${shortId(p.agent_id)} · ${t('card.mode')}:${p.network_mode || t('card.unknown')}</span>
+                <span class="${p.online ? 'online' : 'offline'}">${p.online ? t('card.online') : t('card.offline')}</span>
+              </div>
+            </article>
+          `).join('');
+          cards.querySelectorAll('.card').forEach((el) => el.addEventListener('click', () => {
+            location.hash = `#agent/${el.dataset.id}`;
+          }));
+        } catch (e) {
+          cards.innerHTML = '';
+          renderState(t('state.searchFailed', { message: e instanceof Error ? e.message : t('common.unknownError') }));
+        }
+      }
+
+      async function showDetail(agentId) {
+        cards.classList.add('hidden');
+        state.classList.add('hidden');
+        detail.classList.remove('hidden');
+        try {
+          const d = (await api(`/api/agents/${agentId}`)).data;
+          const p = d.profile;
+          const s = d.summary || {};
+          const recentMessages = publicMessages.filter((item) => item.agent_id === agentId).slice(0, 6);
+          detail.innerHTML = `
+            <button id="backBtn">${t('common.back')}</button>
+            <div class="detail-hero">
+              <div>
+                <h2 style="margin:0;">${p.display_name || t('card.unnamedAgent')}</h2>
+                <div class="muted" style="margin-top:6px;">${p.bio || t('detail.noBioProvided')}</div>
+              </div>
+              <div>
+                ${s.openclaw_bound ? `<span class="badge">${t('detail.openclawAgent')}</span>` : ''}
+              </div>
+            </div>
+            <h3>${t('detail.identity')}</h3>
+            <div class="detail-grid">
+              <div class="detail-item"><b>${t('detail.displayName')}:</b> ${p.display_name || t('card.unnamedAgent')}</div>
+              <div class="detail-item"><b>${t('detail.agentId')}:</b> <span class="mono">${p.agent_id}</span></div>
+              <div class="detail-item"><b>${t('detail.publicKeyFingerprint')}:</b> <span class="mono">${s.public_key_fingerprint || t('detail.unavailable')}</span></div>
+              <div class="detail-item"><b>${t('detail.profileVersion')}:</b> ${s.profile_version || 'v1'}</div>
+            </div>
+            <h3>${t('detail.verifiedClaims')}</h3>
+            <div class="muted mono">${t('detail.sourceSignedClaims')}</div>
+            <p class="chips">${(s.capabilities_summary || []).map((t) => `<span class="chip">${t}</span>`).join('') || `<span class="muted">${t('detail.noCapabilitiesSummary')}</span>`}</p>
+            <p class="chips">${(s.tags || p.tags || []).map((t) => `<span class="chip">${t}</span>`).join('') || `<span class="muted">${t('card.noTags')}</span>`}</p>
+            <div class="detail-grid">
+              <div class="detail-item"><b>${t('detail.verificationStatus')}:</b> <span class="badge ${s.verification_status === 'verified' ? 'ok' : s.verification_status === 'stale' ? 'warn' : 'err'}">${verificationStatusText(t, s.verification_status)}</span></div>
+              <div class="detail-item"><b>${t('detail.verifiedProfile')}:</b> ${s.verified_profile ? t('detail.yes') : t('detail.no')}</div>
+              <div class="detail-item"><b>${t('detail.profileUpdatedAt')}:</b> ${s.profile_updated_at ? new Date(s.profile_updated_at).toLocaleString() : '-'}</div>
+              <div class="detail-item"><b>${t('detail.publicEnabled')}:</b> ${s.signed_claims?.public_enabled ? t('detail.trueText') : t('detail.falseText')}</div>
+            </div>
+            <h3>${t('detail.observedPresence')}</h3>
+            <div class="muted mono">${t('detail.sourceObservedState')}</div>
+            <div class="detail-grid">
+              <div class="detail-item"><b>${t('card.online')}:</b> <span class="${d.online ? 'online' : 'offline'}">${d.online ? t('card.online') : t('card.offline')}</span></div>
+              <div class="detail-item"><b>${t('detail.freshness')}:</b> <span class="badge ${s.freshness_status === 'live' ? 'ok' : s.freshness_status === 'recently_seen' ? 'warn' : 'err'}">${freshnessStatusText(t, s.freshness_status)}</span></div>
+              <div class="detail-item"><b>${t('detail.verifiedPresenceRecent')}:</b> ${s.verified_presence_recent ? t('detail.yes') : t('detail.no')}</div>
+              <div class="detail-item"><b>${t('detail.presenceSeenAt')}:</b> ${
+                s.visibility && s.visibility.show_last_seen === false
+                  ? t('detail.hiddenByVisibility')
+                  : (s.presence_seen_at ? new Date(s.presence_seen_at).toLocaleString() : '-')
+              }</div>
+            </div>
+            <h3>${t('detail.integration')}</h3>
+            <div class="muted mono">${t('detail.sourceIntegrationMetadata')}</div>
+            <div class="detail-grid">
+              <div class="detail-item"><b>${t('detail.networkMode')}:</b> ${s.network_mode || t('card.unknown')}</div>
+              <div class="detail-item"><b>${t('detail.openclawBound')}:</b> ${s.openclaw_bound ? t('detail.yes') : t('detail.no')}</div>
+            </div>
+            <h3>${t('detail.publicVisibility')}</h3>
+            <div class="detail-grid">
+              <div class="detail-item"><b>${t('detail.visible')}:</b> ${(s.public_visibility?.visible_fields || []).join(', ') || '-'}</div>
+              <div class="detail-item"><b>${t('detail.hidden')}:</b> ${(s.public_visibility?.hidden_fields || []).join(', ') || '-'}</div>
+            </div>
+            <h3>${t('detail.recentMessages')}</h3>
+            ${
+              recentMessages.length
+                ? `<div class="stream-list">${recentMessages.map((item) => `
+                    <article class="stream-item">
+                      <div class="stream-item__meta">
+                        <div class="mono muted">${item.created_at ? new Date(item.created_at).toLocaleString() : '-'}</div>
+                      </div>
+                      <div class="stream-item__body">${formatMessageBody(item.body || '')}</div>
+                    </article>
+                  `).join('')}</div>`
+                : `<div class="state">${t('detail.noRecentMessages')}</div>`
+            }
+            <p><b>${t('detail.agentId')}:</b> <span class="mono">${p.agent_id}</span> <button class="secondary" id="copyAgentIdBtn">${t('detail.copy')}</button></p>
+            <p><b>${t('detail.publicKeyFingerprint')}:</b> <span class="mono">${s.public_key_fingerprint || t('detail.unavailable')}</span> <button class="secondary" id="copyFingerprintBtn">${t('detail.copy')}</button></p>
+            <p><button class="secondary" id="copyPublicSummaryBtn">${t('detail.copyPublicSummaryLabel')}</button> <button class="secondary" id="copyIdentitySummaryBtn">${t('detail.copyIdentitySummaryLabel')}</button></p>
+          `;
+          document.getElementById('backBtn').addEventListener('click', () => { location.hash = ''; });
+          document.getElementById('copyAgentIdBtn').addEventListener('click', async (event) => copyText(p.agent_id, event.currentTarget, t('detail.copyAgentId')));
+          document.getElementById('copyFingerprintBtn').addEventListener('click', async (event) => copyText(s.public_key_fingerprint || t('detail.unavailable'), event.currentTarget, t('detail.copyFingerprint')));
+          document.getElementById('copyPublicSummaryBtn').addEventListener('click', async (event) => copyText(toPrettyJson(s), event.currentTarget, t('detail.copyPublicSummary')));
+          document.getElementById('copyIdentitySummaryBtn').addEventListener('click', async () => {
+            const identitySummary = {
+              agent_id: p.agent_id,
+              display_name: p.display_name || "",
+              public_key_fingerprint: s.public_key_fingerprint || null,
+              profile_version: s.profile_version || "v1",
+            };
+            await copyText(toPrettyJson(identitySummary), document.getElementById('copyIdentitySummaryBtn'), t('detail.copyIdentitySummary'));
+          });
+        } catch (e) {
+          detail.innerHTML = `<div class="state">${t('common.loadFailed', { message: e instanceof Error ? e.message : t('common.unknownError') })}</div>`;
+        }
+      }
+
+      function route() {
+        if (location.hash.startsWith('#agent/')) {
+          showDetail(location.hash.slice(7));
+        } else {
+          detail.classList.add('hidden');
+          cards.classList.remove('hidden');
+          state.classList.remove('hidden');
+          search();
+        }
+      }
+
+      document.getElementById('searchBtn').addEventListener('click', search);
+      document.getElementById('refreshMessagesBtn').addEventListener('click', refreshMessages);
+      document.getElementById('q').addEventListener('keydown', (e) => { if (e.key === 'Enter') search(); });
+      document.getElementById('themeDarkBtn').addEventListener('click', () => applyTheme('dark'));
+      document.getElementById('themeLightBtn').addEventListener('click', () => applyTheme('light'));
+      window.addEventListener('hashchange', route);
+
+      (() => {
+        const logo = document.getElementById('brandLogo');
+        const fallback = document.getElementById('brandFallback');
+        if (!logo || !fallback) return;
+        logo.addEventListener('error', () => {
+          logo.style.display = 'none';
+          fallback.classList.remove('hidden');
+        });
+        logo.addEventListener('load', () => {
+          logo.style.display = 'block';
+          fallback.classList.add('hidden');
+        });
+      })();
+
+      applyTheme(localStorage.getItem('silicaclaw_theme_mode') || 'dark');
+      refreshMessages();
+      route();
+      setInterval(() => {
+        refreshMessages();
+        if (!location.hash) search();
+      }, 5000);

package/apps/public-explorer/public/app/i18n.js

@@ -0,0 +1,46 @@
+export function createI18n(translations) {
+  const LOCALE_STORAGE_KEY = "silicaclaw.i18n.locale";
+  const DEFAULT_LOCALE = "en";
+  const SUPPORTED_LOCALES = ["en", "zh-CN"];
+
+  function isSupportedLocale(value) {
+    return SUPPORTED_LOCALES.includes(value);
+  }
+
+  function resolveNavigatorLocale(language) {
+    return String(language || "").toLowerCase().startsWith("zh") ? "zh-CN" : DEFAULT_LOCALE;
+  }
+
+  function resolveInitialLocale() {
+    const saved = localStorage.getItem(LOCALE_STORAGE_KEY);
+    if (isSupportedLocale(saved)) return saved;
+    return resolveNavigatorLocale(globalThis.navigator?.language || "");
+  }
+
+  let currentLocale = resolveInitialLocale();
+
+  function t(key, params = {}) {
+    const parts = key.split(".");
+    let value = translations[currentLocale];
+    for (const part of parts) {
+      value = value && typeof value === "object" ? value[part] : undefined;
+    }
+    if (typeof value !== "string") {
+      value = parts.reduce((acc, part) => (acc && typeof acc === "object" ? acc[part] : undefined), translations[DEFAULT_LOCALE]);
+    }
+    if (typeof value !== "string") return key;
+    return value.replace(/\{(\w+)\}/g, (_, name) => params[name] ?? `{${name}}`);
+  }
+
+  function setLocale(locale) {
+    currentLocale = isSupportedLocale(locale) ? locale : DEFAULT_LOCALE;
+    document.documentElement.lang = currentLocale;
+    return currentLocale;
+  }
+
+  return {
+    getCurrentLocale: () => currentLocale,
+    setLocale,
+    t,
+  };
+}