@mooncompany/uplink-chat 0.5.0

package/public/js/satellites.js

@@ -0,0 +1,1516 @@
+// ============================================
+// SATELLITES MODULE
+// Multiple independent conversation tabs
+// ============================================
+// 
+// DEPENDENCY INTERFACE:
+// This module requires the following dependencies, which can be provided
+// via UplinkSatellites.init(config) or will fall back to window.* globals:
+//
+// - chat: { onConnection(cb), isConnected(), connected? } - Connection status
+// - notifications: { show(message, type) } - User notifications
+// - storage: { loadHistory() } - For migration from legacy storage
+// - panels: { register(id, handlers), toggle(id) } - Panel management
+// - core: { registerModule(name, initFn) } - Module lifecycle
+// - messageApi: { addMessage(text, type, imageUrl, save) } - Chat messages
+// - logger: { debug(...), warn(...), error(...) } - Logging
+//
+// EVENTS EMITTED:
+// - 'uplink:satellite-switching' - Before switch (detail: { satelliteId })
+// - 'uplink:satellite-switched' - After switch (detail: { satelliteId })
+// - 'satellite:switched' (via event bus) - After switch (detail: { satelliteId })
+//
+// ============================================
+
+import { emit as emitEvent, on as onEvent } from './event-bus.js';
+import * as SatelliteUI from './satellite-ui.js';
+
+const STORAGE_KEY = 'uplink-satellites';
+const PRIMARY_SATELLITE = 'main';
+
+// ============================================
+// DEPENDENCY CONTAINER
+// ============================================
+
+// Dependencies with fallbacks to window.* for backwards compatibility
+const deps = {
+  chat: null,
+  notifications: null,
+  storage: null,
+  panels: null,
+  core: null,
+  messageApi: null,
+  logger: null
+};
+
+/**
+ * Resolve a dependency - use injected or fall back to window.*
+ */
+function getChat() {
+  return deps.chat || window.gatewayChat || window.UplinkChat || null;
+}
+
+function getNotifications() {
+  return deps.notifications || window.UplinkNotifications || null;
+}
+
+function getStorage() {
+  return deps.storage || window.UplinkStorage || null;
+}
+
+function getPanels() {
+  return deps.panels || window.UplinkPanels || null;
+}
+
+function getCore() {
+  return deps.core || window.UplinkCore || null;
+}
+
+function getLogger() {
+  return deps.logger || window.logger || console;
+}
+
+function getMessageApi() {
+  // For message API, prefer UplinkChat's addMessage
+  if (deps.messageApi) return deps.messageApi;
+  if (window.UplinkChat && window.UplinkChat.addMessage) {
+    return { addMessage: window.UplinkChat.addMessage };
+  }
+  if (window._originalAddMessage) {
+    return { addMessage: window._originalAddMessage };
+  }
+  if (window.addMessage) {
+    return { addMessage: window.addMessage };
+  }
+  return null;
+}
+
+// ============================================
+// STATE
+// ============================================
+
+let satellites = {};
+let currentSatellite = PRIMARY_SATELLITE;
+let defaultSatellite = PRIMARY_SATELLITE; // Pinned to top of list
+let panelVisible = false;
+
+// UI Elements
+let navigatorPanel = null;
+
+// Timer tracking for cleanup
+let connectionPollInterval = null;
+let pendingDeleteTimers = new Map();
+
+// History fetch debouncing (for visibility change)
+let lastHistoryFetch = 0;
+const HISTORY_FETCH_DEBOUNCE_MS = 10000; // 10 seconds
+
+// Module init retry state
+let initRetryCount = 0;
+const MAX_INIT_RETRIES = 10;
+
+// Track if message hook is installed
+let messageHookInstalled = false;
+
+// ============================================
+// INITIALIZATION
+// ============================================
+
+/**
+ * Initialize the satellites module with optional dependency injection
+ * @param {Object} config - Optional configuration object
+ * @param {Object} config.chat - Chat module with onConnection, isConnected
+ * @param {Object} config.notifications - Notifications module with show()
+ * @param {Object} config.storage - Storage module with loadHistory()
+ * @param {Object} config.panels - Panel manager with register(), toggle()
+ * @param {Object} config.core - Core module with registerModule()
+ * @param {Object} config.messageApi - Message API with addMessage()
+ * @param {Object} config.logger - Logger with debug, warn, error
+ */
+async function init(config = {}) {
+  // Inject dependencies if provided
+  if (config.chat) deps.chat = config.chat;
+  if (config.notifications) deps.notifications = config.notifications;
+  if (config.storage) deps.storage = config.storage;
+  if (config.panels) deps.panels = config.panels;
+  if (config.core) deps.core = config.core;
+  if (config.messageApi) deps.messageApi = config.messageApi;
+  if (config.logger) deps.logger = config.logger;
+
+  loadSatellites();
+  await syncRemoteSessionsWrapper();
+  createNavigatorPanel();
+  injectMessageHooks();
+  
+  // Also listen to event bus for messages (in addition to hook)
+  onEvent('message:added', ({ text, type, imageUrl, save }) => {
+    if (save && type !== 'system') {
+      addMessageToSatellite({ text, type, imageUrl });
+    }
+  });
+  
+  // Handle URL parameter for satellite embedding (e.g., ?satellite=redos-workshop)
+  const urlParams = new URLSearchParams(window.location.search);
+  const urlSatelliteId = urlParams.get('satellite');
+  if (urlSatelliteId && urlSatelliteId !== 'main') {
+    const sanitizedId = urlSatelliteId.replace(/[^a-zA-Z0-9_-]/g, '').substring(0, 32);
+    if (sanitizedId) {
+      // Create satellite if it doesn't exist
+      if (!satellites[sanitizedId]) {
+        // Use URL param 'name' if provided, otherwise humanize the ID
+        const urlSatelliteName = urlParams.get('name') || sanitizedId.replace(/-/g, ' ').replace(/\b\w/g, c => c.toUpperCase());
+        satellites[sanitizedId] = {
+          name: urlSatelliteName,
+          createdAt: Date.now(),
+          embedded: true  // Mark as externally embedded
+        };
+        saveSatellites();
+        getLogger().debug('Satellites: Created embedded satellite from URL:', sanitizedId, urlSatelliteName);
+      }
+      // Switch to the satellite
+      currentSatellite = sanitizedId;
+      getLogger().debug('Satellites: Switched to URL satellite:', sanitizedId);
+    }
+  }
+  
+  // Migrate existing history if this is first run
+  await migrateExistingHistory();
+  
+  // Check session status on init
+  updateSessionStatus();
+  
+  // Setup connection listener for history loading with race condition protection
+  setupConnectionListener();
+  
+  // Setup visibility change handler for history refresh on tab focus
+  setupVisibilityHandler();
+  
+  getLogger().debug('Satellites: Initialized with', Object.keys(satellites).length, 'satellites');
+}
+
+// ============================================
+// CONNECTION LISTENER (Race Condition Fix)
+// ============================================
+
+function setupConnectionListener() {
+  // Try UplinkConnection first (handles WebSocket state)
+  const connection = window.UplinkConnection;
+  const chat = getChat();
+  
+  console.log('[Satellites] setupConnectionListener - connection:', !!connection, 'chat:', !!chat);
+  
+  // Prefer UplinkConnection for connection events
+  if (connection && connection.onConnection) {
+    console.log('[Satellites] Using UplinkConnection for connection events');
+    connection.onConnection((event) => {
+      if (event === 'connected') {
+        console.log('[Satellites] UplinkConnection: connected event, loading history');
+        loadHistoryOnConnect();
+      }
+    });
+    
+    // Check if already connected
+    if (connection.isConnected && connection.isConnected()) {
+      console.log('[Satellites] UplinkConnection: already connected, loading history');
+      loadHistoryOnConnect();
+      return;
+    }
+  } else if (chat && chat.onConnection) {
+    // Fallback to chat module
+    chat.onConnection(() => {
+      console.log('[Satellites] Connection callback fired, loading history');
+      loadHistoryOnConnect();
+    });
+    
+    if (chat.isConnected && chat.isConnected()) {
+      console.log('[Satellites] Already connected on init, loading history');
+      loadHistoryOnConnect();
+      return;
+    }
+  } else {
+    console.log('[Satellites] No connection module found, will use polling fallback');
+  }
+  
+  // Polling fallback: Check every 100ms for connection readiness
+  let pollCount = 0;
+  const maxPolls = 50; // 5 seconds max
+  
+  // Clear any existing poll interval before starting new one
+  if (connectionPollInterval) {
+    clearInterval(connectionPollInterval);
+    connectionPollInterval = null;
+  }
+  
+  connectionPollInterval = setInterval(() => {
+    pollCount++;
+    
+    const conn = window.UplinkConnection;
+    const chatInstance = getChat();
+    
+    if (pollCount === 1 || pollCount % 10 === 0) {
+      const connStatus = conn ? (conn.isConnected ? conn.isConnected() : 'no isConnected') : 'no conn';
+      console.log('[Satellites] Polling attempt', pollCount, '- connection:', connStatus);
+    }
+    
+    // Check UplinkConnection first
+    if (conn && conn.isConnected && conn.isConnected()) {
+      console.log('[Satellites] Connection detected via UplinkConnection polling');
+      clearInterval(connectionPollInterval);
+      connectionPollInterval = null;
+      loadHistoryOnConnect();
+      return;
+    }
+    
+    // Fallback: check chat instance
+    if (chatInstance) {
+      const isConnected = chatInstance.isConnected ? chatInstance.isConnected() : 
+                         chatInstance.connected || chatInstance.readyState === 1;
+      
+      if (isConnected) {
+        console.log('[Satellites] Connection detected via chat polling');
+        clearInterval(connectionPollInterval);
+        connectionPollInterval = null;
+        loadHistoryOnConnect();
+        return;
+      }
+    }
+    
+    // Stop polling after max attempts
+    if (pollCount >= maxPolls) {
+      clearInterval(connectionPollInterval);
+      connectionPollInterval = null;
+      console.log('[Satellites] Connection polling timed out after', maxPolls, 'attempts');
+      // Last resort: try loading history anyway (HTTP fetch might still work)
+      console.log('[Satellites] Attempting history load despite no connection detected');
+      loadHistoryOnConnect();
+    }
+  }, 100);
+}
+
+async function loadHistoryOnConnect() {
+  console.log('[Satellites] loadHistoryOnConnect called');
+  
+  // Fetch history from Gateway and merge with local messages
+  await fetchAndMergeGatewayHistory();
+  
+  // Reload chat display for the current satellite
+  reloadChatDisplay();
+  
+  // Also refresh session status
+  updateSessionStatus();
+  
+  // Track fetch time for debouncing
+  lastHistoryFetch = Date.now();
+  
+  console.log('[Satellites] loadHistoryOnConnect complete');
+}
+
+/**
+ * Handle visibility change - fetch history when tab becomes visible
+ */
+function setupVisibilityHandler() {
+  document.addEventListener('visibilitychange', async () => {
+    if (document.visibilityState !== 'visible') return;
+    
+    // Don't fire API calls if not connected yet (avoid fetch errors during reconnect)
+    if (!window.UplinkConnection?.isConnected?.()) {
+      getLogger().debug('Satellites: Skipping visibility fetch (not connected)');
+      return;
+    }
+    
+    // Debounce: don't fetch if we just fetched recently
+    const now = Date.now();
+    if (now - lastHistoryFetch < HISTORY_FETCH_DEBOUNCE_MS) {
+      getLogger().debug('Satellites: Skipping visibility fetch (debounced)');
+      return;
+    }
+    
+    getLogger().debug('Satellites: Tab visible, fetching history...');
+    lastHistoryFetch = now;
+    
+    // Sync remote sessions (pick up satellites created on other devices)
+    const prevCount = Object.keys(satellites).length;
+    await syncRemoteSessionsWrapper();
+    if (Object.keys(satellites).length > prevCount) {
+      // New satellites appeared — refresh the navigator panel
+      createNavigatorPanel();
+    }
+
+    await fetchAndMergeGatewayHistory();
+    reloadChatDisplay();
+  });
+}
+
+/**
+ * Fetch history from Gateway and merge with local satellite messages
+ */
+async function fetchAndMergeGatewayHistory() {
+  if (!window.UplinkSatelliteSync) {
+    getLogger().warn('Satellites: UplinkSatelliteSync not loaded yet');
+    return;
+  }
+  
+  const satellite = satellites[currentSatellite];
+  if (!satellite) return;
+  
+  await window.UplinkSatelliteSync.fetchAndMergeGatewayHistory(currentSatellite, satellite);
+}
+
+// ============================================
+// DATA MANAGEMENT
+// ============================================
+
+function loadSatellites() {
+  try {
+    const stored = localStorage.getItem(STORAGE_KEY);
+    if (stored) {
+      const data = JSON.parse(stored);
+      satellites = data.satellites || {};
+      currentSatellite = data.currentSatellite || PRIMARY_SATELLITE;
+      defaultSatellite = data.defaultSatellite || PRIMARY_SATELLITE;
+    }
+    
+    // Ensure primary satellite exists
+    if (!satellites[PRIMARY_SATELLITE]) {
+      satellites[PRIMARY_SATELLITE] = createSatelliteData(PRIMARY_SATELLITE, 'Primary', null);
+    }
+    
+    // Ensure default satellite still exists, fallback to primary
+    if (!satellites[defaultSatellite]) {
+      defaultSatellite = PRIMARY_SATELLITE;
+    }
+  } catch (e) {
+    getLogger().error('Satellites: Failed to load', e);
+    satellites = { [PRIMARY_SATELLITE]: createSatelliteData(PRIMARY_SATELLITE, 'Primary', null) };
+    currentSatellite = PRIMARY_SATELLITE;
+    defaultSatellite = PRIMARY_SATELLITE;
+  }
+}
+
+function saveSatellites() {
+  try {
+    localStorage.setItem(STORAGE_KEY, JSON.stringify({
+      satellites,
+      currentSatellite,
+      defaultSatellite
+    }));
+  } catch (e) {
+    getLogger().error('Satellites: Failed to save', e);
+  }
+}
+
+/**
+ * Wrapper for sync module - maintains local state
+ */
+async function syncRemoteSessionsWrapper() {
+  if (!window.UplinkSatelliteSync) {
+    getLogger().warn('Satellites: UplinkSatelliteSync not loaded yet');
+    return;
+  }
+  
+  const result = await window.UplinkSatelliteSync.syncRemoteSessions(
+    satellites, 
+    PRIMARY_SATELLITE, 
+    currentSatellite
+  );
+  
+  // Update local state from sync result
+  satellites = result.satellites;
+  currentSatellite = result.currentSatellite;
+  
+  if (result.added > 0 || result.removed > 0) {
+    saveSatellites();
+  }
+}
+
+function createSatelliteData(id, name, agentId) {
+  return {
+    id,
+    name,
+    agentId: agentId || 'main',
+    createdAt: Date.now(),
+    messages: []
+  };
+}
+
+function generateSatelliteId() {
+  return 'sat-' + Date.now().toString(36) + Math.random().toString(36).substr(2, 4);
+}
+
+function getAgentEmoji(agentId) {
+  const agents = window.UplinkAgents?.getAgents?.() || [];
+  const agent = agents.find(a => a.id === agentId);
+  return agent?.identity?.emoji || '🤖';
+}
+
+// ============================================
+// SATELLITE OPERATIONS
+// ============================================
+
+function promptForSatelliteName() {
+  // Create inline prompt in the navigator panel
+  const listEl = document.getElementById('satelliteList');
+  if (!listEl) return;
+  
+  // Check if prompt already exists
+  if (listEl.querySelector('.satellite-name-prompt')) return;
+  
+  // Build agent options from the agents module
+  const agentsList = window.UplinkAgents?.getAgents?.() || [];
+  const hasMultipleAgents = agentsList.length > 1;
+  const agentOptions = agentsList.map(a => {
+    const label = a.identity?.emoji ? `${a.identity.emoji} ${a.identity?.name || a.name || a.id}` : (a.identity?.name || a.name || a.id);
+    return `<option value="${a.id}" ${a.default ? 'selected' : ''}>${label}</option>`;
+  }).join('');
+
+  const promptHtml = `
+    <div class="satellite-name-prompt">
+      <input type="text" class="satellite-name-input" placeholder="Satellite name..." maxlength="32" autofocus>
+      ${hasMultipleAgents ? `
+      <div class="satellite-agent-field">
+        <label class="satellite-agent-label">Agent</label>
+        <select class="satellite-agent-select" id="satelliteAgentSelect">
+          ${agentOptions}
+        </select>
+      </div>
+      ` : ''}
+      <div class="satellite-prompt-buttons">
+        <button class="satellite-prompt-cancel">Cancel</button>
+        <button class="satellite-prompt-create">Create</button>
+      </div>
+    </div>
+  `;
+  
+  listEl.insertAdjacentHTML('afterbegin', promptHtml);
+  
+  const promptEl = listEl.querySelector('.satellite-name-prompt');
+  const inputEl = promptEl.querySelector('.satellite-name-input');
+  const cancelBtn = promptEl.querySelector('.satellite-prompt-cancel');
+  const createBtn = promptEl.querySelector('.satellite-prompt-create');
+  const agentSelect = promptEl.querySelector('#satelliteAgentSelect');
+  
+  inputEl.focus();
+  
+  const cleanup = () => promptEl.remove();
+  
+  const doCreate = () => {
+    const name = inputEl.value.trim();
+    const agentId = agentSelect?.value || 'main';
+    cleanup();
+    launchSatellite(name || null, null, agentId);
+  };
+  
+  cancelBtn.addEventListener('click', cleanup);
+  createBtn.addEventListener('click', doCreate);
+  inputEl.addEventListener('keydown', (e) => {
+    if (e.key === 'Enter') doCreate();
+    if (e.key === 'Escape') cleanup();
+  });
+}
+
+function launchSatellite(name, initialMessages = null, agentId = null) {
+  const satId = generateSatelliteId();
+  const satellite = createSatelliteData(
+    satId,
+    name || `Satellite ${Object.keys(satellites).length}`,
+    agentId
+  );
+  
+  // If initial messages provided (fork), populate the satellite
+  if (initialMessages && Array.isArray(initialMessages)) {
+    satellite.messages = initialMessages.map(msg => ({
+      text: msg.text,
+      type: msg.type,
+      timestamp: Date.now()
+    }));
+  }
+  
+  satellites[satId] = satellite;
+  saveSatellites();
+  
+  // Switch to new satellite
+  connectToSatellite(satId);
+  
+  // Show notification
+  const forkNote = initialMessages ? ` (forked with ${initialMessages.length} messages)` : '';
+  showNotification(`Launched "${satellite.name}" 🛰️${forkNote}`);
+  
+  return satId;
+}
+
+function connectToSatellite(satId) {
+  console.log('[Satellites] connectToSatellite called with:', satId);
+  if (!satellites[satId]) return false;
+  
+  // Show loading state and disable interaction
+  showSwitchingIndicator(true);
+  
+  currentSatellite = satId;
+  saveSatellites();
+  
+  // Emit event BEFORE reload (so listeners can clear state like reply context)
+  window.dispatchEvent(new CustomEvent('uplink:satellite-switching', { 
+    detail: { satelliteId: satId } 
+  }));
+  
+  // Clear sync deduplication state for new satellite
+  if (window.UplinkConnection?.clearSyncDedup) {
+    window.UplinkConnection.clearSyncDedup();
+  }
+  
+  // Fetch history from gateway then reload display
+  fetchAndMergeGatewayHistory().then(() => {
+    reloadChatDisplay();
+  });
+  updateNavigator();
+  
+  // Update session status indicator
+  updateSessionStatus(satId);
+  
+  // Show toast notification on satellite switch
+  showNotification(`Switched to "${satellites[satId].name}" 🛰️`);
+  
+  // Emit event after switch complete
+  window.dispatchEvent(new CustomEvent('uplink:satellite-switched', { 
+    detail: { satelliteId: satId } 
+  }));
+  
+  // Also emit via event bus for cross-module communication
+  emitEvent('satellite:switched', { satelliteId: satId });
+  
+  // Hide loading state after a brief delay to ensure UI updates complete
+  setTimeout(() => {
+    showSwitchingIndicator(false);
+  }, 150);
+  
+  return true;
+}
+
+/**
+ * Show/hide loading indicator during satellite switch
+ */
+function showSwitchingIndicator(show) {
+  const messagesEl = document.getElementById('messages');
+  const inputArea = document.querySelector('.input-area, .chat-input');
+  const overlay = document.getElementById('satelliteSwitchOverlay');
+  
+  if (show) {
+    // Disable input during switch
+    if (inputArea) {
+      inputArea.classList.add('switching-satellite');
+      inputArea.style.pointerEvents = 'none';
+      inputArea.style.opacity = '0.5';
+    }
+    
+    // Add loading overlay to messages area
+    if (messagesEl && !overlay) {
+      const loadingOverlay = document.createElement('div');
+      loadingOverlay.id = 'satelliteSwitchOverlay';
+      loadingOverlay.className = 'satellite-switch-overlay';
+      loadingOverlay.innerHTML = `
+        <div class="satellite-switch-spinner">
+          <span>🛰️</span>
+          <span>Switching...</span>
+        </div>
+      `;
+      loadingOverlay.style.cssText = `
+        position: absolute;
+        top: 0;
+        left: 0;
+        right: 0;
+        bottom: 0;
+        background: var(--bg-primary, rgba(0,0,0,0.7));
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        z-index: 100;
+        animation: fadeIn 0.15s ease;
+      `;
+      messagesEl.style.position = 'relative';
+      messagesEl.appendChild(loadingOverlay);
+    }
+  } else {
+    // Re-enable input
+    if (inputArea) {
+      inputArea.classList.remove('switching-satellite');
+      inputArea.style.pointerEvents = '';
+      inputArea.style.opacity = '';
+    }
+    
+    // Remove overlay
+    const existingOverlay = document.getElementById('satelliteSwitchOverlay');
+    if (existingOverlay) {
+      existingOverlay.remove();
+    }
+  }
+}
+
+/**
+ * Fetch and display session status from OpenClaw
+ */
+async function updateSessionStatus(satId = currentSatellite) {
+  const indicator = document.getElementById('sessionIndicator');
+  const keyDisplay = document.getElementById('sessionKeyDisplay');
+  
+  if (!indicator || !keyDisplay) return;
+  
+  if (!window.UplinkSatelliteSync) {
+    getLogger().warn('Satellites: UplinkSatelliteSync not loaded yet');
+    return;
+  }
+  
+  // Show loading state
+  indicator.className = 'session-indicator loading';
+  indicator.title = 'Checking session...';
+  keyDisplay.textContent = 'checking...';
+  
+  const satAgentId = satellites[satId]?.agentId || 'main';
+  const data = await window.UplinkSatelliteSync.fetchSessionStatus(satId, satAgentId);
+  
+  if (!data) {
+    indicator.className = 'session-indicator error';
+    indicator.title = 'Failed to check session';
+    keyDisplay.textContent = 'error';
+    return;
+  }
+  
+  if (data.gatewayConnected) {
+    indicator.className = 'session-indicator connected';
+    indicator.title = 'Connected to OpenClaw';
+  } else {
+    indicator.className = 'session-indicator disconnected';
+    indicator.title = 'Gateway offline';
+  }
+  
+  // Show abbreviated session key
+  const shortKey = data.sessionKey.replace('agent:main:', '');
+  keyDisplay.textContent = shortKey;
+  keyDisplay.title = `Session: ${data.sessionKey}\nClick to copy`;
+  
+  // Click to copy
+  keyDisplay.onclick = () => {
+    navigator.clipboard.writeText(data.sessionKey);
+    showNotification('Session key copied');
+  };
+}
+
+function deleteSatellite(satId, skipConfirm = false) {
+  console.log('[Satellites] deleteSatellite START, panelVisible:', panelVisible);
+  
+  // Primary satellite cannot be deleted (button is disabled in UI as visual feedback)
+  if (satId === PRIMARY_SATELLITE) {
+    return false;
+  }
+  
+  const satellite = satellites[satId];
+  const isCurrentSatellite = satId === currentSatellite;
+  
+  // Check for pending delete state (click delete twice to confirm)
+  if (!skipConfirm) {
+    if (!satellite._pendingDelete) {
+      // First click - set pending state and show visual feedback
+      satellite._pendingDelete = Date.now();
+      
+      // Extra warning if retiring the current satellite
+      if (isCurrentSatellite) {
+        showNotification('⚠️ You\'re in this satellite! Click again to retire it.', 'warning');
+      } else {
+        showNotification('Are you sure you want to retire this satellite?', 'info');
+      }
+      console.log('[Satellites] After showNotification, panelVisible:', panelVisible);
+      updateNavigator(); // Re-render to show pending state
+      console.log('[Satellites] After updateNavigator, panelVisible:', panelVisible);
+      
+      // Clear any existing timer for this satellite
+      if (pendingDeleteTimers.has(satId)) {
+        clearTimeout(pendingDeleteTimers.get(satId));
+      }
+      
+      // Auto-clear pending state after 5 seconds
+      const timerId = setTimeout(() => {
+        if (satellite._pendingDelete) {
+          delete satellite._pendingDelete;
+          updateNavigator();
+        }
+        pendingDeleteTimers.delete(satId);
+      }, 5000);
+      pendingDeleteTimers.set(satId, timerId);
+      return false;
+    }
+    
+    // Second click on current satellite - show final warning with message count
+    if (isCurrentSatellite && !satellite._confirmedCurrentDelete) {
+      const msgCount = getMessageCountInSatellite(satId);
+      satellite._confirmedCurrentDelete = true;
+      showNotification(`⚠️ This will delete ${msgCount} messages. Click once more to confirm.`, 'warning');
+      
+      // Reset the confirmation after 5 seconds
+      setTimeout(() => {
+        if (satellite._confirmedCurrentDelete) {
+          delete satellite._confirmedCurrentDelete;
+          delete satellite._pendingDelete;
+          updateNavigator();
+        }
+      }, 5000);
+      return false;
+    }
+  }
+  
+  // Call the retire API to also delete the OpenClaw session
+  retireSatelliteSession(satId);
+  
+  // If we're on this satellite, switch to primary
+  if (currentSatellite === satId) {
+    currentSatellite = PRIMARY_SATELLITE;
+  }
+  
+  delete satellites[satId];
+  saveSatellites();
+  reloadChatDisplay();
+  updateNavigator();
+  
+  // Ensure panel stays visible after delete (fix for splitview state desync)
+  if (navigatorPanel) {
+    navigatorPanel.style.display = 'flex';
+    navigatorPanel.classList.add('visible');
+  }
+  // Also ensure splitview side panel stays open if on desktop
+  const sidePanel = document.getElementById('sidePanel');
+  if (sidePanel) {
+    sidePanel.classList.add('visible');
+    document.body.classList.add('panel-open');
+  }
+  
+  showNotification('Satellite decommissioned');
+  return true;
+}
+
+/**
+ * Call the backend to retire a satellite's OpenClaw session
+ * This deletes both the session entry and transcript from OpenClaw
+ */
+async function retireSatelliteSession(satId) {
+  if (!window.UplinkSatelliteSync) {
+    getLogger().warn('Satellites: UplinkSatelliteSync not loaded yet');
+    return;
+  }
+  
+  const result = await window.UplinkSatelliteSync.retireSatelliteSession(
+    satId, 
+    satellites[satId]?.agentId || 'main'
+  );
+  
+  // Show additional feedback if OpenClaw session was deleted
+  if (result && (result.sessionDeleted || result.transcriptDeleted)) {
+    showNotification('Session data cleared from OpenClaw', 'info');
+  }
+}
+
+function setAsPrimary(satId) {
+  if (!satellites[satId]) return;
+  
+  // Just set this satellite as the default (pinned to top)
+  defaultSatellite = satId;
+  saveSatellites();
+  
+  // Switch to it
+  connectToSatellite(satId);
+  updateNavigator();
+  
+  showNotification(`"${satellites[satId].name}" is now default`);
+}
+
+function renameSatellite(satId) {
+  const satellite = satellites[satId];
+  if (!satellite) return;
+  
+  // Try native prompt first
+  let newName = prompt('Rename satellite:', satellite.name);
+  
+  // If prompt returns null (cancelled or not working), use inline edit
+  if (newName === null) {
+    // Find the satellite item and make name editable
+    const item = navigatorPanel?.querySelector(`[data-satellite-id="${satId}"]`);
+    const nameEl = item?.querySelector('.satellite-item-name');
+    if (nameEl) {
+      const input = document.createElement('input');
+      input.type = 'text';
+      input.value = satellite.name;
+      input.className = 'satellite-rename-input';
+      input.style.cssText = 'width: 100px; padding: 2px 4px; font-size: inherit; border: 1px solid var(--accent); border-radius: 4px; background: var(--bg-secondary); color: inherit;';
+      
+      const originalText = nameEl.textContent;
+      nameEl.textContent = '';
+      nameEl.appendChild(input);
+      input.focus();
+      input.select();
+      
+      const finishEdit = (save) => {
+        const val = input.value.trim();
+        if (save && val) {
+          satellite.name = val;
+          saveSatellites();
+        }
+        nameEl.textContent = save && val ? val : originalText;
+        updateNavigator();
+      };
+      
+      input.addEventListener('blur', () => finishEdit(true));
+      input.addEventListener('keydown', (e) => {
+        if (e.key === 'Enter') { e.preventDefault(); finishEdit(true); }
+        if (e.key === 'Escape') { e.preventDefault(); finishEdit(false); }
+      });
+    }
+    return;
+  }
+  
+  if (newName.trim() === '') return;
+  
+  satellite.name = newName.trim();
+  saveSatellites();
+  updateNavigator();
+}
+
+// ============================================
+// MESSAGE HISTORY
+// ============================================
+
+function getMessageHistory(satId = currentSatellite) {
+  const satellite = satellites[satId];
+  if (!satellite) return [];
+  return satellite.messages || [];
+}
+
+function addMessageToSatellite(msg) {
+  console.log('[Satellites] addMessageToSatellite called, currentSatellite:', currentSatellite, 'msg type:', msg.type);
+  
+  // Main satellite uses Gateway as source of truth for text messages
+  // But we DO save image messages locally since Gateway doesn't track them
+  if (currentSatellite === 'main') {
+    if (!msg.imageUrl) {
+      console.log('[Satellites] Skipping local save for main satellite (Gateway is source of truth)');
+      return;
+    }
+    console.log('[Satellites] Saving image message locally for main satellite');
+  }
+  
+  if (!satellites[currentSatellite]) {
+    console.warn('[Satellites] currentSatellite not found in satellites object!');
+    return;
+  }
+  
+  // Don't store data URLs — they're too large for localStorage
+  const safeMsg = { ...msg };
+  if (safeMsg.imageUrl && safeMsg.imageUrl.startsWith('data:')) {
+    safeMsg.imageUrl = '__pending_upload__';
+  }
+  
+  satellites[currentSatellite].messages.push({
+    ...safeMsg,
+    timestamp: safeMsg.timestamp || Date.now()
+  });
+  
+  console.log('[Satellites] Message saved. Total messages for', currentSatellite, ':', satellites[currentSatellite].messages.length);
+  saveSatellites();
+}
+
+function getMessageCountInSatellite(satId) {
+  return (satellites[satId]?.messages || []).length;
+}
+
+// ============================================
+// UI: NAVIGATOR PANEL
+// ============================================
+
+// Active tab: 'satellites' or 'agents'
+let activeTab = 'satellites';
+
+function switchTab(tab) {
+  // Premium gate: block agents tab for free users
+  if (tab === 'agents' && window.UplinkPremium && !window.UplinkPremium.isActive()) {
+    window.UplinkPremium.showUpgradeModal('Agent management');
+    return;
+  }
+
+  activeTab = tab;
+  const satTabs = navigatorPanel.querySelectorAll('[data-nav-tab="satellites"]');
+  const agentsTabs = navigatorPanel.querySelectorAll('[data-nav-tab="agents"]');
+  const satContent = navigatorPanel.querySelector('.satellite-tab-content');
+  const agentsContent = navigatorPanel.querySelector('.agents-tab-content');
+
+  if (tab === 'satellites') {
+    satTabs.forEach(t => t.classList.add('active'));
+    agentsTabs.forEach(t => t.classList.remove('active'));
+    if (satContent) satContent.style.display = '';
+    if (agentsContent) agentsContent.style.display = 'none';
+  } else {
+    satTabs.forEach(t => t.classList.remove('active'));
+    agentsTabs.forEach(t => t.classList.add('active'));
+    if (satContent) satContent.style.display = 'none';
+    if (agentsContent) agentsContent.style.display = '';
+    // Render agents into the content area
+    if (window.UplinkAgents && agentsContent) {
+      window.UplinkAgents.render(agentsContent);
+    }
+  }
+}
+
+function createNavigatorPanel() {
+  navigatorPanel = document.createElement('div');
+  navigatorPanel.className = 'satellite-navigator';
+  navigatorPanel.innerHTML = `
+    <div class="satellite-nav-header">
+      <div class="satellite-nav-tabs" role="tablist">
+        <button class="satellite-nav-tab active" data-nav-tab="satellites" role="tab" aria-selected="true">Sessions</button>
+        <button class="satellite-nav-tab" data-nav-tab="agents" role="tab" aria-selected="false">Agents</button>
+      </div>
+      <button class="satellite-nav-close" aria-label="Close panel"><svg width="14" height="14" viewBox="0 0 14 14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><line x1="1" y1="1" x2="13" y2="13"/><line x1="13" y1="1" x2="1" y2="13"/></svg></button>
+    </div>
+    <div class="satellite-nav-tabs-inline" role="tablist" style="display: none;">
+      <button class="satellite-nav-tab active" data-nav-tab="satellites" role="tab" aria-selected="true">Sessions</button>
+      <button class="satellite-nav-tab" data-nav-tab="agents" role="tab" aria-selected="false">Agents</button>
+    </div>
+    <div class="satellite-tab-content">
+      <div class="satellite-session-status" id="sessionStatus">
+        <span class="session-indicator" id="sessionIndicator">●</span>
+        <span class="session-key" id="sessionKeyDisplay" title="Click to copy"></span>
+      </div>
+      <div class="satellite-list" id="satelliteList" role="listbox" aria-label="Satellite list"></div>
+      <div class="satellite-nav-actions">
+        <button class="satellite-nav-btn" id="launchSatelliteBtn">+ Launch New</button>
+      </div>
+    </div>
+    <div class="agents-tab-content" style="display: none;"></div>
+  `;
+  
+  navigatorPanel.style.display = 'none';
+  document.body.appendChild(navigatorPanel);
+  
+  // Tab switching
+  navigatorPanel.querySelectorAll('.satellite-nav-tab').forEach(tab => {
+    tab.addEventListener('click', () => switchTab(tab.dataset.navTab));
+  });
+
+  // Event listeners
+  navigatorPanel.querySelector('.satellite-nav-close').addEventListener('click', function() {
+    // If split view is active (desktop), close via split view
+    if (window.UplinkSplitView && window.UplinkSplitView.isDesktop() && window.UplinkSplitView.getCurrentPanel() === 'satellites') {
+      window.UplinkSplitView.closePanel();
+      return;
+    }
+    var panels = getPanels();
+    if (panels) {
+      panels.close('satellites');
+    } else {
+      hideNavigator();
+    }
+  });
+  navigatorPanel.querySelector('#launchSatelliteBtn').addEventListener('click', () => {
+    promptForSatelliteName();
+  });
+  
+  // Bind to existing toggle button in header (or create one as fallback)
+  let toggleBtn = document.getElementById('satellitesBtn');
+  if (!toggleBtn) {
+    const header = document.querySelector('.header-right, .header-actions');
+    if (header) {
+      toggleBtn = document.createElement('button');
+      toggleBtn.id = 'satellitesBtn';
+      toggleBtn.className = 'header-btn satellite-toggle';
+      toggleBtn.innerHTML = '<svg width="18" height="18" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24"><circle cx="12" cy="12" r="3"/><circle cx="12" cy="12" r="8" stroke-dasharray="2 4"/><path d="M12 2v2m0 16v2M2 12h2m16 0h2"/></svg>';
+      toggleBtn.title = 'Satellites';
+      toggleBtn.setAttribute('aria-label', 'Satellites');
+      header.insertBefore(toggleBtn, header.firstChild);
+    }
+  }
+  // Bind click handler (splitview intercepts on desktop, this handles mobile)
+  if (toggleBtn) {
+    toggleBtn.addEventListener('click', toggleNavigator);
+  }
+  
+  // Register with panel manager for mutual exclusivity
+  registerWithPanelManager();
+  
+  updateNavigator();
+}
+
+function updateNavigator() {
+  const listEl = document.getElementById('satelliteList');
+  const currentNameEl = document.getElementById('currentSatelliteName');
+  
+  if (!listEl) return;
+  
+  // Update current satellite name
+  if (currentNameEl && satellites[currentSatellite]) {
+    currentNameEl.textContent = satellites[currentSatellite].name;
+  }
+  
+  // Build list view
+  const listHtml = buildSatelliteList();
+  listEl.innerHTML = listHtml;
+  
+  // Add event listeners to satellite items
+  const items = listEl.querySelectorAll('.satellite-item');
+  items.forEach(item => {
+    const satId = item.dataset.satelliteId;
+    
+    // Click anywhere on the item to connect (except action buttons)
+    item.addEventListener('click', (e) => {
+      if (!e.target.closest('.satellite-item-actions')) {
+        connectToSatellite(satId);
+      }
+    });
+    
+    // Keyboard navigation
+    item.addEventListener('keydown', (e) => {
+      const allItems = Array.from(items);
+      const currentIndex = allItems.indexOf(item);
+      
+      switch (e.key) {
+        case 'ArrowDown':
+          e.preventDefault();
+          if (currentIndex < allItems.length - 1) {
+            allItems[currentIndex + 1].focus();
+          }
+          break;
+        case 'ArrowUp':
+          e.preventDefault();
+          if (currentIndex > 0) {
+            allItems[currentIndex - 1].focus();
+          }
+          break;
+        case 'Enter':
+        case ' ':
+          e.preventDefault();
+          connectToSatellite(satId);
+          break;
+        case 'Delete':
+        case 'Backspace':
+          e.preventDefault();
+          if (satId !== PRIMARY_SATELLITE) {
+            deleteSatellite(satId);
+          }
+          break;
+        case 'F2':
+          e.preventDefault();
+          renameSatellite(satId);
+          break;
+        case 'Home':
+          e.preventDefault();
+          allItems[0]?.focus();
+          break;
+        case 'End':
+          e.preventDefault();
+          allItems[allItems.length - 1]?.focus();
+          break;
+      }
+    });
+    
+    item.querySelector('.satellite-item-rename')?.addEventListener('click', (e) => {
+      e.stopPropagation();
+      renameSatellite(satId);
+    });
+    
+    item.querySelector('.satellite-item-delete')?.addEventListener('click', (e) => {
+      console.log('[Satellites] Delete button clicked for:', satId);
+      e.stopPropagation();
+      e.preventDefault();
+      const satellite = satellites[satId];
+      const skipConfirm = satellite?._pendingDelete && (Date.now() - satellite._pendingDelete < 3000);
+      console.log('[Satellites] skipConfirm:', skipConfirm, 'pendingDelete:', satellite?._pendingDelete);
+      if (skipConfirm && satellite) delete satellite._pendingDelete;
+      deleteSatellite(satId, skipConfirm);
+      console.log('[Satellites] After deleteSatellite, panelVisible:', panelVisible);
+    });
+  });
+}
+
+function buildSatelliteList() {
+  // Sort satellites: primary first, then by most recently active
+  const sortedIds = Object.keys(satellites).sort((a, b) => {
+    if (a === PRIMARY_SATELLITE) return -1;
+    if (b === PRIMARY_SATELLITE) return 1;
+    return (satellites[b].createdAt || 0) - (satellites[a].createdAt || 0);
+  });
+  
+  return sortedIds.map(id => {
+    const satellite = satellites[id];
+    const isCurrent = id === currentSatellite;
+    const isPrimary = id === PRIMARY_SATELLITE;
+    const isDefault = id === defaultSatellite;
+    const msgCount = getMessageCountInSatellite(id);
+    const isPendingDelete = !!satellite._pendingDelete;
+    
+    const classes = ['panel-item', 'satellite-item'];
+    if (isCurrent) classes.push('active', 'current');
+    if (isPendingDelete) classes.push('pending-delete');
+    
+    // Icon: globe for primary, satellite for everything else
+    const icon = isPrimary ? '🌍' : '🛰️';
+    
+    return `
+      <div class="${classes.join(' ')}" 
+           data-satellite-id="${id}"
+           role="option"
+           aria-selected="${isCurrent}"
+           tabindex="${isCurrent ? '0' : '-1'}">
+        <span class="panel-item-icon satellite-item-icon" aria-hidden="true">${icon}</span>
+        <span class="panel-item-name satellite-item-name">${escapeHtml(satellite.name)}</span>
+        <div class="satellite-item-actions">
+          <button class="satellite-item-btn satellite-item-rename" title="Rename" aria-label="Rename ${escapeHtml(satellite.name)}">✏️</button>
+          ${!isPrimary ? `
+            <button class="satellite-item-btn satellite-item-delete" title="${isPendingDelete ? 'Confirm retire' : 'Retire'}" aria-label="${isPendingDelete ? 'Confirm retire' : 'Retire'} ${escapeHtml(satellite.name)}">${isPendingDelete ? '⚠️' : '🗑️'}</button>
+          ` : ''}
+        </div>
+      </div>
+    `;
+  }).join('');
+}
+
+function showNavigator() {
+  if (navigatorPanel) {
+    navigatorPanel.style.display = 'flex';
+    navigatorPanel.classList.add('visible');
+    panelVisible = true;
+    updateNavigator();
+  }
+}
+
+function hideNavigator() {
+  console.log('[Satellites] hideNavigator called');
+  console.trace('[Satellites] hideNavigator stack trace');
+  if (navigatorPanel) {
+    navigatorPanel.classList.remove('visible');
+    // Delay hiding display to allow transition to complete
+    setTimeout(() => {
+      if (!panelVisible) {
+        navigatorPanel.style.display = 'none';
+      }
+    }, 300);
+    panelVisible = false;
+  }
+}
+
+function toggleNavigator() {
+  console.log('[Satellites] toggleNavigator called');
+  console.trace('[Satellites] toggleNavigator stack trace');
+  const panels = getPanels();
+  if (panels) {
+    panelVisible = panels.toggle('satellites');
+    console.log('[Satellites] panels.toggle returned:', panelVisible);
+    if (panelVisible) updateNavigator();
+  } else {
+    if (panelVisible) {
+      hideNavigator();
+    } else {
+      showNavigator();
+    }
+  }
+}
+
+function registerWithPanelManager() {
+  const panels = getPanels();
+  if (panels && navigatorPanel) {
+    panels.register('satellites', {
+      element: navigatorPanel,
+      isOpen: () => panelVisible,
+      open: showNavigator,
+      close: hideNavigator
+    });
+  }
+}
+
+// ============================================
+// CHAT INTEGRATION
+// ============================================
+
+function reloadChatDisplay() {
+  console.log('[Satellites] reloadChatDisplay called');
+  const messagesEl = document.getElementById('messages');
+  const emptyStateEl = document.querySelector('.empty-state');
+  
+  if (!messagesEl) {
+    console.warn('[Satellites] messagesEl not found, retrying...');
+    setTimeout(reloadChatDisplay, 100);
+    return;
+  }
+  
+  // DON'T wipe if streaming is in progress - the streaming div would be destroyed
+  const streamingDiv = messagesEl.querySelector('.message.streaming');
+  const isProcessing = window.UplinkCore?.chatState === 'processing';
+  if (streamingDiv || isProcessing) {
+    return; // Don't wipe DOM during streaming
+  }
+  
+  // Clear current messages
+  messagesEl.innerHTML = '';
+  
+  // For main satellite, messages come from Gateway (set by fetchAndMergeGatewayHistory)
+  // For other satellites, use local storage
+  const messages = currentSatellite === 'main' 
+    ? (satellites[currentSatellite]?.messages || [])  // Gateway messages merged here
+    : getMessageHistory();
+  
+  console.log('[Satellites] Reloading display with', messages.length, 'messages for', currentSatellite);
+  
+  if (messages.length === 0) {
+    if (emptyStateEl) emptyStateEl.style.display = 'flex';
+  } else {
+    if (emptyStateEl) emptyStateEl.style.display = 'none';
+    
+    // Try to use the message API first
+    const msgApi = getMessageApi();
+    console.log('[Satellites] Message API:', msgApi ? 'available' : 'NOT available');
+    
+    messages.forEach(msg => {
+      if (msgApi && msgApi.addMessage) {
+        msgApi.addMessage(msg.text, msg.type, msg.imageUrl, false, msg.timestamp || null);
+      } else {
+        // Fallback: render directly to DOM if message API unavailable
+        renderMessageDirectly(messagesEl, msg);
+      }
+    });
+    
+    // Scroll to bottom after loading
+    messagesEl.scrollTop = messagesEl.scrollHeight;
+  }
+}
+
+/**
+ * Fallback renderer when message API is unavailable
+ */
+function renderMessageDirectly(container, msg) {
+  const div = document.createElement('div');
+  div.className = `message ${msg.type}`;
+  
+  if (msg.imageUrl) {
+    const img = document.createElement('img');
+    img.src = msg.imageUrl;
+    img.alt = msg.type === 'user' ? 'Image shared by you' : 'Image from assistant';
+    div.appendChild(img);
+  }
+  
+  if (msg.text) {
+    const textSpan = document.createElement('span');
+    textSpan.className = 'message-text';
+    // Basic formatting - the full formatMessage is in chat.js
+    textSpan.innerHTML = msg.text
+      .replace(/&/g, '&amp;')
+      .replace(/</g, '&lt;')
+      .replace(/>/g, '&gt;')
+      .replace(/\n/g, '<br>');
+    div.appendChild(textSpan);
+  }
+  
+  container.appendChild(div);
+}
+
+function injectMessageHooks(retryCount = 0) {
+  // Prevent multiple registration
+  if (messageHookInstalled) return;
+  
+  console.log('[Satellites] injectMessageHooks attempt', retryCount, '- UplinkChat:', !!window.UplinkChat, 'onMessage:', !!(window.UplinkChat && window.UplinkChat.onMessage));
+  
+  // If we have an injected messageApi, use that
+  if (deps.messageApi) {
+    messageHookInstalled = true;
+    console.log('[Satellites] Using injected message API');
+    return;
+  }
+  
+  // Use the proper UplinkChat.onMessage hook API
+  if (window.UplinkChat && window.UplinkChat.onMessage) {
+    // Register with the chat module's hook system
+    window.UplinkChat.onMessage(({ text, type, imageUrl, save }) => {
+      // Save to current satellite if this is a new message (not replay)
+      if (save && type !== 'system') {
+        addMessageToSatellite({ text, type, imageUrl });
+      }
+    });
+    
+    // Store reference to addMessage for reloadChatDisplay
+    window._originalAddMessage = window.UplinkChat.addMessage || window.addMessage;
+    
+    messageHookInstalled = true;
+    console.log('[Satellites] Message hook registered via UplinkChat.onMessage');
+  } else if (retryCount < 20) {
+    // Retry with exponential backoff
+    const delay = Math.min(100 * Math.pow(1.5, retryCount), 1000);
+    setTimeout(() => injectMessageHooks(retryCount + 1), delay);
+  } else {
+    console.warn('[Satellites] Could not register message hook after 20 retries - falling back to event listener');
+    // Fallback: listen for chat module ready event
+    window.addEventListener('uplink:ready', () => {
+      console.log('[Satellites] uplink:ready event received, retrying hook installation');
+      if (window.UplinkChat && !messageHookInstalled) {
+        injectMessageHooks(0);
+      }
+    }, { once: true });
+  }
+}
+
+// ============================================
+// NOTIFICATIONS
+// ============================================
+
+function showNotification(message, type = 'success') {
+  // Try to use injected or global notification system
+  const notifications = getNotifications();
+  if (notifications?.show) {
+    notifications.show(message, type);
+    return;
+  }
+  
+  // Fallback: create simple toast
+  const toast = document.createElement('div');
+  toast.className = `satellite-toast satellite-toast-${type}`;
+  toast.textContent = message;
+  // M-35: Announce satellite notifications to screen readers
+  toast.setAttribute('role', 'alert');
+  toast.setAttribute('aria-live', 'polite');
+  toast.style.cssText = `
+    position: fixed;
+    bottom: 80px;
+    left: 50%;
+    transform: translateX(-50%);
+    background: var(--bg-secondary, #333);
+    color: var(--text-primary, #fff);
+    padding: 12px 24px;
+    border-radius: 8px;
+    z-index: 10000;
+    animation: fadeInUp 0.3s ease;
+  `;
+  document.body.appendChild(toast);
+  
+  setTimeout(() => {
+    toast.style.animation = 'fadeOutDown 0.3s ease';
+    setTimeout(() => toast.remove(), 300);
+  }, 2000);
+}
+
+// ============================================
+// UTILITIES
+// ============================================
+
+function escapeHtml(text) {
+  const div = document.createElement('div');
+  div.textContent = text;
+  return div.innerHTML;
+}
+
+// ============================================
+// MIGRATION
+// ============================================
+
+async function migrateExistingHistory() {
+  // Only migrate if primary satellite is empty and there's existing history
+  if (satellites[PRIMARY_SATELLITE].messages.length > 0) return;
+  
+  // Check for old branches data
+  try {
+    const oldBranches = localStorage.getItem('uplink-branches');
+    if (oldBranches) {
+      const data = JSON.parse(oldBranches);
+      if (data.branches?.main?.messages?.length > 0) {
+        satellites[PRIMARY_SATELLITE].messages = data.branches.main.messages;
+        saveSatellites();
+        getLogger().debug('Satellites: Migrated', satellites[PRIMARY_SATELLITE].messages.length, 'messages from branches');
+        return;
+      }
+    }
+  } catch (e) {
+    getLogger().debug('Satellites: No branch data to migrate');
+  }
+  
+  // Try to migrate from storage module
+  try {
+    const storage = getStorage();
+    const existingHistory = await storage?.loadHistory();
+    if (existingHistory && existingHistory.length > 0) {
+      satellites[PRIMARY_SATELLITE].messages = existingHistory;
+      saveSatellites();
+      getLogger().debug('Satellites: Migrated', existingHistory.length, 'messages to primary satellite');
+    }
+  } catch (e) {
+    getLogger().error('Satellites: Migration failed', e);
+  }
+}
+
+// ============================================
+// PUBLIC API
+// ============================================
+
+export const UplinkSatellites = {
+  // Initialization with dependency injection
+  init,
+  
+  // Satellite operations
+  launchSatellite,
+  connectToSatellite,
+  deleteSatellite,
+  renameSatellite,
+  
+  // Getters
+  getCurrentSatellite: () => currentSatellite,
+  getCurrentId: () => currentSatellite,
+  getCurrentAgentId: () => (satellites[currentSatellite]?.agentId || 'main'),
+  getSatellites: () => ({ ...satellites }),
+  getMessageHistory,
+  
+  // UI
+  showNavigator,
+  hideNavigator,
+  toggleNavigator,
+  
+  // History refresh (fetches from Gateway for main satellite)
+  refreshHistory: loadHistoryOnConnect,
+  
+  // Update image URL in stored messages (data URL → server URL)
+  updateLastImageUrl: function(serverUrl) {
+    const sat = satellites[currentSatellite];
+    if (!sat || !sat.messages) return;
+    
+    for (let i = sat.messages.length - 1; i >= 0; i--) {
+      const url = sat.messages[i].imageUrl;
+      if (url && (url === '__pending_upload__' || url.startsWith('data:'))) {
+        sat.messages[i].imageUrl = serverUrl;
+        saveSatellites();
+        break;
+      }
+    }
+  }
+};
+
+import { UplinkCore } from './core.js';
+
+// Backward compat: assign to window
+window.UplinkSatellites = UplinkSatellites;
+
+// Helper for init retry with exponential backoff
+function scheduleInitRetry() {
+  if (initRetryCount >= MAX_INIT_RETRIES) {
+    getLogger().warn('Satellites: Max init retries reached, giving up');
+    return;
+  }
+  initRetryCount++;
+  const delay = Math.min(100 * Math.pow(2, initRetryCount), 5000);
+  setTimeout(() => init(), delay);
+}
+
+// Cleanup function for timers
+function cleanup() {
+  // Clear connection poll interval
+  if (connectionPollInterval) {
+    clearInterval(connectionPollInterval);
+    connectionPollInterval = null;
+  }
+  // Clear all pending delete timers
+  pendingDeleteTimers.forEach((timerId) => clearTimeout(timerId));
+  pendingDeleteTimers.clear();
+}
+
+// Cleanup on page unload
+window.addEventListener('beforeunload', cleanup);
+
+// Register with core for coordinated initialization
+UplinkCore.registerModule('satellites', init);