@qontinui/shared-types 0.2.1

package/src/generated/DiscoveredState.d.ts

@@ -0,0 +1,49 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * A discovered UI state (collection of co-occurring elements).
+ *
+ * States represent distinct UI screens or views identified by the set of
+ * images that consistently appear together.
+ */
+export interface DiscoveredState {
+  /**
+   * Confidence score for state detection (0.0–1.0). Defaults to `1.0`.
+   */
+  confidence: number;
+  /**
+   * Description of what this state represents.
+   */
+  description?: string | null;
+  /**
+   * IDs of DOM elements (for web extraction).
+   */
+  elementIds?: string[];
+  /**
+   * Unique identifier for the state.
+   */
+  id: string;
+  /**
+   * IDs of images in this state.
+   */
+  imageIds?: string[];
+  /**
+   * Additional free-form metadata.
+   */
+  metadata?: {
+    [k: string]: unknown;
+  } | null;
+  /**
+   * Human-readable name.
+   */
+  name: string;
+  /**
+   * IDs of renders where this state appears.
+   */
+  renderIds?: string[];
+}

package/src/generated/DiscoveredStateImage.d.ts

@@ -0,0 +1,56 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { DiscoveryBoundingBox } from './DiscoveryBoundingBox';
+
+/**
+ * Visual element within a discovered state.
+ *
+ * Represents an image crop from a screenshot with its bounding box and
+ * optional pixel-level identification.
+ */
+export interface DiscoveredStateImage {
+  bbox: DiscoveryBoundingBox;
+  /**
+   * Confidence score for this image (0.0–1.0). Defaults to `1.0`.
+   */
+  confidence: number;
+  /**
+   * Semantic type of the element (e.g. `button`, `input`).
+   */
+  elementType?: string | null;
+  /**
+   * Unique identifier for the image.
+   */
+  id: string;
+  /**
+   * Human-readable label for the image.
+   */
+  label?: string | null;
+  /**
+   * Additional free-form metadata.
+   */
+  metadata?: {
+    [k: string]: unknown;
+  } | null;
+  /**
+   * Hash of pixel data for deduplication.
+   */
+  pixelHash?: string | null;
+  /**
+   * ID of the source screenshot.
+   */
+  screenshotId?: string | null;
+  /**
+   * URL to the source screenshot.
+   */
+  screenshotUrl?: string | null;
+  /**
+   * ID of the state this image belongs to.
+   */
+  stateId?: string | null;
+}

package/src/generated/DiscoveredTransition.d.ts

@@ -0,0 +1,44 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { DiscoveryTransitionTrigger } from './DiscoveryTransitionTrigger';
+import type { TransitionTriggerType } from './TransitionTriggerType';
+
+/**
+ * A transition between discovered states.
+ *
+ * Transitions represent actions that change the active set of states on the
+ * screen.
+ */
+export interface DiscoveredTransition {
+  /**
+   * Confidence score for transition detection (0.0–1.0). Defaults to `1.0`.
+   */
+  confidence: number;
+  /**
+   * ID of the source state.
+   */
+  fromStateId: string;
+  /**
+   * Unique identifier for the transition.
+   */
+  id: string;
+  /**
+   * Additional free-form metadata.
+   */
+  metadata?: {
+    [k: string]: unknown;
+  } | null;
+  /**
+   * ID of the target state.
+   */
+  toStateId: string;
+  /**
+   * What triggers this transition.
+   */
+  trigger?: DiscoveryTransitionTrigger | null;
+}

package/src/generated/DiscoveryBoundingBox.d.ts

@@ -0,0 +1,32 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Bounding box for a discovered image element.
+ *
+ * Pixel-space rectangle on a source screenshot. `width` / `height` are `> 0`
+ * on the Python side (validator not duplicated here — this is a wire-format
+ * layer).
+ */
+export interface DiscoveryBoundingBox {
+  /**
+   * Height of the bounding box (pixels, positive).
+   */
+  height: number;
+  /**
+   * Width of the bounding box (pixels, positive).
+   */
+  width: number;
+  /**
+   * X coordinate of the top-left corner (pixels).
+   */
+  x: number;
+  /**
+   * Y coordinate of the top-left corner (pixels).
+   */
+  y: number;
+}

package/src/generated/DiscoveryRequest.d.ts

@@ -0,0 +1,40 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Options for a UI Bridge element-discovery scan.
+ *
+ * Discovery crawls the live DOM and returns elements that match the
+ * provided filters, regardless of whether they are registered in the
+ * bridge registry.
+ */
+export interface DiscoveryRequest {
+  /**
+   * If `true`, include hidden/off-screen elements.
+   */
+  includeHidden?: boolean | null;
+  /**
+   * If `true`, only return interactive elements (buttons, inputs, etc.).
+   */
+  interactiveOnly?: boolean | null;
+  /**
+   * Maximum number of elements to return.
+   */
+  limit?: number | null;
+  /**
+   * CSS selector for the root element to start scanning from.
+   */
+  root?: string | null;
+  /**
+   * CSS selector filter (only elements matching this selector).
+   */
+  selector?: string | null;
+  /**
+   * Filter by element types (e.g. `["button", "input"]`).
+   */
+  types?: string[] | null;
+}

package/src/generated/DiscoveryResponse.d.ts

@@ -0,0 +1,32 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { DiscoveredElement } from './DiscoveredElement';
+import type { ElementRect } from './ElementRect';
+import type { ElementState } from './ElementState';
+
+/**
+ * Response from a UI Bridge discovery scan.
+ */
+export interface DiscoveryResponse {
+  /**
+   * Time taken for the discovery scan in milliseconds.
+   */
+  durationMs: number;
+  /**
+   * Discovered elements matching the request filters.
+   */
+  elements?: DiscoveredElement[];
+  /**
+   * Unix-epoch millisecond timestamp of the scan.
+   */
+  timestamp: number;
+  /**
+   * Total number of elements found (before any limit).
+   */
+  total: number;
+}

package/src/generated/DiscoverySourceType.d.ts

@@ -0,0 +1,14 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Source of a state-discovery result.
+ *
+ * Identifies which discovery pathway produced the state machine. Mirrors
+ * Python `DiscoverySourceType(str, Enum)`.
+ */
+export type DiscoverySourceType = "playwright" | "ui_bridge" | "recording" | "vision" | "manual";

package/src/generated/DiscoveryStrategy.d.ts

@@ -0,0 +1,13 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Strategy used by the state-discovery pass.
+ *
+ * Serialized as a bare lowercase string.
+ */
+export type DiscoveryStrategy = "auto" | "fingerprint";

package/src/generated/DiscoveryTransitionTrigger.d.ts

@@ -0,0 +1,38 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { TransitionTriggerType } from './TransitionTriggerType';
+
+/**
+ * Trigger for a discovered state transition.
+ *
+ * Describes the action (click, type, …) that caused a transition. All
+ * identifying fields are optional — different discovery sources populate
+ * different subsets.
+ */
+export interface DiscoveryTransitionTrigger {
+  /**
+   * ID of the DOM element (for web extraction).
+   */
+  elementId?: string | null;
+  /**
+   * ID of the image that was clicked/interacted with.
+   */
+  imageId?: string | null;
+  /**
+   * CSS selector for the trigger element.
+   */
+  selector?: string | null;
+  /**
+   * Type of trigger action. Defaults to `click` when omitted on the wire.
+   */
+  type?: TransitionTriggerType & string;
+  /**
+   * Value for type actions (text input).
+   */
+  value?: string | null;
+}

package/src/generated/DisplayNode.d.ts

@@ -0,0 +1,45 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { MatchLocation } from './MatchLocation';
+import type { NodeMetadata } from './NodeMetadata';
+import type { NodeStatus } from './NodeStatus';
+import type { NodeType } from './NodeType';
+import type { Outcome } from './Outcome';
+import type { RuntimeData } from './RuntimeData';
+import type { StateContext } from './StateContext';
+import type { TimingInfo } from './TimingInfo';
+import type { TopMatch } from './TopMatch';
+
+/**
+ * Display node structure used by the frontend — extended version of
+ * `TreeNode` with tree-rendering properties. NOT persisted; constructed
+ * from `TreeNode` data for UI display.
+ */
+export interface DisplayNode {
+  /**
+   * Child nodes in the tree.
+   */
+  children: DisplayNode[];
+  duration?: number | null;
+  endTimestamp?: number | null;
+  error?: string | null;
+  id: string;
+  /**
+   * Whether this node should be expanded in the UI (default: true).
+   */
+  isExpanded: boolean;
+  /**
+   * Nesting level in the tree (0 for root, 1 for first-level children).
+   */
+  level: number;
+  metadata?: NodeMetadata & {};
+  name: string;
+  nodeType: NodeType;
+  status: NodeStatus;
+  timestamp: number;
+}

package/src/generated/DomainAssignment.d.ts

@@ -0,0 +1,50 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Full configuration for a domain that workers can be assigned to.
+ *
+ * Domains represent logical areas of responsibility within a project
+ * (e.g., "frontend", "backend", "database", "api"). Workers are assigned to
+ * zero or more domains, and criteria can be scoped to a single domain for
+ * multi-worker verification.
+ */
+export interface DomainAssignment {
+  /**
+   * Workers currently assigned to this domain.
+   */
+  assignedWorkers?: string[];
+  /**
+   * Description of what this domain covers.
+   */
+  description: string;
+  /**
+   * Success-criterion IDs that are specific to this domain.
+   */
+  domainCriteria?: string[];
+  /**
+   * Unique identifier for this domain.
+   */
+  domainId: string;
+  /**
+   * File patterns that belong to this domain
+   * (e.g., `"src/frontend/** /*.ts"`).
+   */
+  filePatterns?: string[];
+  /**
+   * Keywords that help identify this domain.
+   */
+  keywords?: string[];
+  /**
+   * Human-readable name for the domain.
+   */
+  name: string;
+  /**
+   * Additional system-prompt context for workers in this domain.
+   */
+  systemPromptContext?: string | null;
+}

package/src/generated/DomainKnowledge.d.ts

@@ -0,0 +1,29 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * A piece of domain knowledge attached to a state — free-form notes that
+ * help the AI reason about what a state represents.
+ */
+export interface DomainKnowledge {
+  /**
+   * Full knowledge content (markdown or plain text).
+   */
+  content: string;
+  /**
+   * Unique identifier for this knowledge entry.
+   */
+  id: string;
+  /**
+   * Tags for filtering and grouping.
+   */
+  tags: string[];
+  /**
+   * Short title / headline.
+   */
+  title: string;
+}

package/src/generated/DomainVerificationResult.d.ts

@@ -0,0 +1,36 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { Confidence } from './Confidence';
+import type { CriterionType } from './CriterionType';
+import type { VerificationResult } from './VerificationResult';
+
+/**
+ * Result of domain-scoped verification.
+ */
+export interface DomainVerificationResult {
+  /**
+   * Whether all domain criteria passed.
+   */
+  allPassed: boolean;
+  /**
+   * Domain that was verified.
+   */
+  domainId: string;
+  /**
+   * Summary of any failures.
+   */
+  failureSummary?: string | null;
+  /**
+   * Verification results for domain-specific criteria.
+   */
+  results: VerificationResult[];
+  /**
+   * Workers that contributed to this domain.
+   */
+  workerIds: string[];
+}

package/src/generated/ElementActionRequest.d.ts

@@ -0,0 +1,28 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { WaitOptions } from './WaitOptions';
+
+/**
+ * Request to execute an action on a UI Bridge element.
+ */
+export interface ElementActionRequest {
+  /**
+   * Action name (e.g. `"click"`, `"type"`, `"select"`).
+   */
+  action: string;
+  /**
+   * Optional action-specific parameters.
+   */
+  params?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Optional wait conditions to satisfy before executing.
+   */
+  waitOptions?: WaitOptions | null;
+}

package/src/generated/ElementBbox.d.ts

@@ -0,0 +1,36 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Viewport-relative bounding box in CSS pixels.
+ *
+ * This is the live on-screen geometry captured at snapshot time via
+ * `Element.getBoundingClientRect()`. Present only when the SDK has a
+ * live DOM ref for the element; absent when the element is registered
+ * without a ref or when the snapshot is served from the DOM-fallback
+ * scanner.
+ *
+ * Click target for a hit is `(x + width/2, y + height/2)`.
+ */
+export interface ElementBbox {
+  /**
+   * Height of the bbox in CSS pixels.
+   */
+  height: number;
+  /**
+   * Width of the bbox in CSS pixels.
+   */
+  width: number;
+  /**
+   * X coordinate of the bbox origin in viewport CSS pixels.
+   */
+  x: number;
+  /**
+   * Y coordinate of the bbox origin in viewport CSS pixels.
+   */
+  y: number;
+}

package/src/generated/ElementIdentifier.d.ts

@@ -0,0 +1,40 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Identifier bundle for locating a UI Bridge element.
+ *
+ * Elements can be addressed by any combination of UI-Bridge ID, test ID,
+ * AWAS ID, HTML ID, XPath, or CSS selector. The `xpath` and `selector`
+ * fields are always present; the named IDs are optional.
+ */
+export interface ElementIdentifier {
+  /**
+   * AWAS-assigned action identifier.
+   */
+  awasId?: string | null;
+  /**
+   * Native HTML `id` attribute.
+   */
+  htmlId?: string | null;
+  /**
+   * CSS selector that uniquely identifies the element.
+   */
+  selector: string;
+  /**
+   * `data-testid` attribute value.
+   */
+  testId?: string | null;
+  /**
+   * Application-assigned UI Bridge ID.
+   */
+  uiId?: string | null;
+  /**
+   * Full XPath to the element.
+   */
+  xpath: string;
+}

package/src/generated/ElementRect.d.ts

@@ -0,0 +1,48 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+/**
+ * Bounding rectangle of a DOM element, mirroring the output of
+ * `Element.getBoundingClientRect()`.
+ *
+ * Contains both the origin+size pair (`x`, `y`, `width`, `height`) and the
+ * edge offsets (`top`, `right`, `bottom`, `left`) for consumer convenience.
+ */
+export interface ElementRect {
+  /**
+   * Distance from the top of the viewport plus `height`.
+   */
+  bottom: number;
+  /**
+   * Height of the element in CSS pixels.
+   */
+  height: number;
+  /**
+   * Distance from the left of the viewport.
+   */
+  left: number;
+  /**
+   * Distance from the left of the viewport plus `width`.
+   */
+  right: number;
+  /**
+   * Distance from the top of the viewport.
+   */
+  top: number;
+  /**
+   * Width of the element in CSS pixels.
+   */
+  width: number;
+  /**
+   * X coordinate of the element's origin (same as `left`).
+   */
+  x: number;
+  /**
+   * Y coordinate of the element's origin (same as `top`).
+   */
+  y: number;
+}

package/src/generated/ElementState.d.ts

@@ -0,0 +1,47 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated.
+ * DO NOT MODIFY IT BY HAND. Regenerate with `just generate-types` or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`.
+ */
+
+import type { ElementRect } from './ElementRect';
+
+/**
+ * Observable state of a UI Bridge element as returned from the React
+ * registry.
+ *
+ * Every element returned by the bridge includes a snapshot of its current
+ * visibility, interactivity, and form-control value.
+ */
+export interface ElementState {
+  /**
+   * Current checked state for checkbox/radio elements.
+   */
+  checked?: boolean | null;
+  /**
+   * Whether the element is enabled (not disabled).
+   */
+  enabled: boolean;
+  /**
+   * Whether the element currently has keyboard focus.
+   */
+  focused: boolean;
+  rect: ElementRect;
+  /**
+   * Currently selected options for `<select>` elements.
+   */
+  selectedOptions?: string[] | null;
+  /**
+   * Text content of the element (innerText).
+   */
+  textContent?: string | null;
+  /**
+   * Current value for input/textarea elements.
+   */
+  value?: string | null;
+  /**
+   * Whether the element is currently visible in the viewport.
+   */
+  visible: boolean;
+}