@silicaclaw/cli 2026.3.19-9 → 2026.3.20-10

package/packages/storage/dist/packages/core/src/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/storage/dist/packages/core/src/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/storage/dist/packages/core/src/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/storage/dist/packages/core/src/privateCrypto.d.ts

@@ -0,0 +1,17 @@
+import { PrivateEncryptionKeyPair } from "./types";
+export declare function createPrivateEncryptionKeyPair(now?: number): PrivateEncryptionKeyPair;
+export declare function encryptPrivatePayload(input: {
+    plaintext: string;
+    recipient_public_key: string;
+    sender_keypair?: PrivateEncryptionKeyPair | null;
+}): {
+    ciphertext: string;
+    nonce: string;
+    sender_encryption_public_key: string;
+};
+export declare function decryptPrivatePayload(input: {
+    ciphertext: string;
+    nonce: string;
+    sender_encryption_public_key: string;
+    recipient_private_key: string;
+}): string | null;

package/packages/storage/dist/packages/core/src/privateCrypto.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPrivateEncryptionKeyPair = createPrivateEncryptionKeyPair;
+exports.encryptPrivatePayload = encryptPrivatePayload;
+exports.decryptPrivatePayload = decryptPrivatePayload;
+const tweetnacl_1 = __importDefault(require("tweetnacl"));
+const crypto_1 = require("./crypto");
+function createPrivateEncryptionKeyPair(now = Date.now()) {
+    const pair = tweetnacl_1.default.box.keyPair();
+    return {
+        public_key: (0, crypto_1.toBase64)(pair.publicKey),
+        private_key: (0, crypto_1.toBase64)(pair.secretKey),
+        created_at: now,
+    };
+}
+function encryptPrivatePayload(input) {
+    const sender = input.sender_keypair || createPrivateEncryptionKeyPair();
+    const nonce = tweetnacl_1.default.randomBytes(tweetnacl_1.default.box.nonceLength);
+    const message = Buffer.from(String(input.plaintext || ""), "utf8");
+    const ciphertext = tweetnacl_1.default.box(new Uint8Array(message), nonce, (0, crypto_1.fromBase64)(input.recipient_public_key), (0, crypto_1.fromBase64)(sender.private_key));
+    return {
+        ciphertext: (0, crypto_1.toBase64)(ciphertext),
+        nonce: (0, crypto_1.toBase64)(nonce),
+        sender_encryption_public_key: sender.public_key,
+    };
+}
+function decryptPrivatePayload(input) {
+    try {
+        const opened = tweetnacl_1.default.box.open((0, crypto_1.fromBase64)(input.ciphertext), (0, crypto_1.fromBase64)(input.nonce), (0, crypto_1.fromBase64)(input.sender_encryption_public_key), (0, crypto_1.fromBase64)(input.recipient_private_key));
+        if (!opened)
+            return null;
+        return Buffer.from(opened).toString("utf8");
+    }
+    catch {
+        return null;
+    }
+}

package/packages/storage/dist/packages/core/src/privateMessage.d.ts

@@ -0,0 +1,23 @@
+import { AgentIdentity, PrivateMessageReceiptRecord, PrivateMessageRecord } from "./types";
+export declare 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;
+export declare function verifyPrivateMessage(record: PrivateMessageRecord): boolean;
+export declare 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;
+export declare function verifyPrivateMessageReceipt(record: PrivateMessageReceiptRecord): boolean;

package/packages/storage/dist/packages/core/src/privateMessage.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signPrivateMessage = signPrivateMessage;
+exports.verifyPrivateMessage = verifyPrivateMessage;
+exports.signPrivateMessageReceipt = signPrivateMessageReceipt;
+exports.verifyPrivateMessageReceipt = verifyPrivateMessageReceipt;
+const crypto_1 = require("./crypto");
+function unsignedPrivateMessage(record) {
+    const { signature: _signature, ...rest } = record;
+    return rest;
+}
+function unsignedPrivateMessageReceipt(record) {
+    const { signature: _signature, ...rest } = record;
+    return rest;
+}
+function signPrivateMessage(input) {
+    const payload = {
+        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: (0, crypto_1.signPayload)(payload, input.identity.private_key),
+    };
+}
+function verifyPrivateMessage(record) {
+    try {
+        if ((0, crypto_1.hashPublicKey)((0, crypto_1.fromBase64)(record.sender_public_key)) !== record.from_agent_id) {
+            return false;
+        }
+        return (0, crypto_1.verifyPayload)(unsignedPrivateMessage(record), record.signature, record.sender_public_key);
+    }
+    catch {
+        return false;
+    }
+}
+function signPrivateMessageReceipt(input) {
+    const payload = {
+        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: (0, crypto_1.signPayload)(payload, input.identity.private_key),
+    };
+}
+function verifyPrivateMessageReceipt(record) {
+    try {
+        if ((0, crypto_1.hashPublicKey)((0, crypto_1.fromBase64)(record.sender_public_key)) !== record.from_agent_id) {
+            return false;
+        }
+        return (0, crypto_1.verifyPayload)(unsignedPrivateMessageReceipt(record), record.signature, record.sender_public_key);
+    }
+    catch {
+        return false;
+    }
+}

package/packages/storage/dist/packages/core/src/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/storage/dist/packages/core/src/profile.js

@@ -0,0 +1,41 @@
+"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,
+        private_encryption_public_key: input.private_encryption_public_key,
+        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: "",
+        private_encryption_public_key: "",
+        public_enabled: false,
+    };
+}

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

@@ -0,0 +1,74 @@
+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;
+    is_self: boolean;
+    display_name: string;
+    bio: string;
+    avatar_url?: string;
+    private_encryption_public_key?: 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;
+        private_encryption_public_key?: 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;
+    is_self?: boolean;
+    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;

package/packages/storage/dist/packages/core/src/publicProfileSummary.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveCapabilitiesSummary = deriveCapabilitiesSummary;
+exports.buildPublicProfileSummary = buildPublicProfileSummary;
+const DEFAULT_VISIBILITY = {
+    show_tags: true,
+    show_last_seen: true,
+    show_capabilities_summary: true,
+};
+const CAPABILITY_KEYS = ["browser", "computer", "research", "openclaw"];
+function deriveCapabilitiesSummary(tags) {
+    const normalized = new Set(tags.map((tag) => String(tag).trim().toLowerCase()).filter(Boolean));
+    return CAPABILITY_KEYS.filter((key) => normalized.has(key));
+}
+function buildPublicProfileSummary(args) {
+    const visibility = {
+        show_tags: typeof args.visibility?.show_tags === "boolean"
+            ? args.visibility.show_tags
+            : DEFAULT_VISIBILITY.show_tags,
+        show_last_seen: typeof args.visibility?.show_last_seen === "boolean"
+            ? args.visibility.show_last_seen
+            : DEFAULT_VISIBILITY.show_last_seen,
+        show_capabilities_summary: typeof args.visibility?.show_capabilities_summary === "boolean"
+            ? args.visibility.show_capabilities_summary
+            : DEFAULT_VISIBILITY.show_capabilities_summary,
+    };
+    const tags = visibility.show_tags ? args.profile.tags : [];
+    const capabilities = visibility.show_capabilities_summary ? deriveCapabilitiesSummary(args.profile.tags) : [];
+    const now = Number.isFinite(args.now) ? Number(args.now) : Date.now();
+    const ttl = Number.isFinite(args.presence_ttl_ms) ? Number(args.presence_ttl_ms) : 30_000;
+    const age = args.last_seen_at ? Math.max(0, now - args.last_seen_at) : Number.POSITIVE_INFINITY;
+    const freshness_status = age <= ttl ? "live" : age <= ttl * 3 ? "recently_seen" : "stale";
+    const verified_profile = Boolean(args.verified_profile);
+    const verified_presence_recent = freshness_status !== "stale" && Boolean(args.last_seen_at);
+    const verification_status = !verified_profile
+        ? "unverified"
+        : verified_presence_recent
+            ? "verified"
+            : "stale";
+    const visible_fields = [
+        "display_name",
+        "bio",
+        "public_enabled",
+        "profile_updated_at",
+        visibility.show_tags ? "tags" : "",
+        visibility.show_last_seen ? "presence_seen_at" : "",
+        visibility.show_capabilities_summary ? "capabilities_summary" : "",
+    ].filter((field) => Boolean(field));
+    const hidden_fields = [
+        visibility.show_tags ? "" : "tags",
+        visibility.show_last_seen ? "" : "presence_seen_at",
+        visibility.show_capabilities_summary ? "" : "capabilities_summary",
+    ].filter((field) => Boolean(field));
+    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,
+        last_seen_at: visibility.show_last_seen ? args.last_seen_at : null,
+        tags,
+        network_mode: args.network_mode ?? "unknown",
+        openclaw_bound: Boolean(args.openclaw_bound),
+        capabilities_summary: capabilities,
+        profile_version: args.profile_version ?? "v1",
+        public_key_fingerprint: args.public_key_fingerprint ?? null,
+        profile_updated_at: args.profile.updated_at,
+        presence_seen_at: visibility.show_last_seen ? args.last_seen_at : null,
+        freshness_status,
+        verified_profile,
+        verified_presence_recent,
+        verification_status,
+        signed_claims: {
+            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",
+            profile_updated_at: args.profile.updated_at,
+            public_key_fingerprint: args.public_key_fingerprint ?? null,
+            verified_profile,
+        },
+        observed_state: {
+            online: args.online,
+            freshness_status,
+            presence_seen_at: visibility.show_last_seen ? args.last_seen_at : null,
+            verified_presence_recent,
+        },
+        integration_metadata: {
+            network_mode: args.network_mode ?? "unknown",
+            openclaw_bound: Boolean(args.openclaw_bound),
+            verification_status,
+        },
+        public_visibility: {
+            visible_fields,
+            hidden_fields,
+        },
+        visibility,
+    };
+}

package/packages/storage/dist/packages/core/src/socialConfig.d.ts

@@ -0,0 +1,100 @@
+export type SocialIdentityConfig = {
+    display_name: string;
+    bio: string;
+    avatar_url: string;
+    tags: string[];
+};
+export type SocialNetworkAdapter = "mock" | "local-event-bus" | "real-preview" | "webrtc-preview" | "relay-preview";
+export type SocialNetworkMode = "local" | "lan" | "global-preview";
+export type SocialNetworkConfig = {
+    mode: SocialNetworkMode;
+    namespace: string;
+    adapter: SocialNetworkAdapter;
+    port: number;
+    signaling_url: string;
+    signaling_urls: string[];
+    room: string;
+    seed_peers: string[];
+    bootstrap_hints: string[];
+};
+export type SocialDiscoveryConfig = {
+    discoverable: boolean;
+    allow_profile_broadcast: boolean;
+    allow_presence_broadcast: boolean;
+    allow_message_broadcast: boolean;
+};
+export type SocialVisibilityConfig = {
+    show_display_name: boolean;
+    show_bio: boolean;
+    show_tags: boolean;
+    show_agent_id: boolean;
+    show_last_seen: boolean;
+    show_capabilities_summary: boolean;
+};
+export type SocialOpenClawConfig = {
+    bind_existing_identity: boolean;
+    use_openclaw_profile_if_available: boolean;
+};
+export type SocialConfig = {
+    enabled: boolean;
+    public_enabled: boolean;
+    identity: SocialIdentityConfig;
+    network: SocialNetworkConfig;
+    discovery: SocialDiscoveryConfig;
+    visibility: SocialVisibilityConfig;
+    openclaw: SocialOpenClawConfig;
+};
+export type SocialLoadMeta = {
+    found: boolean;
+    source_path: string | null;
+    parse_error: string | null;
+    loaded_at: number;
+};
+export type SocialRuntimeConfig = {
+    enabled: boolean;
+    public_enabled: boolean;
+    source_path: string | null;
+    last_loaded_at: number;
+    social_found: boolean;
+    parse_error: string | null;
+    resolved_identity: {
+        agent_id: string;
+        public_key: string;
+        created_at: number;
+        source: "silicaclaw-existing" | "openclaw-existing" | "silicaclaw-generated";
+    } | null;
+    resolved_profile: {
+        display_name: string;
+        bio: string;
+        avatar_url?: string;
+        tags: string[];
+        public_enabled: boolean;
+    } | null;
+    resolved_network: {
+        mode: SocialNetworkMode;
+        adapter: SocialNetworkAdapter;
+        namespace: string;
+        port: number | null;
+        signaling_url: string;
+        signaling_urls: string[];
+        room: string;
+        seed_peers: string[];
+        bootstrap_hints: string[];
+        bootstrap_sources: string[];
+    };
+    resolved_discovery: SocialDiscoveryConfig;
+    visibility: SocialVisibilityConfig;
+    openclaw: SocialOpenClawConfig;
+};
+export declare function parseFrontmatterObject(frontmatter: string): Record<string, unknown>;
+export declare function extractFrontmatter(content: string): string | null;
+export declare function normalizeSocialConfig(input: unknown): SocialConfig;
+export declare function getDefaultSocialConfig(): SocialConfig;
+export type DefaultSocialTemplateOptions = {
+    display_name?: string;
+    bio?: string;
+    tags?: string[];
+    mode?: SocialNetworkMode;
+    public_enabled?: boolean;
+};
+export declare function generateDefaultSocialMdTemplate(options?: DefaultSocialTemplateOptions): string;