@memberjunction/remote-browser-base 0.0.1 → 5.42.0

package/dist/remote-browser-session.d.ts

@@ -0,0 +1,488 @@
+/**
+ * The live-session contract for the Remote Browser channel and the self-contained, strongly-typed
+ * action / input / output payloads it carries.
+ *
+ * These types are defined **self-contained here** (no dependency on `@memberjunction/computer-use` or
+ * Playwright) so this Base package stays universal — usable client *and* server. The server package
+ * and the backend drivers (which depend on `@memberjunction/computer-use`) *implement*
+ * {@link IRemoteBrowserSession} against a real CDP-connected browser; this package only declares the
+ * shape both sides agree on.
+ *
+ * @see `/plans/realtime/realtime-bridges-architecture.md` §4d (the Remote Browser channel) and §4d-i
+ * (the one-primitive-CDP build decision).
+ */
+import type { UserInfo } from '@memberjunction/core';
+import type { RemoteBrowserControlStrategy } from './control.js';
+/**
+ * Navigate the browser to a URL.
+ */
+export interface RemoteBrowserNavigateAction {
+    Kind: 'navigate';
+    /** The absolute URL to load. */
+    Url: string;
+}
+/**
+ * Click an element. Identify the target either by CSS `Selector` or by viewport coordinates
+ * (`X` / `Y`); a driver prefers `Selector` when both are present.
+ */
+export interface RemoteBrowserClickAction {
+    Kind: 'click';
+    /** Optional CSS selector identifying the element to click. */
+    Selector?: string;
+    /** Optional viewport X coordinate (used when no `Selector` is given). */
+    X?: number;
+    /** Optional viewport Y coordinate (used when no `Selector` is given). */
+    Y?: number;
+}
+/**
+ * Type text. When `Selector` is provided the driver focuses that element first; otherwise the text is
+ * sent to the currently-focused element.
+ */
+export interface RemoteBrowserTypeAction {
+    Kind: 'type';
+    /** The text to type. */
+    Text: string;
+    /** Optional CSS selector to focus before typing. */
+    Selector?: string;
+}
+/**
+ * Press a single key or key-combination (e.g. `'Enter'`, `'Escape'`, `'Control+A'`).
+ */
+export interface RemoteBrowserKeyAction {
+    Kind: 'key';
+    /** The key (or combination) to press, in Playwright/CDP key syntax. */
+    Key: string;
+}
+/**
+ * Scroll the viewport (by `DeltaX` / `DeltaY` pixels) or scroll a specific element into view (by
+ * `Selector`). At least one of the three should be supplied; a driver scrolls `Selector` into view
+ * when present, otherwise applies the deltas.
+ */
+export interface RemoteBrowserScrollAction {
+    Kind: 'scroll';
+    /** Horizontal scroll distance in pixels (positive = right). */
+    DeltaX?: number;
+    /** Vertical scroll distance in pixels (positive = down). */
+    DeltaY?: number;
+    /** Optional CSS selector to scroll into view instead of applying deltas. */
+    Selector?: string;
+}
+/**
+ * Navigate back in history.
+ */
+export interface RemoteBrowserBackAction {
+    Kind: 'back';
+}
+/**
+ * Navigate forward in history.
+ */
+export interface RemoteBrowserForwardAction {
+    Kind: 'forward';
+}
+/**
+ * Wait — either for a fixed duration (`Ms`) or until an element matching `Selector` appears. At least
+ * one should be supplied; a driver waits for `Selector` when present, otherwise sleeps for `Ms`.
+ */
+export interface RemoteBrowserWaitAction {
+    Kind: 'wait';
+    /** Fixed wait in milliseconds. */
+    Ms?: number;
+    /** Optional CSS selector to wait for instead of a fixed duration. */
+    Selector?: string;
+}
+/**
+ * The full agent action vocabulary — a discriminated union over the `Kind` field. The realtime agent
+ * emits these as tool calls and the channel's session executes them over CDP. Strongly typed with no
+ * `any`; narrow on `action.Kind` to access the kind-specific fields.
+ */
+export type RemoteBrowserAction = RemoteBrowserNavigateAction | RemoteBrowserClickAction | RemoteBrowserTypeAction | RemoteBrowserKeyAction | RemoteBrowserScrollAction | RemoteBrowserBackAction | RemoteBrowserForwardAction | RemoteBrowserWaitAction;
+/**
+ * The outcome of executing a {@link RemoteBrowserAction} (or {@link IRemoteBrowserSession.Navigate}).
+ */
+export interface RemoteBrowserActionResult {
+    /** Whether the action completed successfully. */
+    Success: boolean;
+    /** The page URL after the action, when known. */
+    CurrentUrl?: string;
+    /** Optional human-readable detail (an error message on failure, a note on success). */
+    Detail?: string;
+}
+/** One progress update from a goal run — emitted per perceive-act step (transport-neutral). */
+export interface RemoteBrowserGoalProgress {
+    /** 1-based step number. */
+    Step: number;
+    /** A short, model-safe human-readable note (e.g. the controller's reasoning summary). */
+    Message: string;
+    /** The page URL at this step, when known. */
+    Url?: string;
+}
+/**
+ * Options for {@link IRemoteBrowserSession.RunComputerUseGoal}. Transport-neutral — concrete model
+ * selection (vision/action controller, judge) is resolved by the goal engine the CDP layer binds, so
+ * this base type carries no computer-use SDK types.
+ */
+export interface RunComputerUseGoalOptions {
+    /** Optional URL to navigate to before the goal loop begins. */
+    StartUrl?: string;
+    /** Maximum perceive-act steps before the loop gives up. */
+    MaxSteps?: number;
+    /** Optional controller (vision/action) model id, when overriding the engine's auto-selection. */
+    ControllerModelId?: string;
+    /** Optional judge model id, when overriding the engine's auto-selection. */
+    JudgeModelId?: string;
+    /**
+     * Model-blind context object. Values are referenced by `{{path}}` label in the goal/actions and
+     * injected at the action-execution boundary — never seen by any model. (Wired in a later phase; see
+     * `plans/realtime/computer-use-remote-browser-blend.md` §4.)
+     */
+    Context?: Record<string, unknown>;
+    /** Invoked per step so the caller (e.g. a realtime voice session) can narrate progress. */
+    OnProgress?: (progress: RemoteBrowserGoalProgress) => void;
+    /** Abort signal — when aborted (barge-in), the goal loop stops cooperatively. */
+    Signal?: AbortSignal;
+    /**
+     * The MJ user the goal run executes as. The CDP layer forwards it to the bound goal engine so an
+     * MJ-aware engine (e.g. `MJComputerUseEngine`) runs its controller/judge prompts under this user
+     * (prompt-run logging, model access, credential resolution). Transport-neutral here — typed only as
+     * {@link UserInfo}, carrying no computer-use SDK types.
+     */
+    ContextUser?: UserInfo;
+    /**
+     * Optional parent `MJ: AI Agent Runs` id for observability. When set (with {@link AgentRunStepID}), an
+     * MJ-aware goal engine links the run's prompt runs to this agent run and nests them under the step.
+     */
+    AgentRunID?: string;
+    /**
+     * Optional parent `MJ: AI Agent Run Steps` id (the goal's step). When set (with {@link AgentRunID}), an
+     * MJ-aware goal engine nests a child `Prompt` step per prompt under it — grouping the goal's many prompt
+     * runs beneath a single step in the realtime agent run.
+     */
+    AgentRunStepID?: string;
+}
+/**
+ * The outcome of an autonomous, goal-driven browser run — either the computer-use loop
+ * ({@link IRemoteBrowserSession.RunComputerUseGoal}) or a backend's native AI control
+ * ({@link IRemoteBrowserSession.InvokeNativeAIControl}), unified by {@link resolveControlStrategy}.
+ */
+export interface RemoteBrowserGoalResult {
+    /** Whether the goal was achieved. */
+    Success: boolean;
+    /** Which control strategy executed the goal. */
+    Strategy?: RemoteBrowserControlStrategy;
+    /** The page URL when the run ended, when known. */
+    CurrentUrl?: string;
+    /** A terminal status label (e.g. `'Completed'`, `'MaxStepsReached'`, `'Impossible'`, `'Error'`). */
+    Status?: string;
+    /** Number of perceive-act steps executed (computer-use strategy). */
+    StepCount?: number;
+    /** Human-readable detail (judge feedback / error message). */
+    Detail?: string;
+}
+/**
+ * A single encoded viewport frame emitted by the live screencast (CDP `Page.startScreencast` for
+ * self-host, or a provider live-view stream). Frames feed the channel's ScreenOut media track when
+ * screen-sharing the browser into a meeting, or a panel in the MJ console.
+ */
+export interface RemoteBrowserScreencastFrame {
+    /** The frame image, Base64-encoded (typically JPEG/PNG per the backend). */
+    DataBase64: string;
+    /** Frame width in pixels. */
+    Width: number;
+    /** Frame height in pixels. */
+    Height: number;
+    /** Monotonically increasing sequence number for ordering / drop detection. */
+    SequenceNumber: number;
+}
+/**
+ * A single encoded chunk of audio streamed FROM the remote browser to the user — the soundtrack of
+ * whatever the browser is playing (e.g. a YouTube video the co-agent is demoing). The sibling of
+ * {@link RemoteBrowserScreencastFrame} for audio: chunks feed the channel's client-side audio player
+ * (a MediaSource fed `audio/webm;codecs=opus`).
+ *
+ * The default (Self-Hosted Chrome) capture path produces `'webm-opus'` chunks via an in-page
+ * `MediaRecorder`; `'opus'` / `'pcm16'` are reserved for future backend capture paths (e.g. a
+ * server-side virtual audio sink).
+ */
+export interface RemoteBrowserAudioChunk {
+    /** The encoded audio data, Base64-encoded (no `data:` prefix). */
+    DataBase64: string;
+    /** The codec / container of {@link DataBase64}. `'webm-opus'` for the default in-page recorder. */
+    Codec: 'webm-opus' | 'opus' | 'pcm16';
+    /** Sample rate in Hz (typically 48000 for the Opus path). */
+    SampleRate: number;
+    /** Channel count (1 = mono, 2 = stereo). */
+    Channels: number;
+    /** Monotonically increasing sequence number for ordering / drop detection / resync. */
+    SequenceNumber: number;
+    /** Approximate duration of this chunk in milliseconds, when known. */
+    DurationMs?: number;
+}
+/**
+ * A keyboard modifier key that can be held while a human input occurs. These ride on pointer clicks
+ * (so Shift-click text selection / Ctrl-click new-tab semantics relay faithfully) AND on key presses
+ * (so combos like Ctrl/Cmd+A select-all, Cmd+C / Cmd+V relay faithfully). `'Meta'` is the Command key
+ * on macOS / the Windows key elsewhere. Platform-agnostic at this layer — the CDP mapper translates to
+ * Playwright/CDP modifier syntax.
+ */
+export type RemoteBrowserModifierKey = 'Shift' | 'Control' | 'Alt' | 'Meta';
+/**
+ * A human pointer move into the browser viewport.
+ */
+export interface RemoteBrowserPointerMoveInput {
+    Kind: 'pointer-move';
+    /** Viewport X coordinate. */
+    X: number;
+    /** Viewport Y coordinate. */
+    Y: number;
+}
+/**
+ * A human pointer click into the browser viewport.
+ */
+export interface RemoteBrowserPointerClickInput {
+    Kind: 'pointer-click';
+    /** Viewport X coordinate. */
+    X: number;
+    /** Viewport Y coordinate. */
+    Y: number;
+    /** Which mouse button was used (defaults to `'left'` when omitted). */
+    Button?: 'left' | 'middle' | 'right';
+    /**
+     * Modifier keys held during the click (e.g. `['Shift']` for shift-click text selection). Omitted /
+     * empty means no modifiers.
+     */
+    Modifiers?: RemoteBrowserModifierKey[];
+}
+/**
+ * A human pointer-button press (mouse-down) at a viewport point WITHOUT a release — the start of a
+ * click-drag. Pairs with {@link RemoteBrowserPointerUpInput} (and any intervening
+ * {@link RemoteBrowserPointerMoveInput}s) to relay a drag, e.g. click-drag text selection in a field.
+ */
+export interface RemoteBrowserPointerDownInput {
+    Kind: 'pointer-down';
+    /** Viewport X coordinate. */
+    X: number;
+    /** Viewport Y coordinate. */
+    Y: number;
+    /** Which mouse button was pressed (defaults to `'left'` when omitted). */
+    Button?: 'left' | 'middle' | 'right';
+    /** Modifier keys held during the press. Omitted / empty means no modifiers. */
+    Modifiers?: RemoteBrowserModifierKey[];
+}
+/**
+ * A human pointer-button release (mouse-up) at a viewport point — the end of a click-drag started by a
+ * {@link RemoteBrowserPointerDownInput}.
+ */
+export interface RemoteBrowserPointerUpInput {
+    Kind: 'pointer-up';
+    /** Viewport X coordinate. */
+    X: number;
+    /** Viewport Y coordinate. */
+    Y: number;
+    /** Which mouse button was released (defaults to `'left'` when omitted). */
+    Button?: 'left' | 'middle' | 'right';
+    /** Modifier keys held during the release. Omitted / empty means no modifiers. */
+    Modifiers?: RemoteBrowserModifierKey[];
+}
+/**
+ * A human key press routed into the browser during takeover.
+ */
+export interface RemoteBrowserKeyInput {
+    Kind: 'key';
+    /** The key (or combination) pressed, in Playwright/CDP key syntax. */
+    Key: string;
+    /**
+     * Modifier keys held during the press (e.g. `['Control']` with `Key: 'a'` for select-all). The
+     * mapper composes these with `Key` into a single Playwright/CDP chord. Omitted / empty means the
+     * `Key` is pressed on its own.
+     */
+    Modifiers?: RemoteBrowserModifierKey[];
+}
+/**
+ * A block of text the human pastes INTO the browser during takeover — the human-input twin of the
+ * agent's {@link RemoteBrowserTypeAction}. The text is inserted into the remote page's currently-focused
+ * element (no key-by-key synthesis), which is how VNC/remote-desktop paste works: the viewer reads the
+ * LOCAL clipboard on a `paste` event and relays the text here, sidestepping the isolated remote clipboard.
+ */
+export interface RemoteBrowserTextInput {
+    Kind: 'text';
+    /** The text inserted verbatim into the remote browser's focused element (for human paste). */
+    Text: string;
+}
+/**
+ * A human mouse-wheel / trackpad scroll into the browser viewport (Magic Mouse scroll, trackpad
+ * two-finger scroll, wheel). `X` / `Y` are the viewport pixel position the scroll occurred over (so a
+ * scroll targets the element under the pointer); `DeltaX` / `DeltaY` are the scroll deltas in pixels
+ * (positive `DeltaY` = down, positive `DeltaX` = right — matching the DOM `WheelEvent` convention).
+ */
+export interface RemoteBrowserScrollInput {
+    Kind: 'scroll';
+    /** Viewport X coordinate the scroll occurred over. */
+    X: number;
+    /** Viewport Y coordinate the scroll occurred over. */
+    Y: number;
+    /** Horizontal scroll delta in pixels (positive = right). */
+    DeltaX: number;
+    /** Vertical scroll delta in pixels (positive = down). */
+    DeltaY: number;
+}
+/**
+ * The full human-takeover input vocabulary — a discriminated union over `Kind`. When a human "grabs
+ * the wheel" in `Collaborative` (or watches in `ViewOnly`) their pointer/keyboard/scroll events arrive
+ * as these and route into the backend browser via {@link IRemoteBrowserSession.RouteHumanInput}.
+ * Strongly typed with no `any`; narrow on `input.Kind`.
+ */
+export type RemoteBrowserHumanInput = RemoteBrowserPointerMoveInput | RemoteBrowserPointerClickInput | RemoteBrowserPointerDownInput | RemoteBrowserPointerUpInput | RemoteBrowserKeyInput | RemoteBrowserTextInput | RemoteBrowserScrollInput;
+/**
+ * A live handle to a single remote-browser session, returned by
+ * {@link import('./base-remote-browser-provider.js').BaseRemoteBrowserProvider.Connect}.
+ *
+ * The **core** methods (`GetCdpEndpoint`, `Navigate`, `ExecuteAction`, `CaptureScreenshot`,
+ * `GetCurrentUrl`, `Close`) rest on the universal CDP substrate every backend provides and are always
+ * available. The remaining methods are **capability-gated** (feature-gated, documented per-method):
+ * the engine checks the provider's `SupportedFeatures` flag before calling them, and a backend that
+ * cannot satisfy a feature should reject/throw {@link
+ * import('./capability-errors.js').RemoteBrowserCapabilityNotSupportedError}.
+ *
+ * This is a pure interface — the concrete implementation lives in the server package / drivers (which
+ * own the Playwright + CDP machinery).
+ */
+export interface IRemoteBrowserSession {
+    /**
+     * Returns the Chrome DevTools Protocol endpoint for this session — the one primitive every
+     * backend exposes and the engine's computer-use loop connects to.
+     *
+     * @returns The CDP websocket/connect endpoint URL.
+     */
+    GetCdpEndpoint(): string;
+    /**
+     * Navigates the browser to a URL. Convenience over {@link IRemoteBrowserSession.ExecuteAction}
+     * with a `navigate` action.
+     *
+     * @param url The absolute URL to load.
+     * @returns The action result (success + resulting URL).
+     */
+    Navigate(url: string): Promise<RemoteBrowserActionResult>;
+    /**
+     * Executes a single agent {@link RemoteBrowserAction} over CDP.
+     *
+     * @param action The action to perform; narrow on `action.Kind`.
+     * @returns The action result.
+     */
+    ExecuteAction(action: RemoteBrowserAction): Promise<RemoteBrowserActionResult>;
+    /**
+     * Captures a one-off screenshot of the current viewport.
+     *
+     * @returns The screenshot image, Base64-encoded.
+     */
+    CaptureScreenshot(): Promise<string>;
+    /**
+     * Returns the browser's current URL synchronously (last known to the session).
+     *
+     * @returns The current page URL.
+     */
+    GetCurrentUrl(): string;
+    /**
+     * Closes the session and releases the backend browser/container. Idempotent — safe to call once
+     * teardown has already begun.
+     *
+     * @returns A promise that resolves once the session is fully torn down.
+     */
+    Close(): Promise<void>;
+    /**
+     * Returns an embeddable live-view URL so humans can watch the browser without MJ encoding frames.
+     *
+     * **Capability-gated** by `LiveView`. Backends without it reject with {@link
+     * import('./capability-errors.js').RemoteBrowserCapabilityNotSupportedError}.
+     *
+     * @returns The live-view URL.
+     */
+    GetLiveViewUrl(): Promise<string>;
+    /**
+     * Begins streaming encoded viewport frames to `onFrame` (the source for the channel's ScreenOut
+     * track).
+     *
+     * **Capability-gated** by `ScreenStreaming`. Backends without it reject.
+     *
+     * @param onFrame Invoked with each encoded {@link RemoteBrowserScreencastFrame}.
+     * @returns A promise that resolves once the screencast has started.
+     */
+    StartScreencast(onFrame: (frame: RemoteBrowserScreencastFrame) => void): Promise<void>;
+    /**
+     * Stops a screencast previously started with {@link IRemoteBrowserSession.StartScreencast}.
+     *
+     * **Capability-gated** by `ScreenStreaming`. Backends without it reject.
+     *
+     * @returns A promise that resolves once streaming has stopped.
+     */
+    StopScreencast(): Promise<void>;
+    /**
+     * Begins streaming the remote browser's tab audio to `onChunk` (the source for the channel's
+     * client-side audio player) — so a co-agent demoing a video/audio site is HEARD, not just seen.
+     *
+     * **Capability-gated by BACKEND IMPLEMENTATION** (v1): a backend without an audio-capture mechanism
+     * rejects with {@link import('./capability-errors.js').RemoteBrowserCapabilityNotSupportedError}, exactly
+     * like a non-streaming backend rejects {@link IRemoteBrowserSession.StartScreencast}. (A future
+     * metadata `AudioStreaming` feature flag is a documented fast-follow; v1 gates by whether the backend
+     * provides capture.)
+     *
+     * @param onChunk Invoked with each encoded {@link RemoteBrowserAudioChunk}.
+     * @returns A promise that resolves once the audio stream has started.
+     */
+    StartAudioStream(onChunk: (chunk: RemoteBrowserAudioChunk) => void): Promise<void>;
+    /**
+     * Stops an audio stream previously started with {@link IRemoteBrowserSession.StartAudioStream}.
+     *
+     * **Capability-gated by BACKEND IMPLEMENTATION** (v1). Backends without audio capture reject.
+     *
+     * @returns A promise that resolves once streaming has stopped.
+     */
+    StopAudioStream(): Promise<void>;
+    /**
+     * Routes a human takeover input (pointer move/click, key, scroll) into the backend browser.
+     *
+     * **Capability-gated** by `HumanTakeover` — only valid in `Collaborative` (and pointer-only
+     * observation in `ViewOnly`). Backends without it throw.
+     *
+     * @param input The human input event; narrow on `input.Kind`.
+     */
+    RouteHumanInput(input: RemoteBrowserHumanInput): void;
+    /**
+     * Reads the remote page's CURRENT text selection — the copy-out half of human clipboard support. The
+     * viewer captures a local `copy` / Cmd+C, calls this to read what the human has selected on the remote
+     * page, and writes the returned text to the LOCAL clipboard (again sidestepping the isolated remote
+     * clipboard, the mirror of the {@link RemoteBrowserTextInput} paste path).
+     *
+     * **Capability-gated** by `HumanTakeover` (copy-out belongs to the human-control path). Degrades
+     * gracefully: backends that cannot read the selection — or a page with nothing selected — resolve to
+     * `''` rather than throwing, so a best-effort copy never breaks the live view.
+     *
+     * @returns The selected text, or `''` when nothing is selected / the selection can't be read.
+     */
+    GetSelectionText(): Promise<string>;
+    /**
+     * Delegates a high-level natural-language intent to the backend's own AI-control harness (e.g.
+     * Browserbase Stagehand) instead of MJ's computer-use loop.
+     *
+     * **Capability-gated** by `NativeAIControl`. Backends without it reject.
+     *
+     * @param intent The natural-language intent (e.g. `'log in with the test account'`).
+     * @returns The action result.
+     */
+    InvokeNativeAIControl(intent: string): Promise<RemoteBrowserActionResult>;
+    /**
+     * Runs an autonomous, goal-driven browser loop (MJ's computer-use) against THIS session's live
+     * browser — the agent sets a high-level goal ("log in and download the latest invoice") and the
+     * computer-use vision/action model plans + executes it, instead of the caller issuing granular
+     * actions. The CDP layer hands its own (already-attached) `PlaywrightBrowserAdapter` to the engine,
+     * so the loop drives the very page the human is watching (no second browser/CDP attach).
+     *
+     * This is the default `'ComputerUse'` control strategy; the `'NativeAI'` strategy uses
+     * {@link IRemoteBrowserSession.InvokeNativeAIControl} instead. {@link resolveControlStrategy} picks.
+     *
+     * @param goal The natural-language goal.
+     * @param options Optional start URL, step cap, model overrides, and model-blind context.
+     * @returns The goal outcome (success, status, step count, final URL).
+     */
+    RunComputerUseGoal(goal: string, options?: RunComputerUseGoalOptions): Promise<RemoteBrowserGoalResult>;
+}
+//# sourceMappingURL=remote-browser-session.d.ts.map

package/dist/remote-browser-session.d.ts.map

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

package/dist/remote-browser-session.js

@@ -0,0 +1,15 @@
+/**
+ * The live-session contract for the Remote Browser channel and the self-contained, strongly-typed
+ * action / input / output payloads it carries.
+ *
+ * These types are defined **self-contained here** (no dependency on `@memberjunction/computer-use` or
+ * Playwright) so this Base package stays universal — usable client *and* server. The server package
+ * and the backend drivers (which depend on `@memberjunction/computer-use`) *implement*
+ * {@link IRemoteBrowserSession} against a real CDP-connected browser; this package only declares the
+ * shape both sides agree on.
+ *
+ * @see `/plans/realtime/realtime-bridges-architecture.md` §4d (the Remote Browser channel) and §4d-i
+ * (the one-primitive-CDP build decision).
+ */
+export {};
+//# sourceMappingURL=remote-browser-session.js.map

package/dist/remote-browser-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-browser-session.js","sourceRoot":"","sources":["../src/remote-browser-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/package.json

@@ -1,10 +1,35 @@
 {
   "name": "@memberjunction/remote-browser-base",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @memberjunction/remote-browser-base",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+  "type": "module",
+  "version": "5.42.0",
+  "description": "MemberJunction: Universal (client+server) base layer for the Remote Browser channel — the provider registry cache, the capability-gated BaseRemoteBrowserProvider driver contract, the CDP-backed live-session interface, and the control mode/strategy helpers that the server engine and backend drivers build on.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "start": "ts-node-dev src/index.ts",
+    "build": "tsc && tsc-alias -f",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "author": "MemberJunction.com",
+  "license": "ISC",
+  "dependencies": {
+    "@memberjunction/core": "5.42.0",
+    "@memberjunction/global": "5.42.0",
+    "@memberjunction/core-entities": "5.42.0",
+    "rxjs": "^7.8.2"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.11",
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/MJ"
+  }
 }