@qontinui/ui-bridge 0.17.0 → 0.19.0

package/dist/server/index.d.mts

@@ -1,30 +1,30 @@
-import { a as UIBridgeServerHandlers } from '../types-Bubo62kN.mjs';
-export { A as APIResponse, B as BrowserEventsResponse, C as CORSOptions, b as CapabilitiesResponse, c as ControlBatchRequest, d as ControlBatchResponse, e as ControlBatchStep, f as ControlBatchStepResult, D as DOMChangeEvent, E as ElementConditionSelector, g as ElementExpectRequest, h as ElementExpectResponse, i as EndpointCategory, j as EndpointInfo, H as HandlerContext, I as INTERACTION_RELAY_COMMAND_ACTIONS, k as InteractionRelayCommandAction, R as RateLimitOptions, l as RenderLogQuery, m as RouteDefinition, S as SpawnHeadlessRequest, n as SpawnHeadlessResponse, o as StateSummary, U as UIBridgeServerConfig, p as UI_BRIDGE_ROUTES, q as WaitForElementByConditionRequest, r as WaitForElementByConditionResponse, s as WaitForElementPredicate, t as WaitForElementRequest, u as WaitForElementSuccessResponse, v as WaitForRouteChangeRequest, w as WaitForRouteChangeResponse, W as WebSocketMessage, x as WebSocketMessageType } from '../types-Bubo62kN.mjs';
+import { a as UIBridgeServerHandlers, H as HandlerContext } from '../types-DNc31VlO.mjs';
+export { A as APIResponse, B as BrowserEventsResponse, C as CORSOptions, b as CapabilitiesResponse, c as ControlBatchRequest, d as ControlBatchResponse, e as ControlBatchStep, f as ControlBatchStepResult, D as DOMChangeEvent, E as ElementConditionSelector, g as ElementExpectRequest, h as ElementExpectResponse, i as EndpointCategory, j as EndpointInfo, I as INTERACTION_RELAY_COMMAND_ACTIONS, k as InteractionRelayCommandAction, P as PageEvaluateRequest, R as RateLimitOptions, l as RenderLogQuery, m as RouteDefinition, n as RunnerWindow, o as RunnerWindowsList, S as SpawnHeadlessRequest, p as SpawnHeadlessResponse, q as StateSummary, U as UIBridgeServerConfig, r as UI_BRIDGE_ROUTES, s as WaitForElementByConditionRequest, t as WaitForElementByConditionResponse, u as WaitForElementPredicate, v as WaitForElementRequest, w as WaitForElementSuccessResponse, x as WaitForRouteChangeRequest, y as WaitForRouteChangeResponse, W as WebSocketMessage, z as WebSocketMessageType } from '../types-DNc31VlO.mjs';
 export { ActionExecutorLike, CreateHandlersConfig, RegistryLike, closeAllSpawnedHeadlessTabs, createAIHandlers, createHandlers } from './handlers.mjs';
 export { ExpressAdapterConfig, createExpressApp, createExpressRouter, uiBridgeMiddleware } from './express.mjs';
-import { C as CommandRelay } from '../nextjs-CkNdxAF9.mjs';
-export { a as CommandListener, b as CommandRelayOptions, N as NextJSAdapterConfig, c as NextRouteHandler, P as PendingCommand, Q as QueuedCommand, R as RedisRelayBus, d as RelayBus, e as RelayCommandEnvelope, f as RelayResponseEnvelope, T as TabInfo, g as TabListener, h as TabRoutingError, i as TransportDiagnostics, W as WebSocketClient, j as createControlHandlers, k as createDebugHandlers, l as createNextRouteHandlers, m as createRedisRelayBus, n as createRenderLogHandlers, o as createUIBridgeHandler } from '../nextjs-CkNdxAF9.mjs';
-import { U as UIBridgeWSHandler } from '../standalone-CY0Uj5LQ.mjs';
-export { S as StandaloneServer, a as StandaloneServerConfig, W as WebSocketLike, c as createStandaloneServer, s as startCLI } from '../standalone-CY0Uj5LQ.mjs';
-import { e as BridgeEvent, i as AnyCapturedEvent } from '../types-D1UiLr75.mjs';
-import { B as BrowserEventStream, S as StreamSubscription } from '../ws-streaming-DGiomqt_.mjs';
-export { S as SSEManager } from '../sse-handler-CpB3bJ2N.mjs';
+import { C as CommandRelay } from '../nextjs-qQe7vyS4.mjs';
+export { a as CommandListener, b as CommandRelayOptions, N as NextJSAdapterConfig, c as NextRouteHandler, P as PendingCommand, Q as QueuedCommand, R as RedisRelayBus, d as RelayBus, e as RelayCommandEnvelope, f as RelayResponseEnvelope, T as TabInfo, g as TabListener, h as TabRoutingError, i as TransportDiagnostics, W as WebSocketClient, j as createControlHandlers, k as createDebugHandlers, l as createNextRouteHandlers, m as createRedisRelayBus, n as createRenderLogHandlers, o as createUIBridgeHandler } from '../nextjs-qQe7vyS4.mjs';
+import { U as UIBridgeWSHandler } from '../standalone-u-N_N3Wl.mjs';
+export { S as StandaloneServer, a as StandaloneServerConfig, W as WebSocketLike, c as createStandaloneServer, s as startCLI } from '../standalone-u-N_N3Wl.mjs';
+import { e as BridgeEvent, i as AnyCapturedEvent, Q as ControlActionRequest } from '../types-DnqZodFb.mjs';
+import { B as BrowserEventStream, S as StreamSubscription } from '../ws-streaming-BzumSnWw.mjs';
+export { S as SSEManager } from '../sse-handler-BE5cyXF7.mjs';
 import '../codes.generated-CXeSH-M4.mjs';
 import '../types-dIjjX5Mf.mjs';
 import '../tracker-ChLmf8-u.mjs';
-import '../effect-store-C7l209DQ.mjs';
+import '../effect-store-CATaXg5u.mjs';
 import '../render-log/index.mjs';
-import '../find-B4dTGeqA.mjs';
-import '../style-types-mvMAEeSI.mjs';
+import '../find-A7hwZli6.mjs';
+import '../style-types-CtwPR05K.mjs';
 import '../types-C7D5seeQ.mjs';
-import '../error-snapshot-DCr4oUYq.mjs';
-import '../store-Bv5wJ91r.mjs';
-import '../types-BYhYroLP.mjs';
+import '../error-snapshot-CmaQu6Ox.mjs';
+import '../store-BHzSGFU2.mjs';
+import '../types-gusNHeJt.mjs';
 import '../navigation-adapter-D0eod-Ve.mjs';
-import '../drag-drop-detector-CXlhwPb7.mjs';
+import '../drag-drop-detector-Baq_Ixcc.mjs';
 import '../annotations/index.mjs';
 import 'express';
-import '../change-observer-CBfJ5biX.mjs';
+import '../change-observer-BPtZll6d.mjs';
 
 interface WSStreamAdapterConfig {
     /** Minimum severity to forward (default: 'warning') */
@@ -178,6 +178,89 @@ interface RelayHandlersOptions {
  */
 declare function createRelayHandlers(relay: CommandRelay, options?: RelayHandlersOptions): UIBridgeServerHandlers;
 
+/**
+ * Window-scoped client facade (plan 2026-06-07-multi-window-sdk-automation,
+ * Phase 3).
+ *
+ * `windowScope(bridge, 'term-2')` pre-binds the window-targetable SDK methods to
+ * a single runner pop-out window, so a caller driving one window doesn't repeat
+ * (and can't typo) `windowLabel` on every call:
+ *
+ * ```ts
+ * const term = windowScope(handlers, 'term-2');
+ * await term.evaluate({ expression: 'document.title' });
+ * await term.getElements({ text: 'Save' });
+ * await term.executeAction('btn-save', { action: 'click' });
+ * ```
+ *
+ * It is pure sugar over the Phase-1 per-call `windowLabel` option — ONE code
+ * path. `windowScope(bridge, label).evaluate(req)` is exactly
+ * `bridge.pageEvaluate({ ...req, windowLabel: label })`, so there is no
+ * divergent behavior to reason about, and not using the scope (or passing a
+ * label of `'main'`) is byte-identical to a bare call. Only the window-
+ * targetable methods are exposed — you cannot call a non-targetable method on a
+ * window scope and get a silent no-op.
+ *
+ * The read/convenience family (`readValue`/`typeInto`/`clickByText`/
+ * `clickBySelector`/`findByText`) is included as of Phase 4 — the runner now
+ * honors `windowLabel` (read from the body) on those routes, so scoping them is
+ * honest end-to-end.
+ */
+
+/** Options accepted by `getElements`, minus the now-implicit `windowLabel`. */
+type ScopedGetElementsOptions = Omit<NonNullable<Parameters<UIBridgeServerHandlers['getElements']>[0]>, 'windowLabel'>;
+/**
+ * Args for a scoped `evaluate` — the JS expression plus any extra body fields,
+ * minus the now-implicit `windowLabel`. Spelled out rather than
+ * `Omit<PageEvaluateRequest, 'windowLabel'>` because `PageEvaluateRequest`'s
+ * index signature defeats `Omit` (it would drop the required `expression`).
+ */
+type ScopedEvaluateRequest = {
+    expression: string;
+    [key: string]: unknown;
+};
+/**
+ * The window-targetable subset of the SDK, pre-bound to one runner window.
+ * Returned by {@link windowScope}.
+ */
+interface WindowScopedBridge {
+    /** The window label every call on this scope targets. */
+    readonly windowLabel: string;
+    /**
+     * Evaluate a JS expression in the bound window. Delegates to `pageEvaluate`
+     * with `windowLabel` injected.
+     */
+    evaluate(request: ScopedEvaluateRequest, context?: HandlerContext): ReturnType<UIBridgeServerHandlers['pageEvaluate']>;
+    /**
+     * Snapshot elements from the bound window. Delegates to `getElements` with
+     * `windowLabel` injected.
+     */
+    getElements(options?: ScopedGetElementsOptions, context?: HandlerContext): ReturnType<UIBridgeServerHandlers['getElements']>;
+    /**
+     * Execute an action on an element in the bound window. Delegates to
+     * `executeElementAction` with `windowLabel` injected.
+     */
+    executeAction(id: string, request: Omit<ControlActionRequest, 'windowLabel'>, context?: HandlerContext): ReturnType<UIBridgeServerHandlers['executeElementAction']>;
+    /** Read an element's value in the bound window. Delegates to `readValue`. */
+    readValue(request: Omit<Parameters<UIBridgeServerHandlers['readValue']>[0], 'windowLabel'>, context?: HandlerContext): ReturnType<UIBridgeServerHandlers['readValue']>;
+    /** Type text into an element in the bound window. Delegates to `typeInto`. */
+    typeInto(request: Omit<Parameters<UIBridgeServerHandlers['typeInto']>[0], 'windowLabel'>, context?: HandlerContext): ReturnType<UIBridgeServerHandlers['typeInto']>;
+    /** Click an element by visible text in the bound window. Delegates to `clickByText`. */
+    clickByText(request: Omit<Parameters<UIBridgeServerHandlers['clickByText']>[0], 'windowLabel'>, context?: HandlerContext): ReturnType<UIBridgeServerHandlers['clickByText']>;
+    /** Click an element by CSS selector in the bound window. Delegates to `clickBySelector`. */
+    clickBySelector(request: Omit<Parameters<UIBridgeServerHandlers['clickBySelector']>[0], 'windowLabel'>, context?: HandlerContext): ReturnType<UIBridgeServerHandlers['clickBySelector']>;
+    /** Find elements by visible text in the bound window. Delegates to `findByText`. */
+    findByText(request: Omit<Parameters<UIBridgeServerHandlers['findByText']>[0], 'windowLabel'>, context?: HandlerContext): ReturnType<UIBridgeServerHandlers['findByText']>;
+}
+/**
+ * Pre-bind the window-targetable methods of a `UIBridgeServerHandlers` to a
+ * single runner window. See the module docs for the contract.
+ *
+ * @param handlers - the bridge handlers (e.g. from `createRelayHandlers`).
+ * @param windowLabel - the target window's label (discover via `listWindows()`).
+ */
+declare function windowScope(handlers: UIBridgeServerHandlers, windowLabel: string): WindowScopedBridge;
+
 /**
  * Chrome DevTools Protocol Tab Discovery
  *
@@ -309,4 +392,4 @@ interface ElementSelector {
  */
 declare function matchesElementSelector(el: MatchableElement, selector: ElementSelector): boolean;
 
-export { CDPTabDiscovery, type CDPTabsConfig, type CDPTarget, CommandRelay, type ElementSelector, type MatchableElement, type RelayHandlersOptions, UIBridgeServerHandlers, UIBridgeWSHandler, WSStreamAdapter, type WSStreamAdapterConfig, createRelayHandlers, createWSStreamBroadcast, matchesElementSelector };
+export { CDPTabDiscovery, type CDPTabsConfig, type CDPTarget, CommandRelay, type ElementSelector, HandlerContext, type MatchableElement, type RelayHandlersOptions, UIBridgeServerHandlers, UIBridgeWSHandler, WSStreamAdapter, type WSStreamAdapterConfig, type WindowScopedBridge, createRelayHandlers, createWSStreamBroadcast, matchesElementSelector, windowScope };

package/dist/server/index.d.ts

@@ -1,30 +1,30 @@
-import { a as UIBridgeServerHandlers } from '../types-DUVvn3yt.js';
-export { A as APIResponse, B as BrowserEventsResponse, C as CORSOptions, b as CapabilitiesResponse, c as ControlBatchRequest, d as ControlBatchResponse, e as ControlBatchStep, f as ControlBatchStepResult, D as DOMChangeEvent, E as ElementConditionSelector, g as ElementExpectRequest, h as ElementExpectResponse, i as EndpointCategory, j as EndpointInfo, H as HandlerContext, I as INTERACTION_RELAY_COMMAND_ACTIONS, k as InteractionRelayCommandAction, R as RateLimitOptions, l as RenderLogQuery, m as RouteDefinition, S as SpawnHeadlessRequest, n as SpawnHeadlessResponse, o as StateSummary, U as UIBridgeServerConfig, p as UI_BRIDGE_ROUTES, q as WaitForElementByConditionRequest, r as WaitForElementByConditionResponse, s as WaitForElementPredicate, t as WaitForElementRequest, u as WaitForElementSuccessResponse, v as WaitForRouteChangeRequest, w as WaitForRouteChangeResponse, W as WebSocketMessage, x as WebSocketMessageType } from '../types-DUVvn3yt.js';
+import { a as UIBridgeServerHandlers, H as HandlerContext } from '../types-DmMT2yMs.js';
+export { A as APIResponse, B as BrowserEventsResponse, C as CORSOptions, b as CapabilitiesResponse, c as ControlBatchRequest, d as ControlBatchResponse, e as ControlBatchStep, f as ControlBatchStepResult, D as DOMChangeEvent, E as ElementConditionSelector, g as ElementExpectRequest, h as ElementExpectResponse, i as EndpointCategory, j as EndpointInfo, I as INTERACTION_RELAY_COMMAND_ACTIONS, k as InteractionRelayCommandAction, P as PageEvaluateRequest, R as RateLimitOptions, l as RenderLogQuery, m as RouteDefinition, n as RunnerWindow, o as RunnerWindowsList, S as SpawnHeadlessRequest, p as SpawnHeadlessResponse, q as StateSummary, U as UIBridgeServerConfig, r as UI_BRIDGE_ROUTES, s as WaitForElementByConditionRequest, t as WaitForElementByConditionResponse, u as WaitForElementPredicate, v as WaitForElementRequest, w as WaitForElementSuccessResponse, x as WaitForRouteChangeRequest, y as WaitForRouteChangeResponse, W as WebSocketMessage, z as WebSocketMessageType } from '../types-DmMT2yMs.js';
 export { ActionExecutorLike, CreateHandlersConfig, RegistryLike, closeAllSpawnedHeadlessTabs, createAIHandlers, createHandlers } from './handlers.js';
 export { ExpressAdapterConfig, createExpressApp, createExpressRouter, uiBridgeMiddleware } from './express.js';
-import { C as CommandRelay } from '../nextjs-CF71sn2M.js';
-export { a as CommandListener, b as CommandRelayOptions, N as NextJSAdapterConfig, c as NextRouteHandler, P as PendingCommand, Q as QueuedCommand, R as RedisRelayBus, d as RelayBus, e as RelayCommandEnvelope, f as RelayResponseEnvelope, T as TabInfo, g as TabListener, h as TabRoutingError, i as TransportDiagnostics, W as WebSocketClient, j as createControlHandlers, k as createDebugHandlers, l as createNextRouteHandlers, m as createRedisRelayBus, n as createRenderLogHandlers, o as createUIBridgeHandler } from '../nextjs-CF71sn2M.js';
-import { U as UIBridgeWSHandler } from '../standalone-C_knSpNG.js';
-export { S as StandaloneServer, a as StandaloneServerConfig, W as WebSocketLike, c as createStandaloneServer, s as startCLI } from '../standalone-C_knSpNG.js';
-import { e as BridgeEvent, i as AnyCapturedEvent } from '../types-zS11cuej.js';
-import { B as BrowserEventStream, S as StreamSubscription } from '../ws-streaming-D_tat1kF.js';
-export { S as SSEManager } from '../sse-handler-BpZ9QtRm.js';
+import { C as CommandRelay } from '../nextjs-BLvmgmnW.js';
+export { a as CommandListener, b as CommandRelayOptions, N as NextJSAdapterConfig, c as NextRouteHandler, P as PendingCommand, Q as QueuedCommand, R as RedisRelayBus, d as RelayBus, e as RelayCommandEnvelope, f as RelayResponseEnvelope, T as TabInfo, g as TabListener, h as TabRoutingError, i as TransportDiagnostics, W as WebSocketClient, j as createControlHandlers, k as createDebugHandlers, l as createNextRouteHandlers, m as createRedisRelayBus, n as createRenderLogHandlers, o as createUIBridgeHandler } from '../nextjs-BLvmgmnW.js';
+import { U as UIBridgeWSHandler } from '../standalone-SkUUJ8sc.js';
+export { S as StandaloneServer, a as StandaloneServerConfig, W as WebSocketLike, c as createStandaloneServer, s as startCLI } from '../standalone-SkUUJ8sc.js';
+import { e as BridgeEvent, i as AnyCapturedEvent, Q as ControlActionRequest } from '../types-Chf3cfrT.js';
+import { B as BrowserEventStream, S as StreamSubscription } from '../ws-streaming-DweATXes.js';
+export { S as SSEManager } from '../sse-handler-Bw_4h2AN.js';
 import '../codes.generated-CXeSH-M4.js';
 import '../types-D7e9AWwl.js';
 import '../tracker-ChLmf8-u.js';
-import '../effect-store-Cp6Kb2-X.js';
+import '../effect-store-C0YCNUMx.js';
 import '../render-log/index.js';
-import '../find-DWZC8yoa.js';
-import '../style-types-De_9GaYG.js';
+import '../find-DpPytcRP.js';
+import '../style-types-lmRdKbT8.js';
 import '../types-C7D5seeQ.js';
-import '../error-snapshot-owQQTv8i.js';
-import '../store-BjSi35SI.js';
-import '../types-cfwRCpgn.js';
+import '../error-snapshot-DENlqCYO.js';
+import '../store-DH3LUEjx.js';
+import '../types-bG3xLcjL.js';
 import '../navigation-adapter-D0eod-Ve.js';
-import '../drag-drop-detector-B8j1bMWp.js';
+import '../drag-drop-detector-gMHP_QIg.js';
 import '../annotations/index.js';
 import 'express';
-import '../change-observer-DRBa79aK.js';
+import '../change-observer-D0aEcwCl.js';
 
 interface WSStreamAdapterConfig {
     /** Minimum severity to forward (default: 'warning') */
@@ -178,6 +178,89 @@ interface RelayHandlersOptions {
  */
 declare function createRelayHandlers(relay: CommandRelay, options?: RelayHandlersOptions): UIBridgeServerHandlers;
 
+/**
+ * Window-scoped client facade (plan 2026-06-07-multi-window-sdk-automation,
+ * Phase 3).
+ *
+ * `windowScope(bridge, 'term-2')` pre-binds the window-targetable SDK methods to
+ * a single runner pop-out window, so a caller driving one window doesn't repeat
+ * (and can't typo) `windowLabel` on every call:
+ *
+ * ```ts
+ * const term = windowScope(handlers, 'term-2');
+ * await term.evaluate({ expression: 'document.title' });
+ * await term.getElements({ text: 'Save' });
+ * await term.executeAction('btn-save', { action: 'click' });
+ * ```
+ *
+ * It is pure sugar over the Phase-1 per-call `windowLabel` option — ONE code
+ * path. `windowScope(bridge, label).evaluate(req)` is exactly
+ * `bridge.pageEvaluate({ ...req, windowLabel: label })`, so there is no
+ * divergent behavior to reason about, and not using the scope (or passing a
+ * label of `'main'`) is byte-identical to a bare call. Only the window-
+ * targetable methods are exposed — you cannot call a non-targetable method on a
+ * window scope and get a silent no-op.
+ *
+ * The read/convenience family (`readValue`/`typeInto`/`clickByText`/
+ * `clickBySelector`/`findByText`) is included as of Phase 4 — the runner now
+ * honors `windowLabel` (read from the body) on those routes, so scoping them is
+ * honest end-to-end.
+ */
+
+/** Options accepted by `getElements`, minus the now-implicit `windowLabel`. */
+type ScopedGetElementsOptions = Omit<NonNullable<Parameters<UIBridgeServerHandlers['getElements']>[0]>, 'windowLabel'>;
+/**
+ * Args for a scoped `evaluate` — the JS expression plus any extra body fields,
+ * minus the now-implicit `windowLabel`. Spelled out rather than
+ * `Omit<PageEvaluateRequest, 'windowLabel'>` because `PageEvaluateRequest`'s
+ * index signature defeats `Omit` (it would drop the required `expression`).
+ */
+type ScopedEvaluateRequest = {
+    expression: string;
+    [key: string]: unknown;
+};
+/**
+ * The window-targetable subset of the SDK, pre-bound to one runner window.
+ * Returned by {@link windowScope}.
+ */
+interface WindowScopedBridge {
+    /** The window label every call on this scope targets. */
+    readonly windowLabel: string;
+    /**
+     * Evaluate a JS expression in the bound window. Delegates to `pageEvaluate`
+     * with `windowLabel` injected.
+     */
+    evaluate(request: ScopedEvaluateRequest, context?: HandlerContext): ReturnType<UIBridgeServerHandlers['pageEvaluate']>;
+    /**
+     * Snapshot elements from the bound window. Delegates to `getElements` with
+     * `windowLabel` injected.
+     */
+    getElements(options?: ScopedGetElementsOptions, context?: HandlerContext): ReturnType<UIBridgeServerHandlers['getElements']>;
+    /**
+     * Execute an action on an element in the bound window. Delegates to
+     * `executeElementAction` with `windowLabel` injected.
+     */
+    executeAction(id: string, request: Omit<ControlActionRequest, 'windowLabel'>, context?: HandlerContext): ReturnType<UIBridgeServerHandlers['executeElementAction']>;
+    /** Read an element's value in the bound window. Delegates to `readValue`. */
+    readValue(request: Omit<Parameters<UIBridgeServerHandlers['readValue']>[0], 'windowLabel'>, context?: HandlerContext): ReturnType<UIBridgeServerHandlers['readValue']>;
+    /** Type text into an element in the bound window. Delegates to `typeInto`. */
+    typeInto(request: Omit<Parameters<UIBridgeServerHandlers['typeInto']>[0], 'windowLabel'>, context?: HandlerContext): ReturnType<UIBridgeServerHandlers['typeInto']>;
+    /** Click an element by visible text in the bound window. Delegates to `clickByText`. */
+    clickByText(request: Omit<Parameters<UIBridgeServerHandlers['clickByText']>[0], 'windowLabel'>, context?: HandlerContext): ReturnType<UIBridgeServerHandlers['clickByText']>;
+    /** Click an element by CSS selector in the bound window. Delegates to `clickBySelector`. */
+    clickBySelector(request: Omit<Parameters<UIBridgeServerHandlers['clickBySelector']>[0], 'windowLabel'>, context?: HandlerContext): ReturnType<UIBridgeServerHandlers['clickBySelector']>;
+    /** Find elements by visible text in the bound window. Delegates to `findByText`. */
+    findByText(request: Omit<Parameters<UIBridgeServerHandlers['findByText']>[0], 'windowLabel'>, context?: HandlerContext): ReturnType<UIBridgeServerHandlers['findByText']>;
+}
+/**
+ * Pre-bind the window-targetable methods of a `UIBridgeServerHandlers` to a
+ * single runner window. See the module docs for the contract.
+ *
+ * @param handlers - the bridge handlers (e.g. from `createRelayHandlers`).
+ * @param windowLabel - the target window's label (discover via `listWindows()`).
+ */
+declare function windowScope(handlers: UIBridgeServerHandlers, windowLabel: string): WindowScopedBridge;
+
 /**
  * Chrome DevTools Protocol Tab Discovery
  *
@@ -309,4 +392,4 @@ interface ElementSelector {
  */
 declare function matchesElementSelector(el: MatchableElement, selector: ElementSelector): boolean;
 
-export { CDPTabDiscovery, type CDPTabsConfig, type CDPTarget, CommandRelay, type ElementSelector, type MatchableElement, type RelayHandlersOptions, UIBridgeServerHandlers, UIBridgeWSHandler, WSStreamAdapter, type WSStreamAdapterConfig, createRelayHandlers, createWSStreamBroadcast, matchesElementSelector };
+export { CDPTabDiscovery, type CDPTabsConfig, type CDPTarget, CommandRelay, type ElementSelector, HandlerContext, type MatchableElement, type RelayHandlersOptions, UIBridgeServerHandlers, UIBridgeWSHandler, WSStreamAdapter, type WSStreamAdapterConfig, type WindowScopedBridge, createRelayHandlers, createWSStreamBroadcast, matchesElementSelector, windowScope };

package/dist/server/index.js

@@ -237,6 +237,11 @@ var UI_BRIDGE_ROUTES = [
   { method: "GET", path: "/render-log/path", handler: "getRenderLogPath" },
   // Control - Elements
   { method: "GET", path: "/control/elements", handler: "getElements" },
+  // Discover the runner process's own webview windows (main + pop-outs) so
+  // callers can resolve a `windowLabel` target. Runner-owned; promoted out of
+  // the runner_only_baseline allow-list once the SDK declared it here (plan
+  // 2026-06-07-multi-window-sdk-automation, Phase 2).
+  { method: "GET", path: "/control/runner-windows", handler: "listWindows" },
   { method: "GET", path: "/control/element/:id", handler: "getElement", params: ["id"] },
   { method: "GET", path: "/control/element/:id/state", handler: "getElementState", params: ["id"] },
   {
@@ -20697,6 +20702,12 @@ function createHandlers(registry, actionExecutor, config = {}) {
         return error(err.message, "RANK_ELEMENTS_ERROR");
       }
     },
+    listWindows: async () => {
+      return error(
+        "listWindows is runner-only \u2014 query the qontinui-runner directly (GET /control/runner-windows)",
+        "NOT_IMPLEMENTED"
+      );
+    },
     getElement: async (id) => {
       try {
         const element = registry.getElement(id);
@@ -25622,7 +25633,8 @@ function createControlHandlers(handlers) {
           title: pick("title"),
           aria_label: pick("aria_label"),
           text: pick("text"),
-          revealsAny: pick("revealsAny")
+          revealsAny: pick("revealsAny"),
+          windowLabel: pick("windowLabel")
         });
         return jsonResponse(result);
       }
@@ -29782,6 +29794,12 @@ function createRelayHandlers(relay, options) {
         }))
       );
     },
+    async listWindows() {
+      return error2(
+        "listWindows is runner-only \u2014 query the qontinui-runner directly (GET /control/runner-windows), not the browser-tab relay",
+        "NOT_IMPLEMENTED"
+      );
+    },
     async getElement(id, options2, context) {
       try {
         const { callerUserId } = extractTabRouting(options2 ?? {});
@@ -30872,6 +30890,21 @@ function createRelayHandlers(relay, options) {
   return handlers;
 }
 
+// src/server/window-scope.ts
+function windowScope(handlers, windowLabel) {
+  return {
+    windowLabel,
+    evaluate: (request, context) => handlers.pageEvaluate({ ...request, windowLabel }, context),
+    getElements: (options, context) => handlers.getElements({ ...options, windowLabel }, context),
+    executeAction: (id, request, context) => handlers.executeElementAction(id, { ...request, windowLabel }, context),
+    readValue: (request, context) => handlers.readValue({ ...request, windowLabel }, context),
+    typeInto: (request, context) => handlers.typeInto({ ...request, windowLabel }, context),
+    clickByText: (request, context) => handlers.clickByText({ ...request, windowLabel }, context),
+    clickBySelector: (request, context) => handlers.clickBySelector({ ...request, windowLabel }, context),
+    findByText: (request, context) => handlers.findByText({ ...request, windowLabel }, context)
+  };
+}
+
 exports.CDPTabDiscovery = CDPTabDiscovery;
 exports.CommandRelay = CommandRelay;
 exports.INTERACTION_RELAY_COMMAND_ACTIONS = INTERACTION_RELAY_COMMAND_ACTIONS;
@@ -30899,5 +30932,6 @@ exports.createWSStreamBroadcast = createWSStreamBroadcast;
 exports.matchesElementSelector = matchesElementSelector;
 exports.startCLI = startCLI;
 exports.uiBridgeMiddleware = uiBridgeMiddleware;
+exports.windowScope = windowScope;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map