@mcp-b/react-components 0.40.0 → 0.41.0

package/dist/components/agents-sdk/BrowserLiveScreen.d.ts

@@ -0,0 +1,135 @@
+import { ReactNode } from "react";
+
+//#region src/components/agents-sdk/BrowserLiveScreen.d.ts
+/** One claimed tab, as the synced claim records describe it. */
+type BrowserLiveScreenTab = {
+  tabId: number;
+  title?: string;
+  url?: string;
+};
+type BrowserLiveScreenSignal = {
+  viewerId: string;
+  payload: BrowserLiveScreenSignalPayload;
+};
+type BrowserLiveScreenSignalPayload = {
+  kind: "offer";
+  sdp: string;
+} | {
+  kind: "answer";
+  sdp: string;
+} | {
+  kind: "candidate";
+  candidate: RTCIceCandidateInit;
+} | {
+  kind: "close";
+};
+type BrowserLiveScreenFrameMetadata = {
+  deviceWidth: number;
+  deviceHeight: number;
+  offsetTop: number;
+};
+type BrowserLiveScreenStatus = {
+  kind: "streaming";
+  tabId: number;
+  streamGeneration: number;
+  metadata: BrowserLiveScreenFrameMetadata;
+  pageUrl?: string;
+  pageTitle?: string;
+} | {
+  kind: "idle";
+} | {
+  kind: "error";
+  message: string;
+};
+type BrowserLiveScreenInputEvent = {
+  kind: "mouse";
+  type: "mousePressed" | "mouseReleased" | "mouseMoved" | "mouseWheel";
+  x: number;
+  y: number;
+  button?: "none" | "left" | "middle" | "right" | "back" | "forward";
+  buttons?: number;
+  clickCount?: number;
+  deltaX?: number;
+  deltaY?: number;
+  modifiers?: number;
+} | {
+  kind: "key";
+  type: "keyDown" | "keyUp" | "rawKeyDown";
+  key?: string;
+  code?: string;
+  windowsVirtualKeyCode?: number;
+  text?: string;
+  modifiers?: number;
+} | {
+  kind: "text";
+  text: string;
+};
+type BrowserLiveScreenInput = {
+  tabId: number;
+  streamGeneration: number;
+  events: BrowserLiveScreenInputEvent[];
+};
+type BrowserLiveScreenCommand = {
+  kind: "selectTab";
+  tabId: number;
+} | {
+  kind: "navigate";
+  tabId: number;
+  action: "back" | "reload";
+} | {
+  kind: "open";
+  tabId: number;
+  url: string;
+};
+interface BrowserLiveScreenProtocol {
+  /** Data-channel label understood by the employee machine. */
+  dataChannelLabel: string;
+  /** Parses one machine status message; return null for unrelated data. */
+  parseStatus(this: void, value: unknown): BrowserLiveScreenStatus | null;
+  /** Serializes an exact-tab remote-input envelope for the employee machine. */
+  serializeInput(this: void, input: BrowserLiveScreenInput): string;
+  /** Serializes one drawn-browser command for the employee machine. */
+  serializeCommand(this: void, command: BrowserLiveScreenCommand): string;
+}
+interface BrowserLiveScreenProps {
+  /** Sends one opaque WebRTC signaling payload through the host's existing transport. */
+  sendSignal(this: void, signal: BrowserLiveScreenSignal): Promise<void>;
+  /** Subscribes to signaling payloads arriving from the employee machine. */
+  subscribeSignals(this: void, listener: (signal: BrowserLiveScreenSignal) => void): () => void;
+  /** Adapts the host's existing data-channel wire format. */
+  protocol: BrowserLiveScreenProtocol;
+  /** ICE servers for this viewer's peer. Absent means STUN-free loopback,
+   * which is what the extension side panel is. */
+  getIceServers?(this: void): Promise<RTCIceServer[]>;
+  /** Accessible name and visible label for the drawn browser panel. */
+  label?: ReactNode;
+  /** Accessible name for the transparent remote-input surface. */
+  controlLabel?: string;
+  /**
+   * The employee's claimed tabs, from the synchronized claim records. They are
+   * the drawn tab strip: the browser chrome around the stream is synthesized
+   * from state, because Chrome's screencast carries only page pixels.
+   */
+  tabs?: readonly BrowserLiveScreenTab[];
+  /** Claimed tab the host wants visible when the data channel becomes usable. */
+  requestedTabId?: number;
+}
+/**
+ * A complete interactive viewer for an employee's claimed browser tabs.
+ *
+ * The host supplies only signaling transport, ICE configuration, and claimed
+ * tab summaries. This component owns the peer connection, remote-input
+ * mapping, reconnect lifecycle, synthesized browser chrome, and cleanup.
+ */
+declare function BrowserLiveScreen({
+  sendSignal: sendHostSignal,
+  subscribeSignals,
+  protocol,
+  getIceServers,
+  label,
+  controlLabel,
+  tabs,
+  requestedTabId
+}: BrowserLiveScreenProps): import("react").JSX.Element;
+//#endregion
+export { BrowserLiveScreen, BrowserLiveScreenCommand, BrowserLiveScreenFrameMetadata, BrowserLiveScreenInput, BrowserLiveScreenInputEvent, BrowserLiveScreenProps, BrowserLiveScreenProtocol, BrowserLiveScreenSignal, BrowserLiveScreenSignalPayload, BrowserLiveScreenStatus, BrowserLiveScreenTab };