Run a coroutine synchronously for synchronous test functions.

Run a coroutine synchronously for synchronous test functions.

Build a mock httpx.Response-like object with controllable headers.

Build a minimal fake BLEDevice.

Update state from this cycle's {dir: session_pct} and return the active dir.

Connect to device and poll until disconnected or stopped. Returns True if at least one successful write occurred. `device` is a BLEDevice —

Read the Claude OAuth access token from the first available credential file.

Expand a 16-bit RGB565 value to an (R, G, B) tuple using proper rounding. Uses ``(channel * 255 + max // 2) // max`` per channel, NOT a *8 bit-sh

Recover a canonical BLE MAC ("AA:BB:CC:DD:EE:FF") from a PnP instance id. Windows encodes a paired BLE device's address in its PnP instance id as

Return a configured MagicMock that stands in for the winreg module.

Return the D-05 menu status-header string for the current TrayState. Shapes: "Connected · last update HH:MM" (ts.last_sync is a float)

Parse the firmware logo.h C header and return an 80x80 Pillow RGBA Image. The logo.h layout (RGB565A8 planar, little-endian RGB565): - Firs

Called on token-expired / API auth failure (D-01 Error = actionable only).

Acquire the process-wide single-instance lock. Returns a truthy handle to keep alive for the process lifetime if this is the first/only tray,

Pull the accessToken out of a credentials blob. Claude Code stores credentials as a JSON object; the blob may also be nested ({"claudeAiOauth

Read the OAuth token for one config dir. Linux: each dir keeps its own ``<dir>/.credentials.json``. macOS: the default install stores the tok

Called in scan/reconnect branches. BLE churn stays Scanning (D-01).

Composite a colored corner bubble onto the brand mark for the given state. Args: base: The RGBA brand image (as returned by ``load_logo_

Build a mock BleakClient that connects successfully but has is_connected stuck True.

Claude config dirs to poll, from the `config_dirs` option (comma list). Defaults to [~/.claude] so existing single-plan setups are unchanged. ~ i

Assert that none of the FORBIDDEN patterns appear in the given source file. Reads the file relative to the repository root (the cwd pytest is inv

Build a fake ctypes module tree whose CreateMutexW returns `handle` and whose get_last_error() returns `last_error`.

Mirror the relevant part of the _refresh loop body.

Return when any of `events` is set, or after `timeout` seconds. Lets the poll loop's TICK wait wake immediately on a stop signal (clean, resp

Return a connectable handle for the Clawdmeter, or None. Targets only the device bonded to THIS machine (via the PnP table / CLAWDMETER_BLE_A

Called after write_payload returns True. ts = time.time().

Run `blueutil <args>`, returning stdout, or None on failure/timeout. A timeout almost always means blueutil lacks Bluetooth permission (it bl

Pull the accessToken out of a credentials blob. Claude Code stores credentials as a JSON object; the blob may also be nested ({"claudeAiOauth

D-05: double current backoff value, clamped to cap. Pure helper — unit-testable without driving the main loop. Used by both slow-search (cap=

Return human-readable expiry from the first-hit credentials file. Reads claudeAiOauth.expiresAt (epoch milliseconds — JS convention). Divides

Return the ordered list of credential file paths to probe (first hit wins). Priority: 1. CLAUDE_CREDENTIALS_PATH env override (D-03, project-

Build all three connection-state icons from the brand base image. Build them once at startup; swap ``icon.icon = icons[state]`` in the tray l

Log in the daemon [HH:MM:SS] style.

Delete every stored bond that isn't the owner, so the board stays paired to exactly one machine. Removing a bond shifts the indices, so restart from 0

Pick the usage-view sub-screen: pairing hint (BLE down), the idle "Zzz" screen (connected but data has gone stale), or the live usage panels. Only re-

Fraction of billing period elapsed (tp, 0-100) and period length in days (pd). Billing periods are assumed calendar-monthly: period_end is the re

Fraction of billing period elapsed (tp, 0-100) and period length in days (pd). Monthly window is assumed (headers expose only reset_ts, not perio