native-host

Overview ¶

Command native-host is the Chrome native-messaging bridge for the Usage Buttons Stream Deck plugin. Chrome spawns this binary when the companion extension calls chrome.runtime.connectNative with the host name declared in the native-messaging host manifest.

The host has two sides:

• stdin/stdout, framed per Chrome's native-messaging protocol, talks to the extension's service worker.
• A local AF_UNIX socket (per-platform path) talks to the plugin.

The cookies.Bridge glues the two together: plugin cookie queries are forwarded to the extension, replies are correlated back by request ID. The bridge also tracks the handshake "ready" signal so the plugin's HostAvailable probe can distinguish "extension not yet connected" (quiet "waiting on browser" state) from "extension is up, cookies available."

Logging must go to a sidecar file; writing to stdout would corrupt the frame stream.