@agentprojectcontext/apx 1.81.0 → 1.89.1

package/src/interfaces/android/app/src/main/java/dev/agentprojectcontext/apx/MascotBlobCatalog.java

@@ -0,0 +1,66 @@
+// AUTO-GENERATED by scripts/export_android_mascot_assets.py — do not edit by hand.
+package dev.agentprojectcontext.apx;
+
+import android.graphics.Color;
+
+final class MascotBlobCatalog {
+    static final String DEFAULT_KEY = "noche";
+
+    static final class Preset {
+        final String key;
+        final int drawable;
+        final int eyeColor;
+        final float[][] eyes;
+
+        Preset(String key, int drawable, int eyeColor, float[][] eyes) {
+            this.key = key;
+            this.drawable = drawable;
+            this.eyeColor = eyeColor;
+            this.eyes = eyes;
+        }
+    }
+
+    static Preset forKey(String value) {
+        String key = value == null ? DEFAULT_KEY : value.trim();
+        return switch (key) {
+            case "menta" -> new Preset("menta", R.drawable.mascot_menta, Color.parseColor("#15181C"), new float[][]{new float[]{121.9f, 93.1f, 16.0f, 33.8f, 6.4f}, new float[]{151.9f, 93.1f, 16.0f, 33.8f, 6.4f}});
+            case "parche" -> new Preset("parche", R.drawable.mascot_parche, Color.parseColor("#15181C"), new float[][]{new float[]{133.6f, 88.6f, 17.3f, 33.8f, 6.9f}, new float[]{166.1f, 88.6f, 17.3f, 33.8f, 6.9f}});
+            case "trino" -> new Preset("trino", R.drawable.mascot_trino, Color.parseColor("#15181C"), new float[][]{new float[]{105.5f, 130.1f, 18.0f, 29.7f, 7.2f}, new float[]{141.5f, 130.1f, 18.0f, 29.7f, 7.2f}});
+            case "cubi" -> new Preset("cubi", R.drawable.mascot_cubi, Color.parseColor("#15181C"), new float[][]{new float[]{103.2f, 93.1f, 17.2f, 33.8f, 6.9f}, new float[]{135.6f, 93.1f, 17.2f, 33.8f, 6.9f}});
+            case "nimbo" -> new Preset("nimbo", R.drawable.mascot_nimbo, Color.parseColor("#15181C"), new float[][]{new float[]{103.3f, 93.1f, 17.1f, 33.8f, 6.9f}, new float[]{135.6f, 93.1f, 17.1f, 33.8f, 6.9f}});
+            case "papa" -> new Preset("papa", R.drawable.mascot_papa, Color.parseColor("#15181C"), new float[][]{new float[]{125.5f, 90.9f, 18.5f, 30.5f, 7.4f}, new float[]{161.6f, 90.9f, 18.5f, 30.5f, 7.4f}});
+            case "noche" -> new Preset("noche", R.drawable.mascot_noche, Color.parseColor("#3AE7B0"), new float[][]{new float[]{123.8f, 133.6f, 15.9f, 33.8f, 6.4f}, new float[]{157.6f, 133.6f, 15.9f, 33.8f, 6.4f}});
+            case "kiwi" -> new Preset("kiwi", R.drawable.mascot_kiwi, Color.parseColor("#15181C"), new float[][]{new float[]{123.0f, 84.1f, 13.1f, 29.3f, 5.2f}, new float[]{147.7f, 84.1f, 13.1f, 29.3f, 5.2f}});
+            case "gajo" -> new Preset("gajo", R.drawable.mascot_gajo, Color.parseColor("#15181C"), new float[][]{new float[]{107.9f, 95.3f, 16.6f, 29.3f, 6.7f}, new float[]{139.3f, 95.3f, 16.6f, 29.3f, 6.7f}});
+            case "campana" -> new Preset("campana", R.drawable.mascot_campana, Color.parseColor("#15181C"), new float[][]{new float[]{108.6f, 86.3f, 15.8f, 29.3f, 6.3f}, new float[]{135.5f, 86.3f, 15.8f, 29.3f, 6.3f}});
+            case "cobalto" -> new Preset("cobalto", R.drawable.mascot_cobalto, Color.parseColor("#15181C"), new float[][]{new float[]{125.5f, 95.3f, 16.8f, 29.3f, 6.7f}, new float[]{157.2f, 95.3f, 16.8f, 29.3f, 6.7f}});
+            case "rubi" -> new Preset("rubi", R.drawable.mascot_rubi, Color.parseColor("#15181C"), new float[][]{new float[]{123.0f, 84.1f, 13.1f, 29.3f, 5.2f}, new float[]{147.7f, 84.1f, 13.1f, 29.3f, 5.2f}});
+            case "trebol" -> new Preset("trebol", R.drawable.mascot_trebol, Color.parseColor("#15181C"), new float[][]{new float[]{123.6f, 120.1f, 17.2f, 29.3f, 6.9f}, new float[]{155.1f, 120.1f, 17.2f, 29.3f, 6.9f}});
+            case "saturno" -> new Preset("saturno", R.drawable.mascot_saturno, Color.parseColor("#15181C"), new float[][]{});
+            case "onyx" -> new Preset("onyx", R.drawable.mascot_onyx, Color.parseColor("#3AE7B0"), new float[][]{new float[]{119.7f, 124.6f, 16.6f, 29.3f, 6.6f}, new float[]{152.9f, 124.6f, 16.6f, 29.3f, 6.6f}});
+            case "perla" -> new Preset("perla", R.drawable.mascot_perla, Color.parseColor("#15181C"), new float[][]{new float[]{121.4f, 108.4f, 13.5f, 21.4f, 5.4f}, new float[]{148.5f, 108.4f, 13.5f, 21.4f, 5.4f}});
+            case "faro" -> new Preset("faro", R.drawable.mascot_faro, Color.parseColor("#15181C"), new float[][]{new float[]{94.4f, 100.0f, 14.2f, 20.3f, 5.7f}, new float[]{122.7f, 100.0f, 14.2f, 20.3f, 5.7f}});
+            case "brasa" -> new Preset("brasa", R.drawable.mascot_brasa, Color.parseColor("#15181C"), new float[][]{new float[]{94.8f, 95.2f, 16.9f, 18.6f, 6.8f}, new float[]{126.3f, 95.2f, 16.9f, 18.6f, 6.8f}});
+            case "aqua" -> new Preset("aqua", R.drawable.mascot_aqua, Color.parseColor("#15181C"), new float[][]{new float[]{92.9f, 105.8f, 10.9f, 20.3f, 4.4f}, new float[]{114.7f, 105.8f, 10.9f, 20.3f, 4.4f}});
+            case "coral" -> new Preset("coral", R.drawable.mascot_coral, Color.parseColor("#15181C"), new float[][]{new float[]{99.4f, 147.0f, 14.5f, 19.1f, 5.8f}, new float[]{129.3f, 147.0f, 14.5f, 19.1f, 5.8f}});
+            case "zafiro" -> new Preset("zafiro", R.drawable.mascot_zafiro, Color.parseColor("#15181C"), new float[][]{new float[]{105.7f, 116.5f, 14.3f, 21.4f, 5.7f}, new float[]{132.4f, 116.5f, 14.3f, 21.4f, 5.7f}});
+            case "pino" -> new Preset("pino", R.drawable.mascot_pino, Color.parseColor("#15181C"), new float[][]{new float[]{125.0f, 123.2f, 13.4f, 20.3f, 5.4f}, new float[]{151.9f, 123.2f, 13.4f, 20.3f, 5.4f}});
+            case "eclipse" -> new Preset("eclipse", R.drawable.mascot_eclipse, Color.parseColor("#060709"), new float[][]{new float[]{102.8f, 111.9f, 15.5f, 20.3f, 6.2f}, new float[]{131.5f, 111.9f, 15.5f, 20.3f, 6.2f}});
+            case "peon" -> new Preset("peon", R.drawable.mascot_peon, Color.parseColor("#15181C"), new float[][]{new float[]{109.1f, 85.6f, 10.2f, 18.0f, 4.1f}, new float[]{132.9f, 85.6f, 10.2f, 18.0f, 4.1f}});
+            case "ovni" -> new Preset("ovni", R.drawable.mascot_ovni, Color.parseColor("#15181C"), new float[][]{new float[]{106.6f, 105.0f, 15.8f, 16.0f, 6.3f}, new float[]{138.1f, 105.0f, 15.8f, 16.0f, 6.3f}});
+            case "amatista" -> new Preset("amatista", R.drawable.mascot_amatista, Color.parseColor("#15181C"), new float[][]{new float[]{85.8f, 103.4f, 16.9f, 18.3f, 6.8f}, new float[]{117.3f, 103.4f, 16.9f, 18.3f, 6.8f}});
+            case "volcan" -> new Preset("volcan", R.drawable.mascot_volcan, Color.parseColor("#15181C"), new float[][]{new float[]{100.6f, 97.4f, 13.4f, 19.1f, 5.4f}, new float[]{127.5f, 97.4f, 13.4f, 19.1f, 5.4f}});
+            case "quad" -> new Preset("quad", R.drawable.mascot_quad, Color.parseColor("#15181C"), new float[][]{new float[]{80.9f, 68.2f, 17.6f, 21.8f, 7.0f}, new float[]{148.5f, 68.2f, 17.6f, 21.8f, 7.0f}});
+            case "cometa" -> new Preset("cometa", R.drawable.mascot_cometa, Color.parseColor("#15181C"), new float[][]{new float[]{107.5f, 94.8f, 15.7f, 21.4f, 6.3f}, new float[]{136.9f, 94.8f, 15.7f, 21.4f, 6.3f}});
+            case "lila" -> new Preset("lila", R.drawable.mascot_lila, Color.parseColor("#15181C"), new float[][]{new float[]{104.8f, 104.3f, 14.1f, 20.3f, 5.6f}, new float[]{133.0f, 104.3f, 14.1f, 20.3f, 5.6f}});
+            case "orbita" -> new Preset("orbita", R.drawable.mascot_orbita, Color.parseColor("#060709"), new float[][]{new float[]{104.3f, 96.7f, 15.8f, 18.7f, 6.3f}, new float[]{135.9f, 96.7f, 15.8f, 18.7f, 6.3f}});
+            case "caracol" -> new Preset("caracol", R.drawable.mascot_caracol, Color.parseColor("#15181C"), new float[][]{new float[]{149.9f, 109.4f, 14.6f, 17.1f, 5.9f}, new float[]{181.4f, 109.4f, 14.6f, 17.1f, 5.9f}});
+            case "iris" -> new Preset("iris", R.drawable.mascot_iris, Color.parseColor("#15181C"), new float[][]{new float[]{97.7f, 106.6f, 13.7f, 20.3f, 5.5f}, new float[]{125.1f, 106.6f, 13.7f, 20.3f, 5.5f}});
+            case "laguna" -> new Preset("laguna", R.drawable.mascot_laguna, Color.parseColor("#15181C"), new float[][]{new float[]{106.6f, 83.8f, 15.8f, 18.5f, 6.3f}, new float[]{138.1f, 83.8f, 15.8f, 18.5f, 6.3f}});
+            case "carbon" -> new Preset("carbon", R.drawable.mascot_carbon, Color.parseColor("#060709"), new float[][]{new float[]{93.7f, 99.3f, 16.3f, 21.4f, 6.5f}, new float[]{124.2f, 99.3f, 16.3f, 21.4f, 6.5f}});
+            default -> forKey(DEFAULT_KEY);
+        };
+    }
+
+    private MascotBlobCatalog() {}
+}

package/src/interfaces/android/app/src/main/java/dev/agentprojectcontext/apx/MascotOverlayService.java

@@ -0,0 +1,448 @@
+package dev.agentprojectcontext.apx;
+
+import android.app.Notification;
+import android.app.NotificationChannel;
+import android.app.NotificationManager;
+import android.app.PendingIntent;
+import android.app.Service;
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.content.IntentFilter;
+import android.content.res.AssetFileDescriptor;
+import android.graphics.PixelFormat;
+import android.media.AudioAttributes;
+import android.media.MediaPlayer;
+import android.net.ConnectivityManager;
+import android.net.Network;
+import android.os.Build;
+import android.os.Handler;
+import android.os.IBinder;
+import android.os.Looper;
+import android.provider.Settings;
+import android.view.Gravity;
+import android.view.WindowManager;
+
+import okhttp3.Request;
+import okhttp3.Response;
+import okhttp3.WebSocket;
+import okhttp3.WebSocketListener;
+
+public final class MascotOverlayService extends Service {
+    static final String ACTION_STOP = "dev.agentprojectcontext.apx.STOP_MASCOT";
+    static final String ACTION_SHOW = "dev.agentprojectcontext.apx.SHOW_MASCOT";
+    static final String ACTION_APP_FOREGROUND = "dev.agentprojectcontext.apx.APP_FOREGROUND";
+    static final String ACTION_APP_BACKGROUND = "dev.agentprojectcontext.apx.APP_BACKGROUND";
+    static final String ACTION_TEST_MESSAGE = "dev.agentprojectcontext.apx.TEST_MESSAGE";
+    static final String EXTRA_TEST_MESSAGE = "test_message";
+    private static final String SERVICE_CHANNEL = "apx_mascot";
+    private static final int SERVICE_NOTIFICATION = 7001;
+
+    // Two reconnect ladders, because the socket is worth two different amounts
+    // of battery. On a drive it is the only path a proximity card has, so a
+    // drop is repaired in seconds. Parked — which is most of the day — the
+    // daemon is often simply not addressable from where the phone is, and
+    // redialling it every 15 seconds for eight hours is a couple of thousand
+    // radio wakeups that cannot succeed. That is what the battery screen was
+    // reporting, and it is the whole reason this app looked expensive.
+    private static final long TRIP_MAX_BACKOFF_MS = 15_000L;
+    private static final long IDLE_MAX_BACKOFF_MS = 5 * 60_000L;
+
+    private final Handler main = new Handler(Looper.getMainLooper());
+    private WindowManager windowManager;
+    private WindowManager.LayoutParams params;
+    private MascotView mascotView;
+    private android.widget.TextView dismissTarget;
+    private boolean overDismissTarget;
+    private ApxPreferences preferences;
+    private WebSocket socket;
+    private boolean destroyed;
+    private boolean foregroundStarted;
+    private boolean appForeground;
+    private int reconnectAttempts;
+    private ConnectivityManager connectivity;
+    private final Runnable reconnect = this::connect;
+    private final ConnectivityManager.NetworkCallback networkCallback = new ConnectivityManager.NetworkCallback() {
+        @Override public void onAvailable(Network network) {
+            // A network arriving is better news than any timer: dial now and
+            // drop the ladder, instead of waiting out a backoff that was
+            // scheduled while the phone had no way to reach anything.
+            main.post(() -> {
+                main.removeCallbacks(reconnect);
+                reconnectAttempts = 0;
+                if (socket == null) connect();
+            });
+        }
+
+        @Override public void onLost(Network network) {
+            // Nothing left to dial. Stop the ladder and wait to be told there
+            // is a network again — onAvailable is what restarts it.
+            main.post(() -> {
+                if (!networkUp()) main.removeCallbacks(reconnect);
+            });
+        }
+    };
+    private final BroadcastReceiver travelReceiver = new BroadcastReceiver() {
+        @Override public void onReceive(Context context, Intent intent) {
+            if (!preferences.travelActive()) return;
+            // Traveller mode just opened. Whatever idle backoff was pending,
+            // the socket carries proximity cards now — connect straight away.
+            main.removeCallbacks(reconnect);
+            reconnectAttempts = 0;
+            if (socket == null) connect();
+        }
+    };
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        preferences = new ApxPreferences(this);
+        createChannels();
+        connectivity = (ConnectivityManager) getSystemService(CONNECTIVITY_SERVICE);
+        try {
+            connectivity.registerDefaultNetworkCallback(networkCallback);
+        } catch (RuntimeException unavailable) {
+            // Without the callback the ladder is the only way back; it still
+            // works, it just cannot wake early.
+            android.util.Log.w("APX", "No connectivity callback: " + unavailable.getMessage());
+        }
+        IntentFilter travel = new IntentFilter(MapsNavigationListenerService.ACTION_TRAVEL_STATE_CHANGED);
+        if (Build.VERSION.SDK_INT >= 33) registerReceiver(travelReceiver, travel, RECEIVER_NOT_EXPORTED);
+        else registerReceiver(travelReceiver, travel);
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        if (intent != null && ACTION_STOP.equals(intent.getAction())) {
+            preferences.setMascotEnabled(false);
+            removeOverlay();
+        }
+        if (intent != null && ACTION_SHOW.equals(intent.getAction())) {
+            preferences.setMascotEnabled(true);
+        }
+        if (intent != null && ACTION_APP_FOREGROUND.equals(intent.getAction())) appForeground = true;
+        if (intent != null && ACTION_APP_BACKGROUND.equals(intent.getAction())) appForeground = false;
+        if (!foregroundStarted) {
+            startForeground(SERVICE_NOTIFICATION, serviceNotification());
+            foregroundStarted = true;
+        }
+        if (!preferences.paired()) {
+            stopSelf();
+            return START_NOT_STICKY;
+        }
+        if (appForeground || !preferences.mascotEnabled() || !Settings.canDrawOverlays(this)) {
+            removeOverlay();
+        } else if (mascotView == null) {
+            addOverlay();
+        }
+        if (foregroundStarted) {
+            ((NotificationManager) getSystemService(NOTIFICATION_SERVICE))
+                .notify(SERVICE_NOTIFICATION, serviceNotification());
+        }
+        if (socket == null) connect();
+        if (intent != null && ACTION_TEST_MESSAGE.equals(intent.getAction())) {
+            String message = intent.getStringExtra(EXTRA_TEST_MESSAGE);
+            main.post(() -> presentMessage(message == null || message.isBlank()
+                ? "Prueba APX: aviso directo en Android Auto."
+                : message));
+        }
+        return START_STICKY;
+    }
+
+    private void addOverlay() {
+        windowManager = (WindowManager) getSystemService(WINDOW_SERVICE);
+        int width = dp(210);
+        int height = dp(225);
+        android.util.DisplayMetrics metrics = getResources().getDisplayMetrics();
+        int fallbackX = Math.max(0, metrics.widthPixels - width - dp(10));
+        int fallbackY = Math.max(0, metrics.heightPixels - height - dp(60));
+        params = new WindowManager.LayoutParams(
+            width,
+            height,
+            Build.VERSION.SDK_INT >= 26 ? WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY : WindowManager.LayoutParams.TYPE_PHONE,
+            WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE |
+                WindowManager.LayoutParams.FLAG_NOT_TOUCH_MODAL |
+                WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS,
+            PixelFormat.TRANSLUCENT
+        );
+        params.gravity = Gravity.TOP | Gravity.START;
+        params.x = preferences.mascotX(fallbackX);
+        params.y = preferences.mascotY(fallbackY);
+
+        mascotView = new MascotView(this, preferences.mascotAvatar(), new MascotView.Listener() {
+            @Override public void onDragStarted() {
+                showDismissTarget();
+            }
+
+            @Override public void onMove(float rawX, float rawY, float offsetX, float offsetY) {
+                params.x = Math.round(rawX - offsetX);
+                params.y = Math.round(rawY - offsetY);
+                try { windowManager.updateViewLayout(mascotView, params); } catch (RuntimeException ignored) {}
+                updateDismissTarget(rawX, rawY);
+            }
+
+            @Override public void onDragEnded(boolean cancelled) {
+                boolean dismiss = !cancelled && overDismissTarget;
+                hideDismissTarget();
+                if (dismiss) {
+                    preferences.setMascotEnabled(false);
+                    removeOverlay();
+                    ((NotificationManager) getSystemService(NOTIFICATION_SERVICE))
+                        .notify(SERVICE_NOTIFICATION, serviceNotification());
+                } else {
+                    preferences.saveMascotPosition(params.x, params.y);
+                }
+            }
+
+            @Override public void onTapped() {
+                openMobile();
+            }
+        });
+        windowManager.addView(mascotView, params);
+    }
+
+    private void showDismissTarget() {
+        if (dismissTarget != null || windowManager == null) return;
+        dismissTarget = new android.widget.TextView(this);
+        dismissTarget.setText("×");
+        dismissTarget.setTextSize(34);
+        dismissTarget.setTextColor(android.graphics.Color.WHITE);
+        dismissTarget.setGravity(Gravity.CENTER);
+        dismissTarget.setTypeface(null, android.graphics.Typeface.BOLD);
+        setDismissTargetActive(false);
+
+        WindowManager.LayoutParams dismissParams = new WindowManager.LayoutParams(
+            dp(76),
+            dp(76),
+            Build.VERSION.SDK_INT >= 26 ? WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY : WindowManager.LayoutParams.TYPE_PHONE,
+            WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE |
+                WindowManager.LayoutParams.FLAG_NOT_TOUCHABLE |
+                WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS,
+            PixelFormat.TRANSLUCENT
+        );
+        dismissParams.gravity = Gravity.BOTTOM | Gravity.CENTER_HORIZONTAL;
+        dismissParams.y = dp(28);
+        try { windowManager.addView(dismissTarget, dismissParams); } catch (RuntimeException ignored) {
+            dismissTarget = null;
+        }
+    }
+
+    private void updateDismissTarget(float rawX, float rawY) {
+        if (dismissTarget == null) return;
+        android.util.DisplayMetrics metrics = getResources().getDisplayMetrics();
+        float targetX = metrics.widthPixels / 2f;
+        float targetY = metrics.heightPixels - dp(66);
+        boolean active = Math.hypot(rawX - targetX, rawY - targetY) <= dp(92);
+        if (active == overDismissTarget) return;
+        overDismissTarget = active;
+        setDismissTargetActive(active);
+        dismissTarget.animate().scaleX(active ? 1.18f : 1f).scaleY(active ? 1.18f : 1f).setDuration(120).start();
+    }
+
+    private void setDismissTargetActive(boolean active) {
+        if (dismissTarget == null) return;
+        android.graphics.drawable.GradientDrawable background = new android.graphics.drawable.GradientDrawable();
+        background.setShape(android.graphics.drawable.GradientDrawable.OVAL);
+        background.setColor(active
+            ? android.graphics.Color.rgb(224, 64, 64)
+            : android.graphics.Color.argb(205, 74, 79, 78));
+        dismissTarget.setBackground(background);
+    }
+
+    private void hideDismissTarget() {
+        overDismissTarget = false;
+        if (dismissTarget == null || windowManager == null) return;
+        try { windowManager.removeView(dismissTarget); } catch (RuntimeException ignored) {}
+        dismissTarget = null;
+    }
+
+    private void connect() {
+        if (destroyed || !preferences.paired()) return;
+        Request request = new Request.Builder()
+            .url(DaemonAddress.webSocketUrl(preferences.daemonUrl(), preferences.token()))
+            .build();
+        socket = DaemonClient.HTTP.newWebSocket(request, new WebSocketListener() {
+            @Override public void onOpen(WebSocket webSocket, Response response) {
+                reconnectAttempts = 0;
+            }
+
+            @Override public void onMessage(WebSocket webSocket, String text) {
+                handleFrame(text);
+            }
+
+            @Override public void onClosed(WebSocket webSocket, int code, String reason) {
+                clearAndReconnect(webSocket);
+            }
+
+            @Override public void onFailure(WebSocket webSocket, Throwable error, Response response) {
+                clearAndReconnect(webSocket);
+            }
+        });
+    }
+
+    private void clearAndReconnect(WebSocket failed) {
+        if (socket == failed) socket = null;
+        if (destroyed) return;
+        if (!networkUp()) {
+            // Airplane mode, no signal, Wi-Fi off. Retrying would burn the
+            // radio to reach a daemon that is not addressable from here; the
+            // connectivity callback wakes us when that changes.
+            main.removeCallbacks(reconnect);
+            return;
+        }
+        long ceiling = preferences.travelActive() ? TRIP_MAX_BACKOFF_MS : IDLE_MAX_BACKOFF_MS;
+        long delay = Math.min(ceiling, 1_000L << Math.min(reconnectAttempts++, 8));
+        main.removeCallbacks(reconnect);
+        main.postDelayed(reconnect, delay);
+    }
+
+    /**
+     * Is there any network at all? Deliberately not a check for internet
+     * capability — the daemon usually lives on the LAN or a tailnet, and a
+     * Wi-Fi that Android has decided has no internet still reaches it.
+     */
+    private boolean networkUp() {
+        if (connectivity == null) return true;
+        try {
+            return connectivity.getActiveNetwork() != null;
+        } catch (RuntimeException unknown) {
+            return true;
+        }
+    }
+
+    private void handleFrame(String text) {
+        String avatar = MessageFrameParser.avatar(text);
+        if (avatar != null) {
+            preferences.setMascotAvatar(avatar);
+            main.post(() -> {
+                if (mascotView != null) mascotView.setAvatar(avatar);
+            });
+        }
+        // A proximity alert is its own frame and its own card — four buttons,
+        // not a bubble. It is gated on the same "mobility" channel the owner
+        // can mute, because it interrupts exactly like the rest.
+        MessageFrameParser.MobilityAlert alert = MessageFrameParser.mobilityAlert(text);
+        if (alert != null) {
+            if (preferences.notifyChannelEnabled("mobility")) {
+                // The head unit reads from the store; the phone gets a card.
+                // Both, always: the driver may be looking at either one.
+                CarAlertStore.put(alert);
+                main.post(() -> {
+                    ProximityNotification.show(this, alert);
+                    if (mascotView != null) mascotView.showMessage(alert.body());
+                    if (preferences.soundEnabled()) playNotificationSound();
+                });
+            }
+            return;
+        }
+
+        for (MessageFrameParser.Notice notice : MessageFrameParser.notices(text)) {
+            // One gate for the bubble, the sound and the car card: a channel
+            // the owner muted must not reach him by any of the three. He can
+            // still read every one of them in /mobile — this decides what
+            // INTERRUPTS, not what exists.
+            if (!preferences.notifyChannelEnabled(notice.channel())) continue;
+            main.post(() -> presentMessage(notice.text()));
+        }
+    }
+
+    private void presentMessage(String message) {
+        if (mascotView != null) mascotView.showMessage(message);
+        if (preferences.soundEnabled()) playNotificationSound();
+        CarMessageNotification.show(this, message);
+    }
+
+    private void playNotificationSound() {
+        MediaPlayer player = new MediaPlayer();
+        player.setAudioAttributes(new AudioAttributes.Builder()
+            .setUsage(AudioAttributes.USAGE_MEDIA)
+            .setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
+            .build());
+        try (AssetFileDescriptor audio = getResources().openRawResourceFd(R.raw.apx_notification)) {
+            player.setDataSource(audio.getFileDescriptor(), audio.getStartOffset(), audio.getLength());
+            player.setOnCompletionListener(MediaPlayer::release);
+            player.setOnErrorListener((failed, what, extra) -> {
+                failed.release();
+                return true;
+            });
+            player.prepare();
+            player.start();
+            android.util.Log.i("APX", "Message sound started");
+        } catch (Exception error) {
+            player.release();
+            android.util.Log.w("APX", "Could not play message sound", error);
+        }
+    }
+
+    private void removeOverlay() {
+        hideDismissTarget();
+        if (mascotView == null || windowManager == null) return;
+        try { windowManager.removeView(mascotView); } catch (RuntimeException ignored) {}
+        mascotView = null;
+    }
+
+    private void createChannels() {
+        NotificationManager manager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
+        NotificationChannel service = new NotificationChannel(SERVICE_CHANNEL, getString(R.string.mascot_channel), NotificationManager.IMPORTANCE_LOW);
+        service.setDescription("Mantiene mascota APX y conexión local activas.");
+        manager.createNotificationChannel(service);
+        NotificationChannel messages = new NotificationChannel(CarMessageNotification.CHANNEL, getString(R.string.messages_channel), NotificationManager.IMPORTANCE_HIGH);
+        messages.setDescription("Mensajes nuevos recibidos por APX.");
+        messages.setSound(null, null);
+        manager.createNotificationChannel(messages);
+    }
+
+    private Notification serviceNotification() {
+        Intent open = new Intent(this, MainActivity.class).putExtra(MainActivity.EXTRA_PATH, "/mobile");
+        boolean mascotVisible = preferences.mascotEnabled();
+        Intent mascotAction = new Intent(this, MascotOverlayService.class)
+            .setAction(mascotVisible ? ACTION_STOP : ACTION_SHOW);
+        return new Notification.Builder(this, SERVICE_CHANNEL)
+            .setSmallIcon(R.drawable.ic_apx_notification)
+            .setContentTitle("APX conectado")
+            .setContentText("Mensajes directos y avisos activos")
+            .setContentIntent(pendingActivity(open, 1))
+            .addAction(new Notification.Action.Builder(
+                null,
+                mascotVisible ? "Ocultar mascota" : "Mostrar mascota",
+                pendingService(mascotAction, mascotVisible ? 2 : 3)
+            ).build())
+            .setOngoing(true)
+            .build();
+    }
+
+    private PendingIntent pendingActivity(Intent intent, int requestCode) {
+        return PendingIntent.getActivity(this, requestCode, intent, PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE);
+    }
+
+    private PendingIntent pendingService(Intent intent, int requestCode) {
+        return PendingIntent.getService(this, requestCode, intent, PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE);
+    }
+
+    private void openMobile() {
+        Intent intent = new Intent(this, MainActivity.class)
+            .putExtra(MainActivity.EXTRA_PATH, "/mobile")
+            .addFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_SINGLE_TOP);
+        startActivity(intent);
+    }
+
+    @Override
+    public void onDestroy() {
+        destroyed = true;
+        main.removeCallbacksAndMessages(null);
+        try { connectivity.unregisterNetworkCallback(networkCallback); } catch (RuntimeException ignored) {}
+        try { unregisterReceiver(travelReceiver); } catch (RuntimeException ignored) {}
+        if (socket != null) {
+            socket.close(1000, "service stopped");
+            socket = null;
+        }
+        removeOverlay();
+        super.onDestroy();
+    }
+
+    @Override public IBinder onBind(Intent intent) { return null; }
+
+    private int dp(int value) {
+        return Math.round(value * getResources().getDisplayMetrics().density);
+    }
+}