unity-open-mcp 0.1.0

package/dist/dialog-dismiss.js

@@ -0,0 +1,533 @@
+// M13 T4.5 — Unity launch-errors / Safe Mode dialog auto-dismissal.
+//
+// When Unity starts (or the bridge is not yet ready), the Editor can block
+// behind a native modal dialog — chiefly the "compile errors at launch" /
+// "Enter Safe Mode?" prompt. The MCP server then stalls on `/ping` /
+// compile-wait loops with no way to recover. This module probes the OS
+// desktop for that dialog and clicks **Ignore** while the LiveClient's
+// compile/bridge readiness wait is ticking — the same stall point agents hit
+// today (UCP bridge-wait pattern).
+//
+// Design (porting Unity-MCP's `launch-error-dismiss` approach):
+//   - Default: ENABLED (Unity-MCP parity — auto-dismiss unless turned off).
+//   - Opt out via UNITY_OPEN_MCP_NO_AUTO_DISMISS_LAUNCH_ERRORS=1.
+//   - Tunable timeout (30s) / interval (1.5s) — Unity-MCP defaults.
+//   - Each successful dismissal is logged once to stderr (title + button +
+//     platform) for auditability.
+//   - Cross-platform: Windows (Win32/PowerShell), macOS (AppleScript),
+//     Linux/X11 (xdotool).
+//
+// No runtime deps beyond node builtins (mcp-server/AGENTS.md "no runtime
+// deps beyond MCP SDK"): only child_process and os.
+import { execFile, execFileSync } from "node:child_process";
+import { platform as nodePlatform } from "node:os";
+/**
+ * Window-title fragments matched against the Unity launch-errors dialog.
+ * Both legacy and current strings are listed so the matcher stays resilient
+ * across Unity versions. The match is case-insensitive and substring-based
+ * — Unity's actual title varies by version but always contains one of these.
+ *
+ * Exposed so tests can assert the matcher knows about both spellings without
+ * grepping the implementation.
+ */
+export const LAUNCH_ERROR_DIALOG_TITLE_FRAGMENTS = [
+    "Safe Mode", // Unity 2020.2+ ("Enter Safe Mode?") — the launch-errors dialog on every modern Unity (2022 LTS, 6000.x)
+    "Compiler Errors", // Unity 2020+ ("Hold On" + "Compiler Errors on Launch")
+    "Hold On", // Generic Unity progress dialog wrapping the launch-errors variant
+    "Compile Errors", // Older Unity dialog spelling
+    "Scripts have compiler errors", // Unity 2022+ on Linux (window manager surfacing)
+];
+/** The button label this helper presses to dismiss the dialog. */
+export const DISMISS_BUTTON_LABEL = "Ignore";
+/**
+ * Producer-side prefixes for error messages that callers treat as permanent
+ * (the polling loop bails out instead of ticking again). Exported so the
+ * bailout matcher references the SAME literal as the producers.
+ */
+export const LINUX_XDOTOOL_MISSING_PREFIX = "xdotool not found on PATH";
+export const UNSUPPORTED_PLATFORM_PREFIX = "Unsupported platform for launch-errors auto-dismiss";
+/**
+ * Try once to find and dismiss the Unity launch-errors dialog on the current
+ * OS desktop. Pure-ish — performs a single OS call and returns; never blocks
+ * past the underlying syscall's own timeout.
+ *
+ * Library-safe: never throws (errors are returned in the `DismissOutcome`
+ * union), never writes to stdout/stderr, never mutates global state.
+ *
+ * The helper is platform-dispatched:
+ * - **Windows**: Win32 (`EnumWindows` / `EnumChildWindows` /
+ *   `GetWindowTextW` / `SendMessageW(BM_CLICK)`) driven from PowerShell so
+ *   we do not pull in a native node-gyp dependency.
+ * - **macOS**: AppleScript via `osascript`. Requires Accessibility
+ *   permission for the terminal / `node` binary once.
+ * - **Linux/X11**: `xdotool`. Wayland is deferred — the error message calls
+ *   this out so the user does not waste time debugging.
+ */
+export async function tryDismissLaunchErrorsDialog(platform = nodePlatform()) {
+    switch (platform) {
+        case "win32":
+            return tryDismissWindows();
+        case "darwin":
+            return tryDismissMacOS();
+        case "linux":
+            return tryDismissLinuxX11();
+        default:
+            return {
+                kind: "error",
+                message: `${UNSUPPORTED_PLATFORM_PREFIX}: ${platform}`,
+            };
+    }
+}
+// ---------------------------------------------------------------------------
+// Windows — Win32 via PowerShell
+// ---------------------------------------------------------------------------
+/**
+ * The PowerShell payload that probes for the Unity launch-errors dialog and
+ * clicks `Ignore` if found. Exported as a string (not a function) so tests
+ * can assert the script shape without launching PowerShell.
+ *
+ * Strategy:
+ *   1. P/Invoke `EnumWindows` to enumerate every visible top-level window
+ *      owned by `Unity.exe`.
+ *   2. Filter by title fragment (case-insensitive substring).
+ *   3. Walk child windows with `EnumChildWindows`, looking for a Button
+ *      whose text equals `Ignore`.
+ *   4. Send `BM_CLICK` (0x00F5) to the matched button. Preferred over a
+ *      synthesised mouse event — it works even if the user is mid-click in
+ *      another app and does not steal focus.
+ *
+ * The script writes a single-token result to stdout:
+ *   - `dismissed:<button>` on success
+ *   - `not-found` when no dialog was matched
+ *   - `error:<message>` on an unexpected exception
+ */
+export const WINDOWS_DISMISS_PS_SCRIPT = `
+$ErrorActionPreference = 'Stop'
+try {
+  if (-not ([System.Management.Automation.PSTypeName]'UnityOpenMcp.LaunchErrors.Dismisser').Type) {
+    Add-Type -TypeDefinition @"
+using System;
+using System.Collections.Generic;
+using System.Runtime.InteropServices;
+using System.Text;
+namespace UnityOpenMcp.LaunchErrors {
+  public static class Dismisser {
+    public delegate bool EnumWindowsProc(IntPtr hWnd, IntPtr lParam);
+    [DllImport("user32.dll")] static extern bool EnumWindows(EnumWindowsProc lpEnumFunc, IntPtr lParam);
+    [DllImport("user32.dll", CharSet=CharSet.Unicode)] static extern int GetWindowTextW(IntPtr hWnd, StringBuilder lpString, int nMaxCount);
+    [DllImport("user32.dll", CharSet=CharSet.Unicode)] static extern int GetClassNameW(IntPtr hWnd, StringBuilder lpClassName, int nMaxCount);
+    [DllImport("user32.dll")] static extern bool IsWindowVisible(IntPtr hWnd);
+    [DllImport("user32.dll")] static extern bool EnumChildWindows(IntPtr hWndParent, EnumWindowsProc lpEnumFunc, IntPtr lParam);
+    [DllImport("user32.dll")] static extern uint GetWindowThreadProcessId(IntPtr hWnd, out uint lpdwProcessId);
+    [DllImport("user32.dll", CharSet=CharSet.Unicode)] static extern IntPtr SendMessageW(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);
+    const uint BM_CLICK = 0x00F5;
+    static readonly string[] TitleFragments = new[] { ${LAUNCH_ERROR_DIALOG_TITLE_FRAGMENTS.map((f) => JSON.stringify(f)).join(", ")} };
+    static readonly string[] ButtonLabels = new[] { "${DISMISS_BUTTON_LABEL}", "&${DISMISS_BUTTON_LABEL}" };
+    public static string TryDismiss(int[] unityPids) {
+      var unityPidSet = new HashSet<uint>();
+      for (int i = 0; i < unityPids.Length; i++) unityPidSet.Add((uint)unityPids[i]);
+      IntPtr matchedDialog = IntPtr.Zero;
+      var sb = new StringBuilder(512);
+      EnumWindows((hWnd, lParam) => {
+        if (!IsWindowVisible(hWnd)) return true;
+        uint procId; GetWindowThreadProcessId(hWnd, out procId);
+        if (!unityPidSet.Contains(procId)) return true;
+        sb.Length = 0;
+        GetWindowTextW(hWnd, sb, sb.Capacity);
+        var text = sb.ToString();
+        foreach (var frag in TitleFragments) {
+          if (text.IndexOf(frag, StringComparison.OrdinalIgnoreCase) >= 0) {
+            matchedDialog = hWnd;
+            return false;
+          }
+        }
+        return true;
+      }, IntPtr.Zero);
+      if (matchedDialog == IntPtr.Zero) return "not-found";
+      IntPtr matchedButton = IntPtr.Zero;
+      EnumChildWindows(matchedDialog, (hWnd, lParam) => {
+        sb.Length = 0;
+        GetClassNameW(hWnd, sb, sb.Capacity);
+        if (sb.ToString() != "Button") return true;
+        sb.Length = 0;
+        GetWindowTextW(hWnd, sb, sb.Capacity);
+        var text = sb.ToString();
+        foreach (var label in ButtonLabels) {
+          if (string.Equals(text, label, StringComparison.OrdinalIgnoreCase)) {
+            matchedButton = hWnd;
+            return false;
+          }
+        }
+        return true;
+      }, IntPtr.Zero);
+      if (matchedButton == IntPtr.Zero) return "not-found";
+      SendMessageW(matchedButton, BM_CLICK, IntPtr.Zero, IntPtr.Zero);
+      return "dismissed:${DISMISS_BUTTON_LABEL}";
+    }
+  }
+}
+"@
+  }
+  $unityPids = @(Get-Process -Name 'Unity' -ErrorAction SilentlyContinue | ForEach-Object { [int]$_.Id })
+  if ($unityPids.Count -eq 0) { Write-Output 'not-found'; return }
+  Write-Output ([UnityOpenMcp.LaunchErrors.Dismisser]::TryDismiss([int[]]$unityPids))
+} catch {
+  Write-Output ('error:' + $_.Exception.Message)
+}
+`;
+async function tryDismissWindows() {
+    return new Promise((resolve) => {
+        execFile("powershell", ["-NoProfile", "-NonInteractive", "-Command", WINDOWS_DISMISS_PS_SCRIPT], { timeout: 5000, windowsHide: true }, (err, stdout) => {
+            if (err) {
+                // ETIMEDOUT, ENOENT (powershell missing), etc. Treat as transient.
+                resolve({ kind: "error", message: err.message });
+                return;
+            }
+            resolve(parseDismissOutput(stdout));
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// macOS — AppleScript via osascript
+// ---------------------------------------------------------------------------
+/**
+ * The AppleScript snippet used for the macOS dismiss path. Exposed as a
+ * string for testability.
+ *
+ * Strategy: iterate every window of the Unity application process and click
+ * the first button titled `Ignore`. If Unity is not running OR no matching
+ * button exists, the script reports `not-found`. Any AppleScript exception
+ * (e.g. Accessibility permission not granted) is reported as `error:<msg>`.
+ *
+ * Requires the Terminal / `node` binary to have been granted Accessibility
+ * permission in System Settings → Privacy & Security → Accessibility.
+ */
+export const MACOS_DISMISS_APPLESCRIPT = `
+on run
+  try
+    tell application "System Events"
+      if not (exists process "Unity") then
+        return "not-found"
+      end if
+      tell process "Unity"
+        repeat with w in windows
+          try
+            if exists (button "${DISMISS_BUTTON_LABEL}" of w) then
+              click button "${DISMISS_BUTTON_LABEL}" of w
+              return "dismissed:${DISMISS_BUTTON_LABEL}"
+            end if
+          end try
+        end repeat
+      end tell
+    end tell
+    return "not-found"
+  on error errMsg
+    return "error:" & errMsg
+  end try
+end run
+`;
+async function tryDismissMacOS() {
+    return new Promise((resolve) => {
+        execFile("osascript", ["-e", MACOS_DISMISS_APPLESCRIPT], { timeout: 5000 }, (err, stdout) => {
+            if (err) {
+                resolve({ kind: "error", message: err.message });
+                return;
+            }
+            resolve(parseDismissOutput(stdout));
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// Linux/X11 — xdotool
+// ---------------------------------------------------------------------------
+/**
+ * Whether `xdotool` is on PATH. Cached per process so the polling loop pays
+ * the lookup cost at most once.
+ */
+let xdotoolPresence;
+function isXdotoolAvailable() {
+    if (xdotoolPresence !== undefined)
+        return xdotoolPresence;
+    try {
+        execFileSync("xdotool", ["--version"], {
+            stdio: "ignore",
+            timeout: 2000,
+        });
+        xdotoolPresence = true;
+    }
+    catch {
+        xdotoolPresence = false;
+    }
+    return xdotoolPresence;
+}
+/**
+ * Reset the cached `xdotool` presence flag. Test-only — production code
+ * never needs to call this.
+ */
+export function _resetXdotoolPresenceForTests() {
+    xdotoolPresence = undefined;
+}
+/**
+ * Escape a literal string for safe use in `xdotool search --name`. The
+ * argument is interpreted as a regex; without escaping, a future fragment
+ * containing metacharacters would silently change the match semantics.
+ */
+export function regexEscapeForXdotool(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Look up currently-running Unity Editor PIDs on the local box. Used by the
+ * Linux/X11 path to scope the title-fragment match to Unity processes only.
+ * Returns an empty array on any failure. Pure / idempotent / never throws.
+ */
+function getUnityPidsLinux() {
+    try {
+        const stdout = execFileSync("pgrep", ["-x", "Unity"], {
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 1000,
+            encoding: "utf8",
+        });
+        return stdout
+            .split(/\r?\n/)
+            .map((s) => parseInt(s.trim(), 10))
+            .filter((n) => Number.isFinite(n) && n > 0);
+    }
+    catch {
+        return [];
+    }
+}
+async function tryDismissLinuxX11() {
+    if (!isXdotoolAvailable()) {
+        return {
+            kind: "error",
+            message: `${LINUX_XDOTOOL_MISSING_PREFIX}. Install it (e.g. \`sudo apt-get install xdotool\`) to enable Unity launch-errors auto-dismiss on Linux/X11. Wayland is not yet supported.`,
+        };
+    }
+    const unityPids = new Set(getUnityPidsLinux());
+    if (unityPids.size === 0) {
+        return { kind: "not-found" };
+    }
+    // Strategy:
+    //   1. `xdotool search --name '<regex-escaped fragment>'` once per fragment.
+    //   2. Filter candidate windows to those owned by a Unity PID via
+    //      `xdotool getwindowpid <winId>` so we never act on an unrelated
+    //      top-level window with a colliding title.
+    //   3. Activate the window and send Return to click the focused button.
+    //      The Unity launch-errors dialog defaults focus to the leftmost
+    //      button, which IS `Ignore`.
+    return new Promise((resolve) => {
+        const fragments = LAUNCH_ERROR_DIALOG_TITLE_FRAGMENTS;
+        let idx = 0;
+        const tryNext = () => {
+            if (idx >= fragments.length) {
+                resolve({ kind: "not-found" });
+                return;
+            }
+            const fragment = fragments[idx++];
+            execFile("xdotool", ["search", "--name", regexEscapeForXdotool(fragment)], { timeout: 2000 }, (err, stdout) => {
+                if (err || !stdout.trim()) {
+                    tryNext();
+                    return;
+                }
+                const candidateIds = stdout.trim().split(/\s+/).filter(Boolean);
+                findUnityOwnedWindow(candidateIds, unityPids, (winId) => {
+                    if (!winId) {
+                        tryNext();
+                        return;
+                    }
+                    execFile("xdotool", [
+                        "windowactivate",
+                        "--sync",
+                        winId,
+                        "key",
+                        "--clearmodifiers",
+                        "Return",
+                    ], { timeout: 2000 }, (activateErr) => {
+                        if (activateErr) {
+                            resolve({
+                                kind: "error",
+                                message: `xdotool failed to dismiss window ${winId}: ${activateErr.message}`,
+                            });
+                            return;
+                        }
+                        resolve({ kind: "dismissed", button: DISMISS_BUTTON_LABEL });
+                    });
+                });
+            });
+        };
+        tryNext();
+    });
+}
+/**
+ * Walk `candidateIds` and call `done(winId)` with the first window owned by
+ * a Unity PID, or `done(undefined)` if none match. Sequential — the list is
+ * small and parallelism buys nothing meaningful here.
+ */
+function findUnityOwnedWindow(candidateIds, unityPids, done) {
+    let idx = 0;
+    const next = () => {
+        if (idx >= candidateIds.length) {
+            done(undefined);
+            return;
+        }
+        const winId = candidateIds[idx++];
+        execFile("xdotool", ["getwindowpid", winId], { timeout: 1000 }, (err, stdout) => {
+            if (err) {
+                next();
+                return;
+            }
+            const pid = parseInt(stdout.trim(), 10);
+            if (Number.isFinite(pid) && unityPids.has(pid)) {
+                done(winId);
+                return;
+            }
+            next();
+        });
+    };
+    next();
+}
+// ---------------------------------------------------------------------------
+// Shared parser
+// ---------------------------------------------------------------------------
+/**
+ * Parse the single-token contract every platform-specific dispatcher writes
+ * to stdout. Inspects the LAST non-empty line of stdout, not the whole
+ * buffer: a stray PowerShell warning, `osascript` deprecation notice, or
+ * `xdotool` chatter printed before the contract token must not misclassify
+ * the result as `not-found`.
+ *
+ * Contract:
+ *   - `dismissed:<button>` → `{ kind: "dismissed", button }`
+ *   - `not-found`          → `{ kind: "not-found" }`
+ *   - `error:<message>`    → `{ kind: "error", message }`
+ *   - any other / empty    → `{ kind: "not-found" }` (defensive — a transient
+ *     parse miss is treated as "not yet visible" rather than aborting)
+ */
+export function parseDismissOutput(stdout) {
+    const lines = stdout
+        .split(/\r?\n/)
+        .map((l) => l.trim())
+        .filter((l) => l.length > 0);
+    if (lines.length === 0)
+        return { kind: "not-found" };
+    const last = lines[lines.length - 1];
+    if (last === "not-found")
+        return { kind: "not-found" };
+    if (last.startsWith("dismissed:")) {
+        const button = last.substring("dismissed:".length);
+        return { kind: "dismissed", button: button || DISMISS_BUTTON_LABEL };
+    }
+    if (last.startsWith("error:")) {
+        return { kind: "error", message: last.substring("error:".length) };
+    }
+    return { kind: "not-found" };
+}
+// ===========================================================================
+// Polling loop + config
+// ===========================================================================
+/** Default dismiss probe timeout — Unity-MCP parity (30s overall budget). */
+export const DEFAULT_DISMISS_TIMEOUT_MS = 30_000;
+/** Default dismiss probe poll interval — Unity-MCP parity (1.5s tick). */
+export const DEFAULT_DISMISS_INTERVAL_MS = 1_500;
+/**
+ * Substring markers that identify a `kind: "error"` outcome as permanent for
+ * this run. When seen, the polling loop bails out after recording the error
+ * once; ticking again would just respawn the same doomed tool. Keep this list
+ * narrow — only conditions that cannot self-heal mid-launch belong here.
+ */
+const PERMANENT_DISMISS_ERROR_MARKERS = [
+    LINUX_XDOTOOL_MISSING_PREFIX,
+    UNSUPPORTED_PLATFORM_PREFIX,
+];
+function isPermanentDismissError(message) {
+    return PERMANENT_DISMISS_ERROR_MARKERS.some((m) => message.includes(m));
+}
+export function readDismissConfig(env = process.env) {
+    const enabled = env.UNITY_OPEN_MCP_NO_AUTO_DISMISS_LAUNCH_ERRORS !== "1";
+    return {
+        enabled,
+        timeoutMs: parsePositiveInt(env.UNITY_OPEN_MCP_DISMISS_TIMEOUT_MS, DEFAULT_DISMISS_TIMEOUT_MS),
+        intervalMs: parsePositiveInt(env.UNITY_OPEN_MCP_DISMISS_INTERVAL_MS, DEFAULT_DISMISS_INTERVAL_MS),
+    };
+}
+function parsePositiveInt(raw, fallback) {
+    if (raw === undefined || raw === "")
+        return fallback;
+    const n = parseInt(raw, 10);
+    if (!Number.isFinite(n) || n <= 0)
+        return fallback;
+    return n;
+}
+function defaultDismissLog(line) {
+    console.error(line);
+}
+/**
+ * Poll the OS desktop for the Unity launch-errors dialog and click `Ignore`
+ * every time the probe reports it as found. Returns once the abort signal
+ * has fired (authoritative readiness), the overall timeout has elapsed, or
+ * a permanent platform error has been observed.
+ *
+ * Re-entrant dismissals are supported: when the dialog re-appears after a
+ * successful click (resolver-fix → dialog-reappears cycle), each subsequent
+ * dismissal emits its own log line so the recurrence shows in the audit log.
+ *
+ * Never throws. Transient platform errors (a momentary syscall failure) are
+ * logged once and then suppressed; permanent errors bail out after the first
+ * occurrence so the helper does not spawn doomed tool invocations on a fixed
+ * budget.
+ *
+ * The loop keeps polling until aborted even when no dialog appears — unlike
+ * Unity-MCP's standalone `open` CLI, this loop runs CONCURRENTLY with the
+ * LiveClient compile wait. The compile wait's resolution (compiling → idle)
+ * is the authoritative "no more launch dialog" signal and aborts this loop.
+ */
+export async function pollAndDismissLaunchErrors(opts) {
+    const platform = opts.platform ?? nodePlatform();
+    const probe = opts.probe ?? tryDismissLaunchErrorsDialog;
+    const log = opts.log ?? defaultDismissLog;
+    const deadline = Date.now() + Math.max(0, opts.timeoutMs);
+    const interval = Math.max(50, opts.intervalMs);
+    const seenErrorMessages = new Set();
+    let aborted = opts.abortSignal?.aborted ?? false;
+    const onAbort = () => {
+        aborted = true;
+    };
+    opts.abortSignal?.addEventListener("abort", onAbort, { once: true });
+    try {
+        while (Date.now() < deadline && !aborted) {
+            const outcome = await probe(platform);
+            // Re-check exit conditions BEFORE applying the outcome: if abort fired
+            // (or the deadline lapsed) while `probe` was in flight, the in-flight
+            // result is stale and applying it would emit a misleading log.
+            if (aborted || Date.now() >= deadline)
+                break;
+            if (outcome.kind === "dismissed") {
+                log(`[unity-open-mcp] dismissed Unity launch-errors dialog ` +
+                    `(button=${outcome.button}, platform=${platform})`);
+                // Keep polling — the dialog may re-appear after the resolver fixes
+                // one error and surfaces the next.
+            }
+            else if (outcome.kind === "error") {
+                if (!seenErrorMessages.has(outcome.message)) {
+                    seenErrorMessages.add(outcome.message);
+                    log(`[unity-open-mcp] launch-errors auto-dismiss: ${outcome.message}`);
+                }
+                if (isPermanentDismissError(outcome.message)) {
+                    // No point ticking again — bail out.
+                    return;
+                }
+            }
+            const remaining = deadline - Date.now();
+            if (remaining <= 0 || aborted)
+                break;
+            await sleepMs(Math.min(interval, remaining));
+        }
+    }
+    finally {
+        opts.abortSignal?.removeEventListener("abort", onAbort);
+    }
+}
+function sleepMs(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=dialog-dismiss.js.map

package/dist/dialog-dismiss.js.map

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

package/dist/event-stream.d.ts

@@ -0,0 +1,60 @@
+export interface BridgeEvent {
+    seq: number;
+    ts: string;
+    type: "log" | "editor_state" | "ready" | "missed" | "close";
+    logType?: string;
+    message?: string;
+    stack?: string;
+    state?: string;
+    isCompiling?: boolean;
+    isPlaying?: boolean;
+}
+export interface PullResult {
+    subscriberId: string;
+    events: BridgeEvent[];
+    /** Count of events dropped from the queue before this pull (overflow). */
+    dropped: number;
+    /** Whether the SSE reader is currently connected. */
+    connected: boolean;
+    /** Whether this pull started the subscription (first call). */
+    started: boolean;
+    /** Last reconnect failure reason, when `connected` is false. */
+    lastError: string | null;
+}
+export declare class BridgeEventStream {
+    private readonly baseUrl;
+    private readonly authToken?;
+    private subscriberId;
+    private queue;
+    private dropped;
+    private connected;
+    private lastError;
+    private abortController;
+    private reconnectTimer;
+    private started;
+    constructor(baseUrl: string, subscriberId?: string, authToken?: string | undefined);
+    /**
+     * Start the SSE reader if it isn't running. Safe to call repeatedly; returns
+     * true when a fresh subscription was started this call.
+     */
+    ensureSubscription(): boolean;
+    private connect;
+    private pump;
+    private handleBlock;
+    /**
+     * Parse one SSE block (the text between two blank-line separators) into a
+     * BridgeEvent, or null when the block carries no data. Exposed for unit
+     * testing — the SSE reader loop calls it via handleBlock.
+     */
+    static parseSseBlock(block: string): BridgeEvent | null;
+    private enqueue;
+    private scheduleReconnect;
+    /** Drain all queued events. The subscription keeps running. */
+    drain(maxEvents: number): BridgeEvent[];
+    /** One-shot pull: start the subscription if needed and drain. */
+    pull(maxEvents: number): PullResult;
+    /** Stop the reader and clear state. Idempotent; used in tests. */
+    stop(): void;
+    get isConnected(): boolean;
+    get id(): string;
+}