@agentdeck/shared 1.0.22 → 1.0.23

package/dist/esp32-boards.d.ts

@@ -0,0 +1,213 @@
+/**
+ * ESP32 board SSOT — the machine-readable half of the board table.
+ *
+ * WHY THIS FILE EXISTS. The same board set was written out by hand in four
+ * places and only one edge had a gate:
+ *
+ *   docs/hardware-compatibility.md   (spec sheet — gated into docs/hardware/index.html)
+ *   .github/workflows/esp32-release.yml  (build matrix — enforced by a COMMENT only)
+ *   bridge/src/cli.ts                (ESP32_OTA_BOARDS)
+ *   docs/esp32.md                    (alias table)
+ *
+ * A board missing from the release matrix ships no firmware and nothing fails —
+ * which is exactly how `t_embed`, `t_display_pro` and `esp32_c6_147` had no
+ * binaries at all in 1.0.1. This file is where those literals stop being
+ * literals; `scripts/generate-esp32-board-matrix.mjs` emits the derived copies
+ * and cross-checks the rest.
+ *
+ * DIVISION OF LABOUR with docs/hardware-compatibility.md: that file stays the
+ * SSOT for the human columns (display, controller, input, peripherals, status)
+ * and this one owns the machine fields. Two SSOTs over DISJOINT column sets,
+ * bound by a gate — not a second copy. Drop the cross-check and this file makes
+ * the duplication worse, not better.
+ */
+export type Esp32ChipFamily = 'ESP32' | 'ESP32-S3' | 'ESP32-P4' | 'ESP32-C6';
+export type Esp32FlashSize = '4MB' | '8MB' | '16MB';
+/** esptool `--before` values (esptool-js calls this the reset `mode`). */
+export type Esp32ResetBefore = 'default_reset' | 'usb_reset' | 'no_reset' | 'no_reset_no_sync';
+/** esptool `--after` values. */
+export type Esp32ResetAfter = 'hard_reset' | 'soft_reset' | 'no_reset' | 'no_reset_stub';
+/**
+ * Whether the browser flasher may offer this board.
+ * - `verified`          a hardware run connected and both guards agreed
+ * - `verified-partial`  connected, but something is degraded (see the evidence)
+ * - `unverified`        never measured — listed, disabled, with the reason shown
+ * - `blocked`           measured and it cannot work here
+ */
+export type Esp32WebFlashStatus = 'verified' | 'verified-partial' | 'unverified' | 'blocked';
+export interface Esp32BoardSpec {
+    /** canonical `device_info.board` — the string every AgentDeck surface addresses */
+    id: string;
+    /** PlatformIO environment. A DIFFERENT namespace from `id`, deliberately. */
+    env: string;
+    name: string;
+    /** panel summary, mirrored into the release notes table */
+    display: string;
+    /**
+     * Extra CLI spellings accepted for `agentdeck esp32-ota <target>`. This list
+     * is the CLI's existing set VERBATIM — adding a spelling here changes what
+     * the command accepts, so it is a behaviour change, not bookkeeping.
+     * `esp32/scripts/flash.sh` keeps its own friendlier names (`tft_114`,
+     * `amoled_18`, …) for the local build path; those are deliberately NOT
+     * merged in, because they were never valid daemon targets.
+     */
+    aliases: string[];
+    chipFamily: Esp32ChipFamily;
+    flashSize: Esp32FlashSize;
+    flashMode: 'dio';
+    flashFreq: '40m' | '80m';
+    /**
+     * Where the bootloader sits INSIDE the merged image. Audit field only —
+     * consumers write the merged image at 0x0 and never branch on this.
+     */
+    bootloaderOffset: number;
+    uploadBaud: number;
+    /** verbatim `upload_flags` from platformio.ini, for the esptool CLI path */
+    esptoolFlags: string[];
+    /** the reset mode the env's flags imply */
+    before: Esp32ResetBefore;
+    after: Esp32ResetAfter;
+    /** does the flasher stub load on this board? (some envs pin --no-stub) */
+    stub: boolean;
+    /** native-USB CDC/JTAG: entering download mode RE-ENUMERATES the device node */
+    nativeUsb: boolean;
+    /** has dual-OTA partitions, i.e. `agentdeck esp32-ota` can target it */
+    ota: boolean;
+    webFlash: boolean;
+    webFlashStatus: Esp32WebFlashStatus;
+    /**
+     * The evidence for `webFlash`. A flag nobody measured is indistinguishable
+     * from one a board produced, so this string is what tells them apart — and it
+     * is required whenever `webFlash` is true (gated in tests).
+     */
+    webFlashVerified: string;
+    notes: string[];
+}
+/**
+ * esptool's own default bootloader offsets. Three values, not two — ESP32-P4 at
+ * 0x2000 is the one that gets missed, because every other chip in this fleet is
+ * 0x0 or 0x1000 and a "two cases" assumption survives review right up until a
+ * P4 is bricked.
+ */
+export declare const ESP32_BOOTLOADER_OFFSET: Record<Esp32ChipFamily, number>;
+/** Ordered as the release matrix builds them, so the generated diff stays small. */
+export declare const ESP32_BOARDS: Esp32BoardSpec[];
+export declare const esp32BoardById: (id: string) => Esp32BoardSpec | undefined;
+/**
+ * alias / canonical id / env → the board it means.
+ *
+ * Built as a declaration rather than a top-level loop: this package is
+ * published with `sideEffects: false`, so import-time statements are work a
+ * bundler is allowed to delete (gated by shared/src/__tests__/no-side-effects.test.ts).
+ */
+export declare const ESP32_BOARD_BY_TARGET: Record<string, Esp32BoardSpec>;
+/**
+ * esptool reports a chip DESCRIPTION, not a family: "ESP32-D0WD (revision 1)",
+ * "ESP32-S3 (QFN56) (revision v0.2)". Order matters — every variant string also
+ * contains the substring "ESP32", so the classic case has to be the fallback or
+ * it swallows the whole family.
+ */
+export declare function esp32ChipFamilyOf(description: string): Esp32ChipFamily | 'other';
+/**
+ * esptool-js's `detectFlashSize()` silently returns `"4MB"` when it cannot
+ * decode the size id, so "4MB" means either a 4MB part or "no idea". Measured
+ * 2026-08-22: a TTGO T-Display read through the ROM loader (no stub) answers
+ * `0xffffff` and was reported as 4MB, while the same board with the stub reads
+ * `0x1840ef` → 16MB, and esptool.py reads 16MB either way.
+ *
+ * So the id is checked first and "unknown" is allowed to stay unknown.
+ */
+export declare function esp32FlashIdIsUsable(flashIdHex: string | undefined): boolean;
+/**
+ * The flash-size guard is DIRECTIONAL.
+ *
+ * Declaring MORE flash than the part has is the brick: the bootloader header
+ * claims a geometry the chip cannot serve and the partition table is rejected.
+ * Declaring LESS is merely conservative — and on InkDeck it is mandatory, since
+ * the XIAO ESP32-S3 Plus is physically 16MB but its BSP bakes an 8MB field. An
+ * equality test fails that board for doing the correct thing.
+ *
+ * Returns undefined when the detected size is unknown; that is its own answer,
+ * not a pass and not a failure.
+ */
+export declare function esp32FlashSizeIsSafe(declared: string, detected: string | undefined): boolean | undefined;
+/** The `--chip` argument esptool expects for a board's family. */
+export declare const ESP32_ESPTOOL_CHIP: Record<Esp32ChipFamily, string>;
+/** Chip ID `esptool image-info` prints, per family — used to self-check a merged image. */
+export declare const ESP32_IMAGE_CHIP_ID: Record<Esp32ChipFamily, number>;
+/** Where the partition table lives; also where the bootloader region ends. */
+export declare const ESP32_PARTITION_TABLE_OFFSET = 32768;
+/** boot_app0 (the OTA-selection blob) offset. Absent, a board can boot a stale slot. */
+export declare const ESP32_BOOT_APP0_OFFSET = 57344;
+/** app0 — the first application slot. Same on every board here. */
+export declare const ESP32_APP0_OFFSET = 65536;
+export type Esp32PreflightCode = 
+/** every check the link could answer agreed */
+'ok'
+/** connected, but the flash id was unreadable — chip family is all we verified */
+ | 'ok-unknown-flash'
+/** the chip on the wire is not the family this image was built for */
+ | 'chip-mismatch'
+/** the image declares more flash than the part reports having */
+ | 'flash-too-small'
+/** this SURFACE does not offer the board (browser only — see `surface`) */
+ | 'board-not-offered'
+/** the image about to be written was built for different geometry than this board's spec */
+ | 'image-geometry-mismatch';
+/**
+ * Which tool is asking. It changes exactly one thing, and getting it wrong in
+ * either direction is a real defect:
+ *
+ * - `'browser'` additionally requires `webFlash`, because the page only offers
+ *   boards a hardware run measured.
+ * - `'cli'` does NOT. `webFlash` means "offered in the browser", never "may be
+ *   written at all" — and `esp32_c6_147` has no OTA slot, so USB is its ONLY
+ *   update path. A CLI that inherited the browser's list would leave that board
+ *   with no way to be updated at all.
+ */
+export type Esp32FlashSurface = 'browser' | 'cli';
+export interface Esp32PreflightInput {
+    board: Esp32BoardSpec;
+    surface: Esp32FlashSurface;
+    /** raw `getChipDescription()` output, e.g. "ESP32-S3 (QFN56) (revision v0.2)" */
+    detectedChip: string | undefined;
+    /** `detectFlashSize()` output, or undefined when the flash id was unusable */
+    detectedFlashSize: string | undefined;
+    /**
+     * What the IMAGE says, read from the release manifest — as opposed to what
+     * this build's SSOT says the board is.
+     *
+     * These are not the same fact and they are deliberately decoupled: the CLI
+     * takes its manifest from a release tag (`--tag`, or the newest published
+     * one) while its board spec is bundled, and the browser page ships from
+     * master while its manifest comes from whichever release Pages deployed. So
+     * the value the guard checks and the value actually written into the
+     * flash-params header can differ, and the guard would be validating a number
+     * nobody writes.
+     *
+     * Omit when writing a hand-supplied image (`--firmware`), where there is no
+     * manifest to disagree with.
+     */
+    imageGeometry?: {
+        chipFamily: string;
+        flashSize: string;
+    };
+}
+export interface Esp32PreflightVerdict {
+    code: Esp32PreflightCode;
+    /** the only field a caller may branch on to start a write */
+    mayWrite: boolean;
+    /** what was compared, for the UI to show detected-vs-expected */
+    detectedFamily?: Esp32ChipFamily | 'other';
+}
+/**
+ * There is deliberately no `force` parameter.
+ *
+ * Writing a 16MB-header image to an 8MB part, or an S3 image to a classic
+ * ESP32, is precisely how these boards are bricked — and the recovery for a
+ * bricked board is the very tool that refused. An override switch would make
+ * the guard advisory, and an advisory guard is the one that gets clicked
+ * through at 2am. Callers that legitimately need to bypass have esptool.
+ */
+export declare function esp32PreflightVerdict(input: Esp32PreflightInput): Esp32PreflightVerdict;
+//# sourceMappingURL=esp32-boards.d.ts.map

package/dist/esp32-boards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esp32-boards.d.ts","sourceRoot":"","sources":["../src/esp32-boards.ts"],"names":[],"mappings":"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"}

package/dist/esp32-boards.js

@@ -0,0 +1,327 @@
+/**
+ * ESP32 board SSOT — the machine-readable half of the board table.
+ *
+ * WHY THIS FILE EXISTS. The same board set was written out by hand in four
+ * places and only one edge had a gate:
+ *
+ *   docs/hardware-compatibility.md   (spec sheet — gated into docs/hardware/index.html)
+ *   .github/workflows/esp32-release.yml  (build matrix — enforced by a COMMENT only)
+ *   bridge/src/cli.ts                (ESP32_OTA_BOARDS)
+ *   docs/esp32.md                    (alias table)
+ *
+ * A board missing from the release matrix ships no firmware and nothing fails —
+ * which is exactly how `t_embed`, `t_display_pro` and `esp32_c6_147` had no
+ * binaries at all in 1.0.1. This file is where those literals stop being
+ * literals; `scripts/generate-esp32-board-matrix.mjs` emits the derived copies
+ * and cross-checks the rest.
+ *
+ * DIVISION OF LABOUR with docs/hardware-compatibility.md: that file stays the
+ * SSOT for the human columns (display, controller, input, peripherals, status)
+ * and this one owns the machine fields. Two SSOTs over DISJOINT column sets,
+ * bound by a gate — not a second copy. Drop the cross-check and this file makes
+ * the duplication worse, not better.
+ */
+/**
+ * esptool's own default bootloader offsets. Three values, not two — ESP32-P4 at
+ * 0x2000 is the one that gets missed, because every other chip in this fleet is
+ * 0x0 or 0x1000 and a "two cases" assumption survives review right up until a
+ * P4 is bricked.
+ */
+export const ESP32_BOOTLOADER_OFFSET = {
+    ESP32: 0x1000,
+    'ESP32-S3': 0x0,
+    'ESP32-C6': 0x0,
+    'ESP32-P4': 0x2000,
+};
+const EV = '2026-08-22 · esptool-js 0.6.1 · Node 26.5 serialport adapter · ';
+/** Ordered as the release matrix builds them, so the generated diff stays small. */
+export const ESP32_BOARDS = [
+    {
+        id: '86box', env: 'box_86', name: '86 Box', display: '4" 480x480 ST7701',
+        aliases: ['box_86', 'box_40'],
+        chipFamily: 'ESP32-S3', flashSize: '16MB', flashMode: 'dio', flashFreq: '80m',
+        bootloaderOffset: 0x0, uploadBaud: 460800, esptoolFlags: [],
+        before: 'default_reset', after: 'hard_reset', stub: true, nativeUsb: false,
+        ota: true,
+        webFlash: true, webFlashStatus: 'verified',
+        webFlashVerified: EV +
+            'default_reset/stub · ESP32-S3 (QFN56) rev v0.2 · flash 16MB · 460800 ok. ' +
+            'Writes and MD5-verifies from the released merged image (4 runs, esp32-v1.0.7). ' +
+            'POST-WRITE RESET DOES NOT WORK ON THIS BOARD: it stays parked in the flasher stub — silent for 200s ' +
+            'with exclusive port access — after every write, and comes up in 2.0s only once python esptool pulses EN. ' +
+            'A serialport RTS pulse, a DTR pulse, an RTS pulse through the Transport shim, and ' +
+            'main(default_reset)+after(hard_reset) were each measured and none reboot it; esptool-js HardReset is a ' +
+            'release with no assert. The firmware written is correct — the user must power-cycle.',
+        notes: ['CH340 USB-serial bridge.'],
+    },
+    {
+        id: 'ips_35', env: 'ips35', name: 'IPS 3.5"', display: '3.5" 480x320 AXS15231B',
+        aliases: ['ips35'],
+        chipFamily: 'ESP32-S3', flashSize: '16MB', flashMode: 'dio', flashFreq: '80m',
+        bootloaderOffset: 0x0, uploadBaud: 460800,
+        esptoolFlags: ['--before', 'no_reset', '--no-stub'],
+        before: 'no_reset', after: 'hard_reset', stub: false, nativeUsb: true,
+        ota: true,
+        webFlash: false, webFlashStatus: 'unverified',
+        webFlashVerified: '2026-08-22 · owned and live on Wi-Fi, but not USB-attached during the spike. A --no-stub board like the TTGO that did pass, so it is the best next candidate.',
+        notes: ['esptool misdetects the flash as 8MB during a bootloop — 16MB must be explicit.'],
+    },
+    {
+        id: 'round_amoled', env: 'amoled', name: 'Round AMOLED', display: '1.8" 360x360 ST77916',
+        // `amoled_18` was documented in docs/esp32.md but absent from the CLI, so
+        // a user following the docs got "No online WiFi ESP32 target matches". The
+        // CLI already accepts the other flash.sh friendly names (box_40, ips_101,
+        // knob, ticker, s3pro), so this was a gap, not a deliberate exclusion.
+        aliases: ['amoled', 'amoled_18'],
+        chipFamily: 'ESP32-S3', flashSize: '8MB', flashMode: 'dio', flashFreq: '80m',
+        bootloaderOffset: 0x0, uploadBaud: 460800,
+        esptoolFlags: ['--before', 'no_reset', '--no-stub'],
+        before: 'no_reset', after: 'hard_reset', stub: false, nativeUsb: true,
+        ota: true,
+        webFlash: false, webFlashStatus: 'unverified',
+        webFlashVerified: '2026-08-22 · owned and live on Wi-Fi, but not USB-attached during the spike.',
+        notes: [],
+    },
+    {
+        id: 'ips_10', env: 'ips10', name: 'IPS 10.1"', display: '10.1" 800x1280 JD9365',
+        aliases: ['ips10', 'ips_101'],
+        chipFamily: 'ESP32-P4', flashSize: '16MB', flashMode: 'dio', flashFreq: '40m',
+        bootloaderOffset: 0x2000, uploadBaud: 115200,
+        esptoolFlags: ['--before', 'no_reset', '--after', 'no_reset', '--no-stub'],
+        before: 'no_reset', after: 'no_reset', stub: false, nativeUsb: false,
+        ota: true,
+        webFlash: false, webFlashStatus: 'blocked',
+        webFlashVerified: '2026-08-22 · enters download mode but never answers. esptool.py 5.1.2 (the PlatformIO-vendored tool-esptoolpy build — NOT a PyPI release: the PyPI 5.1 line stops at 5.1.0, which is how a CI pin read off a local `pip show esptool` failed the esp32-v1.0.7 cut) reports "Download mode successfully detected, but getting no sync reply: The serial TX path seems to be down" — board-side, not esptool-js.',
+        notes: ['ESP32-P4: the bootloader lives at 0x2000, not 0x0.'],
+    },
+    {
+        id: 'inkdeck', env: 'inkdeck', name: 'InkDeck', display: '7.5" 800x480 e-ink UC8179',
+        aliases: [],
+        chipFamily: 'ESP32-S3', flashSize: '8MB', flashMode: 'dio', flashFreq: '80m',
+        bootloaderOffset: 0x0, uploadBaud: 460800, esptoolFlags: [],
+        before: 'default_reset', after: 'hard_reset', stub: true, nativeUsb: true,
+        ota: true,
+        webFlash: true, webFlashStatus: 'verified',
+        webFlashVerified: EV +
+            'default_reset/stub · ESP32-S3 (QFN56) rev v0.2 · flash 16MB detected vs 8MB declared (BSP-correct) · 460800 ok. Connected on the DOWNLOAD-MODE node, which is a different device node from the running one.',
+        notes: [
+            'The XIAO ESP32-S3 Plus is physically 16MB, but its BSP bakes an 8MB flash-size field — 8MB is the correct declaration, not a mistake.',
+            'Pick the download-mode port, not the running one.',
+        ],
+    },
+    {
+        id: 'ttgo_t_display', env: 'ttgo', name: 'TTGO T-Display', display: '1.14" 240x135 ST7789',
+        aliases: ['ttgo'],
+        chipFamily: 'ESP32', flashSize: '16MB', flashMode: 'dio', flashFreq: '80m',
+        bootloaderOffset: 0x1000, uploadBaud: 115200, esptoolFlags: ['--no-stub'],
+        before: 'default_reset', after: 'hard_reset', stub: false, nativeUsb: false,
+        ota: true,
+        webFlash: true, webFlashStatus: 'verified-partial',
+        webFlashVerified: EV +
+            'BOTH default_reset/stub and default_reset/no-stub connect · ESP32-D0WDQ6 rev v1.1. This is the measurement that proves the --no-stub path works. Flash size reads 16MB WITH the stub and is unreadable without it (flashId 0xffffff), so the size guard is unavailable stubless.',
+        notes: ['Stubless SPI flash-id reads return 0xffffff on this board; the size guard degrades to chip-family only.'],
+    },
+    {
+        id: 'ulanzi_tc001', env: 'led8x32', name: 'Ulanzi TC001', display: '32x8 WS2812B matrix',
+        aliases: ['led8x32'],
+        chipFamily: 'ESP32', flashSize: '8MB', flashMode: 'dio', flashFreq: '80m',
+        bootloaderOffset: 0x1000, uploadBaud: 115200, esptoolFlags: [],
+        before: 'default_reset', after: 'hard_reset', stub: true, nativeUsb: false,
+        ota: true,
+        webFlash: true, webFlashStatus: 'verified',
+        webFlashVerified: EV + 'default_reset/stub · ESP32-D0WD rev 1 · flash 8MB',
+        notes: [
+            'Flash size MUST be 8MB — the 4MB default leaves the bootloader misbehaving (GPIO15 buzzer stuck HIGH, no display).',
+            'This board does NOT answer device_info_request: its CH340 TX is hardware-broken. Verify a flash by the matrix render plus Wi-Fi registration, never by a serial probe.',
+        ],
+    },
+    {
+        id: 't_embed', env: 't_embed', name: 'T-Embed CC1101', display: '1.9" 320x170 ST7789',
+        aliases: ['tembed', 'knob'],
+        chipFamily: 'ESP32-S3', flashSize: '16MB', flashMode: 'dio', flashFreq: '80m',
+        bootloaderOffset: 0x0, uploadBaud: 460800, esptoolFlags: [],
+        before: 'default_reset', after: 'hard_reset', stub: true, nativeUsb: true,
+        ota: true,
+        webFlash: false, webFlashStatus: 'unverified',
+        webFlashVerified: '2026-08-22 · no auto entry into download mode; esptool.py 5.1.2 (the PlatformIO-vendored tool-esptoolpy build, not a PyPI release) fails identically ("No serial data received"), so this is the board, not esptool-js. Needs a physical BOOT press to verify.',
+        notes: [
+            'Native USB CDC needs esptool\'s NORMAL reset — copying the no_reset/no-stub flags from the CH340 envs made every upload fail (2026-07-26).',
+        ],
+    },
+    {
+        id: 't_display_pro', env: 't_display_pro', name: 'T-Display-S3-Pro', display: '2.33" 480x222 ST7796U',
+        aliases: ['tdisplaypro', 'ticker', 's3pro'],
+        chipFamily: 'ESP32-S3', flashSize: '16MB', flashMode: 'dio', flashFreq: '80m',
+        bootloaderOffset: 0x0, uploadBaud: 230400, esptoolFlags: [],
+        before: 'default_reset', after: 'hard_reset', stub: true, nativeUsb: true,
+        ota: true,
+        webFlash: true, webFlashStatus: 'verified',
+        webFlashVerified: EV + 'default_reset/stub · ESP32-S3 (QFN56) rev v0.2 · flash 16MB · 230400 ok (the pinned rate held)',
+        notes: ['USB CDC corrupts the esptool stream above 230400 — stub + 230400 is the proven-stable combination.'],
+    },
+    {
+        id: 'esp32_c6_147', env: 'esp32_c6_147', name: 'Waveshare C6-LCD-1.47', display: '1.47" 172x320 ST7789',
+        aliases: [],
+        chipFamily: 'ESP32-C6', flashSize: '4MB', flashMode: 'dio', flashFreq: '80m',
+        bootloaderOffset: 0x0, uploadBaud: 460800, esptoolFlags: [],
+        before: 'default_reset', after: 'hard_reset', stub: true, nativeUsb: true,
+        // Single-app 4MB layout: no OTA slot, so USB is this board's ONLY update
+        // path. Stated here rather than inferred from an absent line in the CLI's
+        // OTA list, which is how it read before.
+        ota: false,
+        webFlash: false, webFlashStatus: 'unverified',
+        webFlashVerified: '2026-08-22 · not present on serial or Wi-Fi during the spike, and the only ESP32-C6 in the fleet, so the entire C6 path is unverified.',
+        notes: ['No OTA partitions — USB is the only way to update this board.'],
+    },
+];
+export const esp32BoardById = (id) => ESP32_BOARDS.find((b) => b.id === id);
+/**
+ * alias / canonical id / env → the board it means.
+ *
+ * Built as a declaration rather than a top-level loop: this package is
+ * published with `sideEffects: false`, so import-time statements are work a
+ * bundler is allowed to delete (gated by shared/src/__tests__/no-side-effects.test.ts).
+ */
+export const ESP32_BOARD_BY_TARGET = Object.fromEntries(ESP32_BOARDS.flatMap((b) => [b.id, b.env, ...b.aliases].map((key) => [key, b])));
+/**
+ * esptool reports a chip DESCRIPTION, not a family: "ESP32-D0WD (revision 1)",
+ * "ESP32-S3 (QFN56) (revision v0.2)". Order matters — every variant string also
+ * contains the substring "ESP32", so the classic case has to be the fallback or
+ * it swallows the whole family.
+ */
+export function esp32ChipFamilyOf(description) {
+    const d = description.toUpperCase();
+    if (/ESP32-S3/.test(d))
+        return 'ESP32-S3';
+    if (/ESP32-P4/.test(d))
+        return 'ESP32-P4';
+    if (/ESP32-C6/.test(d))
+        return 'ESP32-C6';
+    if (/ESP32-(S2|C2|C3|C5|C61|H2)/.test(d))
+        return 'other';
+    if (/ESP32/.test(d))
+        return 'ESP32';
+    return 'other';
+}
+/* --------------------------------------------------------------- flash guards
+ * These two rules decide whether it is safe to write to a board, so the browser
+ * flasher and the CLI must apply them IDENTICALLY — which makes them SSOT
+ * material, not per-surface helpers.
+ */
+/**
+ * esptool-js's `detectFlashSize()` silently returns `"4MB"` when it cannot
+ * decode the size id, so "4MB" means either a 4MB part or "no idea". Measured
+ * 2026-08-22: a TTGO T-Display read through the ROM loader (no stub) answers
+ * `0xffffff` and was reported as 4MB, while the same board with the stub reads
+ * `0x1840ef` → 16MB, and esptool.py reads 16MB either way.
+ *
+ * So the id is checked first and "unknown" is allowed to stay unknown.
+ */
+export function esp32FlashIdIsUsable(flashIdHex) {
+    if (!flashIdHex)
+        return false;
+    const n = Number.parseInt(flashIdHex, 16);
+    return Number.isFinite(n) && n !== 0xffffff && n !== 0x000000;
+}
+/**
+ * The flash-size guard is DIRECTIONAL.
+ *
+ * Declaring MORE flash than the part has is the brick: the bootloader header
+ * claims a geometry the chip cannot serve and the partition table is rejected.
+ * Declaring LESS is merely conservative — and on InkDeck it is mandatory, since
+ * the XIAO ESP32-S3 Plus is physically 16MB but its BSP bakes an 8MB field. An
+ * equality test fails that board for doing the correct thing.
+ *
+ * Returns undefined when the detected size is unknown; that is its own answer,
+ * not a pass and not a failure.
+ */
+export function esp32FlashSizeIsSafe(declared, detected) {
+    const mb = (s) => {
+        if (!s)
+            return undefined;
+        const m = /(\d+)\s*MB/i.exec(s);
+        return m ? Number(m[1]) : undefined;
+    };
+    const want = mb(declared);
+    const have = mb(detected);
+    if (want === undefined || have === undefined)
+        return undefined;
+    return want <= have;
+}
+/** The `--chip` argument esptool expects for a board's family. */
+export const ESP32_ESPTOOL_CHIP = {
+    ESP32: 'esp32',
+    'ESP32-S3': 'esp32s3',
+    'ESP32-C6': 'esp32c6',
+    'ESP32-P4': 'esp32p4',
+};
+/** Chip ID `esptool image-info` prints, per family — used to self-check a merged image. */
+export const ESP32_IMAGE_CHIP_ID = {
+    ESP32: 0,
+    'ESP32-S3': 9,
+    'ESP32-C6': 13,
+    'ESP32-P4': 18,
+};
+/** Where the partition table lives; also where the bootloader region ends. */
+export const ESP32_PARTITION_TABLE_OFFSET = 0x8000;
+/** boot_app0 (the OTA-selection blob) offset. Absent, a board can boot a stale slot. */
+export const ESP32_BOOT_APP0_OFFSET = 0xe000;
+/** app0 — the first application slot. Same on every board here. */
+export const ESP32_APP0_OFFSET = 0x10000;
+/**
+ * There is deliberately no `force` parameter.
+ *
+ * Writing a 16MB-header image to an 8MB part, or an S3 image to a classic
+ * ESP32, is precisely how these boards are bricked — and the recovery for a
+ * bricked board is the very tool that refused. An override switch would make
+ * the guard advisory, and an advisory guard is the one that gets clicked
+ * through at 2am. Callers that legitimately need to bypass have esptool.
+ */
+export function esp32PreflightVerdict(input) {
+    const { board, surface, detectedChip, detectedFlashSize } = input;
+    if (surface === 'browser' && !board.webFlash) {
+        return { code: 'board-not-offered', mayWrite: false };
+    }
+    const detectedFamily = detectedChip ? esp32ChipFamilyOf(detectedChip) : undefined;
+    if (detectedFamily !== board.chipFamily) {
+        return { code: 'chip-mismatch', mayWrite: false, detectedFamily };
+    }
+    // The guard must check the value that will actually be WRITTEN. Concretely:
+    // the SSOT corrects a board down to 4MB, a pinned manifest still says 16MB,
+    // the part reports 8MB — `4 <= 8` passes while a 16MB header lands on an 8MB
+    // part, which is precisely the brick every other rule here exists to prevent.
+    //
+    // STRICT EQUALITY, NOT DIRECTIONAL, and deliberately so. Unlike the size rule
+    // below, these two values are not "declared vs actual": they are two
+    // descriptions of the SAME board from two sources that are supposed to agree
+    // (a release manifest, and this build's SSOT). A disagreement in either
+    // direction means they describe different boards and there is no way to tell
+    // which one is true.
+    //
+    // It is also the ONLY size check left when the flash id is unreadable — a
+    // stubless TTGO answers 0xffffff, `esp32FlashSizeIsSafe` returns undefined,
+    // and the size axis goes unchecked. Loosening this to a directional test
+    // would remove the sole guard in exactly the case with the least information.
+    //
+    // The cost is a release-ordering constraint, not a defect: after any SSOT
+    // flash-size change, the browser flasher refuses against the previously
+    // deployed release until Pages redeploys with the new manifest. Cut the esp32
+    // release, then push master. See RELEASING.md.
+    const { imageGeometry } = input;
+    if (imageGeometry &&
+        (imageGeometry.flashSize !== board.flashSize || imageGeometry.chipFamily !== board.chipFamily)) {
+        return { code: 'image-geometry-mismatch', mayWrite: false, detectedFamily };
+    }
+    const sizeSafe = esp32FlashSizeIsSafe(board.flashSize, detectedFlashSize);
+    if (sizeSafe === false)
+        return { code: 'flash-too-small', mayWrite: false, detectedFamily };
+    // Unknown is its own answer, and it is a PASS: the merged image bakes its
+    // flash-size field at build time from this same SSOT and CI asserts it with
+    // `esptool image-info`, so the geometry is already correct in the bits. What
+    // is lost is the runtime cross-check, and that has to be said in the UI
+    // rather than quietly downgraded to a full pass.
+    if (sizeSafe === undefined)
+        return { code: 'ok-unknown-flash', mayWrite: true, detectedFamily };
+    return { code: 'ok', mayWrite: true, detectedFamily };
+}
+//# sourceMappingURL=esp32-boards.js.map

package/dist/esp32-boards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"esp32-boards.js","sourceRoot":"","sources":["../src/esp32-boards.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export * from './pairing-code.js';
 export * from './mdns-identity.js';
 export * from './timeline.js';
 export * from './subagent-activity.js';
+export * from './esp32-boards.js';
 export * from './model-provider.js';
 export * from './timeline-icons.js';
 export * from './timeline-label.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -12,6 +12,7 @@ export * from './pairing-code.js';
 export * from './mdns-identity.js';
 export * from './timeline.js';
 export * from './subagent-activity.js';
+export * from './esp32-boards.js';
 export * from './model-provider.js';
 export * from './timeline-icons.js';
 export * from './timeline-label.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentdeck/shared",
-  "version": "1.0.22",
+  "version": "1.0.23",
   "engines": {
     "node": ">=22"
   },