@silicaclaw/cli 2026.3.19-9 → 2026.3.20-10

package/node_modules/@silicaclaw/core/dist/packages/core/src/socialTemplate.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSocialMdTemplate = generateSocialMdTemplate;
+function asBool(value, fallback) {
+    return typeof value === "boolean" ? value : fallback;
+}
+function asString(value, fallback) {
+    return typeof value === "string" ? value : fallback;
+}
+function asStringArray(value, fallback) {
+    if (!Array.isArray(value))
+        return fallback;
+    return value.map((item) => String(item).trim()).filter(Boolean);
+}
+function yamlString(input) {
+    return JSON.stringify(input ?? "");
+}
+function yamlStringList(values, indent = "  ") {
+    if (!values.length) {
+        return `${indent}[]`;
+    }
+    return values.map((value) => `${indent}- ${yamlString(value)}`).join("\n");
+}
+function generateSocialMdTemplate(runtimeConfig) {
+    const enabled = asBool(runtimeConfig?.enabled, true);
+    const publicEnabled = asBool(runtimeConfig?.public_enabled, false);
+    const profile = runtimeConfig?.resolved_profile ?? null;
+    const network = runtimeConfig?.resolved_network ?? null;
+    const discovery = runtimeConfig?.resolved_discovery ?? null;
+    const visibility = runtimeConfig?.visibility ?? null;
+    const openclaw = runtimeConfig?.openclaw ?? null;
+    const displayName = asString(profile?.display_name, "");
+    const bio = asString(profile?.bio, "");
+    const tags = asStringArray(profile?.tags, ["openclaw", "local-first"]);
+    const mode = network?.mode === "local" || network?.mode === "lan" || network?.mode === "global-preview"
+        ? network.mode
+        : "global-preview";
+    const discoverable = asBool(discovery?.discoverable, true);
+    const allowProfileBroadcast = asBool(discovery?.allow_profile_broadcast, true);
+    const allowPresenceBroadcast = asBool(discovery?.allow_presence_broadcast, true);
+    const allowMessageBroadcast = asBool(discovery?.allow_message_broadcast, true);
+    const showDisplayName = asBool(visibility?.show_display_name, true);
+    const showBio = asBool(visibility?.show_bio, true);
+    const showTags = asBool(visibility?.show_tags, true);
+    const showAgentId = asBool(visibility?.show_agent_id, true);
+    const showLastSeen = asBool(visibility?.show_last_seen, true);
+    const showCapabilitiesSummary = asBool(visibility?.show_capabilities_summary, true);
+    const bindExistingIdentity = asBool(openclaw?.bind_existing_identity, true);
+    const useOpenClawProfile = asBool(openclaw?.use_openclaw_profile_if_available, true);
+    return `---
+enabled: ${enabled}
+public_enabled: ${publicEnabled}
+
+identity:
+  display_name: ${yamlString(displayName)}
+  bio: ${yamlString(bio)}
+  tags:
+${yamlStringList(tags.map((tag) => asString(tag, "")), "    ")}
+
+network:
+  mode: ${yamlString(mode)}
+
+discovery:
+  discoverable: ${discoverable}
+  allow_profile_broadcast: ${allowProfileBroadcast}
+  allow_presence_broadcast: ${allowPresenceBroadcast}
+  allow_message_broadcast: ${allowMessageBroadcast}
+
+visibility:
+  show_display_name: ${showDisplayName}
+  show_bio: ${showBio}
+  show_tags: ${showTags}
+  show_agent_id: ${showAgentId}
+  show_last_seen: ${showLastSeen}
+  show_capabilities_summary: ${showCapabilitiesSummary}
+
+openclaw:
+  bind_existing_identity: ${bindExistingIdentity}
+  use_openclaw_profile_if_available: ${useOpenClawProfile}
+---
+
+# Social
+
+Generated from current SilicaClaw runtime state.
+
+- Save as \`social.md\` in your OpenClaw workspace.
+- This export does not auto-overwrite any existing file.
+- Advanced network fields are intentionally hidden in template and resolved in runtime.
+`;
+}

package/node_modules/@silicaclaw/core/dist/packages/core/src/types.d.ts

@@ -0,0 +1,99 @@
+export type AgentIdentity = {
+    agent_id: string;
+    public_key: string;
+    private_key: string;
+    created_at: number;
+};
+export type PrivateEncryptionKeyPair = {
+    public_key: string;
+    private_key: string;
+    created_at: number;
+};
+export type PublicProfile = {
+    agent_id: string;
+    display_name: string;
+    bio: string;
+    tags: string[];
+    avatar_url?: string;
+    private_encryption_public_key?: string;
+    public_enabled: boolean;
+    updated_at: number;
+    signature: string;
+};
+export type SignedProfileRecord = {
+    type: "profile";
+    profile: PublicProfile;
+};
+export type PresenceRecord = {
+    type: "presence";
+    agent_id: string;
+    timestamp: number;
+    signature: string;
+};
+export type IndexRefRecord = {
+    type: "index";
+    key: string;
+    agent_id: string;
+};
+export type SocialMessageRecord = {
+    type: "social.message";
+    message_id: string;
+    agent_id: string;
+    public_key: string;
+    display_name: string;
+    topic: string;
+    body: string;
+    created_at: number;
+    signature: string;
+};
+export type SocialMessageObservationRecord = {
+    type: "social.message.observation";
+    observation_id: string;
+    message_id: string;
+    observed_agent_id: string;
+    observer_agent_id: string;
+    observer_public_key: string;
+    observer_display_name: string;
+    observed_at: number;
+    signature: string;
+};
+export type PrivateMessageRecord = {
+    type: "private.message";
+    message_id: string;
+    conversation_id: string;
+    from_agent_id: string;
+    to_agent_id: string;
+    sender_public_key: string;
+    sender_encryption_public_key: string;
+    recipient_encryption_public_key: string;
+    cipher_scheme: "nacl-box-v1";
+    ciphertext: string;
+    nonce: string;
+    created_at: number;
+    signature: string;
+};
+export type PrivateMessageReceiptRecord = {
+    type: "private.message.receipt";
+    receipt_id: string;
+    message_id: string;
+    conversation_id: string;
+    from_agent_id: string;
+    to_agent_id: string;
+    sender_public_key: string;
+    status: "received" | "read";
+    created_at: number;
+    signature: string;
+};
+export type PrivateConversationSummary = {
+    conversation_id: string;
+    peer_agent_id: string;
+    last_message_at: number | null;
+    last_message_preview: string;
+    unread_count: number;
+};
+export type DirectoryState = {
+    profiles: Record<string, PublicProfile>;
+    presence: Record<string, number>;
+    index: Record<string, string[]>;
+};
+export type ProfileInput = Omit<PublicProfile, "signature" | "updated_at">;

package/node_modules/@silicaclaw/core/dist/packages/core/src/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/node_modules/@silicaclaw/core/src/index.ts

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

package/node_modules/@silicaclaw/core/src/privateCrypto.ts

@@ -0,0 +1,57 @@
+import nacl from "tweetnacl";
+import { fromBase64, toBase64 } from "./crypto";
+import { PrivateEncryptionKeyPair } from "./types";
+
+export function createPrivateEncryptionKeyPair(now = Date.now()): PrivateEncryptionKeyPair {
+  const pair = nacl.box.keyPair();
+  return {
+    public_key: toBase64(pair.publicKey),
+    private_key: toBase64(pair.secretKey),
+    created_at: now,
+  };
+}
+
+export function encryptPrivatePayload(input: {
+  plaintext: string;
+  recipient_public_key: string;
+  sender_keypair?: PrivateEncryptionKeyPair | null;
+}): {
+  ciphertext: string;
+  nonce: string;
+  sender_encryption_public_key: string;
+} {
+  const sender = input.sender_keypair || createPrivateEncryptionKeyPair();
+  const nonce = nacl.randomBytes(nacl.box.nonceLength);
+  const message = Buffer.from(String(input.plaintext || ""), "utf8");
+  const ciphertext = nacl.box(
+    new Uint8Array(message),
+    nonce,
+    fromBase64(input.recipient_public_key),
+    fromBase64(sender.private_key),
+  );
+  return {
+    ciphertext: toBase64(ciphertext),
+    nonce: toBase64(nonce),
+    sender_encryption_public_key: sender.public_key,
+  };
+}
+
+export function decryptPrivatePayload(input: {
+  ciphertext: string;
+  nonce: string;
+  sender_encryption_public_key: string;
+  recipient_private_key: string;
+}): string | null {
+  try {
+    const opened = nacl.box.open(
+      fromBase64(input.ciphertext),
+      fromBase64(input.nonce),
+      fromBase64(input.sender_encryption_public_key),
+      fromBase64(input.recipient_private_key),
+    );
+    if (!opened) return null;
+    return Buffer.from(opened).toString("utf8");
+  } catch {
+    return null;
+  }
+}

package/node_modules/@silicaclaw/core/src/privateMessage.ts

@@ -0,0 +1,101 @@
+import {
+  AgentIdentity,
+  PrivateMessageReceiptRecord,
+  PrivateMessageRecord,
+} from "./types";
+import { fromBase64, hashPublicKey, signPayload, verifyPayload } from "./crypto";
+
+function unsignedPrivateMessage(
+  record: PrivateMessageRecord
+): Omit<PrivateMessageRecord, "signature"> {
+  const { signature: _signature, ...rest } = record;
+  return rest;
+}
+
+function unsignedPrivateMessageReceipt(
+  record: PrivateMessageReceiptRecord
+): Omit<PrivateMessageReceiptRecord, "signature"> {
+  const { signature: _signature, ...rest } = record;
+  return rest;
+}
+
+export function signPrivateMessage(input: {
+  identity: AgentIdentity;
+  message_id: string;
+  conversation_id: string;
+  to_agent_id: string;
+  sender_encryption_public_key: string;
+  recipient_encryption_public_key: string;
+  ciphertext: string;
+  nonce: string;
+  created_at?: number;
+}): PrivateMessageRecord {
+  const payload: Omit<PrivateMessageRecord, "signature"> = {
+    type: "private.message",
+    message_id: input.message_id,
+    conversation_id: input.conversation_id,
+    from_agent_id: input.identity.agent_id,
+    to_agent_id: input.to_agent_id,
+    sender_public_key: input.identity.public_key,
+    sender_encryption_public_key: input.sender_encryption_public_key,
+    recipient_encryption_public_key: input.recipient_encryption_public_key,
+    cipher_scheme: "nacl-box-v1",
+    ciphertext: input.ciphertext,
+    nonce: input.nonce,
+    created_at: input.created_at ?? Date.now(),
+  };
+
+  return {
+    ...payload,
+    signature: signPayload(payload, input.identity.private_key),
+  };
+}
+
+export function verifyPrivateMessage(record: PrivateMessageRecord): boolean {
+  try {
+    if (hashPublicKey(fromBase64(record.sender_public_key)) !== record.from_agent_id) {
+      return false;
+    }
+    return verifyPayload(unsignedPrivateMessage(record), record.signature, record.sender_public_key);
+  } catch {
+    return false;
+  }
+}
+
+export function signPrivateMessageReceipt(input: {
+  identity: AgentIdentity;
+  receipt_id: string;
+  message_id: string;
+  conversation_id: string;
+  to_agent_id: string;
+  status: "received" | "read";
+  created_at?: number;
+}): PrivateMessageReceiptRecord {
+  const payload: Omit<PrivateMessageReceiptRecord, "signature"> = {
+    type: "private.message.receipt",
+    receipt_id: input.receipt_id,
+    message_id: input.message_id,
+    conversation_id: input.conversation_id,
+    from_agent_id: input.identity.agent_id,
+    to_agent_id: input.to_agent_id,
+    sender_public_key: input.identity.public_key,
+    status: input.status,
+    created_at: input.created_at ?? Date.now(),
+  };
+
+  return {
+    ...payload,
+    signature: signPayload(payload, input.identity.private_key),
+  };
+}
+
+export function verifyPrivateMessageReceipt(record: PrivateMessageReceiptRecord): boolean {
+  try {
+    if (hashPublicKey(fromBase64(record.sender_public_key)) !== record.from_agent_id) {
+      return false;
+    }
+    return verifyPayload(unsignedPrivateMessageReceipt(record), record.signature, record.sender_public_key);
+  } catch {
+    return false;
+  }
+}

package/node_modules/@silicaclaw/core/src/profile.ts

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

package/node_modules/@silicaclaw/core/src/publicProfileSummary.ts

@@ -10,9 +10,11 @@ export type ProfileVisibility = {
 
 export type PublicProfileSummary = {
   agent_id: string;
+  is_self: boolean;
   display_name: string;
   bio: string;
   avatar_url?: string;
+  private_encryption_public_key?: string;
   public_enabled: boolean;
   updated_at: number;
   online: boolean;
@@ -33,6 +35,7 @@ export type PublicProfileSummary = {
     display_name: string;
     bio: string;
     avatar_url?: string;
+    private_encryption_public_key?: string;
     tags: string[];
     public_enabled: boolean;
     profile_version: string;
@@ -73,6 +76,7 @@ export function deriveCapabilitiesSummary(tags: string[]): string[] {
 
 export function buildPublicProfileSummary(args: {
   profile: PublicProfile;
+  is_self?: boolean;
   online: boolean;
   last_seen_at: number | null;
   network_mode?: string;
@@ -130,9 +134,11 @@ export function buildPublicProfileSummary(args: {
 
   return {
     agent_id: args.profile.agent_id,
+    is_self: Boolean(args.is_self),
     display_name: args.profile.display_name,
     bio: args.profile.bio,
     avatar_url: args.profile.avatar_url,
+    private_encryption_public_key: args.profile.private_encryption_public_key,
     public_enabled: args.profile.public_enabled,
     updated_at: args.profile.updated_at,
     online: args.online,
@@ -153,6 +159,7 @@ export function buildPublicProfileSummary(args: {
       display_name: args.profile.display_name,
       bio: args.profile.bio,
       avatar_url: args.profile.avatar_url,
+      private_encryption_public_key: args.profile.private_encryption_public_key,
       tags,
       public_enabled: args.profile.public_enabled,
       profile_version: args.profile_version ?? "v1",

package/node_modules/@silicaclaw/core/src/socialConfig.ts

@@ -1,3 +1,5 @@
+import defaults from "../../../config/silicaclaw-defaults.json";
+
 export type SocialIdentityConfig = {
   display_name: string;
   bio: string;
@@ -105,13 +107,13 @@ const DEFAULT_SOCIAL_CONFIG: SocialConfig = {
     tags: [],
   },
   network: {
-    mode: "global-preview",
-    namespace: "silicaclaw.preview",
+    mode: defaults.network.default_mode as SocialNetworkMode,
+    namespace: defaults.network.default_namespace,
     adapter: "relay-preview",
-    port: 44123,
-    signaling_url: "https://relay.silicaclaw.com",
+    port: defaults.ports.network_default,
+    signaling_url: defaults.network.global_preview.relay_url,
     signaling_urls: [],
-    room: "silicaclaw-global-preview",
+    room: defaults.network.global_preview.room,
     seed_peers: [],
     bootstrap_hints: [],
   },

package/node_modules/@silicaclaw/core/src/types.ts

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

package/node_modules/@silicaclaw/network/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/node_modules/@silicaclaw/network/dist/packages/network/src/abstractions/messageEnvelope.d.ts

@@ -0,0 +1,28 @@
+export type NetworkMessageEnvelope<TPayload = unknown> = {
+    version: 1;
+    message_id: string;
+    topic: string;
+    source_peer_id: string;
+    timestamp: number;
+    payload: TPayload;
+};
+export type DecodedNetworkMessage = {
+    envelope: NetworkMessageEnvelope;
+    raw: Buffer;
+};
+export interface MessageEnvelopeCodec {
+    encode(envelope: NetworkMessageEnvelope): Buffer;
+    decode(raw: Buffer): DecodedNetworkMessage | null;
+}
+export type EnvelopeValidationOptions = {
+    now?: number;
+    max_future_drift_ms: number;
+    max_past_drift_ms: number;
+};
+export type EnvelopeValidationResult = {
+    ok: boolean;
+    reason?: "not_object" | "invalid_version" | "invalid_message_id" | "invalid_topic" | "invalid_source_peer_id" | "invalid_timestamp" | "missing_payload" | "timestamp_future_drift" | "timestamp_past_drift";
+    envelope?: NetworkMessageEnvelope;
+    drift_ms?: number;
+};
+export declare function validateNetworkMessageEnvelope(value: unknown, options: EnvelopeValidationOptions): EnvelopeValidationResult;

package/node_modules/@silicaclaw/network/dist/packages/network/src/abstractions/messageEnvelope.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateNetworkMessageEnvelope = validateNetworkMessageEnvelope;
+function validateNetworkMessageEnvelope(value, options) {
+    if (typeof value !== "object" || value === null) {
+        return { ok: false, reason: "not_object" };
+    }
+    const envelope = value;
+    if (envelope.version !== 1) {
+        return { ok: false, reason: "invalid_version" };
+    }
+    if (typeof envelope.message_id !== "string" || envelope.message_id.trim().length === 0) {
+        return { ok: false, reason: "invalid_message_id" };
+    }
+    if (typeof envelope.topic !== "string" || envelope.topic.trim().length === 0) {
+        return { ok: false, reason: "invalid_topic" };
+    }
+    if (typeof envelope.source_peer_id !== "string" || envelope.source_peer_id.trim().length === 0) {
+        return { ok: false, reason: "invalid_source_peer_id" };
+    }
+    if (!Number.isFinite(envelope.timestamp)) {
+        return { ok: false, reason: "invalid_timestamp" };
+    }
+    if (!("payload" in envelope)) {
+        return { ok: false, reason: "missing_payload" };
+    }
+    const now = options.now ?? Date.now();
+    const drift = Number(envelope.timestamp) - now;
+    if (drift > options.max_future_drift_ms) {
+        return { ok: false, reason: "timestamp_future_drift", drift_ms: drift };
+    }
+    if (drift < -options.max_past_drift_ms) {
+        return { ok: false, reason: "timestamp_past_drift", drift_ms: drift };
+    }
+    return { ok: true, envelope: envelope, drift_ms: drift };
+}

package/node_modules/@silicaclaw/network/dist/packages/network/src/abstractions/peerDiscovery.d.ts

@@ -0,0 +1,43 @@
+import { NetworkMessageEnvelope } from "./messageEnvelope";
+export type PeerStatus = "online" | "stale";
+export type PeerSnapshot = {
+    peer_id: string;
+    first_seen_at: number;
+    last_seen_at: number;
+    status: PeerStatus;
+    stale_since_at?: number;
+    messages_seen: number;
+    meta?: Record<string, unknown>;
+};
+export type PeerDiscoveryContext = {
+    self_peer_id: string;
+    publishControl: (topic: string, payload: unknown) => Promise<void>;
+};
+export type PeerDiscoveryStats = {
+    observe_calls: number;
+    peers_added: number;
+    peers_removed: number;
+    peers_marked_stale: number;
+    heartbeat_sent: number;
+    heartbeat_send_errors: number;
+    reconcile_runs: number;
+    last_observed_at: number;
+    last_heartbeat_at: number;
+    last_reconcile_at: number;
+    last_error_at: number;
+};
+export type PeerDiscoveryConfigSnapshot = {
+    discovery: string;
+    heartbeat_topic?: string;
+    heartbeat_interval_ms?: number;
+    stale_after_ms?: number;
+    remove_after_ms?: number;
+};
+export interface PeerDiscovery {
+    start(context: PeerDiscoveryContext): Promise<void>;
+    stop(): Promise<void>;
+    observeEnvelope(envelope: NetworkMessageEnvelope): void;
+    listPeers(): PeerSnapshot[];
+    getStats?(): PeerDiscoveryStats;
+    getConfig?(): PeerDiscoveryConfigSnapshot;
+}

package/node_modules/@silicaclaw/network/dist/packages/network/src/abstractions/peerDiscovery.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/node_modules/@silicaclaw/network/dist/packages/network/src/abstractions/topicCodec.d.ts

@@ -0,0 +1,4 @@
+export interface TopicCodec {
+    encode(topic: string, payload: unknown): unknown;
+    decode(topic: string, payload: unknown): unknown;
+}

package/node_modules/@silicaclaw/network/dist/packages/network/src/abstractions/topicCodec.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });