@qontinui/shared-types 0.2.1

package/src/discovery.ts

@@ -0,0 +1,188 @@
+/**
+ * Unified State Discovery Result types.
+ *
+ * These types represent the output of state discovery from any source:
+ * - Playwright (web extraction)
+ * - UI Bridge (render log analysis)
+ * - Recording (user session recording)
+ * - Vision (screenshot analysis)
+ * - Manual (user-defined)
+ *
+ * All types use camelCase field names to match the generated types from Rust
+ * schemas. Converter functions are provided to transform snake_case API
+ * responses into these typed objects.
+ */
+
+// =============================================================================
+// Re-exports from generated types
+// =============================================================================
+
+export type { DiscoverySourceType } from "./generated/DiscoverySourceType";
+export type { TransitionTriggerType } from "./generated/TransitionTriggerType";
+export type { DiscoveryBoundingBox } from "./generated/DiscoveryBoundingBox";
+export type { DiscoveryTransitionTrigger } from "./generated/DiscoveryTransitionTrigger";
+export type { DiscoveredStateImage } from "./generated/DiscoveredStateImage";
+export type { DiscoveredState } from "./generated/DiscoveredState";
+export type { DiscoveredTransition } from "./generated/DiscoveredTransition";
+export type { StateDiscoveryResult } from "./generated/StateDiscoveryResult";
+export type { StateDiscoveryResultSummary } from "./generated/StateDiscoveryResultSummary";
+export type { StateDiscoveryResultListResponse } from "./generated/StateDiscoveryResultListResponse";
+export type { StateDiscoveryResultCreate } from "./generated/StateDiscoveryResultCreate";
+export type { StateDiscoveryResultUpdate } from "./generated/StateDiscoveryResultUpdate";
+
+// =============================================================================
+// Export/Import
+// =============================================================================
+
+export type { StateMachineExport } from "./generated/StateMachineExport";
+export type { StateMachineImport } from "./generated/StateMachineImport";
+
+import type { DiscoverySourceType } from "./generated/DiscoverySourceType";
+import type { DiscoveredStateImage } from "./generated/DiscoveredStateImage";
+import type { DiscoveredState } from "./generated/DiscoveredState";
+import type { DiscoveredTransition } from "./generated/DiscoveredTransition";
+
+// =============================================================================
+// Display Helpers
+// =============================================================================
+
+export const SOURCE_TYPE_LABELS: Record<DiscoverySourceType, string> = {
+  playwright: "Web Extraction",
+  ui_bridge: "UI Bridge",
+  recording: "Recording",
+  vision: "Vision",
+  manual: "Manual",
+};
+
+export const SOURCE_TYPE_COLORS: Record<DiscoverySourceType, string> = {
+  playwright: "bg-blue-500/20 text-blue-400 border-blue-500/30",
+  ui_bridge: "bg-purple-500/20 text-purple-400 border-purple-500/30",
+  recording: "bg-green-500/20 text-green-400 border-green-500/30",
+  vision: "bg-orange-500/20 text-orange-400 border-orange-500/30",
+  manual: "bg-gray-500/20 text-gray-400 border-gray-500/30",
+};
+
+// =============================================================================
+// Converter Functions (snake_case API responses -> camelCase typed objects)
+// =============================================================================
+
+import type { StateDiscoveryResult } from "./generated/StateDiscoveryResult";
+import type { StateDiscoveryResultSummary } from "./generated/StateDiscoveryResultSummary";
+import type { DiscoveryBoundingBox } from "./generated/DiscoveryBoundingBox";
+import type { DiscoveryTransitionTrigger } from "./generated/DiscoveryTransitionTrigger";
+import type { TransitionTriggerType } from "./generated/TransitionTriggerType";
+
+export function toStateDiscoveryResult(
+  data: Record<string, unknown>,
+): StateDiscoveryResult {
+  return {
+    id: data.id as string,
+    projectId: (data.projectId ?? data.project_id) as string,
+    name: data.name as string,
+    description: data.description as string | undefined,
+    sourceType: (data.sourceType ?? data.source_type) as DiscoverySourceType,
+    sourceSessionId: (data.sourceSessionId ?? data.source_session_id) as
+      | string
+      | undefined,
+    discoveryStrategy: (data.discoveryStrategy ?? data.discovery_strategy) as
+      | string
+      | undefined,
+    images: ((data.images as unknown[]) || []).map(toDiscoveredStateImage),
+    states: ((data.states as unknown[]) || []).map(toDiscoveredState),
+    transitions: ((data.transitions as unknown[]) || []).map(
+      toDiscoveredTransition,
+    ),
+    elementToRenders:
+      ((data.elementToRenders ?? data.element_to_renders) as Record<
+        string,
+        string[]
+      >) || {},
+    imageCount: (data.imageCount ?? data.image_count) as number,
+    stateCount: (data.stateCount ?? data.state_count) as number,
+    transitionCount: (data.transitionCount ?? data.transition_count) as number,
+    renderCount: (data.renderCount ?? data.render_count) as number,
+    uniqueElementCount: (data.uniqueElementCount ??
+      data.unique_element_count) as number,
+    confidence: data.confidence as number,
+    discoveryMetadata:
+      ((data.discoveryMetadata ?? data.discovery_metadata) as Record<
+        string,
+        unknown
+      >) || {},
+    createdAt: (data.createdAt ?? data.created_at) as string,
+    updatedAt: (data.updatedAt ?? data.updated_at) as string,
+  };
+}
+
+export function toDiscoveredStateImage(data: unknown): DiscoveredStateImage {
+  const d = data as Record<string, unknown>;
+  return {
+    id: d.id as string,
+    screenshotId: (d.screenshotId ?? d.screenshot_id) as string | undefined,
+    screenshotUrl: (d.screenshotUrl ?? d.screenshot_url) as string | undefined,
+    bbox: d.bbox as DiscoveryBoundingBox,
+    pixelHash: (d.pixelHash ?? d.pixel_hash) as string | undefined,
+    stateId: (d.stateId ?? d.state_id) as string | undefined,
+    elementType: (d.elementType ?? d.element_type) as string | undefined,
+    label: d.label as string | undefined,
+    confidence: (d.confidence as number) ?? 1.0,
+    metadata: d.metadata as Record<string, unknown> | undefined,
+  };
+}
+
+export function toDiscoveredState(data: unknown): DiscoveredState {
+  const d = data as Record<string, unknown>;
+  return {
+    id: d.id as string,
+    name: d.name as string,
+    imageIds: ((d.imageIds ?? d.image_ids) as string[]) || [],
+    renderIds: ((d.renderIds ?? d.render_ids) as string[]) || [],
+    elementIds: ((d.elementIds ?? d.element_ids) as string[]) || [],
+    confidence: (d.confidence as number) ?? 1.0,
+    description: d.description as string | undefined,
+    metadata: d.metadata as Record<string, unknown> | undefined,
+  };
+}
+
+export function toDiscoveredTransition(data: unknown): DiscoveredTransition {
+  const d = data as Record<string, unknown>;
+  const trigger = d.trigger as Record<string, unknown> | undefined;
+  return {
+    id: d.id as string,
+    fromStateId: (d.fromStateId ?? d.from_state_id) as string,
+    toStateId: (d.toStateId ?? d.to_state_id) as string,
+    trigger: trigger
+      ? {
+          type: (trigger.type as TransitionTriggerType) ?? "click",
+          imageId: (trigger.imageId ?? trigger.image_id) as string | undefined,
+          elementId: (trigger.elementId ?? trigger.element_id) as
+            | string
+            | undefined,
+          selector: trigger.selector as string | undefined,
+          value: trigger.value as string | undefined,
+        }
+      : undefined,
+    confidence: (d.confidence as number) ?? 1.0,
+    metadata: d.metadata as Record<string, unknown> | undefined,
+  };
+}
+
+export function toStateDiscoveryResultSummary(
+  data: Record<string, unknown>,
+): StateDiscoveryResultSummary {
+  return {
+    id: data.id as string,
+    projectId: (data.projectId ?? data.project_id) as string,
+    name: data.name as string,
+    description: data.description as string | undefined,
+    sourceType: (data.sourceType ?? data.source_type) as DiscoverySourceType,
+    discoveryStrategy: (data.discoveryStrategy ?? data.discovery_strategy) as
+      | string
+      | undefined,
+    imageCount: (data.imageCount ?? data.image_count) as number,
+    stateCount: (data.stateCount ?? data.state_count) as number,
+    transitionCount: (data.transitionCount ?? data.transition_count) as number,
+    confidence: data.confidence as number,
+    createdAt: (data.createdAt ?? data.created_at) as string,
+  };
+}

package/src/execution/_api.ts

@@ -0,0 +1,483 @@
+/**
+ * Execution Types
+ *
+ * Type definitions for the unified execution reporting API that supports
+ * multiple run types: QA testing, integration testing, live automation,
+ * recording sessions, and debug runs.
+ *
+ * Tier 1 (enums) and Tier 2 (request/response DTOs) are generated from Rust
+ * (source of truth: qontinui-schemas/rust/src/execution.rs). Do not edit
+ * those sections by hand — regenerate via `just generate-types` (or
+ * `qontinui-runner/src-tauri/scripts/generate_types.sh`).
+ *
+ * Tier 3 (UI display / live-status-stream types) remains hand-authored below.
+ */
+
+// ============================================================================
+// Enums (Tier 1, generated)
+// ============================================================================
+//
+// For enums that had named-constant call-site syntax in the old hand-authored
+// TS (e.g. `RunType.QA_TEST`), we import the generated literal union under an
+// alias, re-export it as the type name, and declare a companion `const` object
+// with the same name so `RunType.QA_TEST` still resolves as a value. TS merges
+// the type alias and const value into one declaration usable in both
+// positions.
+
+import type { RunType as _RunType } from "../generated/RunType";
+export type RunType = _RunType;
+export const RunType = {
+  QA_TEST: "qa_test",
+  INTEGRATION_TEST: "integration_test",
+  LIVE_AUTOMATION: "live_automation",
+  RECORDING: "recording",
+  DEBUG: "debug",
+} as const;
+
+import type { RunStatus as _RunStatus } from "../generated/RunStatus";
+export type RunStatus = _RunStatus;
+export const RunStatus = {
+  PENDING: "pending",
+  RUNNING: "running",
+  COMPLETED: "completed",
+  FAILED: "failed",
+  TIMEOUT: "timeout",
+  CANCELLED: "cancelled",
+  PAUSED: "paused",
+} as const;
+
+import type { ActionStatus as _ActionStatus } from "../generated/ActionStatus";
+export type ActionStatus = _ActionStatus;
+export const ActionStatus = {
+  SUCCESS: "success",
+  FAILED: "failed",
+  TIMEOUT: "timeout",
+  SKIPPED: "skipped",
+  ERROR: "error",
+  PENDING: "pending",
+} as const;
+
+// `ActionType` collides with `tree_events::ActionType` on the Rust side, so
+// the generated symbol is `ExecutionActionType`. We preserve the local name
+// `ActionType` for backward compatibility.
+import type { ExecutionActionType as _ActionType } from "../generated/ExecutionActionType";
+export type ActionType = _ActionType;
+export const ActionType = {
+  // Vision actions
+  FIND: "find",
+  FIND_ALL: "find_all",
+  WAIT_FOR: "wait_for",
+  WAIT_UNTIL_GONE: "wait_until_gone",
+
+  // Input actions
+  CLICK: "click",
+  DOUBLE_CLICK: "double_click",
+  RIGHT_CLICK: "right_click",
+  TYPE: "type",
+  PRESS_KEY: "press_key",
+  HOTKEY: "hotkey",
+  SCROLL: "scroll",
+  DRAG: "drag",
+
+  // State machine actions
+  GO_TO_STATE: "go_to_state",
+  TRANSITION: "transition",
+  VERIFY_STATE: "verify_state",
+
+  // Control flow
+  CONDITIONAL: "conditional",
+  LOOP: "loop",
+  PARALLEL: "parallel",
+  SEQUENCE: "sequence",
+
+  // Utility
+  WAIT: "wait",
+  SCREENSHOT: "screenshot",
+  LOG: "log",
+  ASSERT: "assert",
+
+  // AI actions
+  AI_PROMPT: "ai_prompt",
+  RUN_PROMPT_SEQUENCE: "run_prompt_sequence",
+
+  // Custom/plugin
+  CUSTOM: "custom",
+} as const;
+
+import type { ErrorType as _ErrorType } from "../generated/ErrorType";
+export type ErrorType = _ErrorType;
+export const ErrorType = {
+  ELEMENT_NOT_FOUND: "element_not_found",
+  TIMEOUT: "timeout",
+  ASSERTION_FAILED: "assertion_failed",
+  CRASH: "crash",
+  NETWORK_ERROR: "network_error",
+  VALIDATION_ERROR: "validation_error",
+  OTHER: "other",
+} as const;
+
+import type { IssueSeverity as _IssueSeverity } from "../generated/IssueSeverity";
+export type IssueSeverity = _IssueSeverity;
+export const IssueSeverity = {
+  CRITICAL: "critical",
+  HIGH: "high",
+  MEDIUM: "medium",
+  LOW: "low",
+  INFORMATIONAL: "informational",
+} as const;
+
+import type { ScreenshotType as _ScreenshotType } from "../generated/ScreenshotType";
+export type ScreenshotType = _ScreenshotType;
+export const ScreenshotType = {
+  ERROR: "error",
+  SUCCESS: "success",
+  MANUAL: "manual",
+  PERIODIC: "periodic",
+  ACTION_RESULT: "action_result",
+  STATE_VERIFICATION: "state_verification",
+} as const;
+
+// Shape of annotation overlay on a screenshot. Was inline on
+// `ExecutionScreenshotCreate.annotations[].type` previously. No call sites
+// used a named-constant syntax, so a plain re-export suffices.
+export type { ScreenshotAnnotationShape } from "../generated/ScreenshotAnnotationShape";
+
+// ============================================================================
+// Metadata & DTO Types (Tier 2, generated)
+// ============================================================================
+
+export type { RunnerMetadata } from "../generated/RunnerMetadata";
+export type { WorkflowMetadata } from "../generated/WorkflowMetadata";
+export type { ExecutionStats } from "../generated/ExecutionStats";
+export type { CoverageData } from "../generated/CoverageData";
+export type { LLMMetrics } from "../generated/LLMMetrics";
+
+// ============================================================================
+// Request/Create + Response Types (Tier 2, generated)
+// ============================================================================
+
+export type { ExecutionRunCreate } from "../generated/ExecutionRunCreate";
+export type { ExecutionRunResponse } from "../generated/ExecutionRunResponse";
+
+// `MatchLocation` collides with `tree_events::MatchLocation` on the Rust
+// side, so the generated symbol is `ExecutionMatchLocation`. Preserve the
+// local name via a re-export alias.
+export type { ExecutionMatchLocation as MatchLocation } from "../generated/ExecutionMatchLocation";
+
+export type { ActionExecutionCreate } from "../generated/ActionExecutionCreate";
+export type { ActionExecutionResponse } from "../generated/ActionExecutionResponse";
+
+export type { ScreenshotAnnotation } from "../generated/ScreenshotAnnotation";
+export type { ExecutionScreenshotCreate } from "../generated/ExecutionScreenshotCreate";
+export type { ExecutionScreenshotResponse } from "../generated/ExecutionScreenshotResponse";
+
+export type { ExecutionIssueCreate } from "../generated/ExecutionIssueCreate";
+export type { ExecutionIssueResponse } from "../generated/ExecutionIssueResponse";
+
+export type { ExecutionRunComplete } from "../generated/ExecutionRunComplete";
+export type { ExecutionRunCompleteResponse } from "../generated/ExecutionRunCompleteResponse";
+
+// ============================================================================
+// Execution Status Types (real-time display) — Tier 3, hand-authored
+// ============================================================================
+
+export type TaskComplexity = "simple" | "medium" | "complex";
+
+export interface RoutingFactor {
+  description: string;
+  complexity: TaskComplexity;
+  weight: number;
+}
+
+export interface RoutingDecision {
+  complexity: TaskComplexity;
+  confidence: number;
+  factors: string[];
+  selectedModel: string;
+  timestamp: number;
+  promptPreview?: string;
+  fileCount?: number;
+  criteriaCount?: number;
+}
+
+export interface RoutingStatus {
+  enabled: boolean;
+  decision: RoutingDecision | null;
+  config: {
+    simpleModel: string;
+    mediumModel: string;
+    complexModel: string;
+  };
+}
+
+export interface RetryAttempt {
+  attemptNumber: number;
+  error: string;
+  timestamp: string;
+  delayMs: number;
+  feedbackInjected: boolean;
+}
+
+export interface RetryState {
+  attempt: number;
+  lastError: string | null;
+  lastAttemptAt: string | null;
+  totalDelayMs: number;
+  errorHistory: RetryAttempt[];
+}
+
+export interface RetryStatus {
+  enabled: boolean;
+  maxRetries: number;
+  feedbackInjection: boolean;
+  state: RetryState;
+  nextRetryDelayMs: number | null;
+  exhausted: boolean;
+}
+
+export interface TokenCount {
+  total: number;
+  findings: number;
+  observations: number;
+  feedback: number;
+  solutions: number;
+  other: number;
+  entryCount: number;
+}
+
+export interface CompressionResult {
+  originalTokens: number;
+  compressedTokens: number;
+  itemsSummarized: number;
+  summaryEntriesCreated: number;
+  compressedCategories: string[];
+  timestamp: string;
+}
+
+export interface CompressionStatus {
+  enabled: boolean;
+  thresholdTokens: number;
+  targetTokens: number;
+  currentTokenCount: TokenCount | null;
+  lastCompression: CompressionResult | null;
+  thresholdPercentage: number;
+  compressionImminent: boolean;
+}
+
+export type HookTrigger =
+  | "pre_execution"
+  | "post_execution"
+  | "on_error"
+  | "on_verification_fail"
+  | "on_complete"
+  | "pre_iteration"
+  | "post_iteration";
+
+export interface HookExecutionResult {
+  hookId: string;
+  hookName: string;
+  trigger: HookTrigger;
+  success: boolean;
+  output: string | null;
+  error: string | null;
+  durationMs: number;
+  timestamp: string;
+}
+
+export interface HookDefinition {
+  id: string;
+  name: string;
+  trigger: HookTrigger;
+  enabled: boolean;
+  actionType: string;
+}
+
+export interface HookStatus {
+  hooks: HookDefinition[];
+  executionHistory: HookExecutionResult[];
+  currentlyExecuting: string | null;
+}
+
+export type SubStepStatus =
+  | "pending"
+  | "running"
+  | "completed"
+  | "failed"
+  | "skipped";
+
+export interface SubStepInfo {
+  id: string;
+  parentId: string;
+  name: string;
+  status: SubStepStatus;
+  index: number;
+  totalCount: number;
+  startedAt: number | null;
+  completedAt: number | null;
+  durationMs: number | null;
+  phase?: string;
+}
+
+export interface SubStepStatusDisplay {
+  current: SubStepInfo | null;
+  steps: SubStepInfo[];
+  progressPercent: number;
+  completedCount: number;
+  totalCount: number;
+  isActive: boolean;
+  currentPhase: string | null;
+}
+
+export interface ExecutionStatus {
+  taskRunId: string | null;
+  taskName: string | null;
+  iteration: number;
+  status: "idle" | "running" | "completed" | "failed" | "paused";
+  routing: RoutingStatus;
+  retry: RetryStatus;
+  compression: CompressionStatus;
+  hooks: HookStatus;
+  subSteps: SubStepStatusDisplay;
+  lastUpdated: number;
+}
+
+// ============================================================================
+// Raw Event Types (snake_case from backend) — Tier 3, hand-authored
+// ============================================================================
+
+export interface RawExecutionStatusEventBase {
+  type: string;
+  task_run_id: string;
+  timestamp: number;
+}
+
+export interface RawRoutingDecisionPayload {
+  complexity: string;
+  confidence: number;
+  factors: string[];
+  selected_model: string;
+  prompt_preview?: string;
+  file_count?: number;
+  criteria_count?: number;
+}
+
+export interface RawRetryAttemptPayload {
+  attempt_number: number;
+  error: string;
+  attempt_timestamp: string;
+  delay_ms: number;
+  feedback_injected: boolean;
+}
+
+export interface RawRetryStatePayload {
+  attempt: number;
+  last_error: string | null;
+  last_attempt_at: string | null;
+  total_delay_ms: number;
+  error_history: RawRetryAttemptPayload[];
+}
+
+export interface RawTokenCountPayload {
+  total: number;
+  findings: number;
+  observations: number;
+  feedback: number;
+  solutions: number;
+  other: number;
+  entry_count: number;
+}
+
+export interface RawCompressionResultPayload {
+  original_tokens: number;
+  compressed_tokens: number;
+  items_summarized: number;
+  summary_entries_created: number;
+  compressed_categories: string[];
+  timestamp: string;
+}
+
+export interface RawHookExecutionPayload {
+  hook_id: string;
+  hook_name: string;
+  trigger: string;
+  success: boolean;
+  output: string | null;
+  error: string | null;
+  duration_ms: number;
+  timestamp: string;
+}
+
+export interface RawRoutingDecisionEvent extends RawExecutionStatusEventBase {
+  type: "routing_decision";
+  decision: RawRoutingDecisionPayload;
+}
+
+export interface RawRetryAttemptEvent extends RawExecutionStatusEventBase {
+  type: "retry_attempt";
+  attempt: RawRetryAttemptPayload;
+  state: RawRetryStatePayload;
+  exhausted: boolean;
+  next_retry_delay_ms: number | null;
+}
+
+export interface RawCompressionEvent extends RawExecutionStatusEventBase {
+  type: "compression";
+  result: RawCompressionResultPayload;
+  current_token_count: RawTokenCountPayload;
+}
+
+export interface RawTokenCountUpdateEvent extends RawExecutionStatusEventBase {
+  type: "token_count_update";
+  token_count: RawTokenCountPayload;
+  threshold_percentage: number;
+  compression_imminent: boolean;
+}
+
+export interface RawHookExecutionEvent extends RawExecutionStatusEventBase {
+  type: "hook_execution";
+  result: RawHookExecutionPayload;
+}
+
+export interface RawHookStartedEvent extends RawExecutionStatusEventBase {
+  type: "hook_started";
+  hook_id: string;
+  hook_name: string;
+  trigger: string;
+}
+
+export interface RawStatusChangeEvent extends RawExecutionStatusEventBase {
+  type: "status_change";
+  status: string;
+  iteration: number;
+  task_name: string | null;
+}
+
+export interface RawSubStepCompleteEvent {
+  type: "sub_step_complete";
+  checkpoint_id: string;
+  task_run_id: string;
+  sub_step_id: string;
+  description: string | null;
+  timestamp: number;
+}
+
+export interface RawSubStepStartedEvent {
+  type: "sub_step_started";
+  checkpoint_id: string;
+  task_run_id: string;
+  sub_step_id: string;
+  sub_step_index: number;
+  total_sub_steps: number;
+  description: string | null;
+  phase: string | null;
+  timestamp: number;
+}
+
+export type RawExecutionStatusEvent =
+  | RawRoutingDecisionEvent
+  | RawRetryAttemptEvent
+  | RawCompressionEvent
+  | RawTokenCountUpdateEvent
+  | RawHookExecutionEvent
+  | RawHookStartedEvent
+  | RawStatusChangeEvent;

package/src/execution/index.ts

@@ -0,0 +1 @@
+export * from "./_api";

package/src/generated/A11yAction.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`.
+ */
+
+/**
+ * Accessibility action kinds.
+ */
+export type A11yAction = "capture" | "click" | "type" | "focus" | "query" | "ai_context";

package/src/generated/AccessibilityBackend.d.ts

@@ -0,0 +1,12 @@
+/* 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 capture backend. Each variant corresponds to a platform
+ * accessibility API implementation.
+ */
+export type AccessibilityBackend = "auto" | "cdp" | "uia" | "atspi" | "ax" | "none";