@qontinui/shared-types 0.2.1

package/src/generated/ActionResponse.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 { ElementRect } from './ElementRect';
+import type { ElementState } from './ElementState';
+
+/**
+ * Response from executing an action on an element or component.
+ */
+export interface ActionResponse {
+  /**
+   * Time taken to execute the action in milliseconds.
+   */
+  durationMs: number;
+  /**
+   * Updated element state after the action (if applicable).
+   */
+  elementState?: ElementState | null;
+  /**
+   * Error message if the action failed.
+   */
+  error?: string | null;
+  /**
+   * Action-specific return value.
+   */
+  result?: {
+    [k: string]: unknown;
+  };
+  /**
+   * Stack trace if the action threw an exception.
+   */
+  stack?: string | null;
+  /**
+   * Whether the action completed successfully.
+   */
+  success: boolean;
+  /**
+   * Unix-epoch millisecond timestamp when the action completed.
+   */
+  timestamp: number;
+}

package/src/generated/ActionStatus.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`.
+ */
+
+/**
+ * Outcome of a single action within a run.
+ */
+export type ActionStatus = "success" | "failed" | "timeout" | "skipped" | "error" | "pending";

package/src/generated/ActionType.d.ts

@@ -0,0 +1,41 @@
+/* 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`.
+ */
+
+/**
+ * Types of actions in the automation system.
+ *
+ * Corresponds to the action types defined in the qontinui-schemas config
+ * models. Variants use SCREAMING_SNAKE_CASE on the wire to match the Python
+ * enum values.
+ */
+export type ActionType =
+  | "FIND"
+  | "FIND_STATE_IMAGE"
+  | "EXISTS"
+  | "VANISH"
+  | "CLICK"
+  | "DOUBLE_CLICK"
+  | "RIGHT_CLICK"
+  | "DRAG"
+  | "SCROLL"
+  | "MOUSE_MOVE"
+  | "TYPE"
+  | "KEY_PRESS"
+  | "HOTKEY"
+  | "IF"
+  | "LOOP"
+  | "SWITCH"
+  | "TRY_CATCH"
+  | "BREAK"
+  | "CONTINUE"
+  | "GO_TO_STATE"
+  | "WAIT"
+  | "RUN_WORKFLOW"
+  | "SCREENSHOT"
+  | "CODE_BLOCK"
+  | "SHELL"
+  | "CUSTOM";

package/src/generated/ActiveStatesResult.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`.
+ */
+
+/**
+ * Result of querying currently active states in the state machine.
+ */
+export interface ActiveStatesResult {
+  /**
+   * State IDs currently active.
+   */
+  active_states: string[];
+  /**
+   * The "primary" current state, when one can be singled out.
+   */
+  current_state?: string | null;
+  /**
+   * Error message when the query failed.
+   */
+  error?: string | null;
+  /**
+   * Ordered history of states the machine has passed through.
+   */
+  state_history?: string[] | null;
+  /**
+   * Whether the query succeeded.
+   */
+  success: boolean;
+}

package/src/generated/AgenticPhaseOutput.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 { AgenticStatus } from './AgenticStatus';
+import type { FileChange } from './FileChange';
+import type { FindingOutput } from './FindingOutput';
+import type { ReflectionFixOutput } from './ReflectionFixOutput';
+
+/**
+ * Canonical structured output from the agentic phase.
+ */
+export interface AgenticPhaseOutput {
+  /**
+   * AI's confidence that the fixes will pass verification (0.0-1.0).
+   */
+  confidence: number | null;
+  /**
+   * Files modified during this agentic phase.
+   */
+  filesModified: FileChange[];
+  /**
+   * Findings reported by the AI.
+   */
+  findings: FindingOutput[];
+  /**
+   * Dynamically injected verification steps.
+   */
+  injectedSteps: unknown[];
+  /**
+   * Reflection fixes (when reflection_mode is enabled).
+   */
+  reflectionFixes: ReflectionFixOutput[];
+  status: AgenticStatus;
+  /**
+   * Human-readable summary of what was done.
+   */
+  summary: string;
+  /**
+   * Whether the AI determined errors are unfixable.
+   */
+  unfixable: boolean;
+  /**
+   * Reason why errors are unfixable (if unfixable is true).
+   */
+  unfixableReason: string | null;
+}

package/src/generated/AgenticStatus.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`.
+ */
+
+/**
+ * Status of the agentic phase execution.
+ */
+export type AgenticStatus = "success" | "partial_success" | "failed" | "unfixable";

package/src/generated/AiWorkflow.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 { ExecutionStep } from './ExecutionStep';
+
+/**
+ * A saved AI Builder workflow template.
+ *
+ * Users create these in the Automation Builder tab. Each workflow carries an
+ * ordered list of `ExecutionStep`s plus metadata (goal, category, tags,
+ * context references). The runner persists them in `ai_workflows.json` and
+ * surfaces them through Tauri commands and the HTTP API.
+ */
+export interface AiWorkflow {
+  /**
+   * Whether to auto-include contexts based on task mentions (default: true).
+   */
+  autoIncludeContexts: boolean;
+  /**
+   * Whether to capture input for coordinate validation.
+   */
+  captureInputValidation?: boolean;
+  /**
+   * Category for organization (e.g., `"Testing"`, `"Development"`).
+   */
+  category?: string;
+  /**
+   * Manually added context IDs.
+   */
+  contextIds?: string[];
+  /**
+   * ISO 8601 timestamp of creation.
+   */
+  createdAt: string;
+  /**
+   * Optional description of what this workflow does.
+   */
+  description?: string;
+  /**
+   * Disabled context IDs (excluded from auto-include).
+   */
+  disabledContextIds?: string[];
+  /**
+   * The goal/objective for this workflow.
+   */
+  goal?: string;
+  /**
+   * Unique identifier (UUID v4).
+   */
+  id: string;
+  /**
+   * Maximum iterations for the AI loop.
+   * `None` (omitted) means no cap — loop until success or explicit stop.
+   */
+  maxIterations?: number | null;
+  /**
+   * ISO 8601 timestamp of last modification.
+   */
+  modifiedAt: string;
+  /**
+   * Display name for the workflow.
+   */
+  name: string;
+  /**
+   * The ordered list of execution steps.
+   */
+  steps?: ExecutionStep[];
+  /**
+   * Tags for filtering/searching.
+   */
+  tags?: string[];
+}

package/src/generated/ApiAssertion.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`.
+ */
+
+import type { ApiAssertionOperator } from './ApiAssertionOperator';
+import type { ApiAssertionType } from './ApiAssertionType';
+
+/**
+ * A single assertion evaluated against an API response.
+ */
+export interface ApiAssertion {
+  /**
+   * Expected value. The TS source allows either a string or number, so
+   * this field stays as `serde_json::Value` on the wire.
+   */
+  expected: {
+    [k: string]: unknown;
+  };
+  /**
+   * Header name for `header` assertions.
+   */
+  headerName?: string | null;
+  /**
+   * JSONPath for `json_path` assertions.
+   */
+  jsonPath?: string | null;
+  /**
+   * Comparison operator; defaults to `equals` on the consumer side.
+   */
+  operator?: ApiAssertionOperator | null;
+  type: ApiAssertionType;
+}

package/src/generated/ApiAssertionOperator.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`.
+ */
+
+/**
+ * Comparison operators supported by API assertions.
+ */
+export type ApiAssertionOperator = "equals" | "contains" | "matches" | "greater_than" | "less_than";

package/src/generated/ApiAssertionType.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`.
+ */
+
+/**
+ * Assertion kinds supported on API responses.
+ */
+export type ApiAssertionType = "status_code" | "json_path" | "header" | "body_contains" | "response_time";

package/src/generated/ApiContentType.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`.
+ */
+
+/**
+ * Content-Type values for an API request body.
+ */
+export type ApiContentType = "application/json" | "application/x-www-form-urlencoded" | "text/plain" | "none";

package/src/generated/ApiVariableExtraction.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`.
+ */
+
+/**
+ * Extract a named variable from an API response via JSONPath.
+ */
+export interface ApiVariableExtraction {
+  /**
+   * Default value if the path does not resolve.
+   */
+  defaultValue?: string | null;
+  /**
+   * JSONPath expression used to extract the value.
+   */
+  jsonPath: string;
+  /**
+   * Variable name to bind the extracted value to.
+   */
+  variableName: string;
+}