@qontinui/shared-types 0.2.1

package/src/generated/AccessibilityBounds.d.ts

@@ -0,0 +1,17 @@
+/* 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 for an accessibility node. Coordinates are screen
+ * pixels, typically absolute screen coordinates.
+ */
+export interface AccessibilityBounds {
+  height: number;
+  width: number;
+  x: number;
+  y: number;
+}

package/src/generated/AccessibilityNode.d.ts

@@ -0,0 +1,73 @@
+/* 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 { AccessibilityBounds } from './AccessibilityBounds';
+import type { AccessibilityRole } from './AccessibilityRole';
+import type { AccessibilityState } from './AccessibilityState';
+
+/**
+ * A node in the accessibility tree.
+ *
+ * Each node represents an element in the accessibility hierarchy with its
+ * role, name, value, state, and bounds. The `ref` field provides a stable
+ * identifier for AI-driven automation (e.g., `@e1`, `@e2`).
+ */
+export interface AccessibilityNode {
+  /**
+   * Automation ID / test-ID attribute.
+   */
+  automationId?: string | null;
+  /**
+   * Bounding rectangle in screen coordinates.
+   */
+  bounds?: AccessibilityBounds | null;
+  /**
+   * Child nodes in the tree.
+   */
+  children: AccessibilityNode[];
+  /**
+   * CSS class name or control class.
+   */
+  className?: string | null;
+  /**
+   * Accessible description (additional context).
+   */
+  description?: string | null;
+  /**
+   * HTML tag name (for web elements).
+   */
+  htmlTag?: string | null;
+  /**
+   * Whether the element accepts user interaction.
+   */
+  isInteractive: boolean;
+  /**
+   * Hierarchical level (for headings, tree items).
+   */
+  level?: number | null;
+  /**
+   * Accessible name (label).
+   */
+  name?: string | null;
+  /**
+   * Reference ID like `@e1`, `@e2` for AI interaction.
+   */
+  ref: string;
+  role: AccessibilityRole;
+  /**
+   * Current state flags.
+   */
+  state?: AccessibilityState & {};
+  /**
+   * URL for link elements.
+   */
+  url?: string | null;
+  /**
+   * Current value (for inputs).
+   */
+  value?: string | null;
+}

package/src/generated/AccessibilityRole.d.ts

@@ -0,0 +1,93 @@
+/* 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`.
+ */
+
+/**
+ * ARIA/UIA accessibility roles. Based on WAI-ARIA 1.2 with extensions for
+ * Windows UI Automation and other platform-specific accessibility APIs.
+ */
+export type AccessibilityRole =
+  | "application"
+  | "document"
+  | "article"
+  | "banner"
+  | "complementary"
+  | "contentinfo"
+  | "form"
+  | "main"
+  | "navigation"
+  | "region"
+  | "search"
+  | "button"
+  | "checkbox"
+  | "combobox"
+  | "dialog"
+  | "gridcell"
+  | "link"
+  | "listbox"
+  | "menu"
+  | "menubar"
+  | "menuitem"
+  | "menuitemcheckbox"
+  | "menuitemradio"
+  | "option"
+  | "progressbar"
+  | "radio"
+  | "radiogroup"
+  | "scrollbar"
+  | "searchbox"
+  | "slider"
+  | "spinbutton"
+  | "switch"
+  | "tab"
+  | "tablist"
+  | "tabpanel"
+  | "textbox"
+  | "toolbar"
+  | "tooltip"
+  | "tree"
+  | "treegrid"
+  | "treeitem"
+  | "alert"
+  | "alertdialog"
+  | "grid"
+  | "heading"
+  | "img"
+  | "list"
+  | "listitem"
+  | "log"
+  | "marquee"
+  | "math"
+  | "note"
+  | "separator"
+  | "status"
+  | "table"
+  | "cell"
+  | "columnheader"
+  | "row"
+  | "rowgroup"
+  | "rowheader"
+  | "timer"
+  | "definition"
+  | "directory"
+  | "figure"
+  | "group"
+  | "paragraph"
+  | "term"
+  | "generic"
+  | "static_text"
+  | "none"
+  | "unknown"
+  | "window"
+  | "pane"
+  | "titlebar"
+  | "edit"
+  | "custom"
+  | "dataitem"
+  | "datepicker"
+  | "calendar"
+  | "hyperlink"
+  | "splitbutton";

package/src/generated/AccessibilityRoleCriterion.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`.
+ */
+
+/**
+ * Role selector criterion — either a single role name or a list of roles.
+ * Matches the Python `str | list[str] | None` type on
+ * `AccessibilityTarget.role`.
+ */
+export type AccessibilityRoleCriterion = string | string[];

package/src/generated/AccessibilitySelector.d.ts

@@ -0,0 +1,76 @@
+/* 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 { AccessibilityRole } from './AccessibilityRole';
+import type { AccessibilityState } from './AccessibilityState';
+import type { RoleCriterion } from './RoleCriterion';
+
+/**
+ * Selector for finding nodes in an accessibility tree.
+ *
+ * Provides flexible matching criteria for locating elements by role, name,
+ * automation ID, or other attributes. Multiple criteria are combined with
+ * AND logic.
+ */
+export interface AccessibilitySelector {
+  /**
+   * Required ancestor selector.
+   */
+  ancestor?: AccessibilitySelector | null;
+  /**
+   * Match by automation / test ID.
+   */
+  automationId?: string | null;
+  /**
+   * Whether string matching is case-sensitive.
+   */
+  caseSensitive: boolean;
+  /**
+   * Match by CSS / control class name.
+   */
+  className?: string | null;
+  /**
+   * Match by HTML tag name.
+   */
+  htmlTag?: string | null;
+  /**
+   * Filter by interactivity.
+   */
+  isInteractive?: boolean | null;
+  /**
+   * Maximum tree depth to search.
+   */
+  maxDepth?: number | null;
+  /**
+   * Exact name match.
+   */
+  name?: string | null;
+  /**
+   * Partial name match (contains).
+   */
+  nameContains?: string | null;
+  /**
+   * Regex pattern for name matching.
+   */
+  namePattern?: string | null;
+  /**
+   * Match by role (single or list).
+   */
+  role?: RoleCriterion | null;
+  /**
+   * Required state flags (partial match).
+   */
+  state?: AccessibilityState | null;
+  /**
+   * Exact value match.
+   */
+  value?: string | null;
+  /**
+   * Partial value match (contains).
+   */
+  valueContains?: string | null;
+}

package/src/generated/AccessibilitySnapshot.d.ts

@@ -0,0 +1,43 @@
+/* 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 { AccessibilityBackend } from './AccessibilityBackend';
+import type { AccessibilityBounds } from './AccessibilityBounds';
+import type { AccessibilityNode } from './AccessibilityNode';
+import type { AccessibilityRole } from './AccessibilityRole';
+import type { AccessibilityState } from './AccessibilityState';
+
+/**
+ * Complete accessibility-tree snapshot.
+ *
+ * Full accessibility tree at a point in time, with metadata about the
+ * capture source and summary statistics.
+ */
+export interface AccessibilitySnapshot {
+  backend: AccessibilityBackend;
+  /**
+   * Number of interactive nodes.
+   */
+  interactiveNodes: number;
+  root: AccessibilityNode;
+  /**
+   * Unix timestamp of capture.
+   */
+  timestamp: number;
+  /**
+   * Page / window title.
+   */
+  title?: string | null;
+  /**
+   * Total number of nodes in the tree.
+   */
+  totalNodes: number;
+  /**
+   * Page URL (for web targets).
+   */
+  url?: string | null;
+}

package/src/generated/AccessibilityState.d.ts

@@ -0,0 +1,67 @@
+/* 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`.
+ */
+
+/**
+ * Accessibility state flags for a node.
+ *
+ * These flags represent the current interactive state of an element.
+ * Tri-state booleans use `Option<bool>` — `None` means "not applicable."
+ */
+export interface AccessibilityState {
+  /**
+   * Checkable element's checked state.
+   */
+  isChecked?: boolean | null;
+  /**
+   * Element is disabled / non-interactive.
+   */
+  isDisabled: boolean;
+  /**
+   * Element content can be edited.
+   */
+  isEditable: boolean;
+  /**
+   * Expandable element's expansion state.
+   */
+  isExpanded?: boolean | null;
+  /**
+   * Element can receive focus.
+   */
+  isFocusable: boolean;
+  /**
+   * Element has keyboard focus.
+   */
+  isFocused: boolean;
+  /**
+   * Element is hidden from the accessibility tree.
+   */
+  isHidden: boolean;
+  /**
+   * Element is a modal dialog.
+   */
+  isModal: boolean;
+  /**
+   * Element allows multiple selections.
+   */
+  isMultiselectable: boolean;
+  /**
+   * Pressable element's pressed state.
+   */
+  isPressed?: boolean | null;
+  /**
+   * Element is read-only.
+   */
+  isReadonly: boolean;
+  /**
+   * Element value is required.
+   */
+  isRequired: boolean;
+  /**
+   * Selectable element's selection state.
+   */
+  isSelected?: boolean | null;
+}

package/src/generated/ActionExecutionBatch.d.ts

@@ -0,0 +1,23 @@
+/* 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 { ActionExecutionCreate } from './ActionExecutionCreate';
+import type { ActionStatus } from './ActionStatus';
+import type { ErrorType } from './ErrorType';
+import type { ExecutionActionType } from './ExecutionActionType';
+import type { ExecutionMatchLocation } from './ExecutionMatchLocation';
+import type { LLMMetrics } from './LLMMetrics';
+
+/**
+ * Batch wrapper for reporting multiple action executions in one request.
+ */
+export interface ActionExecutionBatch {
+  /**
+   * Actions to record (Python enforces `1..=100`; enforced by the backend).
+   */
+  actions: ActionExecutionCreate[];
+}

package/src/generated/ActionExecutionBatchResponse.d.ts

@@ -0,0 +1,24 @@
+/* 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`.
+ */
+
+/**
+ * Response envelope returned after creating a batch of action executions.
+ */
+export interface ActionExecutionBatchResponse {
+  /**
+   * Assigned action IDs, in the same order as the submitted batch.
+   */
+  actionIds?: string[];
+  /**
+   * Number of actions recorded.
+   */
+  actionsRecorded: number;
+  /**
+   * Associated run ID.
+   */
+  runId: string;
+}

package/src/generated/ActionExecutionCreate.d.ts

@@ -0,0 +1,124 @@
+/* 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 { ActionStatus } from './ActionStatus';
+import type { ErrorType } from './ErrorType';
+import type { ExecutionActionType } from './ExecutionActionType';
+import type { ExecutionMatchLocation } from './ExecutionMatchLocation';
+import type { LLMMetrics } from './LLMMetrics';
+
+/**
+ * Request payload for reporting a single action execution.
+ *
+ * Usually submitted as part of a batch; see [`ActionExecutionResponse`].
+ */
+export interface ActionExecutionCreate {
+  /**
+   * Human-readable action name.
+   */
+  actionName: string;
+  actionType: ExecutionActionType;
+  /**
+   * IDs of states active when the action ran.
+   */
+  activeStates?: string[] | null;
+  /**
+   * ISO 8601 timestamp when the action completed.
+   */
+  completedAt: string;
+  /**
+   * Confidence score of the match in the range `[0.0, 1.0]`.
+   */
+  confidenceScore?: number | null;
+  /**
+   * Action duration in milliseconds.
+   */
+  durationMs: number;
+  /**
+   * Error message if the action failed.
+   */
+  errorMessage?: string | null;
+  /**
+   * Captured stack trace, if any.
+   */
+  errorStack?: string | null;
+  /**
+   * Category of error, if any.
+   */
+  errorType?: ErrorType | null;
+  /**
+   * Source state ID for state-machine actions.
+   */
+  fromState?: string | null;
+  /**
+   * Opaque input data captured for the action.
+   */
+  inputData?: {
+    [k: string]: unknown;
+  } | null;
+  /**
+   * LLM token and cost metrics, if the action used an LLM.
+   */
+  llmMetrics?: LLMMetrics | null;
+  /**
+   * Pixel location of the match.
+   */
+  matchLocation?: ExecutionMatchLocation | null;
+  /**
+   * Opaque additional metadata.
+   */
+  metadata?: {
+    [k: string]: unknown;
+  } | null;
+  /**
+   * Opaque output data produced by the action.
+   */
+  outputData?: {
+    [k: string]: unknown;
+  } | null;
+  /**
+   * ID of a parent action, if this is a sub-action.
+   */
+  parentActionId?: string | null;
+  /**
+   * Parent action ID for child actions within a sequence.
+   */
+  parentId?: string | null;
+  /**
+   * ID of the pattern the action targeted.
+   */
+  patternId?: string | null;
+  /**
+   * Human-readable pattern name.
+   */
+  patternName?: string | null;
+  /**
+   * ID of a screenshot associated with the action.
+   */
+  screenshotId?: string | null;
+  /**
+   * Zero-based sequence number of the action within the run.
+   */
+  sequenceNumber: number;
+  /**
+   * Span type for tracing (e.g., `"llm"`, `"tool"`, `"agent"`).
+   */
+  spanType?: string | null;
+  /**
+   * ISO 8601 timestamp when the action started.
+   */
+  startedAt: string;
+  status: ActionStatus;
+  /**
+   * Destination state ID for state-machine actions.
+   */
+  toState?: string | null;
+  /**
+   * Trace ID correlating related actions.
+   */
+  traceId?: string | null;
+}

package/src/generated/ActionExecutionListResponse.d.ts

@@ -0,0 +1,20 @@
+/* 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 { ActionExecutionResponse } from './ActionExecutionResponse';
+import type { Pagination } from './Pagination';
+
+/**
+ * Paginated list of action executions.
+ */
+export interface ActionExecutionListResponse {
+  /**
+   * Page of matching actions.
+   */
+  actions: ActionExecutionResponse[];
+  pagination: Pagination;
+}

package/src/generated/ActionExecutionResponse.d.ts

@@ -0,0 +1,24 @@
+/* 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`.
+ */
+
+/**
+ * Response envelope returned after reporting action executions.
+ */
+export interface ActionExecutionResponse {
+  /**
+   * Assigned action IDs, in the same order as the submitted batch.
+   */
+  actionIds?: string[] | null;
+  /**
+   * Number of actions recorded.
+   */
+  recorded: number;
+  /**
+   * Associated run ID.
+   */
+  runId: string;
+}

package/src/generated/ActionReliabilityStats.d.ts

@@ -0,0 +1,54 @@
+/* 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 { ExecutionActionType } from './ExecutionActionType';
+
+/**
+ * Reliability statistics aggregated for a single action type.
+ */
+export interface ActionReliabilityStats {
+  /**
+   * Human-readable action name.
+   */
+  actionName: string;
+  actionType: ExecutionActionType;
+  /**
+   * Mean duration in milliseconds.
+   */
+  avgDurationMs: number;
+  /**
+   * Common error categories, as opaque records. Python types this as
+   * `list[dict[str, Any]]`; typing it further requires product input.
+   */
+  commonErrors?: {
+    [k: string]: unknown;
+  }[];
+  /**
+   * Number of executions that failed.
+   */
+  failedExecutions: number;
+  /**
+   * Median duration in milliseconds.
+   */
+  p50DurationMs: number;
+  /**
+   * 95th-percentile duration in milliseconds.
+   */
+  p95DurationMs: number;
+  /**
+   * Success rate as a percentage.
+   */
+  successRate: number;
+  /**
+   * Number of executions that succeeded.
+   */
+  successfulExecutions: number;
+  /**
+   * Total number of executions observed.
+   */
+  totalExecutions: number;
+}