@silicaclaw/cli 2026.3.19-15 → 2026.3.19-16

package/packages/core/dist/packages/core/src/socialMessage.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signSocialMessage = signSocialMessage;
+exports.verifySocialMessage = verifySocialMessage;
+exports.signSocialMessageObservation = signSocialMessageObservation;
+exports.verifySocialMessageObservation = verifySocialMessageObservation;
+const crypto_1 = require("./crypto");
+function unsignedSocialMessage(record) {
+    const { signature: _signature, ...rest } = record;
+    return rest;
+}
+function signSocialMessage(input) {
+    const payload = {
+        type: "social.message",
+        message_id: input.message_id,
+        agent_id: input.identity.agent_id,
+        public_key: input.identity.public_key,
+        display_name: input.display_name,
+        topic: input.topic,
+        body: input.body,
+        created_at: input.created_at ?? Date.now(),
+    };
+    return {
+        ...payload,
+        signature: (0, crypto_1.signPayload)(payload, input.identity.private_key),
+    };
+}
+function verifySocialMessage(record) {
+    try {
+        if ((0, crypto_1.hashPublicKey)((0, crypto_1.fromBase64)(record.public_key)) !== record.agent_id) {
+            return false;
+        }
+        return (0, crypto_1.verifyPayload)(unsignedSocialMessage(record), record.signature, record.public_key);
+    }
+    catch {
+        return false;
+    }
+}
+function unsignedSocialMessageObservation(record) {
+    const { signature: _signature, ...rest } = record;
+    return rest;
+}
+function signSocialMessageObservation(input) {
+    const payload = {
+        type: "social.message.observation",
+        observation_id: input.observation_id,
+        message_id: input.message_id,
+        observed_agent_id: input.observed_agent_id,
+        observer_agent_id: input.identity.agent_id,
+        observer_public_key: input.identity.public_key,
+        observer_display_name: input.observer_display_name,
+        observed_at: input.observed_at ?? Date.now(),
+    };
+    return {
+        ...payload,
+        signature: (0, crypto_1.signPayload)(payload, input.identity.private_key),
+    };
+}
+function verifySocialMessageObservation(record) {
+    try {
+        if ((0, crypto_1.hashPublicKey)((0, crypto_1.fromBase64)(record.observer_public_key)) !== record.observer_agent_id) {
+            return false;
+        }
+        return (0, crypto_1.verifyPayload)(unsignedSocialMessageObservation(record), record.signature, record.observer_public_key);
+    }
+    catch {
+        return false;
+    }
+}

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

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

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

@@ -0,0 +1,59 @@
+export type AgentIdentity = {
+    agent_id: string;
+    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;
+    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 DirectoryState = {
+    profiles: Record<string, PublicProfile>;
+    presence: Record<string, number>;
+    index: Record<string, string[]>;
+};
+export type ProfileInput = Omit<PublicProfile, "signature" | "updated_at">;

package/packages/core/dist/packages/core/src/types.js

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

package/packages/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/packages/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/packages/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/packages/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/packages/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/packages/network/dist/packages/network/src/abstractions/peerDiscovery.js

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

package/packages/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/packages/network/dist/packages/network/src/abstractions/topicCodec.js

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