@tapflowio/protocol 0.17.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tapflow contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# @tapflowio/protocol
+
+The wire contract for [tapflow](https://github.com/jo-duchan/tapflow)'s WebSocket traffic — the message types exchanged between the browser, the relay, and the device agents.
+
+**Types only.** Nothing in this package emits runtime code, so importing it with `import type` leaves no trace in a bundle.
+
+```ts
+import type { RelayToBrowser, BrowserToRelay } from '@tapflowio/protocol'
+```
+
+It exists so the relay, the dashboard and the MCP server cannot drift apart on what a message looks like. It is published because `@tapflowio/relay` and `@tapflowio/mcp-server` depend on it; most users will never import it directly.
+
+The binary frame envelope is a separate format and is not described here.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,359 @@
+/** Agent resource sample, reported on `agent:resources` and echoed in a session listing. */
+export interface AgentResources {
+    cpuPercent: number;
+    memUsedMB: number;
+    memTotalMB: number;
+    slotsAvailable: number;
+    slotsTotal: number;
+    /** Date.now() */
+    reportedAt: number;
+}
+/** What an agent reports about a device in `agent:register`. No `sessionId`/`busy` — the relay
+ *  owns those. */
+export interface DeviceReport {
+    id: string;
+    name: string;
+    platform: string;
+    status: string;
+    osVersion?: string;
+}
+/** A device as the relay lists it, after adding what only the relay knows. Named `DeviceSummary`
+ *  rather than `DeviceInfo` because both packages already used that name for different shapes:
+ *  the relay for this, the dashboard for the `session:deviceInfo` payload (`DeviceDetails`). */
+export interface DeviceSummary extends DeviceReport {
+    sessionId: string;
+    busy: boolean;
+}
+/** The `session:deviceInfo` payload — what the viewer shows in its info card. */
+export interface DeviceDetails {
+    deviceName: string;
+    osVersion: string;
+}
+/** `agents:listed` groups devices by agent machine. */
+export interface SessionInfo {
+    agentName?: string;
+    platform?: string;
+    resources?: AgentResources;
+    devices: DeviceSummary[];
+}
+export interface ChromeRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface ChromeButton {
+    name: string;
+    accessibilityTitle: string;
+    anchor: string;
+    /** true = button is above the device frame (e.g. home button) */
+    onTop: boolean;
+    /** button center at retracted/default position, in 2× composite px */
+    normalOffset: {
+        x: number;
+        y: number;
+    };
+    /** button center at extended/hover position, in 2× composite px */
+    rolloverOffset: {
+        x: number;
+        y: number;
+    };
+    buttonW: number;
+    buttonH: number;
+    /** HID usage page for SimulatorKit injection (0 = unknown) */
+    usagePage: number;
+    /** HID usage code (0 = unknown) */
+    usage: number;
+    /** base64 PNG of the button at 2× (for the CSS-animated overlay) */
+    buttonPng?: string;
+    /** base64 PNG of the pressed state (imageDown asset) */
+    pressedPng?: string;
+    pressedRect?: ChromeRect;
+}
+export interface AndroidButton {
+    name: string;
+    accessibilityTitle: string;
+    keyCode: number;
+}
+/** iOS device chrome — the bezel artwork and hit regions the viewer composites around the screen. */
+export interface ChromeData {
+    /** full composite PDF at 2× — device frame visible, screen hole transparent */
+    framePng: string;
+    bezelWidth: number;
+    bezelHeight: number;
+    /** full PDF width including devicePadding, at 2× px */
+    compositeWidth: number;
+    compositeHeight: number;
+    padding: {
+        left: number;
+        right: number;
+        top: number;
+        bottom: number;
+    };
+    screenRect: ChromeRect;
+    /** screen corner radius in 2× px (0 if the device has no rounded corners) */
+    screenCornerRadius: number;
+    logicalWidth: number;
+    logicalHeight: number;
+    buttons: ChromeButton[];
+}
+/** Android chrome — no bezel artwork; the emulator frame carries it. */
+export interface AndroidChrome {
+    buttons: AndroidButton[];
+    streamType: 'h264';
+    screenWidth?: number;
+    screenHeight?: number;
+    cornerRadius?: number;
+}
+/** The `session:chrome` payload. The relay never reads it — it stores and forwards — but the
+ *  contract still states the shape, because the viewer parses it. A new platform adds its variant
+ *  here; relay and dashboard code stay unchanged, which is what the OCP rule asks for. */
+export type ChromePayload = ChromeData | AndroidChrome;
+export type RelayToAgent = {
+    type: 'agent:registered';
+    registeredSessions: Array<{
+        deviceId: string;
+        sessionId: string;
+    }>;
+} | {
+    type: 'stream:request-idr';
+    sessionId: string;
+} | {
+    type: 'device:shutdown';
+    sessionId: string;
+    payload: {
+        deviceId: string;
+    };
+} | {
+    type: 'app:install';
+    sessionId: string;
+    payload: {
+        filePath: string;
+        bundleId: string | null;
+    };
+} | {
+    type: 'app:launch';
+    sessionId: string;
+    payload: {
+        bundleId: string;
+    };
+} | {
+    type: 'screenshot:request';
+    sessionId: string;
+    requestId: string;
+    format: 'png' | 'jpeg';
+} | {
+    type: 'ui:tree:request';
+    sessionId: string;
+    requestId: string;
+};
+/**
+ * Why a session stopped existing, server-side. A literal union rather than a string so that adding
+ * a case is a compile-time event for every consumer that switches on it.
+ *
+ * Named `session:terminated`, not `session:ended`: `session:end` is already a message the *browser*
+ * sends to ask for shutdown, and the two would sit one letter apart in the same switch. This one
+ * travels the other way and is not an acknowledgement of that request.
+ */
+export type SessionTerminatedReason = 'agent-disconnected';
+export type RelayToBrowser = {
+    type: 'agents:listed';
+    sessions: SessionInfo[];
+} | {
+    type: 'stream:registered';
+} | {
+    type: 'session:joined';
+    sessionId: string;
+    capabilities: string[];
+} | {
+    type: 'session:terminated';
+    sessionId: string;
+    reason: SessionTerminatedReason;
+} | {
+    type: 'session:agent-away';
+    sessionId: string;
+} | {
+    type: 'session:rebound';
+    sessionId: string;
+    capabilities: string[];
+} | {
+    type: 'session:chrome';
+    payload: ChromePayload;
+} | {
+    type: 'session:deviceInfo';
+    payload: DeviceDetails;
+} | {
+    type: 'device:ready';
+    payload: {
+        deviceId: string;
+    };
+} | {
+    type: 'error';
+    message: string;
+} | {
+    type: 'app:install-error';
+    sessionId: string;
+    message: string;
+} | {
+    type: 'app:launch-error';
+    sessionId: string;
+    message: string;
+} | {
+    type: 'device:boot-error';
+    sessionId: string;
+    message: string;
+} | {
+    type: 'open-url:error';
+    sessionId: string;
+    message: string;
+} | {
+    type: 'app:clear-state-error';
+    sessionId: string;
+    message: string;
+} | {
+    type: 'input:error';
+    sessionId: string;
+    message: string;
+} | {
+    type: 'clipboard:error';
+    sessionId: string;
+    requestId: string;
+    message: string;
+};
+/** Everything the relay originates. Messages it merely forwards keep their inbound type — they are
+ *  not re-created, so they are not checked against this union. */
+export type RelayOutbound = RelayToAgent | RelayToBrowser;
+/** Key input. The payload carries `code` — a `KeyboardEvent.code` name — and `modifiers` as a
+ *  **bitmap**, not a list and not `key`.
+ *
+ *  The dashboard union declared `{ key: string }` while every sender and both agents used
+ *  `{ code, modifiers }`; the mismatch survived because `send()` took `object`. The authority is
+ *  the consumer: `IOSAgent.ts` reads `{ code: string; modifiers?: number }` and passes the number
+ *  straight to `touchHelper.sendKey(usage, modifiers ?? 0)`, where it is the HID modifier bitmap
+ *  documented in packages/ios-agent/AGENTS.md (touch-helper type 9). */
+export interface InputKey {
+    type: 'input:key';
+    sessionId: string;
+    payload: {
+        code: string;
+        modifiers?: number;
+    };
+}
+export interface Point {
+    x: number;
+    y: number;
+}
+/** The two clipboard requests a viewer can make. Kept as its own union because the bridge sends
+ *  them through one call that takes the type as an argument. */
+export type ClipboardRequest = {
+    type: 'clipboard:read';
+    sessionId: string;
+    requestId: string;
+    payload?: {
+        press?: 'copy' | 'cut';
+    };
+} | {
+    type: 'clipboard:write';
+    sessionId: string;
+    requestId: string;
+    payload: {
+        text: string;
+        pasteAfter?: boolean;
+    };
+};
+export type BrowserToRelay = {
+    type: 'agents:list';
+} | {
+    type: 'session:start';
+    sessionId: string;
+} | {
+    type: 'session:end';
+    sessionId: string;
+} | {
+    type: 'session:leave';
+    sessionId: string;
+} | {
+    type: 'device:boot';
+    sessionId: string;
+    payload: {
+        deviceId: string;
+        resetMode?: 'app-only' | 'full-erase';
+        acceptH264?: boolean;
+        secureContext?: boolean;
+    };
+} | {
+    type: 'device:shutdown';
+    sessionId: string;
+    payload: {
+        deviceId: string;
+    };
+} | {
+    type: 'app:install';
+    sessionId: string;
+    buildId: number;
+} | {
+    type: 'app:launch';
+    sessionId: string;
+    buildId: number;
+} | {
+    type: 'app:clear-state';
+    sessionId: string;
+    payload?: {
+        bundleId?: string;
+    };
+} | {
+    type: 'open-url';
+    sessionId: string;
+    payload: {
+        url: string;
+    };
+} | {
+    type: 'input:touch:start';
+    sessionId: string;
+    payload: Point;
+} | {
+    type: 'input:touch:move';
+    sessionId: string;
+    payload: Point;
+} | {
+    type: 'input:touch:end';
+    sessionId: string;
+    payload?: Point;
+} | {
+    type: 'input:pinch:start';
+    sessionId: string;
+    payload: {
+        f0: Point;
+        f1: Point;
+    };
+} | {
+    type: 'input:pinch:move';
+    sessionId: string;
+    payload: {
+        f0: Point;
+        f1: Point;
+    };
+} | {
+    type: 'input:pinch:end';
+    sessionId: string;
+} | InputKey | {
+    type: 'input:type';
+    sessionId: string;
+    payload: {
+        text: string;
+    };
+} | {
+    type: 'input:button';
+    sessionId: string;
+    payload: {
+        name: string;
+        phase?: 'down' | 'up';
+    };
+} | {
+    type: 'input:rotate';
+    sessionId: string;
+} | {
+    type: 'input:keyboard:toggle';
+    sessionId: string;
+} | ClipboardRequest;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,4FAA4F;AAC5F,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;kBACkB;AAClB,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;gGAEgG;AAChG,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,OAAO,CAAA;CACd;AAED,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B,OAAO,EAAE,aAAa,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,kBAAkB,EAAE,MAAM,CAAA;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,iEAAiE;IACjE,KAAK,EAAE,OAAO,CAAA;IACd,sEAAsE;IACtE,YAAY,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACtC,mEAAmE;IACnE,cAAc,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAA;IACjB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,UAAU,CAAA;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,kBAAkB,EAAE,MAAM,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,qGAAqG;AACrG,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACrE,UAAU,EAAE,UAAU,CAAA;IACtB,6EAA6E;IAC7E,kBAAkB,EAAE,MAAM,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB;AAED,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;0FAE0F;AAC1F,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,aAAa,CAAA;AAItD,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,kBAAkB,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAChG;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC7E;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,GAClG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,GAC5F;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAA;AAErE;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAAG,oBAAoB,CAAA;AAS1D,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,WAAW,EAAE,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,uBAAuB,CAAA;CAAE,GAQlF;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAMjD;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAIlC;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAGhE;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtF;kEACkE;AAClE,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,cAAc,CAAA;AAIzD;;;;;;;wEAOwE;AACxE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,WAAW,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9C;AAED,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED;gEACgE;AAChE,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;KAAE,CAAA;CAAE,GACtG;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,CAAA;AAEtH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAI5C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAE5C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAC/J;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC7E;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAE,GAI/D;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,EAAE,EAAE,KAAK,CAAA;KAAE,CAAA;CAAE,GACnF;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,EAAE,EAAE,KAAK,CAAA;KAAE,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC9C,QAAQ,GACR;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,GAC7F;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACpD,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// tapflow wire protocol — the WebSocket message contract shared by browser, relay and agents.
+//
+// Scope: JSON messages only. The binary frame envelope (TFFE) is not here — see
+// contributing/frame-envelope.md. Runtime validators, if they ever exist, belong in this package
+// next to the types they validate.
+//
+// Types only, deliberately. Consumers use `import type`, so nothing from this package reaches a
+// runtime bundle. Do not add `enum` or const objects: they compile to runtime values, which would
+// put JavaScript into the dashboard bundle the moment someone referenced one as a value.
+export {};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,EAAE;AACF,gFAAgF;AAChF,iGAAiG;AACjG,mCAAmC;AACnC,EAAE;AACF,gGAAgG;AAChG,kGAAkG;AAClG,yFAAyF"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@tapflowio/protocol",
+  "version": "0.17.0",
+  "description": "Wire protocol contract for tapflow — the WebSocket message types exchanged between browser, relay, and device agents",
+  "keywords": [
+    "tapflow",
+    "protocol",
+    "websocket",
+    "types",
+    "qa"
+  ],
+  "homepage": "https://github.com/jo-duchan/tapflow",
+  "bugs": "https://github.com/jo-duchan/tapflow/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jo-duchan/tapflow.git",
+    "directory": "packages/protocol"
+  },
+  "license": "MIT",
+  "author": "tapflow contributors",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "source": "./src/index.ts",
+      "tsx": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b && tsc -p tsconfig.assertions.json",
+    "lint": "eslint src"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}