@qontinui/ui-bridge 0.18.0 → 0.19.0

package/dist/{standalone-7VEHUTla.d.ts → standalone-SkUUJ8sc.d.ts}

@@ -1,6 +1,6 @@
-import { C as ChangeObserver } from './change-observer-DWhgnunJ.js';
+import { C as ChangeObserver } from './change-observer-D0aEcwCl.js';
 import { U as UIBridgeRegistry, e as BridgeEvent } from './types-Chf3cfrT.js';
-import { a as UIBridgeServerHandlers, U as UIBridgeServerConfig, W as WebSocketMessage } from './types-DP4N3eYZ.js';
+import { a as UIBridgeServerHandlers, U as UIBridgeServerConfig, W as WebSocketMessage } from './types-DmMT2yMs.js';
 import { S as SSEManager } from './sse-handler-Bw_4h2AN.js';
 
 /**

package/dist/{standalone-DCGkT2Ad.d.mts → standalone-u-N_N3Wl.d.mts}

@@ -1,6 +1,6 @@
-import { C as ChangeObserver } from './change-observer-DMXmff2q.mjs';
+import { C as ChangeObserver } from './change-observer-BPtZll6d.mjs';
 import { U as UIBridgeRegistry, e as BridgeEvent } from './types-DnqZodFb.mjs';
-import { a as UIBridgeServerHandlers, U as UIBridgeServerConfig, W as WebSocketMessage } from './types-DTGf8Noz.mjs';
+import { a as UIBridgeServerHandlers, U as UIBridgeServerConfig, W as WebSocketMessage } from './types-DNc31VlO.mjs';
 import { S as SSEManager } from './sse-handler-BE5cyXF7.mjs';
 
 /**

package/dist/{types-DTGf8Noz.d.mts → types-DNc31VlO.d.mts}

@@ -153,6 +153,28 @@ interface APIResponse<T = unknown> {
 /**
  * Render log query parameters
  */
+/**
+ * One runner-owned webview window, as returned by `listWindows()`
+ * (`GET /control/runner-windows`). The wire shape mirrors the runner's
+ * `ui_bridge_list_runner_windows_handler` exactly — no field remapping.
+ */
+interface RunnerWindow {
+    /** The window's Tauri label — the value to pass as `windowLabel`. */
+    label: string;
+    /** `'main'` for the runner's primary window, `'secondary'` for a pop-out. */
+    kind: 'main' | 'secondary';
+    /** The window's title, or `null` if unavailable. */
+    title: string | null;
+}
+/**
+ * Response payload of `listWindows()` (`GET /control/runner-windows`).
+ */
+interface RunnerWindowsList {
+    /** Number of windows returned. */
+    count: number;
+    /** The runner process's own webview windows, sorted by `label`. */
+    windows: RunnerWindow[];
+}
 /**
  * Request body for `POST /control/page/evaluate` (`pageEvaluate`).
  *
@@ -375,6 +397,19 @@ interface UIBridgeServerHandlers {
          */
         windowLabel?: string;
     }, context?: HandlerContext) => Promise<APIResponse<ControlSnapshot['elements']>>;
+    /**
+     * Enumerate the runner process's OWN webview windows — the main window plus
+     * any pop-out terminal windows — so callers can discover valid `windowLabel`
+     * targets before issuing a window-scoped command. Maps to
+     * `GET /control/runner-windows`.
+     *
+     * **Runner-only.** This is answered by the qontinui-runner, which owns the
+     * Tauri webviews. Non-runner server contexts (a plain React-app server, the
+     * relay's browser-tab path) host no runner windows and return a
+     * `NOT_IMPLEMENTED` error — discover windows via direct HTTP to the runner.
+     * Distinct from `/control/windows`, which enumerates OS desktop windows.
+     */
+    listWindows: (context?: HandlerContext) => Promise<APIResponse<RunnerWindowsList>>;
     getElement: (id: string, options?: {
         recency?: string;
     }, context?: HandlerContext) => Promise<APIResponse<ControlSnapshot['elements'][0]>>;
@@ -889,6 +924,8 @@ interface UIBridgeServerHandlers {
         text: string;
         tag?: string;
         exact?: boolean;
+        /** Target a runner pop-out window discoverable via `listWindows()`; omit → main window. Read from the body. */
+        windowLabel?: string;
     }, context?: HandlerContext) => Promise<APIResponse<{
         clicked: boolean;
         element?: unknown;
@@ -896,6 +933,8 @@ interface UIBridgeServerHandlers {
     clickBySelector: (request: {
         selector: string;
         index?: number;
+        /** Target a runner pop-out window discoverable via `listWindows()`; omit → main window. Read from the body. */
+        windowLabel?: string;
     }, context?: HandlerContext) => Promise<APIResponse<{
         clicked: boolean;
         element?: unknown;
@@ -905,6 +944,8 @@ interface UIBridgeServerHandlers {
         label?: string;
         text: string;
         clear?: boolean;
+        /** Target a runner pop-out window discoverable via `listWindows()`; omit → main window. Read from the body. */
+        windowLabel?: string;
     }, context?: HandlerContext) => Promise<APIResponse<{
         typed: boolean;
         element?: unknown;
@@ -912,6 +953,8 @@ interface UIBridgeServerHandlers {
     readValue: (request: {
         selector: string;
         index?: number;
+        /** Target a runner pop-out window discoverable via `listWindows()`; omit → main window. Read from the body. */
+        windowLabel?: string;
     }, context?: HandlerContext) => Promise<APIResponse<{
         value: string | null;
         length: number;
@@ -920,6 +963,7 @@ interface UIBridgeServerHandlers {
         text: string;
         tag?: string;
         exact?: boolean;
+        windowLabel?: string;
     }, context?: HandlerContext) => Promise<APIResponse<Array<{
         index: number;
         tag: string;
@@ -1211,4 +1255,4 @@ interface WebSocketMessage<T = unknown> {
     timestamp: number;
 }
 
-export { type APIResponse as A, type BrowserEventsResponse as B, type CORSOptions as C, type DOMChangeEvent as D, type ElementConditionSelector as E, type HandlerContext as H, INTERACTION_RELAY_COMMAND_ACTIONS as I, type PageEvaluateRequest as P, type RateLimitOptions as R, type SpawnHeadlessRequest as S, type UIBridgeServerConfig as U, type WebSocketMessage as W, type UIBridgeServerHandlers as a, type CapabilitiesResponse as b, type ControlBatchRequest as c, type ControlBatchResponse as d, type ControlBatchStep as e, type ControlBatchStepResult as f, type ElementExpectRequest as g, type ElementExpectResponse as h, type EndpointCategory as i, type EndpointInfo as j, type InteractionRelayCommandAction as k, type RenderLogQuery as l, type RouteDefinition as m, type SpawnHeadlessResponse as n, type StateSummary as o, UI_BRIDGE_ROUTES as p, type WaitForElementByConditionRequest as q, type WaitForElementByConditionResponse as r, type WaitForElementPredicate as s, type WaitForElementRequest as t, type WaitForElementSuccessResponse as u, type WaitForRouteChangeRequest as v, type WaitForRouteChangeResponse as w, type WebSocketMessageType as x };
+export { type APIResponse as A, type BrowserEventsResponse as B, type CORSOptions as C, type DOMChangeEvent as D, type ElementConditionSelector as E, type HandlerContext as H, INTERACTION_RELAY_COMMAND_ACTIONS as I, type PageEvaluateRequest as P, type RateLimitOptions as R, type SpawnHeadlessRequest as S, type UIBridgeServerConfig as U, type WebSocketMessage as W, type UIBridgeServerHandlers as a, type CapabilitiesResponse as b, type ControlBatchRequest as c, type ControlBatchResponse as d, type ControlBatchStep as e, type ControlBatchStepResult as f, type ElementExpectRequest as g, type ElementExpectResponse as h, type EndpointCategory as i, type EndpointInfo as j, type InteractionRelayCommandAction as k, type RenderLogQuery as l, type RouteDefinition as m, type RunnerWindow as n, type RunnerWindowsList as o, type SpawnHeadlessResponse as p, type StateSummary as q, UI_BRIDGE_ROUTES as r, type WaitForElementByConditionRequest as s, type WaitForElementByConditionResponse as t, type WaitForElementPredicate as u, type WaitForElementRequest as v, type WaitForElementSuccessResponse as w, type WaitForRouteChangeRequest as x, type WaitForRouteChangeResponse as y, type WebSocketMessageType as z };

package/dist/{types-DP4N3eYZ.d.ts → types-DmMT2yMs.d.ts}

@@ -153,6 +153,28 @@ interface APIResponse<T = unknown> {
 /**
  * Render log query parameters
  */
+/**
+ * One runner-owned webview window, as returned by `listWindows()`
+ * (`GET /control/runner-windows`). The wire shape mirrors the runner's
+ * `ui_bridge_list_runner_windows_handler` exactly — no field remapping.
+ */
+interface RunnerWindow {
+    /** The window's Tauri label — the value to pass as `windowLabel`. */
+    label: string;
+    /** `'main'` for the runner's primary window, `'secondary'` for a pop-out. */
+    kind: 'main' | 'secondary';
+    /** The window's title, or `null` if unavailable. */
+    title: string | null;
+}
+/**
+ * Response payload of `listWindows()` (`GET /control/runner-windows`).
+ */
+interface RunnerWindowsList {
+    /** Number of windows returned. */
+    count: number;
+    /** The runner process's own webview windows, sorted by `label`. */
+    windows: RunnerWindow[];
+}
 /**
  * Request body for `POST /control/page/evaluate` (`pageEvaluate`).
  *
@@ -375,6 +397,19 @@ interface UIBridgeServerHandlers {
          */
         windowLabel?: string;
     }, context?: HandlerContext) => Promise<APIResponse<ControlSnapshot['elements']>>;
+    /**
+     * Enumerate the runner process's OWN webview windows — the main window plus
+     * any pop-out terminal windows — so callers can discover valid `windowLabel`
+     * targets before issuing a window-scoped command. Maps to
+     * `GET /control/runner-windows`.
+     *
+     * **Runner-only.** This is answered by the qontinui-runner, which owns the
+     * Tauri webviews. Non-runner server contexts (a plain React-app server, the
+     * relay's browser-tab path) host no runner windows and return a
+     * `NOT_IMPLEMENTED` error — discover windows via direct HTTP to the runner.
+     * Distinct from `/control/windows`, which enumerates OS desktop windows.
+     */
+    listWindows: (context?: HandlerContext) => Promise<APIResponse<RunnerWindowsList>>;
     getElement: (id: string, options?: {
         recency?: string;
     }, context?: HandlerContext) => Promise<APIResponse<ControlSnapshot['elements'][0]>>;
@@ -889,6 +924,8 @@ interface UIBridgeServerHandlers {
         text: string;
         tag?: string;
         exact?: boolean;
+        /** Target a runner pop-out window discoverable via `listWindows()`; omit → main window. Read from the body. */
+        windowLabel?: string;
     }, context?: HandlerContext) => Promise<APIResponse<{
         clicked: boolean;
         element?: unknown;
@@ -896,6 +933,8 @@ interface UIBridgeServerHandlers {
     clickBySelector: (request: {
         selector: string;
         index?: number;
+        /** Target a runner pop-out window discoverable via `listWindows()`; omit → main window. Read from the body. */
+        windowLabel?: string;
     }, context?: HandlerContext) => Promise<APIResponse<{
         clicked: boolean;
         element?: unknown;
@@ -905,6 +944,8 @@ interface UIBridgeServerHandlers {
         label?: string;
         text: string;
         clear?: boolean;
+        /** Target a runner pop-out window discoverable via `listWindows()`; omit → main window. Read from the body. */
+        windowLabel?: string;
     }, context?: HandlerContext) => Promise<APIResponse<{
         typed: boolean;
         element?: unknown;
@@ -912,6 +953,8 @@ interface UIBridgeServerHandlers {
     readValue: (request: {
         selector: string;
         index?: number;
+        /** Target a runner pop-out window discoverable via `listWindows()`; omit → main window. Read from the body. */
+        windowLabel?: string;
     }, context?: HandlerContext) => Promise<APIResponse<{
         value: string | null;
         length: number;
@@ -920,6 +963,7 @@ interface UIBridgeServerHandlers {
         text: string;
         tag?: string;
         exact?: boolean;
+        windowLabel?: string;
     }, context?: HandlerContext) => Promise<APIResponse<Array<{
         index: number;
         tag: string;
@@ -1211,4 +1255,4 @@ interface WebSocketMessage<T = unknown> {
     timestamp: number;
 }
 
-export { type APIResponse as A, type BrowserEventsResponse as B, type CORSOptions as C, type DOMChangeEvent as D, type ElementConditionSelector as E, type HandlerContext as H, INTERACTION_RELAY_COMMAND_ACTIONS as I, type PageEvaluateRequest as P, type RateLimitOptions as R, type SpawnHeadlessRequest as S, type UIBridgeServerConfig as U, type WebSocketMessage as W, type UIBridgeServerHandlers as a, type CapabilitiesResponse as b, type ControlBatchRequest as c, type ControlBatchResponse as d, type ControlBatchStep as e, type ControlBatchStepResult as f, type ElementExpectRequest as g, type ElementExpectResponse as h, type EndpointCategory as i, type EndpointInfo as j, type InteractionRelayCommandAction as k, type RenderLogQuery as l, type RouteDefinition as m, type SpawnHeadlessResponse as n, type StateSummary as o, UI_BRIDGE_ROUTES as p, type WaitForElementByConditionRequest as q, type WaitForElementByConditionResponse as r, type WaitForElementPredicate as s, type WaitForElementRequest as t, type WaitForElementSuccessResponse as u, type WaitForRouteChangeRequest as v, type WaitForRouteChangeResponse as w, type WebSocketMessageType as x };
+export { type APIResponse as A, type BrowserEventsResponse as B, type CORSOptions as C, type DOMChangeEvent as D, type ElementConditionSelector as E, type HandlerContext as H, INTERACTION_RELAY_COMMAND_ACTIONS as I, type PageEvaluateRequest as P, type RateLimitOptions as R, type SpawnHeadlessRequest as S, type UIBridgeServerConfig as U, type WebSocketMessage as W, type UIBridgeServerHandlers as a, type CapabilitiesResponse as b, type ControlBatchRequest as c, type ControlBatchResponse as d, type ControlBatchStep as e, type ControlBatchStepResult as f, type ElementExpectRequest as g, type ElementExpectResponse as h, type EndpointCategory as i, type EndpointInfo as j, type InteractionRelayCommandAction as k, type RenderLogQuery as l, type RouteDefinition as m, type RunnerWindow as n, type RunnerWindowsList as o, type SpawnHeadlessResponse as p, type StateSummary as q, UI_BRIDGE_ROUTES as r, type WaitForElementByConditionRequest as s, type WaitForElementByConditionResponse as t, type WaitForElementPredicate as u, type WaitForElementRequest as v, type WaitForElementSuccessResponse as w, type WaitForRouteChangeRequest as x, type WaitForRouteChangeResponse as y, type WebSocketMessageType as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/ui-bridge",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "UI Bridge Framework - React hooks and providers for UI observation, control, and debugging",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",