@qontinui/ui-bridge 0.17.0 → 0.18.0

package/dist/specs/index.d.mts

@@ -1,14 +1,14 @@
-import { S as SpecCategory, a as SpecSeverity, r as SpecSource, c as SpecConfig, e as SpecAssertion, w as SpecTarget, i as SpecAssertionResult, d as SpecGroup, o as SpecExecutionOptions, h as SpecGroupResult, g as SpecExecutionResult } from '../types-BYhYroLP.mjs';
-export { A as AssertionCondition, j as AsyncStrategy, D as DiscoveredSpec, k as SPEC_CONFIG_VERSION, l as SPEC_FILE_EXTENSION, m as SetupAction, f as SpecCoverage, b as SpecEvent, n as SpecEventType, p as SpecGroupTesting, q as SpecMetadata, s as SpecState, t as SpecStateMachine, u as SpecStateMachineShape, v as SpecStateShape, x as SpecTestingConfig, y as SpecTransition, z as SpecTransitionAction, B as SpecValidationRollup, T as TestDataAsset, C as TestFixture, E as TestInfrastructureRequirements, F as TestScenario, G as TestStep, V as VALID_ASSERTION_TYPES, H as VALID_SPEC_CATEGORIES, I as VALID_SPEC_SEVERITIES, J as VALID_SPEC_SOURCES } from '../types-BYhYroLP.mjs';
-import { r as AssertionType, D as DiscoveredElement, m as AIDiscoveredElement, n as AssertionRequest, S as SearchCriteria, ci as ExtendedComputedStyles, ap as ElementDesignData } from '../types-D1UiLr75.mjs';
-export { a as SpecFilterOptions, b as SpecListener, S as SpecStore, g as getGlobalSpecStore, r as resetGlobalSpecStore } from '../store-Bv5wJ91r.mjs';
-import { A as AssertionConfig } from '../assertions-C-uxQGa8.mjs';
-import { g as ArtifactStore } from '../types-BUCPM1o1.mjs';
-import { p as StyleConstraint, D as DesignTokens, q as StyleConstraintResult, S as StyleGuideConfig, a as StyleAuditReport, r as StyleRule, s as StyleValidationResult, k as QualityMetricId, f as MetricFunction, h as QualityContext, V as ViewportDimensions, Q as QualityEvaluationReport, n as SnapshotBaseline, b as SnapshotDiffReport } from '../style-types-mvMAEeSI.mjs';
-export { c as ElementDiff, E as EvaluateRequest, L as LayoutShift, M as MetricContextConfig, d as MetricFinding, e as MetricFindingSeverity, g as MetricResult, i as QualityGrade, j as QualityMetricCategory, l as STYLE_GUIDE_FILE_EXTENSION, m as STYLE_GUIDE_VERSION, o as StyleChange } from '../style-types-mvMAEeSI.mjs';
+import { S as SpecCategory, a as SpecSeverity, r as SpecSource, c as SpecConfig, e as SpecAssertion, w as SpecTarget, i as SpecAssertionResult, d as SpecGroup, o as SpecExecutionOptions, h as SpecGroupResult, g as SpecExecutionResult } from '../types-gusNHeJt.mjs';
+export { A as AssertionCondition, j as AsyncStrategy, D as DiscoveredSpec, k as SPEC_CONFIG_VERSION, l as SPEC_FILE_EXTENSION, m as SetupAction, f as SpecCoverage, b as SpecEvent, n as SpecEventType, p as SpecGroupTesting, q as SpecMetadata, s as SpecState, t as SpecStateMachine, u as SpecStateMachineShape, v as SpecStateShape, x as SpecTestingConfig, y as SpecTransition, z as SpecTransitionAction, B as SpecValidationRollup, T as TestDataAsset, C as TestFixture, E as TestInfrastructureRequirements, F as TestScenario, G as TestStep, V as VALID_ASSERTION_TYPES, H as VALID_SPEC_CATEGORIES, I as VALID_SPEC_SEVERITIES, J as VALID_SPEC_SOURCES } from '../types-gusNHeJt.mjs';
+import { r as AssertionType, D as DiscoveredElement, m as AIDiscoveredElement, n as AssertionRequest, S as SearchCriteria, ci as ExtendedComputedStyles, ap as ElementDesignData } from '../types-DnqZodFb.mjs';
+export { a as SpecFilterOptions, b as SpecListener, S as SpecStore, g as getGlobalSpecStore, r as resetGlobalSpecStore } from '../store-BHzSGFU2.mjs';
+import { A as AssertionConfig } from '../assertions-j3SVwQrW.mjs';
+import { g as ArtifactStore } from '../types-CB7QpT8R.mjs';
+import { p as StyleConstraint, D as DesignTokens, q as StyleConstraintResult, S as StyleGuideConfig, a as StyleAuditReport, r as StyleRule, s as StyleValidationResult, k as QualityMetricId, f as MetricFunction, h as QualityContext, V as ViewportDimensions, Q as QualityEvaluationReport, n as SnapshotBaseline, b as SnapshotDiffReport } from '../style-types-CtwPR05K.mjs';
+export { c as ElementDiff, E as EvaluateRequest, L as LayoutShift, M as MetricContextConfig, d as MetricFinding, e as MetricFindingSeverity, g as MetricResult, i as QualityGrade, j as QualityMetricCategory, l as STYLE_GUIDE_FILE_EXTENSION, m as STYLE_GUIDE_VERSION, o as StyleChange } from '../style-types-CtwPR05K.mjs';
 import '../codes.generated-CXeSH-M4.mjs';
-import '../types-q-2aMSnI.mjs';
-import '../types-IQUAZlE2.mjs';
+import '../types-cQzKFRd5.mjs';
+import '../types-CgsWB31c.mjs';
 
 /**
  * Spec Validator

package/dist/specs/index.d.ts

@@ -1,14 +1,14 @@
-import { S as SpecCategory, a as SpecSeverity, r as SpecSource, c as SpecConfig, e as SpecAssertion, w as SpecTarget, i as SpecAssertionResult, d as SpecGroup, o as SpecExecutionOptions, h as SpecGroupResult, g as SpecExecutionResult } from '../types-cfwRCpgn.js';
-export { A as AssertionCondition, j as AsyncStrategy, D as DiscoveredSpec, k as SPEC_CONFIG_VERSION, l as SPEC_FILE_EXTENSION, m as SetupAction, f as SpecCoverage, b as SpecEvent, n as SpecEventType, p as SpecGroupTesting, q as SpecMetadata, s as SpecState, t as SpecStateMachine, u as SpecStateMachineShape, v as SpecStateShape, x as SpecTestingConfig, y as SpecTransition, z as SpecTransitionAction, B as SpecValidationRollup, T as TestDataAsset, C as TestFixture, E as TestInfrastructureRequirements, F as TestScenario, G as TestStep, V as VALID_ASSERTION_TYPES, H as VALID_SPEC_CATEGORIES, I as VALID_SPEC_SEVERITIES, J as VALID_SPEC_SOURCES } from '../types-cfwRCpgn.js';
-import { r as AssertionType, D as DiscoveredElement, m as AIDiscoveredElement, n as AssertionRequest, S as SearchCriteria, ci as ExtendedComputedStyles, ap as ElementDesignData } from '../types-zS11cuej.js';
-export { a as SpecFilterOptions, b as SpecListener, S as SpecStore, g as getGlobalSpecStore, r as resetGlobalSpecStore } from '../store-BjSi35SI.js';
-import { A as AssertionConfig } from '../assertions-Cuf-hvNa.js';
-import { g as ArtifactStore } from '../types-Bz40rWAT.js';
-import { p as StyleConstraint, D as DesignTokens, q as StyleConstraintResult, S as StyleGuideConfig, a as StyleAuditReport, r as StyleRule, s as StyleValidationResult, k as QualityMetricId, f as MetricFunction, h as QualityContext, V as ViewportDimensions, Q as QualityEvaluationReport, n as SnapshotBaseline, b as SnapshotDiffReport } from '../style-types-De_9GaYG.js';
-export { c as ElementDiff, E as EvaluateRequest, L as LayoutShift, M as MetricContextConfig, d as MetricFinding, e as MetricFindingSeverity, g as MetricResult, i as QualityGrade, j as QualityMetricCategory, l as STYLE_GUIDE_FILE_EXTENSION, m as STYLE_GUIDE_VERSION, o as StyleChange } from '../style-types-De_9GaYG.js';
+import { S as SpecCategory, a as SpecSeverity, r as SpecSource, c as SpecConfig, e as SpecAssertion, w as SpecTarget, i as SpecAssertionResult, d as SpecGroup, o as SpecExecutionOptions, h as SpecGroupResult, g as SpecExecutionResult } from '../types-bG3xLcjL.js';
+export { A as AssertionCondition, j as AsyncStrategy, D as DiscoveredSpec, k as SPEC_CONFIG_VERSION, l as SPEC_FILE_EXTENSION, m as SetupAction, f as SpecCoverage, b as SpecEvent, n as SpecEventType, p as SpecGroupTesting, q as SpecMetadata, s as SpecState, t as SpecStateMachine, u as SpecStateMachineShape, v as SpecStateShape, x as SpecTestingConfig, y as SpecTransition, z as SpecTransitionAction, B as SpecValidationRollup, T as TestDataAsset, C as TestFixture, E as TestInfrastructureRequirements, F as TestScenario, G as TestStep, V as VALID_ASSERTION_TYPES, H as VALID_SPEC_CATEGORIES, I as VALID_SPEC_SEVERITIES, J as VALID_SPEC_SOURCES } from '../types-bG3xLcjL.js';
+import { r as AssertionType, D as DiscoveredElement, m as AIDiscoveredElement, n as AssertionRequest, S as SearchCriteria, ci as ExtendedComputedStyles, ap as ElementDesignData } from '../types-Chf3cfrT.js';
+export { a as SpecFilterOptions, b as SpecListener, S as SpecStore, g as getGlobalSpecStore, r as resetGlobalSpecStore } from '../store-DH3LUEjx.js';
+import { A as AssertionConfig } from '../assertions-DwPKlu6v.js';
+import { g as ArtifactStore } from '../types-DhJE_FQX.js';
+import { p as StyleConstraint, D as DesignTokens, q as StyleConstraintResult, S as StyleGuideConfig, a as StyleAuditReport, r as StyleRule, s as StyleValidationResult, k as QualityMetricId, f as MetricFunction, h as QualityContext, V as ViewportDimensions, Q as QualityEvaluationReport, n as SnapshotBaseline, b as SnapshotDiffReport } from '../style-types-lmRdKbT8.js';
+export { c as ElementDiff, E as EvaluateRequest, L as LayoutShift, M as MetricContextConfig, d as MetricFinding, e as MetricFindingSeverity, g as MetricResult, i as QualityGrade, j as QualityMetricCategory, l as STYLE_GUIDE_FILE_EXTENSION, m as STYLE_GUIDE_VERSION, o as StyleChange } from '../style-types-lmRdKbT8.js';
 import '../codes.generated-CXeSH-M4.js';
-import '../types-C6ix-zFE.js';
-import '../types-vftd8HsR.js';
+import '../types-CovPz-sh.js';
+import '../types-DgIxG1sS.js';
 
 /**
  * Spec Validator

package/dist/{sse-handler-CpB3bJ2N.d.mts → sse-handler-BE5cyXF7.d.mts}

@@ -1,4 +1,4 @@
-import { e as BridgeEvent } from './types-D1UiLr75.mjs';
+import { e as BridgeEvent } from './types-DnqZodFb.mjs';
 
 /**
  * SSE (Server-Sent Events) Handler for UI Bridge

package/dist/{sse-handler-BpZ9QtRm.d.ts → sse-handler-Bw_4h2AN.d.ts}

@@ -1,4 +1,4 @@
-import { e as BridgeEvent } from './types-zS11cuej.js';
+import { e as BridgeEvent } from './types-Chf3cfrT.js';
 
 /**
  * SSE (Server-Sent Events) Handler for UI Bridge

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

@@ -1,7 +1,7 @@
-import { C as ChangeObserver } from './change-observer-DRBa79aK.js';
-import { U as UIBridgeRegistry, e as BridgeEvent } from './types-zS11cuej.js';
-import { a as UIBridgeServerHandlers, U as UIBridgeServerConfig, W as WebSocketMessage } from './types-DUVvn3yt.js';
-import { S as SSEManager } from './sse-handler-BpZ9QtRm.js';
+import { C as ChangeObserver } from './change-observer-DWhgnunJ.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 { S as SSEManager } from './sse-handler-Bw_4h2AN.js';
 
 /**
  * WebSocket-like interface for compatibility

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

@@ -1,7 +1,7 @@
-import { C as ChangeObserver } from './change-observer-CBfJ5biX.mjs';
-import { U as UIBridgeRegistry, e as BridgeEvent } from './types-D1UiLr75.mjs';
-import { a as UIBridgeServerHandlers, U as UIBridgeServerConfig, W as WebSocketMessage } from './types-Bubo62kN.mjs';
-import { S as SSEManager } from './sse-handler-CpB3bJ2N.mjs';
+import { C as ChangeObserver } from './change-observer-DMXmff2q.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 { S as SSEManager } from './sse-handler-BE5cyXF7.mjs';
 
 /**
  * WebSocket-like interface for compatibility

package/dist/{store-Bv5wJ91r.d.mts → store-BHzSGFU2.d.mts}

@@ -1,4 +1,4 @@
-import { S as SpecCategory, a as SpecSeverity, b as SpecEvent, c as SpecConfig, d as SpecGroup, e as SpecAssertion, f as SpecCoverage } from './types-BYhYroLP.mjs';
+import { S as SpecCategory, a as SpecSeverity, b as SpecEvent, c as SpecConfig, d as SpecGroup, e as SpecAssertion, f as SpecCoverage } from './types-gusNHeJt.mjs';
 
 /**
  * Spec Store

package/dist/{store-BjSi35SI.d.ts → store-DH3LUEjx.d.ts}

@@ -1,4 +1,4 @@
-import { S as SpecCategory, a as SpecSeverity, b as SpecEvent, c as SpecConfig, d as SpecGroup, e as SpecAssertion, f as SpecCoverage } from './types-cfwRCpgn.js';
+import { S as SpecCategory, a as SpecSeverity, b as SpecEvent, c as SpecConfig, d as SpecGroup, e as SpecAssertion, f as SpecCoverage } from './types-bG3xLcjL.js';
 
 /**
  * Spec Store

package/dist/{style-types-mvMAEeSI.d.mts → style-types-CtwPR05K.d.mts}

@@ -1,4 +1,4 @@
-import { ap as ElementDesignData } from './types-D1UiLr75.mjs';
+import { ap as ElementDesignData } from './types-DnqZodFb.mjs';
 
 /**
  * Quality Evaluator Types

package/dist/{style-types-De_9GaYG.d.ts → style-types-lmRdKbT8.d.ts}

@@ -1,4 +1,4 @@
-import { ap as ElementDesignData } from './types-zS11cuej.js';
+import { ap as ElementDesignData } from './types-Chf3cfrT.js';
 
 /**
  * Quality Evaluator Types

package/dist/{types-BUCPM1o1.d.mts → types-CB7QpT8R.d.mts}

@@ -1,6 +1,6 @@
-import { g as SpecExecutionResult, h as SpecGroupResult } from './types-BYhYroLP.mjs';
-import { C as ContractExecutionResult } from './types-q-2aMSnI.mjs';
-import { M as MatrixExecutionResult } from './types-IQUAZlE2.mjs';
+import { g as SpecExecutionResult, h as SpecGroupResult } from './types-gusNHeJt.mjs';
+import { C as ContractExecutionResult } from './types-cQzKFRd5.mjs';
+import { M as MatrixExecutionResult } from './types-CgsWB31c.mjs';
 
 /**
  * Artifact Types

package/dist/{types-IQUAZlE2.d.mts → types-CgsWB31c.d.mts}

@@ -1,4 +1,4 @@
-import { i as SpecAssertionResult, e as SpecAssertion } from './types-BYhYroLP.mjs';
+import { i as SpecAssertionResult, e as SpecAssertion } from './types-gusNHeJt.mjs';
 
 /**
  * Verification Layers Types

package/dist/{types-zS11cuej.d.ts → types-Chf3cfrT.d.ts}

@@ -1215,6 +1215,18 @@ interface EffectVerification {
  * Extended action request with additional options
  */
 interface ControlActionRequest extends ActionRequest {
+    /**
+     * Target a runner pop-out window for this action; omit → the main window.
+     *
+     * Discover live window labels via `listWindows()` (the runner returns a
+     * structured error naming the missing window if the label is unknown). The
+     * runner resolves the target from the `?windowLabel=` **query parameter** on
+     * `POST /control/element/:id/action` (`ActionQueryParams.window_label`), so a
+     * caller issuing the HTTP request directly must append `?windowLabel=<label>`
+     * to the action URL — this typed field documents the option and carries it for
+     * transports that forward the request bag verbatim.
+     */
+    windowLabel?: string;
     /** Unique request ID for tracking */
     requestId?: string;
     /** Capture snapshot after action */

package/dist/{types-C6ix-zFE.d.ts → types-CovPz-sh.d.ts}

@@ -1,4 +1,4 @@
-import { i as SpecAssertionResult, e as SpecAssertion } from './types-cfwRCpgn.js';
+import { i as SpecAssertionResult, e as SpecAssertion } from './types-bG3xLcjL.js';
 
 /**
  * Verification Contract Types

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

@@ -1,13 +1,13 @@
-import { i as AnyCapturedEvent, u as CapturedError, M as UIBridgeConfig, z as ControlSnapshot, Q as ControlActionRequest, C as ControlActionResponse, x as BatchActionRequest, y as BatchActionResponse, R as ComponentActionRequest, g as ComponentActionResponse, V as FindRequest, X as FindResponse, Y as WorkflowRunRequest, Z as WorkflowRunResponse, S as SearchCriteria, _ as SearchResponse, $ as NLActionRequest, a0 as NLActionResponse, n as AssertionRequest, o as AssertionResult, p as BatchAssertionRequest, q as BatchAssertionResult, a1 as SemanticSnapshot, a2 as SemanticDiff, a3 as ActionWithDiffRequest, a4 as ActionDiffResult, a5 as ChangePredicate, a6 as WaitForChangeOptions, a7 as CategorizedDiff, a8 as StructuredChangeAnalysis, a9 as ChangeBufferDrainResult, aa as SnapshotBookmark, ab as SemanticSearchCriteria, ac as SemanticSearchResponse, G as UIState, H as UIStateGroup, I as UITransition, T as TransitionResult, P as PathResult, N as NavigationResult, J as StateSnapshot, ad as IntentExecutionResult, ae as IntentSearchResponse, af as Intent, ag as RecoveryAttemptRequest, ah as RecoveryAttemptResult, ai as PageDataMap, aj as PageRegionMap, ak as StructuredDataExtraction, al as ComponentInfo, am as CrossAppComparisonReport, an as PageNavigationResponse, ao as PageNavigateRequest, ap as ElementDesignData, aq as InteractionStateName, ar as StateStyles, as as ResponsiveSnapshot, at as FormsResponse, F as FillFormRequest, w as FillResult, au as UndoRedoState, K as ElementHistoryOptions } from './types-zS11cuej.js';
+import { i as AnyCapturedEvent, u as CapturedError, M as UIBridgeConfig, z as ControlSnapshot, Q as ControlActionRequest, C as ControlActionResponse, x as BatchActionRequest, y as BatchActionResponse, R as ComponentActionRequest, g as ComponentActionResponse, V as FindRequest, X as FindResponse, Y as WorkflowRunRequest, Z as WorkflowRunResponse, S as SearchCriteria, _ as SearchResponse, $ as NLActionRequest, a0 as NLActionResponse, n as AssertionRequest, o as AssertionResult, p as BatchAssertionRequest, q as BatchAssertionResult, a1 as SemanticSnapshot, a2 as SemanticDiff, a3 as ActionWithDiffRequest, a4 as ActionDiffResult, a5 as ChangePredicate, a6 as WaitForChangeOptions, a7 as CategorizedDiff, a8 as StructuredChangeAnalysis, a9 as ChangeBufferDrainResult, aa as SnapshotBookmark, ab as SemanticSearchCriteria, ac as SemanticSearchResponse, G as UIState, H as UIStateGroup, I as UITransition, T as TransitionResult, P as PathResult, N as NavigationResult, J as StateSnapshot, ad as IntentExecutionResult, ae as IntentSearchResponse, af as Intent, ag as RecoveryAttemptRequest, ah as RecoveryAttemptResult, ai as PageDataMap, aj as PageRegionMap, ak as StructuredDataExtraction, al as ComponentInfo, am as CrossAppComparisonReport, an as PageNavigationResponse, ao as PageNavigateRequest, ap as ElementDesignData, aq as InteractionStateName, ar as StateStyles, as as ResponsiveSnapshot, at as FormsResponse, F as FillFormRequest, w as FillResult, au as UndoRedoState, K as ElementHistoryOptions } from './types-Chf3cfrT.js';
 import { U as UiBridgeErrorCode } from './codes.generated-CXeSH-M4.js';
 import { a as CompositeIdleStatus, S as SignalStatus } from './types-D7e9AWwl.js';
-import { E as EffectRecordEntry } from './effect-store-Cp6Kb2-X.js';
+import { E as EffectRecordEntry } from './effect-store-C0YCNUMx.js';
 import { RenderLogEntryType, RenderLogEntry } from './render-log/index.js';
 import { b as NetworkRequestEntry, W as WaitForRequestOptions, c as WaitForRequestResult } from './tracker-ChLmf8-u.js';
-import { F as FindContext, a as FindResult, b as FormSnapshot, c as FormDiff } from './find-DWZC8yoa.js';
-import { S as StyleGuideConfig, a as StyleAuditReport, E as EvaluateRequest, Q as QualityEvaluationReport, b as SnapshotDiffReport } from './style-types-De_9GaYG.js';
+import { F as FindContext, a as FindResult, b as FormSnapshot, c as FormDiff } from './find-DpPytcRP.js';
+import { S as StyleGuideConfig, a as StyleAuditReport, E as EvaluateRequest, Q as QualityEvaluationReport, b as SnapshotDiffReport } from './style-types-lmRdKbT8.js';
 import { E as ElementAnnotation, A as AnnotationConfig, a as AnnotationCoverage } from './types-C7D5seeQ.js';
-import { F as FingerprintedEvent, T as TimelineEntry, H as HealthReport, N as NetworkChain, E as ErrorSessionSummary, B as BaselineComparison, a as ErrorSnapshot } from './error-snapshot-owQQTv8i.js';
+import { F as FingerprintedEvent, T as TimelineEntry, H as HealthReport, N as NetworkChain, E as ErrorSessionSummary, B as BaselineComparison, a as ErrorSnapshot } from './error-snapshot-DENlqCYO.js';
 
 /**
  * Page Health Diagnostics
@@ -153,6 +153,27 @@ interface APIResponse<T = unknown> {
 /**
  * Render log query parameters
  */
+/**
+ * Request body for `POST /control/page/evaluate` (`pageEvaluate`).
+ *
+ * The body is forwarded verbatim to the runner, so any additional fields are
+ * preserved (index signature); the two known fields are typed for
+ * discoverability.
+ */
+interface PageEvaluateRequest {
+    /** JavaScript expression to evaluate in the target window. */
+    expression: string;
+    /**
+     * Target a runner pop-out window discoverable via `listWindows()`;
+     * omit → the main window. The runner reads this from the request body
+     * (`EvaluateQuery.window_label`) or the `?windowLabel=` query, **query
+     * wins** (`resolve_evaluate_window`); unknown labels yield a structured
+     * error naming the missing window.
+     */
+    windowLabel?: string;
+    /** Forward-compatible: extra fields are forwarded to the runner verbatim. */
+    [key: string]: unknown;
+}
 interface RenderLogQuery {
     /** Filter by entry type */
     type?: RenderLogEntryType;
@@ -345,6 +366,14 @@ interface UIBridgeServerHandlers {
          * `*`-glob matching concrete entries.
          */
         revealsAny?: string;
+        /**
+         * Target a runner pop-out window discoverable via `listWindows()`;
+         * omit → the main window. Serialized as the `?windowLabel=` query
+         * parameter (the runner reads it from the query on `GET
+         * /control/elements`); unknown labels yield a structured error naming
+         * the missing window.
+         */
+        windowLabel?: string;
     }, context?: HandlerContext) => Promise<APIResponse<ControlSnapshot['elements']>>;
     getElement: (id: string, options?: {
         recency?: string;
@@ -597,7 +626,7 @@ interface UIBridgeServerHandlers {
     pageNavigate: (request: PageNavigateRequest, context?: HandlerContext) => Promise<APIResponse<PageNavigationResponse>>;
     pageGoBack: (context?: HandlerContext) => Promise<APIResponse<PageNavigationResponse>>;
     pageGoForward: (context?: HandlerContext) => Promise<APIResponse<PageNavigationResponse>>;
-    pageEvaluate: (request: unknown, context?: HandlerContext) => Promise<APIResponse<unknown>>;
+    pageEvaluate: (request: PageEvaluateRequest, context?: HandlerContext) => Promise<APIResponse<unknown>>;
     pageScroll: (request: unknown, context?: HandlerContext) => Promise<APIResponse<unknown>>;
     clipboardWrite: (request: unknown, context?: HandlerContext) => Promise<APIResponse<unknown>>;
     clipboardRead: (context?: HandlerContext) => Promise<APIResponse<unknown>>;
@@ -1182,4 +1211,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 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 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 };

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

@@ -1,13 +1,13 @@
-import { i as AnyCapturedEvent, u as CapturedError, M as UIBridgeConfig, z as ControlSnapshot, Q as ControlActionRequest, C as ControlActionResponse, x as BatchActionRequest, y as BatchActionResponse, R as ComponentActionRequest, g as ComponentActionResponse, V as FindRequest, X as FindResponse, Y as WorkflowRunRequest, Z as WorkflowRunResponse, S as SearchCriteria, _ as SearchResponse, $ as NLActionRequest, a0 as NLActionResponse, n as AssertionRequest, o as AssertionResult, p as BatchAssertionRequest, q as BatchAssertionResult, a1 as SemanticSnapshot, a2 as SemanticDiff, a3 as ActionWithDiffRequest, a4 as ActionDiffResult, a5 as ChangePredicate, a6 as WaitForChangeOptions, a7 as CategorizedDiff, a8 as StructuredChangeAnalysis, a9 as ChangeBufferDrainResult, aa as SnapshotBookmark, ab as SemanticSearchCriteria, ac as SemanticSearchResponse, G as UIState, H as UIStateGroup, I as UITransition, T as TransitionResult, P as PathResult, N as NavigationResult, J as StateSnapshot, ad as IntentExecutionResult, ae as IntentSearchResponse, af as Intent, ag as RecoveryAttemptRequest, ah as RecoveryAttemptResult, ai as PageDataMap, aj as PageRegionMap, ak as StructuredDataExtraction, al as ComponentInfo, am as CrossAppComparisonReport, an as PageNavigationResponse, ao as PageNavigateRequest, ap as ElementDesignData, aq as InteractionStateName, ar as StateStyles, as as ResponsiveSnapshot, at as FormsResponse, F as FillFormRequest, w as FillResult, au as UndoRedoState, K as ElementHistoryOptions } from './types-D1UiLr75.mjs';
+import { i as AnyCapturedEvent, u as CapturedError, M as UIBridgeConfig, z as ControlSnapshot, Q as ControlActionRequest, C as ControlActionResponse, x as BatchActionRequest, y as BatchActionResponse, R as ComponentActionRequest, g as ComponentActionResponse, V as FindRequest, X as FindResponse, Y as WorkflowRunRequest, Z as WorkflowRunResponse, S as SearchCriteria, _ as SearchResponse, $ as NLActionRequest, a0 as NLActionResponse, n as AssertionRequest, o as AssertionResult, p as BatchAssertionRequest, q as BatchAssertionResult, a1 as SemanticSnapshot, a2 as SemanticDiff, a3 as ActionWithDiffRequest, a4 as ActionDiffResult, a5 as ChangePredicate, a6 as WaitForChangeOptions, a7 as CategorizedDiff, a8 as StructuredChangeAnalysis, a9 as ChangeBufferDrainResult, aa as SnapshotBookmark, ab as SemanticSearchCriteria, ac as SemanticSearchResponse, G as UIState, H as UIStateGroup, I as UITransition, T as TransitionResult, P as PathResult, N as NavigationResult, J as StateSnapshot, ad as IntentExecutionResult, ae as IntentSearchResponse, af as Intent, ag as RecoveryAttemptRequest, ah as RecoveryAttemptResult, ai as PageDataMap, aj as PageRegionMap, ak as StructuredDataExtraction, al as ComponentInfo, am as CrossAppComparisonReport, an as PageNavigationResponse, ao as PageNavigateRequest, ap as ElementDesignData, aq as InteractionStateName, ar as StateStyles, as as ResponsiveSnapshot, at as FormsResponse, F as FillFormRequest, w as FillResult, au as UndoRedoState, K as ElementHistoryOptions } from './types-DnqZodFb.mjs';
 import { U as UiBridgeErrorCode } from './codes.generated-CXeSH-M4.mjs';
 import { a as CompositeIdleStatus, S as SignalStatus } from './types-dIjjX5Mf.mjs';
-import { E as EffectRecordEntry } from './effect-store-C7l209DQ.mjs';
+import { E as EffectRecordEntry } from './effect-store-CATaXg5u.mjs';
 import { RenderLogEntryType, RenderLogEntry } from './render-log/index.mjs';
 import { b as NetworkRequestEntry, W as WaitForRequestOptions, c as WaitForRequestResult } from './tracker-ChLmf8-u.mjs';
-import { F as FindContext, a as FindResult, b as FormSnapshot, c as FormDiff } from './find-B4dTGeqA.mjs';
-import { S as StyleGuideConfig, a as StyleAuditReport, E as EvaluateRequest, Q as QualityEvaluationReport, b as SnapshotDiffReport } from './style-types-mvMAEeSI.mjs';
+import { F as FindContext, a as FindResult, b as FormSnapshot, c as FormDiff } from './find-A7hwZli6.mjs';
+import { S as StyleGuideConfig, a as StyleAuditReport, E as EvaluateRequest, Q as QualityEvaluationReport, b as SnapshotDiffReport } from './style-types-CtwPR05K.mjs';
 import { E as ElementAnnotation, A as AnnotationConfig, a as AnnotationCoverage } from './types-C7D5seeQ.mjs';
-import { F as FingerprintedEvent, T as TimelineEntry, H as HealthReport, N as NetworkChain, E as ErrorSessionSummary, B as BaselineComparison, a as ErrorSnapshot } from './error-snapshot-DCr4oUYq.mjs';
+import { F as FingerprintedEvent, T as TimelineEntry, H as HealthReport, N as NetworkChain, E as ErrorSessionSummary, B as BaselineComparison, a as ErrorSnapshot } from './error-snapshot-CmaQu6Ox.mjs';
 
 /**
  * Page Health Diagnostics
@@ -153,6 +153,27 @@ interface APIResponse<T = unknown> {
 /**
  * Render log query parameters
  */
+/**
+ * Request body for `POST /control/page/evaluate` (`pageEvaluate`).
+ *
+ * The body is forwarded verbatim to the runner, so any additional fields are
+ * preserved (index signature); the two known fields are typed for
+ * discoverability.
+ */
+interface PageEvaluateRequest {
+    /** JavaScript expression to evaluate in the target window. */
+    expression: string;
+    /**
+     * Target a runner pop-out window discoverable via `listWindows()`;
+     * omit → the main window. The runner reads this from the request body
+     * (`EvaluateQuery.window_label`) or the `?windowLabel=` query, **query
+     * wins** (`resolve_evaluate_window`); unknown labels yield a structured
+     * error naming the missing window.
+     */
+    windowLabel?: string;
+    /** Forward-compatible: extra fields are forwarded to the runner verbatim. */
+    [key: string]: unknown;
+}
 interface RenderLogQuery {
     /** Filter by entry type */
     type?: RenderLogEntryType;
@@ -345,6 +366,14 @@ interface UIBridgeServerHandlers {
          * `*`-glob matching concrete entries.
          */
         revealsAny?: string;
+        /**
+         * Target a runner pop-out window discoverable via `listWindows()`;
+         * omit → the main window. Serialized as the `?windowLabel=` query
+         * parameter (the runner reads it from the query on `GET
+         * /control/elements`); unknown labels yield a structured error naming
+         * the missing window.
+         */
+        windowLabel?: string;
     }, context?: HandlerContext) => Promise<APIResponse<ControlSnapshot['elements']>>;
     getElement: (id: string, options?: {
         recency?: string;
@@ -597,7 +626,7 @@ interface UIBridgeServerHandlers {
     pageNavigate: (request: PageNavigateRequest, context?: HandlerContext) => Promise<APIResponse<PageNavigationResponse>>;
     pageGoBack: (context?: HandlerContext) => Promise<APIResponse<PageNavigationResponse>>;
     pageGoForward: (context?: HandlerContext) => Promise<APIResponse<PageNavigationResponse>>;
-    pageEvaluate: (request: unknown, context?: HandlerContext) => Promise<APIResponse<unknown>>;
+    pageEvaluate: (request: PageEvaluateRequest, context?: HandlerContext) => Promise<APIResponse<unknown>>;
     pageScroll: (request: unknown, context?: HandlerContext) => Promise<APIResponse<unknown>>;
     clipboardWrite: (request: unknown, context?: HandlerContext) => Promise<APIResponse<unknown>>;
     clipboardRead: (context?: HandlerContext) => Promise<APIResponse<unknown>>;
@@ -1182,4 +1211,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 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 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 };

package/dist/{types-vftd8HsR.d.ts → types-DgIxG1sS.d.ts}

@@ -1,4 +1,4 @@
-import { i as SpecAssertionResult, e as SpecAssertion } from './types-cfwRCpgn.js';
+import { i as SpecAssertionResult, e as SpecAssertion } from './types-bG3xLcjL.js';
 
 /**
  * Verification Layers Types

package/dist/{types-Bz40rWAT.d.ts → types-DhJE_FQX.d.ts}

@@ -1,6 +1,6 @@
-import { g as SpecExecutionResult, h as SpecGroupResult } from './types-cfwRCpgn.js';
-import { C as ContractExecutionResult } from './types-C6ix-zFE.js';
-import { M as MatrixExecutionResult } from './types-vftd8HsR.js';
+import { g as SpecExecutionResult, h as SpecGroupResult } from './types-bG3xLcjL.js';
+import { C as ContractExecutionResult } from './types-CovPz-sh.js';
+import { M as MatrixExecutionResult } from './types-DgIxG1sS.js';
 
 /**
  * Artifact Types

package/dist/{types-D1UiLr75.d.mts → types-DnqZodFb.d.mts}

@@ -1215,6 +1215,18 @@ interface EffectVerification {
  * Extended action request with additional options
  */
 interface ControlActionRequest extends ActionRequest {
+    /**
+     * Target a runner pop-out window for this action; omit → the main window.
+     *
+     * Discover live window labels via `listWindows()` (the runner returns a
+     * structured error naming the missing window if the label is unknown). The
+     * runner resolves the target from the `?windowLabel=` **query parameter** on
+     * `POST /control/element/:id/action` (`ActionQueryParams.window_label`), so a
+     * caller issuing the HTTP request directly must append `?windowLabel=<label>`
+     * to the action URL — this typed field documents the option and carries it for
+     * transports that forward the request bag verbatim.
+     */
+    windowLabel?: string;
     /** Unique request ID for tracking */
     requestId?: string;
     /** Capture snapshot after action */

package/dist/{types-cfwRCpgn.d.ts → types-bG3xLcjL.d.ts}

@@ -1,4 +1,4 @@
-import { o as AssertionResult, S as SearchCriteria, r as AssertionType } from './types-zS11cuej.js';
+import { o as AssertionResult, S as SearchCriteria, r as AssertionType } from './types-Chf3cfrT.js';
 
 /**
  * Spec Types

package/dist/{types-q-2aMSnI.d.mts → types-cQzKFRd5.d.mts}

@@ -1,4 +1,4 @@
-import { i as SpecAssertionResult, e as SpecAssertion } from './types-BYhYroLP.mjs';
+import { i as SpecAssertionResult, e as SpecAssertion } from './types-gusNHeJt.mjs';
 
 /**
  * Verification Contract Types

package/dist/{types-BYhYroLP.d.mts → types-gusNHeJt.d.mts}

@@ -1,4 +1,4 @@
-import { o as AssertionResult, S as SearchCriteria, r as AssertionType } from './types-D1UiLr75.mjs';
+import { o as AssertionResult, S as SearchCriteria, r as AssertionType } from './types-DnqZodFb.mjs';
 
 /**
  * Spec Types

package/dist/verification-layers/index.d.mts

@@ -1,8 +1,8 @@
-import { U as UiAssertion, L as LayerAssertionResult, A as ApiAssertion, F as FsAssertion, D as DbAssertion, E as ExecutionMatrix, M as MatrixExecutionResult } from '../types-IQUAZlE2.mjs';
-export { a as ApiLayerResult, b as DbLayerResult, c as ExecutionStrategy, d as FsLayerResult, e as LayerSummary, f as LayeredAssertion, g as LayeredAssertionPayload, h as MATRIX_FILE_EXTENSION, i as UiLayerResult, V as VerificationLayer } from '../types-IQUAZlE2.mjs';
-import { D as DiscoveredElement, m as AIDiscoveredElement } from '../types-D1UiLr75.mjs';
-import { A as AssertionConfig } from '../assertions-C-uxQGa8.mjs';
-import '../types-BYhYroLP.mjs';
+import { U as UiAssertion, L as LayerAssertionResult, A as ApiAssertion, F as FsAssertion, D as DbAssertion, E as ExecutionMatrix, M as MatrixExecutionResult } from '../types-CgsWB31c.mjs';
+export { a as ApiLayerResult, b as DbLayerResult, c as ExecutionStrategy, d as FsLayerResult, e as LayerSummary, f as LayeredAssertion, g as LayeredAssertionPayload, h as MATRIX_FILE_EXTENSION, i as UiLayerResult, V as VerificationLayer } from '../types-CgsWB31c.mjs';
+import { D as DiscoveredElement, m as AIDiscoveredElement } from '../types-DnqZodFb.mjs';
+import { A as AssertionConfig } from '../assertions-j3SVwQrW.mjs';
+import '../types-gusNHeJt.mjs';
 import '../codes.generated-CXeSH-M4.mjs';
 
 /**

package/dist/verification-layers/index.d.ts

@@ -1,8 +1,8 @@
-import { U as UiAssertion, L as LayerAssertionResult, A as ApiAssertion, F as FsAssertion, D as DbAssertion, E as ExecutionMatrix, M as MatrixExecutionResult } from '../types-vftd8HsR.js';
-export { a as ApiLayerResult, b as DbLayerResult, c as ExecutionStrategy, d as FsLayerResult, e as LayerSummary, f as LayeredAssertion, g as LayeredAssertionPayload, h as MATRIX_FILE_EXTENSION, i as UiLayerResult, V as VerificationLayer } from '../types-vftd8HsR.js';
-import { D as DiscoveredElement, m as AIDiscoveredElement } from '../types-zS11cuej.js';
-import { A as AssertionConfig } from '../assertions-Cuf-hvNa.js';
-import '../types-cfwRCpgn.js';
+import { U as UiAssertion, L as LayerAssertionResult, A as ApiAssertion, F as FsAssertion, D as DbAssertion, E as ExecutionMatrix, M as MatrixExecutionResult } from '../types-DgIxG1sS.js';
+export { a as ApiLayerResult, b as DbLayerResult, c as ExecutionStrategy, d as FsLayerResult, e as LayerSummary, f as LayeredAssertion, g as LayeredAssertionPayload, h as MATRIX_FILE_EXTENSION, i as UiLayerResult, V as VerificationLayer } from '../types-DgIxG1sS.js';
+import { D as DiscoveredElement, m as AIDiscoveredElement } from '../types-Chf3cfrT.js';
+import { A as AssertionConfig } from '../assertions-DwPKlu6v.js';
+import '../types-bG3xLcjL.js';
 import '../codes.generated-CXeSH-M4.js';
 
 /**

package/dist/{websocket-client-Bmt4YNSR.d.ts → websocket-client-BEtd7_GO.d.ts}

@@ -1,4 +1,4 @@
-import { W as WSClientConfig, a as WSConnectionState, b as WSSubscriptionOptions, B as BridgeEventType, c as BridgeSnapshot, A as ActionRequest, d as ActionResponse, e as BridgeEvent, f as WSClientMessage } from './types-zS11cuej.js';
+import { W as WSClientConfig, a as WSConnectionState, b as WSSubscriptionOptions, B as BridgeEventType, c as BridgeSnapshot, A as ActionRequest, d as ActionResponse, e as BridgeEvent, f as WSClientMessage } from './types-Chf3cfrT.js';
 
 /**
  * WebSocket Client for UI Bridge

package/dist/{websocket-client-B_W7ZvT0.d.mts → websocket-client-CDRMdZdU.d.mts}

@@ -1,4 +1,4 @@
-import { W as WSClientConfig, a as WSConnectionState, b as WSSubscriptionOptions, B as BridgeEventType, c as BridgeSnapshot, A as ActionRequest, d as ActionResponse, e as BridgeEvent, f as WSClientMessage } from './types-D1UiLr75.mjs';
+import { W as WSClientConfig, a as WSConnectionState, b as WSSubscriptionOptions, B as BridgeEventType, c as BridgeSnapshot, A as ActionRequest, d as ActionResponse, e as BridgeEvent, f as WSClientMessage } from './types-DnqZodFb.mjs';
 
 /**
  * WebSocket Client for UI Bridge

package/dist/{ws-streaming-DGiomqt_.d.mts → ws-streaming-BzumSnWw.d.mts}

@@ -1,4 +1,4 @@
-import { E as ErrorSeverity, i as AnyCapturedEvent } from './types-D1UiLr75.mjs';
+import { E as ErrorSeverity, i as AnyCapturedEvent } from './types-DnqZodFb.mjs';
 
 /**
  * WebSocket Real-Time Streaming for Browser Events

package/dist/{ws-streaming-D_tat1kF.d.ts → ws-streaming-DweATXes.d.ts}

@@ -1,4 +1,4 @@
-import { E as ErrorSeverity, i as AnyCapturedEvent } from './types-zS11cuej.js';
+import { E as ErrorSeverity, i as AnyCapturedEvent } from './types-Chf3cfrT.js';
 
 /**
  * WebSocket Real-Time Streaming for Browser Events

package/package.json

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