@silicaclaw/cli 1.0.0-beta.2 → 1.0.0-beta.21

package/packages/core/dist/socialConfig.js

@@ -0,0 +1,288 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFrontmatterObject = parseFrontmatterObject;
+exports.extractFrontmatter = extractFrontmatter;
+exports.normalizeSocialConfig = normalizeSocialConfig;
+exports.getDefaultSocialConfig = getDefaultSocialConfig;
+exports.generateDefaultSocialMdTemplate = generateDefaultSocialMdTemplate;
+const DEFAULT_SOCIAL_CONFIG = {
+    enabled: true,
+    public_enabled: false,
+    identity: {
+        display_name: "",
+        bio: "",
+        avatar_url: "",
+        tags: [],
+    },
+    network: {
+        mode: "global-preview",
+        namespace: "silicaclaw.preview",
+        adapter: "relay-preview",
+        port: 44123,
+        signaling_url: "http://localhost:4510",
+        signaling_urls: [],
+        room: "silicaclaw-global-preview",
+        seed_peers: [],
+        bootstrap_hints: [],
+    },
+    discovery: {
+        discoverable: true,
+        allow_profile_broadcast: true,
+        allow_presence_broadcast: true,
+    },
+    visibility: {
+        show_display_name: true,
+        show_bio: true,
+        show_tags: true,
+        show_agent_id: true,
+        show_last_seen: true,
+        show_capabilities_summary: true,
+    },
+    openclaw: {
+        bind_existing_identity: true,
+        use_openclaw_profile_if_available: true,
+    },
+};
+function parseScalar(value) {
+    const trimmed = value.trim();
+    if (trimmed === "[]")
+        return [];
+    if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
+        const inner = trimmed.slice(1, -1).trim();
+        if (!inner)
+            return [];
+        return inner
+            .split(",")
+            .map((item) => item.trim())
+            .map((item) => (item.startsWith('"') && item.endsWith('"')) || (item.startsWith("'") && item.endsWith("'"))
+            ? item.slice(1, -1)
+            : item)
+            .filter(Boolean);
+    }
+    if (trimmed === "true")
+        return true;
+    if (trimmed === "false")
+        return false;
+    if (trimmed === "null")
+        return null;
+    if (/^-?\d+(\.\d+)?$/.test(trimmed))
+        return Number(trimmed);
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+        (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+function countIndent(line) {
+    let count = 0;
+    while (count < line.length && line[count] === " ")
+        count += 1;
+    return count;
+}
+function findNextSignificantLine(lines, start) {
+    for (let i = start; i < lines.length; i += 1) {
+        const raw = lines[i];
+        const trimmed = raw.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        return { line: trimmed, indent: countIndent(raw) };
+    }
+    return null;
+}
+function parseFrontmatterObject(frontmatter) {
+    const root = {};
+    const lines = frontmatter.replace(/\r\n/g, "\n").split("\n");
+    const stack = [{ indent: -1, value: root, kind: "object" }];
+    for (let i = 0; i < lines.length; i += 1) {
+        const raw = lines[i];
+        const trimmed = raw.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const indent = countIndent(raw);
+        while (stack.length > 1 && indent <= stack[stack.length - 1].indent) {
+            stack.pop();
+        }
+        const current = stack[stack.length - 1];
+        if (trimmed.startsWith("- ")) {
+            if (current.kind !== "array") {
+                continue;
+            }
+            const itemRaw = trimmed.slice(2).trim();
+            if (!itemRaw) {
+                const child = {};
+                current.value.push(child);
+                stack.push({ indent, value: child, kind: "object" });
+                continue;
+            }
+            const keyValue = itemRaw.match(/^([A-Za-z0-9_]+):\s*(.*)$/);
+            if (keyValue) {
+                const child = {};
+                const key = keyValue[1];
+                const valueRaw = keyValue[2];
+                child[key] = valueRaw ? parseScalar(valueRaw) : "";
+                current.value.push(child);
+                continue;
+            }
+            current.value.push(parseScalar(itemRaw));
+            continue;
+        }
+        const match = trimmed.match(/^([A-Za-z0-9_]+):\s*(.*)$/);
+        if (!match || current.kind !== "object") {
+            continue;
+        }
+        const key = match[1];
+        const valueRaw = match[2];
+        const obj = current.value;
+        if (valueRaw) {
+            obj[key] = parseScalar(valueRaw);
+            continue;
+        }
+        const next = findNextSignificantLine(lines, i + 1);
+        const nextIsArray = Boolean(next && next.indent > indent && next.line.startsWith("- "));
+        if (nextIsArray) {
+            const arr = [];
+            obj[key] = arr;
+            stack.push({ indent, value: arr, kind: "array" });
+            continue;
+        }
+        const childObj = {};
+        obj[key] = childObj;
+        stack.push({ indent, value: childObj, kind: "object" });
+    }
+    return root;
+}
+function extractFrontmatter(content) {
+    const normalized = content.replace(/\r\n/g, "\n");
+    if (!normalized.startsWith("---\n")) {
+        return null;
+    }
+    const end = normalized.indexOf("\n---", 4);
+    if (end < 0) {
+        return null;
+    }
+    return normalized.slice(4, end).trim();
+}
+function asObject(value) {
+    if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+        return value;
+    }
+    return {};
+}
+function asBool(value, fallback) {
+    return typeof value === "boolean" ? value : fallback;
+}
+function asString(value, fallback) {
+    return typeof value === "string" ? value : fallback;
+}
+function asNumber(value, fallback) {
+    return Number.isFinite(value) ? Number(value) : fallback;
+}
+function asStringArray(value, fallback) {
+    if (!Array.isArray(value))
+        return fallback;
+    return value.map((item) => String(item).trim()).filter(Boolean);
+}
+function asAdapter(value, fallback) {
+    if (value === "mock" ||
+        value === "local-event-bus" ||
+        value === "real-preview" ||
+        value === "webrtc-preview" ||
+        value === "relay-preview") {
+        return value;
+    }
+    return fallback;
+}
+function asMode(value, fallback) {
+    if (value === "local" || value === "lan" || value === "global-preview") {
+        return value;
+    }
+    return fallback;
+}
+function adapterForMode(mode) {
+    if (mode === "local")
+        return "local-event-bus";
+    if (mode === "lan")
+        return "real-preview";
+    return "relay-preview";
+}
+function normalizeSocialConfig(input) {
+    const root = asObject(input);
+    const identity = asObject(root.identity);
+    const network = asObject(root.network);
+    const discovery = asObject(root.discovery);
+    const visibility = asObject(root.visibility);
+    const openclaw = asObject(root.openclaw);
+    const signalingUrl = asString(network.signaling_url, DEFAULT_SOCIAL_CONFIG.network.signaling_url);
+    const signalingUrls = asStringArray(network.signaling_urls, DEFAULT_SOCIAL_CONFIG.network.signaling_urls);
+    const mode = asMode(network.mode, DEFAULT_SOCIAL_CONFIG.network.mode);
+    return {
+        enabled: asBool(root.enabled, DEFAULT_SOCIAL_CONFIG.enabled),
+        public_enabled: asBool(root.public_enabled, DEFAULT_SOCIAL_CONFIG.public_enabled),
+        identity: {
+            display_name: asString(identity.display_name, DEFAULT_SOCIAL_CONFIG.identity.display_name),
+            bio: asString(identity.bio, DEFAULT_SOCIAL_CONFIG.identity.bio),
+            avatar_url: asString(identity.avatar_url, DEFAULT_SOCIAL_CONFIG.identity.avatar_url),
+            tags: asStringArray(identity.tags, DEFAULT_SOCIAL_CONFIG.identity.tags),
+        },
+        network: {
+            mode,
+            namespace: asString(network.namespace, DEFAULT_SOCIAL_CONFIG.network.namespace),
+            adapter: asAdapter(network.adapter, adapterForMode(mode)),
+            port: asNumber(network.port, DEFAULT_SOCIAL_CONFIG.network.port),
+            signaling_url: signalingUrl,
+            signaling_urls: signalingUrls.length > 0 ? signalingUrls : signalingUrl ? [signalingUrl] : [],
+            room: asString(network.room, DEFAULT_SOCIAL_CONFIG.network.room),
+            seed_peers: asStringArray(network.seed_peers, DEFAULT_SOCIAL_CONFIG.network.seed_peers),
+            bootstrap_hints: asStringArray(network.bootstrap_hints, DEFAULT_SOCIAL_CONFIG.network.bootstrap_hints),
+        },
+        discovery: {
+            discoverable: asBool(discovery.discoverable, DEFAULT_SOCIAL_CONFIG.discovery.discoverable),
+            allow_profile_broadcast: asBool(discovery.allow_profile_broadcast, DEFAULT_SOCIAL_CONFIG.discovery.allow_profile_broadcast),
+            allow_presence_broadcast: asBool(discovery.allow_presence_broadcast, DEFAULT_SOCIAL_CONFIG.discovery.allow_presence_broadcast),
+        },
+        visibility: {
+            show_display_name: asBool(visibility.show_display_name, DEFAULT_SOCIAL_CONFIG.visibility.show_display_name),
+            show_bio: asBool(visibility.show_bio, DEFAULT_SOCIAL_CONFIG.visibility.show_bio),
+            show_tags: asBool(visibility.show_tags, DEFAULT_SOCIAL_CONFIG.visibility.show_tags),
+            show_agent_id: asBool(visibility.show_agent_id, DEFAULT_SOCIAL_CONFIG.visibility.show_agent_id),
+            show_last_seen: asBool(visibility.show_last_seen, DEFAULT_SOCIAL_CONFIG.visibility.show_last_seen),
+            show_capabilities_summary: asBool(visibility.show_capabilities_summary, DEFAULT_SOCIAL_CONFIG.visibility.show_capabilities_summary),
+        },
+        openclaw: {
+            bind_existing_identity: asBool(openclaw.bind_existing_identity, DEFAULT_SOCIAL_CONFIG.openclaw.bind_existing_identity),
+            use_openclaw_profile_if_available: asBool(openclaw.use_openclaw_profile_if_available, DEFAULT_SOCIAL_CONFIG.openclaw.use_openclaw_profile_if_available),
+        },
+    };
+}
+function getDefaultSocialConfig() {
+    return JSON.parse(JSON.stringify(DEFAULT_SOCIAL_CONFIG));
+}
+function generateDefaultSocialMdTemplate(options = {}) {
+    const displayName = options.display_name?.trim() || "My OpenClaw Agent";
+    const bio = options.bio?.trim() || "Local AI agent running on this machine";
+    const tags = Array.isArray(options.tags) && options.tags.length > 0 ? options.tags : ["openclaw", "local-first"];
+    const mode = options.mode ?? "lan";
+    const publicEnabled = typeof options.public_enabled === "boolean" ? options.public_enabled : false;
+    return `---
+enabled: true
+public_enabled: ${publicEnabled}
+
+identity:
+  display_name: ${JSON.stringify(displayName)}
+  bio: ${JSON.stringify(bio)}
+  tags:
+${tags.map((tag) => `    - ${tag}`).join("\n")}
+
+network:
+  mode: ${JSON.stringify(mode)}
+
+openclaw:
+  bind_existing_identity: true
+  use_openclaw_profile_if_available: true
+---
+
+# social.md
+
+This file configures how OpenClaw integrates with SilicaClaw.
+`;
+}

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

@@ -0,0 +1,46 @@
+import { AgentIdentity, ProfileInput, PublicProfile } from "./types";
+import { DefaultSocialTemplateOptions, SocialConfig, SocialLoadMeta } from "./socialConfig";
+export type SocialFileLookup = {
+    found: boolean;
+    source_path: string | null;
+    content: string | null;
+};
+export type OpenClawIdentityLookup = {
+    identity: AgentIdentity | null;
+    source_path: string | null;
+};
+export type OpenClawProfileLookup = {
+    profile: Partial<PublicProfile> | null;
+    source_path: string | null;
+};
+export type LoadedSocialConfig = {
+    config: SocialConfig;
+    meta: SocialLoadMeta;
+    raw_frontmatter: Record<string, unknown> | null;
+};
+export type ResolvedIdentityResult = {
+    identity: AgentIdentity;
+    source: "silicaclaw-existing" | "openclaw-existing" | "silicaclaw-generated";
+    openclaw_source_path: string | null;
+};
+export declare function getSocialConfigSearchPaths(rootDir?: string, homeDir?: string): string[];
+export declare function findSocialMd(rootDir?: string): SocialFileLookup;
+export declare function loadSocialConfig(rootDir?: string): LoadedSocialConfig;
+export declare function findOpenClawIdentity(rootDir?: string, homeDir?: string): OpenClawIdentityLookup;
+export declare function findOpenClawProfile(rootDir?: string, homeDir?: string): OpenClawProfileLookup;
+export declare function resolveIdentityWithSocial(args: {
+    socialConfig: SocialConfig;
+    existingIdentity: AgentIdentity | null;
+    generatedIdentity: AgentIdentity;
+    rootDir?: string;
+}): ResolvedIdentityResult;
+export declare function resolveProfileInputWithSocial(args: {
+    socialConfig: SocialConfig;
+    agentId: string;
+    existingProfile: PublicProfile | null;
+    rootDir?: string;
+}): ProfileInput;
+export declare function ensureDefaultSocialMd(rootDir?: string, options?: DefaultSocialTemplateOptions): {
+    path: string;
+    created: boolean;
+};

package/packages/core/dist/socialResolver.js

@@ -0,0 +1,237 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSocialConfigSearchPaths = getSocialConfigSearchPaths;
+exports.findSocialMd = findSocialMd;
+exports.loadSocialConfig = loadSocialConfig;
+exports.findOpenClawIdentity = findOpenClawIdentity;
+exports.findOpenClawProfile = findOpenClawProfile;
+exports.resolveIdentityWithSocial = resolveIdentityWithSocial;
+exports.resolveProfileInputWithSocial = resolveProfileInputWithSocial;
+exports.ensureDefaultSocialMd = ensureDefaultSocialMd;
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const crypto_1 = require("./crypto");
+const socialConfig_1 = require("./socialConfig");
+function getSocialConfigSearchPaths(rootDir = process.cwd(), homeDir = (0, os_1.homedir)()) {
+    return [
+        (0, path_1.resolve)(rootDir, "social.md"),
+        (0, path_1.resolve)(rootDir, ".openclaw", "social.md"),
+        (0, path_1.resolve)(homeDir, ".openclaw", "social.md"),
+    ];
+}
+function findSocialMd(rootDir = process.cwd()) {
+    const candidates = getSocialConfigSearchPaths(rootDir);
+    for (const path of candidates) {
+        if (!(0, fs_1.existsSync)(path))
+            continue;
+        return {
+            found: true,
+            source_path: path,
+            content: (0, fs_1.readFileSync)(path, "utf8"),
+        };
+    }
+    return {
+        found: false,
+        source_path: null,
+        content: null,
+    };
+}
+function loadSocialConfig(rootDir = process.cwd()) {
+    const lookup = findSocialMd(rootDir);
+    if (!lookup.found || !lookup.content || !lookup.source_path) {
+        return {
+            config: (0, socialConfig_1.normalizeSocialConfig)({}),
+            meta: {
+                found: false,
+                source_path: null,
+                parse_error: null,
+                loaded_at: Date.now(),
+            },
+            raw_frontmatter: null,
+        };
+    }
+    try {
+        const frontmatter = (0, socialConfig_1.extractFrontmatter)(lookup.content);
+        if (!frontmatter) {
+            return {
+                config: (0, socialConfig_1.normalizeSocialConfig)({}),
+                meta: {
+                    found: true,
+                    source_path: lookup.source_path,
+                    parse_error: "frontmatter_not_found",
+                    loaded_at: Date.now(),
+                },
+                raw_frontmatter: null,
+            };
+        }
+        const parsed = (0, socialConfig_1.parseFrontmatterObject)(frontmatter);
+        return {
+            config: (0, socialConfig_1.normalizeSocialConfig)(parsed),
+            meta: {
+                found: true,
+                source_path: lookup.source_path,
+                parse_error: null,
+                loaded_at: Date.now(),
+            },
+            raw_frontmatter: parsed,
+        };
+    }
+    catch (error) {
+        return {
+            config: (0, socialConfig_1.normalizeSocialConfig)({}),
+            meta: {
+                found: true,
+                source_path: lookup.source_path,
+                parse_error: error instanceof Error ? error.message : "social_parse_failed",
+                loaded_at: Date.now(),
+            },
+            raw_frontmatter: null,
+        };
+    }
+}
+function readJson(path) {
+    if (!(0, fs_1.existsSync)(path))
+        return null;
+    try {
+        return JSON.parse((0, fs_1.readFileSync)(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeIdentity(input) {
+    if (typeof input !== "object" || input === null) {
+        return null;
+    }
+    const value = input;
+    if (typeof value.public_key !== "string" || typeof value.private_key !== "string") {
+        return null;
+    }
+    let agentId = typeof value.agent_id === "string" ? value.agent_id : "";
+    if (!agentId) {
+        try {
+            agentId = (0, crypto_1.hashPublicKey)((0, crypto_1.fromBase64)(value.public_key));
+        }
+        catch {
+            return null;
+        }
+    }
+    return {
+        agent_id: agentId,
+        public_key: value.public_key,
+        private_key: value.private_key,
+        created_at: Number.isFinite(value.created_at) ? Number(value.created_at) : Date.now(),
+    };
+}
+function findOpenClawIdentity(rootDir = process.cwd(), homeDir = (0, os_1.homedir)()) {
+    const candidates = [
+        (0, path_1.resolve)(rootDir, ".openclaw", "identity.json"),
+        (0, path_1.resolve)(rootDir, "identity.json"),
+        (0, path_1.resolve)(homeDir, ".openclaw", "identity.json"),
+    ];
+    for (const path of candidates) {
+        const parsed = readJson(path);
+        const identity = normalizeIdentity(parsed);
+        if (identity) {
+            return {
+                identity,
+                source_path: path,
+            };
+        }
+    }
+    return {
+        identity: null,
+        source_path: null,
+    };
+}
+function findOpenClawProfile(rootDir = process.cwd(), homeDir = (0, os_1.homedir)()) {
+    const candidates = [
+        (0, path_1.resolve)(rootDir, ".openclaw", "profile.json"),
+        (0, path_1.resolve)(rootDir, "profile.json"),
+        (0, path_1.resolve)(homeDir, ".openclaw", "profile.json"),
+    ];
+    for (const path of candidates) {
+        const parsed = readJson(path);
+        if (typeof parsed !== "object" || parsed === null)
+            continue;
+        const profile = parsed;
+        return {
+            source_path: path,
+            profile: {
+                display_name: typeof profile.display_name === "string" ? profile.display_name : "",
+                bio: typeof profile.bio === "string" ? profile.bio : "",
+                avatar_url: typeof profile.avatar_url === "string" ? profile.avatar_url : "",
+                tags: Array.isArray(profile.tags)
+                    ? profile.tags.map((tag) => String(tag).trim()).filter(Boolean)
+                    : [],
+            },
+        };
+    }
+    return {
+        profile: null,
+        source_path: null,
+    };
+}
+function resolveIdentityWithSocial(args) {
+    const { socialConfig, existingIdentity, generatedIdentity } = args;
+    if (socialConfig.openclaw.bind_existing_identity) {
+        const openclaw = findOpenClawIdentity(args.rootDir ?? process.cwd());
+        if (openclaw.identity) {
+            return {
+                identity: openclaw.identity,
+                source: "openclaw-existing",
+                openclaw_source_path: openclaw.source_path,
+            };
+        }
+    }
+    if (existingIdentity) {
+        return {
+            identity: existingIdentity,
+            source: "silicaclaw-existing",
+            openclaw_source_path: null,
+        };
+    }
+    return {
+        identity: generatedIdentity,
+        source: "silicaclaw-generated",
+        openclaw_source_path: null,
+    };
+}
+function resolveProfileInputWithSocial(args) {
+    const { socialConfig, agentId, existingProfile } = args;
+    const openclawProfile = socialConfig.openclaw.use_openclaw_profile_if_available
+        ? findOpenClawProfile(args.rootDir ?? process.cwd()).profile
+        : null;
+    const baseDisplayName = existingProfile?.display_name || "";
+    const baseBio = existingProfile?.bio || "";
+    const baseAvatarUrl = existingProfile?.avatar_url || "";
+    const baseTags = existingProfile?.tags || [];
+    // Preserve values saved from local-console first; only fall back to social/openclaw defaults
+    // when local profile fields are empty.
+    const displayName = baseDisplayName || socialConfig.identity.display_name || openclawProfile?.display_name || "";
+    const bio = baseBio || socialConfig.identity.bio || openclawProfile?.bio || "";
+    const avatarUrl = baseAvatarUrl || socialConfig.identity.avatar_url || openclawProfile?.avatar_url || "";
+    const tags = baseTags.length > 0
+        ? baseTags
+        : socialConfig.identity.tags.length > 0
+            ? socialConfig.identity.tags
+            : openclawProfile?.tags || [];
+    return {
+        agent_id: agentId,
+        display_name: displayName,
+        bio,
+        avatar_url: avatarUrl,
+        tags,
+        public_enabled: existingProfile?.public_enabled ?? socialConfig.public_enabled,
+    };
+}
+function ensureDefaultSocialMd(rootDir = process.cwd(), options = {}) {
+    const targetPath = (0, path_1.resolve)(rootDir, "social.md");
+    if ((0, fs_1.existsSync)(targetPath)) {
+        return { path: targetPath, created: false };
+    }
+    (0, fs_1.mkdirSync)(rootDir, { recursive: true });
+    (0, fs_1.writeFileSync)(targetPath, (0, socialConfig_1.generateDefaultSocialMdTemplate)(options), "utf8");
+    return { path: targetPath, created: true };
+}

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

@@ -0,0 +1,2 @@
+import { SocialRuntimeConfig } from "./socialConfig";
+export declare function generateSocialMdTemplate(runtimeConfig: SocialRuntimeConfig | null | undefined): string;

package/packages/core/dist/socialTemplate.js

@@ -0,0 +1,88 @@
+"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
+        : "lan";
+    const discoverable = asBool(discovery?.discoverable, true);
+    const allowProfileBroadcast = asBool(discovery?.allow_profile_broadcast, true);
+    const allowPresenceBroadcast = asBool(discovery?.allow_presence_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}
+
+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.
+`;
+}