@qontinui/shared-types 0.2.1

package/src/generated/FullRunnerStep.d.ts

@@ -0,0 +1,144 @@
+/* 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 { A11yAction } from './A11yAction';
+import type { CheckType } from './CheckType';
+import type { CodeExecutionStep } from './CodeExecutionStep';
+import type { CommandMode } from './CommandMode';
+import type { CommandStep } from './CommandStep';
+import type { CommandStepPhase } from './CommandStepPhase';
+import type { DagApprovalStep } from './DagApprovalStep';
+import type { DagCancelStep } from './DagCancelStep';
+import type { DagLoopStep } from './DagLoopStep';
+import type { ExecutePlaybookStep } from './ExecutePlaybookStep';
+import type { NativeAccessibilityStep } from './NativeAccessibilityStep';
+import type { PlaywrightExecutionMode } from './PlaywrightExecutionMode';
+import type { PromptStep } from './PromptStep';
+import type { PromptStepPhase } from './PromptStepPhase';
+import type { RestartProcessStep } from './RestartProcessStep';
+import type { RetrySpec } from './RetrySpec';
+import type { SaveWorkflowArtifactStep } from './SaveWorkflowArtifactStep';
+import type { TestType } from './TestType';
+import type { UiBridgeAction } from './UiBridgeAction';
+import type { UiBridgeAssertType } from './UiBridgeAssertType';
+import type { UiBridgeComparisonMode } from './UiBridgeComparisonMode';
+import type { UiBridgeDesignAuditStep } from './UiBridgeDesignAuditStep';
+import type { UiBridgeSeverity } from './UiBridgeSeverity';
+import type { UiBridgeStep } from './UiBridgeStep';
+import type { UiBridgeStepPhase } from './UiBridgeStepPhase';
+import type { UiBridgeVisualAssertionStep } from './UiBridgeVisualAssertionStep';
+import type { VerificationCategoryKind } from './VerificationCategoryKind';
+import type { VgaAction } from './VgaAction';
+import type { VgaAutomateStep } from './VgaAutomateStep';
+import type { VisualAssertionType } from './VisualAssertionType';
+import type { WorkflowFixupMode } from './WorkflowFixupMode';
+import type { WorkflowFixupStep } from './WorkflowFixupStep';
+import type { WorkflowRefStep } from './WorkflowRefStep';
+import type { WorkflowStep } from './WorkflowStep';
+import type { WorkflowStepPhase } from './WorkflowStepPhase';
+
+/**
+ * Fully typed discriminated union over **all** step variants registered in
+ * the runner's `HandlerRegistry`.
+ *
+ * ## Wire format
+ *
+ * Internally tagged with `"type"`, matching existing JSON on the wire:
+ * ```json
+ * {"type": "command", "mode": "shell", "command": "cargo build", ...}
+ * {"type": "prompt", "phase": "agentic", "content": "..."}
+ * {"type": "ui_bridge", "action": "navigate", "url": "..."}
+ * {"type": "code_execution", "code": "print('hello')"}
+ * ```
+ *
+ * ## Step arrays remain `Vec<serde_json::Value>`
+ *
+ * `UnifiedWorkflow.setup_steps` / `.verification_steps` / `.agentic_steps` /
+ * `.completion_steps` stay as `Vec<serde_json::Value>` until the Session 2
+ * migration lands. `FullRunnerStep` is available for typed access but is not
+ * yet threaded into the workflow frame fields.
+ *
+ * ## Variant coverage
+ *
+ * | Variant | Wire tag | Handler |
+ * |---------|----------|---------|
+ * | `Command` | `"command"` | `CommandHandler` (sub-modes: shell/check/check_group/test) |
+ * | `Prompt` | `"prompt"` | `PromptStepHandler` |
+ * | `UiBridge` | `"ui_bridge"` | `UiBridgeHandler` (actions: navigate/execute/assert/snapshot/compare/snapshot_assert/action_plan) |
+ * | `Workflow` | `"workflow"` | `WorkflowStepHandler` |
+ * | `CodeExecution` | `"code_execution"` | `CodeExecutionHandler` |
+ * | `ExecutePlaybook` | `"execute_playbook"` | `ExecutePlaybookHandler` |
+ * | `NativeAccessibility` | `"native_accessibility"` | `NativeAccessibilityHandler` |
+ * | `RestartProcess` | `"restart_process"` | `RestartProcessHandler` |
+ * | `SaveWorkflowArtifact` | `"save_workflow_artifact"` | `SaveWorkflowArtifactHandler` |
+ * | `WorkflowFixup` | `"workflow_fixup"` | `WorkflowFixupHandler` |
+ * | `UiBridgeDesignAudit` | `"ui_bridge_design_audit"` | `UiBridgeDesignAuditHandler` |
+ * | `UiBridgeVisualAssertion` | `"ui_bridge_visual_assertion"` | `UiBridgeVisualAssertionHandler` |
+ * | `VgaAutomate` | `"vga_automate"` | `VgaAutomateHandler` |
+ * | `WorkflowRef` | `"workflow_ref"` | `WorkflowRefHandler` |
+ * | `DagCancel` | `"dag_cancel"` | `dag_nodes::DagCancelHandler` |
+ * | `DagApproval` | `"dag_approval"` | `dag_nodes::DagApprovalHandler` |
+ * | `DagLoop` | `"dag_loop"` | `dag_nodes::DagLoopHandler` |
+ *
+ * Variant sizes range ~200–672 bytes depending on each step struct's field
+ * cardinality. `#[allow(large_enum_variant)]` because the sizes reflect real
+ * step shapes; boxing would add heap indirection on every deserialize and
+ * dispatch without meaningful savings — no hot path holds dense
+ * `Vec<FullRunnerStep>` in memory.
+ */
+export type FullRunnerStep =
+  | (CommandStep & {
+      type: "command";
+    })
+  | (PromptStep & {
+      type: "prompt";
+    })
+  | (UiBridgeStep & {
+      type: "ui_bridge";
+    })
+  | (WorkflowStep & {
+      type: "workflow";
+    })
+  | (CodeExecutionStep & {
+      type: "code_execution";
+    })
+  | (ExecutePlaybookStep & {
+      type: "execute_playbook";
+    })
+  | (NativeAccessibilityStep & {
+      type: "native_accessibility";
+    })
+  | (RestartProcessStep & {
+      type: "restart_process";
+    })
+  | (SaveWorkflowArtifactStep & {
+      type: "save_workflow_artifact";
+    })
+  | (WorkflowFixupStep & {
+      type: "workflow_fixup";
+    })
+  | (UiBridgeDesignAuditStep & {
+      type: "ui_bridge_design_audit";
+    })
+  | (UiBridgeVisualAssertionStep & {
+      type: "ui_bridge_visual_assertion";
+    })
+  | (VgaAutomateStep & {
+      type: "vga_automate";
+    })
+  | (WorkflowRefStep & {
+      type: "workflow_ref";
+    })
+  | (DagCancelStep & {
+      type: "dag_cancel";
+    })
+  | (DagApprovalStep & {
+      type: "dag_approval";
+    })
+  | (DagLoopStep & {
+      type: "dag_loop";
+    });

package/src/generated/GUIElementChunk.d.ts

@@ -0,0 +1,151 @@
+/* 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 { BoundingBox } from './BoundingBox';
+import type { ElementType } from './ElementType';
+
+/**
+ * Complete representation of a GUI element chunk for RAG retrieval.
+ *
+ * Contains all information needed for storing, searching, and retrieving GUI
+ * elements from a vector database. Mirrors `rag.models.GUIElementChunk`.
+ */
+export interface GUIElementChunk {
+  area: number;
+  aspect_ratio: number;
+  average_brightness: number;
+  bounding_box?: BoundingBox | null;
+  color_histogram: number[];
+  contrast_ratio: number;
+  /**
+   * ISO 8601 UTC timestamp (`Z` suffix).
+   */
+  created_at?: string | null;
+  depth_in_hierarchy: number;
+  /**
+   * Dominant RGB colour tuples.
+   */
+  dominant_colors: number[][];
+  edge_density: number;
+  /**
+   * More specific classification.
+   */
+  element_subtype: string;
+  element_type?: ElementType & string;
+  /**
+   * How the element was extracted (e.g. `"manual"`).
+   */
+  extraction_method: string;
+  has_text: boolean;
+  height: number;
+  /**
+   * Unique identifier (UUID).
+   */
+  id: string;
+  /**
+   * Dense vector for visual features.
+   */
+  image_embedding?: number[] | null;
+  /**
+   * `"click"`, `"type"`, `"select"`, etc.
+   */
+  interaction_type: string;
+  /**
+   * Is this element required for state identification?
+   */
+  is_defining_element: boolean;
+  is_enabled: boolean;
+  /**
+   * Does the element stay in the same position?
+   */
+  is_fixed_position: boolean;
+  is_focused: boolean;
+  is_interactive: boolean;
+  /**
+   * Is this element optional in the state?
+   */
+  is_optional_element: boolean;
+  is_selected: boolean;
+  /**
+   * Is element shared across multiple states?
+   */
+  is_shared: boolean;
+  ocr_confidence: number;
+  ocr_text: string;
+  /**
+   * Parent container / region identifier.
+   */
+  parent_region?: string | null;
+  /**
+   * `"windows"`, `"macos"`, `"linux"`, `"web"`.
+   */
+  platform: string;
+  /**
+   * `"top-left"`, `"top-right"`, `"bottom-left"`, `"bottom-right"`, or `"center"`.
+   */
+  position_quadrant: string;
+  /**
+   * Probability of finding this element (0-1).
+   */
+  probability: number;
+  /**
+   * Search-region identifier.
+   */
+  search_region_id?: string | null;
+  /**
+   * Expected action when interacted with.
+   */
+  semantic_action: string;
+  /**
+   * `"save"`, `"cancel"`, `"submit"`, `"close"`, etc.
+   */
+  semantic_role: string;
+  sibling_count: number;
+  /**
+   * Threshold for matching (0-1).
+   */
+  similarity_threshold: number;
+  /**
+   * Application name / identifier.
+   */
+  source_app: string;
+  /**
+   * Screenshot identifier.
+   */
+  source_screenshot_id?: string | null;
+  /**
+   * State-machine state ID.
+   */
+  source_state_id?: string | null;
+  /**
+   * Associated state ID.
+   */
+  state_id?: string | null;
+  state_name: string;
+  /**
+   * UI toolkit / style (e.g. `"material"`, `"fluent"`, `"gtk"`).
+   */
+  style_family: string;
+  /**
+   * Human-readable description for embedding.
+   */
+  text_description: string;
+  /**
+   * Dense vector for text.
+   */
+  text_embedding?: number[] | null;
+  text_length: number;
+  /**
+   * ISO 8601 UTC timestamp (`Z` suffix).
+   */
+  updated_at?: string | null;
+  /**
+   * `"normal"`, `"hover"`, `"pressed"`, `"disabled"`.
+   */
+  visual_state: string;
+  width: number;
+}

package/src/generated/GateEvaluationResult.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`.
+ */
+
+/**
+ * Result of evaluating a named gate across a set of steps.
+ */
+export interface GateEvaluationResult {
+  /**
+   * IDs of required steps that failed.
+   */
+  failedStepIds: string[];
+  /**
+   * Name of the gate.
+   */
+  gateName: string;
+  /**
+   * IDs of required steps that were missing.
+   */
+  missingStepIds: string[];
+  /**
+   * Whether the gate passed overall.
+   */
+  passed: boolean;
+  /**
+   * IDs of required steps that passed.
+   */
+  passedStepIds: string[];
+  /**
+   * IDs of steps the gate required.
+   */
+  requiredStepIds: string[];
+}

package/src/generated/HealthCheckUrl.d.ts

@@ -0,0 +1,35 @@
+/* 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`.
+ */
+
+/**
+ * Configuration for a single health check URL.
+ *
+ * A workflow can have zero or more of these; they run before verification to
+ * confirm required services are up.
+ */
+export interface HealthCheckUrl {
+  /**
+   * Expected HTTP status code (default: `200`).
+   */
+  expectedStatus: number;
+  /**
+   * Whether failure should stop the workflow (default: `true`).
+   */
+  isCritical: boolean;
+  /**
+   * Display name for the health check (e.g., `"Backend Server"`).
+   */
+  name: string;
+  /**
+   * Timeout in seconds (default: `30`).
+   */
+  timeoutSeconds: number;
+  /**
+   * URL to check (e.g., `"http://localhost:8000/health"`).
+   */
+  url: string;
+}

package/src/generated/HistoricalActionQuery.d.ts

@@ -0,0 +1,42 @@
+/* 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';
+
+/**
+ * Query filters for looking up historical action results.
+ */
+export interface HistoricalActionQuery {
+  /**
+   * Filter by action name.
+   */
+  actionName?: string | null;
+  /**
+   * Filter by action type.
+   */
+  actionType?: ExecutionActionType | null;
+  /**
+   * Maximum number of results to return (Python constrains to `1..=100`).
+   */
+  limit: number;
+  /**
+   * Filter by project ID.
+   */
+  projectId?: string | null;
+  /**
+   * Filter by state name.
+   */
+  stateName?: string | null;
+  /**
+   * If true, only successful actions are returned.
+   */
+  successOnly: boolean;
+  /**
+   * Filter by workflow ID.
+   */
+  workflowId?: string | null;
+}

package/src/generated/HistoricalActionResult.d.ts

@@ -0,0 +1,57 @@
+/* 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 { ExecutionActionType } from './ExecutionActionType';
+
+/**
+ * A historical action execution, shaped for playback.
+ */
+export interface HistoricalActionResult {
+  /**
+   * Human-readable action name.
+   */
+  actionName: string;
+  actionType: ExecutionActionType;
+  /**
+   * Duration in milliseconds.
+   */
+  durationMs: number;
+  /**
+   * Source state.
+   */
+  fromState?: string | null;
+  /**
+   * Whether a screenshot exists.
+   */
+  hasScreenshot: boolean;
+  /**
+   * Action execution ID.
+   */
+  id: string;
+  /**
+   * Input parameters captured for the action.
+   */
+  inputData?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Output produced by the action.
+   */
+  outputData?: {
+    [k: string]: unknown;
+  };
+  /**
+   * URL to an associated screenshot, if any.
+   */
+  screenshotUrl?: string | null;
+  status: ActionStatus;
+  /**
+   * Target state.
+   */
+  toState?: string | null;
+}

package/src/generated/HttpConfig.d.ts

@@ -0,0 +1,27 @@
+/* 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`.
+ */
+
+/**
+ * HTTP-transport configuration.
+ *
+ * **Secret surface**: `headers` typically carries an `Authorization` token.
+ * See module-level docs.
+ */
+export interface HttpConfig {
+  /**
+   * HTTP headers to include on every request. **Secret surface** —
+   * typically includes `Authorization: Bearer …`.
+   */
+  headers?: {
+    [k: string]: string;
+  };
+  /**
+   * Server URL (e.g. `"http://localhost:8080/mcp"`). The runner appends
+   * `/tools/list` and `/tools/call` to this base.
+   */
+  url: string;
+}

package/src/generated/HttpMethod.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`.
+ */
+
+/**
+ * HTTP methods accepted by API-request command steps.
+ *
+ * Serialized uppercase (`GET`, `POST`, …) to match HTTP convention.
+ */
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";

package/src/generated/IdleCondition.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`.
+ */
+
+/**
+ * Condition that requires the runner to be idle (not executing workflows or
+ * AI tasks) before the task may run.
+ */
+export interface IdleCondition {
+  /**
+   * Whether this condition is active.
+   */
+  enabled: boolean;
+}

package/src/generated/ImplementFixesConfig.d.ts

@@ -0,0 +1,25 @@
+/* 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`.
+ */
+
+/**
+ * Configuration for the implement-fixes phase (Claude CLI).
+ */
+export interface ImplementFixesConfig {
+  /**
+   * Additional context to include in the fix prompt.
+   */
+  additionalContext?: string | null;
+  /**
+   * Model to use (e.g., `"claude-opus-4-6"`). Defaults to `claude-opus-4-6`
+   * when unset.
+   */
+  model?: string | null;
+  /**
+   * Timeout in seconds for the fix agent. Defaults to 600 when unset.
+   */
+  timeoutSecs?: number | null;
+}

package/src/generated/IndividualCheckResult.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`.
+ */
+
+import type { CheckIssueDetail } from './CheckIssueDetail';
+
+/**
+ * Result of a single named verification check (e.g., `"eslint"`, `"mypy"`).
+ */
+export interface IndividualCheckResult {
+  /**
+   * How long the check took, in milliseconds.
+   */
+  durationMs: number;
+  /**
+   * Error message, if the check itself failed to run.
+   */
+  errorMessage: string | null;
+  /**
+   * Number of files the check inspected.
+   */
+  filesChecked: number;
+  /**
+   * Specific issue details.
+   */
+  issues: CheckIssueDetail[];
+  /**
+   * Number of issues auto-fixed by this check.
+   */
+  issuesFixed: number;
+  /**
+   * Number of issues surfaced by this check.
+   */
+  issuesFound: number;
+  /**
+   * Name of the check.
+   */
+  name: string;
+  /**
+   * Raw check output, if captured.
+   */
+  output: string | null;
+  /**
+   * Free-form status string (e.g., `"passed"`, `"failed"`, `"skipped"`).
+   */
+  status: string;
+}

package/src/generated/InitialStateRef.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`.
+ */
+
+/**
+ * A lightweight reference to a state by id and display name.
+ *
+ * Used in [`ResolvedInitialStates`] and [`ResolvedInitialStatesResult`] to
+ * let the UI render human-readable lists without a separate lookup.
+ */
+export interface InitialStateRef {
+  /**
+   * State ID.
+   */
+  id: string;
+  /**
+   * Display name.
+   */
+  name: string;
+}

package/src/generated/InitialStatesSource.d.ts

@@ -0,0 +1,18 @@
+/* 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 initial states configuration.
+ *
+ * - `Defaults`: states with `is_initial=true` in the state machine definition
+ * - `Workflow`: initial states defined on the workflow (`initialStateIds`)
+ * - `Override`: session-only override from the runner UI
+ *
+ * Serialized as a bare lowercase string (`"defaults"` / `"workflow"` /
+ * `"override"`) to match the TS literal union.
+ */
+export type InitialStatesSource = "defaults" | "workflow" | "override";

package/src/generated/IssueSeverity.d.ts

@@ -0,0 +1,11 @@
+/* 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`.
+ */
+
+/**
+ * Severity of an issue reported against a run.
+ */
+export type IssueSeverity = "critical" | "high" | "medium" | "low" | "informational";

package/src/generated/IssueSource.d.ts

@@ -0,0 +1,11 @@
+/* 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 that detected an issue.
+ */
+export type IssueSource = "automation" | "ai_analysis" | "visual_regression" | "user_reported";

package/src/generated/IssueStatus.d.ts

@@ -0,0 +1,11 @@
+/* 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`.
+ */
+
+/**
+ * Lifecycle status of an issue reported against a run.
+ */
+export type IssueStatus = "new" | "open" | "in_progress" | "resolved" | "closed" | "wont_fix";