@minionry/browser-types 0.1.8

package/LICENSE

@@ -0,0 +1,14 @@
+Minionry Commercial License
+
+Copyright (c) 2025-present Minionry, Inc. All rights reserved.
+
+This software is not open-source. It is provided under a commercial
+license, and your rights to install, use, and (where the Minionry Terms
+of Service expressly permit it) distribute this software are set out
+there, together with all applicable restrictions, termination, and
+disclaimer terms:
+
+https://app.minionry.com/terms
+
+If you do not agree to the Minionry Terms of Service, you may not
+install or use this software.

package/README.md

@@ -0,0 +1,8 @@
+# @minionry/browser-types
+
+Shared types used by Minionry packages.
+
+For use with Minionry (https://minionry.com).
+
+Proprietary. © Minionry, Inc. All rights reserved. Use is subject to the terms
+in LICENSE.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './tabs.js';
+export * from './input.js';
+export * from './webrtc.js';
+export * from './preflight.js';
+export * from './viewport.js';
+export * from './state.js';
+export * from './message-types.js';

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './tabs.js';
+export * from './input.js';
+export * from './webrtc.js';
+export * from './preflight.js';
+export * from './viewport.js';
+export * from './state.js';
+export * from './message-types.js';

package/dist/input.d.ts

@@ -0,0 +1,79 @@
+export type MouseWireType = 'mousePressed' | 'mouseReleased' | 'mouseMoved' | 'mouseWheel';
+export type CdpMouseButton = 'none' | 'left' | 'middle' | 'right' | 'back' | 'forward';
+export declare const MOD_ALT = 1;
+export declare const MOD_CTRL = 2;
+export declare const MOD_META = 4;
+export declare const MOD_SHIFT = 8;
+export interface ModifierFlags {
+    altKey: boolean;
+    ctrlKey: boolean;
+    metaKey: boolean;
+    shiftKey: boolean;
+}
+export declare function modifierMask(e: ModifierFlags): number;
+export declare function cdpMouseButton(button: number): CdpMouseButton;
+export interface MouseEnvelope {
+    kind: 'mouse';
+    eventType: MouseWireType;
+    x: number;
+    y: number;
+    button: CdpMouseButton;
+    buttons: number;
+    clickCount: number;
+    modifiers: number;
+    deltaX?: number;
+    deltaY?: number;
+    deltaMode?: number;
+    sourceWidth?: number;
+    sourceHeight?: number;
+}
+export interface KeyEnvelope {
+    kind: 'key';
+    eventType: 'keyDown' | 'rawKeyDown' | 'keyUp';
+    key: string;
+    code: string;
+    keyCode?: number;
+    text?: string;
+    modifiers: number;
+    isComposing?: boolean;
+}
+export interface TouchPoint {
+    x: number;
+    y: number;
+    id: number;
+    force?: number;
+    radiusX?: number;
+    radiusY?: number;
+}
+export interface TouchEnvelope {
+    kind: 'touch';
+    eventType: 'touchStart' | 'touchMove' | 'touchEnd' | 'touchCancel';
+    touchPoints: TouchPoint[];
+    modifiers: number;
+    sourceWidth?: number;
+    sourceHeight?: number;
+}
+export interface TextEnvelope {
+    kind: 'text';
+    text: string;
+}
+export interface ImeEnvelope {
+    kind: 'ime';
+    eventType: 'start' | 'update' | 'commit';
+    imeText?: string;
+    text?: string;
+    selectionStart?: number;
+    selectionEnd?: number;
+}
+export type InputEnvelopeData = MouseEnvelope | KeyEnvelope | TouchEnvelope | TextEnvelope | ImeEnvelope;
+export interface BrowserInputWireEnvelope {
+    type: 'browser_input';
+    tabId?: string;
+    data: InputEnvelopeData;
+}
+export interface BrowserInputRejectedPayload {
+    kind: InputEnvelopeData['kind'];
+    tabId?: string;
+    reason: 'no_active_view' | 'unsupported_kind' | 'modifier_only_key' | 'host_not_ready' | 'malformed' | 'unknown';
+    message?: string;
+}

package/dist/input.js

@@ -0,0 +1,20 @@
+export const MOD_ALT = 1;
+export const MOD_CTRL = 2;
+export const MOD_META = 4;
+export const MOD_SHIFT = 8;
+export function modifierMask(e) {
+    return ((e.altKey ? MOD_ALT : 0) |
+        (e.ctrlKey ? MOD_CTRL : 0) |
+        (e.metaKey ? MOD_META : 0) |
+        (e.shiftKey ? MOD_SHIFT : 0));
+}
+export function cdpMouseButton(button) {
+    switch (button) {
+        case 0: return 'left';
+        case 1: return 'middle';
+        case 2: return 'right';
+        case 3: return 'back';
+        case 4: return 'forward';
+        default: return 'none';
+    }
+}

package/dist/message-types.d.ts

@@ -0,0 +1,10 @@
+export declare const BROWSER_WEB_TO_CLI_TYPES: readonly ["browser_input", "browser_navigate", "browser_back", "browser_forward", "browser_reload", "browser_stop", "browser_resize", "browser_tab_open", "browser_tab_close", "browser_tab_select", "browser_set_bounds", "browser_set_device_profile", "browser_preflight", "browser_snapshot", "browser_webrtc_answer", "browser_webrtc_attach", "browser_webrtc_ice_config", "browser_resume_driver", "browser_lease_release", "browser_agent_task", "browser_agent_approve"];
+export declare const BROWSER_CLI_TO_WEB_TYPES: readonly ["browser_tab_state", "browser_navigation_state", "browser_error", "browser_resize_ack", "browser_preflight_result", "browser_webrtc_offer", "browser_driver_state", "browser_status", "browser_state_update", "browser_session_reset", "browser_input_rejected", "browser_input_focus", "browser_agent_proposed", "browser_agent_step", "browser_agent_done"];
+export declare const BROWSER_BIDIRECTIONAL_TYPES: readonly ["browser_webrtc_ice", "browser_webrtc_state"];
+export type BrowserWebToCliType = (typeof BROWSER_WEB_TO_CLI_TYPES)[number];
+export type BrowserCliToWebType = (typeof BROWSER_CLI_TO_WEB_TYPES)[number];
+export type BrowserBidirectionalType = (typeof BROWSER_BIDIRECTIONAL_TYPES)[number];
+export type BrowserMessageType = BrowserWebToCliType | BrowserCliToWebType | BrowserBidirectionalType;
+export declare function isBrowserMessageType(type: unknown): type is BrowserMessageType;
+export declare const AGENT_TAB_STATE_TYPES: readonly ["agent_tab_state"];
+export type AgentTabStateType = (typeof AGENT_TAB_STATE_TYPES)[number];

package/dist/message-types.js

@@ -0,0 +1,45 @@
+export const BROWSER_WEB_TO_CLI_TYPES = [
+    'browser_input',
+    'browser_navigate',
+    'browser_back',
+    'browser_forward',
+    'browser_reload',
+    'browser_stop',
+    'browser_resize',
+    'browser_tab_open',
+    'browser_tab_close',
+    'browser_tab_select',
+    'browser_set_bounds',
+    'browser_set_device_profile',
+    'browser_preflight',
+    'browser_snapshot',
+    'browser_webrtc_answer',
+    'browser_webrtc_attach',
+    'browser_webrtc_ice_config',
+    'browser_resume_driver',
+    'browser_lease_release',
+    'browser_agent_task',
+    'browser_agent_approve',
+];
+export const BROWSER_CLI_TO_WEB_TYPES = [
+    'browser_tab_state',
+    'browser_navigation_state',
+    'browser_error',
+    'browser_resize_ack',
+    'browser_preflight_result',
+    'browser_webrtc_offer',
+    'browser_driver_state',
+    'browser_status',
+    'browser_state_update',
+    'browser_session_reset',
+    'browser_input_rejected',
+    'browser_input_focus',
+    'browser_agent_proposed',
+    'browser_agent_step',
+    'browser_agent_done',
+];
+export const BROWSER_BIDIRECTIONAL_TYPES = ['browser_webrtc_ice', 'browser_webrtc_state'];
+export function isBrowserMessageType(type) {
+    return typeof type === 'string' && type.startsWith('browser_');
+}
+export const AGENT_TAB_STATE_TYPES = ['agent_tab_state'];

package/dist/preflight.d.ts

@@ -0,0 +1,31 @@
+export type PlatformName = 'aix' | 'android' | 'darwin' | 'freebsd' | 'haiku' | 'linux' | 'openbsd' | 'sunos' | 'win32' | 'cygwin' | 'netbsd' | (string & {});
+export type BrowserCheckId = 'chromium' | 'electron' | 'electron-host-dist' | 'xvfb' | 'pipewire' | 'chromium-libs' | 'chrome-sandbox' | (string & {});
+export interface BrowserMissingCheck {
+    id: BrowserCheckId;
+    label: string;
+    reason?: string | null;
+    fixCommands: string[];
+    advisory?: boolean;
+}
+export interface BrowserPreflightResultPayload {
+    ok: boolean;
+    platform?: PlatformName;
+    packageManager?: string | null;
+    chromiumInstalling?: boolean;
+    missing?: BrowserMissingCheck[];
+    message?: string;
+}
+export type PreflightState = {
+    status: 'unknown';
+} | {
+    status: 'ok';
+} | {
+    status: 'missing';
+    missing: BrowserMissingCheck[];
+    platform?: PlatformName;
+    packageManager?: string | null;
+    chromiumInstalling?: boolean;
+} | {
+    status: 'error';
+    message: string;
+};

package/dist/preflight.js

@@ -0,0 +1 @@
+export {};

package/dist/state.d.ts

@@ -0,0 +1,13 @@
+import type { BrowserNavigationState, BrowserTab } from './tabs.js';
+export interface BrowserStateUpdatePayload {
+    tabs?: BrowserTab[];
+    currentTabId?: string | null;
+    navigation?: BrowserNavigationStatePatch;
+}
+export interface BrowserNavigationStatePatch extends Partial<BrowserNavigationState> {
+    tabId: string;
+}
+export interface BrowserSessionResetPayload {
+    reason: 'host_crashed' | 'host_stopped' | 'host_restarted';
+    message?: string;
+}

package/dist/state.js

@@ -0,0 +1 @@
+export {};

package/dist/tabs.d.ts

@@ -0,0 +1,30 @@
+import type { DeviceProfile } from './viewport.js';
+export type BrowserConnectionState = 'idle' | 'connecting' | 'connected' | 'host-starting' | 'error';
+export interface BrowserTab {
+    id: string;
+    url: string;
+    title: string;
+    favicon?: string;
+    isLoading: boolean;
+    canGoBack: boolean;
+    canGoForward: boolean;
+    error?: string;
+    deviceProfile?: DeviceProfile;
+}
+export interface BrowserNavigationState {
+    url: string;
+    title: string;
+    isLoading: boolean;
+    canGoBack: boolean;
+    canGoForward: boolean;
+}
+export interface BrowserTabsPayload {
+    tabs: BrowserTab[];
+    currentTabId: string | null;
+}
+export interface BrowserNavigationStatePayload extends Partial<BrowserNavigationState> {
+    tabId: string;
+}
+export interface BrowserTabId {
+    id: string;
+}

package/dist/tabs.js

@@ -0,0 +1 @@
+export {};

package/dist/viewport.d.ts

@@ -0,0 +1,30 @@
+export interface BrowserViewport {
+    width: number;
+    height: number;
+}
+export interface BrowserBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    mobile?: boolean;
+    deviceScaleFactor?: number;
+}
+export interface BrowserSessionBounds extends BrowserBounds {
+    sessionId?: string;
+}
+export interface FrameViewport {
+    offsetTop: number;
+    pageScaleFactor: number;
+    deviceWidth: number;
+    deviceHeight: number;
+}
+export type DeviceFormFactor = 'desktop' | 'mobile';
+export interface DeviceProfile {
+    formFactor: DeviceFormFactor;
+    width: number;
+    height: number;
+    label: string;
+}
+export declare const DEVICE_PROFILES: Record<DeviceFormFactor, DeviceProfile>;
+export declare function deviceProfileFor(formFactor: DeviceFormFactor): DeviceProfile;

package/dist/viewport.js

@@ -0,0 +1,7 @@
+export const DEVICE_PROFILES = {
+    desktop: { formFactor: 'desktop', width: 1280, height: 720, label: 'Desktop' },
+    mobile: { formFactor: 'mobile', width: 390, height: 844, label: 'Mobile' },
+};
+export function deviceProfileFor(formFactor) {
+    return DEVICE_PROFILES[formFactor];
+}

package/dist/webrtc.d.ts

@@ -0,0 +1,32 @@
+export type WebrtcConnectionState = 'negotiating' | 'connected' | 'failed' | 'closed';
+export type SelectedCandidateType = 'host' | 'srflx' | 'prflx' | 'relay' | null;
+export interface RTCIceServerLike {
+    urls: string | string[];
+    username?: string;
+    credential?: string;
+}
+export interface IceCandidateInit {
+    candidate?: string;
+    sdpMLineIndex?: number | null;
+    sdpMid?: string | null;
+    usernameFragment?: string | null;
+}
+export type BrowserSignalEnvelope = {
+    kind: 'offer';
+    sessionId: string;
+    sdp: string;
+} | {
+    kind: 'answer';
+    sessionId: string;
+    sdp: string;
+} | {
+    kind: 'ice';
+    sessionId: string;
+    candidate: IceCandidateInit | null;
+} | {
+    kind: 'state';
+    sessionId: string;
+    state: WebrtcConnectionState;
+    reason?: string;
+    selectedCandidateType?: SelectedCandidateType;
+};

package/dist/webrtc.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@minionry/browser-types",
+  "version": "0.1.8",
+  "description": "Shared types used by Minionry packages.",
+  "license": "SEE LICENSE IN LICENSE",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./tabs": {
+      "types": "./dist/tabs.d.ts",
+      "import": "./dist/tabs.js",
+      "default": "./dist/tabs.js"
+    },
+    "./input": {
+      "types": "./dist/input.d.ts",
+      "import": "./dist/input.js",
+      "default": "./dist/input.js"
+    },
+    "./webrtc": {
+      "types": "./dist/webrtc.d.ts",
+      "import": "./dist/webrtc.js",
+      "default": "./dist/webrtc.js"
+    },
+    "./preflight": {
+      "types": "./dist/preflight.d.ts",
+      "import": "./dist/preflight.js",
+      "default": "./dist/preflight.js"
+    },
+    "./viewport": {
+      "types": "./dist/viewport.d.ts",
+      "import": "./dist/viewport.js",
+      "default": "./dist/viewport.js"
+    },
+    "./state": {
+      "types": "./dist/state.d.ts",
+      "import": "./dist/state.js",
+      "default": "./dist/state.js"
+    },
+    "./message-types": {
+      "types": "./dist/message-types.d.ts",
+      "import": "./dist/message-types.js",
+      "default": "./dist/message-types.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "gitHead": "b790f8b643da7b63c57bf12e804dd4a0eba7f312"
+}