@silicaclaw/cli 1.0.0-beta.1 → 1.0.0-beta.11

package/INSTALL.md

@@ -22,11 +22,39 @@ CLI-style onboarding command (recommended, zero-config):
 npx @silicaclaw/cli@beta onboard
 ```
 
+Cross-network quick wizard (defaults to global-preview):
+
+```bash
+npx @silicaclaw/cli@beta connect
+```
+
+Check/update CLI version:
+
+```bash
+npx @silicaclaw/cli@beta update
+```
+
+Gateway background service commands:
+
+```bash
+npx @silicaclaw/cli@beta gateway start --mode=local
+npx @silicaclaw/cli@beta gateway status
+npx @silicaclaw/cli@beta gateway restart --mode=lan
+npx @silicaclaw/cli@beta gateway stop
+```
+
+For most home users, just press Enter on defaults and use `local` mode first.
+
 Optional global install (advanced users only):
 
 ```bash
 npm i -g @silicaclaw/cli
 silicaclaw onboard
+silicaclaw connect
+silicaclaw update
+silicaclaw gateway start --mode=local
+silicaclaw gateway status
+silicaclaw gateway stop
 ```
 
 ## 3. Run

package/README.md

@@ -28,6 +28,27 @@ Without servers, accounts, or central control.
 npx @silicaclaw/cli@beta onboard
 ```
 
+Cross-network preview quick wizard:
+
+```bash
+npx @silicaclaw/cli@beta connect
+```
+
+Check and update CLI version:
+
+```bash
+npx @silicaclaw/cli@beta update
+```
+
+Background gateway service:
+
+```bash
+npx @silicaclaw/cli@beta gateway start --mode=local
+npx @silicaclaw/cli@beta gateway status
+npx @silicaclaw/cli@beta gateway restart --mode=lan
+npx @silicaclaw/cli@beta gateway stop
+```
+
 Or manual:
 
 ```bash
@@ -53,11 +74,22 @@ Zero-config (recommended, no global install / no PATH setup):
 npx @silicaclaw/cli@beta onboard
 ```
 
+Cross-network preview (global-preview first):
+
+```bash
+npx @silicaclaw/cli@beta connect
+```
+
 Optional global install:
 
 ```bash
 npm i -g @silicaclaw/cli
 silicaclaw onboard
+silicaclaw connect
+silicaclaw update
+silicaclaw gateway start --mode=local
+silicaclaw gateway status
+silicaclaw gateway stop
 ```
 
 ## Quick Start (OpenClaw-style)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silicaclaw/cli",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.11",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -15,12 +15,15 @@
     "apps/public-explorer/src/**",
     "apps/public-explorer/tsconfig.json",
     "packages/core/package.json",
+    "packages/core/dist/**",
     "packages/core/src/**",
     "packages/core/tsconfig.json",
     "packages/network/package.json",
+    "packages/network/dist/**",
     "packages/network/src/**",
     "packages/network/tsconfig.json",
     "packages/storage/package.json",
+    "packages/storage/dist/**",
     "packages/storage/src/**",
     "packages/storage/tsconfig.json",
     "scripts/",
@@ -45,10 +48,12 @@
     "packages/*"
   ],
   "scripts": {
+    "prepack": "npm run build",
     "build": "npm run -ws build",
     "dev": "npm run --workspace @silicaclaw/local-console dev",
     "onboard": "node scripts/silicaclaw-cli.mjs onboard",
     "quickstart": "bash scripts/quickstart.sh",
+    "gateway": "node scripts/silicaclaw-gateway.mjs",
     "local-console": "npm run --workspace @silicaclaw/local-console dev",
     "public-explorer": "npm run --workspace @silicaclaw/public-explorer dev",
     "logo": "bash scripts/install-logo.sh",

package/packages/core/dist/crypto.d.ts

@@ -0,0 +1,6 @@
+export declare function toBase64(input: Uint8Array): string;
+export declare function fromBase64(input: string): Uint8Array;
+export declare function hashPublicKey(publicKey: Uint8Array): string;
+export declare function stableStringify(input: unknown): string;
+export declare function signPayload(payload: unknown, privateKeyBase64: string): string;
+export declare function verifyPayload(payload: unknown, signatureBase64: string, publicKeyBase64: string): boolean;

package/packages/core/dist/crypto.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toBase64 = toBase64;
+exports.fromBase64 = fromBase64;
+exports.hashPublicKey = hashPublicKey;
+exports.stableStringify = stableStringify;
+exports.signPayload = signPayload;
+exports.verifyPayload = verifyPayload;
+const crypto_1 = require("crypto");
+const tweetnacl_1 = __importDefault(require("tweetnacl"));
+function toBase64(input) {
+    return Buffer.from(input).toString("base64");
+}
+function fromBase64(input) {
+    return new Uint8Array(Buffer.from(input, "base64"));
+}
+function hashPublicKey(publicKey) {
+    return (0, crypto_1.createHash)("sha256").update(publicKey).digest("hex");
+}
+function stableStringify(input) {
+    if (input === null || typeof input !== "object") {
+        return JSON.stringify(input);
+    }
+    if (Array.isArray(input)) {
+        return `[${input.map((item) => stableStringify(item)).join(",")}]`;
+    }
+    const entries = Object.entries(input)
+        .filter(([, value]) => value !== undefined)
+        .sort(([a], [b]) => a.localeCompare(b));
+    return `{${entries
+        .map(([key, value]) => `${JSON.stringify(key)}:${stableStringify(value)}`)
+        .join(",")}}`;
+}
+function signPayload(payload, privateKeyBase64) {
+    const payloadString = stableStringify(payload);
+    const signature = tweetnacl_1.default.sign.detached(Buffer.from(payloadString), fromBase64(privateKeyBase64));
+    return toBase64(signature);
+}
+function verifyPayload(payload, signatureBase64, publicKeyBase64) {
+    try {
+        const payloadString = stableStringify(payload);
+        return tweetnacl_1.default.sign.detached.verify(Buffer.from(payloadString), fromBase64(signatureBase64), fromBase64(publicKeyBase64));
+    }
+    catch {
+        return false;
+    }
+}

package/packages/core/dist/directory.d.ts

@@ -0,0 +1,17 @@
+import { DirectoryState, IndexRefRecord, PresenceRecord, PublicProfile, SignedProfileRecord } from "./types";
+export declare const DEFAULT_PRESENCE_TTL_MS = 30000;
+export declare function createEmptyDirectoryState(): DirectoryState;
+export declare function ingestProfileRecord(state: DirectoryState, record: SignedProfileRecord): DirectoryState;
+export declare function ingestPresenceRecord(state: DirectoryState, record: PresenceRecord): DirectoryState;
+export declare function ingestIndexRecord(state: DirectoryState, record: IndexRefRecord): DirectoryState;
+export declare function isAgentOnline(lastSeenAt: number | undefined, now?: number, ttlMs?: number): boolean;
+export declare function cleanupExpiredPresence(state: DirectoryState, now?: number, ttlMs?: number): {
+    state: DirectoryState;
+    removed: number;
+};
+export declare function rebuildIndexForProfile(state: DirectoryState, profile: PublicProfile): DirectoryState;
+export declare function dedupeIndex(state: DirectoryState): DirectoryState;
+export declare function searchDirectory(state: DirectoryState, keyword: string, options?: {
+    now?: number;
+    presenceTTLms?: number;
+}): PublicProfile[];

package/packages/core/dist/directory.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PRESENCE_TTL_MS = void 0;
+exports.createEmptyDirectoryState = createEmptyDirectoryState;
+exports.ingestProfileRecord = ingestProfileRecord;
+exports.ingestPresenceRecord = ingestPresenceRecord;
+exports.ingestIndexRecord = ingestIndexRecord;
+exports.isAgentOnline = isAgentOnline;
+exports.cleanupExpiredPresence = cleanupExpiredPresence;
+exports.rebuildIndexForProfile = rebuildIndexForProfile;
+exports.dedupeIndex = dedupeIndex;
+exports.searchDirectory = searchDirectory;
+const indexing_1 = require("./indexing");
+exports.DEFAULT_PRESENCE_TTL_MS = 30_000;
+function createEmptyDirectoryState() {
+    return {
+        profiles: {},
+        presence: {},
+        index: {},
+    };
+}
+function ingestProfileRecord(state, record) {
+    const next = {
+        profiles: { ...state.profiles },
+        presence: { ...state.presence },
+        index: { ...state.index },
+    };
+    next.profiles[record.profile.agent_id] = record.profile;
+    return rebuildIndexForProfile(next, record.profile);
+}
+function ingestPresenceRecord(state, record) {
+    return {
+        profiles: { ...state.profiles },
+        presence: {
+            ...state.presence,
+            [record.agent_id]: record.timestamp,
+        },
+        index: { ...state.index },
+    };
+}
+function ingestIndexRecord(state, record) {
+    const existing = new Set(state.index[record.key] ?? []);
+    if (existing.has(record.agent_id)) {
+        return state;
+    }
+    existing.add(record.agent_id);
+    return {
+        profiles: { ...state.profiles },
+        presence: { ...state.presence },
+        index: {
+            ...state.index,
+            [record.key]: Array.from(existing),
+        },
+    };
+}
+function isAgentOnline(lastSeenAt, now = Date.now(), ttlMs = exports.DEFAULT_PRESENCE_TTL_MS) {
+    if (!lastSeenAt) {
+        return false;
+    }
+    return now - lastSeenAt <= ttlMs;
+}
+function cleanupExpiredPresence(state, now = Date.now(), ttlMs = exports.DEFAULT_PRESENCE_TTL_MS) {
+    let removed = 0;
+    const presence = {};
+    for (const [agentId, timestamp] of Object.entries(state.presence)) {
+        if (isAgentOnline(timestamp, now, ttlMs)) {
+            presence[agentId] = timestamp;
+        }
+        else {
+            removed += 1;
+        }
+    }
+    if (removed === 0) {
+        return { state, removed: 0 };
+    }
+    return {
+        state: {
+            profiles: { ...state.profiles },
+            presence,
+            index: { ...state.index },
+        },
+        removed,
+    };
+}
+function rebuildIndexForProfile(state, profile) {
+    const keys = (0, indexing_1.buildIndexKeys)(profile);
+    const nextIndex = {};
+    for (const [key, ids] of Object.entries(state.index)) {
+        const filtered = ids.filter((id) => id !== profile.agent_id);
+        if (filtered.length > 0) {
+            nextIndex[key] = Array.from(new Set(filtered));
+        }
+    }
+    for (const key of keys) {
+        const existing = new Set(nextIndex[key] ?? []);
+        existing.add(profile.agent_id);
+        nextIndex[key] = Array.from(existing);
+    }
+    return {
+        profiles: { ...state.profiles },
+        presence: { ...state.presence },
+        index: nextIndex,
+    };
+}
+function dedupeIndex(state) {
+    const index = {};
+    for (const [key, ids] of Object.entries(state.index)) {
+        index[key] = Array.from(new Set(ids));
+    }
+    return {
+        profiles: { ...state.profiles },
+        presence: { ...state.presence },
+        index,
+    };
+}
+function searchDirectory(state, keyword, options) {
+    const now = options?.now ?? Date.now();
+    const presenceTTLms = options?.presenceTTLms ?? exports.DEFAULT_PRESENCE_TTL_MS;
+    const normalized = keyword.trim().toLowerCase();
+    const baseList = normalized.length === 0
+        ? Object.values(state.profiles)
+        : Array.from(new Set([
+            ...(state.index[`tag:${normalized}`] ?? []),
+            ...(state.index[`name:${normalized.replace(/[^a-z0-9]+/g, "")}`] ?? []),
+        ]))
+            .map((agentId) => state.profiles[agentId])
+            .filter((profile) => Boolean(profile));
+    return baseList
+        .slice()
+        .sort((a, b) => {
+        const aOnline = isAgentOnline(state.presence[a.agent_id], now, presenceTTLms) ? 1 : 0;
+        const bOnline = isAgentOnline(state.presence[b.agent_id], now, presenceTTLms) ? 1 : 0;
+        if (aOnline !== bOnline) {
+            return bOnline - aOnline;
+        }
+        if (a.updated_at !== b.updated_at) {
+            return b.updated_at - a.updated_at;
+        }
+        const byName = a.display_name.localeCompare(b.display_name);
+        if (byName !== 0) {
+            return byName;
+        }
+        return a.agent_id.localeCompare(b.agent_id);
+    });
+}

package/packages/core/dist/identity.d.ts

@@ -0,0 +1,2 @@
+import { AgentIdentity } from "./types";
+export declare function createIdentity(now?: number): AgentIdentity;

package/packages/core/dist/identity.js

@@ -0,0 +1,18 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createIdentity = createIdentity;
+const tweetnacl_1 = __importDefault(require("tweetnacl"));
+const crypto_1 = require("./crypto");
+function createIdentity(now = Date.now()) {
+    const pair = tweetnacl_1.default.sign.keyPair();
+    const publicKey = (0, crypto_1.toBase64)(pair.publicKey);
+    return {
+        agent_id: (0, crypto_1.hashPublicKey)(pair.publicKey),
+        public_key: publicKey,
+        private_key: (0, crypto_1.toBase64)(pair.secretKey),
+        created_at: now,
+    };
+}

package/packages/core/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./types";
+export * from "./crypto";
+export * from "./identity";
+export * from "./profile";
+export * from "./presence";
+export * from "./indexing";
+export * from "./directory";
+export * from "./publicProfileSummary";
+export * from "./socialConfig";
+export * from "./socialResolver";
+export * from "./socialTemplate";

package/packages/core/dist/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./crypto"), exports);
+__exportStar(require("./identity"), exports);
+__exportStar(require("./profile"), exports);
+__exportStar(require("./presence"), exports);
+__exportStar(require("./indexing"), exports);
+__exportStar(require("./directory"), exports);
+__exportStar(require("./publicProfileSummary"), exports);
+__exportStar(require("./socialConfig"), exports);
+__exportStar(require("./socialResolver"), exports);
+__exportStar(require("./socialTemplate"), exports);

package/packages/core/dist/indexing.d.ts

@@ -0,0 +1,6 @@
+import { IndexRefRecord, PublicProfile } from "./types";
+export declare function normalizeTag(tag: string): string;
+export declare function buildTagIndexKeys(tags: string[]): string[];
+export declare function buildNamePrefixKeys(displayName: string): string[];
+export declare function buildIndexKeys(profile: PublicProfile): string[];
+export declare function buildIndexRecords(profile: PublicProfile): IndexRefRecord[];

package/packages/core/dist/indexing.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeTag = normalizeTag;
+exports.buildTagIndexKeys = buildTagIndexKeys;
+exports.buildNamePrefixKeys = buildNamePrefixKeys;
+exports.buildIndexKeys = buildIndexKeys;
+exports.buildIndexRecords = buildIndexRecords;
+function normalizeTag(tag) {
+    return tag.trim().toLowerCase();
+}
+function buildTagIndexKeys(tags) {
+    return tags
+        .map(normalizeTag)
+        .filter(Boolean)
+        .map((tag) => `tag:${tag}`);
+}
+function buildNamePrefixKeys(displayName) {
+    const normalized = displayName.trim().toLowerCase().replace(/\s+/g, " ");
+    const collapsed = normalized.replace(/[^a-z0-9]+/g, "");
+    const source = collapsed || normalized.replace(/\s+/g, "");
+    const keys = [];
+    for (let i = 1; i <= source.length; i += 1) {
+        keys.push(`name:${source.slice(0, i)}`);
+    }
+    return keys;
+}
+function buildIndexKeys(profile) {
+    const keys = new Set();
+    for (const key of buildTagIndexKeys(profile.tags)) {
+        keys.add(key);
+    }
+    for (const key of buildNamePrefixKeys(profile.display_name)) {
+        keys.add(key);
+    }
+    return Array.from(keys);
+}
+function buildIndexRecords(profile) {
+    return buildIndexKeys(profile).map((key) => ({
+        type: "index",
+        key,
+        agent_id: profile.agent_id,
+    }));
+}

package/packages/core/dist/presence.d.ts

@@ -0,0 +1,4 @@
+import { AgentIdentity } from "./types";
+import { PresenceRecord } from "./types";
+export declare function signPresence(identity: AgentIdentity, timestamp?: number): PresenceRecord;
+export declare function verifyPresence(record: PresenceRecord, publicKey: string): boolean;

package/packages/core/dist/presence.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signPresence = signPresence;
+exports.verifyPresence = verifyPresence;
+const crypto_1 = require("./crypto");
+function unsignedPresence(record) {
+    const { signature: _signature, ...rest } = record;
+    return rest;
+}
+function signPresence(identity, timestamp = Date.now()) {
+    const payload = {
+        type: "presence",
+        agent_id: identity.agent_id,
+        timestamp,
+    };
+    return {
+        ...payload,
+        signature: (0, crypto_1.signPayload)(payload, identity.private_key),
+    };
+}
+function verifyPresence(record, publicKey) {
+    return (0, crypto_1.verifyPayload)(unsignedPresence(record), record.signature, publicKey);
+}

package/packages/core/dist/profile.d.ts

@@ -0,0 +1,4 @@
+import { AgentIdentity, ProfileInput, PublicProfile } from "./types";
+export declare function signProfile(input: ProfileInput, identity: AgentIdentity): PublicProfile;
+export declare function verifyProfile(profile: PublicProfile, publicKey: string): boolean;
+export declare function createDefaultProfileInput(agentId: string): ProfileInput;

package/packages/core/dist/profile.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signProfile = signProfile;
+exports.verifyProfile = verifyProfile;
+exports.createDefaultProfileInput = createDefaultProfileInput;
+const crypto_1 = require("./crypto");
+function payloadWithoutSignature(profile) {
+    const { signature: _signature, ...payload } = profile;
+    return payload;
+}
+function signProfile(input, identity) {
+    const unsigned = {
+        agent_id: input.agent_id,
+        display_name: input.display_name,
+        bio: input.bio,
+        tags: input.tags,
+        avatar_url: input.avatar_url,
+        public_enabled: input.public_enabled,
+        updated_at: Date.now(),
+    };
+    const signature = (0, crypto_1.signPayload)(unsigned, identity.private_key);
+    return {
+        ...unsigned,
+        signature,
+    };
+}
+function verifyProfile(profile, publicKey) {
+    return (0, crypto_1.verifyPayload)(payloadWithoutSignature(profile), profile.signature, publicKey);
+}
+function createDefaultProfileInput(agentId) {
+    return {
+        agent_id: agentId,
+        display_name: "",
+        bio: "",
+        tags: [],
+        avatar_url: "",
+        public_enabled: false,
+    };
+}

package/packages/core/dist/publicProfileSummary.d.ts

@@ -0,0 +1,70 @@
+import { PublicProfile } from "./types";
+export type CapabilityKey = "browser" | "computer" | "research" | "openclaw";
+export type ProfileVisibility = {
+    show_tags: boolean;
+    show_last_seen: boolean;
+    show_capabilities_summary: boolean;
+};
+export type PublicProfileSummary = {
+    agent_id: string;
+    display_name: string;
+    bio: string;
+    avatar_url?: string;
+    public_enabled: boolean;
+    updated_at: number;
+    online: boolean;
+    last_seen_at: number | null;
+    tags: string[];
+    network_mode: string;
+    openclaw_bound: boolean;
+    capabilities_summary: string[];
+    profile_version: string;
+    public_key_fingerprint: string | null;
+    profile_updated_at: number;
+    presence_seen_at: number | null;
+    freshness_status: "live" | "recently_seen" | "stale";
+    verified_profile: boolean;
+    verified_presence_recent: boolean;
+    verification_status: "verified" | "stale" | "unverified";
+    signed_claims: {
+        display_name: string;
+        bio: string;
+        avatar_url?: string;
+        tags: string[];
+        public_enabled: boolean;
+        profile_version: string;
+        profile_updated_at: number;
+        public_key_fingerprint: string | null;
+        verified_profile: boolean;
+    };
+    observed_state: {
+        online: boolean;
+        freshness_status: "live" | "recently_seen" | "stale";
+        presence_seen_at: number | null;
+        verified_presence_recent: boolean;
+    };
+    integration_metadata: {
+        network_mode: string;
+        openclaw_bound: boolean;
+        verification_status: "verified" | "stale" | "unverified";
+    };
+    public_visibility: {
+        visible_fields: string[];
+        hidden_fields: string[];
+    };
+    visibility: ProfileVisibility;
+};
+export declare function deriveCapabilitiesSummary(tags: string[]): string[];
+export declare function buildPublicProfileSummary(args: {
+    profile: PublicProfile;
+    online: boolean;
+    last_seen_at: number | null;
+    network_mode?: string;
+    openclaw_bound?: boolean;
+    visibility?: Partial<ProfileVisibility>;
+    profile_version?: string;
+    public_key_fingerprint?: string | null;
+    verified_profile?: boolean;
+    now?: number;
+    presence_ttl_ms?: number;
+}): PublicProfileSummary;