@qontinui/ui-bridge 0.18.0 → 0.19.0

package/dist/server/index.d.mts

@@ -1,12 +1,12 @@
-import { a as UIBridgeServerHandlers } from '../types-DTGf8Noz.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, P as PageEvaluateRequest, 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-DTGf8Noz.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-BN5L-0yi.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-BN5L-0yi.mjs';
-import { U as UIBridgeWSHandler } from '../standalone-DCGkT2Ad.mjs';
-export { S as StandaloneServer, a as StandaloneServerConfig, W as WebSocketLike, c as createStandaloneServer, s as startCLI } from '../standalone-DCGkT2Ad.mjs';
-import { e as BridgeEvent, i as AnyCapturedEvent } from '../types-DnqZodFb.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';
@@ -24,7 +24,7 @@ import '../navigation-adapter-D0eod-Ve.mjs';
 import '../drag-drop-detector-Baq_Ixcc.mjs';
 import '../annotations/index.mjs';
 import 'express';
-import '../change-observer-DMXmff2q.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,12 +1,12 @@
-import { a as UIBridgeServerHandlers } from '../types-DP4N3eYZ.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, P as PageEvaluateRequest, 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-DP4N3eYZ.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-C1cIi_zY.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-C1cIi_zY.js';
-import { U as UIBridgeWSHandler } from '../standalone-7VEHUTla.js';
-export { S as StandaloneServer, a as StandaloneServerConfig, W as WebSocketLike, c as createStandaloneServer, s as startCLI } from '../standalone-7VEHUTla.js';
-import { e as BridgeEvent, i as AnyCapturedEvent } from '../types-Chf3cfrT.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';
@@ -24,7 +24,7 @@ import '../navigation-adapter-D0eod-Ve.js';
 import '../drag-drop-detector-gMHP_QIg.js';
 import '../annotations/index.js';
 import 'express';
-import '../change-observer-DWhgnunJ.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);
@@ -29783,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 ?? {});
@@ -30873,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;
@@ -30900,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