@qontinui/shared-types 0.2.1

package/src/generated/OlConfig.d.ts

@@ -0,0 +1,48 @@
+/* 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 saved orchestration-loop configuration preset.
+ *
+ * Persisted in the runner's `orchestration_loop_configs` PostgreSQL table and
+ * surfaced to the frontend through the `ol_list_configs` / `ol_get_config`
+ * Tauri commands. The inner `config_json` is an `OrchestrationLoopConfig`
+ * serialized as a JSON blob — stored as `Value` here to preserve forward
+ * compatibility with older presets if the config schema grows new fields.
+ */
+export interface OlConfig {
+  /**
+   * The full [`OrchestrationLoopConfig`] as a JSON blob.
+   */
+  configJson: {
+    [k: string]: unknown;
+  };
+  /**
+   * ISO 8601 creation timestamp.
+   */
+  createdAt: string;
+  /**
+   * Optional free-form description.
+   */
+  description?: string | null;
+  /**
+   * UUID v4 identifier.
+   */
+  id: string;
+  /**
+   * Whether this preset is pinned as a favorite in the UI.
+   */
+  isFavorite: boolean;
+  /**
+   * Human-readable name (e.g., "Nightly regression sweep").
+   */
+  name: string;
+  /**
+   * ISO 8601 last-modified timestamp.
+   */
+  updatedAt: string;
+}

package/src/generated/OrchestrationLoopConfig.d.ts

@@ -0,0 +1,87 @@
+/* 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 { BetweenIterations } from './BetweenIterations';
+import type { BuildPhaseConfig } from './BuildPhaseConfig';
+import type { DecomposerConfig } from './DecomposerConfig';
+import type { DiagnosePhaseConfig } from './DiagnosePhaseConfig';
+import type { ExitStrategy } from './ExitStrategy';
+import type { ImplementFixesConfig } from './ImplementFixesConfig';
+import type { PipelineConfig } from './PipelineConfig';
+import type { StallDetectorConfig } from './StallDetectorConfig';
+import type { SummarizationConfig } from './SummarizationConfig';
+
+/**
+ * Full configuration for an orchestration loop run.
+ *
+ * Covers the simple mode (fixed `workflow_id`, `max_iterations`, exit
+ * strategy) as well as pipeline mode (build / diagnose / reflect / fix
+ * phases) when `pipeline` is populated.
+ */
+export interface OrchestrationLoopConfig {
+  /**
+   * What to do between iterations.
+   */
+  betweenIterations?: BetweenIterations & {};
+  /**
+   * Task-decomposition sub-config (omit to disable).
+   */
+  decomposition?: DecomposerConfig | null;
+  /**
+   * How to decide when to stop.
+   */
+  exitStrategy?: ExitStrategy & {};
+  /**
+   * Maximum number of iterations.
+   * `None` (omitted) means no cap — loop until success or explicit stop.
+   */
+  maxIterations?: number | null;
+  /**
+   * Pipeline-mode configuration. When present, enables build / reflect /
+   * fix phases.
+   */
+  pipeline?: PipelineConfig | null;
+  /**
+   * When `true`, a failed workflow iteration doesn't count as a terminal
+   * failure. Instead, the loop waits for the fixer workflow to complete,
+   * then re-runs. The loop only exits on success or `max_iterations`.
+   */
+  retryOnFailure: boolean;
+  /**
+   * Stall-detection sub-config (omit to disable).
+   */
+  stallDetection?: StallDetectorConfig | null;
+  /**
+   * Context-summarization sub-config (omit to disable).
+   */
+  summarization?: SummarizationConfig | null;
+  /**
+   * Supervisor port for restart/build operations.
+   */
+  supervisorPort: number;
+  /**
+   * Target runner ID (for supervisor restart calls). If `None`, uses
+   * `"primary"`.
+   */
+  targetRunnerId?: string | null;
+  /**
+   * Target runner port to execute workflows on.
+   * If `None`, targets self (this runner's own port).
+   */
+  targetRunnerPort?: number | null;
+  /**
+   * Whether to wait for the fixer workflow before starting the next
+   * iteration. Only applies when `retry_on_failure` is `true`.
+   */
+  waitForFixer: boolean;
+  /**
+   * Workflow ID to execute each iteration.
+   * Required for simple mode; optional in pipeline mode if the build phase
+   * is configured.
+   */
+  workflowId: string;
+}

package/src/generated/OrchestrationLoopStatus.d.ts

@@ -0,0 +1,59 @@
+/* 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 { DiagnosticResult } from './DiagnosticResult';
+import type { ExitCheckResult } from './ExitCheckResult';
+import type { IterationResult } from './IterationResult';
+import type { LoopPhase } from './LoopPhase';
+import type { RootCauseCategory } from './RootCauseCategory';
+
+/**
+ * Runtime state of an orchestration loop.
+ */
+export interface OrchestrationLoopStatus {
+  /**
+   * Iteration index (1-based) currently executing or just completed.
+   */
+  currentIteration: number;
+  /**
+   * Terminal error message (only set in the `Error` phase).
+   */
+  error?: string | null;
+  /**
+   * Whether this loop is in pipeline mode.
+   */
+  isPipeline: boolean;
+  /**
+   * Per-iteration results accumulated so far.
+   */
+  iterationResults?: IterationResult[];
+  /**
+   * Iteration cap for this run. `None` renders as `"∞"`/unlimited in the UI.
+   */
+  maxIterations?: number | null;
+  phase: LoopPhase;
+  /**
+   * Whether the loop is currently running.
+   */
+  running: boolean;
+  /**
+   * ISO 8601 start timestamp.
+   */
+  startedAt?: string | null;
+  /**
+   * Target runner ID.
+   */
+  targetRunnerId?: string | null;
+  /**
+   * Target runner port.
+   */
+  targetRunnerPort: number;
+  /**
+   * The workflow ID being executed.
+   */
+  workflowId: string;
+}

package/src/generated/Outcome.d.ts

@@ -0,0 +1,15 @@
+/* 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`.
+ */
+
+/**
+ * Execution outcome of an action.
+ */
+export interface Outcome {
+  error?: string | null;
+  retryCount: number;
+  success: boolean;
+}

package/src/generated/OutputLine.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 { OutputStream } from './OutputStream';
+
+/**
+ * A single line of output from a managed process.
+ */
+export interface OutputLine {
+  /**
+   * The line content
+   */
+  line: string;
+  stream: OutputStream;
+  /**
+   * ISO 8601 timestamp
+   */
+  timestamp: string;
+}

package/src/generated/OutputStream.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`.
+ */
+
+/**
+ * Which output stream a captured line came from.
+ */
+export type OutputStream = "stdout" | "stderr";

package/src/generated/OverrideCollection.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`.
+ */
+
+import type { CriterionOverride } from './CriterionOverride';
+
+/**
+ * Collection of overrides for a task run.
+ */
+export interface OverrideCollection {
+  /**
+   * All recorded overrides.
+   */
+  overrides?: CriterionOverride[];
+}

package/src/generated/Pagination.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`.
+ */
+
+/**
+ * Pagination envelope attached to list responses.
+ */
+export interface Pagination {
+  /**
+   * Whether additional records are available after this page.
+   */
+  hasMore: boolean;
+  /**
+   * Maximum number of records returned per page.
+   */
+  limit: number;
+  /**
+   * Offset into the full result set.
+   */
+  offset: number;
+  /**
+   * Total number of matching records.
+   */
+  total: number;
+}

package/src/generated/ParserType.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`.
+ */
+
+/**
+ * Parser type for extracting errors from a managed process's log stream.
+ *
+ * Mirrors the pre-extraction `crate::error_monitor::types::ParserType` wire
+ * format. Note the JavaScript rename: the canonical wire value is
+ * `"javascript"` but the serde `alias = "java_script"` is preserved for
+ * backwards compatibility with any settings that were written before the
+ * rename.
+ */
+export type ParserType = "python" | "javascript" | "rust" | "generic";

package/src/generated/PathElement.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`.
+ */
+
+import type { NodeType } from './NodeType';
+
+/**
+ * Element in a tree path (for breadcrumb navigation).
+ */
+export interface PathElement {
+  id: string;
+  name: string;
+  nodeType: NodeType;
+}

package/src/generated/PathfindingRequest.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`.
+ */
+
+/**
+ * Request to compute a path between state sets.
+ *
+ * The pathfinding types are for the graph editor's path-preview feature.
+ * Runtime navigation uses the qontinui Python library (`multistate`)
+ * directly.
+ */
+export interface PathfindingRequest {
+  /**
+   * States assumed to be active at the start of the search.
+   */
+  from_states: string[];
+  /**
+   * States that must all be active at the end.
+   */
+  target_states: string[];
+}

package/src/generated/PathfindingResult.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`.
+ */
+
+import type { PathfindingStep } from './PathfindingStep';
+
+/**
+ * Result of a pathfinding search.
+ */
+export interface PathfindingResult {
+  /**
+   * Error message when pathfinding failed.
+   */
+  error?: string | null;
+  /**
+   * Whether a valid path was found.
+   */
+  found: boolean;
+  /**
+   * Ordered steps on the computed path (empty when `found` is `false`).
+   */
+  steps: PathfindingStep[];
+  /**
+   * Sum of `path_cost` across steps.
+   */
+  total_cost: number;
+}

package/src/generated/PathfindingStep.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`.
+ */
+
+/**
+ * A single step on a computed path.
+ */
+export interface PathfindingStep {
+  /**
+   * States activated by this step.
+   */
+  activate_states: string[];
+  /**
+   * States exited by this step.
+   */
+  exit_states: string[];
+  /**
+   * States required to be active before this step.
+   */
+  from_states: string[];
+  /**
+   * Cost of this step.
+   */
+  path_cost: number;
+  /**
+   * Logical transition ID taken in this step.
+   */
+  transition_id: string;
+  /**
+   * Display name of the transition.
+   */
+  transition_name: string;
+}

package/src/generated/PatternOptions.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`.
+ */
+
+import type { MatchMethod } from './MatchMethod';
+
+/**
+ * Advanced pattern-matching options.
+ */
+export interface PatternOptions {
+  colorTolerance?: number | null;
+  edgeThreshold1?: number | null;
+  edgeThreshold2?: number | null;
+  matchMethod?: MatchMethod | null;
+  maxRotation?: number | null;
+  maxScale?: number | null;
+  minDistanceBetweenMatches?: number | null;
+  minRotation?: number | null;
+  minScale?: number | null;
+  nmsThreshold?: number | null;
+  nonMaxSuppression?: boolean | null;
+  rotationInvariant?: boolean | null;
+  rotationStep?: number | null;
+  scaleInvariant?: boolean | null;
+  scaleStep?: number | null;
+  useColorReduction?: boolean | null;
+  useEdges?: boolean | null;
+  useGrayscale?: boolean | null;
+}

package/src/generated/PipelineConfig.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 { BuildPhaseConfig } from './BuildPhaseConfig';
+import type { DiagnosePhaseConfig } from './DiagnosePhaseConfig';
+import type { ImplementFixesConfig } from './ImplementFixesConfig';
+
+/**
+ * Pipeline-mode configuration for the build → execute → diagnose → reflect →
+ * fix cycle.
+ */
+export interface PipelineConfig {
+  /**
+   * Generate the workflow from a description (optional — if absent, the
+   * top-level `workflow_id` is used).
+   */
+  build?: BuildPhaseConfig | null;
+  /**
+   * Diagnostic-evaluation phase — runs after Execute, before Reflect.
+   * Captures UI state via UI Bridge and classifies failure root causes.
+   */
+  diagnose?: DiagnosePhaseConfig | null;
+  /**
+   * Implement fixes via Claude CLI after reflection finds issues.
+   */
+  implementFixes?: ImplementFixesConfig | null;
+}

package/src/generated/PlaybackFrameRequest.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`.
+ */
+
+/**
+ * Request payload asking for playback frames for a sequence of actions.
+ */
+export interface PlaybackFrameRequest {
+  /**
+   * Action execution IDs, in playback order (Python constrains to
+   * `1..=100`).
+   */
+  actionIds: string[];
+  /**
+   * Whether to include screenshot URLs.
+   */
+  includeScreenshots: boolean;
+}

package/src/generated/PlaywrightExecutionMode.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`.
+ */
+
+/**
+ * Whether a Playwright test executes independently or as part of a chain.
+ */
+export type PlaywrightExecutionMode = "independent" | "chained";

package/src/generated/Point.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 (x, y) pixel offset used by the click-position and related parameters.
+ */
+export interface Point {
+  /**
+   * Horizontal offset in pixels.
+   */
+  x: number;
+  /**
+   * Vertical offset in pixels.
+   */
+  y: number;
+}

package/src/generated/PollingConfig.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`.
+ */
+
+/**
+ * Polling configuration for search operations.
+ */
+export interface PollingConfig {
+  interval?: number | null;
+  maxAttempts?: number | null;
+}

package/src/generated/ProcessConfig.d.ts

@@ -0,0 +1,96 @@
+/* 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 { ParserType } from './ParserType';
+
+/**
+ * Configuration for a managed process.
+ *
+ * Persisted in `settings.json` under `managed_processes`. Surfaced to the
+ * frontend through the `get_process_configs` command and to MCP consumers
+ * through the `processes` endpoint.
+ */
+export interface ProcessConfig {
+  /**
+   * Command arguments (e.g., ["run", "dev"])
+   */
+  args: string[];
+  /**
+   * Start when runner launches
+   */
+  autoStart: boolean;
+  /**
+   * Ring buffer max lines (default 2000)
+   */
+  bufferSize: number;
+  /**
+   * Build command arguments (e.g., ["build"], ["run", "build"]).
+   */
+  buildArgs: string[];
+  /**
+   * Build command to run before restarting (e.g., "cargo", "npm").
+   */
+  buildCommand?: string | null;
+  /**
+   * Category (e.g., "backend", "frontend")
+   */
+  category: string;
+  /**
+   * Command to execute (e.g., "python", "npm", "cargo")
+   */
+  command: string;
+  /**
+   * Working directory (absolute path)
+   */
+  cwd: string;
+  /**
+   * Whether this is a dev-mode-only service (not started in production
+   * builds).
+   */
+  devOnly: boolean;
+  /**
+   * Whether this config is enabled
+   */
+  enabled: boolean;
+  /**
+   * Extra environment variables
+   */
+  env: {
+    [k: string]: string;
+  };
+  /**
+   * Port to check for health (optional)
+   */
+  healthPort?: number | null;
+  /**
+   * Unique identifier (UUID)
+   */
+  id: string;
+  /**
+   * Regex patterns for errors to ignore (matched against error message and
+   * raw entry).
+   */
+  ignorePatterns: string[];
+  /**
+   * Human-readable name (e.g., "FastAPI Backend")
+   */
+  name: string;
+  /**
+   * Parser type for error detection
+   */
+  parser?: ParserType & string;
+  /**
+   * Whether rebuild and AI fix features are enabled for this process.
+   */
+  rebuildEnabled: boolean;
+  /**
+   * Startup group for ordered startup (lower groups start first, default 0).
+   * Processes in the same group start together. The runner waits for health
+   * ports in each group to be ready before starting the next group.
+   */
+  startGroup: number;
+}

package/src/generated/ProcessState.d.ts

@@ -0,0 +1,15 @@
+/* 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 of a managed process.
+ *
+ * Ordering mirrors the lifecycle progression:
+ * `Stopped → Starting → (Building) → Running → Healthy → Stopping → Stopped`,
+ * or to `Failed` on any abnormal exit.
+ */
+export type ProcessState = "stopped" | "starting" | "building" | "running" | "healthy" | "stopping" | "failed";