@silicaclaw/cli 2026.3.19-2 → 2026.3.19-21

package/apps/local-console/dist/apps/local-console/src/server.d.ts

@@ -0,0 +1,752 @@
+import { AgentIdentity, DirectoryState, ProfileInput, PublicProfile, PublicProfileSummary, SocialConfig, SocialMessageRecord, SocialRuntimeConfig } from "@silicaclaw/core";
+import { SocialMessageGovernanceConfig } from "@silicaclaw/storage";
+type InitState = {
+    identity_auto_created: boolean;
+    profile_auto_created: boolean;
+    social_auto_created: boolean;
+    initialized_at: number;
+};
+type IntegrationStatusSummary = {
+    configured: boolean;
+    running: boolean;
+    discoverable: boolean;
+    network_mode: "local" | "lan" | "global-preview";
+    public_enabled: boolean;
+    agent_id: string;
+    display_name: string;
+    connected_to_silicaclaw: boolean;
+    configured_reason: string;
+    running_reason: string;
+    discoverable_reason: string;
+    status_line: string;
+};
+type SocialMessageView = SocialMessageRecord & {
+    is_self: boolean;
+    online: boolean;
+    last_seen_at: number | null;
+    observation_count: number;
+    remote_observation_count: number;
+    last_observed_at: number | null;
+    delivery_status: "local-only" | "remote-observed";
+};
+type RuntimeMessageGovernance = SocialMessageGovernanceConfig;
+type OpenClawBridgeStatus = {
+    enabled: boolean;
+    connected_to_silicaclaw: boolean;
+    public_enabled: boolean;
+    message_broadcast_enabled: boolean;
+    network_mode: "local" | "lan" | "global-preview";
+    adapter: string;
+    agent_id: string;
+    display_name: string;
+    identity_source: "silicaclaw-existing" | "openclaw-existing" | "silicaclaw-generated";
+    openclaw_identity_source_path: string | null;
+    social_source_path: string | null;
+    openclaw_installation: {
+        detected: boolean;
+        detection_mode: "command" | "workspace" | "home" | "not_found";
+        command_path: string | null;
+        workspace_dir: string;
+        home_dir: string;
+        workspace_dir_exists: boolean;
+        home_dir_exists: boolean;
+        workspace_identity_path: string | null;
+        workspace_profile_path: string | null;
+        workspace_social_path: string | null;
+        workspace_skills_path: string | null;
+        home_identity_path: string | null;
+        home_profile_path: string | null;
+        home_social_path: string | null;
+        home_skills_path: string | null;
+    };
+    openclaw_runtime: {
+        running: boolean;
+        process_count: number;
+        processes: Array<{
+            pid: number;
+            ppid: number;
+            command: string;
+        }>;
+        detection_error: string | null;
+        gateway_url: string;
+        gateway_port: number;
+        gateway_reachable: boolean;
+        configured_gateway_url: string;
+        configured_gateway_port: number;
+        configured_gateway_bind: string | null;
+        configured_gateway_config_path: string | null;
+        detection_mode: "process" | "gateway" | "process+gateway" | "not_running";
+    };
+    skill_learning: {
+        available: boolean;
+        installed: boolean;
+        install_mode: "workspace" | "legacy" | "not_installed";
+        installed_skill_path: string | null;
+        install_action: {
+            supported: boolean;
+            endpoint: string;
+            recommended_command: string;
+        };
+        skills: Array<{
+            key: "get_profile" | "list_messages" | "watch_messages" | "send_message";
+            summary: string;
+            endpoint: string;
+        }>;
+    };
+    owner_delivery: {
+        supported: boolean;
+        mode: "public-broadcast-via-openclaw";
+        send_to_owner_via_openclaw: boolean;
+        bridge_messages_readable: boolean;
+        forward_command_configured: boolean;
+        openclaw_command_resolvable: boolean;
+        ready: boolean;
+        forward_command: string | null;
+        owner_channel: string | null;
+        owner_target: string | null;
+        owner_account: string | null;
+        openclaw_source_dir: string | null;
+        reason: string;
+    };
+    endpoints: {
+        status: string;
+        profile: string;
+        messages: string;
+        send_message: string;
+        install_skill: string;
+    };
+};
+type OpenClawBridgeConfigView = {
+    bridge_api_base: string;
+    openclaw_detected: boolean;
+    openclaw_running: boolean;
+    openclaw_gateway_host: string;
+    openclaw_gateway_port: number;
+    openclaw_gateway_url: string;
+    openclaw_gateway_config_path: string | null;
+    openclaw_workspace_skill_dir: string;
+    openclaw_legacy_skill_dir: string;
+    silicaclaw_env_template_path: string;
+    recommended_skill_name: string;
+    recommended_install_command: string;
+    recommended_owner_forward_env: {
+        OPENCLAW_SOURCE_DIR: string;
+        OPENCLAW_OWNER_CHANNEL: string;
+        OPENCLAW_OWNER_TARGET: string;
+        OPENCLAW_OWNER_ACCOUNT: string;
+        OPENCLAW_OWNER_FORWARD_CMD: string;
+    };
+    owner_forward_command_example: string;
+    notes: string[];
+};
+export declare class LocalNodeService {
+    private workspaceRoot;
+    private projectRoot;
+    private storageRoot;
+    private identityRepo;
+    private profileRepo;
+    private cacheRepo;
+    private logRepo;
+    private socialMessageGovernanceRepo;
+    private socialMessageRepo;
+    private socialMessageObservationRepo;
+    private socialRuntimeRepo;
+    private identity;
+    private profile;
+    private directory;
+    private socialMessages;
+    private socialMessageObservations;
+    private messageGovernance;
+    private receivedCount;
+    private broadcastCount;
+    private lastMessageAt;
+    private lastBroadcastAt;
+    private lastBroadcastErrorAt;
+    private lastBroadcastError;
+    private broadcastFailureCount;
+    private broadcaster;
+    private subscriptionsBound;
+    private broadcastEnabled;
+    private receivedByTopic;
+    private publishedByTopic;
+    private outboundMessageTimestamps;
+    private inboundMessageTimestampsByAgent;
+    private initState;
+    private network;
+    private adapterMode;
+    private networkMode;
+    private networkNamespace;
+    private networkPort;
+    private socialConfig;
+    private socialSourcePath;
+    private socialFound;
+    private socialParseError;
+    private socialRawFrontmatter;
+    private socialRuntime;
+    private socialNetworkRequiresRestart;
+    private resolvedIdentitySource;
+    private resolvedOpenClawIdentityPath;
+    private webrtcSignalingUrls;
+    private webrtcRoom;
+    private webrtcSeedPeers;
+    private webrtcBootstrapHints;
+    private webrtcBootstrapSources;
+    private appVersion;
+    constructor(options?: {
+        workspaceRoot?: string;
+        projectRoot?: string;
+        storageRoot?: string;
+    });
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private ensureLocalDirectoryBaseline;
+    getOverview(): {
+        app_version: string;
+        agent_id: string;
+        public_enabled: boolean;
+        broadcast_enabled: boolean;
+        last_broadcast_at: number;
+        last_broadcast_error_at: number;
+        last_broadcast_error: string | null;
+        broadcast_failure_count: number;
+        discovered_count: number;
+        online_count: number;
+        offline_count: number;
+        init_state: InitState;
+        presence_ttl_ms: number;
+        onboarding: {
+            first_run: boolean;
+            connected: boolean;
+            discoverable: boolean;
+            mode: "global-preview" | "local" | "lan";
+            public_enabled: boolean;
+            can_enable_public_discovery: boolean;
+            next_steps: string[];
+        };
+        social: {
+            found: boolean;
+            enabled: boolean;
+            source_path: string | null;
+            network_mode: "global-preview" | "local" | "lan";
+            mode_explainer: {
+                mode: string;
+                short_label: string;
+                summary: string;
+            };
+            governance: {
+                send_limit: {
+                    max: number;
+                    window_ms: number;
+                };
+                receive_limit: {
+                    max: number;
+                    window_ms: number;
+                };
+                duplicate_window_ms: number;
+                blocked_agent_count: number;
+                blocked_term_count: number;
+            };
+        };
+    };
+    getNetworkSummary(): {
+        status: string;
+        adapter: "mock" | "local-event-bus" | "real-preview" | "webrtc-preview" | "relay-preview";
+        mode: "global-preview" | "local" | "lan";
+        received_count: number;
+        broadcast_count: number;
+        broadcast_failure_count: number;
+        last_message_at: number;
+        last_broadcast_at: number;
+        last_broadcast_error_at: number;
+        last_broadcast_error: string | null;
+        received_by_topic: Record<string, number>;
+        published_by_topic: Record<string, number>;
+        peers_discovered: any;
+        namespace: any;
+        port: number | null;
+        components: any;
+        real_preview_stats: any;
+        real_preview_transport_stats: any;
+        real_preview_discovery_stats: any;
+        webrtc_preview: {
+            signaling_url: any;
+            signaling_endpoints: any;
+            room: any;
+            bootstrap_sources: any;
+            seed_peers_count: any;
+            discovery_events_total: any;
+            last_discovery_event_at: any;
+            active_webrtc_peers: any;
+            reconnect_attempts_total: any;
+            last_join_at: any;
+            last_poll_at: any;
+            last_publish_at: any;
+            last_peer_refresh_at: any;
+            last_error_at: any;
+            last_error: any;
+        } | null;
+    };
+    getNetworkConfig(): {
+        adapter: "mock" | "local-event-bus" | "real-preview" | "webrtc-preview" | "relay-preview";
+        mode: "global-preview" | "local" | "lan";
+        namespace: any;
+        port: number | null;
+        components: any;
+        limits: any;
+        adapter_config: any;
+        adapter_extra: {
+            signaling_url: any;
+            signaling_endpoints: any;
+            room: any;
+            bootstrap_sources: any;
+            seed_peers_count: any;
+            discovery_events_total: any;
+            last_discovery_event_at: any;
+            connection_states_summary: any;
+            datachannel_states_summary: any;
+            last_join_at: any;
+            last_poll_at: any;
+            last_publish_at: any;
+            last_peer_refresh_at: any;
+            last_error_at: any;
+            last_error: any;
+        } | null;
+        env: {
+            NETWORK_ADAPTER: "mock" | "local-event-bus" | "real-preview" | "webrtc-preview" | "relay-preview";
+            NETWORK_NAMESPACE: string;
+            NETWORK_PORT: number | null;
+            NETWORK_MAX_MESSAGE_BYTES: number;
+            NETWORK_DEDUPE_WINDOW_MS: number;
+            NETWORK_DEDUPE_MAX_ENTRIES: number;
+            NETWORK_MAX_FUTURE_DRIFT_MS: number;
+            NETWORK_MAX_PAST_DRIFT_MS: number;
+            NETWORK_HEARTBEAT_INTERVAL_MS: number;
+            NETWORK_PEER_STALE_AFTER_MS: number;
+            NETWORK_PEER_REMOVE_AFTER_MS: number;
+            NETWORK_UDP_BIND_ADDRESS: string;
+            NETWORK_UDP_BROADCAST_ADDRESS: string;
+            NETWORK_PEER_ID: string | null;
+            WEBRTC_SIGNALING_URLS: string;
+            WEBRTC_SIGNALING_URL: string;
+            WEBRTC_ROOM: string;
+            WEBRTC_SEED_PEERS: string;
+            WEBRTC_BOOTSTRAP_HINTS: string;
+        };
+        demo_mode: string;
+        mode_explainer: {
+            mode: string;
+            short_label: string;
+            summary: string;
+        };
+    };
+    getNetworkStats(): {
+        adapter: "mock" | "local-event-bus" | "real-preview" | "webrtc-preview" | "relay-preview";
+        mode: "global-preview" | "local" | "lan";
+        message_counters: {
+            received_total: number;
+            broadcast_total: number;
+            broadcast_failures_total: number;
+            last_message_at: number;
+            last_broadcast_at: number;
+            last_broadcast_error_at: number;
+            last_broadcast_error: string | null;
+            received_by_topic: Record<string, number>;
+            published_by_topic: Record<string, number>;
+        };
+        peer_counters: {
+            total: number;
+            online: number;
+            stale: number;
+        };
+        adapter_config: any;
+        adapter_stats: any;
+        adapter_transport_stats: any;
+        adapter_discovery_stats: any;
+        adapter_diagnostics_summary: {
+            signaling_url: any;
+            signaling_endpoints: any;
+            room: any;
+            bootstrap_sources: any;
+            seed_peers_count: any;
+            discovery_events_total: any;
+            last_discovery_event_at: any;
+            connection_states_summary: any;
+            datachannel_states_summary: any;
+            signaling_messages_sent_total: any;
+            signaling_messages_received_total: any;
+            reconnect_attempts_total: any;
+            active_webrtc_peers: any;
+            last_join_at: any;
+            last_poll_at: any;
+            last_publish_at: any;
+            last_peer_refresh_at: any;
+            last_error_at: any;
+            last_error: any;
+        } | null;
+    };
+    getPeersSummary(): {
+        adapter: "mock" | "local-event-bus" | "real-preview" | "webrtc-preview" | "relay-preview";
+        namespace: string;
+        total: number;
+        online: number;
+        stale: number;
+        items: never[];
+        stats: null;
+        components?: undefined;
+        limits?: undefined;
+        diagnostics_summary?: undefined;
+    } | {
+        adapter: any;
+        namespace: any;
+        total: any;
+        online: any;
+        stale: any;
+        items: any;
+        stats: any;
+        components: any;
+        limits: any;
+        diagnostics_summary: {
+            signaling_url: any;
+            signaling_endpoints: any;
+            room: any;
+            bootstrap_sources: any;
+            seed_peers_count: any;
+            discovery_events_total: any;
+            last_discovery_event_at: any;
+            connection_states_summary: any;
+            datachannel_states_summary: any;
+            active_webrtc_peers: any;
+            last_join_at: any;
+            last_poll_at: any;
+            last_publish_at: any;
+            last_peer_refresh_at: any;
+            last_error_at: any;
+            last_error: any;
+        };
+    };
+    getDiscoveryEvents(): {
+        adapter: "mock" | "local-event-bus" | "real-preview" | "webrtc-preview" | "relay-preview";
+        mode: "global-preview" | "local" | "lan";
+        namespace: any;
+        total: any;
+        last_event_at: any;
+        items: any[];
+        bootstrap_sources: any;
+        signaling_endpoints: any;
+        seed_peers_count: any;
+    };
+    getSocialConfigView(): {
+        found: boolean;
+        source_path: string | null;
+        parse_error: string | null;
+        network_requires_restart: boolean;
+        social_config: SocialConfig;
+        raw_frontmatter: Record<string, unknown> | null;
+        runtime: SocialRuntimeConfig | null;
+        init_state: InitState;
+    };
+    getRuntimePaths(): {
+        workspace_root: string;
+        project_root: string;
+        storage_root: string;
+        data_dir: string;
+        social_runtime_path: string;
+        local_console_public_dir: string;
+        social_lookup_paths: string[];
+        social_source_path: string | null;
+    };
+    getIntegrationSummary(): {
+        connected: boolean;
+        discoverable: boolean;
+        summary_line: string;
+        social_md_found: boolean;
+        social_md_source_path: string | null;
+        runtime_generated: boolean;
+        reused_openclaw_identity: boolean;
+        openclaw_identity_source_path: string | null;
+        current_public_enabled: boolean;
+        current_network_mode: "global-preview" | "local" | "lan";
+        current_adapter: "mock" | "local-event-bus" | "real-preview" | "webrtc-preview" | "relay-preview";
+        current_namespace: string;
+        current_broadcast_status: string;
+        configured_enabled: boolean;
+        configured_public_enabled: boolean;
+        configured_discoverable: boolean;
+        configured: boolean;
+        running: boolean;
+        configured_reason: string;
+        running_reason: string;
+        discoverable_reason: string;
+        agent_id: string;
+        display_name: string;
+    };
+    getIntegrationStatus(): IntegrationStatusSummary;
+    setPublicDiscoveryRuntime(enabled: boolean): Promise<{
+        public_enabled: boolean;
+        note: string;
+    }>;
+    setNetworkModeRuntime(mode: "local" | "lan" | "global-preview"): Promise<{
+        mode: "global-preview" | "local" | "lan";
+        adapter: "mock" | "local-event-bus" | "real-preview" | "webrtc-preview" | "relay-preview";
+        network_requires_restart: boolean;
+        note: string;
+    }>;
+    quickConnectGlobalPreview(options?: {
+        signaling_url?: string;
+        room?: string;
+    }): Promise<{
+        mode: "global-preview" | "local" | "lan";
+        adapter: "mock" | "local-event-bus" | "real-preview" | "webrtc-preview" | "relay-preview";
+        signaling_url: string;
+        room: string;
+        network_requires_restart: boolean;
+        note: string;
+    }>;
+    reloadSocialConfig(): Promise<{
+        found: boolean;
+        source_path: string | null;
+        parse_error: string | null;
+        network_requires_restart: boolean;
+        social_config: SocialConfig;
+        raw_frontmatter: Record<string, unknown> | null;
+        runtime: SocialRuntimeConfig | null;
+        init_state: InitState;
+    }>;
+    generateDefaultSocialMd(): Promise<{
+        path: string;
+        created: boolean;
+    }>;
+    exportSocialTemplate(): {
+        filename: string;
+        content: string;
+    };
+    getDirectory(): DirectoryState;
+    search(keyword: string): PublicProfileSummary[];
+    getPublicProfilePreview(): PublicProfileSummary | null;
+    getAgentPublicSummary(agentId: string): PublicProfileSummary | null;
+    getProfile(): PublicProfile | null;
+    getIdentity(): AgentIdentity | null;
+    getSocialMessages(limit?: number, options?: {
+        agent_id?: string | null;
+    }): {
+        total: number;
+        items: SocialMessageView[];
+        governance: {
+            send_limit: {
+                max: number;
+                window_ms: number;
+            };
+            receive_limit: {
+                max: number;
+                window_ms: number;
+            };
+            duplicate_window_ms: number;
+            blocked_agent_count: number;
+            blocked_term_count: number;
+        };
+    };
+    getOpenClawBridgeStatus(): OpenClawBridgeStatus;
+    installOpenClawSkill(skillName?: string): Promise<any>;
+    getOpenClawBridgeProfile(): {
+        identity: AgentIdentity | null;
+        profile: PublicProfile | null;
+        public_profile_preview: PublicProfileSummary | null;
+        integration: {
+            connected: boolean;
+            discoverable: boolean;
+            summary_line: string;
+            social_md_found: boolean;
+            social_md_source_path: string | null;
+            runtime_generated: boolean;
+            reused_openclaw_identity: boolean;
+            openclaw_identity_source_path: string | null;
+            current_public_enabled: boolean;
+            current_network_mode: "global-preview" | "local" | "lan";
+            current_adapter: "mock" | "local-event-bus" | "real-preview" | "webrtc-preview" | "relay-preview";
+            current_namespace: string;
+            current_broadcast_status: string;
+            configured_enabled: boolean;
+            configured_public_enabled: boolean;
+            configured_discoverable: boolean;
+            configured: boolean;
+            running: boolean;
+            configured_reason: string;
+            running_reason: string;
+            discoverable_reason: string;
+            agent_id: string;
+            display_name: string;
+        };
+        bridge: OpenClawBridgeStatus;
+    };
+    getOpenClawBridgeConfig(): OpenClawBridgeConfigView;
+    getSkillsView(): {
+        openclaw: {
+            detected: boolean;
+            running: boolean;
+            detection_mode: "process+gateway" | "gateway" | "process" | "not_running";
+            gateway_url: string;
+            workspace_install_root: string;
+            legacy_install_root: string;
+        };
+        summary: {
+            bundled_count: number;
+            installed_count: number;
+            installed_bundled_count: number;
+            update_available_count: number;
+        };
+        install_action: {
+            supported: boolean;
+            endpoint: string;
+            recommended_command: string;
+        };
+        bundled_skills: {
+            installed_version: string | null;
+            update_available: boolean;
+            key: string;
+            name: string;
+            display_name: string;
+            description: string;
+            version: string;
+            source_path: string;
+            manifest_path: string | null;
+            skill_path: string | null;
+            capabilities: string[];
+            transport: {} | null;
+            owner_dialogue_cheatsheet_path: string | null;
+            owner_dialogue_examples_zh: string[];
+            owner_dialogue_sections_zh: {
+                title: string;
+                items: string[];
+            }[];
+            installed_in_openclaw: boolean;
+            install_mode: string;
+            installed_path: string | null;
+        }[];
+        installed_skills: {
+            bundled_version: string | null;
+            update_available: boolean;
+            key: string;
+            name: string;
+            display_name: string;
+            description: string;
+            version: string;
+            install_mode: "workspace" | "legacy";
+            installed_path: string;
+            manifest_path: string | null;
+            skill_path: string | null;
+            capabilities: string[];
+            owner_dialogue_cheatsheet_path: string | null;
+            owner_dialogue_examples_zh: string[];
+            owner_dialogue_sections_zh: {
+                title: string;
+                items: string[];
+            }[];
+            bundled_source_path: string | null;
+        }[];
+    };
+    getRuntimeMessageGovernance(): SocialMessageGovernanceConfig;
+    getMessageGovernanceView(): Promise<{
+        policy: {
+            send_limit: {
+                max: number;
+                window_ms: number;
+            };
+            receive_limit: {
+                max: number;
+                window_ms: number;
+            };
+            duplicate_window_ms: number;
+            blocked_agent_ids: string[];
+            blocked_terms: string[];
+        };
+        recent_events: import("@silicaclaw/storage").LogEntry[];
+    }>;
+    updateMessageGovernance(input: Partial<RuntimeMessageGovernance>): Promise<{
+        policy: {
+            send_limit: {
+                max: number;
+                window_ms: number;
+            };
+            receive_limit: {
+                max: number;
+                window_ms: number;
+            };
+            duplicate_window_ms: number;
+            blocked_agent_ids: string[];
+            blocked_terms: string[];
+        };
+        recent_events: import("@silicaclaw/storage").LogEntry[];
+    }>;
+    sendSocialMessage(body: string, topic?: string): Promise<{
+        sent: boolean;
+        reason: string;
+        message?: SocialMessageView;
+        error?: string;
+    }>;
+    getLogs(): Promise<import("@silicaclaw/storage").LogEntry[]>;
+    ensureIdentity(): Promise<AgentIdentity>;
+    updateProfile(input: Partial<ProfileInput>): Promise<PublicProfile>;
+    refreshCache(): Promise<{
+        removed_presence: number;
+        profile_count: number;
+        index_key_count: number;
+    }>;
+    clearDiscoveredCache(): Promise<{
+        removed_profiles: number;
+        removed_presence: number;
+        removed_index_refs: number;
+        kept_self_profile: boolean;
+    }>;
+    setBroadcastEnabled(enabled: boolean): Promise<{
+        broadcast_enabled: boolean;
+    }>;
+    broadcastNow(reason?: string): Promise<{
+        sent: boolean;
+        reason: string;
+        error?: string;
+    }>;
+    private hydrateFromDisk;
+    private applySocialConfigOnCurrentState;
+    private writeSocialRuntime;
+    private onMessage;
+    private startBroadcastLoop;
+    private bindNetworkSubscriptions;
+    private buildNetworkAdapter;
+    private restartNetworkAdapter;
+    private compactCacheInMemory;
+    private publish;
+    private persistCache;
+    private persistSocialMessages;
+    private persistSocialMessageObservations;
+    private log;
+    private getAdapterDiagnostics;
+    private getResolvedRealtimeNetworkSummary;
+    private toPublicProfileSummary;
+    private mergeMessageOnlyAgentSummaries;
+    private fingerprintPublicKey;
+    private getOnboardingSummary;
+    private getDefaultDisplayName;
+    private getModeExplainer;
+    private defaultMessageGovernance;
+    private adapterForMode;
+    private applyResolvedNetworkConfig;
+    private normalizeSocialMessageBody;
+    private normalizeWindowTimestamps;
+    private recordTimestamp;
+    private isRateLimited;
+    private containsBlockedMessageTerm;
+    private hasSocialMessage;
+    private getReplayableSelfSocialMessages;
+    private hasRecentDuplicateMessage;
+    private getIncomingSocialMessageRejectionReason;
+    private canPublishMessageObservation;
+    private publishObservationForMessage;
+    private normalizeIncomingSocialMessage;
+    private normalizeSocialMessages;
+    private normalizeIncomingSocialMessageObservation;
+    private normalizeSocialMessageObservations;
+    private ingestSocialMessage;
+    private ingestSocialMessageObservation;
+}
+export declare function main(): Promise<void>;
+export {};