@qontinui/ui-bridge 0.2.0 → 0.3.0

package/dist/swc-plugin/index.d.ts

@@ -0,0 +1,79 @@
+/**
+ * UI Bridge SWC Plugin Configuration
+ */
+interface UIBridgeSwcPluginConfig {
+    /**
+     * Elements to automatically instrument
+     * @default ['button', 'input', 'select', 'textarea', 'a', 'form']
+     */
+    elements?: string[];
+    /**
+     * Prefix for generated IDs
+     * @default 'ui'
+     */
+    idPrefix?: string;
+    /**
+     * Attribute name for the generated ID
+     * @default 'data-ui-id'
+     */
+    idAttribute?: string;
+    /**
+     * Attribute name for aliases
+     * @default 'data-ui-aliases'
+     */
+    aliasesAttribute?: string;
+    /**
+     * Attribute name for element type
+     * @default 'data-ui-type'
+     */
+    typeAttribute?: string;
+    /**
+     * Generate aliases from text content
+     * @default true
+     */
+    generateAliases?: boolean;
+    /**
+     * Include component name in generated ID
+     * @default true
+     */
+    includeComponentName?: boolean;
+    /**
+     * Include file path in generated ID
+     * @default false
+     */
+    includeFilePath?: boolean;
+    /**
+     * Hash the generated ID for shorter strings
+     * @default false
+     */
+    hashIds?: boolean;
+    /**
+     * Maximum alias count per element
+     * @default 5
+     */
+    maxAliases?: number;
+    /**
+     * Skip elements that already have data-ui-id
+     * @default true
+     */
+    skipExisting?: boolean;
+    /**
+     * Only instrument elements inside components with specific names
+     * @default []
+     */
+    onlyInComponents?: string[];
+    /**
+     * Skip instrumentation for elements inside these components
+     * @default []
+     */
+    skipInComponents?: string[];
+    /**
+     * Enable verbose logging during build
+     * @default false
+     */
+    verbose?: boolean;
+}
+
+declare const pluginPath: string;
+
+export { type UIBridgeSwcPluginConfig, pluginPath as default };

package/dist/swc-plugin/index.js

@@ -0,0 +1,15 @@
+'use strict';
+
+var path = require('path');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var path__default = /*#__PURE__*/_interopDefault(path);
+
+// src/swc-plugin/index.ts
+var pluginPath = path__default.default.join(__dirname, "..", "..", "swc-plugin-wasm", "ui_bridge_swc_plugin.wasm");
+var swc_plugin_default = pluginPath;
+
+module.exports = swc_plugin_default;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/swc-plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/swc-plugin/index.ts"],"names":["path"],"mappings":";;;;;;;;;AAqBA,IAAM,aAAaA,qBAAA,CAAK,IAAA,CAAK,WAAW,IAAA,EAAM,IAAA,EAAM,mBAAmB,2BAA2B,CAAA;AAElG,IAAO,kBAAA,GAAQ","file":"index.js","sourcesContent":["/**\n * SWC Plugin for UI Bridge\n *\n * Provides the path to the pre-built WASM plugin binary.\n *\n * @example\n * ```js\n * // next.config.js\n * const swcPluginPath = require('@qontinui/ui-bridge/swc-plugin').default;\n *\n * module.exports = {\n *   experimental: {\n *     swcPlugins: [[swcPluginPath, { elements: ['button', 'input'] }]]\n *   }\n * };\n * ```\n */\nimport path from 'path';\n\nexport type { UIBridgeSwcPluginConfig } from './types';\n\nconst pluginPath = path.join(__dirname, '..', '..', 'swc-plugin-wasm', 'ui_bridge_swc_plugin.wasm');\n\nexport default pluginPath;\n"]}

package/dist/swc-plugin/index.mjs

@@ -0,0 +1,9 @@
+import path from 'path';
+
+// src/swc-plugin/index.ts
+var pluginPath = path.join(__dirname, "..", "..", "swc-plugin-wasm", "ui_bridge_swc_plugin.wasm");
+var swc_plugin_default = pluginPath;
+
+export { swc_plugin_default as default };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/swc-plugin/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/swc-plugin/index.ts"],"names":[],"mappings":";;;AAqBA,IAAM,aAAa,IAAA,CAAK,IAAA,CAAK,WAAW,IAAA,EAAM,IAAA,EAAM,mBAAmB,2BAA2B,CAAA;AAElG,IAAO,kBAAA,GAAQ","file":"index.mjs","sourcesContent":["/**\n * SWC Plugin for UI Bridge\n *\n * Provides the path to the pre-built WASM plugin binary.\n *\n * @example\n * ```js\n * // next.config.js\n * const swcPluginPath = require('@qontinui/ui-bridge/swc-plugin').default;\n *\n * module.exports = {\n *   experimental: {\n *     swcPlugins: [[swcPluginPath, { elements: ['button', 'input'] }]]\n *   }\n * };\n * ```\n */\nimport path from 'path';\n\nexport type { UIBridgeSwcPluginConfig } from './types';\n\nconst pluginPath = path.join(__dirname, '..', '..', 'swc-plugin-wasm', 'ui_bridge_swc_plugin.wasm');\n\nexport default pluginPath;\n"]}

package/dist/{types-CFT3Dnx4.d.mts → types-B5Q0GVo0.d.mts}

@@ -1,5 +1,5 @@
-import { i as ElementType, h as ElementState } from './types-CPMbN_Iw.mjs';
-import { D as DiscoveredElement } from './types-Dr6tH-bm.mjs';
+import { r as ElementType, q as ElementState } from './types-jKVgTI6_.mjs';
+import { D as DiscoveredElement } from './types-B7J7noLK.mjs';
 
 /**
  * AI Module Types
@@ -212,6 +212,63 @@ interface ParsedAction {
     /** Parse confidence */
     parseConfidence: number;
 }
+/**
+ * Partial match information for structured failures
+ */
+interface PartialMatchInfo {
+    /** Element ID */
+    elementId: string;
+    /** Match confidence 0-1 */
+    confidence: number;
+    /** Why this element was considered but not selected */
+    reason: string;
+    /** Element type */
+    type: string;
+    /** Element description/label */
+    description?: string;
+}
+/**
+ * Recovery suggestion for structured failures
+ */
+interface RecoverySuggestionInfo {
+    /** Human-readable suggestion */
+    suggestion: string;
+    /** Machine-executable command (if applicable) */
+    command?: string;
+    /** Confidence that this action will help (0-1) */
+    confidence: number;
+    /** Whether retry with same parameters might help */
+    retryable: boolean;
+}
+/**
+ * Structured failure information for NL action responses
+ */
+interface StructuredFailureInfo {
+    /** Machine-readable error code */
+    errorCode: string;
+    /** Human-readable error message */
+    message: string;
+    /** Target element ID (if known) */
+    elementId?: string;
+    /** Selectors/strategies that were attempted */
+    selectorsTried?: string[];
+    /** Similar elements that were found but not used */
+    partialMatches?: PartialMatchInfo[];
+    /** Current state of the target element (if found) */
+    elementState?: ElementState;
+    /** Reference to visual context (screenshot path/id) */
+    screenshotContext?: string;
+    /** Suggested recovery actions */
+    suggestedActions?: RecoverySuggestionInfo[];
+    /** Whether retry with same parameters might help */
+    retryRecommended: boolean;
+    /** Additional context data */
+    context?: Record<string, unknown>;
+    /** Duration before failure in milliseconds */
+    durationMs?: number;
+    /** Timeout value that was exceeded (for timeout errors) */
+    timeoutMs?: number;
+}
 /**
  * Response from executing a natural language action
  */
@@ -238,6 +295,8 @@ interface NLActionResponse {
     suggestions?: string[];
     /** Alternative elements that could have been used */
     alternatives?: SearchResult[];
+    /** Detailed failure information when success is false */
+    failureInfo?: StructuredFailureInfo;
 }
 /**
  * Types of assertions that can be made about elements
@@ -464,6 +523,59 @@ interface ElementModification {
     /** Whether this is a significant change */
     significant: boolean;
 }
+/**
+ * Semantic search criteria using embeddings
+ */
+interface SemanticSearchCriteria {
+    /** Natural language query for semantic matching */
+    query: string;
+    /** Minimum similarity score (0-1, default: 0.5) */
+    threshold?: number;
+    /** Maximum results to return */
+    limit?: number;
+    /** Filter by element type */
+    type?: string;
+    /** Filter by ARIA role */
+    role?: string;
+    /** Combine with text-based search */
+    combineWithText?: boolean;
+}
+/**
+ * Semantic search result
+ */
+interface SemanticSearchResult {
+    /** The matched element */
+    element: AIDiscoveredElement;
+    /** Semantic similarity score (0-1) */
+    similarity: number;
+    /** Rank in results (1-indexed) */
+    rank: number;
+    /** Text that was used for embedding */
+    embeddedText: string;
+}
+/**
+ * Response from semantic search operations
+ */
+interface SemanticSearchResponse {
+    /** All matching results sorted by similarity */
+    results: SemanticSearchResult[];
+    /** Best match (highest similarity above threshold) */
+    bestMatch: SemanticSearchResult | null;
+    /** Total elements scanned */
+    scannedCount: number;
+    /** Search duration in milliseconds */
+    durationMs: number;
+    /** Query used */
+    query: string;
+    /** Embedding provider info */
+    providerInfo?: {
+        provider: string;
+        model: string;
+        dimension: number;
+    };
+    /** Timestamp */
+    timestamp: number;
+}
 /**
  * Rich error context for AI agents
  */
@@ -531,4 +643,4 @@ interface AIElementRegistrationOptions {
     autoGenerateAliases?: boolean;
 }
 
-export type { AIDiscoveredElement as A, BatchAssertionRequest as B, ElementChange as E, FormAnalysis as F, ModalState as M, NLActionRequest as N, PageContext as P, RecoverySuggestion as R, SearchCriteria as S, AIElementRegistrationOptions as a, AIErrorContext as b, AIFindResponse as c, AssertionRequest as d, AssertionResult as e, AssertionType as f, BatchAssertionResult as g, ElementModification as h, FormFieldAnalysis as i, FormFieldState as j, FormState as k, NLActionResponse as l, ParsedAction as m, SearchResponse as n, SearchResult as o, SemanticDiff as p, SemanticSnapshot as q };
+export type { AIDiscoveredElement as A, BatchAssertionRequest as B, ElementChange as E, FormAnalysis as F, ModalState as M, NLActionRequest as N, PageContext as P, RecoverySuggestion as R, SearchCriteria as S, AIElementRegistrationOptions as a, AIErrorContext as b, AIFindResponse as c, AssertionRequest as d, AssertionResult as e, AssertionType as f, BatchAssertionResult as g, ElementModification as h, FormFieldAnalysis as i, FormFieldState as j, FormState as k, NLActionResponse as l, ParsedAction as m, SearchResponse as n, SearchResult as o, SemanticDiff as p, SemanticSearchCriteria as q, SemanticSearchResponse as r, SemanticSearchResult as s, SemanticSnapshot as t };

package/dist/{types-Dr6tH-bm.d.mts → types-B7J7noLK.d.mts}

@@ -1,4 +1,4 @@
-import { h as ElementState, a as ActionRequest, b as ActionResponse, a0 as WaitOptions } from './types-CPMbN_Iw.mjs';
+import { q as ElementState, f as ActionRequest, g as ActionResponse, ae as WaitOptions } from './types-jKVgTI6_.mjs';
 
 /**
  * Control Module Types

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

@@ -1,4 +1,4 @@
-import { h as ElementState, a as ActionRequest, b as ActionResponse, a0 as WaitOptions } from './types-CPMbN_Iw.js';
+import { q as ElementState, f as ActionRequest, g as ActionResponse, ae as WaitOptions } from './types-jKVgTI6_.js';
 
 /**
  * Control Module Types

package/dist/types-CEQLnFMv.d.mts

@@ -0,0 +1,156 @@
+import { U as UIBridgeConfig } from './types-jKVgTI6_.mjs';
+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-B7J7noLK.mjs';
+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-B5Q0GVo0.mjs';
+import { RenderLogEntryType, RenderLogEntry } from './render-log/index.mjs';
+
+/**
+ * UI Bridge Server Types
+ *
+ * Shared types for server adapters.
+ */
+
+/**
+ * Server configuration
+ */
+interface UIBridgeServerConfig extends UIBridgeConfig {
+    /** Base path for API routes */
+    basePath?: string;
+    /** Enable CORS */
+    cors?: boolean | CORSOptions;
+    /** Authentication middleware */
+    authenticate?: (req: unknown) => boolean | Promise<boolean>;
+    /** Rate limiting */
+    rateLimit?: RateLimitOptions;
+}
+/**
+ * CORS options
+ */
+interface CORSOptions {
+    /** Allowed origins */
+    origin?: string | string[] | boolean;
+    /** Allowed methods */
+    methods?: string[];
+    /** Allowed headers */
+    headers?: string[];
+    /** Expose headers */
+    exposeHeaders?: string[];
+    /** Allow credentials */
+    credentials?: boolean;
+    /** Max age for preflight cache */
+    maxAge?: number;
+}
+/**
+ * Rate limit options
+ */
+interface RateLimitOptions {
+    /** Time window in milliseconds */
+    windowMs?: number;
+    /** Max requests per window */
+    max?: number;
+    /** Message when rate limited */
+    message?: string;
+}
+/**
+ * API response wrapper
+ */
+interface APIResponse<T = unknown> {
+    /** Whether the request succeeded */
+    success: boolean;
+    /** Response data */
+    data?: T;
+    /** Error message if failed */
+    error?: string;
+    /** Error code */
+    code?: string;
+    /** Request timestamp */
+    timestamp: number;
+}
+/**
+ * Render log query parameters
+ */
+interface RenderLogQuery {
+    /** Filter by entry type */
+    type?: RenderLogEntryType;
+    /** Filter entries since timestamp */
+    since?: number;
+    /** Filter entries until timestamp */
+    until?: number;
+    /** Limit number of results */
+    limit?: number;
+}
+/**
+ * Server handler interface
+ *
+ * Implementations provide these handlers for different frameworks.
+ */
+interface UIBridgeServerHandlers {
+    getRenderLog: (query?: RenderLogQuery) => Promise<APIResponse<RenderLogEntry[]>>;
+    clearRenderLog: () => Promise<APIResponse<void>>;
+    captureSnapshot: () => Promise<APIResponse<unknown>>;
+    getRenderLogPath: () => Promise<APIResponse<{
+        path: string;
+    }>>;
+    getElements: () => Promise<APIResponse<ControlSnapshot['elements']>>;
+    getElement: (id: string) => Promise<APIResponse<ControlSnapshot['elements'][0]>>;
+    getElementState: (id: string) => Promise<APIResponse<unknown>>;
+    executeElementAction: (id: string, request: ControlActionRequest) => Promise<APIResponse<ControlActionResponse>>;
+    getComponents: () => Promise<APIResponse<ControlSnapshot['components']>>;
+    getComponent: (id: string) => Promise<APIResponse<ControlSnapshot['components'][0]>>;
+    getComponentState: (id: string) => Promise<APIResponse<{
+        state: Record<string, unknown>;
+        computed: Record<string, unknown>;
+        timestamp: number;
+    }>>;
+    executeComponentAction: (id: string, request: ComponentActionRequest) => Promise<APIResponse<ComponentActionResponse>>;
+    find: (request?: FindRequest) => Promise<APIResponse<FindResponse>>;
+    /**
+     * @deprecated Use find() instead
+     */
+    discover: (request?: FindRequest) => Promise<APIResponse<FindResponse>>;
+    getControlSnapshot: () => Promise<APIResponse<ControlSnapshot>>;
+    getWorkflows: () => Promise<APIResponse<ControlSnapshot['workflows']>>;
+    runWorkflow: (id: string, request?: WorkflowRunRequest) => Promise<APIResponse<WorkflowRunResponse>>;
+    getWorkflowStatus: (runId: string) => Promise<APIResponse<WorkflowRunResponse>>;
+    getActionHistory: (limit?: number) => Promise<APIResponse<unknown[]>>;
+    getMetrics: () => Promise<APIResponse<unknown>>;
+    highlightElement: (id: string) => Promise<APIResponse<void>>;
+    getElementTree: () => Promise<APIResponse<unknown>>;
+    aiSearch: (criteria: SearchCriteria) => Promise<APIResponse<SearchResponse>>;
+    aiExecute: (request: NLActionRequest) => Promise<APIResponse<NLActionResponse>>;
+    aiAssert: (request: AssertionRequest) => Promise<APIResponse<AssertionResult>>;
+    aiAssertBatch: (request: BatchAssertionRequest) => Promise<APIResponse<BatchAssertionResult>>;
+    getSemanticSnapshot: () => Promise<APIResponse<SemanticSnapshot>>;
+    getSemanticDiff: (since?: number) => Promise<APIResponse<SemanticDiff | null>>;
+    getPageSummary: () => Promise<APIResponse<string>>;
+    aiSemanticSearch: (criteria: SemanticSearchCriteria) => Promise<APIResponse<SemanticSearchResponse>>;
+}
+/**
+ * Route definition
+ */
+interface RouteDefinition {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    path: string;
+    handler: string;
+    params?: string[];
+    bodyRequired?: boolean;
+}
+/**
+ * All UI Bridge routes
+ */
+declare const UI_BRIDGE_ROUTES: RouteDefinition[];
+/**
+ * WebSocket message types
+ */
+type WebSocketMessageType = 'subscribe' | 'unsubscribe' | 'event' | 'snapshot' | 'action' | 'error';
+/**
+ * WebSocket message
+ */
+interface WebSocketMessage<T = unknown> {
+    type: WebSocketMessageType;
+    channel?: string;
+    data?: T;
+    error?: string;
+    timestamp: number;
+}
+
+export { type APIResponse as A, type CORSOptions as C, type RateLimitOptions as R, type UIBridgeServerConfig as U, type WebSocketMessage as W, type RenderLogQuery as a, type RouteDefinition as b, type UIBridgeServerHandlers as c, UI_BRIDGE_ROUTES as d, type WebSocketMessageType as e };

package/dist/types-CHnlwiTK.d.ts

@@ -0,0 +1,156 @@
+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 { RenderLogEntryType, RenderLogEntry } from './render-log/index.js';
+
+/**
+ * UI Bridge Server Types
+ *
+ * Shared types for server adapters.
+ */
+
+/**
+ * Server configuration
+ */
+interface UIBridgeServerConfig extends UIBridgeConfig {
+    /** Base path for API routes */
+    basePath?: string;
+    /** Enable CORS */
+    cors?: boolean | CORSOptions;
+    /** Authentication middleware */
+    authenticate?: (req: unknown) => boolean | Promise<boolean>;
+    /** Rate limiting */
+    rateLimit?: RateLimitOptions;
+}
+/**
+ * CORS options
+ */
+interface CORSOptions {
+    /** Allowed origins */
+    origin?: string | string[] | boolean;
+    /** Allowed methods */
+    methods?: string[];
+    /** Allowed headers */
+    headers?: string[];
+    /** Expose headers */
+    exposeHeaders?: string[];
+    /** Allow credentials */
+    credentials?: boolean;
+    /** Max age for preflight cache */
+    maxAge?: number;
+}
+/**
+ * Rate limit options
+ */
+interface RateLimitOptions {
+    /** Time window in milliseconds */
+    windowMs?: number;
+    /** Max requests per window */
+    max?: number;
+    /** Message when rate limited */
+    message?: string;
+}
+/**
+ * API response wrapper
+ */
+interface APIResponse<T = unknown> {
+    /** Whether the request succeeded */
+    success: boolean;
+    /** Response data */
+    data?: T;
+    /** Error message if failed */
+    error?: string;
+    /** Error code */
+    code?: string;
+    /** Request timestamp */
+    timestamp: number;
+}
+/**
+ * Render log query parameters
+ */
+interface RenderLogQuery {
+    /** Filter by entry type */
+    type?: RenderLogEntryType;
+    /** Filter entries since timestamp */
+    since?: number;
+    /** Filter entries until timestamp */
+    until?: number;
+    /** Limit number of results */
+    limit?: number;
+}
+/**
+ * Server handler interface
+ *
+ * Implementations provide these handlers for different frameworks.
+ */
+interface UIBridgeServerHandlers {
+    getRenderLog: (query?: RenderLogQuery) => Promise<APIResponse<RenderLogEntry[]>>;
+    clearRenderLog: () => Promise<APIResponse<void>>;
+    captureSnapshot: () => Promise<APIResponse<unknown>>;
+    getRenderLogPath: () => Promise<APIResponse<{
+        path: string;
+    }>>;
+    getElements: () => Promise<APIResponse<ControlSnapshot['elements']>>;
+    getElement: (id: string) => Promise<APIResponse<ControlSnapshot['elements'][0]>>;
+    getElementState: (id: string) => Promise<APIResponse<unknown>>;
+    executeElementAction: (id: string, request: ControlActionRequest) => Promise<APIResponse<ControlActionResponse>>;
+    getComponents: () => Promise<APIResponse<ControlSnapshot['components']>>;
+    getComponent: (id: string) => Promise<APIResponse<ControlSnapshot['components'][0]>>;
+    getComponentState: (id: string) => Promise<APIResponse<{
+        state: Record<string, unknown>;
+        computed: Record<string, unknown>;
+        timestamp: number;
+    }>>;
+    executeComponentAction: (id: string, request: ComponentActionRequest) => Promise<APIResponse<ComponentActionResponse>>;
+    find: (request?: FindRequest) => Promise<APIResponse<FindResponse>>;
+    /**
+     * @deprecated Use find() instead
+     */
+    discover: (request?: FindRequest) => Promise<APIResponse<FindResponse>>;
+    getControlSnapshot: () => Promise<APIResponse<ControlSnapshot>>;
+    getWorkflows: () => Promise<APIResponse<ControlSnapshot['workflows']>>;
+    runWorkflow: (id: string, request?: WorkflowRunRequest) => Promise<APIResponse<WorkflowRunResponse>>;
+    getWorkflowStatus: (runId: string) => Promise<APIResponse<WorkflowRunResponse>>;
+    getActionHistory: (limit?: number) => Promise<APIResponse<unknown[]>>;
+    getMetrics: () => Promise<APIResponse<unknown>>;
+    highlightElement: (id: string) => Promise<APIResponse<void>>;
+    getElementTree: () => Promise<APIResponse<unknown>>;
+    aiSearch: (criteria: SearchCriteria) => Promise<APIResponse<SearchResponse>>;
+    aiExecute: (request: NLActionRequest) => Promise<APIResponse<NLActionResponse>>;
+    aiAssert: (request: AssertionRequest) => Promise<APIResponse<AssertionResult>>;
+    aiAssertBatch: (request: BatchAssertionRequest) => Promise<APIResponse<BatchAssertionResult>>;
+    getSemanticSnapshot: () => Promise<APIResponse<SemanticSnapshot>>;
+    getSemanticDiff: (since?: number) => Promise<APIResponse<SemanticDiff | null>>;
+    getPageSummary: () => Promise<APIResponse<string>>;
+    aiSemanticSearch: (criteria: SemanticSearchCriteria) => Promise<APIResponse<SemanticSearchResponse>>;
+}
+/**
+ * Route definition
+ */
+interface RouteDefinition {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    path: string;
+    handler: string;
+    params?: string[];
+    bodyRequired?: boolean;
+}
+/**
+ * All UI Bridge routes
+ */
+declare const UI_BRIDGE_ROUTES: RouteDefinition[];
+/**
+ * WebSocket message types
+ */
+type WebSocketMessageType = 'subscribe' | 'unsubscribe' | 'event' | 'snapshot' | 'action' | 'error';
+/**
+ * WebSocket message
+ */
+interface WebSocketMessage<T = unknown> {
+    type: WebSocketMessageType;
+    channel?: string;
+    data?: T;
+    error?: string;
+    timestamp: number;
+}
+
+export { type APIResponse as A, type CORSOptions as C, type RateLimitOptions as R, type UIBridgeServerConfig as U, type WebSocketMessage as W, type RenderLogQuery as a, type RouteDefinition as b, type UIBridgeServerHandlers as c, UI_BRIDGE_ROUTES as d, type WebSocketMessageType as e };