@qontinui/ui-bridge 0.3.0 → 0.3.1

package/dist/{types-CHnlwiTK.d.ts → types-B2EfvEaq.d.ts}

@@ -1,7 +1,8 @@
-import { U as UIBridgeConfig } from './types-jKVgTI6_.js';
-import { d as ControlSnapshot, b as ControlActionRequest, c as ControlActionResponse, C as ComponentActionRequest, a as ComponentActionResponse, F as FindRequest, g as FindResponse, j as WorkflowRunRequest, k as WorkflowRunResponse } from './types-BkNRILUa.js';
-import { S as SearchCriteria, n as SearchResponse, N as NLActionRequest, l as NLActionResponse, d as AssertionRequest, e as AssertionResult, B as BatchAssertionRequest, g as BatchAssertionResult, t as SemanticSnapshot, p as SemanticDiff, q as SemanticSearchCriteria, r as SemanticSearchResponse } from './types-DfPqwU-i.js';
+import { a1 as UIBridgeConfig, C as CapturedError, a3 as UIState, a4 as UIStateGroup, a5 as UITransition, a0 as TransitionResult, T as PathResult, O as NavigationResult, $ as StateSnapshot } from './types-suaYwWWg.js';
+import { d as ControlSnapshot, b as ControlActionRequest, c as ControlActionResponse, C as ComponentActionRequest, a as ComponentActionResponse, F as FindRequest, h as FindResponse, l as WorkflowRunRequest, m as WorkflowRunResponse, i as PageNavigationResponse, P as PageNavigateRequest } from './types-C7gVYRnF.js';
+import { a8 as SearchCriteria, a9 as SearchResponse, X as NLActionRequest, Y as NLActionResponse, d as AssertionRequest, e as AssertionResult, B as BatchAssertionRequest, g as BatchAssertionResult, af as SemanticSnapshot, ab as SemanticDiff, ac as SemanticSearchCriteria, ad as SemanticSearchResponse, M as IntentExecutionResult, O as IntentSearchResponse, L as Intent, a4 as RecoveryAttemptRequest, a5 as RecoveryAttemptResult, a0 as PageDataMap, a2 as PageRegionMap, ai as StructuredDataExtraction, i as ComponentInfo, m as CrossAppComparisonReport } from './types-CebMQj76.js';
 import { RenderLogEntryType, RenderLogEntry } from './render-log/index.js';
+import { E as ElementAnnotation, a as AnnotationConfig, b as AnnotationCoverage } from './types-UBtp7R0u.js';
 
 /**
  * UI Bridge Server Types
@@ -115,6 +116,16 @@ interface UIBridgeServerHandlers {
     getMetrics: () => Promise<APIResponse<unknown>>;
     highlightElement: (id: string) => Promise<APIResponse<void>>;
     getElementTree: () => Promise<APIResponse<unknown>>;
+    getConsoleErrors: (params?: {
+        since?: number;
+        limit?: number;
+    }) => Promise<APIResponse<{
+        errors: CapturedError[];
+        count: number;
+    }>>;
+    clearConsoleErrors: () => Promise<APIResponse<{
+        cleared: boolean;
+    }>>;
     aiSearch: (criteria: SearchCriteria) => Promise<APIResponse<SearchResponse>>;
     aiExecute: (request: NLActionRequest) => Promise<APIResponse<NLActionResponse>>;
     aiAssert: (request: AssertionRequest) => Promise<APIResponse<AssertionResult>>;
@@ -123,6 +134,75 @@ interface UIBridgeServerHandlers {
     getSemanticDiff: (since?: number) => Promise<APIResponse<SemanticDiff | null>>;
     getPageSummary: () => Promise<APIResponse<string>>;
     aiSemanticSearch: (criteria: SemanticSearchCriteria) => Promise<APIResponse<SemanticSearchResponse>>;
+    getStates: () => Promise<APIResponse<UIState[]>>;
+    getState: (id: string) => Promise<APIResponse<UIState>>;
+    getActiveStates: () => Promise<APIResponse<UIState[]>>;
+    activateState: (id: string) => Promise<APIResponse<void>>;
+    deactivateState: (id: string) => Promise<APIResponse<void>>;
+    getStateGroups: () => Promise<APIResponse<UIStateGroup[]>>;
+    activateStateGroup: (id: string) => Promise<APIResponse<void>>;
+    deactivateStateGroup: (id: string) => Promise<APIResponse<void>>;
+    getTransitions: () => Promise<APIResponse<UITransition[]>>;
+    canExecuteTransition: (id: string) => Promise<APIResponse<{
+        canExecute: boolean;
+        reason?: string;
+    }>>;
+    executeTransition: (id: string) => Promise<APIResponse<TransitionResult>>;
+    findPath: (request: {
+        targetStates: string[];
+    }) => Promise<APIResponse<PathResult>>;
+    navigateTo: (request: {
+        targetStates: string[];
+    }) => Promise<APIResponse<NavigationResult>>;
+    getStateSnapshot: () => Promise<APIResponse<StateSnapshot>>;
+    executeIntent: (request: {
+        intentId: string;
+        params?: Record<string, unknown>;
+    }) => Promise<APIResponse<IntentExecutionResult>>;
+    findIntent: (request: {
+        query: string;
+    }) => Promise<APIResponse<IntentSearchResponse>>;
+    listIntents: () => Promise<APIResponse<Intent[]>>;
+    registerIntent: (intent: Intent) => Promise<APIResponse<Intent>>;
+    executeIntentFromQuery: (request: {
+        query: string;
+        params?: Record<string, unknown>;
+    }) => Promise<APIResponse<IntentExecutionResult>>;
+    attemptRecovery: (request: RecoveryAttemptRequest) => Promise<APIResponse<RecoveryAttemptResult>>;
+    analyzePageData: () => Promise<APIResponse<PageDataMap>>;
+    analyzePageRegions: () => Promise<APIResponse<PageRegionMap>>;
+    analyzeStructuredData: () => Promise<APIResponse<StructuredDataExtraction>>;
+    crossAppCompare: (request: {
+        sourceSnapshot: SemanticSnapshot;
+        targetSnapshot: SemanticSnapshot;
+        sourceComponents?: ComponentInfo[];
+        targetComponents?: ComponentInfo[];
+    }) => Promise<APIResponse<CrossAppComparisonReport>>;
+    pageRefresh: () => Promise<APIResponse<PageNavigationResponse>>;
+    pageNavigate: (request: PageNavigateRequest) => Promise<APIResponse<PageNavigationResponse>>;
+    pageGoBack: () => Promise<APIResponse<PageNavigationResponse>>;
+    pageGoForward: () => Promise<APIResponse<PageNavigationResponse>>;
+    getAnnotations: () => Promise<APIResponse<Record<string, ElementAnnotation>>>;
+    getAnnotation: (id: string) => Promise<APIResponse<ElementAnnotation>>;
+    setAnnotation: (id: string, annotation: ElementAnnotation) => Promise<APIResponse<ElementAnnotation>>;
+    deleteAnnotation: (id: string) => Promise<APIResponse<void>>;
+    importAnnotations: (config: AnnotationConfig) => Promise<APIResponse<{
+        count: number;
+    }>>;
+    exportAnnotations: () => Promise<APIResponse<AnnotationConfig>>;
+    getAnnotationCoverage: () => Promise<APIResponse<AnnotationCoverage>>;
+    getPerformanceEntries: () => Promise<APIResponse<unknown>>;
+    clearPerformanceEntries: () => Promise<APIResponse<{
+        cleared: boolean;
+    }>>;
+    getBrowserEvents: (params?: {
+        type?: string;
+        since?: number;
+        limit?: number;
+    }) => Promise<APIResponse<{
+        events: unknown[];
+        count: number;
+    }>>;
 }
 /**
  * Route definition

package/dist/{types-B7J7noLK.d.mts → types-C7gVYRnF.d.ts}

@@ -1,4 +1,4 @@
-import { q as ElementState, f as ActionRequest, g as ActionResponse, ae as WaitOptions } from './types-jKVgTI6_.mjs';
+import { z as ElementState, u as ContentMetadata, f as ActionRequest, g as ActionResponse, ax as WaitOptions } from './types-suaYwWWg.js';
 
 /**
  * Control Module Types
@@ -153,6 +153,10 @@ interface DiscoveredElement {
     state: ElementState;
     /** Whether registered with UI Bridge */
     registered: boolean;
+    /** Whether this is an interactive element or static content */
+    category?: 'interactive' | 'content';
+    /** Metadata for content elements */
+    contentMetadata?: ContentMetadata;
 }
 /**
  * Find request options
@@ -172,6 +176,12 @@ interface FindRequest {
     types?: string[];
     /** Filter by selector */
     selector?: string;
+    /** Include content (non-interactive) elements in results */
+    includeContent?: boolean;
+    /** Only return content elements */
+    contentOnly?: boolean;
+    /** Filter by content role */
+    contentRole?: string;
 }
 /**
  * Find response
@@ -209,6 +219,8 @@ interface ControlSnapshot {
         label?: string;
         actions: string[];
         state: ElementState;
+        category?: 'interactive' | 'content';
+        contentMetadata?: ContentMetadata;
     }>;
     /** All registered components */
     components: Array<{
@@ -247,6 +259,46 @@ interface KeyboardAction {
     /** Hold duration for key press */
     holdDuration?: number;
 }
+/**
+ * Drag action parameters
+ *
+ * Drags the source element to a target element or position by dispatching
+ * a sequence of mouse events: mousedown → mousemove × N → mouseup.
+ * Optionally dispatches HTML5 drag events (dragstart, dragover, drop, dragend)
+ * for applications that listen to those instead of mouse events.
+ */
+interface DragAction {
+    /** Target element to drag to (resolved via registry or DOM query) */
+    target?: {
+        /** UI Bridge element ID (checked in registry first) */
+        elementId?: string;
+        /** CSS selector */
+        selector?: string;
+    };
+    /** Target coordinates (absolute client position, alternative to target element) */
+    targetPosition?: {
+        x: number;
+        y: number;
+    };
+    /** Source offset from element center in pixels (default: element center) */
+    sourceOffset?: {
+        x: number;
+        y: number;
+    };
+    /** Target offset from target element center in pixels (default: element center) */
+    targetOffset?: {
+        x: number;
+        y: number;
+    };
+    /** Number of intermediate mousemove steps (default: 10) */
+    steps?: number;
+    /** Delay in ms between mousedown and first move (default: 100) */
+    holdDelay?: number;
+    /** Delay in ms after mouseup (default: 50) */
+    releaseDelay?: number;
+    /** Also dispatch HTML5 drag events (dragstart/dragover/drop/dragend) alongside mouse events (default: false) */
+    html5?: boolean;
+}
 /**
  * Action types for mouse input
  */
@@ -318,6 +370,24 @@ interface WaitResult {
     /** Error if timed out */
     error?: string;
 }
+/**
+ * Page navigation request
+ */
+interface PageNavigateRequest {
+    /** URL to navigate to */
+    url: string;
+}
+/**
+ * Page navigation response
+ */
+interface PageNavigationResponse {
+    /** Whether the navigation succeeded */
+    success: boolean;
+    /** Current URL after navigation */
+    url?: string;
+    /** Timestamp */
+    timestamp: number;
+}
 /**
  * Action executor interface
  */
@@ -351,4 +421,4 @@ interface WorkflowEngine {
     listActiveRuns(): Promise<WorkflowRunResponse[]>;
 }
 
-export type { ActionExecutor as A, ComponentActionRequest as C, DiscoveredElement as D, FindRequest as F, KeyboardAction as K, MouseAction as M, ScrollAction as S, TypeAction as T, WaitResult as W, ComponentActionResponse as a, ControlActionRequest as b, ControlActionResponse as c, ControlSnapshot as d, DiscoveryRequest as e, DiscoveryResponse as f, FindResponse as g, SelectAction as h, WorkflowEngine as i, WorkflowRunRequest as j, WorkflowRunResponse as k, WorkflowRunStatus as l, WorkflowStepResult as m };
+export type { ActionExecutor as A, ComponentActionRequest as C, DiscoveredElement as D, FindRequest as F, KeyboardAction as K, MouseAction as M, PageNavigateRequest as P, ScrollAction as S, TypeAction as T, WaitResult as W, ComponentActionResponse as a, ControlActionRequest as b, ControlActionResponse as c, ControlSnapshot as d, DiscoveryRequest as e, DiscoveryResponse as f, DragAction as g, FindResponse as h, PageNavigationResponse as i, SelectAction as j, WorkflowEngine as k, WorkflowRunRequest as l, WorkflowRunResponse as m, WorkflowRunStatus as n, WorkflowStepResult as o };

package/dist/{types-BkNRILUa.d.ts → types-CJGrBEhC.d.mts}

@@ -1,4 +1,4 @@
-import { q as ElementState, f as ActionRequest, g as ActionResponse, ae as WaitOptions } from './types-jKVgTI6_.js';
+import { z as ElementState, u as ContentMetadata, f as ActionRequest, g as ActionResponse, ax as WaitOptions } from './types-suaYwWWg.mjs';
 
 /**
  * Control Module Types
@@ -153,6 +153,10 @@ interface DiscoveredElement {
     state: ElementState;
     /** Whether registered with UI Bridge */
     registered: boolean;
+    /** Whether this is an interactive element or static content */
+    category?: 'interactive' | 'content';
+    /** Metadata for content elements */
+    contentMetadata?: ContentMetadata;
 }
 /**
  * Find request options
@@ -172,6 +176,12 @@ interface FindRequest {
     types?: string[];
     /** Filter by selector */
     selector?: string;
+    /** Include content (non-interactive) elements in results */
+    includeContent?: boolean;
+    /** Only return content elements */
+    contentOnly?: boolean;
+    /** Filter by content role */
+    contentRole?: string;
 }
 /**
  * Find response
@@ -209,6 +219,8 @@ interface ControlSnapshot {
         label?: string;
         actions: string[];
         state: ElementState;
+        category?: 'interactive' | 'content';
+        contentMetadata?: ContentMetadata;
     }>;
     /** All registered components */
     components: Array<{
@@ -247,6 +259,46 @@ interface KeyboardAction {
     /** Hold duration for key press */
     holdDuration?: number;
 }
+/**
+ * Drag action parameters
+ *
+ * Drags the source element to a target element or position by dispatching
+ * a sequence of mouse events: mousedown → mousemove × N → mouseup.
+ * Optionally dispatches HTML5 drag events (dragstart, dragover, drop, dragend)
+ * for applications that listen to those instead of mouse events.
+ */
+interface DragAction {
+    /** Target element to drag to (resolved via registry or DOM query) */
+    target?: {
+        /** UI Bridge element ID (checked in registry first) */
+        elementId?: string;
+        /** CSS selector */
+        selector?: string;
+    };
+    /** Target coordinates (absolute client position, alternative to target element) */
+    targetPosition?: {
+        x: number;
+        y: number;
+    };
+    /** Source offset from element center in pixels (default: element center) */
+    sourceOffset?: {
+        x: number;
+        y: number;
+    };
+    /** Target offset from target element center in pixels (default: element center) */
+    targetOffset?: {
+        x: number;
+        y: number;
+    };
+    /** Number of intermediate mousemove steps (default: 10) */
+    steps?: number;
+    /** Delay in ms between mousedown and first move (default: 100) */
+    holdDelay?: number;
+    /** Delay in ms after mouseup (default: 50) */
+    releaseDelay?: number;
+    /** Also dispatch HTML5 drag events (dragstart/dragover/drop/dragend) alongside mouse events (default: false) */
+    html5?: boolean;
+}
 /**
  * Action types for mouse input
  */
@@ -318,6 +370,24 @@ interface WaitResult {
     /** Error if timed out */
     error?: string;
 }
+/**
+ * Page navigation request
+ */
+interface PageNavigateRequest {
+    /** URL to navigate to */
+    url: string;
+}
+/**
+ * Page navigation response
+ */
+interface PageNavigationResponse {
+    /** Whether the navigation succeeded */
+    success: boolean;
+    /** Current URL after navigation */
+    url?: string;
+    /** Timestamp */
+    timestamp: number;
+}
 /**
  * Action executor interface
  */
@@ -351,4 +421,4 @@ interface WorkflowEngine {
     listActiveRuns(): Promise<WorkflowRunResponse[]>;
 }
 
-export type { ActionExecutor as A, ComponentActionRequest as C, DiscoveredElement as D, FindRequest as F, KeyboardAction as K, MouseAction as M, ScrollAction as S, TypeAction as T, WaitResult as W, ComponentActionResponse as a, ControlActionRequest as b, ControlActionResponse as c, ControlSnapshot as d, DiscoveryRequest as e, DiscoveryResponse as f, FindResponse as g, SelectAction as h, WorkflowEngine as i, WorkflowRunRequest as j, WorkflowRunResponse as k, WorkflowRunStatus as l, WorkflowStepResult as m };
+export type { ActionExecutor as A, ComponentActionRequest as C, DiscoveredElement as D, FindRequest as F, KeyboardAction as K, MouseAction as M, PageNavigateRequest as P, ScrollAction as S, TypeAction as T, WaitResult as W, ComponentActionResponse as a, ControlActionRequest as b, ControlActionResponse as c, ControlSnapshot as d, DiscoveryRequest as e, DiscoveryResponse as f, DragAction as g, FindResponse as h, PageNavigationResponse as i, SelectAction as j, WorkflowEngine as k, WorkflowRunRequest as l, WorkflowRunResponse as m, WorkflowRunStatus as n, WorkflowStepResult as o };