@qontinui/shared-types 0.2.1

package/src/generated/ScheduledTaskType.d.ts

@@ -0,0 +1,126 @@
+/* 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 { McpConnectionRef } from './McpConnectionRef';
+
+/**
+ * Type of task to schedule.
+ *
+ * Internally tagged by `task_type`: the variant fields are inlined alongside
+ * the discriminator rather than nested under a `value` key.
+ */
+export type ScheduledTaskType =
+  | {
+      /**
+       * Optional path to a workflow config file.
+       */
+      config_path?: string | null;
+      /**
+       * Optional monitor index to target.
+       */
+      monitor_index?: number | null;
+      task_type: "Workflow";
+      /**
+       * If set, run a unified workflow by ID instead of a legacy workflow
+       * by name.
+       */
+      workflow_id?: string | null;
+      /**
+       * Display name (also used to look up legacy workflows).
+       */
+      workflow_name: string;
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * Optional override for `max_sessions`. `None` uses the prompt's own
+       * setting.
+       */
+      max_sessions?: number | null;
+      /**
+       * ID of the prompt to run.
+       */
+      prompt_id: string;
+      task_type: "Prompt";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * Whether to check the findings queue before running.
+       */
+      check_findings: boolean;
+      /**
+       * Force a run even if no findings are present.
+       */
+      force_run: boolean;
+      task_type: "AutoFix";
+      [k: string]: unknown;
+    }
+  | {
+      task_type: "Watcher";
+      /**
+       * ID of the watcher definition in PostgreSQL.
+       */
+      watcher_id: string;
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * Seconds between successive captures.
+       */
+      capture_interval_secs: number;
+      /**
+       * Whether to also trigger a capture on window focus change.
+       */
+      capture_on_focus_change: boolean;
+      /**
+       * Optional monitor index to capture.
+       */
+      monitor_index?: number | null;
+      task_type: "BackgroundCapture";
+      [k: string]: unknown;
+    }
+  | {
+      /**
+       * Allowed tool names (e.g. `["Bash", "Read", "Write", "Edit"]`).
+       * Empty = use the runner's default tool allow-list.
+       */
+      allowed_tools?: string[];
+      /**
+       * Hard cap on Claude turns per run (safety bound). `None` =
+       * runner's default cap (typically 50).
+       */
+      max_turns?: number | null;
+      /**
+       * Optional MCP connection references resolved at dispatch time
+       * against the runner's existing MCP config. Empty = inherit
+       * whatever the runner currently has configured.
+       */
+      mcp_connections?: McpConnectionRef[];
+      /**
+       * Optional model override. `None` = runner default
+       * (typically `claude-sonnet-4-6`).
+       */
+      model?: string | null;
+      /**
+       * The prompt content to send to the Claude session.
+       */
+      prompt: string;
+      task_type: "RemoteAgent";
+      /**
+       * Wall-clock timeout in seconds. `None` = runner default
+       * (typically 600s = 10 min).
+       */
+      timeout_seconds?: number | null;
+      /**
+       * Working directory for the spawned session. `None` means the
+       * runner's project root. Stored as a string (not `PathBuf`) to keep
+       * this crate JSON-Schema-friendly.
+       */
+      working_directory?: string | null;
+      [k: string]: unknown;
+    };

package/src/generated/SchedulerSettings.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`.
+ */
+
+/**
+ * Global scheduler settings.
+ */
+export interface SchedulerSettings {
+  /**
+   * Default `auto_fix_on_failure` value for newly created tasks.
+   */
+  defaultAutoFixOnFailure: boolean;
+  /**
+   * Whether the scheduler is enabled globally.
+   */
+  enabled: boolean;
+  /**
+   * Maximum number of scheduled tasks allowed to run concurrently.
+   */
+  maxConcurrent: number;
+  /**
+   * Timezone for schedule interpretation (IANA name). `None` = local time.
+   */
+  timezone?: string | null;
+}

package/src/generated/SchedulerStatus.d.ts

@@ -0,0 +1,31 @@
+/* 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 { NextTaskInfo } from './NextTaskInfo';
+
+/**
+ * Summary of the scheduler's current runtime state, returned from the status
+ * API.
+ */
+export interface SchedulerStatus {
+  /**
+   * Whether the scheduler is enabled.
+   */
+  enabled: boolean;
+  /**
+   * The next task scheduled to run, if any.
+   */
+  nextTask?: NextTaskInfo | null;
+  /**
+   * Number of tasks scheduled but not yet running.
+   */
+  pendingTasks: number;
+  /**
+   * Number of tasks currently running.
+   */
+  runningTasks: number;
+}

package/src/generated/ScreenshotAnnotation.d.ts

@@ -0,0 +1,39 @@
+/* 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 { ScreenshotAnnotationShape } from './ScreenshotAnnotationShape';
+
+/**
+ * Annotation overlaid on a screenshot (box, circle, arrow, or text).
+ */
+export interface ScreenshotAnnotation {
+  /**
+   * CSS-style color string (e.g., `"#FF0000"`).
+   */
+  color?: string | null;
+  /**
+   * Annotation height in pixels.
+   */
+  height?: number | null;
+  /**
+   * Free-form label for the annotation.
+   */
+  label?: string | null;
+  type: ScreenshotAnnotationShape;
+  /**
+   * Annotation width in pixels.
+   */
+  width?: number | null;
+  /**
+   * X coordinate in pixels.
+   */
+  x: number;
+  /**
+   * Y coordinate in pixels.
+   */
+  y: number;
+}

package/src/generated/ScreenshotAnnotationShape.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`.
+ */
+
+/**
+ * Kind of shape overlaid on a screenshot annotation.
+ */
+export type ScreenshotAnnotationShape = "box" | "circle" | "arrow" | "text";

package/src/generated/ScreenshotType.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`.
+ */
+
+/**
+ * Kind of screenshot captured.
+ */
+export type ScreenshotType = "error" | "success" | "manual" | "periodic" | "action_result" | "state_verification";

package/src/generated/ScrollDirection.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`.
+ */
+
+/**
+ * Scroll direction for the `scroll` action.
+ *
+ * Serialized as a bare lowercase string.
+ */
+export type ScrollDirection = "up" | "down" | "left" | "right";

package/src/generated/SearchOptions.d.ts

@@ -0,0 +1,33 @@
+/* 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 { CoordinateSystem } from './CoordinateSystem';
+import type { Coordinates } from './Coordinates';
+import type { MatchAdjustment } from './MatchAdjustment';
+import type { MatchMethod } from './MatchMethod';
+import type { PatternOptions } from './PatternOptions';
+import type { PollingConfig } from './PollingConfig';
+import type { Region } from './Region';
+import type { SearchStrategy } from './SearchStrategy';
+
+/**
+ * Search options for target finding.
+ */
+export interface SearchOptions {
+  adjustment?: MatchAdjustment | null;
+  captureImage?: boolean | null;
+  maxMatches?: number | null;
+  maxMatchesToActOn?: number | null;
+  minMatches?: number | null;
+  pattern?: PatternOptions | null;
+  polling?: PollingConfig | null;
+  searchRegions?: Region[] | null;
+  searchStrategy?: SearchStrategy | null;
+  similarity?: number | null;
+  timeout?: number | null;
+  useDefinedRegion?: boolean | null;
+}

package/src/generated/SearchResultItem.d.ts

@@ -0,0 +1,19 @@
+/* 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 { EmbeddingItem } from './EmbeddingItem';
+
+/**
+ * Single search result.
+ */
+export interface SearchResultItem {
+  embedding: EmbeddingItem;
+  /**
+   * Similarity score (0-1).
+   */
+  similarity_score: number;
+}

package/src/generated/SearchStrategy.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`.
+ */
+
+/**
+ * Strategy for selecting among multiple matches in a FIND action.
+ *
+ * Variants serialize uppercase (`"FIRST"`, `"ALL"`, `"BEST"`, `"EACH"`) to
+ * match the existing Python enum and all stored action configs.
+ */
+export type SearchStrategy = "FIRST" | "ALL" | "BEST" | "EACH";

package/src/generated/SemanticSearchRequest.d.ts

@@ -0,0 +1,26 @@
+/* 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`.
+ */
+
+/**
+ * Request for semantic search.
+ */
+export interface SemanticSearchRequest {
+  /**
+   * Max results to return (1–100).
+   */
+  limit: number;
+  /**
+   * Minimum similarity threshold (0–1). CLIP text-to-image similarities
+   * typically fall in 0.15–0.35, so 0.2 is a reasonable default.
+   */
+  min_similarity: number;
+  /**
+   * Search query text (min length 1).
+   */
+  query: string;
+  state_filter?: string | null;
+}

package/src/generated/SemanticSearchResponse.d.ts

@@ -0,0 +1,21 @@
+/* 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 { EmbeddingItem } from './EmbeddingItem';
+import type { SearchResultItem } from './SearchResultItem';
+
+/**
+ * Response from semantic search.
+ */
+export interface SemanticSearchResponse {
+  /**
+   * The original search query.
+   */
+  query: string;
+  results: SearchResultItem[];
+  total_found: number;
+}

package/src/generated/StageCondition.d.ts

@@ -0,0 +1,37 @@
+/* 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 for conditional stage execution.
+ *
+ * When attached to a [`WorkflowStage`], the stage is skipped if the condition
+ * evaluates to "should skip". All condition fields are optional and combine
+ * with AND semantics — all specified conditions must be met for the stage to
+ * run.
+ */
+export interface StageCondition {
+  /**
+   * Run this stage only if the previous stage had this outcome.
+   *
+   * - `"passed"`: run only if previous stage verification passed
+   * - `"failed"`: run only if previous stage verification failed
+   * - `"any"`: always run regardless of previous outcome (default behavior)
+   */
+  ifPrevious?: string | null;
+  /**
+   * Skip this stage if the total number of failed stages so far is below
+   * this threshold. Useful for "recovery" stages that only run when
+   * multiple prior stages have failed.
+   */
+  minFailures?: number | null;
+  /**
+   * Run this stage only after this many loop iterations have occurred
+   * (across all stages). Useful for "escalation" stages that only kick in
+   * after initial attempts have failed.
+   */
+  minIteration?: number | null;
+}

package/src/generated/StageInput.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`.
+ */
+
+/**
+ * An input required by a stage, referencing a prior stage's output.
+ */
+export interface StageInput {
+  /**
+   * Which stage provides this input (stage id). If omitted, searches all
+   * prior stages.
+   */
+  fromStage?: string | null;
+  /**
+   * The key to bind this input to (matches a [`StageOutput::key`] from a
+   * prior stage).
+   */
+  key: string;
+  /**
+   * Whether this input is required (default: `true`). Missing required
+   * inputs are Critical findings.
+   */
+  required: boolean;
+}

package/src/generated/StageOutput.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`.
+ */
+
+/**
+ * An output declared by a stage, available to subsequent stages.
+ */
+export interface StageOutput {
+  /**
+   * Human-readable description.
+   */
+  description: string;
+  /**
+   * Unique key for this output (e.g. `"api_url"`, `"auth_token"`).
+   */
+  key: string;
+}

package/src/generated/StageTransition.d.ts

@@ -0,0 +1,30 @@
+/* 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 record of a stage transition during task execution.
+ *
+ * Used for building the stage-based timeline on the recap page.
+ */
+export interface StageTransition {
+  /**
+   * Previous stage.
+   */
+  from: string;
+  /**
+   * Iteration number at the time of the transition.
+   */
+  iteration: number;
+  /**
+   * When the transition occurred (ISO 8601).
+   */
+  timestamp: string;
+  /**
+   * New stage.
+   */
+  to: string;
+}

package/src/generated/StallDetectorConfig.d.ts

@@ -0,0 +1,31 @@
+/* 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 stall-detection subsystem.
+ *
+ * Controls how the loop engine decides a run is stuck in a repeated-action /
+ * oscillation / runaway-step pattern and forces an exit.
+ */
+export interface StallDetectorConfig {
+  /**
+   * Maximum times the same action may repeat before stall is declared.
+   */
+  maxRepeatedActions: number;
+  /**
+   * Absolute ceiling on total steps across all iterations.
+   */
+  maxTotalSteps: number;
+  /**
+   * Window (in actions) used to detect oscillation between two states.
+   */
+  oscillationWindow: number;
+  /**
+   * Wall-clock seconds without progress before stall is declared.
+   */
+  stallTimeoutSecs: number;
+}

package/src/generated/StandardActionType.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`.
+ */
+
+/**
+ * All UI Bridge SDK standard actions plus workflow-level actions
+ * (`wait`, `navigate`).
+ *
+ * Parameterized actions: `click`, `doubleClick`, `rightClick`, `type`,
+ * `select`, `scroll`, `drag`.
+ * No-param actions: `clear`, `focus`, `blur`, `hover`, `check`, `uncheck`,
+ * `toggle`, `setValue`, `submit`, `reset`.
+ * Workflow-level actions: `wait`, `navigate`.
+ *
+ * Serialized as a bare camelCase string matching the TypeScript literal
+ * union (e.g., `"doubleClick"`, `"setValue"`).
+ */
+export type StandardActionType =
+  | "click"
+  | "doubleClick"
+  | "rightClick"
+  | "type"
+  | "clear"
+  | "select"
+  | "focus"
+  | "blur"
+  | "hover"
+  | "scroll"
+  | "check"
+  | "uncheck"
+  | "toggle"
+  | "setValue"
+  | "drag"
+  | "submit"
+  | "reset"
+  | "wait"
+  | "navigate";

package/src/generated/StateContext.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`.
+ */
+
+/**
+ * State-machine context captured before/after an action.
+ */
+export interface StateContext {
+  activated: string[];
+  activeAfter: string[];
+  activeBefore: string[];
+  changed: boolean;
+  deactivated: string[];
+}